diff --git a/TOC.md b/TOC.md
new file mode 100644
index 00000000000..90b4d216611
--- /dev/null
+++ b/TOC.md
@@ -0,0 +1,88 @@
+# [framework](docs\framework\TOC.md)
+# [app-domains](docs\framework\app-domains\TOC.md)
+# [common-client-technologies](docs\framework\common-client-technologies\TOC.md)
+# [configure-apps](docs\framework\configure-apps\TOC.md)
+# [file-schema](docs\framework\configure-apps\file-schema\TOC.md)
+# [compiler](docs\framework\configure-apps\file-schema\compiler\TOC.md)
+# [cryptography](docs\framework\configure-apps\file-schema\cryptography\TOC.md)
+# [network](docs\framework\configure-apps\file-schema\network\TOC.md)
+# [runtime](docs\framework\configure-apps\file-schema\runtime\TOC.md)
+# [startup](docs\framework\configure-apps\file-schema\startup\TOC.md)
+# [trace-debug](docs\framework\configure-apps\file-schema\trace-debug\TOC.md)
+# [wcf](docs\framework\configure-apps\file-schema\wcf\TOC.md)
+# [wcf-directive](docs\framework\configure-apps\file-schema\wcf-directive\TOC.md)
+# [web](docs\framework\configure-apps\file-schema\web\TOC.md)
+# [windows-identity-foundation](docs\framework\configure-apps\file-schema\windows-identity-foundation\TOC.md)
+# [windows-workflow-foundation](docs\framework\configure-apps\file-schema\windows-workflow-foundation\TOC.md)
+# [data](docs\framework\data\TOC.md)
+# [adonet](docs\framework\data\adonet\TOC.md)
+# [dataset-datatable-dataview](docs\framework\data\adonet\dataset-datatable-dataview\TOC.md)
+# [ef](docs\framework\data\adonet\ef\TOC.md)
+# [language-reference](docs\framework\data\adonet\ef\language-reference\TOC.md)
+# [sql](docs\framework\data\adonet\sql\TOC.md)
+# [linq](docs\framework\data\adonet\sql\linq\TOC.md)
+# [transactions](docs\framework\data\transactions\TOC.md)
+# [wcf](docs\framework\data\wcf\TOC.md)
+# [debug-trace-profile](docs\framework\debug-trace-profile\TOC.md)
+# [deployment](docs\framework\deployment\TOC.md)
+# [get-started](docs\framework\get-started\TOC.md)
+# [install](docs\framework\install\TOC.md)
+# [interop](docs\framework\interop\TOC.md)
+# [mef](docs\framework\mef\TOC.md)
+# [migration-guide](docs\framework\migration-guide\TOC.md)
+# [misc](docs\framework\misc\TOC.md)
+# [net-native](docs\framework\net-native\TOC.md)
+# [network-programming](docs\framework\network-programming\TOC.md)
+# [performance](docs\framework\performance\TOC.md)
+# [reflection-and-codedom](docs\framework\reflection-and-codedom\TOC.md)
+# [resources](docs\framework\resources\TOC.md)
+# [security](docs\framework\security\TOC.md)
+# [serialization](docs\framework\serialization\TOC.md)
+# [tools](docs\framework\tools\TOC.md)
+# [ui-automation](docs\framework\ui-automation\TOC.md)
+# [unmanaged-api](docs\framework\unmanaged-api\TOC.md)
+# [wcf](docs\framework\wcf\TOC.md)
+# [diagnostics](docs\framework\wcf\diagnostics\TOC.md)
+# [etw](docs\framework\wcf\diagnostics\etw\TOC.md)
+# [event-logging](docs\framework\wcf\diagnostics\event-logging\TOC.md)
+# [exceptions-reference](docs\framework\wcf\diagnostics\exceptions-reference\TOC.md)
+# [performance-counters](docs\framework\wcf\diagnostics\performance-counters\TOC.md)
+# [tracing](docs\framework\wcf\diagnostics\tracing\TOC.md)
+# [wmi](docs\framework\wcf\diagnostics\wmi\TOC.md)
+# [extending](docs\framework\wcf\extending\TOC.md)
+# [feature-details](docs\framework\wcf\feature-details\TOC.md)
+# [samples](docs\framework\wcf\samples\TOC.md)
+# [whats-new](docs\framework\whats-new\TOC.md)
+# [windows-services](docs\framework\windows-services\TOC.md)
+# [windows-workflow-foundation](docs\framework\windows-workflow-foundation\TOC.md)
+# [samples](docs\framework\windows-workflow-foundation\samples\TOC.md)
+# [winforms](docs\framework\winforms\TOC.md)
+# [advanced](docs\framework\winforms\advanced\TOC.md)
+# [controls](docs\framework\winforms\controls\TOC.md)
+# [wpf](docs\framework\wpf\TOC.md)
+# [advanced](docs\framework\wpf\advanced\TOC.md)
+# [app-development](docs\framework\wpf\app-development\TOC.md)
+# [controls](docs\framework\wpf\controls\TOC.md)
+# [data](docs\framework\wpf\data\TOC.md)
+# [getting-started](docs\framework\wpf\getting-started\TOC.md)
+# [graphics-multimedia](docs\framework\wpf\graphics-multimedia\TOC.md)
+# [xaml-services](docs\framework\xaml-services\TOC.md)
+# [standard](docs\standard\TOC.md)
+# [asynchronous-programming-patterns](docs\standard\asynchronous-programming-patterns\TOC.md)
+# [attributes](docs\standard\attributes\TOC.md)
+# [base-types](docs\standard\base-types\TOC.md)
+# [collections](docs\standard\collections\TOC.md)
+# [thread-safe](docs\standard\collections\thread-safe\TOC.md)
+# [cross-platform](docs\standard\cross-platform\TOC.md)
+# [xml](docs\standard\data\xml\TOC.md)
+# [datetime](docs\standard\datetime\TOC.md)
+# [design-guidelines](docs\standard\design-guidelines\TOC.md)
+# [events](docs\standard\events\TOC.md)
+# [exceptions](docs\standard\exceptions\TOC.md)
+# [garbage-collection](docs\standard\garbage-collection\TOC.md)
+# [generics](docs\standard\generics\TOC.md)
+# [globalization-localization](docs\standard\globalization-localization\TOC.md)
+# [io](docs\standard\io\TOC.md)
+# [parallel-programming](docs\standard\parallel-programming\TOC.md)
+# [security](docs\standard\security\TOC.md)
+# [threading](docs\standard\threading\TOC.md)
diff --git a/docs/framework/64-bit-apps.md b/docs/framework/64-bit-apps.md
new file mode 100644
index 00000000000..fbd7c68444b
--- /dev/null
+++ b/docs/framework/64-bit-apps.md
@@ -0,0 +1,71 @@
+---
+title: "64 ビット アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "64 ビット アプリケーション [C++]"
+  - "64 ビット プログラミング [C++]"
+  - "アプリケーション [C++], 64 ビット"
+ms.assetid: fd4026bc-2c3d-4b27-86dc-ec5e96018181
+caps.latest.revision: 53
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 53
+---
+# 64 ビット アプリケーション
+アプリケーションをコンパイルするときに、Windows 64 ビット オペレーティング システム上で、ネイティブ アプリケーションとして実行するか、WOW64 \(Windows 64 ビット上の Windows 32 ビット\) の制御下で実行するかを指定できます。  WOW64 は互換環境であり、32 ビット アプリケーションを 64 ビット オペレーティング システム上で実行できるようにします。  WOW64 は、Windows オペレーティング システムのすべての 64 ビット バージョンに含まれています。  
+  
+## Windows における 32 ビット アプリケーションと 64 ビット アプリケーションの実行の比較  
+ .NET Framework 1.0 および 1.1 リリースでビルドされたアプリケーションはすべて、64 ビットのオペレーティング システム上の 32 ビット アプリケーションとして扱われます。そして常に、WOW64 と 32 ビットの共通言語ランタイム \(CLR: Common Language Runtime\) のもとで実行します。  [!INCLUDE[net_v40_long](../../includes/net-v40-long-md.md)] 以降のバージョンでビルドされた 32 ビット アプリケーションも、64 ビット システムでは WOW64 のもとで実行します。  
+  
+ Visual Studio は、x86 コンピューターには 32 ビット版の CLR をインストールし、64 ビットの Windows コンピューターには、32 ビット版の CLR と適切な 64 ビット版の CLR の両方をインストールします   \(Visual Studio は 32 ビット アプリケーションであるため、64 ビット システムにインストールすると WOW64 の制御下で実行されます\)。  
+  
+> [!NOTE]
+>  x86 エミュレーションと、Itanium プロセッサ ファミリ向け WOW64 サブシステムの設計のために、アプリケーションの実行は単一のプロセッサ上に制限されます。  これらの要因により、Itanium ベースのシステム上で実行する 32 ビット .NET Framework アプリケーションのパフォーマンスとスケーラビリティは低下します。  パフォーマンスおよびスケーラビリティを向上させるために、Itanium ベースのシステム用のネイティブ 64 ビット サポートを含む [!INCLUDE[net_v40_long](../../includes/net-v40-long-md.md)] を使用することをお勧めします。  
+  
+ 既定では、64 ビット Windows オペレーティング システムで 64 ビット マネージ アプリケーションを実行するときに、最大 2 GB のオブジェクトを作成できます。  ただし、[!INCLUDE[net_v45](../../includes/net-v45-md.md)] ではこの制限を上げることができます。  詳細については、「[\<gcAllowVeryLargeObjects\> 要素](../../docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md)」を参照してください。  
+  
+ 多くのアセンブリは 32 ビットの CLR と 64 ビットの CLR で同じように実行します。  しかし、次の条件が当てはまる場合、一部のプログラムでは動作が CLR によって異なります。  
+  
+-   プラットフォームによってメンバーのサイズが変わる構造体 \(ポインター型など\)  
+  
+-   定数のサイズを含むポインター演算  
+  
+-   ハンドルに `Int32` ではなく `IntPtr` を使用した不適切なプラットフォーム呼び出しまたは COM 宣言  
+  
+-   `IntPtr` を `Int32` にキャストするコード  
+  
+ 32 ビット アプリケーションを 64 ビットの CLR に移行して実行する方法の詳細については、[MSDN ライブラリの「Migrating 32\-bit Managed Code to 64\-bit](http://go.microsoft.com/fwlink/?LinkId=150542)」を参照してください。  
+  
+## 一般的な 64 ビット プログラミングについて  
+ 64 ビット プログラミングの一般的な問題については、次のドキュメントを参照してください。  
+  
+-   64 ビット Windows コンピューター上の 64 ビット版 CLR の詳細については、MSDN Web サイトの「[.NET Framework Developer Center](http://go.microsoft.com/fwlink/?LinkId=37079)」を参照してください。  
+  
+-   [!INCLUDE[winsdkshort](../../includes/winsdkshort-md.md)] ドキュメントの「[64 ビット Windows プログラミング ガイド](http://go.microsoft.com/fwlink/p/?LinkId=253512)」を参照してください。  
+  
+-   64 ビット版 CLR をダウンロードする方法については、MSDN Web サイトの「[.NET Framework Developer Center Downloads](http://go.microsoft.com/fwlink/?LinkId=50953)」を参照してください。  
+  
+-   64 ビット アプリケーションを作成するための Visual Studio のサポート機能については、「[Visual Studio IDE の 64 ビット サポート](../Topic/Visual%20Studio%20IDE%2064-Bit%20Support.md)」を参照してください。  
+  
+## 64 ビット アプリケーションを作成するためのコンパイラのサポート  
+ 既定では、.NET Framework を使用して 32 ビット コンピューターまたは 64 ビット コンピューターでアプリケーションをビルドする場合、アプリケーションは 64 ビット コンピューターでネイティブ アプリケーションとして \(WOW64 の制御下ではなく\) 実行します。  次の表に、Visual Studio コンパイラを使用して、ネイティブなアプリケーションとして実行する 64 ビット アプリケーション、WOW64 の下で実行する 64 ビット アプリケーション、またはその両方が可能な 64 ビット アプリケーションを作成するための方法を説明するドキュメントを示します。  
+  
+|コンパイラ|コンパイラ オプション|  
+|-----------|-----------------|  
+|Visual Basic|[\/platform](../Topic/-platform%20\(Visual%20Basic\).md)|  
+|Visual C\#|[\/platform \(Specify Output Platform\)](../Topic/-platform%20\(C%23%20Compiler%20Options\).md)|  
+|Visual C\+\+|**\/clr:safe** を使用すると、プラットフォームに依存しない、Microsoft Intermediate Language \(MSIL\) アプリケーションを作成できます。  詳しくは、「[\/clr \(共通言語ランタイムのコンパイル\)](../Topic/-clr%20\(Common%20Language%20Runtime%20Compilation\).md)」を参照してください。<br /><br /> Visual C\+\+ には、それぞれの 64 ビット オペレーティング システムを対象とする個別のコンパイラが含まれます。  Visual C\+\+ を使用して 64 ビット Windows オペレーティング システム上で実行するネイティブ アプリケーションを作成する方法の詳細については、「[64\-bit Programming](http://msdn.microsoft.com/library/h2k70f3s\(v=vs.80\))」を参照してください。|  
+  
+## .exe ファイルまたは .dll ファイルのステータスの特定  
+ .exe ファイルまたは .dll ファイルが、特定のプラットフォーム上または WOW64 の下でのみ動作するように意図されているかどうかを確認するには、[CorFlags.exe \(CorFlags 変換ツール\)](../../docs/framework/tools/corflags-exe-corflags-conversion-tool.md) を使用します \(オプションは指定しません\)。  また、CorFlags.exe を使用して、.exe ファイルまたは .dll ファイルのプラットフォームのステータスを変更することもできます。  Visual Studio アセンブリの CLR ヘッダーのメジャー ランタイム バージョン番号が 2、マイナー ランタイム バージョン番号が 5 に設定されています。  マイナー ランタイム バージョンが 0 に設定されたアプリケーションは、レガシ アプリケーションとして扱われ、常に WOW64 の下で実行されます。  
+  
+ プログラムによって .exe または .dll を照会し、それが特定のプラットフォーム上または WOW64 の下でのみ動作するように意図されているかどうかを確認するには、<xref:System.Reflection.Module.GetPEKind%2A?displayProperty=fullName> メソッドを使用します。
\ No newline at end of file
diff --git a/docs/framework/TOC.md b/docs/framework/TOC.md
new file mode 100644
index 00000000000..ac0c43a3fe8
--- /dev/null
+++ b/docs/framework/TOC.md
@@ -0,0 +1,5 @@
+# [64 ビット アプリケーション](64-bit-apps.md)
+# [.NET Framework 4.6 および 4.5](index.md)
+# [ASP.NET を使用した Web アプリケーション](develop-web-apps-with-aspnet.md)
+# [クライアント アプリケーション](develop-client-apps.md)
+# [開発ガイド](development-guide.md)
diff --git a/docs/framework/app-domains/TOC.md b/docs/framework/app-domains/TOC.md
new file mode 100644
index 00000000000..80280603dc6
--- /dev/null
+++ b/docs/framework/app-domains/TOC.md
@@ -0,0 +1,46 @@
+# [厳密な名前付きアセンブリの作成と使用](create-and-use-strong-named-assemblies.md)
+# [アセンブリの配置](assembly-placement.md)
+# [方法 : アセンブリの内容を表示する](how-to-view-assembly-contents.md)
+# [方法 : アプリケーション ドメインをアンロードする](how-to-unload-an-application-domain.md)
+# [イントラネット アプリケーションの完全信頼での実行](running-intranet-applications-in-full-trust.md)
+# [アセンブリと side-by-side 実行](assemblies-and-side-by-side-execution.md)
+# [アセンブリのシャドウ コピー](shadow-copy-assemblies.md)
+# [厳密な名前付きアセンブリ](strong-named-assemblies.md)
+# [グローバル アセンブリ キャッシュ](gac.md)
+# [アプリケーション ドメインの使用](use.md)
+# [方法 : グローバル アセンブリ キャッシュの内容を表示する](how-to-view-the-contents-of-the-gac.md)
+# [方法 : アプリケーション ドメインを作成する](how-to-create-an-application-domain.md)
+# [方法 : グローバル アセンブリ キャッシュからアセンブリを削除する](how-to-remove-an-assembly-from-the-gac.md)
+# [方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする](how-to-install-an-assembly-into-the-gac.md)
+# [方法: シングルファイル アセンブリをビルドする](how-to-build-a-single-file-assembly.md)
+# [アセンブリの場所](assembly-location.md)
+# [アセンブリへの遅延署名](delay-sign-assembly.md)
+# [アプリケーション ドメインとアセンブリ](index.md)
+# [アセンブリ名](assembly-names.md)
+# [アセンブリ マニフェスト](assembly-manifest.md)
+# [アセンブリとグローバル アセンブリ キャッシュの使用](working-with-assemblies-and-the-gac.md)
+# [アセンブリのバージョン管理](assembly-versioning.md)
+# [拡張された厳密な名前付け](enhanced-strong-naming.md)
+# [方法: 初回例外通知を受け取る](how-to-receive-first-chance-exception-notifications.md)
+# [アプリケーション ドメインからのセットアップ情報の取得](retrieve-setup-information.md)
+# [アセンブリの作成](create-assemblies.md)
+# [共通言語ランタイムでの型の転送](type-forwarding-in-the-common-language-runtime.md)
+# [アセンブリ読み込みの解決](resolve-assembly-loads.md)
+# [方法 : 厳密な名前のアセンブリを参照する](how-to-reference-a-strong-named-assembly.md)
+# [アセンブリ属性の設定](set-assembly-attributes.md)
+# [方法 : アセンブリから型およびメンバーの情報を取得する](how-to-obtain-type-and-member-information-from-an-assembly.md)
+# [サービス コンポーネントとグローバル アセンブリ キャッシュの使用](use-serviced-components-with-the-gac.md)
+# [共通言語ランタイムのアセンブリ](assemblies-in-the-common-language-runtime.md)
+# [方法 : 厳密な名前でアセンブリに署名する](how-to-sign-an-assembly-with-a-strong-name.md)
+# [アセンブリの内容](assembly-contents.md)
+# [方法 : マルチファイル アセンブリをビルドする](how-to-build-a-multifile-assembly.md)
+# [アセンブリを使用したプログラミング](programming-with-assemblies.md)
+# [方法 : 厳密な名前のバイパス機能を無効にする](how-to-disable-the-strong-name-bypass-feature.md)
+# [アプリケーション ドメインとアセンブリに関する方法のトピック](application-domains-and-assemblies-how-to-topics.md)
+# [アセンブリのセキュリティに関する考慮事項](assembly-security-considerations.md)
+# [方法 : アプリケーション ドメインにアセンブリを読み込む](how-to-load-assemblies-into-an-application-domain.md)
+# [マルチファイル アセンブリ](multifile-assemblies.md)
+# [アプリケーション ドメイン](application-domains.md)
+# [方法 : アプリケーション ドメインを構成する](how-to-configure-an-application-domain.md)
+# [方法 : 公開キーと秘密キーのキー ペアを作成する](how-to-create-a-public-private-key-pair.md)
+# [方法 : アセンブリの完全修飾名を特定する](how-to-determine-assembly-fully-qualified-name.md)
diff --git a/docs/framework/app-domains/application-domains-and-assemblies-how-to-topics.md b/docs/framework/app-domains/application-domains-and-assemblies-how-to-topics.md
new file mode 100644
index 00000000000..cbc40259438
--- /dev/null
+++ b/docs/framework/app-domains/application-domains-and-assemblies-how-to-topics.md
@@ -0,0 +1,62 @@
+---
+title: "アプリケーション ドメインとアセンブリに関する方法のトピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン, 方法"
+  - "アセンブリ [.NET Framework], 方法"
+ms.assetid: 2264054e-712e-47e4-8657-1aa1cfec3e3d
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# アプリケーション ドメインとアセンブリに関する方法のトピック
+概念を説明したドキュメントに用意されている、アプリケーション ドメインとアセンブリとのプログラミングに関する方法を説明したトピックへのすべてのリンクを次のセクションに示します。  
+  
+ **アプリケーション ドメイン**  
+  
+-   [方法 : アプリケーション ドメインを作成する](../../../docs/framework/app-domains/how-to-create-an-application-domain.md)  
+  
+-   [方法 : アプリケーション ドメインをアンロードする](../../../docs/framework/app-domains/how-to-unload-an-application-domain.md)  
+  
+-   [方法 : アプリケーション ドメインを構成する](../../../docs/framework/app-domains/how-to-configure-an-application-domain.md)  
+  
+-   [方法 : アプリケーション ドメインにアセンブリを読み込む](../../../docs/framework/app-domains/how-to-load-assemblies-into-an-application-domain.md)  
+  
+-   [方法 : アセンブリから型およびメンバーの情報を取得する](../../../docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md)  
+  
+ **アセンブリ**  
+  
+-   [方法 : アセンブリの完全修飾名を特定する](../../../docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md)  
+  
+-   [方法: シングルファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-single-file-assembly.md)  
+  
+-   [方法 : マルチファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-multifile-assembly.md)  
+  
+-   [方法 : 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)  
+  
+-   [方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)  
+  
+-   [方法 : 厳密な名前のアセンブリを参照する](../../../docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md)  
+  
+-   [方法 : 厳密な名前のバイパス機能を無効にする](../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)  
+  
+-   [方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする](../../../docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md)  
+  
+-   [方法 : グローバル アセンブリ キャッシュの内容を表示する](../../../docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md)  
+  
+-   [方法 : グローバル アセンブリ キャッシュからアセンブリを削除する](../../../docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md)  
+  
+-   [方法 : アセンブリの内容を表示する](../../../docs/framework/app-domains/how-to-view-assembly-contents.md)  
+  
+## 参照  
+ [アプリケーション ドメインとアセンブリ](../../../docs/framework/app-domains/index.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/application-domains.md b/docs/framework/app-domains/application-domains.md
new file mode 100644
index 00000000000..f8f58516994
--- /dev/null
+++ b/docs/framework/app-domains/application-domains.md
@@ -0,0 +1,171 @@
+---
+title: "アプリケーション ドメイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン"
+  - "アプリケーション ドメイン, 概要"
+  - "アプリケーションの分離"
+  - "コード, 検証プロセス"
+  - "共通言語ランタイム, アプリケーション ドメイン"
+  - "分離 (アプリケーションの)"
+  - "プロセス境界 (分離のための)"
+  - "ランタイム, アプリケーション ドメイン"
+  - "検証テスト コード"
+ms.assetid: 113a8bbf-6875-4a72-a49d-ca2d92e19cc8
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# アプリケーション ドメイン
+オペレーティング システムやランタイム環境では、通常、複数のアプリケーションがなんらかの形で分離されています。  たとえば、Windows ではプロセスを使用してアプリケーションが分離されています。  このような分離は、あるアプリケーションで実行されているコードが、関係のない別のアプリケーションに悪影響をもたらさないようにするために必要です。  
+  
+ アプリケーション ドメインは、セキュリティ、信頼性、バージョン管理のための、またアセンブリをアンロードするための分離の境界を提供します。  通常、アプリケーション ドメインは、アプリケーションの実行前に共通言語ランタイムの起動を行うランタイム ホストによって作成されます。  
+  
+ このセクションのトピックでは、アプリケーション ドメインを使用してアセンブリ間を分離する方法について説明します。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [アプリケーションを分離する利点](#benefits)  
+  
+-   [参照](#reference)  
+  
+<a name="benefits"></a>   
+## アプリケーションを分離する利点  
+ これまで、同じコンピューター上で実行される複数のアプリケーションを分離するためには、プロセス境界が使用されていました。  この場合、各アプリケーションが独立のプロセスに読み込まれることで、アプリケーションは同じコンピューター上で実行されるほかのアプリケーションから分離されます。  
+  
+ アプリケーションが分離されるのは、メモリ アドレスがプロセスごとの相対アドレスになっていたためです。つまり、メモリ ポインターをあるプロセスから別のプロセスに渡しても、そのポインターが渡された側のプロセスでは機能しませんでした。  また、2 つのプロセス間で直接呼び出しを行うこともできませんでした。  代わりに間接的な呼び出しを行う場合は、プロキシを使用する必要がありました。  
+  
+ マネージ コードは、実行される前に必ず検査プロセスに渡されます \(管理者が検査を省略する許可をコードに与えた場合は除きます\)。  検査プロセスでは、そのコードが無効なメモリ アドレスにアクセスしたり、コードが実行されるプロセスの正常実行を妨げる原因となる動作を実行したりすることがないかどうかを確認します。  検査テストを通過したコードは、タイプ セーフであると言われます。  コードがタイプ セーフかどうかを検査するこのような機能があるため、共通言語ランタイムでは、プロセス境界と同等の高度な分離レベルを実現しながら、パフォーマンスへの影響は大幅に低く抑えることができます。  
+  
+ アプリケーション ドメインは、共通言語ランタイムがアプリケーション間を分離するために使用できる、より安全で柔軟性に富んだ処理単位となります。  個別のプロセスを使用する場合と同じ分離レベルを実現しながら、しかしプロセス間での呼び出しやプロセスの切り替えによるオーバーヘッドを生じることもなく、1 つのプロセス内で複数のアプリケーション ドメインを実行できます。  1 つのプロセス内で複数のアプリケーションを実行できるため、サーバーのスケーラビリティが飛躍的に向上します。  
+  
+ アプリケーションの分離は、アプリケーションのセキュリティを考えるうえでも重要です。  たとえば、複数のコントロールが互いのデータやリソースにアクセスできないようにして、1 つのブラウザー プロセスで複数の Web アプリケーションのコントロールを実行できます。  
+  
+ アプリケーション ドメインによる分離には、次の利点があります。  
+  
+-   1 つのアプリケーションで発生したエラーが、ほかのアプリケーションに影響することはありません。  タイプ セーフなコードではメモリ フォールトが発生しないため、アプリケーション ドメインを使用することで、1 つのドメインで実行されているコードが同じプロセス内のほかのアプリケーションに影響することが確実になくなります。  
+  
+-   プロセス全体を停止せずに、個々のアプリケーションを停止できます。  アプリケーション ドメインを使用すると、1 つのアプリケーション内で実行されているコードをアンロードできます。  
+  
+    > [!NOTE]
+    >  個々のアセンブリや型はアンロードできません。  アンロードできるのはドメイン全体だけです。  
+  
+-   1 つのアプリケーションで実行されているコードは、ほかのアプリケーションのコードやリソースに直接アクセスできません。  共通言語ランタイムでは、異なるアプリケーション ドメインにあるオブジェクト間での直接呼び出しを禁止することで分離を実現しています。  ドメイン間で渡されるオブジェクトは、コピーされるか、またはプロキシ経由でアクセスされます。  オブジェクトがコピーされる場合、オブジェクトの呼び出しはローカル呼び出しです。  つまり、呼び出し元と参照先オブジェクトの両方が、同じアプリケーション ドメイン内にあります。  オブジェクトがプロキシ経由でアクセスされる場合は、オブジェクトの呼び出しはリモート呼び出しです。  この場合は、呼び出し元と参照先オブジェクトが別のアプリケーション ドメイン内にあります。  ドメイン間呼び出しでは、2 つのプロセス間や 2 台のコンピューター間での呼び出しと同じリモート呼び出しインフラストラクチャが使用されます。  そのため、メソッドの呼び出しが正しく JIT コンパイルされるように、参照先オブジェクトのメタデータが両方のアプリケーション ドメインから利用できることが必要です。  呼び出し元のドメインが呼び出し先オブジェクトのメタデータにアクセスできない場合、コンパイルは **System.IO.FileNotFound** という例外が発生して失敗する可能性があります。  詳細については、「[リモート オブジェクト](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)」を参照してください。  ドメイン間でオブジェクトにアクセスする方法は、アクセス対象のオブジェクトによって決まります。  詳細については、[MarshalByRefObject クラス](frlrfSystemMarshalByRefObjectClassTopic)のトピックを参照してください。  
+  
+-   コードが影響する範囲は、そのコードが実行されるアプリケーションによって決まります。  つまり、アプリケーション ドメインは、アプリケーションのバージョン ポリシー、アクセス対象となるリモート アセンブリの位置、ドメインに読み込まれるアセンブリの場所に関する情報などの構成設定を提供します。  
+  
+-   コードに与えられるアクセス許可は、そのコードが実行されるアプリケーション ドメインによって制御されます。  
+  
+ [ページのトップへ](#top)  
+  
+## アプリケーション ドメインとアセンブリ  
+ ここでは、アプリケーション ドメインとアセンブリの関係について説明します。  アセンブリに含まれるコードを実行する前に、そのアセンブリをアプリケーション ドメインに読み込む必要があります。  通常のアプリケーションを実行すると、複数のアセンブリがアプリケーション ドメインに読み込まれます。  
+  
+ アセンブリが読み込まれる方法によって、そのアセンブリの Just\-In\-Time \(JIT\) コンパイル コードをプロセス内の複数のアプリケーション ドメインで共有できるかどうか、およびアセンブリをプロセスからアンロードできるかどうかが決まります。  
+  
+-   アセンブリがドメインに中立として読み込まれる場合は、同じセキュリティ許可セットを共有するすべてのアプリケーション ドメインが同じ JIT コンパイル コードを共有できるため、アプリケーションに必要なメモリを削減できます。  ただし、アセンブリをプロセスからアンロードできなくなります。  
+  
+-   アセンブリがドメインに中立として読み込まれない場合は、そのアセンブリが読み込まれる各アプリケーション ドメインで、そのアセンブリを JIT でコンパイルする必要があります。  ただし、アセンブリが読み込まれているアプリケーション ドメインをすべてアンロードすることで、プロセスからアセンブリをアンロードできます。  
+  
+ ランタイム ホストは、ランタイムをプロセスに読み込むときに、アセンブリをドメインに中立なアセンブリとして読み込むかどうかを決定します。  マネージ アプリケーションの場合は、<xref:System.LoaderOptimizationAttribute> 属性をプロセスのエントリ ポイント メソッドに適用し、関連付けられた <xref:System.LoaderOptimization> 列挙体から値を指定します。  共通言語ランタイムをホストするアンマネージ アプリケーションの場合は、[CorBindToRuntimeEx 関数](../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md) メソッドを呼び出すときに適切なフラグを指定します。  
+  
+ アセンブリをドメインに中立として読み込むかどうかに関して、次の 3 つのオプションがあります。  
+  
+-   <xref:System.LoaderOptimization> では、常にドメインに中立として読み込まれる Mscorlib を除き、どのアセンブリもドメインに中立として読み込まれません。  この設定は、ホストがプロセス内で 1 つのアプリケーションだけを実行する場合に一般的に使用されるため、シングル ドメインと呼ばれます。  
+  
+-   <xref:System.LoaderOptimization> では、すべてのアセンブリがドメインに中立として読み込まれます。  この設定は、同じコードを実行する複数のアプリケーション ドメインが 1 つのプロセス内に存在する場合に使用します。  
+  
+-   <xref:System.LoaderOptimization> では、厳密な名前が付いたアセンブリとそのすべての依存関係がグローバル アセンブリ キャッシュにインストールされている場合に、それらのアセンブリがドメインに中立として読み込まれます。  その他のアセンブリは、それらが読み込まれる各アプリケーション ドメインで個別に読み込まれ、JIT でコンパイルされるため、プロセスからアンロードできます。  この設定は、同じプロセスで複数のアプリケーションが実行されている場合、または多数のアプリケーション ドメインで共有されているアセンブリと、プロセスからアンロードする必要があるアセンブリが混在している場合に使用します。  
+  
+ <xref:System.Reflection.Assembly.LoadFrom%2A> クラスの <xref:System.Reflection.Assembly> メソッドを使用して読み込み元を指定して読み込まれたアセンブリ、またはバイト配列を指定する <xref:System.Reflection.Assembly.Load%2A> メソッドのオーバーロードを使用してイメージから読み込まれたアセンブリについては、JIT コンパイル コードを共有できません。  
+  
+ [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用してネイティブ コードにコンパイルされたアセンブリは、プロセスに最初に読み込まれるときにドメインに中立として読み込まれていれば、アプリケーション ドメイン間で共有できます。  
+  
+ アプリケーションのエントリ ポイントを含むアセンブリの JIT コンパイル コードは、そのすべての依存関係を共有できる場合にだけ共有されます。  
+  
+ ドメインに中立なアセンブリは、JIT で複数回コンパイルできます。  たとえば、2 つのアプリケーション ドメインのセキュリティ許可セットが異なっている場合、それらのドメインは同じ JIT コンパイル コードを共有できません。  ただし、JIT コンパイル アセンブリの各コピーは、同じ許可セットを持つ他のアプリケーション ドメインと共有できます。  
+  
+ アセンブリをドメインに中立として読み込むかどうかを判断する場合は、メモリ使用量の削減とその他のパフォーマンス要因とのトレードオフを考慮する必要があります。  
+  
+-   ドメインに中立のアセンブリでは、アセンブリを分離する必要があることから、静的データおよびメソッドにアクセスする速度が遅くなります。  静的フィールド内のオブジェクトがドメイン境界を越えて参照されることがないように、アセンブリにアクセスする各アプリケーション ドメインが、静的データのコピーを個別に保持する必要があるためです。  その結果、ランタイムには、呼び出し元が静的データまたは静的メソッドの適切なコピーにアクセスできるようにするための追加のロジックが必要となります。  この追加のロジックのために、呼び出しの処理速度が低下します。  
+  
+-   アセンブリがドメインに中立で読み込まれるときに、アセンブリのすべての依存関係を探し出して読み込む必要があります。これは、ドメインに中立として読み込むことのできない依存関係があると、アセンブリをドメインに中立として読み込むことができなくなるからです。  
+  
+## アプリケーション ドメインとスレッド  
+ アプリケーション ドメインは、セキュリティ、バージョン管理、信頼性のための、またマネージ コードをアンロードするための分離の境界を形成します。  スレッドは、共通言語ランタイムがコードを実行するために使用する、オペレーティング システムの構成です。  実行時には、すべてのマネージ コードがアプリケーション ドメインに読み込まれ、1 つまたは複数のマネージ スレッドによって実行されます。  
+  
+ アプリケーション ドメインとスレッドとの関係は一対一ではありません。  1 つのアプリケーション ドメイン内で一度に複数のスレッドが実行される場合があり、また 1 つのスレッドが 1 つのアプリケーション ドメインに限定されることもありません。  つまり、スレッドはアプリケーション ドメイン境界を自由に越えることができ、アプリケーション ドメインごとに新しいスレッドが生成されるわけではありません。  
+  
+ 特定の時点に限って見ると、どのスレッドも 1 つのアプリケーション ドメイン内で実行されています。  特定のアプリケーション ドメインでゼロ、1 つ、または複数のスレッドを実行できます。  ランタイムは、どのスレッドがどのアプリケーション ドメインで実行されているかを追跡しています。  任意の時点で、あるスレッドが実行されているドメインを特定するには、<xref:System.Threading.Thread.GetDomain%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+### アプリケーション ドメインとカルチャ  
+ <xref:System.Globalization.CultureInfo> オブジェクトによって表されるカルチャは、スレッドに関連付けられます。  <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティを使用すると、現在実行しているスレッドに関連付けられているカルチャを取得できます。<xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティを使用すると、現在実行しているスレッドに関連付けられているカルチャを取得または設定できます。  スレッドに関連付けられているカルチャが <xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティを使用して明示的に設定されている場合、スレッドがアプリケーション ドメインの境界を越えても、そのスレッドとの関連付けが維持されます。  それ以外の場合、スレッドに関連付けられるカルチャは、任意の時点でスレッドが実行されているアプリケーション ドメインの <xref:System.Globalization.CultureInfo.DefaultThreadCurrentCulture%2A?displayProperty=fullName> プロパティの値によって決まります。  
+  
+-   プロパティの値が `null` でない場合、プロパティによって返されるカルチャはスレッドに関連付けられます \(したがって <xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティと <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティによって返されます\)。  
+  
+-   プロパティの値が `null` の場合は、現在のシステム カルチャがスレッドに関連付けられます。  
+  
+## アプリケーション ドメインを使用したプログラミング  
+ 通常、アプリケーション ドメインは、ランタイム ホストによってプログラムで作成および操作されます。  しかし、アプリケーション プログラムでもアプリケーション ドメインを操作する必要が生じる場合があります。  たとえば、アプリケーション プログラムはアプリケーション コンポーネントをドメインに読み込むことができるため、アプリケーション全体を停止せずにドメイン \(およびコンポーネント\) をアンロードできます。  
+  
+ [AppDomain クラス](frlrfSystemAppDomainClassTopic)は、アプリケーション ドメインに対するプログラム インターフェイスです。  このクラスには、ドメインを作成およびアンロードするメソッド、型のインスタンスをドメイン内に作成するメソッド、およびアプリケーション ドメインのアンロードなどの各種通知に登録するメソッドが含まれています。  一般的に使用される [AppDomain](frlrfSystemAppDomainMethodsTopic) メソッドを次の表に示します。  
+  
+|AppDomain メソッド|説明|  
+|--------------------|--------|  
+|<xref:System.AppDomain.CreateDomain%2A>|新しいアプリケーション ドメインを作成します。  <xref:System.AppDomainSetup> オブジェクトを指定するこのメソッドのオーバーロードを使用することをお勧めします。  これは、アプリケーション ベース \(アプリケーションのルート ディレクトリ\)、ドメインの構成ファイルの場所、ドメインにアセンブリを読み込むときに共通言語ランタイムが使用する検索パスなど、新しいドメインのプロパティを設定する場合に望ましい方法です。|  
+|<xref:System.AppDomain.ExecuteAssembly%2A> および <xref:System.AppDomain.ExecuteAssemblyByName%2A>|アプリケーション ドメインでアセンブリを実行します。  これはインスタンス メソッドであるため、参照先の別のアプリケーション ドメインでコードを実行する場合に使用できます。|  
+|<xref:System.AppDomain.CreateInstanceAndUnwrap%2A>|指定した型のインスタンスをアプリケーション ドメイン内に作成し、プロキシを返します。  このメソッドを使用することで、作成された型を含むアセンブリが呼び出し元のアセンブリに読み込まれることを回避できます。|  
+|<xref:System.AppDomain.Unload%2A>|ドメインを正常にシャットダウンします。  アプリケーション ドメインは、ドメイン内で実行されているすべてのスレッドが停止するか、またはドメイン内に存在しなくなるまで、アンロードされません。|  
+  
+> [!NOTE]
+>  共通言語ランタイムはグローバル メソッドのシリアル化をサポートしないため、デリゲートを使用して他のアプリケーション ドメインでグローバル メソッドを実行できません。  
+  
+ 共通言語ランタイムの仕様、「Hosting Interfaces」で説明されているアンマネージ インターフェイスも、アプリケーション ドメインへのアクセスを提供します。  ランタイム ホストは、アンマネージ コードのインターフェイスを使用して、プロセス内にアプリケーション ドメインを作成し、そのドメインにアクセスできます。  
+  
+## COMPLUS\_LoaderOptimization 環境変数  
+ 実行可能アプリケーションの既定のローダーの最適化ポリシーを設定する環境変数。  
+  
+### 構文  
+  
+```  
+COMPLUS_LoaderOptimization = 1  
+```  
+  
+### コメント  
+ 一般的なアプリケーションでは、アプリケーション ドメインに複数のアセンブリが読み込まれてから、それに含まれるコードが実行されます。  
+  
+ アセンブリが読み込まれる方法によって、そのアセンブリの Just\-In\-Time \(JIT\) コンパイル コードをプロセス内の複数のアプリケーション ドメインで共有できるかどうかが決まります。  
+  
+-   アセンブリがドメイン中立として読み込まれる場合は、同じセキュリティ許可セットを共有するすべてのアプリケーション ドメインが同じ JIT コンパイル コードを共有できます。  このため、アプリケーションが必要とするメモリを抑えることができます。  
+  
+-   アセンブリがドメイン中立として読み込まれない場合、読み込まれるすべてのアプリケーション ドメインで JIT コンパイル済みである必要があり、またローダーはアプリケーション ドメイン間で内部リソースを共有できません。  
+  
+ COMPLUS\_LoaderOptimization 環境フラグを 1 に設定すると、ランタイム ホストは強制的にすべてのアセンブリを SingleDomain と呼ばれるドメイン中立でない方法で読み込みます。  SingleDomain では、常にドメインに中立として読み込まれる Mscorlib を除き、どのアセンブリもドメインに中立として読み込まれません。  この設定は、ホストがプロセス内で 1 つのアプリケーションだけを実行する場合に一般的に使用されるため、シングル ドメインと呼ばれます。  
+  
+> [!CAUTION]
+>  COMPLUS\_LoaderOptimization 環境フラグは診断およびテストのシナリオで使用するように設計されています。  このフラグをオンにすることにより、速度の大幅な低下と使用メモリの増大が発生する場合があります。  
+  
+### コード例  
+ 環境の HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\services\\IISADMIN キーの複数文字列値に `COMPLUS_LoaderOptimization=1` を追加することにより、強制的にすべてのアセンブリを IISADMIN サービスにドメイン中立として読み込まないようにできます。  
+  
+```  
+Key = HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\IISADMIN  
+Name = Environment  
+Type = REG_MULTI_SZ  
+Value (to append) = COMPLUS_LoaderOptimization=1  
+  
+```  
+  
+<a name="reference"></a>   
+## 参照  
+ <xref:System.MarshalByRefObject?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/app-domains/assemblies-and-side-by-side-execution.md b/docs/framework/app-domains/assemblies-and-side-by-side-execution.md
new file mode 100644
index 00000000000..a09e73856df
--- /dev/null
+++ b/docs/framework/app-domains/assemblies-and-side-by-side-execution.md
@@ -0,0 +1,31 @@
+---
+title: "アセンブリと side-by-side 実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], side-by-side 実行"
+  - "side-by-side 実行 [.NET Framework]"
+ms.assetid: e42036ee-7590-47d1-b884-cc856e39bd5d
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アセンブリと side-by-side 実行
+side\-by\-side 実行は、アプリケーションやコンポーネントの複数のバージョンを同じコンピューターに格納して実行する機能です。  つまり、ランタイムの複数のバージョンと、特定のバージョンのランタイムを使用するアプリケーションおよびコンポーネントの複数のバージョンを、同一コンピューター上に共存させることができます。  side\-by\-side 実行によって、アプリケーションをバインドするコンポーネントのバージョンや、アプリケーションが使用するランタイムのバージョンを細かく制御できます。  
+  
+ 同じアセンブリの異なるバージョンの side\-by\-side ストレージにおける side\-by\-side 実行のサポートは、厳密な名前には不可欠の要素であり、ランタイムのインフラストラクチャに組み込まれています。  厳密な名前を持つアセンブリのバージョン番号がその識別子の一部に含まれているため、ランタイムは同じアセンブリの複数のバージョンをグローバル アセンブリ キャッシュに格納し、実行時にこれらのアセンブリを読み込むことができます。  
+  
+ ランタイムは、side\-by\-side 実行できるアプリケーションの作成機能を提供しますが、side\-by\-side 実行は自動的にサポートされるわけではありません。  side\-by\-side 実行用のアプリケーション作成の詳細については、「[side\-by\-side 実行用のコンポーネントを作成するためのガイドライン](../../../docs/framework/deployment/guidelines-for-creating-components-for-side-by-side-execution.md)」を参照してください。  
+  
+## 参照  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assemblies-in-the-common-language-runtime.md b/docs/framework/app-domains/assemblies-in-the-common-language-runtime.md
new file mode 100644
index 00000000000..eee7e309c6b
--- /dev/null
+++ b/docs/framework/app-domains/assemblies-in-the-common-language-runtime.md
@@ -0,0 +1,70 @@
+---
+title: "共通言語ランタイムのアセンブリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework]"
+  - "アセンブリ [.NET Framework], 概要"
+  - "アセンブリ [.NET Framework], 境界"
+  - "境界 (アセンブリの)"
+  - "動的アセンブリ"
+  - "参照スコープの境界"
+  - "セキュリティ [.NET Framework], 境界"
+  - "型境界"
+  - "バージョン境界"
+ms.assetid: 2cfebe19-7436-49f1-bd99-3c4019f0b676
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 共通言語ランタイムのアセンブリ
+アセンブリは .NET Framework アプリケーションのビルド ブロックであり、配置、バージョン管理、再利用、アクティブ化のスコープの指定、およびセキュリティ アクセス許可の基本単位となります。  アセンブリは、相互に連携して 1 つの論理的な機能単位を形成するように構築された型やリソースの集合です。  共通言語ランタイムは、型の実装に関して必要な情報をアセンブリから取得します。  共通言語ランタイムにとって、型はアセンブリのコンテキストの外部には存在しません。  
+  
+ アセンブリの機能は次のとおりです。  
+  
+-   共通言語ランタイムが実行するコードを保持します。  ポータブル実行可能 \(PE: Portable Executable\) ファイル内の MSIL \(Microsoft Intermediate Language\) コードにアセンブリ マニフェストが関連付けられていない場合、このコードは実行されません。  各アセンブリが保持できるエントリ ポイントは 1 つだけです \(つまり、`DllMain`、`WinMain`、または `Main`\)。  
+  
+-   セキュリティの境界を形成します。  アクセス許可の要求および付与は、アセンブリを単位として行われます。  アセンブリに適用されるセキュリティ境界の詳細については、「[アセンブリのセキュリティに関する考慮事項](../../../docs/framework/app-domains/assembly-security-considerations.md)」を参照してください。  
+  
+-   型の境界を形成します。  すべての型の ID には、その型を含んでいるアセンブリの名前が含まれます。  したがって、あるアセンブリのスコープに読み込まれた `MyType` と呼ばれる型は、別のアセンブリのスコープに読み込まれた `MyType` と呼ばれる型とは異なります。  
+  
+-   参照スコープの境界を形成します。  アセンブリのマニフェストには、型を解決したり、リソース要求に応答したりするために使用されるアセンブリ メタデータが含まれています。  このメタデータは、アセンブリの外部に公開する型およびリソースを指定します。  マニフェストには、そのアセンブリが依存するほかのアセンブリも列挙されています。  
+  
+-   バージョンの境界を形成します。  アセンブリは、共通言語ランタイムにおけるバージョン管理の最小単位です。同じアセンブリ内のすべての型およびリソースは、まとめてバージョン管理されます。  アセンブリのマニフェストには、任意の依存アセンブリに対して指定した、バージョンの依存関係が記述されています。  バージョン管理の詳細については、「[アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)」を参照してください。  
+  
+-   配置を行う場合の単位として機能します。  アプリケーションの起動時には、そのアプリケーションが最初に呼び出すアセンブリだけが必要です。  その他のアセンブリ、たとえばローカリゼーション リソースや、ユーティリティ クラスを格納するアセンブリは必要に応じて取得できます。  これにより、最初にダウンロードされるアプリケーションを単純化し、サイズを縮小できます。  アセンブリの配置の詳細については、「[アプリケーションの配置](../../../docs/framework/deployment/net-framework-and-applications.md)」を参照してください。  
+  
+-   side\-by\-side 実行がサポートされる場合、その単位として機能します。  同じアセンブリの複数バージョンの同時実行については、「[アセンブリと side\-by\-side 実行](../../../docs/framework/app-domains/assemblies-and-side-by-side-execution.md)」を参照してください。  
+  
+ アセンブリには、静的アセンブリと動的アセンブリの 2 種類があります。  静的アセンブリには、.NET Framework の各型 \(インターフェイスおよびクラス\) と、アセンブリ用のリソース \(ビットマップ、JPEG ファイル、リソース ファイルなど\) を格納できます。  静的アセンブリは、ディスク上のポータブル実行可能 \(PE\) ファイルに保存されます。  .NET Framework を使用して動的アセンブリを作成することもできます。動的アセンブリはメモリから直接実行され、実行前にディスクに保存されることはありません。  動的アセンブリは、実行後にディスクに保存できます。  
+  
+ アセンブリを作成するには、いくつかの方法があります。  Visual Studio など、これまで .dll ファイルや .exe ファイルの作成に使用してきた開発ツールを使用できます。  他の開発環境で作成されたモジュールを使ってアセンブリを作成するには、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に付属している各種ツールを使用できます。  動的アセンブリの作成には、[Reflection.Emit](frlrfSystemReflectionEmit) などの共通言語ランタイム API も使用できます。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[アセンブリの利点](../Topic/Assembly%20Benefits.md)|バージョン管理上の問題や DLL 競合を解決するうえでアセンブリがどのように役立つかを説明します。|  
+|[アセンブリの内容](../../../docs/framework/app-domains/assembly-contents.md)|アセンブリを構成する要素について説明します。|  
+|[アセンブリ マニフェスト](../../../docs/framework/app-domains/assembly-manifest.md)|アセンブリ マニフェストのデータについて説明し、データをアセンブリに格納する方法について説明します。|  
+|[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)|グローバル アセンブリ キャッシュと、そのキャッシュをアセンブリがどのように使用するかを説明します。|  
+|[厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)|厳密な名前付きアセンブリの特性について説明します。|  
+|[アセンブリのセキュリティに関する考慮事項](../../../docs/framework/app-domains/assembly-security-considerations.md)|セキュリティがアセンブリに対してどのように作用するかを説明します。|  
+|[アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)|.NET Framework のバージョン管理ポリシーの概要を説明します。|  
+|[アセンブリの配置](../../../docs/framework/app-domains/assembly-placement.md)|アセンブリの配置場所について説明します。|  
+|[アセンブリと side\-by\-side 実行](../../../docs/framework/app-domains/assemblies-and-side-by-side-execution.md)|複数のバージョンのランタイムやアセンブリの同時使用の概要について説明します。|  
+|[アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)|アセンブリを作成し、署名し、その属性を設定する方法を説明します。|  
+|[動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)|動的アセンブリの作成方法を説明します。|  
+|[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)|実行時に .NET Framework でアセンブリ参照がどのように解決されるかについて説明します。|  
+  
+## 参照  
+ <xref:System.Reflection.Assembly?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-contents.md b/docs/framework/app-domains/assembly-contents.md
new file mode 100644
index 00000000000..9fbce072a77
--- /dev/null
+++ b/docs/framework/app-domains/assembly-contents.md
@@ -0,0 +1,59 @@
+---
+title: "アセンブリの内容 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], マルチファイル"
+  - "アセンブリ [.NET Framework], 単一ファイル"
+  - "マルチファイル アセンブリ"
+  - "シングルファイル アセンブリ"
+ms.assetid: 28116714-da77-45f7-826d-fa035d121948
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アセンブリの内容
+一般に、静的アセンブリは次の 4 つの要素から構成されます。  
+  
+-   アセンブリ メタデータを保持する[アセンブリ マニフェスト](../../../docs/framework/app-domains/assembly-manifest.md)。  
+  
+-   型メタデータ。  
+  
+-   型を実装する MSIL \(Microsoft Intermediate Language\) コード。  
+  
+-   一連のリソース。  
+  
+ このうち必須なのはアセンブリ マニフェストだけですが、アセンブリになんらかの機能を与えるには、型またはリソースのいずれかが必要になります。  
+  
+ アセンブリのこれらの要素は、いくつかの方法でグループ化できます。  1 つの方法として、次の図に示すように、すべての要素を 1 つの物理ファイルにまとめることができます。  
+  
+ ![MyAssembly.dll](../../../docs/framework/app-domains/media/assemblyover1.gif "assemblyover1")  
+シングルファイル アセンブリ  
+  
+ 別の方法として、1 つのアセンブリの要素を複数のファイルに分けることもできます。  この操作には、コンパイル済みコードのモジュール \(.netmodule\)、リソース \(.bmp ファイルや .jpg ファイルなど\)、アプリケーションで必要なその他のファイルなどを使用できます。  複数の言語で記述されたモジュールを組み合わせたり、使用頻度の低い型を必要なときにだけダウンロードされるモジュールに配置することでアプリケーションのダウンロードを最適化したりする場合は、マルチファイル アセンブリを作成します。  
+  
+ あるアプリケーションの開発において、特定のユーティリティ コードを独立したモジュールに配置し、サイズの大きいリソース ファイル \(ここでは .bmp イメージ\) を元のファイルに残しておく例を次の図に示します。  .NET Framework では、ファイルが参照される場合にだけそのファイルがダウンロードされます。参照頻度の低いコードをアプリケーションとは別のファイルに保存することで、コードのダウンロードが最適化されます。  
+  
+ ![MyAssembly.dll](../../../docs/framework/app-domains/media/assemblyover2.gif "assemblyover2")  
+マルチファイル アセンブリ  
+  
+> [!NOTE]
+>  マルチファイル アセンブリを構成する各ファイルは、ファイル システムによって物理的にリンクされるわけではありません。  これらのファイルはアセンブリ マニフェストによってリンクされ、共通言語ランタイムがこれらのファイルをまとめて管理します。  
+  
+ この例では、MyAssembly.dll に含まれるアセンブリ マニフェストに記述されているように、3 つのファイルがすべて 1 つのアセンブリに属しています。  ファイル システムにとっては、これらは 3 つの独立したファイルです。  Util.netmodule というファイルは、アセンブリ情報を含んでいないため、モジュールとしてコンパイルされています。  アセンブリの作成時に、アセンブリ マニフェストが MyAssembly.dll に追加され、その Util.netmodule および Graphic.bmp との関係が示されます。  
+  
+ ソース コードをデザインするときは、作成するアプリケーションの機能を 1 つのファイルにまとめるのか複数のファイルに分割するのか、分割する場合は機能をどのように分けるのかを明確に決める必要があります。  .NET Framework コードをデザインする場合も同様に、機能を 1 つのアセンブリにまとめるのか複数のアセンブリに分割するのか、分割する場合は機能をどのように分割するのかを決めておく必要があります。  
+  
+## 参照  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [アセンブリ マニフェスト](../../../docs/framework/app-domains/assembly-manifest.md)   
+ [アセンブリのセキュリティに関する考慮事項](../../../docs/framework/app-domains/assembly-security-considerations.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-location.md b/docs/framework/app-domains/assembly-location.md
new file mode 100644
index 00000000000..0eecda734af
--- /dev/null
+++ b/docs/framework/app-domains/assembly-location.md
@@ -0,0 +1,41 @@
+---
+title: "アセンブリの場所 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 位置"
+  - "検索 (アセンブリを)"
+ms.assetid: 9f1f41a7-2954-49d3-a2c0-62b6ef4d40ab
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# アセンブリの場所
+アセンブリの場所は、共通言語ランタイムが参照されるアセンブリの位置を特定できるかどうかを決定します。また、アセンブリをほかのアセンブリと共有できるかどうかも決定します。  アセンブリは、次の場所に配置できます。  
+  
+-   アプリケーションのディレクトリまたはサブディレクトリ  
+  
+     これは、アセンブリの最も一般的な配置場所です。  アプリケーション ルート ディレクトリのサブディレクトリは、言語またはカルチャに基づいて作成できます。  アセンブリにカルチャ属性の情報がある場合、そのアセンブリは、そのカルチャ名を持つアプリケーション ディレクトリの下位のサブディレクトリに配置する必要があります。  
+  
+-   グローバル アセンブリ キャッシュ  
+  
+     これは、共通言語ランタイムがインストールされると常にインストールされる、コンピューター全体のコード キャッシュです。  通常、あるアセンブリを複数のアプリケーションで共有する場合、そのアセンブリをグローバル アセンブリ キャッシュ内にインストールする必要があります。  
+  
+-   HTTP サーバー上  
+  
+     アセンブリを HTTP サーバー上に配置する場合、厳密な名前が必要です。アセンブリへのポインターは、アプリケーション構成ファイルのコードベース セクションで指定します。  
+  
+## 参照  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-manifest.md b/docs/framework/app-domains/assembly-manifest.md
new file mode 100644
index 00000000000..5244b592f0e
--- /dev/null
+++ b/docs/framework/app-domains/assembly-manifest.md
@@ -0,0 +1,66 @@
+---
+title: "アセンブリ マニフェスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], メタデータ"
+  - "アセンブリ マニフェスト"
+  - "カルチャ, アセンブリ マニフェスト"
+  - "動的アセンブリ, アセンブリ マニフェスト"
+  - "メタデータ, アセンブリ マニフェスト"
+ms.assetid: 8e40fab9-549d-4731-aec2-ffa47a382de0
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# アセンブリ マニフェスト
+静的であるか動的であるかにかかわらず、すべてのアセンブリは、アセンブリ内の要素の相互関係を記述したデータのコレクションを含んでいます。  このアセンブリ メタデータは、アセンブリ マニフェストに格納されています。  アセンブリ マニフェストには、アセンブリのバージョン要件およびセキュリティ ID を指定するために必要なすべてのメタデータと、アセンブリのスコープを定義したり、リソースやクラスへの参照を解決したりするために必要なすべてのメタデータが格納されています。  アセンブリ マニフェストは、MSIL \(Microsoft Intermediate Language\) コードが記述されている PE ファイル \(.exe または .dll\)、またはアセンブリ マニフェスト情報だけを格納したスタンドアロンの PE ファイルに保存できます。  
+  
+ マニフェストを格納するさまざまな方法を次の図に示します。  
+  
+ ![単独ファイル アセンブリ](../../../docs/framework/app-domains/media/assemblytypes.gif "assemblytypes")  
+アセンブリの種類  
+  
+ 関連付けられているファイルが 1 つだけのアセンブリの場合、マニフェストは PE ファイルに組み込まれ、シングルファイル アセンブリを形成します。  マルチファイル アセンブリを作成する場合は、スタンドアロンのマニフェスト ファイルか、またはそのアセンブリの PE ファイルのうちの 1 つに組み込んだマニフェストを使用します。  
+  
+ 各アセンブリのマニフェストの機能は次のとおりです。  
+  
+-   アセンブリを構成するファイルを列挙します。  
+  
+-   アセンブリの型およびリソースへの参照を、それらの宣言と実装が格納されているファイルに割り当てる方法を制御します。  
+  
+-   そのアセンブリが依存するほかのアセンブリを列挙します。  
+  
+-   アセンブリのコンシューマーと、アセンブリの詳細な実装との間に間接的な関係を確立します。  
+  
+-   アセンブリを自己記述型にします。  
+  
+## アセンブリ マニフェストの内容  
+ アセンブリ マニフェストに格納されている情報を次の表に示します。  アセンブリ名、バージョン番号、カルチャ、厳密な名前情報という最初の 4 項目は、アセンブリの識別子を構成します。  
+  
+|情報|説明|  
+|--------|--------|  
+|\[アセンブリ名\]|アセンブリの名前を指定するテキスト文字列。|  
+|バージョン番号|メジャー バージョン番号、マイナー バージョン番号、リビジョン番号、およびビルド番号。  共通言語ランタイムは、これらの番号を使用してバージョン ポリシーを強制的に適用します。|  
+|Culture|アセンブリがサポートするカルチャや言語に関する情報。  この情報は、アセンブリをカルチャ固有または言語固有の情報を格納したサテライト アセンブリとして指定する場合にだけ使用します。 カルチャ情報を含むアセンブリは、自動的にサテライト アセンブリと見なされます。|  
+|厳密な名前情報|アセンブリに厳密な名前が付いている場合の発行者からの公開キー。|  
+|アセンブリ内のすべてのファイルのリスト|アセンブリに含まれている各ファイルのハッシュおよびファイル名。  アセンブリを構成するすべてのファイルは、アセンブリ マニフェストが含まれているファイルと同じディレクトリに配置する必要があります。|  
+|型参照情報|型参照をその宣言と実装が格納されているファイルに割り当てるために、ランタイムが使用する情報。  この情報は、アセンブリからエクスポートされた型に対して使用されます。|  
+|参照先アセンブリに関する情報|このアセンブリによって静的に参照されるほかのアセンブリのリスト。  参照される各アセンブリ \(依存アセンブリ\) について、その名前、アセンブリ メタデータ \(バージョン、カルチャ、オペレーティング システムなど\)、アセンブリに厳密な名前が付いている場合は公開キーなどが示されます。|  
+  
+ アセンブリ マニフェストの一部の情報は、コード内でアセンブリ属性を使用することで、追加または変更できます。  バージョン情報や、商標、著作権、製品名、会社名、補足バージョンなどの情報属性は変更できます。  アセンブリ属性の完全なリストについては、「[アセンブリ属性の設定](../../../docs/framework/app-domains/set-assembly-attributes.md)」を参照してください。  
+  
+## 参照  
+ [アセンブリの内容](../../../docs/framework/app-domains/assembly-contents.md)   
+ [アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)   
+ [サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md)   
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-names.md b/docs/framework/app-domains/assembly-names.md
new file mode 100644
index 00000000000..59f7f6f7365
--- /dev/null
+++ b/docs/framework/app-domains/assembly-names.md
@@ -0,0 +1,73 @@
+---
+title: "アセンブリ名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 名前"
+  - "名前 [.NET Framework], アセンブリ"
+ms.assetid: 8f8c2c90-f15d-400e-87e7-a757e4f04d0e
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# アセンブリ名
+アセンブリの名前は、メタデータに格納され、アセンブリのスコープおよびアプリケーションによる使用方法に大きく影響します。  厳密な名前を持つアセンブリは、アセンブリの名前、カルチャ、公開キー、およびバージョン番号を含む完全に限定された名前を持ちます。  この名前は通常、表示名と呼ばれ、ロード済みのアセンブリの場合には <xref:System.Reflection.Assembly.FullName%2A> プロパティを使用することによって取得できます。  
+  
+ ランタイムはこれらの情報を使用して、アセンブリを検索したり、同じ名前を持つ他のアセンブリと区別したりします。  たとえば、`myTypes` という厳密な名前を持つアセンブリが、次のような完全に限定された名前を持つ場合があります。  
+  
+```  
+myTypes, Version=1.0.1234.0, Culture=en-US, PublicKeyToken=b77a5c561934e089c, ProcessorArchitecture=msil  
+```  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では、プロセッサ アーキテクチャがアセンブリ ID に追加されて、アセンブリにプロセッサ固有のバージョンを作成できるようになっています。  たとえば、32 ビット プロセッサ固有のバージョン、64 ビット プロセッサ固有のバージョンのように、ID のプロセッサ アーキテクチャのみが異なっているアセンブリ バージョンを作成できます。  厳密な名前にはプロセッサ アーキテクチャは必要ありません。  詳細については、「<xref:System.Reflection.AssemblyName.ProcessorArchitecture%2A?displayProperty=fullName>」を参照してください。  
+  
+ この例では、完全に限定された名前は `myTypes` アセンブリが公開キー トークンを含む厳密な名前を持ち、カルチャ値が US English であり、バージョン番号が 1.0.1234.0 であることを示します。  そのプロセッサ アーキテクチャは "msil" です。これは、オペレーティング システムとプロセッサに応じて 32 ビット コードまたは 64 ビット コードに Just\-In\-Time \(JIT\) コンパイルされることを意味します。  
+  
+ アセンブリ内で型を要求するコードは、完全に限定されたアセンブリ名を使用する必要があります。  これを完全限定バインディングと呼びます。  アセンブリ名だけを指定する部分バインディングは、.NET Framework でアセンブリを参照するときには使用できません。  
+  
+ .NET Framework を構成するアセンブリに対するすべてのアセンブリ参照には、アセンブリの完全限定名も含まれている必要があります。  たとえば、バージョン 1.0 の System.Data .NET Framework アセンブリを参照する場合は、次のようになります。  
+  
+```  
+  
+System.data, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089  
+  
+```  
+  
+ バージョンは、.NET Framework Version 1.0 に付属するすべての .NET Framework アセンブリのバージョン番号に相当します。  .NET Framework アセンブリでは、カルチャ値は常にニュートラルであり、公開キーは前の例の公開キーと同じです。  
+  
+ たとえば、構成ファイルにトレース リスナーを設定するアセンブリ参照を追加するには、システム .NET Framework アセンブリの完全限定名を含めます。  
+  
+```  
+<add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
+```  
+  
+> [!NOTE]
+>  ランタイムは、アセンブリへのバインディング時にはアセンブリ名の大文字と小文字を区別しませんが、アセンブリ名で使用された大文字と小文字は保持されます。  [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] のいくつかのツールでは、アセンブリ名の大文字と小文字が区別されます。  大文字と小文字は区別されるものとしてアセンブリ名を管理するのが無難です。  
+  
+## アプリケーション コンポーネントの名前付け  
+ ランタイムは、アセンブリを識別するときにファイル名を認識しません。  アセンブリの ID は、アセンブリ名、バージョン、カルチャおよび厳密な名前から構成され、ランタイムによって明確に認識される必要があります。  
+  
+ たとえば、myAssembly.dll という名前のアセンブリを参照する myAssembly.exe という名前のアセンブリがある場合は、myAssembly.exe を実行するとバインディングが正しく行われます。  しかし、別のアプリケーションが <xref:System.AppDomain.ExecuteAssembly%2A?displayProperty=fullName> メソッドを使用して myAssembly.exe を実行した場合は、myAssembly.exe が "myAssembly" に対するバインディングを要求しても、ランタイムは "myAssembly" が既に読み込まれているものと判断します。この場合、myAssembly.dll が読み込まれることはありません。  myAssembly.exe には要求された型が含まれていないため、<xref:System.TypeLoadException> が発生します。  
+  
+ この問題を回避するには、アプリケーション内で複数のアセンブリが同じアセンブリ名を持たないようにするか、または同じ名前を持つアセンブリをそれぞれ異なるディレクトリに配置します。  
+  
+> [!NOTE]
+>  厳密な名前付きアセンブリをグローバル アセンブリ キャッシュに配置する場合、.exe や .dll などのファイル名の拡張子を除いたアセンブリのファイル名とアセンブリ名とが一致している必要があります。  たとえば、アセンブリのファイル名が myAssembly.dll である場合、アセンブリ名は myAssembly である必要があります。  ルート アプリケーション ディレクトリ内にだけ配置されるプライベート アセンブリは、ファイル名と異なるアセンブリ名を持つことができます。  
+  
+## 参照  
+ [方法 : アセンブリの完全修飾名を特定する](../../../docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md)   
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-placement.md b/docs/framework/app-domains/assembly-placement.md
new file mode 100644
index 00000000000..c69494cdd2e
--- /dev/null
+++ b/docs/framework/app-domains/assembly-placement.md
@@ -0,0 +1,33 @@
+---
+title: "アセンブリの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "<codeBase> 要素"
+  - "アセンブリ [.NET Framework], 位置"
+  - "アセンブリ [.NET Framework], 配置"
+  - "検索 (アセンブリを)"
+ms.assetid: ff8d48bc-f606-484f-9fe1-d0af264269fb
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# アセンブリの配置
+多くの .NET Framework アプリケーションの場合、アプリケーションを構成するアセンブリは、そのアプリケーションのディレクトリ、アプリケーション ディレクトリのサブディレクトリ、またはグローバル アセンブリ キャッシュ \(アセンブリが共有されている場合\) に配置します。  構成ファイルの [\<codeBase\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) を使用すると、共通言語ランタイムがアセンブリを検索する場所をオーバーライドできます。  アセンブリが厳密な名前を持たない場合、[\<codeBase\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) を使用して指定できる場所は、そのアプリケーションのディレクトリまたはサブディレクトリに制限されます。  アセンブリが厳密な名前を持つ場合は、[\<codeBase\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) を使用してコンピューターまたはネットワーク上の任意の場所を指定できます。  
+  
+ また、アンマネージ コード アプリケーションや COM 相互運用アプリケーションで使用するアセンブリを検索する場所についても似たような規則が適用されます。アセンブリを複数のアプリケーションで共有する場合、そのアセンブリの検索場所はグローバル アセンブリ キャッシュになります。  アンマネージ コードで使用するアセンブリは、型ライブラリとしてエクスポートし、登録する必要があります。  COM 相互運用で使用するアセンブリは、カタログに登録する必要がありますが、場合によっては、この登録が自動的に行われることもあります。  
+  
+## 参照  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アプリの構成](../../../docs/framework/configure-apps/index.md)   
+ [Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-security-considerations.md b/docs/framework/app-domains/assembly-security-considerations.md
new file mode 100644
index 00000000000..d5c5136d304
--- /dev/null
+++ b/docs/framework/app-domains/assembly-security-considerations.md
@@ -0,0 +1,70 @@
+---
+title: "アセンブリのセキュリティに関する考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], セキュリティ"
+  - "アセンブリ [.NET Framework], 署名"
+  - "アセンブリ [.NET Framework], 厳密な名前を付けた"
+  - "付与 (アクセス許可の), アセンブリ"
+  - "整合性 (アセンブリとの)"
+  - "名前 [.NET Framework], アセンブリ"
+  - "名前 [.NET Framework], 厳密な名前"
+  - "アクセス許可 [.NET Framework], アセンブリ"
+  - "セキュリティ [.NET Framework], アセンブリ"
+  - "Signcode"
+  - "署名 (アセンブリに)"
+  - "厳密な名前を付けたアセンブリ, セキュリティの注意事項"
+ms.assetid: 1b5439c1-f3d5-4529-bd69-01814703d067
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# アセンブリのセキュリティに関する考慮事項
+アセンブリを作成する場合は、アセンブリの実行に必要となるアクセス許可セットを指定できます。  アセンブリに対して特定のアクセス許可を付与するかどうかは、証拠に基づいて決定されます。  
+  
+ 証拠には 2 つの使い方があります。  
+  
+-   入力された証拠をローダーによって収集された証拠とマージして、ポリシーの解決に使用される最終的な証拠のセットを作成します。  この形式を使用するメソッドには、**Assembly.Load**、**Assembly.LoadFrom**、および **Activator.CreateInstance** があります。  
+  
+-   入力された証拠を変更せずに、ポリシーの解決に使用する最終的な証拠のセットとして使用します。  この形式を使用するメソッドには、**Assembly.Load\(byte\[\]\)** および **AppDomain.DefineDynamicAssembly\(\)** があります。  
+  
+ アセンブリが実行されるコンピューターで設定されている[セキュリティ ポリシー](../../../docs/framework/misc/code-access-security-basics.md)により、オプションのアクセス許可を与えることもできます。  発生する可能性があるセキュリティ例外をすべて処理するコードを作成するには、次のいずれかを行います。  
+  
+-   コードを実行するために必要なすべてのアクセス許可に対してアクセス許可要求を挿入し、アクセス許可が与えられなかった場合に生じる読み込み時エラーをあらかじめ処理しておく。  
+  
+-   コードを実行するために必要なアクセス許可を取得するためのアクセス許可要求は使用せず、アクセス許可が与えられなかった場合のセキュリティ例外を処理できるように準備しておく。  
+  
+    > [!NOTE]
+    >  セキュリティは複雑な分野で、選択できるオプションも数多くあります。  詳細については、「[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)」を参照してください。  
+  
+ アセンブリの読み込み時に、セキュリティ ポリシーへの追加情報としてアセンブリの証拠が使用されます。  セキュリティ ポリシーは、エンタープライズとコンピューターの管理者、およびユーザー ポリシー設定によって確立され、すべてのマネージ コードが実行されるときに与えられるアクセス許可セットを決定します。  セキュリティ ポリシーは、アセンブリの発行者 \(署名ツールで生成されたシグネチャがある場合\)、アセンブリのダウンロード元の Web サイトおよびゾーン \(Internet Explorer の用語\)、またはアセンブリの厳密な名前に対して設定できます。  たとえば、コンピューター管理者は、Web サイトからダウンロードされ、所定のソフトウェア企業の署名のあるすべてのコードについて、コンピューター上のデータベースへのアクセスは許可するが、ディスクへの書き込みは許可しない、というセキュリティ ポリシーを設定できます。  
+  
+## 厳密な名前付きアセンブリと署名ツール  
+ アセンブリの署名は、2 つの異なる補完的な方法で行うことができます。厳密な名前を使用するか、.NET Framework Version 1.0 と 1.1 の [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または .NET Framework のそれ以降のバージョンの [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用する方法です。  厳密な名前を使用してアセンブリに署名すると、アセンブリ マニフェストを格納しているファイルに公開キー暗号化が追加されます。  厳密な名前による署名では、名前の一意性の検証を支援し、名前の悪用を防止し、参照が解決されたときに呼び出し元に ID を提供できます。  
+  
+ しかし、厳密な名前そのものには信頼性がないため、信頼性という点では [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) および [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) が重要になります。  2 つの署名ツールでは、発行者が第三者機関に対して自分の身元を証明し、証明書を取得する必要があります。  取得した証明書はファイルに埋め込まれ、管理者はその証明書を使用してコードの正当性を信頼するかどうかを判断します。  
+  
+ アセンブリには、厳密な名前と [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用して作成されたデジタル署名の両方を与えるか、またはそのいずれか一方だけを適用できます。  2 つの署名ツールでは、署名できるファイルは一度に 1 つだけです。マルチファイル アセンブリの場合は、アセンブリ マニフェストを格納しているファイルに署名します。  厳密な名前はアセンブリ マニフェストが格納されているファイルに保存されますが、[File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用して作成された署名は、アセンブリ マニフェストが格納されているポータブル実行可能 \(PE: Portable Executable\) ファイルの予約された専用スロットに保存されます。  [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用するアセンブリに対する署名は、[File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) で生成された署名に依存する信頼階層が既に存在する場合や、またはポリシーがキー部分だけを使用し、信頼階層はチェックしていない場合に、\(厳密な名前と組み合わせて、または単独で\) 使用できます。  
+  
+> [!NOTE]
+>  アセンブリに対して厳密な名前と署名ツールの署名の両方を使用する場合は、厳密な名前を先に割り当てる必要があります。  
+  
+ 共通言語ランタイムは、ハッシュ検査も実行します。アセンブリ マニフェストには、アセンブリを構成するすべてのファイルのリストが格納されており、マニフェスト作成時の状態の各ファイルのハッシュも含まれています。  各ファイルが読み込まれたときに、その内容がハッシュされ、マニフェストに格納されているハッシュ値と比較されます。  2 つのハッシュが一致しない場合、アセンブリは読み込まれません。  
+  
+ 厳密な名前と[File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または[SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用する署名によって整合性が保証されるため、これら 2 種類のアセンブリ証拠に基づいてコード アクセス セキュリティ ポリシーを設定できます。  厳密な名前と [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用する署名では、デジタル署名と証明書によって整合性が保証されます。  以上で述べた技術 \(ハッシュ検査、厳密な名前、[File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db) または [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md) を使用する署名\) をすべて組み合わせて使用することで、アセンブリがどのような方法によっても変更されていないことが保証されます。  
+  
+## 参照  
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md)   
+ [File Signing Tool \(Signcode.exe\)](http://msdn.microsoft.com/ja-jp/2d299154-34ea-41ba-ad12-17075bb7e1db)
\ No newline at end of file
diff --git a/docs/framework/app-domains/assembly-versioning.md b/docs/framework/app-domains/assembly-versioning.md
new file mode 100644
index 00000000000..25533944863
--- /dev/null
+++ b/docs/framework/app-domains/assembly-versioning.md
@@ -0,0 +1,82 @@
+---
+title: "アセンブリのバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], バージョン管理"
+  - "補足バージョン"
+  - "解決 (アセンブリ バインディング要求を)"
+  - "バージョン番号, アセンブリ"
+  - "バージョン管理, アセンブリ"
+ms.assetid: 775ad4fb-914f-453c-98ef-ce1089b6f903
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アセンブリのバージョン管理
+共通言語ランタイムを使用するアセンブリのバージョン管理は、すべてアセンブリ レベルで行われます。  アセンブリの特定のバージョン、および依存する各アセンブリのバージョンは、アセンブリのマニフェストに記録されます。  ランタイムの既定のバージョン ポリシーは、構成ファイル \(アプリケーション構成ファイル、発行者ポリシー ファイル、コンピューター管理者の構成ファイル\) に指定した明示的なバージョン ポリシーでオーバーライドされない限り、アプリケーションが作成およびテストされた時点のバージョンの場合にだけそのアプリケーションを実行します。  
+  
+> [!NOTE]
+>  バージョン管理は、厳密な名前付きのアセンブリに対してだけ実行されます。  
+  
+ ランタイムは、アセンブリ バインディング要求を解決するために、いくつかの手順を実行します。  
+  
+1.  元のアセンブリ参照を確認し、バインド先のアセンブリのバージョンを確認します。  
+  
+2.  バージョン ポリシーを適用するために利用できる構成ファイルをすべてチェックします。  
+  
+3.  元のアセンブリ参照と、構成ファイルで指定されているリダイレクトから正しいアセンブリを判断し、呼び出し元のアセンブリにバインドされるバージョンを判断します。  
+  
+4.  グローバル アセンブリ キャッシュと、構成ファイルで指定されたコードベースをチェックした後、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」に説明されているプローブ規則を使用して、アプリケーションのディレクトリとサブディレクトリをチェックします。  
+  
+ これらの手順を次の図に示します。  
+  
+ ![.assembly extern myAssembly](../../../docs/framework/app-domains/media/versioningover.gif "versioningover")  
+アセンブリ バインディング要求の解決  
+  
+ アプリケーションの設定の詳細については、「[アプリの構成](../../../docs/framework/configure-apps/index.md)」を参照してください。  バインディング ポリシーの詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+## バージョン情報  
+ 各アセンブリは、次の 2 種類の形でバージョン情報を表示します。  
+  
+-   アセンブリのバージョン番号。アセンブリ名やカルチャ情報と共に、アセンブリの識別子を構成します。  この番号は、バージョン ポリシーを強制適用するためにランタイムで使用され、実行時の型解決プロセスで重要な役割を果たします。  
+  
+-   補足バージョン。これは、情報の提供だけを目的とした、追加のバージョン情報を表す文字列です。  
+  
+### アセンブリのバージョン番号  
+ 各アセンブリの識別子には、バージョン番号が含まれています。  そのため、バージョン番号が異なる 2 つのアセンブリは、ランタイムでは、まったく異なるアセンブリと見なされます。  このバージョン番号は、次に示す形式の 4 つの部分から成る文字列として表されます。  
+  
+ \<メジャー バージョン\>.\<マイナー バージョン\>.\<ビルド番号\>.\<リビジョン\>  
+  
+ たとえばバージョン 1.5.1254.0 の場合、1 はメジャー バージョン、5 はマイナー バージョン、1254 はビルド番号、0 はリビジョン番号を表します。  
+  
+ バージョン番号は、アセンブリ名や公開キーなどのほかの識別子情報や、アプリケーションに関連付けられているほかの複数のアセンブリの関係や識別子に関する情報と共に、アセンブリ マニフェストに保存されます。  
+  
+ アセンブリの作成時に、開発ツールによって、アセンブリ マニフェストで参照される各アセンブリについての依存情報が記録されます。  ランタイムは、これらのバージョン番号と、管理者、アプリケーション、または発行者が設定した構成情報を組み合わせて使用し、参照先アセンブリの正しいバージョンを読み込みます。  
+  
+ バージョン管理の目的のため、ランタイムでは、通常の名前の付いたアセンブリと、厳密な名前の付いたアセンブリが区別されます。  バージョンのチェックは、厳密な名前付きのアセンブリに対してだけ実行されます。  
+  
+ バージョン バインディング ポリシーの指定については、「[アプリの構成](../../../docs/framework/configure-apps/index.md)」を参照してください。  ランタイムがバージョン情報を使用して特定のアセンブリを見つけ出す方法については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+### アセンブリの補足バージョン  
+ 補足バージョンは、情報の提供だけを目的として、追加のバージョン情報をアセンブリに追加するための文字列です。この情報は実行時には使用されません。  補足バージョンはテキスト ベースで、その製品のマーケティング資料、パッケージ、あるいは製品名に対応するものであり、実行時には使用されません。  たとえば、補足バージョンの例は "共通言語ランタイム バージョン 1.0" や "NET Control SP 2" などになります。  Microsoft Windows のファイル プロパティ ダイアログの \[バージョン\] タブでは、この情報は \[製品バージョン\] という項目に表示されます。  
+  
+> [!NOTE]
+>  任意のテキストを指定できますが、文字列がアセンブリのバージョン番号で使用されている形式でなかったり、形式が正しくてもワイルドカードを含んでいたりすると、コンパイルで警告メッセージが表示されます。  この警告は、実行には影響を与えません。  
+  
+ 補足バージョンは、カスタム属性 <xref:System.Reflection.AssemblyInformationalVersionAttribute?displayProperty=fullName> を使って表されます。  補足バージョン属性の詳細については、「[アセンブリ属性の設定](../../../docs/framework/app-domains/set-assembly-attributes.md)」を参照してください。  
+  
+## 参照  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アプリの構成](../../../docs/framework/configure-apps/index.md)   
+ [アセンブリ属性の設定](../../../docs/framework/app-domains/set-assembly-attributes.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/create-and-use-strong-named-assemblies.md b/docs/framework/app-domains/create-and-use-strong-named-assemblies.md
new file mode 100644
index 00000000000..ec231a1b6be
--- /dev/null
+++ b/docs/framework/app-domains/create-and-use-strong-named-assemblies.md
@@ -0,0 +1,94 @@
+---
+title: "厳密な名前付きアセンブリの作成と使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 署名"
+  - "アセンブリ [.NET Framework], 厳密な名前を付けた"
+  - "アセンブリのバインディング, 厳密な名前を付けた"
+  - "署名 (アセンブリに)"
+  - "厳密な名前のバイパス機能"
+  - "厳密な名前を付けたアセンブリ"
+  - "厳密な名前を付けたアセンブリ, 厳密な名前付きアセンブリの概要"
+  - "厳密な名前を付けたアセンブリ, 読み込み (信頼されたアプリケーション ドメインへの)"
+  - "厳密な名前を付けたアセンブリ, シナリオ"
+ms.assetid: ffbf6d9e-4a88-4a8a-9645-4ce0ee1ee5f9
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 厳密な名前付きアセンブリの作成と使用
+厳密な名前は、単純テキスト名、バージョン番号、カルチャ情報 \(設定されている場合\) から成るアセンブリの識別子と、公開キーおよびデジタル署名で構成されます。  このデジタル署名は、対応する秘密キーを使用してアセンブリ ファイルから生成されます。  \(アセンブリ ファイルにはアセンブリ マニフェストが格納されており、そこに、アセンブリを構成するすべてのファイルの名前とハッシュが含まれます。\)  
+  
+ 厳密な名前のアセンブリは、他の厳密な名前のアセンブリでのタイプだけを使用できます。  それ以外の場合は、厳密な名前のアセンブリのセキュリティが損なわれます。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [厳密な名前のシナリオ](#strong_name_scenario)  
+  
+-   [信頼されたアセンブリの署名検証のバイパス](#bypassing_signature_verification)  
+  
+-   [関連トピック](#related_topics)  
+  
+<a name="strong_name_scenario"></a>   
+## 厳密な名前のシナリオ  
+ 次のシナリオは、厳密な名前のアセンブリに署名した後にそれをその名前で参照するプロセスの概要を示しています。  
+  
+1.  アセンブリ A は、次のいずれかの方法を使用して厳密な名前で作成されます。  
+  
+    -   [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] など、厳密な名前の作成をサポートする開発環境を使用する。  
+  
+    -   [厳密名ツール \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用して暗号化キー ペアを作成し、コマンド ライン コンパイラまたは[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) のいずれかを使用してそのキー ペアをアセンブリに割り当てる。  Windows ソフトウェア開発キット \(SDK\) には、Sn.exe と Al.exe の両方が用意されています。  
+  
+2.  開発環境またはツールは、アセンブリのマニフェストを含むファイルのハッシュに、開発者の秘密キーで署名します。  このデジタル署名は、アセンブリ A のマニフェストを含むポータブル実行可能 \(PE\) ファイルに格納されます。  
+  
+3.  アセンブリ B はアセンブリ A のコンシューマーです。  アセンブリ B のマニフェストの参照セクションには、アセンブリ A の公開キーを表すトークンが含まれています。  トークンは完全な公開キーの一部であり、スペースを節約するために、キー自体ではなくこれが使用されます。  
+  
+4.  共通言語ランタイムは、アセンブリがグローバル アセンブリ キャッシュに入れられる際に、厳密な名前の署名を確認します。  実行時に厳密な名前でバインドするとき、共通言語ランタイムは、アセンブリ B のマニフェストに格納されているキーと、アセンブリ A の厳密な名前を生成するために使用されたキーを比較します。  .NET Framework のセキュリティ チェックに合格してバインドが成功すると、アセンブリ B は、アセンブリ A のビットが改ざんされていないことと、これらのビットが実際にアセンブリ A の開発者からのものであることが保証されます。  
+  
+> [!NOTE]
+>  このシナリオは、信頼の問題を扱っていません。  厳密な名前に加えて、完全な Microsoft Authenticode 署名をアセンブリに持たせることができます。  Authenticode 署名には、信頼を確立するための証明書が含まれます。  厳密な名前を使用すると、コードにこのように署名する必要がないということに注意してください。  実際に、厳密な名前の署名の生成に使用されるキーは、Authenticode 署名の生成に使用されるキーと同じである必要はありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="bypassing_signature_verification"></a>   
+## 信頼されたアセンブリの署名検証のバイパス  
+ [!INCLUDE[net_v35SP1_long](../../../includes/net-v35sp1-long-md.md)] 以降、たとえば `MyComputer` ゾーンの既定のアプリケーション ドメインなど、完全に信頼されたアプリケーション ドメインにアセンブリが読み込まれるときに、厳密な名前の署名は検証されなくなりました。  これは厳密な名前のバイパス機能と呼ばれます。  完全に信頼された環境では、<xref:System.Security.Permissions.StrongNameIdentityPermission> に対する完全に信頼された署名済みアセンブリの要求は、その署名に関係なく、常に成功します。  このような場合、厳密な名前のバイパス機能は、完全に信頼されたアセンブリの厳密名署名検証という不要なオーバーヘッドを回避するので、アセンブリを高速で読み込むことができます。  
+  
+ バイ パス機能は、厳密な名前で署名されていて、次の特性を持つアセンブリに適用されます。  
+  
+-   <xref:System.Security.Policy.StrongName> 証拠なしで完全に信頼されている \(たとえば、`MyComputer` ゾーン証拠を持っている\)。  
+  
+-   完全に信頼された <xref:System.AppDomain> に読み込まれる。  
+  
+-   その <xref:System.AppDomain> の <xref:System.AppDomainSetup.ApplicationBase%2A> プロパティに基づいた場所から読み込まれる。  
+  
+-   遅延署名されていない。  
+  
+ この機能は、個々のアプリケーションに対して、またはコンピューターに対して無効にすることができます。  「[方法 : 厳密な名前のバイパス機能を無効にする](../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[方法 : 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)|署名とアセンブリの暗号化キー ペアを作成する方法について説明します。|  
+|[方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)|厳密な名前のアセンブリを作成する方法について説明します。|  
+|[拡張された厳密な名前付け](../../../docs/framework/app-domains/enhanced-strong-naming.md)|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] での厳密な名前の拡張について説明します。|  
+|[方法 : 厳密な名前のアセンブリを参照する](../../../docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md)|コンパイル時または実行時に厳密な名前のアセンブリでタイプまたはリソースを参照する方法について説明します。|  
+|[方法 : 厳密な名前のバイパス機能を無効にする](../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)|厳密な名前の署名の検証をバイパスする機能を無効にする方法について説明します。  すべてのまたは特定のアプリケーションに対して、この機能を無効にすることができます。|  
+|[アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)|単一ファイル アセンブリおよびマルチファイル アセンブリの概要を示します。|  
+|[NIB: How to: Delay Sign an Assembly \(Visual Studio\)](http://msdn.microsoft.com/ja-jp/cab63b7a-591e-4674-b236-d77cd29a79ea)|アセンブリを作成した後に厳密な名前でアセンブリに署名する方法について説明します。|  
+|[Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)|厳密な名前のアセンブリの作成に役立つ、.NET Framework に付属のツールについて説明します。  このツールには、キーの管理、署名の生成、署名の検査に関する各オプションが用意されています。|  
+|[Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)|モジュールまたはリソース ファイルからアセンブリ マニフェストを含むファイルを生成する、.NET Framework に付属のツールについて説明します。|
\ No newline at end of file
diff --git a/docs/framework/app-domains/create-assemblies.md b/docs/framework/app-domains/create-assemblies.md
new file mode 100644
index 00000000000..bf03b404849
--- /dev/null
+++ b/docs/framework/app-domains/create-assemblies.md
@@ -0,0 +1,59 @@
+---
+title: "アセンブリの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 作成"
+  - "アセンブリ [.NET Framework], マルチファイル"
+  - "マルチファイル アセンブリ"
+  - "シングルファイル アセンブリ"
+ms.assetid: 54832ee9-dca8-4c8b-913c-c0b9d265e9a4
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アセンブリの作成
+[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] などの IDE、または [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に用意されているコンパイラとツールを使用して、シングルファイル アセンブリまたはマルチファイル アセンブリを作成できます。  最も単純なアセンブリであるシングルファイル アセンブリは、簡易名を持ち、1 つのアプリケーション ドメインに読み込まれます。  このアセンブリは、アプリケーション ディレクトリの外部にあるほかのアセンブリからは参照できず、バージョン チェックの対象にもなりません。  このアセンブリで構成されるアプリケーションをアンインストールするには、アセンブリが格納されているディレクトリを削除するだけですみます。  多くの開発者にとって、これらの機能を持つアセンブリは、アプリケーションの配置に必要なすべての機能を持っています。  
+  
+ 複数のコード モジュールとリソース ファイルからマルチファイル アセンブリを作成できます。  複数のアプリケーションで共有するアセンブリを作成することもできます。  共有されるアセンブリは、厳密な名前を持つ必要があり、グローバル アセンブリ キャッシュ内に配置できます。  
+  
+ コード モジュールとリソースをグループ化したアセンブリを作成するときには、次の要素に基づいたいくつかのオプションを指定できます。  
+  
+-   バージョン管理  
+  
+     同じバージョン情報を持つモジュールをグループ化します。  
+  
+-   配置  
+  
+     使用する配置モデルをサポートするコード モジュールおよびリソースをグループ化します。  
+  
+-   再利用  
+  
+     用途別にまとめて論理的に使用できる場合、モジュールをグループ化します。  たとえば、プログラム保守のための、あまり使用しない型とクラスで構成されるアセンブリは、同じアセンブリに配置できます。  さらに、複数のアプリケーションで共有する型は、アセンブリ内にグループ化して厳密な名前で署名する必要があります。  
+  
+-   Security  
+  
+     同じセキュリティ アクセス許可を必要とする複数の型を含むモジュールをグループ化します。  
+  
+-   スコープの指定  
+  
+     参照可能範囲が同じアセンブリ内に制限されている型を含むモジュールをグループ化します。  
+  
+ 共通言語ランタイムアセンブリをアンマネージ COM アプリケーションで使用できるようにする場合は、特別な考慮が必要です。  アンマネージ コードの使用の詳細については、「[COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)」を参照してください。  
+  
+## 参照  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)   
+ [アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)   
+ [方法: シングルファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-single-file-assembly.md)   
+ [方法 : マルチファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-multifile-assembly.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [マルチファイル アセンブリ](../../../docs/framework/app-domains/multifile-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/delay-sign-assembly.md b/docs/framework/app-domains/delay-sign-assembly.md
new file mode 100644
index 00000000000..4ba4c9d5667
--- /dev/null
+++ b/docs/framework/app-domains/delay-sign-assembly.md
@@ -0,0 +1,80 @@
+---
+title: "アセンブリへの遅延署名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "延期 (アセンブリ署名の)"
+  - "署名 (アセンブリに)"
+  - "アセンブリ [.NET Framework]、署名"
+  - "厳密な名前を付けたアセンブリ、遅延 (アセンブリ署名の)"
+  - "部分アセンブリ署名"
+ms.assetid: 9d300e17-5bf1-4360-97da-2aa55efd9070
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# アセンブリへの遅延署名
+開発者側が日常的にアクセスしないキー ペアを、組織で厳重に保護できます。  公開キーは多くのユーザーが使用できることもありますが、秘密キーにアクセスできるユーザーはごくわずかです。  厳密な名前付きのアセンブリを開発する場合、厳密な名前付きの対象アセンブリを参照する各アセンブリには、対象アセンブリに厳密な名前を付けるために使用された公開キーのトークンを格納します。  そのためには、開発プロセス中に公開キーを使用できる必要があります。  
+  
+ ビルド時に遅延署名または部分署名を使用すると、ポータブル実行可能 \(PE\) ファイルの領域を厳密な名前の署名のために予約できます。しかし、実際の署名は後の段階 \(通常はアセンブリの出荷直前\) まで遅れます。  
+  
+ アセンブリに遅延署名する手順の概要を次に示します。  
+  
+1.  最終的な署名を行う組織からキー ペアの公開キー部分を取得します。  通常、このキーは .snk ファイル形式です。このファイルは、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に用意されている[厳密名ツール \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用して作成できます。  
+  
+2.  <xref:System.Reflection> の 2 つのカスタム属性を使用して、アセンブリのソース コードに注釈を付けます。  
+  
+    -   <xref:System.Reflection.AssemblyKeyFileAttribute> は、公開キーを格納するファイルの名前をパラメーターとしてコンストラクターに渡します。  
+  
+    -   <xref:System.Reflection.AssemblyDelaySignAttribute> は、遅延署名を使用していることを示すために、**true** をパラメーターとしてコンストラクターに渡します。  たとえば、次のようになります。  
+  
+         [!code-cpp[AssemblyDelaySignAttribute#4](../../../samples/snippets/cpp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cpp/source2.cpp#4)]
+         [!code-csharp[AssemblyDelaySignAttribute#4](../../../samples/snippets/csharp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cs/source2.cs#4)]
+         [!code-vb[AssemblyDelaySignAttribute#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AssemblyDelaySignAttribute/vb/source2.vb#4)]  
+  
+3.  コンパイラは、公開キーをアセンブリ マニフェストに挿入し、PE ファイル内の領域を完全な厳密な名前の署名のために予約します。  実際の公開キーはアセンブリのビルド中に格納してください。これにより、このアセンブリを参照するほかのアセンブリが、それぞれのアセンブリ参照に格納するキーを取得できるようになります。  
+  
+4.  アセンブリには有効な厳密な名前の署名がないため、厳密な名前の署名の検証をオフにする必要があります。  検証をオフにするには、厳密名ツールで **–Vr** オプションを使用します。  
+  
+     アセンブリ `myAssembly.dll` の検証をオフにする例を次に示します。  
+  
+    ```  
+    sn –Vr myAssembly.dll  
+    ```  
+  
+     レジストリ ファイルを作成するために使用 **–Vk** オプション厳密名ツール、RISC コンピューター \(ARM\) の詳細マイクロプロセッサなどの実行できないプラットフォームの検証を無効にする。  検証をオフにするコンピューターのレジストリにレジストリ ファイルをインポートします。  次の例では `myAssembly.dll`のレジストリ ファイルを作成します。  
+  
+    ```  
+    sn –Vk myRegFile.reg myAssembly.dll  
+    ```  
+  
+     **–Vr** または **–Vk** オプションを使用すると、必要に応じてテスト キーの署名の .snk ファイルを含めることができます。  
+  
+    > [!CAUTION]
+    >  開発時にだけ **\-Vr** または **–Vk** オプションを使用します。  検証省略リストにアセンブリを追加すると、セキュリティ上の脆弱性が生じます。  悪意のあるアセンブリは、検証省略リストに追加されたアセンブリの完全限定アセンブリ名 \(アセンブリ名、バージョン、カルチャ、および公開キー トークン\) を使用することによって、その ID を偽装できます。  これによって、悪意のあるアセンブリの検証も省略できます。  
+  
+    > [!NOTE]
+    >  64 ビット コンピューターで Visual Studio を使用して開発しているときに遅延署名を使用し、**\[Any CPU\]** のアセンブリをコンパイルする場合は、**\-Vr** オプションを 2 回適用することが必要な場合があります \(Visual Studio では、**\[Any CPU\]** は **\[プラットフォーム ターゲット\]** ビルド プロパティの値です。コマンド ラインからコンパイルする場合は、これが既定です\)。コマンド ラインまたはファイル エクスプローラーからアプリケーションを実行するには、アセンブリに **\-Vr** オプションを適用するために [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) の 64 ビット バージョンを使用します。  デザイン時にアセンブリを Visual Studio に読み込むには \(たとえば、アセンブリに、アプリケーションの他のアセンブリで使用されているコンポーネントが含まれている場合\)、32 ビット バージョンの厳密名ツールを使用します。  これは、Just\-In\-Time \(JIT\) コンパイラが、アセンブリがコマンド ラインから実行される場合にはアセンブリを 64 ビット ネイティブ コードにコンパイルし、アセンブリがデザイン時環境に読み込まれる場合には 32 ビット ネイティブ コードにコンパイルするためです。  
+  
+5.  その後、通常は出荷の直前に、アセンブリを組織の署名機関に送信し、**–R** オプション付きで厳密名ツールを使用して、実際の厳密な名前の署名を取得します。  
+  
+     `sgKey.snk` キー ペアを使用して厳密な名前でアセンブリ `myAssembly.dll` に署名する例を次に示します。  
+  
+    ```  
+    sn -R myAssembly.dll sgKey.snk  
+    ```  
+  
+## 参照  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [方法 : 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)   
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/enhanced-strong-naming.md b/docs/framework/app-domains/enhanced-strong-naming.md
new file mode 100644
index 00000000000..139ae137346
--- /dev/null
+++ b/docs/framework/app-domains/enhanced-strong-naming.md
@@ -0,0 +1,115 @@
+---
+title: "拡張された厳密な名前付け | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "厳密な名前付け [.NET Framework], 拡張"
+  - "厳密な名前を付けたアセンブリ"
+ms.assetid: 6cf17a82-62a1-4f6d-8d5a-d7d06dec2bb5
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 拡張された厳密な名前付け
+厳密な名前の署名は、アセンブリを識別するための .NET Framework の識別機構です。  これは通常、発行元 \(署名者\) から受取人 \(検証者\) に対して渡されるデータの整合性を検証するために使用される、公開キーによるデジタル署名です。  この署名はアセンブリに対する一意の ID として使用され、これによりアセンブリへの参照のあいまいさをなくします。  アセンブリはビルド プロセスの一部として署名され、読み込まれるときに検証されます。  
+  
+ 厳密な名前の署名により、悪意のあるユーザーがアセンブリを不正に変更して、元の署名者のキーでアセンブリを再署名することを防ぐことができます。  ただし、厳密な名前キーには、発行者に関する信頼できる情報も、証明書の階層構造も含まれていません。  厳密な名前の署名は、アセンブリの署名者の信頼性を保証するものではなく、またその署名者がキーの正当な所有者であることを示すものでもありません。厳密な名前の署名は、キーの所有者がアセンブリに署名したことのみを示しています。  したがって、信頼できるサードパーティのコードのためのセキュリティの検証コントロールとして、厳密な名前の署名を使用することはお勧めしません。  コードを認証するために推奨される方法は、Microsoft Authenticode です。  
+  
+## 従来の厳密な名前の制限  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以前のバージョンで使用されている厳密な名前付けのテクノロジには次の欠点があります。  
+  
+-   キーが常に攻撃を受ける状態に置かれています。テクノロジとハードウェアの向上により、公開キーから秘密キーを推測することが容易になっています。  攻撃からの保護には、より大きなキーが必要です。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] より前のバージョンでは任意のサイズのキー \(既定のサイズは 1024 ビット\) で署名する機能を提供していますが、新しいキーでアセンブリを署名すると、アセンブリの古い ID を参照しているすべてのバイナリが動作しなくなります。  したがって、互換性を維持する場合には、署名キーのサイズの更新は非常に困難です。  
+  
+-   厳密な名前の署名は SHA\-1 アルゴリズムのみをサポートします。  SHA\-1 は、最近、セキュリティが強化されたハッシュ アプリケーションのためには不十分であることがわかりました。  したがって、より強力なアルゴリズム \(SHA\-256 以上\) が必要です。  SHA\-1 は FIPS 準拠の地位を失う可能性があり、これによって FIPS 準拠のソフトウェアとアルゴリズムのみを選択して使用しているユーザーには問題が生じることになります。  
+  
+## 強化された厳密な名前の利点  
+ 強化された厳密な名前の主な利点は、既存の厳密な名前との互換性と、ある ID が別の ID と等価であることを指定できる機能です。  
+  
+-   既存の署名付きアセンブリを持つ開発者は、以前の ID を参照するアセンブリとの互換性を保ちながら、それらのアセンブリの ID を SHA\-2 アルゴリズムに移行できます。  
+  
+-   新しいアセンブリを作成する際に、既存の厳密な名前の署名を考慮する必要のない開発者は、より安全な SHA\-2 アルゴリズムを使用して、今までどおりにアセンブリに署名できます。  
+  
+## 強化された厳密な名前の使用  
+ 厳密な名前のキーは署名キーと ID のキーで構成されます。  アセンブリは署名キーで署名され、ID キーで識別されます。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] より前では、これらの 2 つのキーは同一です。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、ID キーは、.NET Framework の以前のバージョンと同じですが、署名キーは、より強力なハッシュ アルゴリズムを備えています。  さらに、副署名を作成するために、署名キーは ID キーで署名されます。  
+  
+ <xref:System.Reflection.AssemblySignatureKeyAttribute> 属性によって、アセンブリのメタデータはアセンブリの ID に既存の公開キーを使用することができ、これによって、古いアセンブリ参照は引き続き動作します。<xref:System.Reflection.AssemblySignatureKeyAttribute> の属性は副署名を使用して、新しい署名キーの所有者が古い ID キーの所有者にもなるようにします。  
+  
+### キー移行を伴わない SHA\-2 による署名  
+ 厳密な名前の署名を移行せずにアセンブリに署名するには、コマンド プロンプト ウィンドウから次のコマンドを実行します。  
+  
+1.  新しい ID キーを生成します \(必要な場合\)。  
+  
+    ```  
+    sn -k IdentityKey.snk  
+    ```  
+  
+2.  ID の公開キーを抽出し、このキーで署名する場合に SHA\-2 アルゴリズムを使用するように指定します。  
+  
+    ```  
+    sn -p IdentityKey.snk IdentityPubKey.snk sha256  
+    ```  
+  
+3.  ID 公開キー ファイルで、アセンブリに遅延署名します。  
+  
+    ```  
+    csc MyAssembly.cs /keyfile:IdentityPubKey.snk /delaySign+  
+    ```  
+  
+4.  完全な ID キーのペアでアセンブリに再署名します。  
+  
+    ```  
+    sn -Ra MyAssembly.exe IdentityKey.snk  
+    ```  
+  
+### キー移行を伴う SHA\-2 による署名  
+ 移行した厳密な名前の署名でアセンブリに署名するには、コマンド プロンプト ウィンドウで次のコマンドを実行します。  
+  
+1.  ID キーと署名キーのペアを生成します \(必要な場合\)。  
+  
+    ```  
+    sn -k IdentityKey.snk  
+    sn -k SignatureKey.snk  
+    ```  
+  
+2.  署名の公開キーを抽出し、このキーで署名する場合に SHA\-2 アルゴリズムを使用するように指定します。  
+  
+    ```  
+    sn -p SignatureKey.snk SignaturePubKey.snk sha256  
+    ```  
+  
+3.  副署名を生成するハッシュ アルゴリズムを決定する ID の公開キーを抽出します。  
+  
+    ```  
+    sn -p IdentityKey.snk IdentityPubKey.snk  
+    ```  
+  
+4.  <xref:System.Reflection.AssemblySignatureKeyAttribute> の属性のパラメーターを生成し、アセンブリに属性を追加します。  
+  
+    ```  
+    sn -ac IdentityPubKey.snk IdentityKey.snk SignaturePubKey.snk  
+    ```  
+  
+5.  ID 公開キーでアセンブリに遅延署名します。  
+  
+    ```  
+    csc MyAssembly.cs /keyfile:IdentityPubKey.snk /delaySign+  
+  
+    ```  
+  
+6.  完全な署名キーのペアでアセンブリに署名します。  
+  
+    ```  
+    sn -Ra MyAssembly.exe SignatureKey.snk  
+    ```  
+  
+## 参照  
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/gac.md b/docs/framework/app-domains/gac.md
new file mode 100644
index 00000000000..10ca332a352
--- /dev/null
+++ b/docs/framework/app-domains/gac.md
@@ -0,0 +1,53 @@
+---
+title: "グローバル アセンブリ キャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アクセス制御リスト [.NET Framework]"
+  - "ACL [.NET Framework]"
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "キャッシュ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "GAC (グローバル アセンブリ キャッシュ)"
+  - "グローバル アセンブリ キャッシュ"
+  - "グローバル アセンブリ キャッシュ, 概要"
+ms.assetid: cf5eacd0-d3ec-4879-b6da-5fd5e4372202
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# グローバル アセンブリ キャッシュ
+共通言語ランタイムがインストールされている各コンピューターには、グローバル アセンブリ キャッシュと呼ばれる、コンピューター全体にわたって使用されるコード キャッシュがあります。  グローバル アセンブリ キャッシュは、そのコンピューター上の複数のアプリケーションで共有するように指定されたアセンブリを格納します。  
+  
+ アセンブリを共有するには、必要な場合にだけそれらのアセンブリをグローバル アセンブリ キャッシュにインストールします。  一般的には、明らかにアセンブリを共有する必要がある場合を除いて、アセンブリの依存関係はプライベートにし、アセンブリはアプリケーション ディレクトリに配置します。  また、COM 相互運用またはアンマネージ コードからアセンブリにアクセスできるようにするために、アセンブリをグローバル アセンブリ キャッシュにインストールする必要はありません。  
+  
+> [!NOTE]
+>  アセンブリをグローバル アセンブリ キャッシュにインストールしないようにする必要がある場合もあります。  アプリケーションを構成するアセンブリの 1 つをグローバル アセンブリ キャッシュに配置した場合は、アプリケーション ディレクトリをコピーする **xcopy** コマンドを使用してアプリケーションをレプリケートしたりインストールしたりすることはできなくなります。  この場合、グローバル アセンブリ キャッシュ内に配置したアセンブリも移動する必要があります。  
+  
+ アセンブリをグローバル アセンブリ キャッシュに配置するには、次の 2 つの方法があります。  
+  
+-   グローバル アセンブリ キャッシュを扱うことができるようにデザインされたインストーラーを使用する。  これは、アセンブリをグローバル アセンブリ キャッシュにインストールするために一般的に使用される方法です。  
+  
+-   [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に用意されている[グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) という開発者ツールを使用する。  
+  
+    > [!NOTE]
+    >  配置時にアセンブリをグローバル アセンブリ キャッシュにインストールするには、Windows Installer を使用する必要があります。  グローバル アセンブリ キャッシュ ツールの使用は、開発時のみに限定してください。グローバル アセンブリ キャッシュ ツールでは、Windows インストーラーを使用した場合に提供されるアセンブリ参照カウントやその他の機能が提供されません。  
+  
+ .NET Framework 4 以降では、グローバル アセンブリ キャッシュの既定の場所は **%windir%\\Microsoft.NET\\assembly** です。  .NET Framework の以前のバージョンでは、既定の場所は **%windir%\\assembly** です。  
+  
+ 通常、管理者は、書き込みおよび実行アクセスを制御するアクセス制御リスト \(ACL: Access Control List\) を使用して systemroot ディレクトリを保護します。  グローバル アセンブリ キャッシュは、systemroot ディレクトリのサブディレクトリにインストールされるため、このディレクトリの ACL を継承します。  グローバル アセンブリ キャッシュからファイルを削除する場合は、管理者権限を持つユーザーに対してだけ許可することをお勧めします。  
+  
+ グローバル アセンブリ キャッシュに配置するアセンブリには、厳密な名前を付けておく必要があります。  アセンブリをグローバル アセンブリ キャッシュに追加すると、アセンブリを構成するすべてのファイルに対して、整合性チェックが実行されます。  キャッシュはこのような整合性チェックを実行することで、ファイルが変更されたにもかかわらず、マニフェストにその変更が反映されていないなど、アセンブリに不整合が生じていないかどうかを確認します。  
+  
+## 参照  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)   
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-build-a-multifile-assembly.md b/docs/framework/app-domains/how-to-build-a-multifile-assembly.md
new file mode 100644
index 00000000000..ff282dae2e1
--- /dev/null
+++ b/docs/framework/app-domains/how-to-build-a-multifile-assembly.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : マルチファイル アセンブリをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework]、マルチファイル"
+  - "エントリ ポイント (アセンブリの)"
+  - "コンパイル (アセンブリの)"
+  - "Al.exe"
+  - "コマンド ライン コンパイラ"
+  - "アセンブリ マニフェスト、マルチファイル アセンブリ"
+  - "アセンブリ [.NET Framework]、コンパイル"
+  - "アセンブリ リンカー"
+  - "コード モジュール"
+  - "マルチファイル アセンブリ"
+ms.assetid: 261c5583-8a76-412d-bda7-9b8ee3b131e5
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : マルチファイル アセンブリをビルドする
+この記事では、マルチファイル アセンブリを作成する方法を説明し、プロシージャの各手順を示すコードを提供します。  
+  
+> [!NOTE]
+>  Visual Studio IDE for C\# および Visual Basic は、シングルファイル アセンブリの作成でしか使用できません。  マルチファイル アセンブリを作成する場合は、コマンド ライン コンパイラまたは Visual C\+\+ 付き Visual Studio を使用する必要があります。  
+  
+### マルチファイル アセンブリを作成するには、次のようにします。  
+  
+1.  アセンブリ内のほかのモジュールによって参照される名前空間を含むすべてのファイルをコンパイルして、コード モジュールを生成します。  コード モジュールの既定の拡張子は .netmodule です。  
+  
+     たとえば、`Stringer` ファイルに `Stringer` と呼ばれるクラスを含む `myStringer` という名前空間があるとします。  `Stringer` クラスには、コンソールに 1 つの行を書き込む `StringerMethod` メソッドが含まれます。  
+  
+     [!code-cpp[Conceptual.Assembly.Multifile#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/stringer.cpp#1)]
+     [!code-csharp[Conceptual.Assembly.Multifile#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/stringer.cs#1)]
+     [!code-vb[Conceptual.Assembly.Multifile#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/stringer.vb#1)]  
+  
+     このコードをコンパイルするには、次のコマンドを使用します。  
+  
+     [!code-cpp[Conceptual.Assembly.Multifile#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/stringer.cpp#2)]
+     [!code-csharp[Conceptual.Assembly.Multifile#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/stringer.cs#2)]
+     [!code-vb[Conceptual.Assembly.Multifile#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/stringer.vb#2)]  
+  
+     *module* パラメーターと **\/t:** コンパイラ オプションを指定すると、ファイルはアセンブリではなくモジュールとしてコンパイルされます。  コンパイラは、アセンブリに追加できる `Stringer.netmodule` モジュールを生成します。  
+  
+2.  コード内で参照されるほかのモジュールを示すために必要なコンパイラ オプションを使用して、ほかのすべてのモジュールをコンパイルします。  この手順では、**\/addmodule** コンパイラ オプションを使用します。  
+  
+     次の例では、`Client` コード モジュールに、手順 1. で作成した `Stringer.dll` モジュール内のメソッドを参照するエントリ ポイント `Main` メソッドがあります。  
+  
+     [!code-cpp[Conceptual.Assembly.Multifile#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/client.cpp#3)]
+     [!code-csharp[Conceptual.Assembly.Multifile#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/client.cs#3)]
+     [!code-vb[Conceptual.Assembly.Multifile#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/client.vb#3)]  
+  
+     このコードをコンパイルするには、次のコマンドを使用します。  
+  
+     [!code-cpp[Conceptual.Assembly.Multifile#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/client.cpp#4)]
+     [!code-csharp[Conceptual.Assembly.Multifile#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/client.cs#4)]
+     [!code-vb[Conceptual.Assembly.Multifile#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/client.vb#4)]  
+  
+     このモジュールは後の手順でアセンブリに追加するため、**\/t:module** オプションを指定します。  `Client` 内のコードが `Stringer.netmodule` 内のコードによって作成された名前空間を参照するため、**\/addmodule** オプションを指定します。  コンパイラは、`Stringer.netmodule` という別のモジュールへの参照を格納する `Client.netmodule` モジュールを生成します。  
+  
+    > [!NOTE]
+    >  C\# コンパイラと Visual Basic コンパイラは、マルチファイル アセンブリを直接作成する場合、次の 2 種類の構文を使用します。  
+    >   
+    >  -   2 回のコンパイルで、2 ファイルのアセンブリを作成する。  
+    >   
+    >      [!code-cpp[Conceptual.Assembly.Multifile#5](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/client.cpp#5)]
+      [!code-csharp[Conceptual.Assembly.Multifile#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/client.cs#5)]
+      [!code-vb[Conceptual.Assembly.Multifile#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/client.vb#5)]  
+    > -   1 回のコンパイルで、2 ファイルのアセンブリを作成する。  
+    >   
+    >      [!code-cpp[Conceptual.Assembly.Multifile#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.multifile/cpp/client.cpp#6)]
+      [!code-csharp[Conceptual.Assembly.Multifile#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.multifile/cs/client.cs#6)]
+      [!code-vb[Conceptual.Assembly.Multifile#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.multifile/vb/client.vb#6)]  
+  
+3.  [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用して、アセンブリ マニフェストを格納する出力ファイルを作成します。  このファイルは、アセンブリの一部であるすべてのモジュールまたはリソースについての参照情報を格納します。  
+  
+     コマンド プロンプトに次のコマンドを入力します。  
+  
+     **al** \<*module name*\> \<*module name*\> … **\/main:**\<*method name*\> **\/out:**\<*file name*\> **\/target:**\<*assembly file type*\>  
+  
+     このコマンドで、*module name* 引数はアセンブリに含める各モジュールの名前を指定します。  **\/main:** オプションは、アセンブリのエントリ ポイントであるメソッド名を指定します。  **\/out:** オプションは、アセンブリ メタデータを格納する出力ファイルの名前を指定します。  **\/target:** オプションは、アセンブリがコンソール アプリケーション実行可能ファイル \(.exe\)、Windows 実行可能ファイル \(.win\)、またはライブラリ ファイル \(.lib\) であることを指定します。  
+  
+     Al.exe を使用して、コンソール アプリケーションを実行する `myAssembly.exe` という名前のアセンブリを作成する例を次に示します。  このアプリケーションは、`Client.netmodule` と `Stringer.netmodule` の 2 つのモジュール、およびアセンブリ メタデータだけを格納する実行可能ファイル `myAssembly.exe` で構成されます。  アセンブリのエントリ ポイントは `MainClientApp` クラスの `Main` メソッドで、`Client.dll` 内に配置されています。  
+  
+    ```  
+    al Client.netmodule Stringer.netmodule /main:MainClientApp.Main /out:myAssembly.exe /target:exe   
+    ```  
+  
+     [MSIL 逆アセンブラー \(Ildasm.exe\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用すると、アセンブリの内容を調査したり、ファイルがアセンブリであるかモジュールであるかを判断したりできます。  
+  
+## 参照  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [方法 : アセンブリの内容を表示する](../../../docs/framework/app-domains/how-to-view-assembly-contents.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [マルチファイル アセンブリ](../../../docs/framework/app-domains/multifile-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-build-a-single-file-assembly.md b/docs/framework/app-domains/how-to-build-a-single-file-assembly.md
new file mode 100644
index 00000000000..272a7f81ab9
--- /dev/null
+++ b/docs/framework/app-domains/how-to-build-a-single-file-assembly.md
@@ -0,0 +1,96 @@
+---
+title: "方法: シングルファイル アセンブリをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 単一ファイル"
+  - "アセンブリ マニフェスト, シングルファイル アセンブリ"
+  - "コード モジュール"
+  - "コマンド ライン コンパイラ"
+  - "ライブラリ アセンブリ"
+  - "出力ファイル名 (アセンブリの)"
+  - "シングルファイル アセンブリ"
+ms.assetid: a6063221-43a5-4d3e-814c-288a4ec69aec
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: シングルファイル アセンブリをビルドする
+シングルファイル アセンブリは最も単純な種類のアセンブリであり、[アセンブリ マニフェスト](../../../docs/framework/app-domains/assembly-manifest.md)と同様に型情報と実装を格納します。  コマンド ライン コンパイラまたは [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] を使用して、シングルファイル アセンブリを作成できます。  既定では、コンパイラは .exe 拡張子の付いたアセンブリ ファイルを作成します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] for C\# および Visual Basic はシングルファイル アセンブリの作成にしか使用できません。  マルチファイル アセンブリを作成する場合は、コマンド ライン コンパイラまたは [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] for Visual C\+\+ を使用する必要があります。  
+  
+ コマンド ライン コンパイラを使用してシングルファイル アセンブリを作成する手順を次に示します。  
+  
+### .exe 拡張子の付いたアセンブリを作成するには  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     \<*コンパイラ コマンドの*\>  \<*モジュール名*\>  
+  
+     このコマンドでは、*compiler command* はコード モジュールで使用する言語のコンパイラ コマンドです。*module name* は、コンパイルしてアセンブリを生成するコード モジュールの名前です。  
+  
+ コード モジュール `myCode` からアセンブリ `myCode.exe` を作成する例を次に示します。  
+  
+```csharp  
+csc myCode.cs  
+```  
+  
+```vb  
+vbc myCode.vb  
+```  
+  
+#### .exe 拡張子を持つアセンブリを作成し、出力ファイル名を指定するには  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     \<*コンパイラ コマンドの*\>**\/out:**の\<*ファイル名の*\>  \<*モジュール名*\>  
+  
+     このコマンドで、*compiler command* はコード モジュールで使用する言語のコンパイラ コマンドです。*file name* は出力ファイル名です。*module name* はコンパイルしてアセンブリを生成するコード モジュールの名前です。  
+  
+ コード モジュール `myCode` からアセンブリ `myAssembly.exe` を作成する例を次に示します。  
+  
+```csharp  
+csc /out:myAssembly.exe myCode.cs  
+```  
+  
+```vb  
+vbc /out:myAssembly.exe myCode.vb  
+```  
+  
+## ライブラリ アセンブリの作成  
+ ライブラリ アセンブリは、クラス ライブラリに類似しています。  ライブラリ アセンブリには、他のアセンブリが参照する型が格納されますが、実行を開始するためのエントリ ポイントは含まれません。  
+  
+#### ライブラリ アセンブリを作成するには、次のようにします。  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     \<*コンパイラ コマンドの*\>**\/t:library** の \<*モジュール名*\>  
+  
+     このコマンドでは、*compiler command* はコード モジュールで使用する言語のコンパイラ コマンドです。*module name* は、コンパイルしてアセンブリを生成するコード モジュールの名前です。  **\/out:** オプションなどのほかのコンパイラ オプションも使用できます。  
+  
+ コード モジュール `myCode` からライブラリ アセンブリ `myCodeAssembly.dll` を作成する例を次に示します。  
+  
+```csharp  
+csc /out:myCodeLibrary.dll /t:library myCode.cs  
+```  
+  
+```vb  
+vbc /out:myCodeLibrary.dll /t:library myCode.vb  
+```  
+  
+## 参照  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [マルチファイル アセンブリ](../../../docs/framework/app-domains/multifile-assemblies.md)   
+ [方法 : マルチファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-multifile-assembly.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-configure-an-application-domain.md b/docs/framework/app-domains/how-to-configure-an-application-domain.md
new file mode 100644
index 00000000000..0521f8fdeca
--- /dev/null
+++ b/docs/framework/app-domains/how-to-configure-an-application-domain.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : アプリケーション ドメインを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン, 構成"
+  - "ApplicationBase プロパティ"
+ms.assetid: 07ea8438-7a34-49f0-a7e8-3d6ff7e4a482
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : アプリケーション ドメインを構成する
+<xref:System.AppDomainSetup> クラスを使用して、共通言語ランタイムに新しいアプリケーション ドメインの構成情報を提供できます。  独自のアプリケーション ドメインを作成するときに最も重要なプロパティは、<xref:System.AppDomainSetup.ApplicationBase%2A> です。  **AppDomainSetup** の他のプロパティは、主にランタイム ホストが特定のアプリケーション ドメインを構成するために使用されます。  
+  
+ **ApplicationBase** プロパティは、アプリケーションのルート ディレクトリを定義します。  ランタイムが型要求を満たす必要がある場合、ランタイムは **ApplicationBase** プロパティで指定したディレクトリ内でその型を含むアセンブリを調査します。  
+  
+> [!NOTE]
+>  新しいアプリケーション ドメインは、作成元の **ApplicationBase** プロパティだけを継承します。  
+  
+ **AppDomainSetup** クラスのインスタンスを作成する例を次に示します。このクラスを使用してアプリケーション ドメインを新しく作成し、情報をコンソールに書き込んでから、このアプリケーション ドメインをアンロードします。  
+  
+## 使用例  
+ [!code-cpp[ADApplicationBase#2](../../../samples/snippets/cpp/VS_Snippets_CLR/ADApplicationBase/CPP/source2.cpp#2)]
+ [!code-csharp[ADApplicationBase#2](../../../samples/snippets/csharp/VS_Snippets_CLR/ADApplicationBase/CS/source2.cs#2)]
+ [!code-vb[ADApplicationBase#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/ADApplicationBase/VB/source2.vb#2)]  
+  
+## 参照  
+ [Hosting Overview](http://msdn.microsoft.com/ja-jp/ea527626-99e3-4995-81c4-c8f3e60eb6d5)   
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-create-a-public-private-key-pair.md b/docs/framework/app-domains/how-to-create-a-public-private-key-pair.md
new file mode 100644
index 00000000000..4f228f20141
--- /dev/null
+++ b/docs/framework/app-domains/how-to-create-a-public-private-key-pair.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : 公開キーと秘密キーのキー ペアを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キー ペア (厳密な名前を持つアセンブリの)"
+  - "署名 (アセンブリに)"
+  - "アセンブリ [.NET Framework]、署名"
+  - "暗号化キー ペア"
+  - "snk ファイル (キー ペア ファイル)"
+  - "公開キーと秘密キーのペア"
+  - ".snk ファイル"
+  - "厳密な名前を持つアセンブリ、キー ペア"
+ms.assetid: 05026813-f3bd-4d7c-9e0b-fc588eb3d114
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 公開キーと秘密キーのキー ペアを作成する
+厳密な名前でアセンブリに署名するには、公開キーと秘密キーのキー ペアが必要です。  公開キーと秘密キーの暗号キー ペアは、コンパイル中に厳密な名前付きアセンブリを作成するために使用されます。  キー ペアは、[厳密名ツール \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用して生成できます。  通常、キー ペア ファイルには、.snk 拡張子が付きます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] では、C\# および Visual Basic プロジェクトのプロパティ ページに **\[署名\]** タブがあります。このタブでは、既存のキー ファイルを選択したり、Sn.exe を使用せずに新しいキー ファイルを生成したりできます。  Visual C\+\+ では、**\[プロパティ ページ\]** ウィンドウの **\[構成プロパティ\]** セクションの **\[リンカー\]** セクションにある **\[詳細\]** プロパティ ページで、既存のキー ファイルの場所を指定できます。  <xref:System.Reflection.AssemblyKeyFileAttribute> 属性を使用したキー ファイル ペアの指定は、[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] 以降では行われなくなりました。  
+  
+### ユーザー コントロールを作成するには、次のようにします。  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     **sn –k** の \<*ファイル名*\>  
+  
+     このコマンドで、*file name* はキー ペアを格納する出力ファイルの名前です。  
+  
+ キー ペア `sgKey.snk` を作成する例を次に示します。  
+  
+```  
+sn -k sgKey.snk  
+```  
+  
+ アセンブリに遅延署名してキー ペア全体を制御する場合 \(通常、テスト シナリオでだけ実行できます\) は、次のコマンドを使用して、キー ペアを生成し、そのキー ペアから公開キーを別のファイルに抽出できます。  最初に、キー ペアを作成します。  
+  
+```  
+sn -k keypair.snk  
+```  
+  
+-   次に、キー ペアから公開キーを抽出し、別のファイルにコピーします。  
+  
+```  
+sn -p keypair.snk public.snk  
+```  
+  
+-   キー ペアの作成後に、厳密な名前の署名ツールが検出できる場所にファイルを配置する必要があります。  
+  
+ 厳密な名前でアセンブリに署名すると、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) は、現在のディレクトリと出力ディレクトリを基準にしてキー ファイルを検索します。  コマンド ライン コンパイラを使用する場合は、コード モジュールを格納する現在のディレクトリにキーをコピーするだけで十分です。  
+  
+ プロジェクト プロパティに **\[署名\]** タブがない以前のバージョンの [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用している場合は、キー ファイルの場所として、次のようにファイル属性を指定したプロジェクト ディレクトリを使用することをお勧めします。  
+  
+ [!code-cpp[AssemblyName_KeyPair#21](../../../samples/snippets/cpp/VS_Snippets_CLR/AssemblyName_KeyPair/CPP/keyfileattrib.cpp#21)]
+ [!code-csharp[AssemblyName_KeyPair#21](../../../samples/snippets/csharp/VS_Snippets_CLR/AssemblyName_KeyPair/CS/keyfileattrib.cs#21)]
+ [!code-vb[AssemblyName_KeyPair#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AssemblyName_KeyPair/VB/keyfileattrib.vb#21)]  
+  
+## 参照  
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-create-an-application-domain.md b/docs/framework/app-domains/how-to-create-an-application-domain.md
new file mode 100644
index 00000000000..fb648c89887
--- /dev/null
+++ b/docs/framework/app-domains/how-to-create-an-application-domain.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : アプリケーション ドメインを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン、作成"
+ms.assetid: ba1fa43e-49f5-47d9-bd7f-3024af16f4ba
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : アプリケーション ドメインを作成する
+共通言語ランタイム ホストは、必要に応じてアプリケーション ドメインを自動的に作成します。  一方、独自のアプリケーション ドメインを作成して、個人的に管理するアセンブリを読み込ませることもできます。  アプリケーション ドメインを作成してコードを実行することもできます。  
+  
+ 新しいアプリケーション ドメインを作成するには、<xref:System.AppDomain?displayProperty=fullName> クラスのオーバーロードされた **CreateDomain** メソッドの 1 つを使用します。  アプリケーション ドメインに名前を付けると、その名前を使用してアプリケーション ドメインを参照できます。  
+  
+ `MyDomain` という名前の新しいアプリケーション ドメインを作成し、ホスト ドメイン名と新しく作成された子アプリケーション ドメイン名をコンソールに出力する例を次に示します。  
+  
+## 使用例  
+ [!code-cpp[ADCreateDomain#2](../../../samples/snippets/cpp/VS_Snippets_CLR/ADCreateDomain/CPP/source2.cpp#2)]
+ [!code-csharp[ADCreateDomain#2](../../../samples/snippets/csharp/VS_Snippets_CLR/ADCreateDomain/CS/source2.cs#2)]
+ [!code-vb[ADCreateDomain#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/ADCreateDomain/VB/source2.vb#2)]  
+  
+## 参照  
+ [Hosting Overview](http://msdn.microsoft.com/ja-jp/ea527626-99e3-4995-81c4-c8f3e60eb6d5)   
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md b/docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md
new file mode 100644
index 00000000000..238880cd219
--- /dev/null
+++ b/docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : アセンブリの完全修飾名を特定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 名前"
+  - "名前 [.NET Framework], アセンブリ"
+  - "名前 [.NET Framework], 完全修飾型名"
+ms.assetid: 009dae23-e1f6-4a64-9a9a-32e4c34802b0
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : アセンブリの完全修飾名を特定する
+グローバル アセンブリ キャッシュ内のアセンブリの完全修飾名を検出するには、グローバル アセンブリ キャッシュ ツール \([Gacutil.exe](../../../docs/framework/tools/gacutil-exe-gac-tool.md)\) を使用します。  「[方法 : グローバル アセンブリ キャッシュの内容を表示する](../../../docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md)」を参照してください。  
+  
+ グローバル アセンブリ キャッシュにないアセンブリについては、複数の方法で完全修飾アセンブリ名を取得できます。コードを使用しコンソールや変数に情報を出力したり、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用して完全修飾名を含むアセンブリのメタデータを調べたりできます。  
+  
+-   アセンブリがアプリケーションによって既に読み込まれている場合、<xref:System.Reflection.Assembly.FullName%2A?displayProperty=fullName> プロパティの値を取得して、完全修飾名を取得できます。  この方法を使用して、アセンブリが GAC 内にあるかどうかを判別できます。  具体的な例を次に示します。  
+  
+-   アセンブリのファイル システム パスがわかっている場合は、\(`Shared` Visual Basic で\) 静的 <xref:System.Reflection.AssemblyName.GetAssemblyName%2A?displayProperty=fullName> メソッドを呼び出して、完全修飾アセンブリ名を取得できます。  単純な例を次に示します。  
+  
+     [!code-csharp[System.Reflection.AssemblyName.GetAssemblyName#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.reflection.assemblyname.getassemblyname/cs/getassemblyname1.cs#1)]
+     [!code-vb[System.Reflection.AssemblyName.GetAssemblyName#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.reflection.assemblyname.getassemblyname/vb/getassemblyname1.vb#1)]  
+  
+-   [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用して、アセンブリのメタデータを使用できます。これには完全修飾名が含まれています。  
+  
+ バージョン、カルチャ、アセンブリ名などのアセンブリ属性の設定の詳細については、「[アセンブリ属性の設定](../../../docs/framework/app-domains/set-assembly-attributes.md)」を参照してください。  アセンブリに厳密な名前を指定する方法の詳細については、「[厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)」を参照してください。  
+  
+## 使用例  
+ 指定したクラスを含むアセンブリの完全限定名をコンソールに表示するコード例を次に示します。  アプリによって既に読み込まれているアセンブリの名前を取得するので、アセンブリが GAC 内にあるかどうかは重要ではありません。  
+  
+ [!code-cpp[Assembly.Fullname#2](../../../samples/snippets/cpp/VS_Snippets_CLR/Assembly.FullName/CPP/example2.cpp#2)]
+ [!code-csharp[Assembly.Fullname#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Assembly.FullName/CS/example2.cs#2)]
+ [!code-vb[Assembly.Fullname#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Assembly.FullName/VB/example2.vb#2)]  
+  
+## 参照  
+ [アセンブリ名](../../../docs/framework/app-domains/assembly-names.md)   
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md b/docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md
new file mode 100644
index 00000000000..277d1c2e3ce
--- /dev/null
+++ b/docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : 厳密な名前のバイパス機能を無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "厳密な名前のバイパス機能"
+  - "厳密な名前を付けたアセンブリ、読み込み (信頼されたアプリケーション ドメインへの)"
+ms.assetid: 234e088c-3b11-495a-8817-e0962be79d82
+caps.latest.revision: 30
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# 方法 : 厳密な名前のバイパス機能を無効にする
+.NET Framework Version 3.5 Service Pack 1 \(SP1\) 以降、アセンブリが完全信頼の <xref:System.AppDomain> オブジェクト \(`MyComputer` ゾーンに既定の <xref:System.AppDomain> など\) に読み込まれている場合は、厳密な名前の署名の検証が行われなくなりました。  これは、厳密な名前のバイパス機能と呼ばれます。  完全信頼環境での <xref:System.Security.Permissions.StrongNameIdentityPermission> の要求は、そのシグネチャに関係なく、署名された完全信頼アセンブリであれば常に成功します。  ゾーンは完全に信頼されているため、唯一の制限として、アセンブリは完全に信頼されている必要があります。  このような状況では厳密な名前は決定要因ではないため、これを検証する理由はありません。  厳密な名前の署名の検証をバイパスすることで、パフォーマンスが大幅に向上します。  
+  
+ バイパス機能は、<xref:System.AppDomainSetup.ApplicationBase%2A> プロパティで指定されたディレクトリから完全信頼の <xref:System.AppDomain> に読み込まれ、遅延署名されていないすべての完全信頼アセンブリに適用されます。  
+  
+ レジストリ キー値を設定することで、コンピューターのすべてのアプリケーションに対するバイパス機能をオーバーライドできます。  アプリケーションの構成ファイルを使用すると、単一アプリケーションの設定をオーバーライドできます。  レジストリ キーを使用して無効にされているアプリケーションでは、個別にバイパス機能を元に戻すことはできません。  
+  
+ バイパス機能をオーバーライドすると、厳密な名前が正しいかどうかだけが検証されます。<xref:System.Security.Permissions.StrongNameIdentityPermission> に対するチェックは行われません。  特定の厳密な名前を確認するには、個別にチェックを実行する必要があります。  
+  
+> [!IMPORTANT]
+>  厳密な名前の検証を強制する機能は、次の手順で説明するように、レジストリ キーに依存します。  アプリケーションが、該当のレジストリ キーへのアクセスについてアクセス制御リスト \(ACL: Access Control List\) アクセス許可を持っていないアカウントで実行されている場合、その設定は無効となります。  ACL アクセス許可を構成し、すべてのアセンブリ用に読み取ることができるようにキーを設定する必要があります。  
+  
+### すべてのアプリケーションに対して厳密な名前のバイパス機能を無効にするには  
+  
+-   32 ビット コンピューターでは、システム レジストリの HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework キーの下に、値が 0 の `AllowStrongNameBypass` という名前の DWORD エントリを作成します。  
+  
+-   64 ビット コンピューターでは、システム レジストリの HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework キーと HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\.NETFramework キーの下に、値が 0 の `AllowStrongNameBypass` という名前の DWORD エントリを作成します。  
+  
+### 単一のアプリケーションに対して厳密な名前のバイパス機能を無効にするには  
+  
+1.  アプリケーションの構成ファイルを開くか、または作成します。  
+  
+     このファイルの詳細については、「[アプリの構成](../../../docs/framework/configure-apps/index.md)」の「アプリケーション構成ファイル」を参照してください。  
+  
+2.  次のエントリを追加します。  
+  
+    ```  
+    <configuration>  
+      <runtime>  
+         < bypassTrustedAppStrongNames enabled="false" />  
+      </runtime>  
+    </configuration>  
+    ```  
+  
+ アプリケーションのバイパス機能を元に戻すには、構成ファイル設定を削除するか、属性を "true" に設定します。  
+  
+> [!NOTE]
+>  アプリケーションに対して厳密な名前のバイパス機能の有効\/無効を切り替えることができるのは、コンピューターでバイパス機能が有効になっている場合だけです。  コンピューターでバイパス機能が無効になっている場合は、すべてのアプリケーションに対して厳密な名前が検証され、単一のアプリケーションに対する検証をバイパスすることはできません。  
+  
+## 参照  
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [\<bypassTrustedAppStrongNames\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md)   
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md b/docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md
new file mode 100644
index 00000000000..daab32f06ce
--- /dev/null
+++ b/docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "Gacutil.exe"
+  - "グローバル アセンブリ キャッシュ ツール"
+  - "グローバル アセンブリ キャッシュ, インストール (アセンブリを)"
+  - "厳密な名前を付けたアセンブリ, グローバル アセンブリ キャッシュ"
+ms.assetid: a7e6f091-d02c-49ba-b736-7295cb0eb743
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする
+厳密な名前付きのアセンブリをグローバル アセンブリ キャッシュ \(GAC\) にインストールには、次の 2 つの方法があります。  
+  
+> [!IMPORTANT]
+>  GAC にインストールできるのは、厳密な名前付きのアセンブリだけです。  厳密な名前付きのアセンブリを作成する方法については、「[方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)」を参照してください。  
+  
+-   [Windows インストーラー](http://msdn.microsoft.com/library/windows/desktop/cc185688.aspx) を使用する。  
+  
+     この操作を行うには、Visual Studio 2012 および Visual Studio 2013 で、InstallShield Limited Edition プロジェクトを作成します。  
+  
+     これは、アセンブリをグローバル アセンブリ キャッシュに追加する最も一般的な方法です。この方法をお勧めします。  このインストーラーを使用すると、グローバル アセンブリ キャッシュ内のアセンブリの参照カウントが示されるなどの利点があります。  
+  
+-   [グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用する。  
+  
+     Gacutil.exe を使用すると、厳密な名前付きアセンブリをグローバル アセンブリ キャッシュに追加したり、グローバル アセンブリ キャッシュの内容を表示したりできます。  
+  
+    > [!NOTE]
+    >  Gacutil.exe は開発専用です。製品アセンブリをグローバル アセンブリ キャッシュにインストールするためには使用しないでください。  
+  
+> [!NOTE]
+>  以前のバージョンの .NET Framework では、Windows のシェル拡張機能である Shfusion.dll により、エクスプローラーでアセンブリをドラッグしてインストールすることができました。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、Shfusion.dll は廃止されましたが、互換性のために残されています。  
+  
+### グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\) を使用するには  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     **gacutil \-i** \<*assembly name*\>  
+  
+     このコマンドで、*assembly name* はグローバル アセンブリ キャッシュにインストールされるアセンブリの名前です。  
+  
+ ファイル名 `hello.dll` のアセンブリをグローバル アセンブリ キャッシュにインストールする例を次に示します。  
+  
+```  
+gacutil -i hello.dll  
+```  
+  
+ 詳細については、「[グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)」を参照してください。  
+  
+### InstallShield Limited Edition プロジェクトを使用するには  
+  
+1.  ソリューションのショートカット メニューを開き、**\[追加\]**、**\[新しいプロジェクト\]** の順に選択して、ソリューションにセットアップと配置パッケージを追加します。  
+  
+2.  **\[新しいプロジェクトの追加\]** ダイアログ ボックスの **\[インストール済み\]** フォルダーで、**\[その他のプロジェクトの種類\]**、**\[セットアップと配置\]**、**\[InstallShield Limited Edition\]** の順に選択し、プロジェクトに名前を付けます。  \(プロンプトが表示されたら、InstallShield をダウンロードし、インストールしてアクティブにします。\)  
+  
+3.  **ソリューション エクスプローラー**のプロジェクト アシスタントを使用するか、**ソリューション エクスプローラー**の番号付き手順のサブ手順を選択して、セットアップと配置プロジェクトの一般的な構成を行います。  アセンブリを GAC に追加しない場合と同様にセットアップを構成します。  
+  
+4.  アセンブリを GAC に追加するプロセスを開始するには、**ソリューション エクスプローラー**の **\[アプリケーション データの指定\]** 手順の下にある **\[ファイル\]** を選択します。  
+  
+5.  **\[インストール先コンピューターのフォルダー\]** ペインで、**\[インストール先コンピューター\]** のショートカット メニューを開き、**\[定義済みフォルダーの表示\]**、**\[GlobalAssemblyCache\]** の順に選択します。  
+  
+6.  グローバル アセンブリ キャッシュにインストールするアセンブリを含む、ソリューション内の各プロジェクトで、次の操作を行います。  
+  
+    1.  **\[インストール元コンピューターのフォルダー\]** ペインでプロジェクトを選択します。  
+  
+    2.  **\[インストール先コンピューターのフォルダー\]** ペインで **\[GlobalAssemblyCache\]** を選択します。  
+  
+    3.  **\[インストール元コンピューターのファイル\]** ペインで、**\[*\<project\_name\>* のプライマリ出力\]** を選択します。  
+  
+    4.  手順 c のファイルを **\[インストール先コンピューターのファイル\]** ペインにドラッグします \(または、ファイルのショートカット メニューの **\[コピー\]** と **\[貼り付け\]** コマンドを使用します\)。  
+  
+## 参照  
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)   
+ [方法 : グローバル アセンブリ キャッシュからアセンブリを削除する](../../../docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)   
+ [方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)   
+ [Windows Installer Deployment](http://msdn.microsoft.com/ja-jp/121be21b-b916-43e2-8f10-8b080516d2a0)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-load-assemblies-into-an-application-domain.md b/docs/framework/app-domains/how-to-load-assemblies-into-an-application-domain.md
new file mode 100644
index 00000000000..013485bf681
--- /dev/null
+++ b/docs/framework/app-domains/how-to-load-assemblies-into-an-application-domain.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : アプリケーション ドメインにアセンブリを読み込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン, 読み込み (アセンブリを)"
+  - "読み込み (アセンブリを)"
+ms.assetid: 1432aa2d-bd83-4346-bf3b-a1b7920e2aa9
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : アプリケーション ドメインにアセンブリを読み込む
+アプリケーション ドメインにアセンブリを読み込むには、いくつかの方法があります。  推奨されているのは、[System.Reflection.Assembly](https://msdn.microsoft.com/en-us/library/system.reflection.aspx) クラスの `static` \(Visual Basic では `Shared`\) <xref:System.Reflection.Assembly.Load%2A> メソッドを使用する方法です。  それ以外には、以下の方法でアセンブリを読み込むことができます。  
+  
+-   [Assembly](https://msdn.microsoft.com/en-us/library/system.reflection.aspx) クラスの <xref:System.Reflection.Assembly.LoadFrom%2A> メソッドは、ファイルの場所が指定されたアセンブリを読み込みます。  このメソッドでアセンブリを読み込む場合は、別の読み込みコンテキストが使用されます。  
+  
+-   <xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A> メソッドと <xref:System.Reflection.Assembly.ReflectionOnlyLoadFrom%2A> メソッドは、リフレクション専用コンテキストにアセンブリを読み込みます。  このコンテキストに読み込まれたアセンブリはチェックできますが、実行することはできません。この結果、他のプラットフォームを対象とするアセンブリをチェックできます。  「[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)」を参照してください。  
+  
+> [!NOTE]
+>  リフレクション専用コンテキストは、.NET Framework Version 2.0 で新たに追加されました。  
+  
+-   <xref:System.AppDomain> クラスの <xref:System.AppDomain.CreateInstance%2A> や <xref:System.AppDomain.CreateInstanceAndUnwrap%2A> などのメソッドは、アプリケーション ドメインにアセンブリを読み込むことができます。  
+  
+-   <xref:System.Type> クラスの <xref:System.Type.GetType%2A> メソッドは、アセンブリを読み込むことができます。  
+  
+-   <xref:System.AppDomain?displayProperty=fullName> クラスの <xref:System.AppDomain.Load%2A> メソッドは、アセンブリを読み込むことができますが、主に COM の相互運用性のために使用されます。  このメソッドの呼び出し元であるアプリケーション ドメイン以外のアプリケーション ドメインにアセンブリを読み込む場合は、このメソッドを使用しないでください。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 以降では、現在読み込まれているランタイムよりもバージョン番号が新しい .NET Framework のバージョンでコンパイルされたアセンブリを、ランタイムが読み込まないようになりました。  これに該当するのは、バージョン番号のメジャー部分とマイナー部分を組み合わせた番号です。  
+  
+ 読み込まれたアセンブリの Just\-In\-Time \(JIT\) コンパイル コードがアプリケーション ドメイン間で共有される方法を指定できます。  詳細については、「[Application Domains and Assemblies](http://msdn.microsoft.com/ja-jp/433b04ae-4ba8-4849-9dbd-79194f240346)」を参照してください。  
+  
+## 使用例  
+ 次に示すコードは、"example.exe" または "example.dll" という名前のアセンブリを現在のアプリケーション ドメインに読み込み、アセンブリから `Example` という型を取得し、さらにその型の `MethodA` というパラメーターを持たないメソッドを取得して、そのメソッドを実行します。  読み込まれたアセンブリから情報を取得する方法の詳細については、「[型の動的な読み込みおよび使用](../../../docs/framework/reflection-and-codedom/dynamically-loading-and-using-types.md)」を参照してください。  
+  
+ [!code-cpp[System.AppDomain.Load#2](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.appdomain.load/cpp/source2.cpp#2)]
+ [!code-csharp[System.AppDomain.Load#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.load/cs/source2.cs#2)]
+ [!code-vb[System.AppDomain.Load#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.load/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A>   
+ [Hosting Overview](http://msdn.microsoft.com/ja-jp/ea527626-99e3-4995-81c4-c8f3e60eb6d5)   
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)   
+ [方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)   
+ [Application Domains and Assemblies](http://msdn.microsoft.com/ja-jp/433b04ae-4ba8-4849-9dbd-79194f240346)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md b/docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md
new file mode 100644
index 00000000000..4fe75fb68ae
--- /dev/null
+++ b/docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : アセンブリから型およびメンバーの情報を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 取得 (情報を)"
+  - "取得 (アセンブリ情報を)"
+ms.assetid: 348ae651-ccda-4f13-8eda-19e8337e9438
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : アセンブリから型およびメンバーの情報を取得する
+<xref:System.Reflection> 名前空間には、アセンブリから情報を取得するための多くのメソッドがあります。  このセクションでは、これらのメソッドの 1 つを実行する例を示します。  詳細については、「[リフレクションの概要](../../../docs/framework/reflection-and-codedom/reflection.md)」を参照してください。  
+  
+ アセンブリから型情報とメンバー情報を取得する例を次に示します。  
+  
+## 使用例  
+ [!code-cpp[Conceptual.Types.ViewInfo#8](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source6.cpp#8)]
+ [!code-csharp[Conceptual.Types.ViewInfo#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source6.cs#8)]
+ [!code-vb[Conceptual.Types.ViewInfo#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source6.vb#8)]  
+  
+## 参照  
+ [Hosting Overview](http://msdn.microsoft.com/ja-jp/ea527626-99e3-4995-81c4-c8f3e60eb6d5)   
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-receive-first-chance-exception-notifications.md b/docs/framework/app-domains/how-to-receive-first-chance-exception-notifications.md
new file mode 100644
index 00000000000..8d19f0c0e6f
--- /dev/null
+++ b/docs/framework/app-domains/how-to-receive-first-chance-exception-notifications.md
@@ -0,0 +1,108 @@
+---
+title: "方法: 初回例外通知を受け取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外, 初回通知"
+  - "初回例外通知"
+ms.assetid: 66f002b8-a97d-4a6e-a503-2cec01689113
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: 初回例外通知を受け取る
+<xref:System.AppDomain> クラスの <xref:System.AppDomain.FirstChanceException> イベントを使用すると、共通言語ランタイムが例外ハンドラーの検索を開始する前に、例外がスローされたことを知らせる通知を受け取ることができます。  
+  
+ このイベントは、アプリケーション ドメイン レベルで発生します。  実行スレッドは複数のアプリケーション ドメインを通過する可能性があるため、あるアプリケーション ドメインでハンドルされない例外が別のアプリケーション ドメインでハンドルされることもあります。  通知は、イベントにハンドラーを追加した各アプリケーション ドメインで発生します。この処理は、いずれかのアプリケーション ドメインで例外がハンドルされるまで続行されます。  
+  
+ ここで紹介するプロシージャと例では、1 つのアプリケーション ドメインを実装する単純なプログラムで初回例外通知を受け取る方法と、作成したアプリケーション ドメインで初回例外通知を受け取る方法について説明します。  
+  
+ 複数のアプリケーション ドメインにわたる複雑な例については、<xref:System.AppDomain.FirstChanceException> イベントの例を参照してください。  
+  
+## 既定のアプリケーション ドメインで初回例外通知を受け取る  
+ 次の手順では、アプリケーションのエントリ ポイントである `Main()` メソッドが既定のアプリケーション ドメインで実行されます。  
+  
+#### 既定のアプリケーション ドメインで初回例外通知の動作を確認するには  
+  
+1.  ラムダ関数を使用して <xref:System.AppDomain.FirstChanceException> イベントのイベント ハンドラーを定義し、それをイベントにアタッチします。  この例では、イベント ハンドラーによって、イベントが処理されたアプリケーション ドメインの名前と、例外の <xref:System.Exception.Message%2A> プロパティを出力します。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto_simple#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/cs/example.cs#2)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto_simple#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/vb/example.vb#2)]  
+  
+2.  例外をスローし、それをキャッチします。  ランタイムが例外ハンドラーを見つける前に、<xref:System.AppDomain.FirstChanceException> イベントが発生し、メッセージが表示されます。  このメッセージの後に、例外ハンドラーによるメッセージが表示されます。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto_simple#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/cs/example.cs#3)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto_simple#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/vb/example.vb#3)]  
+  
+3.  例外をスローしますが、それをキャッチしません。  ランタイムが例外ハンドラーを検索する前に、<xref:System.AppDomain.FirstChanceException> イベントが発生し、メッセージが表示されます。  例外ハンドラーがないため、アプリケーションは終了します。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto_simple#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/cs/example.cs#4)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto_simple#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/vb/example.vb#4)]  
+  
+     この手順の最初の 3 つの手順で示されているコードは、完全なコンソール アプリケーションを形成します。  既定のアプリケーション ドメインの名前は .exe ファイルの名前と拡張子から構成されるため、アプリケーションからの出力は .exe ファイルの名前によって異なります。  次のサンプル出力を参照してください。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto_simple#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/cs/example.cs#5)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto_simple#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto_simple/vb/example.vb#5)]  
+  
+## 別のアプリケーション ドメインで初回例外通知を受け取る  
+ プログラムに複数のアプリケーション ドメインが含まれている場合は、通知を受け取るアプリケーション ドメインを選択できます。  
+  
+#### 作成したアプリケーション ドメインで初回例外通知を受け取るには  
+  
+1.  <xref:System.AppDomain.FirstChanceException> イベントのイベント ハンドラーを定義します。  この例では、`static` メソッド \(Visual Basic では `Shared` メソッド\) を使用して、イベントが処理されたアプリケーション ドメインの名前と、例外の <xref:System.Exception.Message%2A> プロパティを出力します。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#3)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#3)]  
+  
+2.  アプリケーション ドメインを作成し、このアプリケーション ドメインの <xref:System.AppDomain.FirstChanceException> イベントにイベント ハンドラーを追加します。  この例では、アプリケーション ドメインの名前は `AD1` です。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#2)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#2)]  
+  
+     既定のアプリケーション ドメインでも、同じようにこのイベントを処理できます。  既定のアプリケーション ドメインへの参照を取得するには、`static` \(Visual Basic では `Shared`\) の <xref:System.AppDomain.CurrentDomain%2A?displayProperty=fullName> プロパティを `Main()` で使用します。  
+  
+#### アプリケーション ドメインで初回例外通知の動作を確認するには  
+  
+1.  前の手順で作成したアプリケーション ドメインに `Worker` オブジェクトを作成します。  `Worker` クラスは、パブリックで、<xref:System.MarshalByRefObject> から派生する必要があります。この記事の最後にある完全な例を参照してください。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#4)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#4)]  
+  
+2.  例外をスローする `Worker` オブジェクトのメソッドを呼び出します。  この例では、`Thrower` メソッドが 2 回呼び出されます。  1 回目のメソッド引数は `true` であるため、メソッドが自身の例外をキャッチします。  2 回目の引数は `false` です。この場合、`Main()` メソッドが既定のアプリケーション ドメインで例外をキャッチします。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#6)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#6)]  
+  
+3.  `Thrower` メソッドにコードを追加して、メソッドが自身の例外をハンドルするかどうかを制御します。  
+  
+     [!code-csharp[System.AppDomain.FirstChanceException_howto#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#5)]
+     [!code-vb[System.AppDomain.FirstChanceException_howto#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#5)]  
+  
+## 使用例  
+ 次の例では、`AD1` という名前のアプリケーション ドメインを作成し、このアプリケーション ドメインの <xref:System.AppDomain.FirstChanceException> イベントにイベント ハンドラーを追加します。  この例では、アプリケーション ドメインに `Worker` クラスのインスタンスを作成し、`Thrower` という名前のメソッドを呼び出します。このメソッドにより、<xref:System.ArgumentException> がスローされます。  メソッドは、引数の値に応じて、例外をキャッチするか、またはハンドルしないようにします。  
+  
+ `Thrower` メソッドが `AD1` で例外をスローするたびに、`AD1` で <xref:System.AppDomain.FirstChanceException> イベントが発生し、イベント ハンドラーによりメッセージが表示されます。  次に、ランタイムによって例外ハンドラーが検索されます。  最初のケースでは、例外ハンドラーは `AD1` で見つかります。  2 番目のケースでは、例外は `AD1` でハンドルされず、代わりに既定のアプリケーション ドメインでキャッチされます。  
+  
+> [!NOTE]
+>  既定のアプリケーション ドメインの名前は、実行可能ファイルの名前と同じです。  
+  
+ 既定のアプリケーション ドメインに <xref:System.AppDomain.FirstChanceException> イベントのハンドラーを追加すると、既定のアプリケーション ドメインが例外をハンドルする前に、イベントが発生して処理されます。  これを確認するには、`Main()` の先頭に C\# コード `AppDomain.CurrentDomain.FirstChanceException += FirstChanceException;` \(Visual Basic では `AddHandler AppDomain.CurrentDomain.FirstChanceException, FirstChanceExceptio`n\) を追加します。  
+  
+ [!code-csharp[System.AppDomain.FirstChanceException_howto#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/cs/example.cs#1)]
+ [!code-vb[System.AppDomain.FirstChanceException_howto#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.firstchanceexception_howto/vb/example.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例はコマンド ライン アプリケーションです。  [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] でこのコードをコンパイルして実行するには、出力結果を確認する前にコマンド ウィンドウが閉じないように、`Main()` の最後に C\# コード `Console.ReadLine();` \(Visual Basic では `Console.ReadLine()`\) を追加します。  
+  
+## 参照  
+ <xref:System.AppDomain.FirstChanceException>
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md b/docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md
new file mode 100644
index 00000000000..5cd1cbdac93
--- /dev/null
+++ b/docs/framework/app-domains/how-to-reference-a-strong-named-assembly.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : 厳密な名前のアセンブリを参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 厳密な名前を付けた"
+  - "アセンブリのバインディング, 厳密な名前を付けた"
+  - "コンパイル時アセンブリ参照"
+  - "厳密な名前を付けたアセンブリ, コンパイル時参照"
+ms.assetid: 4c6a406a-b5eb-44fa-b4ed-4e95bb95a813
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 厳密な名前のアセンブリを参照する
+通常、厳密な名前付きアセンブリ内にある型またはリソースを参照するプロセスは内部で行われます。  コンパイル時 \(事前バインディング\) または実行時に参照を作成できます。  
+  
+ コンパイル時参照は、あるアセンブリが別のアセンブリを明示的に参照することをコンパイラに対して指定するときに発生します。  コンパイル時参照を使用する場合、コンパイラは対象の厳密な名前付きアセンブリの公開キーを自動的に取得し、その公開キーをコンパイルされるアセンブリのアセンブリ参照内に自動的に配置します。  
+  
+> [!NOTE]
+>  厳密な名前付きアセンブリのみ、他の厳密な名前付きアセンブリ内の型を参照できます。  それ以外の場合は、厳密な名前付きアセンブリのセキュリティが確保されません。  
+  
+### 厳密な名前付きアセンブリへのコンパイル時参照を作成するには、次のようにします。  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     \<*compiler command*\> **\/reference:**\<*assembly name*\>  
+  
+     このコマンドで、*compiler command* は、使用している *assembly name* は参照される厳密な名前付きアセンブリの名前に言語のコンパイラ コマンドです。  ライブラリ アセンブリを作成するための **\/t:library** オプションなどの他のコンパイラ オプションも使用できます。  
+  
+ コード モジュール `myAssembly.cs` から厳密な名前付きアセンブリ `myLibAssembly.dll` を参照するアセンブリ `myAssembly.dll` を作成する例を次に示します。  
+  
+```  
+csc /t:library myAssembly.cs /reference:myLibAssembly.dll  
+```  
+  
+### 厳密な名前付きアセンブリへの実行時参照を作成するには、次のようにします。  
+  
+1.  <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドまたは <xref:System.Reflection.Assembly.GetType%2A?displayProperty=fullName> メソッドを使用するなどの方法で、実行時に厳密な名前付きアセンブリ参照を作成する場合は、参照される厳密な名前付きアセンブリの表示名を使用する必要があります。  表示名の構文は、次のとおりです。  
+  
+     \<*assembly name*\>**,** \<*version number*\>**,** \<*culture*\>**,** \<*public key token*\>  
+  
+     たとえば、次のようになります。  
+  
+    ```  
+    myDll, Version=1.1.0.0, Culture=en, PublicKeyToken=03689116d3a4ae33   
+    ```  
+  
+     この例では、`PublicKeyToken` は 16 進形式の公開キー トークンです。  カルチャの値がない場合は、`Culture=neutral` を使用します。  
+  
+ この情報と <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドの使用方法を次のコード例に示します。  
+  
+ [!code-cpp[Assembly.Load1#3](../../../samples/snippets/cpp/VS_Snippets_CLR/Assembly.Load1/CPP/load2.cpp#3)]
+ [!code-csharp[Assembly.Load1#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Assembly.Load1/CS/load2.cs#3)]
+ [!code-vb[Assembly.Load1#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Assembly.Load1/VB/load2.vb#3)]  
+  
+ 特定のアセンブリの 16 進形式の公開キーと公開キー トークンは、次の[厳密名 \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) コマンドを使用して出力できます。  
+  
+ **sn \-Tp \<** *assembly* **\>**  
+  
+ 公開キー ファイルがある場合は、代わりに次のコマンドを使用できます。コマンド ライン オプションの大文字と小文字の違いに注意してください。  
+  
+ **sn \-tp \<** *assembly* **\>**  
+  
+## 参照  
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md b/docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md
new file mode 100644
index 00000000000..22036bdbb98
--- /dev/null
+++ b/docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : グローバル アセンブリ キャッシュからアセンブリを削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "削除 (グローバル アセンブリ キャッシュ内のアセンブリを)"
+  - "GAC (グローバル アセンブリ キャッシュ), 削除 (アセンブリを)"
+  - "Gacutil.exe"
+  - "グローバル アセンブリ キャッシュ ツール"
+  - "グローバル アセンブリ キャッシュ, 削除 (アセンブリを)"
+  - "削除 (グローバル アセンブリ キャッシュからアセンブリを)"
+  - "厳密な名前を付けたアセンブリ, グローバル アセンブリ キャッシュ"
+ms.assetid: acdcc588-b458-436d-876c-726de68244c1
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : グローバル アセンブリ キャッシュからアセンブリを削除する
+グローバル アセンブリ キャッシュ \(GAC\) からアセンブリを削除するには、次の 2 つの方法があります。  
+  
+-   [グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用する方法。  このオプションを使用すると、開発およびテスト時に GAC に配置したアセンブリをアンインストールできます。  
+  
+-   [Windows インストーラー](http://msdn.microsoft.com/library/windows/desktop/cc185688.aspx) を使用する方法。  インストール パッケージをテストするとき、そして実稼働システムのために、アセンブリをアンインストールするにはこのオプションを使用する必要があります。  
+  
+### Gacutil.exe によるアセンブリの削除  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     **gacutil –u** \<*assembly name*\>  
+  
+     このコマンドで、*assembly name* はグローバル アセンブリ キャッシュから削除されるアセンブリの名前です。  
+  
+    > [!WARNING]
+    >  アセンブリが一部のアプリケーションで引き続き必要となる可能性があるので、Gacutil.exe を使用して実稼働システムのアセンブリを削除しないでください。  代わりに、GAC にインストールされる各アセンブリの参照カウントを保持する Windows インストーラーを使用する必要があります。  
+  
+ 次の例では、`hello.dll` という名前のアセンブリが、グローバル アセンブリ キャッシュから削除されます。  
+  
+```  
+gacutil -u hello  
+```  
+  
+### Windows インストーラーでアセンブリを削除する  
+  
+1.  **コントロール パネル**の**プログラムと機能**アプリで、アンインストールするアプリを選択します。  インストール パッケージが GAC にアセンブリを配置した場合、それらが別のアプリケーションによって使用されないときは、Windows インストーラーはそれらを削除します。  
+  
+    > [!NOTE]
+    >  Windows インストーラーは、GAC にインストールされたアセンブリの参照カウントを保持します。  アセンブリの参照カウントがゼロになる場合 \(それが Windows インストーラー パッケージによってインストールされたアプリケーションによって使用されないことを示す\) にのみ、アセンブリが GAC から削除されます。  
+  
+## 参照  
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)   
+ [方法: グローバル アセンブリ キャッシュへのアセンブリのインストール](../../../docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md b/docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md
new file mode 100644
index 00000000000..82a1991faee
--- /dev/null
+++ b/docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md
@@ -0,0 +1,107 @@
+---
+title: "方法 : 厳密な名前でアセンブリに署名する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 署名"
+  - "アセンブリ [.NET Framework], 厳密な名前を付けた"
+  - "署名 (アセンブリに)"
+  - "厳密な名前を付けたアセンブリ, 署名 (厳密な名前を使用した)"
+ms.assetid: 2c30799a-a826-46b4-a25d-c584027a6c67
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : 厳密な名前でアセンブリに署名する
+厳密な名前でアセンブリに署名するには、いくつかの方法があります。  
+  
+-   Visual Studio でプロジェクトの **\[プロパティ\]** ダイアログ ボックスにある **\[署名\]** タブを使用する。 これは、厳密な名前でアセンブリに署名するための最も簡単で便利な方法です。  
+  
+-   [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用して、.NET Framework のコード モジュール \(.netmodule ファイル\) をキー ファイルにリンクする。  
+  
+-   アセンブリ属性を使用して、厳密な名前情報をコードに挿入する。 使用するキー ファイルが配置されている場所に応じて、<xref:System.Reflection.AssemblyKeyFileAttribute> または <xref:System.Reflection.AssemblyKeyNameAttribute> 属性を使用できます。  
+  
+-   コンパイラ オプションを使用する。  
+  
+ 厳密な名前でアセンブリに署名するには、暗号キー ペアが必要です。 キー ペアの作成の詳細については、「[方法 : 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)」を参照してください。  
+  
+### Visual Studio を使用してアセンブリを作成し、厳密な名前でそのアセンブリに署名するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクトのショートカット メニューを開き、**\[プロパティ\]** を選択します。  
+  
+2.  **\[署名\]** タブを選択します。  
+  
+3.  **\[アセンブリの署名\]** ボックスを選択します。  
+  
+4.  **\[厳密な名前のキー ファイルを選択してください\]** ボックスで **\[\<参照\>\]** をクリックし、キー ファイルに移動します。 新しいキー ファイルを作成するには、**\[\<新規作成\>\]** を選択し、**\[厳密な名前キーの作成\]** ダイアログ ボックスでその名前を入力します。  
+  
+### アセンブリ リンカーを使用してアセンブリを作成し、厳密な名前でそのアセンブリに署名するには  
+  
+-   [Visual Studio コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)で次のコマンドを入力します。  
+  
+     **al** **\/out:**\<*assemblyName*\> *\<moduleName\>* **\/keyfile:**\<*keyfileName*\>  
+  
+     それぞれの文字について以下に説明します。  
+  
+     *assemblyName*  
+     アセンブリ リンカーが生成する、厳密な名前で署名されたアセンブリ \(.dll ファイルまたは .exe ファイル\) の名前。  
+  
+     *moduleName*  
+     1 つ以上の型を含む、.NET Framework コード モジュール \(.netmodule ファイル\) の名前。 C\# または Visual Basic で `/target:module` スイッチを使ってコードをコンパイルすることにより、.netmodule ファイルを作成できます。  
+  
+     *keyfileName*  
+     キー ペアを格納しているコンテナーまたはファイルの名前。 アセンブリ リンカーは、関係の相対パスを現在のディレクトリとして解釈します。  
+  
+ 次の例は、キー ファイル `MyAssembly.dll` を使用して厳密な名前でアセンブリ `sgKey.snk` に署名します。  
+  
+```  
+al /out:MyAssembly.dll MyModule.netmodule /keyfile:sgKey.snk  
+```  
+  
+ このツールの詳細については、「[アセンブリ リカー](../../../docs/framework/tools/al-exe-assembly-linker.md)」を参照してください。  
+  
+#### 属性を使用して厳密な名前でアセンブリに署名するには  
+  
+1.  <xref:System.Reflection.AssemblyKeyFileAttribute?displayProperty=fullName> または <xref:System.Reflection.AssemblyKeyNameAttribute> 属性をソース コード ファイルに追加して、厳密な名前でアセンブリに署名するときに使用するキー ペアを格納するファイルまたはコンテナーの名前を指定します。  
+  
+2.  ソース コード ファイルを通常どおりにコンパイルします。  
+  
+> [!NOTE]
+>  C\# および Visual Basic コンパイラは、ソース コードで <xref:System.Reflection.AssemblyKeyFileAttribute> または <xref:System.Reflection.AssemblyKeyNameAttribute> 属性が見つかった場合、コンパイラ警告を発行します \(CS1699 と BC41008\)。 この警告は無視してかまいません。  
+  
+ 次の例は、<xref:System.Reflection.AssemblyKeyFileAttribute> という名前のキー ファイルを指定して、`keyfile.snk` 属性を使用します。このキー ファイルは、アセンブリがコンパイルされるディレクトリにあります。  
+  
+ [!code-cpp[AssemblyName_KeyPair#21](../../../samples/snippets/cpp/VS_Snippets_CLR/AssemblyName_KeyPair/CPP/keyfileattrib.cpp#21)]
+ [!code-csharp[AssemblyName_KeyPair#21](../../../samples/snippets/csharp/VS_Snippets_CLR/AssemblyName_KeyPair/CS/keyfileattrib.cs#21)]
+ [!code-vb[AssemblyName_KeyPair#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AssemblyName_KeyPair/VB/keyfileattrib.vb#21)]  
+  
+ ソース ファイルのコンパイル時に、アセンブリに遅延署名することもできます。 詳細については、「[アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)」を参照してください。  
+  
+### コンパイラを使用して厳密な名前でアセンブリに署名するには  
+  
+-   C\# と Visual Basic では `/keyfile` または `/delaysign` コンパイラ オプションを使用し、C\+\+ では `/KEYFILE` または `/DELAYSIGN` リンカー オプションを使用して、ソース コード ファイルをコンパイルします。 オプション名の後に、コロンと、キー ファイルの名前を追加します。 コマンド ライン コンパイラを使用する場合は、ソース コード ファイルを格納するディレクトリにキー ファイルをコピーできます。  
+  
+     遅延署名については、「[アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)」を参照してください。  
+  
+     次の例は、C\# コンパイラを使用し、アセンブリ `UtilityLibrary.dll` にキー ファイル `sgKey.snk` を使用して厳密な名前で署名します。  
+  
+    ```  
+    csc /t:library UtilityLibrary.cs /keyfile:sgKey.snk  
+    ```  
+  
+## 参照  
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)   
+ [方法 : 公開キーと秘密キーのキー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)   
+ [アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)   
+ [アセンブリおよびマニフェストへの署名の管理](../Topic/Managing%20Assembly%20and%20Manifest%20Signing.md)   
+ [\[署名\] ページ \(プロジェクト デザイナー\)](../Topic/Signing%20Page,%20Project%20Designer.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-unload-an-application-domain.md b/docs/framework/app-domains/how-to-unload-an-application-domain.md
new file mode 100644
index 00000000000..6dfdc68a6ef
--- /dev/null
+++ b/docs/framework/app-domains/how-to-unload-an-application-domain.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : アプリケーション ドメインをアンロードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Unload メソッド"
+  - "アプリケーション ドメイン、アンロード"
+  - "アンロード (アプリケーション ドメインの)"
+ms.assetid: f356116d-e415-4f7c-a332-6e6a60227192
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : アプリケーション ドメインをアンロードする
+アプリケーション ドメインの使用を終了したら、[System.AppDomain.Unload](frlrfSystemAppDomainClassUnloadTopic) メソッドを使用してアプリケーション ドメインをアンロードします。  **Unload** メソッドは、指定したアプリケーション ドメインを正常にシャットダウンします。  アンロード プロセス中は、新たなスレッドがアプリケーション ドメインにアクセスすることはできず、アプリケーション ドメイン固有のデータ構造体はすべて解放されます。  
+  
+ アプリケーション ドメインに読み込まれたアセンブリは削除されるため、以後は使用できません。  アプリケーション ドメイン内のアセンブリがドメインに中立である場合、アセンブリのデータは、プロセス全体がシャットダウンされるまでメモリに残ります。  プロセス全体をシャットダウンする以外に、ドメインに中立なアセンブリをアンロードする方法はありません。  アプリケーション ドメインのアンロード要求が機能しない場合は、<xref:System.CannotUnloadAppDomainException> が生成されます。  
+  
+ `MyDomain` という新しいアプリケーション ドメインを作成し、所定の情報をコンソールに出力してから、アプリケーション ドメインをアンロードする例を次に示します。  このコードは、アンロードされたアプリケーション ドメインの表示名をコンソールに出力します。  このアクションによって例外が生成され、プログラムの末尾にある try ステートメントと catch ステートメントでこの例外が処理されます。  
+  
+## 使用例  
+ [!code-cpp[System.AppDomain.Load#3](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.appdomain.load/cpp/source3.cpp#3)]
+ [!code-csharp[System.AppDomain.Load#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.appdomain.load/cs/source3.cs#3)]
+ [!code-vb[System.AppDomain.Load#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.appdomain.load/vb/source3.vb#3)]  
+  
+## 参照  
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [方法 : アプリケーション ドメインを作成する](../../../docs/framework/app-domains/how-to-create-an-application-domain.md)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-view-assembly-contents.md b/docs/framework/app-domains/how-to-view-assembly-contents.md
new file mode 100644
index 00000000000..9c2d644c62f
--- /dev/null
+++ b/docs/framework/app-domains/how-to-view-assembly-contents.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : アセンブリの内容を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ マニフェスト、表示 (情報を)"
+  - "Ildasm.exe"
+  - "MSIL 逆アセンブラー"
+  - "アセンブリ [.NET Framework]、表示 (内容を)"
+  - "表示 (アセンブリ情報を)"
+  - "MSIL"
+  - "表示 (MSIL 情報を)"
+ms.assetid: fb7baaab-4c0d-47ad-8fd3-4591cf834709
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : アセンブリの内容を表示する
+[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用して、ファイル内の MSIL \(Microsoft Intermediate Language\) 情報を表示できます。  内容を調べる対象のファイルがアセンブリの場合、この情報には、アセンブリの属性とほかのモジュールおよびアセンブリへの参照が含まれることがあります。  この情報は、ファイルがアセンブリまたはアセンブリの一部かどうか、およびファイルにほかのモジュールまたはアセンブリへの参照があるかどうかを判断するために役立ちます。  
+  
+### Ildasm.exe を使用してアセンブリの内容を表示するには  
+  
+1.  コマンド \<プロンプト\> に **\[ildasm\]** の*アセンブリ名*。  たとえば、次のコマンドでは、`Hello.exe` アセンブリが逆アセンブルされます。  
+  
+    ```  
+    ildasm Hello.exe  
+    ```  
+  
+### アセンブリ マニフェストの情報を表示するには  
+  
+1.  MSIL 逆アセンブラー ウィンドウで、マニフェストのアイコンをダブルクリックします。  
+  
+## 使用例  
+ 次の例では、基本の "Hello, World" プログラムを使用します。  プログラムをコンパイルしてから、Ildasm.exe を使用して Hello.exe アセンブリを逆アセンブルし、アセンブリ マニフェストを参照します。  
+  
+ [!code-cpp[Conceptual.Assembly.Contents#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.assembly.contents/cpp/source.cpp#1)]
+ [!code-csharp[Conceptual.Assembly.Contents#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.assembly.contents/cs/source.cs#1)]
+ [!code-vb[Conceptual.Assembly.Contents#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.assembly.contents/vb/source.vb#1)]  
+  
+ Hello.exe アセンブリに対して ildasm.exe コマンドを実行し、IL 逆アセンブラー ウィンドウでマニフェストのアイコンをダブルクリックすると、次の内容が出力されます。  
+  
+```  
+  
+// Metadata version: v4.0.30319  
+.assembly extern mscorlib  
+{  
+  .publickeytoken = (B7 7A 5C 56 19 34 E0 89 )                         // .z\V.4..  
+  .ver 4:0:0:0  
+}  
+.assembly Hello  
+{  
+  .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilationRelaxationsAttribute::.ctor(int32) = ( 01 00 08 00 00 00 00 00 )   
+  .custom instance void [mscorlib]System.Runtime.CompilerServices.RuntimeCompatibilityAttribute::.ctor() = ( 01 00 01 00 54 02 16 57 72 61 70 4E 6F 6E 45 78   // ....T..WrapNonEx  
+                                                                                                             63 65 70 74 69 6F 6E 54 68 72 6F 77 73 01 )       // ceptionThrows.  
+  .hash algorithm 0x00008004  
+  .ver 0:0:0:0  
+}  
+.module Hello.exe  
+// MVID: {7C2770DB-1594-438D-BAE5-98764C39CCCA}  
+.imagebase 0x00400000  
+.file alignment 0x00000200  
+.stackreserve 0x00100000  
+.subsystem 0x0003       // WINDOWS_CUI  
+.corflags 0x00000001    //  ILONLY  
+// Image base: 0x00600000  
+  
+```  
+  
+ 次の表は、例で使用した Hello.exe アセンブリのアセンブリ マニフェストにある各ディレクティブの説明です。  
+  
+|ディレクティブ|説明|  
+|-------------|--------|  
+|**.assembly extern \<**の*アセンブリ名* **\>**|現在のモジュールによって参照される項目を含む別のアセンブリを指定します \(この例では `mscorlib`\)。|  
+|**.publickeytoken \<** *トークン* **\>**|参照されるアセンブリの実際のキーのトークンを指定します。|  
+|**.ver \<**の*バージョン番号* **\>**|参照されるアセンブリのバージョン番号を指定します。|  
+|**.assembly \<**の*アセンブリ名* **\>**|アセンブリ名を指定します。|  
+|**.hash algorithm \<** *int32 値* **\>**|使用されるハッシュ アルゴリズムを指定します。|  
+|**.ver \<**の*バージョン番号* **\>**|アセンブリのバージョン番号を指定します。|  
+|**.module \<**の*ファイル名* **\>**|アセンブリを構成するモジュールの名前を指定します。  この例では、アセンブリは 1 つのファイルだけで構成されています。|  
+|**.subsystem \<** *値* **\>**|プログラムが必要とするアプリケーション環境を指定します。  この例では、値 3 でこの実行可能ファイルがコンソールで実行されることを示します。|  
+|**.corflags**|現在メタデータ内で予約済みのフィールドです。|  
+  
+ アセンブリ マニフェストは、アセンブリの内容に応じて、多くの異なるディレクティブを格納できます。  アセンブリ マニフェストに含まれる多様なディレクティブの一覧については、ヨーロッパ電子計算機工業会 \(ECMA : European Computer Manufacturer Association\) のドキュメント、特に「Partition II: Metadata Definition and Semantics」および「Partition III: CIL Instruction Set」を参照してください。  ドキュメントはオンラインで入手できます。; MSDN [ECMA C\# および共通言語基盤 \(CLI\) 標準](http://go.microsoft.com/fwlink/?LinkID=99212) および [" Standard ECMA\-335 \- Common Language Infrastructure \(CLI\)](http://go.microsoft.com/fwlink/?LinkID=65552) Standards \(Web サイトを参照してください。  
+  
+## 参照  
+ [Application Domains and Assemblies](http://msdn.microsoft.com/ja-jp/433b04ae-4ba8-4849-9dbd-79194f240346)   
+ [アプリケーション ドメインとアセンブリに関する方法のトピック](../../../docs/framework/app-domains/application-domains-and-assemblies-how-to-topics.md)   
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md b/docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md
new file mode 100644
index 00000000000..db1215f0be0
--- /dev/null
+++ b/docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : グローバル アセンブリ キャッシュの内容を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "GAC (グローバル アセンブリ キャッシュ), 表示 (内容を)"
+  - "Gacutil.exe"
+  - "グローバル アセンブリ キャッシュ ツール"
+  - "グローバル アセンブリ キャッシュ, 表示 (内容を)"
+  - "一覧 (グローバル アセンブリ キャッシュ内のアセンブリの)"
+  - "厳密な名前を付けたアセンブリ, グローバル アセンブリ キャッシュ"
+  - "表示 (グローバル アセンブリ キャッシュ内のアセンブリを)"
+ms.assetid: c5f786a0-969b-4f14-9f02-e77c3384d9af
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : グローバル アセンブリ キャッシュの内容を表示する
+[グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用すると、グローバル アセンブリ キャッシュの内容を表示できます。  
+  
+### グローバル アセンブリ キャッシュ内のアセンブリの一覧を表示するには、次のようにします。  
+  
+1.  [Visual Studio コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)で次のコマンドを入力します。  
+  
+     **gacutil \-l**   
+     または               
+     **gacutil \/l**  
+  
+ 以前のバージョンの .NET Framework では、Windows のシェル拡張機能である [Shfusion.dll](http://msdn.microsoft.com/ja-jp/0d9464cf-ddba-4ca9-bbec-f678fb58f380) により、エクスプローラーでグローバル アセンブリ キャッシュを表示することができました。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、Shfusion.dll は廃止されましたが、互換性のために残されています。  
+  
+## 参照  
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/index.md b/docs/framework/app-domains/index.md
new file mode 100644
index 00000000000..16449f6c3b4
--- /dev/null
+++ b/docs/framework/app-domains/index.md
@@ -0,0 +1,50 @@
+---
+title: "アプリケーション ドメインとアセンブリを使用したプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン, プログラミング"
+  - "アセンブリ [.NET Framework], プログラミング"
+  - "プログラミング (アプリケーション ドメインの)"
+  - "プログラミング (アセンブリの)"
+ms.assetid: 96d3b8e3-bef8-4da0-9a81-9841e23a94e9
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# アプリケーション ドメインとアセンブリを使用したプログラミング
+Microsoft Internet Explorer、ASP.NET、Windows シェルなどのホストは、共通言語ランタイムをプロセスに読み込み、そのプロセス内で[アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)を作成します。その後 .NET Framework アプリケーションを実行するときに、そのアプリケーション ドメインにユーザー コードを読み込んでコードを実行します。  通常は、アプリケーション ドメインの作成およびアセンブリへの読み込みはランタイム ホストで実行するため、考慮する必要はありません。  
+  
+ しかし、共通言語ランタイムをホストするアプリケーションを作成する場合、プログラムによってアンロードされるツールまたはコードを作成する場合、または実行時にアンロードおよび再読み込みできるプラグ可能なコンポーネントを作成する場合は、独自のアプリケーション ドメインを作成します。  ランタイム ホストを作成しない場合でも、このセクションにある、アプリケーション ドメインとアプリケーション ドメインに読み込まれたアセンブリをどのように使用するかという説明は重要です。  
+  
+## このセクションの内容  
+ [アプリケーション ドメインとアセンブリに関する方法のトピック](../../../docs/framework/app-domains/application-domains-and-assemblies-how-to-topics.md)  
+ 概念を説明したドキュメントに用意されている、アプリケーション ドメインとアセンブリを利用したプログラミングに関するトピックへのリンクを示します。  
+  
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)  
+ アプリケーション ドメインを作成、構成、および使用する例を示します。  
+  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)  
+ アセンブリを作成し、署名し、その属性を設定する方法を説明します。  
+  
+## 関連項目  
+ [動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)  
+ 動的アセンブリの作成方法を説明します。  
+  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)  
+ アセンブリの概念的な概要を説明します。  
+  
+ [アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)  
+ アプリケーション ドメインの概念的な概要を説明します。  
+  
+ [リフレクションの概要](../../../docs/framework/reflection-and-codedom/reflection.md)  
+ **Reflection** クラスを使って、アセンブリに関する情報を取得する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/app-domains/media/assemblyover1.gif b/docs/framework/app-domains/media/assemblyover1.gif
new file mode 100644
index 00000000000..f359a97e5eb
Binary files /dev/null and b/docs/framework/app-domains/media/assemblyover1.gif differ
diff --git a/docs/framework/app-domains/media/assemblyover2.gif b/docs/framework/app-domains/media/assemblyover2.gif
new file mode 100644
index 00000000000..15467ddede9
Binary files /dev/null and b/docs/framework/app-domains/media/assemblyover2.gif differ
diff --git a/docs/framework/app-domains/media/assemblytypes.gif b/docs/framework/app-domains/media/assemblytypes.gif
new file mode 100644
index 00000000000..cfee9fdc330
Binary files /dev/null and b/docs/framework/app-domains/media/assemblytypes.gif differ
diff --git a/docs/framework/app-domains/media/versioningover.gif b/docs/framework/app-domains/media/versioningover.gif
new file mode 100644
index 00000000000..10d4eb980f5
Binary files /dev/null and b/docs/framework/app-domains/media/versioningover.gif differ
diff --git a/docs/framework/app-domains/multifile-assemblies.md b/docs/framework/app-domains/multifile-assemblies.md
new file mode 100644
index 00000000000..f73f4aa89a0
--- /dev/null
+++ b/docs/framework/app-domains/multifile-assemblies.md
@@ -0,0 +1,50 @@
+---
+title: "マルチファイル アセンブリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], マルチファイル"
+  - "アセンブリ マニフェスト, マルチファイル アセンブリ"
+  - "コード モジュール"
+  - "コマンド ライン コンパイラ"
+  - "コンパイル (アセンブリの)"
+  - "エントリ ポイント (アセンブリの)"
+  - "マルチファイル アセンブリ"
+ms.assetid: 13509e73-db77-4645-8165-aad8dfaedff6
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# マルチファイル アセンブリ
+マルチファイル アセンブリは、コマンド ライン コンパイラまたは Visual C\+\+ 付き [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] を使用して作成できます。  アセンブリ内の 1 つのファイルでアセンブリ マニフェストを格納している必要があります。  また、アプリケーションを起動するアセンブリは、Main メソッドや WinMain メソッドなどのエントリ ポイントを含む必要があります。  
+  
+ たとえば、Client.cs と Stringer.cs の 2 つのコード モジュールを含むアプリケーションがあるとします。  Stringer.cs は、Client.cs 内のコードによって参照される `myStringer` 名前空間を作成します。  Client.cs は、アプリケーションのエントリ ポイントである `Main` メソッドを格納します。  この例で、この 2 つのコード モジュールをコンパイルしてから、アプリケーションを起動するためのアセンブリ マニフェストを格納する 3 番目のファイルを作成します。  アセンブリ マニフェストは、`Client` モジュールと `Stringer` モジュールの両方を参照します。  
+  
+> [!NOTE]
+>  マルチファイル アセンブリは、アセンブリに複数のコード モジュールがある場合でも、1 つのエントリ ポイントしか持つことができません。  
+  
+ マルチファイル アセンブリの作成が必要になる理由は、いくつか考えられます。  
+  
+-   異なる言語で記述された複数のモジュールを結合するため。  これは、マルチファイル アセンブリの作成が必要になる最も一般的な理由です。  
+  
+-   必要な場合にしかダウンロードされないモジュールに使用頻度の低い型を配置することで、アプリケーションのダウンロードを最適化するため。  
+  
+    > [!NOTE]
+    >  `<object>` タグと Microsoft Internet Explorer を使用してダウンロードされるアプリケーションを作成する場合は、マルチファイル アセンブリを作成することが重要です。  この方法では、アセンブリは、アセンブリ マニフェストだけを格納するコードモジュールとは分けて作成します。  Internet Explorer は、最初にアセンブリ マニフェストをダウンロードしてから、その他の必要なモジュールまたはアセンブリをすべてダウンロードするためにワーカー スレッドを作成します。  アセンブリ マニフェストを格納するファイルのダウンロード中は、Internet Explorer はユーザーからの入力には応答しません。  アセンブリ マニフェストを格納するファイルが小さいほど、Internet Explorer が応答しない時間は短くなります。  
+  
+-   複数の開発者が記述したコード モジュールを結合するため。  開発者は作成したコード モジュールを各自でコンパイルできます。しかしこの場合、すべてのモジュールを 1 つのマルチファイル アセンブリにするときには公開されない型が、パブリックな型として公開されてしまうことがあります。  
+  
+ アセンブリを作成した後は、アセンブリ マニフェストの格納ファイル、つまりアセンブリに署名したり、ファイルおよびアセンブリに厳密な名前を付けてグローバル アセンブリ キャッシュに配置したりできます。  
+  
+## 参照  
+ [方法 : マルチファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-multifile-assembly.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/programming-with-assemblies.md b/docs/framework/app-domains/programming-with-assemblies.md
new file mode 100644
index 00000000000..14994ca42cc
--- /dev/null
+++ b/docs/framework/app-domains/programming-with-assemblies.md
@@ -0,0 +1,91 @@
+---
+title: "アセンブリを使用したプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], プログラミング"
+  - "プログラミング (アセンブリの)"
+ms.assetid: 25918b15-701d-42c7-95fc-c290d08648d6
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# アセンブリを使用したプログラミング
+アセンブリは .NET Framework のビルド ブロックであり、配置、バージョン管理、再利用、アクティブ化のスコープの指定、およびセキュリティ アクセス許可の基本単位となります。  共通言語ランタイムは、型の実装に関して必要な情報をアセンブリから取得します。  アセンブリは、相互に連携して 1 つの論理的な機能単位を形成するように構築された型やリソースの集合です。  共通言語ランタイムにとって、型はアセンブリのコンテキストの外部には存在しません。  
+  
+ このセクションでは、モジュールの作成、モジュールからのアセンブリの作成、キー ペアの作成、厳密な名前でのアセンブリへの署名、およびグローバル アセンブリ キャッシュへのアセンブリのインストールについて説明します。  また、このセクションでは、[MSIL 逆アセンブラー \(Ildasm.exe\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用したアセンブリ マニフェスト情報の表示方法についても説明します。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 以降では、現在読み込まれているランタイムよりもバージョン番号が新しい .NET Framework のバージョンでコンパイルされたアセンブリを、ランタイムが読み込まないようになりました。  これに該当するのは、バージョン番号のメジャー部分とマイナー部分を組み合わせた番号です。  
+  
+## このセクションの内容  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)  
+ シングルファイル アセンブリとマルチファイル アセンブリの概要を説明します。  
+  
+ [アセンブリ名](../../../docs/framework/app-domains/assembly-names.md)  
+ アセンブリの名前付けの概要を説明します。  
+  
+ [方法 : アセンブリの完全修飾名を特定する](../../../docs/framework/app-domains/how-to-determine-assembly-fully-qualified-name.md)  
+ アセンブリの完全修飾名を決定する方法を説明します。  
+  
+ [イントラネット アプリケーションの完全信頼での実行](../../../docs/framework/app-domains/running-intranet-applications-in-full-trust.md)  
+ イントラネット共有で完全に信頼されているアセンブリのレガシ セキュリティ ポリシーを指定する方法を説明します。  
+  
+ [アセンブリの場所](../../../docs/framework/app-domains/assembly-location.md)  
+ アセンブリを配置する場所の概要を説明します。  
+  
+ [方法: シングルファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-single-file-assembly.md)  
+ シングルファイル アセンブリの作成方法を説明します。  
+  
+ [マルチファイル アセンブリ](../../../docs/framework/app-domains/multifile-assemblies.md)  
+ マルチファイル アセンブリを作成する理由を説明します。  
+  
+ [方法 : マルチファイル アセンブリをビルドする](../../../docs/framework/app-domains/how-to-build-a-multifile-assembly.md)  
+ マルチファイル アセンブリの作成方法を説明します。  
+  
+ [アセンブリ属性の設定](../../../docs/framework/app-domains/set-assembly-attributes.md)  
+ アセンブリ属性とその設定方法を説明します。  
+  
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)  
+ 厳密な名前を使用してアセンブリに署名する方法とその理由について、具体的な手順を交えて説明します。  
+  
+ [アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)  
+ アセンブリに遅延署名する方法を説明します。  
+  
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)  
+ グローバル アセンブリ キャッシュにアセンブリを追加する方法とその理由について、具体的な手順を交えて説明します。  
+  
+ [方法 : アセンブリの内容を表示する](../../../docs/framework/app-domains/how-to-view-assembly-contents.md)  
+ MSIL 逆アセンブラー \(Ildasm.exe\) を使用したアセンブリ内容の表示方法を説明します。  
+  
+ [共通言語ランタイムでの型の転送](../../../docs/framework/app-domains/type-forwarding-in-the-common-language-runtime.md)  
+ 型の転送を使用して、既存のアプリケーションを壊すことなく型を別のアセンブリに移動させる方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Reflection.Assembly>  
+ アセンブリを表す .NET Framework クラス。  
+  
+## 関連項目  
+ [方法 : アセンブリから型およびメンバーの情報を取得する](../../../docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md)  
+ アセンブリから型情報などの情報をプログラムによって取得する方法を説明します。  
+  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)  
+ 共通言語ランタイムアセンブリの概念的な概要を説明します。  
+  
+ [アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)  
+ アセンブリのバインディングと、<xref:System.Reflection.AssemblyVersionAttribute> 属性および <xref:System.Reflection.AssemblyInformationalVersionAttribute> 属性について概要を説明します。  
+  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)  
+ バインディング要求を満たすために使用するアセンブリを、ランタイムが決定する方法を説明します。  
+  
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)  
+ **Reflection** クラスを使って、アセンブリに関する情報を取得する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/app-domains/resolve-assembly-loads.md b/docs/framework/app-domains/resolve-assembly-loads.md
new file mode 100644
index 00000000000..c5fb0f27e0e
--- /dev/null
+++ b/docs/framework/app-domains/resolve-assembly-loads.md
@@ -0,0 +1,86 @@
+---
+title: "アセンブリ読み込みの解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework]、解決 (読み込みを)"
+  - "アプリケーション ドメイン、読み込み (アセンブリを)"
+  - "解決 (アセンブリ読み込みを)"
+  - "アセンブリ [.NET Framework]、読み込み"
+  - "アプリケーション ドメイン、解決 (アセンブリ読み込みを)"
+ms.assetid: 5099e549-f4fd-49fb-a290-549edd456c6a
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アセンブリ読み込みの解決
+.NET Framework には、アセンブリの読み込みをより細かく制御する必要があるアプリケーション向けに <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントが用意されています。  このイベントを処理することにより、アプリケーションでは、アセンブリを通常のプローブ パス以外から読み込みコンテキストに読み込んだり、読み込むアセンブリのバージョンを複数選択したり、動的アセンブリを生成して返したりすることができます。  このトピックでは、<xref:System.AppDomain.AssemblyResolve> イベントの処理に関するガイダンスを示します。  
+  
+> [!NOTE]
+>  リフレクション専用コンテキストでアセンブリの読み込みを解決する場合は、代わりに <xref:System.AppDomain.ReflectionOnlyAssemblyResolve?displayProperty=fullName> イベントを使用します。  
+  
+## AssemblyResolve イベントの動作  
+ <xref:System.AppDomain.AssemblyResolve> イベントのハンドラーを登録すると、ランタイムで名前によるアセンブリへのバインドに失敗した場合に、必ずこのハンドラーが呼び出されます。  たとえば、ユーザー コードから次のメソッドを呼び出すと、<xref:System.AppDomain.AssemblyResolve> イベントが発生することがあります。  
+  
+-   読み込むアセンブリの表示名を表す文字列 \(<xref:System.Reflection.Assembly.FullName%2A?displayProperty=fullName> プロパティによって返される文字列\) を最初の引数として指定する <xref:System.AppDomain.Load%2A?displayProperty=fullName> メソッド オーバーロードまたは <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッド オーバーロード。  
+  
+-   読み込むアセンブリを識別する <xref:System.Reflection.AssemblyName> オブジェクトを最初の引数として指定する <xref:System.AppDomain.Load%2A?displayProperty=fullName> メソッド オーバーロードまたは <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッド オーバーロード。  
+  
+-   <xref:System.Reflection.Assembly.LoadWithPartialName%2A?displayProperty=fullName> メソッド オーバーロード。  
+  
+-   別のアプリケーション ドメインのオブジェクトをインスタンス化する <xref:System.AppDomain.CreateInstance%2A?displayProperty=fullName> または <xref:System.AppDomain.CreateInstanceAndUnwrap%2A?displayProperty=fullName> メソッド オーバーロード。  
+  
+### イベント ハンドラーで実行する処理  
+ <xref:System.AppDomain.AssemblyResolve> イベントのハンドラーは、読み込むアセンブリの表示名を <xref:System.ResolveEventArgs.Name%2A?displayProperty=fullName> プロパティで受け取ります。  アセンブリ名を認識できない場合、ハンドラーは null \(Visual Basic の場合は `Nothing`、Visual C\+\+ の場合は `nullptr`\) を返します。  
+  
+ アセンブリ名を認識すると、ハンドラーは要求を満たすアセンブリを読み込んで返すことができます。  サンプルのシナリオをいくつか示します。  
+  
+-   アセンブリのバージョンの場所がわかっている場合、<xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドまたは <xref:System.Reflection.Assembly.LoadFile%2A?displayProperty=fullName> メソッドを使用してアセンブリを読み込み、正常に読み込まれた場合はそのアセンブリを返すことができます。  
+  
+-   アセンブリがバイト配列として格納されているデータベースにアクセスできる場合、バイト配列を受け取るいずれかの <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッド オーバーロードを使用してバイト配列を読み込むことができます。  
+  
+-   動的アセンブリを生成して返すことができます。  
+  
+> [!NOTE]
+>  このハンドラーでアセンブリを読み込むときは、読み込み元コンテキストまたは読み込みコンテキストに読み込むか、コンテキストなしで読み込む必要があります。  <xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A?displayProperty=fullName> または <xref:System.Reflection.Assembly.ReflectionOnlyLoadFrom%2A?displayProperty=fullName> メソッドを使用してリフレクション専用コンテキストにアセンブリを読み込もうとすると、<xref:System.AppDomain.AssemblyResolve> イベントを発生させた読み込みは失敗します。  
+  
+ イベント ハンドラーは、適切なアセンブリを返す必要があります。  ハンドラーでは、<xref:System.ResolveEventArgs.Name%2A?displayProperty=fullName> プロパティの値を <xref:System.Reflection.AssemblyName.%23ctor%28System.String%29> コンストラクターに渡すことによって、要求されたアセンブリの表示名を解析できます。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、<xref:System.ResolveEventArgs.RequestingAssembly%2A?displayProperty=fullName> プロパティを使用して、現在の要求が別のアセンブリと依存関係にあるかどうかを確認できます。  この情報は、依存関係を満たすアセンブリを識別するうえで役立ちます。  
+  
+ イベント ハンドラーは、要求されたバージョンとは異なるバージョンのアセンブリを返すことがあります。  
+  
+ ほとんどの場合、ハンドラーによって返されるアセンブリは、ハンドラーが読み込んだコンテキストに関係なく、読み込みコンテキストで返されます。  たとえば、ハンドラーが <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドを使用して読み込み元コンテキストにアセンブリを読み込んだ場合、ハンドラーからアセンブリが返されるときは読み込みコンテキストで返されます。  ただし、次の場合は、アセンブリがハンドラーからコンテキストなしで返されます。  
+  
+-   ハンドラーがコンテキストなしでアセンブリを読み込んだ場合。  
+  
+-   <xref:System.ResolveEventArgs.RequestingAssembly%2A?displayProperty=fullName> プロパティが null でない場合。  
+  
+-   要求元のアセンブリ \(<xref:System.ResolveEventArgs.RequestingAssembly%2A?displayProperty=fullName> プロパティによって返されるアセンブリ\) がコンテキストなしで読み込まれている場合。  
+  
+ コンテキストの詳細については、<xref:System.Reflection.Assembly.LoadFrom%28System.String%29?displayProperty=fullName> メソッド オーバーロードのトピックを参照してください。  
+  
+ 同じアセンブリの複数のバージョンを同じアプリケーション ドメインに読み込むこともできますが、  型の割り当てで問題が生じる可能性があるため、この方法はお勧めしません。  「[アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)」を参照してください。  
+  
+### イベント ハンドラーで実行すべきでない処理  
+ <xref:System.AppDomain.AssemblyResolve> イベントを処理する際の基本的なルールとして、認識できないアセンブリは返さないようにしてください。  ハンドラーを記述するときは、このイベントが発生する原因となる可能性があるアセンブリを把握しておく必要があります。  それ以外のアセンブリについては、null を返すようにしてください。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、<xref:System.AppDomain.AssemblyResolve> イベントはサテライト アセンブリに対して発生します。  この変更は、以前のバージョンの .NET Framework 用に記述されたイベント ハンドラーで、すべてのアセンブリ読み込み要求を解決しようとする場合に影響します。  認識できないアセンブリを無視するイベント ハンドラーには、この変更による影響はありません。それらのイベント ハンドラーは null を返し、通常のフォールバック機構に従います。  
+  
+ イベント ハンドラーでアセンブリを読み込むときに、<xref:System.AppDomain.AssemblyResolve> イベントを再帰的に発生させる可能性がある <xref:System.AppDomain.Load%2A?displayProperty=fullName> メソッド オーバーロードまたは <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッド オーバーロードは使用しないでください。これを使用すると、スタック オーバーフローが発生する可能性があります \(前述の一覧を参照してください\)。これは、読み込み要求の例外処理を指定した場合でも発生します。すべてのイベント ハンドラーから制御が戻るまでは例外がスローされないからです。  したがって、次のコードでは、`MyAssembly` が見つからないとスタック オーバーフローが発生します。  
+  
+ [!code-cpp[AssemblyResolveRecursive#1](../../../samples/snippets/cpp/VS_Snippets_CLR/assemblyresolverecursive/cpp/example.cpp#1)]
+ [!code-csharp[AssemblyResolveRecursive#1](../../../samples/snippets/csharp/VS_Snippets_CLR/assemblyresolverecursive/cs/example.cs#1)]
+ [!code-vb[AssemblyResolveRecursive#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/assemblyresolverecursive/vb/example.vb#1)]  
+  
+## 参照  
+ [アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/retrieve-setup-information.md b/docs/framework/app-domains/retrieve-setup-information.md
new file mode 100644
index 00000000000..8077b96c69b
--- /dev/null
+++ b/docs/framework/app-domains/retrieve-setup-information.md
@@ -0,0 +1,43 @@
+---
+title: "アプリケーション ドメインからのセットアップ情報の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AppDomainSetup オブジェクト"
+  - "アプリケーション ドメイン, 取得 (セットアップ情報を)"
+  - "取得 (セットアップ情報を)"
+ms.assetid: 5cdb12ae-1e37-4a62-8ec7-93d6dcc6e8d9
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アプリケーション ドメインからのセットアップ情報の取得
+アプリケーション ドメインの各インスタンスは、プロパティと <xref:System.AppDomainSetup> 情報で構成されます。  <xref:System.AppDomain?displayProperty=fullName> クラスを使用して、アプリケーション ドメインからセットアップ情報を取得できます。  このクラスは、アプリケーション ドメインについての構成情報を取得するいくつかのメンバーを提供します。  
+  
+ アプリケーション ドメインの **AppDomainSetup** オブジェクトを問い合わせて、アプリケーション ドメインの作成時に渡されたセットアップ情報を取得することもできます。  
+  
+ 新しいアプリケーション ドメインを作成し、いくつかのメンバー値をコンソールに出力する例を次に示します。  
+  
+ [!code-cpp[AppDomain_Setup#2](../../../samples/snippets/cpp/VS_Snippets_CLR/AppDomain_Setup/CPP/source2.cpp#2)]
+ [!code-csharp[AppDomain_Setup#2](../../../samples/snippets/csharp/VS_Snippets_CLR/AppDomain_Setup/CS/source2.cs#2)]
+ [!code-vb[AppDomain_Setup#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AppDomain_Setup/VB/source2.vb#2)]  
+  
+ アプリケーション ドメインのセットアップ情報を設定してから取得する例を次に示します。  `AppDomain.SetupInformation.ApplicationBase` は構成情報を取得します。  
+  
+ [!code-cpp[AppDomain_Setup#3](../../../samples/snippets/cpp/VS_Snippets_CLR/AppDomain_Setup/CPP/source3.cpp#3)]
+ [!code-csharp[AppDomain_Setup#3](../../../samples/snippets/csharp/VS_Snippets_CLR/AppDomain_Setup/CS/source3.cs#3)]
+ [!code-vb[AppDomain_Setup#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AppDomain_Setup/VB/source3.vb#3)]  
+  
+## 参照  
+ [Hosting Overview](http://msdn.microsoft.com/ja-jp/ea527626-99e3-4995-81c4-c8f3e60eb6d5)   
+ [Programming with Application Domains](http://msdn.microsoft.com/ja-jp/bd36055b-56bd-43eb-b4d8-820c37172131)   
+ [アプリケーション ドメインの使用](../../../docs/framework/app-domains/use.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/running-intranet-applications-in-full-trust.md b/docs/framework/app-domains/running-intranet-applications-in-full-trust.md
new file mode 100644
index 00000000000..16f69478888
--- /dev/null
+++ b/docs/framework/app-domains/running-intranet-applications-in-full-trust.md
@@ -0,0 +1,43 @@
+---
+title: "イントラネット アプリケーションの完全信頼での実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "完全信頼, 実行 (イントラネット アプリケーションを)"
+  - "イントラネット アプリケーション, 実行 (完全信頼で)"
+  - "実行 (イントラネット アプリケーションを完全信頼で)"
+ms.assetid: ee13c0a8-ab02-49f7-b8fb-9eab16c6c4f0
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# イントラネット アプリケーションの完全信頼での実行
+.NET Framework Version 3.5 Service Pack 1 \(SP1\) 以降では、アプリケーションとライブラリ アセンブリを、完全に信頼されているアセンブリとしてネットワーク共有から実行できるようになりました。  イントラネットの共有から読み込まれるアセンブリには、<xref:System.Security.SecurityZone> ゾーンの証拠が自動的に追加されます。  この証拠はアセンブリに対し、コンピューター上にあるアセンブリと同じ許可セット \(通常は完全信頼\) を付与します。  この機能は、ホスト上で実行するように設計されている ClickOnce アプリケーションには適用されません。  
+  
+## ライブラリ アセンブリの規則  
+ ネットワーク共有から実行可能ファイルによって読み込まれるアセンブリには、次の規則が適用されます。  
+  
+-   ライブラリ アセンブリは、実行可能なアセンブリと同じフォルダーに存在する必要があります。  サブフォルダーにあるアセンブリや、別のパスで参照されるアセンブリには、完全信頼の許可セットは付与されません。  
+  
+-   実行可能ファイルがアセンブリを遅延読み込みする場合、その実行可能ファイルの起動に使用したのと同じパスを使用する必要があります。  たとえば、共有の\\\\の*network\-computer*の\\*share* がドライブ文字にマップされ、実行可能ファイルを実行すると、そのパスから使用して実行可能ファイルによって読み込まれるアセンブリは、ネットワーク パス、完全信頼が付与されません。  <xref:System.Security.SecurityZone> ゾーンでアセンブリを遅延読み込みするには、実行可能ファイルがドライブ文字のあるパスを使用している必要があります。  
+  
+## 以前のイントラネット ポリシーの復元  
+ .NET Framework の以前のバージョンでは、共有アセンブリには <xref:System.Security.SecurityZone> ゾーンの証拠が付与されていました。  共有上のアセンブリに完全な信頼を付与するには、コード アクセス セキュリティ ポリシーを指定する必要がありました。  
+  
+ この新しい動作は、イントラネット アセンブリの既定の動作です。  コンピューターのすべてのアプリケーションに適用されるレジストリ キー値を設定することで、以前の <xref:System.Security.SecurityZone> 証拠が使用される動作に戻すことができます。  この手順は、32 ビット コンピューターと 64 ビット コンピューターで異なります。  
+  
+-   32 ビット コンピューターでは、システム レジストリの HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework キーの下にサブキーを作成します。  キーの名前は LegacyMyComputerZone とし、DWORD 値 1 を設定します。  
+  
+-   64 ビット コンピューターでは、システム レジストリの HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework キーの下にサブキーを作成します。  キーの名前は LegacyMyComputerZone とし、DWORD 値 1 を設定します。  HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\.NETFramework キー下に同じサブキーを作成します。  
+  
+## 参照  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/set-assembly-attributes.md b/docs/framework/app-domains/set-assembly-attributes.md
new file mode 100644
index 00000000000..d6b1a0f2943
--- /dev/null
+++ b/docs/framework/app-domains/set-assembly-attributes.md
@@ -0,0 +1,92 @@
+---
+title: "アセンブリ属性の設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 属性"
+  - "アセンブリのバインディング, 属性"
+  - "アセンブリ マニフェスト, 属性"
+ms.assetid: 36a98a81-b5b5-4c19-912a-11f91eff7f4e
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# アセンブリ属性の設定
+アセンブリの属性は、アセンブリに関する情報を提供する値です。 属性は、次のような情報に分類されます。  
+  
+-   アセンブリ ID 属性。  
+  
+-   情報属性。  
+  
+-   アセンブリ マニフェスト属性。  
+  
+-   厳密な名前の属性。  
+  
+## アセンブリ ID 属性  
+ アセンブリは、名前、バージョン、およびカルチャの 3 つの属性と、適用される場合は厳密な名前によって識別されます。 これらの属性は、アセンブリの完全な名前を形成し、コード内でアセンブリを参照するときに必要になります。 属性を使用して、アセンブリのバージョンとのカルチャを設定できます。 コンパイラまたは [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) は、アセンブリの作成時に、アセンブリ マニフェストを含むファイルに基づいて名前の値を設定します。  
+  
+ バージョン属性とカルチャ属性について次の表で説明します。  
+  
+|アセンブリ ID 属性|説明|  
+|-----------------|--------|  
+|<xref:System.Reflection.AssemblyCultureAttribute>|アセンブリがサポートするカルチャを示す列挙フィールド。 アセンブリがカルチャに依存しないように指定することもできます。その場合は、アセンブリが既定のカルチャのリソースを格納することを意味します。 **Note:**  ランタイムは、カルチャ属性が null に設定されていないすべてのアセンブリを、サテライト アセンブリとして扱います。 そのようなアセンブリには、サテライト アセンブリ バインディング規則が適用されます。 詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。|  
+|<xref:System.Reflection.AssemblyFlagsAttribute>|アセンブリを並列で実行できるかどうかなどのアセンブリ属性を設定する値。|  
+|<xref:System.Reflection.AssemblyVersionAttribute>|*major*.*minor*.*build*.*revision* 形式の数値 \(たとえば、2.4.0.0\)。 共通言語ランタイムは、この値を使用して、厳密な名前付きアセンブリでのバインディング操作を実行します。 **Note:**  <xref:System.Reflection.AssemblyInformationalVersionAttribute> 属性がアセンブリに適用されない場合、<xref:System.Reflection.AssemblyVersionAttribute> 属性によって指定されたバージョン番号が <xref:System.Windows.Forms.Application.ProductVersion%2A?displayProperty=fullName>、<xref:System.Windows.Forms.Application.UserAppDataPath%2A?displayProperty=fullName>、および <xref:System.Windows.Forms.Application.UserAppDataRegistry%2A?displayProperty=fullName> の各プロパティで使用されます。|  
+  
+ バージョン属性とカルチャ属性をアセンブリに適用する方法を次のコード例で示します。  
+  
+ [!code-cpp[AssemblyDelaySignAttribute#3](../../../samples/snippets/cpp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cpp/source2.cpp#3)]
+ [!code-csharp[AssemblyDelaySignAttribute#3](../../../samples/snippets/csharp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cs/source2.cs#3)]
+ [!code-vb[AssemblyDelaySignAttribute#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AssemblyDelaySignAttribute/vb/source2.vb#3)]  
+  
+## 情報属性  
+ 情報属性は、追加の会社情報または製品情報をアセンブリに指定する場合に使用できます。 アセンブリに適用できる情報属性について、次の表で説明します。  
+  
+|情報属性|説明|  
+|----------|--------|  
+|<xref:System.Reflection.AssemblyCompanyAttribute>|会社名を指定する文字列値。|  
+|<xref:System.Reflection.AssemblyCopyrightAttribute>|著作権情報を指定する文字列値。|  
+|<xref:System.Reflection.AssemblyFileVersionAttribute>|Win32 ファイル バージョン番号を指定する文字列値。 通常、この属性の既定値はアセンブリ バージョンです。|  
+|<xref:System.Reflection.AssemblyInformationalVersionAttribute>|完全な製品バージョン番号など、共通言語ランタイムによって使用されないバージョン情報を指定する文字列値。 **Note:**  この属性をアセンブリに適用した場合は、<xref:System.Windows.Forms.Application.ProductVersion%2A?displayProperty=fullName> プロパティを使用して、この属性で指定された文字列を実行時に取得できます。 この文字列は、<xref:System.Windows.Forms.Application.UserAppDataPath%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Forms.Application.UserAppDataRegistry%2A?displayProperty=fullName> プロパティによって提供されるパスとレジストリ キーにも使用されます。|  
+|<xref:System.Reflection.AssemblyProductAttribute>|製品情報を指定する文字列値。|  
+|<xref:System.Reflection.AssemblyTrademarkAttribute>|商標情報を指定する文字列値。|  
+  
+ これらの属性は、アセンブリの \[Windows のプロパティ\] ページに表示できます。また、独自の Win32 リソース ファイルを指定するために、**\/win32res** コンパイラ オプションを使用してこれらの属性をオーバーライドすることもできます。  
+  
+## アセンブリ マニフェスト属性  
+ アセンブリ マニフェストの属性を使用すると、タイトル、説明、既定のエイリアス、構成などの情報をアセンブリ マニフェストに指定できます。 アセンブリ マニフェスト属性について、次の表で説明します。  
+  
+|アセンブリ マニフェスト属性|説明|  
+|--------------------|--------|  
+|<xref:System.Reflection.AssemblyConfigurationAttribute>|Retail \(製品版\) や Debug \(デバッグ\) など、アセンブリの構成を示す文字列値。 ランタイムはこの値を使用しません。|  
+|<xref:System.Reflection.AssemblyDefaultAliasAttribute>|アセンブリの参照に使用する既定のエイリアスを指定する文字列値。 この値は、アセンブリ自体の名前がフレンドリ名ではない場合 \(GUID 値の場合など\) に、フレンドリ名を指定します。 この値は、完全なアセンブリ名の短い形式としても使用できます。|  
+|<xref:System.Reflection.AssemblyDescriptionAttribute>|アセンブリの特性と目的を要約した短い説明を指定する文字列値。|  
+|<xref:System.Reflection.AssemblyTitleAttribute>|アセンブリのフレンドリ名を指定する文字列値。 たとえば、comdlg という名前のアセンブリに Microsoft Common Dialog Control というタイトルを付けることができます。|  
+  
+## 厳密な名前の属性  
+ 厳密な名前の属性を使用すると、アセンブリに厳密な名前を設定できます。 厳密な名前の属性について、次の表で説明します。  
+  
+|厳密な名前の属性|説明|  
+|--------------|--------|  
+|<xref:System.Reflection.AssemblyDelaySignAttribute>|遅延署名が使用されていることを示すブール値。|  
+|<xref:System.Reflection.AssemblyKeyFileAttribute>|この属性のコンストラクターにパラメーターとして渡される公開キー \(遅延署名を使用する場合\) または公開キーと秘密キーの両方を格納するファイルの名前を示す文字列値。 なお、このファイル名は、ソース ファイルのパスではなく出力ファイルのパスから見た相対パス名 \(.exe または .dll\) です。|  
+|<xref:System.Reflection.AssemblyKeyNameAttribute>|この属性のコンストラクターにパラメーターとして渡されるキー ペアを格納するキー コンテナーを示します。|  
+  
+ 次のコード例では、遅延署名を使用し、公開キー ファイル `myKey.snk` を使用する厳密な名前付きアセンブリを作成する場合に適用する属性を示します。  
+  
+ [!code-cpp[AssemblyDelaySignAttribute#4](../../../samples/snippets/cpp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cpp/source2.cpp#4)]
+ [!code-csharp[AssemblyDelaySignAttribute#4](../../../samples/snippets/csharp/VS_Snippets_CLR/AssemblyDelaySignAttribute/cs/source2.cs#4)]
+ [!code-vb[AssemblyDelaySignAttribute#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AssemblyDelaySignAttribute/vb/source2.vb#4)]  
+  
+## 参照  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/shadow-copy-assemblies.md b/docs/framework/app-domains/shadow-copy-assemblies.md
new file mode 100644
index 00000000000..c4c3c922de4
--- /dev/null
+++ b/docs/framework/app-domains/shadow-copy-assemblies.md
@@ -0,0 +1,90 @@
+---
+title: "アセンブリのシャドウ コピー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン, アセンブリのシャドウ コピー"
+  - "アセンブリ [.NET Framework], シャドウ コピー"
+  - "アセンブリのシャドウ コピー"
+ms.assetid: de8b8759-fca7-4260-896b-5a4973157672
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# アセンブリのシャドウ コピー
+シャドウ コピーにより、アプリケーション ドメインをアンロードしなくても、アプリケーション ドメインで使用されるアセンブリを更新できます。  これは、ASP.NET サイトなど、継続的に使用可能であることが必要なアプリケーションで特に役立ちます。  
+  
+> [!IMPORTANT]
+>  シャドウ コピーは、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリではサポートされていません。  
+  
+ 共通言語ランタイムは、アセンブリがアンロードされるまでファイルを更新できないように、アセンブリがロードされるときにアセンブリ ファイルをロックします。  アプリケーション ドメインからアセンブリをアンロードする唯一の方法は、アプリケーション ドメインをアンロードすることなので、通常の状況では、アセンブリを使用しているすべてのアプリケーション ドメインがアンロードされるまで、そのアセンブリをディスク上で更新することはできません。  
+  
+ ファイルをシャドウ コピーするようにアプリケーション ドメインが構成されると、アプリケーション パスからのアセンブリが別の場所にコピーされて、その場所から読み込まれます。  コピーはロックされますが、元のアセンブリ ファイルはロック解除されて、更新可能になります。  
+  
+> [!IMPORTANT]
+>  シャドウ コピーが可能な唯一のアセンブリは、アプリケーション ドメインの構成時に <xref:System.AppDomainSetup.ApplicationBase%2A> または <xref:System.AppDomainSetup.PrivateBinPath%2A> プロパティで指定された、アプリケーション ディレクトリやそのサブディレクトリに保存されているものです。  グローバル アセンブリ キャッシュに格納されているアセンブリは、シャドウ コピーされません。  
+  
+ この記事は、次のセクションで構成されています。  
+  
+-   「[シャドウ コピーの有効化と使用](#EnablingAndUsing)」では、シャドウ コピーの基本的な使用方法と使用可能なオプションについて説明します。  
+  
+-   「[起動時のパフォーマンス](#StartupPerformance)」では、起動時のパフォーマンスを改善するために [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] でシャドウ コピーに加えられた変更、および以前のバージョンの動作に戻す方法について説明します。  
+  
+-   「[廃止メソッド](#ObsoleteMethods)」では、[!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] でシャドウ コピーを制御するためにプロパティとメソッドに加えられた変更について説明します。  
+  
+<a name="EnablingAndUsing"></a>   
+## シャドウ コピーの有効化と使用  
+ <xref:System.AppDomainSetup> クラスのプロパティを以下のように使用して、シャドウ コピー用のアプリケーション ドメインを構成できます。  
+  
+-   <xref:System.AppDomainSetup.ShadowCopyFiles%2A> プロパティを文字列値に `"true"` に設定して、シャドウ コピーを有効にします。  
+  
+     既定では、この設定は、アプリケーション パス内のすべてのアセンブリを、それらが読み込まれる前にダウンロード キャッシュにコピーします。  これは、他のコンピューターからダウンロードしたファイルを格納するために共通言語ランタイムによって保守されるものと同じキャッシュで、不要になったときには、共通言語ランタイムが自動的にファイルを削除します。  
+  
+-   必要に応じて、<xref:System.AppDomainSetup.CachePath%2A> プロパティと <xref:System.AppDomainSetup.ApplicationName%2A> プロパティを使用して、シャドウ コピーしたファイルのカスタムの場所を設定します。  
+  
+     この場所の基本パスは、<xref:System.AppDomainSetup.ApplicationName%2A> プロパティに <xref:System.AppDomainSetup.CachePath%2A> プロパティをサブディレクトリとして連結することにより形成されます。  アセンブリは、基本パス自体ではなく、このパスのサブディレクトリにシャドウ コピーされます。  
+  
+    > [!NOTE]
+    >  <xref:System.AppDomainSetup.ApplicationName%2A> プロパティが設定されていない場合、<xref:System.AppDomainSetup.CachePath%2A> プロパティは無視されて、ダウンロード キャッシュが使用されます。  例外をスローすることはありません。  
+  
+     カスタムの場所を指定する場合は、不要になったときに、ディレクトリとコピー済みファイルをユーザーがクリーンアップする必要があります。  それらは自動的には削除されません。  
+  
+     シャドウ コピーされるファイル用にカスタムの場所を設定すると良いいくつかの理由があります。  アプリケーションが生成するコピーの数が多い場合は、シャドウ コピーされるファイル用にカスタムの場所を設定することができます。  ダウンロード キャッシュは有効期間ではなくサイズによって制限されるので、共通言語ランタイムが、まだ使用されているファイルを削除しようとする可能性があります。  カスタムの場所を設定するもう 1 つの状況は、アプリケーションを実行しているユーザーに、共通言語ランタイムがダウンロード キャッシュ用に使用するディレクトリの場所に対する書き込みアクセス権がない場合です。  
+  
+-   必要に応じて、<xref:System.AppDomainSetup.ShadowCopyDirectories%2A> プロパティを使用して、シャドウ コピーするアセンブリの数を制限します。  
+  
+     アプリケーション ドメインのシャドウ コピーを有効にすると、既定では、アプリケーション パス内の、つまり <xref:System.AppDomainSetup.ApplicationBase%2A> と <xref:System.AppDomainSetup.PrivateBinPath%2A> プロパティで指定されたディレクトリ内の、すべてのアセンブリがコピーされます。  シャドウ コピーするディレクトリのみを含む文字列を作成して、その文字列を <xref:System.AppDomainSetup.ShadowCopyDirectories%2A> プロパティに割り当てることにより、コピー操作を選択したディレクトリに制限できます。  ディレクトリをセミコロンで区切ります。  シャドウ コピーされるアセンブリは、選択したディレクトリ内のものだけです。  
+  
+    > [!NOTE]
+    >  文字列を <xref:System.AppDomainSetup.ShadowCopyDirectories%2A> プロパティに割り当てない場合、またはこのプロパティを `null` に設定した場合は、<xref:System.AppDomainSetup.ApplicationBase%2A> と <xref:System.AppDomainSetup.PrivateBinPath%2A> プロパティで指定したディレクトリ内のすべてのアセンブリがシャドウ コピーされます。  
+  
+    > [!IMPORTANT]
+    >  セミコロンは区切り文字なので、ディレクトリ パスにはセミコロンを含めないでください。  セミコロンのためのエスケープ文字はありません。  
+  
+<a name="StartupPerformance"></a>   
+## 起動時のパフォーマンス  
+ シャドウ コピーを使用するアプリケーション ドメインを開始するときには、アプリケーション ディレクトリ内のアセンブリをシャドウ コピー ディレクトリにコピーしたり、既にその場所にある場合には検証したりするので、遅延が生じます。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の前には、すべてのアセンブリを一時ディレクトリにコピーしていました。  各アセンブリを開いて、アセンブリ名を確認し、厳密な名前は検証しました。  各アセンブリを検査して、シャドウ コピーのディレクトリにあるコピーよりも最近に更新されていないかどうかを調べました。  更新されていた場合、それはシャドウ コピーのディレクトリにコピーしました。  最後に、一時コピーを破棄しました。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降は、起動時の既定の動作として、アプリケーション ディレクトリ内にある各アセンブリのファイルの日時を、シャドウ コピーのディレクトリ内にあるコピーのファイルの日時と直接比較します。  アセンブリが更新されている場合は、.NET Framework の以前のバージョンと同じ手順を使用してそれをコピーし、そうでない場合は、シャドウ コピーのディレクトリ内にあるコピーが読み込まれます。  
+  
+ 結果としてのパフォーマンスの改善は、アセンブリの変更頻度が小さく、通常はアセンブリの小さなサブセット内で変更が生じるようなアプリケーションで最大となります。  アプリケーション内のアセンブリの大部分が頻繁に変更される場合は、新しい既定動作によって、パフォーマンスが低下する可能性があります。  [\<shadowCopyVerifyByTimestamp\> element](../../../docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md) を構成ファイルに `enabled="false"` と共に追加することによって、.NET Framework の以前のバージョンの起動動作を復元できます。  
+  
+<a name="ObsoleteMethods"></a>   
+## 廃止メソッド  
+ <xref:System.AppDomain> クラスには、アプリケーション ドメインでシャドウ コピーを制御するために使用できる <xref:System.AppDomain.SetShadowCopyFiles%2A> や <xref:System.AppDomain.ClearShadowCopyPath%2A> などのいくつかのメソッドがありますが、これらは .NET Framework version 2.0 では廃止された機能としてマークされています。  シャドウ コピー用にアプリケーション ドメインを構成するには、<xref:System.AppDomainSetup> クラスのプロパティを使用することをお勧めします。  
+  
+## 参照  
+ <xref:System.AppDomainSetup.ShadowCopyFiles%2A?displayProperty=fullName>   
+ <xref:System.AppDomainSetup.CachePath%2A?displayProperty=fullName>   
+ <xref:System.AppDomainSetup.ApplicationName%2A?displayProperty=fullName>   
+ <xref:System.AppDomainSetup.ShadowCopyDirectories%2A?displayProperty=fullName>   
+ [\<shadowCopyVerifyByTimestamp\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/strong-named-assemblies.md b/docs/framework/app-domains/strong-named-assemblies.md
new file mode 100644
index 00000000000..8403caebfea
--- /dev/null
+++ b/docs/framework/app-domains/strong-named-assemblies.md
@@ -0,0 +1,54 @@
+---
+title: "厳密な名前付きアセンブリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 厳密な名前を付けた"
+  - "厳密な名前を付けたアセンブリ, 厳密な名前付きアセンブリの概要"
+ms.assetid: d4a80263-f3e0-4d81-9b61-f0cbeae3797b
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 厳密な名前付きアセンブリ
+アセンブリの厳格な名前付けにより、アセンブリに対して一意の ID を作成し、アセンブリの競合を防ぐことができます。  
+  
+## 厳格な名前付きのアセンブリを作成する方法  
+ 厳格な名前付きのアセンブリは、アセンブリと一緒に配布された公開キーに対応する秘密キーとアセンブリ自体を使用して生成されます。  アセンブリには、アセンブリ マニフェストが含まれます。ここには、アセンブリを構成するすべてのファイルの名前とハッシュが格納されています。  同じ厳格な名前を持つ複数のアセンブリは、同一である必要があります。  
+  
+ Visual Studio またはコマンド ライン ツールを使用して、アセンブリに厳格な名前を付けることができます。  詳細については、「[方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)」または「[Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)」を参照してください。  
+  
+ 厳格に名前付けされたアセンブリには、アセンブリの単純テキスト名、バージョン番号、カルチャ情報 \(省略可能\)、デジタル署名、および署名に使用する秘密キーに対応した公開キーが含まれています。  
+  
+> [!WARNING]
+>  セキュリティに関しては、厳格な名前に依存しないでください。  厳格な名前は、一意の ID を提供するだけです。  
+  
+## アセンブリに厳格な名前を付ける理由  
+ 厳密な名前付きのアセンブリを参照すると、バージョン管理や名前の一意性を保護できるなどの利点を期待できます。  厳密な名前付きのアセンブリは、一部のシナリオを有効にするために必要な、グローバル アセンブリ キャッシュにインストールできます。  
+  
+ 厳格な名前付きのアセンブリは次のシナリオで役立ちます。  
+  
+-   独自のアセンブリを厳密な名前付きのアセンブリが参照できるようにする場合、または他の厳密な名前付きのアセンブリから独自のアセンブリへの `friend` アクセスを可能にする場合。  
+  
+-   同じアセンブリのさまざまなバージョンにアプリがアクセスする必要がある場合。  これは、競合することなく同じアプリ ドメインで side\-by\-side の読み込みを実行するために、アセンブリのさまざまなバージョンが必要であることを意味します。  たとえば、同じ簡易名を持つアセンブリ内に API のさまざまな拡張子が存在する場合、厳格な名前付けはアセンブリの各バージョンに一意の ID を提供します。  
+  
+-   独自のアセンブリを使用するアプリのパフォーマンスに悪影響を及ぼさないように、アセンブリをドメインに中立にする場合。  ドメイン中立のアセンブリはグローバル アセンブリ キャッシュにインストールされている必要があるため、この場合は厳密な名前を付ける必要があります。  
+  
+-   発行者ポリシーを提供することにより、アプリへのサービスを集中管理する場合。これは、グローバル アセンブリ キャッシュにアセンブリがインストールされる必要があることを意味します。  
+  
+ オープン ソースの開発者が厳密な名前付きのアセンブリによる ID の利点を必要とする場合、アセンブリに関連付けられた秘密キーをソース コントロール システムにチェックインすることを検討してください。  
+  
+## 参照  
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)   
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/type-forwarding-in-the-common-language-runtime.md b/docs/framework/app-domains/type-forwarding-in-the-common-language-runtime.md
new file mode 100644
index 00000000000..37b480a929b
--- /dev/null
+++ b/docs/framework/app-domains/type-forwarding-in-the-common-language-runtime.md
@@ -0,0 +1,54 @@
+---
+title: "共通言語ランタイムでの型の転送 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework]、型の転送"
+  - "型の転送"
+ms.assetid: 51f8ffa3-c253-4201-a3d3-c4fad85ae097
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 共通言語ランタイムでの型の転送
+型の転送を使用すると、別のアセンブリに型を移動する際に、元のアセンブリを使用するアプリケーションを再コンパイルする必要がありません。  
+  
+ たとえば、`Utility.dll` というアセンブリ内の `Example` クラスをアプリケーションが使用しているとします。  `Utility.dll` の開発者がアセンブリをリファクタリングすることになり、その過程で `Example` クラスを別のアセンブリに移動します。  `Utility.dll` の前のバージョンが `Utility.dll` の新しいバージョンとそのコンパニオン アセンブリで置換されると、`Example` クラスを使用するアプリケーションは、新しいバージョンの `Utility.dll` で `Example` クラスを見つけられないために失敗します。  
+  
+ これを回避するために、`Utility.dll` の開発者は <xref:System.Runtime.CompilerServices.TypeForwardedToAttribute> 属性を使用して、`Example` クラスに対する要求を転送します。  この属性が新しいバージョンの `Utility.dll` に適用されている場合は、`Example` クラスに対する要求が現在このクラスを含んでいるアセンブリに転送されます。  既存のアプリケーションは、再コンパイルを必要とすることなく正常に機能し続けます。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では、Visual Basic で作成されたアセンブリから型を転送できません。  ただし、Visual Basic で作成されたアプリケーションでは、転送された型を使用できます。  つまり、アプリケーションが C\# または C\+\+ で作成されたアセンブリを使用している場合は、そのアセンブリの型が別のアセンブリに転送されても、Visual Basic アプリケーションは転送された型を使用できます。  
+  
+## 型の転送  
+ 型の転送は 4 つの手順で行います。  
+  
+1.  型のソース コードを、元のアセンブリから転送先のアセンブリに移動します。  
+  
+2.  型の元の場所であるアセンブリで、移動された型に対して <xref:System.Runtime.CompilerServices.TypeForwardedToAttribute> を追加します。  次のコードは、移動された `Example` という型の属性を示しています。  
+  
+    ```csharp  
+    [assembly:TypeForwardedToAttribute(typeof(Example))]  
+    ```  
+  
+    ```cpp#  
+    [assembly:TypeForwardedToAttribute(Example::typeid)]  
+    ```  
+  
+3.  型の現在の場所であるアセンブリをコンパイルします。  
+  
+4.  型の元の場所であるアセンブリを、型の現在の場所であるアセンブリへの参照を指定して再コンパイルします。  たとえば、C\# ファイルをコマンド ラインからコンパイルする場合は、[\/reference \(Import Metadata\)](../Topic/-reference%20\(C%23%20Compiler%20Options\).md) オプションを使用して型の現在の場所であるアセンブリを指定します。  C\+\+ では、ソース ファイルで [\#using](../Topic/%23using%20Directive%20\(C++\).md) ディレクティブを使用して、型の現在の場所であるアセンブリを指定します。  
+  
+## 参照  
+ <xref:System.Runtime.CompilerServices.TypeForwardedToAttribute>   
+ [Type Forwarding \(C\+\+\/CLI\)](../Topic/Type%20Forwarding%20\(C++-CLI\).md)   
+ [\#using ディレクティブ](../Topic/%23using%20Directive%20\(C++\).md)
\ No newline at end of file
diff --git a/docs/framework/app-domains/use-serviced-components-with-the-gac.md b/docs/framework/app-domains/use-serviced-components-with-the-gac.md
new file mode 100644
index 00000000000..542620ef8f7
--- /dev/null
+++ b/docs/framework/app-domains/use-serviced-components-with-the-gac.md
@@ -0,0 +1,37 @@
+---
+title: "サービス コンポーネントとグローバル アセンブリ キャッシュの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "GAC (グローバル アセンブリ キャッシュ), サービス コンポーネント"
+  - "グローバル アセンブリ キャッシュ, サービス コンポーネント"
+  - "サービス コンポーネント, グローバル アセンブリ キャッシュ"
+ms.assetid: 3423e5d9-234c-4571-8161-e35f6d130128
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# サービス コンポーネントとグローバル アセンブリ キャッシュの使用
+サービス コンポーネント \(マネージ コード COM\+ コンポーネント\) は、グローバル アセンブリ キャッシュに配置する必要があります。  共通言語ランタイムと COM\+ サービスがグローバル アセンブリ キャッシュ内にないサービス コンポーネントを処理できるシナリオと、処理できないシナリオとがあります。  それぞれのシナリオを次に示します。  
+  
+-   COM\+ サーバー アプリケーションのサービス コンポーネントの場合、コンポーネントを含むアセンブリは、グローバル アセンブリ キャッシュ内にある必要があります。これは、Dllhost.exe がサービス コンポーネントを格納するディレクトリと同じディレクトリで実行されないためです。  
+  
+-   COM\+ ライブラリ アプリケーションのサービス コンポーネントの場合、ランタイムと COM\+ サービスは、現在のディレクトリ内を検索することによって、コンポーネントを含むアセンブリへの参照を解決できます。  この場合、アセンブリはグローバル アセンブリ キャッシュ内になくてもかまいません。  
+  
+-   ASP.NET アプリケーションのサービス コンポーネントの場合、状況は異なります。  サービス コンポーネントを含むアセンブリをアプリケーション ベースの bin ディレクトリに配置してオンデマンド登録を使用する場合、アセンブリはダウンロード キャッシュにシャドウとしてコピーされます。これは、ASP.NET がランタイムのシャドウ機能を利用するためです。  
+  
+## 参照  
+ [How to: Create a Serviced Component](http://msdn.microsoft.com/ja-jp/7ec0b488-e5fc-46f2-a48d-1278ea4e301d)   
+ [アセンブリとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/working-with-assemblies-and-the-gac.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)   
+ [Assembly Cache Viewer \(Shfusion.dll\)](http://msdn.microsoft.com/ja-jp/0d9464cf-ddba-4ca9-bbec-f678fb58f380)
\ No newline at end of file
diff --git a/docs/framework/app-domains/use.md b/docs/framework/app-domains/use.md
new file mode 100644
index 00000000000..705e5ece0a7
--- /dev/null
+++ b/docs/framework/app-domains/use.md
@@ -0,0 +1,74 @@
+---
+title: "アプリケーション ドメインの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメイン、バージョン情報"
+  - "共通言語ランタイム、アプリケーション ドメイン"
+  - "ランタイム、アプリケーション ドメイン"
+ms.assetid: c6d99815-e022-4d2c-9420-1d7ab5b9d504
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# アプリケーション ドメインの使用
+アプリケーション ドメインは、共通言語ランタイムで使用する分離の単位です。  アプリケーション ドメインは、プロセスの内部で作成および実行します。  通常、アプリケーション ドメインはランタイム ホストによって作成されます。ランタイム ホストはアプリケーションの一種で、ランタイムをプロセスに読み込み、アプリケーション ドメイン内でユーザー コードを実行します。  ランタイム ホストは、プロセスと既定のアプリケーション ドメインを作成し、アプリケーション ドメイン内でマネージ コードを実行します。  ランタイム ホストには ASP.NET、Microsoft Internet Explorer、Windows シェルがあります。  
+  
+ ほとんどのアプリケーションでは、ランタイム ホストが必要なアプリケーション ドメインをすべて作成するため、独自のアプリケーション ドメインを作成する必要はありません。  ただし、アプリケーションでコードを分離する、または DLL を使用したりアンロードしたりする必要がある場合は、追加のアプリケーション ドメインを作成して構成できます。  
+  
+## このセクションの内容  
+ [方法 : アプリケーション ドメインを作成する](../../../docs/framework/app-domains/how-to-create-an-application-domain.md)  
+ アプリケーション ドメインをプログラムで作成する方法を説明します。  
+  
+ [方法 : アプリケーション ドメインをアンロードする](../../../docs/framework/app-domains/how-to-unload-an-application-domain.md)  
+ アプリケーション ドメインをプログラムでアンロードする方法を説明します。  
+  
+ [方法 : アプリケーション ドメインを構成する](../../../docs/framework/app-domains/how-to-configure-an-application-domain.md)  
+ アプリケーション ドメインの構成の概要を説明します。  
+  
+ [アプリケーション ドメインからのセットアップ情報の取得](../../../docs/framework/app-domains/retrieve-setup-information.md)  
+ アプリケーション ドメインからセットアップ情報を取得する方法を説明します。  
+  
+ [方法 : アプリケーション ドメインにアセンブリを読み込む](../../../docs/framework/app-domains/how-to-load-assemblies-into-an-application-domain.md)  
+ アプリケーション ドメインにアセンブリを読み込む方法を説明します。  
+  
+ [方法 : アセンブリから型およびメンバーの情報を取得する](../../../docs/framework/app-domains/how-to-obtain-type-and-member-information-from-an-assembly.md)  
+ アセンブリに関する情報を取得する方法を説明します。  
+  
+ [アセンブリのシャドウ コピー](../../../docs/framework/app-domains/shadow-copy-assemblies.md)  
+ シャドウ コピーによる使用中のアセンブリの更新、およびシャドウ コピーを設定する方法を説明します。  
+  
+ [方法: 初回例外通知を受け取る](../../../docs/framework/app-domains/how-to-receive-first-chance-exception-notifications.md)  
+ 共通言語ランタイムが例外ハンドラーの検索を開始する前に、例外がスローされたことを知らせる通知を受け取る方法について説明します。  
+  
+ [アセンブリ読み込みの解決](../../../docs/framework/app-domains/resolve-assembly-loads.md)  
+ <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを使用してアセンブリの読み込みの失敗を解決する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.AppDomain>  
+ アプリケーション ドメインを表します。  アプリケーション ドメインを作成および制御するためのメソッドを提供します。  
+  
+## 関連項目  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)  
+ アセンブリの機能について概要を説明します。  
+  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)  
+ アセンブリを作成し、署名し、その属性を設定する方法を説明します。  
+  
+ [動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)  
+ 動的アセンブリの作成方法を説明します。  
+  
+ [アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)  
+ アプリケーション ドメインの概念的な概要を説明します。  
+  
+ [リフレクションの概要](../../../docs/framework/reflection-and-codedom/reflection.md)  
+ **Reflection** クラスを使って、アセンブリに関する情報を取得する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/app-domains/working-with-assemblies-and-the-gac.md b/docs/framework/app-domains/working-with-assemblies-and-the-gac.md
new file mode 100644
index 00000000000..72108f18ac2
--- /dev/null
+++ b/docs/framework/app-domains/working-with-assemblies-and-the-gac.md
@@ -0,0 +1,80 @@
+---
+title: "アセンブリとグローバル アセンブリ キャッシュの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アクセス制御リスト [.NET Framework]"
+  - "ACL [.NET Framework]"
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "GAC (グローバル アセンブリ キャッシュ), 利点"
+  - "グローバル アセンブリ キャッシュ, 利点"
+ms.assetid: 8a18e5c2-d41d-49ef-abcb-7c27e2469433
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# アセンブリとグローバル アセンブリ キャッシュの使用
+あるアセンブリを複数のアプリケーションで共有する場合は、そのアセンブリをグローバル アセンブリ キャッシュ内にインストールできます。  共通言語ランタイムをインストールしている各コンピューターは、このコードをコンピューター全体で使用できます。  グローバル アセンブリ キャッシュは、そのコンピューター上の複数のアプリケーションで共有するように指定されたアセンブリを格納します。  グローバル アセンブリ キャッシュ内にインストールされるアセンブリは、厳密な名前を持つ必要があります。  
+  
+> [!NOTE]
+>  グローバル アセンブリ キャッシュ内に配置されるアセンブリは、アセンブリ名とファイル名の拡張子を除く部分が一致している必要があります。  たとえば、アセンブリ名が myAssembly のアセンブリの場合、ファイル名は myAssembly.exe または myAssembly.dll である必要があります。  
+  
+ アセンブリの共有が必要な場合にだけ、アセンブリをグローバル アセンブリ キャッシュにインストールします。  一般的には、明らかにアセンブリを共有する必要がある場合を除いて、アセンブリの依存関係はプライベートにし、アセンブリはアプリケーション ディレクトリに配置します。  また、COM 相互運用 \(機能\) またはアンマネージ コードからアセンブリにアクセスできるようにするために、アセンブリをグローバル アセンブリ キャッシュにインストールする必要はありません。  
+  
+ アセンブリをグローバル アセンブリ キャッシュにインストールする理由は、いくつか考えられます。  
+  
+-   共有の場所。  
+  
+     複数のアプリケーションで使用するアセンブリは、グローバル アセンブリ キャッシュに配置できます。  たとえば、すべてのアプリケーションがグローバル アセンブリ キャッシュ内の 1 つのアセンブリを使用する場合は、アセンブリへの参照をリダイレクトするバージョン ポリシー ステートメントを Machine.config ファイルに追加できます。  
+  
+-   ファイル セキュリティ。  
+  
+     通常、管理者は、書き込みおよび実行アクセスを制御するアクセス制御リスト \(ACL: Access Control List\) を使用して systemroot ディレクトリを保護します。  グローバル アセンブリ キャッシュは、systemroot ディレクトリにインストールされるため、このディレクトリの ACL を継承します。  グローバル アセンブリ キャッシュからファイルを削除する場合は、管理者権限を持つユーザーに対してだけ許可することをお勧めします。  
+  
+-   side\-by\-side でのバージョン管理。  
+  
+     名前は同じでもバージョン情報が異なるアセンブリの複数のコピーを、グローバル アセンブリ キャッシュ内で管理できます。  
+  
+-   追加の検索場所。  
+  
+     共通言語ランタイムは、構成ファイル内のコードベース情報をプローブまたは使用する前に、グローバル アセンブリ キャッシュ内にアセンブリ要求と一致するアセンブリがあるかどうかをチェックします。  
+  
+ アセンブリのグローバル アセンブリ キャッシュへのインストールを明示的に避けたい場合もあります。  アプリケーションを構成するアセンブリの 1 つをグローバル アセンブリ キャッシュに配置した場合は、アプリケーション ディレクトリをコピーする XCOPY を使用してアプリケーションをレプリケートしたりインストールしたりすることはできなくなります。  この場合は、グローバル アセンブリ キャッシュ内のアセンブリも移動する必要があります。  
+  
+## このセクションの内容  
+ [方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする](../../../docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md)  
+ アセンブリをグローバル アセンブリ キャッシュにインストールする方法について説明します。  
+  
+ [方法 : グローバル アセンブリ キャッシュの内容を表示する](../../../docs/framework/app-domains/how-to-view-the-contents-of-the-gac.md)  
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用して、グローバル アセンブリ キャッシュの内容を表示する方法について説明します。  
+  
+ [方法 : グローバル アセンブリ キャッシュからアセンブリを削除する](../../../docs/framework/app-domains/how-to-remove-an-assembly-from-the-gac.md)  
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用して、グローバル アセンブリ キャッシュからアセンブリを削除する方法について説明します。  
+  
+ [サービス コンポーネントとグローバル アセンブリ キャッシュの使用](../../../docs/framework/app-domains/use-serviced-components-with-the-gac.md)  
+ サービス コンポーネント \(マネージ COM\+ コンポーネント\) をグローバル アセンブリ キャッシュに配置する必要がある理由について説明します。  
+  
+## 関連項目  
+ [アセンブリの作成](../../../docs/framework/app-domains/create-assemblies.md)  
+ アセンブリの作成の概要を説明します。  
+  
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)  
+ グローバル アセンブリ キャッシュについて説明します。  
+  
+ [方法 : アセンブリの内容を表示する](../../../docs/framework/app-domains/how-to-view-assembly-contents.md)  
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用して、アセンブリ内の MSIL \(Microsoft Intermediate Language\) 情報を表示する方法について説明します。  
+  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)  
+ 共通言語ランタイムが、アプリケーションを構成するアセンブリを検出して読み込む方法について説明します。  
+  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)  
+ マネージ アプリケーションを構成するブロックであるアセンブリについて説明します。
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/TOC.md b/docs/framework/common-client-technologies/TOC.md
new file mode 100644
index 00000000000..ec693a3403f
--- /dev/null
+++ b/docs/framework/common-client-technologies/TOC.md
@@ -0,0 +1,13 @@
+# [クライアント アプリケーション サービスの概要](client-application-services-overview.md)
+# [Full Code Listings](full-code-listings.md)
+# [Creating the GamePieceCollection Class](creating-the-gamepiececollection-class.md)
+# [Manipulations and Inertia Overview](manipulations-and-inertia-overview.md)
+# [チュートリアル : クライアント アプリケーション サービスの使用](walkthrough-using-client-application-services.md)
+# [Using Manipulations and Inertia in an XNA Application](use-manipulations-and-inertia-in-an-xna-application.md)
+# [共通クライアント技術](index.md)
+# [方法: クライアント アプリケーション サービスでユーザーのログインを実装する](how-to-implement-user-login-with-client-application-services.md)
+# [Creating the Game1 Class](creating-the-game1-class.md)
+# [Creating the GamePiece Class](creating-the-gamepiece-class.md)
+# [Manipulations and Inertia](manipulations-and-inertia.md)
+# [方法 : クライアント アプリケーション サービスを構成する](how-to-configure-client-application-services.md)
+# [クライアント アプリケーション サービス](client-application-services.md)
diff --git a/docs/framework/common-client-technologies/client-application-services-overview.md b/docs/framework/common-client-technologies/client-application-services-overview.md
new file mode 100644
index 00000000000..3d30e3c479d
--- /dev/null
+++ b/docs/framework/common-client-technologies/client-application-services-overview.md
@@ -0,0 +1,99 @@
+---
+title: "クライアント アプリケーション サービスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント アプリケーション サービス, クライアント アプリケーション サービスの概要"
+  - "クライアント アプリケーション サービス, クラス"
+ms.assetid: f0a2da13-e282-4fd7-88a1-f9102c9aeab1
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# クライアント アプリケーション サービスの概要
+クライアント アプリケーション サービスにより、Windows フォーム アプリケーションおよび Windows Presentation Foundation \(WPF\) アプリケーションから [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] ログイン サービス、ロール サービス、プロファイル サービスに簡単にアクセスできます。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスは、[!INCLUDE[vs_orcas_long](../../../includes/vs-orcas-long-md.md)] と [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] に付属くしている Microsoft ASP.NET 2.0 AJAX Extensions に含まれています。  これらのサービスにより、複数の Web ベースおよび Windows ベースのアプリケーションで、単一のサーバーから提供されるユーザー情報とユーザー管理機能を共有できます。  
+  
+ クライアント アプリケーション サービスには、Web サービス機能拡張モデルに組み込まれるクライアント サービス プロバイダーが含まれており、これにより、Windows ベースのアプリケーションで次のことが可能になります。  
+  
+-   シンプルなクライアント構成。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト デザイナーを使用するか、プロジェクトの App.config ファイルでクライアント サービス プロバイダーを指定することにより、ログイン サービス、ロール サービス、およびプロファイル サービスを有効化して構成することができます。  詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  
+  
+-   簡明なプログラミング。  クライアント アプリケーション サービスを有効にして構成すると、既存の [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] のメンバーシップ クラス、ロール クラス、およびアプリケーション設定クラスから間接的にサービス プロバイダーにアクセスできるようになります。  クライアント アプリケーション サービスを実装する [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] クラスに直接アクセスすることもできます。  しかし、ほとんどの場合、直接アクセスは不要です。クライアント アプリケーション サービスのクラスの詳細については、このトピックの「クライアント アプリケーション サービスのクラス」を参照してください。  
+  
+-   オフラインのサポート。  Windows ベースのアプリケーションは、多くの場合、接続頻度の低い環境下に置かれます。  アプリケーションがオンラインのときに、クライアント サービス プロバイダーは、サーバーから取得された値をオフライン時にも使用できるようにキャッシュします。  
+  
+-   [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] アプリケーション設定デザイナーとの統合。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でプロジェクトに設定を追加するときに、クライアント設定サービス プロバイダーを介してアクセスされる設定を指定できます。  
+  
+ 以下のセクションでは、これらの機能について詳しく説明します。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスの詳細については、「[ASP.NET Application Services Overview](../Topic/ASP.NET%20Application%20Services%20Overview.md)」を参照してください。  
+  
+## 認証  
+ クライアント アプリケーション サービスを使用して、既存の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] 認証サービスを介してユーザーを検証できます。  Windows 認証またはフォーム認証を使用してユーザーを認証できます。  Windows 認証では、ユーザーがコンピューターまたはドメインにログオンしたときにオペレーティング システムによって付与されたユーザー ID が使用されます。  通常、社内イントラネット上に配置されているアプリケーションにはWindows 認証を使用します。  フォーム認証では、アプリケーションにログイン コントロールを組み込み、取得した資格情報を認証プロバイダーに渡します。  通常、インターネット上に配置されたアプリケーションにはフォーム認証を使用します。  
+  
+ ユーザーを検証するには、`static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを呼び出します。  このメソッドは、アプリケーションで構成されているクライアント サービス プロバイダーにアクセスし、ユーザーが有効であるかどうかを示す <xref:System.Boolean> 値を返します。  詳細については、「[方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md)」を参照して下さい。  
+  
+ Windows 認証を使用している場合は、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドのパラメーターとして空の文字列または `null` を渡す必要があります。  Windows 認証を使用している場合、このメソッドを呼び出すと常に `true` が返されます。  
+  
+ フォーム認証では、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドは、リモート サービスがユーザーを認証したかどうかを示す値を返します。  検証が成功すると、認証クッキーがローカル ハード ディスクに格納されます。  ロール サービスおよび設定サービスにアクセスする際、このクッキーが検証の確認に使用されます。  
+  
+ フォーム認証を使用している場合は、ユーザー名とパスワードを <xref:System.Web.Security.Membership.ValidateUser%2A> メソッドに渡すことができます。  また、パラメーターとして空の文字列または `null` を渡して、資格情報プロバイダーを使用することもできます。  資格情報プロバイダーは、アプリケーション構成で指定するクラスです。  資格情報プロバイダー クラスは、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装する必要があります。このインターフェイスには、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> という単一のメソッドがあります。  資格情報プロバイダーを使用することにより、複数のアプリケーション間で同じログイン ダイアログ ボックスを共有できます。  詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  
+  
+ フォーム認証で資格情報プロバイダーを使用するようにアプリケーションを構成する際には、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドのパラメーターとして空の文字列または `null` を渡す必要があります。  サービス プロバイダーは <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A?displayProperty=fullName> メソッド実装を呼び出します。  通常、このメソッドを実装してダイアログ ボックスを表示し、データが設定された <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials> オブジェクトを返します。  
+  
+ 認証の詳細については、「[ASP.NET Authentication](../Topic/ASP.NET%20Authentication.md)」を参照してください。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] 認証サービスの設定方法の詳細については、「[Using Forms Authentication with Microsoft Ajax](../Topic/Using%20Forms%20Authentication%20with%20Microsoft%20Ajax.md)」を参照してください。  
+  
+## ロール  
+ クライアント アプリケーション サービスを使用して、既存の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] ロール サービスからロール情報を取得できます。  現在の認証済みユーザーが特定のロールに属すかどうかを判断するには、`static` <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティから取得された <xref:System.Security.Principal.IPrincipal> 参照の <xref:System.Security.Principal.IPrincipal.IsInRole%2A> メソッドを呼び出します。  <xref:System.Security.Principal.IPrincipal.IsInRole%2A> メソッドは、パラメーターとしてロール名を受け取り、現在のユーザーが特定のロールにあるかどうかを示す <xref:System.Boolean> 値を返します。  ユーザーが認証されない場合、または指定されたロールに属していない場合、このメソッドは `false` を返します。  
+  
+ [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] ロール サービスの設定方法の詳細については、「[Using Roles Information with Microsoft Ajax](../Topic/Using%20Roles%20Information%20with%20Microsoft%20Ajax.md)」を参照してください。  
+  
+## 設定  
+ クライアント アプリケーション サービスを使用して、既存の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] プロファイル サービスからユーザー アプリケーション設定を取得できます。  クライアント アプリケーション サービスの Web 設定機能は、[!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] のアプリケーション設定機能と統合されています。Web 設定を取得するには、まず、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト デザイナーの **\[設定\]** タブを使用して、プロジェクトの `Settings` クラス \(C\# では `Properties.Settings.Default`、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `My.Settings` としてアクセスされる\) を生成します。  **\[設定\]** タブの**\[Web 設定の読み込み\]** ボタンをクリックしてWeb 設定を読み込み、これを生成された `Settings` クラスに追加することができます。  すべての認証済みユーザーまたはすべての匿名ユーザーによって使用されるように構成された Web 設定を使用できます。  
+  
+ アプリケーション設定の詳細については、「[アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)」を参照してください。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で設定クラスを生成するのではなく独自の設定クラスを実装する方法の詳細については、「[方法 : アプリケーション設定を作成する](../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)」を参照してください。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] プロファイル サービスの設定方法の詳細については、「[Using Profile Information with Microsoft Ajax](../Topic/Using%20Profile%20Information%20with%20Microsoft%20Ajax.md)」を参照してください。  
+  
+## クライアント アプリケーション サービスのクラス  
+ 次の表は、クライアント アプリケーション サービス機能を実装するクラスの説明です。  
+  
+ 認証、ロール、および設定の主要な機能のみを使用するアプリケーションであれば、これらのクラスに直接アクセスする必要はありません。  このようなアプリケーションは、前のセクションで説明したアプリケーション構成や API を使用して間接的にクライアント アプリケーション サービス プロバイダーにアクセスします。  ユーザーのログアウト機能やオフライン機能などの追加機能を実装する場合は、これらのクラスに直接アクセスする必要があります。  
+  
+> [!NOTE]
+>  すべてのクライアント アプリケーション サービスの API は同期的です。  クライアント アプリケーション サービスは、非同期動作を直接にはサポートしていません。  
+  
+ クライアント アプリケーション サービス プロバイダーは、標準 [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] 型を実装または拡張しますが、これらの型で定義されるメンバーと機能をすべて実装するわけではありません。  たとえば、クライアント アプリケーション サービス プロバイダーを使用して、新しいユーザーの作成や、ロール メンバーシップを管理するユーザー管理アプリケーションを実装することはできません。  この機能を実装するには、現在のところ Web アプリケーションとサーバー側のコードを使用する必要があります。  実装されてないメンバーを確認するには、この表に示されているリンクから、リファレンス ドキュメントを参照してください。  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.Web.ClientServices.ClientFormsIdentity>|このクラスは、フォーム認証のユーザー ID と認証クッキーを管理します。<br /><br /> このクラスに直接アクセスする主な理由は、ユーザーを自動的に再検証する <xref:System.Web.ClientServices.ClientFormsIdentity.RevalidateUser%2A> メソッドを呼び出すためです。たとえば、オフライン モードからオンライン モードに切り替える場合などが該当します。<br /><br /> フォーム認証を使用してユーザーが認証された後、`static` <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティを介して取得される <xref:System.Security.Principal.IPrincipal> 参照の <xref:System.Security.Principal.IPrincipal.Identity%2A> プロパティを使用してこのクラスのインスタンスを取得できます。|  
+|<xref:System.Web.ClientServices.ClientRolePrincipal>|このクラスは、ユーザー ロールを管理します。<br /><br /> このクラスには、間接的にアクセスできないメンバーはありません。  ただし、ユーザーが認証された後は、`static` <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティを使用してこのクラスのインスタンスにアクセスできます。|  
+|<xref:System.Web.ClientServices.ConnectivityStatus>|このクラスは、アプリケーションをオフライン モードに切り替える際に使用する `static` <xref:System.Web.ClientServices.ConnectivityStatus.IsOffline%2A> プロパティを提供します。|  
+|<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials>|このクラスはユーザー資格情報を表します。<br /><br /> このクラスは、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装する際、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> メソッドの戻り値の型としてのみ使用します。|  
+|<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider>|このクラスは、フォーム認証のリモート認証サービスへのアクセスを管理します。<br /><br /> このクラスに直接アクセスする主な理由は、<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.Logout%2A> メンバーと <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.UserValidated> メンバーを使用するためです。これらのメンバーは、基本 <xref:System.Web.Security.MembershipProvider> クラスでは実装されません。  また、<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.ServiceUri%2A> プロパティを使用して、サービスの場所をプログラムによって設定することもできます。<br /><br /> このクラスのインスタンスは、`static` <xref:System.Web.Security.Membership.Provider%2A?displayProperty=fullName> プロパティを使用して取得できます。|  
+|<xref:System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider>|このクラスは Windows 認証を管理します。<br /><br /> このクラスに直接アクセスする主な理由は、<xref:System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider.Logout%2A> メソッドを呼び出すためです。  ログアウト後、ユーザーは Windows に対しては認証されていますが、リモート アプリケーション サービスにはアクセスできなくなります。<br /><br /> このクラスのインスタンスは、`static` <xref:System.Web.Security.Membership.Provider%2A?displayProperty=fullName> プロパティを使用して取得できます。|  
+|<xref:System.Web.ClientServices.Providers.ClientRoleProvider>|このクラスは、リモート ロール サービスへのアクセスを管理します。<br /><br /> このクラスにアクセスする主な理由は、<xref:System.Web.ClientServices.Providers.ClientRoleProvider.ResetCache%2A> メソッドを呼び出すためです。  これは、アプリケーションがゼロ以外のロール サービス キャッシュのタイムアウト値を使用するように構成されている場合に便利です。  詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  また、<xref:System.Web.ClientServices.Providers.ClientRoleProvider.ServiceUri%2A> プロパティを使用して、サービスの場所をプログラムによって設定することもできます。<br /><br /> このクラスのインスタンスは、`static` <xref:System.Web.Security.Roles.Provider%2A?displayProperty=fullName> プロパティを使用して取得できます。|  
+|<xref:System.Web.ClientServices.Providers.ClientSettingsProvider>|このクラスは、リモート Web 設定サービスへのアクセスを管理します。<br /><br /> このクラスにアクセスする主な理由は、<xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved> イベントを処理するためです。  また、<xref:System.Web.ClientServices.Providers.ClientSettingsProvider.ServiceUri%2A> プロパティを使用して、サービスの場所をプログラムによって設定することもできます。|  
+|<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider>|このインターフェイスは、このトピックの「認証」セクションで先述されているように、アプリケーションが検証時にユーザーの資格情報を取得するための間接的な手段を提供します。  詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。|  
+|<xref:System.Web.ClientServices.Providers.SettingsSavedEventArgs>|このクラスは、<xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved?displayProperty=fullName> イベント ハンドラー内で使用する <xref:System.Web.ClientServices.Providers.SettingsSavedEventArgs.FailedSettingsList%2A> プロパティを提供します。|  
+|<xref:System.Web.ClientServices.Providers.UserValidatedEventArgs>|このクラスは、<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.UserValidated> イベント ハンドラー内で使用する <xref:System.Web.ClientServices.Providers.UserValidatedEventArgs.UserName%2A> プロパティを提供します。|  
+  
+## 参照  
+ [クライアント アプリケーション サービス](../../../docs/framework/common-client-technologies/client-application-services.md)   
+ [方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)   
+ [方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md)   
+ [チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)   
+ [OLD NIB: Managing Application Settings](http://msdn.microsoft.com/ja-jp/7de3c3bd-e0dc-4e75-a1aa-7b0ecfaac4fc)   
+ [アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [ASP.NET Application Services Overview](../Topic/ASP.NET%20Application%20Services%20Overview.md)   
+ [Using Forms Authentication with Microsoft Ajax](../Topic/Using%20Forms%20Authentication%20with%20Microsoft%20Ajax.md)   
+ [Using Roles Information with Microsoft Ajax](../Topic/Using%20Roles%20Information%20with%20Microsoft%20Ajax.md)   
+ [Using Profile Information with Microsoft Ajax](../Topic/Using%20Profile%20Information%20with%20Microsoft%20Ajax.md)   
+ [ASP.NET Authentication](../Topic/ASP.NET%20Authentication.md)   
+ [Managing Authorization Using Roles](../Topic/Managing%20Authorization%20Using%20Roles.md)   
+ [Creating and Configuring the Application Services Database for SQL Server](../Topic/Creating%20and%20Configuring%20the%20Application%20Services%20Database%20for%20SQL%20Server.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/client-application-services.md b/docs/framework/common-client-technologies/client-application-services.md
new file mode 100644
index 00000000000..8b873dc57a8
--- /dev/null
+++ b/docs/framework/common-client-technologies/client-application-services.md
@@ -0,0 +1,81 @@
+---
+title: "クライアント アプリケーション サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション設定, クライアント アプリケーション サービス"
+  - "ASP.NET サービス, クライアント アプリケーション サービス"
+  - "認証 [ASP.NET], クライアント アプリケーション サービス"
+  - "クライアント アプリケーション サービス"
+  - "クライアント アプリケーション サービス, クライアント アプリケーション サービスの概要"
+  - "クライアント アプリケーション, ASP.NET サービス"
+  - "資格情報 [.NET Framework]"
+  - "ログイン [クライアント アプリケーション サービス]"
+  - "プロファイル [ASP.NET], クライアント アプリケーション サービス"
+  - "ロール ベースのセキュリティ [.NET Framework], クライアント アプリケーション サービス"
+  - "ロール [.NET Framework], クライアント アプリケーション サービス"
+  - "共有 (情報と機能を) [クライアント アプリケーション サービス]"
+  - "Web 設定 [クライアント アプリケーション サービス]"
+  - "Windows ベースのアプリケーション, クライアント アプリケーション サービス"
+ms.assetid: 1487d8df-089e-4f21-abfb-a791a652b58e
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# クライアント アプリケーション サービス
+クライアント アプリケーション サービスにより、Microsoft ASP.NET 2.0 AJAX Extensions に含まれる [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] のログイン、ロール、およびアプリケーション サービスを使用する Windows ベースのアプリケーションを簡単に作成できます。  これらのサービスにより、複数の Web アプリケーションおよび Windows ベースのアプリケーションで、単一のサーバーから提供されるユーザー情報とユーザー管理機能を共有できます。  たとえば、これらのサービスを使用して、次のタスクを実行できます。  
+  
+-   ユーザーを認証します。  認証サービスを使用して、ユーザー ID を検証することができます。  
+  
+-   認証されたユーザーのロールを確認します。  ロール サービスを使用して、ユーザーのロールに応じてアプリケーションのユーザー インターフェイスを変更できます。  たとえば、管理者ロールのユーザーには機能を追加して提供することができます。  
+  
+-   サーバー上に存在する、ユーザーごとのアプリケーションの設定を保存してアクセスします。  Web 設定サービス \(プロファイル サービスとも呼ばれます\) を使用して、複数のアプリケーションや場所で設定を共有することができます。  
+  
+ クライアント アプリケーション サービスは、アプリケーション構成ファイルで指定できるクライアントのサービス プロバイダーの Web サービス拡張モデルを活用します。  これらのサービス プロバイダーには、ネットワーク接続が利用できない場合、認証、ロール、および設定のデータのローカル キャッシュを使用するオフライン機能が含まれます。  
+  
+ [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスの詳細については、「[ASP.NET Application Services Overview](../Topic/ASP.NET%20Application%20Services%20Overview.md)」を参照してください。  
+  
+## このセクションの内容  
+ [クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)  
+ クライアント アプリケーション サービス プロバイダーを介して使用できる機能について説明します。  
+  
+ [方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)  
+ このトピックでは、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト デザイナーを使用して、アプリケーション サービスを有効にし、構成する方法について説明します。  対応する App.config ファイルへの変更についても説明します。  
+  
+ [方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md)  
+ アプリケーションがクライアントの認証サービス プロバイダーを使用するよう構成される場合のユーザー検証方法について説明します。  
+  
+ [チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)  
+ すべてのクライアント アプリケーション サービスの機能を1 つのアプリケーションに結合する方法について説明します。  このチュートリアルでは、エンド ツー エンドのガイダンスを示します。  たとえば、クライアント アプリケーション サービスのテストに使用できる ASP.NET Web サービス アプリケーションを作成する方法の手順が含まれます。  
+  
+## 関連項目  
+ <xref:System.Web.ClientServices.ClientFormsIdentity>  
+ <xref:System.Web.ClientServices.ClientRolePrincipal>  
+ <xref:System.Web.ClientServices.ConnectivityStatus>  
+ <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials>  
+ <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider>  
+ <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider>  
+ <xref:System.Web.ClientServices.Providers.ClientWindowsAuthenticationMembershipProvider>  
+ <xref:System.Web.ClientServices.Providers.ClientRoleProvider>  
+ <xref:System.Web.ClientServices.Providers.ClientSettingsProvider>  
+ <xref:System.Web.ClientServices.Providers.SettingsSavedEventArgs>  
+ <xref:System.Web.ClientServices.Providers.UserValidatedEventArgs>  
+  
+## 参照  
+ [ASP.NET Application Services Overview](../Topic/ASP.NET%20Application%20Services%20Overview.md)   
+ [Using Forms Authentication with Microsoft Ajax](../Topic/Using%20Forms%20Authentication%20with%20Microsoft%20Ajax.md)   
+ [Using Roles Information with Microsoft Ajax](../Topic/Using%20Roles%20Information%20with%20Microsoft%20Ajax.md)   
+ [Using Profile Information with Microsoft Ajax](../Topic/Using%20Profile%20Information%20with%20Microsoft%20Ajax.md)   
+ [ASP.NET Authentication](../Topic/ASP.NET%20Authentication.md)   
+ [Managing Authorization Using Roles](../Topic/Managing%20Authorization%20Using%20Roles.md)   
+ [OLD NIB: Managing Application Settings](http://msdn.microsoft.com/ja-jp/7de3c3bd-e0dc-4e75-a1aa-7b0ecfaac4fc)   
+ [アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/creating-the-game1-class.md b/docs/framework/common-client-technologies/creating-the-game1-class.md
new file mode 100644
index 00000000000..0efd5d190a8
--- /dev/null
+++ b/docs/framework/common-client-technologies/creating-the-game1-class.md
@@ -0,0 +1,48 @@
+---
+title: "Creating the Game1 Class | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 47932ce3-2ba5-476f-a26b-3ddfd5226f27
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Creating the Game1 Class
+すべての Microsoft XNA プロジェクトと同様、Game1 クラスは  [Microsoft.Xna.Framework.Game](http://msdn.microsoft.com/library/microsoft.xna.framework.game.aspx) クラスから派生しています。このクラスでは、XNA ゲーム用に、基本的なグラフィックス デバイスの初期化、ゲーム ロジックの提供、およびコードの表示を行います。  ほとんどの作業は GamePiece クラスと GamePieceCollection クラスで実行されるため、Game1 クラスは非常に簡潔になっています。  
+  
+## コードの作成  
+ クラスのプライベート メンバーは、ゲーム ピースを保持する **GamePieceCollection** オブジェクト、 [GraphicsDeviceManager](http://msdn.microsoft.com/library/microsoft.xna.framework.graphicsdevicemanager.aspx) オブジェクト、およびゲーム ピースの表示に使用する [SpriteBatch](http://msdn.microsoft.com/library/microsoft.xna.framework.graphics.spritebatch.aspx) オブジェクトで構成されています。  
+  
+ [!code-csharp[ManipulationXNA#_Game1_PrivateMembers](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1_privatemembers)]  
+  
+ ゲームの初期化中にこれらのオブジェクトはインスタンス化されます。  
+  
+ [!code-csharp[ManipulationXNA#_Game1_ConstructorInitialize](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1_constructorinitialize)]  
+  
+ [LoadContent](http://msdn.microsoft.com/library/microsoft.xna.framework.game.loadcontent.aspx) メソッドが呼び出されると、ゲーム ピースが作成されて、 **GamePieceCollection** オブジェクトに割り当てられます。  ゲーム ピースには、次の 2 種類があります。  ピースのスケール ファクターは、小さいピースや大きいピースが存在するようにわずかに変更されます。  
+  
+ [!code-csharp[ManipulationXNA#_Game1_LoadContent](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1_loadcontent)]  
+  
+ [Update](http://msdn.microsoft.com/library/microsoft.xna.framework.game.update.aspx) メソッドは、ゲームの実行中に XNA Framework によって繰り返し呼び出されます。  [Update](http://msdn.microsoft.com/library/microsoft.xna.framework.game.update.aspx) メソッドは、ゲーム ピースのコレクションに対して  **ProcessInertia** メソッドおよび **UpdateFromMouse** メソッドを呼び出します。  これらのメソッドの説明は、「[Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)」にあります。  
+  
+ [!code-csharp[ManipulationXNA#_Game1_UpdateGame](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1_updategame)]  
+  
+ [Draw](http://msdn.microsoft.com/library/microsoft.xna.framework.game.draw.aspx) メソッドも、ゲームの実行中に XNA Framework によって繰り返し呼び出されます。  [Draw](http://msdn.microsoft.com/library/microsoft.xna.framework.game.draw.aspx) メソッドは、**GamePieceCollection** オブジェクトの **Draw** メソッドを呼び出して、ゲーム ピースのレンダリングを実行します。  これらのメソッドの説明は、「[Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)」にあります。  
+  
+ [!code-csharp[ManipulationXNA#_Game1_DrawGame](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1_drawgame)]  
+  
+## 参照  
+ [Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md)   
+ [Using Manipulations and Inertia in an XNA Application](../../../docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md)   
+ [Creating the GamePiece Class](../../../docs/framework/common-client-technologies/creating-the-gamepiece-class.md)   
+ [Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)   
+ [Full Code Listings](../../../docs/framework/common-client-technologies/full-code-listings.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/creating-the-gamepiece-class.md b/docs/framework/common-client-technologies/creating-the-gamepiece-class.md
new file mode 100644
index 00000000000..4c75457337f
--- /dev/null
+++ b/docs/framework/common-client-technologies/creating-the-gamepiece-class.md
@@ -0,0 +1,111 @@
+---
+title: "Creating the GamePiece Class | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37a27a86-ac1c-47be-b477-cb4b819459d3
+caps.latest.revision: 9
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Creating the GamePiece Class
+**GamePiece** クラスは、Microsoft XNA ゲーム ピースのイメージの読み込み、ゲーム ピースに関係するマウスの状態の追跡、マウスのキャプチャ、操作と慣性の処理の実行、およびゲーム ピースがビュー ポートの限度に達したときの跳ね返り機能の提供に必要な機能をすべてカプセル化します。  
+  
+## プライベート メンバー  
+ **GamePiece** クラスの上部で、いくつかのプライベート メンバーが宣言されます。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_PrivateMembers](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_privatemembers)]  
+  
+## パブリック プロパティ  
+ これらの 3 つのプライベート メンバーは、パブリック プロパティを介して公開されます。  **Scale** と **PieceColor** プロパティを使用すると、アプリケーションはピースのサイズと色をそれぞれ指定することができます。  **Bounds** プロパティを公開すると、あるピースが別のピースを重ねて配置する場合など、あるピース自体を表示するために別のピースの境界を使用できるようになります。  次のコードは、パブリック プロパティの宣言を示します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_PublicProperties](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_publicproperties)]  
+  
+## クラスのコンストラクター  
+ **GamePiece** クラスのコンストラクターは、次のパラメーターを受け入れます。  
+  
+-   [SpriteBatch](http://msdn.microsoft.com/library/microsoft.xna.framework.graphics.spritebatch.aspx) 型。  ここで渡される参照は、プライベート メンバー `spriteBatch` に割り当てられ、ゲーム ピースが自身を表示するときに [SpriteBatch.Draw](http://msdn.microsoft.com/library/microsoft.xna.framework.graphics.spritebatch.draw.aspx) メソッドにアクセスするために使用されます。  さらに、[GraphicsDevice](http://msdn.microsoft.com/library/microsoft.xna.framework.graphics.spritebatch.graphicsdevice.aspx) プロパティを使用すると、ゲーム ピースに関連する [Texture](http://msdn.microsoft.com/library/microsoft.xna.framework.graphics.texture.aspx) オブジェクトを作成するとともに、いつゲーム ピースがウィンドウの境界に接したかを検出するために、ビュー ポートのサイズを取得できます。そうすることで、ピースは跳ね返ることができます。  
+  
+-   ゲーム ピースに使用するイメージのファイル名を指定する文字列。  
+  
+ また、コンストラクターは、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D> オブジェクトと <xref:System.Windows.Input.Manipulations.InertiaProcessor2D> オブジェクトを作成し、それらのイベントのイベント ハンドラーを確立します。  
+  
+ 次のコードは、**GamePiece** クラスのコンストラクターを示します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_Constructor](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_constructor)]  
+  
+## マウスの入力のキャプチャ  
+ **UpdateFromMouse** メソッドは、マウスがゲーム ピースの境界内にある間にマウス ボタンが押されたときに検出するとともに、マウス ボタンが離されたときに検出する役割を務めます。  
+  
+ \(マウスがピースの境界内にある間に\) マウスの左ボタンを押すと、このメソッドはフラグを設定して、ゲーム ピースがマウスをキャプチャして、操作の処理を開始することを示します。  
+  
+ 操作の処理は、<xref:System.Windows.Input.Manipulations.Manipulator2D> オブジェクトの配列を作成し、それを <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D> オブジェクトに渡して開始します。  これにより、操作プロセッサがマニピュレーター \(この場合は 1 つのマニピュレーター\) を評価し、操作イベントを発生させます。  
+  
+ さらに、ドラッグが発生するポイントが保存されます。  これは後の <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Delta> イベントのときに、ゲーム ピースがドラッグ ポイントの背後の線に向かって移動するようにデルタ変換値を調整するために使用します。  
+  
+ 最後に、このメソッドは、マウスのキャプチャの状態を返します。  これにより、[GamePieceCollection](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md) オブジェクトは、複数のゲーム ピースがある場合にキャプチャを管理できるようになります。  
+  
+ 次のコードは、**UpdateFromMouse** メソッドを示しています。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_UpdateFromMouse](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_updatefrommouse)]  
+  
+## 操作の処理  
+ 操作の開始時に、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Started> イベントが発生します。  このイベントのハンドラーは、慣性の処理が発生している場合は停止し、*processInertia* フラグを `false` に設定します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_OnManipulationStarted](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_onmanipulationstarted)]  
+  
+ 操作に関連している値が変化するため、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Delta> イベントが発生します。  このイベントのハンドラーは、ゲーム ピースの位置と回転の値を変更するイベント引数に渡されるデルタ値を使用します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_OnManipulationDelta](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_onmanipulationdelta)]  
+  
+ 操作に関連するすべてのマニピュレーター \(この場合は 1 つのマニピュレーター\) が削除されると、操作プロセッサは <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Completed> イベントを生成します。  このイベントのハンドラーは、慣性プロセッサの初期速度をイベント引数によって報告された初期速度に設定して慣性の処理を開始するとともに、*processInertia* フラグを `true` に設定します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_OnManipulationCompleted](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_onmanipulationcompleted)]  
+  
+## 慣性の処理  
+ 慣性の処理では、角速度と直線速度、位置 \(変換\) 座標、および回転の新しい値を推定します。<xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Delta> イベントが発生します。  このイベントのハンドラーは、ゲーム ピースの位置と回転を変更するイベント引数に渡されるデルタ値を使用します。  
+  
+ 新しい座標によって、ゲーム ピースがビュー ポートの境界を越えてしまった場合、慣性の処理の速度が元に戻ります。  これにより、ゲーム ピースが接したビュー ポートの境界から跳ね返ります。  
+  
+ 推定が実行している間は、<xref:System.Windows.Input.Manipulations.InertiaProcessor2D> オブジェクトのプロパティを変更できません。  そのため、X または Y の速度を元に戻す場合、イベント ハンドラーは、最初に <xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Complete%2A> メソッドを呼び出して慣性を停止します。  続いて、新しい初期速度値を、\(スポンジ動作向けに調整された\) 現在の速度値に割り当てます。また、*processInertia* フラグを `true` に設定します。  
+  
+ 次のコードは、<xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Delta> イベントのイベント ハンドラーを示しています。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_OnInertiaDelta](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_oninertiadelta)]  
+  
+ 慣性の処理が完了すると、慣性プロセッサは <xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Completed> イベントを発生させます。  このイベントのハンドラーは、*processInertia* フラグを `false` に設定します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_OnInertiaCompleted](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_oninertiacompleted)]  
+  
+ これまでに提示したロジックで、実際に慣性の推定が発生するものはありません。  これは、**ProcessInertia** メソッドで実現されます。  このメソッドは、ゲームの更新ループ \([Game.Update](http://msdn.microsoft.com/library/microsoft.xna.framework.game.update.aspx) メソッド\) から繰り返し呼び出され、*processInertia* フラグが `true` に設定されていることを確認します。設定されている場合は <xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Process%2A> メソッドを呼び出します。  このメソッドを呼び出すと、推定が発生して、<xref:System.Windows.Input.Manipulations.InertiaProcessor2D.Delta> イベントが発生します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_ProcessInertia](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_processinertia)]  
+  
+ いずれかの描画メソッドのオーバーロードが呼び出されるまで、ゲーム ピースは実際に表示されません。  このメソッドの最初のオーバーロードは、ゲームの描画ループ \([Game.Draw](http://msdn.microsoft.com/library/microsoft.xna.framework.game.draw.aspx) メソッド\) から繰り返し呼び出されます。  これにより、現在の位置、回転、およびスケール ファクターでゲーム ピースが表示されます。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_Draw](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_draw)]  
+  
+## その他のプロパティ  
+ **GamePiece** クラスによって 3 つのプライベート プロパティが使用されます。  
+  
+1.  **Timestamp** – 操作と慣性プロセッサが使用するタイムスタンプ値を取得します。  
+  
+2.  **X** – ゲーム ピースの X 座標を取得または設定します。  設定すると、ヒット テストや、操作プロセッサのピボット位置に使用する境界を調整します。  
+  
+3.  **Y** – ゲーム ピースの Y 座標を取得または設定します。  設定すると、ヒット テストや、操作プロセッサのピボット位置に使用する境界を調整します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePiece_PrivateProperties](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiece_privateproperties)]  
+  
+## 参照  
+ [Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md)   
+ [Using Manipulations and Inertia in an XNA Application](../../../docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md)   
+ [Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)   
+ [Creating the Game1 Class](../../../docs/framework/common-client-technologies/creating-the-game1-class.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md b/docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md
new file mode 100644
index 00000000000..d8eb676b19c
--- /dev/null
+++ b/docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md
@@ -0,0 +1,42 @@
+---
+title: "Creating the GamePieceCollection Class | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4b037ee-1201-4a55-b198-0d6532ed6f35
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Creating the GamePieceCollection Class
+**GamePieceCollection** クラスは、汎用の List クラスから派生し、複数の **GamePiece** オブジェクトをより簡単に管理するメソッドを導入します。  
+  
+## コードの作成  
+ **GamePieceCollection** クラスのコンストラクターは、プライベート メンバー *capturedIndex* を初期化します。  このフィールドは、現在どのゲーム ピースにマウス キャプチャがあるかを追跡するために使用します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePieceCollection_PrivateMembersAndConstructor](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiececollection.cs#_gamepiececollection_privatemembersandconstructor)]  
+  
+ **ProcessInertia** メソッドと **Draw** メソッドは、ゲームの [Game.Update](http://msdn.microsoft.com/library/microsoft.xna.framework.game.update.aspx) メソッドと [Game.Draw](http://msdn.microsoft.com/library/microsoft.xna.framework.game.draw.aspx) メソッドに必要なコードを簡略化します。これは、コレクション内のゲーム ピースをすべて列挙してから、各 **GamePiece** オブジェクトにそれぞれのメソッドを呼び出して行います。  
+  
+ [!code-csharp[ManipulationXNA#_GamePieceCollection_ProcessInertiaAndDraw](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiececollection.cs#_gamepiececollection_processinertiaanddraw)]  
+  
+ **UpdateFromMouse** メソッドもゲームの更新中に呼び出されます。  最初に現在のキャプチャ \(もしあれば\) が有効なままであるかどうかを確認すると、1 つのゲーム ピースのみがマウス キャプチャするようになります。  有効の場合、他のピースはキャプチャの確認ができません。  
+  
+ キャプチャがあるピースがない場合、 **UpdateFromMouse** メソッドから最後から最初へとゲーム ピースを列挙し、対象のピースがマウス キャプチャを報告するかどうかを確認します。  報告する場合、対象のピースは現在キャプチャされているピースになり、後続の処理は実行されません。  **UpdateFromMouse** メソッドは、先にコレクションの最後の項目を確認します。そうすることで、2 つのピースが重なっている場合、Z オーダーが高いピースがキャプチャを取得します。  Z オーダーは明示的ではなく、変更もできません。Z オーダーは、ゲーム ピースがコレクションに追加された順序で管理されます。  
+  
+ [!code-csharp[ManipulationXNA#_GamePieceCollection_UpdateFromMouse](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiececollection.cs#_gamepiececollection_updatefrommouse)]  
+  
+## 参照  
+ [Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md)   
+ [Using Manipulations and Inertia in an XNA Application](../../../docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md)   
+ [Creating the GamePiece Class](../../../docs/framework/common-client-technologies/creating-the-gamepiece-class.md)   
+ [Creating the Game1 Class](../../../docs/framework/common-client-technologies/creating-the-game1-class.md)   
+ [Full Code Listings](../../../docs/framework/common-client-technologies/full-code-listings.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/full-code-listings.md b/docs/framework/common-client-technologies/full-code-listings.md
new file mode 100644
index 00000000000..878294b43f4
--- /dev/null
+++ b/docs/framework/common-client-technologies/full-code-listings.md
@@ -0,0 +1,42 @@
+---
+title: "Full Code Listings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4edbe7f-8503-42cb-a8a1-4f49c78e5e00
+caps.latest.revision: 6
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Full Code Listings
+このトピックでは、[Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md) プロセッサを使用するアプリケーションの完全なコードの一覧を示します。  
+  
+## GamePiece クラス  
+ 完全な **GamePiece** クラスを次のコードに示します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePieceClass](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiece.cs#_gamepiececlass)]  
+  
+## GamePieceCollection クラス  
+ 完全な **GamePieceCollection** クラスを次のコードに示します。  
+  
+ [!code-csharp[ManipulationXNA#_GamePieceCollectionClass](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/gamepiececollection.cs#_gamepiececollectionclass)]  
+  
+## Game1 クラス  
+ 完全な **Game1** クラスを次のコードに示します。  
+  
+ [!code-csharp[ManipulationXNA#_Game1Class](../../../samples/snippets/csharp/VS_Snippets_Misc/manipulationxna/cs/game1.cs#_game1class)]  
+  
+## 参照  
+ [Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md)   
+ [Using Manipulations and Inertia in an XNA Application](../../../docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md)   
+ [Creating the GamePiece Class](../../../docs/framework/common-client-technologies/creating-the-gamepiece-class.md)   
+ [Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)   
+ [Creating the Game1 Class](../../../docs/framework/common-client-technologies/creating-the-game1-class.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/how-to-configure-client-application-services.md b/docs/framework/common-client-technologies/how-to-configure-client-application-services.md
new file mode 100644
index 00000000000..f77c4e337b1
--- /dev/null
+++ b/docs/framework/common-client-technologies/how-to-configure-client-application-services.md
@@ -0,0 +1,160 @@
+---
+title: "方法 : クライアント アプリケーション サービスを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント アプリケーション サービス, 構成"
+ms.assetid: 34a8688a-a32c-40d3-94be-c8e610c6a4e8
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : クライアント アプリケーション サービスを構成する
+このトピックでは、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] **プロジェクト デザイナー**を使用して、クライアント アプリケーション サービスを有効にし、構成する方法について説明します。  クライアント アプリケーション サービスを使用してユーザーを検証し、既存の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスからユーザーのロールおよび設定を取得することができます。  構成した後に、「[クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)」に記載されているように、アプリケーション コード内で有効にされているサービスにアクセスできます。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] アプリケーション サービスの詳細については、「[ASP.NET Application Services Overview](../Topic/ASP.NET%20Application%20Services%20Overview.md)」を参照してください。  
+  
+ クライアント アプリケーション サービスは、**プロジェクト デザイナー**の **\[サービス\]** ページで有効にし、構成することができます。  **\[サービス\]** ページは、プロジェクトの App.config ファイル内の値を更新します。  **プロジェクト デザイナー**にアクセスするには、**\[プロジェクト\]** メニューの **\[プロパティ\]** を使用します。  **\[サービス\]** ページの詳細については、「[\[サービス\] ページ \(プロジェクト デザイナー\)](../Topic/Services%20Page,%20Project%20Designer.md)」を参照してください。  
+  
+ 次の手順では、クライアント アプリケーション サービスの基本構成を実行する方法について説明します。  高度な構成オプションについては、以降のセクションで説明します。  
+  
+### クライアント アプリケーション サービスを構成するには  
+  
+1.  **ソリューション エクスプ ローラー**で、プロジェクト ノードを選択し、**\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+     **プロジェクト デザイナー**が表示されます。  
+  
+2.  **\[サービス\]** タブをクリックします。  次の図に示すように、**\[サービス\]** ページが表示されます。  
+  
+     ![プロジェクト デザイナーの &#91;サービス&#93; タブ](../../../docs/framework/common-client-technologies/media/casdesigner.png "casdesigner")  
+  
+3.  **\[サービス\]** ページで、**\[クライアント アプリケーション サービスを有効にする\]** を選択します。  
+  
+    > [!NOTE]
+    >  クライアント アプリケーション サービスには完全版の .NET Framework が必要です。クライアント アプリケーション サービスは、.NET Framework Client Profile ではサポートされません。  **\[クライアント アプリケーション サービスを有効にする\]** チェック ボックスが無効になっている場合、**\[ターゲット フレームワーク\]** が .NET Framework 3.5 以降に設定されていることを確認します。  C\# で **\[ターゲット フレームワーク\]** の設定を表示するには、プロジェクト デザイナーを開き、**\[アプリケーション\]** ページをクリックします。  Visual Basic で **\[ターゲット フレームワーク\]** の設定を表示するには、プロジェクト デザイナーを開き、**\[コンパイル\]** ページをクリックして、**\[詳細コンパイル オプション\]** をクリックします。  
+  
+4.  独自のログイン コントロールまたはダイアログ ボックスを提供する場合は **\[フォーム認証を使用する\]** を選択し、オペレーティング システムによって付与された ID を使用する場合は **\[Windows 認証を使用する\]** を選択します。  詳細については、「[クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  **\[Windows 認証を使用する\]** を選択すると、SQL Server Compact データベースを使用するために、クライアント アプリケーション サービスが自動的に構成されます。  これは次のセクションで説明するように、**\[サービスの詳細設定\]** ダイアログ ボックスに示されます。  **\[フォーム認証を使用する\]** を選択すると、**\[カスタム接続文字列を使用する\]** の設定は自動的にオフになりません。  これにより、[!INCLUDE[ssEW](../../../includes/ssew-md.md)] データベースが Windows 認証で使用するために既に生成されている場合、エラーが発生することがあります。  これらのエラーを修正するには、**\[サービスの詳細設定\]** ダイアログ ボックスの **\[カスタム接続文字列を使用する\]** の設定をオフにします。  
+  
+5.  **\[フォーム認証を使用する\]** を選択した場合は、**\[認証サービスの場所\]** ボックスで、ファイル名を含まないサービス ホストの URL を指定します。  デザイナーは、構成ファイルに値を書き込むときに、自動的に標準のファイル名 \(Authentication\_JSON\_AppService.axd\) を追加します。  
+  
+6.  必要に応じて、**\[フォーム認証を使用する\]** を選択した場合は、**\[資格情報プロバイダー\]** ボックスに値を指定することができます。  資格情報プロバイダーは、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装する必要があります。  資格情報プロバイダーを使用すると、他のアプリケーション コードからログイン ユーザー インターフェイスを分離できます。  これにより、複数のアプリケーションで使用する単一のログイン ダイアログ ボックスを作成することができます。  詳細については、「[方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md)」を参照して下さい。  
+  
+     資格情報プロバイダーを指定する場合は、アセンブリ修飾型名としてを指定する必要があります。  詳細については、「<xref:System.Type.AssemblyQualifiedName%2A?displayProperty=fullName>」および「[アセンブリ名](../../../docs/framework/app-domains/assembly-names.md)」を参照してください。  最も単純な形式で、アセンブリ修飾型名は、次のようになります。  
+  
+    ```  
+    MyNamespace.MyLoginClass, MyAssembly  
+    ```  
+  
+7.  **\[ロール サービスの場所\]** および **\[Web 設定サービスの場所\]** テキスト ボックスで、ファイル名を含まない、各サービスのサービスの場所を指定します。  デザイナーは、構成ファイルに値を書き込むときに、自動的に標準的なファイル名 \(Role\_JSON\_AppService.axd および Profile\_JSON\_AppService.axd\) を追加します。  
+  
+8.  必要に応じて、**\[詳細設定\]** をクリックして、ローカル キャッシュ動作などの詳細設定を変更します。  詳細については、次の手順を参照してください。  
+  
+## 詳細構成  
+ 次の手順では、あまり一般的ではないシナリオでクライアント アプリケーション サービスを構成する方法について説明します。  たとえば、これらの構成オプションは、公共の場所で使用したり、ローカル データ キャッシュとして暗号化された SQL Server Compact データベースを使用するために使用したりできます。  
+  
+#### クライアント アプリケーション サービスの詳細設定を構成するには  
+  
+1.  **プロジェクト デザイナー**の **\[サービス\]** ページで、**\[詳細設定\]** をクリックします。  
+  
+     次の図に示すように、**\[サービスの詳細設定\]** ダイアログ ボックスが表示されます。  このダイアログ ボックスの詳細については、「[\[サービスの詳細設定\] ダイアログ ボックス](../Topic/Advanced%20Settings%20for%20Services%20Dialog%20Box.md)」を参照してください。  
+  
+     ![&#91;サービスの詳細設定&#93; ダイアログ ボックス](../../../docs/framework/common-client-technologies/media/casdialog.png "casdialog")  
+  
+2.  **\[オフラインでログインできるようにパスワードのハッシュをローカルに保存する\]** をオンまたはオフにします。  このオプションを選択すると、ユーザーのパスワードの暗号化された形式がローカルでキャッシュされます。  これは、アプリケーションにオフライン モードを実装する場合に便利です。  このオプションを選択すると、<xref:System.Web.ClientServices.ConnectivityStatus.IsOffline%2A> プロパティが `true` に設定されている場合でもユーザーを検証できます。  
+  
+3.  **\[サーバー Cookie の期限が切れた場合は常に再度ログオンすることをユーザーに要求する\]** をオンまたはオフにします。  認証 Cookie はリモート サービスで構成され、ユーザーのログインがアクティブであり続ける期間を示します。  cookie を構成する方法の詳細については、「[authentication の forms 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/8163b8b5-ea6c-46c8-b5a9-c4c3de31c0b3)」の「`timeout` 属性」を参照してください。  
+  
+     このオプションを選択した場合、認証 Cookie の有効期限が切れた後にリモート ロールまたは Web 設定サービスにアクセスしようとすると、<xref:System.Net.WebException> がスローされます。  この例外を処理し、ログイン ダイアログ ボックスを表示して、ユーザーを再検証することができます。  この動作の例は、「[チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)」を参照してください。  このオプションは、公共の場所に配置されたアプリケーションで、使用後にアプリケーションを実行中のままにしているユーザーが無期限に認証されないようにするのに便利です。  
+  
+     このオプションをオフにし、認証 Cookie の有効期限が切れた後にリモート サービスへのアクセスを試行すると、ユーザーが自動的に再検証されます。  
+  
+4.  **\[ロール サービスのキャッシュのタイムアウト\]** の値を指定します。  この時間間隔は、ロールが頻繁に更新される場合は小さい値に設定し、ロールが頻繁に更新されない場合はより大きい値に設定します。  オフライン モードを実装する場合は、時間間隔を大きい値に設定して、ロール情報が、アプリケーションがオフラインのときに期限切れにならないようにします。  
+  
+     <xref:System.Web.Security.RolePrincipal.IsInRole%2A> メソッドを呼び出すと、ロール プロバイダーがキャッシュされたロール値またはロール サービスにアクセスします。  プログラムによってキャッシュをリセットし、強制的にこのメソッドがリモート サービスにアクセスするようにするには、<xref:System.Web.ClientServices.Providers.ClientRoleProvider.ResetCache%2A> メソッドを呼び出します。  
+  
+5.  **\[カスタム接続文字列を使用する\]** をオンまたはオフにします。  詳細については、次の手順を参照してください。  
+  
+#### ローカル キャッシュ用データベースを使用するようにクライアント アプリケーション サービスを構成するには  
+  
+1.  **プロジェクト デザイナー**の **\[サービス\]** ページで、**\[詳細設定\]** をクリックします。  
+  
+     **\[サービスの詳細設定\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[カスタム接続文字列を使用する\]** を選択します。  
+  
+     テキスト ボックスに `Data Source = |SQL/CE|` の既定値が表示されます。  
+  
+3.  SQL Server Compact データベースを生成し、使用するには、接続文字列の既定値を保持します。[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] は、データベース ファイルを生成し、<xref:System.Windows.Forms.Application.UserAppDataPath%2A?displayProperty=fullName> プロパティで示されたディレクトリに配置します。  
+  
+4.  暗号化された [!INCLUDE[ssEW](../../../includes/ssew-md.md)] データベースを生成し、使用するには、次の例に示すように、接続文字列に `password` および `encrypt database` 値を追加します。  
+  
+    > [!NOTE]
+    >  必ず、強力なパスワードを指定してください。  データベースが生成された後は、パスワードを変更することはできません。  
+  
+    ```  
+    Data Source = |SQL/CE|;password=<password>;encrypt database=true  
+    ```  
+  
+5.  独自の [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] データベースを使用するには、独自の接続文字列を指定します。  有効な接続文字列の形式の詳細については、[!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] のドキュメントを参照してください。  このデータベースは自動的には生成されません。  接続文字列は、次の SQL ステートメントを使用して作成できる既存のデータベースを参照する必要があります。  
+  
+    ```  
+    CREATE TABLE ApplicationProperties (PropertyName nvarchar(256),  
+        PropertyValue nvarchar(256))  
+    CREATE TABLE UserProperties (PropertyName nvarchar(256),  
+        PropertyValue nvarchar(256))  
+    CREATE TABLE Roles (UserName nvarchar(256),   
+        RoleName nvarchar(256))  
+    CREATE TABLE Settings (PropertyName nvarchar(256),   
+        PropertyStoredAs nvarchar(1), PropertyValue nvarchar(2048))  
+    ```  
+  
+## カスタム プロバイダーの使用  
+ 既定では、クライアント アプリケーション サービスの機能は、<xref:System.Web.ClientServices.Providers?displayProperty=fullName> 名前空間のプロバイダーを使用します。  **プロジェクト デザイナー**の **\[サービス\]** ページを使用してアプリケーションを構成すると、これらのプロバイダーへの参照が App.config ファイルに追加されます。  これらの既定のプロバイダーは、サーバー上の対応するプロバイダーにアクセスします。  Web サービスは、多くの場合、<xref:System.Web.Security.SqlMembershipProvider> や <xref:System.Web.Security.SqlRoleProvider> などのプロバイダーからユーザー データにアクセスするように構成されます。  
+  
+ カスタム サービス プロバイダーを使用する場合は、通常、サーバーにアクセスするすべてのクライアント アプリケーションに影響を与えるようにサーバー側のプロバイダーを変更します。  ただし、クライアント側で既定以外のプロバイダーを使用することもできます。  次の手順に示すように、プロジェクトの App.config ファイルでカスタム認証またはロール プロバイダーを指定できます。  カスタム認証とロール プロバイダーを作成する方法については、「[Implementing a Membership Provider](../Topic/Implementing%20a%20Membership%20Provider.md)」と「[Implementing a Role Provider](../Topic/Implementing%20a%20Role%20Provider.md)」を参照してください。  また、カスタム設定プロバイダーを使用するには、プロジェクトの `Settings` クラス \(C\# では `Properties.Settings.Default` として、`My.Settings` では [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] としてアクセス\) を変更します。  詳細については、「[アプリケーション設定アーキテクチャ](../../../docs/framework/winforms/advanced/application-settings-architecture.md)」を参照してください。  
+  
+#### 既定以外のプロバイダーを使用するようにクライアント アプリケーション サービスを構成するには  
+  
+1.  既定以外の認証またはロール サービス プロバイダーを使用するには、最初に、**\[サービス\]** ページを使用して、他のすべての構成設定を完了します。  
+  
+2.  **プロジェクト デザイナー**を閉じます。  これは、**\[サービス\]** ページが、設定を変更しない場合でも自動的に App.config ファイルを更新するため、必要となります。  この手順で説明するように、App.config ファイルを手動で変更し、**\[サービス\]** ページに戻ると、変更内容はリセットされます。  
+  
+3.  **ソリューション エクスプローラー**で、App.config をダブルクリックします。  
+  
+     アプリケーションの構成ファイルがテキスト エディターで開きます。  
+  
+4.  `<providers>` または `<membership>` 要素内の `<roleManager>` 要素を見つけます。  これらの要素は `<system.web>` 要素の子要素です。  `<membership>` 要素を使用して認証プロバイダーを指定し、`<roleManager>` 要素を使用してロール プロバイダーを指定します。  
+  
+5.  `<add>` 要素の子要素として `<providers>` 要素を追加します。  次の例に示すように、`name` および `type` 属性を指定する必要があります。  `type` 属性値はアセンブリ修飾型の名前である必要があります。  詳細については、「<xref:System.Type.AssemblyQualifiedName%2A?displayProperty=fullName>」および「[アセンブリ名](../../../docs/framework/app-domains/assembly-names.md)」を参照してください。  
+  
+    ```  
+    <add name="MyCustomRoleProvider" type="MyNamespace.MyRoleProvider, MyAssembly" />  
+    ```  
+  
+6.  `defaultProvider` または `<membership>` 要素の `<roleManager>` 属性を変更して、前の手順で追加した `<add>` 要素から名前の値を指定します。  
+  
+    ```  
+    <roleManager enabled="true" defaultProvider="MyCustomRoleProvider">  
+    ```  
+  
+## 参照  
+ [クライアント アプリケーション サービス](../../../docs/framework/common-client-technologies/client-application-services.md)   
+ [クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)   
+ [\[サービス\] ページ \(プロジェクト デザイナー\)](../Topic/Services%20Page,%20Project%20Designer.md)   
+ [\[サービスの詳細設定\] ダイアログ ボックス](../Topic/Advanced%20Settings%20for%20Services%20Dialog%20Box.md)   
+ [方法: クライアント アプリケーション サービスでユーザーのログインを実装する](../../../docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md)   
+ [チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)   
+ [Implementing a Membership Provider](../Topic/Implementing%20a%20Membership%20Provider.md)   
+ [Implementing a Role Provider](../Topic/Implementing%20a%20Role%20Provider.md)   
+ [アプリケーション設定アーキテクチャ](../../../docs/framework/winforms/advanced/application-settings-architecture.md)   
+ [Creating and Configuring the Application Services Database for SQL Server](../Topic/Creating%20and%20Configuring%20the%20Application%20Services%20Database%20for%20SQL%20Server.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md b/docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md
new file mode 100644
index 00000000000..7b9008f4be5
--- /dev/null
+++ b/docs/framework/common-client-technologies/how-to-implement-user-login-with-client-application-services.md
@@ -0,0 +1,66 @@
+---
+title: "方法: クライアント アプリケーション サービスでユーザーのログインを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント アプリケーション サービス, ユーザーの認証"
+  - "検証 (ユーザーを) [クライアント アプリケーション サービス]"
+  - "検証 [.NET Framework], クライアント アプリケーション サービス"
+ms.assetid: 5431a671-eb02-4e18-a651-24764fccec9a
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法: クライアント アプリケーション サービスでユーザーのログインを実装する
+クライアント アプリケーション サービスを使用して、既存の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] プロファイル サービスを介してユーザーを検証できます。  [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] プロファイル サービスをセットアップする方法については、「[Using Forms Authentication with Microsoft Ajax](../Topic/Using%20Forms%20Authentication%20with%20Microsoft%20Ajax.md)」を参照してください。  
+  
+ 次の手順では、アプリケーションがクライアント認証サービス プロバイダーの 1 つを使用するように構成されている場合に、認証サービスを介してユーザーを検証する方法について説明します。  詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  
+  
+ 通常、検証はすべて `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを介して実行します。  このメソッドは、認証サービスとの対話を構成済み認証プロバイダーを介して管理します。  詳細については、「[クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)」を参照してください。  
+  
+ フォーム認証手順では、実行中の [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] 認証サービスへのアクセスが必要です。  クライアント アプリケーション サービス機能のエンド ツー エンド テストに関するガイダンスについては、「[チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)」を参照してください。  
+  
+### メンバーシップ資格情報プロバイダーを使用して、フォーム認証でユーザーを認証するには  
+  
+1.  <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装します。  <xref:System.Windows.Forms.Form?displayProperty=fullName> から派生したログイン ダイアログ ボックス クラスに対する <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A?displayProperty=fullName> の実装コード例を次に示します。  このダイアログ ボックスには、ユーザー名とパスワードのテキスト ボックス、および "次回のために保存" チェック ボックスが含まれています。  クライアント認証プロバイダーが <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> メソッドを呼び出すと、フォームが表示されます。  ユーザーがログイン ダイアログ ボックスに情報を入力し \[OK\] をクリックすると、指定された値が新しい <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials> オブジェクトに返されます。  
+  
+     [!code-csharp[ClientApplicationServices#210](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Login.cs#210)]
+     [!code-vb[ClientApplicationServices#210](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Login.vb#210)]  
+  
+2.  `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを呼び出し、空の文字列をパラメーター値として渡します。  空の文字列を指定すると、このメソッドはアプリケーション用に構成された資格情報プロバイダーに対して <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> メソッドを内部的に呼び出します。  次のコード例では、このメソッドを呼び出して、Windows フォーム アプリケーション全体へのアクセスを制限しています。  このコードを <xref:System.Windows.Forms.Form.Load?displayProperty=fullName> ハンドラーに追加できます。  
+  
+     [!code-csharp[ClientApplicationServices#317](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Class1.cs#317)]
+     [!code-vb[ClientApplicationServices#317](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#317)]  
+  
+### メンバーシップ資格情報プロバイダーを使用せずに、フォーム認証でユーザーを認証するには  
+  
+-   `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを呼び出し、ユーザーから取得したユーザー名とパスワードの値を渡します。  
+  
+     [!code-csharp[ClientApplicationServices#318](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Class1.cs#318)]
+     [!code-vb[ClientApplicationServices#318](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#318)]  
+  
+### Windows 認証でユーザーを認証するには  
+  
+-   `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを呼び出し、空の文字列をパラメーターに渡します。  このメソッド呼び出しでは常に `true` が返され、Windows ID が含まれるユーザーのクッキー キャッシュにクッキーが追加されます。  
+  
+     [!code-csharp[ClientApplicationServices#319](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Class1.cs#319)]
+     [!code-vb[ClientApplicationServices#319](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#319)]  
+  
+## 信頼性の高いプログラミング  
+ このトピックのコード例は、Windows クライアント アプリケーションでの認証の最も単純な使用方法を示しています。  ただし、クライアント アプリケーション サービス、およびフォーム認証で `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドを呼び出すと、<xref:System.Net.WebException> がスローされる場合があります。  これは、認証サービスが使用できないことを示します。  この例外を処理する方法の例は、「[チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)」を参照してください。  
+  
+## 参照  
+ [クライアント アプリケーション サービス](../../../docs/framework/common-client-technologies/client-application-services.md)   
+ [クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)   
+ [方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)   
+ [チュートリアル : クライアント アプリケーション サービスの使用](../../../docs/framework/common-client-technologies/walkthrough-using-client-application-services.md)   
+ [Using Forms Authentication with Microsoft Ajax](../Topic/Using%20Forms%20Authentication%20with%20Microsoft%20Ajax.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/index.md b/docs/framework/common-client-technologies/index.md
new file mode 100644
index 00000000000..59e5479afde
--- /dev/null
+++ b/docs/framework/common-client-technologies/index.md
@@ -0,0 +1,27 @@
+---
+title: ".NET Framework の共通クライアント技術 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 733fc580-337e-4b7c-9756-b70798c18bc3
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# .NET Framework の共通クライアント技術
+このセクションでは、クライアント アプリケーションで使用できるさまざまな技術について説明します。  
+  
+## このセクションの内容  
+ [Manipulations and Inertia](../../../docs/framework/common-client-technologies/manipulations-and-inertia.md)  
+ Microsoft Windows Presentation Foundation \(WPF\) や Microsoft XNA などのさまざまな UI フレームワークで操作と慣性のプロセッサ クラスを使用する方法について説明します。  
+  
+ [クライアント アプリケーション サービス](../../../docs/framework/common-client-technologies/client-application-services.md)  
+ Windows ベースのアプリケーションで Microsoft ASP.NET 2.0 AJAX Extensions に含まれる [!INCLUDE[ajax_current_short](../../../includes/ajax-current-short-md.md)] のログイン、ロール、およびプロファイル アプリケーション サービスを使用する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/manipulations-and-inertia-overview.md b/docs/framework/common-client-technologies/manipulations-and-inertia-overview.md
new file mode 100644
index 00000000000..ee566ef2eca
--- /dev/null
+++ b/docs/framework/common-client-technologies/manipulations-and-inertia-overview.md
@@ -0,0 +1,82 @@
+---
+title: "Manipulations and Inertia Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dd31b89b-eab6-45a1-8d0b-11e0eb84b234
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Manipulations and Inertia Overview
+*操作* では、*マニピュレーター* を使用して、ユーザー インターフェイス \(UI\) 要素の移動、回転、サイズ変更を行えます。  マニピュレーターは、マウス、または \(タッチ対応のシナリオの場合\) スタイラスや指を意味します。  
+  
+ *慣性* では、要素上で摩擦力をシミュレートして、動いている UI 要素の実際の動作をエミュレートします。  これにより、要素は \(直線運動と角運動の両方で\) 徐々に動作の速度を遅らせてから停止します。  この記事では、.NET Framework の操作と慣性の概要を説明します。  
+  
+## 操作  
+ 操作では、マニピュレーターのコレクションを複合オブジェクトとして扱います。  アプリケーションは、個々 のコンポーネントではなく複合オブジェクトへの変更を追跡できます。  
+  
+ 次の図の画像を考えてください。  ユーザーは 2 つのマニピュレーターを使用して、画像の移動、回転、拡大\/縮小を行えます。  各マニピュレーターへの変更は、他のマニピュレーターと一緒に解釈されます。  
+  
+ たとえば、画像に 2 つのマニピュレーター \(1 および 2\) があり、マニピュレーター 1 を \+Y 方向 \(下\) に移動する場合、画像への変更はマニピュレーター 2 で何が発生するかによって変わります。  マニピュレーター 2 も \+Y 方向 \(下\) に移動する場合、画像は \+Y 方向に移動します。  しかし、マニピュレーター 2 が変更しない場合、または \-Y 方向 \(上\) に移動する場合は、画像は小さくなるか回転します。  
+  
+ ![2 本の指で操作中の仮想写真](../../../docs/framework/common-client-technologies/media/manipulation-resize.png "Manipulation\_Resize")  
+  
+ 2 つのマニピュレーターによって操作されている画像  
+  
+ 操作の処理には、マニピュレーターのサブセットを監視し、個別にではなく一緒に動作するかのように解釈するフレームワークがあります。  複数の操作プロセッサのオブジェクトを同時に作成することができ、アプリケーションで UI 要素ごとに 1 つのオブジェクトが操作されます。  操作プロセッサには、[.NET イベント](http://msdn.microsoft.com/library/17sde2xt.aspx) を通じて、どの入力デバイスを観察するかが通知され、それは操作を報告します。  
+  
+ 操作プロセッサには、操作する特定の要素に関する情報はありません。  アプリケーションは、アプリケーション固有の要素への変更を個別に適用します。  たとえば、アプリケーションは画像に変換を適用したり、新しい場所に、または新しいサイズや向きに再描画して表示したりします。  
+  
+ 操作は 2 次元 \(2\-D\) の[アフィン変換](http://msdn.microsoft.com/library/ms533810\(VS.85\).aspx)用に設計されています。  アフィン変換には、変換、回転、拡大\/縮小などがあります。  
+  
+### 操作のパーツ  
+ 操作は、<xref:System.Windows.Input.Manipulations.Manipulator2D> オブジェクトのコレクションです。  この集約的な操作は、最初の場所と楕円で表されます。  最初の場所は、要素を操作しているすべてのマニピュレーターの平均位置です。  楕円は、始点から各 <xref:System.Windows.Input.Manipulations.Manipulator2D> オブジェクトまでの平均距離である半径です。  
+  
+ ![操作の一部](../../../docs/framework/common-client-technologies/media/manipulation-definition.png "Manipulation\_Definition")  
+  
+ 2 つのマニピュレーター \(1 と 2\)、始点、および楕円によって操作を指定します。  
+  
+ マニピュレーターは UI 要素に対して追加、移動、または削除を行い、アプリケーションは <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.ProcessManipulators%2A> メソッドを呼び出して <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D> オブジェクトを更新します。  最初に操作が開始するとき、 <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Started> イベントが発生します。  
+  
+> [!NOTE]
+>  操作の処理は、フレームベースの環境の更新で使用すると、より効率的です。  Microsoft XNA アプリケーションで操作の処理を使用する場合は問題はありません。これは、XNA フレームワークが [Game.Update](http://msdn.microsoft.com/library/microsoft.xna.framework.game.update.aspx) メソッドを使用してフレームベースの更新を行っているためです。  別の環境 \(WinForms など\) では、操作を収集し、定期的にバッチとして <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.ProcessManipulators%2A> メソッドに送信するために、独自のフレームベースのロジックを用意する必要がある場合があります。  
+  
+ マニピュレーターの数またはその場所が変化すると、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Delta> イベントが発生します。  <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Delta> イベント ハンドラーに渡される <xref:System.Windows.Input.Manipulations.Manipulation2DDeltaEventArgs> オブジェクトのプロパティでは、始点、スケール、回転、および最後のイベント以降に発生した変換の変化を指定します。  マニピュレーターが移動したときや、マニピュレーターが追加または削除されたときには、操作の始点が変化します。  変換値では、操作での X 方向および Y 方向の移動量を指定します。  
+  
+ 新しい値を使用して、アプリケーションは UI 要素を再描画します。  
+  
+ ![連絡先 A を右側に移動した後の操作](../../../docs/framework/common-client-technologies/media/manipulation-changed.png "Manipulation\_Changed")  
+  
+ マニピュレーター 1 が移動して始点を変化させる  
+  
+ 操作に関連付けられている最後のマニピュレーターが <xref:System.Windows.Input.Manipulations.ManipulationProcessor2D> オブジェクトから削除されると、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Completed> イベントが発生します。  
+  
+### 操作の処理モデル  
+ 操作プロセッサは、直接使用モデルを使用します。  この単純なモデルでは、アプリケーションは操作プロセッサに入力イベントの詳細を渡す必要があります。  入力イベントは、マウス デバイス、スタイラス、指など、任意の入力プリミティブによって発生することがあります。  このプロセスでは、直接フィルター処理メカニズムと単純な使用モデルを提供しているため、アプリケーションは、必要なときに入力イベントをバッチ処理することができます。  
+  
+ アプリケーションが操作の処理に入力プリミティブを含めるようにするには、入力プリミティブの内容から <xref:System.Windows.Input.Manipulations.Manipulator2D> 構造体を作成してから、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.ProcessManipulators%2A> メソッドを使用してその構造体を操作プロセッサに渡します。  操作プロセッサは、適切な方法でビジュアル コンポーネントを更新するためにアプリケーションが処理する必要のあるイベントを発生させます。  
+  
+ ![直接使用モデルの操作フロー](../../../docs/framework/common-client-technologies/media/manipulation-flow.png "Manipulation\_Flow")  
+  
+ 操作の処理モデル  
+  
+## 慣性  
+ 慣性プロセッサを使用すると、アプリケーションは、実際の動作をシミュレートすることで、UI 要素の位置、向き、その他のプロパティを推定できます。  
+  
+ たとえば、ユーザーが要素をフリックすると、要素は引き続き動き、減速し、徐々に停止します。  慣性プロセッサは、2\-D のアフィン値 \(始点、スケール、変換、回転\) を指定した減速率で指定した時間をかけて変化させることで、この動作を実行します。  
+  
+ 操作の処理と同様、慣性プロセッサには、特定の UI 要素に関する情報はありません。  <xref:System.Windows.Input.Manipulations.InertiaProcessor2D> オブジェクトで発生するイベントに対応して、アプリケーションは、アプリケーション固有の要素への変更を個別に適用します。  
+  
+ 慣性の処理と操作の処理は、多くの場合、一緒に使用されます。  これらのインターフェイスは類似しており、発生するイベントは \(場合によって\) 同一です。  一般に、UI 要素の操作が完了すると、慣性の処理が開始します。  これは、<xref:System.Windows.Input.Manipulations.ManipulationProcessor2D.Completed> イベントをリッスンして、そのイベント ハンドラーから慣性の処理を開始することで実現します。  
+  
+## 参照  
+ <xref:System.Windows.Input.Manipulations>
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/manipulations-and-inertia.md b/docs/framework/common-client-technologies/manipulations-and-inertia.md
new file mode 100644
index 00000000000..f0057f6e921
--- /dev/null
+++ b/docs/framework/common-client-technologies/manipulations-and-inertia.md
@@ -0,0 +1,30 @@
+---
+title: "Manipulations and Inertia | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3731bf83-dba5-478c-94a5-1d7c36443073
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# Manipulations and Inertia
+操作と慣性のプロセッサ クラスにより、アプリケーションは、自然かつ直感的な方法で画面上のユーザー インターフェイス \(UI\) 要素を移動できるようになります。  操作では、ユーザーはマウス デバイス、スタイラス、\(タッチ機能が有効になっているシナリオでは\) 指などのマニピュレーターを使用してコンポーネントを移動、回転、およびサイズ変更できます。  慣性では、UI 要素の摩擦力をシミュレートすることによって、動作中の UI 要素の現実の世界での動作がエミュレートされます。  これにより、停止位置に移動するまでの要素の動きは \(線形および角度の両方で\) 徐々に遅くなります。  
+  
+ 操作および慣性の処理は、Microsoft Windows Presentation Foundation \(WPF\) や Microsoft XNA などのさまざまな UI フレームワークで使用できます。  
+  
+## このセクションの内容  
+ [Manipulations and Inertia Overview](../../../docs/framework/common-client-technologies/manipulations-and-inertia-overview.md)  
+  
+ [Using Manipulations and Inertia in an XNA Application](../../../docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Input.Manipulations>
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/media/casdesigner.png b/docs/framework/common-client-technologies/media/casdesigner.png
new file mode 100644
index 00000000000..cadc5248aaf
Binary files /dev/null and b/docs/framework/common-client-technologies/media/casdesigner.png differ
diff --git a/docs/framework/common-client-technologies/media/casdialog.png b/docs/framework/common-client-technologies/media/casdialog.png
new file mode 100644
index 00000000000..b8759aa38cc
Binary files /dev/null and b/docs/framework/common-client-technologies/media/casdialog.png differ
diff --git a/docs/framework/common-client-technologies/media/manipulation-flow.png b/docs/framework/common-client-technologies/media/manipulation-flow.png
new file mode 100644
index 00000000000..418b8ef4a9b
Binary files /dev/null and b/docs/framework/common-client-technologies/media/manipulation-flow.png differ
diff --git a/docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md b/docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md
new file mode 100644
index 00000000000..27d528dc966
--- /dev/null
+++ b/docs/framework/common-client-technologies/use-manipulations-and-inertia-in-an-xna-application.md
@@ -0,0 +1,41 @@
+---
+title: "Using Manipulations and Inertia in an XNA Application | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b7c18905-850c-4da4-8977-a074406a4263
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Using Manipulations and Inertia in an XNA Application
+この記事では、操作と慣性の処理を Microsoft XNA アプリケーションで使用して、ゲーム ピースの動きを制御する方法について説明します。  この記事をお読みになる前に、「[Manipulations and Inertia Overview](../../../docs/framework/common-client-technologies/manipulations-and-inertia-overview.md)」トピックの内容、および基本的な XNA のプログラミングの概念についてよく理解してください。  
+  
+ この記事で説明するタスクを実行するには、XNA プロジェクトが <xref:System.Windows.Input.Manipulations> アセンブリを参照しているとともに、[XNA Game Studio](http://msdn.microsoft.com/library/bb200104.aspx) \([ダウンロード](http://www.microsoft.com/downloads/details.aspx?FamilyId=7D70D6ED-1EDD-4852-9883-9A33C0AD8FEE&displaylang=en)\) がコンピューターにインストールされて、プロジェクトが XNA アセンブリを参照できる状態になっている必要があります。  
+  
+## 機能の概要  
+ この記事では、操作と慣性の処理を使用するゲーム ピースを表すカスタム クラスの作成方法を示します。  このクラスを使用すると、マウスでゲーム ピースをドラッグしてから放すことで、画面全体で操作できるようになります。  ゲーム ピースを放すと、慣性の処理により、ゲーム ピースの移動速度が徐々に低下します。  直線運動と角運動の両方が行われます。  
+  
+ ![単純な操作と慣性のアプリケーション](../../../docs/framework/common-client-technologies/media/ndp-gamexna.png "NDP\_GameXna")  
+  
+ さらに、複数のゲーム ピースを管理するカスタム コレクションが作成されます。  これにより、XNA Game クラスから必要とされる処理が簡略化します。  
+  
+ [Creating the GamePiece Class](../../../docs/framework/common-client-technologies/creating-the-gamepiece-class.md)  
+  
+ [Creating the GamePieceCollection Class](../../../docs/framework/common-client-technologies/creating-the-gamepiececollection-class.md)  
+  
+ [Creating the Game1 Class](../../../docs/framework/common-client-technologies/creating-the-game1-class.md)  
+  
+ [Full Code Listings](../../../docs/framework/common-client-technologies/full-code-listings.md)  
+  
+## 参照  
+ <xref:System.Windows.Input.Manipulations>   
+ [Manipulations and Inertia Overview](../../../docs/framework/common-client-technologies/manipulations-and-inertia-overview.md)
\ No newline at end of file
diff --git a/docs/framework/common-client-technologies/walkthrough-using-client-application-services.md b/docs/framework/common-client-technologies/walkthrough-using-client-application-services.md
new file mode 100644
index 00000000000..19a72b2c49d
--- /dev/null
+++ b/docs/framework/common-client-technologies/walkthrough-using-client-application-services.md
@@ -0,0 +1,548 @@
+---
+title: "チュートリアル : クライアント アプリケーション サービスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション サービス ホスト [クライアント アプリケーション サービス]"
+  - "クライアント アプリケーション サービス, チュートリアル"
+ms.assetid: bb7c8950-4517-4dae-b705-b74a14059b26
+caps.latest.revision: 47
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 47
+---
+# チュートリアル : クライアント アプリケーション サービスの使用
+このトピックでは、ユーザーを認証し、ユーザーのロールと設定を取得するクライアント アプリケーション サービスを使用する Windows アプリケーションを作成する方法について説明します。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   Windows フォーム アプリケーションを作成し、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト デザイナーを使用してクライアント アプリケーション サービスの有効化および構成を行います。  
+  
+-   アプリケーション サービスのホストと、クライアント構成のテストを行う、簡単な ASP.NET Web サービス アプリケーションを作成します。  
+  
+-   フォーム認証をアプリケーションに追加します。 最初に、ハード コーディングされたユーザー名とパスワードを使用して、サービスをテストします。 次に、アプリケーション構成でログイン フォームを資格情報プロバイダーとして指定して、ログイン フォームを追加します。  
+  
+-   "manager” ロールのユーザーのみに対してボタンを有効にして表示し、ロール ベースの機能を追加します。  
+  
+-   Web 設定にアクセスします。 最初に、プロジェクト デザイナーの **\[設定\]** ページで認証済みの \(テスト\) ユーザーの Web 設定を読み込みます。 次に、Windows フォーム デザイナーを使用して、テキスト ボックスを Web 設定にバインドします。 最後に、変更済みの値をサーバーに保存し直します。  
+  
+-   ログアウトを実装します。 フォームにログアウト オプションを追加して、logout メソッドを呼び出します。  
+  
+-   オフライン モードを有効にします。 ユーザーが接続状態を指定できるように、チェック ボックスを用意します。 次に、この値を使用して、クライアント アプリケーション サービス プロバイダーが Web サービスにアクセスするのではなく、ローカルにキャッシュされたデータを使用するかどうかを指定します。 最後に、アプリケーションがオンライン モードに戻るときに、現在のユーザーを再認証します。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../includes/vs-orcas-long-md.md)]。  
+  
+## クライアント アプリケーションの作成  
+ 最初に、Windows フォーム プロジェクトを作成します。 このチュートリアルでは Windows フォームを使用します。これはより多くの人が使い慣れているためです。しかし、プロセスは Windows Presentation Foundation \(WPF\) プロジェクトと類似しています。  
+  
+#### クライアント アプリケーションを作成し、クライアント アプリケーション サービスを有効にするには  
+  
+1.  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で、**\[ファイル\] &#124; \[新規作成\] &#124; \[プロジェクト\]** メニュー オプションをクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual Basic\]** または **\[Visual C\#\]** ノードを展開し、プロジェクトの種類 **\[Windows\]** をクリックします。  
+  
+3.  **\[.NET Framework 3.5\]** が選択されていることを確認してから、**\[Windows フォーム アプリケーション\]** テンプレートをクリックします。  
+  
+4.  プロジェクトの **\[名前\]** を `ClientAppServicesDemo` に変更してから、**\[OK\]** をクリックします。  
+  
+     [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] に新しい Windows フォーム プロジェクトが開きます。  
+  
+5.  **\[プロジェクト\]** メニューで、**ClientAppServicesDemo** プロパティを選択します。  
+  
+     プロジェクト デザイナーが表示されます。  
+  
+6.  **\[サービス\]** タブで、**\[クライアント アプリケーション サービスを有効にする\]** をクリックします。  
+  
+7.  **\[フォーム認証\]** が選択されていることを確認してから、**\[認証サービスの場所\]**、**\[ロール サービスの場所\]**、および **\[Web 設定サービスの場所\]** を `http://localhost:55555/AppServices` に設定します。  
+  
+8.  [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の **\[アプリケーション\]** タブで、**\[認証モード\]** を **\[アプリケーション定義\]** に設定します。  
+  
+ デザイナーは、アプリケーションの app.config ファイルに指定された設定を格納します。  
+  
+ この時点で、アプリケーションは、同じホストの 3 つのすべてのサービスにアクセスするように構成されます。 次のセクションでは、簡単な Web サービス アプリケーションとしてホストを作成し、クライアントの構成をテストできるようにします。  
+  
+## アプリケーションのサービス ホストを作成する  
+ このセクションでは、ローカルの SQL Server Compact データベース ファイルのユーザー データにアクセスする簡単な Web サービス アプリケーションを作成します。 次に、[ASP.NET Web Site Administration Tool](../Topic/ASP.NET%20Web%20Site%20Administration%20Tool.md)を使用してデータベースにデータを入力します。 この簡単な構成では、クライアント アプリケーションを短時間でテストすることができます。 あるいは、Web サービス ホストを構成して、完全な SQL Server データベースから、またはユーザー設定の <xref:System.Web.Security.MembershipProvider> クラスと <xref:System.Web.Security.RoleProvider> クラスを介してユーザー データにアクセスすることもできます。 詳細については、「[Creating and Configuring the Application Services Database for SQL Server](../Topic/Creating%20and%20Configuring%20the%20Application%20Services%20Database%20for%20SQL%20Server.md)」を参照してください。  
+  
+ 次の手順では、AppServices の Web サービスを作成および構成します。  
+  
+#### アプリケーション サービス ホストを作成および構成するには  
+  
+1.  **\[ソリューション エクスプローラー\]** で、ClientAppServicesDemo ソリューションを選択してから、**\[ファイル\]** メニューで **\[追加\] &#124; \[新しいプロジェクト\]** の順にクリックします。  
+  
+2.  **\[新しいプロジェクトの追加\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual Basic\]** または **\[Visual C\#\]** ノードを展開し、プロジェクトの種類 **\[Web\]** をクリックします。  
+  
+3.  **\[.NET Framework 3.5\]** が選択されていることを確認してから、**\[ASP.NET サービス アプリケーション\]** テンプレートをクリックします。  
+  
+4.  プロジェクトの **\[名前\]** を `AppServices` に変更してから、**\[OK\]** をクリックします。  
+  
+     新しい ASP.NET Web サービス アプリケーション プロジェクトがソリューションに追加され、Service1.asmx.vb または Service1.asmx.cs ファイルがエディターに表示されます。  
+  
+    > [!NOTE]
+    >  この例では、Service1.asmx.vb または Service1.asmx.cs ファイルは使用しません。 作業環境をきちんと整頓したい場合は、このファイルを閉じて **\[ソリューション エクスプローラー\]** から削除してください。  
+  
+5.  **\[ソリューション エクスプローラー\]** で、AppServices プロジェクトを選択し、**\[プロジェクト\]** メニューで **\[AppServices のプロパティ\]** をクリックします。  
+  
+     プロジェクト デザイナーが表示されます。  
+  
+6.  **\[Web\]** タブで、**\[Visual Studio 開発サーバーを使用する\]** が選択されていることを確認します。  
+  
+7.  **\[特定のポート\]** をクリックし、値に `/AppServices` を指定してから、**\[仮想パス\]** を `55555` に設定します。  
+  
+8.  すべてのファイルを保存します。  
+  
+9. **\[ソリューション エクスプローラー\]** で、Web.config を開き、`<system.web>` の開始タグを検索します。  
+  
+10. `<system.web>` タグの前に次のマークアップを追加します。  
+  
+     このマークアップの `authenticationService`、`profileService`、および `roleService` の各要素で、アプリケーション サービスの有効化と構成を行います。 テスト目的で、`authenticationService` 要素の `requireSSL` 属性が "false" に設定されています。`profileService` 要素の `readAccessProperties` 属性と `writeAccessProperties` 属性は、`WebSettingsTestText` プロパティが読み取りと書き込みが可能であることを示しています。  
+  
+    > [!NOTE]
+    >  実稼働コードでは、HTTPS プロトコルを使用して、常に Secure Socket Layer \(SSL\) 上の認証サービスにアクセスする必要があります。 SSL の設定方法については、「[SSL \(Secure Sockets Layer\) を構成する](http://go.microsoft.com/fwlink/?LinkId=91844)」を参照してください。  
+  
+    ```  
+    <system.web.extensions>  
+      <scripting>  
+        <webServices>  
+          <authenticationService enabled="true" requireSSL = "false"/>  
+          <profileService enabled="true"  
+            readAccessProperties="WebSettingsTestText"  
+            writeAccessProperties="WebSettingsTestText" />  
+          <roleService enabled="true"/>  
+        </webServices>  
+      </scripting>  
+    </system.web.extensions>  
+    ```  
+  
+11. 次のマークアップを、`<system.web>` 要素内に収まるように、`<system.web>` の開始タグの後に追加します。  
+  
+     `profile` 要素は、`WebSettingsTestText` という名前の 1 つの Web 設定を構成します。  
+  
+    ```  
+    <profile enabled="true" >  
+      <properties>  
+        <add name="WebSettingsTestText" type="string"   
+          readOnly="false" defaultValue="DefaultText"   
+          serializeAs="String" allowAnonymous="false" />  
+      </properties>  
+    </profile>  
+  
+    ```  
+  
+ 次の手順では、ASP.NET Web サイト管理ツールを使用して、サービスの構成を完了するとともに、ローカル データベース ファイルにデータを読み込みます。 同じ名前の 2 つのロールに属する、`employee` と `manager` という名前の 2 人のユーザーを追加します。 ユーザーのパスワードはそれぞれ、`employee!` と `manager!` です。  
+  
+#### メンバーシップとロールを構成するには  
+  
+1.  **\[ソリューション エクスプローラー\]** で、AppServices プロジェクトを選択し、**\[プロジェクト\]** メニューで **\[ASP.NET の構成\]** をクリックします。  
+  
+     **ASP.NET Web サイト管理ツール**が表示されます。  
+  
+2.  **\[セキュリティ\]** タブで、**\[セキュリティ設定ウィザードを使用して手順に従ってセキュリティを構成する\]** をクリックします。  
+  
+     **\[セキュリティ セットアップ ウィザード\]** が表示され、**\[ようこそ\]** 手順が表示されます。  
+  
+3.  **\[次へ\]** をクリックします。  
+  
+     **\[アクセス方法の選択\]** 手順が表示されます。  
+  
+4.  **\[インターネットから\]** を選択します。 そうすることで、Windows 認証ではなくフォーム認証を使用するようサービスが構成されます。  
+  
+5.  **\[次へ\]** を 2 回クリックします。  
+  
+     **\[ロールの定義\]** 手順が表示されます。  
+  
+6.  **\[この Web サイトのロールを有効化\]** をクリックします。  
+  
+7.  **\[次へ\]** をクリックします。**\[新しいロールの作成\]** フォームが表示されます。  
+  
+8.  **\[新しいロール名\]** テキスト ボックスで、「`manager`」と入力してから、**\[ロールの追加\]** をクリックします。  
+  
+     指定した値が入った **\[既存のロール\]** テーブルが表示されます。  
+  
+9. **\[新しいロール名\]** テキスト ボックスで、`manager` を `employee` に置き換えてから、**\[ロールの追加\]** をクリックします。  
+  
+     **\[既存のロール\]** テーブルに新しい値が表示されます。  
+  
+10. **\[次へ\]** をクリックします。  
+  
+     **\[新しいユーザーの追加\]** 手順が表示されます。  
+  
+11. **\[ユーザーの作成\]** フォームで、次の値を指定します。  
+  
+    |||  
+    |-|-|  
+    |**ユーザー名**|`manager`|  
+    |**パスワード**|`manager!`|  
+    |**パスワードの確認入力**|`manager!`|  
+    |**電子メール**|`manager@contoso.com`|  
+    |**セキュリティの質問**|`manager`|  
+    |**セキュリティ返答**|`manager`|  
+  
+12. **\[ユーザーの作成\]** をクリックします。  
+  
+     成功のメッセージが表示されます。  
+  
+    > [!NOTE]
+    >  フォームでは **\[電子メール\]**、**\[秘密の質問\]**、および **\[秘密の答え\]** の値が必要ですが、この例では使用しません。  
+  
+13. **\[続行\]** をクリックします。  
+  
+     **\[ユーザーの作成\]** フォームが再表示されます。  
+  
+14. **\[ユーザーの作成\]** フォームで、次の値を指定します。  
+  
+    |||  
+    |-|-|  
+    |**ユーザー名**|`employee`|  
+    |**パスワード**|`employee!`|  
+    |**パスワードの確認入力**|`employee!`|  
+    |**電子メール**|`employee@contoso.com`|  
+    |**セキュリティの質問**|`Employee`|  
+    |**セキュリティ返答**|`employee`|  
+  
+15. **\[ユーザーの作成\]** をクリックします。  
+  
+     成功のメッセージが表示されます。  
+  
+16. **\[完了\]** をクリックします。  
+  
+     **Web サイト管理ツール**が再表示されます。  
+  
+17. **\[管理者ユーザー\]** をクリックします。  
+  
+     ユーザーの一覧が表示されます。  
+  
+18. **employee** ユーザーの **\[ロールの編集\]** をクリックしてから、**employee** ロールをクリックします。  
+  
+19. **manager** ユーザーの **\[ロールの編集\]** をクリックしてから、**manager** ロールをクリックします。  
+  
+20. **Web サイト管理ツール**をホストするブラウザのウィンドウを閉じます。  
+  
+21. 変更した Web.config ファイルを再度読み込むかどうかを尋ねるメッセージ ボックスが表示された場合は、**\[はい\]** をクリックします。  
+  
+ これにより、Web サービスのセットアップが完了します。 この時点で、F5 キーを押すとクライアント アプリケーションを実行します。**ASP.NET 開発サーバー**は、クライアント アプリケーションとともに自動的に起動します。 サーバーは、アプリケーションが終了しても引き続き実行しますが、アプリケーションを再起動するとサーバーも再起動します。 そうすることで、Web.config に対して行われたすべての変更を検出することができます。  
+  
+ サーバーを手動で停止するには、タスク バーの通知領域にある ASP.NET 開発サーバーのアイコンを右クリックしてから、**\[停止\]** をクリックします。 これは、時折クリーン再起動を確実に行うために役立ちます。  
+  
+## フォーム認証を追加する  
+ 次の手順では、ユーザーの検証を試みるとともに、ユーザーが無効な資格情報を指定した場合にアクセスを拒否するコードをメイン フォームに追加します。 ハードコーディングされたユーザー名とパスワードを使用して、サービスをテストします。  
+  
+#### アプリケーション コードでユーザーを検証するには  
+  
+1.  **\[ソリューション エクスプローラー\]** の ClientAppServicesDemo プロジェクトで、System.Web アセンブリへの参照を追加します。  
+  
+2.  Form1 ファイルを選択し、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のメイン メニューから **\[表示\] &#124; \[コード\]** をクリックします。  
+  
+3.  コード エディターで、Form1 ファイルの先頭に次のステートメントを追加します。  
+  
+     [!code-csharp[ClientApplicationServices#001](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#001)]
+     [!code-vb[ClientApplicationServices#001](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#001)]  
+  
+4.  **\[ソリューション エクスプローラー\]** で、Form1 をダブルクリックしてデザイナーを表示します。  
+  
+5.  デザイナーで、フォーム領域をダブルクリックして、`Form1_Load` という名前の <xref:System.Windows.Forms.Form.Load?displayProperty=fullName> イベント ハンドラーを生成します。  
+  
+     `Form1_Load` メソッドにカーソルがある状態でコード エディターが表示されます。  
+  
+6.  `Form1_Load` メソッドに次のコードを追加します。  
+  
+     このコードは認証されていないユーザー アクセスを拒否してアプリケーションを終了します。 あるいは、認証されていないユーザーによるフォームへのアクセスを許可するものの、特定の機能へのアクセスを拒否することもできます。 通常、このようにユーザー名とパスワードをハードコーディングすることはありませんが、テスト目的には役立ちます。 次のセクションではこのコードをより堅牢なコードに置き換えて、ログイン ダイアログ ボックスを表示する、例外処理を含んだものにします。  
+  
+     `static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドが [!INCLUDE[dnprdnext](../../../includes/dnprdnext-md.md)] にあることに注意してください。 このメソッドは、構成済みの認証プロバイダーに作業を委任し、認証が成功した場合は `true` を返します。 アプリケーションに、クライアントの認証プロバイダーへの直接の参照は必要ありません。  
+  
+     [!code-csharp[ClientApplicationServices#300](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Class1.cs#300)]
+     [!code-vb[ClientApplicationServices#300](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#300)]  
+  
+ ここで、F5 キーを押してアプリケーションを実行します。正しいユーザー名とパスワードを指定しているため、フォームが表示されます。  
+  
+> [!NOTE]
+>  アプリケーションを実行できない場合は、ASP.NET 開発サーバーを停止してください。 サーバーを再起動する際、ポートが 55555 に設定されていることを確認します。  
+  
+ 代わりにエラー メッセージを表示するには、<xref:System.Web.Security.Membership.ValidateUser%2A> のパラメーターを変更します。 たとえば、2 番目の `"manager!"` パラメーターを `"MANAGER"` などの正しくないパスワードに置き換えます。  
+  
+## 資格情報プロバイダーとしてログイン フォームを追加する  
+ アプリケーション コードでユーザーの資格情報を取得して、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドに渡すことができます。 しかし、資格情報を取得するコードをアプリケーション コードと分けておくと、後でこれを変更するときに便利な場合もあります。  
+  
+ 次の手順では、資格情報プロバイダーを使用するようにアプリケーションを構成してから、両方のパラメーターに <xref:System.String.Empty> を渡すように <xref:System.Web.Security.Membership.ValidateUser%2A> メソッドの呼び出しを変更します。 文字列が空の場合、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドは構成済みの資格情報プロバイダーの <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> メソッドを呼び出します。  
+  
+#### アプリケーションが資格情報プロバイダーを使用するように構成するには  
+  
+1.  **\[ソリューション エクスプローラー\]** で、ClientAppServicesDemo プロジェクトを選択し、**\[プロジェクト\]** メニューで **\[ClientAppServicesDemo のプロパティ\]** をクリックします。  
+  
+     プロジェクト デザイナーが表示されます。  
+  
+2.  **\[サービス\]** タブで、**\[省略可能な資格情報プロバイダー\]** を次の値に設定します。 この値は、アセンブリ修飾型名を示しています。  
+  
+    ```  
+    ClientAppServicesDemo.Login, ClientAppServicesDemo  
+    ```  
+  
+3.  Form1 コード ファイルで、`Form1_Load` メソッドのコードを次のコードに置き換えます。  
+  
+     このコードは、ようこそメッセージを表示してから、次の手順で追加する `ValidateUsingCredentialsProvider` メソッドを呼び出します。 ユーザーが認証されない場合、`ValidateUsingCredentialsProvider` メソッドは `false` を返し、`Form1_Load` メソッドが戻ります。 これにより、アプリケーションが終了するまでそれ以上コードを実行できなくなります。 ようこそメッセージは、アプリケーションが再起動するときが明確になるため便利です。 このチュートリアルの後半でログアウトを実装するときに、アプリケーションを再起動するコードを追加します。  
+  
+     [!code-csharp[ClientApplicationServices#011](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#011)]
+     [!code-vb[ClientApplicationServices#011](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#011)]  
+  
+4.  `Form1_Load` メソッドの後に次のメソッドを追加します。  
+  
+     このメソッドは、`static` <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> メソッドに空の文字列を渡すことによって、\[ログイン\] ダイアログ ボックスを表示させます。 認証サービスが使用できない場合、<xref:System.Web.Security.Membership.ValidateUser%2A> メソッドは <xref:System.Net.WebException> をスローします。 この場合、`ValidateUsingCredentialsProvider` メソッドは警告メッセージを表示し、オフライン モードで再試行するかどうかをユーザーに尋ねます。 この機能には、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」で説明する **\[オフラインでログインできるようにパスワードのハッシュをローカルに保存する\]** 機能が必要です。 この機能は、新しいプロジェクトでは既定で有効になっています。  
+  
+     ユーザーが検証されない場合、`ValidateUsingCredentialsProvider` メソッドはエラー メッセージを表示し、アプリケーションを終了します。 最後に、このメソッドは、認証の結果を返します。  
+  
+     [!code-csharp[ClientApplicationServices#020](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#020)]
+     [!code-vb[ClientApplicationServices#020](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#020)]  
+  
+### ログイン フォームを作成する  
+ 資格情報プロバイダーとは、<xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装するクラスです。 このインターフェイスには、<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationCredentials> オブジェクトを返す <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> という名前の 1 つのメソッドがあります。 次の手順ではログイン ダイアログ ボックスの作成方法を示します。これは <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> を実装してダイアログ ボックスを表示し、ユーザー指定の資格情報を返します。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] は **\[ログイン フォーム\]** テンプレートを備えているため、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] と C\# で手順が別々に説明されています。 このテンプレートを使用すると、時間の節約になり、コーディングの手間も省けます。  
+  
+##### Visual Basic で資格情報プロバイダーとしてログイン ダイアログ ボックスを作成するには  
+  
+1.  **\[ソリューション エクスプローラー\]** で、ClientAppServicesDemo プロジェクトを選択してから、**\[プロジェクト\]** メニューで **\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[ログイン フォーム\]** テンプレートを選択し、項目の **\[名前\]** を `Login.vb` に変更してから、**\[追加\]** をクリックします。  
+  
+     Windows フォーム デザイナーにログイン ダイアログ ボックスが表示されます。  
+  
+3.  デザイナーで、**\[OK\]** ボタンをクリックし、**\[プロパティ\]** ウィンドウで、\[`DialogResult`\] を ”`OK`" に設定します。  
+  
+4.  デザイナーで、`CheckBox` コントロールを、**\[パスワード\]** テキスト ボックスの下にあるフォームに追加します。  
+  
+5.  **\[プロパティ\]** ウィンドウで、**\[\(名前\)\]** の値を ”`rememberMeCheckBox`" と指定し、**\[テキスト\]** の値を "`&Remember me`” と指定します。  
+  
+6.  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のメイン メニューで、**\[表示\] &#124; \[コード\]** の順にクリックします。  
+  
+7.  コード エディターで、ファイルの先頭に次のコードを追加します。  
+  
+     [!code-vb[ClientApplicationServices#101](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Login.vb#101)]  
+  
+8.  クラスが <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider> インターフェイスを実装するようにクラスのシグネチャを変更します。  
+  
+     [!code-vb[ClientApplicationServices#110](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#110)]  
+  
+9. カーソルが `IClientformsAuthenticationCredentialsProvider` の後にあることを確認してから、Enter キーを押して `GetCredentials` メソッドを生成します。  
+  
+10. <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> の実装を見つけて、次のコードに置き換えます。  
+  
+     [!code-vb[ClientApplicationServices#120](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Login.vb#120)]  
+  
+ 次の C\# の手順では、簡単なログイン ダイアログ ボックス用のコード全体を一覧で示します。 このダイアログ ボックスのレイアウトは少し粗雑ですが、重要な部分は <xref:System.Web.ClientServices.Providers.IClientFormsAuthenticationCredentialsProvider.GetCredentials%2A> の実装です。  
+  
+##### C\# で資格情報プロバイダーとしてログイン ダイアログ ボックスを作成するには  
+  
+1.  **\[ソリューション エクスプローラー\]** で、ClientAppServicesDemo プロジェクトを選択してから、**\[プロジェクト\]** メニューで **\[クラスの追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[名前\]** を `Login.cs` に変更してから、**\[追加\]** をクリックします。  
+  
+     コード エディターで Login.cs ファイルが開きます。  
+  
+3.  既定のコードを次のコードに置き換えます。  
+  
+     [!code-csharp[ClientApplicationServices#200](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Login.cs#200)]  
+  
+ アプリケーションを実行してログイン ダイアログ ボックスを表示できるようになりました。 このコードをテストするには、有効と無効の両方のさまざまな資格情報を試し、資格情報が有効な場合にのみフォームにアクセスできることを確認します。 有効なユーザー名は、`employee` と `manager` になります。パスワードはそれぞれ、`employee!` と `manager!` です。  
+  
+> [!NOTE]
+>  この時点で **\[アカウントを記憶\]** は選択しないでください。そうしないと、このチュートリアルの後半でログアウトを実装するまで、別のユーザーとしてログインできなくなります。  
+  
+## ロール ベースの機能を追加する  
+ 次の手順では、フォームにボタンを追加して、manager ロールのユーザーにだけこれを表示します。  
+  
+#### ユーザーのロールに基づいてユーザー インターフェイスを変更するには  
+  
+1.  **\[ソリューション エクスプローラー\]** の ClientAppServicesDemo プロジェクトで、Form1 を選択してから、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のメイン メニューで **\[表示\] &#124; \[デザイナー\]** をクリックします。  
+  
+2.  デザイナーで、**\[ツールボックス\]** からフォームに <xref:System.Windows.Forms.Button> コントロールを追加します。  
+  
+3.  **\[プロパティ\]** ウィンドウで、ボタンの次のプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |**\(名前\)**|managerOnlyButton|  
+    |**テキスト**|&Manager task|  
+    |**Visible**|`False`|  
+  
+4.  Form1 のコード エディターで、`Form1_Load` メソッドの末尾に次のコードを追加します。  
+  
+     このコードは、次の手順で追加する `DisplayButtonForManagerRole` メソッドを呼び出します。  
+  
+     [!code-csharp[ClientApplicationServices#012](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#012)]
+     [!code-vb[ClientApplicationServices#012](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#012)]  
+  
+5.  次のメソッドを Form1 クラスの末尾に追加します。  
+  
+     このメソッドは、`static` <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティによって返される <xref:System.Security.Principal.IPrincipal> の <xref:System.Security.Principal.IPrincipal.IsInRole%2A> メソッドを呼び出します。 クライアント アプリケーション サービスを使用するように構成されたアプリケーションで、このプロパティは <xref:System.Web.ClientServices.ClientRolePrincipal> を返します。 このクラスは <xref:System.Security.Principal.IPrincipal> インターフェイスを実装しているため、明示的に参照する必要はありません。  
+  
+     ユーザーが "manager" ロールの場合、`DisplayButtonForManagerRole` メソッドは `managerOnlyButton` の <xref:System.Windows.Forms.Control.Visible%2A> プロパティを `true` に設定します。 また、このメソッドは、<xref:System.Net.WebException> がスローされるとエラー メッセージを表示します。これは、ロール サービスが使用できないことを示します。  
+  
+    > [!NOTE]
+    >  ユーザー ログインの有効期限が切れている場合、<xref:System.Web.ClientServices.ClientRolePrincipal.IsInRole%2A> メソッドは常に `false` を返します。 このチュートリアルのコードの使用例に示すように、アプリケーションが認証のすぐ後に <xref:System.Security.Principal.IPrincipal.IsInRole%2A> メソッドを 1 回呼び出した場合、これは発生しません。 アプリケーションが他のタイミングでユーザーのロールを取得する必要がある場合は、ログインの有効期限が切れたユーザーを再検証するコードを追加することができます。 有効なユーザーすべてにロールが割り当てられている場合は、<xref:System.Web.ClientServices.Providers.ClientRoleProvider.GetRolesForUser%2A?displayProperty=fullName> メソッドを呼び出してログインの有効期限が切れていないか判断できます。 ロールが返されない場合は、ログインの有効期限が切れています。 この機能の例については、<xref:System.Web.ClientServices.Providers.ClientRoleProvider.GetRolesForUser%2A> メソッドを参照してください。 この機能が必要なのは、アプリケーションの構成で **\[サーバー クッキーの期限が切れた場合は常に再度ログオンすることをユーザーに要求する\]** を選択した場合だけです。 詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  
+  
+     [!code-csharp[ClientApplicationServices#030](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#030)]
+     [!code-vb[ClientApplicationServices#030](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#030)]  
+  
+ 認証が成功した場合に、クライアント認証プロバイダーは <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティを <xref:System.Web.ClientServices.ClientRolePrincipal> クラスのインスタンスに設定します。 このクラスは、構成済みのロール プロバイダーに作業を委任するよう、<xref:System.Security.Principal.IPrincipal.IsInRole%2A> メソッドを実装します。 上記と同様、アプリケーションのコードにサービス プロバイダーへの直接の参照は必要ありません。  
+  
+ ここでアプリケーションを実行し、従業員としてログインして、ボタンが表示されないことを確認できます。次いで、管理者としてログインして、ボタンが表示されることを確認します。  
+  
+## Web 設定にアクセスする  
+ 次の手順では、フォームにテキスト ボックスを追加するとともに、Web 設定にバインドします。 認証とロールを使用する前のコードと同様、設定コードは設定プロバイダーに直接アクセスしません。 代わりに、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] がプロジェクト用に生成する、厳密に型指定された `Settings` クラスを使用します \(C\# では `Properties.Settings.Default` として、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `My.Settings` としてアクセスします\)。  
+  
+#### ユーザー インターフェイスで Web 設定を使用するには  
+  
+1.  タスクバーの通知領域をチェックして、**ASP.NET Web 開発サーバー**がまだ実行中であることを確認します。 サーバーが停止している場合は、アプリケーションを再起動して \(これによりサーバーが自動的に起動します\)、その後、ログイン ダイアログ ボックスを閉じます。  
+  
+2.  **\[ソリューション エクスプローラー\]** で、ClientAppServicesDemo プロジェクトを選択し、**\[プロジェクト\]** メニューで **\[ClientAppServicesDemo のプロパティ\]** をクリックします。  
+  
+     プロジェクト デザイナーが表示されます。  
+  
+3.  **\[設定\]** タブで、**\[Web 設定の読み込み\]** をクリックします。  
+  
+     **\[ログイン\]** ダイアログ ボックスが表示されます。  
+  
+4.  従業員またはマネージャーの資格情報を入力してから、**\[ログイン\]** をクリックします。 使用する Web 設定は認証されたユーザーのみがアクセスできるように構成されているため、**\[ログインのスキップ\]** をクリックすると設定は読み込まれません。  
+  
+     `WebSettingsTestText` の設定が、既定値の `DefaultText` でデザイナーに表示されます。 さらに、`WebSettingsTestText` プロパティを含む `Settings` クラスがプロジェクトに生成されます。  
+  
+5.  **\[ソリューション エクスプローラー\]** の ClientAppServicesDemo プロジェクトで、Form1 を選択してから、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のメイン メニューで **\[表示\] &#124; \[デザイナー\]** をクリックします。  
+  
+6.  デザイナーで、フォームに <xref:System.Windows.Forms.TextBox> コントロールを追加します。  
+  
+7.  **\[プロパティ\]** ウィンドウで、**\[\(名前\)\]** の値を "`webSettingsTestTextBox`" と指定します。  
+  
+8.  コード エディターで、`Form1_Load` メソッドの末尾に次のコードを追加します。  
+  
+     このコードは、次の手順で追加する `BindWebSettingsTestTextBox` メソッドを呼び出します。  
+  
+     [!code-csharp[ClientApplicationServices#013](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#013)]
+     [!code-vb[ClientApplicationServices#013](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#013)]  
+  
+9. 次のメソッドを Form1 クラスの末尾に追加します。  
+  
+     このメソッドは、`webSettingsTestTextBox` の <xref:System.Windows.Forms.TextBox.Text%2A> プロパティを、この手順の前半で生成した `Settings` クラスの `WebSettingsTestText` プロパティにバインドします。 また、このメソッドは、<xref:System.Net.WebException> がスローされるとエラー メッセージを表示します。これは、Web 設定サービスが使用できないことを示します。  
+  
+     [!code-csharp[ClientApplicationServices#040](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#040)]
+     [!code-vb[ClientApplicationServices#040](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#040)]  
+  
+    > [!NOTE]
+    >  通常は、データ バインドを使用して、コントロールと Web 設定間の自動双方向通信を有効にします。 しかし、次の例に示すとおり、直接 Web 設定にアクセスすることもできます。  
+  
+     [!code-csharp[ClientApplicationServices#322](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Class1.cs#322)]
+     [!code-vb[ClientApplicationServices#322](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Class1.vb#322)]  
+  
+10. デザイナーで、フォームを選択してから、**\[プロパティ\]** ウィンドウの **\[イベント\]** ボタンをクリックします。  
+  
+11. <xref:System.Windows.Forms.Form.FormClosing> イベントをクリックしてから、Enter キーを押すとイベント ハンドラーが生成されます。  
+  
+12. 生成されたメソッドを次のコードで置き換えます。  
+  
+     <xref:System.Windows.Forms.Form.FormClosing> イベント ハンドラーが `SaveSettings` メソッドを呼び出します。このメソッドは、次のセクションで追加するログアウト機能でも使用されます。 まず、`SaveSettings` メソッドは、ユーザーがログアウトしていないことを確認します。 これは、現在のプリンシパルによって返される <xref:System.Security.Principal.IIdentity> の <xref:System.Security.Principal.IIdentity.AuthenticationType%2A> プロパティをチェックして行います。 現在のプリンシパルは`static`<xref:System.Threading.Thread.CurrentPrincipal%2A> プロパティを介して取得します。 ユーザーがクライアント アプリケーション サービスで認証済みであれば、認証の種類は "ClientForms" になります。`SaveSettings` メソッドは、単に <xref:System.Security.Principal.IIdentity.IsAuthenticated%2A?displayProperty=fullName> プロパティをチェックすることはできません。これは、ユーザーがログアウト後に有効な Windows ID を持っていることがあるためです。  
+  
+     ユーザーがログアウトしていない場合、`SaveSettings` メソッドは、この手順の前半で生成された `Settings` クラスの <xref:System.Configuration.ApplicationSettingsBase.Save%2A> メソッドを呼び出します。 認証クッキーの有効期限が切れている場合、このメソッドは <xref:System.Net.WebException> をスローすることがあります。 これが発生するのは、アプリケーションの構成で **\[サーバー クッキーの期限が切れた場合は常に再度ログオンすることをユーザーに要求する\]** を選択した場合だけです。 詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。`SaveSettings` メソッドは、<xref:System.Web.Security.Membership.ValidateUser%2A> を呼び出してログイン ダイアログ ボックスを表示することで、クッキーの有効期限を処理します。 ユーザーが正常にログインすると、`SaveSettings` メソッドは自身を呼び出して設定を再度保存しようとします。  
+  
+     前のコードと同様、リモート サービスが使用できない場合、`SaveSettings` メソッドはエラー メッセージを表示します。 設定プロバイダーがリモート サービスにアクセスできない場合、設定はローカル キャッシュに保存されたままとなり、アプリケーションの再起動時に再度読み込まれます。  
+  
+     [!code-csharp[ClientApplicationServices#050](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#050)]
+     [!code-vb[ClientApplicationServices#050](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#050)]  
+  
+13. 次のメソッドを Form1 クラスの末尾に追加します。  
+  
+     このコードは <xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved?displayProperty=fullName> イベントを処理し、設定のいずれかが保存できなかった場合は警告を表示します。 設定サービスが使用できない場合、または認証クッキーの有効期限が切れている場合、<xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved> イベントは発生しません。<xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved> イベントが発生する 1 つの例は、ユーザーが既にログアウトしている場合です。 このイベント ハンドラーは、<xref:System.Configuration.ApplicationSettingsBase.Save%2A> メソッドの呼び出しの直前にある `SaveSettings` メソッドにログアウトのコードを追加することでテストできます。 使用できるログアウトのコードは、次のセクションで説明します。  
+  
+     [!code-csharp[ClientApplicationServices#090](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#090)]
+     [!code-vb[ClientApplicationServices#090](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#090)]  
+  
+14. C\# では、`Form1_Load` メソッドの末尾に次のコードを追加します。 このコードは、最後の手順で追加したメソッドと <xref:System.Web.ClientServices.Providers.ClientSettingsProvider.SettingsSaved> イベントを関連付けます。  
+  
+     [!code-csharp[ClientApplicationServices#015](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#015)]  
+  
+ この時点でアプリケーションをテストするため、従業員として、およびマネージャーとして複数回これを実行し、テキスト ボックスに異なる値を入力します。 値は、ユーザーごとにセッションをまたいで保持されます。  
+  
+## ログアウトを実装する  
+ ユーザーがログイン時に **\[アカウントを記憶\]** チェック ボックスをオンにすると、アプリケーションは以降の実行時に自動的にユーザーを認証します。 自動認証は、アプリケーションがオフライン モードの場合、または認証クッキーの有効期限が切れるまで継続します。 ただし、場合によっては、複数のユーザーがアプリケーションにアクセスしなければならなくなることや、1 人のユーザーが別の資格情報でログインすることもあります。 このシナリオを有効にするには、次の手順に説明するログアウト機能を実装する必要があります。  
+  
+#### ログアウト機能を実装するには  
+  
+1.  Form1 デザイナーで、**\[ツールボックス\]** から <xref:System.Windows.Forms.Button> コントロールをフォームに追加します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、**\[\(名前\)\]** の値を "`logoutButton`" と指定し、**\[テキスト\]** の値を "**&Log Out**" と指定します。  
+  
+3.  "`logoutButton`" をダブルクリックすると、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーが生成されます。  
+  
+     `logoutButton_Click` メソッドにカーソルがある状態でコード エディターが表示されます。  
+  
+4.  生成された `logoutButton_Click` メソッドを次のコードで置き換えます。  
+  
+     まず、このイベント ハンドラーは、前のセクションで追加した `SaveSettings` メソッドを呼び出します。 次に、イベント ハンドラーは <xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.Logout%2A?displayProperty=fullName> メソッドを呼び出します。 認証サービスが使用できない場合、<xref:System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider.Logout%2A> メソッドは <xref:System.Net.WebException> をスローします。 この場合、`logoutButton_Click` メソッドは警告メッセージを表示し、一時的にオフライン モードに切り替えてユーザーをログアウトします。 オフライン モードについては、次のセクションで説明します。  
+  
+     ログアウトすると、アプリケーションの再起動時にログインが必要になるように、ローカルの認証クッキーが削除されます。 ログアウト後、イベント ハンドラーは、アプリケーションを再起動します。 アプリケーションは、再起動すると、ようこそメッセージに続いてログイン ダイアログ ボックスを表示します。 ようこそメッセージにより、アプリケーションが再起動したことが明確になります。 こうすることで、ユーザーが設定の保存のためのログインに続いて、アプリケーションの再起動に伴うログインを再度行わなければならない場合に、起こりうる混乱を避けられます。  
+  
+     [!code-csharp[ClientApplicationServices#070](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#070)]
+     [!code-vb[ClientApplicationServices#070](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#070)]  
+  
+ ログアウト機能をテストするには、アプリケーションを実行し、\[ログイン\] ダイアログ ボックスで **\[アカウントを記憶\]** をクリックします。 次に、ログインする必要がなくなることを確認するため、アプリケーションを閉じて再起動します。 最後に、\[Log out\] をクリックして、アプリケーションを再起動します。  
+  
+## オフライン モードを有効にする  
+ 次の手順では、ユーザーがオフライン モードに入れるようにするチェック ボックスをフォームに追加します。`static` <xref:System.Web.ClientServices.ConnectivityStatus.IsOffline%2A?displayProperty=fullName> プロパティを `true` に設定すると、アプリケーションはオフライン モードを示します。 オフラインの状態は、ローカルのハード ディスク上の、<xref:System.Windows.Forms.Application.UserAppDataPath%2A?displayProperty=fullName> プロパティが示す場所に格納されます。 つまり、オフラインの状態は、ユーザーごと、アプリケーションごとに格納されます。  
+  
+ オフライン モードの場合、クライアント アプリケーション サービス要求はどれも、サービスへのアクセスを試みることなく、ローカル キャッシュからデータを取得します。 既定の構成では、ローカル データには暗号化された形式のユーザーのパスワードが含まれています。 これにより、ユーザーは、アプリケーションがオフライン モードのときにログインできます。 詳細については、「[方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)」を参照してください。  
+  
+#### アプリケーションでオフライン モードを有効にするには  
+  
+1.  **\[ソリューション エクスプローラー\]** の ClientAppServicesDemo プロジェクトで、Form1 を選択してから、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のメイン メニューで **\[表示\] &#124; \[デザイナー\]** をクリックします。  
+  
+2.  デザイナーで、フォームに <xref:System.Windows.Forms.CheckBox> コントロールを追加します。  
+  
+3.  **\[プロパティ\]** ウィンドウで、**\[\(名前\)\]** の値を "`workOfflineCheckBox`" と指定し、**\[テキスト\]** の値を "**&Work offline**" と指定します。  
+  
+4.  **\[プロパティ\]** ウィンドウで、**\[イベント\]** ボタンをクリックします。  
+  
+5.  <xref:System.Windows.Forms.CheckBox.CheckedChanged> イベントをクリックしてから、Enter キーを押すとイベント ハンドラーが生成されます。  
+  
+6.  生成されたメソッドを次のコードで置き換えます。  
+  
+     このコードは、<xref:System.Web.ClientServices.ConnectivityStatus.IsOffline%2A> の値を更新し、オンライン モードに戻るときに、ダイアログを表示せずにユーザーを再検証します。<xref:System.Web.ClientServices.ClientFormsIdentity.RevalidateUser%2A?displayProperty=fullName> メソッドでは、ユーザーが明示的にログインする必要がないように、キャッシュされた資格情報を使用します。 認証サービスが使用できない場合、警告メッセージが表示され、アプリケーションはオフラインのままになります。  
+  
+    > [!NOTE]
+    >  <xref:System.Web.ClientServices.ClientFormsIdentity.RevalidateUser%2A> メソッドは便宜的なものに過ぎません。 このメソッドには戻り値がないため、再検証が失敗したかどうかを示すことはできません。 再検証は失敗することがあります。たとえば、サーバーでユーザーの資格情報が変更された場合などです。 この場合、サービスの呼び出しが失敗した後に、明示的にユーザーを検証するコードを含めることができます。 詳細については、このチュートリアルの上述の「Web 設定にアクセスする」を参照してください。  
+  
+     再検証後、前に追加した `SaveSettings` メソッドを呼び出すことで、このコードはローカルの Web 設定への変更をすべて保存します。 続いて、プロジェクトの `Settings` クラスの <xref:System.Configuration.ApplicationSettingsBase.Reload%2A> メソッドを呼び出して、新しい値をすべて取得します \(C\# では `Properties.Settings.Default` として、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `My.Settings` としてアクセスします\)。  
+  
+     [!code-csharp[ClientApplicationServices#080](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#080)]
+     [!code-vb[ClientApplicationServices#080](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#080)]  
+  
+7.  `Form1_Load` メソッドの末尾に次のコードを追加して、チェック ボックスが現在の接続状態を示すようにします。  
+  
+     [!code-csharp[ClientApplicationServices#014](../../../samples/snippets/csharp/VS_Snippets_Winforms/ClientApplicationServices/CS/Form1.cs#014)]
+     [!code-vb[ClientApplicationServices#014](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ClientApplicationServices/VB/Form1.vb#014)]  
+  
+ これで、サンプル アプリケーションが完成しました。 オフライン機能をテストするには、アプリケーションを実行し、従業員またはマネージャーとしてログインしてから、**\[Work offline\]** をクリックします。 テキスト ボックスの値を変更してから、アプリケーションを終了します。 アプリケーションを再起動します ログインする前に、タスク バーの通知領域にある ASP.NET 開発サーバーのアイコンを右クリックしてから、**\[停止\]** をクリックします。 次に、通常どおりにログインします。 サーバーが実行されていない場合でもログインできます。 テキスト ボックスの値を変更してから、終了および再起動を行って、変更された値を確認します。  
+  
+## 概要  
+ このチュートリアルでは、Windows フォーム アプリケーションでのクライアント アプリケーション サービスの有効化および使用方法について学習しました。 テスト サーバーをセットアップした後、アプリケーションにコードを追加し、ユーザーを認証したり、サーバーからユーザーのロールとアプリケーションの設定を取得したりできるようにしました。 また、接続を使用できない場合に、アプリケーションがリモート サービスではなく、ローカル データ キャッシュを使用できるように、オフライン モードを有効にする方法についても学びました。  
+  
+## 次の手順  
+ 実際のアプリケーションではリモート サーバーから多数のユーザーのデータを取得しますが、サーバーは常に使用可能であるとは限らず、予告なく停止する可能性もあります。 アプリケーションを堅牢にするため、サービスが利用できない場合に状況に適切に対応する必要があります。 このチュートリアルには、サービスが利用できない場合に <xref:System.Net.WebException> をキャッチしてエラー メッセージを表示する try ブロックと catch ブロックが含まれています。 実稼働コードでは、このケースに対処するため、オフライン モードに切り替えることや、アプリケーションを終了すること、特定の機能へのアクセスを拒否することができます。  
+  
+ アプリケーションのセキュリティを向上させるため、配置する前に必ずアプリケーションとサーバーを十分にテストしてください。  
+  
+## 参照  
+ [クライアント アプリケーション サービス](../../../docs/framework/common-client-technologies/client-application-services.md)   
+ [クライアント アプリケーション サービスの概要](../../../docs/framework/common-client-technologies/client-application-services-overview.md)   
+ [方法 : クライアント アプリケーション サービスを構成する](../../../docs/framework/common-client-technologies/how-to-configure-client-application-services.md)   
+ [ASP.NET Web Site Administration Tool](../Topic/ASP.NET%20Web%20Site%20Administration%20Tool.md)   
+ [Creating and Configuring the Application Services Database for SQL Server](../Topic/Creating%20and%20Configuring%20the%20Application%20Services%20Database%20for%20SQL%20Server.md)   
+ [Walkthrough: Using ASP.NET Application Services](../Topic/Walkthrough:%20Using%20ASP.NET%20Application%20Services.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/TOC.md b/docs/framework/configure-apps/TOC.md
new file mode 100644
index 00000000000..1aa29946058
--- /dev/null
+++ b/docs/framework/configure-apps/TOC.md
@@ -0,0 +1,10 @@
+# [暗号化クラスの設定](configure-cryptography-classes.md)
+# [暗号化アルゴリズムへのオブジェクト ID の割り当て](map-object-identifiers-to-cryptography-algorithms.md)
+# [アセンブリ バージョンのリダイレクト](redirect-assembly-versions.md)
+# [アプリの構成](index.md)
+# [方法 : 発行者ポリシーを作成する](how-to-create-a-publisher-policy.md)
+# [方法: 自動バインディング リダイレクトを有効/無効にする](how-to-enable-and-disable-automatic-binding-redirection.md)
+# [方法 : DEVPATH を使用してアセンブリを指定する](how-to-locate-assemblies-by-using-devpath.md)
+# [アセンブリ バインディング リダイレクトのセキュリティ アクセス許可](assembly-binding-redirection-security-permission.md)
+# [アセンブリの場所の指定](specify-assembly-location.md)
+# [暗号化クラスへのアルゴリズム名の割り当て](map-algorithm-names-to-cryptography-classes.md)
diff --git a/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md b/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md
new file mode 100644
index 00000000000..4bf2605e3c0
--- /dev/null
+++ b/docs/framework/configure-apps/assembly-binding-redirection-security-permission.md
@@ -0,0 +1,48 @@
+---
+title: "アセンブリ バインディング リダイレクトのセキュリティ アクセス許可 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], バインディングのリダイレクト"
+  - "side-by-side 実行, アセンブリ バインディング リダイレクト"
+ms.assetid: 24a5cdff-7ed9-4195-93f3-edf6899019fc
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# アセンブリ バインディング リダイレクトのセキュリティ アクセス許可
+アプリケーション構成ファイルで明示的にアセンブリ バインディングをリダイレクトするには、セキュリティ アクセス許可が必要です。  これは、.NET Framework アセンブリおよびサードパーティ製アセンブリに適用されます。  アクセス許可は、[SecurityPermission クラス](frlrfSystemSecurityPermissionsSecurityPermissionClassTopic)の [BindingRedirects](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) フラグを設定することによって付与されます。  既定では、マネージ アセンブリにはアクセス許可が付与されていません。  
+  
+ セキュリティ アクセス許可は、Trusted ゾーン \(ローカル マシン\) および Intranet ゾーンで実行されているアプリケーションに付与されます。  Internet ゾーンで実行されているアプリケーションは、アセンブリ バインディングのリダイレクトの実行が禁止されています。  
+  
+ コンポーネントの発行者によって制御される発行者ポリシー ファイルまたは管理者によって制御されるマシン構成ファイルで実行されるアセンブリのリダイレクトには、アクセス許可は必要ありません。  ただし、明示的にアプリケーション構成ファイルの [\<publisherPolicy apply\= "いいえ」\/\>](../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md) 要素を使用して発行者ポリシーを無視する、アクセス許可はアプリケーションに必要です。  
+  
+ **BindingRedirects** フラグの既定のセキュリティ設定を次の表に示します。  
+  
+|ゾーン|BindingRedirects フラグの設定|  
+|---------|-----------------------------|  
+|Trusted ゾーン \(ローカル マシン\)|**ON**|  
+|Intranet ゾーン|**ON**|  
+|Internet ゾーン|**OFF**|  
+|Untrusted ゾーン|**OFF**|  
+  
+ 管理者は、これらのセキュリティ設定を変更して、特定のコンピューターで特定のシナリオをサポートしたり、制限したりすることができます。  **BindingRedirects** フラグの設定を既定から変更するツールはありません。管理者はユーザーのコンピューターで Security.config ファイルを手動で編集する必要があります。  
+  
+## 参照  
+ [Publisher Policy Files and Side\-by\-Side Execution](http://msdn.microsoft.com/ja-jp/97a042be-4d72-40c3-91c0-76fd36bdf133)   
+ [方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)   
+ [side\-by\-side 実行](../../../docs/framework/deployment/side-by-side-execution.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/configure-cryptography-classes.md b/docs/framework/configure-apps/configure-cryptography-classes.md
new file mode 100644
index 00000000000..2a4d11ce0a5
--- /dev/null
+++ b/docs/framework/configure-apps/configure-cryptography-classes.md
@@ -0,0 +1,46 @@
+---
+title: "暗号化クラスの設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーション構成, 暗号化"
+  - "構成ファイル [.NET Framework], 暗号化"
+  - "暗号アルゴリズム"
+  - "暗号化, クラス"
+  - "既定の暗号化"
+  - "セキュリティ [.NET Framework], 暗号化"
+ms.assetid: eee3ccb8-2c0d-4f35-b38d-6892a46c14e5
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# 暗号化クラスの設定
+コンピューターの管理者は、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] を使用して、.NET Framework および正しく作成されたアプリケーションが使用する既定の暗号化アルゴリズムおよびアルゴリズム実装を設定できます。たとえば、独自の暗号化アルゴリズム実装を持つエンタープライズは、その実装を、[!INCLUDE[winsdkshort](../../../includes/winsdkshort-md.md)] に付属する実装の代わりに既定の実装として使用できます。  暗号を使用するマネージ アプリケーションは常に特定の暗号化アルゴリズム実装をバインドするように選択できますが、暗号構成システムを使用して暗号オブジェクトを作成することをお勧めします。  
+  
+## このセクションの内容  
+ [暗号化クラスへのアルゴリズム名の割り当て](../../../docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md)  
+ 暗号化クラスにアルゴリズム名を割り当てる方法を説明します。  
+  
+ [暗号化アルゴリズムへのオブジェクト ID の割り当て](../../../docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md)  
+ 暗号化アルゴリズムにオブジェクト ID を割り当てる方法を説明します。  
+  
+## 関連項目  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)  
+ [!INCLUDE[winsdkshort](../../../includes/winsdkshort-md.md)] によって提供される暗号サービスの概要を説明します。  
+  
+ [暗号設定スキーマ](../../../docs/framework/configure-apps/file-schema/cryptography/index.md)  
+ アルゴリズムの表示名を、暗号化アルゴリズムを実装するクラスに割り当てる要素について説明します。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/TOC.md b/docs/framework/configure-apps/file-schema/TOC.md
new file mode 100644
index 00000000000..76754a2106b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/TOC.md
@@ -0,0 +1,6 @@
+# [<linkedConfiguration> 要素](linkedconfiguration-element.md)
+# [構成セクション スキーマ](configuration-sections-schema.md)
+# [<assemblyBinding> 要素](assemblybinding-element-for-configuration.md)
+# [構成ファイル スキーマ](index.md)
+# [アプリケーション設定のスキーマ](application-settings-schema.md)
+# [<configuration> 要素](configuration-element.md)
diff --git a/docs/framework/configure-apps/file-schema/application-settings-schema.md b/docs/framework/configure-apps/file-schema/application-settings-schema.md
new file mode 100644
index 00000000000..1469112e695
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/application-settings-schema.md
@@ -0,0 +1,99 @@
+---
+title: "アプリケーション設定のスキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定, スキーマ [Windows フォーム]"
+  - "構成スキーマ [.NET Framework], アプリケーション設定"
+  - "スキーマ (アプリケーション設定)"
+  - "Windows フォーム, アプリケーション設定スキーマ"
+ms.assetid: 5797fcff-6081-4e8c-bebf-63d9c70cf14b
+caps.latest.revision: 3
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 3
+---
+# アプリケーション設定のスキーマ
+アプリケーション設定によって、Windows フォームまたは ASP.NET アプリケーションはアプリケーション スコープおよびユーザー スコープの設定を格納および取得できます。  ここにおける「設定」は、データベース接続文字列からユーザーの既定のウィンドウ サイズにいたるまでのアプリケーションまたは現在のユーザー固有の情報を意味します。  
+  
+ 既定では、Windows フォーム アプリケーションのアプリケーション設定は、.NET 構成システムを使用して設定を XML 構成ファイルに格納する <xref:System.Configuration.LocalFileSettingsProvider> を使用します。  アプリケーション設定が使用するファイルの詳細については、「[アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)」を参照してください。  
+  
+ アプリケーション設定は、使用する構成ファイルで次の要素を定義します。  
+  
+|要素|説明|  
+|--------|--------|  
+|`<applicationSettings>` 要素|アプリケーション固有のすべての `<setting>` タグが含まれます。|  
+|`<userSettings>` 要素|現在のユーザー固有のすべての `<setting>` タグが含まれます。|  
+|`<setting>` 要素|設定を定義します。  `<applicationSettings>` または `<userSettings>` の子要素です。|  
+|`<value>` 要素|設定の値を定義します。  `<setting>` の子要素です。|  
+  
+## \<applicationSettings\> 要素  
+ この要素には \<、クライアント コンピューターのアプリケーションのインスタンス固有のすべての構成\> タグが含まれます。  属性は定義されません。  
+  
+## \<userSettings\> 要素  
+ この要素は \<\>、アプリケーションを使用しているユーザー固有のすべての構成 タグが含まれます。  属性は定義されません。  
+  
+## \<構成\> 要素  
+ この要素は、設定を定義します。  次の属性を持ちます。  
+  
+|要素|説明|  
+|--------|--------|  
+|`name`|必須。  設定の一意の ID です。  Visual Studio を使用して作成された設定は `ProjectName``.Properties.Settings` という名前で保存されます。|  
+|`serializedAs`|必須。  テキストに値をシリアル化するために使用する形式です。  次の値を指定できます。<br /><br /> -   `string`:   値は、<xref:System.ComponentModel.TypeConverter> を使用して文字列としてシリアル化されます。<br />-   `xml`.  値は、XML シリアル化を使用してシリアル化されます。<br />-   `binary`:   値は、バイナリ シリアル化を使用してテキストでエンコードされたバイナリとしてシリアル化されます。<br />-   `custom`:   設定プロバイダーは、この設定に固有の情報を保有してシリアル化および逆シリアル化を実行します。<br />-   バイナリまたはカスタムのシリアル化を使用する場合は、独自に設定クラスを定義し、<xref:System.Configuration.SettingsSerializeAsAttribute> を使用してバイナリまたはカスタムのシリアル化を指定する必要があります。|  
+  
+## \<値要素\>  
+ この要素には、設定の値が含まれます。  
+  
+## 使用例  
+ 2 つのアプリケーション スコープの設定および 2 つのユーザー スコープの設定を定義するアプリケーション設定ファイルのコード例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+    <configSections>  
+        <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >  
+            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+        </sectionGroup>  
+        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >  
+            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />  
+        </sectionGroup>  
+    </configSections>  
+    <applicationSettings>  
+        <WindowsApplication1.Properties.Settings>  
+            <setting name="Cursor" serializeAs="String">  
+                <value>Default</value>  
+            </setting>  
+            <setting name="DoubleBuffering" serializeAs="String">  
+                <value>False</value>  
+            </setting>  
+        </WindowsApplication1.Properties.Settings>  
+    </applicationSettings>  
+    <userSettings>  
+        <WindowsApplication1.Properties.Settings>  
+            <setting name="FormTitle" serializeAs="String">  
+                <value>Form1</value>  
+            </setting>  
+            <setting name="FormSize" serializeAs="String">  
+                <value>595, 536</value>  
+            </setting>  
+        </WindowsApplication1.Properties.Settings>  
+    </userSettings>  
+</configuration>  
+```  
+  
+## 参照  
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md b/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md
new file mode 100644
index 00000000000..da1a6d2e9b2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;configuration&gt; の &lt;assemblyBinding&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/assemblyBinding"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<assemblyBinding> 要素"
+  - "assemblyBinding 要素"
+ms.assetid: 6cc55983-b894-449b-8e26-b258e53939cd
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# &lt;configuration&gt; の &lt;assemblyBinding&gt; 要素
+構成レベルでのアセンブリ バインディング ポリシーを指定します。  
+  
+## 構文  
+  
+```  
+<assemblyBinding    
+   xmlns="urn:schemas-microsoft-com:asm.v1">  
+</assemblyBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`xmlns`|必須の属性です。<br /><br /> アセンブリのバインディングに必要な XML 名前空間を指定します。  値として、文字列 "urn:schemas\-microsoft\-com:asm.v1" を使用します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<linkedConfiguration\> 要素](../../../../docs/framework/configure-apps/file-schema/linkedconfiguration-element.md)|インクルードする構成ファイルを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+ [\<linkedConfiguration\> 要素](../../../../docs/framework/configure-apps/file-schema/linkedconfiguration-element.md) は、アセンブリ構成設定を複製するのではなく、既知の場所にあるアセンブリ構成ファイルをアプリケーション構成ファイルにインクルードできるようにすることで、コンポーネント アセンブリの管理を簡素化します。  
+  
+> [!NOTE]
+>  Windows side\-by\-side マニフェストを使用するアプリケーションに対しては、`<linkedConfiguration>` 要素がサポートされません。  
+  
+## 使用例  
+ ローカル ハード ディスク上の構成ファイルをインクルードする方法を、次のコード例に示します。  
+  
+```  
+<configuration>  
+   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+      <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>  
+   </assemblyBinding>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/compiler/TOC.md b/docs/framework/configure-apps/file-schema/compiler/TOC.md
new file mode 100644
index 00000000000..cc068005e31
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/TOC.md
@@ -0,0 +1,5 @@
+# [<compilers> 要素](compilers-element.md)
+# [コンパイラおよび言語プロバイダー設定のスキーマ](index.md)
+# [<compiler> 要素](compiler-element.md)
+# [<system.codedom> 要素](system-codedom-element.md)
+# [<providerOption> 要素](provideroption-element.md)
diff --git a/docs/framework/configure-apps/file-schema/compiler/compiler-element.md b/docs/framework/configure-apps/file-schema/compiler/compiler-element.md
new file mode 100644
index 00000000000..3a61853adf4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/compiler-element.md
@@ -0,0 +1,111 @@
+---
+title: "&lt;compiler&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#compiler"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.codedom/compilers/compiler"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<compiler> 要素"
+  - "コンパイラ構成属性"
+  - "コンパイラ構成要素, <compiler> 要素"
+  - "compiler 要素"
+ms.assetid: 7a151659-b803-4c27-b5ce-1c4aa0d5a823
+caps.latest.revision: 20
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 20
+---
+# &lt;compiler&gt; 要素
+言語プロバイダーのコンパイラ設定属性を指定します。  
+  
+## 構文  
+  
+```  
+<compiler  
+  language="languageName[;...;...]"  
+  extension="fileExtension[;...;...]"  
+  type="typeName, assemblyName"  
+  warningLevel="number"  
+  compilerOptions="option1 option2"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`compilerOptions`|省略可能な属性。<br /><br /> コンパイル用のその他のコンパイラ固有引数を指定します。  `compilerOptions` 属性の値については、通常、コンパイラのコンパイラ オプションのトピックで説明されています。  Visual Studio 2005 のドキュメントで「コンパイラ オプション」というキーワードを検索すると、コンパイラのオプションについての説明を見つけることができます。|  
+|`extension`|必須の属性です。<br /><br /> 言語プロバイダーのソース ファイルで使用されるファイル名拡張子のセミコロン区切りのリストを指定します。  たとえば、".cs" とします。|  
+|`language`|必須の属性です。<br /><br /> 言語プロバイダーでサポートされる言語名のセミコロン区切りのリストを指定します。  たとえば、"c\#;cs;csharp" とします。|  
+|`type`|必須の属性です。<br /><br /> 言語プロバイダーの型名と、プロバイダーの実装が含まれているアセンブリの名前を指定します。  型名は、「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」で定義されている要件を満たす必要があります。|  
+|`warningLevel`|省略可能な属性。<br /><br /> コンパイラの既定の警告レベルを指定します。これにより、言語プロバイダーでエラーとして処理されるコンパイラの警告レベルが決定されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<providerOption\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/provideroption-element.md)|言語プロバイダーのコンパイラ バージョン属性を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|[\<system.codedom\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md)|利用可能な言語プロバイダー用のコンパイラ構成設定を指定します。|  
+|[\<compilers\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)|コンパイラの設定要素用のコンテナーです。0 個以上の `<compiler>` 要素が含まれます。|  
+  
+## 解説  
+ 各 `<compiler>` 要素では、特定の言語プロバイダー用のコンパイラ設定属性を指定します。  プロバイダーでは、特定の言語用に <xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスを拡張します。`<compiler>` 要素では、言語プロバイダー用にコンパイラとコード ジェネレーターの設定を定義します。  
+  
+ .NET Framework では、マシン構成ファイル \(Machine.config\) にコンパイラの初期設定を定義します。  開発者やコンパイラの販売元では、新しい <xref:System.CodeDom.Compiler.CodeDomProvider> 実装用に構成の設定を追加できます。  コンピューター上の言語プロバイダーおよびコンパイラの構成の設定をプログラムで列挙するには、<xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ アプリケーションまたは Web の構成ファイル内のコンパイラ要素によって、マシン構成ファイル内の設定を補足またはオーバーライドできます。  複数のプロバイダー実装で同じ言語名または同じファイル拡張子が設定されている場合は、最後に一致した設定で、その言語名またはファイル拡張子のそれまでの設定済みプロバイダーがオーバーライドされます。  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイルとアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ 一般的なコンパイラ設定要素を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.codedom>  
+    <compilers>  
+      <!-- zero or more compiler elements -->  
+      <compiler  
+        language="c#;cs;csharp"  
+        extension=".cs"  
+        type="Microsoft.CSharp.CSharpCodeProvider, System,   
+          Version=2.0.3600.0, Culture=neutral,   
+          PublicKeyToken=b77a5c561934e089"  
+        compilerOptions="/optimize"  
+        warningLevel="1" />  
+    </compilers>  
+  </system.codedom>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.CodeDom.Compiler.CompilerInfo>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<compilers\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)   
+ [完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)   
+ [compilation の compilers の compiler 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/f7d6b078-5d42-4134-b3f7-62e1aba1df1e)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/compiler/compilers-element.md b/docs/framework/configure-apps/file-schema/compiler/compilers-element.md
new file mode 100644
index 00000000000..2283694b30a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/compilers-element.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;compilers&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#compilers"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.codedom/compilers"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<compilers> 要素"
+  - "コンパイラ構成要素, <compilers> 要素"
+  - "compilers 要素"
+ms.assetid: d40fba59-98f9-4783-ae0c-2ebea27ce77b
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;compilers&gt; 要素
+コンパイラの設定要素のコンテナー; [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) 内に含まれています。また、より多くの要素を示します。  
+  
+## 構文  
+  
+```  
+<compilers>  
+  <compiler ... />  
+</compilers>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<compiler\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)|言語プロバイダーのコンパイラ設定属性を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|[\<system.codedom\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md)|利用可能な言語プロバイダー用のコンパイラ構成設定を指定します。|  
+  
+## 解説  
+ [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md) 要素はコンピューター上の言語プロバイダー用のコンパイラの構成設定が含まれます。  [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) の各要素は、特定の言語プロバイダー用のコンパイラ設定属性を指定します。  
+  
+ .NET Framework では、マシン構成ファイル \(Machine.config\) 内にコンパイラと言語プロバイダーの初期設定が定義されています。  開発者やコンパイラの販売元では、新しい <xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> 実装用に構成の設定を追加できます。  コンピューター上の言語プロバイダーおよびコンパイラの構成の設定をプログラムで列挙するには、<xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A?displayProperty=fullName> メソッドを使用します。  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイルとアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ 一般的なコンパイラ設定要素を次の例に示します。  
+  
+```  
+<configuration>  
+   <system.codedom>  
+     <compilers>  
+       <!-- zero or more compiler elements -->  
+       <compiler   
+          language="c#;cs;csharp"   
+          extension=".cs"  
+          type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+          compilerOptions=""    
+          warningLevel="1" />  
+     </compilers>  
+   </system.codedom>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.CodeDom.Compiler.CompilerInfo>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [コンパイラおよび言語プロバイダー設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/compiler/index.md)   
+ [\<compiler\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/compiler/index.md b/docs/framework/configure-apps/file-schema/compiler/index.md
new file mode 100644
index 00000000000..e10ffa3c386
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/index.md
@@ -0,0 +1,75 @@
+---
+title: "コンパイラおよび言語プロバイダー設定のスキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンパイラ構成要素"
+  - "コンパイラ構成要素, スキーマ"
+  - "コンパイラ構成設定"
+  - "コンパイラ構成設定, スキーマ"
+  - "構成スキーマ [.NET Framework], コンパイラ設定"
+  - "構成の設定 [.NET Framework], コンパイラ"
+  - "言語プロバイダー"
+  - "言語プロバイダー, 設定スキーマ"
+ms.assetid: c020b139-8699-4f0d-9ac9-70d0c5b2a8c8
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# コンパイラおよび言語プロバイダー設定のスキーマ
+コンパイラおよび言語プロバイダー設定では、利用可能な言語プロバイダー用のコンパイラの設定要素を指定します。  各コンパイラ設定要素では、コード プロバイダーの型名、コンパイラ パラメーター、サポートされる言語名、およびサポートされるファイル拡張子を指定します。  
+  
+ .NET Framework では、マシン構成ファイル \(Machine.config\) にコンパイラの初期設定を定義します。  開発者やコンパイラの販売元では、新しい <xref:System.CodeDom.Compiler.CodeDomProvider> 実装用に構成の設定を追加できます。  コンピューター上の言語プロバイダーおよびコンパイラの構成の設定をプログラムで列挙するには、<xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ [\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<system.codedom\>](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md)  
+  
+ [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)  
+  
+ [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.codedom\>](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md)|利用可能な言語プロバイダー用のコンパイラ構成設定を指定します。|  
+|[\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)|コンパイラの設定要素のコンテナー; [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) 内に含まれています。また、より多くの要素を示します。|  
+|[\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)|言語プロバイダーのコンパイラ設定属性を指定します。|  
+  
+## 使用例  
+ 一般的なコンパイラ設定要素を次の例に示します。  
+  
+```  
+<configuration>  
+   <system.codedom>  
+     <compilers>  
+       <!-- zero or more compiler elements -->  
+       <compiler  
+          language="c#;cs;csharp"  
+          extension=".cs"  
+          type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+          compilerOptions=""  
+          warningLevel="1" />  
+     </compilers>  
+   </system.codedom>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.CodeDom.Compiler.CompilerInfo>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<compiler\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/compiler/provideroption-element.md b/docs/framework/configure-apps/file-schema/compiler/provideroption-element.md
new file mode 100644
index 00000000000..ec6bb7dbbbc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/provideroption-element.md
@@ -0,0 +1,104 @@
+---
+title: "&lt;providerOption&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "provideroption"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<provideroption> 要素"
+  - "provideroption 要素"
+  - "providerOptions"
+ms.assetid: 014f2e0b-c0b5-4fc4-92d3-73f02978b2a1
+caps.latest.revision: 22
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 22
+---
+# &lt;providerOption&gt; 要素
+言語プロバイダーのコンパイラ バージョン属性を指定します。  
+  
+## 構文  
+  
+```  
+<providerOption  
+  name="option-name"  
+  value="option-value"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`name`|必須の属性です。<br /><br /> オプションの名前を指定します \(たとえば "CompilerVersion"\)。|  
+|`value`|必須の属性です。<br /><br /> オプションの値を指定します \(たとえば "v3.5"\)。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|[\<system.codedom\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md)|利用可能な言語プロバイダー用のコンパイラ構成設定を指定します。|  
+|[\<compilers\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)|コンパイラの設定要素用のコンテナーです。0 個以上の `<compiler>` 要素が含まれます。|  
+|[\<compiler\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)|言語プロバイダーのコンパイラ設定属性を指定します。|  
+  
+## 解説  
+ .NET Framework Version 3.5 では、CodeDOM \(Code Document Object Model\) コード プロバイダーは、`<providerOption>` 要素を使用してプロバイダー固有のオプションをサポートできます。  
+  
+ .NET Framework 3.5 には、更新された .NET Framework 2.0 アセンブリと、新しい型を含む新しい Version 3.5 アセンブリが用意されています。  Microsoft C\# および Visual Basic のコード プロバイダーは .NET Framework 2.0 アセンブリに含まれますが、Version 3.5 のコンパイラをサポートするように更新されています。  既定では、更新されたコード プロバイダーは Version 2.0 のコンパイラ用のコードを生成します。  `<providerOption>` 要素を使用して、対象のコンパイラのバージョンを 3.5 に変更できます。  これを行うには、`name` 属性に "CompilerVersion" を指定し、`value` 属性に "v3.5" を指定します。  バージョン番号の前に小文字の "v" を指定する必要があります。  
+  
+ `<providerOption>` 要素を .NET Framework 2.0 の Machine.config ファイルまたはルートの Web.config ファイルに追加することで、バージョンの指定をグローバルにすることができます。  Machine.config ファイルで既定のコンパイラのバージョンを 3.5 に更新した場合は、アプリケーション構成ファイルで `<providerOption>` 要素を使用することにより、アプリケーションごとに 2.0 に戻すことができます。  
+  
+ CodeDOM コード プロバイダーの実装では、<xref:System.Collections.Generic.IDictionary%602> 型の `providerOptions` パラメーターを受け取るコンストラクターを用意することで、カスタム オプションを処理できます。  
+  
+## 使用例  
+ C\# コード プロバイダーの Version 3.5 が使用されるように指定する方法の例を次に示します。  
+  
+```  
+<configuration>  
+  <system.codedom>  
+    <compilers>  
+      <!-- zero or more compiler elements -->  
+      <compiler  
+        language="c#;cs;csharp"  
+        extension=".cs"  
+        type="Microsoft.CSharp.CSharpCodeProvider, System,   
+          Version=2.0.3600.0, Culture=neutral,   
+          PublicKeyToken=b77a5c561934e089"  
+        compilerOptions="/optimize"  
+        warningLevel="1" >  
+          <providerOption  
+            name="CompilerVersion"  
+            value="v3.5" />  
+      </compiler>  
+    </compilers>  
+  </system.codedom>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.CodeDom.Compiler.CompilerInfo>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<compilers\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)   
+ [完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)   
+ [compilation の compilers の compiler 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/f7d6b078-5d42-4134-b3f7-62e1aba1df1e)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md b/docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md
new file mode 100644
index 00000000000..fbff2cfaea0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md
@@ -0,0 +1,104 @@
+---
+title: "&lt;system.codedom&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.codedom"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#system.codedom"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.codedom> 要素"
+  - "コンパイラ構成要素, <system.codedom> 要素"
+  - "system.codedom 要素"
+ms.assetid: 672a68f7-e69f-4479-ac30-e980085ec4fe
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# &lt;system.codedom&gt; 要素
+利用可能な言語プロバイダー用のコンパイラ構成設定を指定します。  
+  
+## 構文  
+  
+```  
+<system.codedom>  
+  <compilers> ... </compilers>  
+</system.codedom>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md)|コンパイラの設定要素のコンテナー; [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) 内に含まれています。また、より多くの要素を示します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+  
+## .NET Framework Version 2.0  
+ [\<system.codedom\>](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md) 要素は <xref:Microsoft.CSharp.CSharpCodeProvider> と <xref:Microsoft.VisualBasic.VBCodeProvider>などの .NET Framework と、インストールされている既定のプロバイダーの他に、コンピューターにインストールされる言語プロバイダーのコンパイラの構成設定が含まれます。  [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md) 要素が含まれています [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) のゼロ以上の要素を紹介します。  [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) の各要素は、特定の言語プロバイダー用のコンパイラ設定属性を指定します。  
+  
+ 開発者やコンパイラの販売元では、新しい <xref:System.CodeDom.Compiler.CodeDomProvider> 実装用にマシンの構成ファイル \(Machine.config\) に構成の設定を追加できます。  <xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A?displayProperty=fullName> メソッドを使用して、既定の言語プロバイダーおよびコンピューターのコンパイラ設定で識別される言語プロバイダーの両方をプログラムで列挙します。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、.NET Framework に用意されている既定の言語プロバイダーは [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md) 要素で識別されます。  .NET Framework version 2.0 では、既定の言語プロバイダーは [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md) 要素では識別されませんが、<xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A> のメソッドを使用して列挙できます。  
+  
+## .NET Framework Version 1.0 および 1.1  
+ [\<system.codedom\>](../../../../../docs/framework/configure-apps/file-schema/compiler/system-codedom-element.md) 要素はコンピューター上の言語プロバイダー用のコンパイラの構成設定が含まれます。  [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compilers-element.md) 要素が含まれています [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) のゼロ以上の要素を紹介します。  [\<コンパイラ\>](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md) の各要素は、特定の言語プロバイダー用のコンパイラ設定属性を指定します。  
+  
+ .NET Framework では、マシン構成ファイル \(Machine.config\) にコンパイラの初期設定を定義します。  開発者やコンパイラの販売元では、新しい <xref:System.CodeDom.Compiler.CodeDomProvider> 実装用に構成の設定を追加できます。  コンピューター上の言語プロバイダーおよびコンパイラの構成の設定をプログラムで列挙するには、<xref:System.CodeDom.Compiler.CodeDomProvider.GetAllCompilerInfo%2A?displayProperty=fullName> メソッドを使用します。  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイルとアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ 一般的なコンパイラ設定を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.codedom>  
+    <compilers>  
+      <!-- zero or more compiler elements -->  
+      <compiler   
+        language="c#;cs;csharp"  
+        extension=".cs"  
+        type="Microsoft.CSharp.CSharpCodeProvider, System,   
+          Version=1.0.5000.0, Culture=neutral,   
+          PublicKeyToken=b77a5c561934e089"  
+        compilerOptions=""  
+        warningLevel="1" />  
+    </compilers>  
+  </system.codedom>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.CodeDom.Compiler.CompilerInfo>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [コンパイラおよび言語プロバイダー設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/compiler/index.md)   
+ [\<compiler\> 要素](../../../../../docs/framework/configure-apps/file-schema/compiler/compiler-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/configuration-element.md b/docs/framework/configure-apps/file-schema/configuration-element.md
new file mode 100644
index 00000000000..626a3fc763b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/configuration-element.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;configuration&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<configuration> 要素"
+  - "configuration 要素"
+  - "コンテナー タグ, <configuration> 要素"
+ms.assetid: 2ec1c9dc-2e5c-4ef0-9958-81670ab88449
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;configuration&gt; 要素
+共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。  
+  
+ **\<configuration\>**  
+  
+## 構文  
+  
+```  
+  
+      <configuration>   
+   <!-- configuration settings -->   
+</configuration>  
+```  
+  
+## 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<assemblyBinding\> 要素](../../../../docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md)|構成レベルでのアセンブリ バインディング ポリシーを指定します。|  
+|[スタートアップ設定スキーマ](../../../../docs/framework/configure-apps/file-schema/startup/index.md)|スタートアップ設定スキーマのすべての要素。|  
+|[ランタイム設定スキーマ](../../../../docs/framework/configure-apps/file-schema/runtime/index.md)|ランタイム設定スキーマのすべての要素。|  
+|[リモート処理設定スキーマ](http://msdn.microsoft.com/ja-jp/dc2d1e62-9af7-4ca1-99fd-98b93bb4db9e)|リモート処理設定スキーマのすべての要素。|  
+|[ネットワーク設定スキーマ](../../../../docs/framework/configure-apps/file-schema/network/index.md)|ネットワーク設定スキーマのすべての要素。|  
+|[暗号設定スキーマ](../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)|暗号設定スキーマのすべての要素。|  
+|[構成セクション スキーマ](../../../../docs/framework/configure-apps/file-schema/configuration-sections-schema.md)|構成セクション設定スキーマのすべての要素。|  
+|[トレースおよびデバッグ設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)|トレースおよびデバッグ設定スキーマのすべての要素。|  
+|[ASP.NET 設定スキーマ](http://msdn.microsoft.com/ja-jp/116608f3-c03d-4413-9fc7-978703e18b0f)|ASP.NET 構成スキーマのすべての要素。これには、ASP.NET Web サイトおよびアプリケーションを構成するための要素が含まれます。  Web.config ファイルで使用します。|  
+|[XML Web サービス設定スキーマ](http://msdn.microsoft.com/ja-jp/f84d6d55-1add-4eb7-ae46-33df5833ea2e)|Web サービス設定スキーマのすべての要素。|  
+|[Web 設定スキーマ](../../../../docs/framework/configure-apps/file-schema/web/index.md)|IIS などのホスト アプリケーションと ASP.NET の連携を構成する要素も含め、Web 設定スキーマのすべての要素。  aspnet.config ファイルで使用します。|  
+  
+## 解説  
+ 各構成ファイルは **\<configuration\>** の 1 要素を一つだけ含める必要があります。  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/configuration-sections-schema.md b/docs/framework/configure-apps/file-schema/configuration-sections-schema.md
new file mode 100644
index 00000000000..1aa90bbfd27
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/configuration-sections-schema.md
@@ -0,0 +1,55 @@
+---
+title: "構成セクション スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成スキーマ [.NET Framework], カスタム設定 (構成ファイルの)"
+  - "構成のセクション [.NET Framework]"
+  - "構成の設定 [.NET Framework], カスタム"
+  - "カスタム要素"
+  - "要素 [.NET Framework], カスタム設定 (構成ファイルの)"
+  - "スキーマ構成の設定"
+ms.assetid: 6e4cc793-c526-4007-b4e9-37d56295f2cb
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 構成セクション スキーマ
+構成セクション スキーマには、構成ファイルにカスタム設定を追加する要素が含まれています。  
+  
+ [\<configuration\>](../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<configSections\>](http://msdn.microsoft.com/ja-jp/8a5cbc84-0257-4c2e-80a9-a064fe7c896b)  
+  
+ [\<&#91;clear&#93;\>](http://msdn.microsoft.com/ja-jp/b0ce3c91-89fa-4bb5-a995-30e21a61036b)  
+  
+ [\<削除\>](http://msdn.microsoft.com/ja-jp/6e2b2d45-113d-4d10-9f8e-0b15fc86bb98)  
+  
+ [\<セクション\>](http://msdn.microsoft.com/ja-jp/51c9d658-c275-4ab2-aa66-c5d5b5289570)  
+  
+ [\<sectionGroup\>](http://msdn.microsoft.com/ja-jp/45fbeb5c-26c7-4c68-b732-b3f1e62c53bf)  
+  
+|要素|説明|  
+|--------|--------|  
+|[configSections の clear 要素 \(全般設定スキーマ\)](http://msdn.microsoft.com/ja-jp/b0ce3c91-89fa-4bb5-a995-30e21a61036b)|以前に定義したセクションとセクション グループをすべて消去します。|  
+|[configSections 要素 \(全般設定スキーマ\)](http://msdn.microsoft.com/ja-jp/8a5cbc84-0257-4c2e-80a9-a064fe7c896b)|構成セクションと名前空間の宣言を指定します。|  
+|[configSections の remove 要素 \(全般設定スキーマ\)](http://msdn.microsoft.com/ja-jp/6e2b2d45-113d-4d10-9f8e-0b15fc86bb98)|定義済みのセクションまたはセクション グループを削除します。|  
+|[configSections の section 要素 \(全般設定スキーマ\)](http://msdn.microsoft.com/ja-jp/51c9d658-c275-4ab2-aa66-c5d5b5289570)|構成セクションの宣言を指定します。|  
+|[configSections の sectionGroup 要素 \(全般設定スキーマ\)](http://msdn.microsoft.com/ja-jp/45fbeb5c-26c7-4c68-b732-b3f1e62c53bf)|構成セクションの名前空間を定義します。|  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/TOC.md b/docs/framework/configure-apps/file-schema/cryptography/TOC.md
new file mode 100644
index 00000000000..63cf19f6184
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/TOC.md
@@ -0,0 +1,9 @@
+# [暗号設定の <mscorlib> 要素](mscorlib-element-for-cryptography-settings.md)
+# [<cryptoNameMapping> 要素](cryptonamemapping-element.md)
+# [<oidMap> 要素](oidmap-element.md)
+# [<nameEntry> 要素](nameentry-element.md)
+# [<cryptographySettings> 要素](cryptographysettings-element.md)
+# [<cryptoClasses> 要素](cryptoclasses-element.md)
+# [<oidEntry> 要素](oidentry-element.md)
+# [暗号設定スキーマ](index.md)
+# [<cryptoClass> 要素](cryptoclass-element.md)
diff --git a/docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md b/docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md
new file mode 100644
index 00000000000..c9cfb1aedb4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;cryptoClass&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/cryptoNameMapping/cryptoClasses/cryptoClass"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#cryptoClass"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<cryptoClass> 要素"
+  - "cryptoClass 要素"
+ms.assetid: 03db52ef-010e-44ea-b6fd-b9c900ecad50
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;cryptoClass&gt; 要素
+[\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md) 要素の表示名への割り当てが設定されている暗号化クラスが含まれています。  
+  
+## 構文  
+  
+```  
+<cryptoClass customClassName="fully qualified type name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`customClassName`|必須の属性です。<br /><br /> 暗号化クラスの情報が含まれます。  この属性を使用して、クラスに短い名前を付けます。  「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」で指定されている要件に合った文字列を指定する必要があります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`cryptoClasses`|[\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md) 要素の表示名への割り当てが設定されている暗号化クラスを示します。|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+|`cryptoNameMapping`|クラスと表示名との割り当てが含まれます。|  
+|`mscorlib`|[\<cryptographySettings\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md) 要素が含まれています。|  
+  
+## 使用例  
+ 次の例のように暗号化クラスを参照し、ランタイムを構成するために使用 **\<cryptoClass\>** 要素。  その後、文字列 "RSA" を <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A?displayProperty=fullName> メソッドに渡し、<xref:System.Security.Cryptography.AsymmetricAlgorithm.Create%2A> メソッドを使用して `MyCryptoRSAClass` オブジェクトを取得できます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RSA" class="MyCryptoRSA"/>  
+            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"  
+                       class="MyCryptoRSA"/>  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/cryptoclasses-element.md b/docs/framework/configure-apps/file-schema/cryptography/cryptoclasses-element.md
new file mode 100644
index 00000000000..9556c05e084
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/cryptoclasses-element.md
@@ -0,0 +1,91 @@
+---
+title: "&lt;cryptoClasses&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/cryptoNameMapping/cryptoClasses"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#cryptoClasses"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<cryptoClasses> 要素"
+  - "cryptoClasses 要素"
+ms.assetid: 290d5f96-946d-4f02-babb-1d31ec0b8295
+caps.latest.revision: 16
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# &lt;cryptoClasses&gt; 要素
+[\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md) 要素の表示名への割り当てが設定されている暗号化クラスを示します。  
+  
+## 構文  
+  
+```  
+<cryptoClasses>   
+</cryptoClasses>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<cryptoClass\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md)|**\<nameEntry\>** 要素の表示名への割り当てが設定されている暗号化クラスが含まれています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+|`cryptoNameMapping`|クラスと表示名との割り当てが含まれます。|  
+|`mscorlib`|`cryptographySettings` 要素を含みます。|  
+  
+## 使用例  
+ 次の例のように暗号化クラスを参照し、ランタイムを構成するために使用 **\<cryptoClass\>** 要素。  その後、文字列 "RSA" を <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A?displayProperty=fullName> メソッドに渡し、<xref:System.Security.Cryptography.AsymmetricAlgorithm.Create%2A> メソッドを使用して `MyCryptoRSAClass` オブジェクトを取得できます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+               <!-- Other cryptography classes go here. -->  
+            </cryptoClasses>  
+            <nameEntry name="RSA" class="MyCryptoRSA"/>  
+            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"  
+                       class="MyCryptoRSA"/>  
+             <!-- Mappings to other cryptography classes go here. -->  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Security.Cryptography>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [System.Security.Cryptography.CryptoConfig.CreateFromName](frlrfSystemSecurityCryptographyCryptoConfigClassCreateFromNameTopic)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md b/docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md
new file mode 100644
index 00000000000..4ec6a2c0956
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md
@@ -0,0 +1,91 @@
+---
+title: "&lt;cryptographySettings&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#cryptographySettings"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<cryptographySettings> 要素"
+  - "cryptographySettings 要素"
+ms.assetid: 6201b7da-bcb7-49f7-b9f5-ba1fe05573b9
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;cryptographySettings&gt; 要素
+暗号に関する設定が含まれます。  
+  
+## 構文  
+  
+```  
+  
+      <cryptographySettings>   
+</crytopgraphySettings>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<cryptoNameMapping\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md)|クラスと表示名との割り当てが含まれます。|  
+|[\<oidMap\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md)|クラスへの ASN.1 オブジェクト識別子 \(OID\) 割り当てが含まれます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`mscorlib`|`cryptographySettings` 要素を含みます。|  
+  
+## 使用例  
+ 次の例では、暗号化の名前の割り当てと OID 割り当てを含む使用 **\<cryptographySettings\>** 要素。  この例では、[System.Security.Cryptography.HashAlgorithm.Create](frlrfSystemSecurityCryptographyHashAlgorithmClassCreateTopic) が `MyHashClass` オブジェクトを返し、`MyCryptoClass` クラスがオブジェクト識別子 1.3.36.2.1 に割り当てられるようにランタイムが構成されます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyHash="MyHashClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+               <cryptoClass   MyCrypto="MyCryptoClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="System.Security.Cryptography.HashAlgorithm"  
+                       class="MyHash"/>  
+         </cryptoNameMapping>  
+         <oidMap>  
+            <oidEntry OID="1.3.36.3.2.1"   name="MyCryptoClass"/>  
+         </oidMap>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md b/docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md
new file mode 100644
index 00000000000..d9b80a90cdf
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;cryptoNameMapping&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#cryptoNameMapping"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/cryptoNameMapping"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<cryptoNameMapping> 要素"
+  - "cryptoNameMapping 要素"
+ms.assetid: c59c9494-149b-4ce6-b38d-371f896ae85c
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# &lt;cryptoNameMapping&gt; 要素
+クラスと表示名との割り当てが含まれます。  
+  
+## 構文  
+  
+```  
+  
+      <cryptoNameMapping>   
+</cryptoNameMapping>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`cryptoClasses`|**\<nameEntry\>** 要素の表示名への割り当てが設定されている暗号化クラスを示します。|  
+|`nameEntry`|クラス名をアルゴリズムの表示名に割り当てます。これにより、1 つのクラスに複数の表示名を割り当てることができるようになります。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+|`cryptoNameMapping`|クラスと表示名との割り当てが含まれます。|  
+|`mscorlib`|cryptographySettings\>  \<要素を含みます。|  
+  
+## 使用例  
+ 次の例では、暗号化クラスを参照し、ランタイムを構成するために **\<cryptoNameMapping\>** 要素を使用する方法を示します。  その後、文字列 "RSA" を <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A?displayProperty=fullName> メソッドに渡し、<xref:System.Security.Cryptography.AsymmetricAlgorithm.Create%2A> メソッドを使用して `MyCryptoRSAClass` オブジェクトを取得できます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RSA" class="MyCryptoRSA"/>  
+            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"  
+                       class="MyCryptoRSA"/>  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/index.md b/docs/framework/configure-apps/file-schema/cryptography/index.md
new file mode 100644
index 00000000000..ff8651a3b95
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/index.md
@@ -0,0 +1,66 @@
+---
+title: "暗号設定スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成スキーマ [.NET Framework], 暗号化"
+  - "構成のセクション [.NET Framework]"
+  - "構成の設定 [.NET Framework], 暗号化"
+  - "暗号化, 割り当て (アルゴリズム名の)"
+  - "暗号化, 設定スキーマ"
+  - "要素 [.NET Framework], 暗号化"
+  - "スキーマ構成の設定"
+ms.assetid: 1f55050a-b2a3-4868-a3c0-da20826150f3
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# 暗号設定スキーマ
+暗号設定スキーマには、アルゴリズムの表示名を暗号化アルゴリズムを実装するクラスに割り当てる方法を指定する要素が含まれます。  
+  
+ [\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<mscorlib\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/mscorlib-element-for-cryptography-settings.md)  
+  
+ [\<cryptographySettings\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md)  
+  
+ [\<cryptoNameMapping\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md)  
+  
+ [\<cryptoClasses\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclasses-element.md)  
+  
+ [\<cryptoClass\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md)  
+  
+ [\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md)  
+  
+ [\<oidMap\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md)  
+  
+ [\<oidEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md)  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<cryptoClasses\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclasses-element.md)|**\<nameEntry\>** 要素の表示名への割り当てが設定されている暗号化クラスを示します。|  
+|[\<cryptoClass\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md)|**\<nameEntry\>** 要素の表示名への割り当てが設定されている暗号化クラスが含まれています。|  
+|[\<cryptographySettings\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md)|暗号に関する設定が含まれます。|  
+|[\<cryptoNameMapping\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptonamemapping-element.md)|クラスと表示名との割り当てが含まれます。|  
+|[\<暗号設定の mscorlibelement\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/mscorlib-element-for-cryptography-settings.md)|**\<cryptographySettings\>**要素が含まれています。|  
+|[\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md)|クラス名をアルゴリズムの表示名に割り当てます。これにより、1 つのクラスに複数の表示名を割り当てることができるようになります。|  
+|[\<oidEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md)|ASN.1 オブジェクト識別子 \(OID\) を表示名に割り当てます。|  
+|[\<oidMap\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md)|クラスへの ASN.1 OID 割り当てが含まれます。|  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/mscorlib-element-for-cryptography-settings.md b/docs/framework/configure-apps/file-schema/cryptography/mscorlib-element-for-cryptography-settings.md
new file mode 100644
index 00000000000..b7fb4eeb587
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/mscorlib-element-for-cryptography-settings.md
@@ -0,0 +1,87 @@
+---
+title: "暗号設定の &lt;mscorlib&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#mscorlib"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<mscorlib> 要素"
+  - "mscorlib 要素"
+ms.assetid: d549668f-31f1-4b92-8021-a9135c09ca3c
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# 暗号設定の &lt;mscorlib&gt; 要素
+[\<cryptographySettings\> 要素](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptographysettings-element.md)が含まれます。  
+  
+## 構文  
+  
+```  
+  
+      <mscorlib>   
+</mscorlib>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 使用例  
+ 次の例では、暗号化クラスを参照し、ランタイムを構成するために **\<mscorlib\>** 要素を使用する方法を示します。  その後、文字列 "RSA" を <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A?displayProperty=fullName> メソッドに渡し、<xref:System.Security.Cryptography.AsymmetricAlgorithm.Create%2A> メソッドを使用して `MyCryptoRSAClass` オブジェクトを取得できます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RSA" class="MyCryptoRSA"/>  
+            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"  
+                       class="MyCryptoRSA"/>  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A>   
+ <xref:System.Security.Cryptography>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md b/docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md
new file mode 100644
index 00000000000..ea10a52e16c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;nameEntry&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#nameEntry"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/cryptoNameMapping/nameEntry"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<nameEntry> 要素"
+  - "nameEntry 要素"
+ms.assetid: 7d7535e9-4b4a-4b8c-82e2-e40dff5a7821
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;nameEntry&gt; 要素
+クラス名をアルゴリズムの表示名に割り当てます。これにより、1 つのクラスに複数の表示名を割り当てることができるようになります。  
+  
+## 構文  
+  
+```  
+<nameEntry name="friendly name" Class="class name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**name**|必須の属性です。<br /><br /> 暗号化クラスを実装するアルゴリズムの表示名を指定します。|  
+|**class**|必須の属性です。<br /><br /> [\<cryptoClass\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md) 要素で **名前** 属性の値を指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.web`|ASP.NET 構成セクションのルート要素を指定します。|  
+  
+## 解説  
+ **name** 属性は、<xref:System.Security.Cryptography> 名前空間に存在するいずれかの抽象クラスの名前です。  抽象暗号化クラスで **Create** メソッドを呼び出すと、抽象クラス名が [Security.CryptoConfig.CreateFromName](frlrfSystemSecurityCryptographyCryptoConfigClassCreateFromNameTopic) メソッドに渡されます。  **CreateFromName** は、**class** 属性で示された型のインスタンスを返します。  **name** 属性が RSA のような短い名前の場合は、**CreateFromName** メソッドを呼び出すときにこの名前を使用できます。  
+  
+## 使用例  
+ 次の例では、暗号化クラスを参照し、ランタイムを構成するために **\<nameEntry\>** 要素を使用する方法を示します。  その後、文字列 "RSA" を <xref:System.Security.Cryptography.CryptoConfig.CreateFromName%2A?displayProperty=fullName> メソッドに渡し、<xref:System.Security.Cryptography.AsymmetricAlgorithm.Create%2A> メソッドを使用して `MyCryptoRSAClass` オブジェクトを取得できます。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCryptoRSA="MyCryptoRSAClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RSA" class="MyCryptoRSA"/>  
+            <nameEntry name="System.Security.Cryptography.AsymmetricAlgorithm"  
+                       class="MyCryptoRSA"/>  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md b/docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md
new file mode 100644
index 00000000000..9b3b110cd0b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;oidEntry&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/oidMap/oidEntry"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#oidEntry"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<oidEntry> 要素"
+  - "oidEntry 要素"
+ms.assetid: 22fb88b0-bf27-489c-9ca0-e65950ac136c
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;oidEntry&gt; 要素
+ASN.1 オブジェクト識別子 \(OID\) を表示名に割り当てます。  
+  
+## 構文  
+  
+```  
+<oidEntry OID="object identifier number" name="friendly name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**OID**|必須の属性です。<br /><br /> クラスで実装されるアルゴリズムに対応する ASN.1 OID を指定します。|  
+|**name**|必須の属性です。<br /><br /> [\<nameEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md) タグで **名前** 属性の値を指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+|`mscorlib`|`cryptographySettings` 要素を含みます。|  
+|`oidMap`|クラスへの ASN.1 オブジェクト識別子 \(OID\) 割り当てが含まれます。|  
+  
+## 解説  
+ ASN.1 オブジェクト識別子は、ある暗号化形式のアルゴリズムを識別します。  オブジェクト識別子を、識別するアルゴリズムの表示名に割り当てます。  オブジェクト識別子の詳細については、MSDN ライブラリを参照してください。  
+  
+## 使用例  
+ 次の例は、このハッシュ アルゴリズムの実装に RIPEMD\-160 ハッシュ アルゴリズムにオブジェクト ID を割り当てるために **\<oidEntry\>** 要素を使用する方法を示します。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCrypto="MyCryptoClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RIPEMD-160" class="MyCrypto"/>  
+         </cryptoNameMapping>  
+         <oidMap>  
+            <oidEntry OID="1.3.36.3.2.1"   name="MyCryptoClass"/>  
+         </oidMap>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)   
+ [暗号化アルゴリズムへのオブジェクト ID の割り当て](../../../../../docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md b/docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md
new file mode 100644
index 00000000000..b80c6956844
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/cryptography/oidmap-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;oidMap&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#oidMap"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/mscorlib/cryptographySettings/oidMap"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<oidMap> 要素"
+  - "oidMap 要素"
+ms.assetid: 7f0c2246-c070-4748-b96a-2f66a296c539
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;oidMap&gt; 要素
+クラスへの ASN.1 オブジェクト識別子 \(OID\) 割り当てが含まれます。  
+  
+## 構文  
+  
+```  
+<oidMap>   
+</oidMap>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<oidEntry\>](../../../../../docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md)|ASN.1 OID を表示名に割り当てます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`cryptographySettings`|暗号に関する設定が含まれます。|  
+|`mscorlib`|`cryptographySettings`  要素を含みます。|  
+  
+## 使用例  
+ 次の例は、このハッシュ アルゴリズムの実装に RIPEMD\-160 ハッシュ アルゴリズムの OID を格納するために **\<oidMap\>** 要素を使用する方法を示します。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass   MyCrypto="MyCryptoClass, MyAssembly  
+                  Culture=neutral, PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="RIPEMD-160" class="MyCrypto"/>  
+         </cryptoNameMapping>  
+         <oidMap>  
+            <oidEntry OID="1.3.36.3.2.1"  name="MyCryptoClass"/>  
+         </oidMap>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)   
+ [暗号サービス](../../../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../../../docs/framework/configure-apps/configure-cryptography-classes.md)   
+ [暗号化アルゴリズムへのオブジェクト ID の割り当て](../../../../../docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/index.md b/docs/framework/configure-apps/file-schema/index.md
new file mode 100644
index 00000000000..0c73612d7b8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/index.md
@@ -0,0 +1,98 @@
+---
+title: ".NET Framework の構成ファイル スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーション構成, 構成スキーマ"
+  - "app.config ファイル, スキーマ"
+  - "アプリケーション構成ファイル, スキーマ"
+  - "アプリケーション開発 [.NET Framework], スキーマ"
+  - "構成スキーマ [.NET Framework]"
+  - "構成の設定 [.NET Framework], アプリケーション"
+  - "コンテナー タグ"
+  - "エンタープライズ セキュリティ構成ファイル"
+  - "enterprisesec.config ファイル"
+  - "マシン構成ファイル"
+  - "machine.config ファイル"
+  - "スキーマ構成の設定"
+  - "スキーマ, 構成の設定"
+  - "セキュリティ [.NET Framework], 構成ファイル"
+  - "security.config ファイル"
+  - "整形式の XML"
+  - "XML タグ"
+ms.assetid: 69003d39-dc8a-460c-a6be-e6d93e690b38
+caps.latest.revision: 20
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 18
+---
+# .NET Framework の構成ファイル スキーマ
+構成ファイルは、設定を変更し、アプリのポリシーを設定するために使用できる標準 XML ファイルです。  .NET Framework の構成スキーマは、アプリの動作を制御するために構成ファイルで使用できる要素で構成されます。  このセクションの目次は、スキーマ、起動時の階層、ランタイム、ネットワーク、およびその他の種類の構成設定を反映しています。  
+  
+ 構成ファイルの種類、形式、および場所については、「[アプリの構成](../../../../docs/framework/configure-apps/index.md)」の記事を参照してください。  構成ファイルを直接編集するには、XML に関する知識が必要です。  
+  
+> [!IMPORTANT]
+>  構成ファイルの XML タグおよび属性では、大文字と小文字が区別されます。  
+  
+## このセクションの内容  
+ [\<configuration\> 要素](../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+ すべての構成ファイルの最上位要素である `<configuration>` 要素について説明します。  
+  
+ [\<assemblyBinding\> 要素](../../../../docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md)  
+ 構成レベルでのアセンブリ バインディング ポリシーを指定します。  
+  
+ [\<linkedConfiguration\> 要素](../../../../docs/framework/configure-apps/file-schema/linkedconfiguration-element.md)  
+ インクルードする構成ファイルを指定します。  
+  
+ [スタートアップ設定スキーマ](../../../../docs/framework/configure-apps/file-schema/startup/index.md)  
+ 使用する共通言語ランタイムのバージョンを指定する要素について説明します。  
+  
+ [ランタイム設定スキーマ](../../../../docs/framework/configure-apps/file-schema/runtime/index.md)  
+ アセンブリのバインディングとランタイムの動作を構成する要素について説明します。  
+  
+ [ネットワーク設定スキーマ](../../../../docs/framework/configure-apps/file-schema/network/index.md)  
+ .NET Framework がインターネットに接続する方法を指定する要素について説明します。  
+  
+ [暗号設定スキーマ](../../../../docs/framework/configure-apps/file-schema/cryptography/index.md)  
+ アルゴリズムの表示名を、暗号化アルゴリズムを実装するクラスに割り当てる要素について説明します。  
+  
+ [構成セクション スキーマ](../../../../docs/framework/configure-apps/file-schema/configuration-sections-schema.md)  
+ カスタム設定の構成セクションを作成し、使用するための要素について説明します。  
+  
+ [トレースおよびデバッグ設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)  
+ トレース スイッチとリスナーを指定する要素について説明します。  
+  
+ [コンパイラおよび言語プロバイダー設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/compiler/index.md)  
+ 使用できる言語プロバイダーのコンパイラの構成を指定する要素について説明します。  
+  
+ [アプリケーション設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/application-settings-schema.md)  
+ Windows フォームや ASP.NET アプリケーションで、アプリケーション スコープおよびユーザー スコープの設定の格納と取得を可能にする要素について説明します。  
+  
+ [Web 設定スキーマ](../../../../docs/framework/configure-apps/file-schema/web/index.md)  
+ IIS などのホスト アプリケーションと ASP.NET の連携を構成する要素も含め、Web 設定スキーマのすべての要素。  aspnet.config ファイルで使用します。  
+  
+## 関連項目  
+ [Remoting Settings Schema](http://msdn.microsoft.com/ja-jp/dc2d1e62-9af7-4ca1-99fd-98b93bb4db9e)  
+ リモート処理を実装するクライアント アプリケーションとサーバー アプリケーションを構成する要素について説明します。  
+  
+ [ASP.NET 設定スキーマ](http://msdn.microsoft.com/library/b5ysx397\(v=vs.100\).aspx)  
+ ASP.NET Web アプリケーションの動作を制御する要素について説明します。  
+  
+ [Web Services Settings Schema](http://msdn.microsoft.com/ja-jp/f84d6d55-1add-4eb7-ae46-33df5833ea2e)  
+ ASP.NET Web サービス、およびそれらのクライアントの動作を制御する要素について説明します。  
+  
+ [Configuring .NET Framework Apps](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)  
+ セキュリティ、アセンブリのバインディング、および .NET Framework のリモート処理を構成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/linkedconfiguration-element.md b/docs/framework/configure-apps/file-schema/linkedconfiguration-element.md
new file mode 100644
index 00000000000..36a9cb40758
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/linkedconfiguration-element.md
@@ -0,0 +1,94 @@
+---
+title: "&lt;linkedConfiguration&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/assemblyBinding/linkedConfiguration"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#linkedConfiguration"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<linkedConfiguration> 要素"
+  - "構成ファイル [.NET Framework], リンクされた構成ファイル"
+  - "インクルード (構成ファイルを)"
+  - "リンクされた構成ファイル"
+  - "linkedConfiguration 要素"
+ms.assetid: 8eb34f3b-427e-4288-a7ff-c73f489deb45
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# &lt;linkedConfiguration&gt; 要素
+インクルードする構成ファイルを指定します。  
+  
+## 構文  
+  
+```  
+<linkedConfiguration  
+   href="URL of linked configuration file"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`href`|インクルードされる構成ファイルの URL です。  `href` 属性に指定できる形式は "file:\/\/" に限られています。  ローカル ファイルと UNC ファイルがサポートされています。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<assemblyBinding\> 要素](../../../../docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md)|構成レベルでのアセンブリ バインディング ポリシーを指定します。|  
+  
+## 解説  
+ `<linkedConfiguration>` 要素は、コンポーネント アセンブリの供給を簡素化します。  既知の場所に構成ファイルがあるアセンブリを 1 つまたは複数のアプリケーションが使用する場合は、それらのアプリケーションの構成ファイルに、構成情報を直接取り込むのではなく、`<linkedConfiguration>` 要素を使用してアセンブリ構成ファイルをインクルードできます。  コンポーネント アセンブリが供給される場合は、共通の構成ファイルを更新することで、そのアセンブリを使用するすべてのアプリケーションに更新された構成情報が提供されます。  
+  
+> [!NOTE]
+>  Windows side\-by\-side マニフェストを使用するアプリケーションに対しては、`<linkedConfiguration>` 要素がサポートされません。  
+  
+ リンクされた構成ファイルの使用については、次の規則が適用されます。  
+  
+-   インクルードされる構成ファイル内の設定は、ローダー バインディング ポリシーにのみ影響し、ローダーのみが使用します。  インクルードされる構成ファイルには、バインディング ポリシー以外の設定も指定できますが、それらの設定には効力がありません。  
+  
+-   `href` 属性に指定できる形式は "file:\/\/" に限られています。  ローカル ファイルと UNC ファイルがサポートされています。  
+  
+-   構成ファイルあたりのリンクされる構成の数には制限がありません。  
+  
+-   リンクされるすべての構成ファイルは、マージされて 1 つのファイルとなります。これは、C\/C\+\+ の `#include` ディレクティブの動作と似ています。  
+  
+-   `<linkedConfiguration>` 要素は、アプリケーション構成ファイルでのみ使用でき、Machine.config では無視されます。  
+  
+-   循環参照は、検出されて終了されます。  つまり、一連の構成ファイルの `<linkedConfiguration>` 要素がループを生成する場合は、そのループが検出されて停止されます。  
+  
+## 使用例  
+ ローカル ハード ディスクから構成ファイルをインクルードする方法を、次のコード例に示します。  
+  
+```  
+<configuration>  
+   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+      <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>  
+   </assemblyBinding>  
+</configuration>  
+```  
+  
+## 参照  
+ [\<assemblyBinding\> 要素](../../../../docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md)   
+ [構成ファイル スキーマ](../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/TOC.md b/docs/framework/configure-apps/file-schema/network/TOC.md
new file mode 100644
index 00000000000..68b9a1b7180
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/TOC.md
@@ -0,0 +1,43 @@
+# [connectionManagement の <clear> 要素 (ネットワーク設定)](clear-element-for-connectionmanagement-network-settings.md)
+# [ネットワーク設定スキーマ](index.md)
+# [webRequestModules の <remove> 要素 (ネットワーク設定)](remove-element-for-webrequestmodules-network-settings.md)
+# [authenticationModules の <clear> 要素 (ネットワーク設定)](clear-element-for-authenticationmodules-network-settings.md)
+# [<Uri> 要素 (Uri 設定)](uri-element-uri-settings.md)
+# [<connectionManagement> 要素 (ネットワーク設定)](connectionmanagement-element-network-settings.md)
+# [authenticationModules の <remove> 要素 (ネットワーク設定)](remove-element-for-authenticationmodules-network-settings.md)
+# [<webProxyScript> 要素 (ネットワーク設定)](webproxyscript-element-network-settings.md)
+# [bypasslist の <add> 要素 (ネットワーク設定)](add-element-for-bypasslist-network-settings.md)
+# [<defaultProxy> 要素 (ネットワーク設定)](defaultproxy-element-network-settings.md)
+# [<requestCaching> 要素 (ネットワーク設定)](requestcaching-element-network-settings.md)
+# [<iriParsing> 要素 (Uri 設定)](iriparsing-element-uri-settings.md)
+# [connectionManagement の <remove> 要素 (ネットワーク設定)](remove-element-for-connectionmanagement-network-settings.md)
+# [connectionManagement の <add> 要素 (ネットワーク設定)](add-element-for-connectionmanagement-network-settings.md)
+# [<servicePointManager> 要素 (ネットワーク設定)](servicepointmanager-element-network-settings.md)
+# [schemeSettings の <clear> 要素 (Uri 設定)](clear-element-for-schemesettings-uri-settings.md)
+# [<httpListener> 要素 (ネットワーク設定)](httplistener-element-network-settings.md)
+# [bypasslist の <remove> 要素 (ネットワーク設定)](remove-element-for-bypasslist-network-settings.md)
+# [schemeSettings の <add> 要素 (Uri 設定)](add-element-for-schemesettings-uri-settings.md)
+# [<mailSettings> 要素 (ネットワーク設定)](mailsettings-element-network-settings.md)
+# [<system.Net> 要素 (ネットワーク設定)](system-net-element-network-settings.md)
+# [<httpWebRequest> 要素 (ネットワーク設定)](httpwebrequest-element-network-settings.md)
+# [webRequestModules の <clear> 要素 (ネットワーク設定)](clear-element-for-webrequestmodules-network-settings.md)
+# [webRequestModules の <add> 要素 (ネットワーク設定)](add-element-for-webrequestmodules-network-settings.md)
+# [schemeSettings の <remove> 要素 (Uri 設定)](remove-element-for-schemesettings-uri-settings.md)
+# [<performanceCounters> 要素 (ネットワーク設定)](performancecounter-element-network-settings.md)
+# [<proxy> 要素 (ネットワーク設定)](proxy-element-network-settings.md)
+# [<socket> 要素 (ネットワーク設定)](socket-element-network-settings.md)
+# [authenticationModules の <add> 要素 (ネットワーク設定)](add-element-for-authenticationmodules-network-settings.md)
+# [bypasslist の <clear> 要素 (ネットワーク設定)](clear-element-for-bypasslist-network-settings.md)
+# [<network> 要素 (ネットワーク設定)](network-element-network-settings.md)
+# [<defaultHttpCachePolicy> 要素 (ネットワーク設定)](defaulthttpcachepolicy-element-network-settings.md)
+# [<smtp> 要素 (ネットワーク設定)](smtp-element-network-settings.md)
+# [<settings> 要素 (ネットワーク設定)](settings-element-network-settings.md)
+# [<idn> 要素 (Uri 設定)](idn-element-uri-settings.md)
+# [<webRequestModules> 要素 (ネットワーク設定)](webrequestmodules-element-network-settings.md)
+# [<bypasslist> 要素 (ネットワーク設定)](bypasslist-element-network-settings.md)
+# [<authenticationModules> 要素 (ネットワーク設定)](authenticationmodules-element-network-settings.md)
+# [<ipv6> 要素 (ネットワーク設定)](ipv6-element-network-settings.md)
+# [<module> 要素 (ネットワーク設定)](module-element-network-settings.md)
+# [<defaultFtpCachePolicy> 要素 (ネットワーク設定)](defaultftpcachepolicy-element-network-settings.md)
+# [<schemeSettings> 要素 (Uri 設定)](schemesettings-element-uri-settings.md)
+# [<specifiedPickupDirectory> 要素 (ネットワーク設定)](specifiedpickupdirectory-element-network-settings.md)
diff --git a/docs/framework/configure-apps/file-schema/network/add-element-for-authenticationmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/add-element-for-authenticationmodules-network-settings.md
new file mode 100644
index 00000000000..5ad5ee2c7ae
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/add-element-for-authenticationmodules-network-settings.md
@@ -0,0 +1,95 @@
+---
+title: "authenticationModules の &lt;add&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#add"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/authenticationModules/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<add> 要素, authenticationModules"
+  - "<authenticationModules>, add 要素"
+  - "add 要素, authenticationModules"
+  - "authenticationModules, add 要素"
+ms.assetid: 333c5fb0-a2ab-4db8-8531-a7fe37bb9b5b
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# authenticationModules の &lt;add&gt; 要素 (ネットワーク設定)
+認証モジュールをアプリケーションに追加します。  
+  
+## 構文  
+  
+```  
+  
+      <add   
+   type = "client type", System, Version="version number", Culture="culture", PublicKeyToken="token"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`type`|認証を実装するモジュールのクラス名および詳細。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[authenticationModules](../../../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md)|ネットワーク要求を認証するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `add` 要素は、登録されている認証モジュールのリストの末尾に認証モジュールを追加します。  認証モジュールは、各認証モジュールがリストに追加された順序で呼び出されます。  
+  
+ `type` 属性の値は、有効な DLL 名および対応するクラスの名前をコンマで区切って指定する必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 既定の認証モジュールを有効にするコード例を次に示します。  Version の値および PublicKeyToken の値は、指定したモジュールに対応する正しい値に置き換える必要があります。  
+  
+```  
+<configuration>  
+  <system.net>  
+        <authenticationModules>  
+            <add type="System.Net.DigestClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+            <add type="System.Net.NegotiateClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+            <add type="System.Net.KerberosClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+            <add type="System.Net.NtlmClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+            <add type="System.Net.BasicClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+        </authenticationModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.IAuthenticationModule>   
+ <xref:System.Net.AuthenticationManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/add-element-for-bypasslist-network-settings.md b/docs/framework/configure-apps/file-schema/network/add-element-for-bypasslist-network-settings.md
new file mode 100644
index 00000000000..03b504ebf20
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/add-element-for-bypasslist-network-settings.md
@@ -0,0 +1,92 @@
+---
+title: "bypasslist の &lt;add&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/bypasslist/add"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<add> 要素, bypasslist"
+  - "<bypasslist>, add 要素"
+  - "add 要素, bypasslist"
+  - "bypasslist, add 要素"
+ms.assetid: a0b86e28-86b4-4497-abe8-d5fd614c7926
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# bypasslist の &lt;add&gt; 要素 (ネットワーク設定)
+IP アドレスまたは DNS 名をプロキシ バイパス リストに追加します。  
+  
+## 構文  
+  
+```  
+  
+      <add   
+   address = "regular expression"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|**address**|IP アドレスまたは DNS 名を記述する正規表現。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[bypasslist](../../../../../docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md)|プロキシを使用しないアドレスを記述する一連の正規表現を提供します。|  
+  
+## 解説  
+ `add` 要素は、IP アドレスまたは DNS サーバー名を記述する正規表現を、プロキシ サーバーをバイパスするアドレスのリストに挿入します。  
+  
+ `address` 属性の値は、一組の IP アドレスまたはホスト名を記述する正規表現である必要があります。  
+  
+ この要素に正規表現を指定する場合は注意が必要です。  たとえば、"\[a\-z\]\+\\.contoso\\.com" という正規表現は、contoso.com ドメインの各ホストに一致しますが、contoso.com.cpandl.com ドメインの各ホストとも一致します。  contoso.com ドメインのホストとだけ一致させるためには、アンカーとして "$" を使用し、"\[a\-z\]\+\\.contoso\\.com$" のように記述します。  
+  
+ 正規表現の詳細については、「[.NET Framework の正規表現](../../../../../docs/standard/base-types/regular-expressions.md)」を参照してください。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 2 つのアドレスをバイパス リストに追加するコード例を次に示します。  第 1 の例では、contoso.com ドメインにあるすべてのサーバーでプロキシをバイパスします。第 2 の例では、IP アドレスが 192.168 で始まるすべてのサーバーでプロキシをバイパスします。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <bypasslist>  
+        <add address="[a-z]+\.contoso\.com$" />  
+        <add address="192\.168\.\d{1,3}\.\d{1,3}" />  
+      </bypasslist>  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/add-element-for-connectionmanagement-network-settings.md b/docs/framework/configure-apps/file-schema/network/add-element-for-connectionmanagement-network-settings.md
new file mode 100644
index 00000000000..193cfb45b72
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/add-element-for-connectionmanagement-network-settings.md
@@ -0,0 +1,89 @@
+---
+title: "connectionManagement の &lt;add&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#add"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/connectionManagement/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<add> 要素, connectionManagement"
+  - "<connectionManagement>, add 要素"
+  - "add 要素, connectionManagement"
+  - "connectionManagement, add 要素"
+ms.assetid: 856bf57d-1c63-46c7-a178-03d97b0a4149
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# connectionManagement の &lt;add&gt; 要素 (ネットワーク設定)
+IP アドレスまたは DNS 名を接続管理リストに追加します。  
+  
+## 構文  
+  
+```  
+  
+        <add   
+   address = "address expression"   
+   maxconnection = integer   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**属性**|**説明**|  
+|------------|------------|  
+|`address`|IP アドレスまたは DNS 名を記述する文字列。|  
+|`maxconnection`|サーバーに対して許可される接続の最大数。  値が指定されていない場合、既定値は 2 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[connectionManagement](../../../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md)|ネットワーク ホストへの接続の最大数を指定します。|  
+  
+## 解説  
+ `address` 属性の値は、すべての接続を示すアスタリスク、または形式が `<schema>://<idn_hostname>[:<port>]` の文字列である必要があります。  
+  
+ HTTP API に渡される URI に Unicode が含まれる場合、punicode 文字列を返す可能性がある <xref:System.Uri.DnsSafeHost%2A> を使用して名前が内部的に変換されます \(動作は現行 IDN 構成によって異なる\)。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 次のコード例では、サーバー www.contoso.com への 4 つの接続とその他のすべてのサーバーへの 2 つの接続を使用するアプリケーションを構成します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <connectionManagement>  
+      <add address = "http://www.contoso.com" maxconnection = "4" />  
+      <add address = "*" maxconnection = "2" />  
+    </connectionManagement>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.ServicePoint>   
+ <xref:System.Net.ServicePointManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/add-element-for-schemesettings-uri-settings.md b/docs/framework/configure-apps/file-schema/network/add-element-for-schemesettings-uri-settings.md
new file mode 100644
index 00000000000..c9fee39d5d3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/add-element-for-schemesettings-uri-settings.md
@@ -0,0 +1,98 @@
+---
+title: "schemeSettings の &lt;add&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 594a7b3b-af23-4cfa-b616-0b2dddb1a705
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# schemeSettings の &lt;add&gt; 要素 (Uri 設定)
+スキーム名に対するスキーム設定を追加します。  
+  
+## 構文  
+  
+```  
+  
+      <add   
+   name = "http|https" genericUriParserOptions="DontUnescapePathDotsAndSlashes"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|name|この設定を適用するスキーム名。  サポートされている値は、name\="http" と name\="https" だけです。|  
+  
+## {属性名} 属性  
+  
+|値|説明|  
+|-------|--------|  
+|genericUriParserOptions|このスキームのパーサー オプション。  サポートされている値は、genericUriParserOptions\= "DontUnescapePathDotsAndSlashes" だけです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<schemeSettings\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md)|<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。|  
+  
+## 解説  
+ 既定では、<xref:System.Uri?displayProperty=fullName> クラスは、パスの圧縮を実行する前に、パーセント記号をエンコードしたパス区切り記号のエスケープを解除します。  これは、次のような攻撃に対するセキュリティ機構として実装されました。  
+  
+ `http://www.contoso.com/..%2F..%2F/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ パーセント記号をエンコードした文字を正しく処理できないモジュールにこの URI が渡されると、次のコマンドがサーバーによって実行されます。  
+  
+ `c:\Windows\System32\cmd.exe /c dir c:\`  
+  
+ このため、<xref:System.Uri?displayProperty=fullName> クラスでは、パス区切り記号のエスケープを解除してから、パスの圧縮を適用します。  上のような悪意のある URL を <xref:System.Uri?displayProperty=fullName> クラス コンストラクターに渡した場合、次の URI になります。  
+  
+ `http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ この既定の動作は、特定のスキームの schemeSettings 構成オプションを使用して、パーセント記号をエンコードしたパス区切り記号のエスケープを解除しないように変更できます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ http スキームのパーセント記号をエンコードしたパス区切り記号をエスケープしないようにするために、<xref:System.Uri> クラスで使用する構成を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <uri>  
+    <schemeSettings>  
+      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>  
+    </schemeSettings>  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Configuration.SchemeSettingElement?displayProperty=fullName>   
+ <xref:System.Configuration.SchemeSettingElementCollection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection.SchemeSettings%2A?displayProperty=fullName>   
+ <xref:System.GenericUriParserOptions?displayProperty=fullName>   
+ <xref:System.Uri?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/add-element-for-webrequestmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/add-element-for-webrequestmodules-network-settings.md
new file mode 100644
index 00000000000..11999809b4b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/add-element-for-webrequestmodules-network-settings.md
@@ -0,0 +1,94 @@
+---
+title: "webRequestModules の &lt;add&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/webRequestModules/add"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<add> 要素, webRequestModules"
+  - "<webRequestModules>, add 要素"
+  - "add 要素, webRequestModules"
+  - "webRequestModules, add 要素"
+ms.assetid: 47ec4adc-f39f-4bcd-8680-1ec21fd26890
+caps.latest.revision: 16
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 16
+---
+# webRequestModules の &lt;add&gt; 要素 (ネットワーク設定)
+カスタム Web 要求モジュールをアプリケーションに追加します。  
+  
+## 構文  
+  
+```  
+  
+      <add   
+  prefix = "URI prefix"   
+  type = "module name, Version, Culture, PublicKeyToken"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`prefix`|この Web 要求モジュールで処理される要求の URI プレフィックス。|  
+|`type`|この Web 要求モジュールを実装するモジュールのアセンブリ名およびクラス名。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[webRequestModules](../../../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md)|ネットワーク ホストからの情報を要求するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `prefix` 属性は、指定した Web 要求モジュールを使用する URI プレフィックスを定義します。  通常、Web 要求モジュールは、HTTP や FTP などの特定のプロトコルを処理するために登録します。ただし、特定のサーバーまたはサーバー上の特定のパスへの要求を処理するために登録することもできます。  
+  
+ Web 要求モジュールは、プレフィックスと一致する URI が <xref:System.Net.WebRequest.Create%2A?displayProperty=fullName> メソッドに渡されると作成されます。  
+  
+ `prefix` 属性の値は、"http" や "http:\/\/www.contoso.com" のように、有効な UR の先行文字である必要があります。  
+  
+ `type` 属性の値は、有効な DLL 名および対応するクラスの名前をコンマで区切って指定する必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ HTTP 用のカスタム Web 要求モジュールを登録するコード例を次に示します。  Version の値および PublicKeyToken の値は、指定したモジュールに対応する正しい値に置き換える必要があります。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <webRequestModules>  
+      <add prefix="http"  
+           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
+           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+      />  
+    </webRequestModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebRequest>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md
new file mode 100644
index 00000000000..d7929c17c0c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;authenticationModules&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#authenticationModules"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/authenticationModules"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<authenticationModules> 要素"
+  - "authenticationModules 要素"
+ms.assetid: 10fcfaad-82ef-4692-871a-0aec9dfbe75e
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# &lt;authenticationModules&gt; 要素 (ネットワーク設定)
+ネットワーク要求を認証するために使用するモジュールを指定します。  
+  
+## 構文  
+  
+```  
+  
+      <authenticationModules>   
+</authenticationModules>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[add](../../../../../docs/framework/configure-apps/file-schema/network/add-element-for-authenticationmodules-network-settings.md)|認証モジュールをアプリケーションに追加します。|  
+|[clear](../../../../../docs/framework/configure-apps/file-schema/network/clear-element-for-authenticationmodules-network-settings.md)|すべての認証モジュールをアプリケーションから削除します。|  
+|[remove](../../../../../docs/framework/configure-apps/file-schema/network/remove-element-for-authenticationmodules-network-settings.md)|認証モジュールをアプリケーションから削除します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[system.net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 解説  
+ `authenticationModule` 要素は、サーバーとの間の認証プロセスを実行する認証モジュールを指定します。  認証モジュールは、<xref:System.Net.IAuthenticationModule> インターフェイスを実装する必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 認証モジュールを有効にするコード例を次に示します。  Version の値および PublicKeyToken の値は、指定したモジュールに対応する正しい値に置き換える必要があります。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <authenticationModules>  
+      <add type="System.Net.DigestClient, System, Version=2.0.3600.0,  
+                 Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+    </authenticationModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.IAuthenticationModule>   
+ <xref:System.Net.AuthenticationManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md
new file mode 100644
index 00000000000..37f7c9bb268
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;bypasslist&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#bypasslist"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/bypasslist"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<bypasslist> 要素"
+  - "bypasslist 要素"
+ms.assetid: 124446b7-abb1-4e5e-a492-b64398f268f1
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# &lt;bypasslist&gt; 要素 (ネットワーク設定)
+プロキシを使用しないアドレスを記述する一連の正規表現を提供します。  
+  
+## 構文  
+  
+```  
+  
+      <bypasslist>   
+</bypasslist>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[add](../../../../../docs/framework/configure-apps/file-schema/network/add-element-for-bypasslist-network-settings.md)|IP アドレスまたは DNS 名をプロキシ バイパス リストに追加します。|  
+|[clear](../../../../../docs/framework/configure-apps/file-schema/network/clear-element-for-bypasslist-network-settings.md)|すべてのエントリをバイパス リストから削除します。|  
+|[remove](../../../../../docs/framework/configure-apps/file-schema/network/remove-element-for-bypasslist-network-settings.md)|IP アドレスまたは DNS 名をプロキシ バイパス リストから削除します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[defaultProxy](../../../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md)|ハイパーテキスト転送プロトコル \(HTTP: Hypertext Transfer Protocol\) プロキシ サーバーを構成します。|  
+  
+## 解説  
+ バイパス リストには、<xref:System.Net.WebRequest> インスタンスがプロキシ サーバーを経由せずに直接アクセスする URI を記述する正規表現が格納されます。  
+  
+ この要素に正規表現を指定する場合は注意が必要です。  たとえば、"\[a\-z\]\+\\.contoso\\.com" という正規表現は、contoso.com ドメインの各ホストに一致しますが、contoso.com.cpandl.com ドメインの各ホストとも一致します。  contoso.com ドメインのホストとだけ一致させるためには、アンカーとして "$" を使用し、"\[a\-z\]\+\\.contoso\\.com$" のように記述します。  
+  
+ 正規表現の詳細については、「[.NET Framework の正規表現](../../../../../docs/standard/base-types/regular-expressions.md)」を参照してください。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 2 つのアドレスをバイパス リストに追加するコード例を次に示します。  第 1 の例では、contoso.com ドメインにあるすべてのサーバーでプロキシをバイパスします。第 2 の例では、IP アドレスが 192.168 で始まるすべてのサーバーでプロキシをバイパスします。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <bypasslist>  
+        <add address="[a-z]+\.contoso\.com$" />  
+        <add address="192\.168\.\d{1,3}\.\d{1,3}" />  
+      </bypasslist>  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/clear-element-for-authenticationmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/clear-element-for-authenticationmodules-network-settings.md
new file mode 100644
index 00000000000..3ab00b8f722
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/clear-element-for-authenticationmodules-network-settings.md
@@ -0,0 +1,80 @@
+---
+title: "authenticationModules の &lt;clear&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/authenticationModules/clear"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<authenticationModules>, clear 要素"
+  - "<clear> 要素, authenticationModules"
+  - "authenticationModules, clear 要素"
+  - "clear 要素, authenticationModules"
+ms.assetid: dc522c45-4a80-4831-8955-f7b68a47edfd
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# authenticationModules の &lt;clear&gt; 要素 (ネットワーク設定)
+すべての認証モジュールをアプリケーションから削除します。  
+  
+## 構文  
+  
+```  
+  
+<clear/>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[authenticationModules](../../../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md)|ネットワーク要求を認証するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `clear` 要素は、構成ファイルまたは構成階層の上位レベルで既に定義されている認証モジュールを削除します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 構成された認証モジュールのすべてを削除する例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <authenticationModules>  
+      <clear/>  
+    </authenticationModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.IAuthenticationModule>   
+ <xref:System.Net.AuthenticationManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/clear-element-for-bypasslist-network-settings.md b/docs/framework/configure-apps/file-schema/network/clear-element-for-bypasslist-network-settings.md
new file mode 100644
index 00000000000..82a57c8cc06
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/clear-element-for-bypasslist-network-settings.md
@@ -0,0 +1,83 @@
+---
+title: "bypasslist の &lt;clear&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/bypasslist/clear"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<bypasslist>, clear 要素"
+  - "<clear> 要素, bypasslist"
+  - "bypasslist, clear 要素"
+  - "clear 要素, bypasslist"
+ms.assetid: 301584ca-a914-4100-b180-3b288d3b099e
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# bypasslist の &lt;clear&gt; 要素 (ネットワーク設定)
+すべてのエントリをプロキシ バイパス リストから削除します。  
+  
+## 構文  
+  
+```  
+  
+<clear/>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[bypasslist](../../../../../docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md)|プロキシを使用しないアドレスを記述する一連の正規表現を提供します。|  
+  
+## 解説  
+ `clear` 要素は、バイパス リストからすべてのエントリを削除します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ すべてのエントリをバイパス リストから削除し、2 つのアドレスをバイパス リストに追加するコード例を次に示します。  第 1 の例では、contoso.com ドメインにあるすべてのサーバーでプロキシをバイパスします。第 2 の例では、IP アドレスが 192.168 で始まるすべてのサーバーでプロキシをバイパスします。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <bypasslist>  
+         <clear/>  
+        <add address="[a-z]+\.contoso\.com$" />  
+        <add address="192\.168\.\d{1,3}\.\d{1,3}" />  
+      </bypasslist>  
+    </defaultProxy>  
+  </system.net>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/clear-element-for-connectionmanagement-network-settings.md b/docs/framework/configure-apps/file-schema/network/clear-element-for-connectionmanagement-network-settings.md
new file mode 100644
index 00000000000..4cf2cdd7ff2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/clear-element-for-connectionmanagement-network-settings.md
@@ -0,0 +1,82 @@
+---
+title: "connectionManagement の &lt;clear&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/connectionManagement/clear"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<clear> 要素, connectionManagement"
+  - "<connectionManagement>, clear 要素"
+  - "clear 要素, connectionManagement"
+  - "connectionManagement, clear 要素"
+ms.assetid: fb259282-84c4-4dc4-a226-78d904a6edc3
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# connectionManagement の &lt;clear&gt; 要素 (ネットワーク設定)
+すべてのエントリを接続管理リストから削除します。  
+  
+## 構文  
+  
+```  
+  
+<clear/>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[connectionManagement](../../../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md)|ネットワーク ホストへの接続の最大数を指定します。|  
+  
+## 解説  
+ `clear` 要素は、接続管理リストからすべてのエントリを削除します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ すべてのエントリを接続管理リストから削除し、サーバー www.contoso.com とそれ以外のすべてのネットワーク ホストの接続管理エントリを追加するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <connectionManagement>  
+      <clear/>  
+      <add address = "http://www.contoso.com" maxconnection = "4" />  
+      <add address = "*" maxconnection = "2" />  
+    </connectionManagement>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.ServicePoint>   
+ <xref:System.Net.ServicePointManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/clear-element-for-schemesettings-uri-settings.md b/docs/framework/configure-apps/file-schema/network/clear-element-for-schemesettings-uri-settings.md
new file mode 100644
index 00000000000..b7c34b3c4cb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/clear-element-for-schemesettings-uri-settings.md
@@ -0,0 +1,89 @@
+---
+title: "schemeSettings の &lt;clear&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 65098332-ce61-4542-ab8d-e7dc0257d31f
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# schemeSettings の &lt;clear&gt; 要素 (Uri 設定)
+既存のスキーム設定をすべて消去します。  
+  
+## 構文  
+  
+```  
+  
+<clear/>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<schemeSettings\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md)|<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。|  
+  
+## 解説  
+ 既定では、<xref:System.Uri?displayProperty=fullName> クラスは、パスの圧縮を実行する前に、パーセント記号をエンコードしたパス区切り記号のエスケープを解除します。  これは、次のような攻撃に対するセキュリティ機構として実装されました。  
+  
+ `http://www.contoso.com/..%2F..%2F/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ パーセント記号をエンコードした文字を正しく処理できないモジュールにこの URI が渡されると、次のコマンドがサーバーによって実行されます。  
+  
+ `c:\Windows\System32\cmd.exe /c dir c:\`  
+  
+ このため、<xref:System.Uri?displayProperty=fullName> クラスでは、パス区切り記号のエスケープを解除してから、パスの圧縮を適用します。  上のような悪意のある URL を <xref:System.Uri?displayProperty=fullName> クラス コンストラクターに渡した場合、次の URI になります。  
+  
+ `http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ この既定の動作は、特定のスキームの schemeSettings 構成オプションを使用して、パーセント記号をエンコードしたパス区切り記号のエスケープを解除しないように変更できます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ スキーム設定をすべて消去してから、http スキームのパーセント記号をエンコードしたパス区切り記号をエスケープしないようにする、<xref:System.Uri> クラスで使用する構成を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <uri>  
+    <schemeSettings>  
+      <clear/>  
+      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>  
+    </schemeSettings>  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Configuration.SchemeSettingElement?displayProperty=fullName>   
+ <xref:System.Configuration.SchemeSettingElementCollection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection.SchemeSettings%2A?displayProperty=fullName>   
+ <xref:System.GenericUriParserOptions?displayProperty=fullName>   
+ <xref:System.Uri?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/clear-element-for-webrequestmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/clear-element-for-webrequestmodules-network-settings.md
new file mode 100644
index 00000000000..08d2c61ab6a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/clear-element-for-webrequestmodules-network-settings.md
@@ -0,0 +1,83 @@
+---
+title: "webRequestModules の &lt;clear&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/webRequestModules/clear"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<clear> 要素, webRequestModules"
+  - "<webRequestModules>, clear 要素"
+  - "clear 要素, webRequestModules"
+  - "webRequestModules, clear 要素"
+ms.assetid: 48f38bcb-f30c-4b74-a8f0-1a3caf1aa96f
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# webRequestModules の &lt;clear&gt; 要素 (ネットワーク設定)
+登録されているすべての Web 要求モジュールをアプリケーションから削除します。  
+  
+## 構文  
+  
+```  
+  
+<clear/>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[webRequestModules](../../../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md)|ネットワーク ホストからの情報を要求するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `clear` 要素は、構成ファイルまたは構成階層の上位レベルで既に定義されているすべての Web 要求モジュールを削除します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ すべての Web 要求モジュールを削除し、HTTP 用の Web 要求モジュールを登録するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <webRequestModules>  
+      <clear/>  
+      <add prefix="http"  
+           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
+           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+      />  
+    </webRequestModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebRequest>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md
new file mode 100644
index 00000000000..2d6b8d19bf2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;connectionManagement&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/connectionManagement"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#connectionManagement"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<connectionManagement> 要素"
+  - "connectionManagement 要素"
+ms.assetid: bedccaab-12a2-4511-8f67-e961f249aec6
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;connectionManagement&gt; 要素 (ネットワーク設定)
+ネットワーク ホストへの接続の最大数を指定します。  
+  
+## 構文  
+  
+```  
+  
+      <connectionManagement>   
+</connectionManagement>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[add](../../../../../docs/framework/configure-apps/file-schema/network/add-element-for-connectionmanagement-network-settings.md)|IP アドレスまたは DNS 名を接続管理リストに追加します。|  
+|[clear](../../../../../docs/framework/configure-apps/file-schema/network/clear-element-for-connectionmanagement-network-settings.md)|すべてのエントリを接続管理リストから削除します。|  
+|[remove](../../../../../docs/framework/configure-apps/file-schema/network/remove-element-for-connectionmanagement-network-settings.md)|IP アドレスまたは DNS 名を接続管理リストから削除します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[system.net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 解説  
+ `connectionManagement` 要素は、サーバーまたはサーバー グループへの接続の最大数を定義します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ アプリケーションの構成でサーバー www.contoso.com への接続数を 4、それ以外のすべてのサーバーへの接続数を 2 に指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <connectionManagement>  
+      <add address = "http://www.contoso.com" maxconnection = "4" />  
+      <add address = "*" maxconnection = "2" />  
+    </connectionManagement>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.ServicePoint>   
+ <xref:System.Net.ServicePointManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/defaultftpcachepolicy-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/defaultftpcachepolicy-element-network-settings.md
new file mode 100644
index 00000000000..f557b980f40
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/defaultftpcachepolicy-element-network-settings.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;defaultFtpCachePolicy&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#defaultFtpCachePolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/requestCaching/defaultFtpCachePolicy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<defaultFtpCachePolicy> 要素"
+  - "defaultFtpCachePolicy 要素"
+ms.assetid: 0eb0c5cb-dd97-484d-8614-785e88877abb
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;defaultFtpCachePolicy&gt; 要素 (ネットワーク設定)
+FTP キャッシュがアクティブであるかどうかを指定し、既定のキャッシュ ポリシーを記述します。  
+  
+## 構文  
+  
+```  
+< defaultFtpCachePolicy  
+  policyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`policyLevel`|FTP キャッシュ ポリシーを指定します。  既定値は `Default` です。|  
+  
+## policyLevel 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`Default`|キャッシュされているリソースが最新であり、content length が正しく、expiration 属性、modification 属性、および content length 属性が指定されている場合、キャッシュされているリソースを返します。|  
+|`BypassCache`|サーバーからリソースを返します。|  
+|`CacheOnly`|content length が指定されており、エントリのサイズに一致する場合、キャッシュされているリソースを返します。|  
+|`CacheIfAvailable`|content length が指定されており、エントリのサイズに一致する場合には、キャッシュされているリソースを返します。その他の場合には、対象のリソースをサーバーからダウンロードした上で、呼び出し元に返します。|  
+|`Revalidate`|キャッシュされているリソースのタイムスタンプが、サーバー上のリソースのタイムスタンプと等しい場合には、キャッシュされているリソースを返します。その他の場合には、対象のリソースをサーバーからダウンロードし、キャッシュに格納し、呼び出し元に返します。|  
+|`Reload`|対象のリソースをサーバーからダウンロードし、キャッシュに格納した上で、呼び出し元に返します。|  
+|`NoCacheNoStore`|キャッシュされたリソースが存在する場合は削除されます。  サーバーからリソースをダウンロードし、呼び出し元に返します。|  
+|`Revalidate`|タイムスタンプがサーバーのリソースのタイムスタンプと同じ場合は、キャッシュされたリソースのコピーを使用して要求に応じます。それ以外の場合は、リソースがサーバーからダウンロードされ、呼び出し元に提示され、キャッシュに格納されます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[requestCaching](../../../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)|ネットワーク要求のキャッシュ機構を制御します。|  
+  
+## 解説  
+  
+## 使用例  
+ 次のコード例は、`NoCacheNoStore` の FTP キャッシュ ポリシーを指定する方法を示しています。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <requestCaching>  
+      <defaultFtpCachePolicy  
+        Level="NoCacheNoStore">  
+      </defaultFtpCachePolicy>  
+    </requestCaching>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Cache>   
+ <xref:System.Net.WebRequest>   
+ <xref:System.Net.Cache.RequestCacheLevel>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/defaulthttpcachepolicy-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/defaulthttpcachepolicy-element-network-settings.md
new file mode 100644
index 00000000000..49ac64ae9d7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/defaulthttpcachepolicy-element-network-settings.md
@@ -0,0 +1,94 @@
+---
+title: "&lt;defaultHttpCachePolicy&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/requestCaching/defaultHttpCachePolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#defaultHttpCachePolicy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<defaultHttpCachePolicy> 要素"
+  - "defaultHttpCachePolicy 要素"
+ms.assetid: 2c1247d0-39b0-4c12-919a-a925ce075c79
+caps.latest.revision: 19
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 19
+---
+# &lt;defaultHttpCachePolicy&gt; 要素 (ネットワーク設定)
+HTTP キャッシュがアクティブであるかどうかを指定し、既定のキャッシュ ポリシーを記述します。  
+  
+## 構文  
+  
+```  
+< defaultHttpCachePolicy  
+  policyLevel="BypassCache|Default"  
+  minimumFresh="d.hh:mm:ss"|"minValue"  
+  maximumAge  ="d.hh:mm:ss"|"maxValue"  
+  maximumStale="d.hh:mm:ss"|"maxValue"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`maximumAge`|キャッシュされたオブジェクトを期限切れであるとマークするまでの最大時間間隔を指定します。|  
+|`maximumStale`|キャッシュされたオブジェクトを期限切れであるとマークするまでの、計算されたフレッシュネス時間からの最大経過時間を指定します。|  
+|`minimumFresh`|キャッシュされたオブジェクトをフレッシュであると判断する最小時間を指定します。|  
+|`policyLevel`|キャッシュ ポリシーが自動であるか、またはキャッシュを迂回するかを指定します。  既定値は `BypassCache` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[requestCaching](../../../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)|ネットワーク要求のキャッシュ機構を制御します。|  
+  
+## 解説  
+ `policyLevel` 属性の値は、`BypassCache` または `Default` です。  
+  
+ `maximumAge`、`maximumStale`と `minimumFresh` 要素の値は *d*形式の明示的な時間間隔のいずれかです。*hh*:*mm*:*ss* \(日、時、分、秒\)、または適切 `minValue` 定数または `maxValue`。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 次のコード例は、minimumFresh に 6 時間を指定し、maximumAge に 2 日間を指定し、maximumStale に 4 時間を指定する方法を示しています。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <requestCaching>  
+      <defaultHttpCachePolicy>  
+        <set minimumFresh="0.06:00:00" />  
+        <set maximumAge  ="2.00:00:00" />  
+        <set maximumStale="0.04:00:00" />  
+      </defaultHttpCachePolicy>  
+    </requestCaching>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Cache>   
+ <xref:System.Net.WebRequest>   
+ <xref:System.Net.Cache.RequestCacheLevel>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md
new file mode 100644
index 00000000000..f82722ab220
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;defaultProxy&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#defaultProxy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<defaultProxy> 要素"
+  - "defaultProxy 要素"
+ms.assetid: 9d663c4b-07b4-4f6f-9b12-efbd3630354f
+caps.latest.revision: 21
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 21
+---
+# &lt;defaultProxy&gt; 要素 (ネットワーク設定)
+ハイパーテキスト転送プロトコル \(HTTP: Hypertext Transfer Protocol\) プロキシ サーバーを構成します。  
+  
+## 構文  
+  
+```  
+  
+        <defaultProxy  
+  enabled="true|false"  
+  useDefaultCredentials="true|false"  
+  <bypasslist> … </bypasslist>  
+  <proxy> … </proxy>  
+  <module> … </module>  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|`enabled`|Web プロキシが使用されているかどうかを指定します。  既定値は `true` です。|  
+|`useDefaultCredentials`|このホストに対する既定の資格情報が Web プロキシにアクセスするために使用されるかどうかを指定します。  既定値は `false` です。|  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[bypasslist](../../../../../docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md)|プロキシを使用しないアドレスを記述する一連の正規表現を提供します。|  
+|[モジュール](../../../../../docs/framework/configure-apps/file-schema/network/module-element-network-settings.md)|新しいプロキシ モジュールをアプリケーションに追加します。|  
+|[プロキシ](../../../../../docs/framework/configure-apps/file-schema/network/proxy-element-network-settings.md)|プロキシ サーバーを定義します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[system.  net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 解説  
+ defaultProxy 要素が空の場合、Internet Explorer のプロキシ設定が使用されます。  この動作は、.NET Framework Version 1.1 とは異なります。  
+  
+ 例外は <xref:System.Net.IWebProxy> クラスから [module](../../../../../docs/framework/configure-apps/file-schema/network/module-element-network-settings.md) 要素で非パブリック型が指定されている場合、型派生していませんスローされます。このオブジェクトの既定のコンストラクターで例外が発生した、またはシステムが指定した既定のプロキシを取得している間に例外が発生しました。  例外の <xref:System.Exception.InnerException%2A> プロパティに、このエラーの根本的な原因に関する詳細情報が含まれています。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ Internet Explorer プロキシの既定値を使用し、プロキシ アドレスを指定し、ローカル アクセスおよび contoso.com のプロキシをバイパスするコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <proxy  
+        usesystemdefault="true"  
+        proxyaddress="http://192.168.1.10:3128"  
+        bypassonlocal="true"  
+      />  
+      <bypasslist  
+        <add address="[a-z]+\.contoso\.com" />  
+      </bypasslist>  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/httplistener-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/httplistener-element-network-settings.md
new file mode 100644
index 00000000000..fa74a118871
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/httplistener-element-network-settings.md
@@ -0,0 +1,152 @@
+---
+title: "&lt;httpListener&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 62f121fd-3f2e-4033-bb39-48ae996bfbd9
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# &lt;httpListener&gt; 要素 (ネットワーク設定)
+<xref:System.Net.HttpListener> クラスで使用されるパラメーターをカスタマイズします。  
+  
+## 構文  
+  
+```  
+  
+      <httpListener  
+  unescapeRequestUrl ="true|false"  
+/>  
+```  
+  
+## 型  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|unescapeRequestUrl|<xref:System.Net.HttpListener> インスタンスが変換された URI ではなくエスケープされていない生の URI を使用するかどうかを示すブール値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+ **unescapeRequestUrl** 属性は、変換された URI ではなくエスケープされていない生の URI を <xref:System.Net.HttpListener> で使用するかどうかを示します。変換された URI では、パーセント記号をエンコードした値はすべて変換され、その他の正規化手順が実行されます。  
+  
+ <xref:System.Net.HttpListener> インスタンスは `http.sys` サービスを通じて要求を受け取ると、`http.sys` から渡された URI 文字列のインスタンスを作成し、そのインスタンスを <xref:System.Net.HttpListenerRequest.Url%2A?displayProperty=fullName> プロパティとして公開します。  
+  
+ `http.sys` サービスでは、次の 2 つの要求 URI 文字列を公開します。  
+  
+-   生の URI  
+  
+-   変換された URI  
+  
+ 生の URI は、HTTP 要求の要求行に指定されている <xref:System.Uri?displayProperty=fullName> です。  
+  
+ `GET /path/`  
+  
+ `Host: www.contoso.com`  
+  
+ 前の要求の `http.sys` から渡される生の URI は、"\/path\/" です。  これは、ネットワーク上で送信された HTTP 動詞の後に続く文字列を表します。  
+  
+ `http.sys` サービスでは、HTTP 要求行および Host ヘッダーに指定されている URI を使用して要求の転送先となる元のサーバーを特定することによって、要求に指定されている情報から、変換された URI を作成します。  この処理は、要求の情報と一連の登録済み URI プレフィックスとを比較することで行われます。  HTTP Server SDK のドキュメントでは、この変換された URI を HTTP\_COOKED\_URL 構造体と呼びます。  
+  
+ 要求と登録済み URI プレフィックスとを比較できるようにするためには、要求の正規化をいくつか行う必要があります。  上のサンプルでは、変換された URI は次のようになります。  
+  
+ `http://www.contoso.com/path/`  
+  
+ `http.sys` サービスでは、<xref:System.Uri.Host%2A?displayProperty=fullName> プロパティ値と要求行の文字列を結合して、変換された URI を作成します。  また、`http.sys` と <xref:System.Uri?displayProperty=fullName> クラスでは、次の処理も行います。  
+  
+-   パーセント記号をエンコードしたすべての値のエスケープを解除します。  
+  
+-   パーセント記号をエンコードした非 ASCII 文字を UTF\-16 文字表現に変換します。  UTF\-8 文字および ANSI\/DBCS 文字も Unicode 文字 \(%uXXXX 形式を使用した Unicode エンコーディング\) と同様にサポートされることに注意してください。  
+  
+-   パスの圧縮など、その他の正規化手順を実行します。  
+  
+ パーセント記号をエンコードした値に使用されているエンコーディングに関する情報は要求に含まれていないため、パーセント記号をエンコードした値を解析するだけでは、正しいエンコーディングを判断できない場合があります。  
+  
+ そのため、`http.sys` には、次に示すように、この処理を変更するためのレジストリ キーが 2 つ用意されています。  
+  
+|レジストリ キー|既定値|説明|  
+|--------------|---------|--------|  
+|EnableNonUTF8|1|ゼロの場合、`http.sys` は UTF\-8 エンコードの URL のみ受け入れます。<br /><br /> ゼロ以外の場合、`http.sys` は要求で ANSI エンコードの URL または DBCS エンコードの URL も受け入れます。|  
+|FavorUTF8|1|ゼロ以外の場合、`http.sys` は常に最初に URL を UTF\-8 としてデコードしようとします。その変換が失敗した場合、EnableNonUTF8 がゼロ以外のときは、ANSI または DBCS としてデコードしようとします。<br /><br /> ゼロ \(かつ EnableNonUTF8 がゼロ以外\) の場合、`http.sys` は URL を ANSI または DBCS としてデコードしようとします。失敗した場合は、UTF\-8 変換を試行します。|  
+  
+ <xref:System.Net.HttpListener> は要求を受け取ると、`http.sys` からの変換された URI を <xref:System.Net.HttpListenerRequest.Url%2A> プロパティへの入力として使用します。  
+  
+ URI では文字と数字以外の文字 \(記号など\) をサポートする必要があります。  例を次に示します。この URI は、顧客番号 "1\/3812" の顧客情報を取得するために使用するものです。  
+  
+ `http://www.contoso.com/Customer('1%2F3812')/`  
+  
+ Uri のパーセント記号をエンコードしたスラッシュに注目してください \(%2F\)。  この場合、スラッシュ文字はデータを表し、パス区切り記号ではないため、この処理は必要です。  
+  
+ この文字列をそのまま Uri コンストラクターに渡すと、次の URI になります。  
+  
+ `http://www.contoso.com/Customer('1/3812')/`  
+  
+ パスはセグメントに分割され、次の要素になります。  
+  
+ `Customer('1`  
+  
+ `3812')`  
+  
+ これでは、要求の送信元の意図とは異なります。  
+  
+ **unescapeRequestUrl** 属性が **false** に設定されている場合、<xref:System.Net.HttpListener> は要求を受け取ると、`http.sys` からの変換された URI ではなく生の URI を <xref:System.Net.HttpListenerRequest.Url%2A> プロパティへの入力として使用します。  
+  
+ **unescapeRequestUrl** 属性の既定値は **true** です。  
+  
+ <xref:System.Net.Configuration.HttpListenerElement.UnescapeRequestUrl%2A> プロパティを使用すると、適用可能な構成ファイルから **unescapeRequestUrl** 属性の現在の値を取得できます。  
+  
+## 使用例  
+ 要求を受け取ったときに、`http.sys` からの変換された URI ではなく生の URI を <xref:System.Net.HttpListenerRequest.Url%2A> プロパティへの入力として使用するように、<xref:System.Net.HttpListener> クラスを構成する方法を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <settings>  
+      <httpListener  
+        unescapeRequestUrl="false"  
+      />  
+    </settings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 要素情報  
+  
+|||  
+|-|-|  
+|名前空間|System.Net|  
+|スキーマ名||  
+|検証ファイル||  
+|空も使用できる||  
+  
+## 参照  
+ <xref:System.Net.Configuration.HttpListenerElement>   
+ <xref:System.Net.HttpListener>   
+ <xref:System.Net.HttpListenerRequest.Url%2A>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/httpwebrequest-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/httpwebrequest-element-network-settings.md
new file mode 100644
index 00000000000..2e074af6704
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/httpwebrequest-element-network-settings.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;httpWebRequest&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/httpWebRequest"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#httpWebRequest"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<httpWebRequest> 要素"
+  - "httpWebRequest 要素"
+ms.assetid: 52acd9d2-5bdc-4dc4-9c2a-f0a476ccbb31
+caps.latest.revision: 18
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 18
+---
+# &lt;httpWebRequest&gt; 要素 (ネットワーク設定)
+Web 要求パラメーターをカスタマイズします。  
+  
+## 構文  
+  
+```  
+  
+      <httpWebRequest  
+  maximumResponseHeadersLength="size"  
+  maximumErrorResponseLength="size"  
+  maximumUnauthorizedUploadLength="size"  
+  useUnsafeHeaderParsing="true|false"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`maximumResponseHeadersLength`|応答ヘッダーの最大長を KB で指定します。  既定値は 64 です。  \-1 の値は、応答ヘッダーにサイズ制限が設定されていないことを示しています。|  
+|`maximumErrorResponseLength`|エラー応答の最大長を KB で指定します。  既定値は 64 です。  \-1 の値は、エラー応答にサイズ制限が設定されていないことを示しています。|  
+|`maximumUnauthorizedUploadLength`|未承認エラー コードに応答してアップロードする最大長をバイトで指定します。  既定値は \-1 です。  値 \-1 は、アップロード情報にサイズ制限が適用されないことを示します。|  
+|`useUnsafeHeaderParsing`|安全でないヘッダー解析が有効であるかどうかを指定します。  既定値は `false` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+ 既定では、.NET Framework は URI 解析に対して RFC 2616 を厳密に適用します。  一部のサーバーの応答では、禁止されたフィールドに制御文字が含まれる場合があり、<xref:System.Net.HttpWebRequest.GetResponse?displayProperty=fullName> メソッドが <xref:System.Net.WebException> をスローする原因となります。  **useUnsafeHeaderParsing** が **true** に設定されている場合、<xref:System.Net.HttpWebRequest.GetResponse?displayProperty=fullName> はスローしませんが、アプリケーションはいくつかのフォームの URI 解析攻撃を受けやすくなります。  最良のソリューションは、応答に制御文字が含まれないように、サーバーを変更することです。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 次のコード例は、通常の最大ヘッダー長より大きい値を指定する方法を示しています。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <settings>  
+      <httpWebRequest  
+        maximumResponseHeadersLength="128"  
+      />  
+    </settings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.HttpWebRequest.MaximumResponseHeadersLength%2A>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md b/docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md
new file mode 100644
index 00000000000..7f06dd0c754
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md
@@ -0,0 +1,111 @@
+---
+title: "&lt;idn&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 16c8e869-1791-4cf5-9244-3d3c738f60ec
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;idn&gt; 要素 (Uri 設定)
+国際化ドメイン名 \(IDN: Internationalized Domain Name\) による解析をドメイン名に適用するかどうかを指定します。  
+  
+## スキーマの階層  
+ [\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<Uri\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)  
+  
+ [\<idn\>](../../../../../docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md)  
+  
+## 構文  
+  
+```  
+<idn  
+  enabled="All|AllExceptIntranet|None"  
+/idn>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|`enabled`|ドメイン名に国際化ドメイン名 \(IDN: Internationalized Domain Name\) による解析を適用するかどうかを指定します。既定値は None です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[uri](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)|URI \(Uniform Resource Identifier\) で表現された Web アドレスが .NET Framework によってどのように処理されるかの設定を格納します。|  
+  
+## 解説  
+ .NET Framework 3.5、3.0 SP1、および 2.0 SP1 では、既存の <xref:System.Uri> クラスが拡張され、IRI \(International Resource Identifier\) および国際化ドメイン名 \(IDN: Internationalized Domain Name\) をサポートするようになりました。  現在のユーザーからは、明確に IRI と IDN サポートを有効にしない限り、.NET Framework 2.0 の動作からの変更点は見えません。  これにより、以前のバージョンの .NET Framework との互換性が確保されます。  
+  
+ IRI のサポートを有効にするには、次の 2 点を変更する必要があります。  
+  
+1.  .NET Framework 2.0 ディレクトリの machine.config ファイルに次の行を追加する。  
+  
+    ```  
+    <section name="uri" type="System.Configuration.UriSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+    ```  
+  
+2.  ドメイン名に国際化ドメイン名 \(IDN: Internationalized Domain Name\) による解析を適用するか、IRI の解析規則を適用するかを指定します。  これは machine.config ファイルまたは app.config ファイルで行うことができます。  
+  
+ 使用する DNS サーバーに応じて、IDN がとりうる値は次の 3 つです。  
+  
+-   idn enabled \= All  
+  
+     この値は、Unicode のドメイン名があれば、それを等価の Punycode \(IDN 名\) に変換します。  
+  
+-   idn enabled \= AllExceptIntranet  
+  
+     この値は、ローカルなイントラネット以外のすべての Unicode ドメイン名を、等価の Punycode \(IDN 名\) を使用するように変換します。  このように、ローカルなイントラネットで国際名を処理する場合、このイントラネットで使用する DNS サーバーは Unicode の名前解決をサポートしている必要があります。  
+  
+-   idn enabled \= None  
+  
+     この値は、どの Unicode のドメイン名も、Punycode を使用するように変換しません。  これが既定値であり、.NET Framework 2.0 の動作と同じです。  
+  
+ IDN を有効にすると、ドメイン名に含まれるすべての Unicode ラベルが等価の Punycode に変換されます。  Punycode 名は ASCII 文字だけで構成され、必ず xn\-\- というプレフィックスで始まります。  この目的は、インターネット上の既存の DNS サーバーをサポートすることです。ほとんどの DNS サーバーは、ASCII 文字しかサポートしていません \(RFC 3940 を参照\)。  
+  
+### 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 例  
+  
+### 説明  
+ 次のコード例は、<xref:System.Uri> クラスで IRI の解析および IDN 名をサポートするための構成を示しています。  
+  
+### コード  
+  
+```  
+<configuration>  
+  <uri>  
+    <idn enabled="All" />  
+    <iriParsing enabled="true" />  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Configuration.IdnElement?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/index.md b/docs/framework/configure-apps/file-schema/network/index.md
new file mode 100644
index 00000000000..634ef2099b5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/index.md
@@ -0,0 +1,57 @@
+---
+title: "ネットワーク設定スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成の設定 [.NET Framework], ネットワーク"
+  - "接続 [.NET Framework], ネットワーク構成要素"
+  - "要素 [.NET Framework], ネットワーク構成要素"
+  - "インターネット, ネットワーク構成要素"
+  - "ネットワーク構成要素"
+  - "ネットワーク リソース, ネットワーク構成要素"
+  - "ネットワーク設定"
+  - "受信 (データを), ネットワーク構成要素"
+  - "送信 (データを), ネットワーク構成要素"
+ms.assetid: f1de5a0f-76c5-4833-819f-5222b8146340
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# ネットワーク設定スキーマ
+ネットワーク設定は、.NET Framework がインターネットに接続する方法を指定します。  [\<system.Net\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md) 下の各子構成要素の機能を説明する表を次に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<authenticationModules\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md)|インターネット要求を認証するために使用するモジュールを指定します。|  
+|[\<connectionManagement\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md)|インターネット ホストへの接続の最大数を指定します。|  
+|[\<defaultProxy\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md)|インターネットへの HTTP 要求のために使用するプロキシ サーバーを指定します。|  
+|[\<mailSettings\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md)|メール送信オプションの設定を格納します。|  
+|[\<requestCaching\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)|インターネット ホストからの情報を要求するために使用するモジュールを指定します。|  
+|[\<requestCaching\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)|<xref:System.Net?displayProperty=fullName> 名前空間の基本的なネットワーク オプションを構成します。|  
+|[\<webRequestModules\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md)|インターネット ホストからの情報を要求するために使用するモジュールを指定します。|  
+  
+ Uri の設定は、.NET Framework は URI \(Uniform Resource Identifiers \(URIs\) を使用\) で表現された Web アドレスがどのように処理するかを指定します。  [\<Uri\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md) 下の各子構成要素の機能を説明する表を次に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<idn\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md)|国際化ドメイン名 \(IDN: Internationalized Domain Name\) による解析をドメイン名に適用するかどうかを指定します。|  
+|[\<iriParsing\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md)|IRI \(International Resource Identifier\) 解析を <xref:System.Uri> に適用するかどうか、および IRI の解析規則を適用するかどうかを指定します。|  
+|[\<schemeSettings\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md)|<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。|  
+  
+## 参照  
+ [構成 \(インターネット アプリケーションを\)](../../../../../docs/framework/network-programming/configuring-internet-applications.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md
new file mode 100644
index 00000000000..b2440319a65
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;ipv6&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/ipv6"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#ipv6"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<ipv6> 要素"
+  - "ipv6 要素"
+ms.assetid: 10b79aef-327b-4718-a892-e11f55e4d169
+caps.latest.revision: 19
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 19
+---
+# &lt;ipv6&gt; 要素 (ネットワーク設定)
+<xref:System.Net.Dns> クラスにある旧形式のメンバーで Internet Protocol Version 6 \(IPv6\) に対応できるようにします。  
+  
+## 構文  
+  
+```  
+  
+      <ipv6  
+  enabled="true|false"  
+/ipv6>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`enabled`|<xref:System.Net.Dns> クラスのメンバーが Internet Protocol Version 6 \(IPv6\) のアドレスを返すかどうかを指定します。  既定値は `false` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+ この設定を行うと、<xref:System.Net.Dns> クラスの <xref:System.Net.Dns.BeginGetHostByName%2A>、<xref:System.Net.Dns.BeginResolve%2A>、<xref:System.Net.Dns.EndGetHostByName%2A>、<xref:System.Net.Dns.EndResolve%2A>、<xref:System.Net.Dns.GetHostByAddress%2A>、<xref:System.Net.Dns.GetHostByName%2A>、および <xref:System.Net.Dns.Resolve%2A> の旧形式のメンバーで、IPv6 のサポートが有効になります。  <xref:System.Net?displayProperty=fullName> 名前空間の他のメンバーでは、オペレーティング システムで IPv6 が有効であれば、IPv6 形式のアドレスを返すことができます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ <xref:System.Net.Dns> クラスの IPv6 サポートを有効にするコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <settings>  
+      <ipv6 enabled="true"/>  
+    </settings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net?displayProperty=fullName>   
+ <xref:System.Net.Dns?displayProperty=fullName>   
+ <xref:System.Net.Sockets.Socket.OSSupportsIPv6%2A?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md b/docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md
new file mode 100644
index 00000000000..f87c8473e15
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;iriParsing&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 953d0b53-445e-41f9-b302-77c4030852ce
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;iriParsing&gt; 要素 (Uri 設定)
+IRI \(International Resource Identifier\) 解析を <xref:System.Uri> に適用するかどうか、および IRI の解析規則を適用するかどうかを指定します。  
+  
+## スキーマの階層  
+ [\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<Uri\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)  
+  
+ [\<iriParsing\>](../../../../../docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md)  
+  
+## 構文  
+  
+```  
+<idn  
+  enabled="true|false"  
+/idn>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|`enabled`|IRI の解析が有効かどうかを指定します。  既定値は `false` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[uri](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)|URI \(Uniform Resource Identifier\) で表現された Web アドレスが .NET Framework によってどのように処理されるかの設定を格納します。|  
+  
+## 解説  
+ .NET Framework 3.5、3.0 SP1、および 2.0 SP1 では、既存の <xref:System.Uri> クラスが拡張され、IRI \(International Resource Identifier\) および国際化ドメイン名 \(IDN: Internationalized Domain Name\) をサポートするようになりました。  現在のユーザーからは、明確に IRI と IDN サポートを有効にしない限り、.NET Framework 2.0 の動作からの変更点は見えません。  これにより、以前のバージョンの .NET Framework との互換性が確保されます。  
+  
+ IRI のサポートを有効にするには、次の 2 点を変更する必要があります。  
+  
+1.  .NET Framework 2.0 ディレクトリの machine.config ファイルに次の行を追加する。  
+  
+    ```  
+    <section name="uri" type="System.Configuration.UriSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+    ```  
+  
+2.  IRI の解析規則を適用するかどうかを指定する。  これは machine.config ファイルまたは app.config ファイルで行うことができます。  
+  
+ IRI 解析を有効にする \(iriParsing enabled \= `true`\) と、RFC 3987 の最新の IRI 規則に従って、正規化と文字チェックが行われます。  既定値は、`false` で、RFC 2396 および RFC 3986 に従って正規化と文字チェックが行われます \(IPv6 リテラルの場合\)  
+  
+### 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 例  
+  
+### 説明  
+ 次のコード例は、<xref:System.Uri> クラスで IRI の解析および IDN 名をサポートするための構成を示しています。  
+  
+### コード  
+  
+```  
+<configuration>  
+  <uri>  
+    <idn enabled="All" />  
+    <iriParsing enabled="true" />  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Configuration.IriParsingElement?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md
new file mode 100644
index 00000000000..336bf0b0a7b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;mailSettings&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#mailSettings"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/mailSettings"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<mailSettings> 要素"
+  - "mailSettings 要素"
+ms.assetid: 54f0f153-17e5-4f49-afdc-deadb940c9c1
+caps.latest.revision: 20
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 20
+---
+# &lt;mailSettings&gt; 要素 (ネットワーク設定)
+電子メールの送信オプションを設定します。  
+  
+## 構文  
+  
+```  
+  
+      <mailSettings  
+  <smtp> … </smtp>  
+/mailsettings>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|[\<smtp\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md)|SMTP \(Simple Mail Transport Protocol\) オプションを設定します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[\<system.Net\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 使用例  
+ 既定のネットワーク資格情報を使用して電子メールを送信するために、適切な SMTP パラメーターを指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <mailSettings>  
+      <smtp deliveryMethod="network">  
+        <network  
+          host="localhost"  
+          port="25"  
+          defaultCredentials="true"  
+        />  
+      </smtp>  
+    </mailSettings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Mail.SmtpClient>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/module-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/module-element-network-settings.md
new file mode 100644
index 00000000000..de4bf6b662f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/module-element-network-settings.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;module&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#module"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/module"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<module> 要素"
+  - "module 要素"
+ms.assetid: 10318725-9666-4d65-ab61-b94c64e59f13
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;module&gt; 要素 (ネットワーク設定)
+新しいプロキシ モジュールをアプリケーションに追加します。  
+  
+## 構文  
+  
+```  
+  
+      <module   
+   type = "name", System, Version="version number", Culture="culture", PublicKeyToken="token" "   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`type`|プロキシを実装するモジュールの名前および詳細。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[defaultProxy](../../../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md)|ハイパーテキスト転送プロトコル \(HTTP: Hypertext Transfer Protocol\) プロキシ サーバーを構成します。|  
+  
+## 解説  
+ `module` 要素は、<xref:System.Net.IWebProxy> インターフェイスを実装するプロキシ クラスを登録します。  プロキシ クラスを登録したら、`module` がサポートされたプロキシによって情報を要求するために使用できます。  
+  
+ `type` 属性の値には、有効なダイナミック リンク ライブラリ \(DLL: Dynamic Link Library\) の名前およびこのモジュールの名前を指定する必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ カスタム プロキシ クラスを登録するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <module  
+        type = "Test.CustomWebProxy, System, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+      />  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.IWebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/network-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/network-element-network-settings.md
new file mode 100644
index 00000000000..102e630891e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/network-element-network-settings.md
@@ -0,0 +1,123 @@
+---
+title: "&lt;network&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#network"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/mailSettings/smtp/network"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<network> 要素"
+  - "network 要素"
+ms.assetid: 2c2c6ad4-ed11-48ab-b28e-2bc0ba9b42c7
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;network&gt; 要素 (ネットワーク設定)
+外部 SMTP \(Simple Mail Transport Protocol\) サーバー用のネットワーク オプションを設定します。  
+  
+## 構文  
+  
+```  
+  
+      <network  
+  clientDomain="string"   
+  defaultCredentials="true|false"  
+  enableSsl="true|false"  
+  host="string"   
+  password="string"  
+  port="integer"   
+  targetName="string"  
+  userName="string"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`clientDomain`|SMTP メール サーバーに接続するために最初の SMTP プロトコル要求で使用するクライアント ドメイン名を指定します。  既定値は、要求を送信するローカル コンピューターの localhost 名です。|  
+|`defaultCredentials`|SMTP トランザクションで SMTP メール サーバーにアクセスするために既定のユーザー資格情報を使用するかどうかを指定します。  既定値は `false` です。|  
+|`enableSsl`|SMTP メール サーバーへのアクセスに SSL を使用するかどうかを指定します。  既定値は `false` です。|  
+|`host`|SMTP トランザクションに使用する SMTP メール サーバーのホスト名を指定します。  この属性には既定値はありません。|  
+|`password`|SMTP メール サーバーへの認証に使用するパスワードを指定します。  この属性には既定値はありません。|  
+|`port`|SMTP メール サーバーへの接続に使用するポート番号を指定します。  既定値は 25 です。|  
+|`targetName`|SMTP トランザクションで拡張保護を使用している場合に認証に使用するサービス プロバイダー名 \(SPN: Service Provider Name\) を指定します。  この属性には既定値はありません。|  
+|`userName`|SMTP メール サーバーへの認証に使用するユーザー名を指定します。  この属性には既定値はありません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<smtp\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md)|SMTP \(Simple Mail Transport Protocol\) の電子メール送信オプションを設定します。|  
+  
+## 解説  
+ 一部の SMTP サーバーでは、使用する前にユーザー認証を受けることが要求されます。  ホストの既定のネットワーク資格情報を使用してユーザー認証を受けるには、`defaultCredentials` 属性を `true` に設定します。  <xref:System.Net.Configuration.SmtpNetworkElement.DefaultCredentials%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `defaultCredentials` 属性の現在の値を取得できます。  
+  
+ 基本認証 \(ユーザー名およびパスワード\) を使用して SMTP サーバーのユーザー認証を受けることもできます。  このオプションを使用するには、指定した SMTP サーバーで有効なユーザー名およびパスワードを指定する必要があります。  
+  
+> [!NOTE]
+>  基本認証では、`userName` の値および `password` の値が暗号化されることなくサーバーに送信されます。  ネットワーク トラフィックを監視している者があれば、この資格情報を参照でき、これを使用してサーバーに接続できます。  Kerberos、NT LAN Manager \(NTLM.\) など、より安全な認証方式を使用することを検討してください。`defaultCredentials` が `true` の場合、サーバーでサポートされている場合は、Kerberos または NTLM が使用されます。  
+  
+ 基本認証オプションと既定のネットワーク資格情報オプションは相互に排他的です。`defaultCredentials` を `true` に設定し、ユーザー名およびパスワードを指定すると、既定のネットワーク資格情報が使用され、基本認証データは無視されます。  
+  
+ 基本認証で `userName` を指定する場合は、メール サーバーの認証を受けるために `password` も指定する必要があります。  
+  
+ <xref:System.Net.Configuration.SmtpNetworkElement.UserName%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `userName` 属性の現在の値を取得できます。  <xref:System.Net.Configuration.SmtpNetworkElement.Password%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `password` 属性の現在の値を取得できます。  セキュリティ上の理由から、通常、`password` 属性は構成ファイルに入力されません。  
+  
+ `clientDomain` 属性は、SMTP サーバーへの最初の SMTP プロトコル要求で使用されるクライアント ドメイン名を変更します。  `clientDomain` 属性は、既定で使用される localhost 名ではなく、ローカル コンピューターの完全修飾ドメイン名に設定できます。  これにより、SMTP プロトコル標準への準拠が向上します。  既定値は、要求を送信するローカル コンピューターの localhost 名です。  <xref:System.Net.Configuration.SmtpNetworkElement.ClientDomain%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `clientDomain` 属性の現在の値を取得できます。  
+  
+ `targetName` 属性は、拡張保護を使用している場合に認証に使用します。  既定値はフォーム「SMTPSVC\/host\<\>」ホストが \<SMTP メール サーバー\> のホスト名である場所です。  <xref:System.Net.Configuration.SmtpNetworkElement.TargetName%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `targetName` 属性の現在の値を取得できます。  
+  
+ `enableSsl`  属性は、SMTP メール サーバーへのアクセスに SSL を使用するかどうかを指定します。  <xref:System.Net.Mail.SmtpClient?displayProperty=fullName> クラスでサポートされているのは、RFC 3207 で定義されている SMTP Service Extension for Secure SMTP over Transport Layer Security のみです。  このモードでは、SMTP セッションが暗号化されていないチャネルで開始されます。その後、SSL によるセキュリティで保護された通信に切り替えるために、クライアントからサーバーに対して STARTTLS コマンドが実行されます。  詳細については、インターネット技術標準化委員会 \(IETF: Internet Engineering Task Force\) から発行された RFC 3207 を参照してください。  
+  
+ 事前に SSL セッションが確立され、その後にプロトコル コマンドが送信されるという、代替接続方法もあります。  この接続方法は SMTPS とも呼ばれ、既定ではポート 465 を使用します。  SSL を使用するこの代替接続方法は、現在はサポートされていません。  
+  
+ <xref:System.Net.Configuration.SmtpNetworkElement.EnableSsl%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから `enableSsl` 属性の現在の値を取得できます。  
+  
+## 使用例  
+ 既定のネットワーク資格情報を使用して電子メールを送信するために、適切な SMTP パラメーターを指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <mailSettings>  
+      <smtp deliveryMethod="network">  
+        <network  
+          clientDomain="www.contoso.com"  
+          defaultCredentials="true"  
+          enableSsl="false"  
+          host="mail.contoso.com"  
+          port="25"  
+        />  
+      </smtp>  
+    </mailSettings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Configuration.SmtpNetworkElement?displayProperty=fullName>   
+ <xref:System.Net.Configuration.SmtpSection?displayProperty=fullName>   
+ <xref:System.Net.Mail.SmtpClient?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/performancecounter-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/performancecounter-element-network-settings.md
new file mode 100644
index 00000000000..d100474cf8a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/performancecounter-element-network-settings.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;performanceCounters&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/performanceCounters"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#performanceCounters"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<performanceCounter> 要素"
+  - "performanceCounter 要素"
+ms.assetid: 3afa1586-e1b8-473d-8985-c3fc90cf561b
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;performanceCounters&gt; 要素 (ネットワーク設定)
+ネットワーク パフォーマンス カウンターを有効または無効にします。  
+  
+## 構文  
+  
+```  
+<performanceCounters  
+  enabled="true|false"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|ネットワーク パフォーマンス カウンターが有効になっているかどうかを指定します。  既定値は `false` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+ ネットワーク パフォーマンス カウンターは、使用される構成ファイルで有効になっている必要があります。  すべてのネットワーク パフォーマンス カウンターは、構成ファイル内の 1 つの設定で有効または無効にされます。  ネットワーク パフォーマンス カウンターを個別に有効または無効にすることはできません。  特定のネットワーク パフォーマンス カウンターの詳細については、「[Networking Performance Counters](http://msdn.microsoft.com/ja-jp/d1860235-f643-46ae-846c-ff0ed8b0e3cd)」を参照してください。  
+  
+ 既定では、ネットワーク パフォーマンス カウンターは無効に設定されます。  
+  
+ <xref:System.Net.Configuration.PerformanceCountersElement.Enabled%2A?displayProperty=fullName> プロパティを使用して、適用可能な構成ファイルから **enabled** 属性の現在の値を取得できます。  
+  
+## 使用例  
+ <xref:System.Net> およびそれに関連する名前空間をネットワーク パフォーマンス カウンターを有効にするように構成する方法を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <settings>  
+      <performanceCounters  
+        enabled="true"  
+      />  
+    </settings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Configuration.PerformanceCountersElement?displayProperty=fullName>   
+ <xref:System.Net.Configuration.PerformanceCountersElement.Enabled%2A?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)   
+ [Networking Performance Counters](http://msdn.microsoft.com/ja-jp/d1860235-f643-46ae-846c-ff0ed8b0e3cd)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/proxy-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/proxy-element-network-settings.md
new file mode 100644
index 00000000000..ddb602d639a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/proxy-element-network-settings.md
@@ -0,0 +1,103 @@
+---
+title: "&lt;proxy&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/proxy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#proxy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<proxy> 要素"
+  - "proxy 要素"
+ms.assetid: 37a548d8-fade-4ac5-82ec-b49b6c6cb22a
+caps.latest.revision: 20
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 20
+---
+# &lt;proxy&gt; 要素 (ネットワーク設定)
+プロキシ サーバーを定義します。  
+  
+## 構文  
+  
+```  
+  
+      <proxy   
+  autoDetect="true|false|unspecified"    
+  bypassonlocal="true|false|unspecified"   
+  proxyaddress="uriString"  
+  scriptLocation="uriString"   
+  usesystemdefault="true|false|unspecified "   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`autoDetect`|プロキシを自動的に検出するかどうかを指定します。  既定値は `unspecified` です。|  
+|`bypassonlocal`|ローカル リソースの場合に、プロキシがバイパスされるかどうかを指定します。  ローカル リソースには、ローカル サーバー \(http:\/\/localhost、http:\/\/loopback、または http:\/\/127.0.0.1\) やピリオドのない URI \(http:\/\/webserver\) が含まれます。  既定値は `unspecified` です。|  
+|`proxyaddress`|使用するプロキシ URI を指定します。|  
+|`scriptLocation`|構成スクリプトの場所を指定します。|  
+|`usesystemdefault`|Internet Explorer のプロキシ設定を使用するかどうかを指定します。  `true` に設定されている場合、後続の属性は Internet Explorer のプロキシ設定をオーバーライドします。  既定値は `unspecified` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[defaultProxy](../../../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md)|ハイパーテキスト転送プロトコル \(HTTP: Hypertext Transfer Protocol\) プロキシ サーバーを構成します。|  
+  
+## テキスト値  
+  
+## 解説  
+ `proxy` 要素は、アプリケーションのプロキシ サーバーを定義します。  この要素が構成ファイルで見つからない場合、.NET Framework では、Internet Explorer のプロキシ設定が使用されます。  
+  
+ `proxyaddress` 属性の値は、整形式 URI \(Uniform Resource Indicator\) で指定する必要があります。  
+  
+ `scriptLocation` 属性は、プロキシ構成スクリプトの自動検出を意味します。  Internet Explorer で、**\[自動構成スクリプトを使用する\]** チェック ボックスがオンの場合、<xref:System.Net.WebProxy> クラスでは、構成スクリプト \(通常は Wpad.dat ファイル\) の検出が試みられます。  
+  
+ Version 2.0 に移行中の .NET Framework Version 1.1 アプリケーションの場合は、`usesystemdefault` 属性を使用してください。  
+  
+ `proxyaddress` 属性で無効な既定のプロキシが指定されている場合、例外がスローされます。  例外の <xref:System.Exception.InnerException%2A> プロパティに、このエラーの根本的な原因に関する詳細情報が含まれています。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ Internet Explorer プロキシの既定値を使用し、プロキシ アドレスを指定し、ローカル アクセスのプロキシをバイパスするコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <proxy  
+        usesystemdefault="true"  
+        proxyaddress="http://192.168.1.10:3128"  
+        bypassonlocal="true"  
+      />  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/remove-element-for-authenticationmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/remove-element-for-authenticationmodules-network-settings.md
new file mode 100644
index 00000000000..b165e9becb4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/remove-element-for-authenticationmodules-network-settings.md
@@ -0,0 +1,86 @@
+---
+title: "authenticationModules の &lt;remove&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/authenticationModules/remove"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<authenticationModules>, remove 要素"
+  - "<remove> 要素, authenticationModules"
+  - "authenticationModules, remove 要素"
+  - "remove 要素, authenticationModules"
+ms.assetid: abf79949-b05c-465a-b51c-bbeda9a74173
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# authenticationModules の &lt;remove&gt; 要素 (ネットワーク設定)
+認証モジュールをアプリケーションから削除します。  
+  
+## 構文  
+  
+```  
+  
+      <remove   
+   name = "authentication module name"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|**name**|削除する認証モジュールの名前。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[authenticationModules](../../../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md)|ネットワーク要求を認証するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `remove` 要素は、構成ファイルまたは構成階層の上位レベルで既に定義されている認証モジュールを削除します。  
+  
+ `name` 属性の値は、有効なクラス名である必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 認証モジュールを削除するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <authenticationModules>  
+      <remove name = "System.Net.NtlmClient" />  
+    </authenticationModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.IAuthenticationModule>   
+ <xref:System.Net.AuthenticationManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/remove-element-for-bypasslist-network-settings.md b/docs/framework/configure-apps/file-schema/network/remove-element-for-bypasslist-network-settings.md
new file mode 100644
index 00000000000..9e1058b52a8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/remove-element-for-bypasslist-network-settings.md
@@ -0,0 +1,90 @@
+---
+title: "bypasslist の &lt;remove&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/defaultProxy/bypasslist/remove"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<bypasslist>, remove 要素"
+  - "bypasslist, remove 要素"
+  - "remove 要素, bypasslist"
+  - "remove 要素, bypasslist"
+ms.assetid: 61dcfb4a-e3d9-4abf-a2cd-7d685fe2f64b
+caps.latest.revision: 16
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 16
+---
+# bypasslist の &lt;remove&gt; 要素 (ネットワーク設定)
+IP アドレスまたは DNS 名をプロキシ バイパス リストから削除します。  
+  
+## 構文  
+  
+```  
+  
+      <remove   
+   name = "regular expression"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`name`|IP アドレスまたは DNS 名を記述する正規表現。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[bypasslist](../../../../../docs/framework/configure-apps/file-schema/network/bypasslist-element-network-settings.md)|プロキシを使用しないアドレスを記述する一連の正規表現を提供します。|  
+  
+## 解説  
+ `remove` 要素は、IP アドレスまたは DNS サーバー名を記述する正規表現を、プロキシ サーバーをバイパスするアドレスのリストから削除します。  アドレスは構成ファイルまたは構成階層の上位レベルで既に定義されています。  
+  
+ `name` 属性の値は、一組の IP アドレスまたはホスト名を記述する正規表現である必要があります。  
+  
+ 正規表現の詳細については、「[.NET Framework の正規表現](../../../../../docs/standard/base-types/regular-expressions.md)」を参照してください。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ adventure\-works.com ドメインで既に定義されているすべてのエントリを削除し、contoso.com ドメインをバイパス リストに追加するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <defaultProxy>  
+      <bypasslist>  
+        <remove name = "[a-z]+\.adventure-works\.com$" />  
+        <add address="[a-z]+\.contoso\.com$" />  
+      </bypasslist>  
+    </defaultProxy>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/remove-element-for-connectionmanagement-network-settings.md b/docs/framework/configure-apps/file-schema/network/remove-element-for-connectionmanagement-network-settings.md
new file mode 100644
index 00000000000..85b2a3c19ca
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/remove-element-for-connectionmanagement-network-settings.md
@@ -0,0 +1,88 @@
+---
+title: "connectionManagement の &lt;remove&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/connectionManagement/remove"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<connectionManagement>, remove 要素"
+  - "<remove> 要素, connectionManagement"
+  - "connectionManagement, remove 要素"
+  - "remove 要素, connectionManagement"
+ms.assetid: 94b81775-5a22-4975-8c47-8620c40c3f35
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# connectionManagement の &lt;remove&gt; 要素 (ネットワーク設定)
+IP アドレスまたは DNS 名を接続管理リストから削除します。  
+  
+## 構文  
+  
+```  
+  
+      <remove   
+   name = "server name or IP address"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`address`|IP アドレスまたは DNS 名。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[connectionManagement](../../../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md)|ネットワーク ホストへの接続の最大数を指定します。|  
+  
+## 解説  
+ `remove` 要素は、指定されたサーバーの接続管理リスト エントリを削除します。  
+  
+ `address` 属性の値は、有効な IP アドレスまたはホスト名である必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ サーバー www.adventure\-works.com のすべての接続管理リスト エントリを削除し、アプリケーションの構成でサーバー www.contoso.com への接続数を 4、それ以外のすべてのサーバーへの接続数を 2 に指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <connectionManagement>  
+      <remove address = "http://www.adventure-works.com"/>  
+      <add address = "http://www.contoso.com" maxconnection = "4" />  
+      <add address = "*" maxconnection = "2" />  
+    </connectionManagement>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.ServicePoint>   
+ <xref:System.Net.ServicePointManager>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/remove-element-for-schemesettings-uri-settings.md b/docs/framework/configure-apps/file-schema/network/remove-element-for-schemesettings-uri-settings.md
new file mode 100644
index 00000000000..6cf51c6f70a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/remove-element-for-schemesettings-uri-settings.md
@@ -0,0 +1,92 @@
+---
+title: "schemeSettings の &lt;remove&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 4095ba51-de20-4f87-b562-018abe422c91
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# schemeSettings の &lt;remove&gt; 要素 (Uri 設定)
+スキーム名に対するスキーム設定を削除します。  
+  
+## 構文  
+  
+```  
+  
+      <remove   
+   <name = "http|https"/>  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|name|この設定を適用するスキーム名。  サポートされている値は、name\="http" と name\="https" だけです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<schemeSettings\> 要素 \(Uri 設定\)](../../../../../docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md)|<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。|  
+  
+## 解説  
+ 既定では、<xref:System.Uri?displayProperty=fullName> クラスは、パスの圧縮を実行する前に、パーセント記号をエンコードしたパス区切り記号のエスケープを解除します。  これは、次のような攻撃に対するセキュリティ機構として実装されました。  
+  
+ `http://www.contoso.com/..%2F..%2F/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ パーセント記号をエンコードした文字を正しく処理できないモジュールにこの URI が渡されると、次のコマンドがサーバーによって実行されます。  
+  
+ `c:\Windows\System32\cmd.exe /c dir c:\`  
+  
+ このため、<xref:System.Uri?displayProperty=fullName> クラスでは、パス区切り記号のエスケープを解除してから、パスの圧縮を適用します。  上のような悪意のある URL を <xref:System.Uri?displayProperty=fullName> クラス コンストラクターに渡した場合、次の URI になります。  
+  
+ `http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ この既定の動作は、特定のスキームの schemeSettings 構成オプションを使用して、パーセント記号をエンコードしたパス区切り記号のエスケープを解除しないように変更できます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ http スキームのスキーム設定をすべて削除する、<xref:System.Uri> クラスで使用する構成を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <uri>  
+    <schemeSettings>  
+      <remove name="http"/>  
+    </schemeSettings>  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Configuration.SchemeSettingElement?displayProperty=fullName>   
+ <xref:System.Configuration.SchemeSettingElementCollection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection.SchemeSettings%2A?displayProperty=fullName>   
+ <xref:System.GenericUriParserOptions?displayProperty=fullName>   
+ <xref:System.Uri?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/remove-element-for-webrequestmodules-network-settings.md b/docs/framework/configure-apps/file-schema/network/remove-element-for-webrequestmodules-network-settings.md
new file mode 100644
index 00000000000..50c75672fea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/remove-element-for-webrequestmodules-network-settings.md
@@ -0,0 +1,89 @@
+---
+title: "webRequestModules の &lt;remove&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/webRequestModules/remove"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<remove> 要素, webRequestModules"
+  - "<webRequestModules>, remove 要素"
+  - "remove 要素, webRequestModules"
+  - "webRequestModules, remove 要素"
+ms.assetid: dd84d2fe-2f4f-457a-9d3c-441d0d21cc10
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# webRequestModules の &lt;remove&gt; 要素 (ネットワーク設定)
+カスタム Web 要求モジュールをアプリケーションから削除します。  
+  
+## 構文  
+  
+```  
+  
+      <remove   
+  name = "URI prefix"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`name`|この Web 要求モジュールで処理される要求の URI プレフィックス。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[webRequestModules](../../../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md)|ネットワーク ホストからの情報を要求するために使用するモジュールを指定します。|  
+  
+## 解説  
+ `remove` 要素では、指定された URI プレフィックスに対する登録済み Web 要求モジュールを削除します。  
+  
+ `prefix` 属性の値は、"http" や "http:\/\/www.contoso.com" のように、有効な URI の先行文字である必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ HTTP 用の既存の Web 要求モジュールを削除し、www.contoso.com に対する HTTP 要求用の新規カスタム Web 要求モジュールを登録するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <webRequestModules>  
+      <remove prefix = "http">  
+      <add prefix="http"  
+           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
+           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+      />  
+    </webRequestModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebRequest>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md
new file mode 100644
index 00000000000..1e120c40f03
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;requestCaching&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#requestCaching"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/requestCaching"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<requestCaching> 要素"
+  - "requestCaching 要素"
+ms.assetid: 9962a2fe-cbda-41a6-9377-571811eaea84
+caps.latest.revision: 20
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 20
+---
+# &lt;requestCaching&gt; 要素 (ネットワーク設定)
+ネットワーク要求のキャッシュ機構を制御します。  
+  
+## 構文  
+  
+```  
+  
+      <requestCaching  
+  isPrivateCache ="true|false"  
+  disableAllCaching="true|false"  
+  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
+  unspecifiedMaximumAge= "d.hh.mm.ss""  
+  <defaultHttpCachePolicy> … </defaultHttpCachePolicy>  
+  <defaultFtpCachePolicy> … </defaultFtpCachePolicy>  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`isPrivateCache`|キャッシュが、異なるユーザーの情報間で分離を提供するかどうかを指定します。  既定値は `true` です。  この値は、中間層アプリケーションの場合は `false` です。|  
+|`disableAllCaching`|キャッシュがすべての Web 応答に対して無効になっているため、プログラムでオーバーライドできないことを指定します。|  
+|`defaultPolicyLevel`|<xref:System.Net.Cache.RequestCacheLevel> 列挙値のいずれか。  既定値は `BypassCache` です。|  
+|`unspecifiedMaximumAge`|コンテンツを期限切れであるとマークするまでの、既定の時間を指定します。|  
+  
+## policyLevel 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`Default`|キャッシュされているリソースが最新であり、content length が正しく、expiration 属性、modification 属性、および content length 属性が指定されている場合、キャッシュされているリソースを返します。|  
+|`BypassCache`|サーバーからリソースを返します。|  
+|`CacheOnly`|content length が指定されており、エントリのサイズに一致する場合、キャッシュされているリソースを返します。|  
+|`CacheIfAvailable`|content length が指定されており、エントリのサイズに一致する場合には、キャッシュされているリソースを返します。その他の場合には、対象のリソースをサーバーからダウンロードした上で、呼び出し元に返します。|  
+|`Revalidate`|キャッシュされているリソースのタイムスタンプが、サーバー上のリソースのタイムスタンプと等しい場合には、キャッシュされているリソースを返します。その他の場合には、対象のリソースをサーバーからダウンロードし、キャッシュに格納した上で、呼び出し元に戻します。|  
+|`Reload`|対象のリソースをサーバーからダウンロードし、キャッシュに格納した上で、呼び出し元に返します。|  
+|`NoCacheNoStore`|キャッシュされたリソースが存在する場合は削除されます。  サーバーからリソースをダウンロードし、呼び出し元に返します。|  
+|`Revalidate`|キャッシュされているリソースのタイムスタンプが、サーバー上のリソースのタイムスタンプと一致する場合には、キャッシュされているリソースのコピーを返して、要求を満たします。その他の場合には、対象のリソースをサーバーからダウンロードして呼び出し元に返し、キャッシュに格納します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[defaultHttpCachePolicy](../../../../../docs/framework/configure-apps/file-schema/network/defaulthttpcachepolicy-element-network-settings.md)|省略可能な要素です。<br /><br /> HTTP キャッシュがアクティブであるかどうかを指定し、既定のキャッシュ ポリシーを記述します。|  
+|[\<defaultFtpCachePolicy\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/defaultftpcachepolicy-element-network-settings.md)|省略可能な要素です。<br /><br /> FTP キャッシュがアクティブであるかどうかを指定し、既定のキャッシュ ポリシーを記述します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[system.net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 使用例  
+ すべてのキャッシュを無効にする方法を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <requestCaching  
+      disableAllCaching="true"  
+    />  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Cache?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md b/docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md
new file mode 100644
index 00000000000..94ebb0433c4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;schemeSettings&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 0ae45c6e-8c4c-4c0d-8b9f-a93824648890
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# &lt;schemeSettings&gt; 要素 (Uri 設定)
+<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。  
+  
+## 構文  
+  
+```  
+  
+      <schemeSettings>   
+</schemeSettings>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[add](../../../../../docs/framework/configure-apps/file-schema/network/add-element-for-schemesettings-uri-settings.md)|スキーム名に対するスキーム設定を追加します。|  
+|[clear](../../../../../docs/framework/configure-apps/file-schema/network/clear-element-for-schemesettings-uri-settings.md)|既存のスキーム設定をすべて消去します。|  
+|[remove](../../../../../docs/framework/configure-apps/file-schema/network/remove-element-for-schemesettings-uri-settings.md)|スキーム名に対するスキーム設定を削除します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[uri](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)|URI \(Uniform Resource Identifier\) で表現された Web アドレスが .NET Framework によってどのように処理されるかの設定を格納します。|  
+  
+## 解説  
+ 既定では、<xref:System.Uri?displayProperty=fullName> クラスは、パスの圧縮を実行する前に、パーセント記号をエンコードしたパス区切り記号のエスケープを解除します。  これは、次のような攻撃に対するセキュリティ機構として実装されました。  
+  
+ `http://www.contoso.com/..%2F..%2F/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ パーセント記号をエンコードした文字を正しく処理できないモジュールにこの URI が渡されると、次のコマンドがサーバーによって実行されます。  
+  
+ `c:\Windows\System32\cmd.exe /c dir c:\`  
+  
+ このため、<xref:System.Uri?displayProperty=fullName> クラスでは、パス区切り記号のエスケープを解除してから、パスの圧縮を適用します。  上のような悪意のある URL を <xref:System.Uri?displayProperty=fullName> クラス コンストラクターに渡した場合、次の URI になります。  
+  
+ `http://www.microsoft.com/Windows/System32/cmd.exe?/c+dir+c:\`  
+  
+ この既定の動作は、特定のスキームの schemeSettings 構成オプションを使用して、パーセント記号をエンコードしたパス区切り記号のエスケープを解除しないように変更できます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ http スキームのパーセント記号をエンコードしたパス区切り記号をエスケープしないようにするために、<xref:System.Uri> クラスで使用する構成を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <uri>  
+    <schemeSettings>  
+      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>  
+    </schemeSettings>  
+  </uri>  
+</configuration>  
+```  
+  
+## 要素情報  
+  
+|||  
+|-|-|  
+|名前空間|システム|  
+|スキーマ名||  
+|検証ファイル||  
+|空も使用できる||  
+  
+## 参照  
+ <xref:System.Configuration.SchemeSettingElement?displayProperty=fullName>   
+ <xref:System.Configuration.SchemeSettingElementCollection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection?displayProperty=fullName>   
+ <xref:System.Configuration.UriSection.SchemeSettings%2A?displayProperty=fullName>   
+ <xref:System.GenericUriParserOptions?displayProperty=fullName>   
+ <xref:System.Uri?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/servicepointmanager-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/servicepointmanager-element-network-settings.md
new file mode 100644
index 00000000000..ab3dfa9de10
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/servicepointmanager-element-network-settings.md
@@ -0,0 +1,80 @@
+---
+title: "&lt;servicePointManager&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#servicePointManager"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/servicePointManager"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<servicePointManager> 要素"
+  - "servicePointManager 要素"
+ms.assetid: 6e5def51-3646-4ef6-a7bd-c69151321bec
+caps.latest.revision: 16
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 16
+---
+# &lt;servicePointManager&gt; 要素 (ネットワーク設定)
+ネットワーク リソースへの接続を設定します。  
+  
+## 構文  
+  
+```  
+  
+      <servicePointManager  
+  checkCertificateName="true|false"  
+  checkCertificateRevocationList="true|false"  
+  encryptionPolicy="AllowNoEncryption|NoEncryption|RequireEncryption"  
+  expect100Continue="true|false"  
+  useNagleAlgorithm="true|false"  
+  enableDnsRoundRobin="true|false"  
+  dnsRefreshTimeout="time"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`checkCertificateName`|証明書を使用する前に、システムで証明書の名前がサーバー ホスト名に一致することを確認する必要があるかどうかを指定します。  既定値は `true` です。|  
+|`checkCertificateRevocationList`|証明書を使用する前に、システムで証明書が取り消されていることをチェックする必要があるかどうかを指定します。  既定値は `false` です。|  
+|`dnsRefreshTimeout`|ドメイン ネーム サービス \(DNS\) 解決が DNS ラウンド ロビン オプションと共にキャッシュされる期間をミリ秒で指定します。  既定値は 120,000 ミリ秒 \(2 分\) です。|  
+|`enableDnsRoundRobin`|複数のインターネット プロトコル \(IP: Internet Protocol\) アドレスを持つホスト名の DNS 解決がすべてのアドレスを返すか、最初のアドレスだけを返すかを指定します。  既定値は `false` です。|  
+|`encryptionPolicy`|<xref:System.Net.ServicePointManager> インスタンスの SSL\/TLS セッションに適用する暗号化ポリシーを指定します。  有効値は、<xref:System.Net.Security.EncryptionPolicy> 列挙型の値と同じです。  暗号化ポリシーが `NoEncryption` に設定されている場合は、<xref:System.Security.Authentication.CipherAlgorithmType> を使用する必要があります。  既定値は `RequireEncryption` です。|  
+|`expect100Continue`|POST メソッドがサーバーから `100-continue` 応答を受け取ることを想定する必要があるかどうかを指定します。  既定値は `true` です。|  
+|`useNagleAlgorithm`|サービス ポイント マネージャーによって制御される接続が、Nagle アルゴリズムを使用するかどうかを指定します。  既定値は `true` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 参照  
+ <xref:System.Net.ServicePointManager>   
+ <xref:System.Net.Security.EncryptionPolicy>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md
new file mode 100644
index 00000000000..d7dbd6df5c9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;settings&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#settings"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<settings> 要素"
+  - "settings 要素"
+ms.assetid: 189ce989-c39b-427d-b004-6b82a668b931
+caps.latest.revision: 21
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 21
+---
+# &lt;settings&gt; 要素 (ネットワーク設定)
+<xref:System.Net?displayProperty=fullName> 名前空間の基本的なネットワーク オプションを構成します。  
+  
+## 構文  
+  
+```  
+  
+      <settings>  
+..<httpListener> … </httpListener>  
+..<httpWebRequest> … </httpWebRequest>  
+..<ipv6> … </ipv6>  
+..<performanceCounters> … </performanceCounters>  
+  <servicePointManager> … </servicePointManager>  
+..<socket> … </socket>  
+..<webProxyScript> … </webProxyScript>  
+</settings>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[httpListener](../../../../../docs/framework/configure-apps/file-schema/network/httplistener-element-network-settings.md)|<xref:System.Net.HttpListener> クラスで使用されるパラメーターをカスタマイズします。|  
+|[httpWebRequest](../../../../../docs/framework/configure-apps/file-schema/network/httpwebrequest-element-network-settings.md)|Web 要求パラメーターをカスタマイズします。|  
+|[ipv6](../../../../../docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md)|IPv6 \(Internet Protocol Version 6\) のサポートを有効にします。|  
+|[\<performanceCounters\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/performancecounter-element-network-settings.md)|ネットワーク パフォーマンス カウンターを有効にします。|  
+|[servicePointManager](../../../../../docs/framework/configure-apps/file-schema/network/servicepointmanager-element-network-settings.md)|ネットワーク リソースへの接続を設定します。|  
+|[ソケット](../../../../../docs/framework/configure-apps/file-schema/network/socket-element-network-settings.md)|ソケット処理で完了ポートを使用するかどうかを指定します。|  
+|[\<webProxyScript\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/webproxyscript-element-network-settings.md)|Web プロキシを検出するために使用するスクリプトの特性を設定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[system.net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 解説  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 参照  
+ <xref:System.Net?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md
new file mode 100644
index 00000000000..fb6fc859f6d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md
@@ -0,0 +1,94 @@
+---
+title: "&lt;smtp&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/mailSettings/smtp"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#smtp"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<smtp> 要素"
+  - "smtp 要素"
+ms.assetid: 220b0329-e384-4e0c-86b4-0945ad17efd9
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;smtp&gt; 要素 (ネットワーク設定)
+電子メール送信の配信形式、配信方法、および差出人アドレスを設定します。  
+  
+## 構文  
+  
+```  
+  
+      <smtp  
+  deliveryFormat="format"   
+  deliveryMethod="method"   
+  from="from address"   
+  <specifiedPickupDirectory> … </ specifiedPickupDirectory >  
+  <network> … </network>  
+/smtp>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`deliveryFormat`|送信する電子メールの配信形式を指定します。  指定できる値は SevenBit および International です。|  
+|`deliveryMethod`|電子メールの配信方法を指定します。  指定できる値は、network、pickupDirectoryFromIis、および specifiedPickupDirectory です。|  
+|`from`|送信する電子メールの差出人アドレスを指定します。|  
+  
+### 子要素  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`specifiedPickupDirectory`|SMTP \(Simple Mail Transport Protocol\) サーバー用のローカル ディレクトリを設定します。|  
+|`network`|外部 SMTP サーバー用のネットワーク オプションを設定します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[\<mailSettings\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md)|電子メールの送信オプションを設定します。|  
+  
+## 使用例  
+ 既定のネットワーク資格情報を使用して電子メールを送信するために、適切な SMTP パラメーターを指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <mailSettings>  
+      <smtp deliveryMethod="network" deliveryFormat="SevenBit"  from="ben@contoso.com">  
+        <network  
+          host="localhost"  
+          port="25"  
+          defaultCredentials="true"  
+        />  
+      </smtp>  
+    </mailSettings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Configuration.SmtpSection?displayProperty=fullName>   
+ <xref:System.Net.Mail.SmtpClient?displayProperty=fullName>   
+ <xref:System.Net.Mail.SmtpDeliveryFormat>   
+ <xref:System.Net.Mail.SmtpDeliveryMethod>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/socket-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/socket-element-network-settings.md
new file mode 100644
index 00000000000..25ddf7988ba
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/socket-element-network-settings.md
@@ -0,0 +1,121 @@
+---
+title: "&lt;socket&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/socket"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#socket"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<socket> 要素"
+  - "socket 要素"
+ms.assetid: 366c634c-7d16-478f-aedf-053eda94a1a0
+caps.latest.revision: 21
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 21
+---
+# &lt;socket&gt; 要素 (ネットワーク設定)
+ソケット処理で完了ポートを使用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+  
+      <socket  
+  alwaysUseCompletionPortsForConnect="true|false"  
+  alwaysUseCompletionPortsForAccept="true|false"  
+  ipProtectionLevel ="EdgeRestricted|Restricted|Unrestricted|Unspecified"  
+/socket>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|**Attribute**|**説明**|  
+|-------------------|------------|  
+|`alwaysUseCompletionPortsForAccept`|Accept メソッドの呼び出しを行う場合、ソケットで常に完了ポートを使用するかどうかを示します。  既定値は `false` です。|  
+|`alwaysUseCompletionPortsForConnect`|Connect メソッドの呼び出しを行う場合、ソケットで常に完了ポートを使用するかどうかを示します。  既定値は `false` です。|  
+|`ipProtectionLevel`|ソケットに使用する既定の <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName> を指定します。  既定値は、Windows のバージョンによって異なります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+ クラスによって `alwaysUseCompletionPortsForAccept` と `alwaysUseCompletionPortsForConnect` 属性が <xref:System.Net.Sockets?displayProperty=fullName>.namespace で完了ポートの使用に関する既定の動作を指定するために使用されます。  完了ポートは、高性能なサーバー アプリケーションに推奨されます。  
+  
+ `alwaysUseCompletionPortsForAccept` 属性および `alwaysUseCompletionPortsForConnect` 属性の既定値は **false** です。  
+  
+ <xref:System.Net.Configuration.SocketElement.AlwaysUseCompletionPortsForAccept%2A> を使用して、適用可能な構成ファイルから `alwaysUseCompletionPortsForAccept` 属性の現在の値を取得できます。  <xref:System.Net.Configuration.SocketElement.AlwaysUseCompletionPortsForConnect%2A> を使用して、適用可能な構成ファイルから `alwaysUseCompletionPortsForConnect` 属性の現在の値を取得できます。  
+  
+ `ipProtectionLevel` 属性は、ソケットに使用する既定の <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName> を指定します。  <xref:System.Net.Configuration.SocketElement.IPProtectionLevel%2A> プロパティを使用すると、IPv6 ソケットの制限を指定したスコープ \(同じリンク ローカルまたはサイト ローカル プレフィックスを持つアドレスなど\) に構成できます。  このオプションによって、アプリケーションは IPv6 ソケットにアクセス制限を設定できます。  この制限により、プライベート LAN で実行されるアプリケーションを外部からの攻撃に対して簡単、堅牢に強化できます。  このオプションで待機中のソケットのスコープを変更して、適切な場合はパブリック ユーザーおよびプライベート ユーザーからの無制限のアクセスを許可したり、必要に応じて同じサイトへのアクセスのみに制限したりできます。  
+  
+ この `ipProtectionLevel` 属性設定は、最初の受信トラフィックにだけ影響します。  
+  
+-   ソケットで受信接続を待機する TCP サーバー。  
+  
+-   ソケットでパケットを受信する UDP アプリケーション。  
+  
+ この構成設定は、既に確立されている TCP 接続には影響しません \(トラフィックはいずれの方向でも制限されません\)。また、アプリケーションが送信する UDP パケットにも影響しません。  
+  
+ <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName> 列挙体で定義されている保護レベルに対応する `ipProtectionLevel` 属性設定には、次の値を指定できます。  
+  
+|||  
+|-|-|  
+|**属性値**|**説明**|  
+|EdgeRestricted|IP 保護レベルはエッジ制限付きです。  この値は、インターネット経由で動作するように設計されているアプリケーションによって使用されます。  この設定を使用する場合、Windows Teredo 実装を使用したネットワーク アドレス変換 \(NAT: Network Address Translation\) トラバーサルは使用できません。  これらのアプリケーションは、IPv4 のファイアウォールをバイパスすることがあるため、開いているポートを対象としたインターネットからの攻撃に対して堅牢である必要があります。  Windows Server 2003 と Windows XP では、ソケットの IP 保護レベルの既定値はエッジ制限付きです。|  
+|Restricted|IP 保護レベルは制限付きです。  この値は、インターネットのシナリオを実装しないイントラネット アプリケーションによって使用されます。  これらのアプリケーションは、一般的に、インターネット型の攻撃に対してテストが行われていなかったり堅牢ではなかったりします。  この設定を使用する場合、受信トラフィックはリンクローカルのみに制限されます。|  
+|制限なし|IP 保護レベルは無制限です。  この値は、Windows に組み込まれている IPv6 NAT Traversal 機能 \(たとえば、Teredo\) を使用するアプリケーションを含む、インターネット経由で動作するように設計されているアプリケーションによって使用されます。  これらのアプリケーションは、IPv4 のファイアウォールをバイパスすることがあるため、開いているポートを対象としたインターネットからの攻撃に対して堅牢である必要があります。  Windows Server 2008 R2 と Windows Vista では、ソケットの IP 保護レベルの既定値は無制限です。|  
+|Unspecified|IP 保護レベルは未指定です。  Windows 7 と Windows Server 2008 R2 では、ソケットの IP 保護レベルの既定値は未指定です。|  
+  
+ `ipProtectionLevel` 属性の既定値は **Unspecified** です。  
+  
+ <xref:System.Net.Configuration.SocketElement.IPProtectionLevel%2A> プロパティを使用して、適用可能な構成ファイルから `ipProtectionLevel` 属性の現在の値を取得できます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 完了ポートが使用される必要があることと、既定の <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName> が Unrestricted である必要があることを指定する方法を、次のコード例に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <settings>  
+      <socket  
+        alwaysUseCompletionPortsForAccept="true"  
+        alwaysUseCompletionPortsForConnect="true"  
+        ipProtectionLevel="Unrestricted"  
+       />  
+    </settings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net?displayProperty=fullName>   
+ <xref:System.Net.Configuration.SocketElement?displayProperty=fullName>   
+ <xref:System.Net.Sockets?displayProperty=fullName>   
+ <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName>   
+ <xref:System.Net.Sockets.SocketOptionName?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/specifiedpickupdirectory-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/specifiedpickupdirectory-element-network-settings.md
new file mode 100644
index 00000000000..77f92b7276c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/specifiedpickupdirectory-element-network-settings.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;specifiedPickupDirectory&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#specifiedPickupDirectory"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/mailSettings/smtp/specifiedPickupDirectory"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<specifiedPickupDirectory> 要素"
+  - "specifiedPickupDirectory 要素"
+ms.assetid: 0121f49d-bff2-4bc6-af06-f1628dcd61f1
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# &lt;specifiedPickupDirectory&gt; 要素 (ネットワーク設定)
+SMTP \(Simple Mail Transport Protocol\) サーバー用のローカル ディレクトリを設定します。  
+  
+## 構文  
+  
+```  
+  
+      <specifiedPickupDirectory  
+  pickupDirectoryLocation="directory"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`pickupDirectoryLocation`|後で SMTP サーバーで処理するために、各アプリケーションが電子メールを保存するためのディレクトリです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<smtp\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/smtp-element-network-settings.md)|SMTP \(Simple Mail Transport Protocol\) の電子メール送信オプションを設定します。|  
+  
+## 解説  
+ アプリケーションは SMTP サーバーが処理するメール メッセージを格納する場所 `specifiedPickupDirectory` 属性設定ディレクトリ。  
+  
+## 使用例  
+ 電子メールを収集するディレクトリとして、c:\\maildrop を指定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <mailSettings>  
+      <smtp deliveryMethod="specifiedPickupDirectory">  
+        <specifiedPickupDirectory  
+          pickupDirectoryLocation="c:\maildrop"  
+        />  
+      </smtp>  
+    </mailSettings>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.Mail.SmtpClient?displayProperty=fullName>   
+ <xref:System.Net.Configuration.SmtpSection?displayProperty=fullName>   
+ <xref:System.Net.Configuration.SmtpSpecifiedPickupDirectoryElement?displayProperty=fullName>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md
new file mode 100644
index 00000000000..a6a41bfd2fc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md
@@ -0,0 +1,106 @@
+---
+title: "&lt;system.Net&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#system.Net"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.Net"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.Net> 要素"
+  - "system.Net 要素"
+ms.assetid: 52de4d6c-b24d-44aa-ba7d-6b5061f1357e
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;system.Net&gt; 要素 (ネットワーク設定)
+.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。  
+  
+## 構文  
+  
+```  
+  
+      <system.net>   
+</system.net>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[authenticationModules](../../../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md)|インターネット要求を認証するために使用するモジュールを指定します。|  
+|[connectionManagement](../../../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md)|インターネット ホストへの接続の最大数を指定します。|  
+|[defaultProxy](../../../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md)|ハイパーテキスト転送プロトコル \(HTTP: Hypertext Transfer Protocol\) プロキシ サーバーを構成します。|  
+|[mailSettings](../../../../../docs/framework/configure-apps/file-schema/network/mailsettings-element-network-settings.md)|SMTP \(Simple Mail Transport Protocol\) の電子メール送信オプションを設定します。|  
+|[requestCaching](../../../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)|ネットワーク要求のキャッシュ機構を制御します。|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間および関連する子名前空間内のクラスの基本的なネットワーク オプションを構成します。|  
+|[\<webRequestModules\> 要素 \(ネットワーク設定\)](../../../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md)|インターネット ホストからの情報を要求するために使用するモジュールを指定します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[適用](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|すべての名前空間の設定が含まれています。|  
+  
+## 解説  
+ [\<system.net\>](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md) 要素は <xref:System.Net> および関連する子名前空間内のクラスの設定が含まれます。  この設定により、認証モジュール、接続管理、メール設定、プロキシ サーバー、およびインターネット ホストから情報を受け取るためのインターネット要求モジュールが構成されます。  
+  
+## 使用例  
+ <xref:System.Net> クラスで使用される一般的な構成を次のコード例に示します。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <authenticationModules>  
+      <add type = "System.Net.DigestClient" />  
+      <add type = "System.Net.NegotiateClient" />  
+      <add type = "System.Net.KerberosClient" />  
+      <add type = "System.Net.NtlmClient" />  
+      <add type = "System.Net.BasicClient" />  
+    </authenticationModules>  
+    <connectionManagement>  
+      <add address = "*" maxconnection = "2" />  
+    </connectionManagement>  
+    <defaultProxy>  
+      <proxy  
+        usesystemdefault = "true"  
+        bypassonlocal = "true"  
+      />  
+    </defaultProxy>  
+    <webRequestModules>  
+      <add prefix = "http"  
+        type = "System.Net.HttpRequestCreator"  
+      />  
+      <add prefix = "https"  
+        type = "System.Net.HttpRequestCreator"  
+      />  
+      <add prefix = "file"  
+        type = "System.Net.FileWebRequestCreator"  
+      />  
+    </webRequestModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md b/docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md
new file mode 100644
index 00000000000..a7875bfcd55
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;Uri&gt; 要素 (Uri 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: c22bab8b-477c-4ae4-8498-65ad409e0847
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;Uri&gt; 要素 (Uri 設定)
+URI \(Uniform Resource Identifier\) で表現された Web アドレスが .NET Framework によってどのように処理されるかの設定を格納します。  
+  
+## スキーマの階層  
+ [\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<uri\>](../../../../../docs/framework/configure-apps/file-schema/network/uri-element-uri-settings.md)  
+  
+## 構文  
+  
+```  
+<uri>  
+</uri>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[idn](../../../../../docs/framework/configure-apps/file-schema/network/idn-element-uri-settings.md)|国際化ドメイン名 \(IDN: Internationalized Domain Name\) による解析をドメイン名に適用するかどうかを指定します。|  
+|[iriParsing](../../../../../docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md)|IRI \(International Resource Identifier\) 解析を <xref:System.Uri> に適用するかどうか、および IRI の解析規則を適用するかどうかを指定します。|  
+|[schemeSettings](../../../../../docs/framework/configure-apps/file-schema/network/schemesettings-element-uri-settings.md)|<xref:System.Uri> が特定のスキーマに対して解析される方法を指定します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[適用](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|すべての名前空間の設定が含まれています。|  
+  
+## 解説  
+ `uri` 要素には、<xref:System.Net> 名前空間のクラスによって使用される <xref:System.Uri> クラスのメンバーの設定が格納されます。  これらの設定によって、IRI および IDN のサポートが構成されます。  
+  
+## 例  
+  
+### 説明  
+ 次のコード例は、<xref:System.Uri> クラスで IRI の解析および IDN 名をサポートするための構成を示しています。  また、この例では、すべてのスキーム設定を消去してから、http スキームのパーセント記号をエンコードしたパス区切り記号をエスケープしないように設定します。  
+  
+### コード  
+  
+```  
+<configuration>  
+  <uri>  
+    <idn enabled="All" />  
+    <iriParsing enabled="true" />  
+    <schemeSettings>  
+      <clear/>  
+      <add name="http" genericUriParserOptions="DontUnescapePathDotsAndSlashes"/>  
+    </schemeSettings>  
+  </uri>  
+</configuration>  
+```  
+  
+## 参照  
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/webproxyscript-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/webproxyscript-element-network-settings.md
new file mode 100644
index 00000000000..064e664283b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/webproxyscript-element-network-settings.md
@@ -0,0 +1,66 @@
+---
+title: "&lt;webProxyScript&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#webProxyScript"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/settings/webProxyScript"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<webProxyScript> 要素"
+  - "webProxyScript 要素"
+ms.assetid: a13c26db-6218-4af3-9696-38f24b23bfac
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;webProxyScript&gt; 要素 (ネットワーク設定)
+Web プロキシを検出するために使用するスクリプトの特性を設定します。  
+  
+## 構文  
+  
+```  
+  
+      <webProxyScript  
+  downloadTimeout="hh:mm:ss"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`downloadTimeout`|スクリプトをダウンロードする最大時間を時、分、および秒で指定します。  既定値は、1 分です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[設定](../../../../../docs/framework/configure-apps/file-schema/network/settings-element-network-settings.md)|<xref:System.Net> 名前空間の基本的なネットワーク オプションを構成します。|  
+  
+## 解説  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 参照  
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md b/docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md
new file mode 100644
index 00000000000..ef1fc4775ec
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;webRequestModules&gt; 要素 (ネットワーク設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.net/webRequestModules"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#webRequestModules"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<webRequestModules> 要素"
+  - "webRequestModules 要素"
+ms.assetid: 1263de11-3e0a-4f94-97c9-710b2ae53817
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;webRequestModules&gt; 要素 (ネットワーク設定)
+ネットワーク ホストからの情報を要求するために使用するモジュールを指定します。  
+  
+## 構文  
+  
+```  
+  
+      <webRequestModules>   
+</webRequestModules>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[add](../../../../../docs/framework/configure-apps/file-schema/network/add-element-for-webrequestmodules-network-settings.md)|カスタム Web 要求モジュールをアプリケーションに追加します。|  
+|[clear](../../../../../docs/framework/configure-apps/file-schema/network/clear-element-for-webrequestmodules-network-settings.md)|登録されているすべての Web 要求モジュールをアプリケーションから削除します。|  
+|[remove](../../../../../docs/framework/configure-apps/file-schema/network/remove-element-for-webrequestmodules-network-settings.md)|カスタム Web 要求モジュールをアプリケーションから削除します。|  
+  
+### 親要素  
+  
+|**要素**|**説明**|  
+|------------|------------|  
+|[system.net](../../../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)|.NET Framework がネットワークに接続する方法を指定するための設定が含まれています。|  
+  
+## 解説  
+ `webRequestModules` 要素はネットワーク ホストへの情報要求を処理するために <xref:System.Net.WebRequest> クラスの子孫を登録します。  Web 要求モジュールは、<xref:System.Net.IWebRequestCreate> インターフェイスを実装する必要があります。  
+  
+ .NET Framework には、http:\/\/、https:\/\/、および file:\/\/ で始まる URI 用に、Web 要求モジュールが用意されています。  構成ファイルにカスタム モジュールを登録するだけで、既定のモジュールをオーバーライドできます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルまたはマシン構成ファイル \(Machine.config\) で使用できます。  
+  
+## 使用例  
+ 既定の HTTP モジュールを登録するコード例を次に示します。  Version の値および PublicKeyToken の値は、指定したモジュールに対応する正しい値に置き換える必要があります。  
+  
+```  
+<configuration>  
+  <system.net>  
+    <webRequestModules>  
+      <add prefix="http"  
+           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
+           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+      />  
+    </webRequestModules>  
+  </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebRequest>   
+ <xref:System.Net.IWebRequestCreate>   
+ [ネットワーク設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/network/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/TOC.md b/docs/framework/configure-apps/file-schema/runtime/TOC.md
new file mode 100644
index 00000000000..3cc837594ea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/TOC.md
@@ -0,0 +1,49 @@
+# [ランタイム設定スキーマ](index.md)
+# [<alwaysFlowImpersonationPolicy> 要素](alwaysflowimpersonationpolicy-element.md)
+# [<namedCaches> の <clear> 要素](clear-element-for-namedcaches.md)
+# [<legacyCorruptedStateExceptionsPolicy> 要素](legacycorruptedstateexceptionspolicy-element.md)
+# [<codeBase> 要素](codebase-element.md)
+# [<Thread_UseAllCpuGroups> 要素](thread-useallcpugroups-element.md)
+# [<ThrowUnobservedTaskExceptions> 要素](throwunobservedtaskexceptions-element.md)
+# [<assemblyIdentity> 要素](assemblyidentity-element-for-runtime.md)
+# [<namedCaches> の <add> 要素](add-element-for-namedcaches.md)
+# [<appDomainManagerAssembly> 要素](appdomainmanagerassembly-element.md)
+# [<enforceFIPSPolicy> 要素](enforcefipspolicy-element.md)
+# [<GCCpuGroup> 要素](gccpugroup-element.md)
+# [<UseRandomizedStringHashAlgorithm> 要素](userandomizedstringhashalgorithm-element.md)
+# [<disableCachingBindingFailures> 要素](disablecachingbindingfailures-element.md)
+# [<appDomainManagerType> 要素](appdomainmanagertype-element.md)
+# [<qualifyAssembly> 要素](qualifyassembly-element.md)
+# [<PreferComInsteadOfManagedRemoting> 要素](prefercominsteadofmanagedremoting-element.md)
+# [<system.runtime.caching> 要素 (キャッシュ設定)](system-runtime-caching-element-cache-settings.md)
+# [<assemblyBinding> 要素](assemblybinding-element-for-runtime.md)
+# [<forcePerformanceCounterUniqueSharedMemoryReads> 要素](forceperformancecounteruniquesharedmemoryreads-element.md)
+# [<gcServer> 要素](gcserver-element.md)
+# [<TimeSpan_LegacyFormatMode> 要素](timespan-legacyformatmode-element.md)
+# [<relativeBindForResources> 要素](relativebindforresources-element.md)
+# [<generatePublisherEvidence> 要素](generatepublisherevidence-element.md)
+# [<CompatSortNLSVersion> 要素](compatsortnlsversion-element.md)
+# [<bypassTrustedAppStrongNames> 要素](bypasstrustedappstrongnames-element.md)
+# [<legacyImpersonationPolicy> 要素](legacyimpersonationpolicy-element.md)
+# [<namedCaches> 要素 (キャッシュ設定)](namedcaches-element-cache-settings.md)
+# [<bindingRedirect> 要素](bindingredirect-element.md)
+# [<supportPortability> 要素](supportportability-element.md)
+# [<developmentMode> 要素](developmentmode-element.md)
+# [<gcAllowVeryLargeObjects> 要素](gcallowverylargeobjects-element.md)
+# [<disableFusionUpdatesFromADManager> 要素](disablefusionupdatesfromadmanager-element.md)
+# [<gcConcurrent> 要素](gcconcurrent-element.md)
+# [<publisherPolicy> 要素](publisherpolicy-element.md)
+# [<NetFx45_CultureAwareComparerGetHashCode_LongStrings> 要素](netfx45-cultureawarecomparergethashcode-longstrings-element.md)
+# [<NetFx40_PInvokeStackResilience> 要素](netfx40-pinvokestackresilience-element.md)
+# [<disableCommitThreadStack> 要素](disablecommitthreadstack-element.md)
+# [<shadowCopyVerifyByTimestamp> 要素](shadowcopyverifybytimestamp-element.md)
+# [<etwEnable> 要素](etwenable-element.md)
+# [<namedCaches> の <remove> 要素](remove-element-for-namedcaches.md)
+# [<runtime> 要素](runtime-element.md)
+# [<UseSmallInternalThreadStacks> 要素](usesmallinternalthreadstacks-element.md)
+# [<memoryCache> 要素 (キャッシュ設定)](memorycache-element-cache-settings.md)
+# [<dependentAssembly> 要素](dependentassembly-element.md)
+# [<probing> 要素](probing-element.md)
+# [<NetFx40_LegacySecurityPolicy> 要素](netfx40-legacysecuritypolicy-element.md)
+# [<appDomainResourceMonitoring> 要素](appdomainresourcemonitoring-element.md)
+# [<loadFromRemoteSources>](loadfromremotesources-element.md)
diff --git a/docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md b/docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md
new file mode 100644
index 00000000000..cc9b1fd146c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;namedCaches&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<namedCaches> の <add> 要素"
+  - "<namedCaches> の add 要素"
+ms.assetid: ce2a63a8-c829-4742-a6ea-72ee5d89f169
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;namedCaches&gt; の &lt;add&gt; 要素
+メモリ キャッシュの `namedCaches` コレクションに `namedCache` エントリを追加します。  
+  
+## 構文  
+  
+```  
+<namedCaches>  
+    <add name="default" />  
+      <!-- child elements -->  
+ </namedCaches>  
+```  
+  
+## 型  
+ `None`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|||  
+|-|-|  
+|Attribute|説明|  
+|`CacheMemoryLimitMegabytes`|<xref:System.Runtime.Caching.MemoryCache> のインスタンスについて許可される最大サイズ \(MB 単位\) を指定する整数値。  既定値は 0 です。これは、<xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。|  
+|`Name`|キャッシュの名前。|  
+|`PhysicalMemoryLimitPercentage`|キャッシュで使用できる物理的にインストールされたコンピューター メモリの最大パーセンテージを指定する 0 ～ 100 の整数値。  既定値は 0 です。これは、<xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。|  
+|`PollingInterval`|キャッシュの実装が、現在のメモリ負荷を、キャッシュ インスタンスに設定されているメモリ制限の絶対値および割合と比較する時間間隔を示す値。  この値は "HH:MM:SS" の形式で入力されます。|  
+  
+### 子要素  
+ `None`  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)|名前付き <xref:System.Runtime.Caching.MemoryCache> インスタンスの構成設定のコレクションが含まれます。|  
+  
+## 解説  
+ `add` 要素は、メモリ キャッシュの `namedCaches` コレクションにエントリを追加します。  `add` 要素を使用する前に [clear](../../../../../docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md) 要素を使用すると、コレクション内に他の名前付きキャッシュがないことを確認できます。  この要素は、machine.config ファイルと Web.config ファイルで使用できます。  
+  
+## 使用例  
+ メモリ キャッシュの `namedCaches`  コレクションに既定の `namedCache` エントリの設定を定義する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  
+  <system.runtime.caching>  
+    <memoryCache>  
+      <namedCaches>  
+          <add name="default"   
+               cacheMemoryLimitMegabytes="0"   
+               physicalMemoryPercentage="0"  
+               pollingInterval="00:02:00" />  
+      </namedCaches>  
+    </memoryCache>  
+  </system.runtime.caching>  
+  
+</configuration>  
+```  
+  
+## 参照  
+ [\<namedCaches\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md
new file mode 100644
index 00000000000..0113803bc99
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md
@@ -0,0 +1,96 @@
+---
+title: "&lt;alwaysFlowImpersonationPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/alwaysFlowImpersonationPolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#alwaysFlowImpersonationPolicy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<alwaysFlowImpersonationPolicy> 要素"
+  - "alwaysFlowImpersonationPolicy 要素"
+ms.assetid: ee622801-9e46-470b-85ab-88c4b1dd2ee1
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;alwaysFlowImpersonationPolicy&gt; 要素
+偽装の実行方法に関係なく、Windows ID が常に非同期ポイント間をフローするように指定します。  
+  
+## 構文  
+  
+```  
+<alwaysFlowImpersonationPolicy    
+  enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> Windows ID が非同期ポイント間をフローするかどうかを示します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|<xref:System.Security.Principal.WindowsIdentity.Impersonate%2A> などのマネージ メソッドを介して偽装が実行されない限り、Windows ID は非同期ポイント間をフローしません。  これは、既定の設定です。|  
+|`true`|偽装の実行方法に関係なく、Windows ID は常に非同期ポイント間をフローします。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework Version 1.0 および 1.1 では、Windows ID は非同期ポイント間をフローしません。  一方、.NET Framework Version 2.0 には、現在の実行スレッドに関する情報を格納し、これをアプリケーション ドメイン内の非同期ポイント間でフローさせる <xref:System.Threading.ExecutionContext> オブジェクトがあります。  <xref:System.Security.Principal.WindowsIdentity> も、非同期ポイント間をフローする情報の一部としてフローします。ただし、偽装が <xref:System.Security.Principal.WindowsIdentity.Impersonate%2A> などのマネージ メソッドを使用して実行され、ネイティブ メソッドのプラットフォーム呼び出しなど、他の手段によって実行されていない場合に限ります。  この要素を使用して、偽装の実行方法に関係なく、Windows ID が非同期ポイント間をフローするように指定します。  
+  
+ この既定の動作は、さらに次の 2 つの方法で変更できます。  
+  
+1.  スレッドごとにマネージ コードを使用する。  
+  
+     <xref:System.Threading.ExecutionContext.SuppressFlow%2A?displayProperty=fullName> メソッド、<xref:System.Security.SecurityContext.SuppressFlowWindowsIdentity%2A?displayProperty=fullName> メソッド、または <xref:System.Security.SecurityContext.SuppressFlow%2A?displayProperty=fullName> メソッドを使用して <xref:System.Threading.ExecutionContext> 設定と <xref:System.Security.SecurityContext> 設定を変更すると、スレッドごとにフローを止めることができます。  
+  
+2.  共通言語ランタイム \(CLR: Common Language Runtime\) を読み込むアンマネージ ホスト インターフェイスの呼び出しを使用する。  
+  
+     単純なマネージ実行可能ファイルの代わりに、アンマネージ ホスト インターフェイスを使用して CLR を読み込むと、[CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md) 関数の呼び出しで特別なフラグを指定できます。  プロセス全体の互換モードを有効にするには、[CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md) の `flags` パラメーターを STARTUP\_ALWAYSFLOW\_IMPERSONATION に設定します。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。  
+  
+## 使用例  
+ マネージ メソッド以外の手段によって偽装が実行されている場合でも、Windows ID が非同期ポイント間をフローするように指定する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <runtime>  
+    <alwaysFlowImpersonationPolicy enabled="true"/>  
+  </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<legacyImpersonationPolicy\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md b/docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md
new file mode 100644
index 00000000000..8d0b9779aa2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;appDomainManagerAssembly&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<appDomainManagerAssembly> 要素"
+  - "appDomainManagerAssembly 要素"
+ms.assetid: c7c56e39-a700-44f5-b94e-411bfce339d9
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;appDomainManagerAssembly&gt; 要素
+プロセスの既定のアプリケーション ドメインにアプリケーション ドメイン マネージャーを提供するアセンブリを指定します。  
+  
+## 構文  
+  
+```  
+<appDomainManagerAssembly   
+   value="assembly display name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`value`|必須の属性です。  プロセスの既定のアプリケーション ドメインにアプリケーション ドメイン マネージャーを提供するアセンブリの表示名を指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ アプリケーション ドメイン マネージャーの型を指定するには、この要素と [\<appDomainManagerType\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md) 要素の両方を指定する必要があります。  これらの要素のどちらかが指定されていない場合、もう一方の要素は無視されます。  
+  
+ 既定のアプリケーション ドメインが読み込まれるとき、<xref:System.TypeLoadException> は指定したアセンブリが存在しない場合、またはアセンブリを [\<appDomainManagerType\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md) 要素で指定された型がスローされます; とプロセスは起動しません。  アセンブリが見つかってもバージョン情報が一致しない場合は、<xref:System.IO.FileLoadException> がスローされます。  
+  
+ 既定のアプリケーション ドメインに対するアプリケーション ドメイン マネージャーの型を指定すると、既定のアプリケーション ドメインから作成される他のアプリケーション ドメインにも、そのアプリケーション ドメイン マネージャーの型が継承されます。  新しいアプリケーション ドメインに対して別のアプリケーション ドメイン マネージャーの型を指定するには、<xref:System.AppDomainSetup.AppDomainManagerType%2A?displayProperty=fullName> プロパティと <xref:System.AppDomainSetup.AppDomainManagerAssembly%2A?displayProperty=fullName> プロパティを使用します。  
+  
+ アプリケーション ドメイン マネージャーの型を指定する場合は、アプリケーションに完全信頼が必要です \(たとえば、デスクトップ上で実行されるアプリケーションは完全に信頼されています\)。アプリケーションに完全信頼がない場合は、<xref:System.TypeLoadException> がスローされます。  
+  
+ アセンブリの表示名の形式については、<xref:System.Reflection.Assembly.FullName%2A?displayProperty=fullName> プロパティを参照してください。  
+  
+ この構成要素は、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降でのみ使用できます。  
+  
+## 使用例  
+ 次の例は、プロセスの既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして、`AdMgrExample` アセンブリ内の `MyMgr` 型を指定する方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <appDomainManagerType value="MyMgr" />  
+      <appDomainManagerAssembly   
+         value="AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.AppDomainSetup.AppDomainManagerType%2A?displayProperty=fullName>   
+ <xref:System.AppDomainSetup.AppDomainManagerAssembly%2A?displayProperty=fullName>   
+ [\<appDomainManagerType\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md)   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [SetAppDomainManagerType メソッド](../Topic/ICLRControl::SetAppDomainManagerType%20Method.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md b/docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md
new file mode 100644
index 00000000000..3bb32485b6f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;appDomainManagerType&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<appDomainManagerType> 要素"
+  - "appDomainManagerType 要素"
+ms.assetid: ae8d5a7e-e7f7-47f7-98d9-455cc243a322
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;appDomainManagerType&gt; 要素
+既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして機能する型を指定します。  
+  
+## 構文  
+  
+```  
+<appDomainManagerAssembly   
+   value="type name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`value`|必須の属性です。  プロセスの既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして機能する型の名前を、名前空間を含めて指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ アプリケーション ドメイン マネージャーの型を指定するには、この要素と [\<appDomainManagerAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md) 要素の両方を指定する必要があります。  これらの要素のどちらかが指定されていない場合、もう一方の要素は無視されます。  
+  
+ 既定のアプリケーション ドメインが読み込まれるとき、<xref:System.TypeLoadException> は指定された型が [\<appDomainManagerAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md) 要素で指定されたアセンブリにあるスローされます; とプロセスは起動しません。  
+  
+ 既定のアプリケーション ドメインに対するアプリケーション ドメイン マネージャーの型を指定すると、既定のアプリケーション ドメインから作成される他のアプリケーション ドメインにも、そのアプリケーション ドメイン マネージャーの型が継承されます。  新しいアプリケーション ドメインに対して別のアプリケーション ドメイン マネージャーの型を指定するには、<xref:System.AppDomainSetup.AppDomainManagerType%2A?displayProperty=fullName> プロパティと <xref:System.AppDomainSetup.AppDomainManagerAssembly%2A?displayProperty=fullName> プロパティを使用します。  
+  
+ アプリケーション ドメイン マネージャーの型を指定する場合は、アプリケーションに完全信頼が必要です \(たとえば、デスクトップ上で実行されるアプリケーションは完全に信頼されています\)。アプリケーションに完全信頼がない場合は、<xref:System.TypeLoadException> がスローされます。  
+  
+ 型と名前空間の形式は、<xref:System.Type.FullName%2A?displayProperty=fullName> プロパティで使用される形式と同じです。  
+  
+ この構成要素は、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降でのみ使用できます。  
+  
+## 使用例  
+ 次の例は、プロセスの既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして、`AdMgrExample` アセンブリ内の `MyMgr` 型を指定する方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <appDomainManagerType value="MyMgr" />  
+      <appDomainManagerAssembly   
+         value="AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.AppDomainSetup.AppDomainManagerType%2A?displayProperty=fullName>   
+ <xref:System.AppDomainSetup.AppDomainManagerAssembly%2A?displayProperty=fullName>   
+ [\<appDomainManagerAssembly\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md)   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [SetAppDomainManagerType メソッド](../Topic/ICLRControl::SetAppDomainManagerType%20Method.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md b/docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md
new file mode 100644
index 00000000000..68bb1f97dd5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;appDomainResourceMonitoring&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<appDomainResourceMonitoring> 要素"
+  - "appDomainResourceMonitoring 要素"
+ms.assetid: 02119ab6-1e91-448e-97ad-e7b2e5c4bbbd
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# &lt;appDomainResourceMonitoring&gt; 要素
+プロセスの有効期間中、プロセス内のすべてのアプリケーション ドメインに関する統計情報を収集するようにランタイムに指示します。  
+  
+## 構文  
+  
+```  
+<appDomainResourceMonitoring    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> アプリケーション ドメインのリソース監視に関する統計情報を収集するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`true`|アプリケーション ドメインのリソース監視に関する統計情報が収集されます。|  
+|`false`|アプリケーション ドメインのリソース監視に関する統計情報は収集されません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ アプリケーション ドメインのリソース監視は、マネージ アプリケーション ドメイン クラス、[ICLRAppDomainResourceMonitor](../../../../../ocs/framework/unmanaged-api/hosting/iclrappdomainresourcemonitor-interface.md) ホスト インターフェイス、および Windows イベント トレーシング \(ETW\) を通じて実現されます。  監視を有効にすると、プロセスの有効期間中、プロセス内のすべてのアプリケーション ドメインに関する統計情報が収集されます。  
+  
+ マネージ コードから監視を有効にするには、<xref:System.AppDomain.MonitoringIsEnabled%2A> プロパティを使用します。  
+  
+ この構成要素は、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降でのみ使用できます。  
+  
+## 使用例  
+ アプリケーション ドメインのリソース監視を有効にする方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <appDomainResourceMonitoring enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.AppDomain.MonitoringIsEnabled%2A?displayProperty=fullName>   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md b/docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md
new file mode 100644
index 00000000000..aad1b8366df
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md
@@ -0,0 +1,105 @@
+---
+title: "&lt;runtime&gt; の &lt;assemblyBinding&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<assemblyBinding> 要素"
+  - "assemblyBinding 要素"
+  - "コンテナー タグ, <assemblyBinding> 要素"
+ms.assetid: 964cbb35-ab49-4498-8471-209689e5dada
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# &lt;runtime&gt; の &lt;assemblyBinding&gt; 要素
+アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。  
+  
+## 構文  
+  
+```  
+  
+        <assemblyBinding    
+   xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">  
+</assemblyBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|**xmlns**|必須の属性です。<br /><br /> アセンブリのバインディングに必要な XML 名前空間を指定します。  値として、文字列 "urn:schemas\-microsoft\-com:asm.v1" を使用します。|  
+|**AppliesTo**|.NET Framework アセンブリのリダイレクトを適用するランタイムのバージョンを指定します。  このオプションの属性では、.NET Framework バージョン番号を使用して、適用するバージョンを指定します。  **appliesTo** 属性が指定されていない場合、**\<assemblyBinding\>** 要素は、.NET Framework のすべてのバージョンに適用されます。  **appliesTo** 属性は .NET Framework Version 1.1 で導入されたものであり、.NET Framework Version 1.0 では無視されます。  これは **appliesTo** 属性が指定されている場合でも、.NET Framework version 1.0 を使用している場合 **\<assemblyBinding\>** のすべての要素が適用されることを意味します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<dependentAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md)|アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。  アセンブリごとに 1 つの **\<dependentAssembly\>** タグを使用します。|  
+|[\<probing\>](../../../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md)|アセンブリの読み込み時に共通言語ランタイムが検索するサブディレクトリを指定します。|  
+|[\<publisherPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md)|ランタイムが発行元ポリシーを適用するかどうかを指定します。|  
+|[\<qualifyAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md)|部分名が使用された場合に動的に読み込む必要があるアセンブリの完全名を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 使用例  
+ あるアセンブリ バージョンを別のバージョンにリダイレクトし、コードベースを提供する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <bindingRedirect oldVersion="1.0.0.0"  
+                             newVersion="2.0.0.0"/>  
+            <codeBase version="2.0.0.0"  
+                      href="http://www.litwareinc.com/myAssembly.dll"/>  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+ **appliesTo** 属性を使用して .NET Framework アセンブリのバインディングをリダイレクトする方法の例を示します。  
+  
+```  
+<runtime>  
+   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">  
+      <dependentAssembly>   
+         <assemblyIdentity name="mscorcfg" publicKeyToken="b03f5f7f11d50a3a" culture=""/>  
+         <bindingRedirect oldVersion="0.0.0.0-65535.65535.65535.65535" newVersion="1.0.3300.0"/>  
+      </dependentAssembly>  
+   </assemblyBinding>  
+</runtime>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/assemblyidentity-element-for-runtime.md b/docs/framework/configure-apps/file-schema/runtime/assemblyidentity-element-for-runtime.md
new file mode 100644
index 00000000000..aef3d185af3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/assemblyidentity-element-for-runtime.md
@@ -0,0 +1,132 @@
+---
+title: "&lt;runtime&gt; の &lt;assemblyIdentity&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/dependentAssembly/assemblyIdentity"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#assemblyIdentity"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<assemblyIdentity> 要素"
+  - "assemblyIdentity 要素"
+  - "コンテナー タグ, <assemblyIdentity> 要素"
+ms.assetid: cea4d187-6398-4da4-af09-c1abc6a349c1
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# &lt;runtime&gt; の &lt;assemblyIdentity&gt; 要素
+アセンブリに関する識別情報が含まれています。  
+  
+## 構文  
+  
+```  
+  
+   <assemblyIdentity    
+name="assembly name"  
+publicKeyToken="public key token"  
+culture="assembly culture"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`name`|必須の属性です。<br /><br /> アセンブリの名前。|  
+|`culture`|省略可能な属性。<br /><br /> アセンブリの言語、および国または地域を指定する文字列。|  
+|`publicKeyToken`|省略可能な属性。<br /><br /> アセンブリの厳密な名前を指定する 16 進値。|  
+|`processorArchitecture`|省略可能な属性。<br /><br /> "x86"、"amd64"、"msil"、または "ia64" のいずれかの値で、プロセッサ固有のコードを含むアセンブリのプロセッサ アーキテクチャを指定します。  値の大文字と小文字は区別されません。  この属性にこれ以外の値を割り当てると、`<assemblyIdentity>` 要素全体が無視されます。  「<xref:System.Reflection.ProcessorArchitecture>」を参照してください。|  
+  
+## processorArchitecture 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`amd64`|64 ビット AMD プロセッサのみ|  
+|`ia64`|64 ビット Intel プロセッサのみ|  
+|`msil`|プロセッサおよびワードあたりのビット数に関して中立|  
+|`x86`|32 ビット Intel プロセッサ \(ネイティブまたは 64 ビット プラットフォーム上の WOW \(Windows on Windows\) 環境\)|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`dependentAssembly`|各アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。  アセンブリごとに 1 つの `<dependentAssembly>` 要素を使用します。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ **\<dependentAssembly\>** の各要素は **\<assemblyIdentity\>** の 1 種類の子要素が必要です。  
+  
+ `processorArchitecture` 属性が指定されている場合、`<assemblyIdentity>` 要素は対応するプロセッサ アーキテクチャを使用するアセンブリにのみ適用されます。  `processorArchitecture` 属性が指定されていない場合、`<assemblyIdentity>` 要素はどのプロセッサ アーキテクチャを使用するアセンブリにも適用できます。  
+  
+ 次の例は、2 種類のプロセッサ アーキテクチャをターゲットとし、かつバージョン管理が同期していない、同じ名前の 2 つのアセンブリ用の構成ファイルを示しています。  アプリケーションが x86 プラットフォームで実行される場合は、最初の `<assemblyIdentity>` 要素が適用され、もう 1 つの要素が無視されます。  アプリケーションが x86 または ia64 以外のプラットフォームで実行される場合は、両方の要素が無視されます。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="MyAssembly"  
+                  publicKeyToken="14a739be0244c389"  
+                  culture="neutral"  
+                  processorArchitecture="x86" />  
+            <bindingRedirect oldVersion= "1.0.0.0"   
+                  newVersion="1.1.0.0" />  
+         </dependentAssembly>  
+         <dependentAssembly>  
+            <assemblyIdentity name="MyAssembly"  
+                  publicKeyToken="14a739be0244c389"  
+                  culture="neutral"   
+                  processorArchitecture="ia64" />  
+            <bindingRedirect oldVersion="1.0.0.0"   
+                  newVersion="2.0.0.0" />  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+ 構成ファイルに、`processorArchitecture` 属性が指定されていない `<assemblyIdentity>` 要素が含まれ、かつプラットフォームと一致する要素が含まれていない場合は、`processorArchitecture` 属性が指定されていない要素が使用されます。  
+  
+## 使用例  
+ アセンブリの情報を提供する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <!--Redirection and codeBase policy for myAssembly.-->  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md b/docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md
new file mode 100644
index 00000000000..8d78bc827ba
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;bindingRedirect&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/dependentAssembly/bindingRedirect"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#bindingRedirect"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<bindingRedirect> 要素"
+  - "bindingRedirect 要素"
+  - "コンテナー タグ, <bindingRedirect> 要素"
+ms.assetid: 67784ecd-9663-434e-bd6a-26975e447ac0
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;bindingRedirect&gt; 要素
+1 つのアセンブリ バージョンを別のバージョンにリダイレクトします。  
+  
+## 構文  
+  
+```  
+  
+   <bindingRedirect    
+oldVersion="existing assembly version"  
+newVersion="new assembly version"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`oldVersion`|必須の属性です。<br /><br /> 初めに要求されていたアセンブリのバージョンを指定します。  アセンブリのバージョン番号の形式は *major.minor.build.revision* です。  このバージョン番号の各部分で有効値は、0 ～ 65535 です。<br /><br /> バージョン範囲は、次の形式でも指定できます。<br /><br /> *n.n.n.n \- n.n.n.n*|  
+|`newVersion`|必須の属性です。<br /><br /> 初めに要求されていたバージョンの代わりに使用するアセンブリのバージョンを指定します。形式は *n.n.n.n* です。<br /><br /> この値では `oldVersion` より前のバージョンを指定できます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|なし||  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`dependentAssembly`|各アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。  アセンブリごとに 1 つの dependentAssembly 要素を使用します。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ 厳密な名前付きアセンブリに対して .NET Framework アプリケーションを構築すると、実行時に新しいバージョンが利用できる場合でも、既定で、アプリケーションの構築時に使用したアセンブリのバージョンが使用されます。  ただし、新しいバージョンのアセンブリで実行するようにもアプリケーションを構成できます。  これらのファイルを使用して、ランタイムが使用するアセンブリ バージョンを決定する方法の詳細については、「[ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+ 複数の `bindingRedirect` 要素を `dependentAssembly` 要素に含めることによって、複数のアセンブリ バージョンをリダイレクトできます。  また、アセンブリの新しいバージョンから古いバージョンにリダイレクトすることもできます。  
+  
+ アプリケーション構成ファイルで明示的にアセンブリ バインディングをリダイレクトするには、セキュリティ アクセス許可が必要です。  これは、.NET Framework アセンブリおよびサードパーティ製アセンブリに適用されます。  アクセス許可は、[SecurityPermission クラス](frlrfSystemSecurityPermissionsSecurityPermissionClassTopic)の [BindingRedirects](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) フラグを設定することによって付与されます。  詳細については、「[アセンブリ バインディング リダイレクトのセキュリティ アクセス許可](../../../../../docs/framework/configure-apps/assembly-binding-redirection-security-permission.md)」を参照してください。  
+  
+## 使用例  
+ あるアセンブリ バージョンを別のバージョンにリダイレクトする例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <bindingRedirect oldVersion="1.0.0.0"  
+                             newVersion="2.0.0.0"/>  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md b/docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md
new file mode 100644
index 00000000000..d3abba90002
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;bypassTrustedAppStrongNames&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<bypassTrustedAppStrongNames> 要素"
+  - "bypassTrustedAppStrongNames 要素"
+  - "厳密な名前のバイパス機能"
+  - "厳密な名前を付けたアセンブリ, 読み込み (信頼されたアプリケーション ドメインへの)"
+ms.assetid: 71b2ebf6-3843-41e2-ad52-ffa5cd083a40
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# &lt;bypassTrustedAppStrongNames&gt; 要素
+完全に信頼されている <xref:System.AppDomain> に読み込まれた、完全信頼アセンブリの厳密な名前の検証をバイパスするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<bypassTrustedAppStrongNames    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 完全信頼アセンブリの厳密な名前の検証を回避するバイパス機能を有効にするかどうかを指定します。  この機能を有効にすると、アセンブリを読み込むときに、厳密な名前が正しいかどうかの検証は行われません。  既定値は、`true` です。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`true`|完全に信頼されている <xref:System.AppDomain> にアセンブリを読み込むとき、完全信頼アセンブリの厳密な名前の署名は検証されません。  これは、既定の設定です。|  
+|`false`|完全に信頼されている <xref:System.AppDomain> にアセンブリを読み込むとき、完全信頼アセンブリの厳密な名前の署名が検証されます。  厳密な名前の署名は、署名が正しいかどうかだけが検証されます。別の厳密な名前と一致するかどうかの比較は行われません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ 厳密な名前のバイパス機能により、完全信頼アセンブリの厳密な名前の署名の検証によるオーバーヘッドを回避することができます。  
+  
+ バイパス機能は、厳密な名前を使用して署名されたすべてのアセンブリと、次のような特性を持つすべてのアセンブリに適用されます。  
+  
+-   <xref:System.Security.Policy.StrongName> 証拠のない \(たとえば、`MyComputer` ゾーンの証拠が付与されている\)、完全に信頼されているアセンブリ  
+  
+-   完全に信頼されている <xref:System.AppDomain> に読み込まれたアセンブリ  
+  
+-   <xref:System.AppDomain> の <xref:System.AppDomainSetup.ApplicationBase%2A> プロパティで指定された場所から読み込まれたアセンブリ  
+  
+-   遅延署名されていないアセンブリ  
+  
+> [!NOTE]
+>  レジストリ キーを使用して、コンピューター上のすべてのアプリケーションに対してバイパス機能が無効になっている場合、この構成ファイルの設定は無効です。  詳細については、「[方法 : 厳密な名前のバイパス機能を無効にする](../../../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、完全信頼アセンブリの厳密な名前の署名の検証動作を指定する方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <bypassTrustedAppStrongNames enabled="false"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [方法 : 厳密な名前のバイパス機能を無効にする](../../../../../docs/framework/app-domains/how-to-disable-the-strong-name-bypass-feature.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md b/docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md
new file mode 100644
index 00000000000..3fa90139c5e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;namedCaches&gt; の &lt;clear&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<namedCaches> の <clear> 要素"
+  - "<namedCaches> の clear 要素"
+ms.assetid: ea01a858-65da-4348-800f-5e3df59d4d79
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;namedCaches&gt; の &lt;clear&gt; 要素
+メモリ キャッシュの `namedCaches` コレクションのすべての `namedCache` エントリを消去します。  
+  
+## 構文  
+  
+```  
+<namedCaches>  
+    <clear name="default" />  
+    <!-- child elements -->  
+ </namedCaches>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ `None`  
+  
+### 子要素  
+ `None`  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)|名前付き <xref:System.Runtime.Caching.MemoryCache> インスタンスの構成設定のコレクションが含まれます。|  
+  
+## 解説  
+ `clear` 要素は、メモリ キャッシュの名前付きキャッシュ コレクション内のすべての `namedCache` エントリを消去します。  `add` 要素を使用する前に `clear` 要素を使用すると、コレクション内に他の名前付きキャッシュがないことを確認するために、新しい名前付きキャッシュ エントリを追加できます。  
+  
+## 参照  
+ [\<namedCaches\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/codebase-element.md b/docs/framework/configure-apps/file-schema/runtime/codebase-element.md
new file mode 100644
index 00000000000..721897056a6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/codebase-element.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;codeBase&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#codeBase"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/dependentAssembly/codeBase"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<codeBase> 要素"
+  - "codeBase 要素"
+  - "コンテナー タグ, <codeBase> 要素"
+ms.assetid: d48a3983-2297-43ff-a14d-1f29d3995822
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;codeBase&gt; 要素
+共通言語ランタイムがアセンブリを検索できる場所を指定します。  
+  
+## 構文  
+  
+```  
+  
+   <codeBase    
+version="Assembly version"  
+href="URL of assembly"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`href`|必須の属性です。<br /><br /> 指定したアセンブリのバージョンをランタイムが検索できる URL を指定します。|  
+|`version`|必須の属性です。<br /><br /> コードベースを適用するアセンブリのバージョンを指定します。  アセンブリのバージョン番号の形式は、*major.minor.build.revision* です。|  
+  
+## version 属性  
+  
+|値|説明|  
+|-------|--------|  
+|バージョン番号の各部分で有効値は、0 ～ 65535 です。|使用できません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`buildproviders`|カスタム リソース ファイルをコンパイルするためのビルド プロバイダーのコレクションを定義します。  ビルド プロバイダーの数は任意です。|  
+|`compilation`|ASP.NET で使用されるすべてのコンパイル設定値を構成します。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`System.web`|ASP.NET 構成セクションのルート要素を指定します。|  
+  
+## 解説  
+ 設定するマシン構成ファイルまたは発行者ポリシー ファイルの **\<codeBase\>** を使用するランタイムのファイルは、アセンブリ バージョンのリダイレクトしなければなりません。  アプリケーション構成ファイルは、アセンブリ バージョンをリダイレクトせずにコードベース設定を指定できます。  使用するアセンブリ バージョンを決定した後、ランタイムはバージョンを決定したファイルのコードベース設定を適用します。  コードベースを指定しないと、ランタイムはアセンブリを通常の方法でプローブします。  
+  
+ アセンブリが厳密な名前を持つ場合、コードベース設定はローカル イントラネットまたはインターネットの任意の場所に保存できます。  プライベート アセンブリの場合、コードベース設定はアプリケーションのディレクトリからの相対パスにする必要があります。  
+  
+ 厳密な名前のないアセンブリの場合、ローダーはバージョンの使用コードベース\> の \<現れるまで dependentAssembly\>で \<無視されます。  バインディングを他のアセンブリにリダイレクトするアプリケーション構成ファイルにエントリがある場合は、アセンブリのバージョンがバインディング要求と一致しないときでも、リダイレクトが優先されます。  
+  
+## 使用例  
+ ランタイムがアセンブリを検索できる場所を指定する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <codeBase version="2.0.0.0"  
+                      href="http://www.litwareinc.com/myAssembly.dll"/>  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリの場所の指定](../../../../../docs/framework/configure-apps/specify-assembly-location.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md b/docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md
new file mode 100644
index 00000000000..28860331cc9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;CompatSortNLSVersion&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<CompatSortNLSVersion> 要素"
+  - "CompatSortNLSVersion 要素"
+ms.assetid: 782cc82e-83f7-404a-80b7-6d3061a8b6e3
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# &lt;CompatSortNLSVersion&gt; 要素
+文字列比較の実行時に、ランタイムがレガシ並べ替え順序を使用するように指定します。  
+  
+## 構文  
+  
+```  
+<CompatSortNLSVersion    
+   enabled="4096"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 並べ替え順序が使用されるロケール ID を指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|4096|代替の並べ替え順序を表すロケール ID。  この場合、4096 は、[!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] およびそれ以前のバージョンの並べ替え順序を表します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] で <xref:System.Globalization.CompareInfo?displayProperty=fullName> クラスによって実行される文字列の比較、並べ替え、および大文字と小文字の区別の処理は、Unicode 5.1 規格に準拠しているため、<xref:System.String.Compare%28System.String%2CSystem.String%29?displayProperty=fullName> や <xref:System.String.LastIndexOf%28System.String%29?displayProperty=fullName> などの文字列比較メソッドの結果は、以前のバージョンの .NET Framework とは異なる場合があります。  アプリケーションがレガシ動作に依存している場合は、`<CompatSortNLSVersion>` 要素をアプリケーションの構成ファイルに含めることで、[!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] およびそれ以前のバージョンで使用されていた文字列の比較および並べ替えの規則を復元できます。  
+  
+> [!IMPORTANT]
+>  文字列の比較および並べ替えのレガシ規則を復元する場合は、ローカル システムで sort00001000.dll ダイナミック リンク ライブラリも使用できるようにする必要があります。  
+  
+ アプリケーション ドメインを作成するときに、文字列 "NetFx40\_Legacy20SortingBehavior" を <xref:System.AppDomainSetup.SetCompatibilitySwitches%2A> メソッドに渡すことで、文字列の比較および並べ替えのレガシ規則を特定のアプリケーション ドメインで使用することもできます。  
+  
+## 使用例  
+ 次の例では、2 つの <xref:System.String> オブジェクトをインスタンス化して、<xref:System.String.Compare%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> メソッドを呼び出し、現在のカルチャの規則を使用してそれらのオブジェクトを比較する方法を示します。  
+  
+ [!code-csharp[String.BreakingChanges#1](../../../../../samples/snippets/csharp/VS_Snippets_CLR/string.breakingchanges/cs/example1.cs#1)]
+ [!code-vb[String.BreakingChanges#1](../../../../../samples/snippets/visualbasic/VS_Snippets_CLR/string.breakingchanges/vb/example1.vb#1)]  
+  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] で例を実行すると、次のように出力されます。  
+  
+```  
+sta follows a in the sort order.  
+```  
+  
+ これは、[!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] で例を実行したときに表示される出力とはまったく異なります。  
+  
+```  
+sta equals a in the sort order.  
+```  
+  
+ ただし、例のディレクトリに次の構成ファイルを追加し、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] で例を実行すると、[!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] で例を実行した場合と同じ出力が生成されます。  
+  
+```  
+<?xml version ="1.0"?>  
+<configuration>  
+   <runtime>  
+      <CompatSortNLSVersion enabled="4096"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md b/docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md
new file mode 100644
index 00000000000..ea2ebb0d757
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md
@@ -0,0 +1,91 @@
+---
+title: "&lt;dependentAssembly&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/dependentAssembly"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#dependentAssembly"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<dependentAssembly> 要素"
+  - "コンテナー タグ, <dependentAssembly> 要素"
+  - "dependentAssembly 要素"
+ms.assetid: 14e95627-dd79-4b82-ac85-e682aa3a31d8
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# &lt;dependentAssembly&gt; 要素
+各アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。  アセンブリごとに 1 つの `dependentAssembly` 要素を使用します。  
+  
+## 構文  
+  
+```  
+<dependentAssembly>   
+</dependentAssembly>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyIdentity`|アセンブリに関する識別情報が含まれています。  各 `dependentAssembly` 要素にこの要素を含める必要があります。|  
+|`codeBase`|アセンブリがコンピューターにインストールされていない場合に、ランタイムが共有アセンブリを検索できるかどうかを指定します。|  
+|`bindingRedirect`|1 つのアセンブリ バージョンを別のバージョンにリダイレクトします。|  
+|`publisherPolicy`|ランタイムがこのアセンブリに発行者ポリシーを適用するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 使用例  
+ 2 つのアセンブリのアセンブリ情報をカプセル化する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <!--Redirection and codeBase policy for myAssembly.-->  
+         </dependentAssembly>  
+         <dependentAssembly>  
+            <assemblyIdentity name="mySecondAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+            <!--Redirection and codeBase policy for mySecondAssembly.-->  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md b/docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md
new file mode 100644
index 00000000000..f44782e4ae0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;developmentMode&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/developmentMode"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#developmentMode"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<developmentMode> 要素"
+  - "コンテナー タグ, <developmentMode> 要素"
+  - "developmentMode 要素"
+ms.assetid: 60e79a8c-415a-497d-be29-b9d0fd9bdee3
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# &lt;developmentMode&gt; 要素
+DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<developmentMode developerInstallation="true | false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**developerInstallation**|DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するかどうかを指定します。|  
+  
+## developerInstallation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|**true**|DEVPATH 環境変数で指定されたディレクトリでアセンブリを検索します。|  
+|**false**|DEVPATH 環境変数で指定されたディレクトリでアセンブリを検索しません。  これが既定値です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ この設定は、開発時にだけ使用します。  ランタイムは、DEVPATH で見つかった厳密な名前付きアセンブリのバージョンを確認しません。  単純に、最初に見つかったアセンブリを使用します。  
+  
+## 使用例  
+ DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するように指定する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <developmentMode developerInstallation="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [方法 : DEVPATH を使用してアセンブリを指定する](../../../../../docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md b/docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md
new file mode 100644
index 00000000000..09d62904440
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;disableCachingBindingFailures&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#disableCachingBindingFailures"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/disableCachingBindingFailures"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<disableCachingBindingFailures> 要素"
+  - "アセンブリ [.NET Framework], キャッシュ (バインディング エラーを)"
+  - "キャッシュ (アセンブリ バインディング エラーを)"
+  - "disableCachingBindingFailures 要素"
+ms.assetid: bf598873-83b7-48de-8955-00b0504fbad0
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# &lt;disableCachingBindingFailures&gt; 要素
+調査でアセンブリが見つからなかったために発生するバインディング エラーのキャッシュを無効にするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<disableCachingBindingFailures enabled="0|1"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> 調査でアセンブリが見つからなかったために発生するバインディング エラーのキャッシュを無効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|0|調査でアセンブリが見つからなかったために発生するバインディング エラーのキャッシュを無効にしません。  これは .NET Framework Version 2.0 以降での既定のバインディング動作です。|  
+|1|調査でアセンブリが見つからなかったために発生するバインディング エラーのキャッシュを無効にします。  この設定により、.NET Framework Version 1.1 のバインディング動作に戻ります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework Version 2.0 以降では、アセンブリを読み込む際の既定の動作として、すべてのバインディング エラーおよび読み込みエラーがキャッシュされます。  つまり、アセンブリの読み込みに失敗した場合、それ以降の同じアセンブリの読み込みの要求は即座に失敗します。アセンブリを探す試みは行われません。  この要素は、調査パスでアセンブリが見つからなかったために発生するバインディング エラーに対応するための既定の動作を無効にします。  このようなエラーでは、<xref:System.IO.FileNotFoundException> がスローされます。  
+  
+ バインディング エラーおよび読み込みエラーの中には、この要素の影響を受けないものもあり、このようなエラーは常にキャッシュされます。  このようなエラーは、アセンブリが見つかっても読み込むことができなかった場合に発生します。  <xref:System.BadImageFormatException> または <xref:System.IO.FileLoadException> がスローされます。  このようなエラーの例を次の一覧に示します。  
+  
+-   有効なアセンブリではないファイルを読み込もうとした場合、その後に無効なファイルを正しいアセンブリに置き換えても、それ以降のそのアセンブリの読み込みは失敗します。  
+  
+-   ファイル システムによってロックされているアセンブリを読み込もうとした場合、その後にそのアセンブリがファイル システムによって解放されても、それ以降のそのアセンブリの読み込みは失敗します。  
+  
+-   読み込もうとしているアセンブリの 1 つ以上のバージョンが調査パスに存在するにもかかわらず、要求している特定のバージョンがその中に含まれていない場合、正しいバージョンを調査パスに移動しても、それ以降のそのバージョンの読み込みは失敗します。  
+  
+## 使用例  
+ 調査でアセンブリが見つからなかったために発生するアセンブリ バインディング エラーのキャッシュを無効にする方法を次のコード例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <disableCachingBindingFailures enabled="1" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md b/docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md
new file mode 100644
index 00000000000..fc6aa30dc29
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;disableCommitThreadStack&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/disableCommitThreadStack"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#disableCommitThreadStack"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<disableCommitThreadStack> 要素"
+  - "disableCommitThreadStack 要素"
+ms.assetid: 3559d46a-7640-4c72-9a11-7e980768929e
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;disableCommitThreadStack&gt; 要素
+スレッドの起動時にスレッド スタック全体をコミットするかどうかを指定します。  
+  
+ \<configuration\>  
+\<runtime\>  
+\<disableCommitThreadStack\>  
+  
+## 構文  
+  
+```  
+<disableCommitThreadStack enabled="0|1"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|enabled|必須の属性です。<br /><br /> スレッド起動時にスレッド スタック全体をコミットすること \(既定の動作\) を無効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|0|共通言語ランタイムの既定の動作 \(スレッドの起動時にスレッド スタック全体をコミット\) を無効にしません。|  
+|1|共通言語ランタイムの既定の動作 \(スレッドの起動時にスレッド スタック全体をコミット\) を無効にします。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ 共通言語ランタイムの既定の動作では、スレッドの起動時にスレッド スタック全体がコミットされます。 メモリが限られているサーバーで多数のスレッドが作成する必要があり、それらのスレッドのほとんどがごくわずかのスタック スペースしか使用しない場合は、スレッドの起動時に共通言語ランタイムが直ちにスレッド スタック全体をコミットしなければ、サーバーのパフォーマンスが向上する可能性があります。  
+  
+> [!NOTE]
+>  アンマネージ ホストは、[STARTUP\_FLAGS](../../../../../ocs/framework/unmanaged-api/hosting/startup-flags-enumeration.md) 列挙体の `STARTUP_DISABLE_COMMITTHREADSTACK` 起動フラグを使用することにより、同じ結果を得ることができます。  
+  
+## 使用例  
+ 次の例は、共通言語ランタイムの既定の動作 \(スレッド起動時にスレッド スタック全体をコミット\) を無効にする方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <disableCommitThreadStack enabled="1" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md b/docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md
new file mode 100644
index 00000000000..5c75cc50c82
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;disableFusionUpdatesFromADManager&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<disableFusionUpdatesFromADManager> 要素"
+  - "disableFusionUpdatesFromADManager 要素"
+ms.assetid: 58d2866c-37bd-4ffa-abaf-ff35926a2939
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;disableFusionUpdatesFromADManager&gt; 要素
+アプリケーション ドメインの構成設定をランタイム ホストがオーバーライドできるという既定の動作を、無効にするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<disableFusionUpdatesFromADManager enabled="0|1"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> Fusion の設定をオーバーライドする既定の機能を無効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|0|Fusion の設定をオーバーライドする機能を無効にしません。  [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降では、これが既定の動作です。|  
+|1|Fusion の設定をオーバーライドする機能を無効にします。  これにより、.NET Framework の以前のバージョンの動作に戻ります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降の既定の動作では、<xref:System.AppDomainManager> オブジェクトが構成設定をオーバーライドできます。そのためには、<xref:System.AppDomainManager> の独自のサブクラスで、<xref:System.AppDomainManager.InitializeNewDomain%2A?displayProperty=fullName> メソッドの実装に渡された <xref:System.AppDomainSetup> オブジェクトの <xref:System.AppDomainSetup.ConfigurationFile%2A> プロパティまたは <xref:System.AppDomainSetup.SetConfigurationBytes%2A> メソッドを使用します。  既定のアプリケーション ドメインでは、変更された設定によって、アプリケーション構成ファイルで指定された設定がオーバーライドされます。  その他のアプリケーション ドメインでは、<xref:System.AppDomainManager.CreateDomain%2A?displayProperty=fullName> メソッドまたは <xref:System.AppDomain.CreateDomain%2A?displayProperty=fullName> メソッドに渡された構成設定がオーバーライドされます。  
+  
+ 渡された構成情報を削除するには、新しい構成情報を渡すか、または null \(Visual Basic では `Nothing`\) を渡すことができます。  
+  
+ 構成情報は、<xref:System.AppDomainSetup.ConfigurationFile%2A> プロパティと <xref:System.AppDomainSetup.SetConfigurationBytes%2A> メソッドのどちらか一方に渡すようにしてください。  両方に構成情報を渡した場合、<xref:System.AppDomainSetup.SetConfigurationBytes%2A> メソッドはアプリケーション構成ファイルの構成情報をオーバーライドするため、<xref:System.AppDomainSetup.ConfigurationFile%2A> プロパティに渡した情報は無視されます。  <xref:System.AppDomainSetup.ConfigurationFile%2A> プロパティを使用する場合は、<xref:System.AppDomainSetup.SetConfigurationBytes%2A> メソッドに null \(Visual Basic では `Nothing`\) を渡すことで、<xref:System.AppDomainManager.CreateDomain%2A?displayProperty=fullName> メソッドまたは <xref:System.AppDomain.CreateDomain%2A?displayProperty=fullName> メソッドの呼び出しで指定されたすべての構成バイトを削除できます。  
+  
+ 構成情報に加えて、<xref:System.AppDomainManager.InitializeNewDomain%2A?displayProperty=fullName> メソッドの実装に渡される <xref:System.AppDomainSetup> オブジェクトの設定も変更できます。変更できる設定には、<xref:System.AppDomainSetup.ApplicationBase%2A>、<xref:System.AppDomainSetup.ApplicationName%2A>、<xref:System.AppDomainSetup.CachePath%2A>、<xref:System.AppDomainSetup.DisallowApplicationBaseProbing%2A>、<xref:System.AppDomainSetup.DisallowBindingRedirects%2A>、<xref:System.AppDomainSetup.DisallowCodeDownload%2A>、<xref:System.AppDomainSetup.DisallowPublisherPolicy%2A>、<xref:System.AppDomainSetup.DynamicBase%2A>、<xref:System.AppDomainSetup.LoaderOptimization%2A>、<xref:System.AppDomainSetup.PrivateBinPath%2A>、<xref:System.AppDomainSetup.PrivateBinPathProbe%2A>、<xref:System.AppDomainSetup.ShadowCopyDirectories%2A>、および <xref:System.AppDomainSetup.ShadowCopyFiles%2A> があります。  
+  
+ `<disableFusionUpdatesFromADManager>` 要素を使用する代わりに、レジストリ設定を作成するか環境変数を設定して、既定の動作を無効にすることもできます。  レジストリの場合、`HKCU\Software\Microsoft\.NETFramework` または `HKLM\Software\Microsoft\.NETFramework` の下に `COMPLUS_disableFusionUpdatesFromADManager` という名前の DWORD 値を作成し、その値を 1 に設定します。  コマンド ラインの場合、`COMPLUS_disableFusionUpdatesFromADManager` 環境変数を 1 に設定します。  
+  
+## 使用例  
+ 次のコード例は、`<disableFusionUpdatesFromADManager>` 要素を使用して、Fusion の設定をオーバーライドする機能を無効にする方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <disableFusionUpdatesFromADManager enabled="1" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md
new file mode 100644
index 00000000000..1577121d56e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;enforceFIPSPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<enforceFIPSPolicy> 要素"
+  - "enforceFIPSPolicy 要素"
+  - "連邦情報処理規格 (FIPS: Federal Information Processing Standard)"
+  - "FIPS"
+ms.assetid: c35509c4-35cf-43c0-bb47-75e4208aa24e
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;enforceFIPSPolicy&gt; 要素
+暗号アルゴリズムが連邦情報処理規格 \(FIPS: Federal Information Processing Standard\) に準拠することを必要とするコンピューターの構成要件を適用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<enforceFIPSPolicy enabled="true|false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> 暗号アルゴリズムが FIPS に準拠することを必要とするコンピューターの構成要件の適用を有効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`true`|暗号アルゴリズムが FIPS に準拠することを必要とするようにコンピューターが構成されている場合は、その要件が適用されます。  クラスが FIPS に準拠しないアルゴリズムを実装している場合は、そのコンピューターでの実行時に、そのクラスのコンストラクターまたは `Create` メソッドによって例外がスローされます。  これは、既定の設定です。|  
+|`false`|コンピューターの構成に関係なく、アプリケーションで使用される暗号アルゴリズムが FIPS に準拠する必要はありません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework 2.0 以降では、暗号アルゴリズムを実装するクラスの作成はコンピューターの構成によって制御されます。  アルゴリズムが FIPS に準拠することを必要とするようにコンピューターが構成されている場合に、クラスが FIPS に準拠しないアルゴリズムを実装しているときは、そのクラスのインスタンスを作成しようとすると例外がスローされます。  コンストラクターは <xref:System.InvalidOperationException> 例外をスローし、`Create` メソッドは内部に <xref:System.InvalidOperationException> 例外を含む <xref:System.Reflection.TargetInvocationException> 例外をスローします。  
+  
+ FIPS への準拠を必要とする構成になっているコンピューターでアプリケーションが実行される場合に、アプリケーションで FIPS に準拠しないアルゴリズムが使用されるときは、構成ファイルでこの要素を使用すると、共通言語ランタイム \(CLR: Common Language Runtime\) によって FIPS への準拠が適用されないようにすることができます。  この要素は、[!INCLUDE[net_v20SP1_long](../../../../../includes/net-v20sp1-long-md.md)] で導入されました。  
+  
+## 使用例  
+ 次の例では、CLR によって FIPS への準拠が適用されないようにする方法を示します。  
+  
+```  
+<configuration>  
+    <runtime>  
+        <enforceFIPSPolicy enabled="false"/>  
+    </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [暗号モデル](../../../../../docs/standard/security/cryptography-model.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/etwenable-element.md b/docs/framework/configure-apps/file-schema/runtime/etwenable-element.md
new file mode 100644
index 00000000000..12b0f7f6f34
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/etwenable-element.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;etwEnable&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<etwEnable> 要素"
+  - "etwEnable 要素"
+ms.assetid: 29dde982-6d8b-4099-8867-ad0d7733f6dc
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;etwEnable&gt; 要素
+共通言語ランタイム イベントで Windows イベント トレーシング \(ETW\) を有効にするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<etwEnable enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> ETW を有効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|true|ETW を有効にします。  これは、Windows Vista および Windows Server 2008 オペレーティング システム以降のバージョンの Windows の既定値です。|  
+|false|ETW を無効にします。  これは、旧バージョンの Windows の既定値です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ Windows Vista 以降、ETW は既定で有効になっています。  この要素を使用すると、アプリケーションに対して ETW を無効にできます。  それ以前の Windows バージョンでは、この要素を使用すると、アプリケーションに対して ETW を有効にできます。  
+  
+> [!NOTE]
+>  レジストリ設定を使用すると、サーバーでグローバルに ETW を有効または無効にできます。  「[.NET Framework のログ記録の制御](../../../../../docs/framework/performance/controlling-logging.md)」を参照してください。  
+  
+## 使用例  
+ アプリケーションに対して ETW トレースを有効にする方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <etwEnable enabled="true" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [.NET Framework のログ記録の制御](../../../../../docs/framework/performance/controlling-logging.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md b/docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md
new file mode 100644
index 00000000000..cebb14dc28b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;forcePerformanceCounterUniqueSharedMemoryReads&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<forcePerformanceCounterUniqueSharedMemoryReads> 要素"
+  - "forcePerformanceCounterUniqueSharedMemoryReads 要素"
+ms.assetid: 91149858-4810-4f65-9b48-468488172c9b
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;forcePerformanceCounterUniqueSharedMemoryReads&gt; 要素
+PerfCounter.dll がカテゴリ固有の共有メモリとグローバル メモリのどちらからパフォーマンス カウンター データを読み込むかを判断するために .NET Framework Version 1.1 アプリケーションの CategoryOptions レジストリ設定を使用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<forcePerformanceCounterUniqueSharedMemoryReads   
+enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> PerfCounter.dll がカテゴリ固有の共有メモリとグローバル メモリのどちらからパフォーマンス カウンター データを読み込むかを判断するために CategoryOptions レジストリ設定を使用するかどうかを示します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|PerfCounter.dll では、CategoryOptions レジストリ設定が使用されません。これが既定値です。|  
+|`true`|PerfCounter.dll では、CategoryOptions レジストリ設定が使用されます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] より前のバージョンの .NET Framework では、読み込まれた PerfCounter.dll のバージョンは、プロセスに読み込まれたランタイムに対応します。  コンピューターに、.NET Framework Version 1.1 と [!INCLUDE[dnprdnlong](../../../../../includes/dnprdnlong-md.md)] の両方がインストールされている場合、.NET Framework 1.1 アプリケーションは .NET Framework 1.1 バージョンの PerfCounter.dll を読み込みます。  [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降では、インストールされている最新のバージョンの PerfCounter.dll が読み込まれます。  これにより、.NET Framework 1.1 アプリケーションは、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] がコンピューターにインストールされている場合に、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] バージョンの PerfCounter.dll を読み込みます。  
+  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降では、パフォーマンス カウンターを使用する場合に、PerfCounter.dll は各プロバイダーの CategoryOptions レジストリ エントリをチェックして、カテゴリ固有の共有メモリとグローバル共有メモリのどちらから読み取る必要があるかを判断します。  .NET Framework 1.1 PerfCounter.dll は、カテゴリ固有の共有メモリを認識しないため、このレジストリ エントリを読み取りません。常にグローバル共有メモリから読み取ります。  
+  
+ 下位互換性を維持するために、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] PerfCounter.dll は、.NET Framework 1.1 アプリケーションで実行されている場合に、CategoryOptions レジストリ エントリをチェックしません。  .NET Framework 1.1 PerfCounter.dll と同様に、単純にグローバル共有メモリを使用します。  ただし、`<forcePerformanceCounterUniqueSharedMemoryReads>` 要素を有効にすることで、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] PerfCounter.dll に対してレジストリ設定をチェックするように指示できます。  
+  
+> [!NOTE]
+>  `<forcePerformanceCounterUniqueSharedMemoryReads>` 要素を有効にしても、カテゴリ固有の共有メモリが使用されるという保証はありません。  `true` を有効にする設定は、PerfCounter.dll が CategoryOptions レジストリ設定を参照する原因にしかなりません。  CategoryOptions の既定の設定では、カテゴリ固有の共有メモリが使用されます。ただし、CategoryOptions を変更して、グローバル共有メモリを使用するように指示できます。  
+  
+ CategoryOptions 設定を含むレジストリ キーは、HKEY\_LOCAL\_MACHINE\\System\\CurrentControlSet\\Services\\の categoryName\\Performance\<\>です。  既定では、CategoryOptions は 3 に設定されます。これは、PerfCounter.dll に対してカテゴリ固有の共有メモリを使用するように指示します。  CategoryOptions が 0 に設定されている場合、PerfCounter.dll はグローバル共有メモリを使用します。  インスタンス データは、作成されるインスタンスの名前が再利用されるインスタンスの名前と同じ場合にのみ再利用されます。  すべてのバージョンで、カテゴリに書き込むことができます。  CategoryOptions が 1 に設定されている場合は、グローバル共有メモリが使用されますが、インスタンス データは、カテゴリ名の長さが再利用されるカテゴリと同じ場合にのみ再利用できます。  
+  
+ 設定 0 および 1 は、メモリ リークと、パフォーマンス カウンター メモリの不足を引き起こすことがあります。  
+  
+## 使用例  
+ PerfCounter.dll がカテゴリ固有の共有メモリを使用する必要があるかどうかを判断するために CategoryOptions レジストリ エントリを参照する必要があることを指定する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <runtime>  
+    <forcePerformanceCounterUniqueSharedMemoryReads enabled="true"/>  
+  </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md b/docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md
new file mode 100644
index 00000000000..201d4b3aaea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;gcAllowVeryLargeObjects&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<gcAllowVeryLargeObjects> 要素"
+  - "gcAllowVeryLargeObjects 要素"
+ms.assetid: 5c7ea24a-39ac-4e5f-83b7-b9f9a1b556ab
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# &lt;gcAllowVeryLargeObjects&gt; 要素
+64 ビット プラットフォームで、合計サイズが 2 GB \(ギガバイト\) を超える配列を有効にします。  
+  
+## 構文  
+  
+```  
+<gcAllowVeryLargeObjects    
+   enabled="true|false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 64 ビット プラットフォームで、合計サイズが 2 GB \(ギガバイト\) を超える配列が有効であるかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|合計サイズが 2 GB を超える配列は有効ではありません。  これは、既定の設定です。|  
+|`true`|64 ビット プラットフォームで、合計サイズが 2 GB を超える配列が有効になっています。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ アプリケーション構成ファイルで次の要素を使用すると 2 GB を超えるサイズの配列が有効になりますが、オブジェクトのサイズや配列のサイズに対するその他の制限は変更されません。  
+  
+-   配列の要素の最大数は <xref:System.UInt32.MaxValue?displayProperty=fullName> です。  
+  
+-   バイト配列および 1 バイト構造体の配列の場合、単一次元の最大インデックスは 2,147,483,591 \(0x7FFFFFC7\) です。その他の種類の場合は 2,146,435,071 \(0X7FEFFFFF\) です。  
+  
+-   文字列およびその他の非配列オブジェクトの最大サイズは変更されません。  
+  
+> [!CAUTION]
+>  この機能を有効にする前に、すべての配列のサイズが 2 GB よりも小さいことを前提としたアンセーフ コードがアプリケーションに含まれていないことを確認します。  たとえば、バッファーとして配列を使用するアンセーフ コードが、配列は 2 GB を超えないという前提で記述されている場合、バッファー オーバーランが発生しやすくなる可能性があります。  
+  
+## 使用例  
+ アプリケーションでこの機能を有効にする方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <runtime>  
+    <gcAllowVeryLargeObjects enabled="true" />  
+  </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md b/docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md
new file mode 100644
index 00000000000..23fc02eb3f2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md
@@ -0,0 +1,105 @@
+---
+title: "&lt;gcConcurrent&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/gcConcurrent"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#gcConcurrent"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<gcConcurrent> 要素"
+  - "コンテナー タグ, <gcConcurrent> 要素"
+  - "gcConcurrent 要素"
+ms.assetid: 503f55ba-26ed-45ac-a2ea-caf994da04cd
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# &lt;gcConcurrent&gt; 要素
+共通言語ランタイムがガベージ コレクションを別のスレッドで実行するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<gcConcurrent    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムがガベージ コレクションを並列に実行するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ガベージ コレクションを並列に実行しません。|  
+|`true`|ガベージ コレクションを並列に実行します。  既定値です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework 4 より前の場合、ワークステーション ガベージ コレクションは、同時実行ガベージ コレクションをサポートしており、別個のスレッドでバックグラウンドでガベージ コレクションを実行していました。  .NET Framework 4 では同時実行ガベージ コレクションはバックグラウンド GC に置き換えられており、これも別個のスレッドでバックグラウンドでガベージ コレクションを実行していました。  .NET Framework 4.5 以降では、バックグラウンド コレクションをサーバー ガベージ コレクションで使用できるようになりました。  `<gcConcurrent>` 要素は、ランタイムが同時実行ガベージ コレクションを実行するかバックグラウンド ガベージ コレクションを実行するか \(使用可能な場合\)、またはフォアグラウンドでガベージ コレクションを実行するかどうかを制御します。  
+  
+> [!WARNING]
+>  .NET Framework 4 以降では、同時実行ガベージ コレクションはバックグラウンド ガベージ コレクションに置き換えられています。  *同時実行*と*バックグラウンド*という用語は、.NET Framework ドキュメントでは同義です。  バックグラウンド ガベージ コレクションを無効にするには、この記事説明されているように `<gcConcurrent>` 要素を使用します。  
+  
+ 既定では、ランタイムは同時実行ガベージ コレクションまたはバックグラウンド ガベージ コレクションを使用します。これは待機時間について最適化されています。  アプリケーションでユーザーとのやり取りが多い場合は、同時実行ガベージ コレクションを有効にして、ガベージ コレクションを実行するためのアプリケーションの停止時間を最小限に抑えます。  `<gcConcurrent>` 要素の `enabled` 属性を `false` に設定すると、ランタイムは非同時実行ガベージ コレクションを使用します。これはスループットについて最適化されています。  次の構成ファイルはバック グラウンド ガベージ コレクションを無効にします。  
+  
+```xml  
+  
+<configuration>  
+   <runtime>  
+      <gcConcurrent enabled="false"/>  
+   </runtime>  
+</configuration>  
+  
+```  
+  
+ マシン構成ファイルに `<gcConcurrentSetting>` 設定が存在する場合、すべての .NET Framework アプリケーションの既定値を定義します。  マシン構成ファイルの設定は、アプリケーション構成ファイルの設定を上書きします。  
+  
+ 同時実行ガベージ コレクションおよびバックグラウンド ガベージ コレクションの詳細については、「[Fundamentals of Garbage Collection](../../../../../docs/standard/garbage-collection/fundamentals.md)」トピックの「同時実行ガベージ コレクション」セクションを参照してください。  
+  
+## 使用例  
+ 同時実行ガベージ コレクションを有効にする方法を次の例に示します。  
+  
+```  
+  
+<configuration>  
+   <runtime>  
+      <gcConcurrent enabled="true"/>  
+   </runtime>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [Fundamentals of Garbage Collection](../../../../../docs/standard/garbage-collection/fundamentals.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md b/docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md
new file mode 100644
index 00000000000..8eabd8b050e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;GCCpuGroup&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<GCCpuGroup> 要素"
+  - "GCCpuGroup 要素"
+ms.assetid: c1fc7d6c-7220-475c-a312-5b8b201f66e0
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# &lt;GCCpuGroup&gt; 要素
+ガベージ コレクションが複数の CPU グループをサポートするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<GCCpuGroup    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ガベージ コレクションが複数の CPU グループをサポートするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ガベージ コレクションは複数の CPU グループをサポートしていません。  これは、既定の設定です。|  
+|`true`|ガベージ コレクションは、サーバーのガベージ コレクションが有効な場合に複数の CPU グループをサポートします。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ コンピューターに複数の CPU グループがあり、サーバーのガベージ コレクション \([\<gcServer\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md) 要素を参照\) が有効になっている場合、ヒープを作成および分散するときに、ガベージ コレクションが CPU グループ全体に分散し、すべてのコアが考慮されます。  
+  
+> [!NOTE]
+>  この要素は、ガベージ コレクション スレッドにのみ適用されます。  ランタイムが CPU グループ全体にユーザー スレッドを分散できるようにするには、[\<Thread\_UseAllCpuGroups\>](../../../../../docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md) 要素を有効にする必要があります。  
+  
+## 使用例  
+ 次の例は、複数の CPU グループのガベージ コレクションを有効にする方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <GCCpuGroup enabled="true"/>  
+      <gcServer enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [How to: Disable Concurrent Garbage Collection](http://msdn.microsoft.com/ja-jp/ba2c6c67-5778-497c-9fac-5f793b5500c7)   
+ [ワークステーションとサーバーのガベージ コレクション](../../../../../docs/standard/garbage-collection/fundamentals.md#workstation_and_server_garbage_collection)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/gcserver-element.md b/docs/framework/configure-apps/file-schema/runtime/gcserver-element.md
new file mode 100644
index 00000000000..72e38fe619c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/gcserver-element.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;gcServer&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/gcServer"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#gcServer"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<gcServer> 要素"
+  - "gcServer 要素"
+ms.assetid: 8d25b80e-2581-4803-bd87-a59528e3cb03
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# &lt;gcServer&gt; 要素
+共通言語ランタイムがサーバーのガベージ コレクションを実行するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<gcServer    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムがサーバーのガベージ コレクションを実行するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|サーバーのガベージ コレクションを実行しません。  既定値です。|  
+|`true`|サーバーのガベージ コレクションを実行します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ 共通言語ランタイム \(CLR\) は、2 種類のガベージ コレクションをサポートしています。1 つはワークステーション ガベージ コレクションで、すべてのシステムで使用できるものです。もう 1 つはサーバー ガベージ コレクションで、マルチプロセッサ システムで使用できるものです。  `<gcServer>` 要素を使用して、CLR によって実行されるガベージ コレクションの種類を制御します。  <xref:System.Runtime.GCSettings.IsServerGC%2A?displayProperty=fullName> プロパティを使用して、サーバー ガベージ コレクションが有効かどうかを決定します。  
+  
+ シングル プロセッサ コンピューターの場合、既定のワークステーション ガベージ コレクションが催促のオプションです。  2 つのプロセッサを搭載するコンピューターで、ワークステーションかサーバーのいずれかを使用できます。  3 つ以上のプロセッサでは、サーバー ガベージ コレクションが最速のオプションです。  
+  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。要素がマシン構成ファイルにある場合には無視されます。  
+  
+> [!NOTE]
+>  .NET Framework 4 以前のバージョンでは、サーバー ガベージ コレクションを有効にすると同時実行ガベージ コレクションが使用できません。  [!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)] 以降では、サーバー ガベージ コレクションは同時実行されるようになりました。  非同時実行サーバー ガベージ コレクションを使用するには、`<gcServer>` 要素を `true` に設定し、[\<gcConcurrent\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)を `false` に設定します。  
+  
+## 使用例  
+ サーバー ガベージ コレクションを有効にする方法を次の例に示します。  
+  
+```  
+  
+<configuration>  
+   <runtime>  
+      <gcServer enabled="true"/>  
+   </runtime>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.Runtime.GCSettings.IsServerGC%2A?displayProperty=fullName>   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [How to: Disable Concurrent Garbage Collection](http://msdn.microsoft.com/ja-jp/ba2c6c67-5778-497c-9fac-5f793b5500c7)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md b/docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md
new file mode 100644
index 00000000000..53344fcad96
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;generatePublisherEvidence&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<generatePublisherEvidence> 要素"
+  - "generatePublisherEvidence 要素"
+ms.assetid: 7d208f50-e8d5-4a42-bc1a-1cf3590706a8
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# &lt;generatePublisherEvidence&gt; 要素
+ランタイムでコード アクセス セキュリティ \(CAS: Code Access Security\) 用の <xref:System.Security.Policy.Publisher> 証拠を作成するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<generatePublisherEvidence    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムで <xref:System.Security.Policy.Publisher> 証拠を作成するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|<xref:System.Security.Policy.Publisher> 証拠を作成しません。|  
+|`true`|<xref:System.Security.Policy.Publisher> 証拠を作成します。  これは、既定の設定です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降では、この要素はアセンブリの読み込み時間に影響を与えません。  詳細については、「[セキュリティの変更点](../../../../../docs/framework/security/security-changes.md)」のセキュリティ ポリシーの簡略化に関するセクションを参照してください。  
+  
+ 共通言語ランタイム \(CLR: Common Language Runtime\) は、アセンブリの <xref:System.Security.Policy.Publisher> 証拠を作成するために、読み込み時に Authenticode 署名を検証します。  ただし、既定では、ほとんどのアプリケーションは <xref:System.Security.Policy.Publisher> 証拠を必要としません。  標準的な CAS ポリシーは、<xref:System.Security.Policy.PublisherMembershipCondition> に依存しません。  コンピューター上でカスタム CAS ポリシーを使用してアプリケーションを実行する場合や、部分信頼環境で <xref:System.Security.Permissions.PublisherIdentityPermission> を実現するための要求への適合を意図する場合を除き、起動時に発行者の署名の検証に関連する不要な処理を実行することは避けることが必要です \(ID アクセス許可の要求は、完全信頼環境下では必ず成功します\)。  
+  
+> [!NOTE]
+>  起動時のパフォーマンスを向上させることを目的に、サービスで `<generatePublisherEvidence>` 要素を使用することをお勧めします。この要素は、タイムアウトの原因になる遅延や、サービス開始のキャンセルを回避することにも役立ちます。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。  
+  
+## 使用例  
+ 次に、`<generatePublisherEvidence>` 要素を使用してアプリケーションの CAS 発行者ポリシー チェックを無効にする方法について説明します。  
+  
+```  
+<configuration>  
+    <runtime>  
+        <generatePublisherEvidence enabled="false"/>  
+    </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/index.md b/docs/framework/configure-apps/file-schema/runtime/index.md
new file mode 100644
index 00000000000..77a4903287e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/index.md
@@ -0,0 +1,185 @@
+---
+title: "ランタイム設定スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成スキーマ [.NET Framework], ランタイム設定"
+  - "ランタイム設定スキーマ"
+  - "スキーマ ランタイム設定"
+ms.assetid: f04816ab-110d-4e28-9283-845d6d9a4a68
+caps.latest.revision: 49
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 42
+---
+# ランタイム設定スキーマ
+ランタイム設定は、共通言語ランタイムがガベージ コレクションを処理する方法と、構成ファイルで使用するアセンブリのバージョンを指定します。  
+  
+ [\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<ランタイム\>](../../../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)  
+  
+ [\<alwaysFlowImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md)  
+  
+ [\<appDomainManagerAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md)  
+  
+ [\<appDomainManagerType\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md)  
+  
+ [\<appDomainResourceMonitoring\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md)  
+  
+ [\<assemblyBinding\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md)  
+  
+ [\<dependentAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md)  
+  
+ [\<assemblyIdentity\>](../../../../../docs/framework/configure-apps/file-schema/runtime/assemblyidentity-element-for-runtime.md)  
+  
+ [\<bindingRedirect\>](../../../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md)  
+  
+ [\<コードベース\>](../../../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md)  
+  
+ [\<プローブ\>](../../../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md)  
+  
+ [\<publisherPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md)  
+  
+ [\<qualifyAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md)  
+  
+ [\<bypassTrustedAppStrongNames\>](../../../../../docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md)  
+  
+ [\<CompatSortNLSVersion\>](../../../../../docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md)  
+  
+ [\<developmentMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md)  
+  
+ [\<disableCachingBindingFailures\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md)  
+  
+ [\<disableCommitThreadStack\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md)  
+  
+ [\<disableFusionUpdatesFromADManager\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md)  
+  
+ [\<enforceFIPSPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md)  
+  
+ [\<etwEnable\>](../../../../../docs/framework/configure-apps/file-schema/runtime/etwenable-element.md)  
+  
+ [\<forcePerformanceCounterUniqueSharedMemoryReads\>](../../../../../docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md)  
+  
+ [\<gcAllowVeryLargeObjects\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)  
+  
+ [\<gcConcurrent\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)  
+  
+ [\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md)  
+  
+ [\<gcServer\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md)  
+  
+ [\<generatePublisherEvidence\>](../../../../../docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md)  
+  
+ [\<legacyCorruptedStateExceptionsPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md)  
+  
+ [\<legacyImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md)  
+  
+ [\<loadfromRemoteSources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md)  
+  
+ [\<NetFx40\_LegacySecurityPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)  
+  
+ [\<NetFx40\_PInvokeStackResilience\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md)  
+  
+ [\<NetFx45\_CultureAwareComparerGetHashCode\_LongStrings\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md)  
+  
+ [\<PreferComInsteadOfManagedRemoting\>](../../../../../docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md)  
+  
+ [\<relativeBindForResources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md)  
+  
+ [\<shadowCopyVerifyByTimeStamp\>](../../../../../docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md)  
+  
+ [\<relativeBindForResources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md)  
+  
+ [\<supportPortability\>](../../../../../docs/framework/configure-apps/file-schema/runtime/supportportability-element.md)  
+  
+ [\<system.runtime.caching\>](../../../../../docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md)  
+  
+ [\<memoryCache\>](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)  
+  
+ [\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)  
+  
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md)  
+  
+ [\<&#91;clear&#93;\>](../../../../../docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md)  
+  
+ [\<削除\>](../../../../../docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md)  
+  
+ [\<Thread\_UseAllCpuGroups\>](../../../../../docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md)  
+  
+ [\<ThrowUnobservedTaskExceptions\>](../../../../../docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md)  
+  
+ [\<TimeSpan\_LegacyFormatMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)  
+  
+ [\<UseRandomizedStringHashAlgorithm\>](../../../../../docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md)  
+  
+ [\<UseSmallInternalThreadStacks\>](../../../../../docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md)  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md)|名前付きキャッシュをメモリ キャッシュの `namedCaches` コレクションに追加します。|  
+|[\<alwaysFlowImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md)|偽装の実行方法に関係なく、Windows ID が常に非同期ポイント間をフローするように指定します。|  
+|[\<appDomainManagerAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md)|プロセスの既定のアプリケーション ドメインにアプリケーション ドメイン マネージャーを提供するアセンブリを指定します。|  
+|[\<appDomainManagerType\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md)|既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして機能する型を指定します。|  
+|[\<appDomainResourceMonitoring\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md)|プロセスの有効期間中、プロセス内のすべてのアプリケーション ドメインに関する統計情報を収集するようにランタイムに指示します。|  
+|[\<assemblyBinding\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md)|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|[\<assemblyIdentity\>](../../../../../docs/framework/configure-apps/file-schema/runtime/assemblyidentity-element-for-runtime.md)|アセンブリに関する識別情報が含まれています。|  
+|[\<bindingRedirect\>](../../../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md)|1 つのアセンブリ バージョンを別のバージョンにリダイレクトします。|  
+|[\<bypassTrustedAppStrongNames\>](../../../../../docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md)|完全に信頼されているアセンブリの厳密な名前の検証をバイパスするかどうかを指定します。|  
+|[\<&#91;clear&#93;\>](../../../../../docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md)|メモリ キャッシュの `namedCaches` コレクションを削除します。|  
+|[\<コードベース\>](../../../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md)|ランタイムがアセンブリを検索できる場所を指定します。|  
+|[\<CompatSortNLSVersion\>](../../../../../docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md)|文字列比較の実行時に、ランタイムがレガシ並べ替え動作を使用するように指定します。|  
+|[\<dependentAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md)|各アセンブリのバインディング ポリシーとアセンブリの場所をカプセル化します。|  
+|[\<developmentMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md)|DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するかどうかを指定します。|  
+|[\<disableCachingBindingFailures\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md)|[!INCLUDE[dnprdnext](../../../../../includes/dnprdnext-md.md)] の既定の動作であるバインディング エラーのキャッシュを無効にするかどうかを指定します。|  
+|[\<disableCommitThreadStack\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md)|スレッドの起動時にスレッド スタック全体をコミットするかどうかを指定します。|  
+|[\<disableFusionUpdatesFromADManager\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md)|アプリケーション ドメインの構成設定をランタイム ホストがオーバーライドできるという既定の動作を、無効にするかどうかを指定します。|  
+|[\<enforceFIPSPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md)|暗号アルゴリズムが連邦情報処理規格 \(FIPS: Federal Information Processing Standard\) に準拠することを必要とするコンピューターの構成要件を適用するかどうかを指定します。|  
+|[\<etwEnable\>](../../../../../docs/framework/configure-apps/file-schema/runtime/etwenable-element.md)|共通言語ランタイム イベントで Windows イベント トレーシング \(ETW\) を有効にするかどうかを指定します。|  
+|[\<forcePerformanceCounterUniqueSharedMemoryReads\>](../../../../../docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md)|PerfCounter.dll がカテゴリ固有の共有メモリとグローバル メモリのどちらからパフォーマンス カウンター データを読み込むかを判断するために .NET Framework Version 1.1 アプリケーションの CategoryOptions レジストリ設定を使用するかどうかを指定します。|  
+|[\<gcAllowVeryLargeObjects\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md)|64 ビット プラットフォームで、合計サイズが 2 GB \(ギガバイト\) を超える配列を有効にします。|  
+|[\<gcConcurrent\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)|ランタイムがガベージ コレクションを並列に実行するかどうかを指定します。|  
+|[\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md)|ガベージ コレクションが複数の CPU グループをサポートするかどうかを指定します。|  
+|[\<gcServer\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md)|共通言語ランタイムがサーバーのガベージ コレクションを実行するかどうかを指定します。|  
+|[\<generatePublisherEvidence\>](../../../../../docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md)|ランタイムがコード アクセス セキュリティ \(CAS: Code Access Security\) 発行者ポリシーを使用するかどうかを指定します。|  
+|[\<legacyCorruptedStateExceptionsPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md)|ランタイムでアクセス違反やその他の破損状態の例外をマネージ コードがキャッチできるかどうかを指定します。|  
+|[\<legacyImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md)|現在のスレッドの実行コンテキストのフロー設定に関係なく、Windows ID が非同期ポイント間をフローしないように指定します。|  
+|[\<loadfromRemoteSources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md)|リモート ソースからのアセンブリを完全信頼アセンブリとして読み込むかどうかを指定します。|  
+|[\<memoryCache\>](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)|<xref:System.Runtime.Caching.MemoryCache> クラスに基づいたキャッシュの構成に使用される要素を定義します。|  
+|[\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)|`namedCache` インスタンスの構成設定のコレクションが含まれます。|  
+|[\<NetFx40\_LegacySecurityPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)|ランタイムがレガシ コード アクセス セキュリティ \(CAS: Code Access Security\) ポリシーを使用するかどうかを指定します。|  
+|[\<NetFx40\_PInvokeStackResilience\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md)|ランタイムが、マネージ コードとアンマネージ コードの間の切り替えを低速にしてでも、実行時に不適切なプラットフォーム呼び出し宣言を自動的に修正するかどうかを指定します。|  
+|[\<NetFx45\_CultureAwareComparerGetHashCode\_LongStrings\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md)|<xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> のメソッドのハッシュ コードを計算するためにランタイムが固定メモリを使用するかどうかを指定します。|  
+|[\<PreferComInsteadOfManagedRemoting\>](../../../../../docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md)|ランタイムでアプリケーション ドメインの境界を越えたリモート処理ではなく COM 相互運用機能が使用されることを指定します。|  
+|[\<プローブ\>](../../../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md)|アセンブリを読み込むときに、ランタイムが検索するサブディレクトリを指定します。|  
+|[\<publisherPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md)|ランタイムが発行者ポリシーを適用するかどうかを指定します。|  
+|[\<qualifyAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md)|部分名が使用された場合に動的に読み込む必要があるアセンブリの完全名を指定します。|  
+|[\<relativeBindForResources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md)|サテライト アセンブリのプローブを最適化します。|  
+|[\<削除\>](../../../../../docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md)|メモリ キャッシュの `namedCaches` コレクションから、名前付きキャッシュ エントリを削除します。|  
+|[\<ランタイム\>](../../../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)|アセンブリのバインディングとガベージ コレクションの動作に関する情報を指定します。|  
+|[\<shadowCopyTimeStampVerification\>](../../../../../docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md)|シャドウ コピーの動作を、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] で導入された既定の起動動作にするか、旧バージョンの .NET Framework の起動動作に戻すかを指定します。|  
+|[\<supportPortability\>](../../../../../docs/framework/configure-apps/file-schema/runtime/supportportability-element.md)|.NET Framework の 2 つの異なる実装にある同じアセンブリを 1 つのアプリケーションから参照できるように、既定の動作を無効にすることができます。既定の動作では、アプリケーションの移植性を高めるために、このようなアセンブリは同等のものとして扱われます。|  
+|[\<system.runtime.caching\>](../../../../../docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md)|既定のメモリ内オブジェクト キャッシュの構成情報を提供します。|  
+|[\<Thread\_UseAllCpuGroups\>](../../../../../docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md)|ランタイムによって、すべての CPU グループにマネージ スレッドを分散するかどうかを指定します。|  
+|[\<ThrowUnobservedTaskExceptions\>](../../../../../docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md)|未処理の例外を実行中のプロセスを停止する必要があるかどうかを指定します。|  
+|[\<TimeSpan\_LegacyFormatMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)|ランタイムで <xref:System.TimeSpan> 値に書式設定のレガシ動作を使用するかどうかを指定します。|  
+|[\<UseRandomizedStringHashAlgorithm\>](../../../../../docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md)|ランタイムがアプリケーション ドメインごとに文字列のハッシュ コードを計算するかどうかを指定します。|  
+|[\<UseSmallInternalThreadStacks\>](../../../../../docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md)|ランタイムで内部的に使用する特定のスレッドを作成するときに、既定のスタック サイズではなく明示的なスタック サイズを使用することを要求します。|  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [How to: Disable Concurrent Garbage Collection](http://msdn.microsoft.com/ja-jp/ba2c6c67-5778-497c-9fac-5f793b5500c7)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md
new file mode 100644
index 00000000000..1d7a8d8ae9e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;legacyCorruptedStateExceptionsPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<legacyCorruptedStateExceptionsPolicy> 要素"
+  - "legacyCorruptedStateExceptionsPolicy 要素"
+ms.assetid: e0a55ddc-bfa8-4f3e-ac14-d1fc3330e4bb
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;legacyCorruptedStateExceptionsPolicy&gt; 要素
+共通言語ランタイムで、アクセス違反やその他の破損状態の例外をマネージ コードがキャッチできるようにするかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<legacyCorruptedStateExceptionsPolicy enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> アクセス違反などの破損状態の例外エラーをアプリケーションがキャッチするように指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|アプリケーションは、アクセス違反などの破損状態の例外エラーをキャッチしません。  これは、既定の設定です。|  
+|`true`|アプリケーションは、アクセス違反などの破損状態の例外エラーをキャッチします。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework Version 3.5 以前では、共通言語ランタイムは、プロセス状態の破損によって発生した例外をマネージ コードがキャッチできるようにしていました。  このような例外の例として、アクセス違反があります。  
+  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降では、このような例外がマネージ コードの `catch` ブロックでキャッチされなくなります。  ただし、次の 2 つの方法により、この変更をオーバーライドして破損状態の例外の処理を維持できます。  
+  
+-   `<legacyCorruptedStateExceptionsPolicy>` 要素の `enabled` 属性を `true` に設定します。  この構成設定はプロセス全体に適用され、すべてのメソッドに反映されます。  
+  
+ または  
+  
+-   例外の `catch` ブロックを含むメソッドに <xref:System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptionsAttribute?displayProperty=fullName> 属性を適用します。  
+  
+ この構成要素は、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降でのみ使用できます。  
+  
+## 使用例  
+ アプリケーションの動作を [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] より前の動作に戻し、破損状態の例外エラーをすべてキャッチするように指定する方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <legacyCorruptedStateExceptionsPolicy enabled="true" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.ExceptionServices.HandleProcessCorruptedStateExceptionsAttribute>   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md
new file mode 100644
index 00000000000..86bebd2537a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;legacyImpersonationPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#legacyImpersonationPolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/legacyImpersonationPolicy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<legacyImpersonationPolicy> 要素"
+  - "legacyImpersonationPolicy 要素"
+ms.assetid: 6e00af10-42f3-4235-8415-1bb2db78394e
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# &lt;legacyImpersonationPolicy&gt; 要素
+現在のスレッドの実行コンテキストのフロー設定に関係なく、Windows ID が非同期ポイント間をフローしないように指定します。  
+  
+## 構文  
+  
+```  
+<legacyImpersonationPolicy    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 現在のスレッドの <xref:System.Threading.ExecutionContext> フロー設定に関係なく、<xref:System.Security.Principal.WindowsIdentity> が非同期ポイント間をフローしないように指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|現在のスレッドの <xref:System.Threading.ExecutionContext> フロー設定に基づいて、<xref:System.Security.Principal.WindowsIdentity> が非同期ポイント間をフローします。  これは、既定の設定です。|  
+|`true`|現在のスレッドの <xref:System.Threading.ExecutionContext> フロー設定に関係なく、<xref:System.Security.Principal.WindowsIdentity> は非同期ポイント間をフローしません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ .NET Framework Version 1.0 および 1.1 では、<xref:System.Security.Principal.WindowsIdentity> はユーザー定義の非同期ポイント間をフローしません。  一方、.NET Framework Version 2.0 には、現在の実行スレッドに関する情報を格納し、これをアプリケーション ドメイン内の非同期ポイント間でフローさせる <xref:System.Threading.ExecutionContext> オブジェクトがあります。  <xref:System.Security.Principal.WindowsIdentity> も、非同期ポイント間をフローする情報の一部としてフローします。つまり、偽装コンテキストが終了した場合でもフローします。  この要素は、<xref:System.Security.Principal.WindowsIdentity> が非同期ポイント間をフローしないように指定するために使用されます。  
+  
+> [!NOTE]
+>  共通言語ランタイム \(CLR: Common Language Runtime\) は、マネージ コードのみを使用して実行される偽装操作を認識し、アンマネージ コードに対するプラットフォーム呼び出しや Win32 関数に対する直接呼び出しなどを通じてマネージ コードの外部で実行される偽装は認識しません。  `alwaysFlowImpersonationPolicy` 要素が true に設定 \(`<alwaysFlowImpersonationPolicy enabled="true"/>`\) されていない場合は、マネージ <xref:System.Security.Principal.WindowsIdentity> オブジェクトのみが非同期ポイント間をフローできます。  `alwaysFlowImpersonationPolicy` を true に設定すると、偽装の実行方法に関係なく、Windows ID が常に非同期ポイント間をフローするように指定されます。  非同期ポイント間のアンマネージ偽装のフローの詳細については、「[\<alwaysFlowImpersonationPolicy\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md)」を参照してください。  
+  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。  
+  
+ この既定の動作は、さらに次の 2 つの方法で変更できます。  
+  
+1.  スレッドごとにマネージ コードを使用する。  
+  
+     <xref:System.Threading.ExecutionContext.SuppressFlow%2A?displayProperty=fullName> メソッド、<xref:System.Security.SecurityContext.SuppressFlowWindowsIdentity%2A?displayProperty=fullName> メソッド、または <xref:System.Security.SecurityContext.SuppressFlow%2A?displayProperty=fullName> メソッドを使用して <xref:System.Threading.ExecutionContext> 設定と <xref:System.Security.SecurityContext> 設定を変更すると、スレッドごとにフローを止めることができます。  
+  
+2.  共通言語ランタイム \(CLR: Common Language Runtime\) を読み込むアンマネージ ホスト インターフェイスの呼び出しを使用する。  
+  
+     単純なマネージ実行可能ファイルの代わりに、アンマネージ ホスト インターフェイスを使用して CLR を読み込むと、[CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md) 関数の呼び出しで特別なフラグを指定できます。  プロセス全体の互換モードを有効にするには、[CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md) の `flags` パラメーターを STARTUP\_LEGACY\_IMPERSONATION に設定します。  
+  
+## 使用例  
+ 非同期ポイント間で Windows ID をフローしないレガシ動作を指定する方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <legacyImpersonationPolicy enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md b/docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md
new file mode 100644
index 00000000000..f44c50afccc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md
@@ -0,0 +1,111 @@
+---
+title: "&lt;loadFromRemoteSources&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "loadFromRemoteSources 要素"
+  - "<loadFromRemoteSources> 要素"
+ms.assetid: 006d1280-2ac3-4db6-a984-a3d4e275046a
+caps.latest.revision: 31
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# &lt;loadFromRemoteSources&gt; 要素
+リモート ソースからのアセンブリに完全信頼を与えるかどうかを指定します。  
+  
+> [!NOTE]
+>  Visual Studio プロジェクトのエラー一覧に表示されたエラー メッセージ、またはビルド エラーによってこのトピックにたどり着いた場合は、「[方法: Visual Studio で Web からダウンロードしたアセンブリを使用する](http://msdn.microsoft.com/ja-jp/d8635b63-89a0-41aa-90f4-f351b2111070)」を参照してください。  
+  
+## 構文  
+  
+```  
+<loadFromRemoteSources    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> リモート ソースから読み込まれるアセンブリに完全信頼を与えるかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|リモート ソースからのアプリケーションに完全信頼を与えません。  これは、既定の設定です。|  
+|`true`|リモート ソースからのアプリケーションに完全信頼を与えます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ .NET Framework Version 3.5 以前のバージョンでは、リモートの場所からアセンブリを読み込んだ場合、そのアセンブリは、読み込み先のゾーンに応じた許可セットが与えられた部分的に信頼されるアセンブリとして実行されていました。  たとえば、Web サイトからアセンブリを読み込んだら、インターネット ゾーンに読み込まれ、インターネット アクセス許可セットが与えられていました。  つまり、このようなアセンブリはインターネット サンドボックスで実行されていました。  [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降のバージョンでそのアセンブリを実行しようとすると、例外がスローされます; \([方法 : サンドボックスで部分信頼コードを実行する](../../../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)を参照してください\) 明示的にアセンブリのサンドボックスを作成したり、完全信頼で実行します。  
+  
+ `<loadFromRemoteSources>` 要素は、.NET Framework の以前のバージョンで部分的に信頼される実行するアセンブリが [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降で完全に信頼されて実行されるように指定することができます。  既定で、リモート アセンブリは [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降では実行されません。  リモート アセンブリを実行するには、完全信頼として実行するか、テストを実行するため <xref:System.AppDomain> サンドボックスを作成する必要があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)]では、ローカル ネットワークの共有のアセンブリを完全信頼として、既定で実行して; `<loadFromRemoteSources>` 要素を有効にする必要はありません。  
+  
+> [!NOTE]
+>  Web からコピーされたアプリケーションは、ローカル コンピューターにある場合でも、フラグが立てられ Web アプリケーションとして Windows によって異なります。  ファイルのプロパティを変更することにより、この指定を変更できます。または、`<loadFromRemoteSources>` 要素を使用して、アセンブリに完全信頼を与えることもできます。  別の方法として、オペレーティング システムがフラグを付けたローカル アセンブリを読み込むために <xref:System.Reflection.Assembly.UnsafeLoadFrom%2A> のメソッドを使用して、Web から読み込まれますです。  
+  
+ この要素の `enabled` 属性は、コード アクセス セキュリティ \(CAS: Code Access Security\) が無効になっている場合にのみ有効です。  [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降のバージョンでは、CAS ポリシーは既定で無効になっています。  `enabled` を `true` に設定すると、リモート アプリケーションには完全信頼が与えられます。  
+  
+ `<loadFromRemoteSources>` の `enabled` が `true` に設定されていない場合は、次の状況で例外がスローされます。  
+  
+-   現在のドメインのサンドボックス化の動作が [!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] での動作と異なる。  この場合、CAS ポリシーを無効にし、現在のドメインがサンドボックス化されないようにする必要があります。  
+  
+-   読み込まれるアセンブリが `MyComputer` ゾーンからのアセンブリではない。  
+  
+> [!NOTE]
+>  Windows Virtual PC アプリケーションの <xref:System.IO.FileLoadException> は、ホスト コンピューターのリンクされたフォルダーからファイルを読み込もうとしたときに発生することがあります。  このエラーは、リンクされたフォルダーからファイルを読み込むときに発生する可能性があります \([リモート デスクトップ サービス](http://go.microsoft.com/fwlink/?LinkId=182775) ターミナル サービス\)。  例外を回避するには、`enabled` を `true` に設定します。  
+  
+ `<loadFromRemoteSources>` 要素を `true` に設定すると、この例外がスローされなくなります。  この設定により、読み込まれたアセンブリを共通言語ランタイムに依存してセキュリティ目的でサンドボックス化せずに、完全信頼アセンブリとして実行できるように指定できます。  
+  
+> [!IMPORTANT]
+>  アセンブリを完全に信頼して実行しない場合は、この構成要素を設定しないでください。  代わりに、アセンブリの読み込み先としてサンドボックス化された <xref:System.AppDomain> を作成してください。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルで使用するそのほかの構成ファイルのコンテキストで使用できます。  詳細について、.NET のセキュリティ ブログ記事を [CAS ポリシーの暗黙の使用: loadFromRemoteSources](http://go.microsoft.com/fwlink/p/?LinkId=266839) 参照します。  
+  
+## 使用例  
+ リモート ソースからのアプリケーションに完全信頼を与える方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <loadFromRemoteSources enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [CAS ポリシーの暗黙の使用: loadFromRemoteSources](http://go.microsoft.com/fwlink/p/?LinkId=266839)   
+ [方法 : サンドボックスで部分信頼コードを実行する](../../../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md b/docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md
new file mode 100644
index 00000000000..db9b68fff1c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md
@@ -0,0 +1,108 @@
+---
+title: "&lt;memoryCache&gt; 要素 (キャッシュ設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<memoryCache> 要素"
+  - "キャッシュ [.NET Framework], 構成"
+  - "memoryCache 要素"
+ms.assetid: 182a622f-f7cf-472d-9d0b-451d2fd94525
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# &lt;memoryCache&gt; 要素 (キャッシュ設定)
+<xref:System.Runtime.Caching.MemoryCache> クラスに基づくキャッシュを構成するために使用される要素を定義します。<xref:System.Runtime.Caching.Configuration.MemoryCacheElement> クラスは、キャッシュの構成に使用できる [memoryCache](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md) 要素を定義します。<xref:System.Runtime.Caching.MemoryCache> クラスの複数のインスタンスを、単一のアプリケーションで使用できます。 構成ファイル内の各 `memoryCache` 要素には、指定した <xref:System.Runtime.Caching.MemoryCache> インスタンスの設定を含むことができます。  
+  
+ \<configuration\>  
+\<system.runtime.caching\>  
+\<memoryCache\>  
+  
+## 構文  
+  
+```  
+<memoryCache   
+    <namedCaches>  
+        <!-- child elements -->  
+    </namedCaches>   
+< memoryCache />  
+```  
+  
+## 型  
+ <xref:System.Runtime.Caching.MemoryCache> クラス。  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`CacheMemoryLimitMegabytes`|<xref:System.Runtime.Caching.MemoryCache> オブジェクトのインスタンスを拡張できる最大メモリ サイズ \(メガバイト\)。 既定値は 0 であり、これは <xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ調整ヒューリスティックが既定で使用されることを意味します。|  
+|`Name`|キャッシュ構成の名前。|  
+|`PhysicalMemoryLimitPercentage`|キャッシュが使用できる物理メモリの割合。 既定値は 0 であり、これは <xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ調整ヒューリスティックが既定で使用されることを意味します。|  
+|`PollingInterval`|時間間隔を示す値。この値を超えると、キャッシュの実装によりキャッシュ インスタンスに設定されている絶対およびパーセントのメモリ制限と現在のメモリ負荷が比較されます。 値は "HH:MM:SS" 形式で入力します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)|`namedCache` インスタンスの構成設定のコレクションが含まれます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.runtime.caching\>](../../../../../docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md)|[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] に組み込まれているアプリケーションに出力キャッシュを実装できるようにするタイプが含まれます。|  
+  
+## 解説  
+ <xref:System.Runtime.Caching.MemoryCache> クラスは、抽象 <xref:System.Runtime.Caching.ObjectCache> クラスの具象実装です。<xref:System.Runtime.Caching.MemoryCache> クラスのインスタンスには、アプリケーション構成ファイルの構成情報を指定することができます。[memoryCache](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md) 構成セクションには、`namedCaches` の構成コレクションが含まれます。  
+  
+ メモリ ベースのキャッシュ オブジェクトが初期化されると、まず、メモリ キャッシュ コンストラクターに渡されるパラメーターの名前と一致する `namedCaches` のエントリの検索が試行されます。`namedCaches` のエントリが見つかると、ポーリングとメモリ管理の情報が構成ファイルから取得されます。  
+  
+ 次に、初期化プロセスで、コンストラクターの構成情報にある名前\/値ペアの任意のコレクションを使用して、構成エントリがオーバーライドされているかどうかが確認されます。 名前\/値ペアのコレクションの、次の値のいずれかを渡すと、構成ファイルから取得した情報をその値がオーバーライドします。  
+  
+-   <xref:System.Runtime.Caching.Configuration.MemoryCacheElement.CacheMemoryLimitMegabytes%2A>  
+  
+-   <xref:System.Runtime.Caching.Configuration.MemoryCacheElement.PhysicalMemoryLimitPercentage%2A>  
+  
+-   <xref:System.Runtime.Caching.MemoryCache.PollingInterval%2A>  
+  
+## 使用例  
+ 次の例は、`name` 属性を "default" に設定することで、<xref:System.Runtime.Caching.MemoryCache> オブジェクトの名前を既定のキャッシュ オブジェクト名に設定する方法を示しています。  
+  
+ `cacheMemoryLimitMegabytes` 属性および `physicalMemoryPercentage` 属性はゼロに設定されます。 これらの属性をゼロに設定すると、<xref:System.Runtime.Caching.MemoryCache> の自動サイズ調整ヒューリスティックが既定で使用されることになります。 キャッシュの実装では、現在のメモリ負荷と絶対およびパーセントのメモリ制限を 2 分ごとに比較する必要があります。  
+  
+```  
+<configuration>  
+  <system.runtime.caching>  
+    <memoryCache>  
+      <namedCaches>  
+          <add name="default"   
+               cacheMemoryLimitMegabytes="0"   
+               physicalMemoryPercentage="0"  
+               pollingInterval="00:02:00" />  
+      </namedCaches>  
+    </memoryCache>  
+  </system.runtime.caching>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Caching.MemoryCache>   
+ [\<system.runtime.caching\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md)   
+ [\<namedCaches\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md b/docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md
new file mode 100644
index 00000000000..9f550cef985
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md
@@ -0,0 +1,98 @@
+---
+title: "&lt;namedCaches&gt; 要素 (キャッシュ設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<namedCaches> 要素"
+  - "キャッシュ [.NET Framework], 構成"
+  - "namedCaches 要素"
+ms.assetid: 6bd4fbc5-55a6-4dc4-998b-cdcc7e023330
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# &lt;namedCaches&gt; 要素 (キャッシュ設定)
+名前付き <xref:System.Runtime.Caching.MemoryCache> インスタンスの構成設定のコレクションを指定します。  <xref:System.Runtime.Caching.Configuration.MemoryCacheSection.NamedCaches%2A> プロパティは、構成ファイルの 1 つ以上の `namedCaches` 要素の構成設定のコレクションを参照します。  
+  
+## 構文  
+  
+```  
+<namedCaches>  
+  <add name="default"   
+</namedCaches>  
+```  
+  
+## 型  
+ `None`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`CacheMemoryLimitMegabytes`|<xref:System.Runtime.Caching.MemoryCache> のインスタンスについて許可される最大サイズ \(MB 単位\) を指定する整数値。  既定値は 0 です。これは、<xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。|  
+|`Name`|キャッシュの名前。|  
+|`PhysicalMemoryLimitPercentage`|キャッシュで使用できる物理的にインストールされたコンピューター メモリの最大パーセンテージを指定する 0 ～ 100 の整数値。  既定値は 0 です。これは、<xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ変更ヒューリスティックが既定で使用されることを意味します。|  
+|`PollingInterval`|キャッシュの実装が、現在のメモリ負荷を、キャッシュ インスタンスに設定されているメモリ制限の絶対値および割合と比較する時間間隔を示す値。  この値は "HH:MM:SS" の形式で入力されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/runtime/add-element-for-namedcaches.md)|名前付きキャッシュをメモリ キャッシュの `namedCaches` コレクションに追加します。|  
+|[\<&#91;clear&#93;\>](../../../../../docs/framework/configure-apps/file-schema/runtime/clear-element-for-namedcaches.md)|メモリ キャッシュの `namedCaches` コレクションを削除します。|  
+|[\<削除\>](../../../../../docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md)|メモリ キャッシュの `namedCaches` コレクションから、名前付きキャッシュ エントリを削除します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<memoryCache\>](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)|<xref:System.Runtime.Caching.MemoryCache> クラスに基づいたキャッシュの構成に使用される要素を定義します。|  
+  
+## 解説  
+ Web.config ファイルのメモリ キャッシュ構成セクションには、`namedCaches` コレクションの `add`、`remove`、および `clear` 属性を含めることができます。  各 `namedCaches` エントリは、`name` 属性によって一意に識別されます。  
+  
+ アプリケーション構成ファイル内の情報を参照することにより、メモリ キャッシュ エントリのインスタンスを取得できます。  既定では、既定のキャッシュ インスタンスのみが構成ファイルにエントリを持ちます。  既定のキャッシュ インスタンスは、<xref:System.Runtime.Caching.MemoryCache.Default%2A> プロパティから返されるインスタンスです。  
+  
+ 名前属性を "default" に設定した場合、要素では既定のメモリ キャッシュ インスタンスが使用されます。  
+  
+## 使用例  
+ `name` 属性を "default" に設定して、キャッシュの名前を既定のキャッシュ エントリ名に設定する方法を次の例に示します。  
+  
+ `cacheMemoryLimitMegabytes` 属性と `physicalMemoryPercentage` 属性は 0 に設定されています。  これらの属性を 0 に設定すると、<xref:System.Runtime.Caching.MemoryCache> クラスの自動サイズ変更ヒューリスティックが使用されます。  キャッシュの実装は、現在のメモリ負荷を、メモリ制限の絶対値および割合と 2 分ごとに比較します。  
+  
+```  
+<configuration>  
+  
+  <system.runtime.caching>  
+    <memoryCache>  
+      <namedCaches>  
+          <add name="default"   
+               cacheMemoryLimitMegabytes="0"   
+               physicalMemoryPercentage="0"  
+               pollingInterval="00:02:00" />  
+      </namedCaches>  
+    </memoryCache>  
+  </system.runtime.caching>  
+  
+</configuration>  
+```  
+  
+## 参照  
+ [\<memoryCache\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md
new file mode 100644
index 00000000000..6d695cdef2a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;NetFx40_LegacySecurityPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<NetFx40_LegacySecurityPolicy> 要素"
+  - "NetFx40_LegacySecurityPolicy 要素"
+ms.assetid: 07132b9c-4a72-4710-99d7-e702405e02d4
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# &lt;NetFx40_LegacySecurityPolicy&gt; 要素
+ランタイムがレガシ コード アクセス セキュリティ \(CAS: Code Access Security\) ポリシーを使用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<NetFx40_LegacySecurityPolicy  
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムがレガシ CAS ポリシーを使用するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ランタイムはレガシ CAS ポリシーを使用しません。  これは、既定の設定です。|  
+|`true`|ランタイムはレガシ CAS ポリシーを使用します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ .NET Framework Version 3.5 以前のバージョンでは、CAS ポリシーが常に有効になります。  [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] では、CAS ポリシーを明示的に有効にする必要があります。  
+  
+ CAS ポリシーはバージョンに固有です。  旧バージョンの .NET Framework に存在するカスタム CAS ポリシーは、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] では再度指定する必要があります。  
+  
+ `<NetFx40_LegacySecurityPolicy>` 要素を [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] アセンブリに適用しても、[透過的セキュリティ コード](../../../../../docs/framework/misc/security-transparent-code.md)には影響しません。透過性規則は引き続き適用されます。  
+  
+> [!IMPORTANT]
+>  `<NetFx40_LegacySecurityPolicy>` 要素を適用すると、[グローバル アセンブリ キャッシュ](../../../../../docs/framework/app-domains/gac.md)にインストールされていない、[ネイティブ イメージ ジェネレーター \(Ngen.exe\)](../../../../../docs/framework/tools/ngen-exe-native-image-generator.md) で作成されたネイティブ イメージのアセンブリでパフォーマンスが大幅に低下する可能性があります。  このパフォーマンスの低下が発生するのは、属性が適用されたときに、ランタイムがアセンブリをネイティブ イメージとして読み込むことができず、結果的に Just\-In\-Time アセンブリとして読み込まれるためです。  
+  
+> [!NOTE]
+>  Visual Studio プロジェクトのプロジェクト設定で、対象となる .NET Framework のバージョンとして、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] より前のバージョンを指定する場合は、そのバージョン用に指定したすべてのカスタム CAS ポリシーを含む CAS ポリシーが有効になります。  ただし、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] の新しい型およびメンバーは使用できません。  また [アプリケーション構成ファイル](../../../../../docs/framework/configure-apps/index.md)でスタートアップ設定スキーマの [\<supportedRuntime\> 要素](../../../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) を使用して .NET Framework の旧バージョンを指定できます。  
+  
+> [!NOTE]
+>  構成ファイルの構文では、大文字と小文字が区別されます。  構文と例の各セクションで提供されている構文を使用する必要があります。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。  
+  
+## 使用例  
+ アプリケーションのレガシ CAS ポリシーを有効にする方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <NetFx40_LegacySecurityPolicy enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md b/docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md
new file mode 100644
index 00000000000..1f292ca5073
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;NetFx40_PInvokeStackResilience&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<NetFx40_PInvokeStackResilience> 要素"
+  - "NetFx40_PInvokeStackResilience 要素"
+ms.assetid: 39fb1588-72a4-4479-af74-0605233b68bd
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;NetFx40_PInvokeStackResilience&gt; 要素
+ランタイムが、マネージ コードとアンマネージ コードの間の切り替えを低速にしてでも、実行時に不適切なプラットフォーム呼び出し宣言を自動的に修正するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<NetFx40_PInvokeStackResilience  enabled="1|0"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムが、32 ビット プラットフォームで実行時に不適切なプラットフォーム呼び出し宣言を検出し、スタックを自動的に修正するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`0`|ランタイムは、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] で導入された、より高速な相互運用マーシャリング アーキテクチャを使用します。このアーキテクチャは、不適切なプラットフォーム呼び出し宣言を検出および修正しません。  これは、既定の設定です。|  
+|`1`|ランタイムは、不適切なプラットフォーム呼び出し宣言を検出および修正する、より低速な切り替えを使用します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ この要素を使用すると、より高速な相互運用マーシャリングを、不適切なプラットフォーム呼び出し宣言に対するランタイム回復と交換できます。  
+  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降では、効率化された相互運用マーシャリング アーキテクチャによって、マネージ コードからアンマネージ コードへの切り替えのパフォーマンスが大幅に向上します。  旧バージョンの .NET Framework では、マーシャリング レイヤーは 32 ビット プラットフォームで不適切なプラットフォーム呼び出し宣言を検出し、スタックを自動的に修正しました。  新しいマーシャリング アーキテクチャでは、この手順が排除されます。  その結果、切り替えは非常に高速ですが、不適切なプラットフォーム呼び出し宣言によってプログラム エラーが発生することがあります。  
+  
+ 開発中に不適切な宣言を簡単に検出するために、Visual Studio デバッグ機能が強化されました。  [pInvokeStackImbalance](../../../../../docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md) マネージ デバッグ アシスタント \(MDA\) は、アプリケーションにデバッガーがアタッチされて稼働しているときに、不適切なプラットフォーム呼び出し宣言を通知します。  
+  
+ 再コンパイルできず、不適切なプラットフォーム呼び出し宣言のあるコンポーネントをアプリケーションが使用する状況に対処するために、`NetFx40_PInvokeStackResilience` 要素を使用できます。  `enabled="1"` を指定してこの要素をアプリケーション構成ファイルに追加すると、切り替えは遅くなりますが、旧バージョンの .NET Framework の動作との互換モードを選択することができます。  旧バージョンの .NET Framework に対してコンパイルされたアセンブリでは、この互換モードが自動的に選択されるため、この要素は不要です。  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルでのみ使用できます。  
+  
+## 使用例  
+ マネージ コードとアンマネージ コードの間の切り替えは低速になりますが、アプリケーションの不適切なプラットフォーム呼び出し宣言に対する回復を強化する方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <NetFx40_PInvokeStackResilience enabled="1"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [pInvokeStackImbalance](../../../../../docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md b/docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md
new file mode 100644
index 00000000000..3e5d75c5ab3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;NetFx45_CultureAwareComparerGetHashCode_LongStrings&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "NetFx45_CultureAwareComparerGetHashCode_LongStrings 要素"
+  - "<NetFx45_CultureAwareComparerGetHashCode_LongStrings> 要素"
+  - "GetHashCode メソッド"
+  - "ハッシュ コード, 計算"
+ms.assetid: 3a5f38d1-ebc8-44de-aaeb-2929f6e6b48f
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;NetFx45_CultureAwareComparerGetHashCode_LongStrings&gt; 要素
+ランタイムが <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> メソッドで固定量のメモリを使用してハッシュ コードを計算するかどうかを指定します。  
+  
+ \<configuration\>  
+\<runtime\>  
+\<NetFx45\_CultureAwareComparerGetHashCode\_LongStrings\>  
+  
+## 構文  
+  
+```vb  
+<NetFx45_CultureAwareComparerGetHashCode_LongStrings enabled="0|1">  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ハッシュ コードを計算するときに、共通言語ランタイムが固定メモリを割り当てるかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|0|共通言語ランタイムが <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> メソッドに可変メモリを割り当ててハッシュ コードを計算します。 既定値です。|  
+|1|共通言語ランタイムが <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> メソッドに固定メモリを割り当ててハッシュ コードを計算します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ 既定では、共通言語ランタイムが <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> メソッドに可変メモリを割り当て、メソッドが非常に長い文字列 \(数メガバイト以上\) のハッシュ コードを計算しようとすると <xref:System.ArgumentException> 例外がスローされることがあります。 この要素をアプリケーション構成ファイルに追加し、`enabled` 属性を 1 に設定すると、<xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> メソッドでハッシュ コードの計算時に固定メモリを割り当てる別のアルゴリズムを使用することを指定できます。  
+  
+> [!IMPORTANT]
+>  `<NetFx45_CultureAwareComparerGetHashCode_LongStrings>` 要素は [!INCLUDE[win8](../../../../../includes/win8-md.md)] 以降のバージョンでは使用されません。  
+  
+## 参照  
+ <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName>   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md b/docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md
new file mode 100644
index 00000000000..ee47300049b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;PreferComInsteadOfManagedRemoting&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<PreferComInsteadOfManagedRemoting> 要素"
+  - "PreferComInsteadOfManagedRemoting 要素"
+ms.assetid: a279a42a-c415-4e79-88cf-64244ebda613
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# &lt;PreferComInsteadOfManagedRemoting&gt; 要素
+アプリケーション ドメインの境界を越えるすべての呼び出しについて、リモート処理ではなく COM 相互運用機能をランタイムで使用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+<PreferComInsteadOfManagedRemoting enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> アプリケーション ドメインの境界を越える場合に、リモート処理ではなく COM 相互運用機能をランタイムで使用するかどうかを示します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ランタイムは、アプリケーション ドメインの境界を越える場合にリモート処理を使用します。  これは、既定の設定です。|  
+|`true`|ランタイムは、アプリケーション ドメインの境界を越える場合に COM 相互運用機能を使用します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ `enabled` 属性を `true` に設定した場合、ランタイムの動作は次のようになります。  
+  
+-   ランタイムは [IManagedObject](../../../../../ocs/framework/unmanaged-api/hosting/imanagedobject-interface.md) インターフェイスをインターフェイスが [IUnknown](http://go.microsoft.com/fwlink/?LinkId=148003) COM インターフェイスを通じてドメインに入ったとき求めません [IUnknown::QueryInterface](http://go.microsoft.com/fwlink/?LinkID=144867)。  代わりに、オブジェクトを囲む[ランタイム呼び出し可能ラッパー](../../../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW: Runtime Callable Wrapper\) を構築します。  
+  
+-   このドメインで生成された [COM 呼び出し可能ラッパー](../../../../../docs/framework/interop/com-callable-wrapper.md) \(CCW: COM Callable Wrapper\) の [IManagedObject](../../../../../ocs/framework/unmanaged-api/hosting/imanagedobject-interface.md) インターフェイスの `QueryInterface` 呼び出しを受け取った場合、ランタイムは E\_NOINTERFACE を返します。  
+  
+ この 2 つの動作によって、アプリケーション ドメインの境界を越えるマネージ オブジェクト間での COM インターフェイスを介する呼び出しは、すべてリモート処理ではなく COM と COM 相互運用機能を使用するようになります。  
+  
+## 使用例  
+ 次の例は、分離の境界を越える場合に、ランタイムで COM 相互運用機能が使用されるように指定する方法を示しています。  
+  
+```  
+<configuration>  
+  <runtime>  
+    <PreferComInsteadOfManagedRemoting enabled="true"/>  
+  </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/probing-element.md b/docs/framework/configure-apps/file-schema/runtime/probing-element.md
new file mode 100644
index 00000000000..0c7c4b95b78
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/probing-element.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;probing&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/probing"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#probing"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<probing> 要素"
+  - "コンテナー タグ, <probing> 要素"
+  - "probing 要素"
+ms.assetid: 09c80fc9-1ba5-4192-89f7-3a79b2e4b024
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# &lt;probing&gt; 要素
+アセンブリを読み込むときに、共通言語ランタイムが検索するアプリケーション ベース サブディレクトリを指定します。  
+  
+## 構文  
+  
+```  
+<probing privatePath="paths"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`privatePath`|必須の属性です。<br /><br /> アセンブリが格納されているアプリケーションのベース ディレクトリのサブディレクトリを指定します。  サブディレクトリは、セミコロン \(;\) で区切ります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 使用例  
+ ランタイムがアセンブリを検索するアプリケーション ベース サブディレクトリを指定する例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <probing privatePath="bin;bin2\subbin;bin3"/>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリの場所の指定](../../../../../docs/framework/configure-apps/specify-assembly-location.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md b/docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md
new file mode 100644
index 00000000000..3599dd7f919
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;publisherPolicy&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/publisherPolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/dependentAssembly/publisherPolicy"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#publisherPolicy"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<publisherPolicy> 要素"
+  - "コンテナー タグ, <publisherPolicy> 要素"
+  - "publisherPolicy 要素"
+ms.assetid: 4613407e-d0a8-4ef2-9f81-a6acb9fdc7d4
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# &lt;publisherPolicy&gt; 要素
+ランタイムが発行者ポリシーを適用するかどうかを指定します。  
+  
+## 構文  
+  
+```  
+  
+<publisherPolicy apply="yes|no"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`apply`|発行者ポリシーを適用するかどうかを指定します。|  
+  
+## apply 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`yes`|発行者ポリシーを適用します。  これは、既定の設定です。|  
+|`no`|発行者ポリシーを適用しません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ コンポーネントの販売元は、アセンブリの新しいバージョンをリリースするときに、以前のバージョンを使用していたアプリケーションが新しいバージョンを使用するように、発行者ポリシーを含めることができます。  指定するには、特定のアセンブリの発行者ポリシーを適用するかどうか **\<dependentAssembly\>** 要素に **\<publisherPolicy\>** 要素を含めます。  
+  
+ **apply** 属性の既定の設定は **yes** です。  **apply** 属性を **no** に設定すると、アセンブリに対して既に設定されていたすべての **yes** がオーバーライドされます。  
+  
+ アクセス許可はアプリケーションに明示的にアプリケーション構成ファイルの [\<publisherPolicy apply\= "いいえ」\/\>](../../../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md) 要素を使用して発行者ポリシーを無視する必要があります。  アクセス許可は、[SecurityPermission クラス](frlrfSystemSecurityPermissionsSecurityPermissionClassTopic)の [BindingRedirects](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) フラグを設定することによって付与されます。  詳細については、「[アセンブリ バインディング リダイレクトのセキュリティ アクセス許可](../../../../../docs/framework/configure-apps/assembly-binding-redirection-security-permission.md)」を参照してください。  
+  
+## 使用例  
+ アセンブリ `myAssembly` の発行者ポリシーを無効にする例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                                    publicKeyToken="32ab4ba45e0a69a1"  
+                                    culture="neutral" />  
+            <publisherPolicy apply="no"/>  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md b/docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md
new file mode 100644
index 00000000000..5f3a9c11161
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;qualifyAssembly&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#qualifyAssembly"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime/assemblyBinding/qualifyAssembly"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<qualifyAssembly> 要素"
+  - "コンテナー タグ, <qualifyAssembly> 要素"
+  - "qualifyAssembly 要素"
+ms.assetid: ad6442f6-1a9d-43b6-b733-04ac1b7f9b82
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# &lt;qualifyAssembly&gt; 要素
+部分名が使用された場合に動的に読み込む必要があるアセンブリの完全名を指定します。  
+  
+## 構文  
+  
+```  
+  
+      <qualifyAssembly partialName=  
+      "PartialAssemblyName"  
+                 fullName="FullAssemblyName"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`partialName`|必須の属性です。<br /><br /> コード内で使用するアセンブリの部分名を指定します。|  
+|`fullName`|必須の属性です。<br /><br /> グローバル アセンブリ キャッシュ内で使用するアセンブリの完全名を指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ 部分アセンブリ名を使用して <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを呼び出すと、共通言語ランタイムはアプリケーション ベース ディレクトリ内でのみアセンブリを検索します。  完全なアセンブリ情報 \(名前、バージョン、公開キー トークン、およびカルチャ\) を指定すると、共通言語ランタイムはグローバル アセンブリ キャッシュ内のアセンブリを捜させますアプリケーション構成ファイルで **\<qualifyAssembly\>** 要素を使用します。  
+  
+ **fullName** 属性には、アセンブリを識別するための 4 つのフィールド \(名前、バージョン、公開キー トークン、およびカルチャ\) を含める必要があります。  **partialName** 属性は、アセンブリを部分的に参照します。  少なくともアセンブリのテキスト名を指定する必要がありますが \(これが最も一般的です\)、テキスト名だけでなく、バージョン、公開キー トークン、カルチャ、またはこれら 4 つの任意の組み合わせも指定できます。  **partialName** は、呼び出しで指定する名前と一致する必要があります。  たとえば、構成ファイル内の **partialName** 属性として `"math"` を指定した場合に、コード内で呼び出し `Assembly.Load("math, Version=3.3.3.3")` を指定することはできません。  
+  
+## 使用例  
+ `Assembly.Load("math")` を `Assembly.Load("math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral")` の呼び出しに論理的に変換する例を次に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <qualifyAssembly partialName="math"   
+                         fullName=  
+"math,version=1.0.0.0,publicKeyToken=a1690a5ea44bab32,culture=neutral"/>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [ランタイムがアセンブリを検索する方法](../../../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [NIB: Partial Assembly References](http://msdn.microsoft.com/ja-jp/ec90f07a-398c-4306-9401-0fc5ff9cb59f)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md b/docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md
new file mode 100644
index 00000000000..a964dfca3c4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;relativeBindForResources&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<relativeBindForResources> 要素"
+  - "RelativeBindForResources 要素"
+ms.assetid: 846ffa47-7257-4ce3-8cac-7ff627e0e34f
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;relativeBindForResources&gt; 要素
+サテライト アセンブリのプローブを最適化します。  
+  
+## 構文  
+  
+```vb  
+<relativeBindForResources    
+   enabled="true|false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 共通言語ランタイムはサテライト アセンブリのプローブを最適化するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ランタイムでは、サテライト アセンブリのプローブを最適化しません。  これが既定値です。|  
+|`true`|ランタイムでは、サテライト アセンブリのプローブを最適化します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ 一般に、リソース マネージャーは [リソースのパッケージ化と配置](../../../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md) のトピックで説明されているように、リソースの場合は、プローブします。  これは、リソース マネージャーがリソースのローカライズ バージョンのプローブと、サテライト アセンブリをアプリケーション コード ベースのカルチャ固有のフォルダーのグローバル アセンブリ キャッシュ、外観、クエリ Window インストーラーを表示することもできます。<xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを発生させることを意味します。  `<relativeBindForResources>` 要素は、リソース マネージャーによってサテライト アセンブリのプローブ方法を最適化します。  これは、次の状況下でリソースのプローブとパフォーマンスが向上する場合:  
+  
+-   サテライト アセンブリがコード アセンブリと同じ場所に配置されます。  つまり、コードのアセンブリがグローバル アセンブリ キャッシュにインストールされている場合、サテライト アセンブリは、そこにインストールする必要があります。  コードのアセンブリがアプリケーション コード ベースにインストールされている場合、サテライト アセンブリは、コード ベースのカルチャ固有のフォルダーにインストールする必要があります。  
+  
+-   Windows インストーラーでのサテライト アセンブリのオンデマンド インストールにほとんど使用されず、使用しない場合。  
+  
+-   アプリケーション コードが <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを処理しない場合。  
+  
+ `true` へ `<relativeBindForResources>` 要素の `enabled` 属性を設定すると、次のようにサテライト アセンブリのリソース マネージャーのプローブを最適化します:  
+  
+-   これはサテライト アセンブリのプローブに親コード アセンブリの場所が使用されます。  
+  
+-   これはサテライト アセンブリのクエリ Window インストーラー。  
+  
+-   これは <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを発生させません。  
+  
+## 参照  
+ [リソースのパッケージ化と配置](../../../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)   
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md b/docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md
new file mode 100644
index 00000000000..020af16be44
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/remove-element-for-namedcaches.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;namedCaches&gt; の &lt;remove&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "namedCaches の <remove> 要素"
+  - "namedCaches の remove 要素"
+ms.assetid: 24211ea5-163e-4fe5-aed8-004d8499760c
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;namedCaches&gt; の &lt;remove&gt; 要素
+メモリ キャッシュの `namedCaches` コレクションから、名前付きキャッシュ エントリを削除します。  
+  
+## 構文  
+  
+```  
+<namedCaches>  
+    <remove name="default" />  
+    <!-- child elements -->  
+ </namedCaches>  
+```  
+  
+## 型  
+ `None`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ `None`  
+  
+### 子要素  
+ `None`  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedCaches\>](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)|名前付き <xref:System.Runtime.Caching.MemoryCache> インスタンスの構成設定のコレクションが含まれます。|  
+  
+## 解説  
+ `remove` 要素は、メモリ キャッシュの名前付きキャッシュ コレクションから `namedCache` エントリを削除します。  
+  
+## 参照  
+ [\<namedCaches\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/namedcaches-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/runtime-element.md b/docs/framework/configure-apps/file-schema/runtime/runtime-element.md
new file mode 100644
index 00000000000..25a0662bcc4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/runtime-element.md
@@ -0,0 +1,143 @@
+---
+title: "&lt;runtime&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#runtime"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/runtime"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<runtime> 要素"
+  - "コンテナー タグ, <runtime> 要素"
+  - "runtime 要素"
+ms.assetid: 1eb2fae3-de4b-45b6-852f-517c39b751bd
+caps.latest.revision: 70
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 62
+---
+# &lt;runtime&gt; 要素
+アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。  
+  
+## 構文  
+  
+```  
+<runtime>  
+</runtime>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<alwaysFlowImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md)|偽装の実行方法に関係なく、Windows ID が常に非同期ポイント間をフローするように指定します。|  
+|[\<appDomainManagerAssembly\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element.md)|プロセスの既定のアプリケーション ドメインにアプリケーション ドメイン マネージャーを提供するアセンブリを指定します。|  
+|[\<appDomainManagerType\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element.md)|既定のアプリケーション ドメインのアプリケーション ドメイン マネージャーとして機能する型を指定します。|  
+|[\<appDomainResourceMonitoring\>](../../../../../docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md)|プロセスの有効期間中、プロセス内のすべてのアプリケーション ドメインに関する統計情報を収集するようにランタイムに指示します。|  
+|[\<assemblyBinding\>](../../../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md)|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+|[\<bypassTrustedAppStrongNames\>](../../../../../docs/framework/configure-apps/file-schema/runtime/bypasstrustedappstrongnames-element.md)|完全に信頼されているアセンブリの厳密な名前の検証をバイパスするかどうかを指定します。|  
+|[\<CompatSortNLSVersion\>](../../../../../docs/framework/configure-apps/file-schema/runtime/compatsortnlsversion-element.md)|文字列比較の実行時に、ランタイムがレガシ並べ替え動作を使用するように指定します。|  
+|[\<developmentMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md)|DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するかどうかを指定します。|  
+|[\<disableCachingBindingFailures\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md)|.NET Framework Version 2.0 の既定の動作であるバインディング エラーのキャッシュを無効にするかどうかを指定します。|  
+|[\<disableCommitThreadStack\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablecommitthreadstack-element.md)|スレッドの起動時にスレッド スタック全体をコミットするかどうかを指定します。|  
+|[\<disableFusionUpdatesFromADManager\>](../../../../../docs/framework/configure-apps/file-schema/runtime/disablefusionupdatesfromadmanager-element.md)|アプリケーション ドメインの構成設定をランタイム ホストがオーバーライドできるという既定の動作を、無効にするかどうかを指定します。|  
+|[\<enforceFIPSPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/enforcefipspolicy-element.md)|暗号アルゴリズムが連邦情報処理規格 \(FIPS: Federal Information Processing Standard\) に準拠することを必要とするコンピューターの構成要件を適用するかどうかを指定します。|  
+|[\<etwEnable\>](../../../../../docs/framework/configure-apps/file-schema/runtime/etwenable-element.md)|共通言語ランタイム イベントで Windows イベント トレーシング \(ETW\) を有効にするかどうかを指定します。|  
+|[\<forcePerformanceCounterUniqueSharedMemoryReads\>](../../../../../docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md)|PerfCounter.dll がカテゴリ固有の共有メモリとグローバル メモリのどちらからパフォーマンス カウンター データを読み込むかを判断するために .NET Framework Version 1.1 アプリケーションの CategoryOptions レジストリ設定を使用するかどうかを指定します。|  
+|[\<gcAllowVeryLargeObjects\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md)|64 ビット プラットフォームで、合計サイズが 2 GB \(ギガバイト\) を超える配列を有効にします。|  
+|[\<gcConcurrent\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)|共通言語ランタイムがガベージ コレクションを並列に実行するかどうかを指定します。|  
+|[\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md)|ガベージ コレクションが複数の CPU グループをサポートするかどうかを指定します。|  
+|[\<gcServer\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md)|共通言語ランタイムがサーバーのガベージ コレクションを実行するかどうかを指定します。|  
+|[\<generatePublisherEvidence\>](../../../../../docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md)|ランタイムがコード アクセス セキュリティ \(CAS: Code Access Security\) 発行者ポリシーを使用するかどうかを指定します。|  
+|[\<legacyCorruptedStateExceptionsPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacycorruptedstateexceptionspolicy-element.md)|ランタイムでアクセス違反やその他の破損状態の例外をマネージ コードがキャッチできるかどうかを指定します。|  
+|[\<legacyImpersonationPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md)|現在のスレッドの実行コンテキストのフロー設定に関係なく、Windows ID が非同期ポイント間をフローしないように指定します。|  
+|[\<loadfromRemoteSources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md)|リモート ソースからのアセンブリを完全信頼アセンブリとして読み込むかどうかを指定します。|  
+|[\<NetFx40\_LegacySecurityPolicy\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)|ランタイムがレガシ コード アクセス セキュリティ \(CAS: Code Access Security\) ポリシーを使用するかどうかを指定します。|  
+|[\<NetFx40\_PInvokeStackResilience\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx40-pinvokestackresilience-element.md)|ランタイムが、マネージ コードとアンマネージ コードの間の切り替えを低速にしてでも、実行時に不適切なプラットフォーム呼び出し宣言を自動的に修正するかどうかを指定します。|  
+|[\<NetFx45\_CultureAwareComparerGetHashCode\_LongStrings\>](../../../../../docs/framework/configure-apps/file-schema/runtime/netfx45-cultureawarecomparergethashcode-longstrings-element.md)|<xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName> のメソッドのハッシュ コードを計算するためにランタイムが固定メモリを使用するかどうかを指定します。|  
+|[\<PreferComInsteadOfRemoting\>](../../../../../docs/framework/configure-apps/file-schema/runtime/prefercominsteadofmanagedremoting-element.md)|ランタイムでアプリケーション ドメインの境界を越えたリモート処理ではなく COM 相互運用機能が使用されることを指定します。|  
+|[\<relativeBindForResources\>](../../../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md)|サテライト アセンブリのプローブを最適化します。|  
+|[\<shadowCopyVerifyByTimeStamp\>](../../../../../docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md)|シャドウ コピーの動作を、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] で導入された既定の起動動作にするか、旧バージョンの .NET Framework の起動動作に戻すかを指定します。|  
+|[\<supportPortability\>](../../../../../docs/framework/configure-apps/file-schema/runtime/supportportability-element.md)|.NET Framework の 2 つの異なる実装にある同じアセンブリを 1 つのアプリケーションから参照できるように、既定の動作を無効にすることができます。既定の動作では、アプリケーションの移植性を高めるために、このようなアセンブリは同等のものとして扱われます。|  
+|[\<system.runtime.caching\>](../../../../../docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md)|既定のメモリ内オブジェクト キャッシュの構成情報を提供します。|  
+|[\<Thread\_UseAllCpuGroups\>](../../../../../docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md)|ランタイムによって、すべての CPU グループにマネージ スレッドを分散するかどうかを指定します。|  
+|[\<ThrowUnobservedTaskExceptions\>](../../../../../docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md)|未処理の例外を実行中のプロセスを停止する必要があるかどうかを指定します。|  
+|[\<TimeSpan\_LegacyFormatMode\>](../../../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)|ランタイムで <xref:System.TimeSpan> 値に書式設定のレガシ動作を使用するかどうかを指定します。|  
+|[\<UseRandomizedStringHashAlgorithm\>](../../../../../docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md)|ランタイムがアプリケーション ドメインごとに文字列のハッシュ コードを計算するかどうかを指定します。|  
+|[\<UseSmallInternalThreadStacks\>](../../../../../docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md)|ランタイムで内部的に使用する特定のスレッドを作成するときに、既定のスタック サイズではなく明示的なスタック サイズを使用することを要求します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+ .NET Framework Version 2.0 では、アプリケーション ドメイン内の非同期ポイント間で偽装 ID がフローします。  .NET Framework Version 2.0 では、machine.config ファイルまたはアプリケーションの構成ファイルでランタイム要素を適切に構成することで、非同期ポイント間の偽装のフローを有効または無効にできます。  ASP.NET の場合、偽装のフローは Windows \<\>Folder\\Microsoft.NET\\Framework\\vx.x.xxxx のディレクトリにある aspnet.config ファイルで構成できます。  
+  
+ 既定では、ASP.NET は、aspnet.config ファイルに次の構成設定が使用されて偽装フローが無効になります。  
+  
+```  
+configuration>  
+   <runtime>  
+      <legacyImpersonationPolicy enabled="true"/>  
+      <alwaysFlowImpersonationPolicy enabled="false"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+ ASP.NET で偽装のフローを可能にする場合は、次の構成設定を明示的に使用する必要があります。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <legacyImpersonationPolicy enabled="false"/>  
+      <alwaysFlowImpersonationPolicy enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+ 詳細については、「[\<legacyImpersonationPolicy\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/legacyimpersonationpolicy-element.md)」および「[\<alwaysFlowImpersonationPolicy\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/alwaysflowimpersonationpolicy-element.md)」を参照してください。  
+  
+## 使用例  
+ あるアセンブリ バージョンを別のバージョンにリダイレクトする例を示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <dependentAssembly>  
+            <assemblyIdentity name="myAssembly"  
+                              publicKeyToken="32ab4ba45e0a69a1"  
+                              culture="neutral" />  
+             <bindingRedirect oldVersion="1.0.0.0"  
+                              newVersion="2.0.0.0"/>  
+         </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../../../docs/framework/configure-apps/redirect-assembly-versions.md)   
+ [How to: Disable Concurrent Garbage Collection](http://msdn.microsoft.com/ja-jp/ba2c6c67-5778-497c-9fac-5f793b5500c7)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md b/docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md
new file mode 100644
index 00000000000..946830091aa
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/shadowcopyverifybytimestamp-element.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;shadowCopyVerifyByTimestamp&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<shadowCopyTimeStampVerification> 要素"
+  - "shadowCopyTimeStampVerification 要素"
+ms.assetid: 2f1648e5-997b-435e-a4f9-d236c574c66c
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;shadowCopyVerifyByTimestamp&gt; 要素
+シャドウ コピーの動作を、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] で導入された既定の起動動作にするか、旧バージョンの .NET Framework の起動動作に戻すかを指定します。  
+  
+## 構文  
+  
+```  
+<shadowCopyVerifyByTimestamp enabled="true|false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> アセンブリをシャドウ コピーする前にそのアセンブリが更新されているかどうかを確認するため、起動時に、シャドウ コピーを使用するアプリケーション ドメインでアセンブリのタイム スタンプを比較するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|true|起動時、シャドウ コピー ディレクトリに前回コピーされたときから更新されているアセンブリのみをコピーします。  これは [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] の既定値です。|  
+|false|以前のバージョンの .NET Framework の起動動作に戻します。この場合、起動時にすべてのファイルがコピーされます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] 以降では、アセンブリがシャドウ コピーされるのは、アセンブリがシャドウ コピー ディレクトリに前回コピーされたときから変更されていることがタイム スタンプからわかる場合だけです。  この方法では、シャドウ コピーを使用するアプリケーションの多くで起動時間が速くなります。詳細については、「[アセンブリのシャドウ コピー](../../../../../docs/framework/app-domains/shadow-copy-assemblies.md)」を参照してください。  アセンブリが更新される割合や頻度が高いアプリケーションでは、この動作の変更による利点がないこともあります。  この場合、.NET Framework の以前のバージョンの動作を復元するには、この要素を使用します。  
+  
+## 使用例  
+ [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] のシャドウ コピーの既定の起動動作を無効にし、以前のバージョンの .NET Framework の起動動作に戻す方法を、次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <shadowCopyVerifyByTimestamp enabled="false" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリのシャドウ コピー](../../../../../docs/framework/app-domains/shadow-copy-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/supportportability-element.md b/docs/framework/configure-apps/file-schema/runtime/supportportability-element.md
new file mode 100644
index 00000000000..352edf6eb20
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/supportportability-element.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;supportPortability&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<supportPortability> 要素"
+  - "supportPortability 要素"
+ms.assetid: 6453ef66-19b4-41f3-b712-52d0c2abc9ca
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# &lt;supportPortability&gt; 要素
+.NET Framework の 2 つの異なる実装にある同じアセンブリを 1 つのアプリケーションから参照できるように、既定の動作を無効にすることができます。既定の動作では、アプリケーションの移植性を高めるために、このようなアセンブリは同等のものとして扱われます。  
+  
+## 構文  
+  
+```  
+<supportPortability PKT="public_key_token" enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|PKT|必須の属性です。<br /><br /> 対象となるアセンブリの公開キー トークンを文字列で指定します。|  
+|enabled|省略可能な属性。<br /><br /> 指定した .NET Framework アセンブリの複数の実装間での移植性に対するサポートを有効にするかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|true|指定した .NET Framework アセンブリの複数の実装間での移植性に対するサポートを有効にします。  これは、既定の設定です。|  
+|false|指定した .NET Framework アセンブリの複数の実装間での移植性に対するサポートを無効にします。  この場合、指定したアセンブリの複数の実装をアプリケーションで参照できます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+|`assemblyBinding`|アセンブリ バージョンのリダイレクトおよびアセンブリの位置に関する情報が含まれます。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降では、.NET Framework の実装と .NET Framework for Silverlight の実装のどちらかなど、.NET Framework の 2 つの実装のうちどちらでも使用できるアプリケーションが自動的にサポートされます。  特定の .NET Framework アセンブリの 2 つの実装は、アセンブリ バインダーで同等と見なされます。  一部のシナリオでは、アプリケーションの移植性を高めるためのこの機能が問題になります。  そのようなシナリオでは、`<supportPortability>` 要素を使用して、この機能を無効にすることができます。  
+  
+ 一例として、特定の参照アセンブリの .NET Framework の実装と .NET Framework for Silverlight の実装の両方を参照する必要があるアセンブリが挙げられます。  たとえば、WPF \(Windows Presentation Foundation\) で作成された XAML デザイナーにおいて、デザイナーのユーザー インターフェイスとして WPF デスクトップの実装を参照すると共に、Silverlight の実装に組み込まれている WPF のサブセットも参照する必要がある場合があります。  既定では、この 2 つのアセンブリはアセンブリ バインディングで同等と見なされるため、別々に参照するとコンパイラ エラーが発生します。  この要素を使用すると、既定の動作を無効にし、コンパイルを正常に実行できます。  
+  
+> [!IMPORTANT]
+>  コンパイラから共通言語ランタイムのアセンブリ バインディング ロジックに情報を渡すには、`/appconfig` コンパイラ オプションを使用して、この要素を含む app.config ファイルの場所を指定する必要があります。  
+  
+## 使用例  
+ .NET Framework と .NET Framework for Silverlight の両方の実装に存在する .NET Framework アセンブリについて、その両方の実装をアプリケーションで参照できるようにする例を次に示します。  `/appconfig` コンパイラ オプションを使用して、この app.config ファイルの場所を指定する必要があります。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding>  
+         <supportPortability PKT="7cec85d7bea7798e" enable="false"/>  
+         <supportPortability PKT="31bf3856ad364e35" enable="false"/>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [\/appconfig \(C\# コンパイラ オプション\)](http://msdn.microsoft.com/library/ee523958.aspx)   
+ [.NET Framework Assembly Unification Overview](http://msdn.microsoft.com/ja-jp/8d8cc65e-031d-463b-bde3-2c6dc2e3bc48)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md b/docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md
new file mode 100644
index 00000000000..bbe24f4cd3e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/system-runtime-caching-element-cache-settings.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;system.runtime.caching&gt; 要素 (キャッシュ設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.runtime.caching> 要素"
+  - "キャッシュ [.NET Framework], 構成"
+  - "system.runtime.caching 要素"
+ms.assetid: 9b44daee-874a-4bd1-954e-83bf53565590
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# &lt;system.runtime.caching&gt; 要素 (キャッシュ設定)
+構成ファイル内の `memoryCache` エントリを使用して既定のメモリ内の <xref:System.Runtime.Caching.ObjectCache> の実装の構成を提供します。  
+  
+ \<configuration\>  
+\<system.runtime.caching\>  
+  
+## 構文  
+  
+```  
+<system.runtime.caching >  
+   <!-- child elements -->  
+</system.runtime.caching >  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ `None`  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<memoryCache\>](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)|<xref:System.Runtime.Caching.MemoryCache> クラスに基づくキャッシュを構成するために使用される要素を定義します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+ この名前空間のクラスは、ASP.NET のキャッシュ機能と同様のキャッシュ機能を使用する方法を提供しますが、`System.Web` アセンブリに依存しません。 詳細については、「[.NET Framework アプリケーションでのキャッシュ](../../../../../docs/framework/performance/caching-in-net-framework-applications.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Caching> 名前空間の出力キャッシュ機能と型は、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] の新機能です。  
+  
+## 使用例  
+ 次の例では、<xref:System.Runtime.Caching.MemoryCache> クラスを元にしたキャッシュの構成方法を紹介します。 この例では、メモリ キャッシュ用の `namedCaches` エントリのインスタンスの構成を方法を示します。 キャッシュの名前は、`name` 属性を "default" に設定することによって、既定のキャッシュ エントリ名に設定されます。  
+  
+ `cacheMemoryLimitMegabytes` 属性および `physicalMemoryPercentage` 属性はゼロに設定されます。 これらの属性をゼロに設定すると、<xref:System.Runtime.Caching.MemoryCache> の自動サイズ調整ヒューリスティックが既定で使用されることになります。 キャッシュの実装では、現在のメモリ負荷と絶対およびパーセントのメモリ制限を 2 分ごとに比較する必要があります。  
+  
+```  
+<configuration>  
+  <system.runtime.caching>  
+    <memoryCache>  
+      <namedCaches>  
+          <add name="default"   
+               cacheMemoryLimitMegabytes="0"   
+               physicalMemoryPercentage="0"  
+               pollingInterval="00:02:00" />  
+      </namedCaches>  
+    </memoryCache>  
+  </system.runtime.caching>  
+</configuration>  
+```  
+  
+## 参照  
+ [\<memoryCache\> 要素 \(キャッシュ設定\)](../../../../../docs/framework/configure-apps/file-schema/runtime/memorycache-element-cache-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md b/docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md
new file mode 100644
index 00000000000..eba82f1dcc4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/thread-useallcpugroups-element.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;Thread_UseAllCpuGroups&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d30fe7c5-8469-46e2-b804-e3eec7b24256
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# &lt;Thread_UseAllCpuGroups&gt; 要素
+ランタイムによって、すべての CPU グループにマネージ スレッドを分散するかどうかを指定します。  
+  
+## 構文  
+  
+```vb  
+<Thread_UseAllCpuGroups    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> ランタイムによって、すべての CPU グループにマネージ スレッドを分散するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ランタイムは、複数の CPU グループにマネージ スレッドを分散しません。  これは、既定の設定です。|  
+|`true`|コンピューターに複数の CPU グループがあり、[\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md) 要素が有効になっている場合、ランタイムは、複数の CPU グループにマネージ スレッドを分散します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ コンピューターに複数の CPU グループがある場合、この要素を有効にすると、ランタイムは、すべての CPU グループにマネージ スレッドを分散します。  この機能を使用するには、すべての CPU のグループにガベージ コレクションを拡張し、ヒープの作成時および調整時にすべてのコアを考慮する [\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md) 要素も有効にする必要があります。  [\<GCCpuGroup\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md) 要素を有効にするには、[\<gcServer\>](../../../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md) 要素も有効にする必要があります。  これらの要素が有効でない場合、`<Thread_UseAllCpuGroups>` 要素を有効にしても効力はありません。  
+  
+## 使用例  
+ 次の例は、複数の CPU グループのサポートを有効にする方法を示しています。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <Thread_UseAllCpuGroups enabled="true"/>  
+      <GCCpuGroup enabled="true"/>  
+      <gcServer enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<GCCpuGroup\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/gccpugroup-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md b/docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md
new file mode 100644
index 00000000000..1cd89d4af3d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md
@@ -0,0 +1,99 @@
+---
+title: "&lt;ThrowUnobservedTaskExceptions&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<ThrowUnobservedTaskExceptions> 要素"
+  - "ThrowUnobservedTaskExceptions 要素"
+ms.assetid: cea7e588-8b8d-48d2-9ad5-8feaf3642c18
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# &lt;ThrowUnobservedTaskExceptions&gt; 要素
+未処理の例外を実行中のプロセスを停止する必要があるかどうかを指定します。  
+  
+## 構文  
+  
+```vb  
+<ThrowUnobservedTaskExceptions  
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> 未処理の例外を実行中のプロセスを停止する必要があるかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|未処理の例外の実行中のプロセスを終了することはありません。  これは、既定の設定です。|  
+|`true`|未処理の例外の実行中のプロセスを終了します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+|||  
+  
+## 解説  
+ <xref:System.Threading.Tasks.Task> に関連付けられている例外が確認されていない場合、<xref:System.Threading.Tasks.Task.Wait%2A> 操作がない、親が接続されておらず、<xref:System.Threading.Tasks.Task.Exception%2A?displayProperty=fullName> のタスクの Exception プロパティは無視して見なされますに読み込まれません。  
+  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)]で、<xref:System.Threading.Tasks.Task> が無視された例外があるガベージ コレクションに既定で、ファイナライザーが例外をスローし、プロセスが終了します。  プロセスの終了がガベージ コレクションと終了のタイミングによって決まります。  
+  
+ 開発者がタスクに基づく非同期コードを記述できる [!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)] が変更された無視された例外に対してこの既定の動作を、を簡単にするには、  無視された例外は、<xref:System.Threading.Tasks.TaskScheduler.UnobservedTaskException> イベントを発生させますが既定で、プロセスは終了しません。  代わりに、例外がイベント ハンドラーが例外を確認するかどうかをイベントが発生させた後に関係なく、無視されます。  
+  
+ [!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)]のアプリケーション構成ファイルで例外をスローする可能性の [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] の動作を有効にするために [\<ThrowUnobservedTaskExceptions\> 要素](../../../../../docs/framework/configure-apps/file-schema/runtime/throwunobservedtaskexceptions-element.md) を使用できます。  
+  
+ また、次の 1 種類の例外の動作を指定する:  
+  
+-   環境変数 `COMPlus_ThrowUnobservedTaskExceptions` \(`set COMPlus_ThrowUnobservedTaskExceptions=1`\) に設定します。  
+  
+-   レジストリ ThrowUnobservedTaskExceptions DWORD 値を設定して \= HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework キーの 1。  
+  
+## 使用例  
+ 次の例では、アプリケーション構成ファイルを使用してタスクの例外をスローするようにする方法を示します。  
+  
+```  
+<configuration>   
+    <runtime>   
+        <ThrowUnobservedTaskExceptions enabled="true"/>   
+    </runtime>   
+</configuration>  
+  
+```  
+  
+## 使用例  
+ 無視された例外がタスクからスローされるかを次の例に示します。  コードは、解放されたプログラムとして正しく動作するために実行する必要があります。  
+  
+ [!code-csharp[ThrowUnobservedTaskExceptions#1](../../../../../samples/snippets/csharp/VS_Snippets_CLR/throwunobservedtaskexceptions/cs/program.cs#1)]
+ [!code-vb[ThrowUnobservedTaskExceptions#1](../../../../../samples/snippets/visualbasic/VS_Snippets_CLR/throwunobservedtaskexceptions/vb/program.vb#1)]  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/timespan-legacyformatmode-element.md b/docs/framework/configure-apps/file-schema/runtime/timespan-legacyformatmode-element.md
new file mode 100644
index 00000000000..2ef690db70d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/timespan-legacyformatmode-element.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;TimeSpan_LegacyFormatMode&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<TimeSpan_LegacyFormatMode> 要素"
+  - "TimeSpan_LegacyFormatMode 要素"
+ms.assetid: 865e7207-d050-4442-b574-57ea29d5e2d6
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;TimeSpan_LegacyFormatMode&gt; 要素
+<xref:System.TimeSpan?displayProperty=fullName> 値による書式設定操作のレガシ動作をランタイムで維持するかどうかを決定します。  
+  
+## 構文  
+  
+```  
+<TimeSpan_LegacyFormatMode    
+   enabled="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> <xref:System.TimeSpan?displayProperty=fullName> 値による書式設定のレガシ動作をランタイムで使用するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|書式設定のレガシ動作はランタイムで復元されません。|  
+|`true`|書式設定のレガシ動作がランタイムで復元されます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降の <xref:System.TimeSpan?displayProperty=fullName> 構造体は、<xref:System.IFormattable> インターフェイスを実装し、標準およびカスタム書式指定文字列を使用した書式設定操作をサポートするようになっています。  解析メソッドでサポート対象外の書式指定子または書式指定文字列が検出されると、<xref:System.FormatException> がスローされます。  
+  
+ 以前のバージョンの .NET Framework では、<xref:System.TimeSpan> 構造体は、<xref:System.IFormattable> を実装せず、書式指定文字列をサポートしていませんでした。  ただし、開発者の多くは、<xref:System.TimeSpan> が一連の書式指定文字列をサポートしていると誤って認識し、<xref:System.String.Format%2A?displayProperty=fullName> などのメソッドでの[複合書式指定の操作](../../../../../docs/standard/base-types/composite-formatting.md)に書式指定文字列を使用していました。  通常、型が <xref:System.IFormattable> を実装し、書式指定文字列をサポートしている場合、サポート対象外の書式指定文字列を使用して書式指定メソッドを呼び出すと、<xref:System.FormatException> がスローされます。  ただし、<xref:System.TimeSpan> は <xref:System.IFormattable> を実装しなかったため、ランタイムでは書式指定文字列が無視され、代わりに <xref:System.TimeSpan.ToString?displayProperty=fullName> メソッドが呼び出されていました。  つまり、書式設定操作で書式指定文字列を使用しても効果はありませんでしたが、<xref:System.FormatException> も発生しませんでした。  
+  
+ レガシ コードによって複合書式指定メソッドと無効な書式指定文字列が渡され、そのコードを再コンパイルできない場合、`<TimeSpan_LegacyFormatMode>` 要素を使用して <xref:System.TimeSpan> のレガシ動作を復元できます。  この要素の `enabled` 属性を `true` に設定すると、複合書式指定メソッドにより <xref:System.TimeSpan.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> ではなく、<xref:System.TimeSpan.ToString?displayProperty=fullName> が呼び出され、<xref:System.FormatException> はスローされません。  
+  
+## 使用例  
+ 次の例では、<xref:System.TimeSpan> オブジェクトをインスタンス化し、サポート対象外の標準書式指定文字列を使用して <xref:System.String.Format%28System.String%2CSystem.Object%29?displayProperty=fullName> メソッドでそのインスタンスの書式設定を試みています。  
+  
+ [!code-csharp[TimeSpan.BreakingChanges#1](../../../../../samples/snippets/csharp/VS_Snippets_CLR/timespan.breakingchanges/cs/legacyformatmode1.cs#1)]
+ [!code-vb[TimeSpan.BreakingChanges#1](../../../../../samples/snippets/visualbasic/VS_Snippets_CLR/timespan.breakingchanges/vb/legacyformatmode1.vb#1)]  
+  
+ [!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)] またはそれ以前のバージョンで例を実行すると、次のように出力されます。  
+  
+```  
+12:30:45  
+```  
+  
+ これは、出力と [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降のバージョンの例を実行すると大きく異なる:  
+  
+```  
+Invalid Format  
+```  
+  
+ ただし、例のディレクトリに次の構成ファイルを追加し、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降のバージョンの例を実行すると、出力は [!INCLUDE[net_v35_short](../../../../../includes/net-v35-short-md.md)]で例を実行したで生成されたデータと同じです。  
+  
+```  
+<?xml version ="1.0"?>  
+<configuration>  
+   <runtime>  
+      <TimeSpan_LegacyFormatMode enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md b/docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md
new file mode 100644
index 00000000000..265d7a00d5b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md
@@ -0,0 +1,110 @@
+---
+title: "&lt;UseRandomizedStringHashAlgorithm&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<UseRandomizedStringHashAlgorithm> 要素"
+  - "UseRandomizedStringHashAlgorithm 要素"
+ms.assetid: c08125d6-56cc-4b23-b482-813ff85dc630
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# &lt;UseRandomizedStringHashAlgorithm&gt; 要素
+共通言語ランタイムがアプリケーション ドメインごとに文字列のハッシュ コードを計算するかどうかを判定します。  
+  
+## 構文  
+  
+```  
+<UseRandomizedStringHashAlgorithm   
+   enabled=0|1 />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`enabled`|必須の属性です。<br /><br /> アプリケーション ドメインごとに文字列のハッシュ コードを計算するかどうかを指定します。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`0`|共通言語ランタイムは、アプリケーション ドメインごとに文字列のハッシュ コードを計算しません。1 つのアルゴリズムを使用して文字列のハッシュ コードを計算します。  これは、既定の設定です。|  
+|`1`|共通言語ランタイムは、アプリケーション ドメインごとに文字列のハッシュ コードを計算します。  異なるアプリケーション ドメインや異なるプロセスで同一の文字列のハッシュ コードは異なります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|ランタイム初期化オプションに関する情報を含んでいます。|  
+  
+## 解説  
+ 既定では、<xref:System.StringComparer> のクラスと <xref:System.String.GetHashCode%2A?displayProperty=fullName> のメソッドは、アプリケーション ドメイン間で一貫したハッシュ コードを生成する単一のハッシュ アルゴリズムを使用します。  これは、`<UseRandomizedStringHashAlgorithm>` 要素の `enabled` 属性を `0` に設定することと同じです。  これは [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] で使用されるハッシュ アルゴリズムです。  
+  
+ <xref:System.StringComparer> クラスと <xref:System.String.GetHashCode%2A?displayProperty=fullName> メソッドは、別のハッシュ アルゴリズムを使用してアプリケーション ドメインごとのハッシュ コードを計算することもできます。  その結果、同じ文字列のハッシュ コードが、アプリケーション ドメイン間で異なります。  これはオプトイン機能であり、この機能を利用するには、`<UseRandomizedStringHashAlgorithm>` 要素の `enabled` 属性を `1` に設定する必要があります。  
+  
+ ハッシュ テーブルの文字列検索は、通常 O\(1\) 操作です。  ただし、多くの競合が発生すると、検索は O\(n<sup>2</sup>\) 操作になることがあります。  特にハッシュ コードを計算するキーがユーザーによる入力データに基づいている場合、`<UseRandomizedStringHashAlgorithm>` 構成要素を使用して、アプリケーション ドメインごとにランダムなハッシュ アルゴリズムを生成でき、潜在的な競合の数を制限できます。  
+  
+## 使用例  
+ 次の例では、値が「This is a string.」であるプライベート文字列定数 `s` を含む `DisplayString` クラスを定義します。また、メソッドを実行しているアプリケーション ドメインの名前と共に文字列値とハッシュ コードを表示する `ShowStringHashCode` メソッドも含まれています。  
+  
+ [!code-csharp[System.String.GetHashCode#2](../../../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.String.GetHashCode/CS/perdomain.cs#2)]
+ [!code-vb[System.String.GetHashCode#2](../../../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.String.GetHashCode/VB/perdomain.vb#2)]  
+  
+ 構成ファイルを指定せずにこの例を実行すると、次のような出力が表示されます。  文字列のハッシュ コードが 2 つアプリケーション ドメインで同じであることに注意してください。  
+  
+```  
+  
+String 'This is a string.' in domain 'PerDomain.exe': 941BCEAC  
+String 'This is a string.' in domain 'NewDomain': 941BCEAC  
+  
+```  
+  
+ ただし、例のディレクトリに次の構成ファイルを追加して例を実行すると、同じ文字列のハッシュ コードがアプリケーション ドメインによって異なります。  
+  
+```  
+  
+<?xml version ="1.0"?>  
+<configuration>  
+   <runtime>  
+      <UseRandomizedStringHashAlgorithm enabled="1" />  
+   </runtime>  
+</configuration>  
+  
+```  
+  
+ 構成ファイルが存在する場合、次の出力が表示されます。  
+  
+```  
+  
+String 'This is a string.' in domain 'PerDomain.exe': 5435776D  
+String 'This is a string.' in domain 'NewDomain': 75CC8236  
+  
+```  
+  
+## 参照  
+ <xref:System.StringComparer.GetHashCode%2A?displayProperty=fullName>   
+ <xref:System.String.GetHashCode%2A?displayProperty=fullName>   
+ <xref:System.Object.GetHashCode%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md b/docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md
new file mode 100644
index 00000000000..d44d209e0c0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/runtime/usesmallinternalthreadstacks-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;UseSmallInternalThreadStacks&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<UseSmallInternalThreadStacks> 要素"
+  - "UseSmallInternalThreadStacks 要素"
+ms.assetid: 1e3f6ec0-1cac-4e1c-9c81-17d948ae5874
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# &lt;UseSmallInternalThreadStacks&gt; 要素
+共通言語ランタイム \(CLR: Common Language Runtime\) で内部的に使用する特定のスレッドを作成するときに、それらのスレッドに既定のスタック サイズを使用せずに、明示的なスタック サイズを指定してメモリ使用量を減らすことを要求します。  
+  
+## 構文  
+  
+```  
+<UseSmallInternalThreadStacks enabled="true|false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|enabled|必須の属性です。<br /><br /> CLR で内部的に使用する特定のスレッドを作成するときに、既定のスタック サイズではなく明示的なスタック サイズを使用することを要求するかどうかを指定します。  明示的なスタック サイズは、既定のスタック サイズの 1 MB よりも小さい値になります。|  
+  
+## enabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|true|明示的なスタック サイズを要求します。|  
+|false|既定のスタック サイズを使用します。  これは [!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] の既定値です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`runtime`|アセンブリのバインディングとガベージ コレクションに関する情報が含まれています。|  
+  
+## 解説  
+ この構成要素は、プロセスでの仮想メモリ使用量を減らすことを要求するために使用します。CLR で内部スレッドに使用する明示的なスタック サイズは、要求が受け入れられる場合、既定のサイズよりも小さくなります。  
+  
+> [!IMPORTANT]
+>  この構成要素は CLR に対する要求であり、絶対要件ではありません。  [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] では、この要求は x86 アーキテクチャについてのみ受け入れられます。  この要素は、CLR の将来のバージョンでは完全に無視されるか、選択した内部スレッドに対して常に使用される明示的なスタック サイズに置き換えられる可能性があります。  
+  
+ この構成要素を指定すると、要求が受け入れられる場合は仮想メモリ使用量を減らすことができる一方で、スタック サイズが小さくなるとスタック オーバーフローが発生する可能性が高くなるため、信頼性が低下します。  
+  
+## 使用例  
+ CLR で内部的に使用する特定のスレッドに明示的なスタック サイズを使用することを要求する方法を、次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <UseSmallInternalThreadStacks enabled="true" />  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [ランタイム設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/startup/TOC.md b/docs/framework/configure-apps/file-schema/startup/TOC.md
new file mode 100644
index 00000000000..c2a4d360039
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/startup/TOC.md
@@ -0,0 +1,4 @@
+# [<requiredRuntime> 要素](requiredruntime-element.md)
+# [<startup> 要素](startup-element.md)
+# [<supportedRuntime> 要素](supportedruntime-element.md)
+# [スタートアップ設定スキーマ](index.md)
diff --git a/docs/framework/configure-apps/file-schema/startup/index.md b/docs/framework/configure-apps/file-schema/startup/index.md
new file mode 100644
index 00000000000..2eb30f614e6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/startup/index.md
@@ -0,0 +1,39 @@
+---
+title: "スタートアップ設定スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成スキーマ [.NET Framework], スタートアップ設定"
+  - "スキーマ スタートアップ設定"
+  - "スタートアップ設定スキーマ"
+ms.assetid: 03de6972-442a-4648-9f3e-efa654e3b949
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# スタートアップ設定スキーマ
+スタートアップ設定で、アプリケーションを実行する共通言語ランタイムのバージョンが指定されます。  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<requiredRuntime\>](../../../../../docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md)|共通言語ランタイムのバージョン 1.0 だけがアプリケーションでサポートされることを指定します。  ランタイム バージョン 1.1 で作成されたアプリケーションは **\<supportedRuntime\>** 要素を使用する必要があります。|  
+|[\<supportedRuntime\>](../../../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)|アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。|  
+|[\<スタートアップ\>](../../../../../docs/framework/configure-apps/file-schema/startup/startup-element.md)|**\<requiredRuntime\>** と **\<supportedRuntime\>** 要素が含まれています。|  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<PaveOver\> Specifying Which Runtime Version to Use](http://msdn.microsoft.com/ja-jp/c376208d-980d-42b4-865b-fbe0d9cc97c2)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md b/docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md
new file mode 100644
index 00000000000..c8b3e008114
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;requiredRuntime&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#requiredRuntime"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/startup/requiredRuntime"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<requiredRuntime> 要素"
+  - "コンテナー タグ, <requiredRuntime> 要素"
+  - "requiredRuntime 要素"
+ms.assetid: 9fa1639e-beb8-43be-b7a4-12f7b229c34b
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;requiredRuntime&gt; 要素
+共通言語ランタイムのバージョン 1.0 だけがアプリケーションでサポートされることを指定します。  
+  
+## 構文  
+  
+```  
+  
+   <requiredRuntime    
+version="runtime version"  
+safemode="true|false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`version`|省略可能な属性。<br /><br /> このアプリケーションがサポートする .NET Framework のバージョンを指定する文字列値。  文字列値は、.NET Framework のインストール ルートの下にあるディレクトリの名前に一致する必要があります。  文字列値の内容は、解析されません。|  
+|`safemode`|省略可能な属性。<br /><br /> ランタイム スタートアップ コードが、レジストリを検索してランタイムのバージョンを判断するかどうかを指定します。|  
+  
+## safemode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|ランタイム スタートアップ コードはレジストリを検索します。  これが既定値です。|  
+|`true`|ランタイム スタートアップ コードはレジストリを検索しません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`startup`|`<requiredRuntime>` 要素を含みます。|  
+  
+## 解説  
+ ランタイムのバージョン 1.0 のみをサポートするようにビルドされたアプリケーションでは、`<requiredRuntime>` 要素を使用する必要があります。  ランタイムのバージョン 1.1 以降を使用してビルドされたアプリケーションでは、`<supportedRuntime>` 要素を使用する必要があります。  
+  
+> [!NOTE]
+>  [CorBindToRuntimeByCfg](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimebycfg-function.md) 関数を使用して構成ファイルを指定する場合は、すべてのバージョンのランタイムに `<requiredRuntime>` 要素を使用する必要があります。  [CorBindToRuntimeByCfg](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimebycfg-function.md) を使用すると、`<supportedRuntime>` 要素は無視されます。  
+  
+ `version` 属性文字列は、指定したバージョンの .NET Framework のインストール フォルダー名と一致する必要があります。  この文字列は解釈されません。  ランタイム スタートアップ コードで一致するフォルダーが見つからなかった場合、ランタイムは読み込まれません。スタートアップ コードはエラー メッセージを表示し、終了します。  
+  
+> [!NOTE]
+>  Microsoft Internet Explorer でホストされるアプリケーションのスタートアップ コードは、`<requiredRuntime>` 要素を無視します。  
+  
+## 使用例  
+ 構成ファイルでランタイムのバージョンを指定する例を示します。  
+  
+```  
+<configuration>  
+   <startup>  
+      <requiredRuntime version="v1.0.3705" safemode="true"/>  
+   </startup>  
+</configuration>  
+```  
+  
+## 参照  
+ [スタートアップ設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/startup/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<PaveOver\> Specifying Which Runtime Version to Use](http://msdn.microsoft.com/ja-jp/c376208d-980d-42b4-865b-fbe0d9cc97c2)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/startup/startup-element.md b/docs/framework/configure-apps/file-schema/startup/startup-element.md
new file mode 100644
index 00000000000..0ff6929b00a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/startup/startup-element.md
@@ -0,0 +1,105 @@
+---
+title: "&lt;startup&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/startup"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#startup"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<startup> 要素"
+  - "コンテナー タグ, <startup> 要素"
+  - "startup 要素"
+ms.assetid: 536acfd8-f827-452f-838a-e14fa3b87621
+caps.latest.revision: 19
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 19
+---
+# &lt;startup&gt; 要素
+共通言語ランタイムのスタートアップ情報を指定します。  
+  
+## 構文  
+  
+```  
+<startup useLegacyV2RuntimeActivationPolicy="true|false" >   
+</startup>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`useLegacyV2RuntimeActivationPolicy`|省略可能な属性。<br /><br /> [!INCLUDE[dnprdnext](../../../../../includes/dnprdnext-md.md)] のランタイムのアクティブ化ポリシーを有効にするか、[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] のアクティブ化ポリシーを使用するかを指定します。|  
+  
+## useLegacyV2RuntimeActivationPolicy 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`true`|選択されたランタイムで [!INCLUDE[dnprdnext](../../../../../includes/dnprdnext-md.md)] のランタイムのアクティブ化ポリシーを有効にし、ランタイムの上限を CLR バージョン 2.0 とするのではなく、レガシのランタイムのアクティブ化手法 \([CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md)など\) を、構成ファイルから選択されたランタイムにバインドするようにします。  これにより、構成ファイルから CLR バージョン 4 またはそれ以降が選択された場合、それ以前のバージョンの .NET Framework で作成された混合モード アセンブリは、選択された CLR バージョンで読み込まれます。  この値を設定すると、CLR バージョン 1.1 または CLR バージョン 2.0 が同じプロセスに読み込まれなくなり、インプロセスの side\-by\-side 機能は事実上無効になります。|  
+|`false`|[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] およびそれ以降の既定のアクティブ化ポリシーを使用し、レガシのランタイムのアクティブ化手法で CLR バージョン 1.1 または 2.0 をプロセスに読み込むことができるようにします。  この値を設定すると、.NET Framework 4 以降に読み込まれなく .NET Framework 4 以降でビルドされていない限り、混合モード アセンブリは行われません。  この値が既定値です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<requiredRuntime\>](../../../../../docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md)|共通言語ランタイムのバージョン 1.0 だけがアプリケーションでサポートされることを指定します。  ランタイムのバージョン 1.1 以降でビルドされたアプリケーションは **\<supportedRuntime\>** 要素を使用する必要があります。|  
+|[\<supportedRuntime\>](../../../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)|アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+ ランタイムのバージョン 1.1 以降を使用して構築されたすべてのアプリケーションでは、**\<supportedRuntime\>** 要素を使用する必要があります。  ランタイムのバージョン 1.0 をサポートするアプリケーションでは、**\<requiredRuntime\>** 要素を使用する必要があります。  
+  
+ Microsoft Internet Explorer でホストされるアプリケーションのスタートアップ コードは **\<startup\>** 要素およびその子要素は無視されます。  
+  
+## useLegacyV2RuntimeActivationPolicy 属性  
+ アプリケーションで [CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md)などのレガシ アクティブ化パスが使用されていて、これらのパスで CLR の以前のバージョンではなくバージョン 4 をアクティブ化する場合、または、アプリケーションは [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] でビルドされているが、以前のバージョンの .NET Framework でビルドされた混合モードのアセンブリに対する依存関係がある場合、この属性は便利です。  このようなシナリオでは、属性を `true` に設定します。  
+  
+> [!NOTE]
+>  属性を `true` に設定すると、CLR バージョン 1.1 または CLR バージョン 2.0 が同じプロセスに読み込まれなくなり、インプロセスの side\-by\-side 機能は事実上無効になります \(「[Side\-by\-Side Execution for COM Interop](http://msdn.microsoft.com/ja-jp/4302318c-3586-49bf-8620-b9a39cdf4a32)」を参照\)。  
+  
+## 使用例  
+ 構成ファイルでランタイムのバージョンを指定する例を示します。  
+  
+```  
+<!-- When used with version 1.0 of the .NET Framework runtime -->  
+<configuration>  
+   <startup>  
+      <requiredRuntime version="v1.0.3705" safemode="true"/>  
+   </startup>  
+</configuration>  
+<!-- When used with version 1.1 (or later) of the runtime -->  
+<configuration>  
+   <startup>  
+      <supportedRuntime version="v1.1.4322"/>  
+      <supportedRuntime version="v1.0.3705"/>  
+   </startup>  
+</configuration>  
+```  
+  
+## 参照  
+ [スタートアップ設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/startup/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<PaveOver\> Specifying Which Runtime Version to Use](http://msdn.microsoft.com/ja-jp/c376208d-980d-42b4-865b-fbe0d9cc97c2)   
+ [Side\-by\-Side Execution for COM Interop](http://msdn.microsoft.com/ja-jp/4302318c-3586-49bf-8620-b9a39cdf4a32)   
+ [インプロセスの side\-by\-side 実行](../../../../../docs/framework/deployment/in-process-side-by-side-execution.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md b/docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md
new file mode 100644
index 00000000000..4465f802cea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md
@@ -0,0 +1,135 @@
+---
+title: "&lt;supportedRuntime&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#supportedRuntime"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/startup/supportedRuntime"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<supportedRuntime> 要素"
+  - "supportedRuntime 要素"
+ms.assetid: 1ae16e23-afbe-4de4-b413-bc457f37b69f
+caps.latest.revision: 33
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 28
+---
+# &lt;supportedRuntime&gt; 要素
+アプリケーションでサポートされる共通言語ランタイムのバージョンを指定します。 バージョン 1.1 以降の .NET Framework で構築されたすべてのアプリケーションでは、この要素を使用する必要があります。  
+  
+ [\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<startup\>](../../../../../docs/framework/configure-apps/file-schema/startup/startup-element.md)  
+  
+ **\<supportedRuntime\>**  
+  
+## 構文  
+  
+```  
+  
+<supportedRuntime version="runtime version" sku="sku id"/>  
+```  
+  
+## 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|**version**|省略可能な属性です。<br /><br /> このアプリケーションがサポートする共通言語ランタイム \(CLR: Common Language Runtime\) のバージョンを指定する文字列値。`version` 属性の有効な値については、「["ランタイム バージョン" の値](#version)」セクションを参照してください。 **Note:**  .NET Framework 3.5 では、"*ランタイム バージョン*" の値は「*メジャー*.*マイナー*.*ビルド*」の形式になります。[!INCLUDE[net_v40_long](../../../../../includes/net-v40-long-md.md)] 以降では、必要となるのはメジャー バージョン番号とマイナー バージョン番号のみです \(つまり、"v4.0.30319" ではなく "v4.0"\)。 短い文字列を使用することをお勧めします。|  
+|**sku**|省略可能な属性です。<br /><br /> 在庫管理単位 \(SKU\) を指定する文字列の値。SKU はこのアプリケーションがサポートする .NET Framework リリースを指定します。<br /><br /> .NET Framework 4.0 以降では、`sku` 属性の使用が推奨されます。  この属性が指定される場合は、アプリケーションが対象とする .NET Framework のバージョンを示します。<br /><br /> SKU 属性の有効な値については、「["sku id" の値](#sku)」セクションを参照してください。|  
+  
+## 解説  
+ アプリケーション構成ファイルに **\<supportedRuntime\>** 要素がない場合は、アプリケーションの構築に使われたランタイムのバージョンが使用されます。  
+  
+ ランタイムのバージョン 1.1 以降を使用して構築されたすべてのアプリケーションでは、**\<supportedRuntime\>** 要素を使用する必要があります。 ランタイムのバージョン 1.0 をサポートするアプリケーションでは、[\<requiredRuntime\>](../../../../../docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md) 要素を使用する必要があります。  
+  
+> [!NOTE]
+>  [CorBindToRuntimeByCfg](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimebycfg-function.md) 関数を使用して構成ファイルを指定する場合は、すべてのバージョンのランタイムに `<requiredRuntime>` 要素を使用する必要があります。[CorBindToRuntimeByCfg](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimebycfg-function.md) を使用すると、`<supportedRuntime>` 要素は無視されます。  
+  
+ NET Framework 1.1 から 3.5 までのランタイムの複数のバージョンをサポートするアプリケーションでは、ランタイムの複数のバージョンをサポートする場合は、最初の要素で最も優先度の高いバージョンを指定し、最後の要素で最も優先度の低いバージョンを指定する必要があります。 .NET Framework 4.0 以降のバージョンをサポートするアプリケーションでは、`version` 属性は .NET Framework 4 以降のバージョンで共通の CLR バージョンを示します。`sku` 属性は、アプリケーションが対象とする単一の .NET Framework バージョンを示します。  
+  
+> [!NOTE]
+>  アプリケーションで [CorBindToRuntimeEx 関数](../../../../../ocs/framework/unmanaged-api/hosting/corbindtoruntimeex-function.md)などのレガシ アクティブ化パスが使用されていて、これらのパスで CLR の以前のバージョンではなくバージョン 4 をアクティブ化する場合、または、アプリケーションは [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] でビルドされているが、以前のバージョンの .NET Framework でビルドされた混合モードのアセンブリに対する依存関係がある場合、サポートされるランタイムの一覧で [!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] を指定するだけでは十分ではありません。 さらに、構成ファイル内の [\<startup\> 要素](../../../../../docs/framework/configure-apps/file-schema/startup/startup-element.md)で、`useLegacyV2RuntimeActivationPolicy` 属性を `true` に設定する必要があります。 ただし、この属性を `true` に設定することは、以前のバージョンの .NET Framework でビルドされたすべてのコンポーネントが、それらのビルドに使用されたランタイムではなく、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] を使用して実行されることを意味します。  
+  
+ アプリケーションは、そのアプリケーションを実行できる .NET Framework のすべてのバージョンでテストすることをお勧めします。  
+  
+<a name="version"></a>   
+## "ランタイム バージョン" の値  
+ 次の表は、`version` 属性の "*ランタイム バージョン*" に指定可能な値の一覧です。  
+  
+|.NET Framework のバージョン|`version` 属性|  
+|---------------------------|------------------|  
+|1.0|"v1.0.3705"|  
+|1.1|"v1.1.4322"|  
+|2.0|"v2.0.50727"|  
+|3.0|"v2.0.50727"|  
+|3.5|"v2.0.50727"|  
+|4.0|"v4.0"|  
+|4.5|"v4.0"|  
+|4.5.1|"v4.0"|  
+|4.5.2|"v4.0"|  
+|4.6|"v4.0"|  
+|4.6.1|"v4.0"|  
+  
+<a name="sku"></a>   
+## "sku id" の値  
+ 次の表は、`sku` 属性がサポートする .NET Framework 4 以降の .NET Framework のバージョンの一覧です。  .NET Framework 4 以降の `sku` 属性は、アプリケーションが対象とする .NET Framework のバージョンを示す点に注意してください。  
+  
+|.NET Framework のバージョン|`sku` 属性|  
+|---------------------------|--------------|  
+|4.0|".NETFramework,Version\=v4.0"|  
+|4.0、Client Profile|".NETFramework,Version\=v4.0,Profile\=Client"|  
+|4.0、プラットフォームの更新プログラム 1|.NETFramework,Version\=v4.0.1|  
+|4.0、Client Profile、更新プログラム 1|.NETFramework,Version\=v4.0.1,Profile\=Client|  
+|4.0、プラットフォームの更新プログラム 2|.NETFramework,Version\=v4.0.2|  
+|4.0、Client Profile、更新プログラム 2|.NETFramework,Version\=v4.0.2,Profile\=Client|  
+|4.0、プラットフォームの更新プログラム 3|.NETFramework,Version\=v4.0.3|  
+|4.0、Client Profile、更新プログラム 3|.NETFramework,Version\=v4.0.3,Profile\=Client|  
+|4.5|".NETFramework,Version\=v4.5"|  
+|4.5.1|".NETFramework,Version\=v4.5.1"|  
+|4.5.2|".NETFramework,Version\=v4.5.2"|  
+|4.6|".NETFramework,Version\=v4.6"|  
+|4.6.1|".NETFramework,Version\=v4.6.1"|  
+  
+ 次の表に、`version` 属性が v4.0 であり、`sku` 属性が NET Framework 4 またはそのプラットフォーム更新プログラム \(PU\) のいずれかを示す場合に、さまざまな `sku` 属性の値について、アプリケーションが実行されるインストール済みの .NET Framework 4 のバージョンを示します。  
+  
+|`sku` 属性の値|4.0 Client|4.0 Full|4.0 Client \+ PU 1|4.0 Full \+ PU 1|4.0 Client \+ PU 2|4.0 Full \+ PU 2|4.0 Client \+ PU 3|4.0 Full \+ PU 3|4.5 以降|  
+|----------------|----------------|--------------|------------------------|----------------------|------------------------|----------------------|------------------------|----------------------|------------|  
+|.NETFramework,Version\=v4.0,Profile\=Client|はい|はい|はい|はい|はい|はい|はい|はい|はい|  
+|.NETFramework,Version\=v4.0||はい||はい||はい||はい|はい|  
+|.NETFramework,Version\=v4.0.1,Profile\=Client|||はい|はい|はい|はい|はい|はい|はい|  
+|.NETFramework,Version\=v4.0.1||||はい||はい||はい|はい|  
+|.NETFramework,Version\=v4.0.2,Profile\=Client|||||はい|はい|はい|はい|はい|  
+|.NETFramework,Version\=v4.0.2||||||はい||はい|はい|  
+|.NETFramework,Version\=v4.0.3,Profile\=Client|||||||はい|はい|はい|  
+|.NETFramework,Version\=v4.0.3||||||||はい|はい|  
+  
+## 使用例  
+ サポートされているランタイムのバージョンを構成ファイルで指定する例を次に示します。 この構成ファイルは、アプリケーションが .NET Framework 4.6 を対象としていることを示します。  
+  
+```xml  
+  
+<configuration> <startup> <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.6" /> </startup> </configuration>  
+  
+```  
+  
+## 構成ファイル  
+ この要素は、アプリケーション構成ファイルで使用できます。  
+  
+## 参照  
+ [スタートアップ設定スキーマ](../../../../../docs/framework/configure-apps/file-schema/startup/index.md)   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<PaveOver\> 使用するランタイム バージョンの指定](http://msdn.microsoft.com/ja-jp/c376208d-980d-42b4-865b-fbe0d9cc97c2)   
+ [インプロセスの side\-by\-side 実行](../../../../../docs/framework/deployment/in-process-side-by-side-execution.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/TOC.md b/docs/framework/configure-apps/file-schema/trace-debug/TOC.md
new file mode 100644
index 00000000000..69898195b93
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/TOC.md
@@ -0,0 +1,22 @@
+# [<assert>](assert-element.md)
+# [<source>](source-element.md)
+# [<filter>](filter-element-for-add-for-listeners-for-trace.md)
+# [<sharedListeners>](sharedlisteners-element.md)
+# [<sources>](sources-element.md)
+# [<clear>](clear-element-for-listeners-for-trace.md)
+# [<performanceCounters>](performancecounters-element.md)
+# [<listeners>](listeners-element-for-source.md)
+# [<remove>](remove-element-for-listeners-for-trace.md)
+# [<add>](add-element-for-listeners-for-trace.md)
+# [<filter>](filter-element-for-add-for-sharedlisteners.md)
+# [<trace>](trace-element.md)
+# [<clear>](clear-element-for-listeners-for-source.md)
+# [<add>](add-element-for-switches.md)
+# [<switches>](switches-element.md)
+# [<add>](add-element-for-listeners-for-source.md)
+# [<remove>](remove-element-for-listeners-for-source.md)
+# [<system.diagnostics>](system-diagnostics-element.md)
+# [トレースおよびデバッグ設定のスキーマ](index.md)
+# [<add>](add-element-for-sharedlisteners.md)
+# [<filter>](filter-element-for-add-for-listeners-for-source.md)
+# [<listeners>](listeners-element-for-trace.md)
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-source.md b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-source.md
new file mode 100644
index 00000000000..29930c79866
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-source.md
@@ -0,0 +1,130 @@
+---
+title: "&lt;source&gt; の &lt;listeners&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source/listeners/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<source> の <listeners> の <add> 要素"
+  - "<source> の <listeners> の add 要素"
+  - "initializeData 属性"
+ms.assetid: 4ce36ac1-81ef-48e8-b8b2-b5a5b0e2adcb
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# &lt;source&gt; の &lt;listeners&gt; の &lt;add&gt; 要素
+トレース ソース用の `Listeners` コレクションにリスナーを追加します。  
+  
+## 構文  
+  
+```  
+<add name="name"   
+  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
+  initializeData="data"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`type`|必須の属性です。<br /><br /> リスナーの型を指定します。  「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」で指定されている要件を満たす文字列を使用する必要があります。|  
+|`initializeData`|省略可能な属性。<br /><br /> 指定したクラスのコンストラクターに渡す文字列。  文字列を受け取るコンストラクターがクラスにない場合は、<xref:System.Configuration.ConfigurationException> がスローされます。|  
+|`name`|省略可能な属性。<br /><br /> リスナーの名前を指定します。|  
+|`traceOutputOptions`|省略可能な属性。<br /><br /> トレース リスナーの <xref:System.Diagnostics.TraceListener.TraceOutputOptions%2A> プロパティ値を指定します。|  
+|\[カスタム属性\]|省略可能な属性です。<br /><br /> このリスナーの <xref:System.Diagnostics.TraceListener.GetSupportedAttributes%2A> メソッドで識別されるリスナー固有の属性の値を指定します。  <xref:System.Diagnostics.DelimitedListTraceListener.Delimiter%2A> は、<xref:System.Diagnostics.DelimitedListTraceListener> クラスに固有の追加属性の例です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-source.md)|トレース ソースの `Listeners` コレクション内のリスナーにフィルターを追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+|`source`|トレース メッセージを開始するトレース ソースを指定します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを指定します。|  
+  
+## 解説  
+ .NET Framework に付属のリスナー クラスは、<xref:System.Diagnostics.TraceListener> クラスの派生クラスです。  
+  
+ トレース リスナーの `name` 属性を指定しない場合は、トレース リスナーの <xref:System.Diagnostics.TraceListener.Name%2A> プロパティは、既定で空の文字列 \(""\) に設定されます。  アプリケーションにリスナーが 1 つしかない場合、名前を指定しなくてもリスナーを追加でき、名前に空の文字列を指定してリスナーを削除できます。  ただし、アプリケーションに複数のリスナーがある場合は、各トレース リスナーの一意の名前を指定する必要があります。これにより、<xref:System.Diagnostics.TraceSource.Listeners%2A?displayProperty=fullName> コレクション内の個別のトレース リスナーを識別および管理できます。  
+  
+> [!NOTE]
+>  同じ名前を持つ同じ型のトレース リスナーを複数追加すると、その型と名前を持つトレース リスナーが 1 つだけ `Listeners` コレクションに追加されます。  ただし、プログラムを使用すると、複数の同一のリスナーを `Listeners` コレクションに追加できます。  
+  
+ `initializeData` 属性の値は、作成するリスナーの型によって異なります。  `initializeData` を指定する必要のないトレース リスナーもあります。  
+  
+> [!NOTE]
+>  `initializeData` 属性を使用すると、"initializeData 属性は宣言されていません" というコンパイラの警告が表示される場合があります。この警告は、`initializeData` 属性を認識しない <xref:System.Diagnostics.TraceListener> 抽象基本クラスに対して構成設定が検証されたために発生します。  通常、パラメーターを受け取るコンストラクターのあるトレース リスナーの実装では、この警告を無視してもかまいません。  
+  
+ .NET Framework に付属するトレース リスナーを次の表に示し、各リスナーの `initializeData` 属性の値を説明します。  
+  
+|トレース リスナー クラス|initializeData 属性の値|  
+|-------------------|-------------------------|  
+|<xref:System.Diagnostics.ConsoleTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.ConsoleTraceListener.%23ctor%2A> コンストラクターの `useErrorStream` 値。`initializeData` 属性を "`true`" に設定すると、トレース出力とデバッグ出力を標準エラー出力ストリームに書き込みます。"`false`" に設定すると、標準出力ストリームに書き込みます。|  
+|<xref:System.Diagnostics.DelimitedListTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.DelimitedListTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.EventLogTraceListener?displayProperty=fullName>|既存のイベント ログ ソースの名前。|  
+|<xref:System.Diagnostics.EventSchemaTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.EventSchemaTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.TextWriterTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.TextWriterTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.XmlWriterTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.XmlWriterTraceListener> が出力を書き込むファイルの名前。|  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<add>` 要素を使用して、リスナー `console` および `textListener` をトレース リソース `TraceSourceApp` の `Listeners` コレクションに追加する方法を次の例に示します。  `textListener` リスナーは、トレース出力を myListener.log ファイルに書き込みます。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="TraceSourceApp" switchName="sourceSwitch"   
+        switchType="System.Diagnostics.SourceSwitch">  
+        <listeners>  
+          <add name="console"   
+            type="System.Diagnostics.ConsoleTraceListener"/>  
+          <add name="textListener"/>  
+          <remove name="Default"/>  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add name="textListener"   
+        type="System.Diagnostics.TextWriterTraceListener"   
+        initializeData="myListener.log"/>  
+    </sharedListeners>  
+    <switches>  
+      <add name="sourceSwitch" value="Warning"/>  
+    </switches>  
+  </system.diagnostics>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md
new file mode 100644
index 00000000000..161e8176b39
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md
@@ -0,0 +1,117 @@
+---
+title: "&lt;trace&gt; の &lt;listeners&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace/listeners/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<listeners> の <add> 要素"
+  - "<listeners> の add 要素"
+  - "initializeData 属性"
+ms.assetid: 81e804a3-ef11-4d39-bbde-bfa012c179e2
+caps.latest.revision: 24
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 22
+---
+# &lt;trace&gt; の &lt;listeners&gt; の &lt;add&gt; 要素
+**Listeners** コレクションにリスナーを追加します。  
+  
+## 構文  
+  
+```  
+<add name="name"   
+     type="trace listener class name, Version, Culture, PublicKeyToken"  
+     initializeData="data"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**type**|必須の属性です。<br /><br /> リスナーの型を指定します。  「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」に指定されている要件に合った文字列を使用する必要があります。|  
+|**initializeData**|省略可能な属性。<br /><br /> 指定したクラスのコンストラクターに渡す文字列。|  
+|**name**|省略可能な属性。<br /><br /> リスナーの名前を指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-trace.md)|トレース用の `Listeners` コレクションのリスナーにフィルターに追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを指定します。  リスナーは、トレース出力を適切なターゲットに転送します。|  
+|`system.diagnostics`|ASP.NET 構成セクションのルート要素を指定します。|  
+|`trace`|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+  
+## 解説  
+ <xref:System.Diagnostics.Debug> クラスおよび <xref:System.Diagnostics.Trace> クラスは、同じ **Listeners** コレクションを共有します。  これらのクラスの一方のコレクションにリスナー オブジェクトを追加すると、もう一方のクラスは同じリスナーを使用します。  リスナー クラスは、[TraceListener クラス](frlrfSystemDiagnosticsTraceListenerClassTopic)の派生クラスです。  
+  
+ トレース リスナーの `name` 属性を指定しない場合は、トレース リスナーの <xref:System.Diagnostics.TraceListener.Name%2A> は、既定で空の文字列 \(""\) に設定されます。  アプリケーションにリスナーが 1 つしかない場合、名前を指定しなくてもリスナーを追加でき、名前に空の文字列を指定してリスナーを削除できます。  ただし、アプリケーションに複数のリスナーがある場合は、各トレース リスナーの一意の名前を指定する必要があります。これにより、<xref:System.Diagnostics.Debug.Listeners%2A> および <xref:System.Diagnostics.Trace.Listeners%2A> コレクション内の個別のトレース リスナーを識別および管理できます。  
+  
+> [!NOTE]
+>  同じ名前を持つ同じ型のトレース リスナーを複数追加すると、その型と名前を持つトレース リスナーが 1 つだけ `Listeners` コレクションに追加されます。  ただし、プログラムを使用すると、複数の同一のリスナーを `Listeners` コレクションに追加できます。  
+  
+ **initializeData** 属性の値は、作成するリスナーの型によって異なります。  **initializeData** を指定する必要のないトレース リスナーもあります。  
+  
+> [!NOTE]
+>  `initializeData` 属性を使用すると、"initializeData 属性は宣言されていません" というコンパイラの警告が表示される場合があります。この警告は、`initializeData` 属性を認識しない <xref:System.Diagnostics.TraceListener> 抽象基本クラスに対して構成設定が検証されたために発生します。  通常、パラメーターを受け取るコンストラクターのあるトレース リスナーの実装では、この警告を無視してもかまいません。  
+  
+ .NET Framework に付属するトレース リスナーを次の表に示し、各リスナーの **initializeData** 属性の値を説明します。  
+  
+|トレース リスナー クラス|initializeData 属性の値|  
+|-------------------|-------------------------|  
+|<xref:System.Diagnostics.ConsoleTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.ConsoleTraceListener.%23ctor%2A> コンストラクターの `useErrorStream` 値。`initializeData` 属性を "`true`" に設定すると、トレースとデバッグの出力を <xref:System.Console.Error%2A?displayProperty=fullName> に書き込みます。"`false`" に設定すると、<xref:System.Console.Out%2A?displayProperty=fullName> に書き込みます。|  
+|<xref:System.Diagnostics.DelimitedListTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.DelimitedListTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.EventLogTraceListener?displayProperty=fullName>|既存のイベント ログ ソースの名前。|  
+|<xref:System.Diagnostics.EventSchemaTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.EventSchemaTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.TextWriterTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.TextWriterTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.XmlWriterTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.XmlWriterTraceListener> が出力を書き込むファイルの名前。|  
+  
+## 使用例  
+ 次の例に **リスナー** のコレクションにリスナーを追加するには `MyListener` と `MyEventListener`**\<追加\>** 要素を使用する方法を示します。  `MyListener` は、`MyListener.log` というファイルを作成し、そのファイルに出力を書き込みます。  `MyEventListener` は、イベント ログにエントリを作成します。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <trace autoflush="true" indentsize="0">  
+         <listeners>  
+            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
+            <add name="MyEventListener"  
+                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
+            <add name="configConsoleListener"  
+                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
+         </listeners>  
+      </trace>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.Debug>   
+ <xref:System.Diagnostics.EventLogTraceListener>   
+ <xref:System.Diagnostics.ConsoleTraceListener>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-sharedlisteners.md b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-sharedlisteners.md
new file mode 100644
index 00000000000..29d2115c796
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-sharedlisteners.md
@@ -0,0 +1,119 @@
+---
+title: "&lt;sharedListeners&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sharedListeners/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<sharedListeners> の <add> 要素"
+  - "<sharedListeners> の add 要素"
+  - "initializeData 属性"
+ms.assetid: 1595e1bc-2492-421f-8384-7f382eb8eb57
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;sharedListeners&gt; の &lt;add&gt; 要素
+`sharedListeners` コレクションにリスナーを追加します。  `sharedListeners` は、任意の [\<source\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/source-element.md) または [\<trace\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/trace-element.md) が参照できるリスナーのコレクションです。既定では、`sharedListeners` コレクションのリスナーは `Listeners` コレクションに配置されません。  これらは、[\<source\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/source-element.md) または [\<trace\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/trace-element.md) に名前で追加する必要があります。  実行時に、`sharedListeners` コレクションのリスナーをコードで取得することはできません。  
+  
+## 構文  
+  
+```  
+<add name="name"   
+  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
+  initializeData="data"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`name`|必須の属性です。<br /><br /> 共有リスナーを `Listeners` コレクションに追加するために使用されるリスナーの名前を指定します。|  
+|`type`|必須の属性です。<br /><br /> リスナーの型を指定します。  「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」で指定されている要件を満たす文字列を使用する必要があります。|  
+|`initializeData`|省略可能な属性。<br /><br /> 指定したクラスのコンストラクターに渡す文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-sharedlisteners.md)|フィルターを `sharedListeners` コレクションのリスナーに追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sharedListeners`|任意の source 要素または trace 要素が参照できるリスナーのコレクション。|  
+  
+## 解説  
+ .NET Framework に付属のリスナー クラスは、<xref:System.Diagnostics.TraceListener> クラスの派生クラスです。  `name` 属性の値は、トレースまたはトレース ソースの `Listeners` コレクションに共有リスナーを追加するために使用されます。  `initializeData` 属性の値は、作成するリスナーの型によって異なります。  `initializeData` を指定する必要のないトレース リスナーもあります。  
+  
+> [!NOTE]
+>  `initializeData` 属性を使用すると、"initializeData 属性は宣言されていません" というコンパイラの警告が表示される場合があります。この警告は、`initializeData` 属性を認識しない <xref:System.Diagnostics.TraceListener> 抽象基本クラスに対して構成設定が検証されたために発生します。  通常、パラメーターを受け取るコンストラクターのあるトレース リスナーの実装では、この警告を無視してもかまいません。  
+  
+ .NET Framework に付属するトレース リスナーを次の表に示し、各リスナーの `initializeData` 属性の値を説明します。  
+  
+|トレース リスナー クラス|initializeData 属性の値|  
+|-------------------|-------------------------|  
+|<xref:System.Diagnostics.ConsoleTraceListener>|<xref:System.Diagnostics.ConsoleTraceListener.%23ctor%2A> コンストラクターの `useErrorStream` 値。`initializeData` 属性を "`true`" に設定すると、トレース出力とデバッグ出力を標準エラー出力ストリームに書き込みます。"`false`" に設定すると、標準出力ストリームに書き込みます。|  
+|<xref:System.Diagnostics.DelimitedListTraceListener>|<xref:System.Diagnostics.DelimitedListTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.EventLogTraceListener?displayProperty=fullName>|既存のイベント ログ ソースの名前。|  
+|<xref:System.Diagnostics.EventSchemaTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.EventSchemaTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.TextWriterTraceListener?displayProperty=fullName>|<xref:System.Diagnostics.TextWriterTraceListener> が出力を書き込むファイルの名前。|  
+|<xref:System.Diagnostics.XmlWriterTraceListener>|<xref:System.Diagnostics.XmlWriterTraceListener> が出力を書き込むファイルの名前。|  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ 次の例に `sharedListeners` のコレクションに <xref:System.Diagnostics.TextWriterTraceListener>`textListener` を追加するには `<add>` 要素を使用する方法を示します。`textListener` にトレース ソース `TraceSourceApp`の `Listeners` のコレクションに名前で追加されます。  `textListener` リスナーは、トレース出力を myListener.log ファイルに書き込みます。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="TraceSourceApp" switchName="sourceSwitch"   
+        switchType="System.Diagnostics.SourceSwitch">  
+        <listeners>  
+          <add name="console"   
+            type="System.Diagnostics.ConsoleTraceListener"/>  
+          <add name="textListener"/>  
+          <remove name="Default"/>  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add name="textListener"   
+        type="System.Diagnostics.TextWriterTraceListener"   
+        initializeData="myListener.log"/>  
+    </sharedListeners>  
+    <switches>  
+      <add name="sourceSwitch" value="Warning"/>  
+    </switches>  
+  </system.diagnostics>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-switches.md b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-switches.md
new file mode 100644
index 00000000000..b6139aaf738
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/add-element-for-switches.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;switches&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/switches/add"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<switches> の <add> 要素"
+  - "<switches> の add 要素"
+ms.assetid: 712ac3a7-7abf-4a9e-8db4-acd241c2f369
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;switches&gt; の &lt;add&gt; 要素
+トレース スイッチを設定するレベルを指定します。  
+  
+## 構文  
+  
+```  
+<add name="switch name"  
+     value="value"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**name**|必須の属性です。<br /><br /> スイッチの名前を指定します。  この属性の値は、スイッチ コンストラクターに渡される *displayName* パラメーターと一致します。|  
+|**値**|必須の属性です。<br /><br /> スイッチのレベルを指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`switches`|トレース スイッチとトレース スイッチを設定するレベルを保持します。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+  
+## 解説  
+ トレース スイッチのレベルは、構成ファイル内に配置することにより変更できます。  スイッチが <xref:System.Diagnostics.BooleanSwitch> の場合は、スイッチのオン\/オフを切り替えることができます。  スイッチが <xref:System.Diagnostics.TraceSwitch> の場合は、スイッチにさまざまなレベルを割り当てて、アプリケーションが出力するトレース メッセージまたはデバッグ メッセージの型を指定できます。  
+  
+## 使用例  
+ 次の例に `General` トレースを設定するには **\<追加\>** 要素を使用する方法をに切り替え [TraceLevel.Error](frlrfSystemDiagnosticsTraceLevelClassTopic) レベルを有効にします `Data` ブール トレース スイッチを示します。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <switches>  
+         <add name="General" value="4" />  
+         <add name="Data" value="1" />  
+      </switches>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Switch>   
+ <xref:System.Diagnostics.TraceSwitch>   
+ <xref:System.Diagnostics.BooleanSwitch>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/assert-element.md b/docs/framework/configure-apps/file-schema/trace-debug/assert-element.md
new file mode 100644
index 00000000000..3a66e5188ae
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/assert-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;assert&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/assert"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#assert"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<assert> 要素"
+  - "assert 要素"
+ms.assetid: ef4c3229-b151-4d85-8091-e6456af9b935
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;assert&gt; 要素
+<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName> メソッドの呼び出し時にメッセージ ボックスを表示するかどうかを指定し、メッセージの書き込み先のファイルの名前も指定します。  
+  
+## 構文  
+  
+```  
+  
+<assert assertuienabled="true|false" logfilename="file name"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`assertuienabled`|省略可能な属性。<br /><br /> **Debug.Assert** メソッドが **false** になったときにメッセージ ボックスを表示するかどうかを指定します。|  
+|`logfilename`|省略可能な属性。<br /><br /> **Debug.Assert** が **false** になった場合のメッセージの書き込み先のファイルの名前を指定します。|  
+  
+## assertuienabled 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`true`|メッセージ ボックスを表示します。  これは、既定の設定です。|  
+|`false`|メッセージ ボックスを表示しません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+  
+## 解説  
+ **\<assert\>** 要素の属性は、両方とも省略可能です。  メッセージの書き込み先のファイルを指定せずにメッセージ ボックスを無効にするか、またはメッセージ ボックスを有効なままにして、メッセージの書き込み先のファイルを指定できます。  
+  
+## 使用例  
+ **Debug.Assert** の呼び出し時のメッセージ ボックス表示を無効にし、メッセージを `c:\log.txt` に書き込む方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <assert assertuienabled="false" logfilename="c:\log.txt"/>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Debug>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md b/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md
new file mode 100644
index 00000000000..689bf69da0b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md
@@ -0,0 +1,96 @@
+---
+title: "&lt;source&gt; の &lt;listeners&gt; の &lt;clear&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source/listeners/clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<source> の <listeners> の <clear> 要素"
+  - "<source> の <listeners> の clear 要素"
+ms.assetid: 76796bb2-9c0b-4526-8135-8bf18b16d8d9
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# &lt;source&gt; の &lt;listeners&gt; の &lt;clear&gt; 要素
+トレース ソースの `Listeners` コレクションを削除します。  
+  
+## 構文  
+  
+```  
+<clear/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+|`source`|トレース メッセージを開始するトレース ソースを指定します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを指定します。|  
+  
+## 解説  
+ `<clear>` 要素は、<xref:System.Diagnostics.DefaultTraceListener> を含め、トレース ソースの `Listeners` コレクションからすべてのリスナーを削除します。  `<add>` 要素を使用する前に、`<clear>` 要素を使用すると、コレクション内に他にアクティブなリスナーがないことを確認できます。  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<add>` 要素を使用してリスナー `console` と `textListener` をトレース ソース `TraceSourceApp` の `Listeners` コレクションに追加する前に、`<clear>` 要素を使用する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+       <source name="TraceSourceApp" switchName="sourceSwitch"   
+         switchType="System.Diagnostics.SourceSwitch">  
+        <listeners>  
+          <clear/>  
+          <add name="console"   
+            type="System.Diagnostics.ConsoleTraceListener"/>  
+          <add name="textListener"/>  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add name="textListener"   
+        type="System.Diagnostics.TextWriterTraceListener"   
+        initializeData="myListener.log"/>  
+    </sharedListeners>  
+    <switches>  
+      <add name="sourceSwitch" value="Warning"/>  
+    </switches>  
+  </system.diagnostics>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-trace.md b/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-trace.md
new file mode 100644
index 00000000000..c303cb0d5d6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-trace.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;trace&gt; の &lt;listeners&gt; の &lt;clear&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace/listeners/clear"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<trace> の <listeners> の <clear> 要素"
+  - "<trace> の <listeners> の clear 要素"
+ms.assetid: b44732a8-271f-4a06-ba9e-fe3298d6f192
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;trace&gt; の &lt;listeners&gt; の &lt;clear&gt; 要素
+トレースの `Listeners` コレクションを削除します。  
+  
+## 構文  
+  
+```  
+<clear/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`trace`|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを保持します。  リスナーは、トレース出力を適切なターゲットに転送します。|  
+  
+## 解説  
+ `<clear>` 要素は、トレースの `Listeners` コレクションからすべてのリスナーを削除します。  `<add>` 要素を使用する前に、`<clear>` 要素を使用すると、コレクション内に他にアクティブなリスナーがないことを確認できます。  
+  
+ <xref:System.Diagnostics.Trace.Listeners%2A?displayProperty=fullName> プロパティ \(`System.Diagnostics.Trace.Listeners.Clear()`\) で <xref:System.Diagnostics.TraceListenerCollection.Clear%2A> メソッドを呼び出すことにより、プログラムで `Listeners` コレクションを削除できます。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+> [!NOTE]
+>  `<clear>` 要素は、`Listeners` コレクションから <xref:System.Diagnostics.DefaultTraceListener> を削除することで、<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName>、<xref:System.Diagnostics.Trace.Assert%2A?displayProperty=fullName>、<xref:System.Diagnostics.Debug.Fail%2A?displayProperty=fullName>、および <xref:System.Diagnostics.Trace.Fail%2A?displayProperty=fullName> の各メソッドの動作を変更します。  `Assert` メソッドまたは `Fail` メソッドを呼び出すと、通常はメッセージ ボックスが表示されます。  ただし、`Listeners` コレクションに <xref:System.Diagnostics.DefaultTraceListener> がない場合は、メッセージ ボックスが表示されません。  
+  
+## 使用例  
+ `<add>` 要素を使用してリスナー `console` をトレースの `Listeners` コレクションに追加する前に、`<clear>` 要素を使用する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <trace autoflush="false" indentsize="4">  
+      <listeners>  
+        <clear/>  
+        <add name="console"   
+          type="System.Diagnostics.ConsoleTraceListener" >  
+          <filter type="System.Diagnostics.EventTypeFilter"   
+            initializeData="Error" />  
+        </add>  
+      </listeners>  
+    </trace>  
+  </system.diagnostics>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Trace.Listeners%2A>   
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.Debug>   
+ <xref:System.Diagnostics.TraceSource>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [\<remove\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-source.md b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-source.md
new file mode 100644
index 00000000000..287770d3659
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-source.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;source&gt; の &lt;listeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#filter"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source/listeners/add/filter"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<filter> 要素 (<source> の <listeners> の <add>)"
+  - "filter 要素 (<source> の <listeners> の <add>)"
+  - "initializeData 属性"
+ms.assetid: 15808b80-4579-4c25-b385-178cfdf154ba
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# &lt;source&gt; の &lt;listeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素
+トレース ソースの `Listeners` コレクション内のリスナーにフィルターを追加します。  
+  
+## 構文  
+  
+```  
+<filter   
+  type="traceFilterClassName"   
+  initializeData="data" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`type`|必須の属性です。<br /><br /> <xref:System.Diagnostics.TraceFilter> クラスを継承するフィルターの型を指定します。  指定する型の <xref:System.Type.FullName%2A> プロパティに対応する型の名前空間修飾名を使用するか、<xref:System.Type.AssemblyQualifiedName%2A> プロパティに対応する、アセンブリ情報を含む完全修飾型名を使用できます。  完全修飾型名については、「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」を参照してください。|  
+|`initializeData`|省略可能な属性。<br /><br /> 指定したフィルター クラスのコンストラクターに渡す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+|`source`|トレース メッセージを開始するトレース ソースを指定します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを保持します。  リスナーは、トレース出力を適切なターゲットに転送します。|  
+|`add`|トレース ソース用の `Listeners` コレクションにリスナーを追加します。|  
+  
+## 解説  
+ `<filter>` 要素は、[\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md) で定義されているリスナーの名前だけでなく、リスナーの型を指定するトレース ソース リスナーの `<add>` 要素に含まれている必要があります。  リスナーが [\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md) で定義されている場合は、そのリスナーのフィルターをその要素内で定義する必要があります。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<filter>` 要素を使用して、トレース ソース `myTraceSource` の `Listeners` コレクション内のリスナー `console` にフィルターを追加する方法を次の例に示します。フィルター イベント レベルは、`Error` として指定します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="myTraceSource" switchName="SourceSwitch"   
+        switchType="System.Diagnostics.SourceSwitch"  >  
+        <listeners>  
+          <add name="console"   
+            type="System.Diagnostics.ConsoleTraceListener" >  
+            <filter type="System.Diagnostics.EventTypeFilter"   
+              initializeData="Error" />  
+          </add>  
+          <remove name="Default" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <switches>  
+      <add name="SourceSwitch" value="Warning" />  
+    </switches>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.TraceListener.Filter%2A?displayProperty=fullName>   
+ <xref:System.Diagnostics.TraceFilter>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-trace.md b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-trace.md
new file mode 100644
index 00000000000..2b5fbb7e139
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-trace.md
@@ -0,0 +1,94 @@
+---
+title: "&lt;trace&gt; の &lt;listeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace/listeners/add/filter"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<filter> 要素 (<trace> の <listeners> の <add>)"
+  - "filter 要素 (<trace> の <listeners> の <add>)"
+  - "initializeData 属性"
+ms.assetid: eb9c18f5-dfa8-47c5-b91b-e4b93e76e1cc
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;trace&gt; の &lt;listeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素
+トレース用の `Listeners` コレクションのリスナーにフィルターに追加します。  
+  
+## 構文  
+  
+```  
+<filter   
+  type="traceFilterClassName"   
+  initializeData="data" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`type`|必須の属性です。<br /><br /> <xref:System.Diagnostics.TraceFilter> クラスを継承するフィルターの型を指定します。  指定する型の <xref:System.Type.FullName%2A> プロパティに対応する型の名前空間修飾名を使用するか、<xref:System.Type.AssemblyQualifiedName%2A> プロパティに対応する、アセンブリ情報を含む完全修飾型名を使用できます。  完全修飾型名については、「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」を参照してください。|  
+|`initializeData`|省略可能な属性。<br /><br /> 指定したフィルター クラスのコンストラクターに渡す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`trace`|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを保持します。  リスナーは、トレース出力を適切なターゲットに転送します。|  
+|`add`|`Listeners` コレクションにリスナーを追加します。|  
+  
+## 解説  
+ `<filter>` 要素は、[\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md) で定義されているリスナーの名前だけでなく、リスナーの型を指定するトレース リスナーの `<add>` 要素に含まれている必要があります。  リスナーが [\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md) で定義されている場合は、そのリスナーのフィルターをその要素内で定義する必要があります。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<filter>`  要素を使用して、トレースのための `Listeners` コレクション内のリスナー `console` にフィルターを追加する方法を次の例に示します。フィルター イベント レベルは、`Error` として指定します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <trace autoflush="false" indentsize="4">  
+      <listeners>  
+        <add name="console"   
+          type="System.Diagnostics.ConsoleTraceListener" >  
+          <filter type="System.Diagnostics.EventTypeFilter"   
+            initializeData="Error" />  
+        </add>  
+        <remove name="Default" />  
+      </listeners>  
+    </trace>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.TraceListener.Filter%2A?displayProperty=fullName>   
+ <xref:System.Diagnostics.TraceFilter>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-sharedlisteners.md b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-sharedlisteners.md
new file mode 100644
index 00000000000..2511e66ef96
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-sharedlisteners.md
@@ -0,0 +1,98 @@
+---
+title: "&lt;sharedListeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sharedListeners/add/filter"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<sharedListeners> の <add> の <filter> 要素"
+  - "<sharedListeners> の <add> の filter 要素"
+  - "フィルター, トレース リスナー"
+  - "initializeData 属性"
+  - "トレース リスナー, フィルター"
+ms.assetid: 7d4e7faa-2e4e-4379-ac76-f6cd7f2f8fac
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# &lt;sharedListeners&gt; の &lt;add&gt; の &lt;filter&gt; 要素
+フィルターを `sharedListeners` コレクションのリスナーに追加します。  
+  
+## 構文  
+  
+```  
+<filter type="System.Diagnostics.EventTypeFilter"   
+  initializeData="Warning" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**type**|必須の属性です。<br /><br /> フィルターの型を指定します。  型の完全名 \(<xref:System.Type.FullName%2A?displayProperty=fullName> プロパティの形式\) のみ使用できます。または、アセンブリ情報を含む完全修飾型名 \(<xref:System.Type.AssemblyQualifiedName%2A?displayProperty=fullName> プロパティの形式\) を使用することもできます。  完全修飾型名の作成の詳細については、「[完全修飾型名の指定](../../../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」を参照してください。|  
+|**initializeData**|省略可能な属性。<br /><br /> 指定したクラスのコンストラクターに渡す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sharedListeners`|任意の source 要素または trace 要素が参照できるリスナーのコレクション。|  
+|`add`|**sharedListeners** コレクションにリスナーを追加します。|  
+  
+## 解説  
+ リスナーが `<sharedListeners>` 要素の `<add>` 要素で定義されている場合、そのリスナーのフィルターは `<add>` 要素の子である `<filter>` 要素で定義する必要があります。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<filter>` 要素を使用してフィルターを `sharedListeners` コレクション内のトレース リスナー `console` に追加する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="myTraceSource" >  
+        <listeners>  
+          <add name="console" />  
+          <remove name="Default" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add name="console"   
+        type="System.Diagnostics.ConsoleTraceListener" >  
+        <filter type="System.Diagnostics.EventTypeFilter"   
+          initializeData="Error" />  
+      </add>  
+    </sharedListeners>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceFilter>   
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.TraceSource>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/index.md b/docs/framework/configure-apps/file-schema/trace-debug/index.md
new file mode 100644
index 00000000000..141521b0e36
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/index.md
@@ -0,0 +1,66 @@
+---
+title: "トレースおよびデバッグ設定のスキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "構成スキーマ [.NET Framework], トレースおよびデバッグの設定"
+  - "構成のセクション [.NET Framework]"
+  - "構成の設定 [.NET Framework], デバッグ"
+  - "構成の設定 [.NET Framework], トレース"
+  - "要素 [.NET Framework], トレースおよびデバッグの設定"
+  - "スキーマ構成の設定"
+  - "トレース リスナー, トレースおよびデバッグ設定のスキーマ"
+  - "トレース [.NET Framework], トレースおよびデバッグ設定のスキーマ"
+ms.assetid: 277ca5f6-e1c4-41b6-a47f-3a67ce5b94ac
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# トレースおよびデバッグ設定のスキーマ
+トレースおよびデバッグの設定により、メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。  
+  
+ 次の表に、トレース設定とデバッグ設定の各要素の機能を示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-source.md)|トレース ソース用の `Listeners` コレクションにリスナーを追加します。|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md)|`Listeners` コレクションにリスナーを追加します。|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-sharedlisteners.md)|`sharedListeners` コレクションにリスナーを追加します。|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-switches.md)|トレース スイッチを設定するレベルを指定します。|  
+|[\<assert\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/assert-element.md)|<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName> メソッドの呼び出し時にメッセージ ボックスを表示するかどうかを指定し、メッセージの書き込み先のファイルの名前も指定します。|  
+|[\<clear\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md)|トレース ソースの `Listeners` コレクションを削除します。|  
+|[\<clear\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-trace.md)|トレースの `Listeners` コレクションを削除します。|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-source.md)|トレース ソースの `Listeners` コレクション内のリスナーにフィルターを追加します。|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-listeners-for-trace.md)|トレース用の `Listeners` コレクションのリスナーにフィルターに追加します。|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/filter-element-for-add-for-sharedlisteners.md)|フィルターを `sharedListeners` コレクションのリスナーに追加します。|  
+|[\<listeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-source.md)|トレース ソースの `Listeners` コレクションにリスナーを指定します。|  
+|[\<listeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md)|トレースの `Listeners` コレクションにリスナーを指定します。|  
+|[\<performanceCounters\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/performancecounters-element.md)|パフォーマンス カウンターが共有するグローバル メモリのサイズを指定します。|  
+|[\<remove\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md)|トレースの `Listeners` コレクションからリスナーを削除します。|  
+|[\<remove\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-source.md)|トレース ソースの `Listeners` コレクションからリスナーを削除します。|  
+|[\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md)|任意の source 要素または trace 要素が参照できるリスナーを含みます。|  
+|[\<sources\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sources-element.md)|トレース メッセージを開始するトレース ソースを保持します。|  
+|[\<source\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/source-element.md)|トレース メッセージを開始するトレース ソースを指定します。|  
+|[\<switches\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/switches-element.md)|トレース スイッチとトレース スイッチを設定するレベルを保持します。|  
+|[\<system.diagnostics\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/system-diagnostics-element.md)|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|[\<trace\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/trace-element.md)|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+  
+## 参照  
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.Debug>   
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-source.md b/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-source.md
new file mode 100644
index 00000000000..06aac279cc4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-source.md
@@ -0,0 +1,99 @@
+---
+title: "&lt;source&gt; の &lt;listeners&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source/listeners"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<source> の <listeners> 要素"
+  - "<source> の listeners 要素"
+ms.assetid: a2991f43-b4d3-4614-a8e7-da392de9697f
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;source&gt; の &lt;listeners&gt; 要素
+<xref:System.Diagnostics.TraceSource> の <xref:System.Diagnostics.TraceSource.Listeners%2A> コレクションでリスナーを追加または削除します。  リスナーにより、トレース出力が適切な場所 \(ログ、ウィンドウ、またはテキスト ファイルなど\) に送られます。  
+  
+## 構文  
+  
+```  
+<listeners>   
+  <add>...</add>  
+  <remove ... />  
+  <clear/>  
+</listeners>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-source.md)|`Listeners` コレクションにリスナーを追加します。|  
+|[\<remove\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-source.md)|`Listeners` コレクションからリスナーを削除します。|  
+|[\<clear\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md)|トレース ソースの `Listeners` コレクションを削除します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+|`source`|トレース メッセージを開始するトレース ソースを指定します。|  
+  
+## 解説  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<listeners>` 要素を使用して、コンソール トレース リスナーを `mySource` ソースに追加し、既定のトレース リスナーを削除する例を次に示します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="mySource" switchName="sourceSwitch"   
+        switchType="System.Diagnostics.SourceSwitch">  
+        <listeners>  
+          <add name="console"   
+            type="System.Diagnostics.ConsoleTraceListener">  
+            <filter type="System.Diagnostics.EventTypeFilter"   
+              initializeData="Error"/>  
+          </add>  
+          <remove name="Default"/>  
+        </listeners>  
+      </source>  
+    </sources>  
+    <switches>  
+      <add name="sourceSwitch" value="Warning"/>  
+    </switches>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md b/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md
new file mode 100644
index 00000000000..44d19f74fe5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md
@@ -0,0 +1,96 @@
+---
+title: "&lt;trace&gt; の &lt;listeners&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace/listeners"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<listeners> 要素"
+  - "listeners 要素"
+ms.assetid: 1394c2c3-6304-46db-87c1-8e8b16f5ad5b
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# &lt;trace&gt; の &lt;listeners&gt; 要素
+メッセージを収集、格納、およびルーティングするリスナーを指定します。  リスナーは、トレース出力を適切なターゲットに転送します。  
+  
+## 構文  
+  
+```  
+<listeners>   
+  <add>...</add>  
+  <clear/>  
+  <remove ... />  
+</listeners>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md)|`Listeners` コレクションにリスナーを追加します。|  
+|[\<clear\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-trace.md)|トレースの `Listeners` コレクションを削除します。|  
+|[\<remove\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md)|`Listeners` コレクションからリスナーを削除します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|ASP.NET 構成セクションのルート要素を指定します。|  
+|`trace`|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+  
+## 解説  
+ <xref:System.Diagnostics.Debug> クラスおよび <xref:System.Diagnostics.Trace> クラスは、同じ **Listeners** コレクションを共有します。  これらのクラスの一方のコレクションにリスナー オブジェクトを追加すると、もう一方のクラスは同じリスナーを使用します。  .NET Framework に付属のリスナー クラスは、<xref:System.Diagnostics.TraceListener> クラスの派生クラスです。  
+  
+## 構成ファイル  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ 次の例に **リスナー** のコレクションにリスナーを追加するには `MyListener` と `MyEventListener`**\<listeners\>** 要素を使用する方法を示します。  `MyListener` は、`MyListener.log` というファイルを作成し、そのファイルに出力を書き込みます。  `MyEventListener` は、イベント ログにエントリを作成します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <trace autoflush="true" indentsize="0">  
+      <listeners>  
+        <add name="myListener"   
+          type="System.Diagnostics.TextWriterTraceListener,   
+            system, version=1.0.3300.0, Culture=neutral,   
+            PublicKeyToken=b77a5c561934e089"   
+          initializeData="c:\myListener.log" />  
+        <add name="MyEventListener"  
+          type="System.Diagnostics.EventLogTraceListener,   
+            system, version=1.0.3300.0, Culture=neutral,   
+            PublicKeyToken=b77a5c561934e089"  
+          initializeData="MyConfigEventLog"/>  
+      </listeners>  
+    </trace>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/performancecounters-element.md b/docs/framework/configure-apps/file-schema/trace-debug/performancecounters-element.md
new file mode 100644
index 00000000000..3f423bdebbf
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/performancecounters-element.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;performanceCounters&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/performanceCounters"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#performanceCounters"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<perfomanceCounters> 要素"
+  - "performanceCounters 要素"
+ms.assetid: a71f605b-c7d9-4501-a5c3-abcbb964a43f
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;performanceCounters&gt; 要素
+パフォーマンス カウンターが共有するグローバル メモリのサイズを指定します。  
+  
+## 構文  
+  
+```  
+<performanceCounters filemappingsize="524288" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|filemappingsize|必須の属性です。<br /><br /> パフォーマンス カウンターが共有するグローバル メモリのサイズをバイト単位で指定します。  既定値は 524288 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`Configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|ASP.NET 構成セクションのルート要素を指定します。|  
+  
+## 解説  
+ パフォーマンス カウンターは、メモリ マップト ファイル \(共有メモリ\) を使用してパフォーマンス データを公開します。共有メモリのサイズによって、一度に使用できるインスタンスの数が決まります。共有メモリには、グローバル共有メモリと個別共有メモリの 2 種類があります。グローバル共有メモリは、.NET Framework Version 1.0 または 1.1 と共にインストールされるすべてのパフォーマンス カウンター カテゴリで使用されます。.NET Framework Version 2.0 と共にインストールされるパフォーマンス カウンター カテゴリでは、個別共有メモリが使用されます。この場合、各パフォーマンス カウンター カテゴリが独自のメモリを持ちます。  
+  
+ グローバル共有メモリのサイズは、構成ファイル内でのみ設定できます。既定のサイズは 524,288 バイト、最大サイズは 33,554,432 バイト、最小サイズは 32,768 バイトです。グローバル共有メモリはすべてのプロセスおよびカテゴリで共有されるため、最初の作成者がサイズを指定します。アプリケーション構成ファイルにサイズを定義すると、指定したサイズは、そのアプリケーションが最初にパフォーマンス カウンターを実行する場合にのみ使用されます。したがって、`filemappingsize` 値は、Machine.config ファイルで指定する必要があります。グローバル共有メモリ内のメモリはパフォーマンス カウンターごとに解放できないため、異なる名前を使用してパフォーマンス カウンターのインスタンスを大量に作成すると、最終的にはグローバル共有メモリを使い果たすことになります。  
+  
+ 個別共有メモリのサイズは、レジストリ キーの HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\*\<category name\>*\\Performance の DWORD FileMappingSize の値は、構成ファイル内のグローバル共有メモリに指定した値によって、その後に最初に参照されます。  FileMappingSize の値が存在しない場合、個別共有メモリのサイズは、構成ファイル内のグローバル設定の値の 4 分の 1 に設定されます。  
+  
+## 参照  
+ <xref:System.Diagnostics.PerformanceCounter>   
+ <xref:System.Diagnostics.PerformanceCounterCategory>   
+ <xref:System.Diagnostics.PerformanceCounter.InstanceLifetime%2A>   
+ <xref:System.Diagnostics.PerformanceCounterInstanceLifetime>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-source.md b/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-source.md
new file mode 100644
index 00000000000..e8c34157941
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-source.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;source&gt; の &lt;listeners&gt; の &lt;remove&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source/listeners/remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<source> の <listeners> の <remove> 要素"
+  - "<source> の <listeners> の remove 要素"
+ms.assetid: 3ff6b578-273d-407f-b07f-8251f1f9f5d0
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# &lt;source&gt; の &lt;listeners&gt; の &lt;remove&gt; 要素
+トレース ソースの `Listeners` コレクションからリスナーを削除します。  
+  
+## 構文  
+  
+```  
+<remove name="listenerName" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`name`|必須の属性です。<br /><br /> `Listeners` コレクションから削除するリスナーの名前。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+|`source`|トレース メッセージを開始するトレース ソースを指定します。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを指定します。|  
+  
+## 解説  
+ `<remove>` 要素は、トレース ソースの `Listeners` コレクションから指定したリスナーを削除します。  
+  
+ <xref:System.Diagnostics.TraceSource> インスタンスの <xref:System.Diagnostics.TraceSource.Listeners%2A> プロパティで <xref:System.Diagnostics.TraceListenerCollection.Remove%2A> メソッドを呼び出すことによって、トレース ソースの `Listeners` コレクションから要素をプログラムで削除できます。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<add>` 要素を使用してリスナー `console` をトレース ソース `TraceSourceApp` の `Listeners` コレクションに追加する前に、`<remove>` 要素を使用する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="TraceSourceApp" switchName="sourceSwitch"   
+         switchType="System.Diagnostics.SourceSwitch" >  
+         <listeners>  
+           <remove name="Default"/>  
+           <add name="console"   
+             type="System.Diagnostics.ConsoleTraceListener" />  
+         </listeners>  
+      </source>  
+    </sources>  
+  </system.diagnostics>  
+</configuration>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource.Listeners%2A>   
+ <xref:System.Diagnostics.TraceSource>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [\<clear\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/clear-element-for-listeners-for-source.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md b/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md
new file mode 100644
index 00000000000..6bb86813793
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/remove-element-for-listeners-for-trace.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;trace&gt; の &lt;listeners&gt; の &lt;remove&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace/listeners/remove"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<remove> 要素"
+  - "remove 要素"
+ms.assetid: 9a5cd1b5-be1a-485f-8f0c-2890ad3ef3e0
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# &lt;trace&gt; の &lt;listeners&gt; の &lt;remove&gt; 要素
+**Listeners** コレクションからリスナーを削除します。  
+  
+## 構文  
+  
+```  
+  
+<remove name="listener name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|**name**|必須の属性です。<br /><br /> **Listeners** コレクションから削除するリスナーの名前。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`listeners`|メッセージを収集、格納、およびルーティングするリスナーを指定します。  リスナーは、トレース出力を適切なターゲットに転送します。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`trace`|ASP.NET トレース サービスを設定します。|  
+  
+## 解説  
+  
+> [!NOTE]
+>  `Listeners` コレクションから <xref:System.Diagnostics.DefaultTraceListener> を削除すると、<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName>、<xref:System.Diagnostics.Trace.Assert%2A?displayProperty=fullName>、<xref:System.Diagnostics.Debug.Fail%2A?displayProperty=fullName>、および <xref:System.Diagnostics.Trace.Fail%2A?displayProperty=fullName> の各メソッドの動作が変わります。  `Assert` メソッドまたは `Fail` メソッドを呼び出すと、通常はメッセージ ボックスが表示されますが、`Listeners` コレクションに <xref:System.Diagnostics.DefaultTraceListener> がない場合はメッセージ ボックスが表示されません。  
+  
+## 使用例  
+ トレース **Listeners** コレクションから既定のトレース リスナーを削除する方法を次の例に示します。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <trace autoflush="true" indentsize="0">  
+         <listeners>  
+            <remove name="Default" />  
+         </listeners>  
+      </trace>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.DefaultTraceListener>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.EventLogTraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md b/docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md
new file mode 100644
index 00000000000..33f27beda20
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;sharedListeners&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#sharedListeners"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sharedListeners"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<sharedListeners> 要素"
+  - "リスナー"
+  - "共有リスナー"
+  - "sharedListeners 要素"
+  - "トレース リスナー, <sharedListeners> 要素"
+ms.assetid: de200534-19dd-4156-86cf-c50521802c4c
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# &lt;sharedListeners&gt; 要素
+任意の source 要素または trace 要素が参照できるリスナーを含みます。既定では、これらのリスナーはトレースを受け取りません。また、実行時にこれらのリスナーを取得することはできません。  共有リスナーとして識別されたリスナーは、ソースまたはトレースに名前で追加できます。  
+  
+## 構文  
+  
+```  
+<sharedListeners>   
+  <add>...</add>  
+</sharedListeners>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-listeners-for-trace.md)|`sharedListeners` コレクションにリスナーを追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`Configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|ASP.NET 構成セクションのルート要素を指定します。|  
+  
+## 解説  
+ リスナーを共有リスナーのコレクションに追加しても、アクティブなリスナーにはなりません。  リスナーをさらにその trace 要素の `Listeners` コレクションに追加することによって、トレース ソースまたはトレースに追加する必要があります。  .NET Framework のリスナー クラスは、<xref:System.Diagnostics.TraceListener> クラスの派生クラスです。  
+  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<sharedListeners>` 要素を使用して、リスナー `console` を<xref:System.Diagnostics.TraceSource> クラスと <xref:System.Diagnostics.Trace> クラスの `Listeners` コレクションに追加する方法を次の例に示します。  コンソール トレース リスナーは、<xref:System.Diagnostics.TraceSource> または <xref:System.Diagnostics.Trace> の呼び出しを通じて、トレース情報をコンソールに書き込みます。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sharedListeners>  
+      <add name="console" type="System.Diagnostics.ConsoleTraceListener" >  
+        <filter type="System.Diagnostics.EventTypeFilter"  
+          initializeData="Warning" />  
+      </add>  
+    </sharedListeners>  
+    <sources>  
+      <source name="mySource" switchName="sourceSwitch"  >  
+        <listeners>  
+          <add name="console" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <switches>  
+      <add name="sourceSwitch" value="Verbose"/>  
+    </switches>  
+    <trace>  
+      <listeners>  
+        <add name="console" />  
+      </listeners>  
+    </trace>  
+  </system.diagnostics>  
+</configuration></system.diagnostics>   
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Listeners](../../../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/source-element.md b/docs/framework/configure-apps/file-schema/trace-debug/source-element.md
new file mode 100644
index 00000000000..fbd0e85242e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/source-element.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;source&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources/source"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#source"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<source> 要素"
+  - "source 要素"
+ms.assetid: ecf86505-735d-4844-aaba-266fdd134218
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# &lt;source&gt; 要素
+トレース メッセージを開始するトレース ソースを指定します。  
+  
+## 構文  
+  
+```  
+<source>   
+  <listeners>...</listeners>  
+</source>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`name`|省略可能な属性。<br /><br /> トレース ソースの名前を指定します。|  
+|`switchName`|省略可能な属性。<br /><br /> アプリケーション内のトレース スイッチ インスタンスの名前を指定します。  スイッチが `<switches>` 要素で識別されていない場合、値はスイッチのレベルを指定します。|  
+|`switchType`|省略可能な属性。<br /><br /> トレース スイッチの型を指定します。  型が存在する場合、その型は有効なクラス名である必要があり、空の文字列にはできません。|  
+|`extraAttribute`|省略可能な属性。<br /><br /> トレース ソースの <xref:System.Diagnostics.TraceSource.GetSupportedAttributes%2A> メソッドによって識別されるそのトレース ソース固有の属性の値を指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<listeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md)|メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+|`sources`|トレース メッセージを開始するトレース ソースを保持します。|  
+  
+## 解説  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<source>`  要素を使用してトレース ソース `mySource` を追加し、`sourceSwitch` という名前のソース スイッチのレベルを設定する方法を次の例に示します。  トレース情報をコンソールに書き込むコンソール トレース リスナーが追加されます。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="mySource" switchName="sourceSwitch" switchType="System.Diagnostics.SourceSwitch"  >  
+        <listeners>  
+          <add name="console" type="System.Diagnostics.ConsoleTraceListener" >  
+            <filter type="System.Diagnostics.EventTypeFilter" initializeData="Error" />  
+          </add>  
+          <remove name="Default" />  
+        </listeners>  
+      </source>  
+    </sources>  
+        <switches>  
+           <add name="sourceSwitch" value="Warning" />  
+        </switches>    
+  </system.diagnostics>   
+</configuration>  
+```  
+  
+## 参照  
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [Trace Switches](../../../../../docs/framework/debug-trace-profile/trace-switches.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/sources-element.md b/docs/framework/configure-apps/file-schema/trace-debug/sources-element.md
new file mode 100644
index 00000000000..5487f151257
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/sources-element.md
@@ -0,0 +1,98 @@
+---
+title: "&lt;sources&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/sources"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#sources"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<sources> 要素"
+  - "sources 要素"
+  - "トレース ソース"
+ms.assetid: c727b2e2-423a-4463-a223-013f40ff16a3
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# &lt;sources&gt; 要素
+トレース メッセージを開始するトレース ソースを指定します。  
+  
+## 構文  
+  
+```  
+<sources>  
+   <source>...</source>  
+</sources>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<source\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/source-element.md)|必須の要素です。<br /><br /> トレース メッセージを開始するトレース ソースを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+  
+## 解説  
+ この要素は、マシン構成ファイル \(Machine.config\) およびアプリケーション構成ファイルで使用できます。  
+  
+## 使用例  
+ `<sources>`  要素を使用してトレース ソース `mySource` を追加し、`sourceSwitch` という名前のソース スイッチのレベルを設定する方法を次の例に示します。  トレース情報をコンソールに書き込むコンソール トレース リスナーが追加されます。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <sources>  
+         <source name="mySource" switchName="sourceSwitch"   
+            switchType="System.Diagnostics.SourceSwitch"  >  
+            <listeners>  
+               <add name="console"   
+                  type="System.Diagnostics.ConsoleTraceListener" >  
+                  <filter type="System.Diagnostics.EventTypeFilter"   
+                     initializeData="Error" />  
+               </add>  
+               <remove name="Default" />  
+            </listeners>  
+         </source>  
+      </sources>  
+      <switches>  
+         <add name="sourceSwitch" value="Warning" />  
+      </switches>    
+   </system.diagnostics>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.DefaultTraceListener>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.ConsoleTraceListener>   
+ <xref:System.Diagnostics.EventLogTraceListener>   
+ <xref:System.Diagnostics.XmlWriterTraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)   
+ [\<source\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/source-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/switches-element.md b/docs/framework/configure-apps/file-schema/trace-debug/switches-element.md
new file mode 100644
index 00000000000..3333cd0753d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/switches-element.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;switches&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/switches"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#switches"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<switches> 要素"
+  - "switches 要素"
+  - "トレース スイッチ, <switches> 要素"
+ms.assetid: 4cf36786-b89a-40e2-a0f1-86bb9b783343
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;switches&gt; 要素
+トレース スイッチとトレース スイッチを設定するレベルを保持します。  
+  
+## 構文  
+  
+```  
+  
+      <switches>   
+</switches>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/add-element-for-switches.md)|トレース スイッチを設定するレベルを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`System.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+  
+## 解説  
+ トレース スイッチのレベルは、構成ファイル内に配置することにより変更できます。  スイッチが <xref:System.Diagnostics.BooleanSwitch> の場合は、スイッチのオン\/オフを切り替えることができます。  スイッチが <xref:System.Diagnostics.TraceSwitch> の場合は、スイッチにさまざまなレベルを割り当てて、アプリケーションが出力するトレース メッセージまたはデバッグ メッセージの型を指定できます。  
+  
+## 使用例  
+ 次の例は、`General` トレースを設定するには **\<switch\>** 要素を使用する方法を [TraceLevel.Error](frlrfSystemDiagnosticsTraceLevelClassTopic) のレベルをに切り替え、`Data` ブール トレース スイッチを有効にします。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <switches>  
+         <add name="General" value="4" />  
+         <add name="Data" value="1" />  
+      </switches>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Switch>   
+ <xref:System.Diagnostics.TraceSwitch>   
+ <xref:System.Diagnostics.BooleanSwitch>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/system-diagnostics-element.md b/docs/framework/configure-apps/file-schema/trace-debug/system-diagnostics-element.md
new file mode 100644
index 00000000000..e4593cca70f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/system-diagnostics-element.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;system.diagnostics&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#system.diagnostics"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.diagnostics> 要素"
+  - "system.diagnostics 要素"
+ms.assetid: 3f348f42-fa72-4ff2-aa1c-bb9eecad4bb2
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# &lt;system.diagnostics&gt; 要素
+メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。  
+  
+## 構文  
+  
+```  
+<system.diagnostics>   
+</system.diagnostics>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<アサート\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/assert-element.md)|<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName> メソッドの呼び出し時にメッセージ ボックスを表示するかどうかを指定し、メッセージの書き込み先のファイルの名前も指定します。|  
+|[\<performanceCounters\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/performancecounters-element.md)|パフォーマンス カウンターが共有するグローバル メモリのサイズを指定します。|  
+|[\<sharedListeners\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sharedlisteners-element.md)|任意の source 要素または trace 要素が参照できるリスナーを含みます。  共有リスナーとして識別されたリスナーは、ソースまたはトレースに名前で追加できます。|  
+|[\<ソース\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/sources-element.md)|トレース メッセージを開始するトレース ソースを指定します。|  
+|[\<スイッチ\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/switches-element.md)|トレース スイッチとトレース スイッチを設定するレベルを保持します。|  
+|[\<trace\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/trace-element.md)|トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 使用例  
+ 次の例 **\<system.diagnostics\>** 要素内のトレース スイッチおよびトレース リスナーを埋め込む方法について説明します。  `General` トレース スイッチは、[TraceLevel.Error](frlrfSystemDiagnosticsTraceLevelClassTopic) レベルに設定されています。  トレース リスナー `myListener` は、`MyListener.log` というファイルを作成し、そのファイルに出力を書き込みます。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では、テキストを使用してスイッチの値を指定できます。  たとえば、<xref:System.Diagnostics.BooleanSwitch> に `true` を指定したり、`Error` などの列挙値を表すテキストを <xref:System.Diagnostics.TraceSwitch> に使用したりできます。  `<add name="myTraceSwitch" value="Error" />` 行は、`<add name="myTraceSwitch" value="1" />` に相当します。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <switches>  
+         <add name="General" value="4" />  
+      </switches>  
+      <trace autoflush="true" indentsize="2">  
+         <listeners>  
+            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
+         </listeners>  
+      </trace>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.Debug>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/trace-debug/trace-element.md b/docs/framework/configure-apps/file-schema/trace-debug/trace-element.md
new file mode 100644
index 00000000000..149d553cc7f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/trace-debug/trace-element.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;trace&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.diagnostics/trace"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#trace"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<trace> 要素"
+  - "リスナー"
+  - "trace 要素"
+  - "トレース リスナー, <trace> 要素"
+ms.assetid: 7931c942-63c1-47c3-a045-9d9de3cacdbf
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# &lt;trace&gt; 要素
+トレース メッセージを収集、格納、およびルーティングするリスナーを保持します。  
+  
+## 構文  
+  
+```  
+<trace autoflush="true|false"   
+       indentsize="indent value"  
+       useGlobalLock="true| false"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`autoflush`|省略可能な属性。<br /><br /> トレース リスナーが毎回の書き込み操作の後で出力バッファーを自動的にフラッシュするかどうかを指定します。|  
+|`indentsize`|省略可能な属性。<br /><br /> インデントするスペース数を指定します。|  
+|`useGlobalLock`|省略可能な属性。<br /><br /> グローバル ロックを使用する必要があるかどうかを示します。|  
+  
+## autoflush 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|出力バッファーを自動的にフラッシュしません。  これは、既定の設定です。|  
+|`true`|出力バッファーを自動的にフラッシュします。|  
+  
+## useGlobalLock 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`false`|リスナーがスレッド セーフである場合は、グローバル ロックを使用しません。それ以外の場合は、グローバル ロックを使用します。|  
+|`true`|リスナーがスレッド セーフかどうかにかかわらず、グローバル ロックを使用します。  これは、既定の設定です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<リスナー\>](../../../../../docs/framework/configure-apps/file-schema/trace-debug/listeners-element-for-trace.md)|メッセージを収集、格納、およびルーティングするリスナーを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`configuration`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+|`system.diagnostics`|メッセージを収集、格納、およびルーティングするトレース リスナーとトレース スイッチを設定するレベルを指定します。|  
+  
+## 使用例  
+ `<trace>` 要素を使用して、リスナー `MyListener` を `Listeners` コレクションに追加する方法を次の例に示します。  `MyListener` は、`MyListener.log` というファイルを作成し、そのファイルに出力を書き込みます。  `useGlobalLock` 属性には `false` を設定します。これにより、トレース リスナーがスレッド セーフの場合は、グローバル ロックが使用されなくなります。  `autoflush` 属性には `true` を設定します。これにより、<xref:System.Diagnostics.Trace.Flush%2A?displayProperty=fullName> メソッドが呼び出されるかどうかに関係なく、トレース リスナーからファイルに出力が書き込まれます。  `indentsize` 属性には 0 \(ゼロ\) を設定します。これにより、<xref:System.Diagnostics.Trace.Indent%2A?displayProperty=fullName> メソッドが呼び出されたときに、リスナーは 0 個のスペースをインデントします。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <trace useGlobalLock="false" autoflush="true" indentsize="0">  
+         <listeners>  
+            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
+         </listeners>  
+      </trace>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceListener>   
+ <xref:System.Diagnostics.DefaultTraceListener>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.EventLogTraceListener>   
+ [トレースおよびデバッグ設定のスキーマ](../../../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf-directive/TOC.md b/docs/framework/configure-apps/file-schema/wcf-directive/TOC.md
new file mode 100644
index 00000000000..0b755b0097d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf-directive/TOC.md
@@ -0,0 +1,2 @@
+# [WCF ディレクティブ構文](index.md)
+# [@ServiceHost](servicehost.md)
diff --git a/docs/framework/configure-apps/file-schema/wcf-directive/index.md b/docs/framework/configure-apps/file-schema/wcf-directive/index.md
new file mode 100644
index 00000000000..3e0ed984790
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf-directive/index.md
@@ -0,0 +1,36 @@
+---
+title: "WCF ディレクティブ構文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e471b042-d5e3-491c-bc81-758655016a3a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF ディレクティブ構文
+コンパイラに指示するために .svc ファイルの [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ディレクティブによって使用される設定を指定します。  各ディレクティブには、そのディレクティブに固有な 1 つ以上の \(値と対にした\) 属性を含めることができます。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] には [@ServiceHost](../../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブだけがあります。  
+  
+## このセクションの内容  
+ [@ServiceHost](../../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md)  
+ .svc コンパイラによって使用されるページ固有の属性を定義します。  .svc ファイルだけに組み込むことができます。  
+  
+## 関連項目  
+ [方法 : IIS で WCF サービスをホストする](../../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)  
+ インターネット インフォメーション サービス \(IIS\) でサービスをホストするときの @ServiceHost ディレクティブの使用方法について説明します。  
+  
+ [方法 : WAS で WCF サービスをホストする](../../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)  
+ Windows プロセス アクティブ化サービス \(WAS\) でサービスをホストするときの @ServiceHost ディレクティブの使用方法について説明します。  
+  
+## 参照  
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)   
+ [インターネット インフォメーション サービスでのホスティング](../../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)   
+ [Windows プロセス アクティブ化サービスでのホスティング](../../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md b/docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md
new file mode 100644
index 00000000000..5f7da4a359f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md
@@ -0,0 +1,78 @@
+---
+title: "@ServiceHost | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96ba6967-00f2-422f-9aa7-15de4d33ebf3
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# @ServiceHost
+サービス ホストの生成に使用されるファクトリを、ホストされるサービスと、.svc ファイルで提供されるホスティング コードのアクセスとコンパイルに必要なその他のプログラミング部分に関連付けます。  
+  
+## 構文  
+  
+```  
+  
+<% @ServiceHost   
+Service = "Service, ServiceNamespace"   
+Factory = "Factory, FactoryNamespace"  
+Debug = "Debug"  
+Language = "Language"   
+CodeBehind = "CodeBehind"%>  
+```  
+  
+## 属性  
+  
+#### サービス  
+ ホストされるサービスの CLR 型名。  これは、1 つ以上のサービス コンタクトを実装する型の修飾名にする必要があります。  
+  
+#### ファクトリ  
+ サービス ホストのインスタンス化に使用されるサービス ホスト ファクトリの CLR 型名。  この属性は省略できます。  未指定の場合は、<xref:System.ServiceModel.ServiceHost> のインスタンスを返す既定の <xref:System.ServiceModel.Activation.ServiceHostFactory> が使用されます。  
+  
+#### デバッグ  
+ デバッグ シンボルを使用して [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスをコンパイルするかどうかを示します。  デバッグ シンボルを含む [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをコンパイルする場合は `true`、それ以外の場合は `false` を指定します。  
+  
+#### 言語  
+ ファイル \(.svc\) 内のすべてのインライン コードをコンパイルするときに使用する言語を指定します。  値は、C\#、VB、JS \(それぞれ、C\#、Visual Basic .NET、および JScript .NET を示す\) など、.NET がサポートする任意の言語を表します。  この属性は省略できます。  
+  
+#### CodeBehind  
+ XML Web サービスを実装するクラスが同じファイル内に存在せず、アセンブリとしてコンパイルされずに \\Bin ディレクトリに置かれているとき、XML Web サービスを実装するソース ファイルを指定します。  
+  
+## 解説  
+ サービスのホストに使用される <xref:System.ServiceModel.ServiceHost> は、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] プログラミング モデル内の拡張ポイントです。  ファクトリ パターンは、ホスティング環境が直接インスタンス化できないポリモーフィック型の可能性があるため、<xref:System.ServiceModel.ServiceHost> のインスタンス化に使用されます。  
+  
+ 既定の実装では <xref:System.ServiceModel.Activation.ServiceHostFactory> を使用して、<xref:System.ServiceModel.ServiceHost> のインスタンスを作成します。  ただし、ファクトリ実装の CLR 型名を [@ServiceHost](../../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブに指定して、独自のファクトリ \(派生ホストを返すファクトリ\) を提供できます。  
+  
+ 既定のファクトリの代わりに独自のカスタム サービス ホスト ファクトリを使用するには、型名を [@ServiceHost](../../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブに次のように指定します。  
+  
+```  
+<% @ServiceHost Factory=”DerivedFactory” Service=”MyService” %>  
+```  
+  
+ ファクトリ実装はできるだけ軽量に保持してください。  多くのカスタム ロジックがある場合は、それらのロジックをファクトリ内部ではなくホスト内部に置くとコードがさらに再利用可能になります。  
+  
+ たとえば、`MyService` の AJAX 対応のエンドポイントを有効にするには、次の例に示す [@ServiceHost](../../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブで、`Factory` 属性の値に、既定の <xref:System.ServiceModel.Activation.ServiceHostFactory> の代わりに <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> を指定します。  
+  
+## 使用例  
+  
+```  
+<% @ServiceHost   
+Service="MyService"  
+Language="C#"  
+Debug="true"  
+Factory="WebScriptServiceHostFactory"  
+%>  
+```  
+  
+## 参照  
+ [カスタム サービス ホスト](../../../../../docs/framework/wcf/samples/custom-service-host.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/TOC.md b/docs/framework/configure-apps/file-schema/wcf/TOC.md
new file mode 100644
index 00000000000..fc4a422fcc0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/TOC.md
@@ -0,0 +1,296 @@
+# [<commonParameters>](commonparameters.md)
+# [<netHttpsBinding>](nethttpsbinding.md)
+# [<security>](security-of-ws2007httpbinding.md)
+# [<wsDualHttpBinding>](wsdualhttpbinding.md)
+# [<endpointBehaviors>](endpointbehaviors.md)
+# [<discoveryEndpoint>](discoveryendpoint.md)
+# [<faultPropagationQuery>](faultpropagationquery-of-wcf.md)
+# [<udpBinding>](udpbinding.md)
+# [<claimTypeRequirements>](claimtyperequirements-for-message.md)
+# [<policyImporters>](policyimporters.md)
+# [<issuerChannelBehaviors>](issuerchannelbehaviors-element.md)
+# [<security>](security-of-peertransport.md)
+# [<httpsTransport>](httpstransport.md)
+# [<dataContractSerializer>](datacontractserializer-element.md)
+# [<declaredTypes>](declaredtypes.md)
+# [メッセージ エンコーディング](message-encoding.md)
+# [<mexHttpsBinding>](mexhttpsbinding.md)
+# [<defaultCertificate>](defaultcertificate-element.md)
+# [<defaultPorts> の <add>](add-of-defaultports.md)
+# [<transport>](transport-of-webhttpbinding.md)
+# [<clear>](clear-of-claimtyperequirements-element.md)
+# [<knownType>](knowntype.md)
+# [<msmqIntegrationBinding></msmqIntegrationBinding>](msmqintegrationbinding.md)
+# [<bookmarkResumptionQueries>](bookmarkresumptionqueries-of-wcf.md)
+# [<webHttpEndpoint>](webhttpendpoint.md)
+# [<messageSenderAuthentication>](messagesenderauthentication.md)
+# [<filterTable>](filtertable.md)
+# [<soapProcessing>](soapprocessing.md)
+# [<issuerMetadata>](issuermetadata.md)
+# [<textMessageEncoding>](textmessageencoding.md)
+# [<add>](add-of-serviceactivations.md)
+# [<persistableType>](persistabletype.md)
+# [<serviceCertificate>](servicecertificate-of-clientcredentials-element.md)
+# [<mexHttpBinding>](mexhttpbinding.md)
+# [<binaryMessageEncoding>](binarymessageencoding.md)
+# [<add>](add-of-filters.md)
+# [<activityScheduledQueries>](activityscheduledqueries-of-wcf.md)
+# [<add>](add-of-scopedcertificates-element.md)
+# [<windowsAuthentication>](windowsauthentication-of-servicecredentials.md)
+# [<endpoint>](endpoint-of-client.md)
+# [<security>](security-of-nethttpbinding.md)
+# [<additionalRequestParameters>](additionalrequestparameters-element.md)
+# [<transport>](transport-of-netnamedpipebinding.md)
+# [<dataContractSerializer>](datacontractserializer-of-system-runtime-serialization.md)
+# [<participants>](participants-of-wcf.md)
+# [<routing>](routing-of-servicebehavior.md)
+# [<faultPropagationQueries>](faultpropagationqueries-of-wcf.md)
+# [<callbackTimeouts>](callbacktimeouts.md)
+# [<transport>](transport-of-peertransport.md)
+# [<activityStateQuery>](activitystatequery-of-wcf.md)
+# [<issuer>](issuer-of-issuedtokenparameters.md)
+# [<standardEndpoints>](standardendpoints.md)
+# [<states>](states-of-wcf-workflowinstancequery.md)
+# [<metadata>](metadata.md)
+# [<namespaceTable> の <add>](add-of-namespacetable.md)
+# [<synchronousReceive>](synchronousreceive-element.md)
+# [<dispatcherSynchronization>](dispatchersynchronization.md)
+# [<mexEndpoint>](mexendpoint.md)
+# [<scopedCertificates>](scopedcertificates-element.md)
+# [<headers>](headers.md)
+# [<add>](add-of-claimtyperequirements.md)
+# [<transport>](transport-of-netpeertcpbinding.md)
+# [<add>](add-of-declaredtypes-element.md)
+# [WCF 構成スキーマ](index.md)
+# [<clientVia>](clientvia.md)
+# [<identity>](identity.md)
+# [<pnrpPeerResolver>](pnrppeerresolver.md)
+# [<peerTransport>](peertransport.md)
+# [<add>](add-of-wcf.md)
+# [<system.serviceModel.activation>](system-servicemodel-activation.md)
+# [<workflow>](workflow-of-wcf.md)
+# [<client>](client.md)
+# [<host>](host.md)
+# [<extensions>](extensions.md)
+# [<add>](add-of-backuplist.md)
+# [<webSocketSettings>](websocketsettings.md)
+# [<byteStreamMessageEncoding>](bytestreammessageencoding.md)
+# [<bindingElementExtensions>](bindingelementextensions.md)
+# [<security>](security-of-netnamedpipebinding.md)
+# [<serviceSecurityAudit>](servicesecurityaudit.md)
+# [<behavior>](behavior-of-endpointbehaviors.md)
+# [<issuedToken>](issuedtoken.md)
+# [<cancelRequestedQuery>](cancelrequestedquery-of-wcf.md)
+# [<bindings>](bindings.md)
+# [<add>](add-of-baseaddressprefixfilter.md)
+# [<peer>](peer-of-servicecredentials.md)
+# [<netHttpBinding>](nethttpbinding.md)
+# [<policyImporter>](policyimporter.md)
+# [<workflowInstanceQueries>](workflowinstancequeries-of-wcf.md)
+# [<security>](security-of-msmqintegrationbinding.md)
+# [<rsa>](rsa.md)
+# [<serviceTimeouts>](servicetimeouts.md)
+# [<peerAuthentication>](peerauthentication.md)
+# [<certificateReference>](certificatereference-for-identity.md)
+# [<msmqIntegration>](msmqintegration.md)
+# [<security>](security-of-wsfederationhttpbinding.md)
+# [<system.runtime.serialization>](system-runtime-serialization.md)
+# [<udpTransportSettings>](udptransportsettings-of-udpannouncementendpoint.md)
+# [<cancelRequestedQueries>](cancelrequestedqueries-of-wcf.md)
+# [<discoveryClient>](discoveryclient.md)
+# [<custom>](custom.md)
+# [<netMsmqBinding>](netmsmqbinding.md)
+# [<dataContractSerializer>](datacontractserializer.md)
+# [<backupList>](backuplist.md)
+# [<serviceDiscovery>](servicediscovery.md)
+# [<persistenceProvider>](persistenceprovider.md)
+# [<serviceThrottling>](servicethrottling.md)
+# [<claimTypeRequirements>](claimtyperequirements-element.md)
+# [<routing>](routing.md)
+# [<message>](message-of-ws2007httpbinding.md)
+# [<namedPipeTransport>](namedpipetransport.md)
+# [<activityStateQueries>](activitystatequeries-of-wcf.md)
+# [<message>](message-of-nethttpbinding.md)
+# [<customBinding>](custombinding.md)
+# [<message>](message-element-of-wsfederationhttpbinding.md)
+# [<enableWebScript>](enablewebscript.md)
+# [<wsFederationHttpBinding>](wsfederationhttpbinding.md)
+# [<certificate>](certificate-element.md)
+# [<ws2007FederationHttpBinding>](ws2007federationhttpbinding.md)
+# [<scopes>](scopes.md)
+# [<wsdlImporter>](wsdlimporter.md)
+# [<serviceActivations>](serviceactivations.md)
+# [<serviceCredentials>](servicecredentials.md)
+# [<dynamicEndpoint>](dynamicendpoint.md)
+# [<transportConfigurationTypes>](transportconfigurationtypes.md)
+# [<windowsStreamSecurity>](windowsstreamsecurity.md)
+# [<clientCertificate>](clientcertificate-of-servicecredentials.md)
+# [<tcpTransport>](tcptransport.md)
+# [<remove>](remove-of-claimtyperequirements-element.md)
+# [<messageSenderAuthentication>](messagesenderauthentication-element.md)
+# [<baseAddressPrefixFilters>](baseaddressprefixfilters.md)
+# [<transactionFlow>](transactionflow.md)
+# [<issuer>](issuer.md)
+# [<net.tcp>](net-tcp.md)
+# [<httpTransport>](httptransport.md)
+# [<webMessageEncoding>](webmessageencoding.md)
+# [<security>](security-of-wsdualhttpbinding.md)
+# [<security>](security-of-wshttpbinding.md)
+# [<basicHttpBinding>](basichttpbinding.md)
+# [<webScriptEndpoint>](webscriptendpoint.md)
+# [<ws2007HttpBinding>](ws2007httpbinding.md)
+# [<udpTransportSettings>](udptransportsettings.md)
+# [<webHttpBinding>](webhttpbinding.md)
+# [<bindingExtensions>](bindingextensions.md)
+# [<security>](security-element-of-ws2007federationhttpbinding.md)
+# [<dns>](dns.md)
+# [<services>](services.md)
+# [<timeOuts>](timeouts.md)
+# [<exposedMethods>](exposedmethods.md)
+# [<filters>](filters-of-routing.md)
+# [<windows>](windows-of-clientcredentials-element.md)
+# [<behavior>](behavior-of-servicebehaviors.md)
+# [<baseAddresses>](baseaddresses.md)
+# [<mtomMessageEncoding>](mtommessageencoding.md)
+# [<system.serviceModel>](system-servicemodel.md)
+# [<add>](add-of-allowaccounts.md)
+# [<bookmarkResumptionQuery>](bookmarkresumptionquery-of-wcf.md)
+# [<message>](message-of-wsdualhttpbinding.md)
+# [<authentication>](authentication-of-servicecertificate-element.md)
+# [<transport>](transport-of-netmsmqbinding.md)
+# [<security>](security-of-webhttpbinding.md)
+# [<defaultPorts>](defaultports.md)
+# [<compositeDuplex>](compositeduplex.md)
+# [<tracking>](tracking-of-wcf.md)
+# [<endpointDiscovery>](endpointdiscovery.md)
+# [<namedPipeTransport> の <connectionPoolSettings>](connectionpoolsettings.md)
+# [<userDefinedTypes>](userdefinedtypes.md)
+# [<message>](message-of-netmsmqbinding.md)
+# [<serviceDebug>](servicedebug.md)
+# [<workflowControlEndpoint>](workflowcontrolendpoint.md)
+# [<add>](add-of-services.md)
+# [<net.pipe>](net-pipe.md)
+# [<transport>](transport-of-ws2007httpbinding.md)
+# [<userPrincipalName>](userprincipalname.md)
+# [<useRequestHeadersForMetadataAddress>](userequestheadersformetadataaddress.md)
+# [<knownCertificates>](knowncertificates.md)
+# [<secureConversationBootstrap>](secureconversationbootstrap.md)
+# [<namespaceTable>](namespacetable.md)
+# [<security>](security-of-basichttpbinding.md)
+# [<message>](message-of-wshttpbinding.md)
+# [<exposedMethod>](exposedmethod.md)
+# [<add>](add-of-authorizationpolicies.md)
+# [<contractTypeNames>](contracttypenames.md)
+# [<serviceAuthenticationManager>](serviceauthenticationmanager.md)
+# [<netTcpBinding>](nettcpbinding.md)
+# [<issuedTokenAuthentication>](issuedtokenauthentication-of-servicecredentials.md)
+# [トランスポート](transports.md)
+# [<udpAnnoucementEndpoint>](udpannoucementendpoint.md)
+# [<authorizationPolicies>](authorizationpolicies.md)
+# [<serviceBehaviors>](servicebehaviors.md)
+# [<behaviorExtensions>](behaviorextensions.md)
+# [<serviceCertificate>](servicecertificate-of-servicecredentials.md)
+# [<backupLists>](backuplists.md)
+# [<findCriteria>](findcriteria.md)
+# [<extensions>](extensions-section.md)
+# [<message>](message-element-of-ws2007federationhttpbinding.md)
+# [<commonBehaviors>](commonbehaviors.md)
+# [<message>](message-of-basichttpbinding.md)
+# [<protocolMapping>](protocolmapping.md)
+# [<add>](add-of-issuerchannelbehaviors.md)
+# [<peer>](peer-of-clientcredentials-element.md)
+# [<endToEndTracing>](endtoendtracing.md)
+# [<serviceHostingEnvironment>](servicehostingenvironment.md)
+# [<add>](add-of-allowedaudienceuris.md)
+# [<persistableTypes>](persistabletypes.md)
+# [<privacyNoticeAt>](privacynoticeat.md)
+# [<transport>](transport-of-basichttpbinding.md)
+# [<certificate>](certificate-for-identity.md)
+# [<authentication>](authentication-of-clientcertificate-element.md)
+# [<transport>](transport-of-nettcpbinding.md)
+# [<certificate>](certificate-of-peer.md)
+# [<channelPoolSettings>](channelpoolsettings.md)
+# [<localClientSettings>](localclientsettings-element.md)
+# [<sslStreamSecurity>](sslstreamsecurity.md)
+# [<comContracts>](comcontracts.md)
+# [<filterTables>](filtertables.md)
+# [<state>](state-of-wcf-workflowinstancequery.md)
+# [<callbackDebug>](callbackdebug.md)
+# [<comContract>](comcontract.md)
+# [<servicePrincipalName>](serviceprincipalname.md)
+# [<httpDigest>](httpdigest-element.md)
+# [<clientCertificate>](clientcertificate-of-clientcredentials-element.md)
+# [<transport>](transport-of-nethttpbinding.md)
+# [<add>](add-of-entries.md)
+# [<basicHttpContextBinding>](basichttpcontextbinding.md)
+# [<xmlElement>](xmlelement.md)
+# [<filters>](filters.md)
+# [<add>](add-of-commonparameters.md)
+# [<workflowInstanceQuery>](workflowinstancequery-of-wcf.md)
+# [<endpointExtensions>](endpointextensions.md)
+# [<filter>](filter.md)
+# [<add>](add-of-claimtyperequirements-element.md)
+# [<workflowRuntime>](workflowruntime.md)
+# [<endpoint>](endpoint-element.md)
+# [<connectionPoolSettings>](connectionpoolsettings-of-tcptransport.md)
+# [<transactedBatching>](transactedbatching.md)
+# [<netPeerTcpBinding>](netpeertcpbinding.md)
+# [<serviceMetadata>](servicemetadata.md)
+# [<security>](security-of-nettcpbinding.md)
+# [<wsdlImporters>](wsdlimporters.md)
+# [<localIssuer>](localissuer.md)
+# [<activityScheduledQuery>](activityscheduledquery-of-wcf.md)
+# [<userNameAuthentication>](usernameauthentication.md)
+# [<security>](security-of-custombinding.md)
+# [<transport>](transport-of-wshttpbinding.md)
+# [<services>](services-of-workflowruntime.md)
+# [<entries>](entries.md)
+# [<tokenRequestParameters>](tokenrequestparameters.md)
+# [<webHttp>](webhttp.md)
+# [<udpDiscoveryEndpoint>](udpdiscoveryendpoint.md)
+# [<security>](security-of-netpeerbinding.md)
+# [<clientCredentials>](clientcredentials.md)
+# [<wsHttpContextBinding>](wshttpcontextbinding.md)
+# [<message>](message-element-of-nettcpbinding.md)
+# [<netTcpContextBinding>](nettcpcontextbinding.md)
+# [<messageLogging></messageLogging>](messagelogging.md)
+# [<add>](add-of-baseaddresses.md)
+# [<issuerMetadata>](issuermetadata-of-issuedtokenparameters.md)
+# [<msmqTransport>](msmqtransport.md)
+# [<mexNamedPipeBinding>](mexnamedpipebinding.md)
+# [<serviceAuthorization>](serviceauthorization-element.md)
+# [<useManagedPresentation>](usemanagedpresentation.md)
+# [<allowAccounts>](allowaccounts.md)
+# [<customTrackingQuery>](customtrackingquery-of-wcf.md)
+# [<customTrackingQueries>](customtrackingqueries-of-wcf.md)
+# [<diagnostics>](diagnostics-for-activation.md)
+# [<service>](service.md)
+# [<reliableSession>](reliablesession.md)
+# [<add>](add-of-knowncertificates.md)
+# [<issuedTokenParameters>](issuedtokenparameters.md)
+# [<parameter>](parameter.md)
+# [<userDefinedType>](userdefinedtype.md)
+# [<allowedAudienceUris>](allowedaudienceuris.md)
+# [<wsHttpBinding>](wshttpbinding.md)
+# [<behaviors>](behaviors.md)
+# [<diagnostics>](diagnostics.md)
+# [<resolver>](resolver.md)
+# [<secureConversationAuthentication>](secureconversationauthentication-of-servicecredential.md)
+# [<trackingProfile>](trackingprofile-of-wcf.md)
+# [<peerAuthentication>](peerauthentication-element.md)
+# [<msmqTransportSecurity>](msmqtransportsecurity.md)
+# [<add>](add-of-protocolmapping.md)
+# [<localServiceSettings>](localservicesettings-element.md)
+# [<add>](add-of-scopes.md)
+# [<transport>](transport-of-msmqintegrationbinding.md)
+# [<unrecognizedPolicyAssertion>](unrecognizedpolicyassertion.md)
+# [<headers>](headers-element.md)
+# [<add>](add-of-transportconfigurationtype.md)
+# [<add>](add-of-contracttypenames.md)
+# [<announcementEndpoint>](announcementendpoint.md)
+# [<discoveryClientSettings>](discoveryclientsettings.md)
+# [<mexTcpBinding>](mextcpbinding.md)
+# [<oneWay>](oneway.md)
+# [<netNamedPipeBinding>](netnamedpipebinding.md)
+# [<certificate>](certificate-of-clientcertificate-element.md)
+# [<security>](security-of-netmsmqbinding.md)
diff --git a/docs/framework/configure-apps/file-schema/wcf/activityscheduledqueries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/activityscheduledqueries-of-wcf.md
new file mode 100644
index 00000000000..e79afd87ae4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/activityscheduledqueries-of-wcf.md
@@ -0,0 +1,63 @@
+---
+title: "WCF の &lt;activityScheduledQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e351329f-9676-4f11-9b19-f4bac82f36fc
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;activityScheduledQueries&gt;
+親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用する、クエリのコレクションを表します。  アクティビティがスケジュールされたレコードを追跡参加要素が定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+     <trackingProfile name="Name">  
+       <workflow>  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+       </workflow>  
+     </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityScheduledQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md)|親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityScheduledQuery](assetId:///System.Activities.Tracking.ActivityScheduledQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/activityscheduledquery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/activityscheduledquery-of-wcf.md
new file mode 100644
index 00000000000..30b1f092e68
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/activityscheduledquery-of-wcf.md
@@ -0,0 +1,64 @@
+---
+title: "WCF の  &lt;activityScheduledQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 25f6eee1-3d98-4c39-b517-c0813f03f106
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の  &lt;activityScheduledQuery&gt;
+親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用する、クエリのコレクションを表します。  アクティビティがスケジュールされたレコードを追跡参加要素が定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+     <trackingProfile name="Name">  
+       <workflow>  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+       </workflow>  
+     </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|キャンセルを要求しているアクティビティの名前を指定する文字列。|  
+|childActivityName|キャンセルが要求された子アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityScheduledQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md)|親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用するクエリ。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityScheduledQuery](assetId:///System.Activities.Tracking.ActivityScheduledQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/activitystatequeries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/activitystatequeries-of-wcf.md
new file mode 100644
index 00000000000..803e2f63c15
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/activitystatequeries-of-wcf.md
@@ -0,0 +1,71 @@
+---
+title: "WCF の &lt;activityStateQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e45db49-ed85-4fdf-bd65-0d5477e31823
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;activityStateQueries&gt;
+ワークフロー インスタンスを構成するアクティビティのライフサイクルの変化を追跡するために使用する、クエリのコレクションを表します。  たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡することが必要な場合があります。  追跡参加要素がアクティビティ状態レコード オブジェクトを定期受信するには、このクエリが必要です。  定期受信可能な状態は ActivityStates で指定します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリ。このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/activitystatequery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/activitystatequery-of-wcf.md
new file mode 100644
index 00000000000..0f61667a9ae
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/activitystatequery-of-wcf.md
@@ -0,0 +1,95 @@
+---
+title: "WCF の &lt;activityStateQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6cdc04b-6f3a-4097-a623-ee4a1be3b5c4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;activityStateQuery&gt;
+ワークフロー インスタンスを構成するアクティビティのライフサイクルの変化を追跡するために使用されるクエリを表します。  たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡することが必要な場合があります。  追跡参加要素がアクティビティ状態レコード オブジェクトを定期受信するには、このクエリが必要です。  定期受信可能な状態は ActivityStates で指定します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|<xref:System.Activities.Tracking.ActivityStateRecord> インスタンスをフィルターするために、アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md)|このアクティビティ クエリに関連付けられている引数のコレクション。|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素のコレクション。|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|このアクティビティ クエリに関連付けられている変数のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素の一覧を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md)[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および `Closed` 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-allowaccounts.md b/docs/framework/configure-apps/file-schema/wcf/add-of-allowaccounts.md
new file mode 100644
index 00000000000..4bfc17993e9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-allowaccounts.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;allowAccounts&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 763c7b1f-e7b0-4d99-a42c-4506fcb8da00
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;allowAccounts&gt; の &lt;add&gt;
+[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをホストし、共有サービスへの接続アクセスが付与されているプロセスのユーザー アカウントを指定します。  
+  
+ \<system.serviceModel.activation\>  
+  
+## 構文  
+  
+```  
+  
+<allowAccounts>  
+   <add securityIdentifier="String"/>  
+</allowAccounts>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|securityIdentifier|ユーザー アカウントの識別に使用される一意の識別子を指定する文字列。  既定値は LocalSystem、Administrators、NS、LS、および IIS\_USRS です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<allowAccounts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/allowaccounts.md)|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] をホストするプロセスのユーザー アカウントを指定する `securityIdentifier` 属性が含まれており、共有サービスへの接続アクセス権が付与される構成要素のコレクションです。|  
+  
+## 使用例  
+ 次の構成例は、このコレクションにユーザー アカウントの 5 つの既定の識別子を追加します。  
+  
+```  
+<allowAccounts>  
+   // LocalSystem account  
+   <add securityIdentifier="S-1-5-18"/>  
+   // LocalService account  
+   <add securityIdentifier="S-1-5-19"/>  
+   // Administrators account  
+   <add securityIdentifier="S-1-5-20"/>  
+   // Network Service account  
+   <add securityIdentifier="S-1-5-32-544" />  
+   // IIS_IUSRS account (Vista only)  
+   <add securityIdentifier="S-1-5-32-568"/>  
+</allowAccounts>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration.NetTcpSection.AllowAccounts%2A>   
+ <xref:System.ServiceModel.Activation.Configuration.NetPipeSection.AllowAccounts%2A>   
+ <xref:System.ServiceModel.Activation.Configuration.SecurityIdentifierElementCollection>   
+ <xref:System.ServiceModel.Activation.Configuration.SecurityIdentifierElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md b/docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md
new file mode 100644
index 00000000000..c20a2ec3c3d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;allowedAudienceUris&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e7b7637-e0ea-4a91-988f-6b6ef28d9fc3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;allowedAudienceUris&gt; の &lt;add&gt;
+<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI を追加します。  
+  
+## 構文  
+  
+```  
+  
+<allowedAudienceUris>   
+   <add allowedAudienceUri="String"/>  
+</allowedAudienceUris>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowedAudienceUri|<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI を含む文字列です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<allowedAudienceUris\>](../../../../../docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md)|<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI のコレクションを表します。|  
+  
+## 解説  
+ このコレクションは、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンを発行するセキュリティ トークン サービス \(STS\) を利用するフェデレーション アプリケーションで使用する必要があります。  STS がセキュリティ トークンを発行する場合、このセキュリティ トークンに <xref:System.IdentityModel.Tokens.SamlAudienceRestrictionCondition> を追加して、セキュリティ トークンの提供先となる Web サービスの URI を指定できます。  これにより、受け取り側 <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> Web サービスは、次のようにしてこのチェックが行われるように指定することで、発行されたセキュリティ トークンがこの Web サービスを対象としていることを確認できます。  
+  
+-   `<issuedTokenAuthentication>` の `audienceUriMode` 属性を <xref:System.IdentityModel.Selectors.AudienceUriMode> または <xref:System.IdentityModel.Selectors.AudienceUriMode> に設定します。  
+  
+-   このコレクションに URI を追加して、有効な URI のセットを指定します。  
+  
+ 詳細については、「<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>」を参照してください。  
+  
+ この構成要素の使用の詳細については、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement.AllowedAudienceUris%2A>   
+ <xref:System.ServiceModel.Configuration.AllowedAudienceUriElementCollection>   
+ <xref:System.ServiceModel.Configuration.AllowedAudienceUriElement>   
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.AllowedAudienceUris%2A>   
+ [\<allowedAudienceUris\>](../../../../../docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md)   
+ [\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-authorizationpolicies.md b/docs/framework/configure-apps/file-schema/wcf/add-of-authorizationpolicies.md
new file mode 100644
index 00000000000..d4659184633
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-authorizationpolicies.md
@@ -0,0 +1,66 @@
+---
+title: "&lt;authorizationPolicies&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 613a03d8-4384-4556-bce2-8c23286c0bb0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;authorizationPolicies&gt; の &lt;add&gt;
+クレームの変換の承認ポリシーを指定します。  
+  
+## 構文  
+  
+```  
+  
+<authorizationPolicies>  
+   <add policyType="String" />  
+</authorizationPolicies>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`policyType`|必須の文字列属性。<br /><br /> [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アクセス制御モデルは、承認ポリシーのセットを型として提供します。  この属性は、入力クレームのセットをクレームの別のセットに変換することを可能にする承認ポリシーを指定します。  アクセス制御は、それに基づいて許可または拒否されます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<authorizationPolicies\>](../../../../../docs/framework/configure-apps/file-schema/wcf/authorizationpolicies.md)|承認ポリシーの種類のコレクションを指定します。|  
+  
+## 解説  
+ 各承認ポリシーは、文字列の単一の必須属性 `policyType` を含みます。  この属性は、入力クレームのセットをクレームの別のセットに変換することを可能にする承認ポリシーを指定します。  アクセス制御は、それに基づいて許可または拒否されます。  認証ポリシーの動作の詳細については、「<xref:System.IdentityModel.Policy.IAuthorizationPolicy>」および「[承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceAuthorizationElement>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ExternalAuthorizationPolicies%2A>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>   
+ <xref:System.ServiceModel.Configuration.AuthorizationPolicyTypeElement>   
+ <xref:System.ServiceModel.Configuration.ServiceAuthorizationElement.AuthorizationPolicies%2A>   
+ <xref:System.ServiceModel.Configuration.AuthorizationPolicyTypeElementCollection>   
+ <xref:System.IdentityModel.Policy.IAuthorizationPolicy>   
+ [サービス操作へのアクセスの承認](../../../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)   
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-authorizationpolicies.md)   
+ [承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-backuplist.md b/docs/framework/configure-apps/file-schema/wcf/add-of-backuplist.md
new file mode 100644
index 00000000000..6b3069b2c69
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-backuplist.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;backupList&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bc5939fc-314a-4ea4-a533-c96958da7173
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;backupList&gt; の &lt;add&gt;
+バックアップ エンドポイント要素を定義する構成要素を表します。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+  <backupLists>  
+    <backupList name="String">  
+      <add endpointName="String" />  
+    </backupList>    
+  </backupLists>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|バックアップ エンドポイントの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|プライマリ エンドポイントに接続できないときにルーティング サービスが使用するエンドポイントのリストを格納します。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.BackupEndpointElement](assetId:///System.ServiceModel.Routing.Configuration.BackupEndpointElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddresses.md b/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddresses.md
new file mode 100644
index 00000000000..03e1d788210
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddresses.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;baseAddresses&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bd7426f-5f4f-43fc-b8e9-de842219aa32
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;baseAddresses&gt; の &lt;add&gt;
+サービス ホストによって使用されるベース アドレスを指定する構成要素を表します。  
+  
+## 構文  
+  
+```  
+  
+<add baseAddress="string" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`baseAddress`|サービス ホストによって使用されるベース アドレスを指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<baseAddresses\>](../../../../../docs/framework/configure-apps/file-schema/wcf/baseaddresses.md)|`baseAddress` 要素のコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HostElement>   
+ <xref:System.ServiceModel.ServiceHost>   
+ <xref:System.ServiceModel.ServiceHostBase.BaseAddresses%2A>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddressprefixfilter.md b/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddressprefixfilter.md
new file mode 100644
index 00000000000..29ad9d24990
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-baseaddressprefixfilter.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;baseAddressPrefixFilter&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b226bede-8459-4de9-b2ac-3d39604ce2bc
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;baseAddressPrefixFilter&gt; の &lt;add&gt;
+パススルー フィルターを指定する構成要素を表します。パススルー フィルターには、インターネット インフォメーション サービス \(IIS\) で [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションをホストする場合に適切な IIS バインドを選択する機構が用意されています。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>  
+     <baseAddressPrefixFilters>  
+        <add prefix="string"/>  
+     </baseAddressPrefixFilters>  
+</serviceHostingEnvironment>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|prefix|ベース アドレスの一部の一致に使用される URI。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<baseAddressPrefixFilters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md)|パススルー フィルターを指定する構成要素のコレクション。パススルー フィルターには、IIS で [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションをホストする場合に適切な IIS バインドを選択する機構が用意されています。|  
+  
+## 解説  
+ プレフィックス フィルターは、サービスによって使用される URI を、共有ホスティング プロバイダーが指定できるようにする手段を提供します。  これにより、共有ホストは、同じサイト上の同じスキームに対して、別々のベース アドレスを使用して複数のアプリケーションをホストできるようになります。  
+  
+ IIS Web サイトは、仮想ディレクトリを含む仮想アプリケーションのコンテナーです。  サイト内のアプリケーションに、1 つ以上の IIS バインディングからアクセスできます。  IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。  バインディング プロトコル \(HTTP など\) は通信を行うスキームを定義し、バインディング情報 \(IP アドレス、ポート、ホスト ヘッダーなど\) にはサイトにアクセスするために使用するデータが含まれます。  
+  
+ IIS では、サイトごとに複数の IIS バインディングを指定できるので、各スキームに複数のベース アドレスが定義されることがあります。  これに対して、サイトでホストされる [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスでは、スキームごとに 1 つのベース アドレスにしかバインドできません。そこで、プレフィックス フィルター機能を使用すると、ホストされるサービスの必要なベース アドレスを選択できます。  IIS によって指定される受信ベース アドレスは、オプションのプレフィックス リスト フィルターに基づいてフィルター処理されます。  
+  
+ たとえば、サイトに次のベース アドレスが含まれているとします。  
+  
+```  
+http://testl.fabrikam.com/Service.svc  
+http://test2.fabrikam.com/Service.svc  
+```  
+  
+ 次の構成ファイルを使用して、appdomain レベルでプレフィックス フィルターを指定できます。  
+  
+```  
+<system.serviceModel>  
+  <serviceHostingEnvironment>  
+     <baseAddressPrefixFilters>  
+        <add prefix=”net.tcp://test1.fabrikam.com:8000”/>  
+        <add prefix=”http://test2.fabrikam.com:9000”/>  
+    </baseAddressPrefixFilters>  
+  </serviceHostingEnvironment>  
+</system.serviceModel>  
+```  
+  
+ この例では、`net.tcp://test1.fabrikam.com:8000` と `http://test2.fabrikam.com:9000` はそれぞれのスキームにおいて、そのまま渡すことができる唯一のベース アドレスです。  
+  
+ 既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。  プレフィックスだけを指定すると、そのスキームに一致するベース アドレスを渡すことができます。  
+  
+> [!NOTE]
+>  フィルターでワイルドカードはサポートされません。  また、IIS が提供する baseAddresses には、`baseAddressPrefixFilters` リストに存在しない他のスキームにバインドされたアドレスが指定される場合があります。  これらのアドレスはフィルターで除外されません。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BaseAddressPrefixFilterElement>   
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements-element.md b/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements-element.md
new file mode 100644
index 00000000000..a5f205ceed8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements-element.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;claimTypeRequirements&gt; 要素の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3234cd45-1478-468e-8b19-5c50815c4786
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;claimTypeRequirements&gt; 要素の &lt;add&gt;
+フェデレーション資格情報に表示されると予想される必須のクレームおよび省略可能なクレームの種類を指定します。  たとえば、サービスは、クレームの種類の特定のセットを処理する必要がある受信資格情報について要件を記述します。  
+  
+## 構文  
+  
+```  
+  
+<claimTypeRequirements>  
+      <add claimType="URI"  
+        isOptional="Boolean" />  
+</claimTypeRequirements>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|claimType|クレームの種類を定義する URI。  たとえば、Web サイトから製品を購入するために、ユーザーは、十分な与信限度額を備えた有効なクレジット カードを示す必要があります。  クレームの種類として、クレジット カードの URI があります。|  
+|isOptional|これが省略可能なクレームかどうかを指定するブール値。  これが必須のクレームの場合は、この属性を `false` に設定します。<br /><br /> サービスが必須でない情報を求めるときにこの属性を使用できます。  たとえば、ユーザーに氏名と住所の入力を要求し、電話番号は省略可能にする場合などです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md)|必須のクレームの種類のコレクションを指定します。  各要素は <xref:System.ServiceModel.Configuration.ClaimTypeElement> 型です。<br /><br /> フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須の要求および省略可能な要求の種類を指定します。|  
+  
+## 解説  
+ フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  この要件はセキュリティ ポリシー内に明記されます。  クライアントがフェデレーション サービスの資格情報 \(CardSpace など\) を要求する場合、クライアントは要件をトークン要求 \(RequestSecurityToken\) に設定します。これにより、フェデレーション サービスは、要件どおりの資格情報を発行できます。  
+  
+## 使用例  
+ 次の構成では、2 つのクレームの種類の要件をセキュリティ バインディングに追加しています。  
+  
+```  
+<bindings>  
+    <wsFederationHttpBinding>  
+      <binding name="myFederatedBinding">  
+        <security mode="Message">  
+          <message issuedTokenType="urn:oasis:names:tc:SAML:1.0:assertion">  
+            <claimTypeRequirements>  
+              <add claimType=  
+"http://schemas.microsoft.com/ws/2005/05/identity/claims/EmailAddress"/>  
+              <add claimType=  
+"http://schemas.microsoft.com/ws/2005/05/identity/claims/UserName"    
+optional="true" />  
+            </claims>  
+          </message>  
+        </security>  
+      </binding>  
+    </wsFederationHttpBinding>  
+</bindings>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements.md b/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements.md
new file mode 100644
index 00000000000..de554dd1c77
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;claimTypeRequirements&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c68e83c9-39e8-4264-b1ce-b6a9eb5b98aa
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;claimTypeRequirements&gt; の &lt;add&gt;
+フェデレーション資格情報に表示されると予想される必須のクレームおよび省略可能なクレームの種類を指定します。  たとえば、サービスは、クレームの種類の特定のセットを処理する必要がある受信資格情報について要件を記述します。  
+  
+## 構文  
+  
+```  
+  
+<claimTypeRequirements>  
+      <add claimType="URI"  
+           isOptional="Boolean" />  
+</claimTypeRequirements>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|claimType|クレームの種類を定義する URI。  たとえば、Web サイトから製品を購入するために、ユーザーは、十分な与信限度額を備えた有効なクレジット カードを示す必要があります。  クレームの種類として、クレジット カードの URI があります。|  
+|isOptional|これが省略可能なクレームかどうかを指定するブール値。  これが必須のクレームの場合は、この属性を `false` に設定します。<br /><br /> サービスが必須でない情報を求めるときにこの属性を使用できます。  たとえば、ユーザーに氏名と住所の入力を要求し、電話番号は省略可能にする場合などです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md)|必須のクレームの種類のコレクションを指定します。<br /><br /> フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須の要求および省略可能な要求の種類を指定します。|  
+  
+## 解説  
+ フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  この要件はセキュリティ ポリシー内に明記されます。  クライアントがフェデレーション サービスの資格情報 \(CardSpace など\) を要求する場合、クライアントは要件をトークン要求 \(RequestSecurityToken\) に設定します。これにより、フェデレーション サービスは、要件どおりの資格情報を発行できます。  
+  
+## 使用例  
+ 次の構成では、2 つのクレームの種類の要件をセキュリティ バインディングに追加しています。  
+  
+```  
+<bindings>  
+    <wsFederationHttpBinding>  
+      <binding name="myFederatedBinding">  
+        <security mode="Message">  
+          <message issuedTokenType="urn:oasis:names:tc:SAML:1.0:assertion">  
+            <claimTypeRequirements>  
+              <add claimType=  
+"http://schemas.microsoft.com/ws/2005/05/identity/claims/EmailAddress"/>  
+              <add claimType=  
+"http://schemas.microsoft.com/ws/2005/05/identity/claims/UserName"    
+optional="true" />  
+            </claims>  
+          </message>  
+        </security>  
+      </binding>  
+    </wsFederationHttpBinding>  
+</bindings>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement>   
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-commonparameters.md b/docs/framework/configure-apps/file-schema/wcf/add-of-commonparameters.md
new file mode 100644
index 00000000000..1978041d409
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-commonparameters.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;commonParameters&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3713bf25-20c8-455f-bb85-de46b6487932
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;commonParameters&gt; の &lt;add&gt;
+複数のサービスでグローバルに使用されるパラメーターの名前と値のペアを指定します。  このパラメーターには通常、永続性サービスによって共有されるデータベース接続文字列が格納されます。  
+  
+## 構文  
+  
+```  
+  
+<workflowRuntime>  
+   <commonParameters>  
+      <add name="String" value="String" />  
+   </commonParameters>  
+</workflowRuntime>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|サービスに対して指定されたパラメーターの名前。|  
+|value|サービスに対して指定されたパラメーターの値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<commonParameters\>](http://msdn.microsoft.com/ja-jp/d0e1e6fc-985a-4713-b7da-194e30dfab4c)|サービスによって使用される共通パラメーターのコレクション。  このコレクションには通常、永続性サービスによって共有されるデータベース接続文字列が格納されます。|  
+  
+## 解説  
+ 最初の要素 `<commonParameters>` は、複数のサービスでグローバルに使用されるパラメーターを定義します \(たとえば <xref:System.Workflow.Runtime.Hosting.SharedConnectionWorkflowCommitWorkBatchService> を使用する場合の `ConnectionString`\)。  
+  
+ <xref:System.Workflow.Runtime.Hosting.DefaultWorkflowCommitWorkBatchService> や <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService> など、作業バッチを永続的ストアにコミットするサービスでは、`EnableRetries` パラメーターを次の例のように使用することで、トランザクションの再試行を有効にできます。  
+  
+```  
+<WorkflowRuntime Name="SampleApplication" UnloadOnIdle="false">  
+    <commonParameters>  
+        <add name="ConnectionString" value="Initial Catalog=WorkflowStore;Data Source=localhost;Integrated Security=SSPI;" />  
+        <add name="EnableRetries" value="True" />  
+    </commonParameters>  
+    <Services>  
+        <add type="System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" EnableRetries="False" />   
+     </Services>  
+</WorkflowRuntime>  
+```  
+  
+ `EnableRetries` パラメーターは、*CommonParameters* セクションのようにグローバル レベルで設定したり、*Services* セクションのように `EnableRetries` をサポートするサービスごとに設定したりできます。  
+  
+ Windows Workflow Foundation ホスト アプリケーションの <xref:System.Workflow.Runtime.WorkflowRuntime> オブジェクトの動作を制御する構成ファイルの使い方の詳細については、「[Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<commonParameters>  
+   <add name="ConnectionString" value="Initial Catalog=WorkflowStore;Data Source=localhost;Integrated Security=SSPI;"/>  
+   <add name="EnableRetries" value="true"/>  
+</commonParameters>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WorkflowRuntimeElement>   
+ <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>   
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ <xref:System.Workflow.Runtime.Hosting.DefaultWorkflowCommitWorkBatchService>   
+ <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService>   
+ [Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)   
+ [\<commonParameters\>](http://msdn.microsoft.com/ja-jp/d0e1e6fc-985a-4713-b7da-194e30dfab4c)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-contracttypenames.md b/docs/framework/configure-apps/file-schema/wcf/add-of-contracttypenames.md
new file mode 100644
index 00000000000..2c203ad142b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-contracttypenames.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;contractTypeNames&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03aff6be-5dfb-4a64-ada3-e36227cd43c7
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;contractTypeNames&gt; の &lt;add&gt;
+検索対象サービスのコントラクト名と、サービスを検索するときに一般的に使用される条件を指定する構成要素。  複数のコントラクト名が指定されると、すべてのコントラクトに一致するサービス エンドポイントのみが適用されます。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] では、1 つのエンドポイントでサポートされるのは 1 つのコントラクトだけであることに注意してください。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <dynamicEndpoint>   
+          <standardEndpoint>  
+             <discoveryClientSettings discoveryEndpoint=”String” >  
+               <findCriteria duration=”TimeSpan”  
+                  maxResults=”Integer”   
+                  scopeMatchBy=”Uri” >  
+                  <contractTypeNames>  
+                     <add name="String" namespace="String" />  
+                  <contractTypeNames>  
+                  <extensions />  
+                  <scopes>  
+                    <add scope="URI"/>  
+                  </scopes>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+          <standardEndpoint>  
+       </dynamicEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|コントラクト型の名前を指定する文字列。|  
+|namespace|コントラクト型の名前空間を指定する文字列。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<contractTypeNames\>](../../../../../docs/framework/configure-apps/file-schema/wcf/contracttypenames.md)|コントラクトの型名のコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.FindCriteria>   
+ <xref:System.ServiceModel.Discovery.Configuration.FindCriteriaElement>   
+ <xref:System.ServiceModel.Discovery.Configuration.ContractTypeNameElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md b/docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md
new file mode 100644
index 00000000000..f138f1506cb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;declaredTypes&gt; 要素の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト"
+  - "DataContractAttribute"
+  - "DataContractSerializer"
+  - "dataContractSerializer 要素"
+ms.assetid: c3d37ae4-8f1c-463f-b195-658c5a7e90a1
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;declaredTypes&gt; 要素の &lt;add&gt;
+逆シリアル化中に、<xref:System.Runtime.Serialization.DataContractSerializer> で使用される型を追加します。  各宣言型は、宣言型のフィールドまたはプロパティとして返される既知の型を含みます。  
+  
+## 構文  
+  
+```  
+  
+<add type="String">  
+   <knownType type="String">  
+       <parameter index="Integer"  
+                  type="String" />  
+   </knownType>  
+</add>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|型|必須の文字列属性です。<br /><br /> 型名 \(名前空間を含む\)、アセンブリ名、バージョン番号、カルチャ、および公開キー トークンを指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<knownType\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowntype.md)|追加される宣言型の既知の型を指定します。  宣言型がジェネリック型の場合は、既知の型を返すために使用されるジェネリック パラメーターを指定するために、`<knownType>` にパラメーター要素も追加する必要があります。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<declaredTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/declaredtypes.md)|<xref:System.Runtime.Serialization.DataContractSerializer> による逆シリアル化中に既知のタイプを必要とするタイプが含まれています。|  
+  
+## 解説  
+ 既知の型の詳細については、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」および「<xref:System.Runtime.Serialization.DataContractSerializer>」を参照してください。  
+  
+ この要素の使用例については、「[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Object> 型を `<declaredType>` として追加すると、<xref:System.Configuration.ConfigurationErrorsException> がスローされます。  これは、構成で <xref:System.Object> 型を宣言型として使用できないためです。  
+  
+## 使用例  
+  
+```  
+<add type="MyCompany.Library.Shape,   
+           MyAssembly, Version=2.0.0.0, Culture=neutral,  
+           PublicKeyToken=XXXXXX, processorArchitecture=MSIL">  
+           <knownType type="MyCompany.Library.Circle,   
+                      MyAssembly, Version=2.0.0.0, Culture=neutral,  
+                      PublicKeyToken=XXXXXX,  
+                      processorArchitecture=MSIL"/>  
+</add>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)   
+ [\<add\> of \<declaredTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-defaultports.md b/docs/framework/configure-apps/file-schema/wcf/add-of-defaultports.md
new file mode 100644
index 00000000000..cf8682e6409
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-defaultports.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;defaultPorts&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f162ce42-963b-4779-96a7-d6d8b4ea0d2f
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;defaultPorts&gt; の &lt;add&gt;
+クライアント アプリケーションがリッスンする既定の通信エンドポイント。  
+  
+## 構文  
+  
+```  
+  
+<useRequestHeadersForMetadataAddress>  
+   <defaultPorts>  
+      <add port="Integer" scheme="String" />  
+   </defaultPorts>  
+</useRequestHeadersForMetadataAddress>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|ポート|既定の通信ポート番号を指定する整数。|  
+|scheme|通信ポートに関連付けられているプロトコル設定のグループを示す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<defaultPorts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/defaultports.md)|クライアント アプリケーションがリッスンする既定の通信エンドポイントの一覧を表示する既定のポートのコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DefaultPortElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-entries.md b/docs/framework/configure-apps/file-schema/wcf/add-of-entries.md
new file mode 100644
index 00000000000..1c59834dcbd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-entries.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;entries&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3af4805b-dc72-4f68-b168-da4fba8c6170
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;entries&gt; の &lt;add&gt;
+以前に定義されたクライアント エンドポイントにフィルターをマップするルーティング エントリを表します。  このフィルターに一致するメッセージは、この宛先に送信されます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filterTables>  
+        <filterTable name="String">  
+          <entries>  
+            <add backupList=”String”  
+                 endpointName="String"   
+                 filterName="String"   
+                 priority="Integer" />  
+          </entries>  
+        </table>  
+      </routingTables>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|backupList|エンドポイントのバックアップ リストへの参照を指定する文字列。|  
+|エンドポイント|`filterName` 属性で指定されたフィルターに一致するメッセージを受信するクライアント エンドポイントへの参照を指定する文字列。|  
+|filterName|フィルター要素への参照を指定する文字列。|  
+|priority|このエントリの優先順位を指定する整数。<br /><br /> ルーティング テーブルのエントリは、優先順位に基づいて評価されます。0 が最下位の優先順位です。  特定の優先順位について、すべてのエントリが同時に評価されます。現在の優先順位について一致するエントリが見つからない場合は、次の優先順位が評価されます。<br /><br /> この値はオプションです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|ルーティング マッピング エントリを含む構成セクション。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.RoutingSection](assetId:///System.ServiceModel.Routing.Configuration.RoutingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Routing.Configuration.FilterTableEntryElement](assetId:///System.ServiceModel.Routing.Configuration.FilterTableEntryElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-filters.md b/docs/framework/configure-apps/file-schema/wcf/add-of-filters.md
new file mode 100644
index 00000000000..1ac284a7743
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-filters.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;filters&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3bf437c-dd99-49f3-9792-9a8721e6eaad
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;filters&gt; の &lt;add&gt;
+ログに記録するメッセージの種類を指定する XPath フィルター。  
+  
+## 構文  
+  
+```  
+  
+<filters>  
+   <add filter="String"/>  
+</filters>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|フィルター|XPath 1.0 の式によって定義される、XML ドキュメントのクエリを指定する文字列。  詳細については、「<xref:System.ServiceModel.Dispatcher.XPathMessageFilter>」を参照してください。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters.md)|ログに記録されるメッセージの種類を制御する XPath フィルターのコレクションを格納します。|  
+  
+## 解説  
+ フィルターは、`logMessagesAtTransportLevel` を `true` に設定することによって指定されるトランスポート層でのみ適用されます。  サービス レベルおよび形式が正しくないメッセージ ログ記録は、フィルターの影響を受けません。  
+  
+ コレクションにフィルターを追加するには、`add` を使用します。  1 つ以上のフィルターを定義した場合は、少なくとも 1 つのフィルターと一致するメッセージだけが記録されます。  フィルターを定義しなかった場合は、すべてのメッセージが通過します。  
+  
+ フィルターは、完全な XPath 構文をサポートし、構成ファイルでの出現順に適用されます。  フィルターが構文的に正しくない場合は、構成例外が発生します。  
+  
+ SOAP ヘッダー セクションがあるメッセージだけを記録するフィルターの設定方法の例を次に示します。  
+  
+## 使用例  
+ SOAP ヘッダー セクションがあるメッセージだけを記録するフィルターの設定方法の例を次に示します。  
+  
+```  
+<messageLogging logEntireMessage="true"  
+     logMalformedMessages="true" logMessagesAtServiceLevel="true"  
+     logMessagesAtTransportLevel="true" maxMessagesToLog="420”>  
+     <filters>  
+        <add xmlns:soap="http://www.w3.org/2003/05/soap-envelope">  
+                        /soap:Envelope/soap:Headers  
+        </add>  
+     </filters>  
+</messageLogging>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DiagnosticSection>   
+ <xref:System.ServiceModel.Diagnostics>   
+ <xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A>   
+ <xref:System.ServiceModel.Configuration.MessageLoggingElement>   
+ <xref:System.ServiceModel.Configuration.MessageLoggingElement.Filters%2A>   
+ <xref:System.ServiceModel.Configuration.XpathMessageFilterElement>   
+ <xref:System.ServiceModel.Dispatcher.XPathMessageFilter>   
+ [メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)   
+ [メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)   
+ [\<messageLogging\>](../../../../../docs/framework/configure-apps/file-schema/wcf/messagelogging.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-issuerchannelbehaviors.md b/docs/framework/configure-apps/file-schema/wcf/add-of-issuerchannelbehaviors.md
new file mode 100644
index 00000000000..328dd5bde22
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-issuerchannelbehaviors.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;issuerChannelBehaviors&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 50710506-e28f-45dd-ab7e-bff6f44173db
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;issuerChannelBehaviors&gt; の &lt;add&gt;
+STS と通信するときに使用されるエンドポイントの動作を追加します。  
+  
+> [!NOTE]
+>  エンドポイントの動作に [\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素が含まれている場合は、例外がスローされます。  
+  
+## 構文  
+  
+```  
+  
+<add issuerAddress="string"  
+     behaviorConfiguraton="string" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|issuerAddress|通信するためのセキュリティ トークン発行者の URI。|  
+|behaviorConfiguration|同じ構成ファイルに定義されたエンドポイントの動作の名前。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuerChannelBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md)|指定されたセキュリティ トークン サービスと通信するときに使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] クライアント エンドポイントの動作のコレクションが含まれています。|  
+  
+## 解説  
+ `issuerAddress` には、クライアントの通信相手となるセキュリティ トークン サービスの URI が含まれます。  `behaviorConfiguration` は、アプリケーションが使用するエンドポイント動作を表します。アプリケーションは、セキュリティ トークン サービスから発行されたトークンを取得するために、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] によって作成されたチャネルでこの動作を使用します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientElement.IssuerChannelBehaviors%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientBehaviorsElement>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientBehaviorsElementCollection>   
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential.IssuerChannelBehaviors%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [\<issuerChannelBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md b/docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md
new file mode 100644
index 00000000000..2e37f717978
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md
@@ -0,0 +1,129 @@
+---
+title: "&lt;knownCertificates&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 128aaabe-3f1a-4c3b-b59f-898d0f02910f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;knownCertificates&gt; の &lt;add&gt;
+既知の証明書のコレクションに X.509 証明書を追加します。  
+  
+## 構文  
+  
+```  
+  
+<knownCertificates>   
+   <add findValue="String"  
+      storeLocation="CurrentUser/LocalMachine"  
+      storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+      x509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"/>  
+</knownCertificates>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|findValue|文字列。  検索対象の値。|  
+|storeLocation|列挙値。  検索する 2 つの格納場所のいずれかです。|  
+|storeName|列挙値。  検索するシステム ストアのいずれかです。|  
+|x509FindType|列挙値。  検索する証明書フィールドのいずれかです。|  
+  
+## findValue 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|値は、検索されるフィールド \(X509FindType 属性により指定される\) によって異なります。  たとえば、サムプリント検索する場合、値は 16 進数の文字列にする必要があります。|  
+  
+## x509FindType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、FindByThumbprint、FindBySubjectName、FindBySubjectDistinguishedName、FindByIssuerName、FindByIssuerDistinguishedName、FindBySerialNumber、FindByTimeValid、FindByTimeNotYetValid、FindBySerialNumber、FindByTimeExpired、FindByTemplateName、FindByApplicationPolicy、FindByCertificatePolicy、FindByExtension、FindByKeyUsage、FindBySubjectKeyIdentifier です。|  
+  
+## storeLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|CurrentUser または LocalMachine です。|  
+  
+## storeName 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、AddressBook、AuthRoot、CertificateAuthority、Disallowed、My、Root、TrustedPeople、および TrustedPublisher です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<knownCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md)|セキュリティ トークンを検証するためのセキュリティ トークン サービス \(STS\) によって提供される X.509 証明書のコレクションを表します。|  
+  
+## 解説  
+ 発行されるトークンのシナリオには、3 つの段階があります。  まず、サービスにアクセスしようとしているクライアントが*セキュリティ トークン サービス*に参照されます。  次に、セキュリティ トークン サービスがクライアントを認証し、その後、クライアントにトークン \(通常は、SAML \(Security Assertions Markup Language\) トークン\) を発行します。  最後に、クライアントがトークンを持ってサービスに戻ります。  サービスはトークンを調べ、トークンを認証することでクライアントの認証を可能にするデータを確認します。  トークンを認証するには、セキュリティ トークン サービスで使用される証明書がサービスによって認識されている必要があります。  
+  
+ [\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md) 要素は、このようなセキュリティ トークン サービス証明書のリポジトリです。  証明書を追加するには、[\<knownCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md) を使用します。  次の例に示すように、証明書ごとに [\<add\> element \<knownCertificates\> Element](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md) を挿入します。  
+  
+```  
+<issuedTokenAuthentication>  
+   <knownCertificates>  
+      <add findValue="www.contoso.com"   
+           storeLocation="LocalMachine" storeName="My"   
+           X509FindType="FindBySubjectName" />  
+    </knownCertificates>  
+</issuedTokenAuthentication>  
+```  
+  
+ 既定では、証明書はセキュリティ トークン サービスから取得する必要があります。  このような "既知" の証明書により、正当なクライアントのみがサービスにアクセスできるようになります。  
+  
+ クライアントがフェデレーション サービスによって認証される条件と、この構成要素の使い方の詳細については、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  フェデレーション シナリオの詳細については、「[フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+## 使用例  
+ 以下の例では、STS 証明書のリポジトリに証明書を追加します。  
+  
+```  
+<serviceBehaviors>  
+ <behavior name="myServiceBehavior">  
+  <serviceCredentials>  
+   <issuedTokenAuthentication>  
+    <knownCertificates>  
+     <add findValue="www.contoso.com" storeLocation="LocalMachine"   
+           storeName="CertificateAuthority"  
+           x509FindType="FindByIssuerName" />  
+     </knownCertificates>  
+    </issuedTokenAuthentication>  
+   </serviceCredentials>  
+  </behavior>  
+ </serviceBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement.KnownCertificates%2A>   
+ <xref:System.ServiceModel.Configuration.X509CertificateTrustedIssuerElementCollection>   
+ <xref:System.ServiceModel.Configuration.X509CertificateTrustedIssuerElement>   
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A>   
+ [\<knownCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-namespacetable.md b/docs/framework/configure-apps/file-schema/wcf/add-of-namespacetable.md
new file mode 100644
index 00000000000..8ebb2fb7e1f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-namespacetable.md
@@ -0,0 +1,58 @@
+---
+title: "&lt;namespaceTable&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf7b5b75-63bd-49a6-abac-4bfdab377e36
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;namespaceTable&gt; の &lt;add&gt;
+名前空間とプレフィックスのマッピングを含む構成要素を表します。これは、ルーティングの XPath フィルターで使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+   <namespaceTable>  
+     <add namespace="String" prefix="String" />   
+   </namespaceTable>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|namespace|名前空間を示す文字列。|  
+|prefix|この名前空間のプレフィックスを示す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namespaceTable\>](../../../../../docs/framework/configure-apps/file-schema/wcf/namespacetable.md)|名前空間とプレフィックスのマッピングを含む要素セットを定義する構成セクションを表します。これは、ルーティングの XPath フィルターで使用されます。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.NamespaceElement](assetId:///System.ServiceModel.Routing.Configuration.NamespaceElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-protocolmapping.md b/docs/framework/configure-apps/file-schema/wcf/add-of-protocolmapping.md
new file mode 100644
index 00000000000..bb4f568e2a7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-protocolmapping.md
@@ -0,0 +1,74 @@
+---
+title: "&lt;protocolMapping&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 08e62249-1641-41d1-91b1-66d7b46244e4
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;protocolMapping&gt; の &lt;add&gt;
+トランスポート プロトコル スキーム \(http、net.tcp、net.pipe など\) と [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] バインディング間の既定のプロトコル マッピングを表します。  実行時に既定のエンドポイントを作成するときに、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は構成されたマッピングを確認し、特定のベース アドレスに使用するバインディングを決定します。  
+  
+## 構文  
+  
+```vb  
+  
+<protocolMapping>  
+    <add binding="String”  
+         bindingConfiguration="String”  
+         scheme="http/net.msmq/net.pipe/net.tcp"/>  
+</protocolMapping>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|既定のエンドポイントを作成するときにエンドポイントに使用されるバインディングの種類を指定する文字列。|  
+|bindingConfiguration|参照されるバインディング構成セクションの名前を指定する文字列。|  
+|scheme|既定のエンドポイントに使用されるトランスポート プロトコル スキーム。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<protocolMapping\>](../../../../../docs/framework/configure-apps/file-schema/wcf/protocolmapping.md)|トランスポート プロトコル スキーム \(http、net.tcp、net.pipe など\) と [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] バインディング間の既定のプロトコル マッピングを定義する構成セクションを表します。|  
+  
+## 使用例  
+ 次の構成例は、machine.config ファイル内の既定のプロトコル マッピングを示しています。  machine.config ファイルを変更することで、既定のマッピングをコンピューター レベルでオーバーライドできます。  または、アプリケーションのスコープ内だけでオーバーライドする場合は、アプリケーション構成ファイルのこのセクションをオーバーライドし、各プロトコル スキームのマッピングを変更できます。  
+  
+```  
+  
+<protocolMapping>  
+        <add scheme="http" binding="basicHttpBinding"/>  
+        <add scheme="net.tcp" binding="netTcpBinding"/>  
+        <add scheme="net.pipe" binding="netNamedPipeBinding"/>  
+        <add scheme="net.msmq" binding="netMsmqBinding"/>  
+</protocolMapping>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Configuration.ProtocolMappingSection](assetId:///System.ServiceModel.Configuration.ProtocolMappingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Configuration.ProtocolMappingElement](assetId:///System.ServiceModel.Configuration.ProtocolMappingElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md b/docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md
new file mode 100644
index 00000000000..b06321aeb3e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md
@@ -0,0 +1,119 @@
+---
+title: "&lt;scopedCertificates&gt; 要素の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e21c1ef8-d6d6-4bca-ac5a-6fbf4bd77412
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;scopedCertificates&gt; 要素の &lt;add&gt;
+範囲指定された証明書のコレクションに X.509 証明書を追加します。  
+  
+## 構文  
+  
+```  
+  
+<add findValue="String"  
+          storeLocation="CurrentUser/LocalMachine"  
+          storeName=" CurrentUser/LocalMachine"  
+          targetUri="string"  
+         x509Type="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"   
+/>   
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|targetUri|文字列。  証明書に関連付けられているサービスの URI を指定します。|  
+|findValue|文字列。  検索対象の値。|  
+|x509FindType|列挙値。  検索する証明書フィールドのいずれかです。|  
+|storeLocation|列挙値。  検索する 2 つの格納場所のいずれかです。|  
+|storeName|列挙値。  検索するシステム ストアのいずれかです。|  
+  
+## findValue 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|値は、検索されるフィールド \(X509FindType 属性により指定される\) によって異なります。  たとえば、サムプリント検索する場合、値は 16 進数の文字列にする必要があります。|  
+  
+## x509FindType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、FindByThumbprint、FindBySubjectName、FindBySubjectDistinguishedName、FindByIssuerName、FindByIssuerDistinguishedName、FindBySerialNumber、FindByTimeValid、FindByTimeNotYetValid、FindBySerialNumber、FindByTimeExpired、FindByTemplateName、FindByApplicationPolicy、FindByCertificatePolicy、FindByExtension、FindByKeyUsage、FindBySubjectKeyIdentifier です。|  
+  
+## storeLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|CurrentUser または LocalMachine です。|  
+  
+## storeName 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、AddressBook、AuthRoot、CertificateAuthority、Disallowed、My、Root、TrustedPeople、および TrustedPublisher です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<scopedCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md)|認証用の \(範囲指定された\) 特定のサービスにより提供される X.509 証明書のコレクションを表します。|  
+  
+## 解説  
+ この要素を使用すると、クライアントは、通信するサービスの URL に基づいて、使用するサービス証明書を構成できます。  これは、クライアントが複数のサービス \(エンド サービスと中間セキュリティ トークン サービス\) と通信している可能性がある発行済みトークンのシナリオで特に便利です。  証明書に基づくメッセージ セキュリティを使用したバインドにおいて、この証明書を使用してサービスへのメッセージを暗号化します。サービスがクライアントへの応答に署名する際には、この証明書を使用することが要求されます。  
+  
+ バインディングにサービスの証明書が必要で、サービスの URL に対する特定の証明書が ScopedCertificates 内に存在しない場合は、既定の証明書が使用されます。  
+  
+ 詳細については、「[方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)」の「範囲指定された証明書」セクションを参照してください。  
+  
+## 使用例  
+ 次の例は、コレクションに X.509 証明書を追加します。  
+  
+```  
+<behaviors>  
+ <endpointBehaviors>  
+  <behavior name="MyEndpointBehavior">  
+   <clientCredentials>  
+    <serviceCertificate>  
+     <scopedCertificates>  
+      <add targetUri="http://www.contoso.com"   
+       findValue="www.Contoso.com"   
+       storeLocation="LocalMachine"  
+       storeName="Root"   
+       x509FindType="FindByIssuerName" />  
+     </scopedCertificates>  
+    </serviceCertificate>  
+   </clientCredentials>  
+  </behavior>  
+ </endpointBehaviors>  
+</behaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509RecipientCertificateClientElement.ScopedCertificates%2A>   
+ <xref:System.ServiceModel.Configuration.X509ScopedServiceCertificateElementCollection>   
+ <xref:System.ServiceModel.Configuration.X509ScopedServiceCertificateElement>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A>   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-scopes.md b/docs/framework/configure-apps/file-schema/wcf/add-of-scopes.md
new file mode 100644
index 00000000000..29d269db6e9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-scopes.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;scopes&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0563a7d8-fc84-4c85-9066-af32665857c2
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;scopes&gt; の &lt;add&gt;
+クエリの実行中に、サービス エンドポイントのフィルター処理に使用できるカスタム スコープ URI を追加します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <endpointBehaviors>  
+    <behavior name="String">  
+      <endpointDiscovery enable="Boolean">  
+        <scopes>  
+          <add scope="URI"/>  
+        </scopes>  
+      </endpointDiscovery>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|スコープ|サービス検索の一致条件に使用できるエンドポイントのスコープ情報を格納する URI。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<scopes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopes.md)|クエリの実行中に、サービス エンドポイントのフィルター処理に使用できるカスタム スコープ URI を指定する構成要素のコレクションを含んでいます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-serviceactivations.md b/docs/framework/configure-apps/file-schema/wcf/add-of-serviceactivations.md
new file mode 100644
index 00000000000..b4175ef0759
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-serviceactivations.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;serviceActivations&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5b01fc8-ee84-48b7-95fd-95ab54fa871f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;serviceActivations&gt; の &lt;add&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスの種類にマップする仮想サービス アクティベーション設定を定義できる構成要素。  これにより、.svc ファイルを使用せずに、WAS\/IIS でホストされているサービスをアクティブ化できます。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>   
+   <serviceActivations>  
+      <add factory="String"  
+           service="String"/>  
+   </serviceActivations>  
+</serviceHostingEnvironment>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|factory|サービス アクティベーション要素を生成するファクトリの CLR 型名を指定する文字列。|  
+|service|サービスを実装する ServiceType \(完全修飾 Typename または省略形の Typename \(App\_Code フォルダーに配置されている場合\)\)。|  
+|relativeAddress|現在の IIS アプリケーション内の相対アドレス \(たとえば "Service.svc"\)。  WCF 4.0 ではこの相対アドレスが 1 個の既知のファイル拡張子 \(.svc、.xamlx など\) を含む必要があります。  relativeUrl 用の物理ファイルは必要ありません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceHostingEnvironment\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)|アクティベーション設定を記述する構成セクション。|  
+  
+## 解説  
+ web.config ファイルでアクティベーション設定を構成する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <serviceHostingEnvironment>  
+      <serviceActivations>  
+        <add service="GreetingService"/>  
+      </serviceActivations>  
+    </serviceHostingEnvironment>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ この構成を使用して、.svc ファイルを使用せずに、GreetingService をアクティブ化できます。  
+  
+ `<serviceHostingEnvironment>` はアプリケーション レベルの構成であることに注意してください。  構成を格納した `web.config` は、仮想アプリケーションのルートの下に配置する必要があります。  また、`serviceHostingEnvironment` は machinetoApplication の継承可能なセクションです。  コンピューターのルートに単一のサービスを登録すると、アプリケーションの各サービスはこのサービスを継承します。  
+  
+ 構成ベースのアクティベーションは、http および非 http プロトコル経由のアクティベーションをサポートします。  relatativeAddress では、  .svc、.xoml、.xamlx などの拡張子が必要です。  既知の buildProviders に対して独自の拡張子をマップできます。これにより、任意の拡張子を使用してサービスをアクティブ化できるようになります。  競合が発生した場合には、`<serviceActivations>` セクションにより、.svc の登録がオーバーライドされます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceActivationElement>   
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-services.md b/docs/framework/configure-apps/file-schema/wcf/add-of-services.md
new file mode 100644
index 00000000000..5f86be656fe
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-services.md
@@ -0,0 +1,74 @@
+---
+title: "&lt;services&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6bdc4590-aa9c-4ec8-9345-879d780cd141
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;services&gt; の &lt;add&gt;
+ワークフロー ベースの [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスをホストする <xref:System.Workflow.Runtime.WorkflowRuntime> のインスタンスの設定を指定します。  この要素は <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement> 型です。  
+  
+## 構文  
+  
+```  
+  
+<workflowRuntime>  
+   <services>  
+      <add type="String"/>  
+   </services>  
+</workflowRuntime>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|型|初期化するサービスのアセンブリ修飾型名を指定する文字列。  指定されたサービスは、そのコンストラクターのシグネチャに関して一定の規則に従う必要があります。  詳細については、「<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>」を参照してください。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<services\>](../../../../../docs/framework/configure-apps/file-schema/wcf/services-of-workflowruntime.md)|<xref:System.Workflow.Runtime.WorkflowRuntime> エンジンに追加されるサービスのコレクション。  要素は、<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement> 型です。  コレクションで指定されたサービスはワークフロー ランタイム エンジンによって初期化され、適切な <xref:System.Workflow.Runtime.WorkflowRuntime> コンストラクターが呼び出されるとワークフロー ランタイム エンジンのサービスに追加されます。  したがって、コレクションで指定されたサービスは、そのコンストラクターのシグネチャに関して一定の規則に従う必要があります。  詳細については、「<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>」を参照してください。|  
+  
+## 解説  
+ この要素で指定されたサービスはワークフロー ランタイム エンジンによって初期化され、適切な <xref:System.Workflow.Runtime.WorkflowRuntime> コンストラクターが呼び出されるとワークフロー ランタイム エンジンのサービスに追加されます。  したがって、指定されたサービスは、そのコンストラクターのシグネチャに関して一定の規則に従う必要があります。  詳細については、「<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>」を参照してください。  
+  
+## 使用例  
+  
+```  
+<serviceBehaviors>  
+   <behavior name="ServiceBehavior">  
+      <workflowRuntime name="WorkflowServiceHostRuntime"  
+                       validateOnCreate="true"  
+                       enablePerformanceCounters="true">  
+         <services>  
+             <add type="NetFx.Checkin.Scenario.WorkflowServices.WorkflowBasedServices.Common.TestPersistenceService.FilePersistenceService, NetFx.Checkin.Scenario.WorkflowServices.WorkflowBasedServices.Common"/>  
+         </services>  
+      </workflowRuntime>  
+   </behavior>  
+</serviceBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WorkflowRuntimeElement>   
+ <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>   
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ [Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-transportconfigurationtype.md b/docs/framework/configure-apps/file-schema/wcf/add-of-transportconfigurationtype.md
new file mode 100644
index 00000000000..fbe6477453b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-transportconfigurationtype.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;transportConfigurationType&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 03d79db9-571d-4534-acef-d05e5467b257
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;transportConfigurationType&gt; の &lt;add&gt;
+この要素は、特定のトランスポートの種類を識別するキーと値のペアです。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>   
+   <transportConfigurationTypes>  
+      <add name="String"  
+               transportConfigurationType="String"/>   
+   </transportConfigurationTypes>  
+</serviceHostingEnvironment>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|必須の文字列属性です。<br /><br /> トランスポートの種類を一意に識別するユーザー定義キーを含みます。|  
+|transportConfigurationType|特定のトランスポートを実装する種類を含む文字列。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transportConfigurationTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transportconfigurationtypes.md)|特定のトランスポートを実装する型のコレクション。|  
+  
+## 使用例  
+  
+```  
+<serviceHostingEnvironment>   
+   <transportConfigurationTypes>  
+      <add name="net.udp"  
+      transportConfigurationType="Microsoft.ServiceModel.Samples.Hosting.HostedUdpTransportConfiguration, UdpActivation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6fa904d2da1848d6" />   
+   </transportConfigurationTypes>  
+</serviceHostingEnvironment>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TransportConfigurationTypeElement>   
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/add-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/add-of-wcf.md
new file mode 100644
index 00000000000..df0d6b5158b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/add-of-wcf.md
@@ -0,0 +1,101 @@
+---
+title: "WCF の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c196f6d7-77f6-4266-973c-305b2b4dd8a2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;add&gt;
+ランタイムから直接出力される追跡レコードをリッスンし、追跡レコードの構成方法に従って処理を行う追跡参加要素を構成します。  これには、特定の出力 \(ファイル、コンソール、ETW など\) への書き込み、レコードの処理や集計、またはその他の必要な組み合わせが含まれます。  
+  
+ ワークフロー追跡と追跡参加要素の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>   
+   <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+   </participants>   
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|name|追跡参加要素の名前を指定する文字列。|  
+|profileName|追跡参加要素が定期受信した追跡レコードを定義する、追跡プロファイルの名前を指定する文字列。|  
+|型|追跡参加要素の型を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|追跡参加要素の一覧|  
+  
+## 解説  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+ 複数の追跡参加要素が追跡イベントを同時に使用することができます。  各追跡参加要素は、それぞれ別の追跡プロファイルと関連付けることができます。  
+  
+ 追跡レコードを ETW セッションに書き込む、標準の追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、`<diagnostics>` セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、`<add>` 要素の `profileName` 属性で定義されます。  これらが定義されると、追跡参加要素は `<etwTracking>` サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.TrackingSection>   
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehavior>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/additionalrequestparameters-element.md b/docs/framework/configure-apps/file-schema/wcf/additionalrequestparameters-element.md
new file mode 100644
index 00000000000..f42a58d1e62
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/additionalrequestparameters-element.md
@@ -0,0 +1,35 @@
+---
+title: "&lt;additionalRequestParameters&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: da8109fb-581c-48f4-b718-3bbda1edc47d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;additionalRequestParameters&gt; 要素
+追加の要求パラメーターを指定する構成要素のコレクションを含みます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.AdditionalRequestParameters%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement.AdditionalRequestParameters%2A>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/allowaccounts.md b/docs/framework/configure-apps/file-schema/wcf/allowaccounts.md
new file mode 100644
index 00000000000..e2ef2ea5f92
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/allowaccounts.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;allowAccounts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 166923a9-a8ac-478f-92f9-529d9667f3a6
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;allowAccounts&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスをホストするプロセスのユーザー アカウントを指定し、共有サービスへの接続アクセス権が付与されている構成要素のコレクションを含みます。  
+  
+ \<system.serviceModel.activation\>  
+  
+## 構文  
+  
+```  
+  
+<allowAccounts>  
+   <add securityIdentifier="String"/>  
+</allowAccounts>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|属性|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-allowaccounts.md)|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをホストし、共有サービスへの接続アクセスが付与されているプロセスのユーザー アカウントを追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<net.pipe\>](../../../../../docs/framework/configure-apps/file-schema/wcf/net-pipe.md) または[\<net.tcp\>](../../../../../docs/framework/configure-apps/file-schema/wcf/net-tcp.md)|Net Pipe または TCP 共有サービスの構成設定を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration.NetTcpSection.AllowAccounts%2A>   
+ <xref:System.ServiceModel.Activation.Configuration.NetPipeSection.AllowAccounts%2A>   
+ <xref:System.ServiceModel.Activation.Configuration.SecurityIdentifierElementCollection>   
+ <xref:System.ServiceModel.Activation.Configuration.SecurityIdentifierElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md b/docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md
new file mode 100644
index 00000000000..ed0e0224b4e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;allowedAudienceUris&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f4dc73d-d95d-4193-9755-7df4cf2b8e1c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;allowedAudienceUris&gt;
+<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI のコレクションを表します。  
+  
+## 構文  
+  
+```  
+  
+<allowedAudienceUris>  
+      <add allowedAudienceUri="String"/>  
+</allowedAudienceUris>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md)|<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)|サービス資格情報として発行されるトークンを指定します。|  
+  
+## 解説  
+ このコレクションは、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンを発行するセキュリティ トークン サービス \(STS\) を利用するフェデレーション アプリケーションで使用する必要があります。  STS がセキュリティ トークンを発行する場合、このセキュリティ トークンに <xref:System.IdentityModel.Tokens.SamlAudienceRestrictionCondition> を追加して、セキュリティ トークンの提供先となる Web サービスの URI を指定できます。  これにより、受け取り側 <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> Web サービスは、次のようにしてこのチェックが行われるように指定することで、発行されたセキュリティ トークンがこの Web サービスを対象としていることを確認できます。  
+  
+-   `<issuedTokenAuthentication>` の `audienceUriMode` 属性を <xref:System.IdentityModel.Selectors.AudienceUriMode> または <xref:System.IdentityModel.Selectors.AudienceUriMode> に設定します。  
+  
+-   このコレクションに URI を追加して、有効な URI のセットを指定します。  
+  
+ 詳細については、「<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>」を参照してください。  
+  
+ この構成要素の使用の詳細については、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement.AllowedAudienceUris%2A>   
+ <xref:System.ServiceModel.Configuration.AllowedAudienceUriElementCollection>   
+ <xref:System.ServiceModel.Configuration.AllowedAudienceUriElement>   
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.AllowedAudienceUris%2A>   
+ [\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md b/docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md
new file mode 100644
index 00000000000..54be6ef94cd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;announcementEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 034b7c69-a770-4502-8cef-38007bbcd025
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;announcementEndpoint&gt;
+この構成要素は、固定アナウンス コントラクトが設定されている標準エンドポイントを定義します。  サービスは、サービスが開いたとき、または閉じたときにオンラインおよびオフラインのアナウンス メッセージを送信することによって、その可用性をアナウンスすることもできます。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスは、[\<serviceDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicediscovery.md) 要素でアナウンス エンドポイントを指定し、AnnouncementClient を使用してアナウンスを実行します。  他のサービスからのアナウンスをリッスンしようとするクライアントは、実際に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスとして動作します。このため、[\<services\>](../../../../../docs/framework/configure-apps/file-schema/wcf/services.md) セクションに、このクライアントのアナウンス エンドポイントを構成する必要があります。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <announcementEndpoint>   
+          <standardEndpoint  
+                  discoveryVersion=”WSDiscovery11/WSDiscoveryApril2005”  
+                  maxAnnouncementDelay=”Timespan”   
+                  name="String" />   
+       </announcementEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryVersion|WS\-Discovery プロトコルの 2 つのバージョンのうち、1 つを指定する文字列。  有効値は WSDiscovery11 と WSDiscoveryApril2005 です。  この値は、<xref:System.ServiceModel.Discovery.Configuration.DiscoveryVersion> 型です。|  
+|maxAnnouncementDelay|Discovery プロトコルが Hello メッセージを送信するまでの待機時間の最大値を指定する Timespan 値。  メッセージは送信前に 0 からこの属性値の間のランダムな時間だけ待機します。  この属性はランダムな短い待機時間を設定するために使用されるもので、ネットワークが機能しなくなり、すべてのサービスが同時にオンラインに戻ったときにネットワーク ストームが発生することを防ぎます。|  
+|name|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 使用例  
+ http およびピア ネットワーク経由でアナウンス メッセージをリッスンするクライアントの例を次に示します。  
+  
+```  
+  
+<services>  
+  <service name="ServiceAnnouncementListener">  
+              <endpoint name="httpAnnouncementEndpoint"  
+                        kind="announcementEndpoint"  
+                        binding="basicHttpBinding"  
+                        address="announcements" />  
+              <endpoint name="peerNetAnnouncementEndpoint"  
+                        kind="announcementEndpoint"  
+                        binding="peerTcpBinding"  
+                        address="net.p2p://discoveryMesh/multicast"  
+                        bindingConfiguration="discoveryPeerTcpBindingConfig" />  
+  ...  
+  </service>  
+</services>  
+  
+<standardEndpoints>  
+  <announcementEndpoint>  
+     <standardEndpoint name="httpAnnouncementEndpoint"                         
+                       version="WSDiscoveryApril2005" />  
+     <standardEndpoint name="peerNetAnnouncementEndpoint"                         
+                       version="WSDiscoveryApril2005" />  
+   </announcementEndpoint>  
+</standardEndpoints>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.AnnouncementEndpoint>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md b/docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md
new file mode 100644
index 00000000000..ed954aa35c5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md
@@ -0,0 +1,118 @@
+---
+title: "&lt;clientCertificate&gt; 要素の &lt;authentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a55eea2-1826-4026-b911-b7cc9e9c8bfe
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# &lt;clientCertificate&gt; 要素の &lt;authentication&gt;
+サービスによって使用されるクライアント証明書の認証動作を指定します。  
+  
+## 構文  
+  
+```  
+  
+<authentication  
+customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+includeWindowsGroups="Boolean"  
+mapClientCertificateToWindowsAccount="Boolean"  
+revocationMode="NoCheck/Online/Offline"  
+trustedStoreLocation="CurrentUser/LocalMachine"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customCertificateValidatorType|省略可能な文字列。  カスタム型の検証に使用される型およびアセンブリです。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。|  
+|certificateValidationMode|省略可能な列挙体です。  資格情報の検証に使用されるモードのいずれかを指定します。  この属性は [System.Servicemodel.Security.X509CertificateValidationMode](assetId:///System.Servicemodel.Security.X509CertificateValidationMode?qualifyHint=False&amp;autoUpgrade=True) 型です。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。  既定値は、`ChainTrust` です。|  
+|includeWindowsGroups|省略可能なブール。  セキュリティ コンテキストに Windows グループが含まれているかどうかを指定します。  この属性を `true` に設定すると、グループ全体が拡張されるため、パフォーマンスに影響が及びます。  ユーザーが属するグループの一覧を生成する必要がない場合は、この属性を `false` に設定します。|  
+|mapClientCertificateToWindowsAcccount|ブール型。  証明書を使用してクライアントを Windows ID にマップできるかどうかを指定します。  これを行うには、Active Directory が有効である必要があります。|  
+|revocationMode|省略可能な列挙体です。  証明書失効リスト \(RCL\) のチェックに使用されるモードのいずれかです。  既定値は、`Online` です。  この値は、HTTP トランスポート セキュリティを使用する場合は無視されます。|  
+|trustedStoreLocation|省略可能な列挙体です。  2 つのシステム格納場所 \(`LocalMachine` または `CurrentUser`\) のいずれかです。  この値は、サービス証明書がクライアントにネゴシエートされるときに使用されます。  指定された格納場所の **\[信頼されたユーザー\]** ストアに対して検証が実行されます。  既定値は、`CurrentUser` です。|  
+  
+## customCertificateValidatorType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|タイプ名およびアセンブリと、タイプの検索に使用される他のデータを指定します。|  
+  
+## certificateValidationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|None、PeerTrust、ChainTrust、PeerOrChainTrust、Custom のいずれかの値にします。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## revocationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|NoCheck、Online、Offline のいずれかの値にします。  詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## trustedStoreLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`LocalMachine` または `CurrentUser` のいずれかの値にします。  既定値は、`CurrentUser` です。  クライアント アプリケーションがシステム アカウントで実行されている場合、証明書は通常 `LocalMachine` の下にあります。  クライアント アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 `CurrentUser` の下にあります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md)|サービスに対するクライアントの認証に使用する X.509 証明書を定義します。|  
+  
+## 解説  
+ `<authentication>` 要素は、<xref:System.ServiceModel.Security.X509ClientCertificateAuthentication> クラスに対応します。  この要素を使用すると、クライアントを認証する方法をカスタマイズできます。  `certificateValidationMode` 属性は、`None`、`ChainTrust`、`PeerOrChainTrust`、`PeerTrust`、または `Custom` に設定できます。  既定のレベルは `ChainTrust` に設定され、チェーンの最上位の*ルート証明機関*で終了する証明書の階層構造で各証明書を検索するよう指定します。  これは最もセキュリティで保護されているモードです。  また、値を `PeerOrChainTrust` に設定することもできます。これは、信頼されたチェーン内の証明書と共に、自己発行された証明書 \(ピア信頼\) も受け入れるよう指定します。  自己発行の資格情報は信頼された証明機関から購入したものである必要はないため、この値はクライアントとサービスの開発およびデバッグに使用されます。  クライアントを展開するときは、代わりに `ChainTrust` 値を使用します。  
+  
+ また、値を `Custom` に設定することもできます。  `Custom` 値に設定する場合は、`customCertificateValidatorType` 属性を、証明書の検証に使用するアセンブリと型に設定する必要もあります。  独自のカスタム検証を作成するには、抽象 <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスを継承する必要があります。  詳細については、「[方法 : カスタム証明書検証を使用するサービスを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードは、`<authentication>` 要素の X.509 証明書とカスタム検証タイプを指定します。  
+  
+```  
+<serviceBehaviors>  
+ <behavior name="myServiceBehavior">  
+  <clientCertificate>  
+   <certificate   
+         findValue="www.cohowinery.com"   
+         storeLocation="CurrentUser"   
+         storeName="TrustedPeople"  
+         x509FindType="FindByIssuerName" />  
+   <authentication customCertificateValidatorType="MyTypes.Coho"  
+    certificateValidationMode="Custom"   
+    revocationMode="Offline"  
+    includeWindowsGroups="false"   
+    mapClientCertificateToWindowsAccount="true" />  
+  </clientCertificate>  
+ </behavior>  
+</serviceBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication>   
+ <xref:System.ServiceModel.Security.X509CertificateValidationMode>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.Authentication%2A>   
+ <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement.Authentication%2A>   
+ <xref:System.ServiceModel.Configuration.X509ClientCertificateAuthenticationElement>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [方法 : カスタム証明書検証を使用するサービスを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md b/docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md
new file mode 100644
index 00000000000..b5b70338555
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md
@@ -0,0 +1,110 @@
+---
+title: "&lt;serviceCertificate&gt; 要素の &lt;authentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 733b67b4-08a1-4d25-9741-10046f9357ef
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;serviceCertificate&gt; 要素の &lt;authentication&gt;
+SSL\/TLS ネゴシエーションを使用して取得されたサービス証明書を認証するためにクライアント プロキシが使用する設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<authentication customCertificateValidatorType="String" certificateValidationMode="None/PeerTrust/ChainTrust/PeerOrChainTrust/Custom"  
+revocationMode="NoCheck/Online/Offline"   
+trustedStoreLocation="LocalMachine/CurrentUser" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customCertificateValidatorType|文字列。  カスタム型の検証に使用される型およびアセンブリです。|  
+|certificateValidationMode|資格情報の検証に使用される 3 つのモードのいずれかを指定します。  `Custom` に設定されている場合、customCertificateValidator も指定する必要があります。  既定値は、`ChainTrust` です。|  
+|revocationMode|証明書失効リスト \(CRL\) のチェックに使用されるモードのいずれかです。  既定値は、`Online` です。|  
+|trustedStoreLocation|2 つのシステム格納場所 \(`LocalMachine` または `CurrentUser`\) のいずれかです。  この値は、サービス証明書がクライアントにネゴシエートされるときに使用されます。  指定された格納場所の **\[信頼されたユーザー\]** ストアに対して検証が実行されます。  既定値は、`CurrentUser` です。|  
+  
+## customCertificateValidator 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|タイプ名およびアセンブリと、タイプの検索に使用される他のデータを指定します。|  
+  
+## certificateValidationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|None、PeerTrust、ChainTrust、PeerOrChainTrust、Custom のいずれかの値にします。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## revocationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|NoCheck、Online、Offline のいずれかの値にします。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## trustedStoreLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|LocalMachine または CurrentUser のいずれかの値。  既定値は CurrentUser です。  クライアント アプリケーションがシステム アカウントで実行されている場合、証明書は通常 LocalMachine の下にあります。  クライアント アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 CurrentUser の下にあります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md)|クライアントに対してサービスを認証する際に使用される証明書を指定します。|  
+  
+## 解説  
+ この構成要素の `certificateValidationMode` 属性は、証明書の認証に使用される信頼レベルを指定します。  既定のレベルは `ChainTrust` に設定され、チェーンの最上位の信頼された証明機関で終了する証明書の階層構造で各証明書を検索するよう指定します。  これは最もセキュリティで保護されているモードです。  また、値を `PeerOrChainTrust` に設定することもできます。これは、信頼されたチェーン内の証明書と共に、自己発行された証明書 \(ピア信頼\) も受け入れるよう指定します。  自己発行の資格情報は信頼された証明機関から購入したものである必要はないため、この値はクライアントとサービスの開発およびデバッグに使用されます。  クライアントを展開するときは、代わりに `ChainTrust` 値を使用します。  値を `Custom` または `None` に設定することもできます。  `Custom` 値を使用するには、`customCertificateValidator` 属性を証明書の検証に使用するアセンブリと型に設定することも必要です。  独自のカスタム検証を作成するには、抽象 X509CertificateValidator クラスを継承する必要があります。  詳細については、「[方法 : カスタム証明書検証を使用するサービスを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)」を参照してください。  
+  
+ `revocationMode` 属性は、証明書が失効していないかどうかをチェックする方法を指定します。  既定値は `online` です。この場合、証明書が失効していないかどうかを自動的にチェックします。  詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、2 つのタスクを実行します。  最初は、ドメイン名が www.contoso.com であるエンドポイントと HTTPプロトコルを経由して通信するときに使用するクライアントのサービス証明書を指定します。  次に、認証中に使用される失効モードとストアの場所を指定します。  
+  
+```  
+<serviceCertificate>  
+  <defaultCertificate findValue="www.contoso.com"   
+                      storeLocation="LocalMachine"  
+                      storeName="TrustedPeople"   
+                      x509FindType="FindByIssuerDistinguishedName" />  
+  <scopedCertificates>  
+     <add targetUri="http://www.contoso.com"   
+          findValue="www.contoso.com" storeLocation="LocalMachine"  
+                  storeName="Root" x509FindType="FindByIssuerName" />  
+  </scopedCertificates>  
+  <authentication revocationMode="Online"   
+   trustedStoreLocation="LocalMachine" />  
+</serviceCertificate>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509RecipientCertificateClientElement>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.Authentication%2A>   
+ <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : カスタム証明書検証を使用するサービスを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)   
+ [\<authentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/authorizationpolicies.md b/docs/framework/configure-apps/file-schema/wcf/authorizationpolicies.md
new file mode 100644
index 00000000000..65d30e960df
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/authorizationpolicies.md
@@ -0,0 +1,33 @@
+---
+title: "&lt;authorizationPolicies&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b367489-54d7-408b-8f56-cb157dd68eaf
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;authorizationPolicies&gt;
+この構成セクションには、`add` キーワードを使用して追加できる承認ポリシーの種類のコレクションが含まれています。  各承認ポリシーは、文字列の単一の必須属性 `policyType` を含みます。  この属性は、入力クレームのセットをクレームの別のセットに変換することを可能にする承認ポリシーを指定します。  アクセス制御は、それに基づいて許可または拒否されます。  認証ポリシーの動作の詳細については、「<xref:System.IdentityModel.Policy.IAuthorizationPolicy>」および「[承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceAuthorizationElement>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ExternalAuthorizationPolicies%2A>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>   
+ <xref:System.ServiceModel.Configuration.AuthorizationPolicyTypeElement>   
+ <xref:System.ServiceModel.Configuration.ServiceAuthorizationElement.AuthorizationPolicies%2A>   
+ <xref:System.ServiceModel.Configuration.AuthorizationPolicyTypeElementCollection>   
+ <xref:System.IdentityModel.Policy.IAuthorizationPolicy>   
+ [サービス操作へのアクセスの承認](../../../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)   
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-authorizationpolicies.md)   
+ [承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/backuplist.md b/docs/framework/configure-apps/file-schema/wcf/backuplist.md
new file mode 100644
index 00000000000..8492f79cdcd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/backuplist.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;backupList&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3d9d1f9-4a53-45e9-a880-86c8bee0b833
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 1
+---
+# &lt;backupList&gt;
+プライマリ エンドポイントに接続できないときにルーティング サービスで使用するエンドポイント セットを列挙したバックアップ リストを定義するための構成セクションを表します。リストの最初のエンドポイントがダウンしていると、ルーティング サービスは自動的にリスト内で次にあるエンドポイントにフェールオーバーします。これにより、クライアント アプリケーションに複雑なパターンの処理方法やサービスの配置場所を示すことなく、アプリケーションの信頼性を高めることができます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+  <backupLists>  
+    <backupList name="String">  
+      <add endpointName="String" />  
+    </backupList>    
+  </backupLists>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|このエンドポイント リストを指定するために使用される名前を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filter.md)||  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|バックアップ エンドポイントの一覧。|  
+  
+## 解説  
+ このセクションには、プライマリ エンドポイントへの送信時に通信例外が発生した場合にメッセージが送信されるエンドポイントの、順序付けられたコレクションが含まれます。  
+  
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-entries.md) の `endpointName` 属性に一覧表示されたプライマリ エンドポイントへの送信が通信例外によって失敗した場合、ルーティング サービスはこのセクションに格納された最初のエンドポイントにメッセージを送信しようとします。  これも通信例外によって失敗した場合、ルーティング サービスは、送信に成功するか、通信例外以外のエラーを返すか、コレクション内のすべてのエンドポイントがエラーを返すまで、このセクションに格納された次のエンドポイントにメッセージを送信しようとします。  
+  
+ 次の例では、"Destination" という名前のプライマリ エンドポイントへの送信で通信例外が返された場合、サービスは "alternateServiceQueue" にメッセージを送信しようとします。  この試行でも通信例外が返された場合、ルーティング サービスはコレクション内の次のエンドポイントにメッセージを送信しようとします。  
+  
+```  
+  
+<filterTables>  
+     <filterTable name="filterTable1">  
+          <add filterName="MatchAllFilter1" endpointName="Destination" backupList="backupEndpointList"/>  
+     </filterTable>  
+</filterTables>  
+<backupLists>  
+     <backupList name="backupEndpointList">  
+          <add endpointName="backupServiceQueue" />  
+          <add endpointName="alternateServiceQueue" />  
+     </backupList>  
+</backupLists>  
+```  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.BackupEndpointCollection](assetId:///System.ServiceModel.Routing.Configuration.BackupEndpointCollection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/backuplists.md b/docs/framework/configure-apps/file-schema/wcf/backuplists.md
new file mode 100644
index 00000000000..a48d04f1ed4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/backuplists.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;backupLists&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 593b3390-f65b-4684-ad40-0596b62f0954
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;backupLists&gt;
+エラー処理に使用されるバックアップ サービス セットを定義する構成セクションを表します。  各子要素は、プライマリ エンドポイントに接続できないときにルーティング サービスが使用するエンドポイント セットを列挙するバックアップ リストです。リストの最初のエンドポイントがダウンしていると、ルーティング サービスは自動的にリスト内で次にあるエンドポイントにフェールオーバーします。これにより、クライアント アプリケーションに複雑なパターンの処理方法やサービスの配置場所を示すことなく、アプリケーションの信頼性を高めることができます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+  <backupLists>  
+    <backupList name="String">  
+      <add endpointName="String" />  
+    </backupList>    
+  </backupLists>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filter.md)|プライマリ エンドポイントに接続できないときにルーティング サービスが使用するエンドポイントのリストを格納します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルター セットと、フィルターが一致するときにメッセージを送信するターゲット エンドポイントを指定するルーティング テーブルを定義する構成セクションを表します。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.BackupListCollection](assetId:///System.ServiceModel.Routing.Configuration.BackupListCollection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/baseaddresses.md b/docs/framework/configure-apps/file-schema/wcf/baseaddresses.md
new file mode 100644
index 00000000000..cb3a92ffa9c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/baseaddresses.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;baseAddresses&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78918102-2898-46e0-9ea8-6b8afe65603e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;baseAddresses&gt;
+自己ホスト環境でのサービス ホストのベース アドレスである `baseAddress` 要素のコレクションを表します。  ベース アドレスが存在すると、そのベース アドレスに関連したアドレスを使用してエンドポイントを構成できます。  
+  
+## 構文  
+  
+```  
+  
+<baseAddresses>  
+   <add baseAddress="string" />  
+</baseAddresses>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-baseaddresses.md)|サービス ホストによって使用されるベース アドレスを指定する構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<host\>](../../../../../docs/framework/configure-apps/file-schema/wcf/host.md)|サービス ホストの設定を指定する構成要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HostElement>   
+ <xref:System.ServiceModel.ServiceHost>   
+ <xref:System.ServiceModel.ServiceHostBase.BaseAddresses%2A>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md b/docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md
new file mode 100644
index 00000000000..bed6a2f7cda
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;baseAddressPrefixFilters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8cab2a9a-c51f-4283-bb60-2ad0c274fd46
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;baseAddressPrefixFilters&gt;
+パス スルー フィルターを指定する構成要素のコレクションを表します。パス スルー フィルターには、インターネット インフォメーション サービス \(IIS\) で [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションをホストする場合に適切な IIS バインドを選択する機構が用意されています。  
+  
+> [!WARNING]
+>  \<baseAddressPrefixFilters\> は localhost を認識しません。代わりに、コンピューターの完全修飾名を使用します。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>  
+     <baseAddressPrefixFilters>  
+        <add prefix="string"/>  
+     </baseAddressPrefixFilters>  
+</serviceHostingEnvironment>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-baseaddressprefixfilter.md)|サービス ホストによって使用されるベース アドレスのプレフィックス フィルターを指定する構成要素を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceHostingEnvironment\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)|環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。|  
+  
+## 解説  
+ プレフィックス フィルターは、サービスによって使用される URI を、共有ホスティング プロバイダーが指定できるようにする手段を提供します。  これにより、共有ホストは、同じサイト上の同じスキームに対して、別々のベース アドレスを使用して複数のアプリケーションをホストできるようになります。  
+  
+ IIS Web サイトは、仮想ディレクトリを含む仮想アプリケーションのコンテナーです。  サイト内のアプリケーションには、1 つ以上の IIS バインディングからアクセスできます。  IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。  バインディング プロトコル \(HTTP など\) は通信を行うスキームを定義し、バインディング情報 \(IP アドレス、ポート、ホスト ヘッダーなど\) にはサイトにアクセスするために使用するデータが含まれます。  
+  
+ IIS では、サイトごとに複数の IIS バインディングを指定できるので、各スキームに複数のベース アドレスが定義されることがあります。  これに対して、サイトでホストされる [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスでは、スキームごとに 1 つのベース アドレスにしかバインドできません。そこで、プレフィックス フィルター機能を使用すると、ホストされるサービスの必要なベース アドレスを選択できます。  IIS によって指定される受信ベース アドレスは、オプションのプレフィックス リスト フィルターに基づいてフィルター処理されます。  
+  
+ たとえば、サイトに次のベース アドレスが含まれているとします。  
+  
+```  
+http://testl.fabrikam.com/Service.svc  
+http://test2.fabrikam.com/Service.svc  
+```  
+  
+ 次の構成ファイルを使用して、appdomain レベルでプレフィックス フィルターを指定できます。  
+  
+```  
+<system.serviceModel>  
+  <serviceHostingEnvironment>  
+     <baseAddressPrefixFilters>  
+        <add prefix=”net.tcp://test1.fabrikam.com:8000”/>  
+        <add prefix=”http://test2.fabrikam.com:9000”/>  
+    </baseAddressPrefixFilters>  
+  </serviceHostingEnvironment>  
+</system.serviceModel>  
+```  
+  
+ この例では、`net.tcp://test1.fabrikam.com:8000` と `http://test2.fabrikam.com:9000` が、対応するスキームに渡される唯一のベース アドレスです。  
+  
+ 既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。  プレフィックスだけを指定すると、そのスキームに一致するベース アドレスを渡すことができます。  
+  
+> [!NOTE]
+>  フィルターでワイルドカードはサポートされません。  また、IIS が提供する baseAddresses には、`baseAddressPrefixFilters` リストに存在しない他のスキームにバインドされたアドレスが指定される場合があります。  これらのアドレスはフィルターで除外されません。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BaseAddressPrefixFilterElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md
new file mode 100644
index 00000000000..7c54b3a32c0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md
@@ -0,0 +1,198 @@
+---
+title: "&lt;basicHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "basicHttpBinding 要素"
+ms.assetid: 85cf1a4f-26c2-48c7-bda6-6c960d5d3fb3
+caps.latest.revision: 43
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 43
+---
+# &lt;basicHttpBinding&gt;
+ASMX ベースの Web サービスとクライアント、および WS\-I Basic Profile 1.1 に準拠するその他のサービスと通信できるエンドポイントを構成および公開するために [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスが使用できるバインディングを表します。  
+  
+## 構文  
+  
+```  
+  
+<basicHttpBinding>  
+   <binding   
+       allowCookies="Boolean"  
+       bypassProxyOnLocal="Boolean"  
+       closeTimeout="TimeSpan"   
+       envelopeVersion="None/Soap11/Soap12"  
+       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+       maxBufferPoolSize="Integer"  
+       maxBufferSize="Integer"  
+       maxReceivedMessageSize="Integer"  
+       messageEncoding="Text/Mtom"  
+              name="string"   
+       openTimeout="TimeSpan"   
+       proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan"  
+              textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+              transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+       useDefaultWebProxy="Boolean"  
+       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">  
+           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"  
+                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"  
+                                    realm="string" />  
+           <message   
+                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                            clientCredentialType="UserName/Certificate"/>  
+       </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"      
+            maxStringContentLength="Integer" />  
+   </binding>  
+</basicHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowCookies`|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> インターネット リソースは、ローカル アドレスを持つ場合ローカルです。  ローカル アドレスは、同じコンピューター、ローカル LAN、またはイントラネット上にあり、"http:\/\/webserver\/"、"http:\/\/localhost\/" などのピリオド \(.\) を含まない URI により構文的に識別されるアドレスです。<br /><br /> この属性の設定は、BasicHttpBinding で構成されたエンドポイントがローカル リソースへのアクセス時にプロキシ サーバーを使用するかどうかを示します。  この属性が `true` の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。  この属性を `true` に設定した場合で、同じコンピューター上のサービスと対話するクライアントがプロキシを経由するときは、\(localhost ではなく\) ホスト名を使用します。<br /><br /> この属性が `false` の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`envelopeVersion`|このバインディングによって処理されるメッセージに使用される SOAP のバージョンを指定します。  有効値は、Soap11 のみです。|  
+|`hostnameComparisonMode`|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる、最大メモリ量を指定する整数値。  既定値は 524288 \(0x80000\) バイトです。<br /><br /> バッファー マネージャーは、バッファー プールを使用することで、バッファーの使用コストを最小化します。  バッファーは、チャネルから出てくるメッセージをサービスが処理するときに必要です。  メッセージの読み込み処理に十分なメモリがバッファー プールにない場合、バッファー マネージャーは、CLR ヒープから追加のメモリを割り当てる必要があります。これにより、ガベージ コレクションのオーバーヘッドが増加します。  CLR ガベージ ヒープから多大な割り当てが行われることは、バッファー プール サイズが小さすぎること、およびこの属性で指定される制限を緩めて割り当てを増やすとパフォーマンスが向上する可能性があることを示します。|  
+|`maxBufferSize`|このバインディングで構成されるエンドポイントのメッセージが処理されるときのメッセージを格納するバッファーの最大サイズを指定する整数値 \(バイト単位\)。  既定値は 65,536 バイトです。|  
+|`maxReceivedMessageSize`|このバインディングで構成されるチャネルが受信可能なメッセージの最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数。  受信側のメッセージが大きすぎると、送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65,536 バイトです。|  
+|`messageEncoding`|SOAP メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。  この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`namespace`|バインディングの XML 名前空間を指定します。  既定値は "http:\/\/tempuri.org\/Bindings" です。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`proxyAddress`|HTTP プロキシのアドレスを格納する URI。  `useSystemWebProxy` が `true` に設定されている場合、この設定は `null` である必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`transferMode`|要求または応答に対してメッセージがバッファーされるか、ストリーム配信されるかを指定する有効な <xref:System.ServiceModel.TransferMode> 値。|  
+|`useDefaultWebProxy`|使用できる場合にシステムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ BasicHttpBinding では、SOAP 1.1 メッセージを送信するために、HTTP をトランスポートとして使用します。  サービスは、ASMX クライアントが消費するエンドポイントなど、WS\-I BP 1.1 に準拠するエンドポイントを開示するためにこのバインディングを使用できます。  同様に、クライアントは BasicHttpBinding を使用して、ASMX Web サービスや BasicHttpBinding で構成されるサービスなどの WS\-I BP 1.1 に準じるエンドポイントを公開するサービスと通信できます。  
+  
+ 既定ではセキュリティは無効になります。ただし、[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)`None 子要素のモード属性に`  以外の値を設定してセキュリティを追加できます。  サービスは、"Text" メッセージ エンコードおよび UTF\-8 テキスト エンコードを既定で使用します。  
+  
+## 使用例  
+ 第 1 世代と第 2 世代の Web サービスで HTTP 通信と最大限の相互運用性を実現する、<xref:System.ServiceModel.BasicHttpBinding> の使用例を次に示します。  バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、`<endpoint>` 要素の `binding` 属性を使用して指定します。  基本的なバインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、`<endpoint>` 要素の `bindingConfiguration` 属性を使用して、名前でバインディング構成を参照する必要があります。次のサービスの構成コードを参照してください。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="basicHttpBinding"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <basicHttpBinding>  
+        <binding name="Binding1"   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Text"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </basicHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+## 使用例  
+ [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  前の例の機能を実行するには、エンドポイント アドレスの bindingConfiguration とバインディングの名前を削除します。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="basicHttpBinding"  
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <basicHttpBinding>  
+        <binding   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Text"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </basicHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+  
+```  
+  
+ 既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/basichttpcontextbinding.md b/docs/framework/configure-apps/file-schema/wcf/basichttpcontextbinding.md
new file mode 100644
index 00000000000..8c3278792e8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/basichttpcontextbinding.md
@@ -0,0 +1,114 @@
+---
+title: "&lt;basicHttpContextBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 39b16b82-4ec6-4eff-8031-67e026870961
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;basicHttpContextBinding&gt;
+HTTP クッキーを交換機構として有効にすることにより、交換する <xref:System.ServiceModel.BasicHttpBinding> のコンテキストを提供するバインディングを指定します。  
+  
+## 構文  
+  
+```  
+  
+<basicHttpContextBinding>  
+   <binding   
+       allowCookies="Boolean"  
+       bypassProxyOnLocal="Boolean"  
+       closeTimeout="TimeSpan"   
+       envelopeVersion="None/Soap11/Soap12"  
+       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+       maxBufferPoolSize="Integer"  
+       maxBufferSize="Integer"  
+       maxReceivedMessageSize="Integer"  
+       messageEncoding="Text/Mtom"  
+       name="string"   
+       openTimeout="TimeSpan"   
+       proxyAddress="URI"  
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan"  
+       textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+       transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+       useDefaultWebProxy="Boolean"  
+       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">  
+           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"  
+                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"  
+                                    realm="string" />  
+           <message  algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"  
+                                    clientCredentialType="UserName/Certificate"/>  
+       </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+   </binding>  
+</basicHttpContextBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowCookies`|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> インターネット リソースは、ローカル アドレスを持つ場合ローカルです。  ローカル アドレスは、同じコンピューター、ローカル LAN、またはイントラネット上にあり、"http:\/\/webserver\/"、"http:\/\/localhost\/" などのピリオド \(.\) を含まない URI により構文的に識別されるアドレスです。<br /><br /> この属性の設定は、BasicHttpBinding で構成されたエンドポイントがローカル リソースへのアクセス時にプロキシ サーバーを使用するかどうかを示します。  この属性が `true` の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。  この属性を `true` に設定した場合で、同じコンピューター上のサービスと対話するクライアントがプロキシを経由するときは、\(localhost ではなく\) ホスト名を使用します。<br /><br /> この属性が `false` の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`envelopeVersion`|このバインディングによって処理されるメッセージに使用される SOAP のバージョンを指定します。  有効値は、Soap11 のみです。|  
+|`hostnameComparisonMode`|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる、最大メモリ量を指定する整数値。  既定値は 524288 \(0x80000\) バイトです。<br /><br /> バッファー マネージャーは、バッファー プールを使用することで、バッファーの使用コストを最小化します。  バッファーは、チャネルから出てくるメッセージをサービスが処理するときに必要です。  メッセージの読み込み処理に十分なメモリがバッファー プールにない場合、バッファー マネージャーは、CLR ヒープから追加のメモリを割り当てる必要があります。これにより、ガベージ コレクションのオーバーヘッドが増加します。  CLR ガベージ ヒープから多大な割り当てが行われることは、バッファー プール サイズが小さすぎること、およびこの属性で指定される制限を緩めて割り当てを増やすとパフォーマンスが向上する可能性があることを示します。|  
+|`maxBufferSize`|このバインディングで構成されるエンドポイントのメッセージが処理されるときのメッセージを格納するバッファーの最大サイズを指定する整数値 \(バイト単位\)。  既定値は 65,536 バイトです。|  
+|`maxReceivedMessageSize`|このバインディングで構成されるチャネルが受信可能なメッセージの最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数。  受信側のメッセージが大きすぎると、送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65,536 バイトです。|  
+|`messageEncoding`|SOAP メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。  この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`messageVersion`|バインディングで構成されるクライアントとサービスが使用するメッセージ バージョンを指定します。  この属性は <xref:System.ServiceModel.Channels.MessageVersion> 型です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`namespace`|バインディングの XML 名前空間を指定します。  既定値は "http:\/\/tempuri.org\/Bindings" です。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`proxyAddress`|HTTP プロキシのアドレスを格納する URI。  `useSystemWebProxy` が `true` に設定されている場合、この設定は `null` である必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`transferMode`|要求または応答に対してメッセージがバッファーされるか、ストリーム配信されるかを指定する有効な <xref:System.ServiceModel.TransferMode> 値。|  
+|`useDefaultWebProxy`|使用できる場合にシステムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ このバインディング要素は、`BasicHttpBinding` のコンテキストの一部として保護レベルと交換機構を提供します。  
+  
+## 参照  
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.BasicHttpContextBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpContextBindingElement>   
+ <xref:System.ServiceModel.Channels.ContextBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md b/docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md
new file mode 100644
index 00000000000..c8f8bcc7930
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;endpointBehaviors&gt; の &lt;behavior&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: b90ca3bc-3c22-4174-b903-e3a39898bd27
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# &lt;endpointBehaviors&gt; の &lt;behavior&gt;
+エンドポイントの動作設定のコレクションを含む `behavior` 要素。  各動作には、それぞれの `name` によってインデックスが付けられます。  エンドポイントは、この名前を使用して各動作にリンクできます。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<system.ServiceModel>  
+  <behaviors>  
+    <endpointBehaviors>  
+       <behavior name="String" />  
+    </endpointBehaviors>  
+  </behaviors>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|動作の構成名を含む一意の文字列。  この値は、要素の識別文字列として機能するため、一意のユーザー定義の文字列である必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+|[\<callbackDebug\>](../../../../../docs/framework/configure-apps/file-schema/wcf/callbackdebug.md)|[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] コールバック オブジェクトのサービス デバッグを指定します。|  
+|[\<callbackTimeouts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/callbacktimeouts.md)|クライアント コールバックのタイムアウトを指定します。|  
+|[\<clientVia\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientvia.md)|メッセージの経路を指定します。|  
+|[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer.md)|DataContractSerializer 用の構成データが含まれています。|  
+|[\<dispatcherSynchronization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/dispatchersynchronization.md)|サービスが非同期に応答を返すことができるようにするエンドポイントの動作を指定します。|  
+|[\<enableWebScript\>](../../../../../docs/framework/configure-apps/file-schema/wcf/enablewebscript.md)|ASP.NET AJAX Web ページからサービスを使用できるようにするエンドポイントの動作を有効にします。  この動作は、必ず \<webHttpBinding\> 標準バインディングまたは \<webMessageEncoding\> バインディング要素と組み合わせて使用する必要があります。|  
+|[\<endpointDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpointdiscovery.md)|エンドポイントのさまざまな探索設定を指定します \(探索可能性、スコープ、メタデータに対するカスタム拡張など\)。|  
+|[\<soapProcessing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/soapprocessing.md)|異なるバインディングの種類およびメッセージ バージョンの間でメッセージのマーシャリングに使用されるクライアント エンドポイントの動作を定義します。|  
+|[\<synchronousReceive\>](../../../../../docs/framework/configure-apps/file-schema/wcf/synchronousreceive-element.md)|サービスまたはクライアント アプリケーションでメッセージを受信する場合のランタイム動作を指定します。  属性や子要素はありません。|  
+|[\<transactedBatching\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transactedbatching.md)|受信操作でトランザクション バッチがサポートされるかどうかを指定します。|  
+|[\<webHttp\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttp.md)|構成によってエンドポイントに WebHttpBehavior を指定します。  この動作を \<webHttpBinding\> 標準バインディングと組み合わせて使用すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの Web プログラミング モデルが有効になります。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpointBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md)|エンドポイント動作要素のコレクション。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md b/docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md
new file mode 100644
index 00000000000..0cf0461d163
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;serviceBehaviors&gt; の &lt;behavior&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78fc0a08-55de-416a-ac12-a5e6ffc9a987
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;serviceBehaviors&gt; の &lt;behavior&gt;
+`behavior` 要素には、サービスの動作設定のコレクションが含まれます。  各動作には、それぞれの `name` によってインデックスが付けられます。  サービスは、[\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md) 要素の `behaviorConfiguration` 属性を使用して、この名前で各動作にリンクできます。  これにより、設定を再定義することなく、エンドポイント間で共通の動作構成を共有できます。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  Windows Workflow アクティビティに固有の動作要素 \([\<sendMessageChannelCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md) 要素など\) については、「[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)」のページを参照してください。  
+  
+## 構文  
+  
+```  
+  
+<system.ServiceModel>  
+  <behaviors>  
+    <serviceBehaviors>  
+       <behavior name="String" />  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|動作の構成名を含む一意の文字列。  この値は、要素の識別文字列として機能するため、一意のユーザー定義の文字列である必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)|DataContractSerializer 用の構成データが含まれています。|  
+|[\<persistenceProvider\>](../../../../../docs/framework/configure-apps/file-schema/wcf/persistenceprovider.md)|使用する永続化プロバイダーの実装の型と、永続化操作に使用するタイムアウトを指定します。|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md)|ルーティング構成の動的な変更を可能にするルーティング サービスへの実行時アクセスを提供します。|  
+|[\<serviceAuthenticationManager\>](../../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthenticationmanager.md)|サービス レベルで転送、メッセージ、または送信元の有効性を確立するワークフロー構成要素を提供します。|  
+|[\<serviceAuthorization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)|サービス操作へのアクセスを承認する設定を指定します。|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+|[\<serviceDebug\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicedebug.md)|[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスのデバッグおよびヘルプ情報機能を指定します。|  
+|[\<serviceDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicediscovery.md)|サービス エンドポイントの探索可能性を指定します。|  
+|[\<serviceMetadata\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicemetadata.md)|サービス メタデータと関連情報の公開を指定します。|  
+|[\<serviceSecurityAudit\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md)|サービス操作中にセキュリティ イベントの監査を有効にする設定を指定します。|  
+|[\<serviceThrottling\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicethrottling.md)|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの調整機構を指定します。|  
+|[\<serviceTimeouts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicetimeouts.md)|サービスのタイムアウトを指定します。|  
+|[\<workflowRuntime\>](../../../../../docs/framework/configure-apps/file-schema/wcf/workflowruntime.md)|ワークフロー ベースの [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをホストするための WorkflowRuntime のインスタンスの設定を指定します。|  
+|[\<useRequestHeadersForMetadataAddress\>](../../../../../docs/framework/configure-apps/file-schema/wcf/userequestheadersformetadataaddress.md)|メタデータのアドレス情報を要求メッセージ ヘッダーから取得できるようにします。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md)|サービス動作要素のコレクション。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/behaviorextensions.md b/docs/framework/configure-apps/file-schema/wcf/behaviorextensions.md
new file mode 100644
index 00000000000..fba8540bea8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/behaviorextensions.md
@@ -0,0 +1,58 @@
+---
+title: "&lt;behaviorExtensions&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 59f2791a-c78f-40d7-aa80-0d9cd10135d9
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;behaviorExtensions&gt;
+動作の拡張により、ユーザーはユーザー定義の動作要素を作成できます。  これらの要素は、標準の Windows Communication Foundation \(WCF\) 動作要素と共に使用できます。  `behaviorExtensions` セクションでは、構成で使用できるように要素を定義します。  次の例は、一般的な動作拡張を示します。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+        <behaviorExtensions>  
+            <add name="myBehavior" type="Microsoft.ServiceModel.Samples.MyBehaviorSection, MyBehavior,  
+                Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+       </behaviorExtensions>  
+    </extensions>  
+</system.serviceModel>  
+```  
+  
+ 構成機能を要素に追加するには、構成要素を記述して登録する必要があります。  詳細については、<xref:System.Configuration> を参照してください。  
+  
+ 要素とその構成の型を定義したら、次の例に示すように拡張を使用できます。  
+  
+```  
+<behaviors>  
+    <behavior configurationName="testChannelBehavior">  
+        <myBehavior />  
+        <channelSecurity cacheCookies="false" detectReplays="false" maxCachedNonces="9"  
+            maxClockSkew="00:00:03" maxCookieCachingTime="00:07:24" replayWindow="00:07:22.2190000" />  
+    </behavior>  
+</behaviors>  
+```  
+  
+## セキュリティ  
+ `machine.config` ファイルと `app.config` ファイルに型を登録する場合は、完全修飾アセンブリ名の使用を強くお勧めします。  型が一意に定義されていない場合、CLR 型ローダーは次の場所を指定された順序で検索します。  
+  
+ 型のアセンブリが判明している場合、ローダーは構成ファイルのリダイレクトの場所、GAC、構成情報を使用する現在のアセンブリ、およびアプリケーションの基本ディレクトリを検索します。  アセンブリが判明していない場合、ローダーは現在のアセンブリ、mscorlib、および `TypeResolve` イベント ハンドラーによって返される場所を検索します。  この CLR 検索順序は、Type Forwarding 機構や AppDomain.TypeResolve イベントなどのフックを使用して変更できます。  
+  
+ 攻撃者が CLR 検索順序を悪用して、未承認のコードを実行する可能性があります。  \(厳密な\) 完全修飾名を使用すると、型が一意に識別され、システムのセキュリティがさらに強化されます。  
+  
+ 詳細については、「[ランタイムがアセンブリを検索する方法](http://go.microsoft.com/fwlink/?LinkId=95336)」および「<xref:System.AppDomain.TypeResolve>」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BehaviorExtensionElement>   
+ [動作を使用したランタイムの構成と拡張](../../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/behaviors.md b/docs/framework/configure-apps/file-schema/wcf/behaviors.md
new file mode 100644
index 00000000000..f32fa2d69cf
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/behaviors.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;behaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e5da4e6-1aa5-466c-924e-f10efee57f0b
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;behaviors&gt;
+この要素は、`endpointBehaviors` と`serviceBehaviors` という 2 つの子コレクションを定義します。  各コレクションは、エンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。  各動作要素は、その一意の `name` 属性で識別されます。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+ \<system.ServiceModel\>  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+   <serviceBehaviors>  
+   </serviceBehaviors>  
+   <endpointBehaviors>  
+   </endpointBehaviors>  
+</behaviors>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpointBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md)|この構成セクションは、特定のエンドポイントに対して定義されたすべての動作を表します。|  
+|[\<serviceBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md)|この構成セクションは、特定のサービスに対して定義されたすべての動作を表します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)|すべての Windows Communication Foundation \(WCF\) 構成要素のルート要素です。|  
+  
+## 解説  
+ `<remove>` 要素を使用して、コレクションから特定の動作を削除できます。  これを行うには、`<remove>` 要素の `name` 属性に、削除する動作の名前を指定します。  また、`<clear>` 要素を使用してコレクションの内容をすべて消去し、動作コレクションの初期値を確実に空にすることもできます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BehaviorsSection>   
+ <xref:System.ServiceModel.Configuration.EndpointBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.EndpointBehaviorElement>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElement>   
+ [動作を使用したランタイムの構成と拡張](../../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)   
+ [クライアントの動作の構成](../../../../../docs/framework/wcf/configuring-client-behaviors.md)   
+ [クライアントのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-client-run-time-behavior.md)   
+ [サービスのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-service-run-time-behavior.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/binarymessageencoding.md b/docs/framework/configure-apps/file-schema/wcf/binarymessageencoding.md
new file mode 100644
index 00000000000..a1b3bfc6318
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/binarymessageencoding.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;binaryMessageEncoding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: e4ae3cd4-6b67-4ce1-af4b-9400e0a38dba
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;binaryMessageEncoding&gt;
+ネットワーク上で Windows Communication Foundation \(WCF\) メッセージをバイナリにエンコードするバイナリ メッセージ エンコーダーを定義します。  
+  
+## 構文  
+  
+```  
+  
+<binaryMessageEncoding   
+      maxReadPoolSize="Integer"  
+   maxSessionSize="Integer"   
+   maxWritePoolSize="Integer"  
+   messageVersion="Soap11Addressing10/Soap12Addressing10” />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|maxReadPoolSize|新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を定義する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 64 です。|  
+|maxSessionSize|エンコーディングに使用されるバッファーのサイズをバイト単位で設定する正の整数。  バッファーが大きくなると、作業セットのサイズの増加時に、エンコーディングの速度が高まります。  既定値は 2048 です。|  
+|maxWritePoolSize|新しいライターを割り当てずに同時に送信可能なメッセージの数を定義する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 16 です。|  
+|messageVersion|使用または予想される SOAP メッセージおよび WS\-Addressing のバージョンを指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。  デコードは、その逆のプロセスです。  WCF \(Windows Communication Foundation\) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM \(Message Transmission Optimization Mechanism\) の 3 種類があります。  
+  
+ `binaryMessageEncoding` 要素は、XML 用の .NET バイナリ形式を指定します。この要素には、使用する文字エンコーディング、SOAP バージョン、および WS\-Addressing バージョンを指定するオプションがあります。  バイナリ メッセージ エンコーダーは、ネットワーク上で Windows Communication Foundation \(WCF\) メッセージをバイナリにエンコードします。  このエンコーディングによりメッセージ転送は非常に高速になりますが、WS\-\* 標準に基づいた相互運用性は失われます。  
+  
+## 使用例  
+  
+```  
+<binaryMessageEncoding maxReadPoolSize="211"  
+   maxWritePoolSize="2132"  
+   maxSessionSize="3141" />  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BinaryMessageEncodingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>   
+ [メッセージ エンコーディング](../../../../../docs/framework/configure-apps/file-schema/wcf/message-encoding.md)   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bindingelementextensions.md b/docs/framework/configure-apps/file-schema/wcf/bindingelementextensions.md
new file mode 100644
index 00000000000..254bfa96bee
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bindingelementextensions.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;bindingElementExtensions&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb597fc0-c947-451c-afda-bf23d42f4f4d
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;bindingElementExtensions&gt;
+このセクションは、コンピューターまたはアプリケーションの構成ファイルからカスタム バインディング要素を使用できます。  このコレクションにカスタム バインディング要素を追加するには、`add` キーワードを使用し、要素の `type` 属性をバインディング要素拡張に設定して、`name` 属性をカスタム バインディング要素に設定します。  
+  
+ バインディングの拡張により、ユーザーは、カスタム バインディングの一部として使用するユーザー定義のバインディング要素を作成できます。  プログラムではバインディング拡張は、抽象クラス <xref:System.ServiceModel.Channels.BindingElement> を実装する型です。  構成ファイルでは、`bindingElementExtensions` セクションは、拡張要素を定義するために使用されます。  
+  
+ 次の例は、`add` 要素と `name` 属性を使用して、構成ファイルの `bindingElementExtensions` セクションにバインディング拡張を追加します。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+        <bindingElementExtensions>  
+           <add name="udpTransport" type="Microsoft.ServiceModel.Samples.UdpTransportSection, UdpTransport,  
+                Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+        </bindingElementExtensions>  
+    </extensions>  
+</system.serviceModel>  
+```  
+  
+ 構成機能を要素に追加するには、ユーザーは `bindingElementExtensionSection` を記述して登録する必要があります。  詳細については、<xref:System.Configuration> を参照してください。  
+  
+ 要素とその構成の型を定義したら、次の例に示すように拡張をカスタム バインディングの一部として使用できます。  
+  
+```  
+<customBinding>  
+     <binding name="test2">  
+         <udpTransport />  
+         <binaryMessageEncoding maxReadPoolSize="211" maxWritePoolSize="2132"  
+             maxSessionSize="3141" />  
+         </binding>  
+</customBinding>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BindingElementExtensionElement>   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bindingextensions.md b/docs/framework/configure-apps/file-schema/wcf/bindingextensions.md
new file mode 100644
index 00000000000..03acdde4e2e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bindingextensions.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;bindingExtensions&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8373f94d-d095-486f-8f1e-4ac2f72b58c7
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;bindingExtensions&gt;
+このセクションは、コンピューターまたはアプリケーションの構成ファイルからユーザー定義のバインディングを使用できます。  このコレクションにユーザー定義のバインディングを追加するには、`add` キーワードを使用し、要素の `type` 属性をユーザー定義のバインディングに設定して、`name` 属性をユーザー定義のバインディングの名前に設定します。  
+  
+ バインディングの拡張により、ユーザーは、エンドポイント構成の一部として使用するユーザー定義のバインディングを作成できます。  プログラムではバインディング拡張は、抽象クラス <xref:System.ServiceModel.Channels.Binding> を実装する型です。  
+  
+ 次の例は、`add` 要素と `name` 属性を使用して、構成ファイルの `bindingElementExtensions` セクションにバインディング拡張を追加します。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+        <bindingExtensions>  
+           <add name="MyBinding" type="Microsoft.ServiceModel.Samples.MyBinding, MyBinding,  
+                Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+        </bindingExtensions>  
+    </extensions>  
+</system.serviceModel>  
+```  
+  
+ 構成機能を要素に追加するには、ユーザーは `bindingSection` を記述して登録する必要があります。  詳細については、<xref:System.Configuration> を参照してください。  
+  
+ 要素とその構成の型を定義したら、次の例に示すように拡張をエンドポイントの一部として使用できます。  
+  
+```  
+<services>  
+    <service name="MyService">  
+        <endpoint address="myAddress" binding="MyBinding" />  
+    </service>  
+</services>  
+  
+```  
+  
+## 参照  
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bindings.md b/docs/framework/configure-apps/file-schema/wcf/bindings.md
new file mode 100644
index 00000000000..a99c9606d3d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bindings.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;bindings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b62cd369-5409-4030-8490-9759a462dd3a
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;bindings&gt;
+このセクションには、標準バインディングおよびカスタム バインディングのコレクションが保持されます。  各エントリは、その一意の `name` 属性で識別できる `binding` 要素です。  サービスは、`name` を使用してバインディングをリンクすることにより、バインディングを使用します。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## システム指定のバインディング  
+ システム指定のバインディングは、WCF メッセージ スタックの複雑さを隠蔽します。  システム指定のバインディングを使用しているアプリケーションは、スタックを完全に制御する必要はありません。  システム指定の各バインディングに公開される属性は、バインディングが処理する使用シナリオに最適な属性です。  
+  
+ システム指定の各バインディングの構成セクションは、バインディングの構成に使用される複数の構成を定義できます。  各構成は、一意の名前によって識別されます。  
+  
+ 要素または属性をシステム指定のバインディングに追加することはできません。  追加するには、このトピックの「カスタム バインディング」セクションで説明するように、カスタム バインディングを実装する必要があります。  システム指定のバインディングを完全に再現し、ユーザー アプリケーションで制御するいくつかの設定を追加するカスタム バインディングを定義できます。  
+  
+ システム指定のバインディングの一覧については、「[システム標準のバインディング](../../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## カスタム バインディング  
+ カスタム バインディングを使用すると、WCF メッセージ スタックのフル コントロールが可能になります。  個別のバインディングは、メッセージ スタックを、スタック要素の構成要素をスタックに出現する順序で指定することにより定義します。  各要素は、スタック内の 1 つの要素を定義および構成します。  各カスタム バインディング内の `transport` 要素は 1 つだけにする必要があります。  この要素がない場合、メッセージ スタックは不完全です。  
+  
+ 要素がスタックに出現する順序は重要です。それは、その順序で操作がメッセージに適用されるためです。  スタック要素で必要な順序を次に示します。  
+  
+1.  トランザクション \(省略可能\)  
+  
+2.  リライアブル メッセージ機能 \(省略可能\)  
+  
+3.  セキュリティ \(省略可能\)  
+  
+4.  エンコーダー  
+  
+5.  Transport  
+  
+ カスタム バインディングは、`name` 属性によって識別されます。  カスタム バインディングの詳細については、「[カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BindingsSection>   
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionqueries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionqueries-of-wcf.md
new file mode 100644
index 00000000000..eb0f0f457fc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionqueries-of-wcf.md
@@ -0,0 +1,62 @@
+---
+title: "WCF の &lt;bookmarkResumptionQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed086712-1dc7-4932-a592-d1116a0155f3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;bookmarkResumptionQueries&gt;
+ワークフロー インスタンス内のブックマークの再開を追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bookmarkResumptionQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionquery.md)|ワークフロー インスタンス内のブックマークの再開を追跡するために使用されるクエリ。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.BookmarkResumptionQuery](assetId:///System.Activities.Tracking.BookmarkResumptionQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionquery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionquery-of-wcf.md
new file mode 100644
index 00000000000..8cc1004584e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bookmarkresumptionquery-of-wcf.md
@@ -0,0 +1,62 @@
+---
+title: "WCF の &lt;bookmarkResumptionQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 755a34f0-87c9-4a1e-ae4d-0fb8a6fbdc0e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;bookmarkResumptionQuery&gt;
+ワークフロー インスタンス内のブックマークの再開を追跡するために使用されるクエリを表します。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|定期受信するブックマーク レコードの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bookmarkResumptionQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md)|ワークフロー インスタンス内のブックマークの再開を追跡するために使用する、クエリのコレクションを表します。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.BookmarkResumptionQuery](assetId:///System.Activities.Tracking.BookmarkResumptionQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/bytestreammessageencoding.md b/docs/framework/configure-apps/file-schema/wcf/bytestreammessageencoding.md
new file mode 100644
index 00000000000..a878b92afe8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/bytestreammessageencoding.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;byteStreamMessageEncoding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bbadd8dd-60a2-4007-b959-89373a8a7d60
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;byteStreamMessageEncoding&gt;
+文字エンコーディングを指定するオプションを使用し、メッセージ エンコーディングをバイト ストリームとして指定します。  
+  
+## 構文  
+  
+```  
+  
+<byteStreamMessageEncoding/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|messageVersion|バインディングを使用して送信されたメッセージの SOAP バージョンを指定します。  このプロパティは、<xref:System.ServiceModel.Channels.MessageVersion.None%2A> のメッセージ バージョン値にのみ設定できます。  バイト ストリーム メッセージ エンコーダーは、他のメッセージ バージョンをサポートしません。<br /><br /> この属性は <xref:System.ServiceModel.Channels.MessageVersion> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ByteStreamMessageEncodingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.ByteStreamMessageEncodingBindingElement>   
+ [メッセージ エンコーディング](../../../../../docs/framework/configure-apps/file-schema/wcf/message-encoding.md)   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/callbackdebug.md b/docs/framework/configure-apps/file-schema/wcf/callbackdebug.md
new file mode 100644
index 00000000000..ae9082d763f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/callbackdebug.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;callbackDebug&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4073feda-1857-4be4-9947-227afb847ced
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;callbackDebug&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] コールバック オブジェクトのサービス デバッグを指定します。  
+  
+## 構文  
+  
+```  
+  
+<callbackDebug  includeExceptionDetailInFaults="Boolean" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`includeExceptionDetailInFaults`|クライアント コールバック オブジェクトが SOAP エラー内のマネージ例外情報をサービスに返すかどうかを指定する値。<br /><br /> プログラムでこの属性を `true` に設定すると、デバッグするために、クライアント コールバック オブジェクト内のマネージ例外情報がサービスに戻るフローを有効にできます。 **Caution:**  マネージ例外情報をクライアントに返すことは、セキュリティ リスクになり得ます。  これは、例外の詳細が、認証されていないクライアントによって使用可能な内部サービスの実装に関する情報を公開するためです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.CallbackDebugElement>   
+ <xref:System.ServiceModel.Description.CallbackDebugBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/callbacktimeouts.md b/docs/framework/configure-apps/file-schema/wcf/callbacktimeouts.md
new file mode 100644
index 00000000000..1d29d8e6a2d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/callbacktimeouts.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;callbackTimeouts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d7fcfc5f-6d35-491e-8fa6-2f964c1e792f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;callbackTimeouts&gt;
+双方向コールバック コントラクト シナリオでトランザクションをサーバーからクライアントに転送する際のタイムアウト値を指定します。  
+  
+## 構文  
+  
+```  
+  
+<callbackTimeOuts transactionTimeout="TimeSpan" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`transactionTimeout`|トランザクションが完了する必要があるまたは自動的に終了される必要がある制限時間を指定する <xref:System.TimeSpan> 値。  既定値は “00:00:00” です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.CallbackTimeoutsElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/cancelrequestedqueries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/cancelrequestedqueries-of-wcf.md
new file mode 100644
index 00000000000..36db62066e7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/cancelrequestedqueries-of-wcf.md
@@ -0,0 +1,62 @@
+---
+title: "WCF の &lt;cancelRequestedQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7cc7125-9ea3-4d3f-99c0-878cdeb1258a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF の &lt;cancelRequestedQueries&gt;
+親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する、クエリのコレクションを表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<cancelRequestedQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ <xref:System.Activities.Tracking.CancelRequestedQuery>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/cancelrequestedquery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/cancelrequestedquery-of-wcf.md
new file mode 100644
index 00000000000..735bc34f775
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/cancelrequestedquery-of-wcf.md
@@ -0,0 +1,64 @@
+---
+title: "WCF の &lt;cancelRequestedQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b690d870-02eb-4c56-8bc3-e5ca99d7097b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;cancelRequestedQuery&gt;
+親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用するクエリを表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|キャンセルを要求しているアクティビティの名前を指定する文字列。|  
+|childActivityName|キャンセルが要求された子アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素の一覧を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CancelRequestedQuery](assetId:///System.Activities.Tracking.CancelRequestedQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/certificate-element.md b/docs/framework/configure-apps/file-schema/wcf/certificate-element.md
new file mode 100644
index 00000000000..a56ec80cb4a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/certificate-element.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;certificate&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b3d9233-ef35-477a-bf5d-efd1e80a52f4
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;certificate&gt; 要素
+ピアツーピア クライアントのメッセージの署名と暗号化に使用する X.509 証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<certificate findValue="String"   
+  
+storeLocation="LocalMachine/CurrentUser"  
+      storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+      X509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`findValue`|X.509 証明書ストアで検索する値を含む文字列。  属性に格納されている型は、指定された `x509FindType` の要件を満たす必要があります。  既定値は空の文字列です。|  
+|`storeLocation`|クライアントがピアの証明書の検証に使用する X.509 証明書ストアの場所を指定します。  以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定は LocalMachine です。|  
+|`storeName`|開く X.509 証明書ストアの名前を指定します。  以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA\) の証明書ストア。<br />-   CertificateAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は My です。|  
+|`X509FindType`|実行する X.509 検索の種類を定義します。  以下の値が有効です。<br /><br /> -   FindByThumbPrint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> `findValue` 属性に格納されている型は、指定された `X509FindType` の要件を満たす必要があります。<br /><br /> 既定値は FindBySubjectDistinguishedName です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md)|ピアツーピア クライアントの認証時に使用される資格情報を指定します。|  
+  
+## 解説  
+ この構成要素には、ピア メッシュ内の近隣ノードを認証するときに使用される X509Certificate2 インスタンスが格納されます。  
+  
+ ピア ツー ピア プログラミングの詳細については、「[ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードは、ピアツーピア シナリオで使用される証明書の検索方法を指定します。  
+  
+```  
+<behaviors>  
+ <endpointBehaviors>  
+  <behavior name="MyEndpointBehavior">  
+   <clientCredentials>  
+    <peer>  
+     <certificate findValue="www.contoso.com"   
+                   storeLocation="LocalMachine"  
+                   x509FindType="FindByIssuerName" />  
+    </peer>  
+   </clientCredentials>  
+  </behavior>  
+</endpointBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.Certificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateElement>   
+ <xref:System.ServiceModel.Security.PeerCredential.Certificate%2A>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/certificate-for-identity.md b/docs/framework/configure-apps/file-schema/wcf/certificate-for-identity.md
new file mode 100644
index 00000000000..2368bea5c48
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/certificate-for-identity.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;identity&gt; の &lt;certificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4aeccaf7-8f23-495c-aa5f-5bd8b5d4a10c
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;identity&gt; の &lt;certificate&gt;
+クライアントに対するサービスの検証に使用される X.509 証明書を指定します。  
+  
+ 要素の値の設定の詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<certificate encodedValue = "Sring" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|encodedValue|証明書の Base64 エンコーディングです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|クライアントで認証するサービスの ID を指定します。|  
+  
+## 使用例  
+ 次のコードは、クライアントに対するサーバーの検証に使用される証明書のエンコードされた表現を指定します。  
+  
+```  
+<identity>  
+  <certificate encodedValue = " MIIBxjCCAXSgAwIBAgIQmXJgyu9tro1M98GifjtuoDAJBgUrDgMCHQUAMBYxFDASBgNVBAMTC1Jvb3QgQWdlbmN5MB4XDTA2MDUxNzIxNDQyNVoXDTM5MTIzMTIzNTk1OVowKTEQMA4GA1UEChMHQ29udG9zbzEVMBMGA1UEAxMMaWRlbnRpdHkuY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDBmivcb8hYbh11hqVoDuB7zmJ2y230f" />  
+</identity>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ <xref:System.ServiceModel.EndpointIdentity>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/certificate-of-clientcertificate-element.md b/docs/framework/configure-apps/file-schema/wcf/certificate-of-clientcertificate-element.md
new file mode 100644
index 00000000000..6baa9dca82b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/certificate-of-clientcertificate-element.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;clientCertificate&gt; 要素の &lt;certificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00297efb-a7f2-4e03-bc2b-943d545610fc
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;clientCertificate&gt; 要素の &lt;certificate&gt;
+メッセージの署名と暗号化に使用される X.509 証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<certificate findValue = "String"   
+storeLocation = "CurrentUser/LocalMachine"  
+storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+X509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`findValue`|X.509 証明書ストアで検索する値を含む文字列。  属性に含まれている型は、指定された X509FindType の要件を満たしている必要があります。  既定値は空の文字列です。|  
+|`storeLocation`|クライアントがサーバーの証明書の検証に使用する X.509 証明書ストアの場所を指定します。  以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定は LocalMachine です。|  
+|`storeName`|開く X.509 証明書ストアの名前を指定します。  以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA\) の証明書ストア。<br />-   CertificationAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は My です。|  
+|`X509FindType`|実行する X.509 検索の種類を定義します。  以下の値が有効です。<br /><br /> -   FindByThumbPrint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> `findValue` 属性に含まれている型は、指定された X509FindType の要件を満たしている必要があります。<br /><br /> 既定値は FindBySubjectDistinguishedName です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md)||  
+  
+## 解説  
+ `<certificate>` 要素は、サービスがクライアントと安全に通信するために、サービスが前もってクライアントの証明書を持っている必要がある場合に使用します。  このような状況は、双方向通信パターンを使用する場合に生じます。  より一般的な要求\/応答パターンでは、クライアントは自身の証明書を要求に含め、サービスはそれを使用してクライアントへの応答を暗号化し、署名します。  一方、双方向通信パターンでは、サービスにはクライアントからの要求が来ないので、クライアントの証明書をあらかじめ取得することで、クライアント宛のメッセージのセキュリティを保護する必要があります。  このため、クライアントの証明書を帯域外のネゴシエーションで取得し、この要素を使用して証明書を指定する必要があります。  双方向サービスの詳細については、「[方法 : 双方向コントラクトを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードは、`<authentication>` 要素の適切な X.509 証明書とカスタム検証タイプの検索方法を指定します。  
+  
+```  
+<serviceBehaviors>  
+ <behavior name="myServiceBehavior">  
+  <clientCertificate>  
+   <certificate   
+         findValue="www.cohowinery.com"   
+         storeLocation="CurrentUser"   
+         storeName="TrustedPeople"  
+         x509FindType="FindByIssuerName" />  
+   <authentication customCertificateValidatorType="MyTypes.Coho"  
+    certificateValidationMode="Custom"   
+    revocationMode="Offline"  
+    includeWindowsGroups="false"   
+    mapClientCertificateToWindowsAccount="true" />  
+  </clientCertificate>  
+ </behavior>  
+</serviceBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.Certificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement.Certificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509ClientCertificateCredentialsElement>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [方法 : カスタム証明書検証を使用するサービスを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/certificate-of-peer.md b/docs/framework/configure-apps/file-schema/wcf/certificate-of-peer.md
new file mode 100644
index 00000000000..b838d379fbc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/certificate-of-peer.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;peer&gt; の &lt;certificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48b69142-c957-4305-a042-c9d0c9a55c0e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;peer&gt; の &lt;certificate&gt;
+ピアで使用される証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<certificate findValue = "String"   
+storeLocation = "CurrentUser/LocalMachine"  
+storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+X509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`findValue`|X.509 証明書ストアで検索する値を含む文字列。  属性に格納されている型は、指定された `x509FindType` の要件を満たす必要があります。  既定値は空の文字列です。|  
+|`storeLocation`|クライアントがピアの証明書の検証に使用する X.509 証明書ストアの場所を指定します。  以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定は LocalMachine です。|  
+|`storeName`|開く X.509 証明書ストアの名前を指定します。  以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA: Certificate Authority\) の証明書ストア。<br />-   CertificateAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は My です。|  
+|`X509FindType`|実行する X.509 検索の種類を定義します。  以下の値が有効です。<br /><br /> -   FindByThumbPrint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> `findValue` 属性に格納されている型は、指定された `X509FindType` の要件を満たす必要があります。<br /><br /> 既定値は FindBySubjectDistinguishedName です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md)|ピア ノードの現在の資格情報を指定します。|  
+  
+## 解説  
+ この構成要素には、ピア メッシュ内の近隣ノードを認証するときに使用される `X509Certificate2` インスタンスが格納されます。  
+  
+ ピア ツー ピア プログラミングの詳細については、「[ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.Certificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateElement>   
+ <xref:System.ServiceModel.Security.PeerCredential.Certificate%2A>   
+ <xref:System.ServiceModel.Security.PeerCredential>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/certificatereference-for-identity.md b/docs/framework/configure-apps/file-schema/wcf/certificatereference-for-identity.md
new file mode 100644
index 00000000000..ffe2da3ce2b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/certificatereference-for-identity.md
@@ -0,0 +1,63 @@
+---
+title: "&lt;identity&gt; の &lt;certificateReference&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac359c65-c22d-42d2-97de-db53b77cebdb
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;identity&gt; の &lt;certificateReference&gt;
+X.509 証明書検証の設定を指定します。  この ID を持つエンドポイントに接続するセキュリティで保護された [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] クライアントは、サーバーによって提示されるクレームに、この ID を構築するために使用された ID クレームが含まれていることを検証します。  
+  
+## 構文  
+  
+```  
+  
+<certificateReference   
+        findValue="String"   
+    isChainIncluded="Boolean"  
+    storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"storeName="  
+  
+    storeLocation="LocalMachine/CurrentUser"  
+  
+X509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+</certificateReference>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|findValue|X.509 証明書ストアで検索する値を指定します。  この属性に格納されている型は、指定された `X509FindType` 値の要件を満たす必要があります。  既定値は空の文字列です。|  
+|isChainIncluded|証明書チェーンを使用して検証を行うかどうかを指定するブール値です。|  
+|storeLocation|クライアントがサーバーの証明書の検証に使用できる証明書ストアの場所を指定します。<br /><br /> 以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定値は LocalMachine です。<br /><br /> この属性は <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 型です。|  
+|storeName|開く X.509 証明書ストアの名前を指定します。<br /><br /> 以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA\) の証明書ストア。<br />-   CertificateAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は、My です。<br /><br /> この属性は <xref:System.Security.Cryptography.X509Certificates.StoreName> 型です。|  
+|X509FindType|実行する X.509 検索の種類を指定します。  `findValue` 属性に含まれている型は、指定された X509FindType の要件を満たしている必要があります。<br /><br /> 以下の値が有効です。<br /><br /> -   FindByThumbPrint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> 既定値は FindBySubjectDistinguishedName です。<br /><br /> この属性は <xref:System.Security.Cryptography.X509Certificates.X509FindType> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする設定を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.CertificateReferenceElement>   
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/channelpoolsettings.md b/docs/framework/configure-apps/file-schema/wcf/channelpoolsettings.md
new file mode 100644
index 00000000000..e9146c0c4a7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/channelpoolsettings.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;channelPoolSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4755f3d3-4213-4c68-ae7f-45b67d744459
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;channelPoolSettings&gt;
+カスタム バインディングのチャネル プール設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<channelPoolSettings  
+    idleTimeout"TimeSpan"  
+        leaseTimeout"TimeSpan"  
+    maxOutboundConnectionsPerEndpopint=”Integer” />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`idleTimeout`|プール内のチャネルの接続が切断されるまでの最大アイドル時間を指定する正の <xref:System.TimeSpan>。  既定値は 00:02:00 です。|  
+|`leaseTimeout`|プールに返されたチャネルが閉じられるまでの時間を指定する <xref:System.TimeSpan>。  既定値は 00:10:00 です。|  
+|`maxOutboundChannelsPerEndpoint`|各リモート エンドポイントのプール内に格納できるチャネルの最大数を指定する正の整数。  既定値は 10 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<oneWay\>](../../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md)|カスタム バインディングでパケット ルーティングを有効にします。|  
+  
+## 解説  
+ クォータは、リソースの過剰な消費を防ぐためのポリシー メカニズムとして使用されます。  クォータは、悪質な、または意図的でないサービス拒否 \(DOS\) 攻撃を防ぎます。  カスタム チャネルにチャネル クォータを設定するには、この要素を使用します。  
+  
+ `ChannelPoolSettings` では、次の 3 つのクォータを指定します。  
+  
+-   `idleTimeout` クォータは、サーバーでは、長時間リソースを停滞させることによるサービス拒否 \(DOS\) 攻撃を軽減するために使用されます。  クライアントでは、適切な値を設定することで、サービスとの接続の信頼性を高めることができます。  既定値では、リソースが控えめに割り当てられています。  開発環境、および小規模のインストール シナリオに適しています。  インストールでリソースが不足している場合、または追加リソースが使用可能であるにもかかわらず接続が制限されている場合、サービス管理者は値を確認する必要があります。  
+  
+-   `leaseTimeout` クォータは、負荷分散機能との統合、および信頼性の向上のために使用されます。  既定値では、リソースが控えめに割り当てられています。  開発環境、および小規模のインストール シナリオに適しています。  インストールでリソースが不足している場合、または追加リソースが使用可能であるにもかかわらず接続が制限されている場合、サービス管理者は値を確認する必要があります。  
+  
+-   `maxOutboundChannelsPerEndpoint` クォータは、サーバーとクライアントの両方に対するキャッシュ制限を設定し、信頼性向上のために使用されます。  既定値ではリソースが控えめに割り当てられており、開発環境および小規模なインストール シナリオに適しています。  インストールでリソースが不足している場合、または追加リソースが使用可能であるにもかかわらず接続が制限されている場合、サービス管理者は値を確認する必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.OneWayBindingElement.ChannelPoolSettings%2A>   
+ <xref:System.ServiceModel.Channels.ChannelPoolSettings>   
+ <xref:System.ServiceModel.Configuration.OneWayElement.ChannelPoolSettings%2A>   
+ <xref:System.ServiceModel.Configuration.ChannelPoolSettingsElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [\<oneWay\>](../../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md b/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md
new file mode 100644
index 00000000000..b93c2269537
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md
@@ -0,0 +1,43 @@
+---
+title: "&lt;claimTypeRequirements&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a26efe73-4bad-4731-8cad-27f00d54354b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;claimTypeRequirements&gt; 要素
+必須のクレームの種類のコレクションを指定します。  
+  
+ フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの子要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須のクレームおよび省略可能なクレームの種類を指定します。  
+  
+ クレームの種類の要件は、発行されるトークンで要求されているクレームの種類の URI と、発行されるトークンでそのクレームの種類が必須かまたは省略可能かを示すブール型のパラメーターで構成されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>   
+ <xref:System.ServiceModel.Configuration.SecurityElementBase.IssuedTokenParameters%2A>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md b/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md
new file mode 100644
index 00000000000..d15f67e0ae9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md
@@ -0,0 +1,31 @@
+---
+title: "&lt;message&gt; の &lt;claimTypeRequirements&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f95c5ecd-abb6-4b77-a6d7-a38727f4a142
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;message&gt; の &lt;claimTypeRequirements&gt;
+必須のクレームの種類のコレクションを指定します。  
+  
+ このコレクションは、発行されたトークンに含める必要のある必須クレームとオプション クレームを指定するために、サービスによって使用されます。クライアントは、発行されたトークンを使用してサービスにアクセスします。  WSDL の公開が有効になっていても、発行されるトークンに指定されたクレームの種類が含まれていることを WCF が要求しない場合、サービスは必須クレームの種類をメタデータで公開します。  存在している必須クレームの種類を実施しようとするサービスは、承認ポリシーを使用して実施します。  
+  
+ フェデレーション クライアント上では、このコレクションには、発行されたトークンに対するクライアントの要求の中でセキュリティ トークン サービスに送信される、必須クレームとオプション クレームのリストが含まれます。  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/clear-of-claimtyperequirements-element.md b/docs/framework/configure-apps/file-schema/wcf/clear-of-claimtyperequirements-element.md
new file mode 100644
index 00000000000..0b2453f09ee
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/clear-of-claimtyperequirements-element.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;claimTypeRequirements&gt; 要素の &lt;clear&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef42fde7-f292-4610-9111-9fea382c3b5f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;claimTypeRequirements&gt; 要素の &lt;clear&gt;
+すべてのクレームの種類をフェデレーション資格情報から削除するように指定します。  これにより、コレクションの初期値を確実に空にできます。  
+  
+## 構文  
+  
+```  
+  
+<claimTypeRequirements>  
+      <clear />  
+</claimTypeRequirements>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md)|必須のクレームの種類のコレクションを指定します。  各要素は <xref:System.ServiceModel.Configuration.ClaimTypeElement> 型です。<br /><br /> フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須の要求および省略可能な要求の種類を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/client.md b/docs/framework/configure-apps/file-schema/wcf/client.md
new file mode 100644
index 00000000000..4552c53b34b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/client.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;client&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.ServiceModel/client"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#client"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: bf0f7031-76c8-4e7e-a6c6-9ad9119134be
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# &lt;client&gt;
+`client` 要素は、クライアントが接続可能なエンドポイントの一覧を定義します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <client>  
+        <endpoint>  
+        </endpoint>  
+                <metadata>  
+        </metadata>  
+    </client>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md)|このクライアントが接続可能なエンドポイントを指定するエンドポイント要素のコレクションを含みます。|  
+|[\<metadata\>](../../../../../docs/framework/configure-apps/file-schema/wcf/metadata.md)|メタデータを処理するための設定を含みます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)|すべての Windows Communication Foundation \(WCF\) 構成要素のルート要素です。|  
+  
+## 解説  
+ `client` セクションは、クライアントが接続可能なエンドポイントの一覧を定義します。  クライアント セクションに示される各エンドポイントは、独自のバインディング、動作、およびコントラクトを定義します。  各エンドポイントは、`name` 属性と `contract` 属性の組み合わせで一意に識別されます。  クライアント コードは、クライアントが実装するサービスのエンドポイントに接続するための `name` を指定します。  `name` 属性が省略されている場合、クライアントが実装するコントラクトのエンドポイントが既定のエンドポイントとして機能します。  
+  
+ さらに、このセクションはメタデータを処理するための設定も指定します。  
+  
+## 使用例  
+  
+```  
+<client>  
+    <endpoint address="/HelloWorld/"  
+              bindingConfiguration="usingDefaults"  
+              name="MyBinding"  
+              binding="customBinding"  
+              contract="HelloWorld">  
+    <addressProperties actingAs="http://www.microsoft.com/TestActor"  
+             identityData="BasicReadWrite" identityType="Spn" isAddressPrivate="false">  
+    </endpoint>  
+</client>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientSection>   
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md b/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md
new file mode 100644
index 00000000000..7c936e36743
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;clientCredentials&gt; 要素の &lt;clientCertificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b3fa000-3434-4142-a178-11903bdd2c5d
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;clientCredentials&gt; 要素の &lt;clientCertificate&gt;
+サービスに対するクライアントの認証に使用される X.509 証明書を定義します。  
+  
+## 構文  
+  
+```  
+  
+<clientCertificate findValue="String"   
+    storeLocation="LocalMachine/CurrentUser"  
+    storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+X509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`findValue`|X.509 証明書ストアで検索する値を含む文字列。  属性に格納されている型は、`X509FindType` 属性値の要件を満たす必要があります。  既定値は空の文字列です。|  
+|`storeLocation`|クライアントがサービスに対して自身を認証するために使用する X.509 証明書の場所を指定します。  以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定は LocalMachine です。  この属性は <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 型です。|  
+|`storeName`|検索する X.509 証明書ストアの名前を指定します。  以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA: Certificate Authority\) の証明書ストア。<br />-   CertificateAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は My です。  この属性は <xref:System.Security.Cryptography.X509Certificates.StoreName> 型です。|  
+|X509FindType|実行する X.509 検索の種類を定義します。  `findValue` 属性に格納されている型は、この属性の要件を満たす必要があります。  以下の値が有効です。<br /><br /> -   FindByThumbPrint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> 既定値は FindBySubjectDistinguishedName です。  この属性は <xref:System.Security.Cryptography.X509Certificates.X509FindType> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ この構成要素は、この要素によるクライアントの認証に使用する証明書を指定します。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] [方法 : クライアントの資格情報の値を指定する](../../../../../docs/framework/wcf/how-to-specify-client-credential-values.md).  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.ClientCertificate%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ClientCredentials.ClientCertificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [方法 : クライアントの資格情報の値を指定する](../../../../../docs/framework/wcf/how-to-specify-client-credential-values.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md
new file mode 100644
index 00000000000..6cd29c7d96f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;serviceCredentials&gt; の &lt;clientCertificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 90ad03aa-2317-43dd-8a72-6d24cdcad15c
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# &lt;serviceCredentials&gt; の &lt;clientCertificate&gt;
+双方向通信パターンでサービスからクライアントへのメッセージの署名および暗号化に使用される X.509 証明書を定義します。  
+  
+## 構文  
+  
+```  
+  
+<clientCertificate>  
+ <certificate/>  
+ <authentication/>  
+</clientCertificate>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<authentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md)|クライアント証明書の認証オプションを指定します。|  
+|[\<certificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/certificate-of-clientcertificate-element.md)|使用する証明書を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ この要素は、サービスがクライアントと安全に通信するために、サービスが前もってクライアントの証明書を持っている必要がある場合に使用します。  このような状況は、双方向通信パターンを使用する場合に生じます。  より一般的な要求\/応答パターンでは、クライアントは自身の証明書を要求に含め、サービスはそれを使用してクライアントへの応答を暗号化し、署名します。  一方、双方向通信パターンでは、サービスにはクライアントからの要求が来ないので、クライアントの証明書をあらかじめ取得することで、クライアント宛のメッセージのセキュリティを保護する必要があります。  このため、クライアントの証明書を帯域外のネゴシエーションで取得し、この要素を使用して証明書を指定する必要があります。  双方向サービスの詳細については、「[方法 : 双方向コントラクトを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+ この要素で設定される証明書は、`MutualCertificateDuplex` メッセージ セキュリティ認証モードで構成されているバインディングのみを対象に、クライアントへのメッセージを暗号化するために使用されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.ClientCertificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.ClientCertificate%2A>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential>   
+ [方法 : 双方向コントラクトを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/clientcredentials.md b/docs/framework/configure-apps/file-schema/wcf/clientcredentials.md
new file mode 100644
index 00000000000..25d6ad8bb7a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/clientcredentials.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;clientCredentials&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e6eef0d-a34e-4d74-b0f7-f65d2181858d
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;clientCredentials&gt;
+サービスに対するクライアントの認証に使用される資格情報を指定します。  
+  
+## 構文  
+  
+```  
+  
+<clientCredentials type="String"  
+      supportInteractive="Boolean" >  
+   <clientCertificate>  
+   </clientCertificate>  
+   <digest>  
+   </digest>  
+   <isuedToken>  
+   </isuedToken>  
+   <peer>  
+   </peer>  
+   <serviceCertificate>  
+   </serviceCertificate>  
+   <windowsAuthentication>  
+   </windowsAuthentication>  
+</clientCredentials>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`supportInteractive`|実行時にクライアントの資格情報を選択する際に、対話型ユーザーを含めるかどうかを指定するブール値。  既定値は `true` です。|  
+|`type`|この設定要素の種類を指定する文字列です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md)|サービスに対するクライアントの認証に使用される証明書を指定します。  この要素は <xref:System.ServiceModel.Configuration.X509InitiatorCertificateClientElement> 型です。|  
+|[\<httpDigest\>](../../../../../docs/framework/configure-apps/file-schema/wcf/httpdigest-element.md)|サービスに対するクライアントの認証に使用されるダイジェストを指定します。  この要素は <xref:System.ServiceModel.Configuration.HttpDigestClientElement> 型です。|  
+|[\<issuedToken\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md)|セキュリティ トークン サービス \(STS\) に対するクライアントの認証に使用されるカスタム トークンの種類を指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenClientElement> 型です。|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md)|現在のピア資格情報を指定します。  この要素は <xref:System.ServiceModel.Configuration.PeerCredentialElement> 型です。|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md)|クライアントに対するサービスの認証に使用される証明書を指定し、証明書オプションを設定するための構造を提供します。  この証明書は、クライアントに対するサービスの帯域外に提供される必要があります。  この要素は <xref:System.ServiceModel.Configuration.X509RecipientCertificateClientElement> 型です。|  
+|[\<windows\>](../../../../../docs/framework/configure-apps/file-schema/wcf/windows-of-clientcredentials-element.md)|Windows 資格情報を指定します。  既定値は、現在のスレッドの資格情報です。  この要素は <xref:System.ServiceModel.Configuration.WindowsClientElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 解説  
+ クライアント資格情報は、相互認証が必要な場合にサービスに対するクライアントの認証に使用されます。  また、この構成セクションを使用して、クライアントがサービスの証明書によってサービスへのメッセージをセキュリティで保護する必要がある場合に使用するサービス証明書を指定することもできます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/clientvia.md b/docs/framework/configure-apps/file-schema/wcf/clientvia.md
new file mode 100644
index 00000000000..63e6a22cbf9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/clientvia.md
@@ -0,0 +1,49 @@
+---
+title: "&lt;clientVia&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c27ee94e-babd-459b-9574-2a6d67d11314
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;clientVia&gt;
+トランスポート チャネルの作成対象となる URI を指定します。  詳細については、「<xref:System.ServiceModel.Description.ClientViaBehavior>」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<clientVia viaUri="String"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`viaUri`|メッセージの経路を示す URI を指定する文字列。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientViaElement>   
+ <xref:System.ServiceModel.Description.ClientViaBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/comcontract.md b/docs/framework/configure-apps/file-schema/wcf/comcontract.md
new file mode 100644
index 00000000000..da78326ddb2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/comcontract.md
@@ -0,0 +1,104 @@
+---
+title: "&lt;comContract&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f8e1c0c-cfdf-4c79-ac65-c64e9323a51c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;comContract&gt;
+COM\+ 統合サービス コントラクトを指定します。  
+  
+## 構文  
+  
+```  
+  
+<comContracts>  
+  <comContract  
+      contract="string"  
+      namespace="string"  
+      name="string"  
+      requireSession="Boolean">  
+      <exposedMethods>  
+         <exposedMethod name="string" />  
+      </exposedMethods>  
+      <userDefinedTypes>  
+         <userDefinedType name="string"  
+            typeLibID="string"  
+            typeLibVersion="string"  
+            typeDefID="string">  
+         </userDefinedType>  
+      </userDefinedTypes>  
+      <persistableTypes>  
+         <persistableType id="string"  
+            name="string">  
+         </persistableType>  
+      </persistableTypes>  
+  </comContract>  
+</comContracts>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|コントラクト|コントラクトの種類を含む文字列。|  
+|name|コントラクト名を含む文字列。|  
+|namespace|コントラクトの名前空間を含む文字列。|  
+|requiresSession|コントラクトをセッションの多いバインディングでのみ使用できるかどうかを指定するブール値。  サービスが初期化される場合、統合ランタイムは、この設定が、使用されるバインディングの種類と一貫していることを保証します。  コントラクト内の 1 つ以上のバインディングが競合する場合は、例外が生成されます。  このプロパティが `false` で、一方向のチャネルを使用し、いずれかの \[out\] パラメーターが存在する場合は、例外も発生します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|persistableTypes|すべての永続型。|  
+|userDefinedTypes|サービス コントラクトに含まれるユーザー定義型 \(UDT\) のコレクション。|  
+|exposedMethods|COM\+ コンポーネントのインターフェイスが Web サービスとして公開されるときに公開される COM\+ メソッドのコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|comContracts|`comContract` 要素のコレクションを含みます。|  
+  
+## 解説  
+ COM\+ 統合サービス コントラクトは、現在 "http:\/\/tempuri.org" 名前空間に制限されており、コントラクト名はサポートする COM インターフェイスから派生します。  ただし、構成ファイルの `comContracts` セクションと `comContract` 要素を使用して代替を指定することができます。  たとえば、次の構成を使用して、名前空間、コントラクト名、組み込まれるユーザー定義型、およびサービス コントラクトのその他の設定を指定できます。  
+  
+```  
+<comContracts>  
+  <comContract  
+      contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"  
+      namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"  
+      name="_Broker"  
+      requireSession="true">  
+      <exposedMethods>  
+         <exposedMethod name="BuyStock" />  
+         <exposedMethod name="SellStock" />  
+         <exposedMethod name="ExecuteTransaction" />  
+      </exposedMethods>  
+  </comContract>  
+</comContracts>  
+```  
+  
+ サービスが初期化される場合、指定した名前空間およびコントラクト名が、生成されるサービスの説明に適用されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComContractElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComContractElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComContractElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/comcontracts.md b/docs/framework/configure-apps/file-schema/wcf/comcontracts.md
new file mode 100644
index 00000000000..85f73c4cbf3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/comcontracts.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;comContracts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42e74148-223d-4888-a8ed-1d928527eb09
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;comContracts&gt;
+`comContracts` 構成セクションには、COM\+ 統合サービス コントラクトのさまざまなプロパティを指定できる要素が含まれます。  
+  
+## 名前空間およびコントラクトの指定  
+ COM\+ 統合サービス コントラクトは、現在 "http:\/\/tempuri.org" 名前空間に制限されており、コントラクト名はサポートする COM インターフェイスから派生します。  ただし、構成ファイルの `comContracts` セクションを使用して候補を指定することができます。  
+  
+ たとえば、次の構成を使用して、サービス コントラクトの名前空間とコントラクト名、およびセッションの多いバインディングで使用させるオプションを指定できます。  
+  
+```  
+<comContracts>  
+  <comContract  
+      contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"  
+      namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"  
+      name="_Broker"  
+      requireSession="true">  
+  </comContract>  
+</comContracts>  
+```  
+  
+ サービスが初期化される場合、指定した名前空間およびコントラクト名が、生成されるサービスの説明に適用されます。  
+  
+ このセクションが空の場合、サービスの初期化によって、サポートしている COM インターフェイス ID から取得された既定の名前空間およびコントラクト名が適用されます。  
+  
+ また、[\<exposedMethod\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethod.md) 要素を使用して、COM\+ コンポーネントのインターフェイスが Web サービスとして公開されるときに公開される COM\+ メソッドを指定できます。  さらに、[\<persistableTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/persistabletypes.md) を使用して、統合で使用される永続型も指定できます。  最後に、[\<userDefinedType\>](../../../../../docs/framework/configure-apps/file-schema/wcf/userdefinedtype.md) 要素を使用して、サービス コントラクトに組み込まれるユーザー定義型 \(UDT\) を含めることができます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComContractElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComContractElement>   
+ [\<exposedMethod\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethod.md)   
+ [\<persistableTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/persistabletypes.md)   
+ [\<userDefinedType\>](../../../../../docs/framework/configure-apps/file-schema/wcf/userdefinedtype.md)   
+ [\<comContract\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontract.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md b/docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md
new file mode 100644
index 00000000000..443728d6413
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md
@@ -0,0 +1,20 @@
+---
+title: "&lt;commonBehaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5260aeca-388d-4e82-94c0-124fa8054cf5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;commonBehaviors&gt;
+`commonBehaviors` セクションは、machine.config ファイルでだけ定義できます。  このセクションは、`endpointBehaviors` と`serviceBehaviors` という 2 つの子コレクションを定義します。  各コレクションは、コンピューター上の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のすべてのエンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。  `endpointBehaviors` で定義される動作はクライアントだけに適用され、`serviceBehaviors` で定義される動作はサービスだけに適用されます。  ある動作が `commonBehaviors` と `behaviors` の両方のセクションで定義されている場合は、`behaviors` セクション内の動作が優先されます。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/commonparameters.md b/docs/framework/configure-apps/file-schema/wcf/commonparameters.md
new file mode 100644
index 00000000000..fe51c46deed
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/commonparameters.md
@@ -0,0 +1,107 @@
+---
+title: "&lt;commonParameters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ffc20832-34d6-4622-8174-81924fd53514
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;commonParameters&gt;
+複数のサービスでグローバルに使用されるパラメーターのコレクションを表します。  このコレクションには通常、永続性サービスによって共有されるデータベース接続文字列が格納されます。  
+  
+## 構文  
+  
+```  
+  
+<workflowRuntime>  
+   <commonParameters>  
+      <add name="String" value="String" />  
+   </commonParameters>  
+</workflowRuntime>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-commonparameters.md)|サービスによって使用される共通パラメーターの名前と値のペアをコレクションに追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowRuntime\>](../../../../../docs/framework/configure-apps/file-schema/wcf/workflowruntime.md)|ワークフロー ベースの [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスをホストする <xref:System.Workflow.Runtime.WorkflowRuntime> のインスタンスの設定を指定します。|  
+  
+## 解説  
+ 最初の要素 `<commonParameters>` は、複数のサービスでグローバルに使用されるパラメーターを定義します \(たとえば <xref:System.Workflow.Runtime.Hosting.SharedConnectionWorkflowCommitWorkBatchService> を使用する場合の `ConnectionString`\)。  
+  
+> [!NOTE]
+>  SQL 追跡サービスでは、`<commonParameters>` セクションに `ConnectionString` 値を指定しても、その値が常に使用されるとは限りません。  `StateMachineWorkflowInstance.StateHistory` プロパティの取得のように、操作によっては失敗する場合があります。  これを回避するには、次の例に示すように、追跡プロバイダーの構成セクションで `ConnectionString` 属性を指定します。  
+  
+ `<add`  
+  
+ `type="System.Workflow.Runtime.Tracking.SqlTrackingService, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"`  
+  
+ `ConnectionString="Data Source=localhost;Initial Catalog=Partner20WFTP;Integrated Security=True;" />`  
+  
+ <xref:System.Workflow.Runtime.Hosting.DefaultWorkflowCommitWorkBatchService> や <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService> など、作業バッチを永続的ストアにコミットするサービスでは、`EnableRetries` パラメーターを次の例のように使用することで、トランザクションの再試行を有効にできます。  
+  
+```  
+<WorkflowRuntime Name="SampleApplication" UnloadOnIdle="false">  
+    <commonParameters>  
+        <add name="ConnectionString" value="Initial Catalog=WorkflowStore;Data Source=localhost;Integrated Security=SSPI;" />  
+        <add name="EnableRetries" value="True" />  
+    </commonParameters>  
+    <Services>  
+        <add type="System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService, System.Workflow.Runtime, Version=3.0.00000.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" EnableRetries="False" />   
+     </Services>  
+</WorkflowRuntime>  
+```  
+  
+ `EnableRetries` パラメーターは、*CommonParameters* セクションのようにグローバル レベルで設定したり、*Services* セクションのように `EnableRetries` をサポートするサービスごとに設定したりできます。  
+  
+ 共通パラメーターをプログラムによって変更する方法を次のコード例に示します。  
+  
+```  
+Configuration config=WebConfigurationManager.OpenWebConfiguration("/Workflow", "Default Web Site", null, "localhost");  
+WorkflowRuntimeSection wfruntime=config.GetSection("WorkflowRuntime") as WorkflowRuntimeSection;  
+NameValueConfigurationCollection commonParameters=wfruntime.CommonParameters;  
+commonParameters["ConnectionString"].Value="another connection string";  
+config.Save();  
+```  
+  
+ 構成ファイルを使用して Windows Workflow Foundation ホスト アプリケーションの <xref:System.Workflow.Runtime.WorkflowRuntime> オブジェクトの動作を制御する方法の詳細については、「[Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<commonParameters>  
+   <add name="ConnectionString" value="Initial Catalog=WorkflowStore;Data Source=localhost;Integrated Security=SSPI;"/>  
+   <add name="EnableRetries" value="true"/>  
+</commonParameters>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WorkflowRuntimeElement>   
+ <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>   
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ <xref:System.Workflow.Runtime.Hosting.DefaultWorkflowCommitWorkBatchService>   
+ <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService>   
+ [Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-commonparameters.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/compositeduplex.md b/docs/framework/configure-apps/file-schema/wcf/compositeduplex.md
new file mode 100644
index 00000000000..b73648d099f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/compositeduplex.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;compositeDuplex&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 725004d1-ce88-4405-a220-78e89844f81f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;compositeDuplex&gt;
+サービスがメッセージをクライアントに返送するためのエンドポイントをクライアントが公開する必要がある場合に使用される、バインディング要素を定義します。  
+  
+## 構文  
+  
+```  
+  
+<compositeDuplex clientBaseAddress="URI" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|clientBaseAddress|二重モードのバック チャネルのアドレスを設定する URI。  サービスは、このアドレスを使用して、クライアントへのアクセス、接続の確立を行います。<br /><br /> この属性が設定されていない場合は、既定のアドレス “`full qualified name+default port\TemporaryIndigoAddress\guid`” が生成されます。  既定値は、`null` です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ たとえば HTTP のように、この構成要素はネイティブでの二重通信を許可しないトランスポートで使用されます。  これとは対照的に、TCP では、二重通信がネイティブで許可されているので、クライアントにメッセージを返信するためにこのバインディング要素をサービスで使用する必要はありません。  
+  
+ クライアントは、サービスのアドレスを公開して、アクセスおよび接続の確立ができるようにする必要があります。  このクライアント アドレスは、`clientBaseAddress` 属性によって提供されます。  ClientBaseAddress がユーザーによって明示的に設定されていない場合は、WCF \(Windows Communication Foundation\) によって自動的に生成されます。  
+  
+## 使用例  
+  
+```  
+<compositeDuplex clientBaseAddress="http://www.contoso.com" />  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.CompositeDuplexElement>   
+ <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings-of-tcptransport.md b/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings-of-tcptransport.md
new file mode 100644
index 00000000000..b2df3402fbf
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings-of-tcptransport.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;tcpTransport&gt; の &lt;connectionPoolSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2fbc3aa7-fcc9-4193-99a3-85d31d60d3f7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;tcpTransport&gt; の &lt;connectionPoolSettings&gt;
+TCP トランスポートの追加の接続プール設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<connectionPoolSettings  
+    groupName=”String”  
+    idleTimeout"TimeSpan"  
+        leaseTimeout="TimeSpan"  
+    maxOutboundConnectionsPerEndpopint=”Integer” />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`groupName`|送信チャネルに使用される接続プールの名前を定義する文字列です。  ストリーム配信モードでは、接続が共有されません。したがって、接続プールは無効です。  既定は、"default" 文字列です。  この値を変更して、特定のクライアントの接続を、個別のグループに分離できます。|  
+|`idleTimeout`|接続が切断されるまでの最大アイドル時間を指定する正の <xref:System.TimeSpan>。  既定値は 00:02:00 です。|  
+|`leaseTimeout`|アクティブな接続が終了されるまでの時間を指定する <xref:System.TimeSpan>。  既定値は 00:05:00 です。<br /><br /> 接続は、接続キャッシュに返された後、アクティブに転送中ではないときに終了します。  TCP トランスポートによって使用される接続キャッシュは、各エンドポイントの必要に応じて、`maxOutboundConnectionsPerEndpoint` で設定されているキャッシュ制限内で新しい接続を作成します。|  
+|`maxOutboundConnectionsPerEndpoint`|そのサービスによって開始されるリモート エンドポイントへの接続の最大数を指定する正の整数。  制限を超えた接続は、制限内に空きができるまでキューに置かれます。  `idleTimeout` は、例外がスローされるまでに接続をキューに入れたままにする期間を制限します。  既定値は 10 です。<br /><br /> この属性は、クライアントから特定のサービス エンドポイントへの接続で、同時にアクティブできる接続数を制限します。  この値よりも多くのアクティブなクライアント接続がある場合、サービスは、クライアントに応答しないように見える可能性があります。  この場合は、この値を調整して、予想される特定のエンドポイントへの同時クライアント接続の最大数より大きくする必要があります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedPipeTransport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/namedpipetransport.md)|チャネルで名前付きパイプを使用してメッセージを転送するトランスポートを定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TcpConnectionPoolSettingsElement>   
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement.ConnectionPoolSettings%2A>   
+ <xref:System.ServiceModel.Channels.TcpConnectionPoolSettings>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings.md b/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings.md
new file mode 100644
index 00000000000..986754d9884
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings.md
@@ -0,0 +1,63 @@
+---
+title: "&lt;connectionPoolSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6fa7fa65-2c6e-4eab-b8cf-7690112c0be5
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;connectionPoolSettings&gt;
+名前付きパイプ バインディングの追加の接続プール設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<connectionPoolSettings  
+        groupName=”String”  
+    idleTimeout"TimeSpan"  
+    maxOutboundConnectionsPerEndpopint=”Integer” />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`groupName`|送信チャネルに使用される接続プールの名前を定義する文字列です。  ストリーム配信モードでは、接続が共有されません。したがって、接続プールは無効です。  既定は、"default" 文字列です。  この値を変更して、特定のクライアントの接続を、個別のグループに分離できます。|  
+|`idleTimeout`|接続が切断されるまでの最大アイドル時間を指定する正の <xref:System.TimeSpan>。  既定値は 00:02:00 です。|  
+|`maxOutboundConnectionsPerEndpoint`|そのサービスによって開始されるリモート エンドポイントへの接続の最大数を指定する正の整数。  制限を超えた接続は、制限内に空きができるまでキューに置かれます。  `idleTimeout` は、例外がスローされるまでに接続をキューに入れたままにする期間を制限します。  既定値は 10 です。<br /><br /> この属性は、クライアントから特定のサービス エンドポイントへの接続で、同時にアクティブできる接続数を制限します。  この値よりも多くのアクティブなクライアント接続がある場合、サービスは、クライアントに応答しないように見える可能性があります。  この場合は、この値を調整して、予想される特定のエンドポイントへの同時クライアント接続の最大数より大きくする必要があります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedPipeTransport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/namedpipetransport.md)|チャネルで名前付きパイプを使用してメッセージを転送するトランスポートを定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.NamedPipeConnectionPoolSettingsElement>   
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement.ConnectionPoolSettings%2A>   
+ <xref:System.ServiceModel.Channels.NamedPipeConnectionPoolSettings>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/contracttypenames.md b/docs/framework/configure-apps/file-schema/wcf/contracttypenames.md
new file mode 100644
index 00000000000..37f2542cd1e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/contracttypenames.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;contractTypeNames&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ec5efc6-87f8-4160-9be0-dcd2e01df3df
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;contractTypeNames&gt;
+検索対象サービスのコントラクト名であるコントラクト型名のリストと、サービスを検索するときに一般的に使用される条件を指定する構成セクション。  複数のコントラクト名が指定されると、すべてのコントラクトに一致するサービス エンドポイントのみが適用されます。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] では、1 つのエンドポイントでサポートされるのは 1 つのコントラクトだけであることに注意してください。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <dynamicEndpoint>   
+          <standardEndpoint>  
+             <discoveryClientSettings discoveryEndpoint=”String” >  
+               <findCriteria duration=”TimeSpan”  
+                  maxResults=”Integer”   
+                  scopeMatchBy=”Uri” >  
+                  <contractTypeNames>  
+                     <add name="String" namespace="String" />  
+                  <contractTypeNames>  
+                  <extensions />  
+                  <scopes>  
+                    <add scope="URI"/>  
+                  </scopes>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+          <standardEndpoint>  
+       </dynamicEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/contracttypenames.md)|コントラクト型名は、サービスを検索するときに一般的に使用される条件セットを参照するプロパティです。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<findCriteria\>](../../../../../docs/framework/configure-apps/file-schema/wcf/findcriteria.md)|探索サービスの検索にクライアント アプリケーションによって使用される基準を提供する構成要素。  基準は、\(探しているサービスを指定する\) 検索条件と \(検索をどのくらい続けるかを指定する\) 検索終了条件にグループ化できます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.FindCriteria>   
+ <xref:System.ServiceModel.Discovery.Configuration.FindCriteriaElement>   
+ <xref:System.ServiceModel.Discovery.Configuration.ContractTypeNameElementCollection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/custom.md b/docs/framework/configure-apps/file-schema/wcf/custom.md
new file mode 100644
index 00000000000..d748b23ca12
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/custom.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;custom&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6f65a00-bd1a-4d4a-955a-fe009ec02ab8
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;custom&gt;
+ユーザー設定のピア リゾルバー サービスの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<custom address="Uri"  
+   resolverType="String">  
+      <headers/>  
+   <identity/>  
+</peerResolver>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`address`|カスタム ピア リゾルバー サービスをホストするピア ノードのエンドポイント アドレスを指定する URI。|  
+|`resolverType`|カスタム ピア リゾルバー サービスの種類を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|この要素を使用して構成されたカスタム ピア リゾルバーの ID を指定します。  この要素は <xref:System.ServiceModel.Configuration.IdentityElement> 型です。|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|カスタム ピア リゾルバーによって処理される SOAP メッセージに使用するアドレス ヘッダーのコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<resolver\>](../../../../../docs/framework/configure-apps/file-schema/wcf/resolver.md)|ピア メッシュ ID を解決してメッシュに参加する複数ノードを表すピア ノード アドレスのセットを取得するために使用されるピア リゾルバー。|  
+  
+## 解説  
+ この要素は、サービスをホストするピアのエンドポイント アドレスや特定のバインディング設定など、カスタム ピア リゾルバー サービスの基本設定を定義します。  カスタム リゾルバーを作成する方法の詳細については、「[Adding a Custom Resolver to a PeerChannel Application](http://msdn.microsoft.com/ja-jp/12aa3787-2962-439c-ad27-46523c8b0419)」を参照してください。  
+  
+## 参照  
+ <xref:System.Servicemodel.PeerResolvers.CustomPeerResolverService>   
+ <xref:System.ServiceModel.PeerResolvers.PeerCustomResolverSettings>   
+ <xref:System.ServiceModel.Configuration.PeerResolverElement.Custom%2A>   
+ <xref:System.ServiceModel.Configuration.PeerCustomResolverElement>   
+ [ピア リゾルバー](../../../../../docs/framework/wcf/feature-details/peer-resolvers.md)   
+ [Adding a Custom Resolver to a PeerChannel Application](http://msdn.microsoft.com/ja-jp/12aa3787-2962-439c-ad27-46523c8b0419)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/custombinding.md b/docs/framework/configure-apps/file-schema/wcf/custombinding.md
new file mode 100644
index 00000000000..9a69ffcc320
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/custombinding.md
@@ -0,0 +1,314 @@
+---
+title: "&lt;customBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 9da4f960-f64e-4d8a-894d-2b09eba5ce4b
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# &lt;customBinding&gt;
+ユーザーのメッセージ スタックを完全に制御できます。  
+  
+## 構文  
+  
+```  
+  
+<customBinding>  
+    <binding name="string"  
+        closeTimeout="TimeSpan"  
+        openTimeout="TimeSpan"   
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+       <compositeDuplex clientBaseAddress="Uri"/>  
+       <reliableSession acknowledgementInterval="TimeSpan"  
+           advancedFlowControl="Boolean"   
+           bufferedMessagesQuota="Integer"  
+           inactivityTimeout="TimeSpan"  
+           maxPendingChannels="Integer"  
+           maxRetryCount="Integer"   
+           ordered="Boolean" />  
+       <pnrpPeerResolver />  
+       <windowsStreamSecurity protectionLevel="None/Sign/EncryptAndSign"/>  
+       <sslStreamSecurity requireClientCertificate="Boolean" />  
+              <transactionFlow transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"/>  
+       <security   
+          defaultAlgorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+           authenticationMode="UserNameForAnonymous"  
+           contextMode="Cookie"   
+           defaultProtectionLevel="Sign"  
+           enableKeyDerivation="false"  
+           keyEntropyMode="ClientEntropy"   
+                  messageProtectionOrder="SignBeforeEncryptAndEncryptSignature"   
+           securityVersion="WSSecurityXXX2005">  
+           <localClientSettings cacheCookies="false"  
+               detectReplays="false"  
+               maxCookieCachingTime="00:07:24" />  
+           <localServiceSettings replayCacheSize="9"  
+               maxClockSkew="00:00:03"   
+               replayWindow="00:07:22.2190000" />  
+       </security>  
+       <binaryMessageEncoding maxReadPoolSize="Integer"  
+           maxWritePoolSize="Integer"  
+           maxSessionSize="Integer" />  
+       <httpsTransport manualAddressing="Boolean"  
+           maxMessageSize="Integer"  
+           authenticationScheme="Negotiate"   
+           bypassProxyOnLocal="Boolean"  
+           hostNameComparisonMode="Exact"   
+           mapAddressingHeadersToHttpHeaders="Boolean"   
+           proxyaddress="Uri"  
+           realm="String"   
+           requireClientCertificate="Boolean" />  
+       <peerTransport manualAddressing="false"  
+          maxMessageSize="20002"  
+          listenIPAddress="202.10.1.9"   
+          messageAuthentication="false"  
+          peerNodeAuthenticationMode="None"  
+          port="1000" />  
+  
+<security   
+      defaultAlgorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+   authenticationMode="UserNameForAnonymous"  
+   bootstrapBindingConfiguration="String"  
+   bootstrapBindingSectionName="String"  
+   defaultProtectionLevel="None/Sign/EncryptAndSign"  
+      requireDerivedKeys="Boolean"  
+   securityHeaderLayout="Strict/Lax/LaxTimestampFirst/LaxTimestampLast"  
+   includeTimestamp="Boolean"  
+   keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"   
+   messageProtectionOrder="SignBeforeEncrypt/SignBeforeEncryptAndEncryptSignature/EncryptBeforeSign"   
+   protectTokens="Boolean"  
+   requireSecurityContextCancellation="Boolean"  
+   securityVersion=" WSSecurityJan2004/WSSecurityXXX2005"  
+   requireSignatureConfirmation="Boolean" >  
+   <localClientSettings cacheCookies="Boolean"  
+      detectReplays="Boolean"  
+      replayCacheSize="Integer"  
+      maxClockSkew="TimeSpan"  
+      maxCookieCachingTime="TimeSpan"  
+      replayWindow="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      reconnectOnTransportFailure="Boolean"  
+      timestampValidityDuration="TimeSpan"  
+      cookieRenewalThresholdPercentage="Integer" />  
+   <localServiceSettings detectReplays="Boolean"  
+      issuedCookieLifeTime="TimeSpan"  
+      maxStatefulNegotiations="Integer"  
+            replayCacheSize="Integer"  
+      maxClockSkew="TimeSpan"   
+      negotiationTimeout="TimeSpan"  
+      replayWindow="TimeSpan"  
+      inactivityTimeout="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      reconnectOnTransportFailure="Boolean"  
+      maxConcurrentSessions="Integer"  
+      timestampValidityDuration="TimeSpan" />  
+   <federationParameters trustVersion="WSTrustApr2004/WSTrustFeb2005" />  
+<security   
+   defaultAlgorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/ Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+   authenticationMode="UserNameForAnonymous"  
+   bootstrapBindingConfiguration="String"  
+   bootstrapBindingSectionName="String"  
+   defaultProtectionLevel="None/Sign/EncryptAndSign"  
+      requireDerivedKeys="Boolean"  
+   securityHeaderLayout="Strict/Lax/LaxTimestampFirst/LaxTimestampLast"  
+   includeTimestamp="Boolean"  
+   keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"   
+   messageProtectionOrder="SignBeforeEncrypt/SignBeforeEncryptAndEncryptSignature/EncryptBeforeSign"   
+   protectTokens="Boolean"  
+   requireSecurityContextCancellation="Boolean"  
+   securityVersion=" WSSecurityJan2004/WSSecurityXXX2005"  
+   requireSignatureConfirmation="Boolean" >  
+   <localClientSettings cacheCookies="Boolean"  
+      detectReplays="Boolean"  
+      replayCacheSize="Integer"  
+      maxClockSkew="TimeSpan"  
+      maxCookieCachingTime="TimeSpan"  
+      replayWindow="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      reconnectOnTransportFailure="Boolean"  
+      timestampValidityDuration="TimeSpan"  
+      cookieRenewalThresholdPercentage="Integer" />  
+   <localServiceSettings detectReplays="Boolean"  
+      issuedCookieLifeTime="TimeSpan"  
+      maxStatefulNegotiations="Integer"  
+            replayCacheSize="Integer"  
+      maxClockSkew="TimeSpan"   
+      negotiationTimeout="TimeSpan"  
+      replayWindow="TimeSpan"  
+      inactivityTimeout="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      reconnectOnTransportFailure="Boolean"  
+      maxConcurrentSessions="Integer"  
+      timestampValidityDuration="TimeSpan" />  
+   <federationParameters trustVersion="WSTrustApr2004/WSTrustFeb2005" />  
+   <GenericIssuedTokenParameters>   
+      <LocalIssuerIssuedTokenParameters keyType=" SymmeticKey/PublicKey"  
+        keySize="Integer"  
+        tokenType="String" />  
+     <IssuedTokenParametersEndpointAddress address="URI"  
+        bindingConfiguration="String"  
+        binding="String" />  
+     <IssuedTokenClient localIssuerChannelBehaviors="String"  
+        cacheIssuedTokens="Boolean"  
+        maxIssuedTokenCachingTime="TimeSpan"  
+        keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy" />  
+     <IssuedTokenClientBehavior issuerAddress="String"  
+        behaviorConfiguration="String" />  
+     <IssuedTokenClientBehavior address="URI"  
+        bindingConfiguration="String"  
+        binding="String" />  
+   </GenericIssuedTokenParameters>   
+</security>  
+</binding>  
+</customBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、カスタム バインディングの識別文字列として機能するユーザー定義文字列です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<compositeDuplex\>](../../../../../docs/framework/configure-apps/file-schema/wcf/compositeduplex.md)|カスタム バインディングの双方向のメッセージングを指定します。  たとえば HTTP のように、ネイティブでの二重通信を許可しないトランスポートで使用されます。  これとは対照的に、TCP では、二重通信がネイティブで許可されているので、クライアントにメッセージを返信するためにこのバインディング要素をサービスで使用する必要はありません。<br /><br /> クライアントは、サービスのアドレスを公開して、アクセスおよび接続の確立ができるようにする必要があります。  このクライアント アドレスは、`ClientBaseAddress` 属性によって提供されます。<br /><br /> この要素は <xref:System.ServiceModel.Configuration.CompositeDuplexElement> 型です。|  
+|[\<pnrpPeerResolver\>](../../../../../docs/framework/configure-apps/file-schema/wcf/pnrppeerresolver.md)|PNRP \(Peer Name Resolution Protocol\) ピア名リゾルバーを指定します。  この要素は <xref:System.ServiceModel.Configuration.PnrpPeerResolverElement> 型です。|  
+|[\<reliableSession\>](../../../../../docs/framework/configure-apps/file-schema/wcf/reliablesession.md)|WS\-ReliableMessaging の設定を指定します。  この要素がカスタム バインディングに追加される場合、その結果となるチャネルにより、正確に 1 回の配信保証をサポートできます。  この要素は <xref:System.ServiceModel.Configuration.ReliableSessionElement> 型です。|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)|カスタム バインディングのセキュリティ オプションを指定します。  この要素は <xref:System.ServiceModel.Configuration.SecurityElement> 型です。|  
+|[\<sslStreamSecurity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md)|SSL ストリーム バインディングのセキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.SslStreamSecurityElement> 型です。|  
+|[\<transactionFlow\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transactionflow.md)|バインディングがトランザクション フローをサポートし、プロトコルが `transactionProtocol` 属性によって使用される必要があることを指定します。  この要素は <xref:System.ServiceModel.Configuration.TransactionFlowElement> 型です。|  
+|[\<windowsStreamSecurity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/windowsstreamsecurity.md)|カスタム バインディングのストリーミング セキュリティのオプションを指定します。  この要素は <xref:System.ServiceModel.Configuration.WindowsStreamSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインディング|Windows Communication Foundation アプリケーションのすべてのバインディングを含みます。|  
+  
+## 解説  
+ カスタム バインディングを使用すると、WCF メッセージ スタックのフル コントロールが可能になります。  特定のエンティティの構成要素を追加した、特別にカスタマイズされたバインディングを作成できます。  たとえば、ユーザーは `httpsTransport` セクション、`reliableSession` セクション、および `security` セクションを組み合わせて、信頼できるセキュリティで保護された HTTPS ベースのバインディングを作成できます。  
+  
+ 個別のバインディングは、メッセージ スタックを、スタック要素の構成要素をスタックに出現する順序で指定することにより定義します。  各要素は、スタック内の 1 つの要素を定義および構成します。  各カスタム バインディング内のトランスポート要素は 1 つだけにする必要があります。  この要素がない場合、メッセージ スタックは不完全です。  
+  
+ 要素がスタックに出現する順序は重要です。それは、その順序で操作がメッセージに適用されるためです。  スタック要素で推奨される順序を次に示します。  
+  
+1.  トランザクション \(省略可能\)  
+  
+2.  リライアブル メッセージ機能 \(省略可能\)  
+  
+3.  セキュリティ \(省略可能\)  
+  
+4.  Transport  
+  
+5.  エンコーダー \(省略可能\)  
+  
+ システムが提供するバインディングの中にサービスの要件を満たすものがない場合は、カスタム バインディングを使用します。  たとえば、カスタム バインドを使用すると、サービス エンドポイントで新しいトランスポートや新しいエンコーダーを使用できます。  
+  
+ カスタム バインドは、特定の順序で "積み重ねられている" バインド要素のコレクションから <xref:System.ServiceModel.Channels.CustomBinding.%23ctor%2A> の 1 つを使用して作成します。  
+  
+-   最上位にあるのは、トランザクションのフローを可能にするオプションの <xref:System.ServiceModel.Channels.TransactionFlowBindingElement> です。  
+  
+-   その次にあるのは、WS\-ReliableMessaging 仕様で定義されているセッションおよび順序指定のメカニズムを提供するオプションの <xref:System.ServiceModel.Channels.ReliableSessionBindingElement> です。  このセッションの概念は、SOAP およびトランスポート中継局を通過できます。  
+  
+-   その次にあるのは、承認、認証、保護、機密性などのセキュリティ機能を提供するオプションのセキュリティ バインド要素です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] では、次のセキュリティ バインド要素が提供されています。  
+  
+    -   <xref:System.ServiceModel.Channels.SecurityBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>  
+  
+-   その次にあるのは、バインド要素によって指定されるオプションのメッセージ パターンです。  
+  
+-   <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement>  
+  
+-   その次にあるのは、オプションのトランスポート アップグレード\/ヘルパー バインド要素です。  
+  
+    -   <xref:System.ServiceModel.Channels.PnrpPeerResolverBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>  
+  
+-   その次にあるのは、必須のメッセージ エンコード バインディング要素です。  独自のトランスポートを使用することも、以下のメッセージ エンコード バインドのいずれかを使用することもできます。  
+  
+    -   <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>  
+  
+-   最下位には、必須のトランスポート要素があります。  独自のトランスポートを使用することも、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] で提供されるトランスポート バインド要素のいずれかを使用することもできます。  
+  
+    -   <xref:System.ServiceModel.Channels.TcpTransportBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.HttpTransportBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.MsmqTransportBindingElement>  
+  
+    -   <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.PeerTransportBindingElement>  
+  
+ 各層のオプションの概要を次の表に示します。  
+  
+|レイヤー|オプション|必須|  
+|----------|-----------|--------|  
+|トランザクション フロー|<xref:System.ServiceModel.Channels.TransactionFlowBindingElement>|Ｘ|  
+|信頼性|<xref:System.ServiceModel.Channels.ReliableSessionBindingElement>|Ｘ|  
+|セキュリティ|同期、非同期、トランスポート レベル|Ｘ|  
+|形状の変更|<xref:System.ServiceModel.Channels.CompositeDuplexBindingElement>|Ｘ|  
+|トランスポートのアップグレード|SSL ストリーム、Windows ストリーム、ピア リゾルバー|Ｘ|  
+|エンコーディング|テキスト、バイナリ、MTOM、カスタム|はい|  
+|Transport|TCP、名前付きパイプ、HTTP、HTTPS、MSMQ のフレーバー、カスタム|はい|  
+  
+ さらに、独自のバインド要素を定義し、それを定義済みの層のいずれかの間に挿入できます。  
+  
+ カスタム バインディングを使用してシステム提供のバインディングを変更する方法については、「[方法 : システム指定のバインディングをカスタマイズする](../../../../../docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.Configuration.BindingsSection>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [customBinding Element](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/customtrackingqueries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/customtrackingqueries-of-wcf.md
new file mode 100644
index 00000000000..cfc87bde42a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/customtrackingqueries-of-wcf.md
@@ -0,0 +1,63 @@
+---
+title: "WCF の &lt;customTrackingQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14cfe47e-9935-4120-84f1-8f38de8ca4c1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;customTrackingQueries&gt;
+コード アクティビティで定義するイベントを追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がカスタム追跡レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<customTrackingQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md)|コード アクティビティで定義するイベントを追跡するために使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CustomTrackingQuery](assetId:///System.Activities.Tracking.CustomTrackingQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/customtrackingquery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/customtrackingquery-of-wcf.md
new file mode 100644
index 00000000000..4a4be066aed
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/customtrackingquery-of-wcf.md
@@ -0,0 +1,64 @@
+---
+title: "WCF の &lt;customTrackingQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 164446ae-8440-4b67-b217-6786cfae1e01
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;customTrackingQuery&gt;
+コード アクティビティで定義するイベントを追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がカスタム追跡レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|追跡レコードを生成したアクティビティの名前を指定する文字列。|  
+|name|生成されたカスタム追跡レコードの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<customTrackingQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md)|コード アクティビティで定義するイベントを追跡するために使用するクエリ。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CustomTrackingQuery](assetId:///System.Activities.Tracking.CustomTrackingQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md
new file mode 100644
index 00000000000..961735a5490
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;dataContractSerializer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "<dataContractSerializer> 要素"
+  - "DataContractSerializer"
+  - "dataContractSerializer 要素"
+  - "KnownTypes"
+ms.assetid: f41fb4d5-24e7-4059-8010-286a30bfea93
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# &lt;dataContractSerializer&gt;
+<xref:System.Runtime.Serialization.DataContractSerializer> 用の設定データが含まれています。  この要素は、2 つの異なる階層で使用されます。  1 つは以下の「スキーマの階層」に示したもので、もう 1 つは「解説」に記載しています。  
+  
+## 構文  
+  
+```  
+  
+<dataContractSerializer ignoreExtensionDataObject="Boolean"  
+   maxItemsInObjectGraph="Integer" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|ignoreExtensionDataObject|エンドポイントがシリアル化または逆シリアル化されているときに、そのエンドポイントにより提供されるデータを無視するかどうかを指定するブール値。  この属性は、`<behavior>` 要素の下の `<dataContractSerializer>` でのみ設定可能です。|  
+|maxItemsInObjectGraph|シリアル化または逆シリアル化する項目の最大数を指定する整数。  この属性は 65536 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md)|サービスの動作設定のコレクション。|  
+|[\<system.runtime.serialization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md)|<xref:System.Runtime.Serialization> 名前空間セクションのルート要素を表し、<xref:System.Runtime.Serialization.DataContractSerializer> のオプションを設定するための要素を含みます。|  
+  
+## 解説  
+ このトピックの冒頭で述べたように、この階層は \<X509Extension\> 要素が使用される 2 つ目の階層です。  
+  
+ [\<system.runtime.serialization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md)  
+  
+ [\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)  
+  
+ 既知の型の詳細については、<xref:System.Runtime.Serialization.DataContractSerializer> を参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior>   
+ <xref:System.ServiceModel.Configuration.DataContractSerializerElement>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [データ転送とシリアル化](../../../../../docs/framework/wcf/feature-details/data-transfer-and-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md
new file mode 100644
index 00000000000..c9120c990df
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;system.runtime.serialization&gt; の &lt;dataContractSerializer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9b3d625-be3f-4768-8e0d-1b7e6929f6a8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;system.runtime.serialization&gt; の &lt;dataContractSerializer&gt;
+<xref:System.Runtime.Serialization.DataContractSerializer> 用の設定データが含まれています。  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+  <system.runtime.serialization>  
+    <dataContractSerializer ignoreExtensionDataObject="Boolean"  
+            maxItemsInObjectGraph="Integer">  
+      <declaredTypes>  
+        <add type="String">  
+          <knownType type="String">  
+             <parameter index="Integer"  
+                        type="String" />  
+          </knownType>  
+        </add>  
+      </declaredTypes>  
+    <dataContractSerializer>  
+  </system.runtime.serialization>  
+</configuration>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|ignoreExtensionDataObject|エンドポイントがシリアル化または逆シリアル化されているときに、そのエンドポイントにより提供されるデータを無視するかどうかを指定するブール値。  この属性は、`<behavior>` 要素の下の `<dataContractSerializer>` でのみ設定可能です。|  
+|maxItemsInObjectGraph|シリアル化または逆シリアル化する項目の最大数を指定する整数。  この属性は 65536 です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<declaredTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/declaredtypes.md)|逆シリアル化時に <xref:System.Runtime.Serialization.DataContractSerializer> が使用する既知の型が含まれています。<br /><br /> データ コントラクトと既知の型の詳細については、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.runtime.serialization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md)|<xref:System.Runtime.Serialization> 名前空間セクションのルート要素を表し、<xref:System.Runtime.Serialization.DataContractSerializer> のオプションを設定するための要素を含みます。|  
+  
+## 解説  
+ 既知の型の詳細については、「<xref:System.Runtime.Serialization.DataContractSerializer>」および「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/datacontractserializer.md b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer.md
new file mode 100644
index 00000000000..43750039688
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/datacontractserializer.md
@@ -0,0 +1,60 @@
+---
+title: "dataContractSerializer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a47513a4-a96c-4350-8586-daacb05dee71
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# dataContractSerializer
+<xref:System.Runtime.Serialization.DataContractSerializer> 用の設定データが含まれています。  
+  
+## 構文  
+  
+```  
+  
+<dataContractSerializer ignoreExtensionDataObject="Boolean"  
+      maxItemsInObjectGraph="Integer" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|ignoreExtensionDataObject|エンドポイントがシリアル化または逆シリアル化されているときに、そのエンドポイントにより提供されるデータを無視するかどうかを指定するブール値。|  
+|maxItemsInObjectGraph|シリアル化または逆シリアル化する項目の最大数を指定する整数。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 解説  
+ 既知の型の詳細については、<xref:System.Runtime.Serialization.DataContractSerializer> のドキュメントを参照してください。  
+  
+> [!CAUTION]
+>  `<dataContractSerializer>` 動作要素が存在する場合は、構成ファイル内で `<enableWebScript>` 動作要素よりも前に出現する必要があります。  それ以外の場合は、動作結果は未定義になります。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior>   
+ <xref:System.ServiceModel.Configuration.DataContractSerializerElement>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [データ転送とシリアル化](../../../../../docs/framework/wcf/feature-details/data-transfer-and-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/declaredtypes.md b/docs/framework/configure-apps/file-schema/wcf/declaredtypes.md
new file mode 100644
index 00000000000..c6673ed2b94
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/declaredtypes.md
@@ -0,0 +1,99 @@
+---
+title: "&lt;declaredTypes&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "<declaredTypes> 要素"
+  - "DataContractSerializer"
+  - "dataContractSerializer 要素"
+  - "declaredTypes 要素"
+  - "KnownTypes"
+ms.assetid: f35184e4-9d9e-4d37-8fb4-d5b58220eb3e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;declaredTypes&gt;
+逆シリアル化時に <xref:System.Runtime.Serialization.DataContractSerializer> が使用する既知の型が含まれています。  
+  
+ データ コントラクトと既知の型の詳細については、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+  <system.runtime.serialization>  
+    <dataContractSerializer>  
+      <declaredTypes>  
+        <add type="String ">  
+          <knownType type="String">  
+                <parameter index="Integer"/>  
+          </knownType>  
+        </add>  
+      </declaredTypes>  
+    <dataContractSerializer>  
+  </system.runtime.serialization>  
+</configuration>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)|既知の型を必要とする型を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md)|<xref:System.Runtime.Serialization.DataContractSerializer> 用の設定データが含まれています。|  
+  
+## 解説  
+ 既知の型[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」および「<xref:System.Runtime.Serialization.DataContractSerializer>」を参照してください。  
+  
+## 使用例  
+ 次の XML コードに、`DataContractSerializer`  要素に追加された宣言型と既知の型を示します。  この例は、追加された 3 つの型を示しています。  最初の型は、"Item" という既知の型を使用する "Orders" という名前のカスタム型です。  2 つ目の宣言型は、既知の型として `Item` を使用する <xref:System.Collections.Generic.List%601> です。  最後の 3 つ目の宣言型は、<xref:System.Collections.Generic.Dictionary%602> です。  <xref:System.Collections.Generic.Dictionary%602> クラスの型は、2 種類のパラメーターを持つジェネリック型です。  最初のパラメーターはキーを表し、2 番目のパラメーターは値を表します。  次の例は、2 番目の型 \(値\) の <xref:System.Collections.Generic.List%601> を既知の型の一覧に追加します。  `index` 属性を使用して、既知の型で使用する型パラメーターを指定する必要があります。  この場合には、"1" に設定された index 属性 \(コレクションは 0 から始まる\) によって値型が示されます。  
+  
+```  
+<configuration>  
+  <system.runtime.serialization>  
+    <dataContractSerializer>  
+      <declaredTypes>  
+        <add type="Examples.Types.Orders, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">  
+          <knownType type="Examples.Types.Item, SerializationTypes, Version=2.0.0.0, Culture=neutral, PublicKey=null" />  
+        </add>  
+        <add type="System.Collections.Generic.List`1, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">  
+          <knownType type="Examples.Types.Item, SerializationTypes, Version=2.0.0.0, Culture=neutral, PublicKey=null" />  
+        </add>  
+        <add type="System.Collections.Generic.Dictionary`2, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">  
+          <knownType type="System.Collections.Generic.List`1, SerializationTypes, Version = 2.0.0.0, Culture = neutral, PublicKeyToken=null">  
+            <parameter index="1"/>  
+          </knownType>  
+        </add>  
+      </declaredTypes>  
+    <dataContractSerializer>  
+  </system.runtime.serialization>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md b/docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md
new file mode 100644
index 00000000000..c8efb1dd025
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md
@@ -0,0 +1,106 @@
+---
+title: "&lt;defaultCertificate&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1ddf364-9a00-45d3-b989-ff381c154ce6
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;defaultCertificate&gt; 要素
+ネゴシエーション プロトコル経由でサービスまたは STS が証明書を提供しないときに使用される X.509 証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<defaultCertificate findValue="String"   
+storeLocation=" CurrentUser/LocalMachine"  
+storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"   
+x509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialiNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|findValue|文字列。  検索対象の値。|  
+|x509FindType|列挙値。  検索する証明書フィールドのいずれかです。|  
+|storeLocation|列挙値。  検索する 2 つのシステム格納場所のいずれかです。|  
+|storeName|列挙値。  検索するシステム ストアのいずれかです。|  
+  
+## findValue 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|値は、検索されるフィールド \(X509FindType 属性により指定される\) によって異なります。  たとえば、サムプリント検索する場合、値は 16 進数の文字列にする必要があります。|  
+  
+## x509FindType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、FindByThumbprint、FindBySubjectName、FindBySubjectDistinguishedName、FindByIssuerName、FindByIssuerDistinguishedName、FindBySerialNumber、FindByTimeValid、FindByTimeNotYetValid、FindBySerialNumber、FindByTimeExpired、FindByTemplateName、FindByApplicationPolicy、FindByCertificatePolicy、FindByExtension、FindByKeyUsage、FindBySubjectKeyIdentifier です。|  
+  
+## storeLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|CurrentUser または LocalMachine です。|  
+  
+## storeName 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|値は、AddressBook、AuthRoot、CertificateAuthority、Disallowed、My、Root、TrustedPeople、および TrustedPublisher です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md)|クライアントに対してサービスを認証する際に使用される証明書を指定します。|  
+  
+## 解説  
+ 証明書ベースのメッセージ セキュリティを使用するバインディングでは、この構成要素で指定された証明書を使用して、サービスへのメッセージが暗号化されます。この証明書は、サービスがクライアントへの応答に署名するためにも使用されます。  この要素には、サービスで証明書が指定されていないときに使用する証明書を 1 つ格納できます。  
+  
+## 使用例  
+ URI が http:\/\/www.contoso.com で始まるエンドポイントに使用する証明書と、証明書ネゴシエーションを実行しない他のすべてのエンドポイントに使用する証明書を指定する例を次に示します。  
+  
+```  
+<serviceCertificate>  
+  <defaultCertificate findValue="www.contoso.com"   
+                      storeLocation="LocalMachine"  
+                      storeName="TrustedPeople"   
+                      x509FindType="FindByIssuerDistinguishedName" />  
+  <scopedCertificates>  
+     <add targetUri="http://www.contoso.com"   
+          findValue="www.contoso.com" storeLocation="LocalMachine"  
+                  storeName="Root" x509FindType="FindByIssuerName" />  
+  </scopedCertificates>  
+  <authentication revocationMode="Online"   
+   trustedStoreLocation="LocalMachine" />  
+</serviceCertificate>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509DefaultServiceCertificateElement>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.DefaultCertificate%2A>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [\<authentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/defaultports.md b/docs/framework/configure-apps/file-schema/wcf/defaultports.md
new file mode 100644
index 00000000000..1bceb1fd3cb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/defaultports.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;defaultPorts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 725d4ee5-bd46-4f0e-9c20-30ba75d6eb2c
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;defaultPorts&gt;
+クライアント アプリケーションがリッスンする既定の通信エンドポイントの一覧を表示する既定のポートのコレクション。  
+  
+## 構文  
+  
+```  
+  
+<useRequestHeadersForMetadataAddress>  
+   <defaultPorts>  
+      <add scheme="http" port="integer" />  
+   </defaultPorts>  
+</useRequestHeadersForMetadataAddress>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<defaultPorts\> の \<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-defaultports.md)|クライアント アプリケーションがリッスンする既定の通信エンドポイント。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<useRequestHeadersForMetadataAddress\>](../../../../../docs/framework/configure-apps/file-schema/wcf/userequestheadersformetadataaddress.md)|既定のポートの一覧。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DefaultPortElementCollection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/diagnostics-for-activation.md b/docs/framework/configure-apps/file-schema/wcf/diagnostics-for-activation.md
new file mode 100644
index 00000000000..280a426698f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/diagnostics-for-activation.md
@@ -0,0 +1,55 @@
+---
+title: "アクティベーションの &lt;diagnostics&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1486e0eb-fe2a-46c3-b584-c924889477dd
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# アクティベーションの &lt;diagnostics&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] リスナーの診断機能を構成します。  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+   <system.serviceModel.activation>  
+       <diagnostics performanceCountersEnabled="Boolean" />  
+   </system.serviceModel.activation>  
+</configuration>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`performanceCountersEnabled`|診断用パフォーマンス カウンターが有効であるかどうかを示すブール値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel.activation\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md)|リスナー プロセス SMSvcHost.exe の設定が含まれています。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration.DiagnosticSection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/diagnostics.md b/docs/framework/configure-apps/file-schema/wcf/diagnostics.md
new file mode 100644
index 00000000000..27c12b7e668
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/diagnostics.md
@@ -0,0 +1,94 @@
+---
+title: "&lt;diagnostics&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0c2f95c4-cc12-4fb5-a70c-7fc6fa95db58
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# &lt;diagnostics&gt;
+`diagnostics` 要素は、ランタイムの検査と管理を行う管理者が使用できる設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+   <diagnostics etwProviderId=”String”  
+       performanceCounters="Off/ServiceOnly/All/Default"         
+       wmiProviderEnabled="Boolean" >  
+       <endToEndTracing activityTracing="Boolean"  
+          messageFlowTracing="Boolean"  
+          propagateActivity="Boolean" />  
+       <messageLogging logEntireMessage="Boolean"  
+          logMalformedMessages="Boolean"  
+          logMessagesAtServiceLevel="Boolean"  
+          logMessagesAtTransportLevel="Boolean"  
+          maxMessagesToLog="Integer"  
+          maxSizeOfMessageToLog="Integer" >  
+          <filters>  
+             <clear />  
+          </filters>  
+       </messageLogging>  
+   </diagnostics>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|etwProviderId|イベントを ETW セッションに書き込むイベント追跡プロバイダーの識別子を指定する文字列。|  
+|performanceCounters|アセンブリのパフォーマンス カウンターが有効であるかどうかを指定します。  有効な値は、次のとおりです。<br /><br /> -   Off: パフォーマンス カウンターは無効です。<br />-   ServiceOnly: このサービスに関連するパフォーマンス カウンターのみ有効です。<br />-   All: パフォーマンス カウンターを実行時に表示できます。<br />-   既定値 : 単一のパフォーマンス カウンター インスタンス \_WCF\_Admin が作成されます。  このインスタンスは、インフラストラクチャで使用される SQM データのコレクションを有効にするために使用されます。  このインスタンスのカウンター値は更新されず、0 のままになります。  WCF の構成が存在しない場合は、これが既定値になります。|  
+|wmiProviderEnabled|アセンブリの WMI プロバイダーが有効であるかどうかを指定するブール値。  ユーザーが Windows Communication Foundation \(WCF\) の検査および制御機能に対する実行時アクセス権を取得するには、WMI プロバイダーが必要です。  既定値は、`false` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endToEndTracing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endtoendtracing.md)|サービス アプリケーションの実行中にエンドツーエンドのトレースのさまざまな側面を有効または無効にするための構成要素。|  
+|[\<messageLogging\>](../../../../../docs/framework/configure-apps/file-schema/wcf/messagelogging.md)|WCF メッセージ ログの設定について説明します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|serviceModel|すべての WCF 構成要素のルート要素です。|  
+  
+## 解説  
+ `diagnostics` セクションは、アセンブリに配置されるすべてのサービスの診断設定を定義します。  アセンブリ内のサービスが 1 つでない限り、サービス レベル別に診断設定を定義することはできません。  属性は、セクションの要件に応じて設定されます。  
+  
+## 使用例  
+  
+```  
+<diagnostics wmiProviderEnabled="false"  
+       performanceCounters="all">  
+       <messageLogging logEntireMessage="true"  
+          logMalformedMessages="true"  
+          logMessagesAtServiceLevel="true"  
+          logMessagesAtTransportLevel="true"  
+          maxMessagesToLog="42"  
+          maxSizeOfMessageToLog="42">  
+         <filters>  
+         <clear />  
+    </filters>  
+       </messageLogging>  
+</diagnostics>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DiagnosticSection>   
+ <xref:System.ServiceModel.Diagnostics>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/discoveryclient.md b/docs/framework/configure-apps/file-schema/wcf/discoveryclient.md
new file mode 100644
index 00000000000..2b80414498e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/discoveryclient.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;discoveryClient&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a78f74c3-1152-4149-ab29-3f12d316caeb
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;discoveryClient&gt;
+クライアント アプリケーションが実行時に探索可能なサービスを自動的に検索し、そのアドレスを見つけることができるカスタム バインディングを作成するための構成要素。  
+  
+## 構文  
+  
+```  
+  
+<discoveryClient discoveryEndpoint=”String” >  
+   <findCriteria duration=”TimeSpan”  
+       maxResults=”Integer”   
+       scopeMatchBy=”Uri” >  
+       <contractTypeNames>  
+          <add name="String" namespace="String" />  
+       <contractTypeNames>  
+       <extensions />  
+       <scopes>  
+          <add scope="URI"/>  
+       </scopes>  
+   </findCriteria>  
+</discoveryClient>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryEndpoint|クライアント アプリケーションが実行時に探索可能なサービスを自動的に検索し、そのアドレスを見つけることができる探索エンドポイントの名前を含む文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|探索サービスの検索にクライアント アプリケーションによって使用される基準を提供する構成要素。  基準は、\(探しているサービスを指定する\) 検索条件と \(検索をどのくらい続けるかを指定する\) 検索終了条件にグループ化できます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement>   
+ <xref:System.ServiceModel.Discovery.Configuration.DiscoveryClientElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/discoveryclientsettings.md b/docs/framework/configure-apps/file-schema/wcf/discoveryclientsettings.md
new file mode 100644
index 00000000000..f5bb642f7b8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/discoveryclientsettings.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;discoveryClientSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02e1b823-a8bb-4074-90d5-8599f71e8f9d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;discoveryClientSettings&gt;
+サービス探索プロセスにクライアントとして参加するためにアプリケーションが必要とする設定を格納します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <dynamicEndpoint>   
+          <standardEndpoint>  
+             <discoveryClientSettings discoveryEndpoint=”String” >  
+               <findCriteria duration=”TimeSpan”  
+                  maxResults=”Integer”   
+                  scopeMatchBy=”Uri” >  
+                  <contractTypeNames>  
+                     <add name="String" namespace="String" />  
+                  <contractTypeNames>  
+                  <extensions />  
+                  <scopes>  
+                    <add scope="URI"/>  
+                  </scopes>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+          <standardEndpoint>  
+       </dynamicEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryEndpoint|クライアント アプリケーションが実行時に探索可能なサービスを自動的に検索し、そのアドレスを見つけることができる探索エンドポイントの名前を含む文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|探索サービスの検索にクライアント アプリケーションによって使用される基準を提供する構成要素。  基準は、\(探しているサービスを指定する\) 検索条件と \(検索をどのくらい続けるかを指定する\) 検索終了条件にグループ化できます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|アプリケーションが実行時に動的にエンドポイント アドレスを検索するクライアント プログラムとして機能するための情報を格納する標準エンドポイントを定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement>   
+ <xref:System.ServiceModel.Discovery.Configuration.DiscoveryClientSettingsElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md b/docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md
new file mode 100644
index 00000000000..23bc2351985
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;discoveryEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fae2f48b-a635-4e4b-859d-a1432ac37e1c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;discoveryEndpoint&gt;
+この構成要素は、固定探索コントラクトが含まれた標準エンドポイントを定義します。  サービスの構成に追加すると、この要素により、探索メッセージをリッスンする場所が指定されます。  クライアントの構成に追加すると、この要素により、探索クエリの送信先となる場所が指定されます。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <discoveryEndpoint>   
+          <standardEndpoint  
+                  discoveryMode=”Adhoc/Managed”  
+                  discoveryVersion=”WSDiscovery11/WSDiscoveryApril2005”  
+                  maxResponseDelay=”Timespan”   
+                  name="String" />  
+       </discoveryEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryMode|探索プロトコルのモードを示す文字列。  有効値は "Adhoc" と "Managed" です。  マネージ モードでは、プロトコルは Discoverable サービスのリポジトリとして機能する Discovery Proxy に依存します。  アドホック モードでは、プロトコルは UDP マルチキャスト メカニズムを使用して利用可能なサービスを探索する必要があります。  この値は、<xref:System.Servicemodel.Discovery.DiscoveryMode> 型です。|  
+|discoveryVersion|WS\-Discovery プロトコルの 2 つのバージョンのうち、1 つを指定する文字列。  有効値は WSDiscovery11 と WSDiscoveryApril2005 です。  この値は、<xref:System.Servicemodel.Discovery.DiscoveryVersion> 型です。|  
+|maxResponseDelay|Discovery プロトコルが Probe Match や Resolve Match などのメッセージを送信するまでの待機時間の最大値を指定する Timespan 値。<br /><br /> すべての ProbeMatch が同時に送信されると、ネットワーク ストームが発生することがあります。  これを防ぐために、各 ProbeMatch はランダムな時間だけ待機して送信されます。  ランダムな待機時間は、0 からこの属性に設定された値の範囲内で設定されます。  この属性を 0 に設定すると、ProbeMatch メッセージは待機せずに短いループで送信されます。  それ以外の場合は、ProbeMatch メッセージはランダムな時間だけ待機して送信されます。すべての ProbeMatch メッセージの送信にかかる合計時間が maxResponseDelay を超えることはありません。  この値はサービスのみに関連するもので、クライアントが使用するものではありません。|  
+|`name`|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 使用例  
+ ピア ネットワーク マルチキャスト トランスポート経由で探索メッセージをリッスンするサービスの例を次に示します。  この例では、明示的に WS\-Discovery April 2005 バージョンを指定します。  
+  
+ 標準エンドポイントの構成はサービスごとに定義します。サービス間で共有することはできません。  別のサービスで同じ探索エンドポイントを使用するには、該当のサービスのセクションに同じ構成を追加する必要があります。  
+  
+```  
+  
+<services>  
+    <service name="CalculatorService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+             <endpoint binding="basicHttpBinding"   
+                address="calculator" contract="ICalculatorService" />  
+             <endpoint name="peerNetDiscovery"  
+                binding="peerTcpBinding"  
+                address="net.p2p://discoveryMesh/multicast"  
+                kind="discoveryEndpoint"  
+                endpointConfiguration="peerTcpDiscoveryEndpointConfiguration"  
+                bindingConfiguration="discoveryPeerTcpBindingConfig" />      
+   </service>  
+</services>  
+<standardEndpoints>  
+  <discoveryEndpoint>  
+     <standardEndpoint name="peerTcpDiscoveryEndpointConfiguration "                         
+                       version="WSDiscoveryApril2005" />  
+   </discoveryEndpoint>  
+</standardEndpoints>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.DiscoveryEndpoint>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/dispatchersynchronization.md b/docs/framework/configure-apps/file-schema/wcf/dispatchersynchronization.md
new file mode 100644
index 00000000000..3d01a47fb14
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/dispatchersynchronization.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;dispatcherSynchronization&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc030f9c-4e38-4b14-94dc-9a0e41ec8e2d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;dispatcherSynchronization&gt;
+サービスが非同期に応答を返すことができるようにするエンドポイントの動作を指定します。  
+  
+## 構文  
+  
+```  
+  
+<dispatcherSynchronizationBehavior   
+   asynchronousSendEnabled=”Boolean”  
+   maxPendingReceives="Integer" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|asynchronousSendEnabled|非同期の送信動作が有効かどうかを示すブール値。|  
+|`maxPendingReceives`|チャネルで発行可能な同時受信の数を指定する整数。<br /><br /> この値は、サービス調整の動作を適切に構成した後に構成する必要があります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DispatcherSynchronizationBehaviorElement>   
+ <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/dns.md b/docs/framework/configure-apps/file-schema/wcf/dns.md
new file mode 100644
index 00000000000..8083d37716c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/dns.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;dns&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81819dae-4825-43b7-bccd-f16d2d3d2f06
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;dns&gt;
+予想されるサーバーの ID を指定します。  この ID は、同じ値を持つ DNS がサーバーの証明書に含まれていれば、X509 証明書の認証モードで有効です。  さらに、SPN に同じ値があれば、Windows 認証モードでも有効です。  
+  
+ 要素の値の設定の詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<dns value = "String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|証明書の DNS です。  DNS は、IP ベースのネットワーク上でコンピューターを特定するために使用される業界標準のプロトコルです。  ユーザーは、207.46.131.137 などの数値ベースのアドレスよりも、[http:\/\/go.microsoft.com\/fwlink\/?prd\=10929](http://go.microsoft.com/fwlink/?prd=10929) や [http:\/\/go.microsoft.com\/fwlink\/?LinkID\=96165](http://go.microsoft.com/fwlink/?LinkID=96165) などの表示名の方が簡単に覚えることができます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|クライアントで認証するサービスの ID を指定します。|  
+  
+## 使用例  
+ 次の構成コードは、サーバーの認証に使用される X.509 証明書の DNS を指定します。  
+  
+```  
+<identity>  
+  <dns value = "www.cohowinery.com" />  
+</identity>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ <xref:System.ServiceModel.DnsEndpointIdentity>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/dynamicendpoint.md b/docs/framework/configure-apps/file-schema/wcf/dynamicendpoint.md
new file mode 100644
index 00000000000..5f9b3d6f130
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/dynamicendpoint.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;dynamicEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 929f223d-176d-4205-9505-234ddb6dbff4
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;dynamicEndpoint&gt;
+この構成要素は、アプリケーションが、実行時に動的にエンドポイント アドレスを検索するクライアント プログラムとして機能するための情報を格納する標準エンドポイントを定義します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <dynamicEndpoint>   
+          <standardEndpoint>  
+             <discoveryClientSettings discoveryEndpoint=”String” >  
+               <findCriteria duration=”TimeSpan”  
+                  maxResults=”Integer”   
+                  scopeMatchBy=”Uri” >  
+                  <contractTypeNames>  
+                     <add name="String" namespace="String" />  
+                  <contractTypeNames>  
+                  <extensions />  
+                  <scopes>  
+                    <add scope="URI"/>  
+                  </scopes>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+          <standardEndpoint>  
+       </dynamicEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<discoveryClientSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/discoveryclientsettings.md)|サービス探索プロセスにクライアントとして参加するためにアプリケーションが必要とする設定を格納します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.DynamicEndpoint>   
+ <xref:System.ServiceModel.Discovery.Configuration.DynamicEndpointElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/enablewebscript.md b/docs/framework/configure-apps/file-schema/wcf/enablewebscript.md
new file mode 100644
index 00000000000..25e7a3202c1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/enablewebscript.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;enableWebScript&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9c7e96e1-af70-4e6e-ac5c-d67929dddbaa
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;enableWebScript&gt;
+この要素は、ASP.NET AJAX Web ページからサービスを使用できるようにするエンドポイントの動作を有効にします。  
+  
+## 構文  
+  
+```  
+  
+<enableWebScript />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作のセットを指定します。|  
+  
+## 解説  
+ この動作は、必ず [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) 標準バインディングまたは [\<webMessageEncoding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webmessageencoding.md) バインディング要素と組み合わせて使用する必要があります。  この動作の詳細については、「<xref:System.ServiceModel.Description.WebScriptEnablingBehavior>」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WebScriptEnablingElement>   
+ <xref:System.ServiceModel.Description.WebScriptEnablingBehavior>   
+ [AJAX の統合と JSON のサポート](../../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)   
+ [\<webHttp\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttp.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endpoint-element.md b/docs/framework/configure-apps/file-schema/wcf/endpoint-element.md
new file mode 100644
index 00000000000..cefb9ca78e2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endpoint-element.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;endpoint&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 2fc8fedc-78d0-4e87-8142-fbfd26c15a4e
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# &lt;endpoint&gt; 要素
+サービスの公開に使用されるサービス エンドポイントのバインディング、コントラクト、およびアドレスのプロパティを指定します。  
+  
+## 構文  
+  
+```  
+  
+<endpoint address="String"  
+   behaviorConfiguration="String"  
+   binding="String"  
+   bindingConfiguration="String"  
+   bindingName="String"  
+   bindingNamespace="String"  
+   contract="String"  
+   endpointConfiguration=”String”  
+   isSystemEndpoint=”Boolean”  
+   kind=”String”  
+   listenUriMode="Explicit/Unique"  
+   listenUri="Uri"  
+</endpoint>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|エンドポイントのアドレスを含む文字列。  アドレスは、絶対または相対アドレスとして指定できます。  相対アドレスが提供されている場合、ホストは、そのバインディングで使用されるトランスポート スキームに適したベース アドレスが提供されることを想定します。  アドレスが構成されていない場合、ベース アドレスはそのエンドポイントのアドレスと見なされます。<br /><br /> 既定値は空の文字列です。|  
+|behaviorConfiguration|エンドポイントで使用される動作の名前を含む文字列。|  
+|バインド|使用するバインディングの種類を指定する必須の文字列属性。  参照できるようにするには、種類は登録された構成セクションを持っている必要があります。  種類は、バインディングの種類の名前ではなくセクション名で登録されます。|  
+|bindingConfiguration|エンドポイントがインスタンス化されるときに使用するバインディングのバインディング名を指定する文字列。  バインディング名は、エンドポイントが定義される時点でスコープ内にある必要があります。  既定値は空の文字列です。<br /><br /> この属性は、構成ファイル内の特定のバインディング構成を参照するために、`binding` と組み合わせて使用されます。  カスタム バインディングを使用しようとする場合にこの属性を設定します。  そうでない場合は、例外がスローされることがあります。|  
+|bindingName|WSDL を介した定義エクスポートに使用するバインディングの一意の修飾名を指定する文字列。  既定値は空の文字列です。|  
+|bindingNamespace|WSDL を介した定義エクスポートに使用するバインディングの名前空間の修飾名を指定する文字列。  既定値は空の文字列です。|  
+|コントラクト|このエンドポイントが公開するコントラクトを示す文字列。  アセンブリは、コントラクト型を実装する必要があります。  サービス実装が単一のコントラクトの型を実装する場合は、このプロパティを省略できます。  既定値は空の文字列です。|  
+|endpointConfiguration|この標準エンドポイントの追加の構成情報を参照する `kind` 属性によって設定される標準エンドポイントの名前を指定する文字列。  同じ名前を `<standardEndpoints>` セクションに定義する必要があります。|  
+|isSystemEndpoint|インフラストラクチャ エンドポイントであるかどうかを指定するブール値。|  
+|kind|適用する標準エンドポイントの種類を指定する文字列。  種類は `<extensions>` セクションまたは machine.config に登録する必要があります。  何も指定されていない場合は、共通のサービス エンドポイントが作成されます。|  
+|listenUriMode|リッスンするサービスに提供される `ListenUri` をトランスポートが処理する方法を指定します。  有効な値は、次のとおりです。<br /><br /> -   Explicit<br />-   ユニーク<br /><br /> 既定値は Explicit です。|  
+|listenUri|サービス エンドポイントがリッスンする URI を指定する文字列。  既定値は空の文字列です。|  
+|name|省略可能な属性です。  サービス エンドポイントの名前を指定する文字列。  既定値は、バインディング名とコントラクトの説明の名前を連結した値です。  サービスには複数のエンドポイントが存在する場合があるため、エンドポイントの `name` 属性はサービスの名前とは異なります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers.md)|アドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<service\>](../../../../../docs/framework/configure-apps/file-schema/wcf/service.md)|クライアントが接続可能なエンドポイントの一覧を定義する設定セクションです。|  
+  
+## 使用例  
+ これはサービス エンドポイントの構成の例です。  
+  
+```  
+<endpoint   
+    address="/HelloWorld/"  
+    bindingConfiguration="usingDefaults"  
+    bindingName="MyBinding"  
+    binding="customBinding"  
+    contract="HelloWorld">  
+    <Headers>  
+       <Region xmlns="http://tempuri.org/">EastCoast</Region>  
+       <Member xmlns="http://tempuri.org/">Gold</Member>  
+    </Headers>  
+</endpoint>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceEndpointElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.Description.ServiceEndpoint>   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)   
+ [方法 : 構成にサービス エンドポイントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md b/docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md
new file mode 100644
index 00000000000..c05db2f3f94
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;client&gt; の &lt;endpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: de6238ae-bbf8-48e9-a1b5-e24c0bea8afa
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# &lt;client&gt; の &lt;endpoint&gt;
+サーバーのサービス エンドポイントに接続するためにクライアントによって使用されるチャネル エンドポイントのコントラクト、バインディング、およびアドレスのプロパティを指定します。  
+  
+## 構文  
+  
+```  
+  
+<endpoint address="String"  
+   behaviorConfiguration="String"  
+   binding="String"  
+   bindingConfiguration="String"  
+   contract="String"  
+   endpointConfiguration=”String”  
+   kind=”String”  
+   name="String"  
+</endpoint>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必須の文字列属性です。<br /><br /> エンドポイントのアドレスを指定します。  既定値は空の文字列です。  アドレスは、絶対 URI にする必要があります。|  
+|behaviorConfiguration|エンドポイントのインスタンス化に使用される動作の動作名を含む文字列。  動作名は、サービスが定義される時点でスコープ内にある必要があります。  既定値は空の文字列です。|  
+|バインド|必須の文字列属性です。<br /><br /> 使用するバインディングの種類を示す文字列。  参照できるようにするには、種類は登録された構成セクションを持っている必要があります。  種類は、バインディングの種類の名前ではなくセクション名で登録されます。|  
+|bindingConfiguration|省略可能です。  エンドポイントがインスタンス化されるときに使用するバインディング構成の名前を含む文字列。  バインディング構成は、エンドポイントが定義される時点でスコープ内にある必要があります。  既定値は空の文字列です。<br /><br /> この属性は、構成ファイル内の特定のバインディング構成を参照するために、`binding` と組み合わせて使用されます。  カスタム バインディングを使用しようとする場合にこの属性を設定します。  そうでない場合は、例外がスローされることがあります。|  
+|コントラクト|必須の文字列属性です。<br /><br /> このエンドポイントが公開するコントラクトを示す文字列。  アセンブリは、コントラクト型を実装する必要があります。|  
+|endpointConfiguration|この標準エンドポイントの追加の構成情報を参照する `kind` 属性によって設定される標準エンドポイントの名前を指定する文字列。  同じ名前を `<standardEndpoints>` セクションに定義する必要があります。|  
+|kind|適用する標準エンドポイントの種類を指定する文字列。  種類は `<extensions>` セクションまたは machine.config に登録する必要があります。  何も指定されていない場合は、共通のチャネル エンドポイントが作成されます。|  
+|name|省略可能な文字列属性。  この属性は、特定のコントラクトのエンドポイントを一意に識別します。  特定のコントラクトの種類に、複数のクライアントを定義できます。  それぞれの定義は、一意の構成名で区別できるようにする必要があります。  この属性が省略されている場合、指定されたコントラクトの種類に関連する既定のエンドポイントとして、対応するエンドポイントが使用されます。  既定値は空の文字列です。<br /><br /> バインディングの `name` 属性は、WSDL を介した定義エクスポートに使用されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers.md)|アドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<client\>](../../../../../docs/framework/configure-apps/file-schema/wcf/client.md)|クライアントが接続可能なエンドポイントの一覧を定義する設定セクションです。|  
+  
+## 使用例  
+ これはチャネル エンドポイントの構成の例です。  
+  
+```  
+<endpoint address="/HelloWorld/"  
+    bindingConfiguration="usingDefaults"  
+    name="MyBinding"  
+    binding="customBinding"  
+    contract="HelloWorld">  
+</endpoint>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ChannelEndpointElement>   
+ <xref:System.ServiceModel.Configuration.ClientSection>   
+ <xref:System.ServiceModel.Configuration.ChannelEndpointElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClientSection.Endpoints%2A>   
+ <xref:System.ServiceModel.Configuration.ChannelEndpointElement>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md b/docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md
new file mode 100644
index 00000000000..5384592baf0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md
@@ -0,0 +1,26 @@
+---
+title: "&lt;endpointBehaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb851947-e8dd-4f8c-8323-26fae90b09c3
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;endpointBehaviors&gt;
+この構成セクションは、特定のエンドポイントに対して定義されたすべての動作を表します。  クライアント動作の構成の詳細については、「[クライアントのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-client-run-time-behavior.md)」および「[クライアントの動作の構成](../../../../../docs/framework/wcf/configuring-client-behaviors.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.EndpointBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.EndpointBehaviorElement>   
+ [クライアントのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-client-run-time-behavior.md)   
+ [クライアントの動作の構成](../../../../../docs/framework/wcf/configuring-client-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endpointdiscovery.md b/docs/framework/configure-apps/file-schema/wcf/endpointdiscovery.md
new file mode 100644
index 00000000000..b03cd2aecc9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endpointdiscovery.md
@@ -0,0 +1,114 @@
+---
+title: "&lt;endpointDiscovery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70812717-888a-4748-9640-0df6715ff029
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;endpointDiscovery&gt;
+エンドポイントのさまざまな探索設定を指定します \(探索可能性、スコープ、メタデータに対するカスタム拡張など\)。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <endpointBehaviors>  
+    <behavior name="String">  
+      <endpointDiscovery enabled="Boolean">  
+        <scopes>  
+          <add scope="URI"/>  
+        </scopes>  
+        <extensions>  
+        </extensions>  
+      </endpointDiscovery>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|enabled|探索可能性をこのエンドポイントで有効にするかどうかを指定するブール値。  既定値は、`false` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<scopes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopes.md)|エンドポイントのスコープ URI のコレクション。  複数の URI を 1 つのエンドポイントに関連付けることができます。|  
+|[\<extensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/extensions.md) \[\<endpointDiscovery\>\]|エンドポイントで発行されるカスタム メタデータを指定できる、XML 要素のコレクション。|  
+|\<types\>|検索するインターフェイスのコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+|||  
+  
+## 解説  
+ エンドポイントの動作構成に追加し、`enabled` 属性を `true` に設定すると、この構成要素の探索可能性が有効になります。  [\<scopes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopes.md)[\<extensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/extensions.md) 子要素を使用して、標準の探索可能なメタデータと共に発行する必要のあるカスタム メタデータを指定することも可能です \(EPR、ContractTypeName、BindingName、Scope、ListenURI\)。  
+  
+ この構成要素は、探索可能性のサービス レベルでの制御を提供する [\<serviceDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicediscovery.md) 要素に依存します。  これは、構成に [\<serviceDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicediscovery.md) が指定されていない場合、この要素の設定が無視されることを意味します。  
+  
+## 使用例  
+ 次の構成例では、フィルターのスコープと、エンドポイントで発行される拡張メタデータを指定しています。  
+  
+```  
+  
+<services>  
+  <service name="CalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+     <endpoint binding="basicHttpBinding"  
+              address="calculator"  
+              contract="ICalculatorService"  
+              behaviorConfiguration="calculatorEndpointBehavior" />  
+  </service>  
+</services>  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceDiscovery />  
+    </behavior>  
+  </serviceBehaviors>  
+  <endpointBehaviors>  
+    <behavior name="calculatorEndpointBehavior">  
+      <endpointDiscovery enabled="true">  
+        <scopes>  
+          <add scope="http://contoso/test1"/>  
+          <add scope="http://contoso/test2"/>  
+        </scopes>  
+        <extensions>  
+          <e:Publisher xmlns:e="http://example.org">  
+            <e:Name>The Example Organization</e:Name>  
+            <e:Address>One Example Way, ExampleTown, EX 12345</e:Address>  
+            <e:Contact>support@example.org</e:Contact>  
+          </e:Publisher>  
+          <AnotherCustomMetadata>Custom Metadata</AnotherCustomMetadata>  
+        </extensions>  
+      </endpointDiscovery>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endpointextensions.md b/docs/framework/configure-apps/file-schema/wcf/endpointextensions.md
new file mode 100644
index 00000000000..5df4d352b00
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endpointextensions.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;endpointExtensions&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33396e0a-1fae-4616-b822-923584eebfd1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;endpointExtensions&gt;
+このセクションは、コンピューターまたはアプリケーションの構成ファイルの拡張セクションに新たな標準エンドポイントを登録します。  このコレクションに標準エンドポイントを追加するには、`add` キーワードを使用し、要素の `type` 属性をエンドポイントの種類に設定して、`name` 属性を標準エンドポイントの名前に設定します。  
+  
+ 次の例は、`add` 要素と `name` 属性を使用して、構成ファイルの `<endpointExtensions>` セクションに標準エンドポイントを追加します。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+        <endpointExtensions>  
+           <add name="udpDiscoveryEndpoint"  
+                type="System.Discovery.UdpEndpointCollectionElement, System.Discovery.dll, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ffffffffffffffff"/>  
+        </endpointExtensions>   
+    </extensions>  
+</system.serviceModel>  
+```  
+  
+ 標準エンドポイントを追加すると、次の例に示すように、このエンドポイントを使用できます。  [\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md) 要素では、`kind` 属性を使用して、`<endpointExtensions>` セクションに登録されている標準エンドポイントの種類を指定します。  `endpointConfiguration` 属性は、`<standardEndpoints>` セクションにある標準エンドポイントの構成要素の `name` 属性と同じになります。  
+  
+```  
+  
+<system.serviceModel>  
+    <services>  
+      <service name="Service1">  
+        <endpoint kind="udpDiscoveryEndpoint"  
+                  endpointConfiguration="udpConfig" />  
+      </service>  
+    </services>  
+    <standardEndpoints>  
+      <udpDiscoveryEndpoint>  
+        <standardEndpoint  
+                  name="udpConfig"  
+                  multicastAddress="soap.udp://239.255.255.250:3703"  
+                  ... />  
+      </udpDiscoveryEndpoint>  
+    </standardEndpoints>  
+  </system.serviceModel>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/endtoendtracing.md b/docs/framework/configure-apps/file-schema/wcf/endtoendtracing.md
new file mode 100644
index 00000000000..4c09a69dcbe
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/endtoendtracing.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;endToEndTracing&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5034f5de-bb60-4157-9ad4-58aaade094e0
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;endToEndTracing&gt;
+サービス アプリケーションの実行中にエンドツーエンドのトレースのさまざまな側面を有効または無効にするための構成要素。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+   <diagnostics>  
+       <endToEndTracing activityTracing="Boolean"  
+          messageFlowTracing="Boolean"  
+          propagateActivity="Boolean" />  
+   </diagnostics>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`activityTracing`|アクティビティのトレースが有効かどうかを示すブール値。|  
+|`messageFlowTracing`|メッセージ フローのトレースが有効かどうかを示すブール値。|  
+|`propagateActivity`|伝達属性が true に設定されているかどうかを示すブール値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<diagnostics\>](../../../../../docs/framework/configure-apps/file-schema/wcf/diagnostics.md)|管理者が行うランタイムの検査と管理の WCF 設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DiagnosticSection>   
+ <xref:System.ServiceModel.Diagnostics>   
+ <xref:System.ServiceModel.Configuration.DiagnosticSection.EndToEndTracing%2A>   
+ <xref:System.ServiceModel.Configuration.EndToEndTracingElement>   
+ [エンドツーエンドのトレース](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/entries.md b/docs/framework/configure-apps/file-schema/wcf/entries.md
new file mode 100644
index 00000000000..7654d45f3e3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/entries.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;entries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 202e430c-c1b9-4343-abe2-ac78c181a3b7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;entries&gt;
+ルーティング フィルターとターゲット エンドポイントとのマッピングを格納するルーティング エントリ。フィルターが一致したときにメッセージを送信するために使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filterTables>  
+        <filterTable name="String">  
+          <entries>  
+            <add backupList=”String”  
+                 endpointName="String"   
+                 filterName="String"   
+                 priority="Integer" />  
+          </entries>  
+        </table>  
+      </routingTables>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md)|以前に定義されたクライアント エンドポイントにフィルターをマップします。  このフィルターに一致するメッセージは、この宛先に送信されます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|ルーティング テーブルを含む構成セクション。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.RoutingSection](assetId:///System.ServiceModel.Routing.Configuration.RoutingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Routing.Configuration.FilterTableEntryElement](assetId:///System.ServiceModel.Routing.Configuration.FilterTableEntryElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/exposedmethod.md b/docs/framework/configure-apps/file-schema/wcf/exposedmethod.md
new file mode 100644
index 00000000000..d29b96f1451
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/exposedmethod.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;exposedMethod&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61c938cd-4ee9-4b06-ab28-922ef491ab11
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;exposedMethod&gt;
+COM\+ コンポーネントのインターフェイスが Web サービスとして公開されるときに公開される COM\+ メソッドを表します。  
+  
+## 構文  
+  
+```  
+  
+<comContracts>  
+  <comContract>  
+      <exposedMethods>  
+         <exposedMethod name="string" />  
+      </exposedMethods>  
+  </comContract>  
+</comContracts>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|COM\+ コンポーネントのインターフェイスが Web サービスとして公開されるときに公開される COM\+ メソッドを含む文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<exposedMethods\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethods.md)|[\<exposedMethod\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethod.md) 要素のコレクション。|  
+  
+## 解説  
+ COM\+ 統合構成ツール \(ComSvcConfig.exe\) を使用して、COM インターフェイスから特定のメソッドを追加して、生成されるサービス コントラクトに表示できます。  
+  
+ たとえば、次のコマンドを使用して、`ItemOrders`.Financial コンポーネントの `IFinances` COM インターフェイスから、3 つの名前付きメソッドを、生成されるサービス コントラクトに追加できます。  
+  
+ `ComSvcConfig.exe /i /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{TransferFunds,AddFunds,RemoveFunds} /hosting:complus`  
+  
+ ComSvcConfig.exe も実行する場合、前述のメソッドを [\<exposedMethod\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethod.md) 要素として一覧表示する次のサービス コントラクトを生成します。  
+  
+```  
+<comContract contractType="{C551FBA9-E3AA-4272-8C2A-84BD8D290AC7}" name="IFinances" namespace="http://contoso.com/services/financial">  
+    <exposedMethod name="TransferFunds"/>  
+    <exposedMethod name="AddFunds"/>  
+    <exposedMethod name="RemoveFunds"/>  
+</comContract>  
+```  
+  
+ サービスの初期化時に、ランタイムは、サービス コントラクトを生成しますが、このとき [\<exposedMethod\>](../../../../../docs/framework/configure-apps/file-schema/wcf/exposedmethod.md) 要素の一覧に含まれるメソッドのみを反映して追加しようとします。  トレースは、サービス コントラクトに含まれないインターフェイス メソッド用に作成されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComMethodElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComMethodElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/exposedmethods.md b/docs/framework/configure-apps/file-schema/wcf/exposedmethods.md
new file mode 100644
index 00000000000..16ccc98e7be
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/exposedmethods.md
@@ -0,0 +1,27 @@
+---
+title: "&lt;exposedMethods&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f21d7ed-b268-498a-9b08-76c38361fd1e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;exposedMethods&gt;
+このセクションには、`exposedMethod` 要素のコレクションが含まれています。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComMethodElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComMethodElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/extensions-section.md b/docs/framework/configure-apps/file-schema/wcf/extensions-section.md
new file mode 100644
index 00000000000..2a3d746bc81
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/extensions-section.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;extensions&gt; セクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 53a59fb6-dede-47ec-9384-b3c2e8f0c1fa
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;extensions&gt; セクション
+この構成セクションには、拡張のコレクションが含まれています。この拡張のコレクションによってユーザーは、ユーザー定義のバインディング、動作、およびその他の拡張機能を作成できます。  
+  
+ \<system.ServiceModel\>  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <extensions>  
+      <bindingExtensions>  
+      </bindingExtensions>  
+      <behaviorExtensions>  
+      </behaviorExtensions>  
+      <bindingElementExtensions>  
+      </bindingElementExtensions>  
+      <endpointExtensions>  
+      </endpointExtensions>  
+    </extensions>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behaviorExtensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behaviorextensions.md)|このセクションには、動作拡張を指定する子要素が含まれています。この動作拡張により、ユーザーはサービスまたはエンドポイントの動作をカスタマイズできます。|  
+|[\<bindingElementExtensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindingelementextensions.md)|このセクションは、コンピューターまたはアプリケーションの構成ファイルからカスタム バインディング要素を使用できます。|  
+|[\<bindingExtensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindingextensions.md)|このセクションには、バインディング拡張を指定する子要素が含まれています。このバインディング拡張によって、ユーザーはバインディングをカスタマイズできます。|  
+|[\<endpointExtensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpointextensions.md)|このセクションには、標準エンドポイントを登録する子要素が含まれています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.ServiceModel|すべての WCF 構成要素のルート要素です。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/extensions.md b/docs/framework/configure-apps/file-schema/wcf/extensions.md
new file mode 100644
index 00000000000..5713f4bdeea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/extensions.md
@@ -0,0 +1,58 @@
+---
+title: "&lt;extensions&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bcfe5c44-04ef-4a20-96a5-90bfadf39623
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;extensions&gt;
+この構成要素には、標準の探索可能なメタデータと共に発行する必要のあるカスタム メタデータ \(EPR、ContractTypeName、BindingName、Scope、ListenURI\) を含む XML 要素のコレクションが格納されます。  この構成要素を使用する場合の例を次に示します。  
+  
+```  
+  
+<services>  
+  <service name="CalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+     <endpoint binding="basicHttpBinding"  
+              address="calculator"  
+              contract="ICalculatorService"  
+              behaviorConfiguration="calculatorEndpointBehavior" />  
+  </service>  
+</services>  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceDiscovery />  
+    </behavior>  
+  </serviceBehaviors>  
+  <endpointBehaviors>  
+    <behavior name="calculatorEndpointBehavior">  
+      <endpointDiscovery enable="true">  
+        <extensions>  
+          <e:Publisher xmlns:e="http://example.org">  
+            <e:Name>The Example Organization</e:Name>  
+            <e:Address>One Example Way, ExampleTown, EX 12345</e:Address>  
+            <e:Contact>support@example.org</e:Contact>  
+          </e:Publisher>  
+          <AnotherCustomMetadata>Custom Metadata</AnotherCustomMetadata>  
+        </extensions>  
+      </endpointDiscovery>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/faultpropagationqueries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/faultpropagationqueries-of-wcf.md
new file mode 100644
index 00000000000..a7ad22159da
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/faultpropagationqueries-of-wcf.md
@@ -0,0 +1,63 @@
+---
+title: "WCF の &lt;faultPropagationQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d85f66a7-e7b0-4dbb-83cc-89fa06fc9161
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;faultPropagationQueries&gt;
+1 つのアクティビティ内で発生するエラーの処理を追跡するために使用する、クエリのコレクションを表します。このイベントは、FaultHandler がエラーを処理するたびに発生します。  1 つのアクティビティ内で発生したエラーの処理は、このようなクエリを使用して追跡する必要があります。  追跡参加要素がエラー伝達レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリ。このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.FaultPropagationQuery](assetId:///System.Activities.Tracking.FaultPropagationQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/faultpropagationquery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/faultpropagationquery-of-wcf.md
new file mode 100644
index 00000000000..d35fa9d6951
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/faultpropagationquery-of-wcf.md
@@ -0,0 +1,64 @@
+---
+title: "WCF の &lt;faultPropagationQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fabafbc8-3e45-4feb-8321-0725e9f4079c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;faultPropagationQuery&gt;
+1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリを表します。このイベントは、FaultHandler がエラーを処理するたびに発生します。  1 つのアクティビティ内で発生したエラーの処理は、このようなクエリを使用して追跡する必要があります。  追跡参加要素がエラー伝達レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|エラーを伝達したエラー ハンドラー アクティビティの名前を指定する文字列。  既定値は \* で、すべてのアクティビティについてエラー伝達レコードが返されることを示します。|  
+|faultHandlerActivityName|エラーの原因となったアクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用する、構成要素の一覧を表します。このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.FaultPropagationQuery](assetId:///System.Activities.Tracking.FaultPropagationQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/filter.md b/docs/framework/configure-apps/file-schema/wcf/filter.md
new file mode 100644
index 00000000000..53918b1a834
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/filter.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;filter&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3266700b-904b-44e4-93a7-e06a1a445100
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;filter&gt;
+受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類と、フィルターが必要とする任意のサポート対象のデータまたはパラメーターを指定するルーティング フィルターを定義します。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filters>  
+        <filter customType=”String”  
+                filterData=”String”  
+                filterType="Action/Address/AddressPrefix/And/Custom/Endpoint/MatchAll/XPath"   
+                name="String" />  
+      </filters>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customType|フィルターとして使用されるカスタム型の完全修飾型名を示す文字列。`filterType` が `custom` に設定されている場合、この属性には作成するクラスの完全修飾型名が指定されます。`filterData` には、カスタム型フィルターの評価時に使用される値を含めることもできます。|  
+|filterData|フィルター データを示す文字列。  この属性を指定する方法の詳細については、「<xref:System.ServiceModel.Routing.Configuration.FilterElement.FilterData%2A>」を参照してください。|  
+|filterType|フィルターの種類を示す文字列。  この属性は <xref:System.ServiceModel.Routing.Configuration.FilterType> 型です。  `filterData` 属性を使用する方法の詳細については、「<xref:System.ServiceModel.Routing.Configuration.FilterElement.FilterData%2A>」を参照してください。|  
+|name|フィルター要素の一意の名前を示す文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を指定するルーティング フィルター セットを定義する構成セクション。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.FilterElement](assetId:///System.ServiceModel.Routing.Configuration.FilterElement?qualifyHint=False&amp;autoUpgrade=True)   
+ <xref:System.ServiceModel.Routing.Configuration.FilterElement.FilterData%2A>   
+ <xref:System.ServiceModel.Routing.Configuration.FilterType>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md b/docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md
new file mode 100644
index 00000000000..dda1011c0c1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;routing&gt; の &lt;filters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7993cf90-9afd-4c3c-9608-184d5da1105c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;routing&gt; の &lt;filters&gt;
+受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を指定するルーティング フィルター セットを定義する構成セクションを表します。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filters>  
+        <filter customType=”String”  
+                filterData=”String”  
+                filterType="Action/Address/AddressPrefix/And/Custom/Endpoint/MatchAll/XPath"   
+                name="String" />  
+      </filters>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filter.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルターを格納します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルター セットと、フィルターが一致するときにメッセージを送信するターゲット エンドポイントを指定するルーティング テーブルを定義する構成セクションを表します。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.FilterElement](assetId:///System.ServiceModel.Routing.Configuration.FilterElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/filters.md b/docs/framework/configure-apps/file-schema/wcf/filters.md
new file mode 100644
index 00000000000..b1864e213d6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/filters.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;filters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37a87222-ec78-4728-8105-9ca1bd961f0c
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;filters&gt;
+`filters` 要素は、ログに記録されるメッセージの種類の制御に使用される XPath フィルターのコレクションを保持します。  
+  
+ フィルターは、`logMessagesAtTransportLevel` を `true` に設定することによって指定されるトランスポート層でのみ適用されます。  サービス レベルおよび形式が正しくないメッセージ ログ記録は、フィルターの影響を受けません。  
+  
+ コレクションにフィルターを追加するには、`add` を使用します。  1 つ以上のフィルターを定義した場合は、少なくとも 1 つのフィルターと一致するメッセージだけが記録されます。  フィルターを定義しなかった場合は、すべてのメッセージが通過します。  
+  
+ フィルターは、完全な XPath 構文をサポートし、構成ファイルでの出現順に適用されます。  フィルターが構文的に正しくない場合は、構成例外が発生します。  
+  
+ SOAP ヘッダー セクションがあるメッセージだけを記録するフィルターの設定方法の例を次に示します。  
+  
+```  
+<messageLogging logEntireMessage="true"  
+     logMalformedMessages="true" logMessagesAtServiceLevel="true"  
+     logMessagesAtTransportLevel="true" maxMessagesToLog="420”>  
+     <filters>  
+        <add xmlns:soap="http://www.w3.org/2003/05/soap-envelope">  
+                        /soap:Envelope/soap:Headers  
+        </add>  
+     </filters>  
+</messageLogging>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.DiagnosticSection>   
+ <xref:System.ServiceModel.Diagnostics>   
+ <xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A>   
+ <xref:System.ServiceModel.Configuration.MessageLoggingElement>   
+ <xref:System.ServiceModel.Configuration.MessageLoggingElement.Filters%2A>   
+ <xref:System.ServiceModel.Configuration.XpathMessageFilterElementCollection>   
+ <xref:System.ServiceModel.Configuration.XpathMessageFilterElement>   
+ <xref:System.ServiceModel.Dispatcher.XPathMessageFilter>   
+ [メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)   
+ [メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)   
+ [\<messageLogging\>](../../../../../docs/framework/configure-apps/file-schema/wcf/messagelogging.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/filtertable.md b/docs/framework/configure-apps/file-schema/wcf/filtertable.md
new file mode 100644
index 00000000000..12e33427b9f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/filtertable.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;filterTable&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e9f05441-3ad1-49b9-a267-71724aa094b4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;filterTable&gt;
+メッセージを評価するフィルターの一覧と、フィルターが true に評価された場合にメッセージをルーティングするクライアント エンドポイントを格納するルーティング テーブルを表します。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filterTables>  
+        <filterTable name="String">  
+          <entries>  
+            <add backupList=”String”  
+                 endpointName="String"   
+                 filterName="String"   
+                 priority="Integer" />  
+          </entries>  
+        </table>  
+      </routingTables>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|name|この構成要素の一意の名前を示す文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md)|ルーティング フィルターとターゲット エンドポイントとのマッピング。フィルターが一致したときにメッセージを送信するために使用されます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|ルーティング テーブルを含む構成セクション。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.RoutingSection](assetId:///System.ServiceModel.Routing.Configuration.RoutingSection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/filtertables.md b/docs/framework/configure-apps/file-schema/wcf/filtertables.md
new file mode 100644
index 00000000000..0bf64365506
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/filtertables.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;filterTables&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41f1ac35-f559-473a-b2c3-8cc83a6a3831
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;filterTables&gt;
+ルーティング フィルターとターゲット エンドポイントとのマッピングを格納するルーティング テーブルを定義する構成セクションを表します。フィルターが一致したときにメッセージを送信するために使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filterTables>  
+        <filterTable name="String">  
+          <entries>  
+            <add backupList=”String”  
+                 endpointName="String"   
+                 filterName="String"   
+                 priority="Integer" />  
+          </entries>  
+        </table>  
+      </routingTables>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md)|ルーティング フィルターとターゲット エンドポイントとのマッピングを格納するルーティング テーブル。フィルターが一致したときにメッセージを送信するために使用されます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|ルーティング フィルターおよびルーティング テーブルを含む構成セクション。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.RoutingSection](assetId:///System.ServiceModel.Routing.Configuration.RoutingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Routing.Configuration.FilterTableCollection](assetId:///System.ServiceModel.Routing.Configuration.FilterTableCollection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/findcriteria.md b/docs/framework/configure-apps/file-schema/wcf/findcriteria.md
new file mode 100644
index 00000000000..d4c2e811aff
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/findcriteria.md
@@ -0,0 +1,76 @@
+---
+title: "&lt;findCriteria&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5454cd19-6bf5-4ba8-94d1-f58d10dc1917
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;findCriteria&gt;
+探索サービスの検索にクライアント アプリケーションによって使用される基準を提供する構成要素。  基準は、\(探しているサービスを指定する\) 検索条件と \(検索をどのくらい続けるかを指定する\) 検索終了条件にグループ化できます。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <dynamicEndpoint>   
+          <standardEndpoint>  
+             <discoveryClientSettings discoveryEndpoint=”String” >  
+               <findCriteria duration=”TimeSpan”  
+                  maxResults=”Integer”   
+                  scopeMatchBy=”Uri” >  
+                  <contractTypeNames>  
+                     <add name="String" namespace="String" />  
+                  <contractTypeNames>  
+                  <extensions />  
+                  <scopes>  
+                    <add scope="URI"/>  
+                  </scopes>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+          <standardEndpoint>  
+       </dynamicEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|duration|ネットワーク上でサービスからの応答を待機する最長時間を指定する Timespan 値。  既定の時間は 20 秒です。|  
+|maxResults|ネットワークまたはインターネット上で待機する、サービスから応答の最大数を指定する整数。  `duration` 属性に指定した時間が経過する前に応答の最大数に達した場合、検索操作は終了します。|  
+|scopeMatchBy|Probe メッセージのスコープをエンドポイントのスコープと一致させるときに使用する、一致のアルゴリズムを指定する URI。<br /><br /> サポートされているスコープ一致規則は 5 つあります。  スコープ一致規則を指定しなかった場合は、`ScopeMatchByPrefix` が使用されます。  詳細については、「<xref:System.ServiceModel.Discovery.FindCriteria>」を参照してください。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<contractTypeNames\>](../../../../../docs/framework/configure-apps/file-schema/wcf/contracttypenames.md)|ワークフロー サービス コントラクト型の名前を格納する構成要素のコレクション。|  
+|\<findCriteria\> の \<extensions\>|拡張を提供する XML 要素オブジェクトのコレクション。|  
+|[\<scopes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopes.md)|特定のサービスを特定する検索操作の実行中に使用される絶対 URI を格納するオブジェクトのコレクション。<br /><br /> 特定のサービスが見つかった場合、サービス URI とスコープ URI が一致します。複雑な一致を処理するスコープ規則が使用されることもあります。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|サービス探索プロセスにクライアントとして参加するためにアプリケーションが必要とする設定を格納します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.FindCriteria>   
+ <xref:System.ServiceModel.Discovery.Configuration.FindCriteriaElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/headers-element.md b/docs/framework/configure-apps/file-schema/wcf/headers-element.md
new file mode 100644
index 00000000000..436949a2700
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/headers-element.md
@@ -0,0 +1,29 @@
+---
+title: "&lt;headers&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 040f7a8c-bb57-4db6-bdb0-cfb92a1b01af
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;headers&gt; 要素
+ローカル発行者を正しくアドレス指定するために必要なアドレス ヘッダーのコレクションが含まれます。  `add` キーワードを使用して、このコレクションにヘッダーを追加できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientElement.LocalIssuer%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersEndpointAddressElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Headers%2A>   
+ <xref:System.ServiceModel.Channels.AddressHeaderCollection>   
+ [方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/headers.md b/docs/framework/configure-apps/file-schema/wcf/headers.md
new file mode 100644
index 00000000000..60f71090fc0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/headers.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;headers&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c79b897d-8ea3-40b5-a8b6-2471941f7ed3
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;headers&gt;
+エンドポイントは、基本となる URI だけでなく、1 つ以上の SOAP ヘッダーによってアドレス指定することもできます。  これが役に立つのは、エンドポイントのクライアントに中継局を指す SOAP ヘッダーを含める必要がある、SOAP 中継局のシナリオの場合です。  この構成要素を使用して、カスタムのアドレス ヘッダーを定義できます。  エンドポイント ヘッダー コレクション内のエントリは、ユーザー定義の XML 要素です。  各要素は、正しい形式の XML である必要があります。  
+  
+## 構文  
+  
+```  
+  
+<headers>  
+    <Region xmlns="Uri">"String"</Region>  
+        <Member xmlns="Uri">"String"</Member>  
+</headers>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|Region||  
+|メンバー||  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md)|さまざまなタイプのエンドポイントを設定します。|  
+  
+## 解説  
+ オプション ヘッダーは、エンドポイントの識別または対話のために、より詳細なアドレス指定情報を提供します。  たとえば、ヘッダーを使用して、受信メッセージの処理方法や、エンドポイントからの応答メッセージの送信先を指定できるほか、複数のサービス インスタンスが使用できる場合に、特定ユーザーからの受信メッセージの処理に使用するインスタンスを指定できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Headers%2A>   
+ <xref:System.ServiceModel.Channels.AddressHeaderCollection>   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/host.md b/docs/framework/configure-apps/file-schema/wcf/host.md
new file mode 100644
index 00000000000..d9e1ad3a8a3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/host.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;host&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: be566d55-9d50-4b2e-985d-52a5cc26cbbb
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;host&gt;
+サービス ホストの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<host>  
+      <baseAddresses>  
+         <baseAddress baseAddress="string" />  
+      </baseAddresses>  
+      <timeOuts closeTimeout="TimeSpan"  
+         openTimeout="TimeSpan" >  
+</host>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<baseAddresses\>](../../../../../docs/framework/configure-apps/file-schema/wcf/baseaddresses.md)|サービス ホストによって使用されるベース アドレスを指定する `baseAddress` 要素のコレクション。|  
+|[\<timeOuts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/timeouts.md)|サービス ホストを開くまたは閉じるまでに待機できる期間を指定する構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<service\>](../../../../../docs/framework/configure-apps/file-schema/wcf/service.md)|[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスの設定を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HostElement>   
+ <xref:System.ServiceModel.ServiceHost>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/httpdigest-element.md b/docs/framework/configure-apps/file-schema/wcf/httpdigest-element.md
new file mode 100644
index 00000000000..2f075065f09
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/httpdigest-element.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;httpDigest&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3da4f276-dfd9-4247-8c07-01d83618727c
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;httpDigest&gt; 要素
+サービスに対するクライアントの認証時に使用されるダイジェスト型の資格情報を指定します。  
+  
+## 構文  
+  
+```  
+  
+<digest impersonationLevel="Identification/Impersonation/Delegation/Anonymous/None" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`impersonationLevel`|クライアントがサーバーと通信する偽装設定を設定します。  クライアントが選択する偽装モードは、サーバーでは適用されません。  以下の値が有効です。<br /><br /> -   Identification: サーバーはクライアントの ID および権限を取得できますが、クライアントを偽装することはできません。<br />-   Impersonation: サーバーは、ローカル システム上にあるクライアントのセキュリティ コンテキストを偽装できます。<br />-   Delegation: サーバーは、リモート システム上にあるクライアントのセキュリティ コンテキストを偽装できます。<br />-   Anonymous: サーバーは、クライアントを偽装したり、識別したりすることができません。<br />-   None: 偽装レベルが割り当てられていません。<br /><br /> 既定値は Identification です。  この属性は <xref:System.Security.Principal.TokenImpersonationLevel> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ ダイジェストは、アルゴリズムと入力セットを使用して決定されるハッシュです。  認証する側と認証される側はアルゴリズムに同意し、入力として使用されるデータを交換します。  クライアントはハッシュを計算して、サービスに送信できます。  また、サービスもハッシュを計算して、値を比較します。  一致すると、クライアントが検証されます。  
+  
+ この機能は、Windows の Active Directory およびインターネット インフォメーション サービス \(IIS\) と共に有効にする必要があります。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] [IIS 6.0 のダイジェスト認証](http://go.microsoft.com/fwlink/?LinkId=88443)。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.HttpDigest%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ClientCredentials.HttpDigest%2A>   
+ <xref:System.ServiceModel.Configuration.HttpDigestClientElement>   
+ <xref:System.ServiceModel.Security.HttpDigestClientCredential>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/httpstransport.md b/docs/framework/configure-apps/file-schema/wcf/httpstransport.md
new file mode 100644
index 00000000000..9908fa787ce
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/httpstransport.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;httpsTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: f6ed4bc0-7e38-4348-9259-30bf61eb9435
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;httpsTransport&gt;
+カスタム バインディングの SOAP メッセージを送信する HTTP トランスポートを指定します。  
+  
+## 構文  
+  
+```  
+  
+<httpsTransport  
+    allowCookies=Boolean"  
+    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"  
+    bypassProxyOnLocal=Boolean"  
+    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"  
+    manualAddressing="Boolean"  
+    maxBufferPoolSize="Integer"  
+    maxBufferSize="Integer"  
+    maxReceivedMessageSize="Integer"  
+    proxyAddress="Uri"  
+    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"        realm="String"  
+    requireClientCertificate=Boolean"  
+    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+        unsafeConnectionNtlmAuthentication="Boolean"  
+....useDefaultWebProxy="Boolean"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowCookies|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> この属性はクッキーを使用する ASMX Web サービスと対話する場合に使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|authenticationScheme|HTTP リスナーにより処理されているクライアント要求の認証に使用するプロトコルを指定します。  以下の値が有効です。<br /><br /> -   Digest: ダイジェスト認証を指定します。<br />-   Negotiate: クライアントとネゴシエートし、認証方式を決定します。  クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。<br />-   Ntlm: NTLM 認証を指定します。<br />-   Basic: 基本認証を指定します。<br />-   Anonymous: 匿名認証を指定します。<br /><br /> 既定は Anonymous です。  この属性は <xref:System.Net.AuthenticationSchemes> 型です。  この属性は 1 回だけ設定できます。|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> ローカル アドレスは、ローカル LAN またはイントラネット上にあるアドレスです。<br /><br /> [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、サービス アドレスが http:\/\/localhost で始まる場合は常にプロキシを無視します。<br /><br /> クライアントが同じマシン上のサービスと対話するときにプロキシを経由させる場合は、localhost ではなくホスト名を使用する必要があります。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  有効な値は次のとおりです。<br /><br /> -   StrongWildcard: \("\+"\) は、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。<br />-   Exact: ワイルドカードなし。<br />-   WeakWildcard: \("\*"\) は、StrongWildcard ではっきりとは一致しない、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。<br /><br /> 既定値は StrongWildcard です。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型です。|  
+|manualAddressing|ユーザーによるメッセージのアドレス指定の管理を有効にするブール値です。  このプロパティは、通常、アプリケーションが複数の宛先のどれにメッセージを送信するかを決定するルーターのシナリオで使用されます。<br /><br /> `true` に設定されている場合、チャネルではメッセージが既にアドレス指定されていると見なされ、他の情報は追加されません。  この場合、ユーザーはすべてのメッセージを別個にアドレス指定できます。<br /><br /> `false` に設定されている場合、既定の Windows Communication Foundation \(WCF\) アドレス指定機構により、すべてのメッセージのアドレスが自動的に作成されます。<br /><br /> 既定値は、`false` です。|  
+|maxBufferPoolSize|バッファー プールの最大サイズを指定する正の整数です。  既定値は 524288 です。<br /><br /> WCF の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxBufferSize|バッファーの最大サイズを指定する正の整数です。  既定値は 524288 です|  
+|maxReceivedMessageSize|受信できるメッセージの最大サイズを指定する正の整数。  既定値は 65536 です。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|proxyAuthenticationScheme|HTTP プロキシにより処理されているクライアント要求の認証に使用するプロトコルを指定します。  以下の値が有効です。<br /><br /> -   None: 認証は実行されません。<br />-   Digest: ダイジェスト認証を指定します。<br />-   Negotiate: クライアントとネゴシエートし、認証方式を決定します。  クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。<br />-   Ntlm: NTLM 認証を指定します。<br />-   Basic: 基本認証を指定します。<br />-   Anonymous: 匿名認証を指定します。<br />-   IntegratedWindowsAuthentication: Windows 認証を指定します。<br /><br /> 既定は Anonymous です。  この属性は <xref:System.Net.AuthenticationSchemes> 型です。|  
+|realm|プロキシおよびサーバーで使用するレルムを指定する文字列です。  既定値は空の文字列です。<br /><br /> サーバーは、レルムを使用して、保護されたリソースをパーティションに分割します。  パーティションごとに、独自の認証方式と承認データベースの両方、またはそのいずれかを指定できます。  レルムは、基本認証およびダイジェスト認証だけに使用されます。  クライアントが正常に認証されると、その認証は特定のレルムのすべてのリソースに対して有効となります。  レルムの詳細については、http:\/\/www.ietf.org の RFC 2617 を参照してください。|  
+|requireClientCertificate|サーバーがクライアントに HTTPS ハンドシェイクの一部としてクライアント証明書の提供を要求するかどうかを指定するブール値。  既定値は、`false` です。|  
+|transferMode|メッセージが要求や応答をバッファーするか、ストリーミングするかを指定します。  以下の値が有効です。<br /><br /> -   Buffered: 要求メッセージと応答メッセージをバッファーします。<br />-   Streamed: 要求メッセージと応答メッセージをストリーミングします。<br />-   StreamedRequest: 要求メッセージをストリーミングし、応答メッセージをバッファーします。<br />-   StreamedResponse: 要求メッセージをバッファーし、応答メッセージをストリーミングします。<br /><br /> 既定値はバッファーです。  この属性は <xref:System.ServiceModel.TransferMode> 型です。|  
+|unsafeConnectionNtlmAuthentication|サーバー上で安全ではない接続共有を有効にするかどうかを指定するブール値です。  既定値は、`false` です。  有効な場合、NTLM 認証は、TCP 接続ごとに 1 回実行されます。|  
+|useDefaultWebProxy|ユーザー固有の設定ではなく、コンピューター全体のプロキシ設定を使用するかどうかを指定するブール値です。  既定値は、`true` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ `httpsTransport` 要素は、HTTPS トランスポート プロトコルを実装するカスタム バインディングを作成する場合の開始点となります。  HTTPS は、セキュリティで保護された相互運用性のために使用される主要なトランスポートです。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、他の Web サービス スタックとの相互運用性を保証するために、HTTPS をサポートします。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HttpsTransportElement>   
+ <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/httptransport.md b/docs/framework/configure-apps/file-schema/wcf/httptransport.md
new file mode 100644
index 00000000000..f4cf0dae530
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/httptransport.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;httpTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 8b30c065-b32a-4fa3-8eb4-5537a9c6b897
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;httpTransport&gt;
+カスタム バインディングの SOAP メッセージを送信する HTTP トランスポートを指定します。  
+  
+## 構文  
+  
+```  
+  
+<httpTransport  
+    allowCookies=Boolean"  
+    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"  
+    bypassProxyOnLocal=Boolean"  
+    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"  
+    keepAliveEnabled="Boolean"  
+    maxBufferSize="Integer"  
+    proxyAddress="Uri"  
+    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"  
+IntegratedWindowsAuthentication: Specifies Windows authentication"  
+    realm="String"  
+    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+        unsafeConnectionNtlmAuthentication="Boolean"  
+        useDefaultWebProxy="Boolean" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowCookies|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> この属性はクッキーを使用する ASMX Web サービスと対話する場合に使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|authenticationScheme|HTTP リスナーにより処理されているクライアント要求の認証に使用するプロトコルを指定します。  以下の値が有効です。<br /><br /> -   Digest: ダイジェスト認証を指定します。<br />-   Negotiate: クライアントとネゴシエートし、認証方式を決定します。  クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。<br />-   Ntlm: NTLM 認証を指定します。<br />-   Basic: 基本認証を指定します。<br />-   Anonymous: 匿名認証を指定します。<br /><br /> 既定は Anonymous です。  この属性は <xref:System.Net.AuthenticationSchemes> 型です。  この属性は 1 回だけ設定できます。|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> ローカル アドレスは、ローカル LAN またはイントラネット上にあるアドレスです。<br /><br /> [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、サービス アドレスが http:\/\/localhost で始まる場合は常にプロキシを無視します。<br /><br /> クライアントが同じマシン上のサービスと対話するときにプロキシを経由させる場合は、localhost ではなくホスト名を使用する必要があります。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  有効な値は次のとおりです。<br /><br /> -   StrongWildcard: \("\+"\) は、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。<br />-   Exact: ワイルドカードなし。<br />-   WeakWildcard: \("\*"\) は、StrongWildcard ではっきりとは一致しない、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。<br /><br /> 既定値は StrongWildcard です。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型です。|  
+|keepAliveEnabled|インターネット リソースへの永続的な接続を行うかどうかを示すブール値。|  
+|maxBufferSize|バッファーの最大サイズを指定する正の整数です。  既定値は 524288 です|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|proxyAuthenticationScheme|HTTP プロキシにより処理されているクライアント要求の認証に使用するプロトコルを指定します。  以下の値が有効です。<br /><br /> -   None: 認証は実行されません。<br />-   Digest: ダイジェスト認証を指定します。<br />-   Negotiate: クライアントとネゴシエートし、認証方式を決定します。  クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。<br />-   Ntlm: NTLM 認証を指定します。<br />-   Basic: 基本認証を指定します。<br />-   Anonymous: 匿名認証を指定します。<br />-   IntegratedWindowsAuthentication: Windows 認証を指定します。<br /><br /> 既定は Anonymous です。  この属性は <xref:System.Net.AuthenticationSchemes> 型です。|  
+|realm|プロキシおよびサーバーで使用するレルムを指定する文字列です。  既定値は空の文字列です。<br /><br /> サーバーは、レルムを使用して、保護されたリソースをパーティションに分割します。  パーティションごとに、独自の認証方式と承認データベースの両方、またはそのいずれかを指定できます。  レルムは、基本認証およびダイジェスト認証だけに使用されます。  クライアントが正常に認証されると、その認証は特定のレルムのすべてのリソースに対して有効となります。  レルムの詳細については、http:\/\/www.ietf.org の RFC 2617 を参照してください。|  
+|transferMode|メッセージが要求や応答をバッファーするか、ストリーミングするかを指定します。  以下の値が有効です。<br /><br /> -   Buffered: 要求メッセージと応答メッセージをバッファーします。<br />-   Streamed: 要求メッセージと応答メッセージをストリーミングします。<br />-   StreamedRequest: 要求メッセージをストリーミングし、応答メッセージをバッファーします。<br />-   StreamedResponse: 要求メッセージをバッファーし、応答メッセージをストリーミングします。<br /><br /> 既定値はバッファーです。  この属性は <xref:System.ServiceModel.TransferMode> 型です。|  
+|unsafeConnectionNtlmAuthentication|サーバー上で安全ではない接続共有を有効にするかどうかを指定するブール値です。  既定値は、`false` です。  有効な場合、NTLM 認証は、TCP 接続ごとに 1 回実行されます。|  
+|useDefaultWebProxy|ユーザー固有の設定ではなく、コンピューター全体のプロキシ設定を使用するかどうかを指定するブール値です。  既定値は、`true` です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ `httpTransport` 要素は、HTTP トランスポート プロトコルを実装するカスタム バインディングを作成する場合の開始点となります。  HTTP は、相互運用性のために使用される主要なトランスポートです。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、他の非 [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] Web サービス スタックとの相互運用性を保証するために、このトランスポートをサポートします。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HttpTransportElement>   
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/identity.md b/docs/framework/configure-apps/file-schema/wcf/identity.md
new file mode 100644
index 00000000000..0d6234f4763
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/identity.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;identity&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1d2ae56-e231-4a07-9c3f-9f13381dc0d8
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# &lt;identity&gt;
+ID 要素を使用すると、クライアント開発者は予想されるサービスの ID をデザイン時に指定できます。  クライアントとサービス間のハンドシェイク プロセスでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] インフラストラクチャが、予想されるサービスの ID とこの要素の値との一致を確実に行うので、認証が可能になります。  詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<identity>  
+    <certificate encodedValue="String"/>  
+    <certificateReference findValue="String"   
+       isChainIncluded="Boolean"  
+       storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"storeName="  
+       storeLocation="LocalMachine/CurrentUser"  
+       X509FindType= Enumeration./>  
+    <dns value="String"/>  
+    <rsa value="String"/>  
+    <servicePrincipalName value="String"/>  
+    <usePrincipalName value="String"/>  
+</identity>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|certificate|X.509 証明書の設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.CertificateElement> 型です。  この要素には、この証明書でエンコードされる値を指定する文字列の `encodedValue` 属性が含まれています。|  
+|certificateReference|X.509 証明書検証の設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.CertificateReferenceElement> 型です。|  
+|dns|サービスの認証に使用される X.509 証明書の DNS を指定します。  この要素には、実際の ID を含む文字列の `value` 属性が含まれています。|  
+|rsa|クライアントに対するサービスの認証に使用される X.509 証明書の RSA フィールドの値を指定します。  この要素には、実際の ID を含む文字列の `value` 属性が含まれています|  
+|servicePrincipalName|サーバー プリンシパル名 \(SPN\) ID を指定します。これは、サービスのインスタンスを一意に識別するために、クライアントにより使用されるプリンシパル名です。  この要素には、実際のプリンシパル名が文字列で含まれている `value` 属性が含まれています。  この要素は <xref:System.ServiceModel.Configuration.ServicePrincipalNameElement> 型です。|  
+|userPrincipalName|ユーザー プリンシパル名 \(UPN\) ID を指定します。これは、ネットワーク上のユーザーのログオン名の種類です。  ユーザー プリンシパル名では、Active Directory で使用されるユーザー オブジェクト名の後に、@ 記号が続き、通常はその後にドメイン名システムの親ドメインが続きます。  たとえば、Fabrikam.com ドメイン ツリーの Jeff のユーザー プリンシパル名は、[jeff@fabrikam.com](mailto:jeffsmith@fabrikam.com) となります。  この要素には、実際のプリンシパル名が文字列で含まれている `value` 属性が含まれています。  この要素は <xref:System.ServiceModel.Configuration.UserPrincipalNameElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<custom\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custom.md)|netPeerTcpBinding のカスタム ピア リゾルバーを指定します。|  
+|[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017)|さまざまなタイプのエンドポイントを設定します。|  
+|[\<issuer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuer.md)|フェデレーション サービスのセキュリティ トークン サービス \(STS\) を指定します。|  
+|[\<issuerMetadata\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuermetadata.md)|フェデレーション サービスのセキュリティ トークン サービス \(STS\) のメタデータ エンドポイントを指定します。|  
+|[\<issuedTokenParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md)|カスタム バインディングで発行済みトークンのパラメーターを定義します。|  
+|[\<localIssuer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localissuer.md)|ローカル セキュリティ トークン サービス \(STS\) を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/index.md b/docs/framework/configure-apps/file-schema/wcf/index.md
new file mode 100644
index 00000000000..2479f6077ae
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/index.md
@@ -0,0 +1,50 @@
+---
+title: "WCF 構成スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: c282aeb5-91f0-4522-8e2f-704c1ef3651f
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# WCF 構成スキーマ
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] 構成要素を使用して、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のサービス アプリケーションとクライアント アプリケーションを構成できます。  [構成エディター ツール \(SvcConfigEditor.exe\)](../../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) を使用して、クライアントとサービスの構成ファイルを作成および変更できます。  構成ファイルは XML として書式設定されているので、テキスト エディターを使用して手動で編集する場合は、XML について理解している必要があります。  理解しないで編集すると、XML 要素タグや属性が見つからないなどの問題が発生する可能性があります。  問題の原因は、XML 要素タグと属性が大文字と小文字を区別することによります。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 構成システムは、<xref:System.Configuration> 名前空間に基づいています。  したがって、<xref:System.Configuration> 名前空間によって提供される、構成ロック、暗号化、マージなどのすべての標準機能を使用して、アプリケーションとその構成のセキュリティを強化できます。  これらの概念の詳細については、次のトピックを参照してください。  
+  
+ [保護された構成を使用した構成情報の暗号化](http://go.microsoft.com/fwlink/?LinkId=95337)  
+  
+ [構成設定のロック](http://go.microsoft.com/fwlink/?LinkId=95338)  
+  
+ このセクションでは、各構成項目のすべての可能な値についてと各構成項目が他の WCF 構成要素とやり取りする方法について説明します。  次のマップは、WCF 構成スキーマを示します。  
+  
+ ![WCF 構成スキーマ](../../../../../docs/framework/configure-apps/file-schema/wcf/media/orcasconfigschema.gif "OrcasConfigSchema")  
+  
+> [!CAUTION]
+>  潜在的なセキュリティ上の脅威を避けるために、アプリケーション構成ファイル \(app.config\) の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 構成セクションは、適切なアクセス制御リスト \(ACL\) を使用して保護する必要があります。  たとえば、適切なユーザーだけが、アプリケーション バインドのセキュリティ設定、またはサービスの構成ファイルのサービス モデル セクションにアクセスまたは変更できるようにする必要があります。  
+  
+## このセクションの内容  
+ [\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)  
+ `ServiceModel` 要素について説明します。  
+  
+ [\<system.serviceModel.activation\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md)  
+ SMSvcHost.exe ツールを構成します。  
+  
+ [\<system.runtime.serialization\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md)  
+ <xref:System.Runtime.Serialization.DataContractSerializer> などのシリアライザーの使用時にオプションを設定するための最上位の要素。  
+  
+## 関連項目  
+ [Configuring Windows Communication Foundation Applications](http://msdn.microsoft.com/ja-jp/13cb368e-88d4-4c61-8eed-2af0361c6d7a)  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のサービスとクライアントを構成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuedtoken.md b/docs/framework/configure-apps/file-schema/wcf/issuedtoken.md
new file mode 100644
index 00000000000..643508294b9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuedtoken.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;issuedToken&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6eae4b7-a6cd-4e1a-b0f6-f407022550b0
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;issuedToken&gt;
+サービスに対するクライアントの認証に使用されるカスタム トークンを指定します。  
+  
+## 構文  
+  
+```  
+  
+<issuedToken   
+   cacheIssuedTokens="Boolean"  
+   defaultKeyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"  
+   issuedTokenRenewalThresholdPercentage = "0 to 100"  
+   issuerChannelBehaviors="String"  
+      localIssuerChannelBehaviors="String"  
+   maxIssuedTokenCachingTime="TimeSpan"  
+</issuedToken>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`cacheIssuedTokens`|トークンがキャッシュされるかどうかを指定する省略可能なブール属性。  既定値は、`true` です。|  
+|`defaultKeyEntropyMode`|ハンドシェイク操作に使用されるランダム値 \(エントロピ\) を指定する省略可能な文字列属性。  値には、`ClientEntropy`、`ServerEntropy`、および `CombinedEntropy` があります。既定値は `CombinedEntropy` です。  この属性は <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> 型です。|  
+|`issuedTokenRenewalThresholdPercentage`|トークンが更新されるまでに待機できる有効な期間 \(トークン発行者によって提供される\) のパーセンテージを指定する省略可能な整数属性。  値は 0 ～ 100 の範囲です。  既定値は 60 で、更新の実行までに待機できる期間の 60% を示します。|  
+|`issuerChannelBehaviors`|発行者との通信時に使用するチャネル動作を指定する省略可能な属性。|  
+|`localIssuerChannelBehaviors`|ローカル発行者との通信時に使用するチャネル動作を指定する省略可能な属性。|  
+|`maxIssuedTokenCachingTime`|トークン発行者 \(STS\) が期間を指定しない場合に、発行済みトークンがキャッシュされる期間を指定する省略可能な Timespan 属性。  既定値は “10675199.02:48:05.4775807” です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<localIssuer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localissuer.md)|トークンのローカル発行者のアドレスと、エンドポイントとの通信に使用されるバインディングを指定します。|  
+|[\<issuerChannelBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md)|ローカル発行者に接続するときに使用するエンドポイント動作を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ 発行済みトークンは、フェデレーション シナリオでセキュリティ トークン サービス \(STS\) を使用して認証するときに使用されるカスタム資格情報の種類です。  既定ではトークンは、SAML トークンです。  詳細については、「[フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。   および [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md) を参照してください。  
+  
+ このセクションには、トークンのローカル発行者やセキュリティ トークン サービスで使用する動作の構成に使用する要素が含まれます。  ローカル発行者を使用するようにクライアントを構成する手順については、「[方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.IssuedToken%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials.IssuedToken%2A>   
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md
new file mode 100644
index 00000000000..5bd971cc94f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;serviceCredentials&gt; の &lt;issuedTokenAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c2e288f-f603-4d13-839a-0fd6d1981bec
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;serviceCredentials&gt; の &lt;issuedTokenAuthentication&gt;
+サービス資格情報として発行されるカスタム トークンを指定します。  
+  
+## 構文  
+  
+```  
+  
+<issuedTokenAuthentication   
+   allowUntrustedRsaIssuers="Boolean"  
+   audienceUriMode="Always/BearerKeyOnly/Never"  
+      customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+   revocationMode="NoCheck/Online/Offline"  
+   samlSerializer="String"  
+    trustedStoreLocation="CurrentUser/LocalMachine">  
+      <allowedAudienceUris>  
+      <add allowedAudienceUri="String"/>  
+      </allowedAudienceUris>  
+      <knownCertificates>   
+         <add findValue="String"  
+                 storeLocation="CurrentUser/LocalMachine"  
+                storeName=" CurrentUser/LocalMachine"  
+                x509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"/>  
+      </knownCertificates>  
+</issuedTokenAuthentication>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowedAudienceUris`|<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> インスタンスにより有効と見なされるように、<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンのターゲットとなる URI のセットを取得します。  この属性の使い方の詳細については、「<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>」を参照してください。|  
+|`allowUntrustedRsaIssuers`|信頼できない RSA 証明書の発行者を許可するかどうかを指定するブール値。<br /><br /> 証明書は、信頼性を検証する証明機関 \(CA\) によって署名されます。  信頼できない発行者とは、証明書の署名が信頼できると指定されていない CA です。|  
+|`audienceUriMode`|<xref:System.IdentityModel.Tokens.SamlSecurityToken> セキュリティ トークンの <xref:System.IdentityModel.Tokens.SamlAudienceRestrictionCondition> を検証するかどうかを指定する値を取得します。  この値は、<xref:System.IdentityModel.Selectors.AudienceUriMode> 型です。  この属性の使い方の詳細については、「<xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>」を参照してください。|  
+|`certificateValidationMode`|証明書検証モードを設定します。  <xref:System.ServiceModel.Security.X509CertificateValidationMode> の有効な値のいずれかです。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。  既定値は、`ChainTrust` です。|  
+|`customCertificateValidatorType`|省略可能な文字列。  カスタム型の検証に使用される型およびアセンブリです。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。|  
+|`revocationMode`|失効状態の検証を行うかどうかに加え、検証をオンラインで実行するか、オフラインで実行するかを指定する失効モードを設定します。  この属性は <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 型です。|  
+|`samlSerializer`|サービス資格情報に使用される SamlSerializer の型を指定する省略可能な文字列属性。  既定値は空の文字列です。|  
+|`trustedStoreLocation`|省略可能な列挙体です。  2 つのシステム格納場所 \(`LocalMachine` または `CurrentUser`\) のいずれかです。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`knownCertificates`|サービス資格情報の信頼できる発行者を指定する <xref:System.ServiceModel.Configuration.X509CertificateTrustedIssuerElement> 要素のコレクションを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ 発行されるトークンのシナリオには、3 つの段階があります。  まず、サービスにアクセスしようとしているクライアントが*セキュリティ トークン サービス*に参照されます。  次に、セキュリティ トークン サービスがクライアントを認証し、その後、クライアントにトークン \(通常は、SAML \(Security Assertions Markup Language\) トークン\) を発行します。  最後に、クライアントがトークンを持ってサービスに戻ります。  サービスはトークンを調べ、トークンを認証することでクライアントの認証を可能にするデータを確認します。  トークンを認証するには、セキュリティ トークン サービスで使用される証明書がサービスによって認識されている必要があります。  
+  
+ この要素は、このようなセキュリティ トークン サービス証明書のリポジトリです。  証明書を追加するには、[\<knownCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md) を使用します。  次の例に示すように、証明書ごとに [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md) を挿入します。  
+  
+```  
+<issuedTokenAuthorization>  
+   <knownCertificates>  
+      <add findValue="www.contoso.com"   
+           storeLocation="LocalMachine" storeName="My"   
+           X509FindType="FindBySubjectName" />  
+    </knownCertificates>  
+</issuedTokenAuthentication>  
+```  
+  
+ 既定では、証明書はセキュリティ トークン サービスから取得する必要があります。  このような "既知" の証明書により、正当なクライアントのみがサービスにアクセスできるようになります。  
+  
+ この構成要素の使用の詳細については、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.IssuedTokenAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.IssuedTokenAuthentication%2A>   
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md b/docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md
new file mode 100644
index 00000000000..5e14292c8e6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;issuedTokenParameters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 120b3f37-7331-4816-b712-d6aab39655a4
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;issuedTokenParameters&gt;
+フェデレーション セキュリティのシナリオで発行されるセキュリティ トークンのパラメーターを指定します。  
+  
+## 構文  
+  
+```  
+  
+<issuedTokenParameters   
+      DefaultMessageSecurityVersion="System.ServiceModel.MessageSecurityVersion"  
+      inclusionMode="AlwaysToInitiator/AlwaysToRecipient/Never/Once"  
+      keySize="Integer"  
+   keyType="AsymmetricKey/BearerKey/SymmetricKey"  
+      tokenType="String" >  
+   <additionalRequestParameters />  
+      <claimTypeRequirements>  
+            <add claimType="URI"  
+           isOptional="Boolean" />  
+      </claimTypeRequirements>  
+      <issuer address="String"   
+                      binding=" " />  
+      <issuerMetadata address="String" />   
+</issuedTokenParameters>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|defaultMessageSecurityVersion|バインドでサポートする必要があるセキュリティ仕様 \(WS\-Security、WS\-Trust、WS\-Secure Conversation、および WS\-Security Policy\) のバージョンを指定します。  この値は、<xref:System.ServiceModel.MessageSecurityVersion> 型です。|  
+|inclusionMode|トークン包含要件を指定します。  この属性は <xref:System.ServiceModel.Security.Tokens.SecurityTokenInclusionMode> 型です。|  
+|keySize|トークン キー サイズを指定する整数。  既定値は 256 です。|  
+|keyType|キーの型を指定する <xref:System.IdentityModel.Tokens.SecurityKeyType> の有効な値。  既定値は、`SymmetricKey` です。|  
+|tokenType|トークンの種類を指定する文字列。  既定値は、"http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.1\#SAML" です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<additionalRequestParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/additionalrequestparameters-element.md)|追加の要求パラメーターを指定する構成要素のコレクション。|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md)|必須のクレームの種類のコレクションを指定します。<br /><br /> フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須の要求および省略可能な要求の種類を指定します。|  
+|[\<issuer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuer-of-issuedtokenparameters.md)|現在のトークンを発行するエンドポイントを指定する構成要素。|  
+|[\<issuerMetadata\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuermetadata-of-issuedtokenparameters.md)|トークン発行者のメタデータのエンドポイント アドレスを指定する構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<secureConversationBootstrap\>](../../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)|セキュリティで保護されたメッセージ交換サービスの開始に使用される既定値を指定します。|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)|カスタム バインディングのセキュリティ オプションを指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement>   
+ <xref:System.ServiceModel.Configuration.SecurityElementBase.IssuedTokenParameters%2A>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuer-of-issuedtokenparameters.md b/docs/framework/configure-apps/file-schema/wcf/issuer-of-issuedtokenparameters.md
new file mode 100644
index 00000000000..83733cdfc2d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuer-of-issuedtokenparameters.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;issuedTokenParameters&gt; の &lt;issuer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6a95f32-d58c-40fc-8658-dd92564d3c90
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;issuedTokenParameters&gt; の &lt;issuer&gt;
+セキュリティ トークンを発行するセキュリティ トークン サービス \(STS\) を指定します。  
+  
+## 構文  
+  
+```  
+  
+<issuer address="Uri" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必須の文字列。  STS の URL です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|ビルダーが作成できるエンドポイントのアドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|発行されたトークンを使用する場合、クライアントでサーバーの認証を有効にする設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md)|現在発行されているトークンを指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.AdditionalRequestParameters%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement.AdditionalRequestParameters%2A>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuer.md b/docs/framework/configure-apps/file-schema/wcf/issuer.md
new file mode 100644
index 00000000000..574d928046d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuer.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;issuer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8c49c6ae-fa1a-4179-a84b-613c3216dcde
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;issuer&gt;
+セキュリティ トークンを発行するセキュリティ トークン サービス \(STS\) を指定します。  
+  
+## 構文  
+  
+```  
+  
+<issuer address="Uri" >  
+   <headers>  
+      <add name="String"  
+                 namespace="String" />  
+   </headers>  
+   <identity>  
+           <certificate encodedValue="String"/>  
+      <certificateReference findValue="String"   
+         isChainIncluded="Boolean"  
+         storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+         storeLocation="LocalMachine/CurrentUser"  
+                  x509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+      <dns value="String"/>  
+      <rsa value="String"/>  
+      <servicePrincipalName value="String"/>  
+      <usePrincipalName value="String"/>  
+   </identity>  
+</issuer>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必須の文字列。  STS の URL です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|ビルダーが作成できるエンドポイントのアドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|発行されたトークンを使用する場合、クライアントでサーバーの認証を有効にする設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md)|[\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) 要素のメッセージ レベル セキュリティの設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.Issuer%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersEndpointAddressElement>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md b/docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md
new file mode 100644
index 00000000000..3cf7dbe4e8f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;issuerChannelBehaviors&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f7378673-8e9b-45b2-98d1-cf5dccdd8c40
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;issuerChannelBehaviors&gt; 要素
+指定されたセキュリティ トークン サービスと通信するときに使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] クライアント エンドポイントの動作 \(構成で定義されている\) のコレクションが含まれています。  定義された動作には、[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素を含めることができません。  
+  
+## 構文  
+  
+```  
+  
+<issuerChannelBehaviors>  
+      <add behaviorConfiguraton="string"  
+                issuerAddress="string" />  
+</issuerChannelBehaviors>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-issuerchannelbehaviors.md)|コレクションに動作を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedToken\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md)|サービスに対するクライアントの認証に使用されるカスタム トークンを指定します。|  
+  
+## 解説  
+ この要素を使用するのは、なんらかの動作 \(`<clientCredentials>` 要素を含む動作以外\) を使用してサービスと通信する必要がある場合です。  たとえば、[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md) 動作の要素を含める必要がある場合などです。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientElement.IssuerChannelBehaviors%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientBehaviorsElement>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientBehaviorsElementCollection>   
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential.IssuerChannelBehaviors%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuermetadata-of-issuedtokenparameters.md b/docs/framework/configure-apps/file-schema/wcf/issuermetadata-of-issuedtokenparameters.md
new file mode 100644
index 00000000000..3b556ef1ab5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuermetadata-of-issuedtokenparameters.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;issuedTokenParameters&gt; の &lt;issuerMetadata&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1a85ca37-496d-4fa3-8d44-d6c9383d735c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;issuedTokenParameters&gt; の &lt;issuerMetadata&gt;
+## 構文  
+  
+```  
+  
+<issuerMetaData address=String"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必ず指定します。  エンドポイントのアドレスを指定する文字列。  アドレスは、絶対 URI にする必要があります。  既定値は空の文字列です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|アドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md)|フェデレーション セキュリティのシナリオで発行されるセキュリティ トークンのパラメーターを指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/issuermetadata.md b/docs/framework/configure-apps/file-schema/wcf/issuermetadata.md
new file mode 100644
index 00000000000..93b20c45b96
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/issuermetadata.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;issuerMetadata&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7eae2c0-cc17-4281-af59-e4eb8d54f92a
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# &lt;issuerMetadata&gt;
+## 構文  
+  
+```  
+  
+<issuerMetadata address=String" >  
+   <headers>  
+      <add name="String"  
+                 namespace="String" />  
+   </headers>  
+   <identity>  
+           <certificate encodedValue="String"/>  
+      <certificateReference findValue="String"   
+         isChainIncluded="Boolean"  
+         storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+         storeLocation="LocalMachine/CurrentUser"  
+                  x509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+      <dns value="String"/>  
+      <rsa value="String"/>  
+      <servicePrincipalName value="String"/>  
+      <usePrincipalName value="String"/>  
+   </identity>  
+</issuerMetadata>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必須の `string` 属性です。<br /><br /> エンドポイントのアドレスを指定します。  アドレスは、絶対 URI にする必要があります。  既定値は空の文字列です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|アドレス ヘッダーのコレクション。|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|メッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする ID です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md)|[\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) 要素のメッセージ レベル セキュリティの設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerMetadataAddress%2A>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.IssuerMetadata%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/knowncertificates.md b/docs/framework/configure-apps/file-schema/wcf/knowncertificates.md
new file mode 100644
index 00000000000..33e5a74a3a7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/knowncertificates.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;knownCertificates&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 678e21b4-6493-47c3-8359-fcf0d37e2138
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# &lt;knownCertificates&gt;
+セキュリティ トークン サービス \(STS\) から発行されるセキュリティ資格情報を認証するために提供される X.509 証明書のコレクションを表します。  
+  
+## 構文  
+  
+```  
+  
+<knownCertificates>   
+      <add findValue="String"  
+         storeLocation="CurrentUser/LocalMachine"  
+          storeName=" CurrentUser/LocalMachine"  
+           x509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"/>  
+</knownCertificates>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md)|コレクションに X.509 証明書を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)|サービス資格情報として発行されるトークンを指定します。|  
+  
+## 解説  
+ 発行されるトークンのシナリオには、3 つの段階があります。  まず、サービスにアクセスしようとしているクライアントが*セキュリティ トークン サービス*に参照されます。  次に、セキュリティ トークン サービスがクライアントを認証し、その後、クライアントにトークン \(通常は、SAML \(Security Assertions Markup Language\) トークン\) を発行します。  最後に、クライアントがトークンを持ってサービスに戻ります。  サービスはトークンを調べ、トークンを認証することでクライアントの認証を可能にするデータを確認します。  トークンを認証するには、セキュリティ トークン サービスで使用される証明書がサービスによって認識されている必要があります。  
+  
+ [\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md) 要素は、このようなセキュリティ トークン サービス証明書のリポジトリです。  証明書を追加するには、[\<knownCertificates\> element](../../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md) を使用します。  次の例に示すように、証明書ごとに [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md) を挿入します。  
+  
+```  
+<issuedTokenAuthentication>  
+   <knownCertificates>  
+      <add findValue="www.contoso.com"   
+           storeLocation="LocalMachine" storeName="My"   
+           X509FindType="FindBySubjectName" />  
+    </knownCertificates>  
+</issuedTokenAuthentication>  
+```  
+  
+ 既定では、証明書はセキュリティ トークン サービスから取得する必要があります。  このような "既知" の証明書により、正当なクライアントのみがサービスにアクセスできるようになります。  
+  
+ クライアントがフェデレーション サービスによって認証される条件と、この構成要素の使い方の詳細については、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  フェデレーション シナリオの詳細については、「[フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+ 構成のコレクションを設定する方法の例については、「[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AllowedAudienceUris%2A>   
+ <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator.AudienceUriMode%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement.KnownCertificates%2A>   
+ <xref:System.ServiceModel.Configuration.X509CertificateTrustedIssuerElementCollection>   
+ <xref:System.ServiceModel.Configuration.X509CertificateTrustedIssuerElement>   
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A>   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md)   
+ [\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/knowntype.md b/docs/framework/configure-apps/file-schema/wcf/knowntype.md
new file mode 100644
index 00000000000..09cc8d139a5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/knowntype.md
@@ -0,0 +1,78 @@
+---
+title: "&lt;knownType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee2b7be3-7148-4a3a-b861-48e7330615e5
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;knownType&gt;
+逆シリアル化中に <xref:System.Runtime.Serialization.DataContractSerializer> によって使用される型を指定します。  この要素には、"宣言型" のフィールドまたはプロパティによって返される "既知の型" を指定します。詳細については、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<knownType type="String">  
+     <parameter index="Integer"  
+                type="String" />  
+</knownType>  
+```  
+  
+## 型  
+ `string`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|型|型 \(名前空間を含む\)、アセンブリ名、バージョン、カルチャ、および公開キー トークンを指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<parameter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/parameter.md)|宣言型がジェネリック型である場合に、パラメーター インデックスを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)|宣言されたタイプのコレクションに、宣言されたタイプを追加します。|  
+  
+## 解説  
+ 既知の型の詳細については、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」および「<xref:System.Runtime.Serialization.DataContractSerializer>」を参照してください。  
+  
+ この要素の使用例については、「[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<add type="MyCompany.Library.Shape,   
+           MyAssembly, Version=2.0.0.0, Culture=neutral,  
+           PublicKeyToken=XXXXXX, processorArchitecture=MSIL">  
+           <knownType type="MyCompany.Library.Circle,   
+                      MyAssembly, Version=2.0.0.0, Culture=neutral,  
+                      PublicKeyToken=XXXXXX,  
+                      processorArchitecture=MSIL"/>  
+</add>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md b/docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md
new file mode 100644
index 00000000000..34e106b6f3d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;localClientSettings&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4680ace5-f4e1-4fcb-b9d8-a4a4af5cd7ae
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;localClientSettings&gt; 要素
+このバインディングのローカル クライアントのセキュリティ設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<security>  
+   <localClientSettings cacheCookies="Boolean"  
+      cookieRenewalThresholdPercentage="Integer"  
+      detectReplays="Boolean"  
+      maxClockSkew="TimeSpan"  
+      maxCookieCachingTime="TimeSpan"  
+      reconnectTransportOnFailure="Boolean"  
+      replayCacheSize="Integer"  
+      replayWindow="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      timestampValidityDuration="TimeSpan" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`cacheCookies`|クッキーのキャッシュが有効かどうかを示すブール値。  既定値は、`false` です。|  
+|`cookieRenewalThresholdPercentage`|更新できるクッキーの最大パーセンテージを指定する整数。  この値は、0 ～ 100 \(0 と 100を含む\) のいずれかです。  既定値は 90 です。|  
+|`detectReplays`|チャネルに対するリプレイ攻撃を検出し、自動的に処理するかどうかを指定するブール値です。  既定値は、`false` です。|  
+|`maxClockSkew`|通信している双方の 2 つのシステム クロックのずれの最長時間を指定する <xref:System.TimeSpan>。  既定値は、"00:05:00" です。<br /><br /> この値が既定値に設定されている場合、受信側はメッセージが受信された時間より前後最大 5 分間の送信時間タイム スタンプを持つメッセージを受け入れます。  送信時間テストにパスしないメッセージは拒否されます。  この設定は、`replayWindow` 属性と組み合わせて使用します。|  
+|`maxCookieCachingTime`|クッキーの最長有効期間を指定する <xref:System.TimeSpan>。  デフォルト値は "10675199.02:48:05.4775807" です。|  
+|`reconnectTransportOnFailure`|WS\-ReliableMessaging を使用した接続が、トランスポート エラーの後再接続を試みるかどうかを指定するブール値です。  既定値は `true` です。これは、再接続の試行が無限に行われることを意味します。  循環は非アクティブ タイムアウトにより破棄され、再接続できない場合はチャネルが例外をスローします。|  
+|`replayCacheSize`|リプレイ検証で使用される、キャッシュ済みの nonce 数を指定する正の整数。  この制限を越えると、最も古い nonce が削除され、新しいメッセージ用に新しい nonce が作成されます。  既定値は 500000 です。|  
+|`replayWindow`|個別のメッセージ nonce の有効期間を指定する <xref:System.TimeSpan>。<br /><br /> この期間が過ぎると、以前に送信されたメッセージと同じ nonce を持つメッセージは受け入れられません。  この属性は、リプレイ攻撃を防ぐために `maxClockSkew` 属性と組み合わせて使用します。  攻撃者は、メッセージのリプレイ ウィンドウの期限が切れた後にメッセージをリプレイする可能性があります。  ただし、このメッセージは `maxClockSkew` テストに失敗します。このテストは、メッセージが受信された時間の前後指定時間以内の送信時間タイムスタンプを持つメッセージを拒否します。|  
+|`sessionKeyRenewalInterval`|イニシエーターがセキュリティ セッションのキーを更新するまでの期間を指定する <xref:System.TimeSpan>。  既定値は "10:00:00" です。|  
+|`sessionKeyRolloverInterval`|キーの更新中に、前のセッション キーが受信メッセージで有効な時間間隔を指定する <xref:System.TimeSpan> です。  既定値は "00:05:00" です。<br /><br /> キーの更新中、クライアントおよびサーバーは、常に、利用可能な最新のキーを使用してメッセージを送信する必要があります。  どちらのパーティも、ロールオーバー時間に達するまで、前のセッション キーで保護された受信メッセージを受け入れます。|  
+|`timestampValidityDuration`|タイムスタンプの有効期間を指定する正の <xref:System.TimeSpan>。  既定値は "00:15:00" です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)|カスタム バインディングのセキュリティ オプションを指定します。|  
+|[\<secureConversationBootstrap\>](../../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)|セキュリティで保護されたメッセージ交換サービスの開始に使用される既定値を指定します。|  
+  
+## 解説  
+ この設定は、サービスのセキュリティ ポリシーから派生する設定ではないという点でローカルです。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.LocalClientSecuritySettingsElement>   
+ <xref:System.ServiceModel.Configuration.SecurityElementBase.LocalClientSettings%2A>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalClientSettings%2A>   
+ <xref:System.ServiceModel.Channels.LocalClientSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/localissuer.md b/docs/framework/configure-apps/file-schema/wcf/localissuer.md
new file mode 100644
index 00000000000..7f6c71e59d2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/localissuer.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;localIssuer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 26bdd0df-0e7d-4b9e-bbeb-f28c53769385
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;localIssuer&gt;
+セキュリティ トークンの取得に使用される、ローカル発行者のアドレスとバインディングを指定します。  
+  
+## 構文  
+  
+```  
+  
+<localIssuer address="string"  
+      binding="string"  
+      bindingConfiguration="string" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|address|必須の文字列。  ローカル発行者の URI を指定します。|  
+|バインド|省略可能な文字列。  システム指定のバインディングの 1 つ。  一覧については、「[システム標準のバインディング](../../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。|  
+|bindingConfiguration|省略可能な文字列。  構成ファイル内に存在するバインディング構成を指定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|ローカル発行者の ID 情報を指定します。|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)|ローカル発行者を正しくアドレス指定するために必要なアドレス ヘッダーのコレクション。  `add` キーワードを使用して、このコレクションにヘッダーを追加できます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedToken\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md)|サービスに対するクライアントの認証に使用されるカスタム トークンを指定します。|  
+  
+## 解説  
+ 発行されたトークンをセキュリティ トークン サービス \(STS\) から取得する場合は、クライアント アプリケーションに、STS との通信に使用するアドレスとバインディングが構成されている必要があります。  <xref:System.ServiceModel.WSFederationHttpBinding> にセキュリティ トークン サービスの URL が設定されていない場合、またはフェデレーション バインディングの発行者アドレスが http:\/\/schemas.microsoft.com\/2005\/12\/ServiceModel\/Addressing\/Anonymous か `null` である場合、クライアントの [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] チャネルは、`address` と `binding` で指定された値を使用して STS と通信し、発行されたトークンを取得します。  ローカル発行者の構成の詳細については、「[方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、`localIssuer` 要素の `address`、`binding`、および `bindingConfiguration` 属性を設定します。  
+  
+```  
+<system.serviceModel>  
+ <behaviors>  
+ <endpointBehaviors>  
+  <behavior name="MyEndpointBehavior">  
+   <clientCredentials>  
+    <issuedToken cacheIssuedTokens="false"   
+                 defaultKeyEntropyMode="ClientEntropy">  
+     <localIssuer address="net.tcp://cohowinery/tokens"   
+                  binding="netTcpBinding"  
+                  bindingConfiguration="myTcpBindingConfig" />  
+    </issuedToken>  
+   </clientCredentials>  
+  </behavior>  
+  </endpointBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IssuedTokenClientElement.LocalIssuer%2A>   
+ <xref:System.ServiceModel.Configuration.IssuedTokenParametersEndpointAddressElement>   
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [方法 : ローカル発行者を設定する](../../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md b/docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md
new file mode 100644
index 00000000000..058c6ecac37
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;localServiceSettings&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0658549c-3f65-46dd-8c5c-9895441ed734
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;localServiceSettings&gt; 要素
+このバインディングのローカル サービスのセキュリティ設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<security>  
+   <localServiceSettings detectReplays="Boolean"  
+      inactivityTimeout="TimeSpan"  
+      issuedCookieLifeTime="TimeSpan"  
+      maxCachedCookies="Integer"   
+      maxClockSkew="TimeSpan"   
+      maxPendingSessions="Integer"  
+      maxStatefulNegotiations="Integer"  
+      negotiationTimeout="TimeSpan"  
+      reconnectTransportOnFailure="Boolean"  
+            replayCacheSize="Integer"  
+      replayWindow="TimeSpan"  
+      sessionKeyRenewalInterval="TimeSpan"  
+      sessionKeyRolloverInterval="TimeSpan"  
+      timestampValidityDuration="TimeSpan" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`detectReplays`|チャネルに対するリプレイ攻撃を検出し、自動的に処理するかどうかを指定するブール値です。  既定値は、`false` です。|  
+|`inactivityTimeout`|チャネルがタイムアウトまで待機する非アクティブな期間を指定する、正の <xref:System.TimeSpan>。  既定値は "01:00:00" です。|  
+|`issuedCookieLifeTime`|すべての新しいセキュリティ クッキーに発行される有効期間を指定する <xref:System.TimeSpan>。  有効期間を超えるクッキーは、再利用され、再度ネゴシエートされる必要があります。  既定値は、"10:00:00" です。|  
+|`maxCachedCookies`|キャッシュできるクッキーの最大数を指定する正の整数。  既定値は 1000 です。|  
+|`maxClockSkew`|通信している双方の 2 つのシステム クロックのずれの最長時間を指定する <xref:System.TimeSpan>。  既定値は、"00:05:00" です。<br /><br /> この値が既定値に設定されている場合、受信側はメッセージが受信された時間より前後最大 5 分間の送信時間タイム スタンプを持つメッセージを受け入れます。  送信時間テストにパスしないメッセージは拒否されます。  この設定は、`replayWindow` 属性と組み合わせて使用します。|  
+|`maxPendingSessions`|サービスがサポートする保留状態のセキュリティ セッションの最大数を指定する正の整数。  この制限に達すると、すべての新しいクライアントが SOAP エラーを受け取ります。  既定値は 1000 です。|  
+|`maxStatefulNegotiations`|同時にアクティブにできるセキュリティ ネゴシエーションの数を指定する正の整数。  制限を超えるネゴシエーション セッションはキューに置かれ、制限内に空きができた場合にのみ完了できます。  既定値は 1024 です。|  
+|`negotiationTimeout`|チャネルによって使用されるセキュリティ ポリシーの有効期間を指定する <xref:System.TimeSpan>。  有効期間が切れると、チャネルは新しいセキュリティ ポリシーについてクライアントと再度ネゴシエートします。  既定値は、"00:02:00" です。|  
+|`reconnectTransportOnFailure`|WS\-ReliableMessaging を使用した接続が、トランスポート エラーの後再接続を試みるかどうかを指定するブール値です。  既定値は `true` です。これは、再接続の試行が無限に行われることを意味します。  循環は非アクティブ タイムアウトにより破棄され、再接続できない場合はチャネルが例外をスローします。|  
+|`replayCacheSize`|リプレイ検証で使用される、キャッシュ済みの nonce 数を指定する正の整数。  この制限を越えると、最も古い nonce が削除され、新しいメッセージ用に新しい nonce が作成されます。  既定値は 500000 です。|  
+|`replayWindow`|個別のメッセージ nonce の有効期間を指定する <xref:System.TimeSpan>。<br /><br /> この期間が過ぎると、以前に送信されたメッセージと同じ nonce を持つメッセージは受け入れられません。  この属性は、リプレイ攻撃を防ぐために `maxClockSkew` 属性と組み合わせて使用します。  攻撃者は、メッセージのリプレイ ウィンドウの期限が切れた後にメッセージをリプレイする可能性があります。  ただし、このメッセージは `maxClockSkew` テストに失敗します。このテストは、メッセージが受信された時間の前後指定時間以内の送信時間タイムスタンプを持つメッセージを拒否します。|  
+|`sessionKeyRenewalInterval`|イニシエーターがセキュリティ セッションのキーを更新するまでの期間を指定する <xref:System.TimeSpan>。  既定値は "10:00:00" です。|  
+|`sessionKeyRolloverInterval`|キーの更新中に、前のセッション キーが受信メッセージで有効な時間間隔を指定する <xref:System.TimeSpan> です。  既定値は "00:05:00" です。<br /><br /> キーの更新中、クライアントおよびサーバーは、常に、利用可能な最新のキーを使用してメッセージを送信する必要があります。  どちらのパーティも、ロールオーバー時間に達するまで、前のセッション キーで保護された受信メッセージを受け入れます。|  
+|`timestampValidityDuration`|タイムスタンプの有効期間を指定する正の <xref:System.TimeSpan>。  既定値は "00:15:00" です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)|カスタム バインディングのセキュリティ オプションを指定します。|  
+|[\<secureConversationBootstrap\>](../../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)|セキュリティで保護されたメッセージ交換サービスの開始に使用される既定値を指定します。|  
+  
+## 解説  
+ この設定は、サービスのセキュリティ ポリシーの一部として公開されず、クライアントのバインディングには影響を与えないため、ローカルです。  
+  
+ `localServiceSecuritySettings` 要素の以下の属性は、サービス拒否 \(DOS\) セキュリティ攻撃を軽減するために役立ちます。  
+  
+-   `maxCachedCookies`: SPNEGO または SSL の各ネゴシエーションの実行後にサーバーによってキャッシュされる、期限付きの SecurityContextTokens の最大数を制御します。  
+  
+-   `issuedCookieLifetime`: SPNEGO または SSL の各ネゴシエーションに続いてサーバーが発行する SecurityContextTokens の有効期限を制御します。  サーバーは、この期間だけ SecurityContextTokens をキャッシュします。  
+  
+-   `maxPendingSessions`: サーバーで確立されているが、そのアプリケーション メッセージが処理されていない、セキュリティで保護されたメッセージ交換の最大数を制御します。  このクォータは、クライアントが、セキュリティで保護されたメッセージ交換をサービスで確立しないようにします。それによって、サービスはクライアントごとの状態を保持できますが、それらの状態を使用することはありません。  
+  
+-   `inactivityTimeout`: サービスが、セキュリティで保護されたメッセージ交換を、それに対するアプリケーション メッセージを受信しなくても維持する最長時間を制御します。  このクォータは、クライアントが、セキュリティで保護されたメッセージ交換をサービスで確立しないようにします。それによって、サービスはクライアントごとの状態を保持できますが、それらの状態を使用することはありません。  
+  
+ セキュリティで保護されたメッセージ交換セッションでは、バインディングの `inactivityTimeout` 属性および `receiveTimeout` 属性の両方が、セッション タイムアウトに影響します。  2 つのうち短い方が、タイムアウトが発生する時間を決定します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.LocalServiceSecuritySettingsElement>   
+ <xref:System.ServiceModel.Configuration.SecurityElementBase.LocalServiceSettings%2A>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalServiceSettings%2A>   
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/media/orcasconfigschema.gif b/docs/framework/configure-apps/file-schema/wcf/media/orcasconfigschema.gif
new file mode 100644
index 00000000000..beba37ea24d
Binary files /dev/null and b/docs/framework/configure-apps/file-schema/wcf/media/orcasconfigschema.gif differ
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-element-of-nettcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-element-of-nettcpbinding.md
new file mode 100644
index 00000000000..2c8cc2eafcb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-element-of-nettcpbinding.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;netTcpBinding&gt; の &lt;message&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d71edd9-c085-4c2e-b6d3-980c313366f9
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# &lt;netTcpBinding&gt; の &lt;message&gt; 要素
+[\<netTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)を使用して構成されたエンドポイントの、メッセージ レベルのセキュリティ要件の種類を定義します。  
+  
+## 構文  
+  
+```  
+  
+<message   
+      algorithmSuite=System.Servicemodel.Security.SecurityAlgorithmsuite  
+    clientCredentialType="None/Windows/UserName/Certificate/IssuedToken"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`algorithmSuite`|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 指定できる値を次の表に示します。  既定値は `Basic256` です。<br /><br /> サービス バインディングで指定されている `algorithmSuite` 値が既定値と異なると、Svcutil.exe を使用して構成ファイルを生成したときにファイルが正しく生成されません。この場合は、構成ファイルを手動で編集して、この属性を適切な値に設定する必要があります。|  
+|`clientCredentialType`|メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  指定できる値を次の表に示します。  既定値は `UserName` です。  この属性は <xref:System.ServiceModel.MessageCredentialType> 型です。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Aes128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Aes192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Aes256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|サービスが匿名クライアントと対話できるようになります。  サービス側では、サービスがクライアントの資格情報を必要としないことを示しています。  クライアント側では、クライアントがクライアントの資格情報を提示しないことを示しています。|  
+|Windows|SOAP 交換を、Windows 資格情報の認証されたコンテキストで行うことが可能になります。|  
+|UserName|サービスが、UserName 資格情報を使用したクライアントの認証を要求できるようにします。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では UserName 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  この資格情報モードは、`negotiateServiceCredential` 属性に基づいて、同時実行可能な交換か、同時実行できないネゴシエーションのいずれかになります。|  
+|証明書|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。  メッセージ セキュリティ モードが使用され、`negotiateServiceCredential` 属性が `false` に設定されている場合、クライアントにサービス証明書を準備する必要があります。|  
+|IssuedToken|通常はセキュリティ トークン サービス \(STS\) により発行されるカスタム トークンを指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)|<xref:System.ServiceModel.Configuration.NetTcpBindingElement>のセキュリティ機能を定義します。|  
+  
+## 解説  
+ メッセージは、SOAP メッセージの整合性と機密性を確保し、通信ピアの相互認証を行うために、メッセージ レベルのセキュリティを使用します。  バインディング上でこのセキュリティ モードが選択された場合、チャネル スタックは、メッセージ セキュリティ バインディング要素を使用して構成され、SOAP メッセージは WS\-Security\* 標準に従って保護されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.MessageSecurityOverTcp>   
+ <xref:System.ServiceModel.Configuration.NetTcpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.NetTcpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.NetTcpSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md
new file mode 100644
index 00000000000..19a5ae2bc17
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md
@@ -0,0 +1,141 @@
+---
+title: "&lt;ws2007FederationHttpBinding&gt; の &lt;message&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52cd941d-e230-4c82-8b29-333a7d20eca8
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;ws2007FederationHttpBinding&gt; の &lt;message&gt; 要素
+[\<ws2007FederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md) 要素のメッセージ レベル セキュリティの設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<ws2007FederationBinding>  
+   <binding >  
+      <security>  
+         <message   
+            algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            issuedTokenType="string"   
+            issuedKeyType="SymmetricKey/PublicKey"  
+            negotiateServiceCredential="Boolean" >  
+            <claimTypeRequirements>  
+               <add claimType="URI"  
+                    isOptional="Boolean" />  
+            </claimTypeRequirements>  
+            <issuer address="Uri" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+               </headers>  
+               <identity>  
+                  <certificate encodedValue="String"/>  
+                  <certificateReference findValue="String"   
+                     isChainIncluded="Boolean"  
+                     storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                     storeLocation="LocalMachine/CurrentUser"  
+                     x509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                  <dns value="String"/>  
+                  <rsa value="String"/>  
+                  <servicePrincipalName value="String"/>  
+                  <usePrincipalName value="String"/>  
+               </identity>  
+            </issuer>  
+            <issuerMetadata address=String" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+               </headers>  
+               <identity>  
+                  <certificate encodedValue="String"/>  
+                  <certificateReference findValue="String"   
+                     isChainIncluded="Boolean"  
+                     storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                     storeLocation="LocalMachine/CurrentUser"  
+                     X509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                  <dns value="String"/>  
+                  <rsa value="String"/>  
+                  <servicePrincipalName value="String"/>  
+                  <usePrincipalName value="String"/>  
+               </identity>  
+            </issuerMetadata>  
+            <tokenRequestParameters>  
+               <xmlElement>  
+               </xmlElement>  
+            </tokenRequestParameters>  
+         </message>  
+      </security>  
+   </binding>  
+</ws2007FederationBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`algorithmSuite`|省略可能です。  メッセージの暗号化、署名、およびキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> それぞれの値については次の表を参照してください。  既定値は Basic256 です。|  
+|`issuedKeyType`|発行されるキーの種類を指定します。  以下の値が有効です。<br /><br /> -   SymmetricKey<br />-   PublicKey<br />-   BearerKey<br /><br /> 既定値は SymmetricKey です。  この属性は <xref:System.IdentityModel.Tokens.SecurityKeyType> 型です。|  
+|`issuedTokenType`|発行されるトークンの型を指定する URI。  既定値は、`null` です。|  
+|`negotiateServiceCredential`|サービス資格情報がネゴシエーションの一部として交換されるか、帯域外で使用できるかを指定する値。  既定値は `true` で、サービス資格情報がネゴシエートされます。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Aes128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Aes192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Aes256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md)|このバインディングのクレームの種類のコレクションを指定します。  各要素は <xref:System.ServiceModel.Configuration.ClaimTypeElement> 型です。|  
+|[\<issuer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuer.md)|セキュリティ トークンを発行するエンドポイントを指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenParametersEndpointAddressElement> 型です。|  
+|[\<issuerMetadata\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuermetadata.md)|発行者のエンドポイント アドレスを指定します。|  
+|[\<tokenRequestParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md)|トークン要求パラメーターのコレクション。  各パラメーターは、XML 要素です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md)|バインディングのセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.WSFederationHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md
new file mode 100644
index 00000000000..aeb8c83a874
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md
@@ -0,0 +1,141 @@
+---
+title: "&lt;wsFederationHttpBinding&gt; の &lt;message&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d710389-d9d8-4454-9bf2-da4ccda31cec
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# &lt;wsFederationHttpBinding&gt; の &lt;message&gt; 要素
+[\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) のメッセージ レベル セキュリティの設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<wsFederationBinding>  
+     <binding >  
+         <security>  
+         <message   
+            algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            issuedTokenType="string"   
+            issuedKeyType="SymmetricKey/PublicKey"  
+            negotiateServiceCredential="Boolean" >  
+            <claimTypeRequirements>  
+               <add claimType="URI"  
+                    isOptional="Boolean" />  
+            </claimTypeRequirements>  
+                        <issuer address="Uri" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+                          </headers>  
+                              <identity>  
+                              <certificate encodedValue="String"/>  
+                                <certificateReference findValue="String"   
+                                 isChainIncluded="Boolean"  
+                            storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                                  storeLocation="LocalMachine/CurrentUser"  
+                     x509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                                   <dns value="String"/>  
+                                <rsa value="String"/>  
+                                <servicePrincipalName value="String"/>  
+                                <usePrincipalName value="String"/>  
+                              </identity>  
+                        </issuer>  
+                        <issuerMetadata address=String" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+               </headers>  
+               <identity>  
+                  <certificate encodedValue="String"/>  
+                  <certificateReference findValue="String"   
+                     isChainIncluded="Boolean"  
+                     storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                     storeLocation="LocalMachine/CurrentUser"  
+                     X509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                  <dns value="String"/>  
+                  <rsa value="String"/>  
+                  <servicePrincipalName value="String"/>  
+                  <usePrincipalName value="String"/>  
+               </identity>  
+                        </issuerMetadata>  
+            <tokenRequestParameters>  
+               <xmlElement>  
+               </xmlElement>  
+            </tokenRequestParameters>  
+         </message>  
+      </security>  
+   </binding>  
+</wsFederationBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  この属性の有効な値については、「algorithmSuite 属性」の表を参照してください。  既定値は `Basic256` です。<br /><br /> この属性は <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。|  
+|issuedKeyType|発行されるキーの種類を指定します。  以下の値が有効です。<br /><br /> -   SymmetricKey<br />-   PublicKey<br /><br /> 既定値は、`SymmetricKey` です。  この属性は <xref:System.IdentityModel.Tokens.SecurityKeyType> 型です。|  
+|issuedTokenType|発行されるトークンの型を指定する URI を含む文字列。  既定値は、`null` です。|  
+|negotiateServiceCredential|サービス資格情報がネゴシエーションの一部として交換されるか、帯域外で使用できるかを指定するブール値。  既定値は `true` で、サービス資格情報がネゴシエートされます。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Basic128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Basic192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Basic256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Basic192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Basic128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Basic128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Basic192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Basic128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-element.md)|このバインディングのクレームの種類のコレクションを指定します。  各要素は <xref:System.ServiceModel.Configuration.ClaimTypeElement> 型です。|  
+|issuer|セキュリティ トークンを発行するエンドポイントを指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenParametersEndpointAddressElement> 型です。|  
+|issuerMetadata|発行者のエンドポイント アドレスを指定します。|  
+|[\<tokenRequestParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md)|トークン要求パラメーターのコレクション。  各パラメーターは、XML 要素です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md)|バインディングのセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.WSFederationHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-encoding.md b/docs/framework/configure-apps/file-schema/wcf/message-encoding.md
new file mode 100644
index 00000000000..d38b13fb704
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-encoding.md
@@ -0,0 +1,38 @@
+---
+title: "メッセージ エンコーディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: f30ee941-aca9-4c67-82a5-421568496f07
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# メッセージ エンコーディング
+エンコーディングは、Unicode 文字のセットをバイト シーケンスに変換するプロセスです。  デコードは、その逆のプロセスです。  WCF \(Windows Communication Foundation\) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM \(Message Transmission Optimization Mechanism\) の 3 種類があります。  
+  
+ `binaryMessageEncoding` 構成セクションでは、バイナリ ベースの XML メッセージに使用される文字エンコーディングおよびメッセージ バージョン管理が指定されます。  バイナリ メッセージ エンコーダーは、ネットワーク上で Windows Communication Foundation \(WCF\) メッセージをバイナリにエンコードします。  このエンコーディングによりメッセージ転送は非常に高速になりますが、WS\-\* 標準に基づいた相互運用性は失われます。  
+  
+ `mtomMessageEncoding` 構成セクションでは、Message Transmission Optimization Mechanism \(MTOM\) エンコーディングを使用したメッセージの文字エンコーディングおよびメッセージ バージョン管理が指定されます。  \(MTOM\) は、Windows Communication Foundation \(WCF\) メッセージでバイナリ データを送信する効率的な技術です。  MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。  MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックはテキストに変換せずにそのまま転送することによって最適化します。  
+  
+ `textMessageEncoding` 構成セクションは、ネットワーク上でテキストベースのメッセージの作成に使用されるテキスト エンコーダーを指定します。  このエンコーダーにより生成されるメッセージは、WS\-\* ベースの相互運用に適しています。  Web サービスまたは Web サービス クライアントは、一般に、テキスト形式の XML を認識できます。  ただし、バイナリ データの大きいブロックをテキストとして送信することは、XML メッセージをエンコードする最も効率の悪い方法です。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-basichttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-basichttpbinding.md
new file mode 100644
index 00000000000..6f2ef7f782f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-basichttpbinding.md
@@ -0,0 +1,138 @@
+---
+title: "&lt;basicHttpBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51cdd329-6461-471a-8747-56c2299b61e5
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# &lt;basicHttpBinding&gt; の &lt;message&gt;
+[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のメッセージ レベル セキュリティの設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<message   
+   algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+      clientCredentialType="UserName/Certificate"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  この属性は、アルゴリズムとキー サイズを指定する <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 既定値は `Basic256` です。|  
+|clientCredentialType|メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  既定値は、`UserName` です。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|UserName|-   UserName 資格情報を使用してクライアントをサーバーに認証するように要求します。  この資格情報は、[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)を使用して指定する必要があります。<br />-   [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では UserName 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  `basicHttpBinding` の場合は、SSL チャネルの設定が必要です。|  
+|証明書|証明書を使用してクライアントをサーバーに認証するように要求します。  この場合のクライアント資格情報は、[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)および [\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md)を使用して指定する必要があります。  さらに、メッセージのセキュリティ モードを使用する場合は、クライアントにサービス証明書を準備する必要があります。  この場合のサービス資格情報は、<xref:System.ServiceModel.Description.ClientCredentials> クラスまたは `ClientCredentials` 動作要素を使用し、[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)を使用してサービス証明書を指定して、指定する必要があります。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のセキュリティ機能を定義します。|  
+  
+## 使用例  
+ このサンプルでは、basicHttpBinding とメッセージ セキュリティを使用するアプリケーションを実装する方法を示します。  サービスの次の構成例では、エンドポイント定義によって basicHttpBinding が指定され、`Binding1` という名前のバインディング構成が参照されます。  サービスがクライアントに対してサービス自体を認証するために使用する証明書は、`serviceCredentials` 要素の下にある構成ファイルの `behaviors` セクションで設定されます。  クライアントがサービスに対してクライアント自体を認証するために使用する証明書に適用される検証モードも、`clientCertificate` 要素の下にある `behaviors` セクションで設定されます。  
+  
+ 同じバインディングとセキュリティの詳細が、クライアントの構成ファイルで指定されます。  
+  
+```  
+<system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- this endpoint is exposed at the base address provided by host: http://localhost:8000/ServiceModelSamples/service  -->  
+        <endpoint address=""  
+                  binding="basicHttpBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is exposed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <basicHttpBinding>  
+        <!--   
+        This configuration defines the SecurityMode as Message and   
+        the clientCredentialType as Certificate.  
+        -->  
+        <binding name="Binding1" >  
+          <security mode = "Message">  
+            <message clientCredentialType="Certificate"/>  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--  
+        The serviceCredentials behavior allows one to define a service certificate.  
+        A service certificate is used by a client to authenticate the service and provide message protection.  
+        This configuration references the "localhost" certificate installed during the setup instructions.  
+        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+            <clientCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </clientCertificate>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.BasicHttpMessageSecurity>   
+ <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.BasicHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.BasicHttpMessageSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-nethttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-nethttpbinding.md
new file mode 100644
index 00000000000..d7e14c5eab8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-nethttpbinding.md
@@ -0,0 +1,138 @@
+---
+title: "&lt;netHttpBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9def5a35-475d-40d6-b716-ccdbd93863c7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;netHttpBinding&gt; の &lt;message&gt;
+[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のメッセージ レベル セキュリティの設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<message   
+   algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+      clientCredentialType="UserName/Certificate"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  この属性は、アルゴリズムとキー サイズを指定する <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 既定値は `Basic256` です。|  
+|clientCredentialType|メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  既定値は、`UserName` です。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|UserName|-   UserName 資格情報を使用してクライアントをサーバーに認証するように要求します。  この資格情報は、\<`clientCredentials`\> 要素を使用して指定する必要があります。<br />-   [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では UserName 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  `basicHttpBinding` の場合は、SSL チャネルの設定が必要です。|  
+|証明書|証明書を使用してクライアントをサーバーに認証するように要求します。  この場合のクライアント資格情報は、\<`clientCredentials`\> および \<`clientCertificate`\> を使用して指定する必要があります。  さらに、メッセージのセキュリティ モードを使用する場合は、クライアントにサービス証明書を準備する必要があります。  この場合のサービス資格情報は、<xref:System.ServiceModel.Description.ClientCredentials> クラスまたは `ClientCredentials` 動作要素を使用し、serviceCredentials の \<serviceCertificate\> 要素を使用してサービス証明書を指定して、指定する必要があります。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<`security`\> 要素 \(\<`netHttpBinding`\>\)|\<`netHttpBinding`\> 要素のセキュリティ機能を定義します。|  
+  
+## 使用例  
+ このサンプルでは、basicHttpBinding とメッセージ セキュリティを使用するアプリケーションを実装する方法を示します。  サービスの次の構成例では、エンドポイント定義によって basicHttpBinding が指定され、`Binding1` という名前のバインディング構成が参照されます。  サービスがクライアントに対してサービス自体を認証するために使用する証明書は、`serviceCredentials` 要素の下にある構成ファイルの `behaviors` セクションで設定されます。  クライアントがサービスに対してクライアント自体を認証するために使用する証明書に適用される検証モードも、`clientCertificate` 要素の下にある `behaviors` セクションで設定されます。  
+  
+ 同じバインディングとセキュリティの詳細が、クライアントの構成ファイルで指定されます。  
+  
+```  
+<system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- this endpoint is exposed at the base address provided by host: http://localhost:8000/ServiceModelSamples/service  -->  
+        <endpoint address=""  
+                  binding="basicHttpBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is exposed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <basicHttpBinding>  
+        <!--   
+        This configuration defines the SecurityMode as Message and   
+        the clientCredentialType as Certificate.  
+        -->  
+        <binding name="Binding1" >  
+          <security mode = "Message">  
+            <message clientCredentialType="Certificate"/>  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--  
+        The serviceCredentials behavior allows one to define a service certificate.  
+        A service certificate is used by a client to authenticate the service and provide message protection.  
+        This configuration references the "localhost" certificate installed during the setup instructions.  
+        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+            <clientCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </clientCertificate>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetHttpMessageSecurity>   
+ <xref:System.ServiceModel.Configuration.NetHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.NetHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.NetHttpMessageSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-netmsmqbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-netmsmqbinding.md
new file mode 100644
index 00000000000..911a1ca96a9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-netmsmqbinding.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;netMsmqBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ebf0240-d7be-4493-b0fe-f00fd5989d77
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;netMsmqBinding&gt; の &lt;message&gt;
+この `netMsmqBinding` バインディングでの SOAP メッセージ セキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<netMsmqBinding>  
+    <binding>  
+      <security>  
+         <message   
+                      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            clientCredentialType="None/Windows/UserName/Certificate/CardSpace" />  
+    </security>  
+</netMsmqBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|MSMQ トランスポートを介して送信されるメッセージにメッセージ ベースのセキュリティを実現するために使用されるメッセージの暗号化およびキー ラップ アルゴリズムを設定します。<br /><br /> 既定値は `Aes256` です。  この属性は <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。|  
+|clientCredentialType|MSMQ トランスポートで送信されるメッセージに対してクライアント認証を実行するときに使用される資格情報の種類を指定します。  以下の値が有効です。<br /><br /> -   None: サービスが匿名クライアントと対話できるようになります。  サービスとクライアントはいずれも資格情報を要求しません。<br />-   Windows : Windows 資格情報の認証済みコンテキストの制御下での SOAP 交換を可能にします。  これは、常に Kerberos ベースの認証を実行します。<br />-   UserName: UserName 資格情報を使用してクライアントを認証するよう、サービスが要求できるようにします。  この場合の資格情報は、`clientCredentials` 動作を使用して指定する必要があります。 **Caution:**  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  したがって、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、UserName 資格情報を使用する場合に交換が強制的に保護されるようにします。  このモードは、サービス証明書が、`clientCredential` 動作および `serviceCertificate` を使用してクライアント側で指定されることを要求します。 <br /><br /> -   Certificate: 証明書を使用してクライアントを認証するようサービスが要求できるようにします。  この場合のクライアント資格情報は、`clientCredentials` 動作を使用して指定する必要があります。  この場合のサービス資格情報は、`serviceCertificate` を指定して `clientCredentials` 動作を使用することで、指定する必要があります。<br />-   CardSpace: サービスは、CardSpace を使用してクライアントを認証するよう要求します。  `serviceCertiifcate` は、`clientCredential` 動作で提供される必要があります。<br /><br /> 既定値は `Windows` です。  この属性は <xref:System.ServiceModel.MessageCredentialType> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md)|バインディングのセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MessageSecurityOverMsmqElement>   
+ <xref:System.ServiceModel.Configuration.NetMsmqSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.NetMsmqSecurity.Message%2A>   
+ <xref:System.ServiceModel.MessageSecurityOverMsmq>   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-ws2007httpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-ws2007httpbinding.md
new file mode 100644
index 00000000000..a3de7b115f8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-ws2007httpbinding.md
@@ -0,0 +1,104 @@
+---
+title: "&lt;ws2007HttpBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ffd8db6-84a8-4b38-a9fe-2cb1a87a1c97
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;ws2007HttpBinding&gt; の &lt;message&gt;
+[\<ws2007HttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md) 要素のメッセージ レベルのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<ws2007HttpBinding>  
+ <binding >  
+  <security>  
+   <message clientCredentialType =  
+    "None/Windows/UserName/Certificate/IssuedToken"  
+    establishSecurityContext="Boolean"  
+    negotiateServiceCredential="Boolean"  
+    algorithmSuite= Enumeration. See algorithmSuite Attribute below.  
+    defaultProtectionLevel="None/Sign/EncryptionAndSign" />  
+  </security>  
+ </binding>  
+</ws2007HttpBinding>  
+```  
+  
+## 型  
+ <xref:System.ServiceModel.NonDualMessageSecurityOverHttp>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`algorithmSuite`|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 既定値は Basic256 です。|  
+|`clientCredentialType`|省略可能です。  セキュリティ モード `Message` または `TransportWithMessageCredentials` を使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  次の表の列挙値を参照してください。  既定は Windows です。<br /><br /> この属性は <xref:System.ServiceModel.MessageCredentialType> 型です。|  
+|`establishSecurityContext`|セキュリティで保護されたセッションをセキュリティ チャネルが確立するかどうかを示す値。  セキュリティで保護されたセッションは、セキュリティ コンテキスト トークン \(SCT\) を確立してからアプリケーション メッセージを交換します。  SCT が確立されると、セキュリティ チャネルは上位のチャネルに <xref:System.ServiceModel.Channels.ISession> インターフェイスを提供します。  セキュリティで保護されたセッションの使用方法の詳細については、「[方法 : セキュリティで保護されたセッションを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-secure-session.md)」を参照してください。<br /><br /> 既定値は `true` です。|  
+|`negotiateServiceCredential`|省略可能です。  サービス資格情報がクライアントの帯域外で提供されるか、ネゴシエーションのプロセスによってサービスからクライアントに取得されるかを指定する値。  そのようなネゴシエーションは、通常のメッセージ交換の準備です。<br /><br /> `clientCredentialType` 属性が None、Username、または Certificate の場合、この属性を `false` に設定すると、クライアントの帯域外でサービス証明書が使用可能になり、クライアントは [\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)のサービス動作でサービス証明書 \([\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) を使用\) を指定する必要があります。  このモードは、WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時に使用できます。<br /><br /> `ClientCredentialType` 属性が `Windows` に設定されている場合、この属性を `false` に設定すると Kerberos ベースの認証が指定されます。  これは、クライアントおよびサービスが同じ Kerberos ドメインの一部でなければならないことを意味します。  このモードは、Kerberos トークン プロファイル \(OASIS WSS TC で定義\) に加えて WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時使用できます。<br /><br /> この属性が `true` の場合、SOAP メッセージを介して <xref:System.ServiceModel.Security.Tokens.ServiceModelSecurityTokenTypes.Spnego%2A> 交換をトンネル化する .NET SOAP ネゴシエーションが行われます。<br /><br /> 既定値は、`true` です。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Aes128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Aes192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Aes256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|サービスが匿名クライアントと対話できるようになります。  サービス側では、サービスがクライアントの資格情報を必要としないことを示しています。  クライアント側では、クライアントがクライアントの資格情報を提示しないことを示しています。|  
+|`Certificate`|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。  `message` セキュリティ モードが使用されており、`negotiateServiceCredential` 属性が `false` に設定されている場合、クライアントをサービス証明書で準備する必要があります。|  
+|`IssuedToken`|通常はセキュリティ トークン サービス \(STS\) により発行されるカスタム トークンを指定します。|  
+|`UserName`|`UserName` 資格情報を使用したクライアントの認証を、サービスで要求することが可能になります。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では `UserName` 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  この資格情報モードは、`negotiateServiceCredential` 属性に基づいて、同時実行可能な交換か、同時実行できないネゴシエーションのいずれかになります。|  
+|`Windows`|SOAP 交換を、`Windows` 資格情報の認証されたコンテキストで行うことが可能になります。  `negotiateServiceCredential` 属性が `true` に設定されている場合、SSPI ネゴシエーションと Kerberos \(同時使用可能な標準\) のいずれかが実行されます。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-ws2007httpbinding.md)|[\<ws2007HttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md)のセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.NonDualMessageSecurityOverHttp>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.WSHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.NonDualMessageSecurityOverHttpElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-wsdualhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-wsdualhttpbinding.md
new file mode 100644
index 00000000000..7369d9f97b6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-wsdualhttpbinding.md
@@ -0,0 +1,96 @@
+---
+title: "&lt;wsDualHttpBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75101744-eed8-4d61-91f4-5fc4473a21f2
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;wsDualHttpBinding&gt; の &lt;message&gt;
+[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のメッセージ レベルのセキュリティを定義します。  
+  
+## 構文  
+  
+```  
+  
+<message   
+      clientCredentialType="None/Windows/UserName/Certificate/CardSpace"  
+     negotiateServiceCredential="Boolean"  
+   algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"/>  
+</message>  
+```  
+  
+## 型  
+ <xref:System.ServiceModel.MessageSecurityOverHttp>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|省略可能です。  メッセージの暗号化とキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 有効値については、以下を参照してください。  既定値は `Basic256` です。|  
+|clientCredentialType|省略可能です。  セキュリティ モード `Message` を使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  有効値については、以下を参照してください。  既定値は、`Windows` です。<br /><br /> この属性は <xref:System.ServiceModel.MessageCredentialType> 型です。|  
+|negotiateServiceCredential|省略可能です。  サービス資格情報がクライアントの帯域外で提供されるか、ネゴシエーションのプロセスによってサービスからクライアントに取得されるかを指定するブール値。  そのようなネゴシエーションは、通常のメッセージ交換の準備です。<br /><br /> `clientCredentialType` 属性が None、Username、または Certificate の場合、この属性を `false` に設定すると、クライアントの帯域外でサービス証明書が使用可能になり、クライアントは [\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)のサービス動作でサービス証明書 \([\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) を使用\) を指定する必要があります。  このモードは、WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時使用できます。<br /><br /> `ClientCredentialType` 属性が `Windows` に設定されている場合、この属性を `false` に設定すると Kerberos ベースの認証が指定されます。  これは、クライアントおよびサービスが同じ Kerberos ドメインの一部でなければならないことを意味します。  このモードは、Kerberos トークン プロファイル \(OASIS WSS TC で定義\) に加えて WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時使用できます。  この属性が `true` の場合、SOAP メッセージを介して SPNego 交換をトンネル化する .NET SOAP ネゴシエーションが行われます。<br /><br /> 既定値は、`true` です。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Aes128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Aes192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Aes256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|サービスが匿名クライアントと対話できるようになります。  サービス側では、サービスがクライアントの資格情報を必要としないことを示しています。  クライアント側では、クライアントがクライアントの資格情報を提示しないことを示しています。|  
+|Windows|SOAP 交換を、Windows 資格情報の認証されたコンテキストで行うことが可能になります。  `negotiateServiceCredential` 属性が `true` に設定されている場合、SSPI ネゴシエーションと Kerberos \(同時使用可能な標準\) のいずれかが実行されます。|  
+|UserName|サービスが、UserName 資格情報を使用したクライアントの認証を要求できるようにします。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では UserName 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  この資格情報モードは、`negotiateServiceCredential` 属性に基づいて、同時実行可能な交換か、同時実行できないネゴシエーションのいずれかになります。|  
+|証明書|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。  メッセージのセキュリティ モードが使用されており、`negotiateServiceCredential` 属性が `false` に設定されている場合、クライアントをサービス証明書で準備する必要があります。|  
+|IssuedToken|カスタム トークン \(通常はセキュリティ トークン サービスにより発行される\) を指定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsdualhttpbinding.md)|[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のセキュリティ機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WSDualHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.WSDualHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.MessageSecurityOverTcpElement>   
+ <xref:System.ServiceModel.MessageSecurityOverHttp>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md
new file mode 100644
index 00000000000..6014c36c5d5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;wsHttpBinding&gt; の &lt;message&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 621abbde-590b-454d-90ac-68dc3c69c720
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# &lt;wsHttpBinding&gt; の &lt;message&gt;
+[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)のメッセージ レベル セキュリティの設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<message   
+   algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+   clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+   establishSecurityContext="Boolean"  
+   negotiateServiceCredential="Boolean" />  
+```  
+  
+## 型  
+ <xref:System.ServiceModel.NonDualMessageSecurityOverHttp>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|algorithmSuite|メッセージの暗号化とキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 既定値は `Basic256` です。|  
+|clientCredentialType|省略可能です。  セキュリティ モード `Message` または `TransportWithMessageCredentials` を使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  次の列挙値を参照してください。  既定値は、`Windows` です。<br /><br /> この属性は <xref:System.ServiceModel.MessageCredentialType> 型です。|  
+|establishSecurityContext|セキュリティで保護されたセッションをセキュリティ チャネルが確立するかどうかを示すブール値。  キュリティで保護されたセッションは、セキュリティ コンテキスト トークン \(SCT\) を確立してからアプリケーション メッセージを交換します。  SCT が確立されると、セキュリティ チャネルは上位のチャネルに <xref:System.ServiceModel.Channels.ISession> インターフェイスを提供します。  セキュリティで保護されたセッションの使用方法の詳細については、「[方法 : セキュリティで保護されたセッションを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-secure-session.md)」を参照してください。<br /><br /> 既定値は `true` です。|  
+|negotiateServiceCredential|省略可能です。  サービス資格情報がクライアントの帯域外で提供されるか、ネゴシエーションのプロセスによってサービスからクライアントに取得されるかを指定するブール値。  そのようなネゴシエーションは、通常のメッセージ交換の準備です。<br /><br /> `clientCredentialType` 属性が None、Username、または Certificate の場合、この属性を `false` に設定すると、クライアントの帯域外でサービス証明書が使用可能になり、クライアントは [\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)のサービス動作でサービス証明書 \([\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) を使用\) を指定する必要があります。  このモードは、WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時使用できます。<br /><br /> `ClientCredentialType` 属性が `Windows` に設定されている場合、この属性を `false` に設定すると Kerberos ベースの認証が指定されます。  これは、クライアントおよびサービスが同じ Kerberos ドメインの一部でなければならないことを意味します。  このモードは、Kerberos トークン プロファイル \(OASIS WSS TC で定義\) に加えて WS\-Trust および WS\-SecureConversation が実装された SOAP スタックと同時使用できます。<br /><br /> この属性が `true` の場合、SOAP メッセージを介して SPNego 交換をトンネル化する .NET SOAP ネゴシエーションが行われます。<br /><br /> 既定値は、`true` です。|  
+  
+## algorithmSuite 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Basic128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Basic192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Basic256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Basic192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Basic128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Basic192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Basic128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Basic192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Basic256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|サービスが匿名クライアントと対話できるようになります。  サービス側では、サービスがクライアントの資格情報を必要としないことを示しています。  クライアント側では、クライアントがクライアントの資格情報を提示しないことを示しています。|  
+|証明書|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。  メッセージのセキュリティ モードが使用されており、`negotiateServiceCredential` 属性が `false` に設定されている場合、クライアントをサービス証明書で準備する必要があります。|  
+|IssuedToken|カスタム トークン \(通常はセキュリティ トークン サービスにより発行される\) を指定します。|  
+|UserName|サービスが、UserName 資格情報を使用したクライアントの認証を要求できるようにします。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ セキュリティでのそのようなキーの使用をサポートしません。  そのため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では UserName 資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。  この資格情報モードは、`negotiateServiceCredential` 属性に基づいて、同時実行可能な交換か、同時実行できないネゴシエーションのいずれかになります。|  
+|Windows|SOAP 交換を、Windows 資格情報の認証されたコンテキストで行うことが可能になります。  `negotiateServiceCredential` 属性が `true` に設定されている場合、SSPI ネゴシエーションと Kerberos \(同時使用可能な標準\) のいずれかが実行されます。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)|[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)のセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.NonDualMessageSecurityOverHttp>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement.Message%2A>   
+ <xref:System.ServiceModel.WSHttpSecurity.Message%2A>   
+ <xref:System.ServiceModel.Configuration.NonDualMessageSecurityOverHttpElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/messagelogging.md b/docs/framework/configure-apps/file-schema/wcf/messagelogging.md
new file mode 100644
index 00000000000..bc222bd4f7b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/messagelogging.md
@@ -0,0 +1,132 @@
+---
+title: "&lt;messageLogging&gt;&lt;/messageLogging&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d06a7e6-9633-4a12-8c5d-123adbbc19c5
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# &lt;messageLogging&gt;&lt;/messageLogging&gt;
+この要素は Windows Communication Foundation (WCF) のメッセージ ログ機能の設定を定義します。  
+  
+ \<system.ServiceModel>  
+<>\>  
+<>\>  
+  
+## <a name="syntax"></a>構文  
+  
+```  
+  
+<system.serviceModel>  
+   <diagnostics>  
+       <messageLogging logEntireMessage="Boolean"  
+          logMalformedMessages="Boolean"  
+          logMessagesAtServiceLevel="Boolean"  
+          logMessagesAtTransportLevel="Boolean"  
+                    maxMessagesToLog="Integer"  
+          maxSizeOfMessageToLog="Integer" >  
+          <filters>  
+                            <clear />  
+          </filters>  
+       </messageLogging>  
+   </diagnostics>  
+</system.serviceModel>  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|説明|  
+|---------------|-----------------|  
+|`logEntireMessage`|メッセージ全体 (メッセージ ヘッダーと本文) を記録するかどうかを指定するブール値。 既定は `false` で、メッセージ ヘッダーだけが記録されます。 この設定は、すべてのメッセージ ログ レベル (サービス、トランスポート、および不正) に影響を与えます。|  
+|`logMalformedMessages`|無効なメッセージを記録するかどうかを指定するブール値。 無効なメッセージは、`maxMessagesToLog` にカウントされません。 既定値は、`false` です。|  
+|`logMessagesAtServiceLevel`|(暗号化およびトランスポートに関連する変換の前に) メッセージをサービス レベルでトレースするかどうかを指定するブール値。 既定値は、`false` です。|  
+|`logMessagesAtTransportLevel`|メッセージをトランスポート レベルでトレースするかどうかを指定するブール値。 構成ファイルに指定されたフィルターが適用され、フィルターに一致するメッセージだけがトレースされます。 既定値は、`false` です。|  
+|`maxMessagesToLog`|記録するメッセージの最大数を指定する正の整数。 既定値は 1000 です。|  
+|`maxSizeOfMessageToLog`|記録するメッセージの最大サイズ (バイト単位) を指定する正の整数。 サイズが制限より大きなメッセージは、記録されません。 この設定は、すべてのトレース レベルに影響を与えます。 既定値は 262144 (0x4000) です。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|フィルター|`filters` 要素には、XPath フィルターのコレクションが保持されます。 トランスポート メッセージ ログが有効な場合 (`logMessagesAtTransportLevel` が `true`)、フィルターに一致するメッセージだけが記録されます。<br /><br /> フィルターは、トランスポート層でのみ適用されます。 サービス レベルおよび形式が正しくないメッセージ ログ記録は、フィルターの影響を受けません。<br /><br /> この要素の唯一の属性である `filter` は、XpathFilter です。<br /><br /> `<filters>     <add xmlns:soap="http://www.w3.org/2003/05/soap-envelope">/soap:Envelope</add> </filters>`|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|診断|管理者が行うランタイムの検査と管理の WCF 設定を定義します。|  
+  
+## <a name="remarks"></a>コメント  
+ メッセージは、サービス、トランスポート、および不正の&3; 種類のレベルで記録されます。 各レベルは、個別にアクティブにできます。  
+  
+ XPath フィルターは、トランスポート レベルとサービス レベルで特定のメッセージを記録するために追加できます。 フィルターが定義されていない場合、すべてのメッセージが記録されます。 フィルターは、メッセージのヘッダーにのみ適用されます。 本文は無視されます。 WCF は、パフォーマンスを強化するためにメッセージ本文を無視します。 本文の内容に基づいてフィルターを適用する場合は、そのためのフィルターを備えたカスタム リスナーを作成できます。  
+  
+ メッセージ トレースをアクティブ化するために、トレース リスナーを作成する必要があります。 リスナー自体にで動作するリスナーを指定できます、 <xref:System.Diagnostics>トレース アーキテクチャです。 次の例は、そのようなリスナーの作成方法を示します。  
+  
+```  
+<system.diagnostics>  
+    <sources>  
+          <source name="System.ServiceModel" switchValue="Verbose">  
+              <listeners>  
+                    <clear />  
+                    <add type="System.Diagnostics.DefaultTraceListener" name="Default"  
+                        traceOutputOptions="None" />  
+                    <add name="ServiceModel Listener" traceOutputOptions="None" />  
+               </listeners>  
+        </source>  
+            <source name="System.ServiceModel.MessageLogging">  
+                <listeners>  
+                    <clear />  
+                    <add type="System.Diagnostics.DefaultTraceListener" name="Default"  
+                        traceOutputOptions="None" />  
+                    <add name="MessageLogging Listener" traceOutputOptions="None"/>  
+               </listeners>  
+        </source>  
+    </sources>  
+     <sharedListeners>  
+            <add initializeData="C:\ItProTools\TraceLog.xml"  
+                    type="System.Diagnostics.XmlWriterTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+                    name="ServiceModel Listener"  
+                    traceOutputOptions="LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack" />  
+            <add initializeData="C:\ItProTools\MessageLog.log"  
+                    type="System.Diagnostics.XmlWriterTraceListener, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+                   name="MessageLogging Listener"  
+                   traceOutputOptions="LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack" />  
+    </sharedListeners>  
+</system.diagnostics>  
+```  
+  
+## <a name="example"></a>例  
+  
+```  
+<messageLogging logEntireMessage="true"  
+    logMalformedMessages="true"  
+    logMessagesAtServiceLevel="true"  
+    logMessagesAtTransportLevel="true"  
+    maxMessagesToLog="42"  
+    maxSizeOfMessageToLog="42">  
+     <filters>  
+         <clear />  
+     </filters>  
+ </messageLogging>  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Configuration.DiagnosticSection>   
+ <xref:System.ServiceModel.Diagnostics>   
+ <xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A>   
+ <xref:System.ServiceModel.Configuration.MessageLoggingElement>   
+ [メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication-element.md b/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication-element.md
new file mode 100644
index 00000000000..fd5ed096823
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication-element.md
@@ -0,0 +1,114 @@
+---
+title: "&lt;messageSenderAuthentication&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d979dfc-a6f9-42ec-96d5-7fbc13a48118
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;messageSenderAuthentication&gt; 要素
+ピアツーピア メッセージ送信者の認証オプションを指定します。  
+  
+ ピア ツー ピア プログラミングの詳細については、「[ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<messageSenderAuthentication  
+customCertificateValidatorType= "namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+certificateValidationMode = "ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+revocationMode="NoCheck/Online/Offline"  
+trustedStoreLocation="CurrentUser/LocalMachine"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customCertificateValidatorType|カスタム型の検証に使用される型およびアセンブリです。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。|  
+|certifcateValidationMode|資格情報の検証に使用される 3 つのモードのいずれかを指定します。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。|  
+|revocationMode|証明書失効リスト \(CRL\) のチェックに使用されるモードのいずれかです。|  
+|trustedStoreLocation|2 つのシステム格納場所 \(`LocalMachine` または `CurrentUser`\) のいずれかです。  この値は、サービス証明書がクライアントにネゴシエートされるときに使用されます。  指定された格納場所の **\[信頼されたユーザー\]** ストアに対して検証が実行されます。|  
+  
+## customCertificateValidatorType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|省略可能です。  タイプ名およびアセンブリと、タイプの検索に使用される他のデータを指定します。  少なくとも、名前空間とタイプ名が必要です。  省略可能な情報は、アセンブリ名、バージョン番号、カルチャ、および公開キー トークンです。|  
+  
+## certificateValidationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|省略可能です。  `None`、`PeerTrust`、`ChainTrust`、`PeerOrChainTrust`、`Custom` のいずれかの値にします。  既定値は、`ChainTrust` です。  既定値は、`ChainTrust` です。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## revocationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`NoCheck`、`Online`、`Offline` のいずれかの値にします。  既定値は、`Online` です。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## trustedStoreLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`LocalMachine` または `CurrentUser` のいずれかの値にします。  既定値は、`CurrentUser` です。  クライアント アプリケーションがシステム アカウントで実行されている場合、証明書は通常 `LocalMachine` の下にあります。  クライアント アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 `CurrentUser` の下にあります。  既定値は、`CurrentUser` です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md)|ピア サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ メッセージ認証を選択した場合は、この要素を構成する必要があります。  出力チャネルでは、各メッセージは、[\<certificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/certificate-element.md) が提供する認証を使用して署名されます。  すべてのメッセージは、アプリケーションに配信される前に、この要素の `customCertificateValidatorType` 属性で指定した検証を使用してメッセージ資格情報がチェックされます。  検証は、資格情報を受け入れることも拒否することもできます。  
+  
+## 使用例  
+ 次のコードは、メッセージ送信者検証モードを `PeerOrChainTrust` に設定します。  
+  
+```  
+<behaviors>  
+ <endpointBehaviors>  
+  <behavior name="MyEndpointBehavior">  
+   <clientCredentials>  
+    <peer>  
+      <certificate findValue="www.contoso.com"   
+                   storeLocation="LocalMachine"  
+                   x509FindType="FindByIssuerName" />  
+        <messageSenderAuthentication   
+          certificateValidationMode="PeerOrChainTrust" />  
+       <messageSenderAuthentication certificateValidationMode="None" />  
+    </peer>  
+   </clientCredentials>  
+  </behavior>  
+ </endpointBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>   
+ <xref:System.ServiceModel.Security.PeerCredential.MessageSenderAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.MessageSenderAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateAuthenticationElement>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication.md b/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication.md
new file mode 100644
index 00000000000..34f070ecc07
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;messageSenderAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ea62fc06-55fb-42e0-aa2b-8867bdf4b415
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;messageSenderAuthentication&gt;
+メッセージ送信者により使用されるピア証明書の認証設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<messageSenderAuthentication  
+   customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+   certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+   revocationMode="NoCheck/Online/Offline"  
+   trustedStoreLocation="CurrentUser/LocalMachine"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`certificateValidationMode`|省略可能な列挙体です。  資格情報の検証に使用される 5 つのモードのいずれかを指定します。  この属性は <xref:System.ServiceModel.Security.X509CertificateValidationMode> 型です。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。|  
+|`customCertificateValidatorType`|省略可能な文字列。  ユーザー設定タイプの検証に使用されるタイプおよびアセンブリを指定します。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。  この属性は <xref:System.IdentityModel.Selectors.X509CertificateValidator> 型です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] には、信頼されたユーザーのストアに対してピア証明書を検証する既定のピア証明書検証が用意されており、  証明書が有効なルートまでつながっていることを検証します。  カスタム検証を実装して別の動作を指定したり、この属性を使用してカスタム検証を指定することができます。|  
+|`revocationMode`|省略可能な列挙体です。  証明書失効モードを指定します。  この属性は <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 型です。  システムは、ピア証明書を失効証明書リストで検索して、それが失効していないことを検証します。  このチェックは、オンラインで、またはキャッシュされた失効リストをチェックする方法で実行されます。  失効チェックは、この属性を NoCheck に設定することにより無効にできます。|  
+|`trustedStoreLocation`|省略可能な列挙体です。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] セキュリティ システムによりピア証明書を検証する、信頼されているユーザー ストアを指定します。  この属性は <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md)|ピア ノードの現在の資格情報を指定します。|  
+  
+## 解説  
+ メッセージ認証を選択した場合は、この要素を構成する必要があります。  出力チャネルでは、各メッセージは、[\<certificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/certificate-element.md) が提供する認証を使用して署名されます。  すべてのメッセージは、アプリケーションに配信される前に、この要素の `customCertificateValidatorType` 属性で指定した検証を使用してメッセージ資格情報がチェックされます。  検証は、資格情報を受け入れることも拒否することもできます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateAuthenticationElement>   
+ <xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>   
+ <xref:System.ServiceModel.Security.PeerCredential.MessageSenderAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.MessageSenderAuthentication%2A>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/metadata.md b/docs/framework/configure-apps/file-schema/wcf/metadata.md
new file mode 100644
index 00000000000..ecb621836b8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/metadata.md
@@ -0,0 +1,66 @@
+---
+title: "&lt;metadata&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d09653eb-e355-4c73-b87b-28f93d56480d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;metadata&gt;
+サービス メタデータを処理する方法を指定します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <client>  
+        <metadata>  
+                   <policyImporters>  
+                          <policyImporter type="string" />  
+                   </policyImporters  
+                 <wsdlImporters>  
+                      <wsdlImporter type="string" />  
+                 </wsdlImporters>  
+        </metadata>  
+    </client>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<policyImporters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/policyimporters.md)|バインディングに関するカスタム ポリシー アサーションのインポートを制御するすべてのポリシー インポーターを指定します。  ポリシー インポーターは、バインディング機能についてのカスタム ポリシー アサーションの検索、およびアサーションで必要となる機能を実装するカスタム バインディング要素の結び付けに使用されます。|  
+|[\<wsdlImporters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdlimporters.md)|WS\-Policy が添付された Web サービス記述言語 \(WSDL\) 1.1 メタデータをインポートするすべての WSDL インポーターを指定します。  WSDL インポーターは、メタデータのインポートに加えて、コントラクトおよびエンドポイント情報を表すさまざまなクラスにその情報を変換するために使用されます。  コントラクトおよびエンドポイントの情報やプロパティを選択的にインポートできます。これらは、任意のインポート エラーを公開し、インポートおよび変換プロセスに関連する型情報を受け取ります。  また、任意のポリシー ドキュメント、WSDL ドキュメント、WSDL 拡張、および XML スキーマ ドキュメントにアクセスするためのバインディング情報およびプロパティのインポートもサポートします。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<client\>](../../../../../docs/framework/configure-apps/file-schema/wcf/client.md)|クライアントが接続可能なエンドポイントの一覧を定義するクライアント セクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ <xref:System.ServiceModel.Configuration.PolicyImporterElementCollection>   
+ <xref:System.ServiceModel.Configuration.WsdlImporterElementCollection>   
+ <xref:System.ServiceModel.Description.MetadataImporter>   
+ <xref:System.ServiceModel.Description.WsdlImporter>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mexendpoint.md b/docs/framework/configure-apps/file-schema/wcf/mexendpoint.md
new file mode 100644
index 00000000000..fc22a48ec14
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mexendpoint.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;mexEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c9823060-0a5d-4f9d-99d4-4d113b758247
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;mexEndpoint&gt;
+この構成要素は、固定 IMetadataExchange コントラクトが含まれた標準エンドポイントを定義します。  IMetadataExchange はすべてのメタデータ交換エンドポイントでコントラクトとして指定されるため、独自のエンドポイントを定義せずにこの標準エンドポイントを使用できます。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <mexEndpoint>   
+          <standardEndpoint  
+                  name="String" />   
+       </announcementEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md
new file mode 100644
index 00000000000..cd53209980a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;mexHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e50b2e1f-9668-41a5-8077-dee7abff9f0f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;mexHttpBinding&gt;
+HTTP 経由の WS\-MetadataExchange \(WS\-MEX\) メッセージ交換に使用されるバインディングの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<mexHttpBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       name="string"   
+       openTimeout="TimeSpan"   
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan">  
+   </binding>  
+</mexHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ このバインディングは、基本的にはセキュリティを無効にした `WSHttpBinding` バインディングです。  ほとんどのメタデータ要求に対応します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexHttpBinding%2A>   
+ <xref:System.ServiceModel.Configuration.MexHttpBindingElement>   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [カスタム バインディングを介したメタデータの公開と取得](../../../../../docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md)   
+ [メタデータ](../../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md b/docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md
new file mode 100644
index 00000000000..63e38df56ac
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md
@@ -0,0 +1,74 @@
+---
+title: "&lt;mexHttpsBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2ed3774-78b9-4a15-b79b-655f1ad68b86
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;mexHttpsBinding&gt;
+HTTPS 経由の WS\-MetadataExchange \(WS\-MEX\) メッセージ交換に使用されるバインディングの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<mexHttpsBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       name="string"   
+       openTimeout="TimeSpan"   
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan">  
+   </binding>  
+</mexHttpsBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ このバインディングは、基本的には証明書を使用してトランスポート レベルのセキュリティをサポートする `WSHttpBinding` バインディングです。  そのようなメタデータ エンドポイントの構成および使用の詳細については、「[方法 : カスタム WS\-Metadata Exchange バインディングを構成する](../../../../../docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md)」、「[方法: MEX 以外のバインディングを介してメタデータを取得する](../../../../../docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md)」、および「[カスタム セキュア メタデータ エンドポイント](../../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)」のサンプルを参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexHttpsBinding%2A>   
+ <xref:System.ServiceModel.Configuration.MexHttpsBindingElement>   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [カスタム バインディングを介したメタデータの公開と取得](../../../../../docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md)   
+ [方法 : カスタム WS\-Metadata Exchange バインディングを構成する](../../../../../docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md)   
+ [方法: MEX 以外のバインディングを介してメタデータを取得する](../../../../../docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md)   
+ [カスタム セキュア メタデータ エンドポイント](../../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)   
+ [メタデータ](../../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mexnamedpipebinding.md b/docs/framework/configure-apps/file-schema/wcf/mexnamedpipebinding.md
new file mode 100644
index 00000000000..2bd349b92fd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mexnamedpipebinding.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;mexNamedPipeBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 193412fa-3260-414c-92c6-b32ed3b94a34
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;mexNamedPipeBinding&gt;
+名前付きパイプを経由する WS\-MetadataExchange \(WS\-MEX\) メッセージ交換に使用されるバインディングの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<mexNamedPipeBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       name="string"   
+       openTimeout="TimeSpan"   
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan">  
+   </binding>  
+</mexNamedPipeBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexNamedPipeBinding%2A>   
+ <xref:System.ServiceModel.Configuration.MexNamedPipeBindingElement>   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [カスタム バインディングを介したメタデータの公開と取得](../../../../../docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md)   
+ [メタデータ](../../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mextcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/mextcpbinding.md
new file mode 100644
index 00000000000..cc855977e3c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mextcpbinding.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;mexTcpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 01baba8d-d784-4255-9ea2-7afff1482bf0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;mexTcpBinding&gt;
+TCP 経由の WS\-MetadataExchange \(WS\-MEX\) メッセージ交換に使用されるバインディングの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<mexTcpBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       name="string"   
+       openTimeout="TimeSpan"   
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan">  
+   </binding>  
+</mexTcpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MexTcpBindingElement>   
+ <xref:System.ServiceModel.Description.MetadataExchangeBindings.CreateMexTcpBinding%2A>   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [カスタム バインディングを介したメタデータの公開と取得](../../../../../docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md)   
+ [メタデータ](../../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/msmqintegration.md b/docs/framework/configure-apps/file-schema/wcf/msmqintegration.md
new file mode 100644
index 00000000000..60cebc320b5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/msmqintegration.md
@@ -0,0 +1,98 @@
+---
+title: "&lt;msmqIntegration&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: ab677405-1ffe-457a-803f-00c1770e51e2
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;msmqIntegration&gt;
+カスタム バインディングの MSMQ トランスポートを指定します。  
+  
+## 構文  
+  
+```  
+  
+<msmqIntegration>  
+        customDeadLetterQueue="Uri"  
+        deadLetterQueue="Custom/None/System"  
+    durable="Boolean"  
+    exactlyOnce="Boolean"  
+    manualAddressing="Boolean"  
+    maxBufferPoolSize="Integer"  
+    maxImmediateRetries="Integer"  
+    maxReceivedMessageSize="Integer"  
+    maxRetryCycles="Integer"  
+    rejectAfterLastRetry="Boolean"  
+    retryCycleDelay="TimeSpan"  
+    serializationFormat="XML/Binary/ActiveX/ByteArray/Stream"  
+    timeToLive="TimeSpan"  
+    useSourceJournal="Boolean"  
+    useMsmqTracing="Boolean"  
+    <msmqTransportSecurity>  
+    </msmqTransportSecurity>  
+</msmqIntegration>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customDeadLetterQueue|アプリケーションごとの配信不能キューの場所を示す URI。ここには、期限切れのメッセージや、アプリケーションへの配信に失敗したメッセージが転送されます。<br /><br /> ExactlyOnce 保証が必要なメッセージ \(つまり、`exactlyOnce` が `true` に設定される\) の場合、この属性は、既定で MSMQ のトランザクション システム全体の配信不能キューになります。<br /><br /> 保証が必要ないメッセージ \(つまり、`exactlyOnce` が `false` に設定される\) の場合、この属性の既定値は `null` です。<br /><br /> 値は、net.msmq スキームを使用する必要があります。  既定値は、`null` です。<br /><br /> `d` `eadLetterQueue` が `None` または `System` に設定されている場合は、この属性を `null` に設定する必要があります。  この属性が `null` でない場合は、`deadLetterQueue` を `Custom` に設定する必要があります。|  
+|deadLetterQueue|使用する配信不能キューの種類を指定します。<br /><br /> 有効な値を次に示します。<br /><br /> -   Custom: カスタムの配信不能キュー。<br />-   None: 配信不能キューは使用されません。<br />-   System: システムの配信不能キューを使用します。<br /><br /> この属性は、DeadLetterQueue 型です。|  
+|durable|このバインディングで処理されるメッセージが非揮発性か揮発性かを指定するブール値。  既定値は、`true` です。<br /><br /> 非揮発性メッセージは、キュー マネージャーがクラッシュしても残り、揮発性メッセージは失われます。  アプリケーションで待ち時間の短縮が要求され、場合によってはメッセージが失われてもかまわない場合は、揮発性メッセージが適しています。<br /><br /> `exactlyOnce` が `true` に設定されている場合、メッセージは非揮発性である必要があります。|  
+|exactlyOnce|このバインディングで処理されるメッセージが正確に 1 回だけ受信されるかどうかを指定するブール値。  既定値は、`true` です。<br /><br /> メッセージは、保証付きまたは保証なしで送信できます。  保証により、アプリケーションは、送信したメッセージが受信メッセージ キューに到達したことを確認できます。到達しなかった場合、アプリケーションは、配信不能キューを読み取ることでそれを判断できます。<br /><br /> `exactlyOnce` は、`true` に設定されている場合、送信されたメッセージが受信メッセージ キューに 1 回だけ配信され、送信に失敗した場合はメッセージが配信不能キューに送信されることを MSMQ が保証することを示します。<br /><br /> `exactlyOnce` を `true` に設定して送信されるメッセージを、トランザクション キューだけに送信する必要があります。|  
+|manualAddressing|ユーザーによるメッセージのアドレス指定の管理を有効にするブール値です。  このプロパティは、通常、アプリケーションが複数の宛先のどれにメッセージを送信するかを決定するルーターのシナリオで使用されます。<br /><br /> `true` に設定されている場合、チャネルではメッセージが既にアドレス指定されていると見なされ、他の情報は追加されません。  この場合、ユーザーはすべてのメッセージを別個にアドレス指定できます。<br /><br /> `false` に設定されている場合、既定の Windows Communication Foundation \(WCF\) アドレス指定機構により、すべてのメッセージのアドレスが自動的に作成されます。<br /><br /> 既定値は、`false` です。|  
+|maxBufferPoolSize|バッファー プールの最大サイズを指定する正の整数です。  既定値は 524288 です。<br /><br /> WCF の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxImmediateRetries|アプリケーション キューから読み取られるメッセージの即時再試行の最大回数を指定する整数。  既定値は 5 です。<br /><br /> メッセージの即時再試行を最大回数実行してもアプリケーションでメッセージを処理できない場合、メッセージは、後で再試行するために再試行キューに送信されます。  再試行サイクルが指定されていない場合は、メッセージが有害メッセージ キューに送信されるか、送信者に否定応答が返されます。|  
+|maxReceivedMessageSize|ヘッダーなどのメッセージの最大サイズ \(バイト単位\) を指定する正の整数。  受信側にとってメッセージが大きすぎると、メッセージの送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|maxRetryCycles|受信側アプリケーションにメッセージを配信する再試行サイクルの最大数を指定する整数。  既定値は、<xref:System.Int32.MaxValue> です。<br /><br /> 1 回の再試行サイクルで、アプリケーションに、指定された回数のメッセージ配信を試みます。  試行回数は、`maxImmediateRetries` 属性で設定します。  配信を指定された回数試行してもアプリケーションがメッセージを処理できない場合、メッセージは、再試行キューに送信されます。  これに続く再試行サイクルは、`retryCycleDelay` 属性により指定された遅延の後、アプリケーションへの配信を再度試行するアプリケーション キューへの再試行キューから返されるメッセージで構成されています。  `maxRetryCycles` 属性は、アプリケーションがメッセージ配信に使用する再試行サイクル数を指定します。|  
+|rejectAfterLastRetry|再試行を最大回数実行しても配信できなかったメッセージに対して実行するアクションを指定するブール値。<br /><br /> `true` は、否定応答が送信者に返され、メッセージが削除されることを示します。`false` は、メッセージが有害メッセージ キューに送信されることを示します。  既定値は、`false` です。<br /><br /> 値が `false` の場合、受信アプリケーションは、有害メッセージ キューを読み取って、有害メッセージ \(配信に失敗したメッセージ\) を処理できます。<br /><br /> MSMQ 3.0 は送信者への否定応答の返信をサポートしていないので、この属性は、MSMQ 3.0 では無視されます。|  
+|retryCycleDelay|すぐに配信できなかったメッセージを配信しようとするときの、再試行サイクルの時間遅延を指定する <xref:System.TimeSpan>。  既定値は 00:10:00 です。<br /><br /> 1 回の再試行サイクルで、受信アプリケーションに、メッセージ配信を指定回試みます。  試行回数は、`maxImmediateRetries` 属性で指定されます。  即時試行を指定された回数実行してもアプリケーションがメッセージを処理できない場合、メッセージは再試行キューに送信されます。  これに続く再試行サイクルは、`retryCycleDelay`  属性により指定された遅延の後、アプリケーションへの配信を再度試行するアプリケーション キューへの再試行キューから返されるメッセージで構成されています。  再試行サイクル数は、`maxRetryCycles` 属性で指定されます。|  
+|serializationFormat|MSMQ メッセージの一部として送信されるオブジェクトのシリアル化に使用されるフォーマッタを指定します。  有効な値は、次のとおりです。<br /><br /> -   ActiveX: COM オブジェクトをシリアル化するとき、ActiveX フォーマッタが使用されます。<br />-   Binary: オブジェクトをバイナリ パケットにシリアル化します。<br />-   ByteArray: オブジェクトをバイト配列にシリアル化します。<br />-   Stream: オブジェクトをストリームにシリアル化します。<br />-   Xml: オブジェクトを XML パケットにシリアル化します。  既定値は XML です。<br /><br /> この属性は <xref:System.ServiceModel.MsmqIntegration.MsmqMessageSerializationFormat> 型です。|  
+|timeToLive|メッセージの期限が切れて、配信不能キューに入れられるまでのメッセージの有効期間を指定する <xref:System.TimeSpan>。  既定値は 1 日を示す 1.00:00:00 です。<br /><br /> この属性を設定すると、タイムリーなメッセージが受信側アプリケーションで処理される前に古くなることがなくなります。  キュー内のメッセージのうち、指定された期間内に受信アプリケーションで処理されなかったメッセージは、期限切れと呼ばれます。  期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。  配信不能キューの場所は、保証の内容に基づいて、`customDeadLetterQueue` 属性を使用して設定されるか、適切な既定値に設定されます。|  
+|useMsmqTracing|このバインディングにより処理されるメッセージをトレースするかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> トレースが有効な場合、メッセージ キュー コンピューターでメッセージが送受信されるたびに、レポート メッセージが作成され、レポート キューに送信されます。|  
+|useSourceJournal|このバインディングにより処理されるメッセージのコピーをソース ジャーナル キューに保存するかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> キューに置かれたアプリケーションでは、コンピューターの発信キューから送信されたメッセージの記録を残す場合は、メッセージをジャーナル キューにコピーできます。  メッセージが発信キューから送信され、送信先のコンピューターで受信されたという応答を受け取ると、メッセージのコピーが送信元のコンピューターのシステム ジャーナル キューに保持されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|msmqTransportSecurity|このバインディングのトランスポート セキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MsmqIntegrationElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md b/docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md
new file mode 100644
index 00000000000..3f093f9d68f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md
@@ -0,0 +1,152 @@
+---
+title: "&lt;msmqIntegrationBinding&gt;&lt;/msmqIntegrationBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "msmqIntegrationBinding 要素"
+ms.assetid: edf277f3-e3bf-4ed8-9f55-83b5788430a7
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# &lt;msmqIntegrationBinding&gt;&lt;/msmqIntegrationBinding&gt;
+MSMQ を介してメッセージをルーティングすることでキューのサポートを提供するバインディングを定義します。  
+  
+ \<system.ServiceModel>  
+<>\>  
+msmqIntegrationBinding  
+  
+## <a name="syntax"></a>構文  
+  
+```  
+  
+<msmqIntegrationBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       customDeadLetterQueue="Uri"  
+       deadLetterQueue="Uri"  
+       durable="Boolean"  
+       exactlyOnce="Boolean"   
+       maxReceivedMessageSize"Integer"  
+       maxRetryCycles="Integer"   
+       name="string"   
+       openTimeout="TimeSpan"        receiveContextEnabled=”Boolean”  
+       receiveErrorHandling="Drop/Fault/Move/Reject"  
+       receiveTimeout="TimeSpan"   
+       receiveRetryCount="Integer"  
+       retryCycleDelay="TimeSpan"    
+       sendTimeout="TimeSpan"   
+       serializationFormat="XML/Binary/ActiveX/ByteArray/Stream">  
+       timeToLive="TimeSpan"    
+       useMsmqTracing="Boolean  
+       useSourceJournal="Boolean"  
+   </binding>  
+</msmqIntegrationBinding>   
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|説明|  
+|---------------|-----------------|  
+|closeTimeout|A <xref:System.TimeSpan>クローズ操作が完了するまで待機する時間の間隔を指定する値。 この値は以上にする必要があります<xref:System.TimeSpan.Zero>です。 既定値は 00:01:00 です。|  
+|customDeadLetterQueue|アプリケーションごとの配信不能キューの場所が含まれている URI です。ここには、期限切れのメッセージや、転送または配信に失敗したメッセージが配置されます。<br /><br /> 配信不能キューは、送信元アプリケーションのキュー マネージャーにある、配信に失敗した期限切れメッセージのキューです。<br /><br /> によって指定される URI <xref:System.ServiceModel.MsmqBindingBase.CustomDeadLetterQueue%2A> net.msmq スキームを使用する必要があります。|  
+|deadLetterQueue|A <xref:System.ServiceModel.MsmqBindingBase.DeadLetterQueue%2A>.value がある場合に使用するには配信不能キューの種類を指定します。<br /><br /> 配信不能キューは、アプリケーションへの配信に失敗したメッセージが転送される場所です。<br /><br /> exactlyOnce 保証が必要なメッセージ (つまり、`exactlyOnce` 属性が `true` に設定される) の場合、この属性は、既定で MSMQ のトランザクション システム全体の配信不能キューになります。<br /><br /> 保証が必要ないメッセージの場合、この属性の既定値は `null` です。|  
+|durable|メッセージがキューで非揮発性か揮発性かを示すブール値です。 非揮発性メッセージは、キュー マネージャーがクラッシュしても残り、揮発性メッセージは失われます。 アプリケーションで待ち時間の短縮が要求され、場合によってはメッセージが失われてもかまわない場合は、揮発性メッセージが適しています。 `exactlyOnce` 属性が `true` に設定されている場合、メッセージは永続的にする必要があります。 既定値は、`true` です。|  
+|exactlyOnce|各メッセージが&1; 回だけ受信されるかどうかを示すブール値です。 その後、送信側に配信エラーが通知されます。 `durable` が `false` の場合、この属性は無視されて、配信が保証されずにメッセージが転送されます。 既定値は、`true` です。 詳細については、次を参照してください。 <xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A>します。|  
+|maxReceivedMessageSize|このバインディングにより処理される最大メッセージ サイズ (ヘッダーを含む) をバイト単位で定義する正の整数です。 この制限を超えるメッセージの送信者が、SOAP エラーを受信します。 メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。 既定値は 65536 です。 このメッセージ サイズの制限は、サービス拒否 (DoS) 攻撃への露出を制限するためのものです。|  
+|maxRetryCycles|有害メッセージ検出機能により使用される再試行サイクルの回数を示す整数です。 すべてのサイクルの配信試行にすべて失敗すると、メッセージは有害メッセージになります。 既定値は 2 です。 詳細については、次を参照してください。 <xref:System.ServiceModel.MsmqBindingBase.MaxRetryCycles%2A>します。|  
+|name|バインディングの構成名を格納する文字列です。 この値は、バインディングの ID として使用されるため、一意にする必要があります。 [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。 既定の構成と名前のないバインディングおよび動作に関する詳細については、次を参照してください。[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)と[WCF サービスの構成を簡略化](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)します。|  
+|openTimeout|A <xref:System.TimeSpan>オープン操作が完了するまで待機する時間の間隔を指定する値。 この値は以上にする必要があります<xref:System.TimeSpan.Zero>です。 既定値は 00:01:00 です。|  
+|receiveErrorHandling|A <xref:System.ServiceModel.ReceiveErrorHandling>有害メッセージおよびディスパッチ不能メッセージの処理方法を指定する値。|  
+|receiveRetryCount|アプリケーション キューからアプリケーションへのメッセージの転送が失敗した場合に、キュー マネージャーが即時再試行を行う最大回数を指定する整数。<br /><br /> 配信試行を最大回数実行してもアプリケーションがメッセージにアクセスできない場合、メッセージは、後で再配信するために再試行キューに送信されます。 メッセージが送信キューに戻されるまでの時間は、`retryCycleDelay` で制御されます。 再試行サイクルが `maxRetryCycles` 値に達した場合は、メッセージが有害メッセージ キューに送信されるか、送信者に否定応答が返されます。|  
+|receiveTimeout|A <xref:System.TimeSpan>受信操作を完了するまで待機する時間の間隔を指定する値。 この値は以上にする必要があります<xref:System.TimeSpan.Zero>です。 既定値は 00:10:00 です。|  
+|receiveContextEnabled|キュー内のメッセージを処理するための受信コンテキストが有効になっているかどうかを指定するブール値。 これが `true` に設定されている場合、サービスではキューのメッセージを "ピーク" してメッセージの処理を開始できます。問題が発生して例外がスローされた場合、メッセージはキューに残ります。 サービスではメッセージを "ロック" して、後で処理を再試行することもできます。 ReceiveContext は、メッセージを「完了」キューから削除できるように処理されたメカニズムを提供します。メッセージは読み込みやに再書き込みキューされなく、ネットワーク経由でし、個々 のメッセージは処理中にさまざまなサービス インスタンスの間でバウンスします。|  
+|retryCycleDelay|すぐに配信できなかったメッセージを配信しようとするときの、再試行サイクルの時間遅延を指定する TimeSpan 値です。 実際の待機時間はさらに長くなる場合があるため、この値で定義されるのは最小待機時間だけです。 既定値は、00:30:00 です。 詳細については、次を参照してください。 <xref:System.ServiceModel.MsmqBindingBase.RetryCycleDelay%2A>します。|  
+|sendTimeout|A <xref:System.TimeSpan>送信操作が完了するまで待機する時間の間隔を指定する値。 この値は以上にする必要があります<xref:System.TimeSpan.Zero>です。 既定値は 00:01:00 です。|  
+|serializationFormat|メッセージ本文のシリアル化に使用される形式を定義します。 この属性の型が<xref:System.ServiceModel.MsmqIntegration.MsmqMessageSerializationFormat>します。|  
+|timeToLive|メッセージの期限が切れて、配信不能キューに入れられるまでのメッセージの有効期間を指定する TimeSpan 値です。 既定値は 1.00:00:00 です。<br /><br /> この属性を設定すると、タイムリーなメッセージが受信側アプリケーションで処理される前に古くなることがなくなります。 キュー内のメッセージのうち、指定された期間内に受信アプリケーションで処理されなかったメッセージは、期限切れと呼ばれます。 期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。 配信不能キューの場所は、保証の内容に基づいて、`DeadLetterQueue` 属性を使用して設定されるか、適切な既定値に設定されます。|  
+|useMsmqTracing|このバインディングにより処理されるメッセージをトレースするかどうかを指定するブール値です。 既定値は、`false` です。 トレースが有効な場合、メッセージ キュー コンピューターでメッセージが送受信されるたびに、レポート メッセージが作成され、レポート キューに送信されます。|  
+|useSourceJournal|このバインディングにより処理されるメッセージのコピーをソース ジャーナルに保存するかどうかを指定するブール値です。 既定値は、`false` です。<br /><br /> キューに置かれたアプリケーションでは、コンピューターの発信キューから送信されたメッセージの記録を残す場合は、メッセージをジャーナル キューにコピーできます。 メッセージが発信キューから送信され、送信先のコンピューターで受信されたという応答を受け取ると、メッセージのコピーが送信元のコンピューターのシステム ジャーナル キューに保持されます。|  
+  
+## <a name="serializationformat-attribute"></a>{SerializationFormat} 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|Xml|XML 形式|  
+|2 項|バイナリ形式|  
+|ActiveX|ActiveX 形式|  
+|ByteArray|オブジェクトをバイト配列にシリアル化します。|  
+|ストリーム|ストリームとして書式設定された本文。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-msmqintegrationbinding.md)|バインディングのセキュリティ設定を定義します。 この要素が型の<xref:System.ServiceModel.Configuration.MsmqIntegrationSecurityElement>します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## <a name="remarks"></a>コメント  
+ このバインディング要素は、Windows Communication Foundation (WCF) アプリケーションにメッセージを送信し、COM、MSMQ ネイティブ Api、またはで定義された型のいずれかを使用する既存の MSMQ アプリケーションからメッセージを受信できるようにするために使用できます、 <xref:System.Messaging?displayProperty=fullName>名前空間、キューをアドレスする方法は、転送保証、かどうかのメッセージを永続的に格納する必要があります、およびメッセージを保護および認証する方法を指定するこの構成要素を使用することができます。 詳細については、次を参照してください。[方法: WCF エンドポイントとメッセージ キュー アプリケーションとメッセージの交換](../../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)します。  
+  
+## <a name="example"></a>例  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+    <bindings>  
+       <msmqIntegrationBinding>  
+           <binding   
+                    closeTimeout="00:00:10"   
+                    openTimeout="00:00:20"   
+                    receiveTimeout="00:00:30"   
+                    sendTimeout="00:00:40"   
+                    deadLetterQueue="net.msmq://localhost/blah"   
+                    durable="true"   
+                    exactlyOnce="true"   
+                    maxReceivedMessageSize="1000"   
+                    maxImmediateRetries="11"   
+                    maxRetryCycles="12"  
+                    poisonMessageHandling="Disabled"   
+                    rejectAfterLastRetry="false"   
+                    retryCycleDelay="00:05:55"   
+                    timeToLive="00:11:11"   
+                    useSourceJournal="true"   
+                    useMsmqTracing="true"   
+                    serializationFormat="Binary">  
+                    <security mode="None" />  
+           </binding>  
+       </msmqIntegrationBinding  
+   </bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Configuration.MsmqIntegrationBindingElement>   
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>   
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBindingElement>   
+ [<>\>](../../../../../docs/framework/misc/binding.md)   
+ [バインド](../../../../../docs/framework/wcf/bindings.md)   
+ [システム指定のバインディングを構成します。](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [バインドを使用して、Windows Communication Foundation サービスとクライアントを構成するには](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/msmqtransport.md b/docs/framework/configure-apps/file-schema/wcf/msmqtransport.md
new file mode 100644
index 00000000000..5ff7d7d49f8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/msmqtransport.md
@@ -0,0 +1,102 @@
+---
+title: "&lt;msmqTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19d89f35-76ac-49dc-832b-e8bec2d5e33b
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;msmqTransport&gt;
+チャネルがカスタム バインドに含まれているときに、MSMQ トランスポートでメッセージを転送するようにします。  
+  
+## 構文  
+  
+```  
+  
+<msmqTransport>  
+    customDeadLetterQueue="Uri"  
+    deadLetterQueue="Custom/None/System"  
+    durable="Boolean"  
+    exactlyOnce="Boolean"  
+    manualAddressing="Boolean"  
+    maxBufferPoolSize="Integer"  
+    maxImmediateRetries="Integer"  
+    maxPoolSize="Integer"  
+    maxReceivedMessageSize="Integer"  
+    maxRetryCycles="Integer"  
+....queueTransferProtocol="Native/Srmp/SrmpSecure"  
+    rejectAfterLastRetry="Boolean"  
+    retryCycleDelay="TimeSpan"  
+    timeToLive="TimeSpan"  
+    useActiveDirectory="Boolean"  
+    useSourceJournal="Boolean"  
+    useMsmqTracing="Boolean"  
+    <msmqTransportSecurity>  
+    </msmqTransportSecurity>  
+</msmqIntegration>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|customDeadLetterQueue|アプリケーションごとの配信不能キューの場所を示す URI。ここには、期限切れのメッセージや、アプリケーションへの配信に失敗したメッセージが転送されます。<br /><br /> ExactlyOnce 保証が必要なメッセージ \(つまり、`exactlyOnce` が `true` に設定される\) の場合、この属性は、既定で MSMQ のトランザクション システム全体の配信不能キューになります。<br /><br /> 保証が必要ないメッセージ \(つまり、`exactlyOnce` が `false` に設定される\) の場合、この属性の既定値は `null` です。<br /><br /> 値は、net.msmq スキームを使用する必要があります。  既定値は、`null` です。<br /><br /> `deadLetterQueue` が `None` または `System` に設定されている場合は、この属性を `null` に設定する必要があります。  この属性が `null` でない場合は、`deadLetterQueue` を `Custom` に設定する必要があります。|  
+|deadLetterQueue|使用する配信不能キューの種類を指定します。<br /><br /> 有効な値を次に示します。<br /><br /> -   Custom: カスタムの配信不能キュー。<br />-   None: 配信不能キューは使用されません。<br />-   System: システムの配信不能キューを使用します。<br /><br /> この属性は、DeadLetterQueue 型です。|  
+|durable|このバインディングで処理されるメッセージが非揮発性か揮発性かを指定するブール値。  既定値は、`true` です。<br /><br /> 非揮発性メッセージは、キュー マネージャーがクラッシュしても残り、揮発性メッセージは失われます。  アプリケーションで待ち時間の短縮が要求され、場合によってはメッセージが失われてもかまわない場合は、揮発性メッセージが適しています。<br /><br /> `exactlyOnce` が `true` に設定されている場合、メッセージは非揮発性である必要があります。|  
+|exactlyOnce|このバインディングで処理されるメッセージが正確に 1 回だけ受信されるかどうかを指定するブール値。  既定値は、`true` です。<br /><br /> メッセージは、保証付きまたは保証なしで送信できます。  保証により、アプリケーションは、送信したメッセージが受信メッセージ キューに到達したことを確認できます。到達しなかった場合、アプリケーションは、配信不能キューを読み取ることでそれを判断できます。<br /><br /> `exactlyOnce` は、`true` に設定されている場合、送信されたメッセージが受信メッセージ キューに 1 回だけ配信され、送信に失敗した場合はメッセージが配信不能キューに送信されることを MSMQ が保証することを示します。<br /><br /> `exactlyOnce` を `true` に設定して送信されるメッセージを、トランザクション キューだけに送信する必要があります。|  
+|manualAddressing|ユーザーによるメッセージのアドレス指定の管理を有効にするブール値です。  このプロパティは、通常、アプリケーションが複数の宛先のどれにメッセージを送信するかを決定するルーターのシナリオで使用されます。<br /><br /> `true` に設定されている場合、チャネルではメッセージが既にアドレス指定されていると見なされ、他の情報は追加されません。  この場合、ユーザーはすべてのメッセージを別個にアドレス指定できます。<br /><br /> `false` に設定されている場合、既定の Windows Communication Foundation \(WCF\) アドレス指定機構により、すべてのメッセージのアドレスが自動的に作成されます。<br /><br /> 既定値は、`false` です。|  
+|maxBufferPoolSize|バッファー プールの最大サイズを指定する正の整数です。  既定値は 524288 です。<br /><br /> WCF の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxImmediateRetries|アプリケーション キューから読み取られるメッセージの即時再試行の最大回数を指定する整数。  既定値は 5 です。<br /><br /> メッセージの即時再試行を最大回数実行してもアプリケーションでメッセージを処理できない場合、メッセージは、後で再試行するために再試行キューに送信されます。  再試行サイクルが指定されていない場合は、メッセージが有害メッセージ キューに送信されるか、送信者に否定応答が返されます。|  
+|maxPoolSize|プールの最大サイズを指定する正の整数です。  既定値は 524288 です。|  
+|maxReceivedMessageSize|ヘッダーなどのメッセージの最大サイズ \(バイト単位\) を指定する正の整数。  受信側にとってメッセージが大きすぎると、メッセージの送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|maxRetryCycles|受信側アプリケーションにメッセージを配信する再試行サイクルの最大数を指定する整数。  既定値は、<xref:System.Int32.MaxValue> です。<br /><br /> 1 回の再試行サイクルで、アプリケーションに、指定された回数のメッセージ配信を試みます。  試行回数は、`maxImmediateRetries` 属性で設定します。  配信を指定された回数試行してもアプリケーションがメッセージを処理できない場合、メッセージは、再試行キューに送信されます。  これに続く再試行サイクルは、`retryCycleDelay` 属性により指定された遅延の後、アプリケーションへの配信を再度試行するアプリケーション キューへの再試行キューから返されるメッセージで構成されています。  `maxRetryCycles` 属性は、アプリケーションがメッセージ配信に使用する再試行サイクル数を指定します。|  
+|queueTransferProtocol|このバインドが使用する、キューに置かれている通信チャネルのトランスポートを指定します。  有効な値は、次のとおりです。<br /><br /> -   Native: ネイティブな MSMQ プロトコルを使用します。<br />-   Srmp: SOAP リライアブル メッセージ プロトコル \(SRMP\) を使用します。<br />-   SrmpSecure: SOAP リライアブル メッセージ プロトコル セキュア \(SRMPS\) トランスポートを使用します。<br /><br /> この属性は <xref:System.ServiceModel.QueueTransferProtocol> 型です。<br /><br /> MSMQ は、SOAP リライアブル メッセージ プロトコル \(SRMP\) を使用する場合は Active Directory アドレス指定をサポートしないため、`u``seActiveDirectory` が `true` に設定されている場合は、この属性を Srmp または Srmps に設定しないでください。|  
+|rejectAfterLastRetry|再試行を最大回数実行しても配信できなかったメッセージに対して実行するアクションを指定するブール値。<br /><br /> `true` は、否定応答が送信者に返され、メッセージが削除されることを示します。`false` は、メッセージが有害メッセージ キューに送信されることを示します。  既定値は、`false` です。<br /><br /> 値が `false` の場合、受信アプリケーションは、有害メッセージ キューを読み取って、有害メッセージ \(配信に失敗したメッセージ\) を処理できます。<br /><br /> MSMQ 3.0 は送信者への否定応答の返信をサポートしていないので、この属性は、MSMQ 3.0 では無視されます。|  
+|retryCycleDelay|すぐに配信できなかったメッセージを配信しようとするときの、再試行サイクルの時間遅延を指定する <xref:System.TimeSpan>。  既定値は 00:10:00 です。<br /><br /> 1 回の再試行サイクルで、受信アプリケーションに、メッセージ配信を指定回試みます。  試行回数は、`maxImmediateRetries` 属性で指定されます。  即時試行を指定された回数実行してもアプリケーションがメッセージを処理できない場合、メッセージは再試行キューに送信されます。  これに続く再試行サイクルは、`retryCycleDelay`  属性により指定された遅延の後、アプリケーションへの配信を再度試行するアプリケーション キューへの再試行キューから返されるメッセージで構成されています。  再試行サイクル数は、`maxRetryCycles` 属性で指定されます。|  
+|timeToLive|メッセージの期限が切れて、配信不能キューに入れられるまでのメッセージの有効期間を指定する <xref:System.TimeSpan>。  既定値は 1 日を示す 1.00:00:00 です。<br /><br /> この属性を設定すると、タイムリーなメッセージが受信側アプリケーションで処理される前に古くなることがなくなります。  キュー内のメッセージのうち、指定された期間内に受信アプリケーションで処理されなかったメッセージは、期限切れと呼ばれます。  期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。  配信不能キューの場所は、保証の内容に基づいて、`customDeadLetterQueue` 属性を使用して設定されるか、適切な既定値に設定されます。|  
+|UseActiveDirectory|キューのアドレスを Active Directory を使用して変換する必要があるかどうかを指定するブール値。<br /><br /> MSMQ キューのアドレスは、パス名または直接形式名で構成できます。  直接形式名を使用する場合、MSMQ は、DNS、NetBIOS、または IP を使用してコンピューター名を解決します。  パス名を使用する場合、MSMQ は、Active Directory を使用してコンピューター名を解決します。  既定では、Windows Communication Framework \(WCF\) キューに置かれているトランスポートは、メッセージ キューの URI を直接形式名に変換します。  この属性を `true` に設定すると、キューに置かれているトランスポートが DNS、NetBIOS、または IP ではなく Active Directory を使用してコンピューター名を解決する必要があることを、アプリケーションで指定できます。|  
+|useMsmqTracing|このバインディングにより処理されるメッセージをトレースするかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> トレースが有効な場合、メッセージ キュー コンピューターでメッセージが送受信されるたびに、レポート メッセージが作成され、レポート キューに送信されます。|  
+|useSourceJournal|このバインディングにより処理されるメッセージのコピーをソース ジャーナル キューに保存するかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> キューに置かれたアプリケーションでは、コンピューターの発信キューから送信されたメッセージの記録を残す場合は、メッセージをジャーナル キューにコピーできます。  メッセージが発信キューから送信され、送信先のコンピューターで受信されたという応答を受け取ると、メッセージのコピーが送信元のコンピューターのシステム ジャーナル キューに保持されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<msmqTransportSecurity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/msmqtransportsecurity.md)|このバインディングのトランスポート セキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ `msmqTransport` 要素は、ユーザーがキューに置かれている通信チャネルのプロパティを設定できるようにします。  キューに置かれている通信チャネルは、そのトランスポートにメッセージ キューを使用します。  
+  
+ このバインディング要素は、メッセージ キューの標準バインディング \(`netMsmqBinding`\) で使用される既定のバインディング要素です。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MsmqTransportElement>   
+ <xref:System.ServiceModel.Channels.MsmqTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/msmqtransportsecurity.md b/docs/framework/configure-apps/file-schema/wcf/msmqtransportsecurity.md
new file mode 100644
index 00000000000..cdd61e09dac
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/msmqtransportsecurity.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;msmqTransportSecurity&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 092e911b-ab1b-4069-a26e-6134c3299e06
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# &lt;msmqTransportSecurity&gt;
+カスタム バインディングの MSMQ トランスポート セキュリティ設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<msmqTransportSecurity>  
+   msmqAuthenticationMode="None/Windows/Certificate"  
+   msmqEncryptionAlgorithm="RC4Stream/AES"  
+   msmqProtectionLevel="None/Sign/EncryptAndSign"  
+   msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+</msmqTransportSecurity>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`msmqAuthenticationMode`|MSMQ トランスポートによるメッセージの認証方法を指定します。  これが `None` に設定されている場合、`msmqProtectionLevel` 属性の値も `None` に設定する必要があります。<br /><br /> 以下の値が有効です。<br /><br /> -   None: 認証は行われません。<br />-   Windows: 認証機構により Active Directory が使用され、メッセージに関連付けられた SID の X.509 証明書が取得されます。  次に、これを使用してキューの ACL がチェックされ、ユーザーがキューに書き込む権限を持っていることが確認されます。<br />-   Certificate: チャネルは、証明書ストアから証明書を取得します。<br /><br /> 既定値は Windows です。  この属性は <xref:System.ServiceModel.MsmqAuthenticationMode> 型です。|  
+|`msmqEncryptionAlgorithm`|メッセージ キュー マネージャー間でメッセージを転送するときに、ネットワーク上でメッセージの暗号化に使用されるアルゴリズムを指定します。  以下の値が有効です。<br /><br /> -   RC4Stream<br />-   AES<br /><br /> 既定値は RC4Stream です。  この属性は <xref:System.ServiceModel.MsmqEncryptionAlgorithm> 型です。|  
+|`msmqProtectionLevel`|MSMQ トランスポートのレベルでメッセージをセキュリティで保護する方法を指定します。  暗号化を行うとメッセージの整合性が確保されますが、EncryptAndSign を使用するとメッセージの整合性と否認防止の両方が確保されます。つまり、メッセージは本当にその送信者から送信されていることになり、記載されている送信者が実際の送信者になります。  以下の値が有効です。<br /><br /> -   None: 保護されません。<br />-   Sign: メッセージは署名されます。<br />-   EncryptAndSign: メッセージは暗号化および署名されます。<br /><br /> 既定値は Sign です。  この属性は <xref:System.Net.Security.ProtectionLevel> 型です。|  
+|`msmqSecureHashAlgorithm`|署名の一部としてダイジェストの計算に使用されるアルゴリズムを指定します。  以下の値が有効です。<br /><br /> -   MD5<br />-   SHA1<br />-   SHA256<br />-   SHA512<br /><br /> 既定値は SHA1 です。  この属性は <xref:System.ServiceModel.MsmqSecureHashAlgorithm> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<msmqIntegration\>](../../../../../docs/framework/configure-apps/file-schema/wcf/msmqintegration.md)|Message Queuing \(MSMQ\) の送信側または受信側とのやり取りに必要な設定を指定します。|  
+|[\<msmqTransport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/msmqtransport.md)|ネイティブ MSMQ プロトコルを使用する Windows Communication Foundation \(WCF\) サービスのキュー通信プロパティを指定します。|  
+  
+## 解説  
+ トランスポート セキュリティの詳細については、「[トランスポート セキュリティ](../../../../../docs/framework/wcf/feature-details/transport-security.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationSecurity>   
+ <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [トランスポート セキュリティ](../../../../../docs/framework/wcf/feature-details/transport-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/mtommessageencoding.md b/docs/framework/configure-apps/file-schema/wcf/mtommessageencoding.md
new file mode 100644
index 00000000000..2a0922eb5cb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/mtommessageencoding.md
@@ -0,0 +1,86 @@
+---
+title: "&lt;mtomMessageEncoding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 7865d171-cd1e-430a-8421-39cc13541d1b
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;mtomMessageEncoding&gt;
+SOAP Message Transmission Optimization Mechanism \(MTOM\) ベースのメッセージに使用されるエンコーディングおよびメッセージ バージョン管理を指定します。  
+  
+## 構文  
+  
+```  
+  
+<mtomMessageEncoding   
+   maxBufferSize="Integer"  
+      maxReadPoolSize="Integer"  
+   maxWritePoolSize="Integer"  
+   messageVersion="Soap11Addressing1/Soap12Addressing10"  
+      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|maxBufferSize|使用できるバッファーの最大サイズを指定する整数。|  
+|maxReadPoolSize|新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を指定する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 64 です。|  
+|maxWritePoolSize|新しいライターを割り当てずに同時に送信可能なメッセージの数を指定する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 16 です。|  
+|messageVersion|バインディングを使用して送信されたメッセージの SOAP バージョンを指定します。  有効な値は、次のとおりです。<br /><br /> -   Soap11Addressing1<br />-   Soap12Addressing10<br /><br /> 既定値は Soap12Addressing10 です。  この属性は <xref:System.ServiceModel.Channels.MessageVersion> 型です。|  
+|writeEncoding|バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。  有効な値は、次のとおりです。<br /><br /> -   UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング<br />-   Utf16TextEncoding: Unicode エンコーディング<br />-   Utf8TextEncoding: 8 ビットのエンコーディング<br /><br /> 既定値は Utf8TextEncoding です。  この属性は <xref:System.Text.Encoding> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。  デコードは、その逆のプロセスです。  WCF \(Windows Communication Foundation\) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM \(Message Transmission Optimization Mechanism\) の 3 種類があります。  
+  
+ `MtomMessageEncoding` 要素は、MTOM \(Message Transmission Optimization Mechanism\) エンコーディングを使用するメッセージの文字エンコーディング、メッセージのバージョン管理、およびその他の設定を指定します。  MTOM は、WCF メッセージでバイナリ データを転送するための効率的なテクノロジです。  MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。  MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックは、base64 でエンコードされた形式に変換せずに、そのまま転送することによって最適化します。  
+  
+## 使用例  
+  
+```  
+<mtomMessageEncoding maxReadPoolSize="211"  
+    maxWritePoolSize="2132"  
+    messageVersion=”Soap11Addressing10”  
+    textEncoding=”utf-8” />  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MtomMessageEncodingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>   
+ [メッセージ エンコーディング](../../../../../docs/framework/configure-apps/file-schema/wcf/message-encoding.md)   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/namedpipetransport.md b/docs/framework/configure-apps/file-schema/wcf/namedpipetransport.md
new file mode 100644
index 00000000000..bd14d0cdd5c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/namedpipetransport.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;namedPipeTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 9fc3f42f-43e2-4ab1-8bc7-3c95a9220df1
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;namedPipeTransport&gt;
+チャネルがカスタム バインディングに含まれているときに名前付きパイプを使用してメッセージを転送するトランスポートを定義します。  
+  
+## 構文  
+  
+```  
+  
+<namedPipeTransport>  
+      <connectionPoolSettings  
+         groupName=”String”  
+          idleTimeout"TimeSpan"  
+        maxOutboundConnectionsPerEndpopint=”Integer” />  
+</namedPipeTransport>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<namedPipeTransport\> の \<connectionPoolSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/connectionpoolsettings.md)|名前付きパイプ バインディングの追加の接続プール設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ このトランスポートは、"net.pipe:\/\/hostname\/path" の形式の URI を使用します。  他の URI コンポーネントは省略可能です。  
+  
+ `namedPipeTransport` 要素は、名前付きパイプ トランスポート プロトコルを実装するカスタム バインディングを作成する場合の開始点となります。  このトランスポートは、コンピューター上での WCF \(Windows Communication Foundation\) 間の通信に使用されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.NamedPipeTransportElement>   
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/namespacetable.md b/docs/framework/configure-apps/file-schema/wcf/namespacetable.md
new file mode 100644
index 00000000000..9614ea51f5b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/namespacetable.md
@@ -0,0 +1,57 @@
+---
+title: "&lt;namespaceTable&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 64801766-01b7-4c65-9ce6-70ad5af67689
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;namespaceTable&gt;
+名前空間とプレフィックスのマッピングを含む要素セットを定義する構成セクションを表します。これは、ルーティングの XPath フィルターで使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+   <namespaceTable>  
+     <add namespace="String" prefix="String" />   
+   </namespaceTable>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filter.md)|XPath 式に使用される名前空間とプレフィックスのマッピングを定義します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルター セットと、フィルターが一致するときにメッセージを送信するターゲット エンドポイントを指定するルーティング テーブルを定義する構成セクションを表します。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.NamespaceElementCollection](assetId:///System.ServiceModel.Routing.Configuration.NamespaceElementCollection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/net-pipe.md b/docs/framework/configure-apps/file-schema/wcf/net-pipe.md
new file mode 100644
index 00000000000..fa44fa050ac
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/net-pipe.md
@@ -0,0 +1,75 @@
+---
+title: "&lt;net.pipe&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a0f0318-f8f6-466c-9fae-199d7274a82e
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;net.pipe&gt;
+名前付きパイプ接続の有効期間を管理し、名前付きパイプを介して到着するアクティベーション要求を処理する名前付きパイプ アクティベーション サービスの構成設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+   <system.serviceModel.activation>  
+       <net.pipe maxPendingAccepts="Integer"  
+                    maxPendingConnections="Integer"  
+          receiveTimeout="TimeSpan">  
+          <allowAccounts>  
+             // LocalSystem account  
+             <add securityIdentifier="S-1-5-18"/>  
+             // LocalService account  
+             <add securityIdentifier="S-1-5-19"/>  
+             // Administrators account  
+             <add securityIdentifier="S-1-5-20"/>  
+             // Network Service account  
+             <add securityIdentifier="S-1-5-32-544" />  
+             // IIS_IUSRS account (Vista only)  
+             <add securityIdentifier="S-1-5-32-568"/>  
+           </allowAccounts>  
+       </net.pipe>  
+   </system.serviceModel.activation>  
+</configuration>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`maxPendingAccepts`|整数は、共有サービスの待機エンドポイントで同時に受け入れる未処理のスレッドの最大数を示しています。  既定値は 2 です。|  
+|`maxPendingConnections`|ディスパッチを待機できる最大接続数を指定する整数。  既定値は 100 です。|  
+|`receiveTimeout`|フレーム データを読み取り、基礎となる接続から接続ディスパッチを実行するタイムアウトを指定する <xref:System.Timespan> です。  既定値は "00:00:10" です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<allowAccounts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/allowaccounts.md)|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] をホストするプロセスのユーザー アカウントを指定する `securityIdentifier` 属性が含まれており、共有サービスへの接続アクセス権が付与される構成要素のコレクションです。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel.activation\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md)|リスナー プロセス SMSvcHost.exe の設定が含まれています。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration.NetPipeSection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/net-tcp.md b/docs/framework/configure-apps/file-schema/wcf/net-tcp.md
new file mode 100644
index 00000000000..5d1983b6c34
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/net-tcp.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;net.tcp&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8bc2f2be-11c1-4bab-9018-1d21ae568d94
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# &lt;net.tcp&gt;
+複数のプロセスが同じ TCP ポートを共有できる NET.TCP ポート共有サービスの構成設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+   <system.serviceModel.activation>  
+       <net.tcp listenBacklog="Integer"  
+          maxPendingAccepts="Integer"  
+          maxPendingConnections="Integer"  
+          receiveTimeout="TimeSpan"  
+          teredoEnabled="Boolean">  
+          <allowAccounts>  
+             <!-- LocalSystem account -->   
+             <add securityIdentifier="S-1-5-18"/>  
+             <!-- LocalService account -->   
+             <add securityIdentifier="S-1-5-19"/>  
+             <!-- Administrators account -->   
+             <add securityIdentifier="S-1-5-20"/>  
+             <!-- Network Service account -->   
+             <add securityIdentifier="S-1-5-32-544" />  
+             <!-- IIS_IUSRS account (Vista only)-->   
+             <add securityIdentifier="S-1-5-32-568"/>  
+           </allowAccounts>  
+       </net.tcp>  
+   </system.serviceModel.activation>  
+</configuration>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`listenBacklog`|共有接続から受け入れられたが、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスにはまだディスパッチされていない未処理の接続の最大数を指定する整数です。  既定値は 10 です。|  
+|`maxPendingAccepts`|整数は、共有サービスの待機エンドポイントで同時に受け入れる未処理のスレッドの最大数を示しています。  既定値は 2 です。|  
+|`MaxPendingConnections`|アプリケーションによる受け入れをリスナーで待機できる最大接続数。  このクォータ値を超過すると、新規の受信接続は受け入れられるのを待機せずに切断されます。  メッセージ セキュリティのような接続機能では、クライアントは複数の接続を開くことがあります。  このクォータ値を設定する場合、サービス管理者はこのような追加の接続も考慮する必要があります。  既定値は 10 です。|  
+|`receiveTimeout`|フレーム データを読み取り、基礎となる接続から接続ディスパッチを実行するタイムアウトを指定する <xref:System.Timespan> です。  既定値は "00:00:10" です。|  
+|`teredoEnabled`|ポート共有サービスが Microsoft Teredo サービスを使用して、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの代わりに TCP ポートをリッスンするかどうかを示すブール値。  既定値は、`false` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<allowAccounts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/allowaccounts.md)|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] をホストするプロセスのユーザー アカウントを指定する `securityIdentifier` 属性が含まれており、共有サービスへの接続アクセス権が付与される構成要素のコレクションです。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel.activation\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md)|リスナー プロセス SMSvcHost.exe の設定が含まれています。|  
+  
+## 解説  
+ ポート共有の詳細については、「[Net.TCP Port Sharing](http://msdn.microsoft.com/ja-jp/f13692ee-a179-4439-ae72-50db9534eded)」を参照してください。  ポート共有サービスを構成する方法については、「[Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration.NetTcpSection>   
+ [Net.TCP Port Sharing](http://msdn.microsoft.com/ja-jp/f13692ee-a179-4439-ae72-50db9534eded)   
+ [Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/nethttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/nethttpbinding.md
new file mode 100644
index 00000000000..909ee9e7c76
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/nethttpbinding.md
@@ -0,0 +1,198 @@
+---
+title: "&lt;netHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0d81ca0-87c5-4090-8baa-e390fd3656d2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;netHttpBinding&gt;
+HTTP を介して通信できるエンド ポイントを構成および公開するために [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスが使用できるバインディングを表します。  双方向コントラクトで使用すると、Web ソケットが使用されます。それ以外の場合は、HTTP が使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+```  
+  
+```csharp  
+  
+<netHttpBinding>  
+   <binding   
+       allowCookies="Boolean"  
+       bypassProxyOnLocal="Boolean"  
+       closeTimeout="TimeSpan"   
+       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+       maxBufferPoolSize="Integer"  
+       maxBufferSize="Integer"  
+       maxReceivedMessageSize="Integer"  
+       messageEncoding="Binary/Text/Mtom"  
+       name="string"   
+       openTimeout="TimeSpan"   
+       proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan"  
+              textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+              transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+       useDefaultWebProxy="Boolean"  
+       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">  
+           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"  
+                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"  
+                                    realm="string" />  
+           <message   
+                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                            clientCredentialType="UserName/Certificate"/>  
+       </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"      
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netHttpBinding>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowCookies`|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> インターネット リソースは、ローカル アドレスを持つ場合ローカルです。  ローカル アドレスは、同じコンピューター、ローカル LAN、またはイントラネット上にあり、"http:\/\/webserver\/"、"http:\/\/localhost\/" などのピリオド \(.\) を含まない URI により構文的に識別されるアドレスです。<br /><br /> この属性の設定は、BasicHttpBinding で構成されたエンドポイントがローカル リソースへのアクセス時にプロキシ サーバーを使用するかどうかを示します。  この属性が `true` の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。  この属性を `true` に設定した場合で、同じコンピューター上のサービスと対話するクライアントがプロキシを経由するときは、\(localhost ではなく\) ホスト名を使用します。<br /><br /> この属性が `false` の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`hostnameComparisonMode`|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる、最大メモリ量を指定する整数値。  既定値は 524288 \(0x80000\) バイトです。<br /><br /> バッファー マネージャーは、バッファー プールを使用することで、バッファーの使用コストを最小化します。  バッファーは、チャネルから出てくるメッセージをサービスが処理するときに必要です。  メッセージの読み込み処理に十分なメモリがバッファー プールにない場合、バッファー マネージャーは、CLR ヒープから追加のメモリを割り当てる必要があります。これにより、ガベージ コレクションのオーバーヘッドが増加します。  CLR ガベージ ヒープから多大な割り当てが行われることは、バッファー プール サイズが小さすぎること、およびこの属性で指定される制限を緩めて割り当てを増やすとパフォーマンスが向上する可能性があることを示します。|  
+|`maxBufferSize`|このバインディングで構成されるエンドポイントのメッセージが処理されるときのメッセージを格納するバッファーの最大サイズを指定する整数値 \(バイト単位\)。  既定値は 65,536 バイトです。|  
+|`maxReceivedMessageSize`|このバインディングで構成されるチャネルが受信可能なメッセージの最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数。  受信側のメッセージが大きすぎると、送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65,536 バイトです。|  
+|`messageEncoding`|SOAP メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。  この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`namespace`|バインディングの XML 名前空間を指定します。  既定値は "http:\/\/tempuri.org\/Bindings" です。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`proxyAddress`|HTTP プロキシのアドレスを格納する URI。  `useSystemWebProxy` が `true` に設定されている場合、この設定は `null` である必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`transferMode`|要求または応答に対してメッセージがバッファーされるか、ストリーム配信されるかを指定する有効な <xref:System.ServiceModel.TransferMode> 値。|  
+|`useDefaultWebProxy`|使用できる場合にシステムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+|||  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ NetHttpBinding では、メッセージを送信するために、HTTP をトランスポートとして使用します。  双方向コントラクトで使用すると、Web ソケットが使用されます。  要求\/応答コントラクト NetHttpBinding と使用する場合、バイナリ エンコーダーとの BasicHttpBinding のように動作します。  
+  
+ 既定ではセキュリティは無効になります。ただし、[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)`None 子要素のモード属性に`  以外の値を設定してセキュリティを追加できます。  サービスは、"Text" メッセージ エンコードおよび UTF\-8 テキスト エンコードを既定で使用します。  
+  
+## 使用例  
+ 第 1 世代と第 2 世代の Web サービスで HTTP 通信と最大限の相互運用性を実現する、<xref:System.ServiceModel.NetHttpBinding> の使用例を次に示します。  バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、`<endpoint>` 要素の `binding` 属性を使用して指定します。  基本的なバインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、`<endpoint>` 要素の `bindingConfiguration` 属性を使用して、名前でバインディング構成を参照する必要があります。次のサービスの構成コードを参照してください。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="netHttpBinding"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <netHttpBinding>  
+        <binding name="Binding1"   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Binary"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </netHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+## 使用例  
+ [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  前の例の機能を実行するには、エンドポイント アドレスの bindingConfiguration とバインディングの名前を削除します。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="netHttpBinding"  
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <netHttpBinding>  
+        <binding   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Binary"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </netHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+ 既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/nethttpsbinding.md b/docs/framework/configure-apps/file-schema/wcf/nethttpsbinding.md
new file mode 100644
index 00000000000..cc102532104
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/nethttpsbinding.md
@@ -0,0 +1,198 @@
+---
+title: "&lt;netHttpsBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff122116-6042-4792-9f21-275b4f97a105
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;netHttpsBinding&gt;
+HTTPS を介して通信できるエンド ポイントを構成および公開するために [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスが使用できるバインディングを表します。  双方向コントラクトで使用すると、Web ソケットが使用されます。それ以外の場合は、HTTPS が使用されます。  
+  
+## 構文  
+  
+```vb  
+  
+```  
+  
+```csharp  
+  
+<netHttpsBinding>  
+   <binding   
+       allowCookies="Boolean"  
+       bypassProxyOnLocal="Boolean"  
+       closeTimeout="TimeSpan"   
+       hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+       maxBufferPoolSize="Integer"  
+       maxBufferSize="Integer"  
+       maxReceivedMessageSize="Integer"  
+       messageEncoding="Binary/Text/Mtom"  
+       name="string"   
+       openTimeout="TimeSpan"   
+       proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan"  
+              textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+              transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+       useDefaultWebProxy="Boolean"  
+       <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">  
+           <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"  
+                  proxyCredentialType="None/Basic/Digest/Ntlm/Windows"  
+                                    realm="string" />  
+           <message   
+                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                            clientCredentialType="UserName/Certificate"/>  
+       </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"      
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netHttpsBinding>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowCookies`|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。<br /><br /> インターネット リソースは、ローカル アドレスを持つ場合ローカルです。  ローカル アドレスは、同じコンピューター、ローカル LAN、またはイントラネット上にあり、"http:\/\/webserver\/"、"http:\/\/localhost\/" などのピリオド \(.\) を含まない URI により構文的に識別されるアドレスです。<br /><br /> この属性の設定は、BasicHttpBinding で構成されたエンドポイントがローカル リソースへのアクセス時にプロキシ サーバーを使用するかどうかを示します。  この属性が `true` の場合、ローカル インターネット リソースへの要求はプロキシ サーバーを使用しません。  この属性を `true` に設定した場合で、同じコンピューター上のサービスと対話するクライアントがプロキシを経由するときは、\(localhost ではなく\) ホスト名を使用します。<br /><br /> この属性が `false` の場合、すべてのインターネット要求はプロキシ サーバー経由で行われます。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`hostnameComparisonMode`|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる、最大メモリ量を指定する整数値。  既定値は 524288 \(0x80000\) バイトです。<br /><br /> バッファー マネージャーは、バッファー プールを使用することで、バッファーの使用コストを最小化します。  バッファーは、チャネルから出てくるメッセージをサービスが処理するときに必要です。  メッセージの読み込み処理に十分なメモリがバッファー プールにない場合、バッファー マネージャーは、CLR ヒープから追加のメモリを割り当てる必要があります。これにより、ガベージ コレクションのオーバーヘッドが増加します。  CLR ガベージ ヒープから多大な割り当てが行われることは、バッファー プール サイズが小さすぎること、およびこの属性で指定される制限を緩めて割り当てを増やすとパフォーマンスが向上する可能性があることを示します。|  
+|`maxBufferSize`|このバインディングで構成されるエンドポイントのメッセージが処理されるときのメッセージを格納するバッファーの最大サイズを指定する整数値 \(バイト単位\)。  既定値は 65,536 バイトです。|  
+|`maxReceivedMessageSize`|このバインディングで構成されるチャネルが受信可能なメッセージの最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数。  受信側のメッセージが大きすぎると、送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65,536 バイトです。|  
+|`messageEncoding`|SOAP メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。  この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`namespace`|バインディングの XML 名前空間を指定します。  既定値は "http:\/\/tempuri.org\/Bindings" です。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`proxyAddress`|HTTP プロキシのアドレスを格納する URI。  `useSystemWebProxy` が `true` に設定されている場合、この設定は `null` である必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`transferMode`|要求または応答に対してメッセージがバッファーされるか、ストリーム配信されるかを指定する有効な <xref:System.ServiceModel.TransferMode> 値。|  
+|`useDefaultWebProxy`|使用できる場合にシステムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+|||  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ NetHttpsBinding では、メッセージを送信するために、HTTPS をトランスポートとして使用します。  双方向コントラクトで使用すると、Web ソケットが使用されます。  要求\/応答コントラクト NetHttpsBinding と使用する場合、バイナリ エンコーダーとの BasicHttpsBinding のように動作します。  
+  
+ 既定ではセキュリティは無効になります。ただし、[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)`None 子要素のモード属性に`  以外の値を設定してセキュリティを追加できます。  サービスは、"Text" メッセージ エンコードおよび UTF\-8 テキスト エンコードを既定で使用します。  
+  
+## 使用例  
+ 第 1 世代と第 2 世代の Web サービスで HTTPS 通信と最大限の相互運用性を実現する、<xref:System.ServiceModel.NetHttpBinding> の使用例を次に示します。  バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、`<endpoint>` 要素の `binding` 属性を使用して指定します。  基本的なバインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、`<endpoint>` 要素の `bindingConfiguration` 属性を使用して、名前でバインディング構成を参照する必要があります。次のサービスの構成コードを参照してください。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="netHttpsBinding"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <netHttpsBinding>  
+        <binding name="Binding1"   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Binary"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </netHttpsBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+## 使用例  
+ [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  前の例の機能を実行するには、エンドポイント アドレスの bindingConfiguration とバインディングの名前を削除します。  
+  
+```xml  
+<system.serviceModel>   
+  <services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="netHttpsBinding"  
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  <bindings>  
+     <netHttpsBinding>  
+        <binding   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxReceivedMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Binary"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+              <security mode="None" />  
+         </binding>  
+     </netHttpsBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+ 既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md b/docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md
new file mode 100644
index 00000000000..9556eed5121
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md
@@ -0,0 +1,157 @@
+---
+title: "&lt;netMsmqBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: a68b44d7-7799-43a3-9e63-f07c782810a6
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# &lt;netMsmqBinding&gt;
+複数コンピューターの通信に適しているキューに置かれたバインディングを定義します。  
+  
+## 構文  
+  
+```  
+  
+<netMsmqBinding>  
+    <binding   
+       closeTimeout="TimeSpan"   
+       customDeadLetterQueue="Uri"  
+       deadLetterQueue="Uri"  
+       durable="Boolean"  
+       exactlyOnce="Boolean"   
+       maxBufferPoolSize="Integer"  
+       maxReceivedMessageSize"Integer"  
+       maxRetryCycles="Integer"   
+       name="string"   
+       openTimeout="TimeSpan"   
+       poisonMessageHandling="Disabled/EnabledIfSupported"   
+       queueTransferProtocol="Native/Srmp/SrmpSecure"  
+       receiveErrorHandling="Drop/Fault/Move/Reject"  
+       receiveTimeout="TimeSpan"   
+       receiveRetryCount="Integer"  
+       rejectAfterLastRetry="Boolean"   
+       retryCycleDelay="TimeSpan"    
+       sendTimeout="TimeSpan"   
+       timeToLive="TimeSpan"    
+       useActiveDirectory="Boolean"  
+       useMsmqTracing="Boolean  
+       useSourceJournal="Boolean"  
+          <security>  
+                  <message    
+                        algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            clientCredentialType="None/Windows/UserName/Certificate/InfoCard "/>  
+                  <transport msmqAuthenticationMode="None/WindowsDomain/Certificate"  
+            msmqEncryptionAlgorithm="RC4Stream/AES"  
+            msmqProtectionLevel="None/Sign/EncryptAndSign"  
+            msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+          </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netMsmqBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`customDeadLetterQueue`|アプリケーションごとの配信不能キューの場所が含まれている URI です。ここには、期限切れのメッセージや、転送または配信に失敗したメッセージが配置されます。<br /><br /> 配信不能キューは、送信元アプリケーションのキュー マネージャーにある、配信に失敗した期限切れメッセージのキューです。<br /><br /> <xref:System.ServiceModel.MsmqBindingBase.CustomDeadLetterQueue%2A> によって指定される URI は、net.msmq スキームを使用する必要があります。|  
+|`deadLetterQueue`|使用する配信不能キューがある場合にその種類を指定する <xref:System.ServiceModel.MsmqBindingBase.DeadLetterQueue%2A> 値。<br /><br /> 配信不能キューは、アプリケーションへの配信に失敗したメッセージが転送される場所です。<br /><br /> `exactlyOnce` 保証が必要なメッセージ \(つまり、`exactlyOnce` 属性が `true` に設定される\) の場合、この属性は、既定で MSMQ のトランザクション システム全体の配信不能キューになります。<br /><br /> 保証が必要ないメッセージの場合、この属性の既定値は `null` です。|  
+|`durable`|メッセージがキューで非揮発性か揮発性かを示すブール値です。  非揮発性メッセージは、キュー マネージャーがクラッシュしても残り、揮発性メッセージは失われます。  アプリケーションで待ち時間の短縮が要求され、場合によってはメッセージが失われてもかまわない場合は、揮発性メッセージが適しています。  `exactlyOnce` 属性が `true` に設定されている場合、メッセージは永続的にする必要があります。  既定値は、`true` です。|  
+|`exactlyOnce`|このバインディングで処理される各メッセージが 1 回だけ受信されるかどうかを示すブール値です。  その後、送信側に配信エラーが通知されます。  `durable` が `false` の場合、この属性は無視されて、配信が保証されずにメッセージが転送されます。  既定値は、`true` です。  詳細については、「<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A>」を参照してください。|  
+|`maxBufferPoolSize`|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定値は 8 です。|  
+|`maxReceivedMessageSize`|このバインディングにより処理される最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数です。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。  このメッセージ サイズの制限は、サービス拒否 \(DoS\) 攻撃への露出を制限するためのものです。|  
+|`maxRetryCycles`|有害メッセージ検出機能により使用される再試行サイクルの回数を示す整数です。  すべてのサイクルの配信試行にすべて失敗すると、メッセージは有害メッセージになります。  既定値は 3 です。  詳細については、「<xref:System.ServiceModel.MsmqBindingBase.MaxRetryCycles%2A>」を参照してください。|  
+|`name`|必須の属性です。  バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`QueueTransferProtocol`|このバインディングが使用するキューに置かれた通信チャネルのトランスポートを指定する有効な <xref:System.ServiceModel.QueueTransferProtocol> 値。  MSMQ は、SOAP リライアブル メッセージ プロトコルを使用する場合は Active Directory アドレス指定をサポートしません。  したがって、`u``seActiveDirectory` 属性が `true` に設定されている場合は、この属性を `Srmp` or `Srmps` に設定しないでください。|  
+|`receiveErrorHandling`|有害メッセージおよびディスパッチ不能メッセージの処理方法を指定する <xref:System.ServiceModel.ReceiveErrorHandling> 値。|  
+|`receiveRetryCount`|キュー マネージャーがメッセージを再試行キューに転送する前にメッセージ送信を試行する最大回数を指定する整数。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`retryCycleDelay`|すぐに配信できなかったメッセージを配信しようとするときの、再試行サイクルの時間遅延を指定する TimeSpan 値です。  実際の待機時間はさらに長くなる場合があるため、この値で定義されるのは最小待機時間だけです。  既定値は、00:10:00 です。  詳細については、「<xref:System.ServiceModel.MsmqBindingBase.RetryCycleDelay%2A>」を参照してください。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`timeToLive`|メッセージの期限が切れて、配信不能キューに入れられるまでのメッセージの有効期間を指定する TimeSpan 値です。  既定値は 1.00:00:00 です。<br /><br /> この属性を設定すると、タイムリーなメッセージが受信側アプリケーションで処理される前に古くなることがなくなります。  キュー内のメッセージのうち、指定された期間内に受信アプリケーションで処理されなかったメッセージは、期限切れと呼ばれます。  期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。  配信不能キューの場所は、保証の内容に基づいて、`DeadLetterQueue` 属性を使用して設定されるか、適切な既定値に設定されます。|  
+|`usingActiveDirectory`|キューのアドレスを Active Directory を使用して変換する必要があるかどうかを指定するブール値。<br /><br /> MSMQ キューのアドレスは、パス名または直接形式名で構成できます。  直接形式名を使用する場合、MSMQ は、DNS、NetBIOS、または IP を使用してコンピューター名を解決します。  パス名を使用する場合、MSMQ は、Active Directory を使用してコンピューター名を解決します。<br /><br /> 既定では、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] キューに置かれているトランスポートは、メッセージ キューの URI を直接形式名に変換します。  `UseActiveDirectory` プロパティを true に設定すると、キューに置かれているトランスポートが DNS、NetBIOS、または IP ではなく Active Directory を使用してコンピューター名を解決する必要があることを、アプリケーションで指定できます。|  
+|`useMsmqTracing`|このバインディングにより処理されるメッセージをトレースするかどうかを指定するブール値です。  既定値は、`false` です。  トレースが有効な場合、メッセージ キュー コンピューターでメッセージが送受信されるたびに、レポート メッセージが作成され、レポート キューに送信されます。|  
+|`useSourceJournal`|このバインディングにより処理されるメッセージのコピーをソース ジャーナルに保存するかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> キューに置かれたアプリケーションでは、コンピューターの発信キューから送信されたメッセージの記録を残す場合は、メッセージをジャーナル キューにコピーできます。  メッセージが発信キューから送信され、送信先のコンピューターで受信されたという応答を受け取ると、メッセージのコピーが送信元のコンピューターのシステム ジャーナル キューに保持されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetMsmqSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ `netMsmqBinding` バインディングは、Microsoft Message Queuing \(MSMQ\) をトランスポートとして使用したキューのサポートを提供し、疎結合アプリケーション、失敗の切り分け、読み込みの均一化、および切断操作のサポートを有効にします。  これらの機能の詳細については、「[WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+    <bindings>  
+           <netMsmqBinding>  
+                <binding   
+                         closeTimeout="00:00:10"   
+                         openTimeout="00:00:20"   
+                         receiveTimeout="00:00:30"  
+                         sendTimeout="00:00:40"  
+                         deadLetterQueue="net.msmq://localhost/blah"   
+                         durable="true"   
+                         exactlyOnce="true"   
+                         maxReceivedMessageSize="1000"  
+                         maxRetries="11"  
+                         maxRetryCycles="12"   
+                         poisonMessageHandling="Disabled"   
+                         rejectAfterLastRetry="false"   
+                         retryCycleDelay="00:05:55"   
+                         timeToLive="00:11:11"   
+                         sourceJournal="true"  
+                         useMsmqTracing="true"  
+                         useActiveDirectory="true">  
+                         <security>  
+                             <message clientCredentialType="Windows" />  
+                         </security>  
+            </netMsmqBinding>  
+    </bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetMsmqBinding>   
+ <xref:System.ServiceModel.Configuration.NetMsmqBindingElement>   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md b/docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md
new file mode 100644
index 00000000000..c47412112de
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md
@@ -0,0 +1,164 @@
+---
+title: "&lt;netNamedPipeBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 00a8580b-face-47a4-838d-b9fed48e72df
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# &lt;netNamedPipeBinding&gt;
+コンピューター上のプロセス間通信に適した、セキュリティで保護された信頼できる最適バインディングを定義します。  既定では、信頼のための WS\-ReliableMessaging、転送セキュリティ用トランスポート セキュリティ、メッセージ配信用名前付きパイプ、およびバイナリ メッセージ エンコーディングを持つランタイム通信スタックを生成します。  
+  
+## 構文  
+  
+```  
+  
+<netNamedPipeBinding>  
+   <binding   
+      closeTimeout="TimeSpan"  
+      hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+      maxBufferPoolSize="Integer"  
+      maxBufferSize="Integer"  
+      maxConnections="Integer"   
+      maxReceivedMessageSize="Integer"  
+            name="string"  
+      openTimeout="TimeSpan"   
+      receiveTimeout="TimeSpan"  
+      sendTimeout="TimeSpan"  
+      transactionFlow="Boolean"  
+      transactionProtocol="OleTransactions/WS-AtomicTransactionOctober2004"  
+            transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+      <security mode="None/Transport">  
+            <transport  protectionLevel="None/Sign/EncryptAndSign" />  
+      </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netNamedPipeBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxBufferSize|メッセージをメモリに保存するのに使用するバッファーの最大サイズをバイト単位で指定する正の整数。  バッファーがいっぱいになると、超過データは、バッファーに空きが出るまで、基になるソケットに残されます。  この値が `maxReceivedMessageSize` 属性の値を下回らないようにしてください。  既定値は 65536 です。  詳細については、「<xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement.MaxBufferSize%2A>」を参照してください。|  
+|maxConnections|サービスが作成し受け付ける発信\/着信接続数の上限を指定する整数。  この属性により指定された別個の制限に対して、着信接続および発信接続がカウントされます。<br /><br /> 制限を超える着信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 制限を超える発信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 既定値は 10 です。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|transactionProtocol|このバインディングで使用されるトランザクション プロトコルを指定します。  有効な値は、次のとおりです。<br /><br /> -   OleTransactions<br />-   WS\-AtomicTransactionOctober2004<br /><br /> 既定値は OleTransactions です。  この属性は <xref:System.ServiceModel.TransactionProtocol> 型です。|  
+|transferMode|メッセージが要求や応答をバッファーするか、ストリーミングするかを指定する <xref:System.ServiceModel.TransferMode> 値です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netnamedpipebinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ `NetNamedPipeBinding` は、トランスポート セキュリティ、メッセージ配信用の名前付きパイプ、およびバイナリ メッセージ エンコーディングを使用するランタイム通信スタックを既定で生成します。  このバインディングは、コンピューター間通信に適した、WCF \(Windows Communication Foundation\) システム標準の選択肢です。  トランザクションもサポートします。  
+  
+ `NetNamedPipeBinding` の既定の構成は、`NetTcpBinding` によって提供される構成に似ていますが、それよりも単純です。この理由は、WCF の実装はコンピューター間での使用のみを目的としているので、公開される機能が少ないためです。  最も顕著な違いは、`securityMode` 設定に `None` オプションと `Transport` オプションしか用意されていないことです。  SOAP セキュリティ サポートは、オプションに含まれません。  このセキュリティ動作は、省略可能な `securityMode` 属性を使用して構成できます。  
+  
+## 使用例  
+ 次の例では、同じコンピューター上でのプロセス間通信を実現する NetNamedPipeBinding バインディングを示します。  名前付きパイプは、異なるコンピューター間では動作しません。  
+  
+ バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、`<endpoint>` 要素の `binding` 属性に指定します。  netNamedPipeBinding バインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、バインディング構成を `bindingConfiguration` 属性を使用して名前で参照します。  この例では、バインディングの構成の名前は Binding1 です。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- this endpoint is exposed at the base address provided by host: net.pipe://localhost/ServiceModelSamples/service  -->  
+        <endpoint address="net.pipe://localhost/ServiceModelSamples/service"  
+                  binding="netNamedPipeBinding"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is exposed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <netNamedPipeBinding>  
+        <binding   
+                 closeTimeout="00:01:00"  
+                 openTimeout="00:01:00"   
+                 receiveTimeout="00:10:00"   
+                 sendTimeout="00:01:00"  
+                 transactionFlow="false"   
+                 transferMode="Buffered"   
+                 transactionProtocol="OleTransactions"  
+                 hostNameComparisonMode="StrongWildcard"   
+                 maxBufferPoolSize="524288"  
+                 maxBufferSize="65536"   
+                 maxConnections="10"   
+                 maxReceivedMessageSize="65536">  
+          <security mode="Transport">  
+            <transport protectionLevel="EncryptAndSign" />  
+          </security>  
+        </binding>  
+      </netNamedPipeBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement>   
+ <xref:System.ServiceModel.NetNamedPipeBinding>   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md
new file mode 100644
index 00000000000..8e619352f08
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md
@@ -0,0 +1,116 @@
+---
+title: "&lt;netPeerTcpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "netPeerBinding 要素"
+ms.assetid: 2dd77ada-a176-47c7-a740-900b279f1aad
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# &lt;netPeerTcpBinding&gt;
+ピア チャネル固有の TCP メッセージングのバインディングを定義します。  
+  
+## 構文  
+  
+```  
+  
+<netPeerBinding>  
+    <binding name="string"  
+         closeTimeout="TimeSpan"  
+         openTimeout="TimeSpan"   
+         receiveTimeout="TimeSpan"  
+         sendTimeout="TimeSpan"  
+         listenIPAddress="String"  
+          maxBufferPoolSize="integer"  
+         maxReceiveMessageSize="Integer"   
+         port="Integer"  
+         <security mode="None/Transport/Message/TransportWithMessageCredential">  
+            <transport credentialType="Certificate/Password" />  
+        </security>  
+    </binding>  
+</netPeerBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|listenIPAddress|ピア ノードが TCP メッセージをリッスンする IP アドレスを指定する文字列です。  既定値は、`null` です。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|ポート|このバインディングがピア チャネルの TCP メッセージを処理するネットワーク インターフェイス ポートを指定する整数です。  この値の有効値の範囲は <xref:System.Net.IPEndPoint.MinPort> ～ <xref:System.Net.IPEndPoint.MaxPort> です。  既定値は 0 です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[\<resolver\>](../../../../../docs/framework/configure-apps/file-schema/wcf/resolver.md)|ピア メッシュ ID を解決してピア メッシュ内のノードのエンドポイント ID アドレスを取得するために、このバインディングによって使用されるピア リゾルバーを指定します。|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netpeerbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.PeerSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ このバインディングは、TCP を介したピア トランスポートを使用するピア ツー ピア アプリケーションまたはマルチパーティ アプリケーションの作成をサポートします。  各ピア ノードは、この種類のバイディングを使用して定義された複数のピア チャネルをホストできます。  
+  
+## 使用例  
+ 次の例では、ピア チャネルを使用してマルチパーティ通信を実現する、NetPeerTcpBinding バインディングを使用する方法を示します。  このバインディングの詳細な使用シナリオについては、「[Net Peer TCP](http://msdn.microsoft.com/ja-jp/31f4db66-edb2-40a6-b92a-14098e92acae)」を参照してください。  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+<bindings>  
+<netPeerBinding>  
+    <binding   
+         closeTimeout="00:00:10"  
+         openTimeout="00:00:20"   
+         receiveTimeout="00:00:30"  
+         sendTimeout="00:00:40"  
+         maxBufferSize="1001"  
+         maxConnections="123"   
+         maxReceiveMessageSize="1000">  
+        <reliableSession ordered="false"  
+            inactivityTimeout="00:02:00"  
+            enabled="true" />  
+        <security mode="TransportWithMessageCredential">  
+            <message clientCredentialType="CardSpace" />  
+        </security>  
+    </binding>  
+</netPeerBinding>  
+</bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetPeerTcpBinding>   
+ <xref:System.ServiceModel.Configuration.NetPeerTcpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [Net Peer TCP](http://msdn.microsoft.com/ja-jp/31f4db66-edb2-40a6-b92a-14098e92acae)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md
new file mode 100644
index 00000000000..6d694e4698c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md
@@ -0,0 +1,164 @@
+---
+title: "&lt;netTcpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "netTcpBinding 要素"
+ms.assetid: 5c5104a7-8754-4335-8233-46a45322503e
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# &lt;netTcpBinding&gt;
+複数コンピューターの通信に適し、セキュリティで保護されて信頼できる最適化されたバインディングを指定します。  既定では、メッセージ セキュリティと認証用 Windows セキュリティ、メッセージ配信用 TCP、およびバイナリ メッセージ エンコーディングを持つランタイム通信スタックを生成します。  
+  
+## 構文  
+  
+```  
+  
+<netTcpBinding>  
+   <binding   
+      closeTimeout="TimeSpan"  
+      hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+      listenBacklog="Integer"  
+      maxBufferPoolSize="integer"  
+      maxBufferSize="Integer"  
+      maxConnections="Integer"   
+      maxReceivedMessageSize="Integer"  
+      name="string"  
+      openTimeout="TimeSpan"  
+      portSharingEnabled="Boolean"  
+      receiveTimeout="TimeSpan"  
+      sendTimeout="TimeSpan"  
+      transactionFlow="Boolean"   
+      transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"   
+            transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+  
+      <reliableSession ordered="Boolean"  
+            inactivityTimeout="TimeSpan"  
+            enabled="Boolean" />  
+      <security mode="None/Transport/Message/Both">  
+            <message clientCredentialType="None/Windows/UserName/Certificate/CardSpace"  
+                defaultProtectionLevel="None/Sign/EncryptAndSign"   
+algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15" />  
+            <transport clientCredentialType="None/Windows/Certificate"  
+                protectionLevel="None/Sign/EncryptAndSign" />  
+      </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netTcpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|listenBacklog|リスナーで受け入れを待機するチャネルの最大数を指定する正の整数。  この制限を超えた接続は、制限内に空きができるまでキューに置かれます。  `connectionTimeout` 属性は、クライアントが接続を待つ時間を制限します。この時間が経過すると接続の例外をスローします。  既定値は 10 です。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 512 \* 1024 バイトです。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxBufferSize|メッセージをメモリに保存するのに使用するバッファーの最大サイズをバイト単位で指定する正の整数。<br /><br /> `transferMode` 属性が `Buffered` に等しい場合は、この属性が `maxReceivedMessageSize` 属性の値と等しくなっている必要があります。<br /><br /> `transferMode` 属性が `Streamed` に等しい場合は、この属性が `maxReceivedMessageSize` 属性の値以下であり、またヘッダーのサイズ以上である必要があります。<br /><br /> 既定値は 65536 です。  詳細については、「<xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement.MaxBufferSize%2A>」を参照してください。|  
+|maxConnections|サービスが作成し受け付ける発信\/着信接続数の上限を指定する整数。  この属性により指定された別個の制限に対して、着信接続および発信接続がカウントされます。<br /><br /> 制限を超える着信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 制限を超える発信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 既定値は 10 です。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|portSharingEnabled|TCP ポート共有をこの接続で有効にするかどうかを指定するブール値。  これが `false` の場合、各バインドは独自の排他ポートを使用します。  クライアントには影響しないため、この設定はサービスのみに関連します。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|transactionProtocol|このバインディングで使用されるトランザクション プロトコルを指定します。  有効な値は、次のとおりです。<br /><br /> -   OleTransactions<br />-   WSAtomicTransactionOctober2004<br /><br /> 既定値は OleTransactions です。  この属性は <xref:System.ServiceModel.TransactionProtocol> 型です。|  
+|transferMode|メッセージが要求や応答をバッファーするか、ストリーミングするかを指定する <xref:System.ServiceModel.TransferMode> 値です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetTcpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ このバインディングは、既定ではランタイム通信スタックを生成し、トランスポート セキュリティ、メッセージ配信用 TCP、およびバイナリ メッセージ エンコーディングを使用します。  このバインドは、イントラネット上の通信に適した [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] システム標準の選択肢です。  
+  
+ `netTcpBinding` の既定の構成は、`wsHttpBinding` が提供する構成よりも高速ですが、これは [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 対 [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 間の通信でのみ使用されることを目的としています。  このセキュリティ動作は、省略可能な `securityMode` 属性を使用して構成できます。  WS\-ReliableMessaging を使用するかどうかは、省略可能な `reliableSessionEnabled` 属性を使用して構成できます。  ただし、信頼できるメッセージングは、既定ではオフです。  `wsHttpBinding` や `basicHttpBinding` などの HTTP システム指定のバインディングは、既定では設定をオンにするように構成され、`netTcpBinding` バインディングは、既定では設定をオフにするように構成されているのが一般的であるため、たとえば、いずれかの WS\-\* 仕様のサポートを得るには、サポートを選択する必要があります。  これは、TCP の既定の構成の方が、HTTP バインディング用の既定の構成より、エンドポイント間でのメッセージ交換が高速になることを意味します。  
+  
+## 使用例  
+ バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、`<endpoint>` 要素の `binding` 属性に指定します。  netTcpBinding バインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、`bindingConfiguration` 属性を使用してバインディング構成を参照する必要があります。  次の例では、バインディング構成を定義します。  
+  
+```  
+<services>  
+  <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+    ...  
+    <endpoint address=""  
+              binding="netTcpBinding"  
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    ...  
+  </service>  
+</services>  
+  
+<bindings>  
+  <netTcpBinding>  
+    <binding   
+             closeTimeout="00:01:00"  
+             openTimeout="00:01:00"   
+             receiveTimeout="00:10:00"   
+             sendTimeout="00:01:00"  
+             transactionFlow="false"   
+             transferMode="Buffered"   
+             transactionProtocol="OleTransactions"  
+             hostNameComparisonMode="StrongWildcard"   
+             listenBacklog="10"  
+             maxBufferPoolSize="524288"   
+             maxBufferSize="65536"   
+             maxConnections="10"  
+             maxReceivedMessageSize="65536">  
+      <readerQuotas maxDepth="32"   
+                    maxStringContentLength="8192"   
+                    maxArrayLength="16384"  
+                    maxBytesPerRead="4096"   
+                    maxNameTableCharCount="16384" />  
+      <reliableSession ordered="true"   
+                       inactivityTimeout="00:10:00"  
+                       enabled="false" />  
+      <security mode="Transport">  
+        <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign" />  
+      </security>  
+    </binding>  
+  </netTcpBinding>  
+</bindings>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetTcpBinding>   
+ <xref:System.ServiceModel.Configuration.NetTcpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/nettcpcontextbinding.md b/docs/framework/configure-apps/file-schema/wcf/nettcpcontextbinding.md
new file mode 100644
index 00000000000..9259d23a447
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/nettcpcontextbinding.md
@@ -0,0 +1,117 @@
+---
+title: "&lt;netTcpContextBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d4715e1-5fff-4c3d-a226-18f21d0b30c4
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;netTcpContextBinding&gt;
+保護レベルの署名を求める <xref:System.ServiceModel.NetTcpBinding> のコンテキストを指定します。  NetTcpContextBinding の contextExchangeMechanism は、SOAPHeader です。  
+  
+## 構文  
+  
+```  
+  
+<netTcpContextBinding>  
+   <binding   
+      closeTimeout="TimeSpan"  
+            contextProtectionLevel="EncryptAndSign/None/Sign"  
+      hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+      listenBacklog="Integer"  
+      maxBufferPoolSize="integer"  
+      maxBufferSize="Integer"  
+      maxConnections="Integer"   
+      maxReceivedMessageSize="Integer"  
+            name="string"  
+      openTimeout="TimeSpan"  
+      portSharingEnabled="Boolean"  
+      receiveTimeout="TimeSpan"  
+      sendTimeout="TimeSpan"  
+      transactionFlow="Boolean"   
+      transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"   
+            transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+  
+      <reliableSession ordered="Boolean"  
+            inactivityTimeout="TimeSpan"  
+            enabled="Boolean" />  
+      <security mode="Message/None/Transport/TransportWithCredential">  
+           <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                realm="string"   
+                defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                defaultRealm="string" />  
+          <message clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+           algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+           establishSecurityContext="Boolean"   
+           negotiateServiceCredential="Boolean"/>  
+       </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+   </binding>  
+</netTcpContextBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|contextProtectionLevel|コンテキスト情報の反映に使用される SOAP ヘッダーの必要な保護レベルを指定する、有効な <xref:System.Net.Security.ProtectionLevel> 値。  既定値は `Sign` です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|listenBacklog|リスナーで受け入れを待機するチャネルの最大数を指定する正の整数。  この制限を超えた接続は、制限内に空きができるまでキューに置かれます。  `connectionTimeout` 属性は、クライアントが接続を待つ時間を制限します。この時間が経過すると接続の例外をスローします。  既定値は 10 です。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 512 \* 1024 バイトです。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxBufferSize|メッセージをメモリに保存するのに使用するバッファーの最大サイズをバイト単位で指定する正の整数。  バッファーがいっぱいになると、超過データは、バッファーに空きが出るまで、基になるソケットに残されます。  この値が `maxReceivedMessageSize` 属性の値を下回らないようにしてください。  既定値は 65536 です。  詳細については、「<xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement.MaxBufferSize%2A>」を参照してください。|  
+|maxConnections|サービスが作成し受け付ける発信\/着信接続数の上限を指定する整数。  この属性により指定された別個の制限に対して、着信接続および発信接続がカウントされます。<br /><br /> 制限を超える着信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 制限を超える発信接続は、制限内に空きができるまでキューに置かれます。<br /><br /> 既定値は 10 です。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|portSharingEnabled|TCP ポート共有をこの接続で有効にするかどうかを指定するブール値。  これが `false` の場合、各バインドは独自の排他ポートを使用します。  クライアントには影響しないため、この設定はサービスのみに関連します。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|transactionProtocol|このバインディングで使用されるトランザクション プロトコルを指定します。  有効な値は、次のとおりです。<br /><br /> -   OleTransactions<br />-   WSAtomicTransactionOctober2004<br /><br /> 既定値は OleTransactions です。  この属性は <xref:System.ServiceModel.TransactionProtocol> 型です。|  
+|transferMode|メッセージが要求や応答をバッファーするか、ストリーミングするかを指定する <xref:System.ServiceModel.TransferMode> 値です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NetTcpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.NetTcpBinding>   
+ <xref:System.ServiceModel.netTcpContextBinding>   
+ <xref:System.ServiceModel.Configuration.netTcpContextBindingElement>   
+ <xref:System.ServiceModel.Channels.ContextBindingElement>   
+ [\<netTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/oneway.md b/docs/framework/configure-apps/file-schema/wcf/oneway.md
new file mode 100644
index 00000000000..4ef00e81288
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/oneway.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;oneWay&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00e67e0e-77c0-4695-9138-c0997b0e5f3c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;oneWay&gt;
+カスタム バインディングのパケット ルーティングを有効にし、一方向メソッドを使用できるようにします。  
+  
+## 構文  
+  
+```  
+  
+<oneWay packetRoutable="Boolean">  
+        <channelPoolSettings  
+           idleTimeout"TimeSpan"  
+          leaseTimeout"TimeSpan"  
+          maxOutboundConnectionsPerEndpopint=”Integer” />  
+```  
+  
+```  
+  
+</oneWay>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`packetRoutable`|パケット ルーティングが有効かどうかを示すブール値。  既定値は、`false` です。|  
+|`MaxAcceptedChannels`|許容できるチャネルの最大数を指定する整数。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<channelPoolSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/channelpoolsettings.md)|現在のチャネルのチャネル プールのプロパティを格納する <xref:System.ServiceModel.Configuration.ChannelPoolSettingsElement> オブジェクト。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ パケット ルーティングを有効にするには、この要素が提供する "一方向の変換" 層が必要です。  カスタム バインディングを作成し、このバインディングをセッション対応または要求応答のトランスポートの上に重ねて、パケット ルーティング可能にすることができます。  この要素は、一方向メソッドをよりネイティブな形式で公開するときにも役に立ちます。  複合二重や信頼できるメッセージ機能などのさらに大きい変換は、この層に対して適用できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.OneWayBindingElement>   
+ <xref:System.ServiceModel.Configuration.OneWayElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/parameter.md b/docs/framework/configure-apps/file-schema/wcf/parameter.md
new file mode 100644
index 00000000000..01b026ac9d9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/parameter.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;parameter&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0fb41e2d-64f7-44ab-993e-05892eac6d82
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;parameter&gt;
+宣言された型がジェネリック型である場合、ジェネリック パラメーターを指定します。  
+  
+## 構文  
+  
+```  
+  
+<parameter index="integer"  
+                      type=String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|インデックス|宣言された型がジェネリック型である場合、既知の型を返すジェネリック パラメーターを指定します。|  
+|型|シリアル化と逆シリアル化で使用される既知の型を説明する文字列。|  
+  
+## index 属性  
+  
+|値|説明|  
+|-------|--------|  
+|"0"|ジェネリック型の最初のパラメーター。  たとえば、<xref:System.Collections.Generic.List%601> にはパラメーターが 1 つだけあります。  宣言型として使用される場合、index は "0" に設定されます。|  
+|"1"|ジェネリック型の 2 番目のパラメーター。  たとえば、<xref:System.Collections.Generic.Dictionary%602> には 2 つのパラメーターがあります。  2 番目のパラメーターによって既知の型が返される場合は、index 属性を "1" に設定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<knownType\>](../../../../../docs/framework/configure-apps/file-schema/wcf/knowntype.md)|宣言型のフィールドまたはプロパティによって返される既知の型を指定します。|  
+  
+## 解説  
+ 既知の型[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」および「<xref:System.Runtime.Serialization.DataContractSerializer>」を参照してください。  
+  
+ この要素の使用例については、「[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)」を参照してください。  
+  
+ この構成要素に、両方の属性を同時に設定することはできません。  両方の属性が設定された場合、<xref:System.Configuration.ConfigurationErrorsException> が発生します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-element.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-declaredtypes-element.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/participants-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/participants-of-wcf.md
new file mode 100644
index 00000000000..fab74e5ab41
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/participants-of-wcf.md
@@ -0,0 +1,99 @@
+---
+title: "WCF の &lt;participants&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d99dbddc-0057-4e18-8e42-f91411d39970
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;participants&gt;
+ランタイムから直接出力される追跡レコードをリッスンし、追跡レコードの構成方法に従って処理を行う追跡参加要素の一覧を構成します。  これには、特定の出力 \(ファイル、コンソール、ETW など\) への書き込み、レコードの処理や集計、またはその他の必要な組み合わせが含まれます。  
+  
+ ワークフロー追跡と追跡参加要素の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>   
+   <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+   </participants>   
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/add-of-participants.md)|追跡参加要素を処理するための設定が含まれます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<tracking\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md)|ワークフロー サービスの追跡設定を定義する構成セクションを表します。|  
+  
+## 解説  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+ 複数の追跡参加要素が追跡イベントを同時に使用することができます。  各追跡参加要素は、それぞれ別の追跡プロファイルと関連付けることができます。  
+  
+ 追跡レコードを ETW セッションに書き込む、標準の追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、`<diagnostics>` セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、`<add>` 要素の `profileName` 属性で定義されます。  これらが定義されると、追跡参加要素は `<etwTracking>` サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.TrackingSection>   
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehavior>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md b/docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md
new file mode 100644
index 00000000000..c3567f11126
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;clientCredentials&gt; 要素の &lt;peer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 505bd987-0042-4622-b68e-94f439729d53
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;clientCredentials&gt; 要素の &lt;peer&gt;
+ピアツーピア クライアントの認証時に使用される資格情報を指定します。  
+  
+## 構文  
+  
+```  
+  
+<peer>  
+  <certificate/>  
+  <peerAuthentication/>  
+  <messageSenderAuthentication/>  
+</peer>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<certificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/certificate-element.md)|ピアツーピア クライアントのメッセージの署名と暗号化に使用する X.509 証明書を指定します。  .|  
+|[\<peerAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peerauthentication-element.md)|ピア クライアントの認証オプションを指定します。|  
+|[\<messageSenderAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication-element.md)|メッセージ送信者の認証オプションを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ この構成要素は、ピア ノードがメッシュ内の他のノードに対して自身を認証するために使用する資格情報と、ピア ノードが他のピア ノードを認証するために使用する認証設定を指定します。  詳細については、「[Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)」および「[セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.Peer%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ClientCredentials.Peer%2A>   
+ <xref:System.ServiceModel.Security.PeerCredential>   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md
new file mode 100644
index 00000000000..facf298e059
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;serviceCredentials&gt; の &lt;peer&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b134e21d-e5b5-458e-9309-626dbf8db4ed
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;serviceCredentials&gt; の &lt;peer&gt;
+ピア ノードの現在の資格情報を指定します。  
+  
+## 構文  
+  
+```  
+  
+<peer>  
+  <certificate/>  
+  <peerAuthentication/>  
+  <messageSenderAuthentication/>  
+</peer>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<certificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/certificate-of-peer.md)|ピアツーピア サービスのメッセージの署名と暗号化に使用する X.509 証明書を指定します。  .|  
+|[\<messageSenderAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication.md)|メッセージ送信者の認証オプションを指定します。|  
+|[\<peerAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peerauthentication.md)|ピア サービスの認証オプションを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.Peer%2A>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.Peer%2A>   
+ <xref:System.ServiceModel.Security.PeerCredential>   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/peerauthentication-element.md b/docs/framework/configure-apps/file-schema/wcf/peerauthentication-element.md
new file mode 100644
index 00000000000..02e0895263b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/peerauthentication-element.md
@@ -0,0 +1,115 @@
+---
+title: "&lt;peerAuthentication&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09a8a9ff-e395-42f6-8ceb-9d44bdc1cbe1
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;peerAuthentication&gt; 要素
+ピアツーピア クライアントの認証オプションを指定します。  
+  
+ ピアツーピア プログラミング[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<peerAuthentication  
+customCertificateValidatorType = "namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+certificateValidationMode = "ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+revocationMode="NoCheck/Online/Offline"  
+trustedStoreLocation="CurrentUser/LocalMachine"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`customCertificateValidatorType`|省略可能な文字列。  カスタム型の検証に使用される型およびアセンブリです。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。|  
+|`certifcateValidationMode`|省略可能な列挙体です。  資格情報の検証に使用される 3 つのモードのいずれかを指定します。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。  既定値は、`ChainTrust` です。|  
+|`revocationMode`|省略可能な列挙体です。  証明書失効リスト \(CRL\) のチェックに使用されるモードのいずれかです。  既定値は、`Online` です。|  
+|`trustedStoreLocation`|省略可能な列挙体です。  2 つのシステム格納場所 \(`LocalMachine` または `CurrentUser`\) のいずれかです。  この値は、サービス証明書がクライアントにネゴシエートされるときに使用されます。  指定された格納場所の **\[信頼されたユーザー\]** ストアに対して検証が実行されます。  既定値は、`CurrentUser` です。|  
+  
+## customCertificateValidatorType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|タイプ名およびアセンブリと、タイプの検索に使用される他のデータを指定します。  少なくとも、名前空間とタイプ名が必要です。  省略可能な情報は、アセンブリ名、バージョン番号、カルチャ、および公開キー トークンです。|  
+  
+## certificateValidationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`None`、`PeerTrust`、`ChainTrust`、`PeerOrChainTrust`、`Custom` のいずれかの値にします。  既定値は、`ChainTrust` です。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## revocationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`NoCheck`、`Online`、`Offline` のいずれかの値にします。  既定値は、`Online` です。<br /><br /> 詳細については、「[証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。|  
+  
+## trustedStoreLocation 属性  
+  
+|値|説明|  
+|-------|--------|  
+|列挙型|`LocalMachine` または `CurrentUser` のいずれかの値にします。  既定値は、`CurrentUser` です。  クライアント アプリケーションがシステム アカウントで実行されている場合、証明書は通常 `LocalMachine` の下にあります。  クライアント アプリケーションがユーザー アカウントで実行されている場合、証明書は通常 `CurrentUser` の下にあります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-clientcredentials-element.md)|ピア サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 解説  
+ `<authentication>` 要素は、<xref:System.ServiceModel.Security.X509PeerCertificateAuthentication> クラスに対応します。  この要素は、メッシュ内の近隣ノード間の認証時に呼び出される検証コントロールを指定します。  新しいピアが近隣ノードとの接続を確立しようとするとき、自身の資格情報を応答側のピアに渡します。  リモート パーティの資格情報を検証するために、応答側の検証が呼び出されます。  メッシュ内でピア接続が確立されるたびに、両方のピアが相互に認証されます。つまり、双方の検証が呼び出されます。  
+  
+## 使用例  
+ 次のコードは、証明書検証モードを `PeerOrChainTrust` に設定します。  
+  
+```  
+<behaviors>  
+ <endpointBehaviors>  
+  <behavior name="MyEndpointBehavior">  
+   <clientCredentials>  
+    <peer>  
+     <certificate findValue="www.contoso.com"   
+                   storeLocation="LocalMachine"  
+                   x509FindType="FindByIssuerName" />  
+     <peerAuthentication   
+          certificateValidationMode="PeerOrChainTrust" />  
+     <messageSenderAuthentication certificateValidationMode="None" />  
+    </peer>  
+   </clientCredentials>  
+  </behavior>  
+</endpointBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>   
+ <xref:System.ServiceModel.Security.PeerCredential.PeerAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.PeerAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateAuthenticationElement>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/peerauthentication.md b/docs/framework/configure-apps/file-schema/wcf/peerauthentication.md
new file mode 100644
index 00000000000..1ff33cd5541
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/peerauthentication.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;peerAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad545e6f-f06e-4549-ac92-09d758d5c636
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;peerAuthentication&gt;
+ピア ノードで使用されるピア証明書の認証設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<peerAuthentication  
+      customCertificateValidatorType="namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"  
+      certificateValidationMode="ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"  
+      revocationMode="NoCheck/Online/Offline"  
+      trustedStoreLocation="CurrentUser/LocalMachine"   
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`certificateValidationMode`|省略可能な列挙体です。  資格情報の検証に使用される 3 つのモードのいずれかを指定します。  この属性は <xref:System.ServiceModel.Security.X509CertificateValidationMode> 型です。  `Custom` に設定されている場合、`customCertificateValidator` も指定する必要があります。|  
+|`customCertificateValidatorType`|省略可能な文字列。  ユーザー設定タイプの検証に使用されるタイプおよびアセンブリを指定します。  `certificateValidationMode` が `Custom` に設定されている場合は、この属性を設定する必要があります。  この属性は <xref:System.IdentityModel.Selectors.X509CertificateValidator> 型です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] には、信頼されたユーザーのストアに対してピア証明書を検証する既定のピア証明書検証が用意されており、  証明書が有効なルートまでつながっていることを検証します。  カスタム検証を実装して別の動作を指定したり、この属性を使用してカスタム検証を指定することができます。|  
+|`revocationMode`|省略可能な列挙体です。  証明書失効モードを指定します。  この属性は <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 型です。  システムは、ピア証明書を失効証明書リストで検索して、それが失効していないことを検証します。  このチェックは、オンラインで、またはキャッシュされた失効リストをチェックする方法で実行されます。  失効チェックは、この属性を NoCheck に設定することにより無効にできます。|  
+|`trustedStoreLocation`|省略可能な列挙体です。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] セキュリティ システムによりピア証明書を検証する、信頼されているユーザー ストアを指定します。  この属性は <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md)|ピア ノードの現在の資格情報を指定します。|  
+  
+## 解説  
+ `<authentication>` 要素は、<xref:System.ServiceModel.Security.X509PeerCertificateAuthentication> クラスに対応します。  この要素は、メッシュ内の近隣ノード間の認証時に呼び出される検証コントロールを指定します。  新しいピアが近隣ノードとの接続を確立しようとするとき、自身の資格情報を応答側のピアに渡します。  リモート パーティの資格情報を検証するために、応答側の検証が呼び出されます。  メッシュ内でピア接続が確立されるたびに、両方のピアが相互に認証されます。つまり、双方の検証が呼び出されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement>   
+ <xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>   
+ <xref:System.ServiceModel.Security.PeerCredential.PeerAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.PeerCredentialElement.PeerAuthentication%2A>   
+ <xref:System.ServiceModel.Configuration.X509PeerCertificateAuthenticationElement>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ピアツーピア ネットワーク](../../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)   
+ [Peer Channel Message Authentication](http://msdn.microsoft.com/ja-jp/80e73386-514e-4c30-9e4a-b9ca8c173a95)   
+ [Peer Channel Custom Authentication](http://msdn.microsoft.com/ja-jp/4aa8a82e-41a8-48e2-8621-7e1cbabdca7c)   
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/peertransport.md b/docs/framework/configure-apps/file-schema/wcf/peertransport.md
new file mode 100644
index 00000000000..bd1d0a26916
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/peertransport.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;peerTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1a5013a-9dd4-4a27-b114-795b8b323177
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;peerTransport&gt;
+カスタム バインディングのピア トランスポートを定義します。  
+  
+## 構文  
+  
+```  
+  
+<peerTransport   
+    listenIpAddress="String"  
+    maxBufferPoolSize="Integer"  
+    maxReceivedMessageSize="Integer"  
+    port="Integer"  
+        <security>  
+    </security>  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|listenIpAddress|ピア ノードが TCP メッセージをリッスンする IP アドレスを指定する文字列です。  既定値は、`null` です。|  
+|maxBufferPoolSize|バッファー プールの最大サイズを指定する正の整数です。  既定値は 524288 です。<br /><br /> WCF の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|ヘッダーなどのメッセージの最大サイズ \(バイト単位\) を定義する正の整数。  受信側にとってメッセージが大きすぎると、メッセージの送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|ポート|このバインディングがピア チャネルの TCP メッセージを処理するネットワーク インターフェイス ポートを指定する整数です。  この値の有効値の範囲は <xref:System.Net.IPEndPoint.MinPort> ～ <xref:System.Net.IPEndPoint.MaxPort> です。  既定値は 0 です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md)|このトランスポートのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.PeerSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ このトランスポートは、要求\/応答操作を含むコントラクトと共に使用することはできません。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerTransportElement>   
+ <xref:System.ServiceModel.Channels.PeerTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/persistabletype.md b/docs/framework/configure-apps/file-schema/wcf/persistabletype.md
new file mode 100644
index 00000000000..b2978fde64c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/persistabletype.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;persistableType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5425fe6-523a-4076-aab4-2c2515b1d830
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;persistableType&gt;
+すべての永続型を指定します。  
+  
+## 構文  
+  
+```  
+  
+<comContracts>  
+  <comContract>  
+      <persistableTypes>  
+         <persistableType id="string"  
+            name="string">  
+         </persistableType>  
+      </persistableTypes>  
+  </comContract>  
+</comContracts>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|id|永続型の一意の ID を指定する文字列を含む必須属性。|  
+|name|永続型の名前を指定する文字列を含む省略可能な属性。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<persistableTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/persistabletypes.md)|`persistableType` 要素のコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComPersistableTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComPersistableTypeElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/persistabletypes.md b/docs/framework/configure-apps/file-schema/wcf/persistabletypes.md
new file mode 100644
index 00000000000..aea94ceb22b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/persistabletypes.md
@@ -0,0 +1,27 @@
+---
+title: "&lt;persistableTypes&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d255097-45f0-4a04-945e-41d9bcfe8c54
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;persistableTypes&gt;
+このセクションには、`persistableType` 要素のコレクションが含まれています。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComPersistableTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComPersistableTypeElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/persistenceprovider.md b/docs/framework/configure-apps/file-schema/wcf/persistenceprovider.md
new file mode 100644
index 00000000000..510a51a7491
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/persistenceprovider.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;persistenceProvider&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a37049c5-a7ea-4519-94f2-912eeb010380
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;persistenceProvider&gt;
+使用する永続化プロバイダーの実装の型と、永続化操作に使用するタイムアウトを指定します。  
+  
+## 構文  
+  
+```  
+  
+<persistenceProvider persistenceOperationTimeout="TimeSpan"  
+   type="String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|persistenceOperationTimeout|永続化動作に使用するタイムアウトを指定する <xref:System.TimeSpan> 値。  既定値は “00:00:30” です。|  
+|型|使用する永続化プロバイダー ファクトリの型を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ この要素は、WCF サービスの状態をシリアル化するために使用される永続化プロバイダーを指定します。  HTTP ヘッダーに状態情報を渡す `wsHttpContextBinding` と一緒に使用する必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PersistenceProviderElement>   
+ <xref:System.ServiceModel.Persistence.PersistenceProvider>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/pnrppeerresolver.md b/docs/framework/configure-apps/file-schema/wcf/pnrppeerresolver.md
new file mode 100644
index 00000000000..7371d569a9f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/pnrppeerresolver.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;pnrpPeerResolver&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1b34f3b-68e5-4911-a367-de49fb61dbc6
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;pnrpPeerResolver&gt;
+リゾルバーとして PNRP \(Peer Name Resolution Protocol\) リゾルバーを使用することを指定します。  PNRP は既定のリゾルバーであるため、この要素は省略可能です。  
+  
+## 構文  
+  
+```  
+  
+<pnrpResolver resolverType="String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|resolverType|使用されるリゾルバーを指定する文字列。  この属性は省略できます。  設定されていない場合、または空の文字列に設定されている場合は、PNRP が使用されます。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 使用例  
+  
+```  
+<pnrpResolver resolverType="" />  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PnrpPeerResolverElement>   
+ <xref:System.ServiceModel.Channels.PnrpPeerResolverBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [ピア リゾルバー](../../../../../docs/framework/wcf/feature-details/peer-resolvers.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/policyimporter.md b/docs/framework/configure-apps/file-schema/wcf/policyimporter.md
new file mode 100644
index 00000000000..fa88f7267dd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/policyimporter.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;policyImporter&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0d03456-546f-44bb-ab12-1b2ce7f98fca
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;policyImporter&gt;
+バインディングに関するカスタム ポリシー アサーションのインポートを制御するポリシー インポーターを指定します。  
+  
+## 構文  
+  
+```  
+  
+<metadata>  
+   <policyImporters>  
+      <policyImporter type="string" />  
+   </policyImporters>  
+</metadata>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`type`|この要素の型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<policyImporters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/policyimporters.md)|バインディングに関するカスタム ポリシー アサーションのインポートを制御するすべてのポリシー インポーターを指定します。|  
+  
+## 解説  
+ ポリシー インポーターは、バインディング機能についてのカスタム ポリシー アサーションの検索、およびアサーションで必要となる機能を実装するカスタム バインディング要素の結び付けに使用されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PolicyImporterElementCollection>   
+ <xref:System.ServiceModel.Configuration.PolicyImporterElement>   
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ <xref:System.ServiceModel.Description.MetadataImporter>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/policyimporters.md b/docs/framework/configure-apps/file-schema/wcf/policyimporters.md
new file mode 100644
index 00000000000..b2952319fe4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/policyimporters.md
@@ -0,0 +1,28 @@
+---
+title: "&lt;policyImporters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8267a6f-bc09-4ec1-9b26-9445f137f663
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;policyImporters&gt;
+この構成要素は、バインディングに関するカスタム ポリシー アサーションのインポートを制御するすべてのポリシー インポーターを指定します。  各子要素は、バインディング機能についてのカスタム ポリシー アサーションの検索、およびアサーションで必要となる機能を実装するカスタム バインディング要素の結び付けに使用される \<`policyImporter`\> です。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ <xref:System.ServiceModel.Configuration.PolicyImporterElementCollection>   
+ <xref:System.ServiceModel.Description.MetadataImporter>   
+ [\<policyImporter\>](../../../../../docs/framework/configure-apps/file-schema/wcf/policyimporter.md)   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/privacynoticeat.md b/docs/framework/configure-apps/file-schema/wcf/privacynoticeat.md
new file mode 100644
index 00000000000..8b195979b6f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/privacynoticeat.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;privacyNoticeAt&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4cc96942-4eb9-4241-b2fd-45aa239915e8
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;privacyNoticeAt&gt;
+`wsFederationHttp` バインディングで使用されるプライバシーに関する声明を指定する構成要素を表します。  
+  
+## 構文  
+  
+```  
+  
+<privacyNotice url="String"  
+        version="Integer" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`url`|プライバシーに関する声明の場所を示す URI を指定する文字列。|  
+|`version`|このプライバシーに関する声明のバージョンを指定する整数。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PrivacyNoticeElement>   
+ <xref:System.ServiceModel.Channels.PrivacyNoticeBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/protocolmapping.md b/docs/framework/configure-apps/file-schema/wcf/protocolmapping.md
new file mode 100644
index 00000000000..4416ffe2e89
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/protocolmapping.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;protocolMapping&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5076644b-1f33-4f26-9488-87de9fcda04c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;protocolMapping&gt;
+トランスポート プロトコル スキーム \(http、net.tcp、net.pipe など\) と WCF バインディング間の既定のプロトコル マッピング セットを定義する構成セクションを表します。  実行時に既定のエンドポイントを作成するときに、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は構成されたマッピングを確認し、特定のベース アドレスに使用するバインディングを決定します。  
+  
+## 構文  
+  
+```vb  
+  
+<protocolMapping>  
+    <add binding="String”  
+         bindingConfiguration="String”  
+         scheme="http/net.msmq/net.pipe/net.tcp"/>  
+</protocolMapping>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md)|トランスポート プロトコル スキーム \(http、net.tcp、net.pipe など\) と WCF バインディング間の既定のプロトコル マッピングを格納します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.ServiceModel|すべての WCF 構成要素のルート要素です。|  
+  
+## 使用例  
+ 次の構成例は、machine.config ファイル内の既定のプロトコル マッピングを示しています。  machine.config ファイルを変更することで、既定のマッピングをコンピューター レベルでオーバーライドできます。  または、アプリケーションのスコープ内だけでオーバーライドする場合は、アプリケーション構成ファイルのこのセクションをオーバーライドし、各プロトコル スキームのマッピングを変更できます。  
+  
+```  
+  
+<protocolMapping>  
+        <add scheme="http" binding="basicHttpBinding"/>  
+        <add scheme="net.tcp" binding="netTcpBinding"/>  
+        <add scheme="net.pipe" binding="netNamedPipeBinding"/>  
+        <add scheme="net.msmq" binding="netMsmqBinding"/>  
+</protocolMapping>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Configuration.ProtocolMappingSection](assetId:///System.ServiceModel.Configuration.ProtocolMappingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Configuration.ProtocolMappingElement](assetId:///System.ServiceModel.Configuration.ProtocolMappingElement?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/reliablesession.md b/docs/framework/configure-apps/file-schema/wcf/reliablesession.md
new file mode 100644
index 00000000000..5031080b9b9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/reliablesession.md
@@ -0,0 +1,135 @@
+---
+title: "&lt;reliableSession&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 129b4a59-37f0-4030-b664-03795d257d29
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# &lt;reliableSession&gt;
+WS\-ReliableMessaging の設定を定義します。  この要素がカスタム バインディングに追加される場合、その結果となるチャネルにより、正確に 1 回の配信保証をサポートできます。  
+  
+## 構文  
+  
+```  
+  
+<reliableSession acknowledgementInterval="TimeSpan"  
+        flowControlEnabled="Boolean"   
+    inactivityTimeout="TimeSpan"  
+    maxPendingChannels="Integer"  
+    maxRetryCount="Integer"   
+        maxTransferWindowSize="Integer"  
+    reliableMessagingVersion="Default/WSReliableMessagingFebruary2005/WSReliableMessaging11"  
+    ordered="Boolean" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|acknowledgementInterval|そのポイントまで受信したメッセージの受信確認の送信をチャネルが待機する最大時間間隔を含む <xref:System.TimeSpan>。  既定値は 00:00:0.2 です。|  
+|flowControlEnabled|高度なフロー制御を有効にするかどうかを示すブール値。WS\-ReliableMessaging のフロー制御の Microsoft 固有の実装です。   既定値は、`true` です。|  
+|inactivityTimeout|他の通信相手がチャネルにメッセージを送信せずにいられる最長期間を指定する <xref:System.TimeSpan>。他の通信相手がメッセージを送信しない期間がこの値を超えると、チャネルでエラーが発生します。  既定値は 00:10:00 です。<br /><br /> チャネルでのアクティビティは、アプリケーションまたはインフラストラクチャのメッセージを受信するように定義されています。  このプロパティは、アクティブでないセッションを維持する最長期間を制御します。  反応のない時間がこれより長く経過すると、インフラストラクチャによってセッションは中止され、チャネルはエラーとなります。 **Note:**  アプリケーションでは定期的にメッセージを送信して接続を維持する必要はありません。|  
+|maxPendingChannels|受け入れるリスナーを待機できるチャネルの最大数を指定する整数。  この値は、1 ～ 16384 \(1 と 16384を含む\) のいずれかです。  既定値は 4 です。<br /><br /> チャネルは、受け入れを待っている間は保留状態になります。  制限に達すると、チャネルは作成されなくなります。  正確には、この数が \(保留状態のチャネルの受け入れによって\) 減少するまで、保留モードにされます。  これはファクトリごとの制限です。<br /><br /> しきい値に達した後に、リモート アプリケーションが新しい信頼できるセッションを確立しようとした場合、要求は拒否され、この原因となる open 操作でエラーが発生します。  この制限は、保留状態の送信チャネルの数には適用されません。|  
+|maxRetryCount|基になるチャネルで Send を呼び出すことで、信頼できるチャネルが受信確認を受信していないメッセージの再転送を試みる最大回数を指定する整数。<br /><br /> この値は、ゼロより大きい値である必要があります。  既定値は 8 です。<br /><br /> この値は、0 を超えた整数にする必要があります。  最後の再転送後に受信確認が受信されない場合、チャネルでエラーが発生します。<br /><br /> メッセージは、受信側でその配信が確認されている場合、転送されたと見なされます。<br /><br /> 転送済みのメッセージの受信確認が一定時間内に受信されない場合、インフラストラクチャは、自動的にそのメッセージを再転送します。  インフラストラクチャは、このプロパティで指定された回数まで、メッセージを再送信しようとします。  最後の再転送後に受信確認が受信されない場合、チャネルでエラーが発生します。<br /><br /> インフラストラクチャは、指数バックオフ アルゴリズムを使用し、計算された平均ラウンドトリップ時間に基づいて、いつ再転送するかを判断します。  時間は、まず再転送の 1 秒前に開始され、試行ごとに遅延が 2 倍にされます。この結果、最初の転送試行から最後の再転送試行までに約 8.5 分かかります。  最初の再転送試行のタイミングは、計算されたラウンドトリップ時間に従って調整されるので、試行にかかる時間延長はさまざまです。  これにより、再転送のタイミングをさまざまなネットワーク条件に動的に適用できます。|  
+|maxTransferWindowSize|バッファーの最大サイズを指定する整数。  有効値は 1 ～ 4096 の範囲です。<br /><br /> クライアントでは、この属性は、まだ受信側で受信が確認されていないメッセージを保持するために信頼できるチャネルが使用するバッファーの最大サイズを定義します。  クォータの単位はメッセージです。  バッファーがいっぱいになると、それ以降の SEND 操作がブロックされます。<br /><br /> 受信側では、この属性は、まだアプリケーションにディスパッチされていない受信メッセージを格納するためにチャネルが使用するバッファーの最大サイズを定義します。  バッファーがいっぱいになると、それ以降のメッセージは、受信側によって通知なしに自動的に削除されるので、クライアントによる再転送が必要になります。|  
+|ordered|メッセージが送信された順序で到着されることを保証するかどうかを指定するブール値。  この設定が `false` の場合、メッセージは送信された順序で到着しません。  既定値は、`true` です。|  
+|reliableMessagingVersion|使用する WS\-ReliableMessaging バージョンを指定する <xref:System.ServiceModel.ReliableMessagingVersion> の有効な値。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ 信頼できるセッションは、信頼できるメッセージとセッションに関する機能を提供します。  信頼できるメッセージは、エラー時に通信を再試行するほか、メッセージの順次到着などの配信の保証を指定できるようにします。  セッションでは、呼び出し間でクライアントの状態が保持されます。  この要素には、オプションとして、順序付けされたメッセージ配信を行う機能も用意されています。  この実装されたセッションは、SOAP およびトランスポート中継局を通過できます。  
+  
+ 各バインド要素は、メッセージの送信または受信時の処理手順を表します。  実行時に、バインディング要素は、メッセージの送受信に求められる送信および受信チャネル スタックを作成するために必要なチャネル ファクトリとリスナーを作成します。  `reliableSession` が提供するスタック内のオプションの層は、エンドポイント間に信頼できるセッションを確立し、このセッションの動作を構成することができます。  
+  
+ 詳細については、「[信頼できるセッション](../../../../../docs/framework/wcf/feature-details/reliable-sessions.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、さまざまなトランスポートとメッセージ エンコーディング要素を使用し、特に、クライアントの状態を保持し、配信順序を保証することを指定する、信頼できるセッションを有効化することによって、カスタム バインディングを構成する方法を示します。  この機能は、クライアントとサービスのアプリケーション構成ファイルで構成されます。  サービスの構成の例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- This endpoint is exposed at the base address provided by host: http://localhost/servicemodelsamples/service.svc  -->  
+        <!-- specify customBinding binding and a binding configuration to use -->  
+        <endpoint address=""  
+                  binding="customBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <!-- custom binding configuration - configures HTTP transport, reliable sessions -->  
+    <bindings>  
+      <customBinding>  
+        <binding name="Binding1">  
+          <reliableSession />  
+          <security authenticationMode="SecureConversation"  
+                     requireSecurityContextCancellation="true">  
+          </security>  
+          <compositeDuplex />  
+          <oneWay />  
+          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8" />  
+          <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"  
+                        hostNameComparisonMode="StrongWildcard"   
+                        proxyAuthenticationScheme="Anonymous" realm=""   
+                        useDefaultWebProxy="true" />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ReliableSessionElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.ReliableSessionBindingElement>   
+ [信頼できるセッション](../../../../../docs/framework/wcf/feature-details/reliable-sessions.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/remove-of-claimtyperequirements-element.md b/docs/framework/configure-apps/file-schema/wcf/remove-of-claimtyperequirements-element.md
new file mode 100644
index 00000000000..20a723d682b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/remove-of-claimtyperequirements-element.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;claimTypeRequirements&gt; 要素の &lt;remove&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ef05bc4-1950-4ee4-95c5-1c6a394eff7e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;claimTypeRequirements&gt; 要素の &lt;remove&gt;
+フェデレーション資格情報から削除するクレームの種類を指定します。  
+  
+## 構文  
+  
+```  
+  
+<claimTypeRequirements>  
+      <remove claimType="URI" />  
+</claimTypeRequirements>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|claimType|削除するクレームの種類を定義する URI。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<claimTypeRequirements\>](../../../../../docs/framework/configure-apps/file-schema/wcf/claimtyperequirements-for-message.md)|必須のクレームの種類のコレクションを指定します。  各要素は <xref:System.ServiceModel.Configuration.ClaimTypeElement> 型です。<br /><br /> フェデレーション シナリオでは、サービスが受信資格情報についての要件を記述します。  たとえば、受信資格情報は、特定のクレーム タイプのセットを処理する必要があります。  このコレクションの要素はそれぞれ、フェデレーション資格情報に表示されると予想される必須の要求および省略可能な要求の種類を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.ClaimTypeRequirements%2A>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElementCollection>   
+ <xref:System.ServiceModel.Configuration.ClaimTypeElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/resolver.md b/docs/framework/configure-apps/file-schema/wcf/resolver.md
new file mode 100644
index 00000000000..1131cd4461f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/resolver.md
@@ -0,0 +1,63 @@
+---
+title: "&lt;resolver&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0c00200c-f135-4e5c-a024-76b72bcbc021
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;resolver&gt;
+ピア メッシュ ID を解決してメッシュに参加する複数ノードを表すピア アドレス セットを取得するためにピア リゾルバーを指定します。  
+  
+## 構文  
+  
+```  
+  
+<resolver mode="Auto/Custom/Pnrp"  
+   referralPolicy="DoNotShare/Service/Share">  
+</resolver>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`mode`|このサービスに関連付けられるピア リゾルバー インスタンスが PNRP 固有、カスタム リゾルバー、自動的に決定されるのいずれであるかを指定する文字列。  この属性は <xref:System.ServiceModel.PeerResolvers.PeerResolverMode> 型です。|  
+|`referralPolicy`|ピア間で参照を共有する方法を指定する文字列。  この属性は <xref:System.ServiceModel.PeerResolvers.PeerReferralPolicy> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<headers\>](../../../../../docs/framework/configure-apps/file-schema/wcf/headers.md)|ユーザー設定のピア リゾルバー サービスの設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<netPeerTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)のすべてのバインディング機能を定義します。|  
+  
+## 解説  
+ ピア名リゾルバーは、ピア メッシュに参加するピア ノードを検索するためにピア チャネルにより使用される探索サービスです。  またピア名リゾルバーは、ノードをピア メッシュに登録するために使用されます。ピア メッシュは、ピア メッシュからピア ノードを認識し、使用可能にするための機構です。  ピア リゾルバーの詳細については、「[ピア リゾルバー](../../../../../docs/framework/wcf/feature-details/peer-resolvers.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.PeerResolver>   
+ <xref:System.ServiceModel.PeerResolvers.PeerResolverSettings>   
+ <xref:System.ServiceModel.NetPeerTcpBinding.Resolver%2A>   
+ <xref:System.ServiceModel.Configuration.NetPeerTcpBindingElement.Resolver%2A>   
+ <xref:System.ServiceModel.Configuration.PeerResolverElement>   
+ [ピア リゾルバー](../../../../../docs/framework/wcf/feature-details/peer-resolvers.md)   
+ [Adding a Custom Resolver to a PeerChannel Application](http://msdn.microsoft.com/ja-jp/12aa3787-2962-439c-ad27-46523c8b0419)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md b/docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md
new file mode 100644
index 00000000000..430e916e1e3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;serviceBehavior&gt; の &lt;routing&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8f9c844-4629-4a45-9599-856dc8f01794
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;serviceBehavior&gt; の &lt;routing&gt;
+ルーティング構成の動的な変更を可能にするルーティング サービスへの実行時アクセスを提供します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <routing filterTable=”String”  
+         routeOnHeadersOnly="Boolean"  
+         SoapProcessingEnabled=”Boolean” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|filterTable|ルーティング サービスによって評価されるフィルターを含むルーティング テーブルの名前を指定する文字列。  この値は、[\<filterTables\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filtertables.md) セクションにある [\<filterTable\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filtertable.md) 要素の `name` 属性の値と一致する必要があります。|  
+|routeOnHeaderOnly|フィルターがメッセージの本文とヘッダーの両方を調べるか、ヘッダーのみを調べるかを指定するブール値。  既定値は、`true` です。|  
+|soapProcessingEnabled|SOAP 処理を実行するかどうかを指定するブール値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ サービスの動作構成に追加すると、この構成要素により、サービスのルーティングが有効になります。  この要素には、サービスで使用される実際のルーティング テーブルを指定できます。  
+  
+ この構成セクションを使用すると、配置パターンの変更時にルーティング設定を変更できます。  実行時には、新しいルーティング設定を使用した独自のルーティング拡張を登録できます。ルーティング サービスは \(開始時に適用されていた規則に関係なく\) 更新済みの構成情報を使用して新たなメッセージとセッションにサービスを提供します。ただし、インフライトのメッセージやセッションには以前の規則が適用されます。このようにして、実行時において、セッション セーフでリサイクルの程度を抑えた状態でのルーティング サービスの再構成が可能となります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Routing.RoutingExtenstion>   
+ <xref:System.ServiceModel.Routing.Configuration.RoutingExtenstionElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/routing.md b/docs/framework/configure-apps/file-schema/wcf/routing.md
new file mode 100644
index 00000000000..0dc0368a826
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/routing.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;routing&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a210c209-3940-4288-9a8e-39b1e62606bc
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;routing&gt;
+受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルター セットと、フィルターが一致するときにメッセージを送信するターゲット エンドポイントを指定するルーティング テーブルを定義する構成セクションを表します。  
+  
+## 構文  
+  
+```vb  
+  
+<routing>  
+      <filters>  
+        <filter customType=”String”  
+                filterData=”String”  
+                filterType="Action/Address/AddressPrefix/And/Custom/Endpoint/MatchAll/XPath"   
+                name="String" />  
+      </filters>  
+      <routingTables>  
+        <table name="String">  
+          <entries>  
+            <add endpoint="String"   
+                 filterName="String"   
+                 priority="Integer" />  
+          </entries>  
+        </table>  
+      </routingTables>  
+</routing>  
+  
+```  
+  
+```csharp  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<filters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filters-of-routing.md)|受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] MessageFilter の種類を定義するルーティング フィルター セットを格納します。|  
+|[\<filterTables\>](../../../../../docs/framework/configure-apps/file-schema/wcf/filtertables.md)|ルーティング フィルターとターゲット エンドポイントとのマッピングを格納します。フィルターが一致したときにエンドポイントを指定するために使用されます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.ServiceModel|すべての WCF 構成要素のルート要素です。|  
+  
+## 参照  
+ [System.ServiceModel.Routing.Configuration.RoutingSection](assetId:///System.ServiceModel.Routing.Configuration.RoutingSection?qualifyHint=False&amp;autoUpgrade=True)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/rsa.md b/docs/framework/configure-apps/file-schema/wcf/rsa.md
new file mode 100644
index 00000000000..afdf300c5b9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/rsa.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;rsa&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae1f2267-e40d-42ff-8abf-06ab7067bdb9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;rsa&gt;
+この ID のエンドポイントに接続するセキュリティで保護された WCF クライアントは、サーバーから提示されたクレームに、この ID を構築するために使用された RSA 公開キーを含むクレームが含まれていることを検証します。  
+  
+## 構文  
+  
+```  
+  
+<rsa value = "String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|省略可能な文字列。  クライアントで比較される RSA 公開キー値。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|クライアントで認証するサービスの ID を指定します。|  
+  
+## 解説  
+ RSA チェックを行うと、その RSA キーまたは生成された独自の RSA キー値に基づいて、単一の証明書の認証を明確に制限できます。  これにより、RSA キーが変更された場合に既存のクライアントで使用できなくなるサービスを犠牲にして、特定の RSA キーをより厳しく認証できます。  
+  
+ ID を使用したクライアントに対するサービスの検証の詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 使用例  
+ 次の構成コードは、サーバーの認証に使用される X.509 証明書の公開キー値を指定します。  
+  
+```  
+<identity>  
+  <rsa value = "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"/>  
+</identity>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ <xref:System.ServiceModel.RsaEndpointIdentity>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md b/docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md
new file mode 100644
index 00000000000..41b99d3dbc4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;scopedCertificates&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7b6fc35-d4b2-4c18-98bd-83e09591f1d3
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;scopedCertificates&gt; 要素
+認証用の \(範囲指定された\) 特定のサービスにより提供される X.509 証明書のコレクションを表します。  このコレクションは一般に、フェデレーション シナリオでセキュリティ トークン サービスのサービス証明書を指定するために使用されます。  
+  
+## 構文  
+  
+```  
+  
+<scopedCertificates>  
+      <add findValue="String"  
+                storeLocation="CurrentUser/LocalMachine"  
+                storeName=" CurrentUser/LocalMachine"  
+                targetUri="string"  
+            x509Type="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />   
+</scopedCertificates>   
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md)|範囲指定された証明書のコレクションに X.509 証明書を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)|クライアントに対してサービスを認証する際に使用される証明書を指定します。|  
+  
+## 解説  
+ このコレクションを使用すると、クライアントは、通信するサービスの URL に基づいて、使用するサービス証明書を構成できます。  これは、クライアントが複数のサービス \(エンド サービスと中間セキュリティ トークン サービス\) と通信している可能性がある発行済みトークンのシナリオで特に便利です。  証明書に基づくメッセージ セキュリティを使用したバインドにおいて、この証明書を使用してサービスへのメッセージを暗号化します。サービスがクライアントへの応答に署名する際には、この証明書を使用することが要求されます。  
+  
+ バインディングにサービスの証明書が必要で、サービスの URL に対する特定の証明書が ScopedCertificates 内に存在しない場合は、既定の証明書が使用されます。  
+  
+ 詳細については、「[方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)」の「範囲指定された証明書」セクションを参照してください。  
+  
+## 使用例  
+ ドメイン名が http:\/\/www.contoso.com であるエンドポイントと HTTP プロトコルを経由して通信するときに使用するクライアントのサービス証明書を指定する例を次に示します。  
+  
+```  
+<serviceCertificate>  
+  <scopedCertificates>  
+     <add targetUri="http://www.contoso.com"   
+          findValue="www.contoso.com" storeLocation="LocalMachine"  
+                  storeName="Root" x509FindType="FindByIssuerName" />  
+  </scopedCertificates>  
+</serviceCertificate>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509RecipientCertificateClientElement.ScopedCertificates%2A>   
+ <xref:System.ServiceModel.Configuration.X509ScopedServiceCertificateElementCollection>   
+ <xref:System.ServiceModel.Configuration.X509ScopedServiceCertificateElement>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A>   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/scopes.md b/docs/framework/configure-apps/file-schema/wcf/scopes.md
new file mode 100644
index 00000000000..7a2ce3fa03f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/scopes.md
@@ -0,0 +1,59 @@
+---
+title: "&lt;scopes&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a0dd3ce-e383-4ac3-b7be-7d604388304a
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;scopes&gt;
+クエリの実行中に、サービス エンドポイントのフィルター処理に使用できるカスタム スコープ URI を指定する構成要素のコレクションを含んでいます。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <endpointBehaviors>  
+    <behavior name="String">  
+      <endpointDiscovery enable="Boolean">  
+        <scopes>  
+          <add scope="URI"/>  
+        </scopes>  
+      </endpointDiscovery>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|属性|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-scopes.md)|サービス検索の一致条件に使用できるエンドポイントのスコープ情報を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpointDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpointdiscovery.md)|エンドポイントのさまざまな探索設定を指定します \(探索可能性、スコープ、メタデータに対するカスタム拡張など\)。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/secureconversationauthentication-of-servicecredential.md b/docs/framework/configure-apps/file-schema/wcf/secureconversationauthentication-of-servicecredential.md
new file mode 100644
index 00000000000..d2e894c86ba
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/secureconversationauthentication-of-servicecredential.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;serviceCredential&gt; の &lt;secureConversationAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0bd3fac7-befd-4a45-ba51-c200b33be0fd
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;serviceCredential&gt; の &lt;secureConversationAuthentication&gt;
+安全な会話サービスの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<secureConversationAuthentication securityStateEncoderType="String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`securityStateEncoderType`|使用される <xref:System.ServiceModel.Security.SecurityStateEncoder> の型を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ この構成要素を使用して、セキュリティ コンテキスト トークン \(SCT\) クッキーのシリアル化のための既知のクレームの種類のリストと、クッキーの情報をエンコードしてセキュリティで保護するためのエンコーダーを指定します。  SCT の詳細については、「<xref:System.ServiceModel.Security.SecureConversationServiceCredential>」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.SecureConversationServiceElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.SecureConversationAuthentication%2A>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.SecureConversationAuthentication%2A>   
+ <xref:System.ServiceModel.Security.SecureConversationServiceCredential>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md b/docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md
new file mode 100644
index 00000000000..761ea3530de
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;secureConversationBootstrap&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66b46f95-fa2d-4b5b-b6ce-0572ab0cdd50
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# &lt;secureConversationBootstrap&gt;
+セキュリティで保護されたメッセージ交換サービスの開始に使用される既定値を指定します。  
+  
+## 構文  
+  
+```  
+  
+<secureConversationBootstrap  
+   allowSerializedSigningTokenOnReply="Boolean"  
+   authenticationMode="AuthenticationMode"  
+   defaultAlgorithmSuite="SecurityAlgorithmSuite"  
+   includeTimestamp="Boolean"  
+   requireDerivedKeys="Boolean"  
+   keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"   
+messageProtectionOrder="SignBeforeEncrypt/SignBeforeEncryptAndEncryptSignature/EncryptBeforeSign"  
+   messageSecurityVersion="WSSecurityJan2004/WSSecurityXXX2005"  
+   requireDerivedKeys="Boolean"  
+   requireSecurityContextCancellation="Boolean"  
+   requireSignatureConfirmation="Boolean" >  
+   securityHeaderLayout="Strict/Lax/LaxTimestampFirst/LaxTimestampLast"  
+   includeTimestamp="Boolean" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowSerializedSigningTokenOnReply`|省略可能です。  シリアル化されたトークンを応答で使用できる場合に指定するブール値。  既定値は `false` です。  二重バインドを使用する場合、この設定の既定値は `true` に設定され、行った設定はすべて無視されます。|  
+|`authenticationMode`|イニシエーターとレスポンダーの間で使用される SOAP 認証モードを指定します。<br /><br /> 既定値は sspiNegotiated です。<br /><br /> この属性は <xref:System.ServiceModel.Configuration.AuthenticationMode> 型です。|  
+|`defaultAlgorithmSuite`|セキュリティ アルゴリズム スイートは、正規化、ダイジェスト、キーラップ、署名、暗号化、およびキー派生の各アルゴリズムなど、さまざまなアルゴリズムを定義します。  各セキュリティ アルゴリズム スイートは、これらのさまざまなパラメーターの値を定義します。  メッセージ ベースのセキュリティは、これらのアルゴリズムを使用して実現されます。<br /><br /> この属性は、既定とは異なるアルゴリズムのセットを選択する別のプラットフォームで操作するときに使用されます。  この設定を修正する場合、関連するアルゴリズムの強さと脆弱性に注意する必要があります。  この属性は <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。  既定値は、`Basic256` です。|  
+|`includeTimestamp`|各メッセージにタイム スタンプが含まれるかどうかを指定するブール値です。  既定値は、`true` です。|  
+|`keyEntropyMode`|メッセージをセキュリティで保護するキーを計算する方法を指定します。  キーは、クライアント キー マテリアルのみ、サービス キー マテリアルのみ、または両方の組み合わせに基づいて生成できます。  次の値を指定できます。<br /><br /> -   ClientEntropy: セッション キーは、クライアントから提供されるキー マテリアルに基づいています。<br />-   ServerEntropy: セッション キーは、サービスから提供されるキー マテリアルに基づいています。<br />-   CombinedEntropy: セッション キーは、クライアントとサービスから提供されるキー マテリアルに基づいています。<br /><br /> 既定値は CombinedEntropy です。<br /><br /> この属性は <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> 型です。|  
+|`messageProtectionOrder`|メッセージ レベルのセキュリティ アルゴリズムをメッセージに適用する順序を設定します。  以下の値が有効です。<br /><br /> -   SignBeforeEncrypt: 最初に署名してから暗号化します。<br />-   SignBeforeEncryptAndEncryptSignature: 署名してから暗号化し、次に署名を暗号化します。<br />-   EncryptBeforeSign: 最初に暗号化してから署名します。<br /><br /> SignBeforeEncryptAndEncryptSignature は、WS\-Security 1.1 による相互証明書を使用する場合の既定値です。  SignBeforeEncrypt は、WS\-Security 1. 0 での既定値です。<br /><br /> この属性は <xref:System.ServiceModel.Security.MessageProtectionOrder> 型です。|  
+|`messageSecurityVersion`|使用される WS\-Security のバージョンを設定します。  以下の値が有効です。<br /><br /> -   WSSecurityJan2004<br />-   WSSecurityXXX2005<br /><br /> 既定値は WSSecurityXXX2005 です。  この属性は <xref:System.ServiceModel.MessageSecurityVersion> 型です。|  
+|`requireDerivedKeys`|キーを元の証明キーから派生できるかどうかを指定するブール値。  既定値は、`true` です。|  
+|`requireSecurityContextCancellation`|セキュリティ コンテキストが不要になったときにそれをキャンセルして終了する必要があるかどうかを指定するブール値。  既定値は、`true` です。|  
+|`requireSignatureConfirmation`|WS\-Security 署名確認を有効にするかどうかを指定するブール値です。  `true` に設定されている場合、メッセージ署名が応答側で確認されます。  既定値は、`false` です。<br /><br /> サービスが要求を完全に認識して応答していることを確認するために、署名確認を使用します。|  
+|`securityHeaderLayout`|セキュリティ ヘッダーでの要素の順序を指定します。  次の値を指定できます。<br /><br /> -   Strict。  "使用前に宣言する" という一般的な方針に従って、項目がセキュリティ ヘッダーに追加されます。<br />-   Lax。  WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。<br />-   LaxWithTimestampFirst。  WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。ただし、セキュリティ ヘッダーの最初の要素は wsse:Timestamp 要素である必要があります。<br />-   LaxWithTimestampLast。  WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。ただし、セキュリティ ヘッダーの最後の要素は wsse:Timestamp 要素である必要があります。<br /><br /> 既定値は Strict です。<br /><br /> この要素は <xref:System.ServiceModel.Channels.SecurityHeaderLayout> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md)|現在発行されているトークンを指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement> 型です。|  
+|[\<localClientSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md)|このバインディングのローカル クライアントのセキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.LocalClientSecuritySettingsElement> 型です。|  
+|[\<localServiceSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md)|このバインディングのローカル サービスのセキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.LocalServiceSecuritySettingsElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)|カスタム バインディングのセキュリティ オプションを指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.LocalServiceSecuritySettingsElement>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalServiceSettings%2A>   
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md
new file mode 100644
index 00000000000..26f8e95a086
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md
@@ -0,0 +1,80 @@
+---
+title: "&lt;ws2007FederationHttpBinding&gt; の &lt;security&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 826219b4-3a16-45fc-832d-0cd7cbbd3b84
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# &lt;ws2007FederationHttpBinding&gt; の &lt;security&gt; 要素
+[\<ws2007FederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md) 要素のセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<ws2007FederationBinding>  
+    <binding >  
+        <security mode="None/Message/TransportWithMessageCredential">  
+           <message negotiateServiceCredential="Boolean"  
+                algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/ Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                defaultProtectionLevel="none/sign/EncryptAndSign"   
+                issuedTokenType="string"   
+                issuedKeyType="SymmetricKey/PublicKey"  
+           </message>  
+        </security>  
+    </binding>  
+</ws2007FederationBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`mode`|省略可能です。  適用するセキュリティの種類を指定します。  既定値は `Message` です。  この属性は <xref:System.ServiceModel.WSFederationHttpSecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|SOAP メッセージは、転送中はセキュリティで保護されません。|  
+|メッセージ|SOAP メッセージ セキュリティを使用して、整合性、機密性、サーバー認証、およびクライアント認証を提供します。  既定では、本文は暗号化および署名されます。  サービスは、証明書を使用して構成する必要があります。  クライアント認証は、セキュリティ トークン サービスによってクライアントに発行されるトークンに基づいています。|  
+|TransportWithMessageCredential|整合性、機密性、およびサーバー認証は、HTTPS によって提供されます。  サービスは、証明書を使用して構成する必要があります。  クライアント認証は、SOAP メッセージ セキュリティによって提供され、セキュリティ トークン サービスによってクライアントに発行されるトークンに基づいています。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-ws2007httpbinding.md)|メッセージ レベル セキュリティの設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のすべてのバインディング機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.WSFederationHttpSecurity>   
+ <xref:System.ServiceModel.WSFederationHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement>   
+ [方法 : WSFederationHttpBinding を作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md
new file mode 100644
index 00000000000..661008bb4e9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;basicHttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6432708d-5465-4bd9-bfc2-466742db99cb
+caps.latest.revision: 16
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 16
+---
+# &lt;basicHttpBinding&gt; の &lt;security&gt;
+[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のセキュリティ機能を定義します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="Message/None/Transport/TransportWithCredential">  
+   <transport  
+      clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+      proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+      realm="string" />  
+   <message  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            clientCredentialType="Certificate/IssuedToken/None/UserName/Windows" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|省略可能です。  使用されるセキュリティの種類を指定します。  既定値は、`None` です。  この属性は <xref:System.ServiceModel.BasicHttpSecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|-   メッセージは、転送中はセキュリティで保護されません。|  
+|Transport|セキュリティは、HTTPS トランスポートを使用して提供されます。  SOAP メッセージは、HTTPS を使用したセキュリティで保護されます。  サービスは、サービスの X.509 証明書を使用してクライアントに認証されます。  クライアントは、提供される ClientCredentialType を使用して認証されます。  「[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md)」を参照してください。|  
+|メッセージ|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。  既定では、本文は暗号化および署名されます。  このバインディングの場合、サーバー証明書をクライアントの帯域外で提供するように要求されます。  このバインディングの唯一の有効な `ClientCredentialType` は、`Certificate` です。|  
+|TransportWithMessageCredential|整合性、機密性、およびサーバー認証は、トランスポート セキュリティによって提供されます。  クライアント認証は、SOAP メッセージ セキュリティで提供されます。  このモードは、ユーザーがユーザー名およびパスワードを使用して認証し、メッセージ転送をセキュリティで保護するために既存の HTTP が配置されている場合に関連します。|  
+|TransportCredentialOnly|このモードは、メッセージの整合性と機密性を提供しません。  http ベースのクライアント認証を提供します。  このモードを使用するときは、十分に注意する必要があります。  トランスポート セキュリティが他の方法 \(IPSec など\) で提供され、クライアント認証だけが [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] インフラストラクチャで提供されている環境で使用する必要があります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md)|基本 HTTP サービスのトランスポート セキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.HttpTransportSecurity> に対応しています。|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-basichttpbinding.md)|基本 HTTP サービスのメッセージ セキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.BasicHttpMessageSecurity> に対応しています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のバインディング要素です。|  
+  
+## 解説  
+ 既定では、SOAP メッセージはセキュリティで保護されず、クライアントは認証されません。  この要素を使用すると、`basicHttpBinding` 要素に追加のセキュリティ設定を構成できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.BasicHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement>   
+ <xref:System.ServiceModel.BasicHttpSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md
new file mode 100644
index 00000000000..676ed0998cd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md
@@ -0,0 +1,185 @@
+---
+title: "&lt;customBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 243a5148-bbd1-447f-a8a5-6e7792c0a3f1
+caps.latest.revision: 24
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 24
+---
+# &lt;customBinding&gt; の &lt;security&gt;
+カスタム バインディングのセキュリティ オプションを指定します。  
+  
+## 構文  
+  
+```  
+  
+<security   
+   allowSerializedSigningTokenOnReply="Boolean"  
+   authenticationMode="AuthenticationMode"  
+      defaultAlgorithmSuite="SecurityAlgorithmSuite"  
+   includeTimestamp="Boolean"  
+      requireDerivedKeys="Boolean"  
+   keyEntropyMode="ClientEntropy/ServerEntropy/CombinedEntropy"   
+messageProtectionOrder="SignBeforeEncrypt/SignBeforeEncryptAndEncryptSignature/EncryptBeforeSign"  
+      messageSecurityVersion="WSSecurityJan2004/WSSecurityXXX2005"  
+   requireDerivedKeys="Boolean"  
+   requireSecurityContextCancellation="Boolean"  
+   requireSignatureConfirmation="Boolean"  
+      securityHeaderLayout=  
+              "Strict/Lax/LaxTimestampFirst/LaxTimestampLast"  
+   includeTimestamp="Boolean">  
+   <issuedTokenParameters />  
+   <localClientSettings />  
+   <localServiceSettings />  
+   <secureConversationBootstrap />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowSerializedSigningTokenOnReply|省略可能です。  シリアル化されたトークンを応答で使用できる場合に指定するブール値。  既定値は `false` です。  二重バインドを使用する場合、この設定の既定値は `true` に設定され、行った設定はすべて無視されます。|  
+|authenticationMode|省略可能です。  イニシエーターとレスポンダーの間で使用される認証モードを指定します。  すべての値については、以下を参照してください。<br /><br /> 既定値は、`sspiNegotiated` です。|  
+|defaultAlgorithmSuite|省略可能です。  メッセージの暗号化とキー ラップ アルゴリズムを設定します。  アルゴリズムとキー サイズは、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> クラスにより決まります。  これらのアルゴリズムは、Security Policy Language \(WS\-SecurityPolicy\) の仕様で指定されているアルゴリズムに対応付けられています。<br /><br /> 指定できる値を以下に示します。  既定値は `Basic256` です。<br /><br /> この属性は、既定とは異なるアルゴリズムのセットを選択する別のプラットフォームで操作するときに使用されます。  この設定を修正する場合、関連するアルゴリズムの強さと脆弱性に注意する必要があります。  この属性は <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> 型です。|  
+|includeTimestamp|各メッセージにタイム スタンプが含まれるかどうかを指定するブール値です。  既定値は、`true` です。|  
+|keyEntropyMode|メッセージをセキュリティで保護するキーを計算する方法を指定します。  キーは、クライアント キー マテリアルのみ、サービス キー マテリアルのみ、または両方の組み合わせに基づいて生成できます。  有効な値は、次のとおりです。<br /><br /> -   `ClientEntropy`: セッション キーは、クライアントから提供されるキー データに基づいています。<br />-   `ServerEntropy`: セッション キーは、サーバーから提供されるキー データに基づいています。<br />-   `CombinedEntropy`: セッション キーは、クライアントとサービスから提供されるキー データに基づいています。<br /><br /> 既定値は、`CombinedEntropy` です。<br /><br /> この属性は <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> 型です。|  
+|messageProtectionOrder|メッセージ レベルのセキュリティ アルゴリズムをメッセージに適用する順序を設定します。  以下の値が有効です。<br /><br /> -   `SignBeforeEncrypt`: 最初に署名してから暗号化します。<br />-   `SignBeforeEncryptAndEncryptSignature`: 最初に署名してから暗号化し、次に署名を暗号化します。<br />-   `EncryptBeforeSign`: 最初に暗号化してから署名します。<br /><br /> 既定値は、使用している WS\-Security のバージョンによって異なります。  WS\-Security 1.1 を使用する場合、既定値は `SignBeforeEncryptAndEncryptSignature` です。  WS\-Security 1.0 を使用する場合、既定値は `SignBeforeEncrypt` です。<br /><br /> この属性は <xref:System.ServiceModel.Security.MessageProtectionOrder> 型です。|  
+|messageSecurityVersion|省略可能です。  使用される WS\-Security のバージョンを設定します。  以下の値が有効です。<br /><br /> -   WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11<br />-   WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10<br />-   WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10<br /><br /> 既定は、WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11 であり、単純に `Default` として XML で表現できます。  この属性は <xref:System.ServiceModel.MessageSecurityVersion> 型です。|  
+|requireDerivedKeys|キーを元の証明キーから派生できる場合に指定するブール値。  既定値は、`true` です。|  
+|requireSecurityContextCancellation|省略可能です。  セキュリティ コンテキストが不要になったときにそれをキャンセルして終了する必要がある場合に指定するブール値。  既定値は、`true` です。|  
+|requireSignatureConfirmation|省略可能です。  WS\-Security 署名確認を有効にするかどうかを指定するブール値です。  `true` に設定されている場合、メッセージ署名が応答側で確認されます。  カスタム バインディングが相互証明書に対して構成されているか、発行されたトークンを使用するように構成されている場合 \(WSS 1.1 バインド\)、この属性の既定値は `true` です。  それ以外の場合、既定値は `false` になります。<br /><br /> サービスが要求を完全に認識して応答していることを確認するために、署名確認を使用します。|  
+|securityHeaderLayout|省略可能です。  セキュリティ ヘッダーでの要素の順序を指定します。  有効な値は、次のとおりです。<br /><br /> -   `Strict` : "使用前に宣言する" という一般的な方針に従って、項目がセキュリティ ヘッダーに追加されます。<br />-   `Lax`: WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。<br />-   `LaxWithTimestampFirst`: WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。ただし、セキュリティ ヘッダーの最初の要素は wsse:Timestamp 要素である必要があります。<br />-   `LaxWithTimestampLast`: WSS: SOAP メッセージ セキュリティに準じた任意の順序で、項目はセキュリティ ヘッダーに追加されます。ただし、セキュリティ ヘッダーの最後の要素は wsse:Timestamp 要素である必要があります。<br /><br /> 既定値は、`Strict` です。<br /><br /> この要素は <xref:System.ServiceModel.Channels.SecurityHeaderLayout> 型です。|  
+  
+## authenticationMode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|String|`AnonymousForCertificate`<br /><br /> `AnonymousForSslNegotiated`<br /><br /> `CertificateOverTransport`<br /><br /> `IssuedToken`<br /><br /> `IssuedTokenForCertificate`<br /><br /> `IssuedTokenForSslNegotiated`<br /><br /> `IssuedTokenOverTransport`<br /><br /> `Kerberos`<br /><br /> `KerberosOverTransport`<br /><br /> `MutualCertificate`<br /><br /> `MutualCertificateDuplex`<br /><br /> `MutualSslNegotiated`<br /><br /> `SecureConversation`<br /><br /> `SspiNegotiated`<br /><br /> `UserNameForCertificate`<br /><br /> `UserNameForSslNegotiated`<br /><br /> `UserNameOverTransport`<br /><br /> `SspiNegotiatedOverTransport`|  
+  
+## defaultAlgorithm 属性  
+  
+|値|説明|  
+|-------|--------|  
+|Basic128|Aes128 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192|Aes192 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256|Aes256 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDes|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesRsa15|TripleDes 暗号化を使用し、メッセージ ダイジェストには Sha1 を、キー ラップには Rsa15 を使用します。|  
+|Basic128Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic192Sha256|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic256Sha256|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|TripleDesSha256|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa\-oaep\-mgf1p を使用します。|  
+|Basic128Sha256Rsa15|メッセージの暗号化には Aes128 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic192Sha256Rsa15|メッセージの暗号化には Aes192 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|Basic256Sha256Rsa15|メッセージの暗号化には Aes256 を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+|TripleDesSha256Rsa15|メッセージの暗号化には TripleDes を使用し、メッセージ ダイジェストには Sha256 を、キー ラップには Rsa15 を使用します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<issuedTokenParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md)|現在発行されているトークンを指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenParametersElement> 型です。|  
+|[\<localClientSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md)|このバインディングのローカル クライアントのセキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.LocalClientSecuritySettingsElement> 型です。|  
+|[\<localServiceSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md)|このバインディングのローカル サービスのセキュリティ設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.LocalServiceSecuritySettingsElement> 型です。|  
+|[\<secureConversationBootstrap\>](../../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)|セキュリティで保護されたメッセージ交換サービスの開始に使用される既定値を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ この要素の使い方[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[SecurityBindingElement 認証モード](../../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)」および「[方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、カスタム バインディングを使用してセキュリティを構成する方法を示します。  カスタム バインディングを使用して、セキュリティで保護されたトランスポートと共にメッセージ レベルのセキュリティを有効にする方法を示します。  これは、クライアントとサービス間でメッセージを転送する際にセキュリティで保護されたトランスポートが必要であると同時に、そのメッセージをメッセージ レベルでセキュリティ保護する必要がある場合に便利です。  この構成は、システム指定のバインディングではサポートされていません。  
+  
+ サービス構成では、TLS\/SSL プロトコルを使用して保護される TCP 通信、および Windows メッセージ セキュリティをサポートするカスタム バインディングが定義されます。  カスタム バインディングはサービス証明書を使用して、トランスポート レベルでサービスを認証し、クライアントとサービス間で転送中のメッセージを保護します。  これは [\<sslStreamSecurity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md) バインディング要素によって実現されます。  サービスの証明書は、サービス動作を使用して構成されます。  
+  
+ さらに、カスタム バインディングは Windows 資格情報の種類 \(既定の資格情報の種類\) によるメッセージ セキュリティを使用します。  これは [security](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) バインディング要素によって実現されます。  Kerberos 認証機構が利用できる場合は、クライアントとサービスはどちらもメッセージ レベルのセキュリティを使用して認証されます。  Kerberos 認証機構が利用できない場合は、NTLM 認証が使用されます。  NTLM はサービスに対してクライアントを認証しますが、クライアントに対するサービスの認証は行いません。  [security](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) バインディング要素は `SecureConversation` authenticationType を使用するように構成されます。この結果、クライアントとサービスの両方でセキュリティ セッションが作成されます。  これは、サービスの双方向コントラクトを動作させるために必要です。  この例の実行の詳細については、「[カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)」を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <!-- use following base address -->  
+            <add baseAddress="net.tcp://localhost:8000/ServiceModelSamples/Service"/>  
+          </baseAddresses>  
+        </host>  
+        <endpoint address=""  
+                    binding="customBinding"  
+                    bindingConfiguration="Binding1"   
+                    contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />  
+        <!-- the mex endpoint is exposed at net.tcp://localhost:8000/ServiceModelSamples/service/mex -->  
+        <endpoint address="mex"  
+                  binding="mexTcpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <!-- configure a custom binding -->  
+      <customBinding>  
+        <binding name="Binding1">  
+          <security authenticationMode="SecureConversation"  
+                     requireSecurityContextCancellation="true">  
+          </security>  
+          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8"/>  
+          <sslStreamSecurity requireClientCertificate="false"/>  
+          <tcpTransport/>  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName"/>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.SecurityElement>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [カスタム バインディング セキュリティ](../../../../../docs/framework/wcf/samples/custom-binding-security.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-msmqintegrationbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-msmqintegrationbinding.md
new file mode 100644
index 00000000000..cffdc1e30c1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-msmqintegrationbinding.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;msmqIntegrationBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae5c68a8-14a2-4c6e-b9e0-3e94e3e9135e
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# &lt;msmqIntegrationBinding&gt; の &lt;security&gt;
+メッセージ キュー \(MSMQ\) 統合チャネルのトランスポート セキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<msmqIntegrationBinding>  
+   <binding>   
+       <security mode="None/Transport">  
+         <transport msmqAuthenticationMode="None/Windows/Certificate"  
+            msmqEncryptionAlgorithm="RC4Stream/AES"  
+            msmqProtectionLevel="None/Sign/EncryptAndSign"  
+            msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+          <message  algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"  
+                        clientCredentialType="None/Windows/UserName/Certificate/CardSpace"  
+            defaultProtectionLevel="None/Sign/EncryptAndSign" />  
+       </security>  
+   </binding>  
+</msmqIntegrationBinding>   
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|メッセージ キュー統合チャネルの整合性、機密性、および認証を制御するセキュリティの種類を指定します。  以下の値が有効です。<br /><br /> -   None: セキュリティは無効になります。<br />-   Transport: 保護と認証はトランスポートが提供します。  これは、2 つのキュー マネージャー間のメッセージ セキュリティに適用されます。  アプリケーションとキュー マネージャーとの間にセキュリティは提供されません。  既存の Msmq アプリケーションは、この種類のセキュリティ モードと機能的に等価です。<br /><br /> 既定値は `Transport` です。  この属性は <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationSecurityMode> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-msmqintegrationbinding.md)|メッセージ キュー統合トランスポートのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<msmqIntegrationBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md)のバインディング要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MsmqIntegrationSecurityElement>   
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.MsmqIntegrationBindingElement.Security%2A>   
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationSecurity>   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [\<msmqIntegrationBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-nethttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-nethttpbinding.md
new file mode 100644
index 00000000000..ed052fa7b0c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-nethttpbinding.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;netHttpBinding&gt; の &lt;security | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dc41f6f7-cabc-4a64-9fa0-ceabf861b348
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;netHttpBinding&gt; の &lt;security
+[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のセキュリティ機能を定義します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="Message/None/Transport/TransportWithCredential">  
+   <transport  
+      clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+      proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+      realm="string" />  
+   <message  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            clientCredentialType="Certificate/IssuedToken/None/UserName/Windows" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|省略可能です。  使用されるセキュリティの種類を指定します。  既定値は、`None` です。  この属性は <xref:System.ServiceModel.NetHttpSecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|-   メッセージは、転送中はセキュリティで保護されません。|  
+|Transport|セキュリティは、HTTPS トランスポートを使用して提供されます。  SOAP メッセージは、HTTPS を使用したセキュリティで保護されます。  サービスは、サービスの X.509 証明書を使用してクライアントに認証されます。  クライアントは、提供される ClientCredentialType を使用して認証されます。|  
+|メッセージ|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。  既定では、本文は暗号化および署名されます。  このバインディングの場合、サーバー証明書をクライアントの帯域外で提供するように要求されます。  このバインディングの唯一の有効な `ClientCredentialType` は、`Certificate` です。|  
+|TransportWithMessageCredential|整合性、機密性、およびサーバー認証は、トランスポート セキュリティによって提供されます。  クライアント認証は、SOAP メッセージ セキュリティで提供されます。  このモードは、ユーザーがユーザー名およびパスワードを使用して認証し、メッセージ転送をセキュリティで保護するために既存の HTTP が配置されている場合に関連します。|  
+|TransportCredentialOnly|このモードは、メッセージの整合性と機密性を提供しません。  http ベースのクライアント認証を提供します。  このモードを使用するときは、十分に注意する必要があります。  トランスポート セキュリティが他の方法 \(IPSec など\) で提供され、クライアント認証だけが [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] インフラストラクチャで提供されている環境で使用する必要があります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-nethttpbinding.md)|基本 HTTP サービスのトランスポート セキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.HttpTransportSecurity> に対応しています。|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-nethttpbinding.md)|基本 HTTP サービスのメッセージ セキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.NetHttpMessageSecurity> に対応しています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のバインディング要素です。|  
+  
+## 解説  
+ 既定では、SOAP メッセージはセキュリティで保護されず、クライアントは認証されません。  この要素を使用すると、`netHttpBinding` 要素に追加のセキュリティ設定を構成できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.NetHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetHttpSecurityElement>   
+ <xref:System.ServiceModel.NetHttpSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md
new file mode 100644
index 00000000000..f801cf23aab
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;netMsmqBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 001d11a9-7439-498c-b09d-fca20eaf8cd3
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# &lt;netMsmqBinding&gt; の &lt;security&gt;
+MSMQ バインディングのセキュリティ設定を定義します。  トランスポートまたは SOAP セキュリティが有効であるかどうか、および有効である場合は、どの認証モードと保護レベルを使用するかを指定します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="None/Transport/Message/Both">  
+   <transport msmqAuthenticationMode="None/WindowsDomain/Certificate"  
+      msmqEncryptionAlgorithm="RC4Stream/AES"  
+      msmqProtectionLevel="None/Sign/EncryptAndSign"  
+      msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+      <message  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+      clientCredentialType="None/Windows/UserName/Certificate/CardSpace"/>  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|整合性、機密性、および認証を制御するセキュリティの種類を指定します。  以下の値が有効です。<br /><br /> -   None: セキュリティは無効になります。<br />-   Transport: 保護と認証はトランスポートが提供します。  これは、2 つのキュー マネージャー間のメッセージ セキュリティに適用されます。  アプリケーションとキュー マネージャーとの間にセキュリティは提供されません。  既存の Msmq アプリケーションは、この種類のセキュリティ モードと機能的に等価です。<br />-   Message: エンドツーエンドのアプリケーション セキュリティを指定します。  トランスポート層で提供されるセキュリティありません。  これは、他の標準バインディングによって提供されたセキュリティと同様です。<br />-   Both: トランスポートと SOAP メッセージング レイヤーの両方でセキュリティを提供します。  同じ資格情報が、両方のレベルで要求されます。<br /><br /> 既定値は、Transport です。  この属性は <xref:System.ServiceModel.NetMsmqSecurityMode> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-netmsmqbinding.md)|SOAP メッセージのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.MessageSecurityOverMsmqElement> 型です。|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-netmsmqbinding.md)|MSMQ トランスポートのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|[\<netMsmqBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md) のバインディング要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.NetMsmqSecurityElement>   
+ <xref:System.ServiceModel.NetMsmqBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetMsmqBindingElement.Security%2A>   
+ <xref:System.ServiceModel.NetMsmqSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-netnamedpipebinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-netnamedpipebinding.md
new file mode 100644
index 00000000000..3aeecda4c4e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-netnamedpipebinding.md
@@ -0,0 +1,66 @@
+---
+title: "&lt;netNamedPipeBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb3cb022-637e-49fd-92e8-6766038affa7
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# &lt;netNamedPipeBinding&gt; の &lt;security&gt;
+バインディングのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<netNamedPipeBinding>  
+      <binding>  
+            <security mode="None/Transport">  
+                        <transport protectionLevel="None/Sign/EncryptAndSign" />  
+            </security>  
+      </binding>  
+</netNamedPipeBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|このバインディングに適用されるセキュリティの種類を指定します。  以下の値が有効です。<br /><br /> -   None: セキュリティは無効になります。<br />-   Transport: セキュリティは、基になるトランスポート ベースのセキュリティを使用して提供されます。  このモードでの保護レベルを制御できます。<br />-   既定値は、Transport です。  この属性は <xref:System.ServiceModel.NetNamedPipeSecurityMode> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|transport|トランスポートのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.NamedPipeTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|[\<netNamedPipeBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md)のバインディング要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.NetNamedPipeSecurity>   
+ <xref:System.ServiceModel.NetNamedPipeBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetNamedPipeBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetNamedPipeSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-netpeerbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-netpeerbinding.md
new file mode 100644
index 00000000000..1497319c116
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-netpeerbinding.md
@@ -0,0 +1,78 @@
+---
+title: "&lt;netPeerBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ef40d8c-f903-4426-9b08-da81462766d8
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# &lt;netPeerBinding&gt; の &lt;security&gt;
+[\<netPeerTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md) のセキュリティ設定を定義します。使用される認証の種類とメッセージ トランスポートで使用されるセキュリティを含みます。  
+  
+## 構文  
+  
+```  
+  
+<netPeerBinding>  
+    <binding>  
+        <security mode="Message/None/Transport//TransportWithMessageCredential">  
+            <transport credentialType="Certificate/Password" />  
+        </security>  
+    </binding>  
+</netPeerBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|省略可能です。  このバインディングで構成されたピアが使用するセキュリティの種類を指定します。  既定値は `Message` です。  この属性は <xref:System.ServiceModel.SecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|メッセージ|SOAP セキュリティにより、認証、整合性、および機密性が実現します。|  
+|なし|セキュリティを無効にします。|  
+|Transport|セキュリティは、HTTPS を使用して確保されます。|  
+|TransportWithMessageCredential|HTTPS により、認証および機密性が実現します。  SOAP メッセージには、豊富な資格情報の種類が用意されています。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-netpeertcpbinding.md)|このバインディングで構成されたピアが送信するセキュリティで保護されたメッセージのトランスポートの型を定義します。  この要素は <xref:System.ServiceModel.Configuration.PeerTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<netPeerTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)のすべてのバインディング機能を定義します。|  
+  
+## 解説  
+ セキュリティは、メッセージ固有にすることも、トランスポート固有にすることもできます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerSecurityElement>   
+ <xref:System.ServiceModel.NetPeerTcpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetPeerTcpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.PeerSecuritySettings>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md
new file mode 100644
index 00000000000..d3317b429de
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;netTcpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 286cd191-4fd5-4c4e-a223-9c71cf7fdead
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# &lt;netTcpBinding&gt; の &lt;security&gt;
+バインディングのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="Message/None/Transport/TransportWithCredential">  
+   <transport  
+      clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+           protectionLevel="None/Sign/EncryptAndSign" />  
+   <message  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+      clientCredentialType="Certificate/IssuedToken/None/UserName/Windows" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|省略可能です。  適用するセキュリティの種類を指定します。  有効な値を次に示します。  既定値は `Transport` です。<br /><br /> この属性は <xref:System.ServiceModel.SecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|Transport|トランスポート セキュリティは、TCP 経由の TLS または SPNaego を使用して提供されます。  サービスは、SSL 証明書を使用して設定する必要があります。  このモードでの保護レベルを制御できます。|  
+|メッセージ|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。  既定では、SOAP 本文は暗号化および署名されます。  このモードは、サービス資格情報をクライアントの帯域外で使用可能にするかどうか、使用するアルゴリズム スイート、メッセージ本文に適用する保護レベルなど、さまざまな機能を提供します。  クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+|TransportWithMessageCredential|トランスポート セキュリティは、メッセージ セキュリティと組み合わせて使用されます。  トランスポート セキュリティは、TCP 経由の TLS または SPNego によって提供され、整合性、機密性、およびサーバー認証が保証されます。  SOAP メッセージ セキュリティは、クライアント認証を提供します。  既定では、クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-nettcpbinding.md)|トランスポートのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.TcpTransportSecurityElement> 型です。|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-nettcpbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.MessageSecurityOverTcpElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|バインド|[\<netTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)のバインディング要素です。|  
+  
+## 解説  
+ 標準バインディングにはそれぞれ、転送セキュリティ要件を制御するためのパラメーターが用意されています。  通常、これらのパラメーターには、使用されるセキュリティ レベル \(メッセージ レベルまたはトランスポート レベル\) を指定したセキュリティ モードと、クライアント資格情報の種類が含まれています。  これらのパラメーターが提示するオプションの選択に基づいて、適切なセキュリティが設定されたチャネル スタックが構築されます。  
+  
+ WCF \(Windows Communication Foundation\) に用意されているシステム標準のバインディグは、最も一般的なシナリオ要件の一部を満たすように設計されたセットです。  これらのバイディングでは、特定のシナリオを対象とするセキュリティ要件を指定できます。  
+  
+ この構成要素によって、`netTcpBinding` のセキュリティ仕様が提供されます。  これは、コンピューター間通信に適した、安全で信頼できる最適化されたバインディングです。  既定では、このバインディングは、メッセージを配信するための TCP、メッセージの保護と認証を行うための Windows セキュリティ、信頼性を高めるための WS\-ReliableMessaging、およびバイナリ メッセージのエンコーディングをサポートするランタイム通信スタックを生成します。  
+  
+## 参照  
+ <xref:System.ServiceModel.NetTcpSecurity>   
+ <xref:System.ServiceModel.NetTcpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetTcpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.NetTcpSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md b/docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md
new file mode 100644
index 00000000000..2aa8c125d96
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;peerTransport&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f73634ed-f896-4968-bf74-5e5ac52d3b6b
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;peerTransport&gt; の &lt;security&gt;
+ピア チャネルに関連付けられたセキュリティ設定を格納します。使用される認証の種類とメッセージ トランスポートで使用されるセキュリティを含みます。  
+  
+## 構文  
+  
+```  
+  
+<security mode="None/Transport/Message/TransportWithMessageCredential">  
+    <transport clientCredentialType="None/Windows/UserName/Certificate/CardSpace" />  
+</security  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`mode`|適用するセキュリティの種類を指定します。  既定値は Message です。  この属性は <xref:System.ServiceModel.SecurityMode> 型です。|  
+  
+## mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Transport`|セキュリティは、HTTPS を使用して確保されます。|  
+|`Message`|SOAP セキュリティにより、認証、整合性、および機密性が実現します。|  
+|`TransportWithMessageCredential`|HTTPS により、認証および機密性が実現します。  SOAP メッセージには、豊富な資格情報の種類が用意されています。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-peertransport.md)|カスタム バインディングのピア トランスポートを定義します。  この要素には、サービスと対話するときに使用される資格情報を指定する `clientCredentialType` 属性があります。  この属性は <xref:System.ServiceModel.PeerTransportCredentialType> 型です。<br /><br /> この要素は <xref:System.ServiceModel.Configuration.PeerTransportSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<peerTransport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peertransport.md)|カスタム バインディングのピア トランスポートを定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerSecurityElement>   
+ <xref:System.ServiceModel.PeerSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート セキュリティ](../../../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-webhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-webhttpbinding.md
new file mode 100644
index 00000000000..06589634bff
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-webhttpbinding.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;webHttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 727cf3d2-6f56-48ad-a59f-ba423edb9c83
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# &lt;webHttpBinding&gt; の &lt;security&gt;
+[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)で構成されるエンドポイントのセキュリティ要件を指定します。  
+  
+## 構文  
+  
+```  
+  
+<system.ServiceModel>  
+    <bindings>  
+        <webHttpBinding>  
+            <binding name = "string">  
+              <security mode="None/Transport/TransportCredentialOnly">  
+                                    <transport clientCredentialType =   
+                                     "Basic/Certificate/Digest/None/Ntlm/Windows"  
+                                     proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                                     realm="string" />  
+              </security>  
+        </webHttpBinding>  
+    </bindings>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|トランスポート レベルのセキュリティをエンドポイントで使用するか、セキュリティを使用しないかを指定します。  既定値は、`None` です。  この属性は <xref:System.ServiceModel.WebHttpSecurityMode> 型です。|  
+  
+## Mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|Transport|セキュリティは、HTTPS を使用して確保されます。  サービスは、SSL 証明書を使用して構成する必要があります。  メッセージは、HTTPS およびサービスを使用して完全にセキュリティで保護され、サービスの SSL 証明書を使用するクライアントによって認証されます。  クライアント認証は、[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-webhttpbinding.md) の `ClientCredentialType` 属性を使用して制御されます。|  
+|TransportCredentialOnly|このモードは、メッセージの整合性と機密性を提供しません。  HTTP ベースのクライアント認証を提供します。  このモードを使用するときは、十分に注意する必要があります。  トランスポート セキュリティが他の方法 \(IPSec など\) で提供され、クライアント認証だけが [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] インフラストラクチャで提供されている環境で使用する必要があります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-webhttpbinding.md)|トランスポートのセキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.Configuration.HttpTransportSecurityElement> 型に対応しています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md)|SOAP メッセージに代わって HTTP 要求に応答する [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] Web サービスのエンドポイントを構成するために使用するバインド要素。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WebHttpBindingElement>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement>   
+ <xref:System.ServiceModel.WebHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WebHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.WebHttpSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [WCF Web HTTP プログラミング モデル](../../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-ws2007httpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-ws2007httpbinding.md
new file mode 100644
index 00000000000..b45fcf5ce74
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-ws2007httpbinding.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;ws2007HttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fdda0ff7-b462-4e26-af52-e87ddab71945
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# &lt;ws2007HttpBinding&gt; の &lt;security&gt;
+[\<ws2007HttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md) 要素と共に使用されるセキュリティ設定を表します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <bindings>  
+        <ws2007HttpBinding>  
+            <binding name = "string">  
+              <security mode="None/Message/Transport/TransportWithMessageCredential">  
+                  <transport>  
+                  </transport>  
+                  <message>  
+                  </message>  
+              </security  
+        </ws2007HttpBinding>  
+    </bindings>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`mode`|-   省略可能です。  適用するセキュリティの種類を指定します。  既定値は、`Message` です。<br /><br /> この属性は <xref:System.ServiceModel.SecurityMode> 型です。|  
+  
+## Mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Transport`|セキュリティは、HTTPS を使用して確保されます。  サービスは、Secure Sockets Layer \(SSL\) 証明書を使用して構成する必要があります。  メッセージは、HTTPS およびサービスを使用して完全にセキュリティで保護され、サービスの SSL 証明書を使用するクライアントによって認証されます。  クライアント認証は、[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-ws2007httpbinding.md) 要素の `ClientCredentials` 属性によって制御されます。|  
+|`Message`|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。  既定では、SOAP 本文は暗号化および署名されます。  このモードは、サービス資格情報をクライアントの帯域外で使用可能にするかどうか、使用するアルゴリズム スイート、<xref:System.ServiceModel.Security.SecurityMessageProperty> によってメッセージ本文に適用する保護レベルなど、さまざまな機能を提供します。  クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+|`TransportWithMessageCredential`|このモードでは、HTTPS は、整合性、機密性、およびサーバー認証を提供し、SOAP メッセージ セキュリティはクライアント認証を提供します。  既定では、クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-ws2007httpbinding.md)|トランスポートのセキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.Configuration.HttpTransportSecurityElement> 型に対応しています。  これらの設定は、モードが Transport に設定されている場合のみ適用されます。|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-ws2007httpbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.Configuration.MessageSecurityOverHttpElement> 型に対応しています。  これらの設定は、モードが Transport に設定されている場合は適用されません。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<ws2007HttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md)|HTTP トランスポート アプリケーションのセキュリティで保護されたバインド。|  
+  
+## 解説  
+ この要素は、WS\-\* 仕様を実装するサービスと相互運用するようにデザインされています。  このバインディングのトランスポート セキュリティは、SSL \(Secure Sockets Layer\) over HTTP または HTTPS です。  
+  
+## 参照  
+ <xref:System.ServiceModel.WSHttpSecurity>   
+ <xref:System.ServiceModel.WSHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement>   
+ <xref:System.ServiceModel.BasicHttpSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-wsdualhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-wsdualhttpbinding.md
new file mode 100644
index 00000000000..36bae299cdc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-wsdualhttpbinding.md
@@ -0,0 +1,75 @@
+---
+title: "&lt;wsDualHttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 869c05e7-4ebe-467d-95ab-c8f8de4e6b9e
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# &lt;wsDualHttpBinding&gt; の &lt;security&gt;
+[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のセキュリティ機能を定義します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="Message/None">  
+   <message  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+      clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+      negotiateServiceCredential="Boolean"/>  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|-   省略可能です。  適用するセキュリティの種類を指定します。  既定値は `Message` です。  この属性は <xref:System.ServiceModel.WSDualHttpSecurityMode> 型です。|  
+  
+## Mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|メッセージ|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wsdualhttpbinding.md)|メッセージ レベル セキュリティの設定を定義します。  この要素は <xref:System.ServiceModel.MessageSecurityOverHttp> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のすべてのバインディング機能を定義します。|  
+  
+## 解説  
+ 二重バインディングでは、クライアントの IP アドレスをサービスに公開します。  クライアントは、セキュリティを使用して信頼するサービスに対して接続のみを可能にする必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.WSDualHttpSecurity>   
+ <xref:System.ServiceModel.WsDualHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WsDualHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WsDualHttpSecurityElement>   
+ <xref:System.ServiceModel.BasicHttpSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md
new file mode 100644
index 00000000000..658c8625173
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md
@@ -0,0 +1,124 @@
+---
+title: "&lt;wsFederationHttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8e5e854-b8dc-4921-843d-34b6a4a6a8ba
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# &lt;wsFederationHttpBinding&gt; の &lt;security&gt;
+[\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) のセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<wsFederationBinding>  
+    <binding >  
+       <security mode="None/Message/TransportWithMessageCredential">  
+         <message   
+            algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            issuedTokenType="string"   
+            issuedKeyType="SymmetricKey/PublicKey"  
+            negotiateServiceCredential="Boolean" >  
+            <claimTypeRequirements>  
+               <add claimType="URI"  
+                    isOptional="Boolean" />  
+            </claimTypeRequirements>  
+                        <issuer address="Uri" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+                          </headers>  
+                              <identity>  
+                                 <certificate encodedValue="String"/>  
+                                <certificateReference findValue="String"   
+                                 isChainIncluded="Boolean"  
+                            storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                                  storeLocation="LocalMachine/CurrentUser"  
+                                   X509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                                   <dns value="String"/>  
+                                <rsa value="String"/>  
+                                <servicePrincipalName value="String"/>  
+                                <usePrincipalName value="String"/>  
+                              </identity>  
+                        </issuer>  
+                        <issuerMetadata address=String" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+               </headers>  
+               <identity>  
+                  <certificate encodedValue="String"/>  
+                  <certificateReference findValue="String"   
+                     isChainIncluded="Boolean"  
+                     storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                     storeLocation="LocalMachine/CurrentUser"  
+                                   X509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                  <dns value="String"/>  
+                  <rsa value="String"/>  
+                  <servicePrincipalName value="String"/>  
+                  <usePrincipalName value="String"/>  
+               </identity>  
+                        </issuerMetadata>  
+            <tokenRequestParameters>  
+               <xmlElement>  
+               </xmlElement>  
+            </tokenRequestParameters>  
+         </message>  
+       </security>  
+    </binding>  
+</wsFederationBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|省略可能です。  適用するセキュリティの種類を指定します。  既定値は `Message` です。  この属性は <xref:System.ServiceModel.WSFederationHttpSecurityMode> 型です。|  
+  
+## Mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|SOAP メッセージは、転送中はセキュリティで保護されません。|  
+|メッセージ|SOAP メッセージ セキュリティを使用して、整合性、機密性、サーバー認証、およびクライアント認証を提供します。  既定では、本文は暗号化および署名されます。  このサービスは、証明書を使用して設定する必要があります。  クライアント認証は、セキュリティ トークン サービスによってクライアントに発行されるトークンに基づいています。|  
+|TransportWithMessageCredential|整合性、機密性、およびサーバー認証は、HTTPS によって提供されます。  このサービスは、証明書を使用して設定する必要があります。  クライアント認証は、SOAP メッセージ セキュリティによって提供され、セキュリティ トークン サービスによってクライアントに発行されるトークンに基づいています。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md)|メッセージ レベル セキュリティの設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|[\<wsDualHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)のすべてのバインディング機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.WSFederationHttpSecurity>   
+ <xref:System.ServiceModel.WSFederationHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement>   
+ [方法 : WSFederationHttpBinding を作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md
new file mode 100644
index 00000000000..f2f1785699f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;wsHttpBinding&gt; の &lt;security&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8658b162-2ddf-4162-a869-aa517a42288a
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# &lt;wsHttpBinding&gt; の &lt;security&gt;
+[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)のセキュリティ機能を表します。  
+  
+## 構文  
+  
+```  
+  
+<security mode="Message/None/Transport/TransportWithMessageCredential">  
+   <transport  
+         clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+      proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+      realm="string"   
+      defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+      defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+      defaultRealm="string" />  
+   <message  
+            clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+       establishSecurityContext="Boolean"   
+      negotiateServiceCredential="Boolean"/>  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|モード|-   省略可能です。  適用するセキュリティの種類を指定します。  既定値は、`Message` です。<br />-   この属性は <xref:System.ServiceModel.SecurityMode> 型です。|  
+  
+## Mode 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|Transport|セキュリティは、HTTPS を使用して確保されます。  サービスは、SSL 証明書を使用して構成する必要があります。  メッセージは、HTTPS を使用して完全にセキュリティで保護され、サービスの SSL 証明書を使用するクライアントによって認証されます。  クライアント認証は、`ClientCredentials` 属性を使用して制御されます。  これは [\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md) の属性です。|  
+|メッセージ|セキュリティは、SOAP メッセージ セキュリティを使用して確保されます。  既定では、SOAP 本文は暗号化および署名されます。  このモードは、サービス資格情報をクライアントの帯域外で使用可能にするかどうか、使用するアルゴリズム スイート、Security.Message プロパティを使用してメッセージ本文に適用する保護レベルなど、さまざまな機能を提供します。  クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+|TransportWithMessageCredential|このモードでは、HTTPS は、整合性、機密性、およびサーバー認証を提供し、SOAP メッセージ セキュリティはクライアント認証を提供します。  既定では、クライアント認証はセッションごとに 1 回実行され、認証の結果はセッションの存続中にキャッシュされます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<transport\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md)|トランスポートのセキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.Configuration.HttpTransportSecurityElement> 型に対応しています。|  
+|[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は、<xref:System.ServiceModel.Configuration.MessageSecurityOverHttpElement> 型に対応しています。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)|HTTP トランスポート アプリケーションのセキュリティで保護されたバインド。|  
+  
+## 解説  
+ WSHttpBinding クラスは、WS\-\* 仕様を実装するサービスと相互運用するようにデザインされています。  このバインディングのトランスポート セキュリティは、SSL \(Secure Sockets Layer\) over HTTP または HTTPS です。  
+  
+## 参照  
+ <xref:System.ServiceModel.WSHttpSecurity>   
+ <xref:System.ServiceModel.WSHttpBinding.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpBindingElement.Security%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/service.md b/docs/framework/configure-apps/file-schema/wcf/service.md
new file mode 100644
index 00000000000..c6a865170ab
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/service.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;service&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 13123dd6-c4a9-4a04-a984-df184b851788
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# &lt;service&gt;
+`service` 要素には Windows Communication Foundation \(WCF\) サービスの設定が含まれます。  また、サービスを公開するエンドポイントも含まれます。  
+  
+## 構文  
+  
+```  
+  
+<service behaviorConfiguration=String"  
+        name="String"  
+</service>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|behaviorConfiguration|サービスのインスタンス化に使用される動作の動作名を含む文字列。  動作名は、サービスが定義される時点でスコープ内にある必要があります。  既定値は空の文字列です。|  
+|name|インスタンス化するサービスの型を指定する必須の文字列属性。  この設定は有効な型と同じでなければなりません。  形式は、`Namespace.Class` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md)|このサービスを公開する `endpoint` 要素のコレクション。|  
+|[\<host\>](../../../../../docs/framework/configure-apps/file-schema/wcf/host.md)|このサービス インスタンスのホストを指定します。  この要素は <xref:System.ServiceModel.Configuration.HostElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<services\>](../../../../../docs/framework/configure-apps/file-schema/wcf/services.md)|すべての WCF 構成要素のルート要素です。|  
+  
+## 解説  
+ サービスは、設定ファイルの `services` セクションで定義されます。  アセンブリには、任意の数のサービスを含めることができます。  各サービスには、独自の `service` 設定セクションがあります。  このセクションとその内容は、サービス コントラクト、動作、および特定のサービスのエンドポイントを定義します。  
+  
+ `behaviorConfiguration` 要素も省略可能です。  サービスが使用する動作を識別します。  この属性で指定された動作は、同じ設定ファイルの範囲にある動作にリンクしている必要があります。  
+  
+ 各サービスでは、固有のアドレスとバインディングを持つ 1 つまたは複数のエンドポイントが公開されます。  構成ファイル内で使用されるすべてのバインディングは、そのファイルのスコープ内で定義される必要があります。  バインディングは、`name` 属性と `bindingConfiguration` 属性の組み合わせによってエンドポイントにリンクされます。  `name` 属性は、バインディングが定義されているセクションを示します。  `bindingConfiguration` 属性は、バインディング セクション内の使用される構成を定義します。  バインディング セクションでは、複数の設定を定義できます。  
+  
+## 使用例  
+ これはサービスの構成の例です。  
+  
+```  
+<service behaviorConfiguration="testChannelBehavior"   
+     name="HelloWorld">  
+     <endpoint   
+        address="/HelloWorld2/"  
+        name="test"  
+        bindingNamespace="http://www.cohowinery.com/"  
+        binding="basicHttpBinding"  
+        contract="IHelloWorld" />  
+</service>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceElement>   
+ [サービスの構成](../../../../../docs/framework/wcf/configuring-services.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/serviceactivations.md b/docs/framework/configure-apps/file-schema/wcf/serviceactivations.md
new file mode 100644
index 00000000000..6f217ef2902
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/serviceactivations.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;serviceActivations&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97e665b6-1c51-410b-928a-9bb42c954ddb
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;serviceActivations&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスの種類にマップする仮想サービス アクティベーション設定を定義する設定を追加できる構成要素。  これにより、.svc ファイルを使用せずに、WAS\/IIS でホストされているサービスをアクティブ化できます。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>   
+   <serviceActivations>  
+      <add factory="String"  
+           service="String"/>  
+   </serviceActivations>  
+</serviceHostingEnvironment>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-serviceactivations.md)|サービス アプリケーションのアクティベーションを指定する構成要素を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceHostingEnvironment\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)|環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。|  
+  
+## 解説  
+ web.config ファイルでアクティベーション設定を構成する方法を次の例に示します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <serviceHostingEnvironment>  
+      <serviceActivations>  
+        <add service="GreetingService"/>  
+      </serviceActivations>  
+    </serviceHostingEnvironment>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ この構成を使用して、.svc ファイルを使用せずに、GreetingService をアクティブ化できます。  
+  
+ `<serviceHostingEnvironment>` はアプリケーション レベルの構成であることに注意してください。  構成を格納した `web.config` は、仮想アプリケーションのルートの下に配置する必要があります。  また、`serviceHostingEnvironment` は machinetoApplication の継承可能なセクションです。  コンピューターのルートに単一のサービスを登録すると、アプリケーションの各サービスはこのサービスを継承します。  
+  
+ 構成ベースのアクティベーションは、http および非 http プロトコル経由のアクティベーションをサポートします。  relatativeAddress では、  .svc、.xoml、.xamlx などの拡張子が必要です。  既知の buildProviders に対して独自の拡張子をマップできます。これにより、任意の拡張子を使用してサービスをアクティブ化できるようになります。  競合が発生した場合には、`<serviceActivations>` セクションにより、.svc の登録がオーバーライドされます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceActivationElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/serviceauthenticationmanager.md b/docs/framework/configure-apps/file-schema/wcf/serviceauthenticationmanager.md
new file mode 100644
index 00000000000..8e034c297e3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/serviceauthenticationmanager.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;serviceAuthenticationManager&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d69e64f-f325-4d55-8e2d-0fb30f222dda
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;serviceAuthenticationManager&gt;
+サービス レベルで転送、メッセージ、または送信元の有効性を確立するワークフロー構成要素を提供します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <serviceAuthenticationManager serviceAuthenticationManagerType =”String”/>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|serviceAuthenticationManagerType|現在の動作の認証ポリシーの種類を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceAuthenticationElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md b/docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md
new file mode 100644
index 00000000000..4c36972d18a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md
@@ -0,0 +1,112 @@
+---
+title: "&lt;serviceAuthorization&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 18cddad5-ddcb-4839-a0ac-1d6f6ab783ca
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# &lt;serviceAuthorization&gt; 要素
+サービス操作へのアクセスを許可する設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceAuthorization  
+     impersonateCallerForAllOperations="Boolean"  
+      principalPermissionMode="None/UseWindowsGroups/UseAspNetRoles/Custom"  
+      roleProviderName="String"  
+      serviceAuthorizationManagerType="String" />  
+      <authorizationPolicies>  
+         <add policyType="String" />  
+      </authorizationPolicies>  
+</serviceAuthorization>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|impersonateCallerForAllOperations|サービスのすべての操作が呼び出し元を偽装するかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> 特定のサービス操作が呼び出し元を偽装する場合、スレッド コンテキストは、指定されたサービスを実行する前に呼び出し元のコンテキストに切り替えられます。|  
+|principalPermissionMode|サーバーでの操作を実行するために使用されるプリンシパルを設定します。  次の値があります。<br /><br /> -   なし<br />-   UseWindowsGroups<br />-   UseAspNetRoles<br />-   Custom<br /><br /> 既定値は UseWindowsGroups です。  値は、<xref:System.ServiceModel.Description.PrincipalPermissionMode> 型です。  この属性の使い方の詳細については、「[方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)」を参照してください。|  
+|roleProviderName|Windows Communication Foundation \(WCF\) アプリケーションにロール情報を提供するロール プロバイダーの名前を指定する文字列。  既定値は空の文字列です。|  
+|ServiceAuthorizationManagerType|サービス承認マネージャーの型を含む文字列。  詳細については、「<xref:System.ServiceModel.ServiceAuthorizationManager>」を参照してください。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|authorizationPolicies|`add` キーワードを使用して追加できる承認ポリシーの種類のコレクションを含みます。  各承認ポリシーは、文字列の単一の必須属性 `policyType` を含みます。  この属性は、入力クレームのセットをクレームの別のセットに変換することを可能にする承認ポリシーを指定します。  アクセス制御は、それに基づいて許可または拒否されます。  詳細については、「<xref:System.ServiceModel.Configuration.AuthorizationPolicyTypeElement>」を参照してください。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|サービスの動作設定のコレクションが含まれています。|  
+  
+## 解説  
+ このセクションには、承認、カスタム ロール プロバイダー、および偽装に影響する要素が含まれています。  
+  
+ `principalPermissionMode` 属性は、保護メソッドの使用を承認するときに使用するユーザー グループを指定します。  既定値は `UseWindowsGroups` で、リソースにアクセスしようとしている ID を、"Administrators" や "Users" などの Windows グループから検索するように指定します。  `UseAspNetRoles` を指定すると、次のコードに示すように、\<system.web\> 要素の下で構成されるカスタム ロール プロバイダーを使用することもできます。  
+  
+```  
+<system.web>  
+  <membership defaultProvider="SqlProvider"   
+   userIsOnlineTimeWindow="15">  
+     <providers>  
+       <clear />  
+       <add   
+          name="SqlProvider"   
+          type="System.Web.Security.SqlMembershipProvider"   
+          connectionStringName="SqlConn"  
+          applicationName="MembershipProvider"  
+          enablePasswordRetrieval="false"  
+          enablePasswordReset="false"  
+          requiresQuestionAndAnswer="false"  
+          requiresUniqueEmail="true"  
+          passwordFormat="Hashed" />  
+     </providers>  
+   </membership>  
+  <!-- Other configuration code not shown.-->  
+</system.web>  
+```  
+  
+ `principalPermissionMode` 属性で `roleProviderName` を使用する方法を次のコードに示します。  
+  
+```  
+<behaviors>  
+   <behavior name="ServiceBehaviour">  
+     <serviceAuthorization principalPermissionMode ="UseAspNetRoles"   
+                           roleProviderName ="SqlProvider" />  
+   </behavior>   
+<!-- Other configuration code not shown. -->  
+</behaviors>  
+```  
+  
+ この構成要素の使い方の詳細な例については、「[サービス操作へのアクセスの承認](../../../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)」および「[承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceAuthorizationElement>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [サービス操作へのアクセスの承認](../../../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)   
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)   
+ [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)   
+ [承認ポリシー](../../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md b/docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md
new file mode 100644
index 00000000000..74ecbf21777
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md
@@ -0,0 +1,26 @@
+---
+title: "&lt;serviceBehaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5aed9062-cc36-4b72-b9dd-a3018b8ffafc
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;serviceBehaviors&gt;
+この構成セクションは、特定のサービスに対して定義されたすべての動作を表します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElement>   
+ [\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md)   
+ [サービスのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-service-run-time-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md b/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md
new file mode 100644
index 00000000000..dabe77556b7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;clientCredentials&gt; 要素の &lt;serviceCertificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e50c0ac5-f0df-4c90-b54b-fc602c1f84ea
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;clientCredentials&gt; 要素の &lt;serviceCertificate&gt;
+クライアントに対してサービスを認証する際に使用される証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceCertificate />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<defaultCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md)|ネゴシエーション プロトコル経由でサービスまたは STS が証明書を提供しないときに使用される X.509 証明書を指定します。|  
+|[\<scopedCertificates\>](../../../../../docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md)|認証用の \(範囲指定された\) 特定のサービスにより提供される X.509 証明書のコレクションを表します。  このコレクションは一般に、フェデレーション シナリオでセキュリティ トークン サービスのサービス証明書を指定するために使用されます。|  
+|[\<authentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md)|クライアントで使用されるサービス証明書の認証動作を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアント自身の認証のためにクライアントによって使用される資格情報を指定します。|  
+  
+## 解説  
+ この構成要素は、SSL 認証を使用してサービスから提示された証明書を検証するためにクライアントが使用する設定を指定します。  また、このクラスには、メッセージ セキュリティを使用してサービスへのメッセージを暗号化するためにクライアントで明示的に構成される、サービスの証明書も含まれます。  
+  
+ `serviceCertificate` 要素の属性は、[\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md)の属性と同じです。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.ServiceCertificate%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ClientCredentials.ServiceCertificate%2A>   
+ <xref:System.ServiceModel.Configuration.X509RecipientCertificateClientElement>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md
new file mode 100644
index 00000000000..a0d414e36d5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;serviceCredentials&gt; の &lt;serviceCertificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 597ae6d5-4938-4950-9f5e-b2280e816182
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;serviceCredentials&gt; の &lt;serviceCertificate&gt;
+メッセージ セキュリティ モードを使用しているクライアントへのサービスの認証に使用する X.509 証明書を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceCertificate findValue="String"   
+    storeLocation="LocalMachine/CurrentUser"  
+    storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+X509FindType="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`findValue`|X.509 証明書ストアで検索する値を含む文字列。  属性に含まれている型は、指定された X509FindType の要件を満たしている必要があります。  既定値は空の文字列です。|  
+|`storeLocation`|クライアントがサーバーの証明書の検証に使用する X.509 証明書ストアの場所を指定します。  以下の値が有効です。<br /><br /> -   LocalMachine: ローカル マシンに割り当てられた証明書ストア。<br />-   CurrentUser: 現在のユーザーに割り当てられた証明書ストア。<br /><br /> 既定は LocalMachine です。|  
+|`storeName`|開く X.509 証明書ストアの名前を指定します。  以下の値が有効です。<br /><br /> -   AddressBook: 他のユーザー用の証明書ストア。<br />-   AuthRoot: サードパーティ証明機関 \(CA\) の証明書ストア。<br />-   CertificatAuthority: 中間証明機関 \(CA\) の証明書ストア。<br />-   Disallowed: 失効した証明書の証明書ストア。<br />-   My: 個人用証明書の証明書ストア。<br />-   Root: 信頼されたルート証明機関 \(CA\) の証明書ストア。<br />-   TrustedPeople: 直接信頼されたユーザーやリソースの証明書ストア。<br />-   TrustedPublisher: 直接信頼された発行者の証明書ストア。<br /><br /> 既定値は My です。|  
+|`X509FindType`|実行する X.509 検索の種類を定義します。  以下の値が有効です。<br /><br /> -   FindByThumbprint<br />-   FindBySubjectName<br />-   FindBySubjectDistinguishedName<br />-   FindByIssuerName<br />-   FindByIssuerDistinguishedName<br />-   FindBySerialNumber<br />-   FindByTimeValid<br />-   FindByTimeNotYetValid<br />-   FindByTemplateName<br />-   FindByApplicationPolicy<br />-   FindByCertificatePolicy<br />-   FindByExtension<br />-   FindByKeyUsage<br />-   FindBySubjectKeyIdentifier<br /><br /> `findValue` 属性に含まれている型は、指定された X509FindType の要件を満たしている必要があります。<br /><br /> 既定値は FindBySubjectDistinguishedName です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ メッセージ セキュリティ モードを使用しているクライアントへのサービスの認証に使用する X.509 証明書を指定するには、この要素を使用します。  定期的に更新される証明書を使用している場合は、証明書のサムプリントが変更されます。  その場合、証明書を同じサブジェクト名で再発行できるため、`X509FindType` としてサブジェクト名を使用します。  
+  
+ この要素の使い方[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[方法 : クライアントの資格情報の値を指定する](../../../../../docs/framework/wcf/how-to-specify-client-credential-values.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.X509RecipientCertificateServiceElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.ServiceCertificate%2A>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.ServiceCertificate%2A>   
+ [方法 : クライアントの資格情報の値を指定する](../../../../../docs/framework/wcf/how-to-specify-client-credential-values.md)   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/servicecredentials.md
new file mode 100644
index 00000000000..4c5aa73181e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicecredentials.md
@@ -0,0 +1,74 @@
+---
+title: "&lt;serviceCredentials&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96db336c-4f7a-4193-81a5-910b8ffd804f
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;serviceCredentials&gt;
+サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceCredentials type="String">  
+   <clientCertificate>  
+   </clientCertificate>  
+   <issuedTokenAuthentication>  
+   </issuedTokenAuthentication>  
+   <peer>  
+   </peer>  
+   <secureConversationAuthentication>  
+   </secureConversationAuthentication>  
+   <serviceCertificate>  
+   </serviceCertificate>  
+   <userNameAuthentication>  
+   </userNameAuthentication>  
+   <windowsAuthentication>  
+   </windowsAuthentication>  
+</serviceCredentials>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`type`|この設定要素の種類を指定する文字列です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md)|クライアント証明書を帯域外で使用できるときに使用される証明書を指定します。  この要素は、クライアント証明書の検証設定も指定します。  この要素は <xref:System.ServiceModel.Configuration.X509InitiatorCertificateServiceElement> 型です。|  
+|[\<issuedTokenAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)|このサービス用に現在発行されているトークンを指定します。  この要素は <xref:System.ServiceModel.Configuration.IssuedTokenServiceElement> 型です。|  
+|[\<peer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/peer-of-servicecredentials.md)|ピア ノードの現在の資格情報を指定します。  この要素は <xref:System.ServiceModel.Configuration.PeerCredentialElement> 型です。|  
+|[\<secureConversationAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationauthentication-of-servicecredential.md)|セキュリティで保護されたメッセージ交換の現在の資格情報を指定します。  この要素は <xref:System.ServiceModel.Configuration.SecureConversationServiceElement> 型です。|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)|サービスが自身を識別するために使用する証明書を指定します。  この要素は <xref:System.ServiceModel.Configuration.X509RecipientCertificateServiceElement> 型です。|  
+|[\<userNameAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md)|ユーザー名とパスワードの検証の設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.UserNameServiceElement> 型です。|  
+|[\<windowsAuthentication\>](../../../../../docs/framework/configure-apps/file-schema/wcf/windowsauthentication-of-servicecredentials.md)|Windows 資格情報の検証の設定を指定します。  この要素は <xref:System.ServiceModel.Configuration.WindowsServiceElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement>   
+ <xref:System.ServiceModel.Description.ServiceCredentials>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicedebug.md b/docs/framework/configure-apps/file-schema/wcf/servicedebug.md
new file mode 100644
index 00000000000..0f8c278c7f4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicedebug.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;serviceDebug&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d7ea986-f232-49fe-842c-f934d9966889
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# &lt;serviceDebug&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスのデバッグおよびヘルプ情報機能を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceDebug   
+    httpHelpPageBinding=”String”  
+    httpHelpPageBindingConfiguration=”String”  
+    httpHelpPageEnabled="Boolean"  
+    httpHelpPageUrl="Uri"  
+    httpsHelpPageBinding=”String”  
+    httpsHelpPageBindingConfiguration=”String”  
+    httpsHelpPageEnabled="Boolean"  
+    httpsHelpPageUrl="Uri"  
+    includeExceptionDetailInFaults="Boolean" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|httpHelpPageBinding|HTTP を利用してサービス ヘルプ ページにアクセスする場合に使用するバインディングの種類を指定する文字列値。<br /><br /> [System.ServiceModel.Channels.IReplyChannel](assetId:///System.ServiceModel.Channels.IReplyChannel?qualifyHint=False&amp;autoUpgrade=True) をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの [System.ServiceModel.Channels.MessageVersion](assetId:///System.ServiceModel.Channels.MessageVersion?qualifyHint=False&amp;autoUpgrade=True) プロパティが [System.ServiceModel.Channels.MessageVersion.None](assetId:///System.ServiceModel.Channels.MessageVersion.None?qualifyHint=False&amp;autoUpgrade=True) である必要があります。|  
+|httpHelpPageBindingConfiguration|このバインディングの追加の構成情報を参照する `httpHelpPageBinding` 属性に指定されるバインディングの名前を指定する文字列。  同じ名前を `<bindings>` セクションに定義する必要があります。|  
+|httpHelpPageEnabled|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] が、`httpHelpPageUrl` 属性により指定されたアドレスに HTML ヘルプ ページを公開するかどうかを制御するブール値です。  既定値は、`true` です。<br /><br /> このプロパティを `false` に設定して、HTML ブラウザーに表示される HTML ヘルプ ページの公開を無効にできます。<br /><br /> HTML ヘルプ ページが、`httpHelpPageUrl` 属性により制御される場所に公開されるようにするには、この属性を `true` に設定する必要があります。  さらに、次のいずれかの条件も満たす必要があります。<br /><br /> -   `httpHelpPageUrl` 属性は、HTTP プロトコル スキームをサポートする絶対アドレスです。<br />-   HTTP プロトコル スキームをサポートするサービスのベース アドレスがあります。<br /><br /> HTTP プロトコル スキームをサポートしない絶対アドレスが `httpHelpPageUrl` 属性に割り当てられている場合は例外がスローされますが、前の基準をどれも満たさないその他のシナリオでは、例外も HTML ヘルプ ページも表示されません。|  
+|httpHelpPageUrl|HTML ブラウザーを使用してエンドポイントを表示するときにユーザーが参照する、カスタム HTML ヘルプ ファイルの相対的または絶対的な HTTP ベースの URL を指定する URI。<br /><br /> この属性を使用して、HTTP\/Get 要求から返されるカスタム HTML ヘルプ ファイルを HTML ブラウザーなどから利用できます。  HTML ヘルプ ファイルの位置は、次のように解決されます。<br /><br /> 1.  この属性の値が相対アドレスの場合、HTML ヘルプ ファイルの位置は、HTTP 要求をサポートするサービスのベース アドレスにこのプロパティの値を加えた値になります。<br />2.  この属性が絶対アドレスであり、HTTP 要求をサポートする場合は、HTML ヘルプ ファイルの位置はこのプロパティの値になります。<br />3.  この属性の値が絶対値であっても HTTP 要求をサポートしていない場合は、例外がスローされます。<br /><br /> この属性は、`httpHelpPageEnabled`  属性が `true` の場合にだけ有効です。|  
+|httpsHelpPageBinding|HTTPS を利用してサービス ヘルプ ページにアクセスする場合に使用するバインディングの種類を指定する文字列値。<br /><br /> assetId:///System.ServiceModel.Channels.IReplyChannel?qualifyHint=False&amp;autoUpgrade=True をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの assetId:///System.ServiceModel.Channels.MessageVersion?qualifyHint=False&amp;autoUpgrade=True プロパティが assetId:///System.ServiceModel.Channels.MessageVersion.None?qualifyHint=False&amp;autoUpgrade=True である必要があります。|  
+|httpsHelpPageBindingConfiguration|このバインディングの追加の構成情報を参照する `httpsHelpPageBinding` 属性に指定されるバインディングの名前を指定する文字列。  同じ名前を `<bindings>` セクションに定義する必要があります。|  
+|httpsHelpPageEnabled|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] が、`httpsHelpPageUrl` 属性により指定されたアドレスに HTML ヘルプ ページを公開するかどうかを制御するブール値です。  既定値は、`true` です。<br /><br /> このプロパティを `false` に設定して、HTML ブラウザーに表示される HTML ヘルプ ページの公開を無効にできます。<br /><br /> HTML ヘルプ ページが、`httpsHelpPageUrl` 属性により制御される場所に公開されるようにするには、この属性を `true` に設定する必要があります。  さらに、次のいずれかの条件も満たす必要があります。<br /><br /> -   `httpsHelpPageUrl` 属性は、HTTPS プロトコル スキームをサポートする絶対アドレスです。<br />-   HTTPS プロトコル スキームをサポートするサービスのベース アドレスがあります。<br /><br /> HTTPS プロトコル スキームをサポートしない絶対アドレスが `httpsHelpPageUrl` 属性に割り当てられている場合は例外がスローされますが、前の基準をどれも満たさないその他のシナリオでは、例外も HTML ヘルプ ページも表示されません。|  
+|httpsHelpPageUrl|HTML ブラウザーを使用してエンドポイントを表示するときにユーザーが参照する、カスタム HTML ヘルプ ファイルの相対的または絶対的な HTTPS ベースの URL を指定する URI。<br /><br /> この属性を使用して、HTTPS\/Get 要求から返されるカスタム HTML ヘルプ ファイルを HTML ブラウザーなどから利用できます。  HTML ヘルプ ファイルの場所は、次のように解決されます。<br /><br /> -   このプロパティの値が相対アドレスの場合、HTML ヘルプ ファイルの位置は、HTTPS 要求をサポートするサービスのベース アドレスにこのプロパティの値を加えた値になります。<br />-   このプロパティが絶対アドレスであり、HTTPS 要求をサポートする場合は、HTML ヘルプ ファイルの位置はこのプロパティの値になります。<br />-   このプロパティの値が絶対値であっても HTTPS 要求をサポートしていない場合は、例外がスローされます。<br /><br /> この属性は、`httpHelpPageEnabled`  属性が `true` の場合にだけ有効です。|  
+|includeExceptionDetailInFaults|デバッグの目的でクライアントに返される SOAP エラーの詳細に、マネージ例外情報を含めるかどうかを指定する値。  既定値は、`false` です。<br /><br /> この属性を `true` に設定すると、デバッグ目的でクライアントへのマネージ例外情報のフロー、および Web ブラウザーでサービスをブラウズするユーザー向けの HTML 情報ファイルの公開を有効にできます。 **Caution:**  マネージ例外情報をクライアントに返すことは、セキュリティ リスクになり得ます。  これは、例外の詳細が、認証されていないクライアントによって使用可能な内部サービスの実装に関する情報を公開するためです。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ 例外が <xref:System.ServiceModel.FaultContractAttribute> を使用して宣言されていない場合でも、`includeExceptionDetailInFaults` を `true` に設定すると、サービスでは、アプリケーション コードによってスローされる例外を返すことができます。  この設定は、サーバーが予期しない例外をスローしている場合のデバッグ時に役立ちます。  この属性を使用すると、不明な例外がシリアル化された形式で返されるので、例外をより詳細に調べることができます。  
+  
+> [!CAUTION]
+>  マネージ例外情報をクライアントに戻すことは、セキュリティ リスクになり得ます。これは、例外の詳細が、非承認のクライアントで使用可能な内部サービスの実装についての情報を公開するからです。  セキュリティの問題にかかわるため、この操作は制御されたデバッグ シナリオでのみ行うことを強くお勧めします。  アプリケーションを配置する場合は、`includeExceptionDetailInFaults` を `false` に設定する必要があります。  
+  
+ マネージ例外に関連するセキュリティ問題の詳細については、「[コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  コード例については、「[サービス デバッグ動作](../../../../../docs/framework/wcf/samples/service-debug-behavior.md)」を参照してください。  
+  
+ `httpsHelpPageEnabled` と `httpsHelpPageUrl` を設定して、ヘルプ ページを有効または無効にすることもできます。  各サービスは、サービスの WSDL を取得するエンドポイントなど、サービスに関する情報が含まれるヘルプ ページをオプションで公開できます。  これを有効にするには、`httpHelpPageEnabled` プロパティを `true` に設定します。  これにより、サービスのベース アドレスへの GET 要求に対して、ヘルプ ページを返すことができます。  このアドレスは、`httpHelpPageUrl` 属性を設定することで変更できます。  また、HTTP の代わりに HTTPS を使用すると、このアドレスをセキュリティで保護できます。  
+  
+ 省略可能な `httpHelpPageBinding` 属性および `httpHelpPageBinding` 属性を使用すると、サービス ウェブ ページにアクセスするためのバインディングを構成できます。  これらの属性が指定されていない場合、サービス ヘルプ ページへのアクセスには、適切な既定のバインディグ \(HTTP の場合は `HttpTransportBindingElement`、HTTPS の場合は `HttpsTransportBindingElement`\) が使用されます。  これらの属性は、組み込みの WCF バインディングでは使用できないことに注意してください。  assetId:///System.ServiceModel.Channels.IReplyChannel?qualifyHint=False&amp;autoUpgrade=True をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの assetId:///System.ServiceModel.Channels.MessageVersion?qualifyHint=False&amp;autoUpgrade=True プロパティが assetId:///System.ServiceModel.Channels.MessageVersion.None?qualifyHint=False&amp;autoUpgrade=True である必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceDebugElement>   
+ <xref:System.ServiceModel.Description.ServiceDebugBehavior>   
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)   
+ [例外とエラーの処理](../../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md)   
+ [サービス デバッグ動作](../../../../../docs/framework/wcf/samples/service-debug-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicediscovery.md b/docs/framework/configure-apps/file-schema/wcf/servicediscovery.md
new file mode 100644
index 00000000000..6ca5dc22b4d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicediscovery.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;serviceDiscovery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3c68a4a-fc95-43c5-aacb-785936c0cf39
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;serviceDiscovery&gt;
+サービス エンドポイントの探索可能性を指定します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <serviceDiscovery>  
+        <announcementEndpoints>  
+              <endpoint name="String”  
+                        kind="Type" />  
+        </announcementEndpoints>  
+        <discoveryEndpoints>  
+              <endpoint name="String”  
+                        kind="Type" />  
+        </discoveryEndpoints>  
+      </serviceDiscovery>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<announcementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md)|アナウンス エンドポイントのコレクション。  このセクションを使用して、アナウンス メッセージの送信に使用するエンドポイントを指定します。|  
+|[\<discoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md)|探索エンドポイントのコレクション。  このセクションを使用して、探索メッセージをリッスンするエンドポイントを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ サービスの動作構成に追加すると、この構成要素により、サービスの探索可能性はすべてのエンドポイントで有効になります。  [\<discoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md)[\<announcementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md) 子要素を使用すると、このようなエンドポイントの探索機能をさらに構成できます。  サービス アナウンス \(オンラインになるときは Hello、オフラインになるときは Bye\) の送信に使用するエンドポイント構成を指定してアナウンスを構成するには、[\<announcementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md) セクションを使用します。  探索メッセージをリッスンするエンドポイントを手動で指定するには、[\<discoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md) セクションを使用します。  
+  
+## 使用例  
+ 次の構成例では、CalculatorService を探索可能に指定しています。また、オプションで、使用するアナウンス エンドポイントを指定しています。  
+  
+```  
+  
+<services>  
+  <service name="CalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+  ...  
+  </service>  
+</services>  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceDiscovery>  
+        <announcementEndpoints>  
+              <endpoint name="udpEndpoint"  
+                        kind="udpAnnouncementEndpoint" />  
+        </announcementEndpoints>  
+      </serviceDiscovery>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md b/docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md
new file mode 100644
index 00000000000..4d6759d7eb0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md
@@ -0,0 +1,107 @@
+---
+title: "&lt;serviceHostingEnvironment&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 4f8a7c4f-e735-4987-979a-b74fcdae2652
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# &lt;serviceHostingEnvironment&gt;
+この要素は、環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。  この要素が空の場合は、既定の型が使用されます。  この要素は、アプリケーション レベルまたはコンピューター レベルの構成ファイルでのみ使用できます。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment  
+     aspNetCompatibilityEnabled="Boolean"  
+     minFreeMemoryPercentageToActivateService="Integer"  
+     multipleSiteBindingsEnabled="Boolean">  
+     <baseAddressPrefixFilters>  
+        <add prefix="string"/>  
+     </baseAddressPrefixFilters>  
+      <serviceActivations>  
+        <add factory="String" service="String"/>  
+      </serviceActivations>  
+     <transportConfigurationTypes>  
+        <add name="String"   
+             transportConfigurationType="String" />  
+     </transportConfigurationTypes>  
+</serviceHostingEnvironment>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|aspNetCompatibilityEnabled|ASP.NET の互換モードが現在のアプリケーションに対して有効になっているかどうかを示すブール値。  既定値は、`false` です。<br /><br /> この属性が `true` に設定されている場合、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスに対する要求は ASP.NET HTTP パイプラインを通過し、HTTP プロトコル以外を介した通信は禁止されます。  詳細については、「[WCF サービスと ASP.NET](../../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」を参照してください。|  
+|minFreeMemoryPercentageToActivateService|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをアクティブにする前に、システムに必要な最小限の空きメモリの容量を指定する整数。 **Caution:**  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの web.config ファイルで、部分信頼と共にこの属性を指定すると、サービスを実行したときに <xref:System.Security.SecurityException> が発生します。|  
+|multipleSiteBindingsEnabled|1 つのサイトで複数の IIS バインディングが有効になっているかどうかを指定するブール値。<br /><br /> IIS は、仮想ディレクトリを含む仮想アプリケーションのコンテナーとしての Web サイトで構成されています。  サイト内のアプリケーションに、1 つ以上の IIS バインディングからアクセスできます。  IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。  バインディング プロトコルは通信を行うスキームを定義するもので、バインディング情報はサイトにアクセスするために使用する情報です。  バインディング プロトコルの例には HTTP があり、一方、バインディング情報には IP アドレス、ポート、ホスト ヘッダーなどを含めることができます。<br /><br /> IIS ではサイトごとに複数の IIS バインディングを指定でき、これによりスキームごとに複数のベース アドレスをサポートできます。  ただし、サイトでホストされている [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスでは、1 つのスキームあたり 1 つのみの baseAddress へのバインディングが許可されています。<br /><br /> [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスに対し、1 つのサイトで複数の IIS バインディングを有効にするには、この属性を `true` に設定します。  複数のサイト バインディングは HTTP プロトコルに対してのみサポートされています。  構成ファイル内のエンドポイントのアドレスには完全な URI を指定する必要があります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<baseAddressPrefixFilters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md)|サービス ホストによって使用されるベース アドレスのプレフィックス フィルターを指定する構成要素のコレクション。|  
+|[\<serviceActivations\>](../../../../../docs/framework/configure-apps/file-schema/wcf/serviceactivations.md)|アクティベーション設定を記述する構成セクション。|  
+|[\<transportConfigurationTypes\>](../../../../../docs/framework/configure-apps/file-schema/wcf/transportconfigurationtypes.md)|特定のトランスポートの型を識別する構成要素のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|serviceModel|すべての Windows Communication Foundation \(WCF\) 構成要素のルート要素です。|  
+  
+## 解説  
+ 既定では、WCF サービスは、ホストされるアプリケーション ドメイン \(AppDomain\) で ASP.NET と並行で実行します。  WCF と ASP.NET が同じ AppDomain で共存できても、既定では WCF 要求は ASP.NET HTTP パイプラインでは処理されません。  結果として、ASP.NET アプリケーション プラットフォームのいくつかの要素は、WCF サービスでは使用できません。  これらの要素は次のとおりです。  
+  
+-   ASP.NET ファイル\/URL 承認  
+  
+-   ASP.NET の偽装  
+  
+-   クッキー ベースのセッションの状態  
+  
+-   HttpContext.Current  
+  
+-   カスタム HttpModule を経由するパイプライン拡張  
+  
+ WCF サービスが ASP.NET のコンテキストで機能し、HTTP 経由でのみ通信する必要がある場合は、WCF の ASP.NET 互換モードを使用できます。  このモードは、`aspNetCompatibilityEnabled` 属性がアプリケーション レベルで `true` に設定されている場合に有効です。  サービス実装では、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> クラスを使用して互換モードで実行できる機能を宣言する必要があります。  互換モードが有効な場合、  
+  
+-   ASP.NET ファイル\/URL 承認が、WCF 承認の前に強制的に実行されます。  承認決定は、要求のトランスポート レベルの ID に基づいています。  メッセージ レベルでの ID は、無視されます。  
+  
+-   WCF サービス操作は、ASP.NET の偽装コンテキストで実行を開始します。  ASP.NET の偽装と WCF の偽装の両方が特定のサービスで有効な場合は、WCF の偽装コンテキストが適用されます。  
+  
+-   HttpContext.Current を WCF サービス コードから使用できるため、サービスは非 HTTP エンドポイントを公開しません。  
+  
+-   WCF 要求は、ASP.NET パイプラインによって処理されます。  受信要求を処理するように構成された HttpModules は、WCF 要求も処理できます。  これらには、ASP.NET プラットフォーム コンポーネント \(<xref:System.Web.SessionState.SessionStateModule> など\) とカスタム サードパーティ モジュールが含まれます。  
+  
+## 例  
+ 次のコード サンプルは、ASP 互換モードを有効にする方法を示します。  
+  
+## コード  
+  
+```  
+<serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)   
+ [WCF サービスと ASP.NET](../../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicemetadata.md b/docs/framework/configure-apps/file-schema/wcf/servicemetadata.md
new file mode 100644
index 00000000000..45f7c5c2af2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicemetadata.md
@@ -0,0 +1,137 @@
+---
+title: "&lt;serviceMetadata&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 2b4c3b4c-31d4-4908-a9b7-5bb411c221f2
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# &lt;serviceMetadata&gt;
+サービス メタデータと関連情報の公開を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceMetadata   
+    externalMetadataLocation="String"  
+    httpGetBinding=”String”  
+    httpGetBindingConfiguration=”String”  
+    httpGetEnabled="Boolean"   
+    httpGetUrl="String"  
+    httpsGetBinding=”String”  
+    httpsGetBindingConfiguration=”String”  
+    httpsGetEnabled="Boolean"   
+    httpsGetUrl="String"  
+    policyVersion="Policy12/Policy15"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|externalMetadataLocation|WSDL ファイルの位置を含む URI。これは、自動生成される WSDL の代わりに、WSDL 要求および MEX 要求に応答してユーザーに返されます。  この属性が設定されていない場合は、既定の WSDL が返されます。  既定値は空の文字列です。|  
+|httpGetBinding|HTTP GET 経由でメタデータを取得する場合に使用するバインディングの種類を指定する文字列。  この設定は省略可能です。  指定しない場合、既定のバインディングが使用されます。<br /><br /> <xref:System.ServiceModel.Channels.IReplyChannel> をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの <xref:System.ServiceModel.Channels.MessageVersion%2A> プロパティが <xref:System.ServiceModel.Channels.MessageVersion.None%2A> である必要があります。|  
+|httpGetBindingConfiguration|このバインディングの追加の構成情報を参照する `httpGetBinding` 属性に指定されるバインディングの名前を設定する文字列。  同じ名前を `<bindings>` セクションに定義する必要があります。|  
+|httpGetEnabled|HTTP\/Get 要求を使用した取得用にサービス メタデータを公開するかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> httpGetUrl 属性が指定されていない場合、メタデータが公開されるアドレスは、サービス アドレスに "?wsdl" を加えたものになります。  たとえば、サービス アドレスが "http:\/\/localhost:8080\/CalculatorService" の場合、HTTP\/Get メタデータ アドレスは、"http:\/\/localhost:8080\/CalculatorService?wsdl" になります。<br /><br /> このプロパティが `false` の場合、あるいはサービスのアドレスが HTTP または HTTPS に基づいていない場合、"?wsdl" は無視されます。|  
+|httpGetUrl|HTTP\/Get 要求を使用した取得用にメタデータが公開されるアドレスを指定する URI。  相対 URI を指定した場合、サービスのベース アドレスに対する相対として処理されます。|  
+|httpsGetBinding|HTTPS GET 経由でメタデータを取得する場合に使用するバインディングの種類を指定する文字列。  この設定は省略可能です。  指定しない場合、既定のバインディングが使用されます。<br /><br /> <xref:System.ServiceModel.Channels.IReplyChannel> をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの <xref:System.ServiceModel.Channels.MessageVersion%2A> プロパティが <xref:System.ServiceModel.Channels.MessageVersion.None%2A> である必要があります。|  
+|httpsGetBindingConfiguration|このバインディングの追加の構成情報を参照する `httpsGetBinding` 属性に指定されるバインディングの名前を設定する文字列。  同じ名前を `<bindings>` セクションに定義する必要があります。|  
+|httpsGetEnabled|HTTPS\/Get 要求を使用した取得用にサービス メタデータを公開するかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> httpsGetUrl 属性が指定されていない場合、メタデータが公開されるアドレスは、サービス アドレスに "?wsdl" を加えたものになります。  たとえば、サービス アドレスが "https:\/\/localhost:8080\/CalculatorService" の場合、HTTP\/Get メタデータ アドレスは、"https:\/\/localhost:8080\/CalculatorService?wsdl" になります。<br /><br /> このプロパティが `false` の場合、あるいはサービスのアドレスが HTTP または HTTPS に基づいていない場合、"?wsdl" は無視されます。|  
+|httpsGetUrl|HTTPS\/Get 要求を使用した取得用にメタデータが公開されるアドレスを指定する URI。|  
+|policyVersion|使用する WS\-Policy 仕様のバージョンを指定する文字列。  この属性は <xref:System.ServiceModel.Description.PolicyVersion> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ この構成要素を使用すると、サービスのメタデータ公開機能を制御できます。  サービスのメタデータには機密情報が含まれる可能性がありますが、意図的ではない開示を回避するために、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスの既定の構成では、メタデータは公開されないようになっています。  この動作は、既定の設定ではセキュリティで保護されますが、同時に、サービスの構成の中でメタデータ公開の動作が明示的に有効化されない限り、サービスの呼び出しに必要なクライアント コードをメタデータ インポート ツール \(Svcutil.exe など\) を使用して生成できないことも意味します。  この構成要素を使用すると、サービスのこの公開動作を有効にできます。  
+  
+ この動作を構成する詳細なコード例については、「[メタデータ公開動作](../../../../../docs/framework/wcf/samples/metadata-publishing-behavior.md)」を参照してください。  
+  
+ オプションの `httpGetBinding` 属性および `httpsGetBinding` 属性を使用すると、HTTP GET または HTTPS GET を介してメタデータを取得するバインディングを構成できます。  これらの属性を指定しない場合、メタデータの取得には、適切な既定のバインディグ \(HTTP の場合は `HttpTransportBindingElement`、HTTPS の場合は `HttpsTransportBindingElement`\) が使用されます。  これらの属性は、組み込みの WCF バインディングでは使用できないことに注意してください。  <xref:System.ServiceModel.Channels.IReplyChannel> をサポートする内部バインディング要素を使用したバインディングでのみサポートされます。  さらに、バインディングの <xref:System.ServiceModel.Channels.MessageVersion%2A> プロパティが <xref:System.ServiceModel.Channels.MessageVersion.None%2A> である必要があります。  
+  
+ サービスが悪意のあるユーザーに公開されないようにするために、SSL over HTTP \(HTTPS\) 機構を使用して転送をセキュリティで保護できます。  転送を保護するには、まず、サービスをホストしているコンピューターの特定のポートに適切な X.509 証明書をバインドする必要があります。  \([!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)。\) 次に、この要素をサービス構成に追加し、`httpsGetEnabled` 属性を `true` に設定します。  最後に、次の例に示すように、`httpsGetUrl` 属性をサービス メタデータ エンドポイントの URL に設定します。  
+  
+```  
+<behaviors>  
+ <serviceBehaviors>  
+  <behavior name="NewBehavior">  
+    <serviceMetadata httpsGetEnabled="true"   
+     httpsGetUrl="https://myComputerName/myEndpoint" />  
+  </behavior>  
+ </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## 使用例  
+ 次の例では、\<serviceMetadata\> 要素を使用してメタデータを公開するサービスを構成します。  さらに、`IMetadataExchange` コントラクトを WS\-MetadataExchange \(MEX\) プロトコルの実装として公開するエンドポイントも構成します。  この例では、`mexHttpBinding` を使用します。これは使いやすい標準バインドで、セキュリティ モードが `None` に設定されている `wsHttpBinding` と同等です。  エンドポイントには、相対アドレスの "mex" が使用されています。このアドレスがサービスのベース アドレスに対して解決されると、エンドポイントのアドレスは http:\/\/localhost\/servicemodelsamples\/service.svc\/mex になります。  
+  
+```  
+<configuration>  
+<system.serviceModel>  
+  <services>  
+    <service   
+        name="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+      <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc  -->  
+      <endpoint address=""  
+                binding="wsHttpBinding"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      <!-- the mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex   
+           To expose the IMetadataExchange contract, you   
+           must enable the serviceMetadata behavior as demonstrated below -->  
+      <endpoint address="mex"  
+                binding="mexHttpBinding"  
+                contract="IMetadataExchange" />  
+    </service>  
+  </services>  
+  
+  <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior">  
+        <!-- The serviceMetadata behavior publishes metadata through   
+             the IMetadataExchange contract. When this behavior is   
+             present, you can expose this contract through an endpoint   
+             as shown above. Setting httpGetEnabled to true publishes   
+             the service's WSDL at the <baseaddress>?wsdl  
+             eg. http://localhost/servicemodelsamples/service.svc?wsdl -->  
+        <serviceMetadata httpGetEnabled="True"/>  
+        <serviceDebug includeExceptionDetailInFaults="False" />  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+  
+</system.serviceModel>  
+  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceMetadataPublishingElement>   
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [メタデータ公開動作](../../../../../docs/framework/wcf/samples/metadata-publishing-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md b/docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md
new file mode 100644
index 00000000000..f6a0902bf22
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md
@@ -0,0 +1,58 @@
+---
+title: "&lt;servicePrincipalName&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f3b85d3-20f2-4cd8-8a6a-ee18befbd165
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;servicePrincipalName&gt;
+サービスの ID をサービス プリンシパル名 \(SPN\) により指定します。  
+  
+ SPN の設定の詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<servicePrincipalName value = "String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|クライアントがサービスのインスタンスを一意に識別する名前です。  フォレストの複数のコンピューターに 1 つのサービスの複数のインスタンスをインストールする場合、各インスタンスには独自の SPN が必要です。  クライアントが認証に使用できる複数の名前がある場合は、指定したサービス インスタンスに複数の SPN を設定できます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|クライアントで認証するサービスの ID を指定します。|  
+  
+## 解説  
+ この ID を持つエンドポイントに接続するセキュリティで保護された [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] クライアントは、エンドポイントの SSPI 認証を実行するときに SPN を使用します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ <xref:System.ServiceModel.SpnEndpointIdentity>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/services-of-workflowruntime.md b/docs/framework/configure-apps/file-schema/wcf/services-of-workflowruntime.md
new file mode 100644
index 00000000000..3bc089a0c09
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/services-of-workflowruntime.md
@@ -0,0 +1,26 @@
+---
+title: "&lt;workflowRuntime&gt; の &lt;services&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 219a05b1-f573-45c9-849b-e86bc373b62f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;workflowRuntime&gt; の &lt;services&gt;
+<xref:System.Workflow.Runtime.WorkflowRuntime> エンジンに追加されるサービスのコレクションを表します。  要素は、<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement> 型です。  コレクションで指定されたサービスはワークフロー ランタイム エンジンによって初期化され、適切な <xref:System.Workflow.Runtime.WorkflowRuntime> コンストラクターが呼び出されるとワークフロー ランタイム エンジンのサービスに追加されます。  したがって、コレクションで指定されたサービスは、そのコンストラクターのシグネチャに関して一定の規則に従う必要があります。  詳細については、「<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>」を参照してください。  
+  
+## 参照  
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>   
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ [Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/services.md b/docs/framework/configure-apps/file-schema/wcf/services.md
new file mode 100644
index 00000000000..5c909afa45c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/services.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;services&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 80d76ba9-2058-48ad-9b91-5e4be7e5c113
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;services&gt;
+サービスは、設定ファイルの `services` セクションで定義されます。  各サービスには、独自の `service` 設定セクションがあります。  
+  
+ \<system.ServiceModel\>  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+        <services>  
+        <service>  
+        </service>  
+        </services>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<service\>](../../../../../docs/framework/configure-apps/file-schema/wcf/service.md)|サービス コントラクト、動作、および特定のサービスのエンドポイントを定義します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)|すべての Windows Communication Foundation \(WCF\) 構成要素のルート要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServicesSection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md b/docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md
new file mode 100644
index 00000000000..05d3bd5b13a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md
@@ -0,0 +1,89 @@
+---
+title: "&lt;serviceSecurityAudit&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba517369-a034-4f8e-a2c4-66517716062b
+caps.latest.revision: 17
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 17
+---
+# &lt;serviceSecurityAudit&gt;
+サービス操作中にセキュリティ イベントの監査を有効にする設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceSecurityAudit   
+   auditLogLocation="Default/Application/Security"  
+   messageAuthenticationAuditLevel= None/Success/Failure/SuccessAndFailure"  
+   serviceAuthorizationAuditLevel="None/Success/Failure/SuccessAndFailure"  
+   suppressAuditFailure="Boolean"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|auditLogLocation|監査ログの場所を指定します。  以下の値が有効です。<br /><br /> -   Default: セキュリティ イベントは、Windows XP のアプリケーション ログと、Windows Server 2003 および Windows Vista のイベント ログに書き込まれます。<br />-   Application: 監査イベントは、アプリケーション イベント ログに書き込まれます。<br />-   Security: 監査イベントは、セキュリティ イベント ログに書き込まれます。<br /><br /> 既定値は Default です。  詳細については、「<xref:System.ServiceModel.AuditLogLocation>」を参照してください。|  
+|suppressAuditFailure|監査ログへの書き込みエラーを非表示にする動作を指定します。<br /><br /> アプリケーションには、監査ログへの書き込みエラーを通知する必要があります。  アプリケーションが監査エラーを処理するように設計されていない場合は、この属性を使用して、監査ログへの書き込みでのエラーが表示されないようにする必要があります。<br /><br /> この属性が `true` の場合、監査イベントの書き込み試行の結果発生する例外 \(ただし、OutOfMemoryException、StackOverFlowException、ThreadAbortException、および ArgumentException を除く\) はシステムによって処理され、アプリケーションには伝達されません。  この属性が `false` の場合、監査イベントの書き込み試行の結果発生する例外は、すべてアプリケーションまで渡されます。<br /><br /> 既定値は、`true` です。|  
+|serviceAuthorizationAuditLevel|監査ログに記録される承認イベントの種類を指定します。  以下の値が有効です。<br /><br /> -   None: サービス承認イベントの監査が実行されます。<br />-   Success: 成功したサービス承認イベントだけが監査されます。<br />-   Failure: 失敗したサービス承認イベントだけが監査されます。<br />-   SuccessAndFailure: 成功と失敗の両方のサービス承認イベントが監査されます。<br /><br /> 既定値は None です。  詳細については、「<xref:System.ServiceModel.AuditLevel>」を参照してください。|  
+|messageAuthenticationAuditLevel|ログに記録されるメッセージ認証監査イベントの種類を指定します。  以下の値が有効です。<br /><br /> -   None: 監査イベントは生成されません。<br />-   Success: 成功するセキュリティ \(メッセージの署名の検証、暗号、およびトークンの検証を含む完全な検証\) イベントだけがログに記録されます。<br />-   Failure: 失敗したイベントだけがログに記録されます。<br />-   SuccessAndFailure: 成功と失敗の両方のイベントがログに記録されます。<br /><br /> 既定値は None です。  詳細については、「<xref:System.ServiceModel.AuditLevel>」を参照してください。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ この構成要素は、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] 認証イベントの監査に使用されます。  監査を有効にすると、成功した認証、失敗した認証、またはその両方を監査できます。  イベントは、3 種類のイベント ログ \(アプリケーション ログ、セキュリティ ログ、およびオペレーティング システムのバージョンに対する既定のログ\) のいずれかに書き込まれます。  イベント ログはすべて、Windows イベント ビューアーを使用して表示できます。  
+  
+ この構成要素の詳細な使用例については、「[サービス監査動作](../../../../../docs/framework/wcf/samples/service-auditing-behavior.md)」を参照してください。  
+  
+ 監査イベントは既定で、Windows XP の場合はアプリケーション ログに、Windows Server 2003 と Windows Vista の場合はセキュリティ ログに表示されます。  監査イベントの場所は、`auditLogLocation` 属性を "Application" または "Security" に設定することによって指定できます。  詳細については、「[方法 : セキュリティ イベントを監査する](../../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)」を参照してください。  イベントをセキュリティ ログに書き込む場合は、\[ローカル セキュリティ ポリシー\] \-\> \[オブジェクト アクセスの監査\] で、\[成功\] と \[失敗\] の各チェック ボックスをオンにする必要があります。  
+  
+ イベント ログを調べる場合、監査イベントのソースは "ServiceModel Audit 3.0.0.0" です。  メッセージ認証監査レコードには "MessageAuthentication" のカテゴリ、サービス承認監査レコードには "ServiceAuthorization" のカテゴリが設定されます。  
+  
+ メッセージ認証監査イベントは、メッセージの改ざんや期限切れの有無、クライアントによるサービス認証の成否などに適用されます。  このイベントでは、認証の成功または失敗に関する情報とクライアント ID、およびメッセージ送信先のエンドポイントとそのメッセージに関連付けられたアクションに関する情報が提供されます。  
+  
+ サービス承認監査イベントは、サービス承認マネージャーによって決定される承認に適用されます。  このイベントでは、承認の成功または失敗に関する情報とクライアント ID、メッセージ送信先のエンドポイント、そのメッセージに関連付けられたアクション、受信メッセージから生成された承認コンテキストの ID、およびアクセス決定を行った承認マネージャーの種類に関する情報が提供されます。  
+  
+## 使用例  
+  
+```  
+<system.serviceModel>  
+   <serviceBehaviors>  
+      <behavior name="NewBehavior">  
+         <serviceSecurityAudit auditLogLocation="Application"   
+             suppressAuditFailure="true"  
+             serviceAuthorizationAuditLevel="Success"   
+             messageAuthenticationAuditLevel="Success" />  
+      </behavior>  
+   </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceSecurityAuditElement>   
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>   
+ [セキュリティ動作](../../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [監査](../../../../../docs/framework/wcf/feature-details/auditing-security-events.md)   
+ [方法 : セキュリティ イベントを監査する](../../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)   
+ [サービス監査動作](../../../../../docs/framework/wcf/samples/service-auditing-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicethrottling.md b/docs/framework/configure-apps/file-schema/wcf/servicethrottling.md
new file mode 100644
index 00000000000..0fb72411f2b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicethrottling.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;serviceThrottling&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: a337d064-1e64-4209-b4a9-db7fdb7e3eaf
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# &lt;serviceThrottling&gt;
+WCF \(Windows Communication Foundation\) サービスの調整機構を指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceThrottling maxConcurrentCalls="Integer"  
+    maxConcurrentInstances="Integer"  
+    maxConcurrentSessions="Integer" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|maxConcurrentCalls|<xref:System.ServiceModel.ServiceHost> で同時に処理できるメッセージ数を制限する正の整数。  制限を超えた呼び出しはキューに置かれます。  この値を 0 に設定することは、Int32.MaxValue に設定することと同じです。  既定値は 16 x プロセッサ数です。|  
+|maxConcurrentInstances|<xref:System.ServiceModel.ServiceHost> で同時に実行できる <xref:System.ServiceModel.InstanceContext> オブジェクト数を制限する正の整数。  追加インスタンスの作成要求は、キューに置かれ、制限下のスロットが利用できるようになったときに完了されます。  既定値は maxConcurrentSessions と MaxConcurrentCalls の合計です。|  
+|maxConcurrentSessions|<xref:System.ServiceModel.ServiceHost> オブジェクトが受け入れることのできるセッション数を制限する正の整数。<br /><br /> サービスは制限を超える接続を受け入れますが、制限内のチャネルだけがアクティブです \(メッセージがチャネルから読み取られます\)。  この値を 0 に設定することは、Int32.MaxValue に設定することと同じです。  既定値は 100 x プロセッサ数です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ 調整コントロールは、同時呼び出し、同時インスタンス、または同時セッションの数を制限して、リソースの過剰消費を防ぎます。  
+  
+ 属性の値に到達するたびにトレースが出力されます。  最初のトレースは警告として出力されます。  
+  
+## 使用例  
+ 次の構成例では、サービスで同時呼び出しの最大数を 2 に、同時インスタンスの最大数を 10 に制限することを指定しています。  この例の実行例の詳細については、「[調整](../../../../../docs/framework/wcf/samples/throttling.md)」を参照してください。  
+  
+```  
+<behaviors>   
+  <serviceBehaviors>   
+    <behavior name="CalculatorServiceBehavior">   
+      <serviceDebug includeExceptionDetailInFaults="False" />   
+      <serviceMetadata httpGetEnabled="True"/>   
+      <!-- Specify throttling behavior -->  
+      <serviceThrottling maxConcurrentCalls="2"   
+           maxConcurrentInstances="10"/>   
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>   
+ <xref:System.ServiceModel.Configuration.ServiceThrottlingElement>   
+ [WCF サービス パフォーマンスを制御するための ServiceThrottlingBehavior の使用](../../../../../docs/framework/wcf/feature-details/using-servicethrottlingbehavior-to-control-wcf-service-performance.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/servicetimeouts.md b/docs/framework/configure-apps/file-schema/wcf/servicetimeouts.md
new file mode 100644
index 00000000000..235b78011c8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/servicetimeouts.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;serviceTimeouts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ada536cf-97dc-4cd7-89ec-ed1466c1c557
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;serviceTimeouts&gt;
+サービスのタイムアウトを指定します。  
+  
+## 構文  
+  
+```  
+  
+<serviceTimeouts transactionTimeout="TimeSpan" />  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`transactionTimeout`|クライアントからサーバーへのトランザクションが発生するまでに待機できる時間を指定する <xref:System.TimeSpan> 値。  既定値は “00:00:00” です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceTimeoutsElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/soapprocessing.md b/docs/framework/configure-apps/file-schema/wcf/soapprocessing.md
new file mode 100644
index 00000000000..d9f1ec25809
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/soapprocessing.md
@@ -0,0 +1,57 @@
+---
+title: "&lt;soapProcessing&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8707027-e6b8-4539-893d-3cd7c13fbc18
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;soapProcessing&gt;
+異なるバインディングの種類およびメッセージ バージョンの間でメッセージのマーシャリングに使用されるクライアント エンドポイントの動作を定義します。  
+  
+## 構文  
+  
+```  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|processMessages|SOAP メッセージ バージョン間のメッセージをマーシャリングするかどうかを指定するブール値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 解説  
+ SOAP 処理は、メッセージ バージョン間でメッセージが変換されるプロセスです。  
+  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ルーティング サービスは、あるプロトコルから別のプロトコルにメッセージを変換できます。  受信メッセージのバージョンと送信メッセージのバージョンが異なる場合、新しいメッセージが正しいバージョンで作成されます。  受信 [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージの本文および関連するヘッダーが含まれた新しい [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージを作成することで、ある <xref:System.ServiceModel.Channel.MessageVersion> から別のメッセージ バージョンへのメッセージの変換が完了します。  アドレス指定に固有のヘッダーまたはルーター レベルで認識されるヘッダーは、新しい WCF メッセージの作成に使用されません。これらのヘッダーは、異なるバージョンであるか \(アドレス指定ヘッダーの場合\)、クライアントとルーターの間の通信の一部として処理されているためです。  
+  
+ 発信メッセージにヘッダーが配置されるかどうかは、受信チャネル層を介して渡されたと認識されるようにマークされているかどうかによって決まります。  認識されないヘッダー \(カスタム ヘッダーなど\) は削除されずに送信メッセージにコピーされ、ルーティング サービスを介して渡されます。  メッセージの本文は、送信メッセージにコピーされます。  そして、メッセージは送信チャネルに送信されます。この時点で、すべてのヘッダー、および使用されている通信プロトコル\/トランスポートに固有のエンベロープ データが作成され、追加されます。  
+  
+ このような処理手順は、SOAP 処理動作が指定されているときに行われます。  この [\<soapProcessingExtension\>](../../../../../docs/framework/configure-apps/file-schema/wcf/soapprocessing.md) 動作は、ルーティング サービスが開始されたときに、すべてのクライアント \(送信\) エンドポイントに適用されるエンドポイントの動作です。  既定では、[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md) 動作によって、クライアント エンドポイントごとに `processMessages` が `true` に設定された新しい [\<soapProcessingExtension\>](../../../../../docs/framework/configure-apps/file-schema/wcf/soapprocessing.md) 動作が作成およびアタッチされます。  ルーティング サービスが認識しないプロトコルを使用している場合や既定の処理動作をオーバーライドする場合は、ルーティング サービス全体または特定のエンドポイントにおいて SOAP 処理を無効にできます。すべてのエンドポイントのルーティング サービス全体で SOAP 処理を無効にするには、[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md) 動作の `soapProcessing` 属性を `false` に設定します。  特定のエンドポイントで SOAP 処理を無効にするには、この動作を使用して `processMessages` 属性を `false` に設定してから、既定の処理コードを実行しないエンドポイントにこの動作をアタッチします。[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md) 動作がルーティング サービスを設定するときには、サービスが既に存在しているため、エンドポイントの動作の再適用はスキップされます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Routing.Configuration.> SoapProcessingExtensionElement?qualifyHint=False&autoUpgrade=True   
+ <xref:System.ServiceModel.Routing.SoapProcessingBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md b/docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md
new file mode 100644
index 00000000000..808930ddcb5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;sslStreamSecurity&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 430a378b-a742-4858-8a12-9f9b235fd627
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# &lt;sslStreamSecurity&gt;
+SSL ストリームを使用してチャネル セキュリティをサポートするカスタム バインド要素を表します。  
+  
+## 構文  
+  
+```  
+  
+<sslStreamSecurity requireClientCertificate="Boolean"  
+      sslProtocols="Ssl3|Tls|Tls11|Tls12" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|requireClientCertificate|クライアント証明書がこのバインディングに必要かどうかを指定するブール値。  既定値は、`false` です。|  
+|sslProtocols|どの SslProtocols がサポートされているのかを指定する SslProtocols 列挙型フラグの値。  既定値は Ssl3&#124;Tls&#124;Tls11&#124;Tls12 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.SslStreamSecurityElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/standardendpoints.md b/docs/framework/configure-apps/file-schema/wcf/standardendpoints.md
new file mode 100644
index 00000000000..5548d2a2301
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/standardendpoints.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;standardEndpoints&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d62153d7-a6e6-462a-a784-cca61e9c2ba1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;standardEndpoints&gt;
+この構成セクションでは、再使用可能な構成済みのエンドポイントである標準エンドポイントのコレクションを定義できます。  標準エンドポイントは、固定値に設定されたアドレス、バインディング、およびコントラクトの 1 つ以上の属性を持ちます。  たとえば、探索エンドポイントでは、コントラクトが固定されています。  標準エンドポイントを使用して、カスタム バインディングの定義と同様に新しいプロパティを指定して、サービス エンドポイントを拡張することもできます。  
+  
+ \<system.ServiceModel\>  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+  
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<announcementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/announcementendpoint.md)|固定アナウンス コントラクトが含まれた標準エンドポイントを定義します。  サービスは、サービスが開いたとき、または閉じたときにオンラインおよびオフラインのアナウンス メッセージを送信することによって、その可用性をアナウンスすることもできます。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスは、[\<serviceDiscovery\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicediscovery.md) 要素でアナウンス エンドポイントを指定し、AnnouncementClient を使用してアナウンスを実行します。  他のサービスからのアナウンスをリッスンしようとするクライアントは、実際に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスとして動作します。このため、[\<services\>](../../../../../docs/framework/configure-apps/file-schema/wcf/services.md) セクションに、このクライアントのアナウンス エンドポイントを構成する必要があります。|  
+|[\<discoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/discoveryendpoint.md)|固定探索コントラクトが含まれた標準エンドポイントを定義します。  サービスの構成に追加すると、この要素により、探索メッセージをリッスンする場所が指定されます。  クライアントの構成に追加すると、この要素により、探索クエリの送信先となる場所が指定されます。|  
+|[\<dynamicEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/dynamicendpoint.md)|この構成要素は、アプリケーションが、実行時に動的にエンドポイント アドレスを検索するクライアント プログラムとして機能するための情報を格納する標準エンドポイントを定義します。|  
+|[\<mexEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/mexendpoint.md)|固定 IMetadataExchange コントラクトが含まれた標準エンドポイントを定義します。  IMetadataExchange はすべてのメタデータ交換エンドポイントでコントラクトとして指定されるため、独自のエンドポイントを定義せずにこの標準エンドポイントを使用できます。|  
+|[\<udpAnnoucementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md)|サービスが UDP バインディングでアナウンス メッセージを送信するために使用する標準エンドポイントを定義します。  これには固定コントラクトがあり、2 つの探索のバージョンをサポートします。  また、WS\-Discovery の仕様 \(WS\-Discovery April 2005 または WS\-Discovery V1.1\) に規定された固定 UDP バインディングと既定のアドレスも備えています。  アナウンス メッセージの送受信に使用するマルチキャスト アドレスを指定できます。|  
+|[\<udpDiscoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md)|UDP マルチキャスト バインディングを使用した探索操作用に事前に構成される標準エンドポイントを定義します。  このエンドポイントには固定コントラクトがあり、WS\-Discovery プロトコルの 2 つのバージョンをサポートします。  また、WS\-Discovery の仕様 \(WS\-Discovery April 2005 または WS\-Discovery V1.1\) に規定された固定 UDP バインディングと既定のアドレスも備えています。|  
+|[\<webHttpEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpendpoint.md)|[\<webHttp\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttp.md) の動作を自動的に追加する固定の [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) バインディングを持つ標準エンドポイントを定義します。  このエンドポイントは、REST サービスを作成する場合に使用します。|  
+|[\<webScriptEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webscriptendpoint.md)|[\<enableWebScript\>](../../../../../docs/framework/configure-apps/file-schema/wcf/enablewebscript.md) の動作を自動的に追加する固定の [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) バインディングを持つ標準エンドポイントを定義します。  このエンドポイントは、ASP.NET AJAX アプリケーションから呼び出されるサービスを作成する場合に使用します。|  
+|[\<workflowControlEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/workflowcontrolendpoint.md)|ワークフロー インスタンスの実行の制御 \(作成、実行、保留、終了など\) に使用する標準エンドポイントを定義します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<system.ServiceModel\>|すべての WCF 構成要素のルート要素です。|  
+  
+## 参照  
+ [標準エンドポイント](../../../../../docs/framework/wcf/feature-details/standard-endpoints.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/state-of-wcf-workflowinstancequery.md b/docs/framework/configure-apps/file-schema/wcf/state-of-wcf-workflowinstancequery.md
new file mode 100644
index 00000000000..d060ecc998a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/state-of-wcf-workflowinstancequery.md
@@ -0,0 +1,103 @@
+---
+title: "WCF の &lt;state&gt;、&lt;workflowInstanceQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40f21055-766c-4be9-86c4-d1d899007098
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;state&gt;、&lt;workflowInstanceQuery&gt;
+追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクション。|  
+  
+## 解説  
+ 返されたレコードは、このコレクションの状態でフィルター処理されます。  
+  
+ 次の表に、有効な状態の値を示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|Aborted|ワークフロー インスタンスは中止されました。|  
+|Completed|ワークフロー インスタンスは完了しました。|  
+|Deleted|ワークフロー インスタンスは削除されました。|  
+|Idle|ワークフロー インスタンスはアイドル状態です。|  
+|Persisted|ワークフロー インスタンスは永続化されました。|  
+|Resumed|ワークフロー インスタンスが再開されました。|  
+|Started|ワークフロー インスタンスが開始されました。|  
+|UnhandledException|ワークフロー インスタンスで未処理の例外が発生しました。|  
+|アンロード|ワークフロー インスタンスはアンロードされました。|  
+|Canceled|ワークフロー インスタンスは取り消されました。|  
+|Suspended|ワークフロー インスタンスが中断されています。|  
+|Terminated|ワークフロー インスタンスは終了しました。|  
+|Unsuspended|ワークフロー インスタンスの中断が解除されました。|  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/states-of-wcf-workflowinstancequery.md b/docs/framework/configure-apps/file-schema/wcf/states-of-wcf-workflowinstancequery.md
new file mode 100644
index 00000000000..bca584fd8cd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/states-of-wcf-workflowinstancequery.md
@@ -0,0 +1,103 @@
+---
+title: "WCF の &lt;states&gt;、&lt;workflowInstanceQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d17f7525-8035-4e9e-85a0-4cddae59f85d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;states&gt;、&lt;workflowInstanceQuery&gt;
+追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md)|開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡するクエリ。|  
+  
+## 解説  
+ 返されたレコードは、このコレクションの状態でフィルター処理されます。  
+  
+ 次の表に、有効な状態の値を示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|Aborted|ワークフロー インスタンスは中止されました。|  
+|Completed|ワークフロー インスタンスは完了しました。|  
+|Deleted|ワークフロー インスタンスは削除されました。|  
+|Idle|ワークフロー インスタンスはアイドル状態です。|  
+|Persisted|ワークフロー インスタンスは永続化されました。|  
+|Resumed|ワークフロー インスタンスが再開されました。|  
+|Started|ワークフロー インスタンスが開始されました。|  
+|UnhandledException|ワークフロー インスタンスで未処理の例外が発生しました。|  
+|アンロード|ワークフロー インスタンスはアンロードされました。|  
+|Canceled|ワークフロー インスタンスは取り消されました。|  
+|Suspended|ワークフロー インスタンスが中断されています。|  
+|Terminated|ワークフロー インスタンスは終了しました。|  
+|Unsuspended|ワークフロー インスタンスの中断が解除されました。|  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/synchronousreceive-element.md b/docs/framework/configure-apps/file-schema/wcf/synchronousreceive-element.md
new file mode 100644
index 00000000000..0a967884aa9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/synchronousreceive-element.md
@@ -0,0 +1,49 @@
+---
+title: "&lt;synchronousReceive&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc070387-3d11-4b02-a952-bc08ad2df05a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;synchronousReceive&gt; 要素
+この構成要素は、サービスまたはクライアント アプリケーションでメッセージを受信する場合のランタイム動作を指定するために使用されます。  属性や子要素はありません。  
+  
+## 構文  
+  
+```  
+  
+<synchronousReceive />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 解説  
+ この動作を使用して、既定の非同期受信ではなく同期受信を使用するようにチャネル リスナーに指示します。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、受け入れた各チャネルに対して新しい処理スレッドを発行します。  チャネルが多数ある場合は、スレッドが不足する可能性があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.SynchronousReceiveElement>   
+ <xref:System.ServiceModel.Description.SynchronousReceiveBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md b/docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md
new file mode 100644
index 00000000000..0ef889431af
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;system.runtime.serialization&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8cebf4c-06d2-4667-8f5b-c3e1fc90df6f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;system.runtime.serialization&gt;
+<xref:System.Runtime.Serialization> 名前空間セクションのルート要素を表し、<xref:System.Runtime.Serialization.DataContractSerializer> のオプションを設定するための要素を含みます。  
+  
+ system.runtime.serialization  
+  
+## 構文  
+  
+```  
+  
+<configuration>  
+  <system.runtime.serialization>  
+    <dataContractSerializer ignoreExtensionDataObject="Boolean"  
+      maxItemsInObjectGraph="Integer">  
+      <declaredTypes>  
+        <add type="String ">  
+          <knownType type="String">  
+             <parameter index="Integer"/>  
+          </knownType>  
+        </add>  
+      </declaredTypes>  
+    <dataContractSerializer>  
+  </system.runtime.serialization>  
+</configuration>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<dataContractSerializer\>](../../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md)|逆シリアル化時に使用される既知の型の追加を可能にします。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|構成の最上位の要素。|  
+  
+## 参照  
+ <xref:System.Runtime.Serialization>   
+ [データ コントラクトの使用](../../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [既知のデータ コントラクト型](../../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md b/docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md
new file mode 100644
index 00000000000..5f6d053d5b2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/system-servicemodel-activation.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;system.serviceModel.activation&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0cae85f-56cb-4030-8807-6f96edff8d2d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;system.serviceModel.activation&gt;
+この構成セクションは、SMSvcHost.exe ツールの構成設定を表します。  構成要素は、SMSvcHost.exe.config ファイルで構成できます。  特にここには、構成される必要があるコンピューター全体のすべての設定が含まれます。  
+  
+## サンプル構成ファイル  
+ 次は、リスナー プロセス SMSvcHost.exe で使用されるサンプル構成ファイル \(SMSvcHost.exe.config\) です。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <gcConcurrent enabled="false" />  
+   </runtime>  
+   <system.serviceModel.activation>  
+       <net.tcp listenBacklog="10"  
+          maxPendingAccepts="2"  
+          maxPendingConnections="100"  
+          receiveTimeout="00:00:10"  
+          teredoEnabled="false">  
+          <allowAccounts>  
+             <!-- LocalSystem account -->  
+             <add securityIdentifier="S-1-5-18"/>  
+             <!-- LocalService account -->  
+             <add securityIdentifier="S-1-5-19"/>  
+             <!-- Network Service account -->  
+            <add securityIdentifier="S-1-5-20"/>   
+             <!-- Administrators account -->  
+            <add securityIdentifier="S-1-5-32-544" />   
+             <!-- IIS_IUSRS account (Vista only) -->  
+             <add securityIdentifier="S-1-5-32-568"/>  
+           </allowAccounts>  
+       </net.tcp>  
+       <net.pipe maxConnectionsPendingDispatch="100"  
+          maxPendingAccepts="2"  
+          receiveTimeout="00:00:10">  
+          <allowAccounts>  
+             <!-- LocalSystem account -->  
+             <add securityIdentifier="S-1-5-18"/>  
+             <!-- LocalService account -->  
+             <add securityIdentifier="S-1-5-19"/>  
+             <!-- Network Service account -->  
+            <add securityIdentifier="S-1-5-20"/>   
+             <!-- Administrators account -->  
+            <add securityIdentifier="S-1-5-32-544" />   
+             <!-- IIS_IUSRS account (Vista only) -->  
+             <add securityIdentifier="S-1-5-32-568"/>  
+           </allowAccounts>  
+       </net.pipe>  
+       <diagnostics performanceCountersEnabled="true" />  
+   </system.serviceModel.activation>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.Configuration>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md b/docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md
new file mode 100644
index 00000000000..0f5291e10a5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md
@@ -0,0 +1,137 @@
+---
+title: "&lt;system.serviceModel&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#system.ServiceModel"
+  - "http://schemas.microsoft.com/.NetConfiguration/v2.0#configuration/system.ServiceModel"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "<system.serviceModel> 要素"
+  - "system.serviceModel 要素"
+ms.assetid: 78519531-ad7a-40d3-b3e7-42f1103d8854
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# &lt;system.serviceModel&gt;
+この構成セクションは、すべての [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ServiceModel 構成要素を含みます。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <behaviors>  
+    </behaviors>  
+    <bindings>  
+    </bindings>  
+    <client>  
+    </client>  
+    <comContracts>  
+    </comContracts>  
+    <commonBehaviors>  
+    </commonBehaviors>  
+    <diagnostics>  
+    </diagnostics>  
+    <extensions>  
+    </extensions>  
+    <protocolMapping>  
+    </protocolMapping>  
+    <routing>  
+    </routing>  
+    <serviceHostingEnvironment>  
+    </serviceHostingEnvironment>  
+    <services>  
+    </services>  
+    <standardEndpoints>  
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)|このセクションは、`endpointBehaviors` と`serviceBehaviors` という 2 つの子コレクションを定義します。  各コレクションは、エンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。  各動作要素は、その一意の `name` 属性で識別されます。|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|このセクションには、標準バインディングおよびカスタム バインディングのコレクションが保持されます。  各エントリは、その一意の `name` により識別されます。  サービスは、`name` を使用してバインディングをリンクすることにより、バインディングを使用します。|  
+|[\<client\>](../../../../../docs/framework/configure-apps/file-schema/wcf/client.md)|このセクションは、クライアントがサービスの接続に使用するエンドポイントの一覧を含みます。|  
+|[\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)|このセクションは、WCF と COM 相互運用が有効な COM コントラクトを定義します。|  
+|[\<commonBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md)|このセクションは、machine.config ファイルでだけ定義できます。  このセクションは、`endpointBehaviors` と`serviceBehaviors` という 2 つの子コレクションを定義します。  各コレクションは、コンピューター上の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のすべてのエンドポイントとサービスによって使用されるそれぞれの動作要素を定義します。  ある動作が `<commonBehaviors>` と `<behaviors>` の両方のセクションで定義されている場合は、\<behaviors\> セクション内の動作が優先されます。|  
+|[\<extensions\>](../../../../../docs/framework/configure-apps/file-schema/wcf/extensions-section.md)|このセクションには、拡張のコレクションが含まれています。これにより、ユーザー定義のバインディング、動作、およびその他の拡張機能を作成できるようになります。|  
+|[\<diagnostics\>](../../../../../docs/framework/configure-apps/file-schema/wcf/diagnostics.md)|このセクションには、WCF の診断機能の設定が含まれます。  ユーザーはトレース、パフォーマンス カウンター、および WMI プロバイダーを有効または無効にしたり、カスタム メッセージ フィルターを追加したりできます。|  
+|[\<protocolMapping\>](../../../../../docs/framework/configure-apps/file-schema/wcf/protocolmapping.md)|このセクションは、トランスポート プロトコル スキーム \(http、net.tcp、net.pipe など\) と WCF バインディング間の既定のプロトコル マッピング セットを定義します。|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing.md)|このセクションは、受信メッセージの評価に使用される [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] <xref:System.ServiceModel.Dispatcher.MessageFilter> の種類を定義するルーティング フィルター セットと、フィルターが一致するときにメッセージを送信するターゲット エンドポイントを指定するルーティング テーブルを定義します。|  
+|[\<serviceHostingEnvironment\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)|このセクションは、環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。  このセクションが空の場合は、既定の型が使用されます。|  
+|[\<services\>](../../../../../docs/framework/configure-apps/file-schema/wcf/services.md)|このセクションには、サービスのコレクションが含まれています。  アセンブリで定義された各サービスの場合、この要素は、サービスの設定を指定する `service` 要素を含みます。|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|このセクションは、再使用可能な構成済みのエンドポイントである標準エンドポイントのコレクションを定義します。  標準エンドポイントは、固定値に設定されたアドレス、バインディング、およびコントラクトの 1 つ以上の属性を持ちます。  たとえば、探索エンドポイントでは、コントラクトが固定されています。  標準エンドポイントを使用して、カスタム バインディングの定義と同様に新しいプロパティを指定して、サービス エンドポイントを拡張することもできます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<configuration\>|.NET 構成ファイルのすべての構成要素のルート要素。|  
+  
+## 解説  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、他の製品の構成セクションに要素を追加しません。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスは、構成ファイルの `services` セクションで定義されます。  アセンブリには、任意の数のサービスを含めることができます。  各サービスには、独自の `service` 設定セクションがあります。  セクションとその内容は、サービス コントラクト、動作、および特定のサービスのエンドポイントを定義します。  
+  
+ サービスの `name` 属性だけが必須項目です。  既定では、サービスの名前は、サービスの実装に使用される、基になる CLR 型を示します。ただし、<xref:System.ServiceModel.ServiceContractAttribute> の ConfigurationName プロパティを変更して、CLR 型要件をオーバーライドすることもできます。  
+  
+ `behaviorConfiguration` 属性は省略できます。  サービスが使用するサービス動作を識別します。  この属性で指定された動作は、同じ構成ファイルの範囲内に定義されたサービス動作にリンクしている必要があります。  たとえば、同一ファイルまたは親ファイルです。  
+  
+ 各サービスでは、`endpoint` 要素で定義された 1 つまたは複数のエンドポイントが公開されます。  各エンドポイントには、独自のアドレスおよびバインディングがあります。  構成ファイル内で使用されるすべてのバインディングは、そのファイルのスコープ内で定義される必要があります。  
+  
+ バインディングは、`name` 属性と `bindingConfiguration` 属性の組み合わせによってエンドポイントにリンクされます。  `binding` 属性は、バインディングが定義されているセクションで定義します。  `bindingConfiguration` 属性は、バインディング セクション内で使用される構成済みバインディングを定義します。  バインディング セクションでは、複数の構成済みバインディングを定義できます。  
+  
+## 使用例  
+ これは、WCF 構成ファイルの例です。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <behaviors>  
+           <!-- List of Behaviors -->  
+        </behaviors>  
+        <client>  
+           <!-- List of Endpoints -->  
+        </client>  
+        <diagnostics wmiProviderEnabled="false" performanceCountersEnabled="false" tracingEnabled="false">  
+        </diagnostics>  
+        <serviceHostingEnvironment>  
+           <!-- List of entries -->  
+        </serviceHostingEnvironment>  
+        <comContracts>  
+           <!-- List of COM+ Contracts -->  
+        </comContracts>          
+        <services>  
+           <!-- List of Services -->  
+        </services>  
+        <bindings>  
+           <!-- List of Bindings -->  
+        </bindings>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceModelSectionGroup>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/tcptransport.md b/docs/framework/configure-apps/file-schema/wcf/tcptransport.md
new file mode 100644
index 00000000000..5874ffa17b3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/tcptransport.md
@@ -0,0 +1,78 @@
+---
+title: "&lt;tcpTransport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 8fcd18c1-9958-42e7-b442-7903f7bdb563
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;tcpTransport&gt;
+カスタム バインディングのメッセージを転送するためにチャネルで使用できる TCP トランスポートを定義します。  
+  
+## 構文  
+  
+```  
+  
+<tcpTransport   
+    listenBacklog="Integer"  
+        portSharingEnabled="Boolean"  
+    teredoEnabled="Boolean"  
+    transferMode=”Buffered/Streamed”  
+        <connectionPoolSettings  
+          groupName=”String”  
+        idleTimeout"TimeSpan"  
+        leaseTimeout="TimeSpan"  
+        maxOutboundConnectionsPerEndpopint=”Integer” />  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|channelInitializationTimeout|接続が切断されるまでのチャネルの初期化ステータスの最大時間 \(秒単位\)。  このクォータは、.Net メッセージ フレーム プロトコルを使用して TCP 接続が接続を認証するのに必要な時間を含みます。  クライアントは、サーバーが認証を実行するための十分な情報を得る前に初期データを送信する必要があります。  既定値は 30 秒です。|  
+|listenBacklog|Web サービスの保留可能なキュー内の接続要求の最大数。  `connectionLeaseTimeout` 属性は、クライアントが接続されるのを待つ時間を制限します。この時間が経過すると接続の例外をスローします。  これは、Web サービスに対して保留可能なキュー内の接続要求の最大数を制御するソケット レベルのプロパティです。  したがって、ListenBacklog が低すぎる場合、サーバーが既存のキュー内の接続の一部を確認するまで WCF は要求を受け入れを停止し、新しい接続を破棄します。既定値は 16 x Sql プロセッサの数です。|  
+|portSharingEnabled|TCP ポート共有をこの接続で有効にする場合に指定するブール値。  これが `false` の場合、各バインディングは独自の排他ポートを使用します。  既定値は、`false` です。<br /><br /> この設定は、サービスのみに関連します。  クライアントには影響はありません。<br /><br /> この設定を使用するには、\[スタートアップの種類\] を \[手動\] または \[自動\] に変更して、Windows Communication Foundation \(WCF\) の TCP ポート共有サービスを有効にする必要があります。|  
+|teredoEnabled|Teredo \(ファイアウォールの内側にあるクライアントをアドレス指定するためのテクノロジ\) が有効であるかどうかを指定するブール値。  既定値は、`false` です。<br /><br /> このプロパティは、基になる TCP ソケットで Tredo を有効にします。  詳細については、「[Teredo の概要](http://go.microsoft.com/fwlink/?LinkId=95339)」を参照してください。<br /><br /> このプロパティは [!INCLUDE[wxpsp2](../../../../../includes/wxpsp2-md.md)] および [!INCLUDE[ws2003](../../../../../includes/ws2003-md.md)] にのみ適用できます。  [!INCLUDE[wv](../../../../../includes/wv-md.md)] には、Teredo 用のコンピューター全体の構成オプションがあるので、Vista を実行する場合は、このプロパティは無視されます。  Teredo の場合、クライアント コンピューターおよびサービス コンピューターの両方に Microsoft IPv6 スタックをインストールし、Teredo 用に正しく設定する必要があります。  Teredo の構成の詳細については、「[Teredo の概要](http://go.microsoft.com/fwlink/?LinkId=95339)」を参照してください。  詳細については、「[Windows Server 2003 Technology Centers](http://go.microsoft.com/fwlink/?LinkId=49888)」を参照してください。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ このトランスポートは、"net.tcp:\/\/hostname:port\/path" の形式の URI を使用します。  他の URI コンポーネントは省略可能です。  
+  
+ `tcpTransport` 要素は、TCP トランスポート プロトコルを実装するカスタム バインディングを作成する場合の開始点となります。  このトランスポートは、WCF 間の通信用に最適化されています。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TcpTransportElement>   
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md b/docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md
new file mode 100644
index 00000000000..d162502cfd0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md
@@ -0,0 +1,83 @@
+---
+title: "&lt;textMessageEncoding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: e6d834d0-356e-45eb-b530-bbefbb9ec3f0
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;textMessageEncoding&gt;
+テキストベースの XML メッセージに使用される文字エンコーディングおよびメッセージ バージョン管理を指定します。  
+  
+## 構文  
+  
+```  
+  
+<textMessageEncoding maxReadPoolSize="Integer"  
+   maxWritePoolSize="Integer"  
+   messageVersion="Soap11Addressing10/Soap12Addressing10"  
+      writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|maxReadPoolSize|新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を指定する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 64 です。|  
+|maxWritePoolSize|新しいライターを割り当てずに同時に送信可能なメッセージの数を指定する整数です。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は 16 です。|  
+|messageVersion|バインディングを使用して送信されたメッセージの SOAP バージョンを指定します。  有効な値は、次のとおりです。<br /><br /> -   Soap11Addressing10<br />-   Soap12Addressing10<br /><br /> 既定値は Soap12Addressing10 です。  この属性は <xref:System.ServiceModel.Channels.MessageVersion> 型です。|  
+|writeEncoding|バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。  有効な値は、次のとおりです。<br /><br /> -   UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング<br />-   Utf16TextEncoding: Unicode エンコーディング<br />-   Utf8TextEncoding: 8 ビットのエンコーディング<br /><br /> 既定値は Utf8TextEncoding です。  この属性は <xref:System.Text.Encoding> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。  デコードは、その逆のプロセスです。  WCF \(Windows Communication Foundation\) には、SOAP メッセージのエンコードとして、テキスト、バイナリ、および MTOM \(Message Transmission Optimization Mechanism\) の 3 種類があります。  
+  
+ `textMessageEncoding` 要素で表されるテキスト エンコーディングでは相互運用性が最も高くなりますが、XML メッセージのエンコーダーとしての効率は最も低くなります。  テキスト エンコーダーは、ネットワーク上でテキストベースのメッセージを作成します。  このエンコーダーにより生成されるメッセージは、WS\-\* ベースの相互運用に適しています。  Web サービスまたは Web サービス クライアントは、一般に、テキスト形式の XML を認識できます。  しかし、大きいブロックのバイナリ データをテキストとして転送するのは、XML メッセージをエンコードする上では、最も非効率的な方法です。  
+  
+## 使用例  
+  
+```  
+<textMessageEncoding maxReadPoolSize="211"  
+    maxWritePoolSize="2132"  
+    messageVersion="Soap12Addressing10"  
+    textEncoding=”utf-8” />  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TextMessageEncodingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [メッセージ エンコーディング](../../../../../docs/framework/configure-apps/file-schema/wcf/message-encoding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/timeouts.md b/docs/framework/configure-apps/file-schema/wcf/timeouts.md
new file mode 100644
index 00000000000..ed2b0eac88a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/timeouts.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;timeOuts&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7fccd436-b326-48ec-8de1-c16817a09e0d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;timeOuts&gt;
+サービス ホストを開くまたは閉じるまでに待機できる期間を指定する構成要素を表します。  
+  
+## 構文  
+  
+```  
+  
+<timeOuts closeTimeout="TimeSpan"  
+   openTimeout="TimeSpan" >  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|サービス ホストを閉じるまでに待機できる期間を指定する <xref:System.TimeSpan> 値。|  
+|`openTimeout`|サービス ホストを開くまでに待機できる期間を指定する <xref:System.TimeSpan> 値。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<host\>](../../../../../docs/framework/configure-apps/file-schema/wcf/host.md)|サービス ホストの設定を指定する構成要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.HostElement>   
+ <xref:System.ServiceModel.ServiceHost>   
+ <xref:System.ServiceModel.ServiceHost.CloseTimeout%2A>   
+ <xref:System.ServiceModel.ServiceHost.OpenTimeout%2A>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md b/docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md
new file mode 100644
index 00000000000..35a3cd97bb0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md
@@ -0,0 +1,29 @@
+---
+title: "&lt;tokenRequestParameters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1fc2b90c-a61f-4337-ac4c-f341e596a781
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;tokenRequestParameters&gt;
+この構成要素には、トークンの要求時にセキュリティ トークン サービスに送信される追加の XML 要素をメッセージ本文に指定するために使用できる子要素が含まれています。  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.TokenRequestParameters%2A>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.TokenRequestParameters%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/tracking-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/tracking-of-wcf.md
new file mode 100644
index 00000000000..b9002450559
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/tracking-of-wcf.md
@@ -0,0 +1,106 @@
+---
+title: "WCF の &lt;tracking&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70cfaf24-a91c-4e56-ac47-d2ed87a963b3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;tracking&gt;
+ワークフロー サービスの追跡設定を定義する構成セクションを表します。  
+  
+ ワークフロー追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[ワークフローの追跡の構成](../../../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<system.serviceModel>  
+  <tracking>    
+     <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+     </participants>   
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|追跡レコードを定期受信する参加要素を定義する、構成要素のコレクション。  追跡参加要素には、追跡レコードからペイロードを処理するロジックが含まれています \(たとえば、ファイルへの書き込みを選択できるなど\)。|  
+|[\<trackingProfile\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md)|ワークフロー インスタンスで発生した追跡レコードをフィルター処理するための追跡プロファイル。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.ServiceModel|すべてのワークフロー構成要素のルート要素。|  
+  
+## 解説  
+ 追跡には、ワークフローの実行を検証する機能が用意されています。  ワークフロー追跡インフラストラクチャはワークフローをインストルメント化し、実行中の主要イベントを反映してレコードを生成します。  たとえば、ワークフロー インスタンスが開始または完了すると、追跡レコードが生成されます。  また、追跡によって、ワークフロー変数に関連付けられたビジネス関連データを抽出することもできます。  たとえば、ワークフローが注文処理システムを表している場合は、注文 ID と共に追跡レコードを抽出できます。  一般的に、WF 追跡機能を有効にすると、ワークフロー実行の診断またはビジネス分析が容易になります。  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.TrackingSection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.TrackingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/trackingprofile-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/trackingprofile-of-wcf.md
new file mode 100644
index 00000000000..7c081027acc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/trackingprofile-of-wcf.md
@@ -0,0 +1,131 @@
+---
+title: "WCF の &lt;trackingProfile&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09b651c2-c0d2-4850-a101-b0e009a1dc3a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;trackingProfile&gt;
+追跡参加要素内でワークフロー追跡レコードのサブスクリプションを作成するための、構成セクションを表します。  追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  追跡プロファイル セクション内で定義されたクエリでは、サブスクリプションによって返されるイベントの種類が定義されます。  
+  
+ ワークフロー追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|追跡プロファイルの名前を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<tracking\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md)|ワークフロー サービスの追跡設定を定義する構成セクションを表します。|  
+  
+## 解説  
+ 追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  監視の要件に応じて、ワークフローの主な状態変化の少数のセットを定期受信する、大まかなプロファイルを作成できます。  それとは反対に、結果として得られるイベントが、後で詳細な実行フローを十分に再構築できるほど豊富な、詳細なプロファイルを作成することもできます。  
+  
+ 追跡プロファイルは、特定の追跡レコードを対象としてワークフロー ランタイムを照会できる、追跡レコード用の宣言型のサブスクリプションとして構築されます。  クエリには、TrackingRecord オブジェクトのさまざまなクラスを定期受信できる型が複数あります。  クエリの一覧については、「[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+ 次の例は、追跡参加要素が `Started`ワークフロー イベントおよび `Completed`ワークフロー イベントを定期受信できるようにする、構成ファイル内の追跡プロファイルを示します。  
+  
+```  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="Sample Tracking Profile">  
+      <workflow activityDefinitionId="*">  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+            <states>  
+              <state name="Started"/>  
+              <state name="Completed"/>  
+            </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.ProfileElement>   
+ <xref:System.Activities.Tracking.TrackingProfile>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transactedbatching.md b/docs/framework/configure-apps/file-schema/wcf/transactedbatching.md
new file mode 100644
index 00000000000..92887837443
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transactedbatching.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;transactedBatching&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2f790a0d-8f03-4b86-81b5-ce1bc1a6c575
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;transactedBatching&gt;
+受信操作でトランザクション バッチがサポートされるかどうかを指定します。  
+  
+## 構文  
+  
+```  
+  
+<transactedBatching maxBatchSize="Integer" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`maxBatchSize`|1 回のトランザクションでまとめてバッチ処理できる受信操作の最大数を指定する整数。  既定値は 0 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作を指定します。|  
+  
+## 解説  
+ トランザクション バッチで構成されるトランスポートは、複数の受信操作を 1 つのトランザクションにバッチ処理しようとします。  これを実行することにより、受信操作のたびに行うトランザクションの作成とそのコミットの比較的高いコストを回避できます。  
+  
+## 使用例  
+ 構成ファイル内でサービスにトランザクション バッチ動作を追加する方法を次の例に示します。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+      <host>  
+        <baseAddresses>  
+          <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+        </baseAddresses>  
+      </host>  
+  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint address="net.msmq://localhost/private/ServiceModelSamples"  
+                binding="netMsmqBinding"  
+                contract="Microsoft.ServiceModel.Samples.IQueueCalculator" />  
+  
+      <!-- the mex endpoint is explosed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+      <endpoint address="mex"  
+                binding="mexHttpBinding"  
+                contract="IMetadataExchange" />  
+    </service>  
+  </services>  
+  
+  <behaviors>  
+    <endpointBehaviors>  
+      <behavior name="endpointBehavior">  
+        <transactedBatching maxBatchSize="10" />  
+      </behavior>  
+    </endpointBehaviors>  
+    <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior">  
+        <serviceMetadata httpGetEnabled="true" />  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TransactedBatchingElement>   
+ <xref:System.ServiceModel.Description.TransactedBatchingBehavior>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transactionflow.md b/docs/framework/configure-apps/file-schema/wcf/transactionflow.md
new file mode 100644
index 00000000000..262cb8ea987
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transactionflow.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;transactionFlow&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8c7b4c5b-ace3-4fe3-89ff-7b13c9aacd13
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;transactionFlow&gt;
+カスタム バインディングのトランザクション フロー サポートを指定します。  
+  
+## 構文  
+  
+```  
+  
+<transactionFlow transactionProtocol="OleTransactions/WSAtomicTransactionOctober2004"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|transactionProtocol|使用されるトランザクション プロトコルを指定します。  以下の値が有効です。<br /><br /> -   OleTransactions<br />-   WSAtomicTransactionOctober2004<br /><br /> 既定値は OleTransactions です。<br /><br /> この属性は <xref:System.ServiceModel.TransactionProtocol> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ この要素により、受信トランザクションの目的のプロトコル形式を指定できるだけでなく、エンドポイントのバインディング設定で受信トランザクション フローを有効または無効にできます。  この構成要素の使い方の詳細については、「[ServiceModel トランザクションの構成](../../../../../docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md)」および「[トランザクション フローの有効化](../../../../../docs/framework/wcf/feature-details/enabling-transaction-flow.md)」を参照してください。  
+  
+> [!CAUTION]
+>  `OleTransactions` プロトコルを使用してエンドポイント間でトランザクションをフローさせるとき、フロー先のエンドポイントが `OleTransactions` 以外のプロトコルを使用して再びフローを試みると、トランザクション タイムアウトが失われる場合があります。  その結果、OleTransactions ホップより後のすべてのダウンレベル ノードが、予想より遅くタイムアウトする可能性があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TransactionFlowElement>   
+ <xref:System.ServiceModel.Channels.TransactionFlowBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [ServiceModel トランザクションの構成](../../../../../docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md)   
+ [トランザクション フローの有効化](../../../../../docs/framework/wcf/feature-details/enabling-transaction-flow.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md
new file mode 100644
index 00000000000..d5bc045322a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md
@@ -0,0 +1,129 @@
+---
+title: "&lt;basicHttpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c5ba293-3d7e-47a6-b84e-e9022857b7e5
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# &lt;basicHttpBinding&gt; の &lt;transport&gt;
+HTTP トランスポートの認証パラメーターを制御するプロパティを定義します。  
+  
+## 構文  
+  
+```  
+<basicHttpBinding>  
+    <binding>  
+        <security  
+        mode="None|Transport|Message|TransportWithMessageCredential|TransportCredentialOnly">  
+            <transport clientCredentialType="None|Basic|Digest|Ntlm|Windows"  
+             proxyCredentialType="None|Basic|Digest|Ntlm|Windows" realm="string" >  
+                <extendedProtectionPolicy  
+                     policyEnforcement="Never|WhenSupported|Always"  
+                     protectionScenario="TransportSelected|TrustedProxy">  
+                    <customServiceNames></customServiceNames>  
+                        </extendedProtectionPolicy>  
+            </transport>  
+        </security>  
+    </binding>  
+</basicHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|clientCredentialType|-   HTTP 認証を使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  既定値は、`None` です。  この属性は <xref:System.ServiceModel.HttpClientCredentialType> 型です。|  
+|proxyCredentialType|-   HTTP 経由のプロキシを使用してドメイン内からクライアント認証を実行するときに使用される資格情報の種類を指定します。  この属性は、親 `security` 要素の `mode` 属性が `Transport` または `TransportCredentialsOnly` の場合にだけ適用されます。  この属性は <xref:System.ServiceModel.HttpProxyCredentialType> 型です。|  
+|realm|ダイジェストまたは基本認証の HTTP 認証方式によって使用されるレルムを指定する文字列。  既定値は空の文字列です。|  
+|policyEnforcement|この列挙体は、<xref:System.Security.Authentication.ExtendedProtectionPolicy> を適用するタイミングを指定します。<br /><br /> 1.  Never – ポリシーが適用されることはありません \(拡張保護は無効になります\)。<br />2.  WhenSupported – ポリシーが適用されるのは、クライアントが拡張保護をサポートしている場合のみです。<br />3.  Always – ポリシーは常に適用されます。  拡張保護をサポートしていないクライアントは認証に失敗します。|  
+|protectionScenario|この列挙体は、ポリシーによって適用される保護シナリオを指定します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|メッセージは、転送中はセキュリティで保護されません。|  
+|Basic|基本認証を指定します。|  
+|Digest|ダイジェスト認証を指定します。|  
+|Ntlm|Windows 認証に失敗した場合で可能な場合は、NTLM 認証を指定します。|  
+|Windows|Windows 統合認証を指定します。|  
+  
+## proxyCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|-   メッセージは、転送中はセキュリティで保護されません。|  
+|Basic|RFC 2617 『HTTP Authentication: Basic and Digest Authentication』で定義されているとおりに基本認証を指定します。|  
+|Digest|RFC 2617 『HTTP Authentication: Basic and Digest Authentication』で定義されているとおりにダイジェスト認証を指定します。|  
+|Ntlm|Windows 認証に失敗した場合で可能な場合は、NTLM 認証を指定します。|  
+|Windows|Windows 統合認証を指定します。|  
+|証明書|証明書を使用したクライアント認証を実行します。  このオプションは、親要素の `security` の `Mode` 属性が Transport に設定されている場合のみ機能し、TransportCredentialOnly に設定されている場合は機能しません。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|[\<basicHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)のセキュリティ機能を定義します。|  
+  
+## 使用例  
+ 基本的なバインディングを使用した SSL トランスポート セキュリティの使用例を次に示します。  既定で、基本的なバインディングは HTTP 通信をサポートします。  
+  
+```  
+<system.serviceModel>  
+   <services>  
+      <service   
+          type="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+         <endpoint address=""  
+               binding="basicHttpBinding"  
+               bindingConfiguration="Binding1"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+   </services>  
+    <bindings>  
+        <basicHttpBinding>  
+        <!-- Configure basicHttpBinding with Transport security -- >  
+        <!-- mode and clientCredentialType set to None.-->  
+           <binding name="Binding1">  
+               <security mode="Transport">  
+                   <transport clientCredentialType="None"  
+                              proxyCredentialType="None">  
+                       <extendedProtectionPolicy  
+                          policyEnforcement="WhenSupported"  
+                          protectionScenario="TransportSelected">  
+                    <customServiceNames></customServiceNames>  
+                       </extendedProtectionPolicy>  
+               </security>  
+           </binding>  
+        </basicHttpBinding>  
+    </bindings>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.BasicHttpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.HttpTransportSecurityElement>   
+ <xref:System.ServiceModel.HttpTransportSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-msmqintegrationbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-msmqintegrationbinding.md
new file mode 100644
index 00000000000..94c90145049
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-msmqintegrationbinding.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;msmqIntegrationBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 054579e3-7fdd-47df-99ca-952706ba5c8e
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# &lt;msmqIntegrationBinding&gt; の &lt;transport&gt;
+メッセージ キュー統合トランスポートのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<security>  
+    <transport msmqAuthenticationMode="None/WindowsDomain/Certificate"  
+        msmqEncryptionAlgorithm="RC4Stream/AES"  
+        msmqProtectionLevel="None/Sign/EncryptAndSign"  
+        msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+</security>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`msmqAuthenticationMode`|MSMQ トランスポートによるメッセージの認証方法を指定します。  これが `None` に設定されている場合、`msmqProtectionLevel` 属性の値も `None` に設定する必要があります。<br /><br /> 以下の値が有効です。<br /><br /> -   None: 認証は行われません。<br />-   WindowsDomain: 認証機構により Active Directory が使用され、メッセージに関連付けられた SID の X.509 証明書が取得されます。  次に、これを使用してキューの ACL がチェックされ、ユーザーがキューに書き込む権限を持っていることが確認されます。<br />-   Certificate: チャネルは、証明書ストアから証明書を取得します。<br /><br /> 既定値は WindowsDomain です。  この属性は <xref:System.ServiceModel.MsmqAuthenticationMode> 型です。|  
+|`msmqEncryptionAlgorithm`|メッセージ キュー マネージャー間でメッセージを転送するときに、ネットワーク上でメッセージの暗号化に使用されるアルゴリズムを指定します。  以下の値が有効です。<br /><br /> -   RC4Stream<br />-   AES<br /><br /> 既定値は RC4Stream です。  この属性は <xref:System.ServiceModel.MsmqEncryptionAlgorithm> 型です。|  
+|`msmqProtectionLevel`|MSMQ トランスポートのレベルでメッセージをセキュリティで保護する方法を指定します。  暗号化を行うとメッセージの整合性が確保されますが、EncryptAndSign を使用するとメッセージの整合性と否認防止の両方が確保されます。つまり、メッセージは本当にその送信者から送信されていることになり、記載されている送信者が実際の送信者になります。<br /><br /> -   以下の値が有効です。<br />-   None: 保護されません。<br />-   Sign: メッセージは署名されます。<br />-   EncryptAndSign: メッセージは暗号化および署名されます。<br /><br /> 既定値は Sign です。  この属性は、ProtectionLevel 型です。|  
+|`msmqSecureHashAlgorithm`|-   署名の一部としてダイジェストの計算に使用されるアルゴリズムを指定します。  以下の値が有効です。<br />-   MD5<br />-   SHA1<br />-   SHA256<br />-   SHA512<br /><br /> 既定値は SHA1 です。  この属性は <xref:System.ServiceModel.MsmqSecureHashAlgorithm> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)|MSMQ バインディングのセキュリティ設定を定義します。|  
+  
+## 解説  
+ この要素は、メッセージ キュー統合トランスポートのセキュリティ設定をカプセル化します。  設定は、メッセージ キュー統合トランスポートとキューに置かれているトランスポートの両方で同じです。  この設定を使用すると、認証モード、暗号化アルゴリズム、セキュア ハッシュ アルゴリズム、および保護レベルを設定できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement>   
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.MsmqIntegrationSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.MsmqTransportSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-nethttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-nethttpbinding.md
new file mode 100644
index 00000000000..e6121d83137
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-nethttpbinding.md
@@ -0,0 +1,129 @@
+---
+title: "&lt;netHttpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b180006-1661-43bf-a699-96fd3da469af
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;netHttpBinding&gt; の &lt;transport&gt;
+HTTP トランスポートの認証パラメーターを制御するプロパティを定義します。  
+  
+## 構文  
+  
+```  
+<netHttpBinding>  
+    <binding>  
+        <security  
+        mode="None|Transport|Message|TransportWithMessageCredential|TransportCredentialOnly">  
+            <transport clientCredentialType="None|Basic|Digest|Ntlm|Windows"  
+             proxyCredentialType="None|Basic|Digest|Ntlm|Windows" realm="string" >  
+                <extendedProtectionPolicy  
+                     policyEnforcement="Never|WhenSupported|Always"  
+                     protectionScenario="TransportSelected|TrustedProxy">  
+                    <customServiceNames></customServiceNames>  
+                        </extendedProtectionPolicy>  
+            </transport>  
+        </security>  
+    </binding>  
+</basicHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|clientCredentialType|-   HTTP 認証を使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。  既定値は、`None` です。  この属性は <xref:System.ServiceModel.HttpClientCredentialType> 型です。|  
+|proxyCredentialType|-   HTTP 経由のプロキシを使用してドメイン内からクライアント認証を実行するときに使用される資格情報の種類を指定します。  この属性は、親 `security` 要素の `mode` 属性が `Transport` または `TransportCredentialsOnly` の場合にだけ適用されます。  この属性は <xref:System.ServiceModel.HttpProxyCredentialType> 型です。|  
+|realm|ダイジェストまたは基本認証の HTTP 認証方式によって使用されるレルムを指定する文字列。  既定値は空の文字列です。|  
+|policyEnforcement|この列挙体は、<xref:System.Security.Authentication.ExtendedProtectionPolicy> を適用するタイミングを指定します。<br /><br /> 1.  Never – ポリシーが適用されることはありません \(拡張保護は無効になります\)。<br />2.  WhenSupported – ポリシーが適用されるのは、クライアントが拡張保護をサポートしている場合のみです。<br />3.  Always – ポリシーは常に適用されます。  拡張保護をサポートしていないクライアントは認証に失敗します。|  
+|protectionScenario|この列挙体は、ポリシーによって適用される保護シナリオを指定します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|メッセージは、転送中はセキュリティで保護されません。|  
+|Basic|基本認証を指定します。|  
+|Digest|ダイジェスト認証を指定します。|  
+|Ntlm|Windows 認証に失敗した場合で可能な場合は、NTLM 認証を指定します。|  
+|Windows|Windows 統合認証を指定します。|  
+  
+## proxyCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|-   メッセージは、転送中はセキュリティで保護されません。|  
+|Basic|RFC 2617 『HTTP Authentication: Basic and Digest Authentication』で定義されているとおりに基本認証を指定します。|  
+|Digest|RFC 2617 『HTTP Authentication: Basic and Digest Authentication』で定義されているとおりにダイジェスト認証を指定します。|  
+|Ntlm|Windows 認証に失敗した場合で可能な場合は、NTLM 認証を指定します。|  
+|Windows|Windows 統合認証を指定します。|  
+|証明書|証明書を使用したクライアント認証を実行します。  このオプションは、親要素の `security` の `Mode` 属性が Transport に設定されている場合のみ機能し、TransportCredentialOnly に設定されている場合は機能しません。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nethttpbinding.md)|[\<netHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nethttpbinding.md)のセキュリティ機能を定義します。|  
+  
+## 使用例  
+ 基本的なバインディングを使用した SSL トランスポート セキュリティの使用例を次に示します。  既定で、基本的なバインディングは HTTP 通信をサポートします。  
+  
+```  
+<system.serviceModel>  
+   <services>  
+      <service   
+          type="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+         <endpoint address=""  
+               binding="netHttpBinding"  
+               bindingConfiguration="Binding1"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+   </services>  
+    <bindings>  
+        <netHttpBinding>  
+        <!-- Configure basicHttpBinding with Transport security -- >  
+        <!-- mode and clientCredentialType set to None.-->  
+           <binding name="Binding1">  
+               <security mode="Transport">  
+                   <transport clientCredentialType="None"  
+                              proxyCredentialType="None">  
+                       <extendedProtectionPolicy  
+                          policyEnforcement="WhenSupported"  
+                          protectionScenario="TransportSelected">  
+                    <customServiceNames></customServiceNames>  
+                       </extendedProtectionPolicy>  
+               </security>  
+           </binding>  
+        </netHttpBinding>  
+    </bindings>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.NetHttpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.NetHttpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.HttpTransportSecurityElement>   
+ <xref:System.ServiceModel.HttpTransportSecurity>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-netmsmqbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-netmsmqbinding.md
new file mode 100644
index 00000000000..6b19b6fc3ca
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-netmsmqbinding.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;netMsmqBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72e1b338-39f0-4af1-a5d9-7a2fb79f6a0b
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;netMsmqBinding&gt; の &lt;transport&gt;
+トランスポートのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<netMsmqBinding>  
+    <binding>  
+    <security>  
+         <transport msmqAuthenticationMode="None/WindowsDomain/Certificate"  
+            msmqEncryptionAlgorithm="RC4Stream/AES"  
+            msmqProtectionLevel="None/Sign/EncryptAndSign"  
+            msmqSecureHashAlgorithm="MD5/SHA1/SHA256/SHA512" />  
+    </security>  
+   </binding>  
+</netMsmqBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|msmqAuthenticationMode|MSMQ トランスポートによるメッセージの認証方法を指定します。  以下の値が有効です。<br /><br /> -   None: 認証は行われません。<br />-   WindowsDomain: 認証機構により Active Directory が使用され、メッセージに関連付けられたセキュリティ識別子の X.509 証明書が取得されます。  次に、これを使用してキューの ACL がチェックされ、ユーザーがキューへの書き込み権限を持っていることが確認されます。<br />-   Certificate: チャネルは、証明書ストアから証明書を取得します。<br /><br /> 既定値は、`WindowsDomain` です。<br /><br /> この属性が `None` に設定されている場合、`msmqProtectionLevel` 属性も `None` に設定する必要があります。  この属性は <xref:System.ServiceModel.MsmqAuthenticationMode> 型です。|  
+|msmqEncryptionAlgorithm|メッセージ キュー マネージャー間でメッセージを転送するときに、ネットワーク上でメッセージの暗号化に使用されるアルゴリズムを指定します。  以下の値が有効です。<br /><br /> -   RC4Stream<br />-   AES<br />-   既定値は `RC4Stream` です。  この属性は <xref:System.ServiceModel.MsmqEncryptionAlgorithm> 型です。|  
+|msmqProtectionLevel|MSMQ トランスポートのレベルでメッセージをセキュリティで保護する方法を指定します。  暗号化を行うとメッセージの整合性が確保されますが、署名および暗号化を使用するとメッセージの整合性と否認防止の両方が確保されます。  つまり、メッセージは本当にその送信者から送信されていることになり、記載されている送信者が実際の送信者になります。  以下の値が有効です。<br /><br /> -   None: 保護されません。<br />-   Sign: メッセージは署名されます。<br />-   EncryptAndSign: メッセージは暗号化および署名されます。<br />-   既定値は、`Sign` です。|  
+|msmqSecureHashAlgorithm|メッセージ ダイジェストの計算に使用されるハッシュ アルゴリズムを指定します。  以下の値が有効です。<br /><br /> -   MD5<br />-   SHA1<br />-   SHA256<br />-   SHA512<br /><br /> 既定値は、`SHA1` です。  この属性は <xref:System.ServiceModel.MsmqSecureHashAlgorithm> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netmsmqbinding.md)|キューに置かれているトランスポートのセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MsmqTransportSecurityElement>   
+ <xref:System.ServiceModel.Configuration.NetMsmqSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.NetMsmqSecurity.Transport%2A>   
+ <xref:System.ServiceModel.MsmqTransportSecurity>   
+ [WCF のキュー](../../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-netnamedpipebinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-netnamedpipebinding.md
new file mode 100644
index 00000000000..1ab24533b9a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-netnamedpipebinding.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;netNamedPipeBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9eff52d-4bde-4586-b56a-b0ec24611f8d
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;netNamedPipeBinding&gt; の &lt;transport&gt;
+名前付きパイプのトランスポート セキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<netNamedPipeBinding>  
+   <binding>  
+      <security mode="None/Transport">  
+            <transport protectionLevel="None/Sign/EncryptAndSign" />  
+      </security>  
+   </binding>  
+</netNamedPipeBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|protectionLevel|名前付きパイプの保護レベルを定義します。  メッセージに署名すると、転送中のメッセージが第三者によって改ざんされるリスクを軽減します。  暗号化により、転送中にデータレベルのプライバシーが提供されます。  以下の値が有効です。<br /><br /> -   None: 保護されません。<br />-   Sign: メッセージは署名されます。<br />-   EncryptAndSign: メッセージは暗号化および署名されます。<br /><br /> 既定値は EncryptAndSign です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netnamedpipebinding.md)|バインディングのセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.NamedPipeTransportSecurity>   
+ <xref:System.ServiceModel.Configuration.NetNamedPipeSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.NetNamedPipeSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.NamedPipeTransportSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-netpeertcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-netpeertcpbinding.md
new file mode 100644
index 00000000000..648e4f4ef9f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-netpeertcpbinding.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;netPeerTcpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c44d86d2-1160-44d7-9c7a-297b12eccc7f
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# &lt;netPeerTcpBinding&gt; の &lt;transport&gt;
+[\<netPeerTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)の使用時にトランスポート レベルのセキュリティ設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<netPeerTcpBinding>  
+    <binding>  
+        <security>  
+            <transport credentialType="Certificate/Password" />  
+        </security>         
+    </binding>  
+</netPeerTcpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|credentialType|省略可能です。  ピア トランスポートにより送信されるメッセージの検証に使用される資格情報の種類を指定します。  この属性は <xref:System.ServiceModel.PeerTransportCredentialType> 型です。|  
+  
+## credentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|証明書|ピア チャネル トランスポートの認証には X 509 証明書が必要です。|  
+|\[Password\]|ピア チャネル トランスポートの認証には正しいパスワードが必要です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-netpeerbinding.md)|[\<netPeerTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)のセキュリティ設定を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerTransportSecurityElement>   
+ <xref:System.ServiceModel.PeerSecuritySettings.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.PeerSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.PeerTransportSecuritySettings>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-nettcpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-nettcpbinding.md
new file mode 100644
index 00000000000..9c908ba5f29
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-nettcpbinding.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;netTcpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49462e0a-66e1-463f-b3e1-c83a441673c6
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# &lt;netTcpBinding&gt; の &lt;transport&gt;
+[\<netTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md) を使用して構成されたエンドポイントに対する、メッセージ レベルのセキュリティ要件の種類を定義します。  
+  
+## 構文  
+  
+```  
+<netTcpBinding>  
+    <binding>  
+        <security  
+         mode="None|Transport|Message|TransportWithMessageCredential">  
+            <transport clientCredentialType="None|Windows|Certificate"  
+             protectionLevel="None|Sign|EncryptAndSign"  
+             sslProtocols="Ssl3|Tls|Tls11|Tls12">  
+                <extendedProtectionPolicy  
+                     policyEnforcement="Never|WhenSupported|Always"  
+                     protectionScenario="TransportSelected|TrustedProxy">  
+                    <customServiceNames></customServiceNames>  
+                        </extendedProtectionPolicy>  
+            </transport>  
+        </security>  
+    </binding>  
+</netTcpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|clientCredentialType|省略可能です。  トランスポート セキュリティを使用してクライアント認証を実行するときに使用される資格情報の種類を指定します。<br /><br /> -   既定値は `Windows` です。<br />-   この属性は <xref:System.ServiceModel.TcpClientCredentialType> 型です。|  
+|protectionLevel|省略可能です。  TCP トランスポートのレベルでセキュリティを定義します。  メッセージに署名すると、転送中のメッセージが第三者によって改ざんされるリスクを軽減します。  暗号化により、転送中にデータレベルのプライバシーが提供されます。<br /><br /> 既定値は `EncryptAndSign` です。|  
+|sslProtocols|どの SslProtocols がサポートされているのかを指定する SslProtocols 列挙型フラグの値。  既定値は Ssl3&#124;Tls&#124;Tls11&#124;Tls12 です。|  
+|policyEnforcement|この列挙体は、<xref:System.Security.Authentication.ExtendedProtectionPolicy> を適用するタイミングを指定します。<br /><br /> 1.  Never – ポリシーが適用されることはありません \(拡張保護は無効になります\)。<br />2.  WhenSupported – ポリシーが適用されるのは、クライアントが拡張保護をサポートしている場合のみです。<br />3.  Always – ポリシーは常に適用されます。  拡張保護をサポートしていないクライアントは認証に失敗します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|クライアントは匿名です。  これには、サービスの証明書が必要です。|  
+|Windows|SP ネゴシエーション \(Kerberos ネゴシエーション\) を使用して、クライアントの Windows 認証を指定します。|  
+|証明書|クライアントは、証明書を使用して認証されます。  これは SSL ネゴシエーションを使用し、サービスの証明書が必要です。|  
+  
+## protectionLevel 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|保護されません。|  
+|Sign|メッセージは署名されます。|  
+|EncryptAndSign|-   メッセージは暗号化および署名されます。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)|[\<netTcpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md) のセキュリティ機能を指定します。|  
+  
+## 解説  
+ トランスポート セキュリティは、SOAP メッセージの整合性と機密性の保護、および相互認証に使用します。  このセキュリティ モードがバインディング上で選択された場合、チャネル スタックはセキュリティ トランスポートを使用して構成され、SOAP メッセージは Windows \(ネゴシエート\) や TCP 上の SSL などのトランスポート セキュリティを使用して保護されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.TcpTransportSecurity>   
+ <xref:System.ServiceModel.Configuration.NetTcpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.NetTcpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.NetTcpTransportSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-peertransport.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-peertransport.md
new file mode 100644
index 00000000000..8f54e9d8900
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-peertransport.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;peerTransport&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d7116240-845c-4b6f-b203-262de6b597ef
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;peerTransport&gt; の &lt;transport&gt;
+このバインドで構成されたピアが送信する、セキュリティで保護されたメッセージのトランスポートの型を指定します。  
+  
+## 構文  
+  
+```  
+  
+<security>  
+   <transport credentialType="Certificate/Password" />  
+</security>         
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|credentialType|省略可能です。  ピア トランスポートにより送信されるメッセージの検証に使用される資格情報の種類を指定します。  この属性は <xref:System.ServiceModel.PeerTransportCredentialType> 型です。|  
+  
+## credentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|証明書|ピア チャネル トランスポートの認証には X 509 証明書が必要です。|  
+|\[Password\]|ピア チャネル トランスポートの認証には正しいパスワードが必要です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md)|ピア トランスポートのセキュリティ設定を定義します。|  
+  
+## 解説  
+ この要素は、[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-peertransport.md) の mode 属性が `Transport` または `TransportWithMessageCredential` に設定されている場合にのみ設定されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.PeerTransportSecurityElement>   
+ <xref:System.ServiceModel.PeerSecuritySettings.Transport%2A>   
+ <xref:System.ServiceModel.PeerTransportSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート セキュリティ](../../../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-webhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-webhttpbinding.md
new file mode 100644
index 00000000000..ba2e028a79d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-webhttpbinding.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;webHttpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f150fb19-7de1-44af-81f4-86cad881cd05
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;webHttpBinding&gt; の &lt;transport&gt;
+HTTP 要求を受信するように構成されたサービス エンドポイントのトランスポート レベルのセキュリティ設定を定義します。  
+  
+## 構文  
+  
+```  
+<webHttpBinding>  
+    <binding>  
+        <security  
+        mode="None|Transport|Message|TransportWithMessageCredential|TransportCredentialOnly">  
+            <transport clientCredentialType="None|Basic|Digest|Ntlm|Windows"  
+             proxyCredentialType="None|Basic|Digest|Ntlm|Windows" realm="string" >  
+                <extendedProtectionPolicy  
+                     policyEnforcement="Never|WhenSupported|Always"  
+                     protectionScenario="TransportSelected|TrustedProxy">  
+                    <customServiceNames></customServiceNames>  
+                        </extendedProtectionPolicy>  
+            </transport>  
+        </security>  
+    </binding>  
+</WebHttpBinding>  
+```  
+  
+## 型  
+ <xref:System.ServiceModel.HttpTransportSecurity>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`clientCredentialType`|サービスに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpClientCredentialType> 型です。|  
+|`proxyCredentialType`|ドメイン プロキシに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpProxyCredentialType> 型です。|  
+|`realm`|ダイジェストまたは基本認証の認証レルムを指定する文字列。  既定値は空の文字列です。<br /><br /> 認証レルムでは、少なくとも、認証を実行するホストの名前を指定します。  アクセス権のあるユーザーのコレクションも指定できます。  ユーザーは、認証レルムを照会して、複数のユーザー名およびパスワードの候補のうち、どれを使用できるかを確認することができます。|  
+|`policyEnforcement`|この列挙体は、<xref:System.Security.Authentication.ExtendedProtectionPolicy> を適用するタイミングを指定します。<br /><br /> 1.  Never – ポリシーが適用されることはありません \(拡張保護は無効になります\)。<br />2.  WhenSupported – ポリシーが適用されるのは、クライアントが拡張保護をサポートしている場合のみです。<br />3.  Always – ポリシーは常に適用されます。  拡張保護をサポートしていないクライアントは認証に失敗します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Basic`|基本認証を使用します。|  
+|`Certificate`|X.509 証明書を使用して、クライアントを認証します。|  
+|`Digest`|ダイジェスト認証を使用します。|  
+|`Ntlm`|Windows ドメインのフォールバックとして NTLM 認証を使用します。|  
+|`Windows`|統合 Windows 認証を使用します。|  
+  
+## proxyCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Basic`|基本認証を使用します。|  
+|`Digest`|ダイジェスト認証を使用します。|  
+|`Ntlm`|Windows ドメインのフォールバックとして NTLM を使用します。|  
+|`Windows`|統合 Windows 認証を使用します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-webhttpbinding.md)|[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素のセキュリティ機能を表します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.HttpTransportSecurity>   
+ <xref:System.ServiceModel.Configuration.WebHttpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.WebHttpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.HttpTransportSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [WCF Web HTTP プログラミング モデル](../../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-ws2007httpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-ws2007httpbinding.md
new file mode 100644
index 00000000000..955826fe7f5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-ws2007httpbinding.md
@@ -0,0 +1,86 @@
+---
+title: "&lt;ws2007HttpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 692befa3-8b0b-4ec5-b601-755874e98eb0
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;ws2007HttpBinding&gt; の &lt;transport&gt;
+HTTP トランスポートの認証設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+transport clientCredentialType =   
+       "Basic/Certificate/Digest/None/Ntlm/Windows"  
+       proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+       realm="string"   
+```  
+  
+## 型  
+ <xref:System.ServiceModel.HttpTransportSecurity>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`clientCredentialType`|サービスに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpClientCredentialType> 型です。|  
+|`proxyCredentialType`|ドメイン プロキシに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpProxyCredentialType> 型です。|  
+|`realm`|ダイジェスト認証または基本認証の認証レルム。  既定値は空の文字列です。<br /><br /> 認証レルムでは、少なくとも、認証を実行するホストの名前を指定します。  アクセス権のあるユーザーのコレクションも指定できます。  ユーザーは、認証レルムを照会して、複数のユーザー名とパスワードの候補のうち、どれを使用できるかを確認できます。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|Basic|基本認証を使用します。|  
+|Digest|ダイジェスト認証を使用します。|  
+|Ntlm|Windows ドメインのフォールバックとして NTLM 認証を使用します。|  
+|Windows|統合 Windows 認証を使用します。|  
+|証明書|X.509 証明書を使用して、クライアントを認証します。|  
+  
+## proxyCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|なし|セキュリティを無効にします。|  
+|Basic|基本認証を使用します。|  
+|Digest|ダイジェスト認証を使用します。|  
+|Ntlm|Windows ドメインのフォールバックとして NTLM を使用します。|  
+|Windows|統合 Windows 認証を使用します。|  
+|証明書|X.509 証明書を使用して、クライアントを認証します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-ws2007httpbinding.md)|[\<ws2007HttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md) 要素のセキュリティ機能を表します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.HttpTransportSecurity>   
+ <xref:System.ServiceModel.Configuration.BasicHttpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.WSHttpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpTransportSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md
new file mode 100644
index 00000000000..0881d25eaf3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;wsHttpBinding&gt; の &lt;transport&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21e38acf-450a-4bda-82b6-de305e1f7cd8
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# &lt;wsHttpBinding&gt; の &lt;transport&gt;
+HTTP トランスポートの認証設定を定義します。  
+  
+## 構文  
+  
+```  
+  
+<wsHttpBinding>  
+    <binding>  
+        <security mode=”None|Transport|TransportWithMessageCredential|TransportCredentialOnly”>  
+            <transport  
+            clientCredentialType="Basic|Certificate|Digest|None|Ntlm|Windows"  
+            proxyCredentialType="Basic|Digest|None|Ntlm|Windows"  
+            realm="string" />  
+                <extendedProtectionPolicy policyEnforcement=”Never|WhenSupported|Always” protectionScenario=”TransportSelected|TrustedProxy”>  
+                    <customServiceNames></customServiceNames>  
+                </extendedProtecutionPolicy>  
+            </transport>  
+        </security>  
+    </binding>  
+</wsHttpBinding>  
+```  
+  
+## 型  
+ <xref:System.ServiceModel.HttpTransportSecurity>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`clientCredentialType`|サービスに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpClientCredentialType> 型です。|  
+|`proxyCredentialType`|ドメイン プロキシに対するクライアントの認証に使用される資格情報を指定します。  この属性は <xref:System.ServiceModel.HttpProxyCredentialType> 型です。|  
+|`realm`|ダイジェストまたは基本認証の認証レルムを指定する文字列。  既定値は空の文字列です。<br /><br /> 認証レルムでは、少なくとも、認証を実行するホストの名前を指定します。  アクセス権のあるユーザーのコレクションも指定できます。  ユーザーは、認証レルムを照会して、複数のユーザー名およびパスワードの候補のうち、どれを使用できるかを確認することができます。|  
+|`policyEnforcement`|この列挙体は、<xref:System.Security.Authentication.ExtendedProtectionPolicy> を適用するタイミングを指定します。<br /><br /> 1.  Never – ポリシーが適用されることはありません \(拡張保護は無効になります\)。<br />2.  WhenSupported – ポリシーが適用されるのは、クライアントが拡張保護をサポートしている場合のみです。<br />3.  Always – ポリシーは常に適用されます。  拡張保護をサポートしていないクライアントは認証に失敗します。|  
+  
+## clientCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Basic`|基本認証を使用します。|  
+|`Digest`|ダイジェスト認証を使用します。|  
+|`Ntlm`|Windows ドメインのフォールバックとして NTLM 認証を使用します。|  
+|`Windows`|統合 Windows 認証を使用します。|  
+|`Certificate`|X.509 証明書を使用して、クライアントを認証します。|  
+  
+## proxyCredentialType 属性  
+  
+|値|説明|  
+|-------|--------|  
+|`None`|セキュリティを無効にします。|  
+|`Basic`|基本認証を使用します。|  
+|`Digest`|ダイジェスト認証を使用します。|  
+|`Ntlm`|Windows ドメインのフォールバックとして NTLM を使用します。|  
+|`Windows`|統合 Windows 認証を使用します。|  
+|`Certificate`|X.509 証明書を使用して、クライアントを認証します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)|[\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)のセキュリティ機能を表します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.HttpTransportSecurity>   
+ <xref:System.ServiceModel.WSHttpSecurity.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.WSHttpSecurityElement.Transport%2A>   
+ <xref:System.ServiceModel.Configuration.HttpTransportSecurityElement>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transportconfigurationtypes.md b/docs/framework/configure-apps/file-schema/wcf/transportconfigurationtypes.md
new file mode 100644
index 00000000000..84f76d78ccb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transportconfigurationtypes.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;transportConfigurationTypes&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 929c8b0a-5460-4f66-a098-2cb8d4e10b69
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;transportConfigurationTypes&gt;
+特定のトランスポートの型を識別する構成要素のコレクションを表します。  これはカスタム WAS プロトコルの追加に使用できます。  
+  
+## 構文  
+  
+```  
+  
+<serviceHostingEnvironment>   
+   <transportConfigurationTypes>  
+      <add name="String"  
+               transportConfigurationType="String"/>   
+   </transportConfigurationTypes>  
+</serviceHostingEnvironment>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|トランスポートの名前|  
+|transportConfigurationType|トランスポートを実装する型|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/wcf/add-of-transportconfigurationtype.md)|特定のトランスポートの型を識別する構成要素を追加します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceHostingEnvironment\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)|環境をホストするサービスがインスタンス化する特定のトランスポートの型を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection>   
+ <xref:System.ServiceModel.ServiceHostingEnvironment>   
+ <xref:System.ServiceModel.Configuration.TransportConfigurationTypeElementCollection>   
+ [ホスト](../../../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/transports.md b/docs/framework/configure-apps/file-schema/wcf/transports.md
new file mode 100644
index 00000000000..4d3db43959d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/transports.md
@@ -0,0 +1,34 @@
+---
+title: "トランスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 5c064c51-5863-4fe7-a772-e298841b62ff
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# トランスポート
+トランスポート層は、チャネル スタックの最も低いレベルにあります。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] で使用される主なトランスポートは、HTTP、HTTPS、TCP、および名前付きパイプです。  このセクションでは、さまざまな種類のトランスポートを構成できるすべての構成要素を示します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.TransportElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [トランスポート](../../../../../docs/framework/wcf/feature-details/transports.md)   
+ [トランスポートの選択](../../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md b/docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md
new file mode 100644
index 00000000000..e2b107a1ed0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md
@@ -0,0 +1,91 @@
+---
+title: "&lt;udpAnnoucementEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b3fa9c5-f372-4df9-a9d6-1e426063b721
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;udpAnnoucementEndpoint&gt;
+この構成要素は、UDP バインディングを使用してアナウンス メッセージを送信するためにサービスが使用する標準エンドポイントを定義します。  これには固定コントラクトがあり、2 つの探索のバージョンをサポートします。  また、WS\-Discovery の仕様 \(WS\-Discovery April 2005 または WS\-Discovery V1.1\) に規定された固定 UDP バインディングと既定のアドレスも備えています。  アナウンス メッセージの送受信に使用するマルチキャスト アドレスを指定できます。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <announcementEndpoint>   
+          <standardEndpoint  
+                  discoveryVersion=”WSDiscovery11/WSDiscoveryApril2005”  
+                  maxAnnouncementDelay=”Timespan”   
+                  multicastAddress=”Uri”  
+                  name="String" />   
+       </announcementEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryVersion|WS\-Discovery プロトコルの 2 つのバージョンのうち、1 つを指定する文字列。  有効値は WSDiscovery11 と WSDiscoveryApril2005 です。  この値は、<xref:System.ServiceModel.Discovery.Configuration.DiscoveryVersion> 型です。|  
+|maxAnnouncementDelay|Discovery プロトコルが Hello メッセージを送信するまでの待機時間の最大値を指定する Timespan 値。  メッセージは送信前に 0 からこの属性値の間のランダムな時間だけ待機します。  この属性はランダムな短い待機時間を設定するために使用されるもので、ネットワークが機能しなくなり、すべてのサービスが同時にオンラインに戻ったときにネットワーク ストームが発生することを防ぎます。|  
+|multicastAddress|探索メッセージの送受信に使用するマルチキャスト アドレスを指定する URI。  既定値は、プロトコル仕様に準じたマルチキャスト アドレスです。|  
+|name|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<udpTransportSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udptransportsettings.md)|UDP エンドポイントの UDP トランスポートを構成できる設定のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 使用例  
+ 既定のマルチキャスト アドレスを使用した UDP マルチキャスト トランスポート経由、および指定されたマルチキャスト アドレスを使用した UDP マルチキャスト トランスポート経由でアナウンスをリッスンするクライアントの例を次に示します。  
+  
+```  
+  
+<services>  
+  <service name="ServiceAnnouncementListener">  
+      <endpoint name="udpAnnouncementEndpointStandard"  
+                kind="udpAnnouncementEndpoint"  
+                bindingConfiguration="..." />  
+      <endpoint name="udpAnnouncementEndpoint2"  
+                kind="udpAnnouncementEndpoint"  
+                endpointConfiguration="AnnouncementConfiguration3702"  
+                bindingConfiguration="..." />  
+...  
+  </service>  
+</services>  
+<standardEndpoints>  
+  <udpAnnouncementEndpoint>  
+     <standardEndpoint name="AnnouncementConfiguration2"   
+          version="WSDiscoveryApril2005"   
+          multicastAddress="soap.udp://239.255.255.250:3703"/>          
+  </udpAnnouncementEndpoint>  
+</standardEndpoints>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/udpbinding.md b/docs/framework/configure-apps/file-schema/wcf/udpbinding.md
new file mode 100644
index 00000000000..b3b913c4720
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/udpbinding.md
@@ -0,0 +1,120 @@
+---
+title: "&lt;udpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa291901-8340-45c6-9c44-5d9281c70bc3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;udpBinding&gt;
+<xref:System.ServiceModel.UdpBinding> バインディングの構成に使用する構成要素です。  
+  
+## 構文  
+  
+```  
+  
+<udpBinding>  
+   <binding   
+       closeTimeout="TimeSpan"   
+       duplicateMessageHistoryLength=”Integer"  
+       maxBufferPoolSize="Integer"  
+       maxBufferSize="Integer"  
+       maxPendingMessagesTotalSize=”Integer”  
+       maxReceivedMessageSize="Integer"  
+       maxRetransmitCount=”Integer”  
+       multicastInterfaceId="Integer"  
+              name="string"   
+       openTimeout="TimeSpan"   
+       receiveTimeout="TimeSpan"  
+       sendTimeout="TimeSpan"  
+       textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+       timeToLive="TimeSpan">  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"      
+            maxStringContentLength="Integer" />  
+   </binding>  
+</basicHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`duplicateMessageHistoryLength`|重複するメッセージの履歴の長さを指定する整数値。|  
+|`maxBufferPoolSize`|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる、最大メモリ量を指定する整数値。  既定値は 524288 \(0x80000\) バイトです。|  
+|`maxBufferSize`|このバインディングで構成されるエンドポイントのメッセージが処理されるときのメッセージを格納するバッファーの最大サイズを指定する整数値 \(バイト単位\)。  既定値は 65,536 バイトです。|  
+|`maxPendingMessagesTotalSize`|受信して、各チャネル インスタンスの入力キューからまだ削除していないメッセージの最大数を指定する整数値。|  
+|`maxReceivedMessageSize`|このバインディングで構成されるチャネルが受信可能なメッセージの最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で定義する正の整数。  受信側のメッセージが大きすぎると、送信側は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65,536 バイトです。|  
+|`maxRetransmitCount`|再送信メッセージの最大数を指定する整数値。|  
+|`multicastInterfaceId`|マルチキャストのインターフェイス ID を指定する整数値。|  
+|`name`|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  各バインドには、サービスのメタデータでこれをまとめて一意に識別する `name` および `namespace` 属性が含まれています。  また、この名前は、同じ種類のバインディング間で一意です。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`timeToLive`|バインディングに対する有効期間を指定する期間値。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ UdpBinding により、WCF サービスが UDP トランスポートを介して通信することができます。  ここでは、クライアントがサービスにメッセージを送信し、応答は返されない "ファイア アンド フォーゲット \(撃ち放し\)" メッセージ交換を使用します。  
+  
+## 使用例  
+ \<`udpBinding`\> 要素を使用して <xref:System.ServiceModel.UdpBinding> を構成する方法を次の例に示します。  
+  
+```xml  
+<udpBinding>  
+        <binding  closeTimeout="00:10:00"  
+                   duplicateMessageHistoryLength="100"  
+                   maxBufferPoolSize="100"  
+                   maxPendingMessagesTotalSize="100000"  
+                   maxReceivedMessageSize="65536"  
+                    maxRetransmitCount="10"  
+                   multicastInterfaceId="00000"  
+                   name="myUdpBinding"  
+                   openTimeout="00:10:00"  
+                   receiveTimeout="00:10:00"  
+                   sendTimeout="00:10:00"  
+                   textEncoding="utf-8"  
+                   timeToLive="00:10:00"  
+          <readerQuotas/>   
+        </binding>  
+      </udpBinding>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md b/docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md
new file mode 100644
index 00000000000..97997d1d28c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;udpDiscoveryEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f485329-2771-43bc-88de-df8f2faa3bb7
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;udpDiscoveryEndpoint&gt;
+この構成要素は、UDP マルチキャスト バインディングを使用した探索操作用に事前に構成される標準エンドポイントを定義します。  このエンドポイントには固定コントラクトがあり、WS\-Discovery プロトコルの 2 つのバージョンをサポートします。  また、WS\-Discovery の仕様 \(WS\-Discovery April 2005 または WS\-Discovery V1.1\) に規定された固定 UDP バインディングと既定のアドレスも備えています。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <discoveryEndpoint>   
+          <standardEndpoint  
+                  discoveryMode=”Adhoc/Managed”  
+                  discoveryVersion=”WSDiscovery11/WSDiscoveryApril2005”  
+                  maxResponseDelay=”Timespan”  
+                  multicastAddress=”Uri”   
+                  name="String" />  
+       </discoveryEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|discoveryMode|探索プロトコルのモードを示す文字列。  有効値は "Adhoc" と "Managed" です。  マネージ モードでは、プロトコルは Discoverable サービスのリポジトリとして機能する Discovery Proxy に依存します。  アドホック モードでは、プロトコルは UDP マルチキャスト メカニズムを使用して利用可能なサービスを探索する必要があります。  この値は、<xref:System.Servicemodel.Discovery.DiscoveryMode> 型です。|  
+|discoveryVersion|WS\-Discovery プロトコルの 2 つのバージョンのうち、1 つを指定する文字列。  有効値は WSDiscovery11 と WSDiscoveryApril2005 です。  この値は、<xref:System.Servicemodel.Discovery.DiscoveryVersion> 型です。|  
+|maxResponseDelay|Discovery プロトコルが Probe Match や Resolve Match などのメッセージを送信するまでの待機時間の最大値を指定する Timespan 値。<br /><br /> すべての ProbeMatch が同時に送信されると、ネットワーク ストームが発生することがあります。  これを防ぐために、各 ProbeMatch はランダムな時間だけ待機して送信されます。  ランダムな待機時間は、0 からこの属性に設定された値の範囲内で設定されます。  この属性を 0 に設定すると、ProbeMatch メッセージは待機せずに短いループで送信されます。  それ以外の場合は、ProbeMatch メッセージはランダムな時間だけ待機して送信されます。すべての ProbeMatch メッセージの送信にかかる合計時間が maxResponseDelay を超えることはありません。  この値はサービスのみに関連するもので、クライアントが使用するものではありません。|  
+|multicastAddress|探索メッセージの送受信に使用するマルチキャスト アドレスを指定する URI。  既定値は、プロトコル仕様に準じたマルチキャスト アドレスです。|  
+|`name`|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<udpTransportSettings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udptransportsettings.md)|UDP エンドポイントの UDP トランスポートを構成できる設定のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 使用例  
+ UDP マルチキャスト トランスポート経由で探索メッセージをリッスンするサービスの例を次に示します。  
+  
+```  
+  
+<services>  
+    <service name="CalculatorService"  
+         behaviorConfiguration="CalculatorServiceBehavior">  
+         <endpoint binding="basicHttpBinding"   
+           address="calculator" contract="ICalculatorService" />  
+         <endpoint name="DiscoveryEndpoint"  
+                kind="udpDiscoveryEndpoint" />  
+</service>  
+<standardEndpoints>  
+  <udpDiscoveryEndpoint>  
+     <standardEndpoint name="DiscoveryEndpoint"                         
+                       version="WSDiscoveryApril2005" />  
+   </udpDiscoveryEndpoint>  
+</standardEndpoints>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.DiscoveryEndpoint>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/udptransportsettings-of-udpannouncementendpoint.md b/docs/framework/configure-apps/file-schema/wcf/udptransportsettings-of-udpannouncementendpoint.md
new file mode 100644
index 00000000000..ae6a1d892ea
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/udptransportsettings-of-udpannouncementendpoint.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;udpAnnouncementEndpoint&gt; の &lt;udpTransportSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7ddff1a-5eed-4bbc-8580-b95ef8890e1f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;udpAnnouncementEndpoint&gt; の &lt;udpTransportSettings&gt;
+この構成要素は、[\<udpAnnoucementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md) の UDP トランスポート設定を公開します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <udpAnnouncementEndpoint>   
+          <standardEndpoint>  
+               <updTransportSettings>  
+                  duplicateMessageHistoryLength=”Integer”  
+                  maxBufferPoolSize=”Integer”   
+                  maxMulticastRetransmitCount=”Integer”  
+                  maxPendingMessageCount=”Integer”  
+                  maxReceivedMessageSize=”Integer”  
+                  maxUnicastRetransmitCount=”Integer”  
+                  multicastInterfaceId=”String”  
+                  socketReceiveBufferSize=”Integer”  
+                  timeToLive=”Integer” />   
+          </standardEndpoint>  
+       </udpAnnouncementEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|duplicateMessageHistoryLength|重複するメッセージを特定するためにトランスポートによって使用されるメッセージ ハッシュの最大数を指定する整数。  重複の検出は、TransportManager レベルで実行されます。  このプロパティを 0 に設定すると、重複の検出は無効になります。<br /><br /> この属性を使用して、システムの管理者や開発者は重複するメッセージの検出アルゴリズムをオフにできます。  これは、独自の重複検出アルゴリズムを実行する場合に望ましいことがあります。<br /><br /> 既定値は 4112 です。|  
+|maxBufferPoolSize|トランスポートによって使用されるバッファー プールの最大サイズを指定する整数。|  
+|maxMulticastRetransmitCount|メッセージを \(最初に送信した後に\) 再送信する最大回数を指定する整数。<br /><br /> 既定値は 2 です。|  
+|maxPendingMessageCount|受信して、各チャネル インスタンスの InputQueue からまだ削除していないメッセージの最大数を指定する整数。  InputQueue が保留メッセージ数の上限に達すると、メッセージは削除されます。<br /><br /> 既定値は 32 です。|  
+|maxReceivedMessageSize|バインディングで処理できるメッセージの最大サイズを指定する整数。<br /><br /> 既定値は 65507 です。|  
+|maxUnicastRetransmitCount|メッセージを \(最初に送信した後に\) 再送信する最大回数を指定する整数。  メッセージをユニキャスト アドレスに送信し、対応する RelatesTo ヘッダーの付いた応答メッセージを受信すると、再送信は早期に \(再送信の回数が構成された回数に到達する前に\) 終了することがあります。<br /><br /> 既定値は 1 です。|  
+|multicastInterfaceId|マルチホーム コンピューター上でマルチキャスト トラフィックを送受信するときに使用するネットワーク アダプターを一意に識別する文字列。  実行時には、トランスポートは、この属性値を使用してインターフェイスのインデックスを参照します。このインデックスは、その後、`IP_MULTICAST_IF` および `IPV6_MULTICAST_IF` のソケット オプションの設定に使用されます。  マルチキャスト グループに参加するときには、同じインターフェイス インデックスが使用されます \(該当する場合\)。<br /><br /> 既定値は `null` です。|  
+|socketReceiveBufferSize|基になる WinSock ソケットの受信バッファー サイズを指定する整数。<br /><br /> 受信チャネルのユーザーは、バインディング上のこの属性を使用して、データ受信時のシステム動作を制御できます。  たとえば、受信 WCF メッセージを最大しきい値で利用するアプリケーションがある場合、この属性値よりも大きい値を使用すると、アプリケーションが処理できるようになるまで待機している間、メッセージを WinSock バッファーにスタックできます。  同じ状況で属性値よりも小さい値を使用すると、メッセージは削除されることになります。この属性は、基になる WinSock `SO_RCVBUF` ソケット オプションを公開します。この属性値には、`maxReceivedMessageSize` のサイズ以上の値を指定する必要があります。  この値を `maxReceivedMessageSize` よりも小さい値に設定すると、ランタイム例外が発生する原因になります。<br /><br /> 既定値は 65536 です。|  
+|timeToLive|マルチキャスト パケットが走査できるネットワーク セグメント ホップの数を指定する整数。  この属性は、`IP_MULTICAST_TTL` および `IP_TTL` ソケット オプションに関連付けられている機能を公開します。<br /><br /> 既定値は 1 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<udpAnnoucementEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpannoucementendpoint.md)|固定アナウンス コントラクトと UDP トランスポート バインディングを持つ標準エンドポイント。|  
+  
+## 参照  
+ <xref:System.Servicemodel.Discovery.UdpTransportSettings>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/udptransportsettings.md b/docs/framework/configure-apps/file-schema/wcf/udptransportsettings.md
new file mode 100644
index 00000000000..c7bcba12652
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/udptransportsettings.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;udpTransportSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 842d92e9-6199-4ec5-b2d1-58533054e1f0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;udpTransportSettings&gt;
+この構成要素は、[\<udpDiscoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md) の UDP トランスポート設定を公開します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <udpDiscoveryEndpoint>   
+          <standardEndpoint>  
+               <updTransportSettings>  
+                  duplicateMessageHistoryLength=”Integer”  
+                  maxBufferPoolSize=”Integer”   
+                  maxMulticastRetransmitCount=”Integer”  
+                  maxPendingMessageCount=”Integer”  
+                  maxReceivedMessageSize=”Integer”  
+                  maxUnicastRetransmitCount=”Integer”  
+                  multicastInterfaceId=”String”  
+                  socketReceiveBufferSize=”Integer”  
+                  timeToLive=”Integer” />   
+          </standardEndpoint>  
+       </udpDiscoveryEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|duplicateMessageHistoryLength|重複するメッセージを特定するためにトランスポートによって使用されるメッセージ ハッシュの最大数を指定する整数。  重複の検出は、TransportManager レベルで実行されます。  このプロパティを 0 に設定すると、重複の検出は無効になります。<br /><br /> この属性を使用して、システムの管理者や開発者は重複するメッセージの検出アルゴリズムをオフにできます。  これは、独自の重複検出アルゴリズムを実行する場合に望ましいことがあります。<br /><br /> 既定値は 4112 です。|  
+|maxBufferPoolSize|トランスポートによって使用されるバッファー プールの最大サイズを指定する整数。|  
+|maxMulticastRetransmitCount|メッセージを \(最初に送信した後に\) 再送信する最大回数を指定する整数。<br /><br /> 既定値は 2 です。|  
+|maxPendingMessageCount|受信して、各チャネル インスタンスの InputQueue からまだ削除していないメッセージの最大数を指定する整数。  InputQueue が保留メッセージ数の上限に達すると、メッセージは削除されます。<br /><br /> 既定値は 32 です。|  
+|maxReceivedMessageSize|バインディングで処理できるメッセージの最大サイズを指定する整数。<br /><br /> 既定値は 65507 です。|  
+|maxUnicastRetransmitCount|メッセージを \(最初に送信した後に\) 再送信する最大回数を指定する整数。  メッセージをユニキャスト アドレスに送信し、対応する RelatesTo ヘッダーの付いた応答メッセージを受信すると、再送信は早期に \(再送信の回数が構成された回数に到達する前に\) 終了することがあります。<br /><br /> 既定値は 1 です。|  
+|multicastInterfaceId|マルチホーム コンピューター上でマルチキャスト トラフィックを送受信するときに使用するネットワーク アダプターを一意に識別する文字列。  実行時には、トランスポートは、この属性値を使用してインターフェイスのインデックスを参照します。このインデックスは、その後、`IP_MULTICAST_IF` および `IPV6_MULTICAST_IF` のソケット オプションの設定に使用されます。  マルチキャスト グループに参加するときには、同じインターフェイス インデックスが使用されます \(該当する場合\)。<br /><br /> 既定値は `null` です。|  
+|socketReceiveBufferSize|基になる WinSock ソケットの受信バッファー サイズを指定する整数。<br /><br /> 受信チャネルのユーザーは、バインディング上のこの属性を使用して、データ受信時のシステム動作を制御できます。  たとえば、受信 WCF メッセージを最大しきい値で利用するアプリケーションがある場合、この属性値よりも大きい値を使用すると、アプリケーションが処理できるようになるまで待機している間、メッセージを WinSock バッファーにスタックできます。  同じ状況で属性値よりも小さい値を使用すると、メッセージは削除されることになります。この属性は、基になる WinSock `SO_RCVBUF` ソケット オプションを公開します。この属性値には、`maxReceivedMessageSize` のサイズ以上の値を指定する必要があります。  この値を `maxReceivedMessageSize` よりも小さい値に設定すると、ランタイム例外が発生する原因になります。<br /><br /> 既定値は 65536 です。|  
+|timeToLive|マルチキャスト パケットが走査できるネットワーク セグメント ホップの数を指定する整数。  この属性は、`IP_MULTICAST_TTL` および `IP_TTL` ソケット オプションに関連付けられている機能を公開します。<br /><br /> 既定値は 1 です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<udpDiscoveryEndpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/udpdiscoveryendpoint.md)|固定探索コントラクトと UDP トランスポート バインディングを持つ標準エンドポイント。|  
+  
+## 参照  
+ <xref:System.Servicemodel.Discovery.UdpTransportSettings>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/unrecognizedpolicyassertion.md b/docs/framework/configure-apps/file-schema/wcf/unrecognizedpolicyassertion.md
new file mode 100644
index 00000000000..f550c69f4dd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/unrecognizedpolicyassertion.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;unrecognizedPolicyAssertion&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 043c3c8f-f263-4ac7-a1af-945d03413f0b
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;unrecognizedPolicyAssertion&gt;
+ポリシー アサーションを指定するバインディング要素を表します。  この要素には属性がなく、空のスイッチとして表されます。  
+  
+## 構文  
+  
+```  
+  
+<unrecognizedPolicyAssertion/>  
+```  
+  
+## 型  
+ `Type`  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/usemanagedpresentation.md b/docs/framework/configure-apps/file-schema/wcf/usemanagedpresentation.md
new file mode 100644
index 00000000000..7825d8595e0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/usemanagedpresentation.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;useManagedPresentation&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 17a0dd77-af54-41db-a9d0-4b17ff42878f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;useManagedPresentation&gt;
+WS\-Trust の CardSpace プロファイルをサポートする CardSpace セキュリティ トークン サービスとの通信に使用するバインディング要素。  この要素には属性がなく、空のスイッチとして表されます。  
+  
+## 構文  
+  
+```  
+  
+<useManagedPresentation/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ この要素は、WS\-Trust の CardSpace プロファイルをサポートするという事実をポリシーで明示するために、ID プロバイダーによって使用されます。  このようなポリシー アサーションを公開する ID プロバイダーは、その CardSpace プロファイルに基づくトークンを発行できる必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.UseManagedPresentationElement>   
+ <xref:System.ServiceModel.Channels.UseManagedPresentationBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/userdefinedtype.md b/docs/framework/configure-apps/file-schema/wcf/userdefinedtype.md
new file mode 100644
index 00000000000..5aebe409c96
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/userdefinedtype.md
@@ -0,0 +1,103 @@
+---
+title: "&lt;userDefinedType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f70ec06-8249-4f0c-9f49-b4df59985fb8
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;userDefinedType&gt;
+サービス コントラクトに含まれるユーザー定義型 \(UDT\) を表します。  
+  
+## 構文  
+  
+```  
+  
+<comContracts>  
+  <comContract>  
+      <userDefinedTypes>  
+         <userDefinedType name="string"  
+            typeLibID="string"  
+            typeLibVersion="string"  
+            typeDefID="string">  
+         </userDefinedType>  
+      </userDefinedTypes>  
+  </comContract>  
+</comContracts>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`name`|判読可能な型名を提供する文字列を含む省略可能な属性。  これは、ランタイムでは使用されませんが、リーダーが型を区別するのに役立ちます。|  
+|`TypeDefID`|登録されているタイプ ライブラリ内の特定の UDT 型を識別する GUID 文字列。|  
+|`TypeLibID`|型を定義する登録されているタイプ ライブラリを識別する GUID 文字列。|  
+|`TypeLibVersion`|型を定義するタイプ ライブラリ バージョンを識別する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|`userDefinedTypes`|`userDefinedType` 要素のコレクション。|  
+  
+## 解説  
+ COM\+ 統合ランタイムは、タイプ ライブラリを調べることによってサービスを作成します。  COM\+ コンポーネントに VARIANT を渡すメソッドが含まれている場合、システムでは、渡される実際の型を実行前に判断することはできません。  したがって、VARIANT としてユーザー定義型 \(UDT\) を渡そうとしても、シリアル化で認識できる型ではないので失敗します。  
+  
+ この問題を回避するには、UDT を構成ファイルに追加して、適切なサービス コントラクトで既知の型として含まれるようにすることができます。  このためには、UDT およびコントラクト、つまりそれを使用する元の COM インターフェイスを一意に識別する必要があります。  
+  
+ この目的で、2 つの特定の UDT を構成ファイルの \<`userDefinedTypes`\> セクションに追加するコード例を次に示します。  
+  
+```  
+<comContracts>  
+  <comContract  
+      contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"  
+      namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"  
+      name="_Broker"  
+      requireSession="true">  
+      <userDefinedTypes>  
+         <userDefinedType name="CustomerType"  
+            typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"  
+            typeLibVersion="1.0"  
+            typeDefID="{D129765C-F211-434e-825A-9A63198C41F2}">  
+         </userDefinedType>  
+         <userDefinedType name="AddressType"  
+            typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"  
+            typeLibVersion="1.0"  
+            typeDefID="{4616AE0D-687A-43B7-BC63-141AE3DFD099}">  
+         </userDefinedType>  
+      </userDefinedTypes>  
+      <exposedMethods>  
+         <exposedMethod name="BuyStock" />  
+         <exposedMethod name="SellStock" />  
+         <exposedMethod name="ExecuteTransaction" />  
+      </exposedMethods>  
+  </comContract>  
+</comContracts>  
+```  
+  
+ サービスを初期化する場合、統合ランタイムは、指定された型を検索し、指定されたコントラクトで既知の型のコレクションにそれらを追加します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComContractElement.UserDefinedTypes%2A>   
+ <xref:System.ServiceModel.Configuration.ComUdtElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComUdtElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/userdefinedtypes.md b/docs/framework/configure-apps/file-schema/wcf/userdefinedtypes.md
new file mode 100644
index 00000000000..ba486723f14
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/userdefinedtypes.md
@@ -0,0 +1,28 @@
+---
+title: "&lt;userDefinedTypes&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6f69742e-5144-4115-9344-cbe175aab73d
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;userDefinedTypes&gt;
+このセクションには、`userDefinedType` 要素のコレクションが含まれています。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ComContractElement.UserDefinedTypes%2A>   
+ <xref:System.ServiceModel.Configuration.ComUdtElementCollection>   
+ <xref:System.ServiceModel.Configuration.ComUdtElement>   
+ [\<comContracts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/comcontracts.md)   
+ [COM\+ アプリケーションとの統合](../../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/userequestheadersformetadataaddress.md b/docs/framework/configure-apps/file-schema/wcf/userequestheadersformetadataaddress.md
new file mode 100644
index 00000000000..6bf3764dd78
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/userequestheadersformetadataaddress.md
@@ -0,0 +1,52 @@
+---
+title: "&lt;useRequestHeadersForMetadataAddress&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 679f0eae-f353-44d1-b42d-a9e247509774
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;useRequestHeadersForMetadataAddress&gt;
+メタデータのアドレス情報を要求メッセージ ヘッダーから取得できるようにします。  
+  
+## 構文  
+  
+```  
+  
+<useRequestHeadersForMetadataAddress>  
+   <defaultPorts>  
+      <add scheme="http" port="integer" />  
+   </defaultPorts>  
+</useRequestHeadersForMetadataAddress>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<defaultPorts\>](../../../../../docs/framework/configure-apps/file-schema/wcf/defaultports.md)|クライアント アプリケーションがリッスンする既定の通信エンドポイントの一覧を表示する既定のポートのコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.UseRequestHeadersForMetadataAddressElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md b/docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md
new file mode 100644
index 00000000000..e061c2635f5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;userNameAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24d8b398-770f-418f-ba23-c4325419cfa6
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# &lt;userNameAuthentication&gt;
+ユーザー名とパスワードに基づいてサービスの資格情報を指定します。  
+  
+## 構文  
+  
+```  
+  
+<userNameAuthentication  
+   cacheLogonTokenLifetime="TimeSpan"  
+   cacheLogonTokens="Boolean"   
+   customUserNamePasswordValidatorType="String"  
+   includeWindowsGroups="Boolean"   
+   maxCacheLogonTokens="Integer"  
+   membershipProviderName="String"  
+   userNamePasswordValidationMode="Windows/MembershipProvider/Custom" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`cacheLogonTokenLifetime`|トークンがキャッシュ内に保持される最大時間を指定する <xref:System.Timespan>。  既定値は 00:15:00 です。|  
+|`cacheLogonTokens`|ログオン トークンがキャッシュされるかどうかを指定するブール値。  既定値は、`false` です。|  
+|`customUserNamePasswordValidatorType`|使用されるカスタム ユーザー名およびパスワード検証の種類を指定する文字列。  既定値は空の文字列です。|  
+|`includeWindowsGroups`|セキュリティ コンテキストに Windows グループが含まれるかどうかを指定するブール値。  既定値は、`true` です。<br /><br /> この属性を `true` に設定すると、グループ全体が拡張されるため、パフォーマンスに影響が及びます。  ユーザーが属するグループの一覧を生成する必要がない場合は、このプロパティを `false` に設定します。|  
+|`maxCacheLogonTokens`|キャッシュするログオン トークンの最大数を指定する整数。  この値は、ゼロより大きい値である必要があります。  既定値は 128 です。|  
+|`membershipProviderName`|バインディングの `clientCredentialType` 属性が `username` に設定されている場合、ユーザー名は Windows アカウントにマップされます。  関連するパスワード検証機構を提供する <xref:System.Web.Security.MembershipProvider> 値の名前を含む文字列であるこの属性を使用して動作をオーバーライドできます。|  
+|`userNamePasswordValidationMode`|ユーザー名とパスワードを検証する方法を指定します。  次の値を指定できます。<br /><br /> -   Windows<br />-   MembershipProvider<br />-   Custom<br /><br /> 既定は Windows です。  この属性は <xref:System.ServiceModel.Security.UserNamePasswordValidationMode> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ サービスで使用されるバインディングがユーザー名とパスワード ベースの認証を使用するように構成されていない場合、この要素の属性は無視されます。  これには、`customUserNamePasswordValidatorType`、`includeWindowsGroups`、`membershipProviderName`、および `userNamePasswordValidationMode` が含まれます。  
+  
+ サービスで使用されるバインディングが Windows 認証のユーザー名とパスワードを使用するように構成されていない場合、ログオン トークンのキャッシュに関連する設定は無視されます。  これには、`cacheLogonTokenLifetime`、`cacheLogonTokens`、および `maxCacheLogonTokens`、が含まれます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.UserNameServiceElement>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.UserNameAuthentication%2A>   
+ <xref:System.ServiceModel.Security.UserNamePasswordServiceCredential>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.UserNameAuthentication%2A>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/userprincipalname.md b/docs/framework/configure-apps/file-schema/wcf/userprincipalname.md
new file mode 100644
index 00000000000..60462341d64
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/userprincipalname.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;userPrincipalName&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 68032f69-149e-4613-bae4-18314d4fd294
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;userPrincipalName&gt;
+クライアントで認証するサービスのユーザー プリンシパル名 \(UPN\) を指定します。  
+  
+ UPN の設定の詳細については、「[サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<userPrincipalName value = "String" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|ユーザー アカウント名 \(ユーザー ログイン名と呼ばれることもある\) と、ユーザー アカウントの検索範囲のドメインを識別するドメイン名です。  これは、Windows ドメインにログオンするための標準的使用方法です。  形式は、someone@example.com です \(電子メールアドレスの場合\)。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)|クライアントで認証するサービスの ID を指定します。|  
+  
+## 解説  
+ この ID を持つエンドポイントに接続する、セキュリティで保護された [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] クライアントは、エンドポイントの SSPI 認証を実行するときに UPN を使用します。  
+  
+## 使用例  
+ 次の構成コードは、クライアントで認証するサービスの UPN を指定します。  
+  
+```  
+<identity>  
+  <userPrincipalName value="someone@cohowinery.com" />  
+</identity>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.IdentityElement>   
+ <xref:System.ServiceModel.EndpointAddress>   
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>   
+ <xref:System.ServiceModel.UpnEndpointIdentity>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/webhttp.md b/docs/framework/configure-apps/file-schema/wcf/webhttp.md
new file mode 100644
index 00000000000..66351e10cd4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/webhttp.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;webHttp&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f9d0754-d41e-44ce-a298-e51cb3096c64
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;webHttp&gt;
+この要素は、構成によってエンドポイントに <xref:System.ServiceModel.Description.WebHttpBehavior> を指定します。  この動作を [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) 標準バインディングと組み合わせて使用すると、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスの Web プログラミング モデルが有効になります。  
+  
+## 構文  
+  
+```  
+  
+<webHttp />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|automaticFormatSelectionEnabled|このプロパティが `true` に設定されている場合は、使用する最適な形式が WCF インフラストラクチャで決定されます。  形式の自動選択は、既定で、下位互換性のために無効になっています。  形式の自動選択は、プログラムで有効にすることも、構成ファイルを使用して有効にすることもできます。|  
+|defaultBodyStyle|返されたメッセージの既定の本文のスタイルを指定します。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.Web.WebMessageBodyStyle> および [WCF Web HTTP 形式](../../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)。|  
+|defaultOutgoingResponseFormat|メッセージの既定の送信応答形式を指定します。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)]詳細については、「[WCF Web HTTP 形式](../../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)」を参照してください。|  
+|faultExceptionEnabled|内部サーバー エラー \(HTTP ステータス コード: 500\) が発生したときに FaultException が生成されるかどうかを指定するフラグを取得または設定します。|  
+|helpEnabled|ヘルプ ページが有効かどうかを示す値を取得または設定します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|エンドポイントの動作のセットを指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WebHttpElement>   
+ <xref:System.ServiceModel.Description.WebHttpBehavior>   
+ [AJAX の統合と JSON のサポート](../../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)   
+ [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md
new file mode 100644
index 00000000000..ba2f57ea2a1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md
@@ -0,0 +1,108 @@
+---
+title: "&lt;webHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84179d77-825d-44b9-895a-ab08e7aa044d
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;webHttpBinding&gt;
+SOAP メッセージに代わって HTTP 要求に応答する [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] Web サービスのエンドポイントを構成するために使用するバインディング要素を定義します。  
+  
+## 構文  
+  
+```  
+  
+<webHttpBinding>  
+    <binding   
+        allowCookies="Boolean"  
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"  
+        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxBufferSize="integer"  
+        maxReceivedMessageSize="Integer"  
+        name="string"  
+        openTimeout="TimeSpan"   
+        proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+                transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"  
+        useDefaultWebProxy="Boolean">  
+  
+writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+        <security mode="None/Transport/TransportCredentialOnly">  
+            <transport clientCredentialType =   
+                 "Basic/Certificate/Digest/None/Ntlm/Windows"  
+                  proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                  realm="string" />  
+        </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</webHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowCookies|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は false です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxBufferSize|チャネルからメッセージを受け取るメッセージ バッファーのマネージャーが使用するために割り当てられる最大メモリ量を指定する整数。  既定値は 524,288 \(0x80000\) バイトです。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者はエラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。 **Note:**  ASP.NET 互換モードでは、この値を増やすだけでは十分ではありません。  `httpRuntime` の値も増やす必要があります \(「[httpRuntime 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/e9b81350-8aaf-47cc-9843-5f7d0c59f369)」を参照\)。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|transferMode|バインディングで構成されたサービスがメッセージ転送のストリーム モードまたはバッファー モード \(あるいは両方のモード\) を使用するかどうかを示す <xref:System.ServiceModel.TransferMode> 値。  既定値は、`Buffered` です。|  
+|useDefaultWebProxy|システムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+|writeEncoding|メッセージ テキストに使用される文字エンコーディングを指定します。  以下の値が有効です。<br /><br /> UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング。<br /><br /> Utf16TextEncoding: 16 ビットのエンコーディング。<br /><br /> Utf8TextEncoding: 8 ビットのエンコーディング。<br /><br /> 既定値は Utf8TextEncoding です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインディングを使用して構成されるエンドポイントにより処理可能な、POX メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-webhttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WebHttpSecurityElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] Web プログラミング モデルを使用すると、開発者は、SOAP ベースのメッセージングに代わって "Plain Old XML" \(POX\) スタイルのメッセージングを使用する HTTP 要求を通じて [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] Web サービスを公開できます。  HTTP 要求を使用してサービスと通信するクライアントに対しては、サービスのエンドポイントを \<WebHttpBehavior\> がアタッチされた [\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) で構成する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の配信および ASP.AJAX 統合のサポートは、Web プログラミング モデル上に構築されます。  このモデルの詳細については、「[WCF Web HTTP プログラミング モデル](../../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Configuration.WebHttpBindingElement>   
+ [WCF Web HTTP プログラミング モデル](../../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/webhttpendpoint.md b/docs/framework/configure-apps/file-schema/wcf/webhttpendpoint.md
new file mode 100644
index 00000000000..22fc50ea703
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/webhttpendpoint.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;webHttpEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ecaaeb6f-ebd0-411d-8b53-92477cd45347
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;webHttpEndpoint&gt;
+この構成要素は、[\<webHttp\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttp.md) の動作を自動的に追加する固定の [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) バインディングを持つ標準エンドポイントを定義します。  このエンドポイントは、REST サービスを作成する場合に使用します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <webHttpEndpoint>   
+          <standardEndpoint  
+             automaticFormatSelectionEnabled="String"   
+             defaultOutgoingResponseFormat=”Xml/Json”  
+             helpEnabled=”Boolean”  
+             webEndpointType=”String”/>        
+       </webHttpEndpoint>   
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|automaticFormatSelectionEnabled|形式の自動選択が有効かどうかを示すブール値。<br /><br /> 形式の自動選択が有効な場合、インフラストラクチャが要求メッセージの `Accept` ヘッダーを解析し、最適な応答形式を判断します。  適切な応答形式が `Accept` ヘッダーに指定されていなかった場合は、要求メッセージの `Content-Type` または操作の既定の応答形式がインフラストラクチャによって使用されます。|  
+|defaultOutgoingResponseFormat|既定の送信応答形式を指定する属性。  この属性は <xref:System.Servicemodel.Web.Webmessageformat> 型です。|  
+|helpEnabled|エンドポイントに対して HTTP ヘルプ ページが有効になっているかどうかを示すブール値。|  
+|webEndpointType|エンドポイントの種類を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.WebHttpEndpoint>   
+ <xref:System.ServiceModel.Configuration.WebHttpEndpointElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/webmessageencoding.md b/docs/framework/configure-apps/file-schema/wcf/webmessageencoding.md
new file mode 100644
index 00000000000..abed82f55fe
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/webmessageencoding.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;webMessageEncoding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 892ca485-e21a-4a44-8e40-633161ef6796
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;webMessageEncoding&gt;
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] バインディングで使用されるときに、プレーンテキストの XML、JSON \(JavaScript Object Notation\) メッセージ エンコーディング、および "生の" バイナリ コンテンツの読み取りと書き込みができるようにします。  
+  
+## 構文  
+  
+```  
+  
+<webMessageEncoding   
+      maxReadPoolSize="Integer"  
+   maxWritePoolSize="Integer"  
+  
+writeEncoding=”UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`maxReadPoolSize`|新しいリーダーを割り当てずに同時に読み取ることができるメッセージの数。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は、内部エンコーダー \(Text、JSON、および raw \(生\)\) ごとに 64 リーダーです。<br /><br /> この数を増やすとメモリの消費量が増えますが、受信メッセージ数の急激な増加にエンコーダーが対処できるようになります。これは、作成済みのリーダーをプールから使用でき、新しいリーダーを作成する必要がないためです。|  
+|`maxWritePoolSize`|新しいライターを割り当てずに同時に送信できるメッセージの数。  プール サイズを大きくすると、システムでは、比較的大きい作業セットで、アクティビティの急増に対する許容度が高まります。  既定値は、内部エンコーダー \(Text、JSON、および raw \(生\)\) ごとに 64 リーダーです。<br /><br /> この数を増やすとメモリの消費が増えますが、送信メッセージ数の急激な増加にエンコーダーが対処できるようになります。これは、作成済みのライターをプールから使用でき、新しいライターを作成する必要がないためです。|  
+|`writeEncoding`|バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。  次の値を指定できます。<br /><br /> -   UnicodeFffeTextEncoding: Unicode ビッグ エンディアン エンコーディング。<br />-   Utf16TextEncoding: Unicode エンコーディング。<br />-   Utf8TextEncoding: 8 ビットのエンコーディング。<br /><br /> 既定値は Utf8TextEncoding です。  この属性は <xref:System.Text.Encoding> 型です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ エンコーディングは、メッセージをバイト シーケンスに変換するプロセスです。  デコードは、その逆のプロセスです。  これらのプロセスでは、文字エンコーディングの指定が必要です。  
+  
+ `webMessageEncoding` 要素は、プレーンテキストの XML と JSON エンコーディング、および "生" のバイナリ データの処理を、一連の内部エンコーダーに代行させることで機能します。  この委任は、複合メッセージ エンコーダーによって実行されます。  
+  
+ このバインディング要素と複合エンコーダーは、`webHttpBinding` 要素によって使用される SOAP メッセージを使用しないシナリオでのエンコーディングを制御するために使用されます。  これらのシナリオには、POX \("Plain Old XML"\)、REST \(Representational State Transfer\)、RSS \(Really Simple Syndication\) と Atom 配信、および AJAX \(Asynchronous JavaScript and XML\) が含まれます。  複合メッセージ エンコーダーは SOAP または WS\-Addressing をサポートしません。  
+  
+ `writeEncoding` 属性を使用すると、バインディング要素に書き込みの文字エンコーディングを構成できます。  指定された <xref:System.Text.Encoding> 値は、JSON およびテキスト形式の XML の場合の書き込みの動作を指定します。  読み取りについては、任意の有効なメッセージ エンコーディングとテキスト エンコーディングが認識されます。  
+  
+ `maxReadPoolSize` と `maxWritePoolSize` を使用して、割り当てられるリーダーとライターの最大数をそれぞれ設定することもできます。  既定では、64 のリーダーと 16 のライターが割り当てられています。  
+  
+ 既定の複雑さの制約は、[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md) 要素を使用して設定されます。これにより、メッセージの複雑さを利用してエンドポイント処理リソースを停滞させる、サービス拒否 \(DOS\) 型の攻撃から保護できます。  
+  
+## 使用例  
+  
+```  
+<webMessageEncoding   
+    maxReadPoolSize="256"  
+    maxWritePoolSize="128"  
+    messageVersion="None"  
+    textEncoding=”utf-8”   
+/>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WebMessageEncodingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.WebMessageEncodingBindingElement>   
+ [メッセージ エンコーディング](../../../../../docs/framework/configure-apps/file-schema/wcf/message-encoding.md)   
+ [メッセージ エンコーダーを選択する](../../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/webscriptendpoint.md b/docs/framework/configure-apps/file-schema/wcf/webscriptendpoint.md
new file mode 100644
index 00000000000..b57f5d1175d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/webscriptendpoint.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;webScriptEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85cb5ecf-351b-45f3-aa29-aa2e4b64bcdd
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;webScriptEndpoint&gt;
+この構成要素は、[\<enableWebScript\>](../../../../../docs/framework/configure-apps/file-schema/wcf/enablewebscript.md) の動作を自動的に追加する固定の [\<webHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md) バインディングを持つ標準エンドポイントを定義します。  このエンドポイントは、ASP.NET AJAX アプリケーションから呼び出されるサービスを作成する場合に使用します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <webScriptEndpoint>   
+          <standardEndpoint  
+             webEndpointType=”String”/>        
+       </webScriptEndpoint>   
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|webEndpointType|エンドポイントの種類を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.WebScriptEndpoint>   
+ <xref:System.ServiceModel.Configuration.WebScriptEndpointElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/websocketsettings.md b/docs/framework/configure-apps/file-schema/wcf/websocketsettings.md
new file mode 100644
index 00000000000..36d74b6bc67
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/websocketsettings.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;webSocketSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bbf97e02-8dd1-4922-acac-3cd33397b249
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;webSocketSettings&gt;
+Web ソケット設定を指定するために使用される構成要素。  
+  
+## 構文  
+  
+```  
+  
+<netHttpBinding>  
+   <binding>   
+       <webSocketSettings createNotificationOnConnection="boolean"  
+                              disablePayloadMasking="boolean"  
+                              keepAliveInterval="TimeSpan"  
+                              maxPendingConnections="Integer"  
+                              receiveBufferSize="Integer"  
+                              sendBufferSize="Integer"  
+                              subProtocol="String"  
+                              transportUsage="WhenDuplex/Always/Never"/>  
+   </binding>  
+</netHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|createNotificationOnConnection|通知を接続時に送信するかどうかを指定します。|  
+|disablePayloadMasking|Web ソケットのマスクが無効であるかどうかを指定します。|  
+|keepAliveInterval|接続維持の間隔を指定します。|  
+|maxPendingConnections|サービスでのディスパッチを待機している接続の最大数を指定します。|  
+|receiveBufferSize|受信バッファーのサイズを指定します。|  
+|sendBufferSize|送信バッファーのサイズを指定します。|  
+|subProtocol|Web ソケットのサブプロトコルを指定します。|  
+|transportUsage|Web ソケットを使用するタイミングを指定します。|  
+  
+## transportUsage 属性  
+  
+|値|説明|  
+|-------|--------|  
+|WhenDuplex|コントラクトが双方向の場合に、Web ソケット プロトコルを使用します。|  
+|Always|コントラクトにかかわらず、常にWeb ソケット プロトコルを使用します。|  
+|Never|Web ソケット プロトコルを使用しません。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<netHttpBinding\>|NetHttpBinding を指定します。|  
+  
+## 使用例  
+ \<webSocketSettings\> 要素を使用する方法を次の例に示します。  
+  
+```xml  
+<netHttpBinding>  
+        <binding>  
+          <webSocketSettings createNotificationOnConnection="true"  
+                              disablePayloadMasking="false  
+                              keepAliveInterval="00:10:00"  
+                              maxPendingConnections="100"  
+                              receiveBufferSize="1000"  
+                              sendBufferSize="1000"  
+                              subProtocol="Soap"  
+                              transportUsage="WhenDuplex/Always/Never"/>  
+  
+        </binding>  
+      </netHttpBinding>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Configuration.BasicHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/windows-of-clientcredentials-element.md b/docs/framework/configure-apps/file-schema/wcf/windows-of-clientcredentials-element.md
new file mode 100644
index 00000000000..d47f2b46291
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/windows-of-clientcredentials-element.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;clientCredentials&gt; 要素の &lt;windows&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 793e41c2-31ea-4159-abbc-2123bf097233
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;clientCredentials&gt; 要素の &lt;windows&gt;
+クライアントを表すために使用される Windows 資格情報の設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<windows   
+    allowedImpersonationLevel="Identification/Impersonation/Delegation/Anonymous/None"  
+        allowNtlm="Boolean"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowedImpersonationLevel`|クライアントがサーバーと通信する偽装設定を設定します。  クライアントが選択する偽装モードは、サーバーでは適用されません。  以下の値が有効です。<br /><br /> -   Identification: サーバーはクライアントの ID および権限を取得できますが、クライアントを偽装することはできません。<br />-   Impersonation: サーバーは、ローカル システム上にあるクライアントのセキュリティ コンテキストを偽装できます。<br />-   Delegation: サーバーは、リモート システム上にあるクライアントのセキュリティ コンテキストを偽装できます。<br />-   Anonymous: サーバーは、クライアントを偽装したり、識別したりすることができません。<br />-   None: 偽装レベルが割り当てられていません。<br /><br /> 既定値は Identification です。  この属性は <xref:System.Security.Principal.TokenImpersonationLevel> 型です。|  
+|`allowNtlm`|このプロパティを `true` に設定すると、Kerberos 認証を利用できない場合、NTLM 認証にダウングレードできます。<br /><br /> このプロパティを `false` に設定すると、NTLM が使用されている場合、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] はベスト エフォートで例外をスローします。  ただし、このプロパティを `false` に設定しても、ネットワーク経由で NTLM 資格情報が送信されなくなるとは限りません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<clientCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)|サービスに対するクライアントの認証に使用される資格情報を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WindowsClientElement>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement.Windows%2A>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ClientCredentials.Windows%2A>   
+ <xref:System.ServiceModel.Security.WindowsClientCredential>   
+ [クライアントのセキュリティ保護](../../../../../docs/framework/wcf/securing-clients.md)   
+ [証明書の使用](../../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/windowsauthentication-of-servicecredentials.md b/docs/framework/configure-apps/file-schema/wcf/windowsauthentication-of-servicecredentials.md
new file mode 100644
index 00000000000..1acdf94dbc2
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/windowsauthentication-of-servicecredentials.md
@@ -0,0 +1,57 @@
+---
+title: "&lt;serviceCredentials&gt; の &lt;windowsAuthentication&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0709473-0997-4de3-8f49-783527309a48
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# &lt;serviceCredentials&gt; の &lt;windowsAuthentication&gt;
+Windows サービス資格情報の設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<windowsAuthentication  
+      allowAnonymousLogons="Boolean"  
+      includeWindowsGroups="Boolean" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`includeWindowsGroups`|セキュリティ コンテキストに Windows グループが含まれるかどうかを指定する省略可能なブール属性。  既定値は、`true` です。<br /><br /> この属性を `true` に設定すると、グループ全体が拡張されるため、パフォーマンスに影響が及びます。  ユーザーが属するグループの一覧を生成する必要がない場合は、この属性を `false` に設定します。|  
+|`allowAnonymousLogons`|認証されていない匿名の呼び出し元を許可するかどうかを指定する省略可能なブール属性。  既定値は、`false` です。<br /><br /> バインディングの `clientCredentialType` 属性が `Windows` に設定されている場合、匿名の呼び出し元は許可されません。  これは、ドメインまたはワークグループの認証済み呼び出し元だけがシステムへのアクセスを許可されていることを示します。  この動作は、この属性を使用してオーバーライドできます。<br /><br /> この設定を使用するときは十分に注意してください。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceCredentials\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)|サービスの認証に使用される資格情報と、クライアントの資格情報検証関連の設定を指定します。|  
+  
+## 解説  
+ 匿名の Windows ユーザーのアクセスを許可するかどうかを指定するには、この要素を使用して、`allowAnonymousLogons` 属性を設定します。  また、`includeWindowsGroups` 属性を設定すると、ユーザーが属するグループの情報を AuthorizationContext に含めるかどうかも指定できます。  この属性が `true` \(既定値\) に設定されている場合、サービスはクライアントが属している Windows グループを特定できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WindowsServiceElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement.WindowsAuthentication%2A>   
+ <xref:System.ServiceModel.Description.ServiceCredentials.WindowsAuthentication%2A>   
+ <xref:System.ServiceModel.Security.WindowsServiceCredential>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/windowsstreamsecurity.md b/docs/framework/configure-apps/file-schema/wcf/windowsstreamsecurity.md
new file mode 100644
index 00000000000..6fa0d094e43
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/windowsstreamsecurity.md
@@ -0,0 +1,57 @@
+---
+title: "&lt;windowsStreamSecurity&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 926bea29-90c7-4a26-9cf0-fb4aa44f6f70
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# &lt;windowsStreamSecurity&gt;
+カスタム バインディングの Windows ストリーム セキュリティ設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<windowsStreamSecurity protectionLevel="None/Sign/EncryptAndSign"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|protectionLevel|メッセージ レベルのセキュリティを定義します。  メッセージに署名すると、転送中のメッセージが第三者によって改ざんされるリスクを軽減します。  暗号化により、転送中にデータレベルのプライバシーが提供されます。  以下の値が有効です。<br /><br /> -   None: 保護されません。<br />-   Sign: メッセージは署名されます。<br />-   EncryptAndSign: メッセージは署名および暗号化されます。<br /><br /> 既定値は EncryptAndSign です。<br /><br /> この属性は <xref:System.Net.Security.ProtectionLevel> 型です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<binding\>](../../../../../docs/framework/misc/binding.md)|カスタム バインドのすべてのバインド機能を定義します。|  
+  
+## 解説  
+ TCP などのストリーム指向プロトコルおよび名前付きパイプを使用するトランスポートは、ストリーム ベースのトランスポート アップグレードをサポートします。  特に、WCF にはセキュリティ アップグレードが用意されています。  このトランスポート セキュリティの構成は、この構成要素および [\<sslStreamSecurity\>](../../../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md) によってカプセル化され、構成してカスタム バインディングに追加できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ <xref:System.ServiceModel.Configuration.WindowsStreamSecurityElement>   
+ <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [バインディングの拡張](../../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [カスタム バインディング](../../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/workflow-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/workflow-of-wcf.md
new file mode 100644
index 00000000000..80dfec39a45
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/workflow-of-wcf.md
@@ -0,0 +1,101 @@
+---
+title: "WCF の &lt;workflow&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0443eba-d3b4-4fae-886e-9878daf77691
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;workflow&gt;
+ランタイムから直接出力される追跡レコードをリッスンし、追跡レコードの構成方法に従って処理を行う追跡参加要素を構成します。  これには、特定の出力 \(ファイル、コンソール、ETW など\) への書き込み、レコードの処理や集計、またはその他の必要な組み合わせが含まれます。  
+  
+ ワークフロー追跡と追跡参加要素の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>   
+   <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+   </participants>   
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|name|追跡参加要素の名前を指定する文字列。|  
+|profileName|追跡参加要素が定期受信した追跡レコードを定義する、追跡プロファイルの名前を指定する文字列。|  
+|型|追跡参加要素の型を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|追跡参加要素の一覧|  
+  
+## 解説  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+ 複数の追跡参加要素が追跡イベントを同時に使用することができます。  各追跡参加要素は、それぞれ別の追跡プロファイルと関連付けることができます。  
+  
+ 追跡レコードを ETW セッションに書き込む、標準の追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、`<diagnostics>` セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、`<add>` 要素の `profileName` 属性で定義されます。  これらが定義されると、追跡参加要素は `<etwTracking>` サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.TrackingSection>   
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehavior>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/workflowcontrolendpoint.md b/docs/framework/configure-apps/file-schema/wcf/workflowcontrolendpoint.md
new file mode 100644
index 00000000000..a8dfc0f575c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/workflowcontrolendpoint.md
@@ -0,0 +1,55 @@
+---
+title: "&lt;workflowControlEndpoint&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c89e76c-643b-4b6a-9b25-628f753d7027
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;workflowControlEndpoint&gt;
+この構成要素は、ワークフロー インスタンスの実行の制御 \(作成、実行、保留、終了など\) に使用する標準エンドポイントを定義します。  
+  
+## 構文  
+  
+```  
+  
+<system.serviceModel>  
+    <standardEndpoints>  
+       <workflowControlEndpoint>   
+          <standardEndpoint  
+                  name="String" />   
+       </workflowControlEndpoint>          
+    </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|標準エンドポイントの構成名を指定する文字列。  この名前は、サービス エンドポイントの `endpointConfiguration` 属性で使用され、標準エンドポイントと構成を関連付けます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<standardEndpoints\>](../../../../../docs/framework/configure-apps/file-schema/wcf/standardendpoints.md)|1 つ以上のプロパティ \(アドレス、バインディング、コントラクト\) が固定されている、あらかじめ定義されたエンドポイントである標準エンドポイントのコレクション。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activites.WorkflowControlEndpoint>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/workflowinstancequeries-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/workflowinstancequeries-of-wcf.md
new file mode 100644
index 00000000000..38c91f5421d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/workflowinstancequeries-of-wcf.md
@@ -0,0 +1,94 @@
+---
+title: "WCF の &lt;workflowInstanceQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0852f77-16e4-4d55-8eb7-a19feb0e8fc4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;workflowInstanceQueries&gt;
+開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡する構成要素のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md)|ワークフロー インスタンスのライフサイクルの変化を追跡するために使用されるクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|`activityDefinitionId` プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 解説  
+ <xref:System.Activities.Tracking.WorkflowInstanceQuery> は、次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの定期受信に使用されます。  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/workflowinstancequery-of-wcf.md b/docs/framework/configure-apps/file-schema/wcf/workflowinstancequery-of-wcf.md
new file mode 100644
index 00000000000..26de68cfb1f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/workflowinstancequery-of-wcf.md
@@ -0,0 +1,94 @@
+---
+title: "WCF の &lt;workflowInstanceQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35c73f9d-474e-42eb-874d-ddc04b1987f3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF の &lt;workflowInstanceQuery&gt;
+開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡するクエリを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md)|開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡する構成要素のコレクションを表します。|  
+  
+## 解説  
+ <xref:System.Activities.Tracking.WorkflowInstanceQuery> は、次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの定期受信に使用されます。  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/workflowruntime.md b/docs/framework/configure-apps/file-schema/wcf/workflowruntime.md
new file mode 100644
index 00000000000..1c6024d80a4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/workflowruntime.md
@@ -0,0 +1,91 @@
+---
+title: "&lt;workflowRuntime&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 304c70fa-78d1-4d0f-b89f-0ca23d734c6f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;workflowRuntime&gt;
+ワークフロー ベースの [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスをホストする <xref:System.Workflow.Runtime.WorkflowRuntime> のインスタンスの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<workflowRuntime cachedInstanceExpiration="TimeSpan"  
+                                  enablePerformanceCounters="Boolean"  
+                                  name="String"  
+                                  validateOnCreate="Boolean">  
+                 <commonParameters>  
+                    <add name="String" value="String" />  
+                 </commonParameters>  
+                 <services>  
+                    <add type="String"/>  
+                 </services>  
+</workflowRuntime>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|cachedInstanceExpiration|ワークフロー インスタンスが強制的にアンロードまたは中止される前に、アイドル状態でメモリに残ることができる最大期間を指定する、省略可能な <xref:System.Timespan> 値。  unloadOnIdle を実行する `PersistenceService` が workflowruntime に設定されている場合、この属性は無視されます。|  
+|enablePerformanceCounters|パフォーマンス カウンターが有効であるかどうかを指定する省略可能なブール値。  パフォーマンス カウンターは、ワークフローに関連したさまざまな統計情報を提供します。ただしそのために、ワークフロー ランタイム エンジンが起動してワークフロー インスタンスが実行されている間は、パフォーマンスが低下します。  既定値は `true` です。|  
+|name|ワークフロー ランタイム エンジンの名前を含む文字列。  名前は出力で使用され、このランタイムを、システムで実行されている他のランタイム \(パフォーマンス カウンターなど\) と区別するために使用されます。<br /><br /> 既定値は空の文字列です。|  
+|validateOnCreate|WorkflowServiceHost を開いたときにワークフロー定義の検証を行うかどうかを指定する省略可能なブール値。  この属性が `true` に設定されているときは、`WorkflowServiceHost.Open` が呼び出されるたびにワークフローの検証が実行されます。  検証エラーが見つかった場合は、<xref:System.Workflow.ComponentModel.Compiler.WorkflowValidationFailedException> エラーがスローされます。<br /><br /> このプロパティが `false` に設定されている場合、ワークフロー定義の検証は行われません。<br /><br /> このプロパティの既定値は `true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|commonParameters|サービスによって使用される共通パラメーターのコレクション。  このコレクションには通常、永続性サービスによって共有されるデータベース接続文字列が格納されます。|  
+|サービス|<xref:System.Workflow.Runtime.WorkflowRuntime> エンジンに追加されるサービスのコレクション。  要素は、<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement> 型です。  コレクションで指定されたサービスはワークフロー ランタイム エンジンによって初期化され、適切な <xref:System.Workflow.Runtime.WorkflowRuntime> コンストラクターが呼び出されるとワークフロー ランタイム エンジンのサービスに追加されます。  したがって、コレクションで指定されたサービスは、そのコンストラクターのシグネチャに関して一定の規則に従う必要があります。  詳細については、「<xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>」を参照してください。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behavior\>](../../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)|動作の要素を指定します。|  
+  
+## 解説  
+ Windows Workflow Foundation ホスト アプリケーションの <xref:System.Workflow.Runtime.WorkflowRuntime> オブジェクトの動作を制御する構成ファイルの使い方の詳細については、「[Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<serviceBehaviors>  
+   <behavior name="ServiceBehavior">  
+      <workflowRuntime name="WorkflowServiceHostRuntime"  
+                       validateOnCreate="true"  
+                       enablePerformanceCounters="true">  
+         <commonParameters>  
+            <add name="ConnectionString" value="Initial Catalog=WorkflowStore;Data Source=localhost;Integrated Security=SSPI;" />  
+            <add name="EnableRetries" value="True" />  
+         </commonParameters>  
+         <services>  
+             <add type="NetFx.Checkin.Scenario.WorkflowServices.WorkflowBasedServices.Common.TestPersistenceService.FilePersistenceService, NetFx.Checkin.Scenario.WorkflowServices.WorkflowBasedServices.Common"/>  
+         </services>  
+      </workflowRuntime>  
+   </behavior>  
+</serviceBehaviors>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WorkflowRuntimeElement>   
+ <xref:System.Workflow.Runtime.Configuration.WorkflowRuntimeServiceElement>   
+ <xref:System.Workflow.Runtime.WorkflowRuntime>   
+ [Workflow Configuration Files](http://msdn.microsoft.com/ja-jp/ada4bb90-6c9d-4f3d-a9d0-b559bb0f9909)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md
new file mode 100644
index 00000000000..ac304bc4dcf
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md
@@ -0,0 +1,145 @@
+---
+title: "&lt;ws2007FederationHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9af4ec79-cdef-457e-9dca-09d5eb821594
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;ws2007FederationHttpBinding&gt;
+[\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)から派生し、フェデレーション セキュリティをサポートする、セキュリティで保護された相互運用可能なバインディングです。  
+  
+## 構文  
+  
+```  
+  
+<ws2007FederationHttpBinding>  
+    <binding   
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"   
+        hostNameComparisonMode="StrongWildcard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="integer"  
+        messageEncoding="Text/Mtom"   
+                name="string"  
+        openTimeout="TimeSpan"   
+        privacyNoticeAt="Uri"  
+        privacyNoticeVersion="Integer"  
+        proxyAddress="Uri"   
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+        textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+        transactionFlow="Boolean"  
+        useDefaultWebProxy="Boolean">  
+        <security mode="None/Message/TransportWithMessageCredential">  
+           <message negotiateServiceCredential="Boolean"  
+                algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                issuedTokenType="string"  
+                issuedKeyType="SymmetricKey/PublicKey"  
+           </message>  
+        </security>  
+        <reliableSession ordered="Boolean"  
+           inactivityTimeout="TimeSpan"  
+           enabled="Boolean" />  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</ws2007FederationHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示す値。  既定値は、`false` です。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`hostnameComparisonMode`|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|このバインドに使用するバッファー プールの最大サイズ。  既定は 524,288 バイト \(512 \* 1024\) です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|`maxReceivedMessageSize`|チャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) が、このバインドを使用してバイト単位で設定されました。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|`messageEncoding`|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`name`|バインドの構成名。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`privactyNoticeAt`|プライバシーに関する声明の場所を示す URI。|  
+|`privactyNoticeVersion`|現在のプライバシーに関する声明のバージョン。|  
+|`proxyAddress`|HTTP プロキシのアドレスを指定する URI。  `useDefaultWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode ビッグ エンディアン エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|`transactionFlow`|バインドが WS\-Transactions のフローをサポートするかどうかを指定する値。  既定値は、`false` です。|  
+|`useDefaultWebProxy`|システムの自動設定 HTTP プロキシを使用するかどうかを示す値。  この属性が `true` の場合、プロキシ アドレスを `null` \(つまり、設定しない\) にする必要があります。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ フェデレーションは、複数の企業または信頼するドメインで認証と承認用の ID を共有する機能です。  フェデレーションは、WS\-Trust プロトコルを使用して、ID 形式を、ある信頼するドメインから別の信頼するドメインにマップします。  フェデレーション HTTP バインドは、SOAP セキュリティと混合モード セキュリティをサポートしますが、トランスポート セキュリティの単独使用はサポートしません。  このバインディングで構成されたサービスは、HTTP トランスポートを使用する必要があります。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] [\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md).  
+  
+## 使用例  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+<bindings>  
+<ws2007FederationHttpBinding>  
+    <binding   
+        bypassProxyOnLocal="false"  
+        transactionFlow="false"  
+        hostNameComparisonMode="WeakWildcard"  
+        maxReceivedMessageSize="1000"  
+        messageEncoding="Mtom"   
+        proxyAddress="http://www.contoso.com"   
+        textEncoding="Utf16TextEncoding"  
+        useDefaultWebProxy="false">  
+        <reliableSession ordered="false"  
+            inactivityTimeout="00:02:00" enabled="true" />  
+        <security mode="None">  
+           <message negotiateServiceCredential="false"  
+                algorithmSuite="Aes128"  
+                issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1"   
+                issuedKeyType="PublicKey">  
+               <issuer address="http://localhost/Sts" />  
+           </message>  
+        </security>  
+    </binding>  
+</ws2007FederationBinding>  
+</bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.WS2007FederationHttpBinding>   
+ <xref:System.ServiceModel.Configuration.WS2007FederationHttpBindingElement>   
+ [\<wsFederationHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md b/docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md
new file mode 100644
index 00000000000..f4136407185
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md
@@ -0,0 +1,153 @@
+---
+title: "&lt;ws2007HttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8586ecc9-bdaa-44d6-8d4d-7038e4ea1741
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# &lt;ws2007HttpBinding&gt;
+<xref:System.ServiceModel.WSHttpBinding.Security%2A>、<xref:System.ServiceModel.ReliableSession>、および <xref:System.ServiceModel.WSHttpBindingBase.TransactionFlow%2A> の各バインディング要素の適切なバージョンをサポートする相互運用可能なバインディングを定義します。  
+  
+## 構文  
+  
+```  
+  
+<ws2007HttpBinding>  
+    <binding   
+        allowCookies="Boolean"  
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"  
+        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="Integer"  
+        messageEncoding="Text/Mtom"   
+                name="string"  
+        openTimeout="TimeSpan"   
+        proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+  
+textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+        transactionFlow="Boolean"  
+        useDefaultWebProxy="Boolean">  
+        <reliableSession ordered="Boolean"  
+           inactivityTimeout="TimeSpan"  
+           enabled="Boolean" />  
+        <security mode="Message/None/Transport/TransportWithCredential">  
+           <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                realm="string"   
+                                />  
+          <message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"  
+           negotiateServiceCredential="Boolean"  
+           algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+           establishSecurityContext="Boolean"   
+           negotiateServiceCredential="Boolean"/>  
+        </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</ws2007HttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`allowCookies`|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定する値です。  既定値は、`false` です。<br /><br /> クッキーを使用する ASMX \(ASP.NET Web サービス\) と対話する場合に、このプロパティを使用できます。  これにより、サーバーから返されるクッキーが、このサービスに対するそれ以降のすべてのクライアント要求に自動的にコピーされます。|  
+|`bypassProxyOnLocal`|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示す値。  既定値は、`false` です。|  
+|`closeTimeout`|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`hostnameComparisonMode`|URI \(Uniform Resource Identifier\) の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|`maxBufferPoolSize`|このバインドに使用するバッファー プールの最大サイズ。  既定値は 524,288 バイト \(512 × 1,024\) です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] の多くの部分でバッファーが使用されます。  使用するたびに毎回バッファーを作成および破棄すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄によるオーバーヘッドを回避できます。|  
+|`maxReceivedMessageSize`|このバインディングで構成されたチャネルで受信可能な、ヘッダーを含む最大メッセージ サイズ \(バイト単位\) です。  この制限を超える場合、メッセージの送信者は SOAP エラーを受け取ります。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|`messageEncoding`|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   `Text`: テキスト メッセージ エンコーダーを使用します。<br />-   `Mtom`: MTOM \(Message Transmission Organization Mechanism\) 1.0 エンコーダーを使用します。<br /><br /> 既定値は、`Text` です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|`name`|バインドの構成名。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|`openTimeout`|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`proxyAddress`|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|`receiveTimeout`|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`sendTimeout`|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|`textEncoding`|バインディングでメッセージの発行に使用する文字セット エンコーディングを指定します。  以下の値が有効です。<br /><br /> -   `UnicodeFffeTextEncoding`: Unicode ビッグ エンディアン エンコーディング。<br />-   `Utf16TextEncoding`: 16 ビット エンコーディング。<br />-   `Utf8TextEncoding`: 8 ビット エンコーディング。<br /><br /> 既定値は、`Utf8TextEncoding` です。<br /><br /> この属性は <xref:System.Text.Encoding> 型です。|  
+|`transactionFlow`|バインドが WS\-Transactions のフローをサポートするかどうかを指定する値。  既定値は、`false` です。|  
+|`useDefaultWebProxy`|システムの自動設定 HTTP プロキシを使用するかどうかを示す値です。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインディングを使用して設定されるエンドポイントで処理できる、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ `WS2007HttpBinding` は、`WSHttpBinding` と同様のシステム標準のバインディングを追加しますが、ReliableSession、Security、および TransactionFlow の各プロトコルの OASIS \(Organization for the Advancement of Structured Information Standards\) 標準バージョンを使用します。  このバインドを使用する場合、オブジェクト モデルも既定の設定も変更する必要はありません。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+    <system.ServiceModel>  
+        <bindings>  
+            <ws2007HttpBinding>  
+                <binding   
+                    closeTimeout="00:00:10"  
+                    openTimeout="00:00:20"   
+                    receiveTimeout="00:00:30"  
+                    sendTimeout="00:00:40"  
+                    bypassProxyOnLocal="false"  
+                    transactionFlow="false"   
+                    hostNameComparisonMode="WeakWildcard"  
+                    maxReceivedMessageSize="1000"  
+                    messageEncoding="Mtom"   
+                    proxyAddress="http://www.contoso.com"  
+                    textEncoding="utf-16"  
+                    useDefaultWebProxy="false">  
+                    <reliableSession ordered="false"  
+                         inactivityTimeout="00:02:00"  
+                         enabled="true" />  
+                    <security mode="Transport">  
+                         <transport clientCredentialType="Digest"  
+                            proxyCredentialType="None"  
+                            realm="someRealm" />  
+                         <message clientCredentialType="Windows"  
+                            negotiateServiceCredential="false"  
+                            algorithmSuite="Aes128"   
+                            defaultProtectionLevel="None" />  
+                    </security>  
+                </binding>  
+           </ws2007HttpBinding>  
+        </bindings>  
+    </system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.WS2007HttpBinding>   
+ <xref:System.ServiceModel.Configuration.WS2007HttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wsdlimporter.md b/docs/framework/configure-apps/file-schema/wcf/wsdlimporter.md
new file mode 100644
index 00000000000..02b642dd461
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wsdlimporter.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;wsdlImporter&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 986b2165-8430-4dba-b1b8-00396841bb96
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# &lt;wsdlImporter&gt;
+WS\-Policy が添付された Web サービス記述言語 \(WSDL\) 1.1 メタデータをインポートするすべての WSDL インポーターを指定します。  
+  
+## 構文  
+  
+```  
+  
+<metadata>  
+      <wsdlImporters>  
+      <wsdlImporter type="string" />  
+   </wsdlImporters>  
+</metadata>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`type`|この要素の型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<wsdlImporters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wsdlimporters.md)|WS\-Policy が添付された Web サービス記述言語 \(WSDL\) 1.1 メタデータをインポートするすべての WSDL インポーターを指定します。|  
+  
+## 解説  
+ WSDL インポーターは、メタデータのインポートに加えて、コントラクトおよびエンドポイント情報を表すさまざまなクラスにその情報を変換するために使用されます。  コントラクトおよびエンドポイントの情報やプロパティを選択的にインポートできます。これらは、任意のインポート エラーを公開し、インポートおよび変換プロセスに関連する型情報を受け取ります。  また、任意のポリシー ドキュメント、WSDL ドキュメント、WSDL 拡張、および XML スキーマ ドキュメントにアクセスするためのバインディング情報およびプロパティのインポートもサポートします。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.WsdlImporterElement>   
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ <xref:System.ServiceModel.Configuration.WsdlImporterElementCollection>   
+ <xref:System.ServiceModel.Description.MetadataImporter>   
+ <xref:System.ServiceModel.Description.WsdlImporter>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wsdlimporters.md b/docs/framework/configure-apps/file-schema/wcf/wsdlimporters.md
new file mode 100644
index 00000000000..c93d692d7cb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wsdlimporters.md
@@ -0,0 +1,28 @@
+---
+title: "&lt;wsdlImporters&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 270c7f93-eab7-47b6-8b94-ac3f5b7f17e4
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;wsdlImporters&gt;
+この構成要素は、WS\-Policy が添付された Web サービス記述言語 \(WSDL\) 1.1 メタデータをインポートするすべての WSDL インポートを指定します。  各子要素は、メタデータをインポートし、その情報をコントラクトおよびエンドポイント情報を表すさまざまなクラスに変換する方法を指定する \<`wsdlImporter`\> です。  コントラクトおよびエンドポイントの情報やプロパティを選択的にインポートできます。これらは、任意のインポート エラーを公開し、インポートおよび変換プロセスに関連する型情報を受け取ります。  また、任意のポリシー ドキュメント、WSDL ドキュメント、WSDL 拡張、および XML スキーマ ドキュメントにアクセスするためのバインディング情報およびプロパティのインポートもサポートします。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.MetadataElement>   
+ <xref:System.ServiceModel.Configuration.WsdlImporterElementCollection>   
+ <xref:System.ServiceModel.Description.MetadataImporter>   
+ <xref:System.ServiceModel.Description.WsdlImporter>   
+ [WCF クライアントの構成](../../../../../docs/framework/wcf/feature-details/client-configuration.md)   
+ [クライアント](../../../../../docs/framework/wcf/feature-details/clients.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md
new file mode 100644
index 00000000000..139db0970ce
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md
@@ -0,0 +1,150 @@
+---
+title: "&lt;wsDualHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "wsDualHttpBinding 要素"
+ms.assetid: fd8ac4e2-5641-473b-9115-73f14ab1c065
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# &lt;wsDualHttpBinding&gt;
+双方向サービス コントラクト、または SOAP 中継局を介しての通信に適した、セキュリティで保護されて信頼できる相互操作可能なバインディングを定義します。  
+  
+## 構文  
+  
+```  
+  
+<wsDualHttpBinding>  
+        <binding name="string"  
+        closeTimeout="TimeSpan"  
+        openTimeout="TimeSpan"   
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+        bypassProxyOnLocal="Boolean"  
+        clientBaseAddress="URI"  
+        transactionFlow="Boolean"   
+        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="Integer"  
+        messageEncoding="Text/Mtom"   
+        proxyAddress="URI"  
+  
+textEncoding="Unicode/BigEndianUnicode/UTF8"  
+        useDefaultWebProxy="Boolean">  
+        <reliableSession ordered="Boolean"  
+            inactivityTimeout="TimeSpan" />  
+        <security mode="None/Message">  
+           <message clientCredentialType="None/Windows/UserName/Certificate/CardSpace"  
+                negotiateServiceCredential="Boolean"  
+                    algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15" />  
+                </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</wsDualHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。|  
+|clientBaseAddress|サービスからの応答メッセージをクライアントがリッスンするベース アドレスを設定する URI。  指定されている場合は、このアドレス \(およびチャネルごとの GUID\) がリッスンに使用されます。  値が指定されていない場合は、クライアント ベース アドレスは、トランスポートに固有の方法で生成されます。  既定値は、`null` です。|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|messageEncoding|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br />-   既定値は Text です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useDefaultWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|textEncoding|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|useDefaultWebProxy|システムの自動設定 HTTP プロキシを使用するかどうかを示すブール値。  この属性が `true` の場合、プロキシ アドレスを `null` \(つまり、設定しない\) にする必要があります。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsdualhttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSDualHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ `WSDualHttpBinding` は、`WSHttpBinding` と同じ Web サービス プロトコルをサポートしますが、双方向コントラクトでの使用を想定しています。  `WSDualHttpBinding` は SOAP セキュリティのみをサポートし、信頼できるメッセージングを要求します。  このバインディングでは、クライアントが、サービスのコールバック エンドポイントを提供するパブリック URI を保持していることが必要です。  これは `clientBaseAddress` 属性によって提供されます。  二重バインディングでは、クライアントの IP アドレスをサービスに公開します。  クライアントは、セキュリティを使用して信頼するサービスに対して接続のみを可能にする必要があります。  
+  
+ このバインディングは、1 つ以上の SOAP 中継局を通じて信頼できる方法で通信するために使用できます。  
+  
+ 既定では、このバインディングは、信頼のための WS\-ReliableMessaging、メッセージ セキュリティと認証用 WS\-Security、メッセージ配信用 HTTP、および Text\/XML メッセージ エンコーディングを持つランタイム スタックを生成します。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+<bindings>  
+<wsDualHttpBinding>  
+    <binding   
+        closeTimeout="00:00:10"  
+        openTimeout="00:00:20"   
+        receiveTimeout="00:00:30"  
+        sendTimeout="00:00:40"  
+        bypassProxyOnLocal="false"   
+        clientBaseAddress="http://localhost:8001/client/"  
+        transactionFlow="true"   
+        hostNameComparisonMode="WeakWildcard"  
+        maxReceivedMessageSize="1000"  
+        messageEncoding="Mtom"   
+        proxyAddress="http://foo/bar"   
+        textEncoding="utf-16"  
+        useDefaultWebProxy="false">  
+        <reliableSession ordered="false"  
+            inactivityTimeout="00:02:00" />  
+        <security mode="None">  
+            <message clientCredentialType="None"  
+                negotiateServiceCredential="false"  
+                algorithmSuite="Aes128" />  
+        </security>  
+    </binding>  
+</wsDualHttpBinding>  
+</bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.WSDualHttpBinding>   
+ <xref:System.ServiceModel.Configuration.WSDualHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md
new file mode 100644
index 00000000000..f73d4b380ac
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md
@@ -0,0 +1,208 @@
+---
+title: "&lt;wsFederationHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "wsFederationBinding 要素"
+ms.assetid: 9c3312b4-2137-4e71-bf3f-de1cf8e9be79
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# &lt;wsFederationHttpBinding&gt;
+WS\-Federation をサポートするバインディングを定義します。  
+  
+## 構文  
+  
+```  
+  
+<wsFederationHttpBinding>  
+    <binding   
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"   
+        hostNameComparisonMode="StrongWildcard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="integer"  
+        messageEncoding="Text/Mtom"   
+                name="string"  
+        openTimeout="TimeSpan"   
+        privacyNoticeAt="Uri"  
+        privacyNoticeVersion="Integer"  
+        proxyAddress="Uri"   
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+        textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/ Utf8TextEncoding"  
+        transactionFlow="Boolean"  
+        useDefaultWebProxy="Boolean">  
+        <security mode="None/Message/TransportWithMessageCredential">  
+         <message   
+            algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+            issuedTokenType="string"   
+            issuedKeyType="SymmetricKey/PublicKey"  
+            negotiateServiceCredential="Boolean" >  
+            <claimTypeRequirements>  
+               <add claimType="URI"  
+                    isOptional="Boolean" />  
+            </claimTypeRequirements>  
+                        <issuer address="Uri" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+                          </headers>  
+                              <identity>  
+                                 <certificate encodedValue="String"/>  
+                                <certificateReference findValue="String"   
+                                 isChainIncluded="Boolean"  
+                            storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                                  storeLocation="LocalMachine/CurrentUser"  
+                                   X509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                                   <dns value="String"/>  
+                                <rsa value="String"/>  
+                                <servicePrincipalName value="String"/>  
+                                <usePrincipalName value="String"/>  
+                              </identity>  
+                        </issuer>  
+                        <issuerMetadata address=String" >  
+               <headers>  
+                  <add name="String"  
+                       namespace="String" />  
+               </headers>  
+               <identity>  
+                  <certificate encodedValue="String"/>  
+                  <certificateReference findValue="String"   
+                     isChainIncluded="Boolean"  
+                     storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"  
+                     storeLocation="LocalMachine/CurrentUser"  
+                     x509FindType=System.Security.Cryptography.X509certificates.X509findtype/>  
+                  <dns value="String"/>  
+                  <rsa value="String"/>  
+                  <servicePrincipalName value="String"/>  
+                  <usePrincipalName value="String"/>  
+               </identity>  
+                        </issuerMetadata>  
+            <tokenRequestParameters>  
+               <xmlElement>  
+               </xmlElement>  
+            </tokenRequestParameters>  
+           </message>  
+        </security>  
+        <reliableSession ordered="Boolean"  
+           inactivityTimeout="TimeSpan"  
+           enabled="Boolean" />  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</wsFederationBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|messageEncoding|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br /><br /> 既定値は Text です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|privactyNoticeAt|プライバシーに関する声明の場所を示す URI を指定する文字列。|  
+|privactyNoticeVersion|現在のプライバシーに関する声明のバージョンを指定する整数。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useDefaultWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:10:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|textEncoding|バインディングでメッセージの発行に使用される文字セット エンコーディングを設定します。  以下の値が有効です。<br /><br /> -   BigEndianUnicode: Unicode BigEndian エンコーディング。<br />-   Unicode: 16 ビット エンコーディング。<br />-   UTF8: 8 ビット エンコーディング。<br /><br /> 既定値は UTF8 です。  この属性は <xref:System.Text.Encoding> 型です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|useDefaultWebProxy|システムの自動設定 HTTP プロキシを使用するかどうかを示すブール値。  この属性が `true` の場合、プロキシ アドレスを `null` \(つまり、設定しない\) にする必要があります。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md)|メッセージのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSFederationHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ フェデレーションは、複数のシステム間で認証と承認用の ID を共有する機能です。  これらの ID は、ユーザーまたはコンピューターを参照できます。  フェデレーション HTTP は、SOAP セキュリティと混合モード セキュリティをサポートしますが、トランスポート セキュリティの単独使用はサポートしません。  このバインドは、WS\-Federation プロトコルに対して [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サポートを提供します。  このバインディングで構成されたサービスは、HTTP トランスポートを使用する必要があります。  
+  
+ バインドは、バインド要素のスタックで構成されます。  
+  
+ `wsFederationHttpBinding` のバインディング要素のスタックは、`wsHttpBinding`  
+  
+ に含まれるスタックと同じです \([\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md) が既定値の <xref:System.ServiceModel.WSFederationHttpSecurityMode> に設定されている場合\)。  
+  
+ `wsFederationHttpBinding` は、[\<message\>](../../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-wsfederationhttpbinding.md) のメッセージ セキュリティ設定の詳細を制御します。  いったんバインディングが作成されると、そのバインディングで使用されるセキュリティは変更できなくなるため、[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md) 要素では get アクセスしか提供されないことに注意してください。  
+  
+ `wsFederationHttpBinding` は、プライバシーに関する声明の場所を示す URI の設定と取得を行う privactyNoticeAt 属性も提供します。  
+  
+ ポリシーをセキュリティで保護することが、フェデレーション シナリオでは特に重要です。  ポリシーを悪意のあるユーザーから保護するには、HTTPS などのセキュリティ形式の使用をお勧めします。  
+  
+ フェデレーション シナリオでこのバインディングを使用する場合は、発行済み \(SAML\) トークンの暗号化に使用するキー、トークンに入れるクレームの種類などの重要情報がサービス ポリシーに含まれる可能性があります。  これが改ざんされると、攻撃者は発行済みトークンのキーを発見してさらに改ざんを行ったり、情報を暴露したりなどの悪意ある行動を取る可能性があります。  このような行為を防ぐには、\(HTTPS などを使用して\) ポリシーをセキュリティで保護し、サービスから安全に取得する必要があります。  
+  
+ このバインディングの詳細については、「[方法 : WSFederationHttpBinding を作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)」を参照してください。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+<system.ServiceModel>  
+<bindings>  
+<wsFederationHttpBinding>  
+    <binding   
+        bypassProxyOnLocal="false"  
+        transactionFlow="false"  
+        hostNameComparisonMode="WeakWildcard"  
+        maxReceivedMessageSize="1000"  
+        messageEncoding="Mtom"   
+        proxyAddress="http://foo/bar"   
+        textEncoding="Utf16TextEncoding"  
+        useDefaultWebProxy="false">  
+        <reliableSession ordered="false"  
+            inactivityTimeout="00:02:00" enabled="true" />  
+        <security mode="None">  
+           <message negotiateServiceCredential="false"  
+                algorithmSuite="Aes128"  
+                issuedTokenType="saml"   
+                issuedKeyType="PublicKey">  
+               <issuer address="http://localhost/Sts" />  
+           </message>  
+        </security>  
+    </binding>  
+</wsFederationBinding>  
+</bindings>  
+</system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.WSFederationHttpBinding>   
+ <xref:System.ServiceModel.Configuration.WSFederationHttpBindingElement>   
+ [方法 : WSFederationHttpBinding を作成する](../../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md b/docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md
new file mode 100644
index 00000000000..d8d28c08352
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md
@@ -0,0 +1,156 @@
+---
+title: "&lt;wsHttpBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "wsHttpBinding 要素"
+ms.assetid: 0eee8ced-ad68-427d-b95a-97260e98deed
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# &lt;wsHttpBinding&gt;
+双方向サービス コントラクト以外に適した、安全で信頼のおける相互操作可能なバインディングを定義します。  バインディングは、信頼のための WS\-ReliableMessaging、およびメッセージのセキュリティと認証のための WS\-Security を実装します。  トランスポートは HTTP、メッセージ エンコーディングは Text\/XML エンコーディングです。  
+  
+## 構文  
+  
+```  
+  
+<wsHttpBinding>  
+    <binding   
+        allowCookies="Boolean"  
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"  
+        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="Integer"  
+        messageEncoding="Text/Mtom"   
+                name="string"  
+        openTimeout="TimeSpan"   
+        proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+                textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+        transactionFlow="Boolean"  
+        useDefaultWebProxy="Boolean">  
+        <reliableSession ordered="Boolean"  
+           inactivityTimeout="TimeSpan"  
+           enabled="Boolean" />  
+        <security mode="Message/None/Transport/TransportWithCredential">  
+           <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                realm="string" />  
+          <message   
+             algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+                          clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+             establishSecurityContext="Boolean"  
+             negotiateServiceCredential="Boolean" />  
+        </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</wsHttpBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowCookies|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は false です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|messageEncoding|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br />-   既定値は Text です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|textEncoding|バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。  以下の値が有効です。<br /><br /> -   UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング。<br />-   Utf16TextEncoding: 16 ビットのエンコーディング。<br />-   Utf8TextEncoding: 8 ビットのエンコーディング。<br /><br /> 既定値は Utf8TextEncoding です。<br /><br /> この属性は <xref:System.Text.Encoding> 型です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|useDefaultWebProxy|システムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 解説  
+ `WSHttpBinding` は `BasicHttpBinding` に似ていますが、より多くの Web サービス機能を提供します。  BasicHttpBinding と同じように HTTP トランスポートを使用し、メッセージ セキュリティを提供します。さらに、トランザクション、信頼できるメッセージング、および WS\-Addressing も提供します。これらは、既定で有効化になっているか、または単一の制御設定で使用できるようになります。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+    <system.ServiceModel>  
+        <bindings>  
+            <wsHttpBinding>  
+                <binding   
+                    closeTimeout="00:00:10"  
+                    openTimeout="00:00:20"   
+                    receiveTimeout="00:00:30"  
+                    sendTimeout="00:00:40"  
+                    bypassProxyOnLocal="false"  
+                    transactionFlow="false"   
+                    hostNameComparisonMode="WeakWildcard"  
+                    maxReceivedMessageSize="1000"  
+                    messageEncoding="Mtom"   
+                    proxyAddress="http://foo/bar"  
+                    textEncoding="utf-16"  
+                    useDefaultWebProxy="false">  
+                    <reliableSession ordered="false"  
+                         inactivityTimeout="00:02:00"  
+                         enabled="true" />  
+                    <security mode="Transport">  
+                         <transport clientCredentialType="Digest"  
+                            proxyCredentialType="None"  
+                            realm="someRealm" />  
+                         <message clientCredentialType="Windows"  
+                            negotiateServiceCredential="false"  
+                            algorithmSuite="Aes128"   
+                            defaultProtectionLevel="None" />  
+                    </security>  
+                </binding>  
+           </wsHttpBinding>  
+        </bindings>  
+    </system.ServiceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.WSHttpBinding>   
+ <xref:System.ServiceModel.Configuration.WSHttpBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/wshttpcontextbinding.md b/docs/framework/configure-apps/file-schema/wcf/wshttpcontextbinding.md
new file mode 100644
index 00000000000..7da3e2a225f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/wshttpcontextbinding.md
@@ -0,0 +1,117 @@
+---
+title: "&lt;wsHttpContextBinding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e40b5c9-0df2-4d66-afc5-a99d0e4ae7a4
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# &lt;wsHttpContextBinding&gt;
+保護レベルの署名を要求する <xref:System.ServiceModel.WsHttpBinding> のコンテキストを提供します。  
+  
+## 構文  
+  
+```  
+  
+<wsHttpContextBinding>  
+    <binding   
+        allowCookies="Boolean"  
+        bypassProxyOnLocal="Boolean"  
+        closeTimeout="TimeSpan"  
+          contextProtectionLevel="EncryptAndSign/None/Sign"  
+        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"  
+        maxBufferPoolSize="integer"  
+        maxReceivedMessageSize="Integer"  
+        messageEncoding="Text/Mtom"   
+                name="string"  
+        openTimeout="TimeSpan"   
+        proxyAddress="URI"  
+        receiveTimeout="TimeSpan"  
+        sendTimeout="TimeSpan"  
+  
+textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"  
+        transactionFlow="Boolean"  
+        useDefaultWebProxy="Boolean">  
+        <reliableSession ordered="Boolean"  
+           inactivityTimeout="TimeSpan"  
+           enabled="Boolean" />  
+        <security mode="Message/None/Transport/TransportWithCredential">  
+           <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                proxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                realm="string"   
+                defaultClientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"  
+                defaultProxyCredentialType="Basic/Digest/None/Ntlm/Windows"  
+                defaultRealm="string" />  
+          <message clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"  
+                      algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"  
+           establishSecurityContext="Boolean"   
+           negotiateServiceCredential="Boolean"/>  
+        </security>  
+       <readerQuotas   
+            maxArrayLength="Integer"  
+            maxBytesPerRead="Integer"  
+            maxDepth="Integer"   
+            maxNameTableCharCount="Integer"           
+            maxStringContentLength="Integer" />  
+    </binding>  
+</wsHttpContextBinding>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowCookies|クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。  既定値は、`false` です。<br /><br /> `allowCookies` が `true` に設定されると、contextChannel は httpCookies をコンテキストの交換モードとして使用します。  この属性が `false` に設定されると、コンテキストは、SOAP ヘッダーとして交換されます。<br /><br /> 既定値は `false` です。<br /><br /> クッキーを使用する ASMX Web サービスと対話する場合にこのプロパティを使用できます。  この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。|  
+|bypassProxyOnLocal|ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。  既定値は、`false` です。|  
+|closeTimeout|クローズ操作が完了するまでの期間を指定する <xref:System.TimeSpan> 値。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|contextProtectionLevel|コンテキスト情報の反映に使用される SOAP ヘッダーの必要な保護レベルを指定する、有効な <xref:System.Net.Security.ProtectionLevel> 値。  既定値は `Sign` です。|  
+|hostnameComparisonMode|URI の解析に使用する HTTP ホスト名比較モードを指定します。  この属性は <xref:System.ServiceModel.HostnameComparisonMode> 型で、URI が一致したときにサービスへのアクセスにホスト名を使用するかどうかを指定します。  既定値は <xref:System.ServiceModel.HostnameComparisonMode.StrongWildcard> で、一致しているホスト名を無視します。|  
+|maxBufferPoolSize|このバインディングに使用するバッファー プール サイズの上限を指定する整数。  既定は 524,288 バイト \(512 \* 1024\) です。  Windows Communication Foundation \(WCF\) では、多くの部分でバッファーを使用します。  使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。  バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。  これで、バッファーの作成と破棄のオーバーヘッドを回避できます。|  
+|maxReceivedMessageSize|このバインディングで構成されるチャネルで受信可能な最大メッセージ サイズ \(ヘッダーを含む\) をバイト単位で指定する正の整数。  この制限を超えるメッセージの送信者が、SOAP エラーを受信します。  メッセージは受信者によって破棄され、トレース ログにこのイベントのエントリが作成されます。  既定値は 65536 です。|  
+|messageEncoding|メッセージのエンコードに使用されるエンコーダーを定義します。  以下の値が有効です。<br /><br /> -   Text: テキスト メッセージのエンコーダーを使用します。<br />-   Mtom: Message Transmission Organization Mechanism 1.0 \(MTOM\) エンコーダーを使用します。<br />-   既定値は Text です。<br /><br /> この属性は <xref:System.ServiceModel.WSMessageEncoding> 型です。|  
+|name|バインディングの構成名を格納する文字列です。  この値は、バインディングの ID として使用されるため、一意にする必要があります。  [!INCLUDE[netfx40_short](../../../../../includes/netfx40-short-md.md)] 以降では、バインディングおよび動作に名前を付ける必要はありません。  既定の構成、および名前のないバインディングと動作の詳細については、「[簡略化された構成](../../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。|  
+|openTimeout|実行中の操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|proxyAddress|HTTP プロキシのアドレスを指定する URI。  `useSystemWebProxy` が `true` の場合、この設定を `null` にする必要があります。  既定値は、`null` です。|  
+|receiveTimeout|受信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|sendTimeout|送信操作が完了するまでの時間間隔を指定する <xref:System.TimeSpan> 値です。  この値は必ず <xref:System.TimeSpan.Zero> 以上である必要があります。  既定値は 00:01:00 です。|  
+|textEncoding|バインドでメッセージの発行に使用される文字セット エンコーディングを指定します。  以下の値が有効です。<br /><br /> -   UnicodeFffeTextEncoding: Unicode BigEndian エンコーディング。<br />-   Utf16TextEncoding: 16 ビットのエンコーディング。<br />-   Utf8TextEncoding: 8 ビットのエンコーディング。<br /><br /> 既定値は Utf8TextEncoding です。<br /><br /> この属性は <xref:System.Text.Encoding> 型です。|  
+|transactionFlow|バインディングが WS\-Transactions のフローをサポートするかどうかを指定するブール値です。  既定値は、`false` です。|  
+|useDefaultWebProxy|システムの自動設定 HTTP プロキシを使用するかどうかを指定するブール値。  既定値は、`true` です。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<security\>](../../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)|バインディングのセキュリティ設定を定義します。  この要素は <xref:System.ServiceModel.Configuration.WSHttpSecurityElement> 型です。|  
+|[\<readerQuotas\>](../Topic/%3CreaderQuotas%3E.md)|このバインドを使用して設定されるエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を定義します。  この要素は <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement> 型です。|  
+|[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b)|チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bindings\>](../../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)|この要素には、標準バインディングおよびカスタム バインディングのコレクションが保持されます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.WSHttpBinding>   
+ <xref:System.ServiceModel.WSHttpContextBinding>   
+ <xref:System.ServiceModel.Configuration.wsHttpContextBindingElement>   
+ <xref:System.ServiceModel.Channels.ContextBindingElement>   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)   
+ [システムが提供するバインディングの構成](../../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)   
+ [\<binding\>](../../../../../docs/framework/misc/binding.md)   
+ [\<wsHttpBinding\>](../../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/wcf/xmlelement.md b/docs/framework/configure-apps/file-schema/wcf/xmlelement.md
new file mode 100644
index 00000000000..2b076035c1d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/wcf/xmlelement.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;xmlElement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 395205c2-d8c0-4a5e-90f3-7ce3c085fccd
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;xmlElement&gt;
+トークンの要求時にセキュリティ トークン サービスへのメッセージ本文で送信される XML 要素を指定します。  
+  
+## 構文  
+  
+```  
+  
+<tokenRequestParameters>  
+      <xmlElement xmlElement="String" />  
+</tokenRequestParameters>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|xmlElement|トークンの要求時にセキュリティ トークン サービスへのメッセージ本文で送信される XML 要素を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<tokenRequestParameters\>](../../../../../docs/framework/configure-apps/file-schema/wcf/tokenrequestparameters.md)|トークン要求パラメーターのコレクション。  各パラメーターは、XML 要素です。|  
+  
+## 参照  
+ <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.TokenRequestParameters%2A>   
+ <xref:System.ServiceModel.Configuration.FederatedMessageSecurityOverHttpElement.TokenRequestParameters%2A>   
+ [サービス ID と認証](../../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [フェデレーションと発行済みトークン](../../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [バインディング](../../../../../docs/framework/wcf/bindings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/web/TOC.md b/docs/framework/configure-apps/file-schema/web/TOC.md
new file mode 100644
index 00000000000..f0c428fe6b8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/web/TOC.md
@@ -0,0 +1,3 @@
+# [Web 設定スキーマ](index.md)
+# [<applicationPool> 要素 (Web 設定)](applicationpool-element-web-settings.md)
+# [<system.web> 要素 (Web 設定)](system-web-element-web-settings.md)
diff --git a/docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md b/docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md
new file mode 100644
index 00000000000..4477bb914fa
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md
@@ -0,0 +1,106 @@
+---
+title: "&lt;applicationPool&gt; 要素 (Web 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<applicationPool> 要素"
+  - "applicationPool 要素"
+ms.assetid: 46d1baaa-e343-4639-b70d-2a43a9f62b2a
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# &lt;applicationPool&gt; 要素 (Web 設定)
+ASP.NET アプリケーションが [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] 以降のバージョンの統合モードで実行されている場合に、プロセス全体の動作を管理するために ASP.NET で使用される構成設定を指定します。  
+  
+> [!IMPORTANT]
+>  この要素と、この要素でサポートされる機能は、ASP.NET アプリケーションが [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] 以降のバージョンでホストされる場合にのみ機能します。  
+  
+## 構文  
+  
+```  
+<applicationPool   
+    maxConcurrentRequestsPerCPU="5000"   
+    maxConcurrentThreadsPerCPU="0"   
+    requestQueueLimit="5000" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|Attribute|説明|  
+|---------------|--------|  
+|`maxConcurrentRequestsPerCPU`|ASP.NET で許可する CPU あたりの同時要求数を指定します。|  
+|`maxConcurrentThreadsPerCPU`|各 CPU のアプリケーション プールで実行できる同時スレッド数を指定します。  これは、要求を処理するために CPU あたりで使用できるマネージ スレッドの数を制限できるため、ASP.NET の同時実行を制御する手段の選択肢となります。  既定の設定は 0 で、この場合、ASP.NET は CPU あたりの作成可能なスレッド数を制限しません。ただし、作成可能なスレッド数には、共通言語ランタイム \(CLR: Common Language Runtime\) のスレッド プールによる制限も適用されます。|  
+|`requestQueueLimit`|単一のプロセスで ASP.NET のキューに配置できる要求の最大数を指定します。  複数の ASP.NET アプリケーションが 1 つのアプリケーション プールで実行される場合、そのアプリケーション プール内のアプリケーションに対する要求の累積数は、この設定によって制限されます。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.web\>](../../../../../docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md)|ASP.NET とホスト アプリケーションの対話方法に関する情報が含まれます。|  
+  
+## 解説  
+ [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] 以降を統合モードで実行する場合は、この要素の組み合わせによって、アプリケーションが IIS アプリケーション プールでホストされているときに ASP.NET でどのようにスレッドを管理し、どのように要求をキューに配置するかを構成できます。  IIS 6 を実行する場合や、[!INCLUDE[iisver](../../../../../includes/iisver-md.md)] をクラシック モードまたは ISAPI モードで実行する場合は、これらの設定は無視されます。  
+  
+ `applicationPool` の設定は、.NET Framework の特定のバージョンで実行されるすべてのアプリケーション プールに適用されます。  この設定は aspnet.config ファイルに含まれています。  .NET Framework の Version 2.0 と 4 には、このファイルの個別のバージョンがあります \(.NET Framework Version 3.0 および 3.5 では、Version 2.0 と aspnet.config ファイルが共有されます\)。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[win7](../../../../../includes/win7-md.md)] で [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] を実行する場合は、アプリケーション プールごとに別々の aspnet.config ファイルを構成できます。  これにより、アプリケーション プールごとにスレッドのパフォーマンスを調整できます。  
+  
+ `maxConcurrentRequestsPerCPU` 設定については、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] での既定の設定は "5000" で、実際に CPU あたりの要求数が 5000 以上にならない限り、ASP.NET によって制御される要求調整は実質的に無効になります。  代わりに、CLR スレッド プールの制限によって、CPU あたりの同時実行が自動的に管理されます。  非同期要求処理を広く利用するアプリケーションや、長時間実行される多数の要求がネットワーク I\/O でブロックされるアプリケーションには、[!INCLUDE[net_v40_short](../../../../../includes/net-v40-short-md.md)] の既定の緩やかな制限が適しています。  `maxConcurrentRequestsPerCPU` を 0 に設定すると、ASP.NET の要求の処理にマネージ スレッドは使用されなくなります。  アプリケーションが IIS アプリケーション プールで実行される場合、要求は IIS I\/O スレッドにとどまるので、同時実行は IIS スレッドの設定によって調整されます。  
+  
+ `requestQueueLimit` の設定は、ASP.NET アプリケーションの Web.config ファイルで設定される [processModel](http://msdn.microsoft.com/ja-jp/4b8fe20e-74c8-4566-b72c-ce5f83c8e32d) 要素の `requestQueueLimit` 属性と同じように機能します。  ただし、aspnet.config ファイルにある `requestQueueLimit` の設定は、Web.config ファイルにある `requestQueueLimit` の設定をオーバーライドします。  つまり、両方の属性を設定した場合 \(既定で両方とも設定されています\)、aspnet.config ファイルにある `requestQueueLimit` の設定が優先されます。  
+  
+## 使用例  
+ 以下の例では、次の環境において aspnet.config ファイルで ASP.NET プロセス全体の動作を構成する方法を示します。  
+  
+-   アプリケーションが [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] アプリケーション プールでホストされている。  
+  
+-   [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] が統合モードで実行されている。  
+  
+-   アプリケーションが [!INCLUDE[net_v35SP1_short](../../../../../includes/net-v35sp1-short-md.md)] 以降を使用している。  
+  
+ この例で指定している値は既定値です。  
+  
+```  
+<configuration>  
+  <system.web>  
+    <applicationPool   
+        maxConcurrentRequestsPerCPU="5000"  
+        maxConcurrentThreadsPerCPU="0"   
+        requestQueueLimit="5000" />  
+  </system.web>  
+</configuration>  
+```  
+  
+## 要素情報  
+  
+|||  
+|-|-|  
+|名前空間||  
+|スキーマ名||  
+|検証ファイル||  
+|空も使用できる||  
+  
+## 参照  
+ [\<system.web\> 要素 \(Web 設定\)](../../../../../docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/web/index.md b/docs/framework/configure-apps/file-schema/web/index.md
new file mode 100644
index 00000000000..9e2394df164
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/web/index.md
@@ -0,0 +1,52 @@
+---
+title: "Web 設定スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ASP.NET 構成システム, Web 設定スキーマ"
+  - "構成ファイル [ASP.NET]"
+  - "構成スキーマ [.NET Framework], [Web 設定]"
+  - "スキーマ Web 設定"
+  - "[Web 設定], スキーマ [ASP.NET]"
+  - "Web.config 構成ファイル [ASP.NET]"
+ms.assetid: ae1ac356-267d-4753-8d7a-7a04eb45a9be
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# Web 設定スキーマ
+Web 設定では、ASP.NET ホスト層で管理されるプロセス全体の動作に適用する、CPU および実行レベルの ASP.NET 設定を指定します。  これらの設定は、ASP.NET アプリケーションの Web.config ファイルで指定されるアプリケーション ドメイン型の設定とは異なります。  
+  
+ Web 設定は、.NET Framework の各バージョンのインストール フォルダーにある Aspnet.config ファイルに含まれています。  たとえば、[!INCLUDE[dnprdnext](../../../../../includes/dnprdnext-md.md)] の Aspnet.config ファイルは、次のフォルダーにあります。  
+  
+ `C:\Windows\Microsoft.NET\Framework\v2.0.50727\`  
+  
+ Web 設定は、machine.config ファイル、ルートの Web.config ファイル、アプリケーション レベルの Web.config ファイルなどのその他の構成ファイルでは使用されません。  
+  
+ [\<configuration\> 要素](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)  
+  
+ [\<system.web\> 要素 \(Web 設定\)](../../../../../docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md)  
+  
+ [\<applicationPool\> 要素 \(Web 設定\)](../../../../../docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md)  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.web\>](../../../../../docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md)|ASP.NET ホスト層で使用される情報が含まれています。|  
+|[\<applicationPool\>](../../../../../docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md)|ASP.NET ホスト層で管理されるプロセス全体の動作に適用する、CPU および実行レベルの ASP.NET 設定を指定します。|  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../../../docs/framework/configure-apps/file-schema/index.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md b/docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md
new file mode 100644
index 00000000000..a006ba3a081
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/web/system-web-element-web-settings.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;system.web&gt; 要素 (Web 設定) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.Web> 要素"
+  - "ASP.NET 構成システム"
+  - "構成ファイル [ASP.NET]"
+  - "system.Web 要素"
+  - "Web.config 構成ファイル [ASP.NET]"
+ms.assetid: 24c4cf4f-ad32-42b2-b040-8e4549e2855e
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# &lt;system.web&gt; 要素 (Web 設定)
+プロセス全体の動作を ASP.NET ホスト層でどのように管理するかについての情報を含みます。  
+  
+## 構文  
+  
+```  
+<system.web>  
+</system.web>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<applicationPool\>](../../../../../docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md)|aspnet.config ファイル内で、IIS アプリケーション プールの構成設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\>](../../../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。|  
+  
+## 解説  
+ `system.web` 要素とその `applicationPool` 子要素は、[!INCLUDE[net_v35SP1_short](../../../../../includes/net-v35sp1-short-md.md)] で [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] に追加されました。  [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] 以降を統合モードで実行する場合、この要素を組み合わせて使用すると、ASP.NET が IIS アプリケーション プールでホストされているときに、ASP.NET でどのようにスレッドを管理し、どのように要求をキューに配置するかを構成できます。  [!INCLUDE[iisver](../../../../../includes/iisver-md.md)] 以降をクラシック モードまたは ISAPI モードで実行する場合、これらの設定は無視されます。  
+  
+## 使用例  
+ 次の例は、ASP.NET が IIS アプリケーション プールでホストされているときの ASP.NET プロセス全体の動作を aspnet.config ファイルで構成する方法を示しています。  この例では、IIS が統合モードで実行されていること、およびアプリケーションが [!INCLUDE[net_v35SP1_short](../../../../../includes/net-v35sp1-short-md.md)] 以降のバージョンを使用していることが前提になります。  この動作は、[!INCLUDE[net_v35SP1_short](../../../../../includes/net-v35sp1-short-md.md)] より前のバージョンの [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] では発生しません。  この例で指定している値は既定値です。  
+  
+```  
+<configuration>  
+  <system.web>  
+    <applicationPool   
+        maxConcurrentRequestsPerCPU="5000"   
+        maxConcurrentThreadsPerCPU="0"   
+        requestQueueLimit="5000" />  
+  </system.web>  
+</configuration>  
+```  
+  
+## 要素情報  
+  
+|||  
+|-|-|  
+|名前空間||  
+|スキーマ名||  
+|検証ファイル||  
+|空も使用できる||  
+  
+## 参照  
+ [\<applicationPool\> 要素 \(Web 設定\)](../../../../../docs/framework/configure-apps/file-schema/web/applicationpool-element-web-settings.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/TOC.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/TOC.md
new file mode 100644
index 00000000000..d49e6d2f463
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/TOC.md
@@ -0,0 +1,37 @@
+# [<system.identityModel.services>](system-identitymodel-services.md)
+# [<issuerTokenResolver>](issuertokenresolver.md)
+# [<securityTokenHandlers>](securitytokenhandlers.md)
+# [<trustedIssuers>](trustedissuers.md)
+# [<sessionSecurityTokenCache>](sessionsecuritytokencache.md)
+# [<claimType>](claimtype.md)
+# [<wsFederation>](wsfederation.md)
+# [<claimTypeRequired>](claimtyperequired.md)
+# [<cookieHandler>](cookiehandler.md)
+# [<x509SecurityTokenHandlerRequirement>](x509securitytokenhandlerrequirement.md)
+# [<tokenReplayDetection>](tokenreplaydetection.md)
+# [<customCookieHandler>](customcookiehandler.md)
+# [<claimsAuthorizationManager>](claimsauthorizationmanager.md)
+# [<federationConfiguration>](federationconfiguration.md)
+# [<certificateValidator>](certificatevalidator.md)
+# [<audienceUris>](audienceuris.md)
+# [<chunkedCookieHandler>](chunkedcookiehandler.md)
+# [<userNameSecurityTokenHandlerRequirement>](usernamesecuritytokenhandlerrequirement.md)
+# [<serviceTokenResolver>](servicetokenresolver.md)
+# [<claimsAuthenticationManager>](claimsauthenticationmanager.md)
+# [<certificateValidation>](certificatevalidation.md)
+# [<roleClaimType>](roleclaimtype.md)
+# [<issuerNameRegistry>](issuernameregistry.md)
+# [<clear>](clear.md)
+# [WIF 構成スキーマ](index.md)
+# [<sessionTokenRequirement>](sessiontokenrequirement.md)
+# [<add>](add.md)
+# [<キャッシュ>](caches.md)
+# [<serviceCertificate>](servicecertificate.md)
+# [<削除>](remove.md)
+# [<certificateReference>](certificatereference.md)
+# [<securityTokenHandlerConfiguration>](securitytokenhandlerconfiguration.md)
+# [<system.identityModel>](system-identitymodel.md)
+# [<identityConfiguration>](identityconfiguration.md)
+# [<nameClaimType>](nameclaimtype.md)
+# [<tokenReplayCache>](tokenreplaycache.md)
+# [<samlSecurityTokenRequirement>](samlsecuritytokenrequirement.md)
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md
new file mode 100644
index 00000000000..f82bc967357
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4712a888-f154-4395-8887-ef14a88a6497
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;add&gt;
+指定されたセキュリティ トークン ハンドラーをトークン ハンドラー コレクションに追加します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add type=xs:string>  
+        <optionalConfigurationElement>  
+        </optionalConfigurationElement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|追加すると、トークン ハンドラーの CLR 型名。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](http://msdn.microsoft.com/ja-jp/7286d2e3-c63d-49fd-abdc-ce2705f22c24)。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<samlSecurityTokenRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md)|構成を提供、 <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler>クラスは、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>クラス、または派生クラスのこれらのクラスのいずれか。|  
+|[\<sessionTokenRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/sessiontokenrequirement.md)|構成を提供、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>クラスまたは派生クラス。|  
+|[\<userNameSecurityTokenHandlerRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/usernamesecuritytokenhandlerrequirement.md)|構成を提供、 <xref:System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler>クラスまたは派生クラス。|  
+|[\<x509SecurityTokenHandlerRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/x509securitytokenhandlerrequirement.md)|オプションの構成を提供、 <xref:System.IdentityModel.Tokens.X509SecurityTokenHandler>クラスまたは派生クラス。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md)|エンドポイントには登録されているセキュリティ トークン ハンドラーのコレクションを指定します。|  
+  
+## 解説  
+ `<add>`要素は、トークン ハンドラーの設定を指定します。 単一の子要素を取ることができます。  これかどうか、ハンドラー クラスを通じて参照に依存している、 `type`属性の`<add>`要素はこの機能のサポートを提供します。  この機能を提供するトークン ハンドラー クラスを受け取るコンス トラクターを公開する必要があります、 <xref:System.Xml.XmlElement>オブジェクト。  
+  
+```  
+public class CustomTokenHandler : Microsoft.IdentityModel.Tokens.SecurityTokenHandler  
+{  
+    public CustomTokenHandler( XmlElement customConfig )  
+    {  
+    }  
+}  
+```  
+  
+ この機能が組み込まれているセキュリティ トークン ハンドラー クラスのいくつかを。  These classes are <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler>, <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>, <xref:System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler>, <xref:System.IdentityModel.Tokens.X509SecurityTokenHandler>, and <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>.  
+  
+> [!IMPORTANT]
+>  トークン ハンドラーのコレクションは、指定された型の 1 つのハンドラーを含めることができます。  派生するハンドラーを追加する場合は、たとえば、つまり、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>クラス、コレクションには、まず削除する必要があります、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>、です、コレクションから既定で存在します。  使用できます、 [\<削除\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/remove.md)要素は、コレクションの使用を 1 つのハンドラーを削除するには、 [\<clear\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/clear.md)要素は、コレクションからすべてのイベント ハンドラーを削除します。  
+  
+ ハンドラーで指定した設定をオーバーライドで、トークン ハンドラーのコレクションで指定された同等の設定に[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)要素とは、サービス レベルで指定されている、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素。  
+  
+## 使用例  
+ 次の XML の使用を示しています、 `<add>`と`<remove>`カスタム セッション トークン ハンドラーが既定のセッション トークン ハンドラーを置換する要素。  XML から取得されます、 `ClaimsAwareWebFarm`サンプル。  
+  
+```  
+<securityTokenHandlers>  
+  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+</securityTokenHandlers>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/audienceuris.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/audienceuris.md
new file mode 100644
index 00000000000..0a9044a8994
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/audienceuris.md
@@ -0,0 +1,77 @@
+---
+title: "&lt;audienceUris&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a3d8515-d756-4afe-a22d-07cbe2217ee3
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# &lt;audienceUris&gt;
+依存元の相手 \(RP\) の許容可能な識別子は Uri のセットを指定します。  トークンが許可されている対象ユーザーの Uri のいずれかのスコープでない限り許可されません。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration>  
+        <audienceUris mode=xs:string>  
+          <add value=xs:string />  
+          <clear />  
+          <remove value=xs:string />  
+        </audienceUris>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|mode|<xref:System.IdentityModel.Selectors.AudienceUriMode> 、対象者の制限が、受信したトークンに適用かどうかを示す値。  使用可能な値は、「は、」"Never"、および"BearerKeyOnly"です。  既定値は「常に」です。  省略可能です。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|`<add value=xs:string>`|指定した URI を追加、 `value`属性、audienceUris コレクションに。  `value` 属性は必須です。  URI は、大文字小文字を区別です。|  
+|`<clear>`|AudienceUris のコレクションを消去します。  すべての識別子は、コレクションから削除されます。|  
+|`<remove value=xs:string>`|指定した URI を削除、 `value` audienceUris コレクションから属性をします。  `value` 属性は必須です。  URI は、大文字小文字を区別です。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成コレクションのセキュリティ トークン ハンドラーを提供します。|  
+  
+## 解説  
+ 既定では、コレクションは空です。 使用`<add>`、 `<clear>`、および`<remove>`要素は、コレクションを変更します。  <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler><xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>オブジェクトの値を構成するのには、対象の URI のコレクションでは、URI の制限で視聴者を許可されて使用<xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement>オブジェクト。  
+  
+ `<audienceUris>`要素で表される、 <xref:System.IdentityModel.Configuration.AudienceUriElementCollection>クラス。  コレクションに追加する個々 の URI が表され、 <xref:System.IdentityModel.Configuration.AudienceUriElement>クラス。  
+  
+> [!NOTE]
+>  使用、 `<audienceUris>`要素の子要素として、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素は推奨されていませんが、旧バージョンとの互換性のためのサポートもします。  設定で、 `<securityTokenHandlerConfiguration>`要素無効もに、 `<identityConfiguration>`要素。  
+  
+## 使用例  
+ 次の XML は、アプリケーションを適切な対象ユーザー Uri を構成する方法を示しています。  次の使用例は、単一の URI を設定します。  この URI のスコープのトークンを受け入れられます、他のユーザーはすべて拒否されます。  
+  
+```  
+<audienceUris>  
+  <add value="http://localhost:19851/"/>  
+</audienceUris>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md
new file mode 100644
index 00000000000..72c3a32b7aa
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;キャッシュ&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4651091b-3a20-40d8-b293-4408c0710143
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;キャッシュ&gt;
+セッション トークンをトークンのリプレイ検出を使用して、キャッシュを登録します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <caches>  
+    </caches>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<sessionSecurityTokenCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md)|セッション トークンをキャッシュ サービスとセキュリティ トークン ハンドラーのコレクションを登録します。|  
+|[\<tokenReplayCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md)|サービスまたはセキュリティ トークン ハンドラーのコレクションを再生のトークン キャッシュを登録します。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス ・ レベルの id の設定を指定します。|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成コレクションのセキュリティ トークン ハンドラーを提供します。|  
+  
+## 解説  
+ A `<caches>`要素は、サービス ・ レベルで指定できます、 `<identityConfiguration>`要素またはセキュリティ トークン ハンドラー コレクションのレベルの下に、 `<securityTokenHandlerConfiguration>`要素。  サービスで指定されているコレクションをトークン ハンドラーの設定をオーバーライドします。  
+  
+ `<caches>`要素で表される、 <xref:System.IdentityModel.Configuration.IdentityModelCachesElement>クラス。  構成済みキャッシュによって表される、 <xref:System.IdentityModel.Configuration.IdentityModelCaches>クラス。  
+  
+## 使用例  
+ 次の XML は、セッションのセキュリティ トークンを保持して、カスタム キャッシュの構成を示しています \(<xref:System.IdentityModel.Tokens.SessionSecurityToken>\)。  構成から取得されます、 `ClaimsAwareWebFarm`サンプル。  
+  
+```  
+<caches>  
+  <sessionSecurityTokenCache type="CacheLibrary.SharedSessionSecurityTokenCache, CacheLibrary">  
+    <!--cacheServiceAddress points to the centralized session security token cache service running in the web farm.-->  
+    <cacheServiceAddress url="http://localhost:4161/SessionSecurityTokenCacheService.svc" />  
+  </sessionSecurityTokenCache>  
+</caches>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatereference.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatereference.md
new file mode 100644
index 00000000000..ae38248f958
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatereference.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;certificateReference&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2ac8bc14-e9f1-48fb-b662-f5991558fbe4
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;certificateReference&gt;
+検索して、証明書ストアの X.509 証明書を検証するために使用する設定を指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <serviceCertificate>  
+      <certificateReference   
+        storeName=”AddressBook||AuthRoot||CertificateAuthority||Disallowed||My||Root||TrustedPeople||TrustedPublisher”  
+        storeLocation=”CurrentUser||LocalMachine”  
+        x509FindType="FindByThumbprint||FindBySubjectName||FindBySubjectDistinguishedName||FindByIssuerName||FindByIssuerDistinguishedName||FindBySerialNumber||FindByTimeValid||FindByTimeNotYetValid||FindByTimeExpired||FindByTemplateName||FindByApplicationPolicy||FindByCertificatePolicy||FindByExtension||FindByKeyUsage||FindBySubjectKeyIdentifier"  
+        findValue=xs:String  
+        isChainIncluded=xs:Boolean >  
+      </certificateReference>  
+    </serviceCertificate>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|storeName|X.509 証明書ストアの名前。  既定値は「私」。  省略可能です。|  
+|storeLocation|A <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 、X.509 証明書ストアの場所を指定する値。  既定値は、"LocalMachine"です。  省略可能です。|  
+|x509FindType|<xref:System.Security.Cryptography.X509Certificates.X509FindType> 、実行する検索の種類を指定する値。  既定値は"FindBySubjectDistinguishedName"です。  省略可能です。|  
+|findValue|X.509 証明書ストアで検索する値。  省略可能です。|  
+|isChainIncluded|証明書チェーンを使用して検証を実行するかどうかを指定します。  既定値は"true;"です。 検証は、証明書チェーンを使用して実行されます。  省略可能です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/servicecertificate.md)|暗号化し、トークンを復号化するために使用する証明書を構成します。|  
+  
+## 解説  
+ `<certificateReference>`要素を探し、証明書ストアの X.509 証明書を検証するために使用する設定を指定します。  子要素として指定されると、 `<serviceCertficate>`要素は、場所と検証の設定を暗号化し、トークンを復号化に使用される X.509 証明書の指定します。  `<certificateReference>`要素で表される、 <xref:System.ServiceModel.Configuration.CertificateReferenceElement>クラス。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md
new file mode 100644
index 00000000000..1dfa28fea0d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;certificateValidation&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c54c704-b55e-4631-88ff-4d4a5621554c
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;certificateValidation&gt;
+証明書を検証するためにトークン ハンドラーが使用する設定を制御します。  これらの設定は固有のハンドラーが独自の検証コントロールで構成されている場合はオーバーライドされます。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <certificateValidation  
+      certificateValidationMode="None||ChainTrust||PeerTrust||PeerOrChainTrust||Custom"  
+      revocationMode="NoCheck||Offline||Online"  
+      trustedStoreLocation="CurrentLocation||LocalMachine" >  
+    </certificateValidation>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|certificateValidationMode|X.509 証明書に使用する有効性認証モードを指定する <xref:System.ServiceModel.Security.X509CertificateValidationMode> 値。  既定値は 「PeerOrChainTrust」です。  カスタム検証を指定するには、このカスタム属性を 「」に設定し、要素を使用して検証コントロールを [\<certificateValidator\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidator.md) 指定します。  省略可能です。|  
+|revocationMode|X.509 証明書に使用する失効モードを指定する <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 値。  既定値は 「オンライン」です。  省略可能です。|  
+|trustedStoreLocation|X.509 証明書ストアを指定する <xref:System.Security.Cryptography.X509Certificates.StoreLocation> 値。  既定値は 「LocalMachine」です。  省略可能です。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<certificateValidator\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidator.md)|証明書検証するためのカスタム型を指定します。  この型は、要素の `certificateValidationMode` のカスタム [\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md) 属性を 「」に設定されている場合のみ使用できます。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス レベルの ID の設定を指定します。|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|セキュリティ トークン ハンドラーの収集の構成を提供します。|  
+  
+## 解説  
+ `<certificateValidation>` の要素は `<identityConfiguration>` 要素の下のまたは `<securityTokenHandlerConfiguration>` 要素の下のセキュリティ トークン ハンドラー コレクション レベル サービス レベルで指定できます。  サービスで指定されたトークン ハンドラー コレクションの設定によってオーバーライドされます。  一部のトークン ハンドラーは構成で証明書検証設定を指定できるようにします。  個別のトークン ハンドラーの設定はサービス レベルでセキュリティ トークン ハンドラー コレクションで指定されたオーバーライドします。  
+  
+## 使用例  
+  
+```  
+<certificateValidation certificateValidationMode="PeerOrChainTrust"  
+                       revocationMode="Online"  
+                       trustedStoreLocation="LocalMachine" />  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidator.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidator.md
new file mode 100644
index 00000000000..0c162f25291
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidator.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;certificateValidator&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 86161897-c20f-4ad8-9d7f-050c247251bf
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;certificateValidator&gt;
+カスタムの種類の証明書の検証を指定します。  この種類は、場合にのみ使用されます、 `certificateValidationMode`属性の[\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md)要素が「カスタム」に設定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <certificateValidation>  
+      <certificateValidator type=xs:string>  
+      </certificateValidator>  
+    </certificateValidation>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生するカスタム型を指定します、 <xref:System.IdentityModel.Selectors.X509CertificateValidator>クラス。  設定、 `certificateValidationMode`属性、 [\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md)要素には、\[カスタム\] この型を使用します。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。  省略可能です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md)|証明書を検証するトークン ハンドラーを使用する設定を制御します。|  
+  
+## 使用例  
+  
+```  
+<certificateValidation certificateValidationMode="Custom"  
+                       revocationMode="Online"  
+                       trustedStoreLocation="LocalMachine">  
+    <certificateValidator type="MyNamespace.CustomValidator, MyAssembly" />    
+</certificateValidation>        
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/chunkedcookiehandler.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/chunkedcookiehandler.md
new file mode 100644
index 00000000000..7e2d9d7462e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/chunkedcookiehandler.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;chunkedCookieHandler&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7220de45-1d14-4aec-a29e-4a2ea8ac861f
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;chunkedCookieHandler&gt;
+構成、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>。  この要素のみが表示される場合、 `mode`属性の`<cookieHandler>` "Default"または「チャンク」です。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <cookieHandler mode="Chunked||Default" >  
+      <chunkedCookieHandler size=xs:int >  
+      </chunkedCookieHandler>  
+    </cookieHandler>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|chunkSize|文字数を 1 つの HTTP cookie を HTTP cookie データの最大サイズです。  チャンクのサイズを調整する場合は慎重に行ってください。  Web ブラウザー cookie およびドメインごとに許可される数のサイズに異なる制限をあります。  これらの制限は、元の Netscape 仕様規定をされて: 300 cookie の合計、4096 バイト \(cookie 値だけでなくすべてのメタデータを含む\)、cookie ヘッダーごとおよびドメインごとの 20 の cookie。  既定値は 2000 です。  必ず指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<cookieHandler\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md)|構成、 <xref:System.IdentityModel.Services.CookieHandler>は、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\) を使用して cookie を読み書きします。|  
+  
+## 解説  
+ 指定すると、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>設定、 `mode`属性の`<cookieHandler>`要素には、"Default"または「チャンク」などで cookie の読み書きに cookie のハンドラーを使用して、チャンク サイズを指定することができます、 `<chunkedCookieHandler>`子要素および設定、 `chunkSize`属性。  場合は、 `<chunkedCookieHandler>`要素が存在しない、既定のチャンク サイズは 2000 バイトが使用されます。  この要素にすることはできませんが指定されて、 `mode`属性が「カスタム」に設定します。  
+  
+ `<chunkedCookieHandler>`要素で表される、 <xref:System.IdentityModel.Services.ChunkedCookieHandlerElement>クラス。  
+  
+## 使用例  
+ 次の例では、cookie を 3000 バイトのチャンク単位で書き込むチャンク cookie ハンドラーを構成します。  
+  
+```  
+<cookieHandler mode="Chunked">  
+    <chunkedCookieHandler chunkSize=3000/>  
+</cookieHandler>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.ChunkedCookieHandler>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthenticationmanager.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthenticationmanager.md
new file mode 100644
index 00000000000..2e4f86c3931
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthenticationmanager.md
@@ -0,0 +1,64 @@
+---
+title: "&lt;claimsAuthenticationManager&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d30a450-6d13-4671-81a8-77e0204500c5
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;claimsAuthenticationManager&gt;
+入力受取所の要求認証マネージャーを登録します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <claimsAuthenticationManager type=xs:string>  
+      <optionalConfigurationElements />  
+    </claimsAuthenticationManager>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|<xref:System.Security.Claims.ClaimsAuthenticationManager> のクラスから派生したカスタム型を指定します。  `type` の属性を指定する方法の詳細については、 " " を参照してください。 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferencess)|  
+  
+### 子要素  
+ `type` の属性がない場合、または `type` の属性参照 <xref:System.Security.Claims.ClaimsAuthenticationManager> のクラス、 `<claimsAuthenticationManager>` の要素には子要素がありません; ただし、 <xref:System.Security.Claims.ClaimsAuthenticationManager> から派生したクラスは、子構成要素を定義できます。  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス レベルの ID の設定を指定します。|  
+  
+## 解説  
+ <xref:System.Security.Claims.ClaimsAuthenticationManager> のクラスにより提供される既定の動作は、入力がエコーされます。  `type` の属性が指定されていない場合、または `type` の属性が <xref:System.Security.Claims.ClaimsAuthenticationManager> のクラスを指定する場合は、 `<claimsAuthenticationManager>` の要素には子要素がありません。  カスタム動作を実行するに <xref:System.Security.Claims.ClaimsAuthenticationManager> クラスから派生した型を登録するに `type` の属性を指定できます。  派生クラスは `<claimsAuthenticationManager>` 要素の子要素を使用してこれらの要素を処理する <xref:System.Security.Claims.ClaimsAuthenticationManager.LoadCustomConfiguration%2A> メソッドのオーバーライドにより構成をサポートできます。  子要素に定義されたスキーマは、クラスのデザイナーがあります。  
+  
+ `<claimsAuthenticationManager>` の要素設定 <xref:System.IdentityModel.Configuration.IdentityConfiguration.ClaimsAuthenticationManager%2A?displayProperty=fullName> のプロパティ。  
+  
+## 使用例  
+  
+```  
+<system.identityModel>  
+    <identityConfiguration name=”MyIdentity”>  
+      <claimsAuthenticationManager type="MyNamespace.CustomClaimsAuthenticationManager, MyAssembly"/>          
+    </identityConfiguration>  
+</microsoft.identityModel>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md
new file mode 100644
index 00000000000..22392351a6a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;claimsAuthorizationManager&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9354eee3-f692-4ad6-8427-3169686b8bcc
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;claimsAuthorizationManager&gt;
+要求の承認マネージャーは、入力方向の要求を登録します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <claimsAuthorizationManager type = xs:string>  
+      <optionalConfigurationElements />  
+    </claimsAuthorizationManager>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生するカスタム型は<xref:System.Security.Claims.ClaimsAuthorizationManager>クラス。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。|  
+  
+### 子要素  
+ ある場合は、ない`type`属性、または、 `type`属性への参照、 <xref:System.Security.Claims.ClaimsAuthenticationManager>クラスは、 `<claimsAuthorizationManager>`要素に子要素。 ただし、クラスを派生してから<xref:System.Security.Claims.ClaimsAuthorizationManager>子の構成要素を定義することができます。  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス ・ レベルの id の設定を指定します。|  
+  
+## 解説  
+ によって提供される既定の動作は<xref:System.Security.Claims.ClaimsAuthorizationManager>クラスは、常に入力方向の要求を承認します。  ない場合`type`属性が指定されて場合、 `type`属性を指定します、 <xref:System.Security.Claims.ClaimsAuthorizationManager>クラス、 `<claimsAuthorizationManager>`要素には子要素があります。  指定することができます、 `type`から派生する属性は、タイプを登録するのには、 <xref:System.Security.Claims.ClaimsAuthorizationManager>カスタム動作を実装するクラス。  派生クラスは、構成要素の子要素をサポートできる、 `<claimsAuthorizationManager>`要素をオーバーライドすることで、 <xref:System.Security.Claims.ClaimsAuthorizationManager.LoadCustomConfiguration%2A>これらの要素を処理するメソッド。  子要素を定義するスキーマ クラスのデザイナーです。  
+  
+> [!IMPORTANT]
+>  使用すると、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermission>や、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute>クラスをコードで参照されている識別情報構成でクレーム ベースのアクセス制御を提供するために、 `<federationConfiguration>`要素は、要求承認マネージャー、承認決定を行うために使用するポリシーを構成します。  パッシブ Web シナリオ、たとえば、Windows 通信基盤 \(WCF\) アプリケーションまたは Web ベースでないアプリケーションではない場合も同様です。  アプリケーションがパッシブの Web アプリケーションでない場合、 `<claimsAuthorizationManager>`要素とその子ポリシー要素が存在する場合\) 参照の id の構成をされるだけの設定を適用します。  これ以外の設定は、すべて無視されます。  詳細については、[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md) 要素を参照してください。  
+  
+ この要素を設定する、 <xref:System.IdentityModel.Configuration.IdentityConfiguration.ClaimsAuthorizationManager%2A?displayProperty=fullName>プロパティ。  
+  
+## 使用例  
+ 次の XML 要求の承認の構成マネージャー リソースとアクションのペアの構成のポリシーの各リソースに対してアクションを実行するのには、リクエスターを持つ必要があります要求の論理的な組み合わせを指定しますを実装を示しています。  このポリシーを使用できるクレームの承認マネージャーを実装するコードにあります、 `ClaimsBasedAuthorization`サンプル。  
+  
+```  
+<system.identityModel>  
+    <identityConfiguration>  
+      <claimsAuthorizationManager type="ClaimsAuthorizationLibrary.MyClaimsAuthorizationManager, ClaimsAuthorizationLibrary">  
+        <policy resource="http://localhost:28491/Developers.aspx" action="GET">  
+          <or>  
+            <claim claimType="http://schemas.microsoft.com/ws/2008/06/identity/claims/role" claimValue="developer" />  
+            <claim claimType="http://schemas.xmlsoap.org/claims/Group" claimValue="Administrator" />  
+          </or>  
+        </policy>  
+        <policy resource="http://localhost:28491/Administrators.aspx" action="GET">  
+          <and>  
+            <claim claimType="http://schemas.xmlsoap.org/claims/Group" claimValue="Administrator" />  
+            <claim claimType="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country" claimValue="USA" />  
+          </and>  
+        </policy>  
+        <policy resource="http://localhost:28491/Default.aspx" action="GET">  
+        </policy>  
+        <policy resource="http://localhost:28491/" action="GET">  
+        </policy>  
+        <policy resource="http://localhost:28491/Claims.aspx" action="GET">  
+        </policy>  
+      </claimsAuthorizationManager>  
+    <identityConfiguration>  
+<system.identityModel>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtype.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtype.md
new file mode 100644
index 00000000000..b5023f44b17
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtype.md
@@ -0,0 +1,51 @@
+---
+title: "&lt;claimType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d17b5831-9a2c-45c4-b0d1-68f48e72e861
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;claimType&gt;
+1 つのオプションまたは必須の請求の入力方向のセキュリティ トークンを指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <claimTypeRequired>  
+      <claimType type=URI optional=xs:boolean >  
+      </claimType>  
+    </claimTypeRequired>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|クレームの種類。  通常、URI。  必ず指定します。|  
+|optional|要求の種類が省略可能かどうかを指定するブール値。  省略可能です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<claimTypeRequired\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtyperequired.md)|入力方向のセキュリティ トークンに必要なクレームのセットを指定します。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtyperequired.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtyperequired.md
new file mode 100644
index 00000000000..918b85bdba6
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtyperequired.md
@@ -0,0 +1,48 @@
+---
+title: "&lt;claimTypeRequired&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c469d71f-6c77-4a24-97aa-53efa126ceef
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;claimTypeRequired&gt;
+入力方向のセキュリティ トークンに必要なクレームのセットを指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <claimTypeRequired>  
+    </claimTypeRequired>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<claimType\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtype.md)|1 つのオプションまたは必須の請求の入力方向のセキュリティ トークンを指定します。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス ・ レベルの id の設定を指定します。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/clear.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/clear.md
new file mode 100644
index 00000000000..f8009411dd1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/clear.md
@@ -0,0 +1,47 @@
+---
+title: "&lt;clear&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54dcd1d1-038f-4fc8-a3a4-56ba7a1ca0fd
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# &lt;clear&gt;
+期限内のトークン ハンドラーのコレクションのすべてのセキュリティのトークン ハンドラーをオフにします。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <clear>  
+      </clear>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<securityTokenHandlers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md)|エンドポイントに登録されたセキュリティのトークン ハンドラーのコレクションを指定します。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md
new file mode 100644
index 00000000000..53ebbf817a4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;cookieHandler&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bfdc127f-8d94-4566-8bef-f583c6ae7398
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;cookieHandler&gt;
+構成、 <xref:System.IdentityModel.Services.CookieHandler>は、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\) を使用して cookie を読み書きします。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <cookieHandler name=xs:string  
+        path=Path  
+        mode="Chunked||Custom||Default"  
+        persistentSessionLifetime=xs:string  
+        hideFromScript=xs:boolean  
+        requireSSL=xs:boolean  
+        domain=xs:string  
+      <chunkedCookieHandler size=xs:int />  
+      <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
+    </cookieHandler>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|name|Cookie が書き込まれるすべてのベース名を指定します。  既定値は"FedAuth"です。|  
+|path|書き込まれたすべての cookie のパス値を指定します。  既定値は"HttpRuntime.AppDomainAppVirtualPath"です。|  
+|mode|いずれか、 <xref:System.IdentityModel.Services.CookieHandlerMode> SAM によって使用される cookie のハンドラーの種類を指定する値。  次の値を使用可能性があります。<br /><br /> -   「既定値」\-は「チャンク」します。<br />-   「チャンク」などのインスタンスを使用して、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>クラス。  この cookie のハンドラーは、個々 の cookie がセットの最大サイズを超えないことを確認します。  これは、可能性があります「1 つの論理の cookie cookie に回線の数にチャンクで」実行します。<br />-   「カスタム」などから派生したカスタム クラス インスタンスを使用して<xref:System.IdentityModel.Services.CookieHandler>。  派生クラスによって参照される、 `<customCookieHandler>`子要素。<br /><br /> 既定値は、"Default"です。|  
+|persistentSessionLifetime|永続的なセッションの有効期間を指定します。  一時的なセッションは 0 にすると、常に使用されます。  既定値は「一時的なセッションを指定なさい」、です。  「365 日間のセッションを指定 365:0:0」、最大値はです。  次の制限に従って値を指定する必要があります： `<xs:pattern value="([0-9.]+:){0,1}([0-9]+:){0,1}[0-9.]+" />`、左端の値日数を指定します。 時間の中央値 \(存在する場合\) を指定します、分の右端の値 \(存在する場合\) を指定します。|  
+|requireSsl|書き込まれた cookie に"Secure"フラグが出力されるかどうかを指定します。  この値を設定すると、サインイン セッション cookie のみ HTTPS 経由で利用できます。  既定値は"true"です。|  
+|hideFromScript|書き込まれた cookie の"HttpOnly"フラグが出力されるかどうかを制御します。  一部の web ブラウザーは、cookie の値にアクセスするクライアント側スクリプトを保持することでこのフラグを優先します。  既定値は"true"です。|  
+|domain|書き込まれたすべての cookie のドメイン値。  既定値は""。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<chunkedCookieHandler\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/chunkedcookiehandler.md)|構成、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>。  この要素のみが表示される場合、 `mode`属性の`<cookieHandler>` "Default"または「チャンク」です。|  
+|[\<customCookieHandler\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/customcookiehandler.md)|Cookie のカスタム ハンドラーの種類を設定します。  この要素が存在するにする必要がある場合は、 `mode`属性の`<cookieHandler>`要素は、「ユーザー設定」。  それの他の値が存在することはできません、 `mode`属性。  カスタムの型から派生する必要があります、 <xref:System.IdentityModel.Services.CookieHandler>クラス。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)|構成設定を含む、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\)。|  
+  
+## 解説  
+ <xref:System.IdentityModel.Services.CookieHandler>読み取りおよび書き込みの生の cookie では、HTTP プロトコル ・ レベルの責任を負います。  いずれかを構成することができます、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>カスタム cookie のハンドラーから派生、 <xref:System.IdentityModel.Services.CookieHandler>クラス。  
+  
+ チャンクの cookie のハンドラーを構成するには、mode 属性を「チャンク」または「デフォルト」を設定します。  既定のチャンク サイズは 2000 バイトですが、含めることによって、別のチャンク サイズをオプションとして指定できます、 `<chunkedCookieHandler>`子要素。  
+  
+ Cookie のカスタム ハンドラーを構成するには、mode 属性に「カスタム」に設定します。  指定する必要があります、 `<customCookieHandler>`カスタム ハンドラーの型を参照する子要素。  
+  
+ `<cookieHandler>`要素で表される、 <xref:System.IdentityModel.Services.CookieHandlerElement>クラス。  構成で指定した cookie のハンドラーからは、 <xref:System.IdentityModel.Services.Configuration.FederationConfiguration.CookieHandler%2A>のプロパティ、 <xref:System.IdentityModel.Services.Configuration.FederationConfiguration>設定オブジェクト、 <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName>プロパティ。  
+  
+## 使用例  
+ 次の XML に示す、 `<cookieHandler>`要素。  この例では、ため、 `mode`属性が指定されていない、cookie の既定のハンドラーが SAM によって使用されます。  これは、インスタンスのです、 <xref:System.IdentityModel.Services.ChunkedCookieHandler>クラス。  `<chunkedCookieHandler>`子要素が指定されていない、既定のチャンク サイズを指定します。  HTTPS は必要なので、 `requireSsl`属性を設定`false`。  
+  
+> [!WARNING]
+>  この例では、HTTPS セッション cookie を記述する必要はありません。  これは、ためには、 `requireSsl`の属性を`<cookieHandler>`要素に設定する`false`。  セキュリティ上のリスクを提示可能性がありますようにこの設定ほとんどの運用環境でしないでください。  
+  
+```  
+<cookieHandler requireSsl="false" />  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.CookieHandler>   
+ <xref:System.IdentityModel.Services.ChunkedCookieHandler>   
+ <xref:System.IdentityModel.Services.SessionAuthenticationModule>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/customcookiehandler.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/customcookiehandler.md
new file mode 100644
index 00000000000..5d51bdc76eb
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/customcookiehandler.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;customCookieHandler&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a03b153d-5ec6-4915-9031-6f0c3fd348be
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# &lt;customCookieHandler&gt;
+Cookie のカスタム ハンドラーの種類を設定します。  この要素のみが表示される場合は、 `mode`属性の`<cookieHandler>`要素は、「ユーザー設定」。  カスタムの型から派生する必要があります、 <xref:System.IdentityModel.Services.CookieHandler>クラス。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <cookieHandler mode=”Custom”>  
+      <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" >  
+      </customCookieHandler>  
+    </cookieHandler>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生するカスタム型を指定します、 <xref:System.IdentityModel.Services.CookieHandler>クラス。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<cookieHandler\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md)|構成、 <xref:System.IdentityModel.Services.CookieHandler>は、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> cookie の読み書きに使用します。|  
+  
+## 解説  
+ 設定することにより、クッキーのカスタム ハンドラーを指定すると、 `mode`属性の`<cookieHandler>`要素「ユーザー設定」などでカスタム cookie のハンドラーの種類を指定する必要があります、 `<customCookieHandler>`クッキーのハンドラーの型を参照する子要素。  この要素にすることはできない時に指定、 `mode` 「チャンク」または「既定値」属性を設定します。  ハンドラーのカスタム cookie を派生する必要がありますから、 <xref:System.IdentityModel.Services.CookieHandler>クラス。  
+  
+ `<customCookieHandler>`要素で表される、 <xref:System.IdentityModel.Configuration.CustomTypeElement>クラス。  
+  
+## 使用例  
+ 次の使用例カスタム cookie のハンドラーの型を使用すると、SAM の構成`MyNamespace.MyCustomCookieHandler`。  
+  
+```  
+<cookieHandler mode="Custom">  
+    <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
+</cookieHandler>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.CookieHandler>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md
new file mode 100644
index 00000000000..6d780a90ca7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;federationConfiguration&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b14054c-6d07-46ab-ab58-03f14beac0f2
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# &lt;federationConfiguration&gt;
+構成、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\) を使用する場合の連合、Ws\-federation プロトコルを使って認証します。  構成、 <xref:System.Security.Claims.ClaimsAuthorizationManager>を使用すると、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermission>や、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute>クレーム ベースのアクセス制御を提供するクラス。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration name=xs:string identityConfigurationName=xs:string>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|name|このフェデレーションの構成要素の名前。  この属性は、主に将来のプロトコルの機能拡張ポイントを提供します。  省略可能です。|  
+|identityConfigurationName|Id の構成セクションで指定した名前は、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素を使用します。  この属性が指定されていない場合は、既定の id の構成セクションが使用されます。  省略可能です。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<cookieHandler\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md)|SAM によって使用される cookie のハンドラーを構成します。  省略可能です。|  
+|[\<serviceCertificate\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/servicecertificate.md)|暗号化し、トークンを復号化するために使用する証明書を構成します。  省略可能です。|  
+|[\<wsFederation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/wsfederation.md)|WS フェデレーション認証モジュール \(WSFAM\) を構成します。  省略可能です。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<system.identityModel.services\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md)|Ws\-federation プロトコルを使用して、認証用の構成セクション。|  
+  
+## 解説  
+ \<federationConfiguration\> 要素に 2 つの異なるシナリオでの設定が用意されています。  
+  
+-   Ws\-federation のパッシブ Web アプリケーションで使用すると、要素には構成設定が含まれています、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\)。  また、セキュリティ トークン ハンドラー、証明書、および要求の承認マネージャーやクレームの認証マネージャーのコンポーネントを構成するために使用する識別情報の構成を参照します。  
+  
+-   使用すると、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermission>や、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute>クラスのコード内でのクレーム ベースのアクセス コントロールを提供するために、要求承認マネージャー、承認決定を行うために使用するポリシーを構成、アイデンティティの構成要素を参照します。  これは、パッシブ Web シナリオでないシナリオにも当てはまります。 たとえば、Windows 通信基盤 \(WCF\) アプリケーションまたは Web ベースでないアプリケーション。  アプリケーションがパッシブの Web アプリケーションでない場合、 [\<claimsAuthorizationManager\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md)要素とその子ポリシー要素が存在する場合\) によって参照されている識別情報の構成の`<federationConfiguration>`要素が適用されるだけの設定します。  その他のメンバーはすべて無視されます。  
+  
+ シナリオに関係なく、ランタイムは既定のフェデレーション構成を読み込みます。  動作は、次のように定義されています。  
+  
+1.  ある場合ない`<federationConfiguration>`要素が、ランタイムはフェデレーションの構成を作成し、既定値が設定されます。  この既定のフェデレーションの構成は、既定のユーザー構成を参照します。  
+  
+2.  場合は 1 つの`<federationConfiguration>`要素が存在しない場合、という名前のないかにかかわらず、既定のフェデレーション構成です。  場合は、 `identityConfiguration`属性を指定すると、名前付きのアイデンティティ構成が参照されています。 それ以外の場合は、ユーザーの既定の構成を参照します。  
+  
+3.  場合は、名前のない`<federationConfiguration>`要素が存在しない場合、既定のフェデレーションの構成です。  場合は、 `identityConfiguration`属性を指定すると、名前付きのアイデンティティ構成が参照されています。 それ以外の場合は、ユーザーの既定の構成を参照します。  
+  
+4.  場合は、複数の名前付き`<federationConfiguration>`要素が存在しない無名`<federationConfiguration>`要素が存在しない場合、例外がスローされます。  
+  
+ 通常、ひとつ`<federationConfiguration>`セクションを定義します。  このセクションでは、既定のフェデレーションの構成です。  複数を一意に名前を指定する可能性があります`<federationConfiguration>`の要素。 無名以外のフェデレーション構成をロードする場合は、ただし、この例では、ハンドラーを用意する必要があるがします。  <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfigurationCreated>イベントとセット、 <xref:System.IdentityModel.Services.Configuration.FederationConfigurationCreatedEventArgs.FederationConfiguration%2A?displayProperty=fullName>プロパティ内のハンドラーに、 <xref:System.IdentityModel.Services.Configuration.FederationConfiguration>オブジェクトから適切な値に初期化`<federationConfiguration>`構成ファイル内の要素。  
+  
+ `<federationConfiguration>`要素で表される、 <xref:System.IdentityModel.Services.Configuration.FederationConfigurationElement>クラス。  構成オブジェクトによって表される、 <xref:System.IdentityModel.Services.Configuration.FederationConfiguration>クラス。  1 つの<xref:System.IdentityModel.Services.Configuration.FederationConfiguration>インスタンスの設定には、 <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName>プロパティとフェデレーションの構成のアプリケーションが用意されています。  
+  
+## 使用例  
+ 次の XML に示す、 `<federationConfiguration>` 、WSFAM の設定が指定され、要素 cookie の既定のハンドラー \(インスタンスの<xref:System.IdentityModel.Services.ChunkedCookieHandler>クラス\) によって SAM を使用します。  
+  
+> [!WARNING]
+>  この例では、cookie のハンドラーと WSFAM のどちらも必要な HTTPS を使用します。  これは、ためには、 `requireHttps`の属性、 `<wsFederation>`要素と、 `requireSsl`の属性、 `<cookieHandlerElement>`は`false`。  これらの設定は、セキュリティ上のリスクがあるとほとんどの運用環境では推奨されません。  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <wsFederation passiveRedirectEnabled="true"   
+      issuer="http://localhost:15839/wsFederationSTS/Issue"   
+      realm="http://localhost:50969/" reply="http://localhost:50969/"   
+      requireHttps="false"   
+      signOutReply="http://localhost:50969/SignedOutPage.html"   
+      signOutQueryString="Param1=value2&Param2=value2"   
+      persistentCookiesOnPassiveRedirects="true" />  
+    <cookieHandler requireSsl="false" />  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.WSFederationAuthenticationModule>   
+ <xref:System.IdentityModel.Services.SessionAuthenticationModule>   
+ <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName>   
+ [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md
new file mode 100644
index 00000000000..f67022fc324
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md
@@ -0,0 +1,100 @@
+---
+title: "&lt;identityConfiguration&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1db76253-07da-447b-9e7a-3705c7228cf4
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# &lt;identityConfiguration&gt;
+サービス ・ レベルの id の設定を指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration  
+      name=xs:string  
+      saveBootstrapContext=xs:boolean>  
+      maximumClockSkew=TimeSpan >  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|name|Id の構成セクションの名前。  特定の構成セクションを参照するのにには、この名前を使用できます。  ない場合は`name`属性を指定すると、既定の構成セクションを定義します。  既定の構成は、パッシブ フェデレーション シナリオでは常に使用されます。  詳細については、[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md) 要素を参照してください。|  
+|saveBootstrapContext|ブートス トラップのトークンをセッション トークンを含める必要がかどうかを指定します。  値も、トークン ハンドラーのコレクションを設定する可能性があります、 `saveBootstrapContext`の属性を[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)要素。  サービスに設定されている値、トークン ハンドラーのコレクションの設定値をオーバーライドします。|  
+|maximumClockSkew|A <xref:System.TimeSpan>は、最大許可された時計の傾斜を指定します。  サインイン セッションの有効期限の検証など、急を要する操作を実行するときの最大許可された時計の傾斜を制御します。  既定値は 5 分です\] 00: 05:00"。  指定する方法の詳細については、 <xref:System.TimeSpan>の値を参照してください[Timespan Values](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_TimespanValues)。  最大クロック スキューも、トークン ハンドラーのコレクションを設定する可能性があります、 `maximumClockSkew`の属性を[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)要素。  サービスに設定されている値、トークン ハンドラーのコレクションの設定値をオーバーライドします。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<キャッシュ\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md)|セッション トークンをトークンのリプレイ検出を使用して、キャッシュを登録します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  省略可能です。|  
+|[\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md)|証明書を検証するトークン ハンドラーを使用する設定を制御します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  省略可能です。|  
+|[\<claimsAuthenticationManager\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthenticationmanager.md)|クレーム認証マネージャーの入力方向の要求を登録します。  省略可能です。|  
+|[\<claimsAuthorizationManager\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md)|要求の承認マネージャーは、入力方向の要求を登録します。  省略可能です。|  
+|[\<claimTypeRequired\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimtyperequired.md)|入力方向のセキュリティ トークンに必要なクレームのセットを指定します。  省略可能です。|  
+|[\<securityTokenHandlers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md)|セキュリティ トークン ハンドラーのコレクションを指定します。  0 個以上のコレクションのセキュリティ トークン ハンドラーを指定できます。  省略可能です。|  
+|[\<tokenReplayDetection\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md)|トークンのリプレイ検出を有効にし、トークンの有効期限を指定します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  省略可能です。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<system.identityModel\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md)|アプリケーションでんだ Windows アイデンティティ基盤 \(ぜ\) オプションを有効にする構成を提供します。|  
+  
+## 解説  
+ 複数のアイデンティティが構成が定義可能性がありますが、それぞれに一意の名前。  動作は次のとおりです。  
+  
+1.  ない場合は`<identityConfiguration>`要素を指定します。  既定のユーザー構成実行時に作成され、既定値が指定されました。  
+  
+2.  場合は 1 つの`<identityConfiguration>`要素を指定します。  これは、ユーザーの既定の構成です。  名前または名前のないかどうかは関係ありません。  
+  
+3.  場合は、複数`<identityConfiguration>`要素を指定します。  無名の要素には、ユーザーの既定の構成を指定します。  複数指定する場合にお勧め`<identityConfiguration>`要素、それらのいずれかする必要がありますできない名前付き。  
+  
+> [!WARNING]
+>  複数指定する場合`<identityConfiguration>`要素、それらのいずれかする必要がありますできない名前付き。  名前のない要素は、ユーザーの既定の構成になります。  
+  
+ 指定した設定のいくつかの`<identityConfiguration>`セキュリティ トークン ハンドラーのコレクションを設定または個々 のセキュリティ トークン ハンドラーの設定によって、要素をオーバーライドできます。  
+  
+> [!IMPORTANT]
+>  使用すると、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermission>や、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute>クラスをコードで参照されている識別情報構成でクレーム ベースのアクセス制御を提供するために、 `<federationConfiguration>`要素は、要求承認マネージャー、承認決定を行うために使用するポリシーを構成します。  パッシブ Web シナリオ、たとえば、Windows 通信基盤 \(WCF\) アプリケーションまたは Web ベースでないアプリケーションではない場合も同様です。  アプリケーションがパッシブの Web アプリケーションでない場合、 [\<claimsAuthorizationManager\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md)要素とその子ポリシー要素が存在する場合\) 参照の id の構成をされるだけの設定を適用します。  これ以外の設定は、すべて無視されます。  詳細については、[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md) 要素を参照してください。  
+  
+ `<identityConfiguration>`要素で表される、 <xref:System.IdentityModel.Configuration.IdentityConfigurationElement>クラス。  ユーザーの構成\] セクションで表される、 <xref:System.IdentityModel.Configuration.IdentityConfiguration>クラス。  
+  
+> [!IMPORTANT]
+>  子要素として、次の要素を指定する、 `<identityConfiguration>`要素が廃止されました、旧バージョンとの互換性はまだ動作がサポートされていますが。  これらの要素で指定する必要があります、 [\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)要素。  
+>   
+>  -   [\<audienceUris\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/audienceuris.md)  
+> -   [\<issuerNameRegistry\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md)  
+> -   [\<issuerTokenResolver\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/issuertokenresolver.md)  
+> -   [\<serviceTokenResolver\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/servicetokenresolver.md)  
+  
+## 使用例  
+ 次の使用例は、"alternateConfiguration"という名前は、身元の構成を作成します。  ユーザーの構成の既定の設定を指定します。  
+  
+```  
+<system.identityModel>  
+    <identityConfiguration name="alternateConfiguration"/>  
+</system.identityModel>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Configuration.IdentityConfiguration>   
+ <xref:System.IdentityModel.Configuration.IdentityConfigurationElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md
new file mode 100644
index 00000000000..5837d74be54
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md
@@ -0,0 +1,120 @@
+---
+title: "Windows Identity Foundation 構成スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d4f6d76-49a5-4bad-b345-097b2e2844e9
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# Windows Identity Foundation 構成スキーマ
+このセクションのトピックでは、たんだ Windows アイデンティティ基盤 \(ぜ\) 構成スキーマに関する情報を提供します。  たんだぜ、フレームワークによって公開されているクラスを使用すると、アプリケーション構成できます、します。  これらのクラスはスキーマに関連する要素を扱うセクションに記載されています。  次に示す基本的な XML 構造をしてたんだぜ構成スキーマを公開するタグです。  属性は省略されます。  強調表示されているコメントは、スキーマの主なコンポーネントを示しています。  
+  
+```  
+<system.identityModel>  
+    <!-- Service Configuration -->  
+    <identityConfiguration>  
+        <caches>  
+            <sessionSecurityTokenCache />  
+            <tokenReplayCache />  
+        </caches>  
+  
+        <certificateValidation>  
+            <certificateValidator />   
+        </certificateValidation>  
+  
+        <claimsAuthenticationManager />  
+  
+        <claimsAuthorizationManager>  
+            <optionalConfigurationElement>  
+        </claimsAuthorizationManager>  
+  
+        <claimTypeRequired>  
+            <claimType />   
+        </claimTypeRequired>  
+  
+        <tokenReplayDetection />  
+  
+        <!-- Security Token Handler Collection Configuration -->  
+        <securityTokenHandlers>  
+            <add>  
+                <!-- Can take an optional configuration element which can be one of  
+                     the following or a custom element -->  
+                <samlSecurityTokenHandlerRequirement>  
+                    <nameClaimType>  
+                    <roleClaimType>   
+                </samlSecurityTokenHandlerRequirement>  
+  
+                <sessionSecurityTokenHandlerRequirement />  
+                <x509SecurityTokenHandlerRequirement />  
+                <userNameSecurityTokenHandlerRequirement />  
+            </add>  
+            <clear />  
+            <remove />  
+            <securityTokenHandlerConfiguration>  
+                <audienceUris>  
+                    <add>  
+                    <clear>  
+                    <remove>  
+                </audienceUris>  
+  
+                <caches>  
+                    <sessionSecurityTokenCache />  
+                    <tokenReplayCache />  
+                </caches>  
+  
+                <certificateValidation>  
+                    <certificateValidator>   
+                </certificateValidation>  
+  
+                <issuerNameRegistry>  
+                    <!-- Can take an optional configuration element which can be   
+                         the <trustedIssuers> element to configure a configuration-based  
+                         issuer name registry or can be a custom element -->  
+                    <trustedIssuers>  
+                        <add>  
+                        <clear>  
+                        <remove>  
+                    </trustedIssuers>  
+                </issuerNameRegistry>  
+  
+                <issuerTokenResolver />  
+                <serviceTokenResolver />  
+                <tokenReplayDetection />  
+            </securityTokenHandlerConfiguration>  
+        </securityTokenHandlers>  
+    </identityConfiguration>  
+</system.identityModel>  
+  
+<system.identityModel.services>  
+    <!-- Federation Authentication Configuration -->  
+    <federatedAuthentication>  
+        <cookieHandler>  
+            <chunkedCookieHandler />  
+            <customCookieHandler />  
+        </cookieHandler>  
+  
+        <serviceCertificate>  
+            <certificateReference>  
+        </serviceCertificate>  
+  
+        <wsFederation />  
+    </federatedAuthentication>  
+</system.identityModel.services>  
+```  
+  
+## このセクションの内容  
+ [\<system.identityModel\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md)たんだぜオプションでアプリケーションを有効にする構成を提供します。  
+  
+ [\<system.identityModel.services\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md)たんだぜを使用して、パッシブ フェデレーションの構成を提供します。  セッション認証モジュール \(SAM\) とフェデレーション認証モジュール \(WSFAM\) を構成します。  
+  
+## 関連項目  
+ [Configuration, Administration, And Management](http://msdn.microsoft.com/ja-jp/1e03c389-de2c-4096-aaff-86b087e1bea0)構成してたんだぜのアプリケーションとサービスを管理する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md
new file mode 100644
index 00000000000..8bcf86c7b7f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;issuerNameRegistry&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58b39d12-c953-40c4-88af-d7eb3343ca28
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 12
+---
+# &lt;issuerNameRegistry&gt;
+ハンドラーで、トークン ハンドラー コレクションで使用される発行者名レジストリを構成します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration>  
+        <issuerNameRegistry type=xs:string>  
+          <optionalCustomConfigurationElements />  
+        </issuerNameRegistry>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生した型は<xref:System.IdentityModel.Tokens.IssuerNameRegistry>クラス。  ユーザー設定を指定する方法の詳細については`type`を参照してください[Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<trustedIssuers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md)|`type`属性には、構成ベースの発行者名レジストリを指定します \(、 <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>クラス\) は、 [\<trustedIssuers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md)要素を指定する必要があります。  [\<trustedIssuers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md)要素を取ることができます`<add>`、 `<clear>`、または`<remove>`要素の子要素として。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成コレクションのセキュリティ トークン ハンドラーを提供します。|  
+  
+## 解説  
+ すべてのトークンの発行者、発行者名レジストリを使用して検証されます。  これからの派生オブジェクトです、 <xref:System.IdentityModel.Tokens.IssuerNameRegistry>クラス。  発行者名レジストリ ニーモニックの名前に対応する発行者によって作成されたトークンの署名を確認するために必要な暗号化の材料を関連付けるために使用されます。  発行者名レジストリ依存元のパーティ \(RP\) アプリケーションによって信頼されている発行者の一覧を維持します。  発行者名レジストリの種類を使用して指定される、 `type`属性。  `<issuerNameRegistry>`要素は、指定した型の構成を提供する 1 つまたは複数の子要素を持つことができます。  オーバーライドして子要素を処理するロジックを提供、 <xref:System.IdentityModel.Tokens.IssuerNameRegistry.LoadCustomConfiguration%2A>メソッド。  
+  
+ 名前レジストリの種類、ボックスの外の提供、シングル ・発行者をたんだぜ、 <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>クラス。  このクラスは、一連の構成で指定されている信頼された発行者の証明書を使用します。  これは、子の構成要素、する必要があります`<trustedIssuers>`、\[信頼できる発行元の証明書のコレクションを設定されている場合します。  証明書を指定する、ASN.1 を使用してエンコードされた形式の証明書の拇印と追加またはを使用して、コレクションからの削除を信頼`<add>`、 `<clear>`、または`<remove>`の要素。  
+  
+ `<issuerNameRegistry>`要素で表される、 <xref:System.IdentityModel.Configuration.IssuerNameRegistryElement>クラス。  
+  
+> [!NOTE]
+>  指定する、 `<issuerNameRegistry>`要素の子要素として、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素は推奨されていませんが、旧バージョンとの互換性のためのサポートもします。  設定で、 `<securityTokenHandlerConfiguration>`要素無効もに、 `<identityConfiguration>`要素。  
+  
+## 使用例  
+ 次の XML 名のレジストリをベースの構成の発行者を指定する方法を示します。  
+  
+```  
+<issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+  <trustedIssuers>  
+    <add thumbprint="9B74CB … 1EF40D0" name="LocalSTS" />  
+  </trustedIssuers>  
+</issuerNameRegistry>  
+  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.IssuerNameRegistry>   
+ <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuertokenresolver.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuertokenresolver.md
new file mode 100644
index 00000000000..90401769f1f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/issuertokenresolver.md
@@ -0,0 +1,90 @@
+---
+title: "&lt;issuerTokenResolver&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f74392f6-3f5b-4880-bd8a-3a9130d31e65
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# &lt;issuerTokenResolver&gt;
+ハンドラーで、トークン ハンドラー コレクションで使用される発行者トークン リゾルバーを登録します。  署名トークンにトークンとメッセージの受信を解決するには、発行者トークン リゾルバーが使用されます。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration>  
+        <issuerTokenResolver type=xs:string>  
+        </issuerTokenResolver>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|発行者、トークン リゾルバーの種類を指定します。  いずれかにする必要があります、 <xref:System.IdentityModel.Tokens.IssuerTokenResolver>クラスまたはから派生した型は<xref:System.IdentityModel.Tokens.IssuerTokenResolver>クラス。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。  必ず指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成コレクションのセキュリティ トークン ハンドラーを提供します。|  
+  
+## 解説  
+ 署名トークンにトークンとメッセージの受信を解決するには、発行者トークン リゾルバーが使用されます。  これは、暗号署名をチェックするために使用される材料を取得するために使用されます。  指定する必要があります、 `type`属性。  指定された型はいずれかになります<xref:System.IdentityModel.Tokens.IssuerTokenResolver>またはから派生するカスタム型は<xref:System.IdentityModel.Tokens.IssuerTokenResolver>クラス。  
+  
+ 一部トークン ハンドラー構成で発行者トークン リゾルバーの設定を指定することができます。  指定されたセキュリティ トークン ハンドラー コレクションで個々 のトークン ハンドラーの設定をオーバーライドします。  
+  
+> [!NOTE]
+>  指定する、 `<issuerTokenResolver>`要素の子要素として、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素は推奨されていませんが、旧バージョンとの互換性のためのサポートもします。  設定で、 `<securityTokenHandlerConfiguration>`要素無効もに、 `<identityConfiguration>`要素。  
+  
+## 使用例  
+ 次の XML から派生するカスタム クラスに基づいて、発行者トークン リゾルバーの構成を示しています<xref:System.IdentityModel.Tokens.IssuerTokenResolver>。  トークン リゾルバーからカスタムの構成要素が初期化される対象キーのペアのディクショナリを保持しています \(`<AddAudienceKeyPair>`\) のクラスを定義します。  クラスのオーバーライド、 <xref:System.IdentityModel.Selectors.SecurityTokenResolver.LoadCustomConfiguration%2A>この要素を処理するメソッド。  オーバーライドは、次の例では、表示されます。 ただし、それを呼び出す方法を簡潔にするため表示されません。  完全な例についてを参照してください、 `CustomToken`サンプル。  
+  
+```  
+<issuerTokenResolver type="SimpleWebToken.CustomIssuerTokenResolver, SimpleWebToken">  
+  <AddAudienceKeyPair  symmetricKey="wAVkldQiFypTQ+kdNdGWCYCHRcee8XmXxOvgmak8vSY=" audience="http://localhost:19851/" />  
+</issuerTokenResolver>  
+```  
+  
+## 使用例  
+  
+```  
+public override void LoadCustomConfiguration(System.Xml.XmlNodeList nodelist)  
+{  
+    foreach (XmlNode node in nodelist)  
+    {  
+        XmlDictionaryReader rdr = XmlDictionaryReader.CreateDictionaryReader(new XmlTextReader(new StringReader(node.OuterXml)));  
+        rdr.MoveToContent();  
+  
+        string symmetricKey = rdr.GetAttribute("symmetricKey");  
+        string audience = rdr.GetAttribute("audience");  
+  
+        this.AddAudienceKeyPair(audience, symmetricKey);  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.IssuerTokenResolver>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/nameclaimtype.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/nameclaimtype.md
new file mode 100644
index 00000000000..4775df7ecc7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/nameclaimtype.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;nameClaimType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 17514d95-f0f5-4789-8e28-346640dc227c
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;nameClaimType&gt;
+<xref:System.Security.Principal.IIdentity.Name%2A> のプロパティを指定する要求タイプを設定します。  要求タイプがこのトークン ハンドラーの <xref:System.IdentityModel.Tokens.SecurityTokenHandler.ValidateToken%2A> 方法によって返された <xref:System.Security.Claims.ClaimsIdentity> のオブジェクト コレクションの <xref:System.Security.Claims.Claim> の検索に使用されます。  一致の値は、たとえば、このハンドラーから生成される <xref:System.Security.Principal.IIdentity> の名前設定されます。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add>  
+        <samlSecurityTokenRequirement>  
+          <nameClaimType value=xs:string>  
+          </nameClaimType>  
+        </samlSecurityTokenRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|<xref:System.Security.Principal.IIdentity.Name%2A> のプロパティに使用する要求タイプの要求を表す URI を指定する文字列。  必須。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<samlSecurityTokenRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md)|これらのクラスのいずれかの <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler> クラス、<xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler> クラス、または派生クラスにコンフィギュレーションを提供します。|  
+  
+## 解説  
+ <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement> のオブジェクトを構成から開始されるときに `<nameClaimType>` の要素セット <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement.NameClaimType%2A> のプロパティ。  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Tokens.SamlSecurityTokenHandler, System.IdentityModel">  
+    <samlSecurityTokenRequirement>  
+        <nameClaimType value="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" />  
+    </samlSecurityTokenRequirement>  
+</add>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement.NameClaimType%2A>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/remove.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/remove.md
new file mode 100644
index 00000000000..4e61210ac26
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/remove.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;削除&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4058e2f1-7db4-4d1a-84dd-1b52836f2ae6
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;削除&gt;
+指定されたセキュリティ トークン ハンドラーをトークン ハンドラー コレクションから削除します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <remove type=xs:string >  
+      </remove>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|削除すると、トークン ハンドラーの CLR 型名。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](http://msdn.microsoft.com/ja-jp/7286d2e3-c63d-49fd-abdc-ce2705f22c24)。  必ず指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md)|エンドポイントには登録されているセキュリティ トークン ハンドラーのコレクションを指定します。|  
+  
+## 使用例  
+ 次の XML の使用を示しています、 `<add>`と`<remove>`カスタム セッション トークン ハンドラーが既定のセッション トークン ハンドラーを置換する要素。  XML から取得されます、 `ClaimsAwareWebFarm`サンプル。  
+  
+```  
+<securityTokenHandlers>  
+  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+</securityTokenHandlers>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/roleclaimtype.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/roleclaimtype.md
new file mode 100644
index 00000000000..65fdf53e395
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/roleclaimtype.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;roleClaimType&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 69a49deb-6369-41ba-806b-ae8d21fac64b
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;roleClaimType&gt;
+たとえば、ハンドラーの <xref:System.IdentityModel.Tokens.SecurityTokenHandler.ValidateToken%2A> 方法によって返された <xref:System.Security.Claims.ClaimsIdentity> のオブジェクト コレクションの要求ロールのタイプを定義する要求タイプを指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add>  
+        <samlSecurityTokenRequirement>  
+          <roleClaimType value=xs:string>  
+          </roleClaimType>  
+        </samlSecurityTokenRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|value|ロールのタイプの要求を使用して要求の要求のタイプを表す URI を指定する文字列。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<samlSecurityTokenRequirement\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md)|これらのクラスのいずれかの <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler> クラス、<xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler> クラス、または派生クラスにコンフィギュレーションを提供します。|  
+  
+## 解説  
+ <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement> のオブジェクトを構成から開始されるときに `<roleClaimType>` の要素セット <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement.RoleClaimType%2A> のプロパティ。  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Tokens.SamlSecurityTokenHandler, System.IdentityModel">  
+    <samlSecurityTokenRequirement>  
+        <roleClaimType value="schemas.microsoft.com/ws/2006/04/identity/claims/role" />  
+    </samlSecurityTokenRequirement>  
+</add>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement.RoleClaimType%2A>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md
new file mode 100644
index 00000000000..7daf3b01bb7
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/samlsecuritytokenrequirement.md
@@ -0,0 +1,85 @@
+---
+title: "&lt;samlSecurityTokenRequirement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09202d12-88d3-49cc-953b-703bcc1690eb
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;samlSecurityTokenRequirement&gt;
+これらのクラスのいずれかの <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler> クラス、<xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler> クラス、または派生クラスにコンフィギュレーションを提供します。  <xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement> クラスで表される。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add>  
+        <samlSecurityTokenRequirement   
+            issuerCertificateValidationMode="None||ChainTrust||PeerTrust||PeerOrChainTrust||Custom"  
+            issuerCertificateRevocationMode="NoCheck||Offline||Online"  
+            issuerCertificateTrustedStoreLocation="CurrentLocation||LocalMachine"  
+            issuerCertificateValidator="Namespace.Class Assembly"  
+            mapToWindows=xs:boolean  
+          <nameClaimType value=xs:string />  
+          <roleClaimType value=xs:string />  
+        </samlSecurityTokenRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|mapToWindows|たとえば、ハンドラーが Windows アカウントに入力された UPN の要求の使用によって検証のトークンをマップするかどうかを指定します。  既定値は「false」です。|  
+|issuerCertificateRevocationMode|X.509 証明書に使用する破棄の方法を指定する <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> の値。  既定値は「オンライン」です。|  
+|issuerCertificateValidationMode|X.509 証明書に使用する検証の方法を指定する <xref:System.ServiceModel.Security.X509CertificateValidationMode> の値。  既定値は、「」PeerOrChainTrust です。|  
+|issuerCertificateTrustedStoreLocation|X.509 証明書の店舗を指定する <xref:System.Security.Cryptography.X509Certificates.StoreLocation> の値。  既定値は、「」LocalMachine です。|  
+|issuerCertificateValidator|<xref:System.IdentityModel.Selectors.X509CertificateValidator>取得元の注文タイプ。  `issuerCertificateValidationMode` の属性をカスタム「」の場合、この型のインスタンスはフィールドの証明書の検証に使用されます。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<nameClaimType\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/nameclaimtype.md)|<xref:System.Security.Principal.IIdentity.Name%2A> のプロパティを指定する要求タイプを設定します。|  
+|[\<roleClaimType\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/roleclaimtype.md)|たとえば、ハンドラーの <xref:System.IdentityModel.Tokens.SecurityTokenHandler.ValidateToken%2A> 方法によって返された <xref:System.Security.Claims.ClaimsIdentity> のオブジェクト コレクションの要求ロールのタイプを定義する要求タイプを指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md)|たとえば、ハンドラーのグループに指定セキュリティのトークン ハンドラーを追加します。|  
+  
+## 解説  
+ オブジェクト モデル \(<xref:System.IdentityModel.Tokens.SamlSecurityTokenRequirement> クラスが `<samlSecurityTokenRequirement>` の要素を表され、<xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler> または <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>の `SamlSecurityTokenRequirement` のプロパティをコンフィギュレーションします。  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Tokens.SamlSecurityTokenHandler, System.IdentityModel">  
+    <samlSecurityTokenRequirement issuerCertificateValidationMode="PeerOrChainTrust"  
+                                  issuerCertificateRevocationMode="Online"  
+                                  issuerCertificateTrustedStoreLocation="LocalMachine"  
+                                  mapToWindows="false">  
+  
+        <nameClaimType value="http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name" />  
+        <roleClaimType value="schemas.microsoft.com/ws/2006/04/identity/claims/role" />  
+    </samlSecurityTokenRequirement>  
+</add>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md
new file mode 100644
index 00000000000..62aef1f49b0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;securityTokenHandlerConfiguration&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28724cc6-020c-4a06-9a1f-d7594f315019
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# &lt;securityTokenHandlerConfiguration&gt;
+構成、トークン ハンドラーのコレクションを提供します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration saveBootstrapContext=xs:boolean  
+          maximumClockSkew=TimeSpan>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|saveBootstrapContext|ブートス トラップのトークンをセッション トークンを含める必要がかどうかを指定します。  値も、トークン ハンドラーのコレクションを設定する可能性があります、 `saveBootstrapContext`の属性を[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素。  サービスに設定されている値、トークン ハンドラーのコレクションの設定値をオーバーライドします。|  
+|maximumClockSkew|A <xref:System.TimeSpan>は、最大許可された時計の傾斜を指定します。  サインイン セッションの有効期限の検証など、急を要する操作を実行するときの最大許可された時計の傾斜を制御します。  既定値は 5 分です\] 00: 05:00"。  指定する方法の詳細については、 <xref:System.TimeSpan>の値を参照してください[Timespan Values](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_TimespanValues)。  最大クロックスも、サービス レベルで設定する可能性があります、 `maximumClockSkew`の属性を[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素。  サービスに設定されている値、トークン ハンドラーのコレクションの設定値をオーバーライドします。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<audienceUris\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/audienceuris.md)|この依存元の相手の許容可能な識別子は Uri のセットを指定します。  省略可能です。|  
+|[\<キャッシュ\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md)|セッション トークンをトークンのリプレイ検出を使用して、キャッシュを登録します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  省略可能です。|  
+|[\<certificateValidation\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatevalidation.md)|証明書を検証するトークン ハンドラーを使用する設定を制御します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  独自の検証コントロールと、特定のハンドラーが設定されている場合、これらの設定はオーバーライドされます。  省略可能です。|  
+|[\<issuerNameRegistry\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md)|ハンドラーで、トークン ハンドラー コレクションで使用される発行者名レジストリを構成します。  省略可能です。|  
+|[\<issuerTokenResolver\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/issuertokenresolver.md)|ハンドラーで、トークン ハンドラー コレクションで使用される発行者トークン リゾルバーを登録します。  署名トークンにトークンとメッセージの受信を解決するには、発行者トークン リゾルバーが使用されます。  省略可能です。|  
+|[\<serviceTokenResolver\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/servicetokenresolver.md)|ハンドラーで、トークン ハンドラー コレクションにより使用されるサービス トークン リゾルバーを登録します。  サービス トークン リゾルバーを使用すると、受信トークンとメッセージの暗号化トークンを解決します。  省略可能です。|  
+|[\<tokenReplayDetection\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md)|トークンのリプレイ検出を有効にし、トークンの有効期限を指定します。  サービス ・ レベルやセキュリティ トークン ハンドラーのコレクションを指定できます。  省略可能です。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlers\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md)|エンドポイントには登録されているセキュリティ トークン ハンドラーのコレクションを指定します。|  
+  
+## 解説  
+ 説明プロパティの値は、 <xref:System.IdentityModel.Tokens.SecurityTokenHandlerConfiguration>オブジェクト。  ここで構成した設定は、サービスで構成されているをオーバーライドします。  いくつかのこれらの設定ハンドラーはセキュリティ トークン ハンドラー コレクションに追加されるときに指定された設定によって、オーバーライドことができます。  
+  
+## 使用例  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>   
+      <securityTokenHandlerConfiguration>  
+  
+        <audienceUris>  
+          <clear/>  
+          <add value="http://www.example.com/myapp/" />  
+        </audienceUris>  
+  
+        <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel">  
+          <trustedIssuers>  
+            <add thumbprint="97249e1a … 4c9158de" name="contoso.com" />  
+          </trustedIssuers>  
+        </issuerNameRegistry>  
+  
+        <issuerTokenResolver type="MyNamespace.CustomTokenResolver, MyAssembly" />  
+  
+        <serviceTokenResolver type="MyNamespace.CustomTokenResolver, MyAssembly" />  
+  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md
new file mode 100644
index 00000000000..641694e7db1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlers.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;securityTokenHandlers&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f11a631d-4094-4e11-bb03-4ede74b30281
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;securityTokenHandlers&gt;
+エンドポイントには登録されているセキュリティ トークン ハンドラーのコレクションを指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|name|トークン ハンドラーのコレクションの名前を指定します。  フレームワークによって認識される唯一の値は、"ActAs"と"OnBehalfOf"です。  トークン ハンドラーのコレクションにこれらの名前のいずれかに指定されている場合は、それぞれトークンの ActAs または OnBehalfOf を処理すると、コレクションが使用されます。|  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md)|セキュリティ トークン ハンドラーは、トークン ハンドラー コレクションに追加します。|  
+|[\<clear\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/clear.md)|すべてのセキュリティ トークン ハンドラー、トークン ハンドラーのコレクションを消去します。|  
+|[\<削除\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/remove.md)|セキュリティ トークン ハンドラーは、トークン ハンドラー コレクションから削除します。|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成、トークン ハンドラーのコレクションを提供します。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス ・ レベルの id の設定を指定します。|  
+  
+## 解説  
+ サービスの構成では、セキュリティ トークン ハンドラーの 1 つ以上の名前付きコレクションを指定できます。  使用してコレクションの名前を指定することができます、 `name`属性。  フレームワークの処理のみの名前は"ActAs"と"OnBehalfOf"です。  ハンドラーがコレクションに存在する場合は、セキュリティ トークン サービス \(STS\) の代わりに、既定のハンドラーを処理するとき使用されます`ActAs`と`OnBehalfOf`トークン。  
+  
+ 既定では、コレクションの次のハンドラーの種類を設定します。 <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler>、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>、 <xref:System.IdentityModel.Tokens.KerberosSecurityTokenHandler>、 <xref:System.IdentityModel.Tokens.WindowsUserNameSecurityTokenHandler>、 <xref:System.IdentityModel.Tokens.RsaSecurityTokenHandler>、 <xref:System.IdentityModel.Tokens.X509SecurityTokenHandler>、および<xref:System.IdentityModel.Tokens.EncryptedSecurityTokenHandler>。  使用してそのコレクションを変更することができます、 `<add>`、 `<remove>`、および`<clear>`の要素。  のみ、単一のハンドラーは特定の型のコレクション内に存在することを確認する必要があります。  ハンドラーから派生させる場合は、たとえば、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>は、クラス ハンドラーまたは、 <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>両方が、単一のコレクションに構成可能性があります。  
+  
+ 使用して、 `<securityTokenHandlerConfiguration>`コレクション内で、ハンドラーの構成設定を指定する要素。  この要素で指定された設定をオーバーライドするを通じてサービスに指定された、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素。  （いくつかの組み込みのハンドラーの種類を含む） いくつかのハンドラーは、子要素の追加の構成をサポートできる、 `<add>`要素。  ハンドラーで指定した設定は、コレクションまたはサービスで指定された同等の設定をオーバーライドします。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicecertificate.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicecertificate.md
new file mode 100644
index 00000000000..c65457631b0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicecertificate.md
@@ -0,0 +1,57 @@
+---
+title: "&lt;serviceCertificate&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42c7f291-2ec3-43c5-8872-35897ff3c660
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;serviceCertificate&gt;
+暗号化し、トークンを復号化に使用される X.509 証明書を構成します。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <serviceCertificate>  
+    </serviceCertificate>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<certificateReference\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/certificatereference.md)|検索して、証明書ストアの X.509 証明書を検証するために使用する設定を指定します。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)|構成設定を含む、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\)。|  
+  
+## 使用例  
+ \<serviceCertificate\> の使用、次の XML を示しています。 要素。  XML から取得されます、 `CustomToken`サンプル。  
+  
+```  
+<serviceCertificate>  
+  <certificateReference x509FindType="FindBySubjectName" findValue="localhost" storeLocation="LocalMachine" storeName="My"/>  
+</serviceCertificate>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicetokenresolver.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicetokenresolver.md
new file mode 100644
index 00000000000..bd3c5bdf556
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/servicetokenresolver.md
@@ -0,0 +1,66 @@
+---
+title: "&lt;serviceTokenResolver&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6e9001e1-e064-4f47-84b2-46225c177746
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;serviceTokenResolver&gt;
+ハンドラーで、トークン ハンドラー コレクションにより使用されるサービス トークン リゾルバーを登録します。  サービス トークン リゾルバーを使用すると、受信トークンとメッセージの暗号化トークンを解決します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration>  
+        <serviceTokenResolver type=xs:string>  
+        </serviceTokenResolver>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|サービス トークン リゾルバーの種類を指定します。  一方、 <xref:System.IdentityModel.Selectors.SecurityTokenResolver>型または派生型、 <xref:System.IdentityModel.Selectors.SecurityTokenResolver>クラス。  指定する方法の詳細については、 `type`属性は、 [Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。  必ず指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|構成コレクションのセキュリティ トークン ハンドラーを提供します。|  
+  
+## 解説  
+ 受信トークンとメッセージの暗号化トークンを解決するには、サービス トークン リゾルバーを使用できます。  これは、着信トークンを復号化に使用するキーを取得するために使用されます。  指定する必要があります、 `type`属性。  指定された型はいずれかになります<xref:System.IdentityModel.Selectors.SecurityTokenResolver>またはから派生するカスタム型は<xref:System.IdentityModel.Selectors.SecurityTokenResolver>クラス。  
+  
+ 一部トークン ハンドラー構成でサービス トークン リゾルバーの設定を指定することができます。  指定されたセキュリティ トークン ハンドラー コレクションで個々 のトークン ハンドラーの設定をオーバーライドします。  
+  
+> [!NOTE]
+>  指定する、 `<serviceTokenResolver>`要素の子要素として、 [\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)要素は推奨されていませんが、旧バージョンとの互換性のためのサポートもします。  設定で、 `<securityTokenHandlerConfiguration>`要素無効もに、 `<identityConfiguration>`要素。  
+  
+## 使用例  
+  
+```  
+<serviceTokenResolver type="MyNamespace.CustomTokenResolver, MyAssembly" />  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md
new file mode 100644
index 00000000000..e060205190d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md
@@ -0,0 +1,65 @@
+---
+title: "&lt;sessionSecurityTokenCache&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d43e676c-0153-485c-ab31-0257a2db7507
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;sessionSecurityTokenCache&gt;
+セッション トークンをキャッシュ サービスとセキュリティ トークン ハンドラーのコレクションを登録します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <caches>  
+      <sessionSecurityTokenCache type=xs:string>  
+      </sessionSecurityTokenCache>  
+    </caches>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生した型は<xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>クラス。  ユーザー設定を指定する方法の詳細については`type`を参照してください[Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<キャッシュ\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md)|サービス、セキュリティ トークン ハンドラーのコレクションを使用して、キャッシュを登録します。|  
+  
+## 使用例  
+ 次の XML は、セッションのセキュリティ トークンを保持して、カスタム キャッシュの構成を示しています \(<xref:System.IdentityModel.Tokens.SessionSecurityToken>\)。  構成から取得されます、 `ClaimsAwareWebFarm`サンプル。  このサンプルの詳細についてを参照してください[WIF コード サンプル インデックス](../../../../../docs/framework/security/wif-code-sample-index.md)。  
+  
+```  
+<caches>  
+  <sessionSecurityTokenCache type="CacheLibrary.SharedSessionSecurityTokenCache, CacheLibrary">  
+    <!--cacheServiceAddress points to the centralized session security token cache service running in the web farm.-->  
+    <cacheServiceAddress url="http://localhost:4161/SessionSecurityTokenCacheService.svc" />  
+  </sessionSecurityTokenCache>  
+</caches>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessiontokenrequirement.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessiontokenrequirement.md
new file mode 100644
index 00000000000..07693dcc1e9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/sessiontokenrequirement.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;sessionTokenRequirement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 496a1735-cbb7-49d5-a6aa-dd5550462073
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# &lt;sessionTokenRequirement&gt;
+<xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler> クラスまたは派生クラスにコンフィギュレーションを提供します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel">  
+        <sessionTokenRequirement lifetime=TimeSpan >  
+        </sessionTokenRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|有効期間|セッションのトークンの有効期間を指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md)|たとえば、ハンドラーのグループに指定セキュリティのトークン ハンドラーを追加します。|  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel">           
+    <sessionTokenRequirement lifetime="10:00" />  
+</add>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md
new file mode 100644
index 00000000000..6225d451675
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;system.identityModel.services&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa1624dd-2d74-4ae3-942e-498cee261ac5
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# &lt;system.identityModel.services&gt;
+Ws\-federation プロトコルを使用して、認証用の構成セクション。  
+  
+ \<system.identityModel.services\>  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration name=xs:string identityConfigurationName=xs:string>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)|構成設定を含む、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\) の HTTP モジュール。|  
+  
+### 親要素  
+ なし  
+  
+## 解説  
+ 追加、 `<system.identityModel.services>` SAM および WSFAM の設定を提供するために、アプリケーションの構成ファイルを追加します。  
+  
+> [!IMPORTANT]
+>  使用すると、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermission>や、 <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute>コード、要求の承認マネージャー内のクレームに基づくアクセス制御を提供するクラス \(<xref:System.Security.Claims.ClaimsAuthorizationManager>\) と承認を決定するために使用するポリシーを構成、 `<identityConfiguration>`から暗黙的または明示的に参照される要素が`<federationConfiguration>`このセクション内の要素。  詳細についてを参照してください、 **備考**で、 [\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)要素。  
+  
+ `<system.identityModel.services>`セクションで表される、 <xref:System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection>クラス。  コレクションの子`<federationConfiguration>` 、セクション内の構成要素で表される、 <xref:System.IdentityModel.Services.Configuration.FederationConfigurationElementCollection>クラス。  
+  
+## 使用例  
+ 次の XML を追加する方法を示しています、 `<system.identityModel.services>`するには、構成ファイルのセクション。  最初セクション宣言の両方を追加する必要があります、 `<system.identityModel.services>`セクションと、 `<system.identityModel>`セクション。  \(を追加したとき、 `<system.identityModel.services>`セクションでは、する必要がありますも追加すると、宣言を`<system.identityModel>`デフォルトようにするセクション`<identityConfiguration>`セクション必要がある場合は、ランタイムで作成できます\)。宣言セクションを追加した後は、統合認証の設定\] を構成できます、 `<system.identityModel.services>`要素。  
+  
+```  
+<configuration>  
+  <configSections>  
+    <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+    <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+  </configSections>  
+  
+  <!-- Additional elements (not shown) -->  
+  
+  <system.identityModel.services>  
+    <federationConfiguration>  
+      <wsFederation passiveRedirectEnabled="true"   
+        issuer="http://localhost:15839/wsFederationSTS/Issue"   
+        realm="http://localhost:50969/" reply="http://localhost:50969/"   
+        requireHttps="false"   
+        signOutReply="http://localhost:50969/SignedOutPage.html"   
+        signOutQueryString="Param1=value2&Param2=value2"   
+        persistentCookiesOnPassiveRedirects="true" />  
+      <cookieHandler requireSsl="false" />  
+    </federationConfiguration>  
+  </system.identityModel.services>  
+  
+</configuration>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md
new file mode 100644
index 00000000000..f7228fff121
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md
@@ -0,0 +1,84 @@
+---
+title: "&lt;system.identityModel&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 210ce7e9-d07b-400c-800f-5f525dcf95e8
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;system.identityModel&gt;
+アプリケーションでんだ Windows アイデンティティ基盤 \(ぜ\) オプションを有効にする構成を提供します。  
+  
+ \<system.identityModel\>  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス ・ レベルの id の設定を指定します。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|`<configuration>`|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 解説  
+ 追加、 `<system.identityModel>`してたんだ Windows アイデンティティ基盤 \(ぜ\) を使用するアプリケーション、サービスを構成するには、構成ファイルのセクション。  `<system.identityModel>`要素で表される、 <xref:System.IdentityModel.Configuration.SystemIdentityModelSection>クラス。  
+  
+## 使用例  
+ 追加する方法の例を示します、 `<system.identityModel>`するには、構成ファイルのセクション。  構成セクションと名前空間の宣言でを最初に追加する必要があります、 `<configSections>`要素。  追加することができ、 `<system.IdentityModel>` 1 つまたは複数の識別情報の構成を指定するのには、構成ファイルの要素。  
+  
+```  
+<configuration>  
+  <configSections>  
+    <!--WIF 4.5 sections -->  
+    <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>  
+    <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>  
+  </configSections>  
+  
+  ...  
+  
+  <system.identityModel>  
+    <identityConfiguration>  
+      <audienceUris>  
+        <add value="http://localhost/WebApplication1/" />  
+      </audienceUris>  
+      <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089">  
+        <trustedIssuers>  
+          <add thumbprint="313D3B … 9106A9EC" name="SelfSTS" />  
+        </trustedIssuers>  
+      </issuerNameRegistry>  
+      <certificateValidation certificateValidationMode="None"/>  
+    </identityConfiguration>  
+  </system.identityModel>  
+  
+  ...  
+  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Configuration.SystemIdentityModelSection>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md
new file mode 100644
index 00000000000..08f66de532a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md
@@ -0,0 +1,67 @@
+---
+title: "&lt;tokenReplayCache&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1572ab23-6933-41b5-bfb4-0c4548145500
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;tokenReplayCache&gt;
+サービスまたはセキュリティ トークン ハンドラーのコレクションを再生のトークン キャッシュを登録します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <caches>  
+      <tokenReplayCache type=xs:string>  
+      </tokenReplayCache>  
+    </caches>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|type|派生した型は<xref:System.IdentityModel.Tokens.TokenReplayCache>クラス。  ユーザー設定を指定する方法の詳細については`type`を参照してください[Custom Type References](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_CustomTypeReferences)。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<キャッシュ\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/caches.md)|サービス、セキュリティ トークン ハンドラーのコレクションを使用して、キャッシュを登録します。|  
+  
+## 解説  
+ トークンの再実行キャッシュを使用すると、再生されたトークンを検出します。  トークンのリプレイ検出を有効にして、 [\<tokenReplayDetection\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md)要素は、また、最大有効期間トークンを指定します。  
+  
+## 使用例  
+ 次の XML は、再生されたトークンを検出するためには、カスタムのキャッシュの構成を示しています。  
+  
+```  
+<caches>  
+  <tokenReplayCache type="MyCacheLibrary.MyTokenReplayCache, MyCacheLibrary">  
+  </tokenReplayCache>  
+</caches>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.TokenReplayCache>   
+ [\<tokenReplayDetection\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md
new file mode 100644
index 00000000000..ed9133f0bec
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaydetection.md
@@ -0,0 +1,58 @@
+---
+title: "&lt;tokenReplayDetection&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac3f588e-5f75-4275-b969-2d492ecc3b47
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# &lt;tokenReplayDetection&gt;
+トークン リプレイ検出を有効にし、トークンの有効期限を指定します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <tokenReplayDetection enabled=xs:boolean expirationPeriod=TimeSpan>  
+    </tokenReplayDetection>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 型  
+ <xref:System.IdentityModel.Configuration.TokenReplayDetectionElement>  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|enabled|トークン リプレイ検出が有効かどうかを指定する値; 「true」トークン リプレイ検出を有効にします。|  
+|expirationPeriod|<xref:System.TimeSpan> 項目がキャッシュから切らされ、削除されたと見なされる前に時間の最大サイズを指定します。  <xref:System.TimeSpan> 値を指定する方法の詳細については、 " " を参照してください。 [Timespan Values](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md#BKMK_TimespanValues)|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<identityConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md)|サービス レベルの ID の設定を指定します。|  
+|[\<securityTokenHandlerConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md)|セキュリティ トークン ハンドラーの収集の構成を提供します。|  
+  
+## 解説  
+ `<tokenReplayDetection>` の要素は `<identityConfiguration>` 要素の下のまたは `<securityTokenHandlerConfiguration>` 要素の下のセキュリティ トークン ハンドラー コレクション レベル サービス レベルで指定できます。  サービスで指定されたトークン ハンドラー コレクションの設定によってオーバーライドされます。  
+  
+ トークン再生のキャッシュの種類は、要素で [\<tokenReplayCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md) 指定されます。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md
new file mode 100644
index 00000000000..7bea2fd09ed
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/trustedissuers.md
@@ -0,0 +1,80 @@
+---
+title: "&lt;trustedIssuers&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d818c917-07b4-40db-9801-8676561859fd
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# &lt;trustedIssuers&gt;
+構成ベースの発行者名レジストリで使用される信頼された発行者の証明書の一覧を構成する \(<xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>\)。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <securityTokenHandlerConfiguration>  
+        <issuerNameRegistry>  
+          <trustedIssuers>  
+            <add thumbprint=xs:string name=xs:string>  
+            <clear>  
+            <remove thumbprint=xs:string>  
+          </trustedIssuers>  
+        </issuerNameRegistry>  
+      </securityTokenHandlerConfiguration>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|`<add thumbprint=xs:string name=xs:string>`|証明書を信頼された発行元のコレクションに追加します。  証明書が指定されて、 `thumbprint`属性。  この属性は必須であり、証明書の拇印の ASN.1 のエンコード形式が含まれている必要があります。  `name`属性はオプションであり、証明書のフレンドリ名を指定するのに使用できます。|  
+|`<clear>`|すべての証明書を信頼された発行元のコレクションから削除します。|  
+|`<remove thumbprint=xs:string>`|証明書は、信頼できる発行元のコレクションから削除します。  証明書が指定されて、 `thumbprint`属性。  この属性は必須です。|  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<issuerNameRegistry\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/issuernameregistry.md)|発行者名レジストリを構成します。 **Important:**  `type`属性の`<issuerNameRegistry>`要素を参照するには、する必要があります、 <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>のクラス、 `<trustedIssuers>`要素が有効であること。|  
+  
+## 解説  
+ たんだ Windows アイデンティティ基盤 \(ぜ\) の単一の実装を提供する、 <xref:System.IdentityModel.Tokens.IssuerNameRegistry>クラス ボックスのアウト、 <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>クラス。  構成の発行者名レジストリ構成から読み込まれる信頼された発行者の一覧を維持します。  一覧では、各発行者名、発行者によって作成されたトークンの署名を確認するために必要な X.509 証明書が関連付けられます。  信頼された発行者の証明書の一覧で指定される、 `<trustedIssuers>`要素。  リスト内の各要素はその発行者によって作成されたトークンの署名を確認するために必要な X.509 証明書、ニーモニックの発行者名を関連付けます。  証明書は、ASN.1 エンコード形式の証明書の拇印を指定して、コレクションを使用して追加の信頼`<add>`要素。  オフにしたり、発行者 \(証明書\) を使用して、一覧からの削除、 `<clear>`と`<remove>`の要素。  
+  
+ `type`属性の`<issuerNameRegistry>`要素を参照するには、する必要があります、 <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>のクラス、 `<trustedIssuers>`要素が有効であること。  
+  
+## 使用例  
+ 次の XML 名のレジストリをベースの構成の発行者を指定する方法を示します。  
+  
+```  
+<issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+  <trustedIssuers>  
+    <add thumbprint="9B74CB2F32 … B1DC01EF40D0" name="LocalSTS" />  
+  </trustedIssuers>  
+</issuerNameRegistry>  
+  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry>   
+ <xref:System.IdentityModel.Tokens.IssuerNameRegistry>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/usernamesecuritytokenhandlerrequirement.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/usernamesecuritytokenhandlerrequirement.md
new file mode 100644
index 00000000000..796fc815fd8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/usernamesecuritytokenhandlerrequirement.md
@@ -0,0 +1,63 @@
+---
+title: "&lt;userNameSecurityTokenHandlerRequirement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ec3bac1-b014-49ae-843c-c54518cb709a
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# &lt;userNameSecurityTokenHandlerRequirement&gt;
+<xref:System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler> クラスまたは派生クラスにコンフィギュレーションを提供します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add type="System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler, System.IdentityModel.Services">  
+        <userNameSecurityTokenHandlerRequirement membershipProviderName=xs:string >  
+        </userNameSecurityTokenHandlerRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|membershipProviderName|セキュリティのトークン ハンドラーで使用される <xref:System.Web.Security.MembershipProvider> を指定します。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md)|たとえば、ハンドラーのグループに指定セキュリティのトークン ハンドラーを追加します。|  
+  
+## 解説  
+ <xref:System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler> のオブジェクトを構成から開始されるときに `<userNameSecurityTokenHandlerRequirement>` の要素セット <xref:System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler.MembershipProvider%2A> のプロパティ。  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Services.Tokens.MembershipUserNameSecurityTokenHandler, System.IdentityModel.Services">  
+    <userNameSecurityTokenHandlerRequirement membershipProviderName="AspNetSqlProvider/>  
+</add>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/wsfederation.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/wsfederation.md
new file mode 100644
index 00000000000..1c12f86f11e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/wsfederation.md
@@ -0,0 +1,105 @@
+---
+title: "&lt;wsFederation&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c537f770-68bd-4f82-96ad-6424ad91369f
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# &lt;wsFederation&gt;
+構成を提供、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\)。  
+  
+## 構文  
+  
+```  
+<system.identityModel.services>  
+  <federationConfiguration>  
+    <wsFederation authenticationType=xs:string (URI)  
+        freshness=xs:decimal  
+        homerealm=xs:string (URI)  
+        issuer=xs:string (URI)  
+        persistentCookiesOnPassiveRedirects=xs:boolean  
+        passiveRedirectEnabled=xs:boolean  
+        policy=xs:string (URI)  
+        realm=xs:string (URI)  
+        reply=xs:string (URI)  
+        request=xs:string (URI)  
+        requestPtr=xs:string (URI)  
+        requireHttps=xs:boolean  
+        resource=xs:string (URI)  
+        signInQueryString=xs:string  
+        signOutQueryString=xs:string  
+        signOutReply=xs:string (URL)  
+    </wsFederation>  
+  </federationConfiguration>  
+</system.identityModel.services>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|Description|  
+|--------|-----------------|  
+|authenticationType|認証の種類を指定する URI。  WS フェデレーションのサインイン要求の wauth パラメーターを設定します。  省略可能です。  既定値は、wauth パラメーターが要求に含まれていないを指定します。 空の文字列です。|  
+|最新状態に維持|認証要求を目的の最大年齢 \(分単位\)。  WS フェデレーションのサインイン要求の wfresh パラメーターを設定します。  省略可能です。  既定値は 0 です。  省略可能です。 **Warning:**  次のリリースで。NET Framework 4.5 は、 `freshness`属性の種類が`xs:string`とその既定値は`null`。|  
+|homeRealm|ホーム ・ レルムの認証に使用する id プロバイダー \(IP\)。  WS フェデレーション サインイン要求の whr パラメーターを設定します。  省略可能です。  Whr パラメーターが要求に含まれていないことを指定します。 空の文字列が省略されます。|  
+|issuer|目的のトークン発行者の URI を指定します。  要求の基本 URL の Ws\-federation サインインとサインアウトの要求のために必要なに設定します。|  
+|persistentCookiesOnPassiveRedirects|認証の永続的な cookie が発行されたかどうかを指定します。  省略可能です。  既定値は"false"が、cookie が発行されませんでした。|  
+|passiveRedirectEnabled|WSFAM は、STS に認証されていない要求を自動的にリダイレクトできるかどうかを指定します。  省略可能です。  既定値は"true"が、認証されていない要求を自動的にリダイレクトされます。|  
+|policy|サインイン要求で使用する、関連するポリシーの場所を指定します。 URL を指定します。  既定値は空の文字列です。  WS フェデレーション サインイン要求の wp のパラメーターを設定します。  省略可能です。  既定値は、wp のパラメーター要求に含まれていないことを指定します。 空の文字列です。|  
+|realm|要求元の領域の URI。  \(依存元の相手 \(RP\) が、セキュリティ トークン サービス \(STS\) を識別する URI です。\)要求 wtrealm Ws\-federation サインイン要求のパラメーターを設定します。  必ず指定します。|  
+|返信|依存元パーティ \(RP\) が、セキュリティ トークン サービス \(STS から\) の返信を受信したいアドレスを識別する URL を指定します。  WS フェデレーションのサインイン要求の wreply パラメーターを設定します。  省略可能です。  既定値は、wreply パラメーターが要求に含まれていないを指定します。 空の文字列です。|  
+|要求|トークンの発行要求します。  WS フェデレーションのサインイン要求の wreq パラメーターを設定します。  省略可能です。  既定値は、wreq パラメーターが要求に含まれていないを指定します。 空の文字列です。  STS は、トークンを発行するのにはどのような知っている、wreq または wreqptr パラメーター内の要求を含まないを意味します。|  
+|requestPtr|トークン発行要求の場所を指定します。 URL を指定します。  要求の wreqptr パラメーターを設定します。  省略可能です。  既定値は、wreqptr パラメーターが要求に含まれていないを指定します。 空の文字列です。  STS は、トークンを発行するのにはどのような知っている、wreq または wreqptr パラメーター内の要求を含まないを意味します。|  
+|requireHttps|セキュリティ トークン サービス \(STS\) との通信が HTTPS プロトコルを使用する必要があるかどうかを指定します。  省略可能です。  既定値は"true"は、HTTPS を使用する必要があります。|  
+|リソース|アクセスして、リソース、依存元の相手 \(RP\) を識別する URI、セキュリティ トークン サービス \(STS\) にします。  省略可能です。  WS フェデレーションのサインイン要求の wres パラメーターを設定します。  省略可能です。  既定値は、wres パラメーターが要求に含まれていないを指定します。 空の文字列です。 **Note:**  wres は、従来型のパラメーターです。  指定、 `realm` wtrealm パラメーターを代わりに使用する属性。|  
+|signInQueryString|WS フェデレーション サインイン要求の URL にクエリ パラメーターを定義するアプリケーションを指定するのには、機能拡張ポイントを提供します。  省略可能です。  既定値は、要求で追加のパラメーターを含めるしないことを指定します。 空の文字列です。  パラメーターは次の形式を使用してクエリ文字列のフラグメントとして指定されている: `“param1=value1&param2=value2&param3=value3”`といった。 **Note:**  構成ファイル内の ' &"は、エンティティ参照を使用して、クエリ文字列内の文字を指定する必要が`&`。|  
+|signOutQueryString|WS フェデレーション サインイン要求の URL にクエリ パラメーターを定義するアプリケーションを指定するのには、機能拡張ポイントを提供します。  省略可能です。  既定値は、要求で追加のパラメーターを含めるしないことを指定します。 空の文字列です。  パラメーターは次の形式を使用してクエリ文字列のフラグメントとして指定されている: `“param1=value1&param2=value2&param3=value3”`といった。 **Note:**  構成ファイル内の ' &"は、エンティティ参照を使用して、クエリ文字列内の文字を指定する必要が`&`。|  
+|signOutReply|パッシブ、Ws\-federation プロトコルをサインアウト時のセキュリティ トークン サービス \(STS\) にクライアントがリダイレクトする URL を指定します。  Ws\-federation サインアウト要求には、wreply パラメーターを設定します。  省略可能です。  既定値は、要求で追加のパラメーターを含めるしないことを指定します。 空の文字列です。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|Description|  
+|--------|-----------------|  
+|[\<federationConfiguration\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)|構成設定を含む、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WSFAM\) と、 <xref:System.IdentityModel.Services.SessionAuthenticationModule> \(SAM\)。|  
+  
+## 解説  
+ 使用できます、 `<wsFederation>` 、WSFAM の Ws\-federation パラメーターの既定値の設定および既定の動作を構成するのには。  WS フェデレーション パラメーターの設定\] で定義されている、 `<wsFederation>`要素によって公開されるのと同じプロパティを設定する、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule>クラス。  これらのプロパティを使用すると、WSFAM によって発行されるすべての要求を同じです。  WSFAM によって公開されるイベントのイベント ハンドラーを追加することにより処理要求の実行中に、Ws\-federation パラメーターを動的に変更できます。 例えば、 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.RedirectingToIdentityProvider>イベント。  詳細については、<xref:System.IdentityModel.Services.WSFederationAuthenticationModule> クラスのドキュメントを参照してください。  
+  
+ `<wsFederation>`要素で表される、 <xref:System.IdentityModel.Services.Configuration.WSFederationElement>クラス。  構成オブジェクトによって表される、 <xref:System.IdentityModel.Services.Configuration.WSFederationConfiguration>クラス。  1 つの<xref:System.IdentityModel.Services.Configuration.WSFederationConfiguration>インスタンスの設定には、 <xref:System.IdentityModel.Services.Configuration.FederationConfiguration>を通じてアクセスされるオブジェクト、 <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName>プロパティと構成、WSFAM を提供します。  
+  
+## 使用例  
+ 次の XML に示す、 `<wsFederation>` 、WSFAM の設定を指定する要素。  
+  
+> [!WARNING]
+>  この例では、WSFAM を HTTPS を使用する必要はありません。  これは、ためには、 `requireHttps`の属性、 `<wsFederation>`が要素を設定`false`。  セキュリティ上のリスクを提示可能性がありますようにこの設定ほとんどの運用環境でしないでください。  
+  
+```  
+<wsFederation passiveRedirectEnabled="true"   
+  issuer="http://localhost:15839/wsFederationSTS/Issue"   
+  realm="http://localhost:50969/"   
+  reply="http://localhost:50969/"   
+  requireHttps="false"   
+  signOutReply="http://localhost:50969/SignedOutPage.html"   
+  signOutQueryString="Param1=value2&Param2=value2"   
+  persistentCookiesOnPassiveRedirects="true" />  
+  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.WSFederationAuthenticationModule>   
+ <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-identity-foundation/x509securitytokenhandlerrequirement.md b/docs/framework/configure-apps/file-schema/windows-identity-foundation/x509securitytokenhandlerrequirement.md
new file mode 100644
index 00000000000..92ffa0369e9
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-identity-foundation/x509securitytokenhandlerrequirement.md
@@ -0,0 +1,72 @@
+---
+title: "&lt;x509SecurityTokenHandlerRequirement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aca22c2c-5ae7-42af-9bbd-15c2524692ce
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# &lt;x509SecurityTokenHandlerRequirement&gt;
+<xref:System.IdentityModel.Tokens.X509SecurityTokenHandler> クラスまたは派生クラスに必要なコンフィギュレーションを提供します。  
+  
+## 構文  
+  
+```  
+<system.identityModel>  
+  <identityConfiguration>  
+    <securityTokenHandlers>  
+      <add type="System.IdentityModel.Tokens.X509SecurityTokenHandler, System.IdentityModel">  
+        <x509SecurityTokenHandlerRequirement>  
+          mapToWindows=xs:boolean  
+          certificateValidationMode="None||ChainTrust||PeerTrust||PeerOrChainTrust||Custom"  
+          certificateValidator="Namespace.Class, Assembly"  
+          revocationMode="NoCheck||Offline||Online"  
+          trustedStoreLocation="CurrentUser||LocalMachine"  
+        </x509SecurityTokenHandlerRequirement>  
+      </add>  
+    </securityTokenHandlers>  
+  </identityConfiguration>  
+</system.identityModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|certificateValidationMode|X.509 証明書に使用する検証の方法を指定する <xref:System.ServiceModel.Security.X509CertificateValidationMode> の値。  既定値は、「」PeerOrChainTrust です。|  
+|mapToWindows|たとえば、ハンドラーが Windows アカウントに入力された UPN の要求の使用によって検証のトークンをマップするかどうかを指定します。  既定値は「false」です。|  
+|revocationMode|X.509 証明書に使用する破棄の方法を指定する <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> の値。  既定値は「オンライン」です。|  
+|trustedStoreLocation|X.509 証明書の店舗を指定する <xref:System.Security.Cryptography.X509Certificates.StoreLocation> の値。  既定値は、「」LocalMachine です。|  
+|certificateValidator|<xref:System.IdentityModel.Selectors.X509CertificateValidator>取得元の注文タイプ。  `certificateValidationMode` の属性をカスタム「」の場合、この型のインスタンスはフィールドの証明書の検証に使用されます。|  
+  
+### 子要素  
+ なし  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/add.md)|たとえば、ハンドラーのグループに指定セキュリティのトークン ハンドラーを追加します。|  
+  
+## 使用例  
+  
+```  
+<add type="System.IdentityModel.Tokens.X509SecurityTokenHandler, System.IdentityModel">  
+    <x509SecurityTokenHandlerRequirement mapToWindows="true"   
+                                         certificateValidationMode="PeerOrChainTrust"   
+                                         revocationMode="Online"   
+                                         trustedStoreLocation="LocalMachine" />  
+</add>  
+```
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/TOC.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/TOC.md
new file mode 100644
index 00000000000..b6a4508943b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/TOC.md
@@ -0,0 +1,46 @@
+# [<tracking>](tracking.md)
+# [<states>](states.md)
+# [<cancelRequestedQueries>](cancelrequestedqueries.md)
+# [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder](microsoft-visualstudio-activities-asr-clientactivitybuilder.md)
+# [<variables>](variables.md)
+# [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder.Build](microsoft-visualstudio-activities-asr-clientactivitybuilder-build.md)
+# [<etwTracking>](etwtracking.md)
+# [<activityScheduledQueries>](activityscheduledqueries.md)
+# [<activityStateQueries>](activitystatequeries.md)
+# [<workflowIdle>](workflowidle.md)
+# [<bufferReceive>](bufferreceive.md)
+# [<state>](state-of-states.md)
+# [<activityScheduledQuery>](activityscheduledquery.md)
+# [<states>](states-of-activitystatequery.md)
+# [<argument>](argument.md)
+# [<activityStateQuery>](activitystatequery.md)
+# [<channelSettings>](channelsettings.md)
+# [<workflowInstanceQuery>](workflowinstancequery.md)
+# [<bookmarkResumptionQueries>](bookmarkresumptionqueries.md)
+# [<cancelRequestedQuery>](cancelrequestedquery.md)
+# [<sqlWorkflowInstanceStore>](sqlworkflowinstancestore.md)
+# [Windows Workflow Foundation の構成スキーマ](index.md)
+# [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder..ctor](microsoft-visualstudio-activities-asr-clientactivitybuilder-ctor.md)
+# [<system.serviceModel>](system-servicemodel-of-workflow.md)
+# [<serviceBehaviors> の <behavior>](behavior-of-servicebehaviors-of-workflow.md)
+# [<workflowInstanceManagement>](workflowinstancemanagement.md)
+# [<state>](state.md)
+# [<workflowUnhandledException>](workflowunhandledexception.md)
+# [<participants>](participants.md)
+# [<workflow>](workflow.md)
+# [<serviceBehaviors>](servicebehaviors-of-workflow.md)
+# [クエリにおける注釈の使用](using-annotation-in-queries.md)
+# [<workflowInstanceQueries>](workflowinstancequeries.md)
+# [<faultPropagationQuery>](faultpropagationquery.md)
+# [<customTrackingQueries>](customtrackingqueries.md)
+# [<customTrackingQuery>](customtrackingquery.md)
+# [<variable>](variable.md)
+# [その他のマネージ参照](additional-managed-reference.md)
+# [<add>](add-of-participants.md)
+# [<behaviors>](behaviors-of-workflow.md)
+# [<sendMessageChannelCache>](sendmessagechannelcache.md)
+# [<bookmarkResumptionQuery>](bookmarkresumptionquery.md)
+# [<factorySettings>](factorysettings.md)
+# [<trackingProfile>](trackingprofile.md)
+# [<arguments>](arguments.md)
+# [<faultPropagationQueries>](faultpropagationqueries.md)
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledqueries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledqueries.md
new file mode 100644
index 00000000000..da7d79628bd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledqueries.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;activityScheduledQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: ca6e82f1-54f2-48d6-899c-9873065b5547
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;activityScheduledQueries&gt;
+親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用する、クエリのコレクションを表します。  アクティビティがスケジュールされたレコードを追跡参加要素が定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+     <trackingProfile name="Name">  
+       <workflow>  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+       </workflow>  
+     </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityScheduledQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md)|親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityScheduledQuery](assetId:///System.Activities.Tracking.ActivityScheduledQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md
new file mode 100644
index 00000000000..ef83b687e9d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;activityScheduledQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: a8bcd6d4-b389-4daf-86bf-1ade85fec114
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;activityScheduledQuery&gt;
+親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用する、クエリのコレクションを表します。  アクティビティがスケジュールされたレコードを追跡参加要素が定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+     <trackingProfile name="Name">  
+       <workflow>  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+       </workflow>  
+     </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|キャンセルを要求しているアクティビティの名前を指定する文字列。|  
+|childActivityName|キャンセルが要求された子アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityScheduledQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledquery.md)|親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用するクエリ。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityScheduledQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityScheduledQuery](assetId:///System.Activities.Tracking.ActivityScheduledQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequeries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequeries.md
new file mode 100644
index 00000000000..f88251897aa
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequeries.md
@@ -0,0 +1,69 @@
+---
+title: "&lt;activityStateQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: bdd3c8ae-a13f-4df1-9b3c-a9d6c4bb1b5f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;activityStateQueries&gt;
+ワークフロー インスタンスを構成するアクティビティのライフサイクルの変化を追跡するために使用する、クエリのコレクションを表します。  たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡することが必要な場合があります。  追跡参加要素がアクティビティ状態レコード オブジェクトを定期受信するには、このクエリが必要です。  定期受信可能な状態は ActivityStates で指定します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリ。 このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md
new file mode 100644
index 00000000000..329e7dc4bab
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md
@@ -0,0 +1,93 @@
+---
+title: "&lt;activityStateQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 9f8c3e4f-e2e3-4402-9760-03bf918ece7b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;activityStateQuery&gt;
+ワークフロー インスタンスを構成するアクティビティのライフサイクルの変化を追跡するために使用されるクエリを表します。  たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡することが必要な場合があります。  追跡参加要素がアクティビティ状態レコード オブジェクトを定期受信するには、このクエリが必要です。  定期受信可能な状態は ActivityStates で指定します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|<xref:System.Activities.Tracking.ActivityStateRecord> インスタンスをフィルターするために、アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md)|このアクティビティ クエリに関連付けられている引数のコレクション。|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素のコレクション。|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|このアクティビティ クエリに関連付けられている変数のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素の一覧を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ActivityStateQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/add-of-participants.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/add-of-participants.md
new file mode 100644
index 00000000000..c4778ef057a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/add-of-participants.md
@@ -0,0 +1,99 @@
+---
+title: "&lt;participants&gt; の &lt;add&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 3c730850-6f8e-4102-acb8-8effb4e09463
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;participants&gt; の &lt;add&gt;
+ランタイムから直接出力される追跡レコードをリッスンし、追跡レコードの構成方法に従って処理を行う追跡参加要素を構成します。  これには、特定の出力 \(ファイル、コンソール、ETW など\) への書き込み、レコードの処理や集計、またはその他の必要な組み合わせが含まれます。  
+  
+ ワークフロー追跡と追跡参加要素の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」と「[追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>   
+   <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+   </participants>   
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|要素|説明|  
+|--------|--------|  
+|name|追跡参加要素の名前を指定する文字列。|  
+|profileName|追跡参加要素が定期受信した追跡レコードを定義する、追跡プロファイルの名前を指定する文字列。|  
+|型|追跡参加要素の型を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|追跡参加要素の一覧|  
+  
+## 解説  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+ 複数の追跡参加要素が追跡イベントを同時に使用することができます。  各追跡参加要素は、それぞれ別の追跡プロファイルと関連付けることができます。  
+  
+ 追跡レコードを ETW セッションに書き込む、標準の追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、**\<diagnostics\>** セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、**profileName** 要素の **\<add\>** 属性で定義されます。  これらが定義されると、追跡参加要素は **\<etwTracking\>** サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.TrackingSection>   
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehavior>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/additional-managed-reference.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/additional-managed-reference.md
new file mode 100644
index 00000000000..9b55c650e01
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/additional-managed-reference.md
@@ -0,0 +1,21 @@
+---
+title: "その他のマネージ参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 453917f7-5fb9-4572-a681-853f80b2b7c5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# その他のマネージ参照
+このトピックでは、[Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md) クラスについて説明します。  
+  
+## このセクションの内容  
+ このクラスは wfd1 インフラストラクチャで使用され、ユーザーが呼び出すためのものではありません。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/argument.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/argument.md
new file mode 100644
index 00000000000..6fc818c6670
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/argument.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;argument&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: a7144d53-8023-4e90-971f-895e016fd58a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;argument&gt;
+アクティビティ状態クエリに関連付けられている引数を表す構成要素。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|この引数の名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md)|このアクティビティ クエリに関連付けられている引数のコレクション。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ArgumentElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ArgumentElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md
new file mode 100644
index 00000000000..44462b95985
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;arguments&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 0f327196-f468-4be3-b6c4-68ba981a1bd6
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;arguments&gt;
+アクティビティ状態クエリに関連付けられている引数のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<argument\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/argument.md)|アクティビティ状態クエリに関連付けられている引数。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.ArgumentElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.ArgumentElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md
new file mode 100644
index 00000000000..266ff3e6622
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md
@@ -0,0 +1,75 @@
+---
+title: "ワークフローの &lt;serviceBehaviors&gt; の &lt;behavior&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 6a4b718a-1b40-4957-935a-f6122819ab3c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ワークフローの &lt;serviceBehaviors&gt; の &lt;behavior&gt;
+**behavior** 要素には、サービスの動作設定のコレクションが含まれます。  各動作には、それぞれの **name** によってインデックスが付けられます。  サービスは、[\<endpoint\>](../../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md) 要素の **behaviorConfiguration** 属性を使用して、この名前で各動作にリンクできます。  これにより、設定を再定義することなく、エンドポイント間で共通の動作構成を共有できます。  
+  
+## 構文  
+  
+```  
+  
+<system.ServiceModel>  
+  <behaviors>  
+    <serviceBehaviors>  
+    <behavior name=String">  
+      <bufferReceive maxPendingMessagesPerChannel=”Integer” />  
+      <etwTracking profileName=”String” />  
+     <sendMessageChannelCache allowUnsafeCaching="Boolean" >          
+        <channelSettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+        <factorySettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+     </sendMessageChannelCache>  
+      <sqlWorkflowInstanceStore   
+          connectionStringName=”String”   
+          honstLockRenewalPeriod=”TimeSpan”  
+          instanceCompletionAction=”DeleteNothing/DeleteAll”  
+          instanceEncodingAction=”None/GZip”  
+          instanceLockedExceptionAction=”NoRetry/BasicRetry/AggressiveRetry”  
+          runnableInstancesDetectionPeriod=”TimeSpan” />  
+      <workflowIdle timeToPersist=”TimeSpan”  
+          timeToUnload=”TimeSpan” />  
+      <workflowUnhandledException action=”Abandon/AbandonAndSuspend/Cancel/Terminate” />  
+    </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|動作の構成名を含む一意の文字列。  この値は、要素の識別文字列として機能するため、一意のユーザー定義の文字列である必要があります。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bufferReceive\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bufferreceive.md)|サービスが、バッファーされた受信処理を使用するためのサービス動作。これにより、ワークフロー サービスは、順番を無視したメッセージを処理できます。|  
+|[\<routing\>](../../../../../docs/framework/configure-apps/file-schema/wcf/routing-of-servicebehavior.md)|<xref:System.Activities.Tracking.ETWTrackingParticipant> を使用した、サービスによる ETW 追跡の利用を可能にするサービス動作。|  
+|[\<sendMessageChannelCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md)|キャッシュの共有レベルのカスタマイズや、チャネル ファクトリ キャッシュの設定を可能にするほか、Send メッセージング アクティビティを使用してサービス エンドポイントにメッセージを送信するワークフローのチャネル キャッシュの設定も可能にするサービス動作。|  
+|[\<sqlWorkflowInstanceStore\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/sqlworkflowinstancestore.md)|ワークフロー サービス インスタンスの状態情報の永続化を SQL Server 2005 または SQL Server 2008 データベースでサポートする <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 機能を構成するためのサービス動作。|  
+|[\<workflowIdle\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowidle.md)|アイドル状態のワークフロー インスタンスのアンロードおよび永続化のタイミングを制御するサービス動作。|  
+|[\<workflowInstanceManagement\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancemanagement.md)|ワークフロー インスタンスの実行方法を制御する設定を指定するためのサービス動作。これには、永続する未処理の例外動作やアイドル状態の動作が含まれます。|  
+|[\<workflowUnhandledException\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowunhandledexception.md)|ワークフロー サービス内で未処理の例外が発生した場合のアクションを指定するためのサービス動作。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/servicebehaviors-of-workflow.md)|サービス動作要素のコレクション。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behaviors-of-workflow.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behaviors-of-workflow.md
new file mode 100644
index 00000000000..0ba179a013e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/behaviors-of-workflow.md
@@ -0,0 +1,54 @@
+---
+title: "ワークフローの &lt;behaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 3c6017b6-0c4f-4192-bd67-9515f5d1ec82
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# ワークフローの &lt;behaviors&gt;
+この要素には、**serviceBehaviors** コレクションが含まれています。  コレクション内の各要素は、ワークフロー サービスによって使用されるそれぞれの動作要素を定義します。  各動作要素は、その一意の **name** 属性で識別されます。  
+  
+ \<system.ServiceModel\>  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+   <serviceBehaviors>  
+   </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/servicebehaviors-of-workflow.md)|この構成セクションは、特定のワークフロー サービスに対して定義されたすべての動作を表します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)|すべてのワークフロー構成要素のルート要素。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BehaviorsSection>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElement>   
+ [動作を使用したランタイムの構成と拡張](../../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md
new file mode 100644
index 00000000000..1d13f80e47e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;bookmarkResumptionQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 8ed61a7f-4254-439c-bdd8-b474971533f7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;bookmarkResumptionQueries&gt;
+ワークフロー インスタンス内のブックマークの再開を追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bookmarkResumptionQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionquery.md)|ワークフロー インスタンス内のブックマークの再開を追跡するために使用されるクエリ。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.BookmarkResumptionQuery](assetId:///System.Activities.Tracking.BookmarkResumptionQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionquery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionquery.md
new file mode 100644
index 00000000000..66f35000084
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionquery.md
@@ -0,0 +1,60 @@
+---
+title: "&lt;bookmarkResumptionQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 226de75d-d25c-48d5-b069-4b7d80a6852b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;bookmarkResumptionQuery&gt;
+ワークフロー インスタンス内のブックマークの再開を追跡するために使用されるクエリを表します。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|定期受信するブックマーク レコードの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<bookmarkResumptionQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md)|ワークフロー インスタンス内のブックマークの再開を追跡するために使用する、クエリのコレクションを表します。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.BookmarkResumptionQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.BookmarkResumptionQuery](assetId:///System.Activities.Tracking.BookmarkResumptionQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bufferreceive.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bufferreceive.md
new file mode 100644
index 00000000000..b2cb0238fc0
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/bufferreceive.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;bufferReceive&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: b23c3a54-10d4-4f13-ab6d-98b26b76f22a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;bufferReceive&gt;
+サービスが、バッファーされた受信処理を使用するためのサービス動作。これにより、ワークフロー サービスは、順番を無視したメッセージを処理できます。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <bufferReceive maxPendingMessagesPerChannel=”Integer” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|maxPendingMessagesPerChannel|各チャネルで許容される保留状態のメッセージの最大数を指定する整数。  既定値は 512 です。  このプロパティは、ワークフロー サービスで受信できる、順番を無視したメッセージの数を制限します。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.BufferReceiveServiceBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.BufferedReceiveElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedqueries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedqueries.md
new file mode 100644
index 00000000000..1ab220f65ad
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedqueries.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;cancelRequestedQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: eab5af7e-76fa-434d-9d36-873e995cee05
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;cancelRequestedQueries&gt;
+親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する、クエリのコレクションを表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<cancelRequestedQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CancelRequestQuery](assetId:///System.Activities.Tracking.CancelRequestQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedquery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedquery.md
new file mode 100644
index 00000000000..e04fe792e37
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedquery.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;cancelRequestedQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 8da9b1c4-338a-4f23-9830-6d257772d340
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;cancelRequestedQuery&gt;
+親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用するクエリを表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|キャンセルを要求しているアクティビティの名前を指定する文字列。|  
+|childActivityName|キャンセルが要求された子アクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素の一覧を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CancelRequestQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CancelRequestedQuery](assetId:///System.Activities.Tracking.CancelRequestedQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/channelsettings.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/channelsettings.md
new file mode 100644
index 00000000000..e4d5ea1f31a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/channelsettings.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;channelSettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 94a4457f-f43f-458d-a47e-2d11103ee75e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;channelSettings&gt;
+チャネル キャッシュの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+       <sendMessageChannelCache allowUnsafeCaching="Boolean" >          
+           <channelSettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+       </sendMessageChannelCache>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|idleTimeout|オブジェクトが破棄されるまでにキャッシュ内でアイドル状態を維持できる最大時間を指定する TimeSpan 値。|  
+|leaseTimeout|オブジェクトがキャッシュから削除されるまでの時間間隔を指定する TimeSpan 値。|  
+|maxItemsInCache|キャッシュに置くことができるオブジェクトの最大数を指定する整数。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<sendMessageChannelCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md)|キャッシュの共有レベルのカスタマイズや、チャネル ファクトリ キャッシュの設定を可能にするほか、Send メッセージング アクティビティを使用してサービス エンドポイントにメッセージを送信するワークフローのチャネル キャッシュの設定も可能にするサービス動作。|  
+  
+## 解説  
+ このサービス動作は、サービス エンドポイントにメッセージを送信するワークフローを対象としています。  これらのワークフローは、通常はクライアント ワークフローですが、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスである場合もあります。  
+  
+ 既定では、<xref:System.ServiceModel.WorkflowServiceHost> によってホストされるワークフローでは、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティが使用するキャッシュは <xref:System.ServiceModel.WorkflowServiceHost> のすべてのワークフロー インスタンス間で共有されます \(ホストレベルのキャッシュ\)。  <xref:System.ServiceModel.WorkflowServiceHost> によってホストされないクライアント ワークフローの場合、キャッシュを使用できるのはワークフロー インスタンスだけです \(インスタンスレベルのキャッシュ\)。  構成でエンドポイントが定義されているワークフローに送信アクティビティがある場合、キャッシュは既定で無効になります。  
+  
+ [!INCLUDE[crabout](../../../../../includes/crabout-md.md)] チャネル ファクトリおよびチャネル キャッシュの既定のキャッシュ共有レベルとキャッシュ設定を変更する方法については、「[Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)」を参照してください。  
+  
+## 使用例  
+ ホストされたワークフロー サービスでは、ファクトリ キャッシュとチャネル キャッシュの設定をアプリケーション構成ファイルで指定できます。  これを行うには、ファクトリ キャッシュおよびチャネル キャッシュのキャッシュ設定を含むサービス動作を追加し、そのサービス動作をサービスに追加します。  次の例は、カスタムのファクトリ キャッシュ設定およびチャネル キャッシュ設定が指定された **MyChannelCacheBehavior** サービス動作を含む構成ファイルの内容を示しています。  このサービス動作は、**behaviorConfiguarion** 属性を通じてサービスに追加されます。  
+  
+```  
+  
+<configuration>    
+  <system.serviceModel>  
+    <!-- List of other config sections here -->   
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="MyChannelCacheBehavior">  
+          <sendMessageChannelCache allowUnsafeCaching ="false" >  
+            <!-- Control only the host level settings -->   
+            <factorySettings maxItemsInCache = "8" idleTimeout = "00:05:00" leaseTimeout="10:00:00" />  
+            <channelSettings maxItemsInCache = "32" idleTimeout = "00:05:00" leaseTimeout="00:06:00" />  
+          </sendMessageChannelCache>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="MyService" behaviorConfiguration="MyChannelCacheBehavior" />  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.SendMessageChannelCache>   
+ <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement>   
+ <xref:System.ServiceModel.Activities.Send>   
+ <xref:System.ServiceModel.Activities.ChannelCacheSettings>   
+ [Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingqueries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingqueries.md
new file mode 100644
index 00000000000..ecdee8d78d4
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingqueries.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;customTrackingQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 4e9e732d-911d-45a3-a569-4b5e9cd1ffbe
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;customTrackingQueries&gt;
+コード アクティビティで定義するイベントを追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がカスタム追跡レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<customTrackingQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md)|コード アクティビティで定義するイベントを追跡するために使用するクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CustomTrackingQuery](assetId:///System.Activities.Tracking.CustomTrackingQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md
new file mode 100644
index 00000000000..3d1d1bba49a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;customTrackingQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 4e108e89-1132-46b7-868a-c7f5c69dc89f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;customTrackingQuery&gt;
+コード アクティビティで定義するイベントを追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がカスタム追跡レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|追跡レコードを生成したアクティビティの名前を指定する文字列。|  
+|name|生成されたカスタム追跡レコードの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<customTrackingQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingquery.md)|コード アクティビティで定義するイベントを追跡するために使用するクエリ。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.CustomTrackingQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.CustomTrackingQuery](assetId:///System.Activities.Tracking.CustomTrackingQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/etwtracking.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/etwtracking.md
new file mode 100644
index 00000000000..ac144a80d0d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/etwtracking.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;etwTracking&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: cb45c82e-6ea1-4c4d-924c-118a25ae1f35
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;etwTracking&gt;
+<xref:System.Activities.Tracking.ETWTrackingParticipant> を使用した、サービスによる ETW 追跡の利用を可能にするサービス動作。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <etwTracking profileName=”String” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|profileName|この動作に関連付けられた追跡プロファイルの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 解説  
+ サービスの動作構成に追加すると、この構成要素により、ワークフロー サービスの追跡参加要素が構成されます。  
+  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、**\<diagnostics\>** セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、**profileName** 要素の **\<add\>** 属性で定義されます。  これらが定義されると、追跡参加要素は **\<etwTracking\>** サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehaviorElement>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/factorysettings.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/factorysettings.md
new file mode 100644
index 00000000000..b77022a20d8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/factorysettings.md
@@ -0,0 +1,95 @@
+---
+title: "&lt;factorySettings&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 202aad17-1b8b-4c87-ad57-4ca5de18ed35
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;factorySettings&gt;
+チャネル ファクトリ キャッシュの設定を指定します。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+       <sendMessageChannelCache allowUnsafeCaching="Boolean" >          
+           <factorySettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+       </sendMessageChannelCache>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|idleTimeout|オブジェクトが破棄されるまでにキャッシュ内でアイドル状態を維持できる最大時間を指定する TimeSpan 値。|  
+|leaseTimeout|オブジェクトがキャッシュから削除されるまでの時間間隔を指定する TimeSpan 値。|  
+|maxItemsInCache|キャッシュに置くことができるオブジェクトの最大数を指定する整数。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<sendMessageChannelCache\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md)|キャッシュの共有レベルのカスタマイズや、チャネル ファクトリ キャッシュの設定を可能にするほか、Send メッセージング アクティビティを使用してサービス エンドポイントにメッセージを送信するワークフローのチャネル キャッシュの設定も可能にするサービス動作。|  
+  
+## 解説  
+ このサービス動作は、サービス エンドポイントにメッセージを送信するワークフローを対象としています。  これらのワークフローは、通常はクライアント ワークフローですが、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスである場合もあります。  
+  
+ 既定では、<xref:System.ServiceModel.WorkflowServiceHost> によってホストされるワークフローでは、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティが使用するキャッシュは <xref:System.ServiceModel.WorkflowServiceHost> のすべてのワークフロー インスタンス間で共有されます \(ホストレベルのキャッシュ\)。  <xref:System.ServiceModel.WorkflowServiceHost> によってホストされないクライアント ワークフローの場合、キャッシュを使用できるのはワークフロー インスタンスだけです \(インスタンスレベルのキャッシュ\)。  構成でエンドポイントが定義されているワークフローに送信アクティビティがある場合、キャッシュは既定で無効になります。  
+  
+ [!INCLUDE[crabout](../../../../../includes/crabout-md.md)] チャネル ファクトリおよびチャネル キャッシュの既定のキャッシュ共有レベルとキャッシュ設定を変更する方法については、「[Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)」を参照してください。  
+  
+## 使用例  
+ ホストされたワークフロー サービスでは、ファクトリ キャッシュとチャネル キャッシュの設定をアプリケーション構成ファイルで指定できます。  これを行うには、ファクトリ キャッシュおよびチャネル キャッシュのキャッシュ設定を含むサービス動作を追加し、そのサービス動作をサービスに追加します。  次の例は、カスタムのファクトリ キャッシュ設定およびチャネル キャッシュ設定が指定された **MyChannelCacheBehavior** サービス動作を含む構成ファイルの内容を示しています。  このサービス動作は、**behaviorConfiguarion** 属性を通じてサービスに追加されます。  
+  
+```  
+  
+<configuration>    
+  <system.serviceModel>  
+    <!-- List of other config sections here -->   
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="MyChannelCacheBehavior">  
+          <sendMessageChannelCache allowUnsafeCaching ="false" >  
+            <!-- Control only the host level settings -->   
+            <factorySettings maxItemsInCache = "8" idleTimeout = "00:05:00" leaseTimeout="10:00:00" />  
+            <channelSettings maxItemsInCache = "32" idleTimeout = "00:05:00" leaseTimeout="00:06:00" />  
+          </sendMessageChannelCache>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="MyService" behaviorConfiguration="MyChannelCacheBehavior" />  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.SendMessageChannelCache>   
+ <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement>   
+ <xref:System.ServiceModel.Activities.Send>   
+ <xref:System.ServiceModel.Activities.ChannelCacheSettings>   
+ [Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md
new file mode 100644
index 00000000000..d8d42214a4b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md
@@ -0,0 +1,61 @@
+---
+title: "&lt;faultPropagationQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 00ff90ae-ebe0-4c85-a93f-61557288d0a3
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;faultPropagationQueries&gt;
+1 つのアクティビティ内で発生するエラーの処理を追跡するために使用する、クエリのコレクションを表します。 このイベントは、FaultHandler がエラーを処理するたびに発生します。  1 つのアクティビティ内で発生したエラーの処理は、このようなクエリを使用して追跡する必要があります。  追跡参加要素がエラー伝達レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリ。 このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.FaultPropagationQuery](assetId:///System.Activities.Tracking.FaultPropagationQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md
new file mode 100644
index 00000000000..4cbd8ca4865
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationquery.md
@@ -0,0 +1,62 @@
+---
+title: "&lt;faultPropagationQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 4fb5c2b1-3dad-4eca-9c7f-3efb51899813
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;faultPropagationQuery&gt;
+1 つのアクティビティ内で発生するエラーの処理を追跡するために使用するクエリを表します。 このイベントは、FaultHandler がエラーを処理するたびに発生します。  1 つのアクティビティ内で発生したエラーの処理は、このようなクエリを使用して追跡する必要があります。  追跡参加要素がエラー伝達レコードを定期受信するには、このクエリが必要です。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityName|エラーを伝達したエラー ハンドラー アクティビティの名前を指定する文字列。  既定値は \* で、すべてのアクティビティについてエラー伝達レコードが返されることを示します。|  
+|faultHandlerActivityName|エラーの原因となったアクティビティの名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<faultPropagationQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用する、構成要素の一覧を表します。 このイベントは、FaultHandler がエラーを処理するたびに発生します。|  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.FaultPropagationQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.FaultPropagationQuery](assetId:///System.Activities.Tracking.FaultPropagationQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md
new file mode 100644
index 00000000000..b34af02f6a1
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/index.md
@@ -0,0 +1,24 @@
+---
+title: "Windows Workflow Foundation の構成スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 7ae70357-b150-4342-8f2a-d5eb6f9c6a0d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Windows Workflow Foundation の構成スキーマ
+[!INCLUDE[wf](../../../../../includes/wf-md.md)] の構成要素を使用して、ワークフロー アプリケーションを構成できます。  ワークフロー アプリケーションでは、追跡とトレースを構成できます。  追跡とトレースの詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」を参照してください。  ワークフロー サービスでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] の構成要素も使用できます。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の詳細については、「[WCF 構成スキーマ](../../../../../docs/framework/configure-apps/file-schema/wcf/index.md)」を参照してください。  
+  
+ 構成ファイルは XML として書式設定されているため、テキスト エディターを使用して手動で編集する場合は、XML について理解している必要があります。  理解しないで編集すると、XML 要素タグや属性が見つからないなどの問題が発生する可能性があります。  問題の原因は、XML 要素タグと属性が大文字と小文字を区別することによります。  
+  
+## このセクションの内容  
+ [\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/system-servicemodel-of-workflow.md)  
+ **ServiceModel** 要素について説明します。
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-build.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-build.md
new file mode 100644
index 00000000000..eed1ba1ef4f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-build.md
@@ -0,0 +1,36 @@
+---
+title: "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder.Build | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+apiname: 
+  - "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder.Build"
+apilocation: 
+  - "Microsoft.VisualStudio.Activities.dll"
+apitype: "Assembly"
+ms.assetid: d83033b0-a4cb-4d40-835e-5c1a176cde5b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder.Build
+ワークフロー アクティビティにデータを提供する <xref:System.Activities.ActivityBuilder> オブジェクトを作成および構成します。  
+  
+## 構文  
+  
+```csharp  
+public ActivityBuilder Build();  
+  
+```  
+  
+## 戻り値  
+ <xref:System.Activities.ActivityBuilder> オブジェクトを返します。  
+  
+## 参照  
+ [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-ctor.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-ctor.md
new file mode 100644
index 00000000000..a59ea03eb54
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-ctor.md
@@ -0,0 +1,48 @@
+---
+title: "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder..ctor | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+apiname: 
+  - "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder..ctor"
+apilocation: 
+  - "Microsoft.VisualStudio.Activities.dll"
+apitype: "Assembly"
+ms.assetid: 6b44b13c-7a23-4df2-8f9f-45e2b1430002
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder..ctor
+[Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md) クラスのインスタンスを作成します。  
+  
+## 構文  
+  
+```csharp  
+public ClientActivityBuilder(OperationDescription operationDescription, string configurationName, string proxyNamespace);  
+  
+```  
+  
+#### パラメーター  
+  
+## パラメーター値  
+ *operationDescription*  
+  
+ 操作名、戻り値の型、パラメーター情報など、生成されるワークフロー アクティビティで実行される操作を記述します。  このパラメーターの値には **null** を指定しないでください。  これは、メッセージ コントラクトを使用し、1 つのメッセージと共に引数を受け取る同期操作を示す必要があります。  これらの条件が満たされていない場合、このクラスのコンストラクターと他のメソッドを使用したランタイムの結果は未定義です。  
+  
+ *configurationName*  
+  
+ エンドポイント構成名を指定します。  このパラメーターの値は **null** または空にしないでください。  これらの条件が満たされていない場合、このクラスのコンストラクターと他のメソッドを使用したランタイムの結果は未定義です。  
+  
+ *proxyNamespace*  
+  
+ 操作のサービスの名前空間を指定します。  このパラメーターの値は **null** または空にしないでください。  これらの条件が満たされていない場合、このクラスのコンストラクターと他のメソッドを使用したランタイムの結果は未定義です。  
+  
+## 参照  
+ [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md
new file mode 100644
index 00000000000..a9aa244055c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder.md
@@ -0,0 +1,34 @@
+---
+title: "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+apiname: 
+  - "Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder"
+apilocation: 
+  - "Microsoft.VisualStudio.Activities.dll"
+apitype: "Assembly"
+ms.assetid: e7287d3f-59ee-448f-b7fe-b640508501a5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder
+このクラスを使用して、ワークフロー アクティビティにデータを提供する <xref:System.Activities.ActivityBuilder> オブジェクトを作成および構成します。  
+  
+## 構文  
+  
+```csharp  
+public class ClientActivityBuilder  
+  
+```  
+  
+## 参照  
+ [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder.Build](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-build.md)   
+ [Microsoft.VisualStudio.Activities.Asr.ClientActivityBuilder..ctor](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/microsoft-visualstudio-activities-asr-clientactivitybuilder-ctor.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md
new file mode 100644
index 00000000000..60884ef2a9a
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;participants&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 560dd0bb-f9fb-423c-8857-2101a3654b06
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# &lt;participants&gt;
+ランタイムから直接出力される追跡レコードをリッスンし、追跡レコードの構成方法に従って処理を行う追跡参加要素の一覧を構成します。  これには、特定の出力 \(ファイル、コンソール、ETW など\) への書き込み、レコードの処理や集計、またはその他の必要な組み合わせが含まれます。  
+  
+ ワークフロー追跡と追跡参加要素の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」と「[追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>   
+   <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+   </participants>   
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<add\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/add-of-participants.md)|追跡参加要素を処理するための設定が含まれます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<tracking\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md)|ワークフロー サービスの追跡設定を定義する構成セクションを表します。|  
+  
+## 解説  
+ 追跡参加要素は、ワークフローから生成される追跡データを取得し、それを別のメディアに保存するために使用します。  同様に、追跡レコードの後処理はすべて、追跡参加要素内でも実行できます。  
+  
+ 複数の追跡参加要素が追跡イベントを同時に使用することができます。  各追跡参加要素は、それぞれ別の追跡プロファイルと関連付けることができます。  
+  
+ 追跡レコードを ETW セッションに書き込む、標準の追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 使用例  
+ 次の構成例は、Web.config ファイルで構成されている標準の ETW 追跡参加要素を示します。  
+  
+ ETW 追跡参加要素が追跡レコードを ETW に書き込むために使用するプロバイダー ID は、**\<diagnostics\>** セクションで定義されます。  追跡参加要素には、その要素が定期受信した追跡レコードを指定するためのプロファイルが関連付けられています。  これは、**profileName** 要素の **\<add\>** 属性で定義されます。  これらが定義されると、追跡参加要素は **\<etwTracking\>** サービス動作に追加されます。  これにより、選択した追跡参加要素がワークフロー インスタンスの拡張機能に追加され、追跡レコードの受信が開始されます。  
+  
+```  
+  
+<configuration>   
+  <system.web>   
+    <compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"/>   
+  </system.web>   
+  <system.serviceModel>   
+    <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />                
+    <tracking>   
+      <participants>   
+        <add name="EtwTrackingParticipant"   
+             type="System.Activities.Tracking.EtwTrackingParticipant, System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"   
+             profileName="HealthMonitoring_Tracking_Profile"/>   
+      </participants>   
+    </tracking>   
+    <behaviors>   
+      <serviceBehaviors>   
+        <behavior>   
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>   
+      </serviceBehaviors>   
+    </behaviors>   
+  </system.serviceModel>   
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.TrackingSection>   
+ <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.EtwTrackingBehavior>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡参加要素](../../../../../docs/framework/windows-workflow-foundation//tracking-participants.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md
new file mode 100644
index 00000000000..dc7c32a1401
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sendmessagechannelcache.md
@@ -0,0 +1,97 @@
+---
+title: "&lt;sendMessageChannelCache&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 241e428e-5030-4b13-8a0a-69f05288d3d9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;sendMessageChannelCache&gt;
+キャッシュの共有レベルのカスタマイズや、チャネル ファクトリ キャッシュの設定を可能にするほか、Send メッセージング アクティビティを使用してサービス エンドポイントにメッセージを送信するワークフローのチャネル キャッシュの設定も可能にするサービス動作。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+       <sendMessageChannelCache allowUnsafeCaching="Boolean" >          
+           <channelSettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+           <factorySettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+       </sendMessageChannelCache>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|allowUnsafeCaching|キャッシュをオンにするかどうかを示すブール値。  ワークフロー サービスにカスタムのバインディングまたは動作がある場合は、キャッシュが安全性を損う可能性があるため、既定では無効になります。  ただし、キャッシュをオンにする場合は、このプロパティを **true** に設定します。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<channelSettings\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/channelsettings.md)|チャネル キャッシュの設定を指定します。|  
+|[\<factorySettings\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/factorysettings.md)|チャネル ファクトリ キャッシュの設定を指定します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 解説  
+ このサービス動作は、サービス エンドポイントにメッセージを送信するワークフローを対象としています。  これらのワークフローは、通常はクライアント ワークフローですが、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスである場合もあります。  
+  
+ 既定では、<xref:System.ServiceModel.WorkflowServiceHost> によってホストされるワークフローでは、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティが使用するキャッシュは <xref:System.ServiceModel.WorkflowServiceHost> のすべてのワークフロー インスタンス間で共有されます \(ホストレベルのキャッシュ\)。  <xref:System.ServiceModel.WorkflowServiceHost> によってホストされないクライアント ワークフローの場合、キャッシュを使用できるのはワークフロー インスタンスだけです \(インスタンスレベルのキャッシュ\)。  構成でエンドポイントが定義されているワークフローに送信アクティビティがある場合、キャッシュは既定で無効になります。  
+  
+ [!INCLUDE[crabout](../../../../../includes/crabout-md.md)] チャネル ファクトリおよびチャネル キャッシュの既定のキャッシュ共有レベルとキャッシュ設定を変更する方法については、「[Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)」を参照してください。  
+  
+## 使用例  
+ ホストされたワークフロー サービスでは、ファクトリ キャッシュとチャネル キャッシュの設定をアプリケーション構成ファイルで指定できます。  これを行うには、ファクトリ キャッシュおよびチャネル キャッシュのキャッシュ設定を含むサービス動作を追加し、そのサービス動作をサービスに追加します。  次の例は、カスタムのファクトリ キャッシュ設定およびチャネル キャッシュ設定が指定された **MyChannelCacheBehavior** サービス動作を含む構成ファイルの内容を示しています。  このサービス動作は、**behaviorConfiguarion** 属性を通じてサービスに追加されます。  
+  
+```  
+  
+<configuration>    
+  <system.serviceModel>  
+    <!-- List of other config sections here -->   
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="MyChannelCacheBehavior">  
+          <sendMessageChannelCache allowUnsafeCaching ="false" >  
+            <!-- Control only the host level settings -->   
+            <factorySettings maxItemsInCache = "8" idleTimeout = "00:05:00" leaseTimeout="10:00:00" />  
+            <channelSettings maxItemsInCache = "32" idleTimeout = "00:05:00" leaseTimeout="00:06:00" />  
+          </sendMessageChannelCache>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="MyService" behaviorConfiguration="MyChannelCacheBehavior" />  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.SendMessageChannelCache>   
+ <xref:System.ServiceModel.Activities.Configuration.SendMessageChannelCacheElement>   
+ <xref:System.ServiceModel.Activities.Send>   
+ [Send アクティビティのキャッシュ共有レベルの変更](../../../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/servicebehaviors-of-workflow.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/servicebehaviors-of-workflow.md
new file mode 100644
index 00000000000..abbd3105dcc
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/servicebehaviors-of-workflow.md
@@ -0,0 +1,23 @@
+---
+title: "ワークフローの &lt;serviceBehaviors&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 51aba42d-0674-4726-a313-af6ed3aaa8f2
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# ワークフローの &lt;serviceBehaviors&gt;
+この構成セクションは、特定のサービスに対して定義されたすべての動作を表します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElementCollection>   
+ <xref:System.ServiceModel.Configuration.ServiceBehaviorElement>   
+ [サービスのランタイム動作の指定](../../../../../docs/framework/wcf/specifying-service-run-time-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sqlworkflowinstancestore.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sqlworkflowinstancestore.md
new file mode 100644
index 00000000000..7ae51fc7b65
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/sqlworkflowinstancestore.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;sqlWorkflowInstanceStore&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 8a4e4214-fc51-4f4d-b968-0427c37a9520
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;sqlWorkflowInstanceStore&gt;
+ワークフロー サービス インスタンスの状態情報の永続化を SQL Server 2005 または SQL Server 2008 データベースでサポートする <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 機能を構成するためのサービス動作。  この機能の詳細については、「[SQL Workflow Instance Store](../../../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <sqlWorkflowInstanceStore   
+          connectionStringName=”String”   
+          honstLockRenewalPeriod=”TimeSpan”  
+          instanceCompletionAction=”DeleteNothing/DeleteAll”  
+          instanceEncodingAction=”None/GZip”  
+          instanceLockedExceptionAction=”NoRetry/BasicRetry/AggressiveRetry”  
+          runnableInstancesDetectionPeriod=”TimeSpan” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|connectionString|基になる永続性データベースへの接続に使用する接続文字列を含む文字列。|  
+|connectionStringName|データベース サーバーへの名前付き接続文字列を含む文字列。  名前付き接続文字列の例は "DefaultConnectionString" です。|  
+|honstLockRenewalPeriod|ホストがインスタンスのロックを更新するまでの時間を指定する Timespan 値。  指定した時間内にホストがロックを更新しない場合は、インスタンスのロックが解除され、他のホストがそのインスタンスを使用できるようになります。<br /><br /> ワークフローをアンロードすることは、同時に、永続化することも意味します。  この属性をゼロに設定した場合は、ワークフローがアイドル状態になった直後に、ワークフロー インスタンスが永続化され、アンロードされます。  この属性を TimeSpan.MaxValue に設定すると、アンロード操作を事実上、無効にします。  アイドル状態になったワークフロー インスタンスはアンロードされません。|  
+|instanceCompletionAction|ワークフロー インスタンス完了後にワークフロー インスタンス データを永続化ストアに保持するか、またはその時点で削除するかを指定する値。  この値は、<xref:System.Activities.DurableInstancing.InstanceCompletionAction> 型です。<br /><br /> 列挙されるアクションは、インスタンスがその操作を完了したとき、永続化ストアからインスタンス データを削除するかどうかで構成されます。<br /><br /> 完了後にインスタンスを保持すると、永続性データベースが急速に増大して、データベースのパフォーマンスに影響します。  データベースのパフォーマンスがパフォーマンス要件を満たすレベルになるように、これらのレコードを定期的に削除するパージ ポリシーを構成する必要があります。|  
+|instanceEncodingOption|インスタンス状態情報を永続化ストアに格納する前に、GZip アルゴリズムで圧縮するかどうかを指定する、省略可能な値。  この値は、<xref:System.Activities.DurableInstancing.InstanceEncodingAction> 型です。  このプロパティの値は、圧縮しない場合は "None"、インスタンス データを gzip アルゴリズムで圧縮する場合は "GZip" です。|  
+|instanceLockedExceptionAction|現在、他のホストにロックされているインスタンスをホストがロックしようとしたときにスローされる例外への応答として発生するアクションを指定する値。  この値は、<xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> 型です。<br /><br /> このフィールドで使用できるオプションは、None、Basic Retry、および Aggressive Retry です。  既定値は None です。  これら 3 つのオプションの説明を次に示します。<br /><br /> -   なし。  サービス ホストはインスタンスをロックしようとせず、<xref:System.Runtime.Persistence.InstanceLockedException> を呼び出し元に渡します。<br />-   基本的な再試行:  サービス ホストは一定の再試行間隔でインスタンスのロックを再試行し、シーケンスの最後に例外を呼び出し元に渡します。<br />-   積極的な再試行:  サービス ホストは指数関数的に増加する遅延を使用してインスタンスのロックを再試行し、シーケンスの最後に <xref:System.Runtime.Persistence.InstanceLockedException> を呼び出し元に渡します。|  
+|runnableInstancesDetectionPeriod||  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.SqlWorkflowInstanceStoreElement>   
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore>   
+ [SQL Workflow Instance Store](../../../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state-of-states.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state-of-states.md
new file mode 100644
index 00000000000..91e745603d5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state-of-states.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;states&gt; の &lt;state&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: ab483c7f-a091-4933-ba6b-708d96846d38
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;states&gt; の &lt;state&gt;
+追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|追跡レコードを生成する必要がある定期受信済みアクティビティの状態を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states-of-activitystatequery.md)|追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素のコレクション。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state.md
new file mode 100644
index 00000000000..378b036a60e
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/state.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;state&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 619414f2-61c2-4427-9977-d05009e343db
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;state&gt;
+追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクション。|  
+  
+## 解説  
+ 返されたレコードは、このコレクションの状態でフィルター処理されます。  
+  
+ 次の表に、有効な状態の値を示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|Aborted|ワークフロー インスタンスは中止されました。|  
+|Completed|ワークフロー インスタンスは完了しました。|  
+|Deleted|ワークフロー インスタンスは削除されました。|  
+|Idle|ワークフロー インスタンスはアイドル状態です。|  
+|Persisted|ワークフロー インスタンスは永続化されました。|  
+|Resumed|ワークフロー インスタンスが再開されました。|  
+|Started|ワークフロー インスタンスが開始されました。|  
+|UnhandledException|ワークフロー インスタンスで未処理の例外が発生しました。|  
+|アンロード|ワークフロー インスタンスはアンロードされました。|  
+|Canceled|ワークフロー インスタンスは取り消されました。|  
+|Suspended|ワークフロー インスタンスが中断されています。|  
+|Terminated|ワークフロー インスタンスは終了しました。|  
+|Unsuspended|ワークフロー インスタンスの中断が解除されました。|  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states-of-activitystatequery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states-of-activitystatequery.md
new file mode 100644
index 00000000000..749c4c2cd66
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states-of-activitystatequery.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;activityStateQuery&gt; の &lt;states&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: a7cc2018-2b79-44f1-825a-bb7ca08690a3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;activityStateQuery&gt; の &lt;states&gt;
+追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素のコレクション。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<state\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/state-of-states.md)|追跡レコードを生成する必要がある定期受信済みアクティビティの状態を含む構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md
new file mode 100644
index 00000000000..4aacc9108f5
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md
@@ -0,0 +1,101 @@
+---
+title: "&lt;states&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: ebea5e7c-ad58-43c5-8f2d-cca25ae1b721
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;states&gt;
+追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<state\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md)|開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡するクエリ。|  
+  
+## 解説  
+ 返されたレコードは、このコレクションの状態でフィルター処理されます。  
+  
+ 次の表に、有効な状態の値を示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|Aborted|ワークフロー インスタンスは中止されました。|  
+|Completed|ワークフロー インスタンスは完了しました。|  
+|Deleted|ワークフロー インスタンスは削除されました。|  
+|Idle|ワークフロー インスタンスはアイドル状態です。|  
+|Persisted|ワークフロー インスタンスは永続化されました。|  
+|Resumed|ワークフロー インスタンスが再開されました。|  
+|Started|ワークフロー インスタンスが開始されました。|  
+|UnhandledException|ワークフロー インスタンスで未処理の例外が発生しました。|  
+|アンロード|ワークフロー インスタンスはアンロードされました。|  
+|Canceled|ワークフロー インスタンスは取り消されました。|  
+|Suspended|ワークフロー インスタンスが中断されています。|  
+|Terminated|ワークフロー インスタンスは終了しました。|  
+|Unsuspended|ワークフロー インスタンスの中断が解除されました。|  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.StateElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/system-servicemodel-of-workflow.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/system-servicemodel-of-workflow.md
new file mode 100644
index 00000000000..e5dd9196590
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/system-servicemodel-of-workflow.md
@@ -0,0 +1,116 @@
+---
+title: "ワークフローの &lt;system.serviceModel&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 6a8eb2bf-f925-40e1-ba5c-a49b1d3a3ac6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ワークフローの &lt;system.serviceModel&gt;
+この構成セクションには、すべてのワークフロー構成要素が含まれます。  
+  
+## 構文  
+  
+```  
+  
+<system.ServiceModel>  
+  <behaviors>  
+    <serviceBehaviors>  
+    <behavior name="String">  
+      <bufferReceive maxPendingMessagesPerChannel=”Integer” />  
+      <etwTracking profileName="String" />  
+     <sendMessageChannelCache allowUnsafeCaching="Boolean" >          
+        <channelSettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+        <factorySettings idleTimeout="TimeSpan" leaseTimeout="TimeSpan" maxItemsInCache="Integer" />  
+     </sendMessageChannelCache>  
+      <sqlWorkflowInstanceStore   
+          connectionStringName="String"   
+          honstLockRenewalPeriod="TimeSpan"  
+          instanceCompletionAction="DeleteNothing/DeleteAll"  
+          instanceEncodingAction="None/GZip"  
+          instanceLockedExceptionAction="NoRetry/BasicRetry/AggressiveRetry"  
+          runnableInstancesDetectionPeriod="TimeSpan" />  
+      <workflowIdle timeToPersist="TimeSpan"  
+          timeToUnload="TimeSpan" />  
+      <workflowUnhandledExceptionaction="Abandon/AbandonAndSuspend/Cancel/Terminate" />  
+    </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+  <tracking>    
+     <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+     </participants>   
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.ServiceModel>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<behaviors\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behaviors-of-workflow.md)|ここでは、**serviceBehaviors** コレクションを定義します。  各コレクション内の要素は、サービスによって使用されるそれぞれの動作要素を定義します。  各動作要素は、その一意の **name** 属性で識別されます。|  
+|[\<tracking\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md)|ワークフロー サービスの追跡設定を定義する構成セクションを表します。<br /><br /> ワークフロー追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」および「[ワークフローの追跡の構成](../../../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」を参照してください。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<configuration\>|.NET 構成ファイルのすべての構成要素のルート要素。|
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md
new file mode 100644
index 00000000000..dcad0289b4f
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md
@@ -0,0 +1,104 @@
+---
+title: "&lt;tracking&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: fd9b50ed-98a1-4518-836d-e4e02c670822
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# &lt;tracking&gt;
+ワークフロー サービスの追跡設定を定義する構成セクションを表します。  
+  
+ ワークフローの追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」と「[ワークフローの追跡の構成](../../../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<system.serviceModel>  
+  <tracking>    
+     <participants>   
+      <add name="String"   
+           profileName="String"  
+           type="String" />   
+     </participants>   
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|追跡レコードを定期受信する参加要素を定義する、構成要素のコレクション。  追跡参加要素には、追跡レコードからペイロードを処理するロジックが含まれています \(たとえば、ファイルへの書き込みを選択できるなど\)。|  
+|[\<trackingProfile\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md)|ワークフロー インスタンスで発生した追跡レコードをフィルター処理するための追跡プロファイル。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.ServiceModel|すべてのワークフロー構成要素のルート要素。|  
+  
+## 解説  
+ 追跡には、ワークフローの実行を検証する機能が用意されています。  ワークフロー追跡インフラストラクチャはワークフローをインストルメント化し、実行中の主要イベントを反映してレコードを生成します。  たとえば、ワークフロー インスタンスが開始または完了すると、追跡レコードが生成されます。  また、追跡によって、ワークフロー変数に関連付けられたビジネス関連データを抽出することもできます。  たとえば、ワークフローが注文処理システムを表している場合は、注文 ID と共に追跡レコードを抽出できます。  一般的に、WF 追跡機能を有効にすると、ワークフロー実行の診断またはビジネス分析が容易になります。  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.TrackingSection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.TrackingSection?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md
new file mode 100644
index 00000000000..5fccaa86d74
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md
@@ -0,0 +1,129 @@
+---
+title: "&lt;trackingProfile&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 154830ff-ddd3-4397-a3b5-5b334907777f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;trackingProfile&gt;
+追跡参加要素内でワークフロー追跡レコードのサブスクリプションを作成するための、構成セクションを表します。  追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  追跡プロファイル セクション内で定義されたクエリでは、サブスクリプションによって返されるイベントの種類が定義されます。  
+  
+ ワークフロー追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」と「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|追跡プロファイルの名前を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<tracking\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/tracking.md)|ワークフロー サービスの追跡設定を定義する構成セクションを表します。|  
+  
+## 解説  
+ 追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  監視の要件に応じて、ワークフローの主な状態変化の少数のセットを定期受信する、大まかなプロファイルを作成できます。  それとは反対に、結果として得られるイベントが、後で詳細な実行フローを十分に再構築できるほど豊富な、詳細なプロファイルを作成することもできます。  
+  
+ 追跡プロファイルは、特定の追跡レコードを対象としてワークフロー ランタイムを照会できる、追跡レコード用の宣言型のサブスクリプションとして構築されます。  クエリには、TrackingRecord オブジェクトのさまざまなクラスを定期受信できる型が複数あります。  クエリの完全な一覧については、「[\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)」と「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+ 次の例は、追跡参加要素が `Started`ワークフロー イベントおよび `Completed`ワークフロー イベントを定期受信できるようにする、構成ファイル内の追跡プロファイルを示します。  
+  
+```  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="Sample Tracking Profile">  
+      <workflow activityDefinitionId="*">  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+            <states>  
+              <state name="Started"/>  
+              <state name="Completed"/>  
+            </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.ProfileElement>   
+ <xref:System.Activities.Tracking.TrackingProfile>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/using-annotation-in-queries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/using-annotation-in-queries.md
new file mode 100644
index 00000000000..82fc70f8bdd
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/using-annotation-in-queries.md
@@ -0,0 +1,43 @@
+---
+title: "クエリにおける注釈の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 50855b30-d5fe-49a9-89d3-3f1bfd670958
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# クエリにおける注釈の使用
+注釈を使用すると、ビルド後に構成できる値を使用して、追跡レコードへのタグ付けを任意に行うことができます。  たとえば、複数のワークフローに存在する複数の追跡レコードに、"Mail Server" \=\= "Mail Server1" というタグを付けることができます。  こうすると、後で追跡レコードのクエリを実行するときに、このタグの付いたすべてのレコードを簡単に見つけることができます。  
+  
+## 注釈の追加  
+ 次の例に示すように、追跡クエリに注釈を追加できます。  
+  
+```  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <annotations>  
+    <annotation name="MailServer" value="Mail Server1"/>  
+  </annotations>  
+</activityStateQuery>  
+  
+```  
+  
+> [!NOTE]
+>  これらの追跡クエリ要素は、追跡プロファイルの作成に使用できます。  追跡プロファイルは構成またはコードで作成できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.ProfileWorkflowElement>   
+ <xref:System.Activities.Tracking.TrackingProfile>   
+ [\<participants\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/participants.md)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variable.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variable.md
new file mode 100644
index 00000000000..84bc4719f3b
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variable.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;variable&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 46cc8cbc-10ec-4625-8813-3f5cd6c6afde
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;variable&gt;
+このアクティビティ クエリに関連付けられている変数のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|name|変数の名前を指定する文字列。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<variable\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/variable.md)|アクティビティ状態クエリに関連付けられている変数。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.VariableElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.VariableElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variables.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variables.md
new file mode 100644
index 00000000000..87bc8fce63c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/variables.md
@@ -0,0 +1,82 @@
+---
+title: "&lt;variables&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: da0fd144-dda9-4613-b650-fe6325076513
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;variables&gt;
+このアクティビティ クエリに関連付けられている変数のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+     <trackingProfile name="Name">  
+       <workflow>  
+          <activityStateQueries>  
+             <activityStateQuery activityName="String" />  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+       </workflow>  
+     </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<variable\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/variable.md)|アクティビティ状態クエリに関連付けられている変数。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する構成要素を表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+  
+## 解説  
+ ActivityStateQuery の固有の機能の 1 つは、ワークフローの実行を追跡するときにデータを抽出する機能です。  これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。  [\<arguments\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/arguments.md) 要素、[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素、および [\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md) 要素を使用して、ワークフロー内の任意のアクティビティから任意の変数または引数を抽出できます。次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出する、アクティビティ状態クエリを示しています。  変数と引数は、ActivityStateRecord でのみ抽出できるため、[\<activityStateQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequery.md) を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.VariableElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.VariableElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.ActivityStateQuery](assetId:///System.Activities.Tracking.ActivityStateQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md
new file mode 100644
index 00000000000..8bc1b130bf8
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md
@@ -0,0 +1,137 @@
+---
+title: "&lt;workflow&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 560aa9b6-9cf3-460e-b798-f87d14b1d2de
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;workflow&gt;
+**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。  
+  
+ ワークフロー追跡とその構成の詳細については、「[ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」と「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="String">  
+      <workflow activityDefinitionId="String">  
+          <activityScheduledQueries>  
+             <activityScheduledQuery activityName="String"  
+                 childActivityName="String"/>  
+          </activityScheduledQueries>  
+             <activityStateQuery activityName="String" />  
+                <arguments>  
+                   <argument name="String"/>  
+                </arguments>  
+                <states>  
+                   <state name="String"/>  
+                </states>  
+                <variables>  
+                   <variable name="String"/>  
+                </variables>  
+          </activityStateQueries>  
+          <bookmarkResumptionQueries>  
+             <bookmarkResumptionQuery name="String" />  
+          </bookmarkResumptionQueries>  
+          <cancelRequestQueries>  
+             <cancelRequestQuery activityName="String"  
+                 childActivityName="String"/>  
+          </cancelRequestQueries>  
+          <customTrackingQueries>  
+             <customTrackingQuery activityName="String"  
+                 name="String"/>  
+          </customTrackingQueries>  
+          <faultPropagationQueries>  
+             <faultPropagationQuery activityName="String"  
+                 faultHandlerActivityName="String"/>  
+          </faultPropagationQueries>  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                 <state name="String"/>  
+              </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|activityDefinitionId|追跡対象のワークフローのアクティビティ定義 ID を指定する文字列。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<activityScheduledQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activityscheduledqueries.md)|親アクティビティによる実行がスケジュールされているアクティビティを追跡するために使用する、クエリのコレクションを表します。  アクティビティがスケジュールされたレコードを追跡参加要素が定期受信するには、このクエリが必要です。|  
+|[\<activityStateQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/activitystatequeries.md)|ワークフロー インスタンスを構成するアクティビティのライフサイクルの変化を追跡するために使用する、クエリのコレクションを表します。  たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡することが必要な場合があります。  追跡参加要素がアクティビティ状態レコード オブジェクトを定期受信するには、このクエリが必要です。  定期受信可能な状態は ActivityStates で指定します。|  
+|[\<bookmarkResumptionQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/bookmarkresumptionqueries.md)|ワークフロー インスタンス内のブックマークの再開を追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がブックマーク再開レコードを定期受信するには、このクエリが必要です。|  
+|[\<cancelRequestedQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/cancelrequestedqueries.md)|親アクティビティが子アクティビティを取り消すための要求を追跡するのに使用する、クエリのコレクションを表します。  追跡参加要素がキャンセル要求レコード オブジェクトを定期受信するには、このクエリが必要です。|  
+|[\<customTrackingQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/customtrackingqueries.md)|コード アクティビティで定義するイベントを追跡するために使用する、クエリのコレクションを表します。  追跡参加要素がカスタム追跡レコードを定期受信するには、このクエリが必要です。|  
+|[\<faultPropagationQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/faultpropagationqueries.md)|1 つのアクティビティ内で発生するエラーの処理を追跡するために使用する、クエリのコレクションを表します。 このイベントは、FaultHandler がエラーを処理するたびに発生します。  1 つのアクティビティ内で発生したエラーの処理は、このようなクエリを使用して追跡する必要があります。  追跡参加要素がエラー伝達レコードを定期受信するには、このクエリが必要です。|  
+|[\<workflowInstanceQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md)|開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡する構成要素のコレクションを表します。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<trackingProfile\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/trackingprofile.md)|追跡参加要素内でワークフロー追跡レコードのサブスクリプションを作成するための、構成セクションを表します。  追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  追跡プロファイル セクション内で定義されたクエリでは、サブスクリプションによって返されるイベントの種類が定義されます。|  
+  
+## 解説  
+ 追跡プロファイルには、実行時に特定のワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  この構成要素を使用して、追跡対象のワークフロー インスタンスが識別されます。  
+  
+ 監視の要件に応じて、ワークフローの主な状態変化の少数のセットを定期受信する、大まかなプロファイルを作成できます。  それとは反対に、結果として得られるイベントが、後で詳細な実行フローを十分に再構築できるほど豊富な、詳細なプロファイルを作成することもできます。  
+  
+ 追跡プロファイルは、特定の追跡レコードを対象としてワークフロー ランタイムを照会できる、追跡レコード用の宣言型のサブスクリプションとして構築されます。  クエリには複数の型があり、これらを使用して、追跡レコードのさまざまなクラスを定期受信できます。  クエリの完全な一覧については、このトピックの子要素の一覧と「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+ 次の例は、追跡参加要素が `Started`ワークフロー イベントおよび `Completed`ワークフロー イベントを定期受信できるようにする、構成ファイル内の追跡プロファイルを示します。  
+  
+```  
+  
+<system.serviceModel>  
+  <tracking>    
+    <trackingProfile name="Sample Tracking Profile">  
+      <workflow activityDefinitionId="*">  
+         <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+            <states>  
+              <state name="Started"/>  
+              <state name="Completed"/>  
+            </states>  
+          </workflowInstanceQuery>  
+        </workflowInstanceQueries>  
+      </workflow>  
+    </trackingProfile>          
+   </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Tracking.Configuration.ProfileWorkflowElement>   
+ <xref:System.Activities.Tracking.TrackingProfile>   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowidle.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowidle.md
new file mode 100644
index 00000000000..f51f47af51d
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowidle.md
@@ -0,0 +1,56 @@
+---
+title: "&lt;workflowIdle&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: b2ef703c-3e01-4213-9d2e-c14c7dba94d2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;workflowIdle&gt;
+アイドル状態のワークフロー インスタンスのアンロードおよび永続化のタイミングを制御するサービス動作。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <workflowIdle timeToPersist=”TimeSpan”  
+          timeToUnload=”TimeSpan” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|timeToPersist|ワークフローがアイドル状態から永続化されるまでの継続時間を指定する Timespan 値。  既定値は TimeSpan.MaxValue です。<br /><br /> 継続時間は、ワークフロー インスタンスがアイドル状態になった時点から開始します。  この属性は、ワークフロー インスタンスを、可能な限り長くメモリに保持しながら、積極的に永続化しようとする場合に役立ちます。  この属性は、値が **timeToUnload** 属性の値未満の場合にのみ有効です。  それより大きい場合は無視されます。  この属性が、**timeToUnload** 属性によって指定された値より先に経過する場合は、ワークフローをアンロードする前に永続化を終了する必要があります。  これは、ワークフローを永続化するまでアンロード操作に遅延が生じる場合があることを意味します。  永続化レイヤーは一時的なエラーの再試行処理は行いますが、回復不可能なエラーに対しては例外をスローするだけです。  したがって、永続化中にスローされる例外は致命的な例外として処理され、ワークフロー インスタンスが中止されます。|  
+|timeToUnload|ワークフローがアイドル状態からアンロードされるまでの継続時間を指定する Timespan 値。  既定値は 1 分です。<br /><br /> ワークフローをアンロードすることは、同時に、永続化することも意味します。  この属性をゼロに設定した場合は、ワークフローがアイドル状態になった直後に、ワークフロー インスタンスが永続化され、アンロードされます。  この属性を TimeSpan.MaxValue に設定すると、アンロード操作を事実上、無効にします。  アイドル状態になったワークフロー インスタンスはアンロードされません。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.WorkflowIdleElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancemanagement.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancemanagement.md
new file mode 100644
index 00000000000..98e6c1224a3
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancemanagement.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;workflowInstanceManagement&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 63ac89ba-c844-4ae2-96ae-cd752a90a109
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# &lt;workflowInstanceManagement&gt;
+ワークフロー インスタンスの実行方法を制御する設定を指定するためのサービス動作。これには、永続する未処理の例外動作やアイドル状態の動作が含まれます。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <workflowInstanceManagement authorizedWindowsGroup=”” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|authorizedWindowsGroup||  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.WorkflowInstanceManagementBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.WorkflowInstanceManagementElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md
new file mode 100644
index 00000000000..4df2311168c
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;workflowInstanceQueries&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 4fe7ce85-cf9a-4dbf-a8f7-bc9b1fc2fe35
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;workflowInstanceQueries&gt;
+開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡する構成要素のコレクションを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQuery\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md)|ワークフロー インスタンスのライフサイクルの変化を追跡するために使用されるクエリ。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflow\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflow.md)|**activityDefinitionId** プロパティによって識別される特定のワークフローのすべてのクエリを格納する構成要素。|  
+  
+## 解説  
+ <xref:System.Activities.Tracking.WorkflowInstanceQuery> は、次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの定期受信に使用されます。  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElementCollection](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElementCollection?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md
new file mode 100644
index 00000000000..ea677146442
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequery.md
@@ -0,0 +1,92 @@
+---
+title: "&lt;workflowInstanceQuery&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 9096e812-626a-409a-9eda-c31a60b84c55
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;workflowInstanceQuery&gt;
+開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡するクエリを表します。  
+  
+ 追跡プロファイルのクエリの詳細については、「[追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+## 構文  
+  
+```vb  
+  
+<tracking>  
+   <trackingProfile name="Name">  
+       <workflow>  
+          <workflowInstanceQueries>  
+             <workflowInstanceQuery>  
+                <states>  
+                   <state name="Name"/>  
+                </states>  
+            </workflowInstanceQuery>  
+         </workflowInstanceQueries>  
+       </workflow>  
+   </trackingProfile>  
+</tracking>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<states\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/states.md)|追跡レコードが作成されたときの追跡ワークフロー インスタンスの定期受信済み状態のコレクション。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<workflowInstanceQueries\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowinstancequeries.md)|開始したイベントや完了したイベントなど、ワークフロー インスタンスのライフサイクルの変化を追跡する構成要素のコレクションを表します。|  
+  
+## 解説  
+ <xref:System.Activities.Tracking.WorkflowInstanceQuery> は、次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの定期受信に使用されます。  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>  
+  
+## 使用例  
+ 次の構成は、このクエリを使用して、`Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信します。  
+  
+```  
+  
+<workflowInstanceQueries>  
+    <workflowInstanceQuery>  
+      <states>  
+        <state name="Started"/>  
+      </states>  
+    </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+  
+```  
+  
+## 参照  
+ [System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement](assetId:///System.ServiceModel.Activities.Tracking.Configuration.WorkflowInstanceQueryElement?qualifyHint=False&amp;autoUpgrade=True)   
+ [System.Activities.Tracking.WorkflowInstanceQuery](assetId:///System.Activities.Tracking.WorkflowInstanceQuery?qualifyHint=False&amp;autoUpgrade=True)   
+ [ワークフロー追跡とトレース](../../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)   
+ [追跡プロファイル](../../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowunhandledexception.md b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowunhandledexception.md
new file mode 100644
index 00000000000..14dea475d61
--- /dev/null
+++ b/docs/framework/configure-apps/file-schema/windows-workflow-foundation/workflowunhandledexception.md
@@ -0,0 +1,54 @@
+---
+title: "&lt;workflowUnhandledException&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+ms.assetid: 57adeab5-f06a-44b2-916b-0e177cf0f4a6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;workflowUnhandledException&gt;
+ワークフロー サービス内で未処理の例外が発生した場合のアクションを指定するためのサービス動作。  
+  
+## 構文  
+  
+```  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name=String">  
+      <workflowUnhandledException action=”Abandon/AbandonAndSuspend/Cancel/Terminate” />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|アクション|未処理の例外が発生した場合のアクションを指定する文字列。  この属性は <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionaction> 型です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<serviceBehaviors\> の \<behavior\>](../../../../../docs/framework/configure-apps/file-schema/windows-workflow-foundation/behavior-of-servicebehaviors-of-workflow.md)|動作の要素を指定します。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior>   
+ <xref:System.ServiceModel.Activities.Configuration.WorkflowUnhandledExceptionElement>
\ No newline at end of file
diff --git a/docs/framework/configure-apps/how-to-create-a-publisher-policy.md b/docs/framework/configure-apps/how-to-create-a-publisher-policy.md
new file mode 100644
index 00000000000..5194f150387
--- /dev/null
+++ b/docs/framework/configure-apps/how-to-create-a-publisher-policy.md
@@ -0,0 +1,122 @@
+---
+title: "方法 : 発行者ポリシーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "GAC (グローバル アセンブリ キャッシュ), 発行者ポリシー アセンブリ"
+  - "グローバル アセンブリ キャッシュ, 発行者ポリシー アセンブリ"
+  - "発行者ポリシー アセンブリ"
+  - "発行者ポリシー ファイル"
+ms.assetid: 8046bc5d-2fa9-4277-8a5e-6dcc96c281d9
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# 方法 : 発行者ポリシーを作成する
+アセンブリの販売元は、アップグレードしたアセンブリに発行者ポリシー ファイルを含めることにより、より新しいバージョンのアセンブリを使用してアプリケーションを実行するように指示できます。  発行者ポリシー ファイルには、アセンブリのリダイレクトやコード ベース設定を指定し、その書式にはアプリケーション構成ファイルと同じ書式を使用します。  発行者ポリシーファイルをコンパイルしてアセンブリを生成し、グローバル アセンブリ キャッシュに配置します。  
+  
+ 発行者ポリシーは、次の手順で作成します。  
+  
+1.  発行者ポリシー ファイルを作成します。  
+  
+2.  発行者ポリシー アセンブリを作成します。  
+  
+3.  その発行者ポリシー アセンブリをグローバル アセンブリ キャッシュに追加します。  
+  
+ 発行者ポリシーのスキーマについては、「[アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)」を参照してください。  `myAssembly` のあるバージョンを別のバージョンにリダイレクトする発行者ポリシー ファイルを次の例に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+       <dependentAssembly>  
+         <assemblyIdentity name="myAssembly"  
+                           publicKeyToken="32ab4ba45e0a69a1"  
+                           culture="en-us" />  
+         <!-- Redirecting to version 2.0.0.0 of the assembly. -->  
+         <bindingRedirect oldVersion="1.0.0.0"  
+                          newVersion="2.0.0.0"/>  
+       </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+ コード ベースの指定方法については、「[アセンブリの場所の指定](../../../docs/framework/configure-apps/specify-assembly-location.md)」を参照してください。  
+  
+## 発行者ポリシー アセンブリの作成  
+ 発行者ポリシー アセンブリを作成するには、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用します。  
+  
+#### ライブラリ アセンブリを作成するには  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     **al \/link:** *publisherPolicyFile* **\/out:** *publisherPolicyAssemblyFile* **\/keyfile:** *keyPairFile* **\/platform:** *processorArchitecture*  
+  
+     上記のコマンドには、次の引数を指定します。  
+  
+    -   *publisherPolicyFile* 引数には、発行者ポリシー ファイルの名前を指定します。  
+  
+    -   *publisherPolicyAssemblyFile* 引数には、このコマンドを実行した結果作成される発行者ポリシー アセンブリの名前を指定します。  アセンブリ ファイルの名前は、次の書式にする必要があります。  
+  
+         **policy.** *majorNumber* **.** *minorNumber* **.** *mainAssemblyName* **.dll**  
+  
+    -   *keyPairFile* 引数には、キー ペアを含むファイルの名前を指定します。  アセンブリと発行者ポリシー アセンブリには、同じキー ペアで署名する必要があります。  
+  
+    -   *processorArchitecture* 引数には、プロセッサ固有のアセンブリが対象とするプラットフォームを指定します。  
+  
+        > [!NOTE]
+        >  .NET Framework Version 2.0 では、特定のプロセッサ アーキテクチャを対象にできるようになりました。  
+  
+     `policy.1.0.myAssembly` という発行者ポリシー アセンブリを発行者ポリシー ファイル `pub.config` から作成し、そのアセンブリに `sgKey.snk` ファイル内のキー ペアを使用して厳密な名前を割り当て、x86 プロセッサ アーキテクチャを対象とするアセンブリを指定するコマンドを次に示します。  
+  
+    ```  
+    al /link:pub.config /out:policy.1.0.myAssembly.dll /keyfile:sgKey.snk /platform:x86  
+    ```  
+  
+     発行者ポリシー アセンブリは、適用先アセンブリのプロセッサ アーキテクチャと一致している必要があります。  したがって、アセンブリの <xref:System.Reflection.AssemblyName.ProcessorArchitecture%2A> 値が <xref:System.Reflection.ProcessorArchitecture> である場合、そのアセンブリの発行者ポリシー アセンブリは `/platform:anycpu` を使用して作成されている必要があります。  ポリシー固有のアセンブリごとに個別の発行者ポリシー アセンブリを指定する必要があります。  
+  
+     この規則により、アセンブリのプロセッサ アーキテクチャを変更する場合、バージョン番号のメジャー部分またはマイナー部分を変更して、正しいプロセッサ アーキテクチャで新しい発行者ポリシー アセンブリを指定する必要があります。  アセンブリに異なるプロセッサ アーキテクチャが指定されていると、古い発行者ポリシー アセンブリがアセンブリにサービスを提供できません。  
+  
+     また、この規則により、常にプロセッサ アーキテクチャが指定されるため、以前のバージョンの .NET Framework を使用してコンパイルしたアセンブリに対しては、バージョン 2.0 のリンカーを使用して発行者ポリシー アセンブリを作成できません。  
+  
+## 発行者ポリシー アセンブリのグローバル アセンブリ キャッシュへの追加  
+ 発行者ポリシー アセンブリをグローバル アセンブリ キャッシュに追加するには、[グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を使用します。  
+  
+#### 発行者ポリシー アセンブリをグローバル アセンブリ キャッシュに追加するには  
+  
+1.  コマンド プロンプトに次のコマンドを入力します。  
+  
+     **gacutil \/i**  *publisherPolicyAssemblyFile*  
+  
+     `policy.1.0.myAssembly.dll` をグローバル アセンブリ キャッシュに追加するコマンドを次に示します。  
+  
+    ```  
+    gacutil /i policy.1.0.myAssembly.dll  
+    ```  
+  
+    > [!IMPORTANT]
+    >  発行者ポリシー アセンブリは、元の発行者ポリシー ファイルがアセンブリと同じディレクトリにある場合を除き、グローバル アセンブリ キャッシュに追加できません。  
+  
+## 参照  
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アプリの構成](../../../docs/framework/configure-apps/index.md)   
+ [Configuring .NET Framework Apps](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)   
+ [ランタイム設定スキーマ](../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md b/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md
new file mode 100644
index 00000000000..51d954df660
--- /dev/null
+++ b/docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md
@@ -0,0 +1,100 @@
+---
+title: "方法: 自動バインディング リダイレクトを有効/無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], バインディングのリダイレクト"
+  - "side-by-side 実行, アセンブリ バインディング リダイレクト"
+ms.assetid: 5fca42f3-bdce-4b81-a704-61e42c89d3ba
+caps.latest.revision: 17
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 17
+---
+# 方法: 自動バインディング リダイレクトを有効/無効にする
+[!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)]以降では、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]を対象とするアプリをコンパイルするときに、アセンブリの統一をオーバーライドするために、アプリ構成ファイルにバインド リダイレクトが自動的に追加される場合があります。  アプリの構成ファイルで手動でバインド リダイレクトを指定している場合でも、アプリまたはそのコンポーネントが同じアセンブリの複数バージョンを参照している場合、バインド リダイレクトが追加されます。  自動バインド リダイレクト機能は、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象とする従来のデスクトップ アプリと Web アプリに影響します。ただし、Web アプリに対する動作は若干異なります。  以前のバージョンの .NET Framework を対象とする既存のアプリがある場合は、自動バインド リダイレクトを有効にできます。また、手動で作成したバインド リダイレクトを保持する場合は、この機能を無効にできます。  
+  
+## デスクトップ アプリでの自動バインド リダイレクトの無効化  
+ 自動バインド リダイレクトは、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] 以上のバージョンを対象とする従来のデスクトップ アプリで、既定で有効になっています。  バインド リダイレクトは、アプリケーションがコンパイルされ、発生する可能性のあるアセンブリの統一をオーバーライドするときに、出力構成ファイル \(app.config\) に追加されます。  ソース app.config ファイルは変更されません。  アプリのプロジェクト ファイルを変更して、この機能を無効にできます。  
+  
+#### 自動バインド リダイレクトを無効にするには  
+  
+1.  Visual Studio の**ソリューション エクスプローラー**で、プロジェクトを選択し、ショートカット メニューの **\[エクスプローラーでフォルダーを開く\]** をクリックします。  
+  
+2.  エクスプローラーで、プロジェクト ファイル \(.csproj または .vbproj\) を検索し、メモ帳で開きます。  
+  
+3.  プロジェクト ファイルで、次のプロパティ エントリを検索します。  
+  
+     `<AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>`  
+  
+4.  `true` を `false` に変更します。  
+  
+     `<AutoGenerateBindingRedirects>false</AutoGenerateBindingRedirects>`  
+  
+## 自動バインド リダイレクトの手動での有効化  
+ 自動バインド リダイレクトは、.NET Framework の旧バージョンを対象とする既存のアプリで有効にするか、またはリダイレクトの追加を確認するメッセージが自動的に表示されない場合に有効にできます。  新しいバージョンのフレームワークを対象としているが、リダイレクトの追加を確認するメッセージが自動的に表示されない場合は、ビルド出力でアセンブリを再マップすることが推奨されることがあります。  
+  
+#### 自動バインド リダイレクトのプロパティを手動で追加するには  
+  
+1.  Visual Studio の**ソリューション エクスプローラー**で、プロジェクトを選択し、ショートカット メニューの **\[エクスプローラーでフォルダーを開く\]** をクリックします。  
+  
+2.  エクスプローラーで、プロジェクト ファイル \(.csproj または .vbproj\) を検索し、メモ帳で開きます。  
+  
+3.  最初の構成プロパティ グループ \(\<PropertyGroup\> タグの下\) に次の要素を追加します。  
+  
+     `<AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>`  
+  
+     要素が挿入されたプロジェクト ファイルの例を次に示します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8"?>  
+    <Project ToolsVersion="12.0" DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
+      <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />  
+      <PropertyGroup>  
+        <Configuration Condition=" '$(Configuration)' == ''     ">Debug</Configuration>  
+        <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>  
+        <ProjectGuid>{123334}</ProjectGuid>  
+        ...  
+        <AutoGenerateBindingRedirects>true</AutoGenerateBindingRedirects>  
+      </PropertyGroup>  
+    ...  
+    </Project>  
+  
+    ```  
+  
+4.  アプリをコンパイルします。  
+  
+## Web アプリでの自動バインド リダイレクトの有効化  
+ 自動バインド リダイレクトは、Web アプリでは異なる方法で実装されます。  ソースの構成 \(web.config\) ファイルを Web アプリ用に変更する必要があるため、バインド リダイレクトは構成ファイルに自動的に追加されません。  ただし、Visual Studio によってバインドの競合が通知されるため、バインド リダイレクトを追加して競合を解決できます。  バインド リダイレクトを追加するかどうかの確認メッセージは常に表示されるため、明示的に Web アプリのこの機能を無効にする必要はありません。  
+  
+#### web.config ファイルにバインド リダイレクトを追加するには  
+  
+1.  Visual Studio で、アプリをコンパイルし、ビルドの警告を確認します。  
+  
+     ![アセンブリ参照の競合のビルド警告](../../../docs/framework/configure-apps/media/clr-assemblyrefwarning.png "CLR\_AssemblyRefWarning")  
+  
+2.  アセンブリ バインドの競合がある場合、警告が表示されます。  警告をダブルクリックします   \(キーボード: 警告を選択し、**Enter** キーを押します\)。  
+  
+     自動的にソース web.config ファイルに必要なバインド リダイレクトを追加できるダイアログ ボックスが表示されます。  
+  
+     ![バインディング リダイレクトのアクセス許可ダイアログ](../../../docs/framework/configure-apps/media/clr-addbindingredirect.png "CLR\_AddBindingRedirect")  
+  
+## 参照  
+ [\<bindingRedirect\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md)   
+ [アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md b/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md
new file mode 100644
index 00000000000..f53c99c4ee8
--- /dev/null
+++ b/docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : DEVPATH を使用してアセンブリを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーション構成, アセンブリ"
+  - "app.config ファイル, アセンブリの場所"
+  - "アプリケーション構成ファイル, 指定 (アセンブリの場所を)"
+  - "アセンブリ [.NET Framework], 位置"
+  - "DEVPATH"
+  - "検索 (アセンブリを)"
+ms.assetid: 44d2eadf-7eec-443c-a2ac-d601fd919e17
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法 : DEVPATH を使用してアセンブリを指定する
+開発者は、作成する共有アセンブリが複数のアプリケーションで正しく動作することを確認する必要があります。  開発時に、グローバル アセンブリ キャッシュにアセンブリを繰り返し配置する代わりに、アセンブリのビルド出力ディレクトリを指す DEVPATH 環境変数を作成できます。  
+  
+ たとえば、MySharedAssembly という共有アセンブリを作成していて、その出力ディレクトリが C:\\MySharedAssembly\\Debug であると仮定します。  開発者は、C:\\MySharedAssembly\\Debug を DEVPATH 変数に格納できます。  マシン構成ファイル内に [\<developmentMode\>](../../../docs/framework/configure-apps/file-schema/runtime/developmentmode-element.md) 要素を指定する必要があります。  この要素は、共通言語ランタイムに、DEVPATH を使用してアセンブリを特定するように指示します。  
+  
+ 共有アセンブリは、実行時に検出可能にする必要があります。アセンブリ参照を解決するためのプライベート ディレクトリを指定するには、「[アセンブリの場所の指定](../../../docs/framework/configure-apps/specify-assembly-location.md)」で説明されているように、構成ファイルで [\<codeBase\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) または [\<probing\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) を使用します。アセンブリをアプリケーション ディレクトリのサブディレクトリに入れることもできます。  詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+> [!NOTE]
+>  これは、開発者専用の高度な機能です。  
+  
+ DEVPATH 環境変数で指定されたディレクトリでランタイムがアセンブリを検索するように指定する例を示します。  
+  
+## 使用例  
+  
+```  
+<configuration>  
+  <runtime>  
+    <developmentMode developerInstallation="true"/>  
+  </runtime>  
+</configuration>  
+```  
+  
+ この設定の既定値は、false です。  
+  
+> [!NOTE]
+>  この設定は、開発時にだけ使用します。  ランタイムは、DEVPATH で見つかった厳密な名前付きアセンブリのバージョンを確認しません。  単純に、最初に見つかったアセンブリを使用します。  
+  
+## 参照  
+ [Configuring .NET Framework Apps](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/index.md b/docs/framework/configure-apps/index.md
new file mode 100644
index 00000000000..401e87cddb5
--- /dev/null
+++ b/docs/framework/configure-apps/index.md
@@ -0,0 +1,143 @@
+---
+title: "構成ファイルを使用してアプリを構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーション構成, 構成ファイル"
+  - "< runtime > 要素"
+  - "アプリケーション構成ファイル"
+  - "アプリケーション構成ファイル, バージョン情報"
+  - "アプリケーション構成ファイル, format"
+  - "アプリケーション構成ファイル, マシン"
+  - "アプリケーション構成ファイル, セキュリティ"
+  - "アプリケーション [.NET Framework], 構成ファイル"
+  - "ASP.NET, 構成"
+  - "構成ファイル [.NET Framework]"
+  - "構成ファイル [.NET Framework], アプリケーション"
+  - "構成ファイル [.NET Framework], format"
+  - "構成ファイル [.NET Framework], マシン"
+  - "構成ファイル [.NET Framework], セキュリティ"
+  - "終了タグ"
+  - "ホスト, アプリケーション"
+  - "マシン構成ファイル"
+  - "セキュリティ構成ファイル"
+  - "開始タグ"
+ms.assetid: 86bd26d3-737e-4484-9782-19b17f34cd1f
+caps.latest.revision: 28
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 28
+---
+# 構成ファイルを使用してアプリを構成する方法
+.NET Framework を使用すると、開発者および管理者は、構成ファイルを使用することにより、アプリケーションの実行方法を制御し、アプリケーションの実行に柔軟性を持たせることができます。  構成ファイルは XML ファイルで、必要に応じて変更できます。  管理者は、アプリケーションからアクセスできるプロテクト リソース、アプリケーションが使用するアセンブリのバージョン、およびリモート アプリケーションやオブジェクトの配置場所を制御できます。  開発者は、構成ファイル内に設定を格納できます。これにより、設定変更のたびにアプリケーションを再コンパイルする必要がなくなります。  このセクションでは、設定できる内容と、アプリケーションを設定することが有益である理由を説明します。  
+  
+> [!NOTE]
+>  マネージ コードは、<xref:System.Configuration> 名前空間のクラスを使用して、構成ファイルから設定を読み込むことができます。設定をファイルへ書き込むことはありません。  
+  
+ ここでは、構成ファイルの構文を説明し、3 種類の構成ファイル \(マシン構成ファイル、アプリケーション構成ファイル、およびセキュリティ構成ファイル\) について情報を提供します。  
+  
+## 構成ファイルの形式  
+ 構成ファイルには、構成情報を設定する論理データ構造体である要素が含まれます。  構成ファイル内では、タグを使用して、それらの要素の先頭と末尾を示します。  たとえば、`<runtime>` 要素は `<runtime>`*child elements*`</runtime>` で構成されます。  空の要素は `<runtime/>` または `<runtime>``</runtime>` として書き込まれます。  
+  
+ XML ファイルと同様に、構成ファイル内の構文では、大文字と小文字が区別されます。  
+  
+ 構成設定は、要素の開始タグの内部に、定義済みの属性の名前と値を組み合わせて使用することで指定します。  `version` 要素に 2 つの属性 \(`href` および `<codeBase>`\) を指定して、ランタイムがアセンブリを検索する場所を指定する例を次に示します。詳細については、「[アセンブリの場所の指定](../../../docs/framework/configure-apps/specify-assembly-location.md)」を参照してください。  
+  
+```  
+<codeBase version="2.0.0.0"  
+          href="http://www.litwareinc.com/myAssembly.dll"/>  
+```  
+  
+## マシン構成ファイル  
+ マシン構成ファイル Machine.config には、コンピューター全体に適用する設定を含めます。  このファイルは、%*runtime install path*%\\Config ディレクトリに含まれています。  Machine.config には、マシン全体のアセンブリ バインディング、組み込みの[リモート処理チャネル](http://msdn.microsoft.com/ja-jp/6e9b60e0-9bc0-47b4-a8ef-3b78585f9a18)、および ASP.NET に関する構成設定が含まれます。  
+  
+ 構成システムは、まずマシン構成ファイル内で、[appSettings 要素](http://msdn.microsoft.com/ja-jp/0d65a3f1-c522-423d-89b6-44921b6daebb)と、開発者が定義したその他の構成セクションを調べます。  次に、アプリケーション構成ファイルを調べます。  マシン構成ファイルを管理しやすくするには、これらの設定をアプリケーション構成ファイルに配置するのが最適です。  しかし、それらの設定をマシン構成ファイル内に配置した方が、システムの保守が簡単になります。  たとえば、クライアント アプリケーションとサーバー アプリケーションの両方で使用されるサードパーティ コンポーネントがある場合、そのコンポーネントの設定を 1 か所に設まとめた方が簡単です。  この場合、同じ設定を 2 つのファイルに配置する必要がなくなるという点から、設定を格納するのに適した場所はマシン構成ファイルになります。  
+  
+> [!NOTE]
+>  XCOPY を使用してアプリケーションを配置しても、マシン構成ファイル内の設定はコピーされません。  
+  
+ 共通言語ランタイムがアセンブリ バインディングに関してマシン構成ファイルを使用する方法の詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+## アプリケーション構成ファイル  
+ アプリケーション構成ファイルは、アプリケーション固有の設定を含みます。  このファイルには、アセンブリ バインディング ポリシー、リモート処理オブジェクトなど、共通言語ランタイムが読み取る構成設定と、アプリケーションが読み取ることのできる設定を含めます。  
+  
+ アプリケーション構成ファイルの名前と場所は、アプリケーションのホストによって異なり、次のいずれかの場合が考えられます。  
+  
+-   実行可能ファイルによってホストされるアプリケーション。  
+  
+     これらのアプリケーションには構成ファイルが 2 つあります。開発中に開発者によって変更されるソース構成ファイルと、アプリケーションと共に配布される出力構成ファイルです。  
+  
+     Visual Studio で開発するときは、プロジェクト ディレクトリにアプリケーションのソース構成ファイルを配置し、その **\[出力ディレクトリにコピー\]** プロパティを **\[常にコピーする\]** または **\[新しい場合はコピーする\]** に設定します。  この構成ファイルの名前は、アプリケーション名に拡張子 .config を付けた名前になります。  たとえば、myApp.exe という名前のアプリケーションは、myApp.exe.config という名前のソース構成ファイルを持ちます。  
+  
+     Visual Studio は、コンパイル済みアセンブリが格納されるディレクトリに自動的にソース構成ファイルをコピーして、アプリケーションと共に配置される出力構成ファイルを作成します。  場合によっては、Visual Studio が出力構成ファイルを変更することがあります。詳細については、「[アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)」の「[アプリ レベルでのアセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md#BKMK_Redirectingassemblyversionsattheapplevel)」を参照してください。  
+  
+-   ASP.NET によってホストされるアプリケーション。  
+  
+     ASP.NET 構成ファイルの詳細については、「[ASP.NET 構成設定](http://msdn.microsoft.com/ja-jp/116608f3-c03d-4413-9fc7-978703e18b0f)」を参照してください。  
+  
+-   Internet Explorer によってホストされるアプリケーション。  
+  
+     Internet Explorer でホストされるアプリケーションに構成ファイルが関連付けられている場合、そのファイルの場所は、`<link>` タグ内に次の構文で指定します。  
+  
+     \<link rel\="*ConfigurationFileName*" href\="*location*"\>  
+  
+     このタグ内の `location` は、構成ファイルの場所を示す URL です。  これにより、アプリケーション ベースが設定されます。  構成ファイルは、アプリケーションと同じ Web サイトに配置する必要があります。  
+  
+## セキュリティ構成ファイル  
+ セキュリティ構成ファイルには、コード グループ階層構造に関する情報と、ポリシー レベルに関連付けたアクセス許可セットを含めます。  セキュリティ ポリシーを変更するときは、ポリシーの変更によってセキュリティ構成ファイルが破損しないように、[コード アクセス セキュリティ ポリシー ツール \(Caspol.exe\)](../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md) を使用することを強くお勧めします。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、セキュリティ構成ファイルはセキュリティ ポリシーが変更された場合にのみ存在します。  
+  
+ セキュリティ構成ファイルは次の場所にあります。  
+  
+-   エンタープライズ ポリシー構成ファイル: %*runtime\-install\-path*%\\Config\\Enterprisesec.config  
+  
+-   コンピューター ポリシー構成ファイル: %*runtime\-install\-path*%\\Config\\Security.config  
+  
+-   ユーザー ポリシー構成ファイル: %USERPROFILE%\\Application data\\Microsoft\\CLR security config\\v*xx.xx*\\Security.config  
+  
+## このセクションの内容  
+ [方法 : DEVPATH を使用してアセンブリを指定する](../../../docs/framework/configure-apps/how-to-locate-assemblies-by-using-devpath.md)  
+ アセンブリ検索のときに DEVPATH 環境変数を使用するようにランタイムに指示する方法を説明します。  
+  
+ [アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)  
+ アセンブリの場所および使用するアセンブリ バージョンを指定する方法を説明します。  
+  
+ [アセンブリの場所の指定](../../../docs/framework/configure-apps/specify-assembly-location.md)  
+ ランタイムがどの場所でアセンブリを検索するかを指定する方法を説明します。  
+  
+ [暗号化クラスの設定](../../../docs/framework/configure-apps/configure-cryptography-classes.md)  
+ 暗号化クラスにアルゴリズム名を割り当てる方法と、暗号化アルゴリズムにオブジェクト ID を割り当てる方法を説明します。  
+  
+ [方法 : 発行者ポリシーを作成する](../../../docs/framework/configure-apps/how-to-create-a-publisher-policy.md)  
+ アセンブリのリダイレクトやコード ベース設定を指定する発行者ポリシー ファイルを追加する状況や方法を説明します。  
+  
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)  
+ スキーマ、起動時の階層、ランタイム、ネットワーク、およびその他の種類の構成設定を説明します。  
+  
+## 参照  
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [アセンブリの場所の指定](../../../docs/framework/configure-apps/specify-assembly-location.md)   
+ [アセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md)   
+ [構成ファイルを使用したリモート オブジェクトの登録](http://msdn.microsoft.com/ja-jp/bc503ee1-c811-4f82-9525-470343326adc)   
+ [ASP.NET Web Site Administration](../Topic/ASP.NET%20Web%20Site%20Administration.md)   
+ [NIB: Security Policy Management](http://msdn.microsoft.com/ja-jp/d754e05d-29dc-4d3a-a2c2-95eaaf1b82b9)   
+ [Caspol.exe \(コード アクセス セキュリティ ポリシー ツール\)](../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [リモート オブジェクト](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md b/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md
new file mode 100644
index 00000000000..58b49b9ce5b
--- /dev/null
+++ b/docs/framework/configure-apps/map-algorithm-names-to-cryptography-classes.md
@@ -0,0 +1,84 @@
+---
+title: "暗号化クラスへのアルゴリズム名の割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号アルゴリズム"
+  - "暗号化, 割り当て (アルゴリズム名の)"
+  - "割り当て (アルゴリズム名の)"
+  - "名前 [.NET Framework], アルゴリズムの割り当て"
+ms.assetid: 01327c69-c5e1-4ef6-b73f-0a58351f0492
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# 暗号化クラスへのアルゴリズム名の割り当て
+開発者は、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] を使用して、次の 4 とおりの方法で暗号オブジェクトを作成できます。  
+  
+-   **new** 演算子を使用してオブジェクトを作成する。  
+  
+-   アルゴリズムの抽象クラスの **Create** メソッドを呼び出して、特定の暗号化アルゴリズムを実装するオブジェクトを作成する。  
+  
+-   [System.Security.Cryptography.CryptoConfig.CreateFromName](frlrfSystemSecurityCryptographyCryptoConfigClassCreateFromNameTopic) メソッドを呼び出して、特定の暗号化アルゴリズムを実装するオブジェクトを作成する。  
+  
+-   暗号化アルゴリズムの抽象クラス \(<xref:System.Security.Cryptography.SymmetricAlgorithm> など\) の **Create** メソッドを呼び出して、その種類の暗号化アルゴリズム \(対称ブロック暗号法など\) のクラスを実装するオブジェクトを作成する。  
+  
+ たとえば、開発者が、バイト セットの SHA1 ハッシュを計算すると仮定します。  <xref:System.Security.Cryptography> 名前空間には、SHA1 アルゴリズムの 2 つの実装が含まれています。1 つは純粋なマネージ実装であり、もう 1 つは CryptoAPI をラップする実装です。  開発者は、**new** 演算子を呼び出すことにより、特定の SHA1 実装 \([SHA1Managed クラス](frlrfSystemSecurityCryptographySHA1ManagedClassTopic)など\) をインスタンス化できます。  しかし、そのクラスが SHA1 ハッシュ アルゴリズムを実装していれば共通言語ランタイムがどのクラスを読み込むかは問題でない場合、開発者は [System.Security.Cryptography.SHA1.Create](frlrfSystemSecurityCryptographySHA1ClassCreateTopic) メソッドを呼び出してオブジェクトを作成できます。  このメソッドは、SHA1 ハッシュ アルゴリズムの実装を返す **System.Security.Cryptography.CryptoConfig.CreateFromName\("System.Security.Cryptography.SHA1"\)** を呼び出します。  
+  
+ 暗号構成には、既定として、.NET Framework に付属しているアルゴリズムのための短い名前が含まれているため、開発者は **System.Security.Cryptography.CryptoConfig.CreateFromName\("SHA1"\)** を呼び出すこともできます。  
+  
+ どのハッシュ アルゴリズムを使用するかは問題でない場合、開発者はハッシュ変換を実装するオブジェクトを返す [System.Security.Cryptography.HashAlgorithm.Create](frlrfSystemSecurityCryptographyHashAlgorithmClassCreateTopic) メソッドを呼び出すことができます。  
+  
+## 構成ファイル内でのアルゴリズム名の割り当て  
+ 既定では、ランタイムは 4 つのシナリオのいずれの場合にも、[System.Security.Cryptography.SHA1CryptoServiceProvider クラス](frlrfSystemSecurityCryptographySHA1CryptoServiceProviderClassTopic) オブジェクトを返します。  コンピューター管理者は、後の 2 つのシナリオのメソッドが返すオブジェクトの型を変更できます。  オブジェクトの型を変換するには、マシン構成ファイル \(Machine.config\) 内で、使用するクラスにアルゴリズムの表示名を割り当てる必要があります。  
+  
+ **System.Security.Cryptography.SHA1.Create**、**System.Security.CryptoConfig.CreateFromName\("SHA1"\)**、および **System.Security.Cryptography.HashAlgorithm.Create** が `MySHA1HashClass` オブジェクトを返すようにランタイムを設定する方法の例を次に示します。  
+  
+```  
+<configuration>  
+   <!-- Other configuration settings. -->  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass MySHA1Hash="MySHA1HashClass, MyAssembly  
+                  Culture='en', PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="SHA1" class="MySHA1Hash"/>  
+            <nameEntry name="System.Security.Cryptography.SHA1"  
+                       class="MySHA1Hash"/>  
+            <nameEntry name="System.Security.Cryptography.HashAlgorithm"  
+                       class="MySHA1Hash"/>  
+         </cryptoNameMapping>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+ [\<cryptoClass\> 要素](../../../docs/framework/configure-apps/file-schema/cryptography/cryptoclass-element.md) に属性名を指定できます。上の例では、属性 `MySHA1Hash`を指定します\)。  **\<cryptoClass\>** 要素の属性の値は、共通言語ランタイム クラスを検索するために使用する文字列です。  「[完全限定型名の指定](../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)」に指定されている要件を満たす任意の文字列を使用できます。  
+  
+ 同一のクラスに複数のアルゴリズム名を割り当てることができます。  [\<nameEntry\> 要素](../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md) は 1 個のわかりやすいアルゴリズムにクラス名を割り当てます。  **name** 属性は、**System.Security.Cryptography.CryptoConfig.CreateFromName** メソッドを呼び出すときに使用する文字列または <xref:System.Security.Cryptography> 名前空間の抽象暗号化クラスです。  **class** 属性の値は **\<cryptoClass\>** 要素内の属性の名前です。  
+  
+> [!NOTE]
+>  [System.Security.Cryptography.SHA1.Create](frlrfSystemSecurityCryptographySHA1ClassCreateTopic) メソッドまたは **Security.CryptoConfig.CreateFromName\("SHA1"\)** メソッドを呼び出すことにより SHA1 アルゴリズムを取得できます。  それぞれのメソッドで保証されるのは、SHA1 アルゴリズムを実装するオブジェクトを返すことだけです。  構成ファイル内の同じクラスに、アルゴリズムのそれぞれの表示名を割り当てる必要はありません。  
+  
+ 既定の名前の一覧およびそれらの名前を割り当てるクラスについては、「[CryptoConfig クラス](frlrfSystemSecurityCryptographyCryptoConfigClassTopic)」を参照してください。  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)   
+ [暗号化クラスの設定](../../../docs/framework/configure-apps/configure-cryptography-classes.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md b/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md
new file mode 100644
index 00000000000..0f11e8b5f64
--- /dev/null
+++ b/docs/framework/configure-apps/map-object-identifiers-to-cryptography-algorithms.md
@@ -0,0 +1,57 @@
+---
+title: "暗号化アルゴリズムへのオブジェクト ID の割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号アルゴリズム"
+  - "暗号化, 割り当て (オブジェクト ID の)"
+  - "デジタル署名"
+  - "識別子, 割り当て (オブジェクト ID の)"
+  - "割り当て (オブジェクト ID の)"
+ms.assetid: c9673f81-bf9e-47fd-bc6f-6bc1c1c4c15e
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 暗号化アルゴリズムへのオブジェクト ID の割り当て
+デジタル署名は、データをあるプログラムから別のプログラムへ送信したときに、データが不正に変更されないことを保証するために使用されます。  一般に、デジタル署名は、署名の対象となるデータのハッシュに数値演算関数を適用して計算されます。  署名対象のハッシュ値をフォーマットするときに、一定のデジタル署名アルゴリズムにより、フォーマット操作の一部として ASN.1 OID \(オブジェクト ID\) が付加されます。  OID は、ハッシュの計算に使用されたアルゴリズムを識別します。  アルゴリズムにオブジェクト ID を割り当てることにより、カスタムのアルゴリズムを使用するように暗号機構を拡張できます。  新しいハッシュ アルゴリズムにオブジェクト ID を割り当てる方法を次の例で示します。  
+  
+```  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+            <cryptoClasses>  
+               <cryptoClass MyNewHash="MyNewHashClass, MyAssembly  
+                  Culture='en', PublicKeyToken=a5d015c7d5a0b012,  
+                  Version=1.0.0.0"/>  
+            </cryptoClasses>  
+            <nameEntry name="NewHash" class="MyNewHash"/>  
+         </cryptoNameMapping>  
+         <oidMap>  
+            <oidEntry OID="1.3.14.33.42.46"  name="NewHash"/>  
+         </oidMap>  
+      </cryptographySettings>  
+   </mscorlib>  
+</configuration>  
+```  
+  
+ [\<oidEntry\> 要素](../../../docs/framework/configure-apps/file-schema/cryptography/oidentry-element.md) は 2 個の属性が含まれています。  **OID** 属性は、オブジェクト ID 番号です。  **名前** 属性は [\<nameEntry\> 要素](../../../docs/framework/configure-apps/file-schema/cryptography/nameentry-element.md)から **名前** 属性の値です。  オブジェクト ID に簡易名を割り当てるには、あらかじめ、クラスにアルゴリズム名を割り当てる必要があります。  
+  
+## 参照  
+ [暗号化クラスの設定](../../../docs/framework/configure-apps/configure-cryptography-classes.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/media/clr-addbindingredirect.png b/docs/framework/configure-apps/media/clr-addbindingredirect.png
new file mode 100644
index 00000000000..8a9624a5a6a
Binary files /dev/null and b/docs/framework/configure-apps/media/clr-addbindingredirect.png differ
diff --git a/docs/framework/configure-apps/media/clr-assemblyrefwarning.png b/docs/framework/configure-apps/media/clr-assemblyrefwarning.png
new file mode 100644
index 00000000000..9dcf33d833d
Binary files /dev/null and b/docs/framework/configure-apps/media/clr-assemblyrefwarning.png differ
diff --git a/docs/framework/configure-apps/redirect-assembly-versions.md b/docs/framework/configure-apps/redirect-assembly-versions.md
new file mode 100644
index 00000000000..e2d185006d0
--- /dev/null
+++ b/docs/framework/configure-apps/redirect-assembly-versions.md
@@ -0,0 +1,127 @@
+---
+title: "アセンブリ バージョンのリダイレクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーションの構成 [.NET Framework]"
+  - "アセンブリ [.NET Framework], バインディングのリダイレクト"
+  - "アセンブリのバインディング, リダイレクト"
+  - "構成 [.NET Framework], アプリケーション"
+  - "リダイレクト (アセンブリ バインディングを以前のバージョンに)"
+ms.assetid: 88fb1a17-6ac9-4b57-8028-193aec1f727c
+caps.latest.revision: 26
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 26
+---
+# アセンブリ バージョンのリダイレクト
+コンパイル時のバインド参照のリダイレクト先として、.NET Framework アセンブリ、サードパーティ製のアセンブリ、または独自のアプリのアセンブリを指定できます。 アプリで別のバージョンのアセンブリを使用するようにリダイレクトするには、発行者ポリシーを使用する、アプリ構成ファイルを使用する、コンピューター構成ファイルを使用するなど、さまざまな方法があります。 ここでは、.NET Framework でのアセンブリ バインドの動作の仕組みと、構成方法について説明します。  
+  
+<a name="BKMK_Assemblyunificationanddefaultbinding"></a>   
+## アセンブリの統一と既定のバインド  
+ .NET Framework アセンブリへのバインドは、*アセンブリの統一*というプロセスによってリダイレクトされる場合があります。 .NET Framework は、1 つのバージョンの共通言語ランタイムと、型ライブラリを構成する 24 個前後の .NET Framework アセンブリで構成されています。 これらの .NET Framework アセンブリは、ランタイムによって単一のユニットとして扱われます。 既定では、アプリを起動するとき、ランタイムによって実行されるコード内の型のすべての参照が、プロセスに読み込まれたランタイムと同じバージョン番号を持つ .NET Framework アセンブリにリダイレクトされます。 このモデルで発生するリダイレクトは、ランタイムの既定の動作となります。  
+  
+ たとえば、System.XML 名前空間の型を参照するアプリケーションが、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を使用して作成されている場合、このアプリには、ランタイム バージョン 4.5 と共に出荷された System.XML アセンブリへの静的参照が含まれます。 ここで、.NET Framework 4 と共に出荷された System.XML アセンブリを指すようにバインド参照をリダイレクトする場合は、リダイレクト情報をアプリ構成ファイルに追加します。 構成ファイルで、統一された .NET Framework アセンブリに対するバインド リダイレクトを設定すると、このアセンブリの統一が取り消されます。  
+  
+ また、使用できる複数のバージョンがある場合は、サードパーティ アセンブリのアセンブリ バインドを手動でリダイレクトすることもできます。  
+  
+<a name="BKMK_Redirectingassemblyversionsbyusingpublisherpolicy"></a>   
+## 発行者ポリシーを使用したアセンブリ バージョンのリダイレクト  
+ アセンブリの販売元は、新しいアセンブリに発行者ポリシー ファイルを含めることにより、より新しいバージョンのアセンブリにアプリをリダイレクトできます。 発行者ポリシー ファイルは、グローバル アセンブリ キャッシュに配置され、アセンブリ リダイレクトの設定が格納されます。  
+  
+ アセンブリの *major*.*minor* バージョンごとに、独自の発行者ポリシー ファイルが割り当てられます。 たとえば、バージョン 2.0.2.222 から 2.0.3.000 へのリダイレクトと、バージョン 2.0.2.321 から 2.0.3.000 へのリダイレクトは、いずれもバージョン 2.0 に関連付けられているため、両方とも同じファイルに記述します。 ただし、バージョン 3.0.0.999 から 4.0.0.000 へのリダイレクトは、バージョン 3.0.999 のファイルに記述します。 .NET Framework のメジャー バージョンごとに、独自の発行者ポリシー ファイルが割り当てられます。  
+  
+ アセンブリの発行者ポリシー ファイルが存在する場合、ランタイムは、アセンブリのマニフェストとアプリ構成ファイルをチェックした後で、発行者ポリシー ファイルをチェックします。 販売元は、新しいアセンブリがリダイレクト元のアセンブリとの下位互換性を維持している場合にだけ、発行者ポリシー ファイルを使用するようにします。  
+  
+ 「[発行者ポリシーの省略](#bypass_PP)」で説明するように、アプリ構成ファイルで設定を指定することによって、アプリの発行者ポリシーを省略することができます。  
+  
+<a name="BKMK_Redirectingassemblyversionsattheapplevel"></a>   
+## アプリ レベルでのアセンブリ バージョンのリダイレクト  
+ アプリ構成ファイルを通じてアプリのバインド動作を変更するには、いくつかの手法があります。手動でのファイルの編集、自動バインド リダイレクトの利用、発行者ポリシーの省略によるバインド動作の指定を行うことができます。  
+  
+### 手動でのアプリ構成ファイルの編集  
+ 手動でアプリ構成ファイルを編集して、アセンブリの問題を解決できます。 たとえば、販売元が、アプリで使用しているアセンブリの新しいバージョンをリリースしたが、下位互換性を保証していないために、発行者ポリシーを提供しない場合でも、次のように、アプリ構成ファイルにアセンブリ バインド情報を記述することによって、アプリで新しいバージョンのアセンブリを使用するように指示できます。  
+  
+```  
+<dependentAssembly> <assemblyIdentity name="someAssembly" publicKeyToken="32ab4ba45e0a69a1" culture="en-us" /> <bindingRedirect oldVersion="7.0.0.0" newVersion="8.0.0.0" /> </dependentAssembly>  
+```  
+  
+### 自動バインド リダイレクトの利用  
+ [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] 以降では、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象とする新しいデスクトップ アプリは自動バインド リダイレクトを使用します。 これは、2 つのコンポーネントが同じ厳密な名前付きアセンブリの異なるバージョンを参照する場合、ランタイムは出力するアプリ構成ファイル \(app.config\) に新しいバージョンのアセンブリへのバインド リダイレクトを自動的に追加することを意味します。 このリダイレクトは、別の方法で発生する可能性があるアセンブリの統一をオーバーライドします。 ソース app.config ファイルは変更されません。 たとえば、アプリがアウトオブバンド .NET Framework コンポーネントを直接参照する場合に、同じコンポーネントの旧バージョンを対象とするサードパーティのライブラリを使用しているとします。 このアプリをコンパイルすると、出力されるアプリ構成ファイルは、新しいバージョンのコンポーネントへのバインド リダイレクトを含むように変更されます。 Web アプリを作成すると、バインドの競合に関するビルドの警告が表示され、ソース Web 構成ファイルに必要なバインド リダイレクトを追加するためオプションが示されます。  
+  
+ 手動でソース app.config ファイルにバインド リダイレクトを追加する場合、[!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] はコンパイル時に、追加されたバインド リダイレクトに基づいてアセンブリの統一を試行します。 たとえば、アセンブリの次のバインド リダイレクトを挿入するとします。  
+  
+ `<bindingRedirect oldVersion="3.0.0.0" newVersion="2.0.0.0" />`  
+  
+ アプリ内の別のプロジェクトが同じアセンブリのバージョン 1.0.0.0 を参照する場合、自動バインド リダイレクトは、アプリがこのアセンブリのバージョン 2.0.0.0 で統一されるように、出力 app.config ファイルに次のエントリを追加します。  
+  
+ `<bindingRedirect oldVersion="1.0.0.0" newVersion="2.0.0.0" />`  
+  
+ [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] で、アプリが .NET Framework の旧バージョンを対象とする場合、自動バインド リダイレクトを有効にすることができます。 どのアセンブリについても、app.config ファイルにバインド リダイレクト情報を記述することによって、この既定の動作をオーバーライドし、バインド リダイレクト機能をオフにすることができます。 この機能をオンまたはオフにする方法については、「[方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)」を参照してください。  
+  
+<a name="bypass_PP"></a>   
+### 発行者ポリシーの省略  
+ アプリの構成ファイルの発行者ポリシーを必要に応じてオーバーライドできます。 たとえば、下位互換性を維持しているとされる新しいアセンブリ バージョンでも、アプリを破壊する可能性があります。 発行者ポリシーを省略する場合は、[\<publisherPolicy\>](../../../docs/framework/configure-apps/file-schema/runtime/publisherpolicy-element.md) 要素をアプリケーション構成ファイルの [\<dependentAssembly\>](../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md) 要素に追加し、**apply** 属性を **no** に設定することによって、以前の **yes** の設定がすべてオーバーライドされます。  
+  
+ `<publisherPolicy apply="no" />`  
+  
+ 発行者ポリシーを省略することにより、アプリの実行を続行できますが、必ず、問題点をアセンブリの販売元に報告してください。 アセンブリに発行者ポリシー ファイルを提供した場合、販売元はそのアセンブリが下位互換性を維持していること、およびクライアントが可能な限り新バージョンを使用できることを確認する必要があります。  
+  
+<a name="BKMK_Redirectingassemblyversionsatthemachinelevel"></a>   
+## コンピューター レベルでのアセンブリ バージョンのリダイレクト  
+ コンピューター管理者が 1 台のコンピューター上のすべてのアプリで特定のアセンブリ バージョンを使用する場合も、まれにあります。 たとえば、セキュリティ ホールを修復するために、すべてのアプリで特定のアセンブリ バージョンを使用する場合があります。 コンピューターの構成ファイル内でアセンブリをリダイレクトした場合は、そのコンピューターで旧バージョンを使用しているすべてのアプリが新バージョンを使用するようになります。 コンピューター構成ファイルは、アプリ構成ファイルおよび発行者ポリシー ファイルよりも優先されます。 このファイルは、%*runtime install path*%\\Config ディレクトリに含まれています。 通常、.NET Framework は %drive%\\Windows\\Microsoft.NET\\Framework ディレクトリにインストールされます。  
+  
+<a name="BKMK_Specifyingassemblybindinginconfigurationfiles"></a>   
+## 構成ファイル内でのアセンブリ バインドの指定  
+ アプリ構成ファイル、コンピューター構成ファイル、発行者ポリシー ファイルのいずれの場合も、同じ XML 形式を使用してバインド リダイレクトを指定できます。 あるバージョンのアセンブリを別のバージョンにリダイレクトするには、[\<bindingRedirect\>](../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md) 要素を使用します。**oldVersion** 属性では、1 つのアセンブリ バージョンまたはバージョンの範囲を指定できます。`newVersion` 属性では、1 つのバージョンを指定する必要があります。  たとえば、`<bindingRedirect oldVersion="1.1.0.0-1.2.0.0" newVersion="2.0.0.0"/>` は、アセンブリ バージョン 1.1.0.0 ～ 1.2.0.0 の代わりにバージョン 2.0.0.0 を使用するようにランタイムに指示します。  
+  
+ 次のコード例は、さまざまなバインディング リダイレクトのシナリオを示しています。 この例では、`myAssembly` のバージョンの範囲に対するリダイレクトと、`mySecondAssembly` の単一のバインド リダイレクトを指定します。 この例では、発行者ポリシー ファイルによって `myThirdAssembly` のバインド リダイレクトがオーバーライドされないことも指定しています。  
+  
+ アセンブリをバインドするには、**\<assemblyBinding\>** タグ内の [xmlns](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md) 属性に対して文字列 "urn:schemas\-microsoft\-com:asm.v1" を指定する必要があります。  
+  
+```  
+<configuration> <runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <dependentAssembly> <assemblyIdentity name="myAssembly" publicKeyToken="32ab4ba45e0a69a1" culture="en-us" /> <!-- Assembly versions can be redirected in app, publisher policy, or machine configuration files. --> <bindingRedirect oldVersion="1.0.0.0-2.0.0.0" newVersion="3.0.0.0" /> </dependentAssembly> <dependentAssembly> <assemblyIdentity name="mySecondAssembly" publicKeyToken="32ab4ba45e0a69a1" culture="en-us" /> <bindingRedirect oldVersion="1.0.0.0" newVersion="2.0.0.0" /> </dependentAssembly> <dependentAssembly> <assemblyIdentity name="myThirdAssembly" publicKeyToken="32ab4ba45e0a69a1" culture="en-us" /> <!-- Publisher policy can be set only in the app configuration file. --> <publisherPolicy apply="no" /> </dependentAssembly> </assemblyBinding> </runtime> </configuration>  
+```  
+  
+### 特定のバージョンへのアセンブリ バインドの制限  
+ アプリ構成ファイルの **\<assemblyBinding\>** 要素で [appliesTo](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md) 属性を使用して、アセンブリ バインドの参照を特定のバージョンの .NET Framework にリダイレクトできます。 このオプションの属性では、.NET Framework バージョン番号を使用して、適用するバージョンを指定します。**appliesTo** 属性が指定されていない場合、[\<assemblyBinding\>](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md) 要素は .NET Framework のすべてのバージョンに適用されます。  
+  
+ たとえば、.NET Framework 3.5 アセンブリのアセンブリ バインドをリダイレクトするには、アプリ構成ファイルに次の XML コードを追加します。  
+  
+```  
+<runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v3.5"> <dependentAssembly> <!-- assembly information goes here --> </dependentAssembly> </assemblyBinding> </runtime>  
+```  
+  
+ バージョンの順序でリダイレクト情報を入力する必要があります。 たとえば、.NET Framework 3.5 アセンブリのアセンブリ バインド リダイレクト情報を入力し、次に .NET Framework 4.5 アセンブリの情報を入力します。 最後に、**appliesTo** 属性を使用せず、すべてのバージョンの .NET Framework に適用される .NET Framework アセンブリ リダイレクトのアセンブリ バインディング リダイレクト情報を入力します。 リダイレクトで競合が発生した場合は、構成ファイル内で最初に一致したリダイレクト ステートメントが使用されます。  
+  
+ たとえば、ある参照を .NET Framework 3.5 のアセンブリにリダイレクトし、別の参照を .NET Framework 4 のアセンブリにリダイレクトするには、次の擬似コードに示すパターンを使用します。  
+  
+```  
+<assemblyBinding xmlns="..." appliesTo="v3.5 "> <!—.NET Framework version 3.5 redirects here --> </assemblyBinding> <assemblyBinding xmlns="..." appliesTo="v4.0.30319"> <!—.NET Framework version 4.0 redirects here --> </assemblyBinding> <assemblyBinding xmlns="..."> <!-- redirects meant for all versions of the runtime --> </assemblyBinding>  
+```  
+  
+## 参照  
+ [方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)   
+ [\<bindingRedirect\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md)   
+ [アセンブリ バインディング リダイレクトのセキュリティ アクセス許可](../../../docs/framework/configure-apps/assembly-binding-redirection-security-permission.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [アプリの構成](../../../docs/framework/configure-apps/index.md)   
+ [.NET Framework アプリの構成](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)   
+ [ランタイム設定スキーマ](../../../docs/framework/configure-apps/file-schema/runtime/index.md)   
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [方法 : 発行者ポリシーを作成する](../../../docs/framework/configure-apps/how-to-create-a-publisher-policy.md)
\ No newline at end of file
diff --git a/docs/framework/configure-apps/specify-assembly-location.md b/docs/framework/configure-apps/specify-assembly-location.md
new file mode 100644
index 00000000000..e19d5a0c746
--- /dev/null
+++ b/docs/framework/configure-apps/specify-assembly-location.md
@@ -0,0 +1,84 @@
+---
+title: "アセンブリの場所の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーションの構成 [.NET Framework]"
+  - "アセンブリ [.NET Framework], 指定 (場所を)"
+  - "構成 [.NET Framework], アプリケーション"
+ms.assetid: 1cb92bd7-6bab-44cf-8fd3-36303ce84fea
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# アセンブリの場所の指定
+アセンブリの場所は、次の 2 とおりの方法で指定できます。  
+  
+-   [\<コードベース\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素を使用します。  
+  
+-   [\<プローブ\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素を使用します。  
+  
+ [.NET Framework 構成ツール](http://msdn.microsoft.com/ja-jp/a7106c52-68da-490e-b129-971b2c743764)を使用して、アセンブリの場所または共通言語ランタイムがアセンブリを検索する場所を指定することもできます。  
+  
+## codeBase 要素\>  \<を使用します。  
+ 、アセンブリ バージョンのリダイレクトする発行者ポリシー ファイルまたはマシン構成ファイルにのみ **\<codeBase\>** 要素を使用できます。  ランタイムは使用するアセンブリ バージョンを決定するときに、バージョンを決定するファイルからコード ベース設定を適用します。  コード ベースが指定されていない場合は、通常の方法でアセンブリを検索します。  詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+ アセンブリの場所を指定する方法の例を次に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+       <dependentAssembly>  
+         <assemblyIdentity name="myAssembly"  
+                           publicKeyToken="32ab4ba45e0a69a1"  
+                           culture="en-us" />  
+         <codeBase version="2.0.0.0"  
+                   href="http://www.litwareinc.com/myAssembly.dll"/>  
+       </dependentAssembly>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+ **version** 属性は、厳密な名前の付いたすべてのアセンブリに対して設定する必要がありますが、厳密な名前が付いていないアセンブリについては省略してください。  **\<codeBase\>** 要素は **href** 属性が必要です。  **\<codeBase\>** 要素のバージョンの範囲は指定できません。  
+  
+> [!NOTE]
+>  厳密な名前の付いていないアセンブリに対してコード ベースのヒントを提供する場合は、そのヒントでアセンブリ ベースまたはアプリケーション ベース ディレクトリのサブディレクトリを示す必要があります。  
+  
+## プローブ \<\> 要素を使用します。  
+ ランタイムは、コード ベースを持たないアセンブリの場所を検索して特定します。  検索の詳細については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+ アプリケーション構成ファイルでランタイムが検索するサブディレクトリを指定するために [\<プローブ\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素を使用して、アセンブリの場所を特定するとき。  ランタイムが検索するディレクトリを指定する方法の例を次に示します。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
+         <probing privatePath="bin;bin2\subbin;bin3"/>  
+      </assemblyBinding>  
+   </runtime>  
+</configuration>  
+```  
+  
+ **privatePath** 属性に、ランタイムがアセンブリを検索する必要があるディレクトリを指定します。  アプリケーションが C:\\Program Files\\MyApp に配置されている場合、ランタイムは、コード ベースが指定されていないアセンブリを C:\\Program Files\\MyApp\\Bin、C:\\Program Files\\MyApp\\Bin2\\Subbin、および C:\\Program Files\\MyApp\\Bin3 内で検索します。  **privatePath** に指定するディレクトリは、アプリケーション ベース ディレクトリのサブディレクトリであることが必要です。  
+  
+## 参照  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [Configuring .NET Framework Apps](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)
\ No newline at end of file
diff --git a/docs/framework/data/TOC.md b/docs/framework/data/TOC.md
new file mode 100644
index 00000000000..304e646f445
--- /dev/null
+++ b/docs/framework/data/TOC.md
@@ -0,0 +1 @@
+# [データとモデリング](index.md)
diff --git a/docs/framework/data/adonet/TOC.md b/docs/framework/data/adonet/TOC.md
new file mode 100644
index 00000000000..0c08f461ff2
--- /dev/null
+++ b/docs/framework/data/adonet/TOC.md
@@ -0,0 +1,156 @@
+# [アソシエーション セット End](association-set-end.md)
+# [ADO.NET のアーキテクチャ](ado-net-architecture.md)
+# [SQL Server データ型のマッピング](sql-server-data-type-mappings.md)
+# [Set Operators](method-based-query-syntax-examples-set-operators.md)
+# [クエリ結果のページング](paging-through-a-query-result.md)
+# [Query Expression Examples](query-expression-examples-linq-to-dataset.md)
+# [Join Operators](query-expression-syntax-examples-join-operators.md)
+# [Debugging LINQ to DataSet Queries](debugging-linq-to-dataset-queries.md)
+# [トランザクションと同時実行](transactions-and-concurrency.md)
+# [コマンドを使用したデータ変更](using-commands-to-modify-data.md)
+# [DataAdapter パラメーター](dataadapter-parameters.md)
+# [Element Operators](method-based-query-syntax-examples-element-operators.md)
+# [ADO.NET の概要](ado-net-overview.md)
+# [Oracle データ型のマッピング](oracle-data-type-mappings.md)
+# [Downloading Sample Databases](downloading-sample-databases-linq-to-dataset.md)
+# [DataAdapter によるバッチ操作の実行](performing-batch-operations-using-dataadapters.md)
+# [カタログ操作の実行](performing-catalog-operations.md)
+# [オプティミスティック同時実行制御](optimistic-concurrency.md)
+# [DbDataAdapter を使用したデータの変更](modifying-data-with-a-dbdataadapter.md)
+# [LINQ to DataSet Examples](linq-to-dataset-examples.md)
+# [LINQ to DataSet Overview](linq-to-dataset-overview.md)
+# [ID 値および Autonumber 値の取得](retrieving-identity-or-autonumber-values.md)
+# [ADO.NET でのデータ型のマッピング](data-type-mappings-in-ado-net.md)
+# [Method-Based Query Examples](method-based-query-examples-linq-to-dataset.md)
+# [Oracle データ型のマッピング](oracle-data-type-mappings-2.md)
+# [DataAdapter によるデータ ソースの更新](updating-data-sources-with-dataadapters.md)
+# [ナビゲーション プロパティ](navigation-property.md)
+# [DataAdapter DataTable と DataColumn のマップ](dataadapter-datatable-and-datacolumn-mappings.md)
+# [DataAdapter と DataReader](dataadapters-and-datareaders.md)
+# [Element Operators](query-expression-syntax-examples-element-operators.md)
+# [ADO.NET テクノロジのオプションとガイドライン](ado-net-technology-options-and-guidelines.md)
+# [Oracle REF CURSOR](oracle-ref-cursors.md)
+# [SQL Server スキーマ コレクション](sql-server-schema-collections.md)
+# [Entity Data Model キーの概念](entity-data-model-key-concepts.md)
+# [SqlClient ストリーミング サポート](sqlclient-streaming-support.md)
+# [Oracle 分散トランザクション](oracle-distributed-transactions.md)
+# [REF CURSOR の例](ref-cursor-examples.md)
+# [Queries in LINQ to DataSet](queries-in-linq-to-dataset.md)
+# [ADO.NET のコード例](ado-net-code-examples.md)
+# [LINQ と ADO.NET](linq-and-ado-net.md)
+# [Partitioning](query-expression-syntax-examples-partitioning.md)
+# [Querying DataSets](querying-datasets-linq-to-dataset.md)
+# [Querying the DataRowView Collection in a DataView](querying-the-datarowview-collection-in-a-dataview.md)
+# [コマンドとパラメーター](commands-and-parameters.md)
+# [ファクトリ モデルの概要](factory-model-overview.md)
+# [SQL Server と System.Transactions の統合](system-transactions-integration-with-sql-server.md)
+# [データベースからの単一の値の取得](obtaining-a-single-value-from-a-database.md)
+# [How to: Implement CopyToDataTable<T> Where the Generic Type T Is Not a DataRow](implement-copytodatatable-where-type-not-a-datarow.md)
+# [Querying Typed DataSets](querying-typed-datasets.md)
+# [モデル宣言関数](model-declared-function.md)
+# [プロパティ](property.md)
+# [エンティティ型](entity-type.md)
+# [ADO.NET でのデータ トレース](data-tracing.md)
+# [アソシエーション セット](association-set.md)
+# [Partitioning](method-based-query-syntax-examples-partitioning-linq.md)
+# [Loading Data Into a DataSet](loading-data-into-a-dataset.md)
+# [DbProviderFactory の取得](obtaining-a-dbproviderfactory.md)
+# [Conversion Operators](method-based-query-syntax-examples-conversion-operators.md)
+# [ADO.NET での side-by-side 実行](side-by-side-execution.md)
+# [データ ソースへの接続](connecting-to-a-data-source.md)
+# [1 つまたは複数の REF CURSOR を使用した DataSet の値の設定](filling-a-dataset-using-one-or-more-ref-cursors.md)
+# [Entity Data Model: 名前空間](entity-data-model-namespaces.md)
+# [DataReader によるデータの取得](retrieving-data-using-a-datareader.md)
+# [Programming Guide](programming-guide-linq-to-dataset.md)
+# [Getting Started](getting-started-linq-to-dataset.md)
+# [接続プール](connection-pooling.md)
+# [コード アクセス セキュリティと ADO.NET](code-access-security.md)
+# [ファセット](facet.md)
+# [DataView Performance](dataview-performance.md)
+# [Comparing DataRows](comparing-datarows-linq-to-dataset.md)
+# [DataSet-Specific Operator Examples](dataset-specific-operator-examples-linq-to-dataset.md)
+# [Ordering](method-based-query-syntax-examples-ordering-linq-to-dataset.md)
+# [Oracle および ADO.NET](oracle-and-adonet.md)
+# [モデル定義関数](model-defined-function.md)
+# [ローカル トランザクション](local-transactions.md)
+# [Oracle スキーマ コレクション](oracle-schema-collections.md)
+# [Sorting with DataView](sorting-with-dataview-linq-to-dataset.md)
+# [Aggregate Operators](query-expression-syntax-examples-aggregate-operators.md)
+# [非同期プログラミング](asynchronous-programming.md)
+# [接続文字列ビルダー](connection-string-builders.md)
+# [ADO.NET データセット](ado-net-datasets.md)
+# [OracleDataReader の REF CURSOR パラメーター](ref-cursor-parameters-in-an-oracledatareader.md)
+# [SQL Server の接続プール (ADO.NET)](sql-server-connection-pooling.md)
+# [ストアド プロシージャでのデータの変更](modifying-data-with-stored-procedures.md)
+# [GetSchema およびスキーマ コレクション](getschema-and-schema-collections.md)
+# [データベース スキーマ情報の取得](retrieving-database-schema-information.md)
+# [Entity Data Model: プリミティブ データ型](entity-data-model-primitive-data-types.md)
+# [Creating a DataView Object](creating-a-dataview-object-linq-to-dataset.md)
+# [接続文字列](connection-strings.md)
+# [LINQ to DataSet](linq-to-dataset.md)
+# [スキーマの制限](schema-restrictions.md)
+# [浮動小数点数](floating-point-numbers.md)
+# [ADO.NET でのデータの取得および変更](retrieving-and-modifying-data.md)
+# [分散トランザクション](distributed-transactions.md)
+# [CommandBuilder でのコマンドの生成](generating-commands-with-commandbuilders.md)
+# [Cross-Table Queries](cross-table-queries-linq-to-dataset.md)
+# [Ordering](query-expression-syntax-examples-ordering-linq-to-dataset.md)
+# [複合型](complex-type.md)
+# [OLE DB スキーマ コレクション](ole-db-schema-collections.md)
+# [安全なクライアント アプリケーション](secure-client-applications.md)
+# [Security](security-linq-to-dataset.md)
+# [Aggregate Operators](method-based-query-syntax-examples-aggregate-operators.md)
+# [ADO.NET](index.md)
+# [接続イベント](connection-events.md)
+# [エンティティ セット](entity-set.md)
+# [DbConnection、DbCommand、および DbException](dbconnection-dbcommand-and-dbexception.md)
+# [バイナリ データの取得](retrieving-binary-data.md)
+# [Filtering with DataView](filtering-with-dataview-linq-to-dataset.md)
+# [データ ソースのデータの更新](updating-data-in-a-data-source.md)
+# [パラメーターおよびパラメーター データ型の構成](configuring-parameters-and-parameter-data-types.md)
+# [共通のスキーマ コレクション](common-schema-collections.md)
+# [Join](method-based-query-syntax-examples-join-linq-to-dataset.md)
+# [How to: Create a LINQ to DataSet Project In Visual Studio](how-to-create-a-linq-to-dataset-project-in-vs.md)
+# [Projection](query-expression-syntax-examples-projection-linq-to-dataset.md)
+# [安全なデータ アクセス](secure-data-access.md)
+# [プライバシーとデータ セキュリティ](privacy-and-data-security.md)
+# [ODBC データ型のマッピング](odbc-data-type-mappings.md)
+# [Entity Data Model: 継承](entity-data-model-inheritance.md)
+# [コマンドの実行](executing-a-command.md)
+# [DataAdapter からの DataSet の読み込み](populating-a-dataset-from-a-dataadapter.md)
+# [参照整合性制約](referential-integrity-constraint.md)
+# [ADO.NET の新機能](whats-new.md)
+# [接続の確立](establishing-the-connection.md)
+# [接続文字列と構成ファイル](connection-strings-and-configuration-files.md)
+# [OracleDataReader を使用した複数の REF CURSOR からのデータの取得](retrieving-data-from-multiple-ref-cursors.md)
+# [Oracle BFILE](oracle-bfiles.md)
+# [アソシエーション End の多重度](association-end-multiplicity.md)
+# [セキュリティの概要 ](security-overview.md)
+# [Data Binding and LINQ to DataSet](data-binding-and-linq-to-dataset.md)
+# [DataSet への既存の制約の追加](adding-existing-constraints-to-a-dataset.md)
+# [Entity Data Model](entity-data-model.md)
+# [アソシエーション End](association-end.md)
+# [OLE DB、ODBC、および Oracle 接続プール](ole-db-odbc-and-oracle-connection-pooling.md)
+# [How to: Bind a DataView Object to a Windows Forms DataGridView Control](how-to-bind-a-dataview-object-to-a-winforms-datagridview-control.md)
+# [DbProviderFactories](dbproviderfactories.md)
+# [Oracle シーケンス](oracle-sequences.md)
+# [Oracle LOB](oracle-lobs.md)
+# [アソシエーション型](association-type.md)
+# [外部キーのプロパティ](foreign-key-property.md)
+# [Restriction](query-expression-syntax-examples-restriction-linq-to-dataset.md)
+# [ODBC スキーマ コレクション](odbc-schema-collections.md)
+# [Creating a DataTable From a Query](creating-a-datatable-from-a-query-linq-to-dataset.md)
+# [Generic Field and SetField Methods](generic-field-and-setfield-methods-linq-to-dataset.md)
+# [OracleType](oracletypes.md)
+# [エンティティ コンテナー](entity-container.md)
+# [接続情報の保護](protecting-connection-information.md)
+# [DataAdapter のイベント処理](handling-dataadapter-events.md)
+# [Projection](method-based-query-syntax-examples-projection.md)
+# [エンティティ キー](entity-key.md)
+# [Single-Table Queries](single-table-queries-linq-to-dataset.md)
+# [ADO.NET でのパフォーマンス カウンター](performance-counters.md)
+# [接続文字列の構文](connection-string-syntax.md)
+# [システム要件](system-requirements-for-the-dotnet-data-provider-for-oracle.md)
+# [OLE DB データ型のマッピング](ole-db-data-type-mappings.md)
+# [.NET Framework データ プロバイダー](data-providers.md)
+# [ADO.NET アプリケーションのセキュリティ保護](securing-ado-net-applications.md)
diff --git a/docs/framework/data/adonet/adding-existing-constraints-to-a-dataset.md b/docs/framework/data/adonet/adding-existing-constraints-to-a-dataset.md
new file mode 100644
index 00000000000..325267aaf9d
--- /dev/null
+++ b/docs/framework/data/adonet/adding-existing-constraints-to-a-dataset.md
@@ -0,0 +1,71 @@
+---
+title: "DataSet への既存の制約の追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 307d2809-208b-4cf8-b6a9-5d16f15fc16c
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet への既存の制約の追加
+**DataAdapter** の **Fill** メソッドは、<xref:System.Data.DataSet> にデータ ソースからのテーブルの列および行だけを格納します。制約は一般にデータ ソースで設定されますが、既定では **Fill** メソッドは **DataSet** にスキーマ情報を追加しません。  データ ソースからの既存の主キー制約情報を **DataSet** に設定するには、**DataAdapter** の **FillSchema** メソッドを呼び出すか、または **Fill** を呼び出す前に **DataAdapter** の **MissingSchemaAction** プロパティを **AddWithKey** に設定します。  これにより、データ ソースの主キー制約が **DataSet** の主キー制約に反映されます。  外部キー制約情報はインクルードされないため、「[DataTable の制約](../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md)」で示すように明示的に作成する必要があります。  
+  
+ **DataSet** 内にデータを格納する前にスキーマ情報を追加すると、主キー制約が **DataSet** 内の <xref:System.Data.DataTable> オブジェクトにインクルードされます。  その結果、**DataSet** に対して格納を行う追加の呼び出しを行ったとき、その主キー列情報を使用してデータ ソースから得られた新しい行と各 **DataTable** の現在の行を一致させ、各テーブルの現在のデータをデータ ソースのデータで上書きします。  スキーマ情報がないと、**DataSet** にデータ ソースからの新しい行が付け加えられ、重複行が発生します。  
+  
+> [!NOTE]
+>  データ ソースの列を自動インクリメント列として指定した場合は、**FillSchema** メソッド \(**MissingSchemaAction** を **AddWithKey** に設定した **Fill** メソッド\) が、**AutoIncrement** プロパティを `true` に設定した **DataColumn** を作成します。  ただし、**AutoIncrementStep** 値と **AutoIncrementSeed** 値は明示的に設定する必要があります。  自動インクリメント列の詳細については、「[AutoIncrement 列の作成](../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md)」を参照してください。  
+  
+ **FillSchema** の使用や **MissingSchemaAction** の設定を **AddWithKey** にする場合、データ ソースで主キー列情報を確認するための追加の処理が必要になります。  この追加の処理によりパフォーマンスが低下する場合があります。  デザイン時に主キー情報がわかっている場合は、最適のパフォーマンスを得るために主キー列 \(複数の場合もある\) を明示的に指定することをお勧めします。  テーブルに関する主キー情報を明示的に設定する方法については、「[主キーの定義](../../../../docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md)」を参照してください。  
+  
+ **FillSchema** を使用して **DataSet** にスキーマ情報を追加する方法を次のコード サンプルに示します。  
+  
+```vb  
+Dim custDataSet As DataSet = New DataSet()  
+  
+custAdapter.FillSchema(custDataSet, SchemaType.Source, "Customers")  
+custAdapter.Fill(custDataSet, "Customers")  
+```  
+  
+```csharp  
+DataSet custDataSet = new DataSet();  
+  
+custAdapter.FillSchema(custDataSet, SchemaType.Source, "Customers");  
+custAdapter.Fill(custDataSet, "Customers");  
+```  
+  
+ **Fill** メソッドの **MissingSchemaAction.AddWithKey** プロパティを使用してスキーマ情報を **DataSet** に追加する方法を次のコード サンプルに示します。  
+  
+```vb  
+Dim custDataSet As DataSet = New DataSet()  
+  
+custAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey  
+custAdapter.Fill(custDataSet, "Customers")  
+```  
+  
+```csharp  
+DataSet custDataSet = new DataSet();  
+  
+custAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;  
+custAdapter.Fill(custDataSet, "Customers");  
+```  
+  
+## 複数の結果セットの処理  
+ **DataAdapter** は、**SelectCommand** から返された複数の結果セットを検出すると **DataSet** に複数のテーブルを作成します。  これらのテーブルには、0 から始まるインクリメンタル既定名 **Table** *N* が割り当てられます。したがって "Table0" ではなく、**Table** から始まります。  テーブル名が **FillSchema** メソッドに引数として渡されると、0 からから始まるインクリメンタル名 **TableName** *N* が割り当てられます。ここでは、"TableName0" ではなく **TableName** から始まります。  
+  
+> [!NOTE]
+>  **OleDbDataAdapter** オブジェクトの **FillSchema** メソッドが複数の結果セットを返すコマンドとして呼び出された場合は、最初の結果セットのスキーマ情報が返されます。  **OleDbDataAdapter** を使用して複数の結果セットのスキーマ情報を返すときは、**Fill** メソッドを呼び出すときに **AddWithKey** に設定した **MissingSchemaAction** を指定してスキーマ情報を取得することをお勧めします。  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ado-net-architecture.md b/docs/framework/data/adonet/ado-net-architecture.md
new file mode 100644
index 00000000000..4154e99db9d
--- /dev/null
+++ b/docs/framework/data/adonet/ado-net-architecture.md
@@ -0,0 +1,68 @@
+---
+title: "ADO.NET のアーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fcd45b99-ae8f-45ab-8b97-d887beda734e
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET のアーキテクチャ
+従来のデータ処理は、主に接続をベースとした 2 層モデルに基づいていました。  近年、データ処理では多層アーキテクチャの採用が増えてきており、アプリケーションのスケーラビリティを高める非接続型アプローチが主流になりつつあります。  
+  
+## ADO.NET のコンポーネント  
+ データのアクセスと操作を実行する、[!INCLUDE[ado_orcas_long](../../../../includes/ado-orcas-long-md.md)] の 2 つの主要コンポーネントが、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーと <xref:System.Data.DataSet> です。  
+  
+### .NET Framework データ プロバイダー  
+ .NET Framework データ プロバイダーは、データの操作と、データに対する高速かつ前方参照専用、読み込み専用のアクセスを実行することを明確な目標としてデザインされたコンポーネントです。  `Connection` オブジェクトはデータ ソースへの接続を実現します。  `Command` オブジェクトによりデータベース コマンドにアクセスし、データの取得、データの修正、ストアド プロシージャの実行、およびパラメーター情報の送信または取得を実行できます。  `DataReader` は、データ ソースからのパフォーマンスの高いデータ ストリームを実現します。  最後に、`DataAdapter` は `DataSet` オブジェクトとデータ ソース間のブリッジとして機能します。  `DataAdapter` では `Command` オブジェクトを使用してデータ ソースに対して SQL コマンドを実行して、`DataSet` にデータを読み込むと同時に、`DataSet` のデータに加えられた変更をデータ ソースと調整します。  詳細については、「[.NET Framework データ プロバイダー](../../../../docs/framework/data/adonet/data-providers.md)」および「[ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)」を参照してください。  
+  
+### DataSet  
+ ADO.NET `DataSet` は、どのデータ ソースにも依存しないデータ アクセスを行うことを目的としています。  したがって、複数の異なるデータ ソースと併用したり、XML データと併用したり、アプリケーションにとってローカルなデータを管理するために使用したりできます。  `DataSet` には、1 つ以上の <xref:System.Data.DataTable> オブジェクトのコレクションが含まれます。このオブジェクトは、データの行と列に加え、主キー、外部キー、制約、および `DataTable` オブジェクトのリレーション情報で構成されます。  詳細については、「[DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)」を参照してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーと `DataSet` のリレーションシップを次の図に示します。  
+  
+ ![ADO.Net グラフィック](../../../../docs/framework/data/adonet/media/ado-1-bpuedev11.png "ado\_1\_bpuedev11")  
+ADO.NET のアーキテクチャ  
+  
+### DataReader または DataSet の選択  
+ アプリケーションで `DataReader` \(「[DataReader によるデータの取得](../../../../docs/framework/data/adonet/retrieving-data-using-a-datareader.md)」を参照\) または `DataSet` \(「[DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)」を参照\) を使用する必要があるかどうかを判断するには、アプリケーションで必要な機能の種類を検討する必要があります。  以下を実行する場合は `DataSet` を使用します。  
+  
+-   アプリケーションでデータをローカルにキャッシュすると、そのデータを操作できます。  クエリの実行結果を読み取るだけで良い場合は、`DataReader` の使用をお勧めします。  
+  
+-   層間で、または XML Web サービスからデータをリモート処理する場合。  
+  
+-   Windows フォーム コントロールとの連結、または複数ソースに属するデータの組み合わせや関連付けなど、データと動的に対話する場合。  
+  
+-   データ ソースとの接続を開かずにデータに対する広範な処理を実行する場合。他のクライアントが使用できるように、接続が解放されます。  
+  
+ `DataSet` の機能が必要ない場合は、`DataReader` を使用して前方参照専用、読み取り専用の方法でデータを返すことにより、アプリケーションのパフォーマンスを向上させることができます。  `DataAdapter` は `DataReader` を使用して `DataSet` の内容を入力しますが \(「[DataAdapter からの DataSet の読み込み](../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)」を参照\)、`DataReader` を使用することでパフォーマンスを向上させることができます。これは、`DataSet` が消費するメモリが節約され、さらに `DataSet` の内容の作成と入力に必要な処理が不要になるためです。  
+  
+## LINQ to DataSet  
+ LINQ to DataSet はクエリ機能を備え、DataSet オブジェクトでキャッシュされたデータに対するコンパイル時の型チェックを行います。  これを使用すると、C\# や Visual Basic などのいずれかの .NET Framework 開発言語でクエリを記述できます。  詳細については、「[LINQ to DataSet](../../../../docs/framework/data/adonet/linq-to-dataset.md)」を参照してください。  
+  
+## LINQ to SQL  
+ LINQ to SQL では、リレーショナル データベースのデータ構造と対応付けられたオブジェクト モデルに対し、中間概念モデルを使用することなくクエリを実行できます。  それぞれのテーブルは独立したクラスで表現され、オブジェクト モデルとリレーショナル データベース スキーマとが緊密に結び付けられます。  LINQ to SQL では、オブジェクト モデルの統合言語クエリが Transact\-SQL に変換され、データベースに送信されて実行されます。  データベースから結果が返されると、LINQ to SQL によって、その結果が再びオブジェクトへと変換されます。  詳細については、「[LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md)」を参照してください。  
+  
+## ADO.NET Entity Framework  
+ ADO.NET Entity Framework は、開発者がリレーショナル ストレージ スキーマに対して直接プログラムを作成するのではなく、概念アプリケーション モデルに対してプログラムを作成して、データ アクセス アプリケーションを作成できるように設計されています。  その目的は、データ指向アプリケーションに必要なコードの量と保守作業の量を減らすことです。  詳細については、「[ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md)」を参照してください。  
+  
+## WCF Data Services  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、Web またはイントラネットにデータ サービスを展開するために使用されます。  データは、エンティティ データ モデルの仕様に従ってエンティティおよびリレーションシップとして構成されます。  このモデルで展開されるデータは、標準 HTTP プロトコルによってアドレス指定可能です。  詳細については、「[WCF Data Services 4.5](../../../../docs/framework/data/wcf/index.md)」を参照してください。  
+  
+## XML と ADO.NET  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では XML の機能を活用して、データに対する非接続型アクセス機能を実現します。  [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の XML クラスと密接に連携するように設計されています。これらはいずれも同じアーキテクチャに属するコンポーネントです。  
+  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] と、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の XML クラスは、`DataSet` オブジェクトに集約されています。  `DataSet` に、XML ソース \(ファイルまたは XML ストリーム\) に含まれるデータを入力できます。  `DataSet` は、XML スキーマ定義言語 \(XSD\) スキーマを含む、W3C \(World Wide Web Consortium\) 準拠の XML として作成できます。これには `DataSet` 内のデータのソースは関係ありません。  `DataSet` のネイティブのシリアル化形式は XML であることから、層間でデータを移動するための媒体として優れており、XML Web サービスとの間でデータとスキーマ コンテキストをリモート処理する場合には `DataSet` が最適な選択となります。  詳細については、「[XML ドキュメントと XML データ](../../../../docs/standard/data/xml/index.md)」を参照してください。  
+  
+## 参照  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ado-net-code-examples.md b/docs/framework/data/adonet/ado-net-code-examples.md
new file mode 100644
index 00000000000..8631a572a65
--- /dev/null
+++ b/docs/framework/data/adonet/ado-net-code-examples.md
@@ -0,0 +1,384 @@
+---
+title: "ADO.NET のコード例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c119657a-9ce6-4940-91e4-ac1d5f0d9584
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# ADO.NET のコード例
+このトピックにリストされたコードは、次の ADO.NET テクノロジを使用してデータベースからデータを取得する方法を示しています。  
+  
+-   ADO.NET データ プロバイダー:   
+  
+    -   [SqlClient](#_SqlClient) (`System.Data.SqlClient`)  
+  
+    -   [OleDb](#_OleDb) (`System.Data.OleDb`)  
+  
+    -   [Odbc](#_Odbc) (`System.Data.Odbc`)  
+  
+    -   [OracleClient](#_OracleClient) (`System.Data.OracleClient`)  
+  
+-   ADO.NET Entity Framework:  
+  
+    -   [LINQ to Entities](#_LINQ)  
+  
+    -   [型指定された ObjectQuery](#_QBM)  
+  
+    -   [EntityClient](#_EntityClient) (`System.Data.EntityClient`)  
+  
+-   [LINQ to SQL](#_LINQ2SQL)  
+  
+## <a name="adonet-data-provider-examples"></a>ADO.NET データ プロバイダーの例  
+ 以下に示した各コードは、ADO.NET データ プロバイダーを使用してデータベースからデータを取得する方法を示しています。 データは `DataReader` で返されます。 詳細については、次を参照してください。 [DataReader によるデータの取得](../../../../docs/framework/data/adonet/retrieving-data-using-a-datareader.md)します。  
+  
+<a name="_SqlClient"></a>   
+### <a name="sqlclient"></a>SqlClient  
+ このコード例は、Microsoft `Northwind` の [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] サンプル データベースに接続できることを前提としています。 このコードを作成、 <xref:System.Data.SqlClient.SqlCommand> Products テーブルから行を選択するを追加する、 <xref:System.Data.SqlClient.SqlParameter>を指定したパラメーター値では、この場合は 5 よりも大きな UnitPrice を持つ行に結果を制限します。 <xref:System.Data.SqlClient.SqlConnection>内に開かれ、`using`によってリソースが閉じられ、破棄、コードが終了したときに、ブロックします。 コードを使用してコマンドを実行する、 <xref:System.Data.SqlClient.SqlDataReader>、し、コンソール ウィンドウに結果を表示します。  
+  
+  [DataWorks SampleApp.SqlClient#1](../CodeSnippet/VS_Snippets_ADO.NET/DataWorks SampleApp.SqlClient#1)]  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_OleDb"></a>   
+### <a name="oledb"></a>OleDb  
+ このコード例は、Microsoft Access の Northwind サンプル データベースに接続できることを前提としています。 このコードを作成、 <xref:System.Data.OleDb.OleDbCommand> Products テーブルから行を選択するを追加する、 <xref:System.Data.OleDb.OleDbParameter>を指定したパラメーター値では、この場合は 5 よりも大きな UnitPrice を持つ行に結果を制限します。 <xref:System.Data.OleDb.OleDbConnection>内に開かれ、`using`によってリソースが閉じられ、破棄、コードが終了したときに、ブロックします。 コードを使用してコマンドを実行する、 <xref:System.Data.OleDb.OleDbDataReader>、し、コンソール ウィンドウに結果を表示します。  
+  
+  [DataWorks SampleApp.OleDb#1](../CodeSnippet/VS_Snippets_ADO.NET/DataWorks SampleApp.OleDb#1)]  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_Odbc"></a>   
+### <a name="odbc"></a>Odbc  
+ このコード例は、Microsoft Access の Northwind サンプル データベースに接続できることを前提としています。 このコードを作成、 <xref:System.Data.Odbc.OdbcCommand> Products テーブルから行を選択するを追加する、 <xref:System.Data.Odbc.OdbcParameter>を指定したパラメーター値では、この場合は 5 よりも大きな UnitPrice を持つ行に結果を制限します。 <xref:System.Data.Odbc.OdbcConnection>内に開かれ、`using`によってリソースが閉じられ、破棄、コードが終了したときに、ブロックします。 使用してコマンドを実行、 <xref:System.Data.Odbc.OdbcDataReader>、し、コンソール ウィンドウに結果を表示します。  
+  
+<!-- TODO: review snippet reference  [!CODE [DataWorksSampleApp.Odbc#1](DataWorksSampleApp.Odbc#1)]  -->  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_OracleClient"></a>   
+### <a name="oracleclient"></a>OracleClient  
+ このコード例では、Oracle サーバー上の DEMO.CUSTOMER との接続を前提としています。 また、System.Data.OracleClient.dll への参照を追加する必要があります。 コード内のデータを返す、 <xref:System.Data.OracleClient.OracleDataReader>します。  
+  
+  [DataWorks SampleApp.Oracle#1](../CodeSnippet/VS_Snippets_ADO.NET/DataWorks SampleApp.Oracle#1)]  
+  
+ [[Top]](#_TOP)  
+  
+## <a name="entity-framework-examples"></a>Entity Framework の例  
+ 以下に示した各コードは、エンティティ データ モデル (EDM) のエンティティを照会して、データ ソースからデータを取得する方法を示しています。 これらの例を使用して、 [Northwind モデル](http://msdn.microsoft.com/ja-jp/74521f8c-e974-48cb-8858-c08deff52638)します。 詳細については、次を参照してください。 [Entity Framework の概要](../../../../docs/framework/data/adonet/ef/overview.md)します。  
+  
+<a name="_LINQ"></a>   
+### <a name="linq-to-entities"></a>LINQ to Entities  
+ この例のコードは LINQ クエリを使用してデータをカテゴリ オブジェクトとして返します。これは、CategoryID および CategoryName プロパティのみを含んでいる匿名型として射影されます。 詳細については、次を参照してください。 [LINQ to Entities の概要](http://msdn.microsoft.com/ja-jp/86d87a27-c17a-45ac-b28d-72c8500333c6)します。  
+  
+```  
+Option Explicit On  
+Option Strict On  
+  
+Imports System  
+Imports System.Linq  
+Imports System.Data.Objects  
+Imports NorthwindModel  
+  
+Class LinqSample  
+    Public Shared Sub ExecuteQuery()  
+        Using context As NorthwindEntities = New NorthwindEntities()  
+            Try  
+                Dim query = From category In context.Categories _  
+                            Select New With _  
+                            { _  
+                                .categoryID = category.CategoryID, _  
+                                .categoryName = category.CategoryName _  
+                            }  
+  
+                For Each categoryInfo In query  
+                    Console.WriteLine(vbTab & "{0}" & vbTab & "{1}", _  
+                        categoryInfo.categoryID, categoryInfo.categoryName)  
+                Next  
+            Catch ex As Exception  
+                Console.WriteLine(ex.Message)  
+            End Try  
+        End Using  
+    End Sub  
+End Class  
+```  
+  
+ C# の場合:  
+  
+```  
+using System;  
+using System.Linq;  
+using System.Data.Objects;  
+using NorthwindModel;  
+  
+class LinqSample  
+{  
+    public static void ExecuteQuery()  
+    {  
+        using (NorthwindEntities context = new NorthwindEntities())  
+        {  
+            try  
+            {  
+                var query = from category in context.Categories  
+                            select new  
+                            {  
+                                categoryID = category.CategoryID,  
+                                categoryName = category.CategoryName  
+                            };  
+  
+                foreach (var categoryInfo in query)  
+                {  
+                    Console.WriteLine("\t{0}\t{1}",  
+                        categoryInfo.categoryID, categoryInfo.categoryName);  
+                }  
+            }  
+            catch (Exception ex)  
+            {  
+                Console.WriteLine(ex.Message);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_QBM"></a>   
+### <a name="typed-objectquery"></a>型指定された ObjectQuery  
+ この例のコードを使用して、 <xref:System.Data.Objects.ObjectQuery%601>をカテゴリ オブジェクトとしてデータを返します。 詳細については、次を参照してください。[オブジェクト クエリ](http://msdn.microsoft.com/ja-jp/0768033c-876f-471d-85d5-264884349276)します。  
+  
+```  
+Option Explicit On  
+Option Strict On  
+  
+Imports System  
+Imports System.Data.Objects  
+Imports NorthwindModel  
+  
+Class ObjectQuerySample  
+    Public Shared Sub ExecuteQuery()  
+        Using context As NorthwindEntities = New NorthwindEntities()  
+            Dim categoryQuery As ObjectQuery(Of Categories) = context.Categories  
+  
+            For Each category As Categories In _  
+                categoryQuery.Execute(MergeOption.AppendOnly)  
+                Console.WriteLine(vbTab & "{0}" & vbTab & "{1}", _  
+                    category.CategoryID, category.CategoryName)  
+            Next  
+        End Using  
+    End Sub  
+End Class  
+```  
+  
+ C# の場合:  
+  
+```  
+using System;  
+using System.Data.Objects;  
+using NorthwindModel;  
+  
+class ObjectQuerySample  
+{  
+    public static void ExecuteQuery()  
+    {  
+        using (NorthwindEntities context = new NorthwindEntities())  
+        {  
+            ObjectQuery<Categories> categoryQuery = context.Categories;  
+  
+            foreach (Categories category in   
+                categoryQuery.Execute(MergeOption.AppendOnly))  
+            {  
+                Console.WriteLine("\t{0}\t{1}",  
+                    category.CategoryID, category.CategoryName);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_EntityClient"></a>   
+### <a name="entityclient"></a>EntityClient  
+ この例のコードを使用して、 <xref:System.Data.EntityClient.EntityCommand> Entity SQL クエリを実行します。 このクエリは、カテゴリ エンティティ型のインスタンスを示すレコードのリストを返します。 <xref:System.Data.EntityClient.EntityDataReader>結果セット内のデータ レコードにアクセスするために使用します。 詳細については、次を参照してください。 [Entity Framework 用の EntityClient プロバイダー](../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)します。  
+  
+```  
+Option Explicit On  
+Option Strict On  
+  
+Imports System  
+Imports System.Data  
+Imports System.Data.Common  
+Imports System.Data.EntityClient  
+Imports NorthwindModel  
+  
+Class EntityClientSample  
+    Public Shared Sub ExecuteQuery()  
+        Dim queryString As String = _  
+            "SELECT c.CategoryID, c.CategoryName " & _  
+                "FROM NorthwindEntities.Categories AS c"  
+  
+        Using conn As EntityConnection = _  
+            New EntityConnection("name=NorthwindEntities")  
+  
+            Try  
+                conn.Open()  
+                Using query As EntityCommand = _  
+                New EntityCommand(queryString, conn)  
+                    Using rdr As DbDataReader = _  
+                        query.ExecuteReader(CommandBehavior.SequentialAccess)  
+                        While rdr.Read()  
+                            Console.WriteLine(vbTab & "{0}" & vbTab & "{1}", _  
+                                              rdr(0), rdr(1))  
+                        End While  
+                    End Using  
+                End Using  
+            Catch ex As Exception  
+                Console.WriteLine(ex.Message)  
+            End Try  
+        End Using   
+    End Sub  
+End Class  
+```  
+  
+ C# の場合:  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.Common;  
+using System.Data.EntityClient;  
+using NorthwindModel;  
+  
+class EntityClientSample  
+{  
+    public static void ExecuteQuery()  
+    {  
+        string queryString =  
+            @"SELECT c.CategoryID, c.CategoryName   
+                FROM NorthwindEntities.Categories AS c";  
+  
+        using (EntityConnection conn =  
+            new EntityConnection("name=NorthwindEntities"))  
+        {  
+            try  
+            {  
+                conn.Open();  
+                using (EntityCommand query = new EntityCommand(queryString, conn))  
+                {  
+                    using (DbDataReader rdr =   
+                        query.ExecuteReader(CommandBehavior.SequentialAccess))  
+                    {  
+                        while (rdr.Read())  
+                        {  
+                            Console.WriteLine("\t{0}\t{1}", rdr[0], rdr[1]);  
+                        }  
+                    }  
+                }  
+            }  
+            catch (Exception ex)  
+            {  
+                Console.WriteLine(ex.Message);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+ [[Top]](#_TOP)  
+  
+<a name="_LINQ2SQL"></a>   
+## <a name="linq-to-sql"></a>LINQ to SQL  
+ この例のコードは LINQ クエリを使用してデータをカテゴリ オブジェクトとして返します。これは、CategoryID および CategoryName プロパティのみを含んでいる匿名型として射影されます。 この例は Northwind データ コンテキストを基にしています。 詳細については、次を参照してください。[概要](../../../../docs/framework/data/adonet/sql/linq/getting-started.md)します。  
+  
+```  
+Option Explicit On  
+Option Strict On  
+  
+Imports System  
+Imports System.Collections.Generic  
+Imports System.Linq  
+Imports System.Text  
+Imports Northwind  
+  
+Class LinqSqlSample  
+    Public Shared Sub ExecuteQuery()  
+        Using db As NorthwindDataContext = New NorthwindDataContext()  
+            Try  
+                Dim query = From category In db.Categories _  
+                                Select New With _  
+                                { _  
+                                    .categoryID = category.CategoryID, _  
+                                    .categoryName = category.CategoryName _  
+                                }  
+  
+                For Each categoryInfo In query  
+                    Console.WriteLine(vbTab & "{0}" & vbTab & "{1}", _  
+                            categoryInfo.categoryID, categoryInfo.categoryName)  
+                Next  
+            Catch ex As Exception  
+                Console.WriteLine(ex.Message)  
+            End Try  
+            End Using   
+    End Sub  
+End Class  
+```  
+  
+ C# の場合:  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using Northwind;  
+  
+    class LinqSqlSample  
+    {  
+        public static void ExecuteQuery()  
+        {  
+            using (NorthwindDataContext db = new NorthwindDataContext())  
+            {  
+                try  
+                {  
+                    var query = from category in db.Categories  
+                                select new  
+                                {  
+                                    categoryID = category.CategoryID,  
+                                    categoryName = category.CategoryName  
+                                };  
+  
+                    foreach (var categoryInfo in query)  
+                    {  
+                        Console.WriteLine("vbTab {0} vbTab {1}",  
+                            categoryInfo.categoryID, categoryInfo.categoryName);  
+                    }  
+                }  
+                catch (Exception ex)  
+                {  
+                    Console.WriteLine(ex.Message);  
+                }  
+            }  
+        }  
+    }  
+```  
+  
+ [[Top]](#_TOP)  
+  
+## <a name="see-also"></a>関連項目  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [取得して、ADO.NET でのデータを変更します。](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [データ アプリケーションの作成](../Topic/Creating%20Data%20Applications.md)   
+ [Entity Data Model (Entity Framework Tasks) のクエリを実行します。](http://msdn.microsoft.com/ja-jp/187f1caa-e4d3-4e31-bd99-5d5c2b329c77)   
+ [方法: 匿名型のオブジェクトを返すクエリの実行](http://msdn.microsoft.com/ja-jp/3b264025-e911-4d73-90ce-992d2b9d189d)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ado-net-datasets.md b/docs/framework/data/adonet/ado-net-datasets.md
new file mode 100644
index 00000000000..386326c1da1
--- /dev/null
+++ b/docs/framework/data/adonet/ado-net-datasets.md
@@ -0,0 +1,59 @@
+---
+title: "ADO.NET データセット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82b641bb-6001-4512-bf1a-2830acdd92ab
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET データセット
+<xref:System.Data.DataSet>オブジェクトがサポートするための要に切断されると、分散データ シナリオを[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)]します。 **データセット**データ ソースに関係なく、一貫性のあるリレーショナル プログラミング モデルを提供するデータのメモリ常駐型表現です。 複数の異なるデータ ソースや XML データと組み合わせて使用でき、アプリケーションにとってローカルなデータの管理にも使用できます。 **データセット**関連テーブル、制約、およびテーブル間のリレーションシップを含む、データの完全なセットを表します。 次の図は、**データセット**オブジェクト モデルです。  
+  
+ ![ADO.Net グラフィック](../../../../docs/framework/data/adonet/media/ado-1-bpuedev11.png "ado_1_bpuedev11")  
+DataSet オブジェクト モデル  
+  
+ メソッドと内のオブジェクト、**データセット**リレーショナル データベースのモデルと一致します。  
+  
+ **データセット**永続化してその内容を XML としてとそのスキーマを XML スキーマ定義言語 (XSD) スキーマとして再読み込みできます。 詳細については、次を参照してください。[データセットを使用して XML](../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)します。  
+  
+## <a name="the-datatablecollection"></a>DataTableCollection  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] **データセット**によって表現される&0; 個以上のテーブルのコレクションを含む<xref:System.Data.DataTable>オブジェクトです。 <xref:System.Data.DataTableCollection>すべてを含む、 **DataTable**内のオブジェクト、**データセット**します。  
+  
+ A **DataTable**で定義された、 <xref:System.Data>名前空間、メモリ常駐データの&1; つのテーブルを表します。 によって表される列のコレクションが含まれています、 <xref:System.Data.DataColumnCollection>、および制約で表される、 <xref:System.Data.ConstraintCollection>、共にテーブルのスキーマを定義します。 A **DataTable**もで表現される行のコレクションを格納、 <xref:System.Data.DataRowCollection>テーブルにデータを格納します。 現在の状態と共に、 <xref:System.Data.DataRow>両方のバージョンを保持現在と元の行に格納された値に対する変更を識別します。  
+  
+## <a name="the-dataview-class"></a>DataView クラス  
+ A <xref:System.Data.DataView>に格納されたデータのさまざまなビューを作成することができます、 <xref:System.Data.DataTable>、データ連結アプリケーションでよく使用されている機能です。 使用して、 <xref:System.Data.DataView>さまざまな並べ替え順序のテーブル内のデータを公開する、および行の状態やフィルター式に基づいて、データをフィルター処理できます。 詳細については、次を参照してください。 [Dataview](../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)します。  
+  
+## <a name="the-datarelationcollection"></a>DataRelationCollection  
+ A**データセット**リレーションシップに含まれているその<xref:System.Data.DataRelationCollection>オブジェクトです。 によって表される、リレーションシップ、 <xref:System.Data.DataRelation>オブジェクト、行に関連付けます**DataTable**の行を別**DataTable**します。 リレーションシップは、リレーショナル データベースの主キー列と外部キー列の間に存在する結合パスに似ています。 A **DataRelation**の&2; つのテーブルで一致する列を識別、**データセット**します。  
+  
+ リレーションシップは、1 つのテーブル内の別のナビゲーションを有効にする、**データセット**します。 必須の要素、 **DataRelation**はリレーションシップの名前、関連するテーブルの名前、および各テーブルに関連する列。 配列を指定して&1; つのテーブルの&1; つ以上の列を持つリレーションシップを構築できます<xref:System.Data.DataColumn>オブジェクトをキー列として。 リレーションシップを追加すると、 <xref:System.Data.DataRelationCollection>、必要に応じて追加することができます、 **UniqueKeyConstraint**と**ForeignKeyConstraint**関連列の値に変更が加えられたときに整合性制約を適用します。  
+  
+ 詳細については、次を参照してください。 [Datarelation の追加](../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md)します。  
+  
+## <a name="xml"></a>XML  
+ 入力することができます、**データセット**から XML ストリームまたはドキュメント。 XML ストリームまたはドキュメントを使用するときに提供する、**データセット**データ、スキーマ情報、またはその両方です。 XML ストリームまたはドキュメントから提供される情報は、既存のデータまたはスキーマ情報に既に存在と組み合わせることができます、**データセット**します。 詳細については、次を参照してください。[データセットを使用して XML](../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)します。  
+  
+## <a name="extendedproperties"></a>ExtendedProperties  
+ **データセット**、 **DataTable**、および**DataColumn**すべてである、 **ExtendedProperties**プロパティです。 **ExtendedProperties**は、 **PropertyCollection**結果セットの生成に使用された SELECT ステートメントまたはデータが生成された時刻などの独自の情報を配置することができます。 **ExtendedProperties**コレクションがのスキーマ情報と共に永続化、**データセット**します。  
+  
+## <a name="linq-to-dataset"></a>LINQ to DataSet  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、DataSet に格納された非接続型データに対する統合言語クエリ機能を提供します。 [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)]規格を使用して[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)]構文を使用しているときに、コンパイル時の構文チェック、静的な型指定、および IntelliSense のサポートを提供し、 [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] IDE です。  
+  
+ 詳細については、次を参照してください。 [LINQ to DataSet](../../../../docs/framework/data/adonet/linq-to-dataset.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [Dataset、Datatable、および Dataview](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [取得して、ADO.NET でのデータを変更します。](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ado-net-overview.md b/docs/framework/data/adonet/ado-net-overview.md
new file mode 100644
index 00000000000..6fd58a2660d
--- /dev/null
+++ b/docs/framework/data/adonet/ado-net-overview.md
@@ -0,0 +1,70 @@
+---
+title: "ADO.NET の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee3bc1d8-11db-4be4-89eb-c708cf04117d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ADO.NET の概要
+ADO.NET は、SQL Server や XML などのデータ ソースや、OLE DB や ODBC 経由で公開されるデータ ソースに対する一貫性を持ったアクセス機能を実現します。  データを共有する消費者向けアプリケーションで ADO.NET を使用することで、そのようなデータ ソースへの接続や、データ ソースに格納されているデータの取得、操作、更新を実行できます。  
+  
+ ADO.NET は、データ操作の中からデータ アクセス機能を分離し、個別にまたは組み合わせて使用できる、独立したコンポーネントへと分解します。  ADO.NET には、データベースとの接続、コマンドの実行、および結果の取得を行うための .NET Framework データ プロバイダーが含まれます。  この結果は直接処理され、ADO.NET <xref:System.Data.DataSet> オブジェクトに格納されます。この結果は、ユーザーに暫定的に公開したり、複数のソースからのデータと組み合わせたり、層間で受け渡したりするために使用されます。  `DataSet` オブジェクトを .NET Framework データ プロバイダーに関係なく使用した場合でも、アプリケーションにとってローカルなデータや XML から提供されたデータを管理できます。  
+  
+ ADO.NET クラスは System.Data.dll にあり、System.Xml.dll に含まれている XML クラスに統合されています。  データベースに接続してデータを取得した後、そのデータをコンソール ウィンドウに表示するサンプル コードについては、「[ADO.NET のコード例](../../../../docs/framework/data/adonet/ado-net-code-examples.md)」を参照してください。  
+  
+ マネージ コードを作成する開発者は、ADO.NET により、ネイティブのコンポーネント オブジェクト モデル \(COM\) 開発者が ActiveX Data Object \(ADO\) によって利用できる機能と同等の機能を利用できます。  .NET アプリケーションでのデータのアクセスには、ADO ではなく ADO.NET を使用することをお勧めします。  
+  
+ ADO.NET は、.NET Framework におけるデータ アクセスの最も直接的な方法を提供します。  基になるストレージ モデルではなく概念モデルをアプリケーションで使用できるようにするための高度な抽象化については、「[ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md)」を参照してください。  
+  
+ **プライバシーに関する声明** : System.Data.dll、System.Data.Design.dll、System.Data.OracleClient.dll、System.Data.SqlXml.dll、System.Data.Linq.dll、System.Data.SqlServerCe.dll、System.Data.DataSetExtensions.dll の各アセンブリでは、ユーザーの個人データとそれ以外のデータが区別されません。  これらのアセンブリによって、ユーザーの個人データの収集、格納、送信が実行されることはありません。  ただし、サードパーティ製のアプリケーションでこれらのアセンブリが使用され、ユーザーの個人データの収集、格納、送信が行われる可能性はあります。  
+  
+## このセクションの内容  
+ [ADO.NET のアーキテクチャ](../../../../docs/framework/data/adonet/ado-net-architecture.md)  
+ ADO.NET のアーキテクチャとコンポーネントの概要を説明します。  
+  
+ [ADO.NET テクノロジのオプションとガイドライン](../../../../docs/framework/data/adonet/ado-net-technology-options-and-guidelines.md)  
+ エンティティ データ プラットフォームに含まれている製品とテクノロジを説明します。  
+  
+ [LINQ と ADO.NET](../../../../docs/framework/data/adonet/linq-and-ado-net.md)  
+ ADO.NET での統合言語クエリ \(LINQ\) の実装方法を説明し、関連項目へのリンクを示します。  
+  
+ [.NET Framework データ プロバイダー](../../../../docs/framework/data/adonet/data-providers.md)  
+ .NET Framework データ プロバイダーと、ADO.NET に同梱される .NET Framework データ プロバイダーのデザインの概要を説明します。  
+  
+ [ADO.NET の DataSet](../../../../docs/framework/data/adonet/ado-net-datasets.md)  
+ `DataSet` のデザインとコンポーネントの概要を説明します。  
+  
+ [ADO.NET での side\-by\-side 実行](../../../../docs/framework/data/adonet/side-by-side-execution.md)  
+ ADO.NET のバージョン間の相違と、その相違が side\-by\-side 実行とアプリケーションの互換性に及ぼす影響について説明します。  
+  
+ [ADO.NET のコード例](../../../../docs/framework/data/adonet/ado-net-code-examples.md)  
+ ADO.NET データ プロバイダーを使用してデータを取得するコード サンプルです。  
+  
+## 関連項目  
+ [ADO.NET の新機能](../../../../docs/framework/data/adonet/whats-new.md)  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の新機能について説明します。  
+  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)  
+ ADO.NET を使用する場合の安全なコーディング方法について説明します。  
+  
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)  
+ .NET Framework データ型と .NET Framework データ プロバイダーとの間のデータ型のマッピングについて説明します。  
+  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)  
+ データ ソースへの接続、データの取得、データの変更の方法について説明します。  これには、`DataReaders` と `DataAdapters` が含まれます。  
+  
+## 参照  
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)   
+ [Visual Studio でのデータへのアクセス](../Topic/Accessing%20data%20in%20Visual%20Studio.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ado-net-technology-options-and-guidelines.md b/docs/framework/data/adonet/ado-net-technology-options-and-guidelines.md
new file mode 100644
index 00000000000..ecd60327df5
--- /dev/null
+++ b/docs/framework/data/adonet/ado-net-technology-options-and-guidelines.md
@@ -0,0 +1,52 @@
+---
+title: "ADO.NET テクノロジのオプションとガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8577281-38e6-4ce5-b036-572039a4c3d8
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET テクノロジのオプションとガイドライン
+ADO.NET データ プラットフォームは、概念エンティティ データ モデルに対してプログラムを作成できるようにして、開発者に必要とされるコード作成と保守作業の量を減らすための、複数のリリースにわたる戦略です。  このプラットフォームには、ADO.NET Entity Framework と関連技術が含まれています。  
+  
+## Entity Framework  
+ ADO.NET Entity Framework は、開発者がリレーショナル ストレージ スキーマに対して直接プログラムを作成するのではなく、概念アプリケーション モデルに対してプログラムを作成して、データ アクセス アプリケーションを作成できるように設計されています。  その目的は、データ指向アプリケーションに必要なコードの量と保守作業の量を減らすことです。  詳細については、「[ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md)」を参照してください。  
+  
+### Entity Data Model \(EDM\)  
+ エンティティ データ モデル \(EDM\) は、アプリケーション データをエンティティとリレーションシップの集合として定義するデザイン仕様です。  このモデルのデータは、アプリケーションの境界を越えたオブジェクト リレーショナル マッピングとデータ プログラミング機能をサポートします。  
+  
+### オブジェクト サービス  
+ Object Services を使用すると、プログラマが一連の共通言語ランタイム \(CLR\) クラスを介して概念モデルを操作できるようになります。  これらのクラスは、概念モデルから自動的に生成することも、概念モデルの構造を反映するように別途開発することもできます。  Object Services は、状態の管理、変更の追跡、ID の解決、リレーションシップの読み込みとナビゲート、オブジェクト変更のデータベースへの反映、Entity SQL のクエリ作成サポートなどのサービスを含む、エンティティ フレームワークに対するインフラストラクチャ サポートも提供します。  詳細については、「[Object Services Overview \(Entity Framework\)](http://msdn.microsoft.com/ja-jp/43014cf9-c9cb-4538-bfbb-197820b60038)」を参照してください。  
+  
+### LINQ to Entities  
+ LINQ to Entities は、LINQ の式と標準クエリ演算子を使用することにより、Entity Framework オブジェクト コンテキストに対して厳密に型指定されたクエリを作成できるようにする統合言語クエリ \(LINQ\) の実装です。  LINQ to Entities を使用すると、開発者は Microsoft SQL Server とサードパーティ データベース間の非常に柔軟なオブジェクト リレーショナル マッピングを使用して、概念モデルを操作できます。  詳細については、「[LINQ to Entities](../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)」を参照してください。  
+  
+### Entity SQL  
+ Entity SQL は、エンティティ データ モデルを操作するように設計されたテキスト ベースのクエリ言語です。  Entity SQL は、継承、複合型、明示的リレーションシップなどの高レベルのモデル概念を使用したクエリ用のコンストラクトを含む SQL 言語の一種です。  Entity SQL は、Object Services で直接使用することもできます。  詳細については、「[Entity SQL 言語](../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)」を参照してください。  
+  
+### EntityClient  
+ EntityClient は、エンティティ データ モデルを操作するために使用する新しい .NET Framework データ プロバイダーです。  EntityClient は、<xref:System.Data.EntityClient.EntityDataReader> を返す <xref:System.Data.EntityClient.EntityConnection> および <xref:System.Data.EntityClient.EntityCommand> オブジェクトを公開するための .NET Framework データ プロバイダーのパターンに従います。  EntityClient は Entity SQL 言語と共に使用でき、ストレージ固有のデータ プロバイダーに対する柔軟なマッピングを提供します。  詳細については、「[EntityClient and Entity SQL](http://msdn.microsoft.com/ja-jp/49202ab9-ac98-4b4b-a05c-140e422bf527)」を参照してください。  
+  
+### Entity Data Model ツール  
+ Entity Framework には、EDM アプリケーションの構築を容易にするためのコマンド ライン ツール、ウィザード、およびデザイナーが用意されています。  EntityDataSource コントロールでは、EDM に基づくデータ バインドのシナリオがサポートされています。  EntityDataSource コントロールのプログラミング サーフェイスは、Visual Studio の他のデータ ソース コントロールに似ています。  詳細については、「[ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)」を参照してください。  
+  
+## LINQ to SQL  
+ LINQ to SQL は、.NET Framework のクラスを使用して SQL Server データベースをモデル化するオブジェクト リレーショナル マッピング \(OR\/M\) の実装です。  LINQ to SQL では、LINQ を使用してデータベースのクエリを実行するだけでなく、そのデータベースのデータを更新、挿入、および削除することができます。  LINQ to SQL では、トランザクション、ビュー、およびストアド プロシージャをサポートし、データ検証ルールとビジネス ロジック ルールをデータ モデルに簡単に統合するための方法を提供します。  オブジェクト リレーショナル デザイナー \(O\/R デザイナー\) を使用して、データベース内のオブジェクトに基づくエンティティ クラスと関連付けのモデル化を実行できます。  詳細については、「[LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)」を参照してください。  
+  
+## WCF Data Services  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、Web またはイントラネットにデータ サービスを展開します。  データは、エンティティ データ モデルの仕様に従ってエンティティおよびリレーションシップとして構成されます。  このモデルで展開されるデータは、標準 HTTP プロトコルによってアドレス指定可能です。  詳細については、「[WCF Data Services 4.5](../../../../docs/framework/data/wcf/index.md)」を参照してください。  
+  
+## 参照  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [ADO.NET の新機能](../../../../docs/framework/data/adonet/whats-new.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/association-end-multiplicity.md b/docs/framework/data/adonet/association-end-multiplicity.md
new file mode 100644
index 00000000000..cfcaee90385
--- /dev/null
+++ b/docs/framework/data/adonet/association-end-multiplicity.md
@@ -0,0 +1,43 @@
+---
+title: "アソシエーション End の多重度 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 340926ee-aefb-4bef-92cc-453e5251fd03
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# アソシエーション End の多重度
+*アソシエーション End の多重度*は、[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の 1 つの End に存在できる[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)のインスタンス数を定義します。  
+  
+ アソシエーション End の多重度には、次のいずれかの値を指定できます。  
+  
+-   1 \(1\): アソシエーション End に 1 つのエンティティ型のインスタンスが存在することを示します。  
+  
+-   0 または 1 \(0..1\): アソシエーション End に 0 または 1 つのエンティティ型のインスタンスが存在することを示します。  
+  
+-   多数 \(\*\): アソシエーション End に 0、1 つ、または複数のエンティティ型のインスタンスが存在することを示します。  
+  
+ アソシエーションは、多くの場合、そのアソシエーション End の多重度により特徴付けられます。  たとえば、アソシエーション End の多重度が 1 \(1\) と多数 \(\*\) の場合、アソシエーションは一対多のアソシエーションと呼ばれます。  次の例で、`PublishedBy` アソシエーションは一対多のアソシエーションです \(出版社が多くの書籍を出版し、書籍は 1 社の出版社により出版されます\)。  `WrittenBy` アソシエーションは多対多のアソシエーションです \(書籍の著者が複数の場合があり、著者は複数の書籍を執筆することができます\)。  
+  
+## 例  
+ 下のダイアグラムは、`WrittenBy` および `PublishedBy` という 2 つのアソシエーションの概念モデルを示しています。  `PublishedBy` アソシエーションのアソシエーション End は `Book` および `Publisher` のエンティティ型です。  `Publisher` End の多重度は 1 \(1\) で、`Book` End の多重度は多数 \(\*\) です。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ ADO.NET Entity Framework では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `PublishedBy` アソシエーションを定義しています。  
+  
+ [!code-xml[EDM_Example_Model#AssociationExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#associationexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/association-end.md b/docs/framework/data/adonet/association-end.md
new file mode 100644
index 00000000000..893351f9581
--- /dev/null
+++ b/docs/framework/data/adonet/association-end.md
@@ -0,0 +1,46 @@
+---
+title: "アソシエーション End | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c345213-0296-4d90-ac6d-cef179798a75
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# アソシエーション End
+*アソシエーション End* は、[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の一方の End にある[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)と、アソシエーションのその End に存在できるエンティティ型のインスタンス数を特定します。  アソシエーション End はアソシエーションの一部として定義され、アソシエーションには必ず 2 つのアソシエーション End が必要です。  [ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)は、一方のアソシエーション End から他方のアソシエーション End へのナビゲーションを可能にします。  
+  
+ アソシエーション End の定義には、次の情報が含まれます。  
+  
+-   アソシエーションに含まれるエンティティ型の 1 つ。  \(必須\)  
+  
+    > [!NOTE]
+    >  アソシエーションでは、各アソシエーション End に同じエンティティ型を指定することができます。  これにより、自己アソシエーションが作成されます。  
+  
+-   アソシエーションの 1 つの End に存在できるエンティティ型のインスタンス数を示す[アソシエーション End の多重度](../../../../docs/framework/data/adonet/association-end-multiplicity.md)。  アソシエーション End の多重度には、1 \(1\)、ゼロか 1 \(0..1\)、または多数 \(\*\) の値を指定することができます。  
+  
+-   アソシエーション End の名前。  \(オプション\)。  
+  
+-   アソシエーション End に実行する CASCADE ON DELETE などの操作の情報。  \(オプション\)。  
+  
+## 例  
+ 下のダイアグラムは、`WrittenBy` および `PublishedBy` という 2 つのアソシエーションの概念モデルを示しています。  `PublishedBy` アソシエーションのアソシエーション End は `Book` および `Publisher` のエンティティ型です。  `Publisher` End の多重度は 1 \(1\) で、`Book` End の多重度は多数 \(\*\) です。これは、出版社が多くの書籍を出版し、書籍は 1 社の出版社により出版されることを示します。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ ADO.NET Entity Framework では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `PublishedBy` アソシエーションを定義します。  各アソシエーション End の型、名前、および多重度は、XML 属性 \(それぞれ `Type` 属性、`Role` 属性、および `Multiplicity` 属性\) で指定されます。  アソシエーション End に実行する操作に関するオプション情報は、XML 要素 \(`OnDelete` 要素\) に指定します。  この場合、出版社を削除すると、関連付けられたすべての書籍も削除されます。  
+  
+ [!code-xml[EDM_Example_Model#AssociationEnd](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books3.edmx#associationend)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/association-set-end.md b/docs/framework/data/adonet/association-set-end.md
new file mode 100644
index 00000000000..c1e10d4f5d3
--- /dev/null
+++ b/docs/framework/data/adonet/association-set-end.md
@@ -0,0 +1,43 @@
+---
+title: "アソシエーション セット End | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe4bf1d3-047a-4a37-98c5-a66e70811346
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# アソシエーション セット End
+*アソシエーション セット End* は、[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)の End にある[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)と[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)を識別します。  アソシエーション セット End はアソシエーション セットの一部として定義されます。アソシエーション セットには、アソシエーション セット End が 2 つ必要です。  
+  
+ アソシエーション セット End の定義には、次の情報が含まれます。  
+  
+-   アソシエーション セットに含まれるエンティティ型の 1 つ。  \(必須\)  
+  
+-   アソシエーション セットに含まれるエンティティ型のエンティティ セット。  \(必須\)  
+  
+## 例  
+ 下のダイアグラムは、`PublishedBy` および `WrittenBy` という 2 つのアソシエーションの概念モデルを示しています。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ 次のダイアグラムには、上の概念モデルに基づくアソシエーション セット \(`PublishedBy`\) と 2 つのエンティティ セット \(`Books` および `Publishers`\) を示しています。  アソシエーション セット End は `Book` および `Publisher` エンティティ セットです。  `Books` エンティティ セット内の Bi は、実行時の `Book` エンティティ型インスタンスを表します。  同様に、Pj は、`Publishers` エンティティ セット内の `Publisher` インスタンスを表します。  BiPj は、`PublishedBy` アソシエーション セット内にある `PublishedBy` アソシエーションのインスタンスを表します。  
+  
+ ![例の設定](../../../../docs/framework/data/adonet/media/setsexample.gif "SetsExample")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれる DSL を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムの各アソシエーションに対して 1 つのアソシエーション セットを持つエンティティ コンテナーを定義しています。  アソシエーション セット End はアソシエーション セット定義の一部として定義されています。  
+  
+ [!code-xml[EDM_Example_Model#EntityContainerExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entitycontainerexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/association-set.md b/docs/framework/data/adonet/association-set.md
new file mode 100644
index 00000000000..793986844a7
--- /dev/null
+++ b/docs/framework/data/adonet/association-set.md
@@ -0,0 +1,52 @@
+---
+title: "アソシエーション セット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a65247b6-ce59-44ea-974c-14ae20a7995f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# アソシエーション セット
+*アソシエーション セット*は、同じ型の[アソシエーション](../../../../docs/framework/data/adonet/association-type.md) インスタンスの論理コンテナーです。  アソシエーション セットは、データ モデリング構造ではなく、データ構造やリレーションシップを表しません。  アソシエーション セットは、アソシエーション インスタンスをグループ化してデータ ストアにマップするための、ホスト環境またはストレージ環境 \(共通言語ランタイムや SQL Server データベースなど\) の構造を提供します。  
+  
+ アソシエーション セットは、[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)とアソシエーション セットの論理グループである[エンティティ コンテナー](../../../../docs/framework/data/adonet/entity-container.md)内に定義します。  
+  
+ アソシエーション セットの定義には、次の情報が含まれます。  
+  
+-   アソシエーション セット名。  \(必須\)  
+  
+-   インスタンスを含むアソシエーション。  \(必須\)  
+  
+-   2 つの[アソシエーション セット End](../../../../docs/framework/data/adonet/association-set-end.md)。  
+  
+## 例  
+ 下のダイアグラムは、`PublishedBy` および `WrittenBy` という 2 つのアソシエーションの概念モデルを示しています。  このダイアグラムにはアソシエーション セットに関する情報が示されていませんが、次のダイアグラムはこのモデルに基づくアソシエーション セットとエンティティ セットの例を示しています。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ 次の例は、上の概念モデルに基づくアソシエーション セット\(`PublishedBy`\) と 2 つのエンティティ セット \(`Books` および `Publishers`\) を示しています。  `Books` エンティティ セット内の Bi は、実行時の `Book` エンティティ型インスタンスを表します。  同様に、Pj は、`Publishers` エンティティ セット内の `Publisher` インスタンスを表します。  BiPj は、`PublishedBy` アソシエーション セット内にある `PublishedBy` アソシエーションのインスタンスを表します。  
+  
+ ![例の設定](../../../../docs/framework/data/adonet/media/setsexample.gif "SetsExample")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムの各アソシエーションに対して 1 つのアソシエーション セットを持つエンティティ コンテナーを定義しています。  各アソシエーション セットの名前とアソシエーションは、XML 属性で定義しています。  
+  
+ [!code-xml[EDM_Example_Model#EntityContainerExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entitycontainerexample)]  
+  
+ 2 つのアソシエーション セットが同じ[アソシエーション セット End](../../../../docs/framework/data/adonet/association-set-end.md) を共有していない限り、アソシエーションごとに複数のアソシエーション セットを定義できます。  次の CSDL は、`WrittenBy` アソシエーションの 2 つのアソシエーション セットを含むエンティティ コンテナーを定義しています。  `Book` エンティティ型と `Author` エンティティ型には複数のエンティティ セットが定義され、同じアソシエーション セット End を共有するアソシエーション セットがないことに注意してください。  
+  
+ [!code-xml[EDM_Example_Model#MultipleAssociationSets](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books3.edmx#multipleassociationsets)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)   
+ [外部キーのプロパティ](../../../../docs/framework/data/adonet/foreign-key-property.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/association-type.md b/docs/framework/data/adonet/association-type.md
new file mode 100644
index 00000000000..122bdcfac70
--- /dev/null
+++ b/docs/framework/data/adonet/association-type.md
@@ -0,0 +1,46 @@
+---
+title: "アソシエーション型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 26c409f6-06e8-4441-ac78-1b1076a3c005
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# アソシエーション型
+*アソシエーション型* \(アソシエーションとも呼ばれます\) は、Entity Data Model \(EDM\) でリレーションシップを記述するために不可欠な構成要素です。  概念モデルでは、アソシエーションが 2 つの[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md) \(`Customer` や `Order` など\) の間のリレーションシップを表します。  アプリケーションでは、アソシエーションのインスタンスが特定のアソシエーション \(`Customer` のインスタンスと `Order` のインスタンスの間のアソシエーションなど\) を表します。  アソシエーション インスタンスは、[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)に論理的にグループ化されます。  
+  
+ アソシエーションの定義には、次の情報が含まれます。  
+  
+-   一意の名前   \(必須\)  
+  
+-   2 つの[アソシエーション End](../../../../docs/framework/data/adonet/association-end.md) \(リレーションシップを構成する各エンティティ型に 1 つずつ\)。  \(必須\)  
+  
+    > [!NOTE]
+    >  アソシエーションは、2 つ以上のエンティティ型のリレーションシップを表すことができません。  しかし、各アソシエーション End に同じエンティティ型を指定することによって、アソシエーションで自己リレーションシップを定義できます。  
+  
+-   [参照整合性制約](../../../../docs/framework/data/adonet/referential-integrity-constraint.md)。  \(オプション\)。  
+  
+ 各アソシエーション End には、アソシエーションの 1 つの End に存在できるエンティティ型のインスタンス数を示す[アソシエーション End の多重度](../../../../docs/framework/data/adonet/association-end-multiplicity.md)を指定する必要があります。  アソシエーション End の多重度には、1 \(1\)、ゼロか 1 \(0..1\)、または多数 \(\*\) の値を指定することができます。  アソシエーションの 1 つの End にあるエンティティ型のインスタンスには、エンティティ型で公開されている場合、[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)または外部キーからアクセスできます。  詳細については、「[Entity Data Model: 外部キー](../../../../docs/framework/data/adonet/foreign-key-property.md)」を参照してください。  
+  
+## 例  
+ 下のダイアグラムは、`WrittenBy` および `PublishedBy` という 2 つのアソシエーションの概念モデルを示しています。  `PublishedBy` アソシエーションのアソシエーション End は `Book` および `Publisher` のエンティティ型です。  `Publisher` End の多重度は 1 \(1\) で、`Book` End の多重度は多数 \(\*\) です。これは、出版社が多くの書籍を出版し、書籍は 1 社の出版社により出版されることを示します。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `PublishedBy` アソシエーションを定義しています。  
+  
+ [!code-xml[EDM_Example_Model#AssociationExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#associationexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/asynchronous-programming.md b/docs/framework/data/adonet/asynchronous-programming.md
new file mode 100644
index 00000000000..95b86cb4731
--- /dev/null
+++ b/docs/framework/data/adonet/asynchronous-programming.md
@@ -0,0 +1,823 @@
+---
+title: "非同期プログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85da7447-7125-426e-aa5f-438a290d1f77
+caps.latest.revision: 30
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 30
+---
+# 非同期プログラミング
+このトピックでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で導入された非同期プログラミング機能をサポートするための拡張機能など、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] Data Provider for [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] \(SqlClient\) における非同期プログラミングのサポートについて説明します。  
+  
+## 従来の非同期プログラミング  
+ [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] より前のバージョンでは、SqlClient による非同期プログラミングは、次のメソッドと `Asynchronous Processing=true` 接続プロパティを使用して行われていました。  
+  
+1.  <xref:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery%2A?displayProperty=fullName>  
+  
+2.  <xref:System.Data.SqlClient.SqlCommand.BeginExecuteReader%2A?displayProperty=fullName>  
+  
+3.  <xref:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader%2A?displayProperty=fullName>  
+  
+ この機能は [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] の SqlClient に残っています。  
+  
+ [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] 以降、これらのメソッドでは、接続文字列に `Asynchronous Processing=true` が必要なくなりました。  
+  
+## [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] で追加された非同期プログラミング機能  
+ 新しい非同期プログラミング機能を使用すると、コードを簡単に非同期にすることができます。  
+  
+ [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] で導入された非同期プログラミング機能の詳細については、次の Web サイトを参照してください。  
+  
+-   [Async および Await を使用した非同期プログラミング](http://go.microsoft.com/fwlink/?LinkId=220765)  
+  
+-   [.Net 4.5 での SqlDataReader の新しい非同期メソッドの使用 \(パート 1\)](http://blogs.msdn.com/b/adonet/archive/2012/04/20/using-sqldatareader-s-new-async-methods-in-net-4-5-beta.aspx)  
+  
+-   [.Net 4.5 での SqlDataReader の新しい非同期メソッドの使用 \(パート 2\)](http://blogs.msdn.com/b/adonet/archive/2012/07/15/using-sqldatareader-s-new-async-methods-in-net-4-5-beta-part-2-examples.aspx)  
+  
+ ユーザー インターフェイスが応答しない場合やサーバーのパフォーマンスが向上しない場合は、コードをさらに非同期にする必要がある可能性があります。  非同期コードの記述には、従来、非同期操作の完了後に発生するロジックを表すコールバック \(または継続とも呼ばれます\) のインストールが伴っていました。  これにより、同期コードと比較して、非同期コードの構造は複雑になります。  
+  
+ 現在は、コールバックを使用したり、コードを複数のメソッドやラムダ式で分割したりせずに、非同期メソッドを呼び出すことができるようになりました。  
+  
+ `async` 修飾子はメソッドが非同期であることを示します。  `async` メソッドを呼び出すと、タスクが返されます。  タスクに対して `await` ステートメントを呼び出すと、現在のメソッドはすぐに終了します。  タスクが終了すると、同じメソッド内で実行が再開されます。  
+  
+> [!WARNING]
+>  非同期呼び出しは、アプリケーションで `Context Connection` 接続文字列キーワードも使用されている場合はサポートされません。  
+  
+ `async` メソッドを呼び出すと、追加のスレッドは割り当てられません。  既存の I\/O 完了スレッドが最後に簡単に使用される可能性があります。  
+  
+ 非同期プログラミングをサポートするために [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] に追加されたメソッドは次のとおりです。  
+  
+-   <xref:System.Data.Common.DbConnection.OpenAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbCommand.ExecuteDbDataReaderAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbCommand.ExecuteNonQueryAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbCommand.ExecuteReaderAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbCommand.ExecuteScalarAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbDataReader.GetFieldValueAsync%2A>  
+  
+-   <xref:System.Data.Common.DbDataReader.IsDBNullAsync%2A>  
+  
+-   <xref:System.Data.Common.DbDataReader.NextResultAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Common.DbDataReader.ReadAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlConnection.OpenAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlCommand.ExecuteNonQueryAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlCommand.ExecuteReaderAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlCommand.ExecuteScalarAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlCommand.ExecuteXmlReaderAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.NextResultAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.ReadAsync%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.SqlClient.SqlBulkCopy.WriteToServerAsync%2A?displayProperty=fullName>  
+  
+ その他の非同期メンバーが、[SqlClient ストリーミング サポート](../../../../docs/framework/data/adonet/sqlclient-streaming-support.md)を行うように追加されました。  
+  
+### 同期から非同期接続を開く  
+ 既存のアプリケーションをアップグレードして、新しい非同期機能を使用できます。  たとえば、同期接続アルゴリズムを使用したアプリケーションで、データベースに接続するたびに UI スレッドをブロックし、接続すると、ユーザーがサインインしたことを他のユーザーに通知するストアド プロシージャが呼び出されるとします。  
+  
+```  
+using SqlConnection conn = new SqlConnection("…");  
+{  
+   conn.Open();  
+   using (SqlCommand cmd = new SqlCommand("StoredProcedure_Logon", conn))  
+   {  
+      cmd.ExecuteNonQuery();  
+   }  
+}  
+  
+```  
+  
+ 新しい非同期機能を使用するように変換した場合、プログラムは次のようになります。  
+  
+```  
+using System;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class A {  
+  
+   static async Task<int> Method(SqlConnection conn, SqlCommand cmd) {  
+      await conn.OpenAsync();  
+      await cmd.ExecuteNonQueryAsync();  
+      return 1;  
+   }  
+  
+   public static void Main() {  
+      using (SqlConnection conn = new SqlConnection("Data Source=(local); Initial Catalog=NorthWind; Integrated Security=SSPI")) {  
+         SqlCommand command = new SqlCommand("select top 2 * from orders", conn);  
+  
+         int result = A.Method(conn, command).Result;  
+  
+         SqlDataReader reader = command.ExecuteReader();  
+         while (reader.Read())  
+            Console.WriteLine(String.Format("{0}", reader[0]));  
+      }  
+   }  
+}  
+```  
+  
+### 既存アプリケーションに新しい非同期機能を追加する \(古いパターンと新しいパターンが混在\)  
+ 既存の非同期ロジックを変更せずに、新しい非同期機能 \(SqlConnection::OpenAsync\) を追加することもできます。  たとえば、現在、次のアルゴリズムを使用するアプリケーションがあるとします。  
+  
+```  
+AsyncCallback productList = new AsyncCallback(ProductList);  
+SqlConnection conn = new SqlConnection("…");  
+conn.Open();  
+SqlCommand cmd = new SqlCommand("SELECT * FROM [Current Product List]", conn);  
+IAsyncResult ia = cmd.BeginExecuteReader(productList, cmd);  
+```  
+  
+ 既存のアルゴリズムを大幅に変更せずに、新しい非同期パターンの使用を開始できます。  
+  
+```  
+using System;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class A {  
+   static void ProductList(IAsyncResult result) { }  
+  
+   public static void Main() {  
+      // AsyncCallback productList = new AsyncCallback(ProductList);  
+      // SqlConnection conn = new SqlConnection("Data Source=(local); Initial Catalog=NorthWind; Integrated Security=SSPI");  
+      // conn.Open();  
+      // SqlCommand cmd = new SqlCommand("select top 2 * from orders", conn);  
+      // IAsyncResult ia = cmd.BeginExecuteReader(productList, cmd);  
+  
+      AsyncCallback productList = new AsyncCallback(ProductList);  
+      SqlConnection conn = new SqlConnection("Data Source=(local); Initial Catalog=NorthWind; Integrated Security=SSPI");  
+      conn.OpenAsync().ContinueWith((task) => {  
+         SqlCommand cmd = new SqlCommand("select top 2 * from orders", conn);  
+         IAsyncResult ia = cmd.BeginExecuteReader(productList, cmd);  
+      }, TaskContinuationOptions.OnlyOnRanToCompletion);  
+   }  
+}  
+```  
+  
+### 基本プロバイダー モデルと新しい非同期機能を使用する  
+ 異なるデータベースに接続してクエリを実行できるツールを作成することが必要になる場合があります。  基本プロバイダー モデルと新しい非同期機能を使用できます。  
+  
+ 分散トランザクションを使用するには、サーバー上で Microsoft Distributed Transaction Controller \(MSDTC\) サービスを有効にする必要があります。  MSDTC を有効にする方法の詳細については、「[Web サーバーで MSDTC を有効にする方法](http://msdn.microsoft.com/library/dd327979.aspx)」を参照してください。  
+  
+```  
+using System;  
+using System.Data.Common;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class A {  
+   static async Task PerformDBOperationsUsingProviderModel(string connectionString, string providerName) {  
+      DbProviderFactory factory = DbProviderFactories.GetFactory(providerName);  
+      using (DbConnection connection = factory.CreateConnection()) {  
+         connection.ConnectionString = connectionString;  
+         await connection.OpenAsync();  
+  
+         DbCommand command = connection.CreateCommand();  
+         command.CommandText = "SELECT * FROM AUTHORS";  
+  
+         using (DbDataReader reader = await command.ExecuteReaderAsync()) {  
+            while (await reader.ReadAsync()) {  
+               for (int i = 0; i < reader.FieldCount; i++) {  
+                  // Process each column as appropriate  
+                  object obj = await reader.GetFieldValueAsync<object>(i);  
+                  Console.WriteLine(obj);  
+               }  
+            }  
+         }  
+      }  
+   }  
+  
+   public static void Main()   
+   {  
+       SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();  
+       // replace these with your own values  
+       builder.DataSource = "your_server";  
+       builder.InitialCatalog = "pubs";  
+       builder.IntegratedSecurity = true;  
+       string provider = "System.Data.SqlClient";  
+  
+       Task task = PerformDBOperationsUsingProviderModel(builder.ConnectionString, provider);  
+       task.Wait();  
+   }  
+}  
+```  
+  
+### SQL トランザクションと新しい非同期機能を使用する  
+  
+```  
+using System;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class Program {  
+   static void Main() {  
+      string connectionString =  
+          "Persist Security Info=False;Integrated Security=SSPI;database=Northwind;server=(local)";  
+      Task task = ExecuteSqlTransaction(connectionString);  
+      task.Wait();  
+   }  
+  
+   static async Task ExecuteSqlTransaction(string connectionString) {  
+      using (SqlConnection connection = new SqlConnection(connectionString)) {  
+         await connection.OpenAsync();  
+  
+         SqlCommand command = connection.CreateCommand();  
+         SqlTransaction transaction = null;  
+  
+         // Start a local transaction.  
+         transaction = await Task.Run<SqlTransaction>(  
+             () => connection.BeginTransaction("SampleTransaction")  
+             );  
+  
+         // Must assign both transaction object and connection  
+         // to Command object for a pending local transaction  
+         command.Connection = connection;  
+         command.Transaction = transaction;  
+  
+         try {  
+            command.CommandText =  
+                "Insert into Region (RegionID, RegionDescription) VALUES (555, 'Description')";  
+            await command.ExecuteNonQueryAsync();  
+  
+            command.CommandText =  
+                "Insert into Region (RegionID, RegionDescription) VALUES (556, 'Description')";  
+            await command.ExecuteNonQueryAsync();  
+  
+            // Attempt to commit the transaction.  
+            await Task.Run(() => transaction.Commit());  
+            Console.WriteLine("Both records are written to database.");  
+         }  
+         catch (Exception ex) {  
+            Console.WriteLine("Commit Exception Type: {0}", ex.GetType());  
+            Console.WriteLine("  Message: {0}", ex.Message);  
+  
+            // Attempt to roll back the transaction.  
+            try {  
+               transaction.Rollback();  
+            }  
+            catch (Exception ex2) {  
+               // This catch block will handle any errors that may have occurred  
+               // on the server that would cause the rollback to fail, such as  
+               // a closed connection.  
+               Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType());  
+               Console.WriteLine("  Message: {0}", ex2.Message);  
+            }  
+         }  
+      }  
+   }  
+}  
+  
+```  
+  
+### SQL トランザクションと新しい非同期機能を使用する  
+ エンタープライズ アプリケーションでは、複数のデータベース サーバー間のトランザクションを有効にするために、一部のシナリオで分散トランザクションの追加が必要になる場合があります。  次のように、System.Transactions 名前空間を使用して分散トランザクションを登録できます。  
+  
+```  
+using System;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+using System.Transactions;  
+  
+class Program {  
+   public static void Main()   
+   {  
+       SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();  
+       // replace these with your own values  
+       builder.DataSource = "your_server";  
+       builder.InitialCatalog = "your_data_source";  
+       builder.IntegratedSecurity = true;  
+  
+       Task task = ExecuteDistributedTransaction(builder.ConnectionString, builder.ConnectionString);  
+       task.Wait();  
+   }  
+  
+   static async Task ExecuteDistributedTransaction(string connectionString1, string connectionString2) {  
+      using (SqlConnection connection1 = new SqlConnection(connectionString1))  
+      using (SqlConnection connection2 = new SqlConnection(connectionString2)) {  
+         using (CommittableTransaction transaction = new CommittableTransaction()) {  
+            await connection1.OpenAsync();  
+            connection1.EnlistTransaction(transaction);  
+  
+            await connection2.OpenAsync();  
+            connection2.EnlistTransaction(transaction);  
+  
+            try {  
+               SqlCommand command1 = connection1.CreateCommand();  
+               command1.CommandText = "Insert into RegionTable1 (RegionID, RegionDescription) VALUES (100, 'Description')";  
+               await command1.ExecuteNonQueryAsync();  
+  
+               SqlCommand command2 = connection2.CreateCommand();  
+               command2.CommandText = "Insert into RegionTable2 (RegionID, RegionDescription) VALUES (100, 'Description')";  
+               await command2.ExecuteNonQueryAsync();  
+  
+               transaction.Commit();  
+            }  
+            catch (Exception ex) {  
+               Console.WriteLine("Exception Type: {0}", ex.GetType());  
+               Console.WriteLine("  Message: {0}", ex.Message);  
+  
+               try {  
+                  transaction.Rollback();  
+               }  
+               catch (Exception ex2) {  
+                  Console.WriteLine("Rollback Exception Type: {0}", ex2.GetType());  
+                  Console.WriteLine("  Message: {0}", ex2.Message);  
+               }  
+            }  
+         }  
+      }  
+   }  
+}  
+  
+```  
+  
+### 非同期操作を取り消す  
+ <xref:System.Threading.CancellationToken> を使用して、非同期要求を取り消すことができます。  
+  
+```  
+using System;  
+using System.Data.SqlClient;  
+using System.Threading;  
+using System.Threading.Tasks;  
+  
+namespace Samples {  
+   class CancellationSample {  
+      public static void Main(string[] args) {  
+         CancellationTokenSource source = new CancellationTokenSource();  
+         source.CancelAfter(2000); // give up after 2 seconds  
+         try {  
+            Task result = CancellingAsynchronousOperations(source.Token);  
+            result.Wait();  
+         }  
+         catch (AggregateException exception) {  
+            if (exception.InnerException is SqlException) {  
+               Console.WriteLine("Operation canceled");  
+            }  
+            else {  
+               throw;  
+            }  
+         }  
+      }  
+  
+      static async Task CancellingAsynchronousOperations(CancellationToken cancellationToken) {  
+         using (SqlConnection connection = new SqlConnection("Server=(local);Integrated Security=true")) {  
+            await connection.OpenAsync(cancellationToken);  
+  
+            SqlCommand command = new SqlCommand("WAITFOR DELAY '00:10:00'", connection);  
+            await command.ExecuteNonQueryAsync(cancellationToken);  
+         }  
+      }  
+   }  
+}  
+```  
+  
+### SqlBulkCopy を使用した非同期操作  
+ 非同期機能は、<xref:System.Data.SqlClient.SqlBulkCopy?displayProperty=fullName> を使用して、<xref:System.Data.SqlClient.SqlBulkCopy.WriteToServerAsync%2A?displayProperty=fullName> にも追加されました。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Data;  
+using System.Data.Odbc;  
+using System.Data.SqlClient;  
+using System.Linq;  
+using System.Text;  
+using System.Threading;  
+using System.Threading.Tasks;  
+  
+namespace SqlBulkCopyAsyncCodeSample {  
+   class Program {  
+      static string selectStatment = "SELECT * FROM [pubs].[dbo].[titles]";  
+      static string createDestTableStatement =  
+          @"CREATE TABLE {0} (  
+            [title_id] [varchar](6) NOT NULL,  
+            [title] [varchar](80) NOT NULL,  
+            [type] [char](12) NOT NULL,  
+            [pub_id] [char](4) NULL,  
+            [price] [money] NULL,  
+            [advance] [money] NULL,  
+            [royalty] [int] NULL,  
+            [ytd_sales] [int] NULL,  
+            [notes] [varchar](200) NULL,  
+            [pubdate] [datetime] NOT NULL)";  
+  
+      // Replace the connection string if needed, for instance to connect to SQL Express: @"Server=(local)\SQLEXPRESS;Database=Demo;Integrated Security=true"  
+      // static string connectionString = @"Server=(localdb)\V11.0;Database=Demo";  
+      static string connectionString = @"Server=(local);Database=Demo;Integrated Security=true";  
+  
+      // static string odbcConnectionString = @"Driver={SQL Server};Server=(localdb)\V11.0;UID=oledb;Pwd=1Password!;Database=Demo";  
+      static string odbcConnectionString = @"Driver={SQL Server};Server=(local);Database=Demo;Integrated Security=true";  
+  
+      // static string marsConnectionString = @"Server=(localdb)\V11.0;Database=Demo;MultipleActiveResultSets=true;";  
+      static string marsConnectionString = @"Server=(local);Database=Demo;MultipleActiveResultSets=true;Integrated Security=true";  
+  
+      // Replace the Server name with your actual sql azure server name and User ID/Password  
+      static string azureConnectionString = @"Server=SqlAzure;User ID=myUserID;Password=myPassword;Database=Demo";  
+  
+      static void Main(string[] args) {  
+         SynchronousSqlBulkCopy();  
+         AsyncSqlBulkCopy().Wait();  
+         MixSyncAsyncSqlBulkCopy().Wait();  
+         AsyncSqlBulkCopyNotifyAfter().Wait();  
+         AsyncSqlBulkCopyDataRows().Wait();  
+         // AsyncSqlBulkCopySqlServerToSqlAzure().Wait();  
+         // AsyncSqlBulkCopyCancel().Wait();  
+         AsyncSqlBulkCopyMARS().Wait();  
+      }  
+  
+      // 3.1.1 Synchronous bulk copy in .NET 4.5  
+      private static void SynchronousSqlBulkCopy() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            conn.Open();  
+            DataTable dt = new DataTable();  
+            using (SqlCommand cmd = new SqlCommand(selectStatment, conn)) {  
+               SqlDataAdapter adapter = new SqlDataAdapter(cmd);  
+               adapter.Fill(dt);  
+  
+               string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+               cmd.CommandText = string.Format(createDestTableStatement, temptable);  
+               cmd.ExecuteNonQuery();  
+  
+               using (SqlBulkCopy bcp = new SqlBulkCopy(conn)) {  
+                  bcp.DestinationTableName = temptable;  
+                  bcp.WriteToServer(dt);  
+               }  
+            }  
+         }  
+  
+      }  
+  
+      // 3.1.2 Asynchrounous bulk copy in .NET 4.5  
+      private static async Task AsyncSqlBulkCopy() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            await conn.OpenAsync();  
+            DataTable dt = new DataTable();  
+            using (SqlCommand cmd = new SqlCommand(selectStatment, conn)) {  
+               SqlDataAdapter adapter = new SqlDataAdapter(cmd);  
+               adapter.Fill(dt);  
+  
+               string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+               cmd.CommandText = string.Format(createDestTableStatement, temptable);  
+               await cmd.ExecuteNonQueryAsync();  
+  
+               using (SqlBulkCopy bcp = new SqlBulkCopy(conn)) {  
+                  bcp.DestinationTableName = temptable;  
+                  await bcp.WriteToServerAsync(dt);  
+               }  
+            }  
+         }  
+      }  
+  
+      // 3.2 Add new Async.NET capabilities in an existing application (Mixing synchronous and asynchornous calls)  
+      private static async Task MixSyncAsyncSqlBulkCopy() {  
+         using (OdbcConnection odbcconn = new OdbcConnection(odbcConnectionString)) {  
+            odbcconn.Open();  
+            using (OdbcCommand odbccmd = new OdbcCommand(selectStatment, odbcconn)) {  
+               using (OdbcDataReader odbcreader = odbccmd.ExecuteReader()) {  
+                  using (SqlConnection conn = new SqlConnection(connectionString)) {  
+                     await conn.OpenAsync();  
+                     string temptable = "temptable";//"[#" + Guid.NewGuid().ToString("N") + "]";  
+                     SqlCommand createCmd = new SqlCommand(string.Format(createDestTableStatement, temptable), conn);  
+                     await createCmd.ExecuteNonQueryAsync();  
+                     using (SqlBulkCopy bcp = new SqlBulkCopy(conn)) {  
+                        bcp.DestinationTableName = temptable;  
+                        await bcp.WriteToServerAsync(odbcreader);  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+  
+      // 3.3 Using the NotifyAfter property  
+      private static async Task AsyncSqlBulkCopyNotifyAfter() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            await conn.OpenAsync();  
+            DataTable dt = new DataTable();  
+            using (SqlCommand cmd = new SqlCommand(selectStatment, conn)) {  
+               SqlDataAdapter adapter = new SqlDataAdapter(cmd);  
+               adapter.Fill(dt);  
+  
+               string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+               cmd.CommandText = string.Format(createDestTableStatement, temptable);  
+               await cmd.ExecuteNonQueryAsync();  
+  
+               using (SqlBulkCopy bcp = new SqlBulkCopy(conn)) {  
+                  bcp.DestinationTableName = temptable;  
+                  bcp.NotifyAfter = 5;  
+                  bcp.SqlRowsCopied += new SqlRowsCopiedEventHandler(OnSqlRowsCopied);  
+                  await bcp.WriteToServerAsync(dt);  
+               }  
+            }  
+         }  
+      }  
+  
+      private static void OnSqlRowsCopied(object sender, SqlRowsCopiedEventArgs e) {  
+         Console.WriteLine("Copied {0} so far...", e.RowsCopied);  
+      }  
+  
+      // 3.4 Using the new SqlBulkCopy Async.NET capabilities with DataRow[]  
+      private static async Task AsyncSqlBulkCopyDataRows() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            await conn.OpenAsync();  
+            DataTable dt = new DataTable();  
+            using (SqlCommand cmd = new SqlCommand(selectStatment, conn)) {  
+               SqlDataAdapter adapter = new SqlDataAdapter(cmd);  
+               adapter.Fill(dt);  
+               DataRow[] rows = dt.Select();  
+  
+               string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+               cmd.CommandText = string.Format(createDestTableStatement, temptable);  
+               await cmd.ExecuteNonQueryAsync();  
+  
+               using (SqlBulkCopy bcp = new SqlBulkCopy(conn)) {  
+                  bcp.DestinationTableName = temptable;  
+                  await bcp.WriteToServerAsync(rows);  
+               }  
+            }  
+         }  
+      }  
+  
+      // 3.5 Copying data from SQL Server to SQL Azure in .NET 4.5  
+      //private static async Task AsyncSqlBulkCopySqlServerToSqlAzure() {  
+      //   using (SqlConnection srcConn = new SqlConnection(connectionString))  
+      //   using (SqlConnection destConn = new SqlConnection(azureConnectionString)) {  
+      //      await srcConn.OpenAsync();  
+      //      await destConn.OpenAsync();  
+      //      using (SqlCommand srcCmd = new SqlCommand(selectStatment, srcConn)) {  
+      //         using (SqlDataReader reader = await srcCmd.ExecuteReaderAsync()) {  
+      //            string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+      //            using (SqlCommand destCmd = new SqlCommand(string.Format(createDestTableStatement, temptable), destConn)) {  
+      //               await destCmd.ExecuteNonQueryAsync();  
+      //               using (SqlBulkCopy bcp = new SqlBulkCopy(destConn)) {  
+      //                  bcp.DestinationTableName = temptable;  
+      //                  await bcp.WriteToServerAsync(reader);  
+      //               }  
+      //            }  
+      //         }  
+      //      }  
+      //   }  
+      //}  
+  
+      // 3.6 Cancelling an Asynchronous Operation to SQL Azure  
+      //private static async Task AsyncSqlBulkCopyCancel() {  
+      //   CancellationTokenSource cts = new CancellationTokenSource();  
+      //   using (SqlConnection srcConn = new SqlConnection(connectionString))  
+      //   using (SqlConnection destConn = new SqlConnection(azureConnectionString)) {  
+      //      await srcConn.OpenAsync(cts.Token);  
+      //      await destConn.OpenAsync(cts.Token);  
+      //      using (SqlCommand srcCmd = new SqlCommand(selectStatment, srcConn)) {  
+      //         using (SqlDataReader reader = await srcCmd.ExecuteReaderAsync(cts.Token)) {  
+      //            string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+      //            using (SqlCommand destCmd = new SqlCommand(string.Format(createDestTableStatement, temptable), destConn)) {  
+      //               await destCmd.ExecuteNonQueryAsync(cts.Token);  
+      //               using (SqlBulkCopy bcp = new SqlBulkCopy(destConn)) {  
+      //                  bcp.DestinationTableName = temptable;  
+      //                  await bcp.WriteToServerAsync(reader, cts.Token);  
+      //                  //Cancel Async SqlBulCopy Operation after 200 ms  
+      //                  cts.CancelAfter(200);  
+      //               }  
+      //            }  
+      //         }  
+      //      }  
+      //   }  
+      //}  
+  
+      // 3.7 Using Async.Net and MARS  
+      private static async Task AsyncSqlBulkCopyMARS() {  
+         using (SqlConnection marsConn = new SqlConnection(marsConnectionString)) {  
+            await marsConn.OpenAsync();  
+  
+            SqlCommand titlesCmd = new SqlCommand("SELECT * FROM [pubs].[dbo].[titles]", marsConn);  
+            SqlCommand authorsCmd = new SqlCommand("SELECT * FROM [pubs].[dbo].[authors]", marsConn);  
+            //With MARS we can have multiple active results sets on the same connection  
+            using (SqlDataReader titlesReader = await titlesCmd.ExecuteReaderAsync())  
+            using (SqlDataReader authorsReader = await authorsCmd.ExecuteReaderAsync()) {  
+               await authorsReader.ReadAsync();  
+  
+               string temptable = "[#" + Guid.NewGuid().ToString("N") + "]";  
+               using (SqlConnection destConn = new SqlConnection(connectionString)) {  
+                  await destConn.OpenAsync();  
+                  using (SqlCommand destCmd = new SqlCommand(string.Format(createDestTableStatement, temptable), destConn)) {  
+                     await destCmd.ExecuteNonQueryAsync();  
+                     using (SqlBulkCopy bcp = new SqlBulkCopy(destConn)) {  
+                        bcp.DestinationTableName = temptable;  
+                        await bcp.WriteToServerAsync(titlesReader);  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+   }  
+}  
+```  
+  
+## MARS を使用して複数のコマンドを非同期的に使用する  
+ この例では、**AdventureWorks** データベースとの接続を 1 つ開きます。  <xref:System.Data.SqlClient.SqlCommand> オブジェクトを使用して、<xref:System.Data.SqlClient.SqlDataReader> が作成されます。  リーダーが使用されると、2 番目の <xref:System.Data.SqlClient.SqlDataReader> リーダーが開かれます。このとき、最初の <xref:System.Data.SqlClient.SqlDataReader> から取得したデータが 2 番目のリーダーの WHERE 句に入力されます。  
+  
+> [!NOTE]
+>  次の例では、 **に含まれるサンプルの [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class Class1 {  
+   static void Main() {  
+      Task task = MultipleCommands();  
+      task.Wait();  
+   }  
+  
+   static async Task MultipleCommands() {  
+      // By default, MARS is disabled when connecting to a MARS-enabled.  
+      // It must be enabled in the connection string.  
+      string connectionString = GetConnectionString();  
+  
+      int vendorID;  
+      SqlDataReader productReader = null;  
+      string vendorSQL =  
+        "SELECT VendorId, Name FROM Purchasing.Vendor";  
+      string productSQL =  
+        "SELECT Production.Product.Name FROM Production.Product " +  
+        "INNER JOIN Purchasing.ProductVendor " +  
+        "ON Production.Product.ProductID = " +  
+        "Purchasing.ProductVendor.ProductID " +  
+        "WHERE Purchasing.ProductVendor.VendorID = @VendorId";  
+  
+      using (SqlConnection awConnection =  
+        new SqlConnection(connectionString)) {  
+         SqlCommand vendorCmd = new SqlCommand(vendorSQL, awConnection);  
+         SqlCommand productCmd =  
+           new SqlCommand(productSQL, awConnection);  
+  
+         productCmd.Parameters.Add("@VendorId", SqlDbType.Int);  
+  
+         await awConnection.OpenAsync();  
+         using (SqlDataReader vendorReader = await vendorCmd.ExecuteReaderAsync()) {  
+            while (await vendorReader.ReadAsync()) {  
+               Console.WriteLine(vendorReader["Name"]);  
+  
+               vendorID = (int)vendorReader["VendorId"];  
+  
+               productCmd.Parameters["@VendorId"].Value = vendorID;  
+               // The following line of code requires a MARS-enabled connection.  
+               productReader = await productCmd.ExecuteReaderAsync();  
+               using (productReader) {  
+                  while (await productReader.ReadAsync()) {  
+                     Console.WriteLine("  " +  
+                       productReader["Name"].ToString());  
+                  }  
+               }  
+            }  
+         }  
+      }  
+   }  
+  
+   private static string GetConnectionString() {  
+      // To avoid storing the connection string in your code, you can retrive it from a configuration file.  
+      return "Data Source=(local);Integrated Security=SSPI;Initial Catalog=AdventureWorks;MultipleActiveResultSets=True";  
+   }  
+}  
+```  
+  
+## MARS を使用してデータの読み取りと更新を非同期的に行う  
+ MARS を使用すると、複数の保留中の操作について、読み取り操作と DML \(データ操作言語\) 操作の両方で 1 つの接続を使用することができます。  この機能により、アプリケーションで接続ビジー エラーを処理する必要がなくなります。  さらに、MARS ではサーバー側カーソルのユーザーを置き換えることができます。通常、この処理は多くのリソースを消費します。  最後に、複数の操作を単一の接続で実行できるので、同じトランザクション コンテキストを共有することにより、システムのストアド プロシージャである **sp\_getbindtoken** と **sp\_bindsession** を使用する必要がなくなります。  
+  
+ 次のコンソール アプリケーションでは、2 つの <xref:System.Data.SqlClient.SqlDataReader> オブジェクトを 3 つの <xref:System.Data.SqlClient.SqlCommand> オブジェクトと使用する方法、および 1 つの <xref:System.Data.SqlClient.SqlConnection> オブジェクトを MARS を有効にして使用する方法について示します。  最初のコマンド オブジェクトでは、格付けが 5 のベンダーの一覧を取得します。  2 番目のコマンド オブジェクトでは、<xref:System.Data.SqlClient.SqlDataReader> から提供されるベンダー ID を使用して特定のベンダーのすべての製品について 2 番目の <xref:System.Data.SqlClient.SqlDataReader> を読み取ります。  各製品のレコードは、2 番目の <xref:System.Data.SqlClient.SqlDataReader> によってアクセスされます。  計算が実行され、新規 **OnOrderQty** を判定します。  3 番目のコマンド オブジェクトでは、**ProductVendor** テーブルを新しい値で更新します。  このプロセスはすべて単一のトランザクションで行われ、最後にロールバックされます。  
+  
+> [!NOTE]
+>  次の例では、 **に含まれるサンプルの [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.Threading.Tasks;  
+  
+class Program {  
+   static void Main() {  
+      Task task = ReadingAndUpdatingData();  
+      task.Wait();  
+   }  
+  
+   static async Task ReadingAndUpdatingData() {  
+      // By default, MARS is disabled when connecting to a MARS-enabled host.  
+      // It must be enabled in the connection string.  
+      string connectionString = GetConnectionString();  
+  
+      SqlTransaction updateTx = null;  
+      SqlCommand vendorCmd = null;  
+      SqlCommand prodVendCmd = null;  
+      SqlCommand updateCmd = null;  
+  
+      SqlDataReader prodVendReader = null;  
+  
+      int vendorID = 0;  
+      int productID = 0;  
+      int minOrderQty = 0;  
+      int maxOrderQty = 0;  
+      int onOrderQty = 0;  
+      int recordsUpdated = 0;  
+      int totalRecordsUpdated = 0;  
+  
+      string vendorSQL =  
+          "SELECT VendorID, Name FROM Purchasing.Vendor " +  
+          "WHERE CreditRating = 5";  
+      string prodVendSQL =  
+          "SELECT ProductID, MaxOrderQty, MinOrderQty, OnOrderQty " +  
+          "FROM Purchasing.ProductVendor " +  
+          "WHERE VendorID = @VendorID";  
+      string updateSQL =  
+          "UPDATE Purchasing.ProductVendor " +  
+          "SET OnOrderQty = @OrderQty " +  
+          "WHERE ProductID = @ProductID AND VendorID = @VendorID";  
+  
+      using (SqlConnection awConnection =  
+        new SqlConnection(connectionString)) {  
+         await awConnection.OpenAsync();  
+         updateTx = await Task.Run(() => awConnection.BeginTransaction());  
+  
+         vendorCmd = new SqlCommand(vendorSQL, awConnection);  
+         vendorCmd.Transaction = updateTx;  
+  
+         prodVendCmd = new SqlCommand(prodVendSQL, awConnection);  
+         prodVendCmd.Transaction = updateTx;  
+         prodVendCmd.Parameters.Add("@VendorId", SqlDbType.Int);  
+  
+         updateCmd = new SqlCommand(updateSQL, awConnection);  
+         updateCmd.Transaction = updateTx;  
+         updateCmd.Parameters.Add("@OrderQty", SqlDbType.Int);  
+         updateCmd.Parameters.Add("@ProductID", SqlDbType.Int);  
+         updateCmd.Parameters.Add("@VendorID", SqlDbType.Int);  
+  
+         using (SqlDataReader vendorReader = await vendorCmd.ExecuteReaderAsync()) {  
+            while (await vendorReader.ReadAsync()) {  
+               Console.WriteLine(vendorReader["Name"]);  
+  
+               vendorID = (int)vendorReader["VendorID"];  
+               prodVendCmd.Parameters["@VendorID"].Value = vendorID;  
+               prodVendReader = await prodVendCmd.ExecuteReaderAsync();  
+  
+               using (prodVendReader) {  
+                  while (await prodVendReader.ReadAsync()) {  
+                     productID = (int)prodVendReader["ProductID"];  
+  
+                     if (prodVendReader["OnOrderQty"] == DBNull.Value) {  
+                        minOrderQty = (int)prodVendReader["MinOrderQty"];  
+                        onOrderQty = minOrderQty;  
+                     }  
+                     else {  
+                        maxOrderQty = (int)prodVendReader["MaxOrderQty"];  
+                        onOrderQty = (int)(maxOrderQty / 2);  
+                     }  
+  
+                     updateCmd.Parameters["@OrderQty"].Value = onOrderQty;  
+                     updateCmd.Parameters["@ProductID"].Value = productID;  
+                     updateCmd.Parameters["@VendorID"].Value = vendorID;  
+  
+                     recordsUpdated = await updateCmd.ExecuteNonQueryAsync();  
+                     totalRecordsUpdated += recordsUpdated;  
+                  }  
+               }  
+            }  
+         }  
+         Console.WriteLine("Total Records Updated: ", totalRecordsUpdated.ToString());  
+         await Task.Run(() => updateTx.Rollback());  
+         Console.WriteLine("Transaction Rolled Back");  
+      }  
+   }  
+  
+   private static string GetConnectionString() {  
+      // To avoid storing the connection string in your code, you can retrive it from a configuration file.  
+      return "Data Source=(local);Integrated Security=SSPI;Initial Catalog=AdventureWorks;MultipleActiveResultSets=True";  
+   }  
+}  
+```  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/code-access-security.md b/docs/framework/data/adonet/code-access-security.md
new file mode 100644
index 00000000000..3926a048cbc
--- /dev/null
+++ b/docs/framework/data/adonet/code-access-security.md
@@ -0,0 +1,206 @@
+---
+title: "コード アクセス セキュリティと ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93e099eb-daa1-4f1e-b031-c1e10a996f88
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# コード アクセス セキュリティと ADO.NET
+.NET Framework はコード アクセス セキュリティ \(CAS\) に加えてロール ベースのセキュリティを備えています。どちらも、共通言語ランタイム \(CLR\) が提供する共通のインフラストラクチャを使って実装されています。  アンマネージ コードの場合、ほとんどのアプリケーションはユーザーまたはプリンシパルの権限で実行されます。  そのため、悪意のあるソフトウェアやエラーを含むソフトウェアが、システム特権を持つユーザーによって実行された場合、コンピューター システムが被害を受けたり、機密データが改ざんされる可能性があります。  
+  
+ これに対し、.NET Framework で実行されるマネージ コードには、コードそのものに適用されるコード アクセス セキュリティが存在します。  コードの実行が許可されるかどうかは、プリンシパルの ID だけでなく、コードの作成元など、コードの ID を表す情報に依存します。  これにより、マネージ コードが誤用される可能性が低くなります。  
+  
+## コード アクセス許可  
+ コードは、実行されるときに、CLR のセキュリティ システムで評価される証拠を提示します。  通常、この証拠は、URL、サイト、ゾーン、アセンブリの ID を保証するデジタル署名などのコードの作成元に関する情報で構成されます。  
+  
+ CLR は、そのコードに許されている操作の範囲内で実行を許可します。  コードは権限を要求できますが、その要求は管理者が設定したセキュリティ ポリシーに基づいて受理されます。  
+  
+> [!NOTE]
+>  CLR で実行されるコード自体に、アクセス許可を与えることはできません。  たとえば、コードから要求できる権限は、セキュリティ ポリシーによって許可されたレベルよりも低い権限だけであり、それを超える権限が付与されることはありません。  権限を付与する場合は、まず、権限をまったく付与しない状態から始め、その後で、実行しようとする特定のタスクに必要な最小限の権限を追加してゆくようにします。  すべての権限を与えてから、不要なものを 1 つずつ拒否していく方法では、アプリケーションを危険にさらす結果となります。必要以上の権限を付与することによって意図しないセキュリティ ホールを招く可能性があります。  詳細については、「[NIB: Configuring Security Policy](http://msdn.microsoft.com/ja-jp/0f130bcd-1bba-4346-b231-0bcca7dab1a4)」および「[NIB: Security Policy Management](http://msdn.microsoft.com/ja-jp/d754e05d-29dc-4d3a-a2c2-95eaaf1b82b9)」を参照してください。  
+  
+ コードのアクセス権限には、次の 3 種類があります。  
+  
+-   `Code access permissions`。<xref:System.Security.CodeAccessPermission> クラスから派生します。  ファイルや環境変数などの保護されたリソースにアクセスして、保護された操作 \(アンマネージ コードへのアクセスなど\) を実行するには権限が必要です。  
+  
+-   `Identity permissions`。アセンブリを識別する特性を表します。  アセンブリには証拠に基づいて権限が付与されます。証拠には、デジタル署名やコードの作成元などの情報が含まれます。  ID 権限も <xref:System.Security.CodeAccessPermission> 基本クラスから派生します。  
+  
+-   `Role-based security permissions`。プリンシパルが、指定された ID を持っているか、または、指定されたロールに属しているかどうかに基づきます。  <xref:System.Security.Permissions.PrincipalPermission> クラスにより、アクティブなプリンシパルに対する宣言型および命令型の権限チェックが可能となります。  
+  
+ ランタイムのセキュリティ システムは、特定のリソースへのアクセスまたは特定の操作の実行がコードに許されているかどうかを判断するため、呼び出し履歴をたどりながら、各呼び出し元に付与されている権限と、要求されている権限とを比較します。  呼び出し履歴に、要求された権限を持たない呼び出し元が 1 つでも見つかった場合、<xref:System.Security.SecurityException> がスローされてアクセスが拒否されます。  
+  
+### 権限の要求  
+ 権限を要求する目的は、そのアプリケーションを実行するために必要な権限をランタイムに伝えると共に、実際に必要な権限以外は付与されないようにすることです。  たとえば、ローカル ディスクにデータを書き込むアプリケーションは <xref:System.Security.Permissions.FileIOPermission> を必要とします。  この権限が付与されていない場合、アプリケーションがディスクへの書き込みを試行した時点で実行に失敗します。  ただし、アプリケーションから `FileIOPermission` を要求した場合、その権限が付与されなければ、最初の段階で例外が生成され、アプリケーションが読み込まれることはありません。  
+  
+ ディスクからのデータの読み取りだけを必要とするアプリケーションでは、書き込み権限が決して付与されないように要求できます。  バグが存在していたり、悪意のある攻撃を受けたとしても、操作の対象となるデータに損害を与えることはありません。  詳細については、「[NIB: Requesting Permissions](http://msdn.microsoft.com/ja-jp/0447c49d-8cba-45e4-862c-ff0b59bebdc2)」を参照してください。  
+  
+## ロール ベースのセキュリティと CAS  
+ ロール ベースのセキュリティとコード アクセス セキュリティ \(CAS\) の両方を実装することで、アプリケーションの全体的なセキュリティを高めることができます。  ロール ベースのセキュリティには、Windows アカウントまたはカスタム ID を使用できます。セキュリティ プリンシパルに関する情報には、現在のスレッドからアクセスできます。  また、ユーザーによって指定された資格情報に基づいて、データやリソースへのアクセスを提供するアプリケーションも少なくありません。  このようなアプリケーションは、通常、ユーザーのロールを調べ、そのロールに基づいてリソースへのアクセスを許可します。  
+  
+ ロール ベースのセキュリティを使用することで、コンポーネントが、現在のユーザーおよびそのユーザーに関連付けられているロールを実行時に特定できるようになります。  この情報を CAS ポリシーを使ってマッピングすることによって、一連の権限が実行時に判別されます。  特定のアプリケーション ドメインでは、ホストが既定のロール ベース セキュリティ ポリシーを変更し、ユーザーおよびそのユーザーに関連付けられたロールを表す既定のセキュリティ プリンシパルを設定できます。  
+  
+ CLR にはマネージ コードに制限を適用するためのメカニズムが、権限を使用することによって実装されています。  ロール ベースのセキュリティ権限により、ユーザー \(またはユーザーのために行動するエージェント\) が特定の ID を持っているかどうか、または特定のロールに所属しているかどうかを検出するメカニズムが実現されます。  詳細については、「[Security Permissions](http://msdn.microsoft.com/ja-jp/b03757b4-e926-4196-b738-3733ced2bda0)」を参照してください。  
+  
+ 開発しているアプリケーションの種類によっては、データベースに対するロール ベースの権限の実装も考慮する必要があります。  SQL Server におけるロール ベースのセキュリティの詳細については「[SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)」を参照してください。  
+  
+## アセンブリ  
+ アセンブリは、.NET Framework アプリケーションの配置、バージョン管理、再利用、アクティベーション スコープ、およびセキュリティ権限の基本単位です。  アセンブリは、互いに連携して動作するように作成された一連の型やリソースを提供し、"機能" の論理上の単位を成すものです。  CLR から見て、型がアセンブリのコンテキスト外に存在することはありません。  アセンブリの作成と配置の詳細については、「[アセンブリを使用したプログラミング](../../../../docs/framework/app-domains/programming-with-assemblies.md)」を参照してください。  
+  
+### 厳密な名前付きアセンブリ  
+ 厳密な名前 \(デジタル署名\) は、アセンブリの ID \(単純なテキスト名、バージョン番号、および使用可能な場合はカルチャ情報\) と、公開キーおよびデジタル署名で構成されます。  このデジタル署名は、対応する秘密キーを使用してアセンブリ ファイルから生成されます。  アセンブリ ファイルにはアセンブリ マニフェストが格納されており、そこに、アセンブリを構成するすべてのファイルの名前とハッシュが含まれます。  
+  
+ アセンブリに厳密な名前を付けることで、アプリケーションやコンポーネントに一意の ID が与えられます。他のソフトウェアは、その ID を使用することで、対応するアプリケーションまたはコンポーネントを明示的に参照できます。  アセンブリに厳密な名前を付けると、悪意のあるコードを含むアセンブリのなりすましから保護することができます。  また、異なるバージョンのコンポーネント間でバージョンの整合性をとることもできます。  グローバル アセンブリ キャッシュ \(GAC\) に展開されるアセンブリには、厳密な名前を付ける必要があります。  詳細については、「[厳密な名前付きアセンブリの作成と使用](../../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)」を参照してください。  
+  
+## ADO.NET 2.0 での Partial Trust \(部分信頼\)  
+ ADO.NET 2.0 では、.NET Framework Data Provider for SQL Server、.NET Framework Data Provider for OLE DB、.NET Framework Data Provider for ODBC、および .NET Framework Data Provider for Oracle のすべてが、部分的に信頼された環境でも実行できるようになりました。  .NET Framework の以前のリリースでは、信頼性のレベルが full\-trust よりも低いアプリケーションでは <xref:System.Data.SqlClient> のみがサポートされていました。  
+  
+ SQL Server プロバイダーを使用する部分的に信頼できるアプリケーションは、少なくとも、Execution アクセス許可と <xref:System.Data.SqlClient.SqlClientPermission> アクセス許可が必要です。  
+  
+### Partial Trust \(部分信頼\) のアクセス許可属性プロパティ  
+ 部分信頼のシナリオでは、<xref:System.Data.SqlClient.SqlClientPermissionAttribute> メンバーを使用して、.NET Framework Data Provider for SQL Server が使用できる機能をさらに制限することができます。  
+  
+ 使用可能な <xref:System.Data.SqlClient.SqlClientPermissionAttribute> プロパティとその説明を次の表に示します。  
+  
+|アクセス許可属性プロパティ|説明|  
+|-------------------|--------|  
+|`Action`|セキュリティ アクションを取得または設定します。  このプロパティは、<xref:System.Security.Permissions.SecurityAttribute> から継承されています。|  
+|`AllowBlankPassword`|接続文字列内で空白のパスワードの使用を許可または禁止します。  有効な値は、空白のパスワードの使用を許可する `true` および空白のパスワードの使用を禁止する `false` です。  このプロパティは、<xref:System.Data.Common.DBDataPermissionAttribute> から継承されています。|  
+|`ConnectionString`|使用できる接続文字列を指定します。  複数の接続文字列を指定できます。 **Note:**  接続文字列には、ユーザー ID やパスワードを含めないでください。  このリリースでは、.NET Framework 構成ツールを使用して接続文字列制限を変更することはできません。 <br /><br /> このプロパティは、<xref:System.Data.Common.DBDataPermissionAttribute> から継承されています。|  
+|`KeyRestrictions`|許可または禁止する接続文字列パラメーターを指定します。  接続文字列パラメーターは、*\<parameter name\>\=* の形式で指定します。  セミコロン \(;\) で区切って、複数のパラメーターを指定できます。 **Note:**  `KeyRestrictions` が指定されておらず、`KeyRestrictionBehavior` プロパティが `AllowOnly` または `PreventUsage` に設定されている場合は、接続文字列パラメーターを追加できません。  このプロパティは、<xref:System.Data.Common.DBDataPermissionAttribute> から継承されています。|  
+|`KeyRestrictionBehavior`|接続文字列パラメーターが、追加を許可された唯一の接続文字列パラメーター \(`AllowOnly`\) か、または追加を禁止された接続文字列パラメーター \(`PreventUsage`\) かを指定します。  `AllowOnly` が既定値です。  このプロパティは、<xref:System.Data.Common.DBDataPermissionAttribute> から継承されています。|  
+|`TypeID`|派生クラスで実装すると、この属性の一意の識別子を取得します。  このプロパティは、<xref:System.Attribute> から継承されています。|  
+|`Unrestricted`|このリソースに対する無制限のアクセス許可が宣言されているかどうかを示します。  このプロパティは、<xref:System.Security.Permissions.SecurityAttribute> から継承されています。|  
+  
+#### ConnectionString の構文  
+ 次の例では、特定の接続文字列のみ使用できるようにするために、構成ファイルの `connectionStrings` 要素を使用する方法を示しています。  構成ファイルからの接続文字列の格納および取得の詳細については、「[接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)」を参照してください。  
+  
+```  
+<connectionStrings>  
+  <add name="DatabaseConnection"   
+    connectionString="Data Source=(local);Initial   
+    Catalog=Northwind;Integrated Security=true;" />  
+</connectionStrings>  
+```  
+  
+#### KeyRestrictions の構文  
+ 上述の接続文字列の使用を許可し、`Encrypt`、`Packet`、`Size` 接続文字列オプションの使用も許可する一方で、その他の接続文字列オプションの使用を禁止する例を次に示します。  
+  
+```  
+<connectionStrings>  
+  <add name="DatabaseConnection"   
+    connectionString="Data Source=(local);Initial   
+    Catalog=Northwind;Integrated Security=true;"  
+    KeyRestrictions="Encrypt=;Packet Size=;"  
+    KeyRestrictionBehavior="AllowOnly" />  
+</connectionStrings>  
+```  
+  
+#### KeyRestrictionBehavior を PreventUsage に設定する場合の構文  
+ 上述の接続文字列の使用を許可し、`User Id`、`Password`、および `Persist Security Info` を除く他のすべての接続パラメーターを許可する例を次に示します。  
+  
+```  
+<connectionStrings>  
+  <add name="DatabaseConnection"   
+    connectionString="Data Source=(local);Initial   
+    Catalog=Northwind;Integrated Security=true;"  
+    KeyRestrictions="User Id=;Password=;Persist Security Info=;"  
+    KeyRestrictionBehavior="PreventUsage" />  
+</connectionStrings>  
+```  
+  
+#### KeyRestrictionBehavior を AllowOnly に設定する場合の構文  
+ `Initial Catalog`、`Connection Timeout`、`Encrypt`、および `Packet Size` パラメーターも含まれる 2 つの接続文字列の使用を許可する例を次に示します。  その他の接続文字列パラメーターは、すべて制限されます。  
+  
+```  
+<connectionStrings>  
+  <add name="DatabaseConnection"   
+    connectionString="Data Source=(local);Initial   
+    Catalog=Northwind;Integrated Security=true;"  
+    KeyRestrictions="Initial Catalog;Connection Timeout=;  
+       Encrypt=;Packet Size=;"   
+    KeyRestrictionBehavior="AllowOnly" />  
+  
+  <add name="DatabaseConnection2"   
+    connectionString="Data Source=SqlServer2;Initial   
+    Catalog=Northwind2;Integrated Security=true;"  
+    KeyRestrictions="Initial Catalog;Connection Timeout=;  
+       Encrypt=;Packet Size=;"   
+    KeyRestrictionBehavior="AllowOnly" />  
+</connectionStrings>  
+```  
+  
+### カスタム アクセス許可セットを使用した Partial Trust の有効化  
+ 特定のゾーンに対して <xref:System.Data.SqlClient> アクセス許可を有効にするには、システム管理者がカスタム アクセス許可セットを作成して、目的のゾーンに指定する必要があります。  `LocalIntranet` などの既定のアクセス許可セットは変更できません。  たとえば、<xref:System.Security.Policy.Zone> が `LocalIntranet` であるコードに <xref:System.Data.SqlClient> アクセス許可をインクルードするには、システム管理者は `LocalIntranet` アクセス許可セットをコピーして名前を "CustomLocalIntranet" に変更し、<xref:System.Data.SqlClient> アクセス許可を追加します。次に、[Caspol.exe \(コード アクセス セキュリティ ポリシー ツール\)](../../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md) を使用して CustomLocalIntranet アクセス許可セットをインポートし、`LocalIntranet_Zone` のアクセス許可セットを CustomLocalIntranet に設定します。  
+  
+### サンプル アクセス許可セット  
+ 部分信頼のシナリオでの、.NET Framework Data Provider for SQL Server 用アクセス許可セットの例を次に示します。  カスタム アクセス許可セットを作成する方法の詳細については、「[NIB:Configuring Permission Sets Using Caspol.exe](http://msdn.microsoft.com/ja-jp/94e2625e-21ad-4038-af36-6d1f9df40a57)」を参照してください。  
+  
+```  
+<PermissionSet class="System.Security.NamedPermissionSet"  
+  version="1"  
+  Name="CustomLocalIntranet"  
+  Description="Custom permission set given to applications on  
+    the local intranet">  
+  
+<IPermission class="System.Data.SqlClient.SqlClientPermission, System.Data, Version=2.0.0000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+version="1"  
+AllowBlankPassword="False">  
+<add ConnectionString="Data Source=(local);Integrated Security=true;"  
+ KeyRestrictions="Initial Catalog=;Connection Timeout=;  
+   Encrypt=;Packet Size=;"   
+ KeyRestrictionBehavior="AllowOnly" />  
+ </IPermission>  
+</PermissionSet>  
+```  
+  
+## セキュリティ アクセス許可を使用した ADO.NET コード アクセスの検証  
+ 部分信頼のシナリオでは、<xref:System.Data.SqlClient.SqlClientPermissionAttribute> を指定することによって、コード内の特定のメソッドに対する CAS 特権を要求できます。  制限されたセキュリティ ポリシーによって、実際にはその特権が許可されていない場合は、そのコードを実行する前に例外がスローされます。  セキュリティ ポリシーの詳細については、「[NIB: Security Policy Management](http://msdn.microsoft.com/ja-jp/d754e05d-29dc-4d3a-a2c2-95eaaf1b82b9)」および「[NIB: Security Policy Best Practices](http://msdn.microsoft.com/ja-jp/d49bc4d5-efb7-4caa-a2fe-e4d3cec63c05)」を参照してください。  
+  
+### 例  
+ 次のサンプルは、特定の接続文字列を必要とするコードの作成方法を示しています。  このサンプルは、<xref:System.Data.SqlClient> に対する無制限の権限を拒否する機能をシミュレートします。この機能は、実際には、システム管理者が、CAS ポリシーを使用して実装します。  
+  
+> [!IMPORTANT]
+>  ADO.NET の CAS 権限を定義する場合、最も制限の厳しいケース \(権限なし\) から開始し、その後で、コードが実行する特定のタスクに必要な特定の権限を追加するというのが、適切なパターンです。  逆に、すべての権限を与えてから特定の権限を拒否してゆく方法は、安全ではありません。同じ接続文字列を表現する方法が多数あるためです。  たとえば、すべての権限を与えた後で接続文字列 "server\=someserver" の使用を拒否しても、"server\=someserver.mycompany.com" という接続文字列は使用可能です。  常に権限をまったく与えない状態から開始することで、権限セットのセキュリティ ホールを減らすことができます。  
+  
+ `SqlClient` でセキュリティ確認要求を実行する方法を、次のコードに示します。CAS の権限が適切に設定されていない場合、<xref:System.Security.SecurityException> がスローされます。  <xref:System.Security.SecurityException> の出力は、コンソール ウィンドウに表示されます。  
+  
+ [!code-csharp[DataWorks SqlClient.CAS#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.CAS/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.CAS#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.CAS/VB/source.vb#1)]  
+  
+ コンソール ウィンドウに表示される出力の例を次に示します。  
+  
+```  
+Failed, as expected: <IPermission class="System.Data.SqlClient.  
+SqlClientPermission, System.Data, Version=2.0.0.0,   
+  Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1"  
+  AllowBlankPassword="False">  
+<add ConnectionString="Data Source=(local);Initial Catalog=  
+  Northwind;Integrated Security=SSPI" KeyRestrictions=""  
+KeyRestrictionBehavior="AllowOnly"/>  
+</IPermission>  
+  
+Connection opened, as expected.  
+Failed, as expected: Request failed.  
+```  
+  
+## アンマネージ コードとの相互運用性  
+ CLR の外部で実行されるコードはアンマネージ コードと呼ばれます。  したがって、CAS などのセキュリティ メカニズムをアンマネージ コードに適用することはできません。  アンマネージ コードの例としては、COM コンポーネント、ActiveX インターフェイス、Win32 API 関数があります。  アンマネージ コードを実行する場合は、アプリケーションの全体的なセキュリティが損なわれないよう特別な考慮をする必要があります。  詳細については、「[アンマネージ コードとの相互運用](../../../../docs/framework/interop/index.md)」を参照してください。  
+  
+ .NET Framework は、COM 相互運用機能を介したアクセスを提供することによって、既存の COM コンポーネントとの下位互換性をサポートしています。  COM 相互運用ツールを使って適切な COM 型をインポートすることにより、.NET Framework アプリケーションに COM コンポーネントを組み込むことができます。  インポートが完了すると、COM 型を使用できるようになります。  アセンブリのメタデータをタイプ ライブラリにエクスポートし、マネージ コンポーネントを COM コンポーネントとして登録することで、COM クライアントからマネージ コードにアクセスすることもできます。  詳細については、「[Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)」を参照してください。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [PAVE Security in Native and .NET Framework Code](http://msdn.microsoft.com/ja-jp/bd61be84-c143-409a-a75a-44253724f784)   
+ [Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)   
+ [Role\-Based Security](http://msdn.microsoft.com/ja-jp/239442e3-5be4-4203-b7fd-793baffea803)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/commands-and-parameters.md b/docs/framework/data/adonet/commands-and-parameters.md
new file mode 100644
index 00000000000..eadd3d095fd
--- /dev/null
+++ b/docs/framework/data/adonet/commands-and-parameters.md
@@ -0,0 +1,44 @@
+---
+title: "コマンドとパラメーター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b623f810-d871-49a5-b0f5-078cc3c34db6
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# コマンドとパラメーター
+データ ソースへの接続を確立した後、<xref:System.Data.Common.DbCommand> オブジェクトを使用してコマンドを実行し、データ ソースから結果を返すことができます。  コマンドは、使用している .NET Framework データ プロバイダーのいずれかのコマンド コンストラクターで作成できます。  コンストラクターには、データ ソースで実行する SQL ステートメント、<xref:System.Data.Common.DbConnection> オブジェクト、<xref:System.Data.Common.DbTransaction> オブジェクトなど、オプションの引数を渡すことができます。  これらのオブジェクトをコマンドのプロパティとして構成することもできます。  また、`DbConnection` オブジェクトの <xref:System.Data.Common.DbConnection.CreateCommand%2A> メソッドを使用して、特定の接続用のコマンドを作成することもできます。  コマンドによって実行される SQL ステートメントは、<xref:System.Data.Common.DbCommand.CommandText%2A> プロパティを使って構成できます。  
+  
+ .NET Framework に含まれている各 .NET Framework データ プロバイダーは、`Command` オブジェクトを持ちます。  .NET Framework Data Provider for OLE DB には <xref:System.Data.OleDb.OleDbCommand> オブジェクト、.NET Framework Data Provider for SQL Server には <xref:System.Data.SqlClient.SqlCommand> オブジェクト、.NET Framework Data Provider for ODBC には <xref:System.Data.Odbc.OdbcCommand> オブジェクト、.NET Framework Data Provider for Oracle には <xref:System.Data.OracleClient.OracleCommand> があります。  
+  
+## このセクションの内容  
+ [コマンドの実行](../../../../docs/framework/data/adonet/executing-a-command.md)  
+ ADO.NET の `Command` オブジェクトと、それを使用してデータ ソースに対してクエリやコマンドを実行する方法について説明します。  
+  
+ [パラメーターおよびパラメーター データ型の構成](../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)  
+ `Command` のパラメーターの使用 \(方向、データ型、パラメーター構文など\) について説明します。  
+  
+ [CommandBuilder でのコマンドの生成](../../../../docs/framework/data/adonet/generating-commands-with-commandbuilders.md)  
+ `DataAdapter` に単一テーブルを対象とする SELECT コマンドが割り当てられているときに、コマンド ビルダーを使用して INSERT、UPDATE、DELETE の各コマンドを自動的に生成する方法について説明します。  
+  
+ [データベースからの単一の値の取得](../../../../docs/framework/data/adonet/obtaining-a-single-value-from-a-database.md)  
+ `Command` オブジェクトの `ExecuteScalar` メソッドを使用してデータベース クエリから単一の値を返す方法について説明します。  
+  
+ [コマンドを使用したデータ変更](../../../../docs/framework/data/adonet/using-commands-to-modify-data.md)  
+ データ プロバイダーを使用して、ストアド プロシージャまたはデータ定義言語 \(DDL\) のステートメントを実行する方法について説明します。  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/common-schema-collections.md b/docs/framework/data/adonet/common-schema-collections.md
new file mode 100644
index 00000000000..c0df60dafdb
--- /dev/null
+++ b/docs/framework/data/adonet/common-schema-collections.md
@@ -0,0 +1,107 @@
+---
+title: "共通のスキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 50127ced-2ac8-4d7a-9cd1-5c98c655ff03
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 共通のスキーマ コレクション
+共通のスキーマ コレクションとは、それぞれの .NET Framework マネージ プロバイダーにより実装されるスキーマ コレクションのことです。  .NET Framework マネージ プロバイダーでは、引数を指定しないで、またはスキーマ コレクション名に "MetaDataCollections" を指定して **GetSchema** メソッドを呼び出すことにより、サポートされるスキーマ コレクションの一覧を決定します。  これにより、サポートされるスキーマ コレクションの一覧、それぞれがサポートする制限数、および使用する識別子部分の数と共に、<xref:System.Data.DataTable> が返されます。  これらのコレクションは、必要なすべての列を表現します。  プロバイダーでは、任意で列を追加できます。  たとえば、`SqlClient` と `OracleClient` は、ParameterName を制限のコレクションに追加します。  
+  
+ プロバイダーでは必要な列の値を特定できない場合、null を返します。  
+  
+ **GetSchema** メソッドの使用に関する詳細については、「[GetSchema およびスキーマ コレクション](../../../../docs/framework/data/adonet/getschema-and-schema-collections.md)」を参照してください。  
+  
+## MetaDataCollections  
+ このスキーマ コレクションは、データベースに接続するために現在使用されている、.NET Framework マネージ プロバイダーによりサポートされるすべてのスキーマ コレクションに関する情報を公開します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|CollectionName|string|コレクションを返すために **GetSchema** メソッドに渡すコレクションの名前。|  
+|NumberOfRestriction|int|コレクションに対して指定できる制限の数。|  
+|NumberOfIdentifierParts|int|複合識別子部分とデータベース オブジェクト名部分の数。  たとえば、SQL Server の場合は、テーブルに 3 つ、列に 4 つになります。  Oracle の場合は、テーブルに 2 つ、列に 3 つになります。|  
+  
+## DataSourceInformation  
+ このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続しているデータ ソースに関する情報を公開します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|CompositeIdentifierSeparatorPattern|string|複合識別子内の複合セパレーターと一致する正規表現。  たとえば "\\" です。\(SQL Server の場合\) や、"@&#124;\\." \(Oracle の場合\) のように指定します。<br /><br /> 複合識別子は、通常、データベース オブジェクト名で使用されます。たとえば、pubs.dbo.authors または pubs@dbo.authors のようになります。<br /><br /> SQL Server の場合、"\\." という正規表現を使用します。  OracleClient の場合、"@&#124;\\." を使用します。<br /><br /> ODBC の場合、Catalog\_name\_seperator を使用します。<br /><br /> OLE DB の場合、DBLITERAL\_CATALOG\_SEPARATOR または DBLITERAL\_SCHEMA\_SEPARATOR を使用します。|  
+|DataSourceProductName|string|"Oracle" や "SQLServer" など、プロバイダーによってアクセスされる製品の名前。|  
+|DataSourceProductVersion|string|プロバイダーによりアクセスされる製品のバージョンを、Microsoft の形式ではなく、データ ソースのネイティブ形式で表します。<br /><br /> 場合によっては、DataSourceProductVersion と DataSourceProductVersionNormalized は同じ値になります。  OLE DB と ODBC の場合、これらの値は、元になるネイティブ API 内の同じ関数呼び出しに割り当てられているので、常に同じ値になります。|  
+|DataSourceProductVersionNormalized|string|`String.Compare()` を使用して比較できるような、データ ソースの正規化されたバージョン。  この形式は、バージョン 10 がバージョン 1 とバージョン 2 の間に並べ替えられることがないように、プロバイダーのすべてのバージョンで一貫しています。<br /><br /> たとえば、Oracle プロバイダーは、正規化されたバージョンで "nn.  nn.  nn.  nn.  nn" という形式を使用します。このため、Oracle 8i データ ソースは、"08.01.07.04.01" を返します。  SQL Server では、一般的な Microsoft 形式である "nn.  nn.  nnnn" を使用します。<br /><br /> 場合によっては、DataSourceProductVersion と DataSourceProductVersionNormalized は同じ値になります。  OLE DB と ODBC の場合、これらの値は、元になるネイティブ API 内の同じ関数呼び出しに割り当てられているので、常に同じ値になります。|  
+|GroupByBehavior|<xref:System.Data.Common.GroupByBehavior>|GROUP BY 句の列と SELECT リストの集計以外の列間のリレーションシップを指定します。|  
+|IdentifierPattern|string|識別子と一致し、その識別子の一致した値がある正規表現。  たとえば "\[A\-Za\-z0\-9\_\#$\]" になります。|  
+|IdentifierCase|<xref:System.Data.Common.IdentifierCase>|引用符で囲まれていない識別子が、大文字と小文字を区別して扱われるかどうかを示します。|  
+|OrderByColumnsInSelect|bool|ORDER BY 句の列が SELECT リストになければならないかどうかを示します。  値が true である場合、SELECT リストになければならないことを示します。値が false である場合、SELECT リストにある必要がないことを示します。|  
+|ParameterMarkerFormat|string|パラメーターを書式設定する方法を表す書式文字列。<br /><br /> 名前付きパラメーターがデータ ソースでサポートされている場合、この文字列内の最初のプレースホルダーは、パラメーター名が書式設定される場所である必要があります。<br /><br /> たとえば、データ ソースが名前に ":" というプレフィックスが付いたパラメーターを要求している場合、これは ":{0}" になります。  これを "p1" のパラメーター名で書式設定すると、結果の文字列は ":p1" になります。<br /><br /> データ ソースが "@" というプレフィックスが付いたパラメーターを要求しているが、既に名前に含まれている場合、"{0}" になります。"@p1" というパラメーターを書式設定した結果は、単に "@p1" になります。<br /><br /> 名前付きパラメーターを要求せず、"?" 文字の使用を要求するデータ ソースの場合、書式文字列は、パラメーター名を無視する "?" として指定できます。  OLE DB の場合、"?" を返します。|  
+|ParameterMarkerPattern|string|パラメーター マーカーと一致する正規表現。  パラメーター名の一致する値になります \(一致する値がある場合\)。<br /><br /> たとえば、パラメーター名に "@" という前置文字が含まれている、名前付きパラメーターがサポートされている場合、"\(@\[A\-Za\-z0\-9\_$\#\]\*\)" となります。<br /><br /> ただし、前置文字として ":" が付いた名前付きパラメーターがサポートされていて、":" がパラメーター名の一部になっていない場合、":\(\[A\-Za\-z0\-9\_$\#\]\*\)" となります。<br /><br /> もちろん、データ ソースが名前付きパラメーターをサポートしない場合は、単に "?" になります。|  
+|ParameterNameMaxLength|int|パラメーター名の文字の最大長。  Visual Studio では、パラメーター名がサポートされている場合、最大長の最小値が 30 文字であることを想定しています。<br /><br /> データ ソースが名前付きパラメーターをサポートしない場合、このプロパティは 0 を返します。|  
+|ParameterNamePattern|string|有効なパラメーター名と一致する正規表現。  異なるデータ ソースでは、パラメーター名として使用できる文字に関して、規則が異なります。<br /><br /> Visual Studio では、パラメーター名がサポートされている場合、文字 "\\p{Lu}\\p{Ll}\\p{Lt}\\p{Lm}\\p{Lo}\\p{Nl}\\p{Nd}" が、パラメーター名として有効な、サポートされる最小限の文字のセットです。|  
+|QuotedIdentifierPattern|string|引用符で囲まれた識別子と一致し、引用符を除いた識別子自体の一致する値のある正規表現。  たとえば、データ ソースが引用符で囲まれた識別子を識別するために、二重引用符を使用した場合、"\(\(\[^\\"\]&#124;\\"\\"\)\*\)" になります。|  
+|QuotedIdentifierCase|<xref:System.Data.Common.IdentifierCase>|引用符で囲まれた識別子が、大文字と小文字を区別して扱われるかどうかを示します。|  
+|StatementSeparatorPattern|string|ステートメント区切り文字と一致する正規表現。|  
+|StringLiteralPattern|string|文字列リテラルと一致し、リテラル自体の一致する値のある正規表現。  たとえば、データ ソースが文字列を識別するために単一引用符を使用した場合、"\('\(\[^'\]&#124;''\)\*'\)"' になります。|  
+|SupportedJoinOperators|<xref:System.Data.Common.SupportedJoinOperators>|データ ソースでサポートされる SQL の JOIN ステートメントの種類を指定します。|  
+  
+## DataTypes  
+ このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続されているデータベースでサポートされているデータ型に関する情報を公開します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|TypeName|string|プロバイダー固有のデータ型の名前。|  
+|ProviderDbType|int|パラメーターの型を指定するときに使用する必要のある、プロバイダー固有の型の値。  たとえば、SqlDbType.Money または OracleType.Blob になります。|  
+|ColumnSize|long|数値以外の列またはパラメーターの長さは、最大長か、プロバイダーによりこの型に定義された長さのいずれかを参照します。<br /><br /> 文字データの場合、これは、最大長か、データ ソースにより定義されている単位で定義された長さです。  Oracle には、長さを指定してから、一部の文字データ型の実際の格納サイズを指定するという概念があります。  これは、Oracle の単位で長さのみを定義します。<br /><br /> 日時のデータ型の場合、これは \(秒の小数部構成要素の最大有効桁数を前提として\) 文字列表現の長さです。<br /><br /> データ型が数値である場合、これは、データ型の最大有効桁数の上限です。|  
+|CreateFormat|string|CREATE TABLE などのデータ定義ステートメントに、この列を追加する方法を示す書式文字列。  CreateParameter 配列の各要素は、書式文字列内で "パラメーター マーカー" で表される必要があります。<br /><br /> たとえば、SQL データ型の DECIMAL には Precision と Scale が必要です。  この場合、書式文字列は "DECIMAL\({0},{1}\)" になります。|  
+|CreateParameters|string|このデータ型の列を作成する場合に指定する必要のある作成パラメーター。  各作成パラメーターは、指定される順序で、コンマで区切られた一覧として文字列内に示されます。<br /><br /> たとえば、SQL データ型の DECIMAL には Precision と Scale が必要です。  この場合、作成パラメーターには、"precision, scale" という文字列が含まれる必要があります。<br /><br /> precision を 10、scale を 2 として DECIMAL 列を作成するためのテキスト コマンド内では、CreateFormat 列の値は DECIMAL\({0},{1}\) になり、完全な型指定は DECIMAL\(10,2\) になります。|  
+|DataType|string|データ型の .NET Framework 型の名前。|  
+|IsAutoincrementable|bool|true の場合、このデータ型の値で自動インクリメントが行われます。<br /><br /> false の場合、このデータ型の値で自動インクリメントは行われません。<br /><br /> このデータ型の 1 つの列で自動インクリメントが行われるかどうかを示しているだけであり、この型のすべての列で自動インクリメントが行われるわけではないことに注意してください。|  
+|IsBestMatch|bool|true の場合、データ ストア内のすべてのデータ型と、DataType 列の値により指定されている .NET Framework データ型との間で、最も一致するデータ型になります。<br /><br /> false の場合、データ型は、最も一致するデータ型ではありません。<br /><br /> DataType 列の値が同じ行のセットでは、1 行だけで BestMatch 列が true に設定されます。|  
+|IsCaseSensitive|bool|true の場合、データ型は文字型であり、大文字と小文字が区別されます。<br /><br /> false の場合、データ型は文字型ではなく、大文字と小文字は区別されません。|  
+|IsFixedLength|bool|true の場合、データ定義言語 \(DDL\) により作成されたこのデータ型の列は、固定長になります。<br /><br /> false の場合、DDL により作成されたこのデータ型の列は、可変長になります。<br /><br /> DBNull.Value の場合、プロバイダーがこのフィールドを固定長の列または可変長の列のどちらで割り当てるかは不明です。|  
+|IsFixedPrecisionScale|bool|true の場合、データ型には、固定有効桁数と小数点以下桁数があります。<br /><br /> false の場合、データ型には、固定有効桁数と小数点以下桁数がありません。|  
+|IsLong|bool|true の場合、データ型には、非常に長いデータが含まれます。非常に長いデータの定義は、プロバイダーによって異なります。<br /><br /> false の場合、データ型には、非常に長いデータは含まれません。|  
+|IsNullable|bool|true の場合、データ型は null に設定できます。<br /><br /> false の場合、データ型は null に設定できません。<br /><br /> DBNull.Value の場合、データ型を null に設定できるかどうかは不明です。|  
+|IsSearchable|bool|true の場合、データ型は、LIKE 述語を除く任意の演算子と共に WHERE 句で使用できます。<br /><br /> false の場合、データ型は、LIKE 述語を除く任意の演算子と共に WHERE 句で使用できません。|  
+|IsSearchableWithLike|bool|true の場合、データ型は、LIKE 述語と共に使用できます。<br /><br /> false の場合、データ型は、LIKE 述語と共に使用できません。|  
+|IsUnsigned|bool|true の場合、データ型は符号なしになります。<br /><br /> false の場合、データ型は符号付きになります。<br /><br /> DBNull.Value の場合、データ型に適用されません。|  
+|MaximumScale|short|型インジケーターが数値型である場合、小数点の右側にとることができる最大桁数になります。  それ以外の場合は DBNull.Value になります。|  
+|MinimumScale|short|型インジケーターが数値型である場合、小数点の右側にとることができる最小桁数になります。  それ以外の場合は DBNull.Value になります。|  
+|IsConcurrencyType|bool|true の場合、データ型は、行が変更されるたびにデータベースにより更新され、列の値がすべての前の値とは異なります。<br /><br /> false の場合、行が変更されるたびにデータ型がデータベースにより更新されることはありません。<br /><br /> DBNull.Value の場合、データベースでは、この型のデータ型をサポートしません。|  
+|IsLiteralsSupported|bool|true の場合、データ型は、リテラルとして表現できます。<br /><br /> false の場合、データ型は、リテラルとして表現できません。|  
+|LiteralPrefix|string|指定されたリテラルに適用されるプレフィックス。|  
+|LitteralSuffix|string|指定されたリテラルに適用されるサフィックス。|  
+|NativeDataType|String|NativeDataType は、データ型の OLE DB 型を公開するための OLE DB 固有の列です。|  
+  
+## 制約  
+ このスキーマ コレクションは、データベースへの接続に現在使用されている、.NET Framework マネージ プロバイダーでサポートされる制限に関する情報を公開します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|CollectionName|string|これらの制限を適用するコレクションの名前。|  
+|RestrictionName|string|コレクション内の制限の名前。|  
+|RestrictionDefault|string|無視されます。|  
+|RestrictionNumber|int|この特定の制限が収まっているコレクションの制限内の実際の位置。|  
+  
+## ReservedWords  
+ このスキーマ コレクションは、.NET Framework マネージ プロバイダーが現在接続されているデータベースにより予約されている予約語に関する情報を公開します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|ReservedWords|string|プロバイダー固有の予約語。|  
+  
+## 参照  
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [GetSchema およびスキーマ コレクション](../../../../docs/framework/data/adonet/getschema-and-schema-collections.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/comparing-datarows-linq-to-dataset.md b/docs/framework/data/adonet/comparing-datarows-linq-to-dataset.md
new file mode 100644
index 00000000000..d828925e26d
--- /dev/null
+++ b/docs/framework/data/adonet/comparing-datarows-linq-to-dataset.md
@@ -0,0 +1,48 @@
+---
+title: "Comparing DataRows (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8fe0eadf-297b-487c-8d4b-7816753c2883
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Comparing DataRows (LINQ to DataSet)
+[!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] では、ソース要素を比較し、両者が等しいかどうかを調べるための各種の集合演算子が定義されています。  [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] が提供している集合演算子は次のとおりです。  
+  
+-   <xref:System.Linq.Enumerable.Distinct%2A>  
+  
+-   <xref:System.Linq.Enumerable.Union%2A>  
+  
+-   <xref:System.Linq.Enumerable.Intersect%2A>  
+  
+-   <xref:System.Linq.Enumerable.Except%2A>  
+  
+ これらの演算子は、要素のコレクションに対して <xref:System.Collections.Generic.IEqualityComparer%601.GetHashCode%2A> メソッドおよび <xref:System.Collections.Generic.IEqualityComparer%601.Equals%2A> メソッドを呼び出すことによってソース要素を比較します。  <xref:System.Data.DataRow> の場合、これらの演算子によって実行されるのは参照の比較です。表形式のデータに対する集合演算においては適切な動作とは言えません。  通常、集合演算で重要なのは要素の値が等しいかどうかであって、要素の参照が等しいかどうかではありません。  このような理由から、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] に <xref:System.Data.DataRowComparer> クラスが追加されました。  このクラスを使用することで行の値を比較できます。  
+  
+ <xref:System.Data.DataRowComparer> クラスには、<xref:System.Data.DataRow> の値を比較するための機能が実装されています。このクラスを <xref:System.Linq.Enumerable.Distinct%2A> などの集合演算に使用できます。  このクラスを直接インスタンス化することはできません。代わりに、<xref:System.Data.DataRowComparer.Default%2A> プロパティを使用して、<xref:System.Data.DataRowComparer> のインスタンスを取得する必要があります。  その後、<xref:System.Data.DataRowComparer.Equals%2A> メソッドを呼び出す際、比較する 2 つの <xref:System.Data.DataRow> オブジェクトを入力パラメーターとして渡します。  <xref:System.Data.DataRowComparer.Equals%2A> メソッドは、2 つの <xref:System.Data.DataRow> オブジェクトに含まれる一連の列値が等しければ `true` を、それ以外の場合は `false` を返します。  
+  
+## 例  
+ この例では、両方のテーブルに存在する連絡先を `Intersect` を使用して取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Intersect2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#intersect2)]
+ [!code-vb[DP LINQ to DataSet Examples#Intersect2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#intersect2)]  
+  
+### 例  
+ 次の例では、2 つの行を比較して、そのハッシュ コードを取得します。  
+  
+ [!code-vb[DP LINQ to DataSet Examples#CompareDifferentRows](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#comparedifferentrows)]  
+  
+## 参照  
+ <xref:System.Data.DataRowComparer>   
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/complex-type.md b/docs/framework/data/adonet/complex-type.md
new file mode 100644
index 00000000000..d2f72a32d7a
--- /dev/null
+++ b/docs/framework/data/adonet/complex-type.md
@@ -0,0 +1,49 @@
+---
+title: "複合型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63efbd23-11d4-4871-bc88-ad01b9837553
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 複合型
+*複合型*は、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)またはその他の複合型に、構造化された豊富なプロパティを定義するためのテンプレートです。  各テンプレートには、以下が含まれています。  
+  
+-   一意の名前   \(必須\)  
+  
+    > [!NOTE]
+    >  複合型の名前は、同じ名前空間のエンティティ型の名前と同じにすることはできません。  
+  
+-   1 つ以上の[プロパティ](../../../../docs/framework/data/adonet/property.md)の形式のデータ。  \(省略可能\)  
+  
+    > [!NOTE]
+    >  複合型のプロパティには、別の複合型を使用することができます。  
+  
+ 複合型は、プリミティブ型のプロパティまたはその他の複合型の形式でデータ ペイロードを伝達できる点がエンティティ型と似ています。  ただし、複合型とエンティティ型の間にはいくつかの重要な違いがあります。  
+  
+-   複合型には ID がないため、独立して存在することができません。  複合型は、エンティティ型またはその他の複合型のプロパティとしてのみ存在できます。  
+  
+-   複合型は、[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)に参加できません。  アソシエーションのいずれの End にも複合型を指定できないため、複合型には[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)を定義できません。  
+  
+## 例  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、`StreetAddress`、`City`、`StateOrProvince`、`Country`、および `PostalCode` のプリミティブ型のプロパティの複合型 Address を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#ComplexTypeExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books2.edmx#complextypeexample)]  
+  
+ エンティティ型のプロパティとして複合型 `Address` \(上の図\) を定義するには、エンティティ型の定義にプロパティの型を宣言する必要があります。  次の CSDL は、エンティティ型 \(Publisher\) に複合型として `Address` プロパティを宣言しています。  
+  
+ [!code-xml[EDM_Example_Model#EntityWithComplexType](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books3.edmx#entitywithcomplextype)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md b/docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md
new file mode 100644
index 00000000000..36c9bd36c95
--- /dev/null
+++ b/docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md
@@ -0,0 +1,206 @@
+---
+title: "パラメーターおよびパラメーター データ型の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 537d8a2c-d40b-4000-83eb-bc1fcc93f707
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# パラメーターおよびパラメーター データ型の構成
+コマンド オブジェクトは、パラメーターを使用して SQL ステートメントまたはストアド プロシージャに値を渡すことによって、型チェックと検証の機能を実現します。 コマンド テキストとは異なり、パラメーターの入力は実行可能なコードとしてではなく、リテラル値として扱われます。 これにより、攻撃者がサーバーのセキュリティを侵害するコマンドを SQL ステートメントに "注入" する SQL インジェクション攻撃を防ぐことができます。  
+  
+ パラメーター化コマンドによりクエリ実行パフォーマンスも向上します。これは、データベース サーバーが入力コマンドを適切なキャッシュ済みクエリ プランに正確に一致させるのに役立つためです。 詳細については、SQL Server オンライン ブックの「[実行プランのキャッシュと再利用](http://go.microsoft.com/fwlink/?LinkId=120424)」および「[パラメーターと実行プランの再利用](http://go.microsoft.com/fwlink/?LinkId=120423)」を参照してください。 セキュリティおよびパフォーマンス上の利点に加え、パラメーター化コマンドを使用すると、データ ソースに渡す値を簡単に扱うことができます。  
+  
+ <xref:System.Data.Common.DbParameter> オブジェクトは、コンストラクターを使って作成できるほか、<xref:System.Data.Common.DbCommand.DbParameterCollection%2A> コレクションの `Add` メソッドを呼び出し、<xref:System.Data.Common.DbParameterCollection> にオブジェクトを追加することによって作成することもできます。`Add` メソッドは、コンストラクター引数または既存のパラメーター オブジェクトを入力として受け取ります。この点はデータ プロバイダーによっても異なります。  
+  
+## ParameterDirection プロパティの指定  
+ パラメーターを追加する際は、入力パラメーターとは別に、パラメーターの <xref:System.Data.ParameterDirection> プロパティを指定する必要があります。`ParameterDirection` で使用できる <xref:System.Data.ParameterDirection> の値を次の表に示します。  
+  
+|メンバー名|説明|  
+|-----------|--------|  
+|<xref:System.Data.ParameterDirection>|このパラメーターは入力パラメーターです。 既定値です。|  
+|<xref:System.Data.ParameterDirection>|このパラメーターは入力と出力の両方の機能を持っています。|  
+|<xref:System.Data.ParameterDirection>|このパラメーターは出力パラメーターです。|  
+|<xref:System.Data.ParameterDirection>|パラメーターは、ストアド プロシージャ、組み込み関数、ユーザー定義関数などの操作からの戻り値を表します。|  
+  
+## パラメーターのプレースホルダーの使用  
+ パラメーターのプレースホルダーの構文はデータ ソースに依存します。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のデータ プロバイダーによって、パラメーターおよびパラメーターのプレースホルダーの名前付けや指定方法が異なります。 次の表に示すように、データ ソースごとに固有の構文が採用されています。  
+  
+|データ プロバイダー|パラメーターの名前付け構文|  
+|----------------|-------------------|  
+|<xref:System.Data.SqlClient>|`@` *parametername* 形式の名前付きパラメーターが使用されます。|  
+|<xref:System.Data.OleDb>|疑問符 \(`?`\) で指定される位置パラメーター マーカーが使用されます。|  
+|<xref:System.Data.Odbc>|疑問符 \(`?`\) で指定される位置パラメーター マーカーが使用されます。|  
+|<xref:System.Data.OracleClient>|`:` *parmname* \(または *parmname*\) 形式の名前付きパラメーターが使用されます。|  
+  
+## パラメーターのデータ型の指定  
+ パラメーターのデータ型は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーに固有の属性です。 型が指定されている場合は、その値がデータ ソースに渡される前に `Parameter` の値が [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダー型に変換されます。`Parameter` オブジェクトの `DbType` プロパティを特定の `Parameter` に設定する一般的な方法で <xref:System.Data.DbType> の型を指定することもできます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトの `Parameter` データ プロバイダー型は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトの `Value` の `Parameter` 型、または `DbType` オブジェクトの `Parameter` から推論されます。`Parameter` 値として渡されるオブジェクトまたは指定された `Parameter` に基づいて推論される `DbType` 型を、次の表に示します。  
+  
+|.NET Framework 型|DbType|SqlDbType|OleDbType|OdbcType|OracleType|  
+|----------------------|------------|---------------|---------------|--------------|----------------|  
+|<xref:System.Boolean>|ブール型|ビット|Boolean|ビット|Byte|  
+|<xref:System.Byte>|Byte|TinyInt|UnsignedTinyInt|TinyInt|Byte|  
+|byte\[\]|2 項|VarBinary`.` 。バイト配列が VarBinary の最大サイズ \(8000 バイト\) より大きい場合、この暗黙の変換はエラーになります。8000 バイトを超えるバイト配列の場合は、明示的に <xref:System.Data.SqlDbType> を設定してください。|VarBinary|2 項|Raw|  
+|<xref:System.Char>|``|char から <xref:System.Data.SqlDbType> への推論はサポートされていません。|Char|Char|Byte|  
+|<xref:System.DateTime>|DateTime|DateTime|DBTimeStamp|DateTime|DateTime|  
+|<xref:System.DateTimeOffset>|DateTimeOffset|SQL Server 2008 の DateTimeOffset。 SQL Server 2008 より前のバージョンの SQL Server では、DateTimeOffset から <xref:System.Data.SqlDbType> への推論はサポートされていません。|||DateTime|  
+|<xref:System.Decimal>|Decimal \(10 進数型\)|Decimal \(10 進数型\)|Decimal \(10 進数型\)|数字|Number|  
+|<xref:System.Double>|倍精度浮動小数点型|Float|Double \(倍精度浮動小数点型\)|Double \(倍精度浮動小数点型\)|倍精度浮動小数点型|  
+|<xref:System.Single>|Single|Real|Single|Real|Float|  
+|<xref:System.Guid>|Guid|UniqueIdentifier|Guid|UniqueIdentifier|Raw|  
+|<xref:System.Int16>|Int16|SmallInt|SmallInt|SmallInt|Int16|  
+|<xref:System.Int32>|Int32|Int|Int|Int|Int32|  
+|<xref:System.Int64>|Int64|BigInt|BigInt|BigInt|Number|  
+|<xref:System.Object>|オブジェクト|バリアント|バリアント|Object から OdbcType への推論はサポートされていません。|Blob|  
+|<xref:System.String>|String|NVarChar。 文字列が NVarChar の最大サイズ \(4000 文字\) より大きい場合、この暗黙の変換はエラーになります。 4000 文字を超える文字列の場合は、明示的に <xref:System.Data.SqlDbType> を設定してください。|VarWChar|NVarChar|NVarChar|  
+|<xref:System.TimeSpan>|時間|SQL Server 2008 の Time。 SQL Server 2008 より前のバージョンの SQL Server では、TimeSpan から <xref:System.Data.SqlDbType> への推論はサポートされていません。|DBTime|時刻|DateTime|  
+|<xref:System.UInt16>|UInt16|UInt16 から <xref:System.Data.SqlDbType> への推論はサポートされていません。|UnsignedSmallInt|Int|UInt16|  
+|<xref:System.UInt32>|UInt32|UInt32 から <xref:System.Data.SqlDbType> への推論はサポートされていません。|UnsignedInt|BigInt|UInt32|  
+|<xref:System.UInt64>|UInt64|UInt64 から <xref:System.Data.SqlDbType> への推論はサポートされていません。|UnsignedBigInt|数字|Number|  
+||AnsiString|VarChar|VarChar|VarChar|VarChar|  
+||AnsiStringFixedLength|Char|Char|Char|Char|  
+|``|通貨|通貨|通貨|`OdbcType` から `Currency` への推論はサポートされていません。|Number|  
+|``|日付|SQL Server 2008 の Date。 SQL Server 2008 より前のバージョンの SQL Server では、Date から <xref:System.Data.SqlDbType> への推論はサポートされていません。|DBDate|日付|DateTime|  
+|``|SByte|SByte から <xref:System.Data.SqlDbType> への推論はサポートされていません。|TinyInt|SByte から `OdbcType` への推論はサポートされていません。|SByte|  
+||StringFixedLength|NChar|WChar|NChar|NChar|  
+||時刻|SQL Server 2008 の Time。 SQL Server 2008 より前のバージョンの SQL Server では、Time から <xref:System.Data.SqlDbType> への推論はサポートされていません。|DBTime|時刻|DateTime|  
+||VarNumeric|VarNumeric から <xref:System.Data.SqlDbType> への推論はサポートされていません。|VarNumeric|VarNumeric から `OdbcType` への推論はサポートされていません。|Number|  
+|ユーザー定義型 \(<xref:Microsoft.SqlServer.Server.SqlUserDefinedAggregateAttribute> を持つオブジェクト\)|プロバイダーに応じて Object または String \(SqlClient は常に Object を返し、Odbc は常に String を返します。OleDb マネージ データ プロバイダーはいずれかを表示できます\)。|<xref:Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute> がある場合は SqlDbType.Udt、それ以外の場合は Variant。|OleDbType.VarWChar \(値が null の場合\)、それ以外の場合は OleDbType.Variant。|OdbcType.NVarChar|サポート外|  
+  
+> [!NOTE]
+>  decimal から他の型への変換は縮小変換になるため、decimal 値は最も近い整数値に切り捨てられます。 変換結果が対象の型にならなかった場合、<xref:System.OverflowException> がスローされます。  
+  
+> [!NOTE]
+>  サーバーに NULL パラメーター値を送信する場合は、<xref:System.DBNull> \(`null` の場合は `Nothing`\) ではなく、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] を指定する必要があります。 システムの null 値は、値のない空オブジェクトです。<xref:System.DBNull> は、null 値を表すために使用します。 データベースの NULL 値の詳細については、「[NULL 値の処理](../../../../docs/framework/data/adonet/sql/handling-null-values.md)」を参照してください。  
+  
+## パラメーター情報の派生  
+ `DbCommandBuilder` クラスを使用してストアド プロシージャからパラメーターを派生させることができます。`SqlCommandBuilder` クラスと `OleDbCommandBuilder` クラスはどちらも静的メソッド `DeriveParameters` を提供します。このメソッドは、ストアド プロシージャから得られたパラメーター情報を使用して、コマンド オブジェクトのパラメーター コレクションを設定します。`DeriveParameters`  はコマンドの既存のパラメーター情報を上書きします。  
+  
+> [!NOTE]
+>  パラメーター情報を派生させた場合、情報を取得するためにデータ ソースへのラウンド トリップが 1 つ増えるため、パフォーマンスが低下します。 パラメーター情報がデザイン時にわかっている場合は、パラメーターを明示的に設定することでアプリケーションのパフォーマンスを改善できます。  
+  
+ 詳細については、「[CommandBuilder でのコマンドの生成](../../../../docs/framework/data/adonet/generating-commands-with-commandbuilders.md)」を参照してください。  
+  
+## SqlCommand およびストアド プロシージャでのパラメーターの使用  
+ ストアド プロシージャは、データドリブンのアプリケーションに多くの利点を提供します。 ストアド プロシージャを使用すると、データベースの操作を単一のコマンドにカプセル化し、最大のパフォーマンスが得られるように最適化し、さらに追加のセキュリティ機能を使用して、セキュリティを強化することができます。 ストアド プロシージャは、ストアド プロシージャ名の後にパラメーター引数を記述して SQL ステートメントとして渡すことで呼び出すことができますが、<xref:System.Data.Common.DbCommand.Parameters%2A> の [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] オブジェクトの <xref:System.Data.Common.DbCommand> コレクションを使用すると、ストアド プロシージャ パラメーターをより明示的に定義でき、出力パラメーターや戻り値にもアクセスできます。  
+  
+> [!NOTE]
+>  パラメーター化ステートメントは、`sp_executesql,` を使ってサーバー上で実行されるため、クエリ プランの再利用が可能になります。`sp_executesql` バッチ内のローカル カーソルまたはローカル変数は、`sp_executesql` を呼び出すバッチでは認識されません。 データベース コンテキストの変更は、`sp_executesql` ステートメント終了時まで有効です。 詳細については、SQL Server オンライン ブックを参照してください。  
+  
+ <xref:System.Data.SqlClient.SqlCommand> でパラメーターを使用して SQL Server のストアド プロシージャを実行する場合は、<xref:System.Data.SqlClient.SqlCommand.Parameters%2A> コレクションに追加したパラメーターの名前が、ストアド プロシージャ内のパラメーター マーカーの名前と一致している必要があります。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for SQL Server は、SQL ステートメントまたはストアド プロシージャにパラメーターを渡す場合の疑問符 \(?\) プレースホルダーをサポートしていません。 ストアド プロシージャ内のパラメーターは名前付きのパラメーターと見なされ、一致するパラメーター マーカーが検索されます。 たとえば、`CustOrderHist` ストアド プロシージャが、`@CustomerID` という名前のパラメーターで定義されているとします。 このストアド プロシージャを実行する場合、実行元のコードでも `@CustomerID` という名前のパラメーターを使用する必要があります。  
+  
+```  
+CREATE PROCEDURE dbo.CustOrderHist @CustomerID varchar(5)  
+```  
+  
+### 例  
+ 次の例では、`Northwind` サンプル データベースにある SQL Server ストアド プロシージャを呼び出す方法を説明します。 ストアド プロシージャの名前は `dbo.SalesByCategory` で、`@CategoryName` データ型の `nvarchar(15)` という名前の入力パラメーターを持ちます。 このコードでは、プロシージャの終了時に接続が破棄されるように、using ブロック内で新しい <xref:System.Data.SqlClient.SqlConnection> を作成しています。<xref:System.Data.SqlClient.SqlCommand> オブジェクトおよび <xref:System.Data.SqlClient.SqlParameter> オブジェクトが作成され、それぞれのプロパティが設定されます。<xref:System.Data.SqlClient.SqlDataReader> によって `SqlCommand` が実行された後、ストアド プロシージャから結果セットが返されて、出力がコンソール ウィンドウに表示されます。  
+  
+> [!NOTE]
+>  `SqlCommand` オブジェクトと `SqlParameter` オブジェクトを作成してから別個のステートメントでプロパティを設定する代わりに、オーバーロード コンストラクターを使用して複数のプロパティを 1 つのステートメントで設定することもできます。  
+  
+ [!code-csharp[DataWorks SqlClient.StoredProcedure#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.StoredProcedure/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.StoredProcedure#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.StoredProcedure/VB/source.vb#1)]  
+  
+## OleDbCommand または OdbcCommand によるパラメーターの使用  
+ <xref:System.Data.OleDb.OleDbCommand> または <xref:System.Data.Odbc.OdbcCommand> でパラメーターを使用するときは、`Parameters` コレクションにパラメーターが追加されている順序が、ストアド プロシージャ内でパラメーターが定義されている順序と一致している必要があります。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC は、ストアド プロシージャ内のパラメーターをプレースホルダーとして処理し、順にパラメーター値を適用します。 また、戻り値パラメーターは、`Parameters` コレクションに最初に追加されたパラメーターにする必要があります。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC は、SQL ステートメントまたはストアド プロシージャにパラメーターを渡す場合の名前付きのパラメーターをサポートしていません。 この場合は、次の例に示すように、疑問符 \(?\) プレースホルダーを使用する必要があります。  
+  
+```  
+SELECT * FROM Customers WHERE CustomerID = ?  
+```  
+  
+ したがって、`Parameter` コレクションに `Parameters` オブジェクトを追加する順序は、パラメーターの疑問符 \(?\)  プレースホルダーの位置と完全に対応している必要があります。  
+  
+### OleDb の例  
+  
+```vb  
+Dim command As OleDbCommand = New OleDbCommand( _  
+  "SampleProc", connection)  
+command.CommandType = CommandType.StoredProcedure  
+  
+Dim parameter As OleDbParameter = command.Parameters.Add( _  
+  "RETURN_VALUE", OleDbType.Integer)  
+parameter.Direction = ParameterDirection.ReturnValue  
+  
+parameter = command.Parameters.Add( _  
+  "@InputParm", OleDbType.VarChar, 12)  
+parameter.Value = "Sample Value"  
+  
+parameter = command.Parameters.Add( _  
+  "@OutputParm", OleDbType.VarChar, 28)  
+parameter.Direction = ParameterDirection.Output  
+```  
+  
+```csharp  
+OleDbCommand command = new OleDbCommand("SampleProc", connection);  
+command.CommandType = CommandType.StoredProcedure;  
+  
+OleDbParameter parameter = command.Parameters.Add(  
+  "RETURN_VALUE", OleDbType.Integer);  
+parameter.Direction = ParameterDirection.ReturnValue;  
+  
+parameter = command.Parameters.Add(  
+  "@InputParm", OleDbType.VarChar, 12);  
+parameter.Value = "Sample Value";  
+  
+parameter = command.Parameters.Add(  
+  "@OutputParm", OleDbType.VarChar, 28);  
+parameter.Direction = ParameterDirection.Output;  
+```  
+  
+## Odbc の例  
+  
+```vb  
+Dim command As OdbcCommand = New OdbcCommand( _  
+  "{ ? = CALL SampleProc(?, ?) }", connection)  
+command.CommandType = CommandType.StoredProcedure  
+  
+Dim parameter As OdbcParameter = command.Parameters.Add("RETURN_VALUE", OdbcType.Int)  
+parameter.Direction = ParameterDirection.ReturnValue  
+  
+parameter = command.Parameters.Add( _  
+  "@InputParm", OdbcType.VarChar, 12)  
+parameter.Value = "Sample Value"  
+  
+parameter = command.Parameters.Add( _  
+  "@OutputParm", OdbcType.VarChar, 28)  
+parameter.Direction = ParameterDirection.Output  
+```  
+  
+```csharp  
+OdbcCommand command = new OdbcCommand( _  
+  "{ ? = CALL SampleProc(?, ?) }", connection);  
+command.CommandType = CommandType.StoredProcedure;  
+  
+OdbcParameter parameter = command.Parameters.Add( _  
+  "RETURN_VALUE", OdbcType.Int);  
+parameter.Direction = ParameterDirection.ReturnValue;  
+  
+parameter = command.Parameters.Add( _  
+  "@InputParm", OdbcType.VarChar, 12);  
+parameter.Value = "Sample Value";  
+  
+parameter = command.Parameters.Add( _  
+  "@OutputParm", OdbcType.VarChar, 28);  
+parameter.Direction = ParameterDirection.Output;  
+```  
+  
+## 参照  
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter パラメーター](../../../../docs/framework/data/adonet/dataadapter-parameters.md)   
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connecting-to-a-data-source.md b/docs/framework/data/adonet/connecting-to-a-data-source.md
new file mode 100644
index 00000000000..7fa077c12d2
--- /dev/null
+++ b/docs/framework/data/adonet/connecting-to-a-data-source.md
@@ -0,0 +1,37 @@
+---
+title: "ADO.NET でのデータ ソースへの接続 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9abc3f92-1be3-4e1a-b360-762dc689650e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ADO.NET でのデータ ソースへの接続
+ADO.NET では、**Connection** オブジェクトを使用して、接続文字列に必要な認証情報を指定することにより、特定のデータ ソースに接続します。  どの **Connection** オブジェクトを使用するかは、データ ソースの種類によって異なります。  
+  
+ .NET Framework に含まれている各 .NET Framework データ プロバイダーは、<xref:System.Data.Common.DbConnection> オブジェクトを持っています。.NET Framework Data Provider for OLE DB には <xref:System.Data.OleDb.OleDbConnection> オブジェクト、.NET Framework Data Provider for SQL Server には <xref:System.Data.SqlClient.SqlConnection> オブジェクト、.NET Framework Data Provider for ODBC には <xref:System.Data.Odbc.OdbcConnection> オブジェクト、.NET Framework Data Provider for Oracle には <xref:System.Data.OracleClient.OracleConnection> があります。  
+  
+## このセクションの内容  
+ [接続の確立](../../../../docs/framework/data/adonet/establishing-the-connection.md)  
+ **Connection** オブジェクトを使用して、データ ソースとの接続を確立する方法について説明します。  
+  
+ [接続イベント](../../../../docs/framework/data/adonet/connection-events.md)  
+ **InfoMessage** イベントを使用してデータ ソースから情報メッセージを取得する方法について説明します。  
+  
+## 参照  
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)   
+ [接続プール](../../../../docs/framework/data/adonet/connection-pooling.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-events.md b/docs/framework/data/adonet/connection-events.md
new file mode 100644
index 00000000000..a04fb9e4223
--- /dev/null
+++ b/docs/framework/data/adonet/connection-events.md
@@ -0,0 +1,117 @@
+---
+title: "接続イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a29de74-acfc-4134-8616-829dd7ce0710
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 接続イベント
+すべての .NET Framework データ プロバイダーには、データ ソースから情報メッセージを取得したり、**Connection** 状態の変化を確認したりするために使用できる 2 つのイベントを持った **Connection** オブジェクトがあります。  **Connection** オブジェクトのイベントを次の表に示します。  
+  
+|Event|説明|  
+|-----------|--------|  
+|**InfoMessage**|データ ソースから情報メッセージが返されたときに発生します。  情報メッセージはデータ ソースからのメッセージであり、例外はスローされません。|  
+|**StateChange**|**Connection** の状態が変化したときに発生します。|  
+  
+## InfoMessage イベントの使用  
+ <xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントを使用して、SQL Server データ ソースから警告や情報メッセージを取得できます。  重大度レベルが 11 から 16 のエラーがデータ ソースから返されると、例外がスローされます。  <xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントを使用して、エラーに関連付けられていないメッセージをデータ ソースから取得することもできます。  Microsoft SQL Server の場合は、重大度レベルが 10 以下のエラーは情報メッセージと見なされ、<xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントでキャプチャされます。  詳細については、SQL Server オンライン ブックの「エラー メッセージ重大度レベル」を参照してください。  
+  
+ <xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントは <xref:System.Data.SqlClient.SqlInfoMessageEventArgs> オブジェクトを受け取りますが、その **Errors** プロパティにはデータ ソースからのメッセージのコレクションが格納されています。  このコレクションの中の **Error** オブジェクトにエラー番号、メッセージ テキスト、およびエラーの原因を問い合わせることができます。  .NET Framework Data Provider for SQL Server には、データベースの詳細情報、ストアド プロシージャ、およびメッセージ送信元の行番号も含まれます。  
+  
+### 例  
+ <xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントのイベント ハンドラーを追加する方法を次のコード サンプルに示します。  
+  
+```vb  
+' Assumes that connection represents a SqlConnection object.  
+  AddHandler connection.InfoMessage, _  
+    New SqlInfoMessageEventHandler(AddressOf OnInfoMessage)  
+  
+Private Shared Sub OnInfoMessage(sender As Object, _  
+  args As SqlInfoMessageEventArgs)  
+  Dim err As SqlError  
+  For Each err In args.Errors  
+    Console.WriteLine("The {0} has received a severity {1}, _  
+       state {2} error number {3}\n" & _  
+      "on line {4} of procedure {5} on server {6}:\n{7}", _  
+      err.Source, err.Class, err.State, err.Number, err.LineNumber, _  
+    err.Procedure, err.Server, err.Message)  
+  Next  
+End Sub  
+  
+```  
+  
+```csharp  
+// Assumes that connection represents a SqlConnection object.  
+  connection.InfoMessage +=   
+    new SqlInfoMessageEventHandler(OnInfoMessage);  
+  
+protected static void OnInfoMessage(  
+  object sender, SqlInfoMessageEventArgs args)  
+{  
+  foreach (SqlError err in args.Errors)  
+  {  
+    Console.WriteLine(  
+  "The {0} has received a severity {1}, state {2} error number {3}\n" +  
+  "on line {4} of procedure {5} on server {6}:\n{7}",  
+   err.Source, err.Class, err.State, err.Number, err.LineNumber,   
+   err.Procedure, err.Server, err.Message);  
+  }  
+}  
+  
+```  
+  
+## InfoMessages としてのエラー処理  
+ <xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントは通常、サーバーが情報メッセージまたは警告メッセージを送信した場合に限り発生します。  ただし、実際にエラーが発生した場合は、サーバーの操作を開始した **ExecuteNonQuery** メソッドまたは **ExecuteReader** メソッドの実行は停止され、例外がスローされます。  
+  
+ サーバーでエラーが発生してもコマンド内の残りのステートメントの処理を続行する場合は、<xref:System.Data.SqlClient.SqlConnection> の <xref:System.Data.SqlClient.SqlConnection.FireInfoMessageEventOnUserErrors%2A> プロパティを `true` に設定します。  このように設定すると、エラーが発生したとき、接続は例外をスローして処理を中断する代わりに、<xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントを発生させます。  クライアント アプリケーションは、このイベントを処理し、エラーに応答できます。  
+  
+> [!NOTE]
+>  重大度レベルが 17 以上のエラーが発生すると、サーバーのコマンド処理が停止します。このエラーは、例外として処理する必要があります。  この場合、<xref:System.Data.SqlClient.SqlConnection.InfoMessage> イベントによるエラー処理の方法にかかわらず例外がスローされます。  
+  
+## StateChange イベントの使用  
+ **StateChange** イベントは、**Connection** の状態が変化したときに発生します。  **StateChange** イベントは **OriginalState** プロパティおよび **CurrentState** プロパティを使用して、**Connection** の状態の変化を判別できる <xref:System.Data.StateChangeEventArgs> を受け取ります。  **OriginalState** プロパティは、**Connection** の状態が変更される前の状態を示す <xref:System.Data.ConnectionState> 列挙体です。  **CurrentState** は、**Connection** の状態が変更された後の状態を示す <xref:System.Data.ConnectionState> 列挙体です。  
+  
+ **StateChange** イベントを使用して **Connection** の状態が変化したときにコンソールにメッセージを出力するコード サンプルを次に示します。  
+  
+```vb  
+' Assumes connection represents a SqlConnection object.  
+  AddHandler connection.StateChange, _  
+    New StateChangeEventHandler(AddressOf OnStateChange)  
+  
+Protected Shared Sub OnStateChange( _  
+  sender As Object, args As StateChangeEventArgs)  
+  
+  Console.WriteLine( _  
+  "The current Connection state has changed from {0} to {1}.", _  
+  args.OriginalState, args.CurrentState)  
+End Sub  
+  
+```  
+  
+```csharp  
+// Assumes connection represents a SqlConnection object.  
+  connection.StateChange  += new StateChangeEventHandler(OnStateChange);  
+  
+protected static void OnStateChange(object sender,   
+  StateChangeEventArgs args)  
+{  
+  Console.WriteLine(  
+    "The current Connection state has changed from {0} to {1}.",  
+      args.OriginalState, args.CurrentState);  
+}  
+```  
+  
+## 参照  
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-pooling.md b/docs/framework/data/adonet/connection-pooling.md
new file mode 100644
index 00000000000..c0f49b8cc29
--- /dev/null
+++ b/docs/framework/data/adonet/connection-pooling.md
@@ -0,0 +1,31 @@
+---
+title: "接続プール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 955c057f-aea8-4ba8-aa6d-e3dfa18ba8d5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 接続プール
+データ ソースへの接続は時間のかかる処理です。  接続を開くコストを最小化するために、ADO.NET は*接続プール*と呼ばれる最適化の手法を使用しています。接続プールを使用することで、接続を開いて閉じるという処理の繰り返しによって生じるコストを最小限に抑えることができます。  接続プールは、.NET Framework データ プロバイダーに応じて異なる処理が行われます。  
+  
+## このセクションの内容  
+ [SQL Server の接続プール \(ADO.NET\)](../../../../docs/framework/data/adonet/sql-server-connection-pooling.md)  
+ 接続プールの概要および [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] における接続プールの動作を説明します。  
+  
+ [OLE DB、ODBC、および Oracle 接続プール](../../../../docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md)  
+ .NET Framework Data Provider for OLE DB、.NET Framework Data Provider for ODBC、および .NET Framework Data Provider for Oracle の接続プールについて説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-string-builders.md b/docs/framework/data/adonet/connection-string-builders.md
new file mode 100644
index 00000000000..1ccb01b5d53
--- /dev/null
+++ b/docs/framework/data/adonet/connection-string-builders.md
@@ -0,0 +1,89 @@
+---
+title: "接続文字列ビルダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8434b608-c4d3-43d3-8ae3-6d8c6b726759
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 接続文字列ビルダー
+以前のバージョンの [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では、文字列値の連結によって構築された接続文字列がコンパイル時にはチェックされません。そのため、不適切なキーワードが使用された場合、実行時に <xref:System.ArgumentException> が発生します。  接続文字列のキーワードの構文は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のデータ プロバイダーごとに異なるため、有効な接続文字列を手動で作成するのが難しいという問題がありました。  この問題に対処するため、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] 2.0 では、各 [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダー用の新しい接続文字列ビルダーが導入されました。  各データ プロバイダーは、<xref:System.Data.Common.DbConnectionStringBuilder> を継承した、厳密に型指定された接続文字列ビルダー クラスを提供しています。  次の表は、各 [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーおよび対応する接続文字列ビルダー クラスの一覧です。  
+  
+|プロバイダー|ConnectionStringBuilder クラス|  
+|------------|---------------------------------|  
+|<xref:System.Data.SqlClient>|<xref:System.Data.SqlClient.SqlConnectionStringBuilder?displayProperty=fullName>|  
+|<xref:System.Data.OleDb>|<xref:System.Data.OleDb.OleDbConnectionStringBuilder?displayProperty=fullName>|  
+|<xref:System.Data.Odbc>|<xref:System.Data.Odbc.OdbcConnectionStringBuilder?displayProperty=fullName>|  
+|<xref:System.Data.OracleClient>|<xref:System.Data.OracleClient.OracleConnectionStringBuilder?displayProperty=fullName>|  
+  
+## 接続文字列のインジェクション攻撃  
+ ユーザー入力から文字列を動的に連結することによって接続文字列を構築している場合、接続文字列のインジェクション攻撃を受ける可能性があります。  文字列の検証や悪意のある文字のエスケープを怠ると、機密データなど、サーバー上のリソースへのアクセスを攻撃者に許してしまうことも考えられます。  たとえば、セミコロンに続けて値を追加するだけでも攻撃が成立します。  接続文字列は "後勝ち" のアルゴリズムで解析されるため、悪質な入力データによって本来の値が置き換えられます。  
+  
+ 接続文字列ビルダー クラスは推測に頼った作業を排除し、構文エラーやセキュリティ上の脆弱性を防ぐことを目的に設計されています。  このクラスには、各データ プロバイダーによってサポートされた既知のキーと値のペアに対応するプロパティおよびメソッドが存在します。  それぞれのクラスは、あらかじめ決められた一連のシノニムを管理しており、特定のシノニムを対応する既知のキー名に変換することができます。  有効なキーと値のペアに対してチェックが実行され、無効なペアが見つかると例外がスローされます。  また、挿入された値は安全な方法で処理されます。  
+  
+ 次の例を実行すると、`Initial Catalog` の設定に対して挿入された余分な値が、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> によってどのように処理されるかを確認できます。  
+  
+```vb  
+Dim builder As New System.Data.SqlClient.SqlConnectionStringBuilder  
+builder("Data Source") = "(local)"  
+builder("Integrated Security") = True  
+builder("Initial Catalog") = "AdventureWorks;NewValue=Bad"  
+Console.WriteLine(builder.ConnectionString)  
+```  
+  
+```csharp  
+System.Data.SqlClient.SqlConnectionStringBuilder builder =  
+  new System.Data.SqlClient.SqlConnectionStringBuilder();  
+builder["Data Source"] = "(local)";  
+builder["integrated Security"] = true;  
+builder["Initial Catalog"] = "AdventureWorks;NewValue=Bad";  
+Console.WriteLine(builder.ConnectionString);  
+```  
+  
+ 出力結果を見ると、挿入された値が <xref:System.Data.SqlClient.SqlConnectionStringBuilder> によって適切に処理されていることがわかります。二重引用符内の余分な値は、新しいキーと値のペアとして接続文字列に追加されるのではなくエスケープされています。  
+  
+```  
+data source=(local);Integrated Security=True;  
+initial catalog="AdventureWorks;NewValue=Bad"  
+```  
+  
+## 構成ファイルからの接続文字列の作成  
+ 接続文字列の特定の要素があらかじめわかっている場合、接続文字列を構成ファイルに格納しておき、それを実行時に取得することによって完全な接続文字列を作成できます。  たとえば、サーバー名は不明でも、データベースの名前はあらかじめ把握できる場合があります。  または、ユーザーに名前とパスワードだけを実行時に指定してもらい、それ以外の値を接続文字列に挿入できないようにしたい場合もあります。  
+  
+ 接続文字列ビルダーには、<xref:System.String> を引数として受け取るオーバーロード コンストラクターがあります。この引数に対して接続文字列を部分的に指定しておき、それ以外の部分をユーザー入力で補完することも可能です。  部分的な接続文字列は構成ファイルに保存し、実行時に取得できます。  
+  
+> [!NOTE]
+>  構成ファイルへのプログラム アクセスは <xref:System.Configuration> 名前空間によって実現できます。Web アプリケーションの場合は <xref:System.Web.Configuration.WebConfigurationManager> を、Windows アプリケーションの場合は <xref:System.Configuration.ConfigurationManager> を使用します。  接続文字列および構成ファイルを使った作業の詳細については、「[接続文字列と構成ファイル](../../../../docs/framework/data/adonet/connection-strings-and-configuration-files.md)」を参照してください。  
+  
+### 例  
+ この例では、接続文字列の一部を構成ファイルから取得し、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> の <xref:System.Data.SqlClient.SqlConnectionStringBuilder.DataSource%2A> プロパティ、<xref:System.Data.SqlClient.SqlConnectionStringBuilder.UserID%2A> プロパティ、および <xref:System.Data.SqlClient.SqlConnectionStringBuilder.Password%2A> プロパティを設定することによって接続文字列全体を作成します。  構成ファイルは次のように定義されています。  
+  
+```  
+<connectionStrings>  
+  <clear/>  
+  <add name="partialConnectString"   
+    connectionString="Initial Catalog=Northwind;"  
+    providerName="System.Data.SqlClient" />  
+</connectionStrings>  
+```  
+  
+> [!NOTE]
+>  このコードを実行するには、プロジェクトで `System.Configuration.dll` を参照設定する必要があります。  
+  
+ [!code-csharp[DataWorks SqlConnectionStringBuilder.UserNamePwd#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlConnectionStringBuilder.UserNamePwd/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlConnectionStringBuilder.UserNamePwd#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlConnectionStringBuilder.UserNamePwd/VB/source.vb#1)]  
+  
+## 参照  
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)   
+ [プライバシーとデータ セキュリティ](../../../../docs/framework/data/adonet/privacy-and-data-security.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-string-syntax.md b/docs/framework/data/adonet/connection-string-syntax.md
new file mode 100644
index 00000000000..37522f647d0
--- /dev/null
+++ b/docs/framework/data/adonet/connection-string-syntax.md
@@ -0,0 +1,203 @@
+---
+title: "接続文字列の構文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0977aeee-04d1-4cce-bbed-750c77fce06e
+caps.latest.revision: 11
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 11
+---
+# 接続文字列の構文
+すべての .NET Framework データ プロバイダーは、<xref:System.Data.Common.DbConnection> を継承する `Connection` オブジェクトに加え、プロバイダー固有の <xref:System.Data.Common.DbConnection.ConnectionString%2A> プロパティを持ちます。  それぞれのプロバイダーに固有の接続文字列の構文は、対応する `ConnectionString` プロパティのトピックで説明されています。  次の表は、.NET Framework に含まれている 4 つのデータ プロバイダーを一覧にしたものです。  
+  
+|.NET Framework データ プロバイダー|説明|  
+|-------------------------------|--------|  
+|<xref:System.Data.SqlClient>|Microsoft SQL Server へのデータ アクセスを提供します。  接続文字列の構文の詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」を参照してください。|  
+|<xref:System.Data.OleDb>|OLE DB を使って公開されたデータ ソースへのデータ アクセスを提供します。  接続文字列の構文の詳細については、「<xref:System.Data.OleDb.OleDbConnection.ConnectionString%2A>」を参照してください。|  
+|<xref:System.Data.Odbc>|ODBC を使って公開されたデータ ソースへのデータ アクセスを提供します。  接続文字列の構文の詳細については、「<xref:System.Data.Odbc.OdbcConnection.ConnectionString%2A>」を参照してください。|  
+|<xref:System.Data.OracleClient>|Oracle バージョン 8.1.7 以降へのデータ アクセスを提供します。  接続文字列の構文の詳細については、「<xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A>」を参照してください。|  
+  
+## 接続文字列ビルダー  
+ ADO.NET 2.0 では、.NET Framework データ プロバイダー用の次の接続文字列ビルダーが導入されました。  
+  
+-   <xref:System.Data.SqlClient.SqlConnectionStringBuilder>  
+  
+-   <xref:System.Data.OleDb.OleDbConnectionStringBuilder>  
+  
+-   <xref:System.Data.Odbc.OdbcConnectionStringBuilder>  
+  
+-   <xref:System.Data.OracleClient.OracleConnectionStringBuilder>  
+  
+ 接続文字列ビルダーを使用すると、構文的に正しい接続文字列を実行時に構築できるため、コード内で接続文字列値を手動で連結する必要はありません。  詳細については、「[接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+## Windows 認証  
+ データ ソースがサポートしている場合は、Windows 認証 \(*統合セキュリティ*\) を使用して接続することをお勧めします。  接続文字列の構文は、プロバイダーによって異なります。  .NET Framework データ プロバイダーで使用されている Windows 認証の構文を次の表に示します。  
+  
+|プロバイダー|構文|  
+|------------|--------|  
+|`SqlClient`|`Integrated Security=true;`<br /><br /> `-- or --`<br /><br /> `Integrated Security=SSPI;`|  
+|`OleDb`|`Integrated Security=SSPI;`|  
+|`Odbc`|`Trusted_Connection=yes;`|  
+|`OracleClient`|`Integrated Security=yes;`|  
+  
+> [!NOTE]
+>  `OleDb` プロバイダーで `Integrated Security=true` に設定すると例外がスローされます。  
+  
+## SqlClient 接続文字列  
+ <xref:System.Data.SqlClient.SqlConnection> 接続文字列の構文については、<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A?displayProperty=fullName> プロパティで説明されています。  <xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> プロパティを使用すると、SQL Server データベースの接続文字列を取得または設定することができます。  以前のバージョンの SQL Server に接続する必要がある場合は、.NET Framework Data Provider for OleDb \(<xref:System.Data.OleDb>\) を使用する必要があります。  接続文字列のほとんどのキーワードは、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> のプロパティにマップされています。  
+  
+ 次の構文のフォームはそれぞれ、Windows 認証を使用してローカル サーバー上の **AdventureWorks** データベースに接続します。  
+  
+```  
+"Persist Security Info=False;Integrated Security=true;  
+    Initial Catalog=AdventureWorks;Server=MSSQL1"  
+"Persist Security Info=False;Integrated Security=SSPI;  
+    database=AdventureWorks;server=(local)"  
+"Persist Security Info=False;Trusted_Connection=True;  
+    database=AdventureWorks;server=(local)"  
+```  
+  
+### SQL Server ログイン  
+ SQL Server への接続には Windows 認証の使用をお勧めします。  ただし、どうしても SQL Server 認証を使用する必要がある場合は、次の構文に従ってユーザー名とパスワードを指定してください。  この例では、アスタリスクを使用して有効なユーザー名とパスワードを表しています。  
+  
+```  
+"Persist Security Info=False;User ID=*****;Password=*****;Initial Catalog=AdventureWorks;Server=MySqlServer"  
+```  
+  
+> [!IMPORTANT]
+>  `Persist`  ``  `Security Info` キーワードの既定の設定は `false` です。  このキーワードを `true` または `yes` に設定すると、ユーザー ID やパスワードなどのセキュリティ関連情報を、接続を開いた後にその接続から取得できます。  機密を要する接続文字列情報が、信頼できないソースによってアクセスされることのないよう、`Persist` `` `Security Info` は必ず `false` にしてください。  
+  
+ SQL Server の名前付きインスタンスに接続するには、*server name\\instance name* 構文を使用します。  
+  
+```  
+Data Source=MySqlServer\MSSQL1;"  
+```  
+  
+ 接続文字列の作成時に、`SqlConnectionStringBuilder` の <xref:System.Data.SqlClient.SqlConnectionStringBuilder.DataSource%2A> プロパティをインスタンス名に設定することもできます。  <xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.DataSource%2A> プロパティは読み取り専用です。  
+  
+> [!NOTE]
+>  Windows 認証は SQL Server ログインよりも優先されます。  Integrated Security を true に指定し、ユーザー名とパスワードも指定した場合、ユーザー名とパスワードは無視され、Windows 認証が使用されます。  
+  
+### Type System Version の変更  
+ <xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A?displayProperty=fullName> の `Type System Version` キーワードは、クライアント側での [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] 型の表現を指定します。  `Type System Version` キーワードの詳細については、<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A?displayProperty=fullName> のトピックを参照してください。  
+  
+## SQL Server Express ユーザー インスタンスへの接続とアタッチ  
+ ユーザー インスタンスは、SQL Server Express の機能の 1 つです。  最小限の特権しか持たないローカル Windows アカウントで実行しているユーザーが、SQL Server データベースにアタッチできます。この場合、管理特権は不要です。  ユーザー インスタンスは、サービスとしてではなく、ユーザーの Windows 資格情報で実行されます。  
+  
+ ユーザー インスタンスの使用の詳細については、「[SQL Server Express ユーザー インスタンス](../../../../docs/framework/data/adonet/sql/sql-server-express-user-instances.md)」を参照してください。  
+  
+## TrustServerCertificate の使用  
+ `TrustServerCertificate` キーワードは、有効な証明書を使用して [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] インスタンスに接続する場合にのみ使用できます。  `TrustServerCertificate` を `true` に設定した場合、トランスポート層に SSL が使用されてチャネルが暗号化されます。また、証明書チェーンをたどることによる信頼性の検証は省略されます。  
+  
+```  
+"TrustServerCertificate=true;"   
+```  
+  
+> [!NOTE]
+>  `TrustServerCertificate` を `true` に設定して暗号化を有効にした場合、接続文字列で `Encrypt` を `false` に設定したとしても、サーバーで指定された暗号化レベルが使用されます。  それ以外の場合、接続は失敗します。  
+  
+### 暗号化の有効化  
+ サーバー証明書がプロビジョニングされていない場合、暗号化を有効にするには、SQL Server 構成マネージャーで **\[プロトコルの暗号化を設定する\]** オプションと **\[サーバー証明書を信頼する\]** オプションを設定する必要があります。  このように、検証可能なサーバー証明書がプロビジョニングされていない場合、暗号化には検証を伴わない自己署名入りのサーバー証明書が使用されます。  
+  
+ SQL Server で構成されたセキュリティのレベルを、アプリケーションの設定によって緩和することはできません。ただし、必要に応じて厳密にすることはできます。  アプリケーションから暗号化を要求するには、`TrustServerCertificate` キーワードおよび `Encrypt` キーワードを `true` に設定します。こうすることで、サーバー証明書がプロビジョニングされておらず、なおかつ、クライアントで **\[プロトコルの暗号化を設定する\]** が構成されていない場合でも常に暗号化が行われます。  ただし、クライアントの構成で `TrustServerCertificate` を有効にしなかった場合は、プロビジョニングされたサーバー証明書が必要です。  
+  
+ 次の表ですべてのケースを説明します。  
+  
+|\[プロトコルの暗号化を設定する\] クライアント設定|\[サーバー証明書を信頼する\] クライアント設定|Encrypt\/Use Encryption for Data 接続文字列\/属性|Trust Server Certificate 接続文字列\/属性|結果|  
+|---------------------------------|-------------------------------|------------------------------------------------|----------------------------------------|--------|  
+|Ｘ|N\/A|無効 \(既定値\)|無視|暗号化は行われません。|  
+|Ｘ|N\/A|はい|無効 \(既定値\)|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+|Ｘ|N\/A|はい|はい|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+|はい|Ｘ|無視|無視|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+|はい|はい|無効 \(既定値\)|無視|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+|はい|はい|はい|無効 \(既定値\)|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+|はい|はい|はい|はい|暗号化は、検証可能なサーバー証明書が提供されている場合にのみ行われます。それ以外の場合は、接続試行が失敗します。|  
+  
+ 詳細については、SQL Server オンライン ブックの「[検証を伴わない暗号化の使用](http://go.microsoft.com/fwlink/?LinkId=120500)」を参照してください。  
+  
+## OleDb 接続文字列  
+ <xref:System.Data.OleDb.OleDbConnection> の <xref:System.Data.OleDb.OleDbConnection.ConnectionString%2A> プロパティを使用すると、Microsoft Access などの OLE DB データ ソースの接続文字列を取得または設定することができます。  <xref:System.Data.OleDb.OleDbConnectionStringBuilder> クラスを使用して、実行時に `OleDb` 接続文字列を作成することもできます。  
+  
+### OleDb 接続文字列の構文  
+ <xref:System.Data.OleDb.OleDbConnection> 接続文字列では、プロバイダー名を指定する必要があります。  次の接続文字列は、Jet プロバイダーを使用して Microsoft Access データベースに接続します。  `UserID` および `Password` キーワードは、データベースがセキュリティ保護されていない場合は省略できます \(既定\)。  
+  
+```  
+Provider=Microsoft.Jet.OLEDB.4.0; Data Source=d:\Northwind.mdb;User ID=Admin;Password=;   
+```  
+  
+ ユーザー レベルのセキュリティを使用して Jet データベースがセキュリティ保護されている場合は、ワークグループ情報ファイル \(.mdw\) の場所を指定する必要があります。  ワークグループ情報ファイルを使用して接続文字列に表示された資格情報を検証します。  
+  
+```  
+Provider=Microsoft.Jet.OLEDB.4.0;Data Source=d:\Northwind.mdb;Jet OLEDB:System Database=d:\NorthwindSystem.mdw;User ID=*****;Password=*****;  
+```  
+  
+> [!IMPORTANT]
+>  **OleDbConnection** の接続情報は、UDL \(Universal Data Link\) ファイルを使用して提供できますが、このファイルは使用しないでください。  UDL ファイルは暗号化されないため、接続文字列をテキスト形式で表現してしまいます。  UDL ファイルは、アプリケーションにとって外部ファイルをベースにしたリソースであるため、.NET Framework でセキュリティ保護できません。  **SqlClient** では UDL ファイルはサポートされていません。  
+  
+### DataDirectory を使用した Access\/Jet との接続  
+ `DataDirectory` の使用は `SqlClient` に限定されません。  <xref:System.Data.OleDb> および <xref:System.Data.Odbc> .NET データ プロバイダーでも使用できます。  アプリケーションの app\_data フォルダーに格納された Northwind.mdb に接続するための <xref:System.Data.OleDb.OleDbConnection> 文字列の構文を次の例に示します。  この場所には、システム データベース \(System.mdw\) も格納されています。  
+  
+```  
+"Provider=Microsoft.Jet.OLEDB.4.0;  
+Data Source=|DataDirectory|\Northwind.mdb;  
+Jet OLEDB:System Database=|DataDirectory|\System.mdw;"  
+```  
+  
+> [!IMPORTANT]
+>  Access\/Jet データベースをセキュリティで保護しない場合は、接続文字列にシステム データベースの場所を指定する必要はありません。  既定では、セキュリティが無効になります。すべてのユーザーが、空のパスワードで組み込みの Admin ユーザーとして接続することになります。  ユーザー レベルのセキュリティを正しく実装したとしても、Jet データベースは攻撃に対して無防備です。  ファイル ベースのセキュリティでは克服できない限界があるため、Access\/Jet データベースに機密情報を格納することはお勧めできません。  
+  
+### Excel への接続  
+ Excel ワークブックへの接続には、Microsoft Jet プロバイダーが使用されます。  次の接続文字列では、`Extended Properties` キーワードは Excel に固有のプロパティを設定しています。"  HDR\=Yes;" は、最初の列にデータではなく、行の名前が含まれていることを示し、"IMEX\=1;" は、「intermixed」データ行を常にテキストとして読み取ることをドライバーに指示しています。  
+  
+```  
+Provider=Microsoft.Jet.OLEDB.4.0;Data Source=D:\MyExcel.xls;Extended Properties=""Excel 8.0;HDR=Yes;IMEX=1""  
+```  
+  
+ `Extended Properties` を二重引用符で囲む必要があることに注意してください。  
+  
+### Data Shape プロバイダーの接続文字列の構文  
+ Microsoft Data Shape プロバイダーを使用するときは、`Provider` および `Data Provider` キーワードを両方使用してください。  Shape プロバイダーを使用して SQL Server のローカル インスタンスに接続する例を次に示します。  
+  
+```  
+"Provider=MSDataShape;Data Provider=SQLOLEDB;Data Source=(local);Initial Catalog=pubs;Integrated Security=SSPI;"   
+```  
+  
+## Odbc 接続文字列  
+ <xref:System.Data.Odbc.OdbcConnection> の <xref:System.Data.Odbc.OdbcConnection.ConnectionString%2A> プロパティを使用すると、OLE DB データベースで接続文字列を取得または設定することができます。  <xref:System.Data.Odbc.OdbcConnectionStringBuilder> は、Odbc の接続文字列もサポートしています。  
+  
+ 次の接続文字列では、Microsoft Text Driver を使用しています。  
+  
+```  
+Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=d:\bin  
+```  
+  
+### DataDirectory を使用した Visual FoxPro との接続  
+ 次の <xref:System.Data.Odbc.OdbcConnection> 接続文字列は、`DataDirectory` を使用して Microsoft Visual FoxPro ファイルに接続する例を示しています。  
+  
+```  
+"Driver={Microsoft Visual FoxPro Driver};  
+SourceDB=|DataDirectory|\MyData.DBC;SourceType=DBC;"  
+```  
+  
+## Oracle 接続文字列  
+ <xref:System.Data.OracleClient.OracleConnection> の <xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A> プロパティを使用すると、OLE DB データベースで接続文字列を取得または設定することができます。  <xref:System.Data.OracleClient.OracleConnectionStringBuilder> は、Oracle の接続文字列もサポートしています。  
+  
+```  
+Data Source=Oracle9i;User ID=*****;Password=*****;  
+```  
+  
+ ODBC 接続文字列の構文の詳細については、「<xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A>」を参照してください。  
+  
+## 参照  
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)   
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-strings-and-configuration-files.md b/docs/framework/data/adonet/connection-strings-and-configuration-files.md
new file mode 100644
index 00000000000..1b5e6865915
--- /dev/null
+++ b/docs/framework/data/adonet/connection-strings-and-configuration-files.md
@@ -0,0 +1,182 @@
+---
+title: "接続文字列と構成ファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37df2641-661e-407a-a3fb-7bf9540f01e8
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 接続文字列と構成ファイル
+接続文字列をアプリケーションのコードに組み込むと、セキュリティ上の脆弱性やメンテナンスの問題を引き起こす可能性があります。  アプリケーションのソース コード内にコンパイルされた暗号化されていない接続文字列は、[Ildasm.exe \(IL 逆アセンブラー\)](../../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用して参照することができます。  さらに、接続文字列が変わるたびにアプリケーションを再コンパイルする必要性が生じます。  そのため、接続文字列はアプリケーション構成ファイルに保存することをお勧めします。  
+  
+## アプリケーション構成ファイルの使用  
+ アプリケーション構成ファイルには、特定のアプリケーションに固有の設定が格納されます。  たとえば、ASP.NET アプリケーションには少なくとも 1 つの **web.config** ファイルが存在するほか、Windows アプリケーションにも必要に応じて **app.config** ファイルを割り当てることができます。  構成ファイルの名前と場所はアプリケーションのホストによって異なりますが、どの構成ファイルにも共通の要素があります。  
+  
+### connectionStrings セクション  
+ 接続文字列は、アプリケーション構成ファイルの **configuration** 要素の **connectionStrings** セクションにキーと値のペアとして格納できます。  子要素には、**add**、**clear**、および **remove** が存在します。  
+  
+ 次の構成ファイル フラグメントは、接続文字列を格納するためのスキーマと構文の例を示しています。  **name** 属性は、実行時に取得する接続文字列を一意に識別するための名前です。  **providerName** は、machine.config ファイルに登録された .NET Framework データ プロバイダーの不変名です。  
+  
+```  
+<?xml version='1.0' encoding='utf-8'?>  
+  <configuration>  
+    <connectionStrings>  
+      <clear />  
+      <add name="Name"   
+       providerName="System.Data.ProviderName"   
+       connectionString="Valid Connection String;" />  
+    </connectionStrings>  
+  </configuration>  
+```  
+  
+> [!NOTE]
+>  構成ファイルに接続文字列の一部を保存しておき、<xref:System.Data.Common.DbConnectionStringBuilder> クラスを使用して実行時に補完できます。  接続文字列の要素を事前に知ることができない場合や、機密情報を構成ファイルに保存したくない場合には有効な手段です。  詳細については、「[接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+### 外部構成ファイルの使用  
+ 外部構成ファイルとは、単一のセクションから成る、構成ファイルのフラグメントを含んだ独立したファイルを言います。  外部構成ファイルは、メインの構成ファイルによって参照されます。  **connectionStrings** セクションを物理的に分かれたファイルに保存できるため、アプリケーションの配置後に接続文字列を編集する場合に有効な手段です。  たとえば、構成ファイルに修正が加えられた場合、ASP.NET の標準的な動作ではアプリケーション ドメインが再起動され、その結果、状態情報が失われてしまいます。  しかし、外部構成ファイルに対する修正であればアプリケーションの再起動は伴いません。  外部構成ファイルは ASP.NET だけでなく、Windows アプリケーションでも使用できます。  また、ファイルのアクセス セキュリティや権限を使用して、外部構成ファイルへのアクセスを制限することもできます。  実行時における外部構成ファイルの使用は透過的であり、特殊なコーディングも不要です。  
+  
+ 外部構成ファイルに接続文字列を保存するには、**connectionStrings** セクションだけを含んだファイルを別途作成します。  それ以外の要素、セクション、または属性は含めないでください。  外部構成ファイルの構文の例を次に示します。  
+  
+```  
+<connectionStrings>  
+  <add name="Name"   
+   providerName="System.Data.ProviderName"   
+   connectionString="Valid Connection String;" />  
+</connectionStrings>  
+```  
+  
+ 外部ファイルの完全修飾名および場所は、メインのアプリケーション構成ファイルの **configSource** 属性で指定します。  この例では、`connections.config` という名前の外部構成ファイルを参照しています。  
+  
+```  
+<?xml version='1.0' encoding='utf-8'?>  
+<configuration>  
+    <connectionStrings configSource="connections.config"/>  
+</configuration>  
+```  
+  
+## 接続文字列の実行時の取得  
+ .NET Framework 2.0 では、<xref:System.Configuration> 名前空間に新しいクラスが導入され、実行時に簡単に構成ファイルから接続文字列を取得できるようになりました。  プログラムから名前またはプロバイダー名を使用して接続文字列を取得できます。  
+  
+> [!NOTE]
+>  **connectionStrings** セクションは、**machine.config** ファイルにも存在します。このセクションには、Visual Studio によって使用される接続文字列が格納されます。  Windows アプリケーションの **app.config** ファイルからプロバイダー名で接続文字列を取得した場合、まず **machine.config** 内の接続文字列が読み込まれ、その後、**app.config** のエントリが読み込まれます。  **connectionStrings** 要素の直後に **clear** を追加すると、継承されたすべての参照がメモリ内のデータ構造から削除され、ローカルの **app.config** ファイルに定義されている接続文字列だけが考慮されます。  
+  
+### 構成クラスの使用  
+ .NET Framework 2.0 以降では、ローカル コンピューター上の構成ファイルで作業するときに、廃止された <xref:System.Configuration.ConfigurationSettings> に代わって <xref:System.Configuration.ConfigurationManager> を使用します。  ASP.NET 構成ファイルでの作業では、<xref:System.Web.Configuration.WebConfigurationManager> を使用します。  Web サーバー上の構成ファイルを扱うことを目的に設計され、**system.web** など、構成ファイルのセクションにプログラムからアクセスできます。  
+  
+> [!NOTE]
+>  実行時に構成ファイルにアクセスするには、呼び出し元に権限を付与する必要があります。必要な権限は、アプリケーションの種類、構成ファイル、格納場所などによって異なります。  詳細については、「[Using the Configuration Classes](../Topic/Using%20the%20Configuration%20Classes.md)」と「<xref:System.Web.Configuration.WebConfigurationManager>」\(ASP.NET アプリケーションの場合\)、および「<xref:System.Configuration.ConfigurationManager>」\(Windows アプリケーションの場合\) を参照してください。  
+  
+ <xref:System.Configuration.ConnectionStringSettingsCollection> を使用すると、アプリケーション構成ファイルから接続文字列を取得できます。  このコレクションには、それぞれが **connectionStrings** セクションの単一のエントリを表す一連の <xref:System.Configuration.ConnectionStringSettings> オブジェクトが格納されます。  個々のプロパティは接続文字列の属性にマップされており、名前またはプロバイダー名を指定することによって接続文字列を取得できます。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Configuration.ConnectionStringSettings.Name%2A>|接続文字列の名前。  **name** 属性にマップされています。|  
+|<xref:System.Configuration.ConnectionStringSettings.ProviderName%2A>|プロバイダーの完全修飾名。  **providerName** 属性にマップされています。|  
+|<xref:System.Configuration.ConnectionStringSettings.ConnectionString%2A>|接続文字列。  **connectionString** 属性にマップされています。|  
+  
+### 例 : すべての接続文字列を一覧表示する  
+ この例では、`ConnectionStringSettings` コレクションを反復処理しながら、<xref:System.Configuration.ConnectionStringSettings.Name%2A>、<xref:System.Configuration.ConnectionStringSettings.ProviderName%2A>、<xref:System.Configuration.ConnectionStringSettings.ConnectionString%2A> の各プロパティをコンソール ウィンドウに表示します。  
+  
+> [!NOTE]
+>  プロジェクトの種類によっては System.Configuration.dll がインクルードされていない場合があります。構成クラスを使用する場合は、必要に応じて参照設定するようにしてください。  特定のアプリケーションの構成ファイルの名前と場所は、アプリケーションの種類やホストしているプロセスによって異なります。  
+  
+ [!code-csharp[DataWorks ConnectionStringSettings.RetrieveFromConfig#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfig/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStringSettings.RetrieveFromConfig#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfig/VB/source.vb#1)]  
+  
+### 例 : 接続文字列を名前で取得する  
+ 次の例では、接続文字列の名前を指定することによって、接続文字列を構成ファイルから取得する方法を説明します。  このコードでは、指定された入力パラメーターと <xref:System.Configuration.ConfigurationManager.ConnectionStrings%2A> の名前とを照合することによって、<xref:System.Configuration.ConnectionStringSettings> オブジェクトを作成します。  一致する名前が見つからなかった場合は `null` \(Visual Basic の場合は `Nothing`\) が返されます。  
+  
+ [!code-csharp[DataWorks ConnectionStringSettings.RetrieveFromConfigByName#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByName/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStringSettings.RetrieveFromConfigByName#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByName/VB/source.vb#1)]  
+  
+### 例 : 接続文字列をプロバイダー名で取得する  
+ 次の例では、プロバイダーの不変名を *System.Data.ProviderName* の形式で指定することによって接続文字列を取得する方法を説明します。  このコードでは、<xref:System.Configuration.ConnectionStringSettingsCollection> を反復処理し、最初に見つかった <xref:System.Configuration.ConnectionStringSettings.ProviderName%2A> の接続文字列を返します。  プロバイダー名が見つからなかった場合は `null` \(Visual Basic の場合は `Nothing`\) が返されます。  
+  
+ [!code-csharp[DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider/VB/source.vb#1)]  
+  
+## 保護構成を使った構成ファイル セクションの暗号化  
+ ASP.NET 2.0 では、*保護構成*と呼ばれる、構成ファイルの機密情報を暗号化するための新しい機能が導入されました。  保護構成は、主に ASP.NET を想定して設計されたものですが、Windows アプリケーションの構成ファイル セクションを暗号化する目的でも使用できます。  保護構成機能の詳細については、「[Encrypting Configuration Information Using Protected Configuration](../Topic/Encrypting%20Configuration%20Information%20Using%20Protected%20Configuration.md)」を参照してください。  
+  
+ 次の構成ファイル フラグメントは、暗号化後の **connectionStrings** セクションを示しています。  **configProtectionProvider** には、接続文字列の暗号化と復号化に使用される、保護構成プロバイダーが指定されています。  **EncryptedData** セクションには暗号文が格納されています。  
+  
+```  
+<connectionStrings configProtectionProvider="DataProtectionConfigurationProvider">  
+  <EncryptedData>  
+    <CipherData>  
+      <CipherValue>AQAAANCMnd8BFdERjHoAwE/Cl+sBAAAAH2... </CipherValue>  
+    </CipherData>  
+  </EncryptedData>  
+</connectionStrings>  
+```  
+  
+ 暗号化された接続文字列は実行時に取得されることになります。このとき、.NET Framework は、指定されたプロバイダーを使用して **CipherValue** を復号化し、アプリケーションに利用可能な接続文字列を提供します。  復号化のプロセスを管理するためのコードを自分で作成する必要はありません。  
+  
+### 保護構成プロバイダー  
+ 保護構成プロバイダーは、ローカル コンピューターの **machine.config** ファイルの **configProtectedData** セクションに登録されます。次のフラグメントを見ると、.NET Framework が備えている 2 つの保護構成プロバイダーが指定されていることがわかります。  ここでは、読みやすくするために一部の値を省略しています。  
+  
+```  
+<configProtectedData defaultProvider="RsaProtectedConfigurationProvider">  
+  <providers>  
+    <add name="RsaProtectedConfigurationProvider"   
+      type="System.Configuration.RsaProtectedConfigurationProvider, ... />  
+    <add name="DataProtectionConfigurationProvider"   
+      type="System.Configuration.DpapiProtectedConfigurationProvider, ... />  
+  </providers>  
+</configProtectedData>  
+```  
+  
+ 別の保護構成プロバイダーが必要な場合は、それを **machine.config** ファイルに追加することによって構成できます。  また、<xref:System.Configuration.ProtectedConfigurationProvider> 抽象基本クラスを継承することで、保護構成プロバイダーを独自に作成することもできます。  次の表は、.NET Framework に含まれている 2 つの構成プロバイダーを示しています。  
+  
+|プロバイダー|説明|  
+|------------|--------|  
+|<xref:System.Configuration.RSAProtectedConfigurationProvider>|データの暗号化と復号化には、RSA 暗号化アルゴリズムが使用されます。  RSA アルゴリズムは、公開キー暗号化だけでなく、デジタル署名にも使用されます。  "公開キー" として知られているほか、2 つの異なるキーが使用されることから非対称暗号化と呼ばれる場合もあります。  [ASP.NET IIS Registration Tool \(Aspnet\_regiis.exe\)](../Topic/ASP.NET%20IIS%20Registration%20Tool%20\(Aspnet_regiis.exe\).md) を使用すると、Web.config ファイルのセクションを暗号化したり、暗号化キーを管理したりすることができます。  構成ファイルは、その処理時に ASP.NET によって復号化されます。  ASP.NET アプリケーションの ID には、セクションの暗号化と復号化に使用される暗号化キーへの読み取りアクセスが必要です。|  
+|<xref:System.Configuration.DPAPIProtectedConfigurationProvider>|構成セクションの暗号化に Windows Data Protection API \(DPAPI\) が使用されます。  この API には、Windows の組み込み暗号化サービスが使用され、コンピューター単位またはユーザー アカウント単位の保護を構成できます。  コンピューター単位の保護は、同じサーバー上の複数のアプリケーションで情報を共有する必要がある場合に使用します。  共有ホスティング環境など、特定のユーザー ID で実行されるサービスには、ユーザー アカウント単位の保護を使用できます。  各アプリケーションは、ファイルやデータベースなど、各種リソースへのアクセスが制限された別々の ID で実行されます。|  
+  
+ どちらのプロバイダーも、強力なデータ暗号化機能を備えています。  ただし、Web ファームなど、複数のサーバーで、同じ構成ファイルを暗号化して使用する場合、データの暗号化に使用される暗号化キーをエクスポートしたり、それを別のサーバーにインポートしたりできるのは、`RsaProtectedConfigurationProvider` だけです。  詳細については、「[Importing and Exporting Protected Configuration RSA Key Containers](../Topic/Importing%20and%20Exporting%20Protected%20Configuration%20RSA%20Key%20Containers.md)」を参照してください。  
+  
+### 構成クラスの使用  
+ <xref:System.Configuration> 名前空間には、構成設定をプログラムから行うためのクラスが存在します。  <xref:System.Configuration.ConfigurationManager> クラスは、コンピューター、アプリケーション、ユーザーの各構成ファイルへのアクセスを提供します。  ASP.NET アプリケーションを作成している場合は、同じ機能を持った <xref:System.Web.Configuration.WebConfigurationManager> クラスを使用します。他にも **\<system.web\>** の設定など、ASP.NET アプリケーション固有の設定にもアクセスできます。  
+  
+> [!NOTE]
+>  <xref:System.Security.Cryptography> 名前空間には、データの暗号化と復号化に関連した補足的なオプションを提供するクラスが存在します。  これらのクラスは、保護構成では利用できない暗号化サービスが必要な場合に使用します。  これらのクラスは必ずしも純粋なマネージ実装とは限らず、アンマネージ Microsoft CryptoAPI 用のラッパーもあります。  詳細については、「[Cryptographic Services](http://msdn.microsoft.com/ja-jp/68a1e844-c63c-44af-9247-f6716eb23781)」を参照してください。  
+  
+### App.config の例  
+ ここでは、Windows アプリケーションの **app.config** ファイルにある **connectionStrings** セクションを条件に応じて暗号化したり復号化したりする方法を紹介します。  この例に示したプロシージャは、MyApplication.exe など、アプリケーションの名前を引数として受け取ります。  その後、**app.config** ファイルを暗号化して、その実行可能ファイルと同じフォルダーに MyApplication.exe.config という名前でコピーします。  
+  
+> [!NOTE]
+>  接続文字列は暗号化したときと同じコンピューターでしか復号化できません。  
+  
+ このコードは、<xref:System.Configuration.ConfigurationManager.OpenExeConfiguration%2A> メソッドを使用して **app.config** ファイルを編集モードで開き、<xref:System.Configuration.ConfigurationManager.GetSection%2A> メソッドを使用して **connectionStrings** セクションを返します。  さらに、<xref:System.Configuration.SectionInformation.IsProtected%2A> プロパティをチェックし、セクションがまだ暗号化されていなければ、<xref:System.Configuration.SectionInformation.ProtectSection%2A> を呼び出して暗号化します。  それ以外の場合は、<xref:System.Configuration.SectionInformation.UnProtectSection%2A> メソッドを呼び出してセクションを復号化します。  最後に、<xref:System.Configuration.Configuration.Save%2A> メソッドで操作を完了し、変更内容を保存します。  
+  
+> [!NOTE]
+>  このコードを実行するには、プロジェクトで `System.Configuration.dll` を参照設定する必要があります。  
+  
+ [!code-csharp[DataWorks ConnectionStrings.Encrypt#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStrings.Encrypt/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStrings.Encrypt#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStrings.Encrypt/VB/source.vb#1)]  
+  
+### Web.config の例  
+ この例では、`WebConfigurationManager` の <xref:System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration%2A> メソッドを使用しています。  この場合、チルダを使用して、**Web.config** ファイルの相対パスを指定できる点に注目してください。  このコードを実行するには、`System.Web.Configuration` クラスへの参照が必要です。  
+  
+ [!code-csharp[DataWorks ConnectionStringsWeb.Encrypt#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStringsWeb.Encrypt/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStringsWeb.Encrypt#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStringsWeb.Encrypt/VB/source.vb#1)]  
+  
+ ASP.NET アプリケーションのセキュリティ保護の詳細については、「[NIB: ASP.NET Security](http://msdn.microsoft.com/ja-jp/04b37532-18d9-40b4-8e5f-ee09a70b311d)」および ASP.NET デベロッパー センターの「[ASP.NET 2.0 のセキュリティ プラクティス](http://go.microsoft.com/fwlink/?LinkId=59997)」を参照してください。  
+  
+## 参照  
+ [接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)   
+ [Using the Configuration Classes](../Topic/Using%20the%20Configuration%20Classes.md)   
+ [アプリの構成](../../../../docs/framework/configure-apps/index.md)   
+ [ASP.NET Web Site Administration](../Topic/ASP.NET%20Web%20Site%20Administration.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/connection-strings.md b/docs/framework/data/adonet/connection-strings.md
new file mode 100644
index 00000000000..5388dcf6efd
--- /dev/null
+++ b/docs/framework/data/adonet/connection-strings.md
@@ -0,0 +1,49 @@
+---
+title: "ADO.NET での接続文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 745c5f95-2f02-4674-b378-6d51a7ec2490
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ADO.NET での接続文字列
+.NET Framework 2.0 では、接続文字列を扱う新しい機能が導入されました。接続文字列ビルダー クラスに追加された新しいキーワードもその 1 つであり、有効な接続文字列を実行時に簡単に作成できるようになっています。  
+  
+ 接続文字列には、データ プロバイダーからデータ ソースにパラメーターとして渡す初期化情報が含まれています。  接続文字列は接続を開くときに解析され、その構文はデータ プロバイダーによって異なります。  構文エラーの場合はランタイム例外が生成されますが、その他のエラーは、データ ソースが接続情報を受け取った後でのみ発生します。  いったん接続文字列が検証されると、接続文字列に指定されたオプションがデータ ソースによって適用されて接続が開かれます。  
+  
+ 接続文字列の形式は、キーと値パラメーターのペアをセミコロンで区切ったリストです。  
+  
+ `keyword1=value; keyword2=value;`  
+  
+ キーワードの大文字と小文字は区別されません。また、キーと値のペア間のスペースは無視されます。  ただし、値の大文字と小文字を区別するかどうかはデータ ソースにより異なる場合があります。  値にセミコロン、単一引用符、または二重引用符が含まれている場合は、必ず二重引用符で囲む必要があります。  
+  
+ 有効な接続文字列の構文はプロバイダーによって異なり、ODBC のような初期の API から長年にわたって進化しています。  .NET Framework Data Provider for SQL Server \(SqlClient\) には、古い構文の要素が多数組み込まれており、一般的に、共通の接続文字列の構文に対しては柔軟性があります。  多くの場合、接続文字列の構文要素には同等として扱われる有効なシノニムが存在しますが、構文やスペルの誤りによって問題が生じる場合もあります。  たとえば、"`Integrated Security=true`" は有効ですが、"`IntegratedSecurity=true`" ではエラーが発生します。  また、ユーザー入力を基にして接続文字列を実行時に構築する場合、入力された文字列を検証しないと、文字列のインジェクション攻撃を招き、データ ソースのセキュリティが脅かされる可能性があります。  
+  
+ こうした問題に対処するため、ADO.NET 2.0 では、各 .NET Framework データ プロバイダー用の新しい接続文字列ビルダーが導入されました。  キーワードがプロパティとして公開され、接続文字列をデータ ソースに送信する前に、その構文を検証できます。  
+  
+## このセクションの内容  
+ [接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)  
+ `ConnectionStringBuilder` クラスを使用して、有効な接続文字列を実行時に作成する方法について説明します。  
+  
+ [接続文字列と構成ファイル](../../../../docs/framework/data/adonet/connection-strings-and-configuration-files.md)  
+ 構成ファイルを使用した接続文字列の格納と取得の方法について説明します。  
+  
+ [接続文字列の構文](../../../../docs/framework/data/adonet/connection-string-syntax.md)  
+ `SqlClient`、`OracleClient`、`OleDb`、`Odbc` の各プロバイダーに固有の接続文字列を構成する方法について説明します。  
+  
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)  
+ データ ソースへの接続に使用する情報を保護する方法を示します。  
+  
+## 参照  
+ [データ ソースへの接続](../../../../ocs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md b/docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md
new file mode 100644
index 00000000000..677029078c3
--- /dev/null
+++ b/docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md
@@ -0,0 +1,84 @@
+---
+title: "Creating a DataTable From a Query (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b97afeb-03f8-41e2-8eb3-58aff65f7d18
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Creating a DataTable From a Query (LINQ to DataSet)
+<xref:System.Data.DataTable> オブジェクトの一般的な利用法の 1 つが、データ バインドです。  <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、クエリの結果を受け取り、そのデータを <xref:System.Data.DataTable> にコピーします。これをデータ バインドに利用できます。  このデータ操作が実行されると、新しい <xref:System.Data.DataTable> が、基となった <xref:System.Data.DataTable> にマージ バックされます。  
+  
+ <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドでは、次の処理を実行することでクエリの結果から <xref:System.Data.DataTable> を作成します。  
+  
+1.  <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドにより、ソース テーブル \(<xref:System.Linq.IQueryable%601> インターフェイスを実装する <xref:System.Data.DataTable> オブジェクト\) から <xref:System.Data.DataTable> を複製します。  通常、<xref:System.Collections.IEnumerable> ソースは [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 式またはメソッド クエリから生成されます。  
+  
+2.  複製の <xref:System.Data.DataTable> のスキーマは、ソース テーブルで最初に列挙されている <xref:System.Data.DataRow> オブジェクトの列から作成されます。複製したテーブルの名前は、ソース テーブルの名前に "query" という単語を付加した名前になります。  
+  
+3.  ソース テーブルの各行について、行の内容が新しい <xref:System.Data.DataRow> オブジェクトにコピーされた後、それが複製のテーブルに挿入されます。  このコピー操作の間、<xref:System.Data.DataRow.RowState%2A> プロパティと <xref:System.Data.DataRow.RowError%2A> プロパティは保持されます。  基になる <xref:System.Data.DataRow> オブジェクトが別々のテーブルに由来している場合、<xref:System.ArgumentException> がスローされます。  
+  
+4.  クエリ実行可能な入力テーブルの <xref:System.Data.DataRow> オブジェクトがすべてコピーされた後、複製の <xref:System.Data.DataTable> が返されます。  基となるシーケンスに <xref:System.Data.DataRow> オブジェクトが含まれていない場合、このメソッドは空の <xref:System.Data.DataTable> を返します。  
+  
+ <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドを呼び出すと、ソース テーブルにバインドされているクエリが実行されることに注意してください。  
+  
+ <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドにより、ソース テーブルの行に Null 参照または Null 許容の値型が検出された場合、その値は <xref:System.DBNull.Value> に置き換えられます。  このようにして、返される <xref:System.Data.DataTable> の Null 値が適切に処理されます。  
+  
+ メモ : <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、複数の <xref:System.Data.DataTable> オブジェクトまたは <xref:System.Data.DataSet> オブジェクトから行を返せるクエリを入力として受け入れます。  <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、ソースの <xref:System.Data.DataTable> または <xref:System.Data.DataSet> オブジェクトから、返された <xref:System.Data.DataTable> にデータをコピーしますが、プロパティはコピーしません。  <xref:System.Data.DataTable.Locale%2A> や <xref:System.Data.DataTable.TableName%2A> などの返された <xref:System.Data.DataTable> に、明示的にプロパティを設定する必要があります。  
+  
+ 次の例では、SalesOrderHeader テーブルに対して 2001 年 8 月 8 日以降の注文をクエリし、<xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドを使用して、このクエリから <xref:System.Data.DataTable> を作成します。  次に、<xref:System.Data.DataTable> が <xref:System.Windows.Forms.BindingSource> にバインドされます。これは <xref:System.Windows.Forms.DataGridView> のプロキシとして機能します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CopyToDataTable1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#copytodatatable1)]
+ [!code-vb[DP LINQ to DataSet Examples#CopyToDataTable1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#copytodatatable1)]  
+  
+## カスタム CopyToDataTable\<T\> メソッドの作成  
+ 既存の <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、ジェネリック パラメーター `T` が <xref:System.Data.DataRow> 型である <xref:System.Collections.Generic.IEnumerable%601> ソースに対してのみ作用します。  有用ではありますが、一連のスカラー型、匿名型を返すクエリ、またはテーブルの結合を実行するクエリからは、テーブルを作成できません。  一連のスカラー型または匿名型からテーブルを読み込む 2 つのカスタム `CopyToDataTable` メソッドの実装例については、「[How to: Implement CopyToDataTable\<T\> Where the Generic Type T Is Not a DataRow](../../../../docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md)」を参照してください。  
+  
+ このセクションの例には、次のカスタム型が使用されています。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#ItemClass](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#itemclass)]
+ [!code-vb[DP Custom CopyToDataTable Examples#ItemClass](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#itemclass)]  
+  
+### 例  
+ この例では、`SalesOrderHeader` テーブルと `SalesOrderDetail` テーブルを結合し、8 月以降のオンラインでの注文を取得して、クエリからテーブルを作成します。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#Join](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#join)]
+ [!code-vb[DP Custom CopyToDataTable Examples#Join](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#join)]  
+  
+### 例  
+ 次の例では、価格が $9.99 を超える一連の商品を照会し、そのクエリの結果からテーブルを作成します。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#LoadItemsIntoTable](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#loaditemsintotable)]
+ [!code-vb[DP Custom CopyToDataTable Examples#LoadItemsIntoTable](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#loaditemsintotable)]  
+  
+### 例  
+ 次の例では、価格が $9.99 を超える一連の商品を照会し、その結果を射影します。  返された一連の匿名型は、既存のテーブルに読み込まれます。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#LoadItemsIntoExistingTable](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#loaditemsintoexistingtable)]
+ [!code-vb[DP Custom CopyToDataTable Examples#LoadItemsIntoExistingTable](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#loaditemsintoexistingtable)]  
+  
+### 例  
+ 次の例では、価格が $9.99 を超える一連の商品を照会し、その結果を射影します。  返された一連の匿名型は、既存のテーブルに読み込まれます。  `Book` 型と `Movies` 型は `Item` 型から派生するため、テーブル スキーマは自動的に展開されます。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#LoadItemsExpandSchema](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#loaditemsexpandschema)]
+ [!code-vb[DP Custom CopyToDataTable Examples#LoadItemsExpandSchema](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#loaditemsexpandschema)]  
+  
+### 例  
+ 次の例では、価格が $9.99 を超える一連の商品を照会し、新しいテーブルに読み込まれる一連の <xref:System.Double> を返します。  
+  
+ [!code-csharp[DP Custom CopyToDataTable Examples#LoadScalarSequence](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#loadscalarsequence)]
+ [!code-vb[DP Custom CopyToDataTable Examples#LoadScalarSequence](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#loadscalarsequence)]  
+  
+## 参照  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)   
+ [Generic Field and SetField Methods](../../../../docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/creating-a-dataview-object-linq-to-dataset.md b/docs/framework/data/adonet/creating-a-dataview-object-linq-to-dataset.md
new file mode 100644
index 00000000000..77199ba2e7d
--- /dev/null
+++ b/docs/framework/data/adonet/creating-a-dataview-object-linq-to-dataset.md
@@ -0,0 +1,80 @@
+---
+title: "Creating a DataView Object (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76057508-e12d-4779-a707-06a4c2568acf
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Creating a DataView Object (LINQ to DataSet)
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のコンテキストで <xref:System.Data.DataView> を作成するには 2 つの方法があります。  <xref:System.Data.DataView> は、<xref:System.Data.DataTable> に対する [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成したり、型指定されているまたは型指定されていない <xref:System.Data.DataTable> から作成したりできます。  どちらの場合でも、<xref:System.Data.DataView> を作成するのにいずれかの <xref:System.Data.DataTableExtensions.AsDataView%2A> 拡張メソッドを使用します。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のコンテキストで <xref:System.Data.DataView> を直接作成することはできません。  
+  
+ <xref:System.Data.DataView> を作成した後に、Windows フォーム アプリケーションまたは ASP.NET アプリケーションの UI コントロールにバインドしたり、フィルターおよび並べ替えの設定を変更したりできます。  
+  
+ <xref:System.Data.DataView> は、インデックスを構築します。これにより、フィルター処理や並べ替えなど、インデックスを使用できる操作のパフォーマンスが大幅に向上します。  <xref:System.Data.DataView> のインデックスは、<xref:System.Data.DataView> の作成時に構築されるほか、並べ替えまたはフィルター処理の情報が変更されたときにも構築されます。  <xref:System.Data.DataView> を作成した後で、並べ替えまたはフィルター処理の情報を設定した場合、インデックスが最低でも 2 回 \(<xref:System.Data.DataView> の作成時と、並べ替えまたはフィルターのプロパティの変更時\) 構築されることになります。  
+  
+ <xref:System.Data.DataView> でのフィルターおよび並べ替えの詳細については、「[Filtering with DataView](../../../../docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md)」および「[Sorting with DataView](../../../../docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md)」を参照してください。  
+  
+## LINQ to DataSet クエリの結果からの DataView の作成  
+ <xref:System.Data.DataView> オブジェクトは、<xref:System.Data.DataRow> オブジェクトの射影である [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリの結果から作成できます。  新しく作成される <xref:System.Data.DataView> は、その基となるクエリからのフィルター処理および並べ替え情報を継承します。  
+  
+> [!NOTE]
+>  ほとんどの場合、フィルターに使用する式は、副作用のない確定的な式である必要があります。  また、並べ替えおよびフィルター処理は任意の回数実行されるため、特定の実行回数に依存するロジックが式に含まれないようにしてください。  
+  
+ 匿名型を返すクエリまたは結合操作を実行するクエリからの <xref:System.Data.DataView> の作成はサポートされていません。  
+  
+ <xref:System.Data.DataView> の作成に使用されるクエリでは、次のクエリ演算子のみがサポートされます。  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.Cast%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.OrderBy%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.OrderByDescending%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.Select%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.ThenBy%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.ThenByDescending%2A>  
+  
+-   <xref:System.Data.EnumerableRowCollectionExtensions.Where%2A>  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから <xref:System.Data.DataView> を作成する場合は、<xref:System.Data.EnumerableRowCollectionExtensions.Select%2A> メソッドをクエリで呼び出す最後のメソッドとする必要があります。次の例では、合計支払額別に並べ替えられたオンライン注文の <xref:System.Data.DataView> を作成します。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQuery1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromquery1)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQuery1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromquery1)]  
+  
+ また、文字列ベースの <xref:System.Data.DataView.RowFilter%2A> プロパティおよび <xref:System.Data.DataView.Sort%2A> プロパティを使用して、<xref:System.Data.DataView> をクエリから作成した後でフィルターを適用し、並べ替えることができます。  この操作を行うと、クエリから継承された並べ替えおよびフィルター情報がクリアされます。  次の例では、姓が "S" で始まる連絡先をフィルター処理する [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから <xref:System.Data.DataView> を作成します。  文字列ベースの <xref:System.Data.DataView.Sort%2A> プロパティは、姓を昇順に並べ替え、名を降順に並べ替えるように設定されています。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQueryStringSort](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromquerystringsort)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQueryStringSort](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromquerystringsort)]  
+  
+## DataTable からの DataView の作成  
+ <xref:System.Data.DataView> オブジェクトは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成できるほか、<xref:System.Data.DataTableExtensions.AsDataView%2A> メソッドを使用して <xref:System.Data.DataTable> から作成することもできます。  
+  
+ 次の例では、<xref:System.Data.DataView> を SalesOrderDetail テーブルから作成した後、<xref:System.Windows.Forms.BindingSource> オブジェクトのデータ ソースとして設定します。  このオブジェクトは、<xref:System.Windows.Forms.DataGridView> コントロールのプロキシとして動作します。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromTable](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromtable)]
+ [!code-vb[DP DataView Samples#CreateLDVFromTable](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromtable)]  
+  
+ <xref:System.Data.DataTable> から <xref:System.Data.DataView> を作成した後、フィルターおよび並べ替えを設定できます。  次の例では、<xref:System.Data.DataView> を Contact テーブルから作成した後、姓を昇順に並べ替え、名を降順に並べ替えるための <xref:System.Data.DataView.Sort%2A> プロパティを設定します。  
+  
+ [!code-csharp[DP DataView Samples#LDVStringSort](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvstringsort)]
+ [!code-vb[DP DataView Samples#LDVStringSort](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvstringsort)]  
+  
+ ただし、<xref:System.Data.DataView> をクエリから作成した後に <xref:System.Data.DataView.RowFilter%2A> プロパティまたは <xref:System.Data.DataView.Sort%2A> プロパティを設定する操作を行うと、パフォーマンスが低下します。なぜなら、<xref:System.Data.DataView> により、フィルター処理および並べ替え処理をサポートするためのインデックスが構築されるからです。  <xref:System.Data.DataView.RowFilter%2A> プロパティまたは <xref:System.Data.DataView.Sort%2A> プロパティを設定すると、データのインデックスが再構築され、アプリケーションのオーバーヘッドが増加してパフォーマンスの低下を招きます。  可能な場合は、<xref:System.Data.DataView> を最初に作成するときにフィルター処理および並べ替え情報を指定して、後で情報を変更するのを避けてください。  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)   
+ [Filtering with DataView](../../../../docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md)   
+ [Sorting with DataView](../../../../docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md b/docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md
new file mode 100644
index 00000000000..0fa017b83fc
--- /dev/null
+++ b/docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md
@@ -0,0 +1,41 @@
+---
+title: "Cross-Table Queries (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6819a16f-8656-41af-a54d-dfec0cb66366
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Cross-Table Queries (LINQ to DataSet)
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、1 つのテーブルを対象とするクエリに加え、複数のテーブルを対象とするクエリを実行できます。このようなクエリは、*統合*を使用して実現されます。  結合とは、あるデータ ソース内のオブジェクトを、他方のデータ ソース内で共通の属性 \(たとえば製品や連絡先 ID\) を持つオブジェクトと関連付けることです。  オブジェクト指向プログラミングでは、それぞれのオブジェクトが別のオブジェクトを参照するメンバーを持つため、オブジェクト間のリレーションシップを比較的簡単にナビゲートできます。ただし、外部データベース テーブル内でのリレーションシップは、これほど簡単にはナビゲートできません。  データベース テーブルには、組み込みのリレーションシップがありません。このようなケースでは、結合操作を使用して、互いのソースの要素を対応付けることができます。  たとえば、製品情報と売上情報が 2 つのテーブルに格納されている場合、結合操作を使用して、同じ販売注文の売上情報と製品を対応付けることができます。  
+  
+ [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] フレームワークには、<xref:System.Linq.Enumerable.Join%2A> と <xref:System.Linq.Enumerable.GroupJoin%2A> の 2 つの結合演算子が用意されています。これらの演算子は、キーが等しいときだけ 2 つのデータ ソースを対応付ける結合方法である*等結合*を実行します   \(これに対し、[!INCLUDE[tsql](../../../../includes/tsql-md.md)] では、`equals` 以外に `less than` 演算子などの結合演算子がサポートされます\)。  
+  
+ リレーショナル データベース用語では、<xref:System.Linq.Enumerable.Join%2A> は内部結合を実行します。  内部結合とは、対応するデータセット内で一致するオブジェクトがあるオブジェクトのみが返される結合です。  
+  
+ リレーショナル データベース用語で <xref:System.Linq.Enumerable.GroupJoin%2A> 演算子に相当するものはありません。この演算子は、内部結合と左外部結合のスーパーセットを実装します。左外部結合とは、関連のある要素が 2 つ目のコレクションに存在しない場合でも 1 つ目 \(左側\) のコレクションの各要素を返す結合です。  
+  
+ 結合の詳細については、「[Join Operations](../../../../ocs/visual-basic/programming-guide/concepts/linq/join-operations.md)」を参照してください。  
+  
+## 例  
+ 次の例では、AdventureWorks サンプル データベースの `SalesOrderHeader` テーブルと `SalesOrderDetail` テーブルを従来の方法で結合し、8 月以降のオンラインでの注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Join](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#join)]
+ [!code-vb[DP LINQ to DataSet Examples#Join](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#join)]  
+  
+## 参照  
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)   
+ [Single\-Table Queries](../../../../docs/framework/data/adonet/single-table-queries-linq-to-dataset.md)   
+ [Querying Typed DataSets](../../../../docs/framework/data/adonet/querying-typed-datasets.md)   
+ [Join Operations](../../../../ocs/visual-basic/programming-guide/concepts/linq/join-operations.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/data-binding-and-linq-to-dataset.md b/docs/framework/data/adonet/data-binding-and-linq-to-dataset.md
new file mode 100644
index 00000000000..afc05339f1e
--- /dev/null
+++ b/docs/framework/data/adonet/data-binding-and-linq-to-dataset.md
@@ -0,0 +1,46 @@
+---
+title: "Data Binding and LINQ to DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 310bff4a-32dd-4f20-a271-6dbd82912631
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Data Binding and LINQ to DataSet
+*データ バインド*とは、アプリケーションの UI とビジネス ロジックの間の接続を確立する処理です。  バインドが適切に設定され、データから適切な通知が提供される場合、データの値が変更されると、そのデータにバインドされている要素に変更が自動的に反映されます。  <xref:System.Data.DataSet> はメモリ内データ表現であり、含まれているデータ ソースとは関係なく、一貫性のあるリレーショナル プログラミング モデルを提供します。  ADO.NET 2.0 の <xref:System.Data.DataView> では、<xref:System.Data.DataTable> に格納されているデータの並べ替えとフィルター処理を行うことができます。  この機能は、データ バインド アプリケーションで一般に使用されます。  <xref:System.Data.DataView> を使用すると、さまざまな並べ替え順序を使用してテーブルのデータを公開したり、行の状態やフィルター式に基づいてデータをフィルター処理したりできます。  <xref:System.Data.DataView> オブジェクトの詳細については、「[DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)」を参照してください。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、開発者は、[!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] を使用して、<xref:System.Data.DataSet> に対する複雑で強力なクエリを作成できます。  ただし、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリは、バインド シナリオで簡単に使用できない <xref:System.Data.DataRow> オブジェクトの列挙を返します。バインドを容易にするには、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから <xref:System.Data.DataView> を作成します。  この <xref:System.Data.DataView> は、クエリに指定されているフィルター処理および並べ替え処理を使用しますが、よりデータ バインドに適しています。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、文字列ベースのフィルター処理および並べ替え処理よりもはるかに複雑で強力な [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 式ベースのフィルター処理および並べ替え処理を提供することで、<xref:System.Data.DataView> の機能を拡張します。  
+  
+ <xref:System.Data.DataView> はクエリ自体を表すもので、クエリに基づくビューではありません。  単純なデータ バインド モデルを提供する場合、<xref:System.Data.DataView> は、<xref:System.Windows.Forms.DataGrid> や <xref:System.Windows.Forms.DataGridView> などの UI コントロールにバインドされます。  当該テーブルの既定のビューを提供する場合、<xref:System.Data.DataView> は、<xref:System.Data.DataTable> から作成することもできます。  
+  
+## このセクションの内容  
+ [Creating a DataView Object](../../../../docs/framework/data/adonet/creating-a-dataview-object-linq-to-dataset.md)  
+ <xref:System.Data.DataView> の作成に関する情報を提供します。  
+  
+ [Filtering with DataView](../../../../docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md)  
+ <xref:System.Data.DataView> を使用してフィルター処理する方法について説明します。  
+  
+ [Sorting with DataView](../../../../docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md)  
+ <xref:System.Data.DataView> を使用して並べ替えを行う方法について説明します。  
+  
+ [Querying the DataRowView Collection in a DataView](../../../../docs/framework/data/adonet/querying-the-datarowview-collection-in-a-dataview.md)  
+ <xref:System.Data.DataView> が公開する <xref:System.Data.DataRowView> コレクションを照会する方法について説明します。  
+  
+ [DataView Performance](../../../../docs/framework/data/adonet/dataview-performance.md)  
+ <xref:System.Data.DataView> およびパフォーマンスに関する情報を提供します。  
+  
+ [How to: Bind a DataView Object to a Windows Forms DataGridView Control](../../../../docs/framework/data/adonet/how-to-bind-a-dataview-object-to-a-winforms-datagridview-control.md)  
+ <xref:System.Data.DataView> オブジェクトを <xref:System.Windows.Forms.DataGridView> にバインドする方法について説明します。  
+  
+## 参照  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/data-providers.md b/docs/framework/data/adonet/data-providers.md
new file mode 100644
index 00000000000..2f21ab1ee78
--- /dev/null
+++ b/docs/framework/data/adonet/data-providers.md
@@ -0,0 +1,167 @@
+---
+title: ".NET Framework データ プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03a9fc62-2d24-491a-9fe6-d6bdb6dcb131
+caps.latest.revision: 13
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 13
+---
+# .NET Framework データ プロバイダー
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーは、データベースに接続して、コマンドを実行したり、結果を取得したりする目的で使用されます。 その結果は、直接処理されるか、必要に応じてユーザーに公開されるように <xref:System.Data.DataSet> に格納されるか、取得したデータセットを複数のソースからのデータと組み合わせるか、または、層間でリモート処理されます。 軽量な [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーでは、データ ソースとコード間に形成される層が最小限で済むため、機能を犠牲にすることなく、パフォーマンスを高めることができます。  
+  
+ 次の表に、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] に含まれているデータ プロバイダーを示します。  
+  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダー|説明|  
+|----------------------------------------------------------------------------|--------|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]|Microsoft [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] へのデータ アクセスを提供します。<xref:System.Data.SqlClient> 名前空間を使用してください。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB|OLE DB を使用して公開されるデータ ソースに対応。<xref:System.Data.OleDb> 名前空間を使用してください。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]Data Provider for ODBC|ODBC を使用して公開されるデータ ソースに対応。<xref:System.Data.Odbc> 名前空間を使用してください。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]Data Provider for Oracle|Oracle データ ソースに対応。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle は、Oracle クライアント ソフトウェア バージョン 8.1.7 以降をサポートしています。<xref:System.Data.OracleClient> 名前空間を使用してください。|  
+|EntityClient プロバイダー|エンティティ データ モデル \(EDM\) アプリケーションにデータ アクセスを提供します。<xref:System.Data.EntityClient> 名前空間を使用してください。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] Compact 4.0|Microsoft [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] Compact 4.0 へのデータ アクセスを提供します。[System.Data.SqlServerCe](http://msdn.microsoft.com/library/system.data.sqlserverce.aspx) 名前空間を使用します。|  
+  
+## .NET Framework Data Providers の核となるオブジェクト  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーを構成する核となる 4 つのオブジェクトの概要を、次の表に示します。  
+  
+|Object|説明|  
+|------------|--------|  
+|`Connection`|特定のデータ ソースへの接続を確立します。 すべての `Connection` オブジェクトの基本クラスは <xref:System.Data.Common.DbConnection> クラスです。|  
+|`Command`|データ ソースに対してコマンドを実行します。`Parameters` を公開し、`Transaction` から `Connection` のスコープ内で実行できます。 すべての `Command` オブジェクトの基本クラスは <xref:System.Data.Common.DbCommand> クラスです。|  
+|`DataReader`|データ ソースから、前方参照専用で読み取り専用のデータ ストリームを読み取ります。 すべての `DataReader` オブジェクトの基本クラスは <xref:System.Data.Common.DbDataReader> クラスです。|  
+|`DataAdapter`|`DataSet` にデータ ソースのデータを読み込んだり、データ ソースの更新内容を解決したりします。 すべての `DataAdapter` オブジェクトの基本クラスは <xref:System.Data.Common.DbDataAdapter> クラスです。|  
+  
+ 前の表で示した核となるクラスの他に、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーには次の表に示すクラスも含まれます。  
+  
+|Object|説明|  
+|------------|--------|  
+|`Transaction`|データ ソースでトランザクション内にコマンドを追加します。 すべての `Transaction` オブジェクトの基本クラスは <xref:System.Data.Common.DbTransaction> クラスです。 ADO.NET は、<xref:System.Transactions> 名前空間のクラスを使ったトランザクションもサポートします。|  
+|`CommandBuilder`|`DataAdapter` のコマンド プロパティを自動的に生成したり、ストアド プロシージャからパラメーター情報を取得したり、`Parameters` オブジェクトの `Command` コレクションにパラメーターを設定したりするためのヘルパー オブジェクトです。 すべての `CommandBuilder` オブジェクトの基本クラスは <xref:System.Data.Common.DbCommandBuilder> クラスです。|  
+|`ConnectionStringBuilder`|`Connection` オブジェクトが使用する接続文字列を簡単に作成および管理するためのヘルパー オブジェクトです。 すべての `ConnectionStringBuilder` オブジェクトの基本クラスは <xref:System.Data.Common.DbConnectionStringBuilder> クラスです。|  
+|`Parameter`|コマンドやストアド プロシージャの入力パラメーター、出力パラメーター、および戻り値パラメーターを定義します。 すべての `Parameter` オブジェクトの基本クラスは <xref:System.Data.Common.DbParameter> クラスです。|  
+|`Exception`|データ ソースでエラーが検出されたときに返されます。 クライアントで検出されたエラーの場合、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーは [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 例外をスローします。 すべての `Exception` オブジェクトの基本クラスは <xref:System.Data.Common.DbException> クラスです。|  
+|`Error`|データ ソースから返された警告またはエラー情報を公開します。|  
+|`ClientPermission`|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーにコード アクセス セキュリティ属性を提供します。 すべての `ClientPermission` オブジェクトの基本クラスは <xref:System.Data.Common.DBDataPermission> クラスです。|  
+  
+## .NET Framework Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] \(SqlClient\)  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] \(SqlClient\) は独自のプロトコルを使用して [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] と通信します。 これは軽量で高速に動作します。OLE DB または ODBC \(Open Database Connectivity\) 層を追加しなくても、直接 [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] にアクセスするように最適化されているためです。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB の対比を次の図に示します。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB は、接続プールとトランザクション サービスを提供する OLE DB Service コンポーネントと、データ ソース用の OLE DB プロバイダーの両方をとおして OLE DB データ ソースと通信します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB に似たアーキテクチャを持っています。たとえば、ODBC Service コンポーネントへの呼び出しを行います。  
+  
+ ![データ プロバイダー](../../../../docs/framework/data/adonet/media/netdataproviders-bpuedev11.png "NETDataProviders\_bpuedev11")  
+.NET Framework Data Provider for SQL Server と .NET Framework Data Provider for OLE DB の比較  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] クラスは、名前空間 <xref:System.Data.SqlClient> 内に配置されます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] はローカル トランザクションと分散トランザクションのどちらもサポートします。 分散トランザクションの場合、既定で、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] は自動的にトランザクションに参加し、トランザクションの詳細を Windows コンポーネント サービスまたは <xref:System.Transactions> から取得します。 詳細については、「[トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)」を参照してください。  
+  
+ 名前空間 `System.Data.SqlClient` をユーザーのアプリケーションにインクルードする方法を次のコード サンプルで示します。  
+  
+```vb  
+Imports System.Data.SqlClient  
+```  
+  
+```csharp  
+using System.Data.SqlClient;  
+```  
+  
+## .NET Framework Data Provider for OLE DB  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB \(OleDb\) は、COM 相互運用機能を介してネイティブ OLE DB を使用することで、データへのアクセスを可能にします。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB はローカル トランザクションと分散トランザクションのどちらもサポートします。 分散トランザクションの場合、既定で、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB は自動的にトランザクションに参加し、トランザクションの詳細を Windows コンポーネント サービスから取得します。 詳細については、「[トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)」を参照してください。  
+  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] とのテストが完了しているプロバイダーを次の表に示します。  
+  
+|ドライバー|プロバイダー|  
+|-----------|------------|  
+|SQLOLEDB|Microsoft OLE DB Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]|  
+|MSDAORA|Microsoft OLE DB Provider for Oracle|  
+|Microsoft.Jet.OLEDB.4.0|OLE DB Provider for Microsoft Jet|  
+  
+> [!NOTE]
+>  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションなどのマルチスレッド アプリケーションのデータ ソースとして Access \(Jet\) データベースを使用することはお勧めできません。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションのデータ ソースとして Jet を使用する必要がある場合、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションから Access データベースへの接続で問題が発生することがあるので注意してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB は OLE DB バージョン 2.5 のインターフェイスをサポートしていません。 OLE DB 2.5 インターフェイスのサポートを必要とする OLE DB Providers は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB と併用した場合、適切に機能しません。 これには Microsoft OLE DB Provider for Exchange および Microsoft OLE DB Provider for Internet Publishing が含まれます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB と OLE DB Provider for ODBC \(MSDASQL\) は併用できません。[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] を使用して ODBC データ ソースにアクセスするには、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC を使用してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB クラスは、名前空間 <xref:System.Data.OleDb> 内に配置されます。 名前空間 `System.Data.OleDb` をユーザーのアプリケーションにインクルードする方法を次のコード サンプルで示します。  
+  
+```vb  
+Imports System.Data.OleDb  
+```  
+  
+```csharp  
+using System.Data.OleDb;  
+```  
+  
+## .NET Framework Data Provider for ODBC  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC \(Odbc\) は、ネイティブ ODBC ドライバー マネージャー \(DM\) を使用することで、データへのアクセスを可能にします。 ODBC データ プロバイダーはローカル トランザクションと分散トランザクションのどちらもサポートします。 分散トランザクションの場合、既定で、ODBC データ プロバイダーは自動的にトランザクションに参加し、トランザクションの詳細を Windows コンポーネント サービスから取得します。 詳細については、「[トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)」を参照してください。  
+  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] とのテストが完了している ODBC ドライバーを次の表に示します。  
+  
+|ドライバー|  
+|-----------|  
+|[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]|  
+|Microsoft ODBC for Oracle|  
+|Microsoft Access ドライバー \(\*.mdb\)|  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC クラスは、名前空間 <xref:System.Data.Odbc> 内に配置されます。  
+  
+ 名前空間 `System.Data.Odbc` をユーザーのアプリケーションにインクルードする方法を次のコード サンプルで示します。  
+  
+```vb  
+Imports System.Data.Odbc  
+```  
+  
+```csharp  
+using System.Data.Odbc;  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC を使用する場合、MDAC 2.6 以降が必要となります。MDAC 2.8 SP1 をお勧めします。 MDAC 2.8 SP1 は「[データ アクセスおよびストレージ デベロッパー センター](http://go.microsoft.com/fwlink/?linkid=4173)」からダウンロードできます。  
+  
+## .NET Framework Oracle 用データ プロバイダー  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle \(OracleClient\) は、Oracle クライアント接続ソフトウェアを介して、Oracle データ ソースのデータへのアクセスを可能にします。 このデータ プロバイダーは Oracle クライアント ソフトウェア バージョン 8.1.7 以降をサポートしています。 データ プロバイダーはローカル トランザクションと分散トランザクションのどちらもサポートします。 詳細については、「[トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)」を参照してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle を使用する場合、Oracle データ ソースに接続する前に、Oracle クライアント ソフトウェア \(バージョン 8.1.7 以降\) をシステムにインストールする必要があります。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle クラスは、名前空間 <xref:System.Data.OracleClient> 内に配置され、`System.Data.OracleClient.dll` アセンブリに格納されます。 このデータ プロバイダーを使用するアプリケーションをコンパイルする場合は、`System.Data.dll` と `System.Data.OracleClient.dll` の両方を参照する必要があります。  
+  
+ 名前空間 `System.Data.OracleClient` をユーザーのアプリケーションにインクルードする方法を次のコード サンプルで示します。  
+  
+```vb  
+Imports System.Data  
+Imports System.Data.OracleClient  
+```  
+  
+```csharp  
+using System.Data;  
+using System.Data.OracleClient;  
+```  
+  
+## .NET Framework データ プロバイダーの選択  
+ アプリケーションのデザインおよびデータ ソースによっては、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーを選択すると、アプリケーションのパフォーマンス、能力、および整合性が向上します。 各 [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーが持つ利点と制限事項を次の表で説明します。  
+  
+|プロバイダー|ノート|  
+|------------|---------|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]|[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] を使用する中間層アプリケーションに推奨されています。<br /><br /> Microsoft Database Engine \(MSDE\) または [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] を使用する単層アプリケーションに推奨されています。<br /><br /> SQLOLEDB \(OLE DB Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]\) と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB を併用する場合に推奨します。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for OLE DB|[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] では、このプロバイダーではなく [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] が推奨されます。<br /><br /> Microsoft Access データベースを使用する単層アプリケーションに推奨されます。 Access データベースを中間層アプリケーションで使用することはお勧めできません。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ``Data Provider for ODBC|中間層アプリケーションおよび単層アプリケーションで ODBC データ ソースを使用する場合に推奨します。|  
+|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ``Data Provider for Oracle|中間層アプリケーションおよび単層アプリケーションで Oracle データ ソースを使用する場合に推奨します。|  
+  
+## EntityClient プロバイダー  
+ EntityClient プロバイダーは、エンティティ データ モデル \(EDM\) に基づくデータ アクセスで使用されます。 他の .NET Framework データ プロバイダーとは異なり、データ ソースと直接やり取りしません。 代わりに Entity SQL を使用して、基になるデータ プロバイダーと通信します。 詳細については、「[EntityClient and Entity SQL](http://msdn.microsoft.com/ja-jp/49202ab9-ac98-4b4b-a05c-140e422bf527)」を参照してください。  
+  
+## 参照  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/data-tracing.md b/docs/framework/data/adonet/data-tracing.md
new file mode 100644
index 00000000000..5ae5fcafd3f
--- /dev/null
+++ b/docs/framework/data/adonet/data-tracing.md
@@ -0,0 +1,64 @@
+---
+title: "ADO.NET でのデータ トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6a752a5-d2a9-4335-a382-b58690ccb79f
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# ADO.NET でのデータ トレース
+ADO.NET は、組み込みデータ トレース機能を特徴としています。この機能は、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]、Oracle、OLE DB、および ODBC 用の .NET データ プロバイダーと、ADO.NET <xref:System.Data.DataSet> および [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] ネットワーク プロトコルによりサポートされています。  
+  
+ データ アクセス API 呼び出しのトレースは、次の問題を診断する際に役立ちます。  
+  
+-   クライアント プログラムとデータベース間のスキーマの不一致  
+  
+-   データベースの使用不可またはネットワーク ライブラリの問題  
+  
+-   誤った SQL がアプリケーションによりハードコーディングまたは生成された  
+  
+-   プログラミング ロジックが不適切  
+  
+-   複数の ADO.NET コンポーネント間または ADO.NET と独自コンポーネント間の対話に起因する問題  
+  
+ トレースを拡張することにより異なるトレース技術をサポートできます。このため、開発者はアプリケーション スタックのあらゆるレベルで問題をトレースできます。  トレースは ADO.NET のみで使用できる機能ではありませんが、Microsoft プロバイダーでは、汎用トレース機能および instrumentation API を活用しています。  
+  
+ ADO.NET におけるマネージ トレースの設定と構成の詳細については、「[データ アクセスのトレース](http://msdn.microsoft.com/library/hh880086.aspx)」を参照してください。  
+  
+## 拡張イベント ログの診断情報へのアクセス  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーでは、拡張イベント ログのサーバーの接続のリング バッファーやアプリケーションのパフォーマンス情報から、接続の障害などのクライアントのイベントを診断情報と関連付けることを容易にするため、データ アクセスのトレース \(「[データ アクセスのトレース](http://msdn.microsoft.com/library/hh880086.aspx)」\) が更新されました。  拡張イベント ログの読み取りの詳細については、「[イベント セッション データの表示](http://msdn.microsoft.com/library/hh710068\(SQL.110\).aspx)」を参照してください。  
+  
+ 接続操作では、ADO.NET はクライアント接続 ID を送信します。  接続が失敗した場合、接続リング バッファー \(「[接続リング バッファーを使用して SQL Server 2008 の接続のトラブルシューティングを実行する](http://go.microsoft.com/fwlink/?LinkId=207752)」\) にアクセスし、`ClientConnectionID` フィールドを見つけて、接続エラーについての診断情報を取得できます。  クライアント接続 ID は、エラーが発生した場合にのみリング バッファーに記録されます。  \(接続がログイン前のパケットを送信する前に失敗すると、クライアント接続 ID は生成されません。\) クライアント接続 ID は 16 バイトの GUID です。  拡張イベント セッション内のイベントに `client_connection_id` アクションが追加された場合にも、拡張イベントのターゲット出力のクライアント接続 ID を見つけることができます。  それ以上にクライアントのドライバーの診断について支援が必要な場合は、データ アクセスのトレースを有効にし、接続コマンドを再実行して、データ アクセスのトレースの `ClientConnectionID` フィールドを確認することができます。  
+  
+ `SqlConnection.ClientConnectionID` プロパティを使用して、クライアント接続 ID をプログラムによって取得できます。  
+  
+ `ClientConnectionID` は、正常に接続を確立する <xref:System.Data.SqlClient.SqlConnection> オブジェクトで使用できます。  接続試行が失敗すると、`ClientConnectionID` は `SqlException.ToString` を通じて利用可能になることがあります。  
+  
+ ADO.NET は、スレッド固有のアクティビティ ID も送信します。  TRACK\_CAUSAILITY オプションが有効な状態でセッションが開始されると、アクティビティ ID は拡張イベントのセッションでキャプチャされます。  アクティブな接続のパフォーマンスの問題については、クライアントのデータ アクセスのトレース \(`ActivityID` フィールド\) からアクティビティ ID を取得した後、その拡張イベントの出力のアクティビティ ID を検索できます。  拡張イベントのアクティビティ ID は 16 バイトの GUID \(クライアント接続 ID の GUID と同じではありません\) であり、4 バイトのシーケンス番号が追加されています。  シーケンス番号は、スレッド内で要求の順序を表し、スレッドのバッチと RPC ステートメントの相対的順序を示します。  `ActivityID` は、現在、データ アクセスのトレースが有効な場合、データ アクセスのトレースの構成のワードの 18 番目のビットが有効にされると、オプションとして SQL のバッチ ステートメントと RPC の要求に送信されるようになっています。  
+  
+ 次は、リング バッファーに格納され、RPC とバッチ操作でクライアントから送信されるアクティビティ ID を記録する拡張イベントのセッションを開始するために [!INCLUDE[tsql](../../../../includes/tsql-md.md)] を使用するサンプルです。  
+  
+```  
+create event session MySession on server   
+add event connectivity_ring_buffer_recorded,   
+add event sql_statement_starting (action (client_connection_id)),   
+add event sql_statement_completed (action (client_connection_id)),   
+add event rpc_starting (action (client_connection_id)),   
+add event rpc_completed (action (client_connection_id))  
+add target ring_buffer with (track_causality=on)  
+```  
+  
+## 参照  
+ [.NET Framework のネットワークのトレース](../../../../docs/framework/network-programming/network-tracing.md)   
+ [Tracing and Instrumenting Applications](../../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)   
+ [ADO.NET マネージ プロバイダーおよび DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/data-type-mappings-in-ado-net.md b/docs/framework/data/adonet/data-type-mappings-in-ado-net.md
new file mode 100644
index 00000000000..69031a7b8a3
--- /dev/null
+++ b/docs/framework/data/adonet/data-type-mappings-in-ado-net.md
@@ -0,0 +1,51 @@
+---
+title: "ADO.NET でのデータ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4afab94-ada6-4c77-a73c-41f17bae6b5a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ADO.NET でのデータ型のマッピング
+.NET Framework は共通型システムを基にしています。このシステムは実行時の型の宣言、使用、および管理方法を定義するものです。  値型と参照型の両方から構成されており、これらはすべて <xref:System.Object> 基本型から派生します。  データ ソースを操作するときは、データ型が明示的に指定されていない場合はデータ プロバイダーから推論されます。  たとえば、<xref:System.Data.DataSet> オブジェクトは、特定のデータ ソースには依存しません。  `DataSet` 内のデータはデータ ソースから取得され、変更は `DataAdapter` によってデータ ソースに反映されます。  つまり、`DataAdapter` が `DataSet` 内の <xref:System.Data.DataTable> に、データ ソースからの値を格納すると、`DataTable` 内の列で結果として設定されるデータ型は、データ ソースへの接続を行う目的で使用した [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダー固有の型ではなく、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のデータ型になります。  
+  
+ 同様に、`DataReader` がデータ ソースから値を返すと、結果の値が [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型のローカル変数に格納されます。`DataAdapter` の `Fill` 操作の場合も、`DataReader` の `Get` メソッドの場合も、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーから返された値から推論されます。  
+  
+ 返される値の型がわかっている場合は、推論されるデータ型を使用するのではなく、`DataReader` の型指定されたアクセサー メソッドを使用できます。  型指定されたアクセサー メソッドを使用して [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の特定の型として値を返すと、追加の型変換が不要になるため、パフォーマンスが向上します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーのデータ型の null 値は、`DBNull.Value` で表現されます。  
+  
+## このセクションの内容  
+ [SQL Server データ型のマッピング](../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)  
+ 推論されたデータ型マッピングおよび <xref:System.Data.SqlClient> のデータ アクセサー メソッドを一覧で示します。  
+  
+ [OLE DB データ型のマッピング](../../../../docs/framework/data/adonet/ole-db-data-type-mappings.md)  
+ 推論されたデータ型マッピングおよび <xref:System.Data.OleDb> のデータ アクセサー メソッドを一覧で示します。  
+  
+ [ODBC データ型のマッピング](../../../../docs/framework/data/adonet/odbc-data-type-mappings.md)  
+ 推論されたデータ型マッピングおよび <xref:System.Data.Odbc> のデータ アクセサー メソッドを一覧で示します。  
+  
+ [Oracle データ型のマッピング](../../../../docs/framework/data/adonet/oracle-data-type-mappings.md)  
+ 推論されたデータ型マッピングおよび <xref:System.Data.OracleClient> のデータ アクセサー メソッドを一覧で示します。  
+  
+ [浮動小数点数](../../../../docs/framework/data/adonet/floating-point-numbers.md)  
+ 開発者が浮動小数点数を扱う際の発生頻度の高い問題について説明します。  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [パラメーターおよびパラメーター データ型の構成](../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [共通型システム](../../../../docs/standard/base-types/common-type-system.md)   
+ [Converting Types](http://msdn.microsoft.com/ja-jp/6038316e-bdaf-4f55-8006-407f591ce156)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings.md b/docs/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings.md
new file mode 100644
index 00000000000..d7cd01c6419
--- /dev/null
+++ b/docs/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings.md
@@ -0,0 +1,109 @@
+---
+title: "DataAdapter DataTable と DataColumn のマップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d023260a-a66a-4c39-b8f4-090cd130e730
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataAdapter DataTable と DataColumn のマップ
+**DataAdapter** は、**TableMappings** プロパティに 0 個以上の <xref:System.Data.Common.DataTableMapping> オブジェクトのコレクションを持っています。  **DataTableMapping** はデータ ソースに対するクエリで返されたデータと <xref:System.Data.DataTable> の間のマスターのマップを提供します。  **DataTableMapping** 名は、**DataAdapter** の **Fill** メソッドに **DataTable** 名の代わりとして渡すことができます。  **Authors** テーブルに対して **AuthorsMapping** という名前の **DataTableMapping** を作成する例を次に示します。  
+  
+```vb  
+workAdapter.TableMappings.Add("AuthorsMapping", "Authors")  
+```  
+  
+```csharp  
+workAdapter.TableMappings.Add("AuthorsMapping", "Authors");  
+```  
+  
+ **DataTableMapping** を使用すると、**DataTable** 内でデータベースの列名とは異なる列名を使用できます。  **DataAdapter** はテーブルの更新時にこのマップを使用して列を一致させます。  
+  
+ **DataAdapter** の **Fill** メソッドまたは **Update** メソッドを呼び出すときに **TableName** または **DataTableMapping** 名を指定しなかった場合、**DataAdapter** は "Table" という名前の **DataTableMapping** を検索します。  その **DataTableMapping** が存在しない場合は、**DataTable** の **TableName** が "Table" になります。  "Table" という名前の **DataTableMapping** を作成することで既定の **DataTableMapping** を指定できます。  
+  
+ 次に示すのは、<xref:System.Data.Common> 名前空間から **DataTableMapping** を作成し、それに "Table" という名前を付けて、指定した **DataAdapter** の既定のマップとして設定するコード サンプルです。  この例では、その後、クエリ結果の最初のテーブル \(**Northwind** データベースの **Customers** テーブル\) の列を <xref:System.Data.DataSet> の **Northwind Customers** テーブルにある、よりわかりやすい名前のセットに割り当てます。  割り当てられない列には、データ ソースの列名が使用されます。  
+  
+```vb  
+Dim mapping As DataTableMapping = _  
+  adapter.TableMappings.Add("Table", "NorthwindCustomers")  
+mapping.ColumnMappings.Add("CompanyName", "Company")  
+mapping.ColumnMappings.Add("ContactName", "Contact")  
+mapping.ColumnMappings.Add("PostalCode", "ZIPCode")  
+  
+adapter.Fill(custDS)  
+  
+```  
+  
+```csharp  
+DataTableMapping mapping =   
+  adapter.TableMappings.Add("Table", "NorthwindCustomers");  
+mapping.ColumnMappings.Add("CompanyName", "Company");  
+mapping.ColumnMappings.Add("ContactName", "Contact");  
+mapping.ColumnMappings.Add("PostalCode", "ZIPCode");  
+  
+adapter.Fill(custDS);  
+```  
+  
+ より高度な条件下では、同じ **DataAdapter** を使用して複数の割り当てが設定された複数テーブルの読み込みのサポートが必要な場合があります。  この場合、**DataTableMapping** オブジェクトを追加します。  
+  
+ **Fill** メソッドに **DataSet** のインスタンスと **DataTableMapping** 名が渡されたとき、その名前の割り当てが存在する場合はその名前が使用され、存在しない場合はその名前の **DataTable** が使用されます。  
+  
+ 次に示すのは、**Customers** という名前と **BizTalkSchema** という **DataTable** 名を持つ **DataTableMapping** を作成する例です。  この例では、その後で、SELECT ステートメントで返された行を **BizTalkSchema** **DataTable** に割り当てています。  
+  
+```vb  
+Dim mapping As ITableMapping = _  
+  adapter.TableMappings.Add("Customers", "BizTalkSchema")  
+mapping.ColumnMappings.Add("CustomerID", "ClientID")  
+mapping.ColumnMappings.Add("CompanyName", "ClientName")  
+mapping.ColumnMappings.Add("ContactName", "Contact")  
+mapping.ColumnMappings.Add("PostalCode", "ZIP")  
+  
+adapter.Fill(custDS, "Customers")  
+  
+```  
+  
+```csharp  
+ITableMapping mapping =   
+  adapter.TableMappings.Add("Customers", "BizTalkSchema");  
+mapping.ColumnMappings.Add("CustomerID", "ClientID");  
+mapping.ColumnMappings.Add("CompanyName", "ClientName");  
+mapping.ColumnMappings.Add("ContactName", "Contact");  
+mapping.ColumnMappings.Add("PostalCode", "ZIP");  
+  
+adapter.Fill(custDS, "Customers");  
+```  
+  
+> [!NOTE]
+>  列マップにソースの列名を指定しなかった場合、またはテーブル マップにソース テーブル名を指定しなかった場合は、自動的に既定の名前が生成されます。  列マップにソース列を指定しなかった場合は、列マップに **SourceColumn1** から始まるインクリメンタル既定名 **SourceColumn** *N* が割り当てられます。  テーブル マップにソース テーブル名を指定しなかった場合は、テーブル マップに **SourceTable1** から始まるインクリメンタル既定名 **SourceTable** *N* が割り当てられます。  
+  
+> [!NOTE]
+>  列マップには、**SourceColumn** *N* の命名規則を使用しないこと、また、テーブルの割り当てには **SourceTable** *N* を使用しないことをお勧めします。これは、指定した名前が **ColumnMappingCollection** 内の既存する既定の列マップ名または **DataTableMappingCollection** 内のテーブル マップ名と競合しないようにするためです。  指定した名前が既に存在する場合は、例外がスローされます。  
+  
+## 複数の結果セットの処理  
+ **SelectCommand** が複数のテーブルを返す場合、**Fill** は **DataSet** 内のテーブルに対する、インクリメント値を含むテーブル名を自動的に生成します。これは、指定したテーブル名で開始し、**TableName** *N* の形式で **TableName1** から数値を加算していく名前になります。  自動的に生成されたテーブル名は、テーブルの割り当てを使用して **DataSet** 内でテーブルに指定する名前に変換できます。  たとえば、**Customers** および **Orders** という 2 つのテーブルを返す **SelectCommand** に対して、次の **Fill** 呼び出しを実行します。  
+  
+```  
+adapter.Fill(customersDataSet, "Customers")  
+```  
+  
+ **DataSet** 内に **Customers** および **Customers1** という 2 つのテーブルが作成されます。  テーブル マップを使用して、2 つ目のテーブルに **Customers1** という名前の代わりに **Orders** という名前を付けることができます。  それには、次の例に示すように、ソース テーブル **Customers1** を **DataSet** テーブル **Orders** に割り当てます。  
+  
+```  
+adapter.TableMappings.Add("Customers1", "Orders")  
+adapter.Fill(customersDataSet, "Customers")  
+```  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataadapter-parameters.md b/docs/framework/data/adonet/dataadapter-parameters.md
new file mode 100644
index 00000000000..6be4a7cb18f
--- /dev/null
+++ b/docs/framework/data/adonet/dataadapter-parameters.md
@@ -0,0 +1,179 @@
+---
+title: "DataAdapter パラメーター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f21e6aba-b76d-46ad-a83e-2ad8e0af1e12
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataAdapter パラメーター
+<xref:System.Data.Common.DbDataAdapter> には 4 つのプロパティがあり、データ ソースからデータを取得したりデータ ソースのデータを更新したりするために使用されます。<xref:System.Data.Common.DbDataAdapter.SelectCommand%2A> プロパティは、データ ソースのデータを返します。<xref:System.Data.Common.DbDataAdapter.InsertCommand%2A>、<xref:System.Data.Common.DbDataAdapter.UpdateCommand%2A>、および <xref:System.Data.Common.DbDataAdapter.DeleteCommand%2A> の各プロパティは、データ ソースの変更を管理するために使用されます。  `SelectCommand` プロパティは、`DataAdapter` の `Fill` メソッドを呼び出す前に設定しておく必要があります。  `InsertCommand`、`UpdateCommand`、`DeleteCommand` の各プロパティは、<xref:System.Data.DataTable> 内のデータに加えられた変更に応じて、`DataAdapter` の `Update` メソッドを呼び出す前に設定する必要があります。  たとえば、行が追加された場合には、`Update` を呼び出す前に `InsertCommand` を設定する必要があります。  `Update` によって挿入行、更新行、または削除行が処理されるとき、`DataAdapter` でそれぞれの `Command` プロパティが使用され、アクションが処理されます。  変更された行に関する現在の情報が `Parameters` コレクションを経由して `Command` オブジェクトに渡されます。  
+  
+ データ ソースの行を更新するときは、一意識別子を使用してテーブル内の更新する列を識別する UPDATE ステートメントを呼び出します。  一意識別子は、一般には主キー フィールドの値です。  UPDATE ステートメントでは、次の Transact\-SQL ステートメントに示すように、一意識別子と更新する列および値の両方を含むパラメーターを使用します。  
+  
+```  
+UPDATE Customers SET CompanyName = @CompanyName   
+  WHERE CustomerID = @CustomerID  
+```  
+  
+> [!NOTE]
+>  パラメーターのプレースホルダーの構文はデータ ソースに依存します。  次に、SQL Server のデータ ソースのプレースホルダーの例を示します。  <xref:System.Data.OleDb> パラメーターおよび <xref:System.Data.Odbc> パラメーターのプレースホルダーとして、疑問符 \(?\) を使用します。  
+  
+ この [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の例では、`CustomerID` が `@CustomerID``` パラメーターの値と等しい行の `@CompanyName` パラメーターの値で `CompanyName` フィールドが更新されます。  これらのパラメーターは <xref:System.Data.SqlClient.SqlParameter> オブジェクトの <xref:System.Data.SqlClient.SqlParameter.SourceColumn%2A> プロパティを使用して、変更された行から情報を取得します。  前のサンプル UPDATE ステートメントのパラメーターを次に示します。  このコードは、変数 `adapter` が有効な <xref:System.Data.SqlClient.SqlDataAdapter> オブジェクトを表すことを前提としています。  
+  
+```  
+adapter.Parameters.Add( _  
+  "@CompanyName", SqlDbType.NChar, 15, "CompanyName")  
+Dim parameter As SqlParameter = _  
+  adapter.UpdateCommand.Parameters.Add("@CustomerID", _  
+  SqlDbType.NChar, 5, "CustomerID")  
+parameter.SourceVersion = DataRowVersion.Original  
+```  
+  
+ `Parameters` コレクションの `Add` メソッドは、パラメーター名、データ型、サイズ \(その型に適用可能な場合\)、および <xref:System.Data.Common.DbParameter.SourceColumn%2A> の名前を `DataTable` から受け取ります。  `@CustomerID` パラメーターの <xref:System.Data.Common.DbParameter.SourceVersion%2A> が `Original` に設定されることに注意してください。  この設定により、変更された <xref:System.Data.DataRow> で 1 つまたは複数の識別列の値が変更されている場合に、データ ソース内の既存の行が確実に更新されます。  識別列の値が変更されている場合、`Original` 行の値がデータ ソースの現在の値と一致し、`Current` 行の値に更新済みの値が格納されます。  `@CompanyName` パラメーターの `SourceVersion` は設定されていないため、既定値である `Current` の行の値が使用されます。  
+  
+> [!NOTE]
+>  `DataAdapter` の `Fill` 操作と `DataReader` の `Get` メソッドのどちらの場合も、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーから返された型から推論されます。  Microsoft SQL Server、OLE DB、および ODBC のデータ型から推論される [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型およびアクセサー メソッドについては、「[ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)」を参照してください。  
+  
+## Parameter.SourceColumn、Parameter.SourceVersion  
+ `SourceColumn` および `SourceVersion` が、引数として `Parameter` コンストラクターに渡されるか、既存の `Parameter` のプロパティとして設定されます。  `SourceColumn` は、`Parameter` の値の取得先である <xref:System.Data.DataRow> の <xref:System.Data.DataColumn> の名前です。  `SourceVersion` により、`DataAdapter` で値の取得に使用される `DataRow` のバージョンを指定します。  
+  
+ `SourceVersion` で使用できる <xref:System.Data.DataRowVersion> 列挙型の値を次の表に示します。  
+  
+|DataRowVersion 列挙定数|説明|  
+|-------------------------|--------|  
+|`Current`|このパラメーターは列の現在の値を使用します。  既定値です。|  
+|`Default`|このパラメーターには列の `DefaultValue` を使用します。|  
+|`Original`|このパラメーターは列の元の値を使用します。|  
+|`Proposed`|このパラメーターは提示された値を使用します。|  
+  
+ 次のセクションの `SqlClient` コード サンプルでは、`CustomerID` 列を 2 つのパラメーター `@CustomerID` \(`SET CustomerID = @CustomerID`\) および `@OldCustomerID` \(`WHERE CustomerID = @OldCustomerID`\) の `SourceColumn` として使用する <xref:System.Data.Common.DbDataAdapter.UpdateCommand%2A> のパラメーターを定義します。  `@CustomerID` パラメーターを使用して、**CustomerID** 列を `DataRow` の現在の値に更新します。  そのため、`SourceVersion` が `Current` である `CustomerID` `SourceColumn` が使用されます。  *@OldCustomerID* パラメーターは、データ ソースの現在の行を識別するために使用されています。  一致する列の値がその行の `Original` バージョンで見つかったため、`SourceVersion` が `Original` である同じ `SourceColumn` \(`CustomerID`\) が使用されます。  
+  
+## SqlClient パラメーターの使用  
+ 次のコード サンプルでは、データベースから追加のスキーマ情報を取得するために <xref:System.Data.SqlClient.SqlDataAdapter> を作成し、<xref:System.Data.Common.DataAdapter.MissingSchemaAction%2A> を <xref:System.Data.MissingSchemaAction> に設定する方法を示します。  <xref:System.Data.SqlClient.SqlDataAdapter.SelectCommand%2A> プロパティ、<xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> プロパティ、<xref:System.Data.SqlClient.SqlDataAdapter.UpdateCommand%2A> プロパティ、および <xref:System.Data.SqlClient.SqlDataAdapter.DeleteCommand%2A> プロパティが設定され、各プロパティに対応する <xref:System.Data.SqlClient.SqlParameter> オブジェクトが <xref:System.Data.SqlClient.SqlCommand.Parameters%2A> コレクションに追加されます。  このメソッドは `SqlDataAdapter` オブジェクトを返します。  
+  
+ [!code-csharp[Classic WebData SqlDataAdapter.SqlDataAdapter Example#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/Classic WebData SqlDataAdapter.SqlDataAdapter Example/CS/source.cs#1)]
+ [!code-vb[Classic WebData SqlDataAdapter.SqlDataAdapter Example#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/Classic WebData SqlDataAdapter.SqlDataAdapter Example/VB/source.vb#1)]  
+  
+## OleDb パラメーターのプレースホルダー  
+ <xref:System.Data.OleDb.OleDbDataAdapter> オブジェクトと <xref:System.Data.Odbc.OdbcDataAdapter> オブジェクトの場合は、疑問符 \(?\) のプレースホルダーを使用してパラメーターを特定する必要があります。  
+  
+```vb  
+Dim selectSQL As String = _  
+  "SELECT CustomerID, CompanyName FROM Customers " & _  
+  "WHERE CountryRegion = ? AND City = ?"  
+Dim insertSQL AS String = _  
+  "INSERT INTO Customers (CustomerID, CompanyName) VALUES (?, ?)"  
+Dim updateSQL AS String = _  
+  "UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _  
+  WHERE CustomerID = ?"  
+Dim deleteSQL As String = "DELETE FROM Customers WHERE CustomerID = ?"  
+```  
+  
+```csharp  
+string selectSQL =   
+  "SELECT CustomerID, CompanyName FROM Customers " +  
+  "WHERE CountryRegion = ? AND City = ?";  
+string insertSQL =   
+  "INSERT INTO Customers (CustomerID, CompanyName) " +  
+  "VALUES (?, ?)";  
+string updateSQL =   
+  "UPDATE Customers SET CustomerID = ?, CompanyName = ? " +  
+  "WHERE CustomerID = ? ";  
+string deleteSQL = "DELETE FROM Customers WHERE CustomerID = ?";  
+```  
+  
+ パラメーターとして使用されるクエリ ステートメントは、作成する必要のある入力パラメーターおよび出力パラメーターを定義します。  パラメーターを作成するには、`Parameters.Add` メソッドまたは `Parameter` コンストラクターを使用して、列名、データ型、およびサイズを指定します。  `Integer` などの組み込みのデータ型の場合は、サイズを指定する必要はありません。サイズを指定する場合、既定のサイズを指定することになります。  
+  
+ 次のコード サンプルでは、SQL ステートメントのパラメーターを作成した後、`DataSet` にデータを格納します。  
+  
+## OleDb の例  
+  
+```vb  
+' Assumes that connection is a valid OleDbConnection object.  
+Dim adapter As OleDbDataAdapter = New OleDbDataAdapter   
+  
+Dim selectCMD AS OleDbCommand = New OleDbCommand(selectSQL, connection)  
+adapter.SelectCommand = selectCMD  
+  
+' Add parameters and set values.  
+selectCMD.Parameters.Add( _  
+  "@CountryRegion", OleDbType.VarChar, 15).Value = "UK"  
+selectCMD.Parameters.Add( _  
+  "@City", OleDbType.VarChar, 15).Value = "London"  
+  
+Dim customers As DataSet = New DataSet  
+adapter.Fill(customers, "Customers")  
+  
+```  
+  
+```csharp  
+// Assumes that connection is a valid OleDbConnection object.  
+OleDbDataAdapter adapter = new OleDbDataAdapter();  
+  
+OleDbCommand selectCMD = new OleDbCommand(selectSQL, connection);  
+adapter.SelectCommand = selectCMD;  
+  
+// Add parameters and set values.  
+selectCMD.Parameters.Add(  
+  "@CountryRegion", OleDbType.VarChar, 15).Value = "UK";  
+selectCMD.Parameters.Add(  
+  "@City", OleDbType.VarChar, 15).Value = "London";  
+  
+DataSet customers = new DataSet();  
+adapter.Fill(customers, "Customers");  
+```  
+  
+## Odbc パラメーター  
+  
+```vb  
+' Assumes that connection is a valid OdbcConnection object.  
+Dim adapter As OdbcDataAdapter = New OdbcDataAdapter  
+  
+Dim selectCMD AS OdbcCommand = New OdbcCommand(selectSQL, connection)  
+adapter.SelectCommand = selectCMD  
+  
+' Add Parameters and set values.  
+selectCMD.Parameters.Add("@CountryRegion", OdbcType.VarChar, 15).Value = "UK"  
+selectCMD.Parameters.Add("@City", OdbcType.VarChar, 15).Value = "London"  
+  
+Dim customers As DataSet = New DataSet  
+adapter.Fill(customers, "Customers")  
+  
+```  
+  
+```csharp  
+// Assumes that connection is a valid OdbcConnection object.  
+OdbcDataAdapter adapter = new OdbcDataAdapter();  
+  
+OdbcCommand selectCMD = new OdbcCommand(selectSQL, connection);  
+adapter.SelectCommand = selectCMD;  
+  
+//Add Parameters and set values.  
+selectCMD.Parameters.Add("@CountryRegion", OdbcType.VarChar, 15).Value = "UK";  
+selectCMD.Parameters.Add("@City", OdbcType.VarChar, 15).Value = "London";  
+  
+DataSet customers = new DataSet();  
+adapter.Fill(customers, "Customers");  
+```  
+  
+> [!NOTE]
+>  パラメーターにパラメーター名が指定されない場合、Parameter1 から始まり数字が増分される既定名 Parameter*N* が割り当てられます。  パラメーター名を指定するときには、Parameter*N* という名前付け規則を使用しないことをお勧めします。これは、指定した名前が `ParameterCollection` 内の既存の既定パラメーター名と競合しないようにするためです。  指定した名前が既に存在する場合は、例外がスローされます。  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [ストアド プロシージャでのデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)   
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataadapters-and-datareaders.md b/docs/framework/data/adonet/dataadapters-and-datareaders.md
new file mode 100644
index 00000000000..581cc300b4b
--- /dev/null
+++ b/docs/framework/data/adonet/dataadapters-and-datareaders.md
@@ -0,0 +1,59 @@
+---
+title: "DataAdapter と DataReader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc952ca2-ec19-46ab-9189-15174b52cb74
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataAdapter と DataReader
+ADO.NET の **DataReader** を使用すると、データベースから前方への読み取り専用のストリームを取得できます。  結果はクエリを実行すると返され、**DataReader** の **Read** メソッドを使用して要求するまで、クライアントのネットワーク バッファーに格納されます。  **DataReader** を使用すると、アプリケーションのパフォーマンスが向上します。これは、使用可能になったデータをすぐに取得するためと、一度に 1 つの行しかメモリに格納しない \(既定の設定\) ことによってシステムのオーバーヘッドが軽減されるためです。  
+  
+ <xref:System.Data.Common.DataAdapter> は、データ ソースからデータを取得し、1 つの <xref:System.Data.DataSet> 内でテーブルを設定するために使用されます。  また、`DataAdapter` は、`DataSet` に対して加えられた変更をデータ ソースに反映させます。  `DataAdapter` は .NET Framework データ プロバイダーの `Connection` オブジェクトを使用してデータ ソースに接続し、`Command` オブジェクトを使用してデータ ソースからデータを取得し、変更をデータ ソースに反映させます。  
+  
+ .NET Framework に含まれている各 .NET Framework データ プロバイダーには、<xref:System.Data.Common.DbDataReader> および <xref:System.Data.Common.DbDataAdapter> オブジェクトがあります。.NET Framework Data Provider for OLE DB には <xref:System.Data.OleDb.OleDbDataReader> および <xref:System.Data.OleDb.OleDbDataAdapter> オブジェクトがあります。.NET Framework Data Provider for SQL Server には <xref:System.Data.SqlClient.SqlDataReader> および <xref:System.Data.SqlClient.SqlDataAdapter> オブジェクトがあります。.NET Framework Data Provider for ODBC には、<xref:System.Data.Odbc.OdbcDataReader> および <xref:System.Data.Odbc.OdbcDataAdapter> オブジェクトがあります。.NET Framework Data Provider for Oracle には、<xref:System.Data.OracleClient.OracleDataReader> および <xref:System.Data.OracleClient.OracleDataAdapter> オブジェクトがあります。  
+  
+## このセクションの内容  
+ [DataReader によるデータの取得](../../../../docs/framework/data/adonet/retrieving-data-using-a-datareader.md)  
+ ADO.NET の **DataReader** オブジェクトと、それを使用してデータ ソースから結果ストリームを返す方法について説明します。  
+  
+ [DataAdapter からの DataSet の読み込み](../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)  
+ `DataAdapter` を使用して `DataSet` にテーブル、列、および行を設定する方法について説明します。  
+  
+ [DataAdapter パラメーター](../../../../docs/framework/data/adonet/dataadapter-parameters.md)  
+ `DataAdapter` のコマンド プロパティのパラメーターを使用する方法と、`DataSet` の列の内容をコマンド パラメーターに割り当てる方法について説明します。  
+  
+ [DataSet への既存の制約の追加](../../../../docs/framework/data/adonet/adding-existing-constraints-to-a-dataset.md)  
+ 既存の制約を `DataSet` に追加する方法について説明します。  
+  
+ [DataAdapter DataTable と DataColumn のマップ](../../../../docs/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings.md)  
+ `DataAdapter` の `DataTableMappings` および `ColumnMappings` を設定する方法について説明します。  
+  
+ [クエリ結果のページング](../../../../docs/framework/data/adonet/paging-through-a-query-result.md)  
+ クエリの結果をデータ ページとして表示する例を示します。  
+  
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)  
+ `DataAdapter` を使用して `DataSet` の変更内容を解決してデータベースに戻す方法について説明します。  
+  
+ [DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)  
+ `DataAdapter` のイベントおよびその使用方法について説明します。  
+  
+ [DataAdapter によるバッチ操作の実行](../../../../docs/framework/data/adonet/performing-batch-operations-using-dataadapters.md)  
+ `DataSet` から更新を適用する際に、SQL Server へのラウンド トリップ回数を減らすことにより、アプリケーションのパフォーマンスを向上させる方法について説明します。  
+  
+## 参照  
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/TOC.md b/docs/framework/data/adonet/dataset-datatable-dataview/TOC.md
new file mode 100644
index 00000000000..6cbe7419282
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/TOC.md
@@ -0,0 +1,71 @@
+# [データの並べ替えとフィルター処理](sorting-and-filtering-data.md)
+# [DataSet 内容の XML データとしての書き込み](writing-dataset-contents-as-xml-data.md)
+# [DataSet スキーマの推論プロセスの概要](summary-of-the-dataset-schema-inference-process.md)
+# [Dataset と XmlDataDocument の同期](synchronizing-a-dataset-with-an-xmldatadocument.md)
+# [型指定された DataSet の注釈](annotating-typed-datasets.md)
+# [DataTable の編集](datatable-edits.md)
+# [DataTable スキーマの定義](datatable-schema-definition.md)
+# [DataTable の作成](creating-a-datatable.md)
+# [DataTable への列の追加](adding-columns-to-a-datatable.md)
+# [DataSet の内容のマージ](merging-dataset-contents.md)
+# [DataRelation の移動](navigating-datarelations.md)
+# [DataView イベントの処理](handling-dataview-events.md)
+# [入れ子になっていない要素間のリレーションの指定](specify-relations-between-elements-with-no-nesting.md)
+# [AcceptChanges と RejectChanges](acceptchanges-and-rejectchanges.md)
+# [Load メソッド](the-load-method.md)
+# [DataTable へのデータの追加](adding-data-to-a-datatable.md)
+# [ChildView とリレーション](childviews-and-relations.md)
+# [AutoIncrement 列の作成](creating-autoincrement-columns.md)
+# [XML からの DataSet リレーショナル構造の推論](inferring-dataset-relational-structure-from-xml.md)
+# [DataSet の内容のコピー](copying-dataset-contents.md)
+# [DataRow の削除](datarow-deletion.md)
+# [DataView の作成](creating-a-dataview.md)
+# [DataRelation の追加](adding-datarelations.md)
+# [XML Web サービスからの DataSet の使用](consuming-a-dataset-from-an-xml-web-service.md)
+# [DataTableReaders](datatablereaders.md)
+# [DataRelation の入れ子化](nesting-datarelations.md)
+# [リレーションシップの推論](inferring-relationships.md)
+# [XML スキーマ (XSD) からの DataSet リレーショナル構造の派生](deriving-dataset-relational-structure-from-xml-schema-xsd.md)
+# [DataRow および DataRowView](datarows-and-datarowviews.md)
+# [行エラー情報](row-error-information.md)
+# [DataSet に対する XPath クエリの実行](performing-an-xpath-query-on-a-dataset.md)
+# [要素のテキストの推論](inferring-element-text.md)
+# [推論の制限事項](inference-limitations.md)
+# [テーブルの推論](inferring-tables.md)
+# [DataSets、DataTables、および DataViews](index.md)
+# [入れ子になっているスキーマ要素間の暗黙的なリレーションの割り当て](map-implicit-relations-between-nested-schema-elements.md)
+# [DataView の変更](modifying-dataviews.md)
+# [DataTable イベントの処理](handling-datatable-events.md)
+# [行の検索](finding-rows.md)
+# [DataTable 内のデータの操作](manipulating-data-in-a-datatable.md)
+# [XML スキーマ (XSD) のキー参照制約の DataSet 制約への割り当て](map-keyref-xml-schema-xsd-constraints-to-dataset-constraints.md)
+# [DataSet の作成](creating-a-dataset.md)
+# [XML スキーマ (XSD) の UNIQUE 制約の DataSet 制約への割り当て](map-unique-xml-schema-xsd-constraints-to-dataset-constraints.md)
+# [DataSet への DataTable の追加](adding-a-datatable-to-a-dataset.md)
+# [DataSet のイベント処理](handling-dataset-events.md)
+# [厳密に型指定された DataSet の生成](generating-strongly-typed-datasets.md)
+# [DataTable](datatables.md)
+# [XSD としての DataSet スキーマ情報の書き込み](writing-dataset-schema-information-as-xsd.md)
+# [DataReader の作成](creating-a-datareader.md)
+# [XML からの DataSet の読み込み](loading-a-dataset-from-xml.md)
+# [XML の DataSet スキーマ情報の読み込み](loading-dataset-schema-information-from-xml.md)
+# [XML スキーマ (XSD) 制約の DataSet 制約への割り当て](mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)
+# [DataSet での XML の使用](using-xml-in-a-dataset.md)
+# [主キーの定義](defining-primary-keys.md)
+# [行の状態とバージョン](row-states-and-row-versions.md)
+# [DataView からの DataTable の作成](creating-a-datatable-from-a-dataview.md)
+# [DataTable の制約](datatable-constraints.md)
+# [入れ子になっている要素に指定したリレーションシップの割り当て](map-relations-specified-for-nested-elements.md)
+# [XML スキーマ (XSD) のキー制約の DataSet 制約への割り当て](map-key-xml-schema-xsd-constraints-to-dataset-constraints.md)
+# [DataTable の移動](navigating-datatables.md)
+# [DataTable 内のデータの表示](viewing-data-in-a-datatable.md)
+# [XML スキーマ (XSD) からの DataSet リレーションの生成](generating-dataset-relations-from-xml-schema-xsd.md)
+# [XML スキーマ制約およびリレーションシップ](xml-schema-constraints-and-relationships.md)
+# [DataViews](dataviews.md)
+# [列の推論](inferring-columns.md)
+# [DataSet と XmlDataDocument の同期](dataset-and-xmldatadocument-synchronization.md)
+# [DataViews の管理](managing-dataviews.md)
+# [式列の作成](creating-expression-columns.md)
+# [DataSet への XSLT 変換の適用](applying-an-xslt-transform-to-a-dataset.md)
+# [DiffGram](diffgrams.md)
+# [型指定された DataSet](typed-datasets.md)
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md b/docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md
new file mode 100644
index 00000000000..d7b307c7833
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md
@@ -0,0 +1,69 @@
+---
+title: "AcceptChanges と RejectChanges | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2d1a6fe-31f9-4b83-9728-06c406a3394e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# AcceptChanges と RejectChanges
+<xref:System.Data.DataTable> 内のデータに行われた変更が正確であるかどうかを検証した後で、<xref:System.Data.DataRow>、<xref:System.Data.DataTable>、または <xref:System.Data.DataSet> の <xref:System.Data.DataRow.AcceptChanges%2A> メソッドを使用して、変更を受け入れることができます。変更を受け入れると、**Current** 行値が **Original** 値に設定され、**RowState** プロパティが **Unchanged** に設定されます。  変更を受け入れるかまたは拒否すると、**RowError** 情報が削除され、**HasErrors** プロパティが **false** に設定されます。  変更を受け入れるかまたは拒否した場合、データ ソース内で実行中の更新操作にも影響することがあります。  詳細については、「[DataAdapter によるデータ ソースの更新](../../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)」を参照してください。  
+  
+ **DataTable** に外部キー制約が存在する場合、**AcceptChanges** と **RejectChanges** を使用して受け入れられた変更または拒否された変更は、**ForeignKeyConstraint.AcceptRejectRule** に基づいて **DataRow** の子の行に反映されます。  詳細については、「[DataTable の制約](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md)」を参照してください。  
+  
+ 行にエラーがあるかどうかをチェックし、必要に応じてエラーを解決し、エラーを解決できない場合にはその行を拒否する例を次に示します。  解決されたエラーについては、**RowError** 値が空の文字列にリセットされるため、**HasErrors** プロパティが **false** に設定されます。  エラーのある行がすべて解決または拒否された時点で、**DataTable** 全体に対するすべての変更を受け入れるために、**AcceptChanges** が呼び出されます。  
+  
+```vb  
+If workTable.HasErrors Then  
+  Dim errRow As DataRow  
+  
+  For Each errRow in workTable.GetErrors()  
+  
+    If errRow.RowError = "Total cannot exceed 1000." Then  
+      errRow("Total") = 1000  
+      errRow.RowError = ""    ' Clear the error.  
+    Else  
+      errRow.RejectChanges()  
+    End If  
+  Next  
+End If  
+  
+workTable.AcceptChanges()  
+  
+```  
+  
+```csharp  
+if (workTable.HasErrors)  
+{  
+  
+  foreach (DataRow errRow in workTable.GetErrors())  
+  {  
+    if (errRow.RowError == "Total cannot exceed 1000.")  
+    {  
+      errRow["Total"] = 1000;  
+      errRow.RowError = "";    // Clear the error.  
+    }  
+    else  
+      errRow.RejectChanges();  
+  }  
+}  
+  
+workTable.AcceptChanges();  
+```  
+  
+## 参照  
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataTable>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/adding-a-datatable-to-a-dataset.md b/docs/framework/data/adonet/dataset-datatable-dataview/adding-a-datatable-to-a-dataset.md
new file mode 100644
index 00000000000..d17e5fd2276
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/adding-a-datatable-to-a-dataset.md
@@ -0,0 +1,41 @@
+---
+title: "DataSet への DataTable の追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 556d29a3-8fc9-4e38-b3ee-c188f7e7b155
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet への DataTable の追加
+ADO.NET を使用して <xref:System.Data.DataTable> オブジェクトを作成し、そのオブジェクトを既存の <xref:System.Data.DataSet> に追加できます。  <xref:System.Data.DataTable.PrimaryKey%2A> プロパティと <xref:System.Data.DataColumn.Unique%2A> プロパティを使用することで、<xref:System.Data.DataTable> の制約情報を設定できます。  
+  
+## 例  
+ <xref:System.Data.DataSet> を構築し、<xref:System.Data.DataSet> に新しい <xref:System.Data.DataTable> オブジェクトを追加してから、3 つの <xref:System.Data.DataColumn> オブジェクトをそのテーブルに追加する例を次に示します。  コードの最後では、1 つの列が主キーの列として設定されています。  
+  
+ [!code-csharp[DataWorks Data.DataTableAdd#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks Data.DataTableAdd/CS/source.cs#1)]
+ [!code-vb[DataWorks Data.DataTableAdd#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks Data.DataTableAdd/VB/source.vb#1)]  
+  
+## 大文字と小文字の区別  
+ 大文字と小文字の区別が異なれば、<xref:System.Data.DataSet> に存在する 2 つ以上のテーブルまたはリレーションが同じ名前を持つことができます。  この場合、名前を使用してテーブルとリレーションを参照する際に大文字と小文字が区別されます。  たとえば、<xref:System.Data.DataSet> **dataSet** に **Table1** と **table1** のテーブルがある場合、**Table1** を参照するには **dataSet.Tables\["Table1"\]**、**table1** を参照するには **dataSet.Tables \["table1"\]** と名前を指定します。  このいずれかのテーブルの参照に **dataSet.Tables \["TABLE1"\]** と指定すると、例外が発生します。  
+  
+ 特定の名前を持つテーブルまたはリレーションが 1 つのみの場合、大文字と小文字は区別されません。  たとえば、<xref:System.Data.DataSet> に **Table1** しか存在しない場合は、**dataSet.Tables\["TABLE1"\]** を使用してそのテーブルを参照できます。  
+  
+> [!NOTE]
+>  この動作は <xref:System.Data.DataSet> の <xref:System.Data.DataSet.CaseSensitive%2A> プロパティの影響を受けません。  <xref:System.Data.DataSet.CaseSensitive%2A> プロパティは、<xref:System.Data.DataSet> 内のデータに適用され、並べ替え、検索、フィルター処理、制約の適用などに影響を及ぼします。  
+  
+## 名前空間のサポート  
+ 2.0 より前のバージョンの ADO.NET では、異なる名前空間に存在しているテーブルであっても、2 つのテーブルが同じ名前を持つことはできませんでした。  ADO.NET 2.0 には、この制限はありません。  したがって、<xref:System.Data.DataSet> に、<xref:System.Data.DataTable.Namespace%2A> プロパティ値が異なり、<xref:System.Data.DataTable.TableName%2A> プロパティ値が一致する 2 つのテーブルが存在しても問題ありません。  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/adding-columns-to-a-datatable.md b/docs/framework/data/adonet/dataset-datatable-dataview/adding-columns-to-a-datatable.md
new file mode 100644
index 00000000000..326872dcd1a
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/adding-columns-to-a-datatable.md
@@ -0,0 +1,65 @@
+---
+title: "DataTable への列の追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e85c4a0e-4f3f-458c-b58b-0ddbc06bf974
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable への列の追加
+<xref:System.Data.DataTable> には、テーブルの **Columns** プロパティによって参照される <xref:System.Data.DataColumn> オブジェクトのコレクションが格納されます。  この列のコレクションと制約によって、テーブルのスキーマ \(構造\) が定義されます。  
+  
+ テーブル内で **DataColumn** オブジェクトを作成するには、**DataColumn** コンストラクターを使用するか、または <xref:System.Data.DataColumnCollection> の 1 つである、テーブルの **Columns** プロパティの **Add** メソッドを呼び出します。  **Add** メソッドは、オプションの **ColumnName**、**DataType**、**Expression** の各引数を受け取り、新しい **DataColumn** をコレクションのメンバーとして作成します。  また、このメソッドは既存の **DataColumn** オブジェクトを受け取り、このオブジェクトをコレクションに追加します。必要な場合には、追加された **DataColumn** への参照を返します。  **DataTable** オブジェクトはデータ ソースに依存しないため、**DataColumn** のデータ型を指定するときには、.NET Framework 型が使用されます。  
+  
+ **DataTable** に 4 つの列を追加する例を次に示します。  
+  
+```vb  
+Dim workTable As DataTable = New DataTable("Customers")  
+  
+Dim workCol As DataColumn = workTable.Columns.Add( _  
+    "CustID", Type.GetType("System.Int32"))  
+workCol.AllowDBNull = false  
+workCol.Unique = true  
+  
+workTable.Columns.Add("CustLName", Type.GetType("System.String"))  
+workTable.Columns.Add("CustFName", Type.GetType("System.String"))  
+workTable.Columns.Add("Purchases", Type.GetType("System.Double"))  
+  
+```  
+  
+```csharp  
+DataTable workTable = new DataTable("Customers");  
+  
+DataColumn workCol = workTable.Columns.Add("CustID", typeof(Int32));  
+workCol.AllowDBNull = false;  
+workCol.Unique = true;  
+  
+workTable.Columns.Add("CustLName", typeof(String));  
+workTable.Columns.Add("CustFName", typeof(String));  
+workTable.Columns.Add("Purchases", typeof(Double));  
+```  
+  
+ この例では、**DBNull** 値を許可せずに値を一意の値に制約するように、**CustID** 列のプロパティが設定されています。  ただし、**CustID** 列をテーブルの主キー列として定義した場合、**AllowDBNull** プロパティは自動的に **false** に設定され、**Unique** プロパティは自動的に **true** に設定されます。  詳細については、「[主キーの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md)」を参照してください。  
+  
+> [!CAUTION]
+>  列名が指定されていない列を **DataColumnCollection** に追加する場合、この列には "Column1" から始まるインクリメンタル既定名 Column*N* が割り当てられます。  列名を指定するときには、"Column*N*" の命名規則を使用しないことをお勧めします。これは、指定した名前が **DataColumnCollection** に既に存在する既定の列名と競合しないようにするためです。  指定した名前が既に存在する場合は、例外がスローされます。  
+  
+ <xref:System.Xml.XLinq.XElement> を、<xref:System.Data.DataTable> 内の <xref:System.Data.DataColumn> の <xref:System.Data.DataColumn.DataType%2A> として使用すると、データを読み取るときに XML シリアル化が機能しません。  たとえば、`DataTable.WriteXml` メソッドを使用して <xref:System.Xml.XmlDocument> を書き込むと、XML へのシリアル化で <xref:System.Xml.XLinq.XElement> に親ノードが追加されます。  この問題に対処するには、<xref:System.Xml.XLinq.XElement> の代わりに <xref:System.Data.SqlTypes.SqlXml> 型を使用します。  `ReadXml` および `WriteXml` は、<xref:System.Data.SqlTypes.SqlXml> で適切に機能します。  
+  
+## 参照  
+ <xref:System.Data.DataColumn>   
+ <xref:System.Data.DataColumnCollection>   
+ <xref:System.Data.DataTable>   
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/adding-data-to-a-datatable.md b/docs/framework/data/adonet/dataset-datatable-dataview/adding-data-to-a-datatable.md
new file mode 100644
index 00000000000..f6b8d685308
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/adding-data-to-a-datatable.md
@@ -0,0 +1,103 @@
+---
+title: "DataTable へのデータの追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6aa8474-7bde-48f7-949d-20dc38a1625b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable へのデータの追加
+<xref:System.Data.DataTable> を作成し、列と制約を使用してそのテーブルの構造を定義した後で、テーブルに新しいデータ行を追加できます。  新しい行を追加するには、新しい変数を <xref:System.Data.DataRow> 型として宣言します。  <xref:System.Data.DataTable.NewRow%2A> メソッドを呼び出すと、新しい **DataRow** オブジェクトが返されます。  次に、**DataTable** は、<xref:System.Data.DataColumnCollection> での定義に従って、テーブルの構造に基づいて **DataRow** オブジェクトを作成します。  
+  
+ **NewRow** メソッドを呼び出して新しい行を作成する例を次に示します。  
+  
+```vb  
+Dim workRow As DataRow = workTable.NewRow()  
+  
+```  
+  
+```csharp  
+DataRow workRow = workTable.NewRow();  
+```  
+  
+ その後でインデックスまたは列名を使用して、新しく追加した行を操作する例を次に示します。  
+  
+```vb  
+workRow("CustLName") = "Smith"  
+workRow(1) = "Smith"  
+  
+```  
+  
+```csharp  
+workRow["CustLName"] = "Smith";  
+workRow[1] = "Smith";  
+```  
+  
+ 新しい行にデータを挿入した後で **Add** メソッドを使用して <xref:System.Data.DataRowCollection> に行を追加するコードを次に示します。  
+  
+```vb  
+workTable.Rows.Add(workRow)  
+  
+```  
+  
+```csharp  
+workTable.Rows.Add(workRow);  
+```  
+  
+ **Add** メソッドを呼び出して <xref:System.Object> 型の値の配列を渡すことにより、新しい行を追加する別の例を次に示します。  
+  
+```vb  
+workTable.Rows.Add(new Object() {1, "Smith"})  
+  
+```  
+  
+```csharp  
+workTable.Rows.Add(new Object[] {1, "Smith"});  
+```  
+  
+ **Object** 型の値の配列を **Add** メソッドに渡すと、テーブル内に新しい行が作成され、その行の列値がオブジェクト配列の値に設定されます。  配列内の値は、テーブル内での列の順序に基づいて、列に順次的に割り当てられます。  
+  
+ 新しく作成した **Customers** テーブルに 10 行を追加する例を次に示します。  
+  
+```vb  
+Dim workRow As DataRow  
+Dim i As Integer  
+  
+For i = 0 To 9  
+  workRow = workTable.NewRow()  
+  workRow(0) = i  
+  workRow(1) = "CustName" & I.ToString()  
+  workTable.Rows.Add(workRow)  
+Next  
+  
+```  
+  
+```csharp  
+DataRow workRow;  
+  
+for (int i = 0; i <= 9; i++)   
+{  
+  workRow = workTable.NewRow();  
+  workRow[0] = i;  
+  workRow[1] = "CustName" + i.ToString();  
+  workTable.Rows.Add(workRow);  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataColumnCollection>   
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataRowCollection>   
+ <xref:System.Data.DataTable>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md b/docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md
new file mode 100644
index 00000000000..22c17928b4a
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md
@@ -0,0 +1,44 @@
+---
+title: "DataRelation の追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4a564fb-c1c4-4135-b6c2-b030e51195e4
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataRelation の追加
+複数の <xref:System.Data.DataTable> オブジェクトを含む <xref:System.Data.DataSet> では、<xref:System.Data.DataRelation> オブジェクトを使用して 1 つのテーブルを別のテーブルに関連付けたり、テーブル間を移動したり、関連付けたテーブルから子または親の行を戻したりできます。  
+  
+ **DataRelation** の作成に必要な引数は、作成する **DataRelation** の名前、およびそのリレーションシップで親子の列となる列への 1 つ以上の <xref:System.Data.DataColumn> 参照の配列です。  **DataRelation** の作成後、DataRelation を使用してテーブル間の移動および値の取得を行うことができます。  
+  
+ <xref:System.Data.DataSet> への **DataRelation** の追加は、既定では <xref:System.Data.UniqueConstraint> が親テーブルに、<xref:System.Data.ForeignKeyConstraint> が子テーブルに追加されます。  上記の既定の制約の詳細については、「[DataTable の制約](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md)」を参照してください。  
+  
+ <xref:System.Data.DataSet> にある 2 つの <xref:System.Data.DataTable> オブジェクトを使用して、**DataRelation** を作成するコード サンプルを次に示します。  各 <xref:System.Data.DataTable> には、2 つの <xref:System.Data.DataTable> オブジェクト間のリンクとなる **CustID** という名前の列があります。  例では、単一の **DataRelation** が <xref:System.Data.DataSet> の **Relations** コレクションに追加されます。  例にある最初の引数には、作成する **DataRelation** の名前を指定します。  2 番目の引数によって親の **DataColumn** が、3 番目の引数によって子の **DataColumn** が設定されます。  
+  
+```vb  
+customerOrders.Relations.Add("CustOrders", _  
+  customerOrders.Tables("Customers").Columns("CustID"), _  
+  customerOrders.Tables("Orders").Columns("CustID"))  
+```  
+  
+```csharp  
+customerOrders.Relations.Add("CustOrders",  
+  customerOrders.Tables["Customers"].Columns["CustID"],  
+  customerOrders.Tables["Orders"].Columns["CustID"]);  
+```  
+  
+ **DataRelation** には、**入れ子になった**プロパティもあります。**true** に設定すると、<xref:System.Data.DataSet.WriteXml%2A> を使用して XML 要素として書き込むときに、親テーブルの関連付けられた行の中で子テーブルの行が入れ子になります。  詳細については、「[DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)」を参照してください。  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/annotating-typed-datasets.md b/docs/framework/data/adonet/dataset-datatable-dataview/annotating-typed-datasets.md
new file mode 100644
index 00000000000..6d88e748b0d
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/annotating-typed-datasets.md
@@ -0,0 +1,240 @@
+---
+title: "型指定された DataSet の注釈 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f82aaa62-321e-4c8a-b51b-9d1114700170
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# 型指定された DataSet の注釈
+注釈を使用すると、基になるスキーマを変更せずに型指定された <xref:System.Data.DataSet> の要素の名前を変更できます。  基になるスキーマの要素の名前を変更すると、データ ソースにあるオブジェクトへの参照が失われるだけでなく、型指定された **DataSet** がデータ ソースにないオブジェクトを参照することになります。  
+  
+ 注釈を使用すると、基になるスキーマを変更せずに、型指定された **DataSet** のオブジェクトをわかりやすい名前にカスタマイズできるため、コードが読みやすくなり、型指定された **DataSet** がクライアントで使用しやすくなります。  たとえば、次の **Northwind** データベースの **Customers** テーブルのスキーマ要素は、**CustomersRow** という名前の **DataRow** オブジェクト名および **Customers** という名前の <xref:System.Data.DataRowCollection> となります。  
+  
+```  
+<xs:element name="Customers">  
+  <xs:complexType>  
+    <xs:sequence>  
+      <xs:element name="CustomerID" type="xs:string" minOccurs="0" />  
+    </xs:sequence>  
+  </xs:complexType>  
+</xs:element>  
+```  
+  
+ **Customers** という **DataRowCollection** 名は、クライアント コードでは意味がありますが、**CustomersRow** という **DataRow** 名は単一のオブジェクトであるため、誤解が生じます。  また、一般的なシナリオでは、CustomersRow オブジェクトは **Row** ID を指定せずに参照されるため、単に **Customer** オブジェクトとして参照されます。  この問題を解決するには、スキーマに注釈を付け、**DataRow** オブジェクトと **DataRowCollection** オブジェクトに新しい名前を指定します。  上記のスキーマに注釈を付けたスキーマを次に示します。  
+  
+```  
+<xs:element name="Customers" codegen:typedName="Customer" codegen:typedPlural="Customers">  
+  <xs:complexType>  
+    <xs:sequence>  
+      <xs:element name="CustomerID" type="xs:string" minOccurs="0" />  
+    </xs:sequence>  
+  </xs:complexType>  
+</xs:element>  
+```  
+  
+ **Customer** という **typedName** 値を指定すると、**Customer** という **DataRow** オブジェクト名になります。  **Customers** という **typedPlural** 値を指定すると、**Customers** という **DataRowCollection** 名が保存されます。  
+  
+ 使用できる注釈を次の表に示します。  
+  
+|注釈|説明|  
+|--------|--------|  
+|**typedName**|オブジェクト名。|  
+|**typedPlural**|オブジェクトのコレクション名。|  
+|**typedParent**|親のリレーションシップで参照される場合のオブジェクト名。|  
+|**typedChildren**|子のリレーションシップからオブジェクトを返すメソッド名。|  
+|**nullValue**|基になる値が **DBNull** の場合の値。  **nullValue** の注釈については、次の表を参照してください。  既定値は **\_throw** です。|  
+  
+ **nullValue** 注釈に指定できる値を次の表に示します。  
+  
+|nullValue の値|説明|  
+|------------------|--------|  
+|*Replacement Value*|返される値を指定します。  返された値は要素の型と一致する必要があります。  たとえば、整数型フィールドが null の場合に 0 を返すために `nullValue="0"` を使用します。|  
+|**\_throw**|例外をスローします。  既定値です。|  
+|**\_null**|プリミティブ型が見つかった場合は、null 参照を返すか、例外をスローします。|  
+|**\_empty**|文字列の場合は **String.Empty** を、それ以外の場合は空のコンストラクターから作成されたオブジェクトを返します。  プリミティブ型が見つかった場合、例外をスローします。|  
+  
+ 型指定された **DataSet** のオブジェクトの既定値と使用できる注釈を次の表に示します。  
+  
+|オブジェクト\/メソッド\/イベント|既定値|注釈|  
+|------------------------|---------|--------|  
+|**DataTable**|TableNameDataTable|typedPlural|  
+|**DataTable** のメソッド|NewTableNameRow<br /><br /> AddTableNameRow<br /><br /> DeleteTableNameRow|typedName|  
+|**DataRowCollection**|TableName|typedPlural|  
+|**DataRow**|TableNameRow|typedName|  
+|**DataColumn**|DataTable.ColumnNameColumn<br /><br /> DataRow.ColumnName|typedName|  
+|**プロパティ**|PropertyName|typedName|  
+|**Child** Accessor|GetChildTableNameRows|typedChildren|  
+|**Parent** Accessor|TableNameRow|typedParent|  
+|**DataSet** イベント|TableNameRowChangeEvent<br /><br /> TableNameRowChangeEventHandler|typedName|  
+  
+ 型指定された **DataSet** の注釈を使用するには、XML スキーマ定義言語 \(XSD\) スキーマに次の **xmlns** 参照をインクルードする必要があります。  \(データベース テーブルから xsd を作成するには、「<xref:System.Data.DataSet.WriteXmlSchema%2A>」または「[Visual Studio でのデータセットの操作](http://msdn.microsoft.com/library/8bw9ksd6.aspx)」 を参照してください。\)  
+  
+```  
+xmlns:codegen="urn:schemas-microsoft-com:xml-msprop"  
+```  
+  
+ **Orders** テーブルとのリレーションを持つ **Northwind** データベースの **Customers** テーブルを公開する、注釈の付いたスキーマのサンプルを次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema id="CustomerDataSet"   
+      xmlns:codegen="urn:schemas-microsoft-com:xml-msprop"  
+      xmlns=""   
+      xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+      xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  <xs:element name="CustomerDataSet" msdata:IsDataSet="true">  
+    <xs:complexType>  
+      <xs:choice maxOccurs="unbounded">  
+        <xs:element name="Customers" codegen:typedName="Customer"  
+codegen:typedPlural="Customers">  
+          <xs:complexType>  
+            <xs:sequence>  
+              <xs:element name="CustomerID"  
+codegen:typedName="CustomerID" type="xs:string" minOccurs="0" />  
+              <xs:element name="CompanyName"  
+codegen:typedName="CompanyName" type="xs:string" minOccurs="0" />  
+              <xs:element name="Phone" codegen:typedName="Phone"  
+codegen:nullValue="" type="xs:string" minOccurs="0" />  
+            </xs:sequence>  
+          </xs:complexType>  
+        </xs:element>  
+        <xs:element name="Orders" codegen:typedName="Order"  
+codegen:typedPlural="Orders">  
+          <xs:complexType>  
+            <xs:sequence>  
+              <xs:element name="OrderID" codegen:typedName="OrderID"  
+type="xs:int" minOccurs="0" />  
+              <xs:element name="CustomerID"  
+codegen:typedName="CustomerID"  
+                 codegen:nullValue="" type="xs:string" minOccurs="0" />  
+              <xs:element name="EmployeeID"  
+codegen:typedName="EmployeeID" codegen:nullValue="0"   
+type="xs:int" minOccurs="0" />  
+              <xs:element name="OrderAdapter"  
+codegen:typedName="OrderAdapter"  
+codegen:nullValue="1980-01-01T00:00:00"   
+type="xs:dateTime" minOccurs="0" />  
+            </xs:sequence>  
+          </xs:complexType>  
+        </xs:element>  
+      </xs:choice>  
+    </xs:complexType>  
+    <xs:unique name="Constraint1">  
+      <xs:selector xpath=".//Customers" />  
+      <xs:field xpath="CustomerID" />  
+    </xs:unique>  
+    <xs:keyref name="CustOrders" refer="Constraint1"  
+codegen:typedParent="Customer" codegen:typedChildren="GetOrders">  
+      <xs:selector xpath=".//Orders" />  
+      <xs:field xpath="CustomerID" />  
+    </xs:keyref>  
+  </xs:element>  
+</xs:schema>  
+```  
+  
+ サンプル スキーマから作成された厳密に型指定された **DataSet** を次のコード サンプルで使用します。  また、一方の <xref:System.Data.SqlClient.SqlDataAdapter> を使用して **Customers** テーブルを、他方の <xref:System.Data.SqlClient.SqlDataAdapter> を使用して **Orders** テーブルを作成します。  厳密に型指定された **DataSet** により、**DataRelations** が定義されます。  
+  
+```vb  
+' Assumes a valid SqlConnection object named connection.  
+Dim customerAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+    "SELECT CustomerID, CompanyName, Phone FROM Customers", &  
+    connection)  
+Dim orderAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+    "SELECT OrderID, CustomerID, EmployeeID, OrderAdapter FROM Orders", &  
+    connection)  
+  
+' Populate a strongly typed DataSet.  
+connection.Open()  
+Dim customers As CustomerDataSet = New CustomerDataSet()  
+customerAdapter.Fill(customers, "Customers")  
+orderAdapter.Fill(customers, "Orders")  
+connection.Close()  
+  
+' Add a strongly typed event.  
+AddHandler customers.Customers.CustomerChanged, &  
+    New CustomerDataSet.CustomerChangeEventHandler( _  
+    AddressOf OnCustomerChanged)  
+  
+' Add a strongly typed DataRow.  
+Dim newCustomer As CustomerDataSet.Customer = _  
+    customers.Customers.NewCustomeromer()  
+newCustomer.CustomerID = "NEW01"  
+newCustomer.CompanyName = "My New Company"  
+customers.Customers.AddCustomer(newCustomer)  
+  
+' Navigate the child relation.  
+Dim customer As CustomerDataSet.Customer  
+Dim order As CustomerDataSet.Order  
+  
+For Each customer In customers.Customers  
+  Console.WriteLine(customer.CustomerID)  
+  For Each order In customer.GetOrders()  
+    Console.WriteLine(vbTab & order.OrderID)  
+  Next  
+Next  
+  
+Private Shared Sub OnCustomerChanged( _  
+    sender As Object, e As CustomerDataSet.CustomerChangeEvent)  
+  
+End Sub  
+  
+```  
+  
+```csharp  
+// Assumes a valid SqlConnection object named connection.  
+SqlDataAdapter customerAdapter = new SqlDataAdapter(  
+    "SELECT CustomerID, CompanyName, Phone FROM Customers",  
+    connection);  
+SqlDataAdapter orderAdapter = new SqlDataAdapter(  
+    "SELECT OrderID, CustomerID, EmployeeID, OrderAdapter FROM Orders",   
+    connection);  
+  
+// Populate a strongly typed DataSet.  
+connection.Open();  
+CustomerDataSet customers = new CustomerDataSet();  
+customerAdapter.Fill(customers, "Customers");  
+orderAdapter.Fill(customers, "Orders");  
+connection.Close();  
+  
+// Add a strongly typed event.  
+customers.Customers.CustomerChanged += new   
+  CustomerDataSet.CustomerChangeEventHandler(OnCustomerChanged);  
+  
+// Add a strongly typed DataRow.  
+CustomerDataSet.Customer newCustomer =   
+    customers.Customers.NewCustomeromer();  
+newCustomer.CustomerID = "NEW01";  
+newCustomer.CompanyName = "My New Company";  
+customers.Customers.AddCustomer(newCustomer);  
+  
+// Navigate the child relation.  
+foreach(CustomerDataSet.Customer customer in customers.Customers)  
+{  
+  Console.WriteLine(customer.CustomerID);  
+  foreach(CustomerDataSet.Order order in customer.GetOrders())  
+    Console.WriteLine("\t" + order.OrderID);  
+}  
+  
+protected static void OnCustomerChanged(object sender, CustomerDataSet.CustomerChangeEvent e)  
+    {  
+  
+    }  
+```  
+  
+## 参照  
+ <xref:System.Data.DataColumnCollection>   
+ <xref:System.Data.DataSet>   
+ [型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/applying-an-xslt-transform-to-a-dataset.md b/docs/framework/data/adonet/dataset-datatable-dataview/applying-an-xslt-transform-to-a-dataset.md
new file mode 100644
index 00000000000..2d941ac07d1
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/applying-an-xslt-transform-to-a-dataset.md
@@ -0,0 +1,132 @@
+---
+title: "DataSet への XSLT 変換の適用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09f2e4ee-1d08-4ba8-8936-83394fee319d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet への XSLT 変換の適用
+<xref:System.Data.DataSet> の **WriteXml** メソッドを使用すると、**DataSet** の内容を XML データとして書き込むことができます。  一般的な作業は、XSLT \(XSL Transformation\) を使用してこの XML を別の形式へ変換する操作です。  ただし **DataSet** を <xref:System.Xml.XmlDataDocument> と同期することで、最初に **WriteXml** を使用して **DataSet** の内容を XML データとして書き込む操作を実行せずに、**DataSet** の内容に XSLT スタイルシートを適用できます。  
+  
+ **DataSet** にテーブルとリレーションシップを格納し、**DataSet** を **XmlDataDocument** と同期し、XSLT スタイルシートを使用して **DataSet** の一部を HTML ファイルとして書き込む例を次に示します。  次のコードは、XSLT スタイルシートの内容です。  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">  
+  
+<xsl:template match="CustomerOrders">  
+  <HTML>  
+  <STYLE>  
+  BODY {font-family:verdana;font-size:9pt}  
+  TD   {font-size:8pt}  
+  </STYLE>  
+    <BODY>  
+    <TABLE BORDER="1">  
+      <xsl:apply-templates select="Customers"/>  
+    </TABLE>  
+    </BODY>  
+  </HTML>  
+</xsl:template>  
+  
+<xsl:template match="Customers">  
+    <TR><TD>  
+      <xsl:value-of select="ContactName"/>, <xsl:value-of select="Phone"/><BR/>  
+    </TD></TR>  
+      <xsl:apply-templates select="Orders"/>  
+</xsl:template>  
+  
+<xsl:template match="Orders">  
+  <TABLE BORDER="1">  
+    <TR><TD valign="top"><B>Order:</B></TD><TD valign="top"><xsl:value-of select="OrderID"/></TD></TR>  
+    <TR><TD valign="top"><B>Date:</B></TD><TD valign="top"><xsl:value-of select="OrderDate"/></TD></TR>  
+    <TR><TD valign="top"><B>Ship To:</B></TD>  
+        <TD valign="top"><xsl:value-of select="ShipName"/><BR/>  
+        <xsl:value-of select="ShipAddress"/><BR/>  
+        <xsl:value-of select="ShipCity"/>, <xsl:value-of select="ShipRegion"/>  <xsl:value-of select="ShipPostalCode"/><BR/>  
+        <xsl:value-of select="ShipCountry"/></TD></TR>  
+  </TABLE>  
+</xsl:template>  
+  
+</xsl:stylesheet>  
+```  
+  
+ 次のコードは、**DataSet** にデータを格納し、XSLT スタイル シートを適用します。  
+  
+> [!NOTE]
+>  リレーションシップが含まれている **DataSet** にスタイル シートを適用する場合は、入れ子になっているリレーションシップごとに <xref:System.Data.DataRelation> の **Nested** プロパティを **true** に設定すると、パフォーマンスが最大になります。  これにより、階層を自然な順番で上から下へと進みながらデータを変換する XSLT スタイル シートを利用できるようになります。パフォーマンスに大きく影響する XPath ロケーション軸 \(たとえば、スタイル シートのノード テスト式での preceding\-sibling や following\-sibling\) を使用して階層をたどる必要はなくなります。  入れ子になったリレーションの詳細については、「[DataRelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)」を参照してください。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+Dim dataSet As DataSet = New DataSet("CustomerOrders")  
+  
+Dim customerAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM Customers", connection)  
+customerAdapter.Fill(dataSet, "Customers")  
+  
+Dim orderAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM Orders", connection)  
+orderAdapter.Fill(dataSet, "Orders")  
+  
+connection.Close()  
+  
+dataSet.Relations.Add("CustOrders", _  
+dataSet.Tables("Customers").Columns("CustomerID"), _  
+dataSet.Tables("Orders").Columns("CustomerID")).Nested = true  
+  
+Dim xmlDoc As XmlDataDocument = New XmlDataDocument(dataSet)   
+  
+Dim xslTran As XslTransform = New XslTransform  
+xslTran.Load("transform.xsl")  
+  
+Dim writer As XmlTextWriter = New XmlTextWriter( _  
+  "xslt_output.html", System.Text.Encoding.UTF8)  
+  
+xslTran.Transform(xmlDoc, Nothing, writer)  
+writer.Close()  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+connection.Open();  
+  
+DataSet custDS = new DataSet("CustomerDataSet");  
+  
+SqlDataAdapter customerAdapter = new SqlDataAdapter(  
+  "SELECT * FROM Customers", connection);  
+customerAdapter.Fill(custDS, "Customers");  
+  
+SqlDataAdapter orderAdapter = new SqlDataAdapter(  
+  "SELECT * FROM Orders", connection);  
+orderAdapter.Fill(custDS, "Orders");  
+  
+connection.Close();  
+  
+custDS.Relations.Add("CustOrders",  
+  custDS.Tables["Customers"].Columns["CustomerID"],  
+                     custDS.Tables["Orders"].Columns["CustomerID"]).Nested = true;  
+  
+XmlDataDocument xmlDoc = new XmlDataDocument(custDS);   
+  
+XslTransform xslTran = new XslTransform();  
+xslTran.Load("transform.xsl");  
+  
+XmlTextWriter writer = new XmlTextWriter("xslt_output.html",   
+  System.Text.Encoding.UTF8);  
+  
+xslTran.Transform(xmlDoc, null, writer);  
+writer.Close();  
+```  
+  
+## 参照  
+ [DataSet と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/childviews-and-relations.md b/docs/framework/data/adonet/dataset-datatable-dataview/childviews-and-relations.md
new file mode 100644
index 00000000000..be2a7e362fb
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/childviews-and-relations.md
@@ -0,0 +1,86 @@
+---
+title: "ChildView とリレーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d475d356-6abb-4701-8fd1-2906fb93dfba
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ChildView とリレーション
+<xref:System.Data.DataSet> 内のテーブル間にリレーションシップが存在する場合は、このリレーションシップの子テーブルの行が含まれている <xref:System.Data.DataView> を作成できます。このような DataView を作成するには、親テーブルの行に対して <xref:System.Data.DataRowView> の <xref:System.Data.DataRowView.CreateChildView%2A> メソッドを使用します。  たとえば、次のコードは、**CategoryName** と **ProductName** によってデータをアルファベット順に並べ替えられた **Categories** およびこのテーブルに関連する **Products** を表示します。  
+  
+```vb  
+Dim catTable As DataTable = catDS.Tables("Categories")  
+Dim prodTable As DataTable = catDS.Tables("Products")  
+  
+' Create a relation between the Categories and Products tables.  
+Dim relation As DataRelation = catDS.Relations.Add("CatProdRel", _  
+  catTable.Columns("CategoryID"), _  
+  prodTable.Columns("CategoryID"))  
+  
+' Create DataViews for the Categories and Products tables.  
+Dim catView As DataView = New DataView(catTable, "", _  
+  "CategoryName", DataViewRowState.CurrentRows)  
+Dim prodView As DataView  
+  
+' Iterate through the Categories table.  
+Dim catDRV, prodDRV As DataRowView  
+  
+For Each catDRV In catView  
+  Console.WriteLine(catDRV("CategoryName"))  
+  
+  ' Create a DataView of the child product records.  
+  prodView = catDRV.CreateChildView(relation)  
+  prodView.Sort = "ProductName"  
+  
+  For Each prodDRV In prodView  
+    Console.WriteLine(vbTab & prodDRV("ProductName"))  
+  Next  
+Next  
+  
+```  
+  
+```csharp  
+DataTable catTable = catDS.Tables["Categories"];  
+DataTable prodTable = catDS.Tables["Products"];  
+  
+// Create a relation between the Categories and Products tables.  
+DataRelation relation = catDS.Relations.Add("CatProdRel",   
+  catTable.Columns["CategoryID"],  
+                                                            prodTable.Columns["CategoryID"]);  
+  
+// Create DataViews for the Categories and Products tables.  
+DataView catView = new DataView(catTable, "", "CategoryName",   
+  DataViewRowState.CurrentRows);  
+DataView prodView;  
+  
+// Iterate through the Categories table.  
+foreach (DataRowView catDRV in catView)  
+{  
+  Console.WriteLine(catDRV["CategoryName"]);  
+  
+  // Create a DataView of the child product records.  
+  prodView = catDRV.CreateChildView(relation);  
+  prodView.Sort = "ProductName";  
+  
+  foreach (DataRowView prodDRV in prodView)  
+    Console.WriteLine("\t" + prodDRV["ProductName"]);  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataView>   
+ <xref:System.Data.DataRowView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/consuming-a-dataset-from-an-xml-web-service.md b/docs/framework/data/adonet/dataset-datatable-dataview/consuming-a-dataset-from-an-xml-web-service.md
new file mode 100644
index 00000000000..b1bb8b38f35
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/consuming-a-dataset-from-an-xml-web-service.md
@@ -0,0 +1,276 @@
+---
+title: "XML Web サービスからの DataSet の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9edd6b71-0fa5-4649-ae1d-ac1c12541019
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML Web サービスからの DataSet の使用
+<xref:System.Data.DataSet> は、非接続型デザインで設計されています。インターネットで簡単にデータを転送するのが目的の一部です。  **DataSet** は、**DataSet** の内容を XML Web サービスからクライアントに \(およびその逆方向に\) ストリーム転送するためのコードを追加せずに XML Web サービスへの入力または出力として指定できるという点で、"シリアル化可能" です。  **DataSet** は、DiffGram 形式を使用して暗黙に XML ストリームに変換され、ネットワーク経由で送信されます。その後、受信側で XML ストリームから **DataSet** として再構築されます。  これにより、XML Web サービスを使用してリレーショナル データを送信および返送する、たいへん簡単で柔軟性のある方法が提供されます。  DiffGram 形式の詳細については、「[DiffGram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)」を参照してください。  
+  
+ **DataSet** を使用してリレーショナル データ \(変更データを含む\) を転送し、更新内容を元のデータ ソースに反映させる XML Web サービスと XML Web サービスのクライアントを作成する手順を次の例に示します。  
+  
+> [!NOTE]
+>  XML Web サービスを作成する場合は、常にセキュリティへの影響を考慮することをお勧めします。  XML Web サービスのセキュリティについては、「[Securing XML Web Services Created Using ASP.NET](http://msdn.microsoft.com/ja-jp/354b2ab1-2782-4542-b32a-dc560178b90c)」を参照してください。  
+  
+### DataSet を返し、処理する XML Web サービスを作成するには、次のようにします。  
+  
+1.  XML Web サービスを作成します。  
+  
+     この例では、データ \(ここでは、**Northwind** データベースの顧客リスト\) を返し、元のデータ ソースに反映させるデータ更新が格納されている **DataSet** を受け取る XML Web サービスを作成します。  
+  
+     この XML Web サービスは 2 つのメソッドを公開しています。顧客リストを返す **GetCustomers** と、更新をデータ ソースに反映させる **UpdateCustomers** です。  この XML Web サービスは、Web サーバー上の DataSetSample.asmx というファイルに格納されます。  次のコードは、DataSetSample.asmx の内容の概要を示しています。  
+  
+    ```vb  
+    <% @ WebService Language = "vb" Class = "Sample" %>  
+    Imports System  
+    Imports System.Data  
+    Imports System.Data.SqlClient  
+    Imports System.Web.Services  
+  
+    <WebService(Namespace:="http://microsoft.com/webservices/")> _  
+    Public Class Sample  
+  
+    Public connection As SqlConnection = New SqlConnection("Data Source=(local);Integrated Security=SSPI;Initial Catalog=Northwind")  
+  
+      <WebMethod( Description := "Returns Northwind Customers", EnableSession := False )> _  
+      Public Function GetCustomers() As DataSet  
+        Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
+          "SELECT CustomerID, CompanyName FROM Customers", connection)  
+  
+        Dim custDS As DataSet = New DataSet()  
+        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey  
+        adapter.Fill(custDS, "Customers")  
+  
+        Return custDS  
+      End Function  
+  
+      <WebMethod( Description := "Updates Northwind Customers", EnableSession := False )> _  
+      Public Function UpdateCustomers(custDS As DataSet) As DataSet  
+        Dim adapter As SqlDataAdapter = New SqlDataAdapter()  
+  
+        adapter.InsertCommand = New SqlCommand( _  
+          "INSERT INTO Customers (CustomerID, CompanyName) " & _  
+          "Values(@CustomerID, @CompanyName)", connection)  
+        adapter.InsertCommand.Parameters.Add( _  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID")  
+        adapter.InsertCommand.Parameters.Add( _  
+          "@CompanyName", SqlDbType.NChar, 15, "CompanyName")  
+  
+        adapter.UpdateCommand = New SqlCommand( _  
+          "UPDATE Customers Set CustomerID = @CustomerID, " & _  
+          "CompanyName = @CompanyName WHERE CustomerID = " & _  
+          @OldCustomerID", connection)  
+        adapter.UpdateCommand.Parameters.Add( _  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID")  
+        adapter.UpdateCommand.Parameters.Add( _  
+          "@CompanyName", SqlDbType.NChar, 15, "CompanyName")  
+  
+        Dim parameter As SqlParameter = _  
+          adapter.UpdateCommand.Parameters.Add( _  
+          "@OldCustomerID", SqlDbType.NChar, 5, "CustomerID")  
+        parameter.SourceVersion = DataRowVersion.Original  
+  
+        adapter.DeleteCommand = New SqlCommand( _  
+          "DELETE FROM Customers WHERE CustomerID = @CustomerID", _  
+          connection)  
+        parameter = adapter.DeleteCommand.Parameters.Add( _  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID")  
+        parameter.SourceVersion = DataRowVersion.Original  
+  
+        adapter.Update(custDS, "Customers")  
+  
+        Return custDS  
+      End Function  
+    End Class  
+  
+    ```  
+  
+    ```csharp  
+    <% @ WebService Language = "C#" Class = "Sample" %>  
+    using System;  
+    using System.Data;  
+    using System.Data.SqlClient;  
+    using System.Web.Services;  
+  
+    [WebService(Namespace="http://microsoft.com/webservices/")]  
+    public class Sample  
+    {  
+      public SqlConnection connection = new SqlConnection("Data Source=(local);Integrated Security=SSPI;Initial Catalog=Northwind");  
+  
+      [WebMethod( Description = "Returns Northwind Customers", EnableSession = false )]  
+      public DataSet GetCustomers()  
+      {  
+        SqlDataAdapter adapter = new SqlDataAdapter(  
+          "SELECT CustomerID, CompanyName FROM Customers", connection);  
+  
+        DataSet custDS = new DataSet();  
+        adapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;  
+        adapter.Fill(custDS, "Customers");  
+  
+        return custDS;  
+      }  
+  
+      [WebMethod( Description = "Updates Northwind Customers",  
+        EnableSession = false )]  
+      public DataSet UpdateCustomers(DataSet custDS)  
+      {  
+        SqlDataAdapter adapter = new SqlDataAdapter();  
+  
+        adapter.InsertCommand = new SqlCommand(  
+          "INSERT INTO Customers (CustomerID, CompanyName) " +  
+          "Values(@CustomerID, @CompanyName)", connection);  
+        adapter.InsertCommand.Parameters.Add(  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID");  
+        adapter.InsertCommand.Parameters.Add(  
+          "@CompanyName", SqlDbType.NChar, 15, "CompanyName");  
+  
+        adapter.UpdateCommand = new SqlCommand(  
+          "UPDATE Customers Set CustomerID = @CustomerID, " +  
+          "CompanyName = @CompanyName WHERE CustomerID = " +  
+          "@OldCustomerID", connection);  
+        adapter.UpdateCommand.Parameters.Add(  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID");  
+        adapter.UpdateCommand.Parameters.Add(  
+          "@CompanyName", SqlDbType.NChar, 15, "CompanyName");  
+        SqlParameter parameter = adapter.UpdateCommand.Parameters.Add(  
+          "@OldCustomerID", SqlDbType.NChar, 5, "CustomerID");  
+        parameter.SourceVersion = DataRowVersion.Original;  
+  
+        adapter.DeleteCommand = new SqlCommand(  
+        "DELETE FROM Customers WHERE CustomerID = @CustomerID",  
+         connection);  
+        parameter = adapter.DeleteCommand.Parameters.Add(  
+          "@CustomerID", SqlDbType.NChar, 5, "CustomerID");  
+        parameter.SourceVersion = DataRowVersion.Original;  
+  
+        adapter.Update(custDS, "Customers");  
+  
+        return custDS;  
+      }  
+    }  
+    ```  
+  
+     代表的なシナリオでは、**UpdateCustomers** メソッドはオプティミスティック同時実行制御違反をキャッチするように記述されます。  説明を簡単にするために、この例では UpdateCustmoers メソッドを省略しています。  オプティミスティック同時実行制御の詳細については、「[オプティミスティック同時実行制御](../../../../../docs/framework/data/adonet/optimistic-concurrency.md)」を参照してください。  
+  
+2.  XML Web サービス プロキシを作成します。  
+  
+     XML Web サービスのクライアントは、公開されたメソッドを使用するために SOAP プロキシを必要とします。  このプロキシは、Visual Studio を使用して生成することができます。  Visual Studio から既存の Web サービスへの Web 参照を設定することにより、この手順で説明されているすべての動作が自動的に実行されます。  プロキシ クラスを手動で作成する場合は、後述の手順を参照してください。  ほとんどの場合、Visual Studio による、クライアント アプリケーションのプロキシ クラスの作成で十分です。  
+  
+     プロキシは、Web サービス記述言語ツールを使用して作成できます。  たとえば、XML Web サービスを http:\/\/myserver\/data\/DataSetSample.asmx に公開する場合は、次のようなコマンドを実行して、名前空間 **WebData.DSSample** を指定した Visual Basic .NET プロキシを作成し、それをファイル sample.vb に格納します。  
+  
+    ```  
+    wsdl /l:VB /out:sample.vb http://myserver/data/DataSetSample.asmx /n:WebData.DSSample  
+    ```  
+  
+     ファイル sample.cs に C\# プロキシを作成するには、次のコマンドを実行します。  
+  
+    ```  
+    wsdl /l:CS /out:sample.cs http://myserver/data/DataSetSample.asmx /n:WebData.DSSample  
+    ```  
+  
+     その後、プロキシをライブラリとしてコンパイルし、XML Web サービスのクライアントにインポートします。  sample.vb に格納されている Visual Basic .NET プロキシ コードを sample.dll としてコンパイルするには次のコマンドを実行します。  
+  
+    ```  
+    vbc /t:library /out:sample.dll sample.vb /r:System.dll /r:System.Web.Services.dll /r:System.Data.dll /r:System.Xml.dll  
+    ```  
+  
+     sample.cs に格納されている C\# プロキシ コードを sample.dll としてコンパイルするには次のコマンドを実行します。  
+  
+    ```  
+    csc /t:library /out:sample.dll sample.cs /r:System.dll /r:System.Web.Services.dll /r:System.Data.dll /r:System.Xml.dll  
+    ```  
+  
+3.  XML Web サービスのクライアントを作成します。  
+  
+     Visual Studio に Web サービスのプロキシ クラスを生成させる場合は、クライアント プロジェクトを作成し、ソリューション エクスプローラー ウィンドウで、そのプロジェクトを右クリックし、\[**Web 参照の追加**\] をクリックし、使用可能な Web サービスの一覧から Web サービスを選択します \(ただし、Web サービスが現行ソリューション内または現在のコンピューターで使用できない場合は、Web サービスのエンド ポイントのアドレスを指定する必要があります\)。上記の手順に従って、XML Web サービス プロキシを作成した場合は、それをクライアント コードにインポートし、XML Web サービスのメソッドを処理できます。  プロキシ ライブラリをインポートし、**GetCustomers** を呼び出して顧客リストを取得し、新しい顧客を追加した後、更新内容が格納された **DataSet** を **UpdateCustomers** に返すサンプル コードを次に示します。  
+  
+     この例では、変更された行だけを **UpdateCustomers** に渡す必要があるため、**UpdateCustomers** には、**DataSet.GetChanges** によって返された **DataSet** が渡されることに注意してください。  **UpdateCustomers** は解決された **DataSet** を返します。その後、この DataSet を既存の **DataSet** に **Merge** して、解決された変更と更新からの行エラー情報を取り込むことができます。  次のコードは、Visual Studio を使用して Web 参照が作成済みで、かつ、\[**Add Web 参照の追加**\] ダイアログ ボックスでその Web 参照の名前が DsSample に変更済みであることが前提となっています。  
+  
+    ```vb  
+    Imports System  
+    Imports System.Data  
+  
+    Public Class Client  
+  
+      Public Shared Sub Main()  
+        Dim proxySample As New DsSample.Sample ()  ' Proxy object.  
+        Dim customersDataSet As DataSet = proxySample.GetCustomers()  
+        Dim customersTable As DataTable = _  
+          customersDataSet.Tables("Customers")  
+  
+        Dim rowAs DataRow = customersTable.NewRow()  
+        row("CustomerID") = "ABCDE"  
+        row("CompanyName") = "New Company Name"  
+        customersTable.Rows.Add(row)  
+  
+        Dim updateDataSet As DataSet = _  
+          proxySample.UpdateCustomers(customersDataSet.GetChanges())  
+  
+        customersDataSet.Merge(updateDataSet)  
+        customersDataSet.AcceptChanges()  
+      End Sub  
+    End Class  
+  
+    ```  
+  
+    ```csharp  
+    using System;  
+    using System.Data;  
+  
+    public class Client  
+    {  
+      public static void Main()  
+      {  
+        Sample proxySample = new DsSample.Sample();  // Proxy object.  
+        DataSet customersDataSet = proxySample.GetCustomers();  
+        DataTable customersTable = customersDataSet.Tables["Customers"];  
+  
+        DataRow row = customersTable.NewRow();  
+        row["CustomerID"] = "ABCDE";  
+        row["CompanyName"] = "New Company Name";  
+        customersTable.Rows.Add(row);  
+  
+        DataSet updateDataSet = new DataSet();  
+  
+        updateDataSet =   
+          proxySample.UpdateCustomers(customersDataSet.GetChanges());  
+  
+        customersDataSet.Merge(updateDataSet);  
+        customersDataSet.AcceptChanges();  
+      }  
+    }  
+    ```  
+  
+     プロキシ クラスを手動で作成する場合は、次の手順に従ってください。  このサンプルをコンパイルするには、作成したプロキシ ライブラリ \(sample.dll\) および関連する .NET ライブラリを指定します。  ファイル client.vb に格納されている Visual Basic .NET バージョンのサンプルをコンパイルするには次のコマンドを実行します。  
+  
+    ```  
+    vbc client.vb /r:sample.dll /r:System.dll /r:System.Data.dll /r:System.Xml.dll /r:System.Web.Services.dll  
+    ```  
+  
+     ファイル client.cs に格納されている C\# バージョンのサンプルをコンパイルするには、次のコマンドを実行します。  
+  
+    ```  
+    csc client.cs /r:sample.dll /r:System.dll /r:System.Data.dll /r:System.Xml.dll /r:System.Web.Services.dll  
+    ```  
+  
+## 参照  
+ [ADO.NET](../../../../../docs/framework/data/adonet/index.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [DataAdapter からの DataSet の読み込み](../../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [DataAdapter パラメーター](../../../../../docs/framework/data/adonet/dataadapter-parameters.md)   
+ [Web Services Description Language Tool \(Wsdl.exe\)](http://msdn.microsoft.com/ja-jp/b9210348-8bc2-4367-8c91-d1a04b403e88)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/copying-dataset-contents.md b/docs/framework/data/adonet/dataset-datatable-dataview/copying-dataset-contents.md
new file mode 100644
index 00000000000..257b219c0d2
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/copying-dataset-contents.md
@@ -0,0 +1,109 @@
+---
+title: "DataSet の内容のコピー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb846617-2b1a-44ff-bd7f-5835f5ea37fa
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# DataSet の内容のコピー
+<xref:System.Data.DataSet> のコピーを作成すると、元のデータに影響せずにデータを使用したり、**DataSet** のデータのサブセットを使用したりできます。  **DataSet** をコピーすると、次の操作を行うことができます。  
+  
+-   スキーマ、データ、行状態情報、行バージョンなどの **DataSet** の正確なコピーを作成できます。  
+  
+-   既存の **DataSet** のスキーマを含み、行だけを変更した **DataSet** を作成できます。  変更されたすべての行を返したり、特定の **DataRowState** を指定したりできます。  行の状態の詳細については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+-   行をコピーせずに、**DataSet** のスキーマ \(リレーショナル構造\) だけをコピーできます。  行は、<xref:System.Data.DataTable.ImportRow%2A> を使用して、既存の <xref:System.Data.DataTable> にインポートできます。  
+  
+ スキーマとデータを含む **DataSet** の正確なコピーを作成するには、**DataSet** の <xref:System.Data.DataSet.Copy%2A> メソッドを使用します。  **DataSet** の正確なコピーを作成する方法を次のコード サンプルに示します。  
+  
+```vb  
+Dim copyDataSet As DataSet = customerDataSet.Copy()  
+  
+```  
+  
+```csharp  
+DataSet copyDataSet = customerDataSet.Copy();  
+```  
+  
+ スキーマ、およびデータが **Added**、**Modified**、または **Deleted** である行だけを含む **DataSet** のコピーを作成するには、**DataSet** の <xref:System.Data.DataSet.GetChanges%2A> メソッドを使用します。  また、**GetChanges** の呼び出し時に **DataRowState** の値を渡すことによって、**GetChanges** を使用して特定の行状態の行だけを返すことができます。  **GetChanges** の呼び出し時に **DataRowState** を渡す方法を次のコード サンプルに示します。  
+  
+```vb  
+' Copy all changes.  
+Dim changeDataSet As DataSet = customerDataSet.GetChanges()  
+' Copy only new rows.  
+Dim addedDataSetAs DataSet = _  
+    customerDataSet.GetChanges(DataRowState.Added)  
+  
+```  
+  
+```csharp  
+// Copy all changes.  
+DataSet changeDataSet = customerDataSet.GetChanges();  
+// Copy only new rows.  
+DataSet addedDataSet= customerDataSet.GetChanges(DataRowState.Added);  
+```  
+  
+ スキーマだけを含む **DataSet** のコピーを作成するには、**DataSet** の <xref:System.Data.DataSet.Clone%2A> メソッドを使用します。  また、**DataTable** の **ImportRow** メソッドを使用して、複製した **DataSet** に既存の行を追加することもできます。  **ImportRow** メソッドを使用すると、データ、行の状態、および行バージョンの情報が指定したテーブルに追加されます。  列名が一致し、データ型が互換性のある型の場合には、列の値だけが追加されます。  
+  
+ **DataSet** のクローンを作成し、**CountryRegion** 列の値が "Germany" の顧客に対する **DataSet** のクローン内の **Customers** テーブルに、元の **DataSet** の行を追加するコード サンプルを次に示します。  
+  
+```vb  
+  
+Dim customerDataSet As New DataSet  
+        customerDataSet.Tables.Add(New DataTable("Customers"))  
+        customerDataSet.Tables("Customers").Columns.Add("Name", GetType(String))  
+        customerDataSet.Tables("Customers").Columns.Add("CountryRegion", GetType(String))  
+        customerDataSet.Tables("Customers").Rows.Add("Juan", "Spain")  
+        customerDataSet.Tables("Customers").Rows.Add("Johann", "Germany")  
+        customerDataSet.Tables("Customers").Rows.Add("John", "UK")  
+  
+Dim germanyCustomers As DataSet = customerDataSet.Clone()  
+  
+Dim copyRows() As DataRow = _  
+  customerDataSet.Tables("Customers").Select("CountryRegion = 'Germany'")  
+  
+Dim customerTable As DataTable = germanyCustomers.Tables("Customers")  
+Dim copyRow As DataRow  
+  
+For Each copyRow In copyRows  
+  customerTable.ImportRow(copyRow)  
+Next  
+  
+```  
+  
+```csharp  
+DataSet customerDataSet = new DataSet();  
+customerDataSet.Tables.Add(new DataTable("Customers"));  
+customerDataSet.Tables["Customers"].Columns.Add("Name", typeof(string));  
+customerDataSet.Tables["Customers"].Columns.Add("CountryRegion", typeof(string));  
+customerDataSet.Tables["Customers"].Rows.Add("Juan", "Spain");  
+customerDataSet.Tables["Customers"].Rows.Add("Johann", "Germany");  
+customerDataSet.Tables["Customers"].Rows.Add("John", "UK");  
+  
+DataSet germanyCustomers = customerDataSet.Clone();  
+  
+DataRow[] copyRows =   
+  customerDataSet.Tables["Customers"].Select("CountryRegion = 'Germany'");  
+  
+DataTable customerTable = germanyCustomers.Tables["Customers"];  
+  
+foreach (DataRow copyRow in copyRows)  
+  customerTable.ImportRow(copyRow);  
+```  
+  
+## 参照  
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataTable>   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datareader.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datareader.md
new file mode 100644
index 00000000000..b9fb8e2d786
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datareader.md
@@ -0,0 +1,41 @@
+---
+title: "DataReader の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49d4422a-7464-4ab8-8ec7-90185fde3ecf
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataReader の作成
+<xref:System.Data.DataTable> クラスおよび <xref:System.Data.DataSet> クラスには、<xref:System.Data.DataTable> の内容または <xref:System.Data.DataSet> オブジェクトの <xref:System.Data.DataSet.Tables%2A> コレクションの内容を、読み取り専用で前方参照専用の 1 つ以上の結果セットとして返す <xref:System.Data.DataTable.CreateDataReader%2A> メソッドがあります。  
+  
+## 例  
+ <xref:System.Data.DataTable> インスタンスを作成するコンソール アプリケーションの例を次に示します。  このアプリケーションは、データが格納された <xref:System.Data.DataTable> `` を、<xref:System.Data.DataTable.CreateDataReader%2A> メソッドを呼び出すプロシージャに渡します。このメソッドは、<xref:System.Data.DataTableReader> 内に格納された結果の反復処理を行います。  
+  
+ [!code-csharp[DataWorks DataTable.CreateDataReader#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataTable.CreateDataReader/CS/source.cs#1)]
+ [!code-vb[DataWorks DataTable.CreateDataReader#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataTable.CreateDataReader/VB/source.vb#1)]  
+  
+ この例では、次の出力がコンソール ウィンドウに表示されます。  
+  
+```  
+1 Mary  
+2 Andy  
+3 Peter  
+4 Russ  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable.CreateDataReader%2A>   
+ <xref:System.Data.DataSet.CreateDataReader%2A>   
+ [DataTableReaders](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataset.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataset.md
new file mode 100644
index 00000000000..f346f658b52
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataset.md
@@ -0,0 +1,38 @@
+---
+title: "DataSet の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57629d8f-393e-4677-8b83-29ffde27f5fc
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet の作成
+<xref:System.Data.DataSet> のインスタンスを作成するには、<xref:System.Data.DataSet> のコンストラクターを呼び出します。  必要に応じて、引数 name を指定します。  名前を指定しない場合、<xref:System.Data.DataSet> の名前は "NewDataSet" に設定されます。  
+  
+ また、既存の <xref:System.Data.DataSet> に基づいて新しい <xref:System.Data.DataSet> を作成することもできます。  既存の <xref:System.Data.DataSet> の正確なコピーを新しい <xref:System.Data.DataSet> として作成できるのは、リレーショナル構造またはスキーマはコピーするけれども既存の <xref:System.Data.DataSet> からのデータは含まない <xref:System.Data.DataSet> のクローン、または <xref:System.Data.DataSet.GetChanges%2A> メソッドを使用して既存の <xref:System.Data.DataSet> から変更された行だけを含む <xref:System.Data.DataSet> のサブセットのいずれかです。  詳細については、「[DataSet の内容のコピー](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/copying-dataset-contents.md)」を参照してください。  
+  
+ <xref:System.Data.DataSet> のインスタンスの作成方法を示すコード例を次に示します。  
+  
+```vb  
+Dim customerOrders As DataSet = New DataSet("CustomerOrders")  
+  
+```  
+  
+```csharp  
+DataSet customerOrders = new DataSet("CustomerOrders");  
+```  
+  
+## 参照  
+ [DataAdapter からの DataSet の読み込み](../../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable-from-a-dataview.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable-from-a-dataview.md
new file mode 100644
index 00000000000..e7c8f5141f1
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable-from-a-dataview.md
@@ -0,0 +1,215 @@
+---
+title: "DataView からの DataTable の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d45cf41-d8ae-4409-af3e-a96a7e476d85
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataView からの DataTable の作成
+データ ソースからデータを取得し、<xref:System.Data.DataTable> にデータを格納した後、再度データを取得せずに、返されたデータの並べ替え、フィルター処理、または制限の適用を行うことが必要になる場合があります。  これを行うには、<xref:System.Data.DataView> クラスを使用します。  さらに、<xref:System.Data.DataView> から新しい <xref:System.Data.DataTable> ``  を作成する必要がある場合は、<xref:System.Data.DataView.ToTable%2A> メソッドを使用して、すべての行および列、またはデータのサブセットを新しい <xref:System.Data.DataTable> にコピーできます。  <xref:System.Data.DataView.ToTable%2A> メソッドには、次の操作を行うためのオーバーロード機能があります。  
+  
+-   <xref:System.Data.DataView> 内の列のサブセットである列を含む <xref:System.Data.DataTable> の作成  
+  
+-   Transact\-SQL の DISTINCT キーワードと同様に、<xref:System.Data.DataView> とは異なる行のみを含む <xref:System.Data.DataTable> ``  の作成  
+  
+## 例  
+ 次のコンソール アプリケーションの例では、**AdventureWorks** サンプル データベース内の **Person.Contact** テーブルからのデータが含まれる <xref:System.Data.DataTable> ``  が作成されます。  次に、<xref:System.Data.DataTable> に基づいて、並べ替えおよびフィルター処理を行った <xref:System.Data.DataView> ``  が作成されます。  <xref:System.Data.DataTable> ``  および <xref:System.Data.DataView> の内容が表示された後、<xref:System.Data.DataView.ToTable%2A> メソッドが呼び出され、<xref:System.Data.DataView> から新しい <xref:System.Data.DataTable> ``  が作成されて、使用可能な列のサブセットのみが選択されます。  最後に、新しい <xref:System.Data.DataTable> の内容が表示されます。  
+  
+```vb  
+Private Sub DemonstrateDataView()  
+    ' Retrieve a DataTable from the AdventureWorks sample database.  
+    ' connectionString is assumed to be a valid connection string.  
+    Dim adapter As New SqlDataAdapter( _  
+       "SELECT FirstName, LastName, EmailAddress FROM Person.Contact WHERE FirstName LIKE 'Mich%'", connectionString)  
+    Dim table As New DataTable  
+  
+    adapter.Fill(table)  
+    Console.WriteLine("Original table name: " & table.TableName)  
+    ' Print current table values.  
+    PrintTableOrView(table, "Current Values in Table")  
+  
+    ' Now create a DataView based on the DataTable.  
+    ' Sort and filter the data.  
+    Dim view As DataView = table.DefaultView  
+    view.Sort = "LastName, FirstName"  
+    view.RowFilter = "LastName > 'M'"  
+    PrintTableOrView(view, "Current Values in View")  
+  
+    ' Create a new DataTable based on the DataView,  
+    ' requesting only two columns with distinct values  
+    ' in the columns.  
+    Dim newTable As DataTable = view.ToTable("UniqueLastNames", True, "FirstName", "LastName")  
+    PrintTableOrView(newTable, "Table created from DataView")  
+    Console.WriteLine("New table name: " & newTable.TableName)  
+  
+    Console.WriteLine("Press any key to continue.")  
+    Console.ReadKey()  
+    End Sub  
+  
+Private Sub PrintTableOrView(ByVal dv As DataView, ByVal label As String)  
+    Dim sw As System.IO.StringWriter  
+    Dim output As String  
+    Dim table As DataTable = dv.Table  
+  
+    Console.WriteLine(label)  
+  
+    ' Loop through each row in the view.  
+    For Each rowView As DataRowView In dv  
+        sw = New System.IO.StringWriter  
+  
+        ' Loop through each column.  
+        For Each col As DataColumn In table.Columns  
+            ' Output the value of each column's data.  
+            sw.Write(rowView(col.ColumnName).ToString() & ", ")  
+        Next  
+        output = sw.ToString  
+        ' Trim off the trailing ", ", so the output looks correct.  
+        If output.Length > 2 Then  
+            output = output.Substring(0, output.Length - 2)  
+        End If  
+        ' Display the row in the console window.  
+        Console.WriteLine(output)  
+    Next  
+    Console.WriteLine()  
+End Sub  
+  
+Private Sub PrintTableOrView(ByVal table As DataTable, ByVal label As String)  
+    Dim sw As System.IO.StringWriter  
+    Dim output As String  
+  
+    Console.WriteLine(label)  
+  
+    ' Loop through each row in the table.  
+    For Each row As DataRow In table.Rows  
+        sw = New System.IO.StringWriter  
+        ' Loop through each column.  
+        For Each col As DataColumn In table.Columns  
+            ' Output the value of each column's data.  
+            sw.Write(row(col).ToString() & ", ")  
+        Next  
+        output = sw.ToString  
+        ' Trim off the trailing ", ", so the output looks correct.  
+        If output.Length > 2 Then  
+            output = output.Substring(0, output.Length - 2)  
+        End If  
+        ' Display the row in the console window.  
+        Console.WriteLine(output)  
+    Next  
+    Console.WriteLine()  
+    End Sub  
+End Module  
+```  
+  
+```csharp  
+private static void DemonstrateDataView()  
+{  
+// Retrieve a DataTable from the AdventureWorks sample database.  
+// connectionString is assumed to be a valid connection string.  
+SqlDataAdapter adapter = new SqlDataAdapter(  
+    "SELECT FirstName, LastName, EmailAddress " +  
+    "FROM Person.Contact WHERE FirstName LIKE 'Mich%'",   
+       GetConnectionString());  
+DataTable table = new DataTable();  
+  
+adapter.Fill(table);  
+Console.WriteLine("Original table name: " + table.TableName);  
+// Print current table values.  
+PrintTableOrView(table, "Current Values in Table");  
+  
+// Now create a DataView based on the DataTable.  
+// Sort and filter the data.  
+DataView view = table.DefaultView;  
+view.Sort = "LastName, FirstName";  
+view.RowFilter = "LastName > 'M'";  
+PrintTableOrView(view, "Current Values in View");  
+  
+// Create a new DataTable based on the DataView,  
+// requesting only two columns with distinct values  
+// in the columns.  
+DataTable newTable = view.ToTable("UniqueLastNames",  
+     true, "FirstName", "LastName");  
+PrintTableOrView(newTable, "Table created from DataView");  
+Console.WriteLine("New table name: " + newTable.TableName);  
+  
+Console.WriteLine("Press any key to continue.");  
+Console.ReadKey();  
+}  
+  
+private static void PrintTableOrView(DataView dv, string label)  
+{  
+System.IO.StringWriter sw;  
+string output;  
+DataTable table = dv.Table;  
+  
+Console.WriteLine(label);  
+  
+// Loop through each row in the view.  
+foreach (DataRowView rowView in dv)  
+{  
+    sw = new System.IO.StringWriter();  
+  
+    // Loop through each column.  
+    foreach (DataColumn col in table.Columns)  
+    {  
+        // Output the value of each column's data.  
+        sw.Write(rowView[col.ColumnName].ToString() + ", ");  
+    }  
+    output = sw.ToString();  
+    // Trim off the trailing ", ", so the output looks correct.  
+    if (output.Length > 2)  
+    {  
+        output = output.Substring(0, output.Length - 2);  
+    }  
+    // Display the row in the console window.  
+    Console.WriteLine(output);  
+}  
+Console.WriteLine();  
+}  
+  
+private static void PrintTableOrView(DataTable table, string label)  
+{  
+System.IO.StringWriter sw;  
+string output;  
+  
+Console.WriteLine(label);  
+  
+// Loop through each row in the table.  
+foreach (DataRow row in table.Rows)  
+{  
+    sw = new System.IO.StringWriter();  
+    // Loop through each column.  
+    foreach (DataColumn col in table.Columns)  
+    {  
+        // Output the value of each column's data.  
+        sw.Write(row[col].ToString() + ", ");  
+    }  
+    output = sw.ToString();  
+    // Trim off the trailing ", ", so the output looks correct.  
+    if (output.Length > 2)  
+    {  
+        output = output.Substring(0, output.Length - 2);  
+    }  
+    // Display the row in the console window.  
+    Console.WriteLine(output);  
+} //  
+Console.WriteLine();  
+}  
+```  
+  
+ }  
+  
+## 参照  
+ <xref:System.Data.DataView.ToTable%2A>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable.md
new file mode 100644
index 00000000000..0bb3222d5bb
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable.md
@@ -0,0 +1,65 @@
+---
+title: "DataTable の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eecf9d78-60e3-4fdc-8de0-e56c13a89414
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable の作成
+<xref:System.Data.DataTable> は 1 つのインメモリ リレーショナル データのテーブルを表します。DataTable は単独で作成および使用することも、他の .NET Framework オブジェクトから <xref:System.Data.DataSet> のメンバーとして使用することもできます。  
+  
+ **DataTable** オブジェクトは、適切な **DataTable** コンストラクターを使用することにより作成できます。  このオブジェクトを **DataSet** に追加するには、**Add** メソッドを使用して、**DataTable** オブジェクトの **Tables** コレクションにオブジェクトを追加します。  
+  
+ **DataSet** の内部で **DataTable** オブジェクトを作成する場合は、**DataAdapter** オブジェクトの **Fill** メソッドまたは **FillSchema** メソッドを使用できます。また、定義済みまたは推論による XML スキーマで、**DataSet** の **ReadXml**、**ReadXmlSchema**、または **InferXmlSchema** の各メソッドを使用して作成することもできます。  **DataTable** を 1 つの **DataSet** の **Tables** コレクションのメンバーとして追加した後で、その **DataTable** を他の **DataSet** のテーブルのコレクションに追加することはできません。  
+  
+ 最初に作成した時点では、**DataTable** にはスキーマ \(構造\) がありません。  テーブルのスキーマを定義するには、<xref:System.Data.DataColumn> オブジェクトを作成し、テーブルの **Columns** コレクションに追加する必要があります。  テーブルの主キー列を定義したり、**Constraint** オブジェクトを作成してテーブルの **Constraints** コレクションに追加したりすることもできます。  **DataTable** のスキーマを定義した後で、**DataRow** オブジェクトをテーブルの **Rows** コレクションに追加することにより、データ行をテーブルに追加できます。  
+  
+ **DataTable** を作成するときに <xref:System.Data.DataTable.TableName%2A> プロパティの値を指定する必要はありません。このプロパティは、後から指定することも、空のままにしておくこともできます。  ただし、**TableName** 値のないテーブルを **DataSet** に追加した場合、そのテーブルの名前は既定のテーブル名 Table*N* になります。この既定名は Table0 に相当する "Table" から始まり、連続する番号が割り当てられていきます。  
+  
+> [!NOTE]
+>  **TableName** 値を指定するときには、"Table*N*" の命名規則を使用しないことをお勧めします。これは、指定した名前が **DataSet** に既に存在する既定のテーブル名と競合しないようにするためです。  指定した名前が既に存在する場合は、例外がスローされます。  
+  
+ **DataTable** オブジェクトのインスタンスを作成し、"Customers" という名前を割り当てる例を次に示します。  
+  
+```vb  
+Dim workTable as DataTable = New DataTable("Customers")  
+  
+```  
+  
+```csharp  
+DataTable workTable = new DataTable("Customers");  
+```  
+  
+ **DataTable** のインスタンスを作成し、**DataSet** の **Tables** コレクションに追加する例を次に示します。  
+  
+```vb  
+Dim customers As DataSet = New DataSet  
+Dim customersTable As DataTable = _  
+   customers.Tables.Add("CustomersTable")  
+  
+```  
+  
+```csharp  
+DataSet customers = new DataSet();  
+DataTable customersTable = customers.Tables.Add("CustomersTable");  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataTableCollection>   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [DataAdapter からの DataSet の読み込み](../../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataview.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataview.md
new file mode 100644
index 00000000000..a6c950a4040
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataview.md
@@ -0,0 +1,60 @@
+---
+title: "DataView の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b1cc02d1-23b1-4439-a998-0da1899f3442
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataView の作成
+<xref:System.Data.DataView> は 2 とおりの方法で作成できます。  **DataView** コンストラクターを使用するか、または <xref:System.Data.DataTable> の <xref:System.Data.DataTable.DefaultView%2A> プロパティへの参照を作成します。  空の **DataView** コンストラクターを使用できます。また、**DataView** コンストラクターでは、**DataTable** を 1 つの引数としてとるか、またはフィルター条件、並べ替え条件、および行状態フィルターと共に **DataTable** を使用します。  **DataView** で使用できるその他の引数については、「[データの並べ替えとフィルター処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md)」を参照してください。  
+  
+ **DataView** のインデックスが作成されるのは、**DataView** が作成される時点と、**Sort**、**RowFilter**、または **RowStateFilter** の各プロパティが変更される時点であるため、**DataView** の作成時に初期の並べ替え順序または初期フィルター条件をコンストラクター引数として指定すると、パフォーマンスを最大限に引き出すことができます。  並べ替え条件やフィルター条件を指定せずに **DataView** を作成してから、**Sort**、**RowFilter**、または **RowStateFilter** の各プロパティを設定すると、インデックスが少なくとも 2 回作成されます。これは、**DataView** の作成時点と、並べ替えプロパティまたはフィルター プロパティの変更時です。  
+  
+ 引数をとらないコンストラクターを使用して **DataView** を作成すると、**Table** プロパティを設定していない間は、**DataView** が使用できます。  
+  
+ **DataView** コンストラクターを使用して **DataView** を作成するコード サンプルを次に示します。  **DataTable** と共に **RowFilter**、**Sort** 列、および **DataViewRowState** が指定されています。  
+  
+```vb  
+Dim custDV As DataView = New DataView(custDS.Tables("Customers"), _  
+    "Country = 'USA'", _  
+    "ContactName", _  
+    DataViewRowState.CurrentRows)  
+  
+```  
+  
+```csharp  
+DataView custDV = new DataView(custDS.Tables["Customers"],   
+    "Country = 'USA'",   
+    "ContactName",   
+    DataViewRowState.CurrentRows);  
+```  
+  
+ テーブルの **DefaultView** プロパティを使用して **DataTable** の既定の **DataView** への参照を取得するコード サンプルを次に示します。  
+  
+```vb  
+Dim custDV As DataView = custDS.Tables("Customers").DefaultView  
+  
+```  
+  
+```csharp  
+DataView custDV = custDS.Tables["Customers"].DefaultView;  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [データの並べ替えとフィルター処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md
new file mode 100644
index 00000000000..ef1443c8933
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md
@@ -0,0 +1,47 @@
+---
+title: "AutoIncrement 列の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf09732a-ab54-4d98-89e2-4d0a1f28fbce
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# AutoIncrement 列の作成
+列値を一意にするために、新しい行がテーブルに追加されたときに列値が自動的にインクリメントされるように設定できます。  自動インクリメント <xref:System.Data.DataColumn> を作成するには、列の <xref:System.Data.DataColumn.AutoIncrement%2A> プロパティを **true** に設定します。  <xref:System.Data.DataColumn> の値は <xref:System.Data.DataColumn.AutoIncrementSeed%2A> プロパティで定義された値から開始され、行が追加されるたびに、**AutoIncrement** 列の値には、列の <xref:System.Data.DataColumn.AutoIncrementStep%2A> プロパティで定義された値が加算されます。  
+  
+ **AutoIncrement** 列では、**DataColumn** の <xref:System.Data.DataColumn.ReadOnly%2A> プロパティを **true** に設定することをお勧めします。  
+  
+ 値 200 から開始して 3 ずつインクリメントする列を作成する方法を次の例に示します。  
+  
+```vb  
+Dim workColumn As DataColumn = workTable.Columns.Add( _  
+    "CustomerID", typeof(Int32))  
+workColumn.AutoIncrement = true  
+workColumn.AutoIncrementSeed = 200  
+workColumn.AutoIncrementStep = 3  
+  
+```  
+  
+```csharp  
+DataColumn workColumn = workTable.Columns.Add(  
+    "CustomerID", typeof(Int32));  
+workColumn.AutoIncrement = true;  
+workColumn.AutoIncrementSeed = 200;  
+workColumn.AutoIncrementStep = 3;  
+```  
+  
+## 参照  
+ <xref:System.Data.DataColumn>   
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/creating-expression-columns.md b/docs/framework/data/adonet/dataset-datatable-dataview/creating-expression-columns.md
new file mode 100644
index 00000000000..beac43b8090
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/creating-expression-columns.md
@@ -0,0 +1,52 @@
+---
+title: "式列の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0af3bd64-92a2-4b47-ae62-f5df35f131a6
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 式列の作成
+列の式を定義すると、同じ行の他の列値またはテーブル内の複数の行の列値に基づいて計算した値を、その列に格納できます。  評価する式を定義するには、対象の列の <xref:System.Data.DataColumn.Expression%2A> プロパティを使用し、その式で <xref:System.Data.DataColumn.ColumnName%2A> プロパティを使用して他の列を参照します。  式列の <xref:System.Data.DataColumn.DataType%2A> は、その式が返す値に適した型であることが必要です。  
+  
+ テーブル内の式列で使用できるいくつかの式の種類を次の表に示します。  
+  
+|式の種類|例|  
+|----------|-------|  
+|比較|"Total \>\= 500"|  
+|計算|"UnitPrice \* Quantity"|  
+|集約|Sum\(Price\)|  
+  
+ 次の例に示すように、既存の **DataColumn** オブジェクトの **Expression** プロパティを設定したり、このプロパティを <xref:System.Data.DataColumn> コンストラクターに渡す 3 番目の引数として使用したりできます。  
+  
+```vb  
+workTable.Columns.Add("Total",Type.GetType("System.Double"))  
+workTable.Columns.Add("SalesTax", Type.GetType("System.Double"), _  
+  "Total * 0.086")  
+  
+```  
+  
+```csharp  
+workTable.Columns.Add("Total", typeof(Double));  
+workTable.Columns.Add("SalesTax", typeof(Double), "Total * 0.086");  
+```  
+  
+ 式は他の式列を参照できます。ただし、2 つの式が相互に参照し合う循環参照の場合は、例外が生成されます。  式の記述の規則については、**DataColumn** クラスの <xref:System.Data.DataColumn.Expression%2A> プロパティのトピックを参照してください。  
+  
+## 参照  
+ <xref:System.Data.DataColumn>   
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataTable>   
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datarow-deletion.md b/docs/framework/data/adonet/dataset-datatable-dataview/datarow-deletion.md
new file mode 100644
index 00000000000..cb9234fc91d
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datarow-deletion.md
@@ -0,0 +1,58 @@
+---
+title: "DataRow の削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c34f531d-4b9b-4071-b2d7-342c402aa586
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# DataRow の削除
+<xref:System.Data.DataTable> オブジェクトから <xref:System.Data.DataRow> オブジェクトを削除するには、<xref:System.Data.DataRowCollection> オブジェクトの **Remove** メソッドと **DataRow** オブジェクトの <xref:System.Data.DataRow.Delete%2A> メソッドの 2 つのメソッドを使用できます。  <xref:System.Data.DataRowCollection.Remove%2A> メソッドが **DataRowCollection** から **DataRow** を削除するのに対し、<xref:System.Data.DataRow.Delete%2A> メソッドは削除対象の行をマークするだけです。  実際の削除は、アプリケーションが **AcceptChanges** メソッドを呼び出すと実行されます。  <xref:System.Data.DataRow.Delete%2A> を使用すると、行を実際に削除する前に、削除対象としてどの行がマークされているかをプログラムによってチェックできます。  削除対象としてマークされている行の <xref:System.Data.DataRow.RowState%2A> プロパティは、<xref:System.Data.DataRow.Delete%2A> に設定されています。  
+  
+ <xref:System.Data.DataRowCollection> オブジェクトを反復処理している間は、foreach ループで <xref:System.Data.DataRow.Delete%2A> も <xref:System.Data.DataRowCollection.Remove%2A> も呼び出すことはできません。  <xref:System.Data.DataRow.Delete%2A> または <xref:System.Data.DataRowCollection.Remove%2A> はコレクションの状態を変更します。  
+  
+ **DataAdapter** およびリレーショナル データ ソースに関連して <xref:System.Data.DataSet> または **DataTable** を使用するときは、**DataRow** の **Delete** メソッドを使用して行を削除します。  **Delete** メソッドは、**DataSet** または **DataTable** の行を **Deleted** としてマークしますが、その行を削除しません。  代わりに、**DataAdapter** が **Deleted** としてマークされた行を検出したときに **DeleteCommand** メソッドを実行して、データ ソースの該当する行を削除します。  その後、**AcceptChanges** メソッドを使用して、その行を永続的に削除できます。  **Remove** を使用して行を削除すると、行はテーブルから完全に削除されますが、**DataAdapter** はデータ ソースの該当する行を削除しません。  
+  
+ **DataRowCollection** の **Remove** メソッドが **DataRow** を引数として受け取り、その行をコレクションから削除する例を次に示します。  
+  
+```vb  
+workTable.Rows.Remove(workRow)  
+  
+```  
+  
+```csharp  
+workTable.Rows.Remove(workRow);  
+```  
+  
+ これに対して、**DataRow** の **Delete** メソッドを呼び出して、該当する行の **RowState** を **Deleted** に変更する例を次に示します。  
+  
+```vb  
+workRow.Delete  
+  
+```  
+  
+```csharp  
+workRow.Delete();  
+```  
+  
+ 行を削除対象としてマークしてから **DataTable** オブジェクトの **AcceptChanges** メソッドを呼び出すと、その行が **DataTable** から削除されます。  これに対して、**RejectChanges** を呼び出すと、行の **RowState** はその行が **Deleted** としてマークされる前の状態に戻ります。  
+  
+> [!NOTE]
+>  **DataRow** の **RowState** が **Added** である場合、つまりテーブルに行が追加された直後の状態の場合に、その行を **Deleted** としてマークすると、その行はテーブルから削除されます。  
+  
+## 参照  
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataRowCollection>   
+ <xref:System.Data.DataTable>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datarows-and-datarowviews.md b/docs/framework/data/adonet/dataset-datatable-dataview/datarows-and-datarowviews.md
new file mode 100644
index 00000000000..473ca58cc76
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datarows-and-datarowviews.md
@@ -0,0 +1,73 @@
+---
+title: "DataRow および DataRowView | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f5eec26-b809-4aca-8778-7e202356d856
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataRow および DataRowView
+<xref:System.Data.DataView> は、<xref:System.Data.DataRowView> オブジェクトの列挙可能なコレクションを公開します。  **DataRowView** オブジェクトは、基になるテーブルの列の名前または列の序数参照によってインデックスが設定されているオブジェクトの配列として値を公開します。  **DataRowView** が **DataRowView** の <xref:System.Data.DataRowView.Row%2A> プロパティを使用して公開している <xref:System.Data.DataRow> にアクセスできます。  
+  
+ **DataRowView** を使用して値を表示している場合は、**DataView** の <xref:System.Data.DataView.RowStateFilter%2A> プロパティによって、基になる **DataRow** から公開される行バージョンが決まります。  **DataRow** を使用してさまざまな行バージョンにアクセスする方法については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+ テーブルの現在の値と元の値をすべて表示するコード サンプルを次に示します。  
+  
+```vb  
+Dim catView As DataView = New DataView(catDS.Tables("Categories"))  
+Console.WriteLine("Current Values:")  
+WriteView(catView)  
+Console.WriteLine("Original Values:")  
+catView.RowStateFilter = DataViewRowState.ModifiedOriginal  
+WriteView(catView)      
+  
+Public Shared Sub WriteView(thisDataView As DataView)  
+  Dim rowView As DataRowView  
+  Dim i As Integer  
+  
+  For Each rowView In thisDataView  
+    For i = 0 To thisDataView.Table.Columns.Count - 1  
+      Console.Write(rowView(i) & vbTab)  
+    Next  
+    Console.WriteLine()  
+  Next  
+End Sub  
+  
+```  
+  
+```csharp  
+DataView catView = new DataView(catDS.Tables["Categories"]);  
+Console.WriteLine("Current Values:");  
+WriteView(catView);  
+Console.WriteLine("Original Values:");  
+catView.RowStateFilter = DataViewRowState.ModifiedOriginal;  
+WriteView(catView);  
+  
+public static void WriteView(DataView thisDataView)  
+{  
+  foreach (DataRowView rowView in thisDataView)  
+  {  
+    for (int i = 0; i < thisDataView.Table.Columns.Count; i++)  
+      Console.Write(rowView[i] + "\t");  
+    Console.WriteLine();  
+  }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataRowVersion>   
+ <xref:System.Data.DataViewRowState>   
+ <xref:System.Data.DataView>   
+ <xref:System.Data.DataRowView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md b/docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md
new file mode 100644
index 00000000000..cb40c6aebe9
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md
@@ -0,0 +1,121 @@
+---
+title: "DataSet と XmlDataDocument の同期 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0ce3793d-54b2-47e4-8cf7-b0591cc4dd21
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet と XmlDataDocument の同期
+ADO.NET の <xref:System.Data.DataSet> には、データのリレーショナル表現があります。  階層データにアクセスするには、.NET Framework で使用できる XML クラスを使用できます。  従来、この 2 つのデータ表現は個別に使用されていました。  .NET Framework では、データのリレーショナル表現と階層表現の両方へリアルタイムに同期的な方法でアクセスできます。リレーショナル表現にアクセスするには **DataSet** オブジェクトを使用します。階層表現にアクセスするには <xref:System.Xml.XmlDataDocument> オブジェクトを使用します。  
+  
+ **DataSet** を **XmlDataDocument** と同期するときには、**DataSet** と **XmlDataDocument** で 1 つのデータ セットが使用されます。  つまり **DataSet** が変更されると、その変更内容が **XmlDataDocument** に反映されます。この逆の反映も行われます。  **DataSet** と **XmlDataDocument** の間のリレーションシップにより、1 つのアプリケーションから 1 つのデータ セットを使用して、**DataSet** の周囲に構築されたサービス スイート全体 \(Web フォーム、Windows フォーム コントロール、Visual Studio、.NET デザイナーなど\) にアクセスしたり、XML サービス スイート \(XSL \(Extensible Stylesheet Language\)、XSLT \(XSL Transformations\)、XPath \(XML Path Language\) など\) にアクセスしたりできる優れた柔軟性を実現します。  アプリケーションでアクセス対象とするサービス セットを選択する必要はありません。どちらのサービス セットにもアクセスできます。  
+  
+ **DataSet** を **XmlDataDocument** と同期する方法は数種類あります。  次の操作を行うことができます。  
+  
+-   **DataSet** にスキーマ \(リレーショナル構造\) とデータを読み込み、この **DataSet** を新しい **XmlDataDocument** と同期します。  この方法では、既存のリレーショナル データの階層ビューが作成されます。  次に例を示します。  
+  
+    ```vb  
+    Dim dataSet As DataSet = New DataSet  
+  
+    ' Add code here to populate the DataSet with schema and data.  
+  
+    Dim xmlDoc As XmlDataDocument = New XmlDataDocument(dataSet)  
+    ```  
+  
+    ```csharp  
+    DataSet dataSet = new DataSet();  
+  
+    // Add code here to populate the DataSet with schema and data.  
+  
+    XmlDataDocument xmlDoc = new XmlDataDocument(dataSet);  
+    ```  
+  
+-   **DataSet** にスキーマだけを読み込み、この **DataSet** \(厳密に型指定された **DataSet** など\) を **XmlDataDocument** と同期します。次に、XML ドキュメントから **XmlDataDocument** を読み込みます。  この方法では、既存の階層データのリレーショナル ビューが作成されます。  **DataSet** スキーマのテーブル名と列名が、同期をとる XML 要素の名前と一致している必要があります。  この名前の一致では、大文字と小文字が区別されます。  
+  
+     **DataSet** のスキーマが一致する必要があるのは、リレーショナル ビューで公開する XML 要素だけです。  つまり、このドキュメント上に非常に大きい XML ドキュメントと非常に小さなリレーショナル ウィンドウを作成できます。  **DataSet** が XML ドキュメントの一部だけを公開する場合でも、**XmlDataDocument** は XML ドキュメント全体を保持します。  この説明に関する詳しい例については、「[Dataset と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/synchronizing-a-dataset-with-an-xmldatadocument.md)」を参照してください。  
+  
+     **DataSet** を作成してそのスキーマを読み込み、**XmlDataDocument** と同期する手順を示すコード サンプルを次に示します。  **DataSet** スキーマが一致する必要があるのは、**XmlDataDocument** の中で **DataSet** を使用して公開する要素だけです。  
+  
+    ```vb  
+    Dim dataSet As DataSet = New DataSet  
+  
+    ' Add code here to populate the DataSet with schema, but not data.  
+  
+    Dim xmlDoc As XmlDataDocument = New XmlDataDocument(dataSet)  
+    xmlDoc.Load("XMLDocument.xml")  
+    ```  
+  
+    ```csharp  
+    DataSet dataSet = new DataSet();  
+  
+    // Add code here to populate the DataSet with schema, but not data.  
+  
+    XmlDataDocument xmlDoc = new XmlDataDocument(dataSet);  
+    xmlDoc.Load("XMLDocument.xml");  
+    ```  
+  
+     データが含まれている **DataSet** を **XmlDataDocument** と同期する場合には、**XmlDataDocument** を読み込むことはできません。  読み込もうとすると例外がスローされます。  
+  
+-   新しい **XmlDataDocument** を作成して、XML ドキュメントからこの **XmlDataDocument** を読み込みます。次に、**XmlDataDocument** の **DataSet** プロパティを使用してデータのリレーショナル ビューにアクセスします。  **DataSet** を使用して **XmlDataDocument** のデータを表示するには、**DataSet** スキーマを設定する必要があります。  この場合も、**DataSet** スキーマのテーブル名と列名が、同期をとる XML 要素の名前と一致している必要があります。  この名前の一致では、大文字と小文字が区別されます。  
+  
+     **XmlDataDocument** のデータのリレーショナル ビューにアクセスする方法を次のコード サンプルに示します。  
+  
+    ```vb  
+    Dim xmlDoc As XmlDataDocument = New XmlDataDocument  
+    Dim dataSet As DataSet = xmlDoc.DataSet  
+  
+    ' Add code here to create the schema of the DataSet to view the data.  
+  
+    xmlDoc.Load("XMLDocument.xml")  
+  
+    ```  
+  
+    ```csharp  
+    XmlDataDocument xmlDoc = new XmlDataDocument();  
+    DataSet dataSet = xmlDoc.DataSet;  
+  
+    // Add code here to create the schema of the DataSet to view the data.  
+  
+    xmlDoc.Load("XMLDocument.xml");  
+    ```  
+  
+ **DataSet** を **XmlDataDocument** と同期するもう 1 つの利点は、XML ドキュメントが完全に保持されることです。  **ReadXml** を使用して XML ドキュメントのデータを **DataSet** に格納すると、**WriteXml** を使用してデータが XML ドキュメントとして書き込まれるときに、この XML ドキュメントと元の XML ドキュメントが大幅に異なる場合があります。  これは、**DataSet** では XML ドキュメントから読み込んだ空白などの書式設定や、要素順序などの階層情報が維持されないためです。  **DataSet** には、XML ドキュメントで無視された要素も含まれていません。これは、これらの要素が **Dataset** のスキーマに一致しないためです。  **XmlDataDocument** を **DataSet** と同期することで、元の XML ドキュメントの書式設定要素や階層要素の構造が **XmlDataDocument** で維持され、**DataSet** には **DataSet** に適切なデータおよびスキーマ情報だけが含まれます。  
+  
+ **DataSet** を **XmlDataDocument** と同期する場合、<xref:System.Data.DataRelation> オブジェクトが入れ子かどうかによって同期結果が異なります。  詳細については、「[DataRelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Dataset と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/synchronizing-a-dataset-with-an-xmldatadocument.md)  
+ 最小限のスキーマが含まれており、厳密に型指定された **DataSet** を **XmlDataDocument** と同期させるサンプルを示します。  
+  
+ [DataSet に対する XPath クエリの実行](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/performing-an-xpath-query-on-a-dataset.md)  
+ **DataSet** の内容に対する XPath クエリの実行のサンプルを示します。  
+  
+ [DataSet への XSLT 変換の適用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/applying-an-xslt-transform-to-a-dataset.md)  
+ **DataSet** の内容に対する XSLT 変換の適用サンプルを示します。  
+  
+## 関連項目  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)  
+ **DataSet** がデータ ソースとして XML と対話する方法を、**DataSet** の内容を XML データとして読み込んで永続化する方法と共に説明します。  
+  
+ [DataRelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)  
+ **DataSet** の内容を XML データとして表現する場合における、入れ子になった **DataRelation** オブジェクトの重要性について説明します。また、このようなリレーションを作成する方法について説明します。  
+  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)  
+ **DataSet** について説明し、**DataSet** を使用したアプリケーション データの管理方法と、**DataSet** を使用したデータ ソース \(リレーショナル データベースや XML など\) との対話方法について説明します。  
+  
+ [XmlDataDocument クラス](frlrfSystemXmlXmlDataDocumentClassTopic)  
+ **XmlDataDocument** クラスに関するリファレンス情報が収録されています。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md
new file mode 100644
index 00000000000..eea53b5a2f0
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md
@@ -0,0 +1,108 @@
+---
+title: "DataTable の制約 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27c9f2fd-f64d-4b4e-bbf6-1d24f47067cb
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable の制約
+制約を使用すると、データの整合性を維持するために <xref:System.Data.DataTable> のデータを強制的に制限できます。  制約は、1 つの列または関連付けられた複数の列に対して自動的に適用される規則であり、行の値がなんらかの方法で変更されたときに実行されるアクションを決定します。  制約は、<xref:System.Data.DataSet> の  `System.Data.DataSet.EnforceConstraints` プロパティを **true** に設定したときに適用されます。  `EnforceConstraints` プロパティの設定方法のコード例については、<xref:System.Data.DataSet.EnforceConstraints%2A> のリファレンス トピックを参照してください。  
+  
+ ADO.NET には、<xref:System.Data.ForeignKeyConstraint> と <xref:System.Data.UniqueConstraint> の 2 種類の制約があります。  既定では、<xref:System.Data.DataRelation> を **DataSet** に追加して複数のテーブル間のリレーションシップを作成すると、この 2 種類の制約が両方とも自動的に作成されます。  ただし、リレーションの作成時に **createConstraints** \= **false** と指定することにより、この動作を無効にできます。  
+  
+## ForeignKeyConstraint  
+ **ForeignKeyConstraint** は、関連付けられているテーブルに更新や削除を反映させる方法についての規則を適用します。  たとえば、あるテーブルの行の値が更新または削除され、その同じ値が、関連付けられている別のテーブルでも使用されている場合、関連付けられているテーブル内で実行されるアクションは **ForeignKeyConstraint** によって決定されます。  
+  
+ **ForeignKeyConstraint** の <xref:System.Data.ForeignKeyConstraint.DeleteRule%2A> プロパティおよび <xref:System.Data.ForeignKeyConstraint.UpdateRule%2A> プロパティは、ユーザーが関連付けられているテーブルの行を削除または更新しようとしたときに実行されるアクションを定義します。  **ForeignKeyConstraint** の **DeleteRule** プロパティおよび **UpdateRule** プロパティに使用できるさまざまな設定の説明を次の表に示します。  
+  
+|規則の設定|説明|  
+|-----------|--------|  
+|**Cascade**|関連付けられている行を削除または更新します。|  
+|**SetNull**|関連付けられている行の値を **DBNull** に設定します。|  
+|**SetDefault**|関連付けられている行の値を既定値に設定します。|  
+|**なし**|関連付けられている行に対してアクションは実行しません。  既定値です。|  
+  
+ **ForeignKeyConstraint** は、関連付けられている行への変更を制限したり、反映させたりできます。  列の **ForeignKeyConstraint** に対して設定されたプロパティによっては、**DataSet** の **EnforceConstraints** プロパティが **true** である場合に親の行に対して操作を実行すると、例外が発生することがあります。  たとえば、**ForeignKeyConstraint** の **DeleteRule** プロパティが **None** の場合、子の行を持っている親の行は削除できません。  
+  
+ **ForeignKeyConstraint** コンストラクターを使用すると、単一列間または列配列間の外部キー制約を作成できます。  **ConstraintCollection** の 1 つである、テーブルの **Constraints** プロパティの **Add** メソッドに結果の **ForeignKeyConstraint** オブジェクトを渡します。  コンストラクター引数を **ConstraintCollection** の **Add** メソッドのいくつかのオーバーロードに渡すことにより、**ForeignKeyConstraint** を作成することもできます。  
+  
+ **ForeignKeyConstraint** を作成するときに、**DeleteRule** の値と **UpdateRule** の値を引数としてコンストラクターに渡したり、それらの値を次の例に示すようにプロパティとして設定したりできます。この例では、**DeleteRule** の値が **None** に設定されています。  
+  
+```vb  
+Dim custOrderFK As ForeignKeyConstraint = New ForeignKeyConstraint("CustOrderFK", _  
+  custDS.Tables("CustTable").Columns("CustomerID"), _  
+  custDS.Tables("OrdersTable").Columns("CustomerID"))  
+custOrderFK.DeleteRule = Rule.None    
+' Cannot delete a customer value that has associated existing orders.  
+custDS.Tables("OrdersTable").Constraints.Add(custOrderFK)  
+  
+```  
+  
+```csharp  
+ForeignKeyConstraint custOrderFK = new ForeignKeyConstraint("CustOrderFK",  
+  custDS.Tables["CustTable"].Columns["CustomerID"],   
+  custDS.Tables["OrdersTable"].Columns["CustomerID"]);  
+custOrderFK.DeleteRule = Rule.None;    
+// Cannot delete a customer value that has associated existing orders.  
+custDS.Tables["OrdersTable"].Constraints.Add(custOrderFK);  
+```  
+  
+### AcceptRejectRule  
+ 行への変更は、**AcceptChanges** メソッドを使用して受け入れることができ、**DataSet**、**DataTable**、または **DataRow** の **RejectChanges** メソッドを使用してキャンセルできます。  **DataSet** に **ForeignKeyConstraints** が含まれている場合は、**AcceptChanges** メソッドまたは **RejectChanges** メソッドを呼び出すと、**AcceptRejectRule** が強制適用されます。  **ForeignKeyConstraint** の **AcceptRejectRule** プロパティは、親の行に対して **AcceptChanges** または **RejectChanges** が呼び出されたときに、子の行に対して実行されるアクションを決定します。  
+  
+ **AcceptRejectRule** に使用できる設定の一覧を次の表に示します。  
+  
+|規則の設定|説明|  
+|-----------|--------|  
+|**Cascade**|子の行への変更を受け入れるかまたは拒否します。|  
+|**なし**|子の行に対してアクションは実行しません。  既定値です。|  
+  
+### 例  
+ 次の例では、<xref:System.Data.ForeignKeyConstraint> を作成し、<xref:System.Data.ForeignKeyConstraint.AcceptRejectRule%2A> を含む複数のプロパティを設定して、<xref:System.Data.DataTable> オブジェクトの <xref:System.Data.ConstraintCollection> に追加します。  
+  
+ [!code-csharp[DataWorks Data.AcceptRejectRule#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks Data.AcceptRejectRule/CS/source.cs#1)]
+ [!code-vb[DataWorks Data.AcceptRejectRule#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks Data.AcceptRejectRule/VB/source.vb#1)]  
+  
+## UniqueConstraint  
+ **UniqueConstraint** オブジェクトは、**DataTable** 内の 1 つの列または列の配列に対して割り当てることができ、指定された列内のすべてのデータが行ごとに一意になるようにします。  **UniqueConstraint** コンストラクターを使用して、1 つの列または列の配列に対する UNIQUE 制約を作成できます。  **ConstraintCollection** の 1 つである、テーブルの **Constraints** プロパティの **Add** メソッドに結果の **UniqueConstraint** オブジェクトを渡します。  コンストラクター引数を **ConstraintCollection** の **Add** メソッドのいくつかのオーバーロードに渡すことにより、**UniqueConstraint** を作成することもできます。  1 つの列または複数の列に対して **UniqueConstraint** を作成するときは、オプションで、その列または複数の列を主キーにするかどうかを指定できます。  
+  
+ 列の **Unique** プロパティを **true** に設定することにより、1 つの列に対する UNIQUE 制約を作成することもできます。  また、1 つの列の **Unique** プロパティを **false** に設定することにより、既存の UNIQUE 制約を削除できます。  1 つの列 \(または複数の列\) をテーブルの主キーとして定義すると、指定した列 \(または複数の列\) の UNIQUE 制約が自動的に作成されます。  **DataTable** の **PrimaryKey** プロパティから列を削除すると、**UniqueConstraint** が削除されます。  
+  
+ **DataTable** の 2 つの列の **UniqueConstraint** を作成する例を次に示します。  
+  
+```vb  
+Dim custTable As DataTable = custDS.Tables("Customers")  
+Dim custUnique As UniqueConstraint = _  
+    New UniqueConstraint(New DataColumn()   {custTable.Columns("CustomerID"), _  
+    custTable.Columns("CompanyName")})  
+custDS.Tables("Customers").Constraints.Add(custUnique)  
+  
+```  
+  
+```csharp  
+DataTable custTable = custDS.Tables["Customers"];  
+UniqueConstraint custUnique = new UniqueConstraint(new DataColumn[]   
+    {custTable.Columns["CustomerID"],   
+    custTable.Columns["CompanyName"]});  
+custDS.Tables["Customers"].Constraints.Add(custUnique);  
+```  
+  
+## 参照  
+ <xref:System.Data.DataRelation>   
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.ForeignKeyConstraint>   
+ <xref:System.Data.UniqueConstraint>   
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datatable-edits.md b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-edits.md
new file mode 100644
index 00000000000..ccb0c2d6816
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-edits.md
@@ -0,0 +1,100 @@
+---
+title: "DataTable の編集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f08008a9-042e-4de9-94f3-4f0e502b1eb5
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable の編集
+<xref:System.Data.DataRow> 内の列値を変更すると、その変更はすぐに行の現在の状態に反映されます。  次に、<xref:System.Data.DataRowState> が **Modified** に設定され、**DataRow** の <xref:System.Data.DataRow.AcceptChanges%2A> メソッドまたは <xref:System.Data.DataRow.RejectChanges%2A> メソッドを使用して変更が受け入れられるかまたは拒否されます。  **DataRow** は、行の編集中に、その行の状態を保留にしておくために使用できる 3 つのメソッドも提供します。  これらのメソッドとは、<xref:System.Data.DataRow.BeginEdit%2A>、<xref:System.Data.DataRow.EndEdit%2A> および <xref:System.Data.DataRow.CancelEdit%2A> です。  
+  
+ **DataRow** の列値が直接変更されると、**DataRow** は、**Current**、**Default**、**Original** の各行バージョンを使用して列値を管理します。  **BeginEdit**、**EndEdit**、**CancelEdit** の各メソッドでは、これらの行バージョンに加えて、4 番目の行バージョン **Proposed** を使用します。  行バージョンの詳細については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+ **Proposed** 行バージョンは、編集操作中に存在するバージョンです。編集操作は、**BeginEdit** への呼び出しによって開始し、**EndEdit** または **CancelEdit** の使用あるいは **AcceptChanges** または **RejectChanges** の呼び出しによって終了します。  
+  
+ 編集操作中に、**DataTable** の **ColumnChanged** イベントで **ProposedValue** を評価することにより、個々の列に検証ロジックを適用できます。  **ColumnChanged** イベントは、変更されている列への参照および **ProposedValue** への参照を維持する **DataColumnChangeEventArgs** を保持します。  提示された値を評価した後で、値を変更するか、または編集をキャンセルできます。  編集が終了すると、行は **Proposed** 状態ではなくなります。  
+  
+ **EndEdit** を呼び出すと編集内容を確定でき、**CancelEdit** を呼び出すと編集内容をキャンセルできます。  **EndEdit** は編集内容を確定しますが、**DataSet** は **AcceptChanges** が呼び出されるまでは実際には変更を受け入れません。  また、**EndEdit** または **CancelEdit** を使用して編集を終了する前に **AcceptChanges** を呼び出した場合は、編集が終了し、**Proposed** 行値が **Current** 行バージョンと **Original** 行バージョンの両方に受け入れられます。  同様に、**RejectChanges** を呼び出した場合も編集が終了し、**Current** 行バージョンと **Proposed** 行バージョンの両方が破棄されます。  **AcceptChanges** または **RejectChanges** を呼び出した後で **EndEdit** または **CancelEdit** を呼び出しても、編集が既に終了しているため、その呼び出しは無効になります。  
+  
+ **BeginEdit**、**EndEdit**、および **CancelEdit** を使用する方法を次の例に示します。  この例では、**ColumnChanged** イベントで **ProposedValue** をチェックして、編集をキャンセルするかどうかを決定しています。  
+  
+```vb  
+Dim workTable As DataTable = New DataTable  
+workTable.Columns.Add("LastName", Type.GetType("System.String"))  
+  
+AddHandler workTable.ColumnChanged, _  
+  New DataColumnChangeEventHandler(AddressOf OnColumnChanged)  
+  
+Dim workRow As DataRow = workTable.NewRow()  
+workRow(0) = "Smith"  
+workTable.Rows.Add(workRow)  
+  
+workRow.BeginEdit()  
+' Causes the ColumnChanged event to write a message and cancel the edit.  
+workRow(0) = ""       
+workRow.EndEdit()  
+  
+' Displays "Smith, New".  
+Console.WriteLine("{0}, {1}", workRow(0), workRow.RowState)  
+  
+Private Shared Sub OnColumnChanged( _  
+  sender As Object, args As DataColumnChangeEventArgs)  
+  If args.Column.ColumnName = "LastName" Then  
+    If args.ProposedValue.ToString() = "" Then  
+      Console.WriteLine("Last Name cannot be blank.  Edit canceled.")  
+      args.Row.CancelEdit()  
+    End If  
+  End If  
+End Sub  
+  
+```  
+  
+```csharp  
+DataTable workTable  = new DataTable();  
+workTable.Columns.Add("LastName", typeof(String));  
+  
+workTable.ColumnChanged +=   
+  new DataColumnChangeEventHandler(OnColumnChanged);  
+  
+DataRow workRow = workTable.NewRow();  
+workRow[0] = "Smith";  
+workTable.Rows.Add(workRow);  
+  
+workRow.BeginEdit();  
+// Causes the ColumnChanged event to write a message and cancel the edit.  
+workRow[0] = "";       
+workRow.EndEdit();  
+  
+// Displays "Smith, New".  
+Console.WriteLine("{0}, {1}", workRow[0], workRow.RowState);    
+  
+protected static void OnColumnChanged(  
+  Object sender, DataColumnChangeEventArgs args)  
+{  
+  if (args.Column.ColumnName == "LastName")  
+    if (args.ProposedValue.ToString() == "")  
+    {  
+      Console.WriteLine("Last Name cannot be blank. Edit canceled.");  
+      args.Row.CancelEdit();  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataRowVersion>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [DataTable イベントの処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md
new file mode 100644
index 00000000000..fbd49f80f5c
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md
@@ -0,0 +1,47 @@
+---
+title: "DataTable スキーマの定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efbcdda4-f5a9-421d-8be2-4c194c74552f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable スキーマの定義
+テーブルのスキーマ \(構造\) は、列と制約で表されます。  <xref:System.Data.DataTable> のスキーマは、<xref:System.Data.DataColumn>、<xref:System.Data.ForeignKeyConstraint>、<xref:System.Data.UniqueConstraint> の各オブジェクトを使用して定義します。  テーブルの列は、データ ソースの列に割り当てたり、式で算出された値を格納したり、格納されている値を自動的にインクリメントしたり、主キー値を格納したりできます。  
+  
+ テーブルの列、リレーション、および制約を名前で参照する場合は、大文字と小文字が区別されます。  複数の列、リレーション、または制約の名前が同じであっても、大文字と小文字が異なっていれば、1 つのテーブルで使用できます。  たとえば、**Col1** と **col1** を同時に使用できます。  この場合、列を名前で参照するときは、列名の大文字と小文字を正確に指定する必要があります。正確に指定しない場合は、例外がスローされます。  たとえば、テーブル **myTable** に列 **Col1** と列 **col1** がある場合、**Col1** は名前 **myTable.Columns\["Col1"\]** で参照され、**col1** は名前 **myTable.Columns\["col1"\]** で参照されます。  いずれかの列を **myTable.Columns\["COL1"\]** という名前で参照しようとすると、例外が生成されます。  
+  
+ 大文字と小文字の区別の規則は、特定の名前の列、リレーション、または制約が 1 つしかない場合には適用されません。  つまり、特定の列、リレーション、または制約オブジェクトと名前が一致する列、リレーション、または制約オブジェクトがテーブルに存在しない場合は、大文字と小文字を区別せずにそのオブジェクトを名前で参照することができます。このとき、例外はスローされません。  たとえば、テーブルに **Col1** が 1 つしかない場合は、**my.Columns\["COL1"\]** を使用してこの列を参照できます。  
+  
+> [!NOTE]
+>  したがって、この動作は **DataTable** の <xref:System.Data.DataTable.CaseSensitive%2A> プロパティの影響を受けません。  **CaseSensitive** プロパティは、テーブルのデータに適用され、並べ替え、検索、フィルター処理、制約の適用などに影響を及ぼします。このプロパティは、テーブルの列、リレーション、および制約の参照には適用されません。  
+  
+## このセクションの内容  
+ [DataTable への列の追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-columns-to-a-datatable.md)  
+ **DataColumn** オブジェクトを使用して、テーブルの列を定義する方法について説明します。  
+  
+ [式列の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-expression-columns.md)  
+ 列の **Expression** プロパティを使用して、同じ行にある他の列の値を基に値を計算する方法について説明します。  
+  
+ [AutoIncrement 列の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md)  
+ 数値を自動的にインクリメントして行ごとに一意の列値が割り当てられるように列を設定する方法について説明します。  
+  
+ [主キーの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md)  
+ 1 つ以上の **DataColumn** オブジェクトからテーブルの主キーを指定する方法について説明します。  
+  
+ [DataTable の制約](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-constraints.md)  
+ テーブルの列の外部キー制約と UNIQUE 制約を定義する方法について説明します。  
+  
+## 参照  
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md b/docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md
new file mode 100644
index 00000000000..3512c56be8c
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md
@@ -0,0 +1,35 @@
+---
+title: "DataTableReaders | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97546ae2-0e42-4d26-961d-e0b244d81ded
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTableReaders
+<xref:System.Data.DataTableReader> は、<xref:System.Data.DataTable> または <xref:System.Data.DataSet> の内容を、読み取り専用かつ前方参照専用の 1 つ以上の結果セットとして表します。  
+  
+ **DataTable** から **DataTableReader** を作成すると、**DataTableReader** オブジェクトには、その作成元である **DataTable** と同一データ \(ただし、Deleted とマークされた行は除く\) を持つ結果セットが 1 つ設定されます。  各列は、元の **DataTable** と同じ順序で格納されます。  
+  
+ <xref:System.Data.DataSet.CreateDataReader%2A> の呼び出しにより **DataTableReader** を作成した場合、**DataTableReader** に複数の結果セットが含まれる場合があります。  結果は、**DataSet** オブジェクトの <xref:System.Data.DataSet.Tables%2A> コレクション内の **DataTables** と同じ順序になります。  
+  
+## このセクションの内容  
+ [DataReader の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datareader.md)  
+ **DataTableReader** オブジェクトの作成方法について説明します。  
+  
+ [DataTable の移動](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/navigating-datatables.md)  
+ **Read** メソッドを使用して、**DataTableReader** の内容を取得する方法について説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/datatables.md b/docs/framework/data/adonet/dataset-datatable-dataview/datatables.md
new file mode 100644
index 00000000000..1efca48593d
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/datatables.md
@@ -0,0 +1,66 @@
+---
+title: "DataTable | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52ff0e32-3e5a-41de-9a3b-7b04ea52b83e
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable
+<xref:System.Data.DataSet> は、テーブル、リレーションシップ、および制約のコレクションで構成されます。  ADO.NET では、**DataSet** 内のテーブルを表すために <xref:System.Data.DataTable> オブジェクトを使用します。  **DataTable** は、1 つのメモリ内のリレーショナル データ テーブルを表します。このテーブルのデータは、そのデータが存在する .NET ベース アプリケーションのローカル データですが、**DataAdapter** を使用して Microsoft SQL Server などのデータ ソースから読み込むこともできます。詳細については、「[DataAdapter からの DataSet の読み込み](../../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)」を参照してください。  
+  
+ **DataTable** クラスは、.NET Framework クラス ライブラリ内の **System.Data** 名前空間のメンバーです。  **DataTable** は、単独でも **DataSet** のメンバーとしても作成および使用できます。また、**DataTable** オブジェクトは、<xref:System.Data.DataView> などの他の .NET Framework オブジェクトからも使用できます。  **DataSet** 内のテーブルのコレクションには、**DataSet** オブジェクトの **Tables** プロパティを使用してアクセスします。  
+  
+ テーブルのスキーマ \(構造\) は、列と制約で表されます。  **DataTable** のスキーマは、<xref:System.Data.DataColumn>、<xref:System.Data.ForeignKeyConstraint>、<xref:System.Data.UniqueConstraint> の各オブジェクトを使用して定義します。  テーブルの列は、データ ソースの列に割り当てたり、式で算出された値を格納したり、格納されている値を自動的にインクリメントしたり、主キー値を格納したりできます。  
+  
+ **DataTable** には、スキーマだけでなく、データを格納して順序付けるための行も必要です。  <xref:System.Data.DataRow> クラスは、テーブルに格納される実際のデータを表します。  **DataRow** およびそのプロパティとメソッドを使用して、テーブル内のデータを取得、評価、および操作できます。  行内のデータがアクセスされて変更されたときは、**DataRow** オブジェクトは、変更後の現在の状態と変更前の状態を維持します。  
+  
+ テーブル間で 1 つ以上の列を関連付け、テーブル間の親子のリレーションシップを作成できます。  **DataTable** オブジェクト間のリレーションシップを作成するには、<xref:System.Data.DataRelation> を使用します。  **DataRelation** オブジェクトを使用すると、特定の行に関連付けられた子の行または親の行を返すことができます。  詳細については、「[DataRelation の追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md)」を参照してください。  
+  
+## このセクションの内容  
+ [DataTable の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-a-datatable.md)  
+ **DataTable** を作成して **DataSet** に追加する方法について説明します。  
+  
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)  
+ **DataColumn** オブジェクトと制約の作成および使用について説明します。  
+  
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)  
+ テーブル内のデータを追加、変更、および削除する方法について説明します。  **DataTable** イベントを使用してテーブル内のデータが変更されたかどうかを確認する方法について説明します。  
+  
+ [DataTable イベントの処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md)  
+ 列値が変更された場合や行が追加または削除された場合のイベントなど、**DataTable** で使用できるイベントについて説明します。  
+  
+## 関連項目  
+ [ADO.NET](../../../../../docs/framework/data/adonet/index.md)  
+ ADO.NET のアーキテクチャとコンポーネントについて説明し、ADO.NET を使用して既存のデータ ソースにアクセスしたり、アプリケーション データを管理する方法について説明します。  
+  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)  
+ テーブル間のリレーションシップを作成する方法も含め、ADO.NET の **DataSet** について説明します。  
+  
+ [Constraint クラス](frlrfSystemDataConstraintClassTopic)  
+ **Constraint** オブジェクトの参照情報を提供します。  
+  
+ [DataColumn クラス](frlrfSystemDataDataColumnClassTopic)  
+ **DataColumn** オブジェクトの参照情報を提供します。  
+  
+ [DataSet クラス](frlrfSystemDataDataSetClassTopic)  
+ **DataSet** オブジェクトの参照情報を提供します。  
+  
+ [DataTable クラス](frlrfSystemDataDataTableClassTopic)  
+ **DataTable** オブジェクトの参照情報を提供します。  
+  
+ [クラス ライブラリの概要](../../../../../docs/standard/class-library-overview.md)  
+ **System** 名前空間やその下位レベルの名前空間 **System.Data** を含む .NET Framework クラス ライブラリの概要について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md b/docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md
new file mode 100644
index 00000000000..cb9fd29cf4d
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md
@@ -0,0 +1,70 @@
+---
+title: "DataViews | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0fe5dfa2-c1cd-435f-90b6-b4dd2e3ef34b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataViews
+<xref:System.Data.DataView> では、<xref:System.Data.DataTable> に格納されているデータのさまざまなビューを作成できます。この機能は、データ連結アプリケーションで頻繁に使用されます。  **DataView** を使用すると、さまざまな並べ替え順序を使用してテーブルのデータを公開したり、行の状態やフィルター式に基づいてデータをフィルター処理したりできます。  
+  
+ **DataView** では、基になる **DataTable** のデータの動的ビューが作成されます。ビューの内容、順序、メンバーシップには、変更が反映されます。  これは、**DataTable** の **Select** メソッドとは異なります。このメソッドでは、特定のフィルターまたは並べ替え順序ごとにテーブルから <xref:System.Data.DataRow> 配列が戻されます。戻される配列の内容には、基になるテーブルの変更内容が反映されていますが、メンバーシップと順序は静的です。  **DataView** は動的機能を備えているため、データ連結アプリケーションにとって理想的なオブジェクトです。  
+  
+ **DataView** は、1 つのデータ セットの動的ビューです。データベースのビューと同様に、この動的ビューには、さまざまな並べ替え順序やフィルター処理条件を適用できます。  ただし、データベース ビューとは異なり、**DataView** は、テーブルとしては処理できず、結合テーブルのビューも作成できません。  また、ソース テーブルの既存の列を除外したり、ソース テーブルにない列 \(計算列など\) を追加することはできません。  
+  
+ **DataSet** のすべてのテーブルのビュー設定を管理するには、<xref:System.Data.DataView.DataViewManager%2A> を使用します。  **DataViewManager** を使用すると、各テーブルの既定のビュー設定を簡単に管理できます。  **DataSet** の複数のテーブルにコントロールを連結する最適な方法は、**DataViewManager** に連結する方法です。  
+  
+## このセクションの内容  
+ [DataView の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataview.md)  
+ **DataTable** の **DataView** の作成方法について説明します。  
+  
+ [データの並べ替えとフィルター処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md)  
+ 特定のフィルター条件を満たすデータ行のサブセットを返すか、または特定の並べ替え順序でデータを返すように **DataView** のプロパティを設定する方法について説明します。  
+  
+ [DataRow および DataRowView](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datarows-and-datarowviews.md)  
+ **DataView** によって公開されるデータへのアクセス方法について説明します。  
+  
+ [行の検索](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md)  
+ **DataView** での特定の行の検索方法について説明します。  
+  
+ [ChildView とリレーション](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/childviews-and-relations.md)  
+ **DataView** を使用して親子のリレーションシップからデータ ビューを作成する方法について説明します。  
+  
+ [DataView の変更](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/modifying-dataviews.md)  
+ **DataView** を使用して、基になる **DataTable** のデータを変更する方法について説明します。また、更新の有効化と無効化についても説明します。  
+  
+ [DataView イベントの処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-dataview-events.md)  
+ **DataView** の内容または順序が更新されるときに、**ListChanged** イベントを使用して通知を受信する方法について説明します。  
+  
+ [DataViews の管理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/managing-dataviews.md)  
+ **DataViewManager** を使用して **DataSet** の各テーブルの **DataView** 設定を管理する方法について説明します。  
+  
+## 関連項目  
+ [ASP.NET Web Applications](http://msdn.microsoft.com/ja-jp/a812d7b7-049e-4234-a4c2-6acf690301f6)  
+ ASP.NET アプリケーション、Web フォームおよび Web サービスを作成する場合の概要と詳細なステップごとの手順を示します。  
+  
+ [Windows Applications](http://msdn.microsoft.com/ja-jp/a6bb2180-09b1-4738-b9fd-7fb05fc92f23)  
+ Windows フォームおよびコンソール アプリケーションの操作に関する詳細情報を提供します。  
+  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)  
+ **DataSet** オブジェクトについて説明し、**DataSet** オブジェクトを使用してアプリケーション データを管理する方法も示します。  
+  
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)  
+ **DataTable** オブジェクトについて説明し、アプリケーション データを単独でまたは **DataSet** の一部として管理するために **DataTable** オブジェクトを使用する方法も示します。  
+  
+ [ADO.NET](../../../../../docs/framework/data/adonet/index.md)  
+ ADO.NET のアーキテクチャとコンポーネントについて説明し、ADO.NET を使用して既存のデータ ソースにアクセスしたり、アプリケーション データを管理する方法について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md b/docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md
new file mode 100644
index 00000000000..58ee2487fbb
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md
@@ -0,0 +1,78 @@
+---
+title: "主キーの定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2ea85959-e763-4669-8bd9-46a9dab894bd
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 主キーの定義
+通常、データベース テーブルには、テーブル内の各行を一意に識別する単一の列または複数の列があります。  行を識別するこのような列を、主キーと呼びます。  
+  
+ 1 つの <xref:System.Data.DataColumn> を <xref:System.Data.DataTable> の <xref:System.Data.DataTable.PrimaryKey%2A> として指定すると、テーブルはその列の <xref:System.Data.DataColumn.AllowDBNull%2A> プロパティを **false** に、<xref:System.Data.DataColumn.Unique%2A> プロパティを **true** に自動的に設定します。  複数列の主キーの場合は、**AllowDBNull** プロパティだけが自動的に **false** に設定されます。  
+  
+ <xref:System.Data.DataTable> の **PrimaryKey** プロパティがその値として、1 つ以上の **DataColumn** オブジェクトから成る配列を受け取る例を次に示します。  最初の例は、1 つの列を主キーとして定義しています。  
+  
+```vb  
+workTable.PrimaryKey = New DataColumn() {workTable.Columns("CustID")}  
+  
+' Or  
+  
+Dim columns(1) As DataColumn  
+columns(0) = workTable.Columns("CustID")  
+workTable.PrimaryKey = columns  
+  
+```  
+  
+```csharp  
+workTable.PrimaryKey = new DataColumn[] {workTable.Columns["CustID"]};  
+  
+// Or  
+  
+DataColumn[] columns = new DataColumn[1];  
+columns[0] = workTable.Columns["CustID"];  
+workTable.PrimaryKey = columns;  
+```  
+  
+ 2 つの列を主キーとして定義する例を次に示します。  
+  
+```vb  
+workTable.PrimaryKey = New DataColumn() {workTable.Columns("CustLName"), _  
+                                         workTable.Columns("CustFName")}  
+  
+' Or  
+  
+Dim keyColumn(2) As DataColumn  
+keyColumn(0) = workTable.Columns("CustLName")  
+keyColumn(1) = workTable.Columns("CustFName")  
+workTable.PrimaryKey = keyColumn  
+  
+```  
+  
+```csharp  
+workTable.PrimaryKey = new DataColumn[] {workTable.Columns["CustLName"],   
+                                         workTable.Columns["CustFName"]};  
+  
+// Or  
+  
+DataColumn[] keyColumn = new DataColumn[2];  
+keyColumn[0] = workTable.Columns["CustLName"];  
+keyColumn[1] = workTable.Columns["CustFName"];  
+workTable.PrimaryKey = keyColumn;  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable>   
+ [DataTable スキーマの定義](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-schema-definition.md)   
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md b/docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md
new file mode 100644
index 00000000000..61b8fa19325
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md
@@ -0,0 +1,107 @@
+---
+title: "XML スキーマ (XSD) からの DataSet リレーショナル構造の派生 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f6cd04d-6197-4bc4-9096-8c51c7e4acae
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# XML スキーマ (XSD) からの DataSet リレーショナル構造の派生
+ここでは、XML スキーマ定義言語 \(XSD\) スキーマ ドキュメントから <xref:System.Data.DataSet> のリレーショナル スキーマを生成する方法についての概要を説明します。  一般的には、スキーマの要素の各 **complexType** 子要素に対して、テーブルが **DataSet** に生成されます。  テーブル構造は、複合型の定義に基づいて決定されます。  テーブルは、スキーマのトップレベル要素の **DataSet** に作成されます。  ただし、**complexType** 要素が別の **complexType** 要素内で入れ子になっている場合、テーブルはトップレベルの **complexType** 要素にだけ作成されます。その場合、入れ子になった **complexType** 要素は、**DataSet** 内の <xref:System.Data.DataTable> に割り当てられます。  
+  
+ XSD の詳細については、World Wide Web Consortium \(W3C\) XML スキーマ パート 0:Primer Recommendation、XML スキーマ パート 1:Structures Recommendation、XML スキーマ パート 2:Datatypes Recommendation \([http:\/\/www.w3.org\/](http://www.w3.org/TR/) にあります\) を参照してください。  
+  
+ `customers` 要素が `MyDataSet` 要素の子要素である XML スキーマの例を次に示します。この `MyDataSet` 要素が **DataSet** 要素に該当します。  
+  
+```  
+<xs:schema id="SomeID"   
+            xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+   <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+     <xs:complexType>  
+       <xs:choice maxOccurs="unbounded">  
+         <xs:element name="customers" >   
+           <xs:complexType >  
+             <xs:sequence>  
+               <xs:element name="CustomerID" type="xs:integer"   
+                            minOccurs="0" />  
+               <xs:element name="CompanyName" type="xs:string"   
+                            minOccurs="0" />  
+               <xs:element name="Phone" type="xs:string" />  
+             </xs:sequence>  
+           </xs:complexType>  
+          </xs:element>  
+       </xs:choice>  
+     </xs:complexType>  
+   </xs:element>  
+ </xs:schema>  
+```  
+  
+ 上記の例では、`customers` 要素は複合型の要素です。  したがって、複合型の定義が解析され、割り当て処理によって次のテーブルが作成されます。  
+  
+```  
+Customers (CustomerID , CompanyName, Phone)  
+```  
+  
+ テーブルの各列のデータ型は、それに対応する指定された要素または属性の XML スキーマ型から派生します。  
+  
+> [!NOTE]
+>  `customers` 要素が **integer** のような単純な XML スキーマ データ型である場合、テーブルは生成されません。  テーブルが作成されるのは、複合型のトップレベル要素に対してだけです。  
+  
+ **Schema** 要素に `InStateCustomers` と `OutOfStateCustomers` の 2 つの子要素を持つ XML スキーマの例を次に示します。  
+  
+```  
+<xs:schema id="SomeID"   
+            xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+   <xs:element name="InStateCustomers" type="customerType" />  
+   <xs:element name="OutOfStateCustomers" type="customerType" />  
+    <xs:complexType name="customerType" >  
+  
+     </xs:complexType>  
+  
+   <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+     <xs:complexType>  
+       <xs:choice maxOccurs="unbounded">  
+         <xs:element ref="customers" />  
+       </xs:choice>  
+     </xs:complexType>  
+   </xs:element>  
+ </xs:schema>  
+```  
+  
+ `InStateCustomers` と `OutOfStateCustomers` の 2 つの子要素は、複合型の要素です \(`customerType`\)。  したがって、割り当て処理によって **DataSet** に次の 2 つの同じテーブルが生成されます。  
+  
+```  
+InStateCustomers (CustomerID , CompanyName, Phone)  
+OutOfStateCustomers (CustomerID , CompanyName, Phone)  
+```  
+  
+## このセクションの内容  
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)  
+ **DataSet** での UNIQUE 制約および外部キー制約の作成に使用する XML スキーマの要素について説明します。  
+  
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)  
+ **DataSet** でのテーブル列間のリレーションの生成に使用する XML スキーマの要素について説明します。  
+  
+ [XML スキーマ制約およびリレーションシップ](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/xml-schema-constraints-and-relationships.md)  
+ XML スキーマの要素を使用して **DataSet** に制約を作成するときに、リレーションが暗黙的に生成される方法について説明します。  
+  
+## 関連項目  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)  
+ **DataSet** のリレーショナル構造とデータを XML データとして読み込んで、永続化する方法について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md b/docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md
new file mode 100644
index 00000000000..cbc12e40cdd
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md
@@ -0,0 +1,146 @@
+---
+title: "DiffGram | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 037f3991-7bbc-424b-b52e-8b03585d3e34
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DiffGram
+DiffGram は、データ要素の現在のバージョンと元のバージョンを識別する XML 形式です。  <xref:System.Data.DataSet> では、<xref:System.Data.DataSet> の内容を読み込んで永続化するため、およびネットワーク接続経由で転送する場合にこの内容をシリアル化するために、DiffGram 形式が使用されます。  DiffGram として作成された <xref:System.Data.DataSet> は、スキーマを使用せずに <xref:System.Data.DataSet> の内容を正確に再作成するために必要なすべての情報を DiffGram に格納します。このような情報には、**Original** 行バージョンと **Current** 行バージョンの両方の列値、行エラー情報、行順序などが含まれています。  
+  
+ XML Web サービスから <xref:System.Data.DataSet> を送信または取得するときには、DiffGram 形式が暗黙的に使用されます。  また、**ReadXml** メソッドを使用して XML から <xref:System.Data.DataSet> の内容を読み取るときや、**WriteXml** メソッドを使用して XML に <xref:System.Data.DataSet> の内容を書き込むときは、読み取りまたは書き込みの形式として DiffGram を指定できます。  詳細については、「[XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)」および「[DataSet 内容の XML データとしての書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)」を参照してください。  
+  
+ .NET Framework では、DiffGram 形式は主に <xref:System.Data.DataSet> の内容をシリアル化するときの形式として使用されますが、Microsoft SQL Server データベース内のテーブル データを変更するときにも DiffGrams を使用できます。  
+  
+ Diffgram は、すべてのテーブルの内容を **\<diffgram\>** 要素に書き込むことによって生成されます。  
+  
+### Diffgram を生成するには  
+  
+1.  ルート テーブル \(親を一切持たないテーブル\) のリストを生成します。  
+  
+2.  リストの各テーブルとその子孫について、すべての行の現在のバージョンを最初の Diffgram セクションに書き込みます。  
+  
+3.  <xref:System.Data.DataSet> の各テーブルについて、すべての行の元のバージョン \(存在する場合\) を Diffgram の **\<before\>** セクションに書き込みます。  
+  
+4.  エラーのある行については、そのエラーの内容を Diffgram の **\<errors\>** セクションに書き込みます。  
+  
+ Diffgram は XML ファイルの上から下に向かって処理されます。  
+  
+### Diffgram を処理するには  
+  
+1.  Diffgram の最初のセクションを処理します。このセクションには、行の現在のバージョンが格納されています。  
+  
+2.  2 番目のセクションまたは **\<before\>** セクションを処理します。このセクションには、修正または削除された行の元のバージョンが格納されています。  
+  
+    > [!NOTE]
+    >  行が削除済みとしてマークされていた場合、削除操作によってその行の子孫も削除される場合があります。この点は、現在の <xref:System.Data.DataSet> の `Cascade` プロパティに依存します。  
+  
+3.  **\<errors\>** セクションを処理します。  このセクションの各項目について、指定された行および列のエラー情報を設定します。  
+  
+> [!NOTE]
+>  <xref:System.Data.XmlWriteMode> を Diffgram に設定した場合、ターゲット <xref:System.Data.DataSet> の内容が、元の <xref:System.Data.DataSet> の内容と異なる場合があります。  
+  
+## DiffGram 形式  
+ DiffGram 形式は、現在のデータ、元のデータ \(または前のデータ\)、エラーの 3 つのセクションから構成されています。DiffGram の例を次に示します。  
+  
+```  
+<?xml version="1.0"?>  
+<diffgr:diffgram   
+         xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"  
+         xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1"  
+         xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
+  
+   <DataInstance>  
+   </DataInstance>  
+  
+  <diffgr:before>  
+  </diffgr:before>  
+  
+  <diffgr:errors>  
+  </diffgr:errors>  
+</diffgr:diffgram>  
+```  
+  
+ DiffGram 形式を構成するデータ ブロックについて次に説明します。  
+  
+ **\<**  ***DataInstance***  **\>**  
+ このドキュメントでは、説明の目的でこの要素の名前である ***DataInstance*** を使用します。  ***DataInstance*** 要素は、<xref:System.Data.DataTable> の行または <xref:System.Data.DataSet> を表します。  実際には *DataInstance* の代わりに <xref:System.Data.DataSet> または <xref:System.Data.DataTable> の名前がこの要素に含まれます。  DiffGram 形式のこのブロックには現在のデータが含まれています。現在のデータは、変更されている場合と未変更の場合があります。  変更されている要素 \(行\) を識別するため、このような要素には **diffgr:hasChanges** 注釈が付きます。  
+  
+ **\<diffgr:before\>**  
+ DiffGram 形式のこのブロックには、行の元の内容が含まれています。  このブロックの要素は、**diffgr:id** 注釈を使用して ***DataInstance*** ブロックの内容と対応しています。  
+  
+ **\<diffgr:errors\>**  
+ DiffGram 形式のこのブロックには、***DataInstance*** ブロックの特定の行に関するエラー情報が含まれています。  このブロックの要素は、**diffgr:id** 注釈を使用して ***DataInstance*** ブロックの内容と対応しています。  
+  
+## DiffGram 注釈  
+ DiffGram では、<xref:System.Data.DataSet> の行バージョンやエラー情報を表すさまざまな DiffGram ブロックの要素を関連付けるため、いくつかの注釈が使用されます。  
+  
+ DiffGram 名前空間 **urn:schemas\-microsoft\-com:xml\-diffgram\-v1** で定義されている DiffGram 注釈を次の表に示します。  
+  
+|注釈|説明|  
+|--------|--------|  
+|**id**|**\<diffgr:before\>** ブロックと **\<diffgr:errors\>** ブロックの要素を **\<** ***DataInstance*** **\>** ブロックの要素と対応させるために使用されます。  **diffgr:id** 注釈の値は *\[TableName\]\[RowIdentifier\]* という形式で指定されます。  たとえば、`<Customers diffgr:id="Customers1">` のように指定します。|  
+|**parentId**|現在の要素の親要素である **\<** ***DataInstance*** **\>** ブロックの要素を識別します。  **diffgr:parentId** 注釈の値は *\[TableName\]\[RowIdentifier\]* という形式で指定されます。  たとえば、`<Orders diffgr:parentId="Customers1">` のように指定します。|  
+|**hasChanges**|**\<**  ***DataInstance***  **\>** ブロックの行を変更済みとして識別します。  **hasChanges** 注釈には、次の 2 つのうち、いずれかの値を指定できます。<br /><br /> **inserted**<br /> **Added** 行を識別します。<br /><br /> **modified**<br /> 対応する **Original** 行バージョンが **\<\<diffgr:before\>\>** ブロックに含まれている **Modified** 行を識別します。  **Deleted** 行の場合、対応する **Original** 行バージョンが **\<diffgr:before\>** ブロックには存在しますが、**\<** ***DataInstance*** **\>** ブロックには注釈付き要素が存在しません。|  
+|**hasErrors**|**\<**  ***DataInstance***  **\>** ブロック内で **RowError** がある行を識別します。  エラー要素は **\<diffgr:errors\>** ブロックに挿入されます。|  
+|**Error**|**\<diffgr:errors\>** ブロック内の特定の要素に関する **RowError** のテキストが含まれています。|  
+  
+ <xref:System.Data.DataSet> の内容が DiffGram として読み取られる、または書き込まれるときには、上記以外の注釈も含まれます。  名前空間 **urn:schemas\-microsoft\-com:xml\-msdata** で定義されている追加の注釈を次の表に示します。  
+  
+|注釈|説明|  
+|--------|--------|  
+|**RowOrder**|元のデータの行順序を保持し、特定の <xref:System.Data.DataTable> の行のインデックスを識別します。|  
+|**非表示**|特定の列を **ColumnMapping** プロパティが **MappingType.Hidden** に設定されている列として識別します。  この属性は、**msdata:hidden** *\[ColumnName\]*\="*value*" という形式で書き込まれます。  たとえば、`<Customers diffgr:id="Customers1" msdata:hiddenContactTitle="Owner">` のように指定します。<br /><br /> データが格納されている隠し列だけが DiffGram 属性として書き込まれます。  それ以外の場合は無視されます。|  
+  
+## DiffGram のサンプル  
+ DiffGram 形式の例を次に示します。  この例では、変更のコミット前のテーブル内の行に対する更新結果が示されています。  CustomerID の "ALFKI" である行は変更されていますが、更新されていません。  このため、**\<** ***DataInstance*** **\>** ブロックに **diffgr:id** が "Customers1" の **Current** 行があり、**\<diffgr:before\>** ブロックに **diffgr:id** が "Customers1" の **Original** 行があります。  CustomerID が "ANATR" である行には **RowError** が含まれているため、この行には `diffgr:hasErrors="true"` という注釈が付いています。**\<diffgr:errors\>** ブロックに、この行に関連する要素があります。  
+  
+```  
+<diffgr:diffgram xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
+  <CustomerDataSet>  
+    <Customers diffgr:id="Customers1" msdata:rowOrder="0" diffgr:hasChanges="modified">  
+      <CustomerID>ALFKI</CustomerID>  
+      <CompanyName>New Company</CompanyName>  
+    </Customers>  
+    <Customers diffgr:id="Customers2" msdata:rowOrder="1" diffgram:hasErrors="true">  
+      <CustomerID>ANATR</CustomerID>  
+      <CompanyName>Ana Trujillo Emparedados y Helados</CompanyName>  
+    </Customers>  
+    <Customers diffgr:id="Customers3" msdata:rowOrder="2">  
+      <CustomerID>ANTON</CustomerID>  
+      <CompanyName>Antonio Moreno Taquera</CompanyName>  
+    </Customers>  
+    <Customers diffgr:id="Customers4" msdata:rowOrder="3">  
+      <CustomerID>AROUT</CustomerID>  
+      <CompanyName>Around the Horn</CompanyName>  
+    </Customers>  
+  </CustomerDataSet>  
+  <diffgr:before>  
+    <Customers diffgr:id="Customers1" msdata:rowOrder="0">  
+      <CustomerID>ALFKI</CustomerID>  
+      <CompanyName>Alfreds Futterkiste</CompanyName>  
+    </Customers>  
+  </diffgr:before>  
+  <diffgr:errors>  
+    <Customers diffgr:id="Customers2" diffgr:Error="An optimistic concurrency violation has occurred for this row."/>  
+  </diffgr:errors>  
+</diffgr:diffgram>  
+```  
+  
+## 参照  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [DataSet 内容の XML データとしての書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md b/docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md
new file mode 100644
index 00000000000..32e88f55c6e
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md
@@ -0,0 +1,106 @@
+---
+title: "行の検索 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5da300e2-74c0-4d13-9202-fc20ed8212d8
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 行の検索
+<xref:System.Data.DataView> の <xref:System.Data.DataView.Find%2A> メソッドと <xref:System.Data.DataView.FindRows%2A> メソッドを使用すると、並べ替えキーの値に基づいて行を検索できます。  **Find** メソッドと **FindRows** メソッドによる検索で、値の大文字と小文字が区別されるかどうかは、基になる <xref:System.Data.DataTable> の **CaseSensitive** プロパティによって決まります。  検索結果を返すには、検索値が既存の並べ替えキーの値と完全に一致している必要があります。  
+  
+ **Find** メソッドは、検索条件に一致する <xref:System.Data.DataRowView> のインデックスの整数値を返します。  複数の行が検索条件に一致する場合は、一致した最初の **DataRowView** が返されます。  一致する DataRowView がない場合には、**Find** は \-1 を返します。  
+  
+ 複数の行に一致する検索結果を返すには、**FindRows** メソッドを使用します。  **FindRows** は **Find** メソッドと同様に機能しますが、**DataView** 内で条件に一致するすべての行を参照する **DataRowView** 配列を返す点が **Find** メソッドとは異なります。  一致する行が見つからない場合、**DataRowView** 配列は空になります。  
+  
+ **Find** メソッドまたは **FindRows** メソッドを使用するには、並べ替え順序を指定する必要があります。並べ替え順序を指定するには、**ApplyDefaultSort** を **true** に設定するか、または **Sort** プロパティを使用します。  並べ替え順序が指定されないと、例外がスローされます。  
+  
+ **Find** メソッドと **FindRows** メソッドには、並べ替え順序に指定されている列の数と長さが一致する値配列を入力として渡します。  1 つの列に基づく並べ替えの場合は、1 つの値を渡します。  複数列に基づく並べ替えの場合は、オブジェクトの配列を渡します。  複数列に基づく並べ替えでは、オブジェクト配列の値の順序が、**DataView** の **Sort** プロパティに指定されている列の順序と一致する必要があります。  
+  
+ 1 列の並べ替え順序が設定されている **DataView** に対して **Find** メソッドを呼び出すコード サンプルを次に示します。  
+  
+```vb  
+Dim custView As DataView = _  
+  New DataView(custDS.Tables("Customers"), "", _  
+  "CompanyName", DataViewRowState.CurrentRows)  
+  
+Dim rowIndex As Integer = custView.Find("The Cracker Box")  
+  
+If rowIndex = -1 Then  
+  Console.WriteLine("No match found.")  
+Else  
+  Console.WriteLine("{0}, {1}", _  
+    custView(rowIndex)("CustomerID").ToString(), _  
+    custView(rowIndex)("CompanyName").ToString())  
+End If  
+  
+```  
+  
+```csharp  
+DataView custView = new DataView(custDS.Tables["Customers"], "",   
+  "CompanyName", DataViewRowState.CurrentRows);  
+  
+int rowIndex = custView.Find("The Cracker Box");  
+  
+if (rowIndex == -1)  
+  Console.WriteLine("No match found.");  
+else  
+  Console.WriteLine("{0}, {1}",  
+    custView[rowIndex]["CustomerID"].ToString(),  
+    custView[rowIndex]["CompanyName"].ToString());  
+```  
+  
+ **Sort** プロパティで複数の列が指定される場合は、次のコード サンプルに示すように、各列に対応する検索値を **Sort** プロパティで指定されている順序で格納したオブジェクト配列を渡す必要があります。  
+  
+```vb  
+Dim custView As DataView = _  
+  New DataView(custDS.Tables("Customers"), "", _  
+  "CompanyName, ContactName", _  
+  DataViewRowState.CurrentRows)  
+  
+Dim foundRows() As DataRowView = _  
+  custView.FindRows(New object() {"The Cracker Box", "Liu Wong"})  
+  
+If foundRows.Length = 0 Then  
+  Console.WriteLine("No match found.")  
+Else  
+  Dim myDRV As DataRowView  
+  For Each myDRV In foundRows  
+    Console.WriteLine("{0}, {1}", _  
+      myDRV("CompanyName").ToString(), myDRV("ContactName").ToString())  
+  Next  
+End If  
+  
+```  
+  
+```csharp  
+DataView custView = new DataView(custDS.Tables["Customers"], "",  
+  "CompanyName, ContactName",  
+  DataViewRowState.CurrentRows);  
+  
+DataRowView[] foundRows =   
+  custView.FindRows(new object[] {"The Cracker Box", "Liu Wong"});  
+  
+if (foundRows.Length == 0)  
+  Console.WriteLine("No match found.");  
+else  
+  foreach (DataRowView myDRV in foundRows)  
+    Console.WriteLine("{0}, {1}", myDRV["CompanyName"].ToString(),   
+      myDRV["ContactName"].ToString());  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md b/docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md
new file mode 100644
index 00000000000..b38c5bb6bc6
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md
@@ -0,0 +1,110 @@
+---
+title: "XML スキーマ (XSD) からの DataSet リレーションの生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c9a1413-c0d2-4447-88ba-9a2b0cbc0aa8
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ (XSD) からの DataSet リレーションの生成
+<xref:System.Data.DataSet> では、親子のリレーションを作成することにより、2 つ以上の列間の関連付けを行います。  XML スキーマ定義言語 \(XSD\) スキーマ内で **DataSet** のリレーションを表すには、次の 3 つの方法があります。  
+  
+-   入れ子になった複合型を指定する方法  
+  
+-   **msdata:Relationship** 注釈を使用する方法  
+  
+-   **msdata:ConstraintOnly** 注釈を使用せずに **xs:keyref** を指定する方法  
+  
+## 入れ子になった複合型  
+ スキーマ内で複数の複合型の定義が入れ子になっている場合は、それらの入れ子状の要素間に親子のリレーションシップがあります。  **OrderDetail** が **Order** 要素の子要素であることを示す XML スキーマのフラグメントを次に示します。  
+  
+```  
+<xs:element name="Order">  
+  <xs:complexType>  
+     <xs:sequence>          
+       <xs:element name="OrderDetail" />  
+           <xs:complexType>               
+           </xs:complexType>  
+     </xs:sequence>  
+  </xs:complexType>  
+</xs:element>  
+```  
+  
+ XML スキーマの割り当て処理によって、スキーマの入れ子になった複合型に対応する **DataSet** にテーブルが作成されます。  また、生成されたテーブルの親子列として使用される追加列も作成されます。  その親子列ではリレーションシップが指定されますが、主キー制約や外部キー制約の指定とは異なるため注意してください。  
+  
+## msdata:Relationship 注釈  
+ **msdata:Relationship** 注釈を使用すると、入れ子になっていないスキーマの要素間の親子のリレーションシップを明示的に指定できます。  **Relationship** 要素の構造を示す例を次に示します。  
+  
+```  
+  
+  <msdata:Relationship name="CustOrderRelationship"    
+msdata:parent=""    
+msdata:child=""    
+msdata:parentkey=""    
+msdata:childkey="" />  
+```  
+  
+ **msdata:Relationship** 注釈の属性は、リレーションシップに必要な **parentkey** 要素と **childkey** 要素、および属性と同様に親子のリレーションシップに必要な要素を示します。  割り当て処理では、その情報に基づいて **DataSet** にテーブルを作成し、それらのテーブル間に主キー\/外部キーのリレーションシップを作成します。  
+  
+ たとえば、同じレベルで \(入れ子にせずに\) **Order** 要素と **OrderDetail** 要素を指定するスキーマのフラグメントを次に示します。  スキーマに **msdata:Relationship** 注釈を指定すると、その 2 つの要素間に親子のリレーションシップが指定されます。  この場合、**msdata:Relationship** 注釈を使用してリレーションシップを明示的に指定する必要があります。  
+  
+```  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+        <xs:element name="OrderDetail">  
+          <xs:complexType>  
+  
+          </xs:complexType>  
+       </xs:element>  
+       <xs:element name="Order">  
+          <xs:complexType>  
+  
+          </xs:complexType>  
+       </xs:element>  
+    </xs:choice>  
+  </xs:complexType>  
+</xs:element>  
+   <xs:annotation>  
+     <xs:appinfo>  
+       <msdata:Relationship name="OrdOrdDetailRelation"  
+          msdata:parent="Order"  
+          msdata:child="OrderDetail"   
+          msdata:parentkey="OrderNumber"  
+          msdata:childkey="OrderNo"/>  
+     </xs:appinfo>  
+  </xs:annotation>  
+  
+```  
+  
+ 割り当て処理では、**Relationship** 要素を使用して、**DataSet** にある **Order** テーブルの **OrderNumber** 列と **OrderDetail** テーブルの **OrderNo** 列に親子のリレーションシップが生成されます。  割り当て処理で指定されるのはリレーションシップだけで、リレーショナル データベースにおける主キー制約や外部キー制約の場合とは異なり、該当する列の値に対する制約が自動的に指定されることはありません。  
+  
+### このセクションの内容  
+ [入れ子になっているスキーマ要素間の暗黙的なリレーションの割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-implicit-relations-between-nested-schema-elements.md)  
+ XML スキーマ内で要素が入れ子になっている場合に、**DataSet** 内に暗黙的に作成される制約とリレーションについて説明します。  
+  
+ [入れ子になっている要素に指定したリレーションシップの割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-relations-specified-for-nested-elements.md)  
+ XML スキーマで入れ子になっている要素に対して、**DataSet** におけるリレーションを明示的に設定する方法について説明します。  
+  
+ [入れ子になっていない要素間のリレーションの指定](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/specify-relations-between-elements-with-no-nesting.md)  
+ XML スキーマで入れ子になっていない要素間に、**DataSet** におけるリレーションを作成する方法について説明します。  
+  
+### 関連項目  
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)  
+ XML スキーマ定義言語 \(XSD\) スキーマから作成された **DataSet** のリレーショナル構造 \(スキーマ\) について説明します。  
+  
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)  
+ **DataSet** での UNIQUE 制約および外部キー制約の作成に使用する XML スキーマの要素について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/generating-strongly-typed-datasets.md b/docs/framework/data/adonet/dataset-datatable-dataview/generating-strongly-typed-datasets.md
new file mode 100644
index 00000000000..9aed990ffd4
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/generating-strongly-typed-datasets.md
@@ -0,0 +1,108 @@
+---
+title: "厳密に型指定された DataSet の生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54333cbf-bb43-4314-a7d4-6dc1dd1c44b3
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# 厳密に型指定された DataSet の生成
+XML スキーマ定義言語 \(XSD\) 標準に準拠する XML スキーマがあれば、[!INCLUDE[winsdklong](../../../../../includes/winsdklong-md.md)] に付属の XSD.exe ツールを使用して、厳密に型指定された <xref:System.Data.DataSet> を生成できます。  
+  
+ \(データベース テーブルから xsd を作成するには、「<xref:System.Data.DataSet.WriteXmlSchema%2A>」または「[Visual Studio でのデータセットの操作](http://msdn.microsoft.com/library/8bw9ksd6.aspx)」 を参照してください。\)  
+  
+ XSD.exe ツールを使用して **DataSet** を生成する構文を次のコードで示します。  
+  
+```  
+xsd.exe /d /l:CS XSDSchemaFileName.xsd /eld /n:XSDSchema.Namespace  
+```  
+  
+ この構文では、`/d` ディレクティブが **DataSet** を生成することを知らせます。また、`/l:` は使用する言語 \(C\#、Visual Basic .NET など\) をツールに知らせます。  オプションの `/eld` ディレクティブを指定すると、生成された **DataSet** に対し、[!INCLUDE[linq_dataset](../../../../../includes/linq-dataset-md.md)] を使用してクエリを実行できます。このオプションは、`/d` オプションと組み合わせて指定します。  詳細については、「[Querying Typed DataSets](../../../../../docs/framework/data/adonet/querying-typed-datasets.md)」を参照してください。  オプションの `/n:` ディレクティブは、**XSDSchema.Namespace** と呼ばれる **DataSet** の名前空間も生成することをツールに知らせます。  コマンドの出力は XSDSchemaFileName.cs で、ADO.NET アプリケーションでコンパイルおよび使用できます。  生成されたコードをライブラリまたはモジュールとしてコンパイルできます。  
+  
+ C\# コンパイラ \(csc.exe\) を使用して、生成されたコードをライブラリとしてコンパイルする構文を次のコードで示します。  
+  
+```  
+csc.exe /t:library XSDSchemaFileName.cs /r:System.dll /r:System.Data.dll  
+```  
+  
+ `/t:` ディレクティブはライブラリとしてコンパイルすることをツールに知らせ、`/r:` ディレクティブはコンパイルに必要な依存ライブラリを指定します。  コマンドの出力は XSDSchemaFileName.dll で、`/r:` ディレクティブによる ADO.NET アプリケーションのコンパイル時にコンパイラに渡すことができます。  
+  
+ ADO.NET アプリケーションの XSD.exe に渡された名前空間にアクセスする構文を次のコードで示します。  
+  
+```vb  
+Imports XSDSchema.Namespace  
+  
+```  
+  
+```csharp  
+using XSDSchema.Namespace;  
+```  
+  
+ **CustomerDataSet** という名前の型指定された **DataSet** を使用して、**Northwind** データベースから顧客リストを読み込むコード サンプルを次に示します。  **Fill** メソッドを使用してデータが読み込まれると、例では、型指定された **CustomersRow** \(**DataRow**\) オブジェクトを使用して、**Customers** テーブルの各顧客をループします。  これにより、**DataColumnCollection** を経由せずに **CustomerID** 列に直接アクセスできます。  
+  
+```vb  
+Dim customers As CustomerDataSet= New CustomerDataSet()  
+Dim adapter As SqlDataAdapter New SqlDataAdapter( _  
+  "SELECT * FROM dbo.Customers;", _  
+  "Data Source=(local);Integrated " & _  
+  "Security=SSPI;Initial Catalog=Northwind")  
+  
+adapter.Fill(customers, "Customers")  
+  
+Dim customerRow As CustomerDataSet.CustomersRow  
+For Each customerRow In customers.Customers  
+  Console.WriteLine(customerRow.CustomerID)  
+Next  
+  
+```  
+  
+```csharp  
+CustomerDataSet customers = new CustomerDataSet();  
+SqlDataAdapter adapter = new SqlDataAdapter(  
+  "SELECT * FROM dbo.Customers;",  
+  "Data Source=(local);Integrated " +  
+  "Security=SSPI;Initial Catalog=Northwind");  
+  
+adapter.Fill(customers, "Customers");  
+  
+foreach(CustomerDataSet.CustomersRow customerRow in customers.Customers)  
+  Console.WriteLine(customerRow.CustomerID);  
+```  
+  
+ 例に使用された XML スキーマを次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema id="CustomerDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  <xs:element name="CustomerDataSet" msdata:IsDataSet="true">  
+    <xs:complexType>  
+      <xs:choice maxOccurs="unbounded">  
+        <xs:element name="Customers">  
+          <xs:complexType>  
+            <xs:sequence>  
+              <xs:element name="CustomerID" type="xs:string" minOccurs="0" />  
+            </xs:sequence>  
+          </xs:complexType>  
+        </xs:element>  
+      </xs:choice>  
+    </xs:complexType>  
+  </xs:element>  
+</xs:schema>  
+```  
+  
+## 参照  
+ <xref:System.Data.DataColumnCollection>   
+ <xref:System.Data.DataSet>   
+ [型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md b/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md
new file mode 100644
index 00000000000..8cbecb61246
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md
@@ -0,0 +1,67 @@
+---
+title: "DataSet のイベント処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54edefe0-bc38-419b-b486-3d8a0c356f13
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet のイベント処理
+<xref:System.Data.DataSet> オブジェクトには、<xref:System.ComponentModel.MarshalByValueComponent.Disposed>、<xref:System.Data.DataSet.Initialized>、<xref:System.Data.DataSet.MergeFailed> という 3 つのイベントがあります。  
+  
+## MergeFailed イベント  
+ `DataSet` オブジェクトのイベントの中で最も使用頻度が高いイベントは、マージしようとしている `MergeFailed` オブジェクトのスキーマが競合する場合に発生する `DataSet` です。 この状況は、ターゲットとソースの <xref:System.Data.DataRow> が同じ主キー値を持ち、なおかつ、<xref:System.Data.DataSet.EnforceConstraints%2A> プロパティが `true` に設定されている場合に発生します。 たとえば、マージ対象のテーブルの主キーの列が 2 つの `DataSet` オブジェクトのテーブル間で同じ場合、例外がスローされ、`MergeFailed` イベントが発生します。<xref:System.Data.MergeFailedEventArgs> イベントに渡される `MergeFailed` オブジェクトには、2 つの <xref:System.Data.MergeFailedEventArgs.Conflict%2A> オブジェクト間のスキーマで発生した競合を示す `DataSet` プロパティ、および競合が発生したテーブルの名前を示す <xref:System.Data.MergeFailedEventArgs.Table%2A> プロパティがあります。  
+  
+ 次のコードは、`MergeFailed` イベントのイベント ハンドラーを追加する方法を示しています。  
+  
+```vb  
+AddHandler workDS.MergeFailed, New MergeFailedEventHandler( _  
+  AddressOf DataSetMergeFailed)  
+  
+Private Shared Sub DataSetMergeFailed(  _  
+  sender As Object,args As MergeFailedEventArgs)  
+  Console.WriteLine("Merge failed for table " & args.Table.TableName)  
+  Console.WriteLine("Conflict = " & args.Conflict)  
+End Sub  
+  
+```  
+  
+```csharp  
+workDS.MergeFailed += new MergeFailedEventHandler(DataSetMergeFailed);  
+  
+private static void DataSetMergeFailed(  
+  object sender, MergeFailedEventArgs args)  
+{  
+  Console.WriteLine("Merge failed for table " + args.Table.TableName);  
+  Console.WriteLine("Conflict = " + args.Conflict);  
+}  
+```  
+  
+## Initialized イベント  
+ <xref:System.Data.DataSet.Initialized> イベントは、`DataSet` のコンストラクターによって `DataSet` の新しいインスタンスが初期化された後に発生します。  
+  
+ <xref:System.Data.DataSet.IsInitialized%2A> プロパティは、`true` の初期化が完了した場合に `DataSet` を返します。それ以外の場合は `false` を返します。 この値は、<xref:System.Data.DataSet.BeginInit%2A> の初期化を開始する `DataSet` メソッドによって <xref:System.Data.DataSet.IsInitialized%2A> が `false` に設定されます。 また、<xref:System.Data.DataSet.EndInit%2A> の初期化を終了する `DataSet` メソッドによって `true` に設定されます。 これらのメソッドは、別のコンポーネントによって使用されている [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] を初期化する目的で、`DataSet` のデザイン環境によって使用されます。 通常、コード内で直接使用することはありません。  
+  
+## Disposed イベント  
+ `DataSet` は、<xref:System.ComponentModel.MarshalByValueComponent> メソッドおよび <xref:System.ComponentModel.MarshalByValueComponent.Dispose%2A> イベントの両方を公開する <xref:System.ComponentModel.MarshalByValueComponent.Disposed> クラスから派生しています。<xref:System.ComponentModel.MarshalByValueComponent.Disposed>イベントでは、コンポーネントが破棄されたことを伝えるイベントを待機するためのイベント ハンドラーを追加します。<xref:System.ComponentModel.MarshalByValueComponent.Disposed> の `DataSet` イベントを使用することで、<xref:System.ComponentModel.MarshalByValueComponent.Dispose%2A> メソッドが呼び出されたときにコードを実行できます。<xref:System.ComponentModel.MarshalByValueComponent.Dispose%2A> は、<xref:System.ComponentModel.MarshalByValueComponent> で使用したリソースを解放します。  
+  
+> [!NOTE]
+>  `DataSet` オブジェクトと `DataTable` オブジェクトは <xref:System.ComponentModel.MarshalByValueComponent> から継承し、リモート処理用の <xref:System.Runtime.Serialization.ISerializable> インターフェイスをサポートします。 これらは、リモート処理ができる唯一の ADO.NET オブジェクトです。 詳細については、「[Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)」を参照してください。  
+  
+ `DataSet` の使用時に使用できるその他のイベントについては、「[DataTable イベントの処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md)」および「[DataAdapter のイベント処理](../../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [データの検証](../Topic/Validating%20Data.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md b/docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md
new file mode 100644
index 00000000000..1624a428a8d
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md
@@ -0,0 +1,90 @@
+---
+title: "DataTable イベントの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62f404a5-13ea-4b93-a29f-55b74a16c9d3
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable イベントの処理
+<xref:System.Data.DataTable> オブジェクトは、アプリケーションが処理できる一連のイベントを提供します。  `DataTable` のイベントを次の表に示します。  
+  
+|Event|説明|  
+|-----------|--------|  
+|<xref:System.Data.DataTable.Initialized>|`DataTable` の <xref:System.Data.DataTable.EndInit%2A> メソッドが呼び出された後に発生します。  このイベントは、主にデザイン時のシナリオをサポートすることを目的としています。|  
+|<xref:System.Data.DataTable.ColumnChanged>|<xref:System.Data.DataColumn> で値が正常に変更された後に発生します。|  
+|<xref:System.Data.DataTable.ColumnChanging>|`DataColumn` に対して値が送信されたときに発生します。|  
+|<xref:System.Data.DataTable.RowChanged>|`DataColumn` 値または `DataTable` の <xref:System.Data.DataRow> の <xref:System.Data.DataRow.RowState%2A> が正常に変更された後で発生します。|  
+|<xref:System.Data.DataTable.RowChanging>|`DataColumn` 値または `DataTable` の `DataRow` の `RowState` に対して変更が送信されたときに発生します。|  
+|<xref:System.Data.DataTable.RowDeleted>|`DataTable` の `DataRow` が `Deleted` としてマークされた後に発生します。|  
+|<xref:System.Data.DataTable.RowDeleting>|`DataTable` の `DataRow` が `Deleted` としてマークされる前に発生します。|  
+|<xref:System.Data.DataTable.TableCleared>|`DataTable` の <xref:System.Data.DataTable.Clear%2A> メソッドがすべての `DataRow` を正常にクリアした後で発生します。|  
+|<xref:System.Data.DataTable.TableClearing>|`Clear` メソッドが呼び出された後、`Clear` 操作が開始される前に発生します。|  
+|<xref:System.Data.DataTable.TableNewRow>|`DataTable` の `NewRow` メソッドの呼び出しにより、新しい `DataRow` が作成された後で発生します。|  
+|<xref:System.ComponentModel.MarshalByValueComponent.Disposed>|`DataTable` が破棄 \(`Disposed`\) されたときに発生します。  このプロパティは、<xref:System.ComponentModel.MarshalByValueComponent> から継承されています。|  
+  
+> [!NOTE]
+>  行の追加または削除を行う操作の多くは、`ColumnChanged` イベントも `ColumnChanging` イベントも生成しません。  ただし、`ReadXml` メソッドでは、`XmlReadMode` が `DiffGram` または `Auto` \(読み込む XML ドキュメントが `DiffGram` の場合\) に設定されていない限り、`ColumnChanged` イベントおよび `ColumnChanging` イベントが生成されます。  
+  
+> [!WARNING]
+>  `RowChanged` イベントの生成元の `DataSet` でデータが変更されると、データが破損する可能性があります。  このようなデータの破損が起きた場合、例外は発生しません。  
+  
+## その他の関連イベント  
+ <xref:System.Data.DataTable.Constraints%2A> プロパティは <xref:System.Data.ConstraintCollection> インスタンスを保持します。  <xref:System.Data.ConstraintCollection> クラスは、<xref:System.Data.ConstraintCollection.CollectionChanged> イベントを公開します。  このイベントは、`ConstraintCollection` に対して制約の追加、変更、または削除が実行されたときに発生します。  
+  
+ <xref:System.Data.DataTable.Columns%2A> プロパティは <xref:System.Data.DataColumnCollection> インスタンスを保持します。  `DataColumnCollection` クラスは、<xref:System.Data.DataColumnCollection.CollectionChanged> イベントを公開します。  このイベントは、`DataColumn` が追加、変更、または `DataColumnCollection` から削除されたときに発生します。  イベントの発生を伴う変更には、名前の変更、型の変更、式の変更、列の序数位置の変更などがあります。  
+  
+ <xref:System.Data.DataSet> の <xref:System.Data.DataSet.Tables%2A> プロパティは <xref:System.Data.DataTableCollection> インスタンスを保持します。  `DataTableCollection` クラスは、`CollectionChanged` イベントと `CollectionChanging` イベントの両方を公開します。  これらのイベントは、`DataSet` に対して、`DataTable` の追加、変更、または削除が実行されたときに発生します。  
+  
+ `DataRows` への変更によって、関連する <xref:System.Data.DataView> のイベントがトリガーされる場合もあります。  `DataView` クラスは、`DataColumn` 値が変更されたとき、または、ビューの構成や並べ替え順が変更されたときに発生する <xref:System.Data.DataView.ListChanged> イベントを公開します。  <xref:System.Data.DataRowView> クラスは、関連する `DataColumn` 値が変更されたときに発生する <xref:System.Data.DataRowView.PropertyChanged> イベントを公開します。  
+  
+## 操作の順序  
+ `DataRow` が追加、変更、または削除されたときに発生する操作の順序について説明します。  
+  
+1.  提示されたレコードを作成し、変更を適用します。  
+  
+2.  式以外の列の制約をチェックします。  
+  
+3.  適宜 `RowChanging` イベントまたは `RowDeleting` イベントを発生させます。  
+  
+4.  提示されたレコードを現在のレコードとして設定します。  
+  
+5.  関連するインデックスをすべて更新します。  
+  
+6.  関連する `DataView` オブジェクトの `ListChanged` イベントおよび関連する `DataRowView` オブジェクトの `PropertyChanged` イベントを発生させます。  
+  
+7.  すべての式列を評価します。ただし、これらの列に対する制約のチェックは、この段階では行われません。  
+  
+8.  式列の評価によって影響を受ける、関連する `DataView` オブジェクトの `ListChanged` イベントおよび関連する `DataRowView` オブジェクトの `PropertyChanged` イベントを発生させます。  
+  
+9. 適宜 `RowChanged` イベントまたは `RowDeleted` イベントを発生させます。  
+  
+10. 式列の制約をチェックします。  
+  
+> [!NOTE]
+>  式列に対する変更で `DataTable` のイベントが発生することはありません。  式列に対する変更で発生するのは、`DataView` と `DataRowView` のイベントだけです。  式列には他の複数の列に対する依存関係が存在することもあるため、1 回の `DataRow` 操作で複数回、評価される場合もあります。  イベントは式が評価されるたびに発生するため、式列が変更された場合、1 回の `DataRow` 操作で複数の `ListChanged` イベントおよび `PropertyChanged` イベントが発生し、同じ式列に対して複数のイベントが発生する場合もあります。  
+  
+> [!WARNING]
+>  <xref:System.NullReferenceException> を `RowChanged` イベント ハンドラー内でスローしないでください。  <xref:System.NullReferenceException> が `DataTable` の `RowChanged` イベント内でスローされると、`DataTable` が破損します。  
+  
+### 例  
+ 次の例では、`RowChanged`、`RowChanging`、`RowDeleted`、`RowDeleting`、`ColumnChanged`、`ColumnChanging`、`TableNewRow`、`TableCleared`、`TableClearing` の各イベントについてイベント ハンドラーを作成しています。  イベントが発生すると、各イベント ハンドラーによって、出力結果がコンソール ウィンドウに表示されます。  
+  
+ [!code-csharp[DataWorks DataTable.Events#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataTable.Events/CS/source.cs#1)]
+ [!code-vb[DataWorks DataTable.Events#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataTable.Events/VB/source.vb#1)]  
+  
+## 参照  
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [DataAdapter のイベント処理](../../../../../docs/framework/data/adonet/handling-dataadapter-events.md)   
+ [DataSet のイベント処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataview-events.md b/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataview-events.md
new file mode 100644
index 00000000000..c3ad9305412
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/handling-dataview-events.md
@@ -0,0 +1,63 @@
+---
+title: "DataView イベントの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5675663-fc91-4e0d-87a9-481b25b64c0f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataView イベントの処理
+<xref:System.Data.DataView> の <xref:System.Data.DataView.ListChanged> イベントを使用して、ビューが更新されているかどうかを確認できます。  基になるテーブルの行の追加、削除、または変更や、このスキーマの列の追加または削除、親子のリレーションシップの変更など、これらの更新を行うとこのイベントが発生します。  さらに、現在表示されている行のリストが新しい並べ替え順序またはフィルターの適用により大幅に変更された場合、**ListChanged** イベントはそのことも通知します。  
+  
+ **ListChanged** イベントは、<xref:System.ComponentModel> 名前空間の **ListChangedEventHandler** デリゲートを実装し、<xref:System.ComponentModel.ListChangedEventArgs> オブジェクトを入力として受け取ります。  発生した変更の内容を確認するには、**ListChangedEventArgs** オブジェクトの **ListChangedType** プロパティの <xref:System.ComponentModel.ListChangedType> 列挙値を使用します。  行の追加、削除、または移動による変更の場合、追加された行または移動された行の新しいインデックスと削除された行の古いインデックスには、**ListChangedEventArgs** オブジェクトの **NewIndex** プロパティを使用してアクセスできます。  移動された行の場合、移動前の古いインデックスにアクセスするには **ListChangedEventArgs** オブジェクトの **OldIndex** プロパティを使用します。  
+  
+ **DataViewManager** は、さらにテーブルが追加または削除された場合に、または基になる **DataSet** の **Relations** コレクションが変更された場合に、そのことを通知するために **ListChanged** イベントを公開します。  
+  
+ **ListChanged** イベント ハンドラーを追加する方法を次のコード サンプルに示します。  
+  
+```vb  
+AddHandler custView.ListChanged, _  
+  New System.ComponentModel.ListChangedEventHandler( _  
+  AddressOf OnListChanged)  
+  
+Private Shared Sub OnListChanged( _  
+  sender As Object, args As System.ComponentModel.ListChangedEventArgs)  
+  Console.WriteLine("ListChanged:")  
+  Console.WriteLine(vbTab & "    Type = " & _  
+    System.Enum.GetName(args.ListChangedType.GetType(), _  
+    args.ListChangedType))  
+  Console.WriteLine(vbTab & "OldIndex = " & args.OldIndex)  
+  Console.WriteLine(vbTab & "NewIndex = " & args.NewIndex)  
+End Sub  
+  
+```  
+  
+```csharp  
+custView.ListChanged  += new   
+  System.ComponentModel.ListChangedEventHandler(OnListChanged);  
+  
+protected static void OnListChanged(object sender,   
+  System.ComponentModel.ListChangedEventArgs args)  
+{  
+  Console.WriteLine("ListChanged:");  
+  Console.WriteLine("\t    Type = " + args.ListChangedType);  
+  Console.WriteLine("\tOldIndex = " + args.OldIndex);  
+  Console.WriteLine("\tNewIndex = " + args.NewIndex);  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataView>   
+ <xref:System.ComponentModel.ListChangedEventHandler>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/index.md b/docs/framework/data/adonet/dataset-datatable-dataview/index.md
new file mode 100644
index 00000000000..f339c24f6e3
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/index.md
@@ -0,0 +1,90 @@
+---
+title: "DataSets、DataTables、および DataViews | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d4c4b69-8919-4224-8a65-6cca1c61b48f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSets、DataTables、および DataViews
+ADO.NET <xref:System.Data.DataSet> はメモリ常駐型のデータ表現であり、含まれているデータ ソースとは関係なく、一貫性のあるリレーショナル プログラミング モデルを提供します。  <xref:System.Data.DataSet> とは、テーブル間のリレーションシップだけでなく、包括するテーブル、整列するテーブル、およびデータを制約するテーブルを含むデータのセットを表します。  
+  
+ <xref:System.Data.DataSet> にはさまざまな使用方法があり、単独または組み合わせで使用できます。  次の操作を行うことができます。  
+  
+-   プログラムを使用して <xref:System.Data.DataSet> 内に <xref:System.Data.DataTable>、<xref:System.Data.DataRelation>、および <xref:System.Data.Constraint> を作成し、テーブルにデータを設定できます。  
+  
+-   `DataAdapter` を使用して、既存のリレーショナル データ ソースから取得したデータのテーブルで <xref:System.Data.DataSet> を作成できます。  
+  
+-   XML を使用して、<xref:System.Data.DataSet> の内容を読み込んだり、永続化したりできます。  詳細については、「[DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)」を参照してください。  
+  
+ 厳密に型指定された <xref:System.Data.DataSet> も XML Web サービスを使用して転送できます。  <xref:System.Data.DataSet> は、XML Web サービスを使用してデータの転送が理想的に行えるように設計されています。  XML Web サービスの概要については、「[XML Web Services Overview](http://msdn.microsoft.com/ja-jp/9db0c7b8-bca6-462b-9be5-f5f9a7f05a4d)」を参照してください。  XML Web サービスから <xref:System.Data.DataSet> を使用する例については、「[XML Web サービスからの DataSet の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/consuming-a-dataset-from-an-xml-web-service.md)」を参照してください。  
+  
+## このセクションの内容  
+ [DataSet の作成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-a-dataset.md)  
+ <xref:System.Data.DataSet> のインスタンス作成に使用する構文について説明します。  
+  
+ [DataSet への DataTable の追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-a-datatable-to-a-dataset.md)  
+ テーブルと列の作成方法および <xref:System.Data.DataSet> への追加方法について説明します。  
+  
+ [DataRelation の追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md)  
+ <xref:System.Data.DataSet> のテーブル間のリレーションを作成する方法について説明します。  
+  
+ [DataRelation の移動](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/navigating-datarelations.md)  
+ <xref:System.Data.DataSet> のテーブル間のリレーションを使用して、親子のリレーションシップに基づく子または親の行を返す方法について説明します。  
+  
+ [DataSet の内容のマージ](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md)  
+ <xref:System.Data.DataSet>、<xref:System.Data.DataTable>、<xref:System.Data.DataRow> の各配列の内容を別の <xref:System.Data.DataSet> にマージする方法について説明します。  
+  
+ [DataSet の内容のコピー](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/copying-dataset-contents.md)  
+ 指定されたデータだけでなく、スキーマを持つことができる <xref:System.Data.DataSet> のコピーを作成する方法について説明します。  
+  
+ [DataSet のイベント処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md)  
+ <xref:System.Data.DataSet> のイベントおよびその使用方法について説明します。  
+  
+ [型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)  
+ 型指定された <xref:System.Data.DataSet> の概要と、その作成および使用方法について説明します。  
+  
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)  
+ <xref:System.Data.DataTable> の作成方法、スキーマの定義方法、およびデータの操作方法について説明します。  
+  
+ [DataTableReaders](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md)  
+ <xref:System.Data.DataTableReader> の作成方法および使用方法について説明します。  
+  
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)  
+ `DataViews` の作成方法および操作方法、および <xref:System.Data.DataView> イベントの操作方法について説明します。  
+  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)  
+ <xref:System.Data.DataSet> がデータ ソースとして XML と対話する方法を、<xref:System.Data.DataSet> の内容を XML データとして読み込んで永続化する方法と共に説明します。  
+  
+ [XML Web サービスからの DataSet の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/consuming-a-dataset-from-an-xml-web-service.md)  
+ <xref:System.Data.DataSet> を使用してデータを転送する XML Web サービスを作成する方法について説明します。  
+  
+## 関連項目  
+ [ADO.NET の新機能](../../../../../docs/framework/data/adonet/whats-new.md)  
+ ADO.NET の新機能について説明します。  
+  
+ [ADO.NET の概要](../../../../../docs/framework/data/adonet/ado-net-overview.md)  
+ ADO.NET のデザインとコンポーネントを紹介します。  
+  
+ [DataAdapter からの DataSet の読み込み](../../../../../docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md)  
+ **DataSet** にデータ ソースのデータを読み込む方法について説明します。  
+  
+ [DataAdapter によるデータ ソースの更新](../../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)  
+ **DataSet** のデータに加えた変更をデータ ソースに反映する方法について説明します。  
+  
+ [DataSet への既存の制約の追加](../../../../../docs/framework/data/adonet/adding-existing-constraints-to-a-dataset.md)  
+ **DataSet** にデータ ソースの主キー情報を設定する方法について説明します。  
+  
+## 参照  
+ [ADO.NET](../../../../../docs/framework/data/adonet/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inference-limitations.md b/docs/framework/data/adonet/dataset-datatable-dataview/inference-limitations.md
new file mode 100644
index 00000000000..223d3d936b7
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inference-limitations.md
@@ -0,0 +1,70 @@
+---
+title: "推論の制限事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78517994-5d57-44f8-9d20-38812977de09
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 推論の制限事項
+各ドキュメントに含まれている XML 要素によっては、XML から <xref:System.Data.DataSet> のスキーマを推論するプロセスにより、異なるスキーマが生成される可能性があります。  たとえば、次のような XML ドキュメントがあるとします。  
+  
+ Document1:  
+  
+```  
+<DocumentElement>  
+  <Element1>Text1</Element1>  
+  <Element1>Text2</Element1>  
+</DocumentElement>  
+```  
+  
+ Document2:  
+  
+```  
+<DocumentElement>  
+  <Element1>Text1</Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスでは、"Document1" については、"DocumentElement" という名前の **DataSet** と "Element1" という名前のテーブルが作成されます。これは、"Element1" が繰り返し出現する要素であるためです。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|Element1\_Text|  
+|--------------------|  
+|Text1|  
+|Text2|  
+  
+ これに対して、"Document2" については、"NewDataSet" という名前の **DataSet** と "DocumentElement" という名前のテーブルが生成されます。この場合、属性も子要素も持たない "Element1" は列として推論されます。  
+  
+ **DataSet:** NewDataSet  
+  
+ **Table:** DocumentElement  
+  
+|Element1|  
+|--------------|  
+|Text1|  
+  
+ これらの 2 つの XML ドキュメントは、同じスキーマを生成することを意図して記述されていますが、推論プロセスでは、各ドキュメントに含まれる要素を基にまったく異なるスキーマが生成されてしまいます。  
+  
+ XML ドキュメントからスキーマを生成するときに生じる可能性のあるこのような矛盾を避けるため、XML から **DataSet** を読み込むときは、XSD \(XML スキーマ定義言語\) または XDR \(XML\-Data Reduced\) を使用して、スキーマを明示的に指定することをお勧めします。  XML スキーマを使用して **DataSet** スキーマを明示的に指定する方法については、「[XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)」を参照してください。  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inferring-columns.md b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-columns.md
new file mode 100644
index 00000000000..90e4b8b97bc
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-columns.md
@@ -0,0 +1,81 @@
+---
+title: "列の推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e022699-c922-454c-93e2-957dd7e7247a
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 列の推論
+ADO.NET は、<xref:System.Data.DataSet> のテーブルとして推論する要素を、XML ドキュメントから決定した後、それらのテーブルの列を推論します。  ADO.NET 2.0 では、各 **simpleType** 要素の厳密に型指定されたデータ型を推論する新しいスキーマ推論エンジンが導入されました。  以前のバージョンでは、推論される **simpleType** 要素のデータ型は、常に **xsd:string** でした。  
+  
+## 移行および下位互換性  
+ **ReadXml** メソッドは、**InferSchema** 型の引数を取ります。  この引数を使用することにより、以前のバージョンと互換性のある推論方法を指定することができます。  **InferSchema** 列挙体で使用できる値を、次の表に示します。  
+  
+ <xref:System.Data.XmlReadMode>  
+ 単純型を <xref:System.String> として常に推論することで下位互換性を提供します。  
+  
+ <xref:System.Data.XmlReadMode>  
+ 厳密に型指定されたデータ型を推論します。  <xref:System.Data.DataTable> で使用した場合、例外をスローします。  
+  
+ <xref:System.Data.XmlReadMode>  
+ インライン スキーマを無視し、データを既存の <xref:System.Data.DataSet> スキーマに読み取ります。  
+  
+## 属性  
+ 「[テーブルの推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-tables.md)」で説明したとおり、属性を持つ要素は、テーブルとして推論されます。  その要素の属性は、そのテーブルの列として推論されます。  スキーマが XML に書き戻される場合に、列の名前が確実に属性として書き込まれるように、推論された列の **ColumnMapping** プロパティは **MappingType.Attribute** に設定されます。  属性の値は、テーブルの行に格納されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1 attr1="value1" attr2="value2"/>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、**attr1** および **attr2** という 2 つの列を持つ **Element1** という名前のテーブルが生成されます。  2 つの列の **ColumnMapping** プロパティは、**MappingType.Attribute** に設定されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|attr1|attr2|  
+|-----------|-----------|  
+|value1|value2|  
+  
+## 属性または子の要素を持たない要素  
+ 要素に子の要素または属性がない場合、その要素は列として推論されます。  列の **ColumnMapping** プロパティは、**MappingType.Element** に設定されます。  子の要素のテキストは、テーブルの行に格納されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1>  
+    <ChildElement1>Text1</ChildElement1>  
+    <ChildElement2>Text2</ChildElement2>  
+  </Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、**ChildElement1** および **ChildElement2** という 2 つの列を持つ **Element1** という名前のテーブルが生成されます。  2 つの列の **ColumnMapping** プロパティは、**MappingType.Element** に設定されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|ChildElement1|ChildElement2|  
+|-------------------|-------------------|  
+|Text1|Text2|  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md
new file mode 100644
index 00000000000..1013ef45f77
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md
@@ -0,0 +1,58 @@
+---
+title: "XML からの DataSet リレーショナル構造の推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd2f41c6-6785-420e-aa43-3ceb0bdccdce
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML からの DataSet リレーショナル構造の推論
+<xref:System.Data.DataSet> のリレーショナル構造 \(スキーマ\) は、テーブル、列、制約、およびリレーションで構成されます。  XML から <xref:System.Data.DataSet> を読み込むときには、事前定義されたスキーマを使用するか、または読み込む対象の XML から明示的にまたは推論によってスキーマを作成できます。  XML から <xref:System.Data.DataSet> のスキーマおよび内容を読み込む方法の詳細については、「[XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)」および「[XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)」を参照してください。  
+  
+ <xref:System.Data.DataSet> のスキーマを XML から作成する場合は、XML スキーマ定義言語 \(「[XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)」を参照\) または XDR \(XML\-Data Reduced\) を使用してスキーマを明示的に指定することをお勧めします。  XML で利用できる XML スキーマまたは XDR スキーマがない場合は、XML の要素および属性の構造から <xref:System.Data.DataSet> のスキーマを推論できます。  
+  
+ ここでは、XML の要素と属性およびその構造を示し、<xref:System.Data.DataSet> スキーマの推論に関する規則について説明します。また、その規則に基づいて推論した <xref:System.Data.DataSet> スキーマも示します。  
+  
+ XML ドキュメント内のすべての属性を推論プロセスの対象には含めないでください。  名前空間で修飾された属性には、XML ドキュメントにとっては重要ですが、<xref:System.Data.DataSet> スキーマにとっては不要なメタデータが含まれていることがあります。  <xref:System.Data.DataSet.InferXmlSchema%2A> を使用して、推論プロセスの間に無視する特定の名前空間を指定できます。  詳細については、「[XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)」を参照してください。  
+  
+## このセクションの内容  
+ [DataSet スキーマの推論プロセスの概要](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/summary-of-the-dataset-schema-inference-process.md)  
+ XML から <xref:System.Data.DataSet> のスキーマを推論するときの規則について概要を示します。  
+  
+ [テーブルの推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-tables.md)  
+ <xref:System.Data.DataSet> のテーブルとして推論される XML の要素について説明します。  
+  
+ [列の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-columns.md)  
+ テーブルの列として推論される XML の要素と属性について説明します。  
+  
+ [リレーションシップの推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-relationships.md)  
+ 推論された入れ子状のテーブルに対して作成される <xref:System.Data.DataRelation> オブジェクトおよび <xref:System.Data.ForeignKeyConstraint> オブジェクトについて説明します。  
+  
+ [要素のテキストの推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-element-text.md)  
+ XML 要素のテキストに対して作成される列について、および XML 要素のテキストが無視される場合について説明します。  
+  
+ [推論の制限事項](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inference-limitations.md)  
+ スキーマ推論の制限事項について説明します。  
+  
+## 関連項目  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)  
+ <xref:System.Data.DataSet> オブジェクトと XML データとの対話について説明します。  
+  
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)  
+ XML スキーマ定義言語 \(XSD\) スキーマから作成された <xref:System.Data.DataSet> のリレーショナル構造 \(スキーマ\) について説明します。  
+  
+ [ADO.NET の概要](../../../../../docs/framework/data/adonet/ado-net-overview.md)  
+ ADO.NET のアーキテクチャとコンポーネントについて、また ADO.NET を使用して既存のデータ ソースにアクセスしたり、アプリケーション データを管理する方法について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inferring-element-text.md b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-element-text.md
new file mode 100644
index 00000000000..6ec29f705fe
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-element-text.md
@@ -0,0 +1,66 @@
+---
+title: "要素のテキストの推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 789799e5-716f-459f-a168-76c5cf22178b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 要素のテキストの推論
+要素にテキストは含まれているが、テーブルとして推論される \(属性を持つ要素または繰り返し出現する要素などの\) 子の要素がない場合は、**TableName\_Text** という名前の新しい列が、要素に対して推論されるテーブルに追加されます。  要素に含まれているテキストはテーブルの行に追加され、新しい列に格納されます。  新しい列の **ColumnMapping** プロパティは、**MappingType.SimpleContent** に設定されます。  
+  
+ たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1 attr1="value1">Text1</Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、**attr1** および **Element1\_Text** という 2 つの列を持つ **Element1** という名前のテーブルが生成されます。  **attr1** 列の **ColumnMapping** プロパティは、**MappingType.Attribute** に設定されます。  **Element1\_Text** 列の **ColumnMapping** プロパティは、**MappingType.SimpleContent** に設定されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|attr1|Element1\_Text|  
+|-----------|--------------------|  
+|value1|Text1|  
+  
+ 要素にテキストだけでなく、テキストを含む子の要素も含まれている場合は、その要素に含まれているテキストを格納するための列はテーブルに追加されません。  要素に含まれるテキストは無視されますが、子の要素のテキストはテーブルの行に追加されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<Element1>  
+  Text1  
+  <ChildElement1>Text2</ChildElement1>  
+  Text3  
+</Element1>  
+```  
+  
+ 推論プロセスにより、**ChildElement1** という 1 つの列を持つ **Element1** という名前のテーブルが生成されます。  **ChildElement1** 要素のテキストは、テーブルの行に追加されます。  その他のテキストは無視されます。  **ChildElement1** 列の **ColumnMapping** プロパティは、**MappingType.Element** に設定されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|ChildElement1|  
+|-------------------|  
+|Text2|  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inferring-relationships.md b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-relationships.md
new file mode 100644
index 00000000000..2c428700d83
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-relationships.md
@@ -0,0 +1,86 @@
+---
+title: "リレーションシップの推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8fa86a9d-6545-4a9d-b1f5-58d9742179c7
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# リレーションシップの推論
+テーブルとして推論される要素に、同じくテーブルとして推論される子の要素が含まれている場合には、2 つのテーブル間に <xref:System.Data.DataRelation> が作成されます。  この場合、**ParentTableName\_Id** という名前の新しい列が、親の要素に対して作成されたテーブルと、子の要素に対して作成されたテーブルの両方に追加されます。  この ID 列の **ColumnMapping** プロパティは、**MappingType.Hidden** に設定されます。  この列が、親テーブルの自動的にインクリメントされる主キーとなり、2 つのテーブル間の **DataRelation** で使用されます。  推論される他のすべての列のデータ型は **System.String** になりますが、追加される ID 列のデータ型は **System.Int32** になります。  親テーブルおよび子テーブルの両方に追加されたこの新しい列を使用して、**DeleteRule** \= **Cascade** である <xref:System.Data.ForeignKeyConstraint> も作成されます。  
+  
+ たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1>  
+    <ChildElement1 attr1="value1" attr2="value2"/>  
+    <ChildElement2>Text2</ChildElement2>  
+  </Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、**Element1** および **ChildElement1** という名前の 2 つのテーブルが生成されます。  
+  
+ **Element1** テーブルには、**Element1\_Id** および **ChildElement2** という名前の 2 つの列があります。  **Element1\_Id** 列の **ColumnMapping** プロパティは、**MappingType.Hidden** に設定されます。  **ChildElement2** 列の **ColumnMapping** プロパティは、**MappingType.Element** に設定されます。  **Element1\_Id** 列は、**Element1** テーブルの主キーとして設定されます。  
+  
+ **ChildElement1** テーブルには、**attr1**、**attr2**、および **Element1\_Id** という名前の 3 つの列があります。  **attr1** 列および **attr2** 列の **ColumnMapping** プロパティは、**MappingType.Attribute** に設定されます。  **Element1\_Id** 列の **ColumnMapping** プロパティは、**MappingType.Hidden** に設定されます。  
+  
+ 2 つのテーブルの **Element1\_Id** 列を使用して、**DataRelation** および **ForeignKeyConstraint** が作成されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|Element1\_Id|ChildElement2|  
+|------------------|-------------------|  
+|0|Text2|  
+  
+ **Table:** ChildElement1  
+  
+|attr1|attr2|Element1\_Id|  
+|-----------|-----------|------------------|  
+|value1|value2|0|  
+  
+ **DataRelation:** Element1\_ChildElement1  
+  
+ **ParentTable:** Element1  
+  
+ **ParentColumn:** Element1\_Id  
+  
+ **ChildTable:** ChildElement1  
+  
+ **ChildColumn:** Element1\_Id  
+  
+ **Nested:** True  
+  
+ **ForeignKeyConstraint:** Element1\_ChildElement1  
+  
+ **Column:** Element1\_Id  
+  
+ **ParentTable:** Element1  
+  
+ **ChildTable:** ChildElement1  
+  
+ **DeleteRule:** Cascade  
+  
+ **AcceptRejectRule:** None  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataRelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/inferring-tables.md b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-tables.md
new file mode 100644
index 00000000000..6ea4893ef77
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/inferring-tables.md
@@ -0,0 +1,134 @@
+---
+title: "テーブルの推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74a288d4-b8e9-4f1a-b2cd-10df92c1ed1f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# テーブルの推論
+XML ドキュメントから <xref:System.Data.DataSet> のスキーマを推論するときには、ADO.NET では、テーブルを表す XML 要素を最初に決定します。  次に示すいくつかの XML 構造は、**DataSet** スキーマのテーブルとして推論されます。  
+  
+-   属性を持つ要素  
+  
+-   子要素を持つ要素  
+  
+-   繰り返し出現する要素  
+  
+## 属性を持つ要素  
+ 要素に属性が指定されている場合は、それらの要素はテーブルとして推論されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1 attr1="value1"/>  
+  <Element1 attr1="value2">Text1</Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、"Element1" という名前のテーブルが生成されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|attr1|Element1\_Text|  
+|-----------|--------------------|  
+|value1||  
+|value2|Text1|  
+  
+## 子要素を持つ要素  
+ 子要素を持つ要素は、テーブルとして推論されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1>  
+    <ChildElement1>Text1</ChildElement1>  
+  </Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、"Element1" という名前のテーブルが生成されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|ChildElement1|  
+|-------------------|  
+|Text1|  
+  
+ ドキュメント \(ルート\) 要素に属性または子要素があり、それらが列として推論される場合には、そのドキュメント要素はテーブルとして推論されます。  ドキュメント要素の属性や子要素が列として推論されない場合には、そのドキュメント要素は **DataSet** として推論されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1>Text1</Element1>  
+  <Element2>Text2</Element2>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、"DocumentElement" という名前のテーブルが生成されます。  
+  
+ **DataSet:** NewDataSet  
+  
+ **Table:** DocumentElement  
+  
+|Element1|Element2|  
+|--------------|--------------|  
+|Text1|Text2|  
+  
+ または、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1 attr1="value1" attr2="value2"/>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、"Element1" という名前のテーブルを含む "DocumentElement" という名前の **DataSet** が生成されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|attr1|attr2|  
+|-----------|-----------|  
+|value1|value2|  
+  
+## 繰り返し出現する要素  
+ 繰り返し出現する要素は、単一のテーブルとして推論されます。  たとえば、次のような XML があるとします。  
+  
+```  
+<DocumentElement>  
+  <Element1>Text1</Element1>  
+  <Element1>Text2</Element1>  
+</DocumentElement>  
+```  
+  
+ 推論プロセスにより、"Element1" という名前のテーブルが生成されます。  
+  
+ **DataSet:** DocumentElement  
+  
+ **Table:** Element1  
+  
+|Element1\_Text|  
+|--------------------|  
+|Text1|  
+|Text2|  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md b/docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md
new file mode 100644
index 00000000000..706337e9501
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md
@@ -0,0 +1,130 @@
+---
+title: "XML からの DataSet の読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49c083b7-a5ed-41cf-aabc-5aaba96f00e6
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML からの DataSet の読み込み
+ADO.NET では、XML ストリームまたは XML ドキュメントから <xref:System.Data.DataSet> の内容を作成できます。  また、.NET Framework では、XML から読み込まれる情報と <xref:System.Data.DataSet> のスキーマまたはリレーショナル構造の作成方法を柔軟に変更できます。  
+  
+ <xref:System.Data.DataSet> に XML のデータを格納するには、<xref:System.Data.DataSet> オブジェクトの **ReadXml** メソッドを使用します。  **ReadXml** メソッドは、ファイル、ストリーム、または **XmlReader** からデータを読み取り、XML のソースを引数として受け取ります。また、**XmlReadMode** 引数を受け取ることもあります。  **XmlReader** に関する詳細については、「[NIB: Reading XML Data with XmlTextReader](http://msdn.microsoft.com/ja-jp/762c069b-b50c-41b8-936e-39eacfb0d540)」を参照してください。**ReadXml** メソッドは、XML ストリームまたは XML ドキュメントの内容を読み取り、<xref:System.Data.DataSet> にデータを読み込みます。  また、指定されている **XmlReadMode** と、リレーショナル スキーマが既に存在しているかどうかに応じて、<xref:System.Data.DataSet> のリレーショナル スキーマも作成します。  
+  
+ **XmlReadMode** 引数のオプションを次の表に示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**Auto**|既定値です。  XML を調べ、次の順序で最適なオプションを選択します。<br /><br /> -   XML が DiffGram の場合は、**DiffGram** が使用されます。<br />-   <xref:System.Data.DataSet> にスキーマが含まれている場合、または XML にインライン スキーマが含まれている場合は、**ReadSchema** が使用されます。<br />-   <xref:System.Data.DataSet> にスキーマが含まれておらず、XML にインライン スキーマが含まれていない場合は、**InferSchema** が使用されます。<br /><br /> 読み取られる XML の形式が判明している場合は、パフォーマンスを最大限に引き出すため、既定値 **Auto** を使用する代わりに、**XmlReadMode** を明示的に設定することをお勧めします。|  
+|**ReadSchema**|インライン スキーマを読み取り、データとスキーマを読み込みます。<br /><br /> <xref:System.Data.DataSet> に既にスキーマが含まれている場合には、読み取るインライン スキーマの新しいテーブルが <xref:System.Data.DataSet> の既存のスキーマに追加されます。  インライン スキーマのテーブルが既に <xref:System.Data.DataSet> に存在している場合には、例外がスローされます。  **XmlReadMode.ReadSchema** を使用して既存のテーブルのスキーマを修正できません。<br /><br /> <xref:System.Data.DataSet> にスキーマが含まれておらず、インライン スキーマが存在しない場合には、データは読み取られません。<br /><br /> インライン スキーマを定義するには、XML スキーマ定義言語 \(XSD\) スキーマを使用します。  XML スキーマとしてのインライン スキーマを書き込む方法の詳細については、「[XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)」を参照してください。|  
+|**IgnoreSchema**|インライン スキーマを無視し、データを既存の <xref:System.Data.DataSet> スキーマへ読み込みます。  既存のスキーマに一致しないデータは破棄されます。  <xref:System.Data.DataSet> にスキーマがない場合には、データは読み込まれません。<br /><br /> データが DiffGram の場合、**IgnoreSchema** は **DiffGram** と同様に機能します。|  
+|**InferSchema**|インライン スキーマを無視し、XML データ構造ごとにスキーマを推論し、データを読み込みます。<br /><br /> <xref:System.Data.DataSet> に既にスキーマが含まれている場合、既存のテーブルに列を追加することによって現在のスキーマが拡張されます。  既存のテーブルが存在しない場合、余分なテーブルは追加されません。  推論されたテーブルが他の名前空間に既に存在している場合、または推論された列と既存の列が矛盾する場合には、例外がスローされます。<br /><br /> **ReadXmlSchema** による XML ドキュメントからのスキーマの推論方法の詳細については、「[XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)」を参照してください。|  
+|**DiffGram**|DiffGram を読み取り、現在のスキーマへデータを追加します。  **DiffGram** は、既存の行に対し、固有の識別子の値が一致する新しい行を結合します。  このトピックの最後にある「XML のデータの結合」の説明を参照してください。  DiffGrams の詳細については、「[DiffGram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)」を参照してください。|  
+|**Fragment**|ストリームの終わりに達するまで、複数 XML フラグメントの読み取りを続行します。  <xref:System.Data.DataSet> スキーマに一致するフラグメントが適切なテーブルに追加されます。  <xref:System.Data.DataSet> スキーマに一致しないフラグメントは破棄されます。|  
+  
+> [!NOTE]
+>  XML ドキュメントにアクセスするためのオブジェクトである **ReadXml** に **XmlReader** を渡すと、**ReadXml** は次の要素ノードを読み取り、このノードをルート要素として処理し、このノードの終わりに到達するまで読み取ります。  ただし **XmlReadMode.Fragment** を指定する場合にはこれは該当しません。  
+  
+## DTD エンティティ  
+ ドキュメント型定義 \(DTD\) スキーマで定義されているエンティティが、XML に含まれている場合に、ファイル名、ストリーム、または非検証 **XmlReader** を **ReadXml** に渡して <xref:System.Data.DataSet> を読み込むと、例外がスローされます。  この方法の代わりに、**EntityHandling** を **EntityHandling.ExpandEntities** に設定して **XmlValidatingReader** を作成し、**XmlValidatingReader** を **ReadXml** へ渡してください。  **XmlValidatingReader** によってエンティティが展開された後で、<xref:System.Data.DataSet> がこのエンティティを読み取ります。  
+  
+ XML ストリームから <xref:System.Data.DataSet> を読み込むコード サンプルを次に示します。  1 番目の例では、ファイル名が **ReadXml** メソッドに渡されます。  2 番目の例では、XML が含まれている文字列が <xref:System.IO.StringReader> によって読み込まれます。  
+  
+```vb  
+Dim dataSet As DataSet = New DataSet  
+dataSet.ReadXml("input.xml", XmlReadMode.ReadSchema)  
+```  
+  
+```csharp  
+DataSet dataSet = new DataSet();  
+dataSet.ReadXml("input.xml", XmlReadMode.ReadSchema);  
+```  
+  
+```vb  
+Dim dataSet As DataSet = New DataSet  
+Dim dataTable As DataTable = New DataTable("table1")  
+dataTable.Columns.Add("col1", Type.GetType("System.String"))  
+dataSet.Tables.Add(dataTable)  
+  
+Dim xmlData As String = "<XmlDS><table1><col1>Value1</col1></table1><table1><col1>Value2</col1></table1></XmlDS>"  
+  
+Dim xmlSR As System.IO.StringReader = New System.IO.StringReader(xmlData)  
+  
+dataSet.ReadXml(xmlSR, XmlReadMode.IgnoreSchema)  
+```  
+  
+```csharp  
+DataSet dataSet = new DataSet();  
+DataTable dataTable = new DataTable("table1");  
+dataTable.Columns.Add("col1", typeof(string));  
+dataSet.Tables.Add(dataTable);  
+  
+string xmlData = "<XmlDS><table1><col1>Value1</col1></table1><table1><col1>Value2</col1></table1></XmlDS>";  
+  
+System.IO.StringReader xmlSR = new System.IO.StringReader(xmlData);  
+  
+dataSet.ReadXml(xmlSR, XmlReadMode.IgnoreSchema);  
+```  
+  
+> [!NOTE]
+>  非常に大きなファイルを読み込む際に **ReadXml** を呼び出すと、パフォーマンスが低下することがあります。  大きなファイルを読み込む場合に、**ReadXml** のパフォーマンスを最大にするには、<xref:System.Data.DataSet> のテーブルごとに <xref:System.Data.DataTable.BeginLoadData%2A> メソッドを呼び出し、その後で **ReadXml** を呼び出します。  最後に、次の例に示すように、<xref:System.Data.DataSet> のテーブルごとに <xref:System.Data.DataTable.EndLoadData%2A> を呼び出します。  
+  
+```vb  
+Dim dataTable As DataTable  
+  
+For Each dataTable In dataSet.Tables  
+   dataTable.BeginLoadData()  
+Next  
+  
+dataSet.ReadXml("file.xml")  
+  
+For Each dataTable in dataSet.Tables  
+   dataTable.EndLoadData()  
+Next  
+```  
+  
+```csharp  
+foreach (DataTable dataTable in dataSet.Tables)  
+   dataTable.BeginLoadData();  
+  
+dataSet.ReadXml("file.xml");   
+  
+foreach (DataTable dataTable in dataSet.Tables)  
+   dataTable.EndLoadData();  
+```  
+  
+> [!NOTE]
+>  <xref:System.Data.DataSet> の XSD スキーマに **targetNamespace** がインクルードされている場合、**ReadXml** を呼び出して、名前空間が修飾されていない要素を含む XML を <xref:System.Data.DataSet> に読み込もうとすると、データが読み取られず、例外が発生することがあります。  この場合に、名前空間が指定されていない要素を読み込むには、XSD スキーマで **elementFormDefault** を "qualified" に設定します。  次に例を示します。  
+  
+```  
+<xsd:schema id="customDataSet"   
+  elementFormDefault="qualified"  
+  targetNamespace="http://www.tempuri.org/customDataSet.xsd"   
+  xmlns="http://www.tempuri.org/customDataSet.xsd"   
+  xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
+  xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+</xsd:schema>  
+```  
+  
+## XML のデータの結合  
+ 既に、<xref:System.Data.DataSet> にデータが含まれている場合には、<xref:System.Data.DataSet> の既存のデータに XML の新しいデータが追加されます。  **ReadXml** では、XML の中で主キーが一致する行情報を <xref:System.Data.DataSet> に結合しません。  既存の行情報を XML の新しい情報で上書きするには、**ReadXml** を使用して新しい <xref:System.Data.DataSet> を作成してから、新しい <xref:System.Data.DataSet> を既存の <xref:System.Data.DataSet> へ結合 \(<xref:System.Data.DataSet.Merge%2A>\) します。  **XmlReadMode** が **DiffGram** の **ReadXML** を使用して DiffGram を読み込むと、同一の一意の識別子を持つ行が結合されます。  
+  
+## 参照  
+ <xref:System.Data.DataSet.Merge%2A?displayProperty=fullName>   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DiffGram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)   
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)   
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md b/docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md
new file mode 100644
index 00000000000..58dd6090e28
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md
@@ -0,0 +1,98 @@
+---
+title: "XML の DataSet スキーマ情報の読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 43dfb23b-5cef-46f2-8d87-78f0fba1eb8c
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML の DataSet スキーマ情報の読み込み
+<xref:System.Data.DataSet> のスキーマ \(テーブル、列、リレーション、および制約\) は、プログラムを使用して定義され、<xref:System.Data.Common.DataAdapter> の **Fill** メソッドまたは **FillSchema** メソッドによって作成されるか、あるいは XML ドキュメントから読み込まれます。  XML ドキュメントから **DataSet** スキーマ情報を読み込むには、**DataSet** の **ReadXmlSchema** メソッドまたは **InferXmlSchema** メソッドを使用します。  **ReadXmlSchema** を使用すると、XML スキーマ定義言語 \(XSD\) スキーマが含まれているドキュメントまたはインライン XML スキーマが含まれている XML ドキュメントから、**DataSet** スキーマ情報を読み込むかまたは推論できます。  **InferXmlSchema** を使用すると、XML ドキュメントからスキーマを推論できます。このとき、指定した特定の XML 名前空間は無視されます。  
+  
+> [!NOTE]
+>  XSD の構造 \(入れ子になったリレーションなど\) を使用してメモリ内で作成された **DataSet** を、Web サービスまたは XML シリアル化を使って転送した場合、**DataSet** 内のテーブルの順序が維持されない場合があります。  この場合、**DataSet** の受け取り側はテーブルの順序に依存していないことが必要です。  ただし、メモリ内で作成するのではなく、転送する **DataSet** のスキーマを XSD ファイルから読み取った場合は、テーブルの順序が常に維持されます。  
+  
+## ReadXmlSchema  
+ XML ドキュメントから **DataSet** のスキーマだけを読み込み、データを読み込まないようにするには、**DataSet** の **ReadXmlSchema** メソッドを使用します。  **ReadXmlSchema** は、XML スキーマ定義言語 \(XSD\) スキーマを使用して定義されている **DataSet** を作成します。  
+  
+ **ReadXmlSchema** メソッドは、ファイル名、ストリーム、または読み込む XML ドキュメントが格納されている **XmlReader** のいずれか 1 つを引数として受け取ります。  この XML ドキュメントには、スキーマだけが含まれているか、またはデータのある XML 要素と共にスキーマがインラインで含まれています。  XML スキーマとしてのインライン スキーマを書き込む方法の詳細については、「[XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)」を参照してください。  
+  
+ **ReadXmlSchema** に渡された XML ドキュメントに、インライン スキーマ情報が含まれていない場合、**ReadXmlSchema** は XML ドキュメントの要素からスキーマを推論します。  **DataSet** に既にスキーマが含まれている場合、テーブルが存在しなければ新しいテーブルを追加することによって現在のスキーマが拡張されます。  既存のテーブルには新しい列は追加されません。  **DataSet** に既に追加される列が存在していますが、XML で検出された列の型と矛盾する場合には、例外がスローされます。  **ReadXmlSchema** による XML ドキュメントからのスキーマの推論方法の詳細については、「[XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)」を参照してください。  
+  
+ **ReadXmlSchema** は **DataSet** スキーマの読み込みまたは推論のいずれかを実行しますが、**DataSet** の **ReadXml** メソッドは、スキーマと XML ドキュメントのデータの両方の読み込みまたは推論を実行します。  詳細については、「[XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)」を参照してください。  
+  
+ XML ドキュメントまたは XML ストリームから **DataSet** スキーマを読み込む方法を次のコード サンプルに示します。  1 番目の例では、XML スキーマ ファイル名が **ReadXmlSchema** メソッドへ渡されます。  2 番目の例では、**System.IO.StreamReader** が示されています。  
+  
+```vb  
+Dim dataSet As DataSet = New DataSet  
+dataSet.ReadXmlSchema("schema.xsd")  
+```  
+  
+```csharp  
+DataSet dataSet = new DataSet();  
+dataSet.ReadXmlSchema("schema.xsd");  
+```  
+  
+```vb  
+Dim xmlStream As System.IO.StreamReader = New System.IO.StreamReader ("schema.xsd");  
+Dim dataSet As DataSet = New DataSet  
+dataSet.ReadXmlSchema(xmlStream)  
+xmlStream.Close()  
+```  
+  
+```csharp  
+System.IO.StreamReader xmlStream = new System.IO.StreamReader("schema.xsd");  
+DataSet dataSet = new DataSet();  
+dataSet.ReadXmlSchema(xmlStream);  
+xmlStream.Close();  
+```  
+  
+## InferXmlSchema  
+ **DataSet** に対し、**DataSet** の **InferXmlSchema** メソッドを使用して XML ドキュメントのスキーマを推論するように指示できます。  **InferXmlSchema** は、**XmlReadMode** を **InferSchema** に設定した **ReadXml** \(データの読み込みとスキーマの推論\) と、読み取られるドキュメントにインライン スキーマが含まれていない場合の **ReadXmlSchema** の両方と同様の機能を備えています。  ただし **InferXmlSchema** には、スキーマを推論するときに無視する特定の XML 名前空間を指定できる追加機能を用意しています。  **InferXmlSchema** に必要な 2 つの引数は、XML ドキュメントの位置と、この操作によって無視される XML 名前空間の文字列配列です。XML ドキュメントの位置は、ファイル名、ストリーム、または **XmlReader** によって指定されます。  
+  
+ たとえば、次のような XML があるとします。  
+  
+```  
+<NewDataSet xmlns:od="urn:schemas-microsoft-com:officedata">  
+<Categories>  
+  <CategoryID od:adotype="3">1</CategoryID>   
+  <CategoryName od:maxLength="15" od:adotype="130">Beverages</CategoryName>   
+  <Description od:adotype="203">Soft drinks and teas</Description>   
+</Categories>  
+<Products>  
+  <ProductID od:adotype="20">1</ProductID>   
+  <ReorderLevel od:adotype="3">10</ReorderLevel>   
+  <Discontinued od:adotype="11">0</Discontinued>   
+</Products>  
+</NewDataSet>  
+```  
+  
+ 前述の XML ドキュメントの要素に対して指定されている属性により、**ReadXmlSchema** メソッドと、**XmlReadMode** が **InferSchema** に設定されている **ReadXml** メソッドは、いずれもドキュメントのすべての要素 \(**Categories**、**CategoryID**、**CategoryName**、**Description**、**Products**、**ProductID**、**ReorderLevel**、および **Discontinued**\) に対してテーブルを作成します。  \(詳細については、「[XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)」を参照してください\)。ただし、この作成方法よりも適切な方法としては、最初に **Categories** テーブルと **Products** テーブルだけを作成し、次に **Categories** テーブルの **CategoryID**、**CategoryName**、および **Description** 列を作成し、**Products** テーブルの **ProductID**、**ReorderLevel** および **Discontinued** 列を作成する方法があります。  推論されたスキーマが、XML 要素に指定されている属性を無視するようにするには、**InferXmlSchema** メソッドを使用して **officedata** の XML 名前空間を無視するように指定します。この例を次に示します。  
+  
+```vb  
+Dim dataSet As DataSet = New DataSet  
+dataSet.InferXmlSchema("input_od.xml", New String() {"urn:schemas-microsoft-com:officedata"})  
+```  
+  
+```csharp  
+DataSet dataSet = new DataSet();  
+dataSet.InferXmlSchema("input_od.xml", new string[] "urn:schemas-microsoft-com:officedata");  
+```  
+  
+## 参照  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)   
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/managing-dataviews.md b/docs/framework/data/adonet/dataset-datatable-dataview/managing-dataviews.md
new file mode 100644
index 00000000000..5358957fb30
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/managing-dataviews.md
@@ -0,0 +1,133 @@
+---
+title: "DataViews の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b67fab5-1722-4d2b-bfc1-247a75f0f1ee
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataViews の管理
+<xref:System.Data.DataView> のすべてのテーブルのビュー設定を管理するには、<xref:System.Data.DataViewManager> を使用します。  リレーションシップを移動するグリッドなどのように、1 つのコントロールを複数のテーブルに連結する場合は、**DataViewManager** が適しています。  
+  
+ **DataViewManager** には、<xref:System.Data.DataSet> のテーブルのビュー設定に使用される <xref:System.Data.DataViewSetting> オブジェクトのコレクションが含まれています。  <xref:System.Data.DataViewSettingCollection> には、**DataSet** の各テーブルに対応する <xref:System.Data.DataViewSetting> オブジェクトが 1 つずつ含まれています。  参照テーブルの既定の **ApplyDefaultSort**、**Sort**、**RowFilter**、**RowStateFilter** の各プロパティを設定するには、**DataViewSetting** を使用します。  名前または序数参照によって、または参照をその特定のテーブル オブジェクトに渡すことによって、特定のテーブルの **DataViewSetting** を参照できます。  **DataViewManager** の **DataViewSetting** オブジェクトのコレクションにアクセスするには、**DataViewSettings** プロパティを使用します。  
+  
+ **DataSet** に、SQL Server **Northwind** データベースの **Customers**、**Orders**、**Order Details** の各テーブルを格納し、テーブル間のリレーションシップを作成し、**DataViewManager** を使用して既定の **DataView** 設定を指定し、**DataGrid** を **DataViewManager** に連結するコード サンプルを次に示します。  この例では **DataSet** のすべてのテーブルを対象とした既定の **DataView** 設定が設定されます。この設定では、テーブルの主キーによってテーブルの内容が並べ替えられ \(**ApplyDefaultSort** \= **true**\)、次に **Customers** テーブルの並べ替え順序が、**CompanyName** による並べ替え順序に変更されます。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection to Northwind.  
+' Create a Connection, DataAdapters, and a DataSet.  
+Dim custDA As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT CustomerID, CompanyName FROM Customers", connection)  
+Dim orderDA As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT OrderID, CustomerID FROM Orders", connection)  
+Dim ordDetDA As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT OrderID, ProductID, Quantity FROM [Order Details]", connection)  
+  
+Dim custDS As DataSet = New DataSet()  
+  
+' Open the Connection.  
+connection.Open()  
+  
+    ' Fill the DataSet with schema information and data.  
+    custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey  
+    orderDA.MissingSchemaAction = MissingSchemaAction.AddWithKey  
+    ordDetDA.MissingSchemaAction = MissingSchemaAction.AddWithKey  
+  
+    custDA.Fill(custDS, "Customers")  
+    orderDA.Fill(custDS, "Orders")  
+    ordDetDA.Fill(custDS, "OrderDetails")  
+  
+    ' Close the Connection.  
+    connection.Close()  
+  
+    ' Create relationships.  
+    custDS.Relations.Add("CustomerOrders", _  
+          custDS.Tables("Customers").Columns("CustomerID"), _  
+          custDS.Tables("Orders").Columns("CustomerID"))  
+  
+    custDS.Relations.Add("OrderDetails", _  
+          custDS.Tables("Orders").Columns("OrderID"), _  
+          custDS.Tables("OrderDetails").Columns("OrderID"))  
+  
+' Create default DataView settings.  
+Dim viewManager As DataViewManager = New DataViewManager(custDS)  
+  
+Dim viewSetting As DataViewSetting  
+For Each viewSetting In viewManager.DataViewSettings  
+  viewSetting.ApplyDefaultSort = True  
+Next  
+  
+viewManager.DataViewSettings("Customers").Sort = "CompanyName"  
+  
+' Bind to a DataGrid.  
+Dim grid As System.Windows.Forms.DataGrid = New System.Windows.Forms.DataGrid()  
+grid.SetDataBinding(viewManager, "Customers")  
+  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection to Northwind.  
+// Create a Connection, DataAdapters, and a DataSet.  
+SqlDataAdapter custDA = new SqlDataAdapter(  
+  "SELECT CustomerID, CompanyName FROM Customers", connection);  
+SqlDataAdapter orderDA = new SqlDataAdapter(  
+  "SELECT OrderID, CustomerID FROM Orders", connection);  
+SqlDataAdapter ordDetDA = new SqlDataAdapter(  
+  "SELECT OrderID, ProductID, Quantity FROM [Order Details]", connection);  
+  
+DataSet custDS = new DataSet();  
+  
+// Open the Connection.  
+connection.Open();  
+  
+    // Fill the DataSet with schema information and data.  
+    custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;  
+    orderDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;  
+    ordDetDA.MissingSchemaAction = MissingSchemaAction.AddWithKey;  
+  
+    custDA.Fill(custDS, "Customers");  
+    orderDA.Fill(custDS, "Orders");  
+    ordDetDA.Fill(custDS, "OrderDetails");  
+  
+    // Close the Connection.  
+    connection.Close();  
+  
+    // Create relationships.  
+    custDS.Relations.Add("CustomerOrders",  
+          custDS.Tables["Customers"].Columns["CustomerID"],  
+          custDS.Tables["Orders"].Columns["CustomerID"]);  
+  
+    custDS.Relations.Add("OrderDetails",  
+          custDS.Tables["Orders"].Columns["OrderID"],  
+          custDS.Tables["OrderDetails"].Columns["OrderID"]);  
+  
+// Create default DataView settings.  
+DataViewManager viewManager = new DataViewManager(custDS);  
+  
+foreach (DataViewSetting viewSetting in viewManager.DataViewSettings)  
+  viewSetting.ApplyDefaultSort = true;  
+  
+viewManager.DataViewSettings["Customers"].Sort = "CompanyName";  
+  
+// Bind to a DataGrid.  
+System.Windows.Forms.DataGrid grid = new System.Windows.Forms.DataGrid();  
+grid.SetDataBinding(viewManager, "Customers");  
+```  
+  
+## 参照  
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataViewManager>   
+ <xref:System.Data.DataViewSetting>   
+ <xref:System.Data.DataViewSettingCollection>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md b/docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md
new file mode 100644
index 00000000000..a9bba88fbdf
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md
@@ -0,0 +1,50 @@
+---
+title: "DataTable 内のデータの操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5cb86d48-a987-4af4-80e0-8cc2c8373d62
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable 内のデータの操作
+<xref:System.Data.DataSet> 内に <xref:System.Data.DataTable> を作成した後で、データベース内のテーブルを使用する場合と同じ操作を実行できます。  テーブル内のデータの追加、表示、編集、および削除を実行したり、エラーとイベントを監視したり、テーブル内のデータを照会したりできます。  **DataTable** 内のデータを変更するときには、変更が正確かどうかを検証したり、変更をプログラムによって受け入れるかまたは拒否するかを決定したりすることもできます。  
+  
+## このセクションの内容  
+ [DataTable へのデータの追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-data-to-a-datatable.md)  
+ 新しい行を作成してテーブルに追加する方法について説明します。  
+  
+ [DataTable 内のデータの表示](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/viewing-data-in-a-datatable.md)  
+ 元のバージョンのデータや現在のバージョンのデータを含め、行内のデータにアクセスする方法について説明します。  
+  
+ [Load メソッド](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/the-load-method.md)  
+ **Load** メソッドを使用して、**DataTable** に行を格納する方法について説明します。  
+  
+ [DataTable の編集](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatable-edits.md)  
+ 提示された変更が検証され、受け入れられるまで行への実際の変更を保留しておく方法も含め、行内のデータを変更する方法について説明します。  
+  
+ [行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)  
+ 行のさまざまな状態について説明します。  
+  
+ [DataRow の削除](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datarow-deletion.md)  
+ テーブルから行を削除する方法について説明します。  
+  
+ [行エラー情報](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md)  
+ アプリケーション内でのデータに関する問題を解決するために、行ごとのエラー情報を挿入する方法について説明します。  
+  
+ [AcceptChanges と RejectChanges](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md)  
+ 行への変更を受け入れたり拒否したりする方法について説明します。  
+  
+## 参照  
+ [DataTable](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatables.md)   
+ [DataTable イベントの処理](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/map-implicit-relations-between-nested-schema-elements.md b/docs/framework/data/adonet/dataset-datatable-dataview/map-implicit-relations-between-nested-schema-elements.md
new file mode 100644
index 00000000000..652d1c2c70b
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/map-implicit-relations-between-nested-schema-elements.md
@@ -0,0 +1,110 @@
+---
+title: "入れ子になっているスキーマ要素間の暗黙的なリレーションの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b25002a-352e-4d9b-bae3-15129458a355
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 入れ子になっているスキーマ要素間の暗黙的なリレーションの割り当て
+XML スキーマ言語定義 \(XSD\) スキーマでは、複数の複合型を入れ子にして指定できます。  この場合、割り当て処理には既定の割り当てが適用されます。その際、<xref:System.Data.DataSet> に作成される内容を次に示します。  
+  
+-   複合型 \(親および子\) それぞれに対して 1 つのテーブル。  
+  
+-   親に UNIQUE 制約がなく、親テーブル名が *TableName* である場合は、*TableName*\_Id という名前の主キー列が、テーブル定義ごとに 1 つ追加されます。  
+  
+-   親テーブルの主キー制約により、追加された列が主キーとして認識されます \(**IsPrimaryKey** プロパティを **True** に設定することで\)。  制約には、Constraint*\#* \(*\#* は、1、2、3 など\) という名前が付けられます。  たとえば、最初の制約の既定の名前は Constraint1 となります。  
+  
+-   子テーブルの外部キー制約により、追加された列が親テーブルの主キーを参照する外部キーとして認識されます。  親テーブル名が *ParentTable*、子テーブル名が *ChildTable* の場合には、制約の名前は *ParentTable\_ChildTable* となります。  
+  
+-   その結果、親テーブルと子テーブル間のデータが関連付けられます。  
+  
+ **OrderDetail** が **Order** 要素の子要素であることを示すスキーマの例を次に示します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+   <xs:complexType>  
+     <xs:choice maxOccurs="unbounded">  
+       <xs:element name="Order">  
+         <xs:complexType>  
+          <xs:sequence>  
+            <xs:element name="OrderNumber" type="xs:string" />  
+            <xs:element name="EmpNumber" type="xs:string" />  
+            <xs:element name="OrderDetail">  
+              <xs:complexType>  
+                <xs:sequence>  
+                  <xs:element name="OrderNo" type="xs:string" />  
+                  <xs:element name="ItemNo" type="xs:string" />  
+                </xs:sequence>  
+              </xs:complexType>  
+            </xs:element>  
+          </xs:sequence>  
+         </xs:complexType>  
+       </xs:element>  
+     </xs:choice>  
+   </xs:complexType>  
+  </xs:element>  
+</xs:schema>  
+```  
+  
+ XML スキーマの割り当て処理によって **DataSet** に作成される内容は、次のとおりです。  
+  
+-   **Order** および **OrderDetail** テーブル。  
+  
+    ```  
+    Order(OrderNumber, EmpNumber, Order_Id)  
+    OrderDetail(OrderNo, ItemNo, Order_Id)  
+    ```  
+  
+-   **Order** テーブルの UNIQUE 制約。  **IsPrimaryKey** プロパティは **True** に設定されるので注意してください。  
+  
+    ```  
+    ConstraintName: Constraint1  
+    Type: UniqueConstraint  
+    Table: Order  
+    Columns: Order_Id   
+    IsPrimaryKey: True  
+    ```  
+  
+-   **OrderDetail** テーブルの外部キー制約。  
+  
+    ```  
+    ConstraintName: Order_OrderDetail  
+    Type: ForeignKeyConstraint  
+    Table: OrderDetail  
+    Columns: Order_Id   
+    RelatedTable: Order  
+    RelatedColumns: Order_Id   
+    ```  
+  
+-   **Order** テーブルと **OrderDetail** テーブル間のリレーションシップ。  スキーマの **Order** 要素と **OrderDetail** 要素が入れ子になっているため、このリレーションシップの **Nested** プロパティは **True** に設定されます。  
+  
+    ```  
+    ParentTable: Order  
+    ParentColumns: Order_Id   
+    ChildTable: OrderDetail  
+    ChildColumns: Order_Id   
+    ParentKeyConstraint: Constraint1  
+    ChildKeyConstraint: Order_OrderDetail  
+    RelationName: Order_OrderDetail  
+    Nested: True  
+    ```  
+  
+## 参照  
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/map-key-xml-schema-xsd-constraints-to-dataset-constraints.md b/docs/framework/data/adonet/dataset-datatable-dataview/map-key-xml-schema-xsd-constraints-to-dataset-constraints.md
new file mode 100644
index 00000000000..1a676e2fcfa
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/map-key-xml-schema-xsd-constraints-to-dataset-constraints.md
@@ -0,0 +1,92 @@
+---
+title: "XML スキーマ (XSD) のキー制約の DataSet 制約への割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22664196-f270-4ebc-a169-70e16a83dfa1
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ (XSD) のキー制約の DataSet 制約への割り当て
+スキーマでは、**key** 要素を使用して要素または属性のキー制約を指定できます。  キー制約を指定する要素または属性の値は、スキーマ インスタンス内で一意になる必要があります。また、null 値にすることはできません。  
+  
+ キー制約を定義する列の値を null 値にできない点を除くと、キー制約は UNIQUE 制約と同じです。  
+  
+ **key** 要素に指定できる **msdata** 属性を次の表に示します。  
+  
+|属性名|説明|  
+|---------|--------|  
+|**msdata:ConstraintName**|この属性を指定した場合、その値が制約名として使用されます。  それ以外の場合は、**name** 属性によって制約名の値が設定されます。|  
+|**msdata:PrimaryKey**|`PrimaryKey="true"` が指定されている場合、**IsPrimaryKey** 制約のプロパティを **true** に設定することによって、主キーになります。  主キーの値は null 値にできないため、**AllowDBNull** 列のプロパティが **false** に設定されます。|  
+  
+ キー制約を指定するスキーマの変換では、割り当て処理により、制約の列ごとに **AllowDBNull** 列のプロパティが **false** に設定された状態でテーブルに UNIQUE 制約が作成されます。  **key** 要素で `msdata:PrimaryKey="true"` を指定しない限り、UNIQUE 制約の **IsPrimaryKey** プロパティも **false** に設定されます。  これは、スキーマに `PrimaryKey="true"` が指定される UNIQUE 制約と同じです。  
+  
+ **key** 要素を使用して **CustomerID** 要素のキー制約を指定するスキーマの例を次に示します。  
+  
+```  
+<xs:schema id="cod"  
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  <xs:element name="Customers">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="CustomerID" type="xs:string" minOccurs="0" />  
+        <xs:element name="CompanyName" type="xs:string" minOccurs="0" />  
+       <xs:element name="Phone" type="xs:string" />  
+     </xs:sequence>  
+   </xs:complexType>  
+ </xs:element>  
+<xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element ref="Customers" />  
+    </xs:choice>  
+  </xs:complexType>  
+   <xs:key  msdata:PrimaryKey="true"  
+       msdata:ConstraintName="KeyCustID"  
+          name="KeyConstCustomerID" >  
+     <xs:selector xpath=".//Customers" />  
+     <xs:field xpath="CustomerID" />  
+    </xs:key>  
+ </xs:element>  
+</xs:schema>   
+```  
+  
+ **key** 要素は、**Customers** 要素の **CustomerID** 子要素の値を一意の値にし、null 値を許可しないように指定します。  XML スキーマ定義言語 \(XSD\) スキーマの変換では、割り当て処理によって次のテーブルが作成されます。  
+  
+```  
+Customers(CustomerID, CompanyName, Phone)  
+```  
+  
+ また、次の <xref:System.Data.DataSet> に示すように、XML スキーマの割り当てによって **CustomerID** 列の **UniqueConstraint** を作成することもできます   \(わかりやすいように、関連するプロパティだけを示します\)。  
+  
+```  
+  
+      DataSetName: MyDataSet  
+TableName: customers  
+  ColumnName: CustomerID  
+      AllowDBNull: False  
+      Unique: True  
+  ConstraintName: KeyCustID  
+      Table: customers  
+      Columns: CustomerID   
+      IsPrimaryKey: True  
+```  
+  
+ 生成される **DataSet** では、スキーマの **Key** 要素で `msdata:PrimaryKey="true"` が指定されるため、**UniqueConstraint** の **IsPrimaryKey** プロパティが **true** に設定されます。  
+  
+ **DataSet** にある **UniqueConstraint**の **ConstraintName** プロパティの値は、スキーマの**key** 要素で指定した **msdata:ConstraintName** 属性の値です。  
+  
+## 参照  
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/map-keyref-xml-schema-xsd-constraints-to-dataset-constraints.md b/docs/framework/data/adonet/dataset-datatable-dataview/map-keyref-xml-schema-xsd-constraints-to-dataset-constraints.md
new file mode 100644
index 00000000000..e7c88244330
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/map-keyref-xml-schema-xsd-constraints-to-dataset-constraints.md
@@ -0,0 +1,125 @@
+---
+title: "XML スキーマ (XSD) のキー参照制約の DataSet 制約への割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b634fea-cc1e-4f6b-9454-10858105b1c8
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ (XSD) のキー参照制約の DataSet 制約への割り当て
+**keyref** 要素を使用すると、ドキュメント内の要素間にリンクを確立できます。  これは、リレーショナル データベースの外部キーのリレーションシップと同様です。  スキーマに **keyref** 要素を指定すると、スキーマの割り当て処理時に keyref 要素がそれに対応する <xref:System.Data.DataSet> の列の外部キー制約に変換されます。  既定では、**keyref** 要素によってリレーションも生成され、リレーションに **ParentColumn**、**ChildTable**、**ParentColumn** および **ChildColumn** プロパティが指定されます。  
+  
+ **keyref** 要素で指定できる **msdata** 属性を次の表に示します。  
+  
+|属性名|説明|  
+|---------|--------|  
+|**msdata:ConstraintOnly**|スキーマの **keyref** 要素で **ConstraintOnly\="true"** を指定した場合、制約が作成されますが、リレーションは作成されません。  この属性を指定しない \(または **False** に設定する\) 場合、制約およびリレーションが **DataSet** に作成されます。|  
+|**msdata:ConstraintName**|**ConstraintName** 属性を指定した場合、その値が制約名として使用されます。  それ以外の場合、スキーマの **keyref** 要素の **name** 属性によって **DataSet** の制約名が設定されます。|  
+|**msdata:UpdateRule**|スキーマの **keyref** 要素で **UpdateRule** 属性を指定した場合、その値が **DataSet** の **UpdateRule** 制約プロパティに割り当てられます。  それ以外の場合、**UpdateRule** プロパティは **Cascade** に設定されます。|  
+|**msdata:DeleteRule**|スキーマの **keyref** 要素で **DeleteRule** 属性を指定した場合、その値が **DataSet** の **DeleteRule** 制約プロパティに割り当てられます。  それ以外の場合、**DeleteRule** プロパティは **Cascade** に設定されます。|  
+|**msdata:AcceptRejectRule**|スキーマの **keyref** 要素で **AcceptRejectRule** 属性を指定した場合、その値が **DataSet** の **AcceptRejectRule** 制約プロパティに割り当てられます。  それ以外の場合、**AcceptRejectRule** プロパティは **None** に設定されます。|  
+  
+ **Order** 要素の **OrderNumber** 子要素と **OrderDetail** 要素の **OrderNo** 子要素間のリレーションシップを指定する **key** 属性と **keyref** 属性を含むスキーマを次の例に示します。  
+  
+ 例では、**OrderDetail** 要素の **OrderNumber** 子要素が **Order** 要素の **OrderNo** キーの子要素を参照します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element name="OrderDetail">  
+       <xs:complexType>  
+         <xs:sequence>  
+           <xs:element name="OrderNo" type="xs:integer" />  
+           <xs:element name="ItemNo" type="xs:string" />  
+         </xs:sequence>  
+       </xs:complexType>  
+      </xs:element>  
+      <xs:element name="Order">  
+        <xs:complexType>  
+          <xs:sequence>  
+            <xs:element name="OrderNumber" type="xs:integer" />  
+            <xs:element name="EmpNumber" type="xs:integer" />  
+          </xs:sequence>  
+        </xs:complexType>  
+      </xs:element>  
+    </xs:choice>  
+  </xs:complexType>  
+  
+  <xs:key name="OrderNumberKey"  >  
+    <xs:selector xpath=".//Order" />  
+    <xs:field xpath="OrderNumber" />  
+  </xs:key>  
+  
+  <xs:keyref name="OrderNoRef" refer="OrderNumberKey">  
+    <xs:selector xpath=".//OrderDetail" />  
+    <xs:field xpath="OrderNo" />  
+  </xs:keyref>  
+ </xs:element>  
+</xs:schema>  
+```  
+  
+ XML スキーマ定義言語 \(XSD\) スキーマの割り当て処理によって、2 つのテーブルを持つ次の **DataSet** が生成されます。  
+  
+```  
+OrderDetail(OrderNo, ItemNo) and  
+Order(OrderNumber, EmpNumber)  
+```  
+  
+ さらに、**DataSet** によって次の制約が定義されます。  
+  
+-   **Order** テーブルの UNIQUE 制約。  
+  
+    ```  
+  
+              Table: Order  
+    Columns: OrderNumber   
+    ConstraintName: OrderNumberKey  
+    Type: UniqueConstraint  
+    IsPrimaryKey: False  
+    ```  
+  
+-   **Order** テーブルと **OrderDetail** テーブル間のリレーションシップ。  スキーマの 2 つの要素が入れ子になっていないため、**Nested** プロパティは **False** に設定されます。  
+  
+    ```  
+  
+              ParentTable: Order  
+    ParentColumns: OrderNumber   
+    ChildTable: OrderDetail  
+    ChildColumns: OrderNo   
+    ParentKeyConstraint: OrderNumberKey  
+    ChildKeyConstraint: OrderNoRef  
+    RelationName: OrderNoRef  
+    Nested: False  
+    ```  
+  
+-   **OrderDetail** テーブルの外部キー制約。  
+  
+    ```  
+  
+              ConstraintName: OrderNoRef  
+    Type: ForeignKeyConstraint  
+    Table: OrderDetail  
+    Columns: OrderNo   
+    RelatedTable: Order  
+    RelatedColumns: OrderNumber   
+    ```  
+  
+## 参照  
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/map-relations-specified-for-nested-elements.md b/docs/framework/data/adonet/dataset-datatable-dataview/map-relations-specified-for-nested-elements.md
new file mode 100644
index 00000000000..4df83119bcd
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/map-relations-specified-for-nested-elements.md
@@ -0,0 +1,87 @@
+---
+title: "入れ子になっている要素に指定したリレーションシップの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24a2d3e5-4af7-4f9a-ab7a-fe6684c9e4fe
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 入れ子になっている要素に指定したリレーションシップの割り当て
+スキーマには、その中の 2 つの要素間の割り当てを明示的に指定するために、**msdata:Relationship** 注釈をインクルードすることができます。  **msdata:Relationship** で指定されたスキーマの 2 つの要素は、必要に応じて、入れ子にすることができます。  割り当て処理では、スキーマの **msdata:Relationship** を使用して 2 つの列間に主キー\/外部キーのリレーションシップを生成します。  
+  
+ **OrderDetail** 要素が **Order** の子要素であることを示す XML スキーマの例を次に示します。  **msdata:Relationship** はこの親子のリレーションシップを識別し、生成された **Order** テーブルの **OrderNumber** 列と生成された **OrderDetail** テーブルの **OrderNo** 列が関連付けられていることを示します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+<xs:element name="MyDataSet" msdata:IsDataSet="true">  
+ <xs:complexType>  
+  <xs:choice maxOccurs="unbounded">  
+   <xs:element name="Order">  
+    <xs:complexType>  
+     <xs:sequence>  
+       <xs:element name="OrderNumber" type="xs:string" />  
+       <xs:element name="EmpNumber" type="xs:string" />  
+       <xs:element name="OrderDetail">  
+          <xs:annotation>  
+           <xs:appinfo>  
+            <msdata:Relationship name="OrdODRelation"   
+                                msdata:parent="Order"   
+                                msdata:child="OrderDetail"   
+                                msdata:parentkey="OrderNumber"   
+                                msdata:childkey="OrderNo"/>  
+           </xs:appinfo>  
+          </xs:annotation>  
+          <xs:complexType>  
+            <xs:sequence>  
+             <xs:element name="OrderNo" type="xs:string" />  
+             <xs:element name="ItemNo" type="xs:string" />  
+            </xs:sequence>  
+         </xs:complexType>  
+       </xs:element>  
+     </xs:sequence>  
+    </xs:complexType>  
+   </xs:element>  
+  </xs:choice>  
+ </xs:complexType>  
+</xs:element>  
+</xs:schema>  
+```  
+  
+ XML スキーマの割り当て処理によって <xref:System.Data.DataSet> に作成される内容は、次のとおりです。  
+  
+-   **Order** および **OrderDetail** テーブル。  
+  
+    ```  
+    Order(OrderNumber, EmpNumber)  
+    OrderDetail(OrderNo, ItemNo)  
+    ```  
+  
+-   **Order** テーブルと **OrderDetail** テーブル間のリレーションシップ。  スキーマの **Order** 要素と **OrderDetail** 要素が入れ子になっているため、このリレーションシップの **Nested** プロパティは **True** に設定されます。  
+  
+    ```  
+    ParentTable: Order  
+    ParentColumns: OrderNumber   
+    ChildTable: OrderDetail  
+    ChildColumns: OrderNo   
+    RelationName: OrdODRelation  
+    Nested: True  
+    ```  
+  
+ 割り当て処理によって制約は作成されません。  
+  
+## 参照  
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/map-unique-xml-schema-xsd-constraints-to-dataset-constraints.md b/docs/framework/data/adonet/dataset-datatable-dataview/map-unique-xml-schema-xsd-constraints-to-dataset-constraints.md
new file mode 100644
index 00000000000..b4d79743df0
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/map-unique-xml-schema-xsd-constraints-to-dataset-constraints.md
@@ -0,0 +1,114 @@
+---
+title: "XML スキーマ (XSD) の UNIQUE 制約の DataSet 制約への割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56da90bf-21d3-4d1a-8bb8-de908866b78d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ (XSD) の UNIQUE 制約の DataSet 制約への割り当て
+XML スキーマ定義言語 \(XSD\) スキーマでは、**unique** 要素を使用して要素または属性の UNIQUE 制約を指定します。  XML スキーマをリレーショナル スキーマに変換する処理では、XML スキーマの要素または属性で指定した UNIQUE 制約が、生成される <xref:System.Data.DataSet> に対応する <xref:System.Data.DataTable> の UNIQUE 制約に割り当てられます。  
+  
+ **unique** 要素で指定できる **msdata** 属性を次の表に示します。  
+  
+|属性名|説明|  
+|---------|--------|  
+|**msdata:ConstraintName**|この属性を指定した場合、その値が制約名として使用されます。  それ以外の場合は、**name** 属性によって制約名の値が設定されます。|  
+|**msdata:PrimaryKey**|**unique** 要素に `PrimaryKey="true"` がある場合、UNIQUE 制約は、**IsPrimaryKey** プロパティが **true** に設定された状態で作成されます。|  
+  
+ **unique** 要素を使用して UNIQUE 制約を指定する XML スキーマの例を次に示します。  
+  
+```  
+<xs:schema id="SampleDataSet"   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  <xs:element name="Customers">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="CustomerID" type="xs:integer"   
+           minOccurs="0"/>  
+        <xs:element name="CompanyName" type="xs:string"   
+           minOccurs="0"/>  
+       <xs:element name="Phone" type="xs:string" />  
+     </xs:sequence>  
+   </xs:complexType>  
+ </xs:element>  
+  
+ <xs:element name="SampleDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element ref="Customers" />  
+    </xs:choice>  
+  </xs:complexType>  
+   <xs:unique      
+msdata:ConstraintName="UCustID"      
+name="UniqueCustIDConstr" >        
+<xs:selector xpath=".//Customers" />        
+<xs:field xpath="CustomerID" />      
+</xs:unique>  
+</xs:element>  
+</xs:schema>  
+```  
+  
+ スキーマの **unique** 要素を使用して、ドキュメント インスタンスのすべての **Customers** 要素に unique 要素を指定します。**CustomerID** 子要素の値は一意になる必要があります。  **DataSet** を作成する場合は、割り当て処理によってスキーマが読み込まれ、次のテーブルが生成されます。  
+  
+```  
+Customers (CustomerID, CompanyName, Phone)  
+```  
+  
+ 次の **DataSet** に示すように、割り当てプロセスによって **CustomerID** 列に対して UNIQUE 制約を作成することもできます   \(わかりやすいように、関連するプロパティだけを示します\)。  
+  
+```  
+  
+      DataSetName: MyDataSet  
+TableName: Customers  
+  ColumnName: CustomerID  
+      AllowDBNull: True  
+      Unique: True  
+  ConstraintName: UcustID  
+      Type: UniqueConstraint  
+      Table: Customers  
+      Columns: CustomerID   
+      IsPrimaryKey: False  
+```  
+  
+ 生成される **DataSet** は UNIQUE 制約のために **IsPrimaryKey** プロパティが **False** に設定されます。  列の **unique** プロパティは、**CustomerID** 列の値が一意であることを示します \(ただし、列の **AllowDBNull** プロパティで指定されているように、CustomerID の値は null 参照となります\)。  
+  
+ スキーマを変更し、オプションの **msdata:PrimaryKey** 属性を **True** に設定すると、UNIQUE 制約がテーブルに作成されます。  **AllowDBNull** 列のプロパティが **False** に、制約の **IsPrimaryKey** プロパティが **True** に設定されると、**CustomerID** 列が主キー列になります。  
+  
+ XML スキーマの要素や属性を組み合わせて UNIQUE 制約を指定できます。  スキーマに別の xs:field 要素を追加することにより、Customer**ID** の値と **CompanyName** の値の組み合わせを任意のインスタンスのすべての **Customers** に対して必ず一意になるように指定する方法を次の例で示します。  
+  
+```  
+  
+      <xs:unique     
+         msdata:ConstraintName="SomeName"    
+         name="UniqueCustIDConstr" >   
+  <xs:selector xpath=".//Customers" />   
+  <xs:field xpath="CustomerID" />   
+  <xs:field xpath="CompanyName" />   
+</xs:unique>  
+```  
+  
+ その結果、**DataSet** に作成される制約を次に示します。  
+  
+```  
+ConstraintName: SomeName  
+  Table: Customers  
+  Columns: CustomerID CompanyName   
+  IsPrimaryKey: False  
+```  
+  
+## 参照  
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md b/docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md
new file mode 100644
index 00000000000..a112a2ae10a
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md
@@ -0,0 +1,54 @@
+---
+title: "XML スキーマ (XSD) 制約の DataSet 制約への割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d0d1a4b-9104-434f-ac04-6c01ab5716b5
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ (XSD) 制約の DataSet 制約への割り当て
+XML スキーマ定義言語 \(XSD\) を使用すると、定義する要素と属性で制約を指定できます。  XML スキーマを <xref:System.Data.DataSet> のリレーショナル スキーマに割り当てると、XML スキーマの制約が **DataSet** 内のテーブルと列の適切なリレーショナル制約に割り当てられます。  
+  
+ このセクションでは、次の XML スキーマの制約の割り当てについて説明します。  
+  
+-   **unique** 要素を使用して指定される UNIQUE 制約  
+  
+-   **key** 要素を使用して指定されるキー制約  
+  
+-   **keyref** 要素を使用して指定されるキー参照制約  
+  
+ 要素または属性に対して制約を指定することにより、同じスキーマに基づくあらゆるドキュメントで、その要素の値について特定の制限を適用できます。  たとえば、スキーマにある **Customer** 要素の **CustomerID** 子要素のキー制約は、**CustomerID** 子要素の値がすべてのドキュメントのインスタンスで一意であり、null 値が許可されないことを示します。  
+  
+ さらに、ドキュメント内のリレーションシップを確立するために、ドキュメント内の要素および属性間に制約を指定することもできます。  ドキュメント内で制約を指定するためにスキーマ内で key 制約または keyref 制約を使用すると、ドキュメントの要素と属性間にリレーションシップを持つことになります。  
+  
+ 割り当て処理は、これらのスキーマ制約を **DataSet** 内に作成されたテーブルでの適切な制約に変換します。  
+  
+## このセクションの内容  
+ [XML スキーマ \(XSD\) の UNIQUE 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-unique-xml-schema-xsd-constraints-to-dataset-constraints.md)  
+ **DataSet** での UNIQUE 制約の作成に使用する XML スキーマの要素について説明します。  
+  
+ [XML スキーマ \(XSD\) のキー制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-key-xml-schema-xsd-constraints-to-dataset-constraints.md)  
+ **DataSet** でのキー制約 \(UNIQUE 制約では null 値が許可されません\) の作成に使用する XML スキーマの要素について説明します。  
+  
+ [XML スキーマ \(XSD\) のキー参照制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-keyref-xml-schema-xsd-constraints-to-dataset-constraints.md)  
+ **DataSet** でのキー参照 \(外部キー\) 制約の作成に使用する XML スキーマの要素について説明します。  
+  
+## 関連項目  
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)  
+ XSD スキーマから作成された **DataSet** のリレーショナル構造 \(スキーマ\) について説明します。  
+  
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)  
+ **DataSet** でのテーブル列間のリレーションの生成に使用する XML スキーマの要素について説明します。  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md b/docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md
new file mode 100644
index 00000000000..3dded0bbd3b
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md
@@ -0,0 +1,91 @@
+---
+title: "DataSet の内容のマージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5e9309a-3ebb-4a9c-9d78-21c4e2bafc5b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet の内容のマージ
+<xref:System.Data.DataSet.Merge%2A> メソッドを使用して、<xref:System.Data.DataSet>、<xref:System.Data.DataTable>、または <xref:System.Data.DataRow> の配列の内容を既存の `DataSet` にマージできます。  いくつかの要因とオプションが、新しいデータを既存の `DataSet` にマージする方法に影響します。  
+  
+## 主キー  
+ マージによって新しいデータとスキーマを受け取るテーブルに主キーがある場合、受信データの新しい行と、<xref:System.Data.DataRowVersion> 行バージョンの主キーの値が受信データの主キーの値と同じである既存の行が照合されます。  受信スキーマの列が既存のスキーマの列と一致する場合、既存の行にあるデータが変更されます。  既存のスキーマと一致しない列は、<xref:System.Data.Common.DataAdapter.MissingSchemaAction%2A> パラメーターに基づいて無視または追加されます。  主キーの値が既存の行と一致しない新しい行は、既存のテーブルに追加されます。  
+  
+ 受信する行または既存の行の状態が <xref:System.Data.DataRowState> の場合、`Original` 行バージョンが存在しないため、`Added` の行の <xref:System.Data.DataRowVersion> 行バージョンの主キーの値を使用して、その 2 つの行の主キーの値を照合します。  
+  
+ 受信テーブルと既存のテーブルに、名前が同じでデータ型が異なる列が含まれている場合、例外がスローされ、`DataSet` の <xref:System.Data.DataSet.MergeFailed> イベントが発生します。  受信テーブルと既存のテーブルの両方にキーが定義されていても、主キーの対象の列が異なる場合、例外がスローされ、`DataSet` の `MergeFailed` イベントが発生します。  
+  
+ マージによって新しいデータを受け取るテーブルに主キーがない場合、受信データの新しい行とそのテーブルの既存の行は一致しません。その代わりに新しい行が既存のテーブルに追加されます。  
+  
+## テーブル名と名前空間  
+ <xref:System.Data.DataTable> オブジェクトには、<xref:System.Data.DataTable.Namespace%2A> プロパティ値を割り当てることができます。  <xref:System.Data.DataTable.Namespace%2A> の値が割り当てられている場合、<xref:System.Data.DataSet> には、<xref:System.Data.DataTable.TableName%2A> の値が同じである複数の <xref:System.Data.DataTable> オブジェクトを含めることができます。  マージ操作の際には、<xref:System.Data.DataTable.TableName%2A> と <xref:System.Data.DataTable.Namespace%2A> の両方を使用してマージの対象を識別します。  <xref:System.Data.DataTable.Namespace%2A> が割り当てられていない場合、<xref:System.Data.DataTable.TableName%2A> のみを使用してマージの対象を識別します。  
+  
+> [!NOTE]
+>  この動作は .NET Framework version 2.0 で変更されました。  .NET Framework version 1.1 では、名前空間はサポートされていましたが、マージ操作中には無視されました。  そのため、<xref:System.Data.DataTable.Namespace%2A> プロパティ値を使用する <xref:System.Data.DataSet> の動作は、実行されている .NET Framework のバージョンに応じて変わります。  たとえば、`DataTables` を含む 2 つの `DataSets` があり、どちらの <xref:System.Data.DataTable.TableName%2A> プロパティの値も同じですが、<xref:System.Data.DataTable.Namespace%2A> プロパティの値が異なっているとします。  .NET Framework 1.1 では、この 2 つの <xref:System.Data.DataSet> オブジェクトをマージするときには <xref:System.Data.DataTable.Namespace%2A> の名前の違いが無視されます。  しかし、バージョン 2.0 以降では、マージを実行すると対象の <xref:System.Data.DataSet> に新しい `DataTables` が 2 つ作成されます。  元の `DataTables` はマージの影響を受けません。  
+  
+## PreserveChanges  
+ `DataSet`、`DataTable`、または `DataRow` の各配列を `Merge` メソッドに渡すときに、オプション パラメーターを含めることができます。そのパラメーターを使用して、変更内容を既存の `DataSet` に保存するかどうか、および受信データで見つかった新しいスキーマの要素を処理する方法を指定します。  受信データの後に続く最初のオプション パラメーターは、Boolean 型のフラグ <xref:System.Data.LoadOption> で、変更内容を既存の `DataSet` に保存するかどうかを指定します。  `PreserveChanges` フラグを `true` に設定した場合、既存の行の `Current` 行バージョンの値は受信する値で上書きされません。  `PreserveChanges` フラグを `false` に設定した場合、既存の行の `Current` 行バージョンの値が受信した値で上書きされます。  `PreserveChanges` フラグを指定しない場合は、既定で `false` に設定されます。  行バージョンの詳細については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+ `PreserveChanges` を `true` に設定すると、既存の行のデータは <xref:System.Data.DataRowVersion> 行バージョンで保存されますが、既存の行の <xref:System.Data.DataRowVersion> 行バージョンのデータは受信した行の `Original` 行バージョンのデータで上書きされます。  既存の行の <xref:System.Data.DataRow.RowState%2A> は、<xref:System.Data.DataRowState> に設定されます。  適用される例外を次に示します。  
+  
+-   既存の行の `RowState` が `Deleted` の場合、この `RowState` は `Deleted` のままであり、`Modified` には設定されません。  この場合、受信した行のデータは既存の行の `Original` 行バージョンとして保存され、既存の行の `Original` 行バージョンのデータが上書きされます \(受信する行の `RowState` が `Added` でない場合\)。  
+  
+-   受信した行の `RowState` が `Added` の場合、受信した行には `Original` 行バージョンが存在しないため、既存の行の `Original` 行バージョンのデータは受信した行のデータで上書きされません。  
+  
+ `PreserveChanges` が `false` の場合、既存の行の `Current` と `Original` の両方の行バージョンが受信した行のデータで上書きされます。さらに、既存の行の `RowState` が、受信した行の `RowState` に設定されます。  適用される例外を次に示します。  
+  
+-   受信した行の `RowState` が `Unchanged` であり、既存の行の `RowState` が `Modified`、`Deleted`、または `Added` である場合、既存の行の `RowState` は `Modified` に設定されます。  
+  
+-   受信した行の `RowState` が `Added` であり、既存の行の `RowState` が `Unchanged`、`Modified`、または `Deleted` である場合、既存の行の `RowState` は `Modified` に設定されます。  また、受信した行には `Original` 行バージョンが存在しないため、既存の行の `Original` 行バージョンのデータは、受信した行のデータで上書きされません。  
+  
+## MissingSchemaAction  
+ `Merge` メソッドのオプションである <xref:System.Data.MissingSchemaAction> パラメーターを使用して、既存の `DataSet` に含まれない受信データのスキーマ要素を `Merge` で処理する方法を指定できます。  
+  
+ 次の表で、`MissingSchemaAction` のオプションについて説明します。  
+  
+|MissingSchemaAction のオプション|説明|  
+|--------------------------------|--------|  
+|<xref:System.Data.MissingSchemaAction>|新しいスキーマ情報を `DataSet` に追加し、受信した値を新しい列に読み込みます。  既定値です。|  
+|<xref:System.Data.MissingSchemaAction>|新しいスキーマおよび主キーの情報を `DataSet` に追加し、受信した値を新しい列に読み込みます。|  
+|<xref:System.Data.MissingSchemaAction>|一致しないスキーマ情報が見つかった場合、例外をスローします。|  
+|<xref:System.Data.MissingSchemaAction>|新しいスキーマ情報を無視します。|  
+  
+## 制約  
+ `Merge` メソッドでは、新しいデータがすべて既存の `DataSet` に追加されるまで制約がチェックされません。  データが追加されると、`DataSet` の現在の値に制約が適用されます。  開発者は、制約違反のためにスローされる例外をコードで処理する必要があります。  
+  
+ `DataSet` 内に、`Unchanged` に設定され、主キー値が 1 である既存の行があるとします。  マージ操作の際、受信した行が `Modified` に設定され、`Original` 行バージョンの主キーの値が 2 であり、`Current` 行バージョンの主キーの値が 1 である場合、`Original` 行バージョンの主キーの値が一致しないため、既存の行と受信した行は一致していると見なされません。  マージが完了し、制約がチェックされると、`Current` 行バージョンの主キーの値が主キー列の UNIQUE 制約に違反するため、例外がスローされます。  
+  
+> [!NOTE]
+>  ID 列などの自動インクリメント列を含むデータベース テーブルに行を挿入すると、挿入によって返される ID 列の値が `DataSet` の列の値と一致せず、返された列がマージされずに追加されることがあります。  詳細については、「[ID 値および Autonumber 値の取得](../../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)」を参照してください。  
+  
+ 次のコード サンプルでは、スキーマが異なる 2 つの `DataSet` オブジェクトをマージし、その 2 つの受信 `DataSet` オブジェクトのスキーマを組み合わせたスキーマを持つ 1 つの `DataSet` を作成します。  
+  
+ [!code-csharp[DataWorks DataSet.Merge#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataSet.Merge/CS/source.cs#1)]
+ [!code-vb[DataWorks DataSet.Merge#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataSet.Merge/VB/source.vb#1)]  
+  
+ 次のコード サンプルでは、更新内容を含む既存の `DataSet` を取得し、その更新内容を `DataAdapter` に渡してデータ ソースで処理します。  次に、その結果を元の `DataSet` にマージします。  エラーとなった変更内容が拒否された後、マージされた変更内容が `AcceptChanges` を使用してコミットされます。  
+  
+ [!code-csharp[DataWorks DataSet.MergeAcceptChanges#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataSet.MergeAcceptChanges/CS/source.cs#1)]
+ [!code-vb[DataWorks DataSet.MergeAcceptChanges#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataSet.MergeAcceptChanges/VB/source.vb#1)]  
+  
+ [!code-csharp[DataWorks DataSet.MergeAcceptChanges#2](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataSet.MergeAcceptChanges/CS/source.cs#2)]
+ [!code-vb[DataWorks DataSet.MergeAcceptChanges#2](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataSet.MergeAcceptChanges/VB/source.vb#2)]  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)   
+ [DataAdapter と DataReader](../../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ID 値および Autonumber 値の取得](../../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/modifying-dataviews.md b/docs/framework/data/adonet/dataset-datatable-dataview/modifying-dataviews.md
new file mode 100644
index 00000000000..d3b8b46ab8b
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/modifying-dataviews.md
@@ -0,0 +1,64 @@
+---
+title: "DataView の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 697a3991-b660-4a5a-8a54-1a2304ff158e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataView の変更
+<xref:System.Data.DataView> を使用して、データ行を基になるテーブルに追加、削除、または変更できます。  基になるテーブルのデータを **DataView** で変更できるかどうかは、**DataView** の 3 つのブール値プロパティで制御されます。  この 3 つのプロパティとは、<xref:System.Data.DataView.AllowNew%2A>、<xref:System.Data.DataView.AllowEdit%2A> および <xref:System.Data.DataView.AllowDelete%2A> です。  これらのプロパティの既定値は **true** です。  
+  
+ **AllowNew** が **true** の場合は、**DataView** の <xref:System.Data.DataView.AddNew%2A> メソッドを使用して <xref:System.Data.DataRowView> を新規に作成できます。  **DataRowView** の <xref:System.Data.DataRowView.EndEdit%2A> メソッドが呼び出されるまでは、新規に作成された行は基になる <xref:System.Data.DataTable> に追加されません。  **DataRowView** の <xref:System.Data.DataRowView.CancelEdit%2A> メソッドが呼び出されると、新規に作成された行は破棄されます。  一度に編集できるのは、1 つの **DataRowView** だけです。  保留中の行がある場合は、**DataRowView** の **AddNew** メソッドまたは **BeginEdit** メソッドを呼び出すと、保留中の行に対して **EndEdit** が暗黙的に呼び出されます。  **EndEdit** が呼び出されると、基になる **DataTable** に対して変更が適用されます。適用された変更をコミットするには **DataTable**、**DataSet**、または **DataRow** の各オブジェクトの **AcceptChanges** メソッドを使用し、拒否するにはこれらのオブジェクトの **RejectChanges** メソッドを使用します。  **AllowNew** が **false** の場合は、**DataRowView** の **AddNew** メソッドを呼び出すと例外がスローされます。  
+  
+ **AllowEdit** が **true** の場合は、**DataRowView** を使用すると **DataRow** の内容を変更できます。  基になる行の変更内容を確定するには **DataRowView.EndEdit** を使用し、変更内容を取り消すには **DataRowView.CancelEdit** を使用します。  一度に編集できるのは 1 行だけです。  保留中の行がある場合は、**DataRowView** の **AddNew** メソッドまたは **BeginEdit** メソッドを呼び出すと、保留中の行に対して **EndEdit** が暗黙的に呼び出されます。  **EndEdit** が呼び出されると、基になる **DataRow** の **Current** 行バージョンに対して変更が適用されます。適用された変更をコミットするには **DataTable**、**DataSet**、または **DataRow** の各オブジェクトの **AcceptChanges** メソッドを使用し、拒否するにはこれらのオブジェクトの **RejectChanges** メソッドを使用します。  **AllowEdit** が **false** の場合は、**DataView** の値を変更しようとすると例外がスローされます。  
+  
+ 既存の **DataRowView** の編集中でも、まだ確定されていない変更に関して、基になる **DataTable** のイベントが発生する場合があります。  **DataRowView** に対して **EndEdit** と **CancelEdit** のどちらが呼び出されているかに関係なく、基になる **DataRow** に対して **EndEdit** を呼び出すと、確定されていない変更が適用され、**CancelEdit** を呼び出すと、確定されていない変更が取り消されます。  
+  
+ **AllowDelete** が **true** の場合は、**DataView** オブジェクトまたは **DataRowView** オブジェクトの **Delete** メソッドを使用して **DataView** の行を削除できます。DataView の行を削除すると、基になる **DataTable** から行が削除されます。  後でこの削除操作をコミットするには **AcceptChanges** を使用し、拒否するには **RejectChanges** を使用します。  **AllowDelete** が **false** の場合は、**DataView** または **DataRowView** の **Delete** メソッドを呼び出すと例外がスローされます。  
+  
+ 次のコード サンプルは、**DataView** を使用して行を削除する機能を無効にし、**DataView** を使用して基になるテーブルに新しい行を追加します。  
+  
+```vb  
+Dim custTable As DataTable = custDS.Tables("Customers")  
+Dim custView As DataView = custTable.DefaultView  
+custView.Sort = "CompanyName"  
+  
+custView.AllowDelete = False  
+  
+Dim newDRV As DataRowView = custView.AddNew()  
+newDRV("CustomerID") = "ABCDE"  
+newDRV("CompanyName") = "ABC Products"  
+newDRV.EndEdit()  
+  
+```  
+  
+```csharp  
+DataTable custTable = custDS.Tables["Customers"];  
+DataView custView = custTable.DefaultView;  
+custView.Sort = "CompanyName";  
+  
+custView.AllowDelete = false;  
+  
+DataRowView newDRV = custView.AddNew();  
+newDRV["CustomerID"] = "ABCDE";  
+newDRV["CompanyName"] = "ABC Products";  
+newDRV.EndEdit();  
+```  
+  
+## 参照  
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataView>   
+ <xref:System.Data.DataRowView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datarelations.md b/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datarelations.md
new file mode 100644
index 00000000000..07c49c27f1f
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datarelations.md
@@ -0,0 +1,58 @@
+---
+title: "DataRelation の移動 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5e673f4-9b44-45ae-aaea-c504d1cc5d3e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataRelation の移動
+<xref:System.Data.DataRelation> の主な機能の 1 つは、<xref:System.Data.DataSet> の 1 つの <xref:System.Data.DataTable> から別の <xref:System.Data.DataTable> を移動できることです。  この参照により、関連付けられた **DataTable** から単一の **DataRow** を指定すると、1 つの **DataTable** 内の関連する <xref:System.Data.DataRow> オブジェクトをすべて取得できます。  たとえば、顧客のテーブルとオーダーのテーブル間に **DataRelation** を確立すると、**GetChildRows** を使用して特定の顧客行のオーダー行をすべて取得できます。  
+  
+ **DataSet** の **Customers** テーブルと **Orders** テーブル間の **DataRelation** を作成し、各顧客のすべてのオーダーを返すコード サンプルを次に示します。  
+  
+ [!code-csharp[DataWorks Data.DataTableRelation#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks Data.DataTableRelation/CS/source.cs#1)]
+ [!code-vb[DataWorks Data.DataTableRelation#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks Data.DataTableRelation/VB/source.vb#1)]  
+  
+ 上記の例に基づいて、4 つのテーブルを相互に関連付け、そのテーブルのリレーションシップ間を移動する例を次に示します。  上記の例に示すように、**CustomerID** は **Customers** テーブルを **Orders** テーブルに関連付けます。  **Customers** テーブルにある各顧客に対しては、**Orders** テーブルにあるすべての子の行が確定され、該当する顧客のオーダー数とその **OrderID** の値が返されます。  
+  
+ 展開された例では、**OrderDetails** テーブルおよび **Products** テーブルからも値が返されます。  各顧客のオーダーに対しては、オーダーされた製品および数量を示すために、**OrderID** を使用して **Orders** テーブルが **OrderDetails** テーブルに関連付けられます。  **OrderDetails** テーブルに含まれているのは、オーダーされた製品の **ProductID** だけであるため、**ProductID** を使用して、**OrderDetails** を **Products** に関連付けて **ProductName** を返します。  このリレーションでは、**Products** テーブルが親となり、**Order Details** テーブルが子となります。  その結果、**OrderDetails** テーブルを順次処理すると、**GetParentRow** が呼び出され、関連付けられた **ProductName** の値を取得します。  
+  
+ **DataRelation** が **Customers** テーブルと **Orders** テーブルに対して作成された場合には、**createConstraints** フラグには値が指定されません \(既定値は **true**\)。  これは、**Orders** テーブルにあるすべての行に対して親の **Customers** テーブルにある **CustomerID** の値が設定されているためです。  **Orders** テーブルに、**Customers** テーブルに存在しない **CustomerID** が存在する場合、<xref:System.Data.ForeignKeyConstraint> は例外をスローします。  
+  
+ 親の列に含まれていない値が子の列に含まれる場合、**DataRelation** の追加時に **createConstraints** フラグが **false** に設定されます。  例では、**Orders** テーブルと **OrderDetails** テーブル間の **DataRelation** に対して、**createConstraints** フラグが **false** に設定されています。  このため、このアプリケーションでは **OrderDetails** テーブルからすべてのレコードを返し、実行時に例外を生成せずに **Orders** テーブルからレコードのサブセットだけを返すことができます。  展開された例では、次の形式で出力が生成されます。  
+  
+```  
+Customer ID: NORTS  
+  Order ID: 10517  
+        Order Date: 4/24/1997 12:00:00 AM  
+           Product: Filo Mix  
+          Quantity: 6  
+           Product: Raclette Courdavault  
+          Quantity: 4  
+           Product: Outback Lager  
+          Quantity: 6  
+  Order ID: 11057  
+        Order Date: 4/29/1998 12:00:00 AM  
+           Product: Outback Lager  
+          Quantity: 3  
+```  
+  
+ **Orders** テーブルのレコードのサブセットだけと共に、**OrderDetails** テーブルと **Products** テーブルからの値が返された場合に展開された例を次のコード サンプルに示します。  
+  
+ [!code-csharp[DataWorks Data.DataTableNavigation#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks Data.DataTableNavigation/CS/source.cs#1)]
+ [!code-vb[DataWorks Data.DataTableNavigation#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks Data.DataTableNavigation/VB/source.vb#1)]  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datatables.md b/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datatables.md
new file mode 100644
index 00000000000..aad93082e29
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/navigating-datatables.md
@@ -0,0 +1,32 @@
+---
+title: "DataTable の移動 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 202026a1-ec79-435e-b507-12a77f5011b2
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataTable の移動
+<xref:System.Data.DataTableReader> は、1 つ以上の <xref:System.Data.DataTable> オブジェクトの内容を、読み取り専用、前方参照専用の 1 つ以上の結果セットとして取得します。  
+  
+ <xref:System.Data.DataSet.CreateDataReader%2A> メソッドの呼び出しにより DataTableReader を作成した場合、<xref:System.Data.DataTableReader> に複数の結果セットが含まれる場合があります。  結果セットが複数ある場合、<xref:System.Data.DataTableReader.NextResult%2A> メソッドは、カーソルを次の結果セットに移動します。  これは前方参照専用です。  前の結果セットに戻ることはできません。  
+  
+## 例  
+ 2 つの <xref:System.Data.DataTable> ``  インスタンスを作成する `TestConstructor` メソッドの例を次に示します。  <xref:System.Data.DataTableReader> クラスを対象としたこのコンストラクターを示すために、この例では、2 つの **DataTables** が含まれる配列に基づいた新しい **DataTableReader** を作成し、単純な操作を実行して、最初の 2 ～ 3 列の内容をコンソール ウィンドウに表示します。  
+  
+ [!code-csharp[DataWorks DataTableReader.NextResult#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DataTableReader.NextResult/CS/source.cs#1)]
+ [!code-vb[DataWorks DataTableReader.NextResult#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DataTableReader.NextResult/VB/source.vb#1)]  
+  
+## 参照  
+ [DataTableReaders](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/datatablereaders.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md b/docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md
new file mode 100644
index 00000000000..ead5cbc4a02
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md
@@ -0,0 +1,142 @@
+---
+title: "DataRelation の入れ子化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9530f9c9-dd98-4b93-8cdb-40d7f1e8d0ab
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataRelation の入れ子化
+データのリレーショナル表現では、各テーブルに含まれている行が、列または列セットを使用して相互に関連付けられています。  ADO.NET の <xref:System.Data.DataSet> では、テーブル間のリレーションシップは <xref:System.Data.DataRelation> を使用して実装されます。  **DataRelation** を作成すると、親子の列のリレーションシップはこのリレーションだけをとおして管理されます。  テーブルと列はそれぞれ別個のエンティティです。  XML のデータ階層表現では、子要素が入れ子の状態で含まれている親要素によって親子のリレーションシップが表現されます。  
+  
+ 子オブジェクトの入れ子を実現するため、**DataSet** が <xref:System.Xml.XmlDataDocument> と同期されるか、または **WriteXml** を使用して XML データとして書き込まれるときに、**DataRelation** が **Nested** プロパティを公開します。  **DataRelation** の **Nested** プロパティを **true** に設定すると、XML データとして書き込まれるとき、または **XmlDataDocument** と同期されるときに、このリレーションにおける子の行が親の列の中で入れ子になります。  **DataRelation** の **Nested** プロパティは既定では **false** に設定されています。  
+  
+ たとえば、次のような **DataSet** があるとします。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+Dim customerAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT CustomerID, CompanyName FROM Customers", connection)  
+Dim orderAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT OrderID, CustomerID, OrderDate FROM Orders", connection)  
+  
+connection.Open()  
+  
+Dim dataSet As DataSet = New DataSet("CustomerOrders")  
+customerAdapter.Fill(dataSet, "Customers")  
+orderAdapter.Fill(dataSet, "Orders")  
+  
+connection.Close()  
+  
+Dim customerOrders As DataRelation = dataSet.Relations.Add( _  
+  "CustOrders", dataSet.Tables("Customers").Columns("CustomerID"), _  
+  dataSet.Tables("Orders").Columns("CustomerID"))  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+SqlDataAdapter customerAdapter = new SqlDataAdapter(  
+  "SELECT CustomerID, CompanyName FROM Customers", connection);  
+SqlDataAdapter orderAdapter = new SqlDataAdapter(  
+  "SELECT OrderID, CustomerID, OrderDate FROM Orders", connection);  
+  
+connection.Open();  
+  
+DataSet dataSet = new DataSet("CustomerOrders");  
+customerAdapter.Fill(dataSet, "Customers");  
+orderAdapter.Fill(dataSet, "Orders");  
+  
+connection.Close();  
+  
+DataRelation customerOrders = dataSet.Relations.Add(  
+  "CustOrders", dataSet.Tables["Customers"].Columns["CustomerID"],  
+  dataSet.Tables["Orders"].Columns["CustomerID"]);  
+```  
+  
+ この **DataSet** では **DataRelation** オブジェクトの **Nested** プロパティが **true** に設定されていないため、**DataSet** が XML データとして表されるときに、子オブジェクトは親要素の中で入れ子になりません。  関連する **DataSet** を含んだ **DataSet** の XML 表現を変換するとき、データ リレーションが入れ子になっていないと、パフォーマンスが低下する場合があります。  データ リレーションシップは入れ子にすることをお勧めします。  入れ子にするには、**Nested** プロパティを **true** に設定します。  次に、トップダウン階層形式の XPath クエリ式を使用してデータを検索、変換するコードを XSLT スタイル シートに記述します。  
+  
+ **DataSet** に対して **WriteXml** を呼び出した結果を次のコード サンプルに示します。  
+  
+```  
+<CustomerOrders>  
+  <Customers>  
+    <CustomerID>ALFKI</CustomerID>  
+    <CompanyName>Alfreds Futterkiste</CompanyName>  
+  </Customers>  
+  <Customers>  
+    <CustomerID>ANATR</CustomerID>  
+    <CompanyName>Ana Trujillo Emparedados y helados</CompanyName>  
+  </Customers>  
+  <Orders>  
+    <OrderID>10643</OrderID>  
+    <CustomerID>ALFKI</CustomerID>  
+    <OrderDate>1997-08-25T00:00:00</OrderDate>  
+  </Orders>  
+  <Orders>  
+    <OrderID>10692</OrderID>  
+    <CustomerID>ALFKI</CustomerID>  
+    <OrderDate>1997-10-03T00:00:00</OrderDate>  
+  </Orders>  
+  <Orders>  
+    <OrderID>10308</OrderID>  
+    <CustomerID>ANATR</CustomerID>  
+    <OrderDate>1996-09-18T00:00:00</OrderDate>  
+  </Orders>  
+</CustomerOrders>  
+```  
+  
+ **Customers** 要素と **Orders** 要素が兄弟要素として示されています。  **Orders** 要素を該当する親要素の子として表すには、**DataRelation** の **Nested** プロパティを **true** に設定し、次のコードを追加する必要があります。  
+  
+```vb  
+customerOrders.Nested = True  
+```  
+  
+```csharp  
+customerOrders.Nested = true;  
+```  
+  
+ 上記のコードを追加した結果の出力を次のコードに示します。この例では、**Orders** 要素がそれぞれ該当する親要素の中で入れ子になっています。  
+  
+```  
+<CustomerOrders>  
+  <Customers>  
+    <CustomerID>ALFKI</CustomerID>  
+    <Orders>  
+      <OrderID>10643</OrderID>  
+      <CustomerID>ALFKI</CustomerID>  
+      <OrderDate>1997-08-25T00:00:00</OrderDate>  
+    </Orders>  
+    <Orders>  
+      <OrderID>10692</OrderID>  
+      <CustomerID>ALFKI</CustomerID>  
+      <OrderDate>1997-10-03T00:00:00</OrderDate>  
+    </Orders>  
+    <CompanyName>Alfreds Futterkiste</CompanyName>  
+  </Customers>  
+  <Customers>  
+    <CustomerID>ANATR</CustomerID>  
+    <Orders>  
+      <OrderID>10308</OrderID>  
+      <CustomerID>ANATR</CustomerID>  
+      <OrderDate>1996-09-18T00:00:00</OrderDate>  
+    </Orders>  
+    <CompanyName>Ana Trujillo Emparedados y helados</CompanyName>  
+  </Customers>  
+</CustomerOrders>  
+```  
+  
+## 参照  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataRelation の追加](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/performing-an-xpath-query-on-a-dataset.md b/docs/framework/data/adonet/dataset-datatable-dataview/performing-an-xpath-query-on-a-dataset.md
new file mode 100644
index 00000000000..1f4cff450cb
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/performing-an-xpath-query-on-a-dataset.md
@@ -0,0 +1,110 @@
+---
+title: "DataSet に対する XPath クエリの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e828566-fffe-4d38-abb2-4d68fd73f663
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet に対する XPath クエリの実行
+同期された <xref:System.Data.DataSet> と <xref:System.Xml.XmlDataDocument> との間のリレーションシップによって、XPath \(XML Path Language\) クエリなどの XML サービスが使用できます。XML サービスは **XmlDataDocument** にアクセスし、**DataSet** に直接アクセスするよりも、特定の機能を効率的に実行できます。  たとえば、<xref:System.Data.DataTable> の **Select** メソッドを使用して **DataSet** の他のテーブルとのリレーションシップをナビゲートする代わりに、**DataSet** と同期化された **XmlDataDocument** に対して XPath クエリを実行すると、<xref:System.Xml.XmlNodeList> 形式で XML 要素のリストを取得できます。  <xref:System.Xml.XmlElement> ノードとしてキャストされた **XmlNodeList** のノードを **XmlDataDocument** の **GetRowFromElement** メソッドに渡すと、同期化された **DataSet** のテーブルの行に一致する <xref:System.Data.DataRow> 参照が返されます。  
+  
+ たとえば、次に示すコード サンプルでは孫 XPath クエリが実行されます。  **DataSet** には、**Customers**、**Orders**、および **OrderDetails** の 3 つのテーブルが格納されています。  このサンプルでは、**Customers** テーブルと **Orders** テーブルの間に親子のリレーションが作成され、次に **Orders** テーブルと **OrderDetails** テーブルの間に親子のリレーションが作成されます。  XPath クエリが実行され、値 43 の **ProductID** ノードを持つ孫 **OrderDetails** ノードのある **Customers** ノードの **XmlNodeList** リストが返されます。  つまり、このサンプルでは、XPath クエリを使用して **ProductID** が 43 の製品を注文した顧客を確認します。  
+  
+```vb  
+' Assumes that connection is a valid SqlConnection.  
+connection.Open()  
+Dim dataSet As DataSet = New DataSet("CustomerOrders")  
+Dim customerAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM Customers", connection)  
+customerAdapter.Fill(dataSet, "Customers")  
+  
+Dim orderAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM Orders", connection)  
+orderAdapter.Fill(dataSet, "Orders")  
+  
+Dim detailAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM [Order Details]", connection)  
+detailAdapter.Fill(dataSet, "OrderDetails")  
+  
+connection.Close()  
+  
+dataSet.Relations.Add("CustOrders", _  
+dataSet.Tables("Customers").Columns("CustomerID"), _  
+dataSet.Tables("Orders").Columns("CustomerID")).Nested = true  
+  
+dataSet.Relations.Add("OrderDetail", _  
+  dataSet.Tables("Orders").Columns("OrderID"), _  
+dataSet.Tables("OrderDetails").Columns("OrderID"), false).Nested = true  
+  
+Dim xmlDoc As XmlDataDocument = New XmlDataDocument(dataSet)   
+  
+Dim nodeList As XmlNodeList = xmlDoc.DocumentElement.SelectNodes( _  
+  "descendant::Customers[*/OrderDetails/ProductID=43]")  
+  
+Dim dataRow As DataRow  
+Dim xmlNode As XmlNode  
+  
+For Each xmlNode In nodeList  
+  dataRow = xmlDoc.GetRowFromElement(CType(xmlNode, XmlElement))  
+  
+  If Not dataRow Is Nothing then Console.WriteLine(xmlRow(0).ToString())  
+Next  
+```  
+  
+```csharp  
+// Assumes that connection is a valid SqlConnection.  
+connection.Open();  
+  
+DataSet dataSet = new DataSet("CustomerOrders");  
+  
+SqlDataAdapter customerAdapter = new SqlDataAdapter(  
+  "SELECT * FROM Customers", connection);  
+customerAdapter.Fill(dataSet, "Customers");  
+  
+SqlDataAdapter orderAdapter = new SqlDataAdapter(  
+  "SELECT * FROM Orders", connection);  
+orderAdapter.Fill(dataSet, "Orders");  
+  
+SqlDataAdapter detailAdapter = new SqlDataAdapter(  
+  "SELECT * FROM [Order Details]", connection);  
+detailAdapter.Fill(dataSet, "OrderDetails");  
+  
+connection.Close();  
+  
+dataSet.Relations.Add("CustOrders",  
+  dataSet.Tables["Customers"].Columns["CustomerID"],  
+ dataSet.Tables["Orders"].Columns["CustomerID"]).Nested = true;  
+  
+dataSet.Relations.Add("OrderDetail",  
+  dataSet.Tables["Orders"].Columns["OrderID"],  
+  dataSet.Tables["OrderDetails"].Columns["OrderID"],   
+  false).Nested = true;  
+  
+XmlDataDocument xmlDoc = new XmlDataDocument(dataSet);   
+  
+XmlNodeList nodeList = xmlDoc.DocumentElement.SelectNodes(  
+  "descendant::Customers[*/OrderDetails/ProductID=43]");  
+  
+DataRow dataRow;  
+foreach (XmlNode xmlNode in nodeList)  
+{  
+  dataRow = xmlDoc.GetRowFromElement((XmlElement)xmlNode);  
+  if (dataRow != null)  
+    Console.WriteLine(dataRow[0]);  
+}  
+```  
+  
+## 参照  
+ [DataSet と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md b/docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md
new file mode 100644
index 00000000000..e8c903c2174
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md
@@ -0,0 +1,90 @@
+---
+title: "行エラー情報 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b1f9070-d032-48c7-b030-bd8fbb2ca59a
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 行エラー情報
+<xref:System.Data.DataTable> の値を編集しているときに、行エラーに対処する必要をなくすために、エラー情報を行に追加して後で使用することができます。  <xref:System.Data.DataRow> オブジェクトは、この目的のために各行に <xref:System.Data.DataRow.RowError%2A> プロパティを提供します。  **DataRow** の **RowError** プロパティにデータを追加すると、その **DataRow** の <xref:System.Data.DataRow.HasErrors%2A> プロパティが **true** に設定されます。  **DataRow** が **DataTable** の一部であり、**DataRow.HasErrors** が **true** である場合は、**DataTable.HasErrors** プロパティも **true** になります。  この原則は、**DataTable** が属している **DataSet** に対しても適用されます。  エラーの有無を確認する場合は、**HasErrors** プロパティをチェックして、エラー情報が追加された行があるかどうかを判断できます。  **HasErrors** が **true** の場合に **DataTable** の <xref:System.Data.DataTable.GetErrors%2A> メソッドを使用して、エラーのある行だけを返してチェックする例を次に示します。  
+  
+```vb  
+Dim workTable As DataTable = New DataTable("Customers")  
+workTable.Columns.Add("CustID", Type.GetType("System.Int32"))  
+workTable.Columns.Add("Total", Type.GetType("System.Double"))  
+  
+AddHandler workTable.RowChanged, New DataRowChangeEventHandler(AddressOf OnRowChanged)  
+  
+Dim i  As Int32  
+  
+For i  = 0 To 10  
+  workTable.Rows.Add(New Object() {i , i *100})  
+Next  
+  
+If workTable.HasErrors Then  
+  Console.WriteLine("Errors in Table " & workTable.TableName)  
+  
+  Dim myRow As DataRow  
+  
+  For Each myRow In workTable.GetErrors()  
+    Console.WriteLine("CustID = " & myRow("CustID").ToString())  
+    Console.WriteLine(" Error = " & myRow.RowError & vbCrLf)  
+  Next  
+End If  
+  
+Private Shared Sub OnRowChanged( _  
+    sender As Object, args As DataRowChangeEventArgs)  
+  ' Check for zero values.  
+  If CDbl(args.Row("Total")) = 0 Then args.Row.RowError = _  
+      "Total cannot be 0."  
+End Sub  
+  
+```  
+  
+```csharp  
+DataTable  workTable = new DataTable("Customers");  
+workTable.Columns.Add("CustID", typeof(Int32));  
+workTable.Columns.Add("Total", typeof(Double));  
+  
+workTable.RowChanged += new DataRowChangeEventHandler(OnRowChanged);  
+  
+for (int i = 0; i < 10; i++)  
+  workTable.Rows.Add(new Object[] {i, i*100});  
+  
+if (workTable.HasErrors)  
+{  
+  Console.WriteLine("Errors in Table " + workTable.TableName);  
+  
+  foreach (DataRow myRow in workTable.GetErrors())  
+  {  
+    Console.WriteLine("CustID = " + myRow["CustID"]);  
+    Console.WriteLine(" Error = " + myRow.RowError + "\n");  
+  }  
+}  
+  
+protected static void OnRowChanged(  
+    Object sender, DataRowChangeEventArgs args)  
+{  
+  // Check for zero values.  
+  if (args.Row["Total"].Equals(0D))  
+    args.Row.RowError = "Total cannot be 0.";  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.DataColumnCollection>   
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataTable>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md b/docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md
new file mode 100644
index 00000000000..07bf1fd87b9
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md
@@ -0,0 +1,107 @@
+---
+title: "行の状態とバージョン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e6642c9-bfc6-425c-b3a7-e4912ffa6c1f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 行の状態とバージョン
+ADO.NET は、行の状態とバージョンを使用してテーブル内の行を管理します。  行状態は、1 つの行のステータスを示します。行バージョンは、1 つの行の値が変更されるときに、変更に応じてその行に格納される現在の値、元の値、既定値などを維持します。  たとえば、ある行の 1 つの列を変更すると、この行の状態は `Modified` になり、次の 2 つの行バージョンが存在することになります。`Current` には現在の行値が格納され、`Original` にはその列が変更される前の行値が格納されます。  
+  
+ 各 <xref:System.Data.DataRow> オブジェクトにある <xref:System.Data.DataRow.RowState%2A> プロパティを調べると、行の現在の状態を確認できます。  `RowState` 列挙値ごとの簡単な説明を次の表に示します。  
+  
+|RowState の値|説明|  
+|-----------------|--------|  
+|<xref:System.Data.DataRowState>|`AcceptChanges` が最後に呼び出されてから、または `DataAdapter.Fill` によって行が作成されてから変更は行われていません。|  
+|<xref:System.Data.DataRowState>|行がテーブルに追加されましたが、`AcceptChanges` が呼び出されていません。|  
+|<xref:System.Data.DataRowState>|行のいくつかの要素が変更されました。|  
+|<xref:System.Data.DataRowState>|行がテーブルから削除されましたが、`AcceptChanges` が呼び出されていません。|  
+|<xref:System.Data.DataRowState>|行がどの `DataRowCollection` にも属していません。  新しく作成された行の `RowState` は `Detached` に設定されます。  `Add` メソッドを呼び出して新しい `DataRow` を `DataRowCollection` に追加すると、`RowState` プロパティの値は `Added` に設定されます。<br /><br /> `Detached` は、`Remove` メソッドを使用するか、または `Delete` メソッドに続いて `AcceptChanges` メソッドを使用して `DataRowCollection` から削除された行に対しても設定されます。|  
+  
+ <xref:System.Data.DataSet>、<xref:System.Data.DataTable>、または <xref:System.Data.DataRow> の `AcceptChanges` が呼び出されると、`Deleted` の行状態を持つすべての行が削除されます。  残りの行の行状態は `Unchanged` になり、`Current` 行バージョンの値は `Original` 行バージョンの値で上書きされます。  `RejectChanges` が呼び出されると、`Added` の行状態を持つすべての行が削除されます。  残りの行の行状態は `Unchanged` になり、`Original` 行バージョンの値は `Current` 行バージョンの値で上書きされます。  
+  
+ <xref:System.Data.DataRowVersion> パラメーターと列参照を渡すことにより、ある行の行バージョンを表示する例を次に示します。  
+  
+```vb  
+Dim custRow As DataRow = custTable.Rows(0)  
+Dim custID As String = custRow("CustomerID", DataRowVersion.Original).ToString()  
+  
+```  
+  
+```csharp  
+DataRow custRow = custTable.Rows[0];  
+string custID = custRow["CustomerID", DataRowVersion.Original].ToString();  
+```  
+  
+ `DataRowVersion` 列挙値ごとの簡単な説明を次の表に示します。  
+  
+|DataRowVersion の値|説明|  
+|-----------------------|--------|  
+|<xref:System.Data.DataRowVersion>|行の現在の値。  この行バージョンは、`Deleted` の `RowState` を持つ行については存在しません。|  
+|<xref:System.Data.DataRowVersion>|特定の行の既定の行バージョン。  `Added`、`Modified`、または `Unchanged` 行の既定の行バージョンは、`Current` です。  `Deleted` 行の既定の行バージョンは、`Original` です。  `Detached` 行の既定の行バージョンは、`Proposed` です。|  
+|<xref:System.Data.DataRowVersion>|行の元の値。  この行バージョンは、`Added` の `RowState` を持つ行については存在しません。|  
+|<xref:System.Data.DataRowVersion>|行に対して提示された値。  この行バージョンは、行、つまり `DataRowCollection` の一部ではない行に対する編集操作の間存在します。|  
+  
+ <xref:System.Data.DataRow.HasVersion%2A> メソッドを呼び出して `DataRowVersion` を引数として渡すことにより、`DataRow` が特定の行バージョンを持っているかどうかを確認できます。  たとえば、`DataRow.HasVersion(DataRowVersion.Original)` は、新しく追加された行に対して `AcceptChanges` が呼び出されていない場合に `false` を返します。  
+  
+ テーブルから削除されたすべての行の値を表示するコード サンプルを次に示します。  `Deleted` 行には `Current` 行バージョンがないため、列値にアクセスするときに `DataRowVersion.Original` を渡す必要があります。  
+  
+```vb  
+Dim catTable As DataTable = catDS.Tables("Categories")  
+  
+Dim delRows() As DataRow = catTable.Select(Nothing, Nothing, DataViewRowState.Deleted)  
+  
+Console.WriteLine("Deleted rows:" & vbCrLf)  
+  
+Dim catCol As DataColumn  
+Dim delRow As DataRow  
+  
+For Each catCol In catTable.Columns  
+  Console.Write(catCol.ColumnName & vbTab)  
+Next  
+Console.WriteLine()  
+  
+For Each delRow In delRows  
+  For Each catCol In catTable.Columns  
+    Console.Write(delRow(catCol, DataRowVersion.Original) & vbTab)  
+  Next  
+  Console.WriteLine()  
+Next  
+  
+```  
+  
+```csharp  
+DataTable catTable = catDS.Tables["Categories"];  
+  
+DataRow[] delRows = catTable.Select(null, null, DataViewRowState.Deleted);  
+  
+Console.WriteLine("Deleted rows:\n");  
+  
+foreach (DataColumn catCol in catTable.Columns)  
+  Console.Write(catCol.ColumnName + "\t");  
+Console.WriteLine();  
+  
+foreach (DataRow delRow in delRows)  
+{  
+  foreach (DataColumn catCol in catTable.Columns)  
+    Console.Write(delRow[catCol, DataRowVersion.Original] + "\t");  
+  Console.WriteLine();  
+}  
+```  
+  
+## 参照  
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [DataAdapter と DataReader](../../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md b/docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md
new file mode 100644
index 00000000000..ceca8a201c0
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md
@@ -0,0 +1,70 @@
+---
+title: "データの並べ替えとフィルター処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fdd9c753-39df-48cd-9822-2781afe76200
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# データの並べ替えとフィルター処理
+<xref:System.Data.DataView> には、<xref:System.Data.DataTable> のデータの並べ替えとフィルター処理を行うさまざまな方法が用意されています。  
+  
+-   <xref:System.Data.DataView.Sort%2A> プロパティを使用すれば、1 列または複数列の並べ替え順序を指定し、ASC \(昇順\) パラメーターと DESC \(降順\) パラメーターを含めることができます。  
+  
+-   <xref:System.Data.DataView.ApplyDefaultSort%2A> プロパティを使用すると、テーブルの主キー列 \(1 列または複数列\) に基づいて、昇順の並べ替え順序を自動的に作成できます。  **Sort** プロパティが null 参照または空の文字列の場合、およびテーブルに主キーが定義されている場合は、<xref:System.Data.DataView.ApplyDefaultSort%2A> だけが適用されます。  
+  
+-   <xref:System.Data.DataView.RowFilter%2A> プロパティを使用すると、列の値に基づいて行のサブセットを指定できます。  **RowFilter** プロパティの有効な式の詳細については、<xref:System.Data.DataColumn> クラスの <xref:System.Data.DataColumn.Expression%2A> プロパティの情報を参照してください。  
+  
+     データ サブセットの動的ビューの作成とは対照的に、データに対して特定のクエリの実行結果を返す場合、パフォーマンスを最大限に引き出すには、**RowFilter** プロパティを設定する代わりに **DataView** の <xref:System.Data.DataView.Find%2A> メソッドまたは <xref:System.Data.DataView.FindRows%2A> メソッドを使用します。  **RowFilter** プロパティを設定すると、データのインデックスが再作成され、アプリケーションのオーバーヘッドが増加してパフォーマンスの低下を招きます。  **RowFilter** プロパティは、データ連結アプリケーションでの使用に適しています。このアプリケーションでは、連結されたコントロールによってフィルター処理結果が表示されます。  **Find** メソッドと **FindRows** メソッドでは、現在のインデックスが使用されます。このため、インデックスを再作成する必要はありません。  **Find** メソッドと **FindRows** メソッドの詳細については、「[行の検索](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md)」を参照してください。  
+  
+-   <xref:System.Data.DataView.RowStateFilter%2A> プロパティを使用して、表示する行バージョンを指定できます。  **DataView** は、基になる行の **RowState** に従って、暗黙的に行バージョンを公開します。  たとえば、**RowStateFilter** が **DataViewRowState.Deleted** に設定されている場合、**DataView** は行バージョンが **Original** の **Deleted** 行をすべて公開します。これは、**Current** 行バージョンが存在しないためです。  **DataRowView** の **RowVersion** プロパティを使用すると、公開される行のバージョンを確認できます。  
+  
+     **DataViewRowState** のオプションを次の表に示します。  
+  
+    |DataViewRowState のオプション|説明|  
+    |-----------------------------|--------|  
+    |**CurrentRows**|**Current** 行バージョンのすべての **Unchanged** 行、**Added** 行、および **Modified** 行です。  既定値です。|  
+    |**Added**|**Current** 行バージョンのすべての **Added** 行です。|  
+    |**Deleted**|**Original** 行バージョンのすべての **Deleted** 行です。|  
+    |**ModifiedCurrent**|**Current** 行バージョンのすべての **Modified** 行です。|  
+    |**ModifiedOriginal**|**Original**  行バージョンのすべての **Modified** 行です。|  
+    |**なし**|行がありません。|  
+    |**OriginalRows**|**Original** 行バージョンのすべての **Unchanged** 行、**Modified** 行、および **Deleted** 行です。|  
+    |**Unchanged**|**Current** 行バージョンのすべての **Unchanged** 行です。|  
+  
+ 行状態と行バージョンの詳細については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+ 在庫数が標準在庫数以下である製品を、仕入先 ID \(supplier ID\) で並べ替え、さらに製品名 \(product name\) で並べ替えたビューを作成するコード サンプルを次に示します。  
+  
+```vb  
+Dim prodView As DataView = New DataView(prodDS.Tables("Products"), _  
+   "UnitsInStock <= ReorderLevel", _  
+   "SupplierID, ProductName", _  
+   DataViewRowState.CurrentRows)  
+  
+```  
+  
+```csharp  
+DataView prodView = new DataView(prodDS.Tables["Products"],  
+   "UnitsInStock <= ReorderLevel",  
+   "SupplierID, ProductName",  
+   DataViewRowState.CurrentRows);  
+```  
+  
+## 参照  
+ <xref:System.Data.DataViewRowState>   
+ <xref:System.Data.DataColumn.Expression%2A?displayProperty=fullName>   
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataView>   
+ [DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/specify-relations-between-elements-with-no-nesting.md b/docs/framework/data/adonet/dataset-datatable-dataview/specify-relations-between-elements-with-no-nesting.md
new file mode 100644
index 00000000000..c631ce05604
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/specify-relations-between-elements-with-no-nesting.md
@@ -0,0 +1,77 @@
+---
+title: "入れ子になっていない要素間のリレーションの指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e31325da-7691-4d33-acf4-99fccca67006
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 入れ子になっていない要素間のリレーションの指定
+要素が入れ子になっていない場合、暗黙的なリレーションは作成されません。  それに対し、**msdata:Relationship** 注釈を使用すると、入れ子になっていない要素間にリレーションを明示的に指定できます。  
+  
+ 互いに入れ子になっていない **Order** 要素と **OrderDetail** 要素の間に **msdata:Relationship** 注釈を指定する XML スキーマの例を次に示します。  **msdata:Relationship** 注釈は、**Schema** 要素の子要素として指定します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+             xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+             xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element name="OrderDetail">  
+       <xs:complexType>  
+         <xs:sequence>  
+           <xs:element name="OrderNo" type="xs:string" />  
+           <xs:element name="ItemNo" type="xs:string" />  
+         </xs:sequence>  
+       </xs:complexType>  
+      </xs:element>  
+      <xs:element name="Order">  
+       <xs:complexType>  
+         <xs:sequence>  
+           <xs:element name="OrderNumber" type="xs:string" />  
+           <xs:element name="EmpNumber" type="xs:string" />  
+         </xs:sequence>  
+       </xs:complexType>  
+      </xs:element>  
+    </xs:choice>  
+  </xs:complexType>  
+  
+  </xs:element>  
+   <xs:annotation>  
+     <xs:appinfo>  
+       <msdata:Relationship name="OrdOrderDetailRelation"  
+                            msdata:parent="Order"   
+                            msdata:child="OrderDetail"   
+                            msdata:parentkey="OrderNumber"   
+                            msdata:childkey="OrderNo"/>  
+     </xs:appinfo>  
+  </xs:annotation>  
+</xs:schema>  
+```  
+  
+ 次に示すように、XML スキーマ定義言語 \(XSD\) スキーマの割り当て処理によって、**Order** テーブルと **OrderDetail** テーブルを含む <xref:System.Data.DataSet> が生成され、それらのテーブル間にリレーションシップが指定されます。  
+  
+```  
+RelationName: OrdOrderDetailRelation  
+ParentTable: Order  
+ParentColumns: OrderNumber   
+ChildTable: OrderDetail  
+ChildColumns: OrderNo   
+Nested: False  
+```  
+  
+## 参照  
+ [XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)   
+ [XML スキーマ \(XSD\) 制約の DataSet 制約への割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/mapping-xml-schema-xsd-constraints-to-dataset-constraints.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/summary-of-the-dataset-schema-inference-process.md b/docs/framework/data/adonet/dataset-datatable-dataview/summary-of-the-dataset-schema-inference-process.md
new file mode 100644
index 00000000000..0ff41be4c3e
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/summary-of-the-dataset-schema-inference-process.md
@@ -0,0 +1,46 @@
+---
+title: "DataSet スキーマの推論プロセスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd0891c8-d068-4e30-a76f-7c375f078bf7
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet スキーマの推論プロセスの概要
+推論プロセスでは、まず、テーブルとして推論する XML ドキュメントの要素を決定します。  XML ドキュメントの残りの要素から、それらのテーブルの列が推論によって決定されます。  入れ子状のテーブルの場合は、入れ子になった <xref:System.Data.DataRelation> オブジェクトと <xref:System.Data.ForeignKeyConstraint> オブジェクトが生成されます。  
+  
+ 推論規則について、次に簡単に説明します。  
+  
+-   属性を持つ要素は、テーブルとして推論されます。  
+  
+-   子要素を持つ要素は、テーブルとして推論されます。  
+  
+-   繰り返し出現する要素は、単一のテーブルとして推論されます。  
+  
+-   ドキュメント \(ルート\) 要素に属性がなく、列として推論される子要素もない場合、その要素は <xref:System.Data.DataSet> として推論されます。  それ以外の場合は、ドキュメント要素はテーブルとして推論されます。  
+  
+-   属性は、列として推論されます。  
+  
+-   属性または子要素を持たず、繰り返し出現することもない要素は、列として推論されます。  
+  
+-   テーブルとして推論される要素が、同じくテーブルとして推論される他の要素の内部に入れ子になっている場合は、その 2 つのテーブル間に入れ子になった **DataRelation** が作成されます。  その場合、**TableName\_Id** という名前の新しい主キー列がその両方のテーブルに追加され、**DataRelation**  によって使用されます。  この **TableName\_Id** 列を使用して、この 2 つのテーブル間に **ForeignKeyConstraint** が作成されます。  
+  
+-   テーブルとして推論される要素に、テキストは含まれているが子要素は含まれていない場合は、**TableName\_Text** という名前の新しい列が各要素のテキストに作成されます。  テーブルとして推論される要素にテキストだけでなく、子要素もある場合、テキストは無視されます。  
+  
+## 参照  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)   
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)   
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)   
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/synchronizing-a-dataset-with-an-xmldatadocument.md b/docs/framework/data/adonet/dataset-datatable-dataview/synchronizing-a-dataset-with-an-xmldatadocument.md
new file mode 100644
index 00000000000..c4e47481d28
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/synchronizing-a-dataset-with-an-xmldatadocument.md
@@ -0,0 +1,240 @@
+---
+title: "Dataset と XmlDataDocument の同期 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fbc96fa9-b5d1-4f97-b099-c89b0e14ce2c
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Dataset と XmlDataDocument の同期
+このセクションでは、<xref:System.Xml.XmlDataDocument> と同期され、厳密に型指定された <xref:System.Data.DataSet> を使用して、注文書を処理する手順の 1 ステップを例に説明します。  この例では、**DataSet** をソース XML ドキュメントの一部だけと一致する最小限のスキーマと共に作成します。  この例では、**XmlDataDocument** を使用してソース XML ドキュメントが完全に保持されるため、XML ドキュメントのサブセットを公開するときに **DataSet** を使用できます。  
+  
+ 注文書に関する情報 \(顧客情報、発注品目、出荷情報など\) をすべて含む XML ドキュメントの例を次に示します。  
+  
+```  
+<?xml version="1.0" standalone="yes"?>  
+<PurchaseOrder>  
+  <Customers>  
+    <CustomerID>CHOPS</CustomerID>  
+    <Orders>  
+      <OrderID>10966</OrderID>  
+      <OrderDetails>  
+        <OrderID>10966</OrderID>  
+        <ProductID>37</ProductID>  
+        <UnitPrice>26</UnitPrice>  
+        <Quantity>8</Quantity>  
+        <Discount>0</Discount>  
+      </OrderDetails>  
+      <OrderDetails>  
+        <OrderID>10966</OrderID>  
+        <ProductID>56</ProductID>  
+        <UnitPrice>38</UnitPrice>  
+        <Quantity>12</Quantity>  
+        <Discount>0.15</Discount>  
+      </OrderDetails>  
+      <OrderDetails>  
+        <OrderID>10966</OrderID>  
+        <ProductID>62</ProductID>  
+        <UnitPrice>49.3</UnitPrice>  
+        <Quantity>12</Quantity>  
+        <Discount>0.15</Discount>  
+      </OrderDetails>  
+      <CustomerID>CHOPS</CustomerID>  
+      <EmployeeID>4</EmployeeID>  
+      <OrderDate>1998-03-20T00:00:00.0000000</OrderDate>  
+      <RequiredDate>1998-04-17T00:00:00.0000000</RequiredDate>  
+      <ShippedDate>1998-04-08T00:00:00.0000000</ShippedDate>  
+      <ShipVia>1</ShipVia>  
+      <Freight>27.19</Freight>  
+      <ShipName>Chop-suey Chinese</ShipName>  
+      <ShipAddress>Hauptstr. 31</ShipAddress>  
+      <ShipCity>Bern</ShipCity>  
+      <ShipPostalCode>3012</ShipPostalCode>  
+      <ShipCountry>Switzerland</ShipCountry>  
+    </Orders>  
+    <CompanyName>Chop-suey Chinese</CompanyName>  
+    <ContactName>Yang Wang</ContactName>  
+    <ContactTitle>Owner</ContactTitle>  
+    <Address>Hauptstr. 29</Address>  
+    <City>Bern</City>  
+    <PostalCode>3012</PostalCode>  
+    <Country>Switzerland</Country>  
+    <Phone>0452-076545</Phone>  
+  </Customers>  
+  <Shippers>  
+    <ShipperID>1</ShipperID>  
+    <CompanyName>Speedy Express</CompanyName>  
+    <Phone>(503) 555-0100</Phone>  
+  </Shippers>  
+  <Shippers>  
+    <ShipperID>2</ShipperID>  
+    <CompanyName>United Package</CompanyName>  
+    <Phone>(503) 555-0101</Phone>  
+  </Shippers>  
+  <Shippers>  
+    <ShipperID>3</ShipperID>  
+    <CompanyName>Federal Shipping</CompanyName>  
+    <Phone>(503) 555-0102</Phone>  
+  </Shippers>  
+  <Products>  
+    <ProductID>37</ProductID>  
+    <ProductName>Gravad lax</ProductName>  
+    <QuantityPerUnit>12 - 500 g pkgs.</QuantityPerUnit>  
+    <UnitsInStock>11</UnitsInStock>  
+    <UnitsOnOrder>50</UnitsOnOrder>  
+    <ReorderLevel>25</ReorderLevel>  
+  </Products>  
+  <Products>  
+    <ProductID>56</ProductID>  
+    <ProductName>Gnocchi di nonna Alice</ProductName>  
+    <QuantityPerUnit>24 - 250 g pkgs.</QuantityPerUnit>  
+    <UnitsInStock>21</UnitsInStock>  
+    <UnitsOnOrder>10</UnitsOnOrder>  
+    <ReorderLevel>30</ReorderLevel>  
+  </Products>  
+  <Products>  
+    <ProductID>62</ProductID>  
+    <ProductName>Tarte au sucre</ProductName>  
+    <QuantityPerUnit>48 pies</QuantityPerUnit>  
+    <UnitsInStock>17</UnitsInStock>  
+    <UnitsOnOrder>0</UnitsOnOrder>  
+    <ReorderLevel>0</ReorderLevel>  
+  </Products>  
+</PurchaseOrder>  
+```  
+  
+ 前述の XML ドキュメントに含まれている注文書の情報を処理する手順の 1 ステップとして、企業の現在の在庫のデータを使用してこの注文書が処理されます。  企業の倉庫で注文を処理する従業員は、注文書の内容をすべて確認する必要はありません。確認する必要がある情報は、注文書の製品情報だけです。  XML ドキュメントの製品情報だけを公開するには、厳密に型指定した **DataSet** を作成し、XML スキーマ定義言語 \(XSD\) スキーマとして記述されているスキーマをこの **DataSet** に読み込みます。このスキーマは、注文の製品と数量に対応しています。  厳密に型指定された **DataSet** オブジェクトの詳細については、「[型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)」を参照してください。  
+  
+ このサンプルの厳密に型指定された **DataSet** の生成元となるスキーマを次のコードに示します。  
+  
+```  
+<?xml version="1.0" standalone="yes"?>  
+<xs:schema id="OrderDetail" xmlns=""   
+                            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+                            xmlns:codegen="urn:schemas-microsoft-com:xml-msprop"   
+                            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  <xs:element name="OrderDetail" msdata:IsDataSet="true">  
+    <xs:complexType>  
+      <xs:choice maxOccurs="unbounded">  
+        <xs:element name="OrderDetails" codegen:typedName="LineItem" codegen:typedPlural="LineItems">  
+          <xs:complexType>  
+            <xs:sequence>  
+              <xs:element name="OrderID" type="xs:int" minOccurs="0" codegen:typedName="OrderID"/>  
+              <xs:element name="Quantity" type="xs:short" minOccurs="0" codegen:typedName="Quantity"/>  
+              <xs:element name="ProductID" type="xs:int" minOccurs="0" codegen:typedName="ProductID"/>  
+            </xs:sequence>  
+          </xs:complexType>  
+        </xs:element>  
+        <xs:element name="Products" codegen:typedName="Product" codegen:typedPlural="Products">  
+          <xs:complexType>  
+            <xs:sequence>  
+              <xs:element name="ProductID" type="xs:int" minOccurs="0" codegen:typedName="ProductID"/>  
+              <xs:element name="ProductName" type="xs:string" minOccurs="0" codegen:typedName="ProductName"/>  
+              <xs:element name="QuantityPerUnit" type="xs:string" minOccurs="0" codegen:typedName="QuantityPerUnit"/>  
+              <xs:element name="UnitsInStock" type="xs:short" minOccurs="0" codegen:typedName="UnitsInStock"/>  
+              <xs:element name="UnitsOnOrder" type="xs:short" minOccurs="0" codegen:typedName="UnitsOnOrder"/>  
+              <xs:element name="ReorderLevel" type="xs:short" minOccurs="0" codegen:typedName="ReorderLevel"/>  
+            </xs:sequence>  
+          </xs:complexType>  
+        </xs:element>  
+      </xs:choice>  
+    </xs:complexType>  
+    <xs:unique name="Constraint1">  
+      <xs:selector xpath=".//Products" />  
+      <xs:field xpath="ProductID" />  
+    </xs:unique>  
+    <xs:keyref name="Relation1" refer="Constraint1" codegen:typedChildren="GetLineItems" codegen:typedParent="Product">  
+      <xs:selector xpath=".//OrderDetails" />  
+      <xs:field xpath="ProductID" />  
+    </xs:keyref>  
+  </xs:element>  
+</xs:schema>  
+```  
+  
+ 元の XML ドキュメントの **OrderDetails** 要素と **Products** 要素の情報だけが **DataSet** のスキーマにインクルードされます。  **DataSet** を **XmlDataDocument** と同期させることで、**DataSet** にインクルードされていない要素も XML ドキュメントに保持されます。  
+  
+ **Northwind.FillOrder** の名前空間を使用して XML スキーマから生成される、厳密に型指定された **DataSet** を使用すると、元の XML ドキュメントの一部を公開できます。XML ドキュメントの一部を公開するには、ソース XML ドキュメントから読み込まれた **XmlDataDocument** に **DataSet** を同期させます。  このスキーマから生成された **DataSet** には構造が含まれていますが、データは含まれていません。  XML を **XmlDataDocument** に読み込むと、データが格納されます。  データが既に含まれている **DataSet** と同期された **XmlDataDocument** を読み込もうとすると、例外がスローされます。  
+  
+ **DataSet** と **XmlDataDocument** の更新後には、**XmlDataDocument** によって、変更後の XML ドキュメントと、**DataSet** によって無視された要素を出力できます。この例を次に示します。  注文書の処理手順では、注文品目の入力後に、変更された XML ドキュメントが注文処理の次のステップ \(社内の出荷部門\) に渡されます。  
+  
+```vb  
+Imports System  
+Imports System.Data  
+Imports System.Xml  
+Imports Northwind.FillOrder  
+  
+Public class Sample  
+  Public Shared Sub Main()  
+  
+    Dim orderDS As OrderDetail = New OrderDetail  
+  
+    Dim xmlDocument As XmlDataDocument = New XmlDataDocument(orderDS)   
+  
+    xmlDocument.Load("Order.xml")  
+  
+    Dim orderItem As OrderDetail.LineItem  
+    Dim product As OrderDetail.Product  
+  
+    For Each orderItem In orderDS.LineItems  
+      product = orderItem.Product  
+  
+      ' Remove quantity from the current stock.  
+      product.UnitsInStock = CType(product.UnitsInStock - orderItem.Quantity, Short)  
+  
+      ' If the remaining stock is less than the reorder level, order more.  
+      If ((product.UnitsInStock + product.UnitsOnOrder) < product.ReorderLevel) Then  
+        product.UnitsOnOrder = CType(product.UnitsOnOrder + product.ReorderLevel, Short)  
+      End If  
+    Next  
+  
+    xmlDocument.Save("Order_out.xml")  
+  End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Data;  
+using System.Xml;  
+using Northwind.FillOrder;  
+  
+public class Sample  
+{  
+  public static void Main()  
+  {  
+    OrderDetail orderDS = new OrderDetail();   
+  
+    XmlDataDocument xmlDocument = new XmlDataDocument(orderDS);   
+  
+    xmlDocument.Load("Order.xml");  
+  
+    foreach (OrderDetail.LineItem orderItem in orderDS.LineItems)  
+    {  
+      OrderDetail.Product product = orderItem.Product;  
+  
+      // Remove quantity from the current stock.  
+      product.UnitsInStock = (short)(product.UnitsInStock - orderItem.Quantity);  
+  
+      // If the remaining stock is less than the reorder level, order more.  
+      if ((product.UnitsInStock + product.UnitsOnOrder) < product.ReorderLevel)  
+        product.UnitsOnOrder = (short)(product.UnitsOnOrder + product.ReorderLevel);  
+    }  
+  
+    xmlDocument.Save("Order_out.xml");  
+  }  
+}  
+```  
+  
+## 参照  
+ [DataSet と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/the-load-method.md b/docs/framework/data/adonet/dataset-datatable-dataview/the-load-method.md
new file mode 100644
index 00000000000..b54c7d62e03
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/the-load-method.md
@@ -0,0 +1,80 @@
+---
+title: "Load メソッド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e22e5812-89c6-41f0-9302-bb899a46dbff
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Load メソッド
+<xref:System.Data.DataTable.Load%2A> メソッドを使用して、データ ソースの行を <xref:System.Data.DataTable> に読み込むことができます。  これはオーバーロードされたメソッドで、最も単純な形式で単一の **DataReader** パラメーターを受け取ります。  この形式により、このメソッドは **DataTable** に対する行の読み込みのみを行います。  あるいは、**LoadOption** パラメーターを指定して **DataTable** へのデータの追加方法を制御することもできます。  
+  
+ **LoadOption** パラメーターは、**DataTable** にデータの行が既に含まれている場合に特に役立ちます。それは、このパラメーターによって、データ ソースから読み込まれるデータとテーブル内に既に存在するデータを組み合わせる方法が指定されているためです。  たとえば、**PreserveCurrentValues** \(既定値\) は、**DataTable** の行が **Added** としてマークされ、データ ソースの行に一致する内容に対して **Original** 値または各列が設定されている場合に指定します。  **Current** 値は、行が追加されたときに割り当てられた値が保持され、その行の **RowState** は **Changed** に設定されます。  
+  
+ <xref:System.Data.LoadOption> 列挙値の簡単な説明を次の表に示します。  
+  
+|LoadOption の値|説明|  
+|-------------------|--------|  
+|**OverwriteRow**|読み込まれる行と **DataTable** に既に存在する行で **PrimaryKey** 値が同じ場合、各列の **Original** 値と **Current** 値は読み込まれる行の値に置き換えられ、**RowState** プロパティは **Unchanged** に設定されます。<br /><br /> **DataTable** に存在していなかった行がデータ ソースから読み込まれ、その行の **RowState** 値は **Unchanged** に設定されます。<br /><br /> このオプションは **DataTable** の内容を更新して、データ ソースの内容と一致するようにします。|  
+|**PreserveCurrentValues \(既定値\)**|読み込まれる行と **DataTable** に既に存在する行の **PrimaryKey** 値が同じ場合、**Original** 値には読み込まれる行の内容が設定されますが、**Current** 値は変更されません。<br /><br /> **RowState** が **Added** または **Modified** の場合、この値は **Modified** に設定されます。<br /><br /> **RowState** が **Deleted** であった場合、この値は **Deleted** のままとなります。<br /><br /> **DataTable** に存在していなかった行がデータ ソースから読み込まれ、その行の **RowState** は **Unchanged** に設定されます。|  
+|**UpdateCurrentValues**|読み込まれる行と **DataTable** に既に存在する行の **PrimaryKey** 値が同じ場合、**Current** 値が **Original** 値にコピーされ、**Current** 値には読み込まれる行の内容が設定されます。<br /><br /> **DataTable** の **RowState** が **Added** の場合、**RowState** は **Added** のままとなります。  **Modified** または **Deleted** としてマークされた行の **RowState** は **Modified** になります。<br /><br /> **DataTable** に存在していなかった行がデータ ソースから読み込まれ、その行の **RowState** は **Added** に設定されます。|  
+  
+ **Load** メソッドを使用して **Northwind** データベースに従業員の誕生日リストを表示する例を次に示します。  
+  
+ \[Visual Basic\]  
+  
+```  
+Private Sub LoadBirthdays(ByVal connectionString As String)  
+    ' Assumes that connectionString is a valid connection string  
+    ' to the Northwind database on SQL Server.  
+    Dim queryString As String = _  
+    "SELECT LastName, FirstName, BirthDate " & _  
+      " FROM dbo.Employees " & _  
+      "ORDER BY BirthDate, LastName, FirstName"  
+  
+    ' Open and fill a DataSet.   
+    Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
+        queryString, connectionString)  
+    Dim employees As New DataSet  
+    adapter.Fill(employees, "Employees")  
+  
+    ' Create a SqlDataReader for use with the Load Method.  
+    Dim reader As DataTableReader = employees.GetDataReader()  
+  
+    ' Create an instance of DataTable and assign the first  
+    ' DataTable in the DataSet.Tables collection to it.  
+    Dim dataTableEmp As DataTable = employees.Tables(0)  
+  
+    ' Fill the DataTable with data by calling Load and  
+    ' passing the SqlDataReader.  
+    dataTableEmp.Load(reader, LoadOption.OverwriteRow)  
+  
+    ' Loop through the rows collection and display the values  
+    ' in the console window.  
+    Dim employeeRow As DataRow  
+    For Each employeeRow In dataTableEmp.Rows  
+        Console.WriteLine("{0:MM\\dd\\yyyy}" & ControlChars.Tab & _  
+          "{1}, {2}", _  
+          employeeRow("BirthDate"), _  
+          employeeRow("LastName"), _  
+          employeeRow("FirstName"))  
+    Next employeeRow  
+  
+    ' Keep the window opened to view the contents.  
+    Console.ReadLine()  
+End Sub  
+```  
+  
+## 参照  
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md b/docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md
new file mode 100644
index 00000000000..5d21e7a6d82
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md
@@ -0,0 +1,35 @@
+---
+title: "型指定された DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 033d2548-cf24-4c05-8179-67d8b009c048
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 型指定された DataSet
+厳密に型指定されていない変数を使用した値への遅延バインディング アクセスに加えて、<xref:System.Data.DataSet> には、厳密に型指定された変数を使用したデータへのアクセスも用意されています。  **DataSet** の一部であるテーブルと列は、ユーザーが認識しやすい名前と厳密に型指定された変数を使用してアクセスできます。  
+  
+ 型指定された **DataSet** とは、**DataSet** から派生するクラスのことです。  したがって、型指定された **DataSet** は **DataSet** のすべてのメソッド、イベント、およびプロパティを継承します。  さらに、型指定された **DataSet** には、厳密に型指定されたメソッド、イベント、およびプロパティが用意されています。  つまり、コレクションベースのメソッドを使用せずに名前でテーブルおよび列にアクセスできます。  コードが読みやすく変更されただけでなく、型指定された **DataSet** を使用して、入力するとおりにラインを Visual Studio .NET コード エディターに自動挿入できます。  
+  
+ さらに、厳密に型指定された **DataSet** を使用してコンパイル時に正しい型で値にアクセスできます。  厳密に型指定された **DataSet** を使用すると、型の不一致が実行時ではなく、コードのコンパイル時にキャッチされます。  
+  
+## このセクションの内容  
+ [厳密に型指定された DataSet の生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-strongly-typed-datasets.md)  
+ 厳密に型指定された **DataSet** の作成および使用方法について説明します。  
+  
+ [型指定された DataSet の注釈](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/annotating-typed-datasets.md)  
+ 基になるスキーマを変更せずに **DataSet** の要素に表示名を付けるために、厳密に型指定された **DataSet** の生成に使用する XML スキーマ定義言語 \(XSD\) スキーマに注釈を付ける方法について説明します。  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md b/docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md
new file mode 100644
index 00000000000..4e3ab9e6278
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md
@@ -0,0 +1,58 @@
+---
+title: "DataSet での XML の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35138159-e199-49ec-baf7-1ec6777e171e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataSet での XML の使用
+ADO.NET では、XML ストリームまたは XML ドキュメントから <xref:System.Data.DataSet> にデータを格納できます。  <xref:System.Data.DataSet> にデータまたはスキーマ情報を格納するには、XML ストリームまたは XML ドキュメントを使用します。  XML ストリームまたは XML ドキュメントから提供される情報を <xref:System.Data.DataSet> の既存のデータまたはスキーマ情報と組み合わせることもできます。  
+  
+ ADO.NET では、他のアプリケーションや XML 対応プラットフォームで <xref:System.Data.DataSet> が使用される場合に、この <xref:System.Data.DataSet> を HTTP 経由で転送するため、**DataSet** の XML 表現を作成できます。このとき、**DataSet** にスキーマが含まれていても、含まれていなくてもかまいません。  <xref:System.Data.DataSet> の XML 表現では、データを XML で記述します。XML 表現にスキーマをインラインで含める場合は、このスキーマを XML スキーマ定義言語 \(XSD\) で記述します。  XML および XML スキーマには、リモート クライアントとの間で <xref:System.Data.DataSet> の内容を転送するための便利な書式が用意されています。  
+  
+## このセクションの内容  
+ [DiffGram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)  
+ <xref:System.Data.DataSet> の内容の読み取りと書き込みに使用される XML 形式である DiffGram について詳しく説明します。  
+  
+ [XML からの DataSet の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md)  
+ XML ドキュメントから <xref:System.Data.DataSet> の内容を読み込むときに考慮する必要のある各種オプションについて説明します。  
+  
+ [DataSet 内容の XML データとしての書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)  
+ <xref:System.Data.DataSet> の内容を XML データとして生成する方法と、使用できる各種 XML 形式オプションについて説明します。  
+  
+ [XML の DataSet スキーマ情報の読み込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-dataset-schema-information-from-xml.md)  
+ XML から <xref:System.Data.DataSet> のスキーマを読み込むために使用される <xref:System.Data.DataSet> のメソッドについて説明します。  
+  
+ [XSD としての DataSet スキーマ情報の書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-schema-information-as-xsd.md)  
+ XML スキーマの使用方法と、<xref:System.Data.DataSet> からの XML スキーマの生成方法について説明します。  
+  
+ [DataSet と XmlDataDocument の同期](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)  
+ 1 つのデータ セットのリレーショナル ビューおよび階層ビューの両方に同期的な方法でアクセスする .NET Framework の機能について説明し、<xref:System.Data.DataSet> と <xref:System.Xml.XmlDataDocument> の間で同期的なリレーションシップを確立する方法について説明します。  
+  
+ [DataRelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)  
+ <xref:System.Data.DataRelation> の内容を XML データとして表現する場合において、入れ子になった <xref:System.Data.DataSet> オブジェクトの重要性について説明します。また、入れ子になったこれらのオブジェクトの作成方法について説明します。  
+  
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)  
+ XML スキーマから作成された <xref:System.Data.DataSet> のリレーショナル構造 \(スキーマ\) について説明します。  
+  
+ [XML からの DataSet リレーショナル構造の推論](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/inferring-dataset-relational-structure-from-xml.md)  
+ XML 要素から推論する際に作成される <xref:System.Data.DataSet> のリレーショナル構造 \(スキーマ\) について説明します。  
+  
+## 関連項目  
+ [ADO.NET の概要](../../../../../docs/framework/data/adonet/ado-net-overview.md)  
+ ADO.NET のアーキテクチャとコンポーネントについて説明し、それらを使用して既存のデータ ソースにアクセスしたり、アプリケーション データを管理したりする方法を示します。  
+  
+## 参照  
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/viewing-data-in-a-datatable.md b/docs/framework/data/adonet/dataset-datatable-dataview/viewing-data-in-a-datatable.md
new file mode 100644
index 00000000000..719c26e30eb
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/viewing-data-in-a-datatable.md
@@ -0,0 +1,122 @@
+---
+title: "DataTable 内のデータの表示 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d26e0fb-f6e0-4afa-9a9c-b8d55b8f20dc
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# DataTable 内のデータの表示
+<xref:System.Data.DataTable> の内容には、**DataTable** の **Rows** コレクションと **Columns** コレクションを使用してアクセスできます。  また、<xref:System.Data.DataTable.Select%2A> メソッドを使用すると、検索条件、並べ替え順序、行の状態などの基準に基づいて **DataTable** 内のデータのサブセットを返すことができます。  さらに、主キー値を使用して特定の行を検索するときは、**DataRowCollection** の <xref:System.Data.DataRowCollection.Find%2A> メソッドを使用できます。  
+  
+ **DataTable** オブジェクトの **Select** メソッドは、指定された基準と一致する <xref:System.Data.DataRow> オブジェクトのセットを返します。  **Select** は、フィルター式、並べ替え式、および **DataViewRowState** のオプション引数を受け取ります。  フィルター式は、**DataColumn** 値に基づいて返す行を識別する `LastName = 'Smith'` などの式です。  並べ替え式は、列の並べ替えについての標準 SQL 規則に基づく `LastName ASC, FirstName ASC` などの式です。  式の記述の規則については、**DataColumn** クラスの <xref:System.Data.DataColumn.Expression%2A> プロパティのトピックを参照してください。  
+  
+> [!TIP]
+>  **DataTable** の **Select** メソッドへの呼び出しを多数実行する場合は、最初に **DataTable** の <xref:System.Data.DataView> を作成することにより、パフォーマンスを向上させることができます。  **DataView** を作成すると、テーブルの行にインデックスが付けられます。  **Select** メソッドがこのインデックスを使用すると、クエリ結果を生成するまでの時間が大幅に減少します。  **DataTable** の **DataView** を作成する方法については、「[DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataviews.md)」を参照してください。  
+  
+ **Select** メソッドは、<xref:System.Data.DataViewRowState> に基づいて、表示または操作する行のバージョンを判断します。  有効な **DataViewRowState** 列挙値の説明を次の表に示します。  
+  
+|DataViewRowState の値|説明|  
+|-------------------------|--------|  
+|**CurrentRows**|変更されていない行、追加された行、および変更された行を含む現在の行。|  
+|**Deleted**|削除された行。|  
+|**ModifiedCurrent**|元のデータを変更した後のバージョンである、現在のバージョン。  **ModifiedOriginal** を参照してください。|  
+|**ModifiedOriginal**|変更されたすべての行の元のバージョン。  現在のバージョンは、**ModifiedCurrent**. を使用して取得できます。|  
+|**Added**|新しい行。|  
+|**なし**|なし。|  
+|**OriginalRows**|変更されていない行および削除された行を含む元の行。|  
+|**Unchanged**|変更されていない行。|  
+  
+ **DataSet** オブジェクトをフィルター処理して、**DataViewRowState** が **CurrentRows** に設定されている行だけを操作できるようにする例を次に示します。  
+  
+```vb  
+Dim column As DataColumn  
+Dim row As DataRow  
+  
+Dim currentRows() As DataRow = _  
+    workTable.Select(Nothing, Nothing, DataViewRowState.CurrentRows)  
+  
+If (currentRows.Length < 1 ) Then  
+  Console.WriteLine("No Current Rows Found")  
+Else  
+  For Each column in workTable.Columns  
+    Console.Write(vbTab & column.ColumnName)  
+  Next  
+  
+  Console.WriteLine(vbTab & "RowState")  
+  
+  For Each row In currentRows  
+    For Each column In workTable.Columns  
+      Console.Write(vbTab & row(column).ToString())  
+    Next  
+  
+    Dim rowState As String = _  
+        System.Enum.GetName(row.RowState.GetType(), row.RowState)  
+    Console.WriteLine(vbTab & rowState)  
+  Next  
+End If  
+  
+```  
+  
+```csharp  
+DataRow[] currentRows = workTable.Select(  
+    null, null, DataViewRowState.CurrentRows);  
+  
+if (currentRows.Length < 1 )  
+  Console.WriteLine("No Current Rows Found");  
+else  
+{  
+  foreach (DataColumn column in workTable.Columns)  
+    Console.Write("\t{0}", column.ColumnName);  
+  
+  Console.WriteLine("\tRowState");  
+  
+  foreach (DataRow row in currentRows)  
+  {  
+    foreach (DataColumn column in workTable.Columns)  
+      Console.Write("\t{0}", row[column]);  
+  
+    Console.WriteLine("\t" + row.RowState);  
+  }  
+}  
+```  
+  
+ **Select** メソッドを使用して、異なる **RowState** 値またはフィールド値を持つ行を返すこともできます。  削除されたすべての行を参照する **DataRow** 配列を返し、また、**CustLName** を基準にして並べ替えた **CustID** 列が 5 より大きいすべての行を参照する、別の **DataRow** 配列も返す例を次に示します。  **Deleted** 行の情報を表示する方法については、「[行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  
+  
+```vb  
+' Retrieve all deleted rows.  
+Dim deletedRows() As DataRow = workTable.Select(Nothing, Nothing, DataViewRowState.Deleted)  
+  
+' Retrieve rows where CustID > 5, and order by CustLName.  
+Dim custRows() As DataRow = workTable.Select( _  
+    "CustID > 5", "CustLName ASC")  
+  
+```  
+  
+```csharp  
+// Retrieve all deleted rows.  
+DataRow[] deletedRows = workTable.Select(  
+    null, null, DataViewRowState.Deleted);  
+  
+// Retrieve rows where CustID > 5, and order by CustLName.  
+DataRow[] custRows = workTable.Select("CustID > 5", "CustLName ASC");  
+```  
+  
+## 参照  
+ <xref:System.Data.DataRow>   
+ <xref:System.Data.DataSet>   
+ <xref:System.Data.DataTable>   
+ <xref:System.Data.DataViewRowState>   
+ [DataTable 内のデータの操作](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/manipulating-data-in-a-datatable.md)   
+ [行の状態とバージョン](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md b/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md
new file mode 100644
index 00000000000..293d7998378
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md
@@ -0,0 +1,89 @@
+---
+title: "DataSet 内容の XML データとしての書き込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd15f8a5-3b4c-46d0-a561-4559ab2a4705
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# DataSet 内容の XML データとしての書き込み
+ADO.NET での XML 表現を記述する、<xref:System.Data.DataSet>、またはスキーマなし。 XML にインラインで含まれているスキーマ情報は、XML スキーマ定義言語 (XSD) を使用して記述されています。 スキーマにはテーブルの定義が含まれています、<xref:System.Data.DataSet>リレーションシップと制約の定義とします。  
+  
+ ときに、<xref:System.Data.DataSet>内の行、XML データとして書き込まれる、<xref:System.Data.DataSet>が現在のバージョンで書き込まれます。 ただし、<xref:System.Data.DataSet>書き込むこともできますが DiffGram としてそう、現在と行の元の値の両方が含まれています。  
+  
+ XML 表現、<xref:System.Data.DataSet>ファイル、ストリームに書き込むことが、 **XmlWriter**、または文字列です。 これらの選択肢では、優れた柔軟性を提供の XML 表現の転送方法を<xref:System.Data.DataSet>します。 XML 表現を取得する、<xref:System.Data.DataSet>を文字列として使用して、 **GetXml**メソッドを次の例で示すようにします。  
+  
+```vb  
+Dim xmlDS As String = custDS.GetXml()  
+```  
+  
+```csharp  
+string xmlDS = custDS.GetXml();  
+```  
+  
+ **GetXml**の XML 表現を返す、<xref:System.Data.DataSet>スキーマ情報がない場合。 スキーマ情報を書き込むため、<xref:System.Data.DataSet>(XML スキーマ) として使用して、文字列に**GetXmlSchema**します。  
+  
+ 書き込む、<xref:System.Data.DataSet>、ファイル、ストリーム、または**XmlWriter**を使用して、 **WriteXml**メソッドです。 最初のパラメーターに渡す**WriteXml** XML の出力先であります。 たとえば、ファイル名を含む文字列を渡して、 **System.IO.TextWriter**オブジェクト、およびなどです。 省略可能な&2; 番目のパラメーターを渡すことができます、**から成る**XML 出力が書き込まれる方法を指定します。  
+  
+ 次の表に、オプションの**から成る**します。  
+  
+|XmlWriteMode のオプション|説明|  
+|-------------------------|-----------------|  
+|**IgnoreSchema**|現在の内容を書き込み、<xref:System.Data.DataSet>せず、XML スキーマの XML データとして。 既定値です。|  
+|**書き込むには**|現在の内容を書き込み、<xref:System.Data.DataSet>インライン XML スキーマとして、リレーショナル構造の XML データとして。|  
+|**DiffGram**|全体を書き込みます<xref:System.Data.DataSet>を DiffGram として元と現在の値を含みます。 詳細については、次を参照してください。 [Diffgram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)します。|  
+  
+ XML 表現を記述するとき、<xref:System.Data.DataSet>を含む**DataRelation**オブジェクトの場合、結果の XML を持つ、関連する親要素内で入れ子になった各リレーションシップの子の行にする可能性があります。 これを実現する次のように設定します。、**入れ子になった**のプロパティ、 **DataRelation**に**true**を追加すると、 **DataRelation**に、<xref:System.Data.DataSet>します。 詳細については、次を参照してください。 [Datarelation の入れ子](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)します。  
+  
+ XML 表現を記述する方法の&2; つの例を次に、<xref:System.Data.DataSet>ファイルにします。 最初の例では、xml ファイルの名前を渡しますに文字列として**WriteXml**します。 2 番目の例では、 **System.IO.StreamWriter**オブジェクトです。  
+  
+```vb  
+custDS.WriteXml("Customers.xml", XmlWriteMode.WriteSchema)  
+  
+```  
+  
+```csharp  
+custDS.WriteXml("Customers.xml", XmlWriteMode.WriteSchema);  
+  
+```  
+  
+```vb  
+Dim xmlSW As System.IO.StreamWriter = New System.IO.StreamWriter("Customers.xml")  
+custDS.WriteXml(xmlSW, XmlWriteMode.WriteSchema)  
+xmlSW.Close()  
+  
+```  
+  
+```csharp  
+System.IO.StreamWriter xmlSW = new System.IO.StreamWriter("Customers.xml");  
+custDS.WriteXml(xmlSW, XmlWriteMode.WriteSchema);  
+xmlSW.Close();  
+```  
+  
+## <a name="mapping-columns-to-xml-elements-attributes-and-text"></a>XML 要素、属性、およびテキストへの列の割り当て  
+ テーブルの列を XML で表現する方法を指定することができますを使用して、 **ColumnMapping**のプロパティ、 **DataColumn**オブジェクトです。 次の表に示します**MappingType**の値、 **ColumnMapping**テーブルの列と、結果の XML のプロパティです。  
+  
+|MappingType の値|説明|  
+|-----------------------|-----------------|  
+|**要素**|既定値です。 列が XML 要素として書き込まれます。このとき、ColumnName は要素名になり、列の内容は要素のテキストとして書き込まれます。 例:<br /><br /> `<ColumnName>Column Contents</ColumnName>`|  
+|**属性**|列が、現在の行の XML 要素の XML 属性として書き込まれます。このとき、ColumnName は属性名になり、列の内容は属性の値として書き込まれます。 例:<br /><br /> `<RowElement ColumnName="Column Contents" />`|  
+|**SimpleContent**|列の内容が、現在の行の XML 要素のテキストとして書き込まれます。 例:<br /><br /> `<RowElement>Column Contents</RowElement>`<br /><br /> なお**SimpleContent**を持つテーブルの列を設定できません**要素**列または入れ子になったリレーションです。|  
+|**非表示**|列は XML 出力に書き込まれません。|  
+  
+## <a name="see-also"></a>関連項目  
+ [データセットの XML を使用します。](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [Diffgram](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/diffgrams.md)   
+ [Datarelation の入れ子化](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/nesting-datarelations.md)   
+ [XSD としての DataSet スキーマ情報の書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-schema-information-as-xsd.md)   
+ [Dataset、Datatable、および Dataview](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-schema-information-as-xsd.md b/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-schema-information-as-xsd.md
new file mode 100644
index 00000000000..866965cc8cc
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-schema-information-as-xsd.md
@@ -0,0 +1,61 @@
+---
+title: "XSD としての DataSet スキーマ情報の書き込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e530831-695e-49ff-8f0b-e5b0c526b8eb
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XSD としての DataSet スキーマ情報の書き込み
+<xref:System.Data.DataSet> のスキーマを XML スキーマ定義言語 \(XSD\) スキーマとして書き込むと、このスキーマを XML ドキュメントに転送できます。このとき関連データを含む定義、または関連データを含まない定義ができます。  XML スキーマはファイル、ストリーム、<xref:System.Xml.XmlWriter>、または文字列に書き込むことができるため、厳密に型指定された **DataSet** を生成するときに役立ちます。  厳密に型指定された **DataSet** オブジェクトの詳細については、「[型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)」を参照してください。  
+  
+ テーブルの列を XML スキーマで表す方法を指定するには、<xref:System.Data.DataColumn> オブジェクトの **ColumnMapping** プロパティを使用します。  詳細については、「[DataSet 内容の XML データとしての書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)」の「XML 要素、属性、およびテキストへの列の割り当て」を参照してください。  
+  
+ **DataSet** スキーマを XML スキーマとしてファイル、ストリーム、または **XmlWriter** に書き込むには、**DataSet** の **WriteXmlSchema** メソッドを使用します。  **WriteXmlSchema** は、XML スキーマの書き込み先を指定するパラメーターを 1 つ受け取ります。  ファイル名を含んだ文字列と <xref:System.IO.StreamWriter> オブジェクトを渡して **DataSet** の XML スキーマをファイルに書き込む方法を示すコード サンプルを次に示します。  
+  
+```vb  
+dataSet.WriteXmlSchema("Customers.xsd")  
+```  
+  
+```csharp  
+dataSet.WriteXmlSchema("Customers.xsd");  
+```  
+  
+```vb  
+Dim writer As System.IO.StreamWriter = New System.IO.StreamWriter("Customers.xsd")  
+dataSet.WriteXmlSchema(writer)  
+writer.Close()  
+```  
+  
+```csharp  
+System.IO.StreamWriter writer = new System.IO.StreamWriter("Customers.xsd");  
+dataSet.WriteXmlSchema(writer);  
+writer.Close();  
+```  
+  
+ **DataSet** のスキーマを取得し、XML スキーマ文字列として書き込むには、次の例に示すように **GetXmlSchema** メソッドを使用します。  
+  
+```vb  
+Dim schemaString As String = dataSet.GetXmlSchema()  
+```  
+  
+```csharp  
+string schemaString = dataSet.GetXmlSchema();  
+```  
+  
+## 参照  
+ [DataSet での XML の使用](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)   
+ [DataSet 内容の XML データとしての書き込み](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)   
+ [型指定された DataSet](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-datatable-dataview/xml-schema-constraints-and-relationships.md b/docs/framework/data/adonet/dataset-datatable-dataview/xml-schema-constraints-and-relationships.md
new file mode 100644
index 00000000000..2345384c71a
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-datatable-dataview/xml-schema-constraints-and-relationships.md
@@ -0,0 +1,198 @@
+---
+title: "XML スキーマ制約およびリレーションシップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 165bc2bc-60a1-40e0-9b89-7c68ef979079
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# XML スキーマ制約およびリレーションシップ
+XML スキーマ定義言語 \(XSD\) スキーマでは、制約 \(UNIQUE、キー、キー参照\) およびリレーションシップ \(**msdata:Relationship** 注釈を使用した\) を指定できます。  このトピックでは、XML スキーマで指定した制約およびリレーションシップを解釈して <xref:System.Data.DataSet> を生成する方法について説明します。  
+  
+ 一般的に、XML スキーマでは **DataSet** にリレーションシップだけを生成する場合に、**msdata:Relationship** 注釈を指定します。  詳細については、「[XML スキーマ \(XSD\) からの DataSet リレーションの生成](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/generating-dataset-relations-from-xml-schema-xsd.md)」を参照してください。  **DataSet** に制約を生成する場合は、制約 \(UNIQUE、キー、およびキー参照\) を指定します。  このトピックの後に説明されているように、リレーションシップを生成するにはキー制約とキー参照制約も使用するので注意してください。  
+  
+## キー制約およびキー参照制約によるリレーションシップの生成  
+ **msdata:Relationship** 注釈を指定する代わりに、XML スキーマの割り当て処理時に使用するキー制約とキー参照制約を指定し、制約だけでなく、**DataSet** のリレーションシップも生成することができます。  ただし、**keyref** 要素で `msdata:ConstraintOnly="true"` を指定した場合、**DataSet** には制約だけが作成され、リレーションシップは生成されません。  
+  
+ 入れ子になっていない **Order** 要素と **OrderDetail** 要素を含む XML スキーマの例を次に示します。  スキーマでは、キー制約とキー参照制約も指定します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element name="OrderDetail">  
+       <xs:complexType>  
+         <xs:sequence>  
+           <xs:element name="OrderNo" type="xs:integer" />  
+           <xs:element name="ItemNo" type="xs:string" />  
+         </xs:sequence>  
+       </xs:complexType>  
+      </xs:element>  
+      <xs:element name="Order">  
+        <xs:complexType>  
+          <xs:sequence>  
+            <xs:element name="OrderNumber" type="xs:integer" />  
+            <xs:element name="EmpNumber" type="xs:integer" />  
+          </xs:sequence>  
+        </xs:complexType>  
+      </xs:element>  
+    </xs:choice>  
+  </xs:complexType>  
+  
+  <xs:key name="OrderNumberKey"  >  
+    <xs:selector xpath=".//Order" />  
+    <xs:field xpath="OrderNumber" />  
+  </xs:key>  
+  
+  <xs:keyref name="OrderNoRef" refer="OrderNumberKey">  
+    <xs:selector xpath=".//OrderDetail" />  
+    <xs:field xpath="OrderNo" />  
+  </xs:keyref>  
+ </xs:element>  
+</xs:schema>  
+```  
+  
+ XML スキーマの割り当て処理時に生成される **DataSet** には、**Order** テーブルと **OrderDetail** テーブルが含まれます。  さらに、**DataSet** にはリレーションシップと制約も含まれます。  そのリレーションシップと制約の例を次に示します。  スキーマでは、**msdata:Relationship** 注釈が指定されないことに注意してください。代わりに、キー制約とキー参照制約を使用してリレーションを生成します。  
+  
+```  
+....ConstraintName: OrderNumberKey  
+....Type: UniqueConstraint  
+....Table: Order  
+....Columns: OrderNumber  
+....IsPrimaryKey: False  
+  
+....ConstraintName: OrderNoRef  
+....Type: ForeignKeyConstraint  
+....Table: OrderDetail  
+....Columns: OrderNo  
+....RelatedTable: Order  
+....RelatedColumns: OrderNumber  
+  
+..RelationName: OrderNoRef  
+..ParentTable: Order  
+..ParentColumns: OrderNumber  
+..ChildTable: OrderDetail  
+..ChildColumns: OrderNo  
+..ParentKeyConstraint: OrderNumberKey  
+..ChildKeyConstraint: OrderNoRef  
+..Nested: False  
+```  
+  
+ 上記のスキーマの例では、**Order** 要素と **OrderDetail** 要素は入れ子になっていません。  入れ子になっている **Order** 要素と **OrderDetail** 要素を含むスキーマの例を次に示します。  ただし、**msdata:Relationship** 注釈が指定されていないため、暗黙のリレーションが適用されます。  詳細については、「[入れ子になっているスキーマ要素間の暗黙的なリレーションの割り当て](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/map-implicit-relations-between-nested-schema-elements.md)」を参照してください。  スキーマでは、キー制約とキー参照制約も指定します。  
+  
+```  
+<xs:schema id="MyDataSet" xmlns=""   
+            xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+            xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
+  
+ <xs:element name="MyDataSet" msdata:IsDataSet="true">  
+  <xs:complexType>  
+    <xs:choice maxOccurs="unbounded">  
+  
+      <xs:element name="Order">  
+        <xs:complexType>  
+          <xs:sequence>  
+            <xs:element name="OrderNumber" type="xs:integer" />  
+            <xs:element name="EmpNumber" type="xs:integer" />  
+  
+            <xs:element name="OrderDetail">  
+              <xs:complexType>  
+                <xs:sequence>  
+                  <xs:element name="OrderNo" type="xs:integer" />  
+                  <xs:element name="ItemNo" type="xs:string" />  
+                </xs:sequence>  
+              </xs:complexType>  
+            </xs:element>  
+          </xs:sequence>  
+        </xs:complexType>  
+      </xs:element>  
+    </xs:choice>  
+  </xs:complexType>  
+  
+  <xs:key name="OrderNumberKey"  >  
+    <xs:selector xpath=".//Order" />  
+    <xs:field xpath="OrderNumber" />  
+  </xs:key>  
+  
+  <xs:keyref name="OrderNoRef" refer="OrderNumberKey">  
+    <xs:selector xpath=".//OrderDetail" />  
+    <xs:field xpath="OrderNo" />  
+  </xs:keyref>  
+ </xs:element>  
+</xs:schema>  
+```  
+  
+ XML スキーマの割り当て処理によって生成された **DataSet** には、次の 2 つのテーブルが含まれます。  
+  
+```  
+Order(OrderNumber, EmpNumber, Order_Id)  
+OrderDetail(OrderNumber, ItemNumber, Order_Id)  
+```  
+  
+ さらに、**DataSet** には 2 つのリレーションシップ \(1 つは **msdata:relationship** 注釈に基づいた、もう 1 つはキー制約とキー参照制約に基づいた\) およびさまざまな制約も含まれます。  リレーションおよび制約の例を次に示します。  
+  
+```  
+..RelationName: Order_OrderDetail  
+..ParentTable: Order  
+..ParentColumns: Order_Id  
+..ChildTable: OrderDetail  
+..ChildColumns: Order_Id  
+..ParentKeyConstraint: Constraint1  
+..ChildKeyConstraint: Order_OrderDetail  
+..Nested: True  
+  
+..RelationName: OrderNoRef  
+..ParentTable: Order  
+..ParentColumns: OrderNumber  
+..ChildTable: OrderDetail  
+..ChildColumns: OrderNo  
+..ParentKeyConstraint: OrderNumberKey  
+..ChildKeyConstraint: OrderNoRef  
+..Nested: False  
+  
+..ConstraintName: OrderNumberKey  
+..Type: UniqueConstraint  
+..Table: Order  
+..Columns: OrderNumber  
+..IsPrimaryKey: False  
+  
+..ConstraintName: Constraint1  
+..Type: UniqueConstraint  
+..Table: Order  
+..Columns: Order_Id  
+..IsPrimaryKey: True  
+  
+..ConstraintName: Order_OrderDetail  
+..Type: ForeignKeyConstraint  
+..Table: OrderDetail  
+..Columns: Order_Id  
+..RelatedTable: Order  
+..RelatedColumns: Order_Id  
+  
+..ConstraintName: OrderNoRef  
+..Type: ForeignKeyConstraint  
+..Table: OrderDetail  
+..Columns: OrderNo  
+..RelatedTable: Order  
+..RelatedColumns: OrderNumber  
+```  
+  
+ 入れ子になっているテーブルを参照するキー参照制約に **msdata:IsNested\="true"** 注釈が含まれている場合は、そのキー参照制約と関連する UNIQUE\/ キー制約に基づいて、1 つの入れ子になったリレーションシップが作成されます。  
+  
+## 参照  
+ [XML スキーマ \(XSD\) からの DataSet リレーショナル構造の派生](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/deriving-dataset-relational-structure-from-xml-schema-xsd.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md b/docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md
new file mode 100644
index 00000000000..da69b139cc9
--- /dev/null
+++ b/docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md
@@ -0,0 +1,54 @@
+---
+title: "DataSet-Specific Operator Examples (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8fdd64af-6ad0-46cd-91c8-dbe26620eeb1
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# DataSet-Specific Operator Examples (LINQ to DataSet)
+このトピックでは、<xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドおよび <xref:System.Data.DataRowComparer> クラスの使用例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## CopyToDataTable  
+  
+### 例  
+ この例では、<xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドを使用して、<xref:System.Data.DataTable> にクエリ結果を読み込みます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#LoadDataTableWithQueryResults](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#loaddatatablewithqueryresults)]
+ [!code-vb[DP LINQ to DataSet Examples#LoadDataTableWithQueryResults](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#loaddatatablewithqueryresults)]  
+  
+```  
+  
+```  
+  
+## DataRowComparer  
+  
+### 例  
+ この例では 2 つの異なるデータ行を <xref:System.Data.DataRowComparer> を使用して比較します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CompareDifferentDataRows](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#comparedifferentdatarows)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dataview-performance.md b/docs/framework/data/adonet/dataview-performance.md
new file mode 100644
index 00000000000..395ac81324f
--- /dev/null
+++ b/docs/framework/data/adonet/dataview-performance.md
@@ -0,0 +1,94 @@
+---
+title: "DataView Performance | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 90820e49-9d46-41f6-9a3d-6c0741bbd8eb
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# DataView Performance
+このトピックでは、<xref:System.Data.DataView> クラスの <xref:System.Data.DataView.Find%2A> メソッドと <xref:System.Data.DataView.FindRows%2A> メソッドを使用すること、および、Web アプリケーションで <xref:System.Data.DataView> をキャッシュすることのパフォーマンス上の利点について説明します。  
+  
+## Find と FindRows  
+ <xref:System.Data.DataView> はインデックスを構築します。  インデックスには、テーブル内またはビュー内の 1 つ以上の列から構築されたキーが含まれています。  これらのキーは特定の構造内に格納され、<xref:System.Data.DataView> はその構造を使用して、キー値に関連した 1 つ以上の行を効率よく迅速に検出できます。  フィルター処理や並べ替えなど、インデックスを使用した操作では、大幅なパフォーマンス向上が期待できます。  <xref:System.Data.DataView> のインデックスは、<xref:System.Data.DataView> の作成時に構築されるほか、並べ替えまたはフィルター処理の情報が変更されたときにも構築されます。  <xref:System.Data.DataView> を作成した後で、並べ替えまたはフィルター処理の情報を設定した場合、インデックスが最低でも 2 回 \(<xref:System.Data.DataView> の作成時と、並べ替えまたはフィルターのプロパティの変更時\) 構築されることになります。  <xref:System.Data.DataView> でのフィルターおよび並べ替えの詳細については、「[Filtering with DataView](../../../../docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md)」および「[Sorting with DataView](../../../../docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md)」を参照してください。  
+  
+ データ サブセットの動的ビューの作成とは対照的に、データに対する特定のクエリの結果を取得する場合は、<xref:System.Data.DataView.RowFilter%2A> プロパティを設定する代わりに <xref:System.Data.DataView> の <xref:System.Data.DataView.Find%2A> メソッドまたは <xref:System.Data.DataView.FindRows%2A> メソッドを使用します。  <xref:System.Data.DataView.RowFilter%2A> プロパティは、データ連結アプリケーションでの使用に適しています。このアプリケーションでは、連結されたコントロールによってフィルター処理結果が表示されます。  <xref:System.Data.DataView.RowFilter%2A> プロパティを設定すると、データのインデックスが再構築され、アプリケーションのオーバーヘッドが増加してパフォーマンスの低下を招きます。  <xref:System.Data.DataView.Find%2A> メソッドと <xref:System.Data.DataView.FindRows%2A> メソッドでは、現在のインデックスが使用されます。このため、インデックスを再構築する必要はありません。  <xref:System.Data.DataView.Find%2A> または <xref:System.Data.DataView.FindRows%2A> を 1 回だけ呼び出す場合は、既存の <xref:System.Data.DataView> を使用するようにします。  <xref:System.Data.DataView.Find%2A> または <xref:System.Data.DataView.FindRows%2A> を複数回呼び出す場合は、新しい <xref:System.Data.DataView> を作成して検索対象の列のインデックスを再構築した後、<xref:System.Data.DataView.Find%2A> メソッドまたは <xref:System.Data.DataView.FindRows%2A> メソッドを呼び出します。  <xref:System.Data.DataView.Find%2A> メソッドおよび <xref:System.Data.DataView.FindRows%2A> メソッドの詳細については、「[行の検索](../../../../docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md)」を参照してください。  
+  
+ 次の例では、<xref:System.Data.DataView.Find%2A> メソッドを使用して、姓が "Zhu" である連絡先を検索します。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryOrderByFind](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromqueryorderbyfind)]
+ [!code-vb[DP DataView Samples#LDVFromQueryOrderByFind](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromqueryorderbyfind)]  
+  
+ 次の例では、<xref:System.Data.DataView.FindRows%2A> メソッドを使用して、赤色の製品をすべて検索します。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryFindRows](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromqueryfindrows)]
+ [!code-vb[DP DataView Samples#LDVFromQueryFindRows](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromqueryfindrows)]  
+  
+## ASP.NET  
+ ASP.NET は、メモリ内に作成するときにサーバー リソースを激しく消費するオブジェクトを保存するためのキャッシュ メカニズムを備えています。  こうしたリソースをキャッシュすることで、アプリケーションのパフォーマンスを大幅に向上させることができます。  キャッシュは、<xref:System.Web.Caching.Cache> クラスに実装されています。キャッシュ インスタンスは、アプリケーションごとにプライベートに保たれます。  新しい <xref:System.Data.DataView> オブジェクトの作成はリソースを大量に消費する処理です。Web アプリケーションにこのキャッシュ機能を使用すれば、Web ページが更新されるたびに <xref:System.Data.DataView> を再構築する必要はありません。  
+  
+ 次の例では、ページが更新されたときにデータの並べ替えをし直さなくても済むように、<xref:System.Data.DataView> をキャッシュしています。  
+  
+```vb  
+If (Cache("ordersView") = Nothing) Then  
+  
+Dim dataSet As New DataSet()  
+  
+   FillDataSet(dataSet)  
+  
+   Dim orders As DataTable = dataSet.Tables("SalesOrderHeader")  
+  
+   Dim query = _  
+                    From order In orders.AsEnumerable() _  
+                    Where order.Field(Of Boolean)("OnlineOrderFlag") = True _  
+                    Order By order.Field(Of Decimal)("TotalDue") _  
+                    Select order  
+  
+   Dim view As DataView = query.AsDataView()  
+  
+   Cache.Insert("ordersView", view)  
+  
+End If  
+  
+Dim ordersView = CType(Cache("ordersView"), DataView)  
+  
+GridView1.DataSource = ordersView  
+GridView1.DataBind()  
+```  
+  
+```csharp  
+if (Cache["ordersView"] == null)  
+{  
+   // Fill the DataSet.                  
+   DataSet dataSet = FillDataSet();  
+  
+   DataTable orders = dataSet.Tables["SalesOrderHeader"];  
+  
+   EnumerableRowCollection<DataRow> query =  
+                        from order in orders.AsEnumerable()  
+                        where order.Field<bool>("OnlineOrderFlag") == true  
+                        orderby order.Field<decimal>("TotalDue")  
+                        select order;  
+  
+   DataView view = query.AsDataView();  
+   Cache.Insert("ordersView", view);  
+}  
+  
+DataView ordersView = (DataView)Cache["ordersView"];  
+  
+GridView1.DataSource = ordersView;  
+GridView1.DataBind();  
+```  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md b/docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md
new file mode 100644
index 00000000000..946f8d750ac
--- /dev/null
+++ b/docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md
@@ -0,0 +1,74 @@
+---
+title: "DbConnection、DbCommand、および DbException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58aab611-7e6f-4749-b983-28ab7ae87dbe
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DbConnection、DbCommand、および DbException
+<xref:System.Data.Common.DbProviderFactory> および <xref:System.Data.Common.DbConnection> を作成すると、コマンドおよびデータ リーダーを使用してデータ ソースからデータを取得できます。  
+  
+## データの取得例  
+ 次のコード例は、`DbConnection` オブジェクトを引数として受け取ります。  <xref:System.Data.Common.DbCommand.CommandText%2A> に SQL SELECT ステートメントを設定することによって、Categories テーブルからデータを検索するための <xref:System.Data.Common.DbCommand> を作成します。  このコードを実行するには、データ ソースに Categories テーブルが存在する必要があります。  接続を開いた後、<xref:System.Data.Common.DbDataReader> を使用してデータが取得されます。  
+  
+ [!code-csharp[DataWorks DbProviderFactories.DbCommandData#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbCommandData/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories.DbCommandData#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbCommandData/VB/source.vb#1)]  
+  
+## コマンド実行例  
+ 次のコード例は、`DbConnection` オブジェクトを引数として受け取ります。  `DbConnection` が有効である場合、接続が開かれ、<xref:System.Data.Common.DbCommand> が作成されて実行されます。  <xref:System.Data.Common.DbCommand.CommandText%2A> には、Northwind データベースの Categories テーブルへの挿入操作を実行する SQL INSERT ステートメントが設定されています。  このコードを実行するには、データ ソースに Northwind データベースが存在すること、および、指定されたプロバイダーの有効な SQL 構文が INSERT ステートメントに使用されていることが必要です。  データ ソースで発生したエラーは <xref:System.Data.Common.DbException> コード ブロックで処理され、それ以外のすべての例外は <xref:System.Exception> ブロックで処理されます。  
+  
+ [!code-csharp[DataWorks DbProviderFactories.DbCommand#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbCommand/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories.DbCommand#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbCommand/VB/source.vb#1)]  
+  
+## DbException でのデータ エラーの処理  
+ <xref:System.Data.Common.DbException> クラスは、データ ソースでスローされるすべての例外の基本クラスです。  このクラスを例外処理コードに使用することで、プロバイダーに固有の例外クラスを参照することなく、各種のプロバイダーによってスローされる例外を処理できます。  次のコード フラグメントでは、<xref:System.Data.Common.DbException> の各プロパティ \(<xref:System.Exception.GetType%2A>、<xref:System.Exception.Source%2A>、<xref:System.Runtime.InteropServices.ExternalException.ErrorCode%2A>、および <xref:System.Exception.Message%2A>\) を使って、データ ソースから返されたエラー情報を表示しています。  出力結果には、エラーの種類、エラーの発生元 \(プロバイダー名\)、エラー コード、および、エラーに関連付けられたメッセージが表示されます。  
+  
+```vb  
+Try  
+    ' Do work here.  
+Catch ex As DbException  
+    ' Display information about the exception.  
+    Console.WriteLine("GetType: {0}", ex.GetType())  
+    Console.WriteLine("Source: {0}", ex.Source)  
+    Console.WriteLine("ErrorCode: {0}", ex.ErrorCode)  
+    Console.WriteLine("Message: {0}", ex.Message)  
+Finally  
+    ' Perform cleanup here.  
+End Try  
+```  
+  
+```csharp  
+try  
+{  
+    // Do work here.  
+}  
+catch (DbException ex)  
+{  
+    // Display information about the exception.  
+    Console.WriteLine("GetType: {0}", ex.GetType());  
+    Console.WriteLine("Source: {0}", ex.Source);  
+    Console.WriteLine("ErrorCode: {0}", ex.ErrorCode);  
+    Console.WriteLine("Message: {0}", ex.Message);  
+}  
+finally  
+{  
+    // Perform cleanup here.  
+}  
+```  
+  
+## 参照  
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)   
+ [DbProviderFactory の取得](../../../../docs/framework/data/adonet/obtaining-a-dbproviderfactory.md)   
+ [DbDataAdapter を使用したデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/dbproviderfactories.md b/docs/framework/data/adonet/dbproviderfactories.md
new file mode 100644
index 00000000000..64b1dfe353d
--- /dev/null
+++ b/docs/framework/data/adonet/dbproviderfactories.md
@@ -0,0 +1,39 @@
+---
+title: "DbProviderFactories | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2a8e2640-3a49-42a1-a3a9-b43026907ae1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DbProviderFactories
+<xref:System.Data.Common> 名前空間には、特定のデータ ソースを使用するための <xref:System.Data.Common.DbProviderFactory> インスタンスを作成するクラスが用意されています。  <xref:System.Data.Common.DbProviderFactory> インスタンスを作成し、データ プロバイダーに関する情報をそのインスタンスに渡すと、`DbProviderFactory` はあらかじめ提供された情報に基づいて厳密に型指定された正しいオブジェクトを判断して返すことができます。  
+  
+ .NET Framework バージョン 4 以降では、<xref:System.Data.Odbc>、<xref:System.Data.OleDb>、<xref:System.Data.SqlClient>、および <xref:System.Data.OracleClient> などのデータ プロバイダーは machine.config ファイルに表示されなくなりますが、カスタム プロバイダーは表示されます。  
+  
+## このセクションの内容  
+ [ファクトリ モデルの概要](../../../../docs/framework/data/adonet/factory-model-overview.md)  
+ ファクトリ デザイン パターンとプログラミング インターフェイスの概要を説明します。  
+  
+ [DbProviderFactory の取得](../../../../docs/framework/data/adonet/obtaining-a-dbproviderfactory.md)  
+ インストールされているデータ プロバイダーの一覧を取得したり、`DbProviderFactory` から <xref:System.Data.Common.DbConnection> を作成したりする方法について説明します。  
+  
+ [DbConnection、DbCommand、および DbException](../../../../docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md)  
+ <xref:System.Data.Common.DbCommand> と <xref:System.Data.Common.DbDataReader> の作成方法のほか、<xref:System.Data.Common.DbException> を使ったデータ エラーの処理方法について説明します。  
+  
+ [DbDataAdapter を使用したデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md)  
+ <xref:System.Data.Common.DbDataAdapter> と <xref:System.Data.Common.DbCommandBuilder> を使用して、データを取得したり変更したりする方法について説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/debugging-linq-to-dataset-queries.md b/docs/framework/data/adonet/debugging-linq-to-dataset-queries.md
new file mode 100644
index 00000000000..efc339a7b89
--- /dev/null
+++ b/docs/framework/data/adonet/debugging-linq-to-dataset-queries.md
@@ -0,0 +1,38 @@
+---
+title: "Debugging LINQ to DataSet Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4c54015-8ce2-4c5c-8d18-7038144cc66d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Debugging LINQ to DataSet Queries
+[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] は、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] コードのデバッグをサポートしています。  ただし、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] コードのデバッグと [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 以外のマネージ コードのデバッグとでは若干違いがあります。ステップ実行、ブレークポイントの設定、デバッガー ウィンドウでの結果の確認など、ほとんどのデバッグ機能は [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] ステートメントでも使用できます。  ただし、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] コードをデバッグする際は、クエリの遅延実行によって生じる副作用を考慮する必要があります。また、エディット コンティニュにも使用上の制限がいくつかあります。  このトピックでは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] でデバッグを行う場合に固有の事項について、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 以外のマネージ コードと比較しつつ説明します。  
+  
+## 結果の表示  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] ステートメントの結果は、データヒント、\[ウォッチ\] ウィンドウ、\[クイック ウォッチ\] ダイアログ ボックスを使用して確認できます。  ソース ウィンドウで特定のクエリにポインターを置くと、データヒントが表示されます。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] の変数をコピーし、それを \[ウォッチ\] ウィンドウまたは \[クイック ウォッチ\] ダイアログ ボックスに貼り付けることができます。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、クエリが評価されるのは、作成したときでも宣言したときでもなく、実際にそのクエリが実行されたときです。  これを*遅延実行*といいます。  したがって、それが評価されるまでは、クエリ変数に値は割り当てられません。  詳細については、「[Queries in LINQ to DataSet](../../../../docs/framework/data/adonet/queries-in-linq-to-dataset.md)」を参照してください。  
+  
+ デバッガーは、クエリの結果を表示するために、そのクエリを評価する必要があります。  この暗黙的な評価は、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のクエリ結果をデバッガーで表示したときに実行されます。この点には、考慮する必要のあるいくつかの影響があります。  クエリの評価には時間がかかります。  結果ノードを展開するときにも時間を要します。  クエリによっては繰り返し評価が実行され、パフォーマンスが著しく低下する場合があります。  さらに、データの値またはプログラムの状態が変わるという副作用が伴う場合もあります。  すべてのクエリに副作用があるわけではありません。  副作用を伴うことなく安全にクエリを評価できるかどうかを判断するには、クエリが実装されているコードを十分に理解する必要があります。  詳細については、「[副作用と式](../Topic/Side%20Effects%20and%20Expressions.md)」を参照してください。  
+  
+## エディット コンティニュ  
+ エディット コンティニュは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリに対する変更をサポートしません。  デバッグ セッション中に [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] ステートメントを追加、削除、または変更しようとした場合、エディット コンティニュでサポートされない変更であることを伝えるダイアログ ボックスが表示されます。  このとき、変更を元に戻すか、デバッグ セッションを中止して編集済みのコードで新たなセッションを開始するかを選択できます。  
+  
+ また、エディット コンティニュでは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] ステートメントで使用されている変数の型または値を変更することはできません。  この場合も、変更を元に戻すか、デバッグ セッションを中止して新たなセッションを開始するかを選択できます。  
+  
+ Visual Studio の Visual C\# では、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリを含んだメソッドのコードに対して、エディット コンティニュを使用することはできません。  
+  
+ Visual Studio の Visual Basic では、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリを含んだメソッドであっても、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 以外のコードであればエディット コンティニュを使用できます。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] ステートメントの前にコードを追加したり削除したりすることもできます。その変更によって [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリの行番号に影響が生じる場合でも可能です。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 以外のコードの Visual Basic デバッグは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] が導入される前と同じように動作します。  ただし、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリの変更、追加、または削除を行う場合は、デバッグを停止してから変更を適用する必要があります。  
+  
+## 参照  
+ [マネージ コードのデバッグ](../Topic/Debugging%20Managed%20Code.md)   
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/distributed-transactions.md b/docs/framework/data/adonet/distributed-transactions.md
new file mode 100644
index 00000000000..b4fd9f9708f
--- /dev/null
+++ b/docs/framework/data/adonet/distributed-transactions.md
@@ -0,0 +1,60 @@
+---
+title: "分散トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 718b257c-bcb2-408e-b004-a7b0adb1c176
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# 分散トランザクション
+トランザクションとは、たとえば、1 つの単位として成功 \(コミット\) または失敗 \(アボート\) する関連タスク セットです。  *分散トランザクション*は、複数のリソースに影響するトランザクションです。  分散トランザクションがコミットされるためには、すべての参加要素が、すべてのデータ変更が永久的な変更となることを保証する必要があります。  システム クラッシュその他の予期しない出来事が発生した場合でも、変更は保持されます。  1 つの参加要素がこの保証に失敗しただけでも、トランザクション全体が失敗し、トランザクションのスコープ内のデータに対する変更がロールバックされます。  
+  
+> [!NOTE]
+>  トランザクションがアクティブであるときに `DataReader` が開始された場合、トランザクションをコミットまたはロールバックしようとすると例外がスローされます。  
+  
+## System.Transactions の操作  
+ .NET Framework では、分散トランザクションは <xref:System.Transactions> 名前空間内の API を介して管理されます。  複数の永続的なリソース マネージャーが関係する場合、<xref:System.Transactions> API は分散トランザクション処理を Microsoft Distributed Transaction Coordinator \(MS DTC\) などのトランザクション モニターに委任します。  詳細については、「[Transaction Fundamentals](http://msdn.microsoft.com/ja-jp/2a476b63-b94f-443f-992d-53943fdf4e5d)」を参照してください。  
+  
+ ADO.NET 2.0 では、`EnlistTransaction` メソッドを使用した分散トランザクションへの参加のサポートが導入されました。これにより、接続を <xref:System.Transactions.Transaction> インスタンスに参加させることができます。  ADO.NET の以前のバージョンでは、分散トランザクションへの明示的な参加は、接続の `EnlistDistributedTransaction` メソッドを使用して実行されていました。これによって <xref:System.EnterpriseServices.ITransaction> インスタンス内の接続を参加させることで、下位互換性を得ることができます。  Enterprise Services トランザクションの詳細については、「[Interoperability with Enterprise Services and COM\+ Transactions](http://msdn.microsoft.com/ja-jp/2e93b3c6-4d48-4b9b-82b2-7d5908a2c970)」を参照してください。  
+  
+ .NET Framework Provider for SQL Server で SQL Server データベースに対して <xref:System.Transactions> トランザクションを使用する場合は、軽量な <xref:System.Transactions.Transaction> が自動的に使用されます。  トランザクションは、必要に応じて完全な分散トランザクションに昇格させることができます。  詳細については、「[SQL Server と System.Transactions の統合](../../../../docs/framework/data/adonet/system-transactions-integration-with-sql-server.md)」を参照してください。  
+  
+> [!NOTE]
+>  既定では、1 つの Oracle データベースが一度に参加できる分散トランザクションの最大数は 10 に設定されています。  Oracle データベースに接続している場合、トランザクション数が 10 個を超えると例外がスローされます。  Oracle では、分散トランザクション内での `DDL` はサポートされません。  
+  
+## 分散トランザクションへの自動参加  
+ 自動参加は、ADO.NET 接続を `System.Transactions` に統合する場合の既定の \(推奨される\) 方法です。  接続オブジェクトは、トランザクションがアクティブであると判定されると、既存の分散トランザクションに自動的に参加します。トランザクションがアクティブであることは、`System.Transaction` から見ると、`Transaction.Current` が null でないことを意味します。  自動トランザクション参加は、接続が開かれた場合に行われます。  その後は、コマンドがトランザクションのスコープ内で実行された場合でも、自動トランザクション参加は行われません。  <xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A?displayProperty=fullName> の接続文字列パラメーターとして `Enlist=false` を指定するか、<xref:System.Data.OleDb.OleDbConnection.ConnectionString%2A?displayProperty=fullName> の接続文字パラメーターとして `OLE DB Services=-7` を指定すると、既存のトランザクションへの自動参加を無効にできます。  Oracle および ODBC 接続文字列パラメーターの詳細については、「<xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A?displayProperty=fullName>」および「<xref:System.Data.Odbc.OdbcConnection.ConnectionString%2A?displayProperty=fullName>」を参照してください。  
+  
+## 手動による分散トランザクションへの参加  
+ 自動参加が無効になっている場合、または接続が開いた後に開始したトランザクションに参加する必要がある場合は、使用中のプロバイダーの <xref:System.Data.Common.DbConnection> オブジェクトの `EnlistTransaction` メソッドを使用して、既存の分散トランザクションに参加できます。  既存の分散トランザクションに参加すると、トランザクションがコミットまたはロールバックされた場合、データ ソースに対してコードで行った変更もコミットまたはロールバックされます。  
+  
+ 分散トランザクションへの参加は、特にビジネス オブジェクトをプールする場合に適切です。  ビジネス オブジェクトが、開かれている接続と共にプールされている場合は、その接続を開くときだけ、自動トランザクション参加が行われます。  プールされているビジネス オブジェクトを使用して複数のトランザクションが実行される場合、そのオブジェクトの開かれている接続は、新しく開始されるトランザクションには自動参加しません。  この場合には、接続の自動トランザクション参加を無効にし、`EnlistTransaction` を使用して、接続をトランザクションに参加させることができます。  
+  
+ `EnlistTransaction`  は、既存のトランザクションを参照する <xref:System.Transactions.Transaction> 型の引数を 1 つ受け取ります。  接続の `EnlistTransaction` メソッドを呼び出した後、接続を使用してデータ ソースに対して行ったすべての変更は、トランザクションに組み込まれます。  null 値を渡すことで、現在の分散トランザクションから接続の参加が解除されます。  この接続は、`EnlistTransaction` を呼び出す前に開く必要があることに注意してください。  
+  
+> [!NOTE]
+>  一度接続を明示的にトランザクションに参加させると、最初のトランザクションが終了するまでは、参加を解除したり別のトランザクションに参加させたりすることはできません。  
+  
+> [!CAUTION]
+>  接続の <xref:System.Data.Common.DbConnection.BeginTransaction%2A> メソッドを使用してトランザクションが既に開始していた場合、`EnlistTransaction` は例外をスローします。  ただし、トランザクションがデータ ソースで開始されたローカル トランザクションである場合 \(たとえば <xref:System.Data.SqlClient.SqlCommand> を使用して BEGIN TRANSACTION ステートメントを明示的に実行した場合\)、`EnlistTransaction` はローカル トランザクションをロールバックし、要求されたように既存の分散トランザクションに参加します。  ローカル トランザクションがロールバックされたことは通知されないため、<xref:System.Data.Common.DbConnection.BeginTransaction%2A> を使用して開始したのではないローカル トランザクションについては、自分で管理する必要があります。  .NET Framework Data Provider for SQL Server \(`SqlClient`\) を SQL Server で使用する場合は、参加を試みると例外がスローされます。  その他の場合については検出されません。  
+  
+## SQL Server の昇格可能なトランザクション  
+ SQL Server は、軽量のローカル トランザクションを必要に応じて分散トランザクションに自動的に昇格できる、昇格可能なトランザクションをサポートしています。  昇格可能なトランザクションは、必要な場合以外、分散トランザクションのオーバーヘッドの増加を引き起こすことはありません。  詳細とコード サンプルについては、「[SQL Server と System.Transactions の統合](../../../../docs/framework/data/adonet/system-transactions-integration-with-sql-server.md)」を参照してください。  
+  
+## 分散トランザクションの設定  
+ 分散トランザクションを使用するには、ネットワーク上の MS DTC を有効にする必要があります。  Windows ファイアウォールを有効にしている場合は、MS DTC サービスでネットワークを使用するか MS DTC ポートを開くことができるようにする必要があります。  
+  
+## 参照  
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [SQL Server と System.Transactions の統合](../../../../docs/framework/data/adonet/system-transactions-integration-with-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/downloading-sample-databases-linq-to-dataset.md b/docs/framework/data/adonet/downloading-sample-databases-linq-to-dataset.md
new file mode 100644
index 00000000000..6f4dfe00d15
--- /dev/null
+++ b/docs/framework/data/adonet/downloading-sample-databases-linq-to-dataset.md
@@ -0,0 +1,84 @@
+---
+title: "Downloading Sample Databases (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eb42a7af-d410-4b7f-b4a8-13c72ce6fd09
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Downloading Sample Databases (LINQ to DataSet)
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のドキュメントで取り上げられているサンプルおよびチュートリアルでは、AdventureWorks サンプル データベースが使用されています。  この製品は、Microsoft のダウンロード サイトから無償でダウンロードできます。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のドキュメントに記載されているサンプルおよびチュートリアルでは、データ ストアとして SQL Server が使用されています。  SQL Server の代わりに、無償で提供されている SQL Server Express Edition をデータ ストアとして使用することもできます。  
+  
+## AdventureWorks データベースのダウンロードとインストール  
+  
+#### SQL Server の AdventureWorks サンプル データベースをダウンロードおよびインストールするには  
+  
+1.  Internet Explorer を開きます。  
+  
+2.  「[SQL Server 2005 サンプルとサンプル データベース](http://go.microsoft.com/fwlink/?linkid=31046)」の Web サイトに移動します。  
+  
+3.  記載されている手順に従ってプロセッサの種類に応じた AdventureWorks サンプル データベース \(AdventureWorksDB.msi など\) をダウンロードし、.MSI ファイルをローカル コンピューターに保存します。  
+  
+4.  以前のバージョンの AdventureWorks は、単体でダウンロードしたか SQL Server のセットアップ時にインストールしたかに関係なく、AdventureWorks.msi の実行前に削除しておく必要があります。  
+  
+#### 単体でダウンロードした以前のバージョンの AdventureWorks サンプル データベースを削除するには  
+  
+1.  AdventureWorks データベースまたは AdventureWorksDW データベースを削除します。  
+  
+2.  **\[プログラムの追加と削除\]** で **\[AdventureWorksDB\]** または **\[AdventureWorksBI\]** を選択し、**\[削除\]** をクリックします。  
+  
+#### 過去にセットアップ プログラムを使用してインストールした AdventureWorks サンプル データベースを削除するには  
+  
+1.  AdventureWorks データベースまたは AdventureWorksDW データベースを削除します。  
+  
+2.  **\[プログラムの追加と削除\]** で **\[Microsoft SQL Server 2005\]** を選択し、**\[変更\]** をクリックします。  
+  
+3.  **\[コンポーネントの選択\]** で **\[ワークステーション コンポーネント\]** を選択し、**\[次へ\]** をクリックします。  
+  
+4.  **\[Microsoft SQL Server インストール ウィザードへようこそ\]** で、**\[次へ\]** をクリックします。  
+  
+5.  **\[システム構成チェック\]** で、**\[次へ\]** をクリックします。  
+  
+6.  **\[インスタンスの変更または削除\]** で、**\[インストール済みコンポーネントの変更\]** をクリックします。  
+  
+7.  **\[機能の選択\]** をクリックし、**\[ドキュメント、サンプル、およびサンプル データベース\]** ノードを展開します。  
+  
+8.  **\[サンプル コードとアプリケーション\]** を選択します。  **\[サンプル データベース\]** を展開し、削除するサンプル データベースを選択して、**\[インストールしない\]** を選択します。  **\[次へ\]** をクリックします。  
+  
+9. **\[インストール\]** をクリックしてインストール ウィザードを完了します。  
+  
+#### AdventureWorks サンプル データベース ファイルを SQL Server のインスタンスにアタッチするには  
+  
+1.  サンプル データベースのインストーラー ファイルをダウンロードしたら、ダウンロードしたファイル \(**AdventureWorksDB.msi** など\) をダブルクリックして、データベースをインストールします。  既定では、データベースは c:\\Program Files\\Microsoft SQL Server\\MSSQL.1\\MSSQL\\Data にインストールされます。  
+  
+2.  SQLCMD または SQL Server Management Studio で次のスクリプトを実行し、AdventureWorks データベース ファイルを SQL Server のインスタンスにアタッチします。  
+  
+    ```  
+    exec sp_attach_db @dbname=N'AdventureWorks', @filename1=N'C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data\AdventureWorks_Data.mdf', @filename2=N'C:\Program Files\Microsoft SQL Server\MSSQL.1\MSSQL\Data\AdventureWorks_log.ldf'  
+    ```  
+  
+     これらのファイルが異なるドライブまたはディレクトリにインストールされている場合は、パスを適宜修正してから、`sp_attach_db` ストアド プロシージャを実行してください。  
+  
+## SQL Server Express Edition のダウンロード  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] セクションで取り上げられているサンプルおよびチュートリアルには、データ ストアとして SQL Server 2005 が使用されていますが、代わりに SQL Server Express Edition を使用するように修正することもできます。  SQL Server Express Edition は無料で入手でき、アプリケーションと共に再配布できます。  Professional Edition 以上の [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] には、SQL Server Express Edition が付属しています。  
+  
+#### SQL Server Express Edition をダウンロードおよびインストールするには  
+  
+1.  Internet Explorer を開始します。  
+  
+2.  [Microsoft SQL Server 2005 Express Edition](http://go.microsoft.com/fwlink/?LinkID=31070) のダウンロード ページに移動します。  
+  
+3.  Web サイトに記載されているインストールの指示に従います。  
+  
+## 参照  
+ [Getting Started](../../../../docs/framework/data/adonet/getting-started-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/TOC.md b/docs/framework/data/adonet/ef/TOC.md
new file mode 100644
index 00000000000..550c2911afa
--- /dev/null
+++ b/docs/framework/data/adonet/ef/TOC.md
@@ -0,0 +1,53 @@
+# [EDM ジェネレーター (EdmGen.exe)](edm-generator-edmgen-exe.md)
+# [Entity Framework の用語](terminology.md)
+# [入れ子になったコレクションを返すクエリの実行方法](how-to-execute-a-query-that-returns-nested-collections.md)
+# [Entity Framework 用 SqlClient の型](sqlclient-for-ef-types.md)
+# [モデリングとマッピング](modeling-and-mapping.md)
+# [データ定義言語の操作](working-with-data-definition-language.md)
+# [EntityCommand を使用してパラメーター化 Entity SQL クエリを実行する方法](how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md)
+# [サンプル プロバイダーでの SQL 生成](sql-generation-in-the-sample-provider.md)
+# [概念モデルに対するクエリ](querying-a-conceptual-model.md)
+# [移行に関する注意点](migration-considerations.md)
+# [方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する](how-to-use-edmgen-exe-to-generate-object-layer-code.md)
+# [複合型を返すクエリの実行方法](how-to-execute-a-query-that-returns-complex-types.md)
+# [アーキテクチャとデザイン](architecture-and-design.md)
+# [プロバイダー マニフェストの仕様](provider-manifest-specification.md)
+# [システム関数](system-functions.md)
+# [データ プロバイダーの操作](working-with-data-providers.md)
+# [数学関数](mathematical-functions.md)
+# [ADO.NET Entity Framework](index.md)
+# [エンティティ フレームワークの概要](overview.md)
+# [Entity Framework 用 SqlClient](sqlclient-for-the-entity-framework.md)
+# [日付と時刻関数](date-and-time-functions.md)
+# [Entity Framework 用の EntityClient プロバイダー](entityclient-provider-for-the-entity-framework.md)
+# [セキュリティに関する注意事項](security-considerations.md)
+# [RefType 結果を返すクエリの実行方法](how-to-execute-a-query-that-returns-reftype-results.md)
+# [Navigate 演算子でリレーションシップをナビゲートする方法](how-to-navigate-relationships-with-the-navigate-operator.md)
+# [接続文字列](connection-strings.md)
+# [コマンド ツリーからの SQL の生成: ベスト プラクティス](generating-sql-from-command-trees-best-practices.md)
+# [Entity Framework 用 SqlClient 関数](sqlclient-for-ef-functions.md)
+# [PrimitiveType 結果を返すクエリの実行方法](how-to-execute-a-query-that-returns-primitivetype-results.md)
+# [パフォーマンスに関する考慮事項](performance-considerations.md)
+# [接続文字列を定義する方法](how-to-define-the-connection-string.md)
+# [EntityConnection の接続文字列を作成する方法](how-to-build-an-entityconnection-connection-string.md)
+# [開発および配置に関する注意事項](development-and-deployment-considerations.md)
+# [Entity Framework データ プロバイダー](data-providers.md)
+# [EntityCommand を使用してパラメーター化されたストアド プロシージャを実行する方法](how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md)
+# [Entity Framework 用の SqlClient の既知の問題](known-issues-in-sqlclient-for-entity-framework.md)
+# [はじめに](getting-started.md)
+# [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)
+# [配置に関する注意事項](deployment-considerations.md)
+# [文字列関数](string-functions.md)
+# [オブジェクトの使用](working-with-objects.md)
+# [ポリモーフィック クエリを実行する方法](how-to-execute-a-polymorphic-query.md)
+# [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する](how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md)
+# [StructuralType 結果を返すクエリの実行方法](how-to-execute-a-query-that-returns-structuraltype-results.md)
+# [コマンド ツリーの構造](the-shape-of-the-command-trees.md)
+# [変更 SQL 生成](modification-sql-generation.md)
+# [モデル ファイルとマッピング ファイルを組み込みリソースにする方法](how-to-make-model-and-mapping-files-embedded-resources.md)
+# [概念モデル正規関数と SQL Server 関数とのマッピング](conceptual-model-canonical-to-sql-server-functions-mapping.md)
+# [チュートリアル: SQL 生成](walkthrough-sql-generation.md)
+# [SQL 生成](sql-generation.md)
+# [Entity Framework のリソース](resources.md)
+# [Entity Framework データ プロバイダーの作成](writing-an-ef-data-provider.md)
+# [集計関数](aggregate-functions-sqlclient-for-entity-framework.md)
diff --git a/docs/framework/data/adonet/ef/aggregate-functions-sqlclient-for-entity-framework.md b/docs/framework/data/adonet/ef/aggregate-functions-sqlclient-for-entity-framework.md
new file mode 100644
index 00000000000..48ef5479865
--- /dev/null
+++ b/docs/framework/data/adonet/ef/aggregate-functions-sqlclient-for-entity-framework.md
@@ -0,0 +1,61 @@
+---
+title: "集計関数 (Entity Framework 用 SqlClient) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 03303f01-b591-4efc-9875-f9c608edff0b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 集計関数 (Entity Framework 用 SqlClient)
+.NET Framework Data Provider for SQL Server \(SqlClient\) には、集計関数が用意されています。  集計関数は、一連の入力値に対して計算を実行し、値を返します。  これらの関数は、SqlClient の SqlServer 名前空間に存在します。  Entity Framework は、プロバイダーの名前空間プロパティを使用することにより、型や関数など、特定のコンストラクターに対してこのプロバイダーによってどのプレフィックスが使用されているかを特定できます。  
+  
+ 次の表に、SqlClient の集計関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`AVG(` `expression` `)`|コレクション内の値の平均値を返します。<br /><br /> NULL 値は無視されます。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `expression` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_AVG](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_avg)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_AVG](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_avg)]|  
+|`CHECKSUM_AGG(` `collection` `)`|コレクション内にある値のチェックサムを返します。<br /><br /> NULL 値は無視されます。<br /><br /> **引数**<br /><br /> Collection \(`Int32`\)。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_CHECKSUM](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_checksum)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_CHECKSUM](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_checksum)]|  
+|`COUNT(` `expression` `)`|コレクション内のアイテムの数を `Int32` 型の値として返します。<br /><br /> **引数**<br /><br /> Collection \(T\)。ここで、T は次のいずれかの型になります。<br /><br /> `Guid` \(SQL Server 2000 では返されません\)、<br /><br /> `Boolean`、`Double`、`DateTime`、`DateTimeOffset`、`Time`、`String`、または `Binary`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_COUNT](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_count)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_COUNT](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_count)]|  
+|`COUNT_BIG(` `expression` `)`|コレクション内のアイテムの数を `bigint` 型の値として返します。<br /><br /> **引数**<br /><br /> Collection \(T\)。ここで、T は次のいずれかの型になります。<br /><br /> `Guid` \(SQL Server 2000 では返されません\)、`Boolean`、`Double`、`DateTime`、`DateTimeOffset`、`Time`、`String`、または `Binary`。<br /><br /> **戻り値**<br /><br /> `Int64`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_COUNTBIG](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_countbig)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_COUNTBIG](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_countbig)]|  
+|`MAX(` `expression` `)`|コレクション内の最大値を返します。<br /><br /> **引数**<br /><br /> Collection \(T\)。ここで、T は `Byte`、`Int16`、`Int32`、`Int64`、`Byte`、`Single`、`Double`、`Decimal`、`DateTime`、`DateTimeOffset`、`Time`、`String`、`Binary` のいずれかの型になります。<br /><br /> **戻り値**<br /><br /> `expression` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_MAX](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_max)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_MAX](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_max)]|  
+|`MIN(` `expression` `)`|コレクション内の最小値を返します。<br /><br /> **引数**<br /><br /> Collection \(T\)。ここで、T は `Byte`、`Int16`、`Int32`、`Int64`、`Byte`、`Single`、`Double`、`Decimal`、`DateTime`、`DateTimeOffset`、`Time`、`String` のいずれかの型になります。<br /><br /> `Binary`.<br /><br /> **戻り値**<br /><br /> `expression` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_MIN](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_min)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_MIN](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_min)]|  
+|`STDEV(` `expression` `)`|指定された式のすべての値の統計的標準偏差を返します。<br /><br /> **引数**<br /><br /> Collection \(`Double`\)。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_STDEV](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_stdev)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_STDEV](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_stdev)]|  
+|`STDEVP(` `expression` `)`|指定された式のすべての値を母集団として統計的標準偏差を返します。<br /><br /> **引数**<br /><br /> Collection \(`Double`\)。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_STDEVP](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_stdevp)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_STDEVP](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_stdevp)]|  
+|`SUM(` `expression` `)`|コレクション内のすべての値の合計を返します。<br /><br /> **引数**<br /><br /> Collection \(T\)。ここで、T は `Int32`、`Int64`、`Double`、`Decimal` のいずれかの型になります。<br /><br /> **戻り値**<br /><br /> `expression` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_SUM](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_sum)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_SUM](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_sum)]|  
+|`VAR(` `expression` `)`|指定された式のすべての値の統計的分散を返します。<br /><br /> **引数**<br /><br /> Collection \(`Double`\)。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_VAR](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_var)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_VAR](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_var)]|  
+|`VARP(` `expression` `)`|指定した式のすべての値について、母集団に対する統計的変位を返します。<br /><br /> **引数**<br /><br /> Collection \(`Double`\)。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_VARP](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_varp)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_VARP](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_varp)]|  
+  
+ SqlClient でサポートされる集計関数の詳細については、SqlClient プロバイダー マニフェストで指定した SQL Server のバージョンのドキュメントを参照してください。  
+  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|---------------------|---------------------|---------------------|  
+|[集約関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115906)|[集約関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkID=115903)|[集約関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115907)|  
+  
+## 参照  
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)   
+ [集計正規関数](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/architecture-and-design.md b/docs/framework/data/adonet/ef/architecture-and-design.md
new file mode 100644
index 00000000000..1185d969bfd
--- /dev/null
+++ b/docs/framework/data/adonet/ef/architecture-and-design.md
@@ -0,0 +1,425 @@
+---
+title: "アーキテクチャとデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd738d39-00e2-4bab-b387-90aac1a014bd
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# アーキテクチャとデザイン
+[サンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616) の SQL 生成モジュールは、コマンド ツリーを表す式ツリー上のビジターとして実装されます。  生成は、式ツリーを介した単一のパスで行われます。  
+  
+ ツリーのノードはボトムアップ方式で処理されます。  まず、中間構造として SqlSelectStatement または SqlBuilder が生成され、どちらも ISqlFragment を実装します。  次に、文字列である SQL ステートメントがその構造から生成されます。  中間構造には 2 つの理由があります。  
+  
+-   論理上、SQL SELECT ステートメントは順序を無視して挿入されます。  FROM 句に参加するノードは、WHERE 句、GROUP BY 句、および ORDER BY 句に参加するノードの前にアクセスされます。  
+  
+-   別名の名前を変更するには、名前の変更中に競合が発生しないように、使用されているすべての別名を識別する必要があります。  SqlBuilder で名前変更の選択を遅らせるには、Symbol オブジェクトを使用して、名前変更の候補となる列を表します。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/de1ca705-4f7c-4d2d-ace5-afefc6d3cefa.gif "de1ca705\-4f7c\-4d2d\-ace5\-afefc6d3cefa")  
+  
+ 最初のフェーズでは、式ツリーにアクセスしている間、式が SqlSelectStatement にグループ化され、結合がフラット化され、結合の別名がフラット化されます。  この段階では、Symbol オブジェクトは、名前変更が可能な列または入力の別名を表します。  
+  
+ 2 番目のフェーズでは、実際の文字列を生成している間、別名の名前が変更されます。  
+  
+## データ構造  
+ このセクションでは、SQL ステートメントのビルドに使用する [サンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616) で使用される種類について説明します。  
+  
+### ISqlFragment  
+ このセクションでは、ISqlFragment インターフェイスを実装するクラスについて説明します。このインターフェイスは、2 つの目的を達成します。  
+  
+-   すべてのビジター メソッドに共通する戻り値の型です。  
+  
+-   最終的な SQL 文字列を作成するためのメソッドを指定します。  
+  
+```  
+internal interface ISqlFragment {  
+   void WriteSql(SqlWriter writer, SqlGenerator sqlGenerator);  
+}  
+```  
+  
+#### SqlBuilder  
+ SqlBuilder は、StringBuilder と同様に、最終的な SQL 文字列の収集デバイスです。  これは、最終的な SQL を構成する文字列、および文字列に変換できる ISqlFragment で構成されます。  
+  
+```  
+internal sealed class SqlBuilder : ISqlFragment {  
+   public void Append(object s)  
+   public void AppendLine()  
+   public bool IsEmpty  
+}  
+```  
+  
+#### SqlSelectStatement  
+ SqlSelectStatement は、"SELECT … FROM  ..  WHERE … GROUP BY … ORDER BY" 形式の正規 SQL SELECT ステートメントを表します。  
+  
+ 各 SQL 句は StringBuilder によって表されます。  また、Distinct が指定されているかどうか、およびステートメントが最上位かどうかを追跡します。  ステートメントが最上位ではなく、ステートメントに TOP 句も含まれていない場合は、ORDER BY 句は省略されます。  
+  
+ FromExtents には、SELECT ステートメントの入力のリストが格納されます。  通常、これに含まれる要素は 1 つだけです。  結合のための SELECT ステートメントには、一時的に、複数の要素が含まれる場合があります。  
+  
+ SELECT ステートメントが結合ノードによって作成されると、SqlSelectStatement は、AllJoinExtents の結合でフラット化されたすべてのエクステントのリストを保持します。  OuterExtents は SqlSelectStatement の外部参照を表し、入力の別名の名前変更に使用されます。  
+  
+```  
+internal sealed class SqlSelectStatement : ISqlFragment {  
+   internal bool IsDistinct { get, set };  
+   internal bool IsTopMost  
+  
+   internal List<Symbol> AllJoinExtents { get, set };  
+   internal List<Symbol> FromExtents { get};  
+   internal Dictionary<Symbol, bool> OuterExtents { get};  
+  
+   internal TopClause Top { get, set };  
+  
+   internal SqlBuilder Select {get};  
+   internal SqlBuilder From  
+   internal SqlBuilder Where  
+   internal SqlBuilder GroupBy  
+   public SqlBuilder OrderBy  
+}  
+```  
+  
+#### TopClause  
+ TopClause は SqlSelectStatement の TOP 式を表します。  TopCount プロパティは、選択する必要がある TOP 行の数を示します。  WithTies が true の場合、TopClause は DbLimitExpession から作成されています。  
+  
+```  
+class TopClause : ISqlFragment {  
+   internal bool WithTies {get}  
+   internal ISqlFragment TopCount {get}  
+   internal TopClause(ISqlFragment topCount, bool withTies)  
+   internal TopClause(int topCount, bool withTies)  
+}  
+```  
+  
+### Symbols  
+ Symbol 関連のクラスおよびシンボル テーブルは、入力の別名の名前変更、結合の別名のフラット化、および列の別名の名前変更を実行します。  
+  
+ Symbol クラスは、エクステント、入れ子になった SELECT ステートメント、または列を表します。  Symbol クラスは、使用後に名前を変更できるように、実際の別名の代わりに使用されます。また、Symbol クラスが表す成果物の追加情報も伝達します \(型も同様です\)。  
+  
+```  
+class Symbol : ISqlFragment {  
+   internal Dictionary<string, Symbol> Columns {get}  
+   internal bool NeedsRenaming {get, set}  
+   internal bool IsUnnest {get, set}   //not used  
+  
+   public string Name{get}  
+   public string NewName {get,set}  
+   internal TypeUsage Type {get, set}  
+  
+   public Symbol(string name, TypeUsage type)  
+}  
+```  
+  
+ Name には、表されるエクステント、入れ子になった SELECT ステートメント、または列の元の別名が格納されます。  
+  
+ NewName には、SQL SELECT ステートメントで使用される別名が格納されます。  最初は Name に設定され、最終的な文字列クエリを生成する際に必要な場合のみ、名前が変更されます。  
+  
+ Type は、エクステントおよび入れ子になった SELECT ステートメントを表すシンボルの場合のみ有効です。  
+  
+#### SymbolPair  
+ SymbolPair クラスは、レコードのフラット化に対処します。  
+  
+ プロパティ式 D\(v, "j3.j2.j1.a.x"\) を考えてみます。この式では、v は VarRef、j1、j2、j3 は結合、a はエクステント、x は列です。  
+  
+ これは、最終的に {j'}.{x'} に変換する必要があります。  ソース フィールドが表す最も外側の SqlStatement は、結合式 \(j2 など\) を表します。つまり、これは常に Join シンボルです。  列フィールドは、非結合シンボルで停止するまで、ある結合シンボルから次の結合シンボルに移動します。  これは、DbPropertyExpression にアクセスすると返されますが、SqlBuilder に追加されることはありません。  
+  
+```  
+class SymbolPair : ISqlFragment {  
+   public Symbol Source;  
+   public Symbol Column;  
+   public SymbolPair(Symbol source, Symbol column)  
+}  
+```  
+  
+#### JoinSymbol  
+ Join シンボルは、結合または結合入力を含む入れ子になった SELECT ステートメントを表す Symbol です。  
+  
+```  
+internal sealed class JoinSymbol : Symbol {  
+   internal List<Symbol> ColumnList {get, set}  
+   internal List<Symbol> ExtentList {get}  
+   internal List<Symbol> FlattenedExtentList {get, set}  
+   internal Dictionary<string, Symbol> NameToExtent {get}  
+   internal bool IsNestedJoin {get, set}  
+  
+   public JoinSymbol(string name, TypeUsage type, List<Symbol> extents)  
+}  
+```  
+  
+ このシンボルが SQL SELECT ステートメントを表す場合、ColumnList は SELECT 句内の列のリストを表します。  ExtentList は、SELECT 句内のエクステントのリストです。  結合により最上位で複数のエクステントがフラット化された場合、FlattenedExtentList はそのエクステントを追跡し、エクステントの別名が正しく変更されたことを確認します。  
+  
+ NameToExtent は、ExtentList 内のすべてのエクステントをディクショナリとして使用します。  IsNestedJoin は、JoinSymbol が通常の結合シンボルか、対応する SqlSelectStatement を持つ結合シンボルかを判断するために使用します。  
+  
+ すべてのリストは、正確に設定されると、参照または列挙に使用されます。  
+  
+#### SymbolTable  
+ SymbolTable は、変数名を Symbol に解決するために使用されます。  SymbolTable は、各スコープの新しいエントリを持つスタックとして実装されます。  Lookup は、エントリが見つかるまでスタックの最上位から最下位まで検索します。  
+  
+```  
+internal sealed class SymbolTable {  
+   internal void EnterScope()  
+   internal void ExitScope()  
+   internal void Add(string name, Symbol value)  
+   internal Symbol Lookup(string name)  
+}  
+```  
+  
+ SQL 生成モジュールのインスタンス 1 つにつき、SymbolTable は 1 つしかありません。  各リレーショナル ノードでは、スコープへの出入りが行われます。  前のスコープ内のすべてのシンボルは、同じ名前の他のシンボルによって非表示になっている場合を除いて、後のスコープに表示されます。  
+  
+### ビジターのグローバル状態  
+ 別名と列の名前変更を支援するために、クエリ ツリーを最初に通過する際に使用されたすべての列名 \(AllColumnNames\) とすべてのエクステントの別名 \(AllExtentNames\) のリストを保持します。  シンボル テーブルは、変数名を Symbol に解決します。  IsVarRefSingle は、検証目的でのみ使用されるため、必ずしも必要ではありません。  
+  
+ CurrentSelectStatement および IsParentAJoin を介して使用される 2 つのスタックは、親ノードから子ノードに "parameters" を渡すために使用されます。これは、ビジター パターンによってパラメーターを渡すことができないためです。  
+  
+```  
+internal Dictionary<string, int> AllExtentNames {get}  
+internal Dictionary<string, int> AllColumnNames {get}  
+SymbolTable symbolTable = new SymbolTable();  
+bool isVarRefSingle = false;  
+  
+Stack<SqlSelectStatement> selectStatementStack;  
+private SqlSelectStatement CurrentSelectStatement{get}  
+  
+Stack<bool> isParentAJoinStack;  
+private bool IsParentAJoin{get}  
+```  
+  
+## 一般的なシナリオ  
+ このセクションでは、一般的なプロバイダー シナリオについて説明します。  
+  
+### SQL ステートメントへの式ノードのグループ化  
+ ボトムアップ方式でツリーにアクセスしたときに最初のリレーショナル ノード \(通常は DbScanExpression エクステント\) が見つかった場合に SqlSelectStatement が作成されます。  入れ子になったクエリをできるだけ少なくして SQL SELECT ステートメントを生成するには、その SqlSelectStatement でできるだけ多くの親ノードを集計します。  
+  
+ 特定の \(リレーショナル\) ノードを現在の SqlSelectStatement \(入力にアクセスしたときに返される SqlSelectStatement\) に追加できるかどうか、または新しいステートメントを開始する必要があるかどうかの決定は、IsCompatible メソッドによって計算され、SqlSelectStatement に既に含まれるノードに依存します。これは、指定されたノードの下にあったノードによって異なります。  
+  
+ 通常、連結が検討されているノードが空ではない句の後に SQL ステートメントの句が評価される場合、そのノードを現在のステートメントに追加することはできません。  たとえば、次のノードが Filter の場合、そのノードを現在の SqlSelectStatement に組み込むことができるのは、次の条件に当てはまる場合のみです。  
+  
+-   SELECT リストが空の場合。  SELECT リストが空ではない場合、SELECT リストはフィルターの前のノードによって生成されているため、述語はその SELECT リストによって生成された列を参照できます。  
+  
+-   GROUPBY が空の場合。  GROUPBY が空ではない場合、フィルターを追加すると、グループ化の前にフィルター処理することになりますが、これは正しい処理ではありません。  
+  
+-   TOP 句が空の場合。  TOP 句が空ではない場合、フィルターを追加すると、TOP を実行する前にフィルター処理することになりますが、これは正しい処理ではありません。  
+  
+ これは、DbConstantExpression や算術式のような非リレーショナル ノードには当てはまりません。非リレーショナル ノードは、常に既存の SqlSelectStatement に含まれているためです。  
+  
+ また、結合ツリーのルート \(結合の親を持たない結合ノード\) が見つかると、新しい SqlSelectStatement が開始されます。  左辺スパイン結合の子はすべて、その SqlSelectStatement に集計されます。  
+  
+ 新しい SqlSelectStatement が開始され、現在の SqlSelectStatement が入力に追加されるたびに、投影列 \(SELECT 句\) が存在しない場合はこの列を追加することによって、現在の SqlSelectStatement を完了することが必要になる場合があります。  これを行うには、AddDefaultColumns メソッドを使用します。このメソッドは、SqlSelectStatement の FromExtents を参照し、FromExtents が表すエクステントのリストによってスコープに取り込まれるすべての列を、投影された列のリストに追加します。  これが実行されるのは、その時点で、他のノードが参照している列が不明なためです。  これは、後で使用できる列のみを投影するように最適化できます。  
+  
+### 結合のフラット化  
+ IsParentAJoin プロパティは、特定の結合をフラット化できるかどうかを判断するのに役立ちます。  特に、IsParentAJoin は、結合の左側の子、および結合への即時入力となる各 DbScanExpression に対してのみ `true` を返します。この場合、その子ノードでは、後で親で使用されるのと同じ SqlSelectStatement が再利用されます。  詳細については、「結合式」を参照してください。  
+  
+### 入力の別名のリダイレクト  
+ 入力の別名のリダイレクトは、シンボル テーブルによって行われます。  
+  
+ 入力の別名のリダイレクトを説明するには、「[コマンド ツリーからの SQL の生成: ベスト プラクティス](../../../../../docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md)」の最初の例を参照してください。  この例では、"a" を投影の "b" にリダイレクトする必要がありました。  
+  
+ SqlSelectStatement オブジェクトが作成されると、ノードへの入力であるエクステントが SqlSelectStatement の From プロパティに配置されます。  Symbol \(\<symbol\_b\>\) は、入力バインディング名 \("b"\) に基づいて作成され、エクステントおよび "AS  " \+  \<symbol\_b\> が From 句に追加されることを表します。  シンボルは FromExtents プロパティにも追加されます。  
+  
+ シンボルはシンボル テーブルにも追加され、入力バインディング名がシンボルにリンクされます \("b", \<symbol\_b\>\)。  
+  
+ 後続のノードが SqlSelectStatement を再利用する場合、シンボル テーブルにエントリが追加され、その入力バインディング名がそのシンボルにリンクされます。  この例では、入力バインディング名が "a" の DbProjectExpression は、SqlSelectStatement を再利用して \("a", \<symbol\_b\>\) を表に追加します。  
+  
+ SqlSelectStatement を再利用しているノードの入力バインディング名を式で参照すると、その参照は、シンボル テーブルを使用して、リダイレクトされた正しいシンボルに解決されます。  "a" を表す DbVariableReferenceExpression にアクセスしているときに "a.x" から "a" に解決されると、Symbol \<symbol\_b\> に解決されます。  
+  
+### 結合の別名のフラット化  
+ 結合の別名のフラット化は、「DbPropertyExpression」で説明されているように、DbPropertyExpression にアクセスするときに行われます。  
+  
+### 列名およびエクステントの別名の名前変更  
+ 列名とエクステントの別名の名前変更に関する問題を解決するには、「SQL 生成の 2 番目のフェーズ: 文字列コマンドの生成」で説明されている、生成の 2 番目のフェーズで別名に置換されるシンボルを使用します。  
+  
+## SQL 生成の最初のフェーズ: 式ツリーへのアクセス  
+ このセクションでは、SQL 生成の最初のフェーズについて説明します。このフェーズでは、クエリを表す式にアクセスするときに、中間構造 SqlSelectStatement または SqlBuilder が生成されます。  
+  
+ このセクションでは、さまざまな式ノード カテゴリにアクセスする際の原則、および特定の式の型にアクセスする際の詳細について説明します。  
+  
+### リレーショナル \(非結合\) ノード  
+ 非結合ノードをサポートする式の型を次に示します。  
+  
+-   DbDistinctExpression  
+  
+-   DbFilterExpression  
+  
+-   DbGroupByExpression  
+  
+-   DbLimitExpession  
+  
+-   DbProjectExpression  
+  
+-   DbSkipExpression  
+  
+-   DbSortExpression  
+  
+ これらのノードへのアクセスは、次のパターンに従います。  
+  
+1.  リレーショナル入力にアクセスし、結果の SqlSelectStatement を取得します。  リレーショナル ノードへの入力は次のいずれかになります。  
+  
+    -   エクステントを含むリレーショナル ノード \(DbScanExpression など\)。  このようなノードにアクセスすると、SqlSelectStatement が返されます。  
+  
+    -   集合演算式 \(UNION ALL など\)。  結果は、角かっこで囲み、新しい SqlSelectStatement の FROM 句に配置する必要があります。  
+  
+2.  入力によって生成された SqlSelectStatement に現在のノードを追加できるかどうかを確認します。  これについては、「SQL ステートメントへの式ノードのグループ化」で説明しています。  追加できない場合は、次の操作を行います。  
+  
+    -   現在の SqlSelectStatement オブジェクトを表示します。  
+  
+    -   新しい SqlSelectStatement オブジェクトを作成し、表示された SqlSelectStatement を新しい SqlSelectStatement オブジェクトの FROM として追加します。  
+  
+    -   スタックの先頭に新しいオブジェクトを配置します。  
+  
+3.  入力式バインディングを入力から正しいシンボルにリダイレクトします。  この情報は、SqlSelectStatement オブジェクトに保持されます。  
+  
+4.  新しい SymbolTable スコープを追加します。  
+  
+5.  式の非入力部分 \(投影や述語など\) にアクセスします。  
+  
+6.  グローバル スタックに追加されたすべてのオブジェクトを表示します。  
+  
+ SQL で DbSkipExpression に相当するものはありません。  論理上、次のように変換されます。  
+  
+```  
+SELECT Y.x1, Y.x2, ..., Y.xn  
+FROM (  
+   SELECT X.x1, X.x2, ..., X.xn, row_number() OVER (ORDER BY sk1, sk2, ...) AS [row_number]   
+   FROM input as X   
+   ) as Y  
+WHERE Y.[row_number] > count   
+ORDER BY sk1, sk2, ...  
+```  
+  
+### 結合式  
+ 次の式は結合式と見なされ、VisitJoinExpression メソッドによって一般的な方法で処理されます。  
+  
+-   DbApplyExpression  
+  
+-   DbJoinExpression  
+  
+-   DbCrossJoinExpression  
+  
+ アクセスする手順を次に示します。  
+  
+ まず、子にアクセスする前に、IsParentAJoin を呼び出し、結合ノードが左スパインに沿った結合の子であるかどうかを確認します。  false が返された場合は、新しい SqlSelectStatement が開始されます。  その意味で、結合にアクセスする方法はその他のノードとは異なります。これは、親 \(結合ノード\) によって、子が使用する可能性のある SqlSelectStatement が作成されるためです。  
+  
+ 次に、入力を 1 つずつ処理します。  入力ごとに、次の手順を実行します。  
+  
+1.  入力にアクセスします。  
+  
+2.  ProcessJoinInputResult を呼び出して、入力にアクセスした結果の後処理を実行します。ProcessJoinInputResult は、結合式の子にアクセスした後にシンボル テーブルを保持し、場合によっては、子によって生成された SqlSelectStatement を終了します。  子の結果は次のいずれかになります。  
+  
+    -   親が追加される SqlSelectStatement とは別の SqlSelectStatement。  この場合、既定の列を追加して完了する必要があります。  入力が Join だった場合、新しい結合シンボルを作成する必要があります。  それ以外の場合は、標準のシンボルを作成します。  
+  
+    -   エクステント \(DbScanExpression など\)。この場合、エクステントは親の SqlSelectStatement の入力のリストに追加されます。  
+  
+    -   SqlSelectStatement 以外。この場合、角かっこで囲まれています。  
+  
+    -   親が追加されるのと同じ SqlSelectStatement。  この場合、FromExtents リスト内のシンボルは、すべてのシンボルを表す新しい 1 つの JoinSymbol に置き換える必要があります。  
+  
+    -   最初の 3 つの場合、AS 句を追加してシンボル テーブルを更新するために AddFromSymbol が呼び出されます。  
+  
+ その後、結合条件がある場合は、その条件にアクセスします。  
+  
+### セット操作  
+ 集合演算 DbUnionAllExpression、DbExceptExpression、および DbIntersectExpression は、VisitSetOpExpression メソッドによって処理されます。  次の構造の SqlBuilder が作成されます。  
+  
+```  
+<leftSqlSelectStatement> <setOp> <rightSqlSelectStatement>  
+```  
+  
+ この場合、\<leftSqlSelectStatement\> および \<rightSqlSelectStatement\> は、各入力にアクセスすることで取得される SqlSelectStatement を表し、\<setOp\> は対応する演算 \(UNION ALL など\) を表します。  
+  
+### DbScanExpression  
+ \(別の結合の左側の子である結合への入力として\) 結合コンテキストにアクセスすると、DbScanExpression は対応するターゲット \(定義クエリ、テーブル、またはビュー\) のターゲット SQL と共に SqlBuilder を返します。  それ以外の場合は、対応するターゲットに対応するように設定された FROM フィールドを使用して新しい SqlSelectStatement が作成されます。  
+  
+### DbVariableReferenceExpression  
+ DbVariableReferenceExpression にアクセスすると、シンボル テーブル内の参照に基づいてその変数参照式に対応する Symbol が返されます。  
+  
+### DbPropertyExpression  
+ 結合の別名のフラット化は、DbPropertyExpression にアクセスするときに識別および処理されます。  
+  
+ Instance プロパティは最初にアクセスされると、結果は Symbol、JoinSymbol、または SymbolPair になります。  この 3 つのケースを処理する方法を次に示します。  
+  
+-   JoinSymbol が返された場合、その NameToExtent プロパティには、必要なプロパティのシンボルが格納されます。  結合シンボルが入れ子になった結合を表す場合、新しい Symbol のペアが結合シンボルと共に返され、インスタンスの別名として使用されるシンボルと、さらに解決するために実際のプロパティを表すシンボルを追跡します。  
+  
+-   SymbolPair が返され、その Column 部分が結合シンボルである場合、結合シンボルが再び返されますが、現在のプロパティ式で表されるプロパティを指すように列プロパティが更新されます。  それ以外の場合は、別名として SymbolPair ソース、および列として現在のプロパティのシンボルを含む SqlBuilder が返されます。  
+  
+-   Symbol が返された場合、Visit メソッドは、別名としてそのインスタンス、および列名としてプロパティ名を含む SqlBuilder メソッドを返します。  
+  
+### DbNewInstanceExpression  
+ DbProjectExpression の Projection プロパティとして使用する場合、DbNewInstanceExpression は、投影された列を表すためにコンマで区切った引数のリストを生成します。  
+  
+ DbNewInstanceExpression が、コレクションの戻り値の型を格納しており、引数として指定される式の新しいコレクションを定義している場合、次の 3 つのケースは個別に処理されます。  
+  
+-   DbNewInstanceExpression に唯一の引数として DbElementExpression が使用されている場合、次のように変換されます。  
+  
+    ```  
+    NewInstance(Element(X)) =>  SELECT TOP 1 …FROM X  
+    ```  
+  
+ DbNewInstanceExpression に引数がない \(空のテーブルを表す\) 場合、DbNewInstanceExpression は次のように変換されます。  
+  
+```  
+SELECT CAST(NULL AS <primitiveType>) as X  
+FROM (SELECT 1) AS Y WHERE 1=0  
+```  
+  
+ それ以外の場合、DbNewInstanceExpression は引数の全体結合ラダーを作成します。  
+  
+```  
+SELECT <visit-result-arg1> as X  
+UNION ALL SELECT <visit-result-arg2> as X  
+UNION ALL …  
+UNION ALL SELECT <visit-result-argN> as X  
+```  
+  
+### DbFunctionExpression  
+ 正規関数と組み込み関数は同じように処理されます。そのため、これらの関数に特別な処理 \(TRIM\(string\) の LTRIM\(RTRIM\(string\)\) へのマップなど\) が必要な場合は、適切なハンドラーが呼び出されます。  それ以外の場合、これらの関数は FunctionName\(arg1, arg2, ..., argn\) に変換されます。  
+  
+ 特別な処理が必要な関数、およびその関数の適切なハンドラーを追跡するには、ディクショナリを使用します。  
+  
+ ユーザー定義関数は NamespaceName.FunctionName\(arg1, arg2, ..., argn\) に変換されます。  
+  
+### DbElementExpression  
+ DbElementExpression にアクセスするメソッドは、スカラー サブクエリを表すために使用されると DbElementExpression にアクセスする場合にのみ呼び出されます。  したがって、DbElementExpression は、完全な SqlSelectStatement に変換され、その周囲に角かっこを追加します。  
+  
+### DbQuantifierExpression  
+ 式の型 \(Any または All\) に応じて、DbQuantifierExpression は次のように変換されます。  
+  
+```  
+Any(input, x) => Exists(Filter(input,x))  
+All(input, x) => Not Exists(Filter(input, not(x))  
+```  
+  
+### DbNotExpression  
+ 場合によっては、入力式を使用して DbNotExpression の変換を折りたたむことができます。  次に例を示します。  
+  
+```  
+Not(IsNull(a)) =>  "a IS NOT NULL"  
+Not(All(input, x) => Not (Not Exists(Filter(input, not(x))) => Exists(Filter(input, not(x))  
+```  
+  
+ 2 番目の折りたたみが行われるのは、All 型の DbQuantifierExpression を変換するときにプロバイダーによって非効率が生じたためです。  したがって、Entity Framework は単純化を実行できませんでした。  
+  
+### DbIsEmptyExpression  
+ DbIsEmptyExpression は次のように変換されます。  
+  
+```  
+IsEmpty(inut) = Not Exists(input)  
+```  
+  
+## SQL 生成の 2 番目のフェーズ: 文字列コマンドの生成  
+ 文字列 SQL コマンドを生成すると、SqlSelectStatement によって、シンボルの実際の別名が生成されます。これにより、列名とエクステントの別名の名前変更に関する問題が解決されます。  
+  
+ エクステントの別名の名前変更は、SqlSelectStatement オブジェクトを文字列に書き込むときに行われます。  まず、外部エクステントで使用されるすべての別名のリストを作成します。  FromExtents \(または null 以外の場合は AllJoinExtents\) 内の各シンボルは、外部エクステントのいずれかと衝突する場合に名前が変更されます。  名前の変更が必要な場合は、AllExtentNames で収集されたエクステントと競合することはありません。  
+  
+ 列の名前変更は、Symbol オブジェクトを文字列に書き込むときに行われます。  最初のフェーズの AddDefaultColumns は、特定の列のシンボルの名前を変更する必要があるかどうかを判断します。  2 番目のフェーズでは、生成された名前が AllColumnNames で使用される名前と競合しないことを確認するために、名前の変更のみが行われます。  
+  
+ エクステントの別名と列の両方について一意の名前を生成するには、\<existing\_name\>\_n を使用します。n はまだ使用されていない最小の別名です。  すべての別名のグローバル リストを使用すると、連鎖名前変更の必要性が高くなります。  
+  
+## 参照  
+ [サンプル プロバイダーでの SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md b/docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md
new file mode 100644
index 00000000000..5936843c237
--- /dev/null
+++ b/docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md
@@ -0,0 +1,123 @@
+---
+title: "概念モデル正規関数と SQL Server 関数とのマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 1a2631bc-a426-4c0a-ba8d-26d9c80d39e2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 概念モデル正規関数と SQL Server 関数とのマッピング
+このトピックでは、概念モデル正規関数を対応する SQL Server 関数にマップする方法について説明します。  
+  
+## 日付と時刻関数  
+ 日付と時刻の関数のマッピングを次の表に示します。  
+  
+|正規関数|SQL Server 関数|  
+|----------|-------------------|  
+|[AddDays\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(day, number, date)`|  
+|[AddHours\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(hour, number, date)`|  
+|[AddMicroseconds\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(microsecond, number, date)`|  
+|[AddMilliseconds\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(millisecond, number, date)`|  
+|[AddMinutes\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(minute, number, date)`|  
+|[AddMonths\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(month, number, date)`|  
+|[AddNanoseconds\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(nanosecond, number, date)`|  
+|[AddSeconds\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(second, number, date)`|  
+|[AddYears\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEADD(year, number, date)`|  
+|[CreateDateTime\(year, month, day, hour, minute, second\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|SQL Server 2000 と SQL Server 2005 の場合、書式指定された `datetime` 値がサーバー上に作成されます。  SQL Server 2008 以上の場合、`datetime2` 値がサーバー上に作成されます。|  
+|[CreateDateTimeOffset\(year, month, day, hour, minute, second, tzoffset\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|書式指定された `datetimeoffset` 値がサーバー上に作成されます。<br /><br /> SQL Server 2000 と SQL Server 2005 ではサポートされません。|  
+|[CreateTime\(hour, minute, second\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|書式指定された `time` 値がサーバー上に作成されます。<br /><br /> SQL Server 2000 と SQL Server 2005 ではサポートされません。|  
+|[CurrentDateTime\(\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`SysDateTime()` \(SQL Server 2008\)。<br /><br /> `GetDate()` \(SQL Server 2000 および SQL Server 2005\)。|  
+|[CurrentDateTimeOffset\(\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`SysDateTimeOffset()` \(SQL Server 2008\)。<br /><br /> SQL Server 2000 と SQL Server 2005 ではサポートされません。|  
+|[CurrentUtcDateTime\(\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`SysUtcDateTime()` \(SQL Server 2008\)。  `GetUtcDate()` \(SQL Server 2000 および SQL Server 2005\)。|  
+|[DayOfYear\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(dayofyear, expression)`|  
+|[Day\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(day, expression)`|  
+|[DiffDays\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(day, startdate, enddate)`|  
+|[DiffHours\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(hour, startdate, enddate)`|  
+|[DiffMicroseconds\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(microsecond, startdate, enddate)`|  
+|[DiffMilliseconds\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(millisecond, startdate, enddate)`|  
+|[DiffMinutes\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(minute, startdate, enddate)`|  
+|[DiffNanoseconds\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(nanosecond, startdate, enddate)`|  
+|[DiffSeconds\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(second, startdate, enddate)`|  
+|[DiffYears\(startExpression, endExpression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DATEDIFF(year, startdate, enddate)`|  
+|[GetTotalOffsetMinutes\(DateTimeOffset\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(tzoffset, expression)`|  
+|[Hour\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(hour, expression)`|  
+|[Millisecond\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(millisecond, expression)`|  
+|[Minute\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(minute, expression)`|  
+|[Month\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(month, expression)`|  
+|[Second\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(second, expression)`|  
+|[Truncate\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|SQL Server 2000 と SQL Server 2005 の場合、切り詰められ、書式設定された `datetime` ``  値がサーバー上に作成されます。  SQL Server 2008 以上の場合、切り詰められた `datetime2` 値か  `` `datetimeoffset` 値がサーバー上に作成されます。|  
+|[Year\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|`DatePart(YEAR, expression)`|  
+  
+## 集計関数  
+ 集計関数のマッピングを次の表に示します。  
+  
+|正規関数|SQL Server 関数|  
+|----------|-------------------|  
+|[Avg\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`AVG(expression)`|  
+|[BigCount\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`BIGCOUNT(expression)`|  
+|[Count\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`COUNT(expression)`|  
+|[Min\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`MIN(expression)`|  
+|[Max\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`MAX(expression)`|  
+|[StDev\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`STDEV(expression)`|  
+|[StDevP\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`STDEVP(expression)`|  
+|[Sum\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`SUM(expression)`|  
+|[Var\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`VAR(expression)`|  
+|[VarP\(expression\)](../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|`VARP(expression)`|  
+  
+## 数学関数  
+ 数学関数のマッピングを次の表に示します。  
+  
+|正規関数|SQL Server 関数|  
+|----------|-------------------|  
+|[Abs\(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`ABS(value)`|  
+|[Ceiling\(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`CEILING(value)`|  
+|[Floor\(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`FLOOR(value)`|  
+|[Power\(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`POWER(value, exponent)`|  
+|[Round\(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`ROUND(value, digits, 0)`|  
+|[Truncate](../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|`ROUND(value , digits, 1)`|  
+  
+## 文字列関数  
+ 文字列関数のマッピングを次の表に示します。  
+  
+|正規関数|SQL Server 関数|  
+|----------|-------------------|  
+|[Contains\(string, target\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`CHARINDEX(target, string)`|  
+|[Concat\(string1, string2\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|string1 \+ string2|  
+|[EndsWith\(string, target\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`CHARINDEX(REVERSE(target), REVERSE(string)) = 1`<br /><br /> **メモ** `string` が固定長文字列の列に格納されており、`target` が定数である場合、`CHARINDEX` 関数は `false` を返します。  この場合、末尾の埋め込み空白も含めて文字列全体が検索されます。  この問題を回避するには、データを固定長文字列の長さに合わせて切り詰めてから、文字列を `EndsWith` 関数に渡します。たとえば、`EndsWith(TRIM(string), target)` のように指定します。|  
+|[IndexOf\(target, string2\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`CHARINDEX(target, string2)`|  
+|[Left \(string1, length\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`LEFT(string1, length)`|  
+|[Length \(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`LEN(string)`|  
+|[LTrim\(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`LTRIM(string)`|  
+|[Right \(string1, length\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`RIGHT (string1, length)`|  
+|[Trim\(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`LTRIM(RTRIM(string))`|  
+|[Replace \(string1, string2, string3\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`REPLACE(string1, string2, string3)`|  
+|[Reverse \(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`REVERSE (string)`|  
+|[RTrim\(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`RTRIM(string)`|  
+|[StartsWith\(string, target\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`CHARINDEX(target, string)`|  
+|[Substring\(string, start, length\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`SUBSTRING(string, start, length)`|  
+|[ToLower\(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`LOWER(string)`|  
+|[ToUpper\(string\)](../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|`UPPER(string)`|  
+  
+## ビット単位の関数  
+ ビット単位の関数のマッピングを次の表に示します。  
+  
+|正規関数|SQL Server 関数|  
+|----------|-------------------|  
+|[BitWiseAnd \(value1, value2\)](../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)|value1 & value2|  
+|[BitWiseNot \(value\)](../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)|~value|  
+|[BitWiseOr \(value1, value2\)](../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)|value1 &#124; value2|  
+|[BitWiseXor \(value1, value2\)](../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)|value1 ^ value2|
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/connection-strings.md b/docs/framework/data/adonet/ef/connection-strings.md
new file mode 100644
index 00000000000..5ed798f62bb
--- /dev/null
+++ b/docs/framework/data/adonet/ef/connection-strings.md
@@ -0,0 +1,126 @@
+---
+title: "接続文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 78d516bc-c99f-4865-8ff1-d856bc1a01c0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 接続文字列
+接続文字列には、データ プロバイダーからデータ ソースにパラメーターとして渡す初期化情報が含まれています。  接続文字列は接続を開くときに解析され、その構文はデータ プロバイダーによって異なります。  Entity Framework で使用される接続文字列には、Entity Framework のサポート基盤である ADO.NET データ プロバイダーへの接続に使用される情報が含まれています。  また、必要なモデル ファイルおよびマッピング ファイルに関する情報も含まれています。  
+  
+ 接続文字列は、モデル メタデータおよびマッピング メタデータにアクセスしてデータ ソースに接続する際に EntityClient プロバイダーによって使用されます。  接続文字列へのアクセスや接続文字列の設定は、<xref:System.Data.EntityClient.EntityConnection> の <xref:System.Data.EntityClient.EntityConnection.ConnectionString%2A> プロパティを使用して行います。  <xref:System.Data.EntityClient.EntityConnectionStringBuilder> クラスを使用すると、接続文字列内のパラメーターの構築やこれらへのアクセスをプログラムで行えます。  詳細については、「[EntityConnection の接続文字列を作成する方法](../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)」を参照してください。  
+  
+ [Entity Data Model ツール](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)は、アプリケーションの構成ファイルに保存される接続文字列を生成します。  <xref:System.Data.Objects.ObjectContext> は、オブジェクト クエリの作成時に自動的にこの接続情報を取得します。  <xref:System.Data.Objects.ObjectContext> インスタンスで使用される <xref:System.Data.EntityClient.EntityConnection> には、<xref:System.Data.Objects.ObjectContext.Connection%2A> プロパティからアクセスできます。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。  
+  
+## 接続文字列パラメーター  
+ 接続文字列の形式は、キーと値パラメーターのペアをセミコロンで区切ったリストです。  
+  
+ `keyword1=value; keyword2=value;`  
+  
+ それぞれのキーワードと値の関連付けには、等号 \(\=\) が使用されます。  キーワードの大文字と小文字は区別されません。また、キーと値のペア間のスペースは無視されます。  ただし、値の大文字と小文字を区別するかどうかはデータ ソースにより異なる場合があります。  値にセミコロン、単一引用符、または二重引用符が含まれている場合は、必ず二重引用符で囲む必要があります。  <xref:System.Data.EntityClient.EntityConnection.ConnectionString%2A> のキーワード値に有効な名前を次の表に示します。  
+  
+|キーワード|説明|  
+|-----------|--------|  
+|`Provider`|`Name` キーワードが指定されていない場合に必要です。  基になるプロバイダーの <xref:System.Data.Common.DbProviderFactory> オブジェクトを取得するために使用されるプロバイダー名です。  この値は定数です。<br /><br /> `Name` キーワードがエンティティ接続文字列に含まれていない場合、`Provider` キーワードの空でない値が必要になります。  このキーワードは `Name` キーワードと同時に指定できません。|  
+|`Provider Connection String`|省略可能です。  基になるデータ ソースに渡される、プロバイダー固有の接続文字列を指定します。  この接続文字列は、データ プロバイダーの有効なキーワード\/値ペアを使用して表されます。  無効な `Provider Connection String` がデータ ソースによって評価されると、ランタイム エラーが発生します。<br /><br /> このキーワードは `Name` キーワードと同時に指定できません。<br /><br /> `Provider Connection String` の値は、引用符で囲む必要があります。  次に例を示します。<br /><br /> `Provider Connection String ="Server=serverName; User ID = userID";`<br /><br /> 次に誤った例を示します。<br /><br /> `Provider Connection String =Server=serverName; User ID = userID`|  
+|`Metadata`|`Name` キーワードが指定されていない場合に必要です。  メタデータとマッピング情報の検索対象となるディレクトリ、ファイル、およびリソースの場所をパイプで区切って指定したリストです。  次に例を示します。<br /><br /> `Metadata=`<br /><br /> `c:\model &#124; c:\model\sql\mapping.msl;`<br /><br /> パイプ区切り記号の両側の空白は無視されます。<br /><br /> このキーワードは `Name` キーワードと同時に指定できません。|  
+|`Name`|アプリケーションは、オプションで、必要なキーワード\/値接続文字列値を提供する接続名をアプリケーション構成ファイル内で指定できます。  その場合は、接続文字列内に値を直接記述することはできません。  `Name` キーワードは、構成ファイル内で使用できません。<br /><br /> `Name` キーワードが接続文字列に含まれていない場合、Provider キーワードの空でない値が必要になります。<br /><br /> このキーワードは他のすべての接続文字列キーワードと同時に指定できません。|  
+  
+ アプリケーション構成ファイルに格納された [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) の接続文字列の例を次に示します。  
+  
+  
+  
+## モデル ファイルおよびマッピング ファイルの場所  
+ `Metadata` パラメーターには、`EntityClient` プロバイダーがモデル ファイルおよびマッピング ファイルを検索するための場所のリストが格納されます。  多くの場合、モデル ファイルとマッピング ファイルは、アプリケーション実行可能ファイルと同じディレクトリに配置されます。  これらのファイルは、特定の場所に配置することも組み込みリソースとしてアプリケーションに含めることもできます。  
+  
+ 組み込みリソースは次のように指定します。  
+  
+```  
+Metadata=res://<assemblyFullName>/<resourceName>.   
+```  
+  
+ 組み込みリソースの場所を定義するには、次のオプションを使用できます。  
+  
+|||  
+|-|-|  
+|オプション|説明|  
+|`assemblyFullName`|リソースが組み込まれたアセンブリの完全な名前。  この名前には、次のように単純な名前、バージョン名、サポートされるカルチャ、および公開キーが含まれます。<br /><br /> `ResourceLib, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null`<br /><br /> リソースは、アプリケーションからアクセスできる任意のアセンブリに組み込むことができます。<br /><br /> `assemblyFullName` にワイルドカード \(\*\) を指定すると、Entity Framework ランタイムでは、次の場所のリソースがこの順序で検索されます。<br /><br /> 1.  呼び出し側のアセンブリ<br />2.  参照アセンブリ<br />3.  アプリケーションの bin ディレクトリ内のアセンブリ<br /><br /> ファイルが上記のどの場所にもない場合は、例外がスローされます。 **Note:**  ワイルドカード \(\*\) を使用する場合、Entity Framework では、正しい名前のリソースを見つけるためにすべてのアセンブリを調べる必要があります。  パフォーマンスを向上させるには、ワイルドカードではなくアセンブリ名を指定してください。|  
+|`resourceName`|AdvendtureWorksModel.csdl などの含まれるリソースの名前。  メタデータ サービスでは、拡張子が .csdl、.ssdl、または .msl のいずれかであるファイルまたはリソースのみが検索されます。  `resourceName` を指定しない場合は、すべてのメタデータ リソースが読み込まれます。  リソースには、アセンブリ内で一意の名前を付ける必要があります。  同じ名前が付けられた複数のファイルがアセンブリ内の異なるディレクトリで定義されている場合、`resourceName` には、リソースの名前の前にフォルダー構造を含める必要があります \(FolderName.FileName.csdl など\)。<br /><br /> `assemblyFullName` にワイルドカード \(\*\) を指定した場合、`resourceName` は不要です。|  
+  
+> [!NOTE]
+>  パフォーマンスを向上させるには、リソースを呼び出し側のアセンブリに組み込んでください。ただし、呼び出し側のアセンブリ内の基になるマッピング ファイルとメタデータ ファイルへの参照が存在しない Web 以外のシナリオの場合は除きます。  
+  
+ 次の例では、呼び出し側のアセンブリ、参照アセンブリ、およびアプリケーションの bin ディレクトリ内のその他のアセンブリに存在するすべてのモデル ファイルおよびマッピング ファイルを読み込みます。  
+  
+```  
+Metadata=res://*/  
+```  
+  
+ 次の例では、model.csdl ファイルを AdventureWorks アセンブリから読み込み、model.ssdl ファイルと model.msl ファイルを実行中のアプリケーションの既定のディレクトリから読み込みます。  
+  
+```  
+Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl|model.ssdl|model.msl  
+```  
+  
+ 次の例では、指定した 3 つのリソースを特定のアセンブリから読み込みます。  
+  
+```  
+Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.csdl|   
+res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.ssdl|   
+res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/model.msl  
+```  
+  
+ 次の例では、拡張子が .csdl、.msl、および .ssdl であるすべての組み込みリソースをアセンブリから読み込みます。  
+  
+```  
+Metadata=res://AdventureWorks, 1.0.0.0, neutral, a14f3033def15840/  
+```  
+  
+ 次の例では、相対ファイル パスと "datadir\\metadata\\" 内のすべてのリソースを読み込まれたアセンブリの場所から読み込みます。  
+  
+```  
+Metadata=datadir\metadata\  
+```  
+  
+ 次の例では、相対ファイル パス内のすべてのリソースを読み込まれたアセンブリの場所から読み込みます。  
+  
+```  
+Metadata=.\  
+```  
+  
+## &#124;DataDirectory&#124; 置換文字列と Web アプリケーション ルート演算子 \(~\) のサポート  
+ `DataDirectory` と ~ 演算子は、`Metadata` キーワードと `Provider Connection String` キーワードの一部として <xref:System.Data.EntityClient.EntityConnection.ConnectionString%2A> `` で使用されます。  <xref:System.Data.EntityClient.EntityConnection> によって、`DataDirectory` と ~ 演算子がそれぞれ <xref:System.Data.Metadata.Edm.MetadataWorkspace> とストア プロバイダーに転送されます。  
+  
+|用語|説明|  
+|--------|--------|  
+|`&#124;DataDirectory&#124;`|マッピング ファイルとメタデータ ファイルの相対パスに解決されます。  この値は、`AppDomain.SetData("DataDirectory", objValue)` メソッドで設定される値です。  `DataDirectory` 置換文字列はパイプ文字で囲む必要があり、その名前とパイプ文字の間に空白を含めることはできません。  `DataDirectory` の名前では大文字と小文字は区別されません。<br /><br /> "DataDirectory" という名前の物理ディレクトリをメタデータ パスのリストのメンバーとして渡す必要がある場合は、名前の片側または両側に空白を追加します \(`Metadata="DataDirectory1 &#124; DataDirectory &#124; DataDirectory2"` など\)。  ASP.NET アプリケーションでは、&#124;DataDirectory&#124; は "\<application root\>\/app\_data" フォルダーに解決されます。|  
+|~|Web アプリケーション ルートに解決されます。  先頭の ~ 文字は、有効なローカル サブディレクトリを表すこともありますが、常に Web アプリケーション ルート演算子 \(~\) として解釈されます。  このようなローカル サブディレクトリを参照するには、ユーザーが明示的に `./~` を渡す必要があります。|  
+  
+ `DataDirectory` と ~ 演算子は、パスの先頭にのみ指定する必要があります。その他の位置では解決されません。  Entity Framework では、`~/data` の解決は試行されますが、`/data/~` は物理パスとして処理されます。  
+  
+ `DataDirectory` または ~ 演算子で始まるパスは、`DataDirectory` と ~ 演算子の分岐の外側の物理パスには解決できません。  たとえば、パス `~`、`~/data`、`~/bin/Model/SqlServer` は解決されます。  パス `~/..` や `~/../other` は解決できません。  
+  
+ `DataDirectory` と ~ 演算子は、`|DataDirectory|\Model` や `~/bin/Model` など、サブディレクトリが含まれるように拡張できます。  
+  
+ `DataDirectory` 置換文字列と ~ 演算子の解決は非再帰型です。  たとえば、`DataDirectory` に `~` 文字が含まれる場合は、例外が発生します。  これにより、無限再帰が回避されます。  
+  
+## 参照  
+ [データ プロバイダーの操作](../../../../../docs/framework/data/adonet/ef/working-with-data-providers.md)   
+ [配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/deployment-considerations.md)   
+ [Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)   
+ [接続文字列](../../../../../docs/framework/data/adonet/connection-strings.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/data-providers.md b/docs/framework/data/adonet/ef/data-providers.md
new file mode 100644
index 00000000000..38ce98e5dd1
--- /dev/null
+++ b/docs/framework/data/adonet/ef/data-providers.md
@@ -0,0 +1,37 @@
+---
+title: "Entity Framework データ プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5252e639-ff11-4818-82e7-07221ed6ae23
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity Framework データ プロバイダー
+ここでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] をサポートするデータ プロバイダーについて説明します。  
+  
+## このセクションの内容  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)  
+ EntityClient データ プロバイダーについて説明します。  このプロバイダーは、データ モデルに対するクエリを正規コマンド ツリーに変換します。  すると、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] 用の [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] データ プロバイダーが、このコマンド ツリーを消費できるようになります。  
+  
+ [Entity Framework 用 SqlClient](../../../../../docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md)  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] データベースと共に使用できる [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] データ プロバイダーについて説明します。  
+  
+## 関連項目  
+ [Entity Framework \(SQL Server Compact\)](http://go.microsoft.com/fwlink/?LinkId=135638)  
+ プロバイダーの制限事項と、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を SQL Server Compact のデータベースと組み合わせて使用する方法について説明します。  
+  
+ [Entity Framework のサードパーティ プロバイダー](http://go.microsoft.com/fwlink/?LinkId=143699)  
+ 現在、Entity Framework 用として公開されているサードパーティのデータ プロバイダーの一覧。  
+  
+## 参照  
+ [データ プロバイダーの操作](../../../../../docs/framework/data/adonet/ef/working-with-data-providers.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/date-and-time-functions.md b/docs/framework/data/adonet/ef/date-and-time-functions.md
new file mode 100644
index 00000000000..d8b7491b548
--- /dev/null
+++ b/docs/framework/data/adonet/ef/date-and-time-functions.md
@@ -0,0 +1,48 @@
+---
+title: "日付と時刻関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 971762d0-663b-4b64-8c61-352a8e6d3949
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 日付と時刻関数
+.NET Framework Data Provider for SQL Server \(SqlClient\) には、`System.DateTime` 型の入力値に対して操作を実行し、`string`、数値、または `System.DateTime` 値の結果を返す日付と時刻関数が用意されています。  これらの関数は、SqlClient の SqlServer 名前空間に存在します。  Entity Framework は、プロバイダーの名前空間プロパティを使用することにより、型や関数など、特定のコンストラクターに対してこのプロバイダーによってどのプレフィックスが使用されているかを特定できます。次の表に、SqlClient の日付と時刻関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`DATEADD(` `datepart`, `number`, `date``)`|指定された日付に特定の期間を加えた新しい `DateTime` 型の値を返します。<br /><br /> **引数**<br /><br /> `datepart`: 新しい値を返す対象となる日付の要素を表す `String`。<br /><br /> `number`: `datepart` に加算する値 \(`Int32`、`Int64`、`Decimal`、`Double` のいずれか\)。<br /><br /> `date`: 有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、`Time` のいずれかの値を返す式、または日付形式の文字列。<br /><br /> **戻り値**<br /><br /> 有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、または `Time` の新しい値。<br /><br /> **例**<br /><br /> `SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))`|  
+|`DATEDIFF(` `datepart`, `startdate`, `enddate``)`|指定された 2 つの日付間の差を、日付および時刻の単位で返します。<br /><br /> **引数**<br /><br /> `datepart`: 差分を計算する日付の要素を表す `String`。<br /><br /> `startdate`: 計算の開始日として、有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、`Time` のいずれかの値を返す式、または日付形式の文字列を指定します。<br /><br /> `enddate`: 計算の終了日として、有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、`Time` のいずれかの値を返す式、または日付形式の文字列を指定します。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),`<br /><br /> `cast('6/20/2006' as DateTime))`|  
+|`DATENAME(` `datepart`, `date``)`|指定された日付の特定の日付構成要素を文字列で返します。<br /><br /> **引数**<br /><br /> `datepart`: 新しい値を返す対象となる日付の要素を表す `String`。<br /><br /> `date`: 有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、`Time` のいずれかの値を返す式、または日付形式の文字列。<br /><br /> **戻り値**<br /><br /> 指定された日付について、特定の日付要素を表す文字列。<br /><br /> **例**<br /><br /> `SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))`|  
+|`DATEPART(` `datepart`, `date``)`|指定された日付について、特定の日付要素を整数で返します。<br /><br /> **引数**<br /><br /> `datepart`: 新しい値を返す対象となる日付の要素を表す `String`。<br /><br /> `date`: 有効桁数が 0 ～ 7 の `DateTime`、`DateTimeOffset`、`Time` のいずれかの値を返す式、または日付形式の文字列。<br /><br /> **戻り値**<br /><br /> 指定された日付の特定の日付要素を表す `Int32` 値。<br /><br /> **例**<br /><br /> `SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))`|  
+|`DAY(` `date` `)`|指定された日付の日を整数として返します。<br /><br /> **引数**<br /><br /> `date`:有効桁数が 0 ～ 7 の `DateTime` 型または `DateTimeOffset` 型の式。<br /><br /> **戻り値**<br /><br /> 指定された日付の日を表す `Int32` 値。<br /><br /> **例**<br /><br /> `SqlServer.DAY(cast('6/9/2006' as DateTime))`|  
+|`GETDATE()`|datetime 値に使用する現在の日付と時刻を SQL Server の内部形式で生成します。<br /><br /> **戻り値**<br /><br /> 有効桁数が 3 の `DateTime` としての現在のシステム日時。<br /><br /> **例**<br /><br /> `SqlServer.GETDATE()`|  
+|`GETUTCDATE()`|UTC \(協定世界時またはグリニッジ標準時\) 形式の datetime 値を生成します。<br /><br /> **戻り値**<br /><br /> UTC 形式の有効桁数 3 の `DateTime` 値。<br /><br /> **例**<br /><br /> `SqlServer.GETUTCDATE()`|  
+|`MONTH(` `date` `)`|指定された日付の月を整数として返します。<br /><br /> **引数**<br /><br /> `date`:有効桁数が 0 ～ 7 の `DateTime` 型または `DateTimeOffset` 型の式。<br /><br /> **戻り値**<br /><br /> 指定された日付の月を表す `Int32` 値。<br /><br /> **例**<br /><br /> `SqlServer.MONTH(cast('6/9/2006' as DateTime))`|  
+|`YEAR(` `date` `)`|指定された日付の年を整数として返します。<br /><br /> **引数**<br /><br /> `date`:有効桁数が 0 ～ 7 の `DateTime` 型または `DateTimeOffset` 型の式。<br /><br /> **戻り値**<br /><br /> 指定された日付の年を表す `Int32` 値。<br /><br /> **例**<br /><br /> `SqlServer.YEAR(cast('6/9/2006' as DateTime))`|  
+|`SYSDATETIME()`|有効桁数が 7 の `DateTime` 値を返します。<br /><br /> **戻り値**<br /><br /> 有効桁数が 7 の `DateTime` 値。<br /><br /> **例**<br /><br /> `SqlServer.SYSDATETIME()`|  
+|`SYSUTCDATE()`|UTC \(協定世界時またはグリニッジ標準時\) 形式の datetime 値を生成します。<br /><br /> **戻り値**<br /><br /> UTC 形式の有効桁数 7 の `DateTime` 値。<br /><br /> **例**<br /><br /> `SqlServer.SYSUTCDATE()`|  
+|`SYSDATETIMEOFFSET()`|有効桁数が 7 の `DateTimeOffset` 値を返します。<br /><br /> **戻り値**<br /><br /> UTC 形式の有効桁数 7 の `DateTimeOffset` 値。<br /><br /> **例**<br /><br /> `SqlServer.SYSDATETIMEOFFSET()`|  
+  
+ SqlClient でサポートされる日付と時刻の関数の詳細については、SqlClient プロバイダー マニフェストで指定した SQL Server のバージョンのドキュメントを参照してください。  
+  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|---------------------|---------------------|---------------------|  
+|[日付と時間関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115908)|[日付と時間関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115909)|[日付と時間関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=98360)|  
+  
+## 参照  
+ [Entity Framework 用 SqlClient 関数](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/deployment-considerations.md b/docs/framework/data/adonet/ef/deployment-considerations.md
new file mode 100644
index 00000000000..b4a3946d0ae
--- /dev/null
+++ b/docs/framework/data/adonet/ef/deployment-considerations.md
@@ -0,0 +1,44 @@
+---
+title: "配置に関する注意事項 (Entity Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 3a847a22-4eb8-4565-b18b-453bbca070db
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 配置に関する注意事項 (Entity Framework)
+このトピックでは、データ アクセスに ADO.NET Entity Framework を使用するアプリケーションの配置について説明します。  Entity Framework の詳細については、「[はじめに](../../../../../docs/framework/data/adonet/ef/getting-started.md)」を参照してください。  
+  
+ Entity Framework は、Visual Studio に組み込むことにより Visual Studio での開発を容易にする一連のツールを提供します。  詳細については、「[ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)」を参照してください。  このトピックでは、Entity Framework ベースのアプリケーションを配置するための具体的なテクノロジの使用法については触れません。  
+  
+ Visual Studio では、ClickOnce 配置など、アプリケーションの配布および配置のための機能が提供されています。  詳細については、Visual Studio ドキュメントの「[アプリケーションとコンポーネントの配置](../Topic/Deploying%20Applications,%20Services,%20and%20Components.md)」を参照してください。  
+  
+ Entity Framework を使用するアプリケーションを配置する場合は、次の注意事項が適用されます。  
+  
+-   .NET Framework 3.5 Service Pack 1 \(SP1\) 以降、Entity Framework は .NET Framework のコンポーネントになっています。  Entity Framework ベースのアプリケーションを配置する場合は、.NET Framework 3.5 SP1 以降のバージョンがインストールされていることを確認する必要があります。  
+  
+-   Entity Data Model ウィザードで概念モデルが生成されると、アプリケーション設定ファイルに接続文字列が作成されます。  モデル ファイルおよびマッピング ファイルをアプリケーション リソースとして埋め込むか、出力ディレクトリにコピーすることができます。  既定では、モデル ファイルとマッピング ファイルは、組み込みアプリケーション リソースとして配置されます。  エンティティ デザイナー ファイルの `Metadata Artifact Processing` プロパティを使用して、次のオプションのいずれかを選択することができます。  詳細については、「[How to: Copy Model and Mapping Files to the Output Directory](http://msdn.microsoft.com/ja-jp/e2c9820f-1705-457e-9fdb-8b289f3179b4)」を参照してください。  
+  
+-   モデルとマッピングの情報 \(概念スキーマ定義言語 \(CSDL\)、ストア スキーマ定義言語 \(SSDL\)、およびマッピング仕様言語 \(MSL\) で表現\) は、アプリケーションと共に配置され、その場所は、接続文字列によって指定されます。  詳細については、「[接続文字列](../../../../../docs/framework/data/adonet/ef/connection-strings.md)」を参照してください。  
+  
+-   モデルとマッピングの情報をアプリケーション リソースとして組み込む場合は、概念モデルを更新するたびに、アプリケーションの再コンパイルと再配置が必要になります。  
+  
+-   Entity Framework は .NET Framework のコンポーネントであるため、.NET Framework 使用許諾契約書での許可に従ってアプリケーションと共に再配布できます。  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)   
+ [開発および配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/development-and-deployment-considerations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/development-and-deployment-considerations.md b/docs/framework/data/adonet/ef/development-and-deployment-considerations.md
new file mode 100644
index 00000000000..a1d574df394
--- /dev/null
+++ b/docs/framework/data/adonet/ef/development-and-deployment-considerations.md
@@ -0,0 +1,35 @@
+---
+title: "開発および配置に関する注意事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 535e6611-02de-484c-b5ff-6ffeed04d740
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 開発および配置に関する注意事項
+このセクションのトピックでは、ADO.NET Entity Framework に基づくアプリケーションを開発または配置する際に考慮する必要のある問題について説明します。  
+  
+## このセクションの内容  
+ [セキュリティに関する注意事項](../../../../../docs/framework/data/adonet/ef/security-considerations.md)  
+  
+ [パフォーマンスに関する考慮事項](../../../../../docs/framework/data/adonet/ef/performance-considerations.md)  
+  
+ [移行に関する注意点](../../../../../docs/framework/data/adonet/ef/migration-considerations.md)  
+  
+ [配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/deployment-considerations.md)  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)   
+ [エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)   
+ [はじめに](../../../../../docs/framework/data/adonet/ef/getting-started.md)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md b/docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md
new file mode 100644
index 00000000000..7e1c3b10d24
--- /dev/null
+++ b/docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md
@@ -0,0 +1,88 @@
+---
+title: "EDM ジェネレーター (EdmGen.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: fe8297a1-1fc3-48ce-8eeb-f70f63f857aa
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# EDM ジェネレーター (EdmGen.exe)
+EdmGen.exe は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] モデルとマッピング ファイルを操作するためのコマンドライン ツールです。  EdmGen.exe ツールを使用すると、次の操作を行うことができます。  
+  
+-   データ ソース固有の .NET Framework データ プロバイダーを使用してデータ ソースに接続し、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で使用される概念モデル \(.csdl\)、ストレージ モデル \(.ssdl\)、およびマッピング \(.msl\) のファイルを生成する。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  
+  
+-   既存のモデルを検証する。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md)」を参照してください。  
+  
+-   概念モデル \(.csdl\) ファイルから生成されたオブジェクト クラスを含む C\# コード ファイルまたは Visual Basic コード ファイルを生成する。  詳細については、「[方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md)」を参照してください。  
+  
+-   事前に生成した既存のモデルのビューを含む C\# コード ファイルまたは Visual Basic コード ファイルを生成する。  詳細については、「[How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)」を参照してください。  
+  
+ EdmGen.exe ツールは [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] ディレクトリにインストールされます。  多くの場合、C:\\windows\\Microsoft.NET\\Framework\\v4.0 にあります。  64 ビット システムの場合は、C:\\windows\\Microsoft.NET\\Framework64\\v4.0 にあります。  Visual Studio のコマンド プロンプトから EdmGen.exe ツールにアクセスすることもできます \(**\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[Microsoft Visual Studio 2010\]**、**\[Visual Studio ツール\]** の順にポイントして、**\[Visual Studio 2010 コマンド プロンプト\]** をクリックします\)。  
+  
+## 構文  
+  
+```  
+EdmGen /mode:choice [options]  
+```  
+  
+## モード  
+ EdmGen.exe ツールを使用する場合、次のいずれかのモードを指定する必要があります。  
+  
+|モード|説明|  
+|---------|--------|  
+|`/mode:ValidateArtifacts`|.csdl、.ssdl、および .msl ファイルを検証し、エラーまたは警告を表示します。<br /><br /> このオプションを使用するには、少なくとも `/inssdl` 引数または `/incsdl` 引数のどちらかが必要です。  `/inmsl` を指定する場合は、`/inssdl` 引数と `/incsdl` 引数も必要です。|  
+|`/mode:FullGeneration`|`/connectionstring` オプションで指定されたデータベース接続情報を使用し、.csdl、.ssdl、.msl、オブジェクト レイヤー、およびビュー ファイルを生成します。<br /><br /> このオプションを使用するには、`/connectionstring` 引数に加え、`/project` 引数を指定するか、`/outssdl`、`/outcsdl`、`/outmsdl`、`/outobjectlayer`、`/outviews`、`/namespace`、`/entitycontainer` の各引数を指定する必要があります。|  
+|`/mode:FromSSDLGeneration`|指定された .ssdl ファイルから、.csdl ファイル、.msl ファイル、ソース コード、およびビューを生成します。<br /><br /> このオプションを使用するには、`/inssdl` 引数に加え、`/project` 引数を指定するか、`/outcsdl`、`/outmsl`、`/outobjectlayer`、`/outviews`、、`/entitycontainer` の各引数を指定する必要があります。|  
+|`/mode:EntityClassGeneration`|.csdl ファイルから生成されたクラスを含むソース コード ファイルを作成します。<br /><br /> このオプションを使用するには、`/incsdl` 引数に加え、`/project` 引数または `/outobjectlayer` 引数のどちらかを指定する必要があります。  `/language` 引数は省略可能です。|  
+|`/mode:ViewGeneration`|.csdl、.ssdl、および .msl ファイルから生成されたビューを含むソース コード ファイルを作成します。<br /><br /> このオプションを使用するには、`/inssdl`、`/incsdl`、 の各引数に加え、`/project` 引数または `/outviews` 引数のどちらかを指定する必要があります。  `/language` 引数は省略可能です。|  
+  
+## オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/p[roject]:`\<string\>|使用するプロジェクト名を指定します。  このプロジェクト名は、名前空間の設定の既定値、モデル ファイルとマッピング ファイルの名前、オブジェクト ソース ファイルの名前、およびビュー生成のソース ファイルの名前として使用されます。  エンティティのコンテナ名が \<project\>Context に設定されています。|  
+|`/prov[ider]:`\<string\>|ストレージ モデル \(.ssdl\) ファイルの生成に使用する [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] データ プロバイダーの名前です。  既定のプロバイダーは [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] Data Provider for SQL Server \(<xref:System.Data.SqlClient?displayProperty=fullName>\) です。|  
+|`/c[onnectionstring]:`\<connection string\>|データ ソースへの接続に使用する文字列を指定します。|  
+|`/incsdl:`\<file\>|.csdl ファイル、または .csdl ファイルがあるディレクトリを指定します。  この引数は複数回指定できるので、複数のディレクトリまたは .csdl ファイルを指定できます。  概念モデルが複数のファイルに分割されている場合にクラスの生成 \(`/mode:EntityClassGeneration`\) またはビューの生成 \(`/mode:ViewGeneration`\) を行うときは、複数のディレクトリを指定すると便利です。  また、複数のモデルを検証する \(`/mode:ValidateArtifacts`\) 場合にも役立ちます。|  
+|`/refcsdl:`\<file\>|追加の .csdl ファイル、またはソース .csdl ファイルの参照の解決に使用するファイルを指定します   \(ソース .csdl ファイルは、`/incsdl` オプションで指定したファイルです\)。  `/refcsdl` ファイルには、ソース .csdl ファイルが依存する型が含まれています。  この引数は複数回指定できます。|  
+|`/inmsl:`\<file\>|.msl ファイル、または .msl ファイルがあるディレクトリを指定します。  この引数は複数回指定できるので、複数のディレクトリまたは .msl ファイルを指定できます。  概念モデルが複数のファイルに分割されている場合にビューを生成 \(`/mode:ViewGeneration`\) するときは、複数のディレクトリを指定すると便利です。  また、複数のモデルを検証する \(`/mode:ValidateArtifacts`\) 場合にも役立ちます。|  
+|`/inssdl:`\<file\>|.ssdl ファイル、または .ssdl ファイルがあるディレクトリを指定します。  この引数は複数回指定できるので、複数のディレクトリまたは .ssdl ファイルを指定できます。  これは、複数のモデルを検証する場合 `(/mode:ValidateArtifacts)` に役立ちます。|  
+|`/outcsdl:`\<file\>|作成される .csdl ファイルの名前を指定します。|  
+|`/outmsl:`\<file\>|作成される .msl ファイルの名前を指定します。|  
+|`/outssdl:`\<file\>|作成される .ssdl ファイルの名前を指定します。|  
+|`/outobjectlayer:`\<file\>|.csdl ファイルから生成されたオブジェクトを含むソース コード ファイルの名前を指定します。|  
+|`/outviews:`\<file\>|生成されたビューを含むソース コード ファイルの名前を指定します。|  
+|`/language:`\[VB&#124;CSharp\]|生成されるソース コード ファイルの言語を指定します。  既定の言語は C\# です。|  
+|`/namespace:`\<string\>|使用するモデル名前空間を指定します。  名前空間は、`/mode:FullGeneration` または `/mode:FromSSDLGeneration` の実行時に .csdl ファイルに設定されます。  `/mode:EntityClassGeneration` の実行時には名前空間は使用されません。|  
+|`/entitycontainer:`\<string\>|生成されたモデル ファイルとマッピング ファイルの `<EntityContainer>` 要素に適用する名前を指定します。|  
+|`/pl[uralize]`|単数形と複数形の英語のルールを、概念モデルの `Entity`、`EntitySet`、および `NavigationProperty` の各名前に適用します。  このオプションでは、以下の処理が実行されます。<br /><br /> -   `EntityType` 名がすべて単数形になります。<br />-   `EntitySet` 名がすべて複数形になります。<br />-   各 `NavigationProperty` が返すエンティティが最大で 1 つの場合、名前は単数形になります。<br />-   各 `NavigationProperty` が返すエンティティが複数の場合、名前は複数形になります。|  
+|`/SupressForeignKeyProperties or /nofk`|外部キー列が概念モデルのエンティティ型のスカラー プロパティとして公開されないようにします。|  
+|`/help` または`?`|このツールのコマンド構文とオプションを表示します。|  
+|`/nologo`|著作権メッセージが表示されないようにします。|  
+|`/targetversion:` \<string\>|生成されたコードのコンパイルに使用される .NET Framework のバージョンです。  サポートされているバージョンは 4 と 4.5 です。  既定値は 4 です。|  
+  
+## このセクションの内容  
+ [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)  
+  
+ [方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md)  
+  
+ [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md)  
+  
+## 参照  
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)   
+ [Entity Data Model](../../../../../docs/framework/data/adonet/entity-data-model.md)   
+ [CSDL、SSDL、および MSL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md b/docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md
new file mode 100644
index 00000000000..beca9faeb4a
--- /dev/null
+++ b/docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md
@@ -0,0 +1,80 @@
+---
+title: "Entity Framework 用の EntityClient プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8c5db787-78e6-4a34-8dc1-188bca0aca5e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Framework 用の EntityClient プロバイダー
+EntityClient プロバイダーは、概念モデルで記述されているデータにアクセスするために Entity Framework アプリケーションで使用するデータ プロバイダーです。  概念モデルの詳細については、「[モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)」を参照してください。  EntityClient は、他の .NET Framework データ プロバイダーを使用してデータ ソースにアクセスします。  たとえば、EntityClient は、SQL Server データベースにアクセスするときは .NET Framework Data Provider for SQL Server \(SqlClient\) を使用します。  SqlClient プロバイダーの詳細については、「[Entity Framework 用 SqlClient](../../../../../docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md)」を参照してください。  EntityClient プロバイダーは <xref:System.Data.EntityClient> 名前空間で実装されます。  
+  
+## 接続の管理  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、基になるデータ プロバイダーおよびリレーショナル データベースに <xref:System.Data.EntityClient.EntityConnection> を提供することにより、ストレージ固有の [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダーに基づいて構築されます。  <xref:System.Data.EntityClient.EntityConnection> オブジェクトを構築するには、必要なモデルとマッピング、さらにストレージ固有のデータ プロバイダー名と接続文字列を含んだ一連のメタデータを参照する必要があります。  <xref:System.Data.EntityClient.EntityConnection> を確立すると、概念モデルから生成されたクラスを使用してエンティティにアクセスできます。  
+  
+ app.config ファイルの接続文字列を指定できます。  
+  
+ <xref:System.Data.EntityClient> には、<xref:System.Data.EntityClient.EntityConnectionStringBuilder> クラスも含まれています。  このクラスを使用すると、開発者はこのクラスのプロパティおよびメソッドを使用することによって、正しい構文の接続文字列をプログラムで作成し、既存の接続文字列の解析や再作成を行うことができます。  詳細については、「[EntityConnection の接続文字列を作成する方法](../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)」を参照してください。  
+  
+## クエリの作成  
+ [!INCLUDE[esql](../../../../../includes/esql-md.md)] 言語は、エンティティの概念スキーマを直接操作し、継承やリレーションシップなどの Entity Data Model 概念をサポートする、ストレージの影響を受けない SQL の言語です。  エンティティ モデルに対して [!INCLUDE[esql](../../../../../includes/esql-md.md)] コマンドを実行するには、<xref:System.Data.EntityClient.EntityCommand> クラスを使用します。  <xref:System.Data.EntityClient.EntityCommand> オブジェクトを構築する場合は、ストアド プロシージャ名またはクエリ テキストを指定できます。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、ストレージ固有のデータ プロバイダーと連携し、汎用的な [!INCLUDE[esql](../../../../../includes/esql-md.md)] をストレージ固有のクエリに変換します。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリ記述の詳細については、「[Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)」を参照してください。  
+  
+ 次の例では、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを作成し、[!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリ テキストを <xref:System.Data.EntityClient.EntityCommand.CommandText%2A?displayProperty=fullName> プロパティに割り当てます。  この [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリは、概念モデルから表示価格で並べ替えた製品を要求します。  次のコードでは、ストレージ モデルが認識されません。  
+  
+ `EntityCommand cmd = conn.CreateCommand();`  
+  
+ `cmd.CommandText = @"` `SELECT VALUE p`  
+  
+ `FROM AdventureWorksEntities.Product AS p`  
+  
+ `ORDER BY p.ListPrice ";`  
+  
+## クエリの実行  
+ クエリを実行すると、そのクエリが解析され、正規コマンド ツリーに変換されます。  すべての後続の処理は、コマンド ツリーで行われます。  コマンド ツリーは <xref:System.Data.SqlClient> など、<xref:System.Data.EntityClient> と基になる [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] データ プロバイダー間の通信手段です。  
+  
+ 概念モデルに対する <xref:System.Data.EntityClient.EntityCommand> の実行結果は、<xref:System.Data.EntityClient.EntityDataReader> によって公開されます。  <xref:System.Data.EntityClient.EntityDataReader> を返すコマンドを実行するには、<xref:System.Data.EntityClient.EntityCommand.ExecuteReader%2A> を呼び出します。  <xref:System.Data.EntityClient.EntityDataReader> は、構造化されたさまざまな結果を記述するための <xref:System.Data.IExtendedDataRecord> を実装します。  
+  
+## トランザクションの管理  
+ Entity Framework では、自動トランザクションと明示的トランザクションという 2 つの使用方法があります。  自動トランザクションでは <xref:System.Transactions> 名前空間を使用し、明示的トランザクションでは <xref:System.Data.EntityClient.EntityTransaction> クラスを使用します。  
+  
+ 概念モデル経由で公開されたデータを更新するには、「[How to: Manage Transactions in the Entity Framework](http://msdn.microsoft.com/ja-jp/4a55eb7f-f826-4a48-9df1-aebe2352ebef)」を参照してください。  
+  
+## このセクションの内容  
+ [EntityConnection の接続文字列を作成する方法](../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)  
+  
+ [PrimitiveType 結果を返すクエリの実行方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)  
+  
+ [StructuralType 結果を返すクエリの実行方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)  
+  
+ [RefType 結果を返すクエリの実行方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-reftype-results.md)  
+  
+ [複合型を返すクエリの実行方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md)  
+  
+ [入れ子になったコレクションを返すクエリの実行方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-nested-collections.md)  
+  
+ [EntityCommand を使用してパラメーター化 Entity SQL クエリを実行する方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md)  
+  
+ [EntityCommand を使用してパラメーター化されたストアド プロシージャを実行する方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md)  
+  
+ [ポリモーフィック クエリを実行する方法](../../../../../docs/framework/data/adonet/ef/how-to-execute-a-polymorphic-query.md)  
+  
+ [Navigate 演算子でリレーションシップをナビゲートする方法](../../../../../docs/framework/data/adonet/ef/how-to-navigate-relationships-with-the-navigate-operator.md)  
+  
+## 参照  
+ [Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)   
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)   
+ [言語リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md b/docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md
new file mode 100644
index 00000000000..be6aee0bebc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md
@@ -0,0 +1,149 @@
+---
+title: "コマンド ツリーからの SQL の生成: ベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 71ef6a24-4c4f-4254-af3a-ffc0d855b0a8
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# コマンド ツリーからの SQL の生成: ベスト プラクティス
+出力クエリ コマンド ツリーは、SQL で表現できるクエリに厳密に従って作成されます。  ただし、出力コマンド ツリーから SQL を生成する際にプロバイダーの作成者が直面する、一般的な問題がいくつかあります。  このトピックでは、これらの問題について説明します。  これらの問題への対処方法については、次のトピックでサンプル プロバイダーを介して紹介します。  
+  
+## SQL SELECT ステートメントでの DbExpression ノードのグループ化  
+ 一般的な SQL ステートメントは、次の形状の入れ子の構造を持ちます。  
+  
+```  
+SELECT …  
+FROM …  
+WHERE …  
+GROUP BY …  
+ORDER BY …  
+```  
+  
+ 1 つ以上の句が空でもかまいません。  入れ子の SELECT ステートメントは、どの行にも出現する可能性があります。  
+  
+ クエリ コマンド ツリーを SQL SELECT ステートメントに変換すると、すべての関係演算子に対応する 1 つのサブクエリが生成されます。  ただしその結果、入れ子になった不要なサブクエリが生成され、読み取りが困難になります。  一部のデータ ストアでは、クエリは十分なパフォーマンスを発揮しません。  
+  
+ 例として、次のクエリ コマンド ツリーについて考えます。  
+  
+```  
+Project (  
+a.x,  
+   a = Filter(  
+      b.y = 5,   
+      b = Scan("TableA")  
+   )  
+)  
+```  
+  
+ 非効率な変換を行った場合、次のような SQL が生成されます。  
+  
+```  
+SELECT a.x  
+FROM (   SELECT *  
+         FROM TableA as b  
+         WHERE b.y = 5) as a  
+```  
+  
+ すべての関係式ノードが新しい SQL SELECT ステートメントになっていることに注目してください。  
+  
+ そのため、正確性を維持しながら、可能な限り多くの式ノードを 1 つの SQL SELECT ステートメントに集約することが重要になります。  
+  
+ このような集約を上の例に適用した場合、結果は次のようになります。  
+  
+```  
+SELECT b.x   
+FROM TableA as b  
+WHERE b.y = 5  
+```  
+  
+## SQL SELECT ステートメントでの結合のフラット化  
+ 複数のノードを 1 つの SQL SELECT ステートメントに集約する処理の 1 つに、1 つの SQL SELECT ステートメントへの複数の結合式の集約があります。  DbJoinExpression は、2 つの入力の間の 1 つの結合を表します。  ただし、1 つの SQL SELECT ステートメントの一部として、複数の結合を指定できます。  その場合、結合は指定の順序で実行されます。  
+  
+ 左辺スパイン結合 \(別の結合の左辺の子として表示される結合\) は、1 つの SQL SELECT ステートメントに簡単にフラット化できます。  たとえば、次のクエリ コマンド ツリーについて考えます。  
+  
+```  
+InnerJoin(  
+   a = LeftOuterJoin(  
+   b = Extent("TableA")  
+   c = Extent("TableB")  
+   ON b.y = c.x ),  
+   d = Extent("TableC")   
+   ON a.b.y = d.z  
+)  
+```  
+  
+ これは、次のように適切に変換できます。  
+  
+```  
+SELECT *  
+FROM TableA as b  
+LEFT OUTER JOIN TableB as c ON b.y = c.x  
+INNER JOIN TableC as d ON b.y = d.z  
+```  
+  
+ ただし、左辺スパイン結合以外の結合のフラット化は容易ではないので、実行しないでください。  たとえば、次のクエリ コマンド ツリーの結合について考えます。  
+  
+```  
+InnerJoin(  
+   a = Extent("TableA")   
+   b = LeftOuterJoin(  
+   c = Extent("TableB")  
+   d = Extent("TableC")  
+   ON c.y = d.x),  
+   ON a.z = b.c.y  
+)  
+```  
+  
+ これは、サブクエリを持つ SQL SELECT ステートメントに変換されます。  
+  
+```  
+SELECT *  
+FROM TableA as a  
+INNER JOIN (SELECT *   
+   FROM TableB as c   
+   LEFT OUTER JOIN TableC as d  
+   ON c.y = d.x) as b  
+ON b.y = d.z  
+```  
+  
+## 入力の別名のリダイレクト  
+ 入力の別名のリダイレクトについて理解するために、DbFilterExpression、DbProjectExpression、DbCrossJoinExpression、DbJoinExpression、DbSortExpression、DbGroupByExpression、DbApplyExpression、DbSkipExpression などの関係式の構造について考えてみましょう。  
+  
+ これらの型はそれぞれ、入力コレクションを示す 1 つ以上の入力プロパティを持ちます。各入力に対応するバインディング変数は、コレクションのトラバース時にその入力の各要素を表すために使用されます。  バインディング変数は、DbFilterExpression の Predicate プロパティや DbProjectExpression の Projection プロパティなどにおいて、入力要素を参照するときに使用されます。  
+  
+ 多数の関係式ノードを 1 つの SQL SELECT ステートメントに集約し、関係式の一部 \(たとえば、DbProjectExpression の Projection プロパティの一部\) である式を評価する場合、複数の式のバインディングを 1 つのエクステントにリダイレクトする必要があるため、使用されるバインディング変数が入力の別名と異なる可能性があります。  この問題は、別名の名前変更と呼ばれます。  
+  
+ このトピックの最初の例について考えてみてください。  単純な変換を実行して Projection a.x \(DbPropertyExpression\(a, x\)\) を変換する場合、バインディング変数に合わせて入力に "a" という別名を設定しているため、`a.x` に変換するのが適切な処理です。  ただし、両方のノードを 1 つの SQL SELECT ステートメントに集約する場合は、入力に "b" という別名が設定されているため、同じ DbPropertyExpression を `b.x` に変換する必要があります。  
+  
+## 結合の別名のフラット化  
+ 出力コマンド ツリーの他の関係式とは異なり、DbJoinExpression は 2 つの列から成る行として結果の型を出力します。この 2 つの列のそれぞれが、いずれか 1 つの入力に対応しています。  結合から生じたスカラー プロパティにアクセスするために作成された DbPropertyExpresssion は、別の DbPropertyExpresssion に基づいています。  
+  
+ 例として、例 2 の "a.b.y" と例 3 の "b.c.y" が挙げられます。  ただし、対応する SQL ステートメントでは、これらは "b.y" になります。  この別名の再設定は、結合の別名のフラット化と呼ばれます。  
+  
+## 列名およびエクステントの別名の名前変更  
+ 結合を持つ SQL SELECT クエリを射影を使用して完成させる必要がある場合、関与するすべての列を入力から列挙する際に、名前の競合が発生することがあります。これは、複数の入力が同じ列名を持っている場合です。  競合を避けるには、列に異なる名前を使用してください。  
+  
+ また、結合のフラット化の際にも、関与するテーブル \(またはサブクエリ\) の別名が競合することがあります。この場合にも名前の変更が必要です。  
+  
+## SELECT \* の回避  
+ ベース テーブルから選択する際には `SELECT *` を使用しないでください。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションのストレージ モデルでは、データベース テーブル内の列のサブセットのみを含めることができます。  この場合、`SELECT *` によって正しくない結果が生成される可能性があります。  代わりに、関与する式の結果の型の列名を使用して、関与するすべての列を指定してください。  
+  
+## 式の再利用  
+ 式は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって渡されたクエリ コマンド ツリーで再利用される場合があります。各式は一度しかクエリ コマンド ツリーに表示されないわけではありません。  
+  
+## プリミティブ型のマッピング  
+ 概念 \(EDM\) 型をプロバイダー型にマップする場合は、さまざまな値に対応できるように、最も幅の広い型 \(Int32\) にマップする必要があります。  また、BLOB 型のような、多様な操作に使用できない型 \([!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の `ntext` など\) にマップすることは避けてください。  
+  
+## 参照  
+ [SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/getting-started.md b/docs/framework/data/adonet/ef/getting-started.md
new file mode 100644
index 00000000000..684951d342e
--- /dev/null
+++ b/docs/framework/data/adonet/ef/getting-started.md
@@ -0,0 +1,29 @@
+---
+title: "はじめに (Entity Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 4735a220-3301-4ec4-8833-7209abb7208f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# はじめに (Entity Framework)
+[!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、データ中心のアプリケーションとサービスをサポートし、抽象化のレベルを論理リレーショナル レベルから概念レベルに引き上げるようなデータに対するプログラミングのためのプラットフォームを提供します。  抽象化レベルの高いデータを開発者が操作できるように、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は特定のデータ ストレージ エンジンまたはリレーショナル スキーマに依存しないコードをサポートします。詳細については、「[エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)」を参照してください。  
+  
+ 最新バージョンの Entity Framework の使用を今すぐ開始するには、「[使用の開始](http://go.microsoft.com/fwlink/?LinkId=235280)」を参照してください。  
+  
+## 参照  
+ [Entity Framework](http://go.microsoft.com/fwlink/?LinkID=234900&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md b/docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md
new file mode 100644
index 00000000000..083b8c515d9
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md
@@ -0,0 +1,45 @@
+---
+title: "EntityConnection の接続文字列を作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 5bd1a748-3df7-4d0a-a607-14f25e3175e9
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# EntityConnection の接続文字列を作成する方法
+このトピックでは、<xref:System.Data.EntityClient.EntityConnection> を作成する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ 次の例では、基になるプロバイダーの <xref:System.Data.SqlClient.SqlConnectionStringBuilder?displayProperty=fullName> を初期化した後、<xref:System.Data.EntityClient.EntityConnectionStringBuilder?displayProperty=fullName> オブジェクトを初期化して、このオブジェクトを <xref:System.Data.EntityClient.EntityConnection> のコンストラクターに渡しています。  
+  
+ [!code-csharp[DP EntityServices Concepts#BuildingConnectionStringWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#buildingconnectionstringwithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#BuildingConnectionStringWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#buildingconnectionstringwithentitycommand)]  
+  
+## 参照  
+ [How to: Use EntityConnection with an Object Context](http://msdn.microsoft.com/ja-jp/2140fe7b-b88b-47c8-a749-d7f142eb1080)   
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-define-the-connection-string.md b/docs/framework/data/adonet/ef/how-to-define-the-connection-string.md
new file mode 100644
index 00000000000..412fcf8297f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-define-the-connection-string.md
@@ -0,0 +1,42 @@
+---
+title: "接続文字列を定義する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 6027335d-4e26-420d-9151-6523289b1989
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 接続文字列を定義する方法
+このトピックでは、概念モデルに接続するための接続文字列を定義する方法について説明します。  このトピックには、[AdventureWorks Sales](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) 概念モデルが使用されています。  AdventureWorks Sales Model は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] ドキュメントのタスク関連のトピック全般で使用されます。  このトピックでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の構成が済んでいること、および AdventureWorks Sales Model が定義済みであることを前提としています。  詳細については、「[How to: Manually Define the Model and Mapping Files](http://msdn.microsoft.com/ja-jp/d4fd6864-f2a1-48f0-aa32-1e318775a99a)」を参照してください。  このトピックの手順は、「[How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)」にも記載されています。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] プロジェクトで [!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ウィザードを使用した場合、自動的に .edmx ファイルが生成され、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトが構成されます。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+### Entity Framework 接続文字列を定義するには  
+  
+-   プロジェクトのアプリケーション構成ファイル \(app.config\) を開き、次の接続文字列を追加します。  
+  
+  
+  
+     プロジェクトにアプリケーション構成ファイルが存在しない場合は、**\[プロジェクト\]** メニューの **\[新しい項目の追加\]** を選択し、**\[全般\]** カテゴリの **\[アプリケーション構成ファイル\]** を選択して、**\[追加\]** をクリックすることによって追加できます。  
+  
+## 参照  
+ [Quickstart](http://msdn.microsoft.com/ja-jp/0bc534be-789f-4819-b9f6-76e51d961675)   
+ [How to: Create a New .edmx File](http://msdn.microsoft.com/ja-jp/beb8189e-e51c-4051-839c-9902c224abf2)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md b/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md
new file mode 100644
index 00000000000..6c3f2dc8371
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md
@@ -0,0 +1,45 @@
+---
+title: "EntityCommand を使用してパラメーター化 Entity SQL クエリを実行する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: e93fea43-7e03-4d7d-9fee-2517b8b88cba
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# EntityCommand を使用してパラメーター化 Entity SQL クエリを実行する方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを使用して、パラメーター付きの [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリを実行する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ 次の例では、2 つのパラメーターを持つクエリ文字列を作成する方法を示します。  次に、<xref:System.Data.EntityClient.EntityCommand> を作成した後、2 つのパラメーターを <xref:System.Data.EntityClient.EntityCommand> の <xref:System.Data.EntityClient.EntityParameter> コレクションに追加し、`Contact` アイテムのコレクションに対して反復処理を実行します。  
+  
+ [!code-csharp[DP EntityServices Concepts#ParameterizedQueryWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#parameterizedquerywithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#ParameterizedQueryWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#parameterizedquerywithentitycommand)]  
+  
+## 参照  
+ [How to: Execute a Parameterized Query](http://msdn.microsoft.com/ja-jp/42048f03-c65c-4d98-b50a-3e7d537a63e8)   
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md b/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md
new file mode 100644
index 00000000000..6cf4c054e57
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md
@@ -0,0 +1,46 @@
+---
+title: "EntityCommand を使用してパラメーター化されたストアド プロシージャを実行する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 4f5639bf-bb7f-4982-bb1d-c7caa4348888
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# EntityCommand を使用してパラメーター化されたストアド プロシージャを実行する方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> クラスを使用して、パラメーター化されたストアド プロシージャを実行する方法を示します。  
+  
+### この例のコードを実行するには  
+  
+1.  [School Model](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+3.  `GetStudentGrades` ストアド プロシージャをインポートし、戻り値の型として `CourseGrade` エンティティを指定します。  ストアド プロシージャのインポート方法の詳細については、「[How to: Import a Stored Procedure](http://msdn.microsoft.com/ja-jp/24e68bf4-bd6d-428d-bc35-92d7b8e3736d)」を参照してください。  
+  
+## 使用例  
+ 次のコードでは、`GetStudentGrades` ストアド プロシージャが実行されます。`StudentId` は必須パラメーターです。  結果は <xref:System.Data.EntityClient.EntityDataReader> によって読み取られます。  
+  
+ [!code-csharp[DP EntityServices Concepts#StoredProcWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#storedprocwithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#StoredProcWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#storedprocwithentitycommand)]  
+  
+## 参照  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-polymorphic-query.md b/docs/framework/data/adonet/ef/how-to-execute-a-polymorphic-query.md
new file mode 100644
index 00000000000..49c18aa8a5e
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-polymorphic-query.md
@@ -0,0 +1,47 @@
+---
+title: "ポリモーフィック クエリを実行する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 2f05da1e-845b-4f14-83e4-c6353a850553
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ポリモーフィック クエリを実行する方法
+このトピックでは、[OFTYPE](../../../../../docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md) 演算子を使ってポリモーフィックな [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリを実行する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [School Model](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac) をプロジェクトに追加し、Entity Framework が使用されるようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+3.  概念モデルを変更して、Table\-Per\-Hierarchy 継承を持つようにします。そのためには、「[Walkthrough: Mapping Inheritance \- Table\-per\-Hierarchy](http://msdn.microsoft.com/ja-jp/49b685cf-9db8-4d6d-b885-8837ed238f55)」で説明されている手順に従います。  
+  
+## 使用例  
+ 次の例では、OFTYPE 演算子を使用し、`Courses` のコレクションから `OnsiteCourses` のコレクションだけを取得して表示します。  
+  
+ [!code-csharp[DP EntityServices Concepts#PolymorphicQuery](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#polymorphicquery)]
+ [!code-vb[DP EntityServices Concepts#PolymorphicQuery](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#polymorphicquery)]  
+  
+## 参照  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)   
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md
new file mode 100644
index 00000000000..457f50c824e
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md
@@ -0,0 +1,47 @@
+---
+title: "複合型を返すクエリの実行方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: c2209fdb-70ef-4dea-8bb8-097fe96f5563
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 複合型を返すクエリの実行方法
+このトピックでは、複合型プロパティを含むエンティティ型オブジェクトを返す [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリを実行する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+3.  .edmx ファイルをダブルクリックして、エンティティ デザイナーの [&#91;モデル ブラウザー&#93; ウィンドウ](http://msdn.microsoft.com/ja-jp/94e836e8-a5ea-47ff-aa3e-599d8a02ebfd)にモデルを表示します。  エンティティ デザイナー画面で、`Contact` エンティティ型の `Email` プロパティと `Phone` プロパティを選択し、右クリックして **\[新しい複合型へのリファクター\]** を選択します。  
+  
+4.  選択した `Email` プロパティと `Phone` プロパティの新しい複合型が**モデル ブラウザー**に追加されます。  複合型には既定の名前が付きます。**プロパティ** ウィンドウで型の名前を `EmailPhone` に変更します。  また、新しい `ComplexProperty` プロパティが `Contact` エンティティ型に追加されます。  プロパティの名前を  に変更します。  
+  
+     Entity Data Model ウィザードを使用した複合型の作成と変更の詳細については、「[How to: Refactor Existing Properties into a Complex Type Property](http://msdn.microsoft.com/ja-jp/5b2eb3b3-693d-42cb-b43a-405812d677eb)」および「[How to: Create and Modify Complex Types](http://msdn.microsoft.com/ja-jp/afb8e206-0ffe-4597-b6d4-6ab566897e1d)」を参照してください。  
+  
+## 使用例  
+ 次の例は、`Contact` オブジェクトのコレクションを返し、`Contact`  オブジェクトの 2 つのプロパティとして `ContactID` と `EmailPhoneComplexType` 複合型の値を表示するクエリを実行します。  
+  
+ [!code-csharp[DP EntityServices Concepts#ComplexTypeWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#complextypewithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#ComplexTypeWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#complextypewithentitycommand)]
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-nested-collections.md b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-nested-collections.md
new file mode 100644
index 00000000000..61bbc287cdd
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-nested-collections.md
@@ -0,0 +1,44 @@
+---
+title: "入れ子になったコレクションを返すクエリの実行方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: f7f385f3-ffcf-4f3b-af35-de8818938e5f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 入れ子になったコレクションを返すクエリの実行方法
+ここでは、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを使用して概念モデルに対してコマンドを実行する方法、および <xref:System.Data.EntityClient.EntityDataReader> を使用して入れ子になったコレクションの結果を取得する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ *入れ子になったコレクション*とは、別のコレクションに含まれているコレクションのことです。  次に示すコードでは、`Contact` のコレクションと、それぞれの `Contact` に関連付けられている、`SalesOrderHeader` の入れ子になったコレクションを取得します。  
+  
+ [!code-csharp[DP EntityServices Concepts#ReturnNestedCollectionWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#returnnestedcollectionwithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#ReturnNestedCollectionWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#returnnestedcollectionwithentitycommand)]  
+  
+## 参照  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md
new file mode 100644
index 00000000000..d6492a4ea5c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md
@@ -0,0 +1,53 @@
+---
+title: "PrimitiveType 結果を返すクエリの実行方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 7139d585-4034-4dfa-916f-2120a8b72792
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# PrimitiveType 結果を返すクエリの実行方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> を使用して概念モデルに対してコマンドを実行する方法と、<xref:System.Data.EntityClient.EntityDataReader> を使用して <xref:System.Data.Metadata.Edm.PrimitiveType> の結果を取得する方法について説明します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ この例は、<xref:System.Data.Metadata.Edm.PrimitiveType> の結果を返すクエリを実行します。  次のクエリを引数として `ExecutePrimitiveTypeQuery` 関数に渡すと、関数は、すべての `Products` の平均表示価格を表示します。  
+  
+ [!code-csharp[DP EntityServices Concepts#EDM_AVG](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_avg)]
+ [!code-sql[DP EntityServices Concepts#EDM_AVG](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_avg)]  
+  
+ パラメーター化されたクエリを渡す場合は、次のように、<xref:System.Data.EntityClient.EntityCommand> オブジェクトの <xref:System.Data.EntityClient.EntityCommand.Parameters%2A> プロパティに <xref:System.Data.EntityClient.EntityParameter> オブジェクトを追加します。  
+  
+ [!code-csharp[DP EntityServices Concepts#CASE_WHEN_THEN_ELSE](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#case_when_then_else)]
+ [!code-sql[DP EntityServices Concepts#CASE_WHEN_THEN_ELSE](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#case_when_then_else)]  
+  
+ [!code-csharp[DP EntityServices Concepts#eSQLPrimitiveTypes](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#esqlprimitivetypes)]
+ [!code-vb[DP EntityServices Concepts#eSQLPrimitiveTypes](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#esqlprimitivetypes)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-reftype-results.md b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-reftype-results.md
new file mode 100644
index 00000000000..2460821d026
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-reftype-results.md
@@ -0,0 +1,53 @@
+---
+title: "RefType 結果を返すクエリの実行方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 7dbbfbcd-93f5-4546-9dbf-e5fa290b69fa
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# RefType 結果を返すクエリの実行方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを使用して概念モデルに対してコマンドを実行する方法と、<xref:System.Data.EntityClient.EntityDataReader> を使用して <xref:System.Data.Metadata.Edm.RefType> の結果を取得する方法を示します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ この例は、<xref:System.Data.Metadata.Edm.RefType> の結果を返すクエリを実行します。  次のクエリを引数として `ExectueRefTypeQuery` 関数に渡すと、関数はエンティティへの参照を返します。  
+  
+ [!code-csharp[DP EntityServices Concepts#REF2](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#ref2)]
+ [!code-sql[DP EntityServices Concepts#REF2](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#ref2)]  
+  
+ パラメーター化されたクエリを渡す場合は、次のように、<xref:System.Data.EntityClient.EntityCommand> オブジェクトの <xref:System.Data.EntityClient.EntityCommand.Parameters%2A> プロパティに <xref:System.Data.EntityClient.EntityParameter> オブジェクトを追加します。  
+  
+ [!code-csharp[DP EntityServices Concepts#REF3](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#ref3)]
+ [!code-sql[DP EntityServices Concepts#REF3](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#ref3)]  
+  
+ [!code-csharp[DP EntityServices Concepts#eSQLRefTypes](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#esqlreftypes)]
+ [!code-vb[DP EntityServices Concepts#eSQLRefTypes](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#esqlreftypes)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md
new file mode 100644
index 00000000000..cbcf266ad8f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md
@@ -0,0 +1,53 @@
+---
+title: "StructuralType 結果を返すクエリの実行方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 2314f2a2-b1c3-40c4-95bb-cdf9b21a7b53
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# StructuralType 結果を返すクエリの実行方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを使用して概念モデルに対してコマンドを実行する方法と、<xref:System.Data.EntityClient.EntityDataReader> を使用して <xref:System.Data.Metadata.Edm.StructuralType> の結果を取得する方法を示します。  <xref:System.Data.Metadata.Edm.EntityType>、<xref:System.Data.Metadata.Edm.RowType> および <xref:System.Data.Metadata.Edm.ComplexType> クラスは、<xref:System.Data.Metadata.Edm.StructuralType> クラスから派生します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ この例は、<xref:System.Data.Metadata.Edm.EntityType> の結果を返すクエリを実行します。  次のクエリを引数として `ExecuteStructuralTypeQuery` 関数に渡すと、この関数は、`Products` に関する詳細を表示します。  
+  
+ [!code-csharp[DP EntityServices Concepts#SelectProduct](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#selectproduct)]
+ [!code-sql[DP EntityServices Concepts#SelectProduct](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#selectproduct)]  
+  
+ パラメーター化されたクエリを渡す場合は、次のように、<xref:System.Data.EntityClient.EntityCommand> オブジェクトの <xref:System.Data.EntityClient.EntityCommand.Parameters%2A> プロパティに <xref:System.Data.EntityClient.EntityParameter> オブジェクトを追加します。  
+  
+ [!code-csharp[DP EntityServices Concepts#GREATER_OR_EQUALS](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#greater_or_equals)]
+ [!code-sql[DP EntityServices Concepts#GREATER_OR_EQUALS](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#greater_or_equals)]  
+  
+ [!code-csharp[DP EntityServices Concepts#eSQLStructuralTypes](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#esqlstructuraltypes)]
+ [!code-vb[DP EntityServices Concepts#eSQLStructuralTypes](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#esqlstructuraltypes)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-make-model-and-mapping-files-embedded-resources.md b/docs/framework/data/adonet/ef/how-to-make-model-and-mapping-files-embedded-resources.md
new file mode 100644
index 00000000000..27ea286a779
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-make-model-and-mapping-files-embedded-resources.md
@@ -0,0 +1,58 @@
+---
+title: "モデル ファイルとマッピング ファイルを組み込みリソースにする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 20dfae4d-e95a-4264-9540-f5ad23b462d3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# モデル ファイルとマッピング ファイルを組み込みリソースにする方法
+[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用すると、モデル ファイルとマッピング ファイルをアプリケーションの組み込みリソースとして配置できます。  モデル ファイルとマッピング ファイルが組み込まれたアセンブリは、エンティティ接続と同じアプリケーション ドメインに読み込む必要があります。  詳細については、「[接続文字列](../../../../../docs/framework/data/adonet/ef/connection-strings.md)」を参照してください。  既定では、[!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ツールが、モデル ファイルとマッピング ファイルを組み込みます。モデル ファイルとマッピング ファイルを手動で定義する場合は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションと共にモデル ファイルとマッピング ファイルが組み込みリソースとして確実に配置されるように、この手順を使用します。  
+  
+> [!NOTE]
+>  組み込みリソースを保持するには、モデル ファイルとマッピング ファイルを変更するたびに、この手順を繰り返す必要があります。  
+  
+### モデル ファイルとマッピング ファイルを組み込むには  
+  
+1.  **ソリューション エクスプローラー**で、概念 \(.csdl\) ファイルを選択します。  
+  
+2.  **\[プロパティ\]** ペインで、**\[ビルド アクション\]** を **\[組み込まれたリソース\]** に設定します。  
+  
+3.  ストレージ \(.ssdl\) ファイルとマッピング \(.msl\) ファイルに対して手順 1. と手順 2. を繰り返します。  
+  
+4.  **ソリューション エクスプローラー**で、App.config ファイルをダブルクリックし、次のいずれかの形式に基づいて `connectionString` 属性の `Metadata` パラメーターを変更します。  
+  
+    -   `Metadata=` `res://<assemblyFullName>/<resourceName>;`  
+  
+    -   `Metadata=` `res://*/<resourceName>;`  
+  
+    -   `Metadata=res://*;`  
+  
+     詳細については、「[接続文字列](../../../../../docs/framework/data/adonet/ef/connection-strings.md)」を参照してください。  
+  
+## 使用例  
+ 次の接続文字列は、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) の組み込みモデル ファイルとマッピング ファイルを参照しています。  この接続文字列は、プロジェクトの App.config ファイルに格納されています。  
+  
+  
+  
+## 参照  
+ [モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)   
+ [接続文字列を定義する方法](../../../../../docs/framework/data/adonet/ef/how-to-define-the-connection-string.md)   
+ [EntityConnection の接続文字列を作成する方法](../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-navigate-relationships-with-the-navigate-operator.md b/docs/framework/data/adonet/ef/how-to-navigate-relationships-with-the-navigate-operator.md
new file mode 100644
index 00000000000..40bc16ffd2c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-navigate-relationships-with-the-navigate-operator.md
@@ -0,0 +1,45 @@
+---
+title: "Navigate 演算子でリレーションシップをナビゲートする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 79996d2d-9b03-4a9d-82cc-7c5e7c2ad93d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Navigate 演算子でリレーションシップをナビゲートする方法
+このトピックでは、<xref:System.Data.EntityClient.EntityCommand> オブジェクトを使用して概念モデルに対してコマンドを実行する方法と、<xref:System.Data.EntityClient.EntityDataReader> を使用して <xref:System.Data.Metadata.Edm.RefType> の結果を取得する方法を示します。  
+  
+### この例のコードを実行するには  
+  
+1.  [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) をプロジェクトに追加して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するようにプロジェクトを構成します。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+2.  アプリケーションのコード ページで、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#namespaces)]
+     [!code-vb[DP EntityServices Concepts#Namespaces](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#namespaces)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[esql](../../../../../includes/esql-md.md)] で [NAVIGATE](../../../../../docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md) 演算子を使用してリレーションシップをナビゲートする方法を示しています。`Navigate` 演算子は、エンティティのインスタンス、リレーションシップの種類、リレーションシップの終端エンティティ、およびリレーションシップの開始エンティティをパラメーターとして受け取ります。  オプションとして、エンティティのインスタンスとリレーションシップ型だけを `Navigate` 演算子に渡すこともできます。  
+  
+ [!code-csharp[DP EntityServices Concepts#NavigateWithNavOperatorWithEntityCommand](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/source.cs#navigatewithnavoperatorwithentitycommand)]
+ [!code-vb[DP EntityServices Concepts#NavigateWithNavOperatorWithEntityCommand](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp entityservices concepts/vb/source.vb#navigatewithnavoperatorwithentitycommand)]  
+  
+## 参照  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)   
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md
new file mode 100644
index 00000000000..98903bc57c7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md
@@ -0,0 +1,59 @@
+---
+title: "方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: c44d2ebe-f66f-42cb-9741-4a3f0c2dcffb
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する
+このトピックでは、[EDM ジェネレーター \(EdmGen.exe\)](../../../../../docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md) ツールを使用して、.csdl ファイルに基づくオブジェクトレイヤー コードを生成する方法について説明します。  
+  
+### EdmGen.exe を使用して Visual Basic プロジェクト用の School モデルのオブジェクトレイヤー コードを生成するには  
+  
+1.  School データベースを作成します。  詳細については、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」を参照してください。  
+  
+2.  School モデルを生成するか、School.csdl ファイルを取得します。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  
+  
+3.  コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v4.0.30319\edmgen.exe" /mode:EntityClassGeneration   
+    /incsdl:.\School.csdl /outobjectlayer:.\School.Objects.vb /language:VB  
+    ```  
+  
+### EdmGen.exe を使用して C\# プロジェクト用の School モデルのオブジェクトレイヤー コードを生成するには  
+  
+1.  School データベースを作成します。  詳細については、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」を参照してください。  
+  
+2.  School モデルを生成するか、School.csdl ファイルを取得します。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  
+  
+3.  コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v4.0.30319\edmgen.exe" /mode:EntityClassGeneration   
+    /incsdl:.\School.csdl /outobjectlayer:.\School.Objects.cs /language:CSharp  
+    ```  
+  
+## 参照  
+ [モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)   
+ [How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)   
+ [How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)   
+ [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md
new file mode 100644
index 00000000000..0a2925aa9fa
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md
@@ -0,0 +1,75 @@
+---
+title: "方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 40db462d-2fd2-4cc1-ad86-d280403e63fa
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する
+このトピックでは、EDM ジェネレーター \(EdmGen.exe\) ツールを使用して、School データベースに基づく次のファイルを生成する方法について説明します。  
+  
+-   概念モデル \(.csdl ファイル\)  
+  
+-   ストレージ モデル \(.ssdl ファイル\)  
+  
+-   概念モデルとストレージ モデル間のマッピング \(.msl ファイル\)  
+  
+-   Visual Basic または C\# のオブジェクト レイヤー コード  
+  
+-   ビュー ファイル  
+  
+ EdmGen.exe ツールでは、\/mode:FullGeneration を使用して上記のファイルを生成します。  EdemGen.exe コマンドの詳細については、「[EDM ジェネレーター \(EdmGen.exe\)](../../../../../docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md)」を参照してください。  
+  
+ EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する場合は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するように [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] プロジェクトを構成する必要もあります。  詳細については、「[How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)」を参照してください。  
+  
+> [!NOTE]
+>  EdmGen.exe によって生成された概念モデルには、データベース内のすべてのオブジェクトが含まれています。  特定のオブジェクトだけを含んだ概念モデルを生成する場合は、Entity Data Model ウィザードを使用してください。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+### EdmGen.exe を使用して Visual Basic プロジェクト用の School モデルを生成するには  
+  
+1.  School データベースを作成します。  詳細については、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」を参照してください。  
+  
+2.  コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v4.0.30319\edmgen.exe" /mode:fullgeneration   
+    /c:"Data Source=%datasourceserver%; Initial Catalog=School; Integrated Security=SSPI"   
+    /project:School /entitycontainer:SchoolEntities /namespace:SchoolModel /language:VB  
+  
+    ```  
+  
+### EdmGen.exe を使用して C\# プロジェクト用の School モデルを生成するには  
+  
+1.  School データベースを作成します。  詳細については、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」を参照してください。  
+  
+2.  コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v4.0.30319\edmgen.exe" /mode:fullgeneration   
+    /c:"Data Source=%datasourceserver%; Initial Catalog=School; Integrated Security=SSPI"   
+    /project:School /entitycontainer:SchoolEntities /namespace:SchoolModel /language:CSharp  
+    ```  
+  
+## 参照  
+ [モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)   
+ [How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)   
+ [How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)   
+ [方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md
new file mode 100644
index 00000000000..bb1583cd509
--- /dev/null
+++ b/docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-validate-model-and-mapping-files.md
@@ -0,0 +1,44 @@
+---
+title: "方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: 2641906a-971a-4d0b-8aee-13fabc02a1cc
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを検証する
+このトピックでは、[EDM ジェネレーター \(EdmGen.exe\)](../../../../../docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md) ツールを使用してモデル ファイルとマッピング ファイルを検証する方法を示します。  詳細については、「[Entity Data Model](../../../../../docs/framework/data/adonet/entity-data-model.md)」を参照してください。  
+  
+### EdmGen.exe を使用して School モデルを検証するには  
+  
+1.  School データベースを作成します。  詳細については、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」を参照してください。  
+  
+2.  School モデルを生成します。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  
+  
+3.  コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```scr  
+    "%windir%\Microsoft.NET\Framework\v4.0.30319\edmgen.exe" /mode:ValidateArtifacts /inssdl:.\School.ssdl /inmsl:.\School.msl /incsdl:.\School.csdl  
+    ```  
+  
+## 参照  
+ [How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)   
+ [How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)   
+ [方法: EdmGen.exe を使用してオブジェクトレイヤー コードを生成する](../../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-object-layer-code.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/index.md b/docs/framework/data/adonet/ef/index.md
new file mode 100644
index 00000000000..bbd6441be6f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/index.md
@@ -0,0 +1,26 @@
+---
+title: "ADO.NET Entity Framework | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: a437041f-6899-4ae7-96ce-aabf528d7205
+caps.latest.revision: 10
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 10
+---
+# ADO.NET Entity Framework
+現在、[msdn.com\/data\/ef](http://msdn.microsoft.com/data/ef) サイトでは、主に Entity Framework に関するコンテンツを提供しています。  
+  
+ このトピックの内容は、「[Entity Framework の導入](http://msdn.microsoft.com/data/jj590134)」ページでご利用いただけます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/known-issues-in-sqlclient-for-entity-framework.md b/docs/framework/data/adonet/ef/known-issues-in-sqlclient-for-entity-framework.md
new file mode 100644
index 00000000000..fb56783f8a9
--- /dev/null
+++ b/docs/framework/data/adonet/ef/known-issues-in-sqlclient-for-entity-framework.md
@@ -0,0 +1,75 @@
+---
+title: "Entity Framework 用の SqlClient の既知の問題 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 48fe4912-4d0f-46b6-be96-3a42c54780f6
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity Framework 用の SqlClient の既知の問題
+ここでは、.NET Framework Data Provider for SQL Server \(SqlClient\) に関連する既知の問題について説明します。  
+  
+## 文字列関数の末尾のスペース  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、文字列値の末尾のスペースは無視されます。  そのため、文字列の末尾にスペースを挿入すると、予期できない結果が生じたり、場合によってはエラーが発生することもあります。  
+  
+ 文字列の末尾にスペースを挿入する必要がある場合は、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] が文字列を切り捨てることがないように、空白文字を挿入することを検討してください。  末尾のスペースが不要である場合は、クエリ パイプラインに渡す前にスペースを削除してください。  
+  
+## RIGHT 関数  
+ `RIGHT(nvarchar(max)`, 0`)` または `RIGHT(varchar(max)`, 0`)` に、最初の引数として `null` 以外の値を、2 番目の引数として 0 を渡すと、`empty` 文字列の代わりに `NULL` 値が返されます。  
+  
+## CROSS APPLY 演算子および OUTER APPLY 演算子  
+ CROSS APPLY 演算子および OUTER APPLY 演算子は [!INCLUDE[ssVersion2005](../../../../../includes/ssversion2005-md.md)] で導入されました。  場合によっては、クエリ パイプラインにより、CROSS APPLY 演算子または OUTER APPLY 演算子を含む Transact\-SQL ステートメントが生成されることがあります。  一部のバックエンド プロバイダー \([!INCLUDE[ssVersion2005](../../../../../includes/ssversion2005-md.md)] より古いバージョンの [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] など\) では、これらの演算子がサポートされていません。したがって、このようなクエリをこれらのバックエンド プロバイダーで実行することはできません。  
+  
+ CROSS APPLY 演算子または OUTER APPLY 演算子を含むクエリの生成につながる可能性がある一般的なシナリオを次に示します。  
+  
+-   ページングを使用した相関サブクエリ  
+  
+-   相関サブクエリ全体、またはナビゲーションによって生成されたコレクション全体を対象とした `AnyElement`  
+  
+-   要素セレクターを受け取るグループ化メソッドを使用する LINQ クエリ  
+  
+-   CROSS APPLY 演算子または OUTER APPLY 演算子が明示的に指定されたクエリ  
+  
+-   REF コンストラクターを引数に取る DEREF コンストラクターを含むクエリ。  
+  
+## SKIP 演算子  
+ [!INCLUDE[ssVersion2000](../../../../../includes/ssversion2000-md.md)] を使用している場合、キー以外の列で ORDER BY と共に SKIP を使用すると、不適切な結果が返されることがあります。  キー以外の列に重複するデータが存在する場合、指定された数を超える行はスキップされます。  これは、[!INCLUDE[ssVersion2000](../../../../../includes/ssversion2000-md.md)] 用に SKIP が変換される方法によるものです。  たとえば、次のクエリでは、`E.NonKeyColumn` に重複値が存在する場合、5 行を超える行はスキップされます。  
+  
+```  
+SELECT [E] FROM Container.EntitySet AS [E] ORDER BY [E].[NonKeyColumn] DESC SKIP 5L  
+```  
+  
+## 適切なバージョンの SQL Server を対象としたクエリの実行  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、SQL Server のバージョンに基づいて実行対象の [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] クエリを決定します。このバージョンは、ストレージ モデル \(.ssdl\) ファイルの Schema 要素の `ProviderManifestToken` 属性で指定されたものです。  このバージョンは、実際に接続する SQL Server のバージョンとは異なる場合があります。  たとえば、使用している SQL Server のバージョンが 2005 であるのに、`ProviderManifestToken` 属性が 2008 に設定されている場合、生成された [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] クエリがサーバーで実行されないことがあります。たとえば、SQL Server 2008 で導入された新しい日時型を使用するクエリは、以前のバージョンの SQL Server では実行されません。  使用している SQL Server のバージョンが 2005 で、`ProviderManifestToken` 属性が 2000 に設定されている場合、生成された [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] クエリが十分に最適化されなかったり、クエリがサポートされていないことを示す例外が発生することがあります。  詳細については、このトピックの「CROSS APPLY 演算子および OUTER APPLY 演算子」を参照してください。  
+  
+ データベースの一部の動作は、データベースの互換性レベルの設定に依存します。  使用している SQL Server のバージョンが 2005 で、`ProviderManifestToken` 属性が 2005 に、データベースの互換性レベルが "80" \(SQL Server 2000\) に設定されている場合、生成された [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の実行対象は SQL Server 2005 になりますが、互換性レベルの設定が原因で予期したとおりに実行されないことがあります。  たとえば、ORDER BY リストの列名とセレクターの列名が一致する場合、順序付けが失われることがあります。  
+  
+## 投影内の入れ子になったクエリ  
+ projection 句内の入れ子になったクエリは、サーバーでデカルト積に変換されないことがあります。  SLQ Server などの一部のバックエンド サーバーでは、これによって TempDB テーブルのサイズが非常に大きくなり、  サーバーのパフォーマンスが低下する可能性があります。  
+  
+ projection 句内の入れ子になったクエリの例を次に示します。  
+  
+```  
+SELECT c, (SELECT c, (SELECT c FROM AdventureWorksModel.Vendor AS c  ) As Inner2 FROM AdventureWorksModel.JobCandidate AS c  ) As Inner1 FROM AdventureWorksModel.EmployeeDepartmentHistory AS c  
+```  
+  
+## サーバー生成の GUID ID 値  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、サーバー生成の GUID 型 ID 値がサポートされますが、プロバイダーは、サーバー生成の ID 値を行の挿入後に返す動作をサポートする必要があります。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2005 以降、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] データベース内のサーバー生成 GUID 型を [OUTPUT 句](http://go.microsoft.com/fwlink/?LinkId=169400) で返すことができるようになりました。  
+  
+## 参照  
+ [Entity Framework 用 SqlClient](../../../../../docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md)   
+ [LINQ to Entities の既知の問題および注意点](../../../../../docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/TOC.md b/docs/framework/data/adonet/ef/language-reference/TOC.md
new file mode 100644
index 00000000000..b67f917b357
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/TOC.md
@@ -0,0 +1,136 @@
+# [FROM](from-entity-sql.md)
+# [NAVIGATE](navigate-entity-sql.md)
+# [Entity SQL の概要](entity-sql-overview.md)
+# [NULL 比較](null-comparisons.md)
+# [/ (除算)](divide-entity-sql.md)
+# [NULL リテラルと型推論](null-literals-and-type-inference-entity-sql.md)
+# [比較式](comparison-expressions.md)
+# [MULTISET](multiset-entity-sql.md)
+# [演算子の優先順位](operator-precedence-entity-sql.md)
+# [&& (AND)](and-entity-sql.md)
+# [Entity SQL クイック リファレンス](entity-sql-quick-reference.md)
+# [メソッドベースのクエリ構文例: フィルター処理](method-based-query-syntax-examples-filtering.md)
+# [CLR メソッドと正規関数とのマッピング](clr-method-to-canonical-function-mapping.md)
+# [SKIP](skip-entity-sql.md)
+# [UNION](union-entity-sql.md)
+# [ISNULL](isnull-entity-sql.md)
+# [クエリ式の構文例 : 集計演算子](query-expression-syntax-examples-aggregate-operators.md)
+# [LINQ to Entities クエリ内の式](expressions-in-linq-to-entities-queries.md)
+# [識別子](identifiers-entity-sql.md)
+# [EXISTS](exists-entity-sql.md)
+# [GROUPPARTITION](grouppartition-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : 結合演算子](method-based-query-syntax-examples-join-operators.md)
+# [GROUP BY](group-by-entity-sql.md)
+# [KEY](key-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : グループ化](method-based-query-syntax-examples-grouping.md)
+# [REF](ref-entity-sql.md)
+# [クエリ式](query-expressions-entity-sql.md)
+# [クエリ式の構文例: フィルター処理](query-expression-syntax-examples-filtering.md)
+# [LIMIT](limit-entity-sql.md)
+# [クエリの実行](query-execution.md)
+# [ORDER BY](order-by-entity-sql.md)
+# [LINQ to Entities でのクエリ](queries-in-linq-to-entities.md)
+# [クエリ結果](query-results.md)
+# [クエリ式の構文例 : 並べ替え](query-expression-syntax-examples-ordering.md)
+# [- (減算)](subtract-entity-sql.md)
+# [CSDL、SSDL、および MSL 仕様](csdl-ssdl-and-msl-specifications.md)
+# [正規関数](canonical-functions.md)
+# [言語リファレンス](index.md)
+# [ページング](paging-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : パーティション分割](method-based-query-syntax-examples-partitioning.md)
+# [HAVING](having-entity-sql.md)
+# [正規関数を呼び出す方法](how-to-call-canonical-functions.md)
+# [比較セマンティクス](comparison-semantics-entity-sql.md)
+# [NULL 値が許容される構造化型](nullable-structured-types-entity-sql.md)
+# [集計関数](aggregate-functions-entity-sql.md)
+# [LINQ to Entities の既知の問題および注意点](known-issues-and-considerations-in-linq-to-entities.md)
+# [WHERE](where-entity-sql.md)
+# [! (NOT)](not-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : リレーションシップのナビゲーション](method-based-query-syntax-examples-navigating-relationships.md)
+# [Entity SQL 言語](entity-sql-language.md)
+# [定数式](constant-expressions.md)
+# [SSDL 仕様](ssdl-specification.md)
+# [Entity SQL と Transact-SQL の相違点](how-entity-sql-differs-from-transact-sql.md)
+# [関数のオーバーロードの解決方法](function-overload-resolution-entity-sql.md)
+# [SELECT](select-entity-sql.md)
+# [ビット単位の正規関数](bitwise-canonical-functions.md)
+# [初期化式](initialization-expressions.md)
+# [日付と時刻の正規関数](date-and-time-canonical-functions.md)
+# [= (等しい)](equals-entity-sql.md)
+# [INTERSECT](intersect-entity-sql.md)
+# [空間関数](spatial-functions.md)
+# [クエリ プランのキャッシュ](query-plan-caching-entity-sql.md)
+# [|| (OR)](or-entity-sql.md)
+# [パラメーター](parameters-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : 要素演算子](method-based-query-syntax-examples-element-operators.md)
+# [名前空間](namespaces-entity-sql.md)
+# [LIKE](like-entity-sql.md)
+# [型システム](type-system-entity-sql.md)
+# [コンパイル済みクエリ (LINQ to Entities)](compiled-queries-linq-to-entities.md)
+# [LINQ to Entities クエリの標準クエリ演算子](standard-query-operators-in-linq-to-entities-queries.md)
+# [サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド (LINQ to Entities)](supported-and-unsupported-linq-methods-linq-to-entities.md)
+# [クエリ式の構文例 : パーティション分割](query-expression-syntax-examples-partitioning.md)
+# [<= (以下)](less-than-or-equal-to-entity-sql.md)
+# [データベース関数を呼び出す方法](how-to-call-database-functions.md)
+# [その他の正規関数](other-canonical-functions.md)
+# [>= (以上)](greater-than-or-equal-to-entity-sql.md)
+# [数学正規関数](math-canonical-functions.md)
+# [OFTYPE](oftype-entity-sql.md)
+# [方法: クエリを使用してモデル定義関数を呼び出す](how-to-call-model-defined-functions-in-queries.md)
+# [CSDL 仕様](csdl-specification.md)
+# [EXCEPT](except-entity-sql.md)
+# [入れ子になった Entity SQL クエリの作成](composing-nested-entity-sql-queries.md)
+# [LINQ to Entities](linq-to-entities.md)
+# [Entity SQL リファレンス](entity-sql-reference.md)
+# [サポートされていない式](unsupported-expressions-entity-sql.md)
+# [文字列正規関数](string-canonical-functions.md)
+# [-- (コメント)](comment-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : 並べ替え](method-based-query-syntax-examples-ordering.md)
+# [TREAT](treat-entity-sql.md)
+# [ISOF](isof-entity-sql.md)
+# [+ (文字列連結)](string-concatenation-entity-sql.md)
+# [名前付きの型コンストラクター](named-type-constructor-entity-sql.md)
+# [THEN](then-entity-sql.md)
+# [関数](functions-entity-sql.md)
+# [+ (加算)](add.md)
+# [IN](in-entity-sql.md)
+# [* (乗算)](multiply-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : 射影](method-based-query-syntax-examples-projection.md)
+# [BETWEEN](between-entity-sql.md)
+# [> (より大きい)](greater-than-entity-sql.md)
+# [DEREF](deref-entity-sql.md)
+# [TOP](top-entity-sql.md)
+# [CREATEREF](createref-entity-sql.md)
+# [ANYELEMENT](anyelement-entity-sql.md)
+# [. (メンバー アクセス)](member-access-entity-sql.md)
+# [方法: カスタム データベース関数を呼び出す](how-to-call-custom-database-functions.md)
+# [コンストラクター](constructing-types-entity-sql.md)
+# [OVERLAPS](overlaps-entity-sql.md)
+# [ユーザー定義関数](user-defined-functions-entity-sql.md)
+# [変数](variables-entity-sql.md)
+# [集計正規関数](aggregate-canonical-functions.md)
+# [!= (等しくない)](not-equal-to-entity-sql.md)
+# [クエリ式の構文例 : 結合演算子](query-expression-syntax-examples-join-operators.md)
+# [方法: モデル定義関数をオブジェクト メソッドとして呼び出す](how-to-call-model-defined-functions-as-object-methods.md)
+# [クエリ式の構文例 : 要素演算子](query-expression-syntax-examples-element-operators.md)
+# [型定義](type-definitions-entity-sql.md)
+# [クエリ式の構文例 : グループ化](query-expression-syntax-examples-grouping.md)
+# [SET](set-entity-sql.md)
+# [CASE](case-entity-sql.md)
+# [パーセント (剰余)](modulo-entity-sql.md)
+# [USING](using-entity-sql.md)
+# [- (負符号)](negative-entity-sql.md)
+# [< (より小さい)](less-than-entity-sql.md)
+# [FLATTEN](flatten-entity-sql.md)
+# [メソッド ベースのクエリ構文例 : 変換](method-based-query-syntax-examples-conversion.md)
+# [MSL 仕様](msl-specification.md)
+# [入力文字セット](input-character-set-entity-sql.md)
+# [LINQ to Entities クエリ内の関数の呼び出し](calling-functions-in-linq-to-entities-queries.md)
+# [メソッド ベースのクエリ構文例 : 集計演算子](method-based-query-syntax-examples-aggregate-operators.md)
+# [クエリ式の構文例 : リレーションシップのナビゲーション](query-expression-syntax-examples-navigating-relationships.md)
+# [FUNCTION](function-entity-sql.md)
+# [リテラル](literals-entity-sql.md)
+# [CAST](cast-entity-sql.md)
+# [クエリ式の構文例 : 射影](query-expression-syntax-examples-projection.md)
+# [ROW](row-entity-sql.md)
+# [COLLECTION](collection-entity-sql.md)
diff --git a/docs/framework/data/adonet/ef/language-reference/add.md b/docs/framework/data/adonet/ef/language-reference/add.md
new file mode 100644
index 00000000000..b619e384b7a
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/add.md
@@ -0,0 +1,57 @@
+---
+title: "+ (加算) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 51769b02-a8f7-4177-9e99-bbd10e77092c
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# + (加算)
+2 つの値を加算します。  
+  
+## 構文  
+  
+```  
+  
+expression  
++  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の数値データ型の有効な式。  
+  
+## 戻り値の型  
+ 2 つの引数の暗黙の型の昇格の結果であるデータ型。 暗黙の型の昇格について詳しくは、「[型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)」をご覧ください。  
+  
+## 解説  
+ EDM.String 型の場合は、値が連結されます。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\+ 算術演算子を使用して 2 つの数値を加算します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#ADD](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#add)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [概念モデルの型 \(CSDL\)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md
new file mode 100644
index 00000000000..d4cc60310e2
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md
@@ -0,0 +1,89 @@
+---
+title: "集計正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 3bcff826-ca90-41b3-a791-04d6ff0e5085
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 集計正規関数
+集計とは、一連の入力値をまとまった値 \(単一の値など\) に変換する式を指します。  集計は SELECT 式の GROUP BY 句と組み合わせて使用されるのが一般的であり、どこで使用できるかについては制約があります。  
+  
+ 次の表に、集計 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`Avg(` `expression` `)`|NULL 以外の値の平均を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `expression` の型。  すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_AVG](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_avg)]
+ [!code-sql[DP EntityServices Concepts#EDM_AVG](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_avg)]|  
+|`BigCount(` `expression` `)`|NULL 値および重複値を含む集計のサイズを返します。<br /><br /> **引数**<br /><br /> 任意の型。<br /><br /> **戻り値**<br /><br /> `Int64`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_BIGCOUNT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_bigcount)]
+ [!code-sql[DP EntityServices Concepts#EDM_BIGCOUNT](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_bigcount)]|  
+|`Count(` `expression` `)`|NULL 値および重複値を含む集計のサイズを返します。<br /><br /> **引数**<br /><br /> 任意の型。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_COUNT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_count)]
+ [!code-sql[DP EntityServices Concepts#EDM_COUNT](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_count)]|  
+|`Max(` `expression` `)`|NULL 以外の値の最大値を返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、`Int64`、`Byte`、`Single`、`Double`、`Decimal`、`DateTime`、`DateTimeOffset`、`Time`、`String`、`Binary`。<br /><br /> **戻り値**<br /><br /> `expression` の型。  すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_MAX](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_max)]
+ [!code-sql[DP EntityServices Concepts#EDM_MAX](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_max)]|  
+|`Min(` `expression` `)`|NULL 以外の値の最小値を返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、`Int64`、`Byte`、`Single`、`Double`、`Decimal`、`DateTime`、`DateTimeOffset`、`Time`、`String`、`Binary`。<br /><br /> **戻り値**<br /><br /> `expression` の型。  すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_MIN](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_min)]
+ [!code-sql[DP EntityServices Concepts#EDM_MIN](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_min)]|  
+|`StDev(` `expression` `)`|NULL 以外の値の標準偏差を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `Double` すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_STDEV](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_stdev)]
+ [!code-sql[DP EntityServices Concepts#EDM_STDEV](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_stdev)]|  
+|`StDevP(` `expression` `)`|すべての値の母集団の標準偏差を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `Double` すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_STDEVP](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_stdevp)]
+ [!code-sql[DP EntityServices Concepts#EDM_STDEVP](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_stdevp)]|  
+|`Sum(` `expression` `)`|NULL 以外の値の合計を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `Double` すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_SUM](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_sum)]
+ [!code-sql[DP EntityServices Concepts#EDM_SUM](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_sum)]|  
+|`Var(` `expression` `)`|すべての null 以外の値の分散を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `Double` すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_VAR](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_var)]
+ [!code-sql[DP EntityServices Concepts#EDM_VAR](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_var)]|  
+|`VarP(` `expression` `)`|すべての null 以外の値の母集団の分散を返します。<br /><br /> **引数**<br /><br /> `Int32`、`Int64`、`Double`、`Decimal`。<br /><br /> **戻り値**<br /><br /> `Double` すべての入力値が `null` の場合は `Null` です。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_VARP](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_varp)]
+ [!code-sql[DP EntityServices Concepts#EDM_VARP](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_varp)]|  
+  
+ 同等の機能は、Microsoft SQL クライアント マネージ プロバイダーでも利用できます。  詳細については、「[Entity Framework 用 SqlClient 関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## コレクションベースの集計  
+ コレクションベースの集計 \(コレクション関数\) は、コレクションに対して演算を実行して、値を返します。  たとえば、ORDERS がすべての注文のコレクションである場合、次の式を使って、最も早い出荷日を計算できます。  
+  
+```  
+min(select value o.ShipDate from LOB.Orders as o)  
+```  
+  
+ コレクションベースの集計では、現在の周囲の名前解決スコープ内で式が評価されます。  
+  
+## グループベースの集計  
+ グループベースの集計では、GROUP BY 句によって定義されたグループごとに計算が実行されます。  その結果の各グループについて、それぞれのグループ内の要素を、集計計算の入力として使って別個の集計が計算されます。  select 式で group by 句を使用した場合、投影または order by 句で使用できるのは、グループ化式の名前、集計式、または定数式だけです。  
+  
+ 次の例では、製品ごとの平均発注数量を計算しています。  
+  
+```  
+select p, avg(ol.Quantity) from LOB.OrderLines as ol  
+  group by ol.Product as p  
+```  
+  
+ SELECT 式に明示的な group by 句を指定せずに、グループベースの集計を行うこともできます。  この場合、すべての要素が単一のグループとして扱われます。  これは、定数に基づくグループ化を指定した場合と同等です。  たとえば、次のような式があったとします。  
+  
+```  
+select avg(ol.Quantity) from LOB.OrderLines as ol  
+```  
+  
+ これは、次の指定と同じです。  
+  
+```  
+select avg(ol.Quantity) from LOB.OrderLines as ol group by 1  
+```  
+  
+ グループベースの集計内の式は、WHERE 句式から可視である名前解決スコープ内で評価されます。  
+  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] の場合と同様、グループベースの集計には、ALL または DISTINCT の修飾子を指定することもできます。  DISTINCT 修飾子が指定された場合、集計を計算する前に、集計の入力コレクションから重複が除外されます。  ALL 修飾子が指定された場合 \(または修飾子が指定されなかった場合\)、重複は除外されません。  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/aggregate-functions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/aggregate-functions-entity-sql.md
new file mode 100644
index 00000000000..02dc5990367
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/aggregate-functions-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "集計関数 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: acfd3149-f519-4c6e-8fe1-b21d243a0e58
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 集計関数 (Entity SQL)
+集計は、コレクションをグループ操作の一部としてスカラーに圧縮する言語構成要素です。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 集計には次の 2 つの形式があります。  
+  
+-   式内のあらゆる位置で使用できる [!INCLUDE[esql](../../../../../../includes/esql-md.md)] コレクション関数。これには、コレクションに対して作用するプロジェクションおよび述語での集計関数の使用が含まれます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] で集計を指定するには、コレクション関数を使用することをお勧めします。  
+  
+-   GROUP BY 句を含むクエリ式内のグループ集計。  [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] と同様に、グループ集計では集計の入力に対する修飾子として DISTINCT と ALL を受け入れます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、まず式をコレクション関数として解釈しようとしますが、SELECT 式のコンテキストにある式はグループ集計として解釈されます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、[GROUPPARTITION](../../../../../../docs/framework/data/adonet/ef/language-reference/grouppartition-entity-sql.md) という特殊な集計演算子を定義します。  この演算子を使用すると、グループ化された入力セットへの参照を取得できます。  これにより、GROUP BY 句の結果をグループ集計関数やコレクション関数以外の場所で使用できる高度なグループ化クエリが可能になります。  
+  
+## コレクション関数  
+ コレクション関数はコレクションに対して実行され、スカラー値を返します。  たとえば、`orders` がすべての `orders` のコレクションである場合、次の式を使用して、最も早い出荷日を計算できます。  
+  
+ `min(select value o.ShipDate from LOB.Orders as o)`  
+  
+## グループ集計  
+ グループ集計では、GROUP BY 句によって定義されたグループ結果ごとに計算が実行されます。  GROUP BY 句により、データがグループに分けられます。  分けられた各グループに集計関数が適用され、それぞれのグループ内の要素を集計計算の入力として使用して、各集計が計算されます。  SELECT 式で GROUP BY 句を使用した場合、プロジェクション、HAVING、または ORDER BY 句で使用できるのは、グループ化式の名前、集計式、または定数式だけです。  
+  
+ 次の例では、製品ごとの平均発注数量を計算しています。  
+  
+ `select p, avg(ol.Quantity) from LOB.OrderLines as ol`  
+  
+ `group by ol.Product as p`  
+  
+ SELECT 式に明示的な GROUP BY 句を指定せずに、グループ集計を行うこともできます。  すべての要素が 1 つのグループとして処理されます。これは定数に基づくグループ化を指定する場合と同じです。  
+  
+ `select avg(ol.Quantity) from LOB.OrderLines as ol`  
+  
+ `select avg(ol.Quantity) from LOB.OrderLines as ol group by 1`  
+  
+ GROUP BY 句で使用される式は、WHERE 句式から参照できる同じ名前解決スコープを使用して評価されます。  
+  
+## 参照  
+ [関数](../../../../../../docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/and-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/and-entity-sql.md
new file mode 100644
index 00000000000..1e2a0947ad8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/and-entity-sql.md
@@ -0,0 +1,60 @@
+---
+title: "&amp;&amp; (AND) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: e7d24213-471d-4807-b85e-570375df89b5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# &amp;&amp; (AND) (Entity SQL)
+両方の式が `true` の場合は `true` を返します。それ以外の場合は `false` または `NULL` を返します。  
+  
+## 構文  
+  
+```  
+  
+          boolean_expression AND boolean_expression  
+or  
+boolean_expression && boolean_expression  
+```  
+  
+## 引数  
+ `boolean_expression`  
+ ブール値を返す任意の有効な式。  
+  
+## 解説  
+ 二重のアンパサンド \(&&\) は、AND 演算子と同じ効果を持ちます。  
+  
+ 使用可能な入力値と戻り値の型を次の表に示します。  
+  
+||`TRUE`|`FALSE`|`NULL`|  
+|-|------------|-------------|------------|  
+|`TRUE`|TRUE|FALSE|NULL|  
+|`FALSE`|FALSE|FALSE|FALSE|  
+|`NULL`|NULL|FALSE|NULL|  
+  
+## 使用例  
+ 次の Entity SQL クエリは、AND 演算子の使い方を示しています。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#AND](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#and)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/anyelement-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/anyelement-entity-sql.md
new file mode 100644
index 00000000000..cdb9d5ac1d7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/anyelement-entity-sql.md
@@ -0,0 +1,58 @@
+---
+title: "ANYELEMENT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 475a9ad6-8c8d-4f49-9970-af273e5360f1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ANYELEMENT (Entity SQL)
+複数値のコレクションから要素を抽出します。  
+  
+## 構文  
+  
+```  
+  
+ANYELEMENT (expression)  
+```  
+  
+## 引数  
+ `expression`  
+ 要素の抽出元のコレクションを返す任意の有効なクエリ式。  
+  
+## 戻り値  
+ コレクションに複数の要素が存在する場合はコレクション内の単一の要素 \(任意の要素\) が、コレクションが空の場合は `null` が返されます。```collection``` が `Collection<T>` 型のコレクションである場合、 `ANYELEMENT(collection)`  は、`T` 型のインスタンスを生成する正しい式です。  
+  
+## 解説  
+ ANYELEMENT では、複数値のコレクションから任意の要素が抽出されます。 たとえば、次の例では、 `Customers` という集合から単一の要素が抽出されます。  
+  
+```  
+ANYELEMENT(Customers)  
+```  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、ANYELEMENT 演算子を使用して、複数値のコレクションから要素を抽出します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#ANYELEMENT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#anyelement)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [NULL 値が許容される構造化型](../../../../../../docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/between-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/between-entity-sql.md
new file mode 100644
index 00000000000..c3a24d41fa6
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/between-entity-sql.md
@@ -0,0 +1,65 @@
+---
+title: "BETWEEN (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 4dcdd754-ae01-4e78-bf28-8a117fb2b73e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# BETWEEN (Entity SQL)
+式の結果が指定の範囲内の値になるかどうかを判断します。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の BETWEEN 式は、Transact\-SQL の BETWEEN 式と同じ効果を持ちます。  
+  
+## 構文  
+  
+```  
+  
+expression [ NOT ] BETWEEN begin_expression AND end_expression  
+```  
+  
+## 引数  
+ `expression`  
+ `begin_expression` と `end_expression` で定義される範囲についてテストするための任意の有効な式。`expression` は、`begin_expression` と `end_expression` の両方と同じ型にする必要があります。  
+  
+ `begin_expression`  
+ 任意の有効な式。`begin_expression` は、`expression` と `end_expression` の両方と同じ型にする必要があります。`begin_expression` は、`end_expression` 未満でなければなりません。それ以外の場合、戻り値は否定されます。  
+  
+ `end_expression`  
+ 任意の有効な式。`end_expression` は、`expression` と `begin_expression` の両方と同じ型にする必要があります。  
+  
+ NOT  
+ BETWEEN の結果を否定することを指定します。  
+  
+ AND  
+ `expression` と `begin_expression` で表される範囲内で `end_expression` をテストする必要があることを示すプレースホルダーです。  
+  
+## 戻り値  
+ `true` が、`expression` と `begin_expression` で指定される範囲内にある場合は `end_expression`。それ以外の場合は `false`。`null` が `expression` であるか、`null` または `begin_expression` が `end_expression` である場合は、`null` が返されます。  
+  
+## 解説  
+ 両端を除いた範囲を指定するには、BETWEEN の代わりに、より大きい \(\>\) とより小さい \(\<\) を意味する演算子を使用します。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、BETWEEN 演算子を使用して、式の結果が指定の範囲内の値になるかどうかを調べます。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#BETWEEN](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#between)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md
new file mode 100644
index 00000000000..5164dd48386
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md
@@ -0,0 +1,37 @@
+---
+title: "ビット単位の正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 993868ca-16e3-47b6-9915-c29cd63b0a21
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# ビット単位の正規関数
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] にはビット単位の正規関数があります。  
+  
+## 解説  
+ 次の表に、ビット単位の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数を示します。  `Null` が入力された場合、これらの関数は `Null` を返します。  戻り値の型は、引数の型と同じです。  複数の引数を関数が受け取る場合、それらの引数は同じ型にする必要があります。  異なる型でビット単位の演算を実行するには、明示的に同じ型にキャストする必要があります。  
+  
+|関数|説明|  
+|--------|--------|  
+|`BitWiseAnd (` `value1` `,`  `value2` `)`|`value1` と `value2` のビット単位の論理積を `value1` と `value2` の型で返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、および `Int64`。<br /><br /> **例**<br /><br /> `-- The following example returns 1.`<br /><br /> `BitWiseAnd(1,3)`|  
+|`BitWiseNot (` `value` `)`|`value` のビット単位の否定を返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、および `Int64`。<br /><br /> **例**<br /><br /> `-- The following example returns -4.`<br /><br /> `BitWiseNot(3)`|  
+|`BitWiseOr (` `value1` `,`  `value2` `)`|`value1` と `value2` のビット単位の論理和を `value1` と `value2` の型で返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、および `Int64`。<br /><br /> **例**<br /><br /> `-- The following example returns 3.`<br /><br /> `BitWiseOr(1,3)`|  
+|`BitWiseXor (` `value1` `,`  `value2` `)`|`value1` と `value2` のビット単位の排他的論理和を `value1` と `value2` の型で返します。<br /><br /> **引数**<br /><br /> `Byte`、`Int16`、`Int32`、および `Int64`。<br /><br /> **例**<br /><br /> `-- The following example returns 2.`<br /><br /> `BitWiseXor (1,3)`|  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md b/docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md
new file mode 100644
index 00000000000..7e1d7e5ecc7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md
@@ -0,0 +1,49 @@
+---
+title: "LINQ to Entities クエリ内の関数の呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 12a525a9-727c-4464-a0c7-71a0ef541792
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to Entities クエリ内の関数の呼び出し
+このセクションの各トピックでは、LINQ to Entities クエリで関数を呼び出す方法について説明します。  
+  
+ <xref:System.Data.Objects.EntityFunctions> クラスおよび <xref:System.Data.Objects.SqlClient.SqlFunctions> クラスを使用すると、Entity Framework の一部として正規関数およびデータベース関数にアクセスできます。  詳細については、「[正規関数を呼び出す方法](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-canonical-functions.md)」および「[データベース関数を呼び出す方法](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-database-functions.md)」を参照してください。  
+  
+ カスタム関数を呼び出すプロセスには、3 つの基本的な手順が必要です。  
+  
+1.  概念モデルで関数を定義するか、ストレージ モデルで関数を宣言します。  
+  
+2.  メソッドをアプリケーションに追加し、<xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> を使用してこれをモデルの関数にマップします。  
+  
+3.  LINQ to Entities クエリから関数を呼び出します。  
+  
+ 詳細については、このセクションの各トピックを参照してください。  
+  
+## このセクションの内容  
+ [正規関数を呼び出す方法](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-canonical-functions.md)  
+  
+ [データベース関数を呼び出す方法](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-database-functions.md)  
+  
+ [方法: カスタム データベース関数を呼び出す](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-custom-database-functions.md)  
+  
+ [方法: クエリを使用してモデル定義関数を呼び出す](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-in-queries.md)  
+  
+ [方法: モデル定義関数をオブジェクト メソッドとして呼び出す](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-as-object-methods.md)  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)   
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)   
+ [.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)   
+ [How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/canonical-functions.md
new file mode 100644
index 00000000000..2f6efb324af
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/canonical-functions.md
@@ -0,0 +1,65 @@
+---
+title: "正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bbcc9928-36ea-4dff-9e31-96549ffed958
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 正規関数
+このセクションでは、すべてのデータ プロバイダーがサポートし、あらゆるクエリ テクノロジで使用されている正規関数について説明します。  正規関数は、プロバイダーが拡張することはできません。  
+  
+ これらの正規関数は、プロバイダーの対応するデータ ソース機能に変換されます。  これによって、全データ ソースに共通する形式で表現される関数を呼び出すことができます。  
+  
+ これらの正規関数はデータ ソースから独立しているため、正規関数の引数の型と戻り値の型は、概念モデルの型の語句で定義されます。  ただし、データ ソースの中には概念モデルのすべての型をサポートしていないものもあります。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリで正規関数を使用すると、適切な関数がデータ ソースで呼び出されます。  
+  
+ すべての正規関数は、NULL が入力された場合の動作と明示的に指定されたエラー状況の両方を含んでいます。  ストア プロバイダーはその動作に従う必要がありますが、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] にはこの動作が適用されません。  
+  
+ LINQ のシナリオの場合、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] に対するクエリでは、基になるデータ ソース内のメソッドへの CLR メソッドのマッピングも行われます。  特定の一連のメソッドが適切にマップされるように、CLR メソッドはデータ ソースに関係なく正規関数にマップされます。  
+  
+## 正規関数の名前空間  
+ 正規関数の名前空間は <xref:System.Data.Metadata.Edm> です。  <xref:System.Data.Metadata.Edm> 名前空間は、自動的にすべてのクエリに含まれます。  ただし、<xref:System.Data.Metadata.Edm> 名前空間に正規関数と同じ名前の関数を含む別の名前空間がインポートされている場合は、名前空間を指定する必要があります。  
+  
+## このセクションの内容  
+ [集計正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)  
+ 集計 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。  
+  
+ [数学正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)  
+ 数学 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。  
+  
+ [文字列正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)  
+ 文字列 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。  
+  
+ [日付と時刻の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)  
+ 日付および時刻の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。  
+  
+ [ビット単位の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)  
+ ビット単位の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。  
+  
+ [空間関数](../../../../../../docs/framework/data/adonet/ef/language-reference/spatial-functions.md)  
+ 空間に関する [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の正規関数について説明します。  
+  
+ [その他の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/other-canonical-functions.md)  
+ ビット単位、日付\/時刻、文字列、数学、または集計に分類されない関数について説明します。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [概念モデル正規関数と SQL Server 関数とのマッピング](../../../../../../docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md)   
+ [ユーザー定義関数](../../../../../../docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/case-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/case-entity-sql.md
new file mode 100644
index 00000000000..05995c4bb32
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/case-entity-sql.md
@@ -0,0 +1,74 @@
+---
+title: "CASE (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 26a47873-e87d-4ba2-9e2c-3787c21efe89
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# CASE (Entity SQL)
+一連の `Boolean` 式を評価して結果を決定します。  
+  
+## 構文  
+  
+```  
+  
+CASE  
+     WHEN Boolean_expression THEN result_expression   
+    [ ...n ]   
+     [   
+    ELSE else_result_expression   
+     ]   
+END  
+```  
+  
+## 引数  
+ `n`  
+ 複数の WHEN `Boolean_expression` THEN `result_expression` 句が使用できることを示すプレースホルダーです。  
+  
+ THEN `result_expression`  
+ `Boolean_expression` が `true` に評価されると返される式です。`result expression` は、任意の有効な式です。  
+  
+ ELSE `else_result_expression`  
+ 比較操作の評価がいずれも `true` でなかった場合に返される式です。 この引数を省略し、比較演算のいずれも `true` に評価されなかった場合、CASE は NULL を返します。`else_result_expression` は、任意の有効な式です。`else_result_expression` と任意の `result_expression` のデータ型は同一であるか、暗黙的な変換によって同一の型になる必要があります。  
+  
+ WHEN `Boolean_expression`  
+ 検索 CASE 形式を使用した場合に評価される `Boolean` 式です。`Boolean_expression` は、任意の有効な `Boolean` 式です。  
+  
+## 戻り値  
+ `result_expression` およびオプションの `else_result_expression` の一連の型の中から、最も優先順位の高い型を返します。  
+  
+## 解説  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の case 式は、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] の case 式と似ています。 case 式を使用すると、適切な結果が得られる式を、一連の条件判定によって決めることができます。 この形式の case 式では、1 つまたは複数の `Boolean` 式によって、最終的に使用される式が決定されます。  
+  
+ CASE 関数は、各 WHEN 句の `Boolean_expression` を指定された順序で評価し、`result_expression` として評価された最初の `Boolean_expression` の `true` を返します。 残りの式は評価されません。`Boolean_expression` の評価がいずれも `true` でなかった場合、データベース エンジンは、ELSE 句が指定されていれば `else_result_expression` を、ELSE 句が指定されていない場合は NULL 値を返します。  
+  
+ CASE ステートメントでマルチセットを取得することはできません。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、CASE 式を使用して、一連の `Boolean` 式を評価し、結果を取得しています。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#CASE_WHEN_THEN_ELSE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#case_when_then_else)]  
+  
+## 参照  
+ [THEN](../../../../../../docs/framework/data/adonet/ef/language-reference/then-entity-sql.md)   
+ [SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md
new file mode 100644
index 00000000000..6db3a91a677
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md
@@ -0,0 +1,75 @@
+---
+title: "CAST (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 07b6d750-dfd4-48a9-b86c-3badcbba6f70
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# CAST (Entity SQL)
+あるデータ型の式を別のデータ型に変換します。  
+  
+## 構文  
+  
+```  
+  
+CAST ( expression AS data_type)  
+```  
+  
+## 引数  
+ `expression`  
+ `data_type` に変換できる任意の有効な式。  
+  
+ `data_type`  
+ 対象システムで提供されるデータ型。 プリミティブ \(スカラー\) 型でなければなりません。 使用される `data_type` は、クエリのスペースによって異なります。 クエリが <xref:System.Data.EntityClient.EntityCommand> で実行される場合、データ型は概念モデルで定義された型です。 詳細については、「[CSDL 仕様](../../../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)」を参照してください。 クエリが <xref:System.Data.Objects.ObjectQuery%601> で実行される場合、データ型は共通言語ランタイム \(CLR\) 型です。  
+  
+## 戻り値  
+ `data_type` と同じ値が返されます。  
+  
+## 解説  
+ キャスト式のセマンティックスは [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] CONVERT 式と似ています。 キャスト式は、ある型の値を別の型の値に変換する場合に使用します。  
+  
+```  
+CAST( e as T )  
+```  
+  
+ e が S 型で、S を T に変換できる場合、上記の式は有効なキャスト式です。 T はプリミティブ \(スカラー\) 型でなければなりません。  
+  
+ `Edm.Decimal` にキャストする場合は、オプションで精度と小数点以下桁数のファセットの値を指定できます。 明示的に指定しない場合、精度と小数点以下桁数の既定値はそれぞれ 18 と 0 です。 具体的には、`Decimal` で次のオーバーロードがサポートされています。  
+  
+-   `CAST( d as Edm.Decimal );`  
+  
+-   `CAST( d as Edm.Decimal(precision) );`  
+  
+-   `CAST( d as Edm.Decimal(precision, scale) );`  
+  
+ キャスト式の使用は明示的な変換と見なされます。 明示的な変換では、データが切り捨てられたり、精度が失われたりする場合があります。  
+  
+> [!NOTE]
+>  CAST はプリミティブ型と列挙メンバー型のみでサポートされています。  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリは CAST 演算子を使用して、あるデータ型の式を別のデータ型にキャストします。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#CAST](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#cast)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md b/docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md
new file mode 100644
index 00000000000..b7162a9b2bf
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md
@@ -0,0 +1,211 @@
+---
+title: "CLR メソッドと正規関数とのマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: e3363261-2cb8-4b54-9555-2870be99b929
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# CLR メソッドと正規関数とのマッピング
+Entity Framework は、文字列操作、数学関数などの多くのデータベース システム間で共通の機能を実装する正規関数のセットを提供します。  この関数により、開発者は広範なデータベース システムをターゲットとして指定することができます。  LINQ to Entities などのクエリ テクノロジから呼び出されると、これらの正規関数は使用されているプロバイダーに対応した正しい格納関数に変換されます。  これにより、関数の呼び出しをデータ ソース間で共通の形式で表すことができ、データ ソース間に一貫した方法でクエリを利用できます。  オペランドが数値型である場合は、ビット単位の AND、OR、NOT、および XOR 演算子も正規関数にマップされます。ブール型のオペランドの場合、ビット単位の AND、OR、NOT、および XOR 演算子は、それぞれのオペランドの論理 AND、OR、NOT、および XOR 演算を計算します。  詳細については、「[正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)」を参照してください。  
+  
+ LINQ シナリオの場合、Entity Framework に対するクエリでは、正規関数による、基になるデータ ソース上のメソッドへの特定の CLR メソッドのマッピングも行われます。  正規関数に明示的にマップされない LINQ to Entities クエリで任意のメソッドの呼び出しが実行されると、ランタイムの <xref:System.NotSupportedException> 例外がスローされます。  
+  
+## System.String メソッド \(静的\) のマッピング  
+  
+|System.String メソッド \(静的\)|正規関数|  
+|-------------------------------|----------|  
+|System.String Concat\(String `str0`, String `str1`\)|Concat\(`str0`, `str1`\)|  
+|System.String Concat\(String `str0`, String `str1`, String `str2`\)|Concat\(Concat\(`str0`, `str1`\), `str2`\)|  
+|System.String Concat\(String `str0`, String `str1`, String `str2`, String `str03`\)|Concat\(Concat\(Concat\(`str0`, `str1`\), `str2`\), `str3`\)|  
+|Boolean Equals\(String `a`, String `b`\)|\= 演算子|  
+|Boolean IsNullOrEmpty\(String `value`\)|\(IsNull\(`value`\)\) OR Length\(`value`\) \= 0|  
+|Boolean op\_Equality\(String `a`, String `b`\)|\= 演算子|  
+|Boolean op\_Inequality\(String `a` , String `b`\)|\!\= 演算子|  
+|Microsoft.VisualBasic.Strings.Trim\(String `str`\)|Trim\(`str`\)|  
+|Microsoft.VisualBasic.Strings.LTrim\(String `str`\)|Ltrim\(`str`\)|  
+|Microsoft.VisualBasic.Strings.RTrim\(String `str`\)|Rtrim\(`str`\)|  
+|Microsoft.VisualBasic.Strings.Len\(String `expression`\)|Length\(`expression`\)|  
+|Microsoft.VisualBasic.Strings.Left\(String `str`, Int32 `Length`\)|Left\(`str`, `Length`\)|  
+|Microsoft.VisualBasic.Strings.Mid\(String `str`, Int32 `Start`, Int32 `Length`\)|Substring\(`str`, `Start`, `Length`\)|  
+|Microsoft.VisualBasic.Strings.Right\(String `str`, Int32 `Length`\)|Right\(`str`, `Length`\)|  
+|Microsoft.VisualBasic.Strings.UCase\(String `Value`\)|ToUpper\(`Value`\)|  
+|Microsoft.VisualBasic.Strings.LCase\(String Value\)|ToLower\(`Value`\)|  
+  
+## System.String メソッド \(インスタンス\) のマッピング  
+  
+|System.String メソッド \(インスタンス\)|正規関数|メモ|  
+|-----------------------------------|----------|--------|  
+|Boolean Contains\(String `value`\)|`this` LIKE '%`value`%'|`value` が定数ではない場合、IndexOf\(`this`, `value`\) \> 0 にマップされます。|  
+|Boolean EndsWith\(String `value`\)|`this` LIKE `'`%`value`'|`value` が定数ではない場合、Right\(`this`, length\(`value`\)\) \= `value` にマップされます。|  
+|Boolean StartsWith\(String `value`\)|`this` LIKE '`value`%'|`value` が定数ではない場合、IndexOf\(`this`, `value`\) \= 1 にマップされます。|  
+|長さ|Length\(`this`\)||  
+|Int32 IndexOf\(String `value`\)|IndexOf\(`this`, `value`\) \- 1||  
+|System.String Insert\(Int32 `startIndex`, String `value`\)|Concat\(Concat\(Substring\(`this`, 1, `startIndex`\), `value`\), Substring\(`this`, `startIndex`\+1, Length\(`this`\) \- `startIndex`\)\)||  
+|System.String Remove\(Int32 `startIndex`\)|Substring\(`this`, 1, `startIndex`\)||  
+|System.String Remove\(Int32 `startIndex`, Int32 `count`\)|Concat\(Substring\(`this`, 1, `startIndex`\) , Substring\(`this`, `startIndex` \+ `count` \+1, Length\(`this`\) \- \(`startIndex` \+ `count`\)\)\)|`count` が 0 以上の整数である場合、サポートされるのは Remove\(`startIndex`, `count`\) だけです。|  
+|System.String Replace\(String `oldValue`, String `newValue`\)|Replace\(`this`, `oldValue`, `newValue`\)||  
+|System.String Substring\(Int32 `startIndex`\)|Substring\(`this`, `startIndex` \+1, Length\(`this`\) \- `startIndex`\)||  
+|System.String Substring\(Int32 `startIndex`, Int32 `length`\)|Substring\(`this`, `startIndex` \+1, `length`\)||  
+|System.String ToLower\(\)|ToLower\(`this`\)||  
+|System.String ToUpper\(\)|ToUpper\(`this`\)||  
+|System.String Trim\(\)|Trim\(`this`\)||  
+|System.String TrimEnd\(Char\[\] `trimChars`\)|RTrim\(`this`\)||  
+|System.String TrimStart\(Char\[\]`trimChars`\)|LTrim\(`this`\)||  
+|Boolean Equals\(String `value`\)|\= 演算子||  
+  
+## System.DateTime メソッド \(静的\) のマッピング  
+  
+|System.DateTime メソッド \(静的\)|正規関数|メモ|  
+|---------------------------------|----------|--------|  
+|Boolean Equals\(DateTime `t1`, DateTime `t2`\)|\= 演算子||  
+|System.DateTime.Now|CurrentDateTime\(\)||  
+|System.DateTime.UtcNow|CurrentUtcDateTime\(\)||  
+|Boolean op\_Equality\(DateTime `d1`, DateTime `d2`\)|\= 演算子||  
+|Boolean op\_GreaterThan\(DateTime `t1`, DateTime `t2`\)|\> 演算子||  
+|Boolean op\_GreaterThanOrEqual\(DateTime `t1`, DateTime `t2`\)|\>\= 演算子||  
+|Boolean op\_Inequality\(DateTime `t1`, DateTime `t2`\)|\!\= 演算子||  
+|Boolean op\_LessThan\(DateTime `t1`, DateTime `t2`\)|\< 演算子||  
+|Boolean op\_LessThanOrEqual\(DateTime `t1`, DateTime `t2`\)|\<\= 演算子||  
+|Microsoft.VisualBasic.DateAndTime.DatePart\( \_<br /><br /> ByVal `Interval` As DateInterval, \_<br /><br /> ByVal `DateValue` As DateTime, \_<br /><br /> Optional ByVal `FirstDayOfWeekValue` As FirstDayOfWeek \= VbSunday, \_<br /><br /> Optional ByVal `FirstWeekOfYearValue` As FirstWeekOfYear \= VbFirstJan1 \_<br /><br /> \) As Integer||詳細については、「DatePart 関数」を参照してください。|  
+|Microsoft.VisualBasic.DateAndTime.Now|CurrentDateTime\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Year\(DateTime `TimeValue`\)|Year\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Month\(DateTime `TimeValue`\)|Month\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Day\(DateTime `TimeValue`\)|Day\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Hour\(DateTime `TimeValue`\)|Hour\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Minute\(DateTime `TimeValue`\)|Minute\(\)||  
+|Microsoft.VisualBasic.DateAndTime.Second\(DateTime `TimeValue`\)|Second\(\)||  
+  
+## System.DateTime メソッド \(インスタンス\) のマッピング  
+  
+|System.DateTime メソッド \(インスタンス\)|正規関数|  
+|-------------------------------------|----------|  
+|Boolean Equals\(DateTime `value`\)|\= 演算子|  
+|Day|Day\(`this`\)|  
+|Hour|Hour\(`this`\)|  
+|Millisecond|Millisecond\(`this`\)|  
+|Minute|Minute\(`this`\)|  
+|月|Month\(`this`\)|  
+|Second|Second\(`this`\)|  
+|Year|Year\(`this`\)|  
+  
+## System.DateTimeOffset メソッド \(インスタンス\) のマッピング  
+ 示されているプロパティに対する `get` メソッドのマッピングを示します。  
+  
+|System.DateTimeOffset メソッド \(インスタンス\)|正規関数|メモ|  
+|-------------------------------------------|----------|--------|  
+|Day|Day\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Hour|Hour\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Millisecond|Millisecond\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Minute|Minute\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|月|Month\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Second|Second\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Year|Year\(`this`\)|SQL Server 2005 ではサポートされません。|  
+  
+> [!NOTE]
+>  比較した <xref:System.DateTimeOffset> オブジェクトが等しい場合、<xref:System.DateTimeOffset.Equals%2A> メソッドは `true` を返します。それ以外の場合は `false` を返します。  比較した <xref:System.DateTimeOffset> オブジェクトが等しい、より大きい、またはより小さい場合、<xref:System.DateTimeOffset.CompareTo%2A> メソッドはそれぞれ 0、1、または \-1 を返します。  
+  
+## System.DateTimeOffset メソッド \(静的\) のマッピング  
+ 示されているプロパティに対する `get` メソッドのマッピングを示します。  
+  
+|System.DateTimeOffset メソッド \(静的\)|正規関数|メモ|  
+|---------------------------------------|----------|--------|  
+|System.DateTimeOffset.Now\(\)|CurrentDateTimeOffset\(\)|SQL Server 2005 ではサポートされません。|  
+  
+## System.TimeSpan メソッド \(インスタンス\) のマッピング  
+ 示されているプロパティに対する `get` メソッドのマッピングを示します。  
+  
+|System.TimeSpan メソッド \(インスタンス\)|正規関数|メモ|  
+|-------------------------------------|----------|--------|  
+|時間|Hour\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Milliseconds|Millisecond\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|分|Minute\(`this`\)|SQL Server 2005 ではサポートされません。|  
+|Seconds|Second\(`this`\)|SQL Server 2005 ではサポートされません。|  
+  
+> [!NOTE]
+>  比較した <xref:System.TimeSpan> オブジェクトが等しい場合、<xref:System.TimeSpan.Equals%2A> メソッドは `true` を返します。それ以外の場合は `false` を返します。  比較した <xref:System.TimeSpan> オブジェクトが等しい、より大きい、またはより小さい場合、<xref:System.TimeSpan.CompareTo%2A> メソッドはそれぞれ 0、1、または \-1 を返します。  
+  
+### DatePart 関数  
+ `DatePart` 関数は、`Interval` の値に応じて、複数の異なる正規関数のいずれかにマップされます。  サポートされている各 `Interval` 値に対応する正規関数のマッピングを次の表に示します。  
+  
+|Interval 値|正規関数|  
+|----------------|----------|  
+|DateInterval.Year|Year\(\)|  
+|DateInterval.Month|Month\(\)|  
+|DateInterval.Day|Day\(\)|  
+|DateInterval.Hour|Hour\(\)|  
+|DateInterval.Minute|Minute\(\)|  
+|DateInterval.Second|Second\(\)|  
+  
+## 数学関数のマッピング  
+  
+|CLR メソッド|正規関数|  
+|--------------|----------|  
+|System.Decimal.Ceiling\(Decimal `d`\)|Ceiling\(`d`\)|  
+|System.Decimal.Floor\(Decimal `d`\)|Floor\(`d`\)|  
+|System.Decimal.Round\(Decimal `d`\)|Round\(`d`\)|  
+|System.Math.Ceiling\(Decimal `d`\)|Ceiling\(`d`\)|  
+|System.Math.Floor\(Decimal `d`\)|Floor\(`d`\)|  
+|System.Math.Round\(Decimal `d`\)|Round\(`d`\)|  
+|System.Math.Ceiling\(Double `a`\)|Ceiling\(`a`\)|  
+|System.Math.Floor\(Double `a`\)|Floor\(`a`\)|  
+|System.Math.Round\(Double `a`\)|Round\(`a`\)|  
+|System.Math.Round\(Double value, Int16 digits\)|Round\(value, digits\)|  
+|System.Math.Round\(Double value, Int32 digits\)|Round\(value, digits\)|  
+|System.Math.Round\(Decimal value, Int16 digits\)|Round\(value, digits\)|  
+|System.Math.Round\(Decimal value, Int32, digits\)|Round\(value, digits\)|  
+|System.Math.Abs\(Int16 value\)|Abs\(value\)|  
+|System.Math.Abs\(Int32 value\)|Abs\(value\)|  
+|System.Math.Abs\(Int64 value\)|Abs\(value\)|  
+|System.Math.Abs\(Byte value\)|Abs\(value\)|  
+|System.Math.Abs\(Single value\)|Abs\(value\)|  
+|System.Math.Abs\(Double value\)|Abs\(value\)|  
+|System.Math.Abs\(Decimal value\)|Abs\(value\)|  
+|System.Math.Truncate\(Double value, Int16 digits\)|Truncate\(value, digits\)|  
+|System.Math.Truncate\(Double value, Int32 digits\)|Truncate\(value, digits\)|  
+|System.Math.Truncate\(Decimal value, Int16 digits\)|Truncate\(value, digits\)|  
+|System.Math.Truncate\(Decimal value, Int32 digits\)|Truncate\(value, digits\)|  
+|System.Math.Power\(Int32 value, Int64 exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Int32 value, Double exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Int32 value, Decimal exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Int64 value, Int64 exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Int64 value, Double exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Int64 value, Decimal exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Double value, Int64 exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Double value, Double exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Double value, Decimal exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Decimal value, Int64 exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Decimal value, Double exponent\)|Power\(value, exponent\)|  
+|System.Math.Power\(Decimal value, Decimal exponent\)|Power\(value, exponent\)|  
+  
+## ビット演算子のマッピング  
+  
+|ビット演算子|非ブール型のオペランドの正規関数|ブール型のオペランドの正規関数|  
+|------------|----------------------|---------------------|  
+|ビット演算子 AND|BitWiseAnd|op1 AND op2|  
+|ビット演算子 OR|BitWiseOr|op1 OR op2|  
+|ビット演算子 NOT|BitWiseNot|NOT\(op\)|  
+|ビット演算子 XOR|BitWiseXor|\(\(op1 AND NOT\(op2\)\) OR \(NOT\(op1\) AND op2\)\)|  
+  
+## その他のマッピング  
+  
+|メソッド|正規関数|  
+|----------|----------|  
+|Guid.NewGuid\(\)|NewGuid\(\)|  
+  
+## 参照  
+ [LINQ to Entities](../../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/collection-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/collection-entity-sql.md
new file mode 100644
index 00000000000..8a8851cb0bc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/collection-entity-sql.md
@@ -0,0 +1,42 @@
+---
+title: "COLLECTION (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03228bfa-be3a-4ccc-82f8-eee429f85cf1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# COLLECTION (Entity SQL)
+COLLECTION キーワードは、インライン関数を定義する場合にのみ使用します。 コレクション関数は、値のコレクションを操作してスカラー出力を生成する関数です。  
+  
+## 構文  
+  
+```  
+  
+COLLECTION(type_definition)   
+```  
+  
+## 引数  
+ `type_definition`  
+ サポートされる型、行、または参照のコレクションを返す式。  
+  
+## 解説  
+ COLLECTION キーワードについて詳しくは、「[型定義](../../../../../../docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の例は、COLLECTION キーワードを使用して 10 進数のコレクションをインライン クエリ関数の引数として宣言する方法を示します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#Collection_GroupPartition](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#collection_grouppartition)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/comment-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/comment-entity-sql.md
new file mode 100644
index 00000000000..7db33e270fc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/comment-entity-sql.md
@@ -0,0 +1,48 @@
+---
+title: "-- (コメント) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 5d9de735-2099-47f1-b7e7-60856f494924
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# -- (コメント) (Entity SQL)
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリには、コメントを含めることができます。 コメント行の先頭には、2 個のダッシュ \(`--`\) を付けます。  
+  
+## 構文  
+  
+```  
+  
+-- text_of_comment  
+```  
+  
+## 引数  
+ `text_of_comment`  
+ コメントのテキストを表す文字列です。  
+  
+## 使用例  
+ 次の Entity SQL クエリは、コメントの使い方を示しています。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#COMMENT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#comment)]  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/comparison-expressions.md b/docs/framework/data/adonet/ef/language-reference/comparison-expressions.md
new file mode 100644
index 00000000000..99fbc78c5bc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/comparison-expressions.md
@@ -0,0 +1,65 @@
+---
+title: "比較式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ec7637a9-01d5-4a95-8bb0-478311cd263b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 比較式
+比較式は、定数値、プロパティ値、またはメソッドの結果と別の値を比較して、両者が等しいかどうか、または一方の値がもう一方の値より大きい \(小さい\) かどうかを調べます。  特定の比較が [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] に対して無効な場合は、例外がスローされます。  暗黙的および明示的な比較を行う場合は、データ ソース内のすべてのコンポーネントが比較可能である必要があります。  比較式は、クエリ結果を絞り込むために `Where` 句で頻繁に使用されます。  
+  
+ 次のクエリ式の構文の例は、販売注文番号が "SO43663" である結果を返すクエリを示しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#RestrictionExpression](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#restrictionexpression)]
+ [!code-vb[DP L2E Conceptual Examples#RestrictionExpression](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#restrictionexpression)]  
+  
+ 次のメソッド ベースのクエリ構文の例は、販売注文番号が "SO43663" である結果を返すクエリを示しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#RestrictionExpression_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#restrictionexpression_mq)]
+ [!code-vb[DP L2E Conceptual Examples#RestrictionExpression_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#restrictionexpression_mq)]  
+  
+ 次のクエリ式の構文の例は、出荷日が 2001 年 7 月 8 日である販売注文情報を返すクエリを示しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#DateTimeComparison](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#datetimecomparison)]
+ [!code-vb[DP L2E Conceptual Examples#DateTimeComparison](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#datetimecomparison)]  
+  
+ 次のメソッド ベースのクエリ構文の例は、出荷日が 2001 年 7 月 8 日である販売注文情報を返すクエリを示しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#DateTimeComparison_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#datetimecomparison_mq)]
+ [!code-vb[DP L2E Conceptual Examples#DateTimeComparison_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#datetimecomparison_mq)]  
+  
+ 定数を返す式はサーバーで変換されます。そのため、ローカルで評価されることはありません。  次の例では、定数を返す式を `Where` 句で使用しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#ConstantExpression](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#constantexpression)]
+ [!code-vb[DP L2E Conceptual Examples#ConstantExpression](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#constantexpression)]  
+  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] では、ユーザー クラスを定数として使用することはできません。  ただし、ユーザー クラスのプロパティ参照は定数と見なされます。そのため、コマンド ツリーの定数式に変換され、データ ソースで実行されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#MyClass](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#myclass)]
+ [!code-vb[DP L2E Conceptual Examples#MyClass](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#myclass)]  
+  
+ [!code-csharp[DP L2E Conceptual Examples#PropertyAsConstant](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#propertyasconstant)]
+ [!code-vb[DP L2E Conceptual Examples#PropertyAsConstant](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#propertyasconstant)]  
+  
+ 定数式を返すメソッドはサポートされません。  次の例の `Where` 句には、定数を返すメソッドが含まれています。  この例を実行すると、例外がスローされます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#MethodAsConstantFails](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#methodasconstantfails)]
+ [!code-vb[DP L2E Conceptual Examples#MethodAsConstantFails](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#methodasconstantfails)]  
+  
+## 参照  
+ [LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/comparison-semantics-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/comparison-semantics-entity-sql.md
new file mode 100644
index 00000000000..5e259c98ebb
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/comparison-semantics-entity-sql.md
@@ -0,0 +1,118 @@
+---
+title: "比較セマンティクス (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b36ce28a-2fe4-4236-b782-e5f7c054deae
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 比較セマンティクス (Entity SQL)
+次のいずれかの [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 演算子を実行すると、型インスタンスの比較が行われます。  
+  
+## 明示的な比較  
+ 等価演算  
+  
+-   \=  
+  
+-   \!\=  
+  
+ 順序付け操作  
+  
+-   \<  
+  
+-   \<\=  
+  
+-   \>  
+  
+-   \>\=  
+  
+ NULL 値が許容される操作  
+  
+-   IS\_NULL  
+  
+-   IS NOT NULL  
+  
+## 明示的な区別  
+ 等価区別  
+  
+-   DISTINCT  
+  
+-   GROUP BY  
+  
+ 順序付け区別  
+  
+-   ORDER BY  
+  
+## 暗黙的な区別  
+ 設定操作および述語 \(等価\)  
+  
+-   UNION  
+  
+-   INTERSECT  
+  
+-   EXCEPT  
+  
+-   SET  
+  
+-   OVERLAPS  
+  
+ 項目述語 \(等価\)  
+  
+-   IN  
+  
+## サポートされている組み合わせ  
+ 次の表は、各種類の型の比較演算子のサポートされているすべての組み合わせを示します。  
+  
+|||||||||  
+|-|-|-|-|-|-|-|-|  
+|**種類**|**\=**<br /><br /> **\!\=**|**GROUP BY**<br /><br /> **DISTINCT**|**UNION**<br /><br /> **INTERSECT**<br /><br /> **EXCEPT**<br /><br /> **SET**<br /><br /> **OVERLAPS**|**IN**|**\<   \<\=**<br /><br /> **\>   \>\=**|**ORDER BY**|**IS\_NULL**<br /><br /> **IS NOT NULL**|  
+|エンティティ型|参照<sup>1</sup>|すべてのプロパティ<sup>2</sup>|すべてのプロパティ<sup>2</sup>|すべてのプロパティ<sup>2</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|参照<sup>1</sup>|  
+|複合型|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|  
+|行|すべてのプロパティ<sup>4</sup>|すべてのプロパティ<sup>4</sup>|すべてのプロパティ<sup>4</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|すべてのプロパティ<sup>4</sup>|スロー<sup>3</sup>|  
+|プリミティブ型|プロバイダー固有|プロバイダー固有|プロバイダー固有|プロバイダー固有|プロバイダー固有|プロバイダー固有|プロバイダー固有|  
+|マルチセット|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|  
+|参照|○<sup>5</sup>|○<sup>5</sup>|○<sup>5</sup>|○<sup>5</sup>|Throw|Throw|○<sup>5</sup>|  
+|関連付け<br /><br /> 型|スロー<sup>3</sup>|Throw|Throw|Throw|スロー<sup>3</sup>|スロー<sup>3</sup>|スロー<sup>3</sup>|  
+  
+ <sup>1</sup>次の例に示すように、エンティティ型インスタンスの参照は暗黙的に比較されます。  
+  
+```  
+SELECT p1, p2   
+FROM AdventureWorksEntities.Product AS p1   
+     JOIN AdventureWorksEntities.Product AS p2   
+WHERE p1 != p2 OR p1 IS NULL  
+```  
+  
+ エンティティ インスタンスは、明示的な参照に対して比較できません。  明示的な参照に対する比較を行った場合は、例外がスローされます。  たとえば、次のクエリを実行すると、例外がスローされます。  
+  
+```  
+SELECT p1, p2   
+FROM AdventureWorksEntities.Product AS p1   
+     JOIN AdventureWorksEntities.Product AS p2   
+WHERE p1 != REF(p2)  
+```  
+  
+ <sup>2</sup>複合型のプロパティは、ストアに送信される前にフラット化されるので、比較が可能になります \(すべてのプロパティが比較可能である場合\)。  <sup>4</sup> も参照してください。  
+  
+ <sup>3</sup>Entity Framework ランタイムでは、サポートされていないケースが検出され、プロバイダー\/ストアは呼び出されずに、意味のある例外がスローされます。  
+  
+ <sup>4</sup>すべてのプロパティの比較が試行されます。  比較不能な型のプロパティ \(text、ntext、image など\) がある場合、サーバー例外がスローされることがあります。  
+  
+ <sup>5</sup>参照のすべての個々の要素 \(エンティティ セット名およびエンティティ型のすべてのキー プロパティを含む\) が比較されます。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md b/docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md
new file mode 100644
index 00000000000..7bff5cfd593
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md
@@ -0,0 +1,82 @@
+---
+title: "コンパイル済みクエリ (LINQ to Entities) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8025ba1d-29c7-4407-841b-d5a3bed40b7a
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# コンパイル済みクエリ (LINQ to Entities)
+似たような構造のクエリを Entity Framework で何度も実行するアプリケーションがある場合は、クエリを一度コンパイルし、異なるパラメーターを指定して複数回実行することで、パフォーマンスを改善できる場合がよくあります。  たとえば、アプリケーションで特定の市区町村に住む顧客をすべて取得する必要がある場合は、ユーザーが実行時にフォーム内で市区町村を指定します。  LINQ to Entities では、この目的のためにコンパイル済みクエリをサポートしています。  
+  
+ .NET Framework 4.5 以降では、LINQ クエリは自動的にキャッシュされます。  ただし、引き続きコンパイル済み LINQ クエリを使用して後続の実行でさらにコストを削減できます。コンパイル済みクエリは、自動的にキャッシュされる LINQ クエリよりも効率的である場合があります。  メモリ内コレクションへ `Enumerable.Contains` 演算子を追加する LINQ to Entities クエリは自動的にキャッシュされないことに注意してください。  またコンパイル済み LINQ クエリのメモリ内コレクションをパラメーターで表すことは許可されていません。  
+  
+ <xref:System.Data.Objects.CompiledQuery> クラスは、クエリをコンパイルおよびキャッシュして、再利用できるようにします。  このクラスには、概念上、<xref:System.Data.Objects.CompiledQuery> の `Compile` メソッドとその複数のオーバーロードが存在します。  `Compile` メソッドを呼び出すと、コンパイル済みクエリを表す新しいデリゲートを作成できます。  <xref:System.Data.Objects.ObjectContext> およびパラメーター値が指定された `Compile` メソッドは、なんらかの結果 \(<xref:System.Linq.IQueryable%601> インスタンスなど\) をもたらすデリゲートを返します。  クエリは、初回実行時に 1 回だけコンパイルされます。  コンパイル時にクエリに対して設定したマージ オプションは、後から変更できません。  一度クエリがコンパイルされると、プリミティブ型のパラメーターを指定することしかできず、生成された SQL を変更するクエリの部分を置き換えることはできません。  詳細については、「[Entity Framework のマージ オプションおよびコンパイルされたクエリ](http://go.microsoft.com/fwlink/?LinkId=199591)」を参照してください。  
+  
+ <xref:System.Data.Objects.CompiledQuery> の `Compile` メソッドによってコンパイルされる [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリ式は、<xref:System.Func%605> などのジェネリック `Func` デリゲートのいずれかによって表されます。  クエリ式は、最大で、`ObjectContext` パラメーター、戻りパラメーター、および 16 個のクエリ パラメーターをカプセル化できます。  17 個以上のクエリ パラメーターが必要な場合は、クエリ パラメーターを表すプロパティを持つ構造体を作成できます。  次に、その構造体のプロパティを設定した後、それらのプロパティをクエリ式で使用できます。  
+  
+## 例  
+ 次の例では、入力パラメーターとして <xref:System.Decimal> を受け取り、合計支払額が $200.00 以上である一連の注文を返すクエリをコンパイルして呼び出します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery2)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery2)]  
+  
+## 例  
+ 次の例では、<xref:System.Data.Objects.ObjectQuery%601> のインスタンスを返すクエリをコンパイルして呼び出します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery1_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery1_mq)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery1_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery1_mq)]  
+  
+## 例  
+ 次の例では、製品の定価の平均を <xref:System.Decimal> 値として返すクエリをコンパイルして呼び出します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery3_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery3_mq)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery3_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery3_mq)]  
+  
+## 例  
+ 次の例では、入力パラメーターとして <xref:System.String> を受け取り、指定された文字列で電子メール アドレスが始まる `Contact` を返すクエリをコンパイルして呼び出します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery4_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery4_mq)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery4_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery4_mq)]  
+  
+## 例  
+ 次の例では、入力パラメーターとして <xref:System.DateTime> および <xref:System.Decimal> を受け取り、注文日が 2003 年 3 月 8 日より遅く合計支払額が $300.00 未満である一連の注文を返すクエリをコンパイルして呼び出します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery5)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery5)]  
+  
+## 例  
+ 次の例では、入力パラメーターとして <xref:System.DateTime> を受け取り、注文日が 2004 年 3 月 8 日より遅い一連の注文を返すクエリをコンパイルして呼び出します。  このクエリは、注文情報を一連の匿名型として返します。  匿名型はコンパイラによって推論されるので、型パラメーターを <xref:System.Data.Objects.CompiledQuery> の `Compile` メソッドに指定することはできず、型はクエリ自体で定義されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery6)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery6)]  
+  
+## 例  
+ 次の例では、入力パラメーターとしてユーザー定義の構造体を受け取り、一連の注文を返すクエリをコンパイルして呼び出します。  この構造体では開始日、終了日、合計支払額のクエリ パラメーターを定義しており、クエリは、2003 年 3 月 3 日から 3 月 8 日までに出荷された、合計支払額が $700.00 を超える注文を返します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CompiledQuery7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#compiledquery7)]
+ [!code-vb[DP L2E Conceptual Examples#CompiledQuery7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#compiledquery7)]  
+  
+ クエリ パラメーターを定義する構造体を次に示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#MyParamsStruct](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#myparamsstruct)]
+ [!code-vb[DP L2E Conceptual Examples#MyParamsStruct](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#myparamsstruct)]  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../../docs/framework/data/adonet/ef/index.md)   
+ [LINQ to Entities](../../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)   
+ [Entity Framework のマージ オプションおよびコンパイルされたクエリ](http://go.microsoft.com/fwlink/?LinkId=199591)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/composing-nested-entity-sql-queries.md b/docs/framework/data/adonet/ef/language-reference/composing-nested-entity-sql-queries.md
new file mode 100644
index 00000000000..f79f3b9c1dc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/composing-nested-entity-sql-queries.md
@@ -0,0 +1,90 @@
+---
+title: "入れ子になった Entity SQL クエリの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 685d4cd3-2c1f-419f-bb46-c9d97a351eeb
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 入れ子になった Entity SQL クエリの作成
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、機能の豊富な関数言語です。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の構成要素は式です。  従来の SQL と異なり、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は表形式の結果セットに限定されていません。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、リテラル、パラメーター、入れ子になった式などが含まれた複雑な式を作成できます。  式の値は、パラメーター化されている場合、つまり他の式で構成される場合があります。  
+  
+## 入れ子になった式  
+ 入れ子になった式は、その式によって返される型の値が受け入れられる場所であればどこにでも配置できます。  次に例を示します。  
+  
+```  
+-- Returns a hierarchical collection of three elements at top-level.   
+-- x must be passed in the parameter collection.  
+ROW(@x, {@x}, {@x, 4, 5}, {@x, 7, 8, 9})  
+  
+-- Returns a hierarchical collection of one element at top-level.  
+-- x must be passed in the parameter collection.  
+{{{@x}}};  
+```  
+  
+ 入れ子になったクエリは、projection 句に配置できます。  次に例を示します。  
+  
+```  
+-- Returns a collection of rows where each row contains an Address entity.  
+-- and a collection of references to its corresponding SalesOrderHeader entities.  
+SELECT address, (SELECT DEREF(soh)   
+                    FROM NAVIGATE(address, AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) AS soh)   
+                    AS salesOrderHeader FROM AdventureWorksEntities.Address AS address  
+```  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、入れ子になったクエリを次のようにかっこで囲む必要があります。  
+  
+```  
+-- Pseudo-Entity SQL  
+( SELECT …  
+FROM … )  
+UNION ALL  
+( SELECT …  
+FROM … );  
+```  
+  
+ 「[How to: Order the Union of Two Queries](http://msdn.microsoft.com/ja-jp/853c583a-eaba-4400-830d-be974e735313)」の例では、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] で式を正しく入れ子にする方法を示します。  
+  
+## 投影内の入れ子になったクエリ  
+ project 句内の入れ子になったクエリは、サーバーでデカルト積に変換されないことがあります。  SLQ Server などの一部のバックエンド サーバーでは、これによって TempDB テーブルのサイズが非常に大きくなり、サーバーのパフォーマンスに悪影響を及ぼす場合があります。  
+  
+ 以下は、このようなクエリの例です。  
+  
+```  
+SELECT c, (SELECT c, (SELECT c FROM AdventureWorksModel.Vendor AS c  ) As Inner2 FROM AdventureWorksModel.JobCandidate AS c  ) As Inner1 FROM AdventureWorksModel.EmployeeDepartmentHistory AS c  
+```  
+  
+## 入れ子になったクエリの順序  
+ Entity Framework では、入れ子になった式をクエリ内の任意の場所に配置できます。  Entity SQL ではクエリを柔軟に作成できるので、入れ子になったクエリの順序を含むクエリを記述できます。  ただし、入れ子になったクエリの順序は維持されません。  
+  
+```  
+-- The following query will order the results by last name.  
+SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorksModel.Contact as C1  
+        ORDER BY C1.LastName  
+```  
+  
+```  
+-- In the following query, ordering of the nested query is ignored.  
+SELECT C2.FirstName, C2.LastName  
+    FROM (SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorksModel.Contact as C1  
+        ORDER BY C1.LastName) as C2  
+```  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/constant-expressions.md b/docs/framework/data/adonet/ef/language-reference/constant-expressions.md
new file mode 100644
index 00000000000..48e4e0e6db8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/constant-expressions.md
@@ -0,0 +1,34 @@
+---
+title: "定数式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9d98a7be-b110-4edb-8eba-bed10f250b6d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 定数式
+定数式は、定数値で構成されています。  定数値は、クライアント側で変換されることなく、コマンド ツリーの定数式に直接変換されます。  これには、定数値になる式が含まれます。  したがって、定数にかかわるすべての式でデータ ソースの動作が、予期したとおりになります。  これは CLR の動作とは異なる結果となります。  
+  
+ 次の例では、サーバーで評価される定数式を示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#ConstantExpression](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#constantexpression)]
+ [!code-vb[DP L2E Conceptual Examples#ConstantExpression](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#constantexpression)]  
+  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] では、ユーザー クラスを定数として使用することはできません。  ただし、ユーザー クラスのプロパティ参照は定数と見なされます。そのため、コマンド ツリーの定数式に変換され、データ ソースで実行されます。  
+  
+## 参照  
+ [LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md
new file mode 100644
index 00000000000..82db8124af9
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md
@@ -0,0 +1,81 @@
+---
+title: "コンストラクター (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 41fa7bde-8d20-4a3f-a3d2-fb791e128010
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# コンストラクター (Entity SQL)
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、行コンストラクター、名前付きの型コンストラクター、およびコレクション コンストラクターの 3 種類のコンストラクターが用意されています。  
+  
+## 行コンストラクター  
+ 1 つまたは複数の値から構造的に型付けされた匿名レコードを構築するには、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の行コンストラクターを使用します。  行コンストラクターの結果の型は、行の構築に使用された値の型に対応するフィールド型を持つ行型です。  たとえば、次の式は  `Record(a int, b string, c int)` 型の値を構築します。  
+  
+ `ROW(1 AS a, "abc" AS b, a + 34 AS c)`  
+  
+ 行コンストラクターで式の別名が指定されていなければ、Entity Framework は別名の生成を試みます。  詳細については、「[識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md)」の「別名の規則」を参照してください。  
+  
+ 次の規則は、行コンストラクターで別名を定義する式に適用されます。  
+  
+-   行コンストラクターの式で同じコンストラクターの他の別名を参照することはできません。  
+  
+-   同じ行コンストラクター内の 2 つの式に同じ別名を指定することはできません。  
+  
+ 行コンストラクターの詳細については、「[ROW](../../../../../../docs/framework/data/adonet/ef/language-reference/row-entity-sql.md)」を参照してください。  
+  
+## コレクション コンストラクター  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] のコレクション コンストラクターを使用して、値のリストからマルチセットのインスタンスを作成します。  コンストラクターのすべての値は、相互に互換性のある型 `T` でなければなりません。また、コンストラクターは `Multiset<T>` 型のコレクションを生成します。  たとえば、次の式は整数のコレクションを作成します。  
+  
+ `Multiset(1, 2, 3)`  
+  
+ `{1, 2, 3}`  
+  
+ 要素の型が確認できないため、空のマルチセット コンストラクターは使用できません。  次の式は無効です。  
+  
+ `multiset() {}`  
+  
+ 詳細については、「[MULTISET](../../../../../../docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md)」を参照してください。  
+  
+## 名前付きの型コンストラクター \(NamedType 初期化子\)  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、型コンストラクター \(初期化子\) を使用して、名前付きの複合型およびエンティティ型のインスタンスを作成できます。  たとえば、次の式は `Person` 型のインスタンスを作成します。  
+  
+ `Person("abc", 12)`  
+  
+ 次の式は、複合型のインスタンスを作成する式です。  
+  
+ `MyModel.ZipCode(‘98118’, ‘4567’)`  
+  
+ 次の式は、入れ子になった複合型のインスタンスを作成する式です。  
+  
+ `MyModel.AddressInfo('My street address', 'Seattle', 'WA', MyModel.ZipCode('98118', '4567'))`  
+  
+ 次の式は、入れ子になった複合型を持つエンティティのインスタンスを作成する式です。  
+  
+ `MyModel.Person("Bill", MyModel.AddressInfo('My street address', 'Seattle', 'WA', MyModel.ZipCode('98118', '4567')))`  
+  
+ 次の例は、複合型のプロパティを null に初期化する方法を示しています。  `MyModel.ZipCode(‘98118’, null)`  
+  
+ コンストラクターに対する引数は、型の属性の宣言と同じ順序であると見なされます。  
+  
+ 詳細については、「[名前付きの型コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md)」を参照してください。  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md
new file mode 100644
index 00000000000..4e43e6840a7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md
@@ -0,0 +1,63 @@
+---
+title: "CREATEREF (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 489828cf-a335-4449-9360-b0d92eec5481
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# CREATEREF (Entity SQL)
+エンティティ セット内のエンティティへの参照を作成します。  
+  
+## 構文  
+  
+```  
+  
+CreateRef(entityset_identifier, row_typed_expression)  
+```  
+  
+## 引数  
+ `entityset_identifier`  
+ エンティティ セット識別子。文字列リテラルは使用できません。  
+  
+ `row_typed_expression`  
+ エンティティ型のキー プロパティに対応する行型の式。  
+  
+## 解説  
+ `row_typed_expression` は、エンティティのキーの種類に構造的に同等である必要があります。 つまり、エンティティ キーのフィールドの数、型、および順序と一致している必要があります。  
+  
+ 次の例では、Orders と BadOrders は両方とも Order 型のエンティティ セットで、ID は Order の 1 つのキー プロパティであると見なされます。 この例は、BadOrders 内のエンティティへの参照を生成する方法を示しています。 参照は未解決の場合がある点に注意してください。  つまり、参照は実際には指定のエンティティを識別しない場合があります。 そのような場合、その参照に対して `DEREF` 操作を行うと、null が返されます。  
+  
+```  
+select CreateRef(LOB.BadOrders, row(o.Id))   
+from LOB.Orders as o   
+```  
+  
+## 使用例  
+ 次の Entity SQL クエリは、CREATEREF 演算子を使用してエンティティ セット内のエンティティへの参照を作成します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#CREATEREF](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#createref)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md)   
+ [KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md)   
+ [REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/csdl-specification.md b/docs/framework/data/adonet/ef/language-reference/csdl-specification.md
new file mode 100644
index 00000000000..15f19233026
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/csdl-specification.md
@@ -0,0 +1,26 @@
+---
+title: "CSDL 仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 6bb94c37-87da-447a-8dfd-83d1c4b5a2d2
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# CSDL 仕様
+現在、[msdn.microsoft.com\/data\/ef](http://msdn.microsoft.com/data/ef) サイトでは、主に Entity Framework に関するコンテンツを提供しています。  
+  
+ このトピックの内容は、「[CSDL 仕様](http://msdn.microsoft.com/data/jj652004)」ページでご利用いただけます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md b/docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md
new file mode 100644
index 00000000000..80978c6c015
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md
@@ -0,0 +1,26 @@
+---
+title: "CSDL、SSDL、および MSL 仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bbdc9237-ff4c-4441-9565-31ebc29743e9
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# CSDL、SSDL、および MSL 仕様
+現在、[msdn.microsoft.com\/data\/ef](http://msdn.microsoft.com/data/ef) サイトでは、主に Entity Framework に関するコンテンツを提供しています。  
+  
+ このトピックの内容は、「[EDMX ファイル](http://msdn.microsoft.com/data/jj650889)」ページでご利用いただけます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md
new file mode 100644
index 00000000000..a7051ae149f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md
@@ -0,0 +1,71 @@
+---
+title: "日付と時刻の正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9628b74f-1585-436a-b385-8b02ed0cdd63
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 日付と時刻の正規関数
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、日付および時刻の正規関数が含まれます。  
+  
+## 解説  
+ 次の表に、日付と時刻の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数を示します。`datetime` は、<xref:System.DateTime> 値です。  
+  
+|関数|説明|  
+|--------|--------|  
+|`AddNanoseconds(` `expression`, `number``)`|指定されたナノ秒数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddMicroseconds(` `expression`, `number``)`|指定されたマイクロ秒数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddMilliseconds(` `expression`, `number``)`|指定されたミリ秒数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddSeconds(` `expression`, `number``)`|指定された秒数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddMinutes(` `expression`, `number``)`|指定された分数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddHours(` `expression`, `number``)`|指定された時間数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`、`DateTime`、`DateTimeOffset`、または `Time`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddDays(` `expression`, `number``)`|指定された日数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`: `DateTime` または `DateTimeOffset`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddMonths(` `expression`, `number``)`|指定された月数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`: `DateTime` または `DateTimeOffset`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`AddYears(` `expression`, `number``)`|指定された年数を表す `number` を `expression` に追加します。<br /><br /> **引数**<br /><br /> `expression`: `DateTime` または `DateTimeOffset`。<br /><br /> `number`: `Int32`.<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`CreateDateTime(` `year`, `month`, `day`, `hour`, `minute`, `second``)`|サーバーのタイム ゾーンでのサーバーの現在の日時として新しい `DateTime` 値を返します。<br /><br /> **引数**<br /><br /> `year`、`month`、`day`、`hour`、`minute`: `Int16` および `Int32`。<br /><br /> `second`: `Double`.<br /><br /> **戻り値**<br /><br /> `DateTime`|  
+|`CreateDateTimeOffset(` `year`, `month`, `day`, `hour`, `minute`, `second`, `tzoffset``)`|世界協定時刻 \(UTC\) を基準としたサーバーの現在の日時として新しい `DateTimeOffset` 値を返します。<br /><br /> **引数**<br /><br /> `year`, `month`, `day`, `hour`, `minute`, `tzoffset`: `Int32`.<br /><br /> `second`: `Double`.<br /><br /> **戻り値**<br /><br /> `DateTimeOffset`|  
+|`CreateTime(` `hour`, `minute`, `second``)`|現在の時刻として新しい `Time` 値を返します。<br /><br /> **引数**<br /><br /> `hour` および `minute`: `Int32`。<br /><br /> `second`: `Double`.<br /><br /> **戻り値**<br /><br /> `Time`|  
+|`CurrentDateTime()`|サーバーのタイム ゾーンでのサーバーの現在の日時として `DateTime` 値を返します。<br /><br /> **戻り値**<br /><br /> `DateTime`|  
+|`CurrentDateTimeOffset()`|現在の日付、時刻、およびオフセットを `DateTimeOffset` として返します。<br /><br /> **戻り値**<br /><br /> `DateTimeOffset`|  
+|`CurrentUtcDateTime()`|UTS タイム ゾーンでのサーバーの現在の日時として <xref:System.DateTime> 値を返します。<br /><br /> **戻り値**<br /><br /> `DateTime`|  
+|`Day(` `expression` `)`|1 ～ 31 の間の `Int32` として `expression` の日付の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime` および `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 12.`<br /><br /> `Day(cast('03/12/1998' as DateTime))`|  
+|`DayOfYear(` `expression` `)`|`expression` の日付の部分を 1 ～ 366 の間の `Int32` として返します。366 はうるう年の最後の日に対して返されます。<br /><br /> **引数**<br /><br /> `DateTime` または `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffNanoseconds(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差をナノ秒単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffMilliseconds(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差をミリ秒単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffMicroseconds(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差をマイクロ秒単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffSeconds(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を秒単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffMinutes(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を分単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffHours(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を時間単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime`、`DateTimeOffset`、または `Time`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffDays(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を日単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime` または `DateTimeOffset`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffMonths(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を月単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime` または `DateTimeOffset`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`DiffYears(` `startExpression`, `endExpression``)`|`startExpression` と `endExpression` の差を年単位で返します。<br /><br /> **引数**<br /><br /> `startExpression`、`endExpression`: `DateTime` または `DateTimeOffset`。 **Note:**  `startExpression` と `endExpression` は、同じ型である必要があります。 <br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`GetTotalOffsetMinutes(` `datetimeoffset` `)`|GMT からのオフセット `datetimeoffset` \(分数\) を返します。  この値は通常、\+780 ～ \-780 \(\+ 13 時間～ \- 13 時間\) の間になります。 **Note:**  この関数は、SQL Server 2008 でのみサポートされます。 <br /><br /> **引数**<br /><br /> `DateTimeOffset`<br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`Hour (` `expression` `)`|0 ～ 23 の間の `Int32` として `expression` の時間の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime, Time` および `DateTimeOffset`。<br /><br /> **例**<br /><br /> `-- The following example returns 22.`<br /><br /> `Hour(cast('22:35:5' as DateTime))`|  
+|`Millisecond(` `expression` `)`|0 ～ 999 の間の `Int32` として `expression` のミリ秒の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime, Time` および `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。|  
+|`Minute(` `expression` `)`|0 ～ 59 の間の `Int32` として `expression` の分の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime, Time` または `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 35`<br /><br /> `Minute(cast('22:35:5' as DateTime))`|  
+|`Month` `(``expression``)`|1 ～ 12 の間の `Int32` として `expression` の月の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime` または `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 3.`<br /><br /> `Month(cast('03/12/1998' as DateTime))`|  
+|`Second(` `expression` `)`|0 ～ 59 の間の `Int32` として `expression` の秒の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime, Time` および `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 5`<br /><br /> `Second(cast('22:35:5' as DateTime))`|  
+|`TruncateTime(` `expression` `)`|時間の値が切り捨てられた `expression` を返します。<br /><br /> **引数**<br /><br /> `DateTime` または `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `expression` の型。|  
+|`Year(` `expression` `)`|`Int32` `YYYY` として `expression` の年の部分を返します。<br /><br /> **引数**<br /><br /> `DateTime` および `DateTimeOffset`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 1998.`<br /><br /> `Year(cast('03/12/1998' as DateTime))`|  
+  
+ `null` が入力された場合、これらの関数は `null` を返します。  
+  
+ 同等の機能は、Microsoft SQL クライアント マネージ プロバイダーでも利用できます。  詳細については、「[Entity Framework 用 SqlClient 関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md
new file mode 100644
index 00000000000..bbe83deec50
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md
@@ -0,0 +1,57 @@
+---
+title: "DEREF (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 4c78e833-b260-453d-9bf4-eb39857dd0fa
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DEREF (Entity SQL)
+参照値を逆参照し、その逆参照の結果を生成します。  
+  
+## 構文  
+  
+```  
+  
+SELECT DEREF ( o.expression) from Table as o;  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効なクエリ式。  
+  
+## 戻り値  
+ 参照されるエンティティの値。  
+  
+## 解説  
+ DEREF 演算子は参照値を逆参照し、その逆参照の結果を生成します。 たとえば、 `r`  が ref\<T\> 型の参照である場合、 `Deref` `(r)`  は  `r` によって参照されるエンティティを生成する  `T`  型の式です。 参照値が null または未解決 \(つまり、参照先が存在しない\) の場合、DEREF 演算子の結果は null になります。  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、DEREF 演算子を使用して参照値を逆参照し、その逆参照の結果を生成します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として ExecutePrimitiveTypeQuery メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#DEREF](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#deref)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md)   
+ [CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md)   
+ [KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md)   
+ [NULL 値が許容される構造化型](../../../../../../docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/divide-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/divide-entity-sql.md
new file mode 100644
index 00000000000..398fb598f94
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/divide-entity-sql.md
@@ -0,0 +1,56 @@
+---
+title: "/ (除算) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ef48c368-f3ed-4275-8ada-4e9649781262
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# / (除算) (Entity SQL)
+1 つの値を別の値で除算します。  
+  
+## 構文  
+  
+```  
+  
+dividend  
+/  
+divisor  
+  
+```  
+  
+## 引数  
+ `dividend`  
+ 除算する数値式。`dividend` は、任意の数値データ型の有効な式です。  
+  
+ `divisor`  
+ 被除数を除算する数値式。`divisor` は、任意の数値データ型の有効な式です。  
+  
+## 戻り値の型  
+ 2 つの引数の暗黙の型の昇格の結果であるデータ型。 暗黙の型の昇格について詳しくは、「[型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\/ 算術演算子を使用して 2 つの数値の間で除算をします。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#DIVIDE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#divide)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/entity-sql-language.md b/docs/framework/data/adonet/ef/language-reference/entity-sql-language.md
new file mode 100644
index 00000000000..7a78220f3c3
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/entity-sql-language.md
@@ -0,0 +1,95 @@
+---
+title: "Entity SQL 言語 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9e7d8837-28c5-429d-a824-7bafb59724cf
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Entity SQL 言語
+Entity SQL は、ストレージに依存しない SQL と似たクエリ言語です。  Entity SQL を使用すると、オブジェクトとして、または表形式でエンティティ データに対してクエリを実行できます。  次の場合には Entity SQL の使用を検討してください。  
+  
+-   クエリを実行時に動的に作成する必要がある場合。  その場合、実行時に Entity SQL クエリ文字列を作成する代わりに、<xref:System.Data.Objects.ObjectQuery%601> のクエリ ビルダー メソッドを使用することも検討してください。  
+  
+-   モデル定義の一部としてクエリを定義する場合。  データ モデルでは Entity SQL のみがサポートされます。  詳細については、「[QueryView Element \(MSL\)](http://msdn.microsoft.com/ja-jp/f0426b34-45cb-4fd7-9777-e0570c5e0e80)」を参照してください。  
+  
+-   EntityClient で <xref:System.Data.EntityClient.EntityDataReader> を使用して行セットとして読み取り専用エンティティ データを返す場合。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+-   SQL ベースのクエリ言語に詳しい場合、Entity SQL の使用が最も適切に思われるでしょう。  
+  
+## Entity SQL と EntityClient プロバイダーの使用  
+ Entity SQL を EntityClient プロバイダーと一緒に使用する際の詳細については、次のトピックを参照してください。  
+  
+ [Entity Framework 用の EntityClient プロバイダー](../../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)  
+  
+ [EntityConnection の接続文字列を作成する方法](../../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)  
+  
+ [PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)  
+  
+ [StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)  
+  
+ [RefType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-reftype-results.md)  
+  
+ [複合型を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-complex-types.md)  
+  
+ [入れ子になったコレクションを返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-nested-collections.md)  
+  
+ [EntityCommand を使用してパラメーター化 Entity SQL クエリを実行する方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-parameterized-entity-sql-query-using-entitycommand.md)  
+  
+ [EntityCommand を使用してパラメーター化されたストアド プロシージャを実行する方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-parameterized-stored-procedure-using-entitycommand.md)  
+  
+ [ポリモーフィック クエリを実行する方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-polymorphic-query.md)  
+  
+ [Navigate 演算子でリレーションシップをナビゲートする方法](../../../../../../docs/framework/data/adonet/ef/how-to-navigate-relationships-with-the-navigate-operator.md)  
+  
+## Entity SQL とオブジェクト クエリの使用  
+ Entity SQL をオブジェクト クエリと一緒に使用する際の詳細については、次のトピックを参照してください。  
+  
+ [How to: Execute a Query that Returns Entity Type Objects](http://msdn.microsoft.com/ja-jp/f73e137d-1534-42bb-9e31-99ca42c19b48)  
+  
+ [How to: Execute a Parameterized Query](http://msdn.microsoft.com/ja-jp/42048f03-c65c-4d98-b50a-3e7d537a63e8)  
+  
+ [How to: Navigate Relationships Using Navigation Properties](http://msdn.microsoft.com/ja-jp/b1d71c7d-16a7-4b46-96ac-690176bd5057)  
+  
+ [How to: Call a User\-Defined Function](http://msdn.microsoft.com/ja-jp/ad131b86-8b4e-4747-8605-d4fc64fb9d02)  
+  
+ [How to: Filter Data](http://msdn.microsoft.com/ja-jp/776f8556-3350-4572-804a-b1513515c1b2)  
+  
+ [How to: Sort Data](http://msdn.microsoft.com/ja-jp/c05f2506-cb9d-4ebc-822b-300042ad53e7)  
+  
+ [How to: Group Data](http://msdn.microsoft.com/ja-jp/df801d9d-9a8a-4157-97a6-5016b18998e1)  
+  
+ [How to: Aggregate Data](http://msdn.microsoft.com/ja-jp/4cf04ce8-3c0f-4f88-9d97-8fac8622598d)  
+  
+ [How to: Execute a Query that Returns Anonymous Type Objects](http://msdn.microsoft.com/ja-jp/3b264025-e911-4d73-90ce-992d2b9d189d)  
+  
+ [How to: Execute a Query that Returns a Collection of Primitive Types](http://msdn.microsoft.com/ja-jp/115b52c0-4f27-4253-8991-284b450000b5)  
+  
+ [How to: Query Related Objects in an EntityCollection](http://msdn.microsoft.com/ja-jp/11ce946f-16f8-4c1d-9d80-f740853807ba)  
+  
+ [How to: Order the Union of Two Queries](http://msdn.microsoft.com/ja-jp/853c583a-eaba-4400-830d-be974e735313)  
+  
+ [How to: Page Through Query Results](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)  
+  
+## このセクションの内容  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)  
+  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../../docs/framework/data/adonet/ef/index.md)   
+ [言語リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md b/docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md
new file mode 100644
index 00000000000..f869e0c53ba
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md
@@ -0,0 +1,78 @@
+---
+title: "Entity SQL の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: f0bb8120-e709-40a3-ac1e-5520dc47477d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity SQL の概要
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] 内の概念モデルに対するクエリの実行に使用できる SQL に似た言語です。  概念モデルは、データをエンティティおよびリレーションシップとして表します。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] を使用すると、SQL を使用したことのあるユーザーが慣れている形式でそれらのエンティティおよびリレーションシップに対してクエリを実行できます。  
+  
+ [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] は、ストレージ固有のデータ プロバイダーと連携し、汎用的な [!INCLUDE[esql](../../../../../../includes/esql-md.md)] をストレージ固有のクエリに変換します。  EntityClient プロバイダーには、エンティティ モデルに対して [!INCLUDE[esql](../../../../../../includes/esql-md.md)] コマンドを実行し、スカラー結果、結果セット、オブジェクト グラフなど、さまざまなデータ型を返すための手段が用意されています。  <xref:System.Data.EntityClient.EntityCommand> オブジェクトを構築する場合は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のクエリ文字列を <xref:System.Data.EntityClient.EntityCommand.CommandText%2A?displayProperty=fullName> プロパティに割り当てることで、ストアド プロシージャの名前またはクエリのテキストを指定できます。  EDM に対する <xref:System.Data.EntityClient.EntityCommand> の実行結果は、<xref:System.Data.EntityClient.EntityDataReader> によって公開されます。  <xref:System.Data.EntityClient.EntityDataReader> を返すコマンドを実行するには、<xref:System.Data.EntityClient.EntityCommand.ExecuteReader%2A> を呼び出します。  
+  
+ EntityClient プロバイダーだけでなく [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] でも、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] を使用して概念モデルに対するクエリを実行し、エンティティ型のインスタンスである厳密に型指定された CLR オブジェクトとしてデータを返すことができます。  詳細については、「[オブジェクトの使用](../../../../../../docs/framework/data/adonet/ef/working-with-objects.md)」を参照してください。  
+  
+ ここでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の概念について説明します。  
+  
+## このセクションの内容  
+ [Entity SQL と Transact\-SQL の相違点](../../../../../../docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md)  
+  
+ [Entity SQL クイック リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-quick-reference.md)  
+  
+ [型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)  
+  
+ [型定義](../../../../../../docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md)  
+  
+ [コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)  
+  
+ [クエリ プランのキャッシュ](../../../../../../docs/framework/data/adonet/ef/language-reference/query-plan-caching-entity-sql.md)  
+  
+ [名前空間](../../../../../../docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md)  
+  
+ [識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md)  
+  
+ [パラメーター](../../../../../../docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md)  
+  
+ [変数](../../../../../../docs/framework/data/adonet/ef/language-reference/variables-entity-sql.md)  
+  
+ [サポートされていない式](../../../../../../docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md)  
+  
+ [リテラル](../../../../../../docs/framework/data/adonet/ef/language-reference/literals-entity-sql.md)  
+  
+ [NULL リテラルと型推論](../../../../../../docs/framework/data/adonet/ef/language-reference/null-literals-and-type-inference-entity-sql.md)  
+  
+ [入力文字セット](../../../../../../docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md)  
+  
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)  
+  
+ [関数](../../../../../../docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md)  
+  
+ [演算子の優先順位](../../../../../../docs/framework/data/adonet/ef/language-reference/operator-precedence-entity-sql.md)  
+  
+ [ページング](../../../../../../docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md)  
+  
+ [比較セマンティクス](../../../../../../docs/framework/data/adonet/ef/language-reference/comparison-semantics-entity-sql.md)  
+  
+ [入れ子になった Entity SQL クエリの作成](../../../../../../docs/framework/data/adonet/ef/language-reference/composing-nested-entity-sql-queries.md)  
+  
+ [NULL 値が許容される構造化型](../../../../../../docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md)  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL 言語](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)   
+ [CSDL、SSDL、および MSL 仕様](../../../../../../docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/entity-sql-quick-reference.md b/docs/framework/data/adonet/ef/language-reference/entity-sql-quick-reference.md
new file mode 100644
index 00000000000..fdc00dd9fbb
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/entity-sql-quick-reference.md
@@ -0,0 +1,378 @@
+---
+title: "Entity SQL クイック リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: e53dad9e-5e83-426e-abb4-be3e78e3d6dc
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity SQL クイック リファレンス
+このトピックでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリのクイック リファレンスを提供します。  このトピックのクエリでは、AdventureWorks Sales Model が使用されています。  
+  
+## リテラル  
+  
+### String  
+ Unicode と非 Unicode の文字列リテラルがあります。  Unicode 文字列には、  たとえば、`N'hello'` のようにします。  
+  
+ 非 Unicode 文字列リテラルの例を次に示します。  
+  
+```  
+'hello'  
+--same as  
+"hello"  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|hello|  
+  
+### DateTime  
+ DateTime リテラルでは、日付部分と時刻部分の両方が必須です。  既定値はありません。  
+  
+ 例:  
+  
+```  
+DATETIME '2006-12-25 01:01:00.000'   
+--same as  
+DATETIME '2006-12-25 01:01'  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|12\/25\/2006 1:01:00 AM|  
+  
+### 整数  
+ 整数リテラルには Int32 \(123\) 型、UInt32 \(123U\) 型、Int64 \(123L\) 型、および UInt64 \(123UL\) 型があります。  
+  
+ 例:  
+  
+```  
+--a collection of integers  
+{1, 2, 3}  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|1|  
+|2|  
+|3|  
+  
+### その他  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] でサポートされているその他のリテラルは、Guid、Binary、Float\/Double、Decimal、および `null` です。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の NULL リテラルは、概念モデルのその他すべての型と互換性があると見なされます。  
+  
+## 型コンストラクター  
+  
+### ROW  
+ [ROW](../../../../../../docs/framework/data/adonet/ef/language-reference/row-entity-sql.md) は、構造的に型指定された匿名のレコード値を作成します。`ROW(1 AS myNumber, ‘Name’ AS myName).`  
+  
+ 例:  
+  
+```  
+SELECT VALUE row (product.ProductID as ProductID, product.Name   
+    as ProductName) FROM AdventureWorksEntities.Product AS product  
+```  
+  
+ Output:  
+  
+|ProductID|名前|  
+|---------------|--------|  
+|1|Adjustable Race|  
+|879|All\-Purpose Bike Stand|  
+|712|AWC Logo Cap|  
+|...|...|  
+  
+### MULTISET  
+ [MULTISET](../../../../../../docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md) は、次のようなコレクションを作成します。  
+  
+ `MULTISET(1,2,2,3)` `--same as`\-`{1,2,2,3}.`  
+  
+ 例:  
+  
+```  
+SELECT VALUE product FROM AdventureWorksEntities.Product AS product WHERE product.ListPrice IN MultiSet (125, 300)  
+```  
+  
+ Output:  
+  
+|ProductID|名前|ProductNumber|…|  
+|---------------|--------|-------------------|-------|  
+|842|Touring\-Panniers, Large|PA\-T100|…|  
+  
+### Object  
+ [名前付きの型コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md) は、`person("abc", 12)` のように、名前付きのユーザー定義オブジェクトを作成します。  
+  
+ 例:  
+  
+```  
+SELECT VALUE AdventureWorksModel.SalesOrderDetail (o.SalesOrderDetailID, o.CarrierTrackingNumber, o.OrderQty,   
+o.ProductID, o.SpecialOfferID, o.UnitPrice, o.UnitPriceDiscount,   
+o.rowguid, o.ModifiedDate) FROM AdventureWorksEntities.SalesOrderDetail   
+AS o  
+```  
+  
+ Output:  
+  
+|SalesOrderDetailID|CarrierTrackingNumber|OrderQty|ProductID|...|  
+|------------------------|---------------------------|--------------|---------------|---------|  
+|1|4911\-403C\-98|1|776|...|  
+|2|4911\-403C\-98|3|777|...|  
+|...|...|...|...|...|  
+  
+## 参照  
+  
+### REF  
+ [REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md) は、エンティティ型のインスタンスへの参照を作成します。  たとえば、次のクエリは、Orders エンティティ セットの各 Order エンティティへの参照を返します。  
+  
+```  
+SELECT REF(o) AS OrderID FROM Orders AS o  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|1|  
+|2|  
+|3|  
+|...|  
+  
+ 次の例では、プロパティ抽出演算子 \(.\) を使用して、エンティティのプロパティにアクセスします。  プロパティ抽出演算子を使用すると、参照は自動的に逆参照されます。  
+  
+ 例:  
+  
+```  
+SELECT VALUE REF(p).Name FROM   
+    AdventureWorksEntities.Product as p  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|Adjustable Race|  
+|All\-Purpose Bike Stand|  
+|AWC Logo Cap|  
+|...|  
+  
+### DEREF  
+ [DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md) は参照値を逆参照し、その逆参照の結果を生成します。  たとえば、次のクエリは、`SELECT DEREF(o2.r) FROM (SELECT REF(o) AS r FROM LOB.Orders AS o) AS o2` のように、Orders エンティティ セットの各 Order について Order エンティティを生成します。  
+  
+ 例:  
+  
+```  
+SELECT VALUE DEREF(REF(p)).Name FROM   
+    AdventureWorksEntities.Product as p  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|Adjustable Race|  
+|All\-Purpose Bike Stand|  
+|AWC Logo Cap|  
+|...|  
+  
+### CREATEREF と KEY  
+ [CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md) は、キーを渡す参照を作成します。  [KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md) は、型参照を持つ式のキー部分を抽出します。  
+  
+ 例:  
+  
+```  
+SELECT VALUE Key(CreateRef(AdventureWorksEntities.Product, row(p.ProductID)))   
+    FROM AdventureWorksEntities.Product as p  
+```  
+  
+ Output:  
+  
+|ProductID|  
+|---------------|  
+|980|  
+|365|  
+|771|  
+|...|  
+  
+## 関数  
+  
+### 正規  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)の名前空間は Edm で、`Edm.Length("string")` のように使用されます。  正規関数と同じ名前の関数を含んでいる別の名前空間がインポートされない限り、名前空間を指定する必要はありません。  2 つの名前空間に同じ関数が存在する場合は、完全な名前を指定する必要があります。  
+  
+ 例:  
+  
+```  
+SELECT Length(c. FirstName) As NameLen FROM   
+    AdventureWorksEntities.Contact AS c   
+    WHERE c.ContactID BETWEEN 10 AND 12  
+```  
+  
+ Output:  
+  
+|NameLen|  
+|-------------|  
+|6|  
+|6|  
+|5|  
+  
+### Microsoft プロバイダー固有  
+ [Microsoft プロバイダー固有の関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)は、`SqlServer` 名前空間にあります。  
+  
+ 例:  
+  
+```  
+SELECT SqlServer.LEN(c.EmailAddress) As EmailLen FROM   
+    AdventureWorksEntities.Contact AS c WHERE   
+    c.ContactID BETWEEN 10 AND 12  
+```  
+  
+ Output:  
+  
+|EmailLen|  
+|--------------|  
+|27|  
+|27|  
+|26|  
+  
+## 名前空間  
+ [USING](../../../../../../docs/framework/data/adonet/ef/language-reference/using-entity-sql.md) は、クエリ式で使用する名前空間を指定します。  
+  
+ 例:  
+  
+```  
+using SqlServer; LOWER('AA');  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|aa|  
+  
+## ページング  
+ ページングは、[SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md) および [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md) サブ句を [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) 句に宣言することによって表現できます。  
+  
+ 例:  
+  
+```  
+SELECT c.ContactID as ID, c.LastName as Name FROM   
+    AdventureWorks.Contact AS c ORDER BY c.ContactID SKIP 9 LIMIT 3;  
+```  
+  
+ Output:  
+  
+|ID|名前|  
+|--------|--------|  
+|10|Adina|  
+|11|Agcaoili|  
+|12|Aguilar|  
+  
+## グループ化  
+ [GROUPING BY](../../../../../../docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md) は、クエリ \([SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)\) 式によって返されるオブジェクトをグループ化するよう指定します。  
+  
+ 例:  
+  
+```  
+SELECT VALUE name FROM AdventureWorksEntities.Product as P   
+    GROUP BY P.Name HAVING MAX(P.ListPrice) > 5  
+```  
+  
+ Output:  
+  
+|name|  
+|----------|  
+|LL Mountain Seat Assembly|  
+|ML Mountain Seat Assembly|  
+|HL Mountain Seat Assembly|  
+|...|  
+  
+## ナビゲーション  
+ リレーションシップ ナビゲーション操作を使用すると、開始側のエンティティと終了側のエンティティ間のリレーションシップをナビゲートできます。  [NAVIGATE](../../../../../../docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md) は、\<namespace\>.\<relationship type name\> として修飾されるリレーションシップ型をとります。  終了側の基数が 1 の場合、Ref\<T\> が返されます。  終端の基数が n の場合、Collection\<Ref\<T\>\> が返されます。  
+  
+ 例:  
+  
+```  
+SELECT a.AddressID, (SELECT VALUE DEREF(v) FROM   
+    NAVIGATE(a, AdventureWorksModel.FK_SalesOrderHeader_Address_BillToAddressID) AS v)   
+    FROM AdventureWorksEntities.Address AS a  
+```  
+  
+ Output:  
+  
+|AddressID|  
+|---------------|  
+|1|  
+|2|  
+|3|  
+|...|  
+  
+## SELECT VALUE AND SELECT  
+  
+### SELECT VALUE  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、暗黙の行の構築をスキップする SELECT VALUE 句が用意されています。  SELECT VALUE 句には 1 つの項目のみを指定できます。  このような句を使用した場合、SELECT 句内の項目には row ラッパーは構築されず、`SELECT VALUE a` などの目的の構造を持つコレクションを作成できます。  
+  
+ 例:  
+  
+```  
+SELECT VALUE p.Name FROM AdventureWorksEntities.Product as p  
+```  
+  
+ Output:  
+  
+|名前|  
+|--------|  
+|Adjustable Race|  
+|All\-Purpose Bike Stand|  
+|AWC Logo Cap|  
+|...|  
+  
+### SELECT  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、任意の行を構築するための行コンストラクターも用意されています。  SELECT は、投影内の 1 つまたは複数の要素、および `SELECT a, b, c` などのフィールドを持つデータ レコードの結果を取得します。  
+  
+ 例:  
+  
+ SELECT p.Name, p.ProductID FROM AdventureWorksEntities.Product as p Output:  
+  
+|名前|ProductID|  
+|--------|---------------|  
+|Adjustable Race|1|  
+|All\-Purpose Bike Stand|879|  
+|AWC Logo Cap|712|  
+|...|...|  
+  
+## CASE 式  
+ [CASE 式](../../../../../../docs/framework/data/adonet/ef/language-reference/case-entity-sql.md)は、一連のブール式を評価して結果を判定します。  
+  
+ 例:  
+  
+```  
+CASE WHEN AVG({25,12,11}) < 100 THEN TRUE ELSE FALSE END  
+```  
+  
+ Output:  
+  
+|値|  
+|-------|  
+|TRUE|  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md b/docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md
new file mode 100644
index 00000000000..0600fda7553
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md
@@ -0,0 +1,145 @@
+---
+title: "Entity SQL リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 61ce7ee1-ffe2-477d-8a9f-835b0a11d900
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity SQL リファレンス
+このセクションには、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] リファレンス トピックがあります。このトピックでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の演算子について概要を説明し、カテゴリ別に分類しています。  
+  
+## 算術演算子  
+ 算術演算子は、数値データ型が 1 つ以上含まれる 2 つの式の間で、数学的な操作を実行します。  次の表は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の算術演算子の一覧です。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[\+ \(加算\)](../../../../../../docs/framework/data/adonet/ef/language-reference/add.md)|加算。|  
+|[\/ \(除算\)](../../../../../../docs/framework/data/adonet/ef/language-reference/divide-entity-sql.md)|除算。|  
+|[% \(剰余\)](../../../../../../docs/framework/data/adonet/ef/language-reference/modulo-entity-sql.md)|除算の剰余|  
+|[\* \(乗算\)](../../../../../../docs/framework/data/adonet/ef/language-reference/multiply-entity-sql.md)|乗算。|  
+|[\- \(負符号\)](../../../../../../docs/framework/data/adonet/ef/language-reference/negative-entity-sql.md)|否定|  
+|[\- \(減算\)](../../../../../../docs/framework/data/adonet/ef/language-reference/subtract-entity-sql.md)|減算。|  
+  
+## 正規関数  
+ 正規関数とは、すべてのデータ プロバイダーがサポートし、あらゆるクエリ テクノロジで使用できる関数です。  次の表に正規関数を示します。  
+  
+|関数|種類|  
+|--------|--------|  
+|[集計 Entity SQL 正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/aggregate-canonical-functions.md)|集計 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。|  
+|[数値演算正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md)|数学 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。|  
+|[文字列正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md)|文字列 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。|  
+|[日付と時刻の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/date-and-time-canonical-functions.md)|日付および時刻の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。|  
+|[ビット単位の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/bitwise-canonical-functions.md)|ビット単位の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数について説明します。|  
+|[その他の正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/other-canonical-functions.md)|ビット単位、日付\/時刻、文字列、数学、または集計に分類されない関数について説明します。|  
+  
+## 比較演算子  
+ 比較演算子は、`Byte`、`Int16`、`Int32`、`Int64`、`Double`、`Single`、`Decimal`、`String`、`DateTime`、`Date`、`Time`、`DateTimeOffset` のデータ型に対して定義されます。  比較演算子が適用される前に、オペランドに対して暗黙の型の昇格が行われます。  比較演算子は常にブール値を取得します。  1 つ以上のオペランドが `null` である場合、結果は `null` になります。  
+  
+ 等価演算子および非等価演算子は、`Boolean` 型など、ID を持つオブジェクト型に対して定義されます。  ID を含む非プリミティブ オブジェクトは、同じ ID を共有している場合に等価と見なされます。  次の表は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の比較演算子の一覧です。  
+  
+|演算子|説明|  
+|---------|--------|  
+|[\= \(等しい\)](../../../../../../docs/framework/data/adonet/ef/language-reference/equals-entity-sql.md)|2 つの式の等価性を比較します。|  
+|[\> \(より大きい\)](../../../../../../docs/framework/data/adonet/ef/language-reference/greater-than-entity-sql.md)|2 つの式を比較して、左の式の値が右の式の値よりも大きいかどうかを判別します。|  
+|[\>\= \(以上\)](../../../../../../docs/framework/data/adonet/ef/language-reference/greater-than-or-equal-to-entity-sql.md)|2 つの式を比較して、左の式の値が右の式の値以上であるかどうかを判別します。|  
+|[IS &#91;NOT&#93; NULL](../../../../../../docs/framework/data/adonet/ef/language-reference/isnull-entity-sql.md)|クエリ式が NULL かどうかを調べます。|  
+|[\< \(より小さい\)](../../../../../../docs/framework/data/adonet/ef/language-reference/less-than-entity-sql.md)|2 つの式を比較して、左の式の値が右の式の値よりも小さいかどうかを判別します。|  
+|[\<\= \(以下\)](../../../../../../docs/framework/data/adonet/ef/language-reference/less-than-or-equal-to-entity-sql.md)|2 つの式を比較して、左の式の値が右の式の値以下であるかどうかを判別します。|  
+|[&#91;NOT&#93; BETWEEN](../../../../../../docs/framework/data/adonet/ef/language-reference/between-entity-sql.md)|式の結果が指定の範囲内の値になるかどうかを判断します。|  
+|[\!\= \(等しくない\)](../../../../../../docs/framework/data/adonet/ef/language-reference/not-equal-to-entity-sql.md)|2 つの式を比較して、左の式の値が右の式の値と等しくないかどうかを判別します。|  
+|[&#91;NOT&#93; LIKE](../../../../../../docs/framework/data/adonet/ef/language-reference/like-entity-sql.md)|指定された文字列が指定されたパターンと一致するかどうかを判断します。|  
+  
+## 論理演算子と CASE 式演算子  
+ 論理演算子は、条件の真偽をテストします。  CASE 式は、一連のブール式を評価して結果を判定します。  次の表に論理演算子と CASE 式演算子を示します。  
+  
+|演算子|説明|  
+|---------|--------|  
+|[&& \(論理 AND\)](../../../../../../docs/framework/data/adonet/ef/language-reference/and-entity-sql.md)|論理 AND。|  
+|[\!  \(論理 NOT\)](../../../../../../docs/framework/data/adonet/ef/language-reference/not-entity-sql.md)|論理 NOT。|  
+|[&#124;&#124; \(論理 OR\)](../../../../../../docs/framework/data/adonet/ef/language-reference/or-entity-sql.md)|論理 OR。|  
+|[CASE](../../../../../../docs/framework/data/adonet/ef/language-reference/case-entity-sql.md)|一連のブール式を評価して結果を決定します。|  
+|[THEN](../../../../../../docs/framework/data/adonet/ef/language-reference/then-entity-sql.md)|[WHEN](http://msdn.microsoft.com/ja-jp/6233fe9f-00b0-460e-8372-64e138a5f998) 句が true に評価された場合の結果です。|  
+  
+## クエリ演算子  
+ クエリ演算子は、エンティティ データを返すクエリ式を定義するために使用されます。  次の表にクエリ演算子を示します。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[FROM](../../../../../../docs/framework/data/adonet/ef/language-reference/from-entity-sql.md)|[SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md) ステートメントで使用するコレクションを指定します。|  
+|[GROUP BY](../../../../../../docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md)|クエリ \([SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)\) 式によって返されるオブジェクトをグループ化するよう指定します。|  
+|[GroupPartition](../../../../../../docs/framework/data/adonet/ef/language-reference/grouppartition-entity-sql.md)|引数値のコレクションを返します。この値は、集計の関係先であるグループ パーティションから投影されたものです。|  
+|[HAVING](../../../../../../docs/framework/data/adonet/ef/language-reference/having-entity-sql.md)|グループまたは集計の検索条件を指定します。|  
+|[LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md)|[ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) 句と共に使用されて、物理ページングを実行します。|  
+|[ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md)|[SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md) ステートメントで返されるオブジェクトで使用される並べ替え順を指定します。|  
+|[SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)|クエリによって返される投影の要素を指定します。|  
+|[SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md)|[ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) 句と共に使用されて、物理ページングを実行します。|  
+|[TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)|クエリ結果の先頭から指定した行セットだけを返すよう指定します。|  
+|[WHERE](../../../../../../docs/framework/data/adonet/ef/language-reference/where-entity-sql.md)|クエリによって返されるデータを条件に基づいてフィルター処理します。|  
+  
+## リファレンス演算子  
+ リファレンスは、特定のエンティティ セットにある特定のエンティティへの論理ポインター \(外部キー\) です。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、参照の構築、分解、およびナビゲートを行うための次の演算子がサポートされています。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md)|エンティティ セット内のエンティティへの参照を作成します。|  
+|[DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md)|参照値を逆参照し、その逆参照の結果を生成します。|  
+|[KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md)|参照またはエンティティ式のキーを抽出します。|  
+|[NAVIGATE](../../../../../../docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md)|リレーションシップ内のエンティティ型間を移動するために使用します。|  
+|[REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md)|エンティティ インスタンスへの参照を返します。|  
+  
+## 集合演算子  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は各種の強力な集合演算機能を備えています。  これには、UNION、INTERSECT、EXCEPT、EXISTS などの Transact\-SQL  演算子に類似する集合演算子が含まれます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、重複排除 \(SET\)、メンバーシップのテスト \(IN\)、および結合 \(JOIN\) の演算子もサポートされています。  次の表に [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子を示します。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[ANYELEMENT](../../../../../../docs/framework/data/adonet/ef/language-reference/anyelement-entity-sql.md)|複数値のコレクションから要素を抽出します。|  
+|[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)|EXCEPT オペランドの左辺のクエリ式から返される結果のうち、右辺のクエリ式でも返される結果を除いた、重複しない値のコレクションを返します。|  
+|[&#91;NOT&#93; EXISTS](../../../../../../docs/framework/data/adonet/ef/language-reference/exists-entity-sql.md)|コレクションが空かどうかを調べます。|  
+|[FLATTEN](../../../../../../docs/framework/data/adonet/ef/language-reference/flatten-entity-sql.md)|コレクションのコレクションをフラット化して単一のコレクションに変換します。|  
+|[&#91;NOT&#93; IN](../../../../../../docs/framework/data/adonet/ef/language-reference/in-entity-sql.md)|コレクション内に一致する値があるかどうかを調べます。|  
+|[INTERSECT](../../../../../../docs/framework/data/adonet/ef/language-reference/intersect-entity-sql.md)|INTERSECT オペランドの左右両方のクエリ式によって返される個別の値のコレクションを返します。|  
+|[OVERLAPS](../../../../../../docs/framework/data/adonet/ef/language-reference/overlaps-entity-sql.md)|2 つのコレクションに共通の要素が存在するかどうかを調べます。|  
+|[SET](../../../../../../docs/framework/data/adonet/ef/language-reference/set-entity-sql.md)|重複する要素をすべて除外した新しいコレクションを生成することによって、オブジェクトのコレクションを 1 つの集合に変換するために使用されます。|  
+|[UNION](../../../../../../docs/framework/data/adonet/ef/language-reference/union-entity-sql.md)|複数のクエリの結果を 1 つのコレクションに結合します。|  
+  
+## 型演算子  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、式 \(値\) の型の構築、クエリの実行、および操作を実行できます。  次の表に型の操作に使用される演算子を示します。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[CAST](../../../../../../docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md)|あるデータ型の式を別のデータ型に変換します。|  
+|[COLLECTION](../../../../../../docs/framework/data/adonet/ef/language-reference/collection-entity-sql.md)|[FUNCTION](../../../../../../docs/framework/data/adonet/ef/language-reference/function-entity-sql.md) 演算で使用され、エンティティ型または複合型のコレクションを宣言します。|  
+|[IS &#91;NOT&#93; OF](../../../../../../docs/framework/data/adonet/ef/language-reference/isof-entity-sql.md)|式の型が指定の型であるか、またはそのサブタイプであるかを判断します。|  
+|[OFTYPE](../../../../../../docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md)|クエリ式を使用して、指定された型のオブジェクトのコレクションを返します。|  
+|[名前付きの型コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md)|エンティティ型または複合型のインスタンスの作成に使用されます。|  
+|[MULTISET](../../../../../../docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md)|値のリストからマルチセットのインスタンスを作成します。|  
+|[ROW](../../../../../../docs/framework/data/adonet/ef/language-reference/row-entity-sql.md)|1 つまたは複数の値から構造的に型付けされた匿名レコードを構築します。|  
+|[TREAT](../../../../../../docs/framework/data/adonet/ef/language-reference/treat-entity-sql.md)|特定の基本データ型のオブジェクトを指定の派生型のオブジェクトとして処理します。|  
+  
+## その他の演算子  
+ 次の表にその他の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 演算子を示します。  
+  
+|演算子|用途|  
+|---------|--------|  
+|[\+ \(文字列連結\)](../../../../../../docs/framework/data/adonet/ef/language-reference/string-concatenation-entity-sql.md)|[!INCLUDE[esql](../../../../../../includes/esql-md.md)] で文字列を連結するために使用されます。|  
+|[.  \(メンバー アクセス\)](../../../../../../docs/framework/data/adonet/ef/language-reference/member-access-entity-sql.md)|構造型概念モデル型のインスタンスのプロパティ値またはフィールド値にアクセスするために使用されます。|  
+|[\-\- \(コメント\)](../../../../../../docs/framework/data/adonet/ef/language-reference/comment-entity-sql.md)|[!INCLUDE[esql](../../../../../../includes/esql-md.md)] コメントを含めます。|  
+|[FUNCTION](../../../../../../docs/framework/data/adonet/ef/language-reference/function-entity-sql.md)|Entity SQL クエリで実行できるインライン関数を定義します。|  
+  
+## 参照  
+ [Entity SQL 言語](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/equals-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/equals-entity-sql.md
new file mode 100644
index 00000000000..9c9d4540267
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/equals-entity-sql.md
@@ -0,0 +1,57 @@
+---
+title: "= (等しい) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 948eb588-7080-4046-bb48-633b007393bf
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# = (等しい) (Entity SQL)
+2 つの式の等価性を比較します。  
+  
+## 構文  
+  
+```  
+  
+          expression  
+          =  
+          expression  
+or   
+expression==expression  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式が右の式と等しい場合は `true`、等しくない場合は `false`。  
+  
+## 解説  
+ \=\= 演算子は \= 演算子と同じです。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\= 比較演算子を使用して 2 つの式の等価性を比較します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#EQUALS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#equals)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/except-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/except-entity-sql.md
new file mode 100644
index 00000000000..4bfc9c952b4
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/except-entity-sql.md
@@ -0,0 +1,60 @@
+---
+title: "EXCEPT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 69cc23e5-3f8f-4b49-b20e-2f84ff11c80d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# EXCEPT (Entity SQL)
+EXCEPT オペランドの左辺のクエリ式から返される結果のうち、右辺のクエリ式でも返される結果を除いた、重複しない値のコレクションを返します。 すべての式は、`expression` と同じ型であるか、共通の基本型または派生型である必要があります。  
+  
+## 構文  
+  
+```  
+  
+expression EXCEPT expression  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効なクエリ式。もう一方のクエリ式から返されたコレクションと比較されます。  
+  
+## 戻り値  
+ `expression` と同じ型であるか、共通の基本データ型または派生型であるコレクション。  
+  
+## 解説  
+ EXCEPT は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。 次の表に、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] 集合演算子の優先順位を示します。  
+  
+|優先順位|演算子|  
+|----------|---------|  
+|最高|INTERSECT|  
+||UNION<br /><br /> UNION ALL|  
+||EXCEPT|  
+|最低|EXISTS<br /><br /> OVERLAPS<br /><br /> FLATTEN<br /><br /> SET|  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、EXCEPT 演算子を使用して、2 つのクエリ式から重複しない値のコレクションを返します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#EXCEPT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#except)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/exists-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/exists-entity-sql.md
new file mode 100644
index 00000000000..ca8d1ea492b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/exists-entity-sql.md
@@ -0,0 +1,56 @@
+---
+title: "EXISTS (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d28ead43-4afb-4bdc-af64-efd2e05005d7
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# EXISTS (Entity SQL)
+コレクションが空かどうかを調べます。  
+  
+## 構文  
+  
+```  
+  
+[NOT] EXISTS (expression)  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効な式。  
+  
+ NOT  
+ EXISTS の結果を否定することを指定します。  
+  
+## 戻り値  
+ コレクションが空でない場合は `true`、それ以外の場合は `false` です。  
+  
+## 解説  
+ EXISTS は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、EXISTS 演算子を使用して、コレクションが空かどうかを調べます。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#EXISTS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#exists)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md b/docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md
new file mode 100644
index 00000000000..6055eeeca6c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md
@@ -0,0 +1,48 @@
+---
+title: "LINQ to Entities クエリ内の式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d70b502f-6a15-4120-b4fe-500b173ad9cc
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to Entities クエリ内の式
+式は、単一の値、オブジェクト、メソッド、または名前空間として評価されるコード フラグメントです。  式には、リテラル値、メソッド呼び出し、演算子とそのオペランド、または単純な名前を含めることができます。  単純な名前には、変数、型メンバー、メソッド パラメーター、名前空間、または型の名前を指定できます。  式では、他の式をパラメーターとして使用する演算子、またはパラメーターが他のメソッド呼び出しであるメソッド呼び出しを使用できます。  したがって、単純な式だけでなく、非常に複雑な式も作成できます。  
+  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリの式には、ラムダ式など、<xref:System.Linq.Expressions> 名前空間内の型で許容されている要素であれば何でも使用できます。  [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリで使用可能な式は、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] に対してクエリを実行するために使用可能な式のスーパーセットです。  [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] に対するクエリの一部である式は、`ObjectQuery<T>` および基になるデータ ソースでサポートされている演算に制限されます。  
+  
+ 次の例では、`Where` 句で使用される比較の式を示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#WhereExpression](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#whereexpression)]
+ [!code-vb[DP L2E Conceptual Examples#WhereExpression](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#whereexpression)]  
+  
+> [!NOTE]
+>  C\# の `unchecked` などの特殊な言語構造は、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] では意味がありません。  
+  
+## このセクションの内容  
+ [定数式](../../../../../../docs/framework/data/adonet/ef/language-reference/constant-expressions.md)  
+  
+ [比較式](../../../../../../docs/framework/data/adonet/ef/language-reference/comparison-expressions.md)  
+  
+ [NULL 比較](../../../../../../docs/framework/data/adonet/ef/language-reference/null-comparisons.md)  
+  
+ [初期化式](../../../../../../docs/framework/data/adonet/ef/language-reference/initialization-expressions.md)  
+  
+ [Navigation Properties](http://msdn.microsoft.com/ja-jp/41e1e6b9-8a57-467d-99d9-1857d2ca2ea5)  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../../docs/framework/data/adonet/ef/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/flatten-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/flatten-entity-sql.md
new file mode 100644
index 00000000000..5f1b474ed9b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/flatten-entity-sql.md
@@ -0,0 +1,50 @@
+---
+title: "FLATTEN (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 1a670c63-0a29-4738-80e6-101f66af05c3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# FLATTEN (Entity SQL)
+コレクションのコレクションをフラット化して単一のコレクションに変換します。 変換後のコレクションは、入れ子構造が失われるだけで、変換前のコレクションとまったく同じ要素を格納します。  
+  
+## 構文  
+  
+```  
+  
+FLATTEN ( collection )  
+```  
+  
+## 引数  
+ `collection`  
+ 値のコレクションのコレクションをフラット化して単一のコレクションとして返す有効な任意の式。  
+  
+## 解説  
+ `FLATTEN` は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、`FLATTEN` 演算子を使用して、コレクションのコレクションをフラット化されたコレクションに変換します。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#FLATTEN](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#flatten)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/from-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/from-entity-sql.md
new file mode 100644
index 00000000000..29c23910d81
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/from-entity-sql.md
@@ -0,0 +1,169 @@
+---
+title: "FROM (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ff3e3048-0d5d-4502-ae5c-9187fcbd0514
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# FROM (Entity SQL)
+[SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md) ステートメントで使用するコレクションを指定します。  
+  
+## 構文  
+  
+```  
+FROM expression [ ,...n ] as C  
+```  
+  
+## 引数  
+ `expression`  
+ `SELECT` ステートメントのソースとして使用するコレクションを生成する任意の有効なクエリ式。  
+  
+## 解説  
+ `FROM` 句は、1 つ以上の `FROM` 句の項目をコンマで区切ったリストです。  `FROM` 句を使用して、`SELECT` ステートメントのソースを 1 つ以上指定できます。  `FROM` 句の最も単純な形式は、次の例に示すように、`SELECT` ステートメントのソースとして使用する 1 つのコレクションと 1 つの別名を識別する単一のクエリ式です。  
+  
+ `FROM C as c`  
+  
+## FROM 句の項目  
+ 各 `FROM` 句項目は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリ内のソース コレクションを参照します。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、`FROM` 句項目のクラスとして、単純 `FROM` 句項目、`JOIN FROM` 句項目、および `APPLY FROM` 句項目をサポートしています。  これらの `FROM` 句の各項目については、以下のセクションで詳しく説明します。  
+  
+### 単純な FROM 句の項目  
+ 最も単純な `FROM` 句の項目は、1 つのコレクションと 1 つの別名を識別する単一の式です。  式には、エンティティ セット、サブクエリ、またはコレクション型のその他の任意の式を使用できます。  次に例を示します。  
+  
+```  
+LOB.Customers as c  
+```  
+  
+ 別名の指定は省略可能です。  上記のように FROM 句の項目を指定する代わりに、次のように指定することもできます。  
+  
+```  
+LOB.Customers  
+```  
+  
+ 別名を指定しない場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] はコレクション式に基づいて別名の生成を試みます。  
+  
+### JOIN FROM 句の項目  
+ `JOIN FROM` 句項目は、2 つの `FROM` 句項目の間の結合を表します。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、クロス結合、内部結合、左外部結合、右外部結合、および完全外部結合をサポートしています。  これらすべての結合は、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] でのサポートと同様にサポートされます。  [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] の場合と同様に、`JOIN` に含まれる 2 つの `FROM` 句の項目は独立している必要があります。  つまり、相互に関連付けられた項目は使用できません。  このような場合には、`CROSS APPLY` または `OUTER APPLY` を使用できます。  
+  
+#### クロス結合  
+ 次の例に示すように、`CROSS JOIN` クエリ式は 2 つのコレクションのデカルト積を生成します。  
+  
+ `FROM C AS c CROSS JOIN D as d`  
+  
+#### 内部結合  
+ 次の例に示すように、`INNER JOIN` は 2 つのコレクションの制約付きデカルト積を生成します。  
+  
+ `FROM C AS c [INNER] JOIN D AS d ON e`  
+  
+ 上記のクエリ式では、`ON` 条件が指定されており、右のコレクションの各要素と対になっている左のコレクションの各要素を結合して処理します。  `ON` 条件を指定しない場合、`INNER JOIN` の動作は `CROSS JOIN` と同じになります。  
+  
+#### 左外部結合と右外部結合  
+ 次の例に示すように、`OUTER JOIN` クエリ式は 2 つのコレクションの制約付きデカルト積を生成します。  
+  
+ `FROM C AS c LEFT OUTER JOIN D AS d ON e`  
+  
+ 上記のクエリ式では、`ON` 条件が指定されており、右のコレクションの各要素と対になっている左のコレクションの各要素を結合して処理します。  `ON` 条件が指定されていない場合、式は、NULL 値を使用して、右の要素と対になっている左の要素の単一のインスタンスを処理します。  
+  
+ `RIGHT OUTER JOIN` についても同様です。  
+  
+#### 完全外部結合  
+ 次の例に示すように、明示的な `FULL OUTER JOIN` は 2 つのコレクションの制約付きデカルト積を生成します。  
+  
+ `FROM C AS c FULL OUTER JOIN D AS d ON e`  
+  
+ 上記のクエリ式では、`ON` 条件が指定されており、右のコレクションの各要素と対になっている左のコレクションの各要素を結合して処理します。  `ON` 条件が指定されていない場合、式は、NULL 値を使用して、右の要素と対になっている左の要素のインスタンスを 1 つ処理します。  また、NULL 値を使用して、左の要素と対になっている右の要素のインスタンスも 1 つ処理します。  
+  
+> [!NOTE]
+>  SQL\-92 との互換性を保つため、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、OUTER キーワードは省略可能です。  したがって、`LEFT JOIN`、`RIGHT JOIN`、および `FULL JOIN` は、`LEFT OUTER JOIN`、`RIGHT OUTER JOIN`、および `FULL OUTER JOIN` のシノニムです。  
+  
+### APPLY 句の項目  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、`CROSS APPLY` と `OUTER APPLY` という 2 種類の `APPLY` をサポートしています。  
+  
+ `CROSS APPLY` は、左のコレクションの各要素と右の式の評価によって生成されたコレクションの要素との一意の組み合わせを生成します。  `CROSS APPLY` では、右の式は左の要素に機能的に依存します。このような関連付けられたコレクションの例を次に示します。  
+  
+ `SELECT c, f FROM C AS c CROSS APPLY c.Assoc AS f`  
+  
+ `CROSS APPLY` の動作は結合リストに似ています。  右の式が空のコレクションとして評価される場合、`CROSS APPLY` は、左の要素のそのインスタンスの組み合わせを生成しません。  
+  
+ `OUTER APPLY` は、右の式が空のコレクションとして評価される場合でも組み合わせを生成する以外は、`CROSS APPLY` と同様です。  `OUTER APPLY` の使用例を次に示します。  
+  
+ `SELECT c, f FROM C AS c OUTER APPLY c.Assoc AS f`  
+  
+> [!NOTE]
+>  [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] とは異なり、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、明示的なネスト解除の手順は不要です。  
+  
+> [!NOTE]
+>  `CROSS` 演算子および `OUTER APPLY` 演算子は [!INCLUDE[ssVersion2005](../../../../../../includes/ssversion2005-md.md)] で導入されました。  場合によっては、クエリ パイプラインにより、`CROSS APPLY` 演算子または `OUTER APPLY` 演算子を含む Transact\-SQL が生成されることがあります。  一部のバックエンド プロバイダー \([!INCLUDE[ssVersion2005](../../../../../../includes/ssversion2005-md.md)] より古いバージョンの [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] など\) では、これらの演算子がサポートされていません。したがって、このようなクエリをこれらのバックエンド プロバイダーで実行することはできません。  
+>   
+>  `CROSS APPLY` 演算子または `OUTER APPLY` 演算子を含むクエリの生成につながる可能性がある一般的なシナリオとしては、ページングを使用した相関サブクエリ、相関サブクエリ全体またはナビゲーションによって生成されたコレクション全体を対象とした AnyElement、要素セレクターを受け取るグループ化メソッドを使用した LINQ クエリ、`CROSS APPLY` 演算子または `OUTER APPLY` 演算子が明示的に指定されたクエリ、`REF` コンストラクターを引数に取る `DEREF` コンストラクターを含むクエリなどがあります。  
+  
+## FROM 句での複数のコレクション  
+ `FROM` 句には、複数のコレクションをコンマで区切って含めることができます。  この場合、これらのコレクションは 1 つに結合されるものと見なされます。  これは、n 方向の CROSS JOIN と考えることができます。  
+  
+ 次の例で、`C` と `D` は独立したコレクションですが、`c.Names` は `C` に依存しています。  
+  
+```  
+FROM C AS c, D AS d, c.Names AS e  
+```  
+  
+ 上記の例は、次の例と論理的に等価です。  
+  
+ `FROM (C AS c JOIN D AS d) CROSS APPLY c.Names AS e`  
+  
+## 左の相関関係  
+ `FROM` 句の項目は、前の句で指定された項目を参照できます。  次の例で、`C` と `D` は独立したコレクションですが、`c.Names` は `C` に依存しています。  
+  
+```  
+from C as c, D as d, c.Names as e  
+```  
+  
+ 上記の例は、次の例と論理的に等価です。  
+  
+```  
+from (C as c join D as d) cross apply c.Names as e  
+```  
+  
+## Semantics  
+ 論理上、`FROM` 句のコレクションは `n` 方向のクロス結合の一部になると見なされます \(1 方向のクロス結合の場合を除く\)。  `FROM` 句内の別名は、左から右へと処理され、後で参照できるように現在のスコープに追加されます。  `FROM` 句は、行のマルチセットを生成すると見なされます。  `FROM` 句の項目ごとに 1 つのフィールドが生成され、そのコレクションの項目の 1 つの要素を表します。  
+  
+ `FROM` 句は、c、d、e の各フィールドが `C`、`D`、`c.Names` の要素型になると見なされる Row\(c, d, e\) 型の行のマルチセットを論理的に生成します。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、単純な `FROM` 句の項目ごとの別名がスコープに導入されます。  たとえば、次の FROM 句の例では、スコープに導入される名前は c、d、e です。  
+  
+```  
+from (C as c join D as d) cross apply c.Names as e  
+```  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] と異なり、`FROM` 句では別名のみがスコープに導入されます。  これらのコレクションの列 \(プロパティ\) への参照は、別名を使用して修飾する必要があります。  
+  
+## 入れ子になったクエリからのキーの抽出  
+ 入れ子になったクエリからのキーの抽出を必要とする特定の種類のクエリはサポートされていません。  たとえば、次のクエリは有効です。  
+  
+```  
+select c.Orders from Customers as c   
+```  
+  
+ しかし、次のクエリは、入れ子になったクエリにキーがないため無効です。  
+  
+```  
+select {1} from {2, 3}  
+```  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)   
+ [NULL 値が許容される構造化型](../../../../../../docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/function-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/function-entity-sql.md
new file mode 100644
index 00000000000..51f97c58ea8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/function-entity-sql.md
@@ -0,0 +1,87 @@
+---
+title: "FUNCTION (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0bb88992-37ed-4991-ace5-55be612a2c4d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# FUNCTION (Entity SQL)
+Entity SQL クエリ コマンドのスコープに関数を定義します。  
+  
+## 構文  
+  
+```  
+  
+FUNCTION function-name( [ { parameter_name <type_definition>   
+        [ ,...n ]  
+  ]  
+) AS ( function_expression )   
+  
+<type_definition>::=  
+    { data_type | COLLECTION ( <type_definition>)   
+                | REF (data_type)   
+                | ROW (row_expression)   
+        }   
+```  
+  
+## 引数  
+ `function-name`  
+ 関数名。  
+  
+ `parameter-name`  
+ 関数のパラメーター名。  
+  
+ `function_expression`  
+ 関数である有効な Entity SQL 式。 関数内のコマンドは、関数に渡される `parameter_name` パラメーターに基づいて実行されます。  
+  
+ `data_type`  
+ サポートされる型の名前。  
+  
+ COLLECTION \( \<type\_definition`>` \)  
+ サポートされる型、行、または参照のコレクションを返す式。  
+  
+ REF **\(** `data_type` **\)**  
+ エンティティ型への参照を返す式。  
+  
+ ROW **\(** `row_expression` **\)**  
+ 1 つまたは複数の値から構造的に型指定された匿名レコードを返す式。 詳細については、「[ROW](../../../../../../docs/framework/data/adonet/ef/language-reference/row-entity-sql.md)」を参照してください。  
+  
+## 解説  
+ 関数のシグネチャが異なっていれば、名前が同じ複数の関数をインラインで宣言することは可能です。 詳細については、「[関数のオーバーロードの解決方法](../../../../../../docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md)」を参照してください。  
+  
+ 関数がインラインである場合、Entity SQL コマンドに呼び出せるのは、そのコマンド内で定義された後のみです。 ただし、インライン関数を別のインライン関数内で呼び出す場合には、呼び出される関数が定義される前でも後でもかまいません。 次の例では、関数 B が定義される前に、関数 A が関数 B を呼び出しています。  
+  
+ `Function A() as ('A calls B. ' + B())`  
+  
+ `Function B() as ('B was called.')`  
+  
+ `A()`  
+  
+ 詳しくは、「[ユーザー定義関数を呼び出す方法](http://msdn.microsoft.com/ja-jp/ad131b86-8b4e-4747-8605-d4fc64fb9d02)」をご覧ください。  
+  
+ 関数をモデル自体で宣言することもできます。 モデルで宣言された関数は、コマンドでインラインで宣言された関数と同じように実行されます。 詳細については、「[ユーザー定義関数](../../../../../../docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md)」を参照してください。  
+  
+## 使用例  
+ 次の Entity SQL コマンドは、関数 `Products` を定義します。この関数は、整数値を受け取って、返された製品をフィルター処理します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#FUNCTION1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#function1)]  
+  
+## 使用例  
+ 次の Entity SQL コマンドは、関数 `StringReturnsCollection` を定義します。この関数は、文字列のコレクションを受け取って、返された連絡先をフィルター処理します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#FUNCTION2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#function2)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL 言語](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md
new file mode 100644
index 00000000000..aad7de69fac
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md
@@ -0,0 +1,47 @@
+---
+title: "関数のオーバーロードの解決方法 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9c648054-3808-4a69-9d3e-98e6a4f9c5ca
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 関数のオーバーロードの解決方法 (Entity SQL)
+このトピックでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] 関数の解決方法について説明します。  
+  
+ それぞれのシグネチャが一意であれば、複数の関数を同じ名前で定義することは可能です。  
+  
+ その場合、式でどの関数が参照されているのかを判断するには、以下の基準を適用する必要があります。  これらの基準は順番に適用されます。  1 つの関数のみに該当する最初の基準が、どの関数に解決されるかを決定します。  
+  
+1.  **パラメーターの数**。  関数が、式で指定されているパラメーター数と同じ数のパラメーターを含んでいます。  
+  
+2.  **型の完全一致**。  関数の各引数の型が、パラメーターの型と完全に一致するか、NULL リテラルになっています。  
+  
+3.  **サブタイプの一致**。  関数の各引数の型が、パラメーターの型に完全に一致するか、そのサブタイプになっています。または、引数が NULL リテラルになっています。  複数の関数が、必要なサブタイプの型変換数においてのみ異なる場合は、最も少ないサブタイプの型変換数を持つ関数が、解決された関数になります。  
+  
+4.  **サブタイプまたは型の昇格の一致**。  関数の各引数の型が、パラメーターの型に完全に一致しているか、そのサブタイプであるか、その型に昇格できます。または、引数が NULL リテラルになっています。  ここでも、複数の関数が、サブタイプの型変換および昇格の数においてのみ異なる場合は、最も少ないサブタイプの型変換および昇格の数を持つ関数が、解決された関数になります。  
+  
+ これらの基準のいずれによっても 1 つの関数を選択できない場合、関数の呼び出し式はあいまいになります。  
+  
+ これらの規則を使用して 1 つの関数を抽出できても、引数がパラメーターに一致しない場合があります。  この場合は、エラーが発生します。  
+  
+ ユーザー定義関数の場合、そのユーザー定義関数に適したシグネチャとモデル定義関数が存在する場合でも、インライン クエリ関数の定義が優先されます。  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [関数](../../../../../../docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md
new file mode 100644
index 00000000000..a03f45e2660
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md
@@ -0,0 +1,38 @@
+---
+title: "関数 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 52b3d776-5acc-4f69-b614-5a43ce56ef9f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 関数 (Entity SQL)
+Entity SQL では、ユーザー定義関数、正規の関数、およびプロバイダー固有の関数がサポートされています。  ユーザー定義関数は、概念モデルまたはクエリでインラインで指定されます。  詳細については、「[ユーザー定義関数](../../../../../../docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md)」を参照してください。  
+  
+ 正規の関数は Entity Framework で定義済みであり、データ プロバイダーによってサポートされています。  プロバイダーによってサポートされていない関数を呼び出すと、Entity SQL コマンドは失敗します。  そのため、通常は、プロバイダー固有の名前空間にあるストア固有の関数よりも正規の関数が推奨されます。  詳細については、「[正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)」を参照してください。  
+  
+ Microsoft SQL クライアント マネージ プロバイダーは、プロバイダー固有の一連の関数を提供しています。  詳細については、「[Entity Framework 用 SqlClient 関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## このセクションの内容  
+ [ユーザー定義関数](../../../../../../docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md)  
+  
+ [関数のオーバーロードの解決方法](../../../../../../docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md)  
+  
+ [集計関数](../../../../../../docs/framework/data/adonet/ef/aggregate-functions-sqlclient-for-entity-framework.md)  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/greater-than-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/greater-than-entity-sql.md
new file mode 100644
index 00000000000..acff5001d73
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/greater-than-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "&gt; (より大きい) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 4cea865c-677c-4b06-99a1-010f2ae2394a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# &gt; (より大きい) (Entity SQL)
+2 つの式を比較して、左の式の値が右の式の値よりも大きいかどうかを判別します。  
+  
+## 構文  
+  
+```  
+  
+expression  
+>  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式の値が右の式の値よりも大きい場合は `true`、そうでない場合は `false`。  
+  
+## 使用例  
+ 次の Entity SQL クエリは「\>」比較演算子を使用して 2 つの式を比較し、左の式の値が右の式の値よりも大きいかどうかを判別します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#GREATER](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#greater)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/greater-than-or-equal-to-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/greater-than-or-equal-to-entity-sql.md
new file mode 100644
index 00000000000..67f7ca73973
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/greater-than-or-equal-to-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "&gt;= (以上) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 70780ac4-0123-4da8-b731-8af856daffe3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# &gt;= (以上) (Entity SQL)
+2 つの式を比較して、左の式の値が右の式の値以上であるかどうかを判別します。  
+  
+## 構文  
+  
+```  
+  
+expression  
+>=  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式の値が右の式の値以上である場合は `true`、そうでない場合は `false`。  
+  
+## 使用例  
+ 次の Entity SQL クエリは「\>\=」比較演算子を使用して 2 つの式を比較し、左の式の値が右の式の値以上であるかどうかを判別します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#GREATER_OR_EQUALS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#greater_or_equals)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md
new file mode 100644
index 00000000000..04624c5a32e
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md
@@ -0,0 +1,85 @@
+---
+title: "GROUP BY (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: cf4f4972-4724-4945-ba44-943a08549139
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# GROUP BY (Entity SQL)
+クエリ \([SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)\) 式によって返されるオブジェクトをグループ化するよう指定します。  
+  
+## 構文  
+  
+```  
+  
+[ GROUP BY aliasedExpression [ ,...n ] ]  
+```  
+  
+## 引数  
+ `aliasedExpression`  
+ グループ化の実行対象となる有効なクエリ式。`expression` には、プロパティを指定することも、FROM 句から返されたプロパティを参照する非集計式を指定することもできます。 GROUP BY 句内の各式は、等価かどうかを比較できる型に評価される必要があります。 通常、これらの型は数値、文字列、日付などのスカラー プリミティブです。 コレクション別にグループ化することはできません。  
+  
+## 解説  
+ SELECT 句の \<select list\> に集計関数が含まれている場合は、GROUP BY によって各グループの集計値が計算されます。 GROUP BY を指定する場合は、選択リスト内の非集計式内の各プロパティ名が GROUP BY リストに含まれるか、GROUP BY 式が選択リスト式に正確に一致する必要があります。  
+  
+> [!NOTE]
+>  ORDER BY 句を指定しない場合、GROUP BY 句でグループが返される順序には特に決まりはありません。 データの特定の順序を指定するには、常に ORDER BY 句を使用することをお勧めします。  
+  
+ GROUP BY 句を明示的または暗黙的に指定した場合 \(たとえばクエリ内の HAVING 句\)、現在のスコープは非表示になり、新しいスコープが導入されます。  
+  
+ SELECT 句、HAVING 句、および ORDER BY 句は、FROM 句で指定された要素名を参照することはできなくなります。 ユーザーが参照できるのは、グループ化式自体だけです。 このためには、新しい名前 \(別名\) を各グループ化式に割り当てます。 グループ化式に別名が指定されていない場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、次の例に示すように別名生成規則を使用することによって別名が生成されます。  
+  
+ `SELECT g1, g2, ...gn FROM c as c1`  
+  
+ `GROUP BY e1 as g1, e2 as g2, ...en as gn`  
+  
+ GROUP BY 句の式は、同じ GROUP BY 句で前に定義された名前を参照できません。  
+  
+ 名前のグループ化に加え、SELECT 句、HAVING 句、および ORDER BY 句で集計を指定することもできます。 集計には、グループの各要素について評価される式が含まれます。 集計演算子により、これらのすべての式の値の数が減少します \(ただし、必ずしも単一の値になるとは限りません\)。 集計式は、現在のスコープに表示される基の要素名、または GROUP BY 句自体によって導入された新しい任意の名前を参照できます。 集計は SELECT 句、HAVING 句、および ORDER BY 句に含まれますが、次の例で示すとおり、実際にはグループ化式と同じスコープで評価されます。  
+  
+ `SELECT name, sum(o.Price * o.Quantity) as total`  
+  
+ `FROM orderLines as o`  
+  
+ `GROUP BY o.Product as name`  
+  
+ このクエリは GROUP BY 句を使用して、注文した全製品の価格のレポートを製品別に分類して生成します。 グループ化式の一部として、製品に `name` という名前を付け、SELECT リストでその名前を参照します。 さらに、注文明細の価格と数量を内部で参照する SELECT リスト内の集計 `sum` を指定します。  
+  
+ 各 GROUP By キー式には、入力スコープへの参照が少なくとも 1 つ必要です。  
+  
+```  
+SELECT FROM Persons as P  
+GROUP BY Q + P   -- GOOD  
+GROUP BY Q   -- BAD  
+GROUP BY 1   -- BAD, a constant is not allowed  
+```  
+  
+ GROUP BY を使用する場合の例については、「[HAVING](../../../../../../docs/framework/data/adonet/ef/language-reference/having-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、GROUP BY 演算子を使用して、クエリによって返されるオブジェクトをグループ化するよう指定します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#GROUPBY](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#groupby)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/grouppartition-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/grouppartition-entity-sql.md
new file mode 100644
index 00000000000..00abacd8213
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/grouppartition-entity-sql.md
@@ -0,0 +1,83 @@
+---
+title: "GROUPPARTITION (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0482e9b-086c-451c-9dfa-ccb024a9efb6
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# GROUPPARTITION (Entity SQL)
+引数値のコレクションを返します。この値は、集計が関連する現在のグループ パーティションから投影されたものです。`GroupPartition` 集計は、グループベースの集計であり、コレクションベースの形式ではありません。  
+  
+## 構文  
+  
+```  
+  
+GROUPPARTITION( [ALL|DISTINCT] expression )  
+```  
+  
+## 引数  
+ `expression`  
+ 任意のブール型 \([!INCLUDE[esql](../../../../../../includes/esql-md.md)]\) の式を指定します。  
+  
+## 解説  
+ 次のクエリでは、製品の一覧と、製品ごとの注文明細の数量のコレクションが生成されます。  
+  
+```  
+select p, GroupPartition(ol.Quantity) from LOB.OrderLines as ol  
+  group by ol.Product as p  
+```  
+  
+ 次の 2 つのクエリは、同じ意味を持っています。  
+  
+```  
+select p, Sum(GroupPartition(ol.Quantity)) from LOB.OrderLines as ol  
+  group by ol.Product as p  
+select p, Sum(ol.Quantity) from LOB.OrderLines as ol  
+  group by ol.Product as p  
+```  
+  
+ `GROUPPARTITION` 演算子は、ユーザー定義の集計関数と組み合わせて使用できます。  
+  
+ `GROUPPARTITION` は、グループ化された入力セットへの参照を格納する特殊な集計演算子です。 この参照は、GROUP BY がスコープに含まれているクエリ内の任意の位置で使用できます。 次に例を示します。  
+  
+```  
+select p, GroupPartition(ol.Quantity) from LOB.OrderLines as ol group by ol.Product as p  
+```  
+  
+ 通常の GROUP BY では、グループ化の結果は非表示です。 結果は集計関数でのみ使用できます。 グループ化の結果を表示するには、サブクエリを使用してグループ化の結果と、入力セットを相関させる必要があります。 次の 2 つのクエリは等価です。  
+  
+```  
+select p, (select q from GroupPartition(ol.Quantity) as q) from LOB.OrderLines as ol group by ol.Product as p  
+select p, (select ol.Quantity as q from LOB.OrderLines as ol2 where ol2.Product = p) from LOB.OrderLines as ol group by ol.Product as p  
+```  
+  
+ 例からわかるように、GROUPPARTITION 集計演算子を使用すると、グループ化後の入力セットへの参照を容易に取得できます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] パラメーターを使用すると、GROUPPARTITION 演算子では、演算子入力内の任意の `expression` 式を指定できます。  
+  
+ たとえば、グループ パーティションへの次の入力式はすべて有効です。  
+  
+```  
+select groupkey, GroupPartition(b) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+select groupkey, GroupPartition(1) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+select groupkey, GroupPartition(a + b) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+select groupkey, GroupPartition({a + b}) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+select groupkey, GroupPartition({42}) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+select groupkey, GroupPartition(b > a) from {1,2,3} as a inner join {4,5,6} as b on true group by a as groupkey  
+```  
+  
+## 使用例  
+ 次の例では、GROUPPARTITION 句を GROUP BY 句と共に使用する方法を示します。 GROUP BY 句は `SalesOrderHeader` によって `Contact` エンティティをグループ化します。 続いて GROUPPARTITION 句は、各グループの `TotalDue` プロパティを投影し、その結果、10 進数のコレクションが生成されます。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#Collection_GroupPartition](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#collection_grouppartition)]
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/having-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/having-entity-sql.md
new file mode 100644
index 00000000000..d44e0cad684
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/having-entity-sql.md
@@ -0,0 +1,63 @@
+---
+title: "HAVING (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b5d52d97-8372-4335-beac-2d0b79dc3707
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# HAVING (Entity SQL)
+グループまたは集計の検索条件を指定します。  
+  
+## 構文  
+  
+```  
+  
+[ HAVING search_condition ]  
+```  
+  
+## 引数  
+ `search_condition`  
+ グループまたは集計の検索条件を指定します。 HAVING 句を GROUP BY ALL と共に使用した場合、HAVING 句により ALL は無効になります。  
+  
+## 解説  
+ HAVING 句は、グループ化の結果について追加的なフィルター処理条件を指定する場合に使用します。 クエリ式で GROUP BY 句が指定されていないと、暗黙的な単独セットのグループになります。  
+  
+> [!NOTE]
+>  HAVING は、[SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md) ステートメントと共にのみ使用できます。[GROUP BY](../../../../../../docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md) を使用しない場合、HAVING は WHERE 句と同様に動作します。  
+  
+ GROUP BY 操作後に適用される場合を除いて、HAVING 句は WHERE 句と同様に動作します。 つまり、次の例のように、HAVING 句は別名および集計のグループ化のみを参照できます。  
+  
+```  
+SELECT Name, SUM(o.Price * o.Quantity) AS Total FROM orderLines AS o GROUP BY o.Product AS Name  
+HAVING SUM(o.Quantity) > 1  
+```  
+  
+ 前述のグループは、複数の製品を含むグループのみに制限されています。  
+  
+## 使用例  
+ 次の Entity SQL のクエリでは、HAVING および GROUP BY 操作を使用して、グループまたは集計の検索条件を指定します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#HAVING](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#having)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md b/docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md
new file mode 100644
index 00000000000..28070a76716
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md
@@ -0,0 +1,227 @@
+---
+title: "Entity SQL と Transact-SQL の相違点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9c9ee36d-f294-4c8b-a196-f0114c94f559
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity SQL と Transact-SQL の相違点
+このトピックでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] と [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] の相違点について説明します。  
+  
+## 継承とリレーションシップのサポート  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、エンティティの概念スキーマを直接操作し、継承やリレーションシップなどの概念モデル機能をサポートします。  
+  
+ 継承を操作するときは、スーパータイプ インスタンスのコレクションからサブタイプのインスタンスを選択すると便利である場合がよくあります。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 内の [oftype](../../../../../../docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md) 演算子 \(C\# シーケンスの `oftype` に相当\) によってこの機能が提供されます。  
+  
+## コレクションのサポート  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、コレクションをファーストクラスのエンティティとして取り扱います。  次に例を示します。  
+  
+-   コレクションの式は、`from` 句内で有効です。  
+  
+-   `in` サブクエリと `exists` サブクエリは任意のコレクションを使用できるように一般化されています。  
+  
+     サブクエリは一種のコレクションです。  `e1 in e2` および `exists(e)` は、これらの演算を実行する [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 構造です。  
+  
+-   `union`、`intersect`、`except` などの集合演算は、現在ではコレクションに対して実行されます。  
+  
+-   結合はコレクションに対して実行されます。  
+  
+## 式のサポート  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] にはサブクエリ \(テーブル\) と式 \(行と列\) があります。  
+  
+ コレクションおよび入れ子になったコレクションをサポートするために、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではすべてを式として取り扱います。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] よりもコンポーザブルであり、すべての式をどこにでも使用できます。  クエリ式は常に投射型のコレクションとなり、コレクション式が許可されている任意の場所で使用できます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] でサポートされていない [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] 式の詳細については、「[サポートされていない式](../../../../../../docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md)」を参照してください。  
+  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリはすべて有効です。  
+  
+```  
+1+2 *3  
+"abc"  
+row(1 as a, 2 as b)  
+{ 1, 3, 5}   
+e1 union all e2  
+set(e1)  
+```  
+  
+## サブクエリの一貫した処理  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] は、テーブルに重点を置いてサブクエリのコンテキストを解釈します。  たとえば、`from` 句内のサブクエリは、マルチセット \(テーブル\) と見なされます。  ただし、`select` 句で使用される同じサブクエリは、スカラー サブクエリと見なされます。  同様に、`in` 演算子の左側で使用されるサブクエリはスカラー サブクエリと見なされますが、右側で使用されるサブクエリはマルチセット サブクエリと見なされます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではこれらの違いが排除されます。  式は、使用するコンテキストに依存しない、一貫した方法で解釈されます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、すべてのサブクエリはマルチセット サブクエリと見なされます。  サブクエリでスカラー値が必要な場合のために、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には `anyelement` 演算子が用意されています。この演算子はコレクション \(この場合はサブクエリ\) に対して演算を行い、コレクションからシングルトン値を抽出します。  
+  
+### サブクエリの暗黙の強制型変換の回避  
+ サブクエリの一貫した処理に伴う二次的作用として、スカラー値へのサブクエリの暗黙的な変換があります。  具体的には、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、単一フィールドの行のマルチセットはそのフィールドのデータ型を持つスカラー値に暗黙的に変換されます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、この暗黙の強制型変換をサポートしていません。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、コレクションからシングルトン値を抽出するための ANYELEMENT 演算子と、クエリ式の実行中に row ラッパーの作成を回避するための `select value` 句が提供されています。  
+  
+## SELECT VALUE: 暗黙の row ラッパーの回避  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] サブクエリ内の SELECT 句では、句内の項目に row ラッパーを暗黙的に作成します。  これは、スカラーやオブジェクトのコレクションを作成できないことを意味します。  [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、1 つのフィールドの RowType と、同じデータ型のシングルトン値との間の暗黙の強制型変換を許可しています。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、暗黙の行の構築をスキップする `select value` 句が用意されています。  `select value` 句には 1 つの項目のみを指定できます。  このような句を使用した場合、`select` 句内の項目には row ラッパーは構築されず、目的の構造を持つコレクションを作成できます。たとえば、`select value a` のように指定します。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、任意の行を構築するための行コンストラクターも用意されています。  `select` は、投影の 1 つ以上の要素を受け取り、結果はフィールドを持つデータ レコードになります。次のように指定します。  
+  
+ `select a, b, c`  
+  
+## 左の相関関係と別名定義  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、1 つのスコープ内の式 \(`select` または `from` のような単一句\) は同じスコープ内で先に定義された式を参照できません。  一部の SQL 言語仕様 \([!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] を含む\) では、`from` 句でこれらを制限付きでサポートしています。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では `from` 句における左の相関関係を一般化し、一貫した方法でこれらを取り扱います。  `from` 句内の式は、追加の構文を使用せずに、同じ句内で先に作成された定義 \(左側の定義\) を参照できます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、`group by` 句を伴うクエリにも制限を課しています。  このようなクエリの `select` 句および `having` 句内の式は、別名を使用した場合にのみ `group by` キーを参照できます。  次の構造は [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では有効ですが、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では無効です。  
+  
+```  
+select t.x + t.y from T as t group by t.x + t.y  
+```  
+  
+ これを [!INCLUDE[esql](../../../../../../includes/esql-md.md)] で実行するには、次のように指定します。  
+  
+```  
+select k from T as t group by (t.x + t.y) as k  
+```  
+  
+## テーブル \(コレクション\) の列 \(プロパティ\) の参照  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 内の列の参照は、すべてテーブルの別名を使用して修飾する必要があります。  次の構造は [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では有効ですが、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では無効です \(`a` がテーブル `T` の有効な列である場合\)。  
+  
+```  
+select a from T  
+```  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の形式は次のとおりです。  
+  
+```  
+select t.a as A from T as t  
+```  
+  
+ テーブルの別名は `from` 句では省略できます。  テーブル名は暗黙的な別名として使用されます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では次の形式も使用できます。  
+  
+```  
+select Tab.a from Tab  
+```  
+  
+## オブジェクト間の移動  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] ではテーブルの列または行の参照に "." 表記を使用します。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではこの表記法を拡張し \(プログラミング言語から借用\)、オブジェクトのプロパティ間の移動をサポートしています。  
+  
+ たとえば、`p` が Person 型の式である場合、この人の住所の市区町村を参照するには次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 構文が使用されます。  
+  
+```  
+p.Address.City   
+```  
+  
+## \* のサポートなし  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では修飾されていない \* 構文を行全体の別名としてサポートしており、修飾された \* 構文 \(t.\*\) をそのテーブルのフィールドのショートカットとしてサポートしています。  また、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では NULL を含む特殊な count\(\*\) 集計も使用できます。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、\* 構造をサポートしていません。  `select * from T` および `select T1.* from T1, T2...` の形式の [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] クエリは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではそれぞれ `select value t from T as t` および `select value t1 from T1 as t1, T2 as t2...` として表すことができます。  また、これらの構造は継承 \(値の置換可能性\) に対応していますが、`select *` Variant 型では宣言された型の最上位レベルのプロパティに限定されています。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は `count(*)` 集計をサポートしていません。  代わりに、`count(0)` を使用してください。  
+  
+## Group By への変更  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では `group by` キーの別名定義をサポートしています。  `select` 句および `having` 句内の式は、これらの別名を使用して `group by` キーを参照する必要があります。たとえば、次のような [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 構文があるとします。  
+  
+```  
+select k1, count(t.a), sum(t.a)  
+from T as t  
+group by t.b + t.c as k1  
+```  
+  
+ これは、次の [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] と同じです。  
+  
+```  
+select b + c, count(*), sum(a)   
+from T  
+group by b + c  
+```  
+  
+## コレクションベースの集計  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、2 種類の集計をサポートしています。  
+  
+ コレクションベースの集計は、コレクションに対して演算を行い、集計結果を生成します。  これらはクエリ内の任意の場所で使用でき、`group by` 句を必要としません。  次に例を示します。  
+  
+```  
+select t.a as a, count({1,2,3}) as b from T as t     
+```  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、SQL スタイルの集計もサポートしています。  次に例を示します。  
+  
+```  
+select a, sum(t.b) from T as t group by t.a as a  
+```  
+  
+## ORDER BY 句の使用法  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、ORDER BY 句は最上位の SELECT .. FROM ..  WHERE ブロックでのみ指定できます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、入れ子になった ORDER BY 式を使用でき、それをクエリ内の任意の場所に配置できますが、入れ子になったクエリ内の順序は保持されません。  
+  
+```  
+-- The following query will order the results by the last name  
+SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName  
+```  
+  
+```  
+-- In the following query ordering of the nested query is ignored.  
+SELECT C2.FirstName, C2.LastName  
+    FROM (SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName) as C2  
+```  
+  
+## 識別子  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、識別子の比較は現在のデータベースの照合順序に基づきます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の識別子では、常に大文字と小文字は区別されず、アクセントは区別されます \(つまり、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではアクセントのある文字とアクセントのない文字が区別されます。たとえば 'a' と 'ấ' は等しくありません\)。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、同じように表示される文字であってもコード ページが異なる場合は、異なる文字と見なされます。  詳細については、「[入力文字セット](../../../../../../docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md)」を参照してください。  
+  
+## Entity SQL では使用できない Transact\-SQL 機能  
+ 次の [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] 機能は [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では使用できません。  
+  
+ DML  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は現在、DML ステートメント \(insert、update、delete\) をサポートしていません。  
+  
+ DDL  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の現在のバージョンでは DDL はサポートされていません。  
+  
+ 命令型プログラミング  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] とは異なり、命令型プログラミングをサポートしていません。  代わりにプログラミング言語を使用します。  
+  
+ グループ化関数  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではグループ化関数 \(CUBE, ROLLUP、GROUPING\_SET など\) はサポートしていません。  
+  
+ 分析関数  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では分析関数はまだサポートしていません。  
+  
+ 組み込み関数、演算子  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] の組み込み関数と演算子のサブセットをサポートしています。  これらの演算子と関数の多くは、主要なストア プロバイダーによりサポートされています。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、プロバイダー マニフェストで宣言されたストア固有の関数を使用します。  また、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] では [!INCLUDE[esql](../../../../../../includes/esql-md.md)] が使用する既存の組み込みストア関数とユーザー定義ストア関数を宣言できます。  
+  
+ ヒント  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではクエリ ヒントのメカニズムは提供していません。  
+  
+ クエリ結果のバッチ処理  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、クエリ結果のバッチ処理はサポートされていません。  たとえば、次の [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] は有効です \(バッチとして送信\)。  
+  
+```  
+select * from products;  
+select * from catagories;  
+```  
+  
+ ただし、同等の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] はサポートされていません。  
+  
+```  
+Select value p from Products as p;  
+Select value c from Categories as c;  
+```  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、コマンドごとに 1 つの結果生成クエリ ステートメントのみをサポートします。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [サポートされていない式](../../../../../../docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-to-call-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/how-to-call-canonical-functions.md
new file mode 100644
index 00000000000..c49d79cb52b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-to-call-canonical-functions.md
@@ -0,0 +1,43 @@
+---
+title: "正規関数を呼び出す方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b3d84873-7403-4957-8e20-b4ae39f50214
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 正規関数を呼び出す方法
+<xref:System.Data.Objects.EntityFunctions> クラスには、LINQ to Entities クエリで使用する正規関数を公開するメソッドが含まれています。  正規関数の詳細については、「[正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Data.Objects.EntityFunctions> クラスの <xref:System.Data.Objects.EntityFunctions.AsUnicode%2A> メソッドと <xref:System.Data.Objects.EntityFunctions.AsNonUnicode%2A> メソッドには正規関数に相当するものがありません。  
+  
+ 値のセットに対して計算を実行して 1 つの値を返す正規関数 \(集計正規関数とも呼ばれる\) は、直接呼び出すことができます。  他の正規関数は、LINQ to Entities クエリの一部としてしか呼び出すことができません。  集計関数を直接呼び出すには、その関数に <xref:System.Data.Objects.ObjectQuery%601> を渡す必要があります。  詳細については、以下の 2 番目の例を参照してください。  
+  
+ 一部の正規関数は、LINQ to Entities クエリで共通言語ランタイム \(CLR\) メソッドを使用して呼び出すことができます。  正規関数にマップされる CLR メソッドの一覧については、「[CLR メソッドと正規関数とのマッピング](../../../../../../docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md)」を参照してください。  
+  
+## 使用例  
+ [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用する例を次に示します。  この例で実行される LINQ to Entities クエリは、<xref:System.Data.Objects.EntityFunctions.DiffDays%2A> メソッドを使用して、`SellEndDate` と `SellStartDate` の差が 365 日よりも少ないすべての製品を返します。  
+  
+ [!code-csharp[DP L2E CanonicalAndStoreFunctions#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e canonicalandstorefunctions/cs/program.cs#1)]
+ [!code-vb[DP L2E CanonicalAndStoreFunctions#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e canonicalandstorefunctions/vb/module1.vb#1)]  
+  
+## 使用例  
+ [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用する例を次に示します。  この例では、`SalesOrderHeader` の小計の標準偏差を返す集計 <xref:System.Data.Objects.EntityFunctions.StandardDeviation%2A> メソッドを直接呼び出します。  <xref:System.Data.Objects.ObjectQuery%601> は関数に渡されているため、LINQ to Entities クエリに含まれていなくても呼び出すことができる点に注意してください。  
+  
+ [!code-csharp[DP L2E CanonicalAndStoreFunctions#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e canonicalandstorefunctions/cs/program.cs#2)]
+ [!code-vb[DP L2E CanonicalAndStoreFunctions#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e canonicalandstorefunctions/vb/module1.vb#2)]  
+  
+## 参照  
+ [LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-to-call-custom-database-functions.md b/docs/framework/data/adonet/ef/language-reference/how-to-call-custom-database-functions.md
new file mode 100644
index 00000000000..b8952323a30
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-to-call-custom-database-functions.md
@@ -0,0 +1,69 @@
+---
+title: "方法: カスタム データベース関数を呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4354e5eb-dd45-469d-97fb-1c495705ee59
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 方法: カスタム データベース関数を呼び出す
+ここでは、データベースで定義されたカスタム関数を LINQ Entities クエリから呼び出す方法について説明します。  
+  
+ LINQ to Entities クエリから呼び出されるデータベース関数は、データベース内で実行されます。  データベース内で関数を実行すると、アプリケーションのパフォーマンスが向上します。  
+  
+ 下に示す手順は、カスタム データベース関数を呼び出す方法の概要をまとめたものです。  各手順の詳しい説明は、その後の例で示します。  
+  
+### データベースで定義されるカスタム関数を呼び出すには  
+  
+1.  データベースにカスタム関数を作成します。  
+  
+     SQL Server におけるカスタム関数の作成の詳細については、「[CREATE FUNCTION \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkID=139871)」を参照してください。  
+  
+2.  関数を .edmx ファイルのストア スキーマ定義言語 \(SSDL\) で宣言します。  関数の名前は、データベースで宣言される関数と同じ名前にする必要があります。  
+  
+     詳細については、「[Function Element \(SSDL\)](http://msdn.microsoft.com/ja-jp/b60cfc3d-8b93-423e-8c99-b867256640a4)」を参照してください。  
+  
+3.  対応するメソッドをアプリケーション コードのクラスに追加して、<xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> をそのメソッドに適用する必要があります。属性の <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.NamespaceName%2A> パラメーターと <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.FunctionName%2A> パラメーターが、それぞれ概念モデルの名前空間名と概念モデルの関数名であることに注意してください。  LINQ の関数名解決では、大文字と小文字が区別されます。  
+  
+4.  LINQ to Entities クエリからメソッドを呼び出します。  
+  
+## 使用例  
+ 次の例は、カスタム データベース関数を LINQ to Entities クエリから呼び出す方法について説明します。  この例では、School モデルを使用します。  School モデルについては、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」および「[Generating the School .edmx File](http://msdn.microsoft.com/ja-jp/c48b3907-a8be-4fe6-884c-e95af1852758)」を参照してください。  
+  
+ 次のコードは、`AvgStudentGrade` 関数を School のサンプル データベースに追加しています。  
+  
+> [!NOTE]
+>  カスタム データベース関数を呼び出す手順は、データベース サーバーとは無関係にすべて同じです。  ただし、下に示すコードは、SQL Server データベースで関数を作成する方法に固有のものです。  他のデータベース サーバーでカスタム関数を作成する場合には、コードは異なることがあります。  
+  
+ [!code-sql[DP L2E MapToDBFunction#1](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp l2e maptodbfunction/tsql/create_avgstudentgrade.sql#1)]  
+  
+## 使用例  
+ 次に、関数を .edmx ファイルのストア スキーマ定義言語 \(SSDL\) で宣言します。  次のコードは、`AvgStudentGrade` 関数を SSDL で宣言しています。  
+  
+ [!code-xml[DP L2E MapToDBFunction#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e maptodbfunction/cs/school.edmx#2)]  
+  
+## 使用例  
+ 次に、メソッドを作成して、SSDL で宣言された関数にマップします。  次のクラスのメソッドは、<xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> を使用して SSDL \(上を参照\) で定義される関数にマップされます。  このメソッドが呼び出されると、データベース内の対応する関数が実行されます。  
+  
+ [!code-csharp[DP L2E MapToDBFunction#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e maptodbfunction/cs/program.cs#3)]
+ [!code-vb[DP L2E MapToDBFunction#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e maptodbfunction/vb/module1.vb#3)]  
+  
+## 使用例  
+ 最後に、メソッドを LINQ to Entities クエリで呼び出します。  次のコードは、学生の姓と平均の成績をコンソールに表示します。  
+  
+ [!code-csharp[DP L2E MapToDBFunction#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e maptodbfunction/cs/program.cs#4)]
+ [!code-vb[DP L2E MapToDBFunction#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e maptodbfunction/vb/module1.vb#4)]  
+  
+## 参照  
+ [.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-to-call-database-functions.md b/docs/framework/data/adonet/ef/language-reference/how-to-call-database-functions.md
new file mode 100644
index 00000000000..c72b6d43327
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-to-call-database-functions.md
@@ -0,0 +1,42 @@
+---
+title: "データベース関数を呼び出す方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79038efa-15bf-464a-83e2-35fe145252ce
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# データベース関数を呼び出す方法
+<xref:System.Data.Objects.SqlClient.SqlFunctions> クラスには、LINQ to Entities クエリで使用する SQL Server 関数を公開するメソッドが含まれています。  LINQ to Entities クエリで <xref:System.Data.Objects.SqlClient.SqlFunctions> メソッドを使用すると、対応するデータベース関数がデータベースで実行されます。  
+  
+> [!NOTE]
+>  値のセットに対して計算を実行して 1 つの値を返すデータベース関数 \(集計データベース関数とも呼ばれる\) は、直接呼び出すことができます。  他の正規関数は、LINQ to Entities クエリの一部としてしか呼び出すことができません。  集計関数を直接呼び出すには、その関数に <xref:System.Data.Objects.ObjectQuery%601> を渡す必要があります。  詳細については、以下の 2 番目の例を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Data.Objects.SqlClient.SqlFunctions> クラスのメソッドは、SQL Server 関数に固有です。  他のプロバイダーから、データベース関数を公開する同様のクラスを入手できることがあります。  
+  
+## 使用例  
+ [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用する例を次に示します。  この例では、<xref:System.Data.Objects.SqlClient.SqlFunctions.CharIndex%2A> メソッドを使用する LINQ to Entities クエリを実行して、姓が "Si" で始まる連絡先をすべて返します。  
+  
+ [!code-csharp[DP L2E CanonicalAndStoreFunctions#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e canonicalandstorefunctions/cs/program.cs#3)]
+ [!code-vb[DP L2E CanonicalAndStoreFunctions#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e canonicalandstorefunctions/vb/module1.vb#3)]  
+  
+## 使用例  
+ [AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用する例を次に示します。  この例では、集計 <xref:System.Data.Objects.SqlClient.SqlFunctions.ChecksumAggregate%2A> メソッドを直接呼び出します。  <xref:System.Data.Objects.ObjectQuery%601> は関数に渡されているため、LINQ to Entities クエリに含まれていなくても呼び出すことができる点に注意してください。  
+  
+ [!code-csharp[DP L2E CanonicalAndStoreFunctions#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e canonicalandstorefunctions/cs/program.cs#4)]
+ [!code-vb[DP L2E CanonicalAndStoreFunctions#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e canonicalandstorefunctions/vb/module1.vb#4)]  
+  
+## 参照  
+ [LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-as-object-methods.md b/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-as-object-methods.md
new file mode 100644
index 00000000000..9de430eba99
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-as-object-methods.md
@@ -0,0 +1,119 @@
+---
+title: "方法: モデル定義関数をオブジェクト メソッドとして呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33bae8a8-4ed8-4a1f-85d1-c62ff288cc61
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 方法: モデル定義関数をオブジェクト メソッドとして呼び出す
+ここでは、モデル定義関数を <xref:System.Data.Objects.ObjectContext> オブジェクトのメソッドまたはカスタム クラスの静的メソッドとして呼び出す方法について説明します。  *モデル定義関数*は、概念モデルで定義される関数です。  このトピックで説明する手順は、これらの関数を LINQ to Entities クエリから呼び出すのではなく、直接呼び出す方法を示すものです。  モデル定義関数を LINQ to Entities クエリに呼び出す方法の詳細については、「[方法: クエリを使用してモデル定義関数を呼び出す](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-in-queries.md)」を参照してください。  
+  
+ モデル定義関数を <xref:System.Data.Objects.ObjectContext> メソッドとして呼び出す場合も、カスタム クラスの静的メソッドとして呼び出す場合も、ます <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> でメソッドをモデル定義関数にマップする必要があります。  ただし、<xref:System.Data.Objects.ObjectContext> クラスのメソッドを定義するときには、<xref:System.Data.Objects.ObjectContext.QueryProvider%2A> プロパティを使用して LINQ プロバイダーを公開する必要があります。それに対して、カスタム クラスの静的メソッドを定義するときには、<xref:System.Linq.IQueryable.Provider%2A> プロパティを使用して LINQ プロバイダーを公開する必要があります。  詳細については、下の手順の後に示した例を参照してください。  
+  
+ 下の手順は、モデル定義関数を <xref:System.Data.Objects.ObjectContext> オブジェクトのメソッドおよびカスタム クラスの静的メソッドとして呼び出す方法の概要を示したものです。  詳細な手順は、その後の例で示します。  この手順では、関数を概念モデルで定義済みであると想定します。  詳細については、「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照してください。  
+  
+### モデル定義関数を ObjectContext オブジェクトのメソッドとして呼び出すには  
+  
+1.  ソース ファイルを追加して、部分クラスを拡張します。このクラスは、<xref:System.Data.Objects.ObjectContext> クラスから派生したものであり、Entity Framework ツールによって自動生成されます。  CLR スタブを別のソース ファイルで定義すると、ファイルを再生成しても変更内容が失われません。  
+  
+2.  共通言語ランタイム \(CLR\) メソッドを、次のことを行う <xref:System.Data.Objects.ObjectContext> クラスに追加します。  
+  
+    -   概念モデルで定義された関数にマップします。  メソッドをマップするには、ユーザーが <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> をメソッドに適用する必要があります。  属性の <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.NamespaceName%2A> パラメーターと <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.FunctionName%2A> パラメーターが、それぞれ概念モデルの名前空間と概念モデルの関数名であることに注意してください。  LINQ の関数名解決では、大文字と小文字が区別されます。  
+  
+    -   <xref:System.Data.Objects.ObjectContext.QueryProvider%2A> プロパティによって返される <xref:System.Linq.IQueryProvider.Execute%2A> メソッドの結果を返します。  
+  
+3.  メソッドを <xref:System.Data.Objects.ObjectContext> クラスのインスタンスのメンバーとして呼び出します。  
+  
+### モデル定義関数をカスタム クラスの静的メソッドとして呼び出すには  
+  
+1.  クラスを次のことを行う静的メソッドでアプリケーションに追加します。  
+  
+    -   概念モデルで定義された関数にマップします。  メソッドをマップするには、ユーザーが <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> をメソッドに適用する必要があります。  属性の <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.NamespaceName%2A> パラメーターと <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.FunctionName%2A> パラメーターが、それぞれ概念モデルの名前空間と概念モデルの関数名であることに注意してください。  
+  
+    -   <xref:System.Linq.IQueryable> 引数を受け取ります。  
+  
+    -   <xref:System.Linq.IQueryable.Provider%2A> プロパティによって返される <xref:System.Linq.IQueryProvider.Execute%2A> メソッドの結果を返します。  
+  
+2.  メソッドをカスタム クラスの静的メソッドのメンバーとして呼び出します。  
+  
+## 使用例  
+ **モデル定義関数を ObjectContext オブジェクトのメソッドとして呼び出す**  
+  
+ 次の例で、モデル定義関数を <xref:System.Data.Objects.ObjectContext> オブジェクトのメソッドとして呼び出す方法を説明します。  この例では、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用します。  
+  
+ 指定製品の製品収益を返す下の概念モデル関数について考察してください   \(関数を概念モデルに追加する方法については、「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照してください\)。  
+  
+ [!code-xml[DP L2E Methods on ObjectContext#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/obj/x86/debug/edmxresourcestoembed/adventureworks.csdl#4)]
+ [!code-xml[DP L2E Methods on ObjectContext#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/obj/x86/debug/edmxresourcestoembed/adventureworks.csdl#4)]
+ [!code-xml[DP L2E Methods on ObjectContext#4](../../../../../../samples/snippets/xml/VS_Snippets_Data/dp l2e methods on objectcontext/xml/adventureworks.edmx#4)]  
+  
+## 使用例  
+ 次のコードでは、メソッドを上の概念モデル関数にマップする `AdventureWorksEntities` クラスに追加します。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#2)]
+ [!code-vb[DP L2E Methods on ObjectContext#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/class1.vb#2)]  
+  
+## 使用例  
+ 次のコードでは、上のメソッドを呼び出して、指定製品の製品収益を表示します。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#3)]
+ [!code-vb[DP L2E Methods on ObjectContext#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/module1.vb#3)]  
+  
+## 使用例  
+ 次の例で、コレクション \(<xref:System.Linq.IQueryable%601> オブジェクトとして\) を返すモデル定義関数を呼び出す方法を説明します。  指定された製品 ID に関して `SalesOrderDetails` をすべて返す下の概念モデル関数について考察してください。  
+  
+ [!code-xml[DP L2E Methods on ObjectContext#7](../../../../../../samples/snippets/xml/VS_Snippets_Data/dp l2e methods on objectcontext/xml/adventureworks.edmx#7)]  
+  
+## 使用例  
+ 次のコードでは、メソッドを上の概念モデル関数にマップする `AdventureWorksEntities` クラスに追加します。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#8](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#8)]
+ [!code-vb[DP L2E Methods on ObjectContext#8](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/class1.vb#8)]  
+  
+## 使用例  
+ 次のコードは、メソッドを呼び出します。  返された <xref:System.Linq.IQueryable%601> クエリがさらに絞り込まれて、各 `SalesOrderDetail` のライン合計を返すことに注意してください。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#9](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#9)]
+ [!code-vb[DP L2E Methods on ObjectContext#9](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/module1.vb#9)]  
+  
+## 使用例  
+ **モデル定義関数をカスタム クラスの静的メソッドとして呼び出す**  
+  
+ 次の例で、モデル定義関数をカスタム クラスの静的メソッドとして呼び出す方法を説明します。  この例では、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を使用します。  
+  
+> [!NOTE]
+>  ユーザーが、モデル定義関数をカスタム クラスの静的メソッドとして呼び出すときには、モデル定義関数はコレクションを受け取って、コレクションの値の集計結果を返す必要があります。  
+  
+ SalesOrderDetail コレクションの製品収益を返す下の概念モデル関数について考察してください   \(関数を概念モデルに追加する方法については、「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照してください\)。  
+  
+ [!code-xml[DP L2E Methods on ObjectContext#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/obj/x86/debug/edmxresourcestoembed/adventureworks.csdl#1)]
+ [!code-xml[DP L2E Methods on ObjectContext#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/obj/x86/debug/edmxresourcestoembed/adventureworks.csdl#1)]
+ [!code-xml[DP L2E Methods on ObjectContext#1](../../../../../../samples/snippets/xml/VS_Snippets_Data/dp l2e methods on objectcontext/xml/adventureworks.edmx#1)]  
+  
+## 使用例  
+ 次のコードでは、上の概念モデル関数にマップする静的メソッドを持つアプリケーションにクラスを追加します。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#5)]
+ [!code-vb[DP L2E Methods on ObjectContext#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/class1.vb#5)]  
+  
+## 使用例  
+ 次のコードでは、上のメソッドを呼び出して、SalesOrderDetail コレクションの製品収益を表示します。  
+  
+ [!code-csharp[DP L2E Methods on ObjectContext#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e methods on objectcontext/cs/program.cs#6)]
+ [!code-vb[DP L2E Methods on ObjectContext#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e methods on objectcontext/vb/module1.vb#6)]  
+  
+## 参照  
+ [.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)   
+ [LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-in-queries.md b/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-in-queries.md
new file mode 100644
index 00000000000..bdf1294c7f0
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-in-queries.md
@@ -0,0 +1,54 @@
+---
+title: "方法: クエリを使用してモデル定義関数を呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c804e4d-f348-4afd-9f63-d3f0f24bc6a9
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 方法: クエリを使用してモデル定義関数を呼び出す
+ここでは、概念モデルで定義されている関数を [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリから呼び出す方法について説明します。  
+  
+ 以下に示す手順は、モデル定義関数を [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリから呼び出す方法をまとめたものです。  各手順の詳しい説明は、その後の例で示します。  この手順では、関数を概念モデルで定義済みであると想定します。  詳細については、「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照してください。  
+  
+### 概念モデルで定義された関数を呼び出すには  
+  
+1.  概念モデルで定義された関数にマップされているアプリケーションに、共通言語ランタイム \(CLR\) メソッドを追加します。  メソッドをマップするには、ユーザーが <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> をメソッドに適用する必要があります。  属性の <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.NamespaceName%2A> パラメーターと <xref:System.Data.Objects.DataClasses.EdmFunctionAttribute.FunctionName%2A> パラメーターが、それぞれ概念モデルの名前空間名と関数名であることに注意してください。  LINQ の関数名解決では、大文字と小文字が区別されます。  
+  
+2.  [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリを使用して関数を呼び出します。  
+  
+## 使用例  
+ 次の例は、概念モデルで定義されている関数を [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリから呼び出す方法を示しています。  この例では、School モデルを使用します。  School モデルについては、「[Creating the School Sample Database](http://msdn.microsoft.com/ja-jp/c1bec483-a0ea-4660-aa0b-7b0a8b68fed0)」および「[Generating the School .edmx File](http://msdn.microsoft.com/ja-jp/c48b3907-a8be-4fe6-884c-e95af1852758)」を参照してください。  
+  
+ 次の概念モデル関数は、あるインストラクターが雇用されてから経過した年数を返します。  関数を概念モデルに追加する方法については、「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照してください\)。  
+  
+ [!code-xml[DP ConceptualModelFunctions#1](../../../../../../samples/snippets/xml/VS_Snippets_Data/dp conceptualmodelfunctions/xml/school.edmx#1)]
+ [!code-xml[DP ConceptualModelFunctions#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp conceptualmodelfunctions/cs/obj/debug/edmxresourcestoembed/school.csdl#1)]  
+  
+## 使用例  
+ 次に、次のメソッドをアプリケーションに追加し、<xref:System.Data.Objects.DataClasses.EdmFunctionAttribute> を使用して概念モデル関数にマップします。  
+  
+ [!code-csharp[DP ConceptualModelFunctions#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp conceptualmodelfunctions/cs/program.cs#2)]
+ [!code-vb[DP ConceptualModelFunctions#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp conceptualmodelfunctions/vb/module1.vb#2)]  
+  
+## 使用例  
+ これで、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリから概念モデル関数を呼び出すことができます。  次のコードは、雇用年数が 10 年を超えるすべてのインストラクターを表示するメソッドを呼び出します。  
+  
+ [!code-csharp[DP ConceptualModelFunctions#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp conceptualmodelfunctions/cs/program.cs#3)]
+ [!code-vb[DP ConceptualModelFunctions#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp conceptualmodelfunctions/vb/module1.vb#3)]  
+  
+## 参照  
+ [.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)   
+ [LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)   
+ [方法: モデル定義関数をオブジェクト メソッドとして呼び出す](../../../../../../docs/framework/data/adonet/ef/language-reference/how-to-call-model-defined-functions-as-object-methods.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md
new file mode 100644
index 00000000000..59201715b31
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md
@@ -0,0 +1,137 @@
+---
+title: "識別子 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d58a5edd-7b5c-48e1-b5d7-a326ff426aa4
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 識別子 (Entity SQL)
+識別子はクエリ式の別名、変数参照、オブジェクトのプロパティ、関数などを表すために [!INCLUDE[esql](../../../../../../includes/esql-md.md)] で使用されます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の識別子には、単純な識別子と引用符で囲まれた識別子の 2 種類があります。  
+  
+## 単純な識別子  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の単純な識別子は、英数字とアンダースコア文字のシーケンスです。  識別子の最初の文字は英文字 \(a ～ z または A ～ Z\) にする必要があります。  
+  
+## 引用符で囲まれた識別子  
+ 引用符で囲まれた識別子とは、角かっこ \(\[\]\) で囲まれた文字のシーケンスです。  引用符で囲まれた識別子を使用すると、単純な識別子内では無効になる文字を使用して識別子を指定することができます。  角かっこ内のすべての文字 \(すべての空白を含む\) が識別子の一部になります。  
+  
+ ただし、次の文字を含めることはできません。  
+  
+-   改行  
+  
+-   キャリッジ リターン  
+  
+-   タブ  
+  
+-   バックスペース  
+  
+-   追加の角かっこ \(識別子の境界を表す角かっこの中の角かっこ\)  
+  
+ Unicode 文字を含めることはできます。  
+  
+ 引用符で囲まれた識別子を使用することにより、次の例のように、識別子では無効な文字を含むプロパティ名を作成できます。  
+  
+ `SELECT c.ContactName AS [Contact Name] FROM customers AS c`  
+  
+ また、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の予約済みキーワードを識別子として指定することもできます。  たとえば、`Email` 型に "From" という名前のプロパティがある場合、次のように角かっこを使用することで、予約済みキーワードの FROM と区別できます。  
+  
+ `SELECT e.[From] FROM emails AS e`  
+  
+ ドット \(.\) 演算子の右側に引用符で囲まれた識別子を使用できます。  
+  
+ `SELECT t FROM ts as t WHERE t.[property] == 2`  
+  
+ 識別子に角かっこを使用するには、角かっこをもう 1 つ追加します。  次の例では、"`abc]`" が識別子です。  
+  
+ `SELECT t from ts as t WHERE t.[abc]]] == 2`  
+  
+ 引用符で囲まれた識別子の比較セマンティクスについては、「[入力文字セット](../../../../../../docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md)」を参照してください。  
+  
+## 別名の規則  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、必要な場合には常に別名を指定することが推奨されます。たとえば、次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 構成要素に対しては別名を指定するようにしてください。  
+  
+-   行コンストラクターのフィールド  
+  
+-   クエリ式の FROM 句の項目  
+  
+-   クエリ式の SELECT 句の項目  
+  
+-   クエリ式の GROUP BY 句の項目  
+  
+### 有効な別名  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の有効な別名とは、単純な識別子および引用符で囲まれた識別子です。  
+  
+### 別名の生成  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリ式で別名が指定されていない場合は、次の単純な規則に基づいて別名が生成されます。  
+  
+-   クエリ式 \(別名が指定されていないクエリ式\) が単純な識別子または引用符で囲まれた識別子の場合は、その識別子が別名として使用されます。  たとえば、 `ROW(a, [b])`  が  `ROW(a AS a, [b] AS [b])` になります。  
+  
+-   より複雑なクエリ式でも、最後の構成要素が単純な識別子であれば、その識別子が別名として使用されます。  たとえば、 `ROW(a.a1, b.[b1])`  が  `ROW(a.a1 AS a1, b.[b1] AS [b1])` になります。  
+  
+ 後に使用する別名に対しては暗黙的な別名を使用しないことをお勧めします。  別名 \(暗黙的な別名または明示的な別名\) が同じスコープで競合していたり繰り返し使用されていたりするとコンパイル エラーが発生しますが、  暗黙的な別名は、同じ名前の明示的または暗黙的な別名があってもそのままコンパイルされます。  
+  
+ 暗黙的な別名は、ユーザー入力に基づいて自動的に生成されます。  たとえば次のコードでは、両方の列の別名として NAME が生成されるため、競合が発生します。  
+  
+```  
+SELECT product.NAME, person.NAME  
+```  
+  
+ 明示的な別名を使用している次のコードも同じように失敗しますが、  こちらの方がコードを見たときにエラーを発見しやすくなります。  
+  
+```  
+SELECT 1 AS X, 2 AS X …  
+```  
+  
+## スコープの規則  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではスコープの規則が定義されています。これにより、クエリ言語で特定の変数をいつ参照できるかが決まります。  一部の式やステートメントでは新しい名前が導入されます。  スコープの規則は、そのような名前をどこで使用でき、いつ \(どこで\) 同じ名前の新しい宣言によって前の名前を参照できなくなるのかが決まります。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリで名前を定義すると、それらはスコープの中で定義されたことになります。  スコープはクエリの全領域をカバーします。  特定のスコープで定義されている名前は、そのスコープのすべての式や名前参照から参照できます。  スコープが始まる前や終わった後では、そのスコープで定義されている名前は参照できません。  
+  
+ スコープは入れ子にすることもできます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の一部では、全領域をカバーする新しいスコープが形成されますが、それらの領域に、同じようにスコープを形成する他の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 式を含めることができます。  スコープが入れ子になっている場合、最も内側のスコープに含まれている参照からは、そのスコープで定義されている名前を参照できるだけでなく、  それより外側のスコープで定義されている名前も参照できます。  同じスコープ内で定義されている 2 つのスコープは兄弟スコープと見なされます。  兄弟スコープで定義されている名前を参照することはできません。  
+  
+ 内側のスコープで宣言した名前が外側のスコープで宣言されている名前と一致する場合、内側のスコープ内の参照や、そのスコープの中で宣言したスコープ内の参照は、その新しく宣言した名前のみを参照します。  外側のスコープの名前は参照できません。  
+  
+ 同じスコープの中であっても、まだ定義されていない名前を参照することはできません。  
+  
+ グローバルな名前は実行環境の一部として存在することができます。  たとえば、永続的なコレクションや環境変数の名前がこれに含まれます。  名前をグローバルにするには、最も外側のスコープで宣言する必要があります。  
+  
+ パラメーターはスコープに含まれません。  パラメーターの参照には特別な構文が含まれるため、パラメーターの名前がクエリ内の他の名前と衝突することはありません。  
+  
+### クエリ式  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリ式では新しいスコープが形成されます。  FROM 句で定義された名前は、出現順 \(左から右の順\) に from スコープに導入されます。  結合リストでは、既にリストで定義されている名前を式で参照できます。  FROM 句で指定された要素のパブリック プロパティ \(フィールドなど\) は from スコープに追加されません。  それらは常に、別名で修飾された名前で参照する必要があります。  通常は、SELECT 式のすべての部分が from スコープに含まれると見なされます。  
+  
+ GROUP BY 句でも新しい兄弟スコープが形成されます。  各グループは、そのグループ内の要素のコレクションを参照するグループ名を持つことができます。  各グループ化式も、group スコープに新しい名前を導入します。  さらに、入れ子集計 \(名前付きグループ\) もスコープに追加されます。  グループ化式自体は from スコープに含まれますが、  選択リスト \(投影\)、HAVING 句、および ORDER BY 句は、GROUP BY 句が使用されている場合には from スコープではなく group スコープに含まれると見なされます。  集計は、この後で説明するように特別扱いになります。  
+  
+ スコープに関する追加の注意事項を以下に示します。  
+  
+-   選択リストでは、新しい名前が順番にスコープに導入されます。  右側の投影式では、左側で投影されている名前を参照できます。  
+  
+-   ORDER BY 句では、選択リストで指定されている名前 \(別名\) を参照できます。  
+  
+-   SELECT 式内の句が評価される順序によって、名前がスコープに導入される順序が決まります。  FROM 句が最初に評価され、WHERE 句、GROUP BY 句、HAVING 句、SELECT 句の順に続き、最後に ORDER BY 句が評価されます。  
+  
+### 集計の処理  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、コレクションベースの集計とグループベースの集計の 2 つの形式の集計がサポートされています。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ではコレクションベースの集計を使用することをお勧めします。グループベースの集計は、SQL との互換性のためにサポートされています。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、集計を解決する際に、まずコレクションベースの集計として処理しようとします。  それが失敗した場合は、その集計の入力を入れ子集計への参照に変換して、その新しい式を解決しようとします。以下に例を示します。  
+  
+ `AVG(t.c) becomes AVG(group..(t.c))`  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [入力文字セット](../../../../../../docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/in-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/in-entity-sql.md
new file mode 100644
index 00000000000..c655af2f5a5
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/in-entity-sql.md
@@ -0,0 +1,56 @@
+---
+title: "IN (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 51662950-ee01-4857-b7b9-311dd8515966
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# IN (Entity SQL)
+コレクション内に一致する値があるかどうかを調べます。  
+  
+## 構文  
+  
+```  
+  
+value [ NOT ] IN expression  
+```  
+  
+## 引数  
+ `value`  
+ 照合する値を返す任意の有効な式。  
+  
+ \[ NOT \]  
+ IN の `Boolean` 型の結果を否定することを指定します。  
+  
+ `expression`  
+ 一致の判定対象のコレクションを返す任意の有効な式。 すべての式は、`value` と同じ型であるか、共通の基本型または派生型である必要があります。  
+  
+## 戻り値  
+ コレクションに値が見つかった場合は `true`、値が null またはコレクションが null の場合は null、それ以外の場合は `false` が返されます。 NOT IN を使用すると、IN の結果が否定されます。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、IN 演算子を使用して、コレクション内に一致する値があるかどうかを調べます。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#IN](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#in)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/index.md b/docs/framework/data/adonet/ef/language-reference/index.md
new file mode 100644
index 00000000000..96840f9895c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/index.md
@@ -0,0 +1,41 @@
+---
+title: "Entity SQL 言語リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bb07282c-161d-47e8-856d-b2374ba18181
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# Entity SQL 言語リファレンス
+このセクションでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)]、[!INCLUDE[esql](../../../../../../includes/esql-md.md)]、および [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] で使用されるモデリング言語とマッピング言語について詳しく説明します。  
+  
+## このセクションの内容  
+ [CSDL、SSDL、および MSL 仕様](../../../../../../docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md)  
+  
+ [LINQ to Entities](../../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)  
+  
+ [Entity SQL 言語](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)  
+  
+ [Canonical Functions](../../../../../../docs/framework/data/adonet/ef/language-reference/index.md)  
+  
+## 関連項目  
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../../docs/framework/data/adonet/ef/index.md)   
+ [はじめに](../../../../../../docs/framework/data/adonet/ef/getting-started.md)   
+ [Samples](http://msdn.microsoft.com/ja-jp/77500b07-de49-4fb7-93ee-ce76f72d4646)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/initialization-expressions.md b/docs/framework/data/adonet/ef/language-reference/initialization-expressions.md
new file mode 100644
index 00000000000..199f043bf92
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/initialization-expressions.md
@@ -0,0 +1,58 @@
+---
+title: "初期化式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 98daef1f-15d4-483e-985c-d78ea3abe8c8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 初期化式
+初期化式は、新しいオブジェクトを初期化します。  初期化式は、ほとんどの新しい C\# 3.0 および Visual Basic 9.0 初期化式を含め、ほとんどがサポートされています。  次の型は、LINQ to Entities クエリによって初期化して返すことができます。  
+  
+-   0 個以上の型指定されたエンティティ オブジェクトのコレクション、または概念モデルで定義された複合型のプロジェクション。  
+  
+-   [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] でサポートされる CLR 型。  
+  
+-   インライン コレクション。  
+  
+-   匿名型。  
+  
+ クエリ式構文の次の例では、匿名型の初期化を示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#AnonymousTypeInitialization](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#anonymoustypeinitialization)]
+ [!code-vb[DP L2E Conceptual Examples#AnonymousTypeInitialization](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#anonymoustypeinitialization)]  
+  
+ メソッドベースのクエリ構文の次の例では、匿名型の初期化を示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#AnonymousTypeInitialization_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#anonymoustypeinitialization_mq)]
+ [!code-vb[DP L2E Conceptual Examples#AnonymousTypeInitialization_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#anonymoustypeinitialization_mq)]  
+  
+ ユーザー定義クラスの初期化もサポートされています。  C\# 3.0 および Visual Basic 9.0 の初期化パターンがサポートされており、getter と setter のプロパティは対称であることが前提となります。  クエリ式構文の次の例では、クエリ内で初期化されるカスタム クラスを示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#MyOrder](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#myorder)]
+ [!code-vb[DP L2E Conceptual Examples#MyOrder](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#myorder)]  
+  
+ [!code-csharp[DP L2E Conceptual Examples#TypeInitialization](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#typeinitialization)]
+ [!code-vb[DP L2E Conceptual Examples#TypeInitialization](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#typeinitialization)]  
+  
+ メソッドベース クエリ構文の次の例では、クエリ内で初期化されるカスタム クラスを示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#TypeInitialization_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#typeinitialization_mq)]
+ [!code-vb[DP L2E Conceptual Examples#TypeInitialization_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#typeinitialization_mq)]  
+  
+## 参照  
+ [LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md
new file mode 100644
index 00000000000..31c10c9a3b7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/input-character-set-entity-sql.md
@@ -0,0 +1,43 @@
+---
+title: "入力文字セット (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 13d291d3-e6bc-4719-b953-758b61a590b6
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 入力文字セット (Entity SQL)
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、UTF\-16 でエンコードされた UNICODE 文字を受け取ります。  
+  
+ 文字列リテラルには、単一引用符で囲んだ任意の UTF\-16 文字を含めることができます   たとえば、N'リテラル文字列' のように記述します。  文字列リテラルが比較される際は、元の UTF\-16 の値が使用されます。  たとえば、N'ABC' は、日本語とラテンのコードページでは異なります。  
+  
+ コメントには、任意の UTF\-16 文字を含めることができます。  
+  
+ エスケープされた識別子には、角かっこで囲んだ任意の UTF\-16 文字を含めることができます   たとえば、\[エスケープされた識別子\] のように記述します。  UTF\-16 エスケープされた識別子の比較では、大文字と小文字が区別されません。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、同じように表示されても別のコード ページに由来する文字の複数のバージョンを別々の文字として扱います。  たとえば、対応する文字が同じコード ページである場合、\[ABC\] は \[abc\] と同じものと見なされます。  ただし、同じ 2 つの識別子のコード ページが異なる場合は、同じものと見なされません。  
+  
+ 空白は、任意の UTF\-16 空白文字です。  
+  
+ 改行は、任意の正規化 UTF\-16 改行文字です。  たとえば、'\\n' および '\\r\\n' は改行文字と見なされますが、'\\r' は改行文字ではありません。  
+  
+ キーワード、式、および句読点には、ラテン語に正規化された任意の UTF\-16 文字を使用できます。  たとえば、日本語のコードページの SELECT は有効なキーワードです。  
+  
+ キーワード、式、および区切り記号に使用できるのは、ラテン文字だけです。  `SELECT` は、日本語のコード ページではキーワードではありません。  \+、\-、\*、\/、\=、\(、\)、‘、\[、\]、およびここに示されていないその他の言語コンストラクトに使用できるのは、ラテン文字だけです。  
+  
+ シンプルな識別子に使用できるのはラテン文字だけです。  元の値が比較されるので、比較の際のあいまいさが回避されます。  たとえば、\[ABC\] は、日本語とラテン語のコードページでは異なります。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/intersect-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/intersect-entity-sql.md
new file mode 100644
index 00000000000..bc00abaeb4b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/intersect-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "INTERSECT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 93c6fe33-f341-4b52-911e-adf503891951
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# INTERSECT (Entity SQL)
+INTERSECT オペランドの左右両方のクエリ式によって返される個別の値のコレクションを返します。 すべての式は、`expression` と同じ型であるか、共通の基本型または派生型である必要があります。  
+  
+## 構文  
+  
+```  
+  
+expression INTERSECT expression  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効なクエリ式。もう一方のクエリ式から返されたコレクションと比較されます。  
+  
+## 戻り値  
+ `expression` と同じ型であるか、共通の基本データ型または派生型であるコレクション。  
+  
+## 解説  
+ INTERSECT は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、INTERSECT 演算子を使用して、INTERSECT オペランドの左右両方のクエリ式によって返される個別の値のコレクションを返します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#INTERSECT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#intersect)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/isnull-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/isnull-entity-sql.md
new file mode 100644
index 00000000000..2647c5eea70
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/isnull-entity-sql.md
@@ -0,0 +1,81 @@
+---
+title: "ISNULL (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: dc7a0173-3664-4c90-a57b-5cbb0a8ed7ee
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ISNULL (Entity SQL)
+クエリ式が NULL かどうかを調べます。  
+  
+## 構文  
+  
+```  
+  
+expression IS [ NOT ] NULL  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効なクエリ式。 コレクションにすることはできません。また、コレクション メンバーや、コレクション型のプロパティを持つレコード型を含めることはできません。  
+  
+ NOT  
+ IS NULL の EDM.Boolean の結果を否定します。  
+  
+## 戻り値  
+ `true` によって NULL が返される場合は `expression`、それ以外の場合は `false` です。  
+  
+## 解説  
+ 外部結合の要素が NULL かどうかを確認するには、`IS NULL` を使用します。  
+  
+```  
+select c   
+      from LOB.Customers as c left outer join LOB.Orders as o   
+                              on c.ID = o.CustomerID    
+      where o is not null and o.OrderQuantity = @x  
+```  
+  
+ メンバーに実際の値が含まれているかどうかを確認するには、`IS NULL` を使用します。  
+  
+```  
+select c from LOB.Customer as c where c.DOB is not null  
+```  
+  
+ 次の表は、いくつかのパターンにおける `IS NULL` の動作を示しています。 すべての例外はクライアント側にスローされてから、プロバイダーが呼び出されます。  
+  
+|パターン|動作|  
+|----------|--------|  
+|null IS NULL|`true` を返します。|  
+|TREAT \(null AS EntityType\) IS NULL|`true` を返します。|  
+|TREAT \(null AS ComplexType\) IS NULL|エラーをスローします。|  
+|TREAT \(null AS RowType\) IS NULL|エラーをスローします。|  
+|EntityType IS NULL|`true` または `false` を返します。|  
+|ComplexType IS NULL|エラーをスローします。|  
+|RowType IS NULL|エラーをスローします。|  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、IS NOT NULL 演算子を使用して、クエリ式が NULL でないかどうかを確認します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#ISNULL](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#isnull)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/isof-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/isof-entity-sql.md
new file mode 100644
index 00000000000..cc59204bead
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/isof-entity-sql.md
@@ -0,0 +1,72 @@
+---
+title: "ISOF (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 5b2b0d34-d0a7-4bcd-baf2-58aa8456d00b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ISOF (Entity SQL)
+式の型が指定の型であるか、またはそのサブタイプであるかを判断します。  
+  
+## 構文  
+  
+```  
+  
+expression IS [ NOT ] OF ( [ ONLY ] type)  
+```  
+  
+## 引数  
+ `expression`  
+ 型を判断するための任意の有効なクエリ式。  
+  
+ NOT  
+ IS OF の EDM.Boolean の結果を否定します。  
+  
+ ONLY  
+ `true` が `expression` 型であり、そのサブタイプでない場合に限り、IS OF が `type` を返すことを指定します。  
+  
+ `type`  
+ `expression` を判定するための型。 型は名前空間で修飾する必要があります。  
+  
+## 戻り値  
+ `true` が型 T で、T が基本データ型または `expression` の派生型である場合は、`type` となります。`expression` が実行時に null である場合は null となり、それ以外の場合は `false` となります。  
+  
+## 解説  
+ `expression IS NOT OF (type)`  および  `expression IS NOT OF (ONLY type)`  式は、構文上はそれぞれ  `NOT (expression IS OF (type))`  および  `NOT (expression IS OF (ONLY type))` に相当します。  
+  
+ 次の表に、いくつかの通常およびコーナー パターンにおける `IS OF` 演算子の動作を示します。 すべての例外はクライアント側にスローされてから、プロバイダーが呼び出されます。  
+  
+|パターン|動作|  
+|----------|--------|  
+|null IS OF \(EntityType\)|スロー|  
+|null IS OF \(ComplexType\)|スロー|  
+|null IS OF \(RowType\)|スロー|  
+|TREAT \(null AS EntityType\) IS OF \(EntityType\)|DBNull を返します。|  
+|TREAT \(null AS ComplexType\) IS OF \(ComplexType\)|スロー|  
+|TREAT \(null AS RowType\) IS OF \(RowType\)|スロー|  
+|EntityType IS OF \(EntityType\)|true または false を返します。|  
+|ComplexType IS OF \(ComplexType\)|スロー|  
+|RowType IS OF \(RowType\)|スロー|  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、IS OF 演算子を使用してクエリ式の型を判定し、次に TREAT 演算子を使用して Course 型のオブジェクトを OnsiteCourse 型のオブジェクトのコレクションに変換します。 このクエリは、[School モデル](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac)に基づいています。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#TREAT_ISOF](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#treat_isof)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/key-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/key-entity-sql.md
new file mode 100644
index 00000000000..18e5a988f35
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/key-entity-sql.md
@@ -0,0 +1,56 @@
+---
+title: "KEY (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: cbaa97a8-c89c-4460-8c74-00474695789f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# KEY (Entity SQL)
+参照またはエンティティ式のキーを抽出します。  
+  
+## 構文  
+  
+```  
+  
+KEY(createref_expression)  
+```  
+  
+## 解説  
+ エンティティ キーには、指定されたエンティティまたはエンティティ参照の正しい順序でキー値が格納されます。 複数のエンティティ セットが同じ型に基づくことができるので、同じキーがそれぞれのエンティティ セットで使用される場合があります。 一意の参照を取得するには、`REF` を使用します。 KEY 演算子の戻り値の型は、同じ順序でエンティティの各キーの 1 つのフィールドを含む行型です。  
+  
+ 次の例では、キー演算子は、BadOrder エンティティへの参照に渡され、その参照のキー部分を返します。 この場合、`Id` プロパティに対応する 1 つだけのフィールドを持つレコード型です。  
+  
+```  
+select Key( CreateRef(LOB.BadOrders, row(o.Id)) )   
+from LOB.Orders as o  
+```  
+  
+## 使用例  
+ 次の Entity SQL クエリは、KEY 演算子を使用して、型参照を持つ式のキー部分を抽出します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#KEY](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#key)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md)   
+ [REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md)   
+ [DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md b/docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md
new file mode 100644
index 00000000000..01fded53f53
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md
@@ -0,0 +1,91 @@
+---
+title: "LINQ to Entities の既知の問題および注意点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: acd71129-5ff0-4b4e-b266-c72cc0c53601
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LINQ to Entities の既知の問題および注意点
+ここでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリの既知の問題について説明します。  
+  
+-   [キャッシュできない LINQ クエリ](#LINQQueriesThatAreNotCached)  
+  
+-   [失われた情報の収集の順序付け](#OrderingInfoLost)  
+  
+-   [サポートされていない符号なし整数](#UnsignedIntsUnsupported)  
+  
+-   [型変換エラー](#TypeConversionErrors)  
+  
+-   [非スカラー変数の参照はサポートされていません。](#RefNonScalarClosures)  
+  
+-   [入れ子になったクエリは、SQL Server 2000 では失敗する可能性があります。](#NestedQueriesSQL2000)  
+  
+-   [匿名型への投影](#ProjectToAnonymousType)  
+  
+<a name="LINQQueriesThatAreNotCached"></a>   
+## キャッシュできない LINQ クエリ  
+ .NET Framework 4.5 以降では、LINQ to Entities クエリは自動的にキャッシュされます。  ただし、メモリ内コレクションへ `Enumerable.Contains` 演算子を追加する LINQ to Entities クエリは自動的にキャッシュされません。  またコンパイル済み LINQ クエリのメモリ内コレクションをパラメーターで表すことは許可されていません。  
+  
+<a name="OrderingInfoLost"></a>   
+## 失われた情報の収集の順序付け  
+ 匿名型に列を投影すると、互換性レベルが "80" に設定された [!INCLUDE[ssVersion2005](../../../../../../includes/ssversion2005-md.md)] データベースに対して実行されるクエリの一部で順序付けが失われます。  この状況は、次の例に示すように、ORDER BY リストの列名がセレクターの列名と一致する場合に発生します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#SBUDT543840](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#sbudt543840)]
+ [!code-vb[DP L2E Conceptual Examples#SBUDT543840](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#sbudt543840)]  
+  
+<a name="UnsignedIntsUnsupported"></a>   
+## サポートされていない符号なし整数  
+ [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] によって符号なし整数がサポートされていないため、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでの符号なし整数型の指定はサポートされていません。次の例に示すように、符号なし整数を指定すると、クエリ式の変換時に <xref:System.ArgumentException> 例外がスローされます。  この例では、ID 48000 を持つ注文に対してクエリを実行します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#UIntAsQueryParam](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#uintasqueryparam)]
+ [!code-vb[DP L2E Conceptual Examples#UIntAsQueryParam](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#uintasqueryparam)]  
+  
+<a name="TypeConversionErrors"></a>   
+## 型変換エラー  
+ Visual Basic では、`CByte` 関数を使用して 1 の値を持つ SQL Server の bit 型の列にプロパティがマップされると、"算術オーバーフロー エラー" というメッセージと共に <xref:System.Data.SqlClient.SqlException> がスローされます。  次の例では、AdventureWorks サンプル データベースの `Product.MakeFlag` 列をクエリし、クエリ結果が反復処理されると、例外がスローされます。  
+  
+ [!code-vb[DP L2E Conceptual Examples#SBUDT544355](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#sbudt544355)]  
+  
+<a name="RefNonScalarClosures"></a>   
+## 非スカラー変数の参照はサポートされていません。  
+ クエリでの非スカラー変数 \(エンティティなど\) の参照はサポートされていません。  そのようなクエリを実行すると、<xref:System.NotSupportedException> 例外がスローされ、"型 `EntityType` の定数値を作成できません。  このコンテキストでサポートされるのはプリミティブ型 \('Int32、String、Guid など'\) だけです" というメッセージが表示されます。  
+  
+> [!NOTE]
+>  スカラー変数のコレクションの参照はサポートされています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#SBUDT555877](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#sbudt555877)]
+ [!code-vb[DP L2E Conceptual Examples#SBUDT555877](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#sbudt555877)]  
+  
+<a name="NestedQueriesSQL2000"></a>   
+## 入れ子になったクエリは、SQL Server 2000 では失敗する可能性があります。  
+ SQL Server 2000 では、LINQ to Entities クエリは、3 ～ 4 レベルの深さの入れ子になった Transact\-SQL クエリを生成する場合に失敗する可能性があります。  
+  
+<a name="ProjectToAnonymousType"></a>   
+## 匿名型への投影  
+ <xref:System.Data.Objects.ObjectQuery%601> に <xref:System.Data.Objects.ObjectQuery%601.Include%2A> メソッドを使用して、関連オブジェクトを含めるように最初のクエリ パスを定義してから LINQ を使用して、返されたオブジェクトを匿名の型に投影した場合、include メソッドで指定されたオブジェクトはクエリ結果に含まれません。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#ProjToAnonType1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#projtoanontype1)]
+ [!code-vb[DP L2E Conceptual Examples#ProjToAnonType1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#projtoanontype1)]  
+  
+ 関連オブジェクトを取得するには、返された型を匿名の型に投影しないでください。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#ProjToAnonType2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#projtoanontype2)]
+ [!code-vb[DP L2E Conceptual Examples#ProjToAnonType2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#projtoanontype2)]  
+  
+## 参照  
+ [LINQ to Entities](../../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/less-than-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/less-than-entity-sql.md
new file mode 100644
index 00000000000..c21dce72503
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/less-than-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "&lt; (より小さい) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 1fc2a039-3ad6-4b3c-b41d-09932e803f86
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# &lt; (より小さい) (Entity SQL)
+2 つの式を比較して、左の式の値が右の式の値よりも小さいかどうかを判別します。  
+  
+## 構文  
+  
+```  
+  
+expression  
+<  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式の値が右の式の値よりも小さい場合は `true`、そうでない場合は `false`。  
+  
+## 使用例  
+ 次の Entity SQL クエリは、「\<」比較演算子を使用して 2 つの式を比較し、左の式の値が右の式の値よりも小さいかどうかを判別します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#LESS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#less)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/less-than-or-equal-to-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/less-than-or-equal-to-entity-sql.md
new file mode 100644
index 00000000000..aec66c80fab
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/less-than-or-equal-to-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;= (以下) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 7c46da5c-fa09-4d90-adcc-c7e1b769d8e6
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# &lt;= (以下) (Entity SQL)
+2 つの式を比較して、左の式の値が右の式の値以下であるかどうかを判別します。  
+  
+## 構文  
+  
+```  
+  
+expression  
+<=  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式の値が右の式の値以下である場合は `true`、そうでない場合は `false`。  
+  
+## 使用例  
+ 次の Entity SQL クエリは「\<\=」比較演算子を使用して 2 つの式を比較し、左の式の値が右の式の値以下であるかどうかを判別します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#LESS_OR_EQUALS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#less_or_equals)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/like-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/like-entity-sql.md
new file mode 100644
index 00000000000..3c954924d47
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/like-entity-sql.md
@@ -0,0 +1,90 @@
+---
+title: "LIKE (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8300e6d2-875b-481e-9ef4-e1e7c12d46fa
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LIKE (Entity SQL)
+指定された文字列 `String` が指定されたパターンと一致するかどうかを判断します。  
+  
+## 構文  
+  
+```  
+  
+match [NOT] LIKE pattern [ESCAPE escape]  
+```  
+  
+## 引数  
+ `match`  
+ 結果が [!INCLUDE[esql](../../../../../../includes/esql-md.md)] になる `String` 式。  
+  
+ `pattern`  
+ 指定された `String` に一致するパターン。  
+  
+ `escape`  
+ エスケープ文字。  
+  
+ NOT  
+ LIKE の結果を否定することを指定します。  
+  
+## 戻り値  
+ `true` がパターンに一致する場合は `string`、一致しない場合は `false`。  
+  
+## 解説  
+ LIKE 演算子を使用する [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 式は、フィルター条件として等価性を使用する式と同様に評価されます。 ただし、LIKE 演算子を使用する [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 式には、リテラル文字とワイルドカード文字の両方を含めることができます。  
+  
+ 次の表では、パターン `string` の構文について説明します。  
+  
+|ワイルドカード文字|説明|例|  
+|---------------|--------|-------|  
+|%|0 個またはそれ以上の文字で構成される任意の `string` です。|`title like '%computer%'`  と指定すると、タイトルに  `"computer"`  という単語が含まれるすべてのタイトルが検索されます。|  
+|\_ \(アンダースコア\)|任意の 1 文字です。|`firstname like '_ean'`  と指定すると、 `"ean`" で終わる 4 文字のすべてのファースト ネーム \(Dean や Sean など\) が検索されます。|  
+|\[ \]|指定した範囲 \(\[a\-f\]\) またはセット \(\[abcdef\]\) にある任意の 1 文字です。|`lastname like '[C-P]arsen'`  と指定すると、Carsen や Larsen などのように、C ～ P の任意の 1 文字で始まり、"arsen" で終わる姓が検索されます。|  
+|\[^\]|指定した範囲 \(\[^a\-f\]\) またはセット \(\[^abcdef\]\) にない任意の 1 文字です。|`lastname like 'de[^l]%'`  と指定すると、"de" で始まり、次の文字が "l" でないすべての姓が検索されます。|  
+  
+> [!NOTE]
+>  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の LIKE 演算子および ESCAPE 句は、`System.DateTime` または `System.Guid` 値には適用できません。  
+  
+ LIKE では、ASCII パターン マッチと Unicode パターン マッチがサポートされています。 すべてのパラメーターが ASCII 文字の場合は、ASCII パターン マッチが行われます。 1 つまたは複数の引数が Unicode の場合は、すべての引数が Unicode に変換され、Unicode パターン マッチが行われます。 LIKE で Unicode を使用する場合、後続する空白は意味を持ちます。しかし、Unicode 以外のデータの場合、後続する空白は意味を持ちません。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のパターン文字列構文は、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] のパターン文字列構文と同じです。  
+  
+ パターンは、標準の文字とワイルドカード文字を含むことができます。 パターン マッチ時に、標準の文字は `string` に指定された文字と正確に一致する必要があります。 しかし、ワイルドカード文字は文字列の任意の部分と一致することができます。 ワイルドカード文字を使用する場合、LIKE 演算子は \= や \!\= などの文字列比較演算子よりも柔軟です。  
+  
+> [!NOTE]
+>  特定のプロバイダーを対象とする場合は、プロバイダー固有の拡張機能を使用できます。 ただし、たとえばコンストラクターの扱いは、プロバイダーによって異なる場合があります。 SqlServer では、\[first\-last\] および \[^first\-last\] のパターンがサポートされています。前者は先頭と末尾の間の 1 文字が完全に一致し、後者は先頭と末尾の間以外の 1 文字が完全に一致します。  
+  
+### エスケープ特殊文字  
+ 前のセクションの表で説明しているように、ESCAPE 句を使用することで、1 文字以上の特殊なワイルドカード文字を含む文字列を検索できます。 たとえば、複数のドキュメントのタイトルにリテラル "100%" が含まれており、そのドキュメントすべてを検索するとします。 パーセント \(%\) 文字はワイルドカード文字であるため、検索を正常に実行するには [!INCLUDE[esql](../../../../../../includes/esql-md.md)] ESCAPE 句を使用してエスケープする必要があります。 このフィルターの例は次のとおりです。  
+  
+```  
+"title like '%100!%%' escape '!'"  
+```  
+  
+ この検索式では、感嘆符文字 \(\!\) の直後のパーセント ワイルドカード文字 \(%\) は、ワイルドカード文字としてではなく、リテラルとして処理されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] ワイルドカード文字および角かっこ \(`[ ]`\) 文字を除き、任意の文字をエスケープ文字として使用できます。 前の例では、感嘆符 \(\!\) 文字はエスケープ文字です。  
+  
+## 使用例  
+ 次の 2 つの [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、LIKE および ESCAPE 演算子を使用して、指定された文字列が指定されたパターンと一致するかどうかを判断します。 最初のクエリは、文字列 `Name` で始まる `Down_` を検索します。 アンダースコア \(`_`\) はワイルドカード文字であるため、このクエリは ESCAPE オプションを使用します。 ESCAPE オプションを指定しないと、単語 `Name` の後にアンダースコア文字以外の 1 文字で始まる `Down` 値もクエリで検索してしまいます。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#LIKE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#like)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md
new file mode 100644
index 00000000000..5884b4df78c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md
@@ -0,0 +1,55 @@
+---
+title: "LIMIT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c22ffede-0a52-44d1-99b9-4a91e651e1b9
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LIMIT (Entity SQL)
+物理的なページングは、ORDER BY 句の LIMIT サブ句を使用して実行できます。 LIMIT は ORDER BY 句と切り離して使用することはできません。  
+  
+## 構文  
+  
+```  
+  
+[ LIMIT n ]  
+```  
+  
+## 引数  
+ `n`  
+ 選択する項目の数。  
+  
+ LIMIT 式のサブ句が ORDER BY 句に存在する場合、クエリは並べ替え順序に従って並べ替えられ、結果の行数は LIMIT 式によって制限されます。 たとえば、LIMIT 5 は、結果セットを 5 つのインスタンスまたは行に制限します。 LIMIT は機能的に TOP と等価ですが、LIMIT では ORDER BY 句が存在する必要がある点が異なります。 SKIP および LIMIT は ORDER BY 句と共に別々に使用できます。  
+  
+> [!NOTE]
+>  TOP 修飾子と SKIP サブ句が同じクエリ式内に存在する場合には、Entity Sql クエリは無効と見なされます。 TOP 式を LIMIT 式に変更してクエリを記述し直す必要があります。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、SELECT ステートメントで返されたオブジェクトの並べ替え順序の指定に ORDER BY 演算子を LIMIT と共に使用します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#LIMIT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#limit)]  
+  
+## 参照  
+ [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md)   
+ [クエリの結果をページングする方法](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)   
+ [ページング](../../../../../../docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md)   
+ [TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/linq-to-entities.md b/docs/framework/data/adonet/ef/language-reference/linq-to-entities.md
new file mode 100644
index 00000000000..0e4958dc2fd
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/linq-to-entities.md
@@ -0,0 +1,106 @@
+---
+title: "LINQ to Entities | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 641f9b68-9046-47a1-abb0-1c8eaeda0e2d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# LINQ to Entities
+LINQ to Entities は、開発者が Visual Basic または Visual C\# を使用して Entity Framework 概念モデルに対するクエリを作成するための統合言語クエリ \(LINQ\) のサポートを提供します。  Entity Framework に対するクエリで代表的なものが、コマンド ツリー クエリです。これはオブジェクト コンテキストに対して実行されます。  LINQ to Entities では、統合言語クエリ \(LINQ\) クエリをコマンド ツリー クエリに変換し、そのクエリを Entity Framework に対して実行します。返されたオブジェクトは、Entity Framework でも LINQ でも使用できます。  次に、LINQ to Entities クエリを作成して実行する手順を示します。  
+  
+1.  <xref:System.Data.Objects.ObjectContext> から <xref:System.Data.Objects.ObjectQuery%601> インスタンスを作成します。  
+  
+2.  <xref:System.Data.Objects.ObjectQuery%601> インスタンスを使用して、C\# または Visual Basic で LINQ to Entities クエリを作成します。  
+  
+3.  LINQ 標準クエリ演算子および標準クエリ式をコマンド ツリーに変換します。  
+  
+4.  コマンド ツリーで表されたクエリをデータ ソースに対して実行します。  実行中にデータ ソースに対してスローされた例外は、クライアントに直接渡されます。  
+  
+5.  クエリの結果をクライアントに返します。  
+  
+## ObjectQuery インスタンスの構築  
+ <xref:System.Data.Objects.ObjectQuery%601> ジェネリック クラスは、0 個以上の型指定されたエンティティのコレクションを返すクエリを表します。  通常、オブジェクト クエリは手作業で構築されるのではなく、既存のオブジェクト コンテキストから構築され、常にそのオブジェクト コンテキストに属しています。  このコンテキストにより、クエリの作成と実行に必要な接続情報とメタデータ情報が取得されます。  <xref:System.Data.Objects.ObjectQuery%601> ジェネリック クラスでは、<xref:System.Linq.IQueryable%601> ジェネリック インターフェイスが実装されます。このインターフェイスのビルダー メソッドにより、LINQ クエリを段階的に構築できます。  C\# `var` キーワード \(Visual Basic の場合は `Dim`、ローカル型推論を有効にする\) を使用することで、コンパイラでエンティティの型を推論することもできます。  
+  
+## クエリの作成  
+ <xref:System.Linq.IQueryable%601> ジェネリック インターフェイスを実装する <xref:System.Data.Objects.ObjectQuery%601> ジェネリック クラスのインスタンスは、LINQ to Entities クエリのデータ ソースとして動作します。  クエリでは、データ ソースから取得する情報を正確に指定できます。  また、並べ替え、グループ化、整形方法を指定して情報を取得することもできます。  LINQ では、クエリが変数に格納されます。  このクエリ変数は、クエリの情報を保存するだけで、なんらかのアクションを実行したり、データを返したりすることはありません。  クエリを作成した後、データを取得するには、そのクエリを実行する必要があります。  
+  
+ LINQ to Entities クエリは、クエリ式の構文とメソッド ベースのクエリ構文という 2 とおりの構文を使って作成できます。  クエリ式の構文とメソッド ベースのクエリ構文は、C\# 3.0 と Visual Basic 9.0 で新たに導入された機能です。  
+  
+ 詳細については、「[LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)」を参照してください。  
+  
+## クエリの変換  
+ LINQ to Entities クエリを Entity Framework に対して実行するには、LINQ クエリを Entity Framework に対して実行できるコマンド ツリー表現に変換する必要があります。  
+  
+ LINQ to Entities クエリは、LINQ 標準クエリ演算子 \(<xref:System.Linq.Queryable.Select%2A>、<xref:System.Linq.Queryable.Where%2A>、<xref:System.Linq.Queryable.GroupBy%2A> など\) と式 \(x \> 10 や Contact.LastName など\) で構成されます。  LINQ 演算子はクラスで定義されるものではなく、クラスのメソッドです。  LINQ の式には、<xref:System.Linq.Expressions> 名前空間の型で許容される要素だけでなく、ラムダ関数で表される要素であれば何でも使用できます。  これは Entity Framework で許容される式のスーパーセットです。定義により、このような式はデータベースで許容され、<xref:System.Data.Objects.ObjectQuery%601> でサポートされる操作に限定されています。  
+  
+ Entity Framework では、演算子と式は 1 つの型の階層で表された後、コマンド ツリーに配置されます。  このコマンド ツリーが、Entity Framework でのクエリの実行に使用されます。  LINQ クエリをコマンド ツリーとして表現できない場合、クエリの変換中に例外がスローされます。  LINQ to Entities クエリを変換する際には、標準クエリ演算子の変換と式の変換という 2 つの変換が実行されます。  
+  
+ LINQ to Entities で正しく変換されない LINQ 標準クエリ演算子は多数あります。  このような演算子を使用すると、クエリの変換時に例外が発生します。  サポートされる LINQ to Entities クエリの一覧については、「[サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md)」を参照してください。  
+  
+ LINQ to Entities の標準クエリ演算子の使用方法の詳細については、「[LINQ to Entities クエリの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)」を参照してください。  
+  
+ 一般的に、LINQ to Entities の式はサーバー上で評価されるため、式の動作が CLR セマンティクスに従っているとは限りません。  詳細については、「[LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)」を参照してください。  
+  
+ CLR メソッドの呼び出しがデータ ソースの正規関数にどのようにマップされるかについては、「[CLR メソッドと正規関数とのマッピング](../../../../../../docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md)」を参照してください。  
+  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリから正規関数、データベース関数、およびカスタム関数を呼び出す方法については、「[LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)」を参照してください。  
+  
+## クエリの実行  
+ ユーザーが LINQ クエリを作成すると、Entity Framework と互換性のある表現 \(コマンド ツリーの形\) に変換された後、データ ソースに対して実行されます。  クエリの実行時に、すべてのクエリ式 \(またはクエリの構成要素\) がクライアントまたはサーバー上で評価されます。  これには、結果の具体化やエンティティの投影で使用される式も含まれます。  詳細については、「[クエリの実行](../../../../../../docs/framework/data/adonet/ef/language-reference/query-execution.md)」を参照してください。  クエリを 1 回コンパイルしてから、異なるパラメーターを使用して数回実行することでパフォーマンスを向上させる方法については、「[コンパイル済みクエリ \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md)」を参照してください。  
+  
+## 具体化  
+ 具体化は、クエリの結果を CLR 型としてクライアントに返すプロセスです。  LINQ to Entities では、クエリの結果のデータ レコードは決して返されません。常に返されるのは、ユーザーまたは Entity Framework で定義された CLR 型、またはコンパイラによって生成される CLR 型 \(匿名型\) です。  オブジェクトの具体化は、すべて Entity Framework によって実行されます。  Entity Framework と CLR とのマッピングができないことが原因でエラーが発生すると、オブジェクトの具体化中に例外がスローされます。  
+  
+ 通常、クエリの結果は次のいずれかの形で返されます。  
+  
+-   0 個以上の型指定されたエンティティ オブジェクトのコレクション、または概念モデルで定義されている複合型のプロジェクション。  
+  
+-   [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] でサポートされる CLR 型。  
+  
+-   インライン コレクション。  
+  
+-   匿名型。  
+  
+ 詳細については、「[クエリ結果](../../../../../../docs/framework/data/adonet/ef/language-reference/query-results.md)」を参照してください。  
+  
+## このセクションの内容  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)  
+  
+ [LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)  
+  
+ [LINQ to Entities クエリ内の関数の呼び出し](../../../../../../docs/framework/data/adonet/ef/language-reference/calling-functions-in-linq-to-entities-queries.md)  
+  
+ [コンパイル済みクエリ \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md)  
+  
+ [クエリの実行](../../../../../../docs/framework/data/adonet/ef/language-reference/query-execution.md)  
+  
+ [クエリ結果](../../../../../../docs/framework/data/adonet/ef/language-reference/query-results.md)  
+  
+ [LINQ to Entities クエリの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)  
+  
+ [CLR メソッドと正規関数とのマッピング](../../../../../../docs/framework/data/adonet/ef/language-reference/clr-method-to-canonical-function-mapping.md)  
+  
+ [サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md)  
+  
+ [LINQ to Entities の既知の問題および注意点](../../../../../../docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md)  
+  
+## 参照  
+ [LINQ to Entities の既知の問題および注意点](../../../../../../docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)   
+ [LINQ と ADO.NET](../../../../../../docs/framework/data/adonet/linq-and-ado-net.md)   
+ [ADO.NET Entity Framework](../../../../../../docs/framework/data/adonet/ef/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/literals-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/literals-entity-sql.md
new file mode 100644
index 00000000000..e2875556638
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/literals-entity-sql.md
@@ -0,0 +1,116 @@
+---
+title: "リテラル (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 092ef693-6e5f-41b4-b868-5b9e82928abf
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# リテラル (Entity SQL)
+このトピックでは、リテラルに関する [!INCLUDE[esql](../../../../../../includes/esql-md.md)] のサポートについて説明します。  
+  
+## Null  
+ NULL リテラルは、あらゆる型で NULL 値を表す際に使用されます。  NULL リテラルは、すべての型と互換性があります。  
+  
+ NULL リテラルをキャストすることによって、型指定された NULL を作成できます。  詳細については、「[CAST](../../../../../../docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md)」を参照してください。  
+  
+ どのような場合に型指定されない NULL リテラルを使用できるかの規則については、「[NULL リテラルと型推論](../../../../../../docs/framework/data/adonet/ef/language-reference/null-literals-and-type-inference-entity-sql.md)」を参照してください。  
+  
+## Boolean  
+ ブール型リテラルは、`true` と `false` のキーワードで表されます。  
+  
+## 整数  
+ 整数リテラルには、<xref:System.Int32> 型と <xref:System.Int64> 型とがあります。  <xref:System.Int32> リテラルは、一連の数字で構成されます。  <xref:System.Int64> リテラルは、一連の数字で構成され、最後に大文字の L が付きます。  
+  
+## Decimal \(10 進数型\)  
+ 固定小数点数 \(decimal\) は、一連の数字、ドット \(.\)、および別の一連の数字で構成され、最後に大文字の "M" が付きます。  
+  
+## Float、Double  
+ 倍精度浮動小数点数は、一連の数字、ドット \(.\)、および別の一連の数字で構成され、場合によっては最後に指数が付きます。  単精度浮動小数点数 \(float\) は、倍精度浮動小数点数の構文に続けて小文字の f が付きます。  
+  
+## String  
+ 文字列は、引用符で囲まれた一連の文字です。  引用符には、単一引用符 \(`'`\) または二重引用符 \("\) を使用できますが、両者を混在させることはできません。  文字列リテラルには、Unicode と非 Unicode のどちらでも使用できます。  文字列リテラルを Unicode として宣言するには、リテラルの前に大文字の "N" を付けます。  既定では、Unicode でない文字列リテラルです。  N と文字列リテラルの間に空白は含めません。また、N は大文字にする必要があります。  
+  
+```  
+'hello' -- non-Unicode character string literal  
+N'hello' -- Unicode character string literal  
+"x"  
+N"This is a string!"  
+'so is THIS'  
+```  
+  
+## DateTime  
+ datetime リテラルは、日付部分と時刻部分とで構成され、ロケールに依存しません。  日付部分と時刻部分のどちらも省略することはできず、既定値はありません。  
+  
+ 日付部分は、`YYYY`\-`MM`\-`DD` という形式になっている必要があります。`YYYY` は 0001 ～ 9999 の 4 桁の年を、`MM` は 1 ～ 12 の月を表します。また、`DD` は、指定した月 \(`MM`\) の有効な日を表します。  
+  
+ 時刻部分は `HH`:`MM`\[:`SS`\[.fffffff\]\] の形式にする必要があります。ここで、`HH` は 0 ～ 23 時の値、`MM` は 0 ～ 59 分の値、`SS` は 0 ～ 59 秒の値、fffffff は 0 ～ 9999999 の 1 秒未満部分の値を表します。  いずれも両端の値を含みます。  1 秒未満部分は省略可能です。  1 秒未満部分を指定しなければ、秒は省略可能です。1 秒未満部分を指定する場合、秒は必須です。  秒も 1 秒未満部分も指定しない場合は、既定値の 0 が使用されます。  
+  
+ DATETIME 記号とリテラル ペイロード間の空白の数に制限はありませんが、改行はできません。  
+  
+```  
+DATETIME'2006-10-1 23:11'  
+DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'  
+```  
+  
+## 時刻  
+ time リテラルは、時刻部分のみで構成され、ロケールに依存しません。  時刻部分は必須で、既定値はありません。  時刻部分は HH:MM\[:SS\[.fffffff\]\] の形式にする必要があります。ここで、HH は 0 ～ 23 時の値、MM は 0 ～ 59 分の値、SS は 0 ～ 59 秒の値、fffffff は 0 ～ 9999999 の 1 秒未満部分の値を表します。  いずれも両端の値を含みます。  1 秒未満部分は省略可能です。  1 秒未満部分を指定しなければ、秒は省略可能です。1 秒未満部分を指定する場合、秒は必須です。  秒も 1 秒未満部分も指定しない場合は、既定値の 0 が使用されます。  
+  
+ TIME 記号とリテラル ペイロード間の空白の数に制限はありませんが、改行はできません。  
+  
+```  
+TIME‘23:11’  
+TIME‘01:01:00.1234567’  
+```  
+  
+## DateTimeOffset  
+ datetimeoffset リテラルは、日付部分、時刻部分、およびオフセット部分で構成され、ロケールに依存しません。  日付部分、時刻部分、オフセット部分はすべて必須で、既定値はありません。  日付部分は YYYY\-MM\-DD の形式にする必要があります。ここで、YYYY は 0001 ～ 9999 の 4 桁の年、MM は 1 ～ 12 の月、DD は特定の月の有効な日付を表します。  時刻部分は HH:MM\[:SS\[.fffffff\]\] の形式にする必要があります。ここで、HH は 0 ～ 23 時の値、MM は 0 ～ 59 分の値、SS は 0 ～ 59 秒の値、fffffff は 0 ～ 9999999 の 1 秒未満部分の値を表します。  いずれも両端の値を含みます。  1 秒未満部分は省略可能です。  1 秒未満部分を指定しなければ、秒は省略可能です。1 秒未満部分を指定する場合、秒は必須です。  秒も 1 秒未満部分も指定しない場合は、既定値の 0 が使用されます。  オフセット部分は {\+&#124;\-}HH:MM の形式にする必要があります。ここで、HH と MM は時刻部分と同じ意味ですが、  オフセットの範囲は \-14:00 ～ \+ 14:00 でなければなりません。  
+  
+ DATETIMEOFFSET 記号とリテラル ペイロード間の空白の数に制限はありませんが、改行はできません。  
+  
+```  
+DATETIMEOFFSET‘2006-10-1 23:11 +02:00’  
+DATETIMEOFFSET‘2006-12-25 01:01:00.0000000 -08:30’  
+```  
+  
+> [!NOTE]
+>  有効な Entity SQL リテラル値は、CLR またはデータ ソースに対してサポートされている範囲に含まれないことがあります。  その結果、例外が発生する可能性があります。  
+  
+## 2 項  
+ バイナリ文字列リテラルは、binary キーワードあるいは簡略記号 `X` または `x` と、それに続く単一引用符で囲まれた一連の 16 進数字で構成されます。  簡略記号 `X` は、大文字と小文字は区別されません。  キーワード `binary` と、バイナリ文字列値との間には、0 個以上の空白文字が許容されます。  
+  
+ 16 進文字についても、大文字と小文字は区別されません。  リテラルが奇数個の 16 進数字で構成されていた場合、桁数が次に大きな偶数個となるように、先頭に 16 進数の 0 を付けることによって調整されます。  バイナリ文字列にサイズの制限はありません。  
+  
+```  
+Binary'00ffaabb'  
+X'ABCabc'  
+BINARY    '0f0f0f0F0F0F0F0F0F0F'  
+X'' –- empty binary string  
+```  
+  
+## Guid  
+ `GUID` リテラルは、グローバル一意識別子を表します。  キーワード `GUID` の後に、単一引用符で囲まれた 8\-4\-4\-4\-12 形式 \(*レジストリ*形式\) の 16 進数字が続きます。  16 進数字の大文字と小文字は区別されません。  
+  
+ GUID 記号とリテラル ペイロード間の空白の数に制限はありませんが、改行はできません。  
+  
+```  
+Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'  
+GUID  '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'  
+```  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md
new file mode 100644
index 00000000000..0d7555ed1bc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/math-canonical-functions.md
@@ -0,0 +1,45 @@
+---
+title: "数学正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 6f6cddc6-b561-4ebe-84b6-841ef5b4113b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 数学正規関数
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には数学正規関数が含まれます。  
+  
+ 次の表に、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] 数学正規関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`Abs(` `value` `)`|`value` の絶対値を返します。<br /><br /> **引数**<br /><br /> `Int16`、`Int32`、`Int64`、`Byte`、`Single`、`Double`、および `Decimal`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> `Abs(-2)`|  
+|`Ceiling(` `value` `)`|`value` 以上で最小の整数値を返します。<br /><br /> **引数**<br /><br /> `Single`、`Double`、および `Decimal`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_CEILING](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_ceiling)]
+ [!code-sql[DP EntityServices Concepts#EDM_CEILING](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_ceiling)]|  
+|`Floor(` `value` `)`|`value` 以下で最大の整数値を返します。<br /><br /> **引数**<br /><br /> `Single`、`Double`、および `Decimal`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#EDM_FLOOR](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#edm_floor)]
+ [!code-sql[DP EntityServices Concepts#EDM_FLOOR](../../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#edm_floor)]|  
+|`Power(` `value`, `exponent``)`|指定された `value` を指定された `exponent` でべき乗した結果を返します。<br /><br /> **引数**<br /><br /> `value`:  `Int32, Int64, Double`、または `Decimal`。<br /><br /> `exponent`: `Int64``, Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> `Power(748.58,2)`|  
+|`Round(` `value` `)`|最も近い整数に丸められた `value` の整数部分を返します。<br /><br /> **引数**<br /><br /> `Single`、`Double`、および `Decimal`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> `Round(748.58)`|  
+|`Round(` `value`, `digits``)`|`value` を指定された最も近い `digits` に丸めて返します。<br /><br /> **引数**<br /><br /> `value`: `Double` または `Decimal`。<br /><br /> `digits`: `Int16` または `Int32`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> `Round(748.58,1)`|  
+|`Truncate(` `value`, `digits``)`|`value` を指定された最も近い `digits` に切り詰めて返します。<br /><br /> **引数**<br /><br /> `value`: `Double` または `Decimal`。<br /><br /> `digits`: `Int16` または `Int32`。<br /><br /> **戻り値**<br /><br /> `value` の型。<br /><br /> **例**<br /><br /> `Truncate(748.58,1)`|  
+  
+ `null` が入力された場合、これらの関数は `null` を返します。  
+  
+ 同等の機能は、Microsoft SQL クライアント マネージ プロバイダーでも利用できます。  詳細については、「[Entity Framework 用 SqlClient 関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/member-access-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/member-access-entity-sql.md
new file mode 100644
index 00000000000..f75d8228339
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/member-access-entity-sql.md
@@ -0,0 +1,45 @@
+---
+title: ". (メンバー アクセス) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 4733e3b2-3efa-4b96-b591-ac31350e96ad
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# . (メンバー アクセス) (Entity SQL)
+ドット演算子 \(.\) は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] メンバー アクセス演算子です。  メンバー アクセス演算子を使用すると、構造型概念モデル型のインスタンスのプロパティ値またはフィールド値を生成できます。  
+  
+## 構文  
+  
+```  
+expression.identifier  
+```  
+  
+## 引数  
+ `expression`  
+ 構造型概念モデル型のインスタンス。  
+  
+ `identifier`  
+ オブジェクト インスタンスに属するプロパティまたはフィールド。  
+  
+## 解説  
+ ドット \(.\) 演算子は、複合型またはエンティティ型のプロパティの抽出と同様に、レコードからフィールドを抽出するために使用できます。  たとえば、Name 型の n が Person 型のメンバーであり、p が Person 型のインスタンスである場合、  p.n は有効なメンバー アクセス式として Name 型の値を生成します。  
+  
+ `select p.Name.FirstName from LOB.Person as p`  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-aggregate-operators.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-aggregate-operators.md
new file mode 100644
index 00000000000..8ab2ae186a3
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-aggregate-operators.md
@@ -0,0 +1,146 @@
+---
+title: "メソッド ベースのクエリ構文例 : 集計演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 0e306067-5720-4782-9719-2286570a7e47
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 集計演算子
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.Aggregate%2A>、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.LongCount%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、<xref:System.Linq.Enumerable.Sum%2A> の各メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Average  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP L2E Examples#Average_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#average_mq)]
+ [!code-vb[DP L2E Examples#Average_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#average_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、各スタイルの製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP L2E Examples#Average2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#average2_mq)]
+ [!code-vb[DP L2E Examples#Average2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#average2_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、平均合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#AverageProjection_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#averageprojection_mq)]
+ [!code-vb[DP L2E Examples#AverageProjection_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#averageprojection_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、それぞれの連絡先 ID について平均合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#AverageGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#averagegrouped_mq)]
+ [!code-vb[DP L2E Examples#AverageGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#averagegrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、それぞれの連絡先について合計支払額が平均値の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#AverageElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#averageelements_mq)]
+ [!code-vb[DP L2E Examples#AverageElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#averageelements_mq)]  
+  
+## Count  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用して、Product テーブル内の製品の数を返します。  
+  
+ [!code-csharp[DP L2E Examples#Count](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#count)]
+ [!code-vb[DP L2E Examples#Count](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#count)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用して、連絡先 ID の一覧と、それぞれの注文数を返します。  
+  
+ [!code-csharp[DP L2E Examples#CountNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#countnested)]
+ [!code-vb[DP L2E Examples#CountNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#countnested)]  
+  
+### 例  
+ 次の例では、製品を色でグループ分けし、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用してそれぞれの色グループに含まれる製品の数を返します。  
+  
+ [!code-csharp[DP L2E Examples#CountGrouped](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#countgrouped)]
+ [!code-vb[DP L2E Examples#CountGrouped](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#countgrouped)]  
+  
+## LongCount  
+  
+### 例  
+ 次の例では、連絡先の数を長整数として取得します。  
+  
+ [!code-csharp[DP L2E Examples#LongCountSimple](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#longcountsimple)]
+ [!code-vb[DP L2E Examples#LongCountSimple](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#longcountsimple)]  
+  
+## 最大  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、最大合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MaxProjection_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#maxprojection_mq)]
+ [!code-vb[DP L2E Examples#MaxProjection_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#maxprojection_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について最大合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MaxGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#maxgrouped_mq)]
+ [!code-vb[DP L2E Examples#MaxGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#maxgrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額が最大の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MaxElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#maxelements_mq)]
+ [!code-vb[DP L2E Examples#MaxElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#maxelements_mq)]  
+  
+## 最小  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、最小合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MinProjection_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#minprojection_mq)]
+ [!code-vb[DP L2E Examples#MinProjection_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#minprojection_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先 ID について最小合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MinGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#mingrouped_mq)]
+ [!code-vb[DP L2E Examples#MinGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#mingrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先について合計支払額が最小の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MinElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#minelements_mq)]
+ [!code-vb[DP L2E Examples#MinElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#minelements_mq)]  
+  
+## Sum  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、SalesOrderDetail テーブル内の注文数量の合計を取得します。  
+  
+ [!code-csharp[DP L2E Examples#SumProjection_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#sumprojection_mq)]
+ [!code-vb[DP L2E Examples#SumProjection_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#sumprojection_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#SumGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#sumgrouped_mq)]
+ [!code-vb[DP L2E Examples#SumGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#sumgrouped_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-conversion.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-conversion.md
new file mode 100644
index 00000000000..6360b8222b1
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-conversion.md
@@ -0,0 +1,56 @@
+---
+title: "メソッド ベースのクエリ構文例 : 変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 19f66872-d5ab-49f8-969f-e53f9632a13d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 変換
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.ToArray%2A>、<xref:System.Linq.Enumerable.ToDictionary%2A>、<xref:System.Linq.Enumerable.ToList%2A> の各メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## ToArray  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.ToArray%2A> メソッドを使用して、シーケンスを配列として即時評価します。  
+  
+ [!code-csharp[DP L2E Examples#ToArray](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#toarray)]
+ [!code-vb[DP L2E Examples#ToArray](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#toarray)]  
+  
+## ToDictionary  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.ToDictionary%2A> メソッドを使用して、シーケンスおよび関連するキー式をディクショナリとして即時評価します。  
+  
+ [!code-csharp[DP L2E Examples#ToDictionary](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#todictionary)]
+ [!code-vb[DP L2E Examples#ToDictionary](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#todictionary)]  
+  
+## ToList  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.ToList%2A> メソッドを使用して、シーケンスを <xref:System.Collections.Generic.List%601> として即時評価します。ここで、`T` は <xref:System.Data.DataRow> 型を表します。  
+  
+ [!code-csharp[DP L2E Examples#ToList](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#tolist)]
+ [!code-vb[DP L2E Examples#ToList](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#tolist)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-element-operators.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-element-operators.md
new file mode 100644
index 00000000000..9dd43565d26
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-element-operators.md
@@ -0,0 +1,40 @@
+---
+title: "メソッド ベースのクエリ構文例 : 要素演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8438b995-bd07-4223-b22d-13adadef33fb
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 要素演算子
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## First  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、'caroline' で始まる最初の電子メール アドレスを検索します。  
+  
+ [!code-csharp[DP L2E Examples#FirstCondition_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#firstcondition_mq)]
+ [!code-vb[DP L2E Examples#FirstCondition_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#firstcondition_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-filtering.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-filtering.md
new file mode 100644
index 00000000000..1ccd27fd783
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-filtering.md
@@ -0,0 +1,77 @@
+---
+title: "メソッドベースのクエリ構文例: フィルター処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: e40e314c-eb30-4f44-a054-41e511e35832
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッドベースのクエリ構文例: フィルター処理
+このトピックでは、メソッド ベースのクエリ構文で、`Where` メソッドと `Where…Contains` メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  `Where Contains` は[コンパイル済みクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md)の中では使用できないことに注意してください。  
+  
+ これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Where  
+  
+### 例  
+ 次の例では、すべてのオンライン注文が返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where1_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where1_mq)]
+ [!code-vb[DP L2E Examples#Where1_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where1_mq)]  
+  
+### 例  
+ 次の例では、注文数量が 3 個以上で 5 個以下の注文が返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where2_mq)]
+ [!code-vb[DP L2E Examples#Where2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where2_mq)]  
+  
+### 例  
+ 次の例では、色が赤の製品がすべて返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where3_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where3_mq)]
+ [!code-vb[DP L2E Examples#Where3_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where3_mq)]  
+  
+### 例  
+ 次の例では、`Where` メソッドを使用して、2003 年 12 月 1 日以降に受けた注文を検索します。次に、`order.SalesOrderDetail` ナビゲーション プロパティを使用して、各注文の詳細を取得します。  
+  
+ [!code-csharp[DP L2E Examples#WhereNavProperty_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#wherenavproperty_mq)]
+ [!code-vb[DP L2E Examples#WhereNavProperty_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#wherenavproperty_mq)]  
+  
+## Where…Contains  
+  
+### 例  
+ 次の例では、配列を `Where Contains` 句の一部として使用し、その配列内の値と一致する `ProductModelID` を持つすべての製品を検出します。  
+  
+ [!code-csharp[DP L2E ArraysAndListsInQueries#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e arraysandlistsinqueries/cs/program.cs#3)]
+ [!code-vb[DP L2E ArraysAndListsInQueries#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e arraysandlistsinqueries/vb/module1.vb#3)]  
+  
+> [!NOTE]
+>  `Where Contains` 句の述語として、<xref:System.Array>、<xref:System.Collections.Generic.List%601>、または <xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装する任意の型のコレクションを使用できます。  さらに、LINQ to Entities クエリ内でコレクションを宣言および初期化できます。  詳細については、次の例を参照してください。  
+  
+### 例  
+ 次の例では、`Where Contains` 句で配列を宣言および初期化し、その配列内の値と一致する `ProductModelID` または `Size` を持つすべての製品を検出します。  
+  
+ [!code-csharp[DP L2E ArraysAndListsInQueries#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e arraysandlistsinqueries/cs/program.cs#4)]
+ [!code-vb[DP L2E ArraysAndListsInQueries#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e arraysandlistsinqueries/vb/module1.vb#4)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-grouping.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-grouping.md
new file mode 100644
index 00000000000..529bde2db27
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-grouping.md
@@ -0,0 +1,50 @@
+---
+title: "メソッド ベースのクエリ構文例 : グループ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: cb23c25c-1075-4cc3-a8ff-4db72e536c0d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : グループ化
+このトピックでは、メソッド ベースのクエリ構文で、`GroupBy` メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## 例  
+ 次の例では、`GroupBy` メソッドを使用して、郵便番号でグループ化されている `Address` オブジェクトを返しています。  結果は匿名型に射影されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupBySimple3_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbysimple3_mq)]
+ [!code-vb[DP L2E Examples#GroupBySimple3_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbysimple3_mq)]  
+  
+## 例  
+ 次の例では、`GroupBy` メソッドを使用して、連絡先の姓の先頭文字でグループ化した `Contact` オブジェクトを返しています。  結果は姓の先頭文字で並べ替えられ、匿名型に投影されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupBySimple2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbysimple2_mq)]
+ [!code-vb[DP L2E Examples#GroupBySimple2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbysimple2_mq)]  
+  
+## 例  
+ 次の例では、`GroupBy` メソッドを使用して、顧客 ID でグループ化されている `SalesOrderHeader` オブジェクトを返しています。  顧客ごとの販売数も返されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupByCount_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbycount_mq)]
+ [!code-vb[DP L2E Examples#GroupByCount_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbycount_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-join-operators.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-join-operators.md
new file mode 100644
index 00000000000..080892af83c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-join-operators.md
@@ -0,0 +1,60 @@
+---
+title: "メソッド ベースのクエリ構文例 : 結合演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d00f0efa-9084-4c17-843f-54904fcb4204
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 結合演算子
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.Join%2A> メソッドと <xref:System.Linq.Enumerable.GroupJoin%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## GroupJoin  
+  
+### 例  
+ 次の例では、SalesOrderHeader テーブルおよび SalesOrderDetail テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行することによって、顧客ごとの注文数を調べます。  GroupJoin は、左外部結合に相当します。つまり、1 つ目 \(左側\) のデータ ソースに存在するすべての要素は、関連する要素がもう一方のデータ ソースに存在するかどうかに関係なく返されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupJoin2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupjoin2_mq)]
+ [!code-vb[DP L2E Examples#GroupJoin2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupjoin2_mq)]  
+  
+### 例  
+ 次の例では、Contact テーブルおよび SalesOrderHeader テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行して、連絡先ごとの注文数を調べます。  各連絡先の注文数と ID が表示されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupJoin_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupjoin_mq)]
+ [!code-vb[DP L2E Examples#GroupJoin_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupjoin_mq)]  
+  
+## Join  
+  
+### 例  
+ 次の例では、Contact テーブルと SalesOrderHeader テーブルの結合を実行します。  
+  
+ [!code-csharp[DP L2E Examples#JoinSimple_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#joinsimple_mq)]
+ [!code-vb[DP L2E Examples#JoinSimple_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#joinsimple_mq)]  
+  
+### 例  
+ 次の例では、Contact テーブルと SalesOrderHeader テーブルを結合し、結果を連絡先 ID でグループ化します。  
+  
+ [!code-csharp[DP L2E Examples#JoinWithGroupedResults_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#joinwithgroupedresults_mq)]
+ [!code-vb[DP L2E Examples#JoinWithGroupedResults_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#joinwithgroupedresults_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-navigating-relationships.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-navigating-relationships.md
new file mode 100644
index 00000000000..cb285c24b8b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-navigating-relationships.md
@@ -0,0 +1,65 @@
+---
+title: "メソッド ベースのクエリ構文例 : リレーションシップのナビゲーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: a0bfa4b1-99e5-4dd1-9912-4b825a9dc25c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : リレーションシップのナビゲーション
+[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] のナビゲーション プロパティは、アソシエーションの末尾にあるエンティティを見つけるために使用できるショートカット プロパティです。  ナビゲーション プロパティを使用すると、ユーザーは、エンティティ間をナビゲートしたり、あるエンティティからアソシエーション セットを介して関連エンティティにナビゲートしたりできます。  このトピックでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリ内でナビゲーション プロパティを介してリレーションシップをナビゲートするためのメソッド ベースのクエリ構文の例を示します。  
+  
+ これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## 例  
+ 次の例では、メソッドベースのクエリ構文で <xref:System.Linq.Queryable.SelectMany%2A> メソッドを使用して、姓が "Zhou" である連絡先のすべての注文を取得します。  `Contact.SalesOrderHeader` ナビゲーション プロパティは、各連絡先の `SalesOrderHeader` オブジェクトのコレクションを取得するために使用されます。  
+  
+ [!code-csharp[DP L2E Examples#SelectEachContactsOrders_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selecteachcontactsorders_mq)]
+ [!code-vb[DP L2E Examples#SelectEachContactsOrders_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selecteachcontactsorders_mq)]  
+  
+## 例  
+ 次の例では、メソッドベースのクエリ構文で <xref:System.Linq.Queryable.Select%2A> メソッドを使用して、姓が "Zhou" である連絡先のすべての連絡先 ID と、各連絡先の合計支払額の総計を取得します。  `Contact.SalesOrderHeader` ナビゲーション プロパティは、各連絡先の `SalesOrderHeader` オブジェクトのコレクションを取得するために使用されます。  `Sum` メソッドは、`Contact.SalesOrderHeader` ナビゲーション プロパティを使用して、それぞれの連絡先のすべての注文の合計支払額を合計します。  
+  
+ [!code-csharp[DP L2E Examples#SelectEachContactsOrders2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selecteachcontactsorders2_mq)]
+ [!code-vb[DP L2E Examples#SelectEachContactsOrders2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selecteachcontactsorders2_mq)]  
+  
+## 例  
+ 次の例では、メソッド ベースのクエリ構文を使用し、姓が "Zhou" である連絡先のすべての注文を取得します。  `Contact.SalesOrderHeader` ナビゲーション プロパティは、各連絡先の `SalesOrderHeader` オブジェクトのコレクションを取得するために使用されます。  連絡先の名前と注文が匿名型で返されます。  
+  
+ [!code-csharp[DP L2E Examples#SelectEachContactsOrders3_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selecteachcontactsorders3_mq)]
+ [!code-vb[DP L2E Examples#SelectEachContactsOrders3_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selecteachcontactsorders3_mq)]  
+  
+## 例  
+ 次の例では、`SalesOrderHeader.Address` ナビゲーション プロパティと `SalesOrderHeader.Contact` ナビゲーション プロパティを使用して、互いに関連付けられている `Address` オブジェクトと `Contact` オブジェクトのコレクションを取得します。  各注文の連絡先の姓、住所、販売注文番号、および Seattle 市に対する合計支払額が匿名型で返されます。  
+  
+ [!code-csharp[DP L2E Examples#GetOrderInfoThruRelationships_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#getorderinfothrurelationships_mq)]
+ [!code-vb[DP L2E Examples#GetOrderInfoThruRelationships_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#getorderinfothrurelationships_mq)]  
+  
+## 例  
+ 次の例では、`Where` メソッドを使用して、2003 年 12 月 1 日以降に受けた注文を検索します。次に、`order.SalesOrderDetail` ナビゲーション プロパティを使用して、各注文の詳細を取得します。  
+  
+ [!code-csharp[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#wherenavproperty)]
+ [!code-vb[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#wherenavproperty)]  
+  
+## 参照  
+ [Navigation Properties](http://msdn.microsoft.com/ja-jp/41e1e6b9-8a57-467d-99d9-1857d2ca2ea5)   
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-ordering.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-ordering.md
new file mode 100644
index 00000000000..eb8e9b61a12
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-ordering.md
@@ -0,0 +1,48 @@
+---
+title: "メソッド ベースのクエリ構文例 : 並べ替え | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 5d21b178-d731-471a-8534-1f8184a2ef06
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 並べ替え
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.ThenBy%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## ThenBy  
+  
+### 例  
+ 次の例では、メソッド ベースのクエリ構文で <xref:System.Linq.Queryable.OrderBy%2A> と <xref:System.Linq.Queryable.ThenBy%2A> を使用し、姓の順、次に名の順に並べ替えられた連絡先の一覧を返します。  
+  
+ [!code-csharp[DP L2E Examples#OrderByThenBy_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#orderbythenby_mq)]
+ [!code-vb[DP L2E Examples#OrderByThenBy_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#orderbythenby_mq)]  
+  
+## ThenByDescending  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Queryable.OrderBy%2A> メソッドおよび <xref:System.Linq.Queryable.ThenByDescending%2A> メソッドを使用し、最初に表示価格で並べ替えた後、製品名の降順で並べ替えます。  
+  
+ [!code-csharp[DP L2E Examples#ThenByDescending_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#thenbydescending_mq)]
+ [!code-vb[DP L2E Examples#ThenByDescending_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#thenbydescending_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-partitioning.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-partitioning.md
new file mode 100644
index 00000000000..ab75683afb7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-partitioning.md
@@ -0,0 +1,60 @@
+---
+title: "メソッド ベースのクエリ構文例 : パーティション分割 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b7b64874-c3c8-4bdb-862c-89a168d07827
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : パーティション分割
+このトピックでは、クエリ式構文で、<xref:System.Linq.Enumerable.Skip%2A> メソッドおよび <xref:System.Linq.Enumerable.Take%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Skip  
+  
+### 例  
+ 次の例では、Contact テーブルから最初の 5 つを除くすべての連絡先を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#SkipSimple](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#skipsimple)]
+ [!code-vb[DP L2E Examples#SkipSimple](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#skipsimple)]  
+  
+### 例  
+ 次の例では、Seattle から最初の 2 つを除くすべての住所を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#SkipNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#skipnested)]
+ [!code-vb[DP L2E Examples#SkipNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#skipnested)]  
+  
+## Take  
+  
+### 例  
+ 次の例では、Contact テーブルから最初の 5 つの連絡先だけを、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#TakeSimple](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#takesimple)]
+ [!code-vb[DP L2E Examples#TakeSimple](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#takesimple)]  
+  
+### 例  
+ 次の例では、Seattle から最初の 3 つの住所を、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#TakeNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#takenested)]
+ [!code-vb[DP L2E Examples#TakeNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#takenested)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-projection.md b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-projection.md
new file mode 100644
index 00000000000..2d130f87924
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-projection.md
@@ -0,0 +1,60 @@
+---
+title: "メソッド ベースのクエリ構文例 : 射影 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 505491fa-5920-43ce-8a96-c25389e125d8
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# メソッド ベースのクエリ構文例 : 射影
+このトピックでは、メソッド ベースのクエリ構文で、<xref:System.Linq.Enumerable.Select%2A> メソッドおよび <xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Select  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Queryable.Select%2A> メソッドを使用して、`Product.Name` プロパティおよび `Product.ProductID` プロパティを一連の匿名型に射影します。  
+  
+ [!code-csharp[DP L2E Examples#SelectAnonymousTypes_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectanonymoustypes_mq)]
+ [!code-vb[DP L2E Examples#SelectAnonymousTypes_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectanonymoustypes_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Select%2A> メソッドを使用して、一連の製品名だけを取得しています。  
+  
+ [!code-csharp[DP L2E Examples#SelectSimple2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectsimple2_mq)]
+ [!code-vb[DP L2E Examples#SelectSimple2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectsimple2_mq)]  
+  
+## SelectMany  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使用して、`TotalDue` が 500.00 に満たないすべての注文を選択します。  
+  
+ [!code-csharp[DP L2E Examples#SelectManyCompoundFrom_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectmanycompoundfrom_mq)]
+ [!code-vb[DP L2E Examples#SelectManyCompoundFrom_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectmanycompoundfrom_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使用して、2002 年 10 月 1 日以降に受けたすべての注文を選択します。  
+  
+ [!code-csharp[DP L2E Examples#SelectManyCompoundFrom2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectmanycompoundfrom2_mq)]
+ [!code-vb[DP L2E Examples#SelectManyCompoundFrom2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectmanycompoundfrom2_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/modulo-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/modulo-entity-sql.md
new file mode 100644
index 00000000000..0687d6130df
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/modulo-entity-sql.md
@@ -0,0 +1,56 @@
+---
+title: "(剰余) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 243ddc4f-3c4e-41e1-a3ef-4ed39e36248b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# (剰余) (Entity SQL)
+ある式を別の式で除算した結果の余りを返します。  
+  
+## 構文  
+  
+```  
+  
+dividend  
+%  
+divisor  
+  
+```  
+  
+## 引数  
+ `dividend`  
+ 除算する数値式。`dividend` は、任意の数値データ型の有効な式です。  
+  
+ `divisor`  
+ 被除数を除算する数値式。`divisor` は、任意の数値データ型の有効な式です。  
+  
+## 戻り値の型  
+ Edm.Int32  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、% 算術演算子を使用して、特定の式を別の式で除算した結果の余りを返します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#MODULO](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#modulo)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/msl-specification.md b/docs/framework/data/adonet/ef/language-reference/msl-specification.md
new file mode 100644
index 00000000000..a0d48cf30d1
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/msl-specification.md
@@ -0,0 +1,26 @@
+---
+title: "MSL 仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 168c895d-b1d3-43cd-8efa-412dae16da6d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# MSL 仕様
+現在、[msdn.microsoft.com\/data\/ef](http://msdn.microsoft.com/data/ef) サイトでは、主に Entity Framework に関するコンテンツを提供しています。  
+  
+ このトピックの内容は、「[MSL 仕様](http://msdn.microsoft.com/data/jj652027)」ページでご利用いただけます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/multiply-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/multiply-entity-sql.md
new file mode 100644
index 00000000000..08372c27979
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/multiply-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "* (乗算) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 508ce246-4e86-47dd-a605-4af4bebb9891
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# * (乗算) (Entity SQL)
+2 つの式を乗算します。  
+  
+## 構文  
+  
+```  
+  
+expression  
+*  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の数値データ型の有効な式。  
+  
+## 戻り値の型  
+ 2 つの引数の暗黙の型の昇格の結果であるデータ型。 暗黙の型の昇格について詳しくは、「[型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\* 算術演算子を使用して 2 つの数値を乗算します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#MULTIPLY](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#multiply)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md
new file mode 100644
index 00000000000..b50e9227d1b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/multiset-entity-sql.md
@@ -0,0 +1,67 @@
+---
+title: "MULTISET (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: eb90a377-e47a-43a5-b308-e993b6d611e6
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# MULTISET (Entity SQL)
+値のリストからマルチセットのインスタンスを作成します。 MULTISET コンストラクターの値はすべて、互換性のある型  `T` である必要があります。 空のマルチセット コンストラクターは使用できません。  
+  
+## 構文  
+  
+```  
+  
+MULTISET (expression [{, expression }] )  
+or  
+{ expression [{, expression }] }  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な値のリスト。  
+  
+## 戻り値  
+ 型 MULTISET\<T\> のコレクション。  
+  
+## 解説  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、行コンストラクター、オブジェクト コンストラクター、およびマルチセット \(またはコレクション\) コンストラクターの 3 種類のコンストラクターが用意されています。 詳細については、「[コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)」を参照してください。  
+  
+ マルチセット コンストラクターは、値のリストからマルチセットのインスタンスを作成します。 このコンストラクターの値はすべて、互換性のある型である必要があります。  
+  
+ たとえば、次の式は整数のマルチセットを作成します。  
+  
+ `MULTISET(1, 2, 3)`  
+  
+ `{1, 2, 3}`  
+  
+> [!NOTE]
+>  入れ子になったマルチセット リテラルは、`{{1, 2, 3}}` のように、外側のマルチセットに含まれているマルチセット要素が 1 つである場合にのみサポートされます。 複数のマルチセット要素が外側のマルチセットに含まれている場合 \(`{{1, 2}, {3, 4}}` など\)、入れ子になったマルチセット リテラルはサポートされません。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、MULTISET 演算子を使用して、値のリストからマルチセットのインスタンスを作成します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#MULTISET](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#multiset)]  
+  
+## 参照  
+ [コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md
new file mode 100644
index 00000000000..4dc81b44909
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/named-type-constructor-entity-sql.md
@@ -0,0 +1,75 @@
+---
+title: "名前付きの型コンストラクター (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 549dea04-d93d-4c87-a292-f81b1598dbfd
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 名前付きの型コンストラクター (Entity SQL)
+エンティティ型や複合型など、概念モデル標準型のインスタンスの作成に使用します。  
+  
+## 構文  
+  
+```  
+  
+[{identifier. }] identifier( [expression [{, expression }]] )  
+```  
+  
+## 引数  
+ `identifier`  
+ 単純な識別子および引用符で囲まれた識別子の値。 詳しくは、「[識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md)」をご覧ください。  
+  
+ `expression`  
+ 型の宣言に表示される順序と同じ順序であると見なされる型の属性。  
+  
+## 戻り値  
+ 名前付きの複合型とエンティティ型のインスタンス。  
+  
+## 解説  
+ 次の例は、標準型と複合型を作成する方法を示しています。  
+  
+ 次の式は、`Person` 型のインスタンスを作成する式です。  
+  
+ `Person("abc", 12)`  
+  
+ 次の式は、複合型のインスタンスを作成する式です。  
+  
+ `MyModel.ZipCode(‘98118’, ‘4567’)`  
+  
+ 次の式は、入れ子になった複合型のインスタンスを作成する式です。  
+  
+ `MyModel.AddressInfo('My street address', 'Seattle', 'WA', MyModel.ZipCode('98118', '4567'))`  
+  
+ 次の式は、入れ子になった複合型を持つエンティティのインスタンスを作成する式です。  
+  
+ `MyModel.Person("Bill", MyModel.AddressInfo('My street address', 'Seattle', 'WA', MyModel.ZipCode('98118', '4567')))`  
+  
+ 次の例は、複合型のプロパティを null に初期化する方法を示しています。`MyModel.ZipCode(‘98118’, null)`  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、名前付きの型コンストラクターを使用して、概念モデル型のインスタンスを作成します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#NAMED_TYPE_CONSTRUCTOR](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#named_type_constructor)]  
+  
+## 参照  
+ [コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md
new file mode 100644
index 00000000000..713f25ee027
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md
@@ -0,0 +1,51 @@
+---
+title: "名前空間 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 83991c21-60db-4af9-aca3-b416f6cae98e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 名前空間 (Entity SQL)
+型名、エンティティ セット、関数など、グローバル識別子の名前の競合を防ぐために、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には名前空間が採用されています。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] における名前空間のサポートは、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] における名前空間のサポートと似ています。  
+  
+ 次の例のように、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、2 とおりの形式で USING 句を指定できます。1 つは略称的な別名を指定する修飾名前空間、もう 1 つは別名を指定しない非修飾名前空間です。  
+  
+ `USING System.Data;`  
+  
+ `USING tsql = System.Data;`  
+  
+## 名前解決ルール  
+ 識別子がローカル スコープ内で解決されない場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] はグローバル スコープ \(名前空間\) で名前を検索します。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、まず識別子 \(プレフィックス\) と修飾名前空間の 1 つを照合します。  一致が見つかった場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、指定された名前空間で、その識別子の残りの部分を解決しようと試みます。  一致が見つからなかった場合は、例外がスローされます。  
+  
+ 次に、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、すべての \(プロローグに指定された\) 非修飾名前空間から識別子を検索することを試みます。  その識別子が属している名前空間を一意に特定できた場合は、その場所が返されます。  同じ識別子に対して複数の名前空間が見つかった場合は、例外がスローされます。  識別子に対応する名前空間を特定できなかった場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、次の例のように、識別子の名前を 1 つ外側のスコープ \(<xref:System.Data.Common.DbCommand> オブジェクトまたは <xref:System.Data.Common.DbConnection> オブジェクト\) に渡します。  
+  
+```  
+SELECT TREAT(p AS NamespaceName.Employee)  
+FROM ContainerName.Person AS p  
+WHERE p IS OF (NamespaceName.Employee)  
+```  
+  
+## .NET Framework との違い  
+ [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] では、部分修飾名前空間を使用できますが、  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では使用できません。  
+  
+## ADO.NET の使用法  
+ クエリは、ADO.NET の <xref:System.Data.Common.DbCommand> オブジェクトを使用して表されます。  <xref:System.Data.Common.DbCommand> オブジェクトは、<xref:System.Data.Common.DbConnection> オブジェクトに対して構築できます。  名前空間を <xref:System.Data.Common.DbCommand> オブジェクトや <xref:System.Data.Common.DbConnection> オブジェクトの一部として指定することもできます。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] がクエリ内で識別子を解決できなかった場合、同様のルールに従って、外側の名前空間が調査されます。  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md
new file mode 100644
index 00000000000..b098ab7adbf
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md
@@ -0,0 +1,94 @@
+---
+title: "NAVIGATE (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: f107f29d-005f-4e39-a898-17f163abb1d0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# NAVIGATE (Entity SQL)
+エンティティ間で確立されたリレーションシップをナビゲートします。  
+  
+## 構文  
+  
+```  
+  
+navigate(instance-expresssion, [relationship-type], [to-end [, from-end] ])  
+```  
+  
+## 引数  
+ `instance-expresssion`  
+ エンティティのインスタンス。  
+  
+ `relationship-type`  
+ 概念スキーマ定義言語 \(CSDL\) ファイルで指定されたリレーションシップの種類の名前。`relationship-type` は \<namespace\>.\<relationship type name\> として修飾されます。  
+  
+ `to`  
+ リレーションシップの終端エンティティ。  
+  
+ `from`  
+ リレーションシップの開始エンティティ。  
+  
+## 戻り値  
+ 終端の基数が 1 の場合、戻り値は `Ref<T>` になります。 終端の基数が n の場合、戻り値は `Collection<Ref<T>>` になります。  
+  
+## 解説  
+ リレーションシップは、[!INCLUDE[adonet_edm](../../../../../../includes/adonet-edm-md.md)] \(EDM\) における最上位の構造です。 リレーションシップは、複数のエンティティ型の間で確立され、ユーザーはエンティティ間のリレーションシップをナビゲートできます。`from` と `to` は、リレーションシップ内の名前解決があいまいでない場合の条件付きのオプションです。  
+  
+ NAVIGATE は、O および C 空間で有効です。  
+  
+ ナビゲーション構造の一般的な形式は次のようになります。  
+  
+ navigate\(`instance-expresssion`, `relationship-type`, \[ `to-end` \[, `from-end` \] \] \)  
+  
+ 次に例を示します。  
+  
+```  
+Select o.Id, navigate(o, OrderCustomer, Customer, Order)  
+From LOB.Orders as o  
+```  
+  
+ ここで、OrderCustomer は `relationship` であり、Customer と Order はリレーションシップの `to-end` \(顧客\) と `from-end` \(注文\) です。 OrderCustomer が n:1 リレーションシップの場合、ナビゲーション式の結果型は Ref\<Customer\> となります。  
+  
+ この式をより簡略化すると、次のようになります。  
+  
+```  
+Select o.Id, navigate(o, OrderCustomer)  
+From LOB.Orders as o  
+```  
+  
+ 同様に、次の形式のクエリでは、ナビゲーション式は Collection\<Ref\<Order\>\> のようになります。  
+  
+```  
+Select c.Id, navigate(c, OrderCustomer, Order, Customer)  
+From LOB.Customers as c  
+```  
+  
+ インスタンス式は、エンティティ\/参照型になる必要があります。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、NAVIGATE 演算子を使用して、Address エンティティ型と SalesOrderHeader エンティティ型間で確立されたリレーションシップをナビゲートします。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#NAVIGATE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#navigate)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [How to: Navigate Relationships with Navigate Operator](../../../../../../docs/framework/data/adonet/ef/language-reference/navigate-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/negative-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/negative-entity-sql.md
new file mode 100644
index 00000000000..479586c8478
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/negative-entity-sql.md
@@ -0,0 +1,55 @@
+---
+title: "- (負符号) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 208e54ef-4741-4ec5-89d6-6ff700863cb0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# - (負符号) (Entity SQL)
+数値式の負の値を返します。  
+  
+## 構文  
+  
+```  
+  
+-  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の数値データ型の有効な式。  
+  
+## 戻り値の型  
+ `expression` のデータ型。  
+  
+## 解説  
+ 符号なしの型を `expression` に指定した場合、戻り値の型は、`expression` の型と最も関連性の高い符号付きの型になります。 たとえば、`expression` に Byte 型を指定した場合、Int16 型の値が返されます。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\- 算術演算子を使用して、数値式の負の値を返します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#NEGATIVE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#negative)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/not-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/not-entity-sql.md
new file mode 100644
index 00000000000..b563a8e1d43
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/not-entity-sql.md
@@ -0,0 +1,52 @@
+---
+title: "! (NOT) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: a1447a34-df06-4393-93c3-0612ebd41abc
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ! (NOT) (Entity SQL)
+`Boolean` 型の式を否定します。  
+  
+## 構文  
+  
+```  
+  
+NOT boolean_expression  
+or  
+! boolean_expression  
+```  
+  
+## 引数  
+ `boolean_expression`  
+ ブール値を返す任意の有効な式。  
+  
+## 解説  
+ 感嘆符 \(\!\) には、NOT 演算子と同じ機能があります。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、NOT 演算子を使用して `Boolean` 型の式を否定します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#NOT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#not)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/not-equal-to-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/not-equal-to-entity-sql.md
new file mode 100644
index 00000000000..b816f6b0cf9
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/not-equal-to-entity-sql.md
@@ -0,0 +1,54 @@
+---
+title: "!= (等しくない) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 3b4a02ad-ddfc-4c42-8dfa-676234461312
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# != (等しくない) (Entity SQL)
+2 つの式を比較して、左の式の値が右の式の値と等しくないかどうかを判別します。 \!\= \(等しくない\) 演算子は、機能的には \<\> 演算子と同じです。  
+  
+## 構文  
+  
+```  
+  
+          expression  
+          !=  
+          expression  
+or  
+expression <> expression  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の有効な式。 両方の式とも、暗黙的に変換可能なデータ型でなければなりません。  
+  
+## 戻り値の型  
+ 左の式が右の式と等しくない場合は `true`、等しい場合は `false`。  
+  
+## 使用例  
+ 次の Entity SQL クエリは \!\= 演算子を使用して 2 つの式を比較し、左の式が右の式と等しくないかどうかを判別します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#NOT_EQUALS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#not_equals)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/null-comparisons.md b/docs/framework/data/adonet/ef/language-reference/null-comparisons.md
new file mode 100644
index 00000000000..2b3f268ecb0
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/null-comparisons.md
@@ -0,0 +1,58 @@
+---
+title: "NULL 比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ef88af8c-8dfe-4556-8b56-81df960a900b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# NULL 比較
+データ ソースの `null` 値は不明な値を表します。  [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでは、NULL 値をチェックして、必ず NULL でない有効なデータを持つ行に特定の計算または比較を行うようにすることができます。  ただし、CLR の NULL セマンティクスは、データ ソースの NULL セマンティクスとは異なる場合があります。  ほとんどのデータベースでは、3 値論理を使用して NULL 比較を処理します。  つまり、NULL 値との比較は `true` にも `false` にも評価されず、`unknown` に評価されます。  これは、多くの場合は ANSI NULL の実装ですが、そうでない場合もあります。  
+  
+ SQL Server の既定では、NULL \= NULL の比較は NULL 値を返します。  次の例では、`ShipDate` が NULL である行が結果セットから除外され、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] ステートメントは 0 行を返します。  
+  
+```  
+-- Find order details and orders with no ship date.  
+SELECT h.SalesOrderID  
+FROM Sales.SalesOrderHeader h  
+JOIN Sales.SalesOrderDetail o ON o.SalesOrderID = h.SalesOrderID  
+WHERE h.ShipDate IS Null  
+```  
+  
+ これは、NULL \= NULL の比較が true を返す CLR の NULL セマンティクスとは大きく異なります。  
+  
+ 次の LINQ クエリは CLR で表されますが、データ ソースで実行されます。  CLR セマンティクスがデータ ソースで使用される保証はないため、動作は予測できません。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#JoinOnNull](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#joinonnull)]
+ [!code-vb[DP L2E Conceptual Examples#JoinOnNull](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#joinonnull)]  
+  
+## キー セレクター  
+ *キー セレクター*とは、要素からキーを抽出するために標準クエリ演算子で使用される関数です。  キー セレクター関数では、式を定数と比較できます。  式が NULL 定数と比較される場合、または 2 つの NULL 定数が比較される場合、CLR の NULL セマンティクスが使用されます。  データ ソースの NULL 値を持つ 2 つの列が比較される場合は、ストア NULL セマンティクスが使用されます。  キー セレクターは、<xref:System.Linq.Queryable.GroupBy%2A> など、グループ化や並べ替えの標準クエリ演算子で使用される場合が多く、クエリ結果の並べ替えやグループ化に使用するキーを選択できます。  
+  
+## NULL オブジェクトの NULL プロパティ  
+ [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] では、NULL オブジェクトのプロパティは NULL です。  CLR で NULL オブジェクトのプロパティを参照しようとすると、<xref:System.NullReferenceException> が返されます。  LINQ クエリに NULL オブジェクトのプロパティが含まれている場合、動作の一貫性が失われることがあります。  
+  
+ たとえば、次のクエリでは、`NewProduct` へのキャストはコマンド ツリー レイヤーで行われ、`Introduced` プロパティが NULL になる可能性があります。  <xref:System.DateTime> の比較が true に評価されるように NULL 比較がデータベースで定義されている場合に、その行が含められます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CastResultsIsNull](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#castresultsisnull)]
+ [!code-vb[DP L2E Conceptual Examples#CastResultsIsNull](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#castresultsisnull)]  
+  
+## 集計関数に NULL コレクションを渡す  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] では、`IQueryable` をサポートするコレクションを集計関数に渡すと、データベースで集計演算が実行されます。  メモリで実行されたクエリとデータベースで実行されたクエリの結果は、異なる可能性があります。  メモリ内のクエリでは、一致するものがなければ 0 が返されます。  データベースでは、これと同じクエリから `null` が返されます。  `null` 値が LINQ 集計関数に渡されると、例外がスローされます。  `null` 値を受け入れるには、型、およびクエリ結果を受け取るその型のプロパティを Null 許容型にキャストします。  
+  
+## 参照  
+ [LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/null-literals-and-type-inference-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/null-literals-and-type-inference-entity-sql.md
new file mode 100644
index 00000000000..e40c392019f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/null-literals-and-type-inference-entity-sql.md
@@ -0,0 +1,55 @@
+---
+title: "NULL リテラルと型推論 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: edd56afb-af1b-4e7d-b210-cb8998143426
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# NULL リテラルと型推論 (Entity SQL)
+NULL リテラルは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] 型システムのすべての型と互換性があります。  ただし、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、NULL リテラルの型を正しく推論できるようにするために、NULL リテラルの使用場所に関して一定の制約が設けられています。  
+  
+## 型指定された NULL  
+ 型指定された NULL は任意の場所で使用できます。  型指定された NULL の場合、型が不明であるため、型推論は必要ありません。  たとえば、次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 構成要素を使用すると、Int16 型の NULL を作成できます。  
+  
+ `(cast(null as Int16))`  
+  
+## 型指定されない NULL リテラル  
+ 型指定されない NULL リテラルは、次のようなコンテキストで使用できます。  
+  
+-   CAST 式または TREAT 式への引数として使用できます。  これは、型指定された NULL 式を生成する場合に推奨される方法です。  
+  
+-   メソッドまたは関数への引数として使用できます。  標準のオーバーロード規則が適用されます。  
+  
+-   \+、\-、\/ などの算術式への引数の 1 つとして使用できます。  他の引数に NULL リテラルを指定することはできません。指定した場合、型推論ができなくなります。  
+  
+-   論理式 \(AND、OR、または NOT\) への引数として使用できます。  引数はすべて Boolean 型であると見なされます。  
+  
+-   IS NULL 式または IS NOT NULL 式への引数として使用できます。  
+  
+-   LIKE 式への 1 つ以上の引数として使用できます。  引数はすべて文字列であると見なされます。  
+  
+-   名前付きの型コンストラクターへの 1 つ以上の引数として使用できます。  
+  
+-   マルチセット コンストラクターへの 1 つ以上の引数として使用できます。  マルチセット コンストラクターに渡す引数のうち、少なくとも 1 つは、NULL リテラルではない式である必要があります。  
+  
+-   CASE 式の THEN 式または ELSE 式への 1 つ以上の引数として使用できます。  CASE 式の THEN 式または ELSE 式のうち、少なくとも一方は、NULL リテラルではない式である必要があります。  
+  
+ 型指定されない NULL リテラルは、その他のシナリオでは使用できません。  たとえば、行コンストラクターへの引数として使用することはできません。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md
new file mode 100644
index 00000000000..47a3cff776a
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md
@@ -0,0 +1,103 @@
+---
+title: "NULL 値が許容される構造化型 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ae006fa9-997e-45bb-8a04-a7f62026171e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# NULL 値が許容される構造化型 (Entity SQL)
+構造化型の `null` インスタンスは、存在しないインスタンスです。  これは、すべてのプロパティの値が `null` であるインスタンスとは異なります。  
+  
+ このトピックでは、NULL 値が許容される構造化型について説明します。この内容には、NULL 値が許容される型、および構造化 NULL 値が許容される型の `null` インスタンスを生成するコード パターンも含まれます。  
+  
+## NULL 値が許容される構造化型の種類  
+ NULL 値が許容される構造化型には、3 つの種類があります。  
+  
+-   行型。  
+  
+-   複合型。  
+  
+-   エンティティ型。  
+  
+## 構造化型の NULL インスタンスを生成するコード パターン  
+ 次のシナリオは、`null` インスタンスを生成します。  
+  
+-   構造化型としての `null` の構造化  
+  
+    ```  
+    TREAT (NULL AS StructuredType)  
+    ```  
+  
+-   派生型に対する基本データ型のキャスト  
+  
+    ```  
+    TREAT (BaseType AS DerivedType)  
+    ```  
+  
+-   false の条件での外部結合  
+  
+    ```  
+    Collection1 LEFT OUTER JOIN Collection2  
+    ON FalseCondition  
+    ```  
+  
+     \-\-または  
+  
+    ```  
+    Collection1 RIGHT OUTER JOIN Collection2  
+    ON FalseCondition  
+    ```  
+  
+     \-\-または  
+  
+    ```  
+    Collection1 FULL OUTER JOIN Collection2  
+    ON FalseCondition  
+    ```  
+  
+-   `null` 参照の逆参照  
+  
+    ```  
+    DEREF(NullRef)  
+    ```  
+  
+-   空のコレクションからの ANYELEMENT の取得  
+  
+    ```  
+    ANYELEMENT(EmptyCollection)  
+    ```  
+  
+-   構造化型の `null` インスタンスのチェック  
+  
+    ```csharp  
+    ...  
+    for (int i = 0; i < reader.FieldCount; i++)  
+    {  
+        if (reader.IsDBNull(i))  
+        {  
+            Console.WriteLine(“[NULL]”);  
+        }  
+        else  
+        {  
+            Console.WriteLine(reader.GetValue(i).ToString());  
+        }  
+    }  
+    ```  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md
new file mode 100644
index 00000000000..14954eb76b6
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/oftype-entity-sql.md
@@ -0,0 +1,80 @@
+---
+title: "OFTYPE (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 6d259ca7-bbf0-40f8-a154-181d25c0d67e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# OFTYPE (Entity SQL)
+クエリ式を使用して、指定された型のオブジェクトのコレクションを返します。  
+  
+## 構文  
+  
+```  
+  
+OFTYPE (expression, [ONLY] test_type)  
+```  
+  
+## 引数  
+ `expression`  
+ オブジェクトのコレクションを返す任意の有効なクエリ式。  
+  
+ `test_type`  
+ `expression` から返される各オブジェクトを判定するための型。 型は名前空間で修飾する必要があります。  
+  
+## 戻り値  
+ `test_type` 型であるか、`test_type` の基本データ型または派生型であるオブジェクトのコレクション。 ONLY を指定した場合、`test_type` のインスタンスまたは空のコレクションのみ返されます。  
+  
+## 解説  
+ `OFTYPE` 式は、コレクションの各要素の型を判定するための式です。`OFTYPE` 式では、指定された型の新しいコレクションが生成されます。生成されたコレクションには、指定された型と同じか、そのサブタイプの要素だけが格納されます。  
+  
+ `OFTYPE` 式は、次のクエリ式の省略形です。  
+  
+```  
+select value treat(t as T) from ts as t where t is of (T)  
+```  
+  
+ Manager が Employee のサブタイプである場合、次の式からは、従業員 \(employee\) のコレクションのうち、マネージャー \(manager\) のコレクションだけが返されます。  
+  
+```  
+OfType(employees, NamespaceName.Manager)  
+```  
+  
+ 型フィルターを使用してコレクションをアップ キャストすることもできます。  
+  
+```  
+OfType(executives, NamespaceName.Manager)  
+```  
+  
+ すべての企業幹部はマネージャーであるので、結果のコレクションには元の企業幹部がすべて含まれたままですが、コレクションはマネージャーのコレクションとして型指定されています。  
+  
+ 次の表は、いくつかのパターンにおける `OFTYPE` 演算子の動作を示しています。 すべての例外はクライアント側にスローされてから、プロバイダーが呼び出されます。  
+  
+|パターン|動作|  
+|----------|--------|  
+|OFTYPE\(Collection\(EntityType\), EntityType\)|Collection\(EntityType\)|  
+|OFTYPE\(Collection\(ComplexType\), ComplexType\)|スロー|  
+|OFTYPE\(Collection\(RowType\), RowType\)|スロー|  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、OFTYPE 演算子を使用して、Course オブジェクトのコレクションから OnsiteCourse オブジェクトのコレクションを取得して返します。 このクエリは、[School モデル](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac)に基づいています。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#OFTYPE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#oftype)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/operator-precedence-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/operator-precedence-entity-sql.md
new file mode 100644
index 00000000000..2a98049642f
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/operator-precedence-entity-sql.md
@@ -0,0 +1,44 @@
+---
+title: "演算子の優先順位 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: e92e4ca5-2889-4266-9625-47f0eb01a948
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 演算子の優先順位 (Entity SQL)
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリに複数の演算子がある場合は、演算子の優先順位によって、操作の実行順序が決まります。  実行される順序により、クエリ結果の値は大きく変わります。  
+  
+ 演算子には、次の表に示す優先順位レベルが定義されています。  優先順位が高い演算子は、優先順位が低い演算子よりも前に評価されます。  
+  
+|レベル|演算の種類|演算子|  
+|---------|-----------|---------|  
+|1|1 次式|`. , [] ()`|  
+|2|単項|`! not`|  
+|3|乗法|`* / %`|  
+|4|加法|`+ -`|  
+|5|並べ替え|`< > <= >=`|  
+|6|等価比較|`= != <>`|  
+|7|条件 AND|`and &&`|  
+|8|条件 OR|`or &#124;&#124;`|  
+  
+ 式の中の 2 つの演算子が同じ優先順位レベルである場合は、クエリの中での位置に従って演算子は左から右へと評価されます。  たとえば、 `x+y-z`  は  `(x+y)-z` と評価されます。  
+  
+ クエリの中で演算子の定義済みの優先順位を無効にするには、かっこを使用します。  この場合、かっこ内のすべての演算が評価され、1 つの結果が作成されてから、かっこ外の演算子でこの結果が使用されます。  たとえば、`x+y*z` の場合、`y` と `z` の積に `x` が加算されますが、`(x+y)*z` の場合は、`x` と `y` の和に `z` が乗算されます。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/or-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/or-entity-sql.md
new file mode 100644
index 00000000000..cd1b308c0e2
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/or-entity-sql.md
@@ -0,0 +1,65 @@
+---
+title: "|| (OR) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8e649648-eb9a-4380-9d74-36e62260628c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# || (OR) (Entity SQL)
+2 つの `Boolean` 式を結合します。  
+  
+## 構文  
+  
+```  
+  
+          boolean_expression OR boolean_expression  
+or   
+boolean_expression || boolean_expression  
+```  
+  
+## 引数  
+ `boolean_expression`  
+ `Boolean` 値を返す任意の有効な式。  
+  
+## 戻り値  
+ いずれかの条件が `true` の場合は `true`、それ以外の場合は `false`。  
+  
+## 解説  
+ OR は [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の論理演算子です。 2 つの条件を結合する場合に使用します。 1 つのステートメント内に複数の論理演算子が使われている場合、OR 演算子は AND 演算子の次に評価されます。 ただし、かっこを使うと、演算の順序を変更することができます。  
+  
+ 二重の縦棒 \(&#124;&#124;\) は、OR 演算子と同じ効果を持ちます。  
+  
+ 使用可能な入力値と戻り値の型を次の表に示します。  
+  
+||`TRUE`|`FALSE`|`NULL`|  
+|-|------------|-------------|------------|  
+|`TRUE`|TRUE|TRUE|TRUE|  
+|`FALSE`|TRUE|FALSE|NULL|  
+|`NULL`|TRUE|NULL|NULL|  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、OR 演算子を使用して 2 つの `Boolean` 式を結合します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#OR](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#or)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md
new file mode 100644
index 00000000000..48619e260d2
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md
@@ -0,0 +1,144 @@
+---
+title: "ORDER BY (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c0b61572-ecee-41eb-9d7f-74132ec8a26c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ORDER BY (Entity SQL)
+SELECT ステートメントで返されるオブジェクトで使用される並べ替え順を指定します。  
+  
+## 構文  
+  
+```  
+  
+[ ORDER BY   
+   {  
+      order_by_expression [SKIP n] [LIMIT n]  
+      [ COLLATE collation_name ]  
+      [ ASC | DESC ]  
+   }  
+   [ ,…n ]   
+]  
+```  
+  
+## 引数  
+ `order_by_expression`  
+ 並べ替えるプロパティを指定する有効なクエリ式。 並べ替えのキーとなる式を複数指定できます。 ORDER BY 句内に記述するキー式の並び順によって、並べ替えられた結果セットの構成が決まります。  
+  
+ COLLATE {collation\_name}  
+ ORDER BY 操作が `collation_name` で指定された照合順序に従って実行されることを指定します。 COLLATE は文字列式にのみ適用できます。  
+  
+ ASC  
+ 指定したプロパティの値が昇順、つまり小さい値から大きい値へと並べ替えられます。 既定値です。  
+  
+ DESC  
+ 指定したプロパティの値が降順、つまり大きい値から小さい値へと並べ替えられます。  
+  
+ LIMIT `n`  
+ 最初の `n` 個の項目のみが選択されます。  
+  
+ SKIP `n`  
+ 最初の `n` 個の項目をスキップします。  
+  
+## 解説  
+ ORDER BY 句は、SELECT 句の結果に論理的に適用されます。 ORDER BY 句では、別名を使用して選択リストの項目を参照できます。 ORDER BY 句は、現在スコープ内にあるその他の変数も参照できます。 ただし、SELECT 句が DISTINCT 修飾子で指定されている場合は、ORDER BY 句は SELECT 句の別名のみを参照できます。  
+  
+ `SELECT c AS c1 FROM cs AS c ORDER BY c1.e1, c.e2`  
+  
+ ORDER BY 句内の各式は、順序付けられた不等号 \(より小さい、より大きいなど\) について比較できる型として評価される必要があります。 通常、これらの型は数値、文字列、日付などのスカラー プリミティブです。 比較できる型の RowType は順序も比較できます。  
+  
+ 順序付けされたセットで、最上位の投影を除きコードが反復処理を行う場合、出力でその順序が維持されることは保証されません。  
+  
+```  
+-- In the following sample, order is guaranteed to be preserved:  
+SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName  
+```  
+  
+```  
+-- In the following query ordering of the nested query is ignored.  
+SELECT C2.FirstName, C2.LastName  
+    FROM (SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName) as C2  
+```  
+  
+ UNION、UNION ALL、EXCEPT、または INTERSECT 操作を順序付けするには、次のパターンを使用してください。  
+  
+```  
+SELECT ...  
+FROM ( UNION/EXCEPT/INTERSECT operation )  
+ORDER BY ...  
+```  
+  
+## 制限付きのキーワード  
+ 次のキーワードは `ORDER BY` 句で使用する場合には、引用符で囲む必要があります。  
+  
+-   CROSS  
+  
+-   FULL  
+  
+-   KEY  
+  
+-   左方向 \(←\) キー  
+  
+-   ORDER  
+  
+-   OUTER  
+  
+-   右方向 \(→\) キー  
+  
+-   ROW  
+  
+-   VALUE  
+  
+## 入れ子になったクエリの順序  
+ Entity Framework では、入れ子になった式をクエリ内の任意の場所に配置できるため、入れ子になったクエリの順序は維持されません。  
+  
+```  
+-- The following query will order the results by the last name.  
+SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName  
+```  
+  
+```  
+-- In the following query, ordering of the nested query is ignored.  
+SELECT C2.FirstName, C2.LastName  
+    FROM (SELECT C1.FirstName, C1.LastName  
+        FROM AdventureWorks.Contact as C1  
+        ORDER BY C1.LastName) as C2  
+```  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、SELECT ステートメントで返されたオブジェクトの並べ替え順序の指定に ORDER BY 演算子を使用します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#ORDERBY](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#orderby)]  
+  
+## 参照  
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md)   
+ [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md)   
+ [TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/other-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/other-canonical-functions.md
new file mode 100644
index 00000000000..e2c3dd7efa6
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/other-canonical-functions.md
@@ -0,0 +1,33 @@
+---
+title: "その他の正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 729bd47b-8e41-494c-a9a9-dcabf8b74312
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# その他の正規関数
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、ビット単位、集計、数学、日付\/時刻、または文字列に分類されない正規関数があります。  
+  
+ 次の表に、その他の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`NewGuid()`|新しい GUID を返します。<br /><br /> **例**<br /><br /> `NewGuid()`|  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/overlaps-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/overlaps-entity-sql.md
new file mode 100644
index 00000000000..ae768c448b4
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/overlaps-entity-sql.md
@@ -0,0 +1,57 @@
+---
+title: "OVERLAPS (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 41743e89-79cb-4d7b-8a27-355b45024b61
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OVERLAPS (Entity SQL)
+2 つのコレクションに共通の要素が存在するかどうかを調べます。  
+  
+## 構文  
+  
+```  
+  
+expression OVERLAPS expression  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効なクエリ式。もう一方のクエリ式から返されたコレクションと比較されます。 すべての式は、`expression` と同じ型であるか、共通の基本型または派生型である必要があります。  
+  
+## 戻り値  
+ 2 つのコレクションに共通の要素がある場合は `true`、それ以外の場合は `false`。  
+  
+## 解説  
+ OVERLAPS の機能は、``次の式と等価です。  
+  
+ `EXISTS ( expression INTERSECT expression )`  
+  
+ OVERLAPS は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、OVERLAPS 演算子を使用して、2 つのコレクションに共通の値が存在するかどうかを調べます。 このクエリは、AdventureWorks Sales Model に基づいています。 これをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#OVERLAPS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#overlaps)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md
new file mode 100644
index 00000000000..d8078161f97
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md
@@ -0,0 +1,41 @@
+---
+title: "ページング (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: ba4f334d-03e5-4a7b-9d42-628f4639b9a2
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ページング (Entity SQL)
+物理的なページングは、[ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) 句の [SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md) サブ句および [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md) サブ句を使用して実行できます。  物理的ページングを決定的に実行するには、SKIP と LIMIT を使用する必要があります。  非決定的な方法で結果の行の数を制限するには、[TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md) を使用する必要があります。  TOP および SKIP\/LIMIT は、同時には指定できません。  
+  
+## TOP の概要  
+ SELECT 句には、オプションの ALL\/DISTINCT 修飾子に続けてオプションの TOP サブ句を指定できます。  TOP サブ句は、クエリ結果の先頭から指定した行セットだけを返すよう指定します。  詳細については、「[TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)」を参照してください。  
+  
+## SKIP\/LIMIT の概要  
+ SKIP と LIMIT は ORDER BY 句の一部です。  SKIP 式のサブ句が ORDER BY 句に存在する場合、結果は並べ替え順序に従って並べ替えられ、結果セットには SKIP 式の直後の行から始まる行が含まれます。  たとえば、SKIP 5 は、先頭の 5 行をスキップし、6 行目以降を返します。  LIMIT 式のサブ句が ORDER BY 句に存在する場合、クエリは並べ替え順序に従って並べ替えられ、結果の行数は LIMIT 式によって制限されます。  たとえば、LIMIT 5 は、結果セットを 5 つのインスタンスまたは行に制限します。  SKIP と LIMIT を同時に使用することはできません。SKIP のみまたは LIMIT のみを ORDER BY 句と一緒に使用できます。  詳細については、次のトピックを参照してください。  
+  
+-   [SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md)  
+  
+-   [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md)  
+  
+-   [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md)  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [How to: Page Through Query Results](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md
new file mode 100644
index 00000000000..487be480c78
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md
@@ -0,0 +1,38 @@
+---
+title: "パラメーター (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 8d618edd-0988-4ff2-8263-ce59448af7a5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# パラメーター (Entity SQL)
+パラメーターは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の外部で定義される変数です。通常は、ホスト言語で使用されるバインド API を通じて定義されます。  それぞれのパラメーターには、名前と型があります。  パラメーター名は、クエリ式内で、プレフィックスとして @ 記号を付けて定義されます。これにより、クエリ内で定義されているプロパティ名などの他の名前と明確に区別されます。  
+  
+ パラメーターをバインドするための API は、ホスト言語によって提供されます。  
+  
+## 例  
+  
+```  
+select c   
+      from LOB.Customers as c   
+      where c.Name = @name  
+```  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md b/docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md
new file mode 100644
index 00000000000..33f1685e3ca
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md
@@ -0,0 +1,83 @@
+---
+title: "LINQ to Entities でのクエリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c015a609-29eb-4e95-abb1-2ca721c6e2ad
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LINQ to Entities でのクエリ
+クエリは、データ ソースからデータを取得する式です。  一般に、クエリは専用のクエリ言語で表現されます。たとえば、リレーショナル データベースであれば SQL、XML であれば XQuery が使用されます。  そのため、開発者はクエリの対象となるデータ ソースやデータ形式ごとに新しいクエリ言語を習得する必要があります。  統合言語クエリ \(LINQ\) は、データ ソースや形式の違いを意識することなくデータを扱うことのできる、より簡素化された一貫したモデルを提供します。  LINQ クエリでは、常にプログラミング オブジェクトを操作することになります。  
+  
+ LINQ のクエリ操作は、データ ソースを取得し、クエリを作成して、クエリを実行するという 3 つのアクションから成ります。  
+  
+ LINQ を介したクエリは、<xref:System.Collections.Generic.IEnumerable%601> ジェネリック インターフェイスまたは <xref:System.Linq.IQueryable%601> ジェネリック インターフェイスを実装するデータ ソースに対して行うことができます。  ジェネリック <xref:System.Data.Objects.ObjectQuery%601> インターフェイスを実装するジェネリック <xref:System.Linq.IQueryable%601> クラスのインスタンスは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリのデータ ソースとして動作します。  <xref:System.Data.Objects.ObjectQuery%601> ジェネリック クラスは、0 個以上の型指定されたオブジェクトのコレクションを返すクエリを表します。  C\# キーワード `var` \(Visual Basic の場合は Dim\) を使用して、コンパイラでエンティティの型を推論することもできます。  
+  
+ クエリでは、データ ソースから取得する情報を正確に指定できます。  また、並べ替え、グループ化、整形方法を指定して情報を取得することもできます。  LINQ では、クエリが変数に格納されます。  クエリが一連の値を返す場合、クエリ変数そのものがクエリ可能な型であることが必要です。  このクエリ変数は、クエリの情報を保存するだけで、なんらかのアクションを実行したり、データを返したりすることはありません。  クエリを作成した後、データを取得するには、そのクエリを実行する必要があります。  
+  
+## クエリ構文  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリは、クエリ式の構文とメソッド ベースのクエリ構文という 2 とおりの構文を使って作成できます。  クエリ式の構文は、C\# 3.0 および Visual Basic 9.0 で新たに導入され、Transact\-SQL や XQuery などと同様な宣言型の構文で記述された一連の句で構成されます。  ただし、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] の共通言語ランタイム \(CLR\) は、クエリ式の構文そのものを理解することはできません。  そのため、クエリ式はコンパイル時に、CLR が理解できる形式 \(メソッド呼び出し\) へと変換されます。  これらのメソッドは*標準クエリ演算子*として知られています。  開発者は、クエリ構文を使う代わりに、メソッド構文を使ってそれらを直接呼び出すこともできます。詳細については、「[Query Syntax and Method Syntax in LINQ](../Topic/Query%20Syntax%20and%20Method%20Syntax%20in%20LINQ%20\(C%23\).md)」を参照してください。  
+  
+### クエリ式の構文  
+ クエリ式は宣言型のクエリ構文です。  開発者は、Transact\-SQL に似た形式の高級言語でクエリを記述できます。  クエリ式の構文を使用することにより、フィルター、並べ替え、グループ化など、データ ソースに対するきわめて複雑な処理を最小限のコードで実行できます。  詳細については、「[基本的なクエリ操作 \(Visual Basic\)](../Topic/Basic%20Query%20Operations%20\(Visual%20Basic\).md)」を参照してください。  クエリ式構文の使用方法を示す例については、次のトピックを参照してください。  
+  
+-   [クエリ式の構文例 : 射影](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-projection.md)  
+  
+-   [クエリ式の構文例: フィルター処理](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-filtering.md)  
+  
+-   [クエリ式の構文例 : 並べ替え](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-ordering.md)  
+  
+-   [クエリ式の構文例 : 集計演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-aggregate-operators.md)  
+  
+-   [クエリ式の構文例 : パーティション分割](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-partitioning.md)  
+  
+-   [クエリ式の構文例 : 結合演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-join-operators.md)  
+  
+-   [クエリ式の構文例 : 要素演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-element-operators.md)  
+  
+-   [クエリ式の構文例 : グループ化](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-grouping.md)  
+  
+-   [クエリ式の構文例 : リレーションシップのナビゲーション](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-navigating-relationships.md)  
+  
+### メソッド ベースのクエリ構文  
+ [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリを作成するもう 1 つの方法として、メソッド ベースのクエリがあります。  メソッド ベースのクエリ構文は、LINQ の演算子メソッドを、ラムダ式をパラメーターとして直接順次呼び出すものです。  詳細については、「[ラムダ式](../Topic/Lambda%20Expressions%20\(C%23%20Programming%20Guide\).md)」を参照してください。  メソッドベースの構文の使用方法を示す例については、次のトピックを参照してください。  
+  
+-   [メソッド ベースのクエリ構文例 : 射影](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-projection.md)  
+  
+-   [メソッドベースのクエリ構文例: フィルター処理](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-filtering.md)  
+  
+-   [メソッド ベースのクエリ構文例 : 並べ替え](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-ordering.md)  
+  
+-   [メソッド ベースのクエリ構文例 : 集計演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-aggregate-operators.md)  
+  
+-   [メソッド ベースのクエリ構文例 : パーティション分割](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-partitioning.md)  
+  
+-   [メソッド ベースのクエリ構文例 : 変換](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-conversion.md)  
+  
+-   [メソッド ベースのクエリ構文例 : 結合演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-join-operators.md)  
+  
+-   [メソッド ベースのクエリ構文例 : 要素演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-element-operators.md)  
+  
+-   [メソッド ベースのクエリ構文例 : グループ化](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-grouping.md)  
+  
+-   [メソッド ベースのクエリ構文例 : リレーションシップのナビゲーション](../../../../../../docs/framework/data/adonet/ef/language-reference/method-based-query-syntax-examples-navigating-relationships.md)  
+  
+## 参照  
+ [LINQ to Entities](../../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)   
+ [Getting Started with LINQ in C\#](../Topic/Getting%20Started%20with%20LINQ%20in%20C%23.md)   
+ [Getting Started with LINQ in Visual Basic](../Topic/Getting%20Started%20with%20LINQ%20in%20Visual%20Basic.md)   
+ [Entity Framework マージ オプションおよびコンパイル済みクエリ](http://go.microsoft.com/fwlink/?LinkId=199591)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-execution.md b/docs/framework/data/adonet/ef/language-reference/query-execution.md
new file mode 100644
index 00000000000..a068d1bf803
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-execution.md
@@ -0,0 +1,104 @@
+---
+title: "クエリの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c0e6cf23-63ac-47dd-bfe9-d5bdca826fac
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# クエリの実行
+ユーザーによって作成された LINQ クエリは、コマンド ツリーに変換されます。  コマンド ツリーは、Entity Framework と互換性のあるクエリの表現です。  コマンド ツリーは、その後データ ソースに対して実行されます。  クエリの実行時には、すべてのクエリ式 \(つまりクエリの全コンポーネント\) が評価されます。これには結果の具体化で使用される式も含まれます。  
+  
+ クエリ式が評価されるタイミングはさまざまです。  LINQ クエリは、クエリ変数の作成時ではなく、常にクエリ変数の反復処理時に実行されます。  これを*遅延実行*といいます。  クエリを即時に実行することもできます。これは、クエリの結果をキャッシュする場合に有効です。  このことについては、このトピックの後半で説明します。  
+  
+ LINQ to Entities クエリを実行すると、クエリ内の一部の式がサーバー上で実行され、別の一部の式がクライアント上でローカルに実行される場合があります。  クライアント側での式の評価は、サーバー上でクエリが実行される前に行われます。  式がクライアント上で評価される場合、クエリ内の式がその評価の結果に置き換えられた後、サーバー上でクエリが実行されます。  クエリはデータ ソースに対して実行されるため、クライアントで指定された動作よりもデータ ソースの構成が優先されます。  たとえば、Null 値の処理方法や、数値の有効桁数などはサーバーの設定によって異なります。  クエリの実行中にサーバーに対してスローされた例外は、クライアントに直接渡されます。  
+  
+## クエリの遅延実行  
+ 一連の値を返すクエリでは、クエリ変数そのものはクエリ結果を保持しません。クエリ変数には、クエリのコマンドが格納されるだけです。  クエリ変数が `foreach` ループまたは `For Each` ループで反復処理されるまで、クエリは実行されません。  これは*遅延実行*として知られています。つまり、作成されたクエリはすぐには実行されません。  これは、任意のタイミングでクエリを実行できるということを意味します。  これは、たとえば他のアプリケーションによって更新されるデータベースがある場合に便利です。  アプリケーションで、最新情報を取得するクエリを作成し、それを繰り返し実行することにより、更新のたびに最新の情報を取得できます。  
+  
+ 遅延実行により、複数のクエリを組み合わせたり、クエリを拡張したりすることが可能となります。  クエリを拡張して新しい操作を追加すると、その変更が最終的な実行時に反映されます。  次の例の最初のクエリでは、すべての製品が返されます。  2 つ目のクエリでは、サイズが "L" のすべての製品を返すように、`Where` を使って 1 つ目のクエリを拡張しています。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#Composing1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#composing1)]
+ [!code-vb[DP L2E Conceptual Examples#Composing1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#composing1)]  
+  
+ クエリが実行された後、後続のすべてのクエリでメモリ内の LINQ 演算子が使用されます。  `foreach` ステートメントや `For Each` ステートメントを使用することによって、または LINQ 変換演算子の 1 つを呼び出すことによって、クエリ変数を反復処理すると、即時実行が発生します。  これらの変換演算子には、<xref:System.Linq.Enumerable.ToList%2A>、<xref:System.Linq.Enumerable.ToArray%2A>、<xref:System.Linq.Enumerable.ToLookup%2A>、<xref:System.Linq.Enumerable.ToDictionary%2A> などがあります。  
+  
+## クエリの即時実行  
+ 一連の値を生成するクエリの遅延実行とは対照的に、シングルトン値を返すクエリは直ちに実行されます。  シングルトン クエリの例としては、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.First%2A>、<xref:System.Linq.Enumerable.Max%2A> があります。  これらのシングルトン クエリは、結果を計算するためにはシーケンスを生成する必要があるため、直ちに実行されます。  即時実行は強制することもできます。  これはクエリの結果をキャッシュする場合などに便利です。  クエリまたはクエリ変数で <xref:System.Linq.Enumerable.ToList%2A> メソッド、<xref:System.Linq.Enumerable.ToDictionary%2A> メソッド、または <xref:System.Linq.Enumerable.ToArray%2A> メソッドを呼び出すと、シングルトン値を生成しないクエリの即時実行を強制できます。  次の例では、<xref:System.Linq.Enumerable.ToArray%2A> メソッドを使用して、シーケンスを配列として即時評価します。  
+  
+ [!code-csharp[DP L2E Examples#ToArray](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#toarray)]
+ [!code-vb[DP L2E Examples#ToArray](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#toarray)]  
+  
+ また、`foreach` ループまたは `For Each` ループをクエリ式の直後に配置して実行を強制することも、<xref:System.Linq.Enumerable.ToList%2A> または <xref:System.Linq.Enumerable.ToArray%2A> を呼び出すことにより、単一のコレクション オブジェクト内のすべてのデータをキャッシュすることにより、実行を強制することもできます。  
+  
+## ストア実行  
+ 一般的に、LINQ to Entities の式はサーバー上で評価されるため、式の動作がデータ ソースのセマンティクスではなく、共通言語ランタイム \(CLR\) セマンティクスに従っているとは限りません。  ただし、これには式がクライアント上で実行された場合などの例外があります。  これは、サーバーとクライアントが異なるタイム ゾーンに存在する場合など、予期しない結果をもたらすことがあります。  
+  
+ クエリ内の一部の式はクライアント上で実行される場合があります。  通常、ほとんどのクエリ実行はサーバーで発生するものと見なされます。  データ ソースにマップされたクエリ要素に対して実行されたメソッドの他に、クエリにはローカルで実行できる式が含まれる場合がよくあります。  クエリ式のローカルでの実行では、クエリ実行または結果の作成で使用できる値が生成されます。  
+  
+ 値のバインド、サブ式、終了からのサブクエリ、およびクエリ結果へのオブジェクトの具体化などの特定の操作は、常にクライアントで実行されます。  その最終的な結果として、これらの要素 \(パラメーター値など\) は実行中には更新できなくなります。  匿名型は、データ ソースでインラインで作成できますが、必ずしもそれを想定することはできません。  インラインのグループはデータ ソースでも作成できますが、すべてのインスタンスでそれが可能であると見なすことはできません。  通常、サーバー上で何を作成できるかについて想定しないことが賢明です。  
+  
+ このセクションでは、コードをクライアント上でローカルに実行するシナリオについて説明します。  ローカルで実行される式の種類の詳細については、「[LINQ to Entities クエリ内の式](../../../../../../docs/framework/data/adonet/ef/language-reference/expressions-in-linq-to-entities-queries.md)」を参照してください。  
+  
+### リテラルとパラメーター  
+ 次の例に示した `orderID` 変数などのローカル変数は、クライアントで評価されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#LiteralParameter1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#literalparameter1)]
+ [!code-vb[DP L2E Conceptual Examples#LiteralParameter1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#literalparameter1)]  
+  
+ メソッド パラメーターもクライアントで評価されます。  下の `MethodParameterExample` メソッドに渡される `orderID` パラメーターがその例です。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#MethodParameterExample](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#methodparameterexample)]
+ [!code-vb[DP L2E Conceptual Examples#MethodParameterExample](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#methodparameterexample)]  
+  
+### クライアントでのリテラルのキャスト  
+ `null` から CLR 型へのキャストは、次のようにクライアントで実行されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#NullCastToString](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#nullcasttostring)]
+ [!code-vb[DP L2E Conceptual Examples#NullCastToString](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#nullcasttostring)]  
+  
+ Null 値が許容される <xref:System.Decimal> などの型へのキャストは、次のようにクライアントで実行されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CastToNullable](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#casttonullable)]
+ [!code-vb[DP L2E Conceptual Examples#CastToNullable](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#casttonullable)]  
+  
+### リテラルのコンストラクター  
+ 概念モデル型にマップできる新しい CLR 型は、次のようにクライアントで実行されます。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#ConstructorForLiteral](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#constructorforliteral)]
+ [!code-vb[DP L2E Conceptual Examples#ConstructorForLiteral](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#constructorforliteral)]  
+  
+ 新しい配列もクライアントで実行されます。  
+  
+## ストアの例外  
+ クエリ実行時に発生したストア エラーはすべてクライアントに渡され、マッピングも処理もされません。  
+  
+## ストアの構成  
+ ストアでクエリが実行される場合、ストアの構成はすべてのクライアント動作をオーバーライドし、ストア セマンティクスはすべての演算および式で表現されます。  これにより、Null 比較、GUID 順序付け、precise 以外のデータ型 \(浮動小数点型や <xref:System.DateTime> など\) を含む演算の精度や正確性、および文字列型演算などの領域において、CLR とストアの実行間で違いが発生する可能性があります。  クエリ結果を調べる場合にはこのことに留意することが重要です。  
+  
+ CLR および SQL Server 間での動作の違いの例を次に示します。  
+  
+-   SQL Server は CLR とは異なる方法で GUID を順序付けます。  
+  
+-   SQL Server で Decimal 型を扱う場合は、結果の精度でも差違が発生する場合もあります。  これは、SQL Server の decimal 型の固定有効桁数の要件によります。  たとえば、<xref:System.Decimal> 値 0.0、0.0、および 1.0 の平均は、クライアント上のメモリでは 0.3333333333333333333333333333 ですが、ストアでは 0.333333 です \(SQL Server の decimal 型の既定の有効桁数に基づきます\)。  
+  
+-   SQL Server では、一部の文字列比較演算も CLR とは異なった方法で処理されます。  文字列比較の動作は、サーバー上の照合順序の設定によって異なります。  
+  
+-   LINQ to Entities クエリに含まれる関数呼び出しまたはメソッド呼び出しは、Entity Framework の正規関数にマップされ、その後 Transact\-SQL に変換され、SQL Server データベースで実行されます。  マップされたこれらの関数が表す動作は、基本クラス ライブラリでの実装とは異なる場合もあります。  たとえば、空の文字列をパラメーターとして <xref:System.String.Contains%2A>, <xref:System.String.StartsWith%2A> メソッドおよび <xref:System.String.EndsWith%2A> メソッドを呼び出すと、CLR での実行では `true` が返されますが、SQL Server での実行では `false` が返されます。  また、末尾の空白のみが異なる 2 つの文字列は SQL Server では同じと見なされますが、CLR では同じではないと見なされるため、<xref:System.String.EndsWith%2A> メソッドは、異なる結果を返す場合があります。  この例を次に示します。  
+  
+ [!code-csharp[DP L2E Conceptual Examples#CanonicalFuncVsCLRBaseType](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Conceptual Examples/CS/Program.cs#canonicalfuncvsclrbasetype)]
+ [!code-vb[DP L2E Conceptual Examples#CanonicalFuncVsCLRBaseType](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Conceptual Examples/VB/Module1.vb#canonicalfuncvsclrbasetype)]
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-aggregate-operators.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-aggregate-operators.md
new file mode 100644
index 00000000000..15713616cf1
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-aggregate-operators.md
@@ -0,0 +1,102 @@
+---
+title: "クエリ式の構文例 : 集計演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d729120c-4c1b-4f34-bbe9-33694fca2dde
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : 集計演算子
+このトピックでは、クエリ式の構文で、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、および <xref:System.Linq.Enumerable.Sum%2A> の各メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Average  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、各スタイルの製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP L2E Examples#Average2_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#average2_mq)]
+ [!code-vb[DP L2E Examples#Average2_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#average2_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> を使用して、それぞれの連絡先 ID について平均合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#AverageGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#averagegrouped_mq)]
+ [!code-vb[DP L2E Examples#AverageGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#averagegrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Average%2A> を使用して、それぞれの連絡先について合計支払額が平均値の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#AverageElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#averageelements_mq)]
+ [!code-vb[DP L2E Examples#AverageElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#averageelements_mq)]  
+  
+## Count  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Count%2A> を使用して、連絡先 ID の一覧と、それぞれの注文数を返します。  
+  
+ [!code-csharp[DP L2E Examples#CountNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#countnested)]
+ [!code-vb[DP L2E Examples#CountNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#countnested)]  
+  
+### 例  
+ 次の例では、製品を色でグループ分けし、<xref:System.Linq.Enumerable.Count%2A> を使用してそれぞれの色グループに含まれる製品の数を返します。  
+  
+ [!code-csharp[DP L2E Examples#CountGrouped](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#countgrouped)]
+ [!code-vb[DP L2E Examples#CountGrouped](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#countgrouped)]  
+  
+## 最大  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について最大合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MaxGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#maxgrouped_mq)]
+ [!code-vb[DP L2E Examples#MaxGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#maxgrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額が最大の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MaxElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#maxelements_mq)]
+ [!code-vb[DP L2E Examples#MaxElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#maxelements_mq)]  
+  
+## 最小  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先 ID について最小合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MinGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#mingrouped_mq)]
+ [!code-vb[DP L2E Examples#MinGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#mingrouped_mq)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先について合計支払額が最小の注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#MinElements_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#minelements_mq)]
+ [!code-vb[DP L2E Examples#MinElements_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#minelements_mq)]  
+  
+## Sum  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額を取得します。  
+  
+ [!code-csharp[DP L2E Examples#SumGrouped_MQ](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#sumgrouped_mq)]
+ [!code-vb[DP L2E Examples#SumGrouped_MQ](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#sumgrouped_mq)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-element-operators.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-element-operators.md
new file mode 100644
index 00000000000..827d0239e88
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-element-operators.md
@@ -0,0 +1,40 @@
+---
+title: "クエリ式の構文例 : 要素演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 32268fe2-de18-4065-8060-f250def83837
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : 要素演算子
+このトピックでは、クエリ式の構文で、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## First  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、名が "Brooke" である最初の連絡先を取得します。  
+  
+ [!code-csharp[DP L2E Examples#FirstSimple](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#firstsimple)]
+ [!code-vb[DP L2E Examples#FirstSimple](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#firstsimple)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-filtering.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-filtering.md
new file mode 100644
index 00000000000..6277ffa4617
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-filtering.md
@@ -0,0 +1,77 @@
+---
+title: "クエリ式の構文例: フィルター処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c27cb89c-1c1d-4988-9f38-950eda3cb275
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例: フィルター処理
+このトピックでは、クエリ式の構文で、`Where` メソッドおよび `Where…Contains` メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  `Where Contains` は[コンパイル済みクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md)の中では使用できないことに注意してください。  
+  
+ これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Where  
+  
+### 例  
+ 次の例では、すべてのオンライン注文が返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where1)]
+ [!code-vb[DP L2E Examples#Where1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where1)]  
+  
+### 例  
+ 次の例では、注文数量が 3 個以上で 5 個以下の注文が返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where2)]
+ [!code-vb[DP L2E Examples#Where2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where2)]  
+  
+### 例  
+ 次の例では、色が赤の製品がすべて返されます。  
+  
+ [!code-csharp[DP L2E Examples#Where3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#where3)]
+ [!code-vb[DP L2E Examples#Where3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#where3)]  
+  
+### 例  
+ 次の例では、`Where` メソッドを使用して、2003 年 12 月 1 日以降に受けた注文を検索します。次に、`order.SalesOrderDetail` ナビゲーション プロパティを使用して、各注文の詳細を取得します。  
+  
+ [!code-csharp[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#wherenavproperty)]
+ [!code-vb[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#wherenavproperty)]  
+  
+## Where…Contains  
+  
+### 例  
+ 次の例では、配列を `Where Contains` 句の一部として使用し、その配列内の値と一致する `ProductModelID` を持つすべての製品を検出します。  
+  
+ [!code-csharp[DP L2E ArraysAndListsInQueries#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e arraysandlistsinqueries/cs/program.cs#1)]
+ [!code-vb[DP L2E ArraysAndListsInQueries#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e arraysandlistsinqueries/vb/module1.vb#1)]  
+  
+> [!NOTE]
+>  `Where Contains` 句の述語として、<xref:System.Array>、<xref:System.Collections.Generic.List%601>、または <xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装する任意の型のコレクションを使用できます。  さらに、LINQ to Entities クエリ内でコレクションを宣言および初期化できます。  詳細については、次の例を参照してください。  
+  
+### 例  
+ 次の例では、`Where Contains` 句で配列を宣言および初期化し、その配列内の値と一致する `ProductModelID` または `Size` を持つすべての製品を検出します。  
+  
+ [!code-csharp[DP L2E ArraysAndListsInQueries#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp l2e arraysandlistsinqueries/cs/program.cs#2)]
+ [!code-vb[DP L2E ArraysAndListsInQueries#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/dp l2e arraysandlistsinqueries/vb/module1.vb#2)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-grouping.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-grouping.md
new file mode 100644
index 00000000000..4d7819ec424
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-grouping.md
@@ -0,0 +1,50 @@
+---
+title: "クエリ式の構文例 : グループ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 2d83d7c0-b3be-4c92-a630-25cd1285de31
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : グループ化
+このトピックでは、クエリ式の構文で、`GroupBy` メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## 例  
+ 次の例では、郵便番号でグループ化された `Address` オブジェクトを返します。  結果は匿名型に射影されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupBySimple3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbysimple3)]
+ [!code-vb[DP L2E Examples#GroupBySimple3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbysimple3)]  
+  
+## 例  
+ 次の例では、`Contact` オブジェクトを、連絡先の姓の先頭文字でグループ化して返します。  結果は姓の先頭文字で並べ替えられ、匿名型に射影されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupBySimple2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbysimple2)]
+ [!code-vb[DP L2E Examples#GroupBySimple2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbysimple2)]  
+  
+## 例  
+ 次の例では、顧客 ID でグループ化された `SalesOrderHeader` オブジェクトが返されます。  顧客ごとの販売数も返されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupByCount](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupbycount)]
+ [!code-vb[DP L2E Examples#GroupByCount](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupbycount)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-join-operators.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-join-operators.md
new file mode 100644
index 00000000000..26982b596e3
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-join-operators.md
@@ -0,0 +1,62 @@
+---
+title: "クエリ式の構文例 : 結合演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 343e8dda-70b2-409d-9334-ce9a880c3cea
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : 結合演算子
+結合は、リレーショナル データベース テーブルのように互いにナビゲート可能なリレーションシップを持たないデータ ソースをターゲットとするクエリにおいて重要な操作です。  2 つのデータ ソースを結合する操作とは、あるデータ ソース内のオブジェクトを、他方のデータ ソース内で共通の属性を持つオブジェクトと関連付けることです。  詳細については、「[Standard Query Operators Overview](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+ このトピックでは、クエリ式の構文で、<xref:System.Linq.Enumerable.GroupJoin%2A> メソッドおよび <xref:System.Linq.Enumerable.Join%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## GroupJoin  
+  
+### 例  
+ 次の例では、SalesOrderHeader テーブルおよび SalesOrderDetail テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行することによって、顧客ごとの注文数を調べます。  GroupJoin は、左外部結合に相当します。つまり、1 つ目 \(左側\) のデータ ソースに存在するすべての要素は、関連する要素がもう一方のデータ ソースに存在するかどうかに関係なく返されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupJoin2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupjoin2)]
+ [!code-vb[DP L2E Examples#GroupJoin2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupjoin2)]  
+  
+### 例  
+ 次の例では、Contact テーブルおよび SalesOrderHeader テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行して、連絡先ごとの注文数を調べます。  各連絡先の注文数と ID が表示されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupJoin](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupjoin)]
+ [!code-vb[DP L2E Examples#GroupJoin](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupjoin)]  
+  
+### 例  
+ 次の例では、Contact テーブルと SalesOrderHeader テーブルの <xref:System.Linq.Enumerable.GroupJoin%2A> を実行します。  GroupJoin は、左外部結合に相当します。つまり、1 つ目 \(左側\) のデータ ソースに存在するすべての要素は、関連する要素がもう一方のデータ ソースに存在するかどうかに関係なく返されます。  
+  
+ [!code-csharp[DP L2E Examples#GroupJoin](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#groupjoin)]
+ [!code-vb[DP L2E Examples#GroupJoin](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#groupjoin)]  
+  
+## Join  
+  
+### 例  
+ 次の例では、SalesOrderHeader テーブルと SalesOrderDetail テーブルを結合し、8 月以降のオンラインでの注文を取得します。  
+  
+ [!code-csharp[DP L2E Examples#Join](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#join)]
+ [!code-vb[DP L2E Examples#Join](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#join)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-navigating-relationships.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-navigating-relationships.md
new file mode 100644
index 00000000000..1538b6ed557
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-navigating-relationships.md
@@ -0,0 +1,58 @@
+---
+title: "クエリ式の構文例 : リレーションシップのナビゲーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 0d4a7f41-c758-4059-8f83-d2e9c2745593
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# クエリ式の構文例 : リレーションシップのナビゲーション
+[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] のナビゲーション プロパティは、アソシエーションの末尾にあるエンティティを見つけるために使用できるショートカット プロパティです。  ナビゲーション プロパティを使用すると、ユーザーは、エンティティ間をナビゲートしたり、あるエンティティからアソシエーション セットを介して関連エンティティにナビゲートしたりできます。  このトピックでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリ内でナビゲーション プロパティを介してリレーションシップをナビゲートするためのクエリ式の構文例を示します。  
+  
+ これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## 例  
+ 次の例では、<xref:System.Linq.Queryable.Select%2A> メソッドを使用して、姓が "Zhou" である連絡先のすべての連絡先 ID と、各連絡先の合計支払額の総計を取得します。  `Contact.SalesOrderHeader` ナビゲーション プロパティは、各連絡先の `SalesOrderHeader` オブジェクトのコレクションを取得するために使用されます。  `Sum` メソッドは、`Contact.SalesOrderHeader` ナビゲーション プロパティを使用して、それぞれの連絡先のすべての注文の合計支払額を合計します。  
+  
+ [!code-csharp[DP L2E Examples#SelectEachContactsOrders2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selecteachcontactsorders2)]
+ [!code-vb[DP L2E Examples#SelectEachContactsOrders2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selecteachcontactsorders2)]  
+  
+## 例  
+ 次の例では、姓が "Zhou" である連絡先のすべての注文を取得します。  `Contact.SalesOrderHeader` ナビゲーション プロパティは、各連絡先の `SalesOrderHeader` オブジェクトのコレクションを取得するために使用されます。  連絡先の名前と注文が匿名型で返されます。  
+  
+ [!code-csharp[DP L2E Examples#SelectEachContactsOrders3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selecteachcontactsorders3)]
+ [!code-vb[DP L2E Examples#SelectEachContactsOrders3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selecteachcontactsorders3)]  
+  
+## 例  
+ 次の例では、`SalesOrderHeader.Address` ナビゲーション プロパティと `SalesOrderHeader.Contact` ナビゲーション プロパティを使用して、互いに関連付けられている `Address` オブジェクトと `Contact` オブジェクトのコレクションを取得します。  各注文の連絡先の姓、住所、販売注文番号、および Seattle 市に対する合計支払額が匿名型で返されます。  
+  
+ [!code-csharp[DP L2E Examples#GetOrderInfoThruRelationships](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#getorderinfothrurelationships)]
+ [!code-vb[DP L2E Examples#GetOrderInfoThruRelationships](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#getorderinfothrurelationships)]  
+  
+### 例  
+ 次の例では、`Where` メソッドを使用して、2003 年 12 月 1 日以降に受けた注文を検索します。次に、`order.SalesOrderDetail` ナビゲーション プロパティを使用して、各注文の詳細を取得します。  
+  
+ [!code-csharp[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#wherenavproperty)]
+ [!code-vb[DP L2E Examples#WhereNavProperty](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#wherenavproperty)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-ordering.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-ordering.md
new file mode 100644
index 00000000000..693d349b98d
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-ordering.md
@@ -0,0 +1,70 @@
+---
+title: "クエリ式の構文例 : 並べ替え | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bcbc9625-7cf7-476e-85d2-058f12682f54
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : 並べ替え
+このトピックでは、クエリ式の構文で、`OrderBy` メソッドおよび `OrderByDescending` メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## OrderBy  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.OrderBy%2A> を使用して、姓の順に並べ替えられた連絡先の一覧を返します。  
+  
+ [!code-csharp[DP L2E Examples#OrderBySimple1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#orderbysimple1)]
+ [!code-vb[DP L2E Examples#OrderBySimple1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#orderbysimple1)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.OrderBy%2A> を使用して、連絡先の一覧を姓の長さの順に並べ替えます。  
+  
+ [!code-csharp[DP L2E Examples#OrderBySimple2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#orderbysimple2)]
+ [!code-vb[DP L2E Examples#OrderBySimple2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#orderbysimple2)]  
+  
+## OrderByDescending  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.OrderByDescending%2A> メソッドと同等の `orderbyc descending` \(Visual Basic の場合は `Order By c Descending`\) を使用して、価格の一覧を高いものから低い順に並べ替えます。  
+  
+ [!code-csharp[DP L2E Examples#OrderByDescendingSimple1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#orderbydescendingsimple1)]
+ [!code-vb[DP L2E Examples#OrderByDescendingSimple1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#orderbydescendingsimple1)]  
+  
+## ThenBy  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Queryable.OrderBy%2A> と <xref:System.Linq.Queryable.ThenBy%2A> を使用して、姓の順、次に名の順に並べ替えられた連絡先の一覧を返します。  
+  
+ [!code-csharp[DP L2E Examples#OrderByThenBy](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#orderbythenby)]
+ [!code-vb[DP L2E Examples#OrderByThenBy](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#orderbythenby)]  
+  
+## ThenByDescending  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.ThenByDescending%2A> メソッドと同等の `OrderByc Descending` を使用して、製品の一覧を、名前順に、次に表示価格の高いものから低い順に並べ替えます。  
+  
+ [!code-csharp[DP L2E Examples#ThenByDescendingSimple](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#thenbydescendingsimple)]
+ [!code-vb[DP L2E Examples#ThenByDescendingSimple](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#thenbydescendingsimple)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-partitioning.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-partitioning.md
new file mode 100644
index 00000000000..1e2c1f6ca0d
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-partitioning.md
@@ -0,0 +1,48 @@
+---
+title: "クエリ式の構文例 : パーティション分割 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 7e41aed0-3be9-4f75-98de-860a85552a3c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : パーティション分割
+このトピックでは、クエリ式の構文で、<xref:System.Linq.Enumerable.Skip%2A> メソッドおよび <xref:System.Linq.Enumerable.Take%2A> メソッドを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Skip  
+  
+### 例  
+ 次の例では、Seattle から最初の 2 つを除くすべての住所を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#SkipNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#skipnested)]
+ [!code-vb[DP L2E Examples#SkipNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#skipnested)]  
+  
+## Take  
+  
+### 例  
+ 次の例では、Seattle から最初の 3 つの住所を、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP L2E Examples#TakeNested](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#takenested)]
+ [!code-vb[DP L2E Examples#TakeNested](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#takenested)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-projection.md b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-projection.md
new file mode 100644
index 00000000000..1b77039e69b
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expression-syntax-examples-projection.md
@@ -0,0 +1,72 @@
+---
+title: "クエリ式の構文例 : 射影 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 079926c5-e6b5-4fb9-b4cf-9c63886dd626
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ式の構文例 : 射影
+このトピックでは、クエリ式の構文で、`Select` メソッドおよび `From c From c`  キーワードを使用して、[AdventureWorks Sales Model](http://msdn.microsoft.com/ja-jp/f16cd988-673f-4376-b034-129ca93c7832) を照会する例を取り上げます。  `From c From c` は、メソッドは、`SelectMany` メソッドのクエリ ベース版に相当します。  これらの例で使用されている、AdventureWorks Sales Model は、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルから作成されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP L2E Examples#ImportsUsing](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#importsusing)]  
+  
+## Select  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Select%2A> メソッドを使用して `Product` テーブルからすべての行を取得し、製品名を表示しています。  
+  
+ [!code-csharp[DP L2E Examples#SelectSimple1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectsimple1)]
+ [!code-vb[DP L2E Examples#SelectSimple1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectsimple1)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Enumerable.Select%2A> を使用して、一連の製品名だけを取得しています。  
+  
+ [!code-csharp[DP L2E Examples#SelectSimple2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectsimple2)]
+ [!code-vb[DP L2E Examples#SelectSimple2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectsimple2)]  
+  
+### 例  
+ 次の例では、<xref:System.Linq.Queryable.Select%2A> メソッドを使用して、`Product.Name` プロパティおよび `Product.ProductID` プロパティを一連の匿名型に射影します。  
+  
+ [!code-csharp[DP L2E Examples#SelectAnonymousTypes](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectanonymoustypes)]
+ [!code-vb[DP L2E Examples#SelectAnonymousTypes](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectanonymoustypes)]  
+  
+## From … From … \(SelectMany\)  
+  
+### 例  
+ 次の例では、`From c From c` \(<xref:System.Linq.Enumerable.SelectMany%2A> メソッドと等価\) を使用して、`TotalDue` が 500.00 に満たないすべての注文を選択します。  
+  
+ [!code-csharp[DP L2E Examples#SelectManyCompoundFrom](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectmanycompoundfrom)]
+ [!code-vb[DP L2E Examples#SelectManyCompoundFrom](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectmanycompoundfrom)]  
+  
+### 例  
+ 次の例では、`From c From c` \(<xref:System.Linq.Enumerable.SelectMany%2A> メソッドと等価\) を使用して、2002 年 10 月 1 日以降に受けたすべての注文を選択します。  
+  
+ [!code-csharp[DP L2E Examples#SelectManyCompoundFrom2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectmanycompoundfrom2)]
+ [!code-vb[DP L2E Examples#SelectManyCompoundFrom2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectmanycompoundfrom2)]  
+  
+### 例  
+ 次の例では、`From c From c` \(<xref:System.Linq.Enumerable.SelectMany%2A> メソッドと等価\) を使用して、注文の合計が 10000.00 を超えるすべての注文を選択します。このとき、`From` 割り当てを使用して、合計を 2 回要求しないようにしています。  
+  
+ [!code-csharp[DP L2E Examples#SelectManyFromAssignment](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Examples/CS/Program.cs#selectmanyfromassignment)]
+ [!code-vb[DP L2E Examples#SelectManyFromAssignment](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Examples/VB/Module1.vb#selectmanyfromassignment)]  
+  
+## 参照  
+ [LINQ to Entities でのクエリ](../../../../../../docs/framework/data/adonet/ef/language-reference/queries-in-linq-to-entities.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md
new file mode 100644
index 00000000000..b023853231c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md
@@ -0,0 +1,33 @@
+---
+title: "クエリ式 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c36f327b-e230-48d4-bbd5-78dc6478c447
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# クエリ式 (Entity SQL)
+クエリ式とは、さまざまなクエリ演算子を組み合わせて 1 つの構文にしたものです。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、[リテラル](../../../../../../docs/framework/data/adonet/ef/language-reference/literals-entity-sql.md)、[パラメーター](../../../../../../docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md)、[変数](../../../../../../docs/framework/data/adonet/ef/language-reference/variables-entity-sql.md)、演算子、[関数](../../../../../../docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md)、set 演算子などのさまざまな種類の式が用意されています。  詳細については、「[Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)」を参照してください。  
+  
+## 句  
+ クエリ式は、オブジェクトのコレクションに連続した操作を適用する一連の句で構成されます。  それらは [SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)、[FROM](../../../../../../docs/framework/data/adonet/ef/language-reference/from-entity-sql.md)、[WHERE](../../../../../../docs/framework/data/adonet/ef/language-reference/where-entity-sql.md)、[GROUP BY](../../../../../../docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md)、[HAVING](../../../../../../docs/framework/data/adonet/ef/language-reference/having-entity-sql.md)、および [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) など、標準の SQL SELECT ステートメントにあるものと同じ句に基づきます。  
+  
+## スコープ  
+ FROM 句で定義された名前は、出現順 \(左から右の順\) に FROM スコープに導入されます。  JOIN リストでは、式は既にリストで定義されている名前を参照できます。  FROM 句で指定された要素のパブリック プロパティは FROM スコープには追加されません。それらは常に別名で修飾された名前で参照する必要があります。  通常は、SELECT 式のすべての部分が FROM スコープに含まれると見なされます。  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-plan-caching-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/query-plan-caching-entity-sql.md
new file mode 100644
index 00000000000..c7cafea3f04
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-plan-caching-entity-sql.md
@@ -0,0 +1,63 @@
+---
+title: "クエリ プランのキャッシュ (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 90b0c685-5ef2-461b-98b4-c3c0a2b253c7
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# クエリ プランのキャッシュ (Entity SQL)
+クエリの実行が試行されると、クエリ パイプラインではそのクエリ プランのキャッシュを検索し、同じクエリが既にコンパイルされ使用可能になっているかどうかを確認します。  使用可能になっている場合は、新しいクエリを構築する代わりに、キャッシュされたプランを再利用します。  クエリ プランのキャッシュ内に一致するものが見つからない場合は、クエリがコンパイルされ、キャッシュされます。  クエリはその [!INCLUDE[esql](../../../../../../includes/esql-md.md)] テキストとパラメーターのコレクション \(名前と型\) によって識別されます。  テキストの比較では、常に大文字と小文字が区別されます。  
+  
+## 構成  
+ クエリ プランのキャッシュは <xref:System.Data.EntityClient.EntityCommand> を使用して構成できます。  
+  
+ <xref:System.Data.EntityClient.EntityCommand.EnablePlanCaching%2A?displayProperty=fullName> でクエリ プランのキャッシュを有効または無効にするには、このプロパティを `true` または `false` に設定します。  2 回以上使用する予定がない個別の動的クエリ プランのキャッシュを無効にすると、パフォーマンスが向上します。  
+  
+ <xref:System.Data.Objects.ObjectQuery.EnablePlanCaching%2A> を使用してクエリ プランのキャッシュを有効にできます。  
+  
+## 推奨される使用方法  
+ 一般的に、動的クエリは避けてください。  次の動的クエリ例は、検証を行わずにユーザー入力をそのまま受け入れるので、SQL インジェクション攻撃に対して脆弱です。  
+  
+ `"SELECT sp.SalesYTD FROM AdventureWorksEntities.SalesPerson as sp WHERE sp.EmployeeID = " + employeeTextBox.Text;`  
+  
+ 動的に生成されたクエリを使用する場合は、再利用される可能性の低いキャッシュ エントリのためにメモリが不必要に消費されないように、クエリ プランのキャッシュを無効にすることをお勧めします。  
+  
+ 静的クエリおよびパラメーター化クエリに対してクエリ プランをキャッシュすると、パフォーマンスが向上します。  以下は、静的クエリの例です。  
+  
+```  
+"SELECT sp.SalesYTD FROM AdventureWorksEntities.SalesPerson as sp";  
+```  
+  
+ クエリ プランのキャッシュでクエリを適切に一致させるには、次の要件に従う必要があります。  
+  
+-   クエリ テキストは定数パターンにする必要があり、最も望ましいのは定数文字列またはリソースです。  
+  
+-   ユーザーが指定した値を渡す必要があるときは、<xref:System.Data.EntityClient.EntityParameter> または <xref:System.Data.Objects.ObjectParameter> を使用します。  
+  
+ クエリ プランのキャッシュ内のスロットを必要以上に消費する次のようなクエリ パターンは避けます。  
+  
+-   テキストの大文字または小文字の変更  
+  
+-   空白への変更  
+  
+-   リテラル値への変更  
+  
+-   コメント内のテキストの変更  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/query-results.md b/docs/framework/data/adonet/ef/language-reference/query-results.md
new file mode 100644
index 00000000000..82f206d387c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/query-results.md
@@ -0,0 +1,48 @@
+---
+title: "クエリ結果 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bcd7b699-4e50-4523-8c33-2f54a103d94e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# クエリ結果
+[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリをコマンド ツリーに変換して実行すると、通常、次のいずれかの形でクエリの結果が返されます。  
+  
+-   0 個以上の型指定されたエンティティ オブジェクトのコレクション、または概念モデルの複合型のプロジェクション。  
+  
+-   概念モデルでサポートされる CLR 型。  
+  
+-   インライン コレクション。  
+  
+-   匿名型。  
+  
+ データ ソースに対してクエリを実行すると、その結果は CLR 型に具体化されてクライアントに返されます。  オブジェクトの具体化は、すべて [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] によって実行されます。  [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] と CLR の間のマッピングができないことが原因でエラーが発生すると、オブジェクトの具体化中に例外がスローされます。  
+  
+ プリミティブ概念モデル型を返すクエリを実行した場合、その結果は、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] から切り離されたスタンドアロンの CLR 型で構成されます。  ただし、クエリが <xref:System.Data.Objects.ObjectQuery%601> によって表されるエンティティ オブジェクトのコレクションを返す場合、これらの型はオブジェクト コンテキストによって追跡されます。  オブジェクトの動作 \(子\/親のコレクション、変更の追跡、多態性など\) は、すべて [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] で定義されます。  この機能は、[!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] での定義に従い仕様範囲内で使用できます。詳細については、「[オブジェクトの使用](../../../../../../docs/framework/data/adonet/ef/working-with-objects.md)」を参照してください。  
+  
+ クエリから返される構造型 \(匿名型、NULL 値が許容される複合型など\) は、`null` 値になります。  返されたエンティティの <xref:System.Data.Objects.DataClasses.EntityCollection%601> プロパティも `null` 値になります。  これは、要素を持たない <xref:System.Data.Objects.ObjectQuery%601> に対する <xref:System.Linq.Queryable.FirstOrDefault%2A> の呼び出しなど、`null` 値になっているエンティティのコレクション プロパティが投影されるためです。  
+  
+ 場合によっては、特定のクエリで実行中に具体化された結果が生成されることもありますが、クエリはサーバー上で実行され、CLR でエンティティ オブジェクトが具体化されることはありません。  オブジェクトが具体化された場合、その結果に依存すると、問題が発生する可能性があります。  
+  
+ 次の例には、`LastName` プロパティがあるカスタム クラス `MyContact` が含まれています。  `LastName` プロパティを設定すると、`count` 変数が増加します。  次の 2 つのクエリを実行した場合、最初のクエリによって `count` が増加しますが、2 つ目のクエリでは増加しません。  これは、ストアでクエリを実行する必要がないため、2 つ目のクエリで結果から `LastName` プロパティが投影され、`MyContact` クラスが作成されないことが、その理由です。  
+  
+ [!code-csharp[DP L2E Materialization Example#MaterializationSideEffects](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Materialization Example/CS/Program.cs#materializationsideeffects)]
+ [!code-vb[DP L2E Materialization Example#MaterializationSideEffects](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Materialization Example/VB/Module1.vb#materializationsideeffects)]  
+  
+ [!code-csharp[DP L2E Materialization Example#MyContactClass](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DP L2E Materialization Example/CS/Program.cs#mycontactclass)]
+ [!code-vb[DP L2E Materialization Example#MyContactClass](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP L2E Materialization Example/VB/Module1.vb#mycontactclass)]
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md
new file mode 100644
index 00000000000..66dda498c71
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md
@@ -0,0 +1,59 @@
+---
+title: "REF (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c5f4cb35-69e9-44cc-b63b-ee38922bbda1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# REF (Entity SQL)
+エンティティ インスタンスへの参照を返します。  
+  
+## 構文  
+  
+```  
+  
+REF( expression )   
+```  
+  
+## 引数  
+ `expression`  
+ エンティティ型のインスタンスを生成する任意の有効な式。  
+  
+## 戻り値  
+ 指定されたエンティティ インスタンスへの参照。  
+  
+## 解説  
+ エンティティ参照は、エンティティ キーとエンティティ セット名で構成されます。 異なるエンティティ セットが同じエンティティ型に基づくことができるので、特定のエンティティ キーが複数のエンティティ セットで使用される場合があります。 ただし、エンティティ参照は常に一意です。 入力式が永続エンティティを表す場合、このエンティティへの参照が返されます。 入力式が永続エンティティではない場合は、NULL 参照が返されます。  
+  
+ プロパティ抽出演算子 \(.\) を使用してエンティティのプロパティにアクセスすると、参照は自動的に逆参照されます。  
+  
+## 使用例  
+ 次の Entity SQL クエリは、REF 演算子を使用して入力エンティティ引数の参照を返します。 プロパティ抽出演算 \(.\) を使用して Product エンティティのプロパティにアクセスすることにより、同じクエリでこの参照が逆参照されます。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#REF](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#ref)]  
+  
+## 参照  
+ [DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md)   
+ [CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md)   
+ [KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [型定義](../../../../../../docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/row-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/row-entity-sql.md
new file mode 100644
index 00000000000..75a8f1c2dc3
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/row-entity-sql.md
@@ -0,0 +1,73 @@
+---
+title: "ROW (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 06da96e8-55d7-486c-991a-4e514d837ff9
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ROW (Entity SQL)
+1 つまたは複数の値から構造的に型付けされた匿名レコードを構築します。  
+  
+## 構文  
+  
+```  
+  
+ROW (expression [ AS alias ] [,...] )  
+```  
+  
+## 引数  
+ `expression`  
+ 行型で構築する値を返す任意の有効なクエリ式。  
+  
+ `alias`  
+ 行型で指定された値の別名を指定します。 別名を指定しないと、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 別名生成規則に基づいて別名の生成を試みます。  
+  
+## 戻り値  
+ 行型。  
+  
+## 解説  
+ 1 つまたは複数の値から構造的に型付けされた匿名レコードを構築するには、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の行コンストラクターを使用します。 行コンストラクターの結果の型は、行の構築に使用された値の型に対応するフィールド型を持つ行型です。 たとえば、次の式は  `Record(a int, b string, c int)` 型の値を構築します。  
+  
+```  
+ROW(1 AS a, "abc" AS b, a+34 AS c)  
+```  
+  
+ 行コンストラクターで式の別名が指定されていなければ、Entity Framework は別名の生成を試みます。 詳細については、「[識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md)」トピックの「別名規則」セクションを参照してください。  
+  
+ 次の規則は、行コンストラクターで別名を定義する式に適用されます。  
+  
+-   行コンストラクターの式で同じコンストラクターの他の別名を参照することはできません。  
+  
+-   同じ行コンストラクター内の 2 つの式に同じ別名を指定することはできません。  
+  
+ クエリ コンストラクターについて詳しくは、「[コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリは ROW 演算子を使用して、構造的に型付けされた匿名レコードを構築します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#ROW](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#row)]  
+  
+## 参照  
+ [コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [型定義](../../../../../../docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/select-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/select-entity-sql.md
new file mode 100644
index 00000000000..76c1629c904
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/select-entity-sql.md
@@ -0,0 +1,119 @@
+---
+title: "SELECT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 9a33bd0d-ded1-41e7-ba3c-305502755e3b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SELECT (Entity SQL)
+クエリで返される要素を指定します。  
+  
+## 構文  
+  
+```  
+  
+SELECT [ ALL | DISTINCT ] [ topSubclause ] aliasedExpr   
+      [{ , aliasedExpr }] FROM fromClause [ WHERE whereClause ] [ GROUP BY groupByClause [ HAVING havingClause ] ] [ ORDER BY orderByClause ]  
+or  
+SELECT VALUE [ ALL | DISTINCT ] [ topSubclause ] expr FROM fromClause [ WHERE whereClause ] [ GROUP BY groupByClause [ HAVING havingClause ] ] [ ORDER BY orderByClause  
+```  
+  
+## 引数  
+ ALL  
+ 結果セットに重複を含むことを指定します。 ALL は既定値です。  
+  
+ DISTINCT  
+ 結果セットに一意な結果のみを含むことを指定します。  
+  
+ VALUE  
+ 1 つの項目のみを指定でき、row ラッパーを追加しません。  
+  
+ `topSubclause`  
+ `top (` `expr` `)` の形式で、クエリから返す最初の結果数を指定する有効な式。  
+  
+ [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) 演算子の LIMIT パラメーターにより、結果セットの最初の n 項目を選ぶこともできます。  
+  
+ `aliasedExpr`  
+ 次の形式の式。  
+  
+ `expr` は、`identifier` &#124; `expr` として示されます。  
+  
+ `expr`  
+ リテラルまたは式。  
+  
+## 解説  
+ [FROM](../../../../../../docs/framework/data/adonet/ef/language-reference/from-entity-sql.md)、[GROUP BY](../../../../../../docs/framework/data/adonet/ef/language-reference/group-by-entity-sql.md)、[HAVING](../../../../../../docs/framework/data/adonet/ef/language-reference/having-entity-sql.md) 句が評価された後に、SELECT 句が評価されます。 SELECT 句は、FROM 句または外側のスコープから現在スコープ内にある項目のみを参照できます。 GROUP BY 句を指定した場合、SELECT 句は GROUP BY キーの別名のみを参照できます。 FROM 句の項目への参照は、集計関数でのみ実行できます。  
+  
+ SELECT キーワードの後に続く 1 つまたは複数のクエリ式の一覧は、選択リスト \(旧称、投影\) と呼びます。 投影のより一般的な形式は、単一クエリ式です。 次の例に示すように、コレクション `member1`  からメンバー `collection1`を選択すると、 `member1`  の各オブジェクトに対応するすべての `collection1`値の新しいコレクションが生成されます。  
+  
+```  
+SELECT collection1.member1 FROM collection1  
+```  
+  
+ たとえば、 `customers`  が、タイプ `Customer` のコレクションで、このコレクションに、タイプ  `Name`  であるプロパティ`string`が含まれる場合、 `Name` から `customers` を選択すると、文字列のコレクションが返されます。  
+  
+```  
+SELECT customers.Name FROM customers AS c  
+```  
+  
+ JOIN 構文 \(FULL、INNER、LEFT、OUTER、ON、および RIGHT\) を使用することもできます。 内部結合に対しては ON が必要ですが、クロス結合に対しては ON を使用できません。  
+  
+## ROW 句および VALUE SELECT 句  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] は、SELECT 句の 2 つのバリアントをサポートします。 最初のバリアント、row select は、SELECT キーワードによって識別され、このバリアントを使用して、投影する必要がある 1 つまたは複数の値を指定できます。 row ラッパーは、返された値の前後に暗黙的に追加されるため、クエリ式の結果は常に、行のマルチセットになります。  
+  
+ row select の各クエリ式は、別名を指定する必要があります。 別名を指定しないと、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] は別名生成規則を使用して別名の生成を試みます。  
+  
+ SELECT 句のもう 1 つのバリアント、value select は SELECT VALUE キーワードによって識別されます。 このバリアントは、1 つの値のみを指定でき、row ラッパーを追加しません。  
+  
+ 次の例に示すように、row select は常に VALUE SELECT として表現できます。  
+  
+```  
+SELECT 1 AS a, "abc" AS b FROM C  
+SELECT VALUE ROW(1 AS a, "abc" AS b) FROM C   
+```  
+  
+## ALL 修飾子および DISTINCT 修飾子  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] の SELECT のどちらのバリアントも ALL 修飾子または DISTINCT 修飾子を指定できます。 DISTINCT 修飾子を指定した場合、SELECT 句まで \(SELECT 句を含めて\) のクエリ式によって生成されたコレクションから重複が除外されます。 ALL 修飾子が指定された場合、重複は除外されません。ALL 修飾子は既定値です。  
+  
+## Transact\-SQL との違い  
+ Transact\-SQL とは異なり、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では SELECT 句で \* 引数を使用できません。  代わりに、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、次の例に示すように、FROM 句からコレクションの別名を参照して、レコード全体にクエリを投影できます。  
+  
+```  
+SELECT * FROM T1, T2  
+```  
+  
+ 上の [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] クエリ式は次の方法で [!INCLUDE[esql](../../../../../../includes/esql-md.md)] で表現されます。  
+  
+```  
+SELECT a1, a2 FROM T1 AS a1, T2 AS a2  
+```  
+  
+## 使用例  
+ 次の Entity SQL クエリは、SELECT 演算子を使用して、クエリによって返される要素を指定します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#LESS](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#less)]  
+  
+## 参照  
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/set-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/set-entity-sql.md
new file mode 100644
index 00000000000..39300fba8cb
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/set-entity-sql.md
@@ -0,0 +1,57 @@
+---
+title: "SET (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 28b4deac-c7e4-4f09-b428-4d352ef2dc94
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# SET (Entity SQL)
+SET 式は、重複する要素をすべて除外した新しいコレクションを生成することによって、オブジェクトのコレクションを 1 つの集合に変換します。  
+  
+## 構文  
+  
+```  
+  
+SET (expression)  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションを返す任意の有効なクエリ式。  
+  
+## 解説  
+ 集合式 `SET(c)` は、論理上、次の select ステートメントと等価です。  
+  
+```  
+SELECT VALUE DISTINCT c FROM c  
+```  
+  
+ `SET` は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、SET 式を使用して、オブジェクトのコレクションを 1 つの集合に変換します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#SET](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#set)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md
new file mode 100644
index 00000000000..33aa5e2c4f8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md
@@ -0,0 +1,55 @@
+---
+title: "SKIP (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: e2139412-8ea4-451b-8f10-91af18dfa3ec
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SKIP (Entity SQL)
+物理的なページングは、ORDER BY 句の SKIP サブ句を使用して実行できます。 SKIP を ORDER BY 句と切り離して使用することはできません。  
+  
+## 構文  
+  
+```  
+  
+[ SKIP n ]  
+```  
+  
+## 引数  
+ `n`  
+ スキップするアイテムの数。  
+  
+## 解説  
+ SKIP 式のサブ句が ORDER BY 句に存在する場合、結果は並べ替え順序に従って並べ替えられ、結果セットには SKIP 式の直後の行から始まる行が含まれます。 たとえば、SKIP 5 は、先頭の 5 行をスキップし、6 行目以降を返します。  
+  
+> [!NOTE]
+>  TOP 修飾子と SKIP サブ句が同じクエリ式内に存在する場合、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリは無効です。 TOP 式を LIMIT 式に変更してクエリを記述し直す必要があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[ssVersion2000](../../../../../../includes/ssversion2000-md.md)] では、キー以外の列で ORDER BY と共に SKIP を使用すると、不適切な結果が返される場合があります。 キー以外の列に重複するデータが存在する場合、指定された数を超える行はスキップされます。 これは、[!INCLUDE[ssVersion2000](../../../../../../includes/ssversion2000-md.md)] 用に SKIP が変換される方法によるものです。 たとえば、次のコードでは、`E.NonKeyColumn` に重複値が存在する場合、5 行を超える行はスキップされます。  
+>   
+>  `SELECT [E] FROM Container.EntitySet AS [E] ORDER BY [E].[NonKeyColumn] DESC SKIP 5L`  
+  
+ [この](https://msdn.microsoft.com/library/bb738702\(v=vs.100\).aspx#_ESQL)例の中の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、SELECT ステートメントで返されたオブジェクトの並べ替え順序の指定に ORDER BY 演算子を SKIP と共に使用します。  
+  
+## 参照  
+ [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md)   
+ [クエリの結果をページングする方法](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)   
+ [ページング](../../../../../../docs/framework/data/adonet/ef/language-reference/paging-entity-sql.md)   
+ [TOP](../../../../../../docs/framework/data/adonet/ef/language-reference/top-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/spatial-functions.md b/docs/framework/data/adonet/ef/language-reference/spatial-functions.md
new file mode 100644
index 00000000000..c0fbf0dc612
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/spatial-functions.md
@@ -0,0 +1,26 @@
+---
+title: "空間関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 90cb177d-88a0-45be-97e8-3b306283c6e0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 空間関数
+空間型のリテラル形式はありません。  ただし、Well\-Known Text 形式の文字列を使用して呼び出す正規の Entity Framework 関数を使用できます。  たとえば、次の関数呼び出しでは、ジオメトリ ポイントが作成されます。  
+  
+```  
+GeometryFromText('POINT (43 -73)')  
+```  
+  
+ [SpatialEdmFunctions メソッド](http://msdn.microsoft.com/library/hh749531.aspx) ページには、空間に関する正規の Entity Framework メソッドすべての一覧が記載されています。  目的のメソッドをクリックすると、関数に渡す必要のあるパラメーターを確認できます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/ssdl-specification.md b/docs/framework/data/adonet/ef/language-reference/ssdl-specification.md
new file mode 100644
index 00000000000..c8e3b772631
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/ssdl-specification.md
@@ -0,0 +1,26 @@
+---
+title: "SSDL 仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9d6b29da-b363-4930-ba57-989f9d6dbf3f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SSDL 仕様
+現在、[msdn.microsoft.com\/data\/ef](http://msdn.microsoft.com/data/ef) サイトでは、主に Entity Framework に関するコンテンツを提供しています。  
+  
+ このトピックの内容は、「[SSDL 仕様](http://msdn.microsoft.com/data/jj652016)」ページでご利用いただけます。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md b/docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md
new file mode 100644
index 00000000000..127751fee41
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md
@@ -0,0 +1,92 @@
+---
+title: "LINQ to Entities クエリの標準クエリ演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 7fa55a9b-6219-473d-b1e5-2884a32dcdff
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to Entities クエリの標準クエリ演算子
+クエリでは、データ ソースから取得する情報を指定できます。  また、並べ替え、グループ化、整形方法を指定して情報を取得することもできます。  LINQ には、クエリで使用できる一連の標準クエリ メソッドが用意されています。  これらのメソッドの大部分はシーケンスに対して機能します。この文脈でのシーケンスとは、<xref:System.Collections.Generic.IEnumerable%601> インターフェイスまたは <xref:System.Linq.IQueryable%601> インターフェイスを実装している型のオブジェクトのことです。  標準クエリ演算子のクエリ機能には、フィルター処理、投影、集計、並べ替え、グループ化、ページングなどがあります。  よく使用される標準クエリ演算子の中には、クエリ式構文を使用することで呼び出しが可能になるように、専用のキーワード構文のあるものもあります。  クエリ式はメソッド ベースの方法とは異なり、読み取りやすくクエリを表現できます。  クエリ式の句は、コンパイル時にクエリ メソッドへの呼び出しに変換されます。  同等なクエリ式の句がある標準クエリ演算子の一覧については、「[Standard Query Operators Overview](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+ 標準クエリ演算子のすべてが [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでサポートされるわけではありません。  詳細については、「[サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md)」を参照してください。このトピックでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] に固有の標準クエリ演算子について説明します。  [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでの既知の問題の詳細については、「[LINQ to Entities の既知の問題および注意点](../../../../../../docs/framework/data/adonet/ef/language-reference/known-issues-and-considerations-in-linq-to-entities.md)」を参照してください。  
+  
+## 投影およびフィルター処理メソッド  
+ *投影*とは、結果セットの要素を目的の形式に変換することです。  たとえば、結果セットの各オブジェクトから必要なプロパティのサブセットを投影したり、特定のプロパティを投影してそのプロパティで数学演算を実行したり、結果セットの全オブジェクトを投影したりすることが可能です。  投影メソッドは、`Select` と `SelectMany` です。  
+  
+ *フィルター処理*とは、特定の条件に一致する要素のみが含まれるように結果セットを限定する操作のことです。  フィルター処理メソッドは、`Where` です。  
+  
+ 投影およびフィルター処理メソッドのオーバーロードの大部分は、位置引数を受け入れるオーバーロードを例外として、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] でサポートされます。  
+  
+## 結合メソッド  
+ 結合は、互いにナビゲート可能なリレーションシップを持たないデータ ソースをターゲットとするクエリにおいて重要な操作です。  2 つのデータ ソースを結合する操作とは、あるデータ ソース内のオブジェクトを、他方のデータ ソース内で共通の属性またはプロパティを持つオブジェクトと関連付けることです。  結合メソッドは、`Join` と `GroupJoin` です。  
+  
+ <xref:System.Collections.Generic.IEqualityComparer%601> を使用するオーバーロードを例外として、結合メソッドの大部分のオーバーロードがサポートされます。  これは、Comparer をデータ ソースに変換できないためです。  
+  
+## セット メソッド  
+ LINQ のセット操作は、同一または別のコレクション \(またはセット\) 内に同等の要素があるかどうかによって結果セットが変化するクエリ操作です。  セット メソッドは、`All`、`Any`、`Concat`、`Contains`、`DefaultIfEmpty`、`Distinct`、`EqualAll`、`Except`、`Intersect`、および `Union` です。  
+  
+ LINQ to Objects と比較すれば動作に多少の違いがありますが、セット メソッドの大部分のオーバーロードは [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] でサポートされます。  ただし、<xref:System.Collections.Generic.IEqualityComparer%601> を使用するセット メソッドは、Comparer をデータ ソースに変換することができないためサポートされません。  
+  
+## 並べ替えメソッド  
+ 並べ替えとは、1 つまたは複数の属性に基づいて結果セットの要素を並べ替えることです。  複数の基準を指定すると、グループ内での結び付きが壊れることがあります。  
+  
+ <xref:System.Collections.Generic.IComparer%601> を使用するオーバーロードを例外として、並べ替えメソッドの大部分のオーバーロードがサポートされます。  これは、Comparer をデータ ソースに変換できないためです。  並べ替えメソッドは、`OrderBy`、`OrderByDescending`、`ThenBy`、`ThenByDescending`、および `Reverse` です。  
+  
+ クエリはデータ ソースで実行されるため、並べ替えの動作が CLR で実行されるクエリとは異なる場合があります。  これは、大文字と小文字の並べ替え、漢字の並べ替え、null の並べ替えなど、並べ替えのオプションをデータ ソースで設定できることが原因です。  データ ソースによっては、これらの並べ替えオプションを使用すると、CLR の結果とは異なる結果が返される場合があります。  
+  
+ 複数の並べ替え操作で同一のキー セレクターを指定すると、並べ替えが重複します。  これは無効であり、例外がスローされます。  
+  
+## グループ化メソッド  
+ グループ化とは、各グループの要素が共通の属性を持てるようにデータをグループに配置することです。  グループ化メソッドは `GroupBy` です。  
+  
+ <xref:System.Collections.Generic.IEqualityComparer%601> を使用するオーバーロードを例外として、グループ化メソッドの大部分のオーバーロードがサポートされます。  これは、Comparer をデータ ソースに変換できないためです。  
+  
+ グループ化メソッドは、キー セレクターの個別のサブクエリを使用してデータ ソースにマップされます。  キー セレクターの比較サブクエリは、`null` 値の比較に関する問題など、データ ソースのセマンティクスを使用することによって実行されます。  
+  
+## 集計メソッド  
+ 集計の操作では、値の集合体から単一の値が計算されます。  たとえば、1 か月分の毎日の気温値から 1 日あたりの平均の気温値を計算することが集計操作です。  集計メソッドは、`Aggregate`、`Average`、`Count`、`LongCount`、`Max`、`Min`、および `Sum` です。  
+  
+ 集計メソッドの大部分のオーバーロードはサポートされています。  null 値に関連する動作では、集計メソッドでデータ ソース セマンティクスが使用されます。  null 値が関係する集計メソッドの動作は、使用するバックエンド データ ソースに応じて異なる可能性があります。  データ ソースのセマンティクスを使用する集計メソッドの動作でも、CLR のメソッドから見込まれる動作とは異なる場合があります。  たとえば、SQL Server での `Sum` メソッドの既定動作では、例外がスローされずに null 値が無視されます。  
+  
+ `Sum` 関数のオーバーフローなど、集計によって生じるあらゆる例外は、クエリ結果の具体化の最中にデータ ソースの例外または Entity Framework の例外としてスローされます。  
+  
+ `Sum`、`Average` など、シーケンス全体の計算にかかわるメソッドの場合、実際の計算はサーバーで行われます。  結果として、サーバー上での型変換や有効桁の消失が発生する場合があり、CLR セマンティクスを使用した際に見込まれる結果とは異なる結果が返される可能性があります。  
+  
+ 次の表に、null および非 null 値に対する集計メソッドの既定の動作を示します。  
+  
+|メソッド|データなし|すべての null 値|いくつかの null 値|null 値なし|  
+|----------|-----------|-----------------|------------------|--------------|  
+|`Average`|null を返します。|null を返します。|シーケンス内の null 値以外の値の平均を返します。|数値のシーケンスの平均を計算します。|  
+|`Count`|0 を返します。|シーケンス内の null 値の数を返します。|シーケンス内の null 値と非 null 値の数を返します。|シーケンス内の要素の数を返します。|  
+|`Max`|null を返します。|null を返します。|シーケンス内の null 以外の値の最大値を返します。|シーケンス内の最大値を返します。|  
+|`Min`|null を返します。|null を返します。|シーケンス内の null 以外の値の最小値を返します。|シーケンス内の最小値を返します。|  
+|`Sum`|null を返します。|null を返します。|シーケンス内の null 以外の値の合計を返します。|数値のシーケンスの合計を計算します。|  
+  
+## 型メソッド  
+ [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] のコンテキストでは、型変換と判定を処理する 2 つの LINQ メソッドがサポートされます。  つまり、サポートされる型は、適切な [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] 型にマップされる型のみです。  これらの型の一覧については、「[Conceptual Model Types \(CSDL\)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)」を参照してください。  型メソッドは、`Convert` と `OfType` です。  
+  
+ エンティティ型では、`OfType` がサポートされます。  概念モデル プリミティブ型では、`Convert` がサポートされます。  C\# の `is` および `as` メソッドもサポートされます。  
+  
+## ページング メソッド  
+ ページング操作では、シーケンスから単一の特定の要素が返されます。  この要素のメソッドは、`ElementAt`、`First`、`FirstOrDefault`、`Last`、`LastOrDefault`、`Single`、`Skip`、`Take`、および `TakeWhile` です。  
+  
+ 多くのページング メソッドはサポートされていません。これは、関数をデータ ソースにマップできないことと、データ ソースでのセットの明示的な順序付けが不足していることのいずれかが理由です。  既定値を返すメソッドは、null 既定値を持つ概念モデル プリミティブ型および参照型に限定されます。  空シーケンスで実行されるページング メソッドは null を返します。  
+  
+## 参照  
+ [サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド \(LINQ to Entities\)](../../../../../../docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md)   
+ [Standard Query Operators Overview](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md b/docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md
new file mode 100644
index 00000000000..86f8b42e553
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/string-canonical-functions.md
@@ -0,0 +1,54 @@
+---
+title: "文字列正規関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 5e2cbebd-5df3-47c7-b0e2-49a17ab22bfb
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 文字列正規関数
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] には、文字列正規関数が含まれています。  
+  
+## 解説  
+ 次の表に、文字列 [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 正規関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`Concat (` `string1`, `string2``)`|`string1` に追加された `string2` を含む文字列を返します。<br /><br /> **引数**<br /><br /> `string1`: `string2` の追加先となる文字列。<br /><br /> `string2`: `string1` に追加される文字列。<br /><br /> **戻り値**<br /><br /> `String` 戻り値の文字列の長さが許容される最大長よりも長い場合は、エラーが発生します。<br /><br /> **例**<br /><br /> `-- The following example returns abcxyz.`<br /><br /> `Concat('abc', 'xyz')`|  
+|`Contains (` `string`, `target``)`|`target` が `string` に含まれる場合は、`true` を返します。<br /><br /> **引数**<br /><br /> `string`: 検索条件となる文字列。<br /><br /> `target`: 検索対象となる文字列。<br /><br /> **戻り値**<br /><br /> `target` が `string` に含まれる場合は `true`。それ以外の場合は `false`。<br /><br /> **例**<br /><br /> `-- The following example returns true.`<br /><br /> `Contains('abc', 'bc')`|  
+|`EndsWith (` `string`, `target``)`|`target` が `string` で終わる場合は、`true` を返します。<br /><br /> **引数**<br /><br /> `string`: 検索条件となる文字列。<br /><br /> `target`: `string` の末尾部分で検索対象となる文字列。<br /><br /> **戻り値**<br /><br /> `string` が `target` で終わる場合は `true`。それ以外の場合は `false`。<br /><br /> **例**<br /><br /> `-- The following example returns true.`<br /><br /> `EndsWith('abc', 'bc')` **Note:**  [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] データ プロバイダーの使用時に、文字列が固定長文字列の列に格納されており `target` が定数である場合、この関数は `false` を返します。  この場合、末尾の埋め込み空白も含めて文字列全体が検索されます。  この問題を回避するには、データを固定長文字列の長さに合わせて切り詰めます。たとえば、`EndsWith(TRIM(string), target)` のように指定します。|  
+|`IndexOf(` `target`, `string``)`|`string` 内における `target` の位置を返します。見つからない場合は 0 を返します。  `string` の先頭を示す場合は 1 を返します。  インデックスの番号は 1 から始まります。<br /><br /> **引数**<br /><br /> `target`: 検索対象となる文字列。<br /><br /> `string`: 検索条件となる文字列。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 4.`<br /><br /> `IndexOf('xyz', 'abcxyz')`|  
+|`Left (` `string`, `length``)`|`string` の左側から最初の `length` 文字を返します。  `string` の長さが `length` よりも短い場合は、文字列全体が返されます。<br /><br /> **引数**<br /><br /> `string`: `String`。<br /><br /> `length`: `Int16`、`Int32`、`Int64`、または `Byte`。  `length` は 0 未満には設定できません。<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns abc.`<br /><br /> `Left('abcxyz', 3)`|  
+|`Length (` `string` `)`|文字列の長さ \(`Int32`\) を文字数として返します。<br /><br /> **引数**<br /><br /> `string`: `String`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **例**<br /><br /> `-- The following example returns 6.`<br /><br /> `Legth('abcxyz')`|  
+|`LTrim(` `string` `)`|先頭の空白文字を除いた `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns abc.`<br /><br /> `LTrim('   abc')`|  
+|`Replace (` `string1`, `string2`, `string3``)`|すべての `string2` を `string3` で置き換えた `string1` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns abcxyz.`<br /><br /> `Concat('abc', 'xyz')`|  
+|`Reverse (` `string` `)`|文字の順序を逆にした `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns dcba.`<br /><br /> `Reverse('abcd')`|  
+|`Right (` `string`, `length``)`|`string` の最後の `length` 文字を返します。  `string` の長さが `length` よりも短い場合は、文字列全体が返されます。<br /><br /> **引数**<br /><br /> `string`: `String`。<br /><br /> `length`: `Int16`、`Int32`、`Int64`、または `Byte`。  `length` は 0 未満には設定できません。<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns xyz.`<br /><br /> `Right('abcxyz', 3)`|  
+|`RTrim(` `string` `)`|末尾の空白文字を除いた `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`|  
+|`Substring (` `string`, `start`, `length``)`|`start` 位置から長さが `length` 文字の部分文字列を返します。  開始が 1 の場合は、文字列の最初の文字を示します。  インデックスの番号は 1 から始まります。<br /><br /> **引数**<br /><br /> `string`: `String`。<br /><br /> `start`: `Int16`、`Int32`、`Int64`、および `Byte`。  `start` は 1 未満には設定できません。<br /><br /> `length`: `Int16`、`Int32`、`Int64`、および `Byte`。  `length` は 0 未満には設定できません。<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns xyz.`<br /><br /> `Substring('abcxyz', 4, 3)`|  
+|`StartsWith (` `string`, `target``)`|`string` が `target` で始まる場合は、`true` を返します。<br /><br /> **引数**<br /><br /> `string`: 検索条件となる文字列。<br /><br /> `target`: `string` の開始部分で検索対象となる文字列。<br /><br /> **戻り値**<br /><br /> `string` が `target` で始まる場合は `true`。それ以外の場合は `false`。<br /><br /> **例**<br /><br /> `-- The following example returns true.`<br /><br /> `StartsWith('abc', 'ab')`|  
+|`ToLower(` `string` `)`|大文字が小文字に変換された `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns abc.`<br /><br /> `ToLower('ABC')`|  
+|`ToUpper(` `string` `)`|小文字が大文字に変換された `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns ABC.`<br /><br /> `ToUpper('abc')`|  
+|`Trim(` `string` `)`|先頭および末尾の空白文字を除いた `string` を返します。<br /><br /> **引数**<br /><br /> `String`<br /><br /> **戻り値**<br /><br /> `String`<br /><br /> **例**<br /><br /> `-- The following example returns abc.`<br /><br /> `Trim('      abc   ')`|  
+  
+ `null` が入力された場合、これらの関数は `null` を返します。  
+  
+ 同等の機能は、Microsoft SQL クライアント マネージ プロバイダーでも利用できます。  詳細については、「[Entity Framework 用 SqlClient 関数](../../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## 参照  
+ [正規関数](../../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/string-concatenation-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/string-concatenation-entity-sql.md
new file mode 100644
index 00000000000..9050d03ffa7
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/string-concatenation-entity-sql.md
@@ -0,0 +1,54 @@
+---
+title: "+ (文字列連結) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 580130fa-6c7c-4f76-a47d-d22c27ccadf6
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# + (文字列連結) (Entity SQL)
+2 つの文字列を連結します。  
+  
+## 構文  
+  
+```  
+  
+expression  
++  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ EDM.String データ型の任意の有効な式。 両方の式は、同じデータ型でなければなりません。または、一方の式をもう一方の式のデータ型に暗黙的に変換できる必要があります。  
+  
+## 戻り値の型  
+ 2 つの引数の暗黙の型の昇格の結果であるデータ型。 暗黙の型の昇格について詳しくは、「[型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\+ 演算子を使用して、2 つの文字列を連結します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#CONCAT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#concat)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [概念モデルの型 \(CSDL\)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/subtract-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/subtract-entity-sql.md
new file mode 100644
index 00000000000..b2db1075756
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/subtract-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "- (減算) (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: bc4327f9-09c0-438f-a008-927c5c478040
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# - (減算) (Entity SQL)
+2 つの値の間で減算をします。  
+  
+## 構文  
+  
+```  
+  
+expression  
+-  
+expression  
+  
+```  
+  
+## 引数  
+ `expression`  
+ 任意の数値データ型の有効な式。  
+  
+## 戻り値の型  
+ 2 つの引数の暗黙の型の昇格の結果であるデータ型。 暗黙の型の昇格について詳しくは、「[型システム](../../../../../../docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、\- 算術演算子を使用して 2 つの数値の間で減算をします。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#SUBTRACT](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#subtract)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md b/docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md
new file mode 100644
index 00000000000..6d428f9eee0
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/supported-and-unsupported-linq-methods-linq-to-entities.md
@@ -0,0 +1,193 @@
+---
+title: "サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド (LINQ to Entities) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 7f3ffa5f-f819-4730-bcdb-09b23de3b6d0
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# サポート対象の LINQ メソッドとサポート非対象の LINQ メソッド (LINQ to Entities)
+このセクションでは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでサポート対象またはサポート非対象になっている統合言語クエリ (LINQ) 標準クエリ演算子について説明します。 LINQ 標準クエリ演算子の多くには、整数の引数を取るオーバーロード バージョンがあります。 整数引数で操作されるシーケンス内の&0; から始まるインデックスに対応する<xref:System.Collections.Generic.IEqualityComparer%601>、または<xref:System.Collections.Generic.IComparer%601>します。 特に指定がなければ、LINQ 標準クエリ演算子のオーバーロード バージョンはサポートされず、このバージョンを使用しようとすると例外がスローされます。  
+  
+## <a name="projection-and-restriction-methods"></a>投影メソッドと制限メソッド  
+ ほとんどの LINQ 投影および制限メソッドは、位置引数を受け入れるメソッドを例外として、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでサポートされます。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象およびサポート非対象の投影および制限メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.Select%2A>\</TSource, TResult>|サポートされています|`Function Select(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> Select<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector )`|  
+|<xref:System.Linq.Queryable.Select%2A>\</TSource, TResult>|サポートされていません|`Function Select(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Integer, TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> Select<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, int, TResult>> selector )`|  
+|<xref:System.Linq.Queryable.SelectMany%2A>\</TSource, TResult>|サポートされています|`Function SelectMany(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, IEnumerable(Of TResult))) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> SelectMany<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, IEnumerable<TResult>>> selector )`|  
+|<xref:System.Linq.Queryable.SelectMany%2A>\</TSource, TResult>|サポートされていません|`Function SelectMany(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Integer, IEnumerable(Of TResult))) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> SelectMany<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, int, IEnumerable<TResult>>> selector )`|  
+|<xref:System.Linq.Queryable.SelectMany%2A></TSource, TCollection, TResult>|サポートされています|`Function SelectMany(Of TSource, TCollection, TResult) ( _ source As IQueryable(Of TSource), _ collectionSelector As Expression(Of Func(Of TSource, IEnumerable(Of TCollection))), _ resultSelector As Expression(Of Func(Of TSource, TCollection, TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> SelectMany\<TSource, TCollection, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, IEnumerable<TCollection>>> collectionSelector, Expression<Func\<TSource, TCollection, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.SelectMany%2A></TSource, TCollection, TResult>|サポートされていません|`Function SelectMany(Of TSource, TCollection, TResult) ( _ source As IQueryable(Of TSource), _ collectionSelector As Expression(Of Func(Of TSource, Integer, IEnumerable(Of TCollection))), _ resultSelector As Expression(Of Func(Of TSource, TCollection, TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> SelectMany\<TSource, TCollection, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, int, IEnumerable<TCollection>>> collectionSelector, Expression<Func\<TSource, TCollection, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.Where%2A>|サポートされています|`Function Where(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Where<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Where%2A>|サポートされていません|`Function Where(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Integer, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Where<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, int, bool>> predicate )`|  
+  
+## <a name="join-methods"></a>結合メソッド  
+ LINQ 結合メソッドは、[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] でサポートされていますが、Comparer はデータ ソースに変換できないため、`IEqualityComparer` を受け入れるものは例外です。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象の結合メソッドとサポート非対象の結合メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.GroupJoin%2A>\</TOuter, TInner, TKey, TResult>|サポートされています|`Function GroupJoin(Of TOuter, TInner, TKey, TResult) ( _ outer As IQueryable(Of TOuter), _ inner As IEnumerable(Of TInner), _ outerKeySelector As Expression(Of Func(Of TOuter, TKey)), _ innerKeySelector As Expression(Of Func(Of TInner, TKey)), _ resultSelector As Expression(Of Func(Of TOuter, IEnumerable(Of TInner), TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupJoin<TOuter, TInner, TKey, TResult>( this IQueryable<TOuter> outer, IEnumerable<TInner> inner, Expression<Func<TOuter, TKey>> outerKeySelector, Expression<Func<TInner, TKey>> innerKeySelector, Expression<Func<TOuter, IEnumerable<TInner>, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.GroupJoin%2A></TOuter, TInner, TKey, TResult>|サポートされません|`Function GroupJoin(Of TOuter, TInner, TKey, TResult) ( _ outer As IQueryable(Of TOuter), _ inner As IEnumerable(Of TInner), _ outerKeySelector As Expression(Of Func(Of TOuter, TKey)), _ innerKeySelector As Expression(Of Func(Of TInner, TKey)), _ resultSelector As Expression(Of Func(Of TOuter, IEnumerable(Of TInner), TResult)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupJoin\<TOuter, TInner, TKey, TResult>( this IQueryable<TOuter> outer, IEnumerable<TInner> inner, Expression<Func\<TOuter, TKey>> outerKeySelector, Expression<Func\<TInner, TKey>> innerKeySelector, Expression<Func<TOuter, IEnumerable<TInner>, TResult>> resultSelector, IEqualityComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.Join%2A>\</TOuter, TInner, TKey, TResult>|サポートされています|`Function Join(Of TOuter, TInner, TKey, TResult) ( _ outer As IQueryable(Of TOuter), _ inner As IEnumerable(Of TInner), _ outerKeySelector As Expression(Of Func(Of TOuter, TKey)), _ innerKeySelector As Expression(Of Func(Of TInner, TKey)), _ resultSelector As Expression(Of Func(Of TOuter, TInner, TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> Join<TOuter, TInner, TKey, TResult>( this IQueryable<TOuter> outer, IEnumerable<TInner> inner, Expression<Func<TOuter, TKey>> outerKeySelector, Expression<Func<TInner, TKey>> innerKeySelector, Expression<Func<TOuter, TInner, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.Join%2A></TOuter, TInner, TKey, TResult>|サポートされません|`Function Join(Of TOuter, TInner, TKey, TResult) ( _ outer As IQueryable(Of TOuter), _ inner As IEnumerable(Of TInner), _ outerKeySelector As Expression(Of Func(Of TOuter, TKey)), _ innerKeySelector As Expression(Of Func(Of TInner, TKey)), _ resultSelector As Expression(Of Func(Of TOuter, TInner, TResult)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> Join\<TOuter, TInner, TKey, TResult>( this IQueryable<TOuter> outer, IEnumerable<TInner> inner, Expression<Func\<TOuter, TKey>> outerKeySelector, Expression<Func\<TInner, TKey>> innerKeySelector, Expression<Func\<TOuter, TInner, TResult>> resultSelector, IEqualityComparer<TKey> comparer )`|  
+  
+## <a name="set-methods"></a>メソッドの設定  
+ ほとんどの LINQ セット メソッドではサポートされて[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)]を使用する例外として、クエリ、 <xref:System.Collections.Generic.EqualityComparer%601>します。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象のセット メソッドとサポート非対象のセット メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.All%2A>|サポートされています|`Function All(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As Boolean`|`bool All<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Any%2A>|サポートされています|`Function Any(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As Boolean`|`bool Any<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Any%2A>|サポートされています|`Function Any(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As Boolean`|`bool Any<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Contains%2A>|サポートされています|`Function Contains(Of TSource) ( _ source As IQueryable(Of TSource), _ item As TSource _ ) As Boolean`|`bool Contains<TSource>( this IQueryable<TSource> source, TSource item )`|  
+|<xref:System.Linq.Queryable.Contains%2A>|サポートされていません|`Function Contains(Of TSource) ( _ source As IQueryable(Of TSource), _ item As TSource, _ comparer As IEqualityComparer(Of TSource) _ ) As Boolean`|`bool Contains<TSource>( this IQueryable<TSource> source, TSource item, IEqualityComparer<TSource> comparer )`|  
+|<xref:System.Linq.Queryable.Concat%2A>|サポート対象だが、<br /><br /> 順序の維持は保証されない|`Function Concat(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Concat<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2 )`|  
+|<xref:System.Linq.Queryable.DefaultIfEmpty%2A>|サポートされています|`Function DefaultIfEmpty(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> DefaultIfEmpty<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.DefaultIfEmpty%2A>|サポートされています|`Function DefaultIfEmpty(Of TSource) ( _ source As IQueryable(Of TSource), _ defaultValue As TSource _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> DefaultIfEmpty<TSource>( this IQueryable<TSource> source, TSource defaultValue )`|  
+|<xref:System.Linq.Queryable.Distinct%2A>|サポートされています|`Function Distinct(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Distinct<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Distinct%2A>|サポートされていません|`Function Distinct(Of TSource) ( _ source As IQueryable(Of TSource), _ comparer As IEqualityComparer(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Distinct<TSource>( this IQueryable<TSource> source, IEqualityComparer<TSource> comparer )`|  
+|<xref:System.Linq.Queryable.Except%2A>|サポートされています|`Function Except(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Except<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2 )`|  
+|<xref:System.Linq.Queryable.Except%2A>|サポートされていません|`Function Except(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource), _ comparer As IEqualityComparer(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Except<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2, IEqualityComparer<TSource> comparer )`|  
+|<xref:System.Linq.Queryable.Intersect%2A>|サポートされています|`Function Intersect(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Intersect<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2 )`|  
+|<xref:System.Linq.Queryable.Intersect%2A>|サポートされていません|`Function Intersect(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource), _ comparer As IEqualityComparer(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Intersect<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2, IEqualityComparer<TSource> comparer )`|  
+|<xref:System.Linq.Queryable.Union%2A>|サポートされています|`Function Union(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Union<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2 )`|  
+|<xref:System.Linq.Queryable.Union%2A>|サポートされていません|`Function Union(Of TSource) ( _ source1 As IQueryable(Of TSource), _ source2 As IEnumerable(Of TSource), _ comparer As IEqualityComparer(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Union<TSource>( this IQueryable<TSource> source1, IEnumerable<TSource> source2, IEqualityComparer<TSource> comparer )`|  
+  
+## <a name="ordering-methods"></a>並べ替えメソッド  
+ LINQ 並べ替えメソッドのほとんどがサポートされている[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)]、受け入れるものは例外、 <xref:System.Collections.Generic.IComparer%601>、comparer をデータ ソースに変換できないため、します。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象の並べ替えメソッドとサポート非対象の並べ替えメソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.OrderBy%2A>\</TSource, TKey>|サポートされています|`Function OrderBy(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> OrderBy<TSource, TKey>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector )`|  
+|<xref:System.Linq.Queryable.OrderBy%2A></TSource, TKey>|サポートされていません|`Function OrderBy(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ comparer As IComparer(Of TKey) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> OrderBy\<TSource, TKey>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, IComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.OrderByDescending%2A>\</TSource, TKey>|サポートされています|`Function OrderByDescending(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> OrderByDescending<TSource, TKey>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector )`|  
+|<xref:System.Linq.Queryable.OrderByDescending%2A></TSource, TKey>|サポートされていません|`Function OrderByDescending(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ comparer As IComparer(Of TKey) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> OrderByDescending\<TSource, TKey>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, IComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.ThenBy%2A>\</TSource, TKey>|サポートされています|`Function ThenBy(Of TSource, TKey) ( _ source As IOrderedQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> ThenBy<TSource, TKey>( this IOrderedQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector )`|  
+|<xref:System.Linq.Queryable.ThenBy%2A></TSource, TKey>|サポートされていません|`Function ThenBy(Of TSource, TKey) ( _ source As IOrderedQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ comparer As IComparer(Of TKey) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> ThenBy\<TSource, TKey>( this IOrderedQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, IComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.ThenByDescending%2A>\</TSource, TKey>|サポートされています|`Function ThenByDescending(Of TSource, TKey) ( _ source As IOrderedQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> ThenByDescending<TSource, TKey>( this IOrderedQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector )`|  
+|<xref:System.Linq.Queryable.ThenByDescending%2A></TSource, TKey>|サポートされていません|`Function ThenByDescending(Of TSource, TKey) ( _ source As IOrderedQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ comparer As IComparer(Of TKey) _ ) As IOrderedQueryable(Of TSource)`|`IOrderedQueryable<TSource> ThenByDescending\<TSource, TKey>( this IOrderedQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, IComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.Reverse%2A>|サポートされていません|`Function Reverse(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Reverse<TSource>( this IQueryable<TSource> source )`|  
+  
+## <a name="grouping-methods"></a>グループ化メソッド  
+ ほとんどの LINQ グループ化メソッドではサポートされて[!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)]、受け入れるものは例外、 <xref:System.Collections.Generic.IEqualityComparer%601>、comparer をデータ ソースに変換できないため、します。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象のグループ化メソッドとサポート非対象のグループ化メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.GroupBy%2A>\</TSource, TKey>|サポートされています|`Function GroupBy(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)) _ ) As IQueryable(Of IGrouping(Of TKey, TSource))`|`IQueryable<IGrouping<TKey, TSource>> GroupBy<TSource, TKey>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A></TSource, TKey>|サポートされていません|`Function GroupBy(Of TSource, TKey) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of IGrouping(Of TKey, TSource))`|`IQueryable<IGrouping\<TKey, TSource>> GroupBy\<TSource, TKey>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, IEqualityComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A>\</TSource, TKey, TElement>|サポートされています|`Function GroupBy(Of TSource, TKey, TElement) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ elementSelector As Expression(Of Func(Of TSource, TElement)) _ ) As IQueryable(Of IGrouping(Of TKey, TElement))`|`IQueryable<IGrouping<TKey, TElement>> GroupBy<TSource, TKey, TElement>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector, Expression<Func<TSource, TElement>> elementSelector )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A></TSource, TKey, TElement>|サポートされています|`Function GroupBy(Of TSource, TKey, TResult) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TSource), TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupBy\<TSource, TKey, TResult>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, Expression<Func<TKey, IEnumerable<TSource>, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A></TSource, TKey, TResult>|サポートされていません|`Function GroupBy(Of TSource, TKey, TElement) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ elementSelector As Expression(Of Func(Of TSource, TElement)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of IGrouping(Of TKey, TElement))`|`IQueryable<IGrouping\<TKey, TElement>> GroupBy\<TSource, TKey, TElement>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, Expression<Func\<TSource, TElement>> elementSelector, IEqualityComparer<TKey> comparer`|  
+|<xref:System.Linq.Queryable.GroupBy%2A>\</TSource, TKey, TResult>|サポートされています|`Function GroupBy(Of TSource, TKey, TElement, TResult) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ elementSelector As Expression(Of Func(Of TSource, TElement)), _ resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TElement), TResult)) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupBy<TSource, TKey, TElement, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector, Expression<Func<TSource, TElement>> elementSelector, Expression<Func<TKey, IEnumerable<TElement>, TResult>> resultSelector )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A></TSource, TKey, TElement, TResult>|サポートされていません|`Function GroupBy(Of TSource, TKey, TResult) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TSource), TResult)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupBy\<TSource, TKey, TResult>( this IQueryable<TSource> source, Expression<Func\<TSource, TKey>> keySelector, Expression<Func<TKey, IEnumerable<TSource>, TResult>> resultSelector, IEqualityComparer<TKey> comparer )`|  
+|<xref:System.Linq.Queryable.GroupBy%2A>\</TSource, TKey, TElement, TResult>|サポートされていません|`Function GroupBy(Of TSource, TKey, TElement, TResult) ( _ source As IQueryable(Of TSource), _ keySelector As Expression(Of Func(Of TSource, TKey)), _ elementSelector As Expression(Of Func(Of TSource, TElement)), _ resultSelector As Expression(Of Func(Of TKey, IEnumerable(Of TElement), TResult)), _ comparer As IEqualityComparer(Of TKey) _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> GroupBy<TSource, TKey, TElement, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, TKey>> keySelector, Expression<Func<TSource, TElement>> elementSelector, Expression<Func<TKey, IEnumerable<TElement>, TResult>> resultSelector, IEqualityComparer<TKey> comparer )`|  
+  
+## <a name="aggregate-methods"></a>集計メソッド  
+ プリミティブ データ型を受け入れる集計メソッドのほとんどが [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] でサポートされています。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象の集計メソッドとサポート非対象の集計メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.Aggregate%2A>|サポートされていません|`Function Aggregate(Of TSource) ( _ source As IQueryable(Of TSource), _ func As Expression(Of Func(Of TSource, TSource, TSource)) _ ) As TSource`|`TSource Aggregate<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, TSource, TSource>> func )`|  
+|<xref:System.Linq.Queryable.Aggregate%2A>\</TSource, TAccumulate>|サポートされていません|`Function Aggregate(Of TSource, TAccumulate) ( _ source As IQueryable(Of TSource), _ seed As TAccumulate, _ func As Expression(Of Func(Of TAccumulate, TSource, TAccumulate)) _ ) As TAccumulate`|`TAccumulate Aggregate<TSource, TAccumulate>( this IQueryable<TSource> source, TAccumulate seed, Expression<Func<TAccumulate, TSource, TAccumulate>> func )`|  
+|<xref:System.Linq.Queryable.Aggregate%2A>\</TSource, TAccumulate, TResult>|サポートされていません|`Function Aggregate(Of TSource, TAccumulate, TResult) ( _ source As IQueryable(Of TSource), _ seed As TAccumulate, _ func As Expression(Of Func(Of TAccumulate, TSource, TAccumulate)), _ selector As Expression(Of Func(Of TAccumulate, TResult)) _ ) As TResult`|`TResult Aggregate<TSource, TAccumulate, TResult>( this IQueryable<TSource> source, TAccumulate seed, Expression<Func<TAccumulate, TSource, TAccumulate>> func, Expression<Func<TAccumulate, TResult>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Decimal) _ ) As Decimal`|`decimal Average( this IQueryable<decimal> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Double) _ ) As Double`|`double Average( this IQueryable<double> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Integer) _ ) As Double`|`double Average( this IQueryable<int> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Long) _ ) As Double`|`double Average( this IQueryable<long> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Nullable(Of Decimal)) _ ) As Nullable(Of Decimal)`|`Nullable<decimal> Average( this IQueryable<Nullable<decimal>> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Nullable(Of Double)) _ ) As Nullable(Of Double)`|`Nullable<double> Average( this IQueryable<Nullable<double>> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Nullable(Of Integer)) _ ) As Nullable(Of Double)`|`Nullable<double> Average( this IQueryable<Nullable<int>> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Nullable(Of Long)) _ ) As Nullable(Of Double)`|`Nullable<double> Average( this IQueryable<Nullable<long>> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Nullable(Of Single)) _ ) As Nullable(Of Single)`|`Nullable<float> Average( this IQueryable<Nullable<float>> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされています|`Function Average ( _ source As IQueryable(Of Single) _ ) As Single`|`float Average( this IQueryable<float> source )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Integer)) _ ) As Double`|`double Average<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, int>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Integer))) _ ) As Nullable(Of Double)`|`Nullable<double> Average<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<int>>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Long)) _ ) As Double`|`double Average<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, long>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Long))) _ ) As Nullable(Of Double)`|`Nullable<double> Average<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<long>>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Single)) _ ) As Single`|`float Average<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, float>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Single))) _ ) As Nullable(Of Single)`|`Nullable<float> Average<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<float>>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Double)) _ ) As Double`|`double Average<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, double>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Double))) _ ) As Nullable(Of Double)`|`Nullable<double> Average<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<double>>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Decimal)) _ ) As Decimal`|`decimal Average<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, decimal>> selector )`|  
+|<xref:System.Linq.Queryable.Average%2A>|サポートされていません|`Function Average(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Decimal))) _ ) As Nullable(Of Decimal)`|`Nullable<decimal> Average<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<decimal>>> selector )`|  
+|<xref:System.Linq.Queryable.Count%2A>|サポートされています|`Function Count(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As Integer`|`int Count<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Count%2A>|サポートされていません|`Function Count(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As Integer`|`int Count<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.LongCount%2A>|サポートされています|`Function LongCount(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As Long`|`long LongCount<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.LongCount%2A>|サポートされていません|`Function LongCount(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As Long`|`long LongCount<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Max%2A>|サポートされています|`Function Max(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource Max<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Max%2A>\</TSource, TResult>|サポートされていません|`Function Max(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, TResult)) _ ) As TResult`|`TResult Max<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector )`|  
+|<xref:System.Linq.Queryable.Min%2A>|サポートされています|`Function Min(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource Min<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Min%2A>\</TSource, TResult>|サポートされていません|`Function Min(Of TSource, TResult) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, TResult)) _ ) As TResult`|`TResult Min<TSource, TResult>( this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Decimal) _ ) As Decimal`|`decimal Sum( this IQueryable<decimal> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Double) _ ) As Double`|`double Sum( this IQueryable<double> source`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Integer) _ ) As Integer`|`int Sum( this IQueryable<int> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Long) _ ) As Long`|`long Sum( this IQueryable<long> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Nullable(Of Decimal)) _ ) As Nullable(Of Decimal)`|`Nullable<decimal> Sum( this IQueryable<Nullable<decimal>> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Nullable(Of Double)) _ ) As Nullable(Of Double)`|`Function Sum ( _ source As IQueryable(Of Nullable(Of Double)) _ ) As Nullable(Of Double)Nullable<double> Sum( this IQueryable<Nullable<double>> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Nullable(Of Integer)) _ ) As Nullable(Of Integer)`|`Nullable<int> Sum( this IQueryable<Nullable<int>> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Nullable(Of Long)) _ ) As Nullable(Of Long)`|`Nullable<long> Sum( this IQueryable<Nullable<long>> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Nullable(Of Single)) _ ) As Nullable(Of Single)`|`Nullable<float> Sum( this IQueryable<Nullable<float>> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされています|`Function Sum ( _ source As IQueryable(Of Single) _ ) As Single`|`float Sum( this IQueryable<float> source )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Integer)) _ ) As Integer`|`int Sum<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, int>> selector )`|  
+<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Integer))) _ ) As Nullable(Of Integer)`|`Nullable<int> Sum<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<int>>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Long)) _ ) As Long`|`long Sum<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, long>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Long))) _ ) As Nullable(Of Long)`|`Nullable<long> Sum<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<long>>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Single))) _ ) As Nullable(Of Single)`|`Nullable<float> Sum<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<float>>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Single)) _ ) As Single`|`float Sum<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, float>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Double)) _ ) As Double`|`double Sum<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, double>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Double))) _ ) As Nullable(Of Double)`|`Nullable<double> Sum<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<double>>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Decimal)) _ ) As Decimal`|`decimal Sum<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, decimal>> selector )`|  
+|<xref:System.Linq.Queryable.Sum%2A>|サポートされていません|`Function Sum(Of TSource) ( _ source As IQueryable(Of TSource), _ selector As Expression(Of Func(Of TSource, Nullable(Of Decimal))) _ ) As Nullable(Of Decimal)`|`Nullable<decimal> Sum<TSource>( this IQueryable<TSource> source, Expression<Func<TSource, Nullable<decimal>>> selector )`|  
+  
+## <a name="type-methods"></a>型メソッド  
+ [!INCLUDE[adonet_ef](../../../../../../includes/adonet-ef-md.md)] では、CLR 型変換とテストを処理する LINQ 標準クエリ演算子がサポートされています。 LINQ to Entities では、概念モデルの型にマップする CLR 型のみがサポートされています。 概念モデル型の一覧は、次を参照してください。[概念モデルの種類 (CSDL)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)します。 次の表に、サポート対象の型メソッドとサポート非対象の型メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.Cast%2A>|EDM プリミティブ型でサポート|`Function Cast(Of TResult) ( _ source As IQueryable _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> Cast<TResult>( this IQueryable source )`|  
+|<xref:System.Linq.Queryable.OfType%2A>|サポートされている<xref:System.Data.Metadata.Edm.EntityType>|`Function OfType(Of TResult) ( _ source As IQueryable _ ) As IQueryable(Of TResult)`|`IQueryable<TResult> OfType<TResult>( this IQueryable source )`|  
+  
+## <a name="paging-methods"></a>ページング メソッド  
+ LINQ ページング メソッドの多くは [!INCLUDE[linq_entities](../../../../../../includes/linq-entities-md.md)] クエリでサポートされていません。 詳細については、次を参照してください。 [LINQ to Entities クエリでの標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)します。 次の表に、サポート対象のページング メソッドとサポート非対象のページング メソッドを示します。  
+  
+|メソッド|Support|Visual Basic 関数シグネチャ|C# メソッド シグネチャ|  
+|------------|-------------|-------------------------------------|--------------------------|  
+|<xref:System.Linq.Queryable.ElementAt%2A>|サポートされていません|`Function ElementAt(Of TSource) ( _ source As IQueryable(Of TSource), _ index As Integer _ ) As TSource`|`TSource ElementAt<TSource>( this IQueryable<TSource> source, int index )`|  
+|<xref:System.Linq.Queryable.ElementAtOrDefault%2A>|サポートされていません|`Function ElementAtOrDefault(Of TSource) ( _ source As IQueryable(Of TSource), _ index As Integer _ ) As TSource`|`TSource ElementAtOrDefault<TSource>( this IQueryable<TSource> source, int index )`|  
+|<xref:System.Linq.Queryable.First%2A>|サポートされています|`Function First(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource First<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.First%2A>|サポートされています|`Function First(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource First<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.FirstOrDefault%2A>|サポートされています|`Function FirstOrDefault(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource FirstOrDefault<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.FirstOrDefault%2A>|サポートされています|`Function FirstOrDefault(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource FirstOrDefault<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Last%2A>|サポートされていません|`Function Last(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource Last<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Last%2A>|サポートされていません|`Function Last(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource Last<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.LastOrDefault%2A>|サポートされていません|`Function LastOrDefault(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource LastOrDefault<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.LastOrDefault%2A>|サポートされていません|`Function LastOrDefault(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource LastOrDefault<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Single%2A>|サポートされています|`Function Single(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource Single<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.Single%2A>|サポートされています|`Function Single(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource Single<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.SingleOrDefault%2A>|サポートされています|`Function SingleOrDefault(Of TSource) ( _ source As IQueryable(Of TSource) _ ) As TSource`|`TSource SingleOrDefault<TSource>( this IQueryable<TSource> source )`|  
+|<xref:System.Linq.Queryable.SingleOrDefault%2A>|サポートされています|`Function SingleOrDefault(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As TSource`|`TSource SingleOrDefault<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Skip%2A>|サポートされています|`Function Skip(Of TSource) ( _ source As IQueryable(Of TSource), _ count As Integer _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Skip<TSource>( this IQueryable<TSource> source, int count )`|  
+|<xref:System.Linq.Queryable.SkipWhile%2A>|サポートされていません|`Function SkipWhile(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> SkipWhile<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.SkipWhile%2A>|サポートされていません|`Function SkipWhile(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Integer, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> SkipWhile<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, int, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.Take%2A>|サポートされています|`Function Take(Of TSource) ( _ source As IQueryable(Of TSource), _ count As Integer _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> Take<TSource>( this IQueryable<TSource> source, int count )`|  
+|<xref:System.Linq.Queryable.TakeWhile%2A>|サポートされていません|`Function TakeWhile(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> TakeWhile<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, bool>> predicate )`|  
+|<xref:System.Linq.Queryable.TakeWhile%2A>|サポートされていません|`Function TakeWhile(Of TSource) ( _ source As IQueryable(Of TSource), _ predicate As Expression(Of Func(Of TSource, Integer, Boolean)) _ ) As IQueryable(Of TSource)`|`IQueryable<TSource> TakeWhile<TSource>( this IQueryable<TSource> source, Expression<Func\<TSource, int, bool>> predicate )`|  
+  
+## <a name="see-also"></a>関連項目  
+ [LINQ to Entities クエリ内の標準クエリ演算子](../../../../../../docs/framework/data/adonet/ef/language-reference/standard-query-operators-in-linq-to-entities-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/then-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/then-entity-sql.md
new file mode 100644
index 00000000000..ce1968abc8a
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/then-entity-sql.md
@@ -0,0 +1,57 @@
+---
+title: "THEN (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 54222642-23c6-4f61-9861-67caca53ac5f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# THEN (Entity SQL)
+WHEN 句が `true` として評価された場合の結果です。  
+  
+## 構文  
+  
+```  
+  
+WHEN when_expression THEN then_expression  
+```  
+  
+## 引数  
+ `when_expression`  
+ 任意の有効なブール式。  
+  
+ `then_expression`  
+ コレクションを返す任意の有効なクエリ式。  
+  
+## 解説  
+ `when_expression` が `true` として評価された場合、対応する `then-expression` が評価されます。 WHEN の条件が満たされなかった場合は、`else-expression` が評価されます。 ただし、`else-expression` が存在しない場合、結果は NULL になります。  
+  
+ 例については、「[CASE](../../../../../../docs/framework/data/adonet/ef/language-reference/case-entity-sql.md)」を参照してください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、CASE 式を使用して、一連の `Boolean` 式を評価します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#CASE_WHEN_THEN_ELSE](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#case_when_then_else)]  
+  
+## 参照  
+ [CASE](../../../../../../docs/framework/data/adonet/ef/language-reference/case-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/top-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/top-entity-sql.md
new file mode 100644
index 00000000000..d8bfdccb8d1
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/top-entity-sql.md
@@ -0,0 +1,65 @@
+---
+title: "TOP (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 4a4a0954-82e2-4eae-bcaf-7c4552f3532d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# TOP (Entity SQL)
+SELECT 句には、オプションの ALL\/DISTINCT 修飾子に続けてオプションの TOP サブ句を指定できます。 TOP サブ句は、クエリ結果の先頭から指定した行セットだけを返すよう指定します。  
+  
+## 構文  
+  
+```  
+  
+[ TOP (n) ]  
+```  
+  
+## 引数  
+ `n`  
+ 返す行の数を指定する数値式。`n` は単一の数値リテラルかまたは単一のパラメーターです。  
+  
+## 解説  
+ TOP 式には、単一の数値リテラルまたは単一のパラメーターを使用してください。 定数リテラルを使用する場合は、リテラルの種類を Edm.Int64 \(byte、int16、int32、int64、または Edm.Int64 に昇格可能な型にマップされる任意のプロバイダー型\) に暗黙的に昇格でき、その値が 0 以上である必要があります。 それ以外の場合は、例外が発生します。 パラメーターを式として使用する場合は、パラメーター型も Edm.Int64 に暗黙的に昇格できる必要がありますが、パラメーター値は遅延バインドされるため、コンパイル時に実際のパラメーター値は検証されません。  
+  
+ 定数 TOP 式の例を以下に示します。  
+  
+ `select distinct top(10) c.a1, c.a2 from T as a`  
+  
+ パラメーター化された TOP 式の例を以下に示します。  
+  
+ `select distinct top(@topParam) c.a1, c.a2 from T as a`  
+  
+ TOP は、クエリが並べ替えられていない限り、非決定的です。 確定的な結果が必要な場合は、[ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md) 句の [SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md) サブ句および [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md) サブ句を使用します。 TOP     SKIP\/LIMIT  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリは、TOP を使用して、クエリ結果から返される 1 番上の 1 行を指定します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#TOP](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#top)]  
+  
+## 参照  
+ [SELECT](../../../../../../docs/framework/data/adonet/ef/language-reference/select-entity-sql.md)   
+ [SKIP](../../../../../../docs/framework/data/adonet/ef/language-reference/skip-entity-sql.md)   
+ [LIMIT](../../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md)   
+ [ORDER BY](../../../../../../docs/framework/data/adonet/ef/language-reference/order-by-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/treat-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/treat-entity-sql.md
new file mode 100644
index 00000000000..20fd9e87aab
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/treat-entity-sql.md
@@ -0,0 +1,84 @@
+---
+title: "TREAT (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 5b77f156-55de-4cb4-8154-87f707d4c635
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# TREAT (Entity SQL)
+特定の基本データ型のオブジェクトを指定の派生型のオブジェクトとして処理します。  
+  
+## 構文  
+  
+```  
+  
+TREAT (expression as type)  
+```  
+  
+## 引数  
+ `expression`  
+ エンティティを返す任意の有効なクエリ式。  
+  
+> [!NOTE]
+>  指定の式の型は、特定のデータ型のサブタイプである必要があります。または、データ型は式の型のサブタイプである必要があります。  
+  
+ `type`  
+ エンティティ型。 型は名前空間で修飾する必要があります。  
+  
+> [!NOTE]
+>  指定の式は、特定のデータ型のサブタイプである必要があります。または、データ型は式のサブタイプである必要があります。  
+  
+## 戻り値  
+ 指定されたデータ型の値。  
+  
+## 解説  
+ TREAT は関連クラス間でキャストを実行するために使用します。 たとえば、`Employee` が `Person` から派生し、p が `Person` 型である場合、`TREAT(p AS NamespaceName.Employee)` はジェネリック型の `Person` インスタンスを `Employee` にキャストします。つまり、p を `Employee` として処理できます。  
+  
+ TREAT は、次のようにクエリを実行できる継承シナリオで使用されます。  
+  
+```  
+SELECT TREAT(p AS NamespaceName.Employee)  
+FROM ContainerName.Person AS p  
+WHERE p IS OF (NamespaceName.Employee)   
+```  
+  
+ このクエリは、`Person` エンティティを `Employee` 型にキャストします。 p の値が実際には `Employee` 型でない場合、この式は `null` 値を返します。  
+  
+> [!NOTE]
+>  指定された式 ```Employee``` は、指定されたデータ型 `Person` のサブタイプである必要があります。または、データ型は式のサブタイプである必要があります。 そうでない場合は、コンパイル時にエラーが発生します。  
+  
+ 次の表に、いくつかの通常パターンと一般的でないパターンにおける TREAT の動作を示します。 すべての例外はクライアント側にスローされてから、プロバイダーが呼び出されます。  
+  
+|パターン|動作|  
+|----------|--------|  
+|`TREAT (null AS EntityType)`|`DbNull` を返します。|  
+|`TREAT (null AS ComplexType)`|例外をスローします。|  
+|`TREAT (null AS RowType)`|例外をスローします。|  
+|`TREAT (EntityType AS EntityType)`|`EntityType` または `null` を返します。|  
+|`TREAT (ComplexType AS ComplexType)`|例外をスローします。|  
+|`TREAT (RowType AS RowType)`|例外をスローします。|  
+  
+## 使用例  
+ 次の [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリでは、TREAT 演算子を使用して、Course 型のオブジェクトを OnsiteCourse 型のオブジェクトのコレクションに変換します。 このクエリは、[School モデル](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac)に基づいています。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#TREAT_ISOF](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#treat_isof)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [NULL 値が許容される構造化型](../../../../../../docs/framework/data/adonet/ef/language-reference/nullable-structured-types-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md
new file mode 100644
index 00000000000..06675518480
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/type-definitions-entity-sql.md
@@ -0,0 +1,98 @@
+---
+title: "型定義 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 306b204a-ade5-47ef-95b5-c785d2da4a7e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 型定義 (Entity SQL)
+型定義は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] Inline 関数の宣言ステートメントで使用されます。  
+  
+## 解説  
+ Inline 関数の宣言ステートメントは、[FUNCTION](../../../../../../docs/framework/data/adonet/ef/language-reference/function-entity-sql.md) キーワード、それに続く関数名を表す識別子 \(例 : "MyAvg"\)、およびそれに続くかっこで囲まれたパラメーター定義リスト \(例 : "dues Collection\(Decimal\)"\) で構成されます。  
+  
+ パラメーター定義リストは、0 個以上のパラメーター定義で構成されます。  各パラメーター定義は、識別子 \(関数のパラメーターの名前。例 : "dues"\) とそれに続く型定義 \(例 : "Collection\(Decimal\)"\) で構成されます。  
+  
+ 型定義は、次のいずれかになります。  
+  
+-   識別子の型 \("Int32" や "AdventureWorks.Order" など\)。  
+  
+-   キーワード `COLLECTION` とそれに続くかっこに囲まれた別の型定義 \(例 : "Collection\(AdventureWorks.Order\)"\)。  
+  
+-   キーワード ROW とそれに続くかっこに囲まれたプロパティ定義リスト \(例 : "Row\(x AdventureWorks.Order\)"\)。  プロパティ定義の形式は、"`identifier type_definition`, `identifier type_definition`, ..." です。  
+  
+-   キーワード REF とそれに続くかっこに囲まれた識別子の型 \(例 : "Ref\(AdventureWorks.Order\)"\)。  REF 型定義演算子は、引数としてエンティティ型を必要とします。  引数としてプリミティブ型を指定することはできません。  
+  
+ 型定義を入れ子にできます \(例 : "Collection\(Row\(x Ref\(AdventureWorks.Order\)\)\)"\)。  
+  
+ 型定義のオプションは、次のとおりです。  
+  
+-   `IdentifierName supported_type`、または  
+  
+-   `IdentifierName` COLLECTION\(`type_definition`\)、または  
+  
+-   `IdentifierName` ROW\(`property_definition`\)、または  
+  
+-   `IdentifierName` REF\(`supported_entity_type`\)  
+  
+ プロパティ定義オプションは、`IdentifierName type_definition` です。  
+  
+ 現在の名前空間で使用されている型であれば、いずれもサポートされます。  これには、プリミティブ型とエンティティ型の両方が含まれます。  
+  
+ サポートされるエンティティ型は、現在の名前空間で使用されているエンティティ型だけを参照します。  これには、プリミティブ型は含まれません。  
+  
+## 例  
+ 簡単な型定義の例を次に示します。  
+  
+```  
+USING Microsoft.Samples.Entity  
+Function MyRound(p1 EDM.Decimal) AS (  
+   Round(p1)  
+)  
+MyRound(CAST(1.7 as EDM.Decimal))  
+```  
+  
+ COLLECTION 型定義の例を次に示します。  
+  
+```  
+USING Microsoft.Samples.Entity  
+Function MyRound(p1 Collection(EDM.Decimal)) AS (  
+   Select Round(p1) from p1  
+)  
+MyRound({CAST(1.7 as EDM.Decimal), CAST(2.7 as EDM.Decimal)})  
+```  
+  
+ ROW 型定義の例を次に示します。  
+  
+```  
+USING Microsoft.Samples.Entity  
+Function MyRound(p1 Row(x EDM.Decimal)) AS (  
+   Round(p1.x)  
+)  
+select MyRound(row(a as x)) from {CAST(1.7 as EDM.Decimal), CAST(2.7 as EDM.Decimal)} as a  
+```  
+  
+ REF 型定義の例を次に示します。  
+  
+```  
+USING Microsoft.Samples.Entity  
+Function UnReference(p1 Ref(AdventureWorks.Order)) AS (  
+   Deref(p1)  
+)  
+select Ref(x) from AdventureWorksEntities.SalesOrderHeaders as x  
+```  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md
new file mode 100644
index 00000000000..ac637e28b62
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/type-system-entity-sql.md
@@ -0,0 +1,67 @@
+---
+title: "型システム (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 818a505b-a196-41dd-aaac-2ccd5f7a2f1a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 型システム (Entity SQL)
+[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、次に示すように多数の型をサポートしています。  
+  
+-   `Int32` や `String` などのプリミティブ型 \(単純型\)。  
+  
+-   <xref:System.Data.Metadata.Edm.EntityType>、<xref:System.Data.Metadata.Edm.ComplexType>、<xref:System.Data.Metadata.Edm.RelationshipType> など、スキーマで定義される標準型。  
+  
+-   <xref:System.Data.Metadata.Edm.CollectionType>、<xref:System.Data.Metadata.Edm.RowType>、<xref:System.Data.Metadata.Edm.RefType> など、明示的にはスキーマで定義されない匿名型。  
+  
+ ここでは、明示的にはスキーマで定義されていなくても [!INCLUDE[esql](../../../../../../includes/esql-md.md)] でサポートされている匿名型について説明します。  プリミティブ型および標準型については、「[Conceptual Model Types \(CSDL\)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)」を参照してください。  
+  
+## 行  
+ 行の構造は、行を構成する型指定された名前付きのメンバーの配列に依存します。  行型には ID がなく、派生元にすることはできません。  同じ行型のインスタンスは、メンバーがそれぞれ同等である場合は同等になります。  行には構造同値以外の動作はなく、共通言語ランタイムに同等のものはありません。  クエリの結果は、行または行のコレクションを含む構造になります。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] クエリとホスト言語の間の API バインドは、結果を生成したクエリでどのように行が構成されるかを定義します。  行インスタンスの作成方法については、「[コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)」を参照してください。  
+  
+## コレクション  
+ コレクション型は、他のオブジェクトの 0 個以上のインスタンスを表します。  コレクションの作成方法については、「[コンストラクター](../../../../../../docs/framework/data/adonet/ef/language-reference/constructing-types-entity-sql.md)」を参照してください。  
+  
+## 参照  
+ 参照とは、特定のエンティティ セットにある特定のエンティティへの論理ポインターです。  
+  
+ [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、参照の構築、分解、およびナビゲートを行うための次の演算子がサポートされています。  
+  
+-   [REF](../../../../../../docs/framework/data/adonet/ef/language-reference/ref-entity-sql.md)  
+  
+-   [CREATEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/createref-entity-sql.md)  
+  
+-   [KEY](../../../../../../docs/framework/data/adonet/ef/language-reference/key-entity-sql.md)  
+  
+-   [DEREF](../../../../../../docs/framework/data/adonet/ef/language-reference/deref-entity-sql.md)  
+  
+ メンバー アクセス \(ドット\) 演算子 \(`.`\) を使用して参照によるナビゲーションを行うことができます。  次のコード例では、r \(参照\) プロパティによるナビゲーションで Order の Id プロパティを取得します。  
+  
+```  
+select o2.r.Id   
+from (select ref(o) as r from LOB.Orders as o) as o2   
+```  
+  
+ 参照値が null であるか、参照先が存在しない場合、結果は null になります。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [CAST](../../../../../../docs/framework/data/adonet/ef/language-reference/cast-entity-sql.md)   
+ [CSDL、SSDL、および MSL 仕様](../../../../../../docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/union-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/union-entity-sql.md
new file mode 100644
index 00000000000..876965e6973
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/union-entity-sql.md
@@ -0,0 +1,62 @@
+---
+title: "UNION (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: df98a4db-b00d-4c8b-bd74-0d285f27e1df
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# UNION (Entity SQL)
+複数のクエリの結果を 1 つのコレクションに結合します。  
+  
+## 構文  
+  
+```  
+  
+          expression  
+UNION [ ALL ]  
+expression  
+```  
+  
+## 引数  
+ `expression`  
+ コレクションと結合するコレクションを返す任意の有効なクエリ式。すべての式は、`expression` と同じ型であるか、共通の基本データ型または派生型である必要があります。  
+  
+ UNION  
+ 複数のコレクションを結合し、1 つのコレクションとして返すことを指定します。  
+  
+ ALL  
+ 複数のコレクションを結合し、重複も含めて 1 つのコレクションとして返すことを指定します。 指定しない場合、重複は結果コレクションから削除されます。  
+  
+## 戻り値  
+ `expression` と同じ型であるか、共通の基本データ型または派生型であるコレクション。  
+  
+## 解説  
+ UNION は、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の 1 つです。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] のすべての集合演算子は左から右に評価されます。[!INCLUDE[esql](../../../../../../includes/esql-md.md)] の集合演算子の優先順位に関する情報については、「[EXCEPT](../../../../../../docs/framework/data/adonet/ef/language-reference/except-entity-sql.md)」をご覧ください。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、UNION ALL 演算子を使用して、2 つのクエリの結果を 1 つのコレクションに結合します。 このクエリは、AdventureWorks Sales Model に基づいています。 このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[StructuralType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-structuraltype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecuteStructuralTypeQuery` メソッドに渡します。  
+  
+ [!code-csharp[DP EntityServices Concepts 2#UNION](../../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts 2/cs/entitysql.cs#union)]  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md
new file mode 100644
index 00000000000..6b6718cf59e
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/unsupported-expressions-entity-sql.md
@@ -0,0 +1,47 @@
+---
+title: "サポートされていない式 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 5e79da7e-e78a-413c-8fb0-f3f9cd84f579
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# サポートされていない式 (Entity SQL)
+このトピックでは、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] でサポートされていない [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] 式について説明します。詳細については、「[Entity SQL と Transact\-SQL の相違点](../../../../../../docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md)」を参照してください。  
+  
+## 定量化された述語  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、次の形式のコンストラクターを使用できます。  
+  
+```  
+sal > all (select salary from employees)  
+sal > any (select salary from employees)  
+```  
+  
+ ただし、[!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、このようなコンストラクターがサポートされていません。  [!INCLUDE[esql](../../../../../../includes/esql-md.md)] では、これに相当する式を次のように記述できます。  
+  
+```  
+not exists(select 0 from employees as e where sal > e.salary)  
+exists(select 0 from employees as e where sal > e.salary)  
+```  
+  
+## \* 演算子  
+ [!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] では、すべての列を投影する必要があることを示すために、SELECT 句で \* 演算子を使用できます。  これは [!INCLUDE[esql](../../../../../../includes/esql-md.md)] でサポートされていません。  
+  
+## 参照  
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)   
+ [Entity SQL と Transact\-SQL の相違点](../../../../../../docs/framework/data/adonet/ef/language-reference/how-entity-sql-differs-from-transact-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md
new file mode 100644
index 00000000000..a22afab7865
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/user-defined-functions-entity-sql.md
@@ -0,0 +1,25 @@
+---
+title: "ユーザー定義関数 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f9e6bbd-8e5a-43e1-809f-f8a61338e522
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ユーザー定義関数 (Entity SQL)
+Entity SQL では、クエリ内でのユーザー定義関数の呼び出しがサポートされます。  これらの関数は、クエリでインラインで定義する \(「[How to: Call a User\-Defined Function](http://msdn.microsoft.com/ja-jp/ad131b86-8b4e-4747-8605-d4fc64fb9d02)」を参照\) ことも、概念モデルの一部として定義する \(「[How to: Define Custom Functions in the Conceptual Model](http://msdn.microsoft.com/ja-jp/0dad7b8b-58f6-4271-b238-f34810d68e5f)」を参照\) こともできます。  概念モデル関数は、概念モデルの [Function](http://msdn.microsoft.com/ja-jp/dc3beca7-55cf-4977-8db0-5064cdbab134) 要素の [DefiningExpression](http://msdn.microsoft.com/ja-jp/d3da8d8b-a048-47ee-8d81-0c2ea3acdd3e) 要素における Entity SQL コマンドとして定義されます。  
+  
+ Entity SQL を使用すると、関数をクエリ コマンド自体で定義することができます。  [FUNCTION](../../../../../../docs/framework/data/adonet/ef/language-reference/function-entity-sql.md) 演算子は、インライン関数を定義します。  複数の関数を 1 つのコマンドで定義することができます。関数の署名が一意であれば、これら複数の関数に同じ名前を付けることができます。  詳細については、「[関数のオーバーロードの解決方法](../../../../../../docs/framework/data/adonet/ef/language-reference/function-overload-resolution-entity-sql.md)」を参照してください。  
+  
+## 参照  
+ [関数](../../../../../../docs/framework/data/adonet/ef/language-reference/functions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/using-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/using-entity-sql.md
new file mode 100644
index 00000000000..3443a2060ca
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/using-entity-sql.md
@@ -0,0 +1,53 @@
+---
+title: "USING (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 20f58b8f-6070-4456-b7e8-5ff3d6269273
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# USING (Entity SQL)
+クエリ式で使用する名前空間を指定します。  
+  
+## 構文  
+  
+```  
+USING [ alias = ] namespace  
+```  
+  
+## 引数  
+ `alias`  
+ 名前空間を修飾する短い別名。  
+  
+ `namespace`  
+ 任意の有効な名前空間。  
+  
+## 使用例  
+ 次の Entity SQL クエリでは、USING 演算子を使用して、クエリ式に使用する名前空間が指定されています。  このクエリをコンパイルして実行するには、次の手順を実行します。  
+  
+1.  「[PrimitiveType 結果を返すクエリの実行方法](../../../../../../docs/framework/data/adonet/ef/how-to-execute-a-query-that-returns-primitivetype-results.md)」の手順に従います。  
+  
+2.  次のクエリを引数として `ExecutePrimitiveTypeQuery` メソッドに渡します。  
+  
+```  
+using SqlServer; RAND()  
+```  
+  
+## 参照  
+ [名前空間](../../../../../../docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md)   
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/variables-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/variables-entity-sql.md
new file mode 100644
index 00000000000..3187c3ffd21
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/variables-entity-sql.md
@@ -0,0 +1,38 @@
+---
+title: "変数 (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: 3eed222a-f8f6-46b6-9cd5-220cc0e4e5d8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 変数 (Entity SQL)
+## 変数  
+ 変数式は、現在のスコープで定義されている名前付きの式への参照です。  変数参照は、[識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md) で定義された有効な [!INCLUDE[esql](../../../../../../includes/esql-md.md)] 識別子である必要があります。  
+  
+ 次の例は、式における変数の使用方法を示しています。  FROM 句の `c` は変数の定義です。  SELECT 句内で使用された `c` は、変数参照を表します。  
+  
+```  
+select c   
+from LOB.customers as c  
+```  
+  
+## 参照  
+ [識別子](../../../../../../docs/framework/data/adonet/ef/language-reference/identifiers-entity-sql.md)   
+ [パラメーター](../../../../../../docs/framework/data/adonet/ef/language-reference/parameters-entity-sql.md)   
+ [Entity SQL の概要](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/language-reference/where-entity-sql.md b/docs/framework/data/adonet/ef/language-reference/where-entity-sql.md
new file mode 100644
index 00000000000..e8aa62d82d5
--- /dev/null
+++ b/docs/framework/data/adonet/ef/language-reference/where-entity-sql.md
@@ -0,0 +1,50 @@
+---
+title: "WHERE (Entity SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+ms.assetid: a8e1061e-0028-4a6f-8f19-b9f48e96c4b8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# WHERE (Entity SQL)
+WHERE 句は、[FROM](../../../../../../docs/framework/data/adonet/ef/language-reference/from-entity-sql.md) 句の直後に適用されます。  
+  
+## 構文  
+  
+```  
+[ WHERE expression ]  
+```  
+  
+## 引数  
+ `expression`  
+ ブール型です。  
+  
+## 解説  
+ WHERE 句は、[!INCLUDE[tsql](../../../../../../includes/tsql-md.md)] で設定された場合と同じセマンティクスを持ちます。  ソース コレクションの要素を条件を満たすものに制限することで、クエリ式によって生成されるオブジェクトを制限します。  
+  
+```  
+select c from cs as c where e  
+```  
+  
+ 式 `e` には Boolean 型が含まれる必要があります。  
+  
+ WHERE 句は、FROM 句の直後、およびグループ化、順序付け、または投影が実行される前に適用されます。  FROM 句で定義されたすべての要素名は、WHERE 句の式に対して表示されます。  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [クエリ式](../../../../../../docs/framework/data/adonet/ef/language-reference/query-expressions-entity-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/mathematical-functions.md b/docs/framework/data/adonet/ef/mathematical-functions.md
new file mode 100644
index 00000000000..720c2ceb562
--- /dev/null
+++ b/docs/framework/data/adonet/ef/mathematical-functions.md
@@ -0,0 +1,61 @@
+---
+title: "数学関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b040c7cb-156d-40f2-9152-61065b18148c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# 数学関数
+.NET Framework Data Provider for SQL Server \(SqlClient\) には、引数として指定された入力値に対して計算を実行し、数値結果を返す数学関数が用意されています。  これらの関数は、SqlClient の SqlServer 名前空間に存在します。  Entity Framework は、プロバイダーの名前空間プロパティを使用することにより、型や関数など、特定のコンストラクターに対してこのプロバイダーによってどのプレフィックスが使用されているかを特定できます。次の表に、SqlClient の数学関数を示します。  
+  
+|関数|説明|  
+|--------|--------|  
+|`ABS(` `expression` `)`|絶対値を求める関数です。<br /><br /> **引数**<br /><br /> `expression`: `Int32`、 `Int64`、`Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> 指定された式の絶対値。<br /><br /> **例**<br /><br /> `SqlServer.ABS(-2)`|  
+|`ACOS(` `expression` `)`|指定された式のアークコサイン \(逆余弦\) 値を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.ACOS(.9)`|  
+|`ASIN(` `expression` `)`|指定された式のアークサイン \(逆正弦\) 値を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.ASIN(.9)`|  
+|`ATAN(` `expression` `)`|指定された数値式のアークタンジェント \(逆正接\) 値を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.ATAN(9)`|  
+|`ATN2(` `expression`, `expression``)`|指定された 2 つの数値式の商がタンジェント \(正接\) となる角度をラジアンで返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.ATN2(9, 8)`|  
+|`CEILING(` `expression` `)`|指定された式をその式以上の最小整数に変換します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`、 `Int64`、`Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_CEILING](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_ceiling)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_CEILING](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_ceiling)]|  
+|`COS(` `expression` `)`|ラジアンで指定された角度のコサイン \(余弦\) を計算します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.COS(45)`|  
+|`COT(` `expression` `)`|ラジアンで指定された角度のコタンジェント \(余接\) を計算します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.COT(60)`|  
+|`DEGREES(` `radians` `)`|対応する角度を度数で返します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`、 `Int64`、`Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> **例**<br /><br /> `SqlServer.DEGREES(3.1)`|  
+|`EXP(` `expression` `)`|指定された数値式の指数値を計算します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.EXP(1)`|  
+|`FLOOR(` `expression` `)`|指定された式をその式以下の最大整数に変換します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> [!code-csharp[DP EntityServices Concepts#SQLSERVER_FLOOR](../../../../../samples/snippets/csharp/VS_Snippets_Data/dp entityservices concepts/cs/entitysql.cs#sqlserver_floor)]
+ [!code-sql[DP EntityServices Concepts#SQLSERVER_FLOOR](../../../../../samples/snippets/tsql/VS_Snippets_Data/dp entityservices concepts/tsql/entitysql.sql#sqlserver_floor)]|  
+|`LOG(` `expression` `)`|指定された `float` 型の式の自然対数を計算します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.LOG(100)`|  
+|`LOG10(` `expression` `)`|指定された `Double` 型の式の 10 を底とした対数を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.LOG10(100)`|  
+|`PI()`|π の定数値を `Double` として返します。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.PI()`|  
+|`POWER(` `numeric_expression, power_expression` `)`|指定された式の指定されたべき乗を計算します。<br /><br /> **引数**<br /><br /> `numeric_expression`: `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> `power_expression`: `numeric_expression` のべき乗値を表す `Double` 型の値。<br /><br /> **戻り値**<br /><br /> 指定された `numeric_expression` を指定された `power_expression` でべき乗した値。<br /><br /> **例**<br /><br /> `SqlServer.POWER(2,7)`|  
+|`RADIANS(` `expression` `)`|角度をラジアンに変換します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`、 `Int64`、`Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> `Int32`、`Int64`、<br /><br /> `Double`、または<br /><br /> `Decimal`.<br /><br /> **例**<br /><br /> `SqlServer.RADIANS(360.0)`|  
+|`RAND(`\[seed\]`)`|0 から 1 までの範囲の乱数を返します。<br /><br /> **引数**<br /><br /> シード値を `Int32` として返します。  シードを指定しない場合は、SQL Server データベース エンジンによってシード値がランダムに割り当てられます。  指定したシード値について、返される結果は常に同じです。<br /><br /> **戻り値**<br /><br /> 0 から 1 までの範囲の `Double` 型の乱数。<br /><br /> **例**<br /><br /> `SqlServer.RAND()`|  
+|`ROUND(` `numeric_expression, length` \[ ,`function` \]`)`|指定された長さまたは有効桁数に丸めた数値式を返します。<br /><br /> **引数**<br /><br /> `numeric_expression`: `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> `length`: `numeric_expression` を丸めた後の有効桁数を表す `Int32`。  `length` に正の値を指定した場合、`numeric_expression` は `length` で指定した小数点以下桁数に丸められます。  `length` に負の値を指定した場合、`numeric_expression` は `length` で指定した小数点の左側の位置で丸められます。<br /><br /> `function`: `` \(省略可\) 実行する操作の種類を表す `Int32`。  function を省略した場合、または 0 \(既定値\) を指定した場合、`numeric_expression` は丸められます。  0 以外の値を指定した場合、`numeric_expression` は切り捨てられます。<br /><br /> **戻り値**<br /><br /> 指定された `numeric_expression` を指定された `power_expression` でべき乗した値。<br /><br /> **例**<br /><br /> `SqlServer.ROUND(748.58, -3)`|  
+|`SIGN(` `expression` `)`|指定した式の符号として、正 \(\+1\)、負 \(\-1\)、ゼロ \(0\) のいずれかを返します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> **戻り値**<br /><br /> `Int32`、`Int64`、`Double`、または `Decimal`。<br /><br /> **例**<br /><br /> `SqlServer.SIGN(-10)`|  
+|`SIN(` `expression` `)`|ラジアンで指定された角度のサイン \(正弦\) を計算し、`Double` 式を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.SIN(20)`|  
+|`SQRT(` `expression` `)`|指定された式の平方根を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.SQRT(3600)`|  
+|`SQUARE(` `expression` `)`|指定された式の 2 乗値を返します。<br /><br /> **引数**<br /><br /> `expression`: `Double`。<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.SQUARE(25)`|  
+|`TAN(` `expression` `)`|指定された式のタンジェントを計算します。<br /><br /> **引数**<br /><br /> `expression`: `Double`<br /><br /> **戻り値**<br /><br /> `Double`<br /><br /> **例**<br /><br /> `SqlServer.TAN(45.0)`|  
+  
+ SqlClient でサポートされる数学関数の詳細については、SqlClient プロバイダー マニフェストで指定した SQL Server のバージョンのドキュメントを参照してください。  
+  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|---------------------|---------------------|---------------------|  
+|[数学関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115913)|[数学関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115911)|[数学関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115912)|  
+  
+## 参照  
+ [Entity Framework 用 SqlClient 関数](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/media/1ec61ed3-fcdd-4649-9089-24385be7e423.gif b/docs/framework/data/adonet/ef/media/1ec61ed3-fcdd-4649-9089-24385be7e423.gif
new file mode 100644
index 00000000000..56d2ed31409
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/1ec61ed3-fcdd-4649-9089-24385be7e423.gif differ
diff --git a/docs/framework/data/adonet/ef/media/406d4f5f-6166-44ea-8e74-c5001d5d5d79.gif b/docs/framework/data/adonet/ef/media/406d4f5f-6166-44ea-8e74-c5001d5d5d79.gif
new file mode 100644
index 00000000000..ed876ed2c92
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/406d4f5f-6166-44ea-8e74-c5001d5d5d79.gif differ
diff --git a/docs/framework/data/adonet/ef/media/430180f5-4fb9-4bc3-8589-d566512d9703.gif b/docs/framework/data/adonet/ef/media/430180f5-4fb9-4bc3-8589-d566512d9703.gif
new file mode 100644
index 00000000000..fe08f2996a7
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/430180f5-4fb9-4bc3-8589-d566512d9703.gif differ
diff --git a/docs/framework/data/adonet/ef/media/558ba7b3-dd19-48d0-b91e-30a76415bf5f.gif b/docs/framework/data/adonet/ef/media/558ba7b3-dd19-48d0-b91e-30a76415bf5f.gif
new file mode 100644
index 00000000000..3b5fcdd8d78
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/558ba7b3-dd19-48d0-b91e-30a76415bf5f.gif differ
diff --git a/docs/framework/data/adonet/ef/media/7510346f-8b09-4c99-b411-40af239c3c4d.gif b/docs/framework/data/adonet/ef/media/7510346f-8b09-4c99-b411-40af239c3c4d.gif
new file mode 100644
index 00000000000..cb2d454ffdd
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/7510346f-8b09-4c99-b411-40af239c3c4d.gif differ
diff --git a/docs/framework/data/adonet/ef/media/9456d6a9-ea2e-40ae-accc-a10e18e28b81.gif b/docs/framework/data/adonet/ef/media/9456d6a9-ea2e-40ae-accc-a10e18e28b81.gif
new file mode 100644
index 00000000000..a34fe5f2849
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/9456d6a9-ea2e-40ae-accc-a10e18e28b81.gif differ
diff --git a/docs/framework/data/adonet/ef/media/b42a7a5c-0ac0-4911-86be-0460a78760ba.gif b/docs/framework/data/adonet/ef/media/b42a7a5c-0ac0-4911-86be-0460a78760ba.gif
new file mode 100644
index 00000000000..f606fadb3a9
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/b42a7a5c-0ac0-4911-86be-0460a78760ba.gif differ
diff --git a/docs/framework/data/adonet/ef/media/ca62c31b-7ff6-4836-b209-e16166304fdc.gif b/docs/framework/data/adonet/ef/media/ca62c31b-7ff6-4836-b209-e16166304fdc.gif
new file mode 100644
index 00000000000..80c47c6e316
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/ca62c31b-7ff6-4836-b209-e16166304fdc.gif differ
diff --git a/docs/framework/data/adonet/ef/media/cd2afa99-7256-4c63-aaa9-c2d13f18a3d8.gif b/docs/framework/data/adonet/ef/media/cd2afa99-7256-4c63-aaa9-c2d13f18a3d8.gif
new file mode 100644
index 00000000000..254a309aeb1
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/cd2afa99-7256-4c63-aaa9-c2d13f18a3d8.gif differ
diff --git a/docs/framework/data/adonet/ef/media/d541eba3-2ee6-4cd1-88f5-89d0b2582a6c.gif b/docs/framework/data/adonet/ef/media/d541eba3-2ee6-4cd1-88f5-89d0b2582a6c.gif
new file mode 100644
index 00000000000..27ce186af51
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/d541eba3-2ee6-4cd1-88f5-89d0b2582a6c.gif differ
diff --git a/docs/framework/data/adonet/ef/media/de1ca705-4f7c-4d2d-ace5-afefc6d3cefa.gif b/docs/framework/data/adonet/ef/media/de1ca705-4f7c-4d2d-ace5-afefc6d3cefa.gif
new file mode 100644
index 00000000000..c23fe6e4bd7
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/de1ca705-4f7c-4d2d-ace5-afefc6d3cefa.gif differ
diff --git a/docs/framework/data/adonet/ef/media/dfb3d02b-7a8c-4d51-ac5a-a73d8aa145e6.gif b/docs/framework/data/adonet/ef/media/dfb3d02b-7a8c-4d51-ac5a-a73d8aa145e6.gif
new file mode 100644
index 00000000000..40da39313fa
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/dfb3d02b-7a8c-4d51-ac5a-a73d8aa145e6.gif differ
diff --git a/docs/framework/data/adonet/ef/media/wd-efarchdiagram.gif b/docs/framework/data/adonet/ef/media/wd-efarchdiagram.gif
new file mode 100644
index 00000000000..b25af328910
Binary files /dev/null and b/docs/framework/data/adonet/ef/media/wd-efarchdiagram.gif differ
diff --git a/docs/framework/data/adonet/ef/migration-considerations.md b/docs/framework/data/adonet/ef/migration-considerations.md
new file mode 100644
index 00000000000..4fd3f086514
--- /dev/null
+++ b/docs/framework/data/adonet/ef/migration-considerations.md
@@ -0,0 +1,111 @@
+---
+title: "移行に関する注意事項 (Entity Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: c85b6fe8-cc32-4642-8f0a-dc0e5a695936
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# 移行に関する注意事項 (Entity Framework)
+[!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] Entity Framework には、既存のアプリケーションにとっていくつかの利点があります。  特に重要な利点の 1 つが、概念モデルを使用して、アプリケーションで使用するデータ構造をデータ ソースのスキーマから分離できることです。  これにより、ストレージ モデルやデータ ソース自体の将来の変更が容易になり、その変更を補うための変更をアプリケーションに加える必要がなくなります。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するメリットについては,「[エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)」および「[Entity Data Model](../../../../../docs/framework/data/adonet/entity-data-model.md)」を参照してください。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の利点を活用するために既存のアプリケーションを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に移行することができます。  移行作業の一部はすべてのアプリケーションに共通です。  こうした共通の作業には、[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] Version 3.5 Service Pack 1 \(SP1\) 以降を使用するようにアプリケーションをアップグレードする作業のほか、モデルおよびマッピングの定義や Entity Framework の構成などが含まれます。  そのほか、アプリケーションを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に移行する際には、  移行するアプリケーションの種類やアプリケーションの特定の機能に依存する注意点もあります。  このトピックでは、既存のアプリケーションをアップグレードする際に最適な方法を選択するために役立つ情報を紹介します。  
+  
+## 全般的な移行の注意点  
+ アプリケーションを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に移行する際には次の点に注意してください。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] Version 3.5 SP1 以降を使用しているアプリケーションはどれでも Entity Framework に移行できますが、アプリケーションが使用するデータ ソースのデータ プロバイダーで Entity Framework がサポートされている必要があります。  
+  
+-   データ ソース プロバイダーが Entity Framework をサポートしていても、そのプロバイダーのすべての機能が Entity Framework でサポートされるとは限りません。  
+  
+-   大規模なアプリケーションや複雑なアプリケーションの場合、アプリケーション全体を一度に Entity Framework に移行する必要はありません。  ただし、Entity Framework を使用しない部分がアプリケーションにある場合、それらの部分については、データ ソースが変更された場合に変更が必要になります。  
+  
+-   [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダーを使用してデータ ソースにアクセスするため、Entity Framework が使用するデータ プロバイダー接続をアプリケーションの他の部分と共有できます   \(たとえば、Entity Framework は SqlClient プロバイダーを使用して SQL Server データベースにアクセスします\)。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+## 共通の移行作業  
+ 既存アプリケーションの [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] への移行パスは、アプリケーションの種類と既存のデータ アクセス計画の両方に依存します。  ただし、以下の作業は、既存のアプリケーションを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に移行する際に常に実行する必要があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsOrcas](../../../../../includes/vsorcas-md.md)] 以降で Entity Data Model ツールを使用すると、これらの作業はすべて自動的に実行されます。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+1.  アプリケーションをアップグレードします。  
+  
+     以前のバージョンの [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] と [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] を使用して作成したプロジェクトは、[!INCLUDE[vsOrcas](../../../../../includes/vsorcas-md.md)] SP1 と [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] Version 3.5 SP1 以降を使用するようにアップグレードする必要があります。  
+  
+2.  モデルおよびマッピングを定義します。  
+  
+     モデル ファイルとマッピング ファイルでは、概念モデルのエンティティ、データ ソースの構造 \(テーブル、ストアド プロシージャ、ビューなど\)、およびエンティティとデータ ソース構造との間のマッピングを定義します。  詳細については、「[How to: Manually Define the Model and Mapping Files](http://msdn.microsoft.com/ja-jp/d4fd6864-f2a1-48f0-aa32-1e318775a99a)」を参照してください。  
+  
+     ストレージ モデルに定義されている型は、データ ソースのオブジェクトと名前が一致している必要があります。  また、既存のアプリケーションでデータがオブジェクトとして公開されている場合は、概念モデルに定義するエンティティおよびプロパティの名前を既存のデータ クラスおよびプロパティの名前に一致させる必要があります。  詳細については、「[How to: Customize Modeling and Mapping Files to Work with Custom Objects](http://msdn.microsoft.com/ja-jp/bb40c4db-0121-4e45-a167-8fb06707a708)」を参照してください。  
+  
+    > [!NOTE]
+    >  Entity Data Model デザイナーを使用すると、概念モデルのエンティティの名前を既存のオブジェクトに合わせて変更できます。  詳細については、「[Entity Data Model Designer](http://msdn.microsoft.com/ja-jp/4ccd7ad6-b934-4f7c-82a0-cfd2d4a95faf)」を参照してください。  
+  
+3.  接続文字列を定義します。  
+  
+     [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で概念モデルに対してクエリを実行する際には特殊な形式の接続文字列を使用します。  この接続文字列は、モデル ファイルとマッピング ファイルに関する情報とデータ ソースへの接続に関する情報をカプセル化したものです。  詳細については、「[接続文字列を定義する方法](../../../../../docs/framework/data/adonet/ef/how-to-define-the-connection-string.md)」を参照してください。  
+  
+4.  [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] プロジェクトを構成します。  
+  
+     [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アセンブリへの参照とモデル ファイルおよびマッピング ファイルを [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] プロジェクトに追加する必要があります。  これらのマッピング ファイルをプロジェクトに追加することで、接続文字列で指定された場所にアプリケーションと共に配置されるようにすることができます。  詳細については、「[How to: Manually Configure an Entity Framework Project](http://msdn.microsoft.com/ja-jp/73f6ae1d-b3b2-4577-aebd-ad5a75954e9e)」を参照してください。  
+  
+## 既存のオブジェクトを含むアプリケーションの注意点  
+ [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] 4 以降では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は POCO \("plain old" CLR object、永続化非依存オブジェクトとも呼ばれます\) をサポートしています。  ほとんどの場合、既存のオブジェクトを少し変更すれば [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で使用できます。  詳細については、「[Working with POCO Entities](http://msdn.microsoft.com/ja-jp/5e0fb82a-b6d1-41a1-b37b-c12db61629d3)」を参照してください。アプリケーションを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に移行し、Entity Framework ツールによって生成されたデータ クラスを使用することもできます。  詳細については、「[How to: Use the Entity Data Model Wizard](http://msdn.microsoft.com/ja-jp/dadb058a-c5d9-4c5c-8b01-28044112231d)」を参照してください。  
+  
+## ADO.NET プロバイダーを使用するアプリケーションの注意点  
+ SqlClient などの [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] プロバイダーを使用すると、データ ソースに対するクエリを実行して表形式のデータを取得できます。  データを [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] DataSet に読み込むこともできます。  以下は、既存の [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] プロバイダーを使用するアプリケーションをアップグレードする場合の注意点です。  
+  
+ データ リーダーを使用して表形式のデータを表示している場合  
+ EntityClient プロバイダーを使用して [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリを実行して、返された <xref:System.Data.EntityClient.EntityDataReader> オブジェクトを列挙処理することも考えられますが、  この方法を使用するのは、データ リーダーを使用して表形式のデータを表示するアプリケーションで、データをオブジェクトに具体化したり、変更を追跡したり、更新を行ったりするための [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の機能が不要である場合だけにしてください。データ ソースを更新する既存のデータ アクセス コードも引き続き使用できますが、<xref:System.Data.EntityClient.EntityConnection.StoreConnection%2A> の <xref:System.Data.EntityClient.EntityConnection> プロパティから既存の接続にアクセスできます。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+ DataSet を使用している場合  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、メモリへの保持、変更の追跡、データ バインド、オブジェクトの XML データとしてのシリアル化など、DataSet によって提供される機能の多くを提供します。  詳細については、「[オブジェクトの使用](../../../../../docs/framework/data/adonet/ef/working-with-objects.md)」を参照してください。  
+  
+ アプリケーションで必要な DataSet の機能が [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって提供されない場合も、[!INCLUDE[linq_dataset](../../../../../includes/linq-dataset-md.md)] を使用して LINQ クエリを活用することができます。  詳細については、「[LINQ to DataSet](../../../../../docs/framework/data/adonet/linq-to-dataset.md)」を参照してください。  
+  
+## データをコントロールにバインドするアプリケーションの注意点  
+ [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] では、データをデータ ソース \(DataSet や [!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] データ ソース コントロールなど\) にカプセル化して、それらのデータ コントロールにユーザー インターフェイス要素をバインドすることができます。  以下は、コントロールを Entity Framework データにバインドする場合の注意点です。  
+  
+ コントロールへのデータ バインド  
+ 概念モデルに対してクエリを実行すると、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって、エンティティ型のインスタンスであるオブジェクトとしてデータが返されます。  それらのオブジェクトは直接コントロールにバインドでき、そのバインドで更新がサポートされます。したがって、<xref:System.Windows.Forms.DataGridView> メソッドが呼び出されると、コントロールのデータ \(<xref:System.Data.Objects.ObjectContext.SaveChanges%2A> の行など\) に対する変更が自動的にデータベースに保存されます。  
+  
+ クエリの結果を列挙して、データ バインドをサポートする <xref:System.Windows.Forms.DataGridView> などのコントロールにデータを表示するアプリケーションは、そのコントロールを <xref:System.Data.Objects.ObjectQuery%601> の結果にバインドするように変更できます。  
+  
+ 詳細については、「[Binding Objects to Controls](http://msdn.microsoft.com/ja-jp/2fd34855-929b-4303-a91e-4bb69d958f2b)」を参照してください。  
+  
+ [!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] データ ソース コントロール  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] には、[!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] Web アプリケーションのデータ バインドを単純化するために作られたデータ ソース コントロールが含まれています。  詳細については、「[Entity Framework データ ソース コントロール](../Topic/EntityDataSource%20Web%20Server%20Control%20Overview.md)」を参照してください。  
+  
+## その他の注意事項  
+ 以下は、特定の種類のアプリケーションを Entity Framework に移行する場合の注意点です。  
+  
+ データ サービスを公開するアプリケーション  
+ Windows Communication Foundation \(WCF\) をベースとする Web サービスやアプリケーションは、XML 要求\/応答メッセージ形式を使用して基になるデータ ソースのデータを公開します。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、バイナリ、XML、または WCF データ コントラクトのシリアル化を使用してエンティティ オブジェクトをシリアル化できます。  バイナリ シリアル化と WCF シリアル化ではオブジェクト グラフの完全なシリアル化がサポートされています。  詳細については、「[Building N\-Tier Applications](http://msdn.microsoft.com/ja-jp/9439d2ba-6b5f-44e8-be65-8a442d922cbb)」を参照してください。  
+  
+ XML データを使用するアプリケーション  
+ オブジェクトのシリアル化を使用すると、  XML データを使用するアプリケーション \(AJAX ベースのインターネット アプリケーションなど\) にデータを提供する  データ サービスを作成できます。  このような場合は [!INCLUDE[ssAstoria](../../../../../includes/ssastoria-md.md)] の使用を検討してください。  これらのデータ サービスは Entity Data Model に基づいており、GET、PUT、POST などの標準の Representational State Transfer \(REST\) HTTP アクションを使用したエンティティ データへの動的アクセスを提供します。  詳細については、「[WCF Data Services 4.5](../../../../../docs/framework/data/wcf/index.md)」を参照してください。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] はネイティブ XML データ型をサポートしていません。  そのため、XML 列を持つテーブルにエンティティをマップすると、その XML 列に対応するエンティティ プロパティは文字列になります。  このような場合は、オブジェクトを切断して XML としてシリアル化することができます。  詳細については、「[Serializing Objects](http://msdn.microsoft.com/ja-jp/06c77f9b-5b2e-4c78-b3e3-8c148ba0ea99)」を参照してください。  
+  
+ アプリケーションで XML データのクエリ機能が必要な場合も、LINQ to XML を使用して LINQ クエリを活用することができます。  詳細については、「[LINQ to XML](../../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md)」を参照してください。  
+  
+ 状態を保持するアプリケーション  
+ [!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] Web アプリケーションでは、Web ページやユーザー セッションの状態を保持しなければならないことがよくあります。  <xref:System.Data.Objects.ObjectContext> インスタンス内のオブジェクトは、クライアントのビュー ステートやサーバーのセッション状態に格納できます。格納したオブジェクトを取得して新しいオブジェクト コンテキストに再アタッチすることもできます。  詳細については、「[Attaching and Detaching Objects](http://msdn.microsoft.com/ja-jp/41d5c1ef-1b78-4502-aa10-7e1438d62d23)」を参照してください。  
+  
+## 参照  
+ [配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/deployment-considerations.md)   
+ [Entity Framework の用語](../../../../../docs/framework/data/adonet/ef/terminology.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/modeling-and-mapping.md b/docs/framework/data/adonet/ef/modeling-and-mapping.md
new file mode 100644
index 00000000000..eea783377a0
--- /dev/null
+++ b/docs/framework/data/adonet/ef/modeling-and-mapping.md
@@ -0,0 +1,32 @@
+---
+title: "モデリングとマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "ESQL"
+  - "jsharp"
+ms.assetid: ec8a9515-3708-4cde-a688-4d8e6975f150
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# モデリングとマッピング
+[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、概念モデル、ストレージ モデル、およびこの 2 つのモデル間のマッピングをアプリケーションに最適な方法で定義できます。  [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] の Entity Data Model ツールを使用すると、データベースまたはグラフィカルなモデルから .[edmx ファイル](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)を作成し、データベースまたはモデルが変更されたときにこのファイルを更新できます。  
+  
+ Entity Framework 4.1 以降では、Code First の開発を使用してモデルをプログラムで作成することもできます。  Code First の開発に対しては、2 つの異なるシナリオがあります。  どちらの場合でも、開発者は .NET Framework のクラス定義をコーディングしてモデルを定義し、データ注釈または Fluent API を使用してオプションで追加のマッピングまたは構成を指定します。  
+  
+ 詳細については、「[概念モデルの作成とマッピング](http://go.microsoft.com/fwlink/?LinkId=235016)」を参照してください。  
+  
+ また [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] に含まれている EDM のジェネレーターを使用できます。  EdmGen.exe は、既存のデータ ソースから .csdl ファイル、.ssdl ファイル、および .msl ファイルを生成します。  モデルとマッピングの内容を手動で作成することもできます。  詳細については、「[EDM ジェネレーター \(EdmGen.exe\)](../../../../../docs/framework/data/adonet/ef/edm-generator-edmgen-exe.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/modification-sql-generation.md b/docs/framework/data/adonet/ef/modification-sql-generation.md
new file mode 100644
index 00000000000..f5cc14088f9
--- /dev/null
+++ b/docs/framework/data/adonet/ef/modification-sql-generation.md
@@ -0,0 +1,297 @@
+---
+title: "変更 SQL 生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2188a39d-46ed-4a8b-906a-c9f15e6fefd1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 変更 SQL 生成
+ここでは、SQL:1999 準拠のデータベース プロバイダーのための変更 SQL 生成モジュールを開発する方法について説明します。  このモジュールは、変更コマンド ツリーを適切な SQL INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントに変換します。  
+  
+ SELECT ステートメントでの SQL 生成の詳細については、「[SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation.md)」を参照してください。  
+  
+## 変更コマンド ツリーの概要  
+ 変更 SQL 生成モジュールは、指定された入力 DbModificationCommandTree に基づいて、データベースに固有の変更 SQL ステートメントを生成します。  
+  
+ DbModificationCommandTree は、DbCommandTree から継承される変更 DML 操作 \(挿入、更新、または削除操作\) のオブジェクト モデル表現です。  DbModificationCommandTree には、次の 3 つの実装があります。  
+  
+-   DbInsertCommandTree  
+  
+-   DbUpdateCommandTree  
+  
+-   DbDeleteCommandTree  
+  
+ DbModificationCommandTree と、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって生成されるその実装は、常に単一行の操作を表します。  ここでは、これら 3 つの種類の実装と、.NET Framework Version 3.5 における制約について説明します。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/558ba7b3-dd19-48d0-b91e-30a76415bf5f.gif "558ba7b3\-dd19\-48d0\-b91e\-30a76415bf5f")  
+  
+ DbModificationCommandTree には、変更操作のターゲット セットを表す Target プロパティがあります。  入力セットを定義する Target の Expression プロパティは、常に DbScanExpression です。  DbScanExpression は、テーブルまたはビューを表すことができます。また、Target の "Defining Query" メタデータ プロパティが null 以外の場合は、クエリによって定義されたデータのセットを表すことができます。  
+  
+ モデル内で定義クエリを使用してセットが定義されているが、対応する変更操作のための関数が指定されていない場合、クエリを表す DbScanExpression は、変更のターゲットとしてプロバイダーにのみ影響を与えます。  プロバイダーによっては、このようなシナリオはサポートされません \(たとえば、SqlClient ではサポートされません\)。  
+  
+ DbInsertCommandTree は、コマンド ツリーとして表現される、単一行の挿入操作を表します。  
+  
+```  
+public sealed class DbInsertCommandTree : DbModificationCommandTree {  
+   public IList<DbModificationClause> SetClauses { get }  
+   public DbExpression Returning { get }  
+}  
+```  
+  
+ DbUpdateCommandTree は、コマンド ツリーとして表現される、単一行の更新操作を表します。  
+  
+ DbDeleteCommandTree は、コマンド ツリーとして表現される、単一行の削除操作を表します。  
+  
+### 変更コマンド ツリーのプロパティの制限  
+ 変更コマンド ツリーのプロパティに対して、次の情報および制限が適用されます。  
+  
+#### DbInsertCommandTree および DbUpdateCommandTree の Returning  
+ null 以外の場合、Returning は、コマンドがリーダーを返すことを示します。  null の場合、コマンドは、影響を受けた \(挿入または更新された\) 行の数を示すスカラー値を返します。  
+  
+ Returning 値は、挿入または更新された行に基づいて返される結果の射影を指定します。  この値は、行を表す DbNewInstanceExpression 型である必要があります。その各引数は、対応する DbModificationCommandTree の Target への参照を表す DbVariableReferenceExpression に対する DbPropertyExpression になります。  Returning プロパティで使用されている DbPropertyExpressions で表されるプロパティは、常にストア生成値または計算値となります。  DbInsertCommandTree では、行が挿入されるテーブルの 1 つ以上のプロパティがストア生成値または計算値として指定されている \(ssdl で StoreGeneratedPattern.Identity または StoreGeneratedPattern.Computed とマークされている\) 場合、Returning は null ではありません。  DbUpdateCommandTrees では、行が更新されるテーブルの 1 つ以上のプロパティがストア計算値として指定されている \(ssdl で StoreGeneratedPattern.Computed とマークされている\) 場合、Returning は null ではありません。  
+  
+#### DbInsertCommandTree および DbUpdateCommandTree の SetClauses  
+ SetClauses は、挿入または更新操作を定義する insert set 句または update set 句のリストを指定します。  
+  
+```  
+The elements of the list are specified as type DbModificationClause, which specifies a single clause in an insert or update modification operation. DbSetClause inherits from DbModificationClause and specifies the clause in a modification operation that sets the value of a property. Beginning in version 3.5 of the .NET Framework, all elements in SetClauses are of type SetClause.   
+```  
+  
+ Property は、更新する必要があるプロパティを指定します。  これは常に、対応する DbModificationCommandTree の Target への参照を表す、DbVariableReferenceExpression に対する DbPropertyExpression です。  
+  
+ Value は、プロパティを更新するための新しい値を指定します。  DbConstantExpression 型または DbNullExpression 型を使用できます。  
+  
+#### DbUpdateCommandTree および DbDeleteCommandTree の Predicate  
+ Predicate は、ターゲット コレクションのどのメンバーを更新または削除する必要があるかを判定するために使用される述語を指定します。  これは、DbExpressions の次のサブセットから構成される式ツリーです。  
+  
+-   Equals 型の DbComparisonExpression。右辺の子は以下のように制限される DbPropertyExression、左辺の子は DbConstantExpression です。  
+  
+-   DbConstantExpression  
+  
+-   以下のように制限される、DbPropertyExpresison に対する DbIsNullExpression。  
+  
+-   対応する DbModificationCommandTree の Target への参照を表す、DbVariableReferenceExpression に対する DbPropertyExpression。  
+  
+-   DbAndExpression。  
+  
+-   DbNotExpression  
+  
+-   DbOrExpression。  
+  
+## サンプル プロバイダーでの変更 SQL 生成  
+ [Entity Framework サンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616) では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] をサポートする ADO.NET データ プロバイダーのコンポーネントを説明しています。  このサンプルは、SQL Server 2005 データベースを対象としており、System.Data.SqlClient ADO.NET 2.0 データ プロバイダーの最上位にラッパーとして実装されます。  
+  
+ SQL Generation\\DmlSqlGenerator.cs ファイル内にあるサンプル プロバイダーの変更 SQL 生成モジュールは、DbModificationCommandTree を入力として受け取り、単一の変更 SQL ステートメントを生成します。この後に、DbModificationCommandTree によって指定された場合にリーダーを返す SELECT ステートメントが続く場合もあります。  生成されたコマンドの構造は、対象の SQL Server データベースの影響を受けます。  
+  
+### ヘルパー クラス: ExpressionTranslator  
+ ExpressionTranslator は、DbExpression 型のすべての変更コマンド ツリー プロパティのための一般的な軽量のトランスレーターです。  このトランスレーターは、変更コマンド ツリーのプロパティを制限する式の型の変換のみをサポートし、特定の制約を考慮して構築されています。  
+  
+ 以降では、特定の式の型へのアクセスについて説明します \(重要度の低い変換を含むノードは省略しています\)。  
+  
+### DbComparisonExpression  
+ preserveMemberValues を true に設定して ExpressionTranslator を構築したときに、右辺の定数が \(DbNullExpression ではなく\) DbConstantExpression である場合、左辺のオペランド \(DbPropertyExpressions\) が DbConstantExpression に関連付けられます。  これは、返される Select ステートメントを、影響を受けた行を識別するために生成する必要がある場合に使用されます。  
+  
+### DbConstantExpression  
+ アクセスされる定数のそれぞれに対して、パラメーターが作成されます。  
+  
+### DbPropertyExpression  
+ DbPropertyExpression のインスタンスが常に入力テーブルを表す場合、生成によって別名が作成される状況を除き \(テーブル変数が使用されたときの更新シナリオでのみこの状況が発生します\)、入力に別名を指定する必要はありません。変換には既定でプロパティ名が使用されます。  
+  
+## 挿入 SQL コマンドの生成  
+ サンプル プロバイダーで指定されている DbInsertCommandTree に対して生成される挿入コマンドは、以下に示す 2 つの挿入テンプレートのどちらかに基づいています。  
+  
+ 1 つ目のテンプレートには、SetClauses のリストの値を受け取って挿入を実行するコマンドと、挿入された行の Returning プロパティが null 以外の場合にその Returning プロパティで指定されたプロパティを返す SELECT ステートメントが含まれています。  行が挿入された場合、述語要素 "@@ROWCOUNT \> 0" は true に設定されます。  述語要素 "keyMemberI \=  keyValueI &#124; scope\_identity\(\)" は、keyMemeberI がストア生成キーの場合にのみ "keyMemberI \=  scope\_identity\(\)" という構造をとります。これは、ID \(ストア生成の ID\) 列に挿入された最後の ID 値が scope\_identity\(\) によって返されるためです。  
+  
+```  
+-- first insert Template  
+INSERT <target>   [ (setClauseProperty0, .. setClausePropertyN)]    
+VALUES (setClauseValue0, .. setClauseValueN) |  DEFAULT VALUES   
+  
+[SELECT <returning>   
+ FROM <target>   
+ WHERE @@ROWCOUNT > 0 AND keyMember0 = keyValue0 AND .. keyMemberI =  keyValueI | scope_identity()  .. AND  keyMemberN = keyValueN]  
+```  
+  
+ 2 番目のテンプレートが必要となるのは、挿入操作で行の挿入を指定するとき、主キーがストア生成値であるが整数型ではないために、scope\_identity\(\) でそのキーを使用できない場合です。  このテンプレートは、複合ストア生成キーがある場合にも使用されます。  
+  
+```  
+-- second insert template  
+DECLARE @generated_keys TABLE [(keyMember0, … keyMemberN)  
+  
+INSERT <target>   [ (setClauseProperty0, .. setClausePropertyN)]    
+ OUTPUT inserted.KeyMember0, …, inserted.KeyMemberN INTO @generated_keys  
+ VALUES (setClauseValue0, .. setClauseValueN) |  DEFAULT VALUES   
+  
+[SELECT <returning_over_t>   
+ FROM @generated_keys  AS g   
+JOIN <target> AS t ON g.KeyMember0 = t.KeyMember0 AND … g.KeyMemberN = t.KeyMemberN  
+ WHERE @@ROWCOUNT > 0   
+```  
+  
+ サンプル プロバイダーに含まれるモデルの使用例を次に示します。  この例では、DbInsertCommandTree から挿入コマンドを生成しています。  
+  
+ 次のコードは、Category を挿入します。  
+  
+```  
+using (NorthwindEntities northwindContext = new NorthwindEntities()) {  
+   Category c = new Category();  
+   c.CategoryName = "Test Category";  
+   c.Description = "A new category for testing";  
+   northwindContext.AddObject("Categories", c);  
+   northwindContext.SaveChanges();  
+}  
+```  
+  
+ このコードでは、プロバイダーに渡される次のコマンド ツリーを生成します。  
+  
+```  
+DbInsertCommandTree  
+|_Parameters  
+|_Target : 'target'  
+| |_Scan : dbo.Categories  
+|_SetClauses  
+| |_DbSetClause  
+| | |_Property  
+| | | |_Var(target).CategoryName  
+| | |_Value  
+| |   |_'Test Category'  
+| |_DbSetClause  
+| | |_Property  
+| | | |_Var(target).Description  
+| | |_Value  
+| |   |_'A new category for testing'  
+| |_DbSetClause  
+|   |_Property  
+|   | |_Var(target).Picture  
+|   |_Value  
+|     |_null  
+|_Returning  
+  |_NewInstance : Record['CategoryID'=Edm.Int32]  
+    |_Column : 'CategoryID'  
+      |_Var(target).CategoryID  
+```  
+  
+ サンプル プロバイダーによって生成されるストア コマンドは、次の SQL ステートメントです。  
+  
+```  
+insert [dbo].[Categories]([CategoryName], [Description], [Picture])  
+values (@p0, @p1, null)  
+select [CategoryID]  
+from [dbo].[Categories]  
+where @@ROWCOUNT > 0 and [CategoryID] = scope_identity()  
+```  
+  
+## 更新 SQL コマンドの生成  
+ 指定された DbUpdateCommandTree に対して、以下に示すテンプレートに基づいて、更新コマンドが生成されます。  
+  
+```  
+-- UPDATE Template   
+UPDATE <target>   
+SET setClauseProprerty0 = setClauseValue0,  .. setClauseProprertyN = setClauseValueN  | @i = 0  
+WHERE <predicate>  
+  
+[SELECT <returning>   
+ FROM <target>   
+ WHERE @@ROWCOUNT > 0 AND keyMember0 = keyValue0 AND .. keyMemberI =  keyValueI | scope_identity()  .. AND  keyMemberN = keyValueN]  
+```  
+  
+ set 句が指定されない場合にのみ、仮の set 句 \("@i \= 0"\) が設定されます。  これは、ストア計算列が再計算されるようにするためです。  
+  
+ Returning プロパティが null でない場合にのみ、SELECT ステートメントが生成され、Returning プロパティに指定されたプロパティが返されます。  
+  
+ 次の例では、サンプル プロバイダーに含まれるモデルを使用して、更新コマンドを生成します。  
+  
+ 次のユーザー コードは、Category を更新します。  
+  
+```  
+using (NorthwindEntities northwindContext = new NorthwindEntities()) {  
+   Category c = northwindContext.Categories.Where(i => i.CategoryName == "Test Category").First();  
+   c.CategoryName = "New test name";  
+   northwindContext.SaveChanges();  
+}  
+```  
+  
+ このユーザー コードは、プロバイダーに渡される次のコマンド ツリーを生成します。  
+  
+```  
+DbUpdateCommandTree  
+|_Parameters  
+|_Target : 'target'  
+| |_Scan : dbo.Categories  
+|_SetClauses  
+| |_DbSetClause  
+|   |_Property  
+|   | |_Var(target).CategoryName  
+|   |_Value  
+|     |_'New test name'  
+|_Predicate  
+| |_  
+|   |_Var(target).CategoryID  
+|   |_=  
+|   |_10  
+|_Returning   
+```  
+  
+ サンプル プロバイダーによって、次のストア コマンドが生成されます。  
+  
+```  
+update [dbo].[Categories]  
+set [CategoryName] = @p0  
+where ([CategoryID] = @p1)   
+```  
+  
+### 削除 SQL コマンドの生成  
+ 指定された DbDeleteCommandTree に対して、以下に示すテンプレートに基づいて、削除コマンドが生成されます。  
+  
+```  
+-- DELETE Template   
+DELETE <target>   
+WHERE <predicate>  
+```  
+  
+ 次の例では、サンプル プロバイダーに含まれるモデルを使用して、削除コマンドを生成します。  
+  
+ 次のユーザー コードは、Category を削除します。  
+  
+```  
+using (NorthwindEntities northwindContext = new NorthwindEntities()) {  
+   Category c = northwindContext.Categories.Where(i => i.CategoryName == "New test name").First();  
+   northwindContext.DeleteObject(c);  
+   northwindContext.SaveChanges();  
+}  
+```  
+  
+ このユーザー コードは、プロバイダーに渡される次のコマンド ツリーを生成します。  
+  
+```  
+DbDeleteCommandTree  
+|_Parameters  
+|_Target : 'target'  
+| |_Scan : dbo.Categories  
+|_Predicate  
+  |_  
+    |_Var(target).CategoryID  
+    |_=  
+    |_10  
+```  
+  
+ サンプル プロバイダーによって、次のストア コマンドが生成されます。  
+  
+```  
+delete [dbo].[Categories]  
+where ([CategoryID] = @p0)  
+```  
+  
+## 参照  
+ [Entity Framework データ プロバイダーの作成](../../../../../docs/framework/data/adonet/ef/writing-an-ef-data-provider.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/overview.md b/docs/framework/data/adonet/ef/overview.md
new file mode 100644
index 00000000000..cbb3d66d420
--- /dev/null
+++ b/docs/framework/data/adonet/ef/overview.md
@@ -0,0 +1,110 @@
+---
+title: "エンティティ フレームワークの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: a2166b3d-d8ba-4a0a-8552-6ba1e3eaaee0
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# エンティティ フレームワークの概要
+[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、データ指向のソフトウェア アプリケーション開発をサポートする ADO.NET のテクノロジ セットです。  データ指向のアプリケーションの設計者と開発者はこれまで、2 つの大きく異なる目的を達成するために苦労してきました。  解決すべきビジネス上の問題のエンティティ、リレーションシップ、およびロジックをモデル化する一方で、データの格納と取得に使用するデータ エンジンに取り組む必要もあるからです。  データは複数のストレージ システムにまたがる場合があり、それぞれに独自のプロトコルが存在します。単一のストレージ システムを使用するアプリケーションであっても、ストレージ システムの要件と効率的で保守しやすいアプリケーション コードの記述要件のバランスを取る必要があります。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用することで、開発者は、顧客や顧客の住所など、ドメイン固有のオブジェクトおよびプロパティの形式でデータを扱うことができます。そのデータが格納されている、基になるデータベース テーブルや列を意識する必要はありません。[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用すると、開発者はデータを操作するときに高い抽象化レベルで作業ができ、従来のアプリケーションよりコードの少ないデータ指向アプリケーションの作成と保守が可能になります。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] のコンポーネントであるため、[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] バージョン 3.5 SP1 以降がインストールされていれば、どのコンピューターでも [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションを実行できます。  
+  
+ このトピックの以降のセクションでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の詳細について説明します。  
+  
+-   [モデルの活用](#LifeToModels)  
+  
+-   [データへのオブジェクトのマッピング](#MappingObjectsToData)  
+  
+-   [エンティティ データに対するアクセスと変更](#AccessingData)  
+  
+-   [データ プロバイダー](#DataProviders)  
+  
+-   [Entity Data Model ツール](#Tools)  
+  
+-   [詳細情報](#LearnMore)  
+  
+<a name="LifeToModels"></a>   
+## モデルの活用  
+ アプリケーションやサービスを構築するとき、従来からの一般的な設計アプローチは、アプリケーションまたはサービスをドメイン モデル、論理モデル、および物理モデルの 3 つの部分に分割する方法です。  ドメイン モデルでは、モデル化の対象となるシステムに存在するエンティティとリレーションシップを定義します。  リレーショナル データベースの論理モデルでは、外部キー制約を用いながらエンティティおよびリレーションシップをテーブルとして正規化します。  物理モデルでは、パーティション分割やインデックス化などのストレージ情報を指定することで、特定のデータ エンジンの機能に対応します。  
+  
+ 物理モデルは、パフォーマンスを向上させるためにデータベース管理者が調整しますが、アプリケーション コードを記述するプログラマは、主に SQL クエリを記述したりストアド プロシージャを呼び出したりすることによって論理モデルを扱うことに専念します。  ドメイン モデルは通常、アプリケーションの要件を収集して伝達するためのツールとして使用されます。プロジェクトの初期段階でのみ表示および検討され、その後ほとんど使用されないのが一般的です。  概念モデルの作成を省略し、実際にリレーショナル データベースのテーブル、列、およびキーを指定することから開始する開発チームも多く存在します。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、開発者がドメイン モデル \([!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では*概念*モデルとも呼ばれる\) 内のエンティティとリレーションシップにクエリを実行し、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] がそれらの操作をデータ ソース固有のコマンドに変換するという形で、モデルが活用されます。  これにより、特定のデータ ソースへの依存関係をアプリケーションにハードコーディングしなくても済みます。  
+  
+ Code First を使用すると、概念モデルはコードのストレージ モデルにマッピングされます。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、オブジェクトの種類と定義する追加の構成に基づいて概念モデルを推論できます。  マッピング メタデータは、ドメインの種類を定義した方法とコードで指定する追加の構成情報の組み合わせに基づいて実行時に生成されます。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、メタデータに基づいて必要に応じてデータベースを生成します。  詳細については、「[概念モデルの作成とマッピング](http://go.microsoft.com/fwlink/?LinkID=235382)」を参照してください。  
+  
+ Entity Data Model ツールでの作業時には、概念モデル、ストレージ モデル、およびこの 2 者間のマッピングは、XML ベースのスキーマで表され、名前の拡張子が同じファイルで定義されます。  
+  
+-   概念モデルは概念スキーマ定義言語 \(CSDL\) で定義されます。  CSDL は、[Entity Data Model](../../../../../docs/framework/data/adonet/entity-data-model.md) の [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の実装です。  ファイル拡張子は .csdl です。  
+  
+-   ストア スキーマ定義言語ファイル \(SSDL\) はストレージ モデル \(論理モデルとも呼ばれる\) を定義します。  ファイル拡張子は .ssdl です。  
+  
+-   マッピング仕様言語ファイル \(MSL\) はストレージ モデルと概念モデルの間のマッピングを定義します。  ファイル拡張子は .msl です。  
+  
+ ストレージ モデルとマッピングは、概念モデル、データ クラス、またはアプリケーション コードを変更することなく、必要に応じて変更できます。  ストレージ モデルはプロバイダー固有なので、データ ソースの違いを意識することなく一貫した概念モデルを扱うことができます。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、これらのモデル ファイルとマッピング ファイルを使用して、概念モデルのエンティティとリレーションシップに対する作成、読み取り、更新、削除などの操作を、データ ソースの同等の操作に変換します。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、概念モデルのエンティティをデータ ソースのストアド プロシージャにマップする操作もサポートしています。  詳細については、「[CSDL、SSDL、および MSL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/csdl-ssdl-and-msl-specifications.md)」を参照してください。  
+  
+<a name="MappingObjectsToData"></a>   
+## データへのオブジェクトのマッピング  
+ オブジェクト指向プログラミングには、データ ストレージ システムと対話するという難題があります。  クラスの編成はリレーショナル データベース テーブルの編成に似ている場合がありますが、完全に一致するわけではありません。  正規化された複数のテーブルと単一のクラスが対応する場合も多く、クラス間のリレーションシップとテーブル間のリレーションシップとで表現方法が異なる場合もあります。  たとえば、販売注文の顧客を表すために、`Order` クラスは `Customer` クラスのインスタンスへの参照が含まれているプロパティを使用する一方で、データベースの `Order` テーブル行には `Customer` テーブルの主キー値に対応する値がある外部キー列 \(または列セット\) が含まれている場合があります。  `Customer` クラスには `Order` クラスのインスタンスのコレクションが含まれている `Orders` という名前のプロパティがありますが、データベースの `Customer` テーブルに同等の列がない場合などです。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、この方法でリレーションシップを表すか、データベースで表されるリレーションシップに似せるかの柔軟性を開発者に与えます。  
+  
+ 既存のソリューションでは、"インピーダンスのミスマッチ" とよく呼ばれるこの差異を、オブジェクト指向のクラスやプロパティをリレーショナル テーブルやリレーショナル列にマップするだけで埋めようとしてきました。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、この従来の方法を使用せずに、論理モデルのリレーショナル テーブル、列、および外部キー制約を概念モデルのエンティティとリレーションシップにマップします。  これにより、さらに柔軟にオブジェクトを定義して論理モデルを最適化することが可能になります。  [!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ツールでは、概念モデルに基づく拡張可能なデータ クラスが生成されます。  このクラスは、開発者が追加するメンバーで拡張できる部分クラスです。  既定では、特定の概念モデルに対して生成されるクラスは、エンティティをオブジェクトとして具体化したり変更を追跡したり保存したりするサービスを提供する基本クラスから派生します。  開発者はこのようなクラスを使用して、エンティティとリレーションシップを、アソシエーションによって関連付けられたオブジェクトとして操作できます。  また、開発者は、概念モデルに生成されるクラスをカスタマイズすることもできます。詳細については、「[オブジェクトの使用](../../../../../docs/framework/data/adonet/ef/working-with-objects.md)」を参照してください。  
+  
+<a name="AccessingData"></a>   
+## エンティティ データに対するアクセスと変更  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は単なるオブジェクト リレーショナル マッピング ソリューションではなく、基本的には、概念モデルのエンティティとリレーションシップとして表されるデータにアプリケーションからアクセスして変更できるようにするためのものです。[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] はモデル ファイルとマッピング ファイルの情報を使用して、概念モデルで表されるエンティティ型に対するオブジェクト クエリをデータ ソース固有のクエリに変換します。  クエリ結果は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] が管理するオブジェクトに具体化されます。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、概念モデルにクエリを実行してオブジェクトを返す方法として以下の機能を提供しています。  
+  
+-   [!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)]。概念モデルで定義されているエンティティ型に対してクエリを実行するための統合言語クエリ \(LINQ\) をサポートしています。  詳細については、「[LINQ to Entities](../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)」を参照してください。  
+  
+-   [!INCLUDE[esql](../../../../../includes/esql-md.md)]。ストレージに依存しない SQL 言語。概念モデルのエンティティを直接操作し、[!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] の概念をサポートしています。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] はオブジェクト クエリと、EntityClient プロバイダーを使用して実行されるクエリの両方で使用されます。  詳細については、「[Entity SQL の概要](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)」を参照してください。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] には、EntityClient データ プロバイダーが含まれています。  このプロバイダーは接続を管理し、エンティティ クエリをデータ ソース固有のクエリに変換し、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] がエンティティ データをオブジェクトに具体化するために使用するデータ リーダーを返します。  オブジェクトの具体化が不要であれば、アプリケーションで [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリを実行して返された読み取り専用のデータ リーダーを使用できるようにすると、EntityClient プロバイダーを標準の [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダーと同様に使用することもできます。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+ 次の図は、データにアクセスするための [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アーキテクチャを示しています。  
+  
+ ![Entity Framework のアーキテクチャ ダイアグラム](../../../../../docs/framework/data/adonet/ef/media/wd-efarchdiagram.gif "wd\_EFArchDiagram")  
+  
+ [!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ツールは、概念モデルのエンティティ コンテナーを表す `System.Data.Objects.ObjectContext` または `System.Data.Entity.DbContext` から派生したクラスを生成できます。  このオブジェクト コンテキストは、変更の追跡や ID、同時実行、およびリレーションシップの管理などの機能を提供します。  また、このクラスは、データ ソースに挿入、更新、および削除を書き込む `SaveChanges` メソッドも公開します。  このような変更は、クエリと同様に、システムによって自動的に生成されるコマンドで行うことも、特定のストアド プロシージャを使用するように指定することもできます。  
+  
+<a name="DataProviders"></a>   
+## データ プロバイダー  
+ `EntityClient` プロバイダーは、概念エンティティおよびリレーションシップに従ってデータにアクセスし、[!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] プロバイダー モデルを拡張します。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] を使用するクエリを実行します。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] は、`EntityClient` がデータベースと通信する基盤となるクエリ言語を提供します。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+ 更新された [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の SqlClient Data Provider は、正規コマンド ツリーをサポートしています。  詳細については、「[Entity Framework 用 SqlClient](../../../../../docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md)」を参照してください。  
+  
+<a name="Tools"></a>   
+## Entity Data Model ツール  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] ランタイムに加えて、[!INCLUDE[vs_current_long](../../../../../includes/vs-current-long-md.md)] にはマッピング ツールとモデリング ツールが含まれています。  詳細については、「[モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)」を参照してください。  
+  
+<a name="LearnMore"></a>   
+## 詳細情報  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の詳細については、次のトピックを参照してください。  
+  
+ [はじめに](../../../../../docs/framework/data/adonet/ef/getting-started.md)  
+ 簡単な [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションの作成方法を示す[Quickstart](http://msdn.microsoft.com/ja-jp/0bc534be-789f-4819-b9f6-76e51d961675) を使用して簡単に実行する方法について説明します。  
+  
+ [Entity Framework の用語](../../../../../docs/framework/data/adonet/ef/terminology.md)  
+ Entity Data Model と [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で使用されている用語や [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のドキュメントで使用されている用語を多数定義しています。  
+  
+ [Entity Framework のリソース](../../../../../docs/framework/data/adonet/ef/resources.md)  
+ 概念に関するトピックへのリンクや [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションの構築に関する外部トピックおよびリソースへのリンクを示します。  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/performance-considerations.md b/docs/framework/data/adonet/ef/performance-considerations.md
new file mode 100644
index 00000000000..7fe9832a808
--- /dev/null
+++ b/docs/framework/data/adonet/ef/performance-considerations.md
@@ -0,0 +1,164 @@
+---
+title: "パフォーマンスに関する考慮事項 (Entity Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61913f3b-4f42-4d9b-810f-2a13c2388a4a
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# パフォーマンスに関する考慮事項 (Entity Framework)
+このトピックでは、ADO.NET Entity Framework のパフォーマンス特性を示し、Entity Framework アプリケーションのパフォーマンスを向上させるために役立つ注意事項について説明します。  
+  
+## クエリ実行の段階  
+ Entity Framework でのクエリのパフォーマンスをより深く理解するには、概念モデルに対して実行されたクエリがデータをオブジェクトとして返す際の動作を知る必要があります。  この一連の動作を次の表に示します。  
+  
+|操作|相対コスト|頻度|コメント|  
+|--------|-----------|--------|----------|  
+|メタデータの読み込み|中|各アプリケーション ドメイン内で 1 回|Entity Framework が使用するモデルとマッピングのメタデータが、<xref:System.Data.Metadata.Edm.MetadataWorkspace> に読み込まれます。  このメタデータはグローバルにキャッシュされ、同じアプリケーション ドメイン内にある <xref:System.Data.Objects.ObjectContext> の他のインスタンスも使用できるようになります。|  
+|データベース接続を開く|中<sup>1</sup>|必要時|データベースへの接続では貴重なリソースが消費されるので、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は必要な場合のみデータベース接続の開閉を行います。  接続は、明示的に開くこともできます。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。|  
+|ビューの生成|High|各アプリケーション ドメイン内で 1 回  \(事前生成可能\)|Entity Framework が、概念モデルに対してクエリを実行したり変更内容をデータ ソースに保存したりできるようになるには、データベースにアクセスするためのローカル クエリ ビューのセットを事前に生成しておく必要があります。  このビューを生成する際のコストは高いため、設計時にビューを事前に作成してプロジェクトに追加しておくことができます。  詳細については、「[How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)」を参照してください。|  
+|クエリの準備|中<sup>2</sup>|各一意のクエリに対して 1 回|クエリ コマンドを作成したり、モデルとマッピングのメタデータに基づいてコマンド ツリーを生成したり、返されるデータの形状を定義したりするためのコストが含まれます。  Entity SQL と LINQ の両方のクエリ コマンドがキャッシュされるため、同じクエリであれば、後続の実行は短時間で済みます。  後続の実行でさらにコストを削減するためにコンパイル済み LINQ クエリを使用でき、コンパイル済みクエリが自動的にキャッシュされる LINQ クエリよりも効率的である場合があります。  詳細については、「[コンパイル済みクエリ \(LINQ to Entities\)](../../../../../docs/framework/data/adonet/ef/language-reference/compiled-queries-linq-to-entities.md)」を参照してください。  LINQ クエリの実行に関する一般的な情報については、「[LINQ to Entities](../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)」を参照してください。 **Note:**  メモリ内コレクションへ `Enumerable.Contains` 演算子を追加する LINQ to Entities クエリは自動的にキャッシュされません。  またコンパイル済み LINQ クエリのメモリ内コレクションをパラメーターで表すことは許可されていません。|  
+|クエリの実行|低<sup>2</sup>|各クエリに対して 1 回|ADO.NET データ プロバイダーを使用してデータ ソースに対してコマンドを実行するコスト。  大半のデータ ソースではクエリ プランがキャッシュされるため、同じクエリであれば、後続の実行は短時間で済むことがあります。|  
+|型の読み込みと検証|低<sup>3</sup>|各 <xref:System.Data.Objects.ObjectContext> インスタンスに対して 1 回|型が読み込まれ、概念モデルが定義する型に照らし合わせて検証されます。|  
+|追跡|低<sup>3</sup>|クエリが返す各オブジェクトに対して 1 回  <sup>4</sup>|クエリが <xref:System.Data.Objects.MergeOption> のマージ オプションを使用する場合には、この段階でパフォーマンスが低下することはありません。<br /><br /> クエリが <xref:System.Data.Objects.MergeOption>、<xref:System.Data.Objects.MergeOption>、または <xref:System.Data.Objects.MergeOption> のいずれかのマージ オプションを使用する場合には、クエリ結果が <xref:System.Data.Objects.ObjectStateManager> で追跡されます。  クエリが返す追跡対象の各オブジェクトに対して <xref:System.Data.EntityKey> が生成され、<xref:System.Data.Objects.ObjectStateManager> に <xref:System.Data.Objects.ObjectStateEntry> を作成するために使用されます。  <xref:System.Data.EntityKey> に対応する既存の <xref:System.Data.Objects.ObjectStateEntry> がある場合には、既存のオブジェクトが返されます。  <xref:System.Data.Objects.MergeOption> または <xref:System.Data.Objects.MergeOption> オプションが指定されている場合、オブジェクトは更新後に返されます。<br /><br /> 詳細については、「[Identity Resolution, State Management, and Change Tracking](http://msdn.microsoft.com/ja-jp/3bd49311-0e72-4ea4-8355-38fe57036ba0)」を参照してください。|  
+|オブジェクトの具体化|中<sup>3</sup>|クエリが返す各オブジェクトに対して 1 回  <sup>4</sup>|返された <xref:System.Data.Common.DbDataReader> オブジェクトを読み取ったり、オブジェクトを作成してプロパティ値を設定したりするプロセス。プロパティ値は、<xref:System.Data.Common.DbDataRecord> クラスの各インスタンスの値に基づきます。  オブジェクトが <xref:System.Data.Objects.ObjectContext> に既に存在しており、クエリに <xref:System.Data.Objects.MergeOption> または <xref:System.Data.Objects.MergeOption> マージ オプションが指定されている場合、この段階でパフォーマンスを低下することはありません。  詳細については、「[Identity Resolution, State Management, and Change Tracking](http://msdn.microsoft.com/ja-jp/3bd49311-0e72-4ea4-8355-38fe57036ba0)」を参照してください。|  
+  
+ <sup>1</sup> データ ソース プロバイダーが接続プールを実装している場合、接続を開くコストはプール全体に配分されます。  .NET Provider for SQL Server は、接続プールをサポートしています。  
+  
+ <sup>2</sup> クエリの複雑さが増すにつれて、コストも増大します。  
+  
+ <sup>3</sup> 総コストは、クエリによって返されるオブジェクトの数に比例して増大します。  
+  
+ <sup>4</sup> このオーバーヘッドは、EntityClient クエリでは必須ではありません。これは、EntityClient クエリはオブジェクトではなく <xref:System.Data.EntityClient.EntityDataReader> を返すからです。  詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。  
+  
+## その他の考慮事項  
+ Entity Framework アプリケーションのパフォーマンスを低下させる可能性があるその他の考慮事項を次に示します。  
+  
+### クエリの実行  
+ クエリがリソースを大量に消費することがあるので、コード内のどの個所で、またどのコンピューター上でクエリを実行するのかを検討してください。  
+  
+#### 遅延実行と即時実行  
+ <xref:System.Data.Objects.ObjectQuery%601> クエリまたは LINQ クエリを作成しても、すぐには実行されないことがあります。  クエリの実行は、結果が必要になるまで遅延されます。たとえば、`foreach` \(C\#\) または `For Each` \(Visual Basic\) の列挙時や、<xref:System.Collections.Generic.List%601> コレクションに割り当てられた場合などです。  クエリがすぐに実行されるのは、<xref:System.Data.Objects.ObjectQuery%601> 上で <xref:System.Data.Objects.ObjectQuery%601.Execute%2A> メソッドが呼び出されたときや、単一クエリを返す LINQ メソッド \(<xref:System.Linq.Enumerable.First%2A> や <xref:System.Linq.Enumerable.Any%2A> など\) が呼び出されたときです。  詳細については、「[Object Queries](http://msdn.microsoft.com/ja-jp/0768033c-876f-471d-85d5-264884349276)」および「[クエリの実行 \(LINQ to Entities\)](../../../../../docs/framework/data/adonet/ef/language-reference/query-execution.md)」を参照してください。  
+  
+#### クライアント側での LINQ クエリの実行  
+ LINQ クエリの実行は、データ ソースをホストするコンピューター上で行われますが、LINQ クエリは部分的にクライアント コンピューター上で評価されることがあります。  詳細については、「[クエリの実行 \(LINQ to Entities\)](../../../../../docs/framework/data/adonet/ef/language-reference/query-execution.md)」の「ストア実行」の項を参照してください。  
+  
+### クエリとマッピングの複雑さ  
+ 個々のクエリの複雑さおよびエンティティ モデルのマッピングの複雑さは、クエリ パフォーマンスに大きな影響を及ぼします。  
+  
+#### マッピングの複雑さ  
+ 概念モデルのエンティティとストレージ モデルのテーブルとの間で、単純な一対一より複雑なマッピングのモデルは、一対一マッピングのモデルより複雑なコマンドを生成します。  
+  
+#### クエリの複雑さ  
+ データソースに対して実行されるコマンド内に多数の結合を必要とするクエリや、データを大量に返すクエリは、次のようにパフォーマンスを低下させることがあります。  
+  
+-   単純に見える概念モデルに対してクエリを実行したところ、より複雑なクエリをデータ ソースに対して実行する結果になることがあります。  これは、Entity Framework が、概念モデルに対するクエリをデータ ソースに対する等価のクエリに変換するからです。  概念モデルの 1 つのエンティティ セットが、データ ソースの複数のテーブルにマップされている場合や、エンティティ間のリレーションシップが結合テーブルにマップされている場合には、データ ソース クエリに対して実行されるクエリ コマンドで 1 つ以上の結合が必要になる場合があります。  
+  
+    > [!NOTE]
+    >  所定のクエリでデータ ソースに対して実行されるコマンドを表示するには、<xref:System.Data.Objects.ObjectQuery%601> クラスまたは <xref:System.Data.EntityClient.EntityCommand> クラスの <xref:System.Data.Objects.ObjectQuery.ToTraceString%2A> メソッドを使用します。  詳細については、「[How to: View the Store Commands](http://msdn.microsoft.com/ja-jp/f9771c6e-3b62-4b24-a5d4-55d68e14fa79)」を参照してください。  
+  
+-   Entity SQL クエリが入れ子になっていると、サーバー上で結合が作成され、その結果多数の行が返されることがあります。  
+  
+     projection 句内の入れ子になったクエリの例を次に示します。  
+  
+    ```  
+    SELECT c, (SELECT c, (SELECT c FROM AdventureWorksModel.Vendor AS c  ) As Inner2   
+        FROM AdventureWorksModel.JobCandidate AS c  ) As Inner1   
+        FROM AdventureWorksModel.EmployeeDepartmentHistory AS c  
+    ```  
+  
+     さらに、このようなクエリでは、入れ子になったクエリ全体でオブジェクトを複製する単一クエリがクエリ パイプラインで生成されます。  そのため、1 つの列が複数回複製されることがあります。  SQL Server など、一部のデータベースでは、これによって TempDB テーブルのサイズが非常に大きくなり、サーバーのパフォーマンスに悪影響を及ぼす場合があります。  入れ子になったクエリを実行するときには、注意を払う必要があります。  
+  
+-   クライアントが、結果セットのサイズに比例してリソースを消費するような操作を実行している場合、データを大量に返すクエリを実行すると、パフォーマンスが低下することがあります。  このような場合には、クエリによって返されるデータの量を制限することを検討してください。  詳細については、「[How to: Page Through Query Results](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)」を参照してください。  
+  
+ Entity Framework によって自動的に生成されるコマンドは、データベース開発者が明示的に記述した同様のコマンドより複雑になることがあります。  データ ソースに対して実行されるコマンドを明示的に制御する必要がある場合には、テーブル値関数またはストアド プロシージャへのマッピングを定義することを検討してください。  
+  
+#### 関係  
+ クエリのパフォーマンスを最適化するには、エンティティ間のリレーションシップをエンティティ モデル内のアソシエーションとしてだけでなく、データ ソース内の論理リレーションシップとしても定義する必要があります。  
+  
+### クエリ パス  
+ 既定では、<xref:System.Data.Objects.ObjectQuery%601> を実行しても、関連オブジェクトは返されません \(リレーションシップ自体を表現するオブジェクトが存在する場合でも\)。  関連オブジェクトは、次の 3 つの方法のいずれかで読み込むことができます。  
+  
+1.  <xref:System.Data.Objects.ObjectQuery%601> が実行される前にクエリ パスを設定します。  
+  
+2.  オブジェクトが公開するナビゲーション プロパティに対して `Load` メソッドを呼び出します。  
+  
+3.  <xref:System.Data.Objects.ObjectContext> で <xref:System.Data.Objects.ObjectContextOptions.LazyLoadingEnabled%2A> オプションを `true` に設定します。  [Entity Data Model Designer](http://msdn.microsoft.com/ja-jp/4ccd7ad6-b934-4f7c-82a0-cfd2d4a95faf) を使用してオブジェクトレイヤー コードを生成すると、自動的に行われます。  詳細については、「[Generated Code Overview](http://msdn.microsoft.com/ja-jp/6a88ea38-6a90-4107-bc33-531b79ce5b6a)」を参照してください。  
+  
+ 使用するオプションを検討する際には、データベースに対する要求数と 1 つのクエリで返されるデータ量の間でのトレードオフに注意してください。  詳細については、「[Loading Related Objects](http://msdn.microsoft.com/ja-jp/452347d2-7b3b-44cd-9001-231299a28cb1)」を参照してください。  
+  
+#### クエリ パスの使用  
+ クエリ パスは、クエリによって返されるオブジェクトのグラフを定義します。  クエリ パスを定義する場合、データベースに対する 1 件の要求だけで、パスによって定義されたすべてのオブジェクトが返されます。  クエリ パスを使用すると、見かけ上は簡単なオブジェクト クエリのデータ ソースに対して複雑なコマンドが実行される可能性があります。  これは、1 つのクエリ内の関連オブジェクトを返すには、1 つまたは複数の結合が必要になるために発生します。  継承のあるエンティティや多対多のリレーションシップを含んだパスなど、複雑なエンティティ モデルに対してクエリを実行する場合は、さらに複雑になります。  
+  
+> [!NOTE]
+>  <xref:System.Data.Objects.ObjectQuery%601> によって生成されるコマンドを表示するには、<xref:System.Data.Objects.ObjectQuery.ToTraceString%2A> メソッドを使用します。  詳細については、「[How to: View the Store Commands](http://msdn.microsoft.com/ja-jp/f9771c6e-3b62-4b24-a5d4-55d68e14fa79)」を参照してください。  
+  
+ クエリ パスに含まれる関連オブジェクトが多すぎる場合や、オブジェクトに含まれる行データが多すぎる場合、データ ソースはクエリを完了できないことがあります。  これは、クエリでデータ ソースの機能を超える中間一時ストレージが必要になる場合に発生します。  この場合は、関連オブジェクトを明示的に読み込むと、データ ソース クエリの複雑さを軽減できます。  
+  
+#### 関連オブジェクトの明示的な読み込み  
+ <xref:System.Data.Objects.DataClasses.EntityCollection%601> または <xref:System.Data.Objects.DataClasses.EntityReference%601> を返すナビゲーション プロパティ上で `Load` メソッドを呼び出すことによって、関連オブジェクトを明示的に読み込むことができます。  オブジェクトを明示的に読み込むには、`Load` を呼び出すたびにデータベースへのラウンドトリップが必要になります。  
+  
+> [!NOTE]
+>  `foreach` ステートメント \(Visual Basic では `For Each`\) を使用するときなど、返されたオブジェクトのコレクションをループ処理しながら、`Load` を呼び出す場合、データ ソース固有のプロバイダーは 1 つの接続で複数のアクティブな結果セットをサポートする必要があります。  SQL Server データベースの場合、プロバイダー接続文字列に `MultipleActiveResultSets = true` の値を指定する必要があります。  
+  
+ エンティティに <xref:System.Data.Objects.DataClasses.EntityCollection%601> プロパティまたは <xref:System.Data.Objects.DataClasses.EntityReference%601> プロパティがない場合は、<xref:System.Data.Objects.ObjectContext.LoadProperty%2A> メソッドを使用することもできます。  これは、POCO エンティティを使用している場合に有効です。  
+  
+ 関連オブジェクトを明示的に読み込むと、結合の数と冗長データの量が減少しますが、`Load` にはデータベースへの接続が繰り返し必要になります。多数のオブジェクトを明示的に読み込む場合には、高コストになることがあります。  
+  
+### 変更の保存  
+ <xref:System.Data.Objects.ObjectContext> 上で <xref:System.Data.Objects.ObjectContext.SaveChanges%2A> メソッドを呼び出すと、コンテキスト内で追加、更新、または削除された各オブジェクトに対して独立した作成、更新、または削除のコマンドが生成されます。  このコマンドは、1 つのトランザクションのデータ ソースで実行されます。  クエリの場合と同様に、作成、更新、および削除の操作は、概念モデルのマッピングの複雑さに依存します。  
+  
+### 分散トランザクション  
+ 明示的トランザクションでの操作で、分散トランザクション コーディネーター \(DTC: Distributed Transaction Coordinator\) によって管理されるリソースが必要とされることがありますが、このような操作は DTC を必要としない同様の操作より高コストになります。  DTC への昇格は、次の状況で発生します。  
+  
+-   明示的トランザクションを常に DTC に昇格する SQL Server 2000 データベースやその他のデータ ソースに対して、明示的トランザクションで操作を実行する場合。  
+  
+-   SQL Server 2005 に対して明示的トランザクションで操作を実行し、かつ接続が [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって管理される場合。  これは、接続が閉じられてから同じトランザクション内で再度開かれると、SQL Server 2005 が DTC に必ず昇格するためです。この動作は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の既定の動作です。  この DTC 昇格は、SQL Server 2008 使用時には生じません。SQL Server 2005 使用時にこの昇格を回避するには、明示的にトランザクション内で接続を開いたり閉じたりする必要があります。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。  
+  
+ 明示的トランザクションが使用されるのは、1 つの <xref:System.Transactions> トランザクション内で操作を 1 つ以上実行するときです。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。  
+  
+## パフォーマンスを向上させるための戦略  
+ 次の戦略を使用すると、Entity Framework でのクエリの全体的なパフォーマンスを向上させることができます。  
+  
+#### ビューの事前生成  
+ アプリケーションがクエリを初めて実行する際、エンティティ モデルに基づいたビュー生成は高コストになります。  EdmGen.exe ユーティリティを使用して、プロジェクトに追加できる Visual Basic または C\# のコード ファイルとして設計時に事前にビューを生成しておきます。  テキスト テンプレート変換ツールキットを使用して、事前にコンパイルされたビューを生成することもできます。  事前に生成したビューは、現在のバージョンの指定エンティティ モデルに対応することを確認するために、実行時に検証されます。  詳細については、「[How to: Pre\-Generate Views to Improve Query Performance](http://msdn.microsoft.com/ja-jp/b18a9d16-e10b-4043-ba91-b632f85a2579)」および「[Entity Framework 4 のプリコンパイルまたは事前生成されたビューとパフォーマンスを分離する](http://go.microsoft.com/fwlink/?LinkID=201337&clcid=0x409)」を参照してください。  
+  
+ サイズが非常に大きいモデルで作業する場合は、次の点に注意してください。  
+  
+ .NET メタデータ形式では、特定のバイナリ内のユーザー文字列の数が 16,777,215 \(0xFFFFFF\) に制限されます。  サイズが非常に大きいモデルのビューを生成中に、ビュー ファイルがこのサイズ制限に達した場合、"ユーザー文字列を作成する論理スペースがありません。" というコンパイル エラーが表示されます。  このサイズ制限は、すべてのマネージ バイナリに適用されます。  詳細については、[ブログ](http://go.microsoft.com/fwlink/?LinkId=201476)を参照してください。ブログでは、大型の複雑なモデルでの操作時のエラーを回避する方法について説明しています。  
+  
+#### クエリの NoTracking マージ オプションの使用を検討する  
+ オブジェクト コンテキスト内で返されたオブジェクトを追跡するにはコストが生じます。  オブジェクトに対する変更内容を検出したり、同じ論理エンティティに対する複数の要求で同じオブジェクト インスタンスが返されるようにするには、オブジェクトを <xref:System.Data.Objects.ObjectContext> インスタンスにアタッチする必要があります。  オブジェクトの更新または削除を行う予定がなく、ID 管理が不要である場合には、クエリ実行時に <xref:System.Data.Objects.MergeOption> マージ オプションを使用することを検討してください。  
+  
+#### 適量のデータを返す  
+ シナリオによっては、<xref:System.Data.Objects.ObjectQuery%601.Include%2A> メソッドを使用してクエリ パスを指定する方がはるかに速いことがあります。データベースに対する必要なラウンド トリップ数が減るからです。  ただし、他のシナリオでは、関連オブジェクトを読み込むためにデータベースへのラウンド トリップを増やす方が速くなることがあります。これは、クエリが単純で結合数が少ないほど、データの冗長性が低下するからです。  したがって、関連オブジェクトを取得するためのさまざまな方法について、パフォーマンスをテストすることをお勧めします。  詳細については、「[Loading Related Objects](http://msdn.microsoft.com/ja-jp/452347d2-7b3b-44cd-9001-231299a28cb1)」を参照してください。  
+  
+ 1 つのクエリで大量のデータが返されることを回避するには、クエリの結果を扱いやすいサイズのグループに分割してページングすることを検討してください。  詳細については、「[How to: Page Through Query Results](http://msdn.microsoft.com/ja-jp/ffc0f920-e7de-42e0-9b12-ef356421d030)」を参照してください。  
+  
+#### ObjectContext のスコープを制限する  
+ 通常は、`using` ステートメント \(Visual Basic では `Using End Using`\) 内に <xref:System.Data.Objects.ObjectContext> インスタンスを作成する必要があります。  これにより、パフォーマンスが向上します。これは、コードがステートメント ブロックを終了するときに、オブジェクト コンテキストに関連付けられたリソースが自動的に廃棄されるからです。  ただし、オブジェクト コンテキストによって管理されるオブジェクトにコントロールがバインドされている場合、バインドが必要とされる間は <xref:System.Data.Objects.ObjectContext> インスタンスを保持し、手動で廃棄する必要があります。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。  
+  
+#### データベース接続を手動で開くことを検討する  
+ アプリケーションで、一連のオブジェクト クエリを実行する場合、またはデータ ソースに対する作成、更新、および削除操作を持続するために <xref:System.Data.Objects.ObjectContext.SaveChanges%2A> を頻繁に呼び出す場合、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] はデータ ソースに対する接続を連続的に開閉する必要があります。  このような状況では、操作の開始時に接続を手動で開いて、操作の完了時に接続を手動で閉じるか廃棄することを検討してください。  詳細については、「[Managing Connections and Transactions](http://msdn.microsoft.com/ja-jp/b6659d2a-9a45-4e98-acaa-d7a8029e5b99)」を参照してください。  
+  
+## パフォーマンス データ  
+ Entity Framework の一部のパフォーマンス データは、[ADO.NET チーム ブログ](http://go.microsoft.com/fwlink/?LinkId=91905) の次のブログ記事に公開されています。  
+  
+-   [ADO.NET Entity Framework のパフォーマンスを探索する \- パート 1](http://go.microsoft.com/fwlink/?LinkId=123907)  
+  
+-   [ADO.NET Entity Framework のパフォーマンスを探索する \- パート 2](http://go.microsoft.com/fwlink/?LinkId=123909)  
+  
+-   [ADO.NET Entity Framework パフォーマンスの比較](http://go.microsoft.com/fwlink/?LinkID=123913)  
+  
+## 参照  
+ [開発および配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/development-and-deployment-considerations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/provider-manifest-specification.md b/docs/framework/data/adonet/ef/provider-manifest-specification.md
new file mode 100644
index 00000000000..785eec8c2fb
--- /dev/null
+++ b/docs/framework/data/adonet/ef/provider-manifest-specification.md
@@ -0,0 +1,290 @@
+---
+title: "プロバイダー マニフェストの仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb450b47-8951-4f99-9350-26f05a4d4e46
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# プロバイダー マニフェストの仕様
+ここでは、データ ストア プロバイダーでデータ ストアの型および関数がどのようにサポートされているかについて説明します。  
+  
+ Entity Services は、特定のデータ ストア プロバイダーとは別に動作しますが、データ プロバイダーでモデル、マッピング、およびクエリと基になるデータ ストアの対話方法を明示的に定義できるようにします。  抽象化レイヤーがない場合、Entity Services が対象とするのは、特定のデータ ストアまたはデータ プロバイダーのみです。  
+  
+ プロバイダーでサポートされる型は、基になるデータベースによって直接的または間接的にサポートされています。  これらの型は、必ずしも正確なストア型であるとは限りませんが、プロバイダーで [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のサポートに使用される型です。  プロバイダー\/ストア型は、Entity Data Model \(EDM\) 用語で記述されます。  
+  
+ データ ストアによってサポートされる関数のパラメーターと戻り値の型は、EDM 用語で指定されます。  
+  
+## 要件  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] およびデータ ストアでは、データが失われたり切り捨てられたりすることなく、既知の型でデータを受け渡しできることが必要です。  
+  
+ プロバイダー マニフェストは、データ ストアへの接続を開くことなく、デザイン時にツールで読み込むことができる必要があります。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では大文字と小文字が区別されますが、基になるデータ ストアでは区別されない場合があります。  マニフェストで定義および使用されている EDM 成果物 \(識別子や型名など\) では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の大文字と小文字の区別を使用する必要があります。  大文字と小文字が区別されるデータ ストア要素がプロバイダー マニフェストに含まれる場合、その大文字と小文字の区別はプロバイダー マニフェストで保持する必要があります。  
+  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、すべてのデータ プロバイダーに対応するプロバイダー マニフェストが必要です。  プロバイダー マニフェストがないプロバイダーを [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] と共に使用しようとすると、エラーが発生します。  
+  
+ プロバイダーとの対話で例外が発生したときに [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によってスローされる例外の種類を次の表に示します。  
+  
+|懸案事項|例外|  
+|----------|--------|  
+|プロバイダーで DbProviderServices の GetProviderManifest がサポートされていない。|ProviderIncompatibleException|  
+|プロバイダー マニフェストが見つからないため、プロバイダー マニフェストを取得しようとすると、プロバイダーから `null` が返される。|ProviderIncompatibleException|  
+|無効なプロバイダー マニフェストにより、プロバイダー マニフェストを取得しようとすると、プロバイダーから無効な XML が返される。|ProviderIncompatibleException|  
+  
+## シナリオ  
+ プロバイダーでは、次のシナリオをサポートしています。  
+  
+### 対称型マッピングによるプロバイダーの記述  
+ マッピングの方向に関係なく、各ストア型が単一の EDM 型にマップされる [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のプロバイダーを記述できます。  EDM 型に対応する非常に単純なマッピングを持つプロバイダー型では、型システムが単純であるか EDM 型と一致するため、対称ソリューションを使用できます。  
+  
+ ドメインの単純さを利用して、静的な宣言型プロバイダー マニフェストを作成することができます。  
+  
+ 次の 2 つのセクションで構成される XML ファイルを記述します。  
+  
+-   ストア型またはストア関数の "対応する EDM 要素" で表現されるプロバイダー型の一覧。  ストア型には、対応する EDM 型があります。  ストア関数には、対応する EDM 関数があります。  たとえば、varchar は SQL Server の型ですが、対応する EDM 型は文字列になります。  
+  
+-   パラメーターと戻り値の型が EDM 用語で表現される、プロバイダーがサポートする関数の一覧。  
+  
+### 非対照型マッピングによるプロバイダーの記述  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のデータ ストア プロバイダーを記述する場合、一部の型の EDM からプロバイダーへの型マッピングが、プロバイダーから EDM への型マッピングとは異なることがあります。  たとえば、プロバイダー側で unbounded の EDM PrimitiveTypeKind.String が nvarchar\(4000\) にマップされるのに対して、nvarchar\(4000\) は EDM PrimitiveTypeKind.String\(MaxLength\=4000\) にマップされる場合があります。  
+  
+ 次の 2 つのセクションで構成される XML ファイルを記述します。  
+  
+-   両方向 \(EDM からプロバイダーおよびプロバイダーから EDM\) のマッピングを定義する、EDM 用語で表現されたプロバイダー型の一覧。  
+  
+-   パラメーターと戻り値の型が EDM 用語で表現される、プロバイダーがサポートする関数の一覧。  
+  
+## プロバイダー マニフェストの探索可能性  
+ マニフェストは、Entity Services の複数のコンポーネントの種類 \(Tools や Query など\) では間接的に使用されますが、データ ストア メタデータ ローダーを使用してメタデータからより直接的に使用することができます。  
+  
+ ![dfb3d02b&#45;7a8c&#45;4d51&#45;ac5a&#45;a73d8aa145e6](../../../../../docs/framework/data/adonet/ef/media/dfb3d02b-7a8c-4d51-ac5a-a73d8aa145e6.gif "dfb3d02b\-7a8c\-4d51\-ac5a\-a73d8aa145e6")  
+  
+ ただし、指定されたプロバイダーでは、異なるストアや、同じストアの異なるバージョンがサポートされている場合があります。  そのため、プロバイダーは、サポートされるデータ ストアごとに、異なるマニフェストを報告する必要があります。  
+  
+### プロバイダー マニフェスト トークン  
+ データ ストア接続が開いている場合、プロバイダーは、クエリで情報を取得して、適切なマニフェストを返すことができます。  この動作は、接続情報が利用できない場合やストアに接続できない場合があるオフライン シナリオでは不可能になることもあります。  マニフェストを識別するには、.ssdl ファイルの `Schema` の `ProviderManifestToken` 属性を使用します。  この属性には必須の形式はありません。プロバイダーは、ストアへの接続を開くことなく、マニフェストを特定するために必要最小限の情報を選択します。  
+  
+ 次に例を示します。  
+  
+```  
+<Schema Namespace="Northwind" Provider="System.Data.SqlClient" ProviderManifestToken="2005" xmlns:edm="http://schemas.microsoft.com/ado/2006/04/edm/ssdl" xmlns="http://schemas.microsoft.com/ado/2006/04/edm/ssdl">  
+```  
+  
+## プロバイダー マニフェストのプログラミング モデル  
+ プロバイダーは <xref:System.Data.Common.DbXmlEnabledProviderManifest> から派生します。これにより、プロバイダーは、そのマニフェストを宣言によって指定できます。  プロバイダーのクラス階層を次の図に示します。  
+  
+ ![なし](../../../../../docs/framework/data/adonet/ef/media/d541eba3-2ee6-4cd1-88f5-89d0b2582a6c.gif "d541eba3\-2ee6\-4cd1\-88f5\-89d0b2582a6c")  
+  
+### 探索可能性の API  
+ プロバイダー マニフェストは、データ ストア接続またはプロバイダー マニフェスト トークンのいずれかを使用して、ストア メタデータ ローダー \(StoreItemCollection\) によって読み込まれます。  
+  
+#### データ ストア接続を使用する  
+ データ ストア接続が使用可能な場合は、DbProvderServices.GetProviderManifestToken を呼び出して GetProviderManifest メソッドに渡されるトークンを返すことで、DbProviderManifest を返します。  このメソッドは、プロバイダーによる GetDbProviderManifestToken の実装に委任されます。  
+  
+```  
+public string GetProviderManifestToken(DbConnection connection);  
+public DbProviderManifest GetProviderManifest(string manifestToken);  
+```  
+  
+#### プロバイダー マニフェスト トークンを使用する  
+ オフライン シナリオの場合、SSDL の表現からトークンが選択されます。  SSDL により、ProviderManifestToken を指定できます \(詳細については、「[Schema Element \(SSDL\)](http://msdn.microsoft.com/ja-jp/fec75ae4-7f16-4421-9265-9dac61509222)」を参照してください\)。  たとえば、接続を開くことができない場合、SSDL には、マニフェストに関する情報を指定するプロバイダー マニフェスト トークンがあります。  
+  
+```  
+public DbProviderManifest GetProviderManifest(string manifestToken);  
+```  
+  
+### プロバイダー マニフェスト スキーマ  
+ プロバイダーごとに定義された情報のスキーマには、メタデータによって使用される静的な情報が含まれています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema elementFormDefault="qualified"  
+   xmlns:xs="http://www.w3.org/2001/XMLSchema"  
+   targetNamespace="http://schemas.microsoft.com/ado/2006/04/edm/providermanifest"  
+   xmlns:pm="http://schemas.microsoft.com/ado/2006/04/edm/providermanifest">  
+  
+  <xs:element name="ProviderManifest">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="Types" type="pm:TTypes" minOccurs="1" maxOccurs="1" />  
+        <xs:element name="Functions" type="pm:TFunctions" minOccurs="0" maxOccurs="1"/>  
+      </xs:sequence>  
+      <xs:attribute name="Namespace" type="xs:string" use="required"/>  
+    </xs:complexType>  
+  </xs:element>  
+  <xs:complexType name="TVersion">  
+    <xs:attribute name="Major" type="xs:int" use="required" />  
+    <xs:attribute name="Minor" type="xs:int" use="required" />  
+    <xs:attribute name="Build" type="xs:int" use="required" />  
+    <xs:attribute name="Revision" type="xs:int" use="required" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TIntegerFacetDescription">  
+    <xs:attribute name="Minimum" type="xs:int" use="optional" />  
+    <xs:attribute name="Maximum" type="xs:int" use="optional" />  
+    <xs:attribute name="DefaultValue" type="xs:int" use="optional" />  
+    <xs:attribute name="Constant" type="xs:boolean" default="false" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TBooleanFacetDescription">  
+    <xs:attribute name="DefaultValue" type="xs:boolean" use="optional" />  
+    <xs:attribute name="Constant" type="xs:boolean" default="true" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TDateTimeFacetDescription">  
+    <xs:attribute name="Constant" type="xs:boolean" default="false" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TFacetDescriptions">  
+    <xs:choice maxOccurs="unbounded">  
+      <xs:element name="Precision" minOccurs="0" maxOccurs="1" type="pm:TIntegerFacetDescription"/>  
+      <xs:element name="Scale" minOccurs="0" maxOccurs="1" type="pm:TIntegerFacetDescription"/>  
+      <xs:element name="MaxLength" minOccurs="0" maxOccurs="1" type="pm:TIntegerFacetDescription"/>  
+      <xs:element name="Unicode" minOccurs="0" maxOccurs="1" type="pm:TBooleanFacetDescription"/>  
+      <xs:element name="FixedLength" minOccurs="0" maxOccurs="1" type="pm:TBooleanFacetDescription"/>  
+    </xs:choice>  
+  </xs:complexType>  
+  
+  <xs:complexType name="TType">  
+    <xs:sequence>  
+      <xs:element name="FacetDescriptions" type="pm:TFacetDescriptions" minOccurs="0" maxOccurs="1"/>  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="required"/>  
+    <xs:attribute name="PrimitiveTypeKind" type="pm:TPrimitiveTypeKind" use="required" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TTypes">  
+    <xs:sequence>  
+      <xs:element name="Type" type="pm:TType" minOccurs="0" maxOccurs="unbounded"/>  
+    </xs:sequence>  
+  </xs:complexType>  
+  
+  <xs:attributeGroup name="TFacetAttribute">  
+    <xs:attribute name="Precision" type="xs:int" use="optional"/>  
+    <xs:attribute name="Scale" type="xs:int" use="optional"/>  
+    <xs:attribute name="MaxLength" type="xs:int" use="optional"/>  
+    <xs:attribute name="Unicode" type="xs:boolean" use="optional"/>  
+    <xs:attribute name="FixedLength" type="xs:boolean" use="optional"/>  
+  </xs:attributeGroup>  
+  
+  <xs:complexType name="TFunctionParameter">  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attributeGroup ref="pm:TFacetAttribute" />  
+    <xs:attribute name="Mode" type="pm:TParameterDirection" use="required" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TReturnType">  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attributeGroup ref="pm:TFacetAttribute" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TFunction">  
+    <xs:choice minOccurs="0" maxOccurs ="unbounded">  
+      <xs:element name ="ReturnType" type="pm:TReturnType" minOccurs="0" maxOccurs="1" />  
+      <xs:element name="Parameter" type="pm:TFunctionParameter" minOccurs="0" maxOccurs="unbounded"/>  
+    </xs:choice>  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Aggregate" type="xs:boolean" use="optional" />  
+    <xs:attribute name="BuiltIn" type="xs:boolean" use="optional" />  
+    <xs:attribute name="StoreFunctionName" type="xs:string" use="optional" />  
+    <xs:attribute name="NiladicFunction" type="xs:boolean" use="optional" />  
+    <xs:attribute name="ParameterTypeSemantics" type="pm:TParameterTypeSemantics" use="optional" default="AllowImplicitConversion" />  
+  </xs:complexType>  
+  
+  <xs:complexType name="TFunctions">  
+    <xs:sequence>  
+      <xs:element name="Function" type="pm:TFunction" minOccurs="0" maxOccurs="unbounded"/>  
+    </xs:sequence>  
+  </xs:complexType>  
+  
+  <xs:simpleType name="TPrimitiveTypeKind">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Binary"/>  
+      <xs:enumeration value="Boolean"/>  
+      <xs:enumeration value="Byte"/>  
+      <xs:enumeration value="Decimal"/>  
+      <xs:enumeration value="DateTime"/>  
+      <xs:enumeration value="Time"/>  
+      <xs:enumeration value="DateTimeOffset"/>          
+      <xs:enumeration value="Double"/>  
+      <xs:enumeration value="Guid"/>  
+      <xs:enumeration value="Single"/>  
+      <xs:enumeration value="SByte"/>  
+      <xs:enumeration value="Int16"/>  
+      <xs:enumeration value="Int32"/>  
+      <xs:enumeration value="Int64"/>  
+      <xs:enumeration value="String"/>  
+    </xs:restriction>  
+  </xs:simpleType>  
+  
+  <xs:simpleType name="TParameterDirection">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="In"/>  
+      <xs:enumeration value="Out"/>  
+      <xs:enumeration value="InOut"/>  
+    </xs:restriction>  
+  </xs:simpleType>  
+  
+  <xs:simpleType name="TParameterTypeSemantics">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="ExactMatchOnly" />  
+      <xs:enumeration value="AllowImplicitPromotion" />  
+      <xs:enumeration value="AllowImplicitConversion" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+```  
+  
+#### Types ノード  
+ プロバイダー マニフェスト内の Types ノードには、データ ストアまたはプロバイダーによってネイティブでサポートされている型に関する情報が含まれています。  
+  
+##### Type ノード  
+ 各 Type ノードでは、EDM の観点でプロバイダー型が定義されています。  Type ノードには、プロバイダー型の名前、およびマップ先のモデル型とその型マッピングを示すファセットに関する情報が記述されています。  
+  
+ プロバイダー マニフェストでこの型情報を公開するために、各 TypeInformation の宣言では、各 Type に対応する複数のファセットの説明を定義する必要があります。  
+  
+|属性名|データ型|必須|既定値|説明|  
+|---------|----------|--------|---------|--------|  
+|名前|String|はい|適用なし|プロバイダー固有のデータ型の名前|  
+|PrimitiveTypeKind|PrimitiveTypeKind|はい|適用なし|EDM 型の名前|  
+  
+###### Function ノード  
+ 各 Function では、プロバイダーを介して使用できる 1 つの関数が定義されています。  
+  
+|属性名|データ型|必須|既定値|説明|  
+|---------|----------|--------|---------|--------|  
+|名前|String|はい|適用なし|関数の識別子\/名前|  
+|ReturnType|String|Ｘ|Void|関数の戻り値の EDM 型|  
+|Aggregate|Boolean|Ｘ|False|関数が集計関数の場合は True|  
+|BuiltIn|Boolean|Ｘ|True|関数がデータ ストアに組み込まれている場合は True|  
+|StoreFunctionName|String|Ｘ|\<Name\>|データ ストア内の関数名。  関数名のリダイレクト レベルを許可できます。|  
+|NiladicFunction|Boolean|Ｘ|False|関数にパラメーターが必要なく、パラメーターなしで呼び出される場合は True|  
+|ParameterType<br /><br /> Semantics|ParameterSemantics|Ｘ|AllowImplicit<br /><br /> 変換|クエリ パイプラインによるパラメーター型の置換の処理方法の選択<br /><br /> -   ExactMatchOnly<br />-   AllowImplicitPromotion<br />-   AllowImplicitConversion|  
+  
+ **Parameters ノード**  
+  
+ 各関数には、1 つ以上の Parameter ノードのコレクションが含まれています。  
+  
+|属性名|データ型|必須|既定値|説明|  
+|---------|----------|--------|---------|--------|  
+|名前|String|はい|適用なし|パラメーターの識別子\/名前|  
+|種類|String|はい|適用なし|パラメーターの EDM 型|  
+|モード|パラメーター<br /><br /> Direction|はい|適用なし|パラメーターの方向<br /><br /> -   in<br />-   out<br />-   inout|  
+  
+##### Namespace 属性  
+ 各データ ストア プロバイダーでは、マニフェストで定義された情報に対して 1 つの名前空間または名前空間のグループを定義する必要があります。  この名前空間は、Entity SQL クエリで、関数および型の名前を解決するために使用できます。  たとえば SqlServer の場合、  その名前空間は、標準的な関数が Entity SQL クエリでサポートされるように Entity Services で定義された正規の名前空間 \(EDM\) とは別にする必要があります。  
+  
+## 参照  
+ [Entity Framework データ プロバイダーの作成](../../../../../docs/framework/data/adonet/ef/writing-an-ef-data-provider.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/querying-a-conceptual-model.md b/docs/framework/data/adonet/ef/querying-a-conceptual-model.md
new file mode 100644
index 00000000000..5342ed0f782
--- /dev/null
+++ b/docs/framework/data/adonet/ef/querying-a-conceptual-model.md
@@ -0,0 +1,24 @@
+---
+title: "概念モデルに対するクエリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: d59a4ae7-a651-403c-82e2-6d710645a867
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 概念モデルに対するクエリ
+[!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用すると概念モデルに対してクエリを実行できます。  最新バージョンの Entity Framework を使用して概念モデルのクエリを実行するには、「[データのクエリ](http://go.microsoft.com/fwlink/?LinkId=235282)」 を参照してください。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/resources.md b/docs/framework/data/adonet/ef/resources.md
new file mode 100644
index 00000000000..0c5278a9616
--- /dev/null
+++ b/docs/framework/data/adonet/ef/resources.md
@@ -0,0 +1,45 @@
+---
+title: "Entity Framework のリソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 0bb04c18-4a14-42a4-baa9-a63d556c9f49
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Entity Framework のリソース
+次の外部リソースでは、Entity Framework アプリケーションの作成に関する情報とサポートを提供しています。  
+  
+ [データ デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=213876)  
+ マイクロソフト テクノロジを使用したデータ開発に関する情報を一か所にまとめたサイト。  
+  
+ [ADO.NET チーム ブログ](http://go.microsoft.com/fwlink/?LinkId=91905)  
+ ADO.NET の機能の最新情報と説明が記載されているブログ。  
+  
+ [Entity Framework 設計ブログ](http://go.microsoft.com/fwlink/?LinkId=186888)  
+ デザインに関する解説と、Entity Framework の将来のバージョンに関する機能の紹介。  
+  
+ [データ プラットフォーム操作方法ビデオ: Entity Framework シリーズ](http://go.microsoft.com/fwlink/?LinkId=124600)  
+ Entity Framework のさまざまなコンポーネントを使用してアプリケーションを作成する方法を説明した一連のビデオ スクリーン キャスト。  
+  
+ [Entity Framework のよくある質問](http://go.microsoft.com/fwlink/?LinkID=213877)  
+ Entity Framework に関してよく寄せられる質問が記載されているブログ。  
+  
+## 参照  
+ [エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)   
+ [はじめに](../../../../../docs/framework/data/adonet/ef/getting-started.md)   
+ [Entity Framework の用語](../../../../../docs/framework/data/adonet/ef/terminology.md)   
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/security-considerations.md b/docs/framework/data/adonet/ef/security-considerations.md
new file mode 100644
index 00000000000..d0264632be8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/security-considerations.md
@@ -0,0 +1,178 @@
+---
+title: "セキュリティに関する注意事項 (Entity Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 84758642-9b72-4447-86f9-f831fef46962
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# セキュリティに関する注意事項 (Entity Framework)
+このトピックでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションの開発、配置、および実行に特有のセキュリティの注意点について説明します。  このほかに、安全な [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] アプリケーションを作成するための推奨事項にも従うようにしてください。  詳細については、「[セキュリティの概要 ](../../../../../docs/framework/data/adonet/security-overview.md)」を参照してください。  
+  
+## セキュリティについての全般的な考慮事項  
+ 以下のセキュリティの注意点は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を使用するすべてのアプリケーションに当てはまります。  
+  
+#### 信頼できるデータ ソース プロバイダーのみを使用する  
+ データ ソースと通信するためにはプロバイダーで次の処理が行われる必要があります。  
+  
+-   [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] から接続文字列を取得する。  
+  
+-   コマンド ツリーをデータ ソースのネイティブ クエリ言語に変換する。  
+  
+-   結果セットを組み立てて返す。  
+  
+ ログオン操作の際には、ユーザーのパスワードに基づく情報が、基になるデータ ソースのネットワーク ライブラリを通じてサーバーに渡されます。  悪質なプロバイダーを使用すると、ユーザーの資格情報を盗まれたり、悪質なクエリを生成されたり、結果セットを改ざんされたりする可能性があります。  
+  
+#### 接続を暗号化して機密データを保護する  
+ データの暗号化は [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では直接処理されません。  ユーザーがパブリック ネットワーク経由でデータにアクセスする場合は、セキュリティを強化するためにアプリケーションでデータ ソースへの暗号化接続を確立する必要があります。  詳細については、データ ソースのセキュリティ関連のドキュメントを参照してください。  SQL Server のデータ ソースについては、「[SQL Server への接続を暗号化する](http://go.microsoft.com/fwlink/?LinkId=119544)」を参照してください。  
+  
+#### 接続文字列を保護する  
+ アプリケーションのセキュリティを実現するうえで、データ ソースへのアクセスを保護することは、最も重要な目標の 1 つです。  保護されていない接続文字列や適切に作成されていない接続文字列は脆弱性を招く原因になります。  接続情報をテキスト形式で保存したり、メモリ内に保持したりすると、システム全体のセキュリティが損なわれる可能性があります。  接続文字列を保護するための推奨事項を以下に示します。  
+  
+-   SQL Server データ ソースで Windows 認証を使用する。  
+  
+     Windows 認証を使用して SQL Server データ ソースに接続する場合、接続文字列にログオンやパスワードの情報が含まれません。  
+  
+-   保護構成を使用して構成ファイル セクションを暗号化する。  
+  
+     ASP.NET には、保護構成と呼ばれる、構成ファイルの機密情報を暗号化するための機能が用意されています。  保護構成は、主に ASP.NET を想定して設計されたものですが、Windows アプリケーションの構成ファイル セクションを暗号化する目的でも使用できます。  新しい保護構成機能の詳細については、「[Encrypting Configuration Information Using Protected Configuration](../Topic/Encrypting%20Configuration%20Information%20Using%20Protected%20Configuration.md)」を参照してください。  
+  
+-   セキュリティで保護された構成ファイルに接続文字列を格納する。  
+  
+     接続文字列はソース コードに埋め込まないようにしてください。  接続文字列は構成ファイルに保存でき、そうすることで、アプリケーションのコードに接続文字列を組み込むことを避けられます。  Entity Data Model ウィザードでは、接続文字列が既定でアプリケーション構成ファイルに保存されます。  不正なアクセスが行われないようにそのファイルをセキュリティで保護してください。  
+  
+-   接続を動的に作成する場合は接続文字列ビルダーを使用する。  
+  
+     接続文字列を実行時に作成する必要がある場合は <xref:System.Data.EntityClient.EntityConnectionStringBuilder> クラスを使用します。  この文字列ビルダー クラスは、入力情報を検証して無効な入力情報をエスケープする処理により、接続文字列インジェクション攻撃の防止に役立ちます。  詳細については、「[EntityConnection の接続文字列を作成する方法](../../../../../docs/framework/data/adonet/ef/how-to-build-an-entityconnection-connection-string.md)」を参照してください。  さらに、適切な文字列ビルダー クラスを使用して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] 接続文字列の一部であるデータ ソース接続文字列を作成します。  ADO.NET プロバイダーの接続文字列ビルダーについては、「[接続文字列ビルダー](../../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+ 詳細については、「[接続情報の保護](../../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+#### 信頼できないユーザーに EntityConnection を公開しない  
+ <xref:System.Data.EntityClient.EntityConnection> オブジェクトは、基になる接続の接続文字列を公開します。  <xref:System.Data.EntityClient.EntityConnection> オブジェクトにアクセスできるユーザーは、基になる接続の <xref:System.Data.ConnectionState> を変更することもできます。  <xref:System.Data.EntityClient.EntityConnection> クラスはスレッド セーフではありません。  
+  
+#### 接続をセキュリティ コンテキストの外で渡さない  
+ 接続が確立された後にその接続をセキュリティ コンテキストの外で渡さないでください。  たとえば、接続を開くためのアクセス許可を持つスレッドが、接続をグローバルな場所に格納することは避けてください。  接続がグローバルな場所にあると、アクセス許可を明示的に与えられていない他の悪質なスレッドであっても、この開いている接続を使用することが可能になってしまいます。  
+  
+#### メモリ ダンプからログオン情報やパスワードが漏洩する可能性がある  
+ データ ソースのログオンとパスワードの情報が接続文字列で渡されると、その情報はガベージ コレクションが行われるまでメモリに保持されます。  その結果、パスワードの文字列がいつメモリからなくなるのか判定できなくなります。  アプリケーションがクラッシュした場合、重要なセキュリティ情報がメモリ ダンプ ファイルに含まれている可能性があります。メモリ ダンプ ファイルは、アプリケーションを実行しているユーザーと、コンピューターに対する管理アクセス権を持つすべてのユーザーが表示できます。  Microsoft SQL Server への接続には Windows 認証を使用してください。  
+  
+#### データ ソースでは必要なアクセス許可のみをユーザーに与える  
+ データ ソースの管理者は、必要なアクセス許可のみをユーザーに与えるようにしてください。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] では、データを変更する DML ステートメント \(INSERT、UPDATE、DELETE など\) はサポートされていませんが、データ ソースへの接続にアクセスすることはできます。  悪質なユーザーによって、その接続を使用してデータ ソースのネイティブ言語で DML ステートメントを実行される可能性があります。  
+  
+#### 最小限のアクセス許可でアプリケーションを実行する  
+ マネージ アプリケーションを完全信頼のアクセス許可で実行できるようにすると、[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] でアプリケーションのコンピューターへのアクセスが制限されなくなります。  これは、システム全体を危険にさらすセキュリティの脆弱性の原因になります。  [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] のコード アクセス セキュリティやその他のセキュリティ メカニズムを使用するには、部分信頼のアクセス許可を使用して、アプリケーションが機能するために必要な最小限のアクセス許可でアプリケーションを実行する必要があります。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションに必要な最小限のアクセス許可を以下に示します。  
+  
+-   <xref:System.Security.Permissions.FileIOPermission>: <xref:System.Security.Permissions.FileIOPermissionAccess> \(指定されたメタデータ ファイルを開くため\) または <xref:System.Security.Permissions.FileIOPermissionAccess> \(メタデータ ファイルのディレクトリを検索するため\)。  
+  
+-   <xref:System.Security.Permissions.ReflectionPermission>: <xref:System.Security.Permissions.ReflectionPermissionFlag> \(LINQ to Entities クエリをサポートするため\)。  
+  
+-   <xref:System.Transactions.DistributedTransactionPermission>: <xref:System.Security.Permissions.PermissionState> \(<xref:System.Transactions> の <xref:System.Transactions.Transaction> に参加するため\)。  
+  
+-   <xref:System.Security.Permissions.SecurityPermission>: <xref:System.Security.Permissions.SecurityPermissionFlag> \(<xref:System.Runtime.Serialization.ISerializable> インターフェイスを使用して例外をシリアル化するため\)。  
+  
+-   データベース接続を開いたりデータベースに対してコマンドを実行したりするためのアクセス許可 \([!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] データベースの <xref:System.Data.SqlClient.SqlClientPermission> など\)。  
+  
+ 詳細については、「[コード アクセス セキュリティと ADO.NET](../../../../../docs/framework/data/adonet/code-access-security.md)」を参照してください。  
+  
+#### 信頼できないアプリケーションをインストールしない  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] ではセキュリティのアクセス許可が適用されません。ユーザーが指定したデータ オブジェクト コードは、信頼されているかどうかに関係なくインプロセスで呼び出されます。  データ ストアとアプリケーションでクライアントの認証および承認が行われるようにしてください。  
+  
+#### すべての構成ファイルへのアクセスを制限する  
+ 管理者は、アプリケーションの構成を指定するすべてのファイル \(enterprisesec.config、security.config、machine.conf、アプリケーション構成ファイル \(\<*application*\>.exe.config\) など\) への書き込みアクセスを制限する必要があります。  
+  
+ app.config ではプロバイダーの不変名を変更できます。  クライアント アプリケーションは、強力な名前を使用して標準のプロバイダー ファクトリ モデルを通じて基になるプロバイダーにアクセスする責任を負う必要があります。  
+  
+#### モデル ファイルとマッピング ファイルへのアクセス許可を制限する  
+ 管理者は、モデル ファイルとマッピング ファイル \(.edmx、.csdl、.ssdl、および .msl\) への書き込みアクセスを、モデルやマッピングを変更するユーザーのみに制限する必要があります。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で実行時に必要なのは、これらのファイルへの読み取りアクセスだけです。  そのほか、[!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ツールによって生成されるオブジェクト レイヤーとプリコンパイル ビューのソース コード ファイルへのアクセスを制限する必要もあります。  
+  
+## クエリのセキュリティに関する注意点  
+ 概念モデルのクエリを実行する際は、セキュリティに関して次の点に注意する必要があります。  これらの注意点は、EntityClient を使用する [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリと、LINQ、[!INCLUDE[esql](../../../../../includes/esql-md.md)]、およびクエリ ビルダー メソッドを使用するオブジェクト クエリに当てはまります。  
+  
+#### SQL インジェクション攻撃を防止する  
+ アプリケーションによっては \(ユーザーや他の外部エージェントからの\) 外部入力を受け取り、その入力内容に応じた処理を実行する場合があります。  直接、間接を問わず、ユーザーまたは外部エージェントから受け取った入力には、対象言語の構文を巧みに利用して不正なアクションを実行する内容が含まれている可能性があります。  対象言語が [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] などの構造化照会言語 \(SQL\) である場合、この操作は SQL インジェクション攻撃と呼ばれます。  悪質なユーザーによって、クエリに直接コマンドを挿入してデータベースのテーブルを削除されたり、サービス拒否の状態を引き起こされたり、本来実行されるべき操作を改変されたりする可能性があります。  
+  
+-   [!INCLUDE[esql](../../../../../includes/esql-md.md)] インジェクション攻撃:  
+  
+     [!INCLUDE[esql](../../../../../includes/esql-md.md)] では、クエリ述語やパラメーター名で使用される値に悪質な入力を渡すことによって SQL インジェクション攻撃が行われる可能性があります。  SQL インジェクションが行われないようにするため、ユーザー入力を [!INCLUDE[esql](../../../../../includes/esql-md.md)] コマンド テキストと組み合わせないようにしてください。  
+  
+     [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリでは、リテラルを渡すことのできる場所であればどこででもパラメーターを渡すことができます。  外部エージェントから受け取ったリテラルを直接クエリに挿入することは避け、パラメーター化クエリを使用するようにしてください。さらに、[Entity SQL](http://msdn.microsoft.com/ja-jp/05685434-05e6-41c2-8d5e-8933b88a40b0) を安全に作成するためクエリ ビルダー メソッドの使用も検討してください。  
+  
+-   [!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)] インジェクション攻撃:  
+  
+     [!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)] 内でクエリを構築することは可能ですが、オブジェクト モデルの API を介して構築します。[!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリとは異なり、[!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)] のクエリは、構築に文字列操作や文字列連結は使用されません。このため、通常の SQL インジェクション攻撃に十分な抵抗力を持っていると言えます。  
+  
+#### 非常に大きな結果セットを使用しないようにする  
+ 非常に大きな結果セットを使用すると、消費されるリソースが結果セットのサイズに比例して増加する操作を実行する場合にクライアント システムがシャットダウンする可能性があります。  次のような状況では、予想外に大きな結果セットが生成されることがあります。  
+  
+-   適切なフィルター条件が含まれていない、大きなデータベースに対するクエリ。  
+  
+-   サーバーで Cartesian Join を作成するクエリ。  
+  
+-   入れ子になった [!INCLUDE[esql](../../../../../includes/esql-md.md)] クエリ。  
+  
+ ユーザー入力を受け取るときには、その入力によって結果セットがシステムで処理しきれないほど大きくならないことを確認する必要があります。  [!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)] の <xref:System.Linq.Queryable.Take%2A> メソッドや [!INCLUDE[esql](../../../../../includes/esql-md.md)] の [LIMIT](../../../../../docs/framework/data/adonet/ef/language-reference/limit-entity-sql.md) 演算子を使用して結果セットのサイズを制限することもできます。  
+  
+#### 信頼できない可能性のある呼び出し元にメソッドを公開するときに IQueryable 結果を返さないようにする  
+ 次の理由で、信頼できない可能性のある呼び出し元に公開されたメソッドから <xref:System.Linq.IQueryable%601> 型を返さないようにします。  
+  
+-   <xref:System.Linq.IQueryable%601> 型を公開するクエリのコンシューマーが、セキュリティ保護されたデータを公開したり結果セットのサイズを増やしたりする結果に関するメソッドを呼び出す可能性があるため。  たとえば、次のようなメソッド シグネチャについて考えてみます。  
+  
+    ```  
+    public IQueryable<Customer> GetCustomer(int customerId)  
+    ```  
+  
+     このクエリのコンシューマーは返された `IQueryable<Customer>` の `.Include("Orders")` を呼び出し、クエリが公開を意図していないデータを取得する可能性があります。  これを回避するには、メソッドの戻り値の型を <xref:System.Collections.Generic.IEnumerable%601> に変更し、結果を具体化するメソッド \(`.ToList()` など\) を呼び出します。  
+  
+-   結果が反復されると <xref:System.Linq.IQueryable%601> クエリが実行されるため、<xref:System.Linq.IQueryable%601> 型を公開するクエリのコンシューマーがスローされた例外をキャッチする可能性があります。  例外にコンシューマーを対象としていない情報が含まれている場合があります。  
+  
+## エンティティのセキュリティに関する注意点  
+ エンティティ型を生成したり操作したりする際には次の点に注意する必要があります。  
+  
+#### ObjectContext を複数のアプリケーション ドメインで共有しない  
+ <xref:System.Data.Objects.ObjectContext> を複数のアプリケーション ドメインで共有すると接続文字列の情報が漏洩する可能性があります。  代わりに、シリアル化したオブジェクトやオブジェクト グラフをもう一方のアプリケーション ドメインに転送して、そのアプリケーション ドメインでそれらのオブジェクトを <xref:System.Data.Objects.ObjectContext> にアタッチするようにしてください。  詳細については、「[Serializing Objects](http://msdn.microsoft.com/ja-jp/06c77f9b-5b2e-4c78-b3e3-8c148ba0ea99)」を参照してください。  
+  
+#### 型の安全性違反を防止する  
+ 型の安全性違反が発生すると、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] でオブジェクトのデータの整合性が保証されなくなります。  型の安全性違反は、信頼できないアプリケーションを完全信頼のコード アクセス セキュリティで実行できるようにすると発生する可能性があります。  
+  
+#### 例外を処理する  
+ try\/catch ブロック内の <xref:System.Data.Objects.ObjectContext> のメソッドとプロパティにアクセスします。  例外をキャッチすると、未処理の例外によって <xref:System.Data.Objects.ObjectStateManager> のエントリまたはモデル情報 \(テーブル名など\) がアプリケーションのユーザーに公開されることはありません。  
+  
+## ASP.NET アプリケーションのセキュリティに関する注意点  
+ [!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] アプリケーションでパスを操作する際には次の点に注意する必要があります。  
+  
+#### ホストでパスがチェックされるかどうかを確認する  
+ `|DataDirectory|` という \(パイプ記号で囲まれた\) 置換文字列を使用すると、解決されたパスがサポートされているかどうかが [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] によって確認されます。  たとえば、`DataDirectory` の後に ".." を使用することはできません。  Web アプリケーション ルート演算子 \(`~`\) の解決では、[!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] をホストするプロセスによってこれと同じチェックが行われます。  IIS ではこのチェックが行われますが、IIS 以外のホストでは、解決されたパスがサポートされているかどうかが確認されない可能性があります。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションを配置するホストの動作を把握しておく必要があります。  
+  
+#### 解決されるパス名を想定しない  
+ ルート演算子 \(`~`\) と `DataDirectory` 置換文字列が解決される値は、アプリケーションの実行中に変化しない状態で維持される必要がありますが、ホストでそれらの値の変更が [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって制限されるわけではありません。  
+  
+#### 配置の前にパスの長さを確認する  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションを配置する前に、ルート演算子 \(~\) と `DataDirectory` 置換文字列の値がオペレーティング システムのパスの長さの制限を超えないことを確認する必要があります。  [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダーでは、パスの長さが有効な制限内であるかどうかの確認が行われません。  
+  
+## ADO.NET メタデータのセキュリティに関する注意点  
+ モデル ファイルとマッピング ファイルの生成と操作を行う際は、セキュリティに関して次の点に注意する必要があります。  
+  
+#### 機密情報がログによって公開されないようにする。  
+ [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] メタデータ サービス コンポーネントでは個人情報はログに記録されません。  アクセス制限のために返すことのできない結果があった場合は、データベース管理システムやファイル システムで例外を生成する代わりに 0 個の結果を返す必要があります。例外には機密情報が含まれる可能性があります。  
+  
+#### 信頼されていないソースから MetadataWorkspace オブジェクトを受け取らない  
+ 信頼されていないソースから <xref:System.Data.Metadata.Edm.MetadataWorkspace> クラスのインスタンスをアプリケーションで受け取らないようにしてください。  代わりに、それらのソースから明示的にワークスペースを作成および設定する必要があります。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [配置に関する注意事項](../../../../../docs/framework/data/adonet/ef/deployment-considerations.md)   
+ [移行に関する注意点](../../../../../docs/framework/data/adonet/ef/migration-considerations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md b/docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md
new file mode 100644
index 00000000000..c062fdbbbae
--- /dev/null
+++ b/docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md
@@ -0,0 +1,32 @@
+---
+title: "サンプル プロバイダーでの SQL 生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e70f553d-4622-4627-928e-1aa2ee605d8e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# サンプル プロバイダーでの SQL 生成
+[Entity Framework サンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616) では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] をサポートする ADO.NET データ プロバイダーの新しいコンポーネントを説明しています。  これは、SQL Server 2005 データベースで動作し、System.Data.SqlClient ADO.NET 2.0 データ プロバイダーのラッパーとして実装されます。  
+  
+ サンプル プロバイダーの SQL 生成モジュール \(DmlSqlGenerator.cs ファイルを除き、SQL Generation フォルダーにあります\) では、入力として DbQueryCommandTree を使用し、単一の SQL SELECT ステートメントを生成します。  
+  
+## このセクションの内容  
+ ここでは、次のトピックについて説明します。  
+  
+ [アーキテクチャとデザイン](../../../../../docs/framework/data/adonet/ef/architecture-and-design.md)  
+  
+ [チュートリアル: SQL 生成](../../../../../docs/framework/data/adonet/ef/walkthrough-sql-generation.md)  
+  
+## 参照  
+ [SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/sql-generation.md b/docs/framework/data/adonet/ef/sql-generation.md
new file mode 100644
index 00000000000..3b09301a406
--- /dev/null
+++ b/docs/framework/data/adonet/ef/sql-generation.md
@@ -0,0 +1,37 @@
+---
+title: "SQL 生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e16aa02-d458-4418-a765-58b42aad9315
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# SQL 生成
+[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のプロバイダーを作成する場合は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] コマンド ツリーを特定のデータベースが認識できる SQL \(たとえば、SQL Server の場合は Transact\-SQL、Oracle の場合は PL\/SQL\) に変換する必要があります。  ここでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] プロバイダーの SQL 生成コンポーネント \(SELECT クエリ用\) の開発方法を説明します。  INSERT、UPDATE、および DELETE の各クエリの詳細については、「[変更 SQL 生成](../../../../../docs/framework/data/adonet/ef/modification-sql-generation.md)」を参照してください。  
+  
+ このセクションの内容を理解するには、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] と ADO.NET プロバイダー モデルについての知識が必要です。  また、コマンド ツリーと <xref:System.Data.Common.CommandTrees.DbExpression> について理解している必要もあります。  
+  
+## SQL 生成モジュールの役割  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] プロバイダーの SQL 生成モジュールは、指定されたクエリ コマンド ツリーを、SQL:1999 準拠のデータベースを対象とする 1 つの SQL SELECT ステートメントに変換します。  生成される SQL 内の入れ子になったクエリは、できるだけ少なくする必要があります。  SQL 生成モジュールによって出力クエリ コマンド ツリーを簡素化する必要はありません。  これは、結合の排除や連続するフィルター ノードの折りたたみなどにより、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] が実行する処理です。  
+  
+ <xref:System.Data.Common.DBProviderServices> クラスは、SQL 生成レイヤーにアクセスしてコマンド ツリーを <xref:System.Data.Common.DbCommands> に変換するための開始点となります。  
+  
+## このセクションの内容  
+ [コマンド ツリーの構造](../../../../../docs/framework/data/adonet/ef/the-shape-of-the-command-trees.md)  
+  
+ [コマンド ツリーからの SQL の生成: ベスト プラクティス](../../../../../docs/framework/data/adonet/ef/generating-sql-from-command-trees-best-practices.md)  
+  
+ [サンプル プロバイダーでの SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md)  
+  
+## 参照  
+ [Entity Framework データ プロバイダーの作成](../../../../../docs/framework/data/adonet/ef/writing-an-ef-data-provider.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md b/docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md
new file mode 100644
index 00000000000..6d30ac94524
--- /dev/null
+++ b/docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md
@@ -0,0 +1,45 @@
+---
+title: "Entity Framework 用 SqlClient 関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 71a3613c-b94e-494c-8ad8-90cf86ae0b87
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity Framework 用 SqlClient 関数
+Entity Framework 用の .NET Framework Data Provider for SQL Server \(SqlClient\) には、`System.DateTime` や `string` の操作を実行する関数の他に、数学計算および集計計算を実行する関数のセットが用意されています。  これらの関数は `SQLServer` 名前空間にあります。  
+  
+ どのプロバイダーでも動作する関数の一覧については、「[正規関数](../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)」を参照してください。  
+  
+ 正規関数が SQL Server 関数にどのようにマップされるかについては、「[概念モデル正規関数と SQL Server 関数とのマッピング](../../../../../docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md)」を参照してください。  
+  
+## このセクションの内容  
+ [概念モデル正規関数と SQL Server 関数とのマッピング](../../../../../docs/framework/data/adonet/ef/conceptual-model-canonical-to-sql-server-functions-mapping.md)  
+  
+ [集計関数](../../../../../docs/framework/data/adonet/ef/aggregate-functions-sqlclient-for-entity-framework.md)  
+  
+ [日付と時刻関数](../../../../../docs/framework/data/adonet/ef/date-and-time-functions.md)  
+  
+ [数学関数](../../../../../docs/framework/data/adonet/ef/mathematical-functions.md)  
+  
+ [文字列関数](../../../../../docs/framework/data/adonet/ef/string-functions.md)  
+  
+ [システム関数](../../../../../docs/framework/data/adonet/ef/system-functions.md)  
+  
+## 参照  
+ [Entity SQL リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-reference.md)   
+ [Entity SQL の概要](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/sqlclient-for-ef-types.md b/docs/framework/data/adonet/ef/sqlclient-for-ef-types.md
new file mode 100644
index 00000000000..b7454190003
--- /dev/null
+++ b/docs/framework/data/adonet/ef/sqlclient-for-ef-types.md
@@ -0,0 +1,2005 @@
+---
+title: "Entity Framework 用 SqlClient の型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: f2a95ead-c845-4e97-9fb3-04b444f7ed81
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity Framework 用 SqlClient の型
+\<?xml version="1.0" encoding="utf-8"?>
+\<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddue.schemas.microsoft.com/authoring/2003/5 http://clixdevr3.blob.core.windows.net/ddueschema/developer.xsd">
+  <introduction>
+    <para>.NET Framework Data Provider for SQL Server (SqlClient) プロバイダー マニフェスト ファイルには、プロバイダー プリミティブ型、マッピング、概念とストレージ モデルのプリミティブ型、および概念とストレージ モデルのプリミティブ型間での昇格と変換の規則、各型のファセットの一覧が含まれています。</para>
+    <para>次の表は、SQL Server 2008 の型を示して<token>ssVersion2005</token>、および<token>ssVersion2000</token>データベースとどのようにこれらの型を概念モデル型マップします。いくつかの新しい型が SQL Server の新しいバージョンで導入されており、これらの型は SQL Server の古いバージョンではサポートされていません。これらの型は、次の表で説明します。</para>
+    \<table xmlns:caps="http://schemas.microsoft.com/build/caps/2013/11">
+      <thead>
+        <tr>
+          <TD>
+            <para>プロバイダーの種類</para>
+            <para>名</para>
+          </TD>
+          <TD>
+            <para>プロバイダーの種類</para>
+            <para>属性</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>EDMSimpleType</languageKeyword>
+            </para>
+            <para>名</para>
+          </TD>
+          <TD>
+            <para>ファセット</para>
+          </TD>
+        </tr>
+      </thead>
+      <tbody>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>ビット</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Boolean</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>tinyint</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Byte</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>smallint</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Int16</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>int</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Int32</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>bigint 型</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Int64</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>浮動小数点数</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Double</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>本当の</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Double</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>10 進数</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Decimal</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>38</para>
+                    <para>18</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>スケール</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>0</para>
+                    <para>38</para>
+                    <para>0</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>数値</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Decimal</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>38</para>
+                    <para>18</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>スケール</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>0</para>
+                    <para>38</para>
+                    <para>0</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>smallmoney</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Decimal</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>10</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>スケール</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>4</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>money</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Decimal</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>19</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>スケール</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>4</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>バイナリ</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>8000</para>
+                    <para>8000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>varbinary</languageKeyword>
+            </para>
+            <para />
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>8000</para>
+                    <para>8000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>varbinary (max)</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>で<token>ssVersion2000</token>します。</para>
+              <para />
+            </alert>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>214748364780</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>イメージ</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>2,147,&483;,647</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>タイムスタンプ</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>8</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>rowversion</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Binary</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>8</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>smalldatetime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.DateTime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>0</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>datetime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.DateTime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                    <para />
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>3</para>
+                    <para>True</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>日付</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>SQL Server 2005 および SQL Server 2000 でします。</para>
+            </alert>
+            <para />
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.DateTime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                    <para />
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>0</para>
+                    <para>Flase</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>時間</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>SQL Server 2005 および SQL Server 2000 でします。</para>
+              <para />
+            </alert>
+            <para />
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Time</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                    <para />
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>7</para>
+                    <para>Flalse</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>datetime2</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>SQL Server 2005 および SQL Server 2000 でします。</para>
+              <para />
+            </alert>
+            <para />
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.DateTime</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                    <para />
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>7</para>
+                    <para>Flalse</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>datetimeoffset</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>SQL Server 2005 および SQL Server 2000 でします。</para>
+            </alert>
+            <para />
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.DateTimeOffset</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>有効桁数</para>
+                    <para />
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>7</para>
+                    <para>Flalse</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>nvarchar</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>で<token>ssVersion2000</token>します。</para>
+            </alert>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>4000</para>
+                    <para>4000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>varchar</languageKeyword>
+            </para>
+            <alert class="note">
+              <para>この型がサポートされていません</para>
+              <para>で<token>ssVersion2000</token>します。</para>
+            </alert>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>8000</para>
+                    <para>8000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>char 型</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>8000</para>
+                    <para>8000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>nchar</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>最小</para>
+                    <para>最大</para>
+                    <para>既定</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1</para>
+                    <para>4000</para>
+                    <para>4000</para>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>varchar</languageKeyword>(<parameterReference>max</parameterReference>)</para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>2,147,&483;,647</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>nvarchar</languageKeyword>(<parameterReference>max</parameterReference>)</para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1073741823</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>ntext</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>等しい</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>注文</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1073741823</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>テキスト</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>等しい</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>注文</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>2,147,&483;,647</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>一意な</languageKeyword>
+            </para>
+            <para>
+              <languageKeyword>識別子</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>等しい</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>注文</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.Guid</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <para>該当なし</para>
+          </TD>
+        </tr>
+        <tr>
+          <TD>
+            <para>
+              <languageKeyword>xml</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>等しい</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>注文</para>
+                    <para>同等</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+          <TD>
+            <para>
+              <languageKeyword>Edm.String</languageKeyword>
+            </para>
+          </TD>
+          <TD>
+            <table>
+              <thead>
+                <tr>
+                  <TD>
+                    <para>ファセットの名前</para>
+                  </TD>
+                  <TD>
+                    <para>属性</para>
+                    <para>名</para>
+                  </TD>
+                  <TD>
+                    <para>値</para>
+                  </TD>
+                </tr>
+              </thead>
+              <tbody>
+                <tr>
+                  <TD>
+                    <para>MaxLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>1073741823</para>
+                    <para>は true。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>Unicode</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>True</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+                <tr>
+                  <TD>
+                    <para>FixedLength</para>
+                  </TD>
+                  <TD>
+                    <para>既定の</para>
+                    <para>定数</para>
+                  </TD>
+                  <TD>
+                    <para>False</para>
+                    <para>は True。</para>
+                  </TD>
+                </tr>
+              </tbody>
+            </table>
+            <para />
+          </TD>
+        </tr>
+      </tbody>
+    </table>
+  </introduction>
+  <relatedTopics>
+\<link xlink:href="bbdc9237-ff4c-4441-9565-31ebc29743e9">CSDL、SSDL、および MSL 仕様</link>
+</relatedTopics>
+</developerConceptualDocument>
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md b/docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md
new file mode 100644
index 00000000000..432716d33b8
--- /dev/null
+++ b/docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md
@@ -0,0 +1,65 @@
+---
+title: "Entity Framework 用 SqlClient | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 9a5d6d39-d955-43a5-a5c2-931c239398f1
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Framework 用 SqlClient
+このセクションでは、.NET Framework Data Provider for SQL Server \(SqlClient\) について説明します。これによって、Microsoft SQL Server 上で Entity Framework が機能できるようになります。  
+  
+## Provider スキーマ属性  
+ `Provider` は、ストア スキーマ定義言語 \(SSDL\) の `Schema` 要素の属性です。  
+  
+ SqlClient を使用するには、文字列 "System.Data.SqlClient" を `Schema` 要素の `Provider` 属性に割り当てます。  
+  
+## ProviderManifestToken スキーマ属性  
+ `ProviderManifestToken` は、SSDL の`Schema` 要素の必須の属性です。  このトークンは、オフライン シナリオ用のプロバイダー マニフェストを読み込むために使用されます。  `ProviderManifestToken` 属性の詳細については、「[Schema Element \(SSDL\)](http://msdn.microsoft.com/ja-jp/fec75ae4-7f16-4421-9265-9dac61509222)」を参照してください。  
+  
+ SqlClient は、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の各バージョンのデータ プロバイダーとして使用できます。  これらのバージョンでは機能が異なります。  たとえば、[!INCLUDE[ssVersion2000](../../../../../includes/ssversion2000-md.md)] では、[!INCLUDE[ssVersion2005](../../../../../includes/ssversion2005-md.md)] で導入された `varchar(max)` 型および `nvarchar(max)` 型をサポートしていません。  
+  
+ SqlClient は、SQL Server の各バージョンに対応する次のプロバイダー マニフェスト トークンを生成し、受け取ります。  
+  
+||||  
+|-|-|-|  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|2000|2005|2008|  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvs](../../../../../includes/vsprvs-md.md)] 2010 以降では、[ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527) は、SQL Server 2000 をサポートしません。  
+  
+## プロバイダーの名前空間名  
+ すべてのプロバイダーで名前空間を指定する必要があります。  このプロパティによって、型や関数など、プロバイダーが特定のコンストラクターに使用するプレフィックスを Entity Framework に通知できます。  SqlClient プロバイダー マニフェストの名前空間は `SqlServer` です。  名前空間の詳細については、「[名前空間](../../../../../docs/framework/data/adonet/ef/language-reference/namespaces-entity-sql.md)」を参照してください。  
+  
+## 型  
+ Entity Framework 用の SqlClient プロバイダーは、概念モデルの型と SQL Server 型の間のマッピング情報を提供します。  詳細については、「[Entity Framework 用 SqlClient の型](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-types.md)」を参照してください。  
+  
+## 関数  
+ Entity Framework 用の SqlClient プロバイダーは、プロバイダーがサポートする関数の一覧を定義します。  サポートされる関数の一覧については、「[Entity Framework 用 SqlClient 関数](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Entity Framework 用 SqlClient 関数](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)  
+  
+ [Entity Framework 用 SqlClient の型](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-types.md)  
+  
+ [Entity Framework 用の SqlClient の既知の問題](../../../../../docs/framework/data/adonet/ef/known-issues-in-sqlclient-for-entity-framework.md)  
+  
+## 参照  
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)   
+ [言語リファレンス](../../../../../docs/framework/data/adonet/ef/language-reference/index.md)   
+ [Known Issues in SqlClient Provider for Entity Framework](../../../../../docs/framework/data/adonet/ef/sqlclient-for-the-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/string-functions.md b/docs/framework/data/adonet/ef/string-functions.md
new file mode 100644
index 00000000000..cb92c622db5
--- /dev/null
+++ b/docs/framework/data/adonet/ef/string-functions.md
@@ -0,0 +1,62 @@
+---
+title: "文字列関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 338f0c26-8aee-43eb-bd1a-ec0849a376b9
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 文字列関数
+.NET Framework Data Provider for SQL Server (SqlClient) には、入力された `String` に対して操作を実行し、その結果を `String` または数値として返す `String` 関数が用意されています。 これらの関数は、SqlClient の SqlServer 名前空間に存在します。 Entity Framework は、プロバイダーの名前空間プロパティを使用することにより、型や関数など、特定のコンストラクターに対してこのプロバイダーによってどのプレフィックスが使用されているかを特定できます。  
+  
+ 次の表に、SqlClient の `String` 関数を示します。  
+  
+|関数|説明|  
+|--------------|-----------------|  
+|`ASCII(` `expression` `)`|文字列式の左端の文字の ASCII コード値を返します。<br /><br /> **引数**<br /><br /> `expression`: ASCII `String` 型の任意の有効な式。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **使用例**<br /><br /> `SqlServer.ASCII('A')`|  
+|`CHAR(` `expression` `)`|`Int32` コードを ASCII String に変換します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`。<br /><br /> **戻り値**<br /><br /> ASCII の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.char(97)`|  
+|`CHARINDEX(` `expression1, expression2` [, `start_location`]`)`|指定された式の、文字列内での開始位置を返します。<br /><br /> **引数**<br /><br /> `expression1`: 検索する文字列を含む式。 String (ASCII または Unicode) 型または Binary 型の式を指定できます。<br /><br /> `expression2`: 式。通常は、文字列を検索する対象の列を指定します。 String (ASCII または Unicode) 型または Binary 型の式を指定できます。<br /><br /> `start_location`: (省略可能) int64 型 (SQL Server 2000 では返されません) または expression2 内の expression1 の検索を開始する文字の位置を表す Int32。 start_location を指定しなかった場合、または負の値や&0; を指定した場合は、expression2 の先頭から検索が開始されます。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **使用例**<br /><br /> `SqlServer.CHARINDEX('h', 'habcdefgh', 2)`|  
+|`DIFFERENCE(` `expression, expression` `)`|2 つの文字列の `SOUNDEX` 値を比較し、両者の類似性を評価します。<br /><br /> **引数**<br /><br /> ASCII または Unicode の `String` 型。 `expression` 引数には定数、変数、または列を指定できます。<br /><br /> **戻り値**<br /><br /> 2 つの文字式の SOUNDEX 値の差を表す `Int32` を返します。 値の範囲は 0 ～ 4 です。 0 は類似性が低いか類似性がないことを示し、4 は類似性が高いか同じ値であることを示します。<br /><br /> **使用例**<br /><br /> `// The following example returns a DIFFERENCE value of 4,`<br /><br /> `//the least possible difference or the best match.`<br /><br /> `SqlServer.DIFFERENCE('Green','Greene');`|  
+|`LEFT(` `expression, count` `)`|文字列の左端から指定された数の文字を返します。<br /><br /> **引数**<br /><br /> `expression`: Unicode または ASCII の String 型。 CAST 関数を使用して、明示的に character_expression を変換します。<br /><br /> `count`: character_expression から取得する文字数を指定する `Int64` (SQL Server 2000 では返されません) または `Int32` 型。<br /><br /> **戻り値**<br /><br /> Unicode または ASCII の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.LEFT('SQL Server', 4)`|  
+|`LEN(` `expression` `)`|指定された文字列式の、末尾の空白を除いた文字数を返します。<br /><br /> **引数**<br /><br /> `expression`: `String` (Unicode または ASCII) 型または `Binary` 型の式。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **使用例**<br /><br /> `SqlServer.LEN('abcd')`|  
+|`LOWER(` `expression` `)`|大文字が小文字に変換された状態の `String` 式を返します。<br /><br /> **引数**<br /><br /> `expression`: `String` 型の任意の有効な式。<br /><br /> **戻り値**<br /><br /> `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.LOWER('AbB')`|  
+|`LTRIM(` `expression` `)`|先頭のスペースを削除した後の `String` 式を返します。<br /><br /> **引数**<br /><br /> `expression`: `String` 型の任意の有効な式。<br /><br /> **戻り値**<br /><br /> `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.LTRIM('   d')`|  
+|`NCHAR(` `expression` `)`|Unicode 標準の定義に従って、指定された整数コードの Unicode の `String` を返します。<br /><br /> **引数**<br /><br /> `expression`: `Int32`。<br /><br /> **戻り値**<br /><br /> Unicode の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.NCHAR(65)`|  
+|`PATINDEX(` `'%pattern%'`, `expression``)`|指定された `String` 式の中で、特定のパターンが最初に現れる先頭位置を返します。<br /><br /> **引数**<br /><br /> `'%pattern%'`: ASCII または Unicode の `String` 型。 ワイルドカード文字も使用できます。ただし、パターンの前後に % 文字が必要です (先頭の文字または末尾の文字を検索する場合は除く)。<br /><br /> `expression`: 指定パターンの検索対象となる ASCII または Unicode の `String`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **使用例**<br /><br /> `SqlServer.PATINDEX('abc', 'ab')`|  
+|`QUOTENAME(` `'char_string'` [, '`quote_char'`]`)`|Unicode の `String` に区切り記号を追加して返すことで、入力文字列から区切り記号で囲まれた有効な SQL Server 2005 識別子を作成します。<br /><br /> **引数**<br /><br /> `char_string`: Unicode の `String`。<br /><br /> `quote_char`: 区切り記号として使用する&1; つの文字を指定します。 単一引用符 (')、左または右の角かっこ ([ ])、二重引用符 (") のいずれかを指定できます。 `quote_char` を指定しない場合は、角かっこが使用されます。<br /><br /> **戻り値**<br /><br /> Unicode の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.QUOTENAME('abc[]def')`|  
+|`REPLACE(` `expression1`, `expression2, expression3``)`|文字式を指定された回数繰り返します。<br /><br /> **引数**<br /><br /> `expression1`: 検索範囲となる文字列式。 string_expression1 は、Unicode または ASCII の String 型で指定できます。<br /><br /> `expression2`: 部分文字列が見つかりません。 string_expression2 は、Unicode または ASCII の String 型で指定できます。<br /><br /> `expression3`: 置換文字列。 string_expression3 は、Unicode または ASCII の String 型で指定できます。<br /><br /> **使用例**<br /><br /> `SqlServer.REPLACE('aabbcc', 'bc', 'zz')`|  
+|`REPLICATE(``char_expression`, int_`expression``)`|文字式を指定された回数繰り返します。<br /><br /> **引数**<br /><br /> `char_expression`: Unicode または ASCII の `String` 型。<br /><br /> `int_expression`: `Int64` (SQL Server 2000 ではサポートされません) または `Int32`。<br /><br /> **戻り値**<br /><br /> Unicode または ASCII の `String` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.REPLICATE('aa',2)`|  
+|`REVERSE(` `expression` `)`|入力文字列の文字位置を逆転した Unicode または ASCII の String を返します。<br /><br /> **引数**<br /><br /> `expression`: Unicode または ASCII の `String` 型。<br /><br /> **戻り値**<br /><br /> Unicode または ASCII の `String` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.REVERSE('abcd')`|  
+|`RIGHT(` `char_expression`, `count``)`|文字列の右端から指定された数の文字を返します。<br /><br /> **引数**<br /><br /> `char_expression`: Unicode または ASCII の String 型。 CAST 関数を使用して、明示的に character_expression を変換します。<br /><br /> `count`: character_expression から取得する文字数を指定する `Int64` (SQL Server 2000 では返されません) または `Int32` 型。<br /><br /> **戻り値**<br /><br /> ASCII の `String` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.RIGHT('SQL Server', 6)`|  
+|`RTRIM(` `expression` `)`|末尾のスペースを削除した後の Unicode または ASCII の String を返します。<br /><br /> **引数**<br /><br /> `expression`: Unicode または ASCII の `String` 型。<br /><br /> **戻り値**<br /><br /> Unicode または ASCII の `String` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.RTRIM('   d   e      ')`|  
+|`SOUNDEX(` `expression` `)`|2 つの文字列の類似性を評価する&4; 文字 (SOUNDEX) コードを返します。**引数**<br /><br /> `expression`: Unicode または ASCII の String 型。<br /><br /> **戻り値**<br /><br /> ASCII の `String`。 4 文字の (SOUNDEX) コードは、2 つの文字列の類似性を評価する文字列です。<br /><br /> **使用例**<br /><br /> `Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1}`<br /><br /> **返します。**<br /><br /> `----- -----  S530  S530`|  
+|`SPACE(` `int_expression` `)`|連続する空白文字で構成される ASCII の `String` を返します。<br /><br /> **引数**<br /><br /> `int_expression`: 空白文字の数を表す `Int64` (SQL Server 2000 では返されません) または `Int32`。<br /><br /> **戻り値**<br /><br /> ASCII の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.SPACE(2)`|  
+|`STR(` `float_expression` [, `length` [, `decimal`]]`)`|数値データから変換された ASCII の `String` を返します。<br /><br /> **引数**<br /><br /> `float _expression`: 小数点付きの概数型 (`Double`) の式。<br /><br /> `length`: (省略可) 全体の長さを表す `Int32`。 これには小数点、符号、数字、空白文字も含まれます。 既定値は 10 です。<br /><br /> `decimal`: (省略可能)、`Int32`小数の桁数を小数点以下の桁数を表します。 16 以下である必要があります。 decimal に 16 を超える値を指定した場合、結果は小数点以下 16 桁に切り捨てられます。<br /><br /> **戻り値**<br /><br /> ASCII の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.STR(212.0)`|  
+|`STUFF(` `str_expression`, `start, length`, `str_expression_to_insert``)`|文字列式内で、指定された長さ分の文字を削除し、指定された開始位置に別の文字列を挿入します。<br /><br /> **引数**<br /><br /> `str_expression`: Unicode または ASCII の `String`。<br /><br /> `start:``Int64` (SQL Server 2000 では返されません) または`Int32`削除と挿入を開始する位置を指定する値。<br /><br /> `length`: 削除する文字数を指定する `Int64` 型 (SQL Server 2000 では返されません) または `Int32` 型の値。<br /><br /> `str_expression_to_insert`: Unicode または ASCII の `String`。<br /><br /> **戻り値**<br /><br /> Unicode または ASCII の `String`。<br /><br /> **使用例**<br /><br /> `SqlServer.STUFF('abcd', 2, 2, 'zz')`|  
+|`SUBSTRING(` `str_expression`, `start, length``)`|`String` 式の一部分を返します。<br /><br /> **引数**<br /><br /> `str_expression`: `String` (ASCII または Unicode) 型または `Binary` 型の式。<br /><br /> `start`: 部分文字列の取得開始位置を指定する `Int64` ( SQL Server 2000 では返されません) または `Int32`。 1 は文字列の先頭文字を表します。<br /><br /> `length`: 式から取得する文字数を指定する `Int64` (SQL Server 2000 では返されません) または `Int32` 型。<br /><br /> **戻り値**<br /><br /> `String` (ASCII または Unicode) 型または `Binary` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.SUBSTRING('abcd', 2, 2)`|  
+|`UNICODE(` `expression` `)`|Unicode 標準に定義された、入力式の先頭文字の整数値を返します。<br /><br /> **引数**<br /><br /> `expression`: Unicode の `String`。<br /><br /> **戻り値**<br /><br /> `Int32`。<br /><br /> **使用例**<br /><br /> `SqlServer.UNICODE('a')`|  
+|`UPPER(` `expression` `)`|小文字が大文字に変換された状態の `String` 式を返します。<br /><br /> **引数**<br /><br /> `expression`: ASCII または Unicode の String 型の式。<br /><br /> **戻り値**<br /><br /> ASCII または Unicode の `String` 型。<br /><br /> **使用例**<br /><br /> `SqlServer.UPPER('AbB')`|  
+  
+ SqlClient でサポートされる `String` 関数の詳細については、SqlClient プロバイダー マニフェストで指定した SQL Server のバージョンのドキュメントを参照してください。  
+  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|---------------------|---------------------|---------------------|  
+|[文字列関数 (TRANSACT-SQL)](http://go.microsoft.com/fwlink/?LinkId=115915)|[文字列関数 (TRANSACT-SQL)](http://go.microsoft.com/fwlink/?LinkId=115916)|[文字列関数 (TRANSACT-SQL)](http://go.microsoft.com/fwlink/?LinkId=115914)|  
+  
+## <a name="see-also"></a>関連項目  
+ [Entity Framework 関数用 SqlClient](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)   
+ [Entity Framework 用 SqlClient の既知の問題](../../../../../docs/framework/data/adonet/ef/known-issues-in-sqlclient-for-entity-framework.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/system-functions.md b/docs/framework/data/adonet/ef/system-functions.md
new file mode 100644
index 00000000000..8f38d5737e2
--- /dev/null
+++ b/docs/framework/data/adonet/ef/system-functions.md
@@ -0,0 +1,46 @@
+---
+title: "システム関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b7c71b58-09e6-44ce-a3e5-a0fdb892fb86
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# システム関数
+.NET Framework Data Provider for SQL Server \(SqlClient\) には、次のシステム関数が用意されています。  
+  
+|関数|説明|  
+|--------|--------|  
+|`CHECKSUM (` `value`, \[`value`, \[`value`\]\]`)`|チェックサム値を返します。  `CHECKSUM` は、ハッシュ インデックスの作成に使用します。<br /><br /> **引数**<br /><br /> `value`: `Boolean`、`Byte`、`Int16`、`Int32`、`Int64`、`Single`、`Decimal`、`Double`、`DateTime`、`String`、`Binary`、または `Guid`。  1 つ、2 つ、または 3 つの値を指定できます。<br /><br /> **戻り値**<br /><br /> 指定された式の絶対値。<br /><br /> **例**<br /><br /> `SqlServer.CHECKSUM(10,100,1000.0)`|  
+|`CURRENT_TIMESTAMP ()`|有効桁数が 7 \(SQL Server 2008\) または 3 \(SQL Server 2005\) の `DateTime` 値に使用する現在の日付と時刻を SQL Server の内部形式で生成します。<br /><br /> **戻り値**<br /><br /> 現在のシステム日時を `DateTime` として表現した値。<br /><br /> **例**<br /><br /> `SqlServer.CURRENT_TIMESTAMP()`|  
+|`CURRENT_ USER` `()`|現在のユーザーの名前を返します。<br /><br /> **戻り値**<br /><br /> ASCII の `String`。<br /><br /> **例**<br /><br /> `SqlServer.CURRENT_USER()`|  
+|`DATALENGTH` `(``expression``)`|式を表すために必要なバイト数を返します。<br /><br /> **引数**<br /><br /> `expression`: `Boolean`、`Byte`、`Int16`、`Int32`、`Int64`、`Single`、`Decimal`、`Double`、`DateTime`、`Time`、`DateTimeOffset`、`String`、`Binary`、または `Guid`。<br /><br /> **戻り値**<br /><br /> プロパティのサイズ \(`Int32`\)。<br /><br /> **例**<br /><br /> `SELECT VALUE SqlServer.DATALENGTH(P.Name)FROM`<br /><br /> `AdventureWorksEntities.Product AS P`|  
+|`HOST_NAME()`|ワークステーション名を返します。<br /><br /> **戻り値**<br /><br /> Unicode の `String`。<br /><br /> **例**<br /><br /> `SqlServer.HOST_NAME()`|  
+|`ISDATE(` `expression` `)`|入力式が有効な日付かどうかを調べます。<br /><br /> **引数**<br /><br /> `expression`: `Boolean`、`Byte`、`Int16`、`Int32`、`Int64`、`Single`、`Decimal`、`Double`、`DateTime`、`Time`、`DateTimeOffset`、`String`、`Binary`、または `Guid`。<br /><br /> **戻り値**<br /><br /> `Int32`。  入力式が有効な日付である場合は 1 です。  それ以外の場合は 0 です。<br /><br /> **例**<br /><br /> `SqlServer.ISDATE('1/1/2006')`|  
+|`ISNUMERIC(` `expression` `)`|式が数値型として有効かどうかを調べます。<br /><br /> **引数**<br /><br /> `expression`: `Boolean`、`Byte`、`Int16`、`Int32`、`Int64`、`Single`、`Decimal`、`Double`、`DateTime`、`Time`、`DateTimeOffset`、`String`、`Binary`、または `Guid`。<br /><br /> **戻り値**<br /><br /> `Int32`。  入力式が有効な日付である場合は 1 です。  それ以外の場合は 0 です。<br /><br /> **例**<br /><br /> `SqlServer.ISNUMERIC('21')`|  
+|`NEWID()`|Guid 型の一意な値を作成します。<br /><br /> **戻り値**<br /><br /> `Guid`<br /><br /> **例**<br /><br /> `SqlServer.NEWID()`|  
+|`USER_NAME(` `id` `)`|指定した識別番号から、データベース ユーザー名を返します。<br /><br /> **引数**<br /><br /> `expression`: データベース ユーザーに関連付けられている `Int32` 型の識別番号を指定します。<br /><br /> **戻り値**<br /><br /> Unicode の `String`。<br /><br /> **例**<br /><br /> `SqlServer.USER_NAME(0)`|  
+  
+ SqlClient でサポートされる文字列関数の詳細については、SqlClient プロバイダー マニフェストで指定した SQL Server のバージョンのドキュメントを参照してください。  
+  
+|SQL Server 2000|SQL Server 2005|SQL Server 2008|  
+|---------------------|---------------------|---------------------|  
+|[システム関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115918)|[システム関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115917)|[システム関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=115919)|  
+  
+## 参照  
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)   
+ [Entity Framework 用 SqlClient 関数](../../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/terminology.md b/docs/framework/data/adonet/ef/terminology.md
new file mode 100644
index 00000000000..cbd398d43db
--- /dev/null
+++ b/docs/framework/data/adonet/ef/terminology.md
@@ -0,0 +1,93 @@
+---
+title: "Entity Framework の用語 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: fa2a1bd1-6118-487b-8673-eebc66b92945
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Entity Framework の用語
+このトピックでは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のドキュメントでよく使用される用語の定義について説明します。  追加情報を確認できる関連トピックへのリンクも示しています。  
+  
+|用語|定義|  
+|--------|--------|  
+|関連付け|エンティティ型間のリレーションシップの定義。<br /><br /> 詳細については、「[Association Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/c305169a-8af7-432f-9ba7-800a163aed41)」および「[アソシエーション型](../../../../../docs/framework/data/adonet/association-type.md)」を参照してください。|  
+|関連付けセット|同じ型のアソシエーションのインスタンスの論理コンテナー。<br /><br /> 詳細については、「[AssociationSet Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/512cbb75-cebe-4f3f-970d-3419deeff684)」および「[アソシエーション セット](../../../../../docs/framework/data/adonet/association-set.md)」を参照してください。|  
+|Code First|Entity Framework 4.1 以降では、Code First の開発を使用してモデルをプログラムで作成することもできます。  Code First の開発に対しては、2 つの異なるシナリオがあります。  どちらの場合でも、開発者は .NET Framework のクラス定義をコーディングしてモデルを定義し、データ注釈または Fluent API を使用してオプションで追加のマッピングまたは構成を指定します。<br /><br /> Code First の開発は、[Entity Framework 5.0](http://go.microsoft.com/fwlink/?LinkId=234900) の一部であることに注意してください。  Entity Framework 5.0 は .NET Framework の一部ではありませんが、.NET Framework 4.5 で構成されます。  Entity Framework 5.0 は、[‘Entity Framework’](http://go.microsoft.com/fwlink/?LinkID=215714) [NuGet](http://go.microsoft.com/fwlink/?LinkId=232488) パッケージとして入手できます。  詳細については、「[Entity Framework リリースおよびバージョン指定](http://go.microsoft.com/fwlink/?LinkId=234899)」を参照してください。|  
+|コマンド ツリー|1 つ以上の式で構成されるすべての [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] クエリの共通プログラム表現。<br /><br /> 詳細については、「[エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)」を参照してください。|  
+|複合型|概念モデルで定義されている複合プロパティを表す [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] クラス。  複合型により、スカラー プロパティをエンティティ内で整理することができます。  複合オブジェクトは、複合型のインスタンスです。  詳細については、「[ComplexType Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/f1c2f311-9889-4b87-abd8-a94f322052e3)」および「[複合型](../../../../../docs/framework/data/adonet/complex-type.md)」を参照してください。|  
+|ComplexType|キー プロパティを持たないエンティティ型の非スカラー プロパティを表すデータ型の仕様。<br /><br /> 詳細については、「[ComplexType Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/f1c2f311-9889-4b87-abd8-a94f322052e3)」および「[複合型](../../../../../docs/framework/data/adonet/complex-type.md)」を参照してください。|  
+|概念モデル|[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] のアプリケーションのドメインにおけるエンティティ型、複合型、アソシエーション、エンティティ コンテナー、エンティティ セット、およびアソシエーション セットの抽象的な仕様。  概念モデルは、CSDL で .csdl ファイルに定義されます。<br /><br /> 詳細については、「[モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)」を参照してください。|  
+|.csdl ファイル|CSDL で表現された概念モデルを含む XML ファイル。|  
+|概念スキーマ定義言語 \(CSDL\)|概念モデルのエンティティ型、関連付け、エンティティ コンテナー、エンティティ セット、および関連付けセットを定義するための XML ベースの言語。<br /><br /> 詳細については、「[CSDL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)」を参照してください。|  
+|コンテナー|エンティティ セットとアソシエーション セットの論理的なグループ。<br /><br /> 詳細については、「[EntityContainer Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/06d03ecb-3b7a-4e7f-95d5-b95307d47a27)」および「[エンティティ コンテナー](../../../../../docs/framework/data/adonet/entity-container.md)」を参照してください。|  
+|同時実行|複数のユーザーが共有データに同時にアクセスや変更を行うことができるようにする処理。  既定では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、オプティミスティック同時実行制御モデルを実装しています。|  
+|方向|一部のアソシエーションの非対称の性質を表します。  方向は、スキーマの `NavigationProperty` 要素または `ReferentialConstraint` 要素の `FromRole` 属性と `ToRole` 属性で指定されます。<br /><br /> 詳細については、「[NavigationProperty Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/5829a238-a50e-4c81-901d-7b54fc00f27e)」および「[ナビゲーション プロパティ](../../../../../docs/framework/data/adonet/navigation-property.md)」を参照してください。|  
+|一括読み込み|関連オブジェクトの特定のセットを、クエリで明示的に要求されたオブジェクトと共に読み込むプロセス。|  
+|.edmx ファイル|概念モデル \(CSDL\)、ストレージ モデル \(SSDL\)、および概念モデルとストレージ モデルの間のマッピング \(MSL\) を含む XML ファイル。  .edmx ファイルが [!INCLUDE[adonet_edm](../../../../../includes/adonet-edm-md.md)] ツールによって作成されます。詳細については、「[.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)」を参照してください。|  
+|End|アソシエーションに参加しているエンティティ。<br /><br /> 詳細については、「[End Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/04f3c141-95bc-424b-989b-1c071b449e7c)」および「[アソシエーション End](../../../../../docs/framework/data/adonet/association-end.md)」を参照してください。|  
+|エンティティ|データ型を定義する際に基づくアプリケーションのドメインにおける概念。<br /><br /> 詳細については、「[EntityType Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/19562e9f-fd70-4b59-bc15-3e289cbb6054)」および「[エンティティ型](../../../../../docs/framework/data/adonet/entity-type.md)」を参照してください。|  
+|EntityClient|`EntityConnection`、`EntityCommand`、`EntityDataReader` などのクラスを含むストレージの影響を受けない [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダー。  [!INCLUDE[esql](../../../../../includes/esql-md.md)] で動作し、`SqlClient` などのストレージ固有の [!INCLUDE[vstecado](../../../../../includes/vstecado-md.md)] データ プロバイダーに接続します。<br /><br /> 詳細については、「[Entity Framework 用の EntityClient プロバイダー](../../../../../docs/framework/data/adonet/ef/entityclient-provider-for-the-entity-framework.md)」を参照してください。|  
+|エンティティ コンテナー|指定された名前空間に実装されるエンティティ セットとアソシエーション セットを指定します。<br /><br /> 詳細については、「[EntityContainer Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/06d03ecb-3b7a-4e7f-95d5-b95307d47a27)」および「[エンティティ コンテナー](../../../../../docs/framework/data/adonet/entity-container.md)」を参照してください。|  
+|Entity Data Model \(EDM\)|格納される形式に関係なく、エンティティおよびリレーションシップとしてデータ構造を記述する一連の概念。<br /><br /> 詳細については、「[Entity Data Model](../../../../../docs/framework/data/adonet/entity-data-model.md)」を参照してください。|  
+|Entity Framework|開発者がデータ ソースの論理スキーマにマップされた概念モデルを使用できるようにすることで、データ指向のソフトウェア アプリケーションの開発をサポートするテクノロジ セット。<br /><br /> 詳細については、「[エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)」を参照してください。|  
+|エンティティ セット|指定された型とそのサブタイプのエンティティの論理コンテナー。  エンティティ セットは、データベース内のテーブルにマップされます。<br /><br /> 詳細については、「[EntitySet Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/ec56db77-718d-4c0e-adc9-f1d33c896287)」および「[エンティティ セット](../../../../../docs/framework/data/adonet/entity-set.md)」を参照してください。|  
+|Entity SQL|エンティティの概念スキーマを直接操作し、継承やリレーションシップなどの概念モデルの概念をサポートする、ストレージの影響を受けない SQL の言語。<br /><br /> 詳細については、「[Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)」を参照してください。|  
+|エンティティ型|概念モデルでの定義に従ってエンティティを表す [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] クラス。  エンティティ型には、スカラー プロパティ、複合プロパティ、およびナビゲーション プロパティが含まれる場合があります。  オブジェクトは、エンティティ型のインスタンスです。  詳細については、「[オブジェクトの使用](../../../../../docs/framework/data/adonet/ef/working-with-objects.md)」を参照してください。|  
+|EntityType|キーやプロパティの名前付きセットを含み、概念モデルまたはストレージ モデルの最上位項目を表すデータ型の仕様。<br /><br /> 詳細については、「[EntityType Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/19562e9f-fd70-4b59-bc15-3e289cbb6054)」および「[エンティティ型](../../../../../docs/framework/data/adonet/entity-type.md)」を参照してください。|  
+|明示的な読み込み|クエリがオブジェクトを返す場合、関連オブジェクトは同時に読み込まれません。  既定では、関連オブジェクトは、ナビゲーション プロパティの `Load` メソッドを使用して明示的に要求されるまで読み込まれません。|  
+|外部キーの関連付け \(アソシエーション\)|外部キー プロパティで管理されるエンティティ間のアソシエーション。|  
+|依存リレーションシップ|プリンシパル エンティティの主キーが依存エンティティの主キーの一部であるリレーションシップ。  このようなリレーションシップでは、プリンシパル エンティティが存在しないと、依存エンティティは存在できません。|  
+|独立した関連付け \(アソシエーション\)|独立オブジェクトによって表され、追跡されるエンティティ間のアソシエーション。|  
+|key|エンティティ型の一意のインスタンスを識別するために使用されるプロパティまたはプロパティ セットを指定するエンティティ型の属性。  オブジェクト レイヤーでは、<xref:System.Data.EntityKey> クラスで表現されます。<br /><br /> 詳細については、「[Key Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/0cdb1402-dbc7-4a04-a11e-5729cdf7431b)」および「[エンティティ キー](../../../../../docs/framework/data/adonet/entity-key.md)」を参照してください。|  
+|遅延読み込み|クエリがオブジェクトを返す場合、関連オブジェクトは同時に読み込まれません。  代わりに、ナビゲーション プロパティへのアクセス時に自動的に読み込まれます。|  
+|[!INCLUDE[linq_entities](../../../../../includes/linq-entities-md.md)]|走査、フィルター、および射影操作を [!INCLUDE[csprcs](../../../../../includes/csprcs-md.md)] と [!INCLUDE[vbprvb](../../../../../includes/vbprvb-md.md)] で直接的な宣言型の方法で表現できるようにする一連のクエリ演算子を定義するクエリ構文。<br /><br /> 詳細については、「[LINQ to Entities](../../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)」を参照してください。|  
+|マップ|概念モデルの項目とストレージ モデルの項目の対応付けの指定。<br /><br /> 詳細については、「[MSL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/msl-specification.md)」を参照してください。|  
+|.msl ファイル|MSL で表現された概念モデルとストレージ モデルの間のマッピングを含む XML ファイル。|  
+|マッピング仕様言語 \(MSL\)|概念モデルで定義された項目をストレージ モデルの項目に対応付ける XML ベースの言語。<br /><br /> 詳細については、「[MSL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/msl-specification.md)」を参照してください。|  
+|変更関数|データ ソースでデータを挿入、更新、および削除するために使用されるストアド プロシージャ。  この関数は、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] で生成されるコマンドの代わりに使用されます。  変更関数は、ストレージ モデルの `Function` 要素で定義されます。  [ModificationFunctionMapping](http://msdn.microsoft.com/ja-jp/b44b5b13-9937-448b-ba36-7a0cfefea782) 要素によって、概念モデルで定義されているエンティティに対する挿入、更新、削除などの操作にこの変更関数がマップされます。|  
+|多重度|アソシエーションによって定義されているリレーションシップの両側に存在できるエンティティの数。  基数とも呼ばれます。<br /><br /> 詳細については、「[End Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/04f3c141-95bc-424b-989b-1c071b449e7c)」および「[アソシエーション End](../../../../../docs/framework/data/adonet/association-end.md)」を参照してください。|  
+|Multiple\-Entity\-Sets\-per\-Type|1 つのエンティティ型を複数のエンティティ セットで定義できる機能。<br /><br /> 詳細については、「[EntitySet Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/ec56db77-718d-4c0e-adc9-f1d33c896287)」および「[How to: Define a Model with Multiple Entity Sets per Type](http://msdn.microsoft.com/ja-jp/61aa4fca-5ac0-4f47-9bc8-46e8c2965ef7)」を参照してください。|  
+|ナビゲーション プロパティ|アソシエーションによって定義されている別のエンティティ型とのリレーションシップを表すエンティティ型のプロパティ。  ナビゲーション プロパティは、アソシエーションのもう一方の End での複数要素の接続性に応じて、関連オブジェクトを <xref:System.Data.Objects.DataClasses.EntityCollection%601> または <xref:System.Data.Objects.DataClasses.EntityReference%601> として返すために使用されます。<br /><br /> 詳細については、「[NavigationProperty Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/5829a238-a50e-4c81-901d-7b54fc00f27e)」および「[ナビゲーション プロパティ](../../../../../docs/framework/data/adonet/navigation-property.md)」を参照してください。|  
+|クエリ パス|オブジェクト クエリの実行時に返す関連オブジェクトを指定するパスの文字列表記。  クエリ パスは、<xref:System.Data.Objects.ObjectQuery%601> に対して <xref:System.Data.Objects.ObjectQuery%601.Include%2A> メソッドを呼び出すことによって定義されます。<br /><br /> 詳細については、「[Loading Related Objects](http://msdn.microsoft.com/ja-jp/452347d2-7b3b-44cd-9001-231299a28cb1)」を参照してください。|  
+|オブジェクト コンテキスト|概念モデルで定義したエンティティ コンテナーを表します。  基になるデータ ソースへの接続を含み、変更の追跡や ID 解決などのサービスを提供します。  オブジェクト コンテキストは、<xref:System.Data.Objects.ObjectContext> クラスまたは `DbContext` クラスのインスタンスで表されます。<br /><br /> `DbContext` は [Entity Framework 5.0](http://go.microsoft.com/fwlink/?LinkId=234900) の一部です。  Entity Framework 5.0 は .NET Framework の一部ではありませんが、.NET Framework 4.5 で構成されます。  Entity Framework 5.0 は、[‘Entity Framework’](http://go.microsoft.com/fwlink/?LinkID=215714) [NuGet](http://go.microsoft.com/fwlink/?LinkId=232488) パッケージとして入手できます。  詳細については、「[Entity Framework リリースおよびバージョン指定](http://go.microsoft.com/fwlink/?LinkId=234899)」を参照してください。|  
+|オブジェクト レイヤー|Entity Framework によって使用されるエンティティ型およびオブジェクト コンテキストの定義。|  
+|オブジェクト クエリ|データをオブジェクトとして返す概念モデルに対してオブジェクト コンテキスト内で実行されるクエリ。<br /><br /> 詳細については、「[Object Queries](http://msdn.microsoft.com/ja-jp/0768033c-876f-471d-85d5-264884349276)」を参照してください。|  
+|オブジェクト リレーショナル マッピング|リレーショナル データベースのデータをオブジェクト指向のソフトウェア アプリケーションで使用できるデータ型に変換する手法。<br /><br /> [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、ストレージ モデルで定義されたリレーショナル データを概念モデルで定義されたデータ型にマップして、オブジェクト リレーショナル マッピング サービスを提供します。<br /><br /> 詳細については、「[モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)」を参照してください。|  
+|オブジェクト サービス|アプリケーション コードを [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] オブジェクトなどのエンティティに対して実行できるようにするための、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] が提供するサービス。|  
+|永続化非依存オブジェクト|データ ストレージに関連するロジックが含まれていないオブジェクト。  POCO エンティティとも呼ばれます。|  
+|POCO|Plain Old CLR Object の略。  別のクラスから継承しないオブジェクト、またはインターフェイスを実装しないオブジェクト。|  
+|POCO エンティティ|[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の、<xref:System.Data.Objects.DataClasses.EntityObject> または <xref:System.Data.Objects.DataClasses.ComplexObject> から継承しないエンティティ、または [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] インターフェイスを実装しないエンティティ。  多くの場合、POCO エンティティは、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] アプリケーションで使用される既存のドメイン オブジェクトです。  このようなエンティティは、永続化非依存性をサポートしています。  詳細については、「[Working with POCO Entities](http://msdn.microsoft.com/ja-jp/5e0fb82a-b6d1-41a1-b37b-c12db61629d3)」を参照してください。|  
+|プロキシ オブジェクト|POCO クラスから派生し、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によって生成されたオブジェクト。変更追跡と遅延読み込みをサポートするために使用されます。  詳細については、「[Requirements for Creating POCO Proxies](http://msdn.microsoft.com/ja-jp/dcdbf982-9b9d-4582-806a-64de4a1c03c8)」を参照してください。|  
+|参照制約|エンティティが他のエンティティと依存関係にあることを示す、概念モデルで定義された制約。  この制約は、依存エンティティのインスタンスが対応する主要エンティティのインスタンスなしでは存在できないことを意味します。<br /><br /> 詳細については、「[ReferentialConstraint Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/24f96a80-85b5-4f2e-a14c-0e3eb6796fa0)」および「[参照整合性制約](../../../../../docs/framework/data/adonet/referential-integrity-constraint.md)」を参照してください。|  
+|リレーションシップ|エンティティ間の論理的な関係。|  
+|ロール|リレーションシップのセマンティクスを明確にするためにアソシエーションの両方の `End` に付けられた名前。<br /><br /> 詳細については、「[End Element \(CSDL\)](http://msdn.microsoft.com/ja-jp/04f3c141-95bc-424b-989b-1c071b449e7c)」および「[アソシエーション End](../../../../../docs/framework/data/adonet/association-end.md)」を参照してください。|  
+|スカラー プロパティ|ストレージ モデルの単一のフィールドにマップされるエンティティのプロパティ。|  
+|自己追跡エンティティ|スカラー プロパティ、複合プロパティ、およびナビゲーション プロパティの変更を報告できる、テキスト テンプレート変換ツールキット \(T4\) から構築されるエンティティ。|  
+|単純型|概念モデルでプロパティを定義するために使用されるプリミティブ型。<br /><br /> 詳細については、「[Conceptual Model Types \(CSDL\)](http://msdn.microsoft.com/ja-jp/987b995f-e429-4569-9559-b4146744def4)」および「[Entity Data Model: プリミティブ データ型](../../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)」を参照してください。|  
+|分割されたエンティティ|ストレージ モデルの 2 つの別個の型にマップされる 1 つのエンティティ型。<br /><br /> 詳細については、「[How to: Define a Model with a Single Entity Mapped to Two Tables](http://msdn.microsoft.com/ja-jp/01762517-e4ab-439d-99e6-564ab7d6f3ed)」を参照してください。|  
+|ストレージ モデル|リレーショナル データベースなど、サポートされているデータ ソースのデータの論理モデルの定義。  ストレージ モデルは、SSDL で .ssdl ファイルに定義されます。<br /><br /> 詳細については、「[モデリングとマッピング](../../../../../docs/framework/data/adonet/ef/modeling-and-mapping.md)」および「[SSDL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/ssdl-specification.md)」を参照してください。|  
+|.ssdl ファイル|SSDL で表現されたストレージ モデルを含む XML ファイル。|  
+|ストア スキーマ定義言語 \(SSDL\)|一般的にデータベース スキーマに対応するストレージ モデルのエンティティ型、アソシエーション、エンティティ コンテナー、エンティティ セット、およびアソシエーション セットの定義に使用される XML ベースの言語。<br /><br /> 詳細については、「[SSDL 仕様](../../../../../docs/framework/data/adonet/ef/language-reference/ssdl-specification.md)」を参照してください。|  
+|table\-per\-hierarchy|あらゆる型の属性を 1 つのテーブル内の階層構造に含める、データベースにおける型階層のモデリング手法。|  
+|table\-per\-type|一対一リレーションシップを持った複数のテーブルを使用して各種の型をモデリングする、データベースにおける型階層のモデリング手法。|  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)   
+ [エンティティ フレームワークの概要](../../../../../docs/framework/data/adonet/ef/overview.md)   
+ [はじめに](../../../../../docs/framework/data/adonet/ef/getting-started.md)   
+ [Entity Framework のリソース](../../../../../docs/framework/data/adonet/ef/resources.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/the-shape-of-the-command-trees.md b/docs/framework/data/adonet/ef/the-shape-of-the-command-trees.md
new file mode 100644
index 00000000000..22d9bc66dbc
--- /dev/null
+++ b/docs/framework/data/adonet/ef/the-shape-of-the-command-trees.md
@@ -0,0 +1,116 @@
+---
+title: "コマンド ツリーの構造 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2215585e-ca47-45f8-98d4-8cb982f8c1d3
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# コマンド ツリーの構造
+SQL 生成モジュールは、指定された入力クエリ コマンド ツリー式に基づいてバックエンドに固有の SQL クエリを生成します。  ここでは、クエリ コマンド ツリーの特性、プロパティ、および構造について説明します。  
+  
+## クエリ コマンド ツリーの概要  
+ クエリ コマンド ツリーは、クエリのオブジェクト モデル表現です。  クエリ コマンド ツリーには、次の 2 つの目的があります。  
+  
+-   [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] に対して指定された入力クエリを表現する。  
+  
+-   プロバイダーに対して提供された出力クエリを表現し、バックエンドに対するクエリを記述する。  
+  
+ クエリ コマンド ツリーでは、入れ子のコレクションおよび型操作、エンティティが特定の型であるかどうかのライク チェック、型に基づくセットのフィルター処理のサポートなど、SQL:1999 準拠のクエリよりも高度なセマンティックがサポートされます。  
+  
+ DBQueryCommandTree.Query プロパティは、クエリのロジックを記述する式ツリーのルートです。  DBQueryCommandTree.Parameters プロパティには、クエリで使用されるパラメーターのリストが格納されます。  式ツリーは、DbExpression オブジェクトから構成されます。  
+  
+ DbExpression オブジェクトは、計算を表します。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、定数、変数、関数、コンストラクター、およびフィルターや結合のような標準の関係演算子など、クエリ式を構成するための式がいくつか用意されています。  すべての DbExpression オブジェクトには、その式によって生成される結果の型を表す ResultType プロパティがあります。  この型は、TypeUsage として表されます。  
+  
+## 出力クエリ コマンド ツリーの構造  
+ 出力クエリ コマンド ツリーは、リレーショナル \(SQL\) クエリを詳細に表しており、クエリ コマンド ツリーに適用される規則よりもはるかに厳密な規則に従います。  通常、出力クエリ コマンド ツリーの構造は、SQL に簡単に変換することができます。  
+  
+ 入力コマンド ツリーは、ナビゲーション プロパティ、エンティティ間のアソシエーション、および継承をサポートする概念モデルに対して表現されます。  出力コマンド ツリーは、ストレージ モデルに対して表現されます。  入力コマンド ツリーでは入れ子になったコレクションを射影することができますが、出力コマンド ツリーではこれはできません。  
+  
+ 出力クエリ コマンド ツリーは、利用可能な DbExpression オブジェクトのサブセットを使用して作成されます。また、そのサブセットに含まれる一部の式も、使用法が制限されています。  
+  
+ 型の操作、特定の式が特定の型であるかどうかのライク チェック、または型に基づくセットのフィルター処理は、出力コマンド ツリーにはありません。  
+  
+ 出力コマンド ツリーでは、ブール値を返す式だけが、射影のために使用されます。また、フィルターや case ステートメントのように述語を必要とする式内の述語のみを対象として使用されます。  
+  
+ 出力クエリ コマンド ツリーのルートは、DbProjectExpression オブジェクトです。  
+  
+### 出力クエリ コマンド ツリーに存在しない式の型  
+ 次の式の型は出力クエリ コマンド ツリー内では無効であり、プロバイダーによって処理する必要はありません。  
+  
+ DbDerefExpression  
+  
+ DbEntityRefExpression  
+  
+ DbRefKeyExpression  
+  
+ DbIsOfExpression  
+  
+ DbOfTypeExpression  
+  
+ DbRefExpression  
+  
+ DbRelationshipNavigationExpression  
+  
+ DbTreatExpression  
+  
+### 式の制限および注意事項  
+ 式を出力クエリ コマンド ツリー内で使用する場合、多くの式は、その使用方法が制限を受けます。  
+  
+#### DbFunctionExpression  
+ 次の種類の関数を渡すことができます。  
+  
+-   Edm 名前空間で認識される正規関数  
+  
+-   BuiltInAttribute で認識される組み込み関数 \(ストア関数\)  
+  
+-   ユーザー定義関数  
+  
+ 正規関数は [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] の一部として指定されています \(詳細については、「[正規関数](../../../../../docs/framework/data/adonet/ef/language-reference/canonical-functions.md)」を参照\)。プロバイダーは、これらの指定に基づいて、正規関数の実装を提供する必要があります。  ストア関数は、対応するプロバイダー マニフェスト内の仕様に基づいています。  ユーザー定義の関数は、SSDL 内の仕様に基づいています。  
+  
+ また、NiladicFunction 属性を持つ関数は引数を持たないため、末尾のかっこを省略して変換する必要があります。  つまり、*\<functionName\>\(\)* ではなく *\<functionName\>* のようにします。  
+  
+#### DbNewInstanceExpression  
+ DbNewInstanceExpression は、次の 2 つのケースでのみ使用できます。  
+  
+-   DbProjectExpression の Projection プロパティとして使用する場合。  使用時には、次の制限が適用されます。  
+  
+    -   結果型は行型である必要があります。  
+  
+    -   それぞれの引数は、プリミティブ型の結果を生成する式です。  通常、それぞれの引数は、スカラー式 \(たとえば、DbVariableReferenceExpression に対する PropertyExpression\)、関数呼び出し、または DbVariableReferenceExpression に対する DbPropertyExpression や関数呼び出しの算術演算です。  ただし、スカラー サブクエリを表す式は、DbNewInstanceExpression の引数リスト内にも使用できます。  スカラー サブクエリを表す式は、DbElementExperession オブジェクト ルートを含むプリミティブ型の 1 行および 1 列のみを返すサブクエリを表す式ツリーです。  
+  
+-   戻り値の型がコレクション型の場合。この場合は、引数として提供される式の新しいコレクションを定義します。  
+  
+#### DbVariableReferenceExpression  
+ DbVariableReferenceExpression は、DbPropertyExpression ノードの子である必要があります。  
+  
+#### DbGroupByExpression  
+ DbGroupByExpression の Aggregates プロパティは、DbFunctionAggregate 型の要素のみを持つことができます。  それ以外の集計型はありません。  
+  
+#### DbLimitExpression  
+ Limit プロパティには、DbConstantExpression または DbParameterReferenceExpression のみを設定できます。  また、.NET Framework Version 3.5 では、WithTies プロパティは常に false です。  
+  
+#### DbScanExpression  
+ 出力コマンド ツリー内で使用した場合、DbScanExpression は、EnitySetBase::Target によって表されるテーブル、ビュー、またはストア クエリに対するスキャンを効果的に表します。  
+  
+ ターゲットの "Defining Query" メタデータ プロパティが null 以外の場合、このプロパティはクエリを表します。クエリのクエリ テキストは、ストア スキーマ定義に指定されたプロバイダーの特定の言語 \(またはダイアレクト\) でメタデータ プロパティ内に提供されます。  
+  
+ ターゲットの "Defining Query" メタデータ プロパティが null の場合、ターゲットは、テーブルまたはビューを表します。  スキーマ プレフィックスは、null 以外の場合は "Schema" メタデータ プロパティに含まれています。null の場合は、エンティティ コンテナー名が使用されます。  テーブル名またはビュー名は、"Table" メタデータ プロパティに含まれています \(このプロパティが null 以外の場合\)。このプロパティが null の場合は、エンティティ セット ベースの Name プロパティに含まれています。  
+  
+ これらのプロパティはすべて、ストア スキーマ定義ファイル \(SSDL\) 内の対応する EntitySet の定義に基づいています。  
+  
+### プリミティブ型の使用  
+ プリミティブ型を出力コマンド ツリー内で参照する場合、通常は概念モデルのプリミティブ型で参照します。  ただし、一部の式に対しては、対応するストア プリミティブ型がプロバイダーで必要となります。  このような式の例としては、DbCastExpression があります。また、null を対応する型にキャストする必要がある場合は、DbNullExpression も同様です。  こうした式では、プロバイダーは、プリミティブ型の種類およびファセットに基づいて、プロバイダー型へマッピングする必要があります。  
+  
+## 参照  
+ [SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/walkthrough-sql-generation.md b/docs/framework/data/adonet/ef/walkthrough-sql-generation.md
new file mode 100644
index 00000000000..a392860d89c
--- /dev/null
+++ b/docs/framework/data/adonet/ef/walkthrough-sql-generation.md
@@ -0,0 +1,210 @@
+---
+title: "チュートリアル: SQL 生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16c38aaa-9927-4f3c-ab0f-81636cce57a3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# チュートリアル: SQL 生成
+このトピックでは、[サンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616)で SQL の生成がどのように行われるかについて説明します。  次の Entity SQL クエリでは、サンプル プロバイダーに含まれているモデルを使用します。  
+  
+```  
+SELECT  j1.ProductId, j1.ProductName, j1.CategoryName, j2.ShipCountry, j2.ProductId  
+FROM (  SELECT P.ProductName, P.ProductId, P.Category.CategoryName  
+        FROM NorthwindEntities.Products AS P) as j1  
+INNER JOIN (SELECT OD.ProductId, OD.Order.ShipCountry as ShipCountry  
+            FROM NorthwindEntities.OrderDetails AS OD) as j2  
+            ON j1.ProductId == j2.ProductId   
+```  
+  
+ このクエリでは、プロバイダーに渡される次の出力コマンド ツリーが生成されます。  
+  
+```  
+DbQueryCommandTree  
+|_Parameters  
+|_Query : Collection{Record['C1'=Edm.Int32, 'ProductID'=Edm.Int32, 'ProductName'=Edm.String, 'CategoryName'=Edm.String, 'ShipCountry'=Edm.String, 'ProductID1'=Edm.Int32]}  
+  |_Project  
+    |_Input : 'Join4'  
+    | |_InnerJoin  
+    |   |_Left : 'Join1'  
+    |   | |_LeftOuterJoin  
+    |   |   |_Left : 'Extent1'  
+    |   |   | |_Scan : dbo.Products  
+    |   |   |_Right : 'Extent2'  
+    |   |   | |_Scan : dbo.Categories  
+    |   |   |_JoinCondition  
+    |   |     |_  
+    |   |       |_Var(Extent1).CategoryID  
+    |   |       |_=  
+    |   |       |_Var(Extent2).CategoryID  
+    |   |_Right : 'Join3'  
+    |   | |_LeftOuterJoin  
+    |   |   |_Left : 'Extent3'  
+    |   |   | |_Scan : dbo.OrderDetails  
+    |   |   |_Right : 'Join2'  
+    |   |   | |_LeftOuterJoin  
+    |   |   |   |_Left : 'Extent4'  
+    |   |   |   | |_Scan : dbo.Orders  
+    |   |   |   |_Right : 'Extent5'  
+    |   |   |   | |_Scan : dbo.InternationalOrders  
+    |   |   |   |_JoinCondition  
+    |   |   |     |_  
+    |   |   |       |_Var(Extent4).OrderID  
+    |   |   |       |_=  
+    |   |   |       |_Var(Extent5).OrderID  
+    |   |   |_JoinCondition  
+    |   |     |_  
+    |   |       |_Var(Extent3).OrderID  
+    |   |       |_=  
+    |   |       |_Var(Join2).Extent4.OrderID  
+    |   |_JoinCondition  
+    |     |_  
+    |       |_Var(Join1).Extent1.ProductID  
+    |       |_=  
+    |       |_Var(Join3).Extent3.ProductID  
+    |_Projection  
+      |_NewInstance : Record['C1'=Edm.Int32, 'ProductID'=Edm.Int32, 'ProductName'=Edm.String, 'CategoryName'=Edm.String, 'ShipCountry'=Edm.String, 'ProductID1'=Edm.Int32]  
+        |_Column : 'C1'  
+        | |_1  
+        |_Column : 'ProductID'  
+        | |_Var(Join4).Join1.Extent1.ProductID  
+        |_Column : 'ProductName'  
+        | |_Var(Join4).Join1.Extent1.ProductName  
+        |_Column : 'CategoryName'  
+        | |_Var(Join4).Join1.Extent2.CategoryName  
+        |_Column : 'ShipCountry'  
+        | |_Var(Join4).Join3.Join2.Extent4.ShipCountry  
+        |_Column : 'ProductID1'  
+          |_Var(Join4).Join3.Extent3.ProductID  
+```  
+  
+ このトピックでは、この出力コマンド ツリーを次の SQL ステートメントに変換する方法について説明します。  
+  
+```  
+SELECT   
+1 AS [C1],   
+[Extent1].[ProductID] AS [ProductID],   
+[Extent1].[ProductName] AS [ProductName],   
+[Extent2].[CategoryName] AS [CategoryName],   
+[Join3].[ShipCountry] AS [ShipCountry],   
+[Join3].[ProductID] AS [ProductID1]  
+FROM   [dbo].[Products] AS [Extent1]  
+LEFT OUTER JOIN [dbo].[Categories] AS [Extent2] ON [Extent1].[CategoryID] = [Extent2].[CategoryID]  
+INNER JOIN    
+(SELECT [Extent3].[OrderID] AS [OrderID1], [Extent3].[ProductID] AS [ProductID], [Extent3].[UnitPrice] AS [UnitPrice], [Extent3].[Quantity] AS [Quantity], [Extent3].[Discount] AS [Discount], [Join2].[OrderID2], [Join2].[CustomerID], [Join2].[EmployeeID], [Join2].[OrderDate], [Join2].[RequiredDate], [Join2].[ShippedDate], [Join2].[Freight], [Join2].[ShipName], [Join2].[ShipAddress], [Join2].[ShipCity], [Join2].[ShipRegion], [Join2].[ShipPostalCode], [Join2].[ShipCountry], [Join2].[OrderID3], [Join2].[CustomsDescription], [Join2].[ExciseTax]  
+FROM  [dbo].[OrderDetails] AS [Extent3]  
+LEFT OUTER JOIN    
+      (SELECT [Extent4].[OrderID] AS [OrderID2], [Extent4].[CustomerID] AS [CustomerID], [Extent4].[EmployeeID] AS [EmployeeID], [Extent4].[OrderDate] AS [OrderDate], [Extent4].[RequiredDate] AS [RequiredDate], [Extent4].[ShippedDate] AS [ShippedDate], [Extent4].[Freight] AS [Freight], [Extent4].[ShipName] AS [ShipName], [Extent4].[ShipAddress] AS [ShipAddress], [Extent4].[ShipCity] AS [ShipCity], [Extent4].[ShipRegion] AS [ShipRegion], [Extent4].[ShipPostalCode] AS [ShipPostalCode], [Extent4].[ShipCountry] AS [ShipCountry], [Extent5].[OrderID] AS [OrderID3], [Extent5].[CustomsDescription] AS [CustomsDescription], [Extent5].[ExciseTax] AS [ExciseTax]  
+FROM  [dbo].[Orders] AS [Extent4]  
+LEFT OUTER JOIN [dbo].[InternationalOrders] AS [Extent5] ON [Extent4].[OrderID] = [Extent5].[OrderID]   
+      ) AS [Join2] ON [Extent3].[OrderID] = [Join2].[OrderID2]   
+   ) AS [Join3] ON [Extent1].[ProductID] = [Join3].[ProductID]  
+```  
+  
+## SQL 生成の最初のフェーズ: 式ツリーへのアクセス  
+ 次の図は、ビジターの最初の空の状態を示しています。  このトピック全体では、このチュートリアルの説明に関連するプロパティのみを示しています。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/430180f5-4fb9-4bc3-8589-d566512d9703.gif "430180f5\-4fb9\-4bc3\-8589\-d566512d9703")  
+  
+ Project ノードにアクセスすると、VisitInputExpression がその入力 \(Join4\) に対して呼び出され、VisitJoinExpression メソッドによって Join4 のアクセスがトリガーされます。  これは最上位の結合であるため、IsParentAJoin は false を返し、新しい SqlSelectStatement \(SelectStatement0\) が作成され、SELECT ステートメント スタックにプッシュされます。  また、新しいスコープ \(scope0\) がシンボル テーブルに追加されます。  結合の最初の入力 \(左辺\) にアクセスする前に、'true' が IsParentAJoin スタックにプッシュされます。  Join4 の左辺の入力である Join1 にアクセスする直前に、ビジターの状態は次の図に示すようになります。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/406d4f5f-6166-44ea-8e74-c5001d5d5d79.gif "406d4f5f\-6166\-44ea\-8e74\-c5001d5d5d79")  
+  
+ 結合のビジット メソッドが Join4 に対して呼び出されると、IsParentAJoin は true になるため、現在の SELECT ステートメントである SelectStatement0 が再利用されます。  新しいスコープ \(scope1\) が追加されます。  左辺の子である Extent1 にアクセスする前に、もう 1 度 true が IsParentAJoin スタックにプッシュされます。  
+  
+ Extent1 にアクセスすると、IsParentAJoin が true を返すため、"\[dbo\].\[Products\]" を含む SqlBuilder が返されます。  制御が、Join4 にアクセスしているメソッドに戻されます。  エントリが IsParentAJoin からポップされ、ProcessJoinInputResult が呼び出されます。それによって、Extent1 へのアクセス結果が SelectStatement0 の FROM 句に追加されます。  入力バインディング名 "Extent1" の新しい from シンボルである symbol\_Extent1 が作成され、SelectStatement0 の FromExtents に追加され、さらに "As" と symbol\_Extent1 が FROM 句に追加されます。  新しいエントリが "Extent1" の AllExtentNames に追加され、値が 0 に設定されます。  新しいエントリがシンボル テーブルの現在のスコープに追加され、"Extent1" にそのシンボル symbol\_Extent1 が関連付けられます。  また、symbol\_Extent1 は SqlSelectStatement の AllJoinExtents にも追加されます。  
+  
+ Join1 の右辺の入力にアクセスする前に、"LEFT OUTER JOIN" が SelectStatement0 の FROM 句に追加されます。  右辺の入力はスキャン式であるため、再度 true が IsParentAJoin スタックにプッシュされます。  右辺の入力にアクセスする前の状態は次の図に示すとおりです。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/ca62c31b-7ff6-4836-b209-e16166304fdc.gif "ca62c31b\-7ff6\-4836\-b209\-e16166304fdc")  
+  
+ 右辺の入力は、左辺の入力と同じように処理されます。  右辺の入力にアクセスした後の状態を、次の図に示します。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/cd2afa99-7256-4c63-aaa9-c2d13f18a3d8.gif "cd2afa99\-7256\-4c63\-aaa9\-c2d13f18a3d8")  
+  
+ 次に、"false" が IsParentAJoin スタックにプッシュされ、結合条件である Var\(Extent1\).CategoryID \=\= Var\(Extent2\).CategoryID が処理されます。  Var\(Extenent1\) は、シンボル テーブルの検索後、\<symbol\_Extent1\> に解決されます。  このインスタンスは単純なシンボルに解決されるため、Var\(Extent1\).CategoryID の処理結果として、\<symbol1\>."CategoryID" を含む SqlBuilder が返されます。  同様に比較の右辺が処理され、結合条件へのアクセス結果が SelectStatement1 の FROM 句に追加され、値 "false" が IsParentAJoin スタックからポップされます。  
+  
+ これで Join1 の処理が完了し、スコープがシンボル テーブルからポップされます。  
+  
+ 制御が、Join1 の親である Join4 の処理に戻されます。  子では SELECT ステートメントを再利用したため、Join1 のエクステントは単一の結合シンボル \<joinSymbol\_Join1\> に置き換えられます。  また、新しいエントリがシンボル テーブルに追加され、Join1 と \<joinSymbol\_Join1\> が関連付けられます。  
+  
+ 次に処理するノードは、Join4 の 2 つ目の子である Join3 です。  これは右辺の子であるため、"false" が IsParentAJoin スタックにプッシュされます。  この時点のビジターの状態を次の図に示します。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/1ec61ed3-fcdd-4649-9089-24385be7e423.gif "1ec61ed3\-fcdd\-4649\-9089\-24385be7e423")  
+  
+ Join3 の場合、IsParentAJoin は false を返します。また、新しい SqlSelectStatement \(SelectStatement1\) を開始し、それをスタックにプッシュする必要があります。  処理は前の結合と同じように実行されます。新しいスコープがスタックにプッシュされ、子が処理されます。  左辺の子がエクステント \(Extent3\) で、右辺の子が結合 \(Join2\) です。Join2 では、新しい SqlSelectStatement \(SelectStatement2\) を開始する必要があります。  Join2 の子もエクステントであり、SelectStatement2 に集約されます。  
+  
+ Join2 にアクセスした直後で、その後処理 \(ProcessJoinInputResult\) を実行する前のビジターの状態を次の図に示します。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/7510346f-8b09-4c99-b411-40af239c3c4d.gif "7510346f\-8b09\-4c99\-b411\-40af239c3c4d")  
+  
+ SelectStatement2 は、前の図では型指定されていない状態で示されています。これは、スタックからポップされたが、まだ親によって後処理が実行されていないためです。  親の FROM の部分に追加する必要がありますが、SELECT 句がないため、完全な SQL ステートメントではありません。  そのため、この時点では、既定の列 \(入力によって生成されるすべての列\) が AddDefaultColumns メソッドによって選択リストに追加されます。  AddDefaultColumns では、FromExtents 内のシンボルを反復処理し、スコープ内に取り込まれたすべての列をシンボルごとに追加します。  単純なシンボルの場合は、シンボルの型を参照して、追加するすべてのプロパティを取得します。  また、AllColumnNames ディクショナリに列名を追加します。  完成した SelectStatement2 が SelectStatement1 の FROM 句に追加されます。  
+  
+ 次に、Join2 を表す新しい結合シンボルが作成され、入れ子になっている結合としてマークされ、SelectStatement1 の AllJoinExtents とシンボル テーブルに追加されます。  その後で、Join3 の結合条件である Var\(Extent3\).OrderID \=  Var\(Join2\).Extent4.OrderID を処理する必要があります。  左辺の処理は Join1 の結合条件の場合と同様です。  ただし、右辺 "Var\(Join2\).Extent4.OrderID" の処理は、結合のフラット化が必要なため異なります。  
+  
+ 次の図には、DbPropertyExpression である "Var\(Join2\).Extent4.OrderID" を処理する直前のビジターの状態を示しています。  
+  
+ "Var\(Join2\).Extent4.OrderID" にアクセスする方法について説明します。  最初に、インスタンス プロパティ "Var\(Join2\).Extent4" にアクセスします。これ自体が 1 つの DbPropertyExpression であり、まず、そのインスタンス "Var\(Join2\)" にアクセスします。  シンボル テーブルの最上位のスコープで、"Join2" は \<joinSymbol\_join2\> に解決されます。  "Var\(Join2\).Extent4" を処理する DbPropertyExpression のビジット メソッドでは、そのインスタンスへのアクセス時に結合シンボルが返されたこと、および結合のフラット化が必要なことが検出されます。  
+  
+ 入れ子になっている結合であるため、結合シンボルの NameToExtent ディクショナリの "Extent4" プロパティを検索し、それを \<symbol\_Extent4\> に解決することで、新しい \<SymbolPair \(joinSymbol\_join2\>、\<symbol\_Extent4\>\) を返します。  シンボル ペアは "Var\(Join2\).Extent4.OrderID" のインスタンスの処理から返されるため、"OrderID" プロパティはそのシンボル ペア \(\<symbol\_Extent4\>\) の ColumnPart を基に解決されます。このシンボル ペアには、それが表すエクステントの列のリストが含まれています。  そのため、"Var\(Join2\).Extent4.OrderID" は { \<joinSymbol\_Join2\>, ".", \<symbol\_OrderID\>} に解決されます。  
+  
+ Join4 の結合条件は同じように処理されます。  制御は最上位の Project を処理した VisitInputExpression メソッドに戻されます。  返された SelectStatement0 の FromExtents を確認すると、入力は結合として識別されており、元のエクステントは削除され、結合シンボルのみを含む新しいエクステントに置き換えられています。  また、シンボル テーブルも更新されています。次に、Project の Projection 部分を処理します。  プロパティの解決および結合エクステントのフラット化は前に説明したとおりです。  
+  
+ ![図](../../../../../docs/framework/data/adonet/ef/media/9456d6a9-ea2e-40ae-accc-a10e18e28b81.gif "9456d6a9\-ea2e\-40ae\-accc\-a10e18e28b81")  
+  
+ 最終的に、次の SqlSelectStatement が生成されます。  
+  
+```  
+SELECT:   
+  "1", " AS ", "[C1]",  
+  <symbol_Extent1>, ".", "[ProductID]", " AS ", "[ProductID]",   
+  <symbol_Extent1>, ".", "[ProductName]", " AS ", "[ProductName]",  
+  <symbol_Extent2>, ".", "[CategoryName]", " AS ", "[CategoryName]",  
+  <joinSymbol_Join3>, ".", <symbol_ShipCountry>, " AS ", "[ShipCountry]",   
+  <joinSymbol_Join3>, ".", <symbol_ProductID>, " AS ", "[ProductID1]"  
+FROM: "[dbo].[Products]", " AS ", <symbol_Extent1>,   
+        "LEFT OUTER JOIN ""[dbo].[Categories]", " AS ", <symbol_Extent2>, " ON ", <symbol_Extent1>, ".", "[CategoryID]", " = ", <symbol_Extent2>, ".", "[CategoryID]",   
+        "INNER JOIN ",   
+        " (", SELECT:   
+           <symbol_Extent3>, ".", "[OrderID]", " AS ", <symbol_OrderID>, ",   
+              <symbol_Extent3>, ".", "[ProductID]", " AS ", <symbol_ProductID>, ...,  
+         <joinSymbol_Join2>, ".", <symbol_OrderID_2>, ", ",   
+           <joinSymbol_Join2>, ".", <symbol_CustomerID>, ....,    
+        <joinSymbol_Join2>, ".", <symbol_OrderID_3>,   
+<joinSymbol_Join2>, ".", <symbol_CustomsDescription>,   
+<joinSymbol_Join2>, ".", <symbol_ExciseTax>  
+FROM: "[dbo].[OrderDetails]", " AS ", <symbol_Extent3>,   
+"LEFT OUTER JOIN ",   
+" (", SELECT:   
+<symbol_Extent4>, ".", "[OrderID]", " AS ", <symbol_OrderID_2>,   
+<symbol_Extent4>, ".", "[CustomerID]", " AS ", <symbol_CustomerID>, ...  
+<symbol_Extent5>, ".", "[OrderID]", " AS ", <symbol_OrderID_3>,  
+<symbol_Extent5>, ".", "[CustomsDescription]", " AS ", <symbol_CustomsDescription>,  
+<symbol_Extent5>, ".", "[ExciseTax]", " AS ", <symbol_ExciseTax>  
+FROM: "[dbo].[Orders]", " AS ", <symbol_Extent4>,  
+"LEFT OUTER JOIN ", , "[dbo].[InternationalOrders]", " AS ", <symbol_Extent5>,   
+" ON ", <symbol_Extent4>, ".", "[OrderID]", " = ", , <symbol_Extent5>, ".", "[OrderID]"  
+" )", " AS ", <joinSymbol_Join2>, " ON ", , , <symbol_Extent3>, ".", "[OrderID]", " = ", , <joinSymbol_Join2>, ".", <symbol_OrderID_2>  
+" )", " AS ", <joinSymbol_Join3>, " ON ", , , <symbol_Extent1>, ".", "[ProductID]", " = ", , <joinSymbol_Join3>, ".", <symbol_ProductID>  
+```  
+  
+### SQL 生成の 2 番目のフェーズ: 文字列コマンドの生成  
+ 2 番目のフェーズでは、シンボルの実際の名前を生成します。ここでは、競合を解決する必要がある "OrderID" という名前の列を表すシンボルについてのみ説明します。  これらは SqlSelectStatement で強調表示されます。  図に使用されているサフィックスは、これらが別々のインスタンスであることを強調しているだけで、新しい名前を表しているわけではありません。その理由は、この段階では、シンボルの最終的な名前 \(場合によっては元の名前とは異なる\) がまだ割り当てられていないためです。  
+  
+ 名前を変更する必要があるシンボルとして最初に検出されるのが、\<symbol\_OrderID\> です。  その新しい名前として "OrderID1" が割り当てられます。1 は、"OrderID" に対して最後に使用されたサフィックスとしてマークされ、シンボルは名前を変更する必要がないものとしてマークされます。  次に、最初に使われている \<symbol\_OrderID\_2\> が検出されます。  これは、有効な次のサフィックスを使用するように名前が変更され \("OrderID2"\)、このシンボルも名前を変更する必要がないものとしてマークされます。そのため、次に使用するときに、名前の変更は行われません。  この処理は、\<symbol\_OrderID\_3\> に対しても行われます。  
+  
+ 2 番目のフェーズの最後に、最終的な SQL ステートメントが生成されます。  
+  
+## 参照  
+ [サンプル プロバイダーでの SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation-in-the-sample-provider.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/working-with-data-definition-language.md b/docs/framework/data/adonet/ef/working-with-data-definition-language.md
new file mode 100644
index 00000000000..bbcf1d535d4
--- /dev/null
+++ b/docs/framework/data/adonet/ef/working-with-data-definition-language.md
@@ -0,0 +1,58 @@
+---
+title: "データ定義言語の操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec50083d-44f4-4093-9b23-5eacd601f96e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# データ定義言語の操作
+[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] バージョン 4 以降では、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] でデータ定義言語 \(DDL\) がサポートされています。  これにより、接続文字列、およびストレージ \(SSDL\) モデルのメターデータに基づいて、データベース インスタンスを作成または削除できます。  
+  
+ <xref:System.Data.Objects.ObjectContext> の次のメソッドでは、接続文字列と SSDL の内容を使用して、データベースの作成と削除、データベースが存在するかどうかの確認、生成された DDL スクリプトの表示を実行します。  
+  
+-   <xref:System.Data.Objects.ObjectContext.CreateDatabase%2A>  
+  
+-   <xref:System.Data.Objects.ObjectContext.DeleteDatabase%2A>  
+  
+-   <xref:System.Data.Objects.ObjectContext.DatabaseExists%2A>  
+  
+-   <xref:System.Data.Objects.ObjectContext.CreateDatabaseScript%2A>  
+  
+> [!NOTE]
+>  DDL コマンドを実行するには、十分なアクセス許可が必要です。  
+  
+ 上記に示したメソッドは、ほとんどの作業を基になる ADO.NET データ プロバイダーに委任します。  データベース オブジェクトの生成に使用される名前付け規則が、照会および更新に使用される規則と一致していることは、プロバイダーによって保証されています。  
+  
+ 次の例は、既存のモデルを基にデータベースを生成する方法を示しています。  また、新しいエンティティ オブジェクトはオブジェクト コンテキストに追加され、データベースに保存されます。  
+  
+## 手順  
+  
+#### 既存のモデルに基づいてデータベースを定義するには  
+  
+1.  コンソール アプリケーションを作成します。  
+  
+2.  既存のモデルをアプリケーションに追加します。  
+  
+    1.  `SchoolModel` という名前の空のモデルを追加します。  空のモデルを作成するには、「[How to: Create a New .edmx File](http://msdn.microsoft.com/ja-jp/beb8189e-e51c-4051-839c-9902c224abf2)」を参照してください。  
+  
+     SchoolModel.edmx ファイルがプロジェクトに追加されます。  
+  
+    1.  「[School Model](http://msdn.microsoft.com/ja-jp/859a9587-81ea-4a45-9bc0-f8d330e1adac)」から、School モデルの概念、ストレージ、およびマッピングの内容をコピーします。  
+  
+    2.  SchoolModel.edmx ファイルを開き、`edmx:Runtime` タグ内にその内容を貼り付けます。  
+  
+3.  main 関数に次のコードを追加します。  このコードでは、データベース サーバーへの接続文字列を初期化し、DDL スクリプトを表示して、データベースを作成します。さらに、コンテキストに新しいエンティティを追加して、データベースに変更内容を保存します。  
+  
+     [!code-csharp[DP ObjectServices Concepts#DDL](../../../../../samples/snippets/csharp/VS_Snippets_Data/DP ObjectServices Concepts/CS/Source.cs#ddl)]
+     [!code-vb[DP ObjectServices Concepts#DDL](../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DP ObjectServices Concepts/VB/Source.vb#ddl)]
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/working-with-data-providers.md b/docs/framework/data/adonet/ef/working-with-data-providers.md
new file mode 100644
index 00000000000..c2e119a9845
--- /dev/null
+++ b/docs/framework/data/adonet/ef/working-with-data-providers.md
@@ -0,0 +1,35 @@
+---
+title: "データ プロバイダーの操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: b6ae53f4-34f8-4510-ad98-ff1e46621526
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# データ プロバイダーの操作
+このセクションの各トピックでは、概念モデルに対するクエリを Entity Framework でサポートされるデータ ソースに対するネイティブ クエリに変換するサービスおよびプロバイダーについて説明します。  
+  
+## このセクションの内容  
+ [接続文字列](../../../../../docs/framework/data/adonet/ef/connection-strings.md)  
+  
+ [Entity Framework データ プロバイダー](../../../../../docs/framework/data/adonet/ef/data-providers.md)  
+  
+ [Entity Framework データ プロバイダーの作成](../../../../../docs/framework/data/adonet/ef/writing-an-ef-data-provider.md)  
+  
+## 参照  
+ [Entity SQL 言語](../../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md)   
+ [ADO.NET Entity Framework](../../../../../docs/framework/data/adonet/ef/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/working-with-objects.md b/docs/framework/data/adonet/ef/working-with-objects.md
new file mode 100644
index 00000000000..58646079fe6
--- /dev/null
+++ b/docs/framework/data/adonet/ef/working-with-objects.md
@@ -0,0 +1,26 @@
+---
+title: "オブジェクトの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+ms.assetid: 338d8a55-05cc-46b0-bbb8-1379d77068e9
+caps.latest.revision: 11
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 11
+---
+# オブジェクトの使用
+[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] では、エンティティ型のインスタンスである型指定された共通言語ランタイム \(CLR\) オブジェクトとして表現されたデータに対してクエリ、挿入、更新、削除を実行できます。エンティティ型とは、概念モデルで定義されたエンティティのことです。  概念モデルで定義されたエンティティとリレーションシップが、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] によってデータ ソースにマップされます。  [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] は、データ ソースから返されるデータをオブジェクトとして具体化したり、オブジェクトに対する変更を追跡したりする機能のほか、同時実行性を処理したり、オブジェクトに対する変更をデータ ソース側に反映したり、オブジェクトをコントロールにバインドしたりする機能を備えています。  
+  
+ 最新バージョンの Entity Framework のオブジェクトによる操作の詳細については、「[オブジェクトの操作](http://go.microsoft.com/fwlink/?LinkId=235289)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ef/writing-an-ef-data-provider.md b/docs/framework/data/adonet/ef/writing-an-ef-data-provider.md
new file mode 100644
index 00000000000..4947f890276
--- /dev/null
+++ b/docs/framework/data/adonet/ef/writing-an-ef-data-provider.md
@@ -0,0 +1,52 @@
+---
+title: "Entity Framework データ プロバイダーの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 092e88c4-a301-453a-b5c3-5740c6575a9f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Framework データ プロバイダーの作成
+このセクションでは、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 以外のデータ ソースをサポートする [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] プロバイダーの作成方法について説明します。[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] には、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] をサポートするプロバイダーが含まれています。  
+  
+## Entity Framework プロバイダー モデルの概要  
+ [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] はデータベースに依存しません。ADO.NET プロバイダー モデルを使用して、さまざまなデータ ソースに接続するプロバイダーを作成できます。  
+  
+ ADO.NET データ プロバイダー モデルを使用して構築された Entity Framework データ プロバイダーは、次の機能を実行します。  
+  
+-   Entity Data Model \(EDM\) プリミティブ型をプロバイダー型にマップします。  
+  
+-   プロバイダー固有の関数を公開します。  
+  
+-   指定された DbQueryCommandTree に対してプロバイダー固有のコマンドを生成して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] クエリをサポートします。  
+  
+-   指定された DbModificationCommandTree に対してプロバイダー固有の更新コマンドを生成して、[!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] を介した更新をサポートします。  
+  
+-   ストア スキーマ定義のマッピング ファイルを公開して、データベースに基づくモデルの生成をサポートします。  
+  
+-   概念モデルを使用してメタデータ \(テーブルとビューなど\) を公開します。  
+  
+ ![b42a7a5c&#45;0ac0&#45;4911&#45;86be&#45;0460a78760ba](../../../../../docs/framework/data/adonet/ef/media/b42a7a5c-0ac0-4911-86be-0460a78760ba.gif "b42a7a5c\-0ac0\-4911\-86be\-0460a78760ba")  
+  
+## サンプル  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 以外のデータ ソースをサポートする [!INCLUDE[adonet_ef](../../../../../includes/adonet-ef-md.md)] プロバイダーのサンプルについては、「[エンティティ フレームワークのサンプル プロバイダー](http://go.microsoft.com/fwlink/?LinkId=180616)」を参照してください。  
+  
+## このセクションの内容  
+ [SQL 生成](../../../../../docs/framework/data/adonet/ef/sql-generation.md)  
+  
+ [変更 SQL 生成](../../../../../docs/framework/data/adonet/ef/modification-sql-generation.md)  
+  
+ [プロバイダー マニフェストの仕様](../../../../../docs/framework/data/adonet/ef/provider-manifest-specification.md)  
+  
+## 参照  
+ [データ プロバイダーの操作](../../../../../docs/framework/data/adonet/ef/working-with-data-providers.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-container.md b/docs/framework/data/adonet/entity-container.md
new file mode 100644
index 00000000000..7e34fd4949f
--- /dev/null
+++ b/docs/framework/data/adonet/entity-container.md
@@ -0,0 +1,41 @@
+---
+title: "エンティティ コンテナー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16e80405-2c75-42fc-b0e4-b1df53b1c584
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# エンティティ コンテナー
+*エンティティ コンテナー*は、[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)、[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)、および[関数インポート](../../../../docs/framework/data/adonet/model-declared-function.md)の論理グループです。  
+  
+ 概念モデルで定義するエンティティ コンテナーは、次の条件を満たしている必要があります。  
+  
+-   1 つ以上のエンティティ コンテナーを各概念モデルに定義すること。  
+  
+-   各概念モデル内のエンティティ コンテナー名が一意であること。  
+  
+ エンティティ コンテナーは、1 つ以上の名前空間に定義されたエンティティ型またはアソシエーションを使用するエンティティ セットまたはアソシエーション セットを定義できます。  詳細については、「[Entity Data Model: 名前空間](../../../../docs/framework/data/adonet/entity-data-model-namespaces.md)」を参照してください。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  詳細については、次の例を参照してください。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ ダイアグラムにはエンティティ コンテナー情報が示されていませんが、概念モデルにはエンティティ コンテナーを定義する必要があります。  [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれる DSL を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された概念モデルのエンティティ コンテナーを定義しています。  エンティティ コンテナー名は XML 属性に定義されています。  
+  
+ [!code-xml[EDM_Example_Model#EntityContainerExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entitycontainerexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-data-model-inheritance.md b/docs/framework/data/adonet/entity-data-model-inheritance.md
new file mode 100644
index 00000000000..f3b42002a53
--- /dev/null
+++ b/docs/framework/data/adonet/entity-data-model-inheritance.md
@@ -0,0 +1,37 @@
+---
+title: "Entity Data Model: 継承 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42c7ef24-710a-4af9-8493-cd41c399ecb0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Data Model: 継承
+Entity Data Model \(EDM\) は、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)の継承をサポートしています。  EDM の継承は、オブジェクト指向プログラミング言語におけるクラスの継承に似ています。  オブジェクト指向言語のクラスと同様、概念モデルでは、別のエンティティ型 \(*基本型*\) を継承するエンティティ型 \(*派生型*\) を定義できます。  ただし、オブジェクト指向プログラミングのクラスとは異なり、概念モデルでは、派生型が基本型のすべての[プロパティ](../../../../docs/framework/data/adonet/property.md)と[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)を常に継承します。  派生型の継承プロパティは、オーバーライドできません。  
+  
+ 概念モデルでは、派生型が別の派生型を継承する継承階層を構築することができます。  階層の最上位にある型 \(階層内で派生型ではない唯一の型\) は、*ルート型*と呼ばれます。  継承階層では、ルート型に[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)を定義する必要があります。  
+  
+ 複数の型から派生型を継承する継承階層を構築することはできません。  たとえば、`Book` エンティティ型の概念モデルでは、それぞれ `Book` から継承する派生型、`FictionBook` および `NonFictionBook` を定義することができます。  しかし、`FictionBook` 型と `NonFictionBook` 型の両方から継承する型を定義することはできません。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`FictionBook`、`Publisher`、および `Author` という 4 つのエンティティ型の概念モデルを示しています。  `FictionBook` エンティティ型は、`Book` エンティティ型から継承する派生型です。  `FictionBook` 型は、`ISBN (Key)` プロパティ、`Title` プロパティ、および `Revision` プロパティを継承し、`Genre` と呼ばれる追加プロパティを定義します。  
+  
+ ![継承](../../../../docs/framework/data/adonet/media/inheritanceexample.gif "InheritanceExample")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `Book` 型を継承する `FictionBook` エンティティ型を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#DerivedType](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books5.edmx#derivedtype)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-data-model-key-concepts.md b/docs/framework/data/adonet/entity-data-model-key-concepts.md
new file mode 100644
index 00000000000..b98213a73e9
--- /dev/null
+++ b/docs/framework/data/adonet/entity-data-model-key-concepts.md
@@ -0,0 +1,49 @@
+---
+title: "Entity Data Model キーの概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c635a16d-6674-45aa-9344-dcb7df992bab
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Data Model キーの概念
+Entity Data Model \(EDM\) では、*エンティティ型*、*アソシエーション型*、および*プロパティ*という 3 つの主要概念を使用してデータ構造を記述します。  これらは、EDM の実装においてデータ構造を記述する上で最も重要な概念です。  
+  
+## エンティティ型  
+ [エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)は、Entity Data Model でデータ構造を記述するために不可欠な構成要素です。  概念モデルでは、エンティティ型は、[プロパティ](../../../../docs/framework/data/adonet/property.md)から構成され、ビジネス アプリケーションの顧客や注文のように、トップレベル概念の構造を記述します。  コンピューター プログラムのクラス定義がクラスのインスタンスのテンプレートになるように、エンティティ型はエンティティのテンプレートになります。  エンティティは、特定のオブジェクト \(特定の顧客や注文など\) を表します。  各エンティティに対して、[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)内の[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)を一意にする必要があります。  エンティティ セットは、特定のエンティティ型のインスタンスのコレクションです。  エンティティ セット \(および[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)\) は[エンティティ コンテナー](../../../../docs/framework/data/adonet/entity-container.md)に論理的にグループ化されます。  
+  
+ エンティティ型では継承がサポートされており、1 つのエンティティ型を別のエンティティ型から派生させることができます。  詳細については、「[Entity Data Model: 継承](../../../../docs/framework/data/adonet/entity-data-model-inheritance.md)」を参照してください。  
+  
+## アソシエーション型  
+ [アソシエーション型](../../../../docs/framework/data/adonet/association-type.md) \(アソシエーションとも呼ばれます\) は、Entity Data Model でリレーションシップを記述するために不可欠な構成要素です。  概念モデルでは、アソシエーションが 2 つのエンティティ型 \(Customer や Order など\) の間のリレーションシップを表します。  すべてのアソシエーションには、アソシエーションに含まれるエンティティ型を指定する 2 つの[アソシエーション End](../../../../docs/framework/data/adonet/association-end.md) があります。  各アソシエーション End には、アソシエーションのその End に存在できるエンティティ数を示す[アソシエーション End の多重度](../../../../docs/framework/data/adonet/association-end-multiplicity.md)も指定する必要があります。  アソシエーション End の多重度には、1 \(1\)、ゼロか 1 \(0..1\)、または多数 \(\*\) の値を指定することができます。  アソシエーションの 1 つの End にあるエンティティには、エンティティ型で公開されている場合、[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)または外部キーからアクセスできます。  詳細については、「[外部キーのプロパティ](../../../../docs/framework/data/adonet/foreign-key-property.md)」を参照してください。  
+  
+ アプリケーションでは、アソシエーションのインスタンスが特定のアソシエーション \(Customer のインスタンスと Order のインスタンスの間のアソシエーションなど\) を表します。  アソシエーション インスタンスは、[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)に論理的にグループ化されます。  アソシエーション セット \(および[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)\) は[エンティティ コンテナー](../../../../docs/framework/data/adonet/entity-container.md)に論理的にグループ化されます。  
+  
+## プロパティ  
+ [エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)には、その構造と特性を定義する[プロパティ](../../../../docs/framework/data/adonet/property.md)が含まれます。  たとえば、Customer エンティティ型には、CustomerId、Name、Address などのプロパティがあります。  
+  
+ 概念モデルのプロパティは、コンピューター プログラムのクラスに定義されるプロパティに似ています。  クラスのプロパティがクラスの構造を定義し、オブジェクトに関する情報を伝達するのと同様に、概念モデルのプロパティはエンティティ型の構造を定義し、エンティティ型のインスタンスに関する情報を伝達します。  
+  
+ プロパティには、プリミティブ データ \(文字列、整数、ブール値など\) または構造化データ \(複合型\) を含めることができます。  詳細については、「[Entity Data Model: プリミティブ データ型](../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)」を参照してください。  
+  
+## 概念モデルの表現  
+ *概念モデル*は、一部のデータの構造をエンティティおよびリレーションシップとして表現したものです。  概念モデルを表現する 1 つの手段として、ダイアグラムを使用することができます。  下のダイアグラムは、3 つのエンティティ型 \(`Book`、`Publisher`、および `Author`\) と 2 つのアソシエーション \(`PublishedBy` および `WrittenBy`\) の概念モデルを表しています。  
+  
+ ![ナビゲーション プロパティが含まれるモデル](../../../../docs/framework/data/adonet/media/modelwithnavprops.gif "ModelWithNavProps")  
+  
+ しかし、この表現には、モデルに関する詳細を伝える上でいくつかの欠点があります。  たとえば、プロパティ型とエンティティ セットの情報はダイアグラムに示されていません。  ドメイン固有言語 \(DSL\) を使用すると、概念モデルの詳細情報をさらに明確に伝えることができます。  [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれる XML ベースの DSL を使用して概念モデルを定義します。  以下に、上のダイアグラムに示されている概念モデルの CSDL 定義を示します。  
+  
+ [!code-xml[EDM_Example_Model#EDMExampleCSDL](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#edmexamplecsdl)]  
+  
+## 参照  
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-data-model-namespaces.md b/docs/framework/data/adonet/entity-data-model-namespaces.md
new file mode 100644
index 00000000000..627f2721fe7
--- /dev/null
+++ b/docs/framework/data/adonet/entity-data-model-namespaces.md
@@ -0,0 +1,29 @@
+---
+title: "Entity Data Model: 名前空間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98ab4226-bb9f-44e7-af46-61a9b1a4e47c
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Entity Data Model: 名前空間
+Entity Data Model \(EDM\) の名前空間は、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)、[複合型](../../../../docs/framework/data/adonet/complex-type.md)、および[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の抽象コンテナーです。  EDM の名前空間はプログラミング言語の名前空間と似ており、その中に含まれるオブジェクトのコンテキストを指定し、同じ名前を持つ \(しかし、別の名前空間に含まれる\) オブジェクトを明確に区別する手段になります。  
+  
+## 例  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL コードは、名前空間を使用して異なる概念モデルに定義された型を識別します。  この例は、`ExtendedBooksModel` 名前空間からインポートされた複合型のプロパティ \(`Address`\) を持つエンティティ型 \(`Publisher`\) を定義します。  `Using` 要素は、名前空間がインポートされていることを示します。  さらに、`Address` プロパティの型は、完全修飾名 \(`ExtendedBooksModel.Address`\) で定義されており、この型が `ExtendedBooksModel` 名前空間で定義されていることを示します。  
+  
+ [!code-xml[EDM_Example_Model#ImportedNamespace](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books6.edmx#importednamespace)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-data-model-primitive-data-types.md b/docs/framework/data/adonet/entity-data-model-primitive-data-types.md
new file mode 100644
index 00000000000..9e5f5ff2972
--- /dev/null
+++ b/docs/framework/data/adonet/entity-data-model-primitive-data-types.md
@@ -0,0 +1,50 @@
+---
+title: "Entity Data Model: プリミティブ データ型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7635168e-0566-4fdd-8391-7941b0d9f787
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Entity Data Model: プリミティブ データ型
+Entity Data Model \(EDM\) は、概念モデルで[プロパティ](../../../../docs/framework/data/adonet/property.md)を定義するために使用する一連の抽象プリミティブ データ型 \(String、Boolean、Int32 など\) をサポートしています。  これらのプリミティブ データ型は、SQL Server データベースや共通言語ランタイム \(CLR\) などのストレージ環境またはホスト環境でサポートされる、実際のプリミティブ データ型のプロキシです。  EDM では、プリミティブ データ型に対する演算や変換のセマンティクスを定義していません。これらのセマンティクスは、ストレージ環境またはホスト環境で定義されます。  通常、EDM のプリミティブ データ型は、ストレージ環境またはホスト環境の対応プリミティブ データ型にマップされます。  Entity Framework が EDM のプリミティブ型を SQL Server データ型にマップする方法については、「[Entity Framework 用 SqlClient の型](../../../../docs/framework/data/adonet/ef/sqlclient-for-ef-types.md)」を参照してください。  
+  
+> [!NOTE]
+>  EDM では、プリミティブ データ型のコレクションをサポートしていません。  
+  
+ EDM の構造化データ型の詳細については、「[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)」と「[複合型](../../../../docs/framework/data/adonet/complex-type.md)」を参照してください。  
+  
+## Entity Data Model でサポートされるプリミティブ データ型  
+ 下の表は、EDM でサポートされるプリミティブ データ型の一覧を示します。  さらに、各プリミティブ データ型に使用できる[ファセット](../../../../docs/framework/data/adonet/facet.md)も示しています。  
+  
+|プリミティブ データ型|説明|使用できるファセット|  
+|-----------------|--------|----------------|  
+|2 項|バイナリ データを格納します。|MaxLength、FixedLength、Nullable、Default|  
+|Boolean|`true` または `false` の値を格納します。|Nullable、Default|  
+|Byte|符号なし 8 ビット整数値を格納します。|Precision、Nullable、Default|  
+|DateTime|日時を表します。|Precision、Nullable、Default|  
+|DateTimeOffset|GMT からのオフセット \(分単位\) としての日時を格納します。|Precision、Nullable、Default|  
+|Decimal \(10 進数型\)|有効桁数と小数点以下桁数が固定長の数値を格納します。|Precision、Nullable、Default|  
+|Double \(倍精度浮動小数点型\)|15 桁の有効桁数を持つ浮動小数点数を格納します。|Precision、Nullable、Default|  
+|Float|7 桁の有効桁数を持つ浮動小数点数を格納します。|Precision、Nullable、Default|  
+|Guid|16 バイトの一意識別子を格納します。|Precision、Nullable、Default|  
+|Int16|符号付き 16 ビット整数値を格納します。|Precision、Nullable、Default|  
+|Int32|符号付き 32 ビット整数値を格納します。|Precision、Nullable、Default|  
+|Int64|符号付き 64 ビット整数値を格納します。|Precision、Nullable、Default|  
+|SByte|符号付き 8 ビット整数値を格納します。|Precision、Nullable、Default|  
+|String|文字データを格納します。|Unicode、FixedLength、MaxLength、Collation、Precision、Nullable、Default|  
+|時刻|時刻を格納します。|Precision、Nullable、Default|  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-data-model.md b/docs/framework/data/adonet/entity-data-model.md
new file mode 100644
index 00000000000..aa18127a487
--- /dev/null
+++ b/docs/framework/data/adonet/entity-data-model.md
@@ -0,0 +1,74 @@
+---
+title: "Entity Data Model | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2dda3d5b-4582-4ba0-a91d-fcd7a1498137
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Entity Data Model
+Entity Data Model \(EDM\) は、格納される形式に関係なく、データ構造を記述する一連の概念です。  EDM は、1976 年に Peter Chen により記述されたエンティティ リレーションシップ モデルを取り入れていますが、これを土台にして利用法が拡張されています。  
+  
+ EDM は、データを多くの形式で格納する場合につきまとう問題に対応しています。  たとえば、データをリレーショナル データベース、テキスト ファイル、XML ファイル、スプレッドシート、およびレポートに格納している企業について考えてみます。  この状況は、データ モデリング、アプリケーション設計、データ アクセスに深刻な問題を提示しています。  データ指向のアプリケーションを設計する場合、データ アクセス、ストレージ、およびスケーラビリティの効率性を損なうことなく、効率的で保守性に優れたコードを作成することが問題になります。  データがリレーショナル構造の場合は、データ アクセス、ストレージ、およびスケーラビリティの効率性が非常に高くなるものの、効率的で保守性に優れたコードを書くことが難しくなります。  データがオブジェクト構造の場合は、これが反対になり、効率的で保守性に優れたコードを作成しやすくなる一方で、データ アクセス、ストレージ、およびスケーラビリティの効率性が損なわれます。  これらの要因の間で適切なバランスを取れる場合でも、データを 1 つの形式から別の形式に移動する際に新しい問題が発生します。  Entity Data Model は、ストレージ スキーマに依存しないエンティティとリレーションシップでデータ構造を記述することで、これらの問題に対応しています。  このため、アプリケーションの設計と開発でデータの格納形式が問題になりません。  さらに、エンティティおよびリレーションシップによりアプリケーションで使用されるデータ構造 \(格納形式ではなく\) が記述されるため、アプリケーションの進化に伴ってこれらを進化させることができます。  
+  
+ `conceptual model` は、データ構造をエンティティおよびリレーションシップとして表現したもので、一般的には、EDM の概念を実装するドメイン固有言語 \(DSL\) で記述されます。  [概念スキーマ定義言語 \(CSDL\)](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md) もこのようなドメイン固有言語の 1 つです。  概念モデルで記述されるエンティティおよびリレーションシップは、アプリケーションにおけるオブジェクトとアソシエーションの抽象化と考えることができます。  これにより開発者は、ストレージ スキーマを気にすることなく概念モデルに集中でき、効率的で保守性に優れたコードを書けるようになります。  同時にストレージ スキーマの設計者は、データ アクセス、ストレージ、およびスケーラビリティの効率性に集中できます。  
+  
+## このセクションの内容  
+ このセクションのトピックでは、Entity Data Model の概念について説明します。  EDM を実装する DSL には、ここで解説した概念を含める必要があります。  [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では CSDL を使用して概念モデルを定義します。  詳細については、「[CSDL 仕様](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)」を参照してください。  
+  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)  
+  
+ [Entity Data Model: 名前空間](../../../../docs/framework/data/adonet/entity-data-model-namespaces.md)  
+  
+ [Entity Data Model: プリミティブ データ型](../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)  
+  
+ [Entity Data Model: 継承](../../../../docs/framework/data/adonet/entity-data-model-inheritance.md)  
+  
+ [アソシエーション End](../../../../docs/framework/data/adonet/association-end.md)  
+  
+ [アソシエーション End の多重度](../../../../docs/framework/data/adonet/association-end-multiplicity.md)  
+  
+ [アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)  
+  
+ [アソシエーション セット End](../../../../docs/framework/data/adonet/association-set-end.md)  
+  
+ [アソシエーション型](../../../../docs/framework/data/adonet/association-type.md)  
+  
+ [複合型](../../../../docs/framework/data/adonet/complex-type.md)  
+  
+ [エンティティ コンテナー](../../../../docs/framework/data/adonet/entity-container.md)  
+  
+ [エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)  
+  
+ [エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)  
+  
+ [エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)  
+  
+ [facet](../../../../docs/framework/data/adonet/facet.md)  
+  
+ [外部キーのプロパティ](../../../../docs/framework/data/adonet/foreign-key-property.md)  
+  
+ [モデル宣言関数](../../../../docs/framework/data/adonet/model-declared-function.md)  
+  
+ [モデル定義関数](../../../../docs/framework/data/adonet/model-defined-function.md)  
+  
+ [ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)  
+  
+ [property](../../../../docs/framework/data/adonet/property.md)  
+  
+ [参照整合性制約](../../../../docs/framework/data/adonet/referential-integrity-constraint.md)  
+  
+## 参照  
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)   
+ [.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)   
+ [CSDL 仕様](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-key.md b/docs/framework/data/adonet/entity-key.md
new file mode 100644
index 00000000000..5026f6ad4ae
--- /dev/null
+++ b/docs/framework/data/adonet/entity-key.md
@@ -0,0 +1,51 @@
+---
+title: "エンティティ キー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d447a6d-fa7a-4db0-8e7a-fd45e385fca0
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# エンティティ キー
+*エンティティ キー*とは、ID を確認するために使用する[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)の[プロパティ](../../../../docs/framework/data/adonet/property.md)または一連のプロパティです。  エンティティ キーを構成するプロパティは、デザイン時に選択されます。  エンティティ キー プロパティの値は、実行時に[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)内でエンティティ型のインスタンスを一意に識別する必要があります。  エンティティ キーを構成するプロパティには、エンティティ セット内のインスタンスの一意性を保証するものを選択する必要があります。  
+  
+ エンティティ キーを構成する一連のプロパティには、次の要件があります。  
+  
+-   エンティティ セット内では、2 つ以上のエンティティ キーを同じにすることができません。  つまり、エンティティ セット内の 2 つのエンティティに対して、キーを構成するすべてのプロパティの値を同じにすることができません。  ただし、エンティティ キーを構成する一部 \(すべてではなく\) の値は同じにすることができます。  
+  
+-   エンティティ キーは、null 値が許可されない不変[プリミティブ型のプロパティ](../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)で構成する必要があります。  
+  
+-   エンティティ型のエンティティ キーを構成するプロパティは、変更できません。  エンティティ型に対して複数のエンティティ キーを許可することはできません。代理キーはサポートされていません。  
+  
+-   エンティティが継承階層に含まれる場合、ルート エンティティには、エンティティ キーを構成するすべてのプロパティを含める必要があり、そのエンティティ キーをルート エンティティ型に定義する必要があります。  詳細については、「[Entity Data Model: 継承](../../../../docs/framework/data/adonet/entity-data-model-inheritance.md)」を参照してください。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  各エンティティ型のエンティティ キーを構成するプロパティには、"\(キー\)" と示されています。  `Author` エンティティ型には、`Name` と `Address` の 2 つのプロパティで構成されるエンティティ キーが含まれます。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `Book` エンティティ型を定義します。  エンティティ キーは、エンティティ型の `ISBN` プロパティを参照して定義されています。  
+  
+ [!code-xml[EDM_Example_Model#EntityExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entityexample)]  
+  
+ 国際標準図書番号 \(ISBN\) は書籍を一意に識別するものであるため、`ISBN` プロパティは、エンティティ キーに適しています。  
+  
+ 次の CSDL は、上のダイアグラムに示された `Author` エンティティ型を定義します。  エンティティ キーは、`Name` と `Address` の 2 つのプロパティで構成されています。  
+  
+ [!code-xml[EDM_Example_Model#CompositeKeyExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#compositekeyexample)]  
+  
+ 同じ名前の 2 人の著者が同じ住所に住む可能性は低いため、エンティティ キーに `Name` および `Address` を使用するのは妥当な選択になります。  ただし、エンティティ キーのこの選択では、エンティティ セット内のエンティティ キーの一意性を絶対的に保証することはできません。  この場合には、`AuthorId` などのプロパティを追加して、著者を一意に識別することが推奨されます。  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-set.md b/docs/framework/data/adonet/entity-set.md
new file mode 100644
index 00000000000..37ef3746b52
--- /dev/null
+++ b/docs/framework/data/adonet/entity-set.md
@@ -0,0 +1,56 @@
+---
+title: "エンティティ セット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 59ec6ab0-88e5-4d25-b112-7a4eccbe61f0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# エンティティ セット
+*エンティティ セット*は、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)のインスタンスと、そのエンティティ型から派生するあらゆる型のインスタンスの論理コンテナーです   \(派生型の詳細については、「[Entity Data Model: 継承](../../../../docs/framework/data/adonet/entity-data-model-inheritance.md)」を参照してください\)。エンティティ型とエンティティ セットの関係は、リレーショナル データベースの行とテーブルの関係に似ており、エンティティ型は行のようにデータ構造を表し、エンティティ セットにはテーブルのように構造のインスタンスが格納されます。  エンティティ セットは、データ モデリング構造ではなく、データ構造を表しません。  エンティティ セットは、エンティティ型のインスタンスをグループ化してデータ ストアにマップするための、ホスト環境またはストレージ環境 \(共通言語ランタイムや SQL Server データベースなど\) の構造を提供します。  
+  
+ エンティティ セットは、エンティティ セットと[アソシエーション セット](../../../../docs/framework/data/adonet/association-set.md)の論理グループである[エンティティ コンテナー](../../../../docs/framework/data/adonet/entity-container.md)内に定義します。  
+  
+ エンティティ型のインスタンスがエンティティ セット内に存在できるようにするには、次の条件を満たしている必要があります。  
+  
+-   インスタンスの型がエンティティ セットの基本になるエンティティ型と同じであるか、インスタンスの型がエンティティ型のサブタイプであること。  
+  
+-   インスタンスの[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)がエンティティ セット内で一意であること。  
+  
+-   インスタンスが他のエンティティ セットに存在しないこと。  
+  
+    > [!NOTE]
+    >  同じエンティティ型を使用して複数のエンティティ セットを定義できますが、特定のエンティティ型のインスタンスは、1 つのエンティティ セット内のみに存在できます。  
+  
+ 概念モデルの各エンティティ型にはエンティティ セットを定義する必要がありません。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ 次のダイアグラムには、上の概念モデルに基づく 2 つのエンティティ セット \(`Books` および `Publishers`\) と、アソシエーション セット\(`PublishedBy`\) を示しています。  `Books` エンティティ セット内の Bi は、実行時の `Book` エンティティ型インスタンスを表します。  同様に、Pj は、`Publishers` エンティティ セットの `Publisher` インスタンスを表します。  BiPj は、`PublishedBy` アソシエーション セット内にある `PublishedBy` アソシエーションのインスタンスを表します。  
+  
+ ![例の設定](../../../../docs/framework/data/adonet/media/setsexample.gif "SetsExample")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上の概念モデルに示された各エンティティ型に対して 1 つのエンティティ セットを持つエンティティ コンテナーを定義しています。  各エンティティ セットの名前とエンティティ型は、XML 属性で定義されています。  
+  
+ [!code-xml[EDM_Example_Model#EntityContainerExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entitycontainerexample)]  
+  
+ 型ごとに複数のエンティティ セット \(Multiple\-Entity\-Sets\-per\-Type: MEST\) を定義できます。  次の CSDL は、`Book` エンティティ型のエンティティ セットを 2 つ持つエンティティ コンテナーを定義しています。  
+  
+ [!code-xml[EDM_Example_Model#MESTExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books2.edmx#mestexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/entity-type.md b/docs/framework/data/adonet/entity-type.md
new file mode 100644
index 00000000000..1b14e3edbda
--- /dev/null
+++ b/docs/framework/data/adonet/entity-type.md
@@ -0,0 +1,48 @@
+---
+title: "エンティティ型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6dee9ab-9e4a-48f2-a169-3f79cc15821c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# エンティティ型
+*エンティティ型*は、Entity Data Model \(EDM\) でデータ構造を記述するために不可欠な構成要素です。  概念モデルでのエンティティ型は、顧客や注文のように、トップレベル概念の構造を表します。  エンティティ型は、エンティティ型のインスタンスのテンプレートです。  各テンプレートには、次の情報が含まれています。  
+  
+-   一意の名前   \(必須\)  
+  
+-   1 つ以上のプロパティにより定義される[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)。  \(必須\)  
+  
+-   [プロパティ](../../../../docs/framework/data/adonet/property.md)の形式のデータ。  \(省略可能\)  
+  
+-   [アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の一方の [End](../../../../docs/framework/data/adonet/association-end.md) から別の End へのナビゲーションを可能にする[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)。  \(オプション\)。  
+  
+ アプリケーションでは、エンティティ型のインスタンスが特定のオブジェクト \(特定の顧客や注文など\) を表します。  エンティティ型の各インスタンスに対して、[エンティティ セット](../../../../docs/framework/data/adonet/entity-set.md)内の[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)を一意にする必要があります。  
+  
+ 2 つのエンティティ型のインスタンスは、型が同じであり、エンティティ キーの値が等しい場合にのみ、等価のインスタンスと見なされます。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ 各エンティティ型のエンティティ キーを構成するプロパティには、"\(キー\)" と示されています。  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `Book` エンティティ型を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#EntityExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entityexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)   
+ [ファセット](../../../../docs/framework/data/adonet/facet.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/establishing-the-connection.md b/docs/framework/data/adonet/establishing-the-connection.md
new file mode 100644
index 00000000000..a0f8c984f05
--- /dev/null
+++ b/docs/framework/data/adonet/establishing-the-connection.md
@@ -0,0 +1,156 @@
+---
+title: "接続の確立 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3af512f3-87d9-4005-9e2f-abb1060ff43f
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# 接続の確立
+Microsoft SQL Server に接続する場合は、.NET Framework Data Provider for SQL Server の <xref:System.Data.SqlClient.SqlConnection> オブジェクトを使用します。  OLE DB データ ソースに接続する場合は、.NET Framework Data Provider for OLE DB の <xref:System.Data.OleDb.OleDbConnection> オブジェクトを使用します。  ODBC データ ソースに接続する場合は、.NET Framework Data Provider for ODBC の <xref:System.Data.Odbc.OdbcConnection> オブジェクトを使用します。  Oracle データ ソースに接続する場合は、.NET Framework Data Provider for Oracle の <xref:System.Data.OracleClient.OracleConnection> オブジェクトを使用します。  安全な接続文字列の格納および取得については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 接続の終了  
+ 接続がプールに返されるようにするために、接続を使い終えたら必ず接続を終了することをお勧めします。  Visual Basic または C\# の `Using` ブロックは、コードがこのブロックを終了したときに接続を破棄します。これは、未処理の例外の場合でも実行されます。  詳細については、「[using ステートメント](../Topic/using%20Statement%20\(C%23%20Reference\).md)」および「[Using Statement](../Topic/Using%20Statement%20\(Visual%20Basic\).md)」を参照してください。  
+  
+ また、使用しているプロバイダーの接続オブジェクトの `Close` または `Dispose` メソッドを使用することもできます。  明示的に終了されていない接続は、プールに追加したり返したりすることができないことがあります。  たとえば、スコープ外に出ても、明示的に終了されていない接続は、最大プール サイズに達した時点でその接続がまだ有効である場合にだけ接続プールに返されます。  詳細については、「[OLE DB、ODBC、および Oracle 接続プール](../../../../docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md)」を参照してください。  
+  
+> [!NOTE]
+>  クラスの `Finalize` メソッド内で **Connection**、**DataReader**、またはその他のマネージ オブジェクトの `Close` または `Dispose` を呼び出さないでください。  終了処理では、クラスに直接所有されているアンマネージ リソースだけを解放してください。  クラスがアンマネージ リソースを所有していない場合は、クラス定義に `Finalize` メソッドを含めないでください。  詳細については、「[Garbage Collection](../../../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+> [!NOTE]
+>  接続が接続プールからフェッチされたり接続プールに返されたりしたとき、ログイン イベントとログアウト イベントはサーバーで発生しません。これは、接続プールに返されても接続は実際には終了していないためです。  詳細については、「[SQL Server の接続プール \(ADO.NET\)](../../../../docs/framework/data/adonet/sql-server-connection-pooling.md)」を参照してください。  
+  
+## SQL Server への接続  
+ .NET Framework Data Provider for SQL Server は、OLE DB \(ADO\) 接続文字列フォーマットに似た接続文字列フォーマットをサポートします。  有効な文字列フォーマットの名前および値については、<xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> プロパティを参照してください。  また、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> クラスを使用すると、構文的に正しい接続文字列を実行時に作成できます。  詳細については、「[接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+ SQL Server のデータベースへの接続を開いて確立する方法を次のサンプル コードに示します。  
+  
+```vb  
+' Assumes connectionString is a valid connection string.  
+Using connection As New SqlConnection(connectionString)  
+    connection.Open()  
+    ' Do work here.  
+End Using  
+```  
+  
+```csharp  
+// Assumes connectionString is a valid connection string.  
+using (SqlConnection connection = new SqlConnection(connectionString))  
+{  
+    connection.Open();  
+    // Do work here.  
+}  
+```  
+  
+### 統合セキュリティと ASP.NET  
+ SQL Server 統合セキュリティ \(信頼関係接続とも呼ばれます\) は、SQL Server への接続を保護します。接続文字列でユーザー ID とパスワードを公開することがなく、接続の認証用に推奨されている方法でもあるためです。  統合セキュリティでは、実行中のプロセスの現在のセキュリティ ID またはトークンを使用します。  これは、デスクトップ アプリケーションでは通常、現在ログオンしているユーザーの ID です。  
+  
+ ASP.NET アプリケーションのセキュリティ ID は、他のオプションのうちのいずれかに設定することもできます。  SQL Server に接続するときに ASP.NET アプリケーションが使用するセキュリティ ID の詳細については、「[ASP.NET Impersonation](../Topic/ASP.NET%20Impersonation.md)」、「[ASP.NET Authentication](../Topic/ASP.NET%20Authentication.md)」、および「[How to: Access SQL Server Using Windows Integrated Security](../Topic/How%20to:%20Access%20SQL%20Server%20Using%20Windows%20Integrated%20Security.md)」を参照してください。  
+  
+## OLE DB データ ソースへの接続  
+ .NET Framework Data Provider for OLE DB は、**OleDbConnection** オブジェクトを使用して、OLE DB によって公開されているデータ ソースへの接続を \(SQLOLEDB: OLE DB Provider for SQL Server を通じて\) 提供します。  
+  
+ .NET Framework Data Provider for OLE DB で使用される接続文字列フォーマットは ADO で使用される接続文字列フォーマットと同じですが、次の例外があります。  
+  
+-   **Provider** キーワードは必須です。  
+  
+-   **URL**、**Remote Provider**、および **Remote Server** キーワードはサポートされていません。  
+  
+ OLE DB 接続文字列の詳細については、「<xref:System.Data.OleDb.OleDbConnection.ConnectionString%2A>」を参照してください。  また、<xref:System.Data.OleDb.OleDbConnectionStringBuilder> を使用すると、接続文字列を実行時に作成できます。  
+  
+> [!NOTE]
+>  **OleDbConnection** オブジェクトは、OLE DB プロバイダー固有の動的プロパティの設定または取得をサポートしていません。  OLE DB プロバイダーに接続文字列で渡すことができるプロパティだけがサポートされています。  
+  
+ OLE DB データ ソースへの接続を作成し確立する方法を次のサンプル コードに示します。  
+  
+```vb  
+' Assumes connectionString is a valid connection string.  
+Using connection As New OleDbConnection(connectionString)  
+    connection.Open()  
+    ' Do work here.  
+End Using  
+  
+```  
+  
+```csharp  
+// Assumes connectionString is a valid connection string.  
+using (OleDbConnection connection =   
+  new OleDbConnection(connectionString))  
+{  
+    connection.Open();  
+    // Do work here.  
+}  
+```  
+  
+## Universal Data Link ファイルは使用しない  
+ **OleDbConnection** の接続情報は、UDL \(Universal Data Link\) ファイルを使用して提供できますが、このファイルは使用しないでください。  UDL ファイルは暗号化されないため、接続文字列をテキスト形式で表現してしまいます。  UDL ファイルは、アプリケーションにとって外部ファイルをベースにしたリソースであるため、.NET Framework でセキュリティ保護できません。  
+  
+## ODBC データ ソースへの接続  
+ .NET Framework Data Provider for ODBC は、**OdbcConnection** オブジェクトを通じて、ODBC によって公開されているデータ ソースへの接続を提供します。  
+  
+ .NET Framework Data Provider for ODBC で使用される接続文字列フォーマットは、できるだけ ODBC の接続文字列フォーマットと一致するようにデザインされています。  ODBC データ ソース名 \(DSN\) を指定することもできます。  **OdbcConnection** の詳細については、「[OdbcConnection クラス](frlrfSystemDataOdbcOdbcConnectionClassTopic)」を参照してください。  
+  
+ ODBC データ ソースへの接続を作成し確立する方法を次のサンプル コードに示します。  
+  
+```vb  
+' Assumes connectionString is a valid connection string.  
+Using connection As New OdbcConnection(connectionString)  
+    connection.Open()  
+    ' Do work here.  
+End Using  
+  
+```  
+  
+```csharp  
+// Assumes connectionString is a valid connection string.  
+using (OdbcConnection connection =   
+  new OdbcConnection(connectionString))  
+{  
+    connection.Open();  
+    // Do work here.  
+}  
+```  
+  
+## Oracle データ ソースへの接続  
+ .NET Framework Data Provider for Oracle は、**OracleConnection** オブジェクトを通じて、Oracle データ ソースへの接続を提供します。  
+  
+ .NET Framework Data Provider for Oracle で使用される接続文字列フォーマットは、できるだけ MSDAORA \(OLE DB Provider for Oracle\) の接続文字列フォーマットと一致するようにデザインされています。  **OracleConnection** の詳細については、「[OracleConnection クラス](frlrfSystemDataOracleClientOracleConnectionClassTopic)」を参照してください。  
+  
+ Oracle データ ソースへの接続を作成し確立する方法を次のサンプル コードに示します。  
+  
+```vb  
+' Assumes connectionString is a valid connection string.  
+Using connection As New OracleConnection(connectionString)  
+    connection.Open()  
+    ' Do work here.  
+End Using  
+  
+```  
+  
+```csharp  
+// Assumes connectionString is a valid connection string.  
+using (OracleConnection connection =   
+  new OracleConnection(connectionString))  
+{  
+    connection.Open();  
+    // Do work here.  
+}  
+OracleConnection nwindConn = new OracleConnection("Data Source=MyOracleServer;Integrated Security=yes;");  
+nwindConn.Open();  
+```  
+  
+## 参照  
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)   
+ [OLE DB、ODBC、および Oracle 接続プール](../../../../docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/executing-a-command.md b/docs/framework/data/adonet/executing-a-command.md
new file mode 100644
index 00000000000..558f0bb0416
--- /dev/null
+++ b/docs/framework/data/adonet/executing-a-command.md
@@ -0,0 +1,50 @@
+---
+title: "コマンドの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40494916-c25a-4cb8-8f7c-fcb8d378464e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# コマンドの実行
+.NET Framework に含まれている各 .NET Framework データ プロバイダーは、それぞれ <xref:System.Data.Common.DbCommand> を継承する固有のコマンド オブジェクトを持ちます。  .NET Framework Data Provider for OLE DB には <xref:System.Data.OleDb.OleDbCommand> オブジェクト、.NET Framework Data Provider for SQL Server には <xref:System.Data.SqlClient.SqlCommand> オブジェクト、.NET Framework Data Provider for ODBC には <xref:System.Data.Odbc.OdbcCommand> オブジェクト、.NET Framework Data Provider for Oracle には <xref:System.Data.OracleClient.OracleCommand> があります。  次の表に示したように、各オブジェクトはコマンドを実行するための各種のメソッドを公開しており、コマンドの種類と適切な戻り値に基づいて使い分けることになります。  
+  
+|コマンド|戻り値|  
+|----------|---------|  
+|`ExecuteReader`|`DataReader` オブジェクトを返します。|  
+|`ExecuteScalar`|単一のスカラー値を返します。|  
+|`ExecuteNonQuery`|行を一切返さないコマンドを実行します。|  
+|`ExecuteXMLReader`|<xref:System.Xml.XmlReader> を返します。  `SqlCommand` オブジェクトでのみ使用できます。|  
+  
+ 厳密に型指定された各コマンド オブジェクトは、次の表に示す <xref:System.Data.CommandType> 列挙値をサポートしています。これらの列挙値を使用してコマンド文字列の解釈方法を指定できます。  
+  
+|CommandType|説明|  
+|-----------------|--------|  
+|`Text`|データ ソース側で実行されるステートメントを定義する SQL コマンド。|  
+|`StoredProcedure`|ストアド プロシージャの名前。  呼び出す `Execute` メソッドに関係なく、コマンドの `Parameters` プロパティを使用して入力パラメーターと出力パラメーターにアクセスし、戻り値を取得できます。  `ExecuteReader` を使用した場合は、`DataReader` を閉じるまで戻り値および出力パラメーターにアクセスすることはできません。|  
+|`TableDirect`|テーブルの名前。|  
+  
+## 例  
+ <xref:System.Data.SqlClient.SqlCommand> オブジェクトを作成し、そのプロパティを設定することによってストアド プロシージャを実行するコード サンプルを次に示します。  ストアド プロシージャへの入力パラメーターは、<xref:System.Data.SqlClient.SqlParameter> オブジェクトを使って指定します。  このコマンドを <xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> メソッドで実行し、<xref:System.Data.SqlClient.SqlDataReader> からの出力をコンソール ウィンドウに表示します。  
+  
+ [!code-csharp[DataWorks SqlClient.StoredProcedure#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.StoredProcedure/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.StoredProcedure#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.StoredProcedure/VB/source.vb#1)]  
+  
+### コマンドのトラブルシューティング  
+ .NET Framework Data Provider for SQL Server には、失敗したコマンド実行に関連して断続的に発生する問題を検出できるパフォーマンス カウンターが追加されています。  詳細については、「[ADO.NET でのパフォーマンス カウンター](../../../../docs/framework/data/adonet/performance-counters.md)」を参照してください。  
+  
+## 参照  
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [Working with DataReaders](http://msdn.microsoft.com/ja-jp/126a966a-d08d-4d22-a19f-f432908b2b54)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/facet.md b/docs/framework/data/adonet/facet.md
new file mode 100644
index 00000000000..e35e63e44dc
--- /dev/null
+++ b/docs/framework/data/adonet/facet.md
@@ -0,0 +1,46 @@
+---
+title: "ファセット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 91c4e6aa-3e54-4b6c-a38a-abf27808cc85
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# ファセット
+*ファセット*は、プリミティブ型のプロパティ定義の詳細を追加するために使用します。  [プロパティ](../../../../docs/framework/data/adonet/property.md)定義には、プロパティの型の情報が含まれますが、多くの場合、より詳しい情報が必要になります。  たとえば、概念モデルのエンティティ型に、値を null に設定できない `String` 型のプロパティが含まれる場合があります。  ファセットにより、このレベルの詳細を指定することができます。  
+  
+ 下の表は、EDM でサポートされるファセットについて説明しています。  
+  
+> [!NOTE]
+>  ファセットの正確な値と動作は、EDM の実装を使用するランタイム環境によって決まります。  
+  
+|ファセット|説明|対象|  
+|-----------|--------|--------|  
+|`Collation`|プロパティの値に対して比較と順序付け操作を行うときに使用する照合シーケンス \(または並べ替え順序\) を指定します。|`String`|  
+|`ConcurrencyMode`|プロパティの値をオプティミスティック同時実行制御チェックに使用することを指定します。|すべてのプリミティブ型のプロパティ|  
+|`Default`|インスタンス化で値が指定されない場合のプロパティの既定値を指定します。|すべてのプリミティブ型のプロパティ|  
+|`FixedLength`|プロパティ値の長さを可変とすることができるかどうかを指定します。|`Binary`, `String`|  
+|`MaxLength`|プロパティ値の最大長を指定します。|`Binary`, `String`|  
+|`Nullable`|プロパティに null 値を指定できるかどうかを指定します。|すべてのプリミティブ型のプロパティ|  
+|`Precision`|`Decimal` 型のプロパティには、プロパティ値の桁数を指定します。  `Time` 型、`DateTime` 型、および `DateTimeOffset` 型のプロパティには、プロパティ値の秒の小数点以下の有効桁数を指定します。|`DateTime`, `DateTimeOffset`, `Decimal`, `Time`,|  
+|`Scale`|プロパティ値の小数点の右側の桁数を指定します。|Decimal \(10 進数型\)|  
+|`Unicode`|プロパティ値を Unicode として保存するかどうかを指定します。|`String`|  
+  
+## 例  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は `Book` エンティティ型を定義しています。  ファセットは XML 属性として実装されています。  ファセット値は、プロパティ値を null に設定できないことと、`Revision` プロパティの `Scale` と `Precision` がそれぞれ 29 に設定されることを示します。  
+  
+ [!code-xml[EDM_Example_Model#EntityExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entityexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/factory-model-overview.md b/docs/framework/data/adonet/factory-model-overview.md
new file mode 100644
index 00000000000..fe10bfb0970
--- /dev/null
+++ b/docs/framework/data/adonet/factory-model-overview.md
@@ -0,0 +1,33 @@
+---
+title: "ファクトリ モデルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b5dc81c4-7554-44b9-b513-769bd61e2e7b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ファクトリ モデルの概要
+ADO.NET 2.0 では、<xref:System.Data.Common> 名前空間に新しい基本クラスが導入されました。  基本クラスは抽象的な存在です。つまり、直接インスタンス化することはできません。  新しい基本クラスとしては、<xref:System.Data.Common.DbConnection>、<xref:System.Data.Common.DbCommand>、<xref:System.Data.Common.DbDataAdapter> があり、<xref:System.Data.SqlClient> や <xref:System.Data.OleDb> などの .NET Framework データ プロバイダーによって共有されます。  基本クラスが追加されたことで、新しいインターフェイスを作成しなくても、.NET Framework データ プロバイダーに対して容易に機能を追加できるようになりました。  
+  
+ また、ADO.NET 2.0 で抽象基本クラスが導入されたことにより、開発者は特定のデータ プロバイダーに依存しない汎用的なデータ アクセス コードを記述できるようになりました。  
+  
+## ファクトリ デザイン パターン  
+ 単一の API で複数プロバイダーのデータベースにアクセスできる "ファクトリ" デザイン パターンの使用は、プロバイダーに依存しないコードを作成するプログラミング モデルの基礎となるものです。  このパターンでは、現実世界の工場のように、他のオブジェクトを作成するためだけに特殊なオブジェクトを使用するため、適切なネーミングがなされていると言えます。  ファクトリ デザイン パターンの詳細な説明については、MSDN にある「[ASP.NET 2.0 および ADO.NET 2.0 での汎用的なデータ アクセス コードの記述](http://go.microsoft.com/fwlink/?LinkId=55915)」および「ADO.NET 2.0 基本クラスとファクトリによる汎用的なコーディング」[http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/dnvs05\/html\/vsgenerics.asp](http://msdn.microsoft.com/library/default.asp?url=/library/dnvs05/html/vsgenerics.asp)」を参照してください。  
+  
+ ADO.NET 2.0 以降では、<xref:System.Data.Common.DbProviderFactories> のインスタンスを作成するための `static` \(Visual Basic の場合は `Shared`\) メソッドが <xref:System.Data.Common.DbProviderFactory> クラスに用意されています。  このインスタンスにより、実行時に指定したプロバイダー情報と接続文字列に基づいて、厳密に型指定された適切なオブジェクトが返されます。  
+  
+## 参照  
+ [DbProviderFactory の取得](../../../../docs/framework/data/adonet/obtaining-a-dbproviderfactory.md)   
+ [DbConnection、DbCommand、および DbException](../../../../docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md)   
+ [DbDataAdapter を使用したデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md)   
+ [ADO.NET マネージ プロバイダーおよび DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/filling-a-dataset-using-one-or-more-ref-cursors.md b/docs/framework/data/adonet/filling-a-dataset-using-one-or-more-ref-cursors.md
new file mode 100644
index 00000000000..176586512ae
--- /dev/null
+++ b/docs/framework/data/adonet/filling-a-dataset-using-one-or-more-ref-cursors.md
@@ -0,0 +1,56 @@
+---
+title: "1 つまたは複数の REF CURSOR を使用した DataSet の値の設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99863e79-5b00-467e-a105-4ffa42de3ff7
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 1 つまたは複数の REF CURSOR を使用した DataSet の値の設定
+この Microsoft Visual Basic の例では、2 つの REF CURSOR パラメーターを返し、返された行を <xref:System.Data.DataSet> に入力する、PL\/SQL ストアド プロシージャを実行する方法について説明します。  
+  
+```vb  
+Private Sub Button1_Click(ByVal sender As Object, _  
+  ByVal e As System.EventArgs) Handles Button1.Click  
+  
+  Dim connString As New String(_  
+    "Data Source=Oracle9i;User ID=scott;Password=tiger;")  
+  Dim ds As New DataSet()  
+    Using conn As New OracleConnection(connString)  
+    Dim cmd As New OracleCommand()  
+  
+    cmd.Connection = conn  
+    cmd.CommandText = "CURSPKG.OPEN_TWO_CURSORS"  
+    cmd.CommandType = CommandType.StoredProcedure  
+    cmd.Parameters.Add(New OracleParameter( _  
+      "EMPCURSOR", OracleType.Cursor)).Direction = _  
+      ParameterDirection.Output  
+    cmd.Parameters.Add(New OracleParameter( _  
+      "DEPTCURSOR", OracleType.Cursor)).Direction = _  
+       ParameterDirection.Output  
+  
+    Dim da As New OracleDataAdapter(cmd)  
+    da.TableMappings.Add("Table", "Emp")  
+    da.TableMappings.Add("Table1", "Dept")  
+    da.Fill(ds)  
+  
+    ds.Relations.Add("EmpDept", ds.Tables("Dept").Columns("Deptno"), _  
+      ds.Tables("Emp").Columns("Deptno"), False)  
+  
+    DataGrid1.DataSource = ds.Tables("Dept")  
+  End Using  
+```  
+  
+## 参照  
+ [Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md b/docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md
new file mode 100644
index 00000000000..79b2ead188c
--- /dev/null
+++ b/docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md
@@ -0,0 +1,101 @@
+---
+title: "Filtering with DataView (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5632d74a-ff53-4ea7-9fe7-4a148eeb1c68
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Filtering with DataView (LINQ to DataSet)
+特定の条件に基づいてデータをフィルター処理し、UI コントロールを介してそのデータをクライアントに提供する機能は、データ バインドの重要な特徴です。  <xref:System.Data.DataView> は、データにフィルターを適用し、特定のフィルター条件を満たすデータ行のサブセットを返す方法をいくつか提供します。  文字列ベースのフィルター処理機能に加え、<xref:System.Data.DataView> では、フィルター条件として [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 式を使用できます。[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 式を使用すると、文字列ベースのフィルター処理よりもはるかに複雑で強力なフィルター処理を実現できます。  
+  
+ <xref:System.Data.DataView> を使用してデータをフィルター処理する方法は 2 つあります。  
+  
+-   Where 句を含む [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから <xref:System.Data.DataView> を作成します。  
+  
+-   <xref:System.Data.DataView> の既存の文字列ベースのフィルター機能を使用します。  
+  
+## フィルター情報を含むクエリによる DataView の作成  
+ <xref:System.Data.DataView> オブジェクトは [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成できます。  このクエリに `Where` 句が含まれている場合、<xref:System.Data.DataView> はクエリのフィルター情報を使用して作成されます。  `Where` 句内の式は、<xref:System.Data.DataView> に含めるデータ行の決定に使用され、これがフィルターの基礎となります。  
+  
+ 式ベースのフィルターは、文字列ベースのフィルターよりもはるかに強力で複雑なフィルター機能を提供します。  文字列ベースのフィルターと式ベースのフィルターは、相互に排他的です。  <xref:System.Data.DataView> をクエリから作成した後に文字列ベースの <xref:System.Data.DataView.RowFilter%2A> を設定した場合、クエリから推論される式ベースのフィルターはクリアされます。  
+  
+> [!NOTE]
+>  ほとんどの場合、フィルターに使用する式は、副作用のない確定的な式である必要があります。  また、フィルター処理は任意の回数実行されるため、特定の実行回数に依存するロジックが式に含まれないようにしてください。  
+  
+### 例  
+ 次の例では、SalesOrderDetail テーブルに対して数量が 3 個以上 5 個以下の注文を取得するクエリを実行し、このクエリから <xref:System.Data.DataView> を作成します。次に、<xref:System.Data.DataView> を <xref:System.Windows.Forms.BindingSource> にバインドします。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryWhere](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromquerywhere)]
+ [!code-vb[DP DataView Samples#LDVFromQueryWhere](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromquerywhere)]  
+  
+### 例  
+ 次の例では、2001 年 6 月 6 日以降に受けた注文に対するクエリから <xref:System.Data.DataView> を作成します。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryWhere3](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromquerywhere3)]
+ [!code-vb[DP DataView Samples#LDVFromQueryWhere3](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromquerywhere3)]  
+  
+### 例  
+ フィルターは並べ替えと組み合わせることもできます。  次の例では、姓が "S" で始まる連絡先を姓、名の順に並べ替えるクエリから <xref:System.Data.DataView> を作成します。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryWhereOrderByThenBy](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromquerywhereorderbythenby)]
+ [!code-vb[DP DataView Samples#LDVFromQueryWhereOrderByThenBy](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromquerywhereorderbythenby)]  
+  
+### 例  
+ 次の例では、SoundEx アルゴリズムを使用して、"Zhu" に類似する姓を持つ連絡先を検索します。  SoundEx アルゴリズムは、SoundEx メソッドに実装されています。  
+  
+ [!code-csharp[DP DataView Samples#LDVSoundExFilter](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvsoundexfilter)]
+ [!code-vb[DP DataView Samples#LDVSoundExFilter](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvsoundexfilter)]  
+  
+ SoundEx は、米国国勢調査局 \(U.S. Census Bureau\) で最初に開発された、名前を英語の発音でインデックス化する音声アルゴリズム  国勢調査局から無償で入手できます。  SoundEx メソッドは、1 つの名前に対して、1 つの英字とそれに続く 3 つの数字から構成される 4 文字のコードを返します。  文字は名前の最初の文字であり、数字は名前に含まれる残りの子音をコード化したものです。  発音が近い名前には、同じ SoundEx コードが与えられます。  前の例の SoundEx メソッドに使用されている SoundEx 実装を次に示します。  
+  
+ [!code-csharp[DP DataView Samples#SoundEx](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#soundex)]
+ [!code-vb[DP DataView Samples#SoundEx](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#soundex)]  
+  
+## RowFilter プロパティの使用  
+ <xref:System.Data.DataView> の既存の文字列ベースのフィルター機能は [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のコンテキストで動作します。  文字列ベースの <xref:System.Data.DataView.RowFilter%2A> フィルター処理の詳細については「[データの並べ替えとフィルター処理](../../../../docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md)」を参照してください。  
+  
+ 次の例では、Contact テーブルから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView.RowFilter%2A> プロパティを設定して、連絡先の姓が "Zhu" である行を返します。  
+  
+ [!code-csharp[DP DataView Samples#LDVRowFilter](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvrowfilter)]
+ [!code-vb[DP DataView Samples#LDVRowFilter](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvrowfilter)]  
+  
+ <xref:System.Data.DataView> を <xref:System.Data.DataTable> クエリまたは [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成した後、<xref:System.Data.DataView.RowFilter%2A> プロパティを使用して、列値に基づいた行のサブセットを指定できます。  文字列ベースのフィルターと式ベースのフィルターは、相互に排他的です。  <xref:System.Data.DataView.RowFilter%2A> プロパティを設定すると、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから推論されるフィルター式はクリアされます \(再設定できません\)。  
+  
+ [!code-csharp[DP DataView Samples#LDVFromQueryWhereSetRowFilter](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvfromquerywheresetrowfilter)]
+ [!code-vb[DP DataView Samples#LDVFromQueryWhereSetRowFilter](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvfromquerywheresetrowfilter)]  
+  
+ データ サブセットの動的ビューの作成とは対照的に、データに対する特定のクエリの結果を取得する場合は、<xref:System.Data.DataView.RowFilter%2A> プロパティを設定する代わりに <xref:System.Data.DataView> の <xref:System.Data.DataView.Find%2A> メソッドまたは <xref:System.Data.DataView.FindRows%2A> メソッドを使用します。  <xref:System.Data.DataView.RowFilter%2A> プロパティは、データ連結アプリケーションでの使用に適しています。このアプリケーションでは、連結されたコントロールによってフィルター処理結果が表示されます。  <xref:System.Data.DataView.RowFilter%2A> プロパティを設定すると、データのインデックスが再構築され、アプリケーションのオーバーヘッドが増加してパフォーマンスの低下を招きます。  <xref:System.Data.DataView.Find%2A> メソッドと <xref:System.Data.DataView.FindRows%2A> メソッドでは、現在のインデックスが使用されます。このため、インデックスを再構築する必要はありません。  <xref:System.Data.DataView.Find%2A> または <xref:System.Data.DataView.FindRows%2A> を 1 回だけ呼び出す場合は、既存の <xref:System.Data.DataView> を使用するようにします。  <xref:System.Data.DataView.Find%2A> または <xref:System.Data.DataView.FindRows%2A> を複数回呼び出す場合は、新しい <xref:System.Data.DataView> を作成して検索対象の列のインデックスを再構築した後、<xref:System.Data.DataView.Find%2A> メソッドまたは <xref:System.Data.DataView.FindRows%2A> メソッドを呼び出します。  <xref:System.Data.DataView.Find%2A> メソッドおよび <xref:System.Data.DataView.FindRows%2A> メソッドの詳細については、「[行の検索](../../../../docs/framework/data/adonet/dataset-datatable-dataview/finding-rows.md)」および「[DataView Performance](../../../../docs/framework/data/adonet/dataview-performance.md)」を参照してください。  
+  
+## フィルターのクリア  
+ <xref:System.Data.DataView> のフィルターは、<xref:System.Data.DataView.RowFilter%2A> プロパティを使用すると、フィルタリングが設定された後にクリアできます。  <xref:System.Data.DataView> のフィルターは、2 つの異なる方法でクリアできます。  
+  
+-   <xref:System.Data.DataView.RowFilter%2A> プロパティを `null` に設定します。  
+  
+-   <xref:System.Data.DataView.RowFilter%2A> プロパティを空の文字列に設定します。  
+  
+### 例  
+ 次の例では、クエリから <xref:System.Data.DataView> を作成した後、<xref:System.Data.DataView.RowFilter%2A> プロパティを `null` に設定してフィルターをクリアします。  
+  
+ [!code-csharp[DP DataView Samples#LDVClearRowFilter2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvclearrowfilter2)]
+ [!code-vb[DP DataView Samples#LDVClearRowFilter2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvclearrowfilter2)]  
+  
+### 例  
+ 次の例では、テーブルから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView.RowFilter%2A> プロパティを設定します。その後、<xref:System.Data.DataView.RowFilter%2A> プロパティを空の文字列に設定してフィルターをクリアします。  
+  
+ [!code-csharp[DP DataView Samples#LDVClearRowFilter](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvclearrowfilter)]
+ [!code-vb[DP DataView Samples#LDVClearRowFilter](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvclearrowfilter)]  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)   
+ [Sorting with DataView](../../../../docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/floating-point-numbers.md b/docs/framework/data/adonet/floating-point-numbers.md
new file mode 100644
index 00000000000..fe355daa468
--- /dev/null
+++ b/docs/framework/data/adonet/floating-point-numbers.md
@@ -0,0 +1,30 @@
+---
+title: "浮動小数点数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 73c218c6-1c44-4402-a167-4f6262629a91
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 浮動小数点数
+このトピックでは、開発者が [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] で浮動小数点数を扱う際によく遭遇する問題について説明します。  これらはコンピューターによる浮動小数点数の格納方法に起因する問題であり、<xref:System.Data.SqlClient> や <xref:System.Data.OracleClient> など、特定のプロバイダーに固有の問題ではありません。  
+  
+ 通常、浮動小数点数には正確なバイナリ表現がありません。  その代わり、数値の近似値がコンピューターによって格納されます。  浮動小数点数を表現するために使用されるバイナリ桁数はそのときどきで異なります。  浮動小数点数をある表現から別の表現に変換した場合、その数値の最下位の桁がわずかに変わってしまう場合があります。  一般に、変換が発生するのは型をキャストしたときです。  この差異は、変換を 1 つのデータベース内で行うか、データベースの値を表す型間で行うか、型と型の間で行うかに関係なく生じます。  このような差が生じてしまう関係上、論理的には等しくなるはずの数値でも、最下位の桁の値が異なる場合があります。  数値の有効桁数が、本来の桁数よりも大きくなったり小さくなったりすることもあります。  また、数値を文字列として表した場合に、期待した値が得られない場合もあります。  
+  
+ こうした影響を最小限に抑えるには、使用できる数値型のうち、最も近い型を使用する必要があります。  たとえば、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] を使用している場合、実数型の Transact\-SQL 値を浮動小数点型の値に変換すると、厳密には数値が変わってしまう場合があります。  同様に、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、<xref:System.Single> を <xref:System.Double> に変換すると、予想外の結果になることがあります。  いずれの場合も、最善の方法は、アプリケーションのすべての値に同じ数値型を使用することです。  固定精度の decimal 型を使用したり、あらかじめ浮動小数点数を固定精度の decimal 型にキャストしておく方法もあります。  
+  
+ 等価比較の問題を回避するには、最下位桁の差異を無視できるようにアプリケーションをコーディングすることを検討してください。  たとえば、2 つの数値の等価性を比較するのではなく、一方の数値からもう一方の数値を減算するようにします。  その差が丸め処理の許容範囲内であれば、2 つの数値が等価であるものとして処理できます。  
+  
+## 参照  
+ [浮動小数点数の精度の低下](../Topic/Why%20Floating-Point%20Numbers%20May%20Lose%20Precision.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/foreign-key-property.md b/docs/framework/data/adonet/foreign-key-property.md
new file mode 100644
index 00000000000..aabc8ea0619
--- /dev/null
+++ b/docs/framework/data/adonet/foreign-key-property.md
@@ -0,0 +1,35 @@
+---
+title: "外部キーのプロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23cb6729-544d-4f67-9ee7-44e8a6545587
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 外部キーのプロパティ
+Entity Data Model \(EDM\) における*外部キーのプロパティ*は、別のエンティティ型の[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)を含む[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)のプリミティブ型[のプロパティ](../../../../docs/framework/data/adonet/property.md) \(または一連のプリミティブ型のプロパティ\) です。  
+  
+ 外部キーのプロパティは、リレーショナル データベースの外部キー列に似ています。  リレーショナル データベースで外部キー列を使用してテーブル内の行の間のリレーションシップを作成するのと同様に、概念モデルでは外部キーのプロパティを使用してエンティティ型の間の[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)を設定します。  エンティティ型の 1 つに外部キーのプロパティがある場合に、2 つのエンティティ型の間のアソシエーションを定義するには、[参照整合性制約](../../../../docs/framework/data/adonet/referential-integrity-constraint.md)を使用します。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  `Book` エンティティ型には、`PublisherId` というプロパティがあります。`PublishedBy` アソシエーションに参照整合性制約を定義するときに、このプロパティは `Publisher` エンティティ型のエンティティ キーを参照します。  
+  
+ ![RefConstraintModel](../../../../docs/framework/data/adonet/media/refconstraintmodel.gif "RefConstraintModel")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、外部キーのプロパティ `PublisherId` を使用して、上の概念モデルに示された `PublishedBy` アソシエーションに参照整合性制約を定義します。  
+  
+ [!code-xml[EDM_Example_Model#RefConstraint](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books4.edmx#refconstraint)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/generating-commands-with-commandbuilders.md b/docs/framework/data/adonet/generating-commands-with-commandbuilders.md
new file mode 100644
index 00000000000..a323a7ea5fc
--- /dev/null
+++ b/docs/framework/data/adonet/generating-commands-with-commandbuilders.md
@@ -0,0 +1,119 @@
+---
+title: "CommandBuilder でのコマンドの生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6e3fb8b5-373b-4f9e-ab03-a22693df8e91
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# CommandBuilder でのコマンドの生成
+`SelectCommand` プロパティが実行時に動的に指定される場合、たとえばクエリ ツールを使用してユーザーの記述したクエリ構文を解釈する場合は、適切な `InsertCommand`、`UpdateCommand`、または `DeleteCommand` をデザイン時に指定することはできません。  <xref:System.Data.DataTable> を単一データベース テーブルに割り当てたり、単一データベースから生成する場合は、<xref:System.Data.Common.DbCommandBuilder> オブジェクトを利用して自動的に <xref:System.Data.Common.DbDataAdapter> の `DeleteCommand`、`InsertCommand`、および `UpdateCommand` を生成できます。  
+  
+ コマンドを自動的に生成するための最低限の条件として、`SelectCommand` プロパティを設定する必要があります。  `SelectCommand` プロパティで取得したテーブル スキーマによって、自動的に生成される INSERT、UPDATE、DELETE の各ステートメントの構文が決定されます。  
+  
+ <xref:System.Data.Common.DbCommandBuilder> は、INSERT、UPDATE、DELETE の各コマンドを生成するために `SelectCommand` を実行する必要があります。  その結果、データ ソースへの追加のトリップが必要になるため、パフォーマンスが低下する可能性があります。  最適のパフォーマンスを実現するには、明示的にコマンドを指定し、<xref:System.Data.Common.DbCommandBuilder> を使用しないようにします。  
+  
+ `SelectCommand` は少なくとも 1 つの主キーまたは一意の列を返す必要があります。  どちらも存在しない場合は、`InvalidOperation` 例外が生成され、コマンドは生成されません。  
+  
+ `DataAdapter` との関連付けが行われていて、`DataAdapter` の `InsertCommand`、`UpdateCommand`、`DeleteCommand` の各プロパティが null 参照である場合、<xref:System.Data.Common.DbCommandBuilder> は自動的にこれらのプロパティを生成します。  プロパティに対して既に `Command` が存在する場合は、既存の `Command` が使用されます。  
+  
+ 複数のテーブルを結合して作成したデータベース ビューは、単一データベース テーブルとは見なされません。  この場合は、<xref:System.Data.Common.DbCommandBuilder> を使用してコマンドを自動的に生成できないため、コマンドを明示的に指定する必要があります。  `DataSet` に対する更新を元のデータ ソースに反映させるコマンドを明示的に設定する方法については、「[DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)」を参照してください。  
+  
+ 出力パラメーターを `DataSet` の更新行に割り当てることが必要な場合があります。  一般的なタスクの 1 つは、データ ソースの自動的に生成された ID フィールドまたはタイムスタンプの値を取得することです。  <xref:System.Data.Common.DbCommandBuilder> は、既定では更新行の列に出力パラメーターを割り当てません。  その場合は、コマンドを明示的に指定する必要があります。  自動的に生成された ID フィールドを挿入行の列に割り当てる例については、「[ID 値および Autonumber 値の取得](../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)」を参照してください。  
+  
+## コマンドの自動生成規則  
+ コマンドの自動生成規則を次の表に示します。  
+  
+|コマンド|規則|  
+|----------|--------|  
+|`InsertCommand`|<xref:System.Data.DataRow.RowState%2A> が <xref:System.Data.DataRowState> に設定されているテーブル内のすべての行に対して、データ ソースの行を挿入します。  更新可能なすべての列に対して値を挿入します \(ただし、ID、式、タイムスタンプなどの列は除きます\)。|  
+|`UpdateCommand`|`RowState` が <xref:System.Data.DataRowState> に設定されているテーブル内のすべての行に対して、データ ソースの行を更新します。  ID や式などの更新不可能な列を除く、すべての列の値を更新します。  データ ソースの列の値と該当行の主キー列の値が一致し、さらにデータ ソースのその他の列がその行の元の値と一致する、すべての行を更新します。  詳細については、このトピックで後述する「更新および削除のオプティミスティック同時実行制御」を参照してください。|  
+|`DeleteCommand`|`RowState` が <xref:System.Data.DataRowState> に設定されているテーブル内のすべての行に対して、データ ソースの行を削除します。  列の値とその行の主キー列の値が一致し、さらにデータ ソースのその他の列がその行の元の値と一致する、すべての行を削除します。  詳細については、このトピックで後述する「更新および削除のオプティミスティック同時実行制御」を参照してください。|  
+  
+## 更新および削除のオプティミスティック同時実行制御  
+ UPDATE ステートメントおよび DELETE ステートメントに対するコマンドの自動生成ロジックは、*オプティミスティック同時実行制御*に基づいています。これはつまり、編集時にレコードがロックされず、他のユーザーまたはプロセスがそのレコードをいつでも変更できることを意味します。  レコードは SELECT ステートメントによって返された後、UPDATE ステートメントまたは DELETE ステートメントの実行前に変更されている可能性もあるため、自動的に生成される UPDATE ステートメントまたは DELETE ステートメントには、元のすべての値を含み、データ ソースから削除されていない行だけを更新するように指定した WHERE 句が含まれます。  これにより、新しいデータが上書きされるのを防ぎます。  自動的に生成された更新コマンドが削除済みの行、または <xref:System.Data.DataSet> にある元の値が含まれていない行を更新しようとすると、コマンドはどのレコードにも反映されずに、<xref:System.Data.DBConcurrencyException> がスローされます。  
+  
+ 元の値とは関係なく UPDATE または DELETE を実行する場合は、`DataAdapter` に明示的に `UpdateCommand` を設定し、コマンドの自動生成は行わないでください。  
+  
+## コマンドの自動生成ロジックの制限事項  
+ コマンドの自動生成には次の制限事項が適用されます。  
+  
+### リレーションシップのないテーブルに限定  
+ コマンドの自動生成ロジックでは、データ ソースの他のテーブルへのリレーションシップを考慮せずに、独立したテーブルを対象として INSERT、UPDATE、または DELETE の各ステートメントを生成します。  その結果、`Update` を呼び出してデータベースの外部キー制約に関係する列に対する変更を発行すると、エラーが発生する場合があります。  このような例外を防ぐには、外部キー制約に関係する列の更新には <xref:System.Data.Common.DbCommandBuilder> を使用せず、更新操作を実行するステートメントを明示的に指定します。  
+  
+### テーブル名と列名  
+ 列名またはテーブル名にスペース、ピリオド \(.\)、疑問符 \(?\)、引用符、その他の英数字以外の特殊文字が含まれていると、それらの文字が角かっこで囲まれていても、コマンドの自動生成ロジックはエラーになる場合があります。  プロバイダーによって異なりますが、QuotePrefix パラメーターと QuoteSuffix パラメーターを設定すると、生成ロジックではスペースを処理できる場合があっても、特殊文字をエスケープできません。  *catalog.schema.table* の形式をとる、テーブルの完全修飾名はサポートされています。  
+  
+## CommandBuilder による SQL ステートメントの自動生成  
+ `DataAdapter` に対して SQL ステートメントを自動的に生成するには、まず `DataAdapter` の `SelectCommand` プロパティを設定します。次に、`CommandBuilder` オブジェクトを作成し、`CommandBuilder` で SQL ステートメントを自動的に生成する `DataAdapter` を引数として指定します。  
+  
+```vb  
+' Assumes that connection is a valid SqlConnection object   
+' inside of a Using block.  
+Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM dbo.Customers", connection)  
+Dim builder As SqlCommandBuilder = New SqlCommandBuilder(adapter)  
+builder.QuotePrefix = "["  
+builder.QuoteSuffix = "]"  
+```  
+  
+```csharp  
+// Assumes that connection is a valid SqlConnection object  
+// inside of a using block.  
+SqlDataAdapter adapter = new SqlDataAdapter(  
+  "SELECT * FROM dbo.Customers", connection);  
+SqlCommandBuilder builder = new SqlCommandBuilder(adapter);  
+builder.QuotePrefix = "[";  
+builder.QuoteSuffix = "]";  
+```  
+  
+## SelectCommand の変更  
+ INSERT、UPDATE、または DELETE の各コマンドを自動生成した後に `SelectCommand` の `CommandText` を変更すると、例外が発生することがあります。  変更された `SelectCommand.CommandText` に、INSERT、UPDATE、または DELETE の各コマンドの自動生成時に使用した `SelectCommand.CommandText` と矛盾するスキーマ情報が含まれている場合、後続の `DataAdapter.Update` メソッド呼び出しでアクセスする列は `SelectCommand` によって参照された現在のテーブルには存在しない可能性があり、例外が発生します。  
+  
+ `CommandBuilder` の `RefreshSchema` メソッドを呼び出すことで、自動的にコマンドを生成する `CommandBuilder` が使用するスキーマ情報を更新できます。  
+  
+ どのコマンドが自動的に生成されたかを確認するには、`CommandBuilder` オブジェクトの `GetInsertCommand`、`GetUpdateCommand`、`GetDeleteCommand` の各メソッドを使用して、自動的に生成されたコマンドへの参照を取得し、関連付けられているコマンドの `CommandText` プロパティを確認します。  
+  
+ 自動的に生成された更新コマンドをコンソールに出力するコード サンプルを次に示します。  
+  
+```  
+Console.WriteLine(builder.GetUpdateCommand().CommandText)  
+```  
+  
+ 次の例では、`custDS` データセットに `Customers` テーブルを作成し直します。  **RefreshSchema** メソッドを呼び出し、新しい列情報を使用して、自動的に生成されたコマンドを更新します。  
+  
+```vb  
+' Assumes an open SqlConnection and SqlDataAdapter inside of a Using block.  
+adapter.SelectCommand.CommandText = _  
+  "SELECT CustomerID, ContactName FROM dbo.Customers"  
+builder.RefreshSchema()  
+  
+custDS.Tables.Remove(custDS.Tables("Customers"))  
+adapter.Fill(custDS, "Customers")  
+```  
+  
+```csharp  
+// Assumes an open SqlConnection and SqlDataAdapter inside of a using block.  
+adapter.SelectCommand.CommandText =   
+  "SELECT CustomerID, ContactName FROM dbo.Customers";  
+builder.RefreshSchema();  
+  
+custDS.Tables.Remove(custDS.Tables["Customers"]);  
+adapter.Fill(custDS, "Customers");  
+```  
+  
+## 参照  
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [コマンドの実行](../../../../docs/framework/data/adonet/executing-a-command.md)   
+ [DbConnection、DbCommand、および DbException](../../../../docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md b/docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md
new file mode 100644
index 00000000000..7920781dfac
--- /dev/null
+++ b/docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md
@@ -0,0 +1,37 @@
+---
+title: "Generic Field and SetField Methods (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1883365f-9d6c-4ccb-9187-df309f47706d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Generic Field and SetField Methods (LINQ to DataSet)
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、<xref:System.Data.DataRow> クラスの拡張メソッドとして、列値にアクセスするための <xref:System.Data.DataRowExtensions.Field%2A> メソッドおよび <xref:System.Data.DataRowExtensions.SetField%2A> メソッドが提供されています。これらのメソッドを使用すると、開発者は列値に容易にアクセスでき、特に、Null 値へのアクセスが容易になっています。<xref:System.Data.DataSet> が <xref:System.DBNull.Value> を使って Null 値を表現するのに対し、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] では、[!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] で導入された Null 許容型が使用されます。  <xref:System.Data.DataRow> の既存の列アクセサーを使用する場合、返されたオブジェクトを適切な型にキャストする必要があります。  <xref:System.Data.DataRow> の特定のフィールドが NULL 値を許容している場合、Null 値を明示的にチェックする必要があります。<xref:System.DBNull.Value> を取得して、それを暗黙的に別の型にキャストしようとすると、<xref:System.InvalidCastException> がスローされます。  次の例では、<xref:System.Data.DataRow.IsNull%2A> メソッドを使用して Null 値をチェックしなかった場合、インデクサーが <xref:System.DBNull.Value> を返し、それを <xref:System.String> にキャストしようとすると、例外がスローされます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#WhereIsNull](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#whereisnull)]
+ [!code-vb[DP LINQ to DataSet Examples#WhereIsNull](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#whereisnull)]  
+  
+ <xref:System.Data.DataRowExtensions.Field%2A> は、<xref:System.Data.DataRow> の列値にアクセスするためのメソッドです。<xref:System.Data.DataRowExtensions.SetField%2A> は、<xref:System.Data.DataRow> の列値を設定するためのメソッドです。  <xref:System.Data.DataRowExtensions.Field%2A> メソッドも <xref:System.Data.DataRowExtensions.SetField%2A> メソッドも Null 許容型を扱うことができるため、前出の例のように Null 値を明示的にチェックする必要はありません。  また、どちらのメソッドもジェネリック メソッドであるため、戻り値の型をキャストする必要もありません。  
+  
+ 次の例では、<xref:System.Data.DataRowExtensions.Field%2A> メソッドを使用します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Where3](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#where3)]
+ [!code-vb[DP LINQ to DataSet Examples#Where3](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#where3)]  
+  
+ <xref:System.Data.DataRowExtensions.Field%2A> メソッドおよび <xref:System.Data.DataRowExtensions.SetField%2A> メソッドのジェネリック パラメーター `T` に指定するデータ型は、基になる値の型と一致している必要があります。  それ以外の場合、<xref:System.InvalidCastException> 例外がスローされます。  指定する列の名前も <xref:System.Data.DataSet> 内の列名と一致している必要があります。一致していない場合、<xref:System.ArgumentException> がスローされます。  どちらの場合も、例外は、実行時にデータが列挙されて、クエリが実行されたときにスローされます。  
+  
+ <xref:System.Data.DataRowExtensions.SetField%2A> メソッド自体は、型変換を一切実行しません。  ただし、型変換がまったく発生しないということではありません。  <xref:System.Data.DataRowExtensions.SetField%2A> メソッドは、[!INCLUDE[ado_whidbey_long](../../../../includes/ado-whidbey-long-md.md)] の <xref:System.Data.DataRow> クラスの動作を公開します。  <xref:System.Data.DataRow> オブジェクトによって型変換が実行され、変換後の値が <xref:System.Data.DataRow> オブジェクトに保存される場合もあります。  
+  
+## 参照  
+ <xref:System.Data.DataRowExtensions>
\ No newline at end of file
diff --git a/docs/framework/data/adonet/getschema-and-schema-collections.md b/docs/framework/data/adonet/getschema-and-schema-collections.md
new file mode 100644
index 00000000000..8bff14f4072
--- /dev/null
+++ b/docs/framework/data/adonet/getschema-and-schema-collections.md
@@ -0,0 +1,117 @@
+---
+title: "GetSchema およびスキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7ab93b89-1221-427c-84ad-04803b3c64b4
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# GetSchema およびスキーマ コレクション
+それぞれの .NET Framework マネージ プロバイダーの **Connection** クラスは、**GetSchema** メソッドを実装します。このメソッドは、現在接続されているデータベースに関するスキーマ情報を取得するために使用されます。**GetSchema** メソッドから返されるスキーマ情報は、<xref:System.Data.DataTable> という形式になります。  **GetSchema** メソッドは、返すスキーマ コレクションを指定し、返される情報の量を制限するためのオプション パラメーターを提供する、オーバーロードされたメソッドです。  
+  
+## スキーマ コレクションの指定  
+ **GetSchema** メソッドの最初のオプション パラメーターは、文字列として指定されるコレクションの名前です。  スキーマ コレクションには 2 種類あります。すべてのプロバイダーに共通している一般的なスキーマ コレクションと、各プロバイダーによって固有のスキーマ コレクションです。  
+  
+ .NET Framework マネージ プロバイダーでは、引数を指定しないで、またはスキーマ コレクション名に "MetaDataCollections" を指定して **GetSchema** メソッドを呼び出すことにより、サポートされるスキーマ コレクションの一覧を決定します。  これにより、サポートされるスキーマ コレクションの一覧、それぞれがサポートする制限数、および使用する識別子部分の数と共に、<xref:System.Data.DataTable> が返されます。  
+  
+### スキーマ コレクションの取得例  
+ .NET Framework Data Provider for the SQL Server <xref:System.Data.SqlClient.SqlConnection> クラスの <xref:System.Data.SqlClient.SqlConnection.GetSchema%2A> メソッドを使って、**AdventureWorks** サンプル データベースに含まれるすべてのテーブルに関するスキーマ情報を取得する方法について、いくつかの例を次に示します。  
+  
+ \[Visual Basic\]  
+  
+```  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+   Sub Main()  
+      Dim connectionString As String = GetConnectionString()  
+      Using connection As New SqlConnection(connectionString)  
+         'Connect to the database then retrieve the schema information.  
+         connection.Open()  
+         Dim table As DataTable = connection.GetSchema("Tables")  
+  
+         ' Display the contents of the table.  
+         DisplayData(table)  
+         Console.WriteLine("Press any key to continue.")  
+         Console.ReadKey()  
+      End Using  
+   End Sub  
+  
+   Private Function GetConnectionString() As String  
+      ' To avoid storing the connection string in your code,    
+      ' you can retrieve it from a configuration file.  
+      Return "Data Source=(local);Database=AdventureWorks;" _  
+         & "Integrated Security=true;"  
+   End Function  
+  
+   Private Sub DisplayData(ByVal table As DataTable)  
+      For Each row As DataRow In table.Rows  
+         For Each col As DataColumn In table.Columns  
+            Console.WriteLine("{0} = {1}", col.ColumnName, row(col))  
+         Next  
+         Console.WriteLine("============================")  
+      Next  
+   End Sub  
+End Module  
+```  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+class Program  
+{  
+  static void Main()  
+  {  
+  string connectionString = GetConnectionString();  
+  using (SqlConnection connection = new SqlConnection(connectionString))  
+  {  
+   // Connect to the database then retrieve the schema information.  
+   connection.Open();  
+   DataTable table = connection.GetSchema("Tables");  
+  
+   // Display the contents of the table.  
+   DisplayData(table);  
+   Console.WriteLine("Press any key to continue.");  
+   Console.ReadKey();  
+   }  
+ }  
+  
+  private static string GetConnectionString()  
+  {  
+   // To avoid storing the connection string in your code,  
+   // you can retrieve it from a configuration file.  
+   return "Data Source=(local);Database=AdventureWorks;" +  
+      "Integrated Security=true;";  
+  }  
+  
+  private static void DisplayData(System.Data.DataTable table)  
+  {  
+     foreach (System.Data.DataRow row in table.Rows)  
+     {  
+        foreach (System.Data.DataColumn col in table.Columns)  
+        {  
+           Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);  
+        }  
+     Console.WriteLine("============================");  
+     }  
+  }  
+}  
+```  
+  
+## 参照  
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/getting-started-linq-to-dataset.md b/docs/framework/data/adonet/getting-started-linq-to-dataset.md
new file mode 100644
index 00000000000..343a7013aa9
--- /dev/null
+++ b/docs/framework/data/adonet/getting-started-linq-to-dataset.md
@@ -0,0 +1,45 @@
+---
+title: "Getting Started (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97522119-f6a3-434c-a1ec-17396b74a556
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Getting Started (LINQ to DataSet)
+ここでは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使ったプログラミングに関する概要を説明します。  
+  
+## このセクションの内容  
+ [LINQ to DataSet Overview](../../../../docs/framework/data/adonet/linq-to-dataset-overview.md)  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] の概要について説明します。  
+  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)  
+ <xref:System.Data.DataSet> にデータを読み込む例について説明します。  この例では、<xref:System.Data.Common.DataAdapter> を使用して、データベースからデータを取得します。  
+  
+ [Downloading Sample Databases](../../../../docs/framework/data/adonet/downloading-sample-databases-linq-to-dataset.md)  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] セクションのサンプル全般にわたって使用される AdventureWorks サンプル データベースのダウンロードに関する情報を提供します。  
+  
+ [How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)  
+ Visual Studio での [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] プロジェクトの作成に関する情報を提供します。  
+  
+## 関連項目  
+ <xref:System.Data.DataRowComparer>  
+  
+ <xref:System.Data.DataRowExtensions>  
+  
+ <xref:System.Data.DataTableExtensions>  
+  
+## 参照  
+ [LINQ to ADO.NET](http://msdn.microsoft.com/ja-jp/be3297b9-1b54-4d4c-82a8-add0d79c2006)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)   
+ [Getting Started with LINQ](http://msdn.microsoft.com/ja-jp/6cc9af04-950a-4cc3-83d4-2aeb4abe4de9)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/handling-dataadapter-events.md b/docs/framework/data/adonet/handling-dataadapter-events.md
new file mode 100644
index 00000000000..72a8be6e80b
--- /dev/null
+++ b/docs/framework/data/adonet/handling-dataadapter-events.md
@@ -0,0 +1,198 @@
+---
+title: "DataAdapter のイベント処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11515b25-ee49-4b1d-9294-a142147c1ec5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataAdapter のイベント処理
+ADO.NET <xref:System.Data.Common.DataAdapter> は、データ ソースのデータに対して行われた変更に応答するときに使用できる 3 つのイベントを公開します。  `DataAdapter` のイベントを次の表に示します。  
+  
+|Event|説明|  
+|-----------|--------|  
+|`RowUpdating`|行に対する UPDATE、INSERT、または DELETE の各操作が \(`Update` メソッドの 1 つの呼び出しによって\) 開始しようとしています。|  
+|`RowUpdated`|行に対する UPDATE、INSERT、DELETE の各操作が \(`Update` メソッドの 1 つの呼び出しによって\) 完了しました。|  
+|`FillError`|`Fill` 操作中にエラーが発生しました。|  
+  
+## RowUpdating と RowUpdated  
+ `RowUpdating` は、<xref:System.Data.DataSet> 側で生じた行に対する更新が、データ ソース側で処理される前に発生します。  `RowUpdated` は、`DataSet` 側で生じた行に対する更新が、データ ソース側で処理された後で発生します。  したがって、更新が始まる前に `RowUpdating` を使用して更新の動作を変更することで、更新発生時に行う追加の処理の提供、更新行への参照の保存、現在の更新のキャンセル、後で処理するバッチ処理のための更新スケジュールなどを提供できます。  `RowUpdated` は、更新中に発生するエラーや例外の応答に便利です。  `DataSet` にエラー情報や再試行ロジックなどを追加できます。  
+  
+ `RowUpdating` イベントおよび `RowUpdated` イベントに渡される <xref:System.Data.Common.RowUpdatingEventArgs> 引数および <xref:System.Data.Common.RowUpdatedEventArgs> 引数には、更新を実行するために使用される `Command` オブジェクトを参照する `Command` プロパティ、更新情報を格納する `DataRow` オブジェクトを参照する `Row` プロパティ、どのタイプの更新を実行するかを示す `StatementType` プロパティ、適用可能な場合は `TableMapping`、および、操作の `Status` などがあります。  
+  
+ `Status` プロパティを使用すると、操作中にエラーが発生したかどうかを確認したり、必要に応じて現在の行および結果行に対するアクションを制御したりできます。  イベントが発生すると、`Status` プロパティは `Continue` または `ErrorsOccurred` のいずれかになります。  次の表では、更新の後続のアクションを制御するために `Status` プロパティに設定できる値を示しています。  
+  
+|状態|説明|  
+|--------|--------|  
+|`Continue`|更新操作を続行します。|  
+|`ErrorsOccurred`|更新操作を中止し、例外をスローします。|  
+|`SkipCurrentRow`|現在の行を無視し、更新操作を続行します。|  
+|`SkipAllRemainingRows`|更新操作を中止しますが、例外はスローしません。|  
+  
+ `Status` プロパティを `ErrorsOccurred` に設定すると、例外がスローされます。  `Errors` プロパティを例外として設定することで、どの例外をスローするかを制御できます。  `Status` に他の値を使用すると、例外はスローされません。  
+  
+ `ContinueUpdateOnError` プロパティを使用して更新行に関するエラーを処理することもできます。  `DataAdapter.ContinueUpdateOnError` を `true` に設定すると、行を更新した結果、例外がスローされようとしているときに、例外のテキストをその行の `RowError` 情報の中に格納し、例外をスローせずに処理を続行できます。  これにより、`Update` が完了した時点でエラーに応答できるようになります。これに対して `RowUpdated` イベントを使用すると、エラーが発生した時点でエラーに応答できます。  
+  
+ イベント ハンドラーを追加および削除する方法を次のコード サンプルに示します。  `RowUpdating` イベント ハンドラーは、削除されたすべてのレコードのログをタイムスタンプと共に記録します。  `RowUpdated` イベント ハンドラーは、`DataSet` の行の `RowError` プロパティにエラー情報を追加し、例外をスローせずに処理を続行します \(`ContinueUpdateOnError` \= `true` の場合と同等の動作です\)。  
+  
+```vb  
+' Assumes that connection is a valid SqlConnection object.  
+Dim custAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT CustomerID, CompanyName FROM Customers", connection)  
+  
+' Add handlers.  
+AddHandler custAdapter.RowUpdating, New SqlRowUpdatingEventHandler( _  
+  AddressOf OnRowUpdating)  
+AddHandler custAdapter.RowUpdated, New SqlRowUpdatedEventHandler(  
+  AddressOf OnRowUpdated)  
+  
+' Set DataAdapter command properties, fill DataSet, and modify DataSet.  
+  
+custAdapter.Update(custDS, "Customers")  
+  
+' Remove handlers.  
+RemoveHandler custAdapter.RowUpdating, _  
+  New SqlRowUpdatingEventHandler(AddressOf OnRowUpdating)  
+RemoveHandler custAdapter.RowUpdated, _  
+  New SqlRowUpdatedEventHandler(AddressOf OnRowUpdated)  
+  
+Private Shared Sub OnRowUpdating(sender As Object, _  
+  args As SqlRowUpdatingEventArgs)  
+  If args.StatementType = StatementType.Delete Then  
+    Dim tw As System.IO.TextWriter = _  
+  System.IO.File.AppendText("Deletes.log")  
+    tw.WriteLine( _  
+      "{0}: Customer {1} Deleted.", DateTime.Now, args.Row(_  
+      "CustomerID", DataRowVersion.Original))  
+    tw.Close()  
+  End If  
+End Sub  
+  
+Private Shared Sub OnRowUpdated( _  
+  sender As Object, args As SqlRowUpdatedEventArgs)  
+  If args.Status = UpdateStatus.ErrorsOccurred  
+    args.Status = UpdateStatus.SkipCurrentRow  
+    args.Row.RowError = args.Errors.Message  
+  End If  
+End Sub  
+```  
+  
+```csharp  
+// Assumes that connection is a valid SqlConnection object.  
+SqlDataAdapter custAdapter = new SqlDataAdapter(  
+  "SELECT CustomerID, CompanyName FROM Customers", connection);  
+  
+// Add handlers.  
+custAdapter.RowUpdating += new SqlRowUpdatingEventHandler(OnRowUpdating);  
+custAdapter.RowUpdated += new SqlRowUpdatedEventHandler(OnRowUpdated);  
+  
+// Set DataAdapter command properties, fill DataSet, modify DataSet.  
+  
+custAdapter.Update(custDS, "Customers");  
+  
+// Remove handlers.  
+custAdapter.RowUpdating -= new SqlRowUpdatingEventHandler(OnRowUpdating);  
+custAdapter.RowUpdated -= new SqlRowUpdatedEventHandler(OnRowUpdated);  
+  
+protected static void OnRowUpdating(  
+  object sender, SqlRowUpdatingEventArgs args)  
+{  
+  if (args.StatementType == StatementType.Delete)  
+  {  
+    System.IO.TextWriter tw = System.IO.File.AppendText("Deletes.log");  
+    tw.WriteLine(  
+      "{0}: Customer {1} Deleted.", DateTime.Now,   
+       args.Row["CustomerID", DataRowVersion.Original]);  
+    tw.Close();  
+  }  
+}  
+  
+protected static void OnRowUpdated(  
+  object sender, SqlRowUpdatedEventArgs args)  
+{  
+  if (args.Status == UpdateStatus.ErrorsOccurred)  
+  {  
+    args.Row.RowError = args.Errors.Message;  
+    args.Status = UpdateStatus.SkipCurrentRow;  
+  }  
+}  
+```  
+  
+## FillError  
+ `DataAdapter` は、`Fill` 操作中にエラーが発生すると `FillError` イベントを発行します。  このタイプのエラーは通常、追加する行のデータを .NET Framework 型に変換したときに、有効桁を消失してしまった場合に発生します。  
+  
+ `Fill` 操作中にエラーが発生した場合、現在の行は `DataTable` に追加されません。  `FillError` イベントを使用すると、エラーを解決してその行を追加するか、または除外された行を無視し、`Fill` 操作を続行できます。  
+  
+ `FillError` イベントに渡す `FillErrorEventArgs` には、エラーに応答してエラーを解決できるいくつかのプロパティを含めることができます。  `FillErrorEventArgs` オブジェクトのプロパティを次の表に示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|`Errors`|発生した `Exception`。|  
+|`DataTable`|エラー発生時にデータを格納しようとしていた `DataTable` オブジェクト。|  
+|`Values`|エラー発生時に追加しようとしていた行の値を保持しているオブジェクトの配列。  `Values` 配列の序数参照は、追加しようとしていた行の列の序数参照に対応します。  たとえば、`Values[0]` は、行の第 1 列として追加しようとした値です。|  
+|`Continue`|例外をスローするかどうかを選択できます。  `Continue` プロパティを `false` に設定すると、エラーが発生したときに現在の `Fill` 操作を停止し、例外をスローします。  `Continue` を `true` に設定すると、エラーに関係なく `Fill` 操作を続行します。|  
+  
+ 次のコード例では、`DataAdapter` の `FillError` イベントにイベント ハンドラーを追加しています。  この `FillError` イベント コードの例は、有効桁の消失が発生したかどうかを確認し、例外に応答する機会を与えます。  
+  
+```vb  
+AddHandler adapter.FillError, New FillErrorEventHandler( _  
+  AddressOf FillError)  
+  
+Dim dataSet As DataSet = New DataSet  
+adapter.Fill(dataSet, "ThisTable")  
+  
+Private Shared Sub FillError(sender As Object, _  
+  args As FillErrorEventArgs)  
+  If args.Errors.GetType() Is Type.GetType("System.OverflowException") Then  
+    ' Code to handle precision loss.  
+    ' Add a row to table using the values from the first two columns.  
+    DataRow myRow = args.DataTable.Rows.Add(New Object() _  
+      {args.Values(0), args.Values(1), DBNull.Value})  
+    ' Set the RowError containing the value for the third column.  
+    args.RowError = _  
+      "OverflowException encountered. Value from data source: " & _  
+      args.Values(2)  
+    args.Continue = True  
+  End If  
+End Sub  
+```  
+  
+```csharp  
+adapter.FillError += new FillErrorEventHandler(FillError);  
+  
+DataSet dataSet = new DataSet();  
+adapter.Fill(dataSet, "ThisTable");  
+  
+protected static void FillError(object sender, FillErrorEventArgs args)  
+{  
+  if (args.Errors.GetType() == typeof(System.OverflowException))  
+  {  
+    // Code to handle precision loss.  
+    //Add a row to table using the values from the first two columns.  
+    DataRow myRow = args.DataTable.Rows.Add(new object[]  
+       {args.Values[0], args.Values[1], DBNull.Value});  
+    //Set the RowError containing the value for the third column.  
+    args.RowError =   
+       "OverflowException Encountered. Value from data source: " +  
+       args.Values[2];  
+    args.Continue = true;  
+  }  
+}  
+```  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [DataSet のイベント処理](../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-dataset-events.md)   
+ [DataTable イベントの処理](../../../../docs/framework/data/adonet/dataset-datatable-dataview/handling-datatable-events.md)   
+ [イベント](../../../../docs/standard/events/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/how-to-bind-a-dataview-object-to-a-winforms-datagridview-control.md b/docs/framework/data/adonet/how-to-bind-a-dataview-object-to-a-winforms-datagridview-control.md
new file mode 100644
index 00000000000..9a7ef041f24
--- /dev/null
+++ b/docs/framework/data/adonet/how-to-bind-a-dataview-object-to-a-winforms-datagridview-control.md
@@ -0,0 +1,37 @@
+---
+title: "How to: Bind a DataView Object to a Windows Forms DataGridView Control | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b73d60a-6049-446a-85a7-3e5a68b183e2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Bind a DataView Object to a Windows Forms DataGridView Control
+<xref:System.Windows.Forms.DataGridView> コントロールには、データを表形式で表示するための強力で柔軟な機能が用意されています。  <xref:System.Windows.Forms.DataGridView> コントロールは、標準 Windows フォーム データ バインディング モデルをサポートするため、<xref:System.Data.DataView> およびその他の各種のデータ ソースにバインドします。  ただし、ほとんどの状況では、データ ソースとの対話の詳細を管理する <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドします。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールの詳細については、「[DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)」を参照してください。  
+  
+### DataGridView コントロールを DataView に接続するには  
+  
+1.  データベースからデータを取得する操作の詳細を処理するメソッドを実装します。  次のコード例では、<xref:System.Data.SqlClient.SqlDataAdapter> コンポーネントを初期化する `GetData` メソッドを実装し、これを使用して <xref:System.Data.DataSet> に値を設定します。  `connectionString` 変数は、使用しているデータベースに合った値に設定してください。  AdventureWorks SQL Server サンプル データベースがインストールされているサーバーにアクセスする必要があります。  
+  
+     [!code-csharp[DP DataViewWinForms Sample#LDVSample1GetData](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataViewWinForms Sample/CS/Form1.cs#ldvsample1getdata)]
+     [!code-vb[DP DataViewWinForms Sample#LDVSample1GetData](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataViewWinForms Sample/VB/Form1.vb#ldvsample1getdata)]  
+  
+2.  フォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラーで、<xref:System.Windows.Forms.DataGridView> コントロールを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドし、`GetData` メソッドを呼び出してデータベースからデータを取得します。  <xref:System.Data.DataView> は、Contact <xref:System.Data.DataTable> に対する [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成された後、<xref:System.Windows.Forms.BindingSource> コンポーネントにバインドされます。  
+  
+     [!code-csharp[DP DataViewWinForms Sample#LDVSample1FormLoad](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataViewWinForms Sample/CS/Form1.cs#ldvsample1formload)]
+     [!code-vb[DP DataViewWinForms Sample#LDVSample1FormLoad](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataViewWinForms Sample/VB/Form1.vb#ldvsample1formload)]  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md b/docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md
new file mode 100644
index 00000000000..f62a28df1a1
--- /dev/null
+++ b/docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md
@@ -0,0 +1,61 @@
+---
+title: "How to: Create a LINQ to DataSet Project In Visual Studio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49ba6cb0-cdd2-4571-aeaa-25bf0f40e9b3
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Create a LINQ to DataSet Project In Visual Studio
+別の種類の [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] プロジェクトでは、特定のインポートされる名前空間 \(Visual Basic\) または `using` ディレクティブ \(C\#\) および参照が必要です。  最小要件は、System.Core.dll への参照と、<xref:System.Linq> の `using` ディレクティブです。  既定では、これらは新しい [!INCLUDE[csharp_orcas_long](../../../../includes/csharp-orcas-long-md.md)] プロジェクトを作成した場合に提供されます。  また、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、System.Data.dll および System.Data.DataSetExtensions.dll への参照と、`Imports` \(Visual Basic\) または `using` \(C\#\) ディレクティブも必要です。  
+  
+ 以前のバージョンの Visual Studio のプロジェクトをアップグレードする場合、これらの LINQ 関連の参照を手動で追加する必要がある場合があります。  さらに、.NET Framework バージョン 3.5 をプロジェクトのターゲットとして手動で設定する必要がある場合があります。  
+  
+> [!NOTE]
+>  コマンド プロンプトからビルドする場合、`drive`**:**\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.5 内の LINQ に関連する DLL を手動で参照する必要があります。  
+  
+### .NET Framework 3.5 をターゲットとして設定するには  
+  
+1.  [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)] で、新しい Visual Basic または C\# プロジェクトを作成します。または、Visual Studio 2005 で作成されている Visual Basic または C\# プロジェクトを開き、指示に従って [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] プロジェクトに変換します。  
+  
+2.  C\# プロジェクトの場合は、**\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+    1.  **\[アプリケーション\]** プロパティ ページで、**\[ターゲット フレームワーク\]** ボックスの一覧から \[.NET Framework 3.5\] を選択します。  
+  
+3.  Visual Basic プロジェクトの場合は、**\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+    1.  **\[コンパイル\]** プロパティ ページで、**\[詳細コンパイル オプション\]** をクリックし、**\[ターゲット フレームワーク \(すべての構成\)\]** ボックスの一覧から \[.NET Framework 3.5\] を選択します。  
+  
+4.  **\[プロジェクト\]** メニューの **\[参照の追加\]** をクリックします。**\[.NET\]** タブをクリックし、下方向にスクロールし、**\[System.Core\]** をクリックします。最後に、**\[OK\]** をクリックします。  
+  
+5.  ソース コード ファイルまたはプロジェクトに <xref:System.Linq> の `using` ディレクティブまたはインポートされる名前空間を追加します。  
+  
+     詳細については、「[using ディレクティブ](../Topic/using%20Directive%20\(C%23%20Reference\).md)」または「[方法 : インポートした名前空間を追加または削除する \(Visual Basic\)](../Topic/How%20to:%20Add%20or%20Remove%20Imported%20Namespaces%20\(Visual%20Basic\).md)」を参照してください。  
+  
+### LINQ to DataSet 機能を有効にするには  
+  
+1.  必要に応じて、このトピックの前の方で説明した手順に従って、System.Core.dll への参照および System.Linq の `using` ディレクティブまたはインポートされる名前空間を追加します。  
+  
+2.  C\# または Visual Basic で、**\[プロジェクト\]** メニューの **\[参照の追加\]** をクリックします。  
+  
+3.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** タブが前面にない場合はこれをクリックします。  下方向にスクロールし、**\[System.Data\]** と **\[System.Data.DataSetExtensions\]** をクリックします。  **\[OK\]** をクリックします。  
+  
+4.  ソース コード ファイルまたはプロジェクトに <xref:System.Data> の `using` ディレクティブまたはインポートされる名前空間を追加します。  詳細については、「[using ディレクティブ](../Topic/using%20Directive%20\(C%23%20Reference\).md)」または「[方法 : インポートした名前空間を追加または削除する \(Visual Basic\)](../Topic/How%20to:%20Add%20or%20Remove%20Imported%20Namespaces%20\(Visual%20Basic\).md)」を参照してください。  
+  
+5.  LINQ to Dataset 機能を使用するために、System.Data.DataSetExtensions.dll への参照を追加します。  System.Data.dll への参照が追加されていない場合はこれを追加します。  
+  
+6.  オプションで、データベースにどのように接続するかに合わせて、`System.Data.Common` または `System.Data.SqlClient` の `using` ディレクティブまたはインポートされる名前空間を追加します。  
+  
+## 参照  
+ [Getting Started](../../../../docs/framework/data/adonet/getting-started-linq-to-dataset.md)   
+ [Getting Started with LINQ](http://msdn.microsoft.com/ja-jp/6cc9af04-950a-4cc3-83d4-2aeb4abe4de9)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md b/docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md
new file mode 100644
index 00000000000..58b19e1c01a
--- /dev/null
+++ b/docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md
@@ -0,0 +1,76 @@
+---
+title: "How to: Implement CopyToDataTable&lt;T&gt; Where the Generic Type T Is Not a DataRow | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b27b52cf-6172-485f-a75c-70ff9c5a2bd4
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Implement CopyToDataTable&lt;T&gt; Where the Generic Type T Is Not a DataRow
+データ バインドには、しばしば <xref:System.Data.DataTable> オブジェクトが使用されます。  <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、クエリの結果を受け取り、そのデータを <xref:System.Data.DataTable> にコピーします。これをデータ バインドに利用できます。  ただし、<xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドは、ジェネリック パラメーター `T` が <xref:System.Data.DataRow> 型である <xref:System.Collections.Generic.IEnumerable%601> ソースに対してのみ作用します。  有用ではありますが、一連のスカラー型、匿名型を射影するクエリ、またはテーブルの結合を実行するクエリからは、テーブルを作成できません。  
+  
+ このトピックでは、<xref:System.Data.DataRow> 型以外のジェネリック パラメーター `T` を受け取る 2 つのカスタム `CopyToDataTable<T>` 拡張メソッドを実装する方法について説明します。  <xref:System.Collections.Generic.IEnumerable%601> ソースから <xref:System.Data.DataTable> を作成するロジックは、`ObjectShredder<T>` クラスに存在し、オーバーロードされた 2 つの `CopyToDataTable<T>` 拡張メソッドにラップされています。  `ObjectShredder<T>` クラスの `Shred` メソッドは、データが格納された <xref:System.Data.DataTable> を返し、<xref:System.Collections.Generic.IEnumerable%601> ソース、<xref:System.Data.DataTable>、および <xref:System.Data.LoadOption> 列挙型の 3 つの入力パラメーターを受け取ります。  返される <xref:System.Data.DataTable> の最初のスキーマは、`T` 型のスキーマに基づきます。  既存のテーブルを入力として指定する場合は、そのスキーマが、`T` 型のスキーマと矛盾がないようにする必要があります。  返されたテーブルでは、`T` 型のパブリック プロパティおよびパブリック フィールドが、それぞれ <xref:System.Data.DataColumn> に変換されます。  `T` から派生した型がソース シーケンスに含まれている場合は、返されるテーブルのスキーマが、あらゆる追加パブリック プロパティまたは追加パブリック フィールドに展開されます。  
+  
+ カスタム `CopyToDataTable<T>` メソッドの使用例については、「[Creating a DataTable From a Query](../../../../docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md)」を参照してください。  
+  
+### カスタム CopyToDataTable\<T\> メソッドをアプリケーションに実装するには  
+  
+1.  `ObjectShredder<T>` クラスを実装して、<xref:System.Collections.Generic.IEnumerable%601> ソースから <xref:System.Data.DataTable> を作成します。  
+  
+     [!code-csharp[DP Custom CopyToDataTable Examples#ObjectShredderClass](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#objectshredderclass)]
+     [!code-vb[DP Custom CopyToDataTable Examples#ObjectShredderClass](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#objectshredderclass)]  
+  
+2.  カスタム `CopyToDataTable<T>` 拡張メソッドをクラスに実装します。  
+  
+     [!code-csharp[DP Custom CopyToDataTable Examples#CustomCopyToDataTableMethods](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/CS/Program.cs#customcopytodatatablemethods)]
+     [!code-vb[DP Custom CopyToDataTable Examples#CustomCopyToDataTableMethods](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP Custom CopyToDataTable Examples/VB/Module1.vb#customcopytodatatablemethods)]  
+  
+3.  `ObjectShredder<T>` クラスおよび `CopyToDataTable<T>` 拡張メソッドをアプリケーションに追加します。  
+  
+    ```vb  
+    Module Module1  
+        Sub Main()  
+        ' Your application code using CopyToDataTable<T>.  
+        End Sub  
+    End Module  
+  
+    Public Module CustomLINQtoDataSetMethods  
+    …  
+    End Module  
+  
+    Public Class ObjectShredder(Of T)  
+    …  
+    End Class  
+    ```  
+  
+4.  ```c#  
+    class Program  
+    {  
+            static void Main(string[] args)  
+            {  
+               // Your application code using CopyToDataTable<T>.  
+            }  
+    }  
+    public static class CustomLINQtoDataSetMethods  
+    {  
+    …  
+    }  
+    public class ObjectShredder<T>  
+    {  
+    …  
+    }  
+    ```  
+  
+## 参照  
+ [Creating a DataTable From a Query](../../../../docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md)   
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/index.md b/docs/framework/data/adonet/index.md
new file mode 100644
index 00000000000..1f0044c0699
--- /dev/null
+++ b/docs/framework/data/adonet/index.md
@@ -0,0 +1,74 @@
+---
+title: "ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b96ed06-9759-4966-a797-a1d5f6ee50ca
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# ADO.NET
+ADO.NET は、.NET Framework のプログラミングでデータ アクセス サービスを使用できるようにするためのクラスの集合です。  ADO.NET は、分散型データ共有アプリケーションを作成する、さまざまなコンポーネントのセットを提供します。  ADO.NET は .NET Framework の不可欠な部分であり、リレーショナル データ、XML データ、およびアプリケーション データへのアクセス機能を提供します。  ADO.NET は、アプリケーション、ツール、言語、またはインターネット ブラウザーが使用するフロントエンド データベース クライアントや中間層ビジネス オブジェクトの作成を含む、各種の開発ニーズをサポートします。  
+  
+## このセクションの内容  
+ [ADO.NET の新機能](../../../../docs/framework/data/adonet/whats-new.md)  
+ ADO.NET の新機能について説明します。  
+  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)  
+ ADO.NET のデザインとコンポーネントを紹介します。  
+  
+ 「[エンティティ フレームワーク](http://go.microsoft.com/fwlink/?LinkID=213876)」  
+ Entity Framework を使用してアプリケーションを作成する方法について説明します。  
+  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)  
+ ADO.NET を使用する場合の安全なコーディング方法について説明します。  
+  
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)  
+ .NET Framework データ型と .NET Framework データ プロバイダーとの間のデータ型のマッピングについて説明します。  
+  
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)  
+ `DataSets`、型指定された `DataSets`、`DataTables`、および `DataViews` の作成方法と使用方法について説明します。  
+  
+ [LINQ to DataSet](../../../../docs/framework/data/adonet/linq-to-dataset.md)  
+ プログラミング例を含め、LINQ to DataSet に関する情報を提供します。  
+  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)  
+ `Commands`、`DataReaders`、および `DataAdapters` を使用してデータ ソースに接続し、データの取得や変更を行う方法について説明します。  
+  
+ [SQL Server と ADO.NET](../../../../docs/framework/data/adonet/sql/index.md)  
+ SQL Server 固有の機能の使用方法について説明します。  
+  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)  
+ .NET Framework Data Provider for Oracle 固有の機能および動作について説明します。  
+  
+## 関連項目  
+ [PAVE Security in Native and .NET Framework Code](http://msdn.microsoft.com/ja-jp/bd61be84-c143-409a-a75a-44253724f784)  
+ Visual Studio、.NET Framework、および暗号のセキュリティに関するトピックへのリンクが掲載されています。  
+  
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)  
+ LINQ に関連したトピックおよびサンプルへのリンクが掲載されています。  
+  
+ [WCF Data Services 4.5](../../../../docs/framework/data/wcf/index.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して、Open Data Protocol \(OData\) を実装するデータ サービスを Web またはインターネットに配置する方法について説明します。  
+  
+ [Core Development Technologies](http://msdn.microsoft.com/ja-jp/f7f0ab29-7866-4ef1-84dc-40e9677b5441)  
+ .NET Framework の標準的な開発タスクに関する情報へのリンクが掲載されています。  
+  
+ [Advanced Development Technologies](http://msdn.microsoft.com/ja-jp/c4a7e341-f0c6-4df4-a74f-223387ac6e4e)  
+ .NET Framework の最新の開発タスクと開発手法に関する情報へのリンクが記載されています。  
+  
+ [Samples and QuickStarts](http://msdn.microsoft.com/ja-jp/e0d76b4d-faa3-4281-a8d3-1136143a2be7)  
+ .NET Framework に関連するすべてのサンプルとクイックスタート サンプルの詳細な一覧が掲載されています。  
+  
+## 参照  
+ [Visual Studio でのデータへのアクセス](../Topic/Accessing%20data%20in%20Visual%20Studio.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/linq-and-ado-net.md b/docs/framework/data/adonet/linq-and-ado-net.md
new file mode 100644
index 00000000000..ab1fe467587
--- /dev/null
+++ b/docs/framework/data/adonet/linq-and-ado-net.md
@@ -0,0 +1,54 @@
+---
+title: "LINQ と ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf0c8f93-3ff7-49f3-8aed-f2b7ac938dec
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# LINQ と ADO.NET
+今日、ビジネス アプリケーション開発者の多くは、2 つ \(またはそれ以上\) のプログラミング言語を使ってアプリケーションを開発しています。ビジネス ロジックやプレゼンテーション層には高級言語 \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] など\) が、データベースとの対話にはクエリ言語 \([!INCLUDE[tsql](../../../../includes/tsql-md.md)] など\) が使用されています。  開発者は実質的に複数の言語に精通していることが要求され、開発環境における言語の不整合が生じる原因にもなっています。  たとえば、データ アクセス API を使用してデータベースを照会するアプリケーションでは、クエリは文字列リテラルとして引用符で囲んで指定する必要があります。  コンパイラはこのクエリ文字列を認識できないため、エラー \(無効な構文、参照されている列または行が実際に存在するかどうかなど\) のチェック機構が働きません。  クエリ パラメーターの型チェックや `IntelliSense` のサポートもありません。  
+  
+ [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] により、開発者はアプリケーション コード内でプログラミング言語とクエリ言語を使い分けることなく、セット ベースのクエリを作成できます。  インメモリのデータ構造、XML ドキュメント、SQL データベース、<xref:System.Data.DataSet> オブジェクトなど、列挙可能な各種データ ソース \(つまり、<xref:System.Collections.IEnumerable> インターフェイスを実装するデータ ソース\) に対する [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] クエリを作成できます。  実装方法には違いがありますが、こうした列挙可能なデータ ソースはすべて同じ構文および言語構造を公開しています。  クエリはプログラミング言語のみで作成できるため、コンパイラによる認識も検証もできない文字列リテラルとしてクエリ言語を記述する必要はありません。  クエリをプログラミング言語に統合することにより、コンパイル時の型チェックや構文チェック、`IntelliSense` の使用などが可能となるため、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] プログラマは生産性を高めることができます。  クエリのデバッグやエラーの修正に伴う手間は、これらの機能によって軽減されます。  
+  
+ SQL テーブルのデータをメモリ内のオブジェクトに転送することは、面倒であるだけでなく間違いの元にもなります。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] および [!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] で実装された [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] プロバイダーは、ソース データを <xref:System.Collections.IEnumerable> ベースのオブジェクト コレクションに変換します。  プログラマからは、クエリの実行時も更新時も常にデータが <xref:System.Collections.IEnumerable> コレクションとして見えます。  これらのコレクションに対するクエリを記述する際には、`IntelliSense` の機能を完全に利用できます。  
+  
+ ADO.NET [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] には、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)]、[!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)]、および [!INCLUDE[linq_entities](../../../../includes/linq-entities-md.md)] の 3 つのテクノロジがあります。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、<xref:System.Data.DataSet> に対する高度で最適化されたクエリの実行を可能にします。一方、[!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] は、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] データベース スキーマに対して直接クエリを実行できるようにします。また、[!INCLUDE[linq_entities](../../../../includes/linq-entities-md.md)] は、[!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)] をクエリできるようにします。  
+  
+ 次の図は、ADO.NET LINQ テクノロジが、高級プログラミング言語および LINQ 対応のデータ ソースとどのように関係しているかを簡単に表したものです。  
+  
+ ![LINQ to ADO.NET の概要](../../../../docs/framework/data/adonet/media/dpue-linqtoadonetoverview-bpuedev11.png "DPUE\_LinqToAdoNetOverview\_bpuedev11")  
+  
+ LINQ 言語機能に関する全般的な情報については、「[Introduction to LINQ](../../../../ocs/visual-basic/programming-guide/language-features/linq/introduction-to-linq.md)」を参照してください。  アプリケーションで LINQ を使用する方法については、「[NOT IN BUILD: LINQ General Programming Guide](http://msdn.microsoft.com/ja-jp/609c7a6b-cbdd-429d-99f3-78d13d3bc049)」を参照してください。このガイドには、LINQ テクノロジの使用方法に関する詳細が記述されています。  
+  
+ 以降のセクションで、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)]、[!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)]、および [!INCLUDE[linq_entities](../../../../includes/linq-entities-md.md)] について詳しく説明します。  
+  
+## LINQ to DataSet  
+ <xref:System.Data.DataSet> は、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の基礎である非接続型プログラミング モデルの重要な要素であり幅広く使用されています。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] により、開発者は、他の多くのデータ ソースで利用できる共通のクエリ作成メカニズムを使用しながら、より高度なクエリ機能を <xref:System.Data.DataSet> に組み込むことができます。  詳細については、「[LINQ to DataSet](../../../../docs/framework/data/adonet/linq-to-dataset.md)」を参照してください。  
+  
+## LINQ to SQL  
+ [!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] は、概念モデルへのマッピングを必要としない開発者にとって有用なツールです。  [!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] では、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] プログラミング モデルを既存のデータベース スキーマ上で直接利用できるようになります。  開発者は、データを表現する [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] クラスを、[!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] を使って生成できます。  こうして生成されたクラスは、概念データ モデルではなく、直接データベースのテーブル、ビュー、ストアド プロシージャ、およびユーザー定義関数にマッピングされます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] では、開発者が、XML などのデータ ソースに加え、インメモリ コレクションや <xref:System.Data.DataSet> と同じ [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] プログラミング パターンを使用して、ストレージ スキーマに対して直接コードを記述できます。  詳細については、「[LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md)」を参照してください。  
+  
+## LINQ to Entities  
+ 現在、多くのアプリケーションが、リレーショナル データベースを基にして作成されています。  ある時点で、これらのアプリケーションにはリレーショナル形式で表されるデータと対話する必要が生じます。  データベース スキーマはアプリケーションの構築に理想的であるとは限らず、アプリケーションの概念モデルはデータベースの論理モデルと同じではありません。  [!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)]は、アプリケーションがデータをオブジェクトとして操作するために特定のドメインのデータをモデル化するときに使用できる概念データ モデルです。  詳細については、「[ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md)」を参照してください。  
+  
+ [!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)]を介して、リレーショナル データは .NET 環境でオブジェクトとして公開されます。  これにより、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] の利用に最適なオブジェクト レイヤーが実現されます。開発者は、ビジネス ロジックの構築に使用する言語で、データベースを照会するクエリを作成できます。  この機能は、[!INCLUDE[linq_entities](../../../../includes/linq-entities-md.md)] と呼ばれます。  詳細については、「[LINQ to Entities](../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)」を参照してください。  
+  
+## 参照  
+ [LINQ to DataSet](../../../../docs/framework/data/adonet/linq-to-dataset.md)   
+ [LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md)   
+ [LINQ to Entities](../../../../docs/framework/data/adonet/ef/language-reference/linq-to-entities.md)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/linq-to-dataset-examples.md b/docs/framework/data/adonet/linq-to-dataset-examples.md
new file mode 100644
index 00000000000..bc990603b28
--- /dev/null
+++ b/docs/framework/data/adonet/linq-to-dataset-examples.md
@@ -0,0 +1,64 @@
+---
+title: "LINQ to DataSet Examples | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfd91658-8d8a-45a4-a356-e327e809f21d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# LINQ to DataSet Examples
+このセクションでは、標準クエリ演算子を使った [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] プログラミングの例を紹介しています。  これらの例に使用されている <xref:System.Data.DataSet> のデータは、`FillDataSet` メソッド \(「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照\) を使って読み込みます。詳細については、「[Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Query Expression Examples](../../../../docs/framework/data/adonet/query-expression-examples-linq-to-dataset.md)  
+ 次の例があります。  
+  
+-   [Projection](../../../../docs/framework/data/adonet/query-expression-syntax-examples-projection-linq-to-dataset.md)  
+  
+-   [Restriction](../../../../docs/framework/data/adonet/query-expression-syntax-examples-restriction-linq-to-dataset.md)  
+  
+-   [Partitioning](../../../../docs/framework/data/adonet/query-expression-syntax-examples-partitioning.md)  
+  
+-   [Ordering](../../../../docs/framework/data/adonet/query-expression-syntax-examples-ordering-linq-to-dataset.md)  
+  
+-   [Element Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-element-operators.md)  
+  
+-   [Aggregate Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-aggregate-operators.md)  
+  
+-   [Join Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-join-operators.md)  
+  
+ [Method\-Based Query Examples](../../../../docs/framework/data/adonet/method-based-query-examples-linq-to-dataset.md)  
+ 次の例があります。  
+  
+-   [Projection](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-projection.md)  
+  
+-   [Partitioning](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-partitioning-linq.md)  
+  
+-   [Ordering](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-ordering-linq-to-dataset.md)  
+  
+-   [Set Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-set-operators.md)  
+  
+-   [Conversion Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-conversion-operators.md)  
+  
+-   [Element Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-element-operators.md)  
+  
+-   [Aggregate Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-aggregate-operators.md)  
+  
+-   [Join](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-join-linq-to-dataset.md)  
+  
+ [DataSet\-Specific Operator Examples](../../../../docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md)  
+ <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドおよび <xref:System.Data.DataRowComparer> クラスの使用例を紹介しています。  
+  
+## 参照  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)   
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/linq-to-dataset-overview.md b/docs/framework/data/adonet/linq-to-dataset-overview.md
new file mode 100644
index 00000000000..7f33a5b1dcb
--- /dev/null
+++ b/docs/framework/data/adonet/linq-to-dataset-overview.md
@@ -0,0 +1,41 @@
+---
+title: "LINQ to DataSet Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dc20a8fb-03f6-4b68-9c2b-7f7299e3070b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to DataSet Overview
+<xref:System.Data.DataSet> は、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] のコンポーネントの中でもきわめて使用頻度の高いコンポーネントの 1 つです。 [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の基礎を成す非接続型プログラミング モデルの重要な要素であり、さまざまなデータ ソースからのデータを明示的にキャッシュできます。 プレゼンテーション層では、<xref:System.Data.DataSet> とデータ バインドの GUI コントロールとが密接に連携します。 中間層では、リレーショナル形式のデータを維持するキャッシュとして機能し、単純で高速なクエリと、階層的なナビゲーション サービスを提供します。  データベースに対する要求数を削減するための基本的な手法は、<xref:System.Data.DataSet> を使用し、データを中間層でキャッシュすることです。  たとえば、データ ドリブンの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションでは、  ほとんど変更されないアプリケーション データがかなりの割合で存在し、しかも、複数のセッションまたは複数のユーザー間で共通して使用されているケースがよくあります。  このデータを Web サーバー上のメモリに維持しておくことで、データベースに対する要求数を減らし、高速な対話処理をユーザーに提供できます。  <xref:System.Data.DataSet> が備えるもう 1 つの特長は、アプリケーションが、1 つまたは複数のデータ ソースから取得したデータのサブセットをアプリケーション空間に取り込むことができる点です。  アプリケーションは、そのデータをリレーショナル形式を維持したままインメモリで操作できます。  
+  
+ こうした突出した特長がある反面、<xref:System.Data.DataSet> のクエリ機能には制限があります。  <xref:System.Data.DataTable.Select%2A> メソッドでデータのフィルター処理や並べ替えを行ったり、<xref:System.Data.DataRow.GetChildRows%2A> メソッドや <xref:System.Data.DataRow.GetParentRow%2A> メソッドを使って階層のナビゲーションを行うことはできます。  しかし、さらに複雑な処理を行うには、開発者が独自にクエリを作成する必要があります。  その結果、アプリケーションで期待したパフォーマンスが得られなかったり、メンテナンスが難しくなったりする可能性があります。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、<xref:System.Data.DataSet> オブジェクトにキャッシュされたデータに対するクエリをより簡単に、より高速にします。  これらのクエリはアプリケーション コードに文字列リテラルとして記述するのではなく、プログラミング言語そのもので表現できます。  つまり、開発者はクエリ言語を個別に習得する必要はありません。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] の利点はそれだけではありません。[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] IDE で [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に対するコンパイル時の構文チェック、静的な型指定、IntelliSense などの機能を利用できるため、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 開発者の生産性も向上します。  また、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用すると、1 つまたは複数のデータ ソースから取得して統合したデータを照会することもできます。  これにより、データの表現方法や扱いに柔軟性が要求されるさまざまなシナリオが実現します。  特に、汎用のレポート作成、分析、ビジネス インテリジェンスを行うアプリケーションでは、この手法を用いたデータ操作が欠かせません。  
+  
+## LINQ to DataSet を使った DataSet のクエリ  
+ <xref:System.Data.DataSet> を使用して [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] オブジェクトを照会するには、あらかじめ <xref:System.Data.DataSet> にデータを読み込んでおく必要があります。 <xref:System.Data.DataSet> へのデータの読み込みは、<xref:System.Data.Common.DataAdapter> クラスまたは [LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md) を使用するなど、複数の方法で行うことができます。  <xref:System.Data.DataSet> オブジェクトへのデータの読み込みが完了すると、そのデータセットに対してクエリを実行できるようになります。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使ったクエリの作成方法は、他の [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] 対応データ ソースに対して [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] を使用する方法と似ています。  [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] のクエリは、<xref:System.Data.DataSet> の単一のテーブルに対して実行するか、または <xref:System.Linq.Enumerable.Join%2A> や <xref:System.Linq.Enumerable.GroupJoin%2A> などの標準クエリ演算子を使って複数のテーブルに対して実行することができます。  
+  
+ [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] のクエリは、<xref:System.Data.DataSet> の型指定されたオブジェクトと、型指定されていないオブジェクトの両方をサポートしています。  アプリケーションのデザイン時に <xref:System.Data.DataSet> のスキーマがわかっている場合は、型指定された <xref:System.Data.DataSet> を使用することをお勧めします。 型指定された <xref:System.Data.DataSet> のテーブルおよび行は、列ごとに型指定されたメンバーを持ちます。これにより、クエリが簡素化され、読みやすくなります。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] には、System.Core.dll に実装された標準クエリ演算子に加え、一連の <xref:System.Data.DataSet> オブジェクトに対して容易にクエリを実行することのできる複数の <xref:System.Data.DataRow> 固有の拡張機能が追加されています。  これらの <xref:System.Data.DataSet> 固有の拡張機能には、<xref:System.Data.DataRow> の列値にアクセスするためのメソッドのほか、一連の行を比較するための演算子があります。  
+  
+## n 層アプリケーションと LINQ to DataSet  
+ n 層データ アプリケーションは、複数の論理レイヤー \(層\) に分けられた、データ処理を中心とするアプリケーションです。  一般に、n 層アプリケーションには、プレゼンテーション層、中間層、およびデータ層が含まれます。  アプリケーション コンポーネントを別個の層に分離すると、アプリケーションの保守容易性とスケーラビリティが向上します。  n 層データ アプリケーションの詳細については、「[n 層アプリケーションでのデータセットの操作](../Topic/Work%20with%20datasets%20in%20n-tier%20applications.md)」を参照してください。  
+  
+ n 層アプリケーションでは、Web アプリケーションの情報をキャッシュするために <xref:System.Data.DataSet> が中間層で使用されます。  拡張メソッドを通じて実装される [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のクエリ機能により、既存の ADO.NET 2.0 の <xref:System.Data.DataSet> が強化されています。  
+  
+## 参照  
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)   
+ [LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/linq-to-dataset.md b/docs/framework/data/adonet/linq-to-dataset.md
new file mode 100644
index 00000000000..9e0ded36156
--- /dev/null
+++ b/docs/framework/data/adonet/linq-to-dataset.md
@@ -0,0 +1,43 @@
+---
+title: "LINQ to DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 743e3755-3ecb-45a2-8d9b-9ed41f0dcf17
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LINQ to DataSet
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、<xref:System.Data.DataSet> オブジェクトにキャッシュされたデータに対するクエリをより簡単に、より高速にします。  つまり、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、クエリを記述するのにクエリ言語ではなくプログラミング言語そのものを使用できるので、クエリ操作が容易になります。  これは、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] 開発者にとって特に便利で、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] によって提供されるコンパイル時の構文チェック、静的な型指定、IntelliSense のサポートをクエリで利用できるようになります。  
+  
+ また、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用すると、1 つまたは複数のデータ ソースから取得して統合したデータを照会することもできます。  これにより、ローカルに集計されたデータのクエリや Web アプリケーションでの中間層のキャッシュなど、データの表現方法や扱いに柔軟性が要求されるさまざまなシナリオが実現します。  特に、汎用のレポート作成、分析、ビジネス インテリジェンスを行うアプリケーションでは、この手法を用いたデータ操作が欠かせません。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 機能は、主に <xref:System.Data.DataRowExtensions> クラスおよび <xref:System.Data.DataTableExtensions> クラスの拡張メソッドを介して公開されます。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、既存の [!INCLUDE[ado_whidbey_long](../../../../includes/ado-whidbey-long-md.md)] アーキテクチャに基づきこれを使用するものであり、アプリケーション コードの [!INCLUDE[ado_whidbey_long](../../../../includes/ado-whidbey-long-md.md)] に代わるものではありません。  既存の ADO.NET 2.0 コードは [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] アプリケーションにおいても機能します。 [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] と [!INCLUDE[ado_whidbey_long](../../../../includes/ado-whidbey-long-md.md)] のリレーションシップとデータ ストアを次の図に示します。  
+  
+ ![ADO.NET プロバイダーに基づく LINQ to DataSet](../../../../docs/framework/data/adonet/media/linqtodataset.gif "LINQtoDataSet")  
+  
+## このセクションの内容  
+ [Getting Started](../../../../docs/framework/data/adonet/getting-started-linq-to-dataset.md)  
+  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)  
+  
+## 関連項目  
+ <xref:System.Data.DataTableExtensions>  
+  
+ <xref:System.Data.DataRowExtensions>  
+  
+ <xref:System.Data.DataRowComparer>  
+  
+## 参照  
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)   
+ [LINQ と ADO.NET](../../../../docs/framework/data/adonet/linq-and-ado-net.md)   
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/loading-data-into-a-dataset.md b/docs/framework/data/adonet/loading-data-into-a-dataset.md
new file mode 100644
index 00000000000..247c7a31c03
--- /dev/null
+++ b/docs/framework/data/adonet/loading-data-into-a-dataset.md
@@ -0,0 +1,33 @@
+---
+title: "Loading Data Into a DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a53e5dc1-9669-49d4-828d-efa633237066
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Loading Data Into a DataSet
+[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] で <xref:System.Data.DataSet> オブジェクトに対するクエリを実行するには、まずデータセットにデータを読み込んでおく必要があります。  <xref:System.Data.DataSet> には、複数の方法でデータを読み込むことができます。  たとえば、[!INCLUDE[vbtecdlinq](../../../../includes/vbtecdlinq-md.md)] を使用してデータベースに対するクエリを実行し、その結果を <xref:System.Data.DataSet> に読み込む方法です。  詳細については、「[LINQ to SQL](../../../../docs/framework/data/adonet/sql/linq/index.md)」を参照してください。  
+  
+ データを <xref:System.Data.DataSet> に読み込む一般的な方法としては、他にも <xref:System.Data.Common.DataAdapter> クラスを使用してデータベースからデータを取得する方法もあります。  この例を次に示します。  
+  
+## 例  
+ この例では、<xref:System.Data.Common.DataAdapter> を使用して、2002 年度の売上情報を照会するクエリを AdventureWorks データベースに対して実行し、その結果を <xref:System.Data.DataSet> に読み込んでいます。  <xref:System.Data.DataSet> への読み込みが完了した後、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用して、そのデータセットに対するクエリを作成できます。  この例の `FillDataSet` メソッドは、「[LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)」のクエリ例で使用されています。  詳細については、「[Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)」を参照してください。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#FillDataSet](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#filldataset)]
+ [!code-vb[DP LINQ to DataSet Examples#FillDataSet](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#filldataset)]  
+  
+## 参照  
+ [LINQ to DataSet Overview](../../../../docs/framework/data/adonet/linq-to-dataset-overview.md)   
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/local-transactions.md b/docs/framework/data/adonet/local-transactions.md
new file mode 100644
index 00000000000..25ad703f9ec
--- /dev/null
+++ b/docs/framework/data/adonet/local-transactions.md
@@ -0,0 +1,58 @@
+---
+title: "ローカル トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ae3712f-ef5e-41a1-9ea9-b3d0399439f1
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# ローカル トランザクション
+[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] でのトランザクションは、複数のタスクをバインドして単一の作業単位として実行する場合に使用します。  たとえば、あるアプリケーションが 2 つのタスクを実行するものとします。  まず、注文情報に従ってテーブルが更新されます。  次に、在庫情報を含むテーブルが更新され、注文品の金額が借方記入されます。  いずれかのタスクが失敗すると、両方の更新がロールバックされます。  
+  
+## トランザクションの種類の判別  
+ 単一フェーズであり、データベースによって直接処理されるトランザクションは、ローカル トランザクションであると見なされます。  トランザクション モニターによってコーディネートされ、トランザクションの解決にフェール セーフ機構 \(2 フェーズのコミットなど\) を使用しているトランザクションは、分散トランザクションであると見なされます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーは、それぞれ独自の `Transaction` オブジェクトを使用してローカル トランザクションを実行しています。  トランザクションを SQL Server データベースで実行できるようにする場合は、<xref:System.Data.SqlClient> トランザクションを選択します。  Oracle トランザクションの場合は、<xref:System.Data.OracleClient> プロバイダーを使用します。  さらに、トランザクションを必要とする、プロバイダーに依存しないコードを記述するための新しい <xref:System.Data.Common.DbTransaction> クラスもあります。  
+  
+> [!NOTE]
+>  トランザクションは、サーバー上で実行するのが最も効率的です。  明示的なトランザクションを広範に使用する SQL Server データベースを操作する場合は、Transact\-SQL の BEGIN TRANSACTION ステートメントを使用して、ストアド プロシージャとしてトランザクション処理を記述するとよいでしょう。  サーバー側のトランザクション実行の詳細については、SQL Server オンライン ブックを参照してください。  
+  
+## 単一の接続を使用したトランザクションの実行  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では、`Connection` オブジェクトを使用してトランザクションを制御します。  ローカル トランザクションは、`BeginTransaction` メソッドを使用して開始できます。  トランザクションを開始すると、`Command` オブジェクトの `Transaction` プロパティを使用して、そのトランザクションにコマンドを参加させることができます。  次に、トランザクションの内容が成功したか失敗したかに基づいて、データ ソースに対する変更をコミットまたはロールバックします。  
+  
+> [!NOTE]
+>  `EnlistDistributedTransaction` メソッドをローカル トランザクションで使用することはできません。  
+  
+ トランザクションのスコープは、接続に限定されています。  次の例では、`try` ブロック内の 2 つの個別のコマンドで構成される明示的なトランザクションを実行しています。  これらのコマンドは、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] の AdventureWorks サンプル データベース内の Production.ScrapReason テーブルに対して INSERT ステートメントを実行し、例外がスローされない場合にコミットします。  `catch` ブロック内のコードは、例外がスローされた場合にトランザクションをロールバックします。  トランザクションが完了する前に中止されるか接続が終了すると、トランザクションは自動的にロールバックされます。  
+  
+## 例  
+ トランザクションを実行するには、次の手順に従います。  
+  
+1.  <xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.BeginTransaction%2A> メソッドを呼び出して、トランザクションの開始位置をマークします。  <xref:System.Data.SqlClient.SqlConnection.BeginTransaction%2A> メソッドは、トランザクションへの参照を返します。  この参照は、トランザクションに参加する <xref:System.Data.SqlClient.SqlCommand> オブジェクトに割り当てられます。  
+  
+2.  実行する <xref:System.Data.SqlClient.SqlCommand> の <xref:System.Data.SqlClient.SqlCommand.Transaction%2A> プロパティに、`Transaction` オブジェクトを割り当てます。  アクティブなトランザクションを持つ接続上でコマンドが実行され、`Command` オブジェクトの `Transaction` プロパティに `Transaction` オブジェクトが割り当てられていない場合は、例外がスローされます。  
+  
+3.  必要なコマンドを実行します。  
+  
+4.  <xref:System.Data.SqlClient.SqlTransaction> オブジェクトの <xref:System.Data.SqlClient.SqlTransaction.Commit%2A> メソッドを呼び出してトランザクションを完了するか、<xref:System.Data.SqlClient.SqlTransaction.Rollback%2A> メソッドを呼び出してトランザクションを終了します。  <xref:System.Data.SqlClient.SqlTransaction.Commit%2A> または <xref:System.Data.SqlClient.SqlTransaction.Rollback%2A> メソッドが実行される前に接続が終了または破棄されると、トランザクションはロールバックされます。  
+  
+ Microsoft SQL Server で [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] を使用するトランザクション ロジックを次のコード サンプルに示します。  
+  
+ [!code-csharp[DataWorks SqlTransaction.Local#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlTransaction.Local/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlTransaction.Local#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlTransaction.Local/VB/source.vb#1)]  
+  
+## 参照  
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [分散トランザクション](../../../../docs/framework/data/adonet/distributed-transactions.md)   
+ [SQL Server と System.Transactions の統合](../../../../docs/framework/data/adonet/system-transactions-integration-with-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/media/examplemodel.gif b/docs/framework/data/adonet/media/examplemodel.gif
new file mode 100644
index 00000000000..d5972492af7
Binary files /dev/null and b/docs/framework/data/adonet/media/examplemodel.gif differ
diff --git a/docs/framework/data/adonet/media/inheritanceexample.gif b/docs/framework/data/adonet/media/inheritanceexample.gif
new file mode 100644
index 00000000000..d7359b371a2
Binary files /dev/null and b/docs/framework/data/adonet/media/inheritanceexample.gif differ
diff --git a/docs/framework/data/adonet/media/linqtodataset.gif b/docs/framework/data/adonet/media/linqtodataset.gif
new file mode 100644
index 00000000000..f7e3d45e18f
Binary files /dev/null and b/docs/framework/data/adonet/media/linqtodataset.gif differ
diff --git a/docs/framework/data/adonet/media/modelwithnavprops.gif b/docs/framework/data/adonet/media/modelwithnavprops.gif
new file mode 100644
index 00000000000..7f522e00c5d
Binary files /dev/null and b/docs/framework/data/adonet/media/modelwithnavprops.gif differ
diff --git a/docs/framework/data/adonet/media/modelwithpublisheddate.gif b/docs/framework/data/adonet/media/modelwithpublisheddate.gif
new file mode 100644
index 00000000000..755b0e6a82f
Binary files /dev/null and b/docs/framework/data/adonet/media/modelwithpublisheddate.gif differ
diff --git a/docs/framework/data/adonet/media/refconstraintmodel.gif b/docs/framework/data/adonet/media/refconstraintmodel.gif
new file mode 100644
index 00000000000..903b549b7ad
Binary files /dev/null and b/docs/framework/data/adonet/media/refconstraintmodel.gif differ
diff --git a/docs/framework/data/adonet/media/setsexample.gif b/docs/framework/data/adonet/media/setsexample.gif
new file mode 100644
index 00000000000..272069e38a9
Binary files /dev/null and b/docs/framework/data/adonet/media/setsexample.gif differ
diff --git a/docs/framework/data/adonet/method-based-query-examples-linq-to-dataset.md b/docs/framework/data/adonet/method-based-query-examples-linq-to-dataset.md
new file mode 100644
index 00000000000..6062bbae0f0
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-examples-linq-to-dataset.md
@@ -0,0 +1,50 @@
+---
+title: "Method-Based Query Examples (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d340775c-7f39-4087-a290-5cbec6cfa68e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Examples (LINQ to DataSet)
+このセクションでは、標準クエリ演算子を使った [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] プログラミングの例をメソッド ベースのクエリ構文を中心に紹介しています。  これらの例に使用されている <xref:System.Data.DataSet> のデータは、`FillDataSet` メソッド \(「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照\) を使って読み込みます。  詳細については、「[Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Projection](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-projection.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Select%2A> メソッドおよび <xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使って <xref:System.Data.DataSet> を照会する例を取り上げます。  
+  
+ [Partitioning](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-partitioning-linq.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Skip%2A> メソッドおよび <xref:System.Linq.Enumerable.Take%2A> メソッドを使って <xref:System.Data.DataSet> を照会し、結果をパーティション分割する例を取り上げます。  
+  
+ [Ordering](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-ordering-linq-to-dataset.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.OrderBy%2A>、<xref:System.Linq.Enumerable.OrderByDescending%2A>、<xref:System.Linq.Enumerable.Reverse%2A>、<xref:System.Linq.Enumerable.ThenByDescending%2A> の各メソッドを使って <xref:System.Data.DataSet> を照会し、結果を並べ替える例を取り上げます。  
+  
+ [Set Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-set-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Distinct%2A>、<xref:System.Linq.Enumerable.Except%2A>、<xref:System.Linq.Enumerable.Intersect%2A>、<xref:System.Linq.Enumerable.Union%2A> の各演算子を使って、データ行の集合に対する値ベースの比較操作を実行する例を取り上げます。  
+  
+ [Conversion Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-conversion-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.ToArray%2A>、<xref:System.Linq.Enumerable.ToDictionary%2A>、<xref:System.Linq.Enumerable.ToList%2A> の各メソッドを使ってクエリ式を即時実行する例を示しています。  
+  
+ [Element Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-element-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.First%2A> メソッドおよび <xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用して <xref:System.Data.DataSet> から <xref:System.Data.DataRow> 要素を取得する例を取り上げます。  
+  
+ [Aggregate Operators](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-aggregate-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、<xref:System.Linq.Enumerable.Sum%2A> の各メソッドを使って <xref:System.Data.DataSet> を照会し、データを集計する例を取り上げます。  
+  
+ [Join](../../../../docs/framework/data/adonet/method-based-query-syntax-examples-join-linq-to-dataset.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.GroupJoin%2A> メソッドおよび <xref:System.Linq.Enumerable.Join%2A> メソッドを使って <xref:System.Data.DataSet> を照会する例を取り上げます。  
+  
+## 参照  
+ [Query Expression Examples](../../../../docs/framework/data/adonet/query-expression-examples-linq-to-dataset.md)   
+ [DataSet\-Specific Operator Examples](../../../../docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-aggregate-operators.md b/docs/framework/data/adonet/method-based-query-syntax-examples-aggregate-operators.md
new file mode 100644
index 00000000000..10ef6791117
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-aggregate-operators.md
@@ -0,0 +1,157 @@
+---
+title: "Method-Based Query Syntax Examples: Aggregate Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ed5f01d-acb2-4dd4-be60-f04c2d570fa8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Aggregate Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Aggregate%2A>、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.LongCount%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、および <xref:System.Linq.Enumerable.Sum%2A> の各演算子で、メソッド クエリ構文を使って <xref:System.Data.DataSet> および集計データに対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Aggregate  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Aggregate%2A> メソッドを使用して、`Contact` テーブルから最初の 5 つの連絡先を取得し、コンマ区切りの姓の一覧を作成します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Aggregate_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#aggregate_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#Aggregate_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#aggregate_mq)]  
+  
+## Average  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Average_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#average_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#Average_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#average_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、各スタイルの製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Average2_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#average2_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#Average2_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#average2_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、平均合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#AverageProjection_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#averageprojection_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#AverageProjection_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#averageprojection_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、それぞれの連絡先 ID について平均合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#AverageGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#averagegrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#AverageGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#averagegrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、それぞれの連絡先について `TotalDue` が平均値の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#AverageElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#averageelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#AverageElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#averageelements_mq)]  
+  
+## Count  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用して、`Product` テーブル内の製品の数を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Count](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#count)]
+ [!code-vb[DP LINQ to DataSet Examples#Count](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#count)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用して、連絡先 ID の一覧と、それぞれの注文数を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CountNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#countnested)]
+ [!code-vb[DP LINQ to DataSet Examples#CountNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#countnested)]  
+  
+### 例  
+ この例では、製品を色でグループ分けし、<xref:System.Linq.Enumerable.Count%2A> メソッドを使用してそれぞれの色グループに含まれる製品の数を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CountGrouped](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#countgrouped)]
+ [!code-vb[DP LINQ to DataSet Examples#CountGrouped](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#countgrouped)]  
+  
+## LongCount  
+  
+### 例  
+ この例では、連絡先の数を長整数として取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#LongCountSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#longcountsimple)]
+ [!code-vb[DP LINQ to DataSet Examples#LongCountSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#longcountsimple)]  
+  
+## 最大  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、最大合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MaxProjection_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#maxprojection_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MaxProjection_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#maxprojection_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について最大合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MaxGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#maxgrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MaxGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#maxgrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について `TotalDue` が最大の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MaxElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#maxelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MaxElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#maxelements_mq)]  
+  
+## 最小  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、最小合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MinProjection_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#minprojection_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MinProjection_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#minprojection_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先 ID について最小合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MinGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#mingrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MinGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#mingrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先について合計支払額が最小の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MinElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#minelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MinElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#minelements_mq)]  
+  
+## Sum  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、`SalesOrderDetail` テーブル内の注文数量の合計を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SumProjection_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#sumprojection_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SumGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#sumgrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SumGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#sumgrouped_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-conversion-operators.md b/docs/framework/data/adonet/method-based-query-syntax-examples-conversion-operators.md
new file mode 100644
index 00000000000..0c3575a7d80
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-conversion-operators.md
@@ -0,0 +1,60 @@
+---
+title: "Method-Based Query Syntax Examples: Conversion Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a084c16b-9b55-4690-aefd-f8e0810a92c3
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Conversion Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.ToArray%2A>、<xref:System.Linq.Enumerable.ToDictionary%2A>、<xref:System.Linq.Enumerable.ToList%2A> の各メソッドを使ってクエリ式を即時実行する例を示しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## ToArray  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ToArray%2A> メソッドを使用して、シーケンスを配列として即時評価します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ToArray](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#toarray)]
+ [!code-vb[DP LINQ to DataSet Examples#ToArray](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#toarray)]  
+  
+## ToDictionary  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ToDictionary%2A> メソッドを使用して、シーケンスおよび関連するキー式をディクショナリとして即時評価します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ToDictionary](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#todictionary)]
+ [!code-vb[DP LINQ to DataSet Examples#ToDictionary](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#todictionary)]  
+  
+## ToList  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ToList%2A> メソッドを使用して、シーケンスを <xref:System.Collections.Generic.List%601> として即時評価します。ここで、`T` は <xref:System.Data.DataRow> 型を表します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ToList](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#tolist)]
+ [!code-vb[DP LINQ to DataSet Examples#ToList](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#tolist)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-element-operators.md b/docs/framework/data/adonet/method-based-query-syntax-examples-element-operators.md
new file mode 100644
index 00000000000..15e423c1161
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-element-operators.md
@@ -0,0 +1,52 @@
+---
+title: "Method-Based Query Syntax Examples: Element Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eedf2fbd-f407-4f62-bb1a-c00eb001b1dd
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Element Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.First%2A> メソッドおよび <xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用し、クエリ式の構文を使って <xref:System.Data.DataSet> から <xref:System.Data.DataRow> 要素を取得する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## ElementAt  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用し、`PostalCode` \=\= "M4B 1V7" の条件に該当する 5 番目の住所を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ElementAt](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#elementat)]
+ [!code-vb[DP LINQ to DataSet Examples#ElementAt](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#elementat)]  
+  
+## First  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、名が 'Brooke' である最初の連絡先を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#FirstSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#firstsimple)]
+ [!code-vb[DP LINQ to DataSet Examples#FirstSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#firstsimple)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-join-linq-to-dataset.md b/docs/framework/data/adonet/method-based-query-syntax-examples-join-linq-to-dataset.md
new file mode 100644
index 00000000000..63ee031ea2e
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-join-linq-to-dataset.md
@@ -0,0 +1,54 @@
+---
+title: "Method-Based Query Syntax Examples: Join (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4fd5ed2c-b03a-4054-a3ed-3ddb380d7d9d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Join (LINQ to DataSet)
+結合は、リレーショナル データベース テーブルのように互いにナビゲート可能なリレーションシップを持たないデータ ソースをターゲットとするクエリにおいて重要な操作です。  2 つのデータ ソースを結合する操作とは、あるデータ ソース内のオブジェクトを、他方のデータ ソース内で共通の属性を持つオブジェクトと関連付けることです。  詳細については、「[Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+ このトピックでは、<xref:System.Linq.Enumerable.Join%2A> メソッドで、メソッド ベースのクエリ構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Join  
+  
+### 例  
+ この例では、`Contact` テーブルと `SalesOrderHeader` テーブルを結合します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#JoinSimple_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#joinsimple_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#JoinSimple_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#joinsimple_mq)]  
+  
+### 例  
+ この例では、`Contact` テーブルと `SalesOrderHeader` テーブルを結合し、結果を連絡先 ID でグループ化します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#JoinWithGroupedResults_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#joinwithgroupedresults_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#JoinWithGroupedResults_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#joinwithgroupedresults_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)   
+ [Join のサンプル](http://go.microsoft.com/fwlink/?LinkId=187357)   
+ [データセットのサンプル](http://go.microsoft.com/fwlink/?LinkId=187358)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-ordering-linq-to-dataset.md b/docs/framework/data/adonet/method-based-query-syntax-examples-ordering-linq-to-dataset.md
new file mode 100644
index 00000000000..f03b41e1e76
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-ordering-linq-to-dataset.md
@@ -0,0 +1,60 @@
+---
+title: "Method-Based Query Syntax Examples: Ordering (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f9ce4fd-e84f-48c0-bb64-89e217236d3e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Ordering (LINQ to DataSet)
+このトピックでは、<xref:System.Data.DataSet> に対し、<xref:System.Linq.Enumerable.OrderBy%2A>、<xref:System.Linq.Enumerable.Reverse%2A>、<xref:System.Linq.Enumerable.ThenBy%2A> の各メソッドを使ってクエリを実行し、その結果をメソッドのクエリ構文を使って並べ替える例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## OrderBy  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> メソッドおよびカスタム Comparer を使用し、大文字と小文字を区別せずに姓の並べ替えを実行します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#OrderByComparer_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#orderbycomparer_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#OrderByComparer_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#orderbycomparer_mq)]  
+  
+## Reverse  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Reverse%2A> メソッドを使用し、`OrderDate` が 2002 年 2 月 20 日よりも前の日付である注文のリストを作成します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Reverse](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#reverse)]
+ [!code-vb[DP LINQ to DataSet Examples#Reverse](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#reverse)]  
+  
+## ThenBy  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> メソッドと <xref:System.Linq.Enumerable.ThenBy%2A> メソッド、およびカスタム Comparer を使用して最初に表示価格で並べ替えた後、製品名の降順で大文字と小文字を区別せずに並べ替えます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ThenByDescendingComparer_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#thenbydescendingcomparer_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#ThenByDescendingComparer_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#thenbydescendingcomparer_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-partitioning-linq.md b/docs/framework/data/adonet/method-based-query-syntax-examples-partitioning-linq.md
new file mode 100644
index 00000000000..a0eea43a04b
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-partitioning-linq.md
@@ -0,0 +1,80 @@
+---
+title: "Method-Based Query Syntax Examples: Partitioning (LINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a582c53f-f203-44ae-a797-d7f169a4fbb5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Partitioning (LINQ
+このトピックでは、<xref:System.Linq.Enumerable.Skip%2A>、<xref:System.Linq.Enumerable.SkipWhile%2A>、<xref:System.Linq.Enumerable.Take%2A>、<xref:System.Linq.Enumerable.TakeWhile%2A> の各メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Skip  
+  
+### 例  
+ この例では、`Contact` テーブルから最初の 5 つを除くすべての連絡先を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SkipSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#skipsimple)]
+ [!code-vb[DP LINQ to DataSet Examples#SkipSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#skipsimple)]  
+  
+### 例  
+ この例では、Seattle から最初の 2 つを除くすべての住所を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SkipNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#skipnested)]
+ [!code-vb[DP LINQ to DataSet Examples#SkipNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#skipnested)]  
+  
+## SkipWhile  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> メソッドおよび <xref:System.Linq.Enumerable.SkipWhile%2A> メソッドを使用し、表示価格が 300.00 を超える製品を `Product` テーブルから取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SkipWhileSimple_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#skipwhilesimple_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SkipWhileSimple_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#skipwhilesimple_mq)]  
+  
+## Take  
+  
+### 例  
+ この例では、`Contact` テーブルから最初の 5 つの連絡先だけを、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#TakeSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#takesimple)]
+ [!code-vb[DP LINQ to DataSet Examples#TakeSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#takesimple)]  
+  
+### 例  
+ この例では、Seattle から最初の 3 つの住所を、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#TakeNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#takenested)]
+ [!code-vb[DP LINQ to DataSet Examples#TakeNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#takenested)]  
+  
+## TakeWhile  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> メソッドおよび <xref:System.Linq.Enumerable.TakeWhile%2A> メソッドを使用し、表示価格が 300.00 未満の製品を `Product` テーブルから取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#TakeWhileSimple_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#takewhilesimple_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#TakeWhileSimple_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#takewhilesimple_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-projection.md b/docs/framework/data/adonet/method-based-query-syntax-examples-projection.md
new file mode 100644
index 00000000000..17ab8c00212
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-projection.md
@@ -0,0 +1,58 @@
+---
+title: "Method-Based Query Syntax Examples: Projection (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0fc2c8f0-1967-4f30-8b20-39b8dccfb82f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Projection (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Select%2A> メソッドおよび <xref:System.Linq.Enumerable.SelectMany%2A> メソッドで、メソッド ベースのクエリ構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Select  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Select%2A> メソッドを使用して、`Name`、`ProductNumber`、`ListPrice` の各プロパティを一連の匿名型に射影します。  また、結果として得られる型では、`ListPrice` プロパティの名前が `Price` に変更されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectAnonymousTypes_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectanonymoustypes_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectAnonymousTypes_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectanonymoustypes_mq)]  
+  
+## SelectMany  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使用して、`TotalDue` が 500.00 に満たないすべての注文を選択します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectManyCompoundFrom_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectmanycompoundfrom_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectManyCompoundFrom_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectmanycompoundfrom_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使用して、2002 年 10 月 1 日以降に受けたすべての注文を選択します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectManyCompoundFrom2_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectmanycompoundfrom2_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectManyCompoundFrom2_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectmanycompoundfrom2_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/method-based-query-syntax-examples-set-operators.md b/docs/framework/data/adonet/method-based-query-syntax-examples-set-operators.md
new file mode 100644
index 00000000000..693c1621d45
--- /dev/null
+++ b/docs/framework/data/adonet/method-based-query-syntax-examples-set-operators.md
@@ -0,0 +1,68 @@
+---
+title: "Method-Based Query Syntax Examples: Set Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa93af15-28af-4b5e-846b-897308410edb
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Method-Based Query Syntax Examples: Set Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Distinct%2A>、<xref:System.Linq.Enumerable.Except%2A>、<xref:System.Linq.Enumerable.Intersect%2A>、<xref:System.Linq.Enumerable.Union%2A> の各演算子を使って、データ行の集合に対する値ベースの比較操作を実行する例を示します。[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)<xref:System.Data.DataRowComparer> の詳細については、「[Comparing DataRows](../../../../docs/framework/data/adonet/comparing-datarows-linq-to-dataset.md)」を参照してください。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Distinct  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Distinct%2A> メソッドを使用してシーケンス内の重複する要素を削除します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#DistinctRows](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#distinctrows)]
+ [!code-vb[DP LINQ to DataSet Examples#DistinctRows](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#distinctrows)]  
+  
+## Except  
+  
+### 例  
+ この例では、最初のテーブルにのみ存在し、かつ 2 つ目のテーブルには存在しない連絡先だけを、<xref:System.Linq.Enumerable.Except%2A> メソッドを使用して取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Except2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#except2)]
+ [!code-vb[DP LINQ to DataSet Examples#Except2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#except2)]  
+  
+## 交差  
+  
+### 例  
+ この例では、両方のテーブルに存在する連絡先を <xref:System.Linq.Enumerable.Intersect%2A> メソッドを使用して取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Intersect2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#intersect2)]
+ [!code-vb[DP LINQ to DataSet Examples#Intersect2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#intersect2)]  
+  
+## 和集合  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Union%2A> メソッドを使用して、2 つのテーブルのいずれかから一意の連絡先を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Union2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#union2)]
+ [!code-vb[DP LINQ to DataSet Examples#Union2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#union2)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/model-declared-function.md b/docs/framework/data/adonet/model-declared-function.md
new file mode 100644
index 00000000000..f0fc332d17f
--- /dev/null
+++ b/docs/framework/data/adonet/model-declared-function.md
@@ -0,0 +1,40 @@
+---
+title: "モデル宣言関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aba87f13-5685-4f6b-ad14-918e8a7d5c2a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# モデル宣言関数
+*モデル宣言関数*は、概念モデルで宣言されていても、その概念モデルには定義されていない関数です。  この関数は、ホスト環境またはストレージ環境で定義します。  たとえば、モデル宣言関数は、データベースに定義された関数にマップされ、これによって概念モデルにおけるサーバー側の機能が公開される場合があります。  
+  
+ モデル宣言関数の宣言には、次の情報が含まれます。  
+  
+-   関数の名前。  \(必須\)  
+  
+-   戻り値の型。  \(オプション\)。  
+  
+    > [!NOTE]
+    >  戻り値が指定されていない場合、戻り値の型は void になります。  
+  
+-   パラメーター名と型を含むパラメーター情報。  \(オプション\)。  
+  
+## 例  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  CSDL には、モデル宣言関数の 1 つの実装手段として、[関数インポート](http://msdn.microsoft.com/ja-jp/125704ae-56c7-4233-80b7-389a10f3a65d)があります。  次の CSDL は、関数インポート定義を含むエンティティ コンテナーを定義しています。  戻り値の型が指定されていないため、関数の戻り値の型は void になります。  
+  
+ [!code-xml[EDM_Example_Model#FunctionImport](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books4.edmx#functionimport)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/model-defined-function.md b/docs/framework/data/adonet/model-defined-function.md
new file mode 100644
index 00000000000..35bb9711314
--- /dev/null
+++ b/docs/framework/data/adonet/model-defined-function.md
@@ -0,0 +1,49 @@
+---
+title: "モデル定義関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8bb2edc8-e8e7-44c2-adc7-f44e11bda4f0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# モデル定義関数
+*モデル定義関数*は、概念モデルで定義される関数です。  モデル定義関数の本体は、[Entity SQL](../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md) により表現されます。これにより、データ ソースでサポートされる規則または言語に関係なく関数を表現することが可能になります。  
+  
+ モデル定義関数の定義には、次の情報が含まれます。  
+  
+-   関数名。  \(必須\)  
+  
+-   戻り値の型。  \(オプション\)。  
+  
+    > [!NOTE]
+    >  戻り値の型が指定されていない場合、戻り値は void になります。  
+  
+-   パラメーター情報。  \(オプション\)。  
+  
+-   関数の本体を定義する [Entity SQL](../../../../docs/framework/data/adonet/ef/language-reference/entity-sql-language.md) 表現。  
+  
+ モデル定義関数では、出力パラメーターがサポートされません。  この制約は、モデル定義関数を構成できるようにするためにあります。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  
+  
+ ![公開日付が含まれるモデル](../../../../docs/framework/data/adonet/media/modelwithpublisheddate.gif "ModelWithPublishedDate")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、`Book` \(上のダイアグラムの\) の出版以降の年数を返す概念モデルの関数を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#ModelDefinedFunction](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books4.edmx#modeldefinedfunction)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)   
+ [Entity Data Model: プリミティブ データ型](../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md b/docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md
new file mode 100644
index 00000000000..46d9d887566
--- /dev/null
+++ b/docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md
@@ -0,0 +1,53 @@
+---
+title: "DbDataAdapter を使用したデータの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e35c7f9e-648b-4fcc-9361-d365c3e42c9a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DbDataAdapter を使用したデータの変更
+<xref:System.Data.Common.DbProviderFactory> オブジェクトの <xref:System.Data.Common.DbProviderFactory.CreateDataAdapter%2A> メソッドを使用すると、ファクトリの作成時に指定した基になるデータ プロバイダーに対して厳密に型指定された <xref:System.Data.Common.DbDataAdapter> オブジェクトを取得できます。  続いて <xref:System.Data.Common.DbCommandBuilder> を使用することで、データ ソースに対して <xref:System.Data.DataSet> のデータの挿入、更新、削除を実行するコマンドを作成できます。  
+  
+## DbDataAdapter によるデータの取得  
+ この例では、プロバイダー名と接続文字列に基づいて厳密に型指定された `DbDataAdapter` を作成する方法を示します。  このコード サンプルでは、<xref:System.Data.Common.DbProviderFactory> の <xref:System.Data.Common.DbProviderFactory.CreateConnection%2A> メソッドを使用して、<xref:System.Data.Common.DbConnection> を作成します。  次に、<xref:System.Data.Common.DbProviderFactory.CreateCommand%2A> メソッドを使用して <xref:System.Data.Common.DbCommand> を作成し、その `CommandText` プロパティと `Connection` プロパティを設定することでデータを選択します。  最後に、<xref:System.Data.Common.DbProviderFactory.CreateDataAdapter%2A> メソッドを使用して <xref:System.Data.Common.DbDataAdapter> オブジェクトを作成し、その `SelectCommand` プロパティを設定します。  `DbDataAdapter` の `Fill` メソッドにより、データが <xref:System.Data.DataTable> に読み込まれます。  
+  
+ [!code-csharp[DataWorks DbProviderFactories.DbDataAdapter#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbDataAdapter/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories.DbDataAdapter#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbDataAdapter/VB/source.vb#1)]  
+  
+## DbDataAdapter を使用したデータの変更  
+ この例では、<xref:System.Data.Common.DbCommandBuilder> を使用してデータ ソースのデータの更新に必要なコマンドを生成することで、<xref:System.Data.Common.DbDataAdapter> を使用して `DataTable` のデータを変更する方法を示します。  `DbDataAdapter` の <xref:System.Data.Common.DbDataAdapter.SelectCommand%2A> は、Customers テーブルの CustomerID と CompanyName を取得するように設定されます。  <xref:System.Data.Common.DbCommandBuilder.GetInsertCommand%2A> メソッドを使用して <xref:System.Data.Common.DbDataAdapter.InsertCommand%2A> プロパティを設定し、<xref:System.Data.Common.DbCommandBuilder.GetUpdateCommand%2A> メソッドを使用して <xref:System.Data.Common.DbDataAdapter.UpdateCommand%2A> プロパティを設定し、<xref:System.Data.Common.DbCommandBuilder.GetDeleteCommand%2A> メソッドを使用して <xref:System.Data.Common.DbDataAdapter.DeleteCommand%2A> プロパティを設定します。  Customers テーブルに新しい行が追加され、データ ソースが更新されます。  次に、CustomerID を検索して追加された行を特定します。この行が、Customers テーブルの主キーとなります。  これにより CompanyName が変更され、データ ソースが更新されます。  最後に、その行を削除します。  
+  
+ [!code-csharp[DataWorks DbProviderFactories.DbDataAdapterModify#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbDataAdapterModify/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories.DbDataAdapterModify#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.DbDataAdapterModify/VB/source.vb#1)]  
+  
+## パラメーターの処理  
+ .NET Framework のデータ プロバイダーによって、パラメーターおよびパラメーターのプレースホルダーの名前付けや指定方法が異なります。  次の表に示すように、データ ソースごとに固有の構文が採用されています。  
+  
+|データ プロバイダー|パラメーターの名前付け構文|  
+|----------------|-------------------|  
+|`SqlClient`|`@` *parametername* 形式の名前付きパラメーターが使用されます。|  
+|`OracleClient`|`:` *parmname* \(または *parmname*\) 形式の名前付きパラメーターが使用されます。|  
+|`OleDb`|疑問符 \(`?`\) で指定される位置パラメーター マーカーが使用されます。|  
+|`Odbc`|疑問符 \(`?`\) で指定される位置パラメーター マーカーが使用されます。|  
+  
+ ファクトリ モデルは、パラメーター化された `DbCommand` オブジェクトおよび `DbDataAdapter` オブジェクトの作成には利用できません。  コード内に分岐を作って、使用するデータ プロバイダーに対応したパラメーターを作成する必要があります。  
+  
+> [!IMPORTANT]
+>  プロバイダー固有のパラメーターを完全に回避するために、文字列の連結を利用して直接 SQL ステートメントを作成することは、セキュリティ上の理由から推奨されません。  パラメーターではなく文字列の連結を利用した場合、アプリケーションが SQL インジェクション攻撃に対して脆弱になります。  
+  
+## 参照  
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)   
+ [DbProviderFactory の取得](../../../../docs/framework/data/adonet/obtaining-a-dbproviderfactory.md)   
+ [DbConnection、DbCommand、および DbException](../../../../docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/modifying-data-with-stored-procedures.md b/docs/framework/data/adonet/modifying-data-with-stored-procedures.md
new file mode 100644
index 00000000000..b2576237358
--- /dev/null
+++ b/docs/framework/data/adonet/modifying-data-with-stored-procedures.md
@@ -0,0 +1,50 @@
+---
+title: "ストアド プロシージャでのデータの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d8e9a46-1af6-4a02-bf61-969d77ae07e0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ストアド プロシージャでのデータの変更
+ストアド プロシージャは、入力パラメーターとしてデータを受け取り、出力パラメーター、結果セット、または戻り値としてデータを返すことができます。  以下のサンプルでは、入力パラメーター、出力パラメーター、および戻り値が ADO.NET によってどのようにやり取りされるかを示したものです。  この例では、主キー列が SQL Server データベースの ID 列であるテーブルに新しいレコードを挿入しています。  
+  
+> [!NOTE]
+>  SQL Server のストアド プロシージャで、<xref:System.Data.SqlClient.SqlDataAdapter> を使用してデータを編集または削除する場合、ストアド プロシージャの定義に SET NOCOUNT ON は使用しないでください。  処理された行数がゼロとして返され、`DataAdapter` によって同時実行の競合として解釈されてしまいます。  この場合、<xref:System.Data.DBConcurrencyException> がスローされます。  
+  
+## 例  
+ この例では、次のストアド プロシージャを使用して、**Northwind** **Categories** テーブルに新しいカテゴリを挿入します。  このストアド プロシージャは **CategoryName** 列の値を入力パラメーターとして受け取り、SCOPE\_IDENTITY\(\) 関数を使用して ID フィールド **CategoryID** の新しい値を取得し、その値を出力パラメーター内に返します。  RETURN ステートメントは、@@ROWCOUNT 関数を使用して、挿入された行の数を返します。  
+  
+```  
+CREATE PROCEDURE dbo.InsertCategory  
+  @CategoryName nvarchar(15),  
+  @Identity int OUT  
+AS  
+INSERT INTO Categories (CategoryName) VALUES(@CategoryName)  
+SET @Identity = SCOPE_IDENTITY()  
+RETURN @@ROWCOUNT  
+```  
+  
+ 上述の `InsertCategory` ストアド プロシージャを <xref:System.Data.SqlClient.SqlDataAdapter> の <xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> のソースとして使用する例を次に示します。  `@Identity` 出力パラメーターは、<xref:System.Data.SqlClient.SqlDataAdapter> の `Update` メソッドが呼び出され、データベースにレコードが挿入された後で <xref:System.Data.DataSet> に反映されます。  戻り値も取得されます。  
+  
+> [!NOTE]
+>  <xref:System.Data.OleDb.OleDbDataAdapter> を使用する場合、**ReturnValue** の <xref:System.Data.ParameterDirection> を含むパラメーターを他のパラメーターより先に指定する必要があります。  
+  
+ [!code-csharp[DataWorks SqlClient.SprocIdentityReturn#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.SprocIdentityReturn/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.SprocIdentityReturn#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.SprocIdentityReturn/VB/source.vb#1)]  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [コマンドの実行](../../../../docs/framework/data/adonet/executing-a-command.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/navigation-property.md b/docs/framework/data/adonet/navigation-property.md
new file mode 100644
index 00000000000..ecd448e3a10
--- /dev/null
+++ b/docs/framework/data/adonet/navigation-property.md
@@ -0,0 +1,47 @@
+---
+title: "ナビゲーション プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0bf1a6a-1d84-484c-b7c3-b410fd8dc0b1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ナビゲーション プロパティ
+*ナビゲーション プロパティ*は、[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の 1 つの [End](../../../../docs/framework/data/adonet/association-end.md) から別の End へのナビゲーションを可能にする、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)の省略可能なプロパティです。  その他の[プロパティ](../../../../docs/framework/data/adonet/property.md)とは異なり、ナビゲーション プロパティはデータを伝達しません。  
+  
+ ナビゲーション プロパティの定義には、以下が含まれます。  
+  
+-   名前。  \(必須\)  
+  
+-   移動対象のアソシエーション。  \(必須\)  
+  
+-   移動対象のアソシエーションの End。  \(必須\)  
+  
+ ナビゲーション プロパティは、アソシエーション End の両方のエンティティ型で省略可能です。  1 つのアソシエーション End のエンティティ型にナビゲーション プロパティを定義した場合に、そのアソシエーションの他方の End でもエンティティ型にナビゲーション プロパティを定義する必要はありません。  
+  
+ ナビゲーション プロパティのデータ型は、リモートの[アソシエーション End](../../../../docs/framework/data/adonet/association-end.md) の[多重度](../../../../docs/framework/data/adonet/association-end-multiplicity.md)により決まります。  たとえば、ナビゲーション プロパティ `OrdersNavProp` が `Customer` エンティティ型に存在し、`Customer` と `Order` の間の一対多のアソシエーションで移動するとします。  ナビゲーション プロパティのリモートのアソシエーション End の多重度が多数 \(\*\) であるため、そのデータ型は \(`Order` の\) コレクションになります。  同様に、`Order` エンティティ型にナビゲーション プロパティ、`CustomerNavProp` が存在する場合、リモート End の多重度が \(1\) であるため、データ型は `Customer` になります。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  Book エンティティ型には、ナビゲーション プロパティ、`Publisher` および `Authors` が定義されています。  Publisher エンティティ型と `Author` エンティティ型には、ナビゲーション プロパティ、`Books` が定義されています。  
+  
+ ![ナビゲーション プロパティが含まれるモデル](../../../../docs/framework/data/adonet/media/modelwithnavprops.gif "ModelWithNavProps")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上のダイアグラムに示された `Book` エンティティ型を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#EntityExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entityexample)]  
+  
+ ナビゲーション プロパティの定義に必要な情報を伝達するために、XML 属性が使用されています。属性 `Name` にはプロパティ名が含まれ、`Relationship` には移動対象のアソシエーション名が含まれ、`FromRole` および `ToRole` にはアソシエーション End が含まれています。  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/obtaining-a-dbproviderfactory.md b/docs/framework/data/adonet/obtaining-a-dbproviderfactory.md
new file mode 100644
index 00000000000..7ad8b5aa8ea
--- /dev/null
+++ b/docs/framework/data/adonet/obtaining-a-dbproviderfactory.md
@@ -0,0 +1,106 @@
+---
+title: "DbProviderFactory の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a16e4a4d-6a5b-45db-8635-19570e4572ae
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DbProviderFactory の取得
+<xref:System.Data.Common.DbProviderFactory> を取得する過程では、データ プロバイダーに関する情報が <xref:System.Data.Common.DbProviderFactories> クラスに渡されます。  <xref:System.Data.Common.DbProviderFactories.GetFactory%2A> メソッドはこの情報に基づいて、厳密に型指定されたプロバイダー ファクトリを作成します。  たとえば、<xref:System.Data.SqlClient.SqlClientFactory> を作成するには、`GetFactory` の引数にプロバイダー名 System.Data.SqlClient を文字列として指定します。  `GetFactory` には、<xref:System.Data.DataRow> を引数として受け取るオーバーロードも存在します。  プロバイダー ファクトリを作成すると、対応するメソッドを使って他のオブジェクトを作成できるようになります。  `SqlClientFactory` のメソッドには、<xref:System.Data.SqlClient.SqlClientFactory.CreateConnection%2A>、<xref:System.Data.SqlClient.SqlClientFactory.CreateCommand%2A>、<xref:System.Data.SqlClient.SqlClientFactory.CreateDataAdapter%2A> などがあります。  
+  
+> [!NOTE]
+>  同様の機能は、.NET Framework の <xref:System.Data.OracleClient.OracleClientFactory> クラス、<xref:System.Data.Odbc.OdbcFactory> クラス、および <xref:System.Data.OleDb.OleDbFactory> クラスにも用意されています。  
+  
+## DbProviderFactory の登録  
+ ファクトリ ベースのクラスをサポートする各 .NET Framework データ プロバイダーは、ローカル コンピューターの **machine.config** ファイルの **DbProviderFactories** セクションに構成情報を登録します。  次の構成ファイル フラグメントは、<xref:System.Data.SqlClient> の構文と形式を示しています。  
+  
+```  
+<system.data>  
+  <DbProviderFactories>  
+    <add name="SqlClient Data Provider"  
+     invariant="System.Data.SqlClient"   
+     description=".Net Framework Data Provider for SqlServer"   
+     type="System.Data.SqlClient.SqlClientFactory, System.Data,   
+     Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+    />  
+  </DbProviderFactories>  
+</system.data>  
+```  
+  
+ 基になるデータ プロバイダーは **invariant** 属性によって識別されます。  この 3 つの部分から成る命名構文は、新しいファクトリを作成するときのほか、プロバイダー名とそれに関連付けられた接続文字列を実行時に取得できるようにするために、アプリケーションの構成ファイルでプロバイダーを指定するときにも使用されます。  
+  
+## プロバイダー情報の取得  
+ <xref:System.Data.Common.DbProviderFactories.GetFactoryClasses%2A> メソッドを使用すると、ローカル コンピューターにインストールされているすべてのデータ プロバイダーに関する情報を取得できます。  このメソッドは、**DbProviderFactories** という名前の <xref:System.Data.DataTable> を返します。このテーブルに含まれる列を次の表に示します。  
+  
+|列の序数|列名|サンプルの出力|説明|  
+|----------|--------|-------------|--------|  
+|0|**名前**|SqlClient Data Provider|データ プロバイダーの読み取り可能な名前|  
+|1|**説明**|.Net Framework Data Provider for SqlServer|データ プロバイダーの読み取り可能な説明|  
+|2|**InvariantName**|System.Data.SqlClient|プログラムでデータ プロバイダーの参照に使用できる名前|  
+|3|**AssemblyQualifiedName**|System.Data.SqlClient.SqlClientFactory, System.Data, Version\=2.0.0.0, Culture\=neutral, PublicKeyToken\=b77a5c561934e089|オブジェクトをインスタンス化するための十分な情報を保持している、ファクトリ クラスの完全修飾名|  
+  
+ この `DataTable` を使用して、ユーザーに実行時に <xref:System.Data.DataRow> を選択してもらうことができます。  次に、選択された `DataRow` を <xref:System.Data.Common.DbProviderFactories.GetFactory%2A> メソッドに渡すことで、厳密に型指定された <xref:System.Data.Common.DbProviderFactory> を作成できます。  選択された <xref:System.Data.DataRow> を `GetFactory` メソッドに渡すことによって、目的の `DbProviderFactory` オブジェクトを作成できます。  
+  
+## インストールされているプロバイダー ファクトリ クラスの一覧表示  
+ 次の例では、インストールされているプロバイダーの情報を含んだ <xref:System.Data.DataTable> を、<xref:System.Data.Common.DbProviderFactories.GetFactoryClasses%2A> メソッドを使用して取得します。  このコードは、`DataTable` 内の各行を反復処理しながら、インストールされている各プロバイダーの情報をコンソール ウィンドウに表示します。  
+  
+ [!code-csharp[DataWorks DbProviderFactories#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories/VB/source.vb#1)]  
+  
+## アプリケーション構成ファイルを使用したファクトリ情報の保存  
+ ファクトリを使用したデザイン パターンでは、プロバイダーや接続文字列の情報をアプリケーション構成ファイルに保存する必要があります。たとえば、Windows アプリケーションの場合は **app.config** に、ASP.NET アプリケーションの場合は **web.config** に、これらの情報を保存することになります。  
+  
+ 次の構成ファイル フラグメントは、2 つの名前付き接続文字列 \(SQL Server の Northwind データベースに接続するための "NorthwindSQL" と、Access\/Jet の Northwind データベースに接続するための "NorthwindAccess"\) を保存する例を示したものです。  **providerName** 属性には不変名が使用されています。  
+  
+```  
+<configuration>  
+  <connectionStrings>  
+    <clear/>  
+    <add name="NorthwindSQL"   
+     providerName="System.Data.SqlClient"   
+     connectionString=  
+     "Data Source=MSSQL1;Initial Catalog=Northwind;Integrated Security=true"  
+    />  
+  
+    <add name="NorthwindAccess"   
+     providerName="System.Data.OleDb"   
+     connectionString=  
+     "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Data\Northwind.mdb;"  
+    />  
+  </connectionStrings>  
+</configuration>  
+```  
+  
+### プロバイダー名による接続文字列の取得  
+ プロバイダー ファクトリを作成するには、プロバイダー名だけでなく接続文字列も指定する必要があります。  次の例では、プロバイダー名を *System.Data.ProviderName* という不変名で渡すことによってアプリケーション構成ファイルから接続文字列を取得します。  このコードでは、<xref:System.Configuration.ConnectionStringSettingsCollection> を反復処理しています。  成功した場合には <xref:System.Configuration.ConnectionStringSettings.ProviderName%2A> が、それ以外の場合は `null` \(Visual Basic の場合は `Nothing`\) が返されます。  プロバイダーに複数のエントリが存在した場合は、最初に見つかったエントリが返されます。  構成ファイルからの接続文字列の取得およびその例については、「[接続文字列と構成ファイル](../../../../docs/framework/data/adonet/connection-strings-and-configuration-files.md)」を参照してください。  
+  
+> [!NOTE]
+>  このコードを実行するには、`System.Configuration.dll` を参照設定する必要があります。  
+  
+ [!code-csharp[DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider/CS/source.cs#1)]
+ [!code-vb[DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks ConnectionStringSettings.RetrieveFromConfigByProvider/VB/source.vb#1)]  
+  
+## DbProviderFactory および DbConnection の作成  
+ 次の例は、*System.Data.ProviderName* 形式のプロバイダー名と接続文字列を引数として渡すことによって、<xref:System.Data.Common.DbProviderFactory> および <xref:System.Data.Common.DbConnection> オブジェクトを作成する方法を示しています。  成功した場合には `DbConnection` オブジェクトが返されます。エラーが発生した場合は `null` \(Visual Basic の場合は `Nothing`\) が返されます。  
+  
+ このコードでは、<xref:System.Data.Common.DbProviderFactories.GetFactory%2A> を呼び出すことによって `DbProviderFactory` を取得しています。  次に、<xref:System.Data.Common.DbProviderFactory.CreateConnection%2A> メソッドで <xref:System.Data.Common.DbConnection> オブジェクトを作成し、<xref:System.Data.Common.DbConnection.ConnectionString%2A> プロパティに接続文字列を設定します。  
+  
+ [!code-csharp[DataWorks DbProviderFactories.GetFactory#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.GetFactory/CS/source.cs#1)]
+ [!code-vb[DataWorks DbProviderFactories.GetFactory#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks DbProviderFactories.GetFactory/VB/source.vb#1)]  
+  
+## 参照  
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)   
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)   
+ [Using the Configuration Classes](../Topic/Using%20the%20Configuration%20Classes.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/obtaining-a-single-value-from-a-database.md b/docs/framework/data/adonet/obtaining-a-single-value-from-a-database.md
new file mode 100644
index 00000000000..c9bc0ec97e1
--- /dev/null
+++ b/docs/framework/data/adonet/obtaining-a-single-value-from-a-database.md
@@ -0,0 +1,31 @@
+---
+title: "データベースからの単一の値の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b38526cd-a62a-48cb-822a-e91dfa68e02d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# データベースからの単一の値の取得
+テーブルやデータ ストリームの形式ではなく、単に 1 つの値をデータベース情報として返すことが必要な場合があります。  たとえば、COUNT\(\*\)、SUM\(Price\)、AVG\(Quantity\) などの集約関数の結果を返す場合です。  **Command** オブジェクトは、**ExecuteScalar** メソッドを使用して単一の値を返す機能を提供します。  **ExecuteScalar** メソッドは、結果セットの 1 行目の 1 列目の値をスカラー値として返します。  
+  
+ <xref:System.Data.SqlClient.SqlCommand> を使用して新しい値をデータベースに挿入するコード サンプルを次に示します。  挿入したレコードの ID 列の値を取得するために、<xref:System.Data.SqlClient.SqlCommand.ExecuteScalar%2A> メソッドが使用されています。  
+  
+ [!code-csharp[DataWorks SqlCommand.ExecuteScalar#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlCommand.ExecuteScalar/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlCommand.ExecuteScalar#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlCommand.ExecuteScalar/VB/source.vb#1)]  
+  
+## 参照  
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [コマンドの実行](../../../../docs/framework/data/adonet/executing-a-command.md)   
+ [DbConnection、DbCommand、および DbException](../../../../docs/framework/data/adonet/dbconnection-dbcommand-and-dbexception.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/odbc-data-type-mappings.md b/docs/framework/data/adonet/odbc-data-type-mappings.md
new file mode 100644
index 00000000000..9a47462ebda
--- /dev/null
+++ b/docs/framework/data/adonet/odbc-data-type-mappings.md
@@ -0,0 +1,47 @@
+---
+title: "ODBC データ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 43c35d32-831d-480f-a150-78f7e869d17f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ODBC データ型のマッピング
+.NET Framework Data Provider for ODBC \(<xref:System.Data.Odbc>\) のデータ型から推論される [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型を次の表に示します。  <xref:System.Data.Odbc.OdbcDataReader> の型指定されたアクセサー メソッドも示します。  
+  
+|ODBC 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型指定されたアクセサー|  
+|------------|-------------------------------------------------------------------|------------------------------------------------------------------------------|  
+|SQL\_BIGINT|Int64|GetInt64\(\)|  
+|SQL\_BINARY|Byte\[\]|GetBytes\(\)|  
+|SQL\_BIT|Boolean|GetBoolean\(\)|  
+|SQL\_CHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|  
+|SQL\_DECIMAL|Decimal \(10 進数型\)|GetDecimal\(\)|  
+|SQL\_DOUBLE|Double \(倍精度浮動小数点型\)|GetDouble\(\)|  
+|SQL\_GUID|Guid|GetGuid\(\)|  
+|SQL\_INTEGER|Int32|GetInt32\(\)|  
+|SQL\_LONG\_VARCHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|  
+|SQL\_LONGVARBINARY|Byte\[\]|GetBytes\(\)|  
+|SQL\_NUMERIC|Decimal \(10 進数型\)|GetDecimal\(\)|  
+|SQL\_REAL|Single|GetFloat\(\)|  
+|SQL\_SMALLINT|Int16|GetInt16\(\)|  
+|SQL\_TINYINT|Byte|GetByte\(\)|  
+|SQL\_TYPE\_TIMES|DateTime|GetDateTime\(\)|  
+|SQL\_TYPE\_TIMESTAMP|DateTime|GetDateTime\(\)|  
+|SQL\_VARBINARY|Byte\[\]|GetBytes\(\)|  
+|SQL\_WCHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|  
+|SQL\_WLONGVARCHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|  
+|SQL\_WVARCHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/odbc-schema-collections.md b/docs/framework/data/adonet/odbc-schema-collections.md
new file mode 100644
index 00000000000..4e5ced895f5
--- /dev/null
+++ b/docs/framework/data/adonet/odbc-schema-collections.md
@@ -0,0 +1,343 @@
+---
+title: "ODBC スキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bb126a5-ceec-4649-a4bc-8aa19e801046
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ODBC スキーマ コレクション
+ここでは、Microsoft SQL Server、Oracle、および Microsoft Jet 用の各 ODBC ドライバーでのスキーマ コレクションのサポートについて説明します。  
+  
+## Microsoft SQL Server ODBC Driver  
+ Microsoft SQL Server ODBC Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   Indexes  
+  
+-   列  
+  
+-   手順  
+  
+-   ProcedureColumns  
+  
+-   ProcedureParameters  
+  
+-   ビュー  
+  
+### Tables と Views  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CAT|String|  
+|TABLE\_SCHEM|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|REMARKS|String|  
+  
+### Indexes  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CAT|String|  
+|TABLE\_SCHEM|String|  
+|TABLE\_NAME|String|  
+|NON\_UNIQUE|Int16|  
+|INDEX\_QUALIFIER|String|  
+|INDEX\_NAME|String|  
+|TYPE|Int16|  
+|ORDINAL\_POSITION|Int16|  
+|COLUMN\_NAME|String|  
+|ASC\_OR\_DESC|String|  
+|CARDINATLITY|Int32|  
+|PAGES|Int32|  
+|FILTER\_CONDITION|String|  
+|SS\_TYPE\_SCHEMA|String|  
+|SS\_DATA\_TYPE|Byte|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CAT|String|  
+|TABLE\_SCHEM|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|COLUMN\_SIZE|Int32|  
+|BUFFER\_LENGTH|Int32|  
+|DECIMAL\_DIGITS|Int16|  
+|NUM\_PREC\_RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|COLUMN\_DEF|String|  
+|SQL\_DATA\_TYPE|Int16|  
+|SQL\_DATETIME\_SUB|Int16|  
+|CHAR\_OCTET\_LENGTH|Int32|  
+|ORDINAL\_POSITION|Int32|  
+|IS\_NULLABLE|String|  
+|SS\_TYPE\_CATALOG|String|  
+|SS\_TYPE\_SCHEMA|String|  
+|SS\_DATA\_TYPE|Byte|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CAT|String|  
+|PROCEDURE\_SCHEM|String|  
+|PROCEDURE\_NAME|String|  
+|NUM\_INPUT\_PARAMS|Int32|  
+|NUM\_OUTPUT\_PARAMS|Int32|  
+|NUM\_RESULT\_SETS|Int32|  
+|REMARKS|String|  
+|PROCEDURE\_TYPE|Int16|  
+  
+### ProcedureColumns  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CAT|String|  
+|PROCEDURE\_SCHEM|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_TYPE|Int16|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|COLUMN\_SIZE|Int32|  
+|BUFFER\_LENGTH|Int32|  
+|DECIMAL\_DIGITS|Int16|  
+|NUM\_PREC\_RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|COLUMN\_DEF|String|  
+|SQL\_DATA\_TYPE|Int16|  
+|SQL\_DATETIME\_SUB|Int16|  
+|CHAR\_OCTET\_LENGTH|Int32|  
+|ORDINAL\_POSITION|Int32|  
+|IS\_NULLABLE|String|  
+|SS\_TYPE\_CATALOG|String|  
+|SS\_TYPE\_SCHEMA|String|  
+|SS\_DATA\_TYPE|Byte|  
+  
+### ProcedureParameters  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CAT|String|  
+|PROCEDURE\_SCHEM|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_TYPE|Int16|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|COLUMN\_SIZE|Int32|  
+|BUFFER\_LENGTH|Int32|  
+|DECIMAL\_DIGITS|Int16|  
+|NUM\_PREC\_RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|COLUMN\_DEF|String|  
+|SQL\_DATA\_TYPE|Int16|  
+|SQL\_DATETIME\_SUB|Int16|  
+|CHAR\_OCTET\_LENGTH|Int32|  
+|ORDINAL\_POSITION|Int32|  
+|IS\_NULLABLE|String|  
+|SS\_TYPE\_CATALOG|String|  
+|SS\_TYPE\_SCHEMA|String|  
+|SS\_DATA\_TYPE|Byte|  
+  
+## Microsoft Oracle ODBC Driver  
+ Microsoft SQL Server Oracle ODBC Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   列  
+  
+-   手順  
+  
+-   ProcedureColumns  
+  
+-   ProcedureParameters  
+  
+-   ビュー  
+  
+-   Indexes  
+  
+### Tables と Views  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_QUALIFIER|String|  
+|TABLE\_OWNER|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|REMARKS|String|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_QUALIFIER|String|  
+|TABLE\_OWNER|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|PRECISION|Int32|  
+|LENGTH|Int32|  
+|SCALE|Int16|  
+|RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|ORDINAL\_POSITION|Int32|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_QUALIFIER|String|  
+|PROCEDURE\_OWNER|String|  
+|PROCEDURE\_NAME|String|  
+|NUM\_INPUT\_PARAMS|Int16|  
+|NUM\_OUTPUT\_PARAMS|Int16|  
+|NUM\_RESULT\_SETS|Int16|  
+|REMARKS|String|  
+|PROCEDURE\_TYPE|Int16|  
+  
+### ProcedureColumns  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_QUALIFIER|String|  
+|PROCEDURE\_OWNER|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_TYPE|Int16|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|PRECISION|Int32|  
+|LENGTH|Int32|  
+|SCALE|Int16|  
+|RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|OVERLOAD|Int32|  
+|ORDINAL\_POSITION|Int32|  
+  
+## Microsoft Jet ODBC Driver  
+ Microsoft Jet ODBC Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   Indexes  
+  
+-   列  
+  
+-   手順  
+  
+-   ProcedureColumns  
+  
+-   ProcedureParameters  
+  
+-   ビュー  
+  
+### Tables と Views  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_QUALIFIER|String|  
+|TABLE\_OWNER|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|REMARKS|String|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_QUALIFIER|String|  
+|TABLE\_OWNER|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|PRECISION|Int32|  
+|LENGTH|Int32|  
+|SCALE|Int16|  
+|RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|ORDINAL\_POSITION|Int32|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_QUALIFIER|String|  
+|PROCEDURE\_OWNER|String|  
+|PROCEDURE\_NAME|String|  
+|NUM\_INPUT\_PARAMS|Int16|  
+|NUM\_OUTPUT\_PARAMS|Int16|  
+|NUM\_RESULT\_SETS|Int16|  
+|REMARKS|String|  
+|PROCEDURE\_TYPE|Int16|  
+  
+### ProcedureColumns  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_QUALIFIER|String|  
+|PROCEDURE\_OWNER|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_TYPE|Int16|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|PRECISION|Int32|  
+|LENGTH|Int32|  
+|SCALE|Int16|  
+|RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|OVERLOAD|Int32|  
+|ORDINAL\_POSITION|Int32|  
+  
+### ProcedureParameters  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CAT|String|  
+|PROCEDURE\_SCHEM|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_TYPE|Int16|  
+|DATA\_TYPE|Int16|  
+|TYPE\_NAME|String|  
+|COLUMN\_SIZE|Int32|  
+|BUFFER\_LENGTH|Int32|  
+|DECIMAL\_DIGITS|Int16|  
+|NUM\_PREC\_RADIX|Int16|  
+|NULLABLE|Int16|  
+|REMARKS|String|  
+|COLUMN\_DEF|String|  
+|SQL\_DATA\_TYPE|Int16|  
+|SQL\_DATETIME\_SUB|Int16|  
+|CHAR\_OCTET\_LENGTH|Int32|  
+|ORDINAL\_POSITION|Int32|  
+|IS\_NULLABLE|String|  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ole-db-data-type-mappings.md b/docs/framework/data/adonet/ole-db-data-type-mappings.md
new file mode 100644
index 00000000000..a4a94d0b1ec
--- /dev/null
+++ b/docs/framework/data/adonet/ole-db-data-type-mappings.md
@@ -0,0 +1,61 @@
+---
+title: "OLE DB データ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04bcb259-59d3-4fd7-894d-4f0dd0c68069
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# OLE DB データ型のマッピング
+.NET Framework Data Provider for ADO および OLE DB \(<xref:System.Data.OleDb>\) のデータ型から推論される [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型を次の表に示します。  <xref:System.Data.OleDb.OleDbDataReader> の型指定されたアクセサー メソッドも示します。  
+  
+|ADO 型|OLE DB 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型指定されたアクセサー|  
+|-----------|--------------|-------------------------------------------------------------------|------------------------------------------------------------------------------|  
+|adBigInt|DBTYPE\_I8|Int64|GetInt64\(\)|  
+|adBinary|DBTYPE\_BYTES|Byte\[\]|GetBytes\(\)|  
+|adBoolean|DBTYPE\_BOOL|Boolean|GetBoolean\(\)|  
+|adBSTR|DBTYPE\_BSTR|String|GetString\(\)|  
+|adChapter|DBTYPE\_HCHAPTER|`DataReader` によってサポートされます。  「[DataReader によるデータの取得](../../../../docs/framework/data/adonet/retrieving-data-using-a-datareader.md)」を参照してください。|GetValue\(\)|  
+|adChar|DBTYPE\_STR|String|GetString\(\)|  
+|adCurrency|DBTYPE\_CY|Decimal \(10 進数型\)|GetDecimal\(\)|  
+|adDate|DBTYPE\_DATE|DateTime|GetDateTime\(\)|  
+|adDBDate|DBTYPE\_DBDATE|DateTime|GetDateTime\(\)|  
+|adDBTime|DBTYPE\_DBTIME|DateTime|GetDateTime\(\)|  
+|adDBTimeStamp|DBTYPE\_DBTIMESTAMP|DateTime|GetDateTime\(\)|  
+|adDecimal|DBTYPE\_DECIMAL|Decimal \(10 進数型\)|GetDecimal\(\)|  
+|adDouble|DBTYPE\_R8|Double \(倍精度浮動小数点型\)|GetDouble\(\)|  
+|adError|DBTYPE\_ERROR|ExternalException|GetValue\(\)|  
+|adFileTime|DBTYPE\_FILETIME|DateTime|GetDateTime\(\)|  
+|adGUID|DBTYPE\_GUID|Guid|GetGuid\(\)|  
+|adIDispatch|DBTYPE\_IDISPATCH \*|Object|GetValue\(\)|  
+|adInteger|DBTYPE\_I4|Int32|GetInt32\(\)|  
+|adIUnknown|DBTYPE\_IUNKNOWN \*|Object|GetValue\(\)|  
+|adNumeric|DBTYPE\_NUMERIC|Decimal \(10 進数型\)|GetDecimal\(\)|  
+|adPropVariant|DBTYPE\_PROPVARIANT|Object|GetValue\(\)|  
+|adSingle|DBTYPE\_R4|Single|GetFloat\(\)|  
+|adSmallInt|DBTYPE\_I2|Int16|GetInt16\(\)|  
+|adTinyInt|DBTYPE\_I1|Byte|GetByte\(\)|  
+|adUnsignedBigInt|DBTYPE\_UI8|UInt64|GetValue\(\)|  
+|adUnsignedInt|DBTYPE\_UI4|UInt32|GetValue\(\)|  
+|adUnsignedSmallInt|DBTYPE\_UI2|UInt16|GetValue\(\)|  
+|adUnsignedTinyInt|DBTYPE\_UI1|Byte|GetByte\(\)|  
+|adVariant|DBTYPE\_VARIANT|Object|GetValue\(\)|  
+|adWChar|DBTYPE\_WSTR|String|GetString\(\)|  
+|adUserDefined|DBTYPE\_UDT|サポート外||  
+|adVarNumeric|DBTYPE\_VARNUMERIC|サポート外||  
+  
+ \* OLE DB の `DBTYPE_IUNKNOWN` 型および `DBTYPE_IDISPATCH` 型の場合、オブジェクト参照はポインターのマーシャリングされた表現です。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md b/docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md
new file mode 100644
index 00000000000..3b68121c72a
--- /dev/null
+++ b/docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md
@@ -0,0 +1,83 @@
+---
+title: "OLE DB、ODBC、および Oracle 接続プール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2bd83b1e-3ea9-43c4-bade-d9cdb9bbbb04
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OLE DB、ODBC、および Oracle 接続プール
+接続をプールすると、アプリケーションのパフォーマンスとスケーラビリティを大幅に改善できます。  このセクションでは、OLE DB、ODBC、および Oracle 用の .NET Framework データ プロバイダーの接続プールについて説明します。  
+  
+## OleDb の接続プール  
+ .NET Framework Data Provider for OLE DB は、OLE DB セッションのプール機能を使用して接続を自動的にプールします。  接続文字列引数を使用して、プール機能を含む OLE DB サービスの有効や無効を切り替えることができます。  たとえば、次の接続文字列は OLE DB セッション プール機能と自動的なトランザクションへの参加を無効にします。  
+  
+```  
+Provider=SQLOLEDB;OLE DB Services=-4;Data Source=localhost;Integrated Security=SSPI;  
+```  
+  
+ 接続がプールに返されるようにするために、接続を使い終えたら必ず接続を終了または破棄することをお勧めします。  明示的に終了されていない接続は、プールに返されない場合があります。  たとえば、スコープ外に出ても、明示的に終了されていない接続は、最大プール サイズに達した時点でその接続がまだ有効である場合にだけ接続プールに返されます。  
+  
+ OLE DB セッション プール機能とリソース プール機能の説明、および OLE DB プロバイダー サービスの既定値をオーバーライドしてプール機能を無効にする方法については、MSDN ライブラリにある「[OLE DB プログラマ ガイド](http://go.microsoft.com/fwlink/?linkid=45232)」を参照してください。  
+  
+## Odbc の接続プール  
+ .NET Framework Data Provider for ODBC の接続プールは、接続に使用される ODBC ドライバー マネージャーによって管理されるため、.NET Framework Data Provider for ODBC の影響は受けません。  
+  
+ 接続プール機能を有効または無効にするには、\[コントロール パネル\] の \[管理ツール\] フォルダーにある **\[ODBC データ ソース アドミニストレーター\]** を開きます。  **\[接続プール\]** タブで、インストールされている各 ODBC ドライバーに対する接続プール パラメーターを指定できます。  ODBC ドライバーの接続プールを変更すると、その ODBC ドライバーを使用するすべてのアプリケーションに影響します。  
+  
+ ODBC 接続プールの詳細については、MSDN ライブラリにある「[情報: よく寄せられる質問 ODBC 接続プーリング](http://support.microsoft.com/kb/169470)」を参照してください。  
+  
+## OracleClient の接続プール  
+ Oracle の .NET データ プロバイダーは ADO.NET クライアント アプリケーションに自動的に接続プールを提供します。  また、接続プール機能の動作を制御する接続文字列修飾子を指定することもできます \(このトピックの後の「接続文字列キーワードによる接続プールの制御」を参照してください\)。  
+  
+### プールの作成と割り当て  
+ 接続が開かれると、厳密一致のアルゴリズムに基づいて接続プールが作成され、接続内の接続文字列に関連付けられます。  各接続プールが別の接続文字列に関連付けられます。  新しい接続が開かれたとき、接続文字列が既存のプールと完全に一致しない場合は、新しいプールが作成されます。  
+  
+ 接続プールは一度作成されるとアクティブなプロセスが終了するまで破棄されません。  アクティブでないプールまたは空のプールの維持には、システム リソースはほとんど使用されません。  
+  
+### 接続の追加  
+ 一意の接続文字列ごとに 1 つの接続プールが作成されます。  プールが作成された段階で、複数の接続オブジェクトが作成されてそのプールへ追加され、最小プール サイズ要件を満たします。  必要に応じて、最大プール サイズに達するまで、接続がプールへ追加されます。  
+  
+ <xref:System.Data.OracleClient.OracleConnection> オブジェクトが要求されたとき、プールに使用可能な接続がある場合はプールから取得されます。  使用可能な接続とは、サーバーへの有効なリンクを持つ接続のうち、現在使用中でないか、一致するトランザクション コンテキストを持っているか、またはどのトランザクション コンテキストにも関連付けられていない接続のことです。  
+  
+ 最大プール サイズに達すると、使用可能な接続を取得できなくなり、要求はキューに置かれます。  接続プーラーは、接続がプールに解放されたときに接続の再割り当てを行ってそれらの要求に応えます。  接続が終了または破棄されると、その接続は解放され、プールに戻されます。  
+  
+### 接続の削除  
+ 接続が長時間アイドル状態のとき、またはサーバーとの接続が切断されているのを検出したときに、接続プーラーはプールから接続を削除します。  この作業を実行できるのは、サーバーとの通信を試みた後だけです。  接続がサーバーに接続していないことがわかると、その接続は無効としてマークされます。  接続プーラーは、定期的に接続プールをスキャンし、プールから解放して無効としてマークするオブジェクトを検索します。  その後、それらの接続は永久に削除されます。  
+  
+ 既に存在しないサーバーへの接続が存在する場合は、接続プーラーが、その接続が切断されていることをまだ検出せず、無効というマークを付けていない状況のときに、プールからその接続を削除できます。  このような状況が発生したときは、例外が生成されます。  ただし、その場合も開発者は接続を終了して解放し、プールへ返す必要があります。  
+  
+ クラスの `Finalize` メソッド内で `Connection`、`DataReader`、またはその他のマネージ オブジェクトの `Close` または `Dispose` を呼び出さないでください。  終了処理では、クラスに直接所有されているアンマネージ リソースだけを解放してください。  クラスがアンマネージ リソースを所有していない場合は、クラス定義に `Finalize` メソッドを含めないでください。  詳細については、「[Garbage Collection](../../../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+### トランザクションのサポート  
+ 接続はプールから取り出され、トランザクション コンテキストに基づいて割り当てられます。  要求スレッドのコンテキストと割り当てられた接続は一致している必要があります。  したがって、各接続プールは、実際にはトランザクション コンテキストに関連付けられていない接続の部分と、それぞれが特定のトランザクション コンテキストに関連付けられている接続を含む *N* 個の部分に分かれています。  
+  
+ 接続が終了すると、その接続は解放されてプールへ返り、さらに、そのトランザクション コンテキストに基づいて特定のサブプールへ返ります。  そのため、分散トランザクションが保留状態である場合を含め、エラーを発生させることなく、開発者が接続を終了させることは可能です。  これにより、分散トランザクションを後でコミットまたはアボートできます。  
+  
+### 接続文字列キーワードによる接続プールの制御  
+ <xref:System.Data.OracleClient.OracleConnection> オブジェクトの <xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A> プロパティは、接続プール ロジックの動作を調整するために使用できる接続文字列キーおよび値のペアをサポートします。  
+  
+ 接続プールの動作を調整するための <xref:System.Data.OracleClient.OracleConnection.ConnectionString%2A> 値についての説明を次の表に示します。  
+  
+|名前|既定値|説明|  
+|--------|---------|--------|  
+|`Connection Lifetime`|0|接続がプールに返された時点で、その接続の作成時刻と現在の時刻を比較し、その時間の長さ \(秒\) が `Connection Lifetime` で指定した値を超えている場合は、その接続が破棄されます。  これは、クラスター構成を採用している状況で、実行中のサーバーと、オンラインになったばかりのサーバーの間での、負荷を強制的に分散するのに便利です。<br /><br /> 値ゼロ \(0\) を指定した場合は、プールされている接続に、最大のタイムアウトが割り当てられます。|  
+|`Enlist`|'true'|`true` に設定すると、トランザクション コンテキストが存在する場合、プーラーは自動的に、作成スレッドの現在のトランザクション コンテキストの中に、その接続を参加させます。|  
+|`Max Pool Size`|100|プールに格納できる最大接続数。|  
+|`Min Pool Size`|0|プールで維持できる最小接続数。|  
+|`Pooling`|'true'|`true` に設定すると、接続が適切なプールから取り出されるか、または必要に応じて作成され、適切なプールに追加されます。|  
+  
+## 参照  
+ [接続プール](../../../../docs/framework/data/adonet/connection-pooling.md)   
+ [ADO.NET でのパフォーマンス カウンター](../../../../docs/framework/data/adonet/performance-counters.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ole-db-schema-collections.md b/docs/framework/data/adonet/ole-db-schema-collections.md
new file mode 100644
index 00000000000..92571f0d0c4
--- /dev/null
+++ b/docs/framework/data/adonet/ole-db-schema-collections.md
@@ -0,0 +1,422 @@
+---
+title: "OLE DB スキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6380c36b-658e-4d67-91e8-7131ef4a7c2c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OLE DB スキーマ コレクション
+ここでは、Microsoft SQL Server、Oracle、および Microsoft Jet 用の各 OLE DB プロバイダーでのスキーマ コレクションのサポートについて説明します。  
+  
+## Microsoft SQL Server OLE DB Provider  
+ Microsoft SQL Server OLE DB Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   列  
+  
+-   手順  
+  
+-   ProcedureParameters  
+  
+-   Catalog  
+  
+-   Indexes  
+  
+### \[テーブル\]  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|TABLE\_GUID|Guid|  
+|DESCRIPTION|String|  
+|TABLE\_PROPID|Int64|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_HASDEFAULT|Boolean|  
+|COLUMN\_DEFAULT|String|  
+|COLUMN\_FLAGS|Int64|  
+|IS\_NULLABLE|Boolean|  
+|DATA\_TYPE|Int32|  
+|TYPE\_GUID|Guid|  
+|CHARACTER\_MAXIMUM\_LENGTH|Int64|  
+|CHARACTER\_OCTET\_LENGTH|Int64|  
+|NUMERIC\_PRECISION|Int32|  
+|NUMERIC\_SCALE|Int16|  
+|DATETIME\_PRECISION|Int64|  
+|CHARACTER\_SET\_CATALOG|String|  
+|CHARACTER\_SET\_SCHEMA|String|  
+|CHARACTER\_SET\_NAME|String|  
+|COLLATION\_CATALOG|String|  
+|COLLATION\_SCHEMA|String|  
+|COLLATION\_NAME|String|  
+|DOMAIN\_CATALOG|String|  
+|DOMAIN\_SCHEMA|String|  
+|DOMAIN\_NAME|String|  
+|DESCRIPTION|String|  
+|COLUMN\_LCID|Int32|  
+|COLUMN\_COMPFLAGS|Int32|  
+|COLUMN\_SORTID|Int32|  
+|COLUMN\_TDSCOLLATION|Byte\[\]|  
+|IS\_COMPUTED|Boolean|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CATALOG|String|  
+|PROCEDURE\_SCHEMA|String|  
+|PROCEDURE\_NAME|String|  
+|PROCEDURE\_TYPE|Int16|  
+|PROCEDURE\_DEFINITION|String|  
+|DESCRIPTION|String|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### ProcedureParameters  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CATALOG|String|  
+|PROCEDURE\_SCHEMA|String|  
+|PROCEDURE\_NAME|String|  
+|PARAMETER\_NAME|String|  
+|ORDINAL\_POSITION|Int32|  
+|PARAMETER\_TYPE|Int32|  
+|PARAMETER\_HASDEFAULT|Boolean|  
+|PARAMETER\_DEFAULT|String|  
+|IS\_NULLABLE|Boolean|  
+|DATA\_TYPE|Int32|  
+|CHARACTER\_MAXIMUM\_LENGTH|Int64|  
+|CHARACTER\_OCTET\_LENGTH|Int64|  
+|NUMERIC\_PRECISION|Int32|  
+|NUMERIC\_SCALE|Int16|  
+|DESCRIPTION|String|  
+|TYPE\_NAME|String|  
+|LOCAL\_TYPE\_NAME|String|  
+  
+### Catalog  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|CATALOG\_NAME|String|  
+|DESCRIPTION|String|  
+  
+### Indexes  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|INDEX\_CATALOG|String|  
+|INDEX\_SCHEMA|String|  
+|INDEX\_NAME|String|  
+|PRIMARY\_KEY|Boolean|  
+|UNIQUE|Boolean|  
+|CLUSTERED|Boolean|  
+|TYPE|Int32|  
+|FILL\_FACTOR|Int32|  
+|INITIAL\_SIZE|Int32|  
+|NULLS|Int32|  
+|SORT\_BOOKMARKS|Boolean|  
+|AUTO\_UPDATE|Boolean|  
+|NULL\_COLLATION|Int32|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|COLLATION|Int16|  
+|CARDINALITY|Decimal \(10 進数型\)|  
+|PAGES|Int32|  
+|FILTER\_CONDITION|String|  
+|INTEGRATED|Boolean|  
+  
+## Microsoft Oracle OLE DB Provider  
+ Microsoft Oracle OLE DB Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   列  
+  
+-   手順  
+  
+-   ProcedureColumns  
+  
+-   ProcedureParameters  
+  
+-   ビュー  
+  
+-   Indexes  
+  
+### \[テーブル\]  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|TABLE\_GUID|Guid|  
+|DESCRIPTION|String|  
+|TABLE\_PROPID|Int64|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_HASDEFAULT|Boolean|  
+|COLUMN\_DEFAULT|String|  
+|COLUMN\_FLAGS|Int64|  
+|IS\_NULLABLE|Boolean|  
+|DATA\_TYPE|Int32|  
+|TYPE\_GUID|Guid|  
+|CHARACTER\_MAXIMUM\_LENGTH|Int64|  
+|CHARACTER\_OCTET\_LENGTH|Int64|  
+|NUMERIC\_PRECISION|Int32|  
+|NUMERIC\_SCALE|Int16|  
+|DATETIME\_PRECISION|Int64|  
+|CHARACTER\_SET\_CATALOG|String|  
+|CHARACTER\_SET\_SCHEMA|String|  
+|CHARACTER\_SET\_NAME|String|  
+|COLLATION\_CATALOG|String|  
+|COLLATION\_SCHEMA|String|  
+|COLLATION\_NAME|String|  
+|DOMAIN\_CATALOG|String|  
+|DOMAIN\_SCHEMA|String|  
+|DOMAIN\_NAME|String|  
+|DESCRIPTION|String|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CATALOG|String|  
+|PROCEDURE\_SCHEMA|String|  
+|PROCEDURE\_NAME|String|  
+|PROCEDURE\_TYPE|Int16|  
+|PROCEDURE\_DEFINITION|String|  
+|DESCRIPTION|String|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### ProcedureColumns  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CATALOG|String|  
+|PROCEDURE\_SCHEMA|String|  
+|PROCEDURE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|ROWSET\_NUMBER|Int64|  
+|ORDINAL\_POSITION|Int64|  
+|IS\_NULLABLE|Boolean|  
+|DATA\_TYPE|Int32|  
+|TYPE\_GUID|Guid|  
+|CHARACTER\_MAXIMUM\_LENGTH|Int64|  
+|CHARACTER\_OCTET\_LENGTH|Int64|  
+|NUMERIC\_PRECISION|Int32|  
+|NUMERIC\_SCALE|Int16|  
+|DESCRIPTION|String|  
+|OVERLOAD|Int16|  
+  
+### ビュー  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|VIEW\_DEFINITION|String|  
+|CHECK\_OPTION|Boolean|  
+|IS\_UPDATABLE|Boolean|  
+|DESCRIPTION|String|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### Indexes  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|INDEX\_CATALOG|String|  
+|INDEX\_SCHEMA|String|  
+|INDEX\_NAME|String|  
+|PRIMARY\_KEY|Boolean|  
+|UNIQUE|Boolean|  
+|CLUSTERED|Boolean|  
+|TYPE|Int32|  
+|FILL\_FACTOR|Int32|  
+|INITIAL\_SIZE|Int32|  
+|NULLS|Int32|  
+|SORT\_BOOKMARKS|Boolean|  
+|AUTO\_UPDATE|Boolean|  
+|NULL\_COLLATION|Int32|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|COLLATION|Int16|  
+|CARDINALITY|Decimal \(10 進数型\)|  
+|PAGES|Int32|  
+|FILTER\_CONDITION|String|  
+|INTEGRATED|Boolean|  
+  
+## Microsoft Jet OLE DB Provider  
+ Microsoft Jet OLE DB Driver は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   \[テーブル\]  
+  
+-   列  
+  
+-   手順  
+  
+-   ビュー  
+  
+-   Indexes  
+  
+### \[テーブル\]  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|TABLE\_TYPE|String|  
+|TABLE\_GUID|Guid|  
+|DESCRIPTION|String|  
+|TABLE\_PROPID|Int64|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### 列  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_HASDEFAULT|Boolean|  
+|COLUMN\_DEFAULT|String|  
+|COLUMN\_FLAGS|Int64|  
+|IS\_NULLABLE|Boolean|  
+|DATA\_TYPE|Int32|  
+|TYPE\_GUID|Guid|  
+|CHARACTER\_MAXIMUM\_LENGTH|Int64|  
+|CHARACTER\_OCTET\_LENGTH|Int64|  
+|NUMERIC\_PRECISION|Int32|  
+|NUMERIC\_SCALE|Int16|  
+|DATETIME\_PRECISION|Int64|  
+|CHARACTER\_SET\_CATALOG|String|  
+|CHARACTER\_SET\_SCHEMA|String|  
+|CHARACTER\_SET\_NAME|String|  
+|COLLATION\_CATALOG|String|  
+|COLLATION\_SCHEMA|String|  
+|COLLATION\_NAME|String|  
+|DOMAIN\_CATALOG|String|  
+|DOMAIN\_SCHEMA|String|  
+|DOMAIN\_NAME|String|  
+|DESCRIPTION|String|  
+  
+### 手順  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|PROCEDURE\_CATALOG|String|  
+|PROCEDURE\_SCHEMA|String|  
+|PROCEDURE\_NAME|String|  
+|PROCEDURE\_TYPE|Int16|  
+|PROCEDURE\_DEFINITION|String|  
+|DESCRIPTION|String|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### ビュー  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|VIEW\_DEFINITION|String|  
+|CHECK\_OPTION|Boolean|  
+|IS\_UPDATABLE|Boolean|  
+|DESCRIPTION|String|  
+|DATE\_CREATED|DateTime|  
+|DATE\_MODIFIED|DateTime|  
+  
+### Indexes  
+  
+|ColumnName|DataType|  
+|----------------|--------------|  
+|TABLE\_CATALOG|String|  
+|TABLE\_SCHEMA|String|  
+|TABLE\_NAME|String|  
+|INDEX\_CATALOG|String|  
+|INDEX\_SCHEMA|String|  
+|INDEX\_NAME|String|  
+|PRIMARY\_KEY|Boolean|  
+|UNIQUE|Boolean|  
+|CLUSTERED|Boolean|  
+|TYPE|Int32|  
+|FILL\_FACTOR|Int32|  
+|INITIAL\_SIZE|Int32|  
+|NULLS|Int32|  
+|SORT\_BOOKMARKS|Boolean|  
+|AUTO\_UPDATE|Boolean|  
+|NULL\_COLLATION|Int32|  
+|ORDINAL\_POSITION|Int64|  
+|COLUMN\_NAME|String|  
+|COLUMN\_GUID|Guid|  
+|COLUMN\_PROPID|Int64|  
+|COLLATION|Int16|  
+|CARDINALITY|Decimal \(10 進数型\)|  
+|PAGES|Int32|  
+|FILTER\_CONDITION|String|  
+|INTEGRATED|Boolean|  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/optimistic-concurrency.md b/docs/framework/data/adonet/optimistic-concurrency.md
new file mode 100644
index 00000000000..19d83207670
--- /dev/null
+++ b/docs/framework/data/adonet/optimistic-concurrency.md
@@ -0,0 +1,218 @@
+---
+title: "オプティミスティック同時実行制御 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e380edac-da67-4276-80a5-b64decae4947
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# オプティミスティック同時実行制御
+マルチユーザー環境には、データベースのデータを更新するための 2 つのモデルがあります。オプティミスティック同時実行制御とペシミスティック同時実行制御です。  <xref:System.Data.DataSet> オブジェクトは、データをリモート処理するときや、データと対話するときのように長時間にわたる利用状況では、オプティミスティック同時実行制御の使用を奨励するように設計されています。  
+  
+ ペシミスティック同時実行制御では、他のユーザーが現在のユーザーに影響を与えるようなデータ変更を実行するのを防ぐために、データ ソースで行をロックする必要があります。  ペシミスティック モデルでは、あるユーザーがロックの適用される操作を実行すると、他のユーザーは、ロックが解除されるまで、競合する操作を実行できません。  このモデルは、同時実行の競合が発生するときに、トランザクションをロールバックするよりもデータをロックで保護する方が低コストに抑えられるため、データの競合が多い環境で主に使用されます。  
+  
+ したがって、ペシミスティック同時実行制御モデルでは、行を更新するユーザーがロックを設定します。  更新を終了してロックを解除するまでは、他のユーザーはその行を変更できません。  そのため、ペシミスティック同時実行制御は、レコードをプログラムで処理する場合のようにロック時間が短いときの実装に適しています。  ペシミスティック同時実行制御は、ユーザーがデータと対話していてレコードが比較的長時間ロックされる場合には適していません。  
+  
+> [!NOTE]
+>  同じ操作で複数の行を更新する必要がある場合は、ペシミスティック同時実行制御でロックするよりも、トランザクションを作成する方が有効です。  
+  
+ これに対して、オプティミスティック同時実行制御を使用するユーザーは、行を読み取るときに行をロックしません。  ユーザーが行を更新するときは、行の読み取り後に別のユーザーがその行を変更したかどうかをアプリケーションで確認する必要があります。  オプティミスティック同時実行制御は、一般に、データの競合が少ない環境で使用されます。  オプティミスティック同時実行制御を使用すると、レコードをロックする必要がないためパフォーマンスが向上します。レコードをロックするには、サーバー リソースを追加する必要があります。  また、レコードのロックを管理するためにデータベース サーバーに永続的に接続している必要があります。  オプティミスティック同時実行制御モデルでは、サーバーとの接続が固定していないため、より短い時間で多数のクライアントを扱うことができます。  
+  
+ オプティミスティック同時実行制御モデルでは、ユーザーがデータベースから値を受け取った後、その値を変更する前に別のユーザーがその値を変更した場合に、違反が発生したと見なされます。  サーバーが同時実行制御違反を解決する方法がよくわかる例を次に示します。  
+  
+ オプティミスティック同時実行制御の例を次の表に示します。  
+  
+ 午後 1 時に、User1 が、次の値を持つデータベースから行を読み取ります。  
+  
+ **CustID     LastName     FirstName**  
+  
+ 101          Smith             Bob  
+  
+|列名|元の値|現在の値|データベース内の値|  
+|--------|---------|----------|---------------|  
+|CustID|101|101|101|  
+|LastName|Smith|Smith|Smith|  
+|FirstName|Bob|Bob|Bob|  
+  
+ 午後 1 時 1 分に、User2 が同じ行を読み取ります。  
+  
+ 午後 1 時 3 分に、User2 が **FirstName** を "Bob" から "Robert" に変更し、データベースを更新します。  
+  
+|列名|元の値|現在の値|データベース内の値|  
+|--------|---------|----------|---------------|  
+|CustID|101|101|101|  
+|LastName|Smith|Smith|Smith|  
+|FirstName|Bob|Robert|Bob|  
+  
+ 更新時のデータベース内の値は User2 が持つ元の値と一致しているため、更新は成功します。  
+  
+ 午後 1 時 5 分に、User1 が "Bob" の名を "James" に変更し、行の更新を試みます。  
+  
+|列名|元の値|現在の値|データベース内の値|  
+|--------|---------|----------|---------------|  
+|CustID|101|101|101|  
+|LastName|Smith|Smith|Smith|  
+|FirstName|Bob|James|Robert|  
+  
+ この時点で、データベース内の値 \("Robert"\) は User1 が期待していた元の値 \("Bob"\) と一致していないため、User1 による更新はオプティミスティック同時実行制御違反となります。  同時実行制御違反は、更新が失敗したことを通知するだけです。  ここで、User2 による変更を User1 による変更で上書きするか、または User1 による変更をキャンセルするかの決定が必要になります。  
+  
+## オプティミスティック同時実行制御違反テスト  
+ オプティミスティック同時実行制御違反をテストするには、いくつか方法があります。  1 つは、テーブルにタイムスタンプ列を含める方法です。  一般に、データベースには、レコードを最後に更新した日付と時刻を識別するために使用するタイムスタンプ機能が用意されています。  この機能を使用すると、timestamp 列がテーブル定義に組み込まれます。  レコードが更新されると、タイムスタンプが更新されて現在の日付と時刻が反映されます。  オプティミスティック同時実行制御違反テストでは、テーブル内容についてのクエリによって timestamp 列が返されます。  更新しようとすると、データベースのタイムスタンプ値と、変更行に格納されている元のタイムスタンプ値が比較されます。  一致した場合、更新が実行され、timestamp 列が現在の時刻に更新されてその更新が反映されます。  一致しなかった場合は、オプティミスティック同時実行制御違反が発生します。  
+  
+ オプティミスティック同時実行制御違反をテストするためのもう 1 つの方法は、行のすべての列の元の値が、データベース内の値とまだ一致しているかどうかを検証することです。  たとえば、次のクエリを見てみましょう。  
+  
+```  
+SELECT Col1, Col2, Col3 FROM Table1  
+```  
+  
+ **Table1** 内の行の更新時にオプティミスティック同時実行制御違反についてテストするために、次の UPDATE ステートメントを実行します。  
+  
+```  
+UPDATE Table1 Set Col1 = @NewCol1Value,  
+              Set Col2 = @NewCol2Value,  
+              Set Col3 = @NewCol3Value  
+WHERE Col1 = @OldCol1Value AND  
+      Col2 = @OldCol2Value AND  
+      Col3 = @OldCol3Value  
+```  
+  
+ 元の値がデータベース内の値と一致する間は、更新が実行されます。  値が変更された場合は、WHERE 句の条件と一致する行を見つけることができないため更新できません。  
+  
+ クエリで、常に一意の主キー値を返すことをお勧めします。  一意の主キーを返さないと、UPDATE ステートメントによって複数の行が更新されることがあり、意図に反した結果となります。  
+  
+ データ ソースの列で null が使用できる場合は、ローカル テーブルおよびデータ ソースで一致する null 参照がないかどうかをチェックするように WHERE 句を拡張する必要があります。  たとえば、次の UPDATE ステートメントは、ローカル行の null 参照がデータ ソースの null 参照とまだ一致しているかどうか、つまり、ローカル行の値がデータ ソースの値とまだ一致しているかどうかをチェックします。  
+  
+```  
+UPDATE Table1 Set Col1 = @NewVal1  
+  WHERE (@OldVal1 IS NULL AND Col1 IS NULL) OR Col1 = @OldVal1  
+```  
+  
+ オプティミスティック同時実行制御モデルを使用するときは、より制限の少ない抽出条件を適用するように選択することもできます。  たとえば、WHERE 句で主キー列だけを使用すると、前回のクエリ実行後に主キー以外の列が更新されたかどうかに関係なく、データが上書きされます。  WHERE 句を特定の列だけに適用することもできます。特定の列だけに WHERE 句を適用した場合は、特定のフィールドが前回のクエリ実行後に更新されていない限りデータが上書きされます。  
+  
+### DataAdapter.RowUpdated イベント  
+ これまでに説明した方法と併せて、<xref:System.Data.Common.DataAdapter> オブジェクトの **RowUpdated** イベントを使用しても、オプティミスティック同時実行制御違反をアプリケーションに通知できます。  **RowUpdated** は、**DataSet** から **Modified** 行の更新を行ったときに発生します。  これにより、例外発生時の処理、カスタム エラー情報の追加、再試行ロジックの追加などの特別の処理コードを追加できます。  <xref:System.Data.Common.RowUpdatedEventArgs> オブジェクトは、テーブルの行を変更する特定の更新コマンドの影響を受けた行数を含む **RecordsAffected** プロパティを返します。  オプティミスティック同時実行制御をテストするように更新コマンドを設定した場合は、オプティミスティック同時実行制御違反の発生時に、**RecordsAffected** プロパティは値 0 を結果として返します。値が 0 なのはレコードが更新されないためです。  この場合、例外がスローされます。  **RowUpdated** イベントを使用すると、発生したイベントを処理したり、**UpdateStatus.SkipCurrentRow** のような適切な **RowUpdatedEventArgs.Status** 値を設定することで例外を回避したりできます。  **RowUpdated** イベントの詳細については、「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。  
+  
+ 必要に応じて、**Update** を呼び出す前に **DataAdapter.ContinueUpdateOnError** を **true** に設定し、**Update** 完了時に特定の行の **RowError** プロパティに格納されたエラー情報に対処することができます。  詳細については、「[行エラー情報](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md)」を参照してください。  
+  
+## オプティミスティック同時実行制御の例  
+ **DataAdapter** の **UpdateCommand** をオプティミスティック同時実行制御をテストするように設定してから、**RowUpdated** イベントを使用してオプティミスティック同時実行制御違反がないかどうかをテストする簡単な例を次に示します。  オプティミスティック同時実行制御違反が検出されると、アプリケーションは、オプティミスティック同時実行制御違反が反映されるように更新が実行された行の **RowError** を設定します。  
+  
+ UPDATE コマンドの WHERE 句に渡されたパラメーター値は、それぞれの列の **Original** 値に割り当てられることに注意してください。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT CustomerID, CompanyName FROM Customers ORDER BY CustomerID", _  
+  connection)  
+  
+' The Update command checks for optimistic concurrency violations  
+' in the WHERE clause.  
+adapter.UpdateCommand = New SqlCommand("UPDATE Customers " &  
+  "(CustomerID, CompanyName) VALUES(@CustomerID, @CompanyName) " & _  
+  "WHERE CustomerID = @oldCustomerID AND CompanyName = " &  
+  "@oldCompanyName", connection)  
+adapter.UpdateCommand.Parameters.Add( _  
+  "@CustomerID", SqlDbType.NChar, 5, "CustomerID")  
+adapter.UpdateCommand.Parameters.Add( _  
+  "@CompanyName", SqlDbType.NVarChar, 30, "CompanyName")  
+  
+' Pass the original values to the WHERE clause parameters.  
+Dim parameter As SqlParameter = dataSet.UpdateCommand.Parameters.Add( _  
+  "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID")  
+parameter.SourceVersion = DataRowVersion.Original  
+parameter = adapter.UpdateCommand.Parameters.Add( _  
+  "@oldCompanyName", SqlDbType.NVarChar, 30, "CompanyName")  
+parameter.SourceVersion = DataRowVersion.Original  
+  
+' Add the RowUpdated event handler.  
+AddHandler adapter.RowUpdated, New SqlRowUpdatedEventHandler( _  
+  AddressOf OnRowUpdated)  
+  
+Dim dataSet As DataSet = New DataSet()  
+adapter.Fill(dataSet, "Customers")  
+  
+' Modify the DataSet contents.  
+adapter.Update(dataSet, "Customers")  
+  
+Dim dataRow As DataRow  
+  
+For Each dataRow In dataSet.Tables("Customers").Rows  
+    If dataRow.HasErrors Then   
+       Console.WriteLine(dataRow (0) & vbCrLf & dataRow.RowError)  
+    End If  
+Next  
+  
+Private Shared Sub OnRowUpdated( _  
+  sender As object, args As SqlRowUpdatedEventArgs)  
+   If args.RecordsAffected = 0  
+      args.Row.RowError = "Optimistic Concurrency Violation!"  
+      args.Status = UpdateStatus.SkipCurrentRow  
+   End If  
+End Sub  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+SqlDataAdapter adapter = new SqlDataAdapter(  
+  "SELECT CustomerID, CompanyName FROM Customers ORDER BY CustomerID",  
+  connection);  
+  
+// The Update command checks for optimistic concurrency violations  
+// in the WHERE clause.  
+adapter.UpdateCommand = new SqlCommand("UPDATE Customers Set CustomerID = @CustomerID, CompanyName = @CompanyName " +  
+   "WHERE CustomerID = @oldCustomerID AND CompanyName = @oldCompanyName, connection);  
+adapter.UpdateCommand.Parameters.Add(  
+  "@CustomerID", SqlDbType.NChar, 5, "CustomerID");  
+adapter.UpdateCommand.Parameters.Add(  
+  "@CompanyName", SqlDbType.NVarChar, 30, "CompanyName");  
+  
+// Pass the original values to the WHERE clause parameters.  
+SqlParameter parameter = adapter.UpdateCommand.Parameters.Add(  
+  "@oldCustomerID", SqlDbType.NChar, 5, "CustomerID");  
+parameter.SourceVersion = DataRowVersion.Original;  
+parameter = adapter.UpdateCommand.Parameters.Add(  
+  "@oldCompanyName", SqlDbType.NVarChar, 30, "CompanyName");  
+parameter.SourceVersion = DataRowVersion.Original;  
+  
+// Add the RowUpdated event handler.  
+adapter.RowUpdated += new SqlRowUpdatedEventHandler(OnRowUpdated);  
+  
+DataSet dataSet = new DataSet();  
+adapter.Fill(dataSet, "Customers");  
+  
+// Modify the DataSet contents.  
+  
+adapter.Update(dataSet, "Customers");  
+  
+foreach (DataRow dataRow in dataSet.Tables["Customers"].Rows)  
+{  
+    if (dataRow.HasErrors)  
+       Console.WriteLine(dataRow [0] + "\n" + dataRow.RowError);  
+}  
+  
+protected static void OnRowUpdated(object sender, SqlRowUpdatedEventArgs args)  
+{  
+  if (args.RecordsAffected == 0)   
+  {  
+    args.Row.RowError = "Optimistic Concurrency Violation Encountered";  
+    args.Status = UpdateStatus.SkipCurrentRow;  
+  }  
+}  
+```  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [行エラー情報](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md)   
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-and-adonet.md b/docs/framework/data/adonet/oracle-and-adonet.md
new file mode 100644
index 00000000000..eede1698d5d
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-and-adonet.md
@@ -0,0 +1,86 @@
+---
+title: "Oracle および ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ee8e389-53cf-45cf-80bd-1df63ef34f2e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Oracle および ADO.NET
+> [!NOTE]
+>  <xref:System.Data.OracleClient> の型は廃止されました。  これらの型は、.NET Framework の現在のバージョンでは引き続きサポートされていますが、今後のリリースでは削除される予定です。  サードパーティの Oracle プロバイダーを使用することをお勧めします。  
+  
+ このセクションでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle 固有の機能および動作について説明します。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle では、Oracle Client ソフトウェアとして提供されている Oracle Call Interface \(OCI\) を使用して Oracle データベースにアクセスできます。  このデータ プロバイダーの機能は、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]、OLE DB、および ODBC 用の各 [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーの機能と同等になるように設計されています。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle を使用するには、アプリケーションで以下のように <xref:System.Data.OracleClient> 名前空間を参照する必要があります。  
+  
+```vb  
+Imports System.Data.OracleClient  
+```  
+  
+```csharp  
+using System.Data.OracleClient;  
+```  
+  
+ コードをコンパイルするには、DLL への参照も必要です。  たとえば、C\# プログラムをコンパイルする場合、コマンド ラインに以下のコードを含める必要があります。  
+  
+```  
+csc /r:System.Data.OracleClient.dll  
+```  
+  
+## このセクションの内容  
+ [システム要件](../../../../docs/framework/data/adonet/system-requirements-for-the-dotnet-data-provider-for-oracle.md)  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle を使用するための要件を説明し、その際に知っておくべきさまざまなことについて説明します。  
+  
+ [Oracle BFILE](../../../../docs/framework/data/adonet/oracle-bfiles.md)  
+ <xref:System.Data.OracleClient.OracleBFile> クラスについて説明します。このクラスは、Oracle BFILE データ型を操作するために使用されます。  
+  
+ [Oracle LOB](../../../../docs/framework/data/adonet/oracle-lobs.md)  
+ <xref:System.Data.OracleClient.OracleLob> クラスについて説明します。このクラスは、Oracle LOB データ型を操作するために使用されます。  
+  
+ [Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)  
+ Oracle REF CURSOR データ型のサポートについて説明します。  
+  
+ [OracleType](../../../../docs/framework/data/adonet/oracletypes.md)  
+ <xref:System.Data.OracleClient.OracleNumber> や <xref:System.Data.OracleClient.OracleString> など、Oracle データ型を操作するために使用する構造体について説明します。  
+  
+ [Oracle シーケンス](../../../../docs/framework/data/adonet/oracle-sequences.md)  
+ サーバーによって生成されたキー値 \(Oracle シーケンス\) を取得するためのサポートについて説明します。  
+  
+ [Oracle データ型のマッピング](../../../../docs/framework/data/adonet/oracle-data-type-mappings.md)  
+ Oracle データ型およびその <xref:System.Data.OracleClient.OracleDataReader> へのマップを一覧表示します。  
+  
+ [Oracle 分散トランザクション](../../../../docs/framework/data/adonet/oracle-distributed-transactions.md)  
+ <xref:System.Data.OracleClient.OracleConnection> オブジェクトが、トランザクションがアクティブであると判断した場合に、既存の分散トランザクションに自動的に参加する方法について説明します。  
+  
+## 関連項目  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] を使用する場合の安全なコーディング方法について説明します。  
+  
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)  
+ `DataSets`、型指定された `DataSets`、`DataTables`、および `DataViews` の作成方法と使用方法について説明します。  
+  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)  
+ ADO.NET でのデータの操作方法について説明します。  
+  
+ [SQL Server と ADO.NET](../../../../docs/framework/data/adonet/sql/index.md)  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] 固有の機能の操作方法について説明します。  
+  
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] でプロバイダーに依存しないコードを記述するための汎用的なクラスについて説明します。  
+  
+## 参照  
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-bfiles.md b/docs/framework/data/adonet/oracle-bfiles.md
new file mode 100644
index 00000000000..43535e56e29
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-bfiles.md
@@ -0,0 +1,98 @@
+---
+title: "Oracle BFILE | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 341bbf84-4734-4d44-8723-ccedee954e21
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Oracle BFILE
+.NET Framework Data Provider for Oracle には、<xref:System.Data.OracleClient.OracleBFile> クラスが含まれています。このクラスは、Oracle <xref:System.Data.OracleClient.OracleType> データ型で使用されます。  
+  
+ Oracle **BFILE** データ型は、最大 4 GB までのバイナリ データへの参照を含む Oracle **LOB** データ型です。  Oracle **BFILE** は、データがサーバー上にではなくオペレーティング システムの物理ファイルに保存されるという点で、他の Oracle **LOB** データ型と異なります。  **BFILE** データ型のデータ アクセスは読み取り専用であることに注意してください。  
+  
+ **LOB** データ型と異なる **BFILE** データ型のその他の特徴としては、次のものがあります。  
+  
+-   非構造化データの保持。  
+  
+-   サーバー側チャンキングのサポート。  
+  
+-   参照コピーのセマンティクスの使用。  たとえば、**BFILE** 上でコピー操作を行う場合、ファイルへの参照である **BFILE** ロケーターだけがコピーされます。  ファイル内のデータはコピーされません。  
+  
+ **BFILE** データ型は、大きいサイズの LOB の参照用として使用してください。データベースへの保存には適しません。  **BFILE** データ型を使用すると、クライアント、サーバー、および通信において、**LOB** データ型よりも、いっそう多くのオーバーヘッドを必要とします。  少量のデータを取得するだけの場合は、**BFILE** へのアクセスがいっそう効果的です。  オブジェクト全体を取得したい場合は、データベースに常駐する LOB へのアクセスがいっそう効果的です。  
+  
+ NULL 以外の **OracleBFile** オブジェクトは、基になる物理ファイルの場所を定義する次の 2 つのエンティティに関連付けられます。  
+  
+1.  Oracle DIRECTORY オブジェクト。ファイル システムのディレクトリに対するデータベースのエイリアスです。  
+  
+2.  基になる物理ファイルのファイル名。このファイルは、DIRECTORY オブジェクトに関連付けられたディレクトリに配置されています。  
+  
+## 例  
+ 次の C\# の例では、Oracle テーブルに **BFILE** を作成し、**OracleBFile** オブジェクトの形式で取得する方法について説明します。  この例では、<xref:System.Data.OracleClient.OracleDataReader> オブジェクトと **OracleBFile** の **Seek** および **Read** メソッドを使用する方法について説明します。  このサンプルを使用するには、はじめに "c:\\\\bfiles" というディレクトリと "MyFile.jpg" というファイルを Oracle サーバーに作成する必要があります。  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Data;  
+using System.Data.OracleClient;  
+  
+public class Sample  
+{  
+   public static void Main(string[] args)  
+   {  
+      OracleConnection connection = new OracleConnection(  
+        "Data Source=Oracle8i;Integrated Security=yes");  
+      connection.Open();  
+  
+      OracleCommand command = connection.CreateCommand();  
+      command.CommandText =   
+        "CREATE or REPLACE DIRECTORY MyDir as 'c:\\bfiles'";  
+      command.ExecuteNonQuery();  
+      command.CommandText =   
+        "DROP TABLE MyBFileTable";  
+      try {  
+        command.ExecuteNonQuery();  
+      }  
+      catch {  
+      }  
+      command.CommandText =   
+        "CREATE TABLE MyBFileTable(col1 number, col2 BFILE)";  
+      command.ExecuteNonQuery();  
+      command.CommandText =   
+        "INSERT INTO MyBFileTable values ('2', BFILENAME('MyDir', " +  
+        "'MyFile.jpg'))";  
+      command.ExecuteNonQuery();  
+      command.CommandText = "SELECT * FROM MyBFileTable";  
+  
+        byte[] buffer = new byte[100];  
+  
+      OracleDataReader reader = command.ExecuteReader();  
+      using (reader) {  
+          if (reader.Read()) {  
+                OracleBFile bFile = reader.GetOracleBFile(1);  
+                using (bFile) {  
+                  bFile.Seek(0, SeekOrigin.Begin);  
+                  bFile.Read(buffer, 0, 100);  
+              }  
+          }  
+      }  
+  
+      connection.Close();  
+   }  
+  
+}  
+```  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-data-type-mappings-2.md b/docs/framework/data/adonet/oracle-data-type-mappings-2.md
new file mode 100644
index 00000000000..7dc237bd546
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-data-type-mappings-2.md
@@ -0,0 +1,54 @@
+---
+title: "Oracle データ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "02/15/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d2521bcc-0051-4f35-8be3-e8723edeaf6f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+---
+# Oracle データ型のマッピング
+.NET Framework Data Provider for Oracle \([!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]\) のデータ型から推論される <xref:System.Data.OracleClient> の型を次の表に示します。<xref:System.Data.OracleClient.OracleDataReader> の型指定されたアクセサー メソッドも示します。  
+  
+|Oracle 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型|[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の型指定されたアクセサー|OracleType の型指定されたアクセサー|  
+|--------------|-------------------------------------------------------------------|------------------------------------------------------------------------------|-----------------------------|  
+|BFILE|Byte\[\]|GetBytes\(\)|GetOracleBFile\(\)|  
+|BLOB|Byte\[\]|GetBytes\(\)|GetOracleLob\(\)|  
+|CHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+|CLOB|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleLob\(\)|  
+|DATE|DateTime|GetDateTime\(\)|GetOracleDateTime\(\)|  
+|FLOAT|Decimal \(10 進数型\)|GetDecimal\(\)|GetOracleNumber\(\) \*\*|  
+|INTEGER|Decimal \(10 進数型\)|GetDecimal\(\)|GetOracleNumber\(\) \*\*|  
+|INTERVAL YEAR TO MONTH \*|Int32|GetInt32\(\)|GetOracleMonthSpan\(\)|  
+|INTERVAL DAY TO SECOND \*|TimeSpan|GetTimeSpan\(\)|GetOracleTimeSpan\(\)|  
+|LONG|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+|LONG RAW|Byte\[\]|GetBytes\(\)|GetOracleBinary\(\)|  
+|NCHAR|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+|NCLOB|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleLob\(\)|  
+|NUMBER|Decimal \(10 進数型\)|GetDecimal\(\)|GetOracleNumber\(\) \*\*|  
+|NVARCHAR2|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+|RAW|Byte\[\]|GetBytes\(\)|GetOracleBinary\(\)|  
+|REF CURSOR||||  
+|ROWID|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+|TIMESTAMP \*|DateTime|GetDateTime\(\)|GetOracleDateTime\(\)|  
+|TIMESTAMP WITH LOCAL TIME ZONE \*|DateTime|GetDateTime\(\)|GetOracleDateTime\(\)|  
+|TIMESTAMP WITH TIME ZONE \*|DateTime|GetDateTime\(\)|GetOracleDateTime\(\)|  
+|UNSIGNED INTEGER|Decimal \(10 進数型\)|GetDecimal\(\)|GetOracleNumber\(\) \*\*|  
+|VARCHAR2|String<br /><br /> Char\[\]|GetString\(\)<br /><br /> GetChars\(\)|GetOracleString\(\)|  
+  
+ \* この Oracle 型は、クライアントとサーバーの両方に Oracle 9i ソフトウェアを使用している場合にだけ使用できます。  
+  
+ \*\* Oracle の NUMBER 型の有効桁数は 38 桁です。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の `decimal` 型は 28 桁に制限されています。 Oracle の NUMBER 型を [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の `decimal` 型に読み込む場合、28 桁を超える NUMBER 型の値では `OverflowException` がスローされます。`OracleDataReader` から Oracle の NUMBER 型の値を読み込む場合は、`GetOracleNumber` の型指定されたアクセサー メソッドを呼び出し、`OracleNumber` として Oracle の NUMBER 型の値を返すことをお勧めします。`DataSet` にデータを読む込む場合は、`FillError` イベントを使用して、`OverflowException` が発生したかどうかを確認し、発生時に適切な対応をすることができます。`FillError` イベントについては、「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-data-type-mappings.md b/docs/framework/data/adonet/oracle-data-type-mappings.md
new file mode 100644
index 00000000000..23464a860a3
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-data-type-mappings.md
@@ -0,0 +1,80 @@
+---
+title: "Oracle データ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec34ae21-bbbb-4adb-b672-83865e2a8451
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Oracle データ型のマッピング
+次の表に、Oracle データ型およびその <xref:System.Data.OracleClient.OracleDataReader> へのマップを示します。  
+  
+|Oracle データ型|OracleDataReader.GetValue によって返される .NET Framework データ型|OracleDataReader.GetOracleValue によって返される OracleClient データ型|解説|  
+|-----------------|------------------------------------------------------------|----------------------------------------------------------------|--------|  
+|**BFILE**|**Byte\[\]**|<xref:System.Data.OracleClient.OracleBFile>||  
+|**BLOB**|**Byte\[\]**|<xref:System.Data.OracleClient.OracleLob>||  
+|**CHAR**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+|**CLOB**|**String**|<xref:System.Data.OracleClient.OracleLob>||  
+|**DATE**|**DateTime**|<xref:System.Data.OracleClient.OracleDateTime>||  
+|**FLOAT**|**Decimal \(10 進数型\)**|<xref:System.Data.OracleClient.OracleNumber>|このデータ型は **NUMBER** データ型のエイリアスであり、<xref:System.Data.OracleClient.OracleDataReader> が浮動小数点数値ではなく **System.Decimal** または <xref:System.Data.OracleClient.OracleNumber> を返すことを目的として用意されています。  .NET Framework データ型を使用することで、オーバーフローが発生する場合があります。|  
+|**INTEGER**|**Decimal \(10 進数型\)**|<xref:System.Data.OracleClient.OracleNumber>|このデータ型は **NUMBER\(38\)** データ型のエイリアスであり、<xref:System.Data.OracleClient.OracleDataReader> が整数値ではなく **System.Decimal** または <xref:System.Data.OracleClient.OracleNumber> を返すことを目的として用意されています。  .NET Framework データ型を使用することで、オーバーフローが発生する場合があります。|  
+|**INTERVAL YEAR TO MONTH**|**Int32**|<xref:System.Data.OracleClient.OracleMonthSpan>||  
+|**INTERVAL DAY TO SECOND**|**TimeSpan**|<xref:System.Data.OracleClient.OracleTimeSpan>||  
+|**LONG**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+|**LONG RAW**|**Byte\[\]**|<xref:System.Data.OracleClient.OracleBinary>||  
+|**NCHAR**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+|**NCLOB**|**String**|<xref:System.Data.OracleClient.OracleLob>||  
+|**NUMBER**|**Decimal \(10 進数型\)**|<xref:System.Data.OracleClient.OracleNumber>|.NET Framework データ型を使用することで、オーバーフローが発生する場合があります。|  
+|**NVARCHAR2**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+|**RAW**|**Byte\[\]**|<xref:System.Data.OracleClient.OracleBinary>||  
+|**REF CURSOR**|||Oracle **REF CURSOR** データ型は <xref:System.Data.OracleClient.OracleDataReader> オブジェクトではサポートされていません。|  
+|**ROWID**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+|**TIMESTAMP**|**DateTime**|<xref:System.Data.OracleClient.OracleDateTime>||  
+|**TIMESTAMP WITH LOCAL TIME ZONE**|**DateTime**|<xref:System.Data.OracleClient.OracleDateTime>||  
+|**TIMESTAMP WITH TIME ZONE**|**DateTime**|<xref:System.Data.OracleClient.OracleDateTime>||  
+|**UNSIGNED INTEGER**|**Number**|<xref:System.Data.OracleClient.OracleNumber>|このデータ型は **NUMBER\(38\)** データ型のエイリアスであり、<xref:System.Data.OracleClient.OracleDataReader> が符号なし整数値ではなく **System.Decimal** または <xref:System.Data.OracleClient.OracleNumber> を返すことを目的として用意されています。  .NET Framework データ型を使用することで、オーバーフローが発生する場合があります。|  
+|**VARCHAR2**|**String**|<xref:System.Data.OracleClient.OracleString>||  
+  
+ 次の表に、パラメーターとしてバインドする場合に使用する Oracle データ型および .NET Framework データ型 \(**System.Data.DbType** および <xref:System.Data.OracleClient.OracleType>\) を示します。  
+  
+|Oracle データ型|パラメーターとしてバインドする DbType 列挙型|パラメーターとしてバインドする OracleType 列挙型|解説|  
+|-----------------|--------------------------------|------------------------------------|--------|  
+|**BFILE**||**BFile**|Oracle では、**BFILE** パラメーターとしてのみ **BFILE** をバインドできます。  .NET Data Provider for Oracle では、**byte\[\]** や <xref:System.Data.OracleClient.OracleBinary> など、**BFILE** 以外の値をバインドしようとした場合に、自動的にこれを構築することはありません。|  
+|**BLOB**||**Blob**|Oracle では、**BLOB** パラメーターとしてのみ **BLOB** をバインドできます。  .NET Data Provider for Oracle では、**byte\[\]** や <xref:System.Data.OracleClient.OracleBinary> など、**BLOB** 以外の値をバインドしようとした場合に、自動的にこれを構築することはありません。|  
+|**CHAR**|**AnsiStringFixedLength**|**Char**||  
+|**CLOB**||**Clob**|Oracle では、**CLOB** パラメーターとしてのみ **CLOB** をバインドできます。  .NET Data Provider for Oracle では、**System.String** や <xref:System.Data.OracleClient.OracleString> など、**CLOB** 以外の値をバインドしようとした場合に、自動的にこれを構築することはありません。|  
+|**DATE**|**DateTime**|**DateTime**||  
+|**FLOAT**|**Single、Double、Decimal**|**Float、Double、Number**|<xref:System.Data.OracleClient.OracleParameter.Size%2A> により **System.Data.DBType** および <xref:System.Data.OracleClient.OracleType> が決定されます。|  
+|**INTEGER**|**SByte、Int16、Int32、Int64、Decimal**|**SByte、Int16、Int32、Number**|<xref:System.Data.OracleClient.OracleParameter.Size%2A> により **System.Data.DBType** および <xref:System.Data.OracleClient.OracleType> が決定されます。|  
+|**INTERVAL YEAR TO MONTH**|**Int32**|**IntervalYearToMonth**|<xref:System.Data.OracleClient.OracleType> は、Oracle 9i クライアントとサーバー ソフトウェアの両方を使用している場合のみ使用できます。|  
+|**INTERVAL DAY TO SECOND**|**Object**|**IntervalDayToSecond**|<xref:System.Data.OracleClient.OracleType> は、Oracle 9i クライアントとサーバー ソフトウェアの両方を使用している場合のみ使用できます。|  
+|**LONG**|**AnsiString**|**LongVarChar**||  
+|**LONG RAW**|**2 項**|**LongRaw**||  
+|**NCHAR**|**StringFixedLength**|**NChar**||  
+|**NCLOB**||**NClob**|Oracle では、**NCLOB** パラメーターとしてのみ **NCLOB** をバインドできます。  .NET Data Provider for Oracle では、**System.String** や <xref:System.Data.OracleClient.OracleString> など、**NCLOB** 以外の値をバインドしようとした場合に、自動的にこれを構築することはありません。|  
+|**NUMBER**|**VarNumeric**|**Number**||  
+|**NVARCHAR2**|**String**|**NVarChar**||  
+|**RAW**|**2 項**|**Raw**||  
+|**REF CURSOR**||**カーソル**|詳細については、「[Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)」を参照してください。|  
+|**ROWID**|**AnsiString**|**Rowid**||  
+|**TIMESTAMP**|**DateTime**|**Timestamp**|<xref:System.Data.OracleClient.OracleType> は、Oracle 9i クライアントとサーバー ソフトウェアの両方を使用している場合のみ使用できます。|  
+|**TIMESTAMP WITH LOCAL TIME ZONE**|**DateTime**|**TimestampLocal**|<xref:System.Data.OracleClient.OracleType> は、Oracle 9i クライアントとサーバー ソフトウェアの両方を使用している場合のみ使用できます。|  
+|**TIMESTAMP WITH TIME ZONE**|**DateTime**|**TimestampWithTz**|<xref:System.Data.OracleClient.OracleType> は、Oracle 9i クライアントとサーバー ソフトウェアの両方を使用している場合のみ使用できます。|  
+|**UNSIGNED INTEGER**|**Byte、UInt16、UInt32、UInt64、Decimal**|**Byte、UInt16、Uint32、Number**|<xref:System.Data.OracleClient.OracleParameter.Size%2A> により **System.Data.DBType** および <xref:System.Data.OracleClient.OracleType> が決定されます。|  
+|**VARCHAR2**|**AnsiString**|**VarChar**||  
+  
+ <xref:System.Data.OracleClient.OracleParameter> オブジェクトの <xref:System.Data.OracleClient.OracleParameter.Value%2A> プロパティで使用される **InputOutput** 値、**Output** 値、および **ReturnValue** **ParameterDirection** 値は、入力値が Oracle データ型 \(<xref:System.Data.OracleClient.OracleNumber> や <xref:System.Data.OracleClient.OracleString> など\) でない限り、.NET Framework データ型となります。  これは **REF CURSOR**、**BFILE**、または **LOB** データ型には適用されません。  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-distributed-transactions.md b/docs/framework/data/adonet/oracle-distributed-transactions.md
new file mode 100644
index 00000000000..7a08289bef8
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-distributed-transactions.md
@@ -0,0 +1,30 @@
+---
+title: "Oracle 分散トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c340ca81-ef79-402f-b204-c5156b890fe5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Oracle 分散トランザクション
+<xref:System.Data.OracleClient.OracleConnection> オブジェクトはトランザクションがアクティブであると判断した場合、既存の分散トランザクションに自動的に参加します。  自動トランザクション参加は、接続が開かれた場合または接続プールから取得された場合に行われます。  既存のトランザクションへの自動参加を無効にするには、  
+  
+```  
+Enlist=false  
+```  
+  
+ を <xref:System.Data.OracleClient.OracleConnection> の接続文字列パラメーターとして指定します。  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-lobs.md b/docs/framework/data/adonet/oracle-lobs.md
new file mode 100644
index 00000000000..12cb9a9698d
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-lobs.md
@@ -0,0 +1,263 @@
+---
+title: "Oracle LOB | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 272e8e1e-a31f-475a-8c2a-ae8e1286bdab
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Oracle LOB
+.NET Framework Data Provider for Oracle には、<xref:System.Data.OracleClient.OracleLob> クラスが含まれています。このクラスは、Oracle の **LOB** データ型を操作するために使用されます。  
+  
+ **OracleLob** は、これらの <xref:System.Data.OracleClient.OracleType> データ型の 1 つです。  
+  
+|データ型|説明|  
+|----------|--------|  
+|**Blob**|最大 4 GB までのバイナリ データを含む Oracle の **BLOB** データ型です。  **Byte** 型の **Array** にマップします。|  
+|**Clob**|Oracle の **CLOB** データ型です。サーバーの既定の文字セットに基づいて最大 4 GB までの文字データを含みます。  **String** にマップします。|  
+|**NClob**|Oracle の **NCLOB** データ型です。サーバーの各国語文字セットに基づいて最大 4 GB までの文字データを含みます。  **String** にマップします。|  
+  
+ **OracleLob** は、データがオペレーティング システムの物理ファイルにではなくサーバーに格納されるという点で、<xref:System.Data.OracleClient.OracleBFile> とは異なります。  また、常に読み取り専用になっている **OracleBFile** とは異なり、読み書き可能なオブジェクトにもなります。  
+  
+## LOB の作成、取得、および書き込み  
+ 次の C\# の例では、Oracle テーブルに LOB を作成し、それらを取得して **OracleLob** オブジェクトの形式で書き込む方法について説明します。  この例では、<xref:System.Data.OracleClient.OracleDataReader> オブジェクトと **OracleLob** の **Read** および **Write** メソッドを使用する方法について説明します。  Oracle の **BLOB**、**CLOB**、および **NCLOB** データ型を使用します。  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.IO;              
+using System.Text;             
+using System.Data;              
+using System.Data.OracleClient;  
+  
+// LobExample  
+public class LobExample  
+{  
+   public static int Main(string[] args)  
+   {  
+      //Create a connection.  
+      OracleConnection conn = new OracleConnection(  
+         "Data Source=Oracle8i;Integrated Security=yes");  
+      using(conn)  
+      {  
+         //Open a connection.  
+         conn.Open();  
+         OracleCommand cmd = conn.CreateCommand();  
+  
+         //Create the table and schema.  
+         CreateTable(cmd);  
+  
+         //Read example.  
+         ReadLobExample(cmd);  
+  
+         //Write example  
+         WriteLobExample(cmd);  
+      }  
+  
+      return 1;  
+   }  
+  
+   // ReadLobExample  
+   public static void ReadLobExample(OracleCommand cmd)  
+   {  
+      int actual = 0;  
+  
+      // Table Schema:  
+      // "CREATE TABLE tablewithlobs (a int, b BLOB, c CLOB, d NCLOB)";  
+      // "INSERT INTO tablewithlobs values (1, 'AA', 'AAA', N'AAAA')";  
+      // Select some data.  
+      cmd.CommandText = "SELECT * FROM tablewithlobs";  
+      OracleDataReader reader = cmd.ExecuteReader();  
+      using(reader)  
+      {  
+         //Obtain the first row of data.  
+         reader.Read();  
+  
+         //Obtain the LOBs (all 3 varieties).  
+         OracleLob blob = reader.GetOracleLob(1);  
+         OracleLob clob = reader.GetOracleLob(2);  
+         OracleLob nclob = reader.GetOracleLob(3);  
+  
+         //Example - Reading binary data (in chunks).  
+         byte[] buffer = new byte[100];  
+         while((actual = blob.Read(buffer, 0, buffer.Length)) >0)  
+            Console.WriteLine(blob.LobType + ".Read(" + buffer + ", " +   
+              buffer.Length + ") => " + actual);  
+  
+         // Example - Reading CLOB/NCLOB data (in chunks).  
+         // Note: You can read character data as raw Unicode bytes   
+         // (using OracleLob.Read as in the above example).  
+         // However, because the OracleLob object inherits directly   
+         // from the .Net stream object,   
+         // all the existing classes that manipluate streams can   
+         // also be used. For example, the   
+         // .Net StreamReader makes it easier to convert the raw bytes   
+         // into actual characters.  
+         StreamReader streamreader =   
+           new StreamReader(clob, Encoding.Unicode);  
+         char[] cbuffer = new char[100];  
+         while((actual = streamreader.Read(cbuffer,   
+           0, cbuffer.Length)) >0)  
+            Console.WriteLine(clob.LobType + ".Read(  
+              " + new string(cbuffer, 0, actual) + ", " +   
+              cbuffer.Length + ") => " + actual);  
+  
+         // Example - Reading data (all at once).  
+         // You could use StreamReader.ReadToEnd to obtain   
+         // all the string data, or simply  
+         // call OracleLob.Value to obtain a contiguous allocation   
+         // of all the data.  
+         Console.WriteLine(nclob.LobType + ".Value => " + nclob.Value);  
+      }  
+   }  
+  
+   // WriteLobExample  
+   public static void WriteLobExample(OracleCommand cmd)  
+   {  
+      //Note: Updating LOB data requires a transaction.  
+      cmd.Transaction = cmd.Connection.BeginTransaction();  
+  
+      // Select some data.  
+      // Table Schema:  
+      // "CREATE TABLE tablewithlobs (a int, b BLOB, c CLOB, d NCLOB)";  
+      // "INSERT INTO tablewithlobs values (1, 'AA', 'AAA', N'AAAA')";  
+      cmd.CommandText = "SELECT * FROM tablewithlobs FOR UPDATE";  
+      OracleDataReader reader = cmd.ExecuteReader();  
+      using(reader)  
+      {  
+         // Obtain the first row of data.  
+         reader.Read();  
+  
+         // Obtain a LOB.  
+         OracleLob blob = reader.GetOracleLob(1/*0:based ordinal*/);  
+  
+         // Perform any desired operations on the LOB   
+         // (read, position, and so on).  
+  
+         // Example - Writing binary data (directly to the backend).  
+         // To write, you can use any of the stream classes, or write  
+         // raw binary data using   
+         // the OracleLob write method. Writing character vs. binary   
+         // is the same;  
+         // however note that character is always in terms of   
+         // Unicode byte counts  
+         // (for example, even number of bytes - 2 bytes for every  
+         // Unicode character).  
+         byte[] buffer = new byte[100];  
+         buffer[0] = 0xCC;  
+         buffer[1] = 0xDD;  
+         blob.Write(buffer, 0, 2);  
+         blob.Position = 0;  
+         Console.WriteLine(blob.LobType + ".Write(  
+           " + buffer + ", 0, 2) => " + blob.Value);  
+  
+         // Example - Obtaining a temp LOB and copying data   
+         // into it from another LOB.  
+         OracleLob templob = CreateTempLob(cmd, blob.LobType);  
+         long actual = blob.CopyTo(templob);  
+         Console.WriteLine(blob.LobType + ".CopyTo(  
+            " + templob.Value + ") => " + actual);  
+  
+         // Commit the transaction now that everything succeeded.  
+         // Note: On error, Transaction.Dispose is called   
+         // (from the using statement)  
+         // and will automatically roll back the pending transaction.  
+         cmd.Transaction.Commit();  
+      }  
+   }  
+  
+   // CreateTempLob  
+   public static OracleLob CreateTempLob(  
+     OracleCommand cmd, OracleType lobtype)  
+   {  
+      //Oracle server syntax to obtain a temporary LOB.  
+      cmd.CommandText = "DECLARE A " + lobtype + "; "+  
+                     "BEGIN "+  
+                        "DBMS_LOB.CREATETEMPORARY(A, FALSE); "+  
+                        ":LOC := A; "+  
+                     "END;";  
+  
+      //Bind the LOB as an output parameter.  
+      OracleParameter p = cmd.Parameters.Add("LOC", lobtype);  
+      p.Direction = ParameterDirection.Output;  
+  
+      //Execute (to receive the output temporary LOB).  
+      cmd.ExecuteNonQuery();  
+  
+      //Return the temporary LOB.  
+      return (OracleLob)p.Value;  
+   }  
+  
+   // CreateTable  
+   public static void CreateTable(OracleCommand cmd)  
+   {  
+      // Table Schema:  
+      // "CREATE TABLE tablewithlobs (a int, b BLOB, c CLOB, d NCLOB)";  
+      // "INSERT INTO tablewithlobs VALUES (1, 'AA', 'AAA', N'AAAA')";  
+      try  
+      {  
+         cmd.CommandText   = "DROP TABLE tablewithlobs";  
+         cmd.ExecuteNonQuery();  
+      }  
+      catch(Exception)  
+      {  
+      }  
+  
+      cmd.CommandText =   
+        "CREATE TABLE tablewithlobs (a int, b BLOB, c CLOB, d NCLOB)";  
+      cmd.ExecuteNonQuery();  
+      cmd.CommandText =   
+        "INSERT INTO tablewithlobs VALUES (1, 'AA', 'AAA', N'AAAA')";  
+      cmd.ExecuteNonQuery();  
+   }  
+}  
+```  
+  
+## 一時 LOB の作成  
+ 次の C\# の例では、一時 LOB の作成方法について説明します。  
+  
+ \[C\#\]  
+  
+```  
+OracleConnection conn = new OracleConnection(  
+  "server=test8172; integrated security=yes;");  
+conn.Open();  
+  
+OracleTransaction tx = conn.BeginTransaction();  
+  
+OracleCommand cmd = conn.CreateCommand();  
+cmd.Transaction = tx;  
+cmd.CommandText =   
+  "declare xx blob; begin dbms_lob.createtemporary(  
+  xx, false, 0); :tempblob := xx; end;";  
+cmd.Parameters.Add(new OracleParameter("tempblob",  
+  OracleType.Blob)).Direction = ParameterDirection.Output;  
+cmd.ExecuteNonQuery();  
+OracleLob tempLob = (OracleLob)cmd.Parameters[0].Value;  
+tempLob.BeginBatch(OracleLobOpenMode.ReadWrite);  
+tempLob.Write(tempbuff,0,tempbuff.Length);  
+tempLob.EndBatch();  
+cmd.Parameters.Clear();  
+cmd.CommandText = "myTable.myProc";  
+cmd.CommandType = CommandType.StoredProcedure;    
+cmd.Parameters.Add(new OracleParameter(  
+  "ImportDoc", OracleType.Blob)).Value = tempLob;  
+cmd.ExecuteNonQuery();  
+  
+tx.Commit();  
+```  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-ref-cursors.md b/docs/framework/data/adonet/oracle-ref-cursors.md
new file mode 100644
index 00000000000..fb4b50cee92
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-ref-cursors.md
@@ -0,0 +1,54 @@
+---
+title: "Oracle REF CURSOR | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6b25b8b-0bdd-41b2-9c7c-661f070c2247
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Oracle REF CURSOR
+.NET Framework Data Provider for Oracle は、Oracle **REF CURSOR** データ型をサポートしています。  データ プロバイダーを使用して Oracle REF CURSOR を操作するときは、次の動作を考慮する必要があります。  
+  
+> [!NOTE]
+>  動作の中には、Microsoft OLE DB Provider for Oracle \(MSDAORA\) の動作と異なるものがあります。  
+  
+-   パフォーマンスの理由から、Data Provider for Oracle では、バインドするよう明示的に指定した場合を除き、**REF CURSOR** データ型が自動的にバインドされることはありません。これは、MSDAORA の場合と同じです。  
+  
+-   データ プロバイダーでは、REF CURSOR パラメーターの指定に使用する {resultset} エスケープのような、ODBC エスケープ シーケンスはサポートされていません。  
+  
+-   REF CURSOR を返すストアド プロシージャを実行するには、**Cursor** の <xref:System.Data.OracleClient.OracleType>、および **Output** の <xref:System.Data.OracleClient.OracleParameter.Direction%2A> を使用して、<xref:System.Data.OracleClient.OracleParameterCollection> にパラメーターを定義する必要があります。  データ プロバイダーでは、REF CURSOR のバインドは出力パラメーターとしてのみサポートされています。  プロバイダーは、入力パラメーターとしての REF CURSOR はサポートしていません。  
+  
+-   パラメーター値からの <xref:System.Data.OracleClient.OracleDataReader> の取得はサポートされていません。  値は、コマンドを実行すると <xref:System.DBNull> 型になります。  
+  
+-   REF CURSOR を使用する **CommandBehavior** 列挙型値のみが **CloseConnection** になります \(たとえば、<xref:System.Data.OracleClient.OracleCommand.ExecuteReader%2A> の呼び出し時\)。その他の値はすべて無視されます。  
+  
+-   **OracleDataReader** 内の REF CURSOR の順序は、**OracleParameterCollection** 内のパラメーターの順序で決まります。  <xref:System.Data.OracleClient.OracleParameter.ParameterName%2A> プロパティは無視されます。  
+  
+-   PL\/SQL の **TABLE** データ型はサポートされていません。  ただし、REF CURSOR は、さらに効果的です。  **TABLE** データ型を使用しなければならない場合、MSDAORA と共に OLE DB .NET データ プロバイダーを使用してください。  
+  
+## このセクションの内容  
+ [REF CURSOR の例](../../../../docs/framework/data/adonet/ref-cursor-examples.md)  
+ 次の 3 つの例を使って REF CURSOR の使い方について説明します。  
+  
+ [OracleDataReader の REF CURSOR パラメーター](../../../../docs/framework/data/adonet/ref-cursor-parameters-in-an-oracledatareader.md)  
+ REF CURSOR パラメーターを返し、**OracleDataReader** として値を読み取る、PL\/SQL ストアド プロシージャを実行する方法について説明します。  
+  
+ [OracleDataReader を使用した複数の REF CURSOR からのデータの取得](../../../../docs/framework/data/adonet/retrieving-data-from-multiple-ref-cursors.md)  
+ REF CURSOR パラメーターを返し、**OracleDataReader** を使用して値を読み取る、PL\/SQL ストアド プロシージャを実行する方法について説明します。  
+  
+ [1 つまたは複数の REF CURSOR を使用した DataSet の値の設定](../../../../docs/framework/data/adonet/filling-a-dataset-using-one-or-more-ref-cursors.md)  
+ 2 つの REF CURSOR パラメーターを返し、返された行を <xref:System.Data.DataSet> に入力する、PL\/SQL ストアド プロシージャを実行する方法について説明します。  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-schema-collections.md b/docs/framework/data/adonet/oracle-schema-collections.md
new file mode 100644
index 00000000000..5d4ce1030ea
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-schema-collections.md
@@ -0,0 +1,390 @@
+---
+title: "Oracle スキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89a75de8-dee8-45e2-a97f-254d7e62e7e1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Oracle スキーマ コレクション
+Microsoft .NET Framework Data Provider for Oracle は、共通のスキーマ コレクションに加えて次のスキーマ コレクションをサポートしています。  
+  
+-   列  
+  
+-   Indexes  
+  
+-   IndexColumns  
+  
+-   手順  
+  
+-   シーケンス  
+  
+-   Synonyms  
+  
+-   \[テーブル\]  
+  
+-   Users  
+  
+-   ビュー  
+  
+-   関数  
+  
+-   パッケージ  
+  
+-   PackageBodies  
+  
+-   引数  
+  
+-   UniqueKeys  
+  
+-   PrimaryKeys  
+  
+-   ForeignKeys  
+  
+-   ForeignKeyColumns  
+  
+-   ProcedureParameters  
+  
+## 列  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|テーブル、ビュー、またはクラスターの所有者。|  
+|TABLE\_NAME|String|テーブル、ビュー、またはクラスターの名前。|  
+|COLUMN\_NAME|String|列名。|  
+|ID|Decimal \(10 進数型\)|作成された列のシーケンス番号。|  
+|DATATYPE|String|列のデータ型。|  
+|LENGTH|Decimal \(10 進数型\)|列の長さ \(バイト単位\)。|  
+|PRECISION|Decimal \(10 進数型\)|NUMBER データ型の場合は 10 進有効桁数、FLOAT データ型の場合はバイナリ有効桁数、その他のデータ型の場合は NULL になります。|  
+|SCALE|Decimal \(10 進数型\)|数値の小数点の右側にある数字。|  
+|NULLABLE|String|列に NULL を許可するかどうかを指定します。  列に NOT NULL 制約がある場合、または列が PRIMARY KEY の一部である場合、値は N になります。|  
+  
+## Indexes  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|インデックスの所有者。|  
+|INDEX\_NAME|String|インデックス名。|  
+|INDEX\_TYPE|String|インデックスの型 \(NORMAL、BITMAP、FUNCTION\-BASED NORMAL、FUNCTION\-BASED BITMAP、または DOMAIN\)。|  
+|TABLE\_OWNER|String|インデックス付きオブジェクトの所有者。|  
+|TABLE\_NAME|String|インデックス付きオブジェクト名。|  
+|TABLE\_TYPE|String|インデックス オブジェクトの型 \(TABLE、CLUSTER など\)。|  
+|UNIQUENESS|String|インデックスが UNIQUE または NONUNIQUE のどちらであるかを指定します。|  
+|COMPRESSION|String|インデックスが ENABLED または DISABLED のどちらであるかを指定します。|  
+|PREFIX\_LENGTH|Decimal \(10 進数型\)|圧縮キーのプレフィックス内の列数。|  
+|TABLESPACE\_NAME|String|インデックスを含むテーブルスペースの名前。|  
+|INI\_TRANS|Decimal \(10 進数型\)|トランザクションの初期数。|  
+|MAX\_TRANS|Decimal \(10 進数型\)|トランザクションの最大数。|  
+|INITIAL\_EXTENT|Decimal \(10 進数型\)|初期エクステントのサイズ。|  
+|NEXT\_EXTENT|Decimal \(10 進数型\)|セカンダリ エクステントのサイズ。|  
+|MIN\_EXTENTS|Decimal \(10 進数型\)|セグメント内で許可されているエクステントの最小数。|  
+|MAX\_EXTENTS|Decimal \(10 進数型\)|セグメント内で許可されているエクステントの最大数。|  
+|PCT\_INCREASE|Decimal \(10 進数型\)|エクステントのサイズの増加率。|  
+|PCT\_THRESHOLD|Decimal \(10 進数型\)|インデックスのエントリごとに許可されるブロック領域のしきい値のパーセンテージ。|  
+|INCLUDE\_COLUMN|Decimal \(10 進数型\)|索引構成表の主キー \(オーバーフローなし\) のインデックスに含まれる最後の列の列 ID。  この列は、\*\_TAB\_COLUMNS データ辞書ビューの COLUMN\_ID 列にマップされます。|  
+|FREELISTS|Decimal \(10 進数型\)|このセグメントに割り当てられているプロセスの空きリスト数。|  
+|FREELIST\_GROUPS|Decimal \(10 進数型\)|このセグメントに割り当てられている空きリスト グループの数。|  
+|PCT\_FREE|Decimal \(10 進数型\)|ブロックにある空き領域の最小のパーセンテージ。|  
+|LOGGING|String|ログ情報。|  
+|BLEVEL|Decimal \(10 進数型\)|B\*\-ツリー レベル: ルート ブロックからリーフ ブロックまでのインデックスの深さ。  深さ 0 は、ルート ブロックとリーフ ブロックが同一であることを示します。|  
+|LEAF\_BLOCKS|Decimal \(10 進数型\)|インデックス内のリーフ ブロックの数。|  
+|DISTINCT\_KEYS|Decimal \(10 進数型\)|個別にインデックスが付けられた値の数。  UNIQUE および PRIMARY KEY 制約を強制するインデックスの場合、この値はテーブルの行数 \(USER\_TABLES.NUM\_ROWS\) と同じです。|  
+|AVG\_LEAF\_BLOCKS\_PER\_KEY|Decimal \(10 進数型\)|最も近い整数に丸められた、インデックスの個別の値が表示されるリーフ ブロックの平均数。  UNIQUE および PRIMARY KEY 制約を強制するインデックスの場合、この値は常に 1 になります。|  
+|AVG\_DATA\_BLOCKS\_PER\_KEY|Decimal \(10 進数型\)|最も近い整数に丸められた、インデックス内の個別の値によってポイントされている、テーブル内のデータ ブロックの平均数。  この統計情報は、インデックス列の値を含む行があるデータ ブロックの平均数を示します。|  
+|CLUSTERING\_FACTOR|Decimal \(10 進数型\)|インデックスの値に基づいて順序付けされている、テーブルの行数を示します。|  
+|STATUS|String|分割されていないインデックスが VALID または UNUSABLE のどちらであるかを示します。|  
+|NUM\_ROWS|Decimal \(10 進数型\)|インデックス内の行数。|  
+|SAMPLE\_SIZE|Decimal \(10 進数型\)|インデックスの分析に使用されるサンプルのサイズ。|  
+|LAST\_ANALYZED|DateTime|インデックスが最後に分析された日付。|  
+|DEGREE|String|インデックスがスキャンされるインスタンスごとのスレッド数。|  
+|INSTANCES|String|インデックスがスキャンされるインスタンス数。|  
+|PARTITIONED|String|インデックスが分割されているかどうかを示します \(YES または NO\)。|  
+|TEMPORARY|String|インデックスが一時テーブルにあるかどうかを示します。|  
+|GENERATED|String|インデックスの名前がシステムが生成した名前かどうかを示します \(Y または N\)。|  
+|SECONDARY|String|インデックスが Oracle9i Data Cartridge の ODCIIndexCreate メソッドによって作成されたセカンダリ オブジェクトであるかどうかを示します \(Y または N\)。|  
+|BUFFER\_POOL|String|インデックス ブロックで使用される既定のバッファー プールの名前。|  
+|USER\_STATS|String|統計情報がユーザーによって直接入力されたものかどうかを示します。|  
+|DURATION|String|一時テーブルの存続期間を示します。1\) SYS$SESSION: セッションが存続している間、行が保持されます。2\) SYS$TRANSACTION: COMMIT 後に行が削除されます。3\) 永続テーブルの場合は NULL です。|  
+|PCT\_DIRECT\_ACCESS|Decimal \(10 進数型\)|索引構成表のセカンダリ インデックスでは、VALID であると推測される行のパーセンテージを示します。|  
+|ITYP\_OWNER|String|ドメイン インデックスでは、indextype の所有者を示します。|  
+|ITYP\_NAME|String|ドメイン インデックスでは、indextype の名前を示します。|  
+|PARAMETERS|String|ドメイン インデックスでは、パラメーターの文字列を示します。|  
+|GLOBAL\_STATS|String|分割されたインデックスでは、統計情報がインデックス全体を分析して収集されたものか \(YES\)、または基になるインデックスのパーティションおよびサブパーティションから推測されたものであるか \(NO\) どうかを示します。|  
+|DOMIDX\_STATUS|String|ドメイン インデックスのステータスが反映されます。  NULL: 指定されたインデックスはドメイン インデックスではありません。  VALID: インデックスは有効なドメイン インデックスです。  IDXTYP\_INVLD: このドメイン インデックスのインデックス型は無効です。|  
+|DOMIDX\_OPSTATUS|String|ドメイン インデックス上で実行された操作のステータスが反映されます。NULL: 指定されたインデックスはドメイン インデックスではありません。  VALID: 操作がエラーなく実行されました。  FAILED: エラーによって操作が失敗しました。|  
+|FUNCIDX\_STATUS|String|関数ベースのインデックスのステータスを示します。NULL: これは関数ベースのインデックスではありません。ENABLED: 関数ベースのインデックスが有効になっています。DISABLED: 関数ベースのインデックスが無効になっています。|  
+|JOIN\_INDEX|String|結合インデックスかどうかを示します。|  
+  
+## IndexColumns  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|INDEX\_OWNER|String|インデックスの所有者。|  
+|INDEX\_NAME|String|インデックス名。|  
+|TABLE\_OWNER|String|テーブルまたはクラスターの所有者。|  
+|TABLE\_NAME|String|テーブルまたはクラスターの名前。|  
+|COLUMN\_NAME|String|オブジェクト型列の列名または属性。|  
+|COLUMN\_POSITION|Decimal \(10 進数型\)|インデックス内の列または属性の位置。|  
+|COLUMN\_LENGTH|Decimal \(10 進数型\)|インデックスが付けられた列の長さ。|  
+|CHAR\_LENGTH|Decimal \(10 進数型\)|列の最大コードポイント長。|  
+|DESCEND|String|列が降順で並べ替えられるかどうかを示します。|  
+  
+## 手順  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者。|  
+|OBJECT\_NAME|String|オブジェクト名。|  
+|SUBOBJECT\_NAME|String|サブオブジェクト名 \(partition など\)。|  
+|OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトの辞書オブジェクト数。|  
+|DATA\_OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトを含むセグメントの辞書オブジェクト数。|  
+|LAST\_DDL\_TIME|DateTime|DDL コマンド \(許可および取り消しを含む\) の実行結果として、最後に変更されたオブジェクトのタイムスタンプ。|  
+|TIMESTAMP|String|オブジェクト \(文字データ\) の指定に対するタイムスタンプ。|  
+|STATUS|String|オブジェクトのステータス \(VALID、INVALID、または N\/A\)。|  
+|TEMPORARY|String|オブジェクトが一時的かどうかを示します \(現在のセッションでは、オブジェクト自体に置かれたデータだけが表示される\)。|  
+|GENERATED|String|このオブジェクトの名前がシステムによって生成されたかどうかを示します   \(Y または N\)。|  
+|SECONDARY|String|Oracle9i Data Cartridge の ODCIIndexCreate メソッドによって作成されたセカンダリ オブジェクトかどうかを示します \(Y または N\)。|  
+|CREATED|DateTime|オブジェクトが作成された日付。|  
+  
+## シーケンス  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|SEQUENCE\_OWNER|String|シーケンスの所有者の名前。|  
+|SEQUENCE\_NAME|String|シーケンス名。|  
+|MIN\_VALUE|Decimal \(10 進数型\)|シーケンスの最小値。|  
+|MAX\_VALUE|Decimal \(10 進数型\)|シーケンスの最大値。|  
+|INCREMENT\_BY|Decimal \(10 進数型\)|シーケンスがインクリメントされる値。|  
+|CYCLE\_FLAG|String|限界に到達するとシーケンスはラップされるかを示します。|  
+|ORDER\_FLAG|String|順に生成されたシーケンス番号。|  
+|CACHE\_SIZE|Decimal \(10 進数型\)|キャッシュするシーケンス番号の数。|  
+|LAST\_NUMBER|Decimal \(10 進数型\)|ディスクに書き込まれた最後のシーケンス番号。  シーケンスでキャッシュが使用される場合、ディスクに書き込まれた数はシーケンスのキャッシュに置かれた最後の番号になります。  この番号は多くの場合、使用された最後のシーケンス番号より大きくなります。|  
+  
+## Synonyms  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|シノニムの所有者。|  
+|SYNONYM\_NAME|String|シノニムの名前。|  
+|TABLE\_OWNER|String|シノニムが参照するオブジェクトの所有者。|  
+|TABLE\_NAME|String|シノニムが参照するオブジェクトの名前。|  
+|DB\_LINK|String|参照されるデータベース リンクの名前 \(参照される場合\)。|  
+  
+## \[テーブル\]  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|テーブルの所有者。|  
+|TABLE\_NAME|String|テーブルの名前。|  
+|TYPE|String|テーブルの型。|  
+  
+## Users  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|NAME|String|ユーザー名。|  
+|ID|Decimal \(10 進数型\)|ユーザーの ID 番号。|  
+|CREATEDATE|DateTime|ユーザーの作成日。|  
+  
+## ビュー  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|ビューの所有者。|  
+|VIEW\_NAME|String|ビューの名前。|  
+|TEXT\_LENGTH|Decimal \(10 進数型\)|ビュー テキストの長さ。|  
+|TEXT|String|ビュー テキスト。|  
+|TYPE\_TEXT\_LENGTH|Decimal \(10 進数型\)|型指定されたビューの TYPE 句の長さ。|  
+|TYPE\_TEXT|String|型指定されたビューの TYPE 句。|  
+|OID\_TEXT\_LENGTH|Decimal \(10 進数型\)|型指定されたビューの WITH OID 句の長さ。|  
+|OID\_TEXT|String|型指定されたビューの WITH OID 句。|  
+|VIEW\_TYPE\_OWNER|String|ビューが型指定されたビューである場合の、ビューの型の所有者。|  
+|VIEW\_TYPE|String|ビューが型指定されたビューである場合の、ビューの型。|  
+|SUPERVIEW\_NAME|String|スーパービューの名前。|  
+  
+## 関数  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者。|  
+|OBJECT\_NAME|String|オブジェクト名。|  
+|SUBOBJECT\_NAME|String|サブオブジェクト名 \(partition など\)。|  
+|OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトの辞書オブジェクト数。|  
+|DATA\_OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトを含むセグメントの辞書オブジェクト数。|  
+|OBJECT\_TYPE|String|オブジェクトの型。|  
+|CREATED|DateTime|オブジェクトが作成された日付。|  
+|LAST\_DDL\_TIME|DateTime|DDL コマンド \(許可および取り消しを含む\) の実行結果として、最後に変更されたオブジェクトのタイムスタンプ。|  
+|TIMESTAMP|String|オブジェクト \(文字データ\) の指定に対するタイムスタンプ。|  
+|STATUS|String|オブジェクトのステータス \(VALID、INVALID、または N\/A\)。|  
+|TEMPORARY|String|オブジェクトが一時的かどうかを示します \(現在のセッションでは、オブジェクト自体に置かれたデータだけが表示される\)。|  
+|GENERATED|String|このオブジェクトの名前がシステムによって生成されたかどうかを示します   \(Y または N\)。|  
+|SECONDARY|String|Oracle9i Data Cartridge の ODCIIndexCreate メソッドによって作成されたセカンダリ オブジェクトかどうかを示します \(Y または N\)。|  
+  
+## パッケージ  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者。|  
+|OBJECT\_NAME|String|オブジェクト名。|  
+|SUBOBJECT\_NAME|String|サブオブジェクト名 \(partition など\)。|  
+|OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトの辞書オブジェクト数。|  
+|DATA\_OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトを含むセグメントの辞書オブジェクト数。|  
+|LAST\_DDL\_TIME|DateTime|DDL コマンド \(許可および取り消しを含む\) の実行結果として、最後に変更されたオブジェクトのタイムスタンプ。|  
+|TIMESTAMP|String|オブジェクト \(文字データ\) の指定に対するタイムスタンプ。|  
+|STATUS|String|オブジェクトのステータス \(VALID、INVALID、または N\/A\)。|  
+|TEMPORARY|String|オブジェクトが一時的かどうかを示します \(現在のセッションでは、オブジェクト自体に置かれたデータだけが表示される\)。|  
+|GENERATED|String|このオブジェクトの名前がシステムによって生成されたかどうかを示します   \(Y または N\)。|  
+|SECONDARY|String|Oracle9i Data Cartridge の ODCIIndexCreate メソッドによって作成されたセカンダリ オブジェクトかどうかを示します \(Y または N\)。|  
+|CREATED|DateTime|オブジェクトが作成された日付。|  
+  
+## PackageBodies  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者。|  
+|OBJECT\_NAME|String|オブジェクト名。|  
+|SUBOBJECT\_NAME|String|サブオブジェクト名 \(partition など\)。|  
+|OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトの辞書オブジェクト数。|  
+|DATA\_OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトを含むセグメントの辞書オブジェクト数。|  
+|LAST\_DDL\_TIME|DateTime|DDL コマンド \(許可および取り消しを含む\) の実行結果として、最後に変更されたオブジェクトのタイムスタンプ。|  
+|TIMESTAMP|String|オブジェクト \(文字データ\) の指定に対するタイムスタンプ。|  
+|STATUS|String|オブジェクトのステータス \(VALID、INVALID、または N\/A\)。|  
+|TEMPORARY|String|オブジェクトが一時的かどうかを示します \(現在のセッションでは、オブジェクト自体に置かれたデータだけが表示される\)。|  
+|GENERATED|String|このオブジェクトの名前がシステムによって生成されたかどうかを示します   \(Y または N\)。|  
+|SECONDARY|String|Oracle9i Data Cartridge の ODCIIndexCreate メソッドによって作成されたセカンダリ オブジェクトかどうかを示します \(Y または N\)。|  
+|CREATED|DateTime|オブジェクトが作成された日付。|  
+  
+## 引数  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者の名前。|  
+|PACKAGE\_NAME|String|パッケージ名。|  
+|OBJECT\_NAME|String|プロシージャまたは関数の名前。|  
+|ARGUMENT\_NAME|String|引数の名前。|  
+|POSITION|Decimal \(10 進数型\)|引数リスト内の位置。関数の戻り値の場合は NULL。|  
+|SEQUENCE|Decimal \(10 進数型\)|入れ子になったすべてのレベルを含む引数シーケンス。|  
+|DEFAULT\_VALUE|String|引数の既定値。|  
+|DEFAULT\_LENGTH|Decimal \(10 進数型\)|引数の既定値の長さ。|  
+|IN\_OUT|String|引数の方向 \(IN、OUT、または IN\/OUT\)。|  
+|DATA\_LENGTH|Decimal \(10 進数型\)|列の長さ \(バイト単位\)。|  
+|DATA\_PRECISION|Decimal \(10 進数型\)|小数桁数 \(NUMBER\) またはバイナリ桁数 \(FLOAT\) の長さ。|  
+|DATA\_SCALE|Decimal \(10 進数型\)|数値の小数点の右側にある数字。|  
+|DATA\_TYPE|String|引数のデータ型。|  
+  
+## UniqueKeys  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|制約定義の所有者。|  
+|CONSTRAINT\_NAME|String|制約定義の名前。|  
+|TABLE\_NAME|String|制約定義を持つテーブル \(またはビュー\) に関連付けられた名前。|  
+|SEARCH\_CONDITION|String|CHECK 制約の検索条件のテキスト。|  
+|R\_OWNER|String|参照制約で参照されるテーブルの所有者。|  
+|R\_CONSTRAINT\_NAME|String|参照テーブルの UNIQUE 制約の定義の名前。|  
+|DELETE\_RULE|String|参照制約の削除規則 \(CASCADE または NO ACTION\)。|  
+|STATUS|String|制約の強制ステータス \(ENABLED または DISABLED\)。|  
+|DEFERRABLE|String|制約を遅延可能にするかどうかを示します。|  
+|VALIDATED|String|すべてのデータが制約に従うかどうかを示します \(VALIDATED または NOT VALIDATED\)。|  
+|GENERATED|String|制約の名前がユーザーとシステムのどちらによって生成されたかを示します。|  
+|BAD|String|値 YES は、この制約が世紀をあいまいに指定していることを示します。  このあいまいさによるエラーを回避するには、TO\_DATE 関数に 4 桁の西暦を使って制約を定義し直します。|  
+|RELY|String|有効な制約が強制されたものであるかどうかを示します。|  
+|LAST\_CHANGE|DateTime|制約が最後に有効または無効になった日時を示します。|  
+|INDEX\_OWNER|String|インデックスを所有するユーザーの名前。|  
+|INDEX\_NAME|String|インデックス名。|  
+  
+## PrimaryKeys  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|制約定義の所有者。|  
+|CONSTRAINT\_NAME|String|制約定義の名前。|  
+|TABLE\_NAME|String|制約定義を持つテーブル \(またはビュー\) に関連付けられた名前。|  
+|SEARCH\_CONDITION|String|CHECK 制約の検索条件のテキスト。|  
+|R\_OWNER|String|参照制約で参照されるテーブルの所有者。|  
+|R\_CONSTRAINT\_NAME|String|参照テーブルの UNIQUE 制約の定義の名前。|  
+|DELETE\_RULE|String|参照制約の削除規則 \(CASCADE または NO ACTION\)。|  
+|STATUS|String|制約の強制ステータス \(ENABLED または DISABLED\)。|  
+|DEFERRABLE|String|制約を遅延可能にするかどうかを示します。|  
+|VALIDATED|String|すべてのデータが制約に従うかどうかを示します \(VALIDATED または NOT VALIDATED\)。|  
+|GENERATED|String|制約の名前がユーザーとシステムのどちらによって生成されたかを示します。|  
+|BAD|String|値 YES は、この制約が世紀をあいまいに指定していることを示します。  このあいまいさによるエラーを回避するには、TO\_DATE 関数に 4 桁の西暦を使って制約を定義し直します。|  
+|RELY|String|有効な制約が強制されたものであるかどうかを示します。|  
+|LAST\_CHANGE|DateTime|制約が最後に有効または無効になった日時を示します。|  
+|INDEX\_OWNER|String|インデックスを所有するユーザーの名前。|  
+|INDEX\_NAME|String|インデックス名。|  
+  
+## ForeignKeys  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|PRIMARY\_KEY\_CONSTRAINT\_NAME|String|制約定義の名前。|  
+|PRIMARY\_KEY\_OWNER|String|制約定義の所有者。|  
+|PRIMARY\_KEY\_TABLE\_NAME|String|制約定義を持つテーブル \(またはビュー\) に関連付けられた名前。|  
+|FOREIGN\_KEY\_OWNER|String|制約定義の所有者。|  
+|FOREIGN\_KEY\_CONSTRIANT\_NAME|String|制約定義の名前。|  
+|FOREIGN\_KEY\_TABLE\_NAME|String|制約定義を持つテーブル \(またはビュー\) に関連付けられた名前。|  
+|SEARCH\_CONDITION|String|CHECK 制約の検索条件のテキスト。|  
+|R\_OWNER|String|参照制約で参照されるテーブルの所有者。|  
+|R\_CONSTRAINT\_NAME|String|参照テーブルの UNIQUE 制約の定義の名前。|  
+|DELETE\_RULE|String|参照制約の削除規則 \(CASCADE または NO ACTION\)。|  
+|STATUS|String|制約の強制ステータス \(ENABLED または DISABLED\)。|  
+|VALIDATED|String|すべてのデータが制約に従うかどうかを示します \(VALIDATED または NOT VALIDATED\)。|  
+|GENERATED|String|制約の名前がユーザーとシステムのどちらによって生成されたかを示します。|  
+|RELY|String|有効な制約が強制されたものであるかどうかを示します。|  
+|LAST\_CHANGE|DateTime|制約が最後に有効または無効になった日時を示します。|  
+|INDEX\_OWNER|String|インデックスを所有するユーザーの名前。|  
+|INDEX\_NAME|String|インデックス名。|  
+  
+## ForeignKeyColumns  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|制約定義の所有者。|  
+|CONSTRAINT\_NAME|String|制約定義の名前。|  
+|TABLE\_NAME|String|制約定義を持つテーブル名。|  
+|COLUMN\_NAME|String|制約定義で指定されているオブジェクト型列の列名または属性名。|  
+|POSITION|Decimal \(10 進数型\)|オブジェクトの定義内の列または属性の元の位置。|  
+  
+## ProcedureParameters  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|OWNER|String|オブジェクトの所有者。|  
+|OBJECT\_NAME|String|プロシージャまたは関数の名前。|  
+|PACKAGE\_NAME|String|プロシージャまたは関数の名前。|  
+|OBJECT\_ID|Decimal \(10 進数型\)|オブジェクトのオブジェクト番号。|  
+|OVERLOAD|String|オーバーロードの一意識別子。|  
+|ARGUMENT\_NAME|String|引数の名前。|  
+|POSITION|Decimal \(10 進数型\)|引数リスト内の位置。関数の戻り値の場合は NULL。|  
+|SEQUENCE|Decimal \(10 進数型\)|入れ子になったすべてのレベルを含む引数シーケンス。|  
+|DATA\_LEVEL|Decimal \(10 進数型\)|複合型の引数の入れ子の深さ。|  
+|DATA\_TYPE|String|引数のデータ型。|  
+|DEFAULT\_VALUE|String|引数の既定値。|  
+|DEFAULT\_LENGTH|Decimal \(10 進数型\)|引数の既定値の長さ。|  
+|IN\_OUT|String|引数の方向 \(IN、OUT、または IN\/OUT\)。|  
+|DATA\_LENGTH|Decimal \(10 進数型\)|列の長さ \(バイト単位\)。|  
+|DATA\_PRECISION|Decimal \(10 進数型\)|小数桁数 \(NUMBER\) またはバイナリ桁数 \(FLOAT\) の長さ。|  
+|DATA\_SCALE|Decimal \(10 進数型\)|数値の小数点の右側にある数字。|  
+|RADIX|Decimal \(10 進数型\)|数値の引数の基数。|  
+|CHARACTER\_SET\_NAME|String|引数の文字セットの名前。|  
+|TYPE\_OWNER|String|引数の型の所有者。|  
+|TYPE\_NAME|String|引数の型の名前。  パッケージ ローカル型である \(パッケージ指定で宣言されている\) 場合、この列にはパッケージ名が表示されます。|  
+|TYPE\_SUBNAME|String|パッケージ ローカル型にのみ関係します。  TYPE\_NAME 列で特定されたパッケージで宣言された型の名前が表示されます。|  
+|TYPE\_LINK|String|TYPE\_NAME 列で特定されたパッケージがリモート パッケージである場合は、パッケージ ローカル型のみに関係します。  この列には、リモート パッケージの参照に使用されるデータベース リンクが表示されます。|  
+|PLS\_TYPE|String|数値引数の場合、引数の PL\/SQL 型の名前を示します。  その他の場合は NULL が返されます。|  
+|CHAR\_LENGTH|Decimal \(10 進数型\)|文字列データ型の文字数制限。|  
+|CHAR\_USED|String|文字列のバイト数制限 \(B\) または文字数制限 \(C\) が正式であるかどうかを示します。|  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracle-sequences.md b/docs/framework/data/adonet/oracle-sequences.md
new file mode 100644
index 00000000000..b2dee75aaf7
--- /dev/null
+++ b/docs/framework/data/adonet/oracle-sequences.md
@@ -0,0 +1,110 @@
+---
+title: "Oracle シーケンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27cd371d-8252-414d-b5b2-5d31fa44b585
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Oracle シーケンス
+.NET Framework Data Provider for Oracle では、<xref:System.Data.OracleClient.OracleDataAdapter> を使用して挿入操作を実行した後、サーバーによって生成されたキー値 \(Oracle シーケンス\) を取得できます。  
+  
+ SQL Server および Oracle は、主キーとして指定できる自動増分列の作成をサポートします。  これらの値はテーブルに行を追加するとサーバーによって自動的に生成されます。  SQL Server では列の Identity プロパティを設定し、Oracle では Sequence を作成します。  SQL Server の自動増分列と Oracle シーケンスの違いは、次のとおりです。  
+  
+-   SQL Server では列を自動増分列として指定すると、新しい行を挿入するたびに SQL Server によって新しい列値が自動的に生成されます。  
+  
+-   Oracle ではシーケンスを作成することによって、テーブルに新しい列値を生成します。ただし、シーケンスとテーブルまたはシーケンスと列の間に直接的な関係はありません。  Oracle シーケンスは、テーブルやストアド プロシージャと同様のオブジェクトです。  
+  
+ Oracle データベースにシーケンスを作成する場合は、初期値と増分値を定義できます。  新しい行を送信する前に、新しい値のシーケンスを照会することもできます。  つまり、コードでデータベースに行を挿入する前に、新しい行のキー値を調べることができます。  
+  
+ SQL Server および ADO.NET を使用した自動増分列の作成の詳細については、「[ID 値および Autonumber 値の取得](../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)」および「[AutoIncrement 列の作成](../../../../docs/framework/data/adonet/dataset-datatable-dataview/creating-autoincrement-columns.md)」を参照してください。  
+  
+## 例  
+ 次の C\# コードは、Oracle データベースから新しいシーケンス値を取得する例です。  新しい行を送信する INSERT INTO クエリでシーケンスを参照した後、Oracle10g で導入された RETURNING 句を使って、生成されたシーケンス値を返します。  この例では、保留状態の一連の新しい行を、ADO.NET の自動増分機能を使って <xref:System.Data.DataTable> に追加し、"プレースホルダー" の主キー値を生成します。  ADO.NET が新しい行に対して生成した増分値は、単なる "プレースホルダー" である点に注意してください。  つまり、データベースで生成される値は、ADO.NET によって生成された値とは必ずしも一致しません。  
+  
+ この例では、保留中の挿入をデータベースに送信する前に行の内容を表示します。  次に、新しい <xref:System.Data.OracleClient.OracleDataAdapter> オブジェクトを作成して、その <xref:System.Data.OracleClient.OracleDataAdapter.InsertCommand%2A> プロパティと <xref:System.Data.OracleClient.OracleDataAdapter.UpdateBatchSize%2A> プロパティを設定します。  この例では、サーバーによって生成された値を、出力パラメーターを使って返すロジックも使用されています。  その後、更新操作を実行し、保留中の行を送信して、<xref:System.Data.DataTable> の内容を表示します。  
+  
+```csharp  
+public void OracleSequence(String connectionString)  
+{  
+   String insertString =   
+      "INSERT INTO SequenceTest_Table (ID, OtherColumn)" +  
+      "VALUES (SequenceTest_Sequence.NEXTVAL, :OtherColumn)" +  
+      "RETURNING ID INTO :ID";  
+  
+   using (OracleConnection conn = new OracleConnection(connectionString))  
+   {  
+      //Open a connection.  
+      conn.Open();  
+      OracleCommand cmd = conn.CreateCommand();  
+  
+      // Prepare the database.  
+      cmd.CommandText = "DROP SEQUENCE SequenceTest_Sequence";  
+      try { cmd.ExecuteNonQuery(); } catch { }  
+  
+      cmd.CommandText = "DROP TABLE SequenceTest_Table";  
+      try { cmd.ExecuteNonQuery(); } catch { }  
+  
+      cmd.CommandText = "CREATE TABLE SequenceTest_Table " +  
+                     "(ID int PRIMARY KEY, OtherColumn varchar(255))";  
+      cmd.ExecuteNonQuery();  
+  
+      cmd.CommandText = "CREATE SEQUENCE SequenceTest_Sequence " +  
+                        "START WITH 100 INCREMENT BY 5";  
+      cmd.ExecuteNonQuery();  
+  
+      DataTable testTable = new DataTable();  
+      DataColumn column = testTable.Columns.Add("ID", typeof(int));  
+      column.AutoIncrement = true;  
+      column.AutoIncrementSeed = -1;  
+      column.AutoIncrementStep = -1;  
+      testTable.PrimaryKey = new DataColumn[] { column };  
+      testTable.Columns.Add("OtherColumn", typeof(string));  
+      for (int rowCounter = 1; rowCounter <= 15; rowCounter++)  
+      {  
+         testTable.Rows.Add(null, "Row #" + rowCounter.ToString());  
+      }  
+  
+      Console.WriteLine("Before Update => ");  
+      foreach (DataRow row in testTable.Rows)  
+      {  
+         Console.WriteLine("   {0} - {1}", row["ID"], row["OtherColumn"]);  
+      }  
+      Console.WriteLine();  
+  
+      cmd.CommandText =   
+        "SELECT ID, OtherColumn FROM SequenceTest_Table";  
+      OracleDataAdapter da = new OracleDataAdapter(cmd);  
+      da.InsertCommand = new OracleCommand(insertString, conn);  
+      da.InsertCommand.Parameters.Add(":ID", OracleType.Int32, 0, "ID");  
+      da.InsertCommand.Parameters[0].Direction = ParameterDirection.Output;  
+      da.InsertCommand.Parameters.Add(":OtherColumn", OracleType.VarChar, 255, "OtherColumn");  
+      da.InsertCommand.UpdatedRowSource = UpdateRowSource.OutputParameters;  
+      da.UpdateBatchSize = 10;  
+  
+      da.Update(testTable);  
+  
+      Console.WriteLine("After Update => ");  
+      foreach (DataRow row in testTable.Rows)  
+      {  
+         Console.WriteLine("   {0} - {1}", row["ID"], row["OtherColumn"]);  
+      }  
+      // Close the connection.  
+      conn.Close();  
+   }  
+}  
+```  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/oracletypes.md b/docs/framework/data/adonet/oracletypes.md
new file mode 100644
index 00000000000..e525ddaf97c
--- /dev/null
+++ b/docs/framework/data/adonet/oracletypes.md
@@ -0,0 +1,127 @@
+---
+title: "OracleType | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 18143304-d5c7-4c95-9995-678088d0c142
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OracleType
+.NET Framework Data Provider for Oracle には、Oracle データ型で使用されるいくつかの構造体が含まれています。  その中には、<xref:System.Data.OracleClient.OracleNumber> や <xref:System.Data.OracleClient.OracleString> があります。  
+  
+> [!NOTE]
+>  これらの構造体に関する詳細な一覧については、「<xref:System.Data.OracleClient>」を参照してください。  
+  
+ C\# の例を以下に示します。  
+  
+-   Oracle テーブルを作成し、データを読み込みます。  
+  
+-   <xref:System.Data.OracleClient.OracleDataReader> を使用してデータにアクセスし、いくつかの <xref:System.Data.OracleClient.OracleType> 構造体を使用してデータを表示します。  
+  
+## Oracle テーブルの作成  
+ この例では、Oracle テーブルを作成し、データを読み込みます。  次の例を実行する前に、この例を実行する必要があります。  
+  
+```csharp  
+public void Setup(string connectionString)  
+   {  
+   OracleConnection conn = new OracleConnection(connectionString);  
+   try  
+      {  
+      conn.Open();  
+      OracleCommand cmd = conn.CreateCommand();  
+      cmd.CommandText ="CREATE TABLE OracleTypesTable " +  
+        "(MyVarchar2 varchar2(3000),MyNumber number(28,4) " +  
+        "PRIMARY KEY ,MyDate date, MyRaw raw(255))";  
+      cmd.ExecuteNonQuery();  
+      cmd.CommandText ="INSERT INTO OracleTypesTable VALUES " +  
+        "( 'test', 2, to_date('2000-01-11 12:54:01','yyyy-mm-dd " +  
+        "hh24:mi:ss'), '0001020304' )";  
+      cmd.ExecuteNonQuery();  
+      }  
+   catch(Exception)  
+   {  
+   }  
+   finally  
+   {  
+      conn.Close();  
+   }  
+}  
+```  
+  
+## Oracle テーブルからのデータの取得  
+ この例では、**OracleDataReader** を使用してデータにアクセスし、いくつかの **OracleType** 構造体を使用してデータを表示します。  
+  
+```csharp  
+public void ReadOracleTypesExample(string connectionString)  
+   {  
+   OracleConnection myConnection =   
+      new OracleConnection(connectionString);  
+   myConnection.Open();  
+   OracleCommand myCommand = myConnection.CreateCommand();  
+  
+   try  
+      {  
+      myCommand.CommandText = "SELECT * from OracleTypesTable";  
+      OracleDataReader oracledatareader1 = myCommand.ExecuteReader();  
+      oracledatareader1.Read();  
+  
+      //Using the oracle specific getters for each type is faster than  
+      //using GetOracleValue.  
+  
+      //First column, MyVarchar2, is a VARCHAR2 data type in Oracle  
+      //Server and maps to OracleString.  
+      OracleString oraclestring1 =   
+        oracledatareader1.GetOracleString(0);  
+      Console.WriteLine("OracleString " + oraclestring1.ToString());  
+  
+      //Second column, MyNumber, is a NUMBER data type in Oracle Server  
+      //and maps to OracleNumber.  
+      OracleNumber oraclenumber1 =   
+        oracledatareader1.GetOracleNumber(1);  
+      Console.WriteLine("OracleNumber " + oraclenumber1.ToString());  
+  
+      //Third column, MyDate, is a DATA data type in Oracle Server  
+      //and maps to OracleDateTime.  
+      OracleDateTime oracledatetime1 =   
+        oracledatareader1.GetOracleDateTime(2);  
+      Console.WriteLine("OracleDateTime " + oracledatetime1.ToString());  
+  
+      //Fourth column, MyRaw, is a RAW data type in Oracle Server and  
+      //maps to OracleBinary.  
+      OracleBinary oraclebinary1 =   
+        oracledatareader1.GetOracleBinary(3);  
+      //Calling value on a null OracleBinary throws  
+      //OracleNullValueException; therefore, check for a null value.  
+      if (oraclebinary1.IsNull==false)  
+      {  
+         foreach(byte b in oraclebinary1.Value)  
+         {  
+            Console.WriteLine("byte " + b.ToString());  
+         }  
+      }  
+      oracledatareader1.Close();  
+   }  
+   catch(Exception e)  
+   {  
+       Console.WriteLine(e.ToString());  
+   }  
+   finally  
+   {  
+       myConnection.Close();  
+   }  
+}  
+```  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/paging-through-a-query-result.md b/docs/framework/data/adonet/paging-through-a-query-result.md
new file mode 100644
index 00000000000..8dc692e78c6
--- /dev/null
+++ b/docs/framework/data/adonet/paging-through-a-query-result.md
@@ -0,0 +1,132 @@
+---
+title: "クエリ結果のページング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa360c46-e5f8-411e-a711-46997771133d
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# クエリ結果のページング
+クエリ結果のページングとは、クエリ結果をデータの小さなサブセット、つまりページに分けて返すプロセスです。  クエリ結果のページングは、結果を管理しやすい小さな単位でユーザーに表示するために行われる一般的な処理です。  
+  
+ **DataAdapter** には、**Fill** メソッドのオーバーロードを通じて 1 ページ分のデータだけを返す機能が用意されています。  しかしこれは大きなクエリ結果のページングには適していません。**DataAdapter** が目的の <xref:System.Data.DataTable> または <xref:System.Data.DataSet> に、要求されたレコードだけを格納する一方で、クエリ全体を返すためのリソースが使用されるためです。  クエリ全体を返す必要があるリソースを使用せずにデータ ソースから 1 ページ分のデータを返すには、必要な行だけ返すように限定する抽出条件をクエリに追加します。  
+  
+ **Fill** メソッドを使用して 1 ページ分のデータを返すには、データ ページの先頭レコードを指定する **startRecord** パラメーターおよびデータ ページのレコード数を指定する **maxRecords** パラメーターを指定します。  
+  
+ **Fill** メソッドを使用してクエリ結果の最初のページ \(ページ サイズ : 5 つのレコード\) を返す方法を次のコード サンプルに示します。  
+  
+```vb  
+Dim currentIndex As Integer = 0  
+Dim pageSize As Integer = 5  
+  
+Dim orderSQL As String = "SELECT * FROM dbo.Orders ORDER BY OrderID"  
+' Assumes that connection is a valid SqlConnection object.  
+Dim adapter As SqlDataAdapter = _  
+  New SqlDataAdapter(orderSQL, connection)  
+  
+Dim dataSet As DataSet = New DataSet()  
+adapter.Fill(dataSet, currentIndex, pageSize, "Orders")  
+```  
+  
+```csharp  
+int currentIndex = 0;  
+int pageSize = 5;  
+  
+string orderSQL = "SELECT * FROM Orders ORDER BY OrderID";  
+// Assumes that connection is a valid SqlConnection object.  
+SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);  
+  
+DataSet dataSet = new DataSet();  
+adapter.Fill(dataSet, currentIndex, pageSize, "Orders");  
+```  
+  
+ 上記の例では、**DataSet** に 5 つのレコードだけが格納されますが、**Orders** テーブル全体が返されます。  **DataSet** にこれと同じ 5 つのレコードを格納し、5 つのレコードだけを返すには、次のコード サンプルに示すように SQL ステートメントで TOP 句と WHERE 句を使用します。  
+  
+```vb  
+Dim pageSize As Integer = 5  
+  
+Dim orderSQL As String = "SELECT TOP " & pageSize & _  
+  " * FROM Orders ORDER BY OrderID"  
+Dim adapter As SqlDataAdapter = _  
+  New SqlDataAdapter(orderSQL, connection)  
+  
+Dim dataSet As DataSet = New DataSet()  
+adapter.Fill(dataSet, "Orders")   
+```  
+  
+```csharp  
+int pageSize = 5;  
+  
+string orderSQL = "SELECT TOP " + pageSize +   
+  " * FROM Orders ORDER BY OrderID";  
+SqlDataAdapter adapter = new SqlDataAdapter(orderSQL, connection);  
+  
+DataSet dataSet = new DataSet();  
+adapter.Fill(dataSet, "Orders");  
+```  
+  
+ この方法でクエリ結果をページングするときは、次のレコード ページを返すコマンドに一意の ID を渡すために、行を順序付けする固有の識別子を保存する必要があります。次のコード サンプルで示します。  
+  
+```vb  
+Dim lastRecord As String = _  
+  dataSet.Tables("Orders").Rows(pageSize - 1)("OrderID").ToString()  
+```  
+  
+```csharp  
+string lastRecord =   
+  dataSet.Tables["Orders"].Rows[pageSize - 1]["OrderID"].ToString();  
+```  
+  
+ **startRecord** パラメーターおよび **maxRecords** パラメーターを受け取る **Fill** メソッドのオーバーロードを使用して次のレコード ページを返すには、現在のレコード インデックスをページ サイズの分だけインクリメントし、テーブルにレコード ページを格納します。  **DataSet** に 1 ページ分のレコードだけを追加する場合でも、データベース サーバーはクエリ結果全体を返すことに注意してください。  次のデータ ページを格納する前にテーブル行をクリアするコード サンプルを次に示します。  データベース サーバーとのやり取りを減らすために、ローカルのキャッシュに、返された一定数の行を保存することもできます。  
+  
+```vb  
+currentIndex = currentIndex + pageSize  
+  
+dataSet.Tables("Orders").Rows.Clear()  
+  
+adapter.Fill(dataSet, currentIndex, pageSize, "Orders")  
+```  
+  
+```csharp  
+currentIndex += pageSize;  
+  
+dataSet.Tables["Orders"].Rows.Clear();  
+  
+adapter.Fill(dataSet, currentIndex, pageSize, "Orders");  
+```  
+  
+ データベース サーバーによってクエリ全体を返さずに次のレコード ページを返すには、SELECT ステートメントに限定的な抽出条件を指定します。  上の例では最後に返されたレコードが保存されますが、次のコード サンプルに示すようにそのレコードを WHERE 句で使用するとクエリの開始点を指定できます。  
+  
+```vb  
+orderSQL = "SELECT TOP " & pageSize & _  
+  " * FROM Orders WHERE OrderID > " & lastRecord & " ORDER BY OrderID"  
+adapter.SelectCommand.CommandText = orderSQL  
+  
+dataSet.Tables("Orders").Rows.Clear()  
+  
+adapter.Fill(dataSet, "Orders")  
+```  
+  
+```csharp  
+orderSQL = "SELECT TOP " + pageSize +   
+  " * FROM Orders WHERE OrderID > " + lastRecord + " ORDER BY OrderID";  
+adapter.SelectCommand.CommandText = orderSQL;  
+  
+dataSet.Tables["Orders"].Rows.Clear();  
+  
+adapter.Fill(dataSet, "Orders");  
+```  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/performance-counters.md b/docs/framework/data/adonet/performance-counters.md
new file mode 100644
index 00000000000..7faa7b8b7e5
--- /dev/null
+++ b/docs/framework/data/adonet/performance-counters.md
@@ -0,0 +1,407 @@
+---
+title: "ADO.NET でのパフォーマンス カウンター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b121b71-78f8-4ae2-9aa1-0b2e15778e57
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# ADO.NET でのパフォーマンス カウンター
+ADO.NET 2.0 では、<xref:System.Data.SqlClient> と <xref:System.Data.OracleClient> の両方をサポートする新しいパフォーマンス カウンターが導入されました。  以前のバージョンの ADO.NET で利用されていた <xref:System.Data.SqlClient> のパフォーマンス カウンターは廃止され、このトピックで説明する新しいパフォーマンス カウンターに置き換えられました。  ADO.NET のパフォーマンス カウンターを使用することで、アプリケーションやそれによって使用される接続リソースのステータスを監視できます。  パフォーマンス カウンターは、Windows パフォーマンス モニターを使って監視できるほか、<xref:System.Diagnostics> 名前空間の <xref:System.Diagnostics.PerformanceCounter> クラスを使用することでプログラムから監視することもできます。  
+  
+## 利用可能なパフォーマンス カウンター  
+ 次の表に示したように、<xref:System.Data.SqlClient> および <xref:System.Data.OracleClient> には現在、14 種類のパフォーマンス カウンターが存在します。  個々のカウンターの名前は、Microsoft .NET Framework の地域別バージョン全体でローカライズされているわけではないことに注意してください。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|`HardConnectsPerSecond`|データベース サーバーに対する 1 秒あたりの接続数。|  
+|`HardDisconnectsPerSecond`|データベース サーバーに対する 1 秒あたりの切断数。|  
+|`NumberOfActiveConnectionPoolGroups`|アクティブな一意の接続プール グループの数。  このカウンターは、AppDomain に見つかった一意の接続文字列数によって制御されます。|  
+|`NumberOfActiveConnectionPools`|接続プールの合計数。|  
+|`NumberOfActiveConnections`|現在使用中のアクティブな接続の数。 **Note:**  既定では、このパフォーマンス カウンターが無効にされています。  このパフォーマンス カウンターを有効にするには、「[既定ではオフになっているカウンターのアクティブ化](#ActivatingOffByDefault)」を参照してください。|  
+|`NumberOfFreeConnections`|接続プール内の利用可能な接続数。 **Note:**  既定では、このパフォーマンス カウンターが無効にされています。  このパフォーマンス カウンターを有効にするには、「[既定ではオフになっているカウンターのアクティブ化](#ActivatingOffByDefault)」を参照してください。|  
+|`NumberOfInactiveConnectionPoolGroups`|排除対象としてマークされた一意の接続プール グループの数。  このカウンターは、AppDomain に見つかった一意の接続文字列数によって制御されます。|  
+|`NumberOfInactiveConnectionPools`|最近のアクティビティが存在せず、破棄待ち状態となっている、アクティブでない接続プールの数。|  
+|`NumberOfNonPooledConnections`|プールされていないアクティブな接続の数。|  
+|`NumberOfPooledConnections`|接続プール インフラストラクチャによって管理されているアクティブな接続の数。|  
+|`NumberOfReclaimedConnections`|アプリケーションによって `Close` も `Dispose` も呼び出されなかった場合に、ガベージ コレクションによって回収された接続の数。  接続を明示的に閉じるか破棄しないと、パフォーマンスが低下します。|  
+|`NumberOfStasisConnections`|現在アクションの完了を待っている \(そのためにアプリケーションからは使用できない\) 接続の数。|  
+|`SoftConnectsPerSecond`|接続プールからプルされているアクティブな接続の数。 **Note:**  既定では、このパフォーマンス カウンターが無効にされています。  このパフォーマンス カウンターを有効にするには、「[既定ではオフになっているカウンターのアクティブ化](#ActivatingOffByDefault)」を参照してください。|  
+|`SoftDisconnectsPerSecond`|接続プールに戻されているアクティブな接続の数。 **Note:**  既定では、このパフォーマンス カウンターが無効にされています。  このパフォーマンス カウンターを有効にするには、「[既定ではオフになっているカウンターのアクティブ化](#ActivatingOffByDefault)」を参照してください。|  
+  
+### 接続プール グループと接続プール  
+ Windows 認証 \(統合セキュリティ\) を使用している場合、`NumberOfActiveConnectionPoolGroups` と `NumberOfActiveConnectionPools` の両方のパフォーマンス カウンターを監視する必要があります。  なぜなら、接続プール グループは接続文字列単位でマップされるためです。  統合セキュリティを使用した場合、接続文字列にマップされた接続プールの他に、個々の Windows ID 用に別々のプールが作成されます。  たとえば、同じ AppDomain に属する Fred と Julie が、どちらも `"Data Source=MySqlServer;Integrated Security=true"` という接続文字列を使用した場合、その接続文字列に対応した接続プール グループが作成され、それに加えて、2 つのプール \(Fred 用と Julie 用\) が作成されます。  John と Martha がまったく同じ SQL Server ログインを持った接続文字列 `"Data Source=MySqlServer;User Id=lowPrivUser;Password=Strong?Password"` を使用した場合は、**lowPrivUser** の ID に対して単一のプールが作成されます。  
+  
+<a name="ActivatingOffByDefault"></a>   
+### 既定ではオフになっているカウンターのアクティブ化  
+ `NumberOfFreeConnections`、`NumberOfActiveConnections`、`SoftDisconnectsPerSecond`、`SoftConnectsPerSecond` の各パフォーマンス カウンターは、既定ではオフになっています。  有効にするには、アプリケーションの構成ファイルに次の情報を追加します。  
+  
+```  
+<system.diagnostics>  
+  <switches>  
+    <add name="ConnectionPoolPerformanceCounterDetail"  
+         value="4"/>  
+  </switches>  
+</system.diagnostics>  
+```  
+  
+## パフォーマンス カウンターの値の取得  
+ 次のコンソール アプリケーションは、アプリケーションでパフォーマンス カウンターの値を取得する方法を示しています。  すべての ADO.NET パフォーマンス カウンターの情報を取得できるように、接続を開いてアクティブにする必要があります。  
+  
+> [!NOTE]
+>  この例では、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] に含まれるサンプルの **AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカル コンピューターにインストールされていること、SqlExpress というインスタンス名で実行されていること、接続文字列に指定された情報と一致する SQL Server ログインが作成済みであることを想定しています。  既定のセキュリティ設定を使用するようにサーバーが構成されている場合、そのままでは Windows 認証しか許可されないため、SQL Server ログインを有効にする必要があります。  接続文字列は環境に合わせて変更してください。  
+  
+### 例  
+  
+```vb  
+Option Explicit On  
+Option Strict On  
+  
+Imports System.Data.SqlClient  
+Imports System.Diagnostics  
+Imports System.Runtime.InteropServices  
+  
+Class Program  
+  
+    Private PerfCounters(9) As PerformanceCounter  
+    Private connection As SqlConnection = New SqlConnection  
+  
+    Public Shared Sub Main()  
+        Dim prog As Program = New Program  
+        ' Open a connection and create the performance counters.   
+        prog.connection.ConnectionString = _  
+           GetIntegratedSecurityConnectionString()  
+        prog.SetUpPerformanceCounters()  
+        Console.WriteLine("Available Performance Counters:")  
+  
+        ' Create the connections and display the results.  
+        prog.CreateConnections()  
+        Console.WriteLine("Press Enter to finish.")  
+        Console.ReadLine()  
+    End Sub  
+  
+    Private Sub CreateConnections()  
+        ' List the Performance counters.  
+        WritePerformanceCounters()  
+  
+        ' Create 4 connections and display counter information.  
+        Dim connection1 As SqlConnection = New SqlConnection( _  
+           GetIntegratedSecurityConnectionString)  
+        connection1.Open()  
+        Console.WriteLine("Opened the 1st Connection:")  
+        WritePerformanceCounters()  
+  
+        Dim connection2 As SqlConnection = New SqlConnection( _  
+           GetSqlConnectionStringDifferent)  
+        connection2.Open()  
+        Console.WriteLine("Opened the 2nd Connection:")  
+        WritePerformanceCounters()  
+  
+        Console.WriteLine("Opened the 3rd Connection:")  
+        Dim connection3 As SqlConnection = New SqlConnection( _  
+           GetSqlConnectionString)  
+        connection3.Open()  
+        WritePerformanceCounters()  
+  
+        Dim connection4 As SqlConnection = New SqlConnection( _  
+           GetSqlConnectionString)  
+        connection4.Open()  
+        Console.WriteLine("Opened the 4th Connection:")  
+        WritePerformanceCounters()  
+  
+        connection1.Close()  
+        Console.WriteLine("Closed the 1st Connection:")  
+        WritePerformanceCounters()  
+  
+        connection2.Close()  
+        Console.WriteLine("Closed the 2nd Connection:")  
+        WritePerformanceCounters()  
+  
+        connection3.Close()  
+        Console.WriteLine("Closed the 3rd Connection:")  
+        WritePerformanceCounters()  
+  
+        connection4.Close()  
+        Console.WriteLine("Closed the 4th Connection:")  
+        WritePerformanceCounters()  
+    End Sub  
+  
+    Private Enum ADO_Net_Performance_Counters  
+        NumberOfActiveConnectionPools  
+        NumberOfReclaimedConnections  
+        HardConnectsPerSecond  
+        HardDisconnectsPerSecond  
+        NumberOfActiveConnectionPoolGroups  
+        NumberOfInactiveConnectionPoolGroups  
+        NumberOfInactiveConnectionPools  
+        NumberOfNonPooledConnections  
+        NumberOfPooledConnections  
+        NumberOfStasisConnections  
+        ' The following performance counters are more expensive to track.  
+        ' Enable ConnectionPoolPerformanceCounterDetail in your config file.  
+        '     SoftConnectsPerSecond  
+        '     SoftDisconnectsPerSecond  
+        '     NumberOfActiveConnections  
+        '     NumberOfFreeConnections  
+    End Enum  
+  
+    Private Sub SetUpPerformanceCounters()  
+        connection.Close()  
+        Me.PerfCounters(9) = New PerformanceCounter()  
+  
+        Dim instanceName As String = GetInstanceName()  
+        Dim apc As Type = GetType(ADO_Net_Performance_Counters)  
+        Dim i As Integer = 0  
+        Dim s As String = ""  
+        For Each s In [Enum].GetNames(apc)  
+            Me.PerfCounters(i) = New PerformanceCounter()  
+            Me.PerfCounters(i).CategoryName = ".NET Data Provider for SqlServer"  
+            Me.PerfCounters(i).CounterName = s  
+            Me.PerfCounters(i).InstanceName = instanceName  
+            i = (i + 1)  
+        Next  
+    End Sub  
+  
+    Private Declare Function GetCurrentProcessId Lib "kernel32.dll" () As Integer  
+  
+    Private Function GetInstanceName() As String  
+        'This works for Winforms apps.   
+        Dim instanceName As String = _  
+           System.Reflection.Assembly.GetEntryAssembly.GetName.Name  
+  
+        ' Must replace special characters like (, ), #, /, \\   
+        Dim instanceName2 As String = _  
+           AppDomain.CurrentDomain.FriendlyName.ToString.Replace("(", "[") _  
+           .Replace(")", "]").Replace("#", "_").Replace("/", "_").Replace("\\", "_")  
+  
+        'For ASP.NET applications your instanceName will be your CurrentDomain's   
+        'FriendlyName. Replace the line above that sets the instanceName with this:   
+        'instanceName = AppDomain.CurrentDomain.FriendlyName.ToString.Replace("(", "[") _  
+        '    .Replace(")", "]").Replace("#", "_").Replace("/", "_").Replace("\\", "_")  
+  
+        Dim pid As String = GetCurrentProcessId.ToString  
+        instanceName = (instanceName + ("[" & (pid & "]")))  
+        Console.WriteLine("Instance Name: {0}", instanceName)  
+        Console.WriteLine("---------------------------")  
+        Return instanceName  
+    End Function  
+  
+    Private Sub WritePerformanceCounters()  
+        Console.WriteLine("---------------------------")  
+        For Each p As PerformanceCounter In Me.PerfCounters  
+            Console.WriteLine("{0} = {1}", p.CounterName, p.NextValue)  
+        Next  
+        Console.WriteLine("---------------------------")  
+    End Sub  
+  
+    Private Shared Function GetIntegratedSecurityConnectionString() As String  
+        ' To avoid storing the connection string in your code,   
+        ' you can retrive it from a configuration file.   
+        Return ("Data Source=.\SqlExpress;Integrated Security=True;" &   
+          "Initial Catalog=AdventureWorks")  
+    End Function  
+  
+    Private Shared Function GetSqlConnectionString() As String  
+        ' To avoid storing the connection string in your code,   
+        ' you can retrive it from a configuration file.   
+        Return ("Data Source=.\SqlExpress;User Id=LowPriv;Password=Data!05;" &   
+          "Initial Catalog=AdventureWorks")  
+    End Function  
+  
+    Private Shared Function GetSqlConnectionStringDifferent() As String  
+        ' To avoid storing the connection string in your code,   
+        ' you can retrive it from a configuration file.   
+        Return ("Initial Catalog=AdventureWorks;Data Source=.\SqlExpress;" & _  
+          "User Id=LowPriv;Password=Data!05;")  
+    End Function  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Data.SqlClient;  
+using System.Diagnostics;  
+using System.Runtime.InteropServices;  
+  
+class Program  
+{  
+    PerformanceCounter[] PerfCounters = new PerformanceCounter[10];  
+    SqlConnection connection = new SqlConnection();  
+  
+    static void Main()  
+    {  
+        Program prog = new Program();  
+        // Open a connection and create the performance counters.  
+        prog.connection.ConnectionString =  
+           GetIntegratedSecurityConnectionString();  
+        prog.SetUpPerformanceCounters();  
+        Console.WriteLine("Available Performance Counters:");  
+  
+        // Create the connections and display the results.  
+        prog.CreateConnections();  
+        Console.WriteLine("Press Enter to finish.");  
+        Console.ReadLine();  
+    }  
+  
+    private void CreateConnections()  
+    {  
+        // List the Performance counters.  
+        WritePerformanceCounters();  
+  
+        // Create 4 connections and display counter information.  
+        SqlConnection connection1 = new SqlConnection(  
+              GetIntegratedSecurityConnectionString());  
+        connection1.Open();  
+        Console.WriteLine("Opened the 1st Connection:");  
+        WritePerformanceCounters();  
+  
+        SqlConnection connection2 = new SqlConnection(  
+              GetSqlConnectionStringDifferent());  
+        connection2.Open();  
+        Console.WriteLine("Opened the 2nd Connection:");  
+        WritePerformanceCounters();  
+  
+        SqlConnection connection3 = new SqlConnection(  
+              GetSqlConnectionString());  
+        connection3.Open();  
+        Console.WriteLine("Opened the 3rd Connection:");  
+        WritePerformanceCounters();  
+  
+        SqlConnection connection4 = new SqlConnection(  
+              GetSqlConnectionString());  
+        connection4.Open();  
+        Console.WriteLine("Opened the 4th Connection:");  
+        WritePerformanceCounters();  
+  
+        connection1.Close();  
+        Console.WriteLine("Closed the 1st Connection:");  
+        WritePerformanceCounters();  
+  
+        connection2.Close();  
+        Console.WriteLine("Closed the 2nd Connection:");  
+        WritePerformanceCounters();  
+  
+        connection3.Close();  
+        Console.WriteLine("Closed the 3rd Connection:");  
+        WritePerformanceCounters();  
+  
+        connection4.Close();  
+        Console.WriteLine("Closed the 4th Connection:");  
+        WritePerformanceCounters();  
+    }  
+  
+    private enum ADO_Net_Performance_Counters  
+    {  
+        NumberOfActiveConnectionPools,  
+        NumberOfReclaimedConnections,  
+        HardConnectsPerSecond,  
+        HardDisconnectsPerSecond,  
+        NumberOfActiveConnectionPoolGroups,  
+        NumberOfInactiveConnectionPoolGroups,  
+        NumberOfInactiveConnectionPools,  
+        NumberOfNonPooledConnections,  
+        NumberOfPooledConnections,  
+        NumberOfStasisConnections  
+        // The following performance counters are more expensive to track.  
+        // Enable ConnectionPoolPerformanceCounterDetail in your config file.  
+        //     SoftConnectsPerSecond  
+        //     SoftDisconnectsPerSecond  
+        //     NumberOfActiveConnections  
+        //     NumberOfFreeConnections  
+    }  
+  
+    private void SetUpPerformanceCounters()  
+    {  
+        connection.Close();  
+        this.PerfCounters = new PerformanceCounter[10];  
+        string instanceName = GetInstanceName();  
+        Type apc = typeof(ADO_Net_Performance_Counters);  
+        int i = 0;  
+        foreach (string s in Enum.GetNames(apc))  
+        {  
+            this.PerfCounters[i] = new PerformanceCounter();  
+            this.PerfCounters[i].CategoryName = ".NET Data Provider for SqlServer";  
+            this.PerfCounters[i].CounterName = s;  
+            this.PerfCounters[i].InstanceName = instanceName;  
+            i++;  
+        }  
+    }  
+  
+    [DllImport("kernel32.dll", SetLastError = true)]  
+    static extern int GetCurrentProcessId();  
+  
+    private string GetInstanceName()  
+    {  
+        //This works for Winforms apps.  
+        string instanceName =  
+            System.Reflection.Assembly.GetEntryAssembly().GetName().Name;  
+  
+        // Must replace special characters like (, ), #, /, \\  
+        string instanceName2 =  
+            AppDomain.CurrentDomain.FriendlyName.ToString().Replace('(', '[')  
+            .Replace(')', ']').Replace('#', '_').Replace('/', '_').Replace('\\', '_');  
+  
+        // For ASP.NET applications your instanceName will be your CurrentDomain's   
+        // FriendlyName. Replace the line above that sets the instanceName with this:  
+        // instanceName = AppDomain.CurrentDomain.FriendlyName.ToString().Replace('(','[')  
+        // .Replace(')',']').Replace('#','_').Replace('/','_').Replace('\\','_');  
+  
+        string pid = GetCurrentProcessId().ToString();  
+        instanceName = instanceName + "[" + pid + "]";  
+        Console.WriteLine("Instance Name: {0}", instanceName);  
+        Console.WriteLine("---------------------------");  
+        return instanceName;  
+    }  
+  
+    private void WritePerformanceCounters()  
+    {  
+        Console.WriteLine("---------------------------");  
+        foreach (PerformanceCounter p in this.PerfCounters)  
+        {  
+            Console.WriteLine("{0} = {1}", p.CounterName, p.NextValue());  
+        }  
+        Console.WriteLine("---------------------------");  
+    }  
+  
+    private static string GetIntegratedSecurityConnectionString()  
+    {  
+        // To avoid storing the connection string in your code,  
+        // you can retrive it from a configuration file.  
+        return @"Data Source=.\SqlExpress;Integrated Security=True;" +  
+          "Initial Catalog=AdventureWorks";  
+    }  
+    private static string GetSqlConnectionString()  
+    {  
+        // To avoid storing the connection string in your code,  
+        // you can retrive it from a configuration file.  
+        return @"Data Source=.\SqlExpress;User Id=LowPriv;Password=Data!05;" +  
+        //  "Initial Catalog=AdventureWorks";  
+    }  
+  
+    private static string GetSqlConnectionStringDifferent()  
+    {  
+        // To avoid storing the connection string in your code,  
+        // you can retrive it from a configuration file.  
+        return @"Initial Catalog=AdventureWorks;Data Source=.\SqlExpress;" +  
+          "User Id=LowPriv;Password=Data!05;";  
+    }  
+}  
+```  
+  
+## 参照  
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [OLE DB、ODBC、および Oracle 接続プール](../../../../docs/framework/data/adonet/ole-db-odbc-and-oracle-connection-pooling.md)   
+ [Performance Counters for ASP.NET](../Topic/Performance%20Counters%20for%20ASP.NET.md)   
+ [ランタイム プロファイリング](../../../../docs/framework/debug-trace-profile/runtime-profiling.md)   
+ [Introduction to Monitoring Performance Thresholds](http://msdn.microsoft.com/ja-jp/d40f10b9-e2b7-4ec8-a9b3-706929e5bf35)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/performing-batch-operations-using-dataadapters.md b/docs/framework/data/adonet/performing-batch-operations-using-dataadapters.md
new file mode 100644
index 00000000000..62b90f071c2
--- /dev/null
+++ b/docs/framework/data/adonet/performing-batch-operations-using-dataadapters.md
@@ -0,0 +1,152 @@
+---
+title: "DataAdapter によるバッチ操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e72ed5af-b24f-486c-8429-c8fd2208f844
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataAdapter によるバッチ操作の実行
+ADO.NET のバッチ サポートを利用すると、<xref:System.Data.Common.DataAdapter> は、<xref:System.Data.DataSet> または <xref:System.Data.DataTable> から INSERT、UPDATE、および DELETE の各操作を 1 操作ずつサーバーに送信するのではなく、グループ化してサーバーに送信できます。  こうすることで、サーバーへのラウンド トリップの回数が減少し、大幅なパフォーマンスの向上が期待できます。  バッチ更新は、SQL Server \(<xref:System.Data.SqlClient>\) および Oracle \(<xref:System.Data.OracleClient>\) の .NET データ プロバイダーでサポートされています。  
+  
+ 以前のバージョンの ADO.NET では、<xref:System.Data.DataSet> に格納されている変更内容をデータベースに反映する場合、`DataAdapter` の `Update` メソッドを実行して、1 行ずつデータベースを更新していました。  このメソッドは、指定された <xref:System.Data.DataTable> 内の行を反復処理すると、各 <xref:System.Data.DataRow> を調べ、行が変更されたことを確認します。  行が変更されている場合、その行の <xref:System.Data.DataRow.RowState%2A> プロパティの値に基づいて、適切な `UpdateCommand`、`InsertCommand`、または `DeleteCommand` のいずれかを呼び出します。  各行の更新では、データベースへのネットワーク ラウンドトリップが発生します。  
+  
+ ADO.NET 2.0 以降では、<xref:System.Data.Common.DbDataAdapter> は <xref:System.Data.Common.DbDataAdapter.UpdateBatchSize%2A> プロパティを公開します。  `UpdateBatchSize` を正の整数値に設定すると、データベースの更新が指定されたサイズのバッチとして送信されます。  たとえば、`UpdateBatchSize` を 10 に設定すると、10 個の個別のステートメントがグループ化され、単一のバッチとして送信されます。  `UpdateBatchSize` を 0 に設定すると、<xref:System.Data.Common.DataAdapter> は、サーバーが処理できる最大のバッチ サイズを使用します。  1 に設定すると、バッチ更新が無効になり、1 行ずつ送信されます。  
+  
+ サイズの大きいバッチを実行すると、パフォーマンスが低下する可能性があります。  そのため、アプリケーションを実装する前に、バッチの最適なサイズ設定をテストする必要があります。  
+  
+## UpdateBatchSize プロパティの使用  
+ バッチ更新を有効にする場合、DataAdapter の `UpdateCommand`、`InsertCommand` および `DeleteCommand` の <xref:System.Data.IDbCommand.UpdatedRowSource%2A> プロパティ値を、<xref:System.Data.UpdateRowSource> または <xref:System.Data.UpdateRowSource> に設定する必要があります。  バッチ更新を実行する際、<xref:System.Data.UpdateRowSource> または <xref:System.Data.UpdateRowSource> のコマンドの <xref:System.Data.IDbCommand.UpdatedRowSource%2A> プロパティ値は、無効になります。  
+  
+ `UpdateBatchSize` プロパティを使用するプロシージャを次に示します。  このプロシージャは、2 つの引数を取ります。1 つは、**Production.ProductCategory** テーブル内の **ProductCategoryID** フィールドおよび **Name** フィールドを表す列を持つ <xref:System.Data.DataSet> オブジェクトで、もう 1 つは、バッチ サイズ \(バッチ ファイル内の行数\) を表す整数です。  このコードにより、新しい <xref:System.Data.SqlClient.SqlDataAdapter> オブジェクトが作成され、その <xref:System.Data.SqlClient.SqlDataAdapter.UpdateCommand%2A> プロパティ、<xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> プロパティ、および <xref:System.Data.SqlClient.SqlDataAdapter.DeleteCommand%2A> プロパティが設定されます。  このコードは、<xref:System.Data.DataSet> オブジェクトによって行が変更済みになっていることを前提としています。  このオブジェクトは、`UpdateBatchSize` プロパティを設定し、更新を実行します。  
+  
+```vb  
+Public Sub BatchUpdate( _  
+  ByVal dataTable As DataTable, ByVal batchSize As Int32)  
+    ' Assumes GetConnectionString() returns a valid connection string.  
+    Dim connectionString As String = GetConnectionString()  
+  
+    ' Connect to the AdventureWorks database.  
+    Using connection As New SqlConnection(connectionString)  
+        ' Create a SqlDataAdapter.  
+        Dim adapter As New SqlDataAdapter()  
+  
+        'Set the UPDATE command and parameters.  
+        adapter.UpdateCommand = New SqlCommand( _  
+          "UPDATE Production.ProductCategory SET " _  
+          & "Name=@Name WHERE ProductCategoryID=@ProdCatID;", _  
+          connection)  
+        adapter.UpdateCommand.Parameters.Add("@Name", _  
+          SqlDbType.NVarChar, 50, "Name")  
+        adapter.UpdateCommand.Parameters.Add("@ProdCatID",  _  
+          SqlDbType.Int, 4, " ProductCategoryID ")  
+        adapter.UpdateCommand.UpdatedRowSource = _  
+          UpdateRowSource.None  
+  
+        'Set the INSERT command and parameter.  
+        adapter.InsertCommand = New SqlCommand( _  
+          "INSERT INTO Production.ProductCategory (Name) VALUES (@Name);", _  
+  connection)  
+        adapter.InsertCommand.Parameters.Add("@Name", _  
+          SqlDbType.NVarChar, 50, "Name")  
+        adapter.InsertCommand.UpdatedRowSource = _  
+          UpdateRowSource.None  
+  
+        'Set the DELETE command and parameter.  
+        adapter.DeleteCommand = New SqlCommand( _  
+          "DELETE FROM Production.ProductCategory " _  
+          & "WHERE ProductCategoryID=@ProdCatID;", connection)  
+        adapter.DeleteCommand.Parameters.Add("@ProdCatID", _  
+           SqlDbType.Int, 4, " ProductCategoryID ")  
+        adapter.DeleteCommand.UpdatedRowSource = UpdateRowSource.None  
+  
+        ' Set the batch size.  
+        adapter.UpdateBatchSize = batchSize  
+  
+        ' Execute the update.  
+        adapter.Update(dataTable)  
+    End Using  
+End Sub  
+```  
+  
+```csharp  
+public static void BatchUpdate(DataTable dataTable,Int32 batchSize)  
+{  
+    // Assumes GetConnectionString() returns a valid connection string.  
+    string connectionString = GetConnectionString();  
+  
+    // Connect to the AdventureWorks database.  
+    using (SqlConnection connection = new   
+      SqlConnection(connectionString))  
+    {  
+  
+        // Create a SqlDataAdapter.  
+        SqlDataAdapter adapter = new SqlDataAdapter();  
+  
+        // Set the UPDATE command and parameters.  
+        adapter.UpdateCommand = new SqlCommand(  
+            "UPDATE Production.ProductCategory SET "  
+            + "Name=@Name WHERE ProductCategoryID=@ProdCatID;",   
+            connection);  
+        adapter.UpdateCommand.Parameters.Add("@Name",   
+           SqlDbType.NVarChar, 50, "Name");  
+        adapter.UpdateCommand.Parameters.Add("@ProdCatID",   
+           SqlDbType.Int, 4, "ProductCategoryID");  
+         adapter.UpdateCommand.UpdatedRowSource = UpdateRowSource.None;  
+  
+        // Set the INSERT command and parameter.  
+        adapter.InsertCommand = new SqlCommand(  
+            "INSERT INTO Production.ProductCategory (Name) VALUES (@Name);",   
+            connection);  
+        adapter.InsertCommand.Parameters.Add("@Name",   
+          SqlDbType.NVarChar, 50, "Name");  
+        adapter.InsertCommand.UpdatedRowSource = UpdateRowSource.None;  
+  
+        // Set the DELETE command and parameter.  
+        adapter.DeleteCommand = new SqlCommand(  
+            "DELETE FROM Production.ProductCategory "  
+            + "WHERE ProductCategoryID=@ProdCatID;", connection);  
+        adapter.DeleteCommand.Parameters.Add("@ProdCatID",   
+          SqlDbType.Int, 4, "ProductCategoryID");  
+        adapter.DeleteCommand.UpdatedRowSource = UpdateRowSource.None;  
+  
+        // Set the batch size.  
+        adapter.UpdateBatchSize = batchSize;  
+  
+        // Execute the update.  
+        adapter.Update(dataTable);  
+    }  
+}  
+```  
+  
+## バッチ更新に関連するイベントおよびエラーの処理  
+ **DataAdapter** には **RowUpdating** と **RowUpdated** の 2 つの更新に関するイベントがあります。  以前のバージョンの ADO.NET では、バッチ処理が無効になっていると、処理された行ごとにこれらのイベントがそれぞれ生成されます。  更新が行われる前に **RowUpdating** が生成され、データベースの更新が完了した後に **RowUpdated** が生成されます。  
+  
+### バッチ更新とイベント動作の違い  
+ バッチ処理が有効になっている場合、1 度のデータベース操作で複数の行が更新されます。  このため、`RowUpdating` イベントは処理された各行ごとに発生しますが、`RowUpdated` イベントは各バッチ処理につき、1 つしか発生しません。  バッチ処理が無効になっている場合、1 対 1 のインターリーブを伴う 2 つのイベントが発生します。つまり、1 つの行に対し、`RowUpdating` イベントが 1 つ、`RowUpdated` イベントが 1 つ発生します。すべての行が処理されるまで、次の行に対して `RowUpdating` イベントが 1 つ、`RowUpdated` イベントが 1 つ発生します。  
+  
+### 更新された行へのアクセス  
+ バッチ処理が無効になっている場合、更新された行には、<xref:System.Data.Common.RowUpdatedEventArgs> クラスの <xref:System.Data.Common.RowUpdatedEventArgs.Row%2A> プロパティを使用してアクセスできます。  
+  
+ バッチ処理が有効になっている場合、複数の行に対して 1 つの `RowUpdated` イベントが生成されます。  つまり、各行の `Row` プロパティ値は null ですが、  `RowUpdating` イベントは各行に対して生成されます。  処理された行にアクセスするには、<xref:System.Data.Common.RowUpdatedEventArgs> クラスの <xref:System.Data.Common.RowUpdatedEventArgs.CopyToRows%2A> メソッドにより、配列に行への参照をコピーします。  処理される行がない場合、`CopyToRows` が <xref:System.ArgumentNullException> をスローします。  <xref:System.Data.Common.RowUpdatedEventArgs.CopyToRows%2A> メソッドを呼び出す前に、<xref:System.Data.Common.RowUpdatedEventArgs.RowCount%2A> プロパティを使用して、処理されている行数を取得できます。  
+  
+### データ エラーの処理  
+ ステートメントを個別に実行した場合とバッチ処理を実行した場合では効果は同じです。  ステートメントはバッチに追加された順序と同じ順序で実行されます。  エラーは、バッチ モードでも、バッチ モードが無効な場合と同様に処理されます。  つまり、各行が個別に処理されます。  データベース内で正常に処理された行だけが、<xref:System.Data.DataTable> 内の対応する <xref:System.Data.DataRow> で更新されます。  
+  
+ バッチ処理の実行に対してサポートされる SQL 構成は、データ プロバイダーとバックエンド データベースが決定します。  サポートされていないステートメントが実行時に送信されると、例外がスローされる場合があります。  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/performing-catalog-operations.md b/docs/framework/data/adonet/performing-catalog-operations.md
new file mode 100644
index 00000000000..0c805d1e139
--- /dev/null
+++ b/docs/framework/data/adonet/performing-catalog-operations.md
@@ -0,0 +1,55 @@
+---
+title: "カタログ操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e60f542f-6271-495b-a9e4-48553481c2a3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# カタログ操作の実行
+データベースまたはカタログを変更するコマンド \(CREATE TABLE ステートメント、CREATE PROCEDURE ステートメントなど\) を実行するには、適切な SQL ステートメントおよび **Connection** オブジェクトを使用して **Command** オブジェクトを作成します。  **Command** オブジェクトの **ExecuteNonQuery** メソッドでコマンドを実行します。  
+  
+ Microsoft SQL Server データベースにストアド プロシージャを作成するコード サンプルを次に示します。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+Dim queryString As String = "CREATE PROCEDURE InsertCategory " & _  
+    "@CategoryName nchar(15), " & _  
+    "@Identity int OUT " & _  
+    "AS " & _  
+    "INSERT INTO Categories (CategoryName) VALUES(@CategoryName) " & _  
+    "SET @Identity = @@Identity " & _  
+    "RETURN @@ROWCOUNT"  
+  
+Dim command As SqlCommand = New SqlCommand(queryString, connection)  
+command.ExecuteNonQuery()  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+string queryString = "CREATE PROCEDURE InsertCategory  " +   
+    "@CategoryName nchar(15), " +  
+    "@Identity int OUT " +  
+    "AS " +   
+    "INSERT INTO Categories (CategoryName) VALUES(@CategoryName) " +   
+    "SET @Identity = @@Identity " +  
+    "RETURN @@ROWCOUNT";  
+  
+SqlCommand command = new SqlCommand(queryString, connection);  
+command.ExecuteNonQuery();  
+```  
+  
+## 参照  
+ [コマンドを使用したデータ変更](../../../../docs/framework/data/adonet/using-commands-to-modify-data.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md b/docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md
new file mode 100644
index 00000000000..f627a1e862f
--- /dev/null
+++ b/docs/framework/data/adonet/populating-a-dataset-from-a-dataadapter.md
@@ -0,0 +1,194 @@
+---
+title: "DataAdapter からの DataSet の読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fa0ac7d-e266-4954-bfac-3fbe2f913153
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# DataAdapter からの DataSet の読み込み
+[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の <xref:System.Data.DataSet> は、データ ソースに依存しない一貫したリレーショナル プログラミング モデルを提供するメモリ常駐型のデータ表現です。`DataSet` はテーブル、制約、およびテーブル間のリレーションシップを含む完全なデータのセットを表します。`DataSet` はデータ ソースとは独立しているため、`DataSet` にはそのアプリケーションに固有のデータと複数のデータ ソースからのデータを含めることができます。 既存のデータ ソースとの対話は `DataAdapter` によって制御されます。  
+  
+ `SelectCommand` の `DataAdapter` プロパティは、データ ソースからデータを取得する `Command` オブジェクトです。`InsertCommand` の `UpdateCommand`、`DeleteCommand`、`DataAdapter` の各プロパティは、`Command` のデータに対して行われた変更に基づいてデータ ソースのデータ更新を管理する `DataSet` オブジェクトです。 これらのプロパティについては、「[DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)」でさらに詳しく説明します。  
+  
+ `Fill` の `DataAdapter` メソッドは、`DataSet` の `SelectCommand` の結果を `DataAdapter` に設定するために使用します。`Fill` は、その引数として、設定対象である `DataSet` と、`DataTable` オブジェクト \(つまり、`DataTable` から返された行を格納する `SelectCommand` の名前\) を受け取ります。  
+  
+> [!NOTE]
+>  `DataAdapter` を使用してテーブル全体を取得すると、特にテーブルの行数が多い場合は処理に時間がかかります。 データベースにアクセスし、データを検索して処理した後、そのデータをクライアントに転送するという時間のかかる処理が伴うためです。 また、テーブル全体をクライアントに取得しようとすると、サーバー上ですべての行がロックされます。`WHERE` 句を使用して、クライアントから返される行数をできるだけ減らすことでパフォーマンスを向上させることができます。 また、`SELECT` ステートメントで必要な列を明示的に指定するだけでもクライアントに返されるデータ量を減らすことができます。 それ以外の対策としては、一度に数百行など、行をバッチで取得し、クライアントが現在のバッチの処理を完了した時点で次のバッチを取得する方法も効果的です。  
+  
+ `Fill` メソッドは、`DataReader` オブジェクトを暗黙的に使用して `DataSet` 内でテーブルを作成するための列の名前と型、および `DataSet` 内のテーブルの行を設定するためのデータを返します。 テーブルおよび列は、存在しない場合にのみ作成されます。それ以外の場合、`Fill` には、既存の `DataSet` スキーマが使用されます。 列の型は、「[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]」の表に基づき、[ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md) の型として作成されます。 データ ソースに主キーが存在し、`DataAdapter`**.**`MissingSchemaAction` が `MissingSchemaAction`**.**`AddWithKey` に設定されている場合だけ、主キーが作成されますが、それ以外の場合は主キーは作成されません。`Fill` はテーブルに主キーがあることがわかると、主キー列の値がデータ ソースから返された主キー列の値と一致する行について、データ ソースから返されたデータで `DataSet` 内のデータを上書きします。 主キーが見つからない場合は、`DataSet` のテーブルの末尾にデータを追加します。`Fill` は、`DataSet` にデータを読み込むときに存在するすべてのマッピングを使用します \(「[DataAdapter DataTable と DataColumn のマップ](../../../../docs/framework/data/adonet/dataadapter-datatable-and-datacolumn-mappings.md)」を参照してください\)。  
+  
+> [!NOTE]
+>  `SelectCommand` が OUTER JOIN の結果を返す場合、`DataAdapter` は、生成される `PrimaryKey` に `DataTable` 値を設定しません。 自分で `PrimaryKey` を定義して、重複行が正しく解決されるようにする必要があります。 詳細については、「[主キーの定義](../../../../docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md)」を参照してください。  
+  
+ 次のコード サンプルでは、Microsoft SQL Server の <xref:System.Data.SqlClient.SqlDataAdapter> データベースへの <xref:System.Data.SqlClient.SqlConnection> を使用する `Northwind` のインスタンスを作成し、<xref:System.Data.DataTable> 内の `DataSet` に顧客リストを読み込みます。<xref:System.Data.SqlClient.SqlConnection> コンストラクターに渡される SQL ステートメントおよび <xref:System.Data.SqlClient.SqlDataAdapter> 引数は、<xref:System.Data.SqlClient.SqlDataAdapter.SelectCommand%2A> の <xref:System.Data.SqlClient.SqlDataAdapter> プロパティを作成するために使用されます。  
+  
+## 例  
+  
+```vb  
+' Assumes that connection is a valid SqlConnection object.  
+Dim queryString As String = _  
+  "SELECT CustomerID, CompanyName FROM dbo.Customers"  
+Dim adapter As SqlDataAdapter = New SqlDataAdapter( _  
+  queryString, connection)  
+  
+Dim customers As DataSet = New DataSet  
+adapter.Fill(customers, "Customers")  
+```  
+  
+```csharp  
+// Assumes that connection is a valid SqlConnection object.  
+string queryString =   
+  "SELECT CustomerID, CompanyName FROM dbo.Customers";  
+SqlDataAdapter adapter = new SqlDataAdapter(queryString, connection);  
+  
+DataSet customers = new DataSet();  
+adapter.Fill(customers, "Customers");  
+```  
+  
+> [!NOTE]
+>  このサンプル コードでは、`Connection` の開始と終了を明示的に行っていません。`Fill` メソッドは、接続がまだ開いていないことを認識すると `Connection` が使用している `DataAdapter` を暗黙的に開きます。`Fill` が接続を開いた場合は、`Fill` の終了時に Fill が接続を終了します。 これにより、`Fill` や `Update` などの単一の操作を扱う場合にコードを簡略化できます。 これに対し、開いている接続を必要とする複数の操作を実行する場合は、`Open` の `Connection` メソッドを明示的に呼び出し、データ ソースに対する操作の実行後に `Close` の `Connection` メソッドを呼び出すことでアプリケーションのパフォーマンスを改善できます。 リソースを解放して他のクライアント アプリケーションが使用できるようにするために、データ ソースへの接続を開いたままにする時間は最小限にすることをお勧めします。  
+  
+## 複数結果セット  
+ `DataAdapter` は複数の結果セットを検出すると、`DataSet` に複数のテーブルを作成します。 これらのテーブルには、Table0 のように、"Table" で始まるインクリメンタル既定名 Table*N* が割り当てられます。 テーブル名を引数として `Fill` メソッドに渡すと、TableName0 を表す "TableName" で始まるインクリメンタル既定名 TableName*N* が割り当てられます。  
+  
+## 複数の DataAdapter からの DataSet の読み込み  
+ 1 つの `DataSet` で、任意の数の `DataAdapter` オブジェクトを使用できます。 それぞれの `DataAdapter` で 1 つ以上の `DataTable` オブジェクトにデータを格納し、関連するデータ ソースに更新を反映させることができます。`DataRelation` に対して `Constraint` オブジェクトおよび `DataSet` オブジェクトを部分的に追加できるため、複数の異なるデータ ソースから取得したデータを関連付けることができます。 たとえば、Microsoft SQL Server データベース、OLE DB を通じて公開される IBM DB2 データベース、および XML をストリーム転送するデータ ソースからのデータを `DataSet` に含めることができます。 1 つ以上の `DataAdapter` オブジェクトを使用して、各データ ソースとの通信を行うことができます。  
+  
+### 例  
+ 次のコード サンプルでは、Microsoft SQL Server 2000 の `Northwind` データベースおよび Microsoft Access の `Northwind` データベースから、それぞれ顧客リストと注文リストを取得します。 取得したテーブルを `DataRelation` で関連付けて、顧客および対応する注文の一覧を表示します。`DataRelation` オブジェクトの詳細については、「[DataRelation の追加](../../../../docs/framework/data/adonet/dataset-datatable-dataview/adding-datarelations.md)」および「[DataRelation の移動](../../../../docs/framework/data/adonet/dataset-datatable-dataview/navigating-datarelations.md)」を参照してください。  
+  
+```vb  
+' Assumes that customerConnection is a valid SqlConnection object.  
+' Assumes that orderConnection is a valid OleDbConnection object.  
+Dim custAdapter As SqlDataAdapter = New SqlDataAdapter( _  
+  "SELECT * FROM dbo.Customers", customerConnection)  
+  
+Dim ordAdapter As OleDbDataAdapter = New OleDbDataAdapter( _  
+  "SELECT * FROM Orders", orderConnection)  
+  
+Dim customerOrders As DataSet = New DataSet()  
+custAdapter.Fill(customerOrders, "Customers")  
+ordAdapter.Fill(customerOrders, "Orders")  
+  
+Dim relation As DataRelation = _  
+  customerOrders.Relations.Add("CustOrders", _  
+  customerOrders.Tables("Customers").Columns("CustomerID"), _   
+  customerOrders.Tables("Orders").Columns("CustomerID"))  
+  
+Dim pRow, cRow As DataRow  
+For Each pRow In customerOrders.Tables("Customers").Rows  
+  Console.WriteLine(pRow("CustomerID").ToString())  
+  
+  For Each cRow In pRow.GetChildRows(relation)  
+    Console.WriteLine(vbTab & cRow("OrderID").ToString())  
+  Next  
+Next  
+  
+```  
+  
+```csharp  
+// Assumes that customerConnection is a valid SqlConnection object.  
+// Assumes that orderConnection is a valid OleDbConnection object.  
+SqlDataAdapter custAdapter = new SqlDataAdapter(  
+  "SELECT * FROM dbo.Customers", customerConnection);  
+OleDbDataAdapter ordAdapter = new OleDbDataAdapter(  
+  "SELECT * FROM Orders", orderConnection);  
+  
+DataSet customerOrders = new DataSet();  
+  
+custAdapter.Fill(customerOrders, "Customers");  
+ordAdapter.Fill(customerOrders, "Orders");  
+  
+DataRelation relation = customerOrders.Relations.Add("CustOrders",  
+  customerOrders.Tables["Customers"].Columns["CustomerID"],  
+  customerOrders.Tables["Orders"].Columns["CustomerID"]);  
+  
+foreach (DataRow pRow in customerOrders.Tables["Customers"].Rows)  
+{  
+  Console.WriteLine(pRow["CustomerID"]);  
+   foreach (DataRow cRow in pRow.GetChildRows(relation))  
+    Console.WriteLine("\t" + cRow["OrderID"]);  
+}  
+```  
+  
+## SQL Server の 10 進数型  
+ 既定では、`DataSet` は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のデータ型を使用してデータを格納します。 ほとんどのアプリケーションで、これらのデータ型を使用してデータ ソース情報を簡単に表示できます。 しかし、データ ソースのデータ型が SQL Server の 10 進数データ型または数値データ型の場合は、この表現によって問題が生じる場合があります。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の `decimal` データ型の最大有効桁数は 28 桁であるのに対し、SQL Server の `decimal` データ型の有効桁数は 38 桁です。`SqlDataAdapter` が動作している間に、`Fill` が、SQL Server の `decimal` フィールドの有効桁数が 28 文字を超えていると判断した場合、現在の行は `DataTable` に追加されません。 その場合は `FillError` イベントが発生するため、開発者は有効桁数の消失が発生していないかどうかを確認し、適切に対応できます。`FillError` イベントの詳細については、「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。 SQL Server の `decimal` 値を取得するために、<xref:System.Data.SqlClient.SqlDataReader> オブジェクトを使用し、<xref:System.Data.SqlClient.SqlDataReader.GetSqlDecimal%2A> メソッドを呼び出すこともできます。  
+  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] 2.0 では、<xref:System.Data.SqlTypes> の `DataSet` に対するサポート機能が強化されています。 詳細については、「[SqlTypes と DataSet](../../../../docs/framework/data/adonet/sql/sqltypes-and-the-dataset.md)」を参照してください。  
+  
+## OLE DB のチャプター  
+ 階層構造の行セット、つまりチャプター \(OLE DB では `DBTYPE_HCHAPTER` 型、ADO では `adChapter` 型\) を使用して `DataSet` の内容を格納できます。<xref:System.Data.OleDb.OleDbDataAdapter> が `Fill` が動作している間にチャプター列を検出すると、そのチャプター列のための `DataTable` を作成し、チャプターから取得した列と行をこのテーブルに格納します。 チャプター列用に作成されたテーブルには、親テーブルの名前とチャプター列の名前の両方を使用した "*ParentTableNameChapteredColumnName*" 形式の名前が割り当てられます。`DataSet` にチャプター列の名前と一致するテーブルが既に存在する場合は、現在のテーブルにチャプター データが格納されます。 既存のテーブルにチャプター内の列と一致する列が存在しない場合は、新しい列が追加されます。  
+  
+ `DataSet` 内のテーブルにチャプター列のデータを格納する前に、親テーブルと子テーブルの両方に 1 つの整数列を追加し、親列を自動インクリメントに設定し、両方のテーブルに追加された列を使用して `DataRelation` を作成すると、階層構造の行セットを形成している親テーブルと子テーブルの間にリレーションが作成されます。 追加されたリレーションには親テーブルの名前とチャプター列の名前を使用した "*ParentTableNameChapterColumnName*" 形式の名前が割り当てられます。  
+  
+ 関連付けられた列は、`DataSet` だけに存在します。 そのデータ ソースからの次の Fill 操作を実行すると、変更を既存の行にマージするのではなく、テーブルに新しい行が追加されます。  
+  
+ `DataAdapter.Fill` を受け取る `DataTable` オーバーロードを使用した場合は、そのテーブルだけにデータが格納されます。 自動インクリメント整数列は、引き続きそのテーブルに追加されますが、子テーブルの作成、子テーブルへのデータの格納、およびリレーションの作成は行われません。  
+  
+ MSDataShape プロバイダーを使用して顧客リスト内の各顧客に対応するオーダー列を生成する例を次に示します。 チャプター列を生成した後で、1 つの `DataSet` 内にそのデータを格納します。  
+  
+```vb  
+Using connection As OleDbConnection = New OleDbConnection( _  
+  "Provider=MSDataShape;Data Provider=SQLOLEDB;" & _  
+  "Data Source=(local);Integrated " & _  
+  "Security=SSPI;Initial Catalog=northwind")  
+  
+Dim adapter As OleDbDataAdapter = New OleDbDataAdapter( _  
+  "SHAPE {SELECT CustomerID, CompanyName FROM Customers} " & _  
+  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " & _  
+  "RELATE CustomerID TO CustomerID)", connection)  
+  
+Dim customers As DataSet = New DataSet()  
+  
+adapter.Fill(customers, "Customers")  
+End Using  
+```  
+  
+```csharp  
+using (OleDbConnection connection = new OleDbConnection("Provider=MSDataShape;Data Provider=SQLOLEDB;" +  
+  "Data Source=(local);Integrated Security=SSPI;Initial Catalog=northwind"))  
+{  
+OleDbDataAdapter adapter = new OleDbDataAdapter("SHAPE {SELECT CustomerID, CompanyName FROM Customers} " +  
+  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS Orders " +  
+  "RELATE CustomerID TO CustomerID)", connection);  
+  
+DataSet customers = new DataSet();  
+adapter.Fill(customers, "Customers");  
+}  
+```  
+  
+ `Fill` 操作が完了すると、`DataSet` に `Customers` と `CustomersOrders` の 2 つのテーブルが格納されます。`CustomersOrders` はチャプター列を表します。`Orders` という列が `Customers` テーブルに追加され、`CustomersOrders` という列が `CustomersOrders` テーブルに追加されます。`Orders` テーブルの `Customers` 列は、自動インクリメントに設定されます。 親テーブルである `DataRelation` テーブルに追加された列を使用して、`CustomersOrders` という `Customers` が作成されます。 サンプル結果の一部を次の表に示します。  
+  
+### TableName: Customers  
+  
+|CustomerID|CompanyName|Orders|  
+|----------------|-----------------|------------|  
+|ALFKI|Alfreds Futterkiste|0|  
+|ANATR|Ana Trujillo Emparedados y helados|1|  
+  
+### TableName: CustomersOrders  
+  
+|CustomerID|OrderID|CustomersOrders|  
+|----------------|-------------|---------------------|  
+|ALFKI|10643|0|  
+|ALFKI|10692|0|  
+|ANATR|10308|1|  
+|ANATR|10625|1|  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [DbDataAdapter を使用したデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-a-dbdataadapter.md)   
+ [複数のアクティブな結果セット \(MARS\)](../../../../docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/privacy-and-data-security.md b/docs/framework/data/adonet/privacy-and-data-security.md
new file mode 100644
index 00000000000..eb153bc6f57
--- /dev/null
+++ b/docs/framework/data/adonet/privacy-and-data-security.md
@@ -0,0 +1,40 @@
+---
+title: "プライバシーとデータ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 46fa5839-adf7-4c7c-bce3-71e941fa7de9
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# プライバシーとデータ セキュリティ
+ADO.NET アプリケーションにおける機密情報の保護と管理は、基になる製品および作成に使用されたテクノロジに依存します。  ADO.NET そのものは、データを保護したり暗号化したりするためのサービスを提供しません。  
+  
+## 暗号化とハッシュ コード  
+ ADO.NET アプリケーションから .NET Framework <xref:System.Security.Cryptography> 名前空間のクラスを使用すると、認証されていない第三者によるデータの読み取りや変更を防止できます。  クラスには、アンマネージ Microsoft CryptoAPI 用のラッパーもあれば、マネージ実装もあります。  「[Cryptographic Services](http://msdn.microsoft.com/ja-jp/68a1e844-c63c-44af-9247-f6716eb23781)」トピックでは、.NET Framework における暗号化の概要や暗号化の実装方法と、暗号化に関連した個々のタスクを実行する方法について説明しています。  
+  
+ 暗号化ではデータを暗号化した後に復号化を行いますが、データのハッシュは不可逆性の処理です。  データのハッシュは、データが変更されていないことを確認することによって改ざんを防止する場合に役立ちます。ハッシュ アルゴリズムは、同一内容の入力文字列に対して、容易に比較できる同一内容の短い値を出力します。  「[ハッシュ コードによるデータの整合性の保証](../../../../docs/standard/security/ensuring-data-integrity-with-hash-codes.md)」では、ハッシュ値を生成および検証する方法について説明します。  
+  
+## 構成ファイルの暗号化  
+ アプリケーションのセキュリティを実現するうえで、データ ソースへのアクセスを保護することは、最も重要な目標の 1 つです。  保護されていない接続文字列は脆弱性を招く原因になります。  構成ファイルに保存された接続文字列は、.NET Framework が基本的な要素を定義するために使用する標準的な XML ファイルに格納されます。  保護構成機能を使用すると、構成ファイル内の機密情報を暗号化できます。  保護構成は、主に ASP.NET アプリケーションを想定して設計されたものですが、Windows アプリケーションの構成ファイル セクションを暗号化する目的でも使用できます。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## メモリ内の文字列値の保護  
+ <xref:System.String> オブジェクトにパスワード、クレジット カード番号、個人データなどの機密情報が含まれていると、そのデータの使用後に、情報が漏洩するリスクが生じます。アプリケーションでは、文字列データをコンピューターのメモリから削除することはできません。  
+  
+ <xref:System.String> は不変であり、いったん作成された文字列値は変更できません。  文字列値を変更したように見えても、実際には <xref:System.String> オブジェクトの新しいインスタンスがメモリ内に作成されているだけです。データはテキスト形式で保存されます。  また、文字列のインスタンスがいつメモリから削除されるかを予測することも不可能です。  文字列型によって占有されたメモリは、.NET のガベージ コレクションによって非確定的に回収されます。  高い機密を要するデータに <xref:System.String> クラスや <xref:System.Text.StringBuilder> クラスを使用することは避けてください。  
+  
+ <xref:System.Security.SecureString> クラスには、Data Protection API \(DPAPI\) を使ってメモリ内のテキストを暗号化するためのメソッドが用意されています。  文字列は不要になった段階でメモリから削除されます。  文字列の内容を簡単に読み取ることのできる `ToString` メソッドは、<xref:System.Security.SecureString> には存在しません。  `SecureString` の新しいインスタンスを作成する際は、値を渡さずに初期化することも、<xref:System.Char> オブジェクトの配列へのポインターを渡して初期化することもできます。  その後、このクラスの各種のメソッドを使って文字列を操作できます。  詳細については、[SecureString のサンプル アプリケーション](http://go.microsoft.com/fwlink/?LinkId=120418)をダウンロードしてください。ここでは、`SecureString` クラスの使用方法を示しています。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/programming-guide-linq-to-dataset.md b/docs/framework/data/adonet/programming-guide-linq-to-dataset.md
new file mode 100644
index 00000000000..a72ff7ccf99
--- /dev/null
+++ b/docs/framework/data/adonet/programming-guide-linq-to-dataset.md
@@ -0,0 +1,65 @@
+---
+title: "Programming Guide (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 977aedd7-0084-46a0-b56f-345787a55da1
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Programming Guide (LINQ to DataSet)
+ここでは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用したプログラミングに関する概要情報と例を提供します。  
+  
+## このセクションの内容  
+ [Queries in LINQ to DataSet](../../../../docs/framework/data/adonet/queries-in-linq-to-dataset.md)  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリの作成方法に関する情報を提供します。  
+  
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)  
+ <xref:System.Data.DataSet> オブジェクトに対してクエリを実行する方法について説明します。  
+  
+ [Comparing DataRows](../../../../docs/framework/data/adonet/comparing-datarows-linq-to-dataset.md)  
+ <xref:System.Data.DataRowComparer> オブジェクトを使用してデータ行を比較する方法について説明します。  
+  
+ [Creating a DataTable From a Query](../../../../docs/framework/data/adonet/creating-a-datatable-from-a-query-linq-to-dataset.md)  
+ <xref:System.Data.DataTableExtensions.CopyToDataTable%2A> メソッドを使用して、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから <xref:System.Data.DataTable> を作成する方法について説明します。  
+  
+ [How to: Implement CopyToDataTable\<T\> Where the Generic Type T Is Not a DataRow](../../../../docs/framework/data/adonet/implement-copytodatatable-where-type-not-a-datarow.md)  
+ <xref:System.Data.DataRow> 型以外のジェネリック パラメーター T を持つカスタム `CopyToDataTable<T>` メソッドの実装方法について説明します。  
+  
+ [Generic Field and SetField Methods](../../../../docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md)  
+ ジェネリック メソッド <xref:System.Data.DataRowExtensions.Field%2A> および <xref:System.Data.DataRowExtensions.SetField%2A> に関する情報を提供します。  
+  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)  
+ <xref:System.Data.DataView> オブジェクトを使ったデータ バインドについて説明します。  
+  
+ [Debugging LINQ to DataSet Queries](../../../../docs/framework/data/adonet/debugging-linq-to-dataset-queries.md)  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリのデバッグおよびトラブルシューティングに関する情報を提供します。  
+  
+ [Security](../../../../docs/framework/data/adonet/security-linq-to-dataset.md)  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] におけるセキュリティの問題について説明します。  
+  
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)  
+ [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 演算子を使ったクエリの例を紹介します。  
+  
+## 関連項目  
+ <xref:System.Data.DataRowComparer>  
+  
+ <xref:System.Data.DataRowExtensions>  
+  
+ <xref:System.Data.DataTableExtensions>  
+  
+ <xref:System.Data.DataView>  
+  
+## 参照  
+ [LINQ to ADO.NET](http://msdn.microsoft.com/ja-jp/be3297b9-1b54-4d4c-82a8-add0d79c2006)   
+ [NOT IN BUILD: LINQ General Programming Guide](http://msdn.microsoft.com/ja-jp/609c7a6b-cbdd-429d-99f3-78d13d3bc049)   
+ [LINQ Framework](http://msdn.microsoft.com/ja-jp/897ea0fc-40db-4694-bbe5-7dd339d5bf94)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/property.md b/docs/framework/data/adonet/property.md
new file mode 100644
index 00000000000..9893ecab1b8
--- /dev/null
+++ b/docs/framework/data/adonet/property.md
@@ -0,0 +1,53 @@
+---
+title: "プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a941c53f-fc97-42c2-8832-0fb9f1d55c06
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# プロパティ
+*プロパティ*は、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)および[複合型](../../../../docs/framework/data/adonet/complex-type.md)に不可欠な構成要素です。  プロパティは、エンティティ型または複合型のインスタンスに含まれるデータの形と特性を定義します。  概念モデルのプロパティは、クラスに定義されるプロパティに似ています。  クラスのプロパティがクラスの構造を定義し、オブジェクトに関する情報を伝達するのと同様に、概念モデルのプロパティはエンティティ型の構造を定義し、エンティティ型のインスタンスに関する情報を伝達します。  
+  
+> [!NOTE]
+>  このトピックで説明するプロパティは、ナビゲーション プロパティとは異なります。  詳細については、「[ナビゲーション プロパティ](../../../../docs/framework/data/adonet/navigation-property.md)」を参照してください。  
+  
+ プロパティの定義には、次の情報が含まれます。  
+  
+-   プロパティ名。  \(必須\)  
+  
+-   プロパティの型。  \(必須\)  
+  
+-   一連の[ファセット](../../../../docs/framework/data/adonet/facet.md)。  \(オプション\)。  
+  
+ プロパティには、プリミティブ データ \(文字列、整数、ブール値など\) または構造化データ \(複合型\) を含めることができます。  プリミティブ型のプロパティは、スカラー プロパティとも呼ばれます。  詳細については、「[Entity Data Model: プリミティブ データ型](../../../../docs/framework/data/adonet/entity-data-model-primitive-data-types.md)」を参照してください。  
+  
+> [!NOTE]
+>  複合型自体に、複合型のプロパティを指定することができます。  
+  
+## 例  
+ 下のダイアグラムは、`Book`、`Publisher`、および `Author` という 3 つのエンティティ型の概念モデルを示しています。  各エンティティ型には、いくつかのプロパティがありますが、ダイアグラムには各プロパティの型情報が示されていません。  [エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)のプロパティには、"\(キー\)" と示されています。  
+  
+ ![モデル例](../../../../docs/framework/data/adonet/media/examplemodel.gif "ExampleModel")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、`Book` エンティティ型 \(上のダイアグラムに示されたように\) を定義し、XML 属性により各プロパティの型と名前を示しています。  ファセット `Nullable` \(省略可能\) も XML 属性により定義されています。  
+  
+ [!code-xml[EDM_Example_Model#EntityExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books.edmx#entityexample)]  
+  
+ ダイアグラムに示されたいずれかのプロパティが複合型のプロパティであることも考えられます。  たとえば、`Publisher` エンティティ型の `Address` プロパティは、`StreetAddress`、`City`、`StateOrProvince`、`Country`、`PostalCode` などいくつかのスカラー プロパティから構成された複合型のプロパティである可能性があります。  このような複合型の CSDL 表現は、次のようになります。  
+  
+ [!code-xml[EDM_Example_Model#ComplexTypeExample](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books2.edmx#complextypeexample)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/protecting-connection-information.md b/docs/framework/data/adonet/protecting-connection-information.md
new file mode 100644
index 00000000000..9b54a27563e
--- /dev/null
+++ b/docs/framework/data/adonet/protecting-connection-information.md
@@ -0,0 +1,53 @@
+---
+title: "接続情報の保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1471f580-bcd4-4046-bdaf-d2541ecda2f4
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 接続情報の保護
+アプリケーションのセキュリティを実現するうえで、データ ソースへのアクセスを保護することは、最も重要な目標の 1 つです。  保護されていない接続文字列は脆弱性を招く原因になります。  接続情報をテキスト形式で保存したり、メモリ内に保持したりすると、システム全体のセキュリティが損なわれる可能性があります。  ソース コードに組み込まれた接続文字列は、[Ildasm.exe \(IL 逆アセンブラー\)](../../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使って、コンパイル済みアセンブリの Microsoft Intermediate Language \(MSIL\) を表示することで読み取ることができます。  
+  
+ 接続文字列に関係したセキュリティ上の脆弱性は、使用されている認証の種類、メモリやディスクへの接続文字列の保存方法、実行時に接続文字列を作成する際の手法などから発生します。  
+  
+## Windows 認証の使用  
+ データ ソースへのアクセスを制限するには、ユーザー ID、パスワード、データ ソース名などの接続情報をセキュリティで保護する必要があります。  ユーザー情報の漏洩を防ぐためにも、できるだけ Windows 認証 \(*統合セキュリティ*\) を使用することをお勧めします。  Windows 認証は、接続文字列に `Integrated Security` キーワードまたは `Trusted_Connection` キーワードを使用することによって指定できます。こうすることで、ユーザー ID とパスワードを使う必要がなくなります。  Windows 認証を使用した場合、ユーザーは Windows によって認証され、サーバー リソースやデータベース リソースへのアクセスは Windows のユーザーおよびグループに付与された権限によって制御されます。  
+  
+ Windows 認証が使用できない場合、ユーザーの資格情報を接続文字列に含めることになるため、十分な注意が必要です。  ASP.NET アプリケーションでは、Windows アカウントを、データベースやその他のネットワーク リソースに接続する際の固定 ID として構成できます。  **web.config** ファイルの identity 要素で権限の借用を有効にし、ユーザー名とパスワードを指定します。  
+  
+```  
+<identity impersonate="true"   
+        userName="MyDomain\UserAccount"   
+        password="*****" />  
+```  
+  
+ 固定 ID アカウントには、権限の低いアカウント、つまり、データベースに対する必要な権限だけが付与されたアカウントを使用してください。  さらに、ユーザー名とパスワードがクリア テキストで表示されないよう、構成ファイルを暗号化する必要があります。  
+  
+## UDL \(Universal Data Link\) ファイルの使用回避  
+ <xref:System.Data.OleDb.OleDbConnection> の接続文字列を UDL \(Universal Data Link\) ファイルに保存することは避けてください。  UDL はクリア テキストで保存され暗号化できません。  UDL ファイルは、アプリケーションにとって外部ファイルをベースにしたリソースであるため、.NET Framework ではセキュリティ保護も暗号化もされません。  
+  
+## 接続文字列ビルダーを使用したインジェクション攻撃の防止  
+ ユーザー入力から文字列を動的に連結することによって接続文字列を構築している場合、接続文字列のインジェクション攻撃を受ける可能性があります。  ユーザー入力の検証や悪意のある文字のエスケープを怠ると、機密データなど、サーバー上のリソースへのアクセスを攻撃者に許してしまうことも考えられます。  こうした問題を解消するために、ADO.NET 2.0 では、接続文字列の構文を検証し、余分なパラメーターの追加を防ぐ新しい接続文字列ビルダー クラスが導入されました。  詳細については、「[接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+## Persist Security Info\=False の使用  
+ `Persist Security Info` の既定値は false です。すべての接続文字列には、この既定値を使用することをお勧めします。  `Persist Security Info` を `true` または `yes` に設定すると、ユーザー ID やパスワードなどのセキュリティ関連情報を、接続を開いた後にその接続から取得できます。  `Persist Security Info` を `false` または `no` に設定した場合、その情報を使って接続を開いた後で、セキュリティ情報が破棄されるため、信頼できないソースによってセキュリティ関連情報がアクセスされることを確実に防ぐことができます。  
+  
+## 構成ファイルの暗号化  
+ 接続文字列は構成ファイルに保存することもでき、そうすることで、アプリケーションのコードに接続文字列を組み込むことを避けられます。  構成ファイルは、.NET Framework が基本的な要素を定義するために使用する標準的な XML ファイルです。  通常、構成ファイル内の接続文字列は、**app.config** \(Windows アプリケーションの場合\) または **web.config** ファイル \(ASP.NET アプリケーションの場合\) の **\<connectionStrings\>** 要素に格納されます。  構成ファイルへの接続文字列の格納、構成ファイルからの接続文字列の取得、および暗号化については、「[接続文字列と構成ファイル](../../../../docs/framework/data/adonet/connection-strings-and-configuration-files.md)」を参照してください。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [Encrypting Configuration Information Using Protected Configuration](../Topic/Encrypting%20Configuration%20Information%20Using%20Protected%20Configuration.md)   
+ [PAVE Security in Native and .NET Framework Code](http://msdn.microsoft.com/ja-jp/bd61be84-c143-409a-a75a-44253724f784)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/queries-in-linq-to-dataset.md b/docs/framework/data/adonet/queries-in-linq-to-dataset.md
new file mode 100644
index 00000000000..ac01be1f8cc
--- /dev/null
+++ b/docs/framework/data/adonet/queries-in-linq-to-dataset.md
@@ -0,0 +1,70 @@
+---
+title: "Queries in LINQ to DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1a78fa8-9f0c-40bc-a372-5575a48708fe
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Queries in LINQ to DataSet
+クエリは、データ ソースからデータを取得する式です。  一般に、クエリは専用のクエリ言語で表現されます。たとえば、リレーショナル データベースであれば SQL、XML であれば XQuery が使用されます。  そのため、開発者はクエリの対象となるデータ ソースやデータ形式ごとに新しいクエリ言語を習得する必要があります。  [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] は、データ ソースや形式の違いを意識せずにデータを扱うことのできる、より簡素化された一貫したモデルを提供します。  [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] クエリでは、常にプログラミング オブジェクトを操作することになります。  
+  
+ [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] のクエリ操作は、データ ソースを取得し、クエリを作成して、クエリを実行するという 3 つのアクションから成ります。  
+  
+ [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] を介したクエリは、<xref:System.Collections.Generic.IEnumerable%601> ジェネリック インターフェイスを実装するデータ ソースに対して行うことができます。  <xref:System.Data.DataTable> で <xref:System.Data.DataTableExtensions.AsEnumerable%2A> を呼び出すと、ジェネリック <xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装するオブジェクトが返されます。このオブジェクトが、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリのデータ ソースとして機能します。  
+  
+ クエリでは、データ ソースから取得する情報を正確に指定できます。  また、並べ替え、グループ化、整形方法を指定して情報を取得することもできます。  [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] では、クエリが変数に格納されます。  一連の値を返すようにクエリを設計する場合、クエリ変数そのものが列挙可能な型であることが必要です。  このクエリ変数は、クエリの情報を保存するだけで、なんらかのアクションを実行したり、データを返したりすることはありません。  クエリを作成した後、データを取得するには、そのクエリを実行する必要があります。  
+  
+ 一連の値を返すクエリでは、クエリ変数そのものはクエリ結果を保持しません。クエリ変数には、クエリのコマンドが格納されるだけです。  クエリ変数が `foreach` ループまたは `For Each` ループで反復処理されるまで、クエリは実行されません。  これを*遅延実行*と呼びます。つまり、作成されたクエリはすぐには実行されません。  これは、任意のタイミングでクエリを実行できるということを意味します。  これは、たとえば他のアプリケーションによって更新されるデータベースがある場合に便利です。  アプリケーションで、最新情報を取得するクエリを作成し、それを繰り返し実行することにより、更新のたびに最新の情報を取得できます。  
+  
+ 遅延実行によって一連の値を返すクエリとは対照的に、シングルトン値を返すクエリは直ちに実行されます。  シングルトン クエリの例としては、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.First%2A> があります。  これらのシングルトン クエリは、結果を計算するためにはクエリ結果が必要であるため、直ちに実行されます。  たとえば、クエリ結果の平均を求めるためには、クエリを実行して、平均関数に入力データを与える必要があります。  シングルトン値を生成しないクエリでも、<xref:System.Linq.Enumerable.ToList%2A> メソッドまたは <xref:System.Linq.Enumerable.ToArray%2A> メソッドを使用することによって、即時実行を強制できます。  即時実行を強制するこの手法は、クエリの結果をキャッシュする場合などに使用すると効果的です。  クエリの遅延実行と即時実行の詳細については、「[Getting Started with LINQ](http://msdn.microsoft.com/ja-jp/6cc9af04-950a-4cc3-83d4-2aeb4abe4de9)」を参照してください。  
+  
+## クエリ  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリは、クエリ式の構文とメソッド ベースのクエリ構文という 2 とおりの構文を使って作成できます。  
+  
+### クエリ式の構文  
+ クエリ式は宣言型のクエリ構文です。  開発者は SQL に似た構文形式を C\# または Visual Basic で用いてクエリを作成できます。  クエリ式の構文を使用することにより、フィルター、並べ替え、グループ化など、データ ソースに対するきわめて複雑な処理を最小限のコードで実行できます。  詳細については、「[LINQ クエリ式](../Topic/LINQ%20Query%20Expressions%20\(C%23%20Programming%20Guide\).md)」および「[基本的なクエリ操作 \(Visual Basic\)](../Topic/Basic%20Query%20Operations%20\(Visual%20Basic\).md)」を参照してください。  
+  
+ クエリ式の構文は、C\# 3.0 および [!INCLUDE[vb_orcas_long](../../../../includes/vb-orcas-long-md.md)] で新たに導入されたものです。  ただし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の共通言語ランタイム \(CLR\) は、クエリ式の構文そのものを理解することはできません。  そのため、クエリ式はコンパイル時に、CLR が理解できる形式 \(メソッド呼び出し\) へと変換されます。  これらのメソッドを*標準クエリ演算子*といいます。  開発者は、クエリ構文を使う代わりに、メソッド構文を使ってそれらを直接呼び出すこともできます。  詳細については、「[Query Syntax and Method Syntax in LINQ](../Topic/Query%20Syntax%20and%20Method%20Syntax%20in%20LINQ%20\(C%23\).md)」を参照してください。  標準クエリ演算子の使用方法の詳細については、「[NOT IN BUILD: LINQ General Programming Guide](http://msdn.microsoft.com/ja-jp/609c7a6b-cbdd-429d-99f3-78d13d3bc049)」を参照してください。  
+  
+ 次の例では、<xref:System.Linq.Enumerable.Select%2A> を使用して `Product` テーブルからすべての行を取得し、製品名を表示しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectSimple1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectsimple1)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectSimple1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectsimple1)]  
+  
+### メソッド ベースのクエリ構文  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリを作成するもう 1 つの方法として、メソッド ベースのクエリがあります。  メソッド ベースのクエリ構文は、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] の演算子メソッドを、ラムダ式をパラメーターとして直接順次呼び出すものです。  詳細については、「[ラムダ式](../Topic/Lambda%20Expressions%20\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+ 次の例では、<xref:System.Linq.Enumerable.Select%2A> を使用して `Product` テーブルからすべての行を取得し、製品名を表示しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectAnonymousTypes_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectanonymoustypes_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectAnonymousTypes_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectanonymoustypes_mq)]  
+  
+## クエリの作成  
+ 前述したように、一連の値を返すように設計されたクエリでは、クエリ変数自体にはクエリ コマンドのみが格納されます。  クエリに即時実行を促すメソッドが含まれていなければ、`foreach` ループまたは `For Each` ループでクエリ変数を反復処理するまで、実際にはクエリは実行されません。  遅延実行により、複数のクエリを組み合わせたり、クエリを拡張したりすることが可能となります。  クエリを拡張して新しい操作を追加すると、その変更が最終的な実行時に反映されます。  次の例の最初のクエリでは、すべての製品が返されます。  2 つ目のクエリでは、サイズが "L" のすべての製品を返すように、`Where` を使って 1 つ目のクエリを拡張しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Composing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#composing)]
+ [!code-vb[DP LINQ to DataSet Examples#Composing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#composing)]  
+  
+ クエリを拡張した後は、追加のクエリを作成することはできません。それ以降のすべてのクエリでは、インメモリの [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 演算子が使用されます。  クエリが実行されるのは、`foreach` ステートメントまたは `For Each` ステートメントでクエリ変数を反復処理したときか、即時実行を促すいずれかの [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 変換演算子を呼び出した場合です。  即時実行を促す演算子としては、<xref:System.Linq.Enumerable.ToList%2A>、<xref:System.Linq.Enumerable.ToArray%2A>、<xref:System.Linq.Enumerable.ToLookup%2A>、<xref:System.Linq.Enumerable.ToDictionary%2A> などがあります。  
+  
+ 次の例の最初のクエリは、すべての製品を表示価格で並べ替えて返します。  <xref:System.Linq.Enumerable.ToArray%2A> メソッドを使用して、クエリの即時実行を強制しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ToArray2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#toarray2)]
+ [!code-vb[DP LINQ to DataSet Examples#ToArray2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#toarray2)]  
+  
+## 参照  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)   
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)   
+ [Getting Started with LINQ in C\#](../Topic/Getting%20Started%20with%20LINQ%20in%20C%23.md)   
+ [Getting Started with LINQ in Visual Basic](../Topic/Getting%20Started%20with%20LINQ%20in%20Visual%20Basic.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-examples-linq-to-dataset.md b/docs/framework/data/adonet/query-expression-examples-linq-to-dataset.md
new file mode 100644
index 00000000000..efaa1c586f2
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-examples-linq-to-dataset.md
@@ -0,0 +1,47 @@
+---
+title: "Query Expression Examples (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f743fbc7-faff-45e5-af1e-61577d87f0cc
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Examples (LINQ to DataSet)
+このセクションでは、標準クエリ演算子を使った [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] プログラミングの例を、クエリ式の構文を中心に説明します。  これらの例に使用されている <xref:System.Data.DataSet> のデータは、`FillDataSet` メソッド \(「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照\) を使って読み込みます。  詳細については、「[Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Projection](../../../../docs/framework/data/adonet/query-expression-syntax-examples-projection-linq-to-dataset.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Select%2A> メソッドおよび <xref:System.Linq.Enumerable.SelectMany%2A> メソッドを使って <xref:System.Data.DataSet> を照会する例を取り上げます。  
+  
+ [Restriction](../../../../docs/framework/data/adonet/query-expression-syntax-examples-restriction-linq-to-dataset.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Where%2A> メソッドを使って <xref:System.Data.DataSet> を照会する例を取り上げます。  
+  
+ [Partitioning](../../../../docs/framework/data/adonet/query-expression-syntax-examples-partitioning.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Skip%2A> メソッドおよび <xref:System.Linq.Enumerable.Take%2A> メソッドを使って <xref:System.Data.DataSet> を照会し、結果をパーティション分割する例を取り上げます。  
+  
+ [Ordering](../../../../docs/framework/data/adonet/query-expression-syntax-examples-ordering-linq-to-dataset.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.OrderBy%2A>、<xref:System.Linq.Enumerable.OrderByDescending%2A>、<xref:System.Linq.Enumerable.Reverse%2A>、<xref:System.Linq.Enumerable.ThenByDescending%2A> の各メソッドを使って <xref:System.Data.DataSet> を照会し、結果を並べ替える例を取り上げます。  
+  
+ [Element Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-element-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.First%2A> メソッドおよび <xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用して <xref:System.Data.DataSet> から <xref:System.Data.DataRow> 要素を取得する例を取り上げます。  
+  
+ [Aggregate Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-aggregate-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、<xref:System.Linq.Enumerable.Sum%2A> の各メソッドを使って <xref:System.Data.DataSet> を照会し、データを集計する例を取り上げます。  
+  
+ [Join Operators](../../../../docs/framework/data/adonet/query-expression-syntax-examples-join-operators.md)  
+ このトピックでは、<xref:System.Linq.Enumerable.GroupJoin%2A> メソッドおよび <xref:System.Linq.Enumerable.Join%2A> メソッドを使って <xref:System.Data.DataSet> を照会する例を取り上げます。  
+  
+## 参照  
+ [Method\-Based Query Examples](../../../../docs/framework/data/adonet/method-based-query-examples-linq-to-dataset.md)   
+ [DataSet\-Specific Operator Examples](../../../../docs/framework/data/adonet/dataset-specific-operator-examples-linq-to-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-aggregate-operators.md b/docs/framework/data/adonet/query-expression-syntax-examples-aggregate-operators.md
new file mode 100644
index 00000000000..2d38f4857ea
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-aggregate-operators.md
@@ -0,0 +1,106 @@
+---
+title: "Query Expression Syntax Examples: Aggregate Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85dafa07-e102-46e7-ab78-37bf06f257a6
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Aggregate Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A>、<xref:System.Linq.Enumerable.Max%2A>、<xref:System.Linq.Enumerable.Min%2A>、および <xref:System.Linq.Enumerable.Sum%2A> の各メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> および集計データに対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Average  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> メソッドを使用して、各スタイルの製品の平均表示価格を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Average2_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#average2_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#Average2_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#average2_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> を使用して、それぞれの連絡先 ID について平均合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#AverageGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#averagegrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#AverageGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#averagegrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Average%2A> を使用して、それぞれの連絡先について `TotalDue` が平均値の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#AverageElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#averageelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#AverageElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#averageelements_mq)]  
+  
+## Count  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Count%2A> を使用して、連絡先 ID の一覧と、それぞれの注文数を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CountNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#countnested)]
+ [!code-vb[DP LINQ to DataSet Examples#CountNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#countnested)]  
+  
+### 例  
+ この例では、製品を色でグループ分けし、<xref:System.Linq.Enumerable.Count%2A> を使用してそれぞれの色グループに含まれる製品の数を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#CountGrouped](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#countgrouped)]
+ [!code-vb[DP LINQ to DataSet Examples#CountGrouped](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#countgrouped)]  
+  
+## 最大  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について最大合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MaxGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#maxgrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MaxGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#maxgrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Max%2A> メソッドを使用して、それぞれの連絡先 ID について `TotalDue` が最大の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MaxElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#maxelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MaxElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#maxelements_mq)]  
+  
+## 最小  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先 ID について最小合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MinGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#mingrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MinGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#mingrouped_mq)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Min%2A> メソッドを使用して、それぞれの連絡先について合計支払額が最小の注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#MinElements_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#minelements_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#MinElements_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#minelements_mq)]  
+  
+## Sum  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Sum%2A> メソッドを使用して、それぞれの連絡先 ID について合計支払額を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SumGrouped_MQ](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#sumgrouped_mq)]
+ [!code-vb[DP LINQ to DataSet Examples#SumGrouped_MQ](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#sumgrouped_mq)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-element-operators.md b/docs/framework/data/adonet/query-expression-syntax-examples-element-operators.md
new file mode 100644
index 00000000000..e6e3abefb0e
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-element-operators.md
@@ -0,0 +1,52 @@
+---
+title: "Query Expression Syntax Examples: Element Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca392dda-16e3-45c7-8d87-12d8d4ee0578
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Element Operators (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.First%2A> メソッドおよび <xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用し、クエリ式の構文を使って <xref:System.Data.DataSet> から <xref:System.Data.DataRow> 要素を取得する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## ElementAt  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ElementAt%2A> メソッドを使用し、`PostalCode` \=\= "M4B 1V7" の条件に該当する 5 番目の住所を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ElementAt](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#elementat)]
+ [!code-vb[DP LINQ to DataSet Examples#ElementAt](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#elementat)]  
+  
+## First  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.First%2A> メソッドを使用して、名が 'Brooke' である最初の連絡先を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#FirstSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#firstsimple)]
+ [!code-vb[DP LINQ to DataSet Examples#FirstSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#firstsimple)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-join-operators.md b/docs/framework/data/adonet/query-expression-syntax-examples-join-operators.md
new file mode 100644
index 00000000000..3db9e8ee103
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-join-operators.md
@@ -0,0 +1,60 @@
+---
+title: "Query Expression Syntax Examples: Join Operators (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4d86667-3392-470d-a076-5ca6cbb660f6
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Join Operators (LINQ to DataSet)
+結合は、リレーショナル データベース テーブルのように互いにナビゲート可能なリレーションシップを持たないデータ ソースをターゲットとするクエリにおいて重要な操作です。  2 つのデータ ソースを結合する操作とは、あるデータ ソース内のオブジェクトを、他方のデータ ソース内で共通の属性を持つオブジェクトと関連付けることです。  詳細については、「[Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+ このトピックでは、<xref:System.Linq.Enumerable.GroupJoin%2A> メソッドおよび <xref:System.Linq.Enumerable.Join%2A> メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## GroupJoin  
+  
+### 例  
+ この例では、`SalesOrderHeader` テーブルおよび `SalesOrderDetail` テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行することによって、顧客ごとの注文数を調べます。  GroupJoin は、左外部結合に相当します。つまり、1 つ目 \(左側\) のデータ ソースに存在するすべての要素は、関連する要素がもう一方のデータ ソースに存在するかどうかに関係なく返されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#GroupJoin2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#groupjoin2)]
+ [!code-vb[DP LINQ to DataSet Examples#GroupJoin2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#groupjoin2)]  
+  
+### 例  
+ この例では、`Contact` テーブルと `SalesOrderHeader` テーブルに対して <xref:System.Linq.Enumerable.GroupJoin%2A> を実行します。  GroupJoin は、左外部結合に相当します。つまり、1 つ目 \(左側\) のデータ ソースに存在するすべての要素は、関連する要素がもう一方のデータ ソースに存在するかどうかに関係なく返されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#GroupJoin](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#groupjoin)]
+ [!code-vb[DP LINQ to DataSet Examples#GroupJoin](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#groupjoin)]  
+  
+## Join  
+  
+### 例  
+ この例では、`SalesOrderHeader` テーブルと `SalesOrderDetail` テーブルを結合し、8 月以降のオンラインでの注文を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Join](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#join)]
+ [!code-vb[DP LINQ to DataSet Examples#Join](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#join)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-ordering-linq-to-dataset.md b/docs/framework/data/adonet/query-expression-syntax-examples-ordering-linq-to-dataset.md
new file mode 100644
index 00000000000..886f7e9cf26
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-ordering-linq-to-dataset.md
@@ -0,0 +1,74 @@
+---
+title: "Query Expression Syntax Examples: Ordering (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 653a4a97-1e4a-4b2d-8d24-7dbe1f2a5c84
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Ordering (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.OrderBy%2A>、<xref:System.Linq.Enumerable.OrderByDescending%2A>、<xref:System.Linq.Enumerable.Reverse%2A>、および <xref:System.Linq.Enumerable.ThenByDescending%2A> の各メソッドで、クエリ構文を使って <xref:System.Data.DataSet> に対するクエリを実行し、その結果を並べ替える例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## OrderBy  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> を使用して、姓の順に並べ替えられた連絡先の一覧を返します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#OrderBySimple1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#orderbysimple1)]
+ [!code-vb[DP LINQ to DataSet Examples#OrderBySimple1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#orderbysimple1)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderBy%2A> を使用して、連絡先の一覧を名の長さの順に並べ替えます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#OrderBySimple2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#orderbysimple2)]
+ [!code-vb[DP LINQ to DataSet Examples#OrderBySimple2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#orderbysimple2)]  
+  
+## OrderByDescending  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.OrderByDescending%2A> メソッドと同等の `orderby  descending` \(`Order By   Descending`\) を使用して、価格の一覧を高いものから低い順に並べ替えます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#OrderByDescendingSimple1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#orderbydescendingsimple1)]
+ [!code-vb[DP LINQ to DataSet Examples#OrderByDescendingSimple1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#orderbydescendingsimple1)]  
+  
+## Reverse  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Reverse%2A> を使用して、`OrderDate` が 2002 年 2 月 20 日よりも前の日付である注文の一覧を作成します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Reverse](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#reverse)]
+ [!code-vb[DP LINQ to DataSet Examples#Reverse](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#reverse)]  
+  
+## ThenByDescending  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.ThenByDescending%2A> メソッドと同等の `OrderBy  Descending` を使用して、製品の一覧を、名前順に、次に表示価格の高いものから低い順に並べ替えます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ThenByDescendingSimple](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#thenbydescendingsimple)]
+ [!code-vb[DP LINQ to DataSet Examples#ThenByDescendingSimple](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#thenbydescendingsimple)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-partitioning.md b/docs/framework/data/adonet/query-expression-syntax-examples-partitioning.md
new file mode 100644
index 00000000000..45049eec33b
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-partitioning.md
@@ -0,0 +1,52 @@
+---
+title: "Query Expression Syntax Examples: Partitioning (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: beb5f361-1ac8-44fb-afa1-2aacea15f166
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Partitioning (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Skip%2A> メソッドおよび <xref:System.Linq.Enumerable.Take%2A> メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Skip  
+  
+### 例  
+ この例では、Seattle から最初の 2 つを除くすべての住所を、<xref:System.Linq.Enumerable.Skip%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SkipNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#skipnested)]
+ [!code-vb[DP LINQ to DataSet Examples#SkipNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#skipnested)]  
+  
+## Take  
+  
+### 例  
+ この例では、Seattle から最初の 3 つの住所を、<xref:System.Linq.Enumerable.Take%2A> メソッドを使って取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#TakeNested](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#takenested)]
+ [!code-vb[DP LINQ to DataSet Examples#TakeNested](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#takenested)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-projection-linq-to-dataset.md b/docs/framework/data/adonet/query-expression-syntax-examples-projection-linq-to-dataset.md
new file mode 100644
index 00000000000..615e3f0d315
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-projection-linq-to-dataset.md
@@ -0,0 +1,70 @@
+---
+title: "Query Expression Syntax Examples: Projection  (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48c9f5ed-76bf-4228-ab10-5217bbb295a3
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Projection  (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Select%2A> メソッドおよび <xref:System.Linq.Enumerable.SelectMany%2A> メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Select  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Select%2A> メソッドを使用して `Product` テーブルからすべての行を取得し、製品名を表示しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectSimple1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectsimple1)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectSimple1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectsimple1)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Select%2A> を使用して、製品名のみのシーケンスを取得しています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectSimple2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectsimple2)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectSimple2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectsimple2)]  
+  
+## SelectMany  
+  
+### 例  
+ この例では、`From  ,`  \(<xref:System.Linq.Enumerable.SelectMany%2A> と同等のメソッド\) を使用して、`TotalDue` が 500.00 に満たないすべての注文を選択します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectManyCompoundFrom](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectmanycompoundfrom)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectManyCompoundFrom](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectmanycompoundfrom)]  
+  
+### 例  
+ この例では、`From  ,`  \(<xref:System.Linq.Enumerable.SelectMany%2A> と同等のメソッド\) を使用して、2002 年 10 月 1 日に受けたすべての注文を選択します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectManyCompoundFrom2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectmanycompoundfrom2)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectManyCompoundFrom2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectmanycompoundfrom2)]  
+  
+### 例  
+ この例では、`From  ,`  \(<xref:System.Linq.Enumerable.SelectMany%2A> と同等のメソッド\) を使用して、注文の合計が 10000.00 を超えるすべての注文を選択します。このとき、`From` 割り当てを使用して、合計を 2 回要求しないようにしています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#SelectManyFromAssignment](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#selectmanyfromassignment)]
+ [!code-vb[DP LINQ to DataSet Examples#SelectManyFromAssignment](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#selectmanyfromassignment)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/query-expression-syntax-examples-restriction-linq-to-dataset.md b/docs/framework/data/adonet/query-expression-syntax-examples-restriction-linq-to-dataset.md
new file mode 100644
index 00000000000..94da974d225
--- /dev/null
+++ b/docs/framework/data/adonet/query-expression-syntax-examples-restriction-linq-to-dataset.md
@@ -0,0 +1,62 @@
+---
+title: "Query Expression Syntax Examples: Restriction (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1daf42c2-c9f4-4cda-b291-7641b9c6d3fe
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Expression Syntax Examples: Restriction (LINQ to DataSet)
+このトピックでは、<xref:System.Linq.Enumerable.Where%2A> メソッドで、クエリ式の構文を使って <xref:System.Data.DataSet> に対するクエリを実行する例を紹介しています。  
+  
+ これらの例で使用されている `FillDataSet` メソッドの指定については、「[Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)」を参照してください。  
+  
+ このトピックの例には、AdventureWorks サンプル データベースの Contact、Address、Product、SalesOrderHeader、SalesOrderDetail の各テーブルが使用されています。  
+  
+ このトピックの例には、次の `using`\/`Imports` ステートメントが使用されています。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#importsusing)]
+ [!code-vb[DP LINQ to DataSet Examples#ImportsUsing](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#importsusing)]  
+  
+ 詳細については、「[How to: Create a LINQ to DataSet Project In Visual Studio](../../../../docs/framework/data/adonet/how-to-create-a-linq-to-dataset-project-in-vs.md)」を参照してください。  
+  
+## Where  
+  
+### 例  
+ この例では、すべてのオンライン注文が返されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Where1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#where1)]
+ [!code-vb[DP LINQ to DataSet Examples#Where1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#where1)]  
+  
+### 例  
+ この例では、注文数量が 3 個以上で 5 個以下の注文が返されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Where2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#where2)]
+ [!code-vb[DP LINQ to DataSet Examples#Where2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#where2)]  
+  
+### 例  
+ この例では、色が赤の製品がすべて返されます。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#Where3](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#where3)]
+ [!code-vb[DP LINQ to DataSet Examples#Where3](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#where3)]  
+  
+### 例  
+ この例では、<xref:System.Linq.Enumerable.Where%2A> メソッドを使用して、2002 年 12 月 1 日以降に受けた注文を検索します。次に、<xref:System.Data.DataRow.GetChildRows%2A> メソッドを使用して、各注文の詳細を取得します。  
+  
+ [!code-csharp[DP LINQ to DataSet Examples#WhereDrillDown](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#wheredrilldown)]
+ [!code-vb[DP LINQ to DataSet Examples#WhereDrillDown](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#wheredrilldown)]  
+  
+## 参照  
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)   
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Standard Query Operators Overview](../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/querying-datasets-linq-to-dataset.md b/docs/framework/data/adonet/querying-datasets-linq-to-dataset.md
new file mode 100644
index 00000000000..e523666750e
--- /dev/null
+++ b/docs/framework/data/adonet/querying-datasets-linq-to-dataset.md
@@ -0,0 +1,36 @@
+---
+title: "Querying DataSets (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb68d2e4-623d-4d60-85e3-965254f6fee7
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Querying DataSets (LINQ to DataSet)
+<xref:System.Data.DataSet> オブジェクトへのデータの読み込みが完了すると、そのデータセットに対してクエリを実行できるようになります。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使ったクエリの作成方法は、他の [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 対応データ ソースに対して [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] を使用する方法と似ています。  ただし、<xref:System.Data.DataSet> オブジェクトに対して [!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] クエリを実行する場合、カスタム型の列挙体ではなく、<xref:System.Data.DataRow> オブジェクトの列挙体を照会しているという点に留意してください。  つまり、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] クエリでは、<xref:System.Data.DataRow> クラスの任意のメンバーを使用できるということです。  これにより、高度で複雑なクエリの作成が可能となります。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリには、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] の他の実装と同様、クエリ式の構文とメソッド ベースのクエリ構文という 2 とおりの作成形式があります。  この 2 つの形式の詳細については、「[Getting Started with LINQ](http://msdn.microsoft.com/ja-jp/6cc9af04-950a-4cc3-83d4-2aeb4abe4de9)」を参照してください。クエリ式の構文またはメソッド ベースのクエリ構文を使用して、<xref:System.Data.DataSet> 内の単一テーブル、<xref:System.Data.DataSet> 内の複数テーブル、または、型指定された <xref:System.Data.DataSet> 内のテーブルを対象にクエリを実行できます。  
+  
+## このセクションの内容  
+ [Single\-Table Queries](../../../../docs/framework/data/adonet/single-table-queries-linq-to-dataset.md)  
+ 単一テーブルのクエリを実行する方法について説明します。  
+  
+ [Cross\-Table Queries](../../../../docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md)  
+ 複数テーブルにまたがるクエリを実行する方法について説明します。  
+  
+ [Querying Typed DataSets](../../../../docs/framework/data/adonet/querying-typed-datasets.md)  
+ 型指定された <xref:System.Data.DataSet> オブジェクトに対してクエリを実行する方法について説明します。  
+  
+## 参照  
+ [LINQ to DataSet Examples](../../../../docs/framework/data/adonet/linq-to-dataset-examples.md)   
+ [Loading Data Into a DataSet](../../../../docs/framework/data/adonet/loading-data-into-a-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/querying-the-datarowview-collection-in-a-dataview.md b/docs/framework/data/adonet/querying-the-datarowview-collection-in-a-dataview.md
new file mode 100644
index 00000000000..62dde52d06c
--- /dev/null
+++ b/docs/framework/data/adonet/querying-the-datarowview-collection-in-a-dataview.md
@@ -0,0 +1,33 @@
+---
+title: "Querying the DataRowView Collection in a DataView | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9070a12-1094-44d6-bb87-a23b50bcb0af
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Querying the DataRowView Collection in a DataView
+<xref:System.Data.DataView> は、<xref:System.Data.DataRowView> オブジェクトの列挙可能なコレクションを公開します。  <xref:System.Data.DataRowView> は、<xref:System.Data.DataRow> のカスタマイズされたビューを表し、<xref:System.Data.DataRow> の特定のバージョンをコントロールに表示します。  <xref:System.Windows.Forms.DataGridView> などのコントロールを通じて、<xref:System.Data.DataRow> のバージョンを 1 つだけ表示できます。  <xref:System.Data.DataRowView> が <xref:System.Data.DataRowView> の <xref:System.Data.DataRowView.Row%2A> プロパティを使用して公開している <xref:System.Data.DataRow> にアクセスできます。  <xref:System.Data.DataRowView> を使用して値を表示している場合は、<xref:System.Data.DataView.RowStateFilter%2A> プロパティによって、基になる <xref:System.Data.DataRow> から公開される行バージョンが決まります。  <xref:System.Data.DataRow> を使用してさまざまな行バージョンにアクセスする方法については、「[行の状態とバージョン](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)」を参照してください。  <xref:System.Data.DataView> によって公開される <xref:System.Data.DataRowView> オブジェクトのコレクションは列挙可能であるため、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用して照会できます。  
+  
+ 次の例では、`Product` テーブルに対して赤色の製品を照会し、そのクエリに基づくテーブルを作成します。  このテーブルから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView.RowStateFilter%2A> プロパティに、削除行と変更行を条件とするフィルターを設定します。  次に <xref:System.Data.DataView> を LINQ クエリのソースとして使用し、変更済みおよび削除済みの <xref:System.Data.DataRowView> オブジェクトを <xref:System.Windows.Forms.DataGridView> コントロールにバインドします。  
+  
+ [!code-csharp[DP DataView Samples#QueryDataView2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#querydataview2)]
+ [!code-vb[DP DataView Samples#QueryDataView2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#querydataview2)]  
+  
+ 次の例では、<xref:System.Windows.Forms.DataGridView> コントロールにバインドされたビューから製品のテーブルを作成します。  <xref:System.Data.DataView> に対して赤色の製品を照会し、並べ替えた結果を <xref:System.Windows.Forms.DataGridView> コントロールにバインドしています。  
+  
+ [!code-csharp[DP DataView Samples#QueryDataView1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#querydataview1)]
+ [!code-vb[DP DataView Samples#QueryDataView1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#querydataview1)]  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/querying-typed-datasets.md b/docs/framework/data/adonet/querying-typed-datasets.md
new file mode 100644
index 00000000000..3b59cec24b5
--- /dev/null
+++ b/docs/framework/data/adonet/querying-typed-datasets.md
@@ -0,0 +1,66 @@
+---
+title: "Querying Typed DataSets | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad712fa1-2baf-462a-b163-574cce6d376a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Querying Typed DataSets
+アプリケーションのデザイン時に <xref:System.Data.DataSet> のスキーマがわかっている場合は、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] を使用するときに、型指定された <xref:System.Data.DataSet> を用いることをお勧めします。  型指定された <xref:System.Data.DataSet> とは、<xref:System.Data.DataSet> から派生するクラスのことです。  したがって、型指定されたデータセットは <xref:System.Data.DataSet> のすべてのメソッド、イベント、およびプロパティを継承します。  さらに、型指定された <xref:System.Data.DataSet> には、厳密に型指定されたメソッド、イベント、およびプロパティが用意されています。  つまり、コレクションベースのメソッドを使用せずに名前でテーブルおよび列にアクセスできます。  これによりクエリが簡素化され、読みやすくなります。  詳細については、「[型指定された DataSet](../../../../docs/framework/data/adonet/dataset-datatable-dataview/typed-datasets.md)」を参照してください。  
+  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] は、型指定された <xref:System.Data.DataSet> に対するクエリもサポートしています。  型指定された <xref:System.Data.DataSet> を使用した場合、ジェネリック メソッドの <xref:System.Data.DataRowExtensions.Field%2A> または <xref:System.Data.DataRowExtensions.SetField%2A> を使って列データにアクセスする必要はありません。  <xref:System.Data.DataSet> に型情報が含まれているため、プロパティ名をコンパイル時に利用できます。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] では、列の値に適切な型としてアクセスすることが可能となるため、型の不一致エラーは実行時ではなくコードのコンパイル時にキャッチされます。  
+  
+ 型指定された <xref:System.Data.DataSet> に対してクエリを実行するには、[!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)] のデータセット デザイナーを使用してあらかじめクラスを生成しておく必要があります。  詳細については、「[方法 : 型指定されたデータセットを作成する](../Topic/Create%20and%20configure%20datasets%20in%20Visual%20Studio.md)」を参照してください。  
+  
+## 例  
+ 次の例では、型指定された <xref:System.Data.DataSet> に対してクエリを実行しています。  
+  
+```csharp  
+var query = from o in orders  
+            where o.OnlineOrderFlag == true  
+            select new { o.SalesOrderID,  
+                         o.OrderDate,  
+                         o.SalesOrderNumber };  
+  
+foreach(var order in query)   
+{  
+    Console.WriteLine("{0}\t{1:d}\t{2}",   
+order.SalesOrderID,   
+order.OrderDate,   
+order.SalesOrderNumber);  
+}  
+```  
+  
+```vb  
+Dim orders = ds.Tables("SalesOrderHeader")  
+  
+Dim query = _  
+       From o In orders _  
+       Where o.OnlineOrderFlag = True _  
+       Select New {SalesOrderID := o.SalesOrderID, _  
+                   OrderDate := o.OrderDate, _  
+                   SalesOrderNumber := o.SalesOrderNumber}  
+  
+For Each Dim onlineOrder In query  
+ Console.WriteLine("{0}\t{1:d}\t{2}", _  
+ onlineOrder.SalesOrderID, _  
+ onlineOrder.OrderDate, _  
+ onlineOrder.SalesOrderNumber)  
+Next  
+```  
+  
+## 参照  
+ [Querying DataSets](../../../../docs/framework/data/adonet/querying-datasets-linq-to-dataset.md)   
+ [Cross\-Table Queries](../../../../docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md)   
+ [Single\-Table Queries](../../../../docs/framework/data/adonet/single-table-queries-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ref-cursor-examples.md b/docs/framework/data/adonet/ref-cursor-examples.md
new file mode 100644
index 00000000000..1c42aab0a4a
--- /dev/null
+++ b/docs/framework/data/adonet/ref-cursor-examples.md
@@ -0,0 +1,91 @@
+---
+title: "REF CURSOR の例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c257da03-c6c9-4cf8-b591-b7740a962c40
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# REF CURSOR の例
+REF CURSOR の例は、REF CURSOR の使い方を説明する、次の 3 つの Microsoft Visual Basic の例によって構成されています。  
+  
+|サンプル|説明|  
+|----------|--------|  
+|[OracleDataReader の REF CURSOR パラメーター](../../../../docs/framework/data/adonet/ref-cursor-parameters-in-an-oracledatareader.md)|この例では、REF CURSOR パラメーターを返し、<xref:System.Data.OracleClient.OracleDataReader> として値を読み込む PL\/SQL ストアド プロシージャを実行します。|  
+|[OracleDataReader を使用した複数の REF CURSOR からのデータの取得](../../../../docs/framework/data/adonet/retrieving-data-from-multiple-ref-cursors.md)|この例では、2 つの REF CURSOR パラメーターを返し、**OracleDataReader** を使用して値を読み込む PL\/SQL ストアド プロシージャを実行します。|  
+|[1 つまたは複数の REF CURSOR を使用した DataSet の値の設定](../../../../docs/framework/data/adonet/filling-a-dataset-using-one-or-more-ref-cursors.md)|この例では、2 つの REF CURSOR パラメーターを返し、返された行を <xref:System.Data.DataSet> に入力する PL\/SQL ストアド プロシージャを実行します。|  
+  
+ これらの例を使用するには、必要に応じて Oracle テーブルを作成し、さらに PL\/SQL パッケージとパッケージ本体を作成する必要があります。  
+  
+## Oracle テーブルの作成  
+ これらの例では、Oracle Scott\/Tiger スキーマで定義されたテーブルを使用します。  Oracle Scott\/Tiger スキーマは、ほとんどの Oracle のインストールに含まれています。  このスキーマが含まれていない場合は、{OracleHome}\\rdbms\\admin\\scott.sql にある SQL コマンド ファイルを使用して、これらの例で使用されているテーブルとインデックスを作成します。  
+  
+## Oracle パッケージとパッケージ本体の作成  
+ これらの例では、次の PL\/SQL パッケージとパッケージ本体がサーバー上に必要になります。  次の Oracle パッケージを Oracle サーバー上に作成します。  
+  
+```  
+CREATE OR REPLACE PACKAGE CURSPKG AS   
+    TYPE T_CURSOR IS REF CURSOR;   
+    PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,   
+                               IO_CURSOR IN OUT T_CURSOR);   
+    PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
+                                DEPTCURSOR OUT T_CURSOR);  
+END CURSPKG;  
+/   
+```  
+  
+ Oracle サーバーで、次の Oracle パッケージ本体を作成します。  
+  
+```  
+CREATE OR REPLACE PACKAGE BODY CURSPKG AS  
+    PROCEDURE OPEN_ONE_CURSOR (N_EMPNO IN NUMBER,  
+                               IO_CURSOR IN OUT T_CURSOR)  
+    IS   
+        V_CURSOR T_CURSOR;   
+    BEGIN   
+        IF N_EMPNO <> 0   
+        THEN  
+             OPEN V_CURSOR FOR   
+             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
+                  FROM EMP, DEPT   
+                  WHERE EMP.DEPTNO = DEPT.DEPTNO   
+                  AND EMP.EMPNO = N_EMPNO;  
+  
+        ELSE   
+             OPEN V_CURSOR FOR   
+             SELECT EMP.EMPNO, EMP.ENAME, DEPT.DEPTNO, DEPT.DNAME   
+                  FROM EMP, DEPT   
+                  WHERE EMP.DEPTNO = DEPT.DEPTNO;  
+  
+        END IF;  
+        IO_CURSOR := V_CURSOR;   
+    END OPEN_ONE_CURSOR;   
+  
+    PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,  
+                                DEPTCURSOR OUT T_CURSOR)  
+    IS   
+        V_CURSOR1 T_CURSOR;   
+        V_CURSOR2 T_CURSOR;   
+    BEGIN   
+        OPEN V_CURSOR1 FOR SELECT * FROM EMP;  
+        OPEN V_CURSOR2 FOR SELECT * FROM DEPT;  
+        EMPCURSOR  := V_CURSOR1;   
+        DEPTCURSOR := V_CURSOR2;   
+    END OPEN_TWO_CURSORS;   
+END CURSPKG;  
+/  
+```  
+  
+## 参照  
+ [Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/ref-cursor-parameters-in-an-oracledatareader.md b/docs/framework/data/adonet/ref-cursor-parameters-in-an-oracledatareader.md
new file mode 100644
index 00000000000..cda27e3c6be
--- /dev/null
+++ b/docs/framework/data/adonet/ref-cursor-parameters-in-an-oracledatareader.md
@@ -0,0 +1,53 @@
+---
+title: "OracleDataReader の REF CURSOR パラメーター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 801dff0f-2508-45aa-9416-f45d6887740c
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OracleDataReader の REF CURSOR パラメーター
+この Microsoft Visual Basic の例では、REF CURSOR パラメーターを返し、<xref:System.Data.OracleClient.OracleDataReader> を使用して値を読み取る、PL\/SQL ストアド プロシージャを実行します。  
+  
+```vb  
+Private Sub Button1_Click(ByVal sender As Object, _  
+  ByVal e As System.EventArgs) Handles Button1.Click  
+  
+  Dim connString As New String(_  
+      "Data Source=Oracle9i;User ID=scott;Password=tiger;")  
+  Using conn As New OracleConnection(connString)  
+    Dim cmd As New OracleCommand()  
+    Dim rdr As OracleDataReader  
+  
+    conn.Open()  
+    cmd.Connection = conn  
+    cmd.CommandText = "CURSPKG.OPEN_ONE_CURSOR"  
+    cmd.CommandType = CommandType.StoredProcedure  
+    cmd.Parameters.Add(New OracleParameter(  
+      "N_EMPNO", OracleType.Number)).Value = 7369  
+    cmd.Parameters.Add(New OracleParameter(  
+      "IO_CURSOR", OracleType.Cursor)).Direction = ParameterDirection.Output  
+  
+    rdr = cmd.ExecuteReader()  
+    While (rdr.Read())  
+        REM do something with the values  
+    End While  
+  
+    rdr.Close()  
+  End Using  
+End Sub  
+```  
+  
+## 参照  
+ [Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/referential-integrity-constraint.md b/docs/framework/data/adonet/referential-integrity-constraint.md
new file mode 100644
index 00000000000..5b47219c5b7
--- /dev/null
+++ b/docs/framework/data/adonet/referential-integrity-constraint.md
@@ -0,0 +1,45 @@
+---
+title: "参照整合性制約 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d3ba44b-4302-40d8-a7a9-62932e0395e5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 参照整合性制約
+Entity Data Model \(EDM\) の*参照整合性制約*は、リレーショナル データベースの参照整合性制約と似ています。  データベース テーブルの列が別のテーブルの主キーを参照できるのと同じように、[エンティティ型](../../../../docs/framework/data/adonet/entity-type.md)の[プロパティ](../../../../docs/framework/data/adonet/property.md)は別のエンティティ型の[エンティティ キー](../../../../docs/framework/data/adonet/entity-key.md)を参照できます。  参照されるエンティティ型は、制約の*プリンシパル End* と呼ばれます。  プリンシパル End を参照するエンティティ型は、制約の*依存 End* と呼ばれます。  
+  
+ 参照整合性制約は、2 つのエンティティ型の間の[アソシエーション](../../../../docs/framework/data/adonet/association-type.md)の一部として定義されます。  参照整合性制約の定義には、次の情報を指定します。  
+  
+-   制約のプリンシパル End。  \(エンティティ キーが依存 End により参照されるエンティティ型\)  
+  
+-   プリンシパル End のエンティティ キー。  
+  
+-   制約の依存 End。  \(プリンシパル End のエンティティ キーを参照するプロパティを持つエンティティ型\)  
+  
+-   依存 End の参照プロパティ。  
+  
+ EDM の参照整合性制約の目的は、常に有効なアソシエーションが存在することを確認するためです。  詳細については、「[外部キーのプロパティ](../../../../docs/framework/data/adonet/foreign-key-property.md)」を参照してください。  
+  
+## 例  
+ 下のダイアグラムは、`PublishedBy` および `WrittenBy` という 2 つのアソシエーションの概念モデルを示しています。  `Book` エンティティ型には、`PublisherId` というプロパティがあります。`PublishedBy` アソシエーションに参照整合性制約を定義するときに、このプロパティは `Publisher` エンティティ型のエンティティ キーを参照します。  
+  
+ ![RefConstraintModel](../../../../docs/framework/data/adonet/media/refconstraintmodel.gif "RefConstraintModel")  
+  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) では、概念スキーマ定義言語 \([CSDL](../../../../docs/framework/data/adonet/ef/language-reference/csdl-specification.md)\) と呼ばれるドメイン固有言語 \(DSL\) を使用して概念モデルを定義します。  次の CSDL は、上の概念モデルに示された `PublishedBy` アソシエーションの参照整合性制約を定義しています。  
+  
+ [!code-xml[EDM_Example_Model#RefConstraint](../../../../samples/snippets/xml/VS_Snippets_Data/edm_example_model/xml/books4.edmx#refconstraint)]  
+  
+## 参照  
+ [Entity Data Model キーの概念](../../../../docs/framework/data/adonet/entity-data-model-key-concepts.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-and-modifying-data.md b/docs/framework/data/adonet/retrieving-and-modifying-data.md
new file mode 100644
index 00000000000..c1dc7b67676
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-and-modifying-data.md
@@ -0,0 +1,73 @@
+---
+title: "ADO.NET でのデータの取得および変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 722e7f87-3691-46c6-87e8-7d159722d675
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# ADO.NET でのデータの取得および変更
+データベース アプリケーションの主な機能は、データ ソースとの接続およびデータベースに格納されているデータの取得です。  ADO.NET の .NET Framework データ プロバイダーは、アプリケーションとデータ ソース間の橋渡し役として機能し、**DataReader** または **DataAdapter** を使用してコマンドを実行したり、データを取得できるようにします。  データベースに格納されているデータを更新する機能は、データベース アプリケーションの重要な機能の 1 つです。  ADO.NET でデータを更新するには、**DataAdapter** と <xref:System.Data.DataSet>、および **Command** オブジェクトを使用する必要があります。また、トランザクションを使用する必要がある場合もあります。  
+  
+## このセクションの内容  
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)  
+ データ ソースへの接続を確立する方法、および接続イベントを使用する方法について説明します。  
+  
+ [接続文字列](../../../../docs/framework/data/adonet/connection-strings.md)  
+ 接続文字列のキーワード、セキュリティ情報、セキュリティ情報の格納や取得など、接続文字列を使用するうえでのさまざまな側面について説明します。  
+  
+ [接続プール](../../../../docs/framework/data/adonet/connection-pooling.md)  
+ .NET Framework Data Provider の接続プールについて説明します。  
+  
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)  
+ コマンドおよびコマンド ビルダーを作成する方法、パラメーターを構成する方法、およびコマンドを実行してデータを取得および変更する方法について説明します。  
+  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)  
+ DataReaders、DataAdapters、パラメーター、DataAdapter イベントの処理、およびバッチ操作の実行について説明します。  
+  
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)  
+ ローカル トランザクションや分散トランザクションの実行方法、およびオプティミスティック同時実行の使用方法について説明します。  
+  
+ [ID 値および Autonumber 値の取得](../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] テーブルの **identity** 列または、Microsoft Access テーブルの **Autonumber** フィールド用に生成された値を、テーブルの挿入行の列に割り当てる例を示します。  `DataTable` での ID 値の結合について説明します。  
+  
+ [バイナリ データの取得](../../../../docs/framework/data/adonet/retrieving-binary-data.md)  
+ `CommandBehavior`.`SequentialAccess` を使用するバイナリ データまたは大きなデータ構造を取得して、`DataReader` の既定の動作を変更する方法について説明します。  
+  
+ [ストアド プロシージャでのデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)  
+ ストアド プロシージャの入力パラメーターおよび出力パラメーターを使用してデータベースに行を挿入し、新しい ID 値を返す方法について説明します。  
+  
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)  
+ データベースまたはカタログ、データベース内のテーブルおよびビュー、テーブルに対して存在する制約、およびその他のスキーマ情報をデータ ソースから取得する方法について説明します。  
+  
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)  
+ プロバイダー ファクトリ モデルについて説明し、`System.Data.Common` 名前空間の基本クラスの使用方法を示します。  
+  
+ [ADO.NET でのデータ トレース](../../../../docs/framework/data/adonet/data-tracing.md)  
+ ADO.NET が備える組み込みデータ トレース機能のしくみについて説明します。  
+  
+ [ADO.NET でのパフォーマンス カウンター](../../../../docs/framework/data/adonet/performance-counters.md)  
+ `SqlClient` および `OracleClient` で使用できるパフォーマンス カウンターについて説明します。  
+  
+ [非同期プログラミング](../../../../docs/framework/data/adonet/asynchronous-programming.md)  
+ 非同期プログラミングに対する [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] サポートについて説明します。  
+  
+ [SqlClient ストリーミング サポート](../../../../docs/framework/data/adonet/sqlclient-streaming-support.md)  
+ 完全にメモリに読み込むことなく [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からデータをストリームするアプリケーションの作成方法について説明します。  
+  
+## 参照  
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server と ADO.NET](../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-binary-data.md b/docs/framework/data/adonet/retrieving-binary-data.md
new file mode 100644
index 00000000000..b53e2949753
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-binary-data.md
@@ -0,0 +1,164 @@
+---
+title: "バイナリ データの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56c5a9e3-31f1-482f-bce0-ff1c41a658d0
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# バイナリ データの取得
+既定では、**DataReader** は、行全体のデータが使用可能になると受信するデータを行として読み込みます。  バイナリ ラージ オブジェクト \(BLOB\) には、1 行に収まらない数ギガバイトのデータが含まれる場合があるため、別の処理が必要です。  **Command.ExecuteReader** メソッドは、<xref:System.Data.CommandBehavior> 引数を受け取って **DataReader** の既定の動作を変更するようにオーバーロードされています。  **ExecuteReader** メソッドに <xref:System.Data.CommandBehavior> を渡すと、数行のデータを読み込む代わりに、データを受け取った時点で順次読み込むように **DataReader** の既定の動作を変更できます。  これは BLOB やその他の大きなデータ構造を読み込む場合に理想的な処理です。  この動作は、データ ソースによって異なる場合があります。  たとえば、Microsoft Access から BLOB を返すと、受け取ったデータから順に読み込むのではなく、BLOB 全体をメモリに読み込みます。  
+  
+ **SequentialAccess** を使用するように **DataReader** を設定するときは、返されたフィールドにアクセスする順序に注意してください。  使用可能になるとすぐに行全体を読み込む **DataReader** の既定の動作では、次の行を読み取るまでは返されたフィールドに任意の順序でアクセスできます。  しかし、**SequentialAccess** を使用しているときは、**DataReader** によって返された各フィールドに順番にアクセスする必要があります。  たとえば、クエリが 3 つの列 \(3 番目の列は BLOB\) を返す場合、最初のフィールドおよび 2 番目のフィールドの値は、3 番目のフィールドの BLOB データにアクセスする前に返す必要があります。  最初のフィールドまたは 2 番目のフィールドの前に 3 番目のフィールドにアクセスした場合は、最初のフィールドと 2 番目のフィールドの値は使用できなくなります。  これは、**SequentialAccess** が **DataReader** をデータを順番に返すように変更し、**DataReader** がデータを飛ばして読み込んだ後はそのデータを使用できなくなるためです。  
+  
+ BLOB フィールドのデータにアクセスするときは、**DataReader** の **GetBytes** 型または **GetChars** 型のアクセサーを使用します。このアクセサーはデータを配列に読み込みます。  文字データ用の **GetString** を使用することもできますが、  システム リソースを節約するためには、BLOB 値全体を 1 つの文字列変数に読み込むことは望ましくありません。  特定のバッファー サイズのデータを返すように指定する代わりに、返されたデータから読み込む先頭バイトまたは先頭文字の開始位置を指定できます。  **GetBytes** と **GetChars** は、返されたバイト数または文字数を表す `long` 値を返します。  **GetBytes** または **GetChars** に null 配列を渡した場合、返される long 値は BLOB の総バイト数または総文字数になります。  オプションで、データ読み込みの開始位置を示す、配列内のインデックスを指定できます。  
+  
+## 例  
+ 次の例は、Microsoft SQL Server の **pubs** サンプル データベースから発行者 ID およびロゴを取得します。  発行者 ID \(`pub_id`\) は文字フィールドであり、ロゴはイメージ、つまり、BLOB です。  **logo** フィールドはビットマップなので、この例は、**GetBytes** を使用してバイナリ データを返します。  フィールドには順番にアクセスする必要があるため、現在の行のデータに対して発行者 ID はロゴの前にアクセスされることに注意してください。  
+  
+```vb  
+' Assumes that connection is a valid SqlConnection object.  
+Dim command As SqlCommand = New SqlCommand( _  
+  "SELECT pub_id, logo FROM pub_info", connection)  
+  
+' Writes the BLOB to a file (*.bmp).  
+Dim stream As FileStream                   
+' Streams the binary data to the FileStream object.  
+Dim writer As BinaryWriter                 
+' The size of the BLOB buffer.  
+Dim bufferSize As Integer = 100        
+' The BLOB byte() buffer to be filled by GetBytes.  
+Dim outByte(bufferSize - 1) As Byte    
+' The bytes returned from GetBytes.  
+Dim retval As Long                     
+' The starting position in the BLOB output.  
+Dim startIndex As Long = 0             
+  
+' The publisher id to use in the file name.  
+Dim pubID As String = ""              
+  
+' Open the connection and read data into the DataReader.  
+connection.Open()  
+Dim reader As SqlDataReader = command.ExecuteReader(CommandBehavior.SequentialAccess)  
+  
+Do While reader.Read()  
+  ' Get the publisher id, which must occur before getting the logo.  
+  pubID = reader.GetString(0)  
+  
+  ' Create a file to hold the output.  
+  stream = New FileStream( _  
+    "logo" & pubID & ".bmp", FileMode.OpenOrCreate, FileAccess.Write)  
+  writer = New BinaryWriter(stream)  
+  
+  ' Reset the starting byte for a new BLOB.  
+  startIndex = 0  
+  
+  ' Read bytes into outByte() and retain the number of bytes returned.  
+  retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize)  
+  
+  ' Continue while there are bytes beyond the size of the buffer.  
+  Do While retval = bufferSize  
+    writer.Write(outByte)  
+    writer.Flush()  
+  
+    ' Reposition start index to end of the last buffer and fill buffer.  
+    startIndex += bufferSize  
+    retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize)  
+  Loop  
+  
+  ' Write the remaining buffer.  
+  writer.Write(outByte, 0 , retval - 1)  
+  writer.Flush()  
+  
+  ' Close the output file.  
+  writer.Close()  
+  stream.Close()  
+Loop  
+  
+' Close the reader and the connection.  
+reader.Close()  
+connection.Close()  
+  
+```  
+  
+```csharp  
+// Assumes that connection is a valid SqlConnection object.  
+SqlCommand command = new SqlCommand(  
+  "SELECT pub_id, logo FROM pub_info", connection);  
+  
+// Writes the BLOB to a file (*.bmp).  
+FileStream stream;                            
+// Streams the BLOB to the FileStream object.  
+BinaryWriter writer;                          
+  
+// Size of the BLOB buffer.  
+int bufferSize = 100;                     
+// The BLOB byte[] buffer to be filled by GetBytes.  
+byte[] outByte = new byte[bufferSize];    
+// The bytes returned from GetBytes.  
+long retval;                              
+// The starting position in the BLOB output.  
+long startIndex = 0;                      
+  
+// The publisher id to use in the file name.  
+string pubID = "";                       
+  
+// Open the connection and read data into the DataReader.  
+connection.Open();  
+SqlDataReader reader = command.ExecuteReader(CommandBehavior.SequentialAccess);  
+  
+while (reader.Read())  
+{  
+  // Get the publisher id, which must occur before getting the logo.  
+  pubID = reader.GetString(0);    
+  
+  // Create a file to hold the output.  
+  stream = new FileStream(  
+    "logo" + pubID + ".bmp", FileMode.OpenOrCreate, FileAccess.Write);  
+  writer = new BinaryWriter(stream);  
+  
+  // Reset the starting byte for the new BLOB.  
+  startIndex = 0;  
+  
+  // Read bytes into outByte[] and retain the number of bytes returned.  
+  retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize);  
+  
+  // Continue while there are bytes beyond the size of the buffer.  
+  while (retval == bufferSize)  
+  {  
+    writer.Write(outByte);  
+    writer.Flush();  
+  
+    // Reposition start index to end of last buffer and fill buffer.  
+    startIndex += bufferSize;  
+    retval = reader.GetBytes(1, startIndex, outByte, 0, bufferSize);  
+  }  
+  
+  // Write the remaining buffer.  
+  writer.Write(outByte, 0, (int)retval - 1);  
+  writer.Flush();  
+  
+  // Close the output file.  
+  writer.Close();  
+  stream.Close();  
+}  
+  
+// Close the reader and the connection.  
+reader.Close();  
+connection.Close();  
+```  
+  
+## 参照  
+ [Working with DataReaders](http://msdn.microsoft.com/ja-jp/126a966a-d08d-4d22-a19f-f432908b2b54)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-data-from-multiple-ref-cursors.md b/docs/framework/data/adonet/retrieving-data-from-multiple-ref-cursors.md
new file mode 100644
index 00000000000..194a5556bd8
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-data-from-multiple-ref-cursors.md
@@ -0,0 +1,60 @@
+---
+title: "OracleDataReader を使用した複数の REF CURSOR からのデータの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 361e9bd4-447d-44b7-8629-3c11f1a7ffbb
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# OracleDataReader を使用した複数の REF CURSOR からのデータの取得
+この Microsoft Visual Basic の例では、2 つの REF CURSOR パラメーターを返し、<xref:System.Data.OracleClient.OracleDataReader> を使用して値を読み取る PL\/SQL ストアド プロシージャを実行します。  
+  
+```vb  
+Private Sub Button1_Click( _  
+  ByVal sender As Object, ByVal e As System.EventArgs)  _  
+  Handles Button1.Click  
+  
+  Dim connString As New String( _  
+      "Data Source=Oracle9i;User ID=scott;Password=tiger;")  
+  Using conn As New OracleConnection(connString)  
+    Dim cmd As New OracleCommand()  
+    Dim rdr As OracleDataReader  
+  
+    conn.Open()  
+    cmd.Connection = conn  
+    cmd.CommandText = "CURSPKG.OPEN_TWO_CURSORS"  
+    cmd.CommandType = CommandType.StoredProcedure  
+    cmd.Parameters.Add(New OracleParameter( _  
+      "EMPCURSOR", OracleType.Cursor)).Direction = _  
+      ParameterDirection.Output  
+    cmd.Parameters.Add(New OracleParameter(_  
+      "DEPTCURSOR", OracleType.Cursor)).Direction = _  
+      ParameterDirection.Output  
+  
+    rdr = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+    While (rdr.Read())  
+        REM do something with the values from the EMP table   
+    End While  
+  
+    rdr.NextResult()  
+    While (rdr.Read())  
+        REM do something with the values from the DEPT table   
+    End While  
+    rdr.Close()  
+  End Using  
+End Sub   
+```  
+  
+## 参照  
+ [Oracle REF CURSOR](../../../../docs/framework/data/adonet/oracle-ref-cursors.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-data-using-a-datareader.md b/docs/framework/data/adonet/retrieving-data-using-a-datareader.md
new file mode 100644
index 00000000000..61646897859
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-data-using-a-datareader.md
@@ -0,0 +1,260 @@
+---
+title: "DataReader によるデータの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97afc121-fb8b-465b-bab3-6d844420badb
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# DataReader によるデータの取得
+**DataReader** を使用してデータを取得するには、データ ソースから行を取得するために **Command.ExecuteReader** を呼び出して、**Command** オブジェクトのインスタンスを作成し、次に **DataReader** を作成する必要があります。  **DataReader** を使用する例を次に示します。ここで、`reader` は有効な DataReader を、`command` は有効な Command オブジェクトを表します。  
+  
+```  
+reader = command.ExecuteReader();  
+```  
+  
+ クエリの結果から行を取得するには、**DataReader** オブジェクトの **Read** メソッドを使用します。  返された行の各列にアクセスするには、その列の名前または序数参照を **DataReader** に渡します。  一方で **DataReader** は、最適のパフォーマンスが得られるように、ネイティブのデータ型を使用して列の値にアクセスするための一連のメソッド \(**GetDateTime**、**GetDouble**、**GetGuid**、**GetInt32** など\) も提供します。  データ プロバイダー固有の **DataReaders** の型指定されたアクセサー メソッドの一覧については、「<xref:System.Data.OleDb.OleDbDataReader>」および「<xref:System.Data.SqlClient.SqlDataReader>」を参照してください。  基になるデータ型がわかっている場合、型指定されたアクセサー メソッドを使用すると、列の値を取得するときに必要な型変換の量が少なくなります。  
+  
+> [!NOTE]
+>  .NET Framework の Windows Server 2003 リリースには、**DataReader** の追加のプロパティである、**HasRows** が含まれているため、これを使用すると、読み取る前に **DataReader** が結果を返したかどうかを確認できます。  
+  
+ 次に、**DataReader** オブジェクトを反復処理して各行から 2 つの列を返すコード サンプルを示します。  
+  
+ [!code-csharp[DataWorks SqlClient.HasRows#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.HasRows/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.HasRows#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.HasRows/VB/source.vb#1)]  
+  
+ **DataReader** はバッファリングされないデータ ストリームを提供して、手続きロジックがデータ ソースからの結果を順番に効率的に処理できるようにします。  **DataReader** はデータをメモリにキャッシュしないため、大量のデータを取得する場合に適しています。  
+  
+## DataReader の終了  
+ **DataReader** を使い終えたら、**Close** メソッドを呼び出す必要があります。  
+  
+ **Command** に出力パラメーターや戻り値が含まれていても、**DataReader** が終了するまでは使用できません。  
+  
+ **DataReader** が開いている間、**Connection** はその **DataReader** によって排他的に使用されています。  元の **DataReader** が終了するまでは、その **Connection** に対してはどのコマンドも実行できません。別の **DataReader** を作成することもできません。  
+  
+> [!NOTE]
+>  クラスの **Finalize** メソッド内で **Connection**、**DataReader**、またはその他のマネージ オブジェクトの **Close** または **Dispose** を呼び出さないでください。  終了処理では、クラスに直接所有されているアンマネージ リソースだけを解放してください。  クラスがアンマネージ リソースを所有していない場合は、クラス定義に **Finalize** メソッドを含めないでください。  詳細については、「[Garbage Collection](../../../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+## NextResult による複数の結果セットの取得  
+ 複数の結果セットが返された場合は、**DataReader** は **NextResult** メソッドを提供してその結果セットを順に反復処理します。  <xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> メソッドを使用して、2 つの SELECT ステートメントの結果を処理する <xref:System.Data.SqlClient.SqlDataReader> の例を次に示します。  
+  
+ [!code-csharp[DataWorks SqlClient.NextResult#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.NextResult/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.NextResult#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.NextResult/VB/source.vb#1)]  
+  
+## DataReader からのスキーマ情報の取得  
+ **DataReader** が開いている間に **GetSchemaTable** メソッドを使用して、現在の結果セットについてのスキーマ情報を取得できます。  **GetSchemaTable** は、現在の結果セットのスキーマ情報を含む行と列が設定されている <xref:System.Data.DataTable> オブジェクトを返します。  **DataTable** には結果セットの列ごとに 1 行が設定されます。  スキーマ テーブル行の各列が、結果セットで返される列の 1 つのプロパティに割り当てられます。**ColumnName** はそのプロパティの名前であり、列の値はプロパティの値です。  **DataReader** のスキーマ情報を出力するコード サンプルを次に示します。  
+  
+ [!code-csharp[DataWorks SqlClient.GetSchemaTable#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.GetSchemaTable/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.GetSchemaTable#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.GetSchemaTable/VB/source.vb#1)]  
+  
+## OLE DB のチャプターの使用  
+ 階層構造の行セット、つまりチャプター \(OLE DB では **DBTYPE\_HCHAPTER** 型、ADO では **adChapter** 型\) は <xref:System.Data.OleDb.OleDbDataReader> を使用して取得できます。  チャプターを含むクエリが **DataReader** として返されるとき、チャプターはその **DataReader** の列として返され、**DataReader** オブジェクトとして公開されます。  
+  
+ ADO.NET の **DataSet** を使用することで、テーブル間の親子のリレーションシップを使用して階層構造の行セットを表現することもできます。  詳細については、「[DataSets、DataTables、および DataViews](../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)」を参照してください。  
+  
+ MSDataShape プロバイダーを使用して、顧客リストの顧客別オーダーのチャプター列を生成するコード サンプルを次に示します。  
+  
+```vb  
+Using connection As OleDbConnection = New OleDbConnection( _  
+  "Provider=MSDataShape;Data Provider=SQLOLEDB;" & _  
+  "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=northwind")  
+  
+Dim custCMD As OleDbCommand = New OleDbCommand( _  
+  "SHAPE {SELECT CustomerID, CompanyName FROM Customers} " & _  
+  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS CustomerOrders " & _  
+  "RELATE CustomerID TO CustomerID)", connection)  
+connection.Open()  
+  
+Dim custReader As OleDbDataReader = custCMD.ExecuteReader()  
+Dim orderReader As OleDbDataReader  
+  
+Do While custReader.Read()  
+  Console.WriteLine("Orders for " & custReader.GetString(1))   
+  ' custReader.GetString(1) = CompanyName  
+  
+  orderReader = custReader.GetValue(2)  
+  ' custReader.GetValue(2) = Orders chapter as DataReader  
+  
+  Do While orderReader.Read()  
+    Console.WriteLine(vbTab & orderReader.GetInt32(1))  
+    ' orderReader.GetInt32(1) = OrderID  
+  Loop  
+  orderReader.Close()  
+Loop  
+' Make sure to always close readers and connections.  
+custReader.Close()  
+End Using  
+```  
+  
+```csharp  
+Using (OleDbConnection connection = new OleDbConnection(  
+  "Provider=MSDataShape;Data Provider=SQLOLEDB;" +  
+  "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=northwind"));  
+{  
+OleDbCommand custCMD = new OleDbCommand(  
+  "SHAPE {SELECT CustomerID, CompanyName FROM Customers} " +  
+  "APPEND ({SELECT CustomerID, OrderID FROM Orders} AS CustomerOrders " +  
+  "RELATE CustomerID TO CustomerID)", connection);  
+connection.Open();  
+  
+OleDbDataReader custReader = custCMD.ExecuteReader();  
+OleDbDataReader orderReader;  
+  
+while (custReader.Read())  
+{  
+  Console.WriteLine("Orders for " + custReader.GetString(1));   
+  // custReader.GetString(1) = CompanyName  
+  
+  orderReader = (OleDbDataReader)custReader.GetValue(2);        
+  // custReader.GetValue(2) = Orders chapter as DataReader  
+  
+  while (orderReader.Read())  
+    Console.WriteLine("\t" + orderReader.GetInt32(1));          
+    // orderReader.GetInt32(1) = OrderID  
+  orderReader.Close();  
+}  
+// Make sure to always close readers and connections.  
+custReader.Close();  
+}  
+```  
+  
+## Oracle REF CURSOR による結果の取得  
+ .NET Framework Data Provider for Oracle は、クエリ結果を返すために、Oracle REF CURSOR の使用をサポートしています。  Oracle REF CURSOR は <xref:System.Data.OracleClient.OracleDataReader> として返されます。  
+  
+ Oracle REF CURSOR を表す **OracleDataReader** オブジェクトは、<xref:System.Data.OracleClient.OracleCommand.ExecuteReader%2A> メソッドで取得できます。また、<xref:System.Data.DataSet> にデータを格納するために使用する <xref:System.Data.OracleClient.OracleDataAdapter> の **SelectCommand** として、1 つ以上の Oracle REF CURSOR を返す <xref:System.Data.OracleClient.OracleCommand> を指定することもできます。  
+  
+ Oracle データ ソースから返された REF CURSOR にアクセスするには、クエリ用の **OracleCommand** を作成し、その **Parameters** コレクションに、REF CURSOR を参照する出力パラメーターを追加します。  パラメーターの名前は、クエリの REF CURSOR パラメーターの名前と一致させる必要があります。  パラメーターの型を **OracleType.Cursor** に設定します。  **OracleCommand** の **ExecuteReader** メソッドは REF CURSOR に対する **OracleDataReader** を返します。  
+  
+ **OracleCommand** が複数の REF CURSOR を返す場合は、複数の出力パラメーターを追加してください。  **OracleCommand.ExecuteReader** メソッドを呼び出して、それぞれの REF CURSOR にアクセスできます。  **ExecuteReader** を呼び出すと、最初の REF CURSOR を参照する **OracleDataReader** が返されます。  次に **OracleDataReader.NextResult** メソッドを呼び出すと、後続の REF CURSOR にアクセスできます。  **OracleCommand.Parameters** コレクションのパラメーターが REF CURSOR 出力パラメーターと名前が一致していても、**OracleDataReader** は、**Parameters** コレクションに追加された順に出力パラメーターにアクセスします。  
+  
+ たとえば、次のような Oracle パッケージとパッケージ本体があるとします。  
+  
+```  
+CREATE OR REPLACE PACKAGE CURSPKG AS   
+  TYPE T_CURSOR IS REF CURSOR;   
+  PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
+    DEPTCURSOR OUT T_CURSOR);   
+END CURSPKG;  
+  
+CREATE OR REPLACE PACKAGE BODY CURSPKG AS   
+  PROCEDURE OPEN_TWO_CURSORS (EMPCURSOR OUT T_CURSOR,   
+    DEPTCURSOR OUT T_CURSOR)   
+  IS   
+  BEGIN   
+    OPEN EMPCURSOR FOR SELECT * FROM DEMO.EMPLOYEE;   
+    OPEN DEPTCURSOR FOR SELECT * FROM DEMO.DEPARTMENT;   
+  END OPEN_TWO_CURSORS;   
+END CURSPKG;   
+```  
+  
+ **OracleType.Cursor** 型の 2 つのパラメーターを **Parameters** コレクションに追加して、上の Oracle パッケージから REF CURSOR を返す **OracleCommand** を作成するコードを次に示します。  
+  
+```vb  
+Dim cursCmd As OracleCommand = New OracleCommand("CURSPKG.OPEN_TWO_CURSORS", oraConn)  
+cursCmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output  
+cursCmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output  
+```  
+  
+```csharp  
+OracleCommand cursCmd = new OracleCommand("CURSPKG.OPEN_TWO_CURSORS", oraConn);  
+cursCmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output;  
+cursCmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output;  
+```  
+  
+ **OracleDataReader** の **Read** メソッドと **NextResult** メソッドを使用して、上のコマンドの結果を返すコードを次に示します。  REF CURSOR パラメーターは順番に返されます。  
+  
+```vb  
+oraConn.Open()  
+  
+Dim cursCmd As OracleCommand = New OracleCommand("CURSPKG.OPEN_TWO_CURSORS", oraConn)  
+cursCmd.CommandType = CommandType.StoredProcedure  
+cursCmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output  
+cursCmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output  
+  
+Dim reader As OracleDataReader = cursCmd.ExecuteReader()  
+  
+Console.WriteLine(vbCrLf & "Emp ID" & vbTab & "Name")  
+  
+Do While reader.Read()  
+  Console.WriteLine("{0}" & vbTab & "{1}, {2}", reader.GetOracleNumber(0), reader.GetString(1), reader.GetString(2))  
+Loop  
+  
+reader.NextResult()  
+  
+Console.WriteLine(vbCrLf & "Dept ID" & vbTab & "Name")  
+  
+Do While reader.Read()  
+  Console.WriteLine("{0}" & vbTab & "{1}", reader.GetOracleNumber(0), reader.GetString(1))  
+Loop  
+' Make sure to always close readers and connections.  
+reader.Close()  
+oraConn.Close()  
+```  
+  
+```csharp  
+oraConn.Open();  
+  
+OracleCommand cursCmd = new OracleCommand("CURSPKG.OPEN_TWO_CURSORS", oraConn);  
+cursCmd.CommandType = CommandType.StoredProcedure;  
+cursCmd.Parameters.Add("EMPCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output;  
+cursCmd.Parameters.Add("DEPTCURSOR", OracleType.Cursor).Direction = ParameterDirection.Output;  
+  
+OracleDataReader reader = cursCmd.ExecuteReader();  
+  
+Console.WriteLine("\nEmp ID\tName");  
+  
+while (reader.Read())  
+  Console.WriteLine("{0}\t{1}, {2}", reader.GetOracleNumber(0), reader.GetString(1), reader.GetString(2));  
+  
+reader.NextResult();  
+  
+Console.WriteLine("\nDept ID\tName");  
+  
+while (reader.Read())  
+  Console.WriteLine("{0}\t{1}", reader.GetOracleNumber(0), reader.GetString(1));  
+// Make sure to always close readers and connections.  
+reader.Close();  
+oraConn.Close();  
+```  
+  
+ 上のコマンドを使用して、Oracle パッケージの結果を **DataSet** に設定する例を次に示します。  
+  
+> [!NOTE]
+>  **OverflowException** が発生しないようにするために、**DataRow** に値を格納する前に Oracle の NUMBER 型から有効な .NET Framework のデータ型への変換も行うことをお勧めします。  **FillError** イベントを使用して、**OverflowException** が発生したかどうかを確認できます。  **FillError** イベントの詳細については、「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。  
+  
+```vb  
+Dim ds As DataSet = New DataSet()  
+  
+Dim adapter As OracleDataAdapter = New OracleDataAdapter(cursCmd)  
+adapter.TableMappings.Add("Table", "Employees")  
+adapter.TableMappings.Add("Table1", "Departments")  
+  
+adapter.Fill(ds)  
+```  
+  
+```csharp  
+DataSet ds = new DataSet();  
+  
+OracleDataAdapter adapter = new OracleDataAdapter(cursCmd);  
+adapter.TableMappings.Add("Table", "Employees");  
+adapter.TableMappings.Add("Table1", "Departments");  
+  
+adapter.Fill(ds);  
+```  
+  
+## 参照  
+ [Working with DataReaders](http://msdn.microsoft.com/ja-jp/126a966a-d08d-4d22-a19f-f432908b2b54)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-database-schema-information.md b/docs/framework/data/adonet/retrieving-database-schema-information.md
new file mode 100644
index 00000000000..14169001c3e
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-database-schema-information.md
@@ -0,0 +1,83 @@
+---
+title: "データベース スキーマ情報の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79038d52-f122-4fd4-9bfb-aaa22d6a114b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# データベース スキーマ情報の取得
+データベースからのスキーマ情報の取得は、スキーマの検出プロセスによって行われます。  スキーマの検出により、アプリケーションでは、指定されたデータベースのデータベース スキーマに関する情報を検索して返すように、マネージ プロバイダーに要求できます。データベース スキーマは*メタデータ*としても知られます。  テーブル、列、ストアド プロシージャなどの各種のデータベース スキーマ要素は、スキーマ コレクションを通じて公開されます。  各スキーマ コレクションには、使用されているプロバイダーに固有の各種のスキーマ情報が含まれています。  
+  
+ それぞれの .NET Framework マネージ プロバイダーは、**Connection** クラスに **GetSchema** メソッドを実装します。また、**GetSchema** メソッドから返されるスキーマ情報は、<xref:System.Data.DataTable> という形式になります。  **GetSchema** メソッドは、返すスキーマ コレクションを指定し、返される情報の量を制限するためのオプション パラメーターを提供する、オーバーロードされたメソッドです。  
+  
+ .NET Framework Data Providers for OLE DB、.NET Framework Data Providers for ODBC、.NET Framework Data Providers for Oracle、および .NET Framework Data Providers for SqlClient は、**DataReader** の列のメタデータを表す DataTable を返す **GetSchemaTable** メソッドを提供します。  
+  
+ .NET Framework Data Provider for OLE DB では、<xref:System.Data.OleDb.OleDbConnection> オブジェクトの <xref:System.Data.OleDb.OleDbConnection.GetOleDbSchemaTable%2A> メソッドを使ってスキーマ情報を公開します。  **GetOleDbSchemaTable** は、引数として、返すスキーマ情報を識別する <xref:System.Data.OleDb.OleDbSchemaGuid> と、返された列に対する制限の配列を受け取ります。  **GetOleDbSchemaTable** は、要求されたスキーマ情報を格納している <xref:System.Data.DataTable> を返します。  
+  
+## このセクションの内容  
+ [GetSchema およびスキーマ コレクション](../../../../docs/framework/data/adonet/getschema-and-schema-collections.md)  
+ **GetSchema** メソッドと、このメソッドを使ってデータベースからスキーマ情報を取得して制限する方法について説明します。  
+  
+ スキーマの制限  
+ **GetSchema** で使用できるスキーマの制限について説明します。  
+  
+ [共通のスキーマ コレクション](../../../../docs/framework/data/adonet/common-schema-collections.md)  
+ すべての .NET Framework マネージ プロバイダーでサポートされる共通のスキーマ コレクションについて説明します。  
+  
+ [SQL Server スキーマ コレクション](../../../../docs/framework/data/adonet/sql-server-schema-collections.md)  
+ .NET Framework Provider for SQL Server でサポートされるスキーマ コレクションについて説明します。  
+  
+ [Oracle スキーマ コレクション](../../../../docs/framework/data/adonet/oracle-schema-collections.md)  
+ .NET Framework Provider for Oracle でサポートされるスキーマ コレクションについて説明します。  
+  
+ [ODBC スキーマ コレクション](../../../../docs/framework/data/adonet/odbc-schema-collections.md)  
+ ODBC ドライバーのスキーマ コレクションについて説明します。  
+  
+ [OLE DB スキーマ コレクション](../../../../docs/framework/data/adonet/ole-db-schema-collections.md)  
+ OLE DB プロバイダーのスキーマ コレクションについて説明します。  
+  
+## 関連項目  
+ <xref:System.Data.Common.DbConnection.GetSchema%2A>  
+ <xref:System.Data.Common.DbConnection> クラスの **GetSchema** メソッドについて説明します。  
+  
+ <xref:System.Data.Odbc.OdbcConnection.GetSchema%2A>  
+ <xref:System.Data.Odbc.OdbcConnection> クラスの **GetSchema** メソッドについて説明します。  
+  
+ <xref:System.Data.OleDb.OleDbConnection.GetSchema%2A>  
+ <xref:System.Data.OleDb.OleDbConnection> クラスの **GetSchema** メソッドについて説明します。  
+  
+ <xref:System.Data.OracleClient.OracleConnection.GetSchema%2A>  
+ <xref:System.Data.OracleClient.OracleConnection> クラスの **GetSchema** メソッドについて説明します。  
+  
+ <xref:System.Data.SqlClient.SqlConnection.GetSchema%2A>  
+ <xref:System.Data.SqlClient.SqlConnection> クラスの **GetSchema** メソッドについて説明します。  
+  
+ <xref:System.Data.Common.DbDataReader.GetSchemaTable%2A>  
+ <xref:System.Data.Common.DbDataReader> クラスの **GetSchemaTable** メソッドについて説明します。  
+  
+ <xref:System.Data.Odbc.OdbcDataReader.GetSchemaTable%2A>  
+ <xref:System.Data.Odbc.OdbcDataReader> クラスの **GetSchemaTable** メソッドについて説明します。  
+  
+ <xref:System.Data.OleDb.OleDbDataReader.GetSchemaTable%2A>  
+ <xref:System.Data.OleDb.OleDbDataReader> クラスの **GetSchemaTable** メソッドについて説明します。  
+  
+ <xref:System.Data.OracleClient.OracleDataReader.GetSchemaTable%2A>  
+ <xref:System.Data.OracleClient.OracleDataReader> クラスの **GetSchemaTable** メソッドについて説明します。  
+  
+ <xref:System.Data.SqlClient.SqlDataReader.GetSchemaTable%2A>  
+ <xref:System.Data.SqlClient.SqlDataReader> クラスの **GetSchemaTable** メソッドについて説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md b/docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md
new file mode 100644
index 00000000000..0d3edcfbaeb
--- /dev/null
+++ b/docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md
@@ -0,0 +1,543 @@
+---
+title: "ID 値および Autonumber 値の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6b7f9cb-81be-44e1-bb94-56137954876d
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# ID 値および Autonumber 値の取得
+リレーショナル データベースの主キーとは、常に一意の値を含んだ列または列の組み合わせをいいます。  主キー値がわかっていれば、それが格納されている行を特定できます。  SQL Server、Oracle、Microsoft Access\/Jet などのリレーショナル データベース エンジンは、主キーとして指定可能な自動インクリメント列の作成をサポートしています。  これらの値はテーブルに行を追加するとサーバーによって自動的に生成されます。  SQL Server では列の Identity プロパティを設定し、Oracle では Sequence を作成します。また、Microsoft Access では、AutoNumber 列を作成します。  
+  
+ <xref:System.Data.DataColumn> を使用し、<xref:System.Data.DataColumn.AutoIncrement%2A> プロパティを true に設定することで、インクリメント値を自動的に生成することもできます。  ただし、複数のクライアント アプリケーションがそれぞれ独立して自動インクリメント値を生成した場合、最終的に <xref:System.Data.DataTable> の別々のインスタンスに重複する値が存在することも考えられます。  サーバーで自動的にインクリメント値を生成すると、各ユーザーが、挿入された行ごとに生成された値を取得できるようになるため、競合を未然に防ぐことができます。  
+  
+ ADO.NET アプリケーションでは、`DataAdapter` の `Update` メソッドを呼び出している間、データベースから出力パラメーターとして、または \(INSERT ステートメントと同じバッチで実行した\) SELECT ステートメントの結果セットの最初に返されたレコードとして、データを取得できます。  これらの値を取得することで、更新対象となる <xref:System.Data.DataRow> 内の対応する列を更新できます。  
+  
+ Microsoft Access Jet データベース エンジンなど、一部のデータベース エンジンは、出力パラメーターをサポートしておらず、複数のステートメントを 1 回のバッチで処理することもできません。  Jet データベース エンジンを使用する場合は、`DataAdapter` の `RowUpdated` イベントのイベント ハンドラーで別途 SELECT コマンドを実行することによって、挿入行に対して生成された新しい AutoNumber 値を取得できます。  
+  
+> [!NOTE]
+>  自動インクリメント値を使用する代わりに、クライアント コンピューター側で <xref:System.Guid> オブジェクトの <xref:System.Guid.NewGuid%2A> メソッドを使用して GUID \(グローバルな一意識別子\) を生成し、新しい行が挿入されるたびにそれをサーバーにコピーする方法もあります。  `NewGuid` メソッドでは、値の重複を高い確率で防ぐアルゴリズムを使って 16 バイトのバイナリ値が生成されます。  SQL Server データベースでは、Transact\-SQL の `NEWID()` 関数を使って自動的に生成される GUID が、`uniqueidentifier` 列に格納されます。  GUID を主キーとして使用すると、パフォーマンスが低下する場合があります。  [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] では、シーケンシャルな GUID を生成する `NEWSEQUENTIALID()` 関数のサポートが新たに提供されています。グローバルな一意性は保証されませんが、より効率的なインデックス処理が可能となります。  
+  
+## SQL Server の ID 列値の取得  
+ Microsoft SQL Server を使用している場合は、出力パラメーターを持ったストアド プロシージャを作成して、挿入された行の ID 値を取得できます。  次の表は、SQL Server で ID 列値の取得に使用できる 3 つの Transact\-SQL 関数を示しています。  
+  
+|関数|説明|  
+|--------|--------|  
+|SCOPE\_IDENTITY|現在の実行スコープ内の最後の ID 値を返します。  通常は、SCOPE\_IDENTITY を使用することをお勧めします。|  
+|@@IDENTITY|現在のセッション内の任意のテーブルで生成された最後の ID 値を保持します。  @@IDENTITY はトリガーの影響を受けるため、期待した ID 値が返されない場合があります。|  
+|IDENT\_CURRENT|任意のセッションとスコープ内の特定のテーブルに対して生成された最後の ID 値を返します。|  
+  
+ 次のストアド プロシージャは、**Categories** テーブルに行を挿入し、Transact\-SQL の SCOPE\_IDENTITY\(\) 関数によって生成された新しい ID 値を出力パラメーターとして取得する方法を示しています。  
+  
+```  
+CREATE PROCEDURE dbo.InsertCategory  
+  @CategoryName nvarchar(15),  
+  @Identity int OUT  
+AS  
+INSERT INTO Categories (CategoryName) VALUES(@CategoryName)  
+SET @Identity = SCOPE_IDENTITY()  
+```  
+  
+ このストアド プロシージャは <xref:System.Data.SqlClient.SqlDataAdapter> オブジェクトの <xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> のソースとして指定できます。  <xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> の <xref:System.Data.SqlClient.SqlCommand.CommandType%2A> プロパティには、有効な <xref:System.Data.CommandType> を設定する必要があります。  ID の出力を取得するには、<xref:System.Data.ParameterDirection> を <xref:System.Data.ParameterDirection> に設定した <xref:System.Data.SqlClient.SqlParameter> を作成します。  挿入コマンドの <xref:System.Data.SqlClient.SqlCommand.UpdatedRowSource%2A> プロパティを `UpdateRowSource.OutputParameters` または `UpdateRowSource.Both` に設定した場合、`InsertCommand` が処理されると、自動的にインクリメントされた ID 値が返され、現在の行の **CategoryID** 列に設定されます。  
+  
+ 挿入コマンドで、INSERT ステートメントと \(新しい ID 値を返す\) SELECT ステートメントの両方を含むバッチを実行した場合、挿入コマンドの `UpdatedRowSource` プロパティを `UpdateRowSource.FirstReturnedRecord` に設定することによって新しい値を取得できます。  
+  
+ [!code-csharp[DataWorks SqlClient.RetrieveIdentityStoredProcedure#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.RetrieveIdentityStoredProcedure/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.RetrieveIdentityStoredProcedure#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.RetrieveIdentityStoredProcedure/VB/source.vb#1)]  
+  
+## 新しい ID 値の結合  
+ `DataTable` の `GetChanges` は、変更行だけを含んだコピーを作成するメソッドです。作成した新しいコピーは `DataAdapter` の `Update` メソッドの呼び出し時に使用できます。  この方法を用いると、変更された行を別のコンポーネントにマーシャリングして更新を実行できます。  更新後、このコピーには、元の `DataTable` に再び結合する必要のある新しい ID 値が格納されている可能性もあります。  新しい ID 値は、おそらく `DataTable` 内の元の値とは異なります。  結合を実行するには、新しい ID 値を含んだ新しい行を追加するのではなく、コピー内の **AutoIncrement** 列の元の値を保持しておき、元の `DataTable` から既存の行を特定して更新する必要があります。  しかし、既定では、`DataAdapter` の `Update` メソッドを呼び出した後、元の値は失われてしまいます。更新された `DataRow` ごとに `AcceptChanges` が暗黙的に呼び出されるためです。  
+  
+ `DataAdapter` の更新処理中、`DataRow` の `DataColumn` に格納されていた元の値を保持するには、次の 2 とおりの方法があります。  
+  
+-   元の値を保持する 1 つ目の方法は、`DataAdapter` の `AcceptChangesDuringUpdate` プロパティを `false` に設定することです。  この設定は、更新対象となる `DataTable` のすべての `DataRow` に影響します。  コード例および詳細については、「<xref:System.Data.Common.DataAdapter.AcceptChangesDuringUpdate%2A>」を参照してください。  
+  
+-   2 つ目は、`DataAdapter` の `RowUpdated` イベント ハンドラーに、<xref:System.Data.Common.RowUpdatedEventArgs.Status%2A> を <xref:System.Data.UpdateStatus> に設定するコードを記述する方法です。  `DataRow` が更新されても、各 `DataColumn` の元の値は保持されます。  この方法を使用した場合、一部の行についてのみ元の値を保持するといったことも可能です。  たとえば、最初に <xref:System.Data.Common.RowUpdatedEventArgs.StatementType%2A> を調べ、`StatementType` が `Insert` である行に限定して <xref:System.Data.Common.RowUpdatedEventArgs.Status%2A> を <xref:System.Data.UpdateStatus> に設定することで、追加された行については元の値を保持し、編集または削除された行については元の値を保持しないようなコードを作成できます。  
+  
+ `DataAdapter` の更新処理中、上記のいずれかの方法で `DataRow` の元の値を保持した場合、ADO.NET は、各 `DataColumn` の元の値を保持する一方で、`DataRow` の現在の値を新しい値 \(つまり、出力パラメーターまたは結果セットの先頭行として返された値\) に設定するための一連の処理を実行します。  最初に `DataRow` の `AcceptChanges` メソッドが呼び出され、現在の値が元の値として保持された後、新しい値が割り当てられます。  これらの処理に続けて、<xref:System.Data.DataRow.RowState%2A> プロパティが <xref:System.Data.DataRowState> に設定されていた `DataRows` については、`RowState` プロパティが <xref:System.Data.DataRowState> に設定されます。これはユーザーが想定していない可能性があります。  
+  
+ 更新対象の各 <xref:System.Data.DataRow> に対し、コマンドの結果がどのように適用されるかは、各 <xref:System.Data.Common.DbCommand> の <xref:System.Data.Common.DbCommand.UpdatedRowSource%2A> プロパティによって決まります。  このプロパティは、`UpdateRowSource` 列挙型のいずれかの値に設定されます。  
+  
+ 次の表では、`UpdateRowSource` 列挙型の各値が、更新対象の行の <xref:System.Data.DataRow.RowState%2A> プロパティにどのように影響するかを説明します。  
+  
+|メンバー名|説明|  
+|-----------|--------|  
+|<xref:System.Data.UpdateRowSource>|`AcceptChanges` が呼び出され、出力パラメーターの値と、返された結果セットの先頭行が、どちらも更新対象の `DataRow` に格納されます。  適用する値が存在しない場合、`RowState` は <xref:System.Data.DataRowState> になります。|  
+|<xref:System.Data.UpdateRowSource>|行が返された場合、`AcceptChanges` が呼び出され、その行が `DataTable` の変更行にマップされて、`RowState` が `Modified` に設定されます。  行が返されなかった場合、`AcceptChanges` は呼び出されず、`RowState` は `Added` のままになります。|  
+|<xref:System.Data.UpdateRowSource>|返されたパラメーターまたは行はすべて無視されます。  `AcceptChanges` は呼び出されず、`RowState` は `Added` のままになります。|  
+|<xref:System.Data.UpdateRowSource>|`AcceptChanges` が呼び出され、出力パラメーターがある場合は `DataTable` の変更行にマップされて、`RowState` が `Modified` に設定されます。  出力パラメーターがない場合は、`RowState` は `Unchanged` になります。|  
+  
+### 例  
+ 次の例では、`DataTable` から変更行を抽出し、<xref:System.Data.SqlClient.SqlDataAdapter> でデータ ソースを更新して、新しい ID 列値を取得します。  <xref:System.Data.SqlClient.SqlDataAdapter.InsertCommand%2A> は、2 つの Transact\-SQL ステートメントを実行します。1 つは INSERT ステートメントで、もう 1 つは、SCOPE\_IDENTITY 関数を使って ID 値を取得する SELECT ステートメントです。  
+  
+```  
+INSERT INTO dbo.Shippers (CompanyName)   
+VALUES (@CompanyName);  
+SELECT ShipperID, CompanyName FROM dbo.Shippers   
+WHERE ShipperID = SCOPE_IDENTITY();  
+```  
+  
+ 挿入コマンドの `UpdatedRowSource` プロパティは `UpdateRowSource.FirstReturnedRow` に、`DataAdapter` の <xref:System.Data.MissingSchemaAction> プロパティは `MissingSchemaAction.AddWithKey` に設定します。  `DataTable` にデータを格納した後、新しい行を `DataTable` に追加します。  次に、変更行を抽出して新しい `DataTable` に格納します。このデータ テーブルが `DataAdapter` に渡され、サーバー側が更新されます。  
+  
+ [!code-csharp[DataWorks SqlClient.MergeIdentity#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.MergeIdentity/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.MergeIdentity#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.MergeIdentity/VB/source.vb#1)]  
+  
+ `OnRowUpdated` イベント ハンドラーでは、<xref:System.Data.SqlClient.SqlRowUpdatedEventArgs> の <xref:System.Data.Common.RowUpdatedEventArgs.StatementType%2A> をチェックして、行が挿入であるかどうかを調べています。  挿入である場合は、<xref:System.Data.Common.RowUpdatedEventArgs.Status%2A> プロパティを <xref:System.Data.UpdateStatus> に設定します。  行は更新されますが、その行の元の値は保持されます。  プロシージャの本体では、<xref:System.Data.DataSet.Merge%2A> メソッドを呼び出すことによって、新しい ID 値を元の `DataTable` に結合し、最後に `AcceptChanges` を呼び出します。  
+  
+ [!code-csharp[DataWorks SqlClient.MergeIdentity#2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.MergeIdentity/CS/source.cs#2)]
+ [!code-vb[DataWorks SqlClient.MergeIdentity#2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.MergeIdentity/VB/source.vb#2)]  
+  
+## Microsoft Access の Autonumber 値の取得  
+ このセクションでは、Jet 4.0 データベースから `Autonumber` 値を取得する方法を例で示します。  Jet データベース エンジンは、複数のステートメントをバッチとして実行することも、出力パラメーターを使用することもできません。そのため、前述した方法では、挿入行に割り当てられた新しい `Autonumber` 値を取得することはできません。  しかし、`RowUpdated` イベント ハンドラーにコードを追加し、別途 SELECT @@IDENTITY ステートメントを実行することによって、新しい `Autonumber` 値を取得できます。  
+  
+### 例  
+ この例では、`MissingSchemaAction.AddWithKey` を使ってスキーマ情報を追加する代わりに、あらかじめ適切なスキーマで `DataTable` を構成した後、<xref:System.Data.OleDb.OleDbDataAdapter> を呼び出して `DataTable` にデータを格納しています。  **CategoryID** 列は、0 を開始番号とし、行が挿入されるたびに値が減少するように構成するため、<xref:System.Data.DataColumn.AutoIncrement%2A> を `true` に、<xref:System.Data.DataColumn.AutoIncrementSeed%2A> を 0 に、<xref:System.Data.DataColumn.AutoIncrementStep%2A> を \-1 に設定しています。  その後、2 つの新しい行を追加し、`GetChanges` を使って変更行を新しい `DataTable` に追加します。`Update` メソッドには、このデータ テーブルが渡されます。  
+  
+ [!code-csharp[DataWorks OleDb.JetAutonumberMerge#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks OleDb.JetAutonumberMerge/CS/source.cs#1)]
+ [!code-vb[DataWorks OleDb.JetAutonumberMerge#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks OleDb.JetAutonumberMerge/VB/source.vb#1)]  
+  
+ `RowUpdated` イベント ハンドラーでは、`OleDbDataAdapter` の `Update` ステートメントと同じ、開いている <xref:System.Data.OleDb.OleDbConnection> を使用します。  このハンドラーでは、挿入された行について、<xref:System.Data.OleDb.OleDbRowUpdatedEventArgs> の `StatementType` をチェックします。  挿入された行ごとに、新しい <xref:System.Data.OleDb.OleDbCommand> を作成して、接続上で SELECT @@IDENTITY ステートメントを実行し、新しい `Autonumber` 値を取得します。取得した値は、`DataRow` の **CategoryID** 列に格納されます。  次に、`AcceptChanges` の暗黙的な呼び出しを抑制するため、`Status` プロパティを `UpdateStatus.SkipCurrentRow` に設定しています。  プロシージャの本体では、`Merge` メソッドを呼び出すことによって、2 つの `DataTable` を結合し、最後に `AcceptChanges` を呼び出します。  
+  
+ [!code-csharp[DataWorks OleDb.JetAutonumberMerge#2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks OleDb.JetAutonumberMerge/CS/source.cs#2)]
+ [!code-vb[DataWorks OleDb.JetAutonumberMerge#2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks OleDb.JetAutonumberMerge/VB/source.vb#2)]  
+  
+### ID 値の取得  
+ 列内の値が一意である必要がある場合、列を ID として設定することがあります。  新しいデータの ID 値が必要となる場合があります。  次のサンプルは、ID 値を取得する方法を示しています。  
+  
+-   データを挿入して ID 値を返すストアド プロシージャを作成します。  
+  
+-   新しいデータを挿入して結果を表示するコマンドを実行します。  
+  
+-   <xref:System.Data.SqlClient.SqlDataAdapter> を使用し、新しいデータを挿入して結果を表示します。  
+  
+ サンプルをコンパイルして実行する前に、次のスクリプトを使用してサンプル データベースを作成する必要があります。  
+  
+```  
+USE [master]  
+GO  
+  
+CREATE DATABASE [MySchool]  
+GO  
+  
+USE [MySchool]  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE procedure [dbo].[CourseExtInfo] @CourseId int  
+as  
+select c.CourseID,c.Title,c.Credits,d.Name as DepartmentName  
+from Course as c left outer join Department as d on c.DepartmentID=d.DepartmentID  
+where c.CourseID=@CourseId  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+create procedure [dbo].[DepartmentInfo] @DepartmentId int,@CourseCount int output  
+as  
+select @CourseCount=Count(c.CourseID)  
+from course as c  
+where c.DepartmentID=@DepartmentId  
+  
+select d.DepartmentID,d.Name,d.Budget,d.StartDate,d.Administrator  
+from Department as d  
+where d.DepartmentID=@DepartmentId  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+Create PROCEDURE [dbo].[GetDepartmentsOfSpecifiedYear]   
+@Year int,@BudgetSum money output  
+AS  
+BEGIN  
+        SELECT @BudgetSum=SUM([Budget])  
+  FROM [MySchool].[dbo].[Department]  
+  Where YEAR([StartDate])=@Year   
+  
+SELECT [DepartmentID]  
+      ,[Name]  
+      ,[Budget]  
+      ,[StartDate]  
+      ,[Administrator]  
+  FROM [MySchool].[dbo].[Department]  
+  Where YEAR([StartDate])=@Year  
+  
+END  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE PROCEDURE [dbo].[GradeOfStudent]   
+-- Add the parameters for the stored procedure here  
+@CourseTitle nvarchar(100),@FirstName nvarchar(50),  
+@LastName nvarchar(50),@Grade decimal(3,2) output  
+AS  
+BEGIN  
+select @Grade=Max(Grade)  
+from [dbo].[StudentGrade] as s join [dbo].[Course] as c on   
+s.CourseID=c.CourseID join [dbo].[Person] as p on s.StudentID=p.PersonID  
+where c.Title=@CourseTitle and p.FirstName=@FirstName   
+and p.LastName= @LastName  
+END  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE PROCEDURE [dbo].[InsertPerson]   
+-- Add the parameters for the stored procedure here  
+@FirstName nvarchar(50),@LastName nvarchar(50),  
+@PersonID int output  
+AS  
+BEGIN  
+    insert [dbo].[Person](LastName,FirstName) Values(@LastName,@FirstName)  
+  
+    set @PersonID=SCOPE_IDENTITY()  
+END  
+Go  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE TABLE [dbo].[Course]([CourseID] [nvarchar](10) NOT NULL,  
+[Year] [smallint] NOT NULL,  
+[Title] [nvarchar](100) NOT NULL,  
+[Credits] [int] NOT NULL,  
+[DepartmentID] [int] NOT NULL,  
+ CONSTRAINT [PK_Course] PRIMARY KEY CLUSTERED   
+(  
+[CourseID] ASC,  
+[Year] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE TABLE [dbo].[Department]([DepartmentID] [int] IDENTITY(1,1) NOT NULL,  
+[Name] [nvarchar](50) NOT NULL,  
+[Budget] [money] NOT NULL,  
+[StartDate] [datetime] NOT NULL,  
+[Administrator] [int] NULL,  
+ CONSTRAINT [PK_Department] PRIMARY KEY CLUSTERED   
+(  
+[DepartmentID] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+SET ANSI_PADDING ON  
+GO  
+CREATE TABLE [dbo].[Person]([PersonID] [int] IDENTITY(1,1) NOT NULL,  
+[LastName] [nvarchar](50) NOT NULL,  
+[FirstName] [nvarchar](50) NOT NULL,  
+[HireDate] [datetime] NULL,  
+[EnrollmentDate] [datetime] NULL,  
+[Picture] [varbinary](max) NULL,  
+ CONSTRAINT [PK_School.Student] PRIMARY KEY CLUSTERED   
+(  
+[PersonID] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE TABLE [dbo].[StudentGrade]([EnrollmentID] [int] IDENTITY(1,1) NOT NULL,  
+[CourseID] [nvarchar](10) NOT NULL,  
+[StudentID] [int] NOT NULL,  
+[Grade] [decimal](3, 2) NOT NULL,  
+ CONSTRAINT [PK_StudentGrade] PRIMARY KEY CLUSTERED   
+(  
+[EnrollmentID] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+create view [dbo].[EnglishCourse]  
+as  
+select c.CourseID,c.Title,c.Credits,c.DepartmentID  
+from Course as c join Department as d on c.DepartmentID=d.DepartmentID  
+where d.Name=N'English'  
+  
+GO  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1045', 2012, N'Calculus', 4, 7)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1061', 2012, N'Physics', 4, 1)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2021', 2012, N'Composition', 3, 2)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2042', 2012, N'Literature', 4, 2)  
+SET IDENTITY_INSERT [dbo].[Department] ON   
+  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (1, N'Engineering', 350000.0000, CAST(0x0000999C00000000 AS DateTime), 2)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (2, N'English', 120000.0000, CAST(0x0000999C00000000 AS DateTime), 6)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (4, N'Economics', 200000.0000, CAST(0x0000999C00000000 AS DateTime), 4)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (7, N'Mathematics', 250024.0000, CAST(0x0000999C00000000 AS DateTime), 3)  
+SET IDENTITY_INSERT [dbo].[Department] OFF  
+SET IDENTITY_INSERT [dbo].[Person] ON   
+  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (1, N'Hu', N'Nan', NULL, CAST(0x0000A0BF00000000 AS DateTime))  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (2, N'Norman', N'Laura', NULL, CAST(0x0000A0BF00000000 AS DateTime))  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (3, N'Olivotto', N'Nino', NULL, CAST(0x0000A0BF00000000 AS DateTime))  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (4, N'Anand', N'Arturo', NULL, CAST(0x0000A0BF00000000 AS DateTime))  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (5, N'Jai', N'Damien', NULL, CAST(0x0000A0BF00000000 AS DateTime))  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (6, N'Holt', N'Roger', CAST(0x000097F100000000 AS DateTime), NULL)  
+INSERT [dbo].[Person] ([PersonID], [LastName], [FirstName], [HireDate], [EnrollmentDate]) VALUES (7, N'Martin', N'Randall', CAST(0x00008B1A00000000 AS DateTime), NULL)  
+SET IDENTITY_INSERT [dbo].[Person] OFF  
+SET IDENTITY_INSERT [dbo].[StudentGrade] ON   
+  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (1, N'C1045', 1, CAST(3.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (2, N'C1045', 2, CAST(3.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (3, N'C1045', 3, CAST(2.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (4, N'C1045', 4, CAST(4.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (5, N'C1045', 5, CAST(3.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (6, N'C1061', 1, CAST(4.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (7, N'C1061', 3, CAST(3.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (8, N'C1061', 4, CAST(2.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (9, N'C1061', 5, CAST(1.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (10, N'C2021', 1, CAST(2.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (11, N'C2021', 2, CAST(3.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (12, N'C2021', 4, CAST(3.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (13, N'C2021', 5, CAST(3.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (14, N'C2042', 1, CAST(2.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (15, N'C2042', 2, CAST(3.50 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (16, N'C2042', 3, CAST(4.00 AS Decimal(3, 2)))  
+INSERT [dbo].[StudentGrade] ([EnrollmentID], [CourseID], [StudentID], [Grade]) VALUES (17, N'C2042', 5, CAST(3.00 AS Decimal(3, 2)))  
+SET IDENTITY_INSERT [dbo].[StudentGrade] OFF  
+ALTER TABLE [dbo].[Course]  WITH CHECK ADD  CONSTRAINT [FK_Course_Department] FOREIGN KEY([DepartmentID])  
+REFERENCES [dbo].[Department] ([DepartmentID])  
+GO  
+ALTER TABLE [dbo].[Course] CHECK CONSTRAINT [FK_Course_Department]  
+GO  
+ALTER TABLE [dbo].[StudentGrade]  WITH CHECK ADD  CONSTRAINT [FK_StudentGrade_Student] FOREIGN KEY([StudentID])  
+REFERENCES [dbo].[Person] ([PersonID])  
+GO  
+ALTER TABLE [dbo].[StudentGrade] CHECK CONSTRAINT [FK_StudentGrade_Student]  
+GO  
+```  
+  
+ コード リストを次に示します。  
+  
+> [!IMPORTANT]
+>  このコード リストは、MySchool.mdb という名前の Access データベース ファイルを参照します。  MySchool.mdb \(完全な C\# または Visual Basic のサンプル プロジェクトとして\) は、[Visual Studio 2012 のサンプル](http://code.msdn.microsoft.com/How-to-retrieve-the-95b4ee43)または[Visual Studio 2013 のサンプル](http://code.msdn.microsoft.com/How-to-Retrieve-the-511acece)からダウンロードできます。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.OleDb;  
+using System.Data.SqlClient;  
+  
+class Program {  
+   static void Main(string[] args) {  
+      String SqlDbConnectionString = "Data Source=(local);Initial Catalog=MySchool;Integrated Security=True;Asynchronous Processing=true;";  
+  
+      InsertPerson(SqlDbConnectionString, "Janice", "Galvin");  
+      Console.WriteLine();  
+  
+      InsertPersonInAdapter(SqlDbConnectionString, "Peter", "Krebs");  
+      Console.WriteLine();  
+  
+      String oledbConnectionString = "Provider=Microsoft.Jet.OLEDB.4.0; Data Source=Database\\MySchool.mdb";  
+      InsertPersonInJet4Database(oledbConnectionString, "Janice", "Galvin");  
+      Console.WriteLine();  
+  
+      Console.WriteLine("Please press any key to exit.....");  
+      Console.ReadKey();  
+   }  
+  
+   // Using stored procedure to insert a new row and retrieve the identity value  
+   static void InsertPerson(String connectionString, String firstName, String lastName) {  
+      String commandText = "dbo.InsertPerson";  
+  
+      using (SqlConnection conn = new SqlConnection(connectionString)) {  
+         using (SqlCommand cmd = new SqlCommand(commandText, conn)) {  
+            cmd.CommandType = CommandType.StoredProcedure;  
+  
+            cmd.Parameters.Add(new SqlParameter("@FirstName", firstName));  
+            cmd.Parameters.Add(new SqlParameter("@LastName", lastName));  
+            SqlParameter personId = new SqlParameter("@PersonID", SqlDbType.Int);  
+            personId.Direction = ParameterDirection.Output;  
+            cmd.Parameters.Add(personId);  
+  
+            conn.Open();  
+            cmd.ExecuteNonQuery();  
+  
+            Console.WriteLine("Person Id of new person:{0}", personId.Value);  
+         }  
+      }  
+   }  
+  
+   // Using stored procedure in adapter to insert new rows and update the identity value.  
+   static void InsertPersonInAdapter(String connectionString, String firstName, String lastName) {  
+      String commandText = "dbo.InsertPerson";  
+      using (SqlConnection conn = new SqlConnection(connectionString)) {  
+         SqlDataAdapter mySchool = new SqlDataAdapter("Select PersonID,FirstName,LastName from [dbo].[Person]", conn);  
+  
+         mySchool.InsertCommand = new SqlCommand(commandText, conn);  
+         mySchool.InsertCommand.CommandType = CommandType.StoredProcedure;  
+  
+         mySchool.InsertCommand.Parameters.Add(  
+             new SqlParameter("@FirstName", SqlDbType.NVarChar, 50, "FirstName"));  
+         mySchool.InsertCommand.Parameters.Add(  
+             new SqlParameter("@LastName", SqlDbType.NVarChar, 50, "LastName"));  
+  
+         SqlParameter personId = mySchool.InsertCommand.Parameters.Add(new SqlParameter("@PersonID", SqlDbType.Int, 0, "PersonID"));  
+         personId.Direction = ParameterDirection.Output;  
+  
+         DataTable persons = new DataTable();  
+         mySchool.Fill(persons);  
+  
+         DataRow newPerson = persons.NewRow();  
+         newPerson["FirstName"] = firstName;  
+         newPerson["LastName"] = lastName;  
+         persons.Rows.Add(newPerson);  
+  
+         mySchool.Update(persons);  
+         Console.WriteLine("Show all persons:");  
+         ShowDataTable(persons, 14);  
+      }  
+   }  
+  
+   /// For a Jet 4.0 database, we need use the sigle statement and event handler to insert new rows and retrieve the identity value.  
+   static void InsertPersonInJet4Database(String connectionString, String firstName, String lastName) {  
+      String commandText = "Insert into Person(FirstName,LastName) Values(?,?)";  
+      using (OleDbConnection conn = new OleDbConnection(connectionString)) {  
+         OleDbDataAdapter mySchool = new OleDbDataAdapter("Select PersonID,FirstName,LastName from Person", conn);  
+  
+         // Create Insert Command  
+         mySchool.InsertCommand = new OleDbCommand(commandText, conn);  
+         mySchool.InsertCommand.CommandType = CommandType.Text;  
+  
+         mySchool.InsertCommand.Parameters.Add(new OleDbParameter("@FirstName", OleDbType.VarChar, 50, "FirstName"));  
+         mySchool.InsertCommand.Parameters.Add(new OleDbParameter("@LastName", OleDbType.VarChar, 50, "LastName"));  
+         mySchool.InsertCommand.UpdatedRowSource = UpdateRowSource.Both;  
+  
+         DataTable persons = CreatePersonsTable();  
+  
+         mySchool.Fill(persons);  
+  
+         DataRow newPerson = persons.NewRow();  
+         newPerson["FirstName"] = firstName;  
+         newPerson["LastName"] = lastName;  
+         persons.Rows.Add(newPerson);  
+  
+         DataTable dataChanges = persons.GetChanges();  
+  
+         mySchool.RowUpdated += OnRowUpdated;  
+  
+         mySchool.Update(dataChanges);  
+  
+         Console.WriteLine("Data before merging:");  
+         ShowDataTable(persons, 14);  
+         Console.WriteLine();  
+  
+         persons.Merge(dataChanges);  
+         persons.AcceptChanges();  
+  
+         Console.WriteLine("Data after merging");  
+         ShowDataTable(persons, 14);  
+      }  
+   }  
+  
+   static void OnRowUpdated(object sender, OleDbRowUpdatedEventArgs e) {  
+      if (e.StatementType == StatementType.Insert) {  
+         // Retrieve the identity value  
+         OleDbCommand cmdNewId = new OleDbCommand("Select @@IDENTITY", e.Command.Connection);  
+         e.Row["PersonID"] = (Int32)cmdNewId.ExecuteScalar();  
+  
+         // After the status is changed, the original values in the row are preserved. And the   
+         // Merge method will be called to merge the new identity value into the original DataTable.  
+         e.Status = UpdateStatus.SkipCurrentRow;  
+      }  
+   }  
+  
+   // Create the Persons table before filling.  
+   private static DataTable CreatePersonsTable() {  
+      DataTable persons = new DataTable();  
+  
+      DataColumn personId = new DataColumn();  
+      personId.DataType = Type.GetType("System.Int32");  
+      personId.ColumnName = "PersonID";  
+      personId.AutoIncrement = true;  
+      personId.AutoIncrementSeed = 0;  
+      personId.AutoIncrementStep = -1;  
+      persons.Columns.Add(personId);  
+  
+      DataColumn firstName = new DataColumn();  
+      firstName.DataType = Type.GetType("System.String");  
+      firstName.ColumnName = "FirstName";  
+      persons.Columns.Add(firstName);  
+  
+      DataColumn lastName = new DataColumn();  
+      lastName.DataType = Type.GetType("System.String");  
+      lastName.ColumnName = "LastName";  
+      persons.Columns.Add(lastName);  
+  
+      DataColumn[] pkey = { personId };  
+      persons.PrimaryKey = pkey;  
+  
+      return persons;  
+   }  
+  
+   private static void ShowDataTable(DataTable table, Int32 length) {  
+      foreach (DataColumn col in table.Columns) {  
+         Console.Write("{0,-" + length + "}", col.ColumnName);  
+      }  
+      Console.WriteLine();  
+  
+      foreach (DataRow row in table.Rows) {  
+         foreach (DataColumn col in table.Columns) {  
+            if (col.DataType.Equals(typeof(DateTime)))  
+               Console.Write("{0,-" + length + ":d}", row[col]);  
+            else if (col.DataType.Equals(typeof(Decimal)))   
+               Console.Write("{0,-" + length + ":C}", row[col]);  
+            else  
+               Console.Write("{0,-" + length + "}", row[col]);  
+         }  
+  
+         Console.WriteLine();  
+      }  
+   }  
+}  
+```  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [行の状態とバージョン](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)   
+ [AcceptChanges と RejectChanges](../../../../docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md)   
+ [DataSet の内容のマージ](../../../../docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/schema-restrictions.md b/docs/framework/data/adonet/schema-restrictions.md
new file mode 100644
index 00000000000..7df5ee1d36e
--- /dev/null
+++ b/docs/framework/data/adonet/schema-restrictions.md
@@ -0,0 +1,273 @@
+---
+title: "スキーマの制限 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 73d2980e-e73c-4987-913a-8ddc93d09144
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# スキーマの制限
+**GetSchema** メソッドの 2 番目のオプション パラメーターは、返されるスキーマ情報の量を制限するために使用される制限で、文字列の配列として **GetSchema** メソッドに渡されます。  配列での位置により、渡すことができる値が決定します。これは、制限の番号に相当します。  
+  
+ たとえば、次の表は、.NET Framework Data Provider for SQL Server を使用して、"Tables" スキーマ コレクションによりサポートされる制限を示しています。  SQL Server スキーマ コレクションの追加の制限をこのトピックの終わりに示します。  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Name|TABLE\_NAME|3|  
+|TableType|@TableType|TABLE\_TYPE|4|  
+  
+## 制限値の指定  
+ "Tables" スキーマ コレクションの制限の 1 つを使用するには、4 つの要素を使って文字列の配列を作成してから、制限の番号と一致する要素内に値を配置します。  たとえば、**GetSchema** メソッドにより返されるテーブルを、"Sales" スキーマ内のテーブルのみに制限するには、**GetSchema** メソッドに渡す前に、配列の 2 番目の要素を "Sales" に設定します。  
+  
+> [!NOTE]
+>  `SqlClient` と `OracleClient` の制限のコレクションには、追加の `ParameterName` 列があります。  制限の既定の列は、下位互換性のために存在してはいますが、現在は無視されています。  制限の値を指定する場合、文字列置換ではなく、パラメーター付きのクエリを使って、SQL への注入攻撃のリスクを最小限にする必要があります。  
+  
+> [!NOTE]
+>  配列内の要素数は、指定したスキーマ コレクションでサポートされる制限数以下にする必要があります。そうでない場合、<xref:System.ArgumentException> がスローされます。  制限は最大数よりも小さい場合があります。  指定されていない制限は、null \(無制限\) と見なされます。  
+  
+ .NET Framework マネージ プロバイダーでは、"Restrictions" という制限のスキーマ コレクションの名前を指定して **GetSchema** メソッドを呼び出すことにより、サポートされる制限の一覧を特定します。  これにより、コレクション名の一覧、制限の名前、既定の制限値、および制限の番号と共に、<xref:System.Data.DataTable> が返されます。  
+  
+### 例  
+ .NET Framework Data Provider for the SQL Server <xref:System.Data.SqlClient.SqlConnection> クラスの <xref:System.Data.SqlClient.SqlConnection.GetSchema%2A> メソッドを使って、**AdventureWorks** サンプル データベースに含まれるすべてのテーブルに関するスキーマ情報を取得し、返される情報を "Sales" スキーマ内のテーブルのみに制限する方法について、いくつかの例を次に示します。  
+  
+ \[Visual Basic\]  
+  
+```  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+Sub Main()  
+  Dim connectionString As String = _  
+    "Data Source=(local);Database=AdventureWorks;" & _  
+       "Integrated Security=true;";  
+  
+  Dim restrictions(3) As String  
+  Using connection As New SqlConnection(connectionString)  
+    connection.Open()  
+  
+    'Specify the restrictions.  
+    restrictions(1) = "Sales"  
+    Dim table As DataTable = connection.GetSchema("Tables", _  
+       restrictions)  
+  
+    ' Display the contents of the table.  
+      For Each row As DataRow In table.Rows  
+         For Each col As DataColumn In table.Columns  
+            Console.WriteLine("{0} = {1}", col.ColumnName, row(col))  
+         Next  
+         Console.WriteLine("============================")  
+      Next  
+    Console.WriteLine("Press any key to continue.")  
+    Console.ReadKey()  
+  End Using  
+End Sub  
+End Module  
+```  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+class Program  
+{  
+  static void Main()  
+  {  
+    string connectionString =   
+       "Data Source=(local);Database=AdventureWorks;" +  
+       "Integrated Security=true;";  
+    using (SqlConnection connection =  
+       new SqlConnection(connectionString))  
+    {  
+        connection.Open();  
+  
+        // Specify the restrictions.  
+        string[] restrictions = new string[4];  
+        restrictions[1] = "Sales";  
+        System.Data.DataTable table = connection.GetSchema(  
+          "Tables", restrictions);  
+  
+        // Display the contents of the table.  
+        foreach (System.Data.DataRow row in table.Rows)  
+        {  
+            foreach (System.Data.DataColumn col in table.Columns)  
+            {  
+                Console.WriteLine("{0} = {1}",   
+                  col.ColumnName, row[col]);  
+            }  
+            Console.WriteLine("============================");  
+        }  
+        Console.WriteLine("Press any key to continue.");  
+        Console.ReadKey();  
+    }  
+  }  
+  
+  private static string GetConnectionString()  
+  {  
+     // To avoid storing the connection string in your code,  
+     // you can retrieve it from a configuration file.  
+     return "Data Source=(local);Database=AdventureWorks;" +  
+        "Integrated Security=true;";  
+  }  
+  
+  private static void DisplayData(System.Data.DataTable table)  
+  {  
+     foreach (System.Data.DataRow row in table.Rows)  
+     {  
+        foreach (System.Data.DataColumn col in table.Columns)  
+        {  
+           Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);  
+        }  
+     Console.WriteLine("============================");  
+     }  
+  }  
+}  
+```  
+  
+## SQL Server スキーマの制限  
+ 次の表に、SQL Server スキーマ コレクションの制限を示します。  
+  
+### Users  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|User\_Name|@Name|name|1|  
+  
+### Databases  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|名前|@Name|名前|1|  
+  
+### \[テーブル\]  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Name|TABLE\_NAME|3|  
+|TableType|@TableType|TABLE\_TYPE|4|  
+  
+### 列  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+|Column|@Column|COLUMN\_NAME|4|  
+  
+### StructuredTypeMembers  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+|Column|@Column|COLUMN\_NAME|4|  
+  
+### ビュー  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+  
+### ViewColumns  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|VIEW\_CATALOG|1|  
+|オーナー|@Owner|VIEW\_SCHEMA|2|  
+|テーブル|@Table|VIEW\_NAME|3|  
+|Column|@Column|COLUMN\_NAME|4|  
+  
+### ProcedureParameters  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|SPECIFIC\_CATALOG|1|  
+|オーナー|@Owner|SPECIFIC\_SCHEMA|2|  
+|名前|@Name|SPECIFIC\_NAME|3|  
+|パラメーター|@Parameter|PARAMETER\_NAME|4|  
+  
+### 手順  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|SPECIFIC\_CATALOG|1|  
+|オーナー|@Owner|SPECIFIC\_SCHEMA|2|  
+|名前|@Name|SPECIFIC\_NAME|3|  
+|種類|@Type|ROUTINE\_TYPE|4|  
+  
+### IndexColumns  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|db\_name\(\)|1|  
+|オーナー|@Owner|user\_name\(\)|2|  
+|テーブル|@Table|o.  name|3|  
+|ConstraintName|@ConstraintName|x.  name|4|  
+|Column|@Column|c.  name|5|  
+  
+### Indexes  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|db\_name\(\)|1|  
+|オーナー|@Owner|user\_name\(\)|2|  
+|テーブル|@Table|o.  name|3|  
+  
+### UserDefinedTypes  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|assembly\_name|@AssemblyName|assemblies.  name|1|  
+|udt\_name|@UDTName|types.assembly\_class|2|  
+  
+### ForeignKeys  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|CONSTRAINT\_CATALOG|1|  
+|オーナー|@Owner|CONSTRAINT\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+|名前|@Name|CONSTRAINT\_NAME|4|  
+  
+## SQL Server 2008 スキーマの制限  
+ 次の表に、SQL Server 2008 スキーマ コレクションの制限を示します。  これらの制限は、.NET Framework 3.5 SP1 および SQL Server 2008 以降で有効です。  これらの制限は、以前のバージョンの .NET Framework および SQL Server ではサポートされません。  
+  
+### ColumnSetColumns  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+  
+### AllColumns  
+  
+|制限の名前|パラメーター名|制限の既定値|制限の番号|  
+|-----------|-------------|------------|-----------|  
+|Catalog|@Catalog|TABLE\_CATALOG|1|  
+|オーナー|@Owner|TABLE\_SCHEMA|2|  
+|テーブル|@Table|TABLE\_NAME|3|  
+|Column|@Column|COLUMN\_NAME|4|  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/secure-client-applications.md b/docs/framework/data/adonet/secure-client-applications.md
new file mode 100644
index 00000000000..402bcc68268
--- /dev/null
+++ b/docs/framework/data/adonet/secure-client-applications.md
@@ -0,0 +1,80 @@
+---
+title: "安全なクライアント アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6239592e-fa7d-4dea-9f00-d296d0048b01
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 安全なクライアント アプリケーション
+通常、アプリケーションは多数の要素で構成されており、それぞれをデータの損失やシステムのセキュリティ侵害を招く脆弱性から確実に保護する必要があります。  安全なユーザー インターフェイスを作成し、攻撃者によるデータやシステム リソースへのアクセスを未然に阻止することで、多くの問題を防ぐことができます。  
+  
+## ユーザー入力の検証  
+ データにアクセスするアプリケーションを構築する場合、ユーザーの入力はすべて悪意のあるものと想定しない限り、  攻撃に対する脆弱性をアプリケーションから取り除くことはできません。  .NET Framework には、入力できる文字数の制限など、入力コントロールの値の範囲を設定するクラスが用意されています。  イベントを捕捉することによって、値の有効性を確認するプロシージャを作成できます。  ユーザーによって入力されるデータを検証し、厳密に型指定することで、アプリケーションをスクリプト インジェクションや SQL インジェクションなどの攻撃にさらす機会を制限できます。  
+  
+> [!IMPORTANT]
+>  クライアント アプリケーションだけでなく、データ ソース側でもユーザー入力を検証する必要があります。  攻撃者がアプリケーションを迂回し、データ ソースを直接攻撃してくる可能性もあります。  
+  
+ [セキュリティとユーザー入力](../../../../docs/standard/security/security-and-user-input.md)  
+ 発見が難しく大きな危険を招く可能性のあるユーザー入力に関連したバグへの対処方法を説明します。  
+  
+ [Validating User Input in ASP.NET Web Pages](../Topic/Validating%20User%20Input%20in%20ASP.NET%20Web%20Pages.md)  
+ ASP.NET の検証コントロールを使ったユーザー入力の検証について概要を説明します。  
+  
+ [Windows フォームでのユーザー入力](../../../../docs/framework/winforms/user-input-in-windows-forms.md)  
+ Windows フォーム アプリケーションにおけるマウス入力およびキーボード入力の検証に関連したリンクや情報を提供します。  
+  
+ [.NET Framework の正規表現](../../../../docs/standard/base-types/regular-expressions.md)  
+ <xref:System.Text.RegularExpressions.Regex> クラスを使用してユーザー入力の有効性を確認する方法について説明します。  
+  
+## Windows アプリケーション  
+ これまで、Windows アプリケーションは、アクセスがすべて許可された状態で実行されていました。  .NET Framework は、コード アクセス セキュリティ \(CAS\) を使用して Windows アプリケーションで実行されるコードを制限するインフラストラクチャを提供します。  ただし、CAS だけでは、アプリケーションを保護するには不十分です。  
+  
+ [Windows フォームのセキュリティ](../../../../docs/framework/winforms/windows-forms-security.md)  
+ Windows フォーム アプリケーションをセキュリティで保護する方法について説明します。また、関連項目へのリンクがあります。  
+  
+ [Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)  
+ Windows フォーム アプリケーションでアンマネージ アプリケーションと対話する方法について説明します。  
+  
+ [ClickOnce Deployment for Windows Forms Applications](http://msdn.microsoft.com/ja-jp/34d8c770-48f2-460c-8d67-4ea5684511df)  
+ Windows フォーム アプリケーションでの `ClickOnce` 配置の使用方法およびセキュリティへの影響について説明します。  
+  
+## ASP.NET と XML Web サービス  
+ 通常、ASP.NET アプリケーションは、アクセスを Web サイトの一部に制限し、データ保護およびサイト セキュリティのための他のメカニズムを提供する必要があります。  以下のリンクにアクセスすると、ASP.NET アプリケーションをセキュリティで保護するための有益な情報を見つけることができます。  
+  
+ XML Web サービスは、ASP.NET アプリケーション、Windows フォーム アプリケーション、またはその他の Web サービスが使用できるデータを提供します。  クライアント アプリケーションのセキュリティだけでなく、Web サービスそのもののセキュリティを管理する必要があります。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[NIB: ASP.NET Security](http://msdn.microsoft.com/ja-jp/04b37532-18d9-40b4-8e5f-ee09a70b311d)|ASP.NET アプリケーションをセキュリティで保護する方法について説明します。|  
+|[Securing XML Web Services Created Using ASP.NET](http://msdn.microsoft.com/ja-jp/354b2ab1-2782-4542-b32a-dc560178b90c)|ASP.NET Web サービスへのセキュリティの実装方法について説明します。|  
+|[Script Exploits Overview](../Topic/Script%20Exploits%20Overview.md)|Web ページに悪意のある文字の挿入を試みるスクリプト攻略攻撃を阻止する方法について説明します。|  
+|[NIB:Basic Security Practices for ASP.NET Web Applications](http://msdn.microsoft.com/ja-jp/94a52ab8-731d-417e-b997-721baf43df38)|一般的なセキュリティ情報のほか、より詳細なページへのリンクも掲載されています。|  
+  
+## リモート処理  
+ .NET リモート処理を使用すると、広範囲の分散アプリケーションを簡単に構築できます。その場合、アプリケーションのコンポーネントを、すべて 1 台のコンピューターに置くことも、遠隔地のコンピューターに分散させることもできます。  同じコンピューター上、またはネットワークを経由してアクセスできる他の任意のコンピューター上にある他のプロセスのオブジェクトを使用するクライアント アプリケーションを構築できます。  また、.NET リモート処理を使用すると、同じプロセスの他のアプリケーション ドメインと通信できます。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[Configuration of Remote Applications](http://msdn.microsoft.com/ja-jp/92c0c097-d984-4315-835b-7490ecdf1097)|一般的な問題を回避するためのリモート処理アプリケーションの構成方法について説明します。|  
+|[Security in Remoting](http://msdn.microsoft.com/ja-jp/9574262c-d4b1-41c5-8600-24ff147c0add)|認証と暗号化のほか、リモート処理に関連したその他のセキュリティ トピックについて説明します。|  
+|[セキュリティとリモート処理の考慮事項](../../../../docs/framework/misc/security-and-remoting-considerations.md)|保護されたオブジェクトやアプリケーション ドメインの境界越えに伴うセキュリティの問題について説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [Recommendations for Data Access Strategies](http://msdn.microsoft.com/ja-jp/72411f32-d12a-4de8-b961-e54fca7faaf5)   
+ [アプリケーションの保護](../Topic/Securing%20Applications.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/secure-data-access.md b/docs/framework/data/adonet/secure-data-access.md
new file mode 100644
index 00000000000..347fcc29dda
--- /dev/null
+++ b/docs/framework/data/adonet/secure-data-access.md
@@ -0,0 +1,106 @@
+---
+title: "安全なデータ アクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 473ebd69-21a3-4627-b95e-4e04d035c56f
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# 安全なデータ アクセス
+セキュリティで保護された ADO.NET コードを作成するには、基になるデータ ストア、つまりデータベースで利用可能なセキュリティ機構を理解しておく必要があります。  さらに、アプリケーションに含まれる他の機能またはコンポーネントのセキュリティへの影響も考慮する必要があります。  
+  
+## 認証、承認、および権限  
+ Microsoft SQL Server に接続する場合は、Windows 認証 \(統合セキュリティ\) を使用できます。Windows 認証では、ユーザー ID とパスワードを渡さずに、現在のアクティブな Windows ユーザーの ID を使用します。  ユーザー資格情報が接続文字列内で公開されないため、Windows 認証を使用することを強くお勧めします。  SQL Server への接続に Windows 認証を使用できない場合は、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> を使用して、接続文字列を実行時に作成することを検討してください。  
+  
+ 認証に使用する資格情報は、アプリケーションのタイプに基づいて、それぞれ個別に処理する必要があります。  たとえば、Windows フォーム アプリケーションでは、ユーザーに認証情報の入力を求めたり、ユーザーの Windows 資格情報を使用できます。  Web アプリケーションでは、ユーザーではなくアプリケーションより提供された資格情報を使用してデータにアクセスする場合がよくあります。  
+  
+ いったん認証されたユーザーは、与えられた権限に基づく範囲で操作を実行できます。  常に最小特権の原則に従い、どうしても必要な権限以外は付与しないようにしてください。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)|保護構成を使用して接続文字列を暗号化する方法など、セキュリティのベスト プラクティスと接続情報を保護する手法について説明します。|  
+|[Recommendations for Data Access Strategies](http://msdn.microsoft.com/ja-jp/72411f32-d12a-4de8-b961-e54fca7faaf5)|データへのアクセスおよびデータベース操作の実行に関連した推奨事項について説明します。|  
+|[接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)|実行時にユーザー入力から接続文字列を構築する方法について説明します。|  
+|[SQL Server セキュリティの概要](../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)|SQL Server のセキュリティ アーキテクチャについて説明します。|  
+  
+## パラメーター化コマンドと SQL インジェクション  
+ パラメーター化コマンドは SQL インジェクション攻撃への対策として利用できます。SQL インジェクション攻撃は、SQL ステートメントに、サーバーのセキュリティを侵害するコマンドを "注入" することによって行われます。  パラメーター化コマンドを使用した場合、外部ソースから受け取る値が必ず値として渡され、Transact\-SQL ステートメントの一部になることはないため、SQL インジェクション攻撃を防ぐことができます。  Transact\-SQL コマンドが値に挿入されたとしても、データ ソースに対して実行されることはありません。  これらのコマンドは、単なるパラメーター値として処理されます。  セキュリティ面の利点に加え、パラメーター化コマンドには、Transact\-SQL ステートメントで渡される値やストアド プロシージャに渡される値を簡単に扱うことができるという利点もあります。  
+  
+ パラメーター化コマンドの使い方の詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[DataAdapter パラメーター](../../../../docs/framework/data/adonet/dataadapter-parameters.md)|`DataAdapter` でパラメーターを使用する方法について説明します。|  
+|[ストアド プロシージャでのデータの変更](../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)|パラメーターの指定方法および戻り値の取得方法について説明します。|  
+|[SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)|SQL Server のストアド プロシージャを使用してデータ アクセスをカプセル化する方法を説明します。|  
+  
+## スクリプト攻略  
+ Web ページに悪意のある文字を挿入することによって行われるスクリプト攻略もインジェクション型の攻撃に属します。  挿入された文字はブラウザーによって検証されることなく、ページの一部として処理されます。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[Script Exploits Overview](../Topic/Script%20Exploits%20Overview.md)|スクリプトによる攻略および SQL ステートメントによる攻略から保護する方法について説明します。|  
+  
+## プローブ攻撃  
+ 攻撃者は、システムを攻撃するときに、サーバー、データベース、テーブルなどの名前を例外情報から取得して使用することがよくあります。  例外には、アプリケーションやデータ ソースに関する具体的な情報が含まれている場合があるので、アプリケーションとデータ ソースの保護を強化するには、クライアント側に不可欠な情報だけを公開するようにします。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[例外処理の基本事項](../../../../docs/standard/exceptions/exception-handling-fundamentals.md)|try\/catch\/finally 構造化例外処理の基本的な形式について説明します。|  
+|[例外の推奨事項](../../../../docs/standard/exceptions/best-practices-for-exceptions.md)|例外処理のベスト プラクティスについて説明します。|  
+  
+## Microsoft Access および Excel データ ソースの保護  
+ セキュリティ要件が最小限の場合、またはセキュリティ要件がまったく存在しない場合は、Microsoft Access や Microsoft Excel を ADO.NET アプリケーションのデータ ストアとして利用できます。  セキュリティ面では、"関係者以外には触らせないようにする" とった程度であれば十分な抑止効果がありますが、それ以上のセキュリティを求めることはできません。  Access および Excel の物理データ ファイルはファイル システム上に存在するため、原則的にすべてのユーザーがアクセスできます。  ファイルは容易にコピーしたり改変したりできるため、データの盗難や損失といった攻撃には決して強くありません。  堅牢なセキュリティが必要な場合は、SQL Server など、物理データ ファイルをファイル システムから読み取ることのできないサーバー ベースのデータベースを使用してください。  
+  
+ Access データおよび Excel データの保護の詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[Access 2007 のセキュリティに関する考慮事項とガイダンス](http://go.microsoft.com/fwlink/?LinkId=98354)|Access 2007 のセキュリティ手法 \(ファイルの暗号化、パスワードの管理、新しい ACCDB 形式および ACCDE 形式へのデータベースの変換、他のセキュリティ オプションの使用など\) について説明します。|  
+|[ユーザーレベルのセキュリティによる Access データベースの保護 \(MDB\)](http://go.microsoft.com/fwlink/?LinkId=47697)|Access 2003 を対象としたトピックです。  Access 2003 でユーザー レベルのセキュリティ機能を実装し、データを保護する方法について説明します。|  
+|[Access セキュリティにおけるワークグループ情報ファイルの役割について](http://support.microsoft.com/kb/305542)|Access 2003 のセキュリティの作業グループ情報ファイルのロールおよびリレーションシップについて説明します。|  
+|[Microsoft Access バージョン 2.0 から 2000 までの Microsoft Access セキュリティに関するよくある質問](http://go.microsoft.com/fwlink/?LinkId=47698)|ダウンロード可能なバージョンの Microsoft Access セキュリティ FAQ です。|  
+|[セキュリティと保護のトラブルシューティング](http://go.microsoft.com/fwlink/?LinkId=47703)|Excel 2003 のセキュリティに関する一般的な問題の解決方法が掲載されています。|  
+  
+## Enterprise Services  
+ COM\+ は、Windows NT アカウントおよびプロセスやスレッドの偽装に基づく独自のセキュリティ モデルを備えています。  <xref:System.EnterpriseServices> 名前空間は、.NET アプリケーションが、<xref:System.EnterpriseServices.ServicedComponent> クラスを使用して、マネージ コードと COM\+ セキュリティ サービスを統合できるようにするラッパーを提供します。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[COM\+ Role\-Based Security and the .NET Framework](http://msdn.microsoft.com/ja-jp/02ab22ef-e5e2-4d29-b33a-6e03d94c4981)|マネージ コードを COM\+ セキュリティ サービスに統合する方法について説明します。|  
+  
+## アンマネージ コードとの相互運用  
+ .NET Framework は、COM コンポーネント、COM\+ サービス、外部のタイプ ライブラリ、各種のオペレーティング システム サービスなど、アンマネージ コードとの相互運用性をサポートします。  アンマネージ コードを使用することは、マネージ コードのセキュリティ境界の外に出ることを意味します。  作成するコード、およびそれを呼び出すコードのどちらにも、アンマネージ コード権限 \(<xref:System.Security.Permissions.SecurityPermissionFlag> フラグが指定された <xref:System.Security.Permissions.SecurityPermission>\) が必要です。  アンマネージ コードは、意図しないセキュリティ上の脆弱性をアプリケーションにもたらす可能性があります。  どうしても必要な場合を除き、アンマネージ コードとの相互運用は避けてください。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[アンマネージ コードとの相互運用](../../../../docs/framework/interop/index.md)|COM コンポーネントを .NET Framework に公開する方法、および .NET Framework コンポーネントを COM に公開する方法について説明します。|  
+|[Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)|プライマリ相互運用機能アセンブリ、スレッド処理、カスタム マーシャリングなど高度なトピックが含まれています。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [Recommendations for Data Access Strategies](http://msdn.microsoft.com/ja-jp/72411f32-d12a-4de8-b961-e54fca7faaf5)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)   
+ [接続文字列ビルダー](../../../../docs/framework/data/adonet/connection-string-builders.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/securing-ado-net-applications.md b/docs/framework/data/adonet/securing-ado-net-applications.md
new file mode 100644
index 00000000000..66956a96a06
--- /dev/null
+++ b/docs/framework/data/adonet/securing-ado-net-applications.md
@@ -0,0 +1,63 @@
+---
+title: "ADO.NET アプリケーションのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 005a1d43-6ee5-471e-ad98-1d30a44d49d5
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ADO.NET アプリケーションのセキュリティ保護
+ユーザー入力の検証を怠るなど、コーディング時に陥りやすい基本的なミスを防ぐだけでは、安全な ADO.NET アプリケーションを作成することはできません。  データにアクセスするアプリケーションには、機密データの取得、操作、破壊など、攻撃者に攻略される可能性がある障害点が多数あります。  そのため、アプリケーションの設計フェーズで行う脅威のモデリングのプロセスから、アプリケーションの最終的な配置と継続的な保守に至るまで、セキュリティのすべての側面を理解することが重要です。  
+  
+ .NET Framework には、データベース アプリケーションのセキュリティを確保し、管理するのに有用なクラス、サービス、およびツールが多数用意されています。  共通言語ランタイム \(CLR\) によって、コードを実行するためのタイプ セーフな環境が実現され、それと同時に、コード アクセス セキュリティ \(CAS\) によって、マネージ コードのアクセス許可はより制限されています。  攻撃者によってもたらされる可能性のある損害は、安全なデータ アクセスのためのコーディング方法に従うことによって最小限に抑えることができます。  
+  
+ データベースなどのアンマネージ リソースを扱う場合、安全なコードを作成したとしても、自ら招いたセキュリティ ホールを防ぐことはできません。  SQL Server を含め、ほとんどのサーバー データベースには、正しく実装することによってセキュリティを強化できる独自のセキュリティ システムがあります。  しかし、データ ソースがいかに堅牢なセキュリティ システムを備えていたとしても、それが適切に構成されていなければ攻撃を防ぐことはできません。  
+  
+## このセクションの内容  
+ [セキュリティの概要 ](../../../../docs/framework/data/adonet/security-overview.md)  
+ 安全な ADO.NET アプリケーションを設計するための推奨事項について説明します。  
+  
+ [安全なデータ アクセス](../../../../docs/framework/data/adonet/secure-data-access.md)  
+ セキュリティで保護されたデータ ソースのデータを使用する方法について説明します。  
+  
+ [安全なクライアント アプリケーション](../../../../docs/framework/data/adonet/secure-client-applications.md)  
+ クライアント アプリケーションのセキュリティに関する考慮事項について説明します。  
+  
+ [コード アクセス セキュリティと ADO.NET](../../../../docs/framework/data/adonet/code-access-security.md)  
+ CAS を使用して ADO.NET コードを保護する方法について説明します。  部分信頼の使用方法についても説明します。  
+  
+ [プライバシーとデータ セキュリティ](../../../../docs/framework/data/adonet/privacy-and-data-security.md)  
+ ADO.NET アプリケーションの暗号化オプションについて説明します。  
+  
+## 関連項目  
+ [SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)  
+ 開発者の観点から SQL Server のセキュリティ機能について説明します。  
+  
+ [セキュリティに関する注意事項](../../../../docs/framework/data/adonet/ef/security-considerations.md)  
+ エンティティ フレームワーク アプリケーションのセキュリティについて説明します。  
+  
+ [セキュリティ](../../../../docs/standard/security/index.md)  
+ .NET Framework のセキュリティをあらゆる観点から説明したトピックへのリンクが含まれています。  
+  
+ [Security Tools](http://msdn.microsoft.com/ja-jp/2a3eb98a-2de6-4fba-b41c-01a74d354c11)  
+ セキュリティ保護およびセキュリティ ポリシーの管理に使用する .NET Framework ツールについて説明します。  
+  
+ [Resources for Creating Secure Applications](http://msdn.microsoft.com/ja-jp/0ebf5f69-76f2-498a-a2df-83cf3443e132)  
+ 安全なアプリケーションを作成するためのトピックへのリンク集です。  
+  
+ [セキュリティ参考文献](../Topic/Security%20Bibliography.md)  
+ オンラインまたは出版物として提供されている外部リソースへのリンク集です。  
+  
+## 参照  
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/security-linq-to-dataset.md b/docs/framework/data/adonet/security-linq-to-dataset.md
new file mode 100644
index 00000000000..97ec5351f43
--- /dev/null
+++ b/docs/framework/data/adonet/security-linq-to-dataset.md
@@ -0,0 +1,33 @@
+---
+title: "Security (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6116b2b8-75f4-4d8b-aea6-c13e55cda50b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Security (LINQ to DataSet)
+このトピックでは、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] におけるセキュリティの問題について説明します。  
+  
+## 信頼できないコンポーネントへのクエリの受け渡し  
+ [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリはプログラム内のどこか 1 か所で定義されていれば、別の場所から実行できます。  このクエリは、それが定義されている場所から見えるすべての要素、たとえば、呼び出し元のメソッドが所属しているクラスのプライベート メンバーやローカル変数\/引数を表すシンボルなどを参照できます。  実行時には、呼び出し元のコードから見えなくても、クエリの定義時に参照されたメンバーであれば、事実上アクセスできることになります。  クエリを実行するコードが、任意に見える要素を増やすことはできません。つまり、アクセスできる範囲を実行元のコードそのものが決めることはできません。  アクセスの範囲は、クエリがアクセスできる範囲に限定されており、そのクエリ自体を通してのみアクセスできます。  
+  
+ つまり、クエリへの参照をコードの別の部分に渡した場合、そのクエリを受け取ったコンポーネントが信頼され、パブリックであるか、プライベートであるかに関係なく、クエリによって参照されたすべてのメンバーに対するアクセスが許可されます。  クエリが慎重に作成され、機密情報が決して漏洩しないという確信がない限り、通常は [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のクエリを信頼できないコンポーネントに渡さないでください。  
+  
+## 外部入力  
+ アプリケーションによっては \(ユーザーや他の外部エージェントからの\) 外部入力を受け取り、その入力内容に応じた処理を実行する場合があります。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のケースで言えば、アプリケーションが外部入力を基に \(またはクエリ内で外部入力を使用して\)、決められた方法でクエリを構築することが考えられます。[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のクエリは、リテラル値を使用できる部分に記述されていれば、どのようなパラメーターでも受け取ります。  アプリケーションの開発者は、外部エージェントから受け取ったリテラルを直接クエリに挿入することは避け、パラメーター化クエリを使用するようにしてください。  
+  
+ 直接、間接を問わず、ユーザーまたは外部エージェントから受け取った入力には、対象言語の構文を巧みに利用して不正なアクションを実行する内容が含まれている可能性があります。  これは、対象言語が Transact\-SQL である場合、その攻撃パターンにちなんで SQL インジェクション攻撃と呼ばれます。  クエリに直接挿入されるユーザー入力を使用して、データベースのテーブルを削除したり、サービス拒否の状態を引き起こしたり、本来実行される操作を改変したりします。  [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] 内でクエリを構築することは可能ですが、オブジェクト モデルの API を介して構築します。Transact\-SQL におけるクエリの作成とは異なり、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] のクエリが、文字列操作や文字列連結によって構築されることはありません。その意味では、SQL インジェクション攻撃に十分な抵抗力を持っていると言えます。  
+  
+## 参照  
+ [Programming Guide](../../../../docs/framework/data/adonet/programming-guide-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/security-overview.md b/docs/framework/data/adonet/security-overview.md
new file mode 100644
index 00000000000..da5bf47012f
--- /dev/null
+++ b/docs/framework/data/adonet/security-overview.md
@@ -0,0 +1,115 @@
+---
+title: "セキュリティの概要  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33e09965-61d5-48cc-9e8c-3b047cc4f194
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# セキュリティの概要 
+アプリケーションのセキュリティ保護は継続的なプロセスとして行う必要があります。  開発者は、アプリケーションがあらゆる攻撃に対して安全であることを常に保証できるわけではありません。これは、新しい技術がもたらす未知の攻撃を予測することが不可能なためです。  反対に、システムに欠陥が発見 \(または公開\) されていない場合も、そのシステムに欠陥がないとは限りません。  プロジェクトの設計フェーズでセキュリティを考慮することはもちろんのこと、アプリケーションの使用期間を通じてセキュリティをいかに確保してゆくかを計画しておく必要があります。  
+  
+## セキュリティのデザイン  
+ セキュリティで保護されたアプリケーションを開発するうえで最大の問題は、プロジェクトのコードが完成した後にセキュリティが導入されるということです。つまり、セキュリティが補足的になりがちです。  最初の段階でアプリケーションにセキュリティを導入しておかないと、十分な対策が講じられず、アプリケーションの安全性を損ねる結果となります。  
+  
+ 最終段階でセキュリティが実装された場合、新しい制限によりソフトウェアが誤動作を起こしたり、予期していなかった機能を組み込むためにソフトウェアの書き換えが必要となって、バグの発生が増えます。  また、書き換えたすべてのコードが新たなバグの原因となる可能性もあります。  このような理由から、新しい機能の開発と平行して進めるよう、開発プロセスの早い段階でセキュリティを考慮する必要があります。  
+  
+### 脅威モデリング  
+ システムがどのような攻撃に曝されているかを理解せずに、攻撃からシステムを保護することはできません。  ADO.NET アプリケーション上でセキュリティ違反の可能性およびその影響を調べるには、*脅威のモデリング*と呼ばれるセキュリティ上の脅威を評価するプロセスが必要です。  
+  
+ 脅威のモデリングは、1\) 攻撃者の視点を理解し、2\) システムのセキュリティの特徴を把握し、3\) 脅威を特定するという、大きく 3 つの手順で構成されます。  
+  
+ 脅威のモデリングでは、反復的なアプローチによってアプリケーションの脆弱性を評価しながら、最重要データの漏洩につながる最も危険な部分を特定します。  脆弱性を特定したら、それらを深刻度の順にランクを付けて脅威への一連の対策に優先順位を付けます。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|MSDN セキュリティ デベロッパー センターの「[脅威のモデリング](http://go.microsoft.com/fwlink/?LinkId=98353)」サイト|脅威のモデリング プロセスを理解し、開発したアプリケーションの脅威モデルを構築するうえで役に立ちます。|  
+  
+## 最小特権の原則  
+ アプリケーションの設計、ビルド、および配置は、アプリケーションが攻撃されるという前提で行う必要があります。  多くの場合、こうした攻撃は、コードを実行しているユーザーの権限で悪意のあるコードを実行することによって行われます。  高い技術を持った攻撃者が脆弱性を悪用することによって作成したコードも存在します。  セキュリティの計画を立てるときは、常に最悪のシナリオを想定するようにしてください。  
+  
+ コードを最小限の特権で実行することによって、できるだけ多層的にコードを防御することが対策の 1 つとして考えられます。  最小限の特権では、常に必要最小限のコードに対し、その処理に必要な最小限の時間だけ権限を与えることが原則となります。  
+  
+ 安全なアプリケーションを作成するためのベスト プラクティスは、まず、権限をまったく付与しない状態から始め、その後で、実行しようとする特定のタスクに必要な最小限の権限を追加してゆくことです。  逆に、すべての権限を与えてから、不要なものを 1 つずつ拒否していく方法では、アプリケーションを危険にさらす結果となります。この場合、意図せずに必要以上の権限を付与することによってセキュリティ ホールを招く可能性があるため、安全性をテストすることも、管理していくことも困難です。  
+  
+ アプリケーションのセキュリティ保護の詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[アプリケーションの保護](../Topic/Securing%20Applications.md)|一般的なセキュリティ トピックへのリンクが含まれています。  分散アプリケーション、Web アプリケーション、モバイル アプリケーション、およびデスクトップ アプリケーションを保護するためのトピックへのリンクも含まれています。|  
+  
+## コード アクセス セキュリティ \(CAS\)  
+ コード アクセス セキュリティ \(CAS\) は、保護されたリソースや操作に対するコードのアクセスを制限するメカニズムです。  .NET Framework では CAS によって次の機能が実行されます。  
+  
+-   各種システム リソースにアクセスするための権限や権限セットを定義する。  
+  
+-   管理者が一連の権限をコードのグループ \(コード グループ\) で関連付けることにより、セキュリティ ポリシーを構成できるようにする。  
+  
+-   実行に不可欠な権限のほか、あった方がよいと思われる権限、決して与えてはならない権限をコードから要求できるようにする。  
+  
+-   コードによって要求された権限およびセキュリティ ポリシーによって許可された操作に基づいて、読み込まれた各アセンブリに権限を付与する。  
+  
+-   呼び出し元が特定の権限を所有していることをコードから要求できるようにする。  
+  
+-   呼び出し元にデジタル署名があることをコード自身が要求できるようにします。これにより、特定の組織またはサイトからの呼び出し元だけが、保護されたコードを呼び出すことができます。  
+  
+-   呼び出し履歴上で、各呼び出し元に付与された権限を、その呼び出し元に求められる権限と比較することにより、コードに対する制限を実行時に強制する。  
+  
+ 攻撃を許した場合でも損害の規模を最小限に抑えるため、コードのセキュリティ コンテキストを選択し、コードの処理に必要なリソースへの権限だけを付与し、それ以外は実行できないようにする。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[コード アクセス セキュリティと ADO.NET](../../../../docs/framework/data/adonet/code-access-security.md)|ADO.NET アプリケーションの観点から、コード アクセス セキュリティ、ロール ベース セキュリティ、および部分信頼環境間の相互作用について説明します。|  
+|[Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)|.NET Framework の CAS について説明する追加のトピックへのリンクが含まれています。|  
+  
+## データベース セキュリティ  
+ 最小特権の原則はデータ ソースにも適用されます。  データベース セキュリティの一般的なガイドラインは次のとおりです。  
+  
+-   アカウントをできるだけ低い権限で作成する。  
+  
+-   単にコードの正常動作を目的としてユーザーに管理者アカウントにアクセスさせることは避ける。  
+  
+-   サーバー側のエラー メッセージをクライアント アプリケーションに返さない。  
+  
+-   クライアントとサーバーの両方ですべての入力を検証する。  
+  
+-   動的 SQL ステートメントは避け、パラメーター化コマンドを使用するようにする。  
+  
+-   データベースのセキュリティ監査とログ記録を有効にし、セキュリティ侵害が発生した場合に警告を受けることができるようにする。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)|SQL Server のセキュリティの概要を説明します。アプリケーションのシナリオを交えながら、SQL Server を対象とした安全な ADO.NET アプリケーションを作成するための指針を提供します。|  
+|[Recommendations for Data Access Strategies](http://msdn.microsoft.com/ja-jp/72411f32-d12a-4de8-b961-e54fca7faaf5)|データへのアクセスおよびデータベース操作の実行に関連した推奨事項について説明します。|  
+  
+## セキュリティ ポリシーと管理  
+ コード アクセス セキュリティ \(CAS\) ポリシーの管理が不適切だと、セキュリティの脆弱性を招く可能性があります。  アプリケーションを展開した後は、セキュリティ監視技法を適用し、新しい脅威が現れた際はそのリスクを評価する必要があります。  
+  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[NIB: Security Policy Management](http://msdn.microsoft.com/ja-jp/d754e05d-29dc-4d3a-a2c2-95eaaf1b82b9)|セキュリティ ポリシーの作成と管理について説明します。|  
+|[NIB: Security Policy Best Practices](http://msdn.microsoft.com/ja-jp/d49bc4d5-efb7-4caa-a2fe-e4d3cec63c05)|セキュリティ ポリシーの管理方法について説明したトピックへのリンクを提供します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [PAVE Security in Native and .NET Framework Code](http://msdn.microsoft.com/ja-jp/bd61be84-c143-409a-a75a-44253724f784)   
+ [SQL Server のセキュリティ](../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/side-by-side-execution.md b/docs/framework/data/adonet/side-by-side-execution.md
new file mode 100644
index 00000000000..6b128804713
--- /dev/null
+++ b/docs/framework/data/adonet/side-by-side-execution.md
@@ -0,0 +1,77 @@
+---
+title: "ADO.NET での side-by-side 実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f9ba96d-9f89-4f65-bb2f-6860879f4393
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET での side-by-side 実行
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の side\-by\-side 実行は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の複数のバージョンがインストールされている 1 台のコンピューター上で、アプリケーションのコンパイル時のバージョンのみを使用して、アプリケーションを実行する機能です。  side\-by\-side 実行の設定の詳細については、「[side\-by\-side 実行](../../../../docs/framework/deployment/side-by-side-execution.md)」を参照してください。  
+  
+ あるバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] を使用してコンパイルされたアプリケーションを、別のバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で実行することもできます。  ただし、インストールされている [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のバージョンごとにアプリケーションをコンパイルして、各バージョンを別々に実行することをお勧めします。  いずれの場合でも、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の各リリース間の変更によって生じるアプリケーションの上位互換性または下位互換性の問題に注意する必要があります。  
+  
+## 上位互換性と下位互換性  
+ 上位互換性とは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の旧バージョンでコンパイルしたアプリケーションが、新しいバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] でも実行できることを意味します。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] version 1.1 用に書かれた [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] コードは、後のバージョンとの上位互換性があります。  
+  
+ 下位互換性とは、アプリケーションが [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の新しいバージョン用にコンパイルされ、機能を低下させずに、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の以前のバージョンで引き続き実行できることを意味します。  当然のことながら、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の新しいバージョンで導入された機能については、これは該当しません。  
+  
+## .NET Framework Data Provider for ODBC  
+ Version 1.1 以降、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC \(<xref:System.Data.Odbc>\) は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の一部として同梱されています。  ODBC データ プロバイダーは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] バージョン 1.0 の開発者が、Web ダウンロードとして、[データ アクセスおよびストレージ デベロッパー センター](http://go.microsoft.com/fwlink/?linkid=4173)から利用することができます。  ダウンロードされた [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for ODBC の名前空間は **Microsoft.Data.Odbc** です。  
+  
+ ODBC データ プロバイダーを使用してデータ ソースに接続する、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 用に開発したアプリケーションがあり、そのアプリケーションを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 以降で実行する場合は、ODBC データ プロバイダーの名前空間を **System.Data.Odbc** に更新する必要があります。  その後で、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の新しいバージョン用に再コンパイルする必要があります。  
+  
+ ODBC データ プロバイダーを使用してデータ ソースに接続する [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 2.0 以降用に開発したアプリケーションがあり、そのアプリケーションを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 で実行する場合は、ODBC データ プロバイダーをダウンロードし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 システムにインストールする必要があります。  次に、ODBC データ プロバイダーの名前空間を **Microsoft.Data.Odbc** に変更し、アプリケーションを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 用に再コンパイルする必要があります。  
+  
+## .NET Framework Data Provider for Oracle  
+ Version 1.1 以降、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for Oracle \(<xref:System.Data.OracleClient>\) は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の一部として同梱されています。  データ プロバイダーは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] バージョン 1.0 の開発者が、Web ダウンロードとして、[データ アクセスおよびストレージ デベロッパー センター](http://go.microsoft.com/fwlink/?linkid=4173)から利用することができます。  
+  
+ このデータ プロバイダーを使用してデータ ソースに接続する、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 2.0 以降用に開発したアプリケーションがあり、そのアプリケーションを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 で実行する場合は、該当するデータ プロバイダーをダウンロードし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 システムにインストールする必要があります。  
+  
+## コード アクセス セキュリティ  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダー \(<xref:System.Data.SqlClient>、<xref:System.Data.OleDb>\) を実行するには、FullTrust 権限が必要です。  権限レベルが FullTrust より低いゾーンで [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーを使用しようとすると、<xref:System.Security.SecurityException> がスローされます。  
+  
+ ただし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 2.0 以降では、部分的に信頼されたゾーンで [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーのすべてを使用できるようになりました。  さらに、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーに新しいセキュリティ機能が追加されました。  この機能により、特定のセキュリティ ゾーンで使用できる接続文字列を制限することができます。  特定のセキュリティ ゾーンに対して空白のパスワードの使用を禁止することもできます。  詳細については、「[コード アクセス セキュリティと ADO.NET](../../../../docs/framework/data/adonet/code-access-security.md)」を参照してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のインストールごとに個別の Security.config ファイルがあるため、セキュリティ設定については、互換性の問題はありません。  ただし、アプリケーションが、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 以降に同梱されている [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の追加のセキュリティ機能に依存している場合は、アプリケーションを Version 1.0 システムに配布することはできません。  
+  
+## SqlCommand の実行  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 以降では、<xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> がデータ ソースでコマンドを実行する方法が変更されました。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 では、<xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> は、**sp\_executesql** ストアド プロシージャのコンテキストですべてのコマンドを実行します。  その結果、接続の状態に影響を与えるコマンド \(たとえば、SET NOCOUNT ON\) は、現在のコマンドの実行だけに適用されます。  接続が開かれている間に実行される後続のコマンドについては、接続の状態は変更されません。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 以降では、<xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> は、コマンドにパラメーターが含まれている場合だけ、**sp\_executesql** ストアド プロシージャのコンテキストでコマンドを実行します。これにより、パフォーマンスが向上します。  その結果、接続の状態に影響を与えるコマンドが、非パラメーター化コマンドに含まれている場合、接続が開いている間に実行される後続のすべてのコマンドに対して、接続の状態を変更します。  
+  
+ たとえば、<xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> への呼び出しで次のバッチ コマンドが実行されるとします。  
+  
+```  
+SET NOCOUNT ON;  
+SELECT * FROM dbo.Customers;  
+```  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.1 以降では、NOCOUNT は、接続が開いている間に実行される後続のコマンドに対して ON のままです。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 では、NOCOUNT は、現在のコマンドの実行に対してだけ ON です。  
+  
+ アプリケーションが、どちらかのバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の <xref:System.Data.SqlClient.SqlCommand.ExecuteReader%2A> の動作に依存している場合は、この変更が上位互換性と下位互換性の両方に影響することがあります。  
+  
+ アプリケーションを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の以前のバージョンと新しいバージョンの両方で動作させる場合は、どのバージョンで実行された場合にも動作が同じになるように、コードを記述できます。  変更された接続状態が後続のすべてのコマンドでも有効になるようにする場合は、<xref:System.Data.SqlClient.SqlCommand.ExecuteNonQuery%2A> を使用してコマンドを実行することをお勧めします。  変更された接続状態が後続のコマンドでは無効になるようにする場合は、接続状態をリセットするコマンドを含めるようにしてください。  次に例を示します。  
+  
+```  
+SET NOCOUNT ON;  
+SELECT * FROM dbo.Customers;  
+SET NOCOUNT OFF;  
+```  
+  
+## 参照  
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/single-table-queries-linq-to-dataset.md b/docs/framework/data/adonet/single-table-queries-linq-to-dataset.md
new file mode 100644
index 00000000000..5b26200971d
--- /dev/null
+++ b/docs/framework/data/adonet/single-table-queries-linq-to-dataset.md
@@ -0,0 +1,40 @@
+---
+title: "Single-Table Queries (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b74bcf8-3f87-449f-bff7-6bcb0d69d212
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Single-Table Queries (LINQ to DataSet)
+[!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] のクエリは、<xref:System.Collections.Generic.IEnumerable%601> インターフェイスまたは <xref:System.Query.IQueryable%601> インターフェイスを実装するデータ ソースに対して動作します。  <xref:System.Data.DataTable> クラスには、いずれのインターフェイスも実装されていません。そのため、[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] クエリの `From` 句でソースとして <xref:System.Data.DataTable> を使用する場合は、<xref:System.Data.DataTableExtensions.AsEnumerable%2A> メソッドを呼び出す必要があります。  
+  
+ 次の例では、SalesOrderHeader テーブルからオンラインでの注文をすべて取得し、注文 ID、注文日、および注文番号をコンソールに出力します。  
+  
+ [!code-csharp[dp linq to dataset examples#Where1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/CS/Program.cs#where1)]
+ [!code-vb[dp linq to dataset examples#Where1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP LINQ to DataSet Examples/VB/Module1.vb#where1)]  
+  
+ ローカル変数 query はクエリ式で初期化されます。クエリ式は、少なくとも 1 つのクエリ演算子 \(標準クエリ演算子、[!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] の場合は <xref:System.Data.DataSet> クラスに固有の演算子\) が適用されることによって、1 つまたは複数の情報ソースに対して機能します。  前の例のクエリ式には、2 つの標準クエリ演算子、`Where` と `Select` が使用されています。  
+  
+ この場合、`Where` 句では、`OnlineOrderFlag` \= `true` という条件に基づいてデータを抽出します。  `Select` 演算子は、その演算子に渡された引数をキャプチャする列挙可能なオブジェクトを割り当てて返します。  上の例では、`SalesOrderID`、`OrderDate`、`SalesOrderNumber` の 3 つのプロパティを使って匿名型を作成しています。  この 3 つのプロパティの値は、`SalesOrderHeader` テーブルの `SalesOrderID` 列、`OrderDate` 列、および `SalesOrderNumber` 列の値に設定されます。  
+  
+ 次に、`Select` から返された列挙可能なオブジェクトを `foreach` ループで列挙し、クエリ結果を出力します。  クエリは <xref:System.Collections.Generic.IEnumerable%601> を実装する <xref:System.Linq.Enumerable> 型であるため、`foreach` ループでクエリ変数を反復処理するまでクエリは評価されません。  クエリの評価を遅らせることで、繰り返し評価することのできる値としてクエリを維持し、評価のたびに異なる結果を得ることができます。  
+  
+ <xref:System.Data.DataRowExtensions.Field%2A> は、<xref:System.Data.DataRow> の列値にアクセスするためのメソッドです。また、前出の例には使用されていませんが、<xref:System.Data.DataRowExtensions.SetField%2A> を使用すると、<xref:System.Data.DataRow> の列値を設定できます。  <xref:System.Data.DataRowExtensions.Field%2A> メソッドも <xref:System.Data.DataRowExtensions.SetField%2A> メソッドも Null 許容型を扱うことができるため、Null 値を明示的にチェックする必要はありません。  また、どちらのメソッドもジェネリック メソッドです。つまり、戻り値の型をキャストする必要はありません。  <xref:System.Data.DataRow> の既存の列アクセサー \(`o["OrderDate"]` など\) を使用することもできますが、その場合、返されたオブジェクトを適切な型にキャストする必要があります。  列に NULL 値が許容されている場合、<xref:System.Data.DataRow.IsNull%2A> メソッドを使って、値が NULL かどうかをチェックする必要があります。  詳細については、「[Generic Field and SetField Methods](../../../../docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md)」を参照してください。  
+  
+ <xref:System.Data.DataRowExtensions.Field%2A> メソッドおよび <xref:System.Data.DataRowExtensions.SetField%2A> メソッドのジェネリック パラメーター `T` に指定するデータ型は、基になる値の型と一致している必要があります。一致していない場合、<xref:System.InvalidCastException> がスローされます。  指定する列の名前も <xref:System.Data.DataSet> 内の列名と一致している必要があります。一致していない場合、<xref:System.ArgumentException> がスローされます。  どちらの場合も、例外は、実行時にデータが列挙されて、クエリが実行されたときにスローされます。  
+  
+## 参照  
+ [Cross\-Table Queries](../../../../docs/framework/data/adonet/cross-table-queries-linq-to-dataset.md)   
+ [Querying Typed DataSets](../../../../docs/framework/data/adonet/querying-typed-datasets.md)   
+ [Generic Field and SetField Methods](../../../../docs/framework/data/adonet/generic-field-and-setfield-methods-linq-to-dataset.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md b/docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md
new file mode 100644
index 00000000000..b06ed387356
--- /dev/null
+++ b/docs/framework/data/adonet/sorting-with-dataview-linq-to-dataset.md
@@ -0,0 +1,91 @@
+---
+title: "Sorting with DataView (LINQ to DataSet) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 885b3b7b-51c1-42b3-bb29-b925f4f69a6f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Sorting with DataView (LINQ to DataSet)
+特定の条件に基づいてデータを並べ替え、UI コントロールを介してそのデータをクライアントに提供する機能は、データ バインドの重要な特徴です。  <xref:System.Data.DataView> には、データを並べ替え、特定の並べ替え条件に従って並べ替えられたデータ行を返す方法がいくつか用意されています。  文字列ベースの並べ替え機能に加え、<xref:System.Data.DataView> では、並べ替え条件として [!INCLUDE[vbteclinqext](../../../../includes/vbteclinqext-md.md)] 式を使用できます。[!INCLUDE[vbteclinq](../../../../includes/vbteclinq-md.md)] 式を使用すると、文字列ベースの並べ替え処理よりもはるかに複雑で強力な並べ替え処理を実現できます。  このトピックでは、<xref:System.Data.DataView> を使用して並べ替えを行うこの 2 つの方法について説明します。  
+  
+## 並べ替え情報を含むクエリによる DataView の作成  
+ <xref:System.Data.DataView> オブジェクトは [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成できます。  このクエリに <xref:System.Linq.Enumerable.OrderBy%2A> 句、<xref:System.Linq.Enumerable.OrderByDescending%2A> 句、<xref:System.Linq.Enumerable.ThenBy%2A> 句、または <xref:System.Linq.Enumerable.ThenByDescending%2A> 句が含まれている場合、これらの句内の式が、<xref:System.Data.DataView> 内のデータを並べ替えるための基準として使用されます。  たとえば、クエリに `Order By`句と `Then By`  句が含まれている場合、結果の <xref:System.Data.DataView> では、指定された両方の列によってデータが並べ替えられます。  
+  
+ 式ベースの並べ替えは、文字列ベースの並べ替えよりもはるかに強力で複雑な並べ替え機能を提供します。  文字列ベースの並べ替え機能と式ベースの並べ替え機能は、相互に排他的です。  <xref:System.Data.DataView> をクエリから作成した後に文字列ベースの <xref:System.Data.DataView.Sort%2A> を設定した場合、クエリから推論される式ベースの並べ替えはクリアされます \(再設定できません\)。  
+  
+ <xref:System.Data.DataView> のインデックスは、<xref:System.Data.DataView> の作成時に構築されるほか、並べ替えまたはフィルター処理の情報が変更されたときにも構築されます。  最高のパフォーマンスを得るには、<xref:System.Data.DataView> を作成する [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリに並べ替え条件を指定し、後で並べ替え情報を変更しないようにします。  詳細については、「[DataView Performance](../../../../docs/framework/data/adonet/dataview-performance.md)」を参照してください。  
+  
+> [!NOTE]
+>  ほとんどの場合、並べ替えに使用する式は、副作用のない確定的な式である必要があります。  また、並べ替え処理は任意の回数実行されるため、特定の実行回数に依存するロジックが式に含まれないようにしてください。  
+  
+### 例  
+ 次の例では、SalesOrderHeader テーブルに対してクエリを実行し、返された行を発注日順に並べ替えます。次にこのクエリから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView> を <xref:System.Windows.Forms.BindingSource> にバインドします。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQueryOrderBy](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromqueryorderby)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQueryOrderBy](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromqueryorderby)]  
+  
+### 例  
+ 次の例では、SalesOrderHeader テーブルに対してクエリを実行し、返された行を合計支払額順に並べ替えます。次にこのクエリから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView> を <xref:System.Windows.Forms.BindingSource> にバインドします。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQueryOrderBy2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromqueryorderby2)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQueryOrderBy2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromqueryorderby2)]  
+  
+### 例  
+ 次の例では、SalesOrderDetail テーブルに対してクエリを実行し、返された行を注文数量順および販売注文 ID 順に並べ替えます。次にこのクエリから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView> を <xref:System.Windows.Forms.BindingSource> にバインドします。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQueryOrderByThenBy](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromqueryorderbythenby)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQueryOrderByThenBy](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromqueryorderbythenby)]  
+  
+## 文字列ベースの Sort プロパティの使用  
+ <xref:System.Data.DataView> の文字列ベースの並べ替え機能は [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] で動作します。  <xref:System.Data.DataView> を [!INCLUDE[linq_dataset](../../../../includes/linq-dataset-md.md)] クエリから作成した後、<xref:System.Data.DataView.Sort%2A> プロパティを使用して、<xref:System.Data.DataView> の並べ替えを設定できます。  
+  
+ 文字列ベースの並べ替え機能と式ベースの並べ替え機能は、相互に排他的です。  <xref:System.Data.DataView.Sort%2A> プロパティを設定すると、<xref:System.Data.DataView> の作成元のクエリから推論される式ベースの並べ替えはクリアされます。  
+  
+ 文字列ベースの <xref:System.Data.DataView.Sort%2A> フィルター処理の詳細については「[データの並べ替えとフィルター処理](../../../../docs/framework/data/adonet/dataset-datatable-dataview/sorting-and-filtering-data.md)」を参照してください。  
+  
+### 例  
+ 次の例では、<xref:System.Data.DataView> を Contact テーブルから作成した後、姓を降順に並べ替え、名を昇順に並べ替えます。  
+  
+ [!code-csharp[DP DataView Samples#LDVStringSort](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvstringsort)]
+ [!code-vb[DP DataView Samples#LDVStringSort](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvstringsort)]  
+  
+### 例  
+ 次の例では、姓が "S" で始まる連絡先を取得するクエリを Contact テーブルに対して実行します。  このクエリから <xref:System.Data.DataView> が作成され、<xref:System.Windows.Forms.BindingSource> オブジェクトにバインドされます。  
+  
+ [!code-csharp[DP DataView Samples#CreateLDVFromQueryStringSort](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#createldvfromquerystringsort)]
+ [!code-vb[DP DataView Samples#CreateLDVFromQueryStringSort](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#createldvfromquerystringsort)]  
+  
+## 並べ替えのクリア  
+ <xref:System.Data.DataView> の並べ替え情報は、<xref:System.Data.DataView.Sort%2A> プロパティを使用すると、並べ替えが設定された後にクリアできます。  <xref:System.Data.DataView> の並べ替え情報は、2 つの方法でクリアできます。  
+  
+-   <xref:System.Data.DataView.Sort%2A> プロパティを `null` に設定します。  
+  
+-   <xref:System.Data.DataView.Sort%2A> プロパティを空の文字列に設定します。  
+  
+### 例  
+ 次の例では、クエリから <xref:System.Data.DataView> を作成した後、<xref:System.Data.DataView.Sort%2A> プロパティを空の文字列に設定して並べ替えをクリアします。  
+  
+ [!code-csharp[DP DataView Samples#LDVClearSort](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvclearsort)]
+ [!code-vb[DP DataView Samples#LDVClearSort](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvclearsort)]  
+  
+### 例  
+ 次の例では、Contact テーブルから <xref:System.Data.DataView> を作成し、<xref:System.Data.DataView.Sort%2A> プロパティを設定して、連絡先の姓を降順に並べ替えます。  次に、<xref:System.Data.DataView.Sort%2A> プロパティを `null` に設定して並べ替え情報をクリアします。  
+  
+ [!code-csharp[DP DataView Samples#LDVClearSort2](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DP DataView Samples/CS/Form1.cs#ldvclearsort2)]
+ [!code-vb[DP DataView Samples#LDVClearSort2](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DP DataView Samples/VB/Form1.vb#ldvclearsort2)]  
+  
+## 参照  
+ [Data Binding and LINQ to DataSet](../../../../docs/framework/data/adonet/data-binding-and-linq-to-dataset.md)   
+ [Filtering with DataView](../../../../docs/framework/data/adonet/filtering-with-dataview-linq-to-dataset.md)   
+ [Sorting Data](../../../../ocs/visual-basic/programming-guide/concepts/linq/sorting-data.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql-server-connection-pooling.md b/docs/framework/data/adonet/sql-server-connection-pooling.md
new file mode 100644
index 00000000000..285bdb8b0bf
--- /dev/null
+++ b/docs/framework/data/adonet/sql-server-connection-pooling.md
@@ -0,0 +1,141 @@
+---
+title: "SQL Server の接続プール (ADO.NET) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e51d44e-7c4e-4040-9332-f0190fe36f07
+caps.latest.revision: 11
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 11
+---
+# SQL Server の接続プール (ADO.NET)
+通常、データベース サーバーへの接続は、時間のかかるいくつかの手順で構成されています。  ソケットまたは名前付きパイプなどの物理チャネルの確立、サーバーとの最初のハンドシェイクの実行、接続文字列の情報の解析、サーバーによる接続の認証、現在のトランザクションへ参加するための検証などの手順を行う必要があります。  
+  
+ 実際には、ほとんどのアプリケーションで、1 つまたはいくつかの違いがあるだけの構成を接続に使用しています。  つまり、アプリケーションの実行時に、多数の同一の接続が繰り返し開かれ、閉じられているのです。  接続を開くコストを最小化するために、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] は*接続プール*と呼ばれる最適化の手法を使用しています。  
+  
+ 接続プールは、新しく開く必要のある接続の数を減らします。  *プーラー*には、物理的な接続の所有権が保持されます。  プーラーは、任意の接続構成それぞれのアクティブな接続のセットをそのまま保持して、接続を管理します。  この接続の `Open` を呼び出すと、プーラーは、プールに使用可能な接続があるかどうかを確認します。  プールされた接続が使用できる場合は、新しい接続を開く代わりに、プールされた接続を呼び出し元に返します。  アプリケーションが接続で `Close` を呼び出すと、プーラーは接続を閉じる代わりに、プールされたアクティブな接続のセットに接続を返します。  接続がプールに返されると、その接続は、次の `Open` 呼び出しで再度使用できる状態になります。  
+  
+ 同じ構成を持つ接続のみをプールすることができます。  [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] は同時に複数のプールを保持し、各プールでの構成は 1 つです。  接続は接続文字列によってプール内で区別されます。また、統合セキュリティを使用している場合は、Windows ID によっても区別されます。  接続がプールされるかどうかは、その接続がトランザクションに参加しているかどうかにも依存します。  <xref:System.Data.SqlClient.SqlConnection.ChangePassword%2A> を使用すると、<xref:System.Data.SqlClient.SqlCredential> インスタンスは接続プールに影響します。  ユーザー ID とパスワードが同じでも、<xref:System.Data.SqlClient.SqlCredential> のインスタンスごとに異なる接続プールが使用されます。  
+  
+ 接続をプールすると、アプリケーションのパフォーマンスとスケーラビリティを大幅に改善できます。  [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では、接続プールが既定で有効になっています。  明示的に無効にしない限り、プーラーは、アプリケーションで接続が開かれたり、閉じられたりする際に接続を最適化します。  また、接続プール機能の動作を制御する接続文字列修飾子を指定することもできます。  詳細については、このトピックで後述する「接続文字列キーワードによる接続プールの制御」を参照してください。  
+  
+> [!NOTE]
+>  接続プールが有効になっている場合とタイムアウト エラーや他のログイン エラーが発生した場合は、例外がスローされ、それ以降に接続を試みると、5 秒間の "ブロック期間" 中失敗します。  ブロック期間内にアプリケーションが接続を試みると、最初の例外が再度スローされます。  ブロック期間の終了後も失敗が続く場合は、最大 1 分として、新しいブロック期間は前のブロック期間の 2 倍の長さになります。  
+  
+## プールの作成と割り当て  
+ 接続が最初に開かれると、完全一致のアルゴリズムに基づいて接続プールが作成され、接続内の接続文字列に関連付けられます。  各接続プールが別の接続文字列に関連付けられます。  新しい接続が開かれたとき、接続文字列が既存のプールと完全に一致しない場合は、新しいプールが作成されます。  接続は、プロセス、アプリケーション ドメイン、接続文字列、Windows ID \(統合セキュリティを使用している場合\) ごとにプールされます。  また、接続文字列は完全に一致していることが必要です。同じ接続に対してキーワードを異なる順序で指定すると別々にプールされます。  
+  
+ 3 つの新しい <xref:System.Data.SqlClient.SqlConnection> オブジェクトを作成し、2 つの接続プールだけでこの 3 つのオブジェクトを管理する C\# の例を次に示します。  1 番目の接続文字列と 2 番目の接続文字列では、`Initial Catalog` に割り当てる値が異なります。  
+  
+```  
+using (SqlConnection connection = new SqlConnection(  
+  "Integrated Security=SSPI;Initial Catalog=Northwind"))  
+    {  
+        connection.Open();        
+        // Pool A is created.  
+    }  
+  
+using (SqlConnection connection = new SqlConnection(  
+  "Integrated Security=SSPI;Initial Catalog=pubs"))  
+    {  
+        connection.Open();        
+        // Pool B is created because the connection strings differ.  
+    }  
+  
+using (SqlConnection connection = new SqlConnection(  
+  "Integrated Security=SSPI;Initial Catalog=Northwind"))  
+    {  
+        connection.Open();        
+        // The connection string matches pool A.  
+    }  
+```  
+  
+ 接続文字列で `MinPoolSize` が指定されていない、またはゼロに指定されている場合、プール内の接続は、アクティブではない一定の期間後に閉じられます。  ただし、`MinPoolSize` がゼロより大きい値に設定されている場合、接続プールは、`AppDomain` がアンロードされ、プロセスが終了するまで破棄されません。  アクティブでないプールまたは空のプールを維持するためには、最小限のシステム オーバーヘッドが発生します。  
+  
+> [!NOTE]
+>  フェールオーバーなど、致命的なエラーが発生すると、プールは自動的にクリアされます。  
+  
+## 接続の追加  
+ 一意の接続文字列ごとに 1 つの接続プールが作成されます。  プールが作成された段階で、複数の接続オブジェクトが作成されてそのプールへ追加され、最小プール サイズ要件を満たします。  必要に応じて、指定された最大プール サイズ \(既定は 100\) に達するまで、接続がプールへ追加されます。  接続が終了または破棄されると、その接続は解放され、プールに戻されます。  
+  
+ <xref:System.Data.SqlClient.SqlConnection> オブジェクトが要求されると、プールに使用可能な接続がある場合はプールから取得されます。  使用可能な接続とは、サーバーへの有効なリンクを持つ接続のうち、使用中でないか、一致するトランザクション コンテキストを持っているか、またはどのトランザクション コンテキストにも関連付けられていない接続のことです。  
+  
+ 接続プーラーは、接続がプールに解放されたときに接続の再割り当てを行って、接続に対する要求に応えます。  最大プール サイズに達すると、使用可能な接続を取得できなくなり、要求はキューに置かれます。  プーラーは、タイムアウト \(既定は 15 秒\) に達するまで接続の再利用を試みます。  接続がタイムアウトになる前に、プーラーが要求を満たすことができない場合は、例外がスローされます。  
+  
+> [!CAUTION]
+>  接続がプールに返されるようにするために、接続を使い終えたら必ず接続を終了することを強くお勧めします。  この操作は、`Close` オブジェクトの `Dispose` または `Connection` メソッドを使用するか、あるいは C\# の `using` ステートメントまたは `Using` の [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] ステートメント内ですべての接続を開くことによって実行できます。  明示的に終了されていない接続は、プールに追加したり返したりすることができないことがあります。  詳細については、「[using ステートメント](../Topic/using%20Statement%20\(C%23%20Reference\).md)」または「[How to: Dispose of a System Resource](../Topic/How%20to:%20Dispose%20of%20a%20System%20Resource%20\(Visual%20Basic\).md)」\([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の場合\) を参照してください。  
+  
+> [!NOTE]
+>  クラスの `Close` メソッド内で `Dispose`、`Connection`、またはその他のマネージ オブジェクトの `DataReader` または `Finalize` を呼び出さないでください。  終了処理では、クラスに直接所有されているアンマネージ リソースだけを解放してください。  クラスがアンマネージ リソースを所有していない場合は、クラス定義に `Finalize` メソッドを含めないでください。  詳細については、「[Garbage Collection](../../../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+> [!NOTE]
+>  接続が接続プールからフェッチされたり接続プールに返される場合、ログイン イベントとログアウト イベントはサーバーで発生しません。  これは、接続プールに返されるときに接続が実際には終了していないためです。  詳細については、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] オンライン ブックの「[Audit Login イベント クラス](http://msdn2.microsoft.com/library/ms190260.aspx)」および「[Audit Logout イベント クラス](http://msdn2.microsoft.com/library/ms175827.aspx)」を参照してください。  
+  
+## 接続の削除  
+ 接続プール機能は、アイドル状態の時間が約 4\-8 分になったか、サーバーとの接続が切断されたことをプール機能が検出した場合に、プールからの接続を削除します。  サーバーとの通信を試みた後にのみ、切断されたサーバー接続が検出可能になることに注意してください。  接続がサーバーに接続していないことがわかると、その接続は無効としてマークされます。  無効な接続は、閉じられるか、または再利用された場合のみ、接続プールから削除されます。  
+  
+ 既に存在しないサーバーへの接続が存在する場合は、接続プーラーが、その接続が切断されていることをまだ検出せず、無効というマークを付けていない状況のときでも、プールからその接続を削除できます。  この機能は、接続がまだ有効であることを確認するオーバーヘッドによってサーバーへのラウンド トリップが実行されることにより、プーラーの利点が失われてしまうことを防ぐためにあります。  この状況が発生した場合は、接続の使用を最初に試みたときに接続が切断されていることが検出され、例外がスローされます。  
+  
+## プールのクリア  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] 2.0 では、プールをクリアするために、<xref:System.Data.SqlClient.SqlConnection.ClearAllPools%2A> と <xref:System.Data.SqlClient.SqlConnection.ClearPool%2A> という 2 つの新しいメソッドが導入されました。  `ClearAllPools` は、指定されたプロバイダーの接続プールをクリアし、`ClearPool` は、特定の接続に関連付けられた接続プールをクリアします。  これらのメソッドが呼び出されたときに使用中の接続がある場合は、適切にマーク付けされ、  接続が閉じられるとプールに返されずに破棄されます。  
+  
+## トランザクションのサポート  
+ 接続はプールから取り出され、トランザクション コンテキストに基づいて割り当てられます。  接続文字列で `Enlist=false` が指定されていない限り、接続プールは、接続を <xref:System.Transactions.Transaction.Current%2A> コンテキストの中に参加させます。  接続が閉じられ、参加した `System.Transactions` トランザクションと共にプールに返されると、同じ `System.Transactions` トランザクションを持つ接続プールに対する次の要求でも、使用可能であれば同じ接続を返すように接続が保持されます。  このような要求が発行された場合で、なおかつ、プールされた接続が使用できない場合は、プールの非トランザクション部分から接続を取り出して参加させます。  プールのどちらの領域にも使用できる接続がない場合は、新しい接続を作成して参加させます。  
+  
+ 接続が終了すると、その接続は解放されてプールへ返り、さらに、そのトランザクション コンテキストに基づいて特定のサブプールへ返ります。  そのため、分散トランザクションが保留状態である場合を含め、エラーを発生させることなく、開発者が接続を終了させることは可能です。  これにより、分散トランザクションを後でコミットまたは中止できます。  
+  
+## 接続文字列キーワードによる接続プールの制御  
+ `ConnectionString` オブジェクトの <xref:System.Data.SqlClient.SqlConnection> プロパティは、接続プール ロジックの動作を調整するために使用できる接続文字列キーおよび値のペアをサポートします。  詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」を参照してください。  
+  
+## プールの断片化  
+ プールの断片化は、プロセスが終了するまで解放されないプールを多数作成できる Web アプリケーションの多くで一般的な問題です。  これにより、多数の接続が開いたままになってメモリを消費し、パフォーマンスが低下します。  
+  
+### 統合セキュリティによるプールの断片化  
+ 接続は、接続文字列とユーザー ID に基づいてプールされます。  したがって、Web サイトで基本認証または Windows 認証を使用していて、統合セキュリティ ログインを使用している場合は、1 ユーザーにつき 1 つのプールが作成されます。  これによって、単一のユーザーによる後続のデータベース要求のパフォーマンスが向上しますが、他のユーザーによって作成された接続は使用できません。  また、1 ユーザーにつき少なくとも 1 つの接続がデータベース サーバーに存在することになります。  これは、開発者がセキュリティおよび監査要件に対して、特定の Web アプリケーションのアーキテクチャに重点を置く必要があるために起こる副作用です。  
+  
+### 多数のデータベースによるプールの断片化  
+ インターネット サービス プロバイダーの多くは、1 つのサーバー上で複数の Web サイトをホストしています。  インターネット サービス プロバイダーは、1 つのデータベースを使用してフォーム認証ログインを確認し、そのユーザーまたはユーザー グループの特定のデータベースへの接続を開きます。  認証データベースへの接続はプールされ、すべてのユーザーが使用できるようになります。  ただし、各データベースに対して個別の接続のプールが存在するため、サーバーへの接続数が増加します。  
+  
+ これもまた、アプリケーションのデザインの副作用です。  [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] に接続するときにセキュリティを損なうことなく、この副作用を回避する比較的簡単な方法があります。  各ユーザーまたはグループの個別のデータベースに接続する代わりに、サーバー上の同じデータベースに接続してから、[!INCLUDE[tsql](../../../../includes/tsql-md.md)] USE ステートメントを実行して目的のデータベースに変更します。  `master` データベースへの最初の接続を作成し、`databaseName` 文字列変数で指定した目的のデータベースに切り替えるコードを次に示します。  
+  
+```vb  
+' Assumes that command is a valid SqlCommand object and that  
+' connectionString connects to master.  
+    command.Text = "USE DatabaseName"  
+Using connection As New SqlConnection(connectionString)  
+    connection.Open()  
+    command.ExecuteNonQuery()  
+End Using  
+```  
+  
+```csharp  
+// Assumes that command is a SqlCommand object and that  
+// connectionString connects to master.  
+command.Text = "USE DatabaseName";  
+using (SqlConnection connection = new SqlConnection(  
+  connectionString))  
+  {  
+    connection.Open();  
+    command.ExecuteNonQuery();  
+  }  
+```  
+  
+## アプリケーション ロールおよび接続プール  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] システム ストアド プロシージャの呼び出しにより `sp_setapprole` のアプリケーション ロールがアクティブになった後は、その接続のセキュリティ コンテキストをリセットすることはできません。  ただし、プールを有効した場合は、プールに接続が返され、プール接続が再利用されると、エラーが発生します。  詳細については、ナレッジ ベース記事「[OLE DB リソース プーリングでの SQL アプリケーション ロール エラー](http://support.microsoft.com/default.aspx?scid=KB;JA-JP;Q229564)」を参照してください。  
+  
+### アプリケーション ロールに代わる方法  
+ アプリケーション ロールに代わるセキュリティ メカニズムの使用をお勧めします。  詳細については、「[SQL Server でのアプリケーション ロールの作成](../../../../docs/framework/data/adonet/sql/creating-application-roles-in-sql-server.md)」を参照してください。  
+  
+## 参照  
+ [接続プール](../../../../docs/framework/data/adonet/connection-pooling.md)   
+ [SQL Server と ADO.NET](../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET でのパフォーマンス カウンター](../../../../docs/framework/data/adonet/performance-counters.md)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql-server-data-type-mappings.md b/docs/framework/data/adonet/sql-server-data-type-mappings.md
new file mode 100644
index 00000000000..b850934e3d6
--- /dev/null
+++ b/docs/framework/data/adonet/sql-server-data-type-mappings.md
@@ -0,0 +1,69 @@
+---
+title: "SQL Server データ型のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fafdc31a-f435-4cd3-883f-1dfadd971277
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# SQL Server データ型のマッピング
+SQL Server と .NET Framework は異なる型システムを使用しています。  たとえば、.NET Framework の <xref:System.Decimal> 構造体の最大小数点以下桁数は 28 ですが、SQL Server の decimal データ型と numeric データ型の最大小数点以下桁数は 38 です。  データを読み書きするときにデータの整合性を保つために、<xref:System.Data.SqlClient.SqlDataReader> では、.NET Framework の型を返すアクセサー メソッドと共に、<xref:System.Data.SqlTypes> のオブジェクトを返す SQL Server 固有の型指定されたアクセサー メソッドを公開しています。  SQL Server の型と .NET Framework の型は、両方とも <xref:System.Data.DbType> および <xref:System.Data.SqlDbType> クラスの列挙によって表されます。これらは <xref:System.Data.SqlClient.SqlParameter> データ型を指定するときに使用できます。  
+  
+ 推論される [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型、<xref:System.Data.DbType> 列挙と <xref:System.Data.SqlDbType> 列挙、および <xref:System.Data.SqlClient.SqlDataReader> のアクセサー メソッドを次の表に示します。  
+  
+|SQL Server データベース エンジンの型|.NET Framework 型|SqlDbType 列挙|SqlDataReader SqlTypes の型指定されたアクセサー|DbType 列挙|SqlDataReader DbType の型指定されたアクセサー|  
+|------------------------------|----------------------|------------------|-----------------------------------------|---------------|---------------------------------------|  
+|bigint|Int64|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlInt64%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetInt64%2A>|  
+|バイナリ|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBinary%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|ビット|Boolean|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBoolean%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBoolean%2A>|  
+|char|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>,<br /><br /> <xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|date<br /><br /> \(SQL Server 2008 以降\)|DateTime|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDateTime%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|  
+|datetime|DateTime|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDateTime%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|  
+|datetime2<br /><br /> \(SQL Server 2008 以降\)|DateTime|<xref:System.Data.SqlDbType>|なし|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|  
+|datetimeoffset<br /><br /> \(SQL Server 2008 以降\)|DateTimeOffset|<xref:System.Data.SqlDbType>|none|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTimeOffset%2A>|  
+|decimal|Decimal \(10 進数型\)|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDecimal%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDecimal%2A>|  
+|FILESTREAM 属性 \(varbinary\(max\)\)|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBytes%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|float|Double \(倍精度浮動小数点型\)|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDouble%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDouble%2A>|  
+|イメージ|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBinary%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|int|Int32|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlInt32%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetInt32%2A>|  
+|money|Decimal \(10 進数型\)|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlMoney%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDecimal%2A>|  
+|nchar|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|ntext|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|数値|Decimal \(10 進数型\)|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDecimal%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDecimal%2A>|  
+|nvarchar|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|実数|Single|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlSingle%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetFloat%2A>|  
+|rowversion|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBinary%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|smalldatetime|DateTime|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlDateTime%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|  
+|smallint|Int16|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlInt16%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetInt16%2A>|  
+|smallmoney|Decimal \(10 進数型\)|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlMoney%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDecimal%2A>|  
+|sql\_variant|Object\*|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlValue%2A> \*|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetValue%2A> \*|  
+|テキスト|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|時間<br /><br /> \(SQL Server 2008 以降\)|TimeSpan|<xref:System.Data.SqlDbType>|none|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|  
+|タイムスタンプ|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBinary%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|tinyint|Byte|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlByte%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetByte%2A>|  
+|uniqueidentifier|Guid|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlGuid%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetGuid%2A>|  
+|varbinary|Byte\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlBinary%2A>|<xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetBytes%2A>|  
+|varchar|String<br /><br /> Char\[\]|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|<xref:System.Data.DbType>, <xref:System.Data.DbType>|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A><br /><br /> <xref:System.Data.SqlClient.SqlDataReader.GetChars%2A>|  
+|xml|Xml|<xref:System.Data.SqlDbType>|<xref:System.Data.SqlClient.SqlDataReader.GetSqlXml%2A>|<xref:System.Data.DbType>|none|  
+  
+ \* `sql_variant` の基になる型がわかっている場合は、特定の型指定されたアクセサーを使用してください。  
+  
+## [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)]オンライン ブックのリファレンス  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] データ型の詳細については、「[データ型 \(データベース エンジン\)](http://go.microsoft.com/fwlink/?LinkID=107468)」を参照してください。  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [ADO.NET でのデータ型のマッピング](../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [パラメーターおよびパラメーター データ型の構成](../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql-server-schema-collections.md b/docs/framework/data/adonet/sql-server-schema-collections.md
new file mode 100644
index 00000000000..88e097b2051
--- /dev/null
+++ b/docs/framework/data/adonet/sql-server-schema-collections.md
@@ -0,0 +1,265 @@
+---
+title: "SQL Server スキーマ コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6403cc3-d78b-4f85-bab1-ada7a3446ec5
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server スキーマ コレクション
+Microsoft .NET Framework Data Provider for SQL Server は、共通のスキーマ コレクションに加えて追加のスキーマ コレクションをサポートしています。  スキーマ コレクションは、使用している SQL Server のバージョンによって多少異なります。  サポートされるスキーマ コレクションの一覧を確認するには、引数を指定しないで、またはスキーマ コレクション名に "MetaDataCollections" を指定して **GetSchema** メソッドを呼び出します。  これにより、サポートされるスキーマ コレクションの一覧、それぞれがサポートする制限数、および使用する識別子部分の数と共に、<xref:System.Data.DataTable> が返されます。  
+  
+## Databases  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|database\_name|String|データベース名。|  
+|Dbid|Int16|データベース ID。|  
+|create\_date|DateTime|データベースの作成日。|  
+  
+## Foreign Keys  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|constraint\_catalog|String|制約が属するカタログ。|  
+|constraint\_schema|String|制約を含むスキーマ。|  
+|constraint\_name|String|名前。|  
+|table\_catalog|String|制約が含まれるテーブル名。|  
+|table\_schema|String|テーブルを含むスキーマ。|  
+|table\_name|String|テーブル名|  
+|constraint\_type|String|制約の型。  "FOREIGN KEY" だけが許可されています。|  
+|is\_deferrable|String|制約を遅延可能にするかどうかを指定します。  NO が返されます。|  
+|initially\_deferred|String|制約を最初に遅延可能にするかどうかを指定します。  NO が返されます。|  
+  
+## Indexes  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|constraint\_catalog|String|インデックスが属するカタログ。|  
+|constraint\_schema|String|インデックスを含むスキーマ。|  
+|constraint\_name|String|インデックス名。|  
+|table\_catalog|String|インデックスが関連付けられているテーブル名。|  
+|table\_schema|String|インデックスが関連付けられているテーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+  
+### Indexes \(SQL Server 2008\)  
+ .NET Framework 3.5 SP1 および SQL Server 2008 以降では、新しい空間型、ファイルストリーム、およびスパース列をサポートするために、以下の列が Indexes スキーマ コレクションに追加されています。  これらの列は、以前のバージョンの .NET Framework および SQL Server ではサポートされません。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|type\_desc|String|インデックスの種類。次のいずれかの値になります。<br /><br /> -   HEAP<br />-   CLUSTERED<br />-   NONCLUSTERED<br />-   XML<br />-   SPATIAL|  
+  
+## IndexColumns  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|constraint\_catalog|String|インデックスが属するカタログ。|  
+|constraint\_schema|String|インデックスを含むスキーマ。|  
+|constraint\_name|String|インデックス名。|  
+|table\_catalog|String|インデックスが関連付けられているテーブル名。|  
+|table\_schema|String|インデックスが関連付けられているテーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+|column\_name|String|インデックスが関連付けられている列名。|  
+|ordinal\_position|Int32|列の位置を示す序数。|  
+|KeyType|UInt16|オブジェクトの型。|  
+  
+## 手順  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|specific\_catalog|String|カタログ固有の名前。|  
+|specific\_schema|String|スキーマ固有の名前。|  
+|specific\_name|String|カタログ固有の名前。|  
+|routine\_catalog|String|ストアド プロシージャが属するカタログ。|  
+|routine\_schema|String|ストアド プロシージャを含むスキーマ。|  
+|routine\_name|String|ストアド プロシージャの名前。|  
+|routine\_type|String|ストアド プロシージャには PROCEDURE が返され、関数には FUNCTION が返されます。|  
+|created|DateTime|プロシージャが作成された日時。|  
+|last\_altered|DateTime|プロシージャの最終更新日時。|  
+  
+## Procedure Parameters  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|specific\_catalog|String|このパラメーターを受け取るプロシージャのカタログ名。|  
+|specific\_schema|String|このパラメーターを受け取るプロシージャを含むスキーマ。|  
+|specific\_name|String|このパラメーターを受け取るとるプロシージャ名。|  
+|ordinal\_position|Int16|パラメーターの位置を示す 1 から始まる序数。  プロシージャの戻り値については 0 になります。|  
+|parameter\_mode|String|入力パラメーターでは IN が返され、出力パラメーターでは OUT が返され、I\/O パラメーターでは INOUT が返されます。|  
+|is\_result|String|プロシージャの結果が関数を表す場合には YES が返されます。  その他の場合は NO が返されます。|  
+|as\_locator|String|ロケーターとして宣言された場合は YES が返されます。  その他の場合は NO が返されます。|  
+|parameter\_name|String|パラメーターの名前。  関数の戻り値に相当する場合は NULL になります。|  
+|data\_type|String|システムにより提供されるデータ型。|  
+|character\_maximum\_length|Int32|バイナリまたは文字データ型の文字列の最大長。  その他の場合は NULL が返されます。|  
+|character\_octet\_length|Int32|バイナリまたは文字データ型の最大バイト数。  その他の場合は NULL が返されます。|  
+|collation\_catalog|String|パラメーター照合のカタログ名。  文字型の 1 つでない場合は、NULL が返されます。|  
+|collation\_schema|String|常に NULL が返されます。|  
+|collation\_name|String|パラメーター照合の名前。  文字型の 1 つでない場合は、NULL が返されます。|  
+|character\_set\_catalog|String|パラメーターの文字セットのカタログ名。  文字型の 1 つでない場合は、NULL が返されます。|  
+|character\_set\_schema|String|常に NULL が返されます。|  
+|character\_set\_name|String|パラメーターの文字セット名。  文字型の 1 つでない場合は、NULL が返されます。|  
+|numeric\_precision|Byte|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数。  その他の場合は NULL が返されます。|  
+|numeric\_precision\_radix|Int16|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数の基数。  その他の場合は NULL が返されます。|  
+|numeric\_scale|Int32|数値データの概数、正確な数値データ、整数データ、または通貨データの桁数。  その他の場合は NULL が返されます。|  
+|datetime\_precision|Int16|パラメーターの型が datetime または smalldatetime である場合の秒数の小数部の有効桁数。  その他の場合は NULL が返されます。|  
+|interval\_type|String|NULL。  将来 SQL Server で使用するために予約されています。|  
+|interval\_precision|Int16|NULL。  将来 SQL Server で使用するために予約されています。|  
+  
+## \[テーブル\]  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|table\_catalog|String|テーブルのカタログ。|  
+|table\_schema|String|テーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+|table\_type|String|テーブルの型。  VIEW または BASE TABLE のいずれかです。|  
+  
+## 列  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|table\_catalog|String|テーブルのカタログ。|  
+|table\_schema|String|テーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+|column\_name|String|列名。|  
+|ordinal\_position|Int16|列の識別番号。|  
+|column\_default|String|列の既定値。|  
+|is\_nullable|String|列に NULL 値が許容されるかどうかを指定します。  この列に NULL が許容される場合は、YES が返されます。  その他の場合は NO が返されます。|  
+|data\_type|String|システムにより提供されるデータ型。|  
+|character\_maximum\_length|Int32 – Sql8、Int16 – Sql7|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大文字列長。  その他の場合は NULL が返されます。|  
+|character\_octet\_length|Int32 – SQL8、Int16 – Sql7|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大バイト長。  その他の場合は NULL が返されます。|  
+|numeric\_precision|Unsigned Byte|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数。  その他の場合は NULL が返されます。|  
+|numeric\_precision\_radix|Int16|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数の基数。  その他の場合は NULL が返されます。|  
+|numeric\_scale|Int32|数値データの概数、正確な数値データ、整数データ、または通貨データの桁数。  その他の場合は NULL が返されます。|  
+|datetime\_precision|Int16|日付時刻データ型および SQL\-92 interval データ型のサブタイプ コード。  その他のデータ型に対しては NULL が返されます。|  
+|character\_set\_catalog|String|列が文字データ型またはテキスト データ型である場合は、文字セットがあるデータベースを示すマスターが返されます。  その他の場合は NULL が返されます。|  
+|character\_set\_schema|String|常に NULL が返されます。|  
+|character\_set\_name|String|この列が文字データ型またはテキスト データ型である場合、文字セットの一意の名前が返されます。  その他の場合は NULL が返されます。|  
+|collation\_catalog|String|列が文字データ型またはテキスト データ型である場合は、照合順序が定義されているデータベースを示すマスターが返されます。  その他の場合、この列は NULL になります。|  
+  
+### Columns \(SQL Server 2008\)  
+ .NET Framework version 3.5 SP1 および SQL Server 2008 以降では、新しい空間型、filestream、およびスパース列をサポートするために、以下の列が Columns スキーマ コレクションに追加されています。  これらの列は、以前のバージョンの .NET Framework および SQL Server ではサポートされません。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|IS\_FILESTREAM|String|列に FILESTREAM 属性がある場合は YES。<br /><br /> 列には FILESTREAM 属性がない場合は NO。|  
+|IS\_SPARSE|String|列がスパース列である場合は YES。<br /><br /> 列がスパース列でない場合は NO。|  
+|IS\_COLUMN\_SET|String|列が列セットの列である場合は YES。<br /><br /> 列が列セットの列でない場合は NO。|  
+  
+### AllColumns \(SQL Server 2008\)  
+ .NET Framework version 3.5 SP1 および SQL Server 2008 以降では、スパース列をサポートするために、AllColumns スキーマ コレクションが追加されています。  AllColumns は、以前のバージョンの .NET Framework および SQL Server ではサポートされません。  
+  
+ AllColumns の制限と生成される DataTable スキーマは、Columns スキーマ コレクションと同じです。  相違は、Columns スキーマ コレクションに含まれていない列セットの列が AllColumns に含まれている点のみです。  次の表では、それらの列について説明します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|table\_catalog|String|テーブルのカタログ。|  
+|table\_schema|String|テーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+|column\_name|String|列名。|  
+|ordinal\_position|Int16|列の識別番号。|  
+|column\_default|String|列の既定値。|  
+|is\_nullable|String|列に NULL 値が許容されるかどうかを指定します。  この列に NULL が許容される場合は、YES が返されます。  その他の場合は NO が返されます。|  
+|data\_type|String|システムにより提供されるデータ型。|  
+|character\_maximum\_length|Int32|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大文字列長。  その他の場合は NULL が返されます。|  
+|character\_octet\_length|Int32|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大バイト長。  その他の場合は NULL が返されます。|  
+|numeric\_precision|Unsigned Byte|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数。  その他の場合は NULL が返されます。|  
+|numeric\_precision\_radix|Int16|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数の基数。  その他の場合は NULL が返されます。|  
+|numeric\_scale|Int32|数値データの概数、正確な数値データ、整数データ、または通貨データの桁数。  その他の場合は NULL が返されます。|  
+|datetime\_precision|Int16|日付時刻データ型および SQL\-92 interval データ型のサブタイプ コード。  その他のデータ型に対しては NULL が返されます。|  
+|character\_set\_catalog|String|列が文字データ型またはテキスト データ型である場合は、文字セットがあるデータベースを示すマスターが返されます。  その他の場合は NULL が返されます。|  
+|character\_set\_schema|String|常に NULL が返されます。|  
+|character\_set\_name|String|この列が文字データ型またはテキスト データ型である場合、文字セットの一意の名前が返されます。  その他の場合は NULL が返されます。|  
+|collation\_catalog|String|列が文字データ型またはテキスト データ型である場合は、照合順序が定義されているデータベースを示すマスターが返されます。  その他の場合、この列は NULL になります。|  
+|IS\_FILESTREAM|String|列に FILESTREAM 属性がある場合は YES。<br /><br /> 列には FILESTREAM 属性がない場合は NO。|  
+|IS\_SPARSE|String|列がスパース列である場合は YES。<br /><br /> 列がスパース列でない場合は NO。|  
+|IS\_COLUMN\_SET|String|列が列セットの列である場合は YES。<br /><br /> 列が列セットの列でない場合は NO。|  
+  
+### ColumnSetColumns \(SQL Server 2008\)  
+ .NET Framework version 3.5 SP1 および SQL Server 2008 以降では、スパース列をサポートするために、ColumnSetColumns スキーマ コレクションが追加されています。  ColumnSetColumns は、以前のバージョンの .NET Framework および SQL Server ではサポートされません。  ColumnSetColumns スキーマ コレクションは、列セット内のすべての列のスキーマを返します。  次の表では、それらの列について説明します。  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|table\_catalog|String|テーブルのカタログ。|  
+|table\_schema|String|テーブルを含むスキーマ。|  
+|table\_name|String|テーブル名。|  
+|column\_name|String|列名。|  
+|ordinal\_position|Int16|列の識別番号。|  
+|column\_default|String|列の既定値。|  
+|is\_nullable|String|列に NULL 値が許容されるかどうかを指定します。  この列に NULL が許容される場合は、YES が返されます。  その他の場合は NO が返されます。|  
+|data\_type|String|システムにより提供されるデータ型。|  
+|character\_maximum\_length|Int32|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大文字列長。  その他の場合は NULL が返されます。|  
+|character\_octet\_length|Int32|バイナリ データ、文字データ、またはテキストおよびイメージ データの最大バイト長。  その他の場合は NULL が返されます。|  
+|numeric\_precision|Unsigned Byte|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数。  その他の場合は NULL が返されます。|  
+|numeric\_precision\_radix|Int16|数値データの概数、正確な数値データ、整数データ、または通貨データの有効桁数の基数。  その他の場合は NULL が返されます。|  
+|numeric\_scale|Int32|数値データの概数、正確な数値データ、整数データ、または通貨データの桁数。  その他の場合は NULL が返されます。|  
+|datetime\_precision|Int16|日付時刻データ型および SQL\-92 interval データ型のサブタイプ コード。  その他のデータ型に対しては NULL が返されます。|  
+|character\_set\_catalog|String|列が文字データ型またはテキスト データ型である場合は、文字セットがあるデータベースを示すマスターが返されます。  その他の場合は NULL が返されます。|  
+|character\_set\_schema|String|常に NULL が返されます。|  
+|character\_set\_name|String|この列が文字データ型またはテキスト データ型である場合、文字セットの一意の名前が返されます。  その他の場合は NULL が返されます。|  
+|collation\_catalog|String|列が文字データ型またはテキスト データ型である場合は、照合順序が定義されているデータベースを示すマスターが返されます。  その他の場合、この列は NULL になります。|  
+|IS\_FILESTREAM|String|列に FILESTREAM 属性がある場合は YES。<br /><br /> 列には FILESTREAM 属性がない場合は NO。|  
+|IS\_SPARSE|String|列がスパース列である場合は YES。<br /><br /> 列がスパース列でない場合は NO。|  
+|IS\_COLUMN\_SET|String|列が列セットの列である場合は YES。<br /><br /> 列が列セットの列でない場合は NO。|  
+  
+## Users  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|uid|Int16|このデータベースで一意のユーザー ID。  1 はデータベースの所有者です。|  
+|name|String|このデータベースで一意のユーザー名またはグループ名。|  
+|createdate|DateTime|アカウントが追加された日付。|  
+|updatedate|DateTime|アカウントが最後に変更された日付。|  
+  
+## ビュー  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|table\_catalog|String|ビューのカタログ。|  
+|table\_schema|String|ビューを含むスキーマ。|  
+|table\_name|String|ビューの名前。|  
+|check\_option|String|WITH CHECK OPTION の型。  元のビューが WITH CHECK OPTION を使用して作成されている場合は CASCADE になります。  その他の場合は NONE が返されます。|  
+|is\_updatable|String|ビューが更新可能であるかどうかを指定します。  常に NO が返されます。|  
+  
+## ViewColumns  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|view\_catalog|String|ビューのカタログ。|  
+|view\_schema|String|ビューを含むスキーマ。|  
+|view\_name|String|ビューの名前。|  
+|table\_catalog|String|このビューに関連付けられているテーブルのカタログ。|  
+|table\_schema|String|このビューに関連付けられているテーブルを含むスキーマ。|  
+|table\_name|String|ビューに関連付けられているテーブルの名前。  ベース テーブルになります。|  
+|column\_name|String|列名。|  
+  
+## UserDefinedTypes  
+  
+|ColumnName|DataType|説明|  
+|----------------|--------------|--------|  
+|assembly\_name|String|アセンブリのファイル名。|  
+|UDT\_name|String|アセンブリのクラス名。|  
+|version\_major|Object|メジャー バージョン番号。|  
+|version\_minor|Object|マイナー バージョン番号。|  
+|version\_build|Object|ビルド番号。|  
+|version\_revision|Object|リビジョン番号。|  
+|Culture\_info|Object|この UDT に関連付けられているカルチャ情報。|  
+|Public\_key|Object|このアセンブリで使用される公開キー。|  
+|Is\_fixed\_length|Boolean|型の長さを max\_length と常に同じにするかどうかを指定します。|  
+|max\_length|Int16|型の最大長 \(バイト単位\)。|  
+|permission\_set\_desc|String|アセンブリのアクセス許可セット\/セキュリティ レベルのフレンドリ名。|  
+|create\_date|DateTime|アセンブリが作成\/登録された日付。|  
+  
+## 参照  
+ [データベース スキーマ情報の取得](../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/TOC.md b/docs/framework/data/adonet/sql/TOC.md
new file mode 100644
index 00000000000..bf845bbe68d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/TOC.md
@@ -0,0 +1,66 @@
+# [ASP.NET アプリケーションでの SqlDependency](sqldependency-in-an-aspnet-app.md)
+# [CLR ストアド プロシージャ](clr-stored-procedures.md)
+# [トランザクションとバルク コピー操作](transaction-and-bulk-copy-operations.md)
+# [待機ハンドルを使用した ASP.NET アプリケーション](aspnet-apps-using-wait-handles.md)
+# [NULL 値の処理](handling-null-values.md)
+# [SQL Server でのストアド プロシージャの署名](signing-stored-procedures-in-sql-server.md)
+# [非同期操作](asynchronous-operations.md)
+# [SqlDependency を使用した変更の検出](detecting-changes-with-sqldependency.md)
+# [コンテキスト接続](the-context-connection.md)
+# [SQL Server のバイナリ データと大きな値のデータ](sql-server-binary-and-large-value-data.md)
+# [SQL Server での安全な動的 SQL の作成](writing-secure-dynamic-sql-in-sql-server.md)
+# [CLR トリガー](clr-triggers.md)
+# [SQL Server のインスタンスの列挙 (ADO.NET)](enumerating-instances-of-sql-server.md)
+# [SQL Server での借用を使用した権限のカスタマイズ](customizing-permissions-with-impersonation-in-sql-server.md)
+# [SQL XML 列値](sql-xml-column-values.md)
+# [バルク コピー サンプルのセットアップ](bulk-copy-example-setup.md)
+# [SQL Server の承認とアクセス許可](authorization-and-permissions-in-sql-server.md)
+# [SQL Server Express のセキュリティ](sql-server-express-security.md)
+# [SqlClient による LocalDB のサポート](sqlclient-support-for-localdb.md)
+# [複数のアクティブな結果セット (MARS)](multiple-active-result-sets-mars.md)
+# [SQL Server の共通言語ランタイム統合](sql-server-common-language-runtime-integration.md)
+# [SQL Server と ADO.NET](index.md)
+# [FILESTREAM データ](filestream-data.md)
+# [ADO.NET における SQL Server データ操作](sql-server-data-operations.md)
+# [SQL Server セキュリティの概要](overview-of-sql-server-security.md)
+# [コールバックを使用した Windows アプリケーション](windows-applications-using-callbacks.md)
+# [GUID と uniqueidentifier 値の比較](comparing-guid-and-uniqueidentifier-values.md)
+# [SQL Server における行レベルのアクセス許可の付与](granting-row-level-permissions-in-sql-server.md)
+# [クエリ通知の有効化](enabling-query-notifications.md)
+# [CLR ユーザー定義型](clr-user-defined-types.md)
+# [SQL Server における XML データ](xml-data-in-sql-server.md)
+# [SqlTypes と DataSet](sqltypes-and-the-dataset.md)
+# [SQL Server のセキュリティ](sql-server-security.md)
+# [ADO.NET での大きい値 (max) データの変更](modifying-large-value-max-data.md)
+# [SQL Server のデータベース ミラーリング](database-mirroring-in-sql-server.md)
+# [SQL Server でのデータの暗号化](data-encryption-in-sql-server.md)
+# [SQL Server でのバルク コピー操作](bulk-copy-operations-in-sql-server.md)
+# [SQL Server データ型と ADO.NET](sql-server-data-types.md)
+# [日付と時刻のデータ](date-and-time-data.md)
+# [認証](authentication-in-sql-server.md)
+# [高可用性障害復旧のための SqlClient サポート](sqlclient-support-for-high-availability-disaster-recovery.md)
+# [バルク コピー操作の単一実行](single-bulk-copy-operations.md)
+# [複数のバルク コピー操作](multiple-bulk-copy-operations.md)
+# [複数のアクティブな結果セット (MARS) の有効化](enabling-multiple-active-result-sets.md)
+# [SQL Server の CLR 統合の概要](introduction-to-sql-server-clr-integration.md)
+# [SQL Server のサーバー ロールとデータベース ロール](server-and-database-roles-in-sql-server.md)
+# [データの操作](manipulating-data.md)
+# [コンソール アプリケーションでのポーリング](polling-in-console-applications.md)
+# [SQL Server のインプロセス固有の ADO.NET の動作](sql-server-in-process-specific-behavior-of-adonet.md)
+# [SQL Server の CLR 統合セキュリティ](clr-integration-security-in-sql-server.md)
+# [SQL Server でのスナップショット分離](snapshot-isolation-in-sql-server.md)
+# [SQL Server のプロバイダー統計情報](provider-statistics-for-sql-server.md)
+# [大きな UDT](large-udts.md)
+# [テーブル値パラメーター](table-valued-parameters.md)
+# [ファイルからの画像の挿入](inserting-an-image-from-a-file.md)
+# [パラメーターとしての XML 値の指定](specifying-xml-values-as-parameters.md)
+# [SQL Server の機能と ADO.NET](sql-server-features-and-adonet.md)
+# [SQL Server でのアプリケーション ロールの作成](creating-application-roles-in-sql-server.md)
+# [SQL Server における所有権とユーザーとスキーマの分離](ownership-and-user-schema-separation-in-sql-server.md)
+# [CLR ユーザー定義関数](clr-user-defined-functions.md)
+# [SqlCommand の実行と SqlNotificationRequest](sqlcommand-execution-with-a-sqlnotificationrequest.md)
+# [SQL Server での複数データベースにまたがるアクセスの有効化](enabling-cross-database-access-in-sql-server.md)
+# [SQL Server のクエリ通知](query-notifications-in-sql-server.md)
+# [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](managing-permissions-with-stored-procedures-in-sql-server.md)
+# [SQL Server におけるアプリケーション セキュリティのシナリオ](application-security-scenarios-in-sql-server.md)
+# [SQL Server Express ユーザー インスタンス](sql-server-express-user-instances.md)
diff --git a/docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md b/docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md
new file mode 100644
index 00000000000..c5a077cc6e9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md
@@ -0,0 +1,70 @@
+---
+title: "SQL Server におけるアプリケーション セキュリティのシナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0164f3a4-406e-4693-bec3-03c8e18b46d7
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server におけるアプリケーション セキュリティのシナリオ
+安全な SQL Server クライアント アプリケーションを作成するにあたって、絶対に正しいという唯一の方法はありません。  アプリケーションの要件、配置環境、およびユーザー数は、アプリケーションごとに異なります。  配置した当初は十分なセキュリティが確保されたアプリケーションも、時間の経過と共に安全性が低下してゆくことが考えられます。  将来発生する脅威を正確に予測することは不可能です。  
+  
+ SQL Server は、製品として何度もバージョン アップを重ねながら、開発者が安全なデータベース アプリケーションを作成できるように、最新のセキュリティ機能を取り入れつつ進化してきました。  しかし、普遍的なセキュリティがない以上、継続的に監視し更新してゆくことがどうしても必要になります。  
+  
+## 一般的な脅威  
+ 開発者は、セキュリティ上の脅威とそれに対抗するツール、および、セキュリティ ホールを作らないようにするにはどうすればよいかを理解しておく必要があります。  セキュリティは鎖のようなものと考えることができます。つまり、1 か所でも弱い部分があると、全体の強度が損なわれるということです。  以下は、このセクションの各トピックで詳しく取り上げているセキュリティ上の一般的な脅威を一覧にしたものです。  
+  
+### SQL インジェクション  
+ SQL インジェクションとは、悪意のあるユーザーによって、有効な入力データの代わりに Transact\-SQL ステートメントが入力されることをいいます。  この入力データが検証を経ることなくサーバーに直接渡され、なおかつ、挿入されたコードをアプリケーションが気付かずに実行した場合、その攻撃によってデータが破損または破壊される可能性があります。  SQL Server インジェクション攻撃を阻止する方法としては、ストアド プロシージャやパラメーター化コマンドを使用する方法のほか、動的 SQL を実行できないようにしたり、すべてのユーザーの権限を制限したりすることが考えられます。  
+  
+### 権限の昇格  
+ 権限の昇格攻撃は、ユーザーが、所有者や管理者など、信頼されたアカウントの権限で振る舞うことのできる状況で発生します。  大切なことは、常に最小限の特権しか持たないユーザー アカウントで実行するようにし、必要な権限以外は割り当てないようにすることです。  コードの実行に、管理者アカウントや所有者アカウントを使用することは避けてください。  このようにすることで、仮に攻撃を阻止できなかった場合でも、損害の範囲を最小限に抑えることができます。  より高い権限が要求される作業を行う場合は、その期間だけプロシージャの署名や権限の借用を使用するようにします。  証明書を使ってストアド プロシージャに署名したり、権限の借用を使用して一時的に権限を割り当てたりできます。  
+  
+### プローブと情報取得  
+ プローブ攻撃には、アプリケーションから生成されるエラー メッセージを調べてセキュリティ上の脆弱性を探す手法がよく用いられます。  すべてのプロシージャ コードにはエラー処理を実装し、SQL Server のエラー情報がエンド ユーザーに返されないようにしてください。  
+  
+### 認証  
+ SQL Server ログインを使用したアプリケーションでは、ユーザーによって入力されたデータから実行時に接続文字列を構築している場合、接続文字列のインジェクション攻撃を受ける可能性があります。  接続文字列をチェックして、有効なキーワードの組み合わせが使用されているかどうかを調べないと、攻撃者によって余分な文字が挿入され、機密データなど、サーバー上のリソースへのアクセスを許してしまうことも考えられます。  できるだけ Windows 認証を使用してください。  SQL Server ログインを使用する必要がある場合は、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> を使用して接続文字列を実行時に作成および検証するようにします。  
+  
+### パスワード  
+ 権限を持ったユーザーのパスワードを侵入者が入手するか、パスワードを推測できた場合、多くの場合、攻撃を許す結果になります。  パスワードは侵入者に対する防御の最前線であるため、システムのセキュリティにとって強力なパスワードを設定することは不可欠です。  混合モード認証のパスワード ポリシーを作成して適用するようにしてください。  
+  
+ Windows 認証を使用する場合でも、`sa` アカウントに必ず強力なパスワードを割り当てます。  
+  
+## このセクションの内容  
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)  
+ ストアド プロシージャを使用して権限を管理したり、データ アクセスを制御したりする方法について説明します。  ストアド プロシージャは、セキュリティ上のさまざまな脅威に対抗する手段として効果的です。  
+  
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)  
+ ストアド プロシージャを使用して、安全な動的 SQL を作成する手法について説明します。  
+  
+ [SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)  
+ 証明書を使ってストアド プロシージャに署名することで、ユーザーが直接アクセスしなくてもデータを利用できるようにする方法について説明します。  これにより、操作を直接実行するための権限が呼び出し元になくても、ストアド プロシージャで操作を実行できます。  
+  
+ [SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)  
+ EXECUTE AS 句を使って他のユーザーの権限を借用する方法について説明します。  権限の借用では、呼び出し元の実行コンテキストが、特定のユーザーの実行コンテキストに切り替えられます。  
+  
+ [SQL Server における行レベルのアクセス許可の付与](../../../../../docs/framework/data/adonet/sql/granting-row-level-permissions-in-sql-server.md)  
+ データ アクセスを制限する行レベルの権限を実装する方法について説明します。  
+  
+ [SQL Server でのアプリケーション ロールの作成](../../../../../docs/framework/data/adonet/sql/creating-application-roles-in-sql-server.md)  
+ アプリケーション ロールの機能について説明します。  
+  
+ [SQL Server での複数データベースにまたがるアクセスの有効化](../../../../../docs/framework/data/adonet/sql/enabling-cross-database-access-in-sql-server.md)  
+ セキュリティを損なうことなく複数データベースにまたがるアクセスを有効にする方法について説明します。  
+  
+## 参照  
+ [SQL Server のセキュリティ](../../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/aspnet-apps-using-wait-handles.md b/docs/framework/data/adonet/sql/aspnet-apps-using-wait-handles.md
new file mode 100644
index 00000000000..ef1c4e6a56e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/aspnet-apps-using-wait-handles.md
@@ -0,0 +1,596 @@
+---
+title: "待機ハンドルを使用した ASP.NET アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f588597a-49de-4206-8463-4ef377e112ff
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 待機ハンドルを使用した ASP.NET アプリケーション
+アプリケーションが一度に 1 つの非同期操作しか処理しない場合は、コールバック モデルとポーリング モデルが非同期操作の処理に役立ちます。  Wait モデルを使用することで、複数の非同期操作をより柔軟に処理できます。  Wait モデルには Wait \(Any\) モデルと Wait \(All\) モデルの 2 つがあり、モデルの実装に使用される <xref:System.Threading.WaitHandle> メソッドに指定されます。  
+  
+ これらの Wait モデルを使用するには、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery%2A> メソッド、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteReader%2A> メソッド、または <xref:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader%2A> メソッドから返される <xref:System.IAsyncResult> オブジェクトの <xref:System.IAsyncResult.AsyncWaitHandle%2A> プロパティを使用する必要があります。  <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドの場合も <xref:System.Threading.WaitHandle.WaitAll%2A> メソッドの場合も、1 つの配列を構成する複数の <xref:System.Threading.WaitHandle> オブジェクトを引数として送信する必要があります。  
+  
+ いずれの Wait メソッドも非同期操作を監視し、操作の完了を待機します。  <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドは、いずれか 1 つの操作の完了またはタイムアウトを待機します。  特定の操作が完了したことがわかれば、その結果を処理し、引き続き次の操作の完了またはタイムアウトを待機できます。  <xref:System.Threading.WaitHandle.WaitAll%2A> メソッドは、<xref:System.Threading.WaitHandle> インスタンスの配列に含まれているすべてのプロセスが完了するかタイムアウトするまで次の操作の監視を開始しません。  
+  
+ Wait モデルの利点が活かされるのは、ある程度の長さの複数の操作を別々のサーバーで実行する必要があるときや、サーバーがすべてのクエリを同時に処理できるほど強力であるときです。  次に示す例では、3 つのクエリが、さまざまな長さの WAITFOR コマンドを小規模な SELECT クエリに追加することで、長いプロセスをエミュレートします。  
+  
+## 例 : Wait \(Any\) モデル  
+ 次の例は Wait \(Any\) モデルを示しています。  3 つの非同期プロセスが開始されると、<xref:System.Threading.WaitHandle.WaitAny%2A> メソッドが呼び出され、3 つのプロセスのいずれかの完了を待機します。  プロセスが 1 つ完了するたびに <xref:System.Data.SqlClient.SqlCommand.EndExecuteReader%2A> メソッドが呼び出され、その結果生成される <xref:System.Data.SqlClient.SqlDataReader> オブジェクトが読み込まれます。  実際のアプリケーションでは、この時点で、<xref:System.Data.SqlClient.SqlDataReader> を使用してページの一部にデータを挿入することが多いでしょう。  この単純な例では、プロセスに対応するテキスト ボックスにプロセスが完了した時刻が追加されます。  テキスト ボックスに表示される時刻を見ると、1 つのプロセスが完了するたびにコードが実行されることがわかります。  
+  
+ この例を設定するには、新しい ASP.NET Web Site プロジェクトを作成します。  1 つの <xref:System.Web.UI.WebControls.Button> コントロールと 4 つの <xref:System.Web.UI.WebControls.TextBox> コントロールをページに配置します \(コントロールの名前は既定の名前のままにします\)。  
+  
+ お使いの環境に応じて接続文字列を変更し、次のコードをフォームのクラスに追加します。  
+  
+ \[Visual Basic\]  
+  
+```  
+' Add these to the top of the class  
+Imports System  
+Imports System.Data  
+Imports System.Data.SqlClient  
+Imports System.Threading  
+  
+' Add this code to the page's class:  
+    Private Function GetConnectionString() As String  
+        ' To avoid storing the connection string in your code,              
+        ' you can retrieve it from a configuration file.   
+  
+        ' If you have not included "Asynchronous Processing=true"   
+        ' in the connection string, the command will not be able  
+        ' to execute asynchronously.  
+        Return "Data Source=(local);Integrated Security=SSPI;" & _  
+          "Initial Catalog=AdventureWorks;" & _  
+          "Asynchronous Processing=true"  
+    End Function    
+  
+    Sub Button1_Click( _  
+     ByVal sender As Object, ByVal e As System.EventArgs)  
+  
+        ' In a real-world application, you might be connecting to   
+        '  three different servers or databases. For the example,  
+        '  we connect to only one.  
+        Dim connection1 As New SqlConnection(GetConnectionString())  
+        Dim connection2 As New SqlConnection(GetConnectionString())  
+        Dim connection3 As New SqlConnection(GetConnectionString())  
+  
+        ' To keep the example simple, all three asynchronous   
+        ' processes select a row from the same table. WAITFOR  
+        ' commands are used to emulate long-running processes  
+        ' that complete after different periods of time.  
+        Dim commandText1 As String = _  
+            "WAITFOR DELAY '0:0:01';" & _  
+            "SELECT * FROM Production.Product " & _  
+            "WHERE ProductNumber = 'BL-2036'"  
+  
+        Dim commandText2 As String = _  
+            "WAITFOR DELAY '0:0:05';" & _  
+            "SELECT * FROM Production.Product " & _  
+            "WHERE ProductNumber = 'BL-2036'"  
+  
+        Dim commandText3 As String = _  
+            "WAITFOR DELAY '0:0:10';" & _  
+            "SELECT * FROM Production.Product " & _  
+            "WHERE ProductNumber = 'BL-2036'"  
+  
+        Dim waitHandles(2) As WaitHandle  
+        Try  
+            ' For each process, open a connection and begin execution.  
+            ' Use the IAsyncResult object returned by   
+            ' BeginExecuteReader to add a WaitHandle for the process  
+            ' to the array.  
+            connection1.Open()  
+            Dim command1 As New SqlCommand(commandText1, connection1)  
+            Dim result1 As IAsyncResult = _  
+             command1.BeginExecuteReader()  
+            waitHandles(0) = result1.AsyncWaitHandle  
+  
+            connection2.Open()  
+            Dim command2 As New SqlCommand(commandText2, connection2)  
+            Dim result2 As IAsyncResult = _  
+             command2.BeginExecuteReader()  
+            waitHandles(1) = result2.AsyncWaitHandle  
+  
+            connection3.Open()  
+            Dim command3 As New SqlCommand(commandText3, connection3)  
+            Dim result3 As IAsyncResult = _  
+             command3.BeginExecuteReader()  
+            waitHandles(2) = result3.AsyncWaitHandle  
+  
+            Dim index As Integer  
+            For countWaits As Integer = 1 To 3  
+                ' WaitAny waits for any of the processes to complete.  
+                ' The return value is either the index of the  
+                ' array element whose process just completed, or  
+                ' the WaitTimeout value.  
+                index = WaitHandle.WaitAny(waitHandles, 60000, False)  
+                ' This example doesn't actually do anything with the   
+                ' data returned by the processes, but the code opens   
+                ' readers for each just to demonstrate the concept.  
+                ' Instead of using the returned data to fill the   
+                ' controls on the page, the example adds the time  
+                ' the process was completed to the corresponding  
+                ' text box.  
+                Select Case index  
+                    Case 0  
+                        Dim reader1 As SqlDataReader  
+                        reader1 = command1.EndExecuteReader(result1)  
+                        If reader1.Read Then  
+                            TextBox1.Text = _  
+                             "Completed " & _  
+                             System.DateTime.Now.ToLongTimeString()  
+                        End If  
+                        reader1.Close()  
+  
+                    Case 1  
+                        Dim reader2 As SqlDataReader  
+                        reader2 = command2.EndExecuteReader(result2)  
+                        If reader2.Read Then  
+                            TextBox2.Text = _  
+                             "Completed " & _  
+                             System.DateTime.Now.ToLongTimeString()  
+                        End If  
+                        reader2.Close()  
+                    Case 2  
+                        Dim reader3 As SqlDataReader  
+                        reader3 = command3.EndExecuteReader(result3)  
+                        If reader3.Read Then  
+                            TextBox3.Text = _  
+                             "Completed " & _  
+                             System.DateTime.Now.ToLongTimeString()  
+                        End If  
+                        reader3.Close()  
+                    Case WaitHandle.WaitTimeout  
+                        Throw New Exception("Timeout")  
+                End Select  
+  
+            Next  
+        Catch ex As Exception  
+            TextBox4.Text = ex.ToString  
+        End Try  
+        connection1.Close()  
+        connection2.Close()  
+        connection3.Close()  
+  
+    End Sub  
+```  
+  
+ \[C\#\]  
+  
+```  
+// Add the following using statements, if they are not already there.  
+using System;  
+using System.Data;  
+using System.Configuration;  
+using System.Web;  
+using System.Web.Security;  
+using System.Web.UI;  
+using System.Web.UI.WebControls;  
+using System.Web.UI.WebControls.WebParts;  
+using System.Web.UI.HtmlControls;  
+using System.Threading;  
+using System.Data.SqlClient;  
+  
+// Add this code to the page's class  
+string GetConnectionString()  
+     //  To avoid storing the connection string in your code,              
+     //  you can retrieve it from a configuration file.   
+     //  If you have not included "Asynchronous Processing=true"   
+     //  in the connection string, the command will not be able  
+     //  to execute asynchronously.  
+{  
+     return "Data Source=(local);Integrated Security=SSPI;" +  
+          "Initial Catalog=AdventureWorks;" +  
+          "Asynchronous Processing=true";  
+}  
+void Button1_Click(object sender, System.EventArgs e)  
+{  
+     //  In a real-world application, you might be connecting to   
+     //   three different servers or databases. For the example,  
+     //   we connect to only one.  
+  
+     SqlConnection connection1 =   
+          new SqlConnection(GetConnectionString());  
+     SqlConnection connection2 =   
+          new SqlConnection(GetConnectionString());  
+     SqlConnection connection3 =   
+          new SqlConnection(GetConnectionString());  
+     //  To keep the example simple, all three asynchronous   
+     //  processes select a row from the same table. WAITFOR  
+     //  commands are used to emulate long-running processes  
+     //  that complete after different periods of time.  
+  
+     string commandText1 = "WAITFOR DELAY '0:0:01';" +   
+          "SELECT * FROM Production.Product " +   
+          "WHERE ProductNumber = 'BL-2036'";  
+     string commandText2 = "WAITFOR DELAY '0:0:05';" +   
+          "SELECT * FROM Production.Product " +   
+          "WHERE ProductNumber = 'BL-2036'";  
+     string commandText3 = "WAITFOR DELAY '0:0:10';" +   
+          "SELECT * FROM Production.Product " +   
+          "WHERE ProductNumber = 'BL-2036'";  
+     try  
+          //  For each process, open a connection and begin   
+          //  execution. Use the IAsyncResult object returned by   
+          //  BeginExecuteReader to add a WaitHandle for the   
+          //  process to the array.  
+     {  
+          connection1.Open();  
+          SqlCommand command1 =  
+               new SqlCommand(commandText1, connection1);  
+          IAsyncResult result1 = command1.BeginExecuteReader();  
+          WaitHandle waitHandle1 = result1.AsyncWaitHandle;  
+  
+          connection2.Open();  
+          SqlCommand command2 =  
+               new SqlCommand(commandText2, connection2);  
+          IAsyncResult result2 = command2.BeginExecuteReader();  
+          WaitHandle waitHandle2 = result2.AsyncWaitHandle;  
+  
+          connection3.Open();  
+          SqlCommand command3 =  
+               new SqlCommand(commandText3, connection3);  
+          IAsyncResult result3 = command3.BeginExecuteReader();  
+          WaitHandle waitHandle3 = result3.AsyncWaitHandle;  
+  
+          WaitHandle[] waitHandles = {  
+               waitHandle1, waitHandle2, waitHandle3  
+          };  
+  
+          int index;  
+          for (int countWaits = 0; countWaits <= 2; countWaits++)  
+          {  
+               //  WaitAny waits for any of the processes to   
+               //  complete. The return value is either the index   
+               //  of the array element whose process just   
+               //  completed, or the WaitTimeout value.  
+  
+               index = WaitHandle.WaitAny(waitHandles,   
+                    60000, false);  
+               //  This example doesn't actually do anything with   
+               //  the data returned by the processes, but the   
+               //  code opens readers for each just to demonstrate       
+               //  the concept.  
+               //  Instead of using the returned data to fill the   
+               //  controls on the page, the example adds the time  
+               //  the process was completed to the corresponding  
+               //  text box.  
+  
+               switch (index)  
+               {  
+                    case 0:  
+                         SqlDataReader reader1;  
+                         reader1 =   
+                              command1.EndExecuteReader(result1);  
+                         if (reader1.Read())  
+                         {  
+                           TextBox1.Text =   
+                           "Completed " +  
+                           System.DateTime.Now.ToLongTimeString();  
+                         }  
+                         reader1.Close();  
+                         break;  
+                    case 1:  
+                         SqlDataReader reader2;  
+                         reader2 =   
+                              command2.EndExecuteReader(result2);  
+                         if (reader2.Read())  
+                         {  
+                           TextBox2.Text =   
+                           "Completed " +  
+                           System.DateTime.Now.ToLongTimeString();  
+                         }  
+                         reader2.Close();  
+                         break;  
+                    case 2:  
+                         SqlDataReader reader3;  
+                         reader3 =   
+                              command3.EndExecuteReader(result3);  
+                         if (reader3.Read())  
+                         {  
+                           TextBox3.Text =   
+                           "Completed " +  
+                           System.DateTime.Now.ToLongTimeString();  
+                         }  
+                         reader3.Close();  
+                         break;  
+                    case WaitHandle.WaitTimeout:  
+                         throw new Exception("Timeout");  
+                         break;  
+               }  
+          }  
+     }  
+     catch (Exception ex)  
+     {  
+          TextBox4.Text = ex.ToString();  
+     }  
+     connection1.Close();  
+     connection2.Close();  
+     connection3.Close();  
+}  
+```  
+  
+## 例 : Wait \(All\) モデル  
+ 次の例は Wait \(All\) モデルを示しています。  3 つの非同期プロセスが開始されると、<xref:System.Threading.WaitHandle.WaitAll%2A> メソッドが呼び出され、プロセスの完了を待機します。  
+  
+ Wait \(Any\) モデルの例と同様に、プロセスに対応するテキスト ボックスにプロセスが完了した時刻が追加されます。  テキスト ボックスに表示される時刻を見ると、すべてのプロセスが完了した後で <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドに続くコードが実行されることがわかります。  
+  
+ この例を設定するには、新しい ASP.NET Web Site プロジェクトを作成します。  1 つの <xref:System.Web.UI.WebControls.Button> コントロールと 4 つの <xref:System.Web.UI.WebControls.TextBox> コントロールをページに配置します \(コントロールの名前は既定の名前のままにします\)。  
+  
+ お使いの環境に応じて接続文字列を変更し、次のコードをフォームのクラスに追加します。  
+  
+ \[Visual Basic\]  
+  
+```  
+' Add these to the top of the class  
+Imports System  
+Imports System.Data  
+Imports System.Data.SqlClient  
+Imports System.Threading  
+  
+' Add this code to the page's class:  
+    Private Function GetConnectionString() As String  
+        ' To avoid storing the connection string in your code,              
+        ' you can retrieve it from a configuration file.   
+  
+        ' If you have not included "Asynchronous Processing=true"   
+        ' in the connection string, the command will not be able  
+        ' to execute asynchronously.  
+        Return "Data Source=(local);Integrated Security=SSPI;" & _  
+          "Initial Catalog=AdventureWorks;" & _  
+          "Asynchronous Processing=true"  
+    End Function    
+    Sub Button1_Click( _  
+     ByVal sender As Object, ByVal e As System.EventArgs)  
+  
+        ' In a real-world application, you might be connecting to   
+        '  three different servers or databases. For the example,  
+        '  we connect to only one.  
+        Dim connection1 As New SqlConnection(GetConnectionString())  
+        Dim connection2 As New SqlConnection(GetConnectionString())  
+        Dim connection3 As New SqlConnection(GetConnectionString())  
+  
+        ' To keep the example simple, all three asynchronous   
+        ' processes select a row from the same table. WAITFOR  
+        ' commands are used to emulate long-running processes  
+        ' that complete after different periods of time.  
+        Dim commandText1 As String = _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint + 1 " & _  
+         "WHERE ReorderPoint Is Not Null;" & _  
+         "WAITFOR DELAY '0:0:01';" & _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint - 1 " & _  
+         "WHERE ReorderPoint Is Not Null"  
+  
+        Dim commandText2 As String = _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint + 1 " & _  
+         "WHERE ReorderPoint Is Not Null;" & _  
+         "WAITFOR DELAY '0:0:05';" & _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint - 1 " & _  
+         "WHERE ReorderPoint Is Not Null"  
+  
+        Dim commandText3 As String = _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint + 1 " & _  
+         "WHERE ReorderPoint Is Not Null;" & _  
+         "WAITFOR DELAY '0:0:10';" & _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint - 1 " & _  
+         "WHERE ReorderPoint Is Not Null"  
+  
+        Dim waitHandles(2) As WaitHandle  
+  
+        Try  
+            ' For each process, open a connection and begin execution.  
+            ' Use the IAsyncResult object returned by   
+            ' BeginExecuteReader to add a WaitHandle for the process  
+            ' to the array.  
+            connection1.Open()  
+            Dim command1 As New SqlCommand(commandText1, connection1)  
+            Dim result1 As IAsyncResult = _  
+             command1.BeginExecuteNonQuery()  
+            waitHandles(0) = result1.AsyncWaitHandle  
+  
+            connection2.Open()  
+            Dim command2 As New SqlCommand(commandText2, connection2)  
+            Dim result2 As IAsyncResult = _  
+             command2.BeginExecuteNonQuery()  
+            waitHandles(1) = result2.AsyncWaitHandle  
+  
+            connection3.Open()  
+            Dim command3 As New SqlCommand(commandText3, connection3)  
+            Dim result3 As IAsyncResult = _  
+             command3.BeginExecuteNonQuery()  
+            waitHandles(2) = result3.AsyncWaitHandle  
+  
+            ' WaitAll waits for all of the processes to complete.  
+            ' The return value is True if all processes completed,   
+            ' False if any process timed out.  
+            Dim result As Boolean = _  
+             WaitHandle.WaitAll(waitHandles, 60000, False)  
+            If result Then  
+                Dim rowCount1 As Long = _  
+                 command1.EndExecuteNonQuery(result1)  
+                TextBox1.Text = _  
+                 "Completed " & _  
+                 System.DateTime.Now.ToLongTimeString()  
+  
+                Dim rowCount2 As Long = _  
+                 command2.EndExecuteNonQuery(result2)  
+                TextBox2.Text = _  
+                 "Completed " & _  
+                 System.DateTime.Now.ToLongTimeString()  
+  
+                Dim rowCount3 As Long = _  
+                 command3.EndExecuteNonQuery(result3)  
+                TextBox3.Text = _  
+                 "Completed " & _  
+                 System.DateTime.Now.ToLongTimeString()  
+            Else  
+                Throw New Exception("Timeout")  
+            End If  
+        Catch ex As Exception  
+            TextBox4.Text = ex.ToString  
+        End Try  
+        connection1.Close()  
+        connection2.Close()  
+        connection3.Close()  
+  
+    End Sub  
+```  
+  
+ \[C\#\]  
+  
+```  
+// Add the following using statements, if they are not already there.  
+using System;  
+using System.Data;  
+using System.Configuration;  
+using System.Web;  
+using System.Web.Security;  
+using System.Web.UI;  
+using System.Web.UI.WebControls;  
+using System.Web.UI.WebControls.WebParts;  
+using System.Web.UI.HtmlControls;  
+using System.Threading;  
+using System.Data.SqlClient;  
+  
+// Add this code to the page's class  
+string GetConnectionString()  
+    //  To avoid storing the connection string in your code,              
+    //  you can retrieve it from a configuration file.   
+    //  If you have not included "Asynchronous Processing=true"   
+    //  in the connection string, the command will not be able  
+    //  to execute asynchronously.  
+{  
+    return "Data Source=(local);Integrated Security=SSPI;" +  
+        "Initial Catalog=AdventureWorks;" +  
+        "Asynchronous Processing=true";  
+}  
+void Button1_Click(object sender, System.EventArgs e)  
+{  
+    //  In a real-world application, you might be connecting to   
+    //   three different servers or databases. For the example,  
+    //   we connect to only one.  
+  
+    SqlConnection connection1 =   
+        new SqlConnection(GetConnectionString());  
+    SqlConnection connection2 =   
+        new SqlConnection(GetConnectionString());  
+    SqlConnection connection3 =   
+        new SqlConnection(GetConnectionString());  
+    //  To keep the example simple, all three asynchronous   
+    //  processes execute UPDATE queries that result in  
+      //  no change to the data. WAITFOR  
+    //  commands are used to emulate long-running processes  
+    //  that complete after different periods of time.  
+  
+    string commandText1 =   
+        "UPDATE Production.Product " +  
+        "SET ReorderPoint = ReorderPoint + 1 " +  
+        "WHERE ReorderPoint Is Not Null;" +  
+        "WAITFOR DELAY '0:0:01';" +  
+        "UPDATE Production.Product " +  
+        "SET ReorderPoint = ReorderPoint - 1 " +  
+        "WHERE ReorderPoint Is Not Null";  
+  
+    string commandText2 =   
+      "UPDATE Production.Product " +  
+      "SET ReorderPoint = ReorderPoint + 1 " +  
+      "WHERE ReorderPoint Is Not Null;" +  
+      "WAITFOR DELAY '0:0:05';" +  
+      "UPDATE Production.Product " +  
+      "SET ReorderPoint = ReorderPoint - 1 " +  
+      "WHERE ReorderPoint Is Not Null";  
+  
+    string commandText3 =  
+       "UPDATE Production.Product " +  
+       "SET ReorderPoint = ReorderPoint + 1 " +  
+       "WHERE ReorderPoint Is Not Null;" +  
+       "WAITFOR DELAY '0:0:10';" +  
+       "UPDATE Production.Product " +  
+       "SET ReorderPoint = ReorderPoint - 1 " +  
+       "WHERE ReorderPoint Is Not Null";  
+    try  
+        //  For each process, open a connection and begin   
+        //  execution. Use the IAsyncResult object returned by   
+        //  BeginExecuteReader to add a WaitHandle for the   
+        //  process to the array.  
+    {  
+        connection1.Open();  
+        SqlCommand command1 =  
+            new SqlCommand(commandText1, connection1);  
+        IAsyncResult result1 = command1.BeginExecuteNonQuery();  
+        WaitHandle waitHandle1 = result1.AsyncWaitHandle;  
+        connection2.Open();  
+  
+        SqlCommand command2 =  
+            new SqlCommand(commandText2, connection2);  
+        IAsyncResult result2 = command2.BeginExecuteNonQuery();  
+        WaitHandle waitHandle2 = result2.AsyncWaitHandle;  
+        connection3.Open();  
+  
+        SqlCommand command3 =  
+            new SqlCommand(commandText3, connection3);  
+        IAsyncResult result3 = command3.BeginExecuteNonQuery();  
+        WaitHandle waitHandle3 = result3.AsyncWaitHandle;  
+  
+        WaitHandle[] waitHandles = {  
+            waitHandle1, waitHandle2, waitHandle3  
+        };  
+  
+        bool result;  
+        //  WaitAll waits for all of the processes to   
+        //  complete. The return value is True if the processes  
+        //  all completed successfully, False if any process  
+        //  timed out.  
+  
+        result = WaitHandle.WaitAll(waitHandles, 60000, false);  
+        if(result)  
+        {  
+            long rowCount1 =   
+                command1.EndExecuteNonQuery(result1);  
+            TextBox1.Text = "Completed " +  
+                System.DateTime.Now.ToLongTimeString();  
+            long rowCount2 =   
+                command2.EndExecuteNonQuery(result2);  
+            TextBox2.Text = "Completed " +  
+                System.DateTime.Now.ToLongTimeString();  
+  
+            long rowCount3 =   
+                command3.EndExecuteNonQuery(result3);  
+            TextBox3.Text = "Completed " +  
+                System.DateTime.Now.ToLongTimeString();  
+        }  
+        else  
+        {  
+            throw new Exception("Timeout");  
+        }  
+    }  
+  
+    catch (Exception ex)  
+    {  
+        TextBox4.Text = ex.ToString();  
+    }  
+    connection1.Close();  
+    connection2.Close();  
+    connection3.Close();  
+}  
+```  
+  
+## 参照  
+ [非同期操作](../../../../../docs/framework/data/adonet/sql/asynchronous-operations.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/asynchronous-operations.md b/docs/framework/data/adonet/sql/asynchronous-operations.md
new file mode 100644
index 00000000000..7ad185da0b7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/asynchronous-operations.md
@@ -0,0 +1,42 @@
+---
+title: "非同期操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7d32c3c-bf78-4bfc-a357-c9e82e4a4b3c
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# 非同期操作
+コマンドの実行など、データベースでの一部の操作は、完了までに長時間かかることがあります。  そのような場合、シングルスレッドのアプリケーションでは、他の操作をブロックして、コマンドが終了するまで待機しなければ操作を続行できません。  これに対して、長時間にわたる操作をバックグラウンド スレッドに割り当てることができれば、フォアグラウンド スレッドがアクティブなまま操作を続行できます。  たとえば、Windows アプリケーションでは、操作を実行中のユーザー インターフェイス スレッドの応答性を維持しながら、時間のかかる操作をバックグラウンド スレッドに委任することができます。  
+  
+ .NET Framework では、複数の標準的な非同期デザイン パターンが用意されており、バックグラウンド スレッドを利用して、その他の操作を完了するためにユーザー インターフェイスまたは優先順位の高いスレッドを解放できます。  ADO.NET では、<xref:System.Data.SqlClient.SqlCommand> クラスでこれらと同じデザイン パターンがサポートされています。  特に、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery%2A>、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteReader%2A>、および <xref:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader%2A> メソッドと、<xref:System.Data.SqlClient.SqlCommand.EndExecuteNonQuery%2A>、<xref:System.Data.SqlClient.SqlCommand.EndExecuteReader%2A>、および <xref:System.Data.SqlClient.SqlCommand.EndExecuteXmlReader%2A> メソッドとのペアによって、非同期動作がサポートされています。  
+  
+> [!NOTE]
+>  非同期プログラミングは .NET Framework の中心的な機能であり、ADO.NET では標準のデザイン パターンが活用されます。  開発者が利用できるさまざまな非同期技法の詳細については、「[Calling Synchronous Methods Asynchronously](../../../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)」を参照してください。  
+  
+ ADO.NET 機能での非同期技法の使用に伴う特別な考慮事項はありませんが、非同期機能は、.NET Framework のその他の領域よりも ADO.NET で使用する場合が多いと思われます。  マルチスレッドのアプリケーションは、その利点と問題点を認識した上で作成することが重要です。  このセクションに示す例は、マルチスレッド機能を組み込むアプリケーションを構築する際に考慮すべき重要な問題を提示しています。  
+  
+## このセクションの内容  
+ [コールバックを使用した Windows アプリケーション](../../../../../docs/framework/data/adonet/sql/windows-applications-using-callbacks.md)  
+ この例では、非同期コマンドを安全に実行し、異なるスレッドのフォームと内容との対話を正しく処理する方法を示します。  
+  
+ [待機ハンドルを使用した ASP.NET アプリケーション](../../../../../docs/framework/data/adonet/sql/aspnet-apps-using-wait-handles.md)  
+ この例では、ASP.NET ページから複数の同時実行コマンドを実行し、すべてのコマンドの終了時に Wait ハンドルを使用して操作を管理する方法を示します。  
+  
+ [コンソール アプリケーションでのポーリング](../../../../../docs/framework/data/adonet/sql/polling-in-console-applications.md)  
+ この例では、ポーリングを使用して非同期コマンドの実行をコンソール アプリケーションで待機する方法を示します。  この技法は、クラス ライブラリまたはユーザー インターフェイスを持たないその他のアプリケーションでも有効です。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [Calling Synchronous Methods Asynchronously](../../../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/authentication-in-sql-server.md b/docs/framework/data/adonet/sql/authentication-in-sql-server.md
new file mode 100644
index 00000000000..390f17977cb
--- /dev/null
+++ b/docs/framework/data/adonet/sql/authentication-in-sql-server.md
@@ -0,0 +1,93 @@
+---
+title: "認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 646ddbf5-dd4e-4285-8e4a-f565f666c5cc
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# 認証
+[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] は、Windows 認証モードと混合モードという 2 つの認証モードをサポートしています。  
+  
+-   Windows 認証は既定の認証モードです。この [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] セキュリティ モデルは Windows と緊密に統合されているため、多くの場合、統合セキュリティと呼ばれます。  特定の Windows ユーザーおよび Windows グループが、信頼されたアカウントとして SQL Server へのログインが許可されます。  既に認証済みの Windows ユーザーは別途資格情報を提示する必要はありません。  
+  
+-   混合モードは、Windows による認証と [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] による認証の両方がサポートされます。  ユーザー名とパスワードの組み合わせは、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 内で管理されます。  
+  
+> [!IMPORTANT]
+>  できるだけ Windows 認証を使用することをお勧めします。  Windows 認証では、暗号化された一連のメッセージを使用して [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のユーザーを認証します。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインを使用した場合、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のログイン名とパスワードはネットワーク経由で渡されるためセキュリティが低下します。  
+  
+ Windows 認証では、既に Windows にログオンしているユーザーが別途 [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] にログオンする必要はありません。  次の `SqlConnection.ConnectionString` では、Windows 認証が指定されているため、ユーザー名もパスワードも不要です。  
+  
+```  
+"Server=MSSQL1;Database=AdventureWorks;Integrated Security=true;  
+```  
+  
+> [!NOTE]
+>  ログインは、データベース ユーザーとは異なります。  ログインまたは Windows グループは、別個の操作でデータベース ユーザーまたはロールにマップする必要があります。  その後、ユーザーまたはロールに対してデータベース オブジェクトにアクセスするための権限を付与することになります。  
+  
+## 認証のシナリオ  
+ 通常、以下の状況では Windows 認証が最良の選択肢です。  
+  
+-   ドメイン コントローラーが存在する。  
+  
+-   アプリケーションとデータベースが同じコンピューター上に存在する。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] Express または LocalDB のインスタンスを使用している。  
+  
+ 次の状況では、SQL Server ログインを使用することがよくあります。  
+  
+-   ワークグループが存在する。  
+  
+-   ユーザーが別の信頼されていないドメインから接続する。  
+  
+-   [!INCLUDE[vstecasp](../../../../../includes/vstecasp-md.md)] などのインターネット アプリケーション。  
+  
+> [!NOTE]
+>  Windows 認証を指定しても、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインは無効になりません。  高い権限を持つ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインを無効にするには、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] ステートメント ALTER LOGIN DISABLE を使用します。  
+  
+## ログインの種類  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、次の 3 種類のログインがサポートされています。  
+  
+-   ローカル Windows ユーザー アカウントまたは信頼されたドメイン アカウント。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] が Windows に依存する形で Windows ユーザー アカウントを認証します。  
+  
+-   Windows グループ。  Windows グループへのアクセス権を付与すると、そのグループに属しているすべての Windows ユーザー ログインにアクセス権が付与されます。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログイン。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] はユーザー名およびパスワードのハッシュを master データベースに格納し、内部の認証方法を使ってログイン試行を検証します。  
+  
+> [!NOTE]
+>  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、証明書または非対称キーから作成されたログインが提供されています。このログインはコード署名にのみ使用されます。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] への接続には使用できません。  
+  
+## 混合モード認証  
+ 混合モード認証を使用する場合は、SQL Server に格納される [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインを作成する必要があります。  さらに、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のユーザー名とパスワードを実行時に指定する必要があります。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] は、`sa` \("system administrator" の略\) という名前の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインが作成されます。  `sa` ログインには強力なパスワードを割り当て、アプリケーションで `sa` ログインを使用することは避けてください。  `sa` ログインは、サーバー全体に対する取り消し不可能な管理者の資格情報を持つ `sysadmin` 固定サーバー ロールにマップされます。  システム管理者のアクセス権が攻撃者によって取得された場合の潜在的な損害は計り知れません。  既定では、Windows `BUILTIN\Administrators` グループ \(ローカル管理者のグループ\) のすべてのメンバーが `sysadmin` ロールに所属しますが、sysadmin ロールから Windows の Administrators グループのメンバーを削除することもできます。  
+  
+ [!INCLUDE[winxpsvr](../../../../../includes/winxpsvr-md.md)] 以降のバージョンで [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] を実行している場合、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] ログインに Windows のパスワード ポリシー メカニズムが適用されます。  パスワードの複雑性のポリシーは、考えられるパスワードの数を増やすことにより、総当たり攻撃を防ぐようにデザインされています。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 内部で使用されるパスワードに、[!INCLUDE[winxpsvr](../../../../../includes/winxpsvr-md.md)] で使用されているものと同じ複雑性ポリシーおよび有効期限ポリシーを適用できます。  
+  
+> [!IMPORTANT]
+>  ユーザー入力から文字列を連結することによって接続文字列を構築している場合、接続文字列のインジェクション攻撃に対して脆弱になります。  <xref:System.Data.SqlClient.SqlConnectionStringBuilder> を使用すると、構文的に正しい接続文字列を実行時に作成できます。  詳細については、「[接続文字列ビルダー](../../../../../docs/framework/data/adonet/connection-string-builders.md)」を参照してください。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[SQL Server 2008 R2 オンライン ブック](http://msdn.microsoft.com/library/bb543165.aspx)」|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のログインおよびその他のセキュリティ プリンシパルについて説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [データ ソースへの接続](../../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [接続文字列](../../../../../docs/framework/data/adonet/connection-strings.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md b/docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md
new file mode 100644
index 00000000000..888b795dbee
--- /dev/null
+++ b/docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md
@@ -0,0 +1,74 @@
+---
+title: "SQL Server の承認とアクセス許可 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d340405c-91f4-4837-a3cc-a238ee89888a
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# SQL Server の承認とアクセス許可
+データベース オブジェクトを作成する際は、ユーザーがそれらのオブジェクトにアクセスできるように明示的に権限を付与する必要があります。  セキュリティ保護可能なすべてのオブジェクトには、権限ステートメントを使ってプリンシパルに付与することのできる権限が関連付けられています。  
+  
+## 最小特権の原則  
+ LUA \(最小限の特権しか持たないユーザー アカウント\) アプローチによるアプリケーション開発は、セキュリティ上の脅威に対抗する多層防御の重要な部分を占めます。  LUA アプローチを用いることで、ユーザーに最小特権の原則に従った行動を要求し、常に制限ユーザー アカウントでログオンしてもらうことができます。  固定サーバー ロールを使用すると、意図せず管理タスクが実行されてしまう可能性があるため、`sysadmin` 固定サーバー ロールの使用は厳しく制限されることになります。  
+  
+ データベース ユーザーに権限を付与する際は、常に最小特権の原則に従うようにしてください。  ユーザーまたはロールが各自のタスクを実行するために必要な最小限の権限だけを付与します。  
+  
+> [!IMPORTANT]
+>  アプリケーションの開発とテストに LUA アプローチを使用した場合、開発プロセスの難易度は上がります。  オブジェクトの作成やコードの記述は、LUA アカウントとして行うよりも、システム管理者またはデータベース所有者として行う方が簡単です。  高度な権限がなければ正常に動作しないケースも考えられます。しかし、逆に、高い特権を持つアカウントでアプリケーションを開発していると、最小限の特権しか持たないユーザーが、そのアプリケーションを使った場合にどのような制限が生じるかといった影響が見えにくくなります。  なんらかの機能が利用できなかった場合に、ユーザーに過剰な権限を付与して再試行させるというやり方では、アプリケーションに攻撃の隙が生じてしまいます。  LUA アカウントでログオンしてアプリケーションの設計、開発、およびテストを行うことにより、統制のとれたセキュリティ計画が実現します。意図しない問題の発生を防ぎ、その場しのぎの措置でシステム特権を与えるといった誘惑にかられることもありません。  Windows 認証を使ってアプリケーションを配置する場合でも、テスト時には SQL Server ログインを使用できます。  
+  
+## ロール ベースの権限  
+ ユーザーに対して権限を付与するのではなく、ロールに対して権限を付与した方がセキュリティの管理がシンプルになります。  ロールに割り当てられた権限セットは、そのロールのすべてのメンバーによって継承されます。  ユーザーごとに別個の権限セットを作成するよりも、ロールに対してユーザーを追加したり、ロールからユーザーを削除したりする方が容易です。  ロールは入れ子にすることができます \(ただし、あまり階層が深すぎると、パフォーマンスが低下する場合があります\)。  固定データベース ロールにユーザーを追加することで、権限の割り当てを簡素化することもできます。  
+  
+ 権限をスキーマ レベルで付与できます。  ユーザーは、スキーマに新しく作成されたすべてのオブジェクトの権限を自動的に継承するため、新しいオブジェクトが作成されるたびに権限を付与する必要はありません。  
+  
+## プロシージャ コードを介した権限  
+ ストアド プロシージャやユーザー定義関数などのモジュールを介してデータ アクセスをカプセル化すると、アプリケーションに保護層を追加できます。  権限をストアド プロシージャまたは関数に対してのみ付与することで、テーブルなど、基になるオブジェクトへの権限を拒否し、データベース オブジェクトがユーザーによって直接操作されるのを防ぐことができます。  SQL Server では、これを所有権の継承によって実現しています。  
+  
+## 権限ステートメント  
+ Transact\-SQL の 3 つの権限ステートメントを次の表で説明します。  
+  
+|権限ステートメント|説明|  
+|---------------|--------|  
+|GRANT|権限を付与します。|  
+|REVOKE|権限を取り消します。  これは、新しいオブジェクトの既定の状態です。  ユーザーまたはロールから取り消された権限は、引き続きそのプリンシパルが割り当てられている他のグループまたはロールから継承できます。|  
+|DENY|権限を継承できないように取り消します。  DENY はすべての権限に優先しますが、オブジェクトの所有者または `sysadmin` のメンバーには適用されません。  `public` ロールに対してオブジェクトの権限を拒否 \(DENY\) した場合、オブジェクトの所有者および `sysadmin` のメンバーを除くすべてのユーザーおよびロールの権限が拒否されます。|  
+  
+-   GRANT ステートメントでは、データベース ユーザーによる継承が可能な権限をグループまたはロールに割り当てることができます。  ただし、DENY ステートメントは、他のすべての権限ステートメントに優先します。  そのため、権限を拒否されたユーザーが、別のロールからそれを継承することはできません。  
+  
+> [!NOTE]
+>  `sysadmin` 固定サーバー ロールのメンバーおよびオブジェクトの所有者の権限を拒否することはできません。  
+  
+## 所有権の継承  
+ SQL Server では、権限を付与されているプリンシパル以外、オブジェクトにアクセスすることはできません。  複数のデータベース オブジェクトが、相互にアクセスするシーケンスは、チェーンと呼ばれます。  SQL Server は、チェーン内のリンクをたどる際、個々の項目に個別にアクセスする場合とは異なる方法で権限を評価します。  チェーンを介してオブジェクトにアクセスする場合、SQL Server は最初にオブジェクトの所有者と、呼び出し元オブジェクト \(つまり、チェーンにおける直前のリンク\) の所有者とを比較します。  オブジェクトの所有者がどちらも同じであれば、参照されているオブジェクトに対する権限はチェックされません。  あるオブジェクトが、所有者の異なる別のオブジェクトにアクセスする場合、所有権の継承が途切れるため、必ず呼び出し元のセキュリティ コンテキストが SQL Server によってチェックされます。  
+  
+## プロシージャ コードと所有権の継承  
+ ユーザーに、テーブルのデータを選択するストアド プロシージャを実行するための権限が付与されていると仮定します。  ストアド プロシージャの所有者とテーブルの所有者が同じであった場合、このユーザーには、テーブルに対する権限を付与する必要はなく、権限を拒否することも可能です。  ただし、ストアド プロシージャの所有者とテーブルの所有者が異なる場合、SQL Server は、そのユーザーがテーブルに対する権限を持っているかどうかを必ずチェックした上でデータへのアクセスを許可します。  
+  
+> [!NOTE]
+>  動的 SQL ステートメントの場合、所有権の継承は適用されません。  SQL ステートメントを実行するプロシージャを呼び出すには、その呼び出し元に、基になるテーブルへの権限が付与されている必要があるため、SQL インジェクション攻撃に対してアプリケーションが脆弱になってしまいます。  SQL Server では、基になるテーブルへの権限を付与しなくても済むように、権限の借用や証明書によるモジュールへの署名など、新しいメカニズムが用意されています。  これらを CLR のストアド プロシージャと組み合わせて使用することも可能です。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[権限 \(データベース エンジン\)](http://msdn.microsoft.com/library/ms191291.aspx)」|権限の階層、カタログ ビュー、および固定サーバー ロールと固定データベース ロールの権限について説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [認証](../../../../../docs/framework/data/adonet/sql/authentication-in-sql-server.md)   
+ [SQL Server のサーバー ロールとデータベース ロール](../../../../../docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md)   
+ [SQL Server における所有権とユーザーとスキーマの分離](../../../../../docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/bulk-copy-example-setup.md b/docs/framework/data/adonet/sql/bulk-copy-example-setup.md
new file mode 100644
index 00000000000..2b1ad75b519
--- /dev/null
+++ b/docs/framework/data/adonet/sql/bulk-copy-example-setup.md
@@ -0,0 +1,93 @@
+---
+title: "バルク コピー サンプルのセットアップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4dde6ac-b8b6-4593-965a-635c8fb2dadb
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# バルク コピー サンプルのセットアップ
+<xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用すると、SQL Server のテーブルにのみデータを書き込むことができます。  このトピック内のコード サンプルには、SQL Server のサンプル データベース **AdventureWorks** が使用されています。  既存のテーブルの改変を防ぐため、コード サンプルでは、別途作成したテーブルにデータを書き込みます。このテーブルを最初に作成しておく必要があります。  
+  
+ **BulkCopyDemoMatchingColumns** テーブルと **BulkCopyDemoDifferentColumns** テーブルはいずれも **AdventureWorks** の **Production.Products** テーブルに基づいたテーブルです。  コード サンプルではこれらのテーブルを使用し、**Production.Products** テーブルからこれらのサンプル テーブルのいずれかにデータを追加します。  **BulkCopyDemoDifferentColumns** テーブルは、コピー元のデータからコピー先のテーブルに列をマップする方法を説明するサンプルに使用されます。**BulkCopyDemoMatchingColumns** は他のサンプルの大部分に使用されます。  
+  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用して複数のテーブルに書き込む方法を説明するコード サンプルもあります。  これらのサンプルでは、**BulkCopyDemoOrderHeader** テーブルと **BulkCopyDemoOrderDetail** テーブルはコピー先のテーブルとして使用されます。  これらのテーブルは、**AdventureWorks** の **Sales.SalesOrderHeader** テーブルと **Sales.SalesOrderDetail** テーブルに基づいたテーブルです。  
+  
+> [!NOTE]
+>  **SqlBulkCopy** コード サンプルでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の SQL Server インスタンス内に存在する場合、Transact\-SQL `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+## テーブルのセットアップ  
+ コード サンプルを正しく動作させるために必要なテーブルを作成するには、SQL Server データベースで次の Transact\-SQL ステートメントを実行する必要があります。  
+  
+```  
+USE AdventureWorks  
+  
+IF EXISTS (SELECT * FROM dbo.sysobjects   
+ WHERE id = object_id(N'[dbo].[BulkCopyDemoMatchingColumns]')   
+ AND OBJECTPROPERTY(id, N'IsUserTable') = 1)  
+    DROP TABLE [dbo].[BulkCopyDemoMatchingColumns]  
+  
+CREATE TABLE [dbo].[BulkCopyDemoMatchingColumns]([ProductID] [int] IDENTITY(1,1) NOT NULL,  
+    [Name] [nvarchar](50) NOT NULL,  
+    [ProductNumber] [nvarchar](25) NOT NULL,  
+ CONSTRAINT [PK_ProductID] PRIMARY KEY CLUSTERED   
+(  
+    [ProductID] ASC  
+) ON [PRIMARY]) ON [PRIMARY]  
+  
+IF EXISTS (SELECT * FROM dbo.sysobjects   
+ WHERE id = object_id(N'[dbo].[BulkCopyDemoDifferentColumns]')   
+ AND OBJECTPROPERTY(id, N'IsUserTable') = 1)  
+    DROP TABLE [dbo].[BulkCopyDemoDifferentColumns]  
+  
+CREATE TABLE [dbo].[BulkCopyDemoDifferentColumns]([ProdID] [int] IDENTITY(1,1) NOT NULL,  
+    [ProdNum] [nvarchar](25) NOT NULL,  
+    [ProdName] [nvarchar](50) NOT NULL,  
+ CONSTRAINT [PK_ProdID] PRIMARY KEY CLUSTERED   
+(  
+    [ProdID] ASC  
+) ON [PRIMARY]) ON [PRIMARY]  
+  
+IF EXISTS (SELECT * FROM dbo.sysobjects   
+ WHERE id = object_id(N'[dbo].[BulkCopyDemoOrderHeader]')   
+ AND OBJECTPROPERTY(id, N'IsUserTable') = 1)  
+    DROP TABLE [dbo].[BulkCopyDemoOrderHeader]  
+  
+CREATE TABLE [dbo].[BulkCopyDemoOrderHeader]([SalesOrderID] [int] IDENTITY(1,1) NOT NULL,  
+    [OrderDate] [datetime] NOT NULL,  
+    [AccountNumber] [nvarchar](15) NULL,  
+ CONSTRAINT [PK_SalesOrderID] PRIMARY KEY CLUSTERED   
+(  
+    [SalesOrderID] ASC  
+) ON [PRIMARY]) ON [PRIMARY]  
+  
+IF EXISTS (SELECT * FROM dbo.sysobjects   
+ WHERE id = object_id(N'[dbo].[BulkCopyDemoOrderDetail]')   
+ AND OBJECTPROPERTY(id, N'IsUserTable') = 1)  
+    DROP TABLE [dbo].[BulkCopyDemoOrderDetail]  
+  
+CREATE TABLE [dbo].[BulkCopyDemoOrderDetail]([SalesOrderID] [int] NOT NULL,  
+    [SalesOrderDetailID] [int] NOT NULL,  
+    [OrderQty] [smallint] NOT NULL,  
+    [ProductID] [int] NOT NULL,  
+    [UnitPrice] [money] NOT NULL,  
+ CONSTRAINT [PK_LineNumber] PRIMARY KEY CLUSTERED   
+(  
+    [SalesOrderID] ASC,  
+    [SalesOrderDetailID] ASC  
+) ON [PRIMARY]) ON [PRIMARY]  
+```  
+  
+## 参照  
+ [SQL Server でのバルク コピー操作](../../../../../docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md b/docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md
new file mode 100644
index 00000000000..c00aee316a0
--- /dev/null
+++ b/docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md
@@ -0,0 +1,50 @@
+---
+title: "SQL Server でのバルク コピー操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83a7a0d2-8018-4354-97b9-0b1d99f8342b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# SQL Server でのバルク コピー操作
+Microsoft SQL Server には、サイズの大きなファイルをテーブルに高速でバルク コピーしたり、SQL Server データベースのデータを表示したりするための **bcp** という一般的なコマンド ライン ユーティリティが用意されています。  <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用すると、同様の機能を備えたマネージ コード ソリューションを作成できます。  SQL Server のテーブルにデータを読み込むには、INSERT ステートメントを使用するなどの方法もありますが、<xref:System.Data.SqlClient.SqlBulkCopy> を使用すれば他の方法よりもパフォーマンス面で大幅に有利になります。  
+  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用すると、SQL Server のテーブルにのみデータを書き込むことができます。  ただし、データ ソースについては SQL Server に限定されているわけではありません。<xref:System.Data.DataTable> インスタンスのデータの読み込み、または、<xref:System.Data.IDataReader> インスタンスによるデータの読み取りであれば、任意のデータ ソースを使用することができます。  
+  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用すると、次のことを実行できます。  
+  
+-   単一のバルク コピー操作  
+  
+-   複数のバルク コピー操作  
+  
+-   トランザクション内でのバルク コピー操作  
+  
+> [!NOTE]
+>  <xref:System.Data.SqlClient.SqlBulkCopy> クラスがサポートされていない、バージョン 1.1 以前の .NET Framework では、<xref:System.Data.SqlClient.SqlCommand> オブジェクトを使用して、SQL Server Transact\-SQL **BULK INSERT** ステートメントを実行できます。  
+  
+## このセクションの内容  
+ [バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)  
+ バルク コピーの例で使用されるテーブルについて説明します。また、AdventureWorks データベースにテーブルを作成する SQL スクリプトを提供します。  
+  
+ [バルク コピー操作の単一実行](../../../../../docs/framework/data/adonet/sql/single-bulk-copy-operations.md)  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用して、SQL Server のインスタンスにデータをバルク コピーする単一の方法を説明します。また、Transact\-SQL ステートメントと <xref:System.Data.SqlClient.SqlCommand> クラスを使用したバルク コピー操作の実行方法も説明します。  
+  
+ [複数のバルク コピー操作](../../../../../docs/framework/data/adonet/sql/multiple-bulk-copy-operations.md)  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用して、SQL Server のインスタンスにデータのバルク コピー操作を行う複数の方法を説明します。  
+  
+ [トランザクションとバルク コピー操作](../../../../../docs/framework/data/adonet/sql/transaction-and-bulk-copy-operations.md)  
+ トランザクション内でのバルク コピー操作の実行方法を説明します。トランザクションのコミットやロールバックの方法も説明します。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/clr-integration-security-in-sql-server.md b/docs/framework/data/adonet/sql/clr-integration-security-in-sql-server.md
new file mode 100644
index 00000000000..3e6f0d536c4
--- /dev/null
+++ b/docs/framework/data/adonet/sql/clr-integration-security-in-sql-server.md
@@ -0,0 +1,36 @@
+---
+title: "SQL Server の CLR 統合セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 489fe096-fd1d-42de-8438-bf7aed46aea2
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server の CLR 統合セキュリティ
+Microsoft SQL Server で新たに導入された機能の 1 つに、.NET Framework の共通言語ランタイム \(CLR\) コンポーネントの統合があります。  CLR の統合により、Microsoft Visual Basic .NET や Microsoft Visual C\# を含む任意の .NET Framework 言語を使用して、ストアド プロシージャ、トリガー、ユーザー定義型、ユーザー定義関数、ユーザー定義集計、およびストリーミング テーブル値関数を作成できるようになりました。  
+  
+ CLR は、コード アクセス セキュリティ \(CAS\) と呼ばれるマネージ コード用のセキュリティ モデルをサポートしています。  このモデルでは、コードのメタデータに指定された証拠に基づいてアセンブリに権限が付与されます。  SQL Server のユーザーベースのセキュリティ モデルは、SQL Server により CLR のコード アクセスベースのセキュリティ モデルと統合されます。  
+  
+## 外部リソース  
+ SQL Server と CLR の統合の詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)|.NET Framework の CAS について説明します。|  
+|[CLR 統合のセキュリティ](http://go.microsoft.com/fwlink/?LinkId=59998)|SQL Server の内部で実行されるマネージ コードのセキュリティ モデルについて説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server の共通言語ランタイム統合](../../../../../docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/clr-stored-procedures.md b/docs/framework/data/adonet/sql/clr-stored-procedures.md
new file mode 100644
index 00000000000..9d4f6255e37
--- /dev/null
+++ b/docs/framework/data/adonet/sql/clr-stored-procedures.md
@@ -0,0 +1,37 @@
+---
+title: "CLR ストアド プロシージャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd7eea9b-218a-4988-8c9a-8abcc6031c66
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# CLR ストアド プロシージャ
+ストアド プロシージャは、スカラー式では使用できないルーチンです。  ストアド プロシージャは、表形式の結果とメッセージをクライアントに返したり、データ定義言語 \(DDL\) ステートメントおよびデータ操作言語 \(DML\) ステートメントを呼び出したり、出力パラメーターを返したりすることができます。  
+  
+> [!NOTE]
+>  Microsoft Visual Basic では、出力パラメーターのサポートが Microsoft Visual C\# と異なります。  パラメーターを参照によって渡す方式を指定し、次に示すように、\<Out\(\)\> 属性を適用して出力パラメーターを指定する必要があります。  
+  
+```  
+Public Shared Sub ExecuteToClient( <Out()> ByRef number As Integer)  
+```  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [CLR ストアド プロシージャ](http://go.microsoft.com/fwlink/?LinkId=115400)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/clr-triggers.md b/docs/framework/data/adonet/sql/clr-triggers.md
new file mode 100644
index 00000000000..bde88046c95
--- /dev/null
+++ b/docs/framework/data/adonet/sql/clr-triggers.md
@@ -0,0 +1,30 @@
+---
+title: "CLR トリガー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: defe379c-30c7-487f-9abd-9c5e12ff49be
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# CLR トリガー
+トリガーは、言語イベントが実行されると自動的に実行される特殊な種類のストアド プロシージャです。  Microsoft SQL Server が .NET Framework 共通言語ランタイム \(CLR\) と統合されているため、任意の .NET Framework 言語を使用して CLR トリガーを作成できます。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [CLR トリガー](http://go.microsoft.com/fwlink/?LinkId=115397)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/clr-user-defined-functions.md b/docs/framework/data/adonet/sql/clr-user-defined-functions.md
new file mode 100644
index 00000000000..b018d19659b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/clr-user-defined-functions.md
@@ -0,0 +1,26 @@
+---
+title: "CLR ユーザー定義関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c59d9d3-6ff9-411b-8b29-b1494d80fdf1
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# CLR ユーザー定義関数
+ユーザー定義関数は、パラメーターを受け取り、計算やその他の動作を実行し、結果を返すルーチンです。  Microsoft Visual Basic .NET や Microsoft Visual C\# など、任意の Microsoft .NET Framework プログラミング言語を使用してユーザー定義関数を作成できます。  
+  
+ 詳細については、「[CLR ユーザー定義関数](http://msdn.microsoft.com/library/ms131077.aspx)」を参照してください。  
+  
+## 参照  
+ [SQL Server の共通言語ランタイム統合](../../../../../docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/clr-user-defined-types.md b/docs/framework/data/adonet/sql/clr-user-defined-types.md
new file mode 100644
index 00000000000..1fb896438a6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/clr-user-defined-types.md
@@ -0,0 +1,36 @@
+---
+title: "CLR ユーザー定義型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f70e0b0-3a0d-4eb1-b914-07a5d0c167c2
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# CLR ユーザー定義型
+Microsoft SQL Server では、Microsoft .NET Framework 共通言語ランタイム \(CLR\) を使用して実装されるユーザー定義型 \(UDT\) をサポートしています。  CLR は SQL Server に統合されており、この機構を利用すると、データベースの型システムを拡張できます。  UDT を利用すれば、SQL Server データ型システムのユーザー拡張が可能であり、複雑な構造化型を定義することもできます。  
+  
+ UDT は、アプリケーション アーキテクチャの観点から見て 2 つの重要な利点を備えています。  
+  
+-   内部状態と外部動作の間の \(クライアントとサーバーの両方での\) 強力なカプセル化。  
+  
+-   他の関連するサーバー機能との緊密な統合。  独自の UDT を定義すると、列定義、変数、パラメーター、関数の結果、カーソル、トリガー、およびレプリケーションなど、SQL Server のシステム型を利用できるすべてのコンテキストでその UDT を使用できます。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [ユーザー定義の CLR 型](http://go.microsoft.com/fwlink/?LinkId=98366)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/comparing-guid-and-uniqueidentifier-values.md b/docs/framework/data/adonet/sql/comparing-guid-and-uniqueidentifier-values.md
new file mode 100644
index 00000000000..7b702a0cb20
--- /dev/null
+++ b/docs/framework/data/adonet/sql/comparing-guid-and-uniqueidentifier-values.md
@@ -0,0 +1,54 @@
+---
+title: "GUID と uniqueidentifier 値の比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aababd75-2335-43e3-ace8-4b7ae84191a8
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# GUID と uniqueidentifier 値の比較
+SQL Server のグローバル一意識別子 \(GUID: Globally Unique Identifier\) データ型は、16 バイトのバイナリ値を格納する `uniqueidentifier` データ型で表現されます。  GUID は、2 進数の値です。GUID は主に、多数のコンピューターが多数のサイトに存在するネットワーク内で、一意である必要のある識別子として使用されます。  GUID は、Transact\-SQL NEWID 関数を呼び出すことにより生成され、世界中のコンピューターの中で一意であることが保証されています。  詳細については、SQL Server オンライン ブックの「uniqueidentifier データの使用」を参照してください。  
+  
+## SqlGuid 値の使用  
+ GUID の値は長くて不可解な値であるため、ユーザーには意味がわかりません。  ランダムに生成された GUID をキー値として使用して多数の行を挿入した場合に、ランダムな I\/O をインデックスにすると、パフォーマンスに悪影響を及ぼします。  また、GUID は、その他のデータ型に比べてサイズが大きくなります。  通常、GUID は、その他のデータ型が適さないような非常に限られた場合にのみ使用することをお勧めします。  
+  
+### GUID 値の比較  
+ `uniqueidentifier` 型の値には比較演算子が使用できます。  ただし、順序付けは、2 つの値のビット パターンの比較によっては実装されません。  `uniqueidentifier` 値に対して実行可能な唯一の操作は、比較 \(\=、\<\>、\<、\>、\<\=、\>\=\) と NULL の確認 \(IS NULL および IS NOT NULL\) です。  これ以外の算術演算子を使用することはできません。  
+  
+ <xref:System.Guid> と <xref:System.Data.SqlTypes.SqlGuid> のいずれも、異なる GUID 値を比較するための `CompareTo` メソッドを持っています。  ただし、`System.Guid.CompareTo` と `SqlTypes.SqlGuid.CompareTo` では実装方法が異なります。  <xref:System.Data.SqlTypes.SqlGuid> は、値の末尾 6 バイトが最上位になる SQL Server の動作に従って `CompareTo` を実装します。  <xref:System.Guid> は、16 バイトすべてを評価します。  次の例は、この動作の違いを示しています。  コードの最初のセクションは、並べ替えられていない <xref:System.Guid> 値を表示し、コードの 2 つ目のセクションは、並べ替えられた <xref:System.Guid> 値を示します。  3 つ目のセクションは、並べ替えられた <xref:System.Data.SqlTypes.SqlGuid> 値を示します。  出力は、コードの一覧の下に表示されます。  
+  
+ [!code-csharp[DataWorks SqlTypes.Guid#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlTypes.Guid/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlTypes.Guid#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlTypes.Guid/VB/source.vb#1)]  
+  
+ この例を実行すると、次の結果が得られます。  
+  
+```  
+Unsorted Guids:  
+3aaaaaaa-bbbb-cccc-dddd-2eeeeeeeeeee  
+2aaaaaaa-bbbb-cccc-dddd-1eeeeeeeeeee  
+1aaaaaaa-bbbb-cccc-dddd-3eeeeeeeeeee  
+  
+Sorted Guids:  
+1aaaaaaa-bbbb-cccc-dddd-3eeeeeeeeeee  
+2aaaaaaa-bbbb-cccc-dddd-1eeeeeeeeeee  
+3aaaaaaa-bbbb-cccc-dddd-2eeeeeeeeeee  
+  
+Sorted SqlGuids:  
+2aaaaaaa-bbbb-cccc-dddd-1eeeeeeeeeee  
+3aaaaaaa-bbbb-cccc-dddd-2eeeeeeeeeee  
+1aaaaaaa-bbbb-cccc-dddd-3eeeeeeeeeee  
+```  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/creating-application-roles-in-sql-server.md b/docs/framework/data/adonet/sql/creating-application-roles-in-sql-server.md
new file mode 100644
index 00000000000..836f38302b0
--- /dev/null
+++ b/docs/framework/data/adonet/sql/creating-application-roles-in-sql-server.md
@@ -0,0 +1,72 @@
+---
+title: "SQL Server でのアプリケーション ロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27442435-dfb2-4062-8c59-e2960833a638
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# SQL Server でのアプリケーション ロールの作成
+アプリケーション ロールは、データベース ロールやユーザーに対してではなく、アプリケーションに権限を割り当てる手段です。  ユーザーはデータベースに接続し、アプリケーション ロールをアクティブ化して、そのアプリケーションに付与された権限を使用することになります。  アプリケーション ロールに付与された権限は、接続している間のみ有効です。  
+  
+> [!IMPORTANT]
+>  アプリケーション ロールは、クライアント アプリケーションが接続文字列でアプリケーション ロール名とパスワードを渡すことによってアクティブ化されます。  2 層アプリケーションでは、パスワードをクライアント コンピューターに保存する必要があるため、セキュリティ上の脆弱性を伴います。  3 層アプリケーションでは、アプリケーションのユーザーがアクセスできないような形でパスワードを保存できます。  
+  
+## アプリケーション ロールの特徴  
+ アプリケーション ロールには次の特徴があります。  
+  
+-   データベース ロールとは異なり、アプリケーション ロールはメンバーを持ちません。  
+  
+-   アプリケーション ロールは、アプリケーションが `sp_setapprole` システム ストアド プロシージャにアプリケーション ロール名とパスワードを渡すことによってアクティブ化されます。  
+  
+-   パスワードはクライアント コンピューターに保存しておき、実行時に渡す必要があります。アプリケーション ロールを SQL Server 内からアクティブ化することはできません。  
+  
+-   パスワードは暗号化されません。  パラメーターのパスワードが一方向のハッシュとして保存されます。  
+  
+-   アクティブ化後、アプリケーション ロールを使用して取得した権限は、接続している間のみ有効です。  
+  
+-   アプリケーション ロールは、`public` ロールに付与された権限を継承します。  
+  
+-   アプリケーション ロールが `sysadmin` 固定サーバー ロールのメンバーによってアクティブ化された場合、セキュリティ コンテキストは、接続している間、アプリケーション ロールのセキュリティ コンテキストに切り替わります。  
+  
+-   アプリケーション ロールを持ったデータベースに `guest` アカウントを作成した場合、そのアプリケーション ロールまたはそれを呼び出すログインに対するデータベース ユーザー アカウントを作成する必要はありません。  別のデータベースに `guest` アカウントが存在する場合は、アプリケーション ロールでそのデータベースに直接アクセスできます。  
+  
+-   SYSTEM\_USER など、ログイン名を返す組み込み関数を実行した場合、アプリケーション ロールを呼び出したログイン名が返されます。  データベース ユーザー名を返す組み込み関数を実行した場合、アプリケーション ロールの名前が返されます。  
+  
+### 最小特権の原則  
+ パスワードが漏洩した場合に備えて、アプリケーション ロールには必要な権限だけを付与してください。  アプリケーション ロールを使ったデータベースでは、`public` ロールに対する権限は取り消す必要があります。  アプリケーション ロールの呼び出し元が特定のデータベースにアクセスできないようにするには、そのデータベースの `guest` アカウントを無効にします。  
+  
+### アプリケーション ロールの機能強化  
+ アプリケーション ロールをアクティブ化した後で実行コンテキストを元の呼び出し元に戻すことができるため、接続プールを無効にする必要はありません。  呼び出し元のコンテキスト情報を格納するクッキーを作成するための新しいオプションが `sp_setapprole` プロシージャに追加されています。  `sp_unsetapprole` プロシージャにそのクッキーを渡して呼び出すことによって、元のセッションに切り替えることができます。  
+  
+## アプリケーション ロールに代わる方法  
+ アプリケーション ロールはパスワードのセキュリティに依存する関係上、セキュリティ上の脆弱性を伴います。  パスワードをアプリケーション コードに組み込んだり、ディスクに保存したりすると、パスワードが漏洩する可能性があります。  
+  
+ 以下の代替策を検討する必要があります。  
+  
+-   EXECUTE AS ステートメントに NO REVERT 句と WITH COOKIE 句を指定してコンテキスト切り替えを行う。  ログインにマップされていないユーザー アカウントをデータベースに作成し、  このアカウントに権限を割り当てるようにします。  EXECUTE AS はパスワード ベースではなく、権限ベースであるため、非ログイン ユーザーで使用した方が高いセキュリティを確保できます。  詳細については、「[SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)」を参照してください。  
+  
+-   証明書を使ってストアド プロシージャに署名し、そのプロシージャを実行するのに必要な権限だけを付与する。  詳細については、「[SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)」を参照してください。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[アプリケーション ロール](http://msdn.microsoft.com/library/ms190998.aspx)」|SQL Server 2008 でアプリケーション ロールを作成および使用する方法について説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md b/docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md
new file mode 100644
index 00000000000..49adac84d9f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md
@@ -0,0 +1,91 @@
+---
+title: "SQL Server での借用を使用した権限のカスタマイズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dc733d09-1d6d-4af0-9c4b-8d24504860f1
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server での借用を使用した権限のカスタマイズ
+多くのアプリケーションでは、ベース テーブルへのアクセスを制限する組み合わせ所有権を利用して、ストアド プロシージャを使ってデータにアクセスします。  ストアド プロシージャに対して EXECUTE 権限を付与するとき、ベース テーブルに対する権限を取り消したり拒否したりできます。  ストアド プロシージャとテーブルの所有者が同じ場合、SQL Server では呼び出し元の権限をチェックしません。  ただし、オブジェクトの所有者が異なる場合や、動的 SQL の場合には、組み合わせ所有権が無効になります。  
+  
+ 参照先オブジェクトに対する権限が呼び出し元になくても、ストアド プロシージャで EXECUTE AS 句を使用できます。  EXECUTE AS 句の効果は、実行コンテキストがプロキシ ユーザーに切り替えられることです。  入れ子になったストアド プロシージャやトリガーへの呼び出しを含め、すべてのコードがプロキシ ユーザーのセキュリティ コンテキストで実行されます。  プロシージャの実行後、または REVERT ステートメントが発行されたときにのみ、実行コンテキストが最初の呼び出し元に戻ります。  
+  
+## EXECUTE AS ステートメントを使用したコンテキスト切り替え  
+ Transact\-SQL の EXECUTE AS ステートメントを使用して、別のログインまたはデータベース ユーザーの権限を借用することで、ステートメントの実行コンテキストを切り替えることができます。  これは、クエリとプロシージャを別のユーザーとしてテストできる便利な手法です。  
+  
+```  
+EXECUTE AS LOGIN = 'loginName';  
+EXECUTE AS USER = 'userName';  
+```  
+  
+ 権限を借用するログインまたはユーザーに対する IMPERSONATE 権限が必要です。  この権限は、`sysadmin` にはすべてのデータベースに対して与えられ、`db_owner` ロールのメンバーには所有するデータベースに対して与えられます。  
+  
+## EXECUTE AS 句を使用した権限の許可  
+ EXECUTE AS 句は、ストアド プロシージャ、トリガー、ユーザー定義関数 \(インライン テーブル値関数を除く\) の定義ヘッダーで使用できます。  そのため、EXECUTE AS 句で指定されたユーザー名またはキーワードのコンテキストでプロシージャが実行されます。  データベースに、ログインに割り当てられないプロキシ ユーザーを作成し、プロシージャがアクセスするオブジェクトに対して必要な権限のみを許可することができます。  EXECUTE AS 句で指定されたプロキシ ユーザーのみが、モジュールからアクセスされるすべてのオブジェクトに対する権限を持っている必要があります。  
+  
+> [!NOTE]
+>  TRUNCATE TABLE など、許可する権限のない操作もあります。  プロシージャ内にステートメントを組み込み、ALTER TABLE 権限を持つプロキシ ユーザーを指定することで、プロシージャに対する EXECUTE 権限のみを持つ呼び出し元に、テーブルを切り捨てる権限を追加することができます。  
+  
+ EXECUTE AS 句で指定されたコンテキストは、入れ子になったプロシージャやトリガーを含むプロシージャの実行中に有効となります。  実行が完了したとき、または REVERT ステートメントが発行されたときに、コンテキストが呼び出し元に戻ります。  
+  
+ プロシージャで EXECUTE AS 句を使用する際には、次の 3 つの手順を実行します。  
+  
+1.  ログインに割り当てられていないプロキシ ユーザーをデータベースに作成します。  この操作は必須ではありませんが、権限を管理するときに役立ちます。  
+  
+```  
+CREATE USER proxyUser WITHOUT LOGIN  
+```  
+  
+1.  プロキシ ユーザーに必要な権限を与えます。  
+  
+2.  ストアド プロシージャまたはユーザー定義関数に EXECUTE AS 句を追加します。  
+  
+```  
+CREATE PROCEDURE [procName] WITH EXECUTE AS 'proxyUser' AS ...  
+```  
+  
+> [!NOTE]
+>  呼び出し元の元のセキュリティ コンテキストが保持されないため、監査の必要なアプリケーションはブレークされる可能性があります。  SESSION\_USER、USER、USER\_NAME など、現在のユーザーの識別情報を返す組み込み関数では、最初の呼び出し元ではなく EXECUTE AS 句に関連付けられているユーザーが返されます。  
+  
+### REVERT での EXECUTE AS の使用  
+ Transact\-SQL REVERT ステートメントを使用して、元の実行コンテキストに戻ることができます。  
+  
+ オプションの句である WITH NO REVERT COOKIE \= @variableName を使用すると、@variableName 変数に正しい値が含まれていれば、実行コンテキストを呼び出し元に切り替えることができます。  これにより、接続プールが使用されている環境では実行コンテキストを呼び出し元に切り替えることができます。  @variableName の値は、EXECUTE AS ステートメントの呼び出し元のみが把握しているため、実行コンテキストがアプリケーションを呼び出したエンド ユーザーによって変更されることはありません。  接続は、閉じられるとプールに返されます。  ADO.NET における接続プールの詳細については、「[SQL Server の接続プール \(ADO.NET\)](../../../../../docs/framework/data/adonet/sql-server-connection-pooling.md)」を参照してください。  
+  
+### 実行コンテキストの指定  
+ EXECUTE AS は、ユーザーを指定するだけでなく、次のキーワードを指定して使用することもできます。  
+  
+-   CALLER :   既定で、CALLER として実行されます。他にオプションが指定されていない場合、プロシージャは呼び出し元のセキュリティ コンテキストで実行されます。  
+  
+-   OWNER :   OWNER として実行すると、プロシージャがプロシージャ所有者のコンテキストで実行されます。  `dbo` すなわちデータベース所有者が所有するスキーマでプロシージャが作成されている場合、プロシージャは権限無制限で実行されます。  
+  
+-   SELF :   SELF として実行すると、ストアド プロシージャの作成者のセキュリティ コンテキストで実行されます。  これは、指定されたユーザーとして実行することと同じです。指定されたユーザーとは、プロシージャを作成または変更した人物です。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[コンテキストの切り替え \(データベース エンジン\)](http://msdn.microsoft.com/library/ms188268.aspx)」|EXECUTE AS 句の使用方法を説明しているトピックへのリンクが用意されています。|  
+|SQL Server オンライン ブックの「[EXECUTE AS の使用によるカスタム権限セットの作成](http://msdn.microsoft.com/library/ms190384.aspx)」および「[モジュールでの EXECUTE AS の使用](http://msdn.microsoft.com/library/ms178106.aspx)」|EXECUTE AS 句の使用方法を説明するトピックです。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)   
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)   
+ [ストアド プロシージャでのデータの変更](../../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/data-encryption-in-sql-server.md b/docs/framework/data/adonet/sql/data-encryption-in-sql-server.md
new file mode 100644
index 00000000000..f130a1ade2d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/data-encryption-in-sql-server.md
@@ -0,0 +1,46 @@
+---
+title: "SQL Server でのデータの暗号化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83b992f7-b351-4678-b4b9-f4ffd58134cc
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server でのデータの暗号化
+SQL Server には、証明書、非対称キー、対称キーのいずれかを使ってデータを暗号化したり、復号化したりできる関数が用意されています。  これらはすべて内部の証明書ストアで管理されます。  証明書ストアは、1 つ上の層がその下の層を保護する暗号化階層を使用することによって、証明書およびキーを保護します。  SQL Server では、この機能領域をシークレット ストレージと呼びます。  
+  
+ 暗号化関数によってサポートされる最速の暗号化方式は対称キーによる暗号化です。  この方法は大量のデータを処理する場合に適しています。  対称キーは、証明書、パスワードまたは他の対称キーで暗号化できます。  
+  
+## キーとアルゴリズム  
+ SQL Server は、DES、Triple DES、RC2、RC4、128 ビット RC4、DESX、128 ビット AES、192 ビット AES、256 ビット AES など、複数の対称キー暗号化アルゴリズムをサポートしています。  アルゴリズムは Windows Crypto API を使って実装されています。  
+  
+ SQL Server は、オープンする対称キーをデータベース接続のスコープ内で複数管理できます。  オープンするキーは証明書ストアから取得でき、データを復号化する際に使用できます。  データの一部が復号化されていれば、使用する対称キーを指定する必要はありません。  暗号化された各値は、どのキーを使って暗号化されたかを示すキー識別子 \(キー GUID\) を保持します。  正しいキーが復号化されてオープンされた場合、暗号化されたバイト ストリームとオープンする対称キーとがエンジンによって照合されます。  次に、このキーを使って復号化が実行されて、データが返されます。  正しいキーがオープンされなかった場合は NULL が返されます。  
+  
+ データベース内で暗号化されたデータを使用した操作方法の例については、SQL Server オンライン ブックの「[データの列の暗号化](http://go.microsoft.com/fwlink/?LinkID=128559)」を参照してください。  
+  
+## 外部リソース  
+ データの暗号化の詳細については、次のリソースを参照してください。  
+  
+|||  
+|-|-|  
+|SQL Server オンライン ブックの「[SQL Server の暗号化](http://msdn.microsoft.com/library/bb510663.aspx)」|SQL Server における暗号化の概要を説明します。  このトピックには、他のトピックや具体的な方法を示したページへのリンクが用意されています。|  
+|SQL Server オンライン ブックの「[暗号化階層](http://msdn.microsoft.com/library/ms189586.aspx)」および「[暗号化の操作方法に関するトピック](http://msdn.microsoft.com/library/aa337557.aspx)」|SQL Server における暗号化の概要を説明します。  このトピックには、他のトピックや具体的な方法を示したページへのリンクが用意されています。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [認証](../../../../../docs/framework/data/adonet/sql/authentication-in-sql-server.md)   
+ [SQL Server のサーバー ロールとデータベース ロール](../../../../../docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md)   
+ [SQL Server における所有権とユーザーとスキーマの分離](../../../../../docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md)   
+ [SQL Server の承認とアクセス許可](../../../../../docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/database-mirroring-in-sql-server.md b/docs/framework/data/adonet/sql/database-mirroring-in-sql-server.md
new file mode 100644
index 00000000000..f02760c1293
--- /dev/null
+++ b/docs/framework/data/adonet/sql/database-mirroring-in-sql-server.md
@@ -0,0 +1,71 @@
+---
+title: "SQL Server のデータベース ミラーリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89befaff-bb46-4290-8382-e67cdb0e3de9
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server のデータベース ミラーリング
+SQL Server のデータベース ミラーリング機能を使用すると、スタンバイ サーバー上に SQL Server データベースのコピー \(ミラー\) を保持できます。  ミラーリングは、常にデータのコピーが 2 つ別々に存在することを保証し、高可用性とデータの完全な冗長性をもたらします。  .NET Data Provider for SQL Server では、データベース ミラーリングが暗黙的にサポートされているため、SQL Server データベース用に構成されている場合は、開発者が操作を行ったり、コードを作成したりする必要はありません。  さらに、<xref:System.Data.SqlClient.SqlConnection> オブジェクトは、<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> 内のフェールオーバー パートナー サーバーの名前を指定できる明示的な接続モードをサポートします。  
+  
+ 次の簡略化された一連のイベントは、ミラーリング用に構成されているデータベースを対象にする <xref:System.Data.SqlClient.SqlConnection> オブジェクトで発生します。  
+  
+1.  クライアント アプリケーションが正常にプリンシパル データベースに接続し、クライアント上でキャッシュされたパートナー サーバーの名前をサーバーが返信します。  
+  
+2.  プリンシパル データベースが存在するサーバーで障害が発生したか、接続が中断された場合、接続とトランザクションの状態は失われます。  クライアント アプリケーションは、プリンシパル データベースへの接続を再確立しようとして、失敗します。  
+  
+3.  次に、クライアント アプリケーションでは、パートナー サーバー上のミラー データベースへの接続を透過的に確立しようとします。  この処理に成功すると、新しいプリンシパル データベースとなるミラー データベースに、接続がリダイレクトされます。  
+  
+## 接続文字列でのフェールオーバー パートナーの指定  
+ 接続文字列でフェールオーバー パートナー サーバーの名前を指定すると、クライアント アプリケーションが最初に接続するときにプリンシパル データベースを使用できない場合、クライアントはフェールオーバー パートナーへの接続を透過的に試行します。  
+  
+```  
+";Failover Partner=PartnerServerName"  
+```  
+  
+ 接続文字列のフェールオーバー パートナー サーバーの名前を省略すると、クライアント アプリケーションが最初に接続するときにプリンシパル データベースが使用できない場合、<xref:System.Data.SqlClient.SqlException> が発生します。  
+  
+ <xref:System.Data.SqlClient.SqlConnection> が正常に開かれた場合、サーバーからフェールオーバー パートナーの名前が返され、接続文字列に指定されている値を置き換えます。  
+  
+> [!NOTE]
+>  データベース ミラーリング シナリオでは、接続文字列で初期カタログやデータベース名を明示的に指定する必要があります。  クライアントが、初期カタログやデータベースが明示的に指定されていない接続に関するフェールオーバー情報を受信する場合は、このフェールオーバー情報はキャッシュされず、アプリケーションはプリンシパル サーバーでの障害発生時にフェールオーバーを試行しません。  接続文字列にフェールオーバー パートナーの値が含まれていても、初期カタログまたはデータベースの値が含まれていない場合、`InvalidArgumentException` が発生します。  
+  
+## 現在のサーバー名の取得  
+ フェールオーバーの場合には、<xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.DataSource%2A> プロパティを使って、現在の接続が実際に接続されているサーバーの名前を取得できます。  次のコード フラグメントでは、アクティブなサーバーの名前を取得します。この場合、接続変数は開いている <xref:System.Data.SqlClient.SqlConnection> を参照することを前提としています。  
+  
+ フェールオーバー イベントが発生し、接続がミラー サーバーに切り替えられると、ミラー名を反映するために **DataSource** プロパティが更新されます。  
+  
+```vb  
+Dim activeServer As String = connection.DataSource  
+```  
+  
+```csharp  
+string activeServer = connection.DataSource;  
+```  
+  
+## SqlClient ミラーリングの動作  
+ クライアントは、常に現在のプリンシパル サーバーに接続しようとします。  接続に失敗した場合は、フェールオーバー パートナーに接続しようとします。  ミラー データベースが既にパートナー サーバー上でプリンシパル ロールに切り替わっている場合、接続は正常に行われ、新しいプリンシパルとミラー間のマッピングがクライアントに送信されて <xref:System.AppDomain> の呼び出しの有効期間の間キャッシュされます。  このマッピングは永続ストレージには格納されないため、別の **AppDomain** 内またはプロセス内で次回の接続に使用することはできません。  ただし、同一の **AppDomain** 内では次回の接続に使用できます。  同一または別のコンピューター上で実行されている、別の **AppDomain** またはプロセスには常に接続のプールがあり、これらの接続はリセットされません。  このとき、プライマリ データベースがダウンし、各プロセスまたは **AppDomain** が失敗した場合、プールは自動的に消去されます。  
+  
+> [!NOTE]
+>  サーバーのミラーリング サポートは、データベースごとに構成されます。  複数部分から成る名前を使用するか、現在のデータベースを変更することにより、プリンシパル\/ミラー セットに含まれない他のデータベースに対してデータの操作が実行された場合、これらの他のデータベースへの変更は障害の発生時には反映されません。  ミラー化されていないデータベース内でデータが変更された場合、エラーは発生しません。  開発者は、このような操作の考えられる影響を評価する必要があります。  
+  
+## データベース ミラーリングに関するリソース  
+ ミラーリングの構成、配置、および管理の概念に関するドキュメントや情報については、SQL Server オンライン ブックの次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[データベース ミラーリング](http://msdn.microsoft.com/library/bb934127.aspx)」|SQL Server でのミラーリングの設定と構成方法について説明します。|  
+  
+## 参照  
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/date-and-time-data.md b/docs/framework/data/adonet/sql/date-and-time-data.md
new file mode 100644
index 00000000000..f2a5ce37fca
--- /dev/null
+++ b/docs/framework/data/adonet/sql/date-and-time-data.md
@@ -0,0 +1,245 @@
+---
+title: "日付と時刻のデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6f5ff56a-a57e-49d7-8ae9-bbed697e42e3
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# 日付と時刻のデータ
+SQL Server 2008 では、日付と時刻の情報を扱うための新しいデータ型が導入されました。  新しいデータ型には、日付と時刻の別個のデータ型と、範囲、有効桁数、タイム ゾーン処理が向上した拡張データ型が含まれています。  .NET Framework 3.5 Service Pack \(SP\) 1 以降では、.NET Framework Data Provider for SQL Server \(<xref:System.Data.SqlClient>\) が SQL Server 2008 データベース エンジンの新機能すべてをサポートします。  SqlClient でこれらの新機能を使用するには、.NET Framework 3.5 SP1 以降をインストールする必要があります。  
+  
+ SQL Server 2008 より前のバージョンの SQL Server では、日付と時刻に使用できるデータ型には `datetime` と `smalldatetime` の 2 つしかありませんでした。  どちらのデータ型も日付値と時刻値の両方を保持するため、日付と時刻のどちらか一方の値のみを使用するのが困難でした。  また、これらのデータ型でサポートされる日付は、英国で 1753 年にグレゴリオ暦が導入された後の日付に限られています。  もう 1 つの制限は、これらの古いデータ型はタイム ゾーンを処理できないことです。その結果、複数のタイム ゾーンから送られてくるデータの処理が難しくなっています。  
+  
+ SQL Server のデータ型に関する完全な説明は、SQL Server オンライン ブックに記載されています。  次の表は、バージョン別の日付と時刻のデータに関する初歩的なトピックの一覧です。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [日付と時間のデータの使用](http://go.microsoft.com/fwlink/?LinkID=98361)  
+  
+## SQL Server 2008 で導入された日付\/時刻データ型  
+ 次の表は、新しい日付と時刻のデータ型の説明です。  
+  
+|SQL Server のデータ型|説明|  
+|----------------------|--------|  
+|`date`|データ型 `date` の範囲は 01 年 1 月 1 日から 9999 年 12 月 31 日までで、精度は 1 日です。  既定値は 1900 年 1 月 1 日です。  記憶領域のサイズは 3 バイトです。|  
+|`time`|`time` データ型は、24 時間形式で時刻値のみを格納します。  `time` データ型は、00:00:00.0000000 から 23:59:59.9999999 の範囲を 100 ナノ秒の精度で表すことができます。  既定値は 00:00:00.0000000 \(午前 0 時\) です。  `time` データ型はユーザー定義による 1 秒未満の時間の有効桁数をサポートし、記憶領域のサイズは、指定された有効桁数に応じて 3 バイト～ 6 バイトになります。|  
+|`datetime2`|`datetime2` データ型は、`date` 型と `time` 型の範囲および有効桁数を単一のデータ型として組み合わせたものです。<br /><br /> 既定値および文字列リテラルの形式は、`date` 型および `time` 型で定義されているものと同じです。|  
+|`datetimeoffset`|`datetimeoffset` データ型は、`datetime2` のすべての機能に加えて、タイム ゾーン オフセットを持ちます。  タイム ゾーン オフセットは、\[\+&#124;\-\] HH:MM として表されます。  HH は、タイム ゾーン オフセットの時間数を表す 00 ～ 14 の 2 桁の数字です。  MM は、タイム ゾーン オフセットの付加的な分数を表す 0 ～ 59 の 2 桁の数字です。  時刻の精度は 100 ナノ秒までサポートされます。  必須の \+ 記号または \- 記号は、ローカル時刻を取得する際、UTC \(協定世界時またはグリニッジ標準時\) を基準としてタイム ゾーン オフセットを加算するか、減算するかを示します。|  
+  
+> [!NOTE]
+>  `Type System Version` キーワードの使用方法の詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」を参照してください。  
+  
+## 日付書式と表記順序  
+ SQL Server が日付と時刻の値をどのように処理するかは、型システムのバージョンとサーバーのバージョンだけでなく、サーバーの既定の言語と書式設定にも左右されます。  日付文字列が、ある言語の日付書式で有効な場合でも、別の言語と日付書式を使用している接続でクエリを実行した場合には意味を持たない可能性があります。  
+  
+ Transact\-SQL の SET LANGUAGE ステートメントは、日付の構成要素の並べ方を決定する DATEFORMAT を暗黙に設定します。  日付構成要素の表記順序が MDY、DMY、YMD、YDM、MYD、DYM のいずれであるかを明確にするには、接続で Transact\-SQL の SET DATEFORMAT ステートメントを使用します。  
+  
+ 接続で DATEFORMAT を指定しないと、SQL Server はその接続に関連付けられている既定の言語を使用します。  たとえば、日付文字列 '01\/02\/03' は、言語が United States English に設定されているサーバーでは MDY \(January 2, 2003\) として、British English に設定されているサーバーでは DMY \(February 1, 2003\) として処理されます。  年は、SQL Server の終了年の規則に従って決定されます。この規則では、世紀の値を割り当てるための終了日が定義されます。  詳細については、SQL Server オンライン ブックの「[two digit year cutoff オプション](http://go.microsoft.com/fwlink/?LinkId=120473)」を参照してください。  
+  
+> [!NOTE]
+>  YDM 日付書式は、文字列形式から `date`、`time`、`datetime2`、または `datetimeoffset` に変換する場合にはサポートされません。  
+  
+ SQL Server が日付と時間のデータを解釈する方法の詳細については、SQL Server 2008 オンライン ブックの「[日付と時間のデータの使用](http://go.microsoft.com/fwlink/?LinkID=98361)」を参照してください。  
+  
+## Date\/Time データ型とパラメーター  
+ <xref:System.Data.SqlClient.SqlParameter> のデータ型は、<xref:System.Data.SqlDbType> 列挙型のいずれかの値を使って指定できます。  新しい日付型と時刻型をサポートするために、<xref:System.Data.SqlDbType> には、次の列挙値が追加されています。  
+  
+-   `SqlDbType.Date`  
+  
+-   `SqlDbType.Time`  
+  
+-   `SqlDbType.DateTime2`  
+  
+-   `SqlDbType.DateTimeOffSet`  
+  
+ `SqlParameter` オブジェクトの <xref:System.Data.SqlClient.SqlParameter.DbType%2A> プロパティを特定の <xref:System.Data.DbType> 列挙値に設定することによって、<xref:System.Data.SqlClient.SqlParameter> の型をジェネリックに指定することもできます。  `datetime2` データ型と `datetimeoffset` データ型をサポートするために、<xref:System.Data.DbType> には、次の列挙値が追加されています。  
+  
+-   DbType.DateTime2  
+  
+-   DbType.DateTimeOffset  
+  
+ これらの新しい列挙値は、以前のバージョンの .NET Framework に存在した `Date`、`Time`、および `DateTime` の各列挙値を補います。  
+  
+ パラメーター オブジェクトの .NET Framework データ プロバイダー型は、パラメーター オブジェクトの値の .NET Framework 型か、またはパラメーター オブジェクトの `DbType` から推論されます。  新しい date 型と time 型をサポートするための新しい <xref:System.Data.SqlTypes> データ型は導入されていません。  SQL Server 2008 の date 型\/time 型と CLR のデータ型のマッピングを次の表に示します。  
+  
+|SQL Server のデータ型|.NET Framework 型|System.Data.SqlDbType|System.Data.DbType|  
+|----------------------|----------------------|---------------------------|------------------------|  
+|date|System.DateTime|日付|日付|  
+|時間|System.TimeSpan|時刻|時刻|  
+|datetime2|System.DateTime|DateTime2|DateTime2|  
+|datetimeoffset|System.DateTimeOffset|DateTimeOffset|DateTimeOffset|  
+|datetime|System.DateTime|DateTime|DateTime|  
+|smalldatetime|System.DateTime|DateTime|DateTime|  
+  
+### SqlParameter プロパティ  
+ 次の表は、日付と時刻のデータ型に関係する `SqlParameter` プロパティの説明です。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Data.SqlClient.SqlParameter.IsNullable%2A>|値を NULL に設定できるかどうかを取得または設定します。  サーバーに NULL パラメーター値を送る場合は、`null` \(Visual Basic の場合は `Nothing`\) ではなく、<xref:System.DBNull> を指定する必要があります。  データベースの NULL 値の詳細については、「[NULL 値の処理](../../../../../docs/framework/data/adonet/sql/handling-null-values.md)」を参照してください。|  
+|<xref:System.Data.SqlClient.SqlParameter.Precision%2A>|その値の最大桁数を取得または設定します。  この設定値は date データ型と time データ型では無視されます。|  
+|<xref:System.Data.SqlClient.SqlParameter.Scale%2A>|小数点以下の桁数を取得または設定します。これは `Time`、`DateTime2`、および `DateTimeOffset` の時刻部分の値の処理で使用されます。  既定値は 0 です。これは、実際の桁数が値から推論されてサーバーに送られることを意味します。|  
+|<xref:System.Data.SqlClient.SqlParameter.Size%2A>|date データ型と time データ型では無視されます。|  
+|<xref:System.Data.SqlClient.SqlParameter.Value%2A>|パラメーター値を取得または設定します。|  
+|<xref:System.Data.SqlClient.SqlParameter.SqlValue%2A>|パラメーター値を取得または設定します。|  
+  
+> [!NOTE]
+>  時刻の値が 0 と 24 の間にない場合は、<xref:System.ArgumentException> がスローされます。  
+  
+### パラメーターの作成  
+ <xref:System.Data.SqlClient.SqlParameter> オブジェクトは、そのコンストラクターを使って作成できるほか、<xref:System.Data.SqlClient.SqlParameterCollection> の `Add` メソッドを呼び出して、<xref:System.Data.SqlClient.SqlCommand> <xref:System.Data.SqlClient.SqlCommand.Parameters%2A> コレクションにそれを追加することによって作成することもできます。  `Add` メソッドは、入力としてコンストラクター引数または既存のパラメーター オブジェクトを受け取ります。  
+  
+ このトピックの次のセクションでは、日付と時刻のパラメーターを指定する方法の例を示します。  パラメーターの使用方法を示すその他の例については、「[パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)」および「[DataAdapter パラメーター](../../../../../docs/framework/data/adonet/dataadapter-parameters.md)」を参照してください。  
+  
+### Date の例  
+ 次のコード フラグメントは、`date` パラメーターの指定方法を示しています。  
+  
+```csharp  
+SqlParameter parameter = new SqlParameter();  
+parameter.ParameterName = "@Date";  
+parameter.SqlDbType = SqlDbType.Date;  
+parameter.Value = "2007/12/1";  
+```  
+  
+```vb  
+Dim parameter As New SqlParameter()  
+parameter.ParameterName = "@Date"  
+parameter.SqlDbType = SqlDbType.Date  
+parameter.Value = "2007/12/1"  
+```  
+  
+### Time の例  
+ 次のコード フラグメントは、`time` パラメーターの指定方法を示しています。  
+  
+```csharp  
+SqlParameter parameter = new SqlParameter();  
+parameter.ParameterName = "@time";  
+parameter.SqlDbType = SqlDbType.Time;  
+parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;  
+```  
+  
+```vb  
+Dim parameter As New SqlParameter()  
+parameter.ParameterName = "@Time"  
+parameter.SqlDbType = SqlDbType.Time  
+parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;  
+```  
+  
+### Datetime2 の例  
+ 次のコード フラグメントは、`datetime2` パラメーターの日付と時刻の指定方法を示しています。  
+  
+```csharp  
+SqlParameter parameter = new SqlParameter();  
+parameter.ParameterName = "@Datetime2";  
+parameter.SqlDbType = SqlDbType.DateTime2;  
+parameter.Value = DateTime.Parse("1666-09-02 1:00:00");  
+```  
+  
+```vb  
+Dim parameter As New SqlParameter()  
+parameter.ParameterName = "@Datetime2"  
+parameter.SqlDbType = SqlDbType.DateTime2  
+parameter.Value = DateTime.Parse("1666-09-02 1:00:00");  
+```  
+  
+### DateTimeOffSet の例  
+ 次のコード フラグメントは、`DateTimeOffSet` パラメーターの日付と時刻、およびタイム ゾーン オフセット 0 を指定する方法を示しています。  
+  
+```csharp  
+SqlParameter parameter = new SqlParameter();  
+parameter.ParameterName = "@DateTimeOffSet";  
+parameter.SqlDbType = SqlDbType.DateTimeOffSet;  
+parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");  
+```  
+  
+```vb  
+Dim parameter As New SqlParameter()  
+parameter.ParameterName = "@DateTimeOffSet"  
+parameter.SqlDbType = SqlDbType.DateTimeOffSet  
+parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");  
+```  
+  
+### AddWithValue  
+ 次のコード フラグメントのように、<xref:System.Data.SqlClient.SqlCommand> の `AddWithValue` メソッドを使用してパラメーターを渡すこともできます。  ただし、`AddWithValue` メソッドでは <xref:System.Data.SqlClient.SqlParameter.DbType%2A> または <xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> をパラメーターに指定できません。  
+  
+```csharp  
+command.Parameters.AddWithValue(   
+    "@date", DateTimeOffset.Parse("16660902"));  
+```  
+  
+```vb  
+command.Parameters.AddWithValue( _  
+    "@date", DateTimeOffset.Parse("16660902"))  
+```  
+  
+ `@date` パラメーターは、サーバー上の `date`、`datetime`、または `datetime2` データ型にマッピングできます。  新しい `datetime` データ型を使用するときは、パラメーターの <xref:System.Data.SqlDbType> プロパティをそのインスタンスのデータ型に明示的に設定する必要があります。  <xref:System.Data.SqlDbType> の使用やパラメーター値の明示的な指定により、`datetime` および `smalldatetime` データ型との下位互換性の問題が発生する場合があります。  
+  
+ 次の表は、どの `SqlDbTypes` がどの CLR 型から推論されるかを示しています。  
+  
+|CLR 型|推論される SqlDbType|  
+|-----------|---------------------|  
+|DateTime|SqlDbType.DateTime|  
+|TimeSpan|SqlDbType.Time|  
+|DateTimeOffset|SqlDbType.DateTimeOffset|  
+  
+## 日付と時刻データの取得  
+ SQL Server 2008 の日付値および時刻値を取得するためのメソッドを次の表に示します。  
+  
+|SqlClient のメソッド|説明|  
+|---------------------|--------|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetDateTime%2A>|指定された列の値を <xref:System.DateTime> 構造体として取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetDateTimeOffset%2A>|指定された列の値を <xref:System.DateTimeOffset> 構造体として取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificFieldType%2A>|特定のフィールドについて、基になるプロバイダー固有の型を返します。  新しい date 型および time 型については、`GetFieldType` と同じ型が返されます。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificValue%2A>|指定された列の値を取得します。  新しい date 型および time 型については、`GetValue` と同じ型が返されます。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificValues%2A>|指定された配列の値を取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetSqlString%2A>|列の値を <xref:System.Data.SqlTypes.SqlString> として取得します。  データを `SqlString` で表現できない場合、<xref:System.InvalidCastException> が発生します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetSqlValue%2A>|列データを対応する既定の `SqlDbType` として取得します。  新しい date 型および time 型については、`GetValue` と同じ型が返されます。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetSqlValues%2A>|指定された配列の値を取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetString%2A>|Type System Version が SQL Server 2005 に設定されている場合、列の値を文字列として取得します。  データを文字列で表現できない場合、<xref:System.InvalidCastException> が発生します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetTimeSpan%2A>|指定された列の値を <xref:System.Timespan> 構造体として取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetValue%2A>|指定された列の値を、基になる CLR 型として取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetValues%2A>|配列内の列の値を取得します。|  
+|<xref:System.Data.SqlClient.SqlDataReader.GetSchemaTable%2A>|結果セットのメタデータを表す <xref:System.Data.DataTable> を返します。|  
+  
+> [!NOTE]
+>  新しい日付と時刻の `SqlDbTypes` は、SQL Server 内でインプロセスで実行されるコードではサポートされません。  そのような型の 1 つがサーバーに渡されると、例外が発生します。  
+  
+## 日付値と時刻値のリテラル指定  
+ 日付と時刻のデータ型は、さまざまなリテラル文字列形式を使用して指定できます。SQL Server は、実行時にそれらを内部の日付\/時刻構造体に変換します。  SQL Server は、単一引用符 \('\) で囲まれた日付と時刻のデータを認識します。  次に文字列形式の例を示します。  
+  
+-   英数字の日付書式 \(`'October 15, 2006'` など\)。  
+  
+-   数字の日付書式 \(`'10/15/2006'` など\)。  
+  
+-   区切りなしの文字列形式 \(`'20061015'` など\)。これは ISO 規格の日付書式では 2006 年 10 月 15 日と解釈されます。  
+  
+> [!NOTE]
+>  すべてのリテラル文字列形式と日付\/時刻データ型のその他の特徴については、SQL Server オンライン ブックに完全な説明が記載されています。  
+  
+ 時刻の値が 0 と 24 の間にない場合は、<xref:System.ArgumentException> がスローされます。  
+  
+## SQL Server 2008 オンライン ブックの関連トピック  
+ SQL Server 2008 での日付値と時刻値の使用方法の詳細については、SQL Server 2008 オンライン ブックで次の関連トピックを参照してください。  
+  
+|トピック|説明|  
+|----------|--------|  
+|[日付と時間のデータ型と関数 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=98360)|Transact\-SQL の日付と時刻のデータ型および関数の概要について説明します。|  
+|[日付と時間のデータの使用](http://go.microsoft.com/fwlink/?LinkId=98361)|日付と時刻のデータ型と関数の情報、および使用例を示します。|  
+|[データ型 \(Transact\-SQL\)](http://go.microsoft.com/fwlink/?LinkId=98362)|SQL Server 2008 のシステム データ型について説明します。|  
+  
+## 参照  
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/detecting-changes-with-sqldependency.md b/docs/framework/data/adonet/sql/detecting-changes-with-sqldependency.md
new file mode 100644
index 00000000000..884d34ac398
--- /dev/null
+++ b/docs/framework/data/adonet/sql/detecting-changes-with-sqldependency.md
@@ -0,0 +1,131 @@
+---
+title: "SqlDependency を使用した変更の検出 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e6a58316-f005-4477-92e1-45cc2eb8c5b4
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# SqlDependency を使用した変更の検出
+クエリ結果が最初に取得されたクエリ結果と異なることを検出するために、<xref:System.Data.SqlClient.SqlDependency> オブジェクトを <xref:System.Data.SqlClient.SqlCommand> に関連付けることができます。  さらに、`OnChange` イベントにデリゲートを割り当てることができます。このイベントは、関連付けられたコマンドの結果が変わったときに発生します。  コマンドを実行する前に、コマンドを <xref:System.Data.SqlClient.SqlDependency> に関連付ける必要があります。  また、<xref:System.Data.SqlClient.SqlDependency> の `HasChanges` プロパティを使用しても、データが最初に取得されて以降にクエリ結果が変化したかどうかを判別できます。  
+  
+## セキュリティの考慮事項  
+ 指定されたコマンドについて基になるデータが変更されたという通知を受け取るために、依存関係を持つインフラストラクチャでは <xref:System.Data.SqlClient.SqlDependency.Start%2A> が呼び出されると、<xref:System.Data.SqlClient.SqlConnection> が開かれることを利用します。  クライアントが `SqlDependency.Start` の呼び出しを開始できるかどうかは、<xref:System.Data.SqlClient.SqlClientPermission> を使用し、コード アクセス セキュリティ属性を利用することで制御します。  詳細については、「[クエリ通知の有効化](../../../../../docs/framework/data/adonet/sql/enabling-query-notifications.md)」および「[コード アクセス セキュリティと ADO.NET](../../../../../docs/framework/data/adonet/code-access-security.md)」を参照してください。  
+  
+### 例  
+ 次の手順に従って、依存関係を宣言し、コマンドを実行して、結果セットが変更された場合に通知を受け取ります。  
+  
+1.  サーバーへの `SqlDependency` 接続を開始します。  
+  
+2.  <xref:System.Data.SqlClient.SqlConnection> および <xref:System.Data.SqlClient.SqlCommand> オブジェクトを作成し、サーバーに接続して、Transact\-SQL ステートメントを定義します。  
+  
+3.  `SqlDependency` オブジェクトを新しく作成するか、既存のものを使用して、それを `SqlCommand` オブジェクトにバインドします。  内部的には、これによって <xref:System.Data.Sql.SqlNotificationRequest> オブジェクトが作成され、必要に応じてコマンド オブジェクトにバインドされます。  この通知要求には、この `SqlDependency` オブジェクトを一意に識別する内部 ID が含まれます。  クライアント リスナーがまだアクティブでない場合、それも起動されます。  
+  
+4.  `SqlDependency` オブジェクトの `OnChange` イベントにイベント ハンドラーを定期受信します。  
+  
+5.  `SqlCommand` オブジェクトの任意の `Execute` メソッドを使用して、コマンドを実行します。  このコマンドは通知オブジェクトにバインドされているため、サーバーは通知を生成する必要があることを認識し、キュー情報が依存関係を持つキューにポイントされます。  
+  
+6.  サーバーへの `SqlDependency` 接続を停止します。  
+  
+ その後、基になるデータをユーザーが変更すると、Microsoft SQL Server ではその変更に対する保留通知を検出し、通知を送信します。その通知は、`SqlDependency.Start` を呼び出すことで作成された基になる `SqlConnection` を利用して処理され、クライアントに転送されます。  クライアント リスナーは無効なメッセージを受け取ります。  クライアント リスナーでは、関連付けられている `SqlDependency` オブジェクトを特定し、`OnChange` イベントを発生させます。  
+  
+ 次のコード フラグメントに、サンプル アプリケーションの作成に利用されるデザイン パターンを示します。  
+  
+```vb  
+Sub Initialization()  
+    ' Create a dependency connection.  
+    SqlDependency.Start(connectionString, queueName)  
+End Sub  
+  
+Sub SomeMethod()   
+    ' Assume connection is an open SqlConnection.  
+    ' Create a new SqlCommand object.  
+    Using command As New SqlCommand( _  
+      "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers", _  
+      connection)  
+  
+        ' Create a dependency and associate it with the SqlCommand.  
+        Dim dependency As New SqlDependency(command)  
+        ' Maintain the refence in a class member.  
+        ' Subscribe to the SqlDependency event.  
+        AddHandler dependency.OnChange, AddressOf OnDependencyChange  
+  
+        ' Execute the command.  
+        Using reader = command.ExecuteReader()  
+            ' Process the DataReader.  
+        End Using  
+    End Using  
+End Sub   
+  
+' Handler method  
+Sub OnDependencyChange(ByVal sender As Object, _  
+    ByVal e As SqlNotificationEventArgs)   
+    ' Handle the event (for example, invalidate this cache entry).  
+End Sub  
+  
+Sub Termination()  
+    ' Release the dependency  
+    SqlDependency.Stop(connectionString, queueName)  
+End Sub  
+```  
+  
+```csharp  
+void Initialization()  
+{  
+    // Create a dependency connection.  
+    SqlDependency.Start(connectionString, queueName);  
+}  
+  
+void SomeMethod()  
+{  
+    // Assume connection is an open SqlConnection.  
+  
+    // Create a new SqlCommand object.  
+    using (SqlCommand command=new SqlCommand(  
+        "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers",   
+        connection))  
+    {  
+  
+        // Create a dependency and associate it with the SqlCommand.  
+        SqlDependency dependency=new SqlDependency(command);  
+        // Maintain the refence in a class member.  
+  
+        // Subscribe to the SqlDependency event.  
+        dependency.OnChange+=new  
+           OnChangeEventHandler(OnDependencyChange);  
+  
+        // Execute the command.  
+        using (SqlDataReader reader = command.ExecuteReader())  
+        {  
+            // Process the DataReader.  
+        }  
+    }  
+}  
+  
+// Handler method  
+void OnDependencyChange(object sender,   
+   SqlNotificationEventArgs e )  
+{  
+  // Handle the event (for example, invalidate this cache entry).  
+}  
+  
+void Termination()  
+{  
+    // Release the dependency.  
+    SqlDependency.Stop(connectionString, queueName);  
+}  
+```  
+  
+## 参照  
+ [SQL Server のクエリ通知](../../../../../docs/framework/data/adonet/sql/query-notifications-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/enabling-cross-database-access-in-sql-server.md b/docs/framework/data/adonet/sql/enabling-cross-database-access-in-sql-server.md
new file mode 100644
index 00000000000..862acbb2553
--- /dev/null
+++ b/docs/framework/data/adonet/sql/enabling-cross-database-access-in-sql-server.md
@@ -0,0 +1,67 @@
+---
+title: "SQL Server での複数データベースにまたがるアクセスの有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 10663fb6-434c-4c81-8178-ec894b9cf895
+caps.latest.revision: 10
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 10
+---
+# SQL Server での複数データベースにまたがるアクセスの有効化
+複数データベースの組み合わせ所有権は、あるデータベースのプロシージャが、別のデータベースのオブジェクトに依存している場合に作用します。  複数データベースの組み合わせ所有権は、単一データベースの組み合わせ所有権とほぼ同じように機能しますが、所有権の連鎖性を保つために、すべてのオブジェクトの所有者が同じログイン アカウントにマップされていることが必要です。  ソース データベース内のソース オブジェクトおよびターゲット データベース内のターゲット オブジェクトが同じログイン アカウントによって所有されている場合、ターゲット オブジェクトに対する権限は SQL Server によってチェックされません。  
+  
+## 既定で無効の機能  
+ 複数データベースにまたがる組み合わせ所有権は、既定では無効になっています。  次に示したように、複数データベースの組み合わせ所有権はセキュリティ上のリスクを伴うため無効にすることをお勧めします。  
+  
+-   `db_ddladmin` データベース ロールまたは `db_owners` データベース ロールのデータベース所有者およびメンバーは、他のユーザーによって所有されたオブジェクトを作成できます。  これらのオブジェクトが、他のデータベースのオブジェクトに依存している可能性もあります。  これは、複数データベースの組み合わせ所有権を有効にした場合、すべてのデータベースのデータについて、これらのユーザーを完全に信頼する必要があることを意味します。  
+  
+-   CREATE DATABASE 権限を持つユーザーは、新しいデータベースを作成したり、既存のデータベースをアタッチしたりできます。  複数データベースの組み合わせ所有権を有効にした場合、これらのユーザーが、新たに作成したデータベースから \(または、アタッチしたデータベースから\)、権限を持たない他のデータベース内のオブジェクトにアクセスできます。  
+  
+## 複数データベースの組み合わせ所有権の有効化  
+ 高い権限が与えられたユーザーを完全に信頼できる環境であれば、複数データベースの組み合わせ所有権を有効にすることができます。  複数データベースの組み合わせ所有権は、セットアップ時にすべてのデータベースを対象に構成できるほか、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] コマンドの `sp_configure` および `ALTER DATABASE` を使用して特定のデータベースを対象に構成することもできます。  
+  
+ 複数データベースの組み合わせ所有権を個別に構成するには、`sp_configure` を使用し、サーバーに対してこの機能を無効にします。  次に、ALTER DATABASE コマンドで SET DB\_CHAINING ON を指定し、必要なデータベースに対してのみ、複数データベースの組み合わせ所有権を構成します。  
+  
+ 次のサンプルでは、すべてのデータベースに対して複数データベースの組み合わせ所有権を有効にします。  
+  
+```  
+EXECUTE sp_configure 'show advanced', 1;  
+RECONFIGURE;  
+EXECUTE sp_configure 'cross db ownership chaining', 1;  
+RECONFIGURE;  
+```  
+  
+ 次のサンプルでは、特定のデータベースに対して複数データベースの組み合わせ所有権を有効にします。  
+  
+```  
+ALTER DATABASE Database1 SET DB_CHAINING ON;  
+ALTER DATABASE Database2 SET DB_CHAINING ON;  
+  
+```  
+  
+### 動的 SQL  
+ 動的に生成された SQL ステートメントの実行では、同じユーザーが両方のデータベースに存在しない限り、複数データベースの組み合わせ所有権は機能しません。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、別のデータベースのデータにアクセスするストアド プロシージャを作成し、両方のデータベースに存在する証明書でそのプロシージャに署名することによって、これを回避できます。  これにより、ユーザーは、データベースへのアクセス許可が付与されていなくても、そのプロシージャによって使用されるデータベース リソースにアクセスできるようになります。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|「[EXECUTE AS の使用によるデータベースの権限借用の拡張](http://msdn.microsoft.com/library/ms188304\(SQL.105\).aspx)」および「[cross db ownership chaining サーバー構成オプション](http://msdn.microsoft.com/library/ms188694.aspx) [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)]」オンライン ブック。|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のインスタンスに対して複数データベースの組み合わせ所有権を構成する方法を説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)   
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)   
+ [ADO.NET マネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/enabling-multiple-active-result-sets.md b/docs/framework/data/adonet/sql/enabling-multiple-active-result-sets.md
new file mode 100644
index 00000000000..dc7a992e639
--- /dev/null
+++ b/docs/framework/data/adonet/sql/enabling-multiple-active-result-sets.md
@@ -0,0 +1,120 @@
+---
+title: "複数のアクティブな結果セット (MARS) の有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 576079e4-debe-4ab5-9204-fcbe2ca7a5e2
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# 複数のアクティブな結果セット (MARS) の有効化
+複数のアクティブな結果セット \(MARS : Multiple Active Result Set\) は、SQL Server で動作する機能であり、複数のバッチを単一の接続で実行することができます。  SQL Server で使用できるように MARS が有効になっているときは、使用中の各コマンド オブジェクトは接続にセッションを追加します。  
+  
+> [!NOTE]
+>  単一の MARS セッションは、MARS 用に 1 つの論理接続を開いた後、アクティブな各コマンドにつき 1 つの論理接続を開きます。  
+  
+## 接続文字列で MARS を有効または無効にする  
+  
+> [!NOTE]
+>  次の接続文字列では、SQL Server に含まれるサンプルの **AdventureWorks** データベースを使用します。  指定されている接続文字列は、データベースが MSSQL1 という名前のサーバーにインストールされていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+ 既定では、MARS 機能は無効になっています。  この機能を有効にするには、キーワード ペア "MultipleActiveResultSet\=True" を接続文字列に追加します。"  True" は、MARS を有効にするための唯一の有効な値です。  次の例では、SQL Server のインスタンスに接続し、MARS が有効になるよう指定する方法について説明します。  
+  
+```vb  
+Dim connectionString As String = "Data Source=MSSQL1;" & _  
+    "Initial Catalog=AdventureWorks;Integrated Security=SSPI;" & _  
+    "MultipleActiveResultSets=True"  
+```  
+  
+```csharp  
+string connectionString = "Data Source=MSSQL1;" +   
+    "Initial Catalog=AdventureWorks;Integrated Security=SSPI;" +  
+    "MultipleActiveResultSets=True";  
+```  
+  
+ MARS を無効にするには、キーワード ペア "MultipleActiveResultSet\=False" を接続文字列に追加します。"  False" は、MARS を無効にするための唯一の有効な値です。  次の接続文字列では、MARS を無効にしています。  
+  
+```vb  
+Dim connectionString As String = "Data Source=MSSQL1;" & _  
+    "Initial Catalog=AdventureWorks;Integrated Security=SSPI;" & _  
+    "MultipleActiveResultSets=False"  
+```  
+  
+```csharp  
+string connectionString = "Data Source=MSSQL1;" +   
+    "Initial Catalog=AdventureWorks;Integrated Security=SSPI;" +  
+    "MultipleActiveResultSets=False";  
+```  
+  
+## MARS の使用に関する特記事項  
+ 一般に、MARS の有効な接続を使用するために、既存のアプリケーションを修正する必要はありません。  ただし、MARS 機能をご自分のアプリケーションで使用する場合、次の特記事項について理解しておく必要があります。  
+  
+### ステートメント インタリーブ  
+ MARS 操作は、サーバー上で同期して実行されます。  SELECT ステートメントと BULK INSERT ステートメントをインタリーブすることができます。  ただし、DML \(データ操作言語\) と DDL \(データ定義言語\) のステートメントはアトミック実行されます。  バッチのアトミック実行中にステートメントを実行しようとすると、いずれもブロックされます。  サーバーでの並列実行は MARS の機能ではありません。  
+  
+ MARS 接続において、SELECT ステートメントを含むバッチと DML ステートメントを含むバッチの 2 つが送信されると、SELECT ステートメントの実行中に DML の実行が開始されます。  ただし、DML ステートメントは SELECT ステートメントが進行する前に実行を完了しなければなりません。  両方のステートメントが同じトランザクションで実行されている場合、SELECT ステートメントの実行を開始した後に行われた DML ステートメントによる変更は、読み取り操作では表示されません。  
+  
+ SELECT ステートメント内の WAITFOR ステートメントは、待機中、つまり最初の行が作成されるまではトランザクションを生成しません。  これは、WAITFOR ステートメントが待機している間は、同一の接続内では他のいかなるバッチも実行されないことを意味します。  
+  
+### MARS セッションのキャッシュ  
+ MARS を有効にして接続が開かれている場合、論理セッションが作成されます。このセッションによってオーバーヘッドが増加します。  オーバーヘッドを最小化してパフォーマンスを向上させるため、**SqlClient** は接続内の MARS セッションをキャッシュします。  キャッシュには、最大 10 個の MARS セッションが含まれます。  ユーザーがこの値を変更することはできません。  セッションが限度に達すると新しいセッションが作成され、エラーは生成されません。  キャッシュとそのキャッシュに含まれるセッションは、接続ごとに作成されます。接続をまたいで共有されることはありません。  セッションが解放されると、プールの上限に達している場合を除き、セッションはプールに返されます。  キャッシュ プールがいっぱいになっている場合、セッションは閉じられます。  MARS セッションの有効期限は終了しません。  クリーンアップされるのは、接続オブジェクトが破棄されるときだけです。  MARS セッションのキャッシュはプリロードされません。  アプリケーションがさらに多くのセッションを要求したときに読み込まれます。  
+  
+### スレッド セーフ  
+ MARS 操作は、スレッド セーフではありません。  
+  
+### 接続プール  
+ MARS の有効な接続は、その他の接続と同じようにプールされます。  アプリケーションが 2 つの接続を開き、その一方は MARS が有効で他方は MARS が無効になっている場合、それら 2 つの接続は別々のプールに入れられます。  詳細については、「[SQL Server の接続プール \(ADO.NET\)](../../../../../docs/framework/data/adonet/sql-server-connection-pooling.md)」を参照してください。  
+  
+### SQL Server のバッチ実行環境  
+ 接続を開くとき、既定の環境が定義されます。  この環境は、MARS の論理セッションにコピーされます。  
+  
+ バッチ実行環境には、次のコンポーネントが含まれます。  
+  
+-   SET オプション \(ANSI\_NULLS、DATE\_FORMAT、LANGUAGE、TEXTSIZE など\)  
+  
+-   セキュリティ コンテキスト \(ユーザーまたはアプリケーションのロール\)  
+  
+-   データベース コンテキスト \(現在のデータベース\)  
+  
+-   実行状態を表す変数 \(@@ERROR、@@ROWCOUNT、@@FETCH\_STATUS、@@IDENTITY など\)  
+  
+-   最上位の一時テーブル  
+  
+ MARS を使用すると、既定の実行環境が接続に関連付けられます。  所定の接続で実行を開始する新しいバッチは、いずれも既定の環境のコピーを受け取ります。  コードが所定のバッチで実行されるときは、その環境に対して行われるすべての変更は、常に特定のバッチにスコープ設定されます。  実行が完了すると、実行の設定は既定の環境にコピーされます。  単一のバッチが複数のコマンドを発行し、それらが同じトランザクションで連続して実行される場合、そのセマンティクスは、以前のクライアントやサーバーを含む接続で公開されているときのセマンティクスと同じです。  
+  
+### 並列実行  
+ MARS は、アプリケーション内で複数の接続に対するすべての要件を削除するようには設計されていません。  アプリケーションがサーバーに対するコマンドの完全な並列実行を必要とする場合、複数の接続を使用する必要があります。  
+  
+ たとえば、次のようなシナリオがあるとします。  2 つのコマンド オブジェクトが作成され、一方は結果セットを処理し、もう一方はデータを更新するとします。それらは MARS を介して共通の接続を共有します。  このシナリオでは、最初のコマンド オブジェクトの結果をすべて読み取るまで、`Transaction`.`Commit` による更新に失敗し、次の例外が発生します。  
+  
+ メッセージ: トランザクション コンテキストを他のセッションが使用中です。  
+  
+ ソース: .Net SqlClient Data Provider  
+  
+ 期待される出力: \(null\)  
+  
+ 受信: System.Data.SqlClient.SqlException  
+  
+ このシナリオに対応するには、次の 3 つの方法があります。  
+  
+1.  リーダーが作成されてからトランザクションを開始し、リーダーがトランザクションの一部にならないようにします。  すべての更新は、それ自身のトランザクションになります。  
+  
+2.  リーダーが閉じてからすべての操作をコミットします。  この場合、後続の更新バッチが実行される可能性があります。  
+  
+3.  MARS を使用せず、代わりに MARS が導入される以前に行っていたように、コマンド オブジェクトごとに別々の接続を使用します。  
+  
+### MARS サポートの検出  
+ アプリケーションは、`SqlConnection.ServerVersion` の値を読み取って MARS サポートを確認することができます。  SQL Server 2005 のメジャー番号は 9、SQL Server 2008 のメジャー番号は 10 です。  
+  
+## 参照  
+ [複数のアクティブな結果セット \(MARS\)](../../../../../docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/enabling-query-notifications.md b/docs/framework/data/adonet/sql/enabling-query-notifications.md
new file mode 100644
index 00000000000..6339d851e9d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/enabling-query-notifications.md
@@ -0,0 +1,93 @@
+---
+title: "クエリ通知の有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5333e19-8e55-4aa9-82dc-ca8745e516ed
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# クエリ通知の有効化
+クエリ通知を使用するアプリケーションには、いくつか共通する要件があります。  SQL クエリ通知をサポートするには、データ ソースが正しく設定され、ユーザーがクライアント側およびサーバー側の正しい権限を所有している必要があります。  
+  
+ クエリ通知を使用するためには、次のことが必要です。  
+  
+-   データベースのクエリ通知を有効にする  
+  
+-   データベースへの接続に使用するユーザー ID に対して、必要なアクセス許可を設定する  
+  
+-   <xref:System.Data.SqlClient.SqlCommand> オブジェクトを使用して、関連する通知オブジェクト \(<xref:System.Data.SqlClient.SqlDependency> または <xref:System.Data.Sql.SqlNotificationRequest> のいずれか\) を持つ有効な SELECT ステートメントを実行する  
+  
+-   監視対象のデータが変更された場合に通知を処理するコードを設定する  
+  
+## クエリ通知の要件  
+ クエリ通知は、特定の要件を満たす SELECT ステートメントでのみサポートされます。  次の表に、SQL Server オンライン ブックの Service Broker とクエリ通知に関するドキュメントへのリンクを示します。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [クエリ通知の作成](http://msdn.microsoft.com/library/ms181122.aspx)  
+  
+-   [Service Broker のセキュリティに関する注意点](http://msdn.microsoft.com/library/ms166059.aspx)  
+  
+-   [セキュリティと保護 \(Service Broker\)](http://msdn.microsoft.com/library/bb522911.aspx)  
+  
+-   [Notification Services のセキュリティに関する注意点](http://msdn.microsoft.com/library/ms172604.aspx)  
+  
+-   [クエリ通知の権限](http://msdn.microsoft.com/library/ms188311.aspx)  
+  
+-   [Service Broker の国際化に関する注意点](http://msdn.microsoft.com/library/ms166028.aspx)  
+  
+-   [ソリューション設計に関する考慮事項 \(Service Broker\)](http://msdn.microsoft.com/library/bb522899.aspx)  
+  
+-   [Service Broker 開発者向けの情報](http://msdn.microsoft.com/library/ms166100.aspx)  
+  
+-   [開発者ガイド \(Service Broker\)](http://msdn.microsoft.com/library/bb522908.aspx)  
+  
+## サンプル コードを実行するためのクエリ通知の有効化  
+ **AdventureWorks** データベースで Service Broker を有効にするには、SQL Server Management Studio を通じて、次の Transact\-SQL ステートメントを実行します。  
+  
+ `ALTER DATABASE AdventureWorks SET ENABLE_BROKER;`  
+  
+ クエリ通知のサンプルを正しく実行するには、次の Transact\-SQL ステートメントをデータベース サーバー上で実行する必要があります。  
+  
+```  
+CREATE QUEUE ContactChangeMessages;  
+  
+CREATE SERVICE ContactChangeNotifications  
+  ON QUEUE ContactChangeMessages  
+([http://schemas.microsoft.com/SQL/Notifications/PostQueryNotification]);  
+```  
+  
+## クエリ通知のアクセス許可  
+ 通知を要求するコマンドを実行するユーザーは、特定のサーバーに対する SUBSCRIBE QUERY NOTIFICATIONS データベース アクセス許可を必要とします。  
+  
+ 部分信頼の状態で実行されるクライアント側のコードには、<xref:System.Data.SqlClient.SqlClientPermission> が必要です。  
+  
+ 次のコードでは、<xref:System.Data.SqlClient.SqlClientPermission> オブジェクトを作成して、<xref:System.Security.Permissions.PermissionState> を <xref:System.Security.Permissions.PermissionState> に設定します。  <xref:System.Security.CodeAccessPermission.Demand%2A> を指定すると、呼び出し履歴の上流に、権限の付与されていない呼び出し元が 1 つでも存在した場合、実行時に強制的に <xref:System.Security.SecurityException> が発生します。  
+  
+ [!code-csharp[DataWorks SqlNotification.Perms#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlNotification.Perms/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlNotification.Perms#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlNotification.Perms/VB/source.vb#1)]  
+  
+## 通知オブジェクトの選択  
+ クエリ通知 API は、通知を処理するために <xref:System.Data.SqlClient.SqlDependency> と <xref:System.Data.Sql.SqlNotificationRequest> という 2 つのオブジェクトを提供します。  通常、ASP.NET 以外のほとんどのアプリケーションでは、<xref:System.Data.SqlClient.SqlDependency> オブジェクトを使用する必要があります。  ASP.NET アプリケーションは、高レベルの <xref:System.Web.Caching.SqlCacheDependency> を使用する必要があります。これは <xref:System.Data.SqlClient.SqlDependency> をラップし、通知オブジェクトとキャッシュ オブジェクトを管理するためのフレームワークになります。  
+  
+### SqlDependency の使用  
+ <xref:System.Data.SqlClient.SqlDependency> を使用するには、使用する SQL Server データベースに対して Service Broker を有効にし、通知を受け取るためのアクセス許可をユーザーに与える必要があります。  通知キューなどの Service Broker オブジェクトは、あらかじめ定義されています。  
+  
+ さらに、<xref:System.Data.SqlClient.SqlDependency> によってワーカー スレッドが自動的に開始され、キューにポストされた通知を処理すると共に、Service Broker メッセージが解析され、情報がイベント引数データとして公開されます。  <xref:System.Data.SqlClient.SqlDependency> は `Start` メソッドを呼び出し、データベースに対する依存関係を設定して初期化する必要があります。  これは、必要となる各データベース接続に対するアプリケーション初期化中に、1 回だけ呼び出す必要がある静的メソッドです。  `Stop` メソッドは、作成された依存関係を持つ接続それぞれのアプリケーションの終了時に呼び出す必要があります。  
+  
+### SqlNotificationRequest の使用  
+ これに対し <xref:System.Data.Sql.SqlNotificationRequest> では、待機するインフラストラクチャ全体を自分で実装する必要があります。  さらに、キュー、サービス、およびキューによってサポートされるメッセージの種類など、サポート対象となるすべての Service Broker オブジェクトを定義する必要があります。  手動によるこの方法は、使用しているアプリケーションで特殊な通知メッセージや通知動作が必要な場合、またはそのアプリケーションが Service Broker アプリケーションの一部である場合に使用すると便利です。  
+  
+## 参照  
+ [SQL Server のクエリ通知](../../../../../docs/framework/data/adonet/sql/query-notifications-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/enumerating-instances-of-sql-server.md b/docs/framework/data/adonet/sql/enumerating-instances-of-sql-server.md
new file mode 100644
index 00000000000..991b5c2e0c9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/enumerating-instances-of-sql-server.md
@@ -0,0 +1,133 @@
+---
+title: "SQL Server のインスタンスの列挙 (ADO.NET) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ddf1c83c-9d40-45e6-b04d-9828c6cbbfdc
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# SQL Server のインスタンスの列挙 (ADO.NET)
+[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、アプリケーションは現在のネットワーク内の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンスを検索できます。  <xref:System.Data.Sql.SqlDataSourceEnumerator> クラスは、表示可能なすべてのサーバーに関する情報が含まれた <xref:System.Data.DataTable> を提供することで、アプリケーション開発者にこの情報を公開します。  このときに返されるテーブルには、ユーザーが新しい接続を作成しようとして、\[接続プロパティ\] ダイアログ ボックスで、利用可能なすべてのサーバーが含まれたドロップダウン リストを展開したときに表示されるリストと一致するサーバー インスタンスのリストが含まれています。  結果には一部のインスタンスが表示されないことがあります。  
+  
+> [!NOTE]
+>  大半の Windows サービスと同様に、できるだけ少ない特権で SQL Browser サービスを実行することをお勧めします。  SQL Browser サービスの詳細および SQL Browser サービスの動作を管理する方法については、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックを参照してください。  
+  
+## 列挙子インスタンスの取得  
+ 使用可能な [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンスに関する情報を含むテーブルを取得するには、まず、共有プロパティまたは静的プロパティである <xref:System.Data.Sql.SqlDataSourceEnumerator.Instance%2A> プロパティを使用して列挙子を取得する必要があります。  
+  
+```vb  
+Dim instance As System.Data.Sql.SqlDataSourceEnumerator = _  
+   System.Data.Sql.SqlDataSourceEnumerator.Instance  
+```  
+  
+```csharp  
+System.Data.Sql.SqlDataSourceEnumerator instance =   
+   System.Data.Sql.SqlDataSourceEnumerator.Instance  
+```  
+  
+ 静的なインスタンスを取得したら、使用可能なサーバーに関する情報が含まれた <xref:System.Data.DataTable> を返す <xref:System.Data.Sql.SqlDataSourceEnumerator.GetDataSources%2A> メソッドを呼び出すことができます。  
+  
+```vb  
+Dim dataTable As System.Data.DataTable = instance.GetDataSources()  
+```  
+  
+```csharp  
+System.Data.DataTable dataTable = instance.GetDataSources();  
+```  
+  
+ このメソッド呼び出しから返されるテーブルには、次の列が含まれています。これらすべての列に `string` 値が含まれています。  
+  
+|Column|説明|  
+|------------|--------|  
+|**ServerName**|サーバーの名前。|  
+|**InstanceName**|サーバー インスタンスの名前。  サーバーが既定のインスタンスとして実行されている場合は空白になります。|  
+|**IsClustered**|サーバーがクラスターの一部になっているかどうかを示します。|  
+|**バージョン**|サーバーのバージョン。  次に例を示します。<br /><br /> -   9.00.x \([!INCLUDE[ssVersion2005](../../../../../includes/ssversion2005-md.md)]\)<br />-   10.0.xx \([!INCLUDE[ssKatmai](../../../../../includes/sskatmai-md.md)]\)<br />-   10.50.x \([!INCLUDE[ssKilimanjaro](../../../../../includes/sskilimanjaro-md.md)]\)<br />-   11.0.xx \([!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012\)|  
+  
+## 列挙の制約  
+ 使用可能なサーバーの一部が表示されないことがあります。  サーバーの一覧は、タイムアウトやネットワーク トラフィックなどの要因によって異なることがあります。  そのため、2 回続けて呼び出しても、呼び出しごとにリストが異なる可能性があります。  同じネットワーク上のサーバーのみがリストに表示されます。  通常、ブロードキャスト パケットはルーターを経由しません。そのため、特定のサーバーがリストに表示されないことがありますが、その状態はいつ呼び出しを行っても変わりません。  
+  
+ 一覧に含まれているサーバーは、`IsClustered` やバージョンなどの追加情報を持っている場合も、持っていない場合もあります。  サーバーが持っている情報は、一覧が取得された方法によって異なります。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] Browser サービスを介して一覧に表示されるサーバーには、一覧に名前しか表示されない、Windows インフラストラクチャを介して検索されたサーバーより多くの詳細情報が含まれています。  
+  
+> [!NOTE]
+>  サーバー列挙は、完全に信頼された環境で実行している場合にのみ利用できます。  部分的に信頼された環境で実行されているアセンブリは、<xref:System.Data.SqlClient.SqlClientPermission> Code Access Security \(CAS\) アクセス許可を持っている場合でも、サーバー列挙を使用できません。  
+  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、SQL Browser という名前の外部の Windows サービスを利用して、<xref:System.Data.Sql.SqlDataSourceEnumerator> に情報を提供します。  このサービスは既定で有効になりますが、管理者がこのサービスをオフにしたり無効にしたりすると、サーバー インスタンスがこのクラスから見えなくなります。  
+  
+## 例  
+ 次のコンソール アプリケーションは、表示可能なすべての [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンスに関する情報を取得し、その情報をコンソール ウィンドウに表示します。  
+  
+```vb  
+Imports System.Data.Sql  
+  
+Module Module1  
+  Sub Main()  
+    ' Retrieve the enumerator instance and then the data.  
+    Dim instance As SqlDataSourceEnumerator = _  
+     SqlDataSourceEnumerator.Instance  
+    Dim table As System.Data.DataTable = instance.GetDataSources()  
+  
+    ' Display the contents of the table.  
+    DisplayData(table)  
+  
+    Console.WriteLine("Press any key to continue.")  
+    Console.ReadKey()  
+  End Sub  
+  
+  Private Sub DisplayData(ByVal table As DataTable)  
+    For Each row As DataRow In table.Rows  
+      For Each col As DataColumn In table.Columns  
+        Console.WriteLine("{0} = {1}", col.ColumnName, row(col))  
+      Next  
+      Console.WriteLine("============================")  
+    Next  
+  End Sub  
+End Module  
+```  
+  
+```csharp  
+using System.Data.Sql;  
+  
+class Program  
+{  
+  static void Main()  
+  {  
+    // Retrieve the enumerator instance and then the data.  
+    SqlDataSourceEnumerator instance =  
+      SqlDataSourceEnumerator.Instance;  
+    System.Data.DataTable table = instance.GetDataSources();  
+  
+    // Display the contents of the table.  
+    DisplayData(table);  
+  
+    Console.WriteLine("Press any key to continue.");  
+    Console.ReadKey();  
+  }  
+  
+  private static void DisplayData(System.Data.DataTable table)  
+  {  
+    foreach (System.Data.DataRow row in table.Rows)  
+    {  
+      foreach (System.Data.DataColumn col in table.Columns)  
+      {  
+        Console.WriteLine("{0} = {1}", col.ColumnName, row[col]);  
+      }  
+      Console.WriteLine("============================");  
+    }  
+  }  
+}  
+```  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/filestream-data.md b/docs/framework/data/adonet/sql/filestream-data.md
new file mode 100644
index 00000000000..758a35211dd
--- /dev/null
+++ b/docs/framework/data/adonet/sql/filestream-data.md
@@ -0,0 +1,231 @@
+---
+title: "FILESTREAM データ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd8b845c-0f09-4295-b466-97ef106eefa8
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# FILESTREAM データ
+FILESTREAM ストレージ属性は、varbinary\(max\) 列に格納されるバイナリ \(BLOB\) データに対応しています。  FILESTREAM の導入前は、バイナリ データの格納するために特別な処理が必要でした。  テキスト ドキュメント、イメージ、ビデオなどの非構造化データはデータベース外に保存されることが多く、そのために管理が困難でした。  
+  
+> [!NOTE]
+>  SqlClient を使用して FILESTREAM データを操作するには、.NET Framework 3.5 SP1 以降をインストールする必要があります。  
+  
+ varbinary\(max\) 列に FILESTREAM 属性を指定すると、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、データがデータベース ファイルではなくローカルの NTFS ファイル システムに保存されます。  データは個別に保存されますが、データベースに保存されている varbinary\(max\) データの操作のためにサポートされているのと同じ [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] ステートメントを使用できます。  
+  
+## FILESTREAM の SqlClient サポート  
+ [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] \(<xref:System.Data.SqlClient>\) は、<xref:System.Data.SqlTypes> 名前空間で定義された <xref:System.Data.SqlTypes.SqlFileStream> クラスを使用して、FILESTREAM データの読み取りと書き込みをサポートします。  `SqlFileStream` は <xref:System.IO.Stream> クラスを継承します。このクラスは、データのストリームへの読み込みと書き込みを行うためのメソッドを提供します。  ストリームからデータを読み取ると、データはストリームからバイトの配列などのデータ構造に転送されます。  書き込みを行うと、データはデータ構造からストリームに転送されます。  
+  
+### [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] テーブルの作成  
+ 次の [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] ステートメントでは、従業員の名前の付いたテーブルを作成し、データ行を挿入します。  FILESTREAM ストレージを有効にすると、このテーブルを次のようなコード例と共に使用できます。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの関連トピックへのリンクは、このトピックの最後にあります。  
+  
+```  
+CREATE TABLE employees  
+(  
+  EmployeeId INT  NOT NULL  PRIMARY KEY,  
+  Photo VARBINARY(MAX) FILESTREAM  NULL,  
+  RowGuid UNIQUEIDENTIFIER  NOT NULL  ROWGUIDCOL  
+  UNIQUE DEFAULT NEWID()  
+)  
+GO  
+Insert into employees  
+Values(1, 0x00, default)  
+GO  
+  
+```  
+  
+### 例: FILESTREAM データの読み取り、上書き、および挿入  
+ 次のサンプルでは、FILESTREAM からデータを読み取る方法を示します。  コードはファイルへの論理パスを取得し、`FileAccess` を `Read` に、`FileOptions` を `SequentialScan` に設定します。  次に、コードは SqlFileStream からバイトをバッファーに読み取ります。  バイトはコンソール ウィンドウに書き込まれます。  
+  
+ また、このサンプルでは、すべての既存のデータを上書きする FILESTREAM にデータを書き込む方法も示します。  コードはファイルへの論理パスを取得し、`SqlFileStream` を作成し、`FileAccess` を `Write` に、`FileOptions` を `SequentialScan` に設定します。  1 バイトが `SqlFileStream` に書き込まれ、ファイルのデータは置換されます。  
+  
+ このサンプルでは、Seek メソッドを使用してファイルの末尾にデータを追加することによって、データを FILESTREAM に書き込む方法も示します。  コードはファイルへの論理パスを取得し、`SqlFileStream` を作成し、`FileAccess` を `ReadWrite` に、`FileOptions` を `SequentialScan` に設定します。  コードは Seek メソッドを使用してファイルの末尾をシークし、1 バイトを既存のファイルに追加します。  
+  
+```csharp  
+using System;  
+using System.Data.SqlClient;  
+using System.Data.SqlTypes;  
+using System.Data;  
+using System.IO;  
+  
+namespace FileStreamTest  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder("server=(local);integrated security=true;database=myDB");  
+            ReadFilestream(builder);  
+            OverwriteFilestream(builder);  
+            InsertFilestream(builder);  
+  
+            Console.WriteLine("Done");  
+        }  
+  
+        private static void ReadFilestream(SqlConnectionStringBuilder connStringBuilder)  
+        {  
+            using (SqlConnection connection = new SqlConnection(connStringBuilder.ToString()))  
+            {  
+                connection.Open();  
+                SqlCommand command = new SqlCommand("SELECT TOP(1) Photo.PathName(), GET_FILESTREAM_TRANSACTION_CONTEXT() FROM employees", connection);  
+  
+                SqlTransaction tran = connection.BeginTransaction(IsolationLevel.ReadCommitted);  
+                command.Transaction = tran;  
+  
+                using (SqlDataReader reader = command.ExecuteReader())  
+                {  
+                    while (reader.Read())  
+                    {  
+                        // Get the pointer for the file  
+                        string path = reader.GetString(0);  
+                        byte[] transactionContext = reader.GetSqlBytes(1).Buffer;  
+  
+                        // Create the SqlFileStream  
+                        using (Stream fileStream = new SqlFileStream(path, transactionContext, FileAccess.Read, FileOptions.SequentialScan, allocationSize: 0))  
+                        {  
+                            // Read the contents as bytes and write them to the console  
+                            for (long index = 0; index < fileStream.Length; index++)  
+                            {  
+                                Console.WriteLine(fileStream.ReadByte());  
+                            }  
+                        }  
+                    }  
+                }  
+                tran.Commit();  
+            }  
+        }  
+  
+        private static void OverwriteFilestream(SqlConnectionStringBuilder connStringBuilder)  
+        {  
+            using (SqlConnection connection = new SqlConnection(connStringBuilder.ToString()))  
+            {  
+                connection.Open();  
+  
+                SqlCommand command = new SqlCommand("SELECT TOP(1) Photo.PathName(), GET_FILESTREAM_TRANSACTION_CONTEXT() FROM employees", connection);  
+  
+                SqlTransaction tran = connection.BeginTransaction(IsolationLevel.ReadCommitted);  
+                command.Transaction = tran;  
+  
+                using (SqlDataReader reader = command.ExecuteReader())  
+                {  
+                    while (reader.Read())  
+                    {  
+                        // Get the pointer for file   
+                        string path = reader.GetString(0);  
+                        byte[] transactionContext = reader.GetSqlBytes(1).Buffer;  
+  
+                        // Create the SqlFileStream  
+                        using (Stream fileStream = new SqlFileStream(path, transactionContext, FileAccess.Write, FileOptions.SequentialScan, allocationSize: 0))  
+                        {  
+                            // Write a single byte to the file. This will  
+                            // replace any data in the file.  
+                            fileStream.WriteByte(0x01);  
+                        }  
+                    }  
+                }  
+                tran.Commit();  
+            }  
+        }  
+  
+        private static void InsertFilestream(SqlConnectionStringBuilder connStringBuilder)  
+        {  
+            using (SqlConnection connection = new SqlConnection(connStringBuilder.ToString()))  
+            {  
+                connection.Open();  
+  
+                SqlCommand command = new SqlCommand("SELECT TOP(1) Photo.PathName(), GET_FILESTREAM_TRANSACTION_CONTEXT() FROM employees", connection);  
+  
+                SqlTransaction tran = connection.BeginTransaction(IsolationLevel.ReadCommitted);  
+                command.Transaction = tran;  
+  
+                using (SqlDataReader reader = command.ExecuteReader())  
+                {  
+                    while (reader.Read())  
+                    {  
+                        // Get the pointer for file  
+                        string path = reader.GetString(0);  
+                        byte[] transactionContext = reader.GetSqlBytes(1).Buffer;  
+  
+                        using (Stream fileStream = new SqlFileStream(path, transactionContext, FileAccess.Write, FileOptions.SequentialScan, allocationSize: 0))  
+                        {  
+                            // Seek to the end of the file  
+                            fileStream.Seek(0, SeekOrigin.End);  
+  
+                            // Append a single byte   
+                            fileStream.WriteByte(0x01);  
+                        }  
+                    }  
+                }  
+                tran.Commit();  
+            }  
+  
+        }  
+    }  
+} using (SqlConnection connection = new SqlConnection(  
+    connStringBuilder.ToString()))  
+{  
+    connection.Open();  
+  
+    SqlCommand command = new SqlCommand("", connection);  
+    command.CommandText = "select Top(1) Photo.PathName(), "  
+    + "GET_FILESTREAM_TRANSACTION_CONTEXT () from employees";  
+  
+    SqlTransaction tran = connection.BeginTransaction(  
+        System.Data.IsolationLevel.ReadCommitted);  
+    command.Transaction = tran;  
+  
+    using (SqlDataReader reader = command.ExecuteReader())  
+    {  
+        while (reader.Read())  
+        {  
+            // Get the pointer for file  
+            string path = reader.GetString(0);  
+            byte[] transactionContext = reader.GetSqlBytes(1).Buffer;  
+  
+            FileStream fileStream = new SqlFileStream(path,  
+                (byte[])reader.GetValue(1),  
+                FileAccess.ReadWrite,  
+                FileOptions.SequentialScan, 0);  
+  
+            // Seek to the end of the file  
+            fs.Seek(0, SeekOrigin.End);  
+  
+            // Append a single byte   
+            fileStream.WriteByte(0x01);  
+            fileStream.Close();  
+        }  
+    }  
+    tran.Commit();  
+}  
+```  
+  
+ 別のサンプルについては、「[ファイル ストリーム列へのバイナリ データの格納および取得方法](http://www.codeproject.com/Articles/32216/How-to-store-and-fetch-binary-data-into-a-file-str)」を参照してください。  
+  
+## [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの関連トピック  
+ FILESTREAM の詳細なドキュメントは、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの次のセクションにあります。  
+  
+|トピック|説明|  
+|----------|--------|  
+|[FILESTREAM ストレージの設計と実装](http://msdn2.microsoft.com/library/bb895234\(SQL.105\).aspx)|FILESTREAM ドキュメントと関連項目へのリンクを示します。|  
+|[FILESTREAM の概要](http://msdn2.microsoft.com/library/bb933993\(SQL.105\).aspx)|FILESTREAM ストレージを使用するタイミング、および SQL Server データベース エンジンと NTFS ファイル システムを統合する方法について説明します。|  
+|[FILESTREAM ストレージの概要](http://msdn.microsoft.com/library/bb933995\(SQL.105\).aspx)|FILESTREAM を SQL Server のインスタンス上で有効にする方法、データベースと FILESTREAM データを格納するテーブルの作成方法、および FILESTREAM データを含んでいる行の操作方法について説明します。|  
+|[クライアント アプリケーションでの FILESTREAM ストレージの使用](http://msdn.microsoft.com/library/bb933877\(SQL.105\).aspx)|FILESTREAM データを操作するための Win32 API 関数について説明します。|  
+|[FILESTREAM と SQL Server のその他の機能の使用](http://msdn.microsoft.com/library/bb895334\(SQL.105\).aspx)|FILESTREAM データを SQL Server の他の機能と共に使用する際の注意事項、ガイドライン、および制限事項について説明します。|  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [コード アクセス セキュリティと ADO.NET](../../../../../docs/framework/data/adonet/code-access-security.md)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/granting-row-level-permissions-in-sql-server.md b/docs/framework/data/adonet/sql/granting-row-level-permissions-in-sql-server.md
new file mode 100644
index 00000000000..77ba67d1901
--- /dev/null
+++ b/docs/framework/data/adonet/sql/granting-row-level-permissions-in-sql-server.md
@@ -0,0 +1,66 @@
+---
+title: "SQL Server における行レベルのアクセス許可の付与 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a55aaa12-34ab-41cd-9dec-fd255b29258c
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server における行レベルのアクセス許可の付与
+権限を単に付与、取り消し、拒否するよりも細かなレベルで、データに対するアクセスを制御することが必要な場合があります。 たとえば、医療施設のデータベース アプリケーションでは、各医師がアクセスできるのは、自分が担当している患者の情報のみに制限する必要があります。 同様の要件は、金融機関、司法機関、政府機関、軍事機関のアプリケーションなど、さまざまな環境で考えられます。 こうしたシナリオに対処するため SQL Server 2016 には、[行レベルのセキュリティ](https://msdn.microsoft.com/library/dn765131.aspx)機能が備わっています。この機能は、セキュリティ ポリシーにおける行レベルのアクセス ロジックを簡略化および一元化します。 従来の SQL Server バージョンでは、同様の機能は行レベルのフィルター処理を行うビューを使用して実現できます。  
+  
+## 行レベルのフィルター処理の実装  
+ 行レベルのフィルター処理は、前述の病院の例などのように、1 つのテーブルに情報を格納するアプリケーションで使用されます。 行レベルのフィルター処理を実装するため、それぞれの行には、ユーザー名、ラベル、識別子など、区別するパラメーターを定義する列があります。 対象テーブルでセキュリティ ポリシーまたはビューを作成し、ユーザーがアクセスできる行をフィルター処理します。 その後、パラメーター化されたストアド プロシージャを作成し、ユーザーが実行できるクエリの種類を制御します。  
+  
+ 次の例は、ユーザー名またはログイン名に基づいて行レベルのフィルター処理を構成する方法を示しています。  
+  
+-   テーブルを作成し、名前を格納するための列を追加します。  
+  
+-   行レベルのフィルター処理を以下のように有効にします。  
+  
+    -   SQL Server 2016 以降または [Azure SQL Database](https://azure.microsoft.com/documentation/services/sql-database/) を使用している場合は、表に関する述語を追加するセキュリティー ポリシーを作成します。このセキュリティー・ポリシーは、現在のデータベース ユーザー \(CURRENT\_USER\(\) 組み込み関数を使用\) または現在のログイン名 \(SUSER\_SNAME\(\) 組み込み関数を使用\) のいずれかに一致する行のみが返されるように制限します。  
+  
+        ```tsql  
+        CREATE SCHEMA Security GO CREATE FUNCTION Security.userAccessPredicate(@UserName sysname) RETURNS TABLE WITH SCHEMABINDING AS RETURN SELECT 1 AS accessResult WHERE @UserName = SUSER_SNAME() GO CREATE SECURITY POLICY Security.userAccessPolicy ADD FILTER PREDICATE Security.userAccessPredicate(UserName) ON dbo.MyTable, ADD BLOCK PREDICATE Security.userAccessPredicate(UserName) ON dbo.MyTable GO  
+        ```  
+  
+    -   SQL Server 2016 より前のバージョンを使用している場合、同様の機能はビューを使用して実現できます。  
+  
+        ```tsql  
+        CREATE VIEW vw_MyTable AS RETURN SELECT * FROM MyTable WHERE UserName = SUSER_SNAME() GO  
+  
+        ```  
+  
+-   データを選択、挿入、更新、削除するストアド プロシージャを作成します。 フィルター処理を行うのにセキュリティ ポリシーを使用する場合には、ストアド プロシージャが基本テーブルでこれらの操作を直接実行する必要があります。フィルター処理がビューによって行われる場合、ストアド プロシージャがビューのためにビューに対して操作を行わなければなりません。 セキュリティ ポリシーまたはビューは、ユーザーのクエリによって返される行または変更された行を自動的にフィルター処理します。ストアド プロシージャは堅固なセキュリティ境界を設け、クエリに対して直接アクセスできるユーザーが、クエリを正常に実行し、フィルター対象データの存在を推論できてしまうという事態を回避します。  
+  
+-   データの挿入を行うストアド プロシージャの場合、セキュリティ ポリシーまたはビューで指定したのと同じ関数を使用してユーザー名を取得し、その値を UserName 列に挿入します。  
+  
+-   テーブル \(該当する場合にはビューも\) に設定されている `public` ロールの権限をすべて拒否します。 フィルター処理の述語には、ロールではなくユーザー名またはログイン名が使用されているため、ユーザーは、他のデータベース ロールから権限を継承することはできなくなります。  
+  
+-   データベース ロールにストアド プロシージャの EXECUTE 権限を付与します。 ユーザーは、提供されているストアド プロシージャを使ってのみ、データにアクセスできるようになります。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|||  
+|-|-|  
+|[SQL Server 2005 を使用して機密データベースに行レベルとセル レベルのセキュリティを実装する方法](http://go.microsoft.com/fwlink/?LinkId=98227) \(SQL Server TechCenter サイト\)|行レベルとセル レベルのセキュリティを使用して、機密データベースのセキュリティ要件を満たす方法について説明します。|  
+  
+## 参照  
+ [行レベルのセキュリティ](https://msdn.microsoft.com/library/dn765131.aspx)   
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)   
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/handling-null-values.md b/docs/framework/data/adonet/sql/handling-null-values.md
new file mode 100644
index 00000000000..56d1ebd8c77
--- /dev/null
+++ b/docs/framework/data/adonet/sql/handling-null-values.md
@@ -0,0 +1,152 @@
+---
+title: "NULL 値の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f18b288f-b265-4bbe-957f-c6833c0645ef
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# NULL 値の処理
+列の値が不明または欠落している場合は、リレーショナル データベースの NULL 値が使用されます。  NULL は空文字列 \(文字または日付時刻データ型\) でもゼロ値 \(数値データ型\) でもありません。  ANSI SQL\-92 の規格では、すべてのデータ型について NULL は同一でなければならないと規定されているため、すべての NULL が一貫して処理されます。  <xref:System.Data.SqlTypes> 名前空間では、<xref:System.Data.SqlTypes.INullable> インターフェイスを実装することで NULL セマンティクスが提供されます。  <xref:System.Data.SqlTypes> 内の各データ型には、それぞれ独自に `IsNull` プロパティと `Null` 値があり、データ型のインスタンスに割り当てることができます。  
+  
+> [!NOTE]
+>  .NET Framework version 2.0 では、NULL 許容型がサポートされました。この型を使用することで、値型を拡張して基になる型のすべての値を表すことができます。  これらの CLR NULL 許容型は、<xref:System.Nullable> 構造体のインスタンスを表します。  この機能は、値の型がボックスまたはアンボックスされるときに特に有効であり、オブジェクト型との互換性が強化されます。  ANSI SQL の NULL は `null` 参照 \(Visual Basic では `Nothing`\) と動作が異なるため、CLR NULL 許容型は NULL のデータベースへの格納を意図したものではありません。  データベースの ANSI SQL NULL 値を操作するには、<xref:System.Nullable> ではなく <xref:System.Data.SqlTypes> NULL を使用します。  CLR NULL 許容型の操作の詳細については、Visual Basic の場合は「[Nullable Value Types](../Topic/Nullable%20Value%20Types%20\(Visual%20Basic\).md)」、C\# の場合は「[Null 許容型の使用](../Topic/Using%20Nullable%20Types%20\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+## NULL および 3 つの値を持つロジック  
+ 列定義に NULL 値を許可することで、3 つの値を持つロジックをアプリケーションに定義できます。  比較によって、次の 3 つの条件のうちの 1 つを評価できます。  
+  
+-   True  
+  
+-   False  
+  
+-   不明  
+  
+ NULL は不明であるとされるため、2 つの NULL 値を相互に比較した場合、同等であるとは見なされません。  算術演算子を使用する式では、オペランドのいずれかが NULL である場合は結果も NULL になります。  
+  
+## NULL および SqlBoolean  
+ <xref:System.Data.SqlTypes> 間の比較により、<xref:System.Data.SqlTypes.SqlBoolean> が返されます。  各 `SqlType` の `IsNull` 関数により、<xref:System.Data.SqlTypes.SqlBoolean> が返され、NULL 値の確認に使用できます。  次の truth テーブルは、NULL 値がある場合の AND、OR、および NOT 演算子の機能を示します   \(T\=true、F\=false、U\=不明または NULL\)。  
+  
+ ![真理値表](../../../../../docs/framework/data/adonet/sql/media/truthtable-bpuedev11.png "TruthTable\_bpuedev11")  
+  
+### ANSI\_NULLS オプションについて  
+ <xref:System.Data.SqlTypes> では、ANSI\_NULLS オプションが SQL Server で設定された場合と同じセマンティクスになります。  すべての算術演算子 \(\+、\-、\*、\/、%\)、ビット演算子 \(~、&、&#124;\)、およびほとんどの関数では、プロパティ `IsNull` を除き、オペランドまたは引数が NULL であった場合に NULL を返します。  
+  
+ ANSI SQL\-92 標準では、WHERE 句で *columnName* \= NULL とすることは認められていません。  SQL Server では、ANSI\_NULLS オプションによって、データベース内の既定の NULL 値と、NULL 値に対する比較の評価の両方が制御されます。  ANSI\_NULLS がオン \(既定\) である場合、IS NULL 演算子を NULL 値のテストを行う式で使用する必要があります。  たとえば次の比較では、ANSI\_NULLS がオンである場合、常に不明となります。  
+  
+```  
+  
+colname > NULL  
+```  
+  
+ NULL 値を含む変数との比較でも不明となります。  
+  
+```  
+  
+colname > @MyVariable  
+```  
+  
+ NULL 値をテストするには、IS NULL または IS NOT NULL 述語を使用します。  これにより WHERE 句が複雑になる場合があります。  たとえば、AdventureWorks Customer テーブル内の TerritoryID 列では、NULL 値が許可されています。  SELECT ステートメントによってその他の値と合わせて NULL 値もテストされる場合は、IS NULL 述語を含める必要があります。  
+  
+```  
+SELECT CustomerID, AccountNumber, TerritoryID  
+FROM AdventureWorks.Sales.Customer  
+WHERE TerritoryID IN (1, 2, 3)  
+   OR TerritoryID IS NULL  
+```  
+  
+ SQL Server で ANSI\_NULLS をオフに設定すると、等値演算子を使用する式を作成し、NULL 値と比較できます。  ただし、別の接続からその接続に対して NULL オプションを設定することを防ぐことはできません。  IS NULL を使用した NULL 値のテストは、接続の ANSI\_NULLS 設定にかかわらず、常に動作します。  
+  
+ `DataSet` では、ANSI\_NULLS をオフに設定することはできません。<xref:System.Data.SqlTypes> における NULL 値の処理については、常に ANSI SQL\-92 標準に準拠します。  
+  
+## NULL 値の割り当て  
+ NULL 値は特殊であり、ストレージおよび割り当てのセマンティクスは、システムおよびストレージ システムの種類によって異なります。  `Dataset` は、異なる種類のシステムおよびストレージ システムで使用できるように設計されています。  
+  
+ このセクションでは、異なる種類のシステム上にある <xref:System.Data.DataRow> の <xref:System.Data.DataColumn> に NULL 値を割り当てるための NULL セマンティクスについて説明します。  
+  
+ `DBNull.Value`  
+ この割り当ては、任意の型の `DataColumn` で有効です。  その型が `INullable` を実装している場合は、`DBNull.Value` が厳密に型指定された適切な NULL 値に強制的に変換されます。  
+  
+ `SqlType.Null`  
+ すべての <xref:System.Data.SqlTypes> データ型で `INullable` を実装します。  暗黙的なキャスト演算子を使用して、厳密に型指定された NULL 値を列のデータ型に変換できる場合は、割り当てが行われます。  変換できない場合は、無効なキャスト例外がスローされます。  
+  
+ `null`  
+ 特定の `DataColumn` データ型について 'null' が有効であった場合、`INullable` 型 \(`SqlType.Null`\) に関連付けられている、適切な `DbNull.Value` または `Null` に強制的に変換されます。  
+  
+ `derivedUdt.Null`  
+ UDT 列の場合、NULL 値は常に `DataColumn` に関連付けられている型に基づいて格納されます。  `DataColumn` に関連付けられている UDT が `INullable` を実装せず、サブクラスで実装される場合を考えます。  この場合、派生クラスに関連付けられた厳密に型指定された NULL 値が割り当てられていれば、NULL ストレージが常に DataColumn のデータ型と一致するため、型指定されていない `DbNull.Value` として格納されます。  
+  
+> [!NOTE]
+>  `Nullable<T>` または <xref:System.Nullable> 構造体は、現在 `DataSet` ではサポートされていません。  
+  
+### 複数列 \(行\) の割り当て  
+ <xref:System.Data.DataRow.ItemArray%2A> を行にマップできる、`DataTable.Add` や `DataTable.LoadDataRow` などの API については、DataColumn の既定値に 'null' をマップします。  配列内のオブジェクトに `DbNull.Value` またはその厳密に型指定された値が含まれる場合は、上記と同じ規則が適用されます。  
+  
+ さらに、`DataRow.["columnName"]` の NULL 値割り当てのインスタンスには、次の規則が適用されます。  
+  
+1.  既定の *default* 値は `DbNull.Value` です。ただし、それが厳密に型指定された適切な NULL 値となる、厳密に型指定された NULL 列は例外です。  
+  
+2.  XML ファイルへのシリアル化中に NULL 値が書き出されることはありません \("xsi:nil" と同じ\)。  
+  
+3.  既定値を含む NULL 以外のすべての値は、常に XML へのシリアル化中に書き出されます。  これは、NULL 値 \(xsi:nil\) が明示的で既定値が暗黙的である、XSD\/XML セマンティクスとは異なります \(XML にない場合は、検証パーサーが関連付けられた XSD スキーマから取得します\)。  逆に `DataTable` では、NULL 値が暗黙的で、既定値が明示的になります。  
+  
+4.  XML 入力から読み取られた各行の欠落している列値にはすべて、NULL が割り当てられます。  <xref:System.Data.DataTable.NewRow%2A> または類似のメソッドを使用して作成された行には、DataColumn の既定値が割り当てられます。  
+  
+5.  <xref:System.Data.DataRow.IsNull%2A> メソッドは、`DbNull.Value` と `INullable.Null` のどちらに対しても `true` を返します。  
+  
+## NULL 値の割り当て  
+ 任意の <xref:System.Data.SqlTypes> インスタンスの既定値は NULL です。  
+  
+ <xref:System.Data.SqlTypes> の NULL 値は型固有であり、`DbNull` などの 1 つの値で表すことはできません。  NULL 値の確認には、`IsNull` プロパティを使用します。  
+  
+ NULL 値は、次のコード サンプルに示すように <xref:System.Data.DataColumn> に割り当てることができます。  NULL 値は、例外をトリガーすることなく `SqlTypes` 変数に直接割り当てることができます。  
+  
+### 例  
+ 次のコード サンプルでは、<xref:System.Data.SqlTypes.SqlInt32> および <xref:System.Data.SqlTypes.SqlString> として定義される 2 つの列を持つ <xref:System.Data.DataTable> が作成されます。  このコードでは既知の値の行が 1 行、NULL 値の行が 1 行追加され、<xref:System.Data.DataTable> を通じて反復処理されます。これにより値が変数に割り当てられ、コンソール ウィンドウに出力が表示されます。  
+  
+ [!code-csharp[DataWorks SqlTypes.IsNull#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlTypes.IsNull/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlTypes.IsNull#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlTypes.IsNull/VB/source.vb#1)]  
+  
+ この例を実行すると、次の結果が表示されます。  
+  
+```  
+isColumnNull=False, ID=123, Description=Side Mirror  
+isColumnNull=True, ID=Null, Description=Null  
+```  
+  
+## NULL 値と SqlTypes および CLR 型との比較  
+ NULL 値を比較する場合は、`Equals` メソッドによって <xref:System.Data.SqlTypes> で NULL 値を評価する方法と、CLR 型を使用する方法との違いを理解することが重要です。  <xref:System.Data.SqlTypes> `Equals` メソッドではすべて、NULL 値の評価にデータベース セマンティクスが使用されます。一方または両方の値が NULL である場合は、比較によって NULL が得られます。  その一方で、2 つの <xref:System.Data.SqlTypes> に対して CLR `Equals` メソッドを使用した場合は、両方が NULL であれば true が得られます。  これは、CLR `String.Equals` メソッドなどのインスタンス メソッドを使用した場合と、`SqlString.Equals` などの静的\/共有メソッドを使用した場合の違いを反映しています。  
+  
+ 次のコード サンプルでは、`SqlString.Equals` メソッドと `String.Equals` メソッドにそれぞれ NULL 値のペアを渡し、次に空の文字列のペアを渡した場合の、各メソッドの結果の違いを示します。  
+  
+ [!code-csharp[DataWorks SqlTypes.CompareNulls#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlTypes.CompareNulls/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlTypes.CompareNulls#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlTypes.CompareNulls/VB/source.vb#1)]  
+  
+ このコードを実行すると、次の出力が生成されます。  
+  
+```  
+SqlString.Equals shared/static method:  
+  Two nulls=Null  
+  
+String.Equals instance method:  
+  Two nulls=True  
+  
+SqlString.Equals shared/static method:  
+  Two empty strings=True  
+  
+String.Equals instance method:  
+  Two empty strings=True   
+```  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/index.md b/docs/framework/data/adonet/sql/index.md
new file mode 100644
index 00000000000..bbdd740a6c5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/index.md
@@ -0,0 +1,55 @@
+---
+title: "SQL Server と ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c18b1fb1-2af1-4de7-80a4-95e56fd976cb
+caps.latest.revision: 7
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 7
+---
+# SQL Server と ADO.NET
+このセクションでは、.NET Framework Data Provider for SQL Server \(<xref:System.Data.SqlClient>\) 固有の機能および動作について説明します。  
+  
+ <xref:System.Data.SqlClient> は SQL Server のバージョンへのアクセスを提供し、データベース固有のプロトコルをカプセル化します。  このデータ プロバイダーの機能は、OLE DB、ODBC、および Oracle に対する .NET Framework データ プロバイダーの機能と同等になるように設計されています。  <xref:System.Data.SqlClient> には、SQL Server と直接通信するための表形式データ ストリーム \(TDS\) パーサーが含まれています。  
+  
+> [!NOTE]
+>  .NET Framework Data Provider for SQL Server を使用するには、アプリケーションで <xref:System.Data.SqlClient> 名前空間を参照する必要があります。  
+  
+## このセクションの内容  
+ [SQL Server のセキュリティ](../../../../../docs/framework/data/adonet/sql/sql-server-security.md)  
+ SQL Server のセキュリティの概要を説明し、アプリケーションのシナリオを交えながら、SQL Server を対象とした安全な ADO.NET アプリケーションを作成するための指針を提供します。  
+  
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)  
+ SQL Server のデータ型の操作方法、および .NET Framework データ型との相互作用について説明します。  
+  
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)  
+ SQL Server で大きな値のデータを扱う方法について説明します。  
+  
+ [ADO.NET における SQL Server データ操作](../../../../../docs/framework/data/adonet/sql/sql-server-data-operations.md)  
+ SQL Server でのデータの操作方法について説明します。  一括コピー操作、MARS、非同期操作、およびテーブル値パラメーターに関するセクションがあります。  
+  
+ [SQL Server の機能と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-features-and-adonet.md)  
+ ADO.NET アプリケーション開発者にとって役立つ SQL Server の機能について説明します。  
+  
+ [LINQ to SQL](../../../../../docs/framework/data/adonet/sql/linq/index.md)  
+ LINQ to SQL アプリケーションを作成するのに必要な基本的なビルド ブロック、プロセス、および手法について説明します。  
+  
+ SQL Server データベース エンジンの詳細なドキュメントについては、使用している SQL Server のバージョンに対応する SQL Server オンライン ブックを参照してください。  
+  
+ [SQL Server オンライン ブック](http://msdn.microsoft.com/library/ms130214.aspx)  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [ADO.NET でのデータ型のマッピング](../../../../../docs/framework/data/adonet/data-type-mappings-in-ado-net.md)   
+ [DataSets、DataTables、および DataViews](../../../../../docs/framework/data/adonet/dataset-datatable-dataview/index.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/inserting-an-image-from-a-file.md b/docs/framework/data/adonet/sql/inserting-an-image-from-a-file.md
new file mode 100644
index 00000000000..39db0a66f55
--- /dev/null
+++ b/docs/framework/data/adonet/sql/inserting-an-image-from-a-file.md
@@ -0,0 +1,142 @@
+---
+title: "ファイルからの画像の挿入 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35900aa2-5615-4174-8212-ba184c6b82fb
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# ファイルからの画像の挿入
+データ ソースのフィールドの型に応じて、バイナリ データまたは文字データとして、BLOB \(バイナリ ラージ オブジェクト\) をデータベースに書き込むことができます。  BLOB は `text`、`ntext`、および `image` データ型を示す一般的な用語であり、通常ドキュメントとピクチャが含まれています。  
+  
+ BLOB 値をデータベースに書き込むには、適切な INSERT または UPDATE ステートメントを実行し、入力パラメーターとして BLOB 値を渡します \(「[パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)」を参照\)。  BLOB が、SQL Server の `text` フィールドなどのようにテキストとして格納される場合は、文字列パラメーターとして BLOB を渡すことができます。  BLOB が、SQL Server の `image` フィールドなどのようにバイナリ形式で格納される場合は、バイナリ パラメーターとして `byte` 型の配列を渡すことができます。  
+  
+## 例  
+ Northwind データベースの Employees テーブルに従業員情報を追加するコード サンプルを次に示します。  従業員の写真がファイルから読み取られ、テーブルの Photo フィールド \(イメージ フィールド\) に追加されます。  
+  
+```vb  
+Public Shared Sub AddEmployee( _  
+  lastName As String, _  
+  firstName As String, _  
+  title As String, _  
+  hireDate As DateTime, _  
+  reportsTo As Integer, _  
+  photoFilePath As String, _  
+  connectionString As String)  
+  
+  Dim photo() as Byte = GetPhoto(photoFilePath)  
+  
+  Using connection As SqlConnection = New SqlConnection( _  
+    connectionString)  
+  
+  Dim command As SqlCommand = New SqlCommand( _  
+    "INSERT INTO Employees (LastName, FirstName, Title, " & _  
+    "HireDate, ReportsTo, Photo) " & _  
+    "Values(@LastName, @FirstName, @Title, " & _  
+    "@HireDate, @ReportsTo, @Photo)", connection)   
+  
+  command.Parameters.Add("@LastName",  _  
+    SqlDbType.NVarChar, 20).Value = lastName  
+  command.Parameters.Add("@FirstName", _  
+    SqlDbType.NVarChar, 10).Value = firstName  
+  command.Parameters.Add("@Title", _  
+    SqlDbType.NVarChar, 30).Value = title  
+  command.Parameters.Add("@HireDate", _  
+    SqlDbType.DateTime).Value = hireDate  
+  command.Parameters.Add("@ReportsTo", _  
+    SqlDbType.Int).Value = reportsTo  
+  
+  command.Parameters.Add("@Photo", _  
+    SqlDbType.Image, photo.Length).Value = photo  
+  
+  connection.Open()  
+  command.ExecuteNonQuery()  
+  
+  End Using  
+End Sub  
+  
+Public Shared Function GetPhoto(filePath As String) As Byte()  
+  Dim stream As FileStream = new FileStream( _  
+     filePath, FileMode.Open, FileAccess.Read)  
+  Dim reader As BinaryReader = new BinaryReader(stream)  
+  
+  Dim photo() As Byte = reader.ReadBytes(stream.Length)  
+  
+  reader.Close()  
+  stream.Close()  
+  
+  Return photo  
+End Function  
+```  
+  
+```csharp  
+public static void AddEmployee(  
+  string lastName,   
+  string firstName,   
+  string title,   
+  DateTime hireDate,   
+  int reportsTo,   
+  string photoFilePath,   
+  string connectionString)  
+{  
+  byte[] photo = GetPhoto(photoFilePath);  
+  
+  using (SqlConnection connection = new SqlConnection(  
+    connectionString))  
+  
+  SqlCommand command = new SqlCommand(  
+    "INSERT INTO Employees (LastName, FirstName, " +  
+    "Title, HireDate, ReportsTo, Photo) " +  
+    "Values(@LastName, @FirstName, @Title, " +  
+    "@HireDate, @ReportsTo, @Photo)", connection);   
+  
+  command.Parameters.Add("@LastName",    
+     SqlDbType.NVarChar, 20).Value = lastName;  
+  command.Parameters.Add("@FirstName",   
+      SqlDbType.NVarChar, 10).Value = firstName;  
+  command.Parameters.Add("@Title",       
+      SqlDbType.NVarChar, 30).Value = title;  
+  command.Parameters.Add("@HireDate",   
+       SqlDbType.DateTime).Value = hireDate;  
+  command.Parameters.Add("@ReportsTo",   
+      SqlDbType.Int).Value = reportsTo;  
+  
+  command.Parameters.Add("@Photo",  
+      SqlDbType.Image, photo.Length).Value = photo;  
+  
+  connection.Open();  
+  command.ExecuteNonQuery();  
+  }  
+}  
+  
+public static byte[] GetPhoto(string filePath)  
+{  
+  FileStream stream = new FileStream(  
+      filePath, FileMode.Open, FileAccess.Read);  
+  BinaryReader reader = new BinaryReader(stream);  
+  
+  byte[] photo = reader.ReadBytes((int)stream.Length);  
+  
+  reader.Close();  
+  stream.Close();  
+  
+  return photo;  
+}  
+```  
+  
+## 参照  
+ [コマンドを使用したデータ変更](../../../../../docs/framework/data/adonet/using-commands-to-modify-data.md)   
+ [バイナリ データの取得](../../../../../docs/framework/data/adonet/retrieving-binary-data.md)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/introduction-to-sql-server-clr-integration.md b/docs/framework/data/adonet/sql/introduction-to-sql-server-clr-integration.md
new file mode 100644
index 00000000000..ce8ff4cec2f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/introduction-to-sql-server-clr-integration.md
@@ -0,0 +1,78 @@
+---
+title: "SQL Server の CLR 統合の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 551d2290-ed80-49be-b377-44b32444da1c
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server の CLR 統合の概要
+共通言語ランタイム \(CLR\) は、Microsoft .NET Framework の中核であり、すべての .NET Framework コードの実行環境を提供します。  CLR の内部で実行されるコードはマネージ コードと呼ばれます。  CLR は、ジャストインタイム \(JIT\) コンパイル、メモリの割り当てと管理、タイプ セーフの設定、例外処理、スレッド管理、セキュリティなど、プログラムの実行に必要なさまざまな機能やサービスを備えています。  
+  
+ Microsoft SQL Server にホストされる CLR \(CLR 統合と呼ばれる\) を利用することで、ストアド プロシージャ、トリガー、ユーザー定義関数、ユーザー定義型、およびユーザー定義集計をマネージ コードで作成できます。  マネージ コードは実行前にネイティブ コードにコンパイルされるため、状況によっては、パフォーマンスが大幅に向上します。  
+  
+ マネージ コードは、コード アクセス セキュリティ \(CAS\)、コード リンク、およびアプリケーション ドメインを使用して、アセンブリが特定の操作を実行することを防止します。  SQL Server は、CAS を使用して、マネージ コードをセキュリティ保護し、オペレーティング システムやデータベース サーバーへの侵害を防止します。  
+  
+ このセクションは、SQL Server の CLR 統合を利用したプログラミングを始めるのに十分な情報を提供することを目的としており、包括的な情報の提供は目的としていません。  詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [共通言語ランタイム \(CLR\) 統合の概要](http://go.microsoft.com/fwlink/?LinkId=115242)  
+  
+## CLR 統合の有効化  
+ Microsoft SQL Server では共通言語ランタイム \(CLR\) 統合機能が既定でオフになっているため、CLR 統合を利用して実装されるオブジェクトを使用するには、CLR 統合機能を有効にする必要があります。  Transact\-SQL を使用して CLR 統合を有効にするには、次に示すように、`sp_configure` ストアド プロシージャの `clr enabled` オプションを使用します。  
+  
+```  
+sp_configure 'clr enabled', 1  
+GO  
+RECONFIGURE  
+GO  
+```  
+  
+ `clr enabled` オプションを 0 に設定することにより、CLR 統合を無効にできます。  CLR 統合を無効にすると、SQL Server ではすべての CLR ルーチンの実行が停止され、すべてのアプリケーション ドメインがアンロードされます。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [CLR 統合の有効化](http://go.microsoft.com/fwlink/?LinkId=115230)  
+  
+## CLR アセンブリの配置  
+ CLR メソッドをテスト サーバーでテストおよび検証すると、配置スクリプトを使用してこれらを実稼働サーバーに配布できます。  配置スクリプトは手動で生成するか、SQL Server Management Studio を使用して生成することができます。  詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [CLR データベース オブジェクトの展開](http://go.microsoft.com/fwlink/?LinkId=115232)  
+  
+## CLR 統合セキュリティ  
+ Microsoft SQL Server と Microsoft .NET Framework 共通言語ランタイム \(CLR\) との統合のセキュリティ モデルは、SQL Server 内部で実行されるさまざまなタイプの CLR オブジェクトおよび非 CLR オブジェクトの間のアクセスを管理し、セキュリティで保護します。  これらのオブジェクトは、Transact\-SQL ステートメントまたはサーバーで実行される別の CLR オブジェクトから呼び出される可能性があります。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [CLR 統合のセキュリティ](http://go.microsoft.com/fwlink/?LinkId=115234)  
+  
+## CLR アセンブリのデバッグ  
+ Microsoft SQL Server は、データベース内の Transact\-SQL オブジェクトおよび共通言語ランタイム \(CLR\) オブジェクトのデバッグをサポートしています。  デバッグは言語をまたがって機能します。ユーザーは、Transact\-SQL から CLR オブジェクトへ、または CLR オブジェクトから Transact\-SQL へシームレスにデバッグできます。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [CLR データベース オブジェクト](http://go.microsoft.com/fwlink/?LinkId=115236)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [コード アクセス セキュリティと ADO.NET](../../../../../docs/framework/data/adonet/code-access-security.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/large-udts.md b/docs/framework/data/adonet/sql/large-udts.md
new file mode 100644
index 00000000000..0218a3b3534
--- /dev/null
+++ b/docs/framework/data/adonet/sql/large-udts.md
@@ -0,0 +1,144 @@
+---
+title: "大きな UDT | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 420ae24e-762b-4e09-b4c3-2112c470ee49
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# 大きな UDT
+開発者は、ユーザー定義型 \(UDT\) を使用すると、SQL Server データベースに共通言語ランタイム \(CLR\) オブジェクトを格納して、サーバーのスカラー型システムを拡張することができます。  UDT は複数の要素を持つことができ、動作を定義できます。この点は、1 つの SQL Server システム データ型から構成される従来の別名データ型と異なります。  
+  
+> [!NOTE]
+>  大きな UDT に対する SqlClient のサポート強化を利用するには、.NET Framework 3.5 SP1 以降をインストールする必要があります。  
+  
+ 従来は、UDT の最大サイズが 8 KB に制限されていました。  SQL Server 2008 では、<xref:Microsoft.SqlServer.Server.Format> 形式の UDT に対するこの制限が廃止されています。  
+  
+ ユーザー定義型の完全な説明については、使用している SQL Server のバージョンに対応する SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [ユーザー定義の CLR 型](http://go.microsoft.com/fwlink/?LinkId=98366)  
+  
+## GetSchema による UDT スキーマの取得  
+ <xref:System.Data.SqlClient.SqlConnection> の <xref:System.Data.SqlClient.SqlConnection.GetSchema%2A> メソッドは、データベース スキーマ情報を <xref:System.Data.DataTable> に返します。  詳細については、「[SQL Server スキーマ コレクション](../../../../../docs/framework/data/adonet/sql-server-schema-collections.md)」を参照してください。  
+  
+### UDT の GetSchemaTable 列値  
+ <xref:System.Data.SqlClient.SqlDataReader> の <xref:System.Data.SqlClient.SqlDataReader.GetSchemaTable%2A> メソッドは、列メタデータを記述する <xref:System.Data.DataTable> を返します。  次の表は、SQL Server 2005 と SQL Server 2008 における、大きな UDT の列メタデータの違いを示しています。  
+  
+|SqlDataReader 列|SQL Server 2005|SQL Server 2008 以降|  
+|---------------------|---------------------|------------------------|  
+|`ColumnSize`|可変|可変|  
+|`NumericPrecision`|255|255|  
+|`NumericScale`|255|255|  
+|`DataType`|`Byte[]`|UDT インスタンス|  
+|`ProviderSpecificDataType`|`SqlTypes.SqlBinary`|UDT インスタンス|  
+|`ProviderType`|21 \(`SqlDbType.VarBinary`\)|29 \(`SqlDbType.Udt`\)|  
+|`NonVersionedProviderType`|29 \(`SqlDbType.Udt`\)|29 \(`SqlDbType.Udt`\)|  
+|`DataTypeName`|`SqlDbType.VarBinary`|3 つの部分から成る名前 \(*Database.SchemaName.TypeName* として指定\)|  
+|`IsLong`|可変|可変|  
+  
+## SqlDataReader に関する注意点  
+ SQL Server 2008 以降、<xref:System.Data.SqlClient.SqlDataReader> は大きな UDT 値を取得できるように拡張されました。  どの程度大きな UDT 値が [SqlDataReader](assetId:///SqlDataReader?qualifyHint=False&amp;autoUpgrade=True) によって処理されるかは、使用される SQL Server のバージョンだけでなく、接続文字列に指定されている `Type System Version` によっても異なります。  詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」を参照してください。  
+  
+ <xref:System.Data.SqlClient.SqlDataReader> の次のメソッドは、`Type System Version` が SQL Server 2005 に設定されていると、UDT ではなく <xref:System.Data.SqlTypes.SqlBinary> を返します。  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificFieldType%2A>  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificValue%2A>  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetProviderSpecificValues%2A>  ``  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetSqlValue%2A>  ``  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetSqlValues%2A>  
+  
+ 次のメソッドは、`Type System Version` が SQL Server 2005 に設定されていると、UDT ではなく `Byte[]` の配列を返します。  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetValue%2A>  ``  
+  
+-   <xref:System.Data.SqlClient.SqlDataReader.GetValues%2A>  
+  
+ 現在のバージョンの ADO.NET では、変換は実行されません。  
+  
+## SqlParameter の指定  
+ 大きな UDT を扱うことができるように、次の <xref:System.Data.SqlClient.SqlParameter> プロパティが拡張されています。  
+  
+|SqlParameter プロパティ|説明|  
+|------------------------|--------|  
+|<xref:System.Data.SqlClient.SqlParameter.Value%2A>|パラメーターの値を表すオブジェクトを取得または設定します。  既定値は null です。  このプロパティは、`SqlBinary`、`Byte[]`、またはマネージ オブジェクトになります。|  
+|<xref:System.Data.SqlClient.SqlParameter.SqlValue%2A>|パラメーターの値を表すオブジェクトを取得または設定します。  既定値は null です。  このプロパティは、`SqlBinary`、`Byte[]`、またはマネージ オブジェクトになります。|  
+|<xref:System.Data.SqlClient.SqlParameter.Size%2A>|解決するパラメーター値のサイズを取得または設定します。  既定値は 0 です。  このプロパティは、パラメーター値のサイズを表す整数になります。  大きな UDT の場合は UDT の実際のサイズに、不明な場合は \-1 になります。|  
+  
+## データの取得例  
+ 次のコード フラグメントは、大きな UDT を取得する方法を示しています。  `connectionString` 変数は SQL Server データベースへの有効な接続を前提とし、`commandString` 変数は有効な SELECT ステートメントで主キー列が最初に記載されていることを前提とします。  
+  
+```csharp  
+using (SqlConnection connection = new SqlConnection(   
+    connectionString, commandString))  
+{  
+  connection.Open();  
+  SqlCommand command = new SqlCommand(commandString);  
+  SqlDataReader reader = command.ExecuteReader();  
+  while (reader.Read())  
+  {  
+    // Retrieve the value of the Primary Key column.  
+    int id = reader.GetInt32(0);  
+  
+    // Retrieve the value of the UDT.  
+    LargeUDT udt = (LargeUDT)reader[1];  
+  
+    // You can also use GetSqlValue and GetValue.  
+    // LargeUDT udt = (LargeUDT)reader.GetSqlValue(1);  
+    // LargeUDT udt = (LargeUDT)reader.GetValue(1);  
+  
+    Console.WriteLine(  
+     "ID={0} LargeUDT={1}", id, udt);  
+  }  
+reader.close  
+}  
+```  
+  
+```vb  
+Using connection As New SqlConnection( _  
+    connectionString, commandString)  
+    connection.Open()  
+    Dim command As New SqlCommand(commandString, connection)  
+    Dim reader As SqlDataReader  
+    reader = command.ExecuteReader  
+  
+    While reader.Read()  
+      ' Retrieve the value of the Primary Key column.  
+      Dim id As Int32 = reader.GetInt32(0)  
+  
+      ' Retrieve the value of the UDT.  
+      Dim udt As LargeUDT = CType(reader(1), LargeUDT)  
+  
+     ' You can also use GetSqlValue and GetValue.  
+     ' Dim udt As LargeUDT = CType(reader.GetSqlValue(1), LargeUDT)  
+     ' Dim udt As LargeUDT = CType(reader.GetValue(1), LargeUDT)  
+  
+      ' Print values.  
+      Console.WriteLine("ID={0} LargeUDT={1}", id, udt)  
+    End While  
+    reader.Close()  
+End Using  
+  
+```  
+  
+## 参照  
+ [パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [データベース スキーマ情報の取得](../../../../../docs/framework/data/adonet/retrieving-database-schema-information.md)   
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/TOC.md b/docs/framework/data/adonet/sql/linq/TOC.md
new file mode 100644
index 00000000000..adecc196c4c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/TOC.md
@@ -0,0 +1,159 @@
+# [How to: Resolve Conflicts by Overwriting Database Values](how-to-resolve-conflicts-by-overwriting-database-values.md)
+# [How to: Dynamically Create a Database](how-to-dynamically-create-a-database.md)
+# [How to: Retrieve Information As Read-Only](how-to-retrieve-information-as-read-only.md)
+# [How to: Call User-Defined Functions Inline](how-to-call-user-defined-functions-inline.md)
+# [ASP.NET での LINQ to SQL N 層](linq-to-sql-n-tier-with-aspnet.md)
+# [LINQ to SQL Queries](linq-to-sql-queries.md)
+# [How to: Control How Much Related Data Is Retrieved](how-to-control-how-much-related-data-is-retrieved.md)
+# [Downloading Sample Databases](downloading-sample-databases.md)
+# [Querying the Database](querying-the-database.md)
+# [Remote vs. Local Execution](remote-vs-local-execution.md)
+# [Return the Average Value From a Numeric Sequence](return-the-average-value-from-a-numeric-sequence.md)
+# [プログラミング ガイド](programming-guide.md)
+# [Walkthrough: Using Only Stored Procedures (C#)](walkthrough-using-only-stored-procedures-csharp.md)
+# [Basic Data Types](basic-data-types.md)
+# [How to: Filter Related Data](how-to-filter-related-data.md)
+# [How to: Customize Entity Classes by Using the Code Editor](how-to-customize-entity-classes-by-using-the-code-editor.md)
+# [How to: Represent Columns as Allowing Null Values](how-to-represent-columns-as-allowing-null-values.md)
+# [How to: Query for Information](how-to-query-for-information.md)
+# [How to: Directly Execute SQL Queries](how-to-directly-execute-sql-queries.md)
+# [Unsupported Functionality](unsupported-functionality.md)
+# [LINQ to SQL with Tightly-Coupled Client-Server Applications](linq-to-sql-with-tightly-coupled-client-server-applications.md)
+# [Code Generation in LINQ to SQL](code-generation-in-linq-to-sql.md)
+# [Getting Started](getting-started.md)
+# [How to: Validate DBML and External Mapping Files](how-to-validate-dbml-and-external-mapping-files.md)
+# [SQL-CLR Custom Type Mappings](sql-clr-custom-type-mappings.md)
+# [Formulate Joins and Cross-Product Queries](formulate-joins-and-cross-product-queries.md)
+# [Making and Submitting Data Changes](making-and-submitting-data-changes.md)
+# [Sort Elements in a Sequence](sort-elements-in-a-sequence.md)
+# [Security in LINQ to SQL](security-in-linq-to-sql.md)
+# [How to: Specify Which Members are Tested for Concurrency Conflicts](how-to-specify-which-members-are-tested-for-concurrency-conflicts.md)
+# [Deferred versus Immediate Loading](deferred-versus-immediate-loading.md)
+# [Return the Set Intersection of Two Sequences](return-the-set-intersection-of-two-sequences.md)
+# [System.String Methods](system-string-methods.md)
+# [How to: Handle Composite Keys in Queries](how-to-handle-composite-keys-in-queries.md)
+# [How to: Manage Change Conflicts](how-to-manage-change-conflicts.md)
+# [Return the First Element in a Sequence](return-the-first-element-in-a-sequence.md)
+# [Count the Number of Elements in a Sequence](count-the-number-of-elements-in-a-sequence.md)
+# [Data Binding](data-binding.md)
+# [Analyzing LINQ to SQL Source Code](analyzing-linq-to-sql-source-code.md)
+# [Walkthrough: Simple Object Model and Query (Visual Basic)](walkthrough-simple-object-model-and-query-visual-basic.md)
+# [How to: Submit Changes to the Database](how-to-submit-changes-to-the-database.md)
+# [Object Identity](object-identity.md)
+# [Responsibilities of the Developer In Overriding Default Behavior](responsibilities-of-the-developer-in-overriding-default-behavior.md)
+# [Implementing N-Tier Business Logic](implementing-business-logic-linq-to-sql.md)
+# [Local Method Calls](local-method-calls.md)
+# [How to: Connect to a Database](how-to-connect-to-a-database.md)
+# [Data Retrieval and CUD Operations in N-Tier Applications (LINQ to SQL)](data-retrieval-and-cud-operations-in-n-tier-applications.md)
+# [Optimistic Concurrency: Overview](optimistic-concurrency-overview.md)
+# [How to: Use Stored Procedures Mapped for Multiple Result Shapes](how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md)
+# [How to: Specify Concurrency-Conflict Checking](how-to-specify-concurrency-conflict-checking.md)
+# [Convert a Sequence to an Array](convert-a-sequence-to-an-array.md)
+# [How to: Use Stored Procedures that Take Parameters](how-to-use-stored-procedures-that-take-parameters.md)
+# [How to: Specify Database Names](how-to-specify-database-names.md)
+# [How to: Resolve Conflicts by Retaining Database Values](how-to-resolve-conflicts-by-retaining-database-values.md)
+# [How to: Map Inheritance Hierarchies](how-to-map-inheritance-hierarchies.md)
+# [Customizing Operations By Using Stored Procedures](customizing-operations-by-using-stored-procedures.md)
+# [null セマンティクス](null-semantics.md)
+# [Learning by Walkthroughs](learning-by-walkthroughs.md)
+# [Walkthrough: Querying Across Relationships (Visual Basic)](walkthrough-querying-across-relationships-visual-basic.md)
+# [How to: Use Stored Procedures Mapped for Sequential Result Shapes](how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md)
+# [How to: Make Entities Serializable](how-to-make-entities-serializable.md)
+# [Standard Query Operator Translation](standard-query-operator-translation.md)
+# [Customizing Operations: Overview](customizing-operations-overview.md)
+# [How to: Update Rows in the Database](how-to-update-rows-in-the-database.md)
+# [Serialization](serialization.md)
+# [How to: Generate the Object Model in Visual Basic or C#](how-to-generate-the-object-model-in-visual-basic-or-csharp.md)
+# [How to: Store and Reuse Queries](how-to-store-and-reuse-queries.md)
+# [LINQ to SQL N-Tier with Web Services](linq-to-sql-n-tier-with-web-services.md)
+# [Typical Steps for Using LINQ to SQL](typical-steps-for-using-linq-to-sql.md)
+# [Query Concepts](query-concepts.md)
+# [How to: Retrieve Entity Conflict Information](how-to-retrieve-entity-conflict-information.md)
+# [Retrieving Objects from the Identity Cache](retrieving-objects-from-the-identity-cache.md)
+# [How to: Bracket Data Submissions by Using Transactions](how-to-bracket-data-submissions-by-using-transactions.md)
+# [System.TimeSpan Methods](system-timespan-methods.md)
+# [How to: Detect and Resolve Conflicting Submissions](how-to-detect-and-resolve-conflicting-submissions.md)
+# [Troubleshooting](troubleshooting.md)
+# [Transaction Support](transaction-support.md)
+# [Return the Set Union of Two Sequences](return-the-set-union-of-two-sequences.md)
+# [N-Tier and Remote Applications with LINQ to SQL](n-tier-and-remote-applications-with-linq-to-sql.md)
+# [How to: Represent Tables as Classes](how-to-represent-tables-as-classes.md)
+# [The LINQ to SQL Object Model](the-linq-to-sql-object-model.md)
+# [Return Or Skip Elements in a Sequence](return-or-skip-elements-in-a-sequence.md)
+# [How to: Reuse a Connection Between an ADO.NET Command and a DataContext](how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md)
+# [How to: Retrieve Member Conflict Information](how-to-retrieve-member-conflict-information.md)
+# [Convert a Sequence to a Generic List](convert-a-sequence-to-a-generic-list.md)
+# [How to: Represent Columns as Class Members](how-to-represent-columns-as-class-members.md)
+# [Object States and Change-Tracking](object-states-and-change-tracking.md)
+# [Find the Minimum Value in a Numeric Sequence](find-the-minimum-value-in-a-numeric-sequence.md)
+# [Concatenate Two Sequences](concatenate-two-sequences.md)
+# [Formulate Projections](formulate-projections.md)
+# [LINQ to SQL](index.md)
+# [How to: Return Rowsets](how-to-return-rowsets.md)
+# [Background Information](background-information.md)
+# [How to: Use Scalar-Valued User-Defined Functions](how-to-use-scalar-valued-user-defined-functions.md)
+# [Find the Maximum Value in a Numeric Sequence](find-the-maximum-value-in-a-numeric-sequence.md)
+# [Attribute-Based Mapping](attribute-based-mapping.md)
+# [Data Types and Functions](data-types-and-functions.md)
+# [Communicating with the Database](communicating-with-the-database.md)
+# [How to: Represent Columns as Database-Generated](how-to-represent-columns-as-database-generated.md)
+# [Convert a Type to a Generic IEnumerable](convert-a-type-to-a-generic-ienumerable.md)
+# [How to: Represent Primary Keys](how-to-represent-primary-keys.md)
+# [Return the Set Difference Between Two Sequences](return-the-set-difference-between-two-sequences.md)
+# [How to: Display Generated SQL](how-to-display-generated-sql.md)
+# [How to: Represent Columns as Timestamp or Version Columns](how-to-represent-columns-as-timestamp-or-version-columns.md)
+# [Walkthrough: Using Only Stored Procedures (Visual Basic)](walkthrough-using-only-stored-procedures-visual-basic.md)
+# [How to: Use Table-Valued User-Defined Functions](how-to-use-table-valued-user-defined-functions.md)
+# [How to: Specify Private Storage Fields](how-to-specify-private-storage-fields.md)
+# [SQL Server Compact and LINQ to SQL](sql-server-compact-and-linq-to-sql.md)
+# [Boolean Data Types](boolean-data-types.md)
+# [Walkthrough: Querying Across Relationships (C#)](walkthrough-querying-across-relationships-csharp.md)
+# [System.Object Methods](system-object-methods.md)
+# [How to: Map Database Relationships](how-to-map-database-relationships.md)
+# [How to: Generate Customized Code by Modifying a DBML File](how-to-generate-customized-code-by-modifying-a-dbml-file.md)
+# [System.DateTime Methods](system-datetime-methods.md)
+# [SQL-CLR Type Mapping](sql-clr-type-mapping.md)
+# [Sequence Operators](sequence-operators.md)
+# [Stored Procedures](stored-procedures.md)
+# [ADO.NET and LINQ to SQL](ado-net-and-linq-to-sql.md)
+# [How to: Insert Rows Into the Database](how-to-insert-rows-into-the-database.md)
+# [Customizing Operations by Using Stored Procedures Exclusively](customizing-operations-by-using-stored-procedures-exclusively.md)
+# [Walkthrough: Simple Object Model and Query (C#)](walkthrough-simple-object-model-and-query-csharp.md)
+# [How to: Represent Computed Columns](how-to-represent-computed-columns.md)
+# [Samples](samples.md)
+# [System.Convert Methods](system-convert-methods.md)
+# [Adding Business Logic By Using Partial Methods](adding-business-logic-by-using-partial-methods.md)
+# [How to: Specify When Concurrency Exceptions are Thrown](how-to-specify-when-concurrency-exceptions-are-thrown.md)
+# [Determine if Any or All Elements in a Sequence Satisfy a Condition](determine-if-any-or-all-elements-in-a-sequence-satisfy-a-condition.md)
+# [User-Defined Functions](user-defined-functions.md)
+# [Reference](reference.md)
+# [Eliminate Duplicate Elements from a Sequence](eliminate-duplicate-elements-from-a-sequence.md)
+# [Querying Across Relationships](querying-across-relationships.md)
+# [Creating the Object Model](creating-the-object-model.md)
+# [Insert, Update, and Delete Operations](insert-update-and-delete-operations.md)
+# [Debugging Support](debugging-support.md)
+# [Numeric and Comparison Operators](numeric-and-comparison-operators.md)
+# [System.DateTimeOffset Methods](system-datetimeoffset-methods.md)
+# [Frequently Asked Questions](frequently-asked-questions.md)
+# [Compute the Sum of Values in a Numeric Sequence](compute-the-sum-of-values-in-a-numeric-sequence.md)
+# [Walkthrough: Manipulating Data (C#)](walkthrough-manipulating-data-csharp.md)
+# [How to: Generate the Object Model as an External File](how-to-generate-the-object-model-as-an-external-file.md)
+# [How to: Specify Database Data Types](how-to-specify-database-data-types.md)
+# [How to: Delete Rows From the Database](how-to-delete-rows-from-the-database.md)
+# [Walkthrough: Manipulating Data (Visual Basic)](walkthrough-manipulating-data-visual-basic.md)
+# [How to: Display LINQ to SQL Commands](how-to-display-linq-to-sql-commands.md)
+# [Group Elements in a Sequence](group-elements-in-a-sequence.md)
+# [How to: Turn Off Deferred Loading](how-to-turn-off-deferred-loading.md)
+# [Inheritance Support](inheritance-support.md)
+# [How to: Resolve Conflicts by Merging with Database Values](how-to-resolve-conflicts-by-merging-with-database-values.md)
+# [How to: Retrieve Many Objects At Once](how-to-retrieve-many-objects-at-once.md)
+# [How to: Filter at the DataContext Level](how-to-filter-at-the-datacontext-level.md)
+# [Aggregate Queries](aggregate-queries.md)
+# [Query Examples](query-examples.md)
+# [How to: Display a ChangeSet](how-to-display-a-changeset.md)
+# [System.Math Methods](system-math-methods.md)
+# [SQL-CLR Type Mismatches](sql-clr-type-mismatches.md)
+# [Customizing Insert, Update, and Delete Operations](customizing-insert-update-and-delete-operations.md)
+# [External Mapping](external-mapping.md)
+# [LINQ to SQL の主な機能](what-you-can-do-with-linq-to-sql.md)
+# [How to: Directly Execute SQL Commands](how-to-directly-execute-sql-commands.md)
diff --git a/docs/framework/data/adonet/sql/linq/adding-business-logic-by-using-partial-methods.md b/docs/framework/data/adonet/sql/linq/adding-business-logic-by-using-partial-methods.md
new file mode 100644
index 00000000000..2ac3121f5e9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/adding-business-logic-by-using-partial-methods.md
@@ -0,0 +1,59 @@
+---
+title: "Adding Business Logic By Using Partial Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3a73991e-fd4e-4610-93fb-7ced4dc6b7f9
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Adding Business Logic By Using Partial Methods
+生成された [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のコードは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]部分メソッドを使用して  *プロジェクトでカスタマイズできます。* [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] から生成されるコードでは、シグネチャが部分メソッドの一部として定義されています。  このメソッドを実装する場合に、独自の部分メソッドを追加できます。  独自の実装を追加しない場合は、コンパイラで部分メソッドのシグネチャが破棄され、既定のメソッドが [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で呼び出されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、妥当性検査やその他のカスタマイズをエンティティ クラスに追加できます。  
+  
+ たとえば、Northwind サンプル データベースの `Customer` クラスに対する既定の対応付けには次の部分メソッドが含まれます。  
+  
+ [!code-csharp[DLinqOverrideDefault#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefault/cs/northwind.cs#2)]
+ [!code-vb[DLinqOverrideDefault#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefault/vb/northwind.vb#2)]  
+  
+ 次のようなコードを独自の部分 `Customer` クラスに追加することで、独自のメソッドを実装できます。  
+  
+ [!code-csharp[DLinqOverrideDefault#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefault/cs/Program.cs#3)]
+ [!code-vb[DLinqOverrideDefault#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefault/vb/Module1.vb#3)]  
+  
+ この方法は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]、`Insert`、および `Update` の既定のメソッドをオーバーライドし、オブジェクトのライフ サイクル イベントの発生時にプロパティを検証するために、`Delete` で一般的に使用されます。  
+  
+ 詳細については、「[Partial Methods](../Topic/Partial%20Methods%20\(Visual%20Basic\).md)」\([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\) または「[partial \(メソッド\) \(C\# リファレンス\)](../Topic/partial%20\(Method\)%20\(C%23%20Reference\).md)」\(C\#\) を参照してください。  
+  
+## 例  
+  
+### 説明  
+ 次の例では、SQLMetal などのコード生成ツールによって定義される `ExampleClass` を最初に示し、次に 2 つのメソッドの 1 つだけを実装できることを示します。  
+  
+### コード  
+ [!code-csharp[DLinqSubmittingChanges#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#4)]
+ [!code-vb[DLinqSubmittingChanges#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#4)]  
+  
+## 例  
+  
+### 説明  
+ 次の例では、`Shipper` エンティティと `Order` エンティティのリレーションシップを使用します。  メソッドには部分メソッドの `InsertShipper` と `DeleteShipper` が含まれています。  これらのメソッドは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の対応付けによって提供される既定の部分メソッドをオーバーライドします。  
+  
+### コード  
+ [!code-csharp[DLinqOverrideDefault#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefault/cs/northwind.cs#1)]
+ [!code-vb[DLinqOverrideDefault#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefault/vb/northwind.vb#1)]  
+  
+## 参照  
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)   
+ [Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/ado-net-and-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/ado-net-and-linq-to-sql.md
new file mode 100644
index 00000000000..a94c16a5607
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/ado-net-and-linq-to-sql.md
@@ -0,0 +1,66 @@
+---
+title: "ADO.NET and LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49ac6da0-f2e1-46fa-963e-1b6dcb63fef7
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ADO.NET and LINQ to SQL
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、[!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] テクノロジ ファミリの一部です。  [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] プロバイダー モデルから提供されるサービスに基づいて動作します。  したがって、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] コードを既存の [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] アプリケーションに混在させ、現在の [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] ソリューションを [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に統合することができます。  次の図は、この関係を高いレベルから見たものです。  
+  
+ ![LINQ to SQL および ADO.NET](../../../../../../docs/framework/data/adonet/sql/linq/media/dlinq-3.png "DLinq\_3")  
+  
+## 接続  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.DataContext> を作成するときには、既存の [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] 接続を指定します。  <xref:System.Data.Linq.DataContext> に対するすべての操作 \(クエリを含む\) で、この接続が使用されます。  接続が既に開いていた場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では使い終わった後も接続をそのままにします。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#4)]
+ [!code-vb[DLinqCommunicatingWithDatabase#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#4)]  
+  
+ 次のコードに示すとおり、<xref:System.Data.Linq.DataContext.Connection%2A> プロパティを使用して、いつでも接続にアクセスしたり、任意に閉じたりすることができます。  
+  
+ [!code-csharp[DLinqAdoNet#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqAdoNet/cs/Program.cs#1)]
+ [!code-vb[DLinqAdoNet#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqAdoNet/vb/Module1.vb#1)]  
+  
+## トランザクション  
+ 既に独自のデータベース トランザクションを初期化していて、<xref:System.Data.Linq.DataContext> をトランザクションに使用する必要がある場合は、<xref:System.Data.Linq.DataContext> をトランザクションに渡すことができます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] でトランザクションを実行する場合は、<xref:System.Transactions.TransactionScope> オブジェクトの使用をお勧めします。  この方法を使うと、データベースと他のメモリ常駐リソース マネージャー間で動作する分散トランザクションを作成できます。  トランザクション スコープは、わずかなリソースで開始されます。  トランザクションのスコープ内に複数の接続がある場合のみ、このトランザクションは分散トランザクションに昇格します。  
+  
+ [!code-csharp[DLinqAdoNet#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqAdoNet/cs/Program.cs#2)]
+ [!code-vb[DLinqAdoNet#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqAdoNet/vb/Module1.vb#2)]  
+  
+ この方法は、すべてのデータベースに使用できるわけではありません。  たとえば、SqlClient 接続を [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] サーバーに使用する場合、この接続はシステム トランザクションに昇格できません。  代わりに、トランザクション スコープが使用されているときは、完全な分散トランザクションに自動的に参加します。  
+  
+## 直接 SQL コマンド  
+ ときには、クエリを実行したり変更内容を送信したりする <xref:System.Data.Linq.DataContext> 機能に不足があり、実行する必要がある特別なタスクを完了できないこともあります。  このような場合は、<xref:System.Data.Linq.DataContext.ExecuteQuery%2A> メソッドを使用して、SQL コマンドをデータベースに発行し、クエリ結果をオブジェクトに変換することができます。  
+  
+ たとえば、`Customer` クラスのデータが 2 つのテーブル \(customer1 および customer2\) に含まれているとします。  次のクエリは `Customer` オブジェクトのシーケンスを返します。  
+  
+ [!code-csharp[DLinqAdoNet#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqAdoNet/cs/Program.cs#3)]
+ [!code-vb[DLinqAdoNet#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqAdoNet/vb/Module1.vb#3)]  
+  
+ 表形式の結果の列名がエンティティ クラスの列のプロパティと一致する限り、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は SQL クエリからオブジェクトを作成します。  
+  
+### パラメーター  
+ <xref:System.Data.Linq.DataContext.ExecuteQuery%2A> メソッドは、パラメーターを受け取ります。  次のコードでは、パラメーター化されたクエリが実行されます。  
+  
+ [!code-csharp[DlinqAdoNet#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqAdoNet/cs/Program.cs#4)]
+ [!code-vb[DlinqAdoNet#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqAdoNet/vb/Module1.vb#4)]  
+  
+> [!NOTE]
+>  パラメーターは、`Console.WriteLine()` および `String.Format()` で使用されるものと同じ中かっこ表記でクエリ テキストに表現されます。  `String.Format()` は、指定されたクエリ文字列を受け取り、中かっこで囲まれたパラメーターを、`@p0`、`@p1` …、`@p(n)` などの、生成されたパラメーター名に置き換えます。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [How to: Reuse a Connection Between an ADO.NET Command and a DataContext](../../../../../../docs/framework/data/adonet/sql/linq/how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/aggregate-queries.md b/docs/framework/data/adonet/sql/linq/aggregate-queries.md
new file mode 100644
index 00000000000..fbd333dc131
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/aggregate-queries.md
@@ -0,0 +1,58 @@
+---
+title: "Aggregate Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 13ec5580-05ce-4a1f-9d3d-8660be7891a2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Aggregate Queries
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、`Average`、`Count`、`Max`、`Min`、および `Sum` の各集計演算子をサポートしています。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の集計演算子には、次の特性があります。  
+  
+-   集計クエリは直ちに実行されます。  
+  
+     詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+-   通常、集計クエリはコレクションではなく 1 つの数値を返します。  
+  
+     詳細については、「[Aggregation Operations](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/aggregation-operations.md)」を参照してください。  
+  
+-   匿名型に対して集計を呼び出すことはできません。  
+  
+ 以下のトピックの例は、Northwind サンプル データベースから派生しています。  詳細については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Return the Average Value From a Numeric Sequence](../../../../../../docs/framework/data/adonet/sql/linq/return-the-average-value-from-a-numeric-sequence.md)  
+ <xref:System.Linq.Enumerable.Average%2A> 演算子を使用する方法を示します。  
+  
+ [Count the Number of Elements in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/count-the-number-of-elements-in-a-sequence.md)  
+ <xref:System.Linq.Enumerable.Count%2A> 演算子を使用する方法を示します。  
+  
+ [Find the Maximum Value in a Numeric Sequence](../../../../../../docs/framework/data/adonet/sql/linq/find-the-maximum-value-in-a-numeric-sequence.md)  
+ <xref:System.Linq.Enumerable.Max%2A> 演算子を使用する方法を示します。  
+  
+ [Find the Minimum Value in a Numeric Sequence](../../../../../../docs/framework/data/adonet/sql/linq/find-the-minimum-value-in-a-numeric-sequence.md)  
+ <xref:System.Linq.Enumerable.Min%2A> 演算子を使用する方法を示します。  
+  
+ [Compute the Sum of Values in a Numeric Sequence](../../../../../../docs/framework/data/adonet/sql/linq/compute-the-sum-of-values-in-a-numeric-sequence.md)  
+ <xref:System.Linq.Enumerable.Sum%2A> 演算子を使用する方法を示します。  
+  
+## 関連項目  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)  
+ Visual Basic および C\# の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリに関するトピックへのリンクを示します。  
+  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] での [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリの設計に関する概念について説明するトピックへのリンクを示します。  
+  
+ [Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] でクエリが動作するしくみについて説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/analyzing-linq-to-sql-source-code.md b/docs/framework/data/adonet/sql/linq/analyzing-linq-to-sql-source-code.md
new file mode 100644
index 00000000000..aa16347906b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/analyzing-linq-to-sql-source-code.md
@@ -0,0 +1,35 @@
+---
+title: "Analyzing LINQ to SQL Source Code | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cba3eef8-e108-4478-b588-ad59580e133e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Analyzing LINQ to SQL Source Code
+以下の手順を実行すると、Northwind サンプル データベースから [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のソース コードを作成できます。  オブジェクト モデルの要素とデータベースの要素を比較対照することで、個別の項目がどのように対応付けられているかがわかります。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]を使用してこのコードを生成できます。  
+  
+1.  開発用コンピューターに Northwind サンプル データベースがない場合は、無料でダウンロードできます。  詳細については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  
+  
+2.  SqlMetal コマンド ライン ツールを使用して、Visual Basic または C\# のソース ファイルを生成します。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  コマンド プロンプトで次のコマンドを入力すると、ストアド プロシージャおよび関数を含めて Visual Basic または C\# のソース ファイルを生成できます。  
+  
+    -   `sqlmetal /code:northwind.vb /language:vb "c:\northwnd.mdf" /sprocs /functions /pluralize`  
+  
+    -   `sqlmetal /code:northwind.cs /language:csharp "c:\northwnd.mdf" /sprocs /functions /pluralize`  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)   
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/attribute-based-mapping.md b/docs/framework/data/adonet/sql/linq/attribute-based-mapping.md
new file mode 100644
index 00000000000..30116d51d19
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/attribute-based-mapping.md
@@ -0,0 +1,153 @@
+---
+title: "Attribute-Based Mapping | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6dd89999-f415-4d61-b8c8-237d23d7924e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Attribute-Based Mapping
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、属性を適用するか、または外部のマッピング ファイルを使用して、SQL Server データベースを [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルに対応付けます。  このトピックでは、属性ベースの方法について説明します。  
+  
+ 大部分の基本フォームでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、データベースと <xref:System.Data.Linq.DataContext>、テーブルとクラス、列およびリレーションシップとそのクラスのプロパティを、それぞれ対応付けています。  属性を使用して、オブジェクト モデル内の継承階層を対応付けることもできます。  詳細については、「[How to: Generate the Object Model in Visual Basic or C\#](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md)」を参照してください。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用する開発者は、一般に [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] を使用して属性ベースの対応付けを実行します。また、SQLMetal コマンド ライン ツールを使用したり、自分で属性をハンド コードしたりすることもできます。  詳細については、「[How to: Generate the Object Model in Visual Basic or C\#](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md)」を参照してください。  
+  
+> [!NOTE]
+>  外部 XML ファイルを使用して対応付けることもできます。  詳細については、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+ 以下のセクションでは、属性ベースの対応付けについて詳しく説明します。  詳細については、「<xref:System.Data.Linq.Mapping>」を参照してください。  
+  
+## DatabaseAttribute 属性  
+ この属性は、接続によってデータベースの名前が提供されない場合に、データベースの既定の名前を指定するために使用します。  この属性は省略可能ですが、この属性を使用する場合は、次の表に示されているように、<xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> プロパティを適用する必要があります。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A>|文字列|「<xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A>」を参照してください。|<xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> プロパティを使用して、データベースの名前を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.DatabaseAttribute>」を参照してください。  
+  
+## TableAttribute 属性  
+ この属性は、クラスを、データベース テーブルまたはビューに関連付けられたエンティティ クラスとして指定するために使用します。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、この属性を持つクラスを、永続的なクラスとして扱います。  次の表は、<xref:System.Data.Linq.Mapping.TableAttribute.Name%2A> プロパティについての説明です。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.TableAttribute.Name%2A>|文字列|クラス名と同じ文字列|クラスを、データベース テーブルに関連付けられたエンティティ クラスとして指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.TableAttribute>」を参照してください。  
+  
+## ColumnAttribute 属性  
+ この属性は、データベース テーブルの列を表すエンティティ クラスのメンバーを指定するために使用します。  この属性は、フィールドまたはプロパティに適用できます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がデータベースへの変更を保存すると、列として指定したメンバーのみが取得および保持されます。  この属性を持たないメンバーは非永続的であると見なされ、挿入や更新の場合に送信されません。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.AutoSync%2A>|AutoSync|Never|共通言語ランタイム \(CLR\) に対して、挿入または更新操作の後に値を取得することを指示します。<br /><br /> オプション : Always、Never、OnUpdate、OnInsert|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A>|ブール型|`true`|列に null 値を含めることができることを示します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A>|文字列|推論によるデータベース列型|データベースの型と修飾子を使用して、データベース列の型を指定します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A>|文字列|Empty|データベースの計算列を定義します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A>|ブール型|`false`|データベースが自動生成する値が、列に含まれることを示します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.IsDiscriminator%2A>|ブール型|`false`|[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 継承階層の識別子の値が列に含まれることを示します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A>|ブール型|`false`|このクラス メンバーが、テーブルの主キーの列、または主キーの一部である列を表すことを指定します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A>|ブール型|`false`|メンバーの列の型を、データベースのタイムスタンプまたはバージョン番号として指定します。|  
+|<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A>|UpdateCheck|`Always` \(メンバーの <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> が `true` の場合は除く\)|[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がオプティミスティック同時実行競合を検出する方法を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.ColumnAttribute>」を参照してください。  
+  
+> [!NOTE]
+>  AssociationAttribute プロパティ値と ColumnAttribute Storage プロパティ値では大文字と小文字が区別されます。  たとえば、AssociationAttribute.Storage  プロパティの属性に使用されている値は、コード内の別の場所で使用されている対応するプロパティ名と、大文字と小文字が一致するようにしてください。  これは、[!INCLUDE[vb_current_short](../../../../../../includes/vb-current-short-md.md)] など、通常は大文字と小文字が区別されない言語を含むすべての .NET プログラミング言語に適用されます。  Storage プロパティの詳細については、「<xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A?displayProperty=fullName>」を参照してください。  
+  
+## AssociationAttribute 属性  
+ この属性は、外部キーと主キーのリレーションシップなど、データベース内の関連付けを表すプロパティを指定するために使用します。  リレーションシップの詳細については、「[How to: Map Database Relationships](../../../../../../docs/framework/data/adonet/sql/linq/how-to-map-database-relationships.md)」を参照してください。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.DeleteOnNull%2A>|ブール型|`false`|外部キー メンバーがすべて null 非許容の関連付けの場合、関連付けが null に設定されるとオブジェクトを削除します。|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.DeleteRule%2A>|文字列|なし|関連付けに削除の動作を追加します。|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.IsForeignKey%2A>|ブール型|`false`|true の場合、データベースのリレーションシップを表す関連付けの中で、メンバーを外部キーとして指定します。|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.IsUnique%2A>|ブール型|`false`|true の場合、外部キーの一意性の制約を示します。|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.OtherKey%2A>|文字列|関連クラスの ID|ターゲット エンティティ クラスの 1 つ以上のメンバーを、関連付けの他方の側のキー値として指定します。|  
+|<xref:System.Data.Linq.Mapping.AssociationAttribute.ThisKey%2A>|文字列|包含クラスの ID|関連付けのこちら側のキー値を表す、このエンティティ クラスのメンバーを指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.AssociationAttribute>」を参照してください。  
+  
+> [!NOTE]
+>  AssociationAttribute プロパティ値と ColumnAttribute Storage プロパティ値では大文字と小文字が区別されます。  たとえば、AssociationAttribute.Storage  プロパティの属性に使用されている値は、コード内の別の場所で使用されている対応するプロパティ名と、大文字と小文字が一致するようにしてください。  これは、[!INCLUDE[vb_current_short](../../../../../../includes/vb-current-short-md.md)] など、通常は大文字と小文字が区別されない言語を含むすべての .NET プログラミング言語に適用されます。  Storage プロパティの詳細については、「<xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A?displayProperty=fullName>」を参照してください。  
+  
+## InheritanceMappingAttribute 属性  
+ この属性は、継承階層を対応付けるために使用します。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Code%2A>|文字列|なし。  値を指定する必要があります。|識別子のコード値を指定します。|  
+|<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.IsDefault%2A>|ブール型|`false`|true の場合、ストア内の識別子の値が、指定された値に一致しないときは、この型のオブジェクトをインスタンス化します。|  
+|<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Type%2A>|種類|なし。  値を指定する必要があります。|階層内のクラスの型を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute>」を参照してください。  
+  
+## FunctionAttribute 属性  
+ この属性は、データベース内のストアド プロシージャまたはユーザー定義関数として表すメソッドを指定するために使用します。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.FunctionAttribute.IsComposable%2A>|ブール型|`false`|false の場合、ストアド プロシージャへの対応付けを表します。  true の場合、ユーザー定義関数への対応付けを表します。|  
+|<xref:System.Data.Linq.Mapping.FunctionAttribute.Name%2A>|文字列|データベース内の名前と同じ文字列|ストアド プロシージャまたはユーザー定義関数の名前を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.FunctionAttribute>」を参照してください。  
+  
+## ParameterAttribute 属性  
+ この属性は、ストアド プロシージャ メソッドの入力パラメーターを対応付けるために使用します。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.ParameterAttribute.DbType%2A>|文字列|なし|データベースの型を指定します。|  
+|<xref:System.Data.Linq.Mapping.ParameterAttribute.Name%2A>|文字列|データベース内のパラメーター名と同じ文字列|パラメーターの名前を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.ParameterAttribute>」を参照してください。  
+  
+## ResultTypeAttribute 属性  
+ この属性は、結果の型を指定するために使用します。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.ResultTypeAttribute.Type%2A>|型|\(なし\)|<xref:System.Data.Linq.IMultipleResults> を返すストアド プロシージャに対応付けられているメソッドで使用します。  ストアド プロシージャの有効な型マッピングまたは期待される型マッピングを宣言します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.ResultTypeAttribute>」を参照してください。  
+  
+## DataAttribute 属性  
+ この属性は、名前およびプライベート ストレージ フィールドを指定するために使用します。  
+  
+ この属性のプロパティを次の表に示します。  
+  
+|プロパティ|種類|既定値|説明|  
+|-----------|--------|---------|--------|  
+|<xref:System.Data.Linq.Mapping.DataAttribute.Name%2A>|文字列|データベース内の名前と同じ|テーブル、列などの名前を指定します。|  
+|<xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A>|文字列|パブリック アクセサー|基になるストレージ フィールドの名前を指定します。|  
+  
+ 詳細については、「<xref:System.Data.Linq.Mapping.DataAttribute>」を参照してください。  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/background-information.md b/docs/framework/data/adonet/sql/linq/background-information.md
new file mode 100644
index 00000000000..d575acb9b84
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/background-information.md
@@ -0,0 +1,93 @@
+---
+title: "Background Information | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 724888f2-d3f1-4bea-b9a1-a0adb8a00f3b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Background Information
+このセクションのトピックでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の使用に関する基本事項の範囲を超えた概念と手順について説明します。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] コードおよびアプリケーションの他の例を参照するには、次の手順に従います。  
+  
+-   特定の問題について MSDN ライブラリを検索します。  
+  
+-   [LINQ フォーラム](http://go.microsoft.com/fwlink/?LinkId=76488)に参加して、複雑なトピックについて専門家と検討したりすることもできます。  
+  
+-   [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のコード例を含む、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジについて記載されているホワイト ペーパーを参照します。  詳細については、「[LINQ to SQL: リレーショナル データのための .NET 統合言語クエリ](http://go.microsoft.com/fwlink/?LinkId=93205)」を参照してください。  
+  
+## このセクションの内容  
+ [ADO.NET and LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/ado-net-and-linq-to-sql.md)  
+ [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] と [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の関係について説明します。  
+  
+ [Analyzing LINQ to SQL Source Code](../../../../../../docs/framework/data/adonet/sql/linq/analyzing-linq-to-sql-source-code.md)  
+ Northwind サンプル データベースからソース コードを生成および表示することによって、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の対応付けを分析する方法について説明します。  
+  
+ [Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)  
+ 検証コードおよび他のカスタマイズを追加する方法について説明します。  
+  
+ [Data Binding](../../../../../../docs/framework/data/adonet/sql/linq/data-binding.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が <xref:System.ComponentModel.IListSource> を使用してデータ バインディングをサポートする方法について説明します。  
+  
+ [Inheritance Support](../../../../../../docs/framework/data/adonet/sql/linq/inheritance-support.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルにおける継承の役割と、クエリ内で関連する演算子を使用する方法について説明します。  
+  
+ [Local Method Calls](../../../../../../docs/framework/data/adonet/sql/linq/local-method-calls.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がサポートするローカル メソッド呼び出しについて説明します。  
+  
+ [N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用する多階層アプリケーションについて詳しく説明します。  
+  
+ [Object Identity](../../../../../../docs/framework/data/adonet/sql/linq/object-identity.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデル内のオブジェクト識別子について説明し、この機能とデータベース内のオブジェクト識別子との相違について説明します。  
+  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)  
+ オブジェクト モデルと、リレーショナル データ モデルとの関係について説明します。  
+  
+ [Object States and Change\-Tracking](../../../../../../docs/framework/data/adonet/sql/linq/object-states-and-change-tracking.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が変更を追跡する方法について詳しく説明します。  
+  
+ [Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)  
+ オプティミスティック同時実行制御について説明し、用語を定義します。  
+  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] のクエリとは異なる、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のクエリの要素について説明します。  
+  
+ [Retrieving Objects from the Identity Cache](../../../../../../docs/framework/data/adonet/sql/linq/retrieving-objects-from-the-identity-cache.md)  
+ ID キャッシュからオブジェクトを取得するクエリについて説明します。  
+  
+ [Security in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md)  
+ データベース接続におけるセキュリティへの適切な対応について説明します。  
+  
+ [Serialization](../../../../../../docs/framework/data/adonet/sql/linq/serialization.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーション内のシリアル化プロセスについて説明します。  
+  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)  
+ デザイン時にストアド プロシージャを対応付ける方法、およびアプリケーションからこれらを呼び出す方法について説明します。  
+  
+ [Transaction Support](../../../../../../docs/framework/data/adonet/sql/linq/transaction-support.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がサポートする 3 つのトランザクション モデルについて説明します。  
+  
+ [SQL\-CLR Type Mismatches](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md)  
+ さまざまな種類のシステムが混在する場合の問題について説明します。  
+  
+ [SQL\-CLR Custom Type Mappings](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md)  
+ 型マッピングをカスタマイズする際のガイダンスを示します。  
+  
+ [User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/user-defined-functions.md)  
+ デザイン時にユーザー定義関数を対応付ける方法、およびアプリケーションからこれらを呼び出す方法について説明します。  
+  
+## 関連項目  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のさまざまな要素について説明するセクションへのリンクを示します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/basic-data-types.md b/docs/framework/data/adonet/sql/linq/basic-data-types.md
new file mode 100644
index 00000000000..6be85939050
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/basic-data-types.md
@@ -0,0 +1,34 @@
+---
+title: "Basic Data Types | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eca2c472-9548-4800-bd31-5d8d9f11752b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Basic Data Types
+LINQ to SQL クエリは、Microsoft SQL Server で実行される前に Transact\-SQL に変換されるため、  LINQ to SQL は、SQL Server が基本データ型に対してサポートするのと同じ組み込み機能の多くをサポートします。  
+  
+## キャスト  
+ SQL Server 内に同様の有効な変換が存在する場合は、変換元の CLR 型から変換先の CLR 型への暗黙的または明示的なキャストが有効になります。  CLR キャストの詳細については、「[CType 関数](../Topic/CType%20Function%20\(Visual%20Basic\).md) \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\)」および「[as](../Topic/as%20\(C%23%20Reference\).md)」を参照してください。  変換後に、CLR 式に対して実行された操作の動作は、変換先の型に通常割り当てられる他の CLR 式の動作と一致するように、キャストによって変更されます。継承の割り当てのコンテキストにおいてもキャストは変換可能です。  より厳密なエンティティ サブタイプにオブジェクトを変換して、そのサブタイプに固有のデータへのアクセスを可能にすることができます。  
+  
+## 等値演算子  
+ LINQ to SQL は、LINQ to SQL クエリ内の基本データ型で次の等値演算子をサポートします。  
+  
+-   等値演算子および非等値演算子 : 等値演算子および非等値演算子は、数値型、<xref:System.Boolean> 型、<xref:System.DateTime> 型、および <xref:System.TimeSpan> 型についてサポートされます。  [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の演算子 `=` および `<>` の詳細については、「[Comparison Operators](../Topic/Comparison%20Operators%20\(Visual%20Basic\).md)」を参照してください。C\# の比較演算子 `==` および `!=` の詳細については、「[\=\= 演算子](../Topic/==%20Operator%20\(C%23%20Reference\).md)」および「[\!\= 演算子](../Topic/!=%20Operator%20\(C%23%20Reference\).md)」を参照してください。  
+  
+-   Is 演算子 : `IS` 演算子には、継承の割り当ての使用時にサポートされる変換があります。  これは、オブジェクトが特定の種類のエンティティであるかどうかを検査する場合に、判別列を直接調べる代わりとして使用でき、判別列のチェックに変換されます。  Visual Basic と C\# の Is 演算子の詳細については、「[Is Operator](../Topic/Is%20Operator%20\(Visual%20Basic\).md)」および「[is](../Topic/is%20\(C%23%20Reference\).md)」を参照してください。  
+  
+## 参照  
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)   
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/boolean-data-types.md b/docs/framework/data/adonet/sql/linq/boolean-data-types.md
new file mode 100644
index 00000000000..d762beb5de9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/boolean-data-types.md
@@ -0,0 +1,34 @@
+---
+title: "Boolean Data Types | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57f7376b-4b11-4b35-98a9-780382053ceb
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Boolean Data Types
+ブール演算子は、共通言語ランタイム \(CLR\) で正常に動作しますが、ショートサーキットの動作は変換されません。  たとえば、Visual Basic の `AndAlso` 演算子は `And` 演算子のように動作します。  C\# の `&&` 演算子は `&` 演算子のように動作します。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の演算子をサポートしています。  
+  
+|Visual Basic|C\#|  
+|------------------|---------|  
+|[And Operator](../Topic/And%20Operator%20\(Visual%20Basic\).md)|[& 演算子](../Topic/&%20Operator%20\(C%23%20Reference\).md)|  
+|[AndAlso Operator](../Topic/AndAlso%20Operator%20\(Visual%20Basic\).md)|[&& 演算子](../Topic/&&%20Operator%20\(C%23%20Reference\).md)|  
+|[Or 演算子](../Topic/Or%20Operator%20\(Visual%20Basic\).md)|[&#124; 演算子](../Topic/%7C%20Operator%20\(C%23%20Reference\).md)|  
+|[OrElse Operator](../Topic/OrElse%20Operator%20\(Visual%20Basic\).md)|[&#124;&#124; 演算子](../Topic/%7C%7C%20Operator%20\(C%23%20Reference\).md)|  
+|[Xor Operator](../Topic/Xor%20Operator%20\(Visual%20Basic\).md)|[^ 演算子](../Topic/%5E%20Operator%20\(C%23%20Reference\).md)|  
+|[Not Operator](../Topic/Not%20Operator%20\(Visual%20Basic\).md)|[\! 演算子](../Topic/!%20Operator%20\(C%23%20Reference\).md)|  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md
new file mode 100644
index 00000000000..2aa47ce26a6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md
@@ -0,0 +1,284 @@
+---
+title: "Code Generation in LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ddcbdaa1-e7fa-4d85-a379-313b49965c07
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Code Generation in LINQ to SQL
+[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]または SQLMetal コマンド ライン ツールを使用することにより、データベースを表すコードを生成できます。  どちらの場合も、エンド ツー エンドのコード生成が次の 3 段階で行われます。  
+  
+1.  *DBML Extractor* がスキーマ情報をデータベースから抽出して、XML 形式の DBML ファイルの中に情報を再アセンブルします。  
+  
+2.  *DBML Validator* が DBML ファイルをスキャンし、エラーがないかどうか確認します。  
+  
+3.  検証エラーが見つからない場合、ファイルはコード ジェネレーターに渡されます。  
+  
+ 詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してコードを生成することもできます。  「[LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)」を参照してください。  
+  
+## DBML Extractor  
+ DBML Extractor は [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のコンポーネントの 1 つで、データベース メタデータを入力として受け入れ、DBML ファイルを出力として生成します。  
+  
+## コード ジェネレーター  
+ コード ジェネレーターは [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のコンポーネントの 1 つで、DBML ファイルを [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]、C\#、または XML のマッピング ファイルに変換します。  
+  
+## XML スキーマ定義ファイル  
+ DBML ファイルは、以下のような XSD ファイルのスキーマ定義に対して有効である必要があります。  
+  
+ このスキーマ定義ファイルを、外部マッピング ファイルの検証に使われるスキーマ定義ファイルと区別してください。  詳細については、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ユーザーには、この XSD ファイルが \[XML スキーマ\] ダイアログ ボックスで「DbmlSchema.xsd」としても表示されます。  DBML ファイルの検証で XSD ファイルを正しく使用するには、「[How to: Validate DBML and External Mapping Files](../../../../../../docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md)」を参照してください。  
+  
+```  
+?<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://schemas.microsoft.com/linqtosql/dbml/2007" xmlns="http://schemas.microsoft.com/linqtosql/dbml/2007"  
+elementFormDefault="qualified" >  
+  <xs:element name="Database" type="Database" />  
+  <xs:complexType name="Database">  
+    <xs:sequence>  
+      <xs:element name="Connection" type="Connection" minOccurs="0" maxOccurs="1" />  
+      <xs:element name="Table" type="Table" minOccurs="0" maxOccurs="unbounded" />  
+      <xs:element name="Function" type="Function" minOccurs="0" maxOccurs="unbounded" />  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="EntityNamespace" type="xs:string" use="optional" />  
+    <xs:attribute name="ContextNamespace" type="xs:string" use="optional" />  
+    <xs:attribute name="Class" type="xs:string" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="ClassModifier" use="optional" />  
+    <xs:attribute name="BaseType" type="xs:string" use="optional" />  
+    <xs:attribute name="Provider" type="xs:string" use="optional" />  
+    <xs:attribute name="ExternalMapping" type="xs:boolean" use="optional" />  
+    <xs:attribute name="Serialization" type="SerializationMode" use="optional" />  
+    <xs:attribute name="EntityBase" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Table">  
+    <xs:all>  
+      <xs:element name="Type" type="Type" minOccurs="1" maxOccurs="1" />  
+      <xs:element name="InsertFunction" type="TableFunction" minOccurs="0" maxOccurs="1" />  
+      <xs:element name="UpdateFunction" type="TableFunction" minOccurs="0" maxOccurs="1" />  
+      <xs:element name="DeleteFunction" type="TableFunction" minOccurs="0" maxOccurs="1" />  
+    </xs:all>  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Member" type="xs:string" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="MemberModifier" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Type">  
+    <xs:sequence>  
+      <xs:choice minOccurs="0" maxOccurs="unbounded">  
+        <xs:element name="Column" type="Column" minOccurs="0" maxOccurs="unbounded" />  
+        <xs:element name="Association" type="Association" minOccurs="0" maxOccurs="unbounded" />  
+      </xs:choice>  
+      <xs:element name="Type" type="Type" minOccurs="0" maxOccurs="unbounded" />  
+    </xs:sequence>  
+    <xs:attribute name="IdRef" type="xs:IDREF" use="optional" />  
+    <xs:attribute name="Id" type="xs:ID" use="optional" />  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="InheritanceCode" type="xs:string" use="optional" />  
+    <xs:attribute name="IsInheritanceDefault" type="xs:boolean" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="ClassModifier" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Column">  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Member" type="xs:string" use="optional" />  
+    <xs:attribute name="Storage" type="xs:string" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="MemberModifier" use="optional" />  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+    <xs:attribute name="IsReadOnly" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsPrimaryKey" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsDbGenerated" type="xs:boolean" use="optional" />  
+    <xs:attribute name="CanBeNull" type="xs:boolean" use="optional" />  
+    <xs:attribute name="UpdateCheck" type="UpdateCheck" use="optional" />  
+    <xs:attribute name="IsDiscriminator" type="xs:boolean" use="optional" />  
+    <xs:attribute name="Expression" type="xs:string" use="optional" />  
+    <xs:attribute name="IsVersion" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsDelayLoaded" type="xs:boolean" use="optional" />  
+    <xs:attribute name="AutoSync" type="AutoSync" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Association">  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Member" type="xs:string" use="required" />  
+    <xs:attribute name="Storage" type="xs:string" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="MemberModifier" use="optional" />  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attribute name="ThisKey" type="xs:string" use="optional" />  
+    <xs:attribute name="OtherKey" type="xs:string" use="optional" />  
+    <xs:attribute name="IsForeignKey" type="xs:boolean" use="optional" />  
+    <xs:attribute name="Cardinality" type="Cardinality" use="optional" />  
+    <xs:attribute name="DeleteRule" type="xs:string" use="optional" />  
+    <xs:attribute name="DeleteOnNull" type="xs:boolean" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Function">  
+    <xs:sequence>  
+      <xs:element name="Parameter" type="Parameter" minOccurs="0" maxOccurs="unbounded" />  
+      <xs:choice>  
+        <xs:element name="ElementType" type="Type" minOccurs="0" maxOccurs="unbounded" />  
+        <xs:element name="Return" type="Return" minOccurs="0" maxOccurs="1" />  
+      </xs:choice>  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Id" type="xs:ID" use="optional" />  
+    <xs:attribute name="Method" type="xs:string" use="optional" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+    <xs:attribute name="Modifier" type="MemberModifier" use="optional" />  
+    <xs:attribute name="HasMultipleResults" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsComposable" type="xs:boolean" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="TableFunction">  
+    <xs:sequence>  
+      <xs:element name="Argument" type="TableFunctionParameter" minOccurs="0" maxOccurs="unbounded" />  
+      <xs:element name="Return" type="TableFunctionReturn" minOccurs="0" maxOccurs="1" />  
+    </xs:sequence>  
+    <xs:attribute name="FunctionId" type="xs:IDREF" use="required" />  
+    <xs:attribute name="AccessModifier" type="AccessModifier" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Parameter">  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="Parameter" type="xs:string" use="optional" />  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+    <xs:attribute name="Direction" type="ParameterDirection" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Return">  
+    <xs:attribute name="Type" type="xs:string" use="required" />  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="TableFunctionParameter">  
+    <xs:attribute name="Parameter" type="xs:string" use="required" />  
+    <xs:attribute name="Member" type="xs:string" use="required" />  
+    <xs:attribute name="Version" type="Version" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="TableFunctionReturn">  
+    <xs:attribute name="Member" type="xs:string" use="required" />  
+  </xs:complexType>  
+  <xs:complexType name="Connection">  
+    <xs:attribute name="Provider" type="xs:string" use="required" />  
+    <xs:attribute name="Mode" type="ConnectionMode" use="optional" />  
+    <xs:attribute name="ConnectionString" type="xs:string" use="optional" />  
+    <xs:attribute name="SettingsObjectName" type="xs:string" use="optional" />  
+    <xs:attribute name="SettingsPropertyName" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:simpleType name="ConnectionMode">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="ConnectionString" />  
+      <xs:enumeration value="AppSettings" />  
+      <xs:enumeration value="WebSettings" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="AccessModifier">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Public" />  
+      <xs:enumeration value="Internal" />  
+      <xs:enumeration value="Protected" />  
+      <xs:enumeration value="ProtectedInternal" />  
+      <xs:enumeration value="Private" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="UpdateCheck">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Always" />  
+      <xs:enumeration value="Never" />  
+      <xs:enumeration value="WhenChanged" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="SerializationMode">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="None" />  
+      <xs:enumeration value="Unidirectional" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="ParameterDirection">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="In" />  
+      <xs:enumeration value="Out" />  
+      <xs:enumeration value="InOut" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="Version">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Current" />  
+      <xs:enumeration value="Original" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="AutoSync">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Never" />  
+      <xs:enumeration value="OnInsert" />  
+      <xs:enumeration value="OnUpdate" />  
+      <xs:enumeration value="Always" />  
+      <xs:enumeration value="Default" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="ClassModifier">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Sealed" />  
+      <xs:enumeration value="Abstract" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="MemberModifier">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Virtual" />  
+      <xs:enumeration value="Override" />  
+      <xs:enumeration value="New" />  
+      <xs:enumeration value="NewVirtual" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="Cardinality">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="One" />  
+      <xs:enumeration value="Many" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+```  
+  
+## サンプル DBML ファイル  
+ 次のコードは、Northwind サンプル データベースから作成された DBML ファイルの抜粋です。  SQLMetal で **\/xml** オプションを使用することにより、ファイル全体を生成できます。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+```  
+<?xml version="1.0" encoding="utf-16"?>  
+<Database Name="northwnd" Class="Northwnd" xmlns="http://schemas.microsoft.com/dsltools/DLinqML">  
+  
+  <Table Name="Customers">  
+    <Type Name="Customer">  
+      <Column Name="CustomerID" Type="System.String" DbType="NChar(5) NOT NULL" IsPrimaryKey="True" CanBeNull="False" />  
+      <Column Name="CompanyName" Type="System.String" DbType="NVarChar(40) NOT NULL" CanBeNull="False" />  
+      <Column Name="ContactName" Type="System.String" DbType="NVarChar(30)" CanBeNull="True" />  
+      <Column Name="ContactTitle" Type="System.String" DbType="NVarChar(30)" CanBeNull="True" />  
+      <Column Name="Address" Type="System.String" DbType="NVarChar(60)" CanBeNull="True" />  
+      <Column Name="City" Type="System.String" DbType="NVarChar(15)" CanBeNull="True" />  
+      <Column Name="Region" Type="System.String" DbType="NVarChar(15)" CanBeNull="True" />  
+      <Column Name="PostalCode" Type="System.String" DbType="NVarChar(10)" CanBeNull="True" />  
+      <Column Name="Country" Type="System.String" DbType="NVarChar(15)" CanBeNull="True" />  
+      <Column Name="Phone" Type="System.String" DbType="NVarChar(24)" CanBeNull="True" />  
+      <Column Name="Fax" Type="System.String" DbType="NVarChar(24)" CanBeNull="True" />  
+      <Association Name="FK_CustomerCustomerDemo_Customers" Member="CustomerCustomerDemos" ThisKey="CustomerID" OtherKey="CustomerID" OtherTable="CustomerCustomerDemo" DeleteRule="NO ACTION" />  
+      <Association Name="FK_Orders_Customers" Member="Orders" ThisKey="CustomerID" OtherKey="CustomerID" OtherTable="Orders" DeleteRule="NO ACTION" />  
+    </Type>  
+  </Table>  
+</Database>  
+```  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)   
+ [How to: Generate the Object Model as an External File](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/communicating-with-the-database.md b/docs/framework/data/adonet/sql/linq/communicating-with-the-database.md
new file mode 100644
index 00000000000..a91f31f2b03
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/communicating-with-the-database.md
@@ -0,0 +1,33 @@
+---
+title: "Communicating with the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 659d9817-bcaa-457f-9639-169394177274
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Communicating with the Database
+このセクションのトピックでは、データベースとの通信を確立および維持するうえでの基本的な事項について説明します。  
+  
+## このセクションの内容  
+ [How to: Connect to a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md)  
+ <xref:System.Data.Linq.DataContext> クラスを使用してデータベースに接続する方法について説明します。  
+  
+ [How to: Directly Execute SQL Commands](../../../../../../docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-commands.md)  
+ <xref:System.Data.Linq.DataContext.ExecuteCommand%2A> クラスを使用して SQL 言語コマンドを送信する方法について説明します。  
+  
+ [How to: Reuse a Connection Between an ADO.NET Command and a DataContext](../../../../../../docs/framework/data/adonet/sql/linq/how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションで既存の [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] 接続を使用する例を示します。  
+  
+## 参照  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/compute-the-sum-of-values-in-a-numeric-sequence.md b/docs/framework/data/adonet/sql/linq/compute-the-sum-of-values-in-a-numeric-sequence.md
new file mode 100644
index 00000000000..d03c0579f43
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/compute-the-sum-of-values-in-a-numeric-sequence.md
@@ -0,0 +1,48 @@
+---
+title: "Compute the Sum of Values in a Numeric Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24e335b0-984e-4825-8721-0a91b533b7c3
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Compute the Sum of Values in a Numeric Sequence
+<xref:System.Linq.Enumerable.Sum%2A> 演算子を使用すると、シーケンス内の数値の合計を計算できます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の `Sum` 演算子には、次の特性があります。  
+  
+-   標準クエリ演算子の集計演算子 `Sum` では、空のシーケンスや null のみを含むシーケンスはゼロに評価されます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、SQL のセマンティクスは維持されます。  したがって、空のシーケンスまたは null のみを含むシーケンスについては、`Sum` 演算子は 0 ではなく null に評価します。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] での集計には、中間結果に対する SQL の制限が適用されます。  64 ビットの結果を使って 32 ビット整数の合計値を計算することはできません。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] による `Sum` の変換で、オーバーフローが発生する可能性があります。  これは、標準クエリ演算子の実装で、対応するメモリ内シーケンスでオーバーフローが発生しない場合でも起こる可能性があります。  
+  
+## 使用例  
+ `Order` テーブルに含まれるすべての注文の運賃の合計を求める例を次に示します。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`64942.6900` です。  
+  
+ [!code-csharp[DLinqQueryExamples#12](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#12)]
+ [!code-vb[DLinqQueryExamples#12](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#12)]  
+  
+## 使用例  
+ すべての製品の受注単位の合計を求める例を次に示します。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`780` です。  
+  
+ `Sum` には `short` 型のオーバーロードがないため、short 型 \(`UnitsOnOrder` など\) をキャストする必要があります。  
+  
+ [!code-csharp[DLinqQueryExamples#13](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#13)]
+ [!code-vb[DLinqQueryExamples#13](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#13)]  
+  
+## 参照  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/concatenate-two-sequences.md b/docs/framework/data/adonet/sql/linq/concatenate-two-sequences.md
new file mode 100644
index 00000000000..0bc2f5542e8
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/concatenate-two-sequences.md
@@ -0,0 +1,40 @@
+---
+title: "Concatenate Two Sequences | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76767e7c-0607-4e1d-9ca2-a94f311f45eb
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Concatenate Two Sequences
+2 つのシーケンスを連結するには、<xref:System.Linq.Queryable.Concat%2A> 演算子を使用します。  
+  
+ <xref:System.Linq.Queryable.Concat%2A> 演算子は、受信側と引数の順序が同じである、順序付けされたマルチセットに対して定義されます。  
+  
+ SQL での順序付けは、結果が作成される前の最終段階です。  このため、<xref:System.Linq.Queryable.Concat%2A> 演算子は `UNION ALL` を使用して実装され、その引数の順序を保持しません。  結果内での順序付けを正しく行うには、結果の順序を明示的に指定する必要があります。  
+  
+## 使用例  
+ この例では、<xref:System.Linq.Queryable.Concat%2A> を使用して、すべての `Customer` と `Employee` の電話番号と FAX 番号のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#39](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#39)]
+ [!code-vb[DLinqQueryExamples#39](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#39)]  
+  
+## 使用例  
+ この例では、<xref:System.Linq.Queryable.Concat%2A> を使用して、すべての `Customer` と `Employee` の名前と電話番号のマッピングのシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#40](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#40)]
+ [!code-vb[DLinqQueryExamples#40](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#40)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-a-generic-list.md b/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-a-generic-list.md
new file mode 100644
index 00000000000..6bd7c92054f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-a-generic-list.md
@@ -0,0 +1,29 @@
+---
+title: "Convert a Sequence to a Generic List | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7ab76d93-6898-4e75-b76f-290a66ecead8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Convert a Sequence to a Generic List
+シーケンスからジェネリック リストを作成するには、<xref:System.Linq.Enumerable.ToList%2A> を使用します。  
+  
+## 使用例  
+ 次のサンプルでは、<xref:System.Linq.Enumerable.ToList%2A> を使用して、クエリを直ちにジェネリック <xref:System.Collections.Generic.List%601> に評価します。  
+  
+ [!code-csharp[DLinqQueryExamples#45](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#45)]
+ [!code-vb[DLinqQueryExamples#45](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#45)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-an-array.md b/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-an-array.md
new file mode 100644
index 00000000000..c0f3ccaad95
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/convert-a-sequence-to-an-array.md
@@ -0,0 +1,29 @@
+---
+title: "Convert a Sequence to an Array | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf0af444-890d-43e2-aeca-98589dd74ddf
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Convert a Sequence to an Array
+シーケンスから配列を作成するには、<xref:System.Linq.Enumerable.ToArray%2A> を使用します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Linq.Enumerable.ToArray%2A> を使用して、クエリを直ちに配列に評価し、3 番目の要素を取得します。  
+  
+ [!code-csharp[DLinqQueryExamples#44](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#44)]
+ [!code-vb[DLinqQueryExamples#44](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#44)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/convert-a-type-to-a-generic-ienumerable.md b/docs/framework/data/adonet/sql/linq/convert-a-type-to-a-generic-ienumerable.md
new file mode 100644
index 00000000000..67ae33cb84a
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/convert-a-type-to-a-generic-ienumerable.md
@@ -0,0 +1,31 @@
+---
+title: "Convert a Type to a Generic IEnumerable | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 64774fb5-7447-4296-ad3b-8a94346f99a1
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Convert a Type to a Generic IEnumerable
+汎用 `IEnumerable` として型指定された引数を返すには、<xref:System.Linq.Enumerable.AsEnumerable%2A> を使用します。  
+  
+## 使用例  
+ この例では、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] \(既定の汎用 `Query` を使用\) は、クエリを SQL に変換し、サーバー上での実行を試みます。  しかし、`where` 句が、SQL に変換できない、ユーザー定義のクライアント側メソッド \(`isValidProduct`\) を参照しています。  
+  
+ これを解決するには、クライアント側の汎用 <xref:System.Collections.Generic.IEnumerable%601> 実装の `where` を指定し、汎用 <xref:System.Linq.IQueryable%601> を置き換えます。  <xref:System.Linq.Enumerable.AsEnumerable%2A> 演算子を呼び出すことによって、これを行います。  
+  
+ [!code-csharp[DLinqQueryExamples#46](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#46)]
+ [!code-vb[DLinqQueryExamples#46](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#46)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/count-the-number-of-elements-in-a-sequence.md b/docs/framework/data/adonet/sql/linq/count-the-number-of-elements-in-a-sequence.md
new file mode 100644
index 00000000000..ed75b93ced6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/count-the-number-of-elements-in-a-sequence.md
@@ -0,0 +1,40 @@
+---
+title: "Count the Number of Elements in a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ccbe5d54-c9eb-4b14-b0ab-f628483c5f99
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Count the Number of Elements in a Sequence
+<xref:System.Linq.Enumerable.Count%2A> 演算子を使用すると、シーケンス内の要素数をカウントできます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、出力は `91` になります。  
+  
+## 使用例  
+ データベース内の `Customers` の数をカウントする例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#4)]
+ [!code-vb[DLinqQueryExamples#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#4)]  
+  
+## 使用例  
+ データベース内の製品のうち、生産中止になっていない製品の数をカウントする例を次に示します。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、出力は `69` になります。  
+  
+ [!code-csharp[DLinqQueryExamples#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#5)]
+ [!code-vb[DLinqQueryExamples#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#5)]  
+  
+## 参照  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/creating-the-object-model.md b/docs/framework/data/adonet/sql/linq/creating-the-object-model.md
new file mode 100644
index 00000000000..1c5f7968433
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/creating-the-object-model.md
@@ -0,0 +1,48 @@
+---
+title: "Creating the Object Model | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27afce86-9b1d-45fb-8e0b-636bf671a236
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Creating the Object Model
+既存のデータベースからオブジェクト モデルを作成し、このオブジェクト モデルを既定の状態で使用できます。  オブジェクト モデルの多くの側面と動作をカスタマイズできます。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] を使用してオブジェクト モデルを作成できます。  
+  
+## このセクションの内容  
+ [How to: Generate the Object Model in Visual Basic or C\#](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md)  
+ SQLMetal コマンド ライン ツールの使い方について説明します。  また、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] ユーザー向けの[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)]に関するトピックへのリンクを示します。  
+  
+ [How to: Generate the Object Model as an External File](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md)  
+ 属性ベースの対応付けを使用する代わりに外部マッピング ファイルを生成する方法について説明します。  
+  
+ [How to: Generate Customized Code by Modifying a DBML File](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-customized-code-by-modifying-a-dbml-file.md)  
+ [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] または C\# のコードを DBML メタデータ ファイルから生成する方法について説明します。  
+  
+ [How to: Validate DBML and External Mapping Files](../../../../../../docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md)  
+ 変更したマッピング ファイルを検証する方法について説明します \(上級\)。  
+  
+ [How to: Make Entities Serializable](../../../../../../docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md)  
+ 適切な属性を追加してエンティティをシリアル化可能にする方法について説明します。  
+  
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)  
+ コード エディターを使用して、独自のマッピング コードを書いたり、自動的に生成されたコードをカスタマイズしたりする方法について説明します。  
+  
+## 関連項目  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルについて詳しく説明します。  
+  
+ [Typical Steps for Using LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/typical-steps-for-using-linq-to-sql.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションを実装する標準的な手順について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md b/docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md
new file mode 100644
index 00000000000..9c5111d1b16
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md
@@ -0,0 +1,38 @@
+---
+title: "Customizing Insert, Update, and Delete Operations | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 07eef055-8f6c-414d-850e-d323ff946cd0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Customizing Insert, Update, and Delete Operations
+既定で、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、挿入、読み取り、更新、および削除の各操作を実装する動的な SQL を生成します。  ただし、実際の使用では、業務ニーズに合わせてアプリケーションをカスタマイズすることが多くなります。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] を使って挿入、更新、および削除の各操作をカスタマイズできます。  
+  
+ ここでは、挿入、読み取り、更新、および削除の各操作をアプリケーションでカスタマイズするために [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に用意されている手段について説明します。  
+  
+## このセクションの内容  
+ [Customizing Operations: Overview](../../../../../../docs/framework/data/adonet/sql/linq/customizing-operations-overview.md)  
+ 挿入、読み取り、更新、および削除の各操作をカスタマイズするために [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に用意されている手段について説明します。  
+  
+ [Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/insert-update-and-delete-operations.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の既定のデータベース データ操作手順について説明します。  
+  
+ [Responsibilities of the Developer In Overriding Default Behavior](../../../../../../docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって強制されない要件を実装するときの開発者の役割について説明します。  
+  
+ [Adding Business Logic By Using Partial Methods](../../../../../../docs/framework/data/adonet/sql/linq/adding-business-logic-by-using-partial-methods.md)  
+ 自動生成されるメソッドをオーバーライドするために部分メソッドを使用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures-exclusively.md b/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures-exclusively.md
new file mode 100644
index 00000000000..58f53cc0464
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures-exclusively.md
@@ -0,0 +1,39 @@
+---
+title: "Customizing Operations by Using Stored Procedures Exclusively | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 441e8ef3-998c-4d12-8825-ce66a178f90f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Customizing Operations by Using Stored Procedures Exclusively
+ストアド プロシージャのみを使用してデータにアクセスすることは、一般的なシナリオです。  
+  
+## 例  
+  
+### 説明  
+ 最初のクエリ \(動的に SQL を実行するクエリ\) をストアド プロシージャのラップ メソッド呼び出しで置き換えることで、「[Customizing Operations By Using Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md)」に用意されたサンプル コードを変更できます。  
+  
+ 次の例に示すように、`CustomersByCity` がこのメソッドであることを前提とします。  
+  
+### コード  
+ [!code-csharp[DLinqOverrideDefaultSproc#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefaultSproc/cs/northwind.cs#4)]
+ [!code-vb[DLinqOverrideDefaultSproc#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefaultSproc/vb/northwind.vb#4)]  
+  
+ 次のコードは、動的 SQL を使わずに実行されます。  
+  
+ [!code-csharp[DLinqOverrideDefaultSproc#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefaultSproc/cs/Program.cs#5)]
+ [!code-vb[DLinqOverrideDefaultSproc#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefaultSproc/vb/Module1.vb#5)]  
+  
+## 参照  
+ [Responsibilities of the Developer In Overriding Default Behavior](../../../../../../docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md b/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md
new file mode 100644
index 00000000000..1b64ff3e51c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md
@@ -0,0 +1,55 @@
+---
+title: "Customizing Operations By Using Stored Procedures | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aedbecc1-c33c-4fb4-8861-fdf7e1dc6b8a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Customizing Operations By Using Stored Procedures
+ストアド プロシージャは、既定の動作をオーバーライドする方法として一般的に使用されます。  このトピックでは、ストアド プロシージャ用に生成されたメソッド ラッパーを使用する方法、およびストアド プロシージャを直接呼び出す方法の例を示します。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、挿入、更新、および削除を実行するストアド プロシージャを割り当てることができます。  
+  
+> [!NOTE]
+>  データベースによって生成された値を読み取るには、ストアド プロシージャの出力パラメーターを使用します。  出力パラメーターを使用できない場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]によって生成されたオーバーライドで処理するのではなく、部分メソッドの実装を作成します。  データベースによって生成される値に割り当てられているメンバーは、`INSERT` 操作または `UPDATE` 操作が正常に完了した後で、適切な値に設定する必要があります。  詳細については、「[Responsibilities of the Developer In Overriding Default Behavior](../../../../../../docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md)」を参照してください。  
+  
+## 例  
+  
+### 説明  
+ 次の例では、`Northwind` クラスに、ストアド プロシージャを呼び出す 2 つのメソッドがあり、派生クラスでのオーバーライドに使用されているものとします。  
+  
+### コード  
+ [!code-csharp[DLinqOverrideDefaultSproc#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefaultSproc/cs/northwind.cs#1)]
+ [!code-vb[DLinqOverrideDefaultSproc#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefaultSproc/vb/northwind.vb#1)]  
+  
+## 例  
+  
+### 説明  
+ 次のクラスはこれらのメソッドをオーバーライドに使用しています。  
+  
+### コード  
+ [!code-csharp[DLinqOverrideDefaultSproc#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefaultSproc/cs/northwind.cs#2)]
+ [!code-vb[DLinqOverrideDefaultSproc#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefaultSproc/vb/northwind.vb#2)]  
+  
+## 例  
+  
+### 説明  
+ `NorthwindThroughSprocs` は `Northwnd` とまったく同様に使用できます。  
+  
+### コード  
+ [!code-csharp[DLinqOverrideDefaultSproc#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqOverrideDefaultSproc/cs/Program.cs#3)]
+ [!code-vb[DLinqOverrideDefaultSproc#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqOverrideDefaultSproc/vb/Module1.vb#3)]  
+  
+## 参照  
+ [Responsibilities of the Developer In Overriding Default Behavior](../../../../../../docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/customizing-operations-overview.md b/docs/framework/data/adonet/sql/linq/customizing-operations-overview.md
new file mode 100644
index 00000000000..e913ad39387
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/customizing-operations-overview.md
@@ -0,0 +1,34 @@
+---
+title: "Customizing Operations: Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3546296-1443-4b88-aa6e-d41011041ba7
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Customizing Operations: Overview
+既定では、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が、挿入、更新、および削除の各操作のための動的な SQL を対応付けに基づいて生成します。しかし、実際には、セキュリティや検査などを目的とした独自のビジネス ロジックを追加することが必要になる場合がよくあります。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、以下の方法で、これらの操作をカスタマイズできます。  
+  
+## 読み込みオプション  
+ クエリで、データベースに接続するときに、メイン ターゲットに関係するデータをどれだけ取得するかを制御できます。  この機能は主に、<xref:System.Data.Linq.DataLoadOptions> を使用して実装します。  詳細については、「[Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)」を参照してください。  
+  
+## 部分メソッド  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] による既定の対応付けでは、ビジネス ロジックの実装に使用できる部分メソッドが提供されます。  詳細については、「[Adding Business Logic By Using Partial Methods](../../../../../../docs/framework/data/adonet/sql/linq/adding-business-logic-by-using-partial-methods.md)」を参照してください。  
+  
+## ストアド プロシージャおよびユーザー定義関数  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、ストアド プロシージャとユーザー定義関数の使用がサポートされています。  ストアド プロシージャは、操作のカスタマイズによく使用されます。  詳細については、「[Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)」を参照してください。  
+  
+## 参照  
+ [Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/data-binding.md b/docs/framework/data/adonet/sql/linq/data-binding.md
new file mode 100644
index 00000000000..6821d50f780
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/data-binding.md
@@ -0,0 +1,114 @@
+---
+title: "Data Binding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cbec8b02-a1e8-4ae8-a83b-bb5190413ac5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Data Binding
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、グリッド コントロールなどのコモン コントロールに対するバインディングをサポートしています。  具体的に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、データ グリッドにバインドし、マスター\/詳細形式のバインディングを処理するための基本パターンが、表示と更新の両方に関して定義されています。  
+  
+## 基本原則  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリをデータベースで実行するために、SQL に変換します。  その結果は、厳密に型指定された `IEnumerable` になります。  これらのオブジェクトは通常の共通言語ランタイム \(CLR: Common Language Runtime\) オブジェクトであるため、一般的なオブジェクト データ バインディングを使用して結果を表示できます。  一方、変更操作 \(挿入、更新、および削除\) には、追加的な手順が必要です。  
+  
+## 操作  
+ Windows フォーム コントロールに対する暗黙バインディングは、<xref:System.ComponentModel.IListSource> を実装することで実現されます。  データ ソース ジェネリック <xref:System.Data.Linq.Table%601> \(C\# では `Table<T>`、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] では `Table(Of T)`\) およびジェネリック `DataQuery` は更新されており、<xref:System.ComponentModel.IListSource> を実装しています。各ユーザー インターフェイス \(UI\) データ バインディング エンジン \(Windows フォームおよび Windows Presentation Foundation\) はいずれも、データ ソースが <xref:System.ComponentModel.IListSource> を実装しているかどうかをテストします。  したがって、コントロールのデータ ソースに対するクエリの直接表示を作成すると、次の例のように [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のコレクション生成が暗黙的に呼び出されます。  
+  
+ [!code-csharp[DLinqDataBinding#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqDataBinding/cs/Program.cs#1)]
+ [!code-vb[DLinqDataBinding#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqDataBinding/vb/Module1.vb#1)]  
+  
+ Windows Presentation Foundation でも同じようになります。  
+  
+ [!code-csharp[DLinqDataBinding#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqDataBinding/cs/Program.cs#2)]
+ [!code-vb[DLinqDataBinding#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqDataBinding/vb/Module1.vb#2)]  
+  
+ コレクション生成は、ジェネリック <xref:System.Data.Linq.Table%601> およびジェネリック `DataQuery` によって <xref:System.ComponentModel.IListSource.GetList%2A> で実装されます。  
+  
+## IListSource の実装  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の 2 か所で <xref:System.ComponentModel.IListSource> を実装しています。  
+  
+-   データ ソースが <xref:System.Data.Linq.Table%601> の場合 : [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はテーブルを参照し、テーブルへの参照を保持する `DataBindingList` コレクションを設定します。  
+  
+-   データ ソースが <xref:System.Linq.IQueryable%601> の場合 :   次の 2 つのシナリオがあります。  
+  
+    -   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が、基になる <xref:System.Data.Linq.Table%601> を <xref:System.Linq.IQueryable%601> から見つけた場合、ソースは編集に対応し、上の場合と同じ状況になります。  
+  
+    -   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が、基になる <xref:System.Data.Linq.Table%601> を見つけることができなかった場合、ソースは編集 \(たとえば `groupby`\) に対応していません。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、クエリを参照してジェネリック `SortableBindingList` を設定します。これは、指定したプロパティによる T エンティティの並べ替え機能を実装した単純な <xref:System.ComponentModel.BindingList%601> です。  
+  
+## 専用コレクション  
+ このドキュメントでここまでに説明した多くの機能について、<xref:System.ComponentModel.BindingList%601> を特化したクラスが用意されています。  ジェネリック `SortableBindingList` クラスと、ジェネリック `DataBindingList` クラスです。  いずれも内部クラスとして宣言されています。  
+  
+### ジェネリック SortableBindingList  
+ これは <xref:System.ComponentModel.BindingList%601> を継承したクラスで、並べ替え可能な <xref:System.ComponentModel.BindingList%601> です。  並べ替えはメモリ内で処理され、データベース自体とのやり取りは行われません。  <xref:System.ComponentModel.BindingList%601> は <xref:System.ComponentModel.IBindingList> を実装していますが、既定では並べ替えをサポートしていません。  しかし、<xref:System.ComponentModel.BindingList%601> は、仮想*コア* メソッドを持つ <xref:System.ComponentModel.IBindingList> を実装しています。  これらのメソッドを簡単にオーバーライドできます。  ジェネリック `SortableBindingList` は、<xref:System.ComponentModel.BindingList%601.SupportsSortingCore%2A>、<xref:System.ComponentModel.BindingList%601.SortPropertyCore%2A>、<xref:System.ComponentModel.BindingList%601.SortDirectionCore%2A>、および <xref:System.ComponentModel.BindingList%601.ApplySortCore%2A> をオーバーライドします。  `ApplySortCore` は <xref:System.ComponentModel.IBindingList.ApplySort%2A> によって呼び出され、指定のプロパティで T の項目のリストを並べ替えます。  
+  
+ そのプロパティが T にない場合、例外が発生します。  
+  
+ 並べ替えを行うために、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、ジェネリック <xref:System.Collections.Generic.Comparer%601.System%23Collections%23IComparer%23Compare%2A> を継承したジェネリック `SortableBindingList.PropertyComparer` クラスを作成し、指定の型 T、`PropertyDescriptor`、および方向に応じた既定の比較子を実装します。  このクラスは、T の `Comparer` を動的に作成します \(T は `PropertyDescriptor` の `PropertyType`\)。  そして、静的なジェネリック `Comparer` から既定の比較子が取得されます。  既定のインスタンスはリフレクションを使用して取得されます。  
+  
+ ジェネリック `SortableBindingList` は `DataBindingList` の基本クラスでもあります。  ジェネリック `SortableBindingList` には、項目の追加と削除の追跡を中断および再開するための 2 つの仮想メソッドがあります。  これら 2 つのメソッドは、並べ替えなどの基本機能にも使用できますが、実際にはジェネリック `DataBindingList` などの上位クラスによって実装されます。  
+  
+### ジェネリック DataBindingList  
+ このクラスは、ジェネリック `SortableBindingLIst` を継承しています。  ジェネリック `DataBindingList` は、最初にコレクションの読み込みに使用したジェネリック `IQueryable` の基になるジェネリック `Table` に対する参照を保持しています。  ジェネリック `DatabindingList` では、`InsertItem`\(\) と `RemoveItem`\(\) がオーバーライドされて、コレクションに対する項目の追加と削除を追跡する処理が追加されています。  また、追跡を中断および再開する機能の抽象メソッドが実装され、条件に応じた追跡が可能となっています。  この結果、ジェネリック `DataBindingList` では、親クラスが持つ追跡機能のポリモーフィックな使用法がすべて活用されています。  
+  
+## EntitySet へのバインディング  
+ `EntitySet` へのバインディングは特別なケースです。`EntitySet` は既に、<xref:System.ComponentModel.IBindingList> を実装したコレクションであるためです。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、並べ替えとキャンセル \(<xref:System.ComponentModel.ICancelAddNew>\) のサポートが追加されています。  `EntitySet` クラスは内部リストを使用してエンティティを格納します。  このリストは、ジェネリック配列 \(ジェネリック `ItemList` クラス\) を基にした低水準のコレクションです。  
+  
+### 並べ替え機能の追加  
+ Array には、T の `Comparer` を使用できる並べ替えメソッド \(`Array.Sort()`\) があります。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、このトピックで前に説明したジェネリック `SortableBindingList.PropertyComparer` クラスを使用して、プロパティに応じた `Comparer` と、並べ替えの方向を取得します。  ジェネリック `ItemList` には、この機能を呼び出すための `ApplySort` メソッドが追加されています。  
+  
+ `EntitySet` 側では、並べ替えのサポートを次のように宣言する必要があります。  
+  
+-   <xref:System.ComponentModel.IBindingList.SupportsSorting%2A> は、`true` を返します。  
+  
+-   <xref:System.ComponentModel.IBindingList.ApplySort%2A> では、`entities.ApplySort()` を呼び出した後で `OnListChanged()` を呼び出します。  
+  
+-   <xref:System.ComponentModel.IBindingList.SortDirection%2A> プロパティおよび <xref:System.ComponentModel.IBindingList.SortProperty%2A> プロパティでは、現在の並べ替えの定義を公開します。これはローカル メンバーに格納されています。  
+  
+ System.Windows.Forms.BindingSource を使用して EntitySet\<TEntity\> を System.Windows.Forms.BindingSource.DataSource にバインドした場合、BindingSource.List を更新するには EntitySet\<Tentity\>.GetNewBindingList を呼び出す必要があります。  
+  
+ System.Windows.Forms.BindingSource を使用して BindingSource.DataMember プロパティを設定し、BindingSource.DataMember で指定した、EntitySet\<TEntity\> を公開するプロパティを持つクラスに BindingSource.DataSource を設定した場合、BindingSource.List を更新する際に EntitySet\<Tentity\>.GetNewBindingList を呼び出す必要はありませんが、並べ替え機能が失われます。  
+  
+## キャッシュ  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリは <xref:System.ComponentModel.IListSource.GetList%2A> を実装しています。  Windows フォームの BindingSource クラスは、このインターフェイスがあると、1 つの接続に対して GetList\(\) を 3 回呼び出します。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、この状況に対処するために、格納するインスタンスごとにキャッシュを実装し、生成された同じコレクションを常に返します。  
+  
+## キャンセル  
+ <xref:System.ComponentModel.IBindingList> には <xref:System.ComponentModel.IBindingList.AddNew%2A> メソッドが定義されています。バインドされたコレクションから新しい項目を作成するためにコントロールが使用するメソッドです。  `DataGridView` コントロールでは、表示されている最後の行のヘッダーにアスタリスクが表示されている状況で、この機能が明確に示されます。  このアスタリスクは、新しい項目を追加できることを示します。  
+  
+ コレクションは、この機能に加えて、<xref:System.ComponentModel.ICancelAddNew> も実装することができます。  この機能によって、コントロールでは、キャンセルを行ったり、新しく編集された項目が検証されているかどうかを確認したりできるようになります。  
+  
+ <xref:System.ComponentModel.ICancelAddNew> は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のすべてのデータ バインド コレクション \(ジェネリック `SortableBindingList` およびジェネリック `EntitySet`\) に実装されます。どちらの実装でも、コードは次のように動作します。  
+  
+-   いったん挿入した項目をコレクションから削除できます。  
+  
+-   UI が編集をコミットしていない場合、変更を追跡しません。  
+  
+-   編集がキャンセルされた場合 \(<xref:System.ComponentModel.ICancelAddNew.CancelNew%2A>\)、変更を追跡しません。  
+  
+-   編集がコミットされた場合 \(<xref:System.ComponentModel.ICancelAddNew.EndNew%2A>\)、追跡を行うことができます。  
+  
+-   新しい項目が <xref:System.ComponentModel.IBindingList.AddNew%2A> で追加されたものでない場合、コレクションは通常どおり動作します。  
+  
+## トラブルシューティング  
+ このセクションでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のデータ バインディング アプリケーションのトラブルシューティングに役立つ可能性がある項目について説明します。  
+  
+-   プロパティを使用する必要があります。フィールドのみの使用では不十分です。  この使用は Windows フォームで必要です。  
+  
+-   既定では、`image`、`varbinary`、および `timestamp` の各データベース型は、バイト配列に対応付けられます。  このシナリオでは `ToString()` がサポートされていないため、これらのオブジェクトは表示できません。  
+  
+-   主キーに割り当てられたクラス メンバーは setter を持ちますが、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ではオブジェクト ID の変更がサポートされません。  したがって、対応付けで使用されているデータベースの主キー\/一意キーは更新できません。  グリッドを変更すると、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出したときに例外が発生します。  
+  
+-   1 つのエンティティが 2 つの別個のグリッド \(たとえばマスター グリッドと詳細グリッド\) にバインドされている場合、マスター グリッドで `Delete` を行っても、詳細グリッドには反映されません。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md b/docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md
new file mode 100644
index 00000000000..fbd14b9ff22
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md
@@ -0,0 +1,415 @@
+---
+title: "Data Retrieval and CUD Operations in N-Tier Applications (LINQ to SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c3133d53-83ed-4a4d-af8b-82edcf3831db
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Data Retrieval and CUD Operations in N-Tier Applications (LINQ to SQL)
+Customers または Orders のようなエンティティ オブジェクトをネットワークを介してクライアントにシリアル化すると、これらのエンティティはデータ コンテキストからデタッチされます。  変更内容、および他のオブジェクトとの関連付けはデータ コンテキストによって追跡されなくなります。  クライアントがデータを読み取るだけの場合は、これは問題にはなりません。  また、クライアントが新しい行をデータベースに追加できるようにすることも、ある程度簡単です。  しかし、アプリケーションでクライアントによるデータの更新または削除を可能にする必要がある場合には、<xref:System.Data.Linq.DataContext.SubmitChanges%2A?displayProperty=fullName> を呼び出す前に、新しいデータ コンテキストにエンティティをアタッチする必要があります。  さらに、元の値によるオプティミスティック同時実行制御チェックを使用する場合には、何らかの方法で、元のエンティティと変更後のエンティティをデータベースに渡す必要もあります。  エンティティがデタッチされた後に新しいデータ コンテキストにエンティティを入れるために、`Attach` メソッドが用意されています。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] エンティティの代わりにプロキシ オブジェクトをシリアル化する場合でも、データベースにデータを送るには、データ アクセス層 \(DAL\) 上にエンティティを構築して新しい <xref:System.Data.Linq.DataContext?displayProperty=fullName> にそれをアタッチする必要があります。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、エンティティがどのようにシリアル化されるかについてはまったく関与しません。  Windows Communication Foundation \(WCF\) を使ってシリアル化できるクラスを生成するために[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]および SQLMetal ツールを使用する方法について、詳しくは「[How to: Make Entities Serializable](../../../../../../docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md)」を参照してください。  
+  
+> [!NOTE]
+>  `Attach` メソッドは、新しいエンティティまたは逆シリアル化されたエンティティに対してのみ呼び出してください。  エンティティを元のデータ コンテキストからデタッチする唯一の方法は、シリアル化です。  デタッチされていないエンティティを新しいデータ コンテキストにアタッチしようとした場合、元のデータ コンテキストの遅延ローダーがそのエンティティにまだ存在するならば、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は例外をスローします。  2 つの異なるデータ コンテキストの遅延ローダーを持つエンティティに対して、挿入、更新、および削除操作を実行すると、予想外の結果が生じる可能性があります。  遅延ローダーの詳細については、「[Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)」を参照してください。  
+  
+## データの取得  
+  
+### クライアントのメソッド呼び出し  
+ Windows フォーム クライアントから DAL に対するメソッド呼び出しの例を以下に示します。  この例では、DAL は Windows サービス ライブラリとして実装されています。  
+  
+```vb  
+Private Function GetProdsByCat_Click(ByVal sender As Object, ByVal e _  
+    As EventArgs)  
+  
+    ' Create the WCF client proxy.  
+    Dim proxy As New NorthwindServiceReference.Service1Client  
+  
+    ' Call the method on the service.  
+    Dim products As NorthwindServiceReference.Product() = _  
+        proxy.GetProductsByCategory(1)  
+  
+    ' If the database uses original values for concurrency checks,  
+    ' the client needs to store them and pass them back to the  
+    ' middle tier along with the new values when updating data.  
+  
+    For Each v As NorthwindClient1.NorthwindServiceReference.Product _  
+        In products  
+        ' Persist to a List(Of Product) declared at class scope.  
+        ' Additional change-tracking logic is the responsibility  
+        ' of the presentation tier and/or middle tier.  
+        originalProducts.Add(v)  
+    Next  
+  
+    ' (Not shown) Bind the products list to a control  
+    ' and/or perform whatever processing is necessary.  
+End Function  
+```  
+  
+```csharp  
+private void GetProdsByCat_Click(object sender, EventArgs e)  
+{  
+    // Create the WCF client proxy.  
+    NorthwindServiceReference.Service1Client proxy =   
+    new NorthwindClient.NorthwindServiceReference.Service1Client();  
+  
+    // Call the method on the service.  
+    NorthwindServiceReference.Product[] products =   
+    proxy.GetProductsByCategory(1);  
+  
+    // If the database uses original values for concurrency checks,   
+    // the client needs to store them and pass them back to the   
+    // middle tier along with the new values when updating data.  
+    foreach (var v in products)  
+    {  
+        // Persist to a list<Product> declared at class scope.  
+        // Additional change-tracking logic is the responsibility  
+        // of the presentation tier and/or middle tier.  
+        originalProducts.Add(v);  
+    }  
+  
+    // (Not shown) Bind the products list to a control  
+    // and/or perform whatever processing is necessary.  
+    }  
+```  
+  
+### 中間層での実装  
+ 次の例は、中間層でのインターフェイス メソッドの実装を示しています。  ここでは、次の 2 つの点が重要です。  
+  
+-   <xref:System.Data.Linq.DataContext> はメソッドのスコープで宣言されます。  
+  
+-   メソッドは、実際の結果から成る <xref:System.Collections.IEnumerable> コレクションを返します。  シリアライザーは、結果をクライアント\/プレゼンテーション層に戻すためのクエリを実行します。  中間層でクエリ結果にローカルにアクセスするには、クエリ変数に対して `ToList` または `ToArray` を呼び出すことで、実行を強制できます。  その後、そのリストまたは配列を `IEnumerable` として返すことができます。  
+  
+```vb  
+Public Function GetProductsByCategory(ByVal categoryID As Integer) _  
+    As IEnumerable(Of Product)  
+  
+    Dim db As New NorthwindClasses1DataContext(connectionString)  
+    Dim productQuery = _  
+    From prod In db.Products _  
+    Where prod.CategoryID = categoryID _  
+    Select prod  
+  
+    Return productQuery.AsEnumerable()  
+  
+End Function  
+```  
+  
+```csharp  
+public IEnumerable<Product> GetProductsByCategory(int categoryID)  
+{  
+    NorthwindClasses1DataContext db =   
+    new NorthwindClasses1DataContext(connectionString);  
+  
+    IEnumerable<Product> productQuery =  
+    from prod in db.Products  
+    where prod.CategoryID == categoryID  
+    select prod;  
+  
+    return productQuery.AsEnumerable();   
+}  
+```  
+  
+ データ コンテキストの 1 つのインスタンスの有効期間は、1 つの「作業単位」である必要があります。疎結合環境では、通常、作業単位は小さく、たとえば `SubmitChanges` の 1 つの呼び出しを含む単一のオプティミスティック トランザクションです。  このため、データ コンテキストはメソッドのスコープ内で作成されて破棄されます。  作業単位にビジネス ルール ロジックの呼び出しが含まれる場合、通常は、その操作全体のために `DataContext` インスタンスを保持する必要が生じます。  いずれにしても、`DataContext` インスタンスの有効期間は、多数のトランザクションにわたって長い時間になることが意図されていません。  
+  
+ このメソッドは Product オブジェクトを返しますが、各 Product に関連付けられた Order\_Detail オブジェクトのコレクションを返しません。  この既定の動作を変更するには、<xref:System.Data.Linq.DataLoadOptions> オブジェクトを使用します。  詳細については、「[How to: Control How Much Related Data Is Retrieved](../../../../../../docs/framework/data/adonet/sql/linq/how-to-control-how-much-related-data-is-retrieved.md)」を参照してください。  
+  
+## データの挿入  
+ 新しいオブジェクトを挿入するために、プレゼンテーション層は単に中間層インターフェイス上の関連するメソッドを呼び出して、挿入対象の新しいオブジェクトを渡します。  ただし、クライアントがいくつかの値だけを渡して、オブジェクト全体の構築を中間層に任せた方が効率的である場合もあります。  
+  
+### 中間層での実装  
+ 中間層で、新しい <xref:System.Data.Linq.DataContext> が作成され、<xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> メソッドを使ってオブジェクトが <xref:System.Data.Linq.DataContext> にアタッチされて、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> の呼び出し時にオブジェクトが挿入されます。  他の Web サービスのシナリオとまったく同じ方法で、例外、コールバック、エラー状態を処理できます。  
+  
+```vb  
+' No call to Attach is necessary for inserts.  
+Public Sub InsertOrder(ByVal o As Order)  
+  
+    Dim db As New NorthwindClasses1DataContext(connectionString)  
+    db.Orders.InsertOnSubmit(o)  
+  
+    ' Exception handling not shown.  
+    db.SubmitChanges()  
+  
+End Sub  
+```  
+  
+```csharp  
+// No call to Attach is necessary for inserts.  
+    public void InsertOrder(Order o)  
+    {  
+        NorthwindClasses1DataContext db = new NorthwindClasses1DataContext(connectionString);  
+        db.Orders.InsertOnSubmit(o);  
+  
+        // Exception handling not shown.  
+        db.SubmitChanges();  
+    }  
+```  
+  
+## データの削除  
+ 既存のオブジェクトをデータベースから削除するために、プレゼンテーション層は中間層インターフェイス上の関連するメソッドを呼び出して、削除対象のオブジェクトの元の値を含むコピーを渡します。  
+  
+ 削除操作ではオプティミスティック同時実行制御チェックが行われて、削除対象のオブジェクトを新しいデータ コンテキストに最初にアタッチする必要があります。  この例では、オブジェクトにタイムスタンプ \(RowVersion\) が含まれないことを示すために `Boolean` パラメーターが `false` に設定されます。  各レコードのタイムスタンプがデータベース テーブルで生成される場合には、同時実行チェックは特にクライアントにとって非常に簡単です。  元のオブジェクトまたは変更後のオブジェクトを渡して、`Boolean` パラメーターを `true` に設定するだけです。  いずれの場合も、中間層では、通常、<xref:System.Data.Linq.ChangeConflictException> をキャッチする必要があります。  オプティミスティック同時実行の競合を処理する方法について、詳しくは「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+ 関連するテーブルに対する外部キー制約を含むエンティティを削除する際には、<xref:System.Data.Linq.EntitySet%601> コレクション内のすべてのオブジェクトを最初に削除する必要があります。  
+  
+```vb  
+' Attach is necessary for deletes.  
+Public Sub DeleteOrder(ByVal order As Order)  
+    Dim db As New NorthwindClasses1DataContext(connectionString)  
+  
+    db.Orders.Attach(order, False)  
+    ' This will throw an exception if the order has order details.  
+    db.Orders.DeleteOnSubmit(order)  
+  
+    Try  
+        ' ConflictMode is an optional parameter.  
+        db.SubmitChanges(ConflictMode.ContinueOnConflict)  
+  
+    Catch ex As ChangeConflictException  
+        ' Get conflict information, and take actions  
+        ' that are appropriate for your application.  
+        ' See MSDN Article "How to: Manage Change  
+        ' Conflicts (LINQ to SQL).  
+  
+    End Try  
+End Sub  
+```  
+  
+```csharp  
+// Attach is necessary for deletes.  
+public void DeleteOrder(Order order)  
+{  
+    NorthwindClasses1DataContext db = new NorthwindClasses1DataContext(connectionString);  
+  
+    db.Orders.Attach(order, false);  
+    // This will throw an exception if the order has order details.  
+    db.Orders.DeleteOnSubmit(order);  
+    try  
+    {  
+        // ConflictMode is an optional parameter.  
+        db.SubmitChanges(ConflictMode.ContinueOnConflict);  
+    }  
+    catch (ChangeConflictException e)  
+    {  
+       // Get conflict information, and take actions  
+       // that are appropriate for your application.  
+       // See MSDN Article How to: Manage Change Conflicts (LINQ to SQL).  
+    }  
+}  
+```  
+  
+## データの更新  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オプティミスティック同時実行制御を行う次のようなシナリオでの更新をサポートします。  
+  
+-   タイムスタンプつまり RowVersion 番号に基づくオプティミスティック同時実行制御。  
+  
+-   エンティティ プロパティのサブセットの元の値に基づくオプティミスティック同時実行制御。  
+  
+-   元のエンティティ全体および変更後のエンティティ全体に基づくオプティミスティック同時実行制御。  
+  
+ また、エンティティとそのリレーションシップの両方に対して更新または削除を実行することもできます \(たとえば Customer と、それに関連した Order オブジェクトのコレクション\)。  エンティティ オブジェクトとその子 \(`EntitySet`\) コレクションから成るグラフをクライアント上で変更して、オプティミスティック同時実行制御チェックで元の値が必要とされる場合には、クライアントはそれぞれのエンティティと <xref:System.Data.Linq.EntitySet%601> オブジェクトの元の値を提供する必要があります。  1 つのメソッド呼び出しで互いに関連する更新、削除、挿入のセットをクライアントが実行できるようにするには、各エンティティにどんな操作を実行するかを示す方法をクライアントに提供する必要があります。  その後、中間層で適切な <xref:System.Data.Linq.ITable.Attach%2A> メソッドを呼び出した後、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出す前に、各エンティティに対して <xref:System.Data.Linq.ITable.InsertOnSubmit%2A>, <xref:System.Data.Linq.ITable.DeleteAllOnSubmit%2A> または <xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> \(挿入の場合は `Attach` 無し\) を呼び出す必要があります。  更新を試行する前に元の値を入手するためにデータベースからデータを取得しないでください。  
+  
+ オプティミスティック同時実行制御の詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  オプティミスティック同時実行の変更の競合を解決する方法について、詳しくは「[How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)」を参照してください。  
+  
+ それぞれのシナリオの例を以下に示します。  
+  
+### タイムスタンプを使用したオプティミスティック同時実行  
+  
+```vb  
+' Assume that "customer" has been sent by client.  
+' Attach with "true" to say this is a modified entity  
+' and it can be checked for optimistic concurrency  
+' because it has a column that is marked with the  
+' "RowVersion" attribute.  
+  
+db.Customers.Attach(customer, True)  
+  
+Try  
+    ' Optional: Specify a ConflictMode value  
+    ' in call to SubmitChanges.  
+    db.SubmitChanges()  
+Catch ex As ChangeConflictException  
+    ' Handle conflict based on options provided.  
+    ' See MSDN article "How to: Manage Change  
+    ' Conflicts (LINQ to SQL)".  
+End Try  
+```  
+  
+```csharp  
+// Assume that "customer" has been sent by client.  
+// Attach with "true" to say this is a modified entity  
+// and it can be checked for optimistic concurrency because  
+//  it has a column that is marked with "RowVersion" attribute  
+db.Customers.Attach(customer, true)  
+try  
+{  
+    // Optional: Specify a ConflictMode value  
+    // in call to SubmitChanges.  
+    db.SubmitChanges();  
+}  
+catch(ChangeConflictException e)  
+{  
+    // Handle conflict based on options provided  
+    // See MSDN article How to: Manage Change Conflicts (LINQ to SQL).  
+}  
+```  
+  
+### 元の値のサブセットを使用した場合  
+ この手法では、クライアントは変更対象の値と共に、シリアル化されたオブジェクト全体を返します。  
+  
+```vb  
+Public Sub UpdateProductInventory(ByVal p As Product, ByVal _  
+    unitsInStock As Short?, ByVal unitsOnOrder As Short?)  
+  
+    Using db As New NorthwindClasses1DataContext(connectionString)  
+        ' p is the original unmodified product  
+        ' that was obtained from the database.  
+        ' The client kept a copy and returns it now.  
+        db.Products.Attach(p, False)  
+  
+        ' Now that the original values are in the data context,  
+        ' apply the changes.  
+        p.UnitsInStock = unitsInStock  
+        p.UnitsOnOrder = unitsOnOrder  
+  
+        Try  
+            ' Optional: Specify a ConflictMode value  
+            ' in call to SubmitChanges.  
+            db.SubmitChanges()  
+  
+        Catch ex As Exception  
+            ' Handle conflict based on options provided.  
+            ' See MSDN article "How to: Manage Change Conflicts  
+            ' (LINQ to SQL)".  
+        End Try  
+    End Using  
+End Sub  
+```  
+  
+```csharp  
+public void UpdateProductInventory(Product p, short? unitsInStock, short? unitsOnOrder)  
+{  
+    using (NorthwindClasses1DataContext db = new NorthwindClasses1DataContext(connectionString))  
+    {  
+        // p is the original unmodified product  
+        // that was obtained from the database.  
+        // The client kept a copy and returns it now.  
+        db.Products.Attach(p, false);  
+  
+        // Now that the original values are in the data context, apply the changes.  
+        p.UnitsInStock = unitsInStock;  
+        p.UnitsOnOrder = unitsOnOrder;  
+        try  
+        {  
+             // Optional: Specify a ConflictMode value  
+             // in call to SubmitChanges.  
+             db.SubmitChanges();  
+        }  
+        catch (ChangeConflictException e)  
+        {  
+            // Handle conflict based on provided options.  
+            // See MSDN article How to: Manage Change Conflicts  
+            // (LINQ to SQL).  
+        }  
+    }  
+}  
+```  
+  
+### エンティティ全体を使用する場合  
+  
+```vb  
+Public Sub UpdateProductInfo(ByVal newProd As Product, ByVal _  
+    originalProd As Product)  
+  
+    Using db As New NorthwindClasses1DataContext(connectionString)  
+        db.Products.Attach(newProd, originalProd)  
+  
+        Try  
+            ' Optional: Specify a ConflictMode value  
+            ' in call to SubmitChanges.  
+            db.SubmitChanges()  
+  
+        Catch ex As Exception  
+            ' Handle potential change conflicgt in whatever way  
+            ' is appropriate for your application.  
+            ' For more information, see the MSDN article  
+            ' "How to: Manage Change Conflicts (LINQ to  
+            ' SQL)".  
+        End Try  
+  
+    End Using  
+End Sub  
+```  
+  
+```csharp  
+public void UpdateProductInfo(Product newProd, Product originalProd)  
+{  
+     using (NorthwindClasses1DataContext db = new  
+        NorthwindClasses1DataContext(connectionString))  
+     {  
+         db.Products.Attach(newProd, originalProd);  
+         try  
+         {  
+               // Optional: Specify a ConflictMode value  
+               // in call to SubmitChanges.  
+               db.SubmitChanges();  
+         }  
+        catch (ChangeConflictException e)  
+        {  
+            // Handle potential change conflict in whatever way  
+            // is appropriate for your application.  
+            // For more information, see the MSDN article  
+            // How to: Manage Change Conflicts (LINQ to SQL)/  
+        }   
+    }  
+}  
+```  
+  
+ コレクションを更新するには、`Attach` ではなく <xref:System.Data.Linq.ITable.AttachAll%2A> を呼び出します。  
+  
+### 必要なエンティティ メンバー  
+ 既に説明したように、`Attach` メソッドを呼び出す前に設定する必要があるのは、エンティティ オブジェクトのいくつかのメンバーだけです。  設定する必要のあるエンティティ メンバーは、次の条件を満たす必要があります。  
+  
+-   エンティティの ID の一部分である。  
+  
+-   変更される予定である。  
+  
+-   タイムスタンプであるか、<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> 属性が `Never` 以外の値に設定されている。  
+  
+ テーブルでオプティミスティック同時実行チェック用にタイムスタンプまたはバージョン番号を使用している場合は、<xref:System.Data.Linq.ITable.Attach%2A> を呼び出す前にこれらのメンバーを設定する必要があります。  Column 属性の <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> プロパティが true に設定されている場合、メンバーはオプティミスティック同時実行チェック専用です。  要求された更新は、データベース上のバージョン番号またはタイムスタンプ値が同じ場合にのみ、送信されます。  
+  
+ また、<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> が `Never` に設定されていないメンバーもまた、オプティミスティック同時実行チェックに使用されます。  他の値が指定されない場合、既定値は `Always` です。  
+  
+ これらの必要なメンバーのいずれかが欠落している場合、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> 中に <xref:System.Data.Linq.ChangeConflictException> \("行が見つからないか変更されています"\) がスローされます。  
+  
+### 状態  
+ エンティティ オブジェクトが <xref:System.Data.Linq.DataContext> インスタンスにアタッチされた後、そのオブジェクトは `PossiblyModified` 状態にあると見なされます。  アタッチされたオブジェクトを強制的に `Modified` 状態にする方法は、3 つあります。  
+  
+1.  未変更としてアタッチした後、フィールドを直接変更する。  
+  
+2.  現在のオブジェクト インスタンスと元のオブジェクト インスタンスを受け入れる <xref:System.Data.Linq.Table%601.Attach%2A> オーバーロードを使ってアタッチする。  こうすると、古い値と新しい値が変更トラッカーに提供されるため、変更されたフィールドが自動的に判別されます。  
+  
+3.  \(true に設定された\) 2 番目のブール値パラメーターを受け入れる <xref:System.Data.Linq.Table%601.Attach%2A> オーバーロードを使ってアタッチする。  こうすると、元の値を提供しなくても、変更トラッカーはオブジェクトが変更済みと見なします。  この手法では、オブジェクトにバージョン\/タイムスタンプ フィールドが含まれる必要があります。  
+  
+ 詳細については、「[Object States and Change\-Tracking](../../../../../../docs/framework/data/adonet/sql/linq/object-states-and-change-tracking.md)」を参照してください。  
+  
+ アタッチ対象のオブジェクトと同じ ID を持つエンティティ オブジェクトが ID キャッシュ内に既に存在する場合、<xref:System.Data.Linq.DuplicateKeyException> がスローされます。  
+  
+ オブジェクトの `IEnumerable` セットを使ってアタッチするとき、既存のキーが含まれる場合には、<xref:System.Data.Linq.DuplicateKeyException> がスローされます。  残りのオブジェクトはアタッチされません。  
+  
+## 参照  
+ [N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)   
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/data-types-and-functions.md b/docs/framework/data/adonet/sql/linq/data-types-and-functions.md
new file mode 100644
index 00000000000..cce11d3b7fa
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/data-types-and-functions.md
@@ -0,0 +1,44 @@
+---
+title: "Data Types and Functions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 683413c5-0312-4e60-8619-9a97bdc6e62a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Data Types and Functions
+次の表の各トピックでは、共通言語ランタイム \(CLR\) のメンバー、コンストラクト、およびキャストに対する LINQ to SQL でのサポートについて説明します。  サポートされているメンバーおよびコンストラクトは、LINQ to SQL クエリで使用できます。  
+  
+ この表でサポートされていないアイテムは、LINQ to SQL では、SQL Server で実行するために CLR のメンバー、コンストラクト、またはキャストを変換できないことを意味します。  それらをコード内で使用することはできる場合もありますが、クエリが Transact\-SQL に変換される前、またはデータベースから結果が取得された後に評価する必要があります。  
+  
+|トピック|説明|  
+|----------|--------|  
+|[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)|CLR 型と SQL Server 型のマッピングを、行列形式で示します。|  
+|[Basic Data Types](../../../../../../docs/framework/data/adonet/sql/linq/basic-data-types.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[Boolean Data Types](../../../../../../docs/framework/data/adonet/sql/linq/boolean-data-types.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[null セマンティクス](../../../../../../docs/framework/data/adonet/sql/linq/null-semantics.md)|null および null 許容に関する問題が記載されている [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] トピックへのリンクを示します。|  
+|[Numeric and Comparison Operators](../../../../../../docs/framework/data/adonet/sql/linq/numeric-and-comparison-operators.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[Sequence Operators](../../../../../../docs/framework/data/adonet/sql/linq/sequence-operators.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[System.Convert Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-convert-methods.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[System.DateTime Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-datetime-methods.md)|<xref:System.DateTime?displayProperty=fullName> 構造体のメンバーに対する LINQ to SQL でのサポートについて説明します。|  
+|[System.DateTimeOffset Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-datetimeoffset-methods.md)|<xref:System.DateTimeOffset?displayProperty=fullName> 構造体のメンバーに対する LINQ to SQL でのサポートについて説明します。|  
+|[System.Math Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-math-methods.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[System.Object Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-object-methods.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[System.String Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-string-methods.md)|[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] との相違の概要を示します。|  
+|[System.TimeSpan Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-timespan-methods.md)|<xref:System.TimeSpan?displayProperty=fullName> 構造体のメンバーに対する LINQ to SQL でのサポートについて説明します。|  
+|[Unsupported Functionality](../../../../../../docs/framework/data/adonet/sql/linq/unsupported-functionality.md)|[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] でサポートされていない機能について説明します。|  
+  
+## 参照  
+ [SQL\-CLR Type Mismatches](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md)   
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)   
+ [.NET Framework Class Library in Visual Studio](http://msdn.microsoft.com/ja-jp/a03e374c-3d5c-4169-937b-49857ab273ae)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/debugging-support.md b/docs/framework/data/adonet/sql/linq/debugging-support.md
new file mode 100644
index 00000000000..2628f6250dd
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/debugging-support.md
@@ -0,0 +1,38 @@
+---
+title: "Debugging Support | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 262d8e60-8e71-42d7-8340-1b5276a0ad35
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Debugging Support
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトのデバッグを全般的にサポートします。 さらに、「[LINQ のデバッグ](http://msdn.microsoft.com/library/Bb385795\(v=vs.110\))」または「[LINQ のデバッグ](http://msdn.microsoft.com/library/Bb385795\(v=vs.120\))」も参照してください。  
+  
+ また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は SQL コードを表示する特別なツールも備えています。  詳細については、このセクションの各トピックを参照してください。  
+  
+## このセクションの内容  
+ [How to: Display Generated SQL](../../../../../../docs/framework/data/adonet/sql/linq/how-to-display-generated-sql.md)  
+ <xref:System.Data.Linq.DataContext> プロパティを使用してクエリの動作を表示する方法について説明します。  
+  
+ [How to: Display a ChangeSet](../../../../../../docs/framework/data/adonet/sql/linq/how-to-display-a-changeset.md)  
+ データベースに送信された変更内容を表示する方法について説明します。  
+  
+ [How to: Display LINQ to SQL Commands](../../../../../../docs/framework/data/adonet/sql/linq/how-to-display-linq-to-sql-commands.md)  
+ SQL コマンドとその他の情報を表示する方法について説明します。  
+  
+ [Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)  
+ 原因の特定が難しい一般的なシナリオについて説明します。  
+  
+## 参照  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md b/docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md
new file mode 100644
index 00000000000..93bb03a8c4e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md
@@ -0,0 +1,41 @@
+---
+title: "Deferred versus Immediate Loading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d1d7247f-a3b7-460b-b342-5c1a2365aa1a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Deferred versus Immediate Loading
+オブジェクトに対してクエリを実行すると、要求したオブジェクトだけが実際に取得されます。  *関連*オブジェクトが自動で同時に取得されることはありません。  \(詳細については、「[Querying Across Relationships](../../../../../../docs/framework/data/adonet/sql/linq/querying-across-relationships.md)」を参照してください\)。ただし、関連オブジェクトにアクセスしようとすると、それらを取得する要求が生成されるため、関連オブジェクトがまだ読み込まれていない状態を識別することはできません。  
+  
+ たとえば、特定の注文のセットを取得するクエリを実行し、ときおり特定の顧客に電子メール通知を送信しようとしているとします。  最初から注文ごとにすべての顧客データを取得する必要はありません。  遅延読み込みを使用すると、関連情報が実際に必要になるまで、その情報の取得を遅らせることができます。  次に例を示します。  
+  
+ [!code-csharp[DLinqQueryConcepts#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#1)]
+ [!code-vb[DLinqQueryConcepts#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#1)]  
+  
+ その反対も同様です。  顧客データと注文データを同時に表示する必要のあるアプリケーションがあるとします。  両方のデータが必要であることがわかっています。  このアプリケーションでは、結果を取得するのと同時に、各顧客の注文情報が必要になります。  すべての顧客について注文を照会する個別のクエリを発行するのは適切ではありません。  ここで必要なのは、注文データと顧客データを同時に収集することです。  
+  
+ [!code-csharp[DLinqQueryConcepts#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#2)]
+ [!code-vb[DLinqQueryConcepts#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#2)]  
+  
+ 1 つのクエリでクロス積によって顧客データと注文データを結合し、すべての関連データを大きな 1 つの投影として取得することもできます。  ただし、このような結果はエンティティではありません   \(詳細については、「[The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)」を参照してください\)。  エンティティとは、識別子を持ち、変更が可能なオブジェクトですが、これらの結果は投影であり、変更や永続化はできません。  さらに、平坦な結合出力では、注文ごとに各顧客が繰り返し現れるため、余分なデータが大量に取得されることになります。  
+  
+ ここで必要なのは、関連オブジェクトのセットを同時に取得することです。  このセットは、目的の用途に必要十分なデータだけを取得できるように、グラフ上に線引きされた区画に相当します。  この目的から、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、オブジェクト モデルの特定の領域の即時読み込みを行う <xref:System.Data.Linq.DataLoadOptions> が用意されています。  次のメソッドがあります。  
+  
+-   <xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> メソッド。メイン ターゲットに関連するデータを即時に読み込みます。  
+  
+-   <xref:System.Data.Linq.DataLoadOptions.AssociateWith%2A> メソッド。特定のリレーションシップに対して取得されるオブジェクトにフィルターを適用します。  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/determine-if-any-or-all-elements-in-a-sequence-satisfy-a-condition.md b/docs/framework/data/adonet/sql/linq/determine-if-any-or-all-elements-in-a-sequence-satisfy-a-condition.md
new file mode 100644
index 00000000000..f6ca5177a3d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/determine-if-any-or-all-elements-in-a-sequence-satisfy-a-condition.md
@@ -0,0 +1,41 @@
+---
+title: "Determine if Any or All Elements in a Sequence Satisfy a Condition | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 339ec145-826c-46d2-8cf2-3acd252cd072
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Determine if Any or All Elements in a Sequence Satisfy a Condition
+<xref:System.Linq.Enumerable.All%2A> 演算子は、シーケンスのすべての要素が条件を満たす場合に `true` を返します。  
+  
+ <xref:System.Linq.Queryable.Any%2A> 演算子は、シーケンスの要素が 1 つでも条件を満たす場合に `true` を返します。  
+  
+## 使用例  
+ 次の例では、最低 1 件の注文がある顧客のシーケンスを返します。  `Where`\/`where` 句は、指定された `Customer` に `Order` がある場合に `true` に評価されます。  
+  
+ [!code-csharp[DLinqQueryExamples#37](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#37)]
+ [!code-vb[DLinqQueryExamples#37](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#37)]  
+  
+## 使用例  
+ 次の Visual Basic コードでは、注文がない顧客のリストを調べ、リストに記載されている顧客に連絡先名があることを確認します。  
+  
+ [!code-vb[DLinqQueryExamples#37v](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#37v)]  
+  
+## 使用例  
+ 次の C\# コードでは、注文の `ShipCity` が "C" で始まる顧客のシーケンスを返します。  注文のない顧客も結果に含まれます。  \(<xref:System.Linq.Queryable.All%2A> 演算子はシーケンスが空の場合に `true` を返すように設計されています\)。注文のない顧客を削除してコンソールに出力するには、`Count` 演算子を使用します。  
+  
+ [!code-csharp[DLinqQueryExamples#38](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#38)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/downloading-sample-databases.md b/docs/framework/data/adonet/sql/linq/downloading-sample-databases.md
new file mode 100644
index 00000000000..48d37736e52
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/downloading-sample-databases.md
@@ -0,0 +1,63 @@
+---
+title: "Downloading Sample Databases | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef9d69a1-9461-43fe-94bb-7c836754bcb5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Downloading Sample Databases
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のドキュメントに収録されている多数のサンプルとチュートリアルでは、Northwind サンプル データベースと SQL Server Express Edition が使用されています。  これらの製品は、Microsoft のダウンロード サイトから無料でダウンロードできます。  
+  
+## Northwind データベースのダウンロード  
+  
+#### SQL Server 用の Northwind サンプル データベースをダウンロードしてインストールするには  
+  
+1.  Internet Explorer を開始します。  
+  
+2.  [Northwind および Pubs サンプル データベース](http://go.microsoft.com/fwlink?linkid=64296)の Web サイトにアクセスします。  
+  
+3.  **\[ダウンロード\]** をクリックします。  
+  
+4.  **\[ファイルのダウンロード\]** ダイアログ ボックスで、**\[保存\]** をクリックします。  
+  
+5.  ファイルのダウンロード後に、**Nwind.exe** ファイルをダブルクリックし、データベースをインストールします。  
+  
+     既定では、このデータベースは *drive*:\\SQL Server 2000 Sample Databases にインストールされます。  
+  
+## SQL Server Express Edition のダウンロード  
+ SQL Server Express Edition は無料で入手でき、アプリケーションと共に再配布できます。  [!INCLUDE[vsprvs](../../../../../../includes/vsprvs-md.md)] を使用している場合は、Pro 以上のエディションに SQL Server Express Edition が含まれています。  
+  
+#### SQL Server Express Edition をダウンロードおよびインストールするには  
+  
+1.  Internet Explorer を開始します。  
+  
+2.  [Microsoft ダウンロード センター](http://go.microsoft.com/fwlink?linkid=74602)のWeb サイトにアクセスします。  
+  
+3.  キーワード ボックスに「SQL Server Express」と入力します。  
+  
+4.  **\[検索\]** をクリックします。  
+  
+5.  結果のページで、**Microsoft SQL Server 2005 Express Edition** のダウンロード ページへのリンクをクリックします。  
+  
+6.  Web サイトに記載されているインストールの指示に従います。  
+  
+## Management Studio Express のダウンロード  
+ ダウンロードしたデータベースを変更する場合は、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] 統合開発環境 \(IDE: Integrated Development Environment\) の**サーバー エクスプローラー**からデータベースにアクセスできますが、Microsoft SQL Server Management Studio Express \(SSMSE\) を使用することもできます。  
+  
+#### Management Studio Express をダウンロードするには  
+  
+-   [SSMSE サイト](http://go.microsoft.com/fwlink/?LinkId=95933)に記載されている手順に従います。  
+  
+## 参照  
+ [Getting Started](../../../../../../docs/framework/data/adonet/sql/linq/getting-started.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/eliminate-duplicate-elements-from-a-sequence.md b/docs/framework/data/adonet/sql/linq/eliminate-duplicate-elements-from-a-sequence.md
new file mode 100644
index 00000000000..a05e25bf62d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/eliminate-duplicate-elements-from-a-sequence.md
@@ -0,0 +1,29 @@
+---
+title: "Eliminate Duplicate Elements from a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b224a84-bad5-4843-adcc-14e784d280f5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Eliminate Duplicate Elements from a Sequence
+重複する要素をシーケンスから削除するには、<xref:System.Linq.Queryable.Distinct%2A> 演算子を使用します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Linq.Queryable.Distinct%2A> を使用して、顧客の住所がある市のシーケンスを選択します。それぞれの市はシーケンス内で重複しません。  
+  
+ [!code-csharp[DLinqQueryExamples#36](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#36)]
+ [!code-vb[DLinqQueryExamples#36](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#36)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/external-mapping.md b/docs/framework/data/adonet/sql/linq/external-mapping.md
new file mode 100644
index 00000000000..3b21e5f5087
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/external-mapping.md
@@ -0,0 +1,154 @@
+---
+title: "External Mapping | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 076606b8-d889-4ba0-b5da-ae577b146f23
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# External Mapping
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は*外部マッピング*をサポートします。これは、別個の XML ファイルを使用して、データベースのデータ モデルとオブジェクト モデルの間のマッピングを指定するプロセスです。  外部マッピング ファイルを使用すると、次のような利点があります。  
+  
+-   マッピング コードをアプリケーション コードから分離できます。  この方法により、アプリケーション コードの煩雑さが軽減されます。  
+  
+-   外部マッピング ファイルは、構成ファイルのような方法で扱うことができます。  たとえば、バイナリを配布した後、外部マッピング ファイルを交換するだけでアプリケーションの動作を更新できます。  
+  
+## 要件  
+ マッピング ファイルは XML ファイルである必要があります。また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] スキーマ定義 \(.xsd\) ファイルに対して検証される必要があります。  
+  
+ 次の規則が適用されます。  
+  
+-   マッピング ファイルは XML ファイルである必要があります。  
+  
+-   XML マッピング ファイルは、XML スキーマ定義ファイルに対して有効である必要があります。  詳細については、「[How to: Validate DBML and External Mapping Files](../../../../../../docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md)」を参照してください。  
+  
+-   外部マッピングは、属性ベースのマッピングをオーバーライドします。  言い換えると、外部マッピング ソースを使って <xref:System.Data.Linq.DataContext> を作成した場合、<xref:System.Data.Linq.DataContext> はクラスに作成したすべてのマッピング属性を無視します。  この動作は、クラスが外部マッピング ファイルに含まれるかどうかにかかわらず適用されます。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、2 つのマッピング方法 \(属性ベースと外部\) を組み合わせて使用することはできません。  
+  
+## XML スキーマ定義ファイル  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の外部マッピングは、以下のような XML スキーマ定義に対して有効である必要があります。  
+  
+ このスキーマ定義ファイルを、DBML ファイルの検証に使われるスキーマ定義ファイルと区別してください。  詳細については、「[Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)」を参照してください。  
+  
+> [!NOTE]
+>  また、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ユーザーには、この XSD ファイルが \[XML スキーマ\] ダイアログ ボックスで「LinqToSqlMapping.xsd」として表示されます。  外部マッピング ファイルを検証するためにこのファイルを正しく使用する方法については、「[How to: Validate DBML and External Mapping Files](../../../../../../docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md)」を参照してください。  
+  
+```  
+?<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://schemas.microsoft.com/linqtosql/mapping/2007" xmlns="http://schemas.microsoft.com/linqtosql/mapping/2007"  
+elementFormDefault="qualified" >  
+  <xs:element name="Database" type="Database" />  
+  <xs:complexType name="Database">  
+    <xs:sequence>  
+      <xs:element name="Table" type="Table" minOccurs="0" maxOccurs="unbounded" />  
+      <xs:element name="Function" type="Function" minOccurs="0" maxOccurs="unbounded" />  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Provider" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Table">  
+    <xs:sequence>  
+      <xs:element name="Type" type="Type" minOccurs="1" maxOccurs="1" />  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Member" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Type">  
+    <xs:sequence>  
+      <xs:choice minOccurs="0" maxOccurs="unbounded">  
+        <xs:element name="Column" type="Column" minOccurs="0" maxOccurs="unbounded" />  
+        <xs:element name="Association" type="Association" minOccurs="0" maxOccurs="unbounded" />  
+      </xs:choice>  
+      <xs:element name="Type" type="Type" minOccurs="0" maxOccurs="unbounded" />  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="required" />  
+    <xs:attribute name="InheritanceCode" type="xs:string" use="optional" />  
+    <xs:attribute name="IsInheritanceDefault" type="xs:boolean" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Column">  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Member" type="xs:string" use="required" />  
+    <xs:attribute name="Storage" type="xs:string" use="optional" />  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+    <xs:attribute name="IsPrimaryKey" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsDbGenerated" type="xs:boolean" use="optional" />  
+    <xs:attribute name="CanBeNull" type="xs:boolean" use="optional" />  
+    <xs:attribute name="UpdateCheck" type="UpdateCheck" use="optional" />  
+    <xs:attribute name="IsDiscriminator" type="xs:boolean" use="optional" />  
+    <xs:attribute name="Expression" type="xs:string" use="optional" />  
+    <xs:attribute name="IsVersion" type="xs:boolean" use="optional" />  
+    <xs:attribute name="AutoSync" type="AutoSync" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Association">  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Member" type="xs:string" use="required" />  
+    <xs:attribute name="Storage" type="xs:string" use="optional" />  
+    <xs:attribute name="ThisKey" type="xs:string" use="optional" />  
+    <xs:attribute name="OtherKey" type="xs:string" use="optional" />  
+    <xs:attribute name="IsForeignKey" type="xs:boolean" use="optional" />  
+    <xs:attribute name="IsUnique" type="xs:boolean" use="optional" />  
+    <xs:attribute name="DeleteRule" type="xs:string" use="optional" />  
+    <xs:attribute name="DeleteOnNull" type="xs:boolean" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Function">  
+    <xs:sequence>  
+      <xs:element name="Parameter" type="Parameter" minOccurs="0" maxOccurs="unbounded" />  
+      <xs:choice>  
+        <xs:element name="ElementType" type="Type" minOccurs="0" maxOccurs="unbounded" />  
+        <xs:element name="Return" type="Return" minOccurs="0" maxOccurs="1" />  
+      </xs:choice>  
+    </xs:sequence>  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Method" type="xs:string" use="required" />  
+    <xs:attribute name="IsComposable" type="xs:boolean" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Parameter">  
+    <xs:attribute name="Name" type="xs:string" use="optional" />  
+    <xs:attribute name="Parameter" type="xs:string" use="required" />  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+    <xs:attribute name="Direction" type="ParameterDirection" use="optional" />  
+  </xs:complexType>  
+  <xs:complexType name="Return">  
+    <xs:attribute name="DbType" type="xs:string" use="optional" />  
+  </xs:complexType>  
+  <xs:simpleType name="UpdateCheck">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Always" />  
+      <xs:enumeration value="Never" />  
+      <xs:enumeration value="WhenChanged" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="ParameterDirection">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="In" />  
+      <xs:enumeration value="Out" />  
+      <xs:enumeration value="InOut" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="AutoSync">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="Never" />  
+      <xs:enumeration value="OnInsert" />  
+      <xs:enumeration value="OnUpdate" />  
+      <xs:enumeration value="Always" />  
+      <xs:enumeration value="Default" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+```  
+  
+## 参照  
+ [Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)   
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)   
+ [How to: Generate the Object Model as an External File](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/find-the-maximum-value-in-a-numeric-sequence.md b/docs/framework/data/adonet/sql/linq/find-the-maximum-value-in-a-numeric-sequence.md
new file mode 100644
index 00000000000..fce999dce25
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/find-the-maximum-value-in-a-numeric-sequence.md
@@ -0,0 +1,80 @@
+---
+title: "Find the Maximum Value in a Numeric Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70d7c058-0280-4815-a008-6f290093591a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Find the Maximum Value in a Numeric Sequence
+一連の数値の中の最大値を見つけるには、<xref:System.Linq.Enumerable.Max%2A> 演算子を使用します。  
+  
+## 使用例  
+ 次の例では、従業員の最新の入社日を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`11/15/1994 12:00:00 AM` です。  
+  
+ [!code-csharp[DLinqQueryExamples#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#6)]
+ [!code-vb[DLinqQueryExamples#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#6)]  
+  
+## 使用例  
+ 次の例では、製品の最大在庫数を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`125` です。  
+  
+ [!code-csharp[DLinqQueryExamples#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#7)]
+ [!code-vb[DLinqQueryExamples#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#7)]  
+  
+## 使用例  
+ 次の例では、Max を使用して、各カテゴリ内で単価が最も高い `Products` を見つけます。  出力では、カテゴリごとに結果の一覧が示されます。  
+  
+ [!code-csharp[DLinqQueryExamples#8](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#8)]
+ [!code-vb[DLinqQueryExamples#8](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#8)]  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、結果は次のようになります。  
+  
+ `1`  
+  
+ `Côte de Blaye`  
+  
+ `2`  
+  
+ `Vegie-spread`  
+  
+ `3`  
+  
+ `Sir Rodney's Marmalade`  
+  
+ `4`  
+  
+ `Raclette Courdavault`  
+  
+ `5`  
+  
+ `Gnocchi di nonna Alice`  
+  
+ `6`  
+  
+ `Thüringer Rostbratwurst`  
+  
+ `7`  
+  
+ `Manjimup Dried Apples`  
+  
+ `8`  
+  
+ `Carnarvon Tigers`  
+  
+## 参照  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/find-the-minimum-value-in-a-numeric-sequence.md b/docs/framework/data/adonet/sql/linq/find-the-minimum-value-in-a-numeric-sequence.md
new file mode 100644
index 00000000000..0cd2babda5c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/find-the-minimum-value-in-a-numeric-sequence.md
@@ -0,0 +1,80 @@
+---
+title: "Find the Minimum Value in a Numeric Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78203093-f242-4572-9b31-9495b10926aa
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Find the Minimum Value in a Numeric Sequence
+一連の数値の中から最小値を返すには、<xref:System.Linq.Enumerable.Min%2A> 演算子を使用します。  
+  
+## 使用例  
+ 次の例では、製品の最低単価を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`2.5000` です。  
+  
+ [!code-csharp[DLinqQueryExamples#9](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#9)]
+ [!code-vb[DLinqQueryExamples#9](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#9)]  
+  
+## 使用例  
+ 次の例では、注文の最低配送料を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行した場合の出力は、`0.0200` です。  
+  
+ [!code-csharp[DLinqQueryExamples#10](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#10)]
+ [!code-vb[DLinqQueryExamples#10](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#10)]  
+  
+## 使用例  
+ 次の例では、Min を使用して、各カテゴリ内で単価が最も安い `Products` を見つけます。  出力はカテゴリごとに行われます。  
+  
+ [!code-csharp[DLinqQueryExamples#11](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#11)]
+ [!code-vb[DLinqQueryExamples#11](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#11)]  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、結果は次のようになります。  
+  
+ `1`  
+  
+ `Guaraná Fantástica`  
+  
+ `2`  
+  
+ `Aniseed Syrup`  
+  
+ `3`  
+  
+ `Teatime Chocolate Biscuits`  
+  
+ `4`  
+  
+ `Geitost`  
+  
+ `5`  
+  
+ `Filo Mix`  
+  
+ `6`  
+  
+ `Tourtière`  
+  
+ `7`  
+  
+ `Longlife Tofu`  
+  
+ `8`  
+  
+ `Konbu`  
+  
+## 参照  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/formulate-joins-and-cross-product-queries.md b/docs/framework/data/adonet/sql/linq/formulate-joins-and-cross-product-queries.md
new file mode 100644
index 00000000000..665404fd673
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/formulate-joins-and-cross-product-queries.md
@@ -0,0 +1,87 @@
+---
+title: "Formulate Joins and Cross-Product Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8072ede-0521-4670-9bec-1778ceeb875b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Formulate Joins and Cross-Product Queries
+次の例は、複数のテーブルからの結果を組み合わせる方法を示しています。  
+  
+## 使用例  
+ 次の例は、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `From` 句 \(C\# の `from` 句\) で外部キー ナビゲーションを使用して、ロンドンの顧客の注文をすべて選択します。  
+  
+ [!code-csharp[DLinqQueryExamples#47](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#47)]
+ [!code-vb[DLinqQueryExamples#47](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#47)]  
+  
+## 使用例  
+ 次の例は、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Where` 句 \(C\# の `where` 句\) で外部キー ナビゲーションを使用して、`Supplier` が米国にあり、在庫切れになっている `Products` をフィルター処理します。  
+  
+ [!code-csharp[DLinqQueryExamples#48](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#48)]
+ [!code-vb[DLinqQueryExamples#48](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#48)]  
+  
+## 使用例  
+ 次の例は、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `From` 句 \(C\# の `from` 句\) で外部キー ナビゲーションを使用して、シアトルの従業員をフィルター処理し、その担当区域を表示します。  
+  
+ [!code-csharp[DLinqQueryExamples#49](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#49)]  
+  
+## 使用例  
+ 次の例は、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) で外部キー ナビゲーションを使用して、上司と部下の関係にあり、同じ `City` 出身の 2 人の従業員の組み合わせをフィルター処理します。  
+  
+ [!code-csharp[DLinqQueryExamples#50](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#50)]
+ [!code-vb[DLinqQueryExamples#50](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#50)]  
+  
+## 使用例  
+ 次の [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の例は、すべての顧客と注文を調べ、注文と顧客が一致すること、およびリスト内のすべての顧客に連絡先名が指定されていることを確認します。  
+  
+ [!code-vb[DLinqQueryExamples#50v](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#50v)]  
+  
+## 使用例  
+ 次の例は、2 つのテーブルを明示的に結合し、両方のテーブルからの結果を投影します。  
+  
+ [!code-csharp[DLinqQueryExamples#51](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#51)]
+ [!code-vb[DLinqQueryExamples#51](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#51)]  
+  
+## 使用例  
+ 次の例は、3 つのテーブルを明示的に結合し、各テーブルからの結果を投影します。  
+  
+ [!code-csharp[DLinqQueryExamples#52](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#52)]
+ [!code-vb[DLinqQueryExamples#52](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#52)]  
+  
+## 使用例  
+ 次の例は、`DefaultIfEmpty()` を使用して、`LEFT OUTER JOIN` を実現する方法を示しています。  `Employee` に `Order` がない場合は、`DefaultIfEmpty()` メソッドから null が返されます。  
+  
+ [!code-csharp[DLinqQueryExamples#53](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#53)]
+ [!code-vb[DLinqQueryExamples#53](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#53)]  
+  
+## 使用例  
+ 次の例は、結合の結果の `let` 式を投影します。  
+  
+ [!code-csharp[DLinqQueryExamples#54](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#54)]
+ [!code-vb[DLinqQueryExamples#54](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#54)]  
+  
+## 使用例  
+ 次の例は、複合キーを使用する `join` を示しています。  
+  
+ [!code-csharp[DLinqQueryExamples#55](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#55)]
+ [!code-vb[DLinqQueryExamples#55](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#55)]  
+  
+## 使用例  
+ 次の例は、一方が null 許容で他方がそうでない `join` の作成方法を示しています。  
+  
+ [!code-csharp[DLinqQueryExamples#56](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#56)]
+ [!code-vb[DLinqQueryExamples#56](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#56)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/formulate-projections.md b/docs/framework/data/adonet/sql/linq/formulate-projections.md
new file mode 100644
index 00000000000..3ba7f92b227
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/formulate-projections.md
@@ -0,0 +1,83 @@
+---
+title: "Formulate Projections | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 745742df-0eda-479b-83f8-29bd8a80db96
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Formulate Projections
+以下の例は、C\# の `select` ステートメントおよび [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` ステートメントを他の機能と組み合わせて、クエリの射影を作成する方法を示しています。  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) を使用して、`Customers` の連絡先の名前のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#57](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#57)]
+ [!code-vb[DLinqQueryExamples#57](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#57)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*匿名型*を使用して、`Customers` の連絡先の名前と電話番号のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#58](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#58)]
+ [!code-vb[DLinqQueryExamples#58](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#58)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*匿名型*を使用して、従業員の名前と電話番号のシーケンスを返します。  結果のシーケンスでは、`FirstName` フィールドと `LastName` フィールドは 1 つのフィールド \(`Name`\) に結合され、`HomePhone` フィールドは `Phone` という名前に変更されます。  
+  
+ [!code-csharp[DLinqQueryExamples#59](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#59)]
+ [!code-vb[DLinqQueryExamples#59](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#59)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*匿名型*を使用して、すべての `ProductID`、および `HalfPrice` という名前の計算値のシーケンスを返します。  この値は、`UnitPrice` を 2 で割った値に設定されます。  
+  
+ [!code-csharp[DLinqQueryExamples#60](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#60)]
+ [!code-vb[DLinqQueryExamples#60](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#60)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*条件付きステートメント*を使用して、製品名と製品の購入可能性のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#61](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#61)]
+ [!code-vb[DLinqQueryExamples#61](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#61)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*既知の型* \(Name\) を使用して、従業員の名前のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#62](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#62)]
+ [!code-vb[DLinqQueryExamples#62](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#62)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` と `Where` \(C\# の `select` と `where`\) を使用して、London の顧客の連絡先の名前の、*フィルター処理されたシーケンス*を返します。  
+  
+ [!code-csharp[DLinqQueryExamples#63](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#63)]
+ [!code-vb[DLinqQueryExamples#63](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#63)]  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] の `Select` 句 \(C\# の `select` 句\) および*匿名型*を使用して、顧客に関するデータの*成型されたサブセット*を返します。  
+  
+ [!code-csharp[DLinqQueryExamples#64](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#64)]
+ [!code-vb[DLinqQueryExamples#64](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#64)]  
+  
+## 使用例  
+ 次の例では、入れ子になったクエリを使用して以下の結果を返します。  
+  
+-   すべての注文および対応する `OrderID` のシーケンス。  
+  
+-   注文内で割引のある項目から成るサブシーケンス。  
+  
+-   出荷コストが含まれない場合に節約される費用。  
+  
+ [!code-csharp[DLinqQueryExamples#65](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#65)]
+ [!code-vb[DLinqQueryExamples#65](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#65)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/frequently-asked-questions.md b/docs/framework/data/adonet/sql/linq/frequently-asked-questions.md
new file mode 100644
index 00000000000..3f47a32f74b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/frequently-asked-questions.md
@@ -0,0 +1,209 @@
+---
+title: "Frequently Asked Questions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 252ed666-0679-4eea-b71b-2f14117ef443
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Frequently Asked Questions
+ここでは、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] を実装するときに発生する可能性のある一般的な問題の対処法について説明します。  
+  
+ その他の問題については、「[Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)」を参照してください。  
+  
+## 接続できない  
+ Q.  データベースに接続できません。  
+  
+ A:   接続文字列が正しいこと、および [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] のインスタンスが実行中であることを確認してください。  また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、名前付きパイプ プロトコルを有効にする必要があります。  詳細については、「[Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)」を参照してください。  
+  
+## データベースの変更内容が失われる  
+ Q.  データベース内のデータを変更しましたが、アプリケーションを再実行すると、変更が元に戻っています。  
+  
+ A:   変更結果をデータベースに保存するために、必ず <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出してください。  
+  
+## データベース接続: どれほどの時間開いているか  
+ Q.  データベース接続が開いている時間は、どれほどですか。  
+  
+ A:   通常、接続は、クエリ結果を処理するまでは開いた状態を保ちます。  すべての結果を処理するのに時間がかかる可能性がある場合、結果をキャッシュに入れることが可能であれば、クエリに対して <xref:System.Linq.Enumerable.ToList%2A> を適用してください。  通常のシナリオでは、各オブジェクトが一度だけ処理されるため、`DataReader` と [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のどちらの場合もストリーミング モデルがより優れています。  
+  
+ 接続が厳密にどのように使用されるかは、以下に応じて異なります。  
+  
+-   接続オブジェクトを使って <xref:System.Data.Linq.DataContext> が作成されている場合は、接続状態。  
+  
+-   接続文字列の設定 \(たとえば、複数のアクティブな結果セット \(MARS\) の有効化\)。  詳細については、「[複数のアクティブな結果セット \(MARS\)](../../../../../../docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md)」を参照してください。  
+  
+## クエリを使用しない更新  
+ Q.  データベースに対してあらかじめクエリを実行せずに、テーブル データを更新できますか?  
+  
+ A:   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] にはセットベースの更新コマンドはありませんが、次のいずれかの技法を使用すると、あらかじめクエリを実行せずに更新できます。  
+  
+-   <xref:System.Data.Linq.DataContext.ExecuteCommand%2A> を使って SQL コードを送信する。  
+  
+-   オブジェクトの新しいインスタンスを作成し、更新に関連したすべての現在値 \(フィールド\) を初期化する。  その後、<xref:System.Data.Linq.DataContext> を使ってオブジェクトを <xref:System.Data.Linq.Table%601.Attach%2A> に関連付け、更新対象のフィールドを変更します。  
+  
+## 予期しないクエリ結果  
+ Q.  予期しない結果がクエリから返されます。  どうなっているのか調べる方法はありますか。  
+  
+ A:   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には、生成された SQL コードを調べるためのツールがいくつか用意されています。  このうち、最も重要なものは <xref:System.Data.Linq.DataContext.Log%2A> です。  詳細については、「[Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)」を参照してください。  
+  
+## 予期しないストアド プロシージャ結果  
+ Q.  戻り値が `MAX()` によって計算されるストアド プロシージャがあります。  このストアド プロシージャを [!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)] サーフェイスにドラッグすると、戻り値が正しくありません。  
+  
+ A:   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には、ストアド プロシージャを介して、データベースによって生成される値を返す方法が 2 つあります。  
+  
+-   出力結果に名前を付ける。  
+  
+-   出力パラメーターを明示的に指定する。  
+  
+ 間違っている出力例を以下に示します。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は結果をマップできないため、常に 0 が返されます。  
+  
+ `create procedure proc2`  
+  
+ `as`  
+  
+ `begin`  
+  
+ `select max(i) from t where name like 'hello'`  
+  
+ `end`  
+  
+ 出力パラメーターを使用して正しい出力をする例を次に示します。  
+  
+ `create procedure proc2`  
+  
+ `@result int OUTPUT`  
+  
+ `as`  
+  
+ `select @result = MAX(i) from t where name like 'hello'`  
+  
+ `go`  
+  
+ 出力結果に名前を付けて正しい出力をする例を次に示します。  
+  
+ `create procedure proc2`  
+  
+ `as`  
+  
+ `begin`  
+  
+ `select nax(i) AS MaxResult from t where name like 'hello'`  
+  
+ `end`  
+  
+ 詳細については、「[Customizing Operations By Using Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md)」を参照してください。  
+  
+## シリアル化のエラー  
+ Q.  シリアル化を試みると、「アセンブリ ... の型 'System.Data.Linq.ChangeTracker\+StandardChangeTracker'   はシリアル化可能として設定されていません。」というエラーが発生します。  
+  
+ A:   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のコード生成では、<xref:System.Runtime.Serialization.DataContractSerializer> のシリアル化がサポートされます。  <xref:System.Xml.Serialization.XmlSerializer> および <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> はサポートされません。  詳細については、「[Serialization](../../../../../../docs/framework/data/adonet/sql/linq/serialization.md)」を参照してください。  
+  
+## 複数の DBML ファイル  
+ Q.  いくつかのテーブルを共有する複数の DBML ファイルが存在する場合は、コンパイラ エラーが発生します。  
+  
+ A:   の **Context Namespace** プロパティと [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] **Entity Namespace** プロパティを、各 DBML ファイルの個別の値に設定してください。  この手法により、名前および名前空間の競合を防ぐことができます。  
+  
+## 挿入または更新で、データベース生成値を明示的に設定しなくても良いようにする  
+ Q.  あるデータベース テーブルに `DateCreated` という列があり、その既定値は SQL `Getdate()` です。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用して新しいレコードを挿入しようとすると、値が `NULL` に設定されます。  データベースの既定値が設定されるようにするには、どうしたらいいですか。  
+  
+ A:   ID 列 \(自動インクリメント\)、rowguidcol 列 \(データベースが生成した GUID\)、およびタイムスタンプ列の場合は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が、このような状況に自動的に対処します。  それ以外の場合には、手動で <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A>\=`true` プロパティと <xref:System.Data.Linq.Mapping.ColumnAttribute.AutoSync%2A>\=<xref:System.Data.Linq.Mapping.AutoSync>\/<xref:System.Data.Linq.Mapping.AutoSync>\/<xref:System.Data.Linq.Mapping.AutoSync> プロパティを設定する必要があります。  
+  
+## 複数の DataLoadOptions  
+ Q.  最初の読み込みオプションを上書きせずに、追加の読み込みオプションを指定できますか?  
+  
+ A:   はい。  次の例のように、最初のオプションは上書きされません。  
+  
+```vb  
+Dim dlo As New DataLoadOptions()  
+dlo.LoadWith(Of Order)(Function(o As Order) o.Customer)  
+dlo.LoadWith(Of Order)(Function(o As Order) o.OrderDetails)  
+```  
+  
+```csharp  
+DataLoadOptions dlo = new DataLoadOptions();  
+dlo.LoadWith<Order>(o => o.Customer);  
+dlo.LoadWith<Order>(o => o.OrderDetails);  
+```  
+  
+## SQL Compact 3.5 の使用に関するエラー  
+ Q.  テーブルを [!INCLUDE[ssEW](../../../../../../includes/ssew-md.md)] データベースからドラッグすると、エラーが発生します。  
+  
+ A:   [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] は [!INCLUDE[ssEW](../../../../../../includes/ssew-md.md)] ランタイムではサポートされますが、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]ではサポートされません。  この場合、独自のエンティティ クラスを作成して適切な属性を追加する必要があります。  
+  
+## 継承関係でのエラー  
+ Q.  [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]でツールボックスの継承図形を使って、2 つのエンティティを接続すると、エラーが発生します。  
+  
+ A:   関係を作成するだけでは不十分です。  識別子の列、基本クラスの識別子の値、派生クラスの識別子の値などの情報を提供する必要があります。  
+  
+## プロバイダー モデル  
+ Q.  パブリック プロバイダー モデルを利用できますか?  
+  
+ A:   いいえ。使用可能なパブリック プロバイダー モデルはありません。  現時点で、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] と [!INCLUDE[ssEW](../../../../../../includes/ssew-md.md)] だけをサポートします。  
+  
+## SQL 注入攻撃  
+ Q.  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、SQL 注入攻撃からどのように保護されますか?  
+  
+ A:   ユーザー入力の連結により形成される従来の SQL クエリでは、SQL 注入が大きなリスクでした。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、クエリで <xref:System.Data.SqlClient.SqlParameter> を使用することにより、そのような注入を防止します。  ユーザー入力はパラメーター値に変換されます。  この手法は、顧客の入力で悪意のあるコマンドが使用されることを防止します。  
+  
+## DBML ファイル内の読み取り専用フラグの変更  
+ Q.  DBML ファイルからオブジェクト モデルを作成するときに、どうすれば、特定のプロパティから setter を取り除くことができますか?  
+  
+ A:   これは高度なシナリオですが、以下の手順に従ってください。  
+  
+1.  .dbml ファイル内で、<xref:System.Data.Linq.ITable.IsReadOnly%2A> フラグを `True` に変更することにより、プロパティを変更します。  
+  
+2.  部分クラスを追加します。  読み取り専用メンバー用のパラメーターを使ってコンストラクターを作成します。  
+  
+3.  既定の <xref:System.Data.Linq.Mapping.UpdateCheck> 値 \(<xref:System.Data.Linq.Mapping.UpdateCheck>\) がアプリケーションにとって適切な値かどうかを検討します。  
+  
+    > [!CAUTION]
+    >  [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] で[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)]を使用している場合は、変更内容が上書きされる可能性があります。  
+  
+## APTCA  
+ Q.  System.Data.Linq は、部分的に信頼されているコードが使用できるようにマークされていますか?  
+  
+ A:   はい。System.Data.Linq.dll アセンブリは、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] 属性でマークされている <xref:System.Security.AllowPartiallyTrustedCallersAttribute> アセンブリの 1 つです。  このマークがないと、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] のアセンブリは完全に信頼されたコードによってのみ使用されます。  
+  
+ 部分的に信頼される呼び出し元を [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で許可する主なシナリオは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]trust 構成が Medium の Web アプリケーションから  *アセンブリにアクセスできるようにする場合です。*  
+  
+## 複数のテーブルからのデータのマッピング  
+ Q.  エンティティに、複数のテーブルから取得されたデータが含まれています。  どのようにマップできますか?  
+  
+ A:   データベース内にビューを作成して、エンティティをそのビューにマップすることができます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、テーブル用と同じ SQL をビュー用に生成します。  
+  
+> [!NOTE]
+>  このシナリオでのビューの使用には、制限があります。  この手法は、<xref:System.Data.Linq.Table%601> に対して実行される操作が、基になるビューでサポートされるような場合に、最も安全に機能します。  どのような操作が意図されるかは、開発者だけが知っています。  たとえば、ほとんどのアプリケーションは読み取り専用です。他の多くのアプリケーションは、ビューに対してストアド プロシージャを使用することによってのみ、`Create`\/`Update`\/`Delete` 操作を実行します。  
+  
+## 接続プール  
+ Q.  <xref:System.Data.Linq.DataContext> プールに役立つコンストラクトはありますか?  
+  
+ A:   <xref:System.Data.Linq.DataContext> のインスタンスは再使用しないようにしてください。  <xref:System.Data.Linq.DataContext> はそれぞれ、特定の 1 つの編集\/クエリ セッション用の状態 \(ID キャッシュを含む\) を保持します。  データベースの現在の状態に基づく新しいインスタンスを得るには、新しい <xref:System.Data.Linq.DataContext> を使用してください。  
+  
+ それでも、基になる [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] 接続プールは使用できます。  詳細については、「[SQL Server の接続プール \(ADO.NET\)](../../../../../../docs/framework/data/adonet/sql-server-connection-pooling.md)」を参照してください。  
+  
+## 2 番目の DataContext が更新されない  
+ Q.  データベース内の値を格納するために、<xref:System.Data.Linq.DataContext> の 1 つのインスタンスを使用しました。  しかし、同じデータベースに対する 2 番目の <xref:System.Data.Linq.DataContext> では、更新された値が反映されません。  2 番目の <xref:System.Data.Linq.DataContext> インスタンスは、キャッシュされた値を返すようです。  
+  
+ A:   この動作は意図されたものです。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、最初のインスタンスと同じインスタンス\/値を返し続けます。  更新の際には、オプティミスティック同時実行が使用されます。  元のデータを使ってデータベースの現在の状態を検査し、実際に未変更であることをアサートします。  変更されている場合は競合が発生するため、アプリケーションでそれを解決する必要があります。  1 つのオプションとして、アプリケーションは、元の状態をデータベースの現在の状態にリセットして、更新を再試行できます。  詳細については、「[How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)」を参照してください。  
+  
+ また、<xref:System.Data.Linq.DataContext.ObjectTrackingEnabled%2A> を false に設定することもできます。この場合、キャッシュと変更追跡が無効になります。  その後は、クエリを実行するたびに最新の値を取得できます。  
+  
+## 読み取り専用モードで SubmitChanges を呼び出すことができない  
+ Q.  読み取り専用モードで <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出そうとすると、エラーが発生します。  
+  
+ A:   読み取り専用モードでは、変更を追跡するコンテキスト機能は無効です。  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)   
+ [Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)   
+ [Security in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/getting-started.md b/docs/framework/data/adonet/sql/linq/getting-started.md
new file mode 100644
index 00000000000..1cab57c13ba
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/getting-started.md
@@ -0,0 +1,39 @@
+---
+title: "Getting Started | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: db8a557a-fef8-4f4f-bb91-8cff7250ee25
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Getting Started
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用すると、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] テクノロジを使用して、メモリ内コレクションへのアクセスと同じように SQL データベースにアクセスできます。  
+  
+ たとえば、次のコードでは、`Northwind` データベースを表す `nw` オブジェクトが作成され、`Customers` テーブルが対象とされ、`London` からの `Customers` を選択するように行がフィルター処理され、取得する `CompanyName` の文字列が選択されます。  
+  
+ ループが実行されると、`CompanyName` の値のコレクションが取得されます。  
+  
+ [!code-csharp[DLinqGettingStarted#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqGettingStarted/cs/Program.cs#1)]
+ [!code-vb[DLinqGettingStarted#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqGettingStarted/vb/Module1.vb#1)]  
+  
+## 次の手順  
+ 挿入や更新など、これ以外の例については、「[LINQ to SQL の主な機能](../../../../../../docs/framework/data/adonet/sql/linq/what-you-can-do-with-linq-to-sql.md)」を参照してください。  
+  
+ 次に、チュートリアルで [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の使用を実際に体験できます。  「[Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)」を参照してください。  
+  
+ 最後に、独自の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトで作業を始める方法については、「[Typical Steps for Using LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/typical-steps-for-using-linq-to-sql.md)」を参照してください。  
+  
+## 参照  
+ [LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/index.md)   
+ [Introduction to LINQ](../../../../../../ocs/visual-basic/programming-guide/language-features/linq/introduction-to-linq.md)   
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/group-elements-in-a-sequence.md b/docs/framework/data/adonet/sql/linq/group-elements-in-a-sequence.md
new file mode 100644
index 00000000000..eeaa26d4e4e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/group-elements-in-a-sequence.md
@@ -0,0 +1,81 @@
+---
+title: "Group Elements in a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d50c8b4-f550-4775-bbb6-eab6e874cb43
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Group Elements in a Sequence
+<xref:System.Linq.Enumerable.GroupBy%2A> 演算子はシーケンスの要素をグループ化します。  Northwind データベースを使用する例を次に示します。  
+  
+> [!NOTE]
+>  null 列値が <xref:System.Linq.Enumerable.GroupBy%2A> クエリに含まれると、<xref:System.InvalidOperationException> がスローされることがあります。  詳細については、「[Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)」の「GroupBy InvalidOperationException」を参照してください。  
+  
+## 使用例  
+ 次の例では、`CategoryID` を基準として `Products` をグループ化しています。  
+  
+ [!code-csharp[DLinqQueryExamples#27](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#27)]
+ [!code-vb[DLinqQueryExamples#27](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#27)]  
+  
+## 使用例  
+ <xref:System.Linq.Enumerable.Max%2A> を使用して各 `CategoryID` の最も高い単価を調べる例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#28](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#28)]
+ [!code-vb[DLinqQueryExamples#28](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#28)]  
+  
+## 使用例  
+ Average を使用して各 `CategoryID` の `UnitPrice` の平均値を求める例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#29](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#29)]
+ [!code-vb[DLinqQueryExamples#29](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#29)]  
+  
+## 使用例  
+ <xref:System.Linq.Queryable.Sum%2A> を使用して各 `CategoryID` の `UnitPrice` の合計値を求める例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#30](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#30)]
+ [!code-vb[DLinqQueryExamples#30](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#30)]  
+  
+## 使用例  
+ <xref:System.Linq.Queryable.Count%2A> を使用して各 `CategoryID` に含まれる生産中止の `Products` の数を調べる例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#31](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#31)]
+ [!code-vb[DLinqQueryExamples#31](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#31)]  
+  
+## 使用例  
+ `where` 句を使用して最低 10 種類の製品が含まれるすべてのカテゴリを調べる方法を次の例に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#32](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#32)]
+ [!code-vb[DLinqQueryExamples#32](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#32)]  
+  
+## 使用例  
+ `CategoryID` と `SupplierID` を使用して製品をグループ化する例を次に示します。  
+  
+ [!code-csharp[DLinqQueryExamples#33](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#33)]
+ [!code-vb[DLinqQueryExamples#33](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#33)]  
+  
+## 使用例  
+ 次の例は、製品の 2 つのシーケンスを返します。  最初のシーケンスには、単価が 10 以下の製品が含まれます。  2 番目のシーケンスには、単価が 10 よりも大きい製品が含まれます。  
+  
+ [!code-csharp[DLinqQueryExamples#34](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#34)]
+ [!code-vb[DLinqQueryExamples#34](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#34)]  
+  
+## 使用例  
+ <xref:System.Linq.Queryable.GroupBy%2A> 演算子は、単一キーの引数のみを受け取ります。  複数のキーを使用してグループ化する場合は、次の例に示すように、匿名型を作成する必要があります。  
+  
+ [!code-csharp[DLinqQueryExamples#35](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#35)]
+ [!code-vb[DLinqQueryExamples#35](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#35)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-bracket-data-submissions-by-using-transactions.md b/docs/framework/data/adonet/sql/linq/how-to-bracket-data-submissions-by-using-transactions.md
new file mode 100644
index 00000000000..678f526ced7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-bracket-data-submissions-by-using-transactions.md
@@ -0,0 +1,31 @@
+---
+title: "How to: Bracket Data Submissions by Using Transactions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94044a31-de90-479b-935a-8159b4ae5c5a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Bracket Data Submissions by Using Transactions
+データベースへの送信を <xref:System.Transactions.TransactionScope> で囲むことができます。  詳細については、「[Transaction Support](../../../../../../docs/framework/data/adonet/sql/linq/transaction-support.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードでは、データベース送信を <xref:System.Transactions.TransactionScope> で囲みます。  
+  
+ [!code-csharp[DLinqSubmittingChanges#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#3)]
+ [!code-vb[DLinqSubmittingChanges#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#3)]  
+  
+## 参照  
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)   
+ [Transaction Support](../../../../../../docs/framework/data/adonet/sql/linq/transaction-support.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-call-user-defined-functions-inline.md b/docs/framework/data/adonet/sql/linq/how-to-call-user-defined-functions-inline.md
new file mode 100644
index 00000000000..f5ae1a82c0a
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-call-user-defined-functions-inline.md
@@ -0,0 +1,46 @@
+---
+title: "How to: Call User-Defined Functions Inline | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f80d4327-b6a5-4aa8-a743-e95d09a2a02e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Call User-Defined Functions Inline
+ユーザー定義関数はインラインで呼び出すことができますが、遅延実行のクエリに含まれる関数は、そのクエリが実行されるまで実行されません。  詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+ 同じ関数をクエリの外部で呼び出すと、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、メソッド呼び出し式から単純なクエリが作成されます。  この SQL 構文を次に示します \(`@p0` パラメーターは渡される定数にバインドされます\)。  
+  
+```  
+SELECT dbo.ReverseCustName(@p0)  
+```  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、次の結果が作成されます。  
+  
+ [!code-csharp[DLinqUDFS#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqUDFS/cs/Program.cs#4)]
+ [!code-vb[DLinqUDFS#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqUDFS/vb/Module1.vb#4)]  
+  
+## 使用例  
+ 次の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリでは、生成されたユーザー定義関数メソッド `ReverseCustName` がインライン呼び出しになっています。  クエリは遅延実行されるので、この関数は即座には実行されません。  このクエリ用に作成される SQL は、データベース内のユーザー定義関数の呼び出しに変換されます \(クエリの後の SQL コードを参照してください\)。  
+  
+ [!code-csharp[DLinqUDFS#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqUDFS/cs/Program.cs#5)]
+ [!code-vb[DLinqUDFS#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqUDFS/vb/Module1.vb#5)]  
+  
+```  
+SELECT [t0].[ContactName],  
+    dbo.ReverseCustName([t0].[ContactTitle]) AS [Title]  
+FROM [Customers] AS [t0]  
+```  
+  
+## 参照  
+ [User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/user-defined-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md b/docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md
new file mode 100644
index 00000000000..dfa6e85ec49
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md
@@ -0,0 +1,47 @@
+---
+title: "How to: Connect to a Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c33d74b3-530d-421b-a121-96786dd263a5
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Connect to a Database
+データベースへの接続、データベースからのオブジェクトの取得、およびデータベースへの変更内容の反映では、<xref:System.Data.Linq.DataContext> を仲介役として使用します。  <xref:System.Data.Linq.DataContext> の使い方は [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] の <xref:System.Data.SqlClient.SqlConnection> と同様です。  つまり、接続または接続文字列を指定して、<xref:System.Data.Linq.DataContext> を初期化します。  詳細については、「[DataContext Methods \(O\/R Designer\)](../Topic/DataContext%20Methods%20\(O-R%20Designer\).md)」を参照してください。  
+  
+ <xref:System.Data.Linq.DataContext> の役割は、オブジェクトを求める要求を、データベースに対して発行する SQL クエリに変換し、その結果からオブジェクトを組み立てることです。  <xref:System.Data.Linq.DataContext> では、標準クエリ演算子と同じ演算子パターン \(`Where` や `Select` など\) を実装することで、[!INCLUDE[vbteclinqext](../../../../../../includes/vbteclinqext-md.md)] を使用できます。  
+  
+> [!IMPORTANT]
+>  セキュリティで保護された接続を確立することは、最も重要です。  詳細については、「[Security in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Linq.DataContext> を使用して、Northwind サンプル データベースに接続し、市が London である顧客の行を取得しています。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#1)]
+ [!code-vb[DLinqCommunicatingWithDatabase#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#1)]  
+  
+ 各データベース テーブルは `Table` コレクションとして表され、テーブルを識別するエンティティ クラスを使用して <xref:System.Data.Linq.DataContext.GetTable%2A> メソッドでアクセスできます。  
+  
+## 使用例  
+ 基本的な <xref:System.Data.Linq.DataContext> クラスおよび <xref:System.Data.Linq.DataContext.GetTable%2A> メソッドを使用するのではなく、厳密に型指定された <xref:System.Data.Linq.DataContext> を宣言するのがベスト プラクティスです。  厳密に型指定された <xref:System.Data.Linq.DataContext> では、次の例のように、すべての `Table` コレクションをそのコンテキストのメンバーとして宣言します。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#2)]
+ [!code-vb[DLinqCommunicatingWithDatabase#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#2)]  
+  
+ この場合、London の顧客を取得するクエリは、次のように簡単に表せます。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#5)]
+ [!code-vb[DLinqCommunicatingWithDatabase#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#5)]  
+  
+## 参照  
+ [Communicating with the Database](../../../../../../docs/framework/data/adonet/sql/linq/communicating-with-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-control-how-much-related-data-is-retrieved.md b/docs/framework/data/adonet/sql/linq/how-to-control-how-much-related-data-is-retrieved.md
new file mode 100644
index 00000000000..48567200cee
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-control-how-much-related-data-is-retrieved.md
@@ -0,0 +1,32 @@
+---
+title: "How to: Control How Much Related Data Is Retrieved | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efdc203e-3da9-4477-815e-54f10c3d7c6c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Control How Much Related Data Is Retrieved
+メイン ターゲットと一緒にどの関連データを取得するかを指定するには、<xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> メソッドを使用します。  たとえば、顧客の注文に関する情報が必要になることがわかっている場合は、<xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> を使用して、顧客情報と同時に注文情報を取得できます。  この方法によって、データベースへの 1 回のアクセスで 2 種類の情報セットを両方とも取得できます。  
+  
+> [!NOTE]
+>  メイン ターゲットである顧客に関連して注文データも取得する場合など、クエリのメイン ターゲットに関連するデータを取得するには、クロス積を 1 つの大きな投影として取得する方法もあります。  ただし、多くの場合、この方法には欠点があります。  たとえば、この結果は単なる射影であり、エンティティではないため、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で変更して永続化することはできません。また、不要なデータが大量に取得される可能性もあります。  
+  
+## 使用例  
+ 次の例では、クエリを実行すると、ロンドンに住んでいるすべての `Customers` のすべての `Orders` が取得されます。  その結果、それ以降 `Customer` オブジェクトの `Orders` プロパティにアクセスしても、新しいデータベース クエリは実行されません。  
+  
+ [!code-csharp[System.Data.Linq.DataLoadOptions#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.dataloadoptions/cs/program.cs#2)]
+ [!code-vb[System.Data.Linq.DataLoadOptions#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.dataloadoptions/vb/module1.vb#2)]  
+  
+## 参照  
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md b/docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md
new file mode 100644
index 00000000000..d7fa3e10a16
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md
@@ -0,0 +1,66 @@
+---
+title: "How to: Customize Entity Classes by Using the Code Editor | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec28332f-9f3c-4e0a-baca-60f9141a68c0
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Customize Entity Classes by Using the Code Editor
+[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してエンティティ クラスを作成またはカスタマイズできます。  
+  
+ [!INCLUDE[vsprvs](../../../../../../includes/vsprvs-md.md)] コード エディターを使用して、独自のマッピング コードを記述したり、既に生成されているコードをカスタマイズしたりすることもできます。  詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」を参照してください。  
+  
+ このセクションのトピックでは、オブジェクト モデルをカスタマイズする方法について説明します。  
+  
+ [How to: Specify Database Names](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-database-names.md)  
+ <xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> の使用方法について説明します。  
+  
+ [How to: Represent Tables as Classes](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-tables-as-classes.md)  
+ <xref:System.Data.Linq.Mapping.TableAttribute> の使用方法について説明します。  
+  
+ [How to: Represent Columns as Class Members](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-class-members.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute> の使用方法について説明します。  
+  
+ [How to: Represent Primary Keys](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-primary-keys.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A> の使用方法について説明します。  
+  
+ [How to: Map Database Relationships](../../../../../../docs/framework/data/adonet/sql/linq/how-to-map-database-relationships.md)  
+ <xref:System.Data.Linq.Mapping.AssociationAttribute> 属性の使い方の例を示します。  
+  
+ [How to: Represent Columns as Database\-Generated](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-database-generated.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A> の使用方法について説明します。  
+  
+ [How to: Represent Columns as Timestamp or Version Columns](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-timestamp-or-version-columns.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> の使用方法について説明します。  
+  
+ [How to: Specify Database Data Types](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-database-data-types.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A> の使用方法について説明します。  
+  
+ [How to: Represent Computed Columns](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-computed-columns.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A> の使用方法について説明します。  
+  
+ [How to: Specify Private Storage Fields](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-private-storage-fields.md)  
+ <xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A> の使用方法について説明します。  
+  
+ [How to: Represent Columns as Allowing Null Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-allowing-null-values.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A> の使用方法について説明します。  
+  
+ [How to: Map Inheritance Hierarchies](../../../../../../docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md)  
+ 継承階層の指定に必要な割り当てについて説明します。  
+  
+ [How to: Specify Concurrency\-Conflict Checking](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-concurrency-conflict-checking.md)  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> の使用方法について説明します。  
+  
+## 参照  
+ [SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md b/docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md
new file mode 100644
index 00000000000..f413f2a839f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md
@@ -0,0 +1,60 @@
+---
+title: "How to: Delete Rows From the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2144c99b-8055-4080-a5c6-1ea14335e2a3
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Delete Rows From the Database
+テーブルに関連付けられたコレクションから行に対応する [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクトを削除することで、その行をデータベースから削除できます。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、変更内容が適切な SQL の `DELETE` コマンドに変換されます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は連鎖削除操作をサポートせず、認識もしません。  制約を持つテーブルの行を削除するには、次のいずれかのタスクを完了する必要があります。  
+  
+-   データベース内の外部キー制約で `ON DELETE CASCADE` 規則を設定する。  
+  
+-   独自のコードを使用して、親オブジェクトの削除を妨げる子オブジェクトを最初に削除する。  
+  
+ それ以外の場合は、例外がスローされます。  後で説明する 2 番目のコード例を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の `Insert`、`Update`、および `Delete` の既定のデータベース操作メソッドはオーバーライドできます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+>   
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、同じ用途のストアド プロシージャを開発できます。  
+  
+ 以下の手順では、有効な <xref:System.Data.Linq.DataContext> で Northwind データベースに接続されるものと想定しています。  詳細については、「[How to: Connect to a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md)」を参照してください。  
+  
+### データベースから行を削除するには  
+  
+1.  データベースで削除する行をクエリします。  
+  
+2.  <xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A> メソッドを呼び出します。  
+  
+3.  データベースに変更内容を送信します。  
+  
+## 使用例  
+ この最初のコード例では、注文 \#11000 に属する注文詳細情報をデータベースに照会し、それらの注文詳細情報を削除するようにマークして、変更をデータベースに送信します。  
+  
+ [!code-csharp[System.Data.Linq.Table#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.table/cs/program.cs#3)]
+ [!code-vb[System.Data.Linq.Table#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/module1.vb#3)]  
+  
+## 使用例  
+ この 2 番目のコード例の目的は、注文 \(\#10250\) を削除することです。  このコードは、まず、`OrderDetails` テーブルを調べて、削除対象の注文に子が存在するかどうかを確認します。  注文に子が存在する場合は、最初に子を、次に注文を削除するようにマークします。  <xref:System.Data.Linq.DataContext> によって、データベース制約に従って削除コマンドがデータベースに送信され、正しい順序で実際の削除が行われます。  
+  
+ [!code-csharp[DLinqCascadeWorkaround#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCascadeWorkaround/cs/Program.cs#1)]
+ [!code-vb[DLinqCascadeWorkaround#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCascadeWorkaround/vb/Module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [How to: Assign Stored Procedures to Perform Updates, Inserts, and Deletes \(O\/R Designer\)](../Topic/How%20to:%20Assign%20stored%20procedures%20to%20perform%20updates,%20inserts,%20and%20deletes%20\(O-R%20Designer\).md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-detect-and-resolve-conflicting-submissions.md b/docs/framework/data/adonet/sql/linq/how-to-detect-and-resolve-conflicting-submissions.md
new file mode 100644
index 00000000000..d49499ccddd
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-detect-and-resolve-conflicting-submissions.md
@@ -0,0 +1,33 @@
+---
+title: "How to: Detect and Resolve Conflicting Submissions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 91e27206-01fb-4c7a-8afc-1383a6ac5067
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Detect and Resolve Conflicting Submissions
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には、複数のユーザーがデータベースを変更するために生じる競合を、検出および解決するための多くのリソースが用意されています。  詳細については、「[How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)」を参照してください。  
+  
+## 使用例  
+ <xref:System.Data.Linq.ChangeConflictException> 例外をキャッチする `try`\/`catch` ブロックの例を次にします。  各競合のエンティティおよびメンバー情報が、コンソール ウィンドウに表示されます。  
+  
+> [!NOTE]
+>  情報の取得をサポートするには、`using System.Reflection` ディレクティブ \(Visual Basic の場合は `Imports System.Reflection`\) を含める必要があります。  詳細については、「<xref:System.Reflection>」を参照してください。  
+  
+ [!code-csharp[DLinqSubmittingChanges#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#2)]
+ [!code-vb[DLinqSubmittingChanges#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#2)]  
+  
+## 参照  
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)   
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-commands.md b/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-commands.md
new file mode 100644
index 00000000000..fc8037fd2f5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-commands.md
@@ -0,0 +1,30 @@
+---
+title: "How to: Directly Execute SQL Commands | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04671bb0-40c0-4465-86e5-77986f454661
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Directly Execute SQL Commands
+<xref:System.Data.Linq.DataContext> 接続を使用すると仮定して、オブジェクトを返さない SQL コマンドを実行するために <xref:System.Data.Linq.DataContext.ExecuteCommand%2A> を使用できます。  
+  
+## 使用例  
+ SQL Server で UnitPrice の値を 1.00 増やす方法の例を次に示します。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#3)]
+ [!code-vb[DLinqCommunicatingWithDatabase#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#3)]  
+  
+## 参照  
+ [How to: Directly Execute SQL Queries](../../../../../../docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-queries.md)   
+ [Communicating with the Database](../../../../../../docs/framework/data/adonet/sql/linq/communicating-with-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-queries.md b/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-queries.md
new file mode 100644
index 00000000000..ac1b340d558
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-queries.md
@@ -0,0 +1,44 @@
+---
+title: "How to: Directly Execute SQL Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e491b9bf-741a-4296-9f51-76c25ddf6a82
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Directly Execute SQL Queries
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、作成したクエリをパラメーター化された SQL クエリ \(テキスト形式\) に変換し、それを SQL Server に送って処理します。  
+  
+ アプリケーションでローカルに使用できるさまざまなメソッドの中には、SQL では実行できないものもあります。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、このようなローカル メソッドを、SQL 環境内で使用できる同等の操作や関数に変換しようとします。  [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] 組み込み型のほとんどのメソッドと演算子には、SQL コマンドに直接対応する変換が用意されています。  使用可能な関数から生成できるものもあります。  生成できないものについては、ランタイム例外が発生します。  詳細については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」を参照してください。  
+  
+ 特殊なタスクに対して [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリでは不十分な場合は、<xref:System.Data.Linq.DataContext.ExecuteQuery%2A> メソッドを使用して SQL クエリを実行し、そのクエリの結果をオブジェクトに直接変換できます。  
+  
+## 使用例  
+ 次の例では、`Customer` クラスのデータが 2 つのテーブル \(customer1 および customer2\) にわたって格納されているものとします。  クエリは `Customer` オブジェクトのシーケンスを返します。  
+  
+ [!code-csharp[DLinqQuerying#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#4)]
+ [!code-vb[DLinqQuerying#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#4)]  
+  
+ 表形式の結果の列名がエンティティ クラスの列のプロパティと一致する限り、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は SQL クエリからオブジェクトを作成します。  
+  
+## 使用例  
+ <xref:System.Data.Linq.DataContext.ExecuteQuery%2A> メソッドは、パラメーターの使用にも対応しています。  パラメーター化されたクエリを実行するには、次のようなコードを使用します。  
+  
+ [!code-csharp[DLinqQuerying#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#5)]
+ [!code-vb[DLinqQuerying#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#5)]  
+  
+ クエリ テキスト内では、`Console.WriteLine()` および `String.Format()` で使用するのと同じ中かっこ表記を使用して、パラメーターを表現します。  実際には、指定したクエリ文字列について `String.Format()` が呼び出され、中かっこで囲まれたパラメーターは、生成された @p0、@p1、...、@p\(n\) のようなパラメーター名に置き換えられます。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-display-a-changeset.md b/docs/framework/data/adonet/sql/linq/how-to-display-a-changeset.md
new file mode 100644
index 00000000000..496e2c508c5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-display-a-changeset.md
@@ -0,0 +1,83 @@
+---
+title: "How to: Display a ChangeSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 126e7245-c5a0-4ebf-800d-cc1fcf9cd0ab
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Display a ChangeSet
+<xref:System.Data.Linq.DataContext> によって追跡される変更を <xref:System.Data.Linq.DataContext.GetChangeSet%2A> を使って表示することができます。  
+  
+## 使用例  
+ 以下の例では、住所がロンドンの顧客を取得し、これをパリに変更してから変更内容をデータベースに送信しています。  
+  
+ [!code-csharp[DLinqDebuggingSupport#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqDebuggingSupport/cs/Program.cs#2)]
+ [!code-vb[DLinqDebuggingSupport#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqDebuggingSupport/vb/Module1.vb#2)]  
+  
+ このコードからの出力は次のようになります。  最後に概要として、8 か所の変更が示されることに注意してください。  
+  
+ `CustomerID: AROUT`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: BSBEV`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: CONSH`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: EASTC`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: NORTS`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: PARIS`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: SEVES`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ `CustomerID: SPECD`  
+  
+ `Original value: London`  
+  
+ `Updated value: Paris`  
+  
+ ``  
+  
+ `Total changes: {Added: 0, Removed: 0, Modified: 8}`  
+  
+## 参照  
+ [Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-display-generated-sql.md b/docs/framework/data/adonet/sql/linq/how-to-display-generated-sql.md
new file mode 100644
index 00000000000..cf8c948b714
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-display-generated-sql.md
@@ -0,0 +1,50 @@
+---
+title: "How to: Display Generated SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 626492c0-5ee3-4675-88e8-8c40379510b6
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Display Generated SQL
+<xref:System.Data.Linq.DataContext.Log%2A> プロパティを使用して、クエリに対して生成された SQL コードを表示し、処理を変更できます。  この方法は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の機能を理解し、特定の問題をデバッグするのに役立ちます。  
+  
+## 使用例  
+ <xref:System.Data.Linq.DataContext.Log%2A> プロパティを使用して、コードを実行する前にコンソール ウィンドウに SQL コードを表示するコード例を次に示します。  このプロパティは、query、insert、update、および delete の各コマンドで使用できます。  
+  
+ コンソール ウィンドウの行は、次の [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] コードまたは C\# コードを実行するときに表示される内容です。  
+  
+```  
+SELECT [t0].[CustomerID], [t0].[CompanyName], [t0].[ContactName], [t0].[ContactT  
+itle], [t0].[Address], [t0].[City], [t0].[Region], [t0].[PostalCode], [t0].[Coun  
+try], [t0].[Phone], [t0].[Fax]  
+FROM [dbo].[Customers] AS [t0]  
+WHERE [t0].[City] = @p0  
+-- @p0: Input String (Size = 6; Prec = 0; Scale = 0) [London]  
+-- Context: SqlProvider(Sql2005) Model: AttributedMetaModel Build: 3.5.20810.0  
+```  
+  
+```  
+AROUT  
+BSBEV  
+CONSH  
+EASTC  
+NORTS  
+SEVES  
+```  
+  
+ [!code-csharp[DLinqDebuggingSupport#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqDebuggingSupport/cs/Program.cs#1)]
+ [!code-vb[DLinqDebuggingSupport#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqDebuggingSupport/vb/Module1.vb#1)]  
+  
+## 参照  
+ [Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-display-linq-to-sql-commands.md b/docs/framework/data/adonet/sql/linq/how-to-display-linq-to-sql-commands.md
new file mode 100644
index 00000000000..8434c9a466f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-display-linq-to-sql-commands.md
@@ -0,0 +1,56 @@
+---
+title: "How to: Display LINQ to SQL Commands | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1decb05e-37ad-4ed6-ab2f-071eb4c4f628
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Display LINQ to SQL Commands
+SQL コマンドとその他の情報を表示するには、<xref:System.Data.Linq.DataContext.GetCommand%2A> を使用します。  
+  
+## 使用例  
+ クエリからの出力、生成された SQL コマンド、コマンドの種類、および接続の種類をコンソール ウィンドウに表示する例を次に示します。  
+  
+ [!code-csharp[DLinqDebuggingSupport#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqDebuggingSupport/cs/Program.cs#3)]
+ [!code-vb[DLinqDebuggingSupport#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqDebuggingSupport/vb/Module1.vb#3)]  
+  
+ 次のような出力が表示されます。  
+  
+```  
+Customers from London:  
+    Thomas Hardy  
+    Victoria Ashworth  
+    Elizabeth Brown  
+    Ann Devon  
+    Simon Crowther  
+    Marie Bertrand  
+    Hari Kumar  
+    Dominique Perrier  
+```  
+  
+```  
+Command Text:  
+SELECT [t0].[CustomerID], [t0].[CompanyName], [t0].[ContactName], [t0].[ContactT  
+itle], [t0].[Address], [t0].[City], [t0].[Region], [t0].[PostalCode], [t0].[Coun  
+try], [t0].[Phone], [t0].[Fax]  
+FROM [dbo].[Customers] AS [t0]  
+WHERE [t0].[City] = @p0  
+  
+Command Type: Text  
+  
+Connection: System.Data.SqlClient.SqlConnection  
+```  
+  
+## 参照  
+ [Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md b/docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md
new file mode 100644
index 00000000000..7cd029d658b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md
@@ -0,0 +1,60 @@
+---
+title: "How to: Dynamically Create a Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb7f23c4-4572-4c38-9898-a287807d070c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Dynamically Create a Database
+LINQ to SQL では、オブジェクト モデルをリレーショナル データベースに対応付けます。  マッピングを有効化するには、属性ベースの対応付けか、リレーショナル データベースの構造を記述した外部マッピング ファイルを使用します。  いずれの場合も、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドを使用してデータベースの新しいインスタンスを作成するために必要な、リレーショナル データベースに関する十分な情報が提供されます。  
+  
+ <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで作成されるデータベースのレプリカには、オブジェクト モデル内でエンコードされる情報だけが格納されます。  マッピング ファイルおよびオブジェクト モデルの属性では、既存のデータベースの構造のすべてがエンコードされるとは限りません。  ユーザー定義関数、ストアド プロシージャ、トリガー、または CHECK 制約の内容は、マッピング ファイルでは表現されません。  これは多くのデータベースにとって十分な動作です。  
+  
+ <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドはさまざまなシナリオで使用できますが、特に、Microsoft SQL Server 2008 などの既知のデータ プロバイダーを利用できる場合に適しています。  一般的なシナリオとして、次のようなものが考えられます。  
+  
+-   顧客のシステムに自動的に自身をインストールするアプリケーションを作成している場合  
+  
+-   オフライン状態を保存するためにローカル データベースを必要とするクライアント アプリケーションを作成している場合  
+  
+ 接続文字列で .mdf ファイルまたは単にカタログ名を使用することにより、SQL Server でも <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドを使用できます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、接続文字列を使用して、作成するデータベースおよびデータベースの作成先となるサーバーを定義します。  
+  
+> [!NOTE]
+>  可能な限り、データベースへの接続には Windows 統合セキュリティを使用してください。これにより、接続文字列にパスワードを含める必要がなくなります。  
+  
+## 使用例  
+ 次のコードは、MyDVDs.mdf という名前の新しいデータベースを作成する例です。  
+  
+ [!code-csharp[DLinqSubmittingChanges#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#5)]
+ [!code-vb[DLinqSubmittingChanges#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#5)]  
+  
+## 使用例  
+ 次のようにすると、オブジェクト モデルを使用してデータベースを作成できます。  
+  
+ [!code-csharp[DLinqSubmittingChanges#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#6)]
+ [!code-vb[DLinqSubmittingChanges#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#6)]  
+  
+## 使用例  
+ 顧客のシステムに自動的に自身をインストールするアプリケーションを作成している場合、新しいデータベースを作成する前に既存のデータベースがあるかどうかを確認して削除します。  <xref:System.Data.Linq.DataContext> クラスには、このプロセスに役立つ <xref:System.Data.Linq.DataContext.DatabaseExists%2A> メソッドと <xref:System.Data.Linq.DataContext.DeleteDatabase%2A> メソッドが用意されています。  
+  
+ 次の例は、これらのメソッドを使用してこの方法を実装する 1 つの方法を示しています。  
+  
+ [!code-csharp[DLinqSubmittingChanges#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#7)]
+ [!code-vb[DLinqSubmittingChanges#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#7)]  
+  
+## 参照  
+ [Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)   
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)   
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)   
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-filter-at-the-datacontext-level.md b/docs/framework/data/adonet/sql/linq/how-to-filter-at-the-datacontext-level.md
new file mode 100644
index 00000000000..2eee89546d1
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-filter-at-the-datacontext-level.md
@@ -0,0 +1,29 @@
+---
+title: "How to: Filter at the DataContext Level | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15505cd7-0df2-427a-9f86-e0f96f60ee2e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Filter at the DataContext Level
+`EntitySets` を `DataContext` レベルでフィルター処理できます。  このフィルター処理は、対象の <xref:System.Data.Linq.DataContext> インスタンスを使って実行されたすべてのクエリに適用されます。  
+  
+## 使用例  
+ 次の例では、あらかじめ読み込まれた顧客からの注文を `ShippedDate` に基づいてフィルター処理するために <xref:System.Data.Linq.DataLoadOptions.AssociateWith%28System.Linq.Expressions.LambdaExpression%29?displayProperty=fullName> が使用されます。  
+  
+ [!code-csharp[DLinqQueryConcepts#10](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#10)]
+ [!code-vb[DLinqQueryConcepts#10](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#10)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-filter-related-data.md b/docs/framework/data/adonet/sql/linq/how-to-filter-related-data.md
new file mode 100644
index 00000000000..c490ba6f225
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-filter-related-data.md
@@ -0,0 +1,29 @@
+---
+title: "How to: Filter Related Data | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec8b8f97-5d01-4f31-9b97-d1556df6a4bc
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Filter Related Data
+取得したデータの量を制限するサブクエリを指定するには、<xref:System.Data.Linq.DataLoadOptions.AssociateWith%2A> メソッドを使用します。  
+  
+## 使用例  
+ 次の例の <xref:System.Data.Linq.DataLoadOptions.AssociateWith%2A> メソッドは、取得した `Orders` を、その日に出荷されていないものに限定します。  この処理を行わないと、サブセットのみが必要な場合でも、すべての `Orders` が取得されることになります。  
+  
+ [!code-csharp[System.Data.Linq.DataLoadOptions#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.dataloadoptions/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.DataLoadOptions#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.dataloadoptions/vb/module1.vb#1)]  
+  
+## 参照  
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-generate-customized-code-by-modifying-a-dbml-file.md b/docs/framework/data/adonet/sql/linq/how-to-generate-customized-code-by-modifying-a-dbml-file.md
new file mode 100644
index 00000000000..6a9cfbd2071
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-generate-customized-code-by-modifying-a-dbml-file.md
@@ -0,0 +1,51 @@
+---
+title: "How to: Generate Customized Code by Modifying a DBML File | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 50ad597a-8598-42d3-82dd-fc7d702ebc37
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Generate Customized Code by Modifying a DBML File
+データベース マークアップ言語 \(.dbml\) メタデータ ファイルから、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] または C\# のソース コードを生成できます。  この方法を使用すると、アプリケーション マッピング コードを生成する前に、既定の .dbml ファイルをカスタマイズできます。  これは高度な機能です。  
+  
+ 実行手順は次のとおりです。  
+  
+1.  .dbml ファイルを生成します。  
+  
+2.  エディターを使用して .dbml ファイルを変更します。  .dbml ファイルは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] .dbml ファイルのスキーマ定義 \(.xsd\) ファイルに照らして検証する必要があることに注意してください。  詳細については、「[Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)」を参照してください。  
+  
+3.  [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] または C\# のソース コードを生成します。  
+  
+ 次の例では、SQLMetal コマンド ライン ツールを使用します。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードでは、Northwind サンプル データベースから .dbml ファイルを生成します。  データベース メタデータのソースとして、データベースの名前または .mdf ファイルの名前を使用します。  
+  
+```  
+sqlmetal /server:myserver /database:northwind /dbml:mymeta.dbml  
+sqlmetal /dbml:mymeta.dbml mydbfile.mdf  
+```  
+  
+## 使用例  
+ 次のコードでは、.dbml ファイルから [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] または C\# のソース コードを生成します。  
+  
+```  
+sqlmetal /namespace:nwind /code:nwind.vb /language:vb DBMLFile.dbml  
+sqlmetal /namespace:nwind /code:nwind.cs /language:csharp DBMLFile.dbml  
+```  
+  
+## 参照  
+ [Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)   
+ [SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md b/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md
new file mode 100644
index 00000000000..e0fd328760f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-as-an-external-file.md
@@ -0,0 +1,61 @@
+---
+title: "How to: Generate the Object Model as an External File | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2496fa06-3df4-4ecb-86c4-70a49ea08565
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Generate the Object Model as an External File
+属性ベースのマッピングに代わる方法として、SQLMetal コマンド ライン ツールを使用することにより、外部 XML ファイルとしてオブジェクト モデルを生成できます。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  外部 XML マッピング ファイルを使用すると、コードの煩雑さが軽減されます。  さらに、アプリケーションのバイナリを再コンパイルしなくても、外部ファイルを変更するだけで動作を変えることができます。  詳細については、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]は、外部マッピング ファイルの生成をサポートしていません。  
+  
+## 使用例  
+ 次のコマンドは、Northwind サンプル データベースから外部マッピング ファイルを生成します。  
+  
+```  
+sqlmetal /server:myserver /database:northwind /map:externalfile.xml  
+```  
+  
+## 使用例  
+ 以下は、Northwind サンプル データベース内の Customers テーブルのマッピングを示す、外部マッピング ファイルの一部分です。  この部分は、**\/map** オプションを使って SQLMetal を実行することによって生成されました。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<Database xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Name="northwnd">  
+  <Table Name="Customers">  
+    <Type Name=".Customer">  
+      <Column Name="CustomerID" Member="CustomerID" Storage="_CustomerID" DbType="NChar(5) NOT NULL" CanBeNull="False" IsPrimaryKey="True" />  
+      <Column Name="CompanyName" Member="CompanyName" Storage="_CompanyName" DbType="NVarChar(40) NOT NULL" CanBeNull="False" />  
+      <Column Name="ContactName" Member="ContactName" Storage="_ContactName" DbType="NVarChar(30)" />  
+      <Column Name="ContactTitle" Member="ContactTitle" Storage="_ContactTitle" DbType="NVarChar(30)" />  
+      <Column Name="Address" Member="Address" Storage="_Address" DbType="NVarChar(60)" />  
+      <Column Name="City" Member="City" Storage="_City" DbType="NVarChar(15)" />  
+      <Column Name="Region" Member="Region" Storage="_Region" DbType="NVarChar(15)" />  
+      <Column Name="PostalCode" Member="PostalCode" Storage="_PostalCode" DbType="NVarChar(10)" />  
+      <Column Name="Country" Member="Country" Storage="_Country" DbType="NVarChar(15)" />  
+      <Column Name="Phone" Member="Phone" Storage="_Phone" DbType="NVarChar(24)" />  
+      <Column Name="Fax" Member="Fax" Storage="_Fax" DbType="NVarChar(24)" />  
+      <Association Name="FK_CustomerCustomerDemo_Customers" Member="CustomerCustomerDemos" Storage="_CustomerCustomerDemos" ThisKey="CustomerID" OtherTable="CustomerCustomerDemo" OtherKey="CustomerID" DeleteRule="NO ACTION" />  
+      <Association Name="FK_Orders_Customers" Member="Orders" Storage="_Orders" ThisKey="CustomerID" OtherTable="Orders" OtherKey="CustomerID" DeleteRule="NO ACTION" />  
+    </Type>  
+  </Table>  
+</Database>  
+```  
+  
+## 参照  
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)   
+ [How to: Generate the Object Model in Visual Basic or C\#](../../../../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md b/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md
new file mode 100644
index 00000000000..a37ec0ecd5e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md
@@ -0,0 +1,54 @@
+---
+title: "How to: Generate the Object Model in Visual Basic or C# | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a0c73b33-5650-420c-b9dc-f49310c201ee
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Generate the Object Model in Visual Basic or C# #
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、使用しているプログラミング言語のオブジェクト モデルが、リレーショナル データベースに対応付けられています。  既存のデータベースのメタデータから [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] または C\# のモデルを自動的に生成するためのツールが 2 つ用意されています。  
+  
+-   [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してオブジェクト モデルを生成できます。  [!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]では、機能が豊富なユーザー インターフェイスを使用して、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルを生成できます。  
+  
+-   SQLMetal コマンド ライン ツール。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  既存のデータベースがなく、オブジェクト モデルからデータベースを作成する場合は、コード エディターと <xref:System.Data.Linq.DataContext.CreateDatabase%2A> を使用してオブジェクト モデルを作成できます。  詳細については、「[How to: Dynamically Create a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md)」を参照してください。  
+  
+ [!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]のドキュメントには、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]を使用して、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)] または C\# のオブジェクト モデルを生成する方法の例が紹介されています。  以下の情報は、SQLMetal コマンド ライン ツールの使用方法の例です。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 使用例  
+ 次の例に示す SQLMetal コマンド ラインでは、Northwind サンプル データベースの属性ベースのオブジェクト モデルとして [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] コードが生成されます。  ストアド プロシージャと関数も含まれます。  
+  
+```  
+sqlmetal /code:northwind.vb /language:vb "c:\northwnd.mdf" /sprocs /functions  
+```  
+  
+## 使用例  
+ 次の例に示す SQLMetal コマンド ラインでは、Northwind サンプル データベースの属性ベースのオブジェクト モデルとして C\# コードが生成されます。  ストアド プロシージャと関数も含まれ、テーブル名は自動的に複数化されます。  
+  
+```  
+sqlmetal /code:northwind.cs /language:csharp "c:\northwnd.mdf" /sprocs /functions /pluralize  
+```  
+  
+## 参照  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)   
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)   
+ [Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)   
+ [SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)   
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-handle-composite-keys-in-queries.md b/docs/framework/data/adonet/sql/linq/how-to-handle-composite-keys-in-queries.md
new file mode 100644
index 00000000000..c0a4ca51e2b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-handle-composite-keys-in-queries.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Handle Composite Keys in Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ce2f14fd-1038-458a-91e3-a078c61f0d10
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Handle Composite Keys in Queries
+演算子によっては、引数を 1 つしか受け取らないものがあります。  1 つの演算子にデータベースの複数の列を含めるには、その組み合わせを表す匿名型を作成する必要があります。  
+  
+## 使用例  
+ `GroupBy` 演算子を使用するクエリを次の例に示します。この演算子は、1 つの `key` 引数だけを受け取ることができます。  
+  
+ [!code-csharp[DLinqCompositeKeys#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCompositeKeys/cs/Program.cs#1)]
+ [!code-vb[DLinqCompositeKeys#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCompositeKeys/vb/Module1.vb#1)]  
+  
+## 使用例  
+ 次の例に示すように、結合の場合も同様です。  
+  
+ [!code-csharp[DLinqCompositeKeys#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCompositeKeys/cs/Program.cs#2)]
+ [!code-vb[DLinqCompositeKeys#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCompositeKeys/vb/Module1.vb#2)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-insert-rows-into-the-database.md b/docs/framework/data/adonet/sql/linq/how-to-insert-rows-into-the-database.md
new file mode 100644
index 00000000000..206f0df9a8f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-insert-rows-into-the-database.md
@@ -0,0 +1,47 @@
+---
+title: "How to: Insert Rows Into the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 44d99680-69c7-4879-a732-f6771b334211
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Insert Rows Into the Database
+関連付けられた [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Table%601> コレクションにオブジェクトを追加し、その変更内容をデータベースに送信することで、データベースに行を挿入できます。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、変更内容が SQL の `INSERT` コマンドに適切に変換されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の `Insert`、`Update`、および `Delete` の既定のデータベース操作メソッドはオーバーライドできます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+>   
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、同じ用途のストアド プロシージャを開発できます。  
+  
+ 以下の手順では、有効な <xref:System.Data.Linq.DataContext> で Northwind データベースに接続されるものと想定しています。  詳細については、「[How to: Connect to a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md)」を参照してください。  
+  
+### 行をデータベースに挿入するには  
+  
+1.  送信する列データを含む新しいオブジェクトを作成します。  
+  
+2.  データベース内の挿入先テーブルに関連付けられた [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] `Table` コレクションに新しいオブジェクトを追加します。  
+  
+3.  データベースに変更内容を送信します。  
+  
+## 使用例  
+ 次のサンプル コードでは、`Order` 型の新しいオブジェクトを作成し、適切な値をこのオブジェクトに設定します。  その後で、新しいオブジェクトを `Order` コレクションに追加します。  最後にこの変更内容を `Orders` テーブルの新しい行としてデータベースに送信します。  
+  
+ [!code-csharp[System.Data.Linq.Table#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.table/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.Table#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [DataContext Methods \(O\/R Designer\)](../Topic/DataContext%20Methods%20\(O-R%20Designer\).md)   
+ [How to: Assign Stored Procedures to Perform Updates, Inserts, and Deletes \(O\/R Designer\)](../Topic/How%20to:%20Assign%20stored%20procedures%20to%20perform%20updates,%20inserts,%20and%20deletes%20\(O-R%20Designer\).md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md b/docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md
new file mode 100644
index 00000000000..5b4640ac12f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md
@@ -0,0 +1,39 @@
+---
+title: "How to: Make Entities Serializable | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6c5bf6e-064a-4f77-b74c-76b3a5dec309
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Make Entities Serializable
+コードを作成するときに、エンティティをシリアル化可能にできます。  エンティティ クラスは <xref:System.Runtime.Serialization.DataContractAttribute> 属性で装飾し、列は <xref:System.Runtime.Serialization.DataMemberAttribute> 属性で装飾します。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してこれを実現できます。  
+  
+ SQLMetal コマンド ライン ツールを使用する場合は、**\/serialization** オプションに引数 `unidirectional` を指定します。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 使用例  
+ 次の SQLMetal コマンド ラインでは、シリアル化可能なエンティティを持つファイルが作成されます。  
+  
+```  
+sqlmetal /code:nwserializable.vb /language:vb "c:\northwnd.mdf" /sprocs /functions /pluralize /serialization:unidirectional  
+```  
+  
+```  
+sqlmetal /code:nwserializable.cs /language:csharp "c:\northwnd.mdf" /sprocs /functions /pluralize /serialization:unidirectional  
+```  
+  
+## 参照  
+ [Serialization](../../../../../../docs/framework/data/adonet/sql/linq/serialization.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md b/docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md
new file mode 100644
index 00000000000..9ff9b740325
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md
@@ -0,0 +1,49 @@
+---
+title: "How to: Manage Change Conflicts | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd292c51-a3d1-4c6f-8d8e-04323c36054e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Manage Change Conflicts
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には、同時実行の競合の発見、評価、および解決に使用できる API が用意されています。  
+  
+## このセクションの内容  
+ [How to: Detect and Resolve Conflicting Submissions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-detect-and-resolve-conflicting-submissions.md)  
+ 同時実行の競合を検出および解決する方法を説明します。  
+  
+ [How to: Specify When Concurrency Exceptions are Thrown](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md)  
+ 同時実行の競合をいつ通知するかを指定する方法を説明します。  
+  
+ [How to: Specify Which Members are Tested for Concurrency Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md)  
+ メンバーに属性を設定して、そのメンバーで同時実行の競合をチェックするかどうかを指定する方法を説明します。  
+  
+ [How to: Retrieve Entity Conflict Information](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-entity-conflict-information.md)  
+ エンティティの競合に関する情報を収集する方法を説明します。  
+  
+ [How to: Retrieve Member Conflict Information](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-member-conflict-information.md)  
+ メンバーの競合に関する情報を収集する方法を説明します。  
+  
+ [How to: Resolve Conflicts by Retaining Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md)  
+ 現在の値をデータベースの値で上書きする方法を説明します。  
+  
+ [How to: Resolve Conflicts by Overwriting Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md)  
+ データベースの値を上書きして現在の値を維持する方法を説明します。  
+  
+ [How to: Resolve Conflicts by Merging with Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-merging-with-database-values.md)  
+ データベースの値と現在の値をマージして競合を解決する方法を説明します。  
+  
+## 関連項目  
+ [Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のオプティミスティック同時実行制御で使用される用語を説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-map-database-relationships.md b/docs/framework/data/adonet/sql/linq/how-to-map-database-relationships.md
new file mode 100644
index 00000000000..cefadff0666
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-map-database-relationships.md
@@ -0,0 +1,62 @@
+---
+title: "How to: Map Database Relationships | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 538def39-8399-46fb-b02d-60ede4e050af
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Map Database Relationships
+データ リレーションシップが常に同じ場合は、これをエンティティ クラス内のプロパティ参照としてエンコードできます。  たとえば、Northwind サンプル データベースでは、通常は顧客が注文を発注するため、モデルには、顧客と注文のリレーションシップが常に存在します。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Data.Linq.Mapping.AssociationAttribute> 属性を定義して、このようなリレーションシップを表します。  この属性を、<xref:System.Data.Linq.EntitySet%601> 型および <xref:System.Data.Linq.EntityRef%601> 型と共に使用することで、データベース内の外部キー リレーションシップが表されます。詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」の「Association 属性」セクションを参照してください。  
+  
+> [!NOTE]
+>  AssociationAttribute プロパティ値と ColumnAttribute Storage プロパティ値では大文字と小文字が区別されます。  たとえば、AssociationAttribute.Storage  プロパティの属性に使用されている値は、コード内の別の場所で使用されている対応するプロパティ名と、大文字と小文字が一致するようにしてください。  これは、[!INCLUDE[vb_current_short](../../../../../../includes/vb-current-short-md.md)] など、通常は大文字と小文字が区別されない言語を含むすべての .NET プログラミング言語に適用されます。  Storage プロパティの詳細については、「<xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A?displayProperty=fullName>」を参照してください。  
+  
+ ほとんどのリレーションシップは、このトピックの例のように、一対多のリレーションシップです。  次に示すように、一対一および多対多のリレーションシップも表すことができます。  
+  
+-   一対一 : 両側に <xref:System.Data.Linq.EntitySet%601> を指定することによって、この種類のリレーションシップを表します。  
+  
+     たとえば、顧客のセキュリティ コードが `Customer` テーブルには表示されず、承認されたユーザーのみがアクセスできるようにするために作成された、`SecurityCode`\-`Customer` リレーションシップがその例です。  
+  
+-   多対多 : 多対多リレーションシップでは、リンク テーブル \(*結合*テーブルともいいます\) の主キーは、多くの場合、他の 2 つのテーブルの外部キーが結合して作成されます。  
+  
+     たとえば、リンク テーブル `Employee` を使用して作成される `Project`\-`EmployeeProject` という多対多リレーションシップがあるとします。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、このようなリレーションシップを、`Employee`、`Project`、および `EmployeeProject` という 3 つのクラスを使用してモデル化する必要があります。  この場合、`Employee` と `Project` の間のリレーションシップを変更すると、主キーの `EmployeeProject` の更新が必要であるように見える可能性がありす。  ただし、この状態は、既存の `EmployeeProject` の削除、および新しい `EmployeeProject` の作成として適切にモデル化されます。  
+  
+    > [!NOTE]
+    >  リレーショナル データベース内のリレーションシップは、通常、他のテーブルの主キーを参照する外部キー値としてモデル化されます。  それらの間を移動するには、リレーショナル*結合*演算を使用して、2 つのテーブルを明示的に関連付けます。  
+    >   
+    >  これに対して、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 内のオブジェクトは、*ドット*表記を使用して移動するプロパティ参照または参照のコレクションを使用して、互いを参照します。  
+  
+## 使用例  
+ 次の一対多の例では、`Customer` クラスは、顧客とその注文のリレーションシップを宣言するプロパティを持ちます。  `Orders` プロパティは <xref:System.Data.Linq.EntitySet%601> 型です。  この型は、このリレーションシップが一対多 \(1 人の顧客対多くの注文\) であることを意味します。  <xref:System.Data.Linq.Mapping.AssociationAttribute.OtherKey%2A> プロパティを使用して、この関連付けを実現する方法を記述します。つまり、これと比較する、関連クラス内のプロパティの名前を指定します。  この例では、データベース`CustomerID`結合がその列値を比較するときに、 *プロパティが比較されます。*  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してクラス間の関連付けを作成できます。  
+  
+ [!code-csharp[DlinqCustomize#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCustomize/cs/Program.cs#3)]
+ [!code-vb[DlinqCustomize#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb#3)]  
+  
+## 使用例  
+ 逆の場合も可能です。  `Customer` クラスを使用して顧客と注文の関連付けを記述するのではなく、`Order` クラスを使用できます。  `Order` クラスは、<xref:System.Data.Linq.EntityRef%601> 型を使用して、次のコード例に示すように、顧客へのリレーションシップを記述できます。  
+  
+> [!NOTE]
+>  <xref:System.Data.Linq.EntityRef%601> クラスは、*遅延読み込み*をサポートします。  詳細については、*「*[Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)」を参照してください。  
+  
+ [!code-csharp[DLinqCustomize#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCustomize/cs/Program.cs#5)]
+ [!code-vb[DLinqCustomize#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb#5)]  
+  
+## 参照  
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)   
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md b/docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md
new file mode 100644
index 00000000000..4d9fce23309
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md
@@ -0,0 +1,59 @@
+---
+title: "How to: Map Inheritance Hierarchies | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b27c779b-9355-4dc7-b95f-7dfd504b6e48
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# How to: Map Inheritance Hierarchies
+[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] で継承の割り当てを実装するには、以下の手順で示すように、継承階層のルート クラスで属性および属性プロパティを指定する必要があります。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して継承階層を割り当てることができます。  「[How to: Configure Inheritance by Using the O\/R Designer](../Topic/How%20to:%20Configure%20inheritance%20by%20using%20the%20O-R%20Designer.md)」を参照してください。  
+  
+> [!NOTE]
+>  サブクラスには特別な属性やプロパティは必要ありません。  特に、サブクラスに <xref:System.Data.Linq.Mapping.TableAttribute> 属性がない点に注意してください。  
+  
+### 継承階層を割り当てるには  
+  
+1.  ルート クラスに <xref:System.Data.Linq.Mapping.TableAttribute> 属性を追加します。  
+  
+2.  ルート クラスに対し、階層構造の各クラスについて <xref:System.Data.Linq.Mapping.InheritanceMappingAttribute> 属性を追加します。  
+  
+3.  各 <xref:System.Data.Linq.Mapping.InheritanceMappingAttribute> 属性に対し、<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Code%2A> プロパティを定義します。  
+  
+     このプロパティは、データベース テーブルの <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDiscriminator%2A> 列に含まれる値を保持し、このデータ行が属するクラスまたはサブクラスを示します。  
+  
+4.  各 <xref:System.Data.Linq.Mapping.InheritanceMappingAttribute> 属性に対し、<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Type%2A> プロパティも追加します。  
+  
+     このプロパティは、キー値が示すクラスまたはサブクラスを表す値を保持します。  
+  
+5.  1 つの <xref:System.Data.Linq.Mapping.InheritanceMappingAttribute> 属性にのみ、<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.IsDefault%2A> プロパティを追加します。  
+  
+     このプロパティは、データベース テーブルから取得された識別値が、継承の割り当てのいずれの *フォールバック* 値にも一致しない場合に使用する、<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Code%2A>用の割り当てを示します。  
+  
+6.  <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDiscriminator%2A> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute> プロパティを追加します。  
+  
+     このプロパティは、<xref:System.Data.Linq.Mapping.InheritanceMappingAttribute.Code%2A> 値を保持する列であることを示します。  
+  
+## 使用例  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して継承を構成できます。  「[How to: Configure Inheritance by Using the O\/R Designer](../Topic/How%20to:%20Configure%20inheritance%20by%20using%20the%20O-R%20Designer.md)」を参照してください。  
+  
+ 次のコード例では、`Vehicle` をルート クラスとして定義し、ここまでの手順を実装して、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] の階層構造を指定します。  
+  
+ [!code-csharp[DLinqCustomize#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCustomize/cs/Program.cs#4)]
+ [!code-vb[DLinqCustomize#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb#4)]  
+  
+## 参照  
+ [Inheritance Support](../../../../../../docs/framework/data/adonet/sql/linq/inheritance-support.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-query-for-information.md b/docs/framework/data/adonet/sql/linq/how-to-query-for-information.md
new file mode 100644
index 00000000000..98eb435c7fe
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-query-for-information.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Query for Information | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e538d288-2070-40ca-9da6-4fbc68cd6ad0
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Query for Information
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリでは、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリと同じ構文を使用します。  異なる点は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリ内で参照されるオブジェクトは、データベース内の要素に割り当てられるという点だけです。  詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、作成したクエリを同等の SQL クエリに変換し、それをサーバーに送って処理します。  
+  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリの機能の中には、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションで特に注意を要するものがあります。  詳細については、「[Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)」を参照してください。  
+  
+## 使用例  
+ 次のクエリは、ロンドンからの顧客のリストを取得します。  この例の `Customers` は、Northwind サンプル データベース内のテーブルです。  
+  
+ [!code-csharp[DLinqQuerying#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#1)]
+ [!code-vb[DLinqQuerying#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#1)]  
+  
+## 参照  
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-allowing-null-values.md b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-allowing-null-values.md
new file mode 100644
index 00000000000..cc48d4dea26
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-allowing-null-values.md
@@ -0,0 +1,32 @@
+---
+title: "How to: Represent Columns as Allowing Null Values | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ebb71a37-1f4c-4fa7-b2d2-d903f13c4af1
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Columns as Allowing Null Values
+データベース列が null 値を保持できることを指定するには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の <xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A> プロパティを使用します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A>」を参照してください。  
+  
+### null 値を許可する列を指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.CanBeNull%2A> プロパティ値を `true` に設定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-class-members.md b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-class-members.md
new file mode 100644
index 00000000000..bb70f82b796
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-class-members.md
@@ -0,0 +1,36 @@
+---
+title: "How to: Represent Columns as Class Members | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7ab28021-4d15-4d9c-bf2e-6ccc0daa7d1a
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Columns as Class Members
+フィールドまたはプロパティをデータベース列に関連付けるには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性を使用します。  
+  
+### フィールドまたはプロパティをデータベース列に対応付けるには  
+  
+-   プロパティまたはフィールドの宣言に <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性を追加します。  
+  
+## 使用例  
+ 次の例では、`Customer` クラス内の `CustomerID` フィールドを `Customers` データベース テーブル内の `CustomerID` 列に対応付けます。  
+  
+ [!code-csharp[DLinqCustomize#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCustomize/cs/Program.cs#2)]
+ [!code-vb[DLinqCustomize#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb#2)]  
+  
+ 名前が推論できる場合は、<xref:System.Data.Linq.Mapping.DataAttribute.Name%2A> プロパティを指定する必要はありません。  名前を指定しない場合は、プロパティまたはフィールドと同じ名前であると見なされます。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-database-generated.md b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-database-generated.md
new file mode 100644
index 00000000000..dfdf01ea8b9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-database-generated.md
@@ -0,0 +1,32 @@
+---
+title: "How to: Represent Columns as Database-Generated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6524b8a6-e5d2-4a3b-8e08-beafc4a84fd2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Columns as Database-Generated
+データベース生成列を表すフィールドまたはプロパティを指定するには、<xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A> プロパティを使用します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A>」を参照してください。  
+  
+### データベース生成列を表すフィールドまたはプロパティを指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.IsDbGenerated%2A> プロパティを追加します。  
+  
+2.  プロパティ値を `true` に設定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-timestamp-or-version-columns.md b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-timestamp-or-version-columns.md
new file mode 100644
index 00000000000..869772b8c7f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-columns-as-timestamp-or-version-columns.md
@@ -0,0 +1,33 @@
+---
+title: "How to: Represent Columns as Timestamp or Version Columns | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5afd5ce8-1d20-4bc3-a34f-49d95449f493
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Columns as Timestamp or Version Columns
+<xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> プロパティを使用して、データベースのタイムスタンプまたはバージョン番号を保持するデータベース列を表すフィールドまたはプロパティを指定します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A>」を参照してください。  
+  
+### タイムスタンプ列またはバージョン列を表すフィールドまたはプロパティを指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A> プロパティ値を `true` に設定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Specify Which Members are Tested for Concurrency Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-computed-columns.md b/docs/framework/data/adonet/sql/linq/how-to-represent-computed-columns.md
new file mode 100644
index 00000000000..48511b7c85f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-computed-columns.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Represent Computed Columns | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4025f1fd-9dfa-46c0-b04f-34e8bc7957a2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Computed Columns
+計算の結果が格納される列を表すには、<xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A> プロパティを使用します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A>」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、計算列は主キーとしてサポートされません。  
+  
+### 計算列を表すには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.Expression%2A> プロパティに数式を表す文字列を代入します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-primary-keys.md b/docs/framework/data/adonet/sql/linq/how-to-represent-primary-keys.md
new file mode 100644
index 00000000000..6f7cd256d7e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-primary-keys.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Represent Primary Keys | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63c65289-6539-42b2-8493-891c232018fa
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Primary Keys
+データベース列の主キーを表すプロパティまたはフィールドを指定するには、<xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A> プロパティを使用します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A>」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、計算列は主キーとしてサポートされません。  
+  
+### プロパティまたはフィールドを主キーとして指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A> プロパティを追加します。  
+  
+2.  値として `true` を指定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-represent-tables-as-classes.md b/docs/framework/data/adonet/sql/linq/how-to-represent-tables-as-classes.md
new file mode 100644
index 00000000000..cef09f45c05
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-represent-tables-as-classes.md
@@ -0,0 +1,36 @@
+---
+title: "How to: Represent Tables as Classes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84dda12b-88a2-4cd2-92b3-8db87b28d14c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Represent Tables as Classes
+データベース テーブルに関連付けられたエンティティ クラスとしてクラスを指定するには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.TableAttribute> 属性を使用します。  
+  
+### データベース テーブルにクラスを対応付けるには  
+  
+-   クラス宣言に <xref:System.Data.Linq.Mapping.TableAttribute> 属性を追加します。  
+  
+## 使用例  
+ 次のコードでは、`Customers` データベース テーブルに関連付けられたエンティティ クラスとして、`Customer` クラスを確立します。  
+  
+ [!code-csharp[DLinqCustomize#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCustomize/cs/Program.cs#1)]
+ [!code-vb[DLinqCustomize#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb#1)]  
+  
+ 名前が推論できる場合は、<xref:System.Data.Linq.Mapping.TableAttribute.Name%2A> プロパティを指定する必要はありません。  名前を指定しない場合は、プロパティまたはフィールドと同じ名前であると見なされます。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-merging-with-database-values.md b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-merging-with-database-values.md
new file mode 100644
index 00000000000..d6626f5b8a1
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-merging-with-database-values.md
@@ -0,0 +1,50 @@
+---
+title: "How to: Resolve Conflicts by Merging with Database Values | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1988b79c-3bfc-4c5c-a08a-86cf638bbe17
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Resolve Conflicts by Merging with Database Values
+変更内容を再送信する前に、データベース内の予期した値と実際の値の違いを調整するために、<xref:System.Data.Linq.RefreshMode> を使用して、データベース内の値を現在のクライアント メンバー値とマージできます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  どの場合も、データベースから最新のデータを取得することで、まずクライアントのレコードが更新されます。  この処理によって、次の更新処理が同じ同時実行チェックで失敗することを防止できます。  
+  
+## 使用例  
+ このシナリオでは、ユーザー 1 が変更内容を送信しようとしたときに <xref:System.Data.Linq.ChangeConflictException> 例外がスローされます。途中でユーザー 2 が Assistant 列と Department  列を変更したためです。  次の表は、この状況を示しています。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|ユーザー 1 およびユーザー 2 が照会した最初のデータベース状態|Alfreds|Maria|Sales|  
+|ユーザー 1 が送信しようとした変更内容|Alfred||Marketing|  
+|ユーザー 2 が既に送信した変更内容||Mary|サービス|  
+  
+ ユーザー 1 は、この競合を解決するために、データベース値を現在のクライアント メンバー値にマージすることに決めます。  その結果、現在の変更セットでも値が変更されているデータベース値のみが上書きされます。  
+  
+ ユーザー 1 が <xref:System.Data.Linq.RefreshMode> を使用して競合を解決すると、データベース内の結果は次の表のようになります。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|競合解決後の新しい状態|Alfred<br /><br /> \(ユーザー 1 の値\)|Mary<br /><br /> \(ユーザー 2 の値\)|Marketing<br /><br /> \(ユーザー 1 の値\)|  
+  
+ 次の例では、クライアントでも値が変更されている場合を除き、データベース値を現在のクライアント メンバー値にマージする方法を示しています。  個別のメンバーの競合に対する検査やカスタム ハンドリングは発生しません。  
+  
+ [!code-csharp[System.Data.Linq.RefreshMode#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.refreshmode/cs/program.cs#3)]
+ [!code-vb[System.Data.Linq.RefreshMode#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/module1.vb#3)]  
+  
+## 参照  
+ [How to: Resolve Conflicts by Overwriting Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md)   
+ [How to: Resolve Conflicts by Retaining Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md)   
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md
new file mode 100644
index 00000000000..19d58c34135
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md
@@ -0,0 +1,48 @@
+---
+title: "How to: Resolve Conflicts by Overwriting Database Values | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd6db0b8-c29c-48ff-b768-31d28e7a148c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Resolve Conflicts by Overwriting Database Values
+変更を再送信する前に、データベース内の予期した値と実際の値の違いを調整するために、<xref:System.Data.Linq.RefreshMode> を使用してデータベース内の値を上書きできます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  どの場合も、データベースから最新のデータを取得することで、まずクライアントのレコードが更新されます。  この処理によって、次の更新処理が同じ同時実行チェックで失敗することを防止できます。  
+  
+## 使用例  
+ このシナリオでは、ユーザー 1 が変更を送信しようとしたときに <xref:System.Data.Linq.ChangeConflictException> 例外がスローされます。これは、途中でユーザー 2 が Assistant 列と Department 列を変更していたためです。  次の表は、この状況を示しています。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|ユーザー 1 およびユーザー 2 が照会した最初のデータベース状態|Alfreds|Maria|Sales|  
+|ユーザー 1 が送信しようとした変更内容|Alfred||Marketing|  
+|ユーザー 2 が既に送信した変更内容||Mary|サービス|  
+  
+ ユーザー 1 は、この競合を解決するために、データベース値を現在のクライアント メンバー値で上書きすることに決めます。  
+  
+ ユーザー 1 が <xref:System.Data.Linq.RefreshMode> を使用して競合を解決すると、データベース内の結果は次の表のようになります。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|競合解決後の新しい状態|Alfred<br /><br /> \(ユーザー 1 の値\)|Maria<br /><br /> \(元の値\)|Marketing<br /><br /> \(ユーザー 1 の値\)|  
+  
+ 次のコード例は、データベース値を現在のクライアント メンバー値で上書きする方法を示しています   \(個々のメンバーの競合に対する検査やカスタム ハンドリングは行われません\)。  
+  
+ [!code-csharp[System.Data.Linq.RefreshMode#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.refreshmode/cs/program.cs#2)]
+ [!code-vb[System.Data.Linq.RefreshMode#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/module1.vb#2)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md
new file mode 100644
index 00000000000..e04851a7b97
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md
@@ -0,0 +1,48 @@
+---
+title: "How to: Resolve Conflicts by Retaining Database Values | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b475cf72-9e64-4f6e-99c1-af7737bc85ef
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Resolve Conflicts by Retaining Database Values
+変更内容を再送信する前に、データベース内の予期した値と実際の値の違いを調整するために、<xref:System.Data.Linq.RefreshMode> を使用することで、データベース内の値を維持できます。  この場合、オブジェクト モデル内の現在の値は上書きされます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  どの場合も、データベースから最新のデータを取得することで、まずクライアントのレコードが更新されます。  この処理によって、次の更新処理が同じ同時実行チェックで失敗することを防止できます。  
+  
+## 使用例  
+ このシナリオでは、ユーザー 1 が変更内容を送信しようとしたときに <xref:System.Data.Linq.ChangeConflictException> 例外がスローされます。途中でユーザー 2 が Assistant 列と Department  列を変更したためです。  次の表は、この状況を示しています。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|ユーザー 1 およびユーザー 2 が照会した最初のデータベース状態|Alfreds|Maria|Sales|  
+|ユーザー 1 が送信しようとした変更内容|Alfred||Marketing|  
+|ユーザー 2 が既に送信した変更内容||Mary|サービス|  
+  
+ ユーザー 1 は、この競合を解決するために、新しいデータベース値でオブジェクト モデルの現在の値を上書きすることに決めます。  
+  
+ ユーザー 1 が <xref:System.Data.Linq.RefreshMode> を使用して競合を解決すると、データベース内の結果は次の表のようになります。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|競合解決後の新しい状態|Alfreds<br /><br /> \(元の値\)|Mary<br /><br /> \(ユーザー 2 の値\)|サービス<br /><br /> \(ユーザー 2 の値\)|  
+  
+ オブジェクト モデルの現在の値をデータベース値で上書きする方法を次のコード例に示します   \(個々のメンバーの競合に対する検査やカスタム ハンドリングは行われません\)。  
+  
+ [!code-csharp[System.Data.Linq.RefreshMode#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.refreshmode/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.RefreshMode#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-retrieve-entity-conflict-information.md b/docs/framework/data/adonet/sql/linq/how-to-retrieve-entity-conflict-information.md
new file mode 100644
index 00000000000..7f32bd5ab30
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-retrieve-entity-conflict-information.md
@@ -0,0 +1,29 @@
+---
+title: "How to: Retrieve Entity Conflict Information | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a02b608-e7bb-4041-a452-a7fed26fd008
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Retrieve Entity Conflict Information
+<xref:System.Data.Linq.ObjectChangeConflict> クラスのオブジェクトを使用して、<xref:System.Data.Linq.ChangeConflictException> 例外によって発生する競合に関する情報を提供できます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、累積した競合のリストを反復処理します。  
+  
+ [!code-csharp[System.Data.Linq.ObjectChangeConflict#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.objectchangeconflict/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.ObjectChangeConflict#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.objectchangeconflict/vb/module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-retrieve-information-as-read-only.md b/docs/framework/data/adonet/sql/linq/how-to-retrieve-information-as-read-only.md
new file mode 100644
index 00000000000..97b2f922220
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-retrieve-information-as-read-only.md
@@ -0,0 +1,36 @@
+---
+title: "How to: Retrieve Information As Read-Only | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb09e298-0b53-47e5-97fb-ab318bcd4fad
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Retrieve Information As Read-Only
+データを変更する予定がない場合は、読み取り専用の結果を取得することでクエリのパフォーマンスを向上させることができます。  
+  
+ 読み取り専用の処理を実装するには、<xref:System.Data.Linq.DataContext.ObjectTrackingEnabled%2A> を `false` に設定します。  
+  
+> [!NOTE]
+>  <xref:System.Data.Linq.DataContext.ObjectTrackingEnabled%2A> を `false` に設定すると、<xref:System.Data.Linq.DataContext.DeferredLoadingEnabled%2A> が暗黙的に `false` に設定されます。  
+  
+## 使用例  
+ 次のコード例は、従業員の入社日の読み取り専用コレクションを取得します。  
+  
+ [!code-csharp[DLinqQuerying#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#2)]
+ [!code-vb[DLinqQuerying#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#2)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)   
+ [Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-retrieve-many-objects-at-once.md b/docs/framework/data/adonet/sql/linq/how-to-retrieve-many-objects-at-once.md
new file mode 100644
index 00000000000..e8bcecef9ad
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-retrieve-many-objects-at-once.md
@@ -0,0 +1,29 @@
+---
+title: "How to: Retrieve Many Objects At Once | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 18aff4d8-bde8-461b-9960-ccabb24e9d22
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Retrieve Many Objects At Once
+多くのオブジェクトを 1 つのクエリで取得するには、<xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> を使用します。  
+  
+## 使用例  
+ <xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> メソッドを使用して、`Customer` と `Order` の両方を取得するコードの例を次に示します。  
+  
+ [!code-csharp[DLinqQueryConcepts#9](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#9)]
+ [!code-vb[DLinqQueryConcepts#9](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#9)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-retrieve-member-conflict-information.md b/docs/framework/data/adonet/sql/linq/how-to-retrieve-member-conflict-information.md
new file mode 100644
index 00000000000..5098e61b294
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-retrieve-member-conflict-information.md
@@ -0,0 +1,32 @@
+---
+title: "How to: Retrieve Member Conflict Information | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7dd6829e-79a5-4480-9023-9e588cb0bf2e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Retrieve Member Conflict Information
+<xref:System.Data.Linq.MemberChangeConflict> クラスを使用すると、競合する個々のメンバーに関する情報を取得できます。  この同じコンテキストで、メンバーの競合の処理をカスタマイズできます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードでは、<xref:System.Data.Linq.ObjectChangeConflict> オブジェクトを反復処理します。  オブジェクトごとに、次に <xref:System.Data.Linq.MemberChangeConflict> オブジェクトを反復処理します。  
+  
+> [!NOTE]
+>  <xref:System.Data.Linq.MemberChangeConflict.Member%2A> 情報を提供するには、<xref:System.Reflection> を含めます。  
+  
+ [!code-csharp[System.Data.Linq.MemberChangeConflict#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.memberchangeconflict/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.MemberChangeConflict#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.memberchangeconflict/vb/module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-return-rowsets.md b/docs/framework/data/adonet/sql/linq/how-to-return-rowsets.md
new file mode 100644
index 00000000000..e711697d669
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-return-rowsets.md
@@ -0,0 +1,45 @@
+---
+title: "How to: Return Rowsets | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 725718f5-da29-4841-9f53-aafef64ba977
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Return Rowsets
+この例では、データベースから行セットを返し、入力パラメーターを使用して結果をフィルター処理します。  
+  
+ 行セットを返すストアド プロシージャを実行する場合は、ストアド プロシージャからの戻り値を格納する*結果*クラスを使用します。  詳細については、「[Analyzing LINQ to SQL Source Code](../../../../../../docs/framework/data/adonet/sql/linq/analyzing-linq-to-sql-source-code.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、顧客の行を返し、入力パラメーターを使用して、顧客が在住する市が "London" である行のみを返すストアド プロシージャを示しています。  例では、列挙可能な `CustomersByCityResult` クラスを想定しています。  
+  
+```  
+CREATE PROCEDURE [dbo].[Customers By City]  
+    (@param1 NVARCHAR(20))  
+AS  
+BEGIN  
+    -- SET NOCOUNT ON added to prevent extra result sets from  
+    -- interfering with SELECT statements.  
+    SET NOCOUNT ON;  
+    SELECT CustomerID, ContactName, CompanyName, City from Customers  
+        as c where c.City=@param1  
+END  
+```  
+  
+ [!code-csharp[DLinqSprox#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/northwind-sprox.cs#1)]
+ [!code-vb[DLinqSprox#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/northwind-sprox.vb#1)]  
+  
+## 参照  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md b/docs/framework/data/adonet/sql/linq/how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md
new file mode 100644
index 00000000000..74dd8ce124e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-reuse-a-connection-between-an-ado-net-command-and-a-datacontext.md
@@ -0,0 +1,31 @@
+---
+title: "How to: Reuse a Connection Between an ADO.NET Command and a DataContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e26c7eb-c18a-43b5-a8f0-28fd8b04b0f0
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Reuse a Connection Between an ADO.NET Command and a DataContext
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] テクノロジ ファミリの一部であり、[!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] によって提供されるサービスに基づいているため、[!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] コマンドおよび <xref:System.Data.Linq.DataContext> 間の接続を再利用できます。  
+  
+## 使用例  
+ [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] コマンドおよび <xref:System.Data.Linq.DataContext> 間の同じ接続を再利用する方法を次の例に示します。  
+  
+ [!code-csharp[DLinqCommunicatingWithDatabase#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCommunicatingWithDatabase/cs/Program.cs#4)]
+ [!code-vb[DLinqCommunicatingWithDatabase#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCommunicatingWithDatabase/vb/Module1.vb#4)]  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [ADO.NET and LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/ado-net-and-linq-to-sql.md)   
+ [Communicating with the Database](../../../../../../docs/framework/data/adonet/sql/linq/communicating-with-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-concurrency-conflict-checking.md b/docs/framework/data/adonet/sql/linq/how-to-specify-concurrency-conflict-checking.md
new file mode 100644
index 00000000000..b3b7ea06586
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-concurrency-conflict-checking.md
@@ -0,0 +1,30 @@
+---
+title: "How to: Specify Concurrency-Conflict Checking | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2547fcb-58eb-4377-9948-1b8d76a0f3d7
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify Concurrency-Conflict Checking
+<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すときに同時実行の競合をチェックするデータベース列を指定できます。  詳細については、「[How to: Specify Which Members are Tested for Concurrency Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md)」を参照してください。  
+  
+## 使用例  
+ 次のコード例では、更新の確認時に `HomePage` メンバーを検査しないことを指定しています。  詳細については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A>」を参照してください。  
+  
+ [!code-csharp[System.Data.Linq.Mapping.UpdateCheck#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.mapping.updatecheck/cs/northwind.cs#1)]
+ [!code-vb[System.Data.Linq.Mapping.UpdateCheck#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/northwind.vb#1)]  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-database-data-types.md b/docs/framework/data/adonet/sql/linq/how-to-specify-database-data-types.md
new file mode 100644
index 00000000000..059e5b96b33
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-database-data-types.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Specify Database Data Types | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2228fdad-7e6a-4b1b-b4d1-79d0198b7c28
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify Database Data Types
+<xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A> プロパティを使用して、T\-SQL テーブル宣言に列を定義する正確なテキストを指定します。  
+  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A> プロパティは、<xref:System.Data.Linq.DataContext.CreateDatabase%2A> を使用してデータベースのインスタンスを作成することを予定している場合のみ指定する必要があります。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A>」を参照してください。  
+  
+### データ型を T\-SQL テーブルに定義するテキストを指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.DbType%2A> プロパティの値を T\-SQL で使用される正確なテキストに設定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-database-names.md b/docs/framework/data/adonet/sql/linq/how-to-specify-database-names.md
new file mode 100644
index 00000000000..0c157012781
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-database-names.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Specify Database Names | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b80f0fd2-7f75-45fe-9e12-496f80f183df
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify Database Names
+<xref:System.Data.Linq.Mapping.DatabaseAttribute> 属性の <xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> プロパティを使用すると、接続によってデータベースの名前が提供されない場合に、名前を指定できます。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A>」を参照してください。  
+  
+### データベースの名前を指定するには  
+  
+1.  データベースのクラス宣言に <xref:System.Data.Linq.Mapping.DatabaseAttribute> 属性を追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.DatabaseAttribute> 属性に <xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> プロパティを追加します。  
+  
+3.  <xref:System.Data.Linq.Mapping.DatabaseAttribute.Name%2A> プロパティ値を目的の名前に設定します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-private-storage-fields.md b/docs/framework/data/adonet/sql/linq/how-to-specify-private-storage-fields.md
new file mode 100644
index 00000000000..ea8bb0bc3fe
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-private-storage-fields.md
@@ -0,0 +1,32 @@
+---
+title: "How to: Specify Private Storage Fields | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a40e816-cc6e-43a0-b32a-9caaa0ab6912
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify Private Storage Fields
+基になるストレージ フィールドの名前を指定するには、<xref:System.Data.Linq.Mapping.DataAttribute> 属性の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] <xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A> プロパティを使用します。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A>」を参照してください。  
+  
+### 基になるストレージ フィールドの名前を指定するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A> プロパティを追加します。  
+  
+2.  フィールドの名前を <xref:System.Data.Linq.Mapping.DataAttribute.Storage%2A> プロパティの値として代入します。  
+  
+## 参照  
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md b/docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md
new file mode 100644
index 00000000000..db82fcfb854
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md
@@ -0,0 +1,38 @@
+---
+title: "How to: Specify When Concurrency Exceptions are Thrown | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 344ae068-ff63-4a2e-8b00-af22e143675f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify When Concurrency Exceptions are Thrown
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、オプティミスティック同時実行の競合によってオブジェクトが更新されないときに <xref:System.Data.Linq.ChangeConflictException> 例外がスローされます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+ 変更内容をデータベースに送信する前に、同時実行例外をどの時点でスローするかを指定できます。  
+  
+-   例外を最初のエラーの時点でスローします \(<xref:System.Data.Linq.ConflictMode>\)。  
+  
+-   更新の再試行を決められた回数繰り返し、すべてのエラー情報を集積してから、この情報を例外で報告します \(<xref:System.Data.Linq.ConflictMode>\)。  
+  
+ <xref:System.Data.Linq.ChangeConflictException> 例外がスローされると、例外を通じて <xref:System.Data.Linq.ChangeConflictCollection> コレクションにアクセスできます。  このコレクションを使用して、個々の競合 \(それぞれが 1 回の更新失敗に対応する\) の詳細情報を取得したり、<xref:System.Data.Linq.ObjectChangeConflict.MemberConflicts%2A> コレクションにアクセスしたりすることができます。  各メンバー競合は、同時実行チェックでエラーになった更新の 1 つのメンバーに対応します。  
+  
+## 使用例  
+ 両方の値の例を次のコードに示します。  
+  
+ [!code-csharp[System.Data.Linq.ConflictModeEnumeration#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.conflictmodeenumeration/cs/program.cs#1)]
+ [!code-vb[System.Data.Linq.ConflictModeEnumeration#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.conflictmodeenumeration/vb/module1.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md b/docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md
new file mode 100644
index 00000000000..f34f00c2f03
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md
@@ -0,0 +1,55 @@
+---
+title: "How to: Specify Which Members are Tested for Concurrency Conflicts | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d2cda293-1e2f-4878-af0e-5aaf0d092120
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Specify Which Members are Tested for Concurrency Conflicts
+オプティミスティック同時実行の競合を検出する更新チェックにどのメンバーを含めるかを指定するには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性の <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティに 3 つの列挙値のいずれか 1 つを適用します。  
+  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティ \(デザイン時に設定\) は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の実行時の同時実行機能と一緒に使用されます。  詳細については、「[Optimistic Concurrency: Overview](../../../../../../docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  `IsVersion=true` として指定されているメンバーがない限り、元のメンバーの各値は、データベースの現在の状態と比較されます。  詳細については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.IsVersion%2A>」を参照してください。  
+  
+ コード例については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A>」を参照してください。  
+  
+### 競合の検出でこのメンバーを常に使用するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティ値を `Always` に設定します。  
+  
+### 競合の検出でこのメンバーを使用しないようにするには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティ値を `Never` に設定します。  
+  
+### アプリケーションでメンバーの値が変更された場合にのみ、競合の検出でこのメンバーを使用するには  
+  
+1.  <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性に <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティを追加します。  
+  
+2.  <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A> プロパティ値を `WhenChanged` に設定します。  
+  
+## 使用例  
+ 次の例では、更新チェックで `HomePage` オブジェクトが検査されないように指定しています。  詳細については、「<xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A>」を参照してください。  
+  
+ [!code-csharp[System.Data.Linq.Mapping.UpdateCheck#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.mapping.updatecheck/cs/northwind.cs#1)]
+ [!code-vb[System.Data.Linq.Mapping.UpdateCheck#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/northwind.vb#1)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-store-and-reuse-queries.md b/docs/framework/data/adonet/sql/linq/how-to-store-and-reuse-queries.md
new file mode 100644
index 00000000000..c1f25669f6c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-store-and-reuse-queries.md
@@ -0,0 +1,43 @@
+---
+title: "How to: Store and Reuse Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a012bd79-1809-45e3-adea-0229532396cc
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Store and Reuse Queries
+同じ構造のクエリを何回も実行するアプリケーションでは、1 回コンパイルしたクエリを、パラメーターを変えて何回も実行する方が、多くの場合にパフォーマンスを向上できます。  たとえば、特定の市に住むすべての顧客を取得するアプリケーションで、ユーザーが、対象の市を実行時にフォームで指定するとします。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、この目的で、*コンパイル済みクエリ*の使用がサポートされています。  
+  
+> [!NOTE]
+>  コンパイル済みクエリは、このパターンの使用法が最も一般的です。  その他にも方法は考えられます。  たとえば、デザイナーによって生成されたコードを継承した部分クラスの静的メンバーとしてコンパイル済みクエリを格納するなどです。  
+  
+## 使用例  
+ スレッド境界を越えてクエリを再利用することが必要となる場合もよくあります。  その場合には、コンパイル済みクエリを静的変数に格納することは特に有効です。  次のコード例では、`Queries` クラスはコンパイル済みクエリを格納するためのクラスで、厳密に型指定された <xref:System.Data.Linq.DataContext> を表す Northwind クラスを使用することを想定しています。  
+  
+ [!code-csharp[DLinqQuerying#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#6)]
+ [!code-vb[DLinqQuerying#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#6)]  
+  
+ [!code-csharp[DLinqQuerying#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#7)]
+ [!code-vb[DLinqQuerying#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#7)]  
+  
+## 使用例  
+ 現時点では、*匿名型*を返すクエリを \(静的変数に\) 格納することはできません。型には汎用引数として指定する名前がないからです。  この問題を回避する方法を次の例に示します。結果を表すことのできる型を作成し、それを汎用引数として使用しています。  
+  
+ [!code-csharp[DLinqQuerying#8](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#8)]
+ [!code-vb[DLinqQuerying#8](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#8)]  
+  
+## 参照  
+ <xref:System.Data.Linq.CompiledQuery>   
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-submit-changes-to-the-database.md b/docs/framework/data/adonet/sql/linq/how-to-submit-changes-to-the-database.md
new file mode 100644
index 00000000000..d897cccb86b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-submit-changes-to-the-database.md
@@ -0,0 +1,44 @@
+---
+title: "How to: Submit Changes to the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7cba174-9d40-491d-b32c-f2d73b7e9eab
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Submit Changes to the Database
+オブジェクトに加えた変更は、その数にかかわらず、メモリ内のレプリカに対してのみ反映されています。  データベースの実際のデータは変更されていません。  <xref:System.Data.Linq.DataContext> の <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を明示的に呼び出すまでは、変更内容はサーバーに送信されません。  
+  
+ この呼び出しを行うと、<xref:System.Data.Linq.DataContext> は、変更内容を、同等の SQL コマンドに変換します。  独自のカスタム ロジックを使用してこれらの処理をオーバーライドすることもできますが、発行の順序は、*変更プロセッサ*と呼ばれる <xref:System.Data.Linq.DataContext> のサービスによって調整されています。  イベントの順序は次のとおりです。  
+  
+1.  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すと、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、一連の既知のオブジェクトをチェックして、新しいインスタンスがアタッチされているかどうかを判断します。  その場合、それらの新しいインスタンスが、一連の追跡対象オブジェクトに追加されます。  
+  
+2.  保留中の変更があるすべてのオブジェクトが、互いの依存関係に基づいて、オブジェクトのシーケンスに配置されます。  他のオブジェクトに依存して変更内容が決まるオブジェクトは、その依存対象の後でシーケンスに配置されます。  
+  
+3.  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、実際の変更を送信する直前に、一連の各コマンドをカプセル化するトランザクションを開始します。  
+  
+4.  オブジェクトに対する変更内容が 1 つずつ SQL コマンドに変換され、サーバーに送信されます。  
+  
+ この時点で、データベースによってエラーが検出された場合、送信処理は中断され、例外が発生します。  データベースに加えた変更はすべてロールバックされ、送信を行わなかった場合と同じ状態になります。  この時点でも、<xref:System.Data.Linq.DataContext> には、すべての変更内容の記録がそのまま残っています。  したがって、次のコード例のように、問題を修正したうえで <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を再度呼び出すことができます。  
+  
+## 使用例  
+ 一連の送信処理のトランザクションが正常に完了した場合、<xref:System.Data.Linq.DataContext> は、変更追跡情報を無視して、オブジェクトに対する変更を受け入れます。  
+  
+ [!code-csharp[DLinqSubmittingChanges#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSubmittingChanges/cs/Program.cs#1)]
+ [!code-vb[DLinqSubmittingChanges#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSubmittingChanges/vb/Module1.vb#1)]  
+  
+## 参照  
+ [How to: Detect and Resolve Conflicting Submissions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-detect-and-resolve-conflicting-submissions.md)   
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-turn-off-deferred-loading.md b/docs/framework/data/adonet/sql/linq/how-to-turn-off-deferred-loading.md
new file mode 100644
index 00000000000..125fe27652e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-turn-off-deferred-loading.md
@@ -0,0 +1,33 @@
+---
+title: "How to: Turn Off Deferred Loading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b84b852-3cad-41a7-8077-149a70d50c8b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Turn Off Deferred Loading
+<xref:System.Data.Linq.DataContext.DeferredLoadingEnabled%2A> を `false` に設定すると、遅延読み込みをオフにできます。  詳細については、「[Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)」を参照してください。  
+  
+> [!NOTE]
+>  遅延読み込みは、オブジェクト トラッキングをオフにすると暗黙でオフになります。  詳細については、「[How to: Retrieve Information As Read\-Only](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-information-as-read-only.md)」を参照してください。  
+  
+## 使用例  
+ <xref:System.Data.Linq.DataContext.DeferredLoadingEnabled%2A> を `false` に設定して、遅延読み込みをオフにする方法を次の例に示します。  
+  
+ [!code-csharp[DLinqQuerying#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQuerying/cs/Program.cs#3)]
+ [!code-vb[DLinqQuerying#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQuerying/vb/Module1.vb#3)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-update-rows-in-the-database.md b/docs/framework/data/adonet/sql/linq/how-to-update-rows-in-the-database.md
new file mode 100644
index 00000000000..2227bbeb10d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-update-rows-in-the-database.md
@@ -0,0 +1,46 @@
+---
+title: "How to: Update Rows in the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2b5c90f-6cc3-4128-bfab-1db488d5af26
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# How to: Update Rows in the Database
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の <xref:System.Data.Linq.Table%601> コレクションに関連付けられたオブジェクトのメンバーの値を変更し、その変更内容をデータベースに送信することで、データベースの行を更新できます。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、変更内容が SQL の `UPDATE` コマンドに適切に変換されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の `Insert`、`Update`、および `Delete` の既定のデータベース操作メソッドはオーバーライドできます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+>   
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、同じ用途のストアド プロシージャを開発できます。  
+  
+ 以下の手順では、有効な <xref:System.Data.Linq.DataContext> で Northwind データベースに接続されるものと想定しています。  詳細については、「[How to: Connect to a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-connect-to-a-database.md)」を参照してください。  
+  
+### データベースの行を更新するには  
+  
+1.  データベースで更新する行をクエリします。  
+  
+2.  結果として得られた [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクトのメンバー値に、必要な変更を加えます。  
+  
+3.  データベースに変更内容を送信します。  
+  
+## 使用例  
+ 次の例では、データベースの注文 \#11000 をクエリし、結果として得られた `ShipName` オブジェクトの `ShipVia` と `Order` の値を変更します。  次に、これらのメンバー値の変更内容を、`ShipName` 列と `ShipVia` 列に対する変更としてデータベースに送信します。  
+  
+ [!code-csharp[System.Data.Linq.Table#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/system.data.linq.table/cs/program.cs#2)]
+ [!code-vb[System.Data.Linq.Table#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/module1.vb#2)]  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)   
+ [How to: Assign Stored Procedures to Perform Updates, Inserts, and Deletes \(O\/R Designer\)](../Topic/How%20to:%20Assign%20stored%20procedures%20to%20perform%20updates,%20inserts,%20and%20deletes%20\(O-R%20Designer\).md)   
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-use-scalar-valued-user-defined-functions.md b/docs/framework/data/adonet/sql/linq/how-to-use-scalar-valued-user-defined-functions.md
new file mode 100644
index 00000000000..2f7f792a70c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-use-scalar-valued-user-defined-functions.md
@@ -0,0 +1,45 @@
+---
+title: "How to: Use Scalar-Valued User-Defined Functions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 714e252f-c053-4bbb-b1f3-924111cd4d97
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Use Scalar-Valued User-Defined Functions
+<xref:System.Data.Linq.Mapping.FunctionAttribute> 属性を使用することによって、クラスで定義されているクライアント メソッドを、ユーザー定義関数に対応付けることができます。  メソッドの本体は、メソッド呼び出しの目的を反映する式を構築し、変換および実行のためにその式を <xref:System.Data.Linq.DataContext> に渡します。  
+  
+> [!NOTE]
+>  直接実行は、関数がクエリの外部で呼び出される場合のみ発生します。  詳細については、「[How to: Call User\-Defined Functions Inline](../../../../../../docs/framework/data/adonet/sql/linq/how-to-call-user-defined-functions-inline.md)」を参照してください。  
+  
+## 使用例  
+ 次の SQL コードは、スカラー値のユーザー定義関数 `ReverseCustName()` を示しています。  
+  
+```  
+CREATE FUNCTION ReverseCustName(@string varchar(100))  
+RETURNS varchar(100)  
+AS  
+BEGIN  
+    DECLARE @custName varchar(100)  
+    -- Implementation left as exercise for users.  
+    RETURN @custName  
+END  
+```  
+  
+ このコードで、次のようなクライアント メソッドを対応付けます。  
+  
+ [!code-csharp[DLinqUDFS#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqUDFS/cs/northwind-tfunc.cs#3)]
+ [!code-vb[DLinqUDFS#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqUDFS/vb/northwind-tfunc.vb#3)]  
+  
+## 参照  
+ [User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/user-defined-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md
new file mode 100644
index 00000000000..714382e3c60
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md
@@ -0,0 +1,51 @@
+---
+title: "How to: Use Stored Procedures Mapped for Multiple Result Shapes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2b84dfe-7fec-489a-92de-45215cec4518
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Use Stored Procedures Mapped for Multiple Result Shapes
+複数の結果形状を返すことができるストアド プロシージャの場合、戻り値の型を単一の射影形状として厳密に型指定することはできません。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、返される可能性のある射影型をすべて生成できますが、どの順序で返されるかを知ることはできません。  
+  
+ このシナリオと対照的なのが、複数の結果形状をシーケンシャルに生成するストアド プロシージャです。  詳細については、「[How to: Use Stored Procedures Mapped for Sequential Result Shapes](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md)」を参照してください。  
+  
+ 複数の結果型を返すストアド プロシージャには、プロシージャが返す可能性のある一連の型を示す <xref:System.Data.Linq.Mapping.ResultTypeAttribute> 属性を適用します。  
+  
+## 使用例  
+ 次の SQL コードの例では、結果形状は入力値 \(`shape =1` または `shape = 2`\) に応じて変わります。  どちらの射影が先に返されるかはわかりません。  
+  
+```  
+CREATE PROCEDURE VariableResultShapes(@shape int)  
+AS  
+if(@shape = 1)  
+    select CustomerID, ContactTitle, CompanyName from customers  
+else if(@shape = 2)  
+    select OrderID, ShipName from orders  
+```  
+  
+ [!code-csharp[DLinqSprox#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/northwind-sprox.cs#4)]
+ [!code-vb[DLinqSprox#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/northwind-sprox.vb#4)]  
+  
+## 使用例  
+ このストアド プロシージャを実行するには、次のようなコードを使用します。  
+  
+> [!NOTE]
+>  ストアド プロシージャに対する知識に基づいて、<xref:System.Data.Linq.IMultipleResults.GetResult%2A> パターンを使用し、正しい型の列挙子を取得する必要があります。  
+  
+ [!code-csharp[DLinqSprox#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/Program.cs#5)]
+ [!code-vb[DLinqSprox#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/Module1.vb#5)]  
+  
+## 参照  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md
new file mode 100644
index 00000000000..fc6e54f647f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md
@@ -0,0 +1,42 @@
+---
+title: "How to: Use Stored Procedures Mapped for Sequential Result Shapes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a73530de-5a4e-4d9c-8d66-abb19c225b11
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Use Stored Procedures Mapped for Sequential Result Shapes
+この種類のストアド プロシージャでは、複数の結果形状が生成されますが、どの順序で結果が返されるかがわかります。  このシナリオは、返される結果のシーケンスがわからないシナリオと対照的です。  詳細については、「[How to: Use Stored Procedures Mapped for Multiple Result Shapes](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md)」を参照してください。  
+  
+## 使用例  
+ 次は、複数の結果形状をシーケンシャルに返すストアド プロシージャの T\-SQL です。  
+  
+```  
+CREATE PROCEDURE MultipleResultTypesSequentially  
+AS  
+select * from products  
+select * from customers  
+```  
+  
+ [!code-csharp[DLinqSprox#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/northwind-sprox.cs#6)]
+ [!code-vb[DLinqSprox#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/northwind-sprox.vb#6)]  
+  
+## 使用例  
+ このストアド プロシージャを実行するには、次のようなコードを使用します。  
+  
+ [!code-csharp[DLinqSprox#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/Program.cs#7)]
+ [!code-vb[DLinqSprox#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/Module1.vb#7)]  
+  
+## 参照  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-that-take-parameters.md b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-that-take-parameters.md
new file mode 100644
index 00000000000..e1b27292848
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-that-take-parameters.md
@@ -0,0 +1,50 @@
+---
+title: "How to: Use Stored Procedures that Take Parameters | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b935fd84-cb9c-4205-8c48-658d5db2ec93
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Use Stored Procedures that Take Parameters
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、出力パラメーターを参照パラメーターに対応付け、値型はパラメーターを null 許容型として宣言します。  
+  
+ 行セットを返すクエリでの入力パラメーターの使用方法の例については、「[How to: Return Rowsets](../../../../../../docs/framework/data/adonet/sql/linq/how-to-return-rowsets.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、単一の入力パラメーター \(顧客 ID\) を受け取り、出力パラメーター \(その顧客の売上合計\) を返します。  
+  
+```  
+CREATE PROCEDURE [dbo].[CustOrderTotal]   
+@CustomerID nchar(5),  
+@TotalSales money OUTPUT  
+AS  
+SELECT @TotalSales = SUM(OD.UNITPRICE*(1-OD.DISCOUNT) * OD.QUANTITY)  
+FROM ORDERS O, "ORDER DETAILS" OD  
+where O.CUSTOMERID = @CustomerID AND O.ORDERID = OD.ORDERID  
+```  
+  
+ [!code-csharp[DLinqSprox#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/northwind-sprox.cs#2)]
+ [!code-vb[DLinqSprox#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/northwind-sprox.vb#2)]  
+  
+## 使用例  
+ このストアド プロシージャは次のように呼び出すことができます。  
+  
+ [!code-csharp[DLinqSprox#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSprox/cs/Program.cs#3)]
+ [!code-vb[DLinqSprox#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSprox/vb/Module1.vb#3)]  
+  
+## 参照  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Null 許容型の使用](../Topic/Using%20Nullable%20Types%20\(C%23%20Programming%20Guide\).md)   
+ [Nullable Value Types](../Topic/Nullable%20Value%20Types%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-use-table-valued-user-defined-functions.md b/docs/framework/data/adonet/sql/linq/how-to-use-table-valued-user-defined-functions.md
new file mode 100644
index 00000000000..6cc7c5a6e48
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-use-table-valued-user-defined-functions.md
@@ -0,0 +1,55 @@
+---
+title: "How to: Use Table-Valued User-Defined Functions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a4ae2b4-3290-4aa1-bc95-fc70c51b54cf
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Use Table-Valued User-Defined Functions
+テーブル値関数は、単一の行セットを返します \(複数の結果形状を返すことができるストアド プロシージャとは異なります\)。  テーブル値関数の戻り値の型は `Table` であるため、テーブルを使用できる SQL の任意の場所でテーブル値関数を使用できます。  テーブル値関数をテーブルのように扱うこともできます。  
+  
+## 使用例  
+ 次の SQL 関数は、`TABLE` を返すことを明示的に示しています。  そのため、返される行セットの構造が暗黙的に定義されます。  
+  
+```  
+CREATE FUNCTION ProductsCostingMoreThan(@cost money)  
+RETURNS TABLE  
+AS  
+RETURN  
+    SELECT ProductID, UnitPrice  
+    FROM Products  
+    WHERE UnitPrice > @cost  
+```  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、関数を次のように割り当てます。  
+  
+ [!code-csharp[DLinqUDFS#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqUDFS/cs/northwind-tfunc.cs#1)]
+ [!code-vb[DLinqUDFS#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqUDFS/vb/northwind-tfunc.vb#1)]  
+  
+## 使用例  
+ 次の SQL コードは、関数が返すテーブルに結合できることを示しており、それ以外の場合は、他のテーブルと同じように扱います。  
+  
+```  
+SELECT p2.ProductName, p1.UnitPrice  
+FROM dbo.ProductsCostingMoreThan(80.50)  
+AS p1 INNER JOIN Products AS p2 ON p1.ProductID = p2.ProductID  
+```  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、クエリは次のように表示されます。  
+  
+ [!code-csharp[DLinqUDFS#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqUDFS/cs/Program.cs#2)]
+ [!code-vb[DLinqUDFS#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqUDFS/vb/Module1.vb#2)]  
+  
+## 参照  
+ [User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/user-defined-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md b/docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md
new file mode 100644
index 00000000000..4d0243aa958
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/how-to-validate-dbml-and-external-mapping-files.md
@@ -0,0 +1,81 @@
+---
+title: "How to: Validate DBML and External Mapping Files | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9ea37f5-0a9e-4401-8fc3-1e6fd44c49f9
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# How to: Validate DBML and External Mapping Files
+変更した外部マッピング ファイルや .dbml ファイルは、それぞれのスキーマ定義に対して検証する必要があります。  このトピックでは、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ユーザーを対象に、検証プロセスを実装する手順を示します。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+### .dbml ファイルまたは XML ファイルを検証するには  
+  
+1.  Visual Studio で、**\[ファイル\]** メニューの **\[開く\]** をポイントし、**\[ファイル\]** をクリックします。  
+  
+2.  **\[ファイルを開く\]** ダイアログ ボックスで、検証する .dbml ファイルまたは XML マッピング ファイルをクリックします。  
+  
+     **XML エディター**でファイルが開きます。  
+  
+3.  ウィンドウを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+4.  **\[プロパティ\]** ウィンドウで、**\[Schemas\]** プロパティの横にある \[...\] ボタンをクリックします。  
+  
+     **\[XML スキーマ\]** ダイアログ ボックスが表示されます。  
+  
+5.  目的に適したスキーマ定義を見つけます。  
+  
+    -   DbmlSchema.xsd は、.dbml ファイルを検証するためのスキーマ定義です。  詳細については、「[Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)」を参照してください。  
+  
+    -   LinqToSqlMapping.xsd は、外部 XML マッピング ファイルを検証するためのスキーマ定義です。  詳細については、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+6.  目的のスキーマ定義の行の **\[使用\]** 列をクリックしてドロップダウン ボックスを表示し、**\[このスキーマを使用する\]** をクリックします。  
+  
+     これで、スキーマ定義ファイルが DBML ファイルまたは XML マッピング ファイルに関連付けられます。  
+  
+     他のスキーマ定義は選択しないようにしてください。  
+  
+7.  **\[表示\]** メニューの **\[エラー一覧\]** をクリックします。  
+  
+     エラー、警告、またはメッセージが生成されていないか確認します。  生成されていなければ、XML ファイルはスキーマ定義に対して有効です。  
+  
+## スキーマ定義を指定する別の方法  
+ なんらかの理由で **\[XML スキーマ\]** ダイアログ ボックスに適切な .xsd ファイルが表示されない場合は、ヘルプ トピックから .xsd ファイルをダウンロードできます。  次の手順を使用すると、ダウンロードしたファイルを、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] の XML エディターに対応する Unicode 形式で保存できます。  
+  
+#### スキーマ定義ファイルをヘルプ トピックからコピーするには  
+  
+1.  このトピックで既に説明したように、スキーマ定義が含まれているヘルプ トピックを表示します。  
+  
+    -   .dbml ファイルについては、「[Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)」を参照してください。  
+  
+    -   外部マッピング ファイルについては、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+2.  **\[コードのコピー\]** をクリックして、コード ファイルをクリップボードにコピーします。  
+  
+3.  メモ帳を起動して、新しいファイルを作成します。  
+  
+4.  クリップボードからメモ帳のファイルにコードを貼り付けます。  
+  
+5.  メモ帳で、**\[ファイル\]** メニューの **\[名前を付けて保存\]** をクリックします。  
+  
+6.  **\[文字コード\]** ボックスの一覧の **\[Unicode\]** をクリックします。  
+  
+    > [!IMPORTANT]
+    >  これを選択することで、テキスト ファイルの先頭に Unicode\-16 のバイト順マーカー \(`FFFE`\) が追加されます。  
+  
+7.  **\[ファイル名\]** ボックスに、ファイル名と拡張子 .xsd を入力します。  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/implementing-business-logic-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/implementing-business-logic-linq-to-sql.md
new file mode 100644
index 00000000000..ee5fca9321b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/implementing-business-logic-linq-to-sql.md
@@ -0,0 +1,194 @@
+---
+title: "Implementing Business Logic (LINQ to SQL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4577590-7b12-42e1-84a6-95aa2562727e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Implementing Business Logic (LINQ to SQL)
+このトピックの「ビジネス ロジック」とは、データベースでデータを挿入、更新、または削除される前にデータに適用されるカスタム規則または検証テストのことです。  ビジネス ロジックは、「ビジネス ルール」または「ドメイン ロジック」とも呼ばれます。 n 層アプリケーションでは、通常、論理層として設計されるため、プレゼンテーション層やデータ アクセス層から独立して変更できます。  データベースのデータを更新、挿入、または削除する前または後に、データ アクセス層によってビジネス ロジックを呼び出すことができます。  
+  
+ ビジネス ロジックは、フィールドの型がテーブル列の型と互換性を持つかどうか確認するスキーマ検証のような簡単なものにすることもできます。  または、任意の複雑な方法で相互に影響するオブジェクトのセットから成るビジネス ロジックも可能です。  規則は、データベース上のストアド プロシージャとして、またはメモリ内のオブジェクトとして実装可能です。  ビジネス ロジックの実装方法とは無関係に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、部分クラスと部分メソッドを使ってビジネス ロジックをデータ アクセス コードから分離することができます。  
+  
+## LINQ to SQL でビジネス ロジックを呼び出す方法  
+ 手動で、または[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]か SQLMetal を使用してデザイン時にエンティティ クラスを生成すると、部分クラスとして定義されます。  つまり、別個のコード ファイル内で、カスタム ビジネス ロジックを格納するエンティティ クラスの別の部分を定義できます。  コンパイル時に 2 つの部分が 1 つのクラスに結合されます。 ただし、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]または SQLMetal を使ってエンティティ クラスを再生成する必要がある場合には、そうしてもかまいません。その場合、開発者が作成したクラスの部分は変更されません。  
+  
+ エンティティと <xref:System.Data.Linq.DataContext> を定義する部分クラスには、部分メソッドが含まれます。  これらは機能拡張ポイントであり、これらを使用して、エンティティまたはエンティティ プロパティを更新、挿入、削除する前および後にビジネス ロジックを適用できます。  部分メソッドはコンパイル時のイベントのようなものです。  コード ジェネレーターはメソッド シグネチャを定義して、get および set プロパティ アクセサー内、`DataContext` コンストラクター内、および、場合によっては <xref:System.Data.Linq.DataContext.SubmitChanges%2A> 呼び出し時に背後でメソッドを呼び出します。  ただし、特定の部分メソッドを実装しない場合には、そのメソッドのすべての参照と定義はコンパイル時に削除されます。  
+  
+ 別個のコード ファイル内に作成する実装定義では、必要な任意のカスタム ロジックを実行できます。  部分クラス自体をドメイン層として使用できます。または、部分メソッドの実装定義から別個の 1 つ以上のオブジェクトに呼び出すこともできます。  どちらの場合も、ビジネス ロジックはデータ アクセス コードとプレゼンテーション層コードから明確に分離されています。  
+  
+## 機能拡張ポイントの詳細  
+ 次の例は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] と `DataContext` の 2 つのテーブルを持つ `Customers` クラス用に`Orders`によって生成されるコードの一部分です。  このクラスで Insert、Update、および Delete メソッドがテーブルごとに定義されていることに注意してください。  
+  
+```vb  
+Partial Public Class Northwnd  
+    Inherits System.Data.Linq.DataContext  
+  
+    Private Shared mappingSource As _  
+        System.Data.Linq.Mapping.MappingSource = New _  
+        AttributeMappingSource  
+  
+    #Region "Extensibility Method Definitions"  
+    Partial Private Sub OnCreated()  
+    End Sub  
+    Partial Private Sub InsertCustomer(instance As Customer)  
+    End Sub  
+    Partial Private Sub UpdateCustomer(instance As Customer)  
+    End Sub  
+    Partial Private Sub DeleteCustomer(instance As Customer)  
+    End Sub  
+    Partial Private Sub InsertOrder(instance As [Order])  
+    End Sub  
+    Partial Private Sub UpdateOrder(instance As [Order])  
+    End Sub  
+    Partial Private Sub DeleteOrder(instance As [Order])  
+    End Sub  
+    #End Region  
+```  
+  
+```csharp  
+public partial class MyNorthWindDataContext : System.Data.Linq.DataContext  
+    {  
+        private static System.Data.Linq.Mapping.MappingSource mappingSource = new AttributeMappingSource();  
+  
+        #region Extensibility Method Definitions  
+        partial void OnCreated();  
+        partial void InsertCustomer(Customer instance);  
+        partial void UpdateCustomer(Customer instance);  
+        partial void DeleteCustomer(Customer instance);  
+        partial void InsertOrder(Order instance);  
+        partial void UpdateOrder(Order instance);  
+        partial void DeleteOrder(Order instance);  
+        #endregion  
+```  
+  
+ 部分クラス内で Insert、Update、および Delete メソッドを実装すると、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ランタイムは <xref:System.Data.Linq.DataContext.SubmitChanges%2A> の呼び出し時に、既定のメソッドの代わりにこれらのメソッドを呼び出します。  こうすることで、作成、読み取り、更新、削除操作の既定の動作をオーバーライドできます。  詳細については、「[Walkthrough: Customizing the Insert, Update, and Delete Behavior of Entity Classes](../Topic/Walkthrough:%20Customizing%20the%20insert,%20update,%20and%20delete%20behavior%20of%20entity%20classes.md)」を参照してください。  
+  
+ `OnCreated` メソッドはクラス コンストラクター内で呼び出されます。  
+  
+```vb  
+Public Sub New(ByVal connection As String)  
+    MyBase.New(connection, mappingSource)  
+    OnCreated()  
+End Sub  
+```  
+  
+```csharp  
+public MyNorthWindDataContext(string connection) :  
+            base(connection, mappingSource)  
+        {  
+            OnCreated();  
+        }  
+```  
+  
+ エンティティの作成時、読み込み時、および検証時 \([!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の呼び出し時\) に `SubmitChanges` ランタイムによって呼び出される 3 つのメソッドが、エンティティ クラスに含まれています。  さらに、エンティティ クラスには、各プロパティごとの 2 つの部分メソッドも含まれています。このうち 1 つはプロパティの設定前に、もう 1 つは設定後に呼び出されます。  次のコード例は、`Customer` クラス用に生成されるいくつかのメソッドを示しています。  
+  
+```vb  
+#Region "Extensibility Method Definitions"  
+    Partial Private Sub OnLoaded()  
+    End Sub  
+    Partial Private Sub OnValidate(action As _  
+        System.Data.Linq.ChangeAction)  
+    End Sub  
+    Partial Private Sub OnCreated()  
+    End Sub  
+    Partial Private Sub OnCustomerIDChanging(value As String)  
+    End Sub  
+    Partial Private Sub OnCustomerIDChanged()  
+    End Sub  
+    Partial Private Sub OnCompanyNameChanging(value As String)  
+    End Sub  
+    Partial Private Sub OnCompanyNameChanged()  
+    End Sub  
+' ...Additional Changing/Changed methods for each property.  
+```  
+  
+```csharp  
+#region Extensibility Method Definitions  
+    partial void OnLoaded();  
+    partial void OnValidate();  
+    partial void OnCreated();  
+    partial void OnCustomerIDChanging(string value);  
+    partial void OnCustomerIDChanged();  
+    partial void OnCompanyNameChanging(string value);  
+    partial void OnCompanyNameChanged();  
+// ...additional Changing/Changed methods for each property  
+```  
+  
+ 以下の `CustomerID` プロパティの例に示されるように、メソッドはプロパティの set アクセサー内で呼び出されます。  
+  
+```vb  
+Public Property CustomerID() As String  
+    Set  
+        If (String.Equals(Me._CustomerID, value) = False) Then  
+            Me.OnCustomerIDChanging(value)  
+            Me.SendPropertyChanging()  
+            Me._CustomerID = value  
+            Me.SendPropertyChanged("CustomerID")  
+            Me.OnCustomerIDChanged()  
+        End If  
+    End Set  
+End Property  
+```  
+  
+```csharp  
+public string CustomerID  
+{  
+    set  
+    {  
+        if ((this._CustomerID != value))  
+        {  
+            this.OnCustomerIDChanging(value);  
+            this.SendPropertyChanging();  
+            this._CustomerID = value;  
+            this.SendPropertyChanged("CustomerID");  
+            this.OnCustomerIDChanged();  
+        }  
+     }  
+}  
+```  
+  
+ クラスの開発者が作成する部分で、メソッドの実装定義を記述します。  [!INCLUDE[vsprvs](../../../../../../includes/vsprvs-md.md)] では、`partial` と入力した後、クラスの別の部分にメソッド定義用の IntelliSense が表示されます。  
+  
+```vb  
+Partial Public Class Customer  
+    Private Sub OnCustomerIDChanging(value As String)  
+        ' Perform custom validation logic here.  
+    End Sub  
+End Class  
+```  
+  
+```csharp  
+partial class Customer   
+    {  
+        partial void OnCustomerIDChanging(string value)  
+        {  
+            //Perform custom validation logic here.  
+        }  
+    }  
+```  
+  
+ 部分メソッドを使ってビジネス ロジックをアプリケーションに追加する方法の詳細については、以下のトピックを参照してください。  
+  
+ [How to: Add Validation to Entity Classes](../Topic/How%20to:%20Add%20validation%20to%20entity%20classes.md)  
+  
+ [Walkthrough: Customizing the Insert, Update, and Delete Behavior of Entity Classes](../Topic/Walkthrough:%20Customizing%20the%20insert,%20update,%20and%20delete%20behavior%20of%20entity%20classes.md)  
+  
+ [Walkthrough: Adding Validation to Entity Classes](../Topic/Walkthrough:%20Adding%20Validation%20to%20Entity%20Classes.md)  
+  
+## 参照  
+ [部分クラスと部分メソッド](../Topic/Partial%20Classes%20and%20Methods%20\(C%23%20Programming%20Guide\).md)   
+ [Partial Methods](../Topic/Partial%20Methods%20\(Visual%20Basic\).md)   
+ [LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)   
+ [SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/index.md b/docs/framework/data/adonet/sql/linq/index.md
new file mode 100644
index 00000000000..9ebecfca0c2
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/index.md
@@ -0,0 +1,61 @@
+---
+title: "LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 73d13345-eece-471a-af40-4cc7a2f11655
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LINQ to SQL
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] Version 3.5 のコンポーネントであり、リレーショナル データをオブジェクトとして管理するためのランタイム インフラストラクチャを提供します。  
+  
+> [!NOTE]
+>  リレーショナル データは 2 次元テーブル \(*リレーション*または*フラット ファイル*\) のコレクションで表され、共通の列がテーブルを相互に関連付けます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を効果的に使用するには、リレーショナル データベースの基本原則を理解している必要があります。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、リレーショナル データベースのデータ モデルが、開発者のプログラミング言語で表されるオブジェクト モデルに対応付けられています。  アプリケーションが実行されると、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オブジェクト モデルの統合言語クエリを SQL に変換し、それをデータベースに送信して実行します。データベースから結果が返されると、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はそれをプログラミング言語で操作できるオブジェクトに変換し直します。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用する開発者は、通常、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用します。これには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の機能の多くを実装するためのユーザー インターフェイスが用意されています。  
+  
+ このリリースの [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に含まれているドキュメントでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションを構築するのに必要な基本的なビルド ブロック、プロセス、および手法について説明します。  特定の問題について MSDN ライブラリを検索したり、[LINQ フォーラム](http://go.microsoft.com/fwlink/?LinkId=76488)に参加して、複雑なトピックについて専門家と検討したりすることもできます。  また、「[LINQ to SQL: リレーショナル データのための .NET 統合言語クエリ](http://go.microsoft.com/fwlink/?LinkId=93205)」ホワイト ペーパーには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジの詳細と、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のコード例が記載されています。  
+  
+## このセクションの内容  
+ [Getting Started](../../../../../../docs/framework/data/adonet/sql/linq/getting-started.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の簡単な概要と、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用して作業を始める方法を示します。  
+  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)  
+ マップ、クエリ、更新、デバッグ、および同様の操作を行う手順を示します。  
+  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のさまざまな側面に関するリファレンス情報を示します。  SQL\-CLR 型マッピング、標準クエリ演算子変換などのトピックが含まれます。  
+  
+ [Samples](../../../../../../docs/framework/data/adonet/sql/linq/samples.md)  
+ [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のサンプルへのリンクを示します。  
+  
+## 関連項目  
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] テクノロジの概要を示します。  
+  
+ [LINQ](../Topic/LINQ%20in%20Visual%20Basic.md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] ユーザーを対象に [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] テクノロジについて説明します。  
+  
+ [LINQ to ADO.NET](http://msdn.microsoft.com/ja-jp/be3297b9-1b54-4d4c-82a8-add0d79c2006)  
+ [!INCLUDE[vstecado](../../../../../../includes/vstecado-md.md)] ポータルにリンクします。  
+  
+ [LINQ to SQL チュートリアル](http://msdn.microsoft.com/ja-jp/308e66ac-f704-4e00-9b4e-7af0045a2374)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のチュートリアルを一覧します。  
+  
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)  
+ ドキュメントで使用されるサンプル データベースをダウンロードする方法について説明します。  
+  
+ [LinqDataSource テクノロジの概要](http://msdn.microsoft.com/ja-jp/104cfc3f-7385-47d3-8a51-830dfa791136)  
+ <xref:System.Web.UI.WebControls.LinqDataSource> コントロールが [!INCLUDE[vbteclinqext](../../../../../../includes/vbteclinqext-md.md)] データソース コントロールのアーキテクチャを通じて[!INCLUDE[vstecasp](../../../../../../includes/vstecasp-md.md)] を Web 開発者に公開する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/inheritance-support.md b/docs/framework/data/adonet/sql/linq/inheritance-support.md
new file mode 100644
index 00000000000..e2135fae4c5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/inheritance-support.md
@@ -0,0 +1,29 @@
+---
+title: "Inheritance Support | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19bb2794-b4e7-402e-8307-1d1517381a08
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Inheritance Support
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、*シングル テーブル マッピング*をサポートしています。  これは、1 つの継承階層全体が単一のデータベース テーブルに保存されることを意味します。  テーブルには、階層構造内で使用され得るすべてのデータ列の平坦化された共用体が格納されます   \(2 つのテーブルを 1 つに結合し、元のテーブルのいずれかにあった行が新しいテーブルに含まれるようにした結果、1 つの共用体が形成されます\)。 行によって表されるインスタンスの型に適合しない列には null が設定されます。  
+  
+ シングル テーブル マッピング形式は、継承を表す最も単純な形式であり、多くのクエリのカテゴリで良好なパフォーマンス特性を示します。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] でこのマッピングを実装するには、継承階層のルート クラスで属性および属性プロパティを指定する必要があります。  詳細については、「[How to: Map Inheritance Hierarchies](../../../../../../docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md)」を参照してください。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して継承階層を割り当てることもできます。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/insert-update-and-delete-operations.md b/docs/framework/data/adonet/sql/linq/insert-update-and-delete-operations.md
new file mode 100644
index 00000000000..a28d2b5aee9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/insert-update-and-delete-operations.md
@@ -0,0 +1,41 @@
+---
+title: "Insert, Update, and Delete Operations | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 26a43a4f-83c9-4732-806d-bb23aad0ff6b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Insert, Update, and Delete Operations
+オブジェクト モデルに対してオブジェクトの追加、変更、および削除を行うには、`Insert` で `Update`、`Delete`、および [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の各操作を実行します。  既定では、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって SQL に対する操作が変換され、変更内容がデータベースに送信されます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オブジェクトに加えた変更内容の操作と維持に関して最大限の柔軟性を提供します。  クエリによって取得するか新規に作成することによりエンティティ オブジェクトが使用可能になった後で、通常のオブジェクトと同じようにそれらのオブジェクトをアプリケーションで変更できます。  つまり、それらに対して、値の変更、コレクションへの追加、およびコレクションからの削除を行うことができます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では変更履歴が保持されるため、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すと、変更内容をデータベースに送信できます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は連鎖削除操作をサポートせず、認識もしません。  制約を持つテーブルの行を削除するには、データベース内の外部キー制約で `ON DELETE CASCADE` 規則を設定するか、独自のコードを使用して、親オブジェクトの削除を妨げる子オブジェクトを最初に削除する必要があります。それ以外の場合は、例外がスローされます。  詳細については、「[How to: Delete Rows From the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md)」を参照してください。  
+  
+ 次の例では、Northwind サンプル データベースの `Customer` クラスと `Order` クラスを使用します。  簡潔にするため、ここではクラス定義を省いています。  
+  
+ [!code-csharp[DLinqCRUDOps#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqCRUDOps/cs/Program.cs#1)]
+ [!code-vb[DLinqCRUDOps#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqCRUDOps/vb/Module1.vb#1)]  
+  
+ <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すと、変更内容をデータベースに送信する SQL コマンドが [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって自動的に生成され、実行されます。  
+  
+> [!NOTE]
+>  独自に作成したロジック \(通常はストアド プロシージャ\) を使用して、この動作をオーバーライドできます。  詳細については、「[Responsibilities of the Developer In Overriding Default Behavior](../../../../../../docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md)」を参照してください。  
+>   
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、この用途のストアド プロシージャを開発できます。  
+  
+## 参照  
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)   
+ [Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md b/docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md
new file mode 100644
index 00000000000..47b833ad7b2
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md
@@ -0,0 +1,98 @@
+---
+title: "Learning by Walkthroughs | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8ae2965-6a49-4155-89b0-7fab2c488ab1
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Learning by Walkthroughs
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のドキュメントにはいくつかのチュートリアルが用意されています。  このトピックでは、チュートリアルに関する全般的な話題 \(トラブルシューティングを含む\) を取り上げます。また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] について学ぶための、いくつかの入門レベルのチュートリアルへのリンクを示します。  
+  
+> [!NOTE]
+>  この「入門のためのチュートリアル」のセクションのチュートリアルでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 技術をサポートする基本的なコードを紹介します。  実際の開発では、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]と Windows フォーム プロジェクトを使用して [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションを実装するのが一般的です。  そのための例とチュートリアルは、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)] のドキュメントにあります。  
+  
+## 入門のためのチュートリアル  
+ このセクションではいくつかのチュートリアルを示します。  これらのチュートリアルは、Northwind サンプル データベースを基にしており、複雑さを抑えて、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の機能を少しずつ導入していきます。  
+  
+ 一般的な流れは次のとおりです。  
+  
+|目標|Visual Basic|C\#|  
+|--------|------------------|---------|  
+|エンティティ クラスを作成し、簡単なクエリを実行します。|[Walkthrough: Simple Object Model and Query \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-visual-basic.md)|[Walkthrough: Simple Object Model and Query \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-csharp.md)|  
+|2 番目のクラスを追加し、より複雑なクエリを実行します<br /><br /> \(前のチュートリアルを完了している必要があります\)。|[Walkthrough: Querying Across Relationships \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-visual-basic.md)|[Walkthrough: Querying Across Relationships \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-csharp.md)|  
+|データベースの項目を追加、変更、および削除します。|[Walkthrough: Manipulating Data \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-visual-basic.md)|[Walkthrough: Manipulating Data \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-csharp.md)|  
+|ストアド プロシージャを使用します。|[Walkthrough: Using Only Stored Procedures \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-visual-basic.md)|[Walkthrough: Using Only Stored Procedures \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-csharp.md)|  
+  
+## 全般  
+ 以下の情報は、これらのチュートリアル全体に該当します。  
+  
+-   環境 : [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の各チュートリアルでは、統合開発環境 \(IDE: Integrated Development Environment\) として [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用します。  
+  
+-   SQL エンジン : これらのチュートリアルは、SQL Server Express を使用して実装できるように作成されています。  SQL Server Express を持っていない場合は、無料でダウンロードできます。  詳細については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のチュートリアルでは、ファイル名を接続文字列として使用します。  ファイル名を指定するだけで済むのは、SQL Server Express ユーザーのために [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に備わっている機能です。  セキュリティ問題には常に注意してください。  詳細については、「[Security in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md)」を参照してください。  
+  
+-   通常、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のチュートリアルには、Northwind サンプル データベースが必要です。  詳細については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  
+  
+-   使用している設定または [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] のエディションによっては、チュートリアルの中で、ヘルプの記載と異なるダイアログ ボックスやメニュー コマンドが表示される場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+-   多階層のシナリオに関連するチュートリアルでは、開発用コンピューターとは別のコンピューターにサーバーが配置されていることと、そのサーバーにアクセスするための適切なアクセス許可が必要です。  
+  
+-   通常、Northwind サンプル データベースの Orders テーブルを表すクラスの名前は `[Order]` です。  エスケープが必要な理由は、`Order` が [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] のキーワードであるためです。  
+  
+## トラブルシューティング  
+ これらのチュートリアルで使用するデータベースにアクセスするための十分なアクセス許可がない場合、ランタイム エラーが発生することがあります。  特に一般的な問題を解決するためのヒントについては、以下の手順を参照してください。  
+  
+### ログオンの問題  
+ アプリケーションが試みているデータベース アクセスの方法が、データベースが受け付けないログオン方法である可能性があります。  
+  
+##### データベース ログオンを確認または変更するには  
+  
+1.  Windows の **\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]** をポイントします。次に **\[Microsoft SQL Server 2005\]** をポイントし、**\[構成ツール\]** をポイントして、**\[SQL Server 構成マネージャー\]** をクリックします。  
+  
+2.  **SQL Server 構成マネージャー**の左ペインで、**\[SQL Server 2005 のサービス\]** をクリックします。  
+  
+3.  右ペインで **\[SQL Server \(SQLEXPRESS\)\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+4.  **\[ログオン\]** タブをクリックして、サーバーにログオンする方法を確認します。  
+  
+     多くの場合は、**\[ローカル システム\]** で正常に動作します。  
+  
+     変更を加えた場合は、**\[再起動\]** をクリックしてサービスを再起動します。  
+  
+### プロトコル  
+ 場合によっては、アプリケーションがデータベースにアクセスするためのプロトコルが正しく設定されていないこともあります。  たとえば、 **のチュートリアルに必要な[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]名前付きパイプ** プロトコルは、既定では有効になっていません。  
+  
+##### 名前付きパイプ プロトコルを有効にするには  
+  
+1.  **SQL Server 構成マネージャー**の左ペインで、**\[SQL Server 2005 ネットワークの構成\]** を展開し、**\[SQLEXPRESS のプロトコル\]** をクリックします。  
+  
+2.  右ペインで、**\[名前付きパイプ\]** プロトコルが有効になっていることを確認します。  有効になっていない場合は、**\[名前付きパイプ\]** を右クリックし、**\[有効化\]** をクリックします。  
+  
+     サービスの停止および再起動が必要になります。  次のブロックの手順に従って操作します。  
+  
+### サービスの停止および再起動  
+ 変更を有効にするには、サービスを停止し、再起動する必要があります。  
+  
+##### サービスを停止および再起動するには  
+  
+1.  **SQL Server 構成マネージャー**の左ペインで、**\[SQL Server 2005 のサービス\]** をクリックします。  
+  
+2.  右ペインで、**\[SQL Server \(SQLEXPRESS\)\]** を右クリックし、**\[停止\]** をクリックします。  
+  
+3.  **\[SQL Server \(SQLEXPRESS\)\]** を右クリックし、**\[再起動\]** をクリックします。  
+  
+## 参照  
+ [Getting Started](../../../../../../docs/framework/data/adonet/sql/linq/getting-started.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-aspnet.md b/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-aspnet.md
new file mode 100644
index 00000000000..5bd7b65b2d7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-aspnet.md
@@ -0,0 +1,25 @@
+---
+title: "ASP.NET での LINQ to SQL N 層 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f6cc863a-d6a6-4281-ba8b-197c01cf6c6f
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ASP.NET での LINQ to SQL N 層
+[!INCLUDE[vstecasp](../../../../../../includes/vstecasp-md.md)] を使用する [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションでは、<xref:System.Web.UI.WebControls.LinqDataSource> Web サーバー コントロールが使われます。 このコントロールは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に対するクエリ実行、ブラウザーへのデータ送信、データの取得、データベースを更新する [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]<xref:System.Data.Linq.DataContext> へのデータ送信など、必要なほとんどのロジックを扱います。 マークアップでこのコントロールを構成するだけで、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] とブラウザーの間のすべてのデータ転送をコントロールが処理するようになります。 このコントロールがプレゼンテーション層との対話を処理し、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がデータ層との通信を処理するため、[!INCLUDE[vstecasp](../../../../../../includes/vstecasp-md.md)] 多層アプリケーションでは、カスタム ビジネス ロジックを作成することが開発者の主な作業になります。  
+  
+ `LINQDataSource` の詳細については、「[NIB: LinqDataSource Web サーバー コントロールの概要](http://msdn.microsoft.com/ja-jp/104cfc3f-7385-47d3-8a51-830dfa791136)」を参照してください。  
+  
+## 参照  
+ [N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-web-services.md b/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-web-services.md
new file mode 100644
index 00000000000..1628acc062e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-web-services.md
@@ -0,0 +1,48 @@
+---
+title: "LINQ to SQL N-Tier with Web Services | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9cb10eb8-957f-4beb-a271-5f682016fed2
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to SQL N-Tier with Web Services
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、Web サービスなど、疎結合のデータ アクセス層 \(DAL\) の中間層で特に使用されるように設計されています。  プレゼンテーション層が ASP.NET Web ページである場合、中間層の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] とユーザー インターフェイスとのデータ転送を管理するために <xref:System.Web.UI.WebControls.LinqDataSource> Web サーバー コントロールを使用します。  プレゼンテーション層が ASP.NET ページでない場合には、中間層とプレゼンテーション層の両方で、データのシリアル化と逆シリアル化を管理するための追加の操作を行う必要があります。  
+  
+## 中間層での LINQ to SQL のセットアップ  
+ Web サービスまたは n 層アプリケーションでは、中間層にデータ コンテキストおよびエンティティのクラスが含まれます。  これらのクラスは手動で作成できます。または、他の箇所で説明されているように、SQLMetal.exe または[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して作成することもできます。  オプションとして、デザイン時にエンティティ クラスをシリアル化可能にすることができます。  詳細については、「[How to: Make Entities Serializable](../../../../../../docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md)」を参照してください。  別のオプションとして、シリアル化対象のデータをカプセル化するクラスから成る別のセットを作成して、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリ内でデータを返すときにシリアル化可能な型に射影することもできます。  
+  
+ その後、データの取得、挿入、更新のためにクライアントが呼び出すメソッドを持つインターフェイスを定義します。  これらのインターフェイス メソッドは [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリをラップします。  任意のシリアル化技法を使って、リモート メソッド呼び出しとデータのシリアル化を扱うことができます。  唯一の要件として、たとえば標準の Northwind オブジェクト モデルにおける Customers と Orders のように、循環型または双方向のリレーションシップがオブジェクト モデルに存在する場合は、それをサポートするシリアライザーを使用する必要があります。  Windows Communication Foundation \(WCF\) の <xref:System.Runtime.Serialization.DataContractSerializer> は双方向リレーションシップをサポートしますが、WCF 以外の Web サービスで使用される XmlSerializer はこれをサポートしません。XmlSerializer の使用を選択する場合は、オブジェクト モデルに循環型リレーションシップが存在しないことを確認する必要があります。  
+  
+ Windows Communication Foundation の詳細については、「[Windows Communication Foundation Services and WCF Data Services in Visual Studio](../Topic/Windows%20Communication%20Foundation%20Services%20and%20WCF%20Data%20Services%20in%20Visual%20Studio.md)」を参照してください。  
+  
+ ビジネス ルールまたは他のドメイン固有のロジックを実装するために、<xref:System.Data.Linq.DataContext> 上の部分クラスとメソッド、およびエンティティ クラスを使用して [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ランタイム イベント内にフックします。  詳細については、「[Implementing N\-Tier Business Logic](../../../../../../docs/framework/data/adonet/sql/linq/implementing-business-logic-linq-to-sql.md)」を参照してください。  
+  
+## シリアル化可能な型の定義  
+ クライアントまたはプレゼンテーション層には、中間層から受け取るクラスについての型定義が必要です。  これらの型は、それ自体、エンティティ クラスにすることも可能です。または、リモート処理用にエンティティ クラスのいくつかのフィールドだけをラップする特殊クラスにすることも可能です。  いずれの場合も、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、プレゼンテーション層がこれらの型定義をどのように取得するかにまったく関与しません。  たとえば、プレゼンテーション層は、WCF を使用して型を自動生成する場合があります。または、型が定義されている DLL のコピーを持っている場合や、単に独自の型を定義する場合もあります。  
+  
+## データの取得と挿入  
+ 中間層は、プレゼンテーション層がデータにアクセスする方法を指定するインターフェイスを定義します。  たとえば `GetProductByID(int productID)`、`GetCustomers()` などです。  中間層では、通常、メソッド本体が <xref:System.Data.Linq.DataContext> の新しいインスタンスを作成し、1 つ以上のテーブルに対するクエリを実行します。  その後、中間層は <xref:System.Collections.Generic.IEnumerable%601> として結果を返します。`T` は、エンティティ クラス、またはシリアル化で使用される他の型です。  プレゼンテーション層は、中間層との間でクエリ変数を直接やり取りすることはありません。  2 つの層は、値、オブジェクト、および具象データのコレクションをやり取りします。  コレクションを受け取った後、プレゼンテーション層は必要に応じて [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] to Objects を使ってクエリを実行できます。  
+  
+ データの挿入時に、プレゼンテーション層は新しいオブジェクトを構築して中間層にそれを送ることができます。または、プレゼンテーション層から渡される値に基づいて中間層にオブジェクトを構築させることもできます。  一般的に、n 層アプリケーションでのデータの取得と挿入は、2 層アプリケーションでの処理と似ています。  詳細については、「[Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)」および「[Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)」を参照してください。  
+  
+## 更新と削除における変更内容の追跡  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、タイムスタンプ \(RowVersion ともいう\) および元の値に基づくオプティミスティック同時実行制御をサポートします。  データベース テーブルにタイムスタンプが存在すると、更新と削除のために、中間層とプレゼンテーション層で実行する必要のある追加の処理はあまりありません。  しかし、元の値を使ってオプティミスティック同時実行制御チェックを行う必要がある場合には、プレゼンテーション層はこれらの値を追跡して、更新時にそれを送り返す必要があります。  これは、プレゼンテーション層上のエンティティに対する変更内容が中間層で追跡されないためです。  実際、エンティティの最初の取得とその後の更新は、通常、<xref:System.Data.Linq.DataContext> のまったく別の 2 つのインスタンスによって実行されます。  
+  
+ プレゼンテーション層での変更箇所が多いほど、これらの変更を追跡して中間層にパッケージとして戻す操作が複雑になります。  変更内容をやり取りするメカニズムの実装は、完全にアプリケーションに依存しています。  唯一の要件は、オプティミスティック同時実行制御チェックに必要な元の値が [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に渡されなければならないということです。  
+  
+ 詳細については、「[Data Retrieval and CUD Operations in N\-Tier Applications \(LINQ to SQL\)](../../../../../../docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md)」を参照してください。  
+  
+## 参照  
+ [N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)   
+ [NIB: LinqDataSource Web Server Control Overview](http://msdn.microsoft.com/ja-jp/104cfc3f-7385-47d3-8a51-830dfa791136)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/linq-to-sql-queries.md b/docs/framework/data/adonet/sql/linq/linq-to-sql-queries.md
new file mode 100644
index 00000000000..313d069631d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/linq-to-sql-queries.md
@@ -0,0 +1,45 @@
+---
+title: "LINQ to SQL Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4897aaa-7f44-4c20-a471-b948c2971aae
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# LINQ to SQL Queries
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリは、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリと同じ構文を使用して定義します。  異なる点は、クエリ内で参照されるオブジェクトがデータベース内の要素に割り当てられるという点だけです。  詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、作成したクエリを同等の SQL クエリに変換し、それをサーバーに送って処理します。 具体的には、アプリケーションは [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] API を使用してクエリの実行を要求します。  次に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロバイダーがクエリを SQL テキストに変換し、ADO プロバイダーに実行を委任します。 ADO プロバイダーは、クエリの結果を `DataReader` として返します。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロバイダーは、ADO の結果をユーザー オブジェクトの <xref:System.Linq.IQueryable> コレクションに変換します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] 組み込み型のほとんどのメソッドと演算子には、SQL に直接対応する変換が用意されています。  [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] で変換できないものについては、ランタイム例外が発生します。  詳細については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」を参照してください。  
+  
+ 次の表は、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリの項目と [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリの項目の類似点と相違点を示すものです。  
+  
+|アイテム|LINQ クエリ|[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリ|  
+|----------|--------------|--------------------------------------------------------------------|  
+|クエリを保持するローカル変数の戻り値の型 \(シーケンスを返すクエリの場合\)|ジェネリック `IEnumerable`|ジェネリック `IQueryable`|  
+|データ ソースの指定|`From` \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\) 句または `from` \(C\#\) 句を使用|同|  
+|フィルター処理|`Where`\/`where` 句を使用|同|  
+|グループ化|`Group…By`\/`groupby` 句を使用|同|  
+|選択 \(投影\)|`Select`\/`select` 句を使用|同|  
+|遅延実行と即時実行|「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。|同|  
+|結合の実装|`Join`\/`join` 句を使用|`Join`\/`join` 句を使用できますが、<xref:System.Data.Linq.Mapping.AssociationAttribute> 属性を使用する方が効果的です。  詳細については、「[Querying Across Relationships](../../../../../../docs/framework/data/adonet/sql/linq/querying-across-relationships.md)」を参照してください。|  
+|リモート実行とローカル実行||詳細については、「[Remote vs. Local Execution](../../../../../../docs/framework/data/adonet/sql/linq/remote-vs-local-execution.md)」を参照してください。|  
+|ストリーミングとキャッシュ クエリ|ローカル メモリ シナリオでは適用なし||  
+  
+## 参照  
+ [Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)   
+ [Basic LINQ Query Operations](../Topic/Basic%20LINQ%20Query%20Operations%20\(C%23\).md)   
+ [Type Relationships in LINQ Query Operations](../Topic/Type%20Relationships%20in%20LINQ%20Query%20Operations%20\(C%23\).md)   
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/linq-to-sql-with-tightly-coupled-client-server-applications.md b/docs/framework/data/adonet/sql/linq/linq-to-sql-with-tightly-coupled-client-server-applications.md
new file mode 100644
index 00000000000..68cfaea88fd
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/linq-to-sql-with-tightly-coupled-client-server-applications.md
@@ -0,0 +1,27 @@
+---
+title: "LINQ to SQL with Tightly-Coupled Client-Server Applications | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e083d805-dcf6-459d-b9af-9ef0563f2dd7
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# LINQ to SQL with Tightly-Coupled Client-Server Applications
+プレゼンテーション層の密結合スマート クライアントと共に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を中間層で使用することができます。  読み取り専用データ アクセス、オプティミスティック同時実行チェックなし、またはタイムスタンプを使用したオプティミスティック同時実行のシナリオの場合、非リモートのシナリオに比べて複雑さはほぼ同じです。  しかし、元の値を使用したオプティミスティック同時実行チェックをデータベースで行う必要がある場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は DataSet のようなレベルのデータ ラウンド トリップをサポートしません。  ただし、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 中間層は任意のプラットフォーム上のクライアントとの間でデータをやり取りできます。  
+  
+ [!INCLUDE[vs_orcas_long](../../../../../../includes/vs-orcas-long-md.md)] の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には、クライアントにシリアル化された後のエンティティの状態を追跡するインフラストラクチャが用意されていません。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、小量の比較的アトミックな対話を、データ層とプレゼンテーション層の間で行うサービス指向アーキテクチャが実現されますが、元の値のラウンド トリップはまったく実行されません。  このため、密結合のスマート クライアントを [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] と共に使用し、元の値を使ったオプティミスティック同時実行制御をデータベースで行う場合には、プレゼンテーション層と中間層の間で変更内容を通信するための独自の機構を実装する必要があります。  中間層で [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用することの利点を考慮に入れて、この余分の作業を行うかどうかは、システム設計者の判断に任せられます。  一方、データベースでタイムスタンプを使用する場合には、変更追跡用のカスタム ロジックは必要ありません。  
+  
+## 参照  
+ [N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)   
+ [LINQ to SQL N\-Tier with Web Services](../../../../../../docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-web-services.md)   
+ [n 層アプリケーションでのデータセットの操作](../Topic/Work%20with%20datasets%20in%20n-tier%20applications.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/local-method-calls.md b/docs/framework/data/adonet/sql/linq/local-method-calls.md
new file mode 100644
index 00000000000..65f14b43b48
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/local-method-calls.md
@@ -0,0 +1,34 @@
+---
+title: "Local Method Calls | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c34b5012-aee9-4994-9364-1d99d12b7463
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Local Method Calls
+ローカル メソッド呼び出しとは、オブジェクト モデル内で実行される呼び出しです。  リモート メソッド呼び出しとは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が SQL に変換し、データベース エンジンに送信して実行される呼び出しです。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が呼び出しを SQL に変換できないときには、ローカル メソッド呼び出しが必要です。  それ以外の場合は、<xref:System.InvalidOperationException> がスローされます。  
+  
+## 例 1  
+ 次の例では、`Order` クラスは Northwind サンプル データベースの Orders テーブルに割り当てられています。  このクラスには、ローカル インスタンス メソッドが追加されています。  
+  
+ クエリ 1 では、`Order` クラスのコンストラクターがローカルで実行されます。  クエリ 2 では、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が `LocalInstanceMethod()` を SQL に変換しようとした場合は失敗し、<xref:System.InvalidOperationException> 例外がスローされるはずです。しかし、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はローカル メソッド呼び出しをサポートしているため、クエリ 2 で例外はスローされません。  
+  
+ [!code-csharp[DlinqLocalMethodCall#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqLocalMethodCall/cs/Program.cs#1)]
+ [!code-vb[DlinqLocalMethodCall#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqLocalMethodCall/vb/Module1.vb#1)]  
+  
+ [!code-csharp[DlinqLocalMethodCall#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqLocalMethodCall/cs/northwind.cs#2)]
+ [!code-vb[DlinqLocalMethodCall#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqLocalMethodCall/vb/northwind.vb#2)]  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md b/docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md
new file mode 100644
index 00000000000..b639d46effb
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md
@@ -0,0 +1,47 @@
+---
+title: "Making and Submitting Data Changes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d68c2dc3-99b3-49ab-b547-2ca5b386429a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Making and Submitting Data Changes
+このセクションのトピックでは、データベースを変更し、その変更を送信する方法と、オプティミスティック同時実行の競合を処理する方法について説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の `Insert`、`Update`、および `Delete` の既定のデータベース操作メソッドはオーバーライドできます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+>   
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、同じ用途のストアド プロシージャを開発できます。  
+  
+## このセクションの内容  
+ [How to: Insert Rows Into the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-insert-rows-into-the-database.md)  
+ オブジェクト モデルにオブジェクトを追加することにより、データベースに行を挿入する方法について説明します。  
+  
+ [How to: Update Rows in the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-update-rows-in-the-database.md)  
+ オブジェクト モデルのオブジェクトを更新することにより、データベースの行を更新する方法について説明します。  
+  
+ [How to: Delete Rows From the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md)  
+ オブジェクト モデルのオブジェクトを削除することにより、データベースの行を削除する方法について説明します。  
+  
+ [How to: Submit Changes to the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-submit-changes-to-the-database.md)  
+ オブジェクト モデルに対する変更をデータベースに送信する方法について説明します。  
+  
+ [How to: Bracket Data Submissions by Using Transactions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-bracket-data-submissions-by-using-transactions.md)  
+ トランザクションに操作を含める方法について説明します。  
+  
+ [How to: Dynamically Create a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md)  
+ 動的にデータベースを生成する方法と、この方法を使用する一般的なシナリオについて説明します。  
+  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)  
+ オプティミスティック同時実行制御の問題に対処する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/media/dlinq-3.png b/docs/framework/data/adonet/sql/linq/media/dlinq-3.png
new file mode 100644
index 00000000000..b3192811efc
Binary files /dev/null and b/docs/framework/data/adonet/sql/linq/media/dlinq-3.png differ
diff --git a/docs/framework/data/adonet/sql/linq/media/dlinqobjectmodel.png b/docs/framework/data/adonet/sql/linq/media/dlinqobjectmodel.png
new file mode 100644
index 00000000000..e39c00f9708
Binary files /dev/null and b/docs/framework/data/adonet/sql/linq/media/dlinqobjectmodel.png differ
diff --git a/docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md
new file mode 100644
index 00000000000..4a2dcdc272b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md
@@ -0,0 +1,44 @@
+---
+title: "N-Tier and Remote Applications with LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 854a1cdd-53cb-45f5-83ca-63962a9b3598
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# N-Tier and Remote Applications with LINQ to SQL
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用する n 層つまり多層アプリケーションを作成することができます。  通常、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] データ コンテキスト、エンティティ クラス、およびクエリ構築ロジックは、中間層にデータ アクセス層 \(DAL\) として置かれます。  ビジネス ロジックと非永続的データは、エンティティとデータ コンテキストの部分クラスと部分メソッドの中に完全に実装できます。または、別個のクラスに実装することもできます。  
+  
+ クライアントまたはプレゼンテーション層は、中間層のリモート インターフェイス上のメソッドを呼び出し、その層の DAL は、<xref:System.Data.Linq.DataContext> メソッドにマップされるクエリまたはストアド プロシージャを実行します。  中間層は、通常、エンティティまたはプロキシ オブジェクトの XML 表現としてデータをクライアントに返します。  
+  
+ 中間層では、データ コンテキストによってエンティティが作成され、データ コンテキストはエンティティの状態を追跡し、データベースからの遅延読み込み、および変更内容のデータベースへの送信を管理します。  これらのエンティティは、`DataContext` にいわばアタッチされます。  ただし、シリアル化によってエンティティが別の層に送られた後は、エンティティがデタッチされます。つまり、その状態が `DataContext` によって追跡されなくなります。  更新のためにクライアントによって戻されるエンティティは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が変更内容をデータベースに送信する前に、データ コンテキストに再びアタッチされる必要があります。  オプティミスティック同時実行チェックのために元の値またはタイムスタンプが必要とされる場合、クライアントはこれらを中間層に戻す必要があります。  
+  
+ ASP.NET アプリケーションでは、このような複雑な操作の大部分が <xref:System.Web.UI.WebControls.LinqDataSource> によって管理されます。  詳細については、「[NIB: LinqDataSource Web Server Control Overview](http://msdn.microsoft.com/ja-jp/104cfc3f-7385-47d3-8a51-830dfa791136)」を参照してください。  
+  
+## その他のリソース  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用する n 層アプリケーションの実装方法について、詳しくは以下のトピックを参照してください。  
+  
+-   [ASP.NET での LINQ to SQL N 層](../../../../../../docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-aspnet.md)  
+  
+-   [LINQ to SQL N\-Tier with Web Services](../../../../../../docs/framework/data/adonet/sql/linq/linq-to-sql-n-tier-with-web-services.md)  
+  
+-   [LINQ to SQL with Tightly\-Coupled Client\-Server Applications](../../../../../../docs/framework/data/adonet/sql/linq/linq-to-sql-with-tightly-coupled-client-server-applications.md)  
+  
+-   [Implementing N\-Tier Business Logic](../../../../../../docs/framework/data/adonet/sql/linq/implementing-business-logic-linq-to-sql.md)  
+  
+-   [Data Retrieval and CUD Operations in N\-Tier Applications \(LINQ to SQL\)](../../../../../../docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md)  
+  
+ ADO.NET DataSet を使用する n 層アプリケーションの詳細については、「[n 層アプリケーションでのデータセットの操作](../Topic/Work%20with%20datasets%20in%20n-tier%20applications.md)」を参照してください。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/null-semantics.md b/docs/framework/data/adonet/sql/linq/null-semantics.md
new file mode 100644
index 00000000000..fe7dc541ff7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/null-semantics.md
@@ -0,0 +1,30 @@
+---
+title: "null セマンティクス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a97017ae-d634-4cf3-bbaf-054a528fd683
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# null セマンティクス
+次の表では、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ドキュメントで `null` \(`Nothing` では [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\) について説明している各部分へのリンクを示します。  
+  
+|トピック|説明|  
+|----------|--------|  
+|[SQL\-CLR Type Mismatches](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md)|このトピックの「null セマンティクス」セクションでは、3 つの状態を持つ SQL のブール値と、2 つの状態を持つ共通言語ランタイム \(CLR: Common Language Runtime\) の <xref:System.Boolean>、`Nothing` \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\)、`null` \(C\#\)、および関連するその他の話題について説明します。|  
+|[Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)|このトピックの「null セマンティクス」セクションでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] での null の比較のセマンティクスについて説明します。|  
+|[System.String Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-string-methods.md)|このトピックの「.NET との相違」セクションでは、<xref:System.String.LastIndexOf%2A> の戻り値が 0 の場合に、文字列が null の場合と、見つかった位置が 0 の場合の両方があることについて説明します。|  
+|[Compute the Sum of Values in a Numeric Sequence](../../../../../../docs/framework/data/adonet/sql/linq/compute-the-sum-of-values-in-a-numeric-sequence.md)|null のみを含むシーケンス、または空のシーケンスの場合に、<xref:System.Linq.Enumerable.Sum%2A> 演算子が 0 ではなく `null` \(`Nothing` では [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\) に評価されることについて説明します。|  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/numeric-and-comparison-operators.md b/docs/framework/data/adonet/sql/linq/numeric-and-comparison-operators.md
new file mode 100644
index 00000000000..967abb0d354
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/numeric-and-comparison-operators.md
@@ -0,0 +1,70 @@
+---
+title: "Numeric and Comparison Operators | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 25b4a26a-06f2-4f80-87a9-76705ed46197
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Numeric and Comparison Operators
+算術演算子と比較演算子は、次の点を除いて、共通言語ランタイム \(CLR\) では期待どおりに動作します。  
+  
+-   SQL では、浮動小数点数に対して剰余演算子がサポートされません。  
+  
+-   SQL ではチェックされない算術はサポートされません。  
+  
+-   インクリメント演算子とデクリメント演算子は、SQL に複製できない式で使用すると副作用があるため、SQL ではサポートされません。  
+  
+## サポートされる演算子  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の演算子をサポートしています。  
+  
+-   基本算術演算子  
+  
+    -   `+`  
+  
+    -   `-` \(減算\)  
+  
+    -   `*`  
+  
+    -   `/`  
+  
+    -   Visual Basic 整数除算 \(`\`\)  
+  
+    -   `%` \(Visual Basic `Mod`\)  
+  
+    -   `<<`  
+  
+    -   `>>`  
+  
+    -   `-` \(単項マイナス符号\)  
+  
+-   基本比較演算子  
+  
+    -   Visual Basic `=` および C\# `==`  
+  
+    -   Visual Basic `<>` および C\# `!=`  
+  
+    -   Visual Basic `Is/IsNot`  
+  
+    -   `<`  
+  
+    -   `<=`  
+  
+    -   `>`  
+  
+    -   `>=`  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)   
+ [C\# 演算子](../Topic/C%23%20Operators.md)   
+ [Operators](../Topic/Operators%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/object-identity.md b/docs/framework/data/adonet/sql/linq/object-identity.md
new file mode 100644
index 00000000000..899528f5295
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/object-identity.md
@@ -0,0 +1,50 @@
+---
+title: "Object Identity | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c788f2f9-65cc-4455-9907-e8388a268e00
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Object Identity
+実行時のオブジェクトは、一意の ID を持ちます。  2 つの変数が同じオブジェクトを参照している場合、実際それらの変数は、そのオブジェクトの同じインスタンスを参照しています。  したがって、一方の変数から加えた変更は、もう一方の変数から直ちに参照できます。  
+  
+ リレーショナル データベースのテーブルの行は、一意の ID を持ちません。  それぞれの行は一意の主キーを持つので、同じキー値を持つ行が存在することはありません。  しかしこれは、データベース テーブルの中だけでの制限です。  
+  
+ 実際には、データベースの外にデータを取り出して、別の層に移し、そこでアプリケーションが処理を行うのが普通です。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がサポートするのはこのモデルです。  データベースからデータを行として取り出す場合、同じデータを表す 2 つの行が、実際に同じ行インスタンスに対応付けられることは求めません。  ある特定の顧客についてのクエリを 2 回行うと、2 行のデータが取得されます。どちらの行も、内容は同じ情報です。  
+  
+ オブジェクトの場合、求める動作は大きく異なります。  <xref:System.Data.Linq.DataContext> に対して同じ情報を繰り返し要求した場合、同じオブジェクト インスタンスが返されることを期待します。  そのような動作を期待するのは、オブジェクトはアプリケーションにとって特別な意味を持つものであり、オブジェクトらしい動作が求められるためです。  オブジェクトは階層やグラフとして設計されています。  そして、そのように取得されることを期待します。同じデータを何回か要求したからといって、レプリケートされたインスタンスをいくつも返されることは期待しません。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、オブジェクト ID は <xref:System.Data.Linq.DataContext> によって管理されます。  データベースから新しい行を取得すると、主キーに基づいてその行が ID テーブルに記録され、新しいオブジェクトが作成されます。  それと同じ行を取得した場合、最初のオブジェクト インスタンスがアプリケーションに返されます。  <xref:System.Data.Linq.DataContext> は、このような方法で、データベースにおける ID の概念 \(つまり主キー\) を、言語における ID の概念 \(つまりインスタンス\) に置き換えます。  アプリケーションが参照するオブジェクトは、常に最初に取得した状態です。  新しいデータが異なる場合、破棄されます。  詳細については、「[Retrieving Objects from the Identity Cache](../../../../../../docs/framework/data/adonet/sql/linq/retrieving-objects-from-the-identity-cache.md)」を参照してください。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オプティミスティック更新をサポートするために、この方法を使用してローカル オブジェクトの整合性を維持します。  オブジェクトが最初に作成された後で生じた変更は、アプリケーションが加えた変更だけなので、アプリケーションの意図は明確です。  その間に外部の者によって変更が加えられた場合、`SubmitChanges()` を呼び出した時点で把握されます。  
+  
+> [!NOTE]
+>  クエリで要求されたオブジェクトが、既に取得済みであることが簡単に判別できる場合、クエリは実行されません。  ID テーブルは、それまでに取得した全オブジェクトのキャッシュの役割を果たします。  
+  
+## 例  
+  
+### オブジェクトのキャッシュの例 1  
+ この例では、同じクエリを 2 回実行した場合、メモリ内にある同じオブジェクトへの参照をそのつど受け取ります。  
+  
+ [!code-csharp[DLinqObjectIdentity#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectIdentity/cs/Program.cs#1)]
+ [!code-vb[DLinqObjectIdentity#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectIdentity/vb/Module1.vb#1)]  
+  
+### オブジェクトのキャッシュの例 2  
+ この例では、データベースの同じ行を返す、異なるクエリを実行した場合、メモリ内にある同じオブジェクトへの参照をそのつど受け取ります。  
+  
+ [!code-csharp[DLinqObjectIdentity#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectIdentity/cs/Program.cs#2)]
+ [!code-vb[DLinqObjectIdentity#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectIdentity/vb/Module1.vb#2)]  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/object-states-and-change-tracking.md b/docs/framework/data/adonet/sql/linq/object-states-and-change-tracking.md
new file mode 100644
index 00000000000..41466ddfdeb
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/object-states-and-change-tracking.md
@@ -0,0 +1,74 @@
+---
+title: "Object States and Change-Tracking | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a808b00-9c3c-479a-aa94-717280fefd71
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Object States and Change-Tracking
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクトは常に、いずれかの*状態*にあります。  たとえば、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が新しいオブジェクトを作成すると、そのオブジェクトは `Unchanged` 状態です。  ユーザーが作成する新しいオブジェクトは <xref:System.Data.Linq.DataContext> にとって不明であり、`Untracked` 状態です。  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> が正常に実行されると、すべてのオブジェクトが [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] にとって既知となり、`Unchanged` 状態になります   \(データベースから削除されたオブジェクトは例外です。これは `Deleted` 状態であり、<xref:System.Data.Linq.DataContext> インスタンスの中で使用できません\)。  
+  
+## オブジェクトの状態  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクトで有効な状態を次の表に示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|`Untracked`|[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって追跡されないオブジェクト。  具体的には次のものがあります。<br /><br /> -   現在の <xref:System.Data.Linq.DataContext> を通じて照会されないオブジェクト \(新規作成されたオブジェクトなど\)。<br />-   逆シリアル化を通じて作成されたオブジェクト。<br />-   異なる <xref:System.Data.Linq.DataContext> を通じて照会されるオブジェクト。|  
+|`Unchanged`|現在の <xref:System.Data.Linq.DataContext> を使用して取得され、作成後に変更された履歴がないオブジェクト。|  
+|`PossiblyModified`|<xref:System.Data.Linq.DataContext> に*アタッチ*されているオブジェクト。  詳細については、「[Data Retrieval and CUD Operations in N\-Tier Applications \(LINQ to SQL\)](../../../../../../docs/framework/data/adonet/sql/linq/data-retrieval-and-cud-operations-in-n-tier-applications.md)」を参照してください。|  
+|`ToBeInserted`|現在の <xref:System.Data.Linq.DataContext> を使用して取得されていないオブジェクト。  この場合、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> 中にデータベースの `INSERT` が発生します。|  
+|`ToBeUpdated`|取得後に変更された履歴があるオブジェクト。  この場合、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> 中にデータベースの `UPDATE` が発生します。|  
+|`ToBeDeleted`|削除がマークされているオブジェクト。<xref:System.Data.Linq.DataContext.SubmitChanges%2A> 中にデータベースの `DELETE` が発生します。|  
+|`Deleted`|データベース内で削除されたオブジェクト。  これは最後の状態であり、次の状態に移行できません。|  
+  
+## オブジェクトの挿入  
+ <xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> を使用して、`Inserts` を明示的に要求できます。  または、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、更新する必要がある既知のオブジェクトの 1 つに接続しているオブジェクトを見つけることによって、`Inserts` を推論できます。  たとえば、`Untracked` オブジェクトを <xref:System.Data.Linq.EntitySet%601> に追加するか、<xref:System.Data.Linq.EntityRef%601> を `Untracked` オブジェクトに設定すると、グラフ内の追跡オブジェクトを通じて、`Untracked` オブジェクトにアクセスできるようになります。  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> の実行中、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は追跡オブジェクトをスキャンして、追跡されていないアクセス可能な永続オブジェクトを見つけます。  このようなオブジェクトは、データベースへの挿入候補です。  
+  
+ また、継承階層内のクラスの場合、<xref:System.Data.Linq.Table%601.InsertOnSubmit%2A>\(`o`\) は、*識別子*として指定されているメンバーの値が、オブジェクト `o` の型に一致するように設定します。  既定の識別子の値の型が一致する場合、この操作によって、識別子の値が既定値で上書きされます。  詳細については、「[Inheritance Support](../../../../../../docs/framework/data/adonet/sql/linq/inheritance-support.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  `Table` に追加されたオブジェクトは、ID キャッシュにはありません。  ID キャッシュは、データベースから取得されたもののみを反映します。  <xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> を呼び出した後、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> が正常終了するまで、追加されたエンティティはデータベースに対するクエリで使用されません。  
+  
+## オブジェクトの削除  
+ 適切な <xref:System.Data.Linq.Table%601> で <xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A>\(o\) を呼び出すことにより、追跡オブジェクト `o` に削除のマークを付けることができます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Data.Linq.EntitySet%601> からのオブジェクトの削除は更新操作と見なされ、対応する外部キー値は null に設定されます。  操作の対象 \(`o`\) はテーブルから削除されません。  たとえば、`cust.Orders.DeleteOnSubmit(ord)` は、外部キー `ord.CustomerID` を null に設定することによって `cust` と `ord` のリレーションシップが切断される更新を表します。  `ord` に対応する行の削除は行われません。  
+  
+ テーブルからオブジェクトを削除すると \(<xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A>\)、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は次の処理を実行します。  
+  
+-   <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すときに、そのオブジェクトに対して `DELETE` 操作が実行されます。  
+  
+-   関連オブジェクトが読み込まれているかどうかにかかわらず、関連オブジェクトに削除は反映されません。  特に、リレーションシップ プロパティを更新するために関連オブジェクトが読み込まれることはありません。  
+  
+-   <xref:System.Data.Linq.DataContext.SubmitChanges%2A> が正常に実行されると、オブジェクトは `Deleted` 状態に設定されます。  その結果、その <xref:System.Data.Linq.DataContext> で、オブジェクトまたはその `id` を使用することはできません。  データベース内でオブジェクトが削除された後でも、<xref:System.Data.Linq.DataContext> インスタンスによって保持される内部キャッシュは、取得されたオブジェクトや新規として追加されたオブジェクトを消去しません。  
+  
+ <xref:System.Data.Linq.DataContext> によって追跡されたオブジェクトでのみ、<xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A> を呼び出すことができます。  `Untracked` オブジェクトの場合は、<xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A> を呼び出す前に <xref:System.Data.Linq.Table%601.Attach%2A> を呼び出す必要があります。  `Untracked` オブジェクトで <xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A> を呼び出すと、例外がスローされます。  
+  
+> [!NOTE]
+>  テーブルからオブジェクトを削除すると、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> が呼び出されたときに、対応する SQL `DELETE` コマンドが [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって生成されることになります。  この処理によって、キャッシュからオブジェクトが削除されたり、関連オブジェクトに削除が反映されることはありません。  
+>   
+>  削除されたオブジェクトの `id` を再要求するには、新しい <xref:System.Data.Linq.DataContext> インスタンスを使用します。  関連オブジェクトをクリーンアップするには、データベースの*連鎖削除*機能を使用するか、関連オブジェクトを手動で削除します。  
+>   
+>  関連オブジェクトは、データベースの場合とは異なり、特別な順序で削除する必要はありません。  
+  
+## オブジェクトの更新  
+ 変更の通知を確認することで、`Updates` を検出できます。  通知は、プロパティ Set アクセス操作子の <xref:System.ComponentModel.INotifyPropertyChanging.PropertyChanging> イベントを通じて提供されます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オブジェクトへの最初の変更が通知されると、オブジェクトのコピーを作成し、オブジェクトを、`Update` ステートメントを生成する候補と見なします。  
+  
+ <xref:System.ComponentModel.INotifyPropertyChanging> を実装していないオブジェクトの場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オブジェクトが最初に実体化されたときの値のコピーを保持します。  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すと、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、現在の値と元の値を比較して、オブジェクトが変更されたかどうかを判断します。  
+  
+ リレーションシップの更新の場合、子から親への参照 \(つまり、外部キーに対応する参照\) が基準と見なされます。  逆方向 \(つまり、親から子\) の参照はオプションです。  リレーションシップ クラス \(<xref:System.Data.Linq.EntitySet%601> および <xref:System.Data.Linq.EntityRef%601>\) は、一対多および一対一のリレーションシップで双方向の参照が一致することを保証します。  オブジェクト モデルが <xref:System.Data.Linq.EntitySet%601> または <xref:System.Data.Linq.EntityRef%601> を使用していない場合、かつ、逆方向の参照が存在する場合は、ユーザーが、リレーションシップが更新されるときに前方参照と一致するようにする必要があります。  
+  
+ 要求される参照と対応する外部キーの両方を更新する場合は、両者が一致する必要があります。  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出したときに 2 つが同期しない場合は、<xref:System.InvalidOperationException> 例外がスローされます。  外部キー値を変更するだけで、基になる行を更新することはできますが、オブジェクト グラフの接続と、リレーションシップの双方向の一貫性を保持するには、参照を変更する必要があります。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/insert-update-and-delete-operations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md b/docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md
new file mode 100644
index 00000000000..7f638552c72
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/optimistic-concurrency-overview.md
@@ -0,0 +1,99 @@
+---
+title: "Optimistic Concurrency: Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2e38512-d0c8-4807-b30a-cb7e30338694
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Optimistic Concurrency: Overview
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はオプティミスティック同時実行制御をサポートします。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ドキュメントでオプティミスティック同時実行の説明に使用している用語を次の表に示します。  
+  
+|用語|説明|  
+|--------|--------|  
+|同時実行|2 人以上のユーザーがデータベースの同じ行を同時に更新しようとした状況のことです。|  
+|同時実行の競合|2 人以上のユーザーが、行の中の 1 つまたは複数の列に対し、互いに競合する値を送信しようとした状況のことです。|  
+|同時実行制御|同時実行の競合を解決するために使用する手法のことです。|  
+|オプティミスティック同時実行制御|他のトランザクションが行の値に変更を加えていないかどうかをまず調べたうえで変更の送信を許可する手法のことです。<br /><br /> これと対照的なのが*ペシミスティック同時実行制御*で、レコードをロックすることで同時実行の競合を防ぎます。<br /><br /> *オプティミスティック* \(楽観的\) という名前が付いているのは、トランザクションどうしが競合する可能性は小さいものと見なす方法であるためです。|  
+|競合の解決|データベースを再度クエリしてから相違点を調整することによって競合する項目を更新する処理のことです。<br /><br /> オブジェクトを更新するときには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の変更トラッカーによって、以下のデータが記録されます。<br /><br /> -   データベースからもともと取得し、更新チェックに使用した値。<br />-   その後のクエリで取得した新しいデータベース値。<br /><br /> 次に [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、オブジェクトが競合しているかどうか \(つまり 1 つまたは複数のメンバー値が変更されているかどうか\) を判断します。  オブジェクトが競合している場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は次に、どのメンバーが競合しているかを判断します。<br /><br /> [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が見つけたメンバーの競合は、競合の一覧に追加されます。|  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のオブジェクト モデルで*オプティミスティック同時実行の競合*が発生するのは、次の 2 つの条件が両方とも成り立つ場合です。  
+  
+-   クライアントがデータベースに変更を送信しようとした。  
+  
+-   データベースで、そのクライアントによる最後の読み取り以降に、1 つまたは複数の更新チェック値が更新されている。  
+  
+ この競合を解決するためには、オブジェクトのどのメンバーが競合しているかを判別し、どのように対処するかを決定することが必要です。  
+  
+> [!NOTE]
+>  オプティミスティック同時実行のチェックに関与するのは、<xref:System.Data.Linq.Mapping.UpdateCheck> または <xref:System.Data.Linq.Mapping.UpdateCheck> として割り当てられているメンバーのみです。  <xref:System.Data.Linq.Mapping.UpdateCheck> と指定されているメンバーには、チェックは実行されません。  詳細については、「<xref:System.Data.Linq.Mapping.UpdateCheck>」を参照してください。  
+  
+## 例  
+ 次のシナリオは、ユーザー 1 が、更新の手始めとして、データベースの行をクエリした状況です。  ユーザー 1 が取得した行には、Alfreds、Maria、および Sales という値が入っています。  
+  
+ ユーザー 1 は、Manager 列の値を Alfred に、また Department 列の値を Marketing に、それぞれ変更しようと考えています。  しかし、ユーザー 1 がその変更を発行する前に、ユーザー 2 がデータベースに変更を送信しました。  その結果、Assistant 列の値は Mary に、また Department 列の値は Service に、それぞれ変更されました。  
+  
+ ここで、ユーザー 1 が変更を送信しようとすると、送信は失敗し、<xref:System.Data.Linq.ChangeConflictException> 例外がスローされます。  このような結果になるのは、データベースの Assistant 列と Department 列の値が、予期した値と異なるためです。  Assistant 列と Department 列を表すメンバーが競合しています。  この状況をまとめると次の表のようになります。  
+  
+||Manager|Assistant|Department|  
+|------|-------------|---------------|----------------|  
+|元の状態|Alfreds|Maria|Sales|  
+|ユーザー 1|Alfred||Marketing|  
+|ユーザー 2||Mary|サービス|  
+  
+ このような競合は、いくつかの方法で解決できます。  詳細については、「[How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)」を参照してください。  
+  
+## 競合の検出と解決のチェック リスト  
+ 競合の検出と解決は、さまざまな詳細レベルで行うことができます。  極端な方法としては、すべての競合を 3 つの方法 \(<xref:System.Data.Linq.RefreshMode> を参照\) のいずれかで 1 つで解決し、それ以外の考慮を一切加えないという方法もあります。  正反対の方法としては、競合している各メンバーについて、それぞれの競合の種類ごとに、特定の処理を指定するという方法もあります。  
+  
+-   オブジェクト モデルの <xref:System.Data.Linq.Mapping.UpdateCheck> オプションを指定または変更します。  
+  
+     詳細については、「[How to: Specify Which Members are Tested for Concurrency Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md)」を参照してください。  
+  
+-   <xref:System.Data.Linq.DataContext.SubmitChanges%2A> の呼び出しの try\/catch ブロックで、例外がどの時点でスローされるかを指定します。  
+  
+     詳細については、「[How to: Specify When Concurrency Exceptions are Thrown](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md)」を参照してください。  
+  
+-   取得する競合の詳細さを判断し、それに応じたコードを try\/catch ブロックに記述します。  
+  
+     詳細については、「[How to: Retrieve Entity Conflict Information](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-entity-conflict-information.md)」および「[How to: Retrieve Member Conflict Information](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-member-conflict-information.md)」を参照してください。  
+  
+-   `try`\/`catch` コードで、発見されたさまざまな競合を解決する方法を指定します。  
+  
+     詳細については、「[How to: Resolve Conflicts by Retaining Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-retaining-database-values.md)」、「[How to: Resolve Conflicts by Overwriting Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-overwriting-database-values.md)」、および「[How to: Resolve Conflicts by Merging with Database Values](../../../../../../docs/framework/data/adonet/sql/linq/how-to-resolve-conflicts-by-merging-with-database-values.md)」を参照してください。  
+  
+## 競合の発見と解決をサポートする LINQ to SQL の型  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で、オプティミスティック同時実行の競合の解決をサポートするクラスと機能を以下に示します。  
+  
+-   <xref:System.Data.Linq.ObjectChangeConflict?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.MemberChangeConflict?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.ChangeConflictCollection?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.ChangeConflictException?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.DataContext.ChangeConflicts%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.DataContext.SubmitChanges%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.DataContext.Refresh%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.Mapping.ColumnAttribute.UpdateCheck%2A?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.Mapping.UpdateCheck?displayProperty=fullName>  
+  
+-   <xref:System.Data.Linq.RefreshMode?displayProperty=fullName>  
+  
+## 参照  
+ [How to: Manage Change Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-manage-change-conflicts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/programming-guide.md b/docs/framework/data/adonet/sql/linq/programming-guide.md
new file mode 100644
index 00000000000..11cc322f097
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/programming-guide.md
@@ -0,0 +1,51 @@
+---
+title: "プログラミング ガイド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed1012d4-3ff2-4877-af27-93125c4180ea
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# プログラミング ガイド
+ここでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のオブジェクト モデルを作成および使用する方法について説明します。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、同じタスクの多くを[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]でも実行できます。  
+  
+ 特定の問題について MSDN ライブラリを検索したり、[LINQ フォーラム](http://go.microsoft.com/fwlink/?LinkId=76488)に参加して、複雑なトピックについて専門家と検討したりすることもできます。  また、「[LINQ to SQL: リレーショナル データのための .NET 統合言語クエリ](http://go.microsoft.com/fwlink/?LinkId=93205)」ホワイト ペーパーには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジの詳細と、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のコード例が記載されています。  
+  
+## このセクションの内容  
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)  
+ オブジェクト モデルを生成する方法について説明します。  
+  
+ [Communicating with the Database](../../../../../../docs/framework/data/adonet/sql/linq/communicating-with-the-database.md)  
+ データベースへのコンジットとして <xref:System.Data.Linq.DataContext> オブジェクトを使用する方法について説明します。  
+  
+ [Querying the Database](../../../../../../docs/framework/data/adonet/sql/linq/querying-the-database.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] でクエリを実行する方法を説明し、多数の例を示します。  
+  
+ [Making and Submitting Data Changes](../../../../../../docs/framework/data/adonet/sql/linq/making-and-submitting-data-changes.md)  
+ データベース内のデータを変更する方法について説明します。  
+  
+ [Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトのデバッグ機能について説明します。  
+  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)  
+ 同時実行の競合の解決、新しいデータベースの作成など、上級ユーザー向けの追加項目が記載されています。  
+  
+## 関連項目  
+ [LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/index.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジの説明および機能の解説が記載されているトピックへのリンクを示します。  
+  
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)  
+ ストアド プロシージャの使用手順のトピックへのリンクを示します。  
+  
+ [Introduction to LINQ](../../../../../../ocs/visual-basic/programming-guide/language-features/linq/introduction-to-linq.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使い始めるときに役立つリソースを示します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/query-concepts.md b/docs/framework/data/adonet/sql/linq/query-concepts.md
new file mode 100644
index 00000000000..879d132af32
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/query-concepts.md
@@ -0,0 +1,43 @@
+---
+title: "Query Concepts | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a125749-ccb5-49d5-999d-d2db7171d74d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Concepts
+このセクションでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリを設計するうえでの主要な概念について説明します。  
+  
+## このセクションの内容  
+ [LINQ to SQL Queries](../../../../../../docs/framework/data/adonet/sql/linq/linq-to-sql-queries.md)  
+ 一般的な [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] トピックを参照し、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 固有のアイテムについて説明します。  
+  
+ [Querying Across Relationships](../../../../../../docs/framework/data/adonet/sql/linq/querying-across-relationships.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルで関連付けを使用する方法について説明します。  
+  
+ [Remote vs. Local Execution](../../../../../../docs/framework/data/adonet/sql/linq/remote-vs-local-execution.md)  
+ クエリの実行場所を指定する方法について説明します。  
+  
+ [Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)  
+ 関連オブジェクトをいつ読み込むかを指定する方法について説明します。  
+  
+## 関連項目  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジについて説明するトピックへのリンクを示します。  
+  
+ [Object Identity](../../../../../../docs/framework/data/adonet/sql/linq/object-identity.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のオブジェクト識別子の概念について説明します。  
+  
+ [Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] のクエリ操作の概要について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/query-examples.md b/docs/framework/data/adonet/sql/linq/query-examples.md
new file mode 100644
index 00000000000..57e6806a52d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/query-examples.md
@@ -0,0 +1,82 @@
+---
+title: "Query Examples | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 137f8677-494c-4d49-95ce-c17742f2d01f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Query Examples
+このセクションでは、[!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# で一般的な [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリの例を示して説明します。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、「サンプル」セクションに多数のサンプル ソリューションが用意されています。  詳細については、「[Samples](../../../../../../docs/framework/data/adonet/sql/linq/samples.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  *db* は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ドキュメントのコード サンプルでよく使用されます。  *db* は、*Northwind* クラスのインスタンスであることが前提です。このクラスは、<xref:System.Data.Linq.DataContext> から継承されます。  
+  
+## このセクションの内容  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)  
+ <xref:System.Linq.Enumerable.Average%2A>、<xref:System.Linq.Enumerable.Count%2A> などの使用方法について説明します。  
+  
+ [Return the First Element in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/return-the-first-element-in-a-sequence.md)  
+ <xref:System.Linq.Enumerable.First%2A> の使用例を示して説明します。  
+  
+ [Return Or Skip Elements in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/return-or-skip-elements-in-a-sequence.md)  
+ <xref:System.Linq.Enumerable.Take%2A> および <xref:System.Linq.Enumerable.Skip%2A> の使用例を示して説明します。  
+  
+ [Sort Elements in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/sort-elements-in-a-sequence.md)  
+ <xref:System.Linq.Enumerable.OrderBy%2A> の使用例を示して説明します。  
+  
+ [Group Elements in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/group-elements-in-a-sequence.md)  
+ <xref:System.Linq.Enumerable.GroupBy%2A> の使用例を示して説明します。  
+  
+ [Eliminate Duplicate Elements from a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/eliminate-duplicate-elements-from-a-sequence.md)  
+ <xref:System.Linq.Enumerable.Distinct%2A> の使用例を示して説明します。  
+  
+ [Determine if Any or All Elements in a Sequence Satisfy a Condition](../../../../../../docs/framework/data/adonet/sql/linq/determine-if-any-or-all-elements-in-a-sequence-satisfy-a-condition.md)  
+ <xref:System.Linq.Enumerable.All%2A> および <xref:System.Linq.Enumerable.Any%2A> の使用例を示して説明します。  
+  
+ [Concatenate Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/concatenate-two-sequences.md)  
+ <xref:System.Linq.Enumerable.Concat%2A> の使用例を示して説明します。  
+  
+ [Return the Set Difference Between Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-difference-between-two-sequences.md)  
+ <xref:System.Linq.Enumerable.Except%2A> の使用例を示して説明します。  
+  
+ [Return the Set Intersection of Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-intersection-of-two-sequences.md)  
+ <xref:System.Linq.Enumerable.Intersect%2A> の使用例を示して説明します。  
+  
+ [Return the Set Union of Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-union-of-two-sequences.md)  
+ <xref:System.Linq.Enumerable.Union%2A> の使用例を示して説明します。  
+  
+ [Convert a Sequence to an Array](../../../../../../docs/framework/data/adonet/sql/linq/convert-a-sequence-to-an-array.md)  
+ <xref:System.Linq.Enumerable.ToArray%2A> の使用例を示して説明します。  
+  
+ [Convert a Sequence to a Generic List](../../../../../../docs/framework/data/adonet/sql/linq/convert-a-sequence-to-a-generic-list.md)  
+ <xref:System.Linq.Enumerable.ToList%2A> の使用例を示して説明します。  
+  
+ [Convert a Type to a Generic IEnumerable](../../../../../../docs/framework/data/adonet/sql/linq/convert-a-type-to-a-generic-ienumerable.md)  
+ <xref:System.Linq.Enumerable.AsEnumerable%2A> の使用例を示して説明します。  
+  
+ [Formulate Joins and Cross\-Product Queries](../../../../../../docs/framework/data/adonet/sql/linq/formulate-joins-and-cross-product-queries.md)  
+ `from` 句、`where` 句、および `select` 句で外部キーを移動する方法の例を示して説明します。  
+  
+ [Formulate Projections](../../../../../../docs/framework/data/adonet/sql/linq/formulate-projections.md)  
+ `select` と他の機能 \(*匿名型*など\) を組み合わせてクエリ射影を作成する方法の例を示して説明します。  
+  
+## 関連項目  
+ [Standard Query Operators Overview](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)  
+ 標準クエリ演算子の概念について説明します。  
+  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)  
+ クエリに関する概念が [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] でどのように使用されるかを説明します。  
+  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に関連するプログラミングの概念を説明するトピックへのポータルです。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/querying-across-relationships.md b/docs/framework/data/adonet/sql/linq/querying-across-relationships.md
new file mode 100644
index 00000000000..93edc8a77a0
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/querying-across-relationships.md
@@ -0,0 +1,60 @@
+---
+title: "Querying Across Relationships | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 297878d0-685b-4c01-b2e0-9d731b7322bc
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# Querying Across Relationships
+他のオブジェクトまたは他のオブジェクトのコレクションをクラス定義内で参照することは、データベース内の外部キー リレーションシップに直接対応します。  クエリを実行するときにこのリレーションシップを使用するには、ドット表記を使ってリレーションシップ プロパティにアクセスし、オブジェクト間を移動します。  これらのアクセス操作は、SQL で同等の複雑な結合または相関サブクエリとして変換されます。  
+  
+ たとえば、次のクエリでは、ロンドン在住の顧客からの注文のみが結果として得られるように注文から顧客へと移動します。  
+  
+ [!code-csharp[DLinqQueryConcepts#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#3)]
+ [!code-vb[DLinqQueryConcepts#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#3)]  
+  
+ リレーションシップ プロパティが存在しない場合は、これを*結合*として、SQL で記述するときと同じように手動で作成する必要があります。次にコードの例を示します。  
+  
+ [!code-csharp[DLinqQueryConcepts#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#4)]
+ [!code-vb[DLinqQueryConcepts#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#4)]  
+  
+ このようなリレーションシップは、*リレーションシップ* プロパティを使用すると一度に定義できます。  こうすると、使いやすいドット構文を使用できるようになります。  しかし、それだけがリレーションシップ プロパティの利点ではありません。なぜなら、通常はドメイン固有のオブジェクト モデルは階層構造またはグラフとして定義されるからです。  プログラムで使用するオブジェクトには他のオブジェクトへの参照が含まれます。  このオブジェクト間リレーションシップがデータベースの外部キー型リレーションシップに相当するのは、単なる幸運な偶然です。  プロパティへのアクセスは、結合を記述するための便利な方法となります。  
+  
+ この点では、リレーションシップ プロパティは、クエリそのものよりもクエリの結果でより重要です。  クエリによって特定の顧客に関するデータが取得された後で、クラス定義ではその顧客の注文が存在することが示されます。  つまり、特定の顧客の `Orders` プロパティにその顧客のすべての注文が含まれると見なすことができます。  実際には、これはクラスをこのように定義することにより宣言したコントラクトです。  クエリによって注文が要求されなかった場合でも、ここに注文が含まれていると見なすことができます。  オブジェクト モデルに対して期待されるのは、それがデータベースがメモリ内に拡張されたものであり、関連オブジェクトがすぐに使用できる状態にある、という錯覚を維持することです。  
+  
+ リレーションシップが得られたので、クラスに定義されたリレーションシップ プロパティを参照してクエリを作成できます。  これらのリレーションシップ参照は、データベース内の外部キー リレーションシップに対応します。  これらのリレーションシップを使用する操作は、SQL で同等の複雑な結合として変換されます。  <xref:System.Data.Linq.Mapping.AssociationAttribute> 属性を使用してリレーションシップを定義している限りは、明示的な結合を [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で記述する必要はありません。  
+  
+ この錯覚を維持するために、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] には*遅延読み込み*と呼ばれる機能が実装されています。  詳細については、「[Deferred versus Immediate Loading](../../../../../../docs/framework/data/adonet/sql/linq/deferred-versus-immediate-loading.md)」を参照してください。  
+  
+ たとえば、`CustomerID`\-`OrderID` ペアのリストを射影する次の SQL クエリがあるとします。  
+  
+```  
+SELECT t0.CustomerID, t1.OrderID  
+FROM   Customers AS t0 INNER JOIN  
+          Orders AS t1 ON t0.CustomerID = t1.CustomerID  
+WHERE  (t0.City = @p0)  
+```  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用して同じ結果を得るには、`Orders` クラスに既に存在する `Customer` プロパティ参照を使用します。  次のコードに示すとおり、`Orders` 参照からは、クエリを実行し、`CustomerID`\-`OrderID` ペアを射影するために必要な情報が提供されます。  
+  
+ [!code-csharp[DLinqQueryConcepts#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#5)]
+ [!code-vb[DLinqQueryConcepts#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#5)]  
+  
+ 逆の操作も可能です。  つまり、`Orders` にクエリを実行し、その `Customer` リレーションシップ参照を使用して、関連付けられた `Customer` オブジェクトに関する情報にアクセスできます。  次のコードでは、前の例と同じ `CustomerID`\-`OrderID` ペアを射影しますが、ここでは `Orders` ではなく `Customers` にクエリを実行しています。  
+  
+ [!code-csharp[DLinqQueryConcepts#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#6)]
+ [!code-vb[DLinqQueryConcepts#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#6)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/querying-the-database.md b/docs/framework/data/adonet/sql/linq/querying-the-database.md
new file mode 100644
index 00000000000..87adca8f20c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/querying-the-database.md
@@ -0,0 +1,54 @@
+---
+title: "Querying the Database | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eefb8b0c-ff07-4e86-a3d3-567479523fe9
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Querying the Database
+ここでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトにおけるクエリの開発と実行の方法について説明します。  
+  
+## このセクションの内容  
+ [How to: Query for Information](../../../../../../docs/framework/data/adonet/sql/linq/how-to-query-for-information.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のクエリが、基本的には [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] のクエリとほとんど同じであることを簡単に説明します。  
+  
+ [How to: Retrieve Information As Read\-Only](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-information-as-read-only.md)  
+ データを変更する必要がない場合に、クエリのパフォーマンスを向上させる方法について説明します。  
+  
+ [How to: Control How Much Related Data Is Retrieved](../../../../../../docs/framework/data/adonet/sql/linq/how-to-control-how-much-related-data-is-retrieved.md)  
+ メイン ターゲットと一緒にどの関連データを取得するかを制御する方法について説明します。  
+  
+ [How to: Filter Related Data](../../../../../../docs/framework/data/adonet/sql/linq/how-to-filter-related-data.md)  
+ サブクエリを使用して関連データを取得する方法について説明します。  
+  
+ [How to: Turn Off Deferred Loading](../../../../../../docs/framework/data/adonet/sql/linq/how-to-turn-off-deferred-loading.md)  
+ 遅延読み込みをオフにする方法について説明します。  
+  
+ [How to: Directly Execute SQL Queries](../../../../../../docs/framework/data/adonet/sql/linq/how-to-directly-execute-sql-queries.md)  
+ SQL 言語を使用してクエリを発行する方法について説明します。  
+  
+ [How to: Store and Reuse Queries](../../../../../../docs/framework/data/adonet/sql/linq/how-to-store-and-reuse-queries.md)  
+ クエリを 1 回だけコンパイルし、異なるパラメーターで複数回使用する方法について説明します。  
+  
+ [How to: Handle Composite Keys in Queries](../../../../../../docs/framework/data/adonet/sql/linq/how-to-handle-composite-keys-in-queries.md)  
+ 演算子が 1 つの引数しか受け取らない場合に、複数の列を 1 つのクエリに含める方法について説明します。  
+  
+ [How to: Retrieve Many Objects At Once](../../../../../../docs/framework/data/adonet/sql/linq/how-to-retrieve-many-objects-at-once.md)  
+ <xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> の使用方法について説明します。  
+  
+ [How to: Filter at the DataContext Level](../../../../../../docs/framework/data/adonet/sql/linq/how-to-filter-at-the-datacontext-level.md)  
+ <xref:System.Data.Linq.DataLoadOptions.LoadWith%2A> のもう 1 つの使用方法について説明します。  
+  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)  
+ クエリの例を多数示します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/reference.md b/docs/framework/data/adonet/sql/linq/reference.md
new file mode 100644
index 00000000000..7465d5b376a
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/reference.md
@@ -0,0 +1,54 @@
+---
+title: "Reference | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 312c3935-a947-4220-a837-0039d9fc458b
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Reference
+このセクションには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用する開発者向けのリファレンス情報が用意されています。  
+  
+ 特定の問題について MSDN ライブラリを検索し、特に [LINQ フォーラム](http://go.microsoft.com/fwlink/?LinkId=76488)に参加して、複雑なトピックについて専門家と検討することをお勧めします。  また、Visual Basic および C\# のコード例を含む、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジについて記載されているホワイト ペーパーを参照することもできます。  詳細については、「[LINQ to SQL: リレーショナル データのための .NET 統合言語クエリ](http://go.microsoft.com/fwlink/?LinkId=93205)」を参照してください。  
+  
+## このセクションの内容  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が変換エンジンで変換を明示的に提供する場合のみ、共通言語ランタイム \(CLR\) コンストラクトが SQL の対応する式を持つことについて説明します。  
+  
+ [Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルを SQL Server データベースに対応付ける [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 属性ベース方式について説明します。  
+  
+ [Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] でデータベースからメタ情報が取得され、コード ファイルが生成される過程について説明します。  
+  
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルを SQL Server データベースに対応付ける [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 外部マッピング方式について説明します。  マッピング ファイルの XSD スキーマ定義を示して説明します。  
+  
+ [Frequently Asked Questions](../../../../../../docs/framework/data/adonet/sql/linq/frequently-asked-questions.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に関してよく寄せられる質問への回答を示します。  
+  
+ [SQL Server Compact and LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/sql-server-compact-and-linq-to-sql.md)  
+ [!INCLUDE[ssEW](../../../../../../includes/ssew-md.md)] と [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションの [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] の違いについて説明します。  
+  
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] による標準クエリ演算子から SQL コマンドへの変換について説明します。  
+  
+## 関連項目  
+ [LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/index.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 関連トピックのポータルを提供します。  
+  
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)  
+ [!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] 関連トピックのポータルを提供します。  
+  
+ [LinqDataSource Web サーバー コントロールの概要](http://msdn.microsoft.com/ja-jp/104cfc3f-7385-47d3-8a51-830dfa791136)  
+ <xref:System.Web.UI.WebControls.LinqDataSource> コントロールが [!INCLUDE[vstecasp](../../../../../../includes/vstecasp-md.md)] データソース コントロールのアーキテクチャを通じて[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] を Web 開発者に公開する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/remote-vs-local-execution.md b/docs/framework/data/adonet/sql/linq/remote-vs-local-execution.md
new file mode 100644
index 00000000000..8cb95271786
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/remote-vs-local-execution.md
@@ -0,0 +1,55 @@
+---
+title: "Remote vs. Local Execution | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee50e943-9349-4c84-ab1c-c35d3ada1a9c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Remote vs. Local Execution
+クエリは、リモートで実行することも \(データベース エンジンによるデータベースに対するクエリの実行\)、ローカルに実行することも \([!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によるローカル キャッシュに対するクエリの実行\) できます。  
+  
+## リモート実行  
+ 次のクエリがあるとします。  
+  
+ [!code-csharp[DLinqQueryConcepts#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#7)]
+ [!code-vb[DLinqQueryConcepts#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#7)]  
+  
+ データベース内に大量の行がある場合は、小さなサブセットを処理するためにすべての行を取得するのは望ましくありません。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Data.Linq.EntitySet%601> クラスに <xref:System.Linq.IQueryable> インターフェイスが実装されています。  これにより、このようなクエリをリモートで実行することが可能になります。  この方法には、次の 2 つの大きな利点があります。  
+  
+-   不要なデータは取得されません。  
+  
+-   多くの場合、データベース エンジンによって実行されるクエリは、データベース インデックスの効果でより効率的になります。  
+  
+## ローカル実行  
+ 一方、関連するエンティティ全体をローカル キャッシュに取り込むことが必要な場合もあります。  この目的から、<xref:System.Data.Linq.EntitySet%601> には、<xref:System.Data.Linq.EntitySet%601> のすべてのメンバーを明示的に読み込む <xref:System.Data.Linq.EntitySet%601.Load%2A> メソッドが用意されています。  
+  
+ <xref:System.Data.Linq.EntitySet%601> が既に読み込まれている場合、それ以降のクエリはローカルに実行されます。  この方法は、次の 2 つの点で役立ちます。  
+  
+-   データ全体をローカルで使用する必要がある場合、または複数回使用する必要がある場合に、リモート クエリおよびそれに伴う待機時間を回避できます。  
+  
+-   エンティティ全体をシリアル化できます。  
+  
+ 次のコードは、ローカル実行を行う方法を示しています。  
+  
+ [!code-csharp[DLinqQueryConcepts#8](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryConcepts/cs/Program.cs#8)]
+ [!code-vb[DLinqQueryConcepts#8](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryConcepts/vb/Module1.vb#8)]  
+  
+## 比較  
+ この 2 種類の実行方法は、強力なオプションの組み合わせになります。つまり、大規模なコレクションではリモート実行を、小規模なコレクションまたは完全なコレクションが必要な場合はローカル実行を選択できます。  リモート実行は <xref:System.Linq.IQueryable> を使用して実装し、ローカル実行はメモリ内の <xref:System.Collections.Generic.IEnumerable%601> コレクションに対して行います。  ローカル実行 \(<xref:System.Collections.Generic.IEnumerable%601>\) を強制的に行う方法については、「[Convert a Type to a Generic IEnumerable](../../../../../../docs/framework/data/adonet/sql/linq/convert-a-type-to-a-generic-ienumerable.md)」を参照してください。  
+  
+### 順序なしのセットに対するクエリ  
+ <xref:System.Collections.Generic.List%601> を実装するローカル コレクションと、リレーショナル データベース内の*順序なしのセット*に対してリモート クエリを実行するコレクションの間には、重要な違いがあることに注意してください。  インデックス値を使用するメソッドなど、<xref:System.Collections.Generic.List%601> のメソッドにはリストのセマンティクスが必要ですが、これは通常、順序なしのセットに対するリモート クエリからは得られません。  このため、このようなメソッドでは、ローカル実行を可能にするために暗黙的に <xref:System.Data.Linq.EntitySet%601> が読み込まれます。  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md b/docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md
new file mode 100644
index 00000000000..cd2a698642c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/responsibilities-of-the-developer-in-overriding-default-behavior.md
@@ -0,0 +1,37 @@
+---
+title: "Responsibilities of the Developer In Overriding Default Behavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6909ddd-e053-46a8-980c-0e12a9797be1
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Responsibilities of the Developer In Overriding Default Behavior
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、以下の要件を満たすことは強制ではないものの、これらの要件を満たさなかった場合の動作は未定義です。  
+  
+-   オーバーライドするメソッドでは、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> も <xref:System.Data.Linq.Table%601.Attach%2A> も呼び出さないでください。  オーバーライド メソッドでこれらのメソッドを呼び出した場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は例外をスローします。  
+  
+-   オーバーライド メソッドは、トランザクションの開始、コミット、および中断には使用できません。  <xref:System.Data.Linq.DataContext.SubmitChanges%2A> 操作はトランザクションの下で実行されます。  入れ子になった内側のトランザクションは、外側のトランザクションと干渉する可能性があります。  読み込みのオーバーライド メソッドでは、<xref:System.Transactions.Transaction> 内で実行されている操作でないことを確認した場合にのみ、トランザクションを開始できます。  
+  
+-   オーバーライド メソッドでは、該当するオプティミスティック同時実行の対応付けに従うことが望まれます。  オプティミスティック同時実行の競合が発生したときに、オーバーライド メソッドは <xref:System.Data.Linq.ChangeConflictException> をスローすることが望まれています。  この例外は [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によってキャッチされるため、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> で指定した <xref:System.Data.Linq.DataContext.SubmitChanges%2A> オプションを適切に処理できます。  
+  
+-   作成 \(`Insert`\) および `Update` のオーバーライド メソッドでは、操作が正常に完了した場合、データベースによって生成された列の値を、対応するオブジェクト メンバーに反映することが望まれます。  
+  
+     たとえば、`Order.OrderID` が ID 列 \(*自動インクリメント*の主キー\) に割り当てられている場合、`InsertOrder()` オーバーライド メソッドでは、データベースが生成した ID を取得して、`Order.OrderID` メンバーにその ID を設定する必要があります。  同様に、タイムスタンプ型のメンバーは、データベースが生成したタイムスタンプ値に更新して、更新後のオブジェクトの一貫性を維持する必要があります。  データベースが生成した値を反映しなかった場合、データベースと、<xref:System.Data.Linq.DataContext> が追跡するオブジェクトとの間で、矛盾が生じる可能性があります。  
+  
+-   正しい動的 API を呼び出す必要があります。  たとえば、更新のオーバーライド メソッドで呼び出すことができるのは <xref:System.Data.Linq.DataContext.ExecuteDynamicUpdate%2A> のみです。  呼び出した動的メソッドが対象の操作に一致するかどうかについて、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、検出や検査は行いません。  適合しないメソッドを呼び出した場合 \(たとえば、更新するオブジェクトについて <xref:System.Data.Linq.DataContext.ExecuteDynamicDelete%2A> を呼び出した場合\)、結果は未定義です。  
+  
+-   オーバーライド メソッドでは、決められた操作を実行することが望まれます。  一括読み込み、遅延読み込み、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> など、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 操作のセマンティクスでは、決められたサービスをオーバーライド メソッドで提供する必要があります。たとえば、読み込みのオーバーライドで、データベースの内容をチェックせずに空のコレクションを返すと、データの矛盾を引き起こす可能性があります。  
+  
+## 参照  
+ [Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/retrieving-objects-from-the-identity-cache.md b/docs/framework/data/adonet/sql/linq/retrieving-objects-from-the-identity-cache.md
new file mode 100644
index 00000000000..2b8d8242b37
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/retrieving-objects-from-the-identity-cache.md
@@ -0,0 +1,75 @@
+---
+title: "Retrieving Objects from the Identity Cache | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96c13903-ccb6-4a0e-ab6a-8ca955ca314d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Retrieving Objects from the Identity Cache
+このトピックでは、<xref:System.Data.Linq.DataContext> によって管理される ID キャッシュからオブジェクトを返す、LINQ to SQL クエリの種類について説明します。  
+  
+ LINQ to SQL では、<xref:System.Data.Linq.DataContext> がクエリの実行に応じてオブジェクトの ID を ID キャッシュにログして、オブジェクトを管理する場合があります。  場合によっては、データベースに対してクエリを実行する前に、LINQ to SQL が ID キャッシュからオブジェクトの取得を試みることがあります。  
+  
+ 通常、LINQ to SQL で ID キャッシュからオブジェクトを取得するには、そのクエリがオブジェクトのプライマリ キーに基づき、1 つのオブジェクトを返すようにする必要があります。  特に、次に示す一般的な形式のいずれかでクエリを実行する必要があります。  
+  
+> [!NOTE]
+>  プリコンパイル済みクエリでは、ID キャッシュからオブジェクトが返されません。  プリコンパイル済みクエリの詳細については、「<xref:System.Data.Linq.CompiledQuery>」および「[How to: Store and Reuse Queries](../../../../../../docs/framework/data/adonet/sql/linq/how-to-store-and-reuse-queries.md)」を参照してください。  
+  
+ オブジェクトを ID キャッシュから取得するには、次に示す一般的な形式のいずれかでクエリを実行する必要があります。  
+  
+-   <xref:System.Data.Linq.Table%601> `.Function1(` `predicate` `)`  
+  
+-   <xref:System.Data.Linq.Table%601> `.Function1(` `predicate` `).Function2()`  
+  
+ これらの一般的な形式では、`Function1`、`Function2`、および `predicate` が次のように定義されます。  
+  
+ `Function1` は、次のいずれかになります。  
+  
+-   <xref:System.Linq.Queryable.Where%2A>  
+  
+-   <xref:System.Linq.Queryable.First%2A>  
+  
+-   <xref:System.Linq.Queryable.FirstOrDefault%2A>  
+  
+-   <xref:System.Linq.Queryable.Single%2A>  
+  
+-   <xref:System.Linq.Queryable.SingleOrDefault%2A>  
+  
+ `Function2` は、次のいずれかになります。  
+  
+-   <xref:System.Linq.Queryable.First%2A>  
+  
+-   <xref:System.Linq.Queryable.FirstOrDefault%2A>  
+  
+-   <xref:System.Linq.Queryable.Single%2A>  
+  
+-   <xref:System.Linq.Queryable.SingleOrDefault%2A>  
+  
+ `predicate` は、オブジェクトのプライマリ キー プロパティが定数値に設定された式である必要があります。  オブジェクトのプライマリ キーが複数のプロパティで定義されている場合は、それぞれのプライマリ キー プロパティが定数値に設定されている必要があります。  `predicate` に使用する必要がある形式の例を次に示します。  
+  
+-   `c => c.PK == constant_value`  
+  
+-   `c => c.PK1 == constant_value1 && c=> c.PK2 == constant_value2`  
+  
+## 例  
+ 次のコードは、ID キャッシュからオブジェクトを取得する LINQ to SQL クエリの例です。  
+  
+ [!code-csharp[L2S_QueryCache#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/l2s_querycache/cs/program.cs#1)]
+ [!code-vb[L2S_QueryCache#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/l2s_querycache/vb/module1.vb#1)]  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Object Identity](../../../../../../docs/framework/data/adonet/sql/linq/object-identity.md)   
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [Object Identity](../../../../../../docs/framework/data/adonet/sql/linq/object-identity.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-or-skip-elements-in-a-sequence.md b/docs/framework/data/adonet/sql/linq/return-or-skip-elements-in-a-sequence.md
new file mode 100644
index 00000000000..454e6637d4e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-or-skip-elements-in-a-sequence.md
@@ -0,0 +1,87 @@
+---
+title: "Return Or Skip Elements in a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81a31acd-e0f1-4bca-9a12-fa1ad5752374
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return Or Skip Elements in a Sequence
+<xref:System.Linq.Queryable.Take%2A> 演算子を使用すると、シーケンス内の指定された数の要素を返し、残りをスキップできます。  
+  
+ <xref:System.Linq.Queryable.Skip%2A> 演算子を使用すると、シーケンス内の指定された数の要素をスキップし、残りを返すことができます。  
+  
+> [!NOTE]
+>  <xref:System.Linq.Enumerable.Take%2A> と <xref:System.Linq.Enumerable.Skip%2A> を SQL Server 2000 に対するクエリで使用する場合は、いくつかの制限があります。  詳細については、「[Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)」の「SQL Server 2000 の Skip 例外と Take 例外」を参照してください。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、SQL `NOT EXISTS` 句を含むサブクエリを使用して <xref:System.Linq.Queryable.Skip%2A> を変換します。  この変換には、次のような制限があります。  
+  
+-   引数は、セットである必要があります。  順序が指定されていてもマルチセットはサポートされません。  
+  
+-   生成されるクエリは、<xref:System.Linq.Queryable.Skip%2A> が適用される基本クエリに対して生成されるクエリより複雑な場合があります。  複雑なために、パフォーマンスが低下したり、タイムアウトが発生することもあります。  
+  
+## 使用例  
+ 次の例では、`Take` を使用して、雇用された最初の 5 人の `Employees` を選択します。  コレクションは最初、`HireDate` 順に並べられます。  
+  
+ [!code-csharp[DLinqQueryExamples#16](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#16)]
+ [!code-vb[DLinqQueryExamples#16](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#16)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Linq.Queryable.Skip%2A> を使用して、最も値段が高い 10 個の `Products` 以外のすべてを選択します。  
+  
+ [!code-csharp[DLinqQueryExamples#17](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#17)]
+ [!code-vb[DLinqQueryExamples#17](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#17)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Linq.Queryable.Skip%2A> メソッドと <xref:System.Linq.Queryable.Take%2A> メソッドを組み合わせて、最初の 50 レコードをスキップし、次の 10 レコードを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#18](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#18)]
+ [!code-vb[DLinqQueryExamples#18](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#18)]  
+  
+ <xref:System.Linq.Queryable.Take%2A> 操作と <xref:System.Linq.Queryable.Skip%2A> 操作は、順序付けされたセットに対してのみ正しく定義されます。  順序付けされていないセットまたはマルチセットのセマンティクスは未定義です。  
+  
+ SQL での順序付けの制限により、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、<xref:System.Linq.Queryable.Take%2A> 演算子または <xref:System.Linq.Queryable.Skip%2A> 演算子の引数の順序を、演算子の結果に移動することを試みます。  
+  
+> [!NOTE]
+>  [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] と [!INCLUDE[sqprsqlong](../../../../../../includes/sqprsqlong-md.md)] で変換は異なります。  複雑さに関係なくクエリを指定して <xref:System.Linq.Queryable.Skip%2A> を使用する予定の場合は、[!INCLUDE[sqprsqlong](../../../../../../includes/sqprsqlong-md.md)] を使用してください。  
+  
+ [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] に対して次の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリを検討します。  
+  
+ [!code-csharp[DLinqQueryExamples#19](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#19)]
+ [!code-vb[DLinqQueryExamples#19](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#19)]  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次に示すように、順序付けを SQL コードの最後に移動します。  
+  
+```  
+SELECT TOP 1 [t0].[CustomerID], [t0].[CompanyName],  
+FROM [Customers] AS [t0]  
+WHERE (NOT (EXISTS(  
+    SELECT NULL AS [EMPTY]  
+    FROM (  
+        SELECT TOP 1 [t1].[CustomerID]  
+        FROM [Customers] AS [t1]  
+        WHERE [t1].[City] = @p0  
+        ORDER BY [t1].[CustomerID]  
+        ) AS [t2]  
+    WHERE [t0].[CustomerID] = [t2].[CustomerID]  
+    ))) AND ([t0].[City] = @p1)  
+ORDER BY [t0].[CustomerID]  
+```  
+  
+ <xref:System.Linq.Queryable.Take%2A> と <xref:System.Linq.Queryable.Skip%2A> を連結する場合は、指定されているすべての順序が一致する必要があります。  それ以外の場合、結果は未定義です。  
+  
+ SQL の仕様に基づく負でない定数の整数引数に対して、<xref:System.Linq.Queryable.Take%2A> と <xref:System.Linq.Queryable.Skip%2A> の両方とも正しく定義されます。  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-the-average-value-from-a-numeric-sequence.md b/docs/framework/data/adonet/sql/linq/return-the-average-value-from-a-numeric-sequence.md
new file mode 100644
index 00000000000..a24e63b27df
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-the-average-value-from-a-numeric-sequence.md
@@ -0,0 +1,122 @@
+---
+title: "Return the Average Value From a Numeric Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee3b8673-a2e7-4b2d-9b5c-4972ff9e665d
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return the Average Value From a Numeric Sequence
+<xref:System.Linq.Enumerable.Average%2A> 演算子は、一連の数値の平均値を計算します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で整数値の `Average` が変換されるときには、倍精度浮動小数点数ではなく整数として計算されます。  
+  
+## 使用例  
+ 次の例は、`Orders` テーブルの `Freight` の平均値を返します。  
+  
+ Northwind サンプル データベースでは、結果は `78.2442` になります。  
+  
+ [!code-csharp[DLinqQueryExamples#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#1)]
+ [!code-vb[DLinqQueryExamples#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#1)]  
+  
+## 使用例  
+ 次の例は、`Products` テーブルのすべての `Products` の単価の平均値を返します。  
+  
+ Northwind サンプル データベースでは、結果は `28.8663` になります。  
+  
+ [!code-csharp[DLinqQueryExamples#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#2)]
+ [!code-vb[DLinqQueryExamples#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#2)]  
+  
+## 使用例  
+ 次の例は、`Average` 演算子を使用して、カテゴリ内の平均単価よりも単価が高い `Products` を見つけます。  その後、結果をグループ別に表示します。  
+  
+ この例の戻り値は匿名型なので、C\# で `var` キーワードを使用する必要がある点に注意してください。  
+  
+ [!code-csharp[DLinqQueryExamples#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#3)]
+ [!code-vb[DLinqQueryExamples#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#3)]  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、結果は次のようになります。  
+  
+ `1`  
+  
+ `Côte de Blaye`  
+  
+ `Ipoh Coffee`  
+  
+ `2`  
+  
+ `Grandma's Boysenberry Spread`  
+  
+ `Northwoods Cranberry Sauce`  
+  
+ `Sirop d'érable`  
+  
+ `Vegie-spread`  
+  
+ `3`  
+  
+ `Sir Rodney's Marmalade`  
+  
+ `Gumbär Gummibärchen`  
+  
+ `Schoggi Schokolade`  
+  
+ `Tarte au sucre`  
+  
+ `4`  
+  
+ `Queso Manchego La Pastora`  
+  
+ `Mascarpone Fabioli`  
+  
+ `Raclette Courdavault`  
+  
+ `Camembert Pierrot`  
+  
+ `Gudbrandsdalsost`  
+  
+ `Mozzarella di Giovanni`  
+  
+ `5`  
+  
+ `Gustaf's Knäckebröd`  
+  
+ `Gnocchi di nonna Alice`  
+  
+ `Wimmers gute Semmelknödel`  
+  
+ `6`  
+  
+ `Mishi Kobe Niku`  
+  
+ `Thüringer Rostbratwurst`  
+  
+ `7`  
+  
+ `Rössle Sauerkraut`  
+  
+ `Manjimup Dried Apples`  
+  
+ `8`  
+  
+ `Ikura`  
+  
+ `Carnarvon Tigers`  
+  
+ `Nord-Ost Matjeshering`  
+  
+ `Gravad lax`  
+  
+## 参照  
+ [Aggregate Queries](../../../../../../docs/framework/data/adonet/sql/linq/aggregate-queries.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-the-first-element-in-a-sequence.md b/docs/framework/data/adonet/sql/linq/return-the-first-element-in-a-sequence.md
new file mode 100644
index 00000000000..5f6a6a1ab69
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-the-first-element-in-a-sequence.md
@@ -0,0 +1,45 @@
+---
+title: "Return the First Element in a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ccdc3777-b2c2-44e3-a627-abef8d79a555
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return the First Element in a Sequence
+<xref:System.Linq.Enumerable.First%2A> 演算子を使用すると、シーケンスの内最初の要素を返すことができます。  <xref:System.Linq.Enumerable.First%2A> を使用するクエリは直ちに実行されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は <xref:System.Linq.Enumerable.Last%2A> 演算子をサポートしません。  
+  
+## 使用例  
+ 次のコードは、テーブル内の最初の `Shipper` を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、結果は次のようになります。  
+  
+ `ID = 1, Company = Speedy Express`.  
+  
+ [!code-csharp[DLinqQueryExamples#14](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#14)]
+ [!code-vb[DLinqQueryExamples#14](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#14)]  
+  
+## 使用例  
+ 次のコードは、`CustomerID` が BONAP の単一の `Customer` を見つけます。  
+  
+ Northwind サンプル データベースに対してこのクエリを実行すると、結果は `ID = BONAP, Contact = Laurence Lebihan` になります。  
+  
+ [!code-csharp[DLinqQueryExamples#15](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#15)]
+ [!code-vb[DLinqQueryExamples#15](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#15)]  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-the-set-difference-between-two-sequences.md b/docs/framework/data/adonet/sql/linq/return-the-set-difference-between-two-sequences.md
new file mode 100644
index 00000000000..d4a06910985
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-the-set-difference-between-two-sequences.md
@@ -0,0 +1,32 @@
+---
+title: "Return the Set Difference Between Two Sequences | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62efb546-c898-408f-af21-36e7c6fed217
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return the Set Difference Between Two Sequences
+2 つのシーケンスの差集合を返すには、<xref:System.Linq.Queryable.Except%2A> 演算子を使用します。  
+  
+## 使用例  
+ この例では、<xref:System.Linq.Queryable.Except%2A> を使用して、`Customers` は居住しているが `Employees` は居住していないすべての国のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#41](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#41)]
+ [!code-vb[DLinqQueryExamples#41](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#41)]  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Linq.Queryable.Except%2A> 演算は集合でのみ適切に定義されます。  マルチセットのセマンティクスは未定義です。  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-the-set-intersection-of-two-sequences.md b/docs/framework/data/adonet/sql/linq/return-the-set-intersection-of-two-sequences.md
new file mode 100644
index 00000000000..4b1e3e39227
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-the-set-intersection-of-two-sequences.md
@@ -0,0 +1,32 @@
+---
+title: "Return the Set Intersection of Two Sequences | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d09c344e-3548-4944-a3ed-051880e3f5b8
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return the Set Intersection of Two Sequences
+2 つのシーケンスの積集合を返すには、<xref:System.Linq.Queryable.Intersect%2A> 演算子を使用します。  
+  
+## 使用例  
+ この例では、<xref:System.Linq.Queryable.Intersect%2A> を使用して、`Customers` と `Employees` の両方が居住しているすべての国のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#42](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#42)]
+ [!code-vb[DLinqQueryExamples#42](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#42)]  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Linq.Queryable.Intersect%2A> 演算は集合でのみ適切に定義されます。  マルチセットのセマンティクスは未定義です。  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/return-the-set-union-of-two-sequences.md b/docs/framework/data/adonet/sql/linq/return-the-set-union-of-two-sequences.md
new file mode 100644
index 00000000000..cfa8c7f48c7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/return-the-set-union-of-two-sequences.md
@@ -0,0 +1,32 @@
+---
+title: "Return the Set Union of Two Sequences | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b8bd3cb-86d4-4a3b-9906-61f68726dd1f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Return the Set Union of Two Sequences
+2 つのシーケンスの和集合を返すには、<xref:System.Linq.Queryable.Union%2A> 演算子を使用します。  
+  
+## 使用例  
+ この例では、<xref:System.Linq.Queryable.Union%2A> を使用して、`Customers` と `Employees` のいずれかが居住しているすべての国のシーケンスを返します。  
+  
+ [!code-csharp[DLinqQueryExamples#43](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#43)]
+ [!code-vb[DLinqQueryExamples#43](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#43)]  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Linq.Queryable.Union%2A> 演算子は、マルチセットの順序なし連結演算子として、マルチセットに対して定義されます \(事実上、SQL の `UNION ALL` 句の結果\)。  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/samples.md b/docs/framework/data/adonet/sql/linq/samples.md
new file mode 100644
index 00000000000..3660ba33393
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/samples.md
@@ -0,0 +1,39 @@
+---
+title: "Samples | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fcc0c4a-b952-4cfe-9e09-0c0cf874ba2c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Samples
+ここでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] サンプル コードが用意されている [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のソリューションへのリンクを示します。  
+  
+## このセクションの内容  
+ SampleQueries ソリューションの [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] バージョン  
+ [Sample Queries \(Visual Basic\)](http://msdn.microsoft.com/ja-jp/c9de4619-45fb-4655-be8f-763ee4ed8abe)  
+  
+ SampleQueries ソリューションの C\# バージョン  
+ [LINQ C\# Samples Solution](http://msdn.microsoft.com/ja-jp/23852e6b-b9a9-4a06-aedb-b27a5930ed74)  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] コードおよびアプリケーションの他の例を参照するには、次の手順に従います。  
+  
+-   特定の問題について MSDN ライブラリを検索します。  
+  
+-   [LINQ フォーラム](http://go.microsoft.com/fwlink/?LinkId=76488)に参加して、複雑なトピックについて専門家と検討したりすることもできます。  
+  
+-   [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] および C\# のコード例を含む、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] テクノロジについて記載されているホワイト ペーパーを参照します。  詳細については、「[LINQ to SQL: リレーショナル データのための .NET 統合言語クエリ](http://go.microsoft.com/fwlink/?LinkId=93205)」を参照してください。  
+  
+## 参照  
+ [LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/index.md)   
+ [LINQ to SQL Walkthroughs](http://msdn.microsoft.com/ja-jp/308e66ac-f704-4e00-9b4e-7af0045a2374)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md
new file mode 100644
index 00000000000..c596fecd0a9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/security-in-linq-to-sql.md
@@ -0,0 +1,45 @@
+---
+title: "Security in LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d49787f7-414e-4c71-aa33-80a5895536b1
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Security in LINQ to SQL
+データベースに接続するときは、常にセキュリティのリスクがあります。  LINQ to SQL には SQL Server のデータを操作する新しい方法が含まれていますが、セキュリティ メカニズムは追加されていません。  
+  
+## アクセス制御と認証  
+ LINQ to SQL には独自のユーザー モデルや認証メカニズムがありません。  オブジェクト モデルにマッピングされるデータベース、データベースのテーブル、ビュー、ストアド プロシージャなどへのアクセス制御には SQL Server のセキュリティを使用します。  ユーザーには必要最小限のアクセス権を与え、ユーザー認証には強力なパスワードを要求してください。  
+  
+## マッピングとスキーマ情報  
+ オブジェクト モデルまたは外部マッピング ファイルにある、SQL\-CLR 型マッピングとデータベース スキーマ情報は、ファイル システムでこれらのファイルに対してアクセス権を持つ全ユーザーに公開されます。  オブジェクト モデルや外部マッピング ファイルにアクセスできるユーザーはすべてスキーマ情報を使用できると想定してください。スキーマ情報へのアクセスを制限するには、ファイルのセキュリティ メカニズムを使用してソース ファイルとマッピング ファイルのセキュリティを確保します。  
+  
+## 接続文字列  
+ 接続文字列にパスワードを使用することは、できるだけ避けてください。  接続文字列自体がセキュリティのリスクであるうえに、接続文字列はオブジェクト リレーショナル デザイナーまたは SQLMetal コマンド ライン ツールの使用時にオブジェクト モデルや外部マッピング ファイルにクリア テキストで追加できます。  ファイル システムでオブジェクト モデルまたは外部マッピング ファイルに対してアクセス権があれば、どのユーザーでも接続パスワードを見ることができます \(パスワードが接続文字列に含まれている場合\)。  
+  
+ このようなリスクを最小限に抑えるには、統合セキュリティを使用して [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] との信頼関係接続を作成します。  この方法を使用すると、接続文字列にパスワードを含める必要がなくなります。  詳細については、「[SQL Server のセキュリティ](../../../../../../docs/framework/data/adonet/sql/sql-server-security.md)」を参照してください。  
+  
+ 統合セキュリティがない場合は、接続文字列にクリア テキストのパスワードが必要になります。  以下は、接続文字列のセキュリティ保護に最も有効な手段です。  
+  
+-   統合セキュリティを使用します。  
+  
+-   接続文字列をパスワードで保護し、接続文字列の配布を最小限にします。  
+  
+-   接続文字列の代わりに、表示時間に制限のある <xref:System.Data.SqlClient.SqlConnection?displayProperty=fullName> クラスを使用します。  LINQ to SQL の <xref:System.Data.Linq.DataContext?displayProperty=fullName> クラスは <xref:System.Data.SqlClient.SqlConnection> を使用してインスタンス化できます。  
+  
+-   すべての接続文字列の期限と接触点を最小限にします。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [Frequently Asked Questions](../../../../../../docs/framework/data/adonet/sql/linq/frequently-asked-questions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sequence-operators.md b/docs/framework/data/adonet/sql/linq/sequence-operators.md
new file mode 100644
index 00000000000..cd748622ed3
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sequence-operators.md
@@ -0,0 +1,56 @@
+---
+title: "Sequence Operators | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d332d32-3806-4451-b7af-25af269194ae
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Sequence Operators
+一般的には、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、次のいずれかの性質を持つシーケンス演算子はサポートされません。  
+  
+-   ラムダとインデックス パラメーターを使用する。  
+  
+-   シーケンス行のプロパティに依存する \(<xref:System.Linq.Queryable.TakeWhile%2A> など\)。  
+  
+-   任意の CLR 実装に依存する \(<xref:System.Collections.Generic.IComparer%601> など\)。  
+  
+|サポートされない例|  
+|---------------|  
+|<xref:System.Linq.Enumerable.Where%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Boolean%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Select%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Select%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.TakeWhile%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Boolean%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.TakeWhile%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Boolean%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.SkipWhile%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Boolean%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.SkipWhile%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Boolean%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.GroupBy%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%601%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.GroupBy%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2CSystem.Collections.Generic.IEnumerable%7B%60%602%7D%2C%60%603%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%601%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Reverse%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.DefaultIfEmpty%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%600%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.ElementAt%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.ElementAtOrDefault%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Range%28System.Int32%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Repeat%60%601%28%60%600%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Empty%60%601?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Contains%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%600%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Aggregate%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%600%2C%60%600%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Aggregate%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%601%2CSystem.Func%7B%60%601%2C%60%600%2C%60%601%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.Aggregate%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2C%60%601%2CSystem.Func%7B%60%601%2C%60%600%2C%60%601%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%29?displayProperty=fullName>|  
+|<xref:System.Linq.Enumerable.SequenceEqual%2A?displayProperty=fullName>|  
+  
+## .NET との相違  
+ サポートされるすべてのシーケンス演算子は、`Average` を除いて、共通言語ランタイム \(CLR\) で正常に動作します。  `Average` は、平均化される型と同じ型の値を返しますが、CLR での `Average` は、常に <xref:System.Double> または <xref:System.Decimal> を返します。  ソース引数が明示的に double \/ decimal にキャストされている場合、または、セレクターが double \/ decimal にキャストする場合、作成される SQL でもこのような変換が行われるため、結果に問題はありません。  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/serialization.md b/docs/framework/data/adonet/sql/linq/serialization.md
new file mode 100644
index 00000000000..b08683a33df
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/serialization.md
@@ -0,0 +1,82 @@
+---
+title: "Serialization | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a15ae411-8dc2-4ca3-84d2-01c9d5f1972a
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Serialization
+このトピックでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のシリアル化機能について説明します。  デザイン時のコード生成でシリアル化を追加する方法と、実行時の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のクラスのシリアル化の動作について説明します。  
+  
+ デザイン時には、次のいずれかの方法でシリアル化のコードを追加できます。  
+  
+-   [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]で、**Serialization Mode** プロパティを **Unidirectional** に変更します。  
+  
+-   SQLMetal コマンド ラインに **\/serialization** オプションを追加します。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 概要  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が生成するコードには、遅延読み込み機能が既定で備わっています。  遅延読み込みは、中間層でデータを必要に応じて透過的に読み込むうえでは非常に便利です。  しかし、シリアル化のときには問題です。遅延読み込みが意図されているかどうかに関係なく、シリアライザーによって遅延読み込みが発生するためです。  具体的には、オブジェクトがシリアル化されるときには、遅延読み込みされるすべての外部参照の推移的閉包がシリアル化されます。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のシリアル化機能では、この問題に対処しています。これには主に、次の 2 つの方法が使用されます。  
+  
+-   <xref:System.Data.Linq.DataContext> のモードにより、遅延読み込みをオフにします \(<xref:System.Data.Linq.DataContext.ObjectTrackingEnabled%2A>\)。  詳細については、「<xref:System.Data.Linq.DataContext>」を参照してください。  
+  
+-   コード生成のスイッチにより、生成するエンティティに <xref:System.Runtime.Serialization.DataContractAttribute?displayProperty=fullName> 属性および <xref:System.Runtime.Serialization.DataMemberAttribute?displayProperty=fullName> 属性を生成します。  この方法と、シリアル化での遅延読み込みクラスの動作が、このトピックの主な話題です。  
+  
+### 定義  
+  
+-   *DataContract シリアライザー* : .NET Framework 3.0 以降のバージョンの WCF \(Windows Communication Framework\) コンポーネントが使用する既定のシリアライザーです。  
+  
+-   *単方向シリアル化* : 循環参照を防ぐために、一方向の関連付けプロパティのみを含む、シリアル化されたバージョンのクラスです。  慣例として、主キー\/外部キーのリレーションシップの親側のプロパティをシリアル化の対象としてマークします。  双方向の関連付けの反対側はシリアル化しません。  
+  
+     [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、シリアル化の種類として、単方向シリアル化のみがサポートされています。  
+  
+## コード例  
+ 次のコードは、Northwind サンプル データベースの典型的な `Customer` クラスおよび `Order` クラスを使用して、これらのクラスをシリアル化の属性で装飾するようすを示します。  
+  
+ [!code-csharp[DLinqSerialization#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#1)]
+ [!code-vb[DLinqSerialization#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#1)]  
+  
+ [!code-csharp[DLinqSerialization#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#2)]
+ [!code-vb[DLinqSerialization#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#2)]  
+  
+ [!code-csharp[DLinqSerialization#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#3)]
+ [!code-vb[DLinqSerialization#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#3)]  
+  
+ 次の例の `Order` クラスでは、簡略化のために、`Customer` クラスに関する逆関連付けのプロパティのみを示します。  循環参照を防ぐために、`DataMember` 属性はありません。  
+  
+ [!code-csharp[DLinqSerialization#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#4)]
+ [!code-vb[DLinqSerialization#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#4)]  
+  
+ [!code-csharp[DLinqSerialization#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#5)]
+ [!code-vb[DLinqSerialization#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#5)]  
+  
+### エンティティをシリアル化する方法  
+ 前のセクションで示したコードのエンティティは次のようにシリアル化できます。  
+  
+ [!code-csharp[DLinqSerialization#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/Program.cs#6)]
+ [!code-vb[DLinqSerialization#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/Module1.vb#6)]  
+  
+### 自己再帰的リレーションシップ  
+ 自己再帰的リレーションシップも同じパターンに従います。  外部キーに関する関連付けのプロパティには `DataMember` 属性がなく、親プロパティにはあります。  
+  
+ 次のクラスには、自己再帰的リレーションシップが 2 つあります。Employee.Manager\/Reports と Employee.Mentor\/Mentees です。  
+  
+ [!code-csharp[DLinqSerialization#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSerialization/cs/northwind-ser.cs#7)]
+ [!code-vb[DLinqSerialization#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSerialization/vb/northwind-ser.vb#7)]  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)   
+ [How to: Make Entities Serializable](../../../../../../docs/framework/data/adonet/sql/linq/how-to-make-entities-serializable.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sort-elements-in-a-sequence.md b/docs/framework/data/adonet/sql/linq/sort-elements-in-a-sequence.md
new file mode 100644
index 00000000000..29dbea5ad93
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sort-elements-in-a-sequence.md
@@ -0,0 +1,97 @@
+---
+title: "Sort Elements in a Sequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d59b93a9-50c8-4770-a114-d902f6a0ea76
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Sort Elements in a Sequence
+1 つ以上のキーに従ってシーケンスを並べ替えるには、<xref:System.Linq.Enumerable.OrderBy%2A> 演算子を使用します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、`string` や `int` などの単純で基本的なデータ型による順序付けをサポートするように設計されています。  匿名型のように複数の値を持つ複雑なクラスでの順序付けはサポートされていません。  また、`byte` データ型もサポートされていません。  
+  
+## 使用例  
+ 次の例は、`Employees` を入社日の順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#20](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#20)]
+ [!code-vb[DLinqQueryExamples#20](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#20)]  
+  
+## 使用例  
+ 次の例は、`where` を使用して、`London` に出荷された `Orders` を運送料の順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#21](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#21)]
+ [!code-vb[DLinqQueryExamples#21](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#21)]  
+  
+## 使用例  
+ 次の例は、`Products` を単価の高い順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#22](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#22)]
+ [!code-vb[DLinqQueryExamples#22](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#22)]  
+  
+## 使用例  
+ 次の例は、`OrderBy` で複数のフィールドを使用して、`Customers` を最初に都市の順に、次に連絡先の順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#24](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#24)]
+ [!code-vb[DLinqQueryExamples#24](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#24)]  
+  
+## 使用例  
+ 次の例は、`EmployeeID 1` からの注文を、最初に出荷先国の順に、次に運送料の高い順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#25](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#25)]
+ [!code-vb[DLinqQueryExamples#25](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#25)]  
+  
+## 使用例  
+ 次の例は、<xref:System.Linq.Enumerable.OrderBy%2A> 演算子、<xref:System.Linq.Enumerable.Max%2A> 演算子、および <xref:System.Linq.Enumerable.GroupBy%2A> 演算子を組み合わせて、各カテゴリで単価の最も高い `Products` を特定し、そのグループをカテゴリ ID の順に並べ替えます。  
+  
+ [!code-csharp[DLinqQueryExamples#26](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqQueryExamples/cs/Program.cs#26)]
+ [!code-vb[DLinqQueryExamples#26](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqQueryExamples/vb/Module1.vb#26)]  
+  
+ Northwind サンプル データベースに対して前のクエリを実行すると、結果は次のようになります。  
+  
+ `1`  
+  
+ `Côte de Blaye`  
+  
+ `2`  
+  
+ `Vegie-spread`  
+  
+ `3`  
+  
+ `Sir Rodney's Marmalade`  
+  
+ `4`  
+  
+ `Raclette Courdavault`  
+  
+ `5`  
+  
+ `Gnocchi di nonna Alice`  
+  
+ `6`  
+  
+ `Thüringer Rostbratwurst`  
+  
+ `7`  
+  
+ `Manjimup Dried Apples`  
+  
+ `8`  
+  
+ `Carnarvon Tigers`  
+  
+## 参照  
+ [Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)   
+ [Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md b/docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md
new file mode 100644
index 00000000000..683c2b34e32
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md
@@ -0,0 +1,43 @@
+---
+title: "SQL-CLR Custom Type Mappings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d916c7fb-4b56-4214-acbe-5e23365047b2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# SQL-CLR Custom Type Mappings
+SQL Server と共通言語ランタイム \(CLR\) 間の型マッピングは、SQLMetal コマンド ライン ツールのオブジェクト リレーショナル デザイナー \(O\/R デザイナー\) を使用すると、自動的に指定されます。  
+  
+ マッピングをカスタマイズしないと、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」で説明するように、これらのツールによって既定の型マッピングが割り当てられます。  これらの既定とは異なる型マッピングを使用する場合は、型マッピングをカスタマイズする必要があります。  
+  
+ 型マッピングをカスタマイズする場合は、中間の DBML ファイルに変更を加える方法が推奨されます。  次に、SQLMetal または O\/R デザイナーでカスタマイズした DBML ファイルを使用して、コード ファイルとマッピング ファイルを作成します。  
+  
+ コード ファイルとマッピング ファイルから <xref:System.Data.Linq.DataContext> オブジェクトをインスタンス化すると、指定した型マッピングに従って <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドがデータベースを作成します。  マッピングに CLR の `type` 属性が指定されていない場合は、既定の型マッピングが使用されます。  
+  
+## SQLMetal または O\/R デザイナーを使用したカスタマイズ  
+ SQLMetal と O\/R デザイナーを使用すると、コード ファイルの内外の型マッピング情報を含むオブジェクト ファイルを自動作成できます。  これらのファイルはマッピングを再作成するたびに SQLMetal または O\/R デザイナーによって上書きされるため、カスタム型マッピングを指定する場合は DBML ファイルをカスタマイズする方法をお勧めします。  
+  
+ SQLMetal または O\/R デザイナーで型マッピングをカスタマイズするには、最初に DBML ファイルを生成します。  次に、コード ファイルやマッピング ファイルを生成する前に、DBML ファイルを変更して適切な型マッピングを指定します。  SQLMetal では、DBML ファイルの `Type` 属性と `DbType` 属性を手動で変更して、型マッピングをカスタマイズする必要があります。  O\/R デザイナーでは、デザイナー内で変更を加えることができます。  O\/R デザイナーの使用方法の詳細については、「[LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)」を参照してください。  
+  
+> [!NOTE]
+>  一部の型マッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  カスタマイズを加える前に、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」の「型マッピングと実行時動作の関係」をよくお読みください。  
+  
+ 型マッピングのカスタマイズが SQLMetal または O\/R デザイナーで認識されるためには、コード ファイルや外部のマッピング ファイルを生成するときに、必ずこれらのツールにカスタム DBML ファイルのパスを提供する必要があります。  型マッピングのカスタマイズでは必須ではありませんが、常に型マッピング情報をコード ファイルから分離し、外部の型マッピング ファイルを追加生成することをお勧めします。  コード ファイルの再コンパイルを要求しないことで、柔軟性を残しておくことができます。  
+  
+## データベースの変更の組み込み  
+ データベースを変更すると、DBML ファイルを更新して、これらの変更を反映する必要があります。  その 1 つの方法として、新しい DBML ファイルを自動作成してから型マッピングのカスタマイズをやり直します。  もう 1 つは、新しい DBML ファイルとカスタマイズした DBML ファイルを比較し、カスタム DBML ファイルを手動で更新してデータベースの変更を反映させる方法です。  
+  
+## 参照  
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)   
+ [Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md b/docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md
new file mode 100644
index 00000000000..aceeef80449
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md
@@ -0,0 +1,268 @@
+---
+title: "SQL-CLR Type Mapping | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ed76327-54a7-414b-82a9-7579bfcec04b
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SQL-CLR Type Mapping
+LINQ to SQL では、リレーショナル データベースのデータ モデルが、任意のプログラミング言語で表されるオブジェクト モデルに対応付けられています。  アプリケーションが実行されると、LINQ to SQL は、オブジェクト モデルの統合言語クエリを SQL に変換し、それをデータベースに送信して実行します。  データベースから結果が返されると、LINQ to SQL はその結果をプログラミング言語で操作できるオブジェクトに変換し直します。  
+  
+ オブジェクト モデルとデータベースの間でデータを変換するには、*型マッピング*を定義する必要があります。  LINQ to SQL は型マッピングを使用して、共通言語ランタイム \(CLR\) のそれぞれの型を SQL Server の特定の型に対応付けます。  型マッピングおよびその他のマッピング情報 \(データベース構造やテーブルのリレーションシップなど\) は、オブジェクト モデル内で属性ベースの対応付けを使用して定義できます。  また、オブジェクト モデルの外部で外部マッピング ファイルを使用して指定することもできます。  詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」および「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+ このトピックでは、以下の点について説明します。  
+  
+-   [既定の型マッピング](#DefaultTypeMapping)  
+  
+-   [型マッピングと実行時動作の関係](#BehaviorMatrix)  
+  
+-   [CLR と SQL の実行時の動作の違い](#BehaviorDiffs)  
+  
+-   [Enum 型のマッピング](#EnumMapping)  
+  
+-   [数値のマッピング](#NumericMapping)  
+  
+-   [テキストおよび XML のマッピング](#TextMapping)  
+  
+-   [日付および時刻のマッピング](#DateMapping)  
+  
+-   [バイナリのマッピング](#BinaryMapping)  
+  
+-   [その他のマッピング](#MiscMapping)  
+  
+<a name="DefaultTypeMapping"></a>   
+## 既定の型マッピング  
+ オブジェクト モデルまたは外部マッピング ファイルは、オブジェクト リレーショナル デザイナー \(O\/R デザイナー\) または SQLMetal コマンド ライン ツールを使用して自動的に作成できます。  これらのツールの既定の型マッピングでは、SQL Server データベース内の列にマップするためにどの CLR 型を選択するかが定義されています。  これらのツールの使用方法の詳細については、「[Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)」を参照してください。  
+  
+ また、<xref:System.Data.Linq.DataContext.CreateDatabase%2A> メソッドを使用して、オブジェクト モデルまたは外部マッピング ファイルのマッピング情報に基づいて SQL Server データベースを作成することもできます。  <xref:System.Data.Linq.DataContext.CreateDatabase%2A> メソッドの既定の型マッピングでは、オブジェクト モデル内の CLR 型にマップするためにどの型の SQL Server 列を作成するかが定義されています。  詳細については、「[How to: Dynamically Create a Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-dynamically-create-a-database.md)」を参照してください。  
+  
+<a name="BehaviorMatrix"></a>   
+## 型マッピングと実行時動作の関係  
+ 次の図は、データがデータベースから取得されるときやデータベースに保存されるときに、特定の型マッピングで行われる実行時の動作を示しています。  シリアル化を除き、LINQ to SQL では、このマトリックスに指定されていない CLR または SQL Server のデータ型のマッピングはサポートされません。  シリアル化のサポートの詳細については、「[バイナリ シリアル化](#BinarySerialization)」を参照してください。  
+  
+> [!NOTE]
+>  一部の型マッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  
+  
+### カスタム型マッピング  
+ LINQ to SQL では、O\/R デザイナー、SQLMetal、および <xref:System.Data.Linq.DataContext.CreateDatabase%2A> メソッドで使用される既定の型マッピング以外も使用できます。  DBML ファイルで明示的に指定すると、カスタム型マッピングを作成できます。  次に、その DBML ファイルを使用してオブジェクト モデル コードとマッピング ファイルを作成できます。  詳細については、「[SQL\-CLR Custom Type Mappings](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md)」を参照してください。  
+  
+<a name="BehaviorDiffs"></a>   
+## CLR と SQL の実行時の動作の違い  
+ CLR と SQL Server では有効桁数や実行方法が異なるため、計算を実行する場所によって、得られる結果や動作が異なる場合があります。  LINQ to SQL クエリで実行される計算は、実際は Transact\-SQL に変換されてから SQL Server データベースで実行されます。  LINQ to SQL クエリの外部で実行される計算は、CLR のコンテキスト内で実行されます。  
+  
+ CLR および SQL Server 間での動作の違いの例を次に示します。  
+  
+-   SQL Server では、一部のデータ型が、CLR の対応する型のデータとは異なる順序で並べ替えられます。  たとえば、SQL Server の `UNIQUEIDENTIFIER` 型のデータは、CLR の <xref:System.Guid?displayProperty=fullName> 型のデータとは異なる順序で並べ替えられます。  
+  
+-   SQL Server では、一部の文字列比較操作の処理が CLR とは異なります。  SQL Server での文字列比較の動作は、サーバー上の照合順序の設定によって決まります。  詳細については、Microsoft SQL Server オンライン ブックの「[照合順序の使用](http://go.microsoft.com/fwlink/?LinkId=115330)」を参照してください。  
+  
+-   SQL Server では、マップされている一部の関数で、CLR とは異なる値が返されることがあります。  たとえば、末尾の空白文字のみが異なる 2 つの文字列を等価関数で比較した場合、SQL Server では等しいと見なされるのに対し、CLR では等しくないと見なされます。  
+  
+<a name="EnumMapping"></a>   
+## Enum 型のマッピング  
+ LINQ to SQL では、CLR の <xref:System.Enum?displayProperty=fullName> 型の SQL Server 型へのマッピングが 2 種類サポートされています。  
+  
+-   SQL 数値型 \(`TINYINT`、`SMALLINT`、`INT`、`BIGINT`\) へのマッピング  
+  
+     CLR <xref:System.Enum?displayProperty=fullName> 型を SQL 数値型にマップすると、基になる CLR <xref:System.Enum?displayProperty=fullName> の整数値は SQL Server データベース列の値にマップされます。  たとえば、<xref:System.Enum?displayProperty=fullName> という名前の `DaysOfWeek` に、基になる整数値が 3 である `Tue` という名前のメンバーが含まれる場合、そのメンバーはデータベース値 3 にマップされます。  
+  
+-   SQL テキスト型 \(`CHAR`、`NCHAR`、`VARCHAR`、`NVARCHAR`\) へのマッピング  
+  
+     CLR <xref:System.Enum?displayProperty=fullName> 型を SQL テキスト型にマップすると、CLR <xref:System.Enum?displayProperty=fullName> のメンバーの名前に SQL データベース値がマップされます。  たとえば、<xref:System.Enum?displayProperty=fullName> という名前の `DaysOfWeek` に、基になる整数値が 3 である `Tue` という名前のメンバーが含まれる場合、このメンバーはデータベース値 `Tue` にマップされます。  
+  
+> [!NOTE]
+>  SQL のテキスト型を CLR の <xref:System.Enum?displayProperty=fullName> にマップする場合は、マップされる SQL 列に <xref:System.Enum> メンバーの名前のみを含めてください。  <xref:System.Enum> 型にマップされる SQL 列では、他の値はサポートされません。  
+  
+ O\/R デザイナーと SQLMetal コマンド ライン ツールでは、SQL の型から CLR の <xref:System.Enum> クラスへの自動的なマッピングはできません。  DBML ファイルを O\/R デザイナーと SQLMetal で使用できるようにカスタマイズして、このマッピングを明示的に設定する必要があります。  カスタム型マッピングの詳細については、「[SQL\-CLR Custom Type Mappings](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-custom-type-mappings.md)」を参照してください。  
+  
+ 列挙を目的とする SQL の列は、他の数値やテキストの列と型が同じであるため、これらのツールはユーザーの意図を認識できず、次の「[数値のマッピング](#NumericMapping)」と「[テキストおよび XML のマッピング](#TextMapping)」のセクションで説明するように既定のマッピングを使用します。  DBML ファイルを使用したコード生成の詳細については、「[Code Generation in LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)」を参照してください。  
+  
+ <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドでは、CLR の <xref:System.Enum?displayProperty=fullName> 型をマップするために数値型の SQL 列が作成されます。  
+  
+<a name="NumericMapping"></a>   
+## 数値のマッピング  
+ LINQ to SQL では、CLR と SQL Server のさまざまな数値型をマップできます。  次の表に、O\/R デザイナーおよび SQLMetal でデータベースに基づいてオブジェクト モデルまたは外部マッピング ファイルを作成するときに選択される CLR 型を示します。  
+  
+|SQL Server 型|O\/R デザイナーおよび SQLMetal で使用される既定の CLR 型マッピング|  
+|------------------|-------------------------------------------------|  
+|`BIT`|<xref:System.Boolean?displayProperty=fullName>|  
+|`TINYINT`|<xref:System.Int16?displayProperty=fullName>|  
+|`INT`|<xref:System.Int32?displayProperty=fullName>|  
+|`BIGINT`|<xref:System.Int64?displayProperty=fullName>|  
+|`SMALLMONEY`|<xref:System.Decimal?displayProperty=fullName>|  
+|`MONEY`|<xref:System.Decimal?displayProperty=fullName>|  
+|`DECIMAL`|<xref:System.Decimal?displayProperty=fullName>|  
+|`NUMERIC`|<xref:System.Decimal?displayProperty=fullName>|  
+|`REAL/FLOAT(24)`|<xref:System.Single?displayProperty=fullName>|  
+|`FLOAT/FLOAT(53)`|<xref:System.Double?displayProperty=fullName>|  
+  
+ 次の表に、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで使用される既定の型マッピングを示します。既定の型マッピングでは、オブジェクト モデルまたは外部マッピング ファイルで定義された CLR 型にマップするために作成される SQL 列の型が定義されています。  
+  
+|CLR 型|<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> で使用される既定の SQL Server 型|  
+|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Boolean?displayProperty=fullName>|`BIT`|  
+|<xref:System.Byte?displayProperty=fullName>|`TINYINT`|  
+|<xref:System.Int16?displayProperty=fullName>|`SMALLINT`|  
+|<xref:System.Int32?displayProperty=fullName>|`INT`|  
+|<xref:System.Int64?displayProperty=fullName>|`BIGINT`|  
+|<xref:System.SByte?displayProperty=fullName>|`SMALLINT`|  
+|<xref:System.UInt16?displayProperty=fullName>|`INT`|  
+|<xref:System.UInt32?displayProperty=fullName>|`BIGINT`|  
+|<xref:System.UInt64?displayProperty=fullName>|`DECIMAL(20)`|  
+|<xref:System.Decimal?displayProperty=fullName>|`DECIMAL(29,4)`|  
+|<xref:System.Single?displayProperty=fullName>|`REAL`|  
+|<xref:System.Double?displayProperty=fullName>|`FLOAT`|  
+  
+ これ以外にもさまざまな数値のマッピングを選択できますが、一部のマッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  詳細については、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」を参照してください。  
+  
+### Decimal 型と Money 型  
+ SQL Server の `DECIMAL` 型の既定の有効桁数 \(小数点の右側と左側で 18 桁\) は、対応する既定の型である CLR の <xref:System.Decima?displayProperty=fullName>l 型の有効桁数よりはるかに少なくなっています。  その結果、データベースにデータを保存するときに有効桁数が少なくなることがあります。  一方、SQL Server の `DECIMAL` 型に 29 桁を超える有効桁数が設定されている場合、その逆が発生する可能性があります。  SQL Server の `DECIMAL` 型に CLR の <xref:System.Decimal?displayProperty=fullName> より大きい有効桁数の値が設定されていると、データベースからデータを取得するときに有効桁数が少なくなることがあります。  
+  
+ SQL Server の `MONEY` 型と `SMALLMONEY` 型も、既定で CLR の <xref:System.Decimal?displayProperty=fullName> 型に対応付けられます。これらの型も有効桁数がはるかに少ないため、データベースにデータを保存するときにオーバーフローやデータ損失の例外が発生する可能性があります。  
+  
+<a name="TextMapping"></a>   
+## テキストおよび XML のマッピング  
+ さまざまなテキスト ベースの型および XML 型も、LINQ to SQL を使用してマップすることができます。  次の表に、O\/R デザイナーおよび SQLMetal でデータベースに基づいてオブジェクト モデルまたは外部マッピング ファイルを作成するときに選択される CLR 型を示します。  
+  
+|SQL Server 型|O\/R デザイナーおよび SQLMetal で使用される既定の CLR 型マッピング|  
+|------------------|-------------------------------------------------|  
+|`CHAR`|<xref:System.String?displayProperty=fullName>|  
+|`NCHAR`|<xref:System.String?displayProperty=fullName>|  
+|`VARCHAR`|<xref:System.String?displayProperty=fullName>|  
+|`NVARCHAR`|<xref:System.String?displayProperty=fullName>|  
+|`TEXT`|<xref:System.String?displayProperty=fullName>|  
+|`NTEXT`|<xref:System.String?displayProperty=fullName>|  
+|`XML`|<xref:System.Xml.Linq.XElement?displayProperty=fullName>|  
+  
+ 次の表に、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで使用される既定の型マッピングを示します。既定の型マッピングでは、オブジェクト モデルまたは外部マッピング ファイルで定義された CLR 型にマップするために作成される SQL 列の型が定義されています。  
+  
+|CLR 型|<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> で使用される既定の SQL Server 型|  
+|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Char?displayProperty=fullName>|`NCHAR(1)`|  
+|<xref:System.String?displayProperty=fullName>|`NVARCHAR(4000)`|  
+|<xref:System.Char?displayProperty=fullName>\[\]|`NVARCHAR(4000)`|  
+|`Parse()` および `ToString()` を実装するカスタム型|`NVARCHAR(MAX)`|  
+  
+ これ以外にもさまざまなテキスト ベースおよび XML のマッピングを選択できますが、一部のマッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  詳細については、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」を参照してください。  
+  
+### XML 型  
+ SQL Server の `XML` データ型は、Microsoft SQL Server 2005 以降で使用できます。  SQL Server の `XML` データ型は、<xref:System.Xml.Linq.XElement>、<xref:System.Xml.Linq.XDocument>、または <xref:System.String> にマップできます。  <xref:System.Xml.Linq.XElement> に読み込むことができない XML フラグメントが列に格納されている場合は、列を <xref:System.String> にマップして、実行時エラーを回避する必要があります。  <xref:System.String> にマップする必要がある XML フラグメントを次に示します。  
+  
+-   XML 要素のシーケンス  
+  
+-   属性  
+  
+-   パブリック識別子 \(PI\)  
+  
+-   コメント  
+  
+ <xref:System.Xml.Linq.XElement> および <xref:System.Xml.Linq.XDocument> は、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」で示したように SQL Server にマップすることができますが、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドには、これらの型に対する既定の SQL Server 型マッピングはありません。  
+  
+### カスタム型  
+ クラスが `Parse()` および `ToString()` を実装している場合は、そのオブジェクトを SQL のテキスト型 \(`CHAR`、 `NCHAR`、`VARCHAR`、`NVARCHAR`、`TEXT`、`NTEXT`、`XML`\) にマップできます。  オブジェクトをデータベースに格納するには、`ToString()` から返された値をマップ先のデータベース列に送信します。  オブジェクトを再構築するには、データベースから返された文字列に対して `Parse()` を呼び出します。  
+  
+> [!NOTE]
+>  LINQ to SQL では、<xref:System.Xml.Serialization.IXmlSerializable?displayProperty=fullName> の使用によるシリアル化はサポートされません。  
+  
+<a name="DateMapping"></a>   
+## 日付および時刻のマッピング  
+ LINQ to SQL では、SQL Server のさまざまな日付型および時刻型をマップできます。  次の表に、O\/R デザイナーおよび SQLMetal でデータベースに基づいてオブジェクト モデルまたは外部マッピング ファイルを作成するときに選択される CLR 型を示します。  
+  
+|SQL Server 型|O\/R デザイナーおよび SQLMetal で使用される既定の CLR 型マッピング|  
+|------------------|-------------------------------------------------|  
+|`SMALLDATETIME`|<xref:System.DateTime?displayProperty=fullName>|  
+|`DATETIME`|<xref:System.DateTime?displayProperty=fullName>|  
+|`DATETIME2`|<xref:System.DateTime?displayProperty=fullName>|  
+|`DATETIMEOFFSET`|<xref:System.DateTimeOffset?displayProperty=fullName>|  
+|`DATE`|<xref:System.DateTime?displayProperty=fullName>|  
+|`TIME`|<xref:System.TimeSpan?displayProperty=fullName>|  
+  
+ 次の表に、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで使用される既定の型マッピングを示します。既定の型マッピングでは、オブジェクト モデルまたは外部マッピング ファイルで定義された CLR 型にマップするために作成される SQL 列の型が定義されています。  
+  
+|CLR 型|<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> で使用される既定の SQL Server 型|  
+|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.DateTime?displayProperty=fullName>|`DATETIME`|  
+|<xref:System.DateTimeOffset?displayProperty=fullName>|`DATETIMEOFFSET`|  
+|<xref:System.TimeSpan?displayProperty=fullName>|`TIME`|  
+  
+ これ以外にもさまざまな日付および時刻のマッピングを選択できますが、一部のマッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  詳細については、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」を参照してください。  
+  
+> [!NOTE]
+>  SQL Server の `DATETIME2` 型、`DATETIMEOFFSET` 型、`DATE` 型、および `TIME` 型は、Microsoft SQL Server 2008 以降で使用できます。  Microsoft .NET Framework version 3.5 SP1 以降の LINQ to SQL では、これらの新しい型へのマッピングがサポートされています。  
+  
+### System.Datetime  
+ CLR の <xref:System.DateTime?displayProperty=fullName> 型の範囲と有効桁数の値は、`DATETIME` メソッドの既定の型マッピングである SQL Server の <xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> 型の範囲と有効桁数より大きな値です。  `DATETIME` の範囲外の日付に関連する例外を回避するには、Microsoft SQL Server 2008 以降で利用できる `DATETIME2` を使用してください。  `DATETIME2` は、CLR の <xref:System.DateTime?displayProperty=fullName> の範囲と精度に対応させることができます。  
+  
+ SQL Server の日付には、CLR で十分にサポートされている機能である <xref:System.TimeZone> の概念がありません。  <xref:System.TimeZone> の値は、元の <xref:System.TimeZone> の情報にかかわらず、<xref:System.DateTimeKind> 変換なしでそのまま保存されます。  <xref:System.DateTime> 値がデータベースから取得される場合、その値は、<xref:System.DateTime> が <xref:System.DateTimeKind> の状態で、そのまま <xref:System.DateTimeKind> に読み込まれます。  サポートされる <xref:System.DateTime?displayProperty=fullName> メソッドの詳細については、「[System.DateTime Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-datetime-methods.md)」を参照してください。  
+  
+### System.TimeSpan  
+ Microsoft SQL Server 2008 および .NET Framework 3.5 SP1 では、CLR の <xref:System.TimeSpan?displayProperty=fullName> 型を SQL Server の `TIME` 型にマップできます。  ただし、CLR の <xref:System.TimeSpan?displayProperty=fullName> でサポートされる範囲と SQL Server `TIME` 型でサポートされる範囲には大きな差があります。  時間を表す 0 より小さい値または 23:59:59.9999999 より大きい値を SQL の `TIME` にマップすると、オーバーフロー例外が発生します。  詳細については、「[System.TimeSpan Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-timespan-methods.md)」を参照してください。  
+  
+ Microsoft SQL Server 2000 および SQL Server 2005 では、データベース フィールドを <xref:System.TimeSpan> にマップすることはできません。  ただし、<xref:System.TimeSpan> 値を <xref:System.TimeSpan> 減算から返したり、リテラル変数またはバインド変数として式に取り込んだりできるため、<xref:System.DateTime> の操作はサポートされています。  
+  
+<a name="BinaryMapping"></a>   
+## バイナリのマッピング  
+ SQL Server のさまざまな型を CLR の <xref:System.Data.Linq.Binary?displayProperty=fullName> 型にマップすることができます。  次の表に、O\/R デザイナーおよび SQLMetal でデータベースに基づいてオブジェクト モデルまたは外部マッピング ファイルを作成するときに、CLR の <xref:System.Data.Linq.Binary?displayProperty=fullName> 型が選択される SQL Server 型を示します。  
+  
+|SQL Server 型|O\/R デザイナーおよび SQLMetal で使用される既定の CLR 型マッピング|  
+|------------------|-------------------------------------------------|  
+|`BINARY(50)`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+|`VARBINARY(50)`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+|`VARBINARY(MAX)`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+|`VARBINARY(MAX)`  属性を持つ `FILESTREAM`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+|`IMAGE`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+|`TIMESTAMP`|<xref:System.Data.Linq.Binary?displayProperty=fullName>|  
+  
+ 次の表に、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで使用される既定の型マッピングを示します。既定の型マッピングでは、オブジェクト モデルまたは外部マッピング ファイルで定義された CLR 型にマップするために作成される SQL 列の型が定義されています。  
+  
+|CLR 型|<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> で使用される既定の SQL Server 型|  
+|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Data.Linq.Binary?displayProperty=fullName>|`VARBINARY(MAX)`|  
+|<xref:System.Byte?displayProperty=fullName>|`VARBINARY(MAX)`|  
+|<xref:System.Runtime.Serialization.ISerializable?displayProperty=fullName>|`VARBINARY(MAX)`|  
+  
+ これ以外にもさまざまなバイナリのマッピングを選択できますが、一部のマッピングでは、データベースに対する変換操作中にオーバーフローやデータ損失の例外が発生することがあります。  詳細については、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」を参照してください。  
+  
+### SQL Server の FILESTREAM  
+ `FILESTREAM` 列の `VARBINARY(MAX)` 属性は、Microsoft SQL Server 2008 以降で使用できます。.NET Framework version 3.5 SP1 以降の LINQ to SQL では、これらの属性にマップすることができます。  
+  
+ `VARBINARY(MAX)` 属性を持つ `FILESTREAM` 列を <xref:System.Data.Linq.Binary> オブジェクトにマップすることはできますが、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドを使用して `FILESTREAM` 属性を持つ列を自動的に作成することはできません。  `FILESTREAM` の詳細については、Microsoft SQL Server オンライン ブックの「[FILESTREAM の概要](http://go.microsoft.com/fwlink/?LinkId=115291)」を参照してください。  
+  
+<a name="BinarySerialization"></a>   
+### バイナリ シリアル化  
+ クラスが <xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装している場合は、オブジェクトを SQL バイナリ フィールド \(`BINARY`、`VARBINARY`、`IMAGE`\) にシリアル化できます。  <xref:System.Runtime.Serialization.ISerializable> インターフェイスの実装方法に従って、オブジェクトのシリアル化と逆シリアル化が行われます。  詳細については、「[バイナリ シリアル化](http://go.microsoft.com/fwlink/?LinkId=115581)」を参照してください。  
+  
+<a name="MiscMapping"></a>   
+## その他のマッピング  
+ ここでは、上記以外のさまざまな型について、既定の型マッピングを示します。  次の表に、O\/R デザイナーおよび SQLMetal でデータベースに基づいてオブジェクト モデルまたは外部マッピング ファイルを作成するときに選択される CLR 型を示します。  
+  
+|SQL Server 型|O\/R デザイナーおよび SQLMetal で使用される既定の CLR 型マッピング|  
+|------------------|-------------------------------------------------|  
+|`UNIQUEIDENTIFIER`|<xref:System.Guid?displayProperty=fullName>|  
+|`SQL_VARIANT`|<xref:System.Object?displayProperty=fullName>|  
+  
+ 次の表に、<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> メソッドで使用される既定の型マッピングを示します。既定の型マッピングでは、オブジェクト モデルまたは外部マッピング ファイルで定義された CLR 型にマップするために作成される SQL 列の型が定義されています。  
+  
+|CLR 型|<xref:System.Data.Linq.DataContext.CreateDatabase%2A?displayProperty=fullName> で使用される既定の SQL Server 型|  
+|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Guid?displayProperty=fullName>|`UNIQUEIDENTIFIER`|  
+|<xref:System.Object?displayProperty=fullName>|`SQL_VARIANT`|  
+  
+ LINQ to SQL では、ここに示したその他の型に対する上記以外の型マッピングはサポートされません。  詳細については、「[型マッピングと実行時動作の関係](#BehaviorMatrix)」を参照してください。  
+  
+## 参照  
+ [Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)   
+ [External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)   
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)   
+ [SQL\-CLR Type Mismatches](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md b/docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md
new file mode 100644
index 00000000000..b5a0afd2c70
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sql-clr-type-mismatches.md
@@ -0,0 +1,301 @@
+---
+title: "SQL-CLR Type Mismatches | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a90c33f-7ed7-4501-ad5f-6224c5da8e9b
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# SQL-CLR Type Mismatches
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はオブジェクト モデルと SQL Server 間の変換のほとんどを自動化します。  ただし、正確な変換が実行されない場合もあります。  以下のセクションでは、共通言語ランタイム \(CLR\) の型と SQL Server データベースの型の主な不一致について概要を示します。  特定の型のマッピングと関数の変換については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」と「[Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)」で詳しく説明しています。  
+  
+## データ型  
+ CLR と SQL Server 間の変換は、クエリがデータベースに送信されるときと、結果がオブジェクト モデルに返されるときに発生します。  たとえば、次の Transact\-SQL では 2 つの値の変換が必要です。  
+  
+```  
+Select DateOfBirth From Customer Where CustomerId = @id     
+```  
+  
+ SQL Server にクエリを実行する前に、Transact\-SQL パラメーターの値を指定する必要があります。  この例では、データベースが値を認識できるように、最初に `id` パラメーターの値を CLR の <xref:System.Int32?displayProperty=fullName> 型から SQL Server の `INT` 型に変換します。  次に、結果を取得するために、SQL Server の `DateOfBirth` 列を SQL Server の `DATETIME` 型から、オブジェクト モデルで使用できる CLR の <xref:System.DateTime?displayProperty=fullName> 型に変換する必要があります。  この例では、CLR オブジェクト モデルの型と SQL Server データベースの型をそのままマッピングできますが、  これが常に可能であるとは限りません。  
+  
+### 対応する型の欠落  
+ 次の型には、対応する適切な型がありません。  
+  
+-   CLR <xref:System> 名前空間の不一致 :  
+  
+    -   **符号なし整数**。  通常、この型はオーバーフローを避けるため、大きいサイズの符号付きの型に変換されます。  リテラルは、値に基づいて、同じサイズまたはより小さいサイズの符号付きの型に変換されます。  
+  
+    -   **ブール型**。  この型は、1 ビット以上の数値型または文字列型に変換できます。  リテラルは、同じ値に評価される式に \(たとえば SQL の `1=1` は CLS の `True` に\) 変換できます。  
+  
+    -   **TimeSpan**。  この型は、2 つの `DateTime` 値の差分を表します。SQL Server の `timestamp` には相当しません。  CLR の <xref:System.Timespan?displayProperty=fullName> は、場合によっては SQL Server の `TIME` 型にもマッピングします。  SQL Server の `TIME` 型は、24 時間未満の正の値を表すだけが目的でした。  CLR の <xref:System.Timespan> の範囲はこれよりずっと大きくなります。  
+  
+    > [!NOTE]
+    >  <xref:System.Data.SqlTypes> にある SQL Server に固有の [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] 型は、この比較には含まれていません。  
+  
+-   SQL Server の不一致 :  
+  
+    -   **固定長文字型**。  Transact\-SQL では、Unicode カテゴリと Unicode 以外のカテゴリが区別され、それぞれのカテゴリに 3 つの型 \(固定長 `nchar`\/`char`、可変長 `nvarchar`\/`varchar`、および大きいサイズの `ntext`\/`text`\) があります。  固定長文字型は、文字を取得するために CLR の <xref:System.Char?displayProperty=fullName> 型に変換できますが、この型の変換と動作に正確には対応していません。  
+  
+    -   **Bit**。  `bit` ドメインに格納される値の数は `Nullable<Boolean>` と同じですが、両者の型は異なります。  `Bit` が受け取る値は `1` と `0` であり、`true`\/`false` ではありません。また、ブール式に相当する型としては使用できません。  
+  
+    -   **Timestamp**。  CLR の <xref:System.Timespan?displayProperty=fullName> 型とは異なり、SQL Server の `TIMESTAMP` 型は、各更新に固有のデータベースで生成される 8 バイトの数字を表し、<xref:System.DateTime> の値の差異に基づくものではありません。  
+  
+    -   **Money** および **SmallMoney**。  これらの値は <xref:System.Decimal> に変換できますが、基本的には異なる型であり、サーバーベースの関数や変換では異なる型として扱われます。  
+  
+### 複数のマッピング  
+ SQL Server のデータ型には CLR の 1 つ以上のデータ型にマッピングできるものが多くあります。  また、CLR のデータ型にも SQL Server の 1 つ以上のデータ型にマッピングできるものが多くあります。  マッピングは LINQ to SQL でサポートされている場合がありますが、CLR と SQL Server 間でマッピングされる 2 つの型が有効桁数、範囲、セマンティクスにおいて完全に一致するとは限りません。  これらの要素の一部または全部が異なるマッピングもあります。  さまざまなマッピング パターンで生じる違いの詳細については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」を参照してください。  
+  
+### ユーザー定義型  
+ ユーザー定義の CLR 型は、型システムの差異を埋めるために設計されていますが、  型のバージョン管理に関する興味深い問題が発生しています。  クライアントで使用されるバージョンでの変更が、データベース サーバーに保存されている型での変更に一致しない場合があります。  このような変更が原因で別の型不一致が発生して型のセマンティクスが一致しなくなり、バージョンの差異が表面化する可能性があります。  後続のバージョンで継承階層がリファクタリングされるにつれて、問題はさらに複雑化します。  
+  
+## 式のセマンティクス  
+ CLR の型とデータベースの型が 1 対 1 で対応しないという不一致に加えて、式の変換がこの不一致をさらに複雑にしています。  演算子セマンティクス、関数セマンティクス、暗黙の型変換、および優先順位規則について不一致を考慮する必要があります。  
+  
+ ここでは、よく似ている式で起こる不一致について具体的に説明します。  特定の CLR 式にセマンティクス的に同等の SQL 式を生成することが可能な場合があります。  ただし、よく似た 2 つの式のセマンティクスの相違が CLR ユーザーに明らかかどうかは不明なため、セマンティクスの同等性に必要な変更が意図されているかどうかはわかりません。  これが特に重大な問題となるのは、式が一連の値に評価されるときです。  差異が見えるかどうかはデータによっても左右され、コーディングとデバッグの段階で特定することは困難です。  
+  
+### null セマンティクス  
+ SQL 式では、ブール式に 3 つの論理値を使用します。  式の結果は true、false、または null です。  これに対し、CLR は null 値に関する比較に、2 つの値によるブール型の結果を指定します。  次のコードがあるとします。  
+  
+ [!code-csharp[DLinqMismatch#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#2)]
+ [!code-vb[DLinqMismatch#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#2)]  
+  
+```  
+-- Assume col1 and col2 are integer columns with null values.   
+-- Assume that ANSI null behavior has not been explicitly  
+--    turned off.  
+Select …  
+From …  
+Where col1 = col2  
+-- Evaluates to null, not true and the corresponding row is not  
+--     selected.  
+-- To obtain matching behavior (i -> col1, j -> col2) change  
+--     the query to the following:  
+Select …  
+From …  
+Where  
+    col1 = col2   
+or (col1 is null and col2 is null)  
+-- (Visual Basic 'Nothing'.)  
+```  
+  
+ 同様の問題は、結果が 2 つの値のいずれかになることが前提とされているときにも起こります。  
+  
+ [!code-csharp[DLinqMismatch#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#3)]
+ [!code-vb[DLinqMismatch#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#3)]  
+  
+```  
+-- Assume col1 and col2 are nullable columns.  
+-- Assume that ANSI null behavior has not been explicitly  
+--     turned off.  
+Select …  
+From …  
+Where  
+    col1 = col2        
+or col1 != col2  
+-- Visual Basic: col1 <> col2.  
+  
+-- Excludes the case where the boolean expression evaluates  
+--     to null. Therefore the where clause does not always  
+--     evaluate to true.  
+```  
+  
+ この例では、生成される SQL の動作は同等ですが、意図したとおりに正確に変換されない可能性があります。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、C\# の `null` または [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] `nothing` の比較セマンティクスが SQL に強制されません。  比較演算子は、対応する SQL の演算子に構文上は変換されます。  セマンティクスには、サーバーまたは接続の設定で定義された SQL セマンティクスが反映されます。  既定の SQL Server 設定では、2 つの null 値は一致しないと見なされます \(この設定を変更するとセマンティクスを変更できます\)。  いずれにしても、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ではクエリの変換時にサーバーの設定は考慮されません。  
+  
+ リテラルの `null` \(`nothing`\) による比較は適切な SQL バージョンの \(`is null` または `is not null`\) に変換されます。  
+  
+ `null` \(`nothing`\) の値の照合順序は SQL Server で定義され、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では変更されません。  
+  
+### 型変換と上位変換  
+ SQL では、式における暗黙の型変換が豊富にサポートされています。  同じような式でも、C\# では明示的なキャストが必要です。  次に例を示します。  
+  
+-   `Nvarchar` 型と `DateTime` 型は、SQL では明示的にキャストせずに比較できますが、C\# では明示的に変換する必要があります。  
+  
+-   `Decimal` は、SQL では暗黙に `DateTime` に変換されます。  C\# では、暗黙の変換は行われません。  
+  
+ 同様に、型の基本セットが異なるため、Transact\-SQL の型の優先順位は C\# の優先順位と異なります。  実際に、両者の優先順位のリストには明白なサブセットやスーパーセットの関係は成り立ちません。  たとえば、`nvarchar` を `varchar` と比較すると、`varchar` 式が `nvarchar` に暗黙的に変換されます。  これに相当する上位変換は CLR にはありません。  
+  
+ 単純なケースでは、これらの違いによって、CLR 式には SQL 式では冗長となるキャストがあります。  さらに重要なことは、SQL 式が評価される過程で中間結果として、正確に対応するものが C\# に存在しない型に上位変換される \(またはその逆\) 可能性があることです。  このような式のテスト、デバッグ、および検証には多大な労力を要します。  
+  
+### Collation  
+ Transact\-SQL では、明示的な照合順序が文字列型の注釈としてサポートされます。  この照合順序に従って、特定の比較の有効性が決定されます。  たとえば、明示的な照合順序の異なる 2 つの列を比較するとエラーになります。  CTS の文字列型はこれよりも単純なため、このようなエラーは起こりません。  次に例を示します。  
+  
+```  
+create table T2 (  
+    Col1 nvarchar(10),  
+    Col2      nvarchar(10) collate Latin_general_ci_as  
+)  
+```  
+  
+ [!code-csharp[DLinqMismatch#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#4)]
+ [!code-vb[DLinqMismatch#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#4)]  
+  
+```  
+Select …  
+From …  
+Where Col1 = Col2  
+-- Error, collation conflict.  
+```  
+  
+ ここでは、collation サブ句で、代用できない*制限がある型*を作成しています。  
+  
+ 同様に、並べ替え順序も型システムによって顕著に異なります。  この相違は、結果の並べ替えに影響します。  <xref:System.Guid> は、すべての 16 バイトを辞書の編集順序 \(`IComparable()`\) で並べ替えますが、T\-SQL は、node\(10\-15\)、clock\-seq\(8\-9\)、time\-high\(6\-7\)、time\-mid\(4\-5\)、time\-low\(0\-3\) の順序で GUID を比較します。  この順序は、NT 生成の GUID がこのようなオクテット順になった SQL 7.0 で採用されました。  この方法により、同じノード クラスターで生成された GUID がタイムスタンプに従って順番に並ぶことが保証されていました。  また、この方法はインデックスの作成にも便利でした \(挿入時にランダムな入出力の代わりに追加が発生します\)。  この順番はプライバシーを考慮して後に Windows で暗号化されましたが、SQL では互換性を維持する必要があります。  この問題を回避するには、<xref:System.Guid> ではなく <xref:System.Data.SqlTypes.SqlGuid> を使用します。  
+  
+### 演算子と関数の相違  
+ 基本的には対応する関係にある演算子と関数にも、若干のセマンティクスの違いがあります。  次に例を示します。  
+  
+-   C\# の論理演算子 `&&` と `||` については、オペランドの辞書編集上の順序に基づいてショート サーキットのセマンティクスが指定されます。  一方 SQL では、セットベースのクエリの対象となるため、実行の順序を決定する際の自由度が高くなります。  次に、これの具体例をいくつか示します。  
+  
+    -   セマンティクスが等価になるように変換するには、SQL の "`CASE` … `WHEN` … `THEN`" 構造でオペランドの実行順序が変更されないようにする必要があります。  
+  
+    -   C\# の式が最初のオペランドの評価結果に基づく 2 番目のオペランドの評価に依存している場合は、`AND`\/`OR` 演算子へのルーズな変換によって予期しないエラーが発生する可能性があります。  
+  
+-   `Round()` 関数のセマンティクスは、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] と T\-SQL で異なります。  
+  
+-   文字列のインデックスは、CLR では 0 から始まりますが、SQL では 1 から始まります。  したがって、インデックスのある関数にはインデックスの変換が必要です。  
+  
+-   CLR では、浮動小数点数に剰余演算子 \(%\) がサポートされていますが、SQL ではサポートされていません。  
+  
+-   `Like` 演算子は、暗黙的な変換に基づいて自動的にオーバーロードされます。  `Like` は文字列型を操作するために定義された演算子ですが、数値型または `DateTime` 型に `Like` が使用される場合にはこれらの非文字列型からも暗黙の変換が許されます。  CTS には、これに相当する暗黙の変換はありません。  したがって、オーバーロードを追加する必要があります。  
+  
+    > [!NOTE]
+    >  この `Like` 演算子の動作は C\# のみに当てはまります。Visual Basic の `Like` キーワードは以前と変わりません。  
+  
+-   SQL では常にオーバーフローがチェックされますが、C\# ではこのチェックを明示的に指定して折り返しを回避する必要があります \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] では不要です\)。  たとえば、整数の列 C1、C2、および C3 があり、C1\+C2 が C3 \(Update T Set C3 \= C1 \+ C2\) に保存されるとします。  
+  
+    ```  
+    create table T3 (  
+        Col1      integer,  
+        Col2      integer  
+    )  
+    insert into T3 (col1, col2) values (2147483647, 5)  
+    -- Valid values: max integer value and 5.  
+    select * from T3 where col1 + col2 < 0  
+    -- Produces arithmetic overflow error.  
+    ```  
+  
+ [!code-csharp[DLinqMismatch#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#5)]
+ [!code-vb[DLinqMismatch#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#5)]  
+  
+-   SQL では対称的な算術型丸めが実行されますが、[!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] では銀行型丸めが使用されます。  詳細については、サポート技術情報の文書「丸めを行うカスタム プロシージャを実装する方法」\(196652\) を参照してください。  
+  
+-   既定で、共通ロケールの SQL で文字や文字列を比較する場合に大文字と小文字は区別されません。  Visual Basic と C\# では、大文字と小文字は区別されます。  たとえば、`s` が `food` の場合、`s == "Food"` \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] では `s = "Food"`\) と `s == "Food"` の結果は異なります。  
+  
+    ```  
+    -- Assume default US-English locale (case insensitive).  
+    create table T4 (  
+        Col1      nvarchar (256)  
+    )  
+    insert into T4 values (‘Food’)   
+    insert into T4 values (‘FOOD’)  
+    select * from T4 where Col1 = ‘food’  
+    -- Both the rows are returned because of case-insensitive matching.  
+    ```  
+  
+ [!code-csharp[DLinqMismatch#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#6)]
+ [!code-vb[DLinqMismatch#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#6)]  
+  
+-   SQL で固定長の文字型引数に適用される演算子や関数と、CLR の <xref:System.String?displayProperty=fullName> に適用される同じ演算子や関数とでは、セマンティクスに顕著な違いがあります。  これも、型の説明で指摘したように、対応する型の欠落の問題が波及したものと解釈できます。  
+  
+    ```  
+    create table T4 (  
+        Col1      nchar(4)  
+    )  
+    Insert into T5(Col1) values ('21');  
+    Insert into T5(Col1) values ('1021');  
+    Select * from T5 where Col1 like '%1'  
+    -- Only the second row with Col1 = '1021' is returned.  
+    -- Not the first row!  
+    ```  
+  
+     [!code-csharp[DLinqMismatch#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#7)]
+     [!code-vb[DLinqMismatch#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#7)]  
+  
+     同様の問題は、文字列の連結でも見られます。  
+  
+    ```  
+    create table T6 (  
+        Col1      nchar(4)  
+        Col2       nchar(4)  
+    )  
+    Insert into T6 values ('a', 'b');  
+    Select Col1+Col2 from T6  
+    -- Returns concatenation of padded strings "a   b   " and not "ab".  
+    ```  
+  
+ 概して、CLR 式には複雑な変換が必要になる場合があり、SQL 機能を表現するには演算子や関数の追加が必要になる可能性があります。  
+  
+### 型キャスト  
+ C\# と SQL では、明示的な型キャスト \(`Cast` および `Convert`\) を使って、式の既定のセマンティクスをオーバーライドできます。  ただし、型システムの境界を越えてこの機能を提供するとジレンマが生じます。  特定のセマンティクスを提供する SQL のキャストは、それに相当する C\# のキャストに簡単には変換できません。  反対に、C\# のキャストを SQL の同等のキャストに直接変換することはできません。型の不一致、対応する型の欠落、および型の優先順位の相違があるためです。  型システムの不一致の露出と式の有意性の喪失は、トレードオフの関係にあります。  
+  
+ また、型のキャストは、どちらのドメインでも式の検証には不要かもしれませんが、既定以外のマッピングを式に正しく適用するために必要になる場合があります。  
+  
+```  
+-- Example from "Non-default Mapping" section extended  
+create table T5 (  
+    Col1      nvarchar(10),  
+    Col2      nvarchar(10)  
+)  
+Insert into T5(col1, col2) values (‘3’, ‘2’);  
+```  
+  
+ [!code-csharp[DLinqMismatch#8](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#8)]
+ [!code-vb[DLinqMismatch#8](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#8)]  
+  
+```  
+Select *  
+From T5  
+Where Col1 + Col2 > 4     
+-- "Col1 + Col2" expr evaluates to '32'   
+```  
+  
+## パフォーマンスの問題  
+ SQL Server と CLR の型の相違が原因となり、CLR と SQL Server の型システムの境界を越えるときにパフォーマンスが低下する可能性があります。  次のような状況でパフォーマンスに影響が現れます。  
+  
+-   論理積\/和演算子の評価順序の強制  
+  
+-   述語の評価順序を強制する SQL を生成すると、SQL オプティマイザーの機能が制限されます。  
+  
+-   型変換は、CLR コンパイラで導入される場合も、オブジェクト リレーショナル クエリ実装で導入される場合も、インデックスの使用を抑制することがあります。  
+  
+     次に例を示します。  
+  
+    ```  
+    -- Table DDL  
+    create table T5 (  
+        Col1      varchar(100)  
+    )  
+    ```  
+  
+     [!code-csharp[DLinqMismatch#9](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqMismatch/cs/Program.cs#9)]
+     [!code-vb[DLinqMismatch#9](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqMismatch/vb/Module1.vb#9)]  
+  
+     式 `(s = SOME_STRING_CONSTANT)` を変換するとします。  
+  
+    ```  
+    -- Corresponding part of SQL where clause  
+    Where …  
+    Col1 = SOME_STRING_CONSTANT  
+    -- This expression is of the form <varchar> = <nvarchar>.  
+    -- Hence SQL introduces a conversion from varchar to nvarchar,  
+    --     resulting in  
+    Where …  
+    Convert(nvarchar(100), Col1) = SOME_STRING_CONSTANT  
+    -- Cannot use the index for column Col1 for some implementations.  
+    ```  
+  
+ SQL Server と CLR の型システムの境界を越えるときは、セマンティクスの相違に加えて、パフォーマンスへの影響も考慮することが重要です。  データセットが大きい場合、このようなパフォーマンスの問題が、アプリケーションの展開が可能かどうかを左右することがあります。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/sql-server-compact-and-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/sql-server-compact-and-linq-to-sql.md
new file mode 100644
index 00000000000..5999079401f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/sql-server-compact-and-linq-to-sql.md
@@ -0,0 +1,53 @@
+---
+title: "SQL Server Compact and LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 59022359-a5a2-4c42-9a6a-5c0259c3ad17
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server Compact and LINQ to SQL
+SQL Server Compact は、Visual Studio と共にインストールされる既定のデータベースです。詳細については、「[PAVE OVER Using SQL Server Compact \(Visual Studio\)](http://msdn.microsoft.com/ja-jp/13320dd1-94e5-4077-bf76-8df253695ccc)」を参照してください。  
+  
+ このトピックでは、使用法、構成、機能セット、および [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] サポートのスコープに関する主要な相違を示します。  
+  
+## LINQ to SQL との関係における SQL Server Compact の特徴  
+ 既定では、SQL Server Compact はすべての [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] エディションでインストールされるため、開発コンピューター上の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で使用できます。  しかし、SQL Server Compact と [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] を使用するアプリケーションの配置は、[!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] アプリケーションの場合とは異なります。  SQL Server Compact は .NET Framework の一部ではないため、アプリケーションにパッケージ化するか、Microsoft サイトから個別にダウンロードする必要があります。  
+  
+ これには、次のような特徴があります。  
+  
+-   SQL Server Compact は DLL としてパッケージ化されており、データベース ファイル \(.sdf 拡張子\) に対して直接使用できます。  
+  
+-   SQL Server Compact は、クライアント アプリケーションと同じプロセスで実行されます。  そのため、SQL Server Compact と通信する方が [!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] と通信するより効率的に優れています。  一方、SQL Server Compact では、コストを伴うマネージ コードとアンマネージ コード間の相互運用性が必要です。  
+  
+-   SQL Server Compact DLL のサイズはわずかです。  このため、アプリケーション全体のサイズが抑制されます。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ランタイムおよび SQLMetal コマンド ライン ツールが SQL Server Compact をサポートしています。  
+  
+-   [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)] では、SQL Server Compact はサポートしていません。  
+  
+## 機能セット  
+ SQL Server Compact の機能セットは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションに影響を及ぼす次の点で、[!INCLUDE[ssNoVersion](../../../../../../includes/ssnoversion-md.md)] の機能セットより単純です。  
+  
+-   SQL Server Compact は、ストアド プロシージャまたはビューをサポートしません。  
+  
+-   SQL Server Compact は、一部のデータ型と SQL 関数のみをサポートします。  
+  
+-   SQL Server Compact は、一部の SQL コンストラクトのみをサポートします。  
+  
+-   SQL Server Compact は、最小限のオプティマイザーを備えています。  クエリによってはタイムアウトする場合もあります。  
+  
+-   SQL Server Compact は、部分信頼をサポートしません。  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md b/docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md
new file mode 100644
index 00000000000..e2401842dca
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md
@@ -0,0 +1,238 @@
+---
+title: "Standard Query Operator Translation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a60c30fa-1e68-45fe-b984-f6abb9ede40e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Standard Query Operator Translation
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、標準クエリ演算子から SQL コマンドへの変換が行われます。  SQL 変換の実行のセマンティクスは、データベースのクエリ プロセッサによって決まります。  
+  
+ 標準クエリ演算子は*シーケンス*に対して定義されています。  シーケンスは*順序付き*で、シーケンスの各要素の参照 ID に基づいています。  詳細については、「[Standard Query Operators Overview](../../../../../../ocs/visual-basic/programming-guide/concepts/linq/standard-query-operators-overview.md)」を参照してください。  
+  
+ SQL が扱う対象は主に、*順序なしの値のセット*です。  通常、順序付けは、明示的な後処理の操作として、クエリの中間結果ではなく最終結果に対して適用されます。  ID は値で定義されます。  このため、SQL クエリは、*セット* \(集合\) ではなくマルチセット \(*多重集合*\) を扱うものとして理解されます。  
+  
+ 以下、標準クエリ演算子とその SQL 変換との違いを、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 用 SQL Server プロバイダーの場合について説明します。  
+  
+## 演算子のサポート  
+  
+### Concat  
+ <xref:System.Linq.Enumerable.Concat%2A> メソッドは、受信側と引数の順序が同じである、順序付けされたマルチセットに対して定義されます。  <xref:System.Linq.Enumerable.Concat%2A> は、共通の順序に従ったマルチセットに対する `UNION ALL` として機能します。  
+  
+ 最後の手順は、結果を生成する前の SQL での順序付けです。  <xref:System.Linq.Enumerable.Concat%2A> は、引数の順序を維持しません。  適切な順序にするには、<xref:System.Linq.Enumerable.Concat%2A> の結果を明示的に順序付けする必要があります。  
+  
+### Intersect、Except、Union  
+ <xref:System.Linq.Enumerable.Intersect%2A> メソッドと <xref:System.Linq.Enumerable.Except%2A> メソッドは、セットに対してのみ正しく定義されます。  マルチセットのセマンティクスは未定義です。  
+  
+ <xref:System.Linq.Enumerable.Union%2A> メソッドは、マルチセットの順序なし連結メソッドとして、マルチセットに対して定義されます \(事実上、SQL の UNION ALL 句の結果\)。  
+  
+### Take、Skip  
+ <xref:System.Linq.Enumerable.Take%2A> メソッドと <xref:System.Linq.Enumerable.Skip%2A> メソッドは、*順序付けされたセット*に対してのみ正しく定義されます。  順序付けされていないセットまたはマルチセットのセマンティクスは未定義です。  
+  
+> [!NOTE]
+>  <xref:System.Linq.Enumerable.Take%2A> と <xref:System.Linq.Enumerable.Skip%2A> を SQL Server 2000 に対するクエリで使用する場合は、いくつかの制限があります。  詳細については、「[Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)」の「SQL Server 2000 の Skip 例外と Take 例外」を参照してください。  
+  
+ SQL の順序付けの制約により、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、これらのメソッドの引数の順序を、メソッドの結果に移動することを試みます。  たとえば、次のような [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリがあるとします。  
+  
+ [!code-csharp[DLinqSQOTranslation#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSQOTranslation/cs/Program.cs#1)]
+ [!code-vb[DLinqSQOTranslation#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSQOTranslation/vb/Module1.vb#1)]  
+  
+ このコードに対して生成される SQL では、順序が次のように末尾に移動されます。  
+  
+```  
+SELECT TOP 1 [t0].[CustomerID], [t0].[CompanyName],  
+FROM [Customers] AS [t0]  
+WHERE (NOT (EXISTS(  
+    SELECT NULL AS [EMPTY]  
+    FROM (  
+        SELECT TOP 1 [t1].[CustomerID]  
+        FROM [Customers] AS [t1]  
+        WHERE [t1].[City] = @p0  
+        ORDER BY [t1].[CustomerID]  
+        ) AS [t2]  
+    WHERE [t0].[CustomerID] = [t2].[CustomerID]  
+    ))) AND ([t0].[City] = @p1)  
+ORDER BY [t0].[CustomerID]  
+```  
+  
+ <xref:System.Linq.Enumerable.Take%2A> と <xref:System.Linq.Enumerable.Skip%2A> を連結する場合は、指定されているすべての順序が一致することが当然必要です。  それ以外の場合、結果は未定義です。  
+  
+ <xref:System.Linq.Enumerable.Take%2A> と <xref:System.Linq.Enumerable.Skip%2A> はいずれも、標準クエリ演算子の仕様に基づく、負でない定数の整数引数に対して正しく定義されます。  
+  
+### 変換されない演算子  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって変換されないメソッドを次に示します。  最も一般的な理由は、順序なしのマルチセットとシーケンスの違いにあります。  
+  
+|演算子|理由|  
+|---------|--------|  
+|<xref:System.Linq.Enumerable.TakeWhile%2A>, <xref:System.Linq.Enumerable.SkipWhile%2A>|SQL クエリの操作の対象は、シーケンスではなく、マルチセットです。  結果に対して適用する最後の句が `ORDER BY` であることが必要です。  このため、これら 2 つのメソッドには、汎用的な変換がありません。|  
+|<xref:System.Linq.Enumerable.Reverse%2A>|順序付けされたセットに対しては、このメソッドの変換が可能ですが、現在の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では変換されません。|  
+|<xref:System.Linq.Enumerable.Last%2A>, <xref:System.Linq.Enumerable.LastOrDefault%2A>|順序付けされたセットに対しては、これらのメソッドの変換が可能ですが、現在の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では変換されません。|  
+|<xref:System.Linq.Enumerable.ElementAt%2A>, <xref:System.Linq.Enumerable.ElementAtOrDefault%2A>|SQL クエリの操作の対象は、インデックス可能なシーケンスではなくマルチセットです。|  
+|<xref:System.Linq.Enumerable.DefaultIfEmpty%2A> \(既定の引数のオーバーロード\)|一般に、任意のタプルに対して既定値を指定することはできません。  場合によっては、外部結合を通じて、タプルに対する null 値の使用が可能です。|  
+  
+## 式の変換  
+  
+### null セマンティクス  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、null 比較セマンティクスを SQL に強制しません。  比較演算子は、対応する SQL の演算子に構文上は変換されます。  このため、セマンティクスには、サーバーまたは接続の設定で定義された SQL セマンティクスが反映されます。  たとえば、既定の SQL Server 設定では、2 つの null 値は一致しないと見なされますが、この設定を変更することでセマンティクスを変更できます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、クエリを変換するときにサーバーの設定を考慮しません。  
+  
+ リテラルの null による比較は適切な SQL 形式 \(`is null` または `is not null`\) に変換されます。  
+  
+ `null` の値の照合順序は SQL Server で定義されます  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では変更されません。  
+  
+### 集計  
+ 標準クエリ演算子の集計メソッド <xref:System.Linq.Enumerable.Sum%2A> では、空のシーケンスや null のみを含むシーケンスはゼロに評価されます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、SQL のセマンティクスは変更されず、空のシーケンスまたは null のみを含むシーケンスは、<xref:System.Linq.Enumerable.Sum%2A> による評価はゼロではなく `null` になります。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] での集計には、中間結果に対する SQL の制限が適用されます。  32 ビットの整数の <xref:System.Linq.Enumerable.Sum%2A> の計算には、64 ビットの結果は使用されません。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] による <xref:System.Linq.Enumerable.Sum%2A> の変換では、対応するメモリ内シーケンスに、標準クエリ演算子の実装によるオーバーフローが発生していない場合でも、オーバーフローが発生することがあります。  
+  
+ 同様に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が整数値の <xref:System.Linq.Enumerable.Average%2A> を変換するときには、`double` ではなく `integer` として計算されます。  
+  
+### エンティティ引数  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Linq.Enumerable.GroupBy%2A> メソッドおよび <xref:System.Linq.Enumerable.OrderBy%2A> メソッドでエンティティ型を使用できます。  これらの演算子の変換では、型の引数を使用している場合、その型のすべてのメンバーを指定しているのと同等と見なされます。  たとえば、次のコードは同じ意味です。  
+  
+ [!code-csharp[DLinqSQOTranslation#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSQOTranslation/cs/Program.cs#2)]
+ [!code-vb[DLinqSQOTranslation#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSQOTranslation/vb/Module1.vb#2)]  
+  
+### 引数の等値性\/比較  
+ 以下のメソッドの実装では、引数が等値であることが必要です。  
+  
+ <xref:System.Linq.Enumerable.Contains%2A>  
+  
+ <xref:System.Linq.Enumerable.Skip%2A>  
+  
+ <xref:System.Linq.Enumerable.Union%2A>  
+  
+ <xref:System.Linq.Enumerable.Intersect%2A>  
+  
+ <xref:System.Linq.Enumerable.Except%2A>  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、*フラット*な引数に対して、等値性と比較がサポートされていますが、シーケンスの引数またはシーケンスを含む引数に対してはサポートされていません。  フラットな引数とは、SQL の行に対応付けられる型のものです。  シーケンスを含まないと静的に決定できる 1 つまたは複数のエンティティ型の射影は、フラットな引数と見なされます。  
+  
+ フラットな引数の例を次に示します。  
+  
+ [!code-csharp[DLinqSQOTranslation#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSQOTranslation/cs/Program.cs#3)]
+ [!code-vb[DLinqSQOTranslation#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSQOTranslation/vb/Module1.vb#3)]  
+  
+ フラットでない \(階層構造の\) 引数の例を次に示します。  
+  
+ [!code-csharp[DLinqSQOTranslation#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqSQOTranslation/cs/Program.cs#4)]
+ [!code-vb[DLinqSQOTranslation#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqSQOTranslation/vb/Module1.vb#4)]  
+  
+### Visual Basic の関数の変換  
+ Visual Basic のコンパイラが使用する以下のヘルパー関数は、対応する SQL 演算子および関数に変換されます。  
+  
+ `CompareString`  
+  
+ `DateTime.Compare`  
+  
+ `Decimal.Compare`  
+  
+ `IIf (in Microsoft.VisualBasic.Interaction)`  
+  
+ 変換メソッド :  
+  
+|||||  
+|-|-|-|-|  
+|ToBoolean|ToSByte|ToByte|ToChar|  
+|ToCharArrayRankOne|ToDate|ToDecimal|ToDouble|  
+|ToInteger|ToUInteger|ToLong|ToULong|  
+|ToShort|ToUShort|ToSingle|ToString|  
+  
+## 継承のサポート  
+  
+### 継承の対応付けの制限  
+ 詳細については、「[How to: Map Inheritance Hierarchies](../../../../../../docs/framework/data/adonet/sql/linq/how-to-map-inheritance-hierarchies.md)」を参照してください。  
+  
+### クエリでの継承  
+ C\# のキャストは射影でのみサポートされます。  他の場所で使用したキャストは変換されず、無視されます。  SQL 関数名を除き、SQL が実行するのは、共通言語ランタイム \(CLR: Common Language Runtime\) の <xref:System.Convert> に相当する処理のみです。  つまり、SQL は、ある型の値を別の型に変更することはできます。  CLR のキャストに相当するものはありません。同じビット列を別の型として再解釈するという概念がないためです。  したがって、C\# のキャストはローカルでのみ機能します。  リモート処理はされません。  
+  
+ 演算子 `is` と `as`、および `GetType` メソッドは、`Select` 演算子に限定されません。  他のクエリ演算子でも使用できます。  
+  
+## SQL Server 2008 のサポート  
+ .NET Framework 3.5 SP1 以降、LINQ to SQL は SQL Server 2008 で導入された新しい日付\/時刻型へのマッピングをサポートします。  ただし、これらの新しい型にマッピングされた値を操作するときに使用できる LINQ to SQL のクエリ演算子にはいくつか制限があります。  
+  
+### サポートされていないクエリ演算子  
+ `DATETIME2`、`DATE`、`TIME`、および `DATETIMEOFFSET` は、SQL Server の新しい日付\/時刻型にマッピングされた値ではサポートされていません。  
+  
+-   `Aggregate`  
+  
+-   `Average`  
+  
+-   `LastOrDefault`  
+  
+-   `OfType`  
+  
+-   `Sum`  
+  
+ SQL Server の日付\/時刻型へのマッピングの詳細については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」を参照してください。  
+  
+## SQL Server 2005 のサポート  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、SQL Server 2005 の以下の機能をサポートしていません。  
+  
+-   SQL CLR 用に作成されたストアド プロシージャ。  
+  
+-   ユーザー定義型。  
+  
+-   XML クエリ機能。  
+  
+## SQL Server 2000 のサポート  
+ [!INCLUDE[sqprsqext](../../../../../../includes/sqprsqext-md.md)] と比較した場合の [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] の以下の制限事項は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のサポートに影響します。  
+  
+### Cross Apply 演算子および Outer Apply 演算子  
+ これらの演算子は [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] では使用できません。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、一連の書き換えを行って、これらの演算子を適切な結合に置換します。  
+  
+ `Cross Apply` および `Outer Apply` は、リレーションシップ ナビゲーションに対してのみ生成されます。  どのようなクエリのセットに対してこのような書き換えが可能かは、正しく定義されていません。  このため、[!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] でサポートされている最小限のクエリのセットは、リレーションシップ ナビゲーションを含まないクエリのセットです。  
+  
+### text \/ ntext  
+ データ型 `text` \/ `ntext` は、[!INCLUDE[sqprsqext](../../../../../../includes/sqprsqext-md.md)] でサポートされている、`varchar(max)` \/ `nvarchar(max)` に対する特定のクエリ操作では使用できません。  
+  
+ この制限事項には、対処方法はありません。  具体的には、`text` 列または `ntext` 列に割り当てられているメンバーを含む結果に対して、`Distinct()` を使用することはできません。  
+  
+### 入れ子になったクエリによってトリガーされる動作  
+ [!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] \(SP4 まで\) のバインダーには、入れ子になったクエリによってトリガーされる特異な動作があります。  この特異動作をトリガーする SQL クエリのセットは、正しく定義されていません。  このため、SQL Server の例外を発生させる可能性がある [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] クエリのセットは定義することができません。  
+  
+### Skip 演算子および Take 演算子  
+ <xref:System.Linq.Enumerable.Take%2A> と <xref:System.Linq.Enumerable.Skip%2A> には、[!INCLUDE[ss2k](../../../../../../includes/ss2k-md.md)] に対するクエリで使用する場合に特定の制限があります。  詳細については、「[Troubleshooting](../../../../../../docs/framework/data/adonet/sql/linq/troubleshooting.md)」の「SQL Server 2000 の Skip 例外と Take 例外」を参照してください。  
+  
+## オブジェクトの具体化  
+ 実体化とは、1 つまたは複数の SQL クエリで返された行から CLR オブジェクトを作成することです。  
+  
+-   以下の呼び出しは、実体化の中で*ローカルで実行*されます。  
+  
+    -   コンストラクター  
+  
+    -   射影での `ToString` メソッド  
+  
+    -   射影での型キャスト  
+  
+-   <xref:System.Linq.Enumerable.AsEnumerable%2A> メソッドに続くメソッドは*ローカルで実行*されます。  このメソッドでは即時実行は行われません。  
+  
+-   `struct` は、クエリ結果の戻り値の型として、または結果の型のメンバーとして使用できます。  エンティティはクラスである必要があります。  匿名型はクラス インスタンスとして実体化されますが、射影では名前付き構造体 \(エンティティ以外\) を使用できます。  
+  
+-   クエリ結果の戻り値の型のメンバーには、<xref:System.Linq.IQueryable%601> 型を使用できます。  これはローカル コレクションとして実体化されます。  
+  
+-   以下のメソッドでは、メソッドの対象シーケンスの*即時実体化*が発生します。  
+  
+    -   <xref:System.Linq.Enumerable.ToList%2A>  
+  
+    -   <xref:System.Linq.Enumerable.ToDictionary%2A>  
+  
+    -   <xref:System.Linq.Enumerable.ToArray%2A>  
+  
+## 参照  
+ [Reference](../../../../../../docs/framework/data/adonet/sql/linq/reference.md)   
+ [Return Or Skip Elements in a Sequence](../../../../../../docs/framework/data/adonet/sql/linq/return-or-skip-elements-in-a-sequence.md)   
+ [Concatenate Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/concatenate-two-sequences.md)   
+ [Return the Set Difference Between Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-difference-between-two-sequences.md)   
+ [Return the Set Intersection of Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-intersection-of-two-sequences.md)   
+ [Return the Set Union of Two Sequences](../../../../../../docs/framework/data/adonet/sql/linq/return-the-set-union-of-two-sequences.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/stored-procedures.md b/docs/framework/data/adonet/sql/linq/stored-procedures.md
new file mode 100644
index 00000000000..e9d7ed7d710
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/stored-procedures.md
@@ -0,0 +1,51 @@
+---
+title: "Stored Procedures | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d23dd7a-a85f-44ff-a717-af7d0950c0fc
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Stored Procedures
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、オブジェクト モデル内のメソッドを使用して、データベース内のストアド プロシージャを表します。  <xref:System.Data.Linq.Mapping.FunctionAttribute> 属性、および必要に応じて <xref:System.Data.Linq.Mapping.ParameterAttribute> 属性を適用することによって、メソッドをストアド プロシージャとして指定します。  詳細については、「[The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)」を参照してください。  
+  
+ [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、通常、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してストアド プロシージャを対応付けます。このセクションのトピックでは、自分でコードを作成する場合に、アプリケーション内でこれらのメソッドを記述および呼び出す方法について説明します。  
+  
+## このセクションの内容  
+ [How to: Return Rowsets](../../../../../../docs/framework/data/adonet/sql/linq/how-to-return-rowsets.md)  
+ データ行を返す方法および入力パラメーターの使用方法について説明します。  
+  
+ [How to: Use Stored Procedures that Take Parameters](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-that-take-parameters.md)  
+ 入力パラメーターおよび出力パラメーターの使用方法について説明します。  
+  
+ [How to: Use Stored Procedures Mapped for Multiple Result Shapes](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-multiple-result-shapes.md)  
+ 同じストアド プロシージャで複数の形状の結果を返す方法について説明します。  
+  
+ [How to: Use Stored Procedures Mapped for Sequential Result Shapes](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-stored-procedures-mapped-for-sequential-result-shapes.md)  
+ リターン シーケンスが既知の場合に複数の形状を返す方法について説明します。  
+  
+ [Customizing Operations By Using Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures.md)  
+ ストアド プロシージャを使用して挿入、更新、および削除の操作を実装する方法について説明します。  
+  
+ [Customizing Operations by Using Stored Procedures Exclusively](../../../../../../docs/framework/data/adonet/sql/linq/customizing-operations-by-using-stored-procedures-exclusively.md)  
+ ストアド プロシージャのみを使用して挿入、更新、および削除の操作を実装する方法について説明します。  
+  
+## 関連項目  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデルを作成および使用する方法について説明します。  
+  
+ [Walkthrough: Using Only Stored Procedures \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-visual-basic.md)  
+ Visual Basic でストアド プロシージャを使用する手順を示します。  
+  
+ [Walkthrough: Using Only Stored Procedures \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-csharp.md)  
+ C\# でストアド プロシージャを使用する手順を示します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-convert-methods.md b/docs/framework/data/adonet/sql/linq/system-convert-methods.md
new file mode 100644
index 00000000000..1ff0f852064
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-convert-methods.md
@@ -0,0 +1,59 @@
+---
+title: "System.Convert Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3ca6c5b6-ea5d-4ab0-b675-f082135b342c
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.Convert Methods
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の <xref:System.Convert> メソッドをサポートしていません。  
+  
+-   <xref:System.IFormatProvider> パラメーターを持つ形式。  
+  
+-   文字配列またはバイト配列を扱うメソッド。  
+  
+    -   <xref:System.Convert.FromBase64CharArray%2A>  
+  
+    -   <xref:System.Convert.ToBase64CharArray%2A>  
+  
+    -   <xref:System.Convert.FromBase64String%2A>  
+  
+    -   <xref:System.Convert.ToBase64String%2A>  
+  
+-   次のメソッド。  
+  
+    -   `public static <Type2> To<Type2>(<Type1> value);` \(  
+  
+         `Type1` および `Type2` は `sbyte`、`uint`、`ulong`、`ushort` のいずれか\)  
+  
+    -   C\#:  
+  
+         `int To<int type>(string value, int fromBase),`  
+  
+         `ToString(...  value, int toBase)`  
+  
+    -   Visual Basic:  
+  
+         `Function To(Of [Numeric])(value as String, fromBase As Integer)`  
+  
+         `As [Numeric], ToString( value As …, toBase As Integer)`  
+  
+    -   <xref:System.Convert.IsDBNull%2A>  
+  
+    -   <xref:System.Convert.GetTypeCode%2A>  
+  
+    -   <xref:System.Convert.ChangeType%2A>  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-datetime-methods.md b/docs/framework/data/adonet/sql/linq/system-datetime-methods.md
new file mode 100644
index 00000000000..9bca8ed84f7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-datetime-methods.md
@@ -0,0 +1,78 @@
+---
+title: "System.DateTime Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f80700c-e83f-4ab6-af0f-1c9a606e1133
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.DateTime Methods
+LINQ to SQL でサポートされている以下のメソッド、演算子、およびプロパティは、LINQ to SQL のクエリで使用できます。  メソッド、演算子、またはプロパティがサポートされていない場合は、LINQ to SQL でメンバーを変換して SQL Server で実行することはできません。  これらのメンバーはコード内で使用できますが、クエリが Transact\-SQL に変換される前、またはデータベースから結果が取得された後で評価する必要があります。  
+  
+## サポートされている System.DateTime メンバー  
+ オブジェクト モデルまたは外部マッピング ファイルにマッピングされると、LINQ to SQL クエリ内で次の <xref:System.DateTime?displayProperty=fullName> メンバーを呼び出すことができます。  
+  
+|サポートされている <xref:System.DateTime> メソッド|サポートされている <xref:System.DateTime> 演算子|サポートされている <xref:System.DateTime> プロパティ|  
+|---------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.DateTime.Add%2A>|<xref:System.DateTime.op_Addition%2A>|<xref:System.DateTime.Date%2A>|  
+|<xref:System.DateTime.AddDays%2A>|<xref:System.DateTime.op_Equality%2A>|<xref:System.DateTime.Day%2A>|  
+|<xref:System.DateTime.AddHours%2A>|<xref:System.DateTime.op_GreaterThan%2A>|<xref:System.DateTime.DayOfWeek%2A>|  
+|<xref:System.DateTime.AddMilliseconds%2A>|<xref:System.DateTime.op_GreaterThanOrEqual%2A>|<xref:System.DateTime.DayOfYear%2A>|  
+|<xref:System.DateTime.AddMinutes%2A>|<xref:System.DateTime.op_Inequality%2A>|<xref:System.DateTime.Hour%2A>|  
+|<xref:System.DateTime.AddMonths%2A>|<xref:System.DateTime.op_LessThan%2A>|<xref:System.DateTime.Millisecond%2A>|  
+|<xref:System.DateTime.AddSeconds%2A>|<xref:System.DateTime.op_LessThanOrEqual%2A>|<xref:System.DateTime.Minute%2A>|  
+|<xref:System.DateTime.AddTicks%2A>|<xref:System.DateTime.op_Subtraction%2A>|<xref:System.DateTime.Month%2A>|  
+|<xref:System.DateTime.AddYears%2A>||<xref:System.DateTime.Now%2A>|  
+|<xref:System.DateTime.Compare%2A>||<xref:System.DateTime.Second%2A>|  
+|<xref:System.DateTime.CompareTo%28System.DateTime%29>||<xref:System.DateTime.TimeOfDay%2A>|  
+|<xref:System.DateTime.Equals%28System.DateTime%29>||<xref:System.DateTime.Today%2A>|  
+|||<xref:System.DateTime.Year%2A>|  
+  
+## LINQ to SQL でサポートされていないメンバー  
+ 以下のメンバーは LINQ to SQL クエリ内でサポートされていません。  
+  
+|||  
+|-|-|  
+|<xref:System.DateTime.IsDaylightSavingTime%2A>|<xref:System.DateTime.IsLeapYear%2A>|  
+|<xref:System.DateTime.DaysInMonth%2A>|<xref:System.DateTime.ToBinary%2A>|  
+|<xref:System.DateTime.ToFileTime%2A>|<xref:System.DateTime.ToFileTimeUtc%2A>|  
+|<xref:System.DateTime.ToLongDateString%2A>|<xref:System.DateTime.ToLongTimeString%2A>|  
+|<xref:System.DateTime.ToOADate%2A>|<xref:System.DateTime.ToShortDateString%2A>|  
+|<xref:System.DateTime.ToShortTimeString%2A>|<xref:System.DateTime.ToUniversalTime%2A>|  
+|<xref:System.DateTime.FromBinary%2A>|<xref:System.DateTime.UtcNow%2A>|  
+|<xref:System.DateTime.FromFileTime%2A>|<xref:System.DateTime.FromFileTimeUtc%2A>|  
+|<xref:System.DateTime.FromOADate%2A>|<xref:System.DateTime.GetDateTimeFormats%2A>|  
+  
+## メソッドの変換例  
+ LINQ to SQL でサポートされているメソッドはすべて、SQL Server に送信される前に Transact\-SQL に変換されます。  たとえば、次のようなパターンを考えてみます。  
+  
+ `(dateTime1 – dateTime2).{Days, Hours, Milliseconds, Minutes, Months, Seconds, Years}`  
+  
+ 認識されると、次のように SQL Server の `DATEDIFF` 関数の直接呼び出しに変換されます。  
+  
+ `DATEDIFF({DatePart}, @dateTime1, @dateTime2)`  
+  
+## SQLMethods の日付と時刻のメソッド  
+ LINQ to SQL では、<xref:System.DateTime> 構造体で提供されるメソッドの他に、次の表に示すように、日付と時刻を操作する <xref:System.Data.Linq.SqlClient.SqlMethods?displayProperty=fullName> クラスのメソッドも提供しています。  
+  
+||||  
+|-|-|-|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffDay%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMillisecond%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffNanosecond%2A>|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffHour%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMinute%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffSecond%2A>|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMicrosecond%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMonth%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffYear%2A>|  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)   
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-datetimeoffset-methods.md b/docs/framework/data/adonet/sql/linq/system-datetimeoffset-methods.md
new file mode 100644
index 00000000000..44d12f3e41c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-datetimeoffset-methods.md
@@ -0,0 +1,39 @@
+---
+title: "System.DateTimeOffset Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 25b3e5c0-7603-4a70-b3e5-2149e3da69a2
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.DateTimeOffset Methods
+オブジェクト モデルまたは外部マッピング ファイルにマッピングされると、<xref:System.DateTimeOffset?displayProperty=fullName> メソッド、演算子、プロパティのほとんどを LINQ to SQL のクエリ内から呼び出すことができます。  
+  
+ サポートされていないメソッドは、`Finalize`、`GetHashCode`、`GetType`、`MemberwiseClone` など、LINQ to SQL クエリ内のコンテキストで意味を持たない <xref:System.Object?displayProperty=fullName> から継承されたメソッドだけです。  これらのメソッドは LINQ to SQL で変換して SQL Server で実行することができないため、サポートされていません。  
+  
+> [!NOTE]
+>  共通言語ランタイム \(CLR\) の <xref:System.DateTimeOffset?displayProperty=fullName> 構造体、およびそれを LINQ to SQL で SQL の `DATETIMEOFFSET` 列にマッピングする機能を使用するには、.NET Framework 3.5 SP1 以降が必要です。  SQL の `DATETIMEOFFSET` 列は、Microsoft SQL Server 2008 以降でのみ使用できます。  
+  
+## SQLMethods の日付と時刻のメソッド  
+ LINQ to SQL では、<xref:System.DateTimeOffset> 構造体で提供されるメソッドの他に、次の表に示すように、日付と時刻を操作する <xref:System.Data.Linq.SqlClient.SqlMethods?displayProperty=fullName> クラスのメソッドも提供しています。  
+  
+||||  
+|-|-|-|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffDay%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMillisecond%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffNanosecond%2A>|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffHour%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMinute%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffSecond%2A>|  
+|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMicrosecond%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffMonth%2A>|<xref:System.Data.Linq.SqlClient.SqlMethods.DateDiffYear%2A>|  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-math-methods.md b/docs/framework/data/adonet/sql/linq/system-math-methods.md
new file mode 100644
index 00000000000..b587f58b2a3
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-math-methods.md
@@ -0,0 +1,36 @@
+---
+title: "System.Math Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f299521-6f41-4720-bd70-67c93fc50948
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.Math Methods
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の <xref:System.Math> メソッドをサポートしていません。  
+  
+-   <xref:System.Math.DivRem%28System.Int32%2CSystem.Int32%2CSystem.Int32%40%29?displayProperty=fullName>  
+  
+-   <xref:System.Math.DivRem%28System.Int64%2CSystem.Int64%2CSystem.Int64%40%29?displayProperty=fullName>  
+  
+-   <xref:System.Math.IEEERemainder%28System.Double%2CSystem.Double%29?displayProperty=fullName>  
+  
+## .NET との相違  
+ .NET Framework で使用される丸めセマンティクスは SQL Server とは異なります。  .NET Framework の <xref:System.Math.Round%2A> メソッドは*銀行型丸め*を実行します。銀行型丸めでは、.5 で終わる数値は次の桁に切り上げられるのではなく、最も近い偶数になるように丸められます。  たとえば、2.5 は 2 に丸められ、3.5 は 4 に丸められます   \(この方法は、大規模なデータ トランザクションで、値が大きくなる組織的バイアスの回避に役立ちます\)。  
+  
+ SQL では、`ROUND` 関数は常に、0 から遠ざかる方向に丸めを実行します。  したがって、2.5 は 3 に丸められます。これは、2 に丸められる .NET Framework とは対照的です。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、SQL の `ROUND` セマンティクスに到達するため、銀行型丸めを実装しようとしません。  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-object-methods.md b/docs/framework/data/adonet/sql/linq/system-object-methods.md
new file mode 100644
index 00000000000..2b958c723a3
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-object-methods.md
@@ -0,0 +1,39 @@
+---
+title: "System.Object Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5397fca0-689e-443e-802f-e1cbdc866427
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.Object Methods
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の <xref:System.Object> メソッドをサポートしています。  
+  
+|||  
+|-|-|  
+|<xref:System.Object.Equals%28System.Object%29?displayProperty=fullName>|<xref:System.Object.Equals%28System.Object%2CSystem.Object%29?displayProperty=fullName>|  
+|<xref:System.Object.ToString?displayProperty=fullName>||  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の <xref:System.Object> メソッドをサポートしていません。  
+  
+|||  
+|-|-|  
+|<xref:System.Object.GetHashCode?displayProperty=fullName>|<xref:System.Object.ReferenceEquals%28System.Object%2CSystem.Object%29?displayProperty=fullName>|  
+|<xref:System.Object.MemberwiseClone?displayProperty=fullName>|<xref:System.Object.GetType?displayProperty=fullName>|  
+|`BINARY`、`VARBINARY`、`IMAGE`、`TIMESTAMP` などのバイナリ型の <xref:System.Object.ToString?displayProperty=fullName>||  
+  
+## .NET との相違  
+ SQL では、double 型に対する <xref:System.Object.ToString?displayProperty=fullName> の出力で、SQL `CONVERT`\(NVARCHAR\(30\), @x, 2\) を使用します。  このとき、SQL は常に 16 桁と指数表記を使用します \(たとえば、0 に対して "0.000000000000000e\+000" を使用\)。  そのため、<xref:System.Object.ToString?displayProperty=fullName> 変換では、.NET Framework 内の <xref:System.Convert.ToString%2A?displayProperty=fullName> と同じ文字列は作成されません。  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-string-methods.md b/docs/framework/data/adonet/sql/linq/system-string-methods.md
new file mode 100644
index 00000000000..727233f6782
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-string-methods.md
@@ -0,0 +1,66 @@
+---
+title: "System.String Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ce307f14-87e6-4816-8694-8a4147f6b784
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.String Methods
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の <xref:System.String> メソッドをサポートしていません。  
+  
+## サポートされていない一般的な System.String メソッド  
+ サポートされていない一般的な <xref:System.String> メソッドは次のとおりです。  
+  
+-   カルチャを認識するオーバーロード \(`CultureInfo`、`StringComparison`、`IFormatProvider` を受け取るメソッド\)  
+  
+-   `char` 配列を受け取るまたは生成するメソッド  
+  
+## サポートされていない System.String 静的メソッド  
+  
+|サポートされていない System.String 静的メソッド|  
+|-------------------------------------|  
+|<xref:System.String.Copy%28System.String%29?displayProperty=fullName>|  
+|<xref:System.String.Compare%28System.String%2CSystem.String%2CSystem.Boolean%29?displayProperty=fullName>|  
+|<xref:System.String.Compare%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Globalization.CultureInfo%29?displayProperty=fullName>|  
+|<xref:System.String.Compare%28System.String%2CSystem.Int32%2CSystem.String%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.String.Compare%28System.String%2CSystem.Int32%2CSystem.String%2CSystem.Int32%2CSystem.Int32%2CSystem.Boolean%29?displayProperty=fullName>|  
+|<xref:System.String.Compare%28System.String%2CSystem.Int32%2CSystem.String%2CSystem.Int32%2CSystem.Int32%2CSystem.Boolean%2CSystem.Globalization.CultureInfo%29?displayProperty=fullName>|  
+|<xref:System.String.CompareOrdinal%28System.String%2CSystem.String%29?displayProperty=fullName>|  
+|<xref:System.String.CompareOrdinal%28System.String%2CSystem.Int32%2CSystem.String%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName>|  
+|<xref:System.String.Format%2A?displayProperty=fullName>|  
+|<xref:System.String.Join%2A?displayProperty=fullName>|  
+  
+## サポートされていない System.String 非静的メソッド  
+  
+|サポートされていない System.String 非静的メソッド|  
+|--------------------------------------|  
+|[String.IndexOfAny\(Char\<xref:System.String.IndexOfAny%28System.Char%5B%5D%29?displayProperty=fullName>|  
+|<xref:System.String.Split%2A?displayProperty=fullName>|  
+|<xref:System.String.ToCharArray?displayProperty=fullName>|  
+|<xref:System.String.ToUpper%28System.Globalization.CultureInfo%29?displayProperty=fullName>|  
+|[String.TrimEnd\(Char\<xref:System.String.TrimEnd%28System.Char%5B%5D%29?displayProperty=fullName>|  
+|[String.TrimStart\(Char\<xref:System.String.TrimStart%28System.Char%5B%5D%29?displayProperty=fullName>|  
+  
+## .NET との相違  
+  
+-   SQL Server で有効にされている照合順序があっても、クエリには適用されません。したがって、既定では、カルチャ依存で大文字と小文字を区別しない比較が行われます。  この動作は、大文字と小文字を区別する .NET Framework の既定の動作とは異なります。  
+  
+-   `LastIndexOf` が 0 を返した場合は、文字列が `NULL` であるか、または見つかった位置が 0 であることを示します。  
+  
+-   固定長文字列 \(`CHAR`、`NCHAR`\) では、データベースにおいて自動的に埋め込みが適用されるため、連結やその他の操作で予期しない結果が生じることがあります。  
+  
+-   `TEXT` 列、`NTEXT` 列、および XML では、`Replace`、`ToLower`、`ToUpper` などの多くのメソッドや文字インデクサーで有効な変換が用意されていないため、通常の変換を行おうとすると `SqlExceptions` が発生します。  これらの型については、これが適切な動作と見なされます。  ただし、`VARCHAR`、`NVARCHAR`、`VARCHAR(max)`、および `NVARCHAR(max)` については、すべての文字列操作が共通言語ランタイム \(CLR: Common Language Runtime\) のセマンティクと一致している必要があります。  
+  
+## 参照  
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/system-timespan-methods.md b/docs/framework/data/adonet/sql/linq/system-timespan-methods.md
new file mode 100644
index 00000000000..12b85b96f1f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/system-timespan-methods.md
@@ -0,0 +1,49 @@
+---
+title: "System.TimeSpan Methods | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9333fee8-1454-4374-855b-8c14c002f48f
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# System.TimeSpan Methods
+<xref:System.TimeSpan?displayProperty=fullName> のメンバー サポートは、使用している .NET Framework と Microsoft SQL Server のバージョンに大きく依存します。  
+  
+ メソッド、演算子、またはプロパティがサポートされていなければ、LINQ to SQL でメンバーを変換して SQL Server で実行することができません。  それでもこれらのメンバーをコードで使用することはできますが、  クエリが Transact\-SQL に変換される前か、データベースから結果が取得された後で評価する必要があります。  
+  
+## 以前の制限  
+ .NET Framework 3.5 SP1 より前のバージョンの .NET Framework で LINQ to SQL を使用すると、SQL Server のデータベース フィールドを <xref:System.TimeSpan?displayProperty=fullName> にマッピングできません。  ただし、<xref:System.TimeSpan> 値を <xref:System.DateTime> 減算から返したり、リテラル変数またはバインド変数として式に取り込んだりできるため、<xref:System.TimeSpan> の操作はサポートされています。  
+  
+## サポートされている System.TimeSpan メソッド  
+ LINQ to SQL でサポートされている以下のメソッド、演算子、およびプロパティは、LINQ to SQL のクエリで使用できます。  オブジェクト モデルまたは外部マッピング ファイルにマッピングされると、LINQ to SQL クエリ内で <xref:System.TimeSpan?displayProperty=fullName> メンバーの多くを呼び出すことができます。  
+  
+|サポートされている <xref:System.TimeSpan> メソッド|サポートされている <xref:System.TimeSpan> 演算子|サポートされている <xref:System.TimeSpan> プロパティ|  
+|---------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.TimeSpan.Compare%2A>|<xref:System.TimeSpan.op_Equality%2A>|<xref:System.TimeSpan.Days%2A>|  
+|<xref:System.TimeSpan.CompareTo%28System.TimeSpan%29>|<xref:System.TimeSpan.op_GreaterThan%2A>|<xref:System.TimeSpan.Hours%2A>|  
+|<xref:System.TimeSpan.Duration%2A>|<xref:System.TimeSpan.op_GreaterThanOrEqual%2A>|<xref:System.TimeSpan.MaxValue>|  
+|<xref:System.TimeSpan.Equals%28System.TimeSpan%2CSystem.TimeSpan%29>|<xref:System.TimeSpan.op_Inequality%2A>|<xref:System.TimeSpan.Milliseconds%2A>|  
+|<xref:System.TimeSpan.Equals%28System.TimeSpan%29>|<xref:System.TimeSpan.op_LessThan%2A>|<xref:System.TimeSpan.Minutes%2A>|  
+||<xref:System.TimeSpan.op_LessThanOrEqual%2A>|<xref:System.TimeSpan.MinValue%2A>|  
+  
+> [!NOTE]
+>  LINQ to SQL で <xref:System.TimeSpan?displayProperty=fullName> を SQL の `TIME` 列にマッピングする機能を使用するには、.NET Framework 3.5 SP1 以降が必要です。  SQL の `TIME` データ型は Microsoft SQL Server 2008 以降でのみ使用可能です。  
+  
+### 加算と減算  
+ 加算と減算は、CLR の <xref:System.TimeSpan?displayProperty=fullName> 型ではサポートされていますが、SQL の `TIME` 型ではサポートされていません。  そのため、LINQ to SQL クエリにより、SQL の `TIME` 型にマッピングしたときに加算や減算を試みると、エラーが発生します。  SQL の日付\/時刻型の操作に関するその他の注意点については、「[SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)」を参照してください。  
+  
+## 参照  
+ [Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [SQL\-CLR Type Mapping](../../../../../../docs/framework/data/adonet/sql/linq/sql-clr-type-mapping.md)   
+ [Data Types and Functions](../../../../../../docs/framework/data/adonet/sql/linq/data-types-and-functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md b/docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md
new file mode 100644
index 00000000000..beefb773b88
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md
@@ -0,0 +1,89 @@
+---
+title: "The LINQ to SQL Object Model | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81dd0c37-e2a4-4694-83b0-f2e49e693810
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# The LINQ to SQL Object Model
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、開発者のプログラミング言語で表されるオブジェクト モデルが、リレーショナル データベースのデータ モデルに対応付けられています。  データ操作はオブジェクト モデルに従って行われます。  
+  
+ このシナリオでは、データベースに対してデータベース コマンド \(`INSERT` など\) を実行する必要はありません。  代わりに、オブジェクト モデル内で値を変更し、メソッドを実行します。  データベースに対してクエリを実行したり、変更を送信する必要がある場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、要求を正しい SQL コマンドに変換し、そのコマンドをデータベースに送信します。  
+  
+ ![DLinqObjectModel](../../../../../../docs/framework/data/adonet/sql/linq/media/dlinqobjectmodel.png "DLinqObjectModel")  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] オブジェクト モデル内の最も基本的な要素と、リレーショナル データ モデル内の要素との関係を、次の表に示します。  
+  
+|LINQ to SQL オブジェクト モデル|リレーショナル データ モデル|  
+|----------------------------|---------------------|  
+|エンティティ クラス|テーブル|  
+|クラス メンバー|Column|  
+|関連付け|外部キー リレーションシップ|  
+|メソッド|ストアド プロシージャまたは関数|  
+  
+> [!NOTE]
+>  次の説明は、リレーショナル データ モデルと規則に関する基本的な知識があることが前提です。  
+  
+## LINQ to SQL エンティティ クラスおよびデータベース テーブル  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、データベース テーブルは*エンティティ クラス*で表されます。  エンティティ クラスは、作成する他のクラスに似ていますが、クラスをデータベース テーブルに関連付ける特別な情報を使用して、クラスに注釈を付ける点が異なります。  次の例に示すように、クラス宣言にカスタム属性 \(<xref:System.Data.Linq.Mapping.TableAttribute>\) を追加することによって、この注釈を付けます。  
+  
+### 例  
+ [!code-csharp[DLinqObjectModel#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectModel/cs/Program.cs#1)]
+ [!code-vb[DLinqObjectModel#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectModel/vb/Module1.vb#1)]  
+  
+ テーブルとして宣言されたクラスのインスタンスのみ \(つまり、エンティティ クラス\)、データベースに保存できます。  
+  
+ 詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」の「Table 属性」セクションを参照してください。  
+  
+## LINQ to SQL クラス メンバーおよびデータベース列  
+ クラスとテーブルの関連付けに加えて、フィールドまたはプロパティを設定してデータベース列を表すことができます。  このためには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、次の例に示すように <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性を定義します。  
+  
+### 例  
+ [!code-csharp[DLinqObjectModel#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectModel/cs/Program.cs#2)]
+ [!code-vb[DLinqObjectModel#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectModel/vb/Module1.vb#2)]  
+  
+ 列に対応付けられたフィールドおよびプロパティのみ、データベースに保持したり、データベースから取得できます。  列として宣言されていないものは、アプリケーション ロジックの一時的な部分と見なされます。  
+  
+ <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性にはさまざまなプロパティがあり、これを使用することで、列を表すメンバーをカスタマイズできます \(たとえば、主キー列を表すメンバーを指定できます\)。  詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」の「Column 属性」セクションを参照してください。  
+  
+## LINQ to SQL の関連付けおよびデータベースの外部キー リレーションシップ  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、<xref:System.Data.Linq.Mapping.AssociationAttribute> 属性を適用することによって、データベースの関連付け \(外部キーと主キーのリレーションシップなど\) を表します。  次のコード セグメントでは、`Order` クラスに `Customer` プロパティが含まれ、このプロパティが <xref:System.Data.Linq.Mapping.AssociationAttribute> 属性を持ちます。  このプロパティとその属性が、`Order` クラスおよび `Customer` クラスとのリレーションシップを提供します。  
+  
+ `Customer` クラスの `Order` プロパティを表示する方法を次の例に示します。  
+  
+### 例  
+ [!code-csharp[DLinqObjectModel#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectModel/cs/northwind.cs#3)]
+ [!code-vb[DLinqObjectModel#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectModel/vb/northwind.vb#3)]  
+  
+ 詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」の「Association 属性」セクションを参照してください。  
+  
+## LINQ to SQL メソッドおよびデータベース ストアド プロシージャ  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、ストアド プロシージャとユーザー定義関数をサポートしています。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、これらのデータベース定義の概念をクライアント オブジェクトに対応付けることによって、クライアント コードから厳密に型指定された方法でのアクセスを実現しています。  メソッド シグネチャは、データベース内で定義されているプロシージャおよび関数のシグネチャと可能な限りよく似ています。  IntelliSense を使用して、これらのメソッドを見つけることができます。  
+  
+ 呼び出しによって対応するプロシージャに返される結果セットは、厳密に型指定されたコレクションです。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、<xref:System.Data.Linq.Mapping.FunctionAttribute> 属性と <xref:System.Data.Linq.Mapping.ParameterAttribute> 属性を使用して、ストアド プロシージャおよび関数をメソッドに対応付けます。  ストアド プロシージャを表すメソッドは、<xref:System.Data.Linq.Mapping.FunctionAttribute.IsComposable%2A> プロパティによって、ユーザー定義関数を表すメソッドと区別されます。  このプロパティが `false` \(既定値\) に設定されている場合、メソッドはストアド プロシージャを表します。  `true` に設定されている場合、メソッドはデータベース関数を表します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している場合は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用して、ストアド プロシージャおよびユーザー定義関数に対応付けられるメソッドを作成できます。  
+  
+### 例  
+ [!code-csharp[DLinqObjectModel#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqObjectModel/cs/northwind.cs#4)]
+ [!code-vb[DLinqObjectModel#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqObjectModel/vb/northwind.vb#4)]  
+  
+ 詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」 の「Function 属性」、「Stored Procedure 属性」、および「Parameter 属性」の各セクション、および「[Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)」を参照してください。  
+  
+## 参照  
+ [Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)   
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/transaction-support.md b/docs/framework/data/adonet/sql/linq/transaction-support.md
new file mode 100644
index 00000000000..042f51bb4f6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/transaction-support.md
@@ -0,0 +1,35 @@
+---
+title: "Transaction Support | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8cceb26e-8d36-4365-8967-58e2e89e0187
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Transaction Support
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、3 種類のトランザクション モデルがサポートされています。  チェックが行われる順に、これらのモデルを以下に示します。  
+  
+## 明示的なローカル トランザクション  
+ <xref:System.Data.Linq.DataContext.SubmitChanges%2A> が呼び出されたときに <xref:System.Data.Linq.DataContext.Transaction%2A> プロパティが \(`IDbTransaction`\) トランザクションに設定されている場合、同じトランザクションのコンテキストで <xref:System.Data.Linq.DataContext.SubmitChanges%2A> 呼び出しが実行されます。  
+  
+ トランザクションの実行が終了したら、ユーザーがトランザクションをコミットまたはロールバックする必要があります。  トランザクションに対応する接続は、<xref:System.Data.Linq.DataContext> を構築するのに使用した接続に一致する必要があります。  異なる接続が使用されると、例外がスローされます。  
+  
+## 明示的な分散トランザクション  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] API \(<xref:System.Data.Linq.DataContext.SubmitChanges%2A> など\) は、アクティブな <xref:System.Transactions.Transaction> のスコープ内で呼び出すことができます。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、呼び出しがトランザクションのスコープにあることを検出し、新しいトランザクションを作成しません。  この場合は、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] によって、接続の終了も回避されます。  このようなトランザクションのコンテキストで、クエリと <xref:System.Data.Linq.DataContext.SubmitChanges%2A> の実行が可能です。  
+  
+## 暗黙のトランザクション  
+ <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すと、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、呼び出しが <xref:System.Transactions.Transaction> のスコープにあるかどうか、または `Transaction` プロパティ \(`IDbTransaction`\) がユーザーによって開始されたローカル トランザクションに設定されているかどうかをチェックします。  どちらのトランザクションも見つからない場合、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はローカル トランザクション \(`IDbTransaction`\) を開始し、それを使用して、生成された SQL コマンドを実行します。  すべての SQL コマンドが終了すると、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はローカル トランザクションをコミットして戻ります。  
+  
+## 参照  
+ [Background Information](../../../../../../docs/framework/data/adonet/sql/linq/background-information.md)   
+ [How to: Bracket Data Submissions by Using Transactions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-bracket-data-submissions-by-using-transactions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/troubleshooting.md b/docs/framework/data/adonet/sql/linq/troubleshooting.md
new file mode 100644
index 00000000000..e94abaf7e7a
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/troubleshooting.md
@@ -0,0 +1,81 @@
+---
+title: "Troubleshooting | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8cd4401c-b12c-4116-a421-f3dcffa65670
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Troubleshooting
+ここでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションで発生する可能性のある問題をいくつか示し、そうした問題を回避または影響を軽減するための提案を示します。  
+  
+ その他の問題については、「[Frequently Asked Questions](../../../../../../docs/framework/data/adonet/sql/linq/frequently-asked-questions.md)」を参照してください。  
+  
+## サポートされない標準クエリ演算子  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、すべての標準クエリ演算子メソッド \(たとえば <xref:System.Linq.Enumerable.ElementAt%2A>\) をサポートするわけではありません。  このため、コンパイルできたプロジェクトでも、ランタイム エラーが発生する可能性があります。  詳細については、「[Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)」を参照してください。  
+  
+## メモリの問題  
+ クエリにメモリ内コレクションと [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の <xref:System.Data.Linq.Table%601> が含まれる場合、2 つのコレクションの指定順序に応じて、メモリ内でクエリが実行される可能性があります。  クエリをメモリ内で実行する必要がある場合、データベース テーブルのデータを取得する必要があります。  
+  
+ この手法は非効率的で、メモリとプロセッサの消費量が非常に大きくなる可能性があります。  このような複数ドメインのクエリはできる限り使用しないでください。  
+  
+## ファイル名と SQLMetal  
+ 入力ファイル名を指定するには、その名前をコマンド ラインに入力ファイルとして追加します。  **\/conn** オプションを使用して接続文字列にファイル名を含める方法はサポートされていません。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## クラス ライブラリ プロジェクト  
+ [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]は、プロジェクトの `app.config` ファイルの中に接続文字列を作成します。  クラス ライブラリ プロジェクトでは `app.config` ファイルが使用されません。  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、デザイン時のファイルで提供される接続文字列を使用します。  `app.config` 内の値を変更しても、アプリケーションの接続先データベースは変更されません。  
+  
+## 連鎖削除  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は連鎖削除操作をサポートせず、認識もしません。  制約を持つテーブルの行を削除するには、次のいずれかを行う必要があります。  
+  
+-   データベース内の外部キー制約で `ON DELETE CASCADE` 規則を設定する。  
+  
+-   独自のコードを使用して、親オブジェクトの削除を妨げる子オブジェクトを最初に削除する。  
+  
+ このような操作を行わない場合、<xref:System.Data.SqlClient.SqlException> 例外がスローされます。  
+  
+ 詳細については、「[How to: Delete Rows From the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md)」を参照してください。  
+  
+## クエリ可能でない式  
+ 「'型' の式はクエリ不可能です。LINQ プロバイダーに対してアセンブリ参照や名前空間インポートが不足していないことを確認してください」というエラーが発生した場合、次の点を確認してください。  
+  
+-   アプリケーションが [!INCLUDE[compact_v35_short](../../../../../../includes/compact-v35-short-md.md)] を対象としている。  
+  
+-   `System.Core.dll` および `System.Data.Linq.dll` への参照が存在する。  
+  
+-   <xref:System.Linq> および <xref:System.Data.Linq> のための `Imports` \([!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)]\) または `using` \(C\#\) ディレクティブが存在する。  
+  
+## DuplicateKeyException  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトのデバッグ時に、エンティティのリレーションシップを走査する場合があります。  その際、これらの項目はキャッシュに入り、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] はこれらの存在を認識します。  その後、同じキーの複数の行を生成する <xref:System.Data.Linq.Table%601.Attach%2A> や <xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> などのメソッドを実行しようとした場合、<xref:System.Data.Linq.DuplicateKeyException> がスローされます。  
+  
+## 文字列連結の例外  
+ `[n]text` と他の `[n][var]char` にマップされる複数のオペランドを連結する操作はサポートされません。  異なる 2 つの型のセットにマップされる文字列を連結しようとすると、例外がスローされます。  詳細については、「[System.String Methods](../../../../../../docs/framework/data/adonet/sql/linq/system-string-methods.md)」を参照してください。  
+  
+## SQL Server 2000 の Skip 例外と Take 例外  
+ SQL Server 2000 データベースに対して <xref:System.Linq.Queryable.Take%2A> または <xref:System.Linq.Queryable.Skip%2A> を使用する際には、ID メンバー \(<xref:System.Data.Linq.Mapping.ColumnAttribute.IsPrimaryKey%2A>\) を使用する必要があります。  クエリは、\(結合ではなく\) 1 つのテーブルに対して実行されるか、<xref:System.Linq.Queryable.Distinct%2A>、<xref:System.Linq.Queryable.Except%2A>、<xref:System.Linq.Queryable.Intersect%2A>、または <xref:System.Linq.Queryable.Union%2A> 操作である必要があります。さらに、クエリに <xref:System.Linq.Queryable.Concat%2A> 操作を含めることはできません。  詳細については、「[Standard Query Operator Translation](../../../../../../docs/framework/data/adonet/sql/linq/standard-query-operator-translation.md)」の「SQL Server 2000 のサポート」を参照してください。  
+  
+ この要件は [!INCLUDE[sqprsqlong](../../../../../../includes/sqprsqlong-md.md)] には適用されません。  
+  
+## GroupBy InvalidOperationException  
+ この例外は、たとえば `group x by (Phone==@phone)` のように、`boolean` 式でグループ分けする <xref:System.Linq.Enumerable.GroupBy%2A> クエリ内の列値が null である場合にスローされます。  式が `boolean` であるため、キーは `nullable` `boolean` ではなく、`boolean` と推論されます。  変換された比較で null が生成される場合、`nullable` `boolean` を `boolean` に割り当てようとして、例外がスローされます。  
+  
+ この状態を回避する \(null を false と扱う\) には、次のような手法を使用してください。  
+  
+ `GroupBy="(Phone != null) && (Phone=@Phone)"`  
+  
+## OnCreated\(\) 部分メソッド  
+ オブジェクト コンストラクターが呼び出されるたびに、生成されたメソッド `OnCreated()` が呼び出されます。これは、元の値をコピーするために [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] がコンストラクターを呼び出す場合にも当てはまります。  独自の部分クラスに `OnCreated()` メソッドを実装する場合には、この動作を考慮に入れてください。  
+  
+## 参照  
+ [Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)   
+ [Frequently Asked Questions](../../../../../../docs/framework/data/adonet/sql/linq/frequently-asked-questions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/typical-steps-for-using-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/typical-steps-for-using-linq-to-sql.md
new file mode 100644
index 00000000000..fded9e0a7c7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/typical-steps-for-using-linq-to-sql.md
@@ -0,0 +1,94 @@
+---
+title: "Typical Steps for Using LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a88bd51-bd74-48f7-a9b1-f650e8d55a3e
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Typical Steps for Using LINQ to SQL
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションを実装するには、このトピックで説明する手順に従います。  多くの手順は省略できます。  既定の状態でオブジェクト モデルを使用することもできます。  
+  
+ [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してオブジェクト モデルを作成し、クエリのコーディングを開始すると、非常に簡単です。  
+  
+## オブジェクト モデルの作成  
+ 最初に、既存のリレーショナル データベースのメタデータからオブジェクト モデルを作成します。  オブジェクト モデルは、開発者のプログラミング言語に従ってデータベースを表します。  詳細については、「[The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)」を参照してください。  
+  
+### 1.モデルを作成するツールを選択します。  
+ モデルを作成するツールとして、3 つのツールを使用できます。  
+  
+-   [!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]  
+  
+     このデザイナーは、既存のデータベースからモデルを作成する多機能なユーザー インターフェイスを備えています。  このツールは [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] IDE の一部であり、小規模または中規模のデータベースに最適です。  
+  
+-   SQLMetal コード生成ツール  
+  
+     このコマンド ライン ユーティリティは、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]と多少異なるオプション セットを備えています。  このツールは、大規模なデータベースのモデル化に適しています。  詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+-   コード エディター  
+  
+     [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] コード エディターまたは他のエディターを使用して、独自のコードを作成できます。  既存のデータベースがあり、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]または SQLMetal ツールを使用できる場合は、この方法はエラーを発生する可能性が高いため、その使用はお勧めできません。  ただし、コード エディターは、他のツールを使用して既に生成されたコードを調整または変更する場合に役立ちます。  詳細については、「[How to: Customize Entity Classes by Using the Code Editor](../../../../../../docs/framework/data/adonet/sql/linq/how-to-customize-entity-classes-by-using-the-code-editor.md)」を参照してください。  
+  
+### 2.生成するコードの種類を選択します。  
+  
+-   属性ベースの対応付け用の C\# または [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] ソース コード。  
+  
+     このコード ファイルを、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] プロジェクトに含めます。詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」を参照してください。  
+  
+-   外部マッピング用の XML ファイル。  
+  
+     この方法を使用すると、アプリケーション コードとは別にマッピング メタデータを保持できます。  詳細については、「[External Mapping](../../../../../../docs/framework/data/adonet/sql/linq/external-mapping.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]は、外部マッピング ファイルの生成をサポートしていません。  SQLMetal ツールを使用してこの機能を実装する必要があります。  
+  
+-   最終コード ファイルを生成する前に変更できる DBML ファイル。  
+  
+     これは高度な機能です。  
+  
+### 3.コード ファイルを調整して、アプリケーションのニーズを反映します。  
+ この目的で、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]またはコード エディターを使用できます。  
+  
+## オブジェクト モデルの使用  
+ 2 層シナリオでの開発者とデータの関係を次の図に示します。  その他のシナリオについては、「[N\-Tier and Remote Applications with LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/n-tier-and-remote-applications-with-linq-to-sql.md)」を参照してください。  
+  
+ ![DLinqObjectModel](../../../../../../docs/framework/data/adonet/sql/linq/media/dlinqobjectmodel.png "DLinqObjectModel")  
+  
+ オブジェクト モデルが完成したので、そのモデル内で情報要求を記述し、データを操作します。  オブジェクト モデルのオブジェクトとプロパティを使用し、データベースの行と列は使用しません。  データベースを直接操作することはありません。  
+  
+ [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に対して、記述したクエリの実行、または操作したデータに対する `SubmitChanges()` の呼び出しを指示すると、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、データベースの言語でデータベースと通信します。  
+  
+ 作成したオブジェクト モデルの典型的な使用手順を次に示します。  
+  
+### 1.クエリを作成し、データベースから情報を取得します。  
+ 詳細については、「[Query Concepts](../../../../../../docs/framework/data/adonet/sql/linq/query-concepts.md)」および「[Query Examples](../../../../../../docs/framework/data/adonet/sql/linq/query-examples.md)」を参照してください。  
+  
+### 2.挿入、更新、および削除の既定の動作をオーバーライドします。  
+ この手順は省略できます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+  
+### 3.適切なオプションを設定し、同時実行の競合を検出およびレポートします。  
+ 同時実行の競合の処理について、モデルの既定値をそのまま使用することも、目的に合わせて変更することもできます。  詳細については、「[How to: Specify Which Members are Tested for Concurrency Conflicts](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-which-members-are-tested-for-concurrency-conflicts.md) および「[How to: Specify When Concurrency Exceptions are Thrown](../../../../../../docs/framework/data/adonet/sql/linq/how-to-specify-when-concurrency-exceptions-are-thrown.md)」を参照してください。  
+  
+### 4.継承階層を確立します。  
+ この手順は省略できます。  詳細については、「[Inheritance Support](../../../../../../docs/framework/data/adonet/sql/linq/inheritance-support.md)」を参照してください。  
+  
+### 5.適切なユーザー インターフェイスを提供します。  
+ この手順は省略でき、アプリケーションの使用方法によって異なります。  
+  
+### 6.アプリケーションをデバッグおよびテストします。  
+ 詳細については、「[Debugging Support](../../../../../../docs/framework/data/adonet/sql/linq/debugging-support.md)」を参照してください。  
+  
+## 参照  
+ [Getting Started](../../../../../../docs/framework/data/adonet/sql/linq/getting-started.md)   
+ [Creating the Object Model](../../../../../../docs/framework/data/adonet/sql/linq/creating-the-object-model.md)   
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/unsupported-functionality.md b/docs/framework/data/adonet/sql/linq/unsupported-functionality.md
new file mode 100644
index 00000000000..eb96ea4624c
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/unsupported-functionality.md
@@ -0,0 +1,37 @@
+---
+title: "Unsupported Functionality | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e480cfb5-697e-42c8-bed5-9264c945c4f9
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Unsupported Functionality
+LINQ to SQL では、次の SQL 機能は、既存の共通言語ランタイム \(CLR\) および .NET Framework の構成要素の変換からは公開できません。  
+  
+-   `STDDEV`  
+  
+-   `LIKE`  
+  
+     `LIKE` は直接変換によってサポートされませんが、同様の機能が <xref:System.Data.Linq.SqlClient.SqlMethods> クラスにあります。  詳細については、「[M:System.Data.Linq.SqlClient.SqlMethods.Like\(System.String,System.String](assetId:///M:System.Data.Linq.SqlClient.SqlMethods.Like(System.String,System.String?qualifyHint=True&autoUpgrade=True)」を参照してください。  
+  
+-   `DATEDIFF`  
+  
+     LINQ to SQL では、`DATEDIFF` のサポートが制限されています。  同様の機能が [SqlMethods](assetId:///T:System.Data.Linq.SqlClient.SqlMethods?qualifyHint=False&autoUpgrade=True) クラスにあります。  
+  
+-   `ROUND`  
+  
+     LINQ to SQL では、`ROUND` のサポートが制限されています。  詳細については、「[System.Math Methods](../Topic/System.Math%20Methods.md)」を参照してください。  
+  
+## 参照  
+ [Data Types and Functions](../Topic/Data%20Types%20and%20Functions.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/user-defined-functions.md b/docs/framework/data/adonet/sql/linq/user-defined-functions.md
new file mode 100644
index 00000000000..f1bdff40223
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/user-defined-functions.md
@@ -0,0 +1,40 @@
+---
+title: "User-Defined Functions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3304c9b2-5c7a-4a95-9d45-4f260dcb606e
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# User-Defined Functions
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] では、オブジェクト モデル内のメソッドを使用して、ユーザー定義関数を表します。  <xref:System.Data.Linq.Mapping.FunctionAttribute> 属性、および必要に応じて <xref:System.Data.Linq.Mapping.ParameterAttribute> 属性を適用することによって、メソッドを関数として指定します。  詳細については、「[The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)」を参照してください。  
+  
+ <xref:System.InvalidOperationException> を回避するため、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で作成するユーザー定義関数は次のいずれかの形式にする必要があります。  
+  
+-   正しいマッピング属性を持つメソッド呼び出しとしてラップされた関数。  詳細については、「[Attribute\-Based Mapping](../../../../../../docs/framework/data/adonet/sql/linq/attribute-based-mapping.md)」を参照してください。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] に固有の静的 SQL メソッド。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../../../includes/dnprdnshort-md.md)] メソッドによってサポートされる関数。  
+  
+ このセクションのトピックでは、自分でコードを作成する場合に、アプリケーション内でこれらのメソッドを記述および呼び出す方法について説明します。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、通常、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してユーザー定義関数を対応付けます。  
+  
+## このセクションの内容  
+ [How to: Use Scalar\-Valued User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-scalar-valued-user-defined-functions.md)  
+ スカラー値を返す関数を実装する方法を説明します。  
+  
+ [How to: Use Table\-Valued User\-Defined Functions](../../../../../../docs/framework/data/adonet/sql/linq/how-to-use-table-valued-user-defined-functions.md)  
+ テーブル値を返す関数を実装する方法を説明します。  
+  
+ [How to: Call User\-Defined Functions Inline](../../../../../../docs/framework/data/adonet/sql/linq/how-to-call-user-defined-functions-inline.md)  
+ 関数をインラインで呼び出す方法とインライン呼び出しの実行時の相違点について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-csharp.md b/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-csharp.md
new file mode 100644
index 00000000000..1990f5fa1f2
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-csharp.md
@@ -0,0 +1,172 @@
+---
+title: "Walkthrough: Manipulating Data (C#) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24adfbe0-0ad6-449f-997d-8808e0770d2e
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Walkthrough: Manipulating Data (C#)
+このチュートリアルでは、データベースに対してデータの追加、変更、および削除を行う、基本の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] シナリオ全体を示します。  顧客の追加、顧客名の変更、および注文の削除を行うため、サンプルの Northwind データベースのコピーを使用します。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual C\# 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ このチュートリアルの前提条件は次のとおりです。  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest6"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   Northwind サンプル データベース。  
+  
+     開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、northwnd.mdf ファイルを c:\\linqtest6 フォルダーにコピーします。  
+  
+-   Northwind データベースから生成された C\# コード ファイル。  
+  
+     このファイルを生成するには、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]または SQLMetal ツールを使用します。  このチュートリアルは、SQLMetal ツールを使用して次のコマンド ラインで作成されています。  
+  
+     **sqlmetal \/code:"c:\\linqtest6\\northwind.cs" \/language:csharp "C:\\linqtest6\\northwnd.mdf" \/pluralize**  
+  
+     詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] で [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+-   プロジェクトにデータベース コード ファイルを追加します。  
+  
+-   新しい顧客オブジェクトを作成します。  
+  
+-   顧客の連絡先名を変更します。  
+  
+-   注文を削除します。  
+  
+-   これらの変更を Northwind データベースに送信します。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] で、**\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual C\#\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[コンソール アプリケーション\]** をクリックします。  
+  
+4.  **\[プロジェクト名\]** ボックスに「LinqDataManipulationApp」と入力します。  
+  
+5.  **\[場所\]** ボックスで、プロジェクト ファイルを格納する場所を確認します。  
+  
+6.  **\[OK\]** をクリックします。  
+  
+## LINQ の参照とディレクティブを追加する  
+ このチュートリアルで使用するアセンブリは、既定ではプロジェクトにインストールされていない場合があります。  System.Data.Linq がプロジェクトの参照として表示されない場合は、次に説明する手順に従って追加してください。  
+  
+#### System.Data.Linq を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+2.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+3.  Program.cs の冒頭に、次のディレクティブを追加します。  
+  
+     [!code-csharp[DLinqWalk3CS#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#1)]  
+  
+## プロジェクトに Northwind コード ファイルを追加する  
+ これらの手順では、SQLMetal ツールを使用して Northwind サンプル データベースからコード ファイルを生成していることが前提です。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+#### プロジェクトに Northwind コード ファイルを追加するには  
+  
+1.  \[プロジェクト\] メニューの \[既存のアイテムの追加\] をクリックします。  
+  
+2.  **\[既存項目の追加\]** ダイアログ ボックスで c:\\linqtest6\\northwind.cs に移動し、**\[追加\]** をクリックします。  
+  
+     northwind.cs ファイルがプロジェクトに追加されます。  
+  
+## データベース接続の設定  
+ 最初に、データベースへの接続をテストします。  データベースの名前 Northwnd に i の文字が欠けていることに注意してください。  次の手順でエラーが生成された後で、northwind.cs ファイルを調べて、Northwind 部分クラスのスペルを確認します。  
+  
+#### データベース接続を設定してテストするには  
+  
+1.  Program クラスの `Main` メソッドに次のコードを入力するか、貼り付けます。  
+  
+     [!code-csharp[DLinqWalk3CS#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#2)]  
+  
+2.  この時点でアプリケーションをテストするには、F5 キーを押します。  
+  
+     **コンソール** ウィンドウが開きます。  
+  
+     **コンソール** ウィンドウで Enter キーを押すか、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] の **\[デバッグ\]** メニューの **\[デバッグの停止\]** をクリックして、アプリケーションを閉じます。  
+  
+## 新しいエンティティの作成  
+ 新しいエンティティを作成する手順は簡単です。  `new` キーワードを使用してオブジェクト \(`Customer` など\) を作成できます。  
+  
+ 以降のセクションでは、ローカル キャッシュのみに変更を加えます。  このチュートリアルの終盤で <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すまで、変更内容はデータベースに送信されません。  
+  
+#### 新しい Customer エンティティ オブジェクトを追加するには  
+  
+1.  次のコードを `Main` メソッド内の `Console.ReadLine();` の前に追加することで、新しい `Customer` を作成します。  
+  
+     [!code-csharp[DLinqWalk3CS#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#3)]  
+  
+2.  F5 キーを押してソリューションをデバッグします。  
+  
+3.  **コンソール** ウィンドウで Enter キーを押して、デバッグを停止し、このチュートリアルを続行します。  
+  
+## エンティティの更新  
+ 以降の手順では、`Customer` オブジェクトを取得し、そのプロパティの 1 つを変更します。  
+  
+#### 顧客の名前を変更するには  
+  
+-   `Console.ReadLine();` の前に次のコードを追加します。  
+  
+     [!code-csharp[DLinqWalk3CS#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#4)]  
+  
+## エンティティの削除  
+ 同じ顧客オブジェクトを使用して、最初の注文を削除できます。  
+  
+ 行間のリレーションシップを切断し、データベースから行を削除する方法を次のコードに示します。  オブジェクトを削除できることを確認するため、次のコードを `Console.ReadLine` の前に追加します。  
+  
+#### 行を削除するには  
+  
+-   `Console.ReadLine();` の直前に次のコードを追加します。  
+  
+     [!code-csharp[DLinqWalk3CS#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#5)]  
+  
+## 変更内容のデータベースへの送信  
+ 最後の手順は、オブジェクトの作成、更新、および削除を実際にデータベースに送信するために必要です。  この手順を行わないと、変更はローカルのみに留まり、クエリの結果には反映されません。  
+  
+#### データベースに変更内容を送信するには  
+  
+1.  `Console.ReadLine` の直前に次のコードを挿入します。  
+  
+     [!code-csharp[DLinqWalk3CS#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#6)]  
+  
+2.  変更内容の送信前と送信後の変化を示すために、次のコードを \(`SubmitChanges` の後に\) 挿入します。  
+  
+     [!code-csharp[DLinqWalk3CS#7](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk3CS/cs/Program.cs#7)]  
+  
+3.  F5 キーを押してソリューションをデバッグします。  
+  
+4.  **コンソール** ウィンドウで Enter キーを押してアプリケーションを終了します。  
+  
+> [!NOTE]
+>  変更内容を送信して新しい顧客を追加した後で、このソリューションを再度実行することはできません。  ソリューションを再度実行するには、追加する顧客の名前と顧客 ID を変更します。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-visual-basic.md b/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-visual-basic.md
new file mode 100644
index 00000000000..848ea164fd7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-visual-basic.md
@@ -0,0 +1,195 @@
+---
+title: "Walkthrough: Manipulating Data (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f6a54f6-ec33-452a-a37d-48122207bf14
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Walkthrough: Manipulating Data (Visual Basic)
+このチュートリアルでは、データベースに対してデータの追加、変更、および削除を行う、基本の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] シナリオ全体を示します。  顧客の追加、顧客名の変更、および注文の削除を行うため、サンプルの Northwind データベースのコピーを使用します。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual Basic 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ このチュートリアルの前提条件は次のとおりです。  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest2"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   Northwind サンプル データベース。  
+  
+     開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、northwnd.mdf ファイルを c:\\linqtest2 フォルダーにコピーします。  
+  
+-   Northwind データベースから生成された Visual Basic コード ファイル。  
+  
+     このファイルを生成するには、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]または SQLMetal ツールを使用します。  このチュートリアルは、SQLMetal ツールを使用して次のコマンド ラインで作成されています。  
+  
+     **sqlmetal \/code:"c:\\linqtest2\\northwind.vb" \/language:vb "C:\\linqtest2\\northwnd.mdf" \/pluralize**  
+  
+     詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] で [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+-   プロジェクトにデータベース コード ファイルを追加します。  
+  
+-   新しい顧客オブジェクトを作成します。  
+  
+-   顧客の連絡先名を変更します。  
+  
+-   注文を削除します。  
+  
+-   これらの変更を Northwind データベースに送信します。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] の **\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual Basic\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[コンソール アプリケーション\]** をクリックします。  
+  
+4.  **\[プロジェクト名\]** ボックスに「LinqDataManipulationApp」と入力します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+## LINQ の参照とディレクティブを追加する  
+ このチュートリアルで使用するアセンブリは、既定ではプロジェクトにインストールされていない場合があります。  `System.Data.Linq` がプロジェクトの参照 \(**ソリューション エクスプローラー**で **\[すべてのファイルを表示\]** をクリックし、**\[参照設定\]** ノードを展開\) に表示されていない場合は、以下の手順に従って追加します。  
+  
+#### System.Data.Linq を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+2.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+3.  コード エディターで、**Module1** の上に次のディレクティブを追加します。  
+  
+     [!code-vb[DLinqWalk3VB#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#1)]  
+  
+## プロジェクトに Northwind コード ファイルを追加する  
+ これらの手順では、SQLMetal ツールを使用して Northwind サンプル データベースからコード ファイルを生成していることが前提です。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+#### プロジェクトに Northwind コード ファイルを追加するには  
+  
+1.  \[プロジェクト\] メニューの \[既存のアイテムの追加\] をクリックします。  
+  
+2.  **\[既存項目の追加\]** ダイアログ ボックスで c:\\linqtest2\\northwind.vb に移動し、**\[追加\]** をクリックします。  
+  
+     プロジェクトに northwind.vb ファイルが追加されます。  
+  
+## データベース接続の設定  
+ 最初に、データベースへの接続をテストします。  データベースの名前 Northwnd に i の文字が欠けていることに注意してください。  次の手順でエラーが生成された後で、northwind.vb ファイルを調べて、Northwind 部分クラスのスペルを確認します。  
+  
+#### データベース接続を設定してテストするには  
+  
+1.  `Sub Main` に次のコードを入力するか、貼り付けます。  
+  
+     [!code-vb[DLinqWalk3VB#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#2)]  
+  
+2.  この時点でアプリケーションをテストするには、F5 キーを押します。  
+  
+     **コンソール** ウィンドウが開きます。  
+  
+     **コンソール** ウィンドウで Enter キーを押すか、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] **\[デバッグ\]** メニューの **\[デバッグの停止\]** をクリックして、アプリケーションを閉じます。  
+  
+## 新しいエンティティの作成  
+ 新しいエンティティを作成する手順は簡単です。  `New` キーワードを使用してオブジェクト \(`Customer` など\) を作成できます。  
+  
+ 以降のセクションでは、ローカル キャッシュのみに変更を加えます。  このチュートリアルの終盤で <xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出すまで、変更内容はデータベースに送信されません。  
+  
+#### 新しい Customer エンティティ オブジェクトを追加するには  
+  
+1.  次のコードを `Sub Main` 内の `Console.ReadLine` の前に追加することで、新しい `Customer` を作成します。  
+  
+     [!code-vb[DLinqWalk3VB#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#3)]  
+  
+2.  F5 キーを押してソリューションをデバッグします。  
+  
+     結果は、以下のようにコンソール ウィンドウに表示されます。  
+  
+     `Customers matching CA before insert:`  
+  
+     `Customer ID: CACTU`  
+  
+     `Customer ID: RICAR`  
+  
+     新しい行は結果に表示されません。  新しいデータは、まだデータベースに送信されていません。  
+  
+3.  **コンソール** ウィンドウで Enter キーを押して、デバッグを停止します。  
+  
+## エンティティの更新  
+ 以降の手順では、`Customer` オブジェクトを取得し、そのプロパティの 1 つを変更します。  
+  
+#### 顧客の名前を変更するには  
+  
+-   `Console.ReadLine()` の前に次のコードを追加します。  
+  
+     [!code-vb[DLinqWalk3VB#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#4)]  
+  
+## エンティティの削除  
+ 同じ顧客オブジェクトを使用して、最初の注文を削除できます。  
+  
+ 行間のリレーションシップを切断し、データベースから行を削除する方法を次のコードに示します。  
+  
+#### 行を削除するには  
+  
+-   `Console.ReadLine()` の直前に次のコードを追加します。  
+  
+     [!code-vb[DLinqWalk3VB#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#5)]  
+  
+## 変更内容のデータベースへの送信  
+ 最後の手順は、オブジェクトの作成、更新、および削除を実際にデータベースに送信するために必要です。  この手順を行わないと、変更はローカルのみに留まり、クエリの結果には反映されません。  
+  
+#### データベースに変更内容を送信するには  
+  
+1.  `Console.ReadLine` の直前に次のコードを挿入します。  
+  
+     [!code-vb[DLinqWalk3VB#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#6)]  
+  
+2.  変更内容の送信前と送信後の変化を示すために、次のコードを \(`SubmitChanges` の後に\) 挿入します。  
+  
+     [!code-vb[DLinqWalk3VB#7](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk3VB/vb/Module1.vb#7)]  
+  
+3.  F5 キーを押してソリューションをデバッグします。  
+  
+     次のようにコンソール ウィンドウが表示されます。  
+  
+    ```  
+    Customers matching CA before update:  
+    Customer ID: CACTU  
+    Customer ID: RICAR  
+  
+    The Order Detail to be deleted is: OrderID = 10643  
+  
+    Customers matching CA after update:  
+    Customer ID: A3VCA  
+    Customer ID: CACTU  
+    Customer ID: RICAR  
+    ```  
+  
+4.  **コンソール** ウィンドウで Enter キーを押して、デバッグを停止します。  
+  
+> [!NOTE]
+>  変更内容を送信して新しい顧客を追加した後で、このソリューションを再度実行することはできません。同じ顧客を再度追加できないためです。  ソリューションを再度実行するには、追加する顧客 ID の値を変更します。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-csharp.md b/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-csharp.md
new file mode 100644
index 00000000000..644ec8bc629
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-csharp.md
@@ -0,0 +1,99 @@
+---
+title: "Walkthrough: Querying Across Relationships (C#) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 552abeb1-18f2-4e93-a9c6-ef7b2db30c32
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Walkthrough: Querying Across Relationships (C#)
+このチュートリアルでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の*関連付け*を使用してデータベース内の外部キー リレーションシップを表現する方法について説明します。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual C\# 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ 「[Walkthrough: Simple Object Model and Query \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-csharp.md)」を終了している必要があります。  このチュートリアルは前のチュートリアルに基づいて作成されており、c:\\linqtest5 に northwnd.mdf ファイルがあることが前提です。  
+  
+## 概要  
+ このチュートリアルは、主に次の 3 つの手順で構成されています。  
+  
+-   エンティティ クラスを追加して、Northwind サンプル データベース内の Orders テーブルを表します。  
+  
+-   `Customer` クラスに注釈を付けて、`Customer` クラスと `Order` クラス間のリレーションシップを強化します。  
+  
+-   クエリを作成および実行して、`Customer` クラスによる `Order` 情報の取得をテストします。  
+  
+## テーブル間のリレーションシップを指定する  
+ `Customer` クラス定義の後に、次のコードから成る `Order` エンティティ クラス定義を作成します。これは、`Order.Customer` が外部キーとして `Customer.CustomerID` に関係することを示しています。  
+  
+#### Order エンティティ クラスを追加するには  
+  
+-   `Customer` クラスの後に次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk2CS#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk2CS/cs/Program.cs#1)]  
+  
+## Customer クラスに注釈を付ける  
+ ここでは、`Customer` クラスに注釈を付けて、`Order` クラスとのリレーションシップを指定します。  いずれかの方向のリレーションシップが定義されていればリンクを作成できるため、この注釈の追加は必ずしも必要ではありません。  しかし、この注釈を追加することで、どちらの方向でも簡単にオブジェクトを移動できます。  
+  
+#### Customer クラスに注釈を付けるには  
+  
+-   `Customer` クラスに次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk2CS#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk2CS/cs/Program.cs#2)]  
+  
+## Customer\-Order リレーションシップ間のクエリを作成および実行する  
+ `Customer` オブジェクトから `Order` オブジェクトに、またはその逆の順序で、直接アクセスできます。  Customer と Order の間に、明示的な*結合*は必要ありません。  
+  
+#### Customer オブジェクトを使用して Order オブジェクトにアクセスするには  
+  
+1.  `Main` メソッドに次のコードを入力または貼り付けることによって、メソッドを変更します。  
+  
+     [!code-csharp[DLinqWalk2CS#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk2CS/cs/Program.cs#3)]  
+  
+2.  F5 キーを押して、アプリケーションをデバッグします。  
+  
+    > [!NOTE]
+    >  `db.Log = Console.Out;` をコメント アウトすることによって、コンソール ウィンドウ内の SQL コードを除去できます。  
+  
+3.  コンソール ウィンドウで Enter キーを押して、デバッグを停止します。  
+  
+## データベースの厳密に型指定されたビューを作成する  
+ データベースの厳密に型指定されたビューを使用すると、操作が非常に簡単になります。  <xref:System.Data.Linq.DataContext> オブジェクトを厳密に型指定することによって、<xref:System.Data.Linq.DataContext.GetTable%2A> を呼び出す必要がありません。  厳密に型指定された <xref:System.Data.Linq.DataContext> オブジェクトを使用する場合は、すべてのクエリで、厳密に型指定されたテーブルを使用できます。  
+  
+ 次の手順では、データベース内の Customers テーブルに対応する厳密に型指定されたテーブルとして、`Customers` を作成します。  
+  
+#### DataContext オブジェクトを厳密に型指定するには  
+  
+1.  `Customer` クラス宣言の上に次のコードを追加します。  
+  
+     [!code-csharp[DLinqWalk2CS#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk2CS/cs/Program.cs#4)]  
+  
+2.  `Main` メソッドを次のように変更し、厳密に型指定された <xref:System.Data.Linq.DataContext> を使用するようにします。  
+  
+     [!code-csharp[DLinqWalk2CS#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk2CS/cs/Program.cs#5)]  
+  
+3.  F5 キーを押して、アプリケーションをデバッグします。  
+  
+     コンソール ウィンドウの出力は次のとおりです。  
+  
+     `ID=WHITC`  
+  
+4.  コンソール ウィンドウで Enter キーを押して、デバッグを停止します。  
+  
+## 次の手順  
+ 次のチュートリアル \([Walkthrough: Manipulating Data \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-csharp.md)\) では、データの操作方法について説明します。  そのチュートリアルを実行するのに、既に終了したこのシリーズの 2 つのチュートリアルを保存する必要はありません。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-visual-basic.md b/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-visual-basic.md
new file mode 100644
index 00000000000..e28bd8e8209
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-visual-basic.md
@@ -0,0 +1,100 @@
+---
+title: "Walkthrough: Querying Across Relationships (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7da43e3-769f-4e07-bcd6-552b8bde66f4
+caps.latest.revision: 2
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 2
+---
+# Walkthrough: Querying Across Relationships (Visual Basic)
+このチュートリアルでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の*関連付け*を使用してデータベース内の外部キー リレーションシップを表現する方法について説明します。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual Basic 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ 「[Walkthrough: Simple Object Model and Query \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-visual-basic.md)」を終了している必要があります。  このチュートリアルは前のチュートリアルに基づいて作成されており、c:\\linqtest に northwnd.mdf ファイルがあることが前提です。  
+  
+## 概要  
+ このチュートリアルは、主に次の 3 つの手順で構成されています。  
+  
+-   エンティティ クラスを追加して、Northwind サンプル データベース内の Orders テーブルを表します。  
+  
+-   `Customer` クラスに注釈を付けて、`Customer` クラスと `Order` クラス間のリレーションシップを強化します。  
+  
+-   クエリを作成および実行して、`Customer` クラスによる `Order` 情報の取得のプロセスをテストします。  
+  
+## テーブル間のリレーションシップを指定する  
+ `Customer` クラス定義の後に、次のコードから成る `Order` エンティティ クラス定義を作成します。これは、`Orders.Customer` が外部キーとして `Customers.CustomerID` に関係することを示しています。  
+  
+#### Order エンティティ クラスを追加するには  
+  
+-   `Customer` クラスの後に次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk2VB#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk2VB/vb/Module1.vb#1)]  
+  
+## Customer クラスに注釈を付ける  
+ ここでは、`Customer` クラスに注釈を付けて、`Order` クラスとのリレーションシップを指定します。  いずれかの方向のリレーションシップが定義されていればリンクを作成できるため、この注釈の追加は必ずしも必要ではありません。  しかし、この注釈を追加することで、どちらの方向でも簡単にオブジェクトを移動できます。  
+  
+#### Customer クラスに注釈を付けるには  
+  
+-   `Customer` クラスに次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk2VB#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk2VB/vb/Module1.vb#2)]  
+  
+## Customer\-Order リレーションシップ間のクエリを作成および実行する  
+ `Customer` オブジェクトから `Order` オブジェクトに、またはその逆の順序で、直接アクセスできます。  Customer と Order の間に、明示的な*結合*は必要ありません。  
+  
+#### Customer オブジェクトを使用して Order オブジェクトにアクセスするには  
+  
+1.  `Sub Main` メソッドに次のコードを入力または貼り付けることによって、メソッドを変更します。  
+  
+     [!code-vb[DLinqWalk2VB#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk2VB/vb/Module1.vb#3)]  
+  
+2.  F5 キーを押して、アプリケーションをデバッグします。  
+  
+     2 つの名前がメッセージ ボックスに表示され、生成された SQL コードがコンソール ウィンドウに表示されます。  
+  
+3.  メッセージ ボックスを閉じて、デバッグを停止します。  
+  
+## データベースの厳密に型指定されたビューを作成する  
+ データベースの厳密に型指定されたビューを使用すると、操作が非常に簡単になります。  <xref:System.Data.Linq.DataContext> オブジェクトを厳密に型指定することによって、<xref:System.Data.Linq.DataContext.GetTable%2A> を呼び出す必要がありません。  厳密に型指定された <xref:System.Data.Linq.DataContext> オブジェクトを使用する場合は、すべてのクエリで、厳密に型指定されたテーブルを使用できます。  
+  
+ 次の手順では、データベース内の Customers テーブルに対応する厳密に型指定されたテーブルとして、`Customers` を作成します。  
+  
+#### DataContext オブジェクトを厳密に型指定するには  
+  
+1.  `Customer` クラス宣言の上に次のコードを追加します。  
+  
+     [!code-vb[DLinqWalk2VB#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk2VB/vb/Module1.vb#4)]  
+  
+2.  `Sub Main` を次のように変更し、厳密に型指定された <xref:System.Data.Linq.DataContext> を使用するようにします。  
+  
+     [!code-vb[DLinqWalk2VB#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk2VB/vb/Module1.vb#5)]  
+  
+3.  F5 キーを押して、アプリケーションをデバッグします。  
+  
+     コンソール ウィンドウの出力は次のとおりです。  
+  
+     `ID=WHITC`  
+  
+4.  コンソール ウィンドウで Enter キーを押してアプリケーションを終了します。  
+  
+5.  このアプリケーションを保存するには、**\[ファイル\]** メニューの **\[すべてを保存\]** をクリックします。  
+  
+## 次の手順  
+ 次のチュートリアル \([Walkthrough: Manipulating Data \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-manipulating-data-visual-basic.md)\) では、データの操作方法について説明します。  そのチュートリアルを実行するのに、既に終了したこのシリーズの 2 つのチュートリアルを保存する必要はありません。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-csharp.md b/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-csharp.md
new file mode 100644
index 00000000000..97e0e879087
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-csharp.md
@@ -0,0 +1,165 @@
+---
+title: "Walkthrough: Simple Object Model and Query (C#) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 419961cc-92d6-45f5-ae8a-d485bdde3a37
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Walkthrough: Simple Object Model and Query (C#)
+このチュートリアルでは、複雑さを抑えた、基本的な [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] のエンドツーエンドのシナリオを示します。サンプルの Northwind データベースにある Customers テーブルのモデル化を行うエンティティ クラスを作成します。  次に、住所がロンドンの顧客を表示するための簡単なクエリを作成します。  
+  
+ このチュートリアルでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の考え方を示すために、コード中心の方法をあえて使用しています。  通常は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してオブジェクト モデルを作成できます。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual C\# 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest5"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   このチュートリアルには、Northwind サンプル データベースが必要です。  開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、ファイルを c:\\linqtest5 フォルダーにコピーします。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを作成します。  
+  
+-   データベース テーブルにクラスを割り当てます。  
+  
+-   クラスに対し、データベース列を表すプロパティを指定します。  
+  
+-   Northwind データベースへの接続を指定します。  
+  
+-   データベースに対して実行する簡単なクエリを作成します。  
+  
+-   クエリを実行して結果を観察する。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] で、**\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual C\#\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[コンソール アプリケーション\]** をクリックします。  
+  
+4.  **\[プロジェクト名\]** ボックスに「LinqConsoleApp」と入力します。  
+  
+5.  **\[場所\]** ボックスで、プロジェクト ファイルを格納する場所を確認します。  
+  
+6.  **\[OK\]** をクリックします。  
+  
+## LINQ の参照とディレクティブを追加する  
+ このチュートリアルで使用するアセンブリは、既定ではプロジェクトにインストールされていない場合があります。  System.Data.Linq がプロジェクトの参照 \(**ソリューション エクスプローラー**で **\[参照設定\]** ノードを展開\) に表示されていない場合は、以下の手順に従って追加します。  
+  
+#### System.Data.Linq を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+2.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+3.  **Program.cs** の冒頭に、次のディレクティブを追加します。  
+  
+     [!code-csharp[DLinqWalk1CS#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1CS/cs/Program.cs#1)]  
+  
+## データベース テーブルにクラスを対応付ける  
+ この手順では、クラスを作成して、データベース テーブルに対応付けます。  このようなクラスのことを*エンティティ クラス*と呼びます。  対応付けは、<xref:System.Data.Linq.Mapping.TableAttribute> 属性を追加するだけで完了します。  <xref:System.Data.Linq.Mapping.TableAttribute.Name%2A> プロパティを使用して、データベースのテーブルの名前を指定します。  
+  
+#### エンティティ クラスを作成し、データベース テーブルに対応付けるには  
+  
+-   Program.cs の `Program` クラス宣言の直前に次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk1CS#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1CS/cs/Program.cs#2)]  
+  
+## データベース列を表すプロパティをクラスに追加する  
+ この手順では、いくつかのタスクを実行します。  
+  
+-   <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性を使用して、エンティティ クラスの `CustomerID` プロパティおよび `City` プロパティを、データベース テーブルの列を表すものとして指定します。  
+  
+-   `CustomerID` プロパティを、データベースの主キー列を表すものとして指定します。  
+  
+-   プライベートでの格納用として `_CustomerID` フィールドおよび `_City` フィールドを指定します。  これで、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、ビジネス ロジックを含む場合があるパブリック アクセサーを使用せずに、値を直接格納および取得できます。  
+  
+#### 2 つのデータベース列の特性を指定するには  
+  
+-   Program.cs の `Customer` クラスの中かっこ内に次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk1CS#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1CS/cs/Program.cs#3)]  
+  
+## Northwind データベースへの接続を指定する  
+ この手順では、<xref:System.Data.Linq.DataContext> オブジェクトを使用して、コードで作成したデータ構造とデータベース本体との間の接続を確立します。  データベースからのオブジェクトの取得や、変更内容の送信では、<xref:System.Data.Linq.DataContext> を仲介役として使用します。  
+  
+ また、データベースの Customers テーブルに対するクエリ用として、型指定された論理的なテーブルの役割を果たす `Table<Customer>` を宣言します。  これらのクエリの作成と実行は後の手順で行います。  
+  
+#### データベース接続を指定するには  
+  
+-   `Main` メソッドに次のコードを入力または貼り付けます。  
+  
+     `northwnd.mdf` ファイルは、linqtest5 フォルダーにあるものとします。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+     [!code-csharp[DLinqWalk1CS#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1CS/cs/Program.cs#4)]  
+  
+## 簡単なクエリの作成  
+ この手順では、データベースの Customers テーブルから、住所が London の顧客を検索するクエリを作成します。  この手順で作成するクエリ コードは、クエリを指定するだけです。  実行は行いません。  このような方法を*遅延実行*といいます。  詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+ また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が生成した SQL コマンドをログに出力します。  <xref:System.Data.Linq.DataContext.Log%2A> を使用したこのログ機能は、デバッグに有効で、データベースに送信されたコマンドが目的のクエリを正確に表しているかどうかを確認するのに役立ちます。  
+  
+#### 簡単なクエリを作成するには  
+  
+-   `Main` メソッドの `Table<Customer>` 宣言の後に次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk1ACS#5](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1ACS/cs/Program.cs#5)]  
+  
+## クエリの実行  
+ この手順では、実際にクエリを実行します。  ここまでの手順で作成したクエリ式は、結果が必要になるまでは評価されません。  `foreach` の反復処理を開始した時点で、データベースに対して SQL コマンドが実行され、オブジェクトが実体化されます。  
+  
+#### クエリを実行するには  
+  
+1.  `Main` メソッドの末尾 \(クエリ指定の後\) に次のコードを入力または貼り付けます。  
+  
+     [!code-csharp[DLinqWalk1ACS#6](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk1ACS/cs/Program.cs#6)]  
+  
+2.  F5 キーを押してアプリケーションをデバッグします。  
+  
+    > [!NOTE]
+    >  アプリケーションで実行時エラーが発生した場合は、「[Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)」のトラブルシューティングのセクションを参照してください。  
+  
+     クエリの結果は、以下のようにコンソール ウィンドウに表示されます。  
+  
+     `ID=AROUT, City=London`  
+  
+     `ID=BSBEV, City=London`  
+  
+     `ID=CONSH, City=London`  
+  
+     `ID=EASTC, City=London`  
+  
+     `ID=NORTS, City=London`  
+  
+     `ID=SEVES, City=London`  
+  
+3.  コンソール ウィンドウで Enter キーを押してアプリケーションを終了します。  
+  
+## 次の手順  
+ 「[Walkthrough: Querying Across Relationships \(C\#\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-csharp.md)」トピックは、このチュートリアルの終わりから続行します。  「リレーションシップ間でクエリを実行する」のチュートリアルでは、リレーショナル データベースの[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]結合と同じように、複数のテーブルにまたがったクエリを  *で行う方法を説明します。*  
+  
+ 「リレーションシップ間でクエリを実行する」のチュートリアルに進む場合は、必要条件として、ここで完了したチュートリアルのソリューションを保存しておく必要があります。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-visual-basic.md b/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-visual-basic.md
new file mode 100644
index 00000000000..875154ca295
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-simple-object-model-and-query-visual-basic.md
@@ -0,0 +1,161 @@
+---
+title: "Walkthrough: Simple Object Model and Query (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c878e457-f715-46e4-a136-ff14d6c86018
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# Walkthrough: Simple Object Model and Query (Visual Basic)
+このチュートリアルでは、複雑さを抑えた、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 全体の基本的なシナリオを示します。  サンプルの Northwind データベースにある Customers テーブルのモデル化を行うエンティティ クラスを作成します。  次に、住所がロンドンの顧客を表示するための簡単なクエリを作成します。  
+  
+ このチュートリアルでは、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] の考え方を示すために、コード中心の方法をあえて使用しています。  通常は、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]を使用してオブジェクト モデルを作成できます。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual Basic 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   このチュートリアルには、Northwind サンプル データベースが必要です。  開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、ファイルを c:\\linqtest フォルダーにコピーします。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを作成します。  
+  
+-   データベース テーブルにクラスを割り当てます。  
+  
+-   クラスに対し、データベース列を表すプロパティを指定します。  
+  
+-   Northwind データベースへの接続を指定します。  
+  
+-   データベースに対して実行する簡単なクエリを作成します。  
+  
+-   クエリを実行して結果を観察する。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual Basic\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[コンソール アプリケーション\]** をクリックします。  
+  
+4.  **\[プロジェクト名\]** ボックスに「LinqConsoleApp」と入力します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+## LINQ の参照とディレクティブを追加する  
+ このチュートリアルで使用するアセンブリは、既定ではプロジェクトにインストールされていない場合があります。  `System.Data.Linq` がプロジェクトの参照 \(**ソリューション エクスプローラー**で **\[すべてのファイルを表示\]** をクリックし、**\[参照設定\]** ノードを展開\) に表示されていない場合は、以下の手順に従って追加します。  
+  
+#### System.Data.Linq を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+2.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+3.  また、**\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、\[System.Windows.Forms\] までスクロールして、これをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     このチュートリアルで使用するメッセージ ボックスをサポートするアセンブリがプロジェクトに追加されます。  
+  
+4.  `Module1` の上に次のディレクティブを追加します。  
+  
+     [!code-vb[DLinqWalk1VB#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1VB/vb/Module1.vb#1)]  
+  
+## データベース テーブルにクラスを対応付ける  
+ この手順では、クラスを作成して、データベース テーブルに対応付けます。  このようなクラスのことを*エンティティ クラス*と呼びます。  対応付けは、<xref:System.Data.Linq.Mapping.TableAttribute> 属性を追加するだけで完了します。  <xref:System.Data.Linq.Mapping.TableAttribute.Name%2A> プロパティを使用して、データベースのテーブルの名前を指定します。  
+  
+#### エンティティ クラスを作成し、データベース テーブルに対応付けるには  
+  
+-   Module1.vb で、`Sub Main` の直前に次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk1VB#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1VB/vb/Module1.vb#2)]  
+  
+## データベース列を表すプロパティをクラスに追加する  
+ この手順では、いくつかのタスクを実行します。  
+  
+-   <xref:System.Data.Linq.Mapping.ColumnAttribute> 属性を使用して、エンティティ クラスの `CustomerID` プロパティおよび `City` プロパティを、データベース テーブルの列を表すものとして指定します。  
+  
+-   `CustomerID` プロパティを、データベースの主キー列を表すものとして指定します。  
+  
+-   プライベートでの格納用として `_CustomerID` フィールドおよび `_City` フィールドを指定します。  これで、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、ビジネス ロジックを含む場合があるパブリック アクセサーを使用せずに、値を直接格納および取得できます。  
+  
+#### 2 つのデータベース列の特性を指定するには  
+  
+-   Module1.vb で、`End Class` の直前に次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk1VB#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1VB/vb/Module1.vb#3)]  
+  
+## Northwind データベースへの接続を指定する  
+ この手順では、<xref:System.Data.Linq.DataContext> オブジェクトを使用して、コードで作成したデータ構造とデータベース本体との間の接続を確立します。  データベースからのオブジェクトの取得や、変更内容の送信では、<xref:System.Data.Linq.DataContext> を仲介役として使用します。  
+  
+ また、データベースの Customers テーブルに対するクエリ用として、型指定された論理的なテーブルの役割を果たす `Table(Of Customer)` を宣言します。  これらのクエリの作成と実行は後の手順で行います。  
+  
+#### データベース接続を指定するには  
+  
+-   `Sub Main` メソッドに次のコードを入力または貼り付けます。  
+  
+     `northwnd.mdf` ファイルは linqtest フォルダーに置かれているものとします。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+     [!code-vb[DLinqWalk1VB#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1VB/vb/Module1.vb#4)]  
+  
+## 簡単なクエリの作成  
+ この手順では、データベースの Customers テーブルから、住所が London の顧客を検索するクエリを作成します。  この手順で作成するクエリ コードは、クエリを指定するだけです。  実行は行いません。  このような方法を*遅延実行*といいます。  詳細については、「[Introduction to LINQ Queries \(C\#\)](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)」を参照してください。  
+  
+ また、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] が生成した SQL コマンドをログに出力します。  <xref:System.Data.Linq.DataContext.Log%2A> を使用したこのログ機能は、デバッグに有効で、データベースに送信されたコマンドが目的のクエリを正確に表しているかどうかを確認するのに役立ちます。  
+  
+#### 簡単なクエリを作成するには  
+  
+-   `Sub Main` メソッドの `Table(Of Customer)` 宣言の後に次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk1AVB#5](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1AVB/vb/Module1.vb#5)]  
+  
+## クエリの実行  
+ この手順では、実際にクエリを実行します。  ここまでの手順で作成したクエリ式は、結果が必要になるまでは評価されません。  `For Each` の反復処理を開始した時点で、データベースに対して SQL コマンドが実行され、オブジェクトが実体化されます。  
+  
+#### クエリを実行するには  
+  
+1.  `Sub Main` メソッドの末尾 \(クエリ指定の後\) に次のコードを入力または貼り付けます。  
+  
+     [!code-vb[DLinqWalk1AVB#6](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk1AVB/vb/Module1.vb#6)]  
+  
+2.  F5 キーを押してアプリケーションをデバッグします。  
+  
+    > [!NOTE]
+    >  アプリケーションで実行時エラーが発生した場合は、「[Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)」のトラブルシューティングのセクションを参照してください。  
+  
+     メッセージ ボックスには 6 人の顧客の一覧が表示されます。  コンソール ウィンドウには生成された SQL コードが表示されます。  
+  
+3.  **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+     アプリケーションが終了します。  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックします。  
+  
+     引き続き次のチュートリアルに進む場合は、このアプリケーションが必要になります。  
+  
+## 次の手順  
+ 「[Walkthrough: Querying Across Relationships \(Visual Basic\)](../../../../../../docs/framework/data/adonet/sql/linq/walkthrough-querying-across-relationships-visual-basic.md)」トピックは、このチュートリアルの終了位置から続行します。  「リレーションシップ間でクエリを実行する」のチュートリアルでは、リレーショナル データベースの[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)]結合と同じように、複数のテーブルにまたがったクエリを  *で行う方法を説明します。*  
+  
+ 「リレーションシップ間でクエリを実行する」のチュートリアルに進む場合は、必要条件として、ここで完了したチュートリアルのソリューションを保存しておく必要があります。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-csharp.md b/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-csharp.md
new file mode 100644
index 00000000000..036018a5dc5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-csharp.md
@@ -0,0 +1,199 @@
+---
+title: "Walkthrough: Using Only Stored Procedures (C#) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ecde4bf2-fa4d-4252-b5e4-96a46b9e097d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Walkthrough: Using Only Stored Procedures (C#)
+このチュートリアルでは、ストアド プロシージャを実行することでのみデータにアクセスする、基本的な [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] シナリオ全体を示します。  この方法は、データ ストアへのアクセス方法を制限する目的で、データベース管理者によってよく使用されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションでストアド プロシージャを使用して、既定の動作をオーバーライドすることもできます。これは、`Create`、`Update`、および `Delete` の各プロセスで特に役立ちます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+  
+ このチュートリアルでは、Northwind サンプル データベース内のストアド プロシージャにマップされた 2 つのメソッド \(CustOrdersDetail および CustOrderHist\) を使用します。  このマップは、SqlMetal コマンド ライン ツールを実行して C\# ファイルを生成したときに作成されます。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+ このチュートリアルは、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]には依存しません。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]を使用して、ストアド プロシージャの機能を実装することもできます。  「[LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)」を参照してください。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual C\# 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ このチュートリアルの前提条件は次のとおりです。  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest7"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   Northwind サンプル データベース。  
+  
+     開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、northwnd.mdf ファイルを c:\\linqtest7 フォルダーにコピーします。  
+  
+-   Northwind データベースから生成された C\# コード ファイル。  
+  
+     このチュートリアルは、SqlMetal ツールを使用して次のコマンド ラインで作成されています。  
+  
+     **sqlmetal \/code:"c:\\linqtest7\\northwind.cs" \/language:csharp "c:\\linqtest7\\northwnd.mdf" \/sprocs \/functions \/pluralize**  
+  
+     詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを設定します。  
+  
+-   プロジェクトに System.Data.Linq アセンブリを追加します。  
+  
+-   プロジェクトにデータベース コード ファイルを追加します。  
+  
+-   データベースへの接続を作成します。  
+  
+-   ユーザー インターフェイスを設定します。  
+  
+-   アプリケーションを実行およびテストします。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] で、**\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual C\#\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[Windows フォーム アプリケーション\]** をクリックします。  
+  
+4.  **\[名前\]** ボックスに、「SprocOnlyApp」と入力します。  
+  
+5.  **\[場所\]** ボックスで、プロジェクト ファイルを格納する場所を確認します。  
+  
+6.  **\[OK\]** をクリックします。  
+  
+     Windows フォーム デザイナーが開きます。  
+  
+## LINQ to SQL アセンブリ参照を追加する  
+ 標準の Windows フォーム アプリケーション テンプレートには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アセンブリは含まれていません。  次の手順に従って、アセンブリを自分で追加する必要があります。  
+  
+#### System.Data.Linq.dll を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+2.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+## プロジェクトに Northwind コード ファイルを追加する  
+ この手順では、事前に SqlMetal ツールを使用して、Northwind サンプル データベースからコード ファイルを生成していることが前提となります。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+#### プロジェクトに Northwind コード ファイルを追加するには  
+  
+1.  \[プロジェクト\] メニューの \[既存のアイテムの追加\] をクリックします。  
+  
+2.  **\[既存項目の追加\]** ダイアログ ボックスで、c:\\linqtest7\\northwind.cs に移動し、**\[追加\]** をクリックします。  
+  
+     northwind.cs ファイルがプロジェクトに追加されます。  
+  
+## データベース接続を作成する  
+ この手順では、Northwind サンプル データベースへの接続を定義します。  このチュートリアルでは、パスとして "c:\\linqtest7\\northwnd.mdf" を使用します。  
+  
+#### データベース接続を作成するには  
+  
+1.  **ソリューション エクスプローラー**で **\[Form1.cs\]** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `Form1` クラスに次のコードを入力します。  
+  
+     [!code-csharp[DLinqWalk4CS#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk4CS/cs/Form1.cs#1)]  
+  
+## ユーザー インターフェイスを設定する  
+ この手順では、ユーザーがストアド プロシージャを実行してデータベース内のデータにアクセスできるように、インターフェイスを設定します。  このチュートリアルで作成するアプリケーションでは、ユーザーがデータベース内のデータにアクセスできる手段は、アプリケーションに埋め込まれたストアド プロシージャを使用することだけです。  
+  
+#### ユーザー インターフェイスを設定するには  
+  
+1.  Windows フォーム デザイナー \(**\[Form1.cs\[デザイン\]\]**\) に戻ります。  
+  
+2.  **\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+     ツールボックスが表示されます。  
+  
+    > [!NOTE]
+    >  このセクションの残りの手順を実行する間、ツールボックスを開いたままにしておくには、**\[自動的に隠す\]** プッシュピンをクリックします。  
+  
+3.  ツールボックスから、2 つのボタン、2 つのテキスト ボックス、および 2 つのラベルを **Form1** にドラッグします。  
+  
+     図のようにコントロールを配置します。  コントロールを簡単に配置できるように、**Form1** のサイズを拡大します。  
+  
+4.  **\[label1\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+5.  **Text** プロパティを「**label1**」から「**Enter OrderID:**」に変更します。  
+  
+6.  **\[label2\]** についても同様に、**Text** プロパティを「**label2**」から「**Enter CustomerID:**」に変更します。  
+  
+7.  同様に、**\[button1\]** の **Text** プロパティを「**Order Details**」に変更します。  
+  
+8.  **\[button2\]** の **Text** プロパティを「**Order History**」に変更します。  
+  
+     すべてのテキストが表示されるように、ボタン コントロールの幅を広げます。  
+  
+#### ボタン クリックを処理するには  
+  
+1.  **Form1** の **\[Order Details\]** をダブルクリックして、コード エディターに button1 のイベント ハンドラーを表示します。  
+  
+2.  `button1` のハンドラーに次のコードを入力します。  
+  
+     [!code-csharp[DLinqWalk4CS#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk4CS/cs/Form1.cs#2)]  
+  
+3.  次に、**Form1** の **button2** をダブルクリックして、`button2` のハンドラーを表示します。  
+  
+4.  `button2` のハンドラーに次のコードを入力します。  
+  
+     [!code-csharp[DLinqWalk4CS#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqWalk4CS/cs/Form1.cs#3)]  
+  
+## アプリケーションのテスト  
+ 次に、アプリケーションをテストします。  データ ストアに対する操作は、2 つのストアド プロシージャで実行できる処理に制限されることに注意してください。  つまり、入力した orderID に含まれている製品を返す処理と、入力した CustomerID の注文製品の履歴を返す処理のみを実行できます。  
+  
+#### アプリケーションをテストするには  
+  
+1.  F5 キーを押してデバッグを開始します。  
+  
+     Form1 が表示されます。  
+  
+2.  **\[Enter OrderID\]** ボックスに「`10249`」と入力し、**\[Order Details\]** をクリックします。  
+  
+     注文 10249 に含まれている製品がメッセージ ボックスに表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+3.  **\[Enter CustomerID\]** ボックスに「`ALFKI`」と入力し、**\[Order History\]** をクリックします。  
+  
+     顧客 ALFKI の注文履歴がメッセージ ボックスに表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+4.  **\[Enter OrderID\]** ボックスに「`123`」と入力し、**\[Order Details\]** をクリックします。  
+  
+     "No results" というメッセージ ボックスが表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+5.  **\[デバッグ\]** メニューの **\[デバッグの停止\]** をクリックします。  
+  
+     デバッグ セッションが終了します。  
+  
+6.  操作が終了したら、**\[ファイル\]** メニューの **\[プロジェクトを閉じる\]** をクリックし、メッセージに従ってプロジェクトを保存します。  
+  
+## 次の手順  
+ いくつかの変更を加えることによって、このプロジェクトを強化できます。  たとえば、使用できるストアド プロシージャの一覧をリスト ボックスに表示し、実行するプロシージャをユーザーに選択させることができます。  レポートの出力をテキスト ファイルに送ることもできます。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)   
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-visual-basic.md b/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-visual-basic.md
new file mode 100644
index 00000000000..6a3cbe80d7e
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/walkthrough-using-only-stored-procedures-visual-basic.md
@@ -0,0 +1,201 @@
+---
+title: "Walkthrough: Using Only Stored Procedures (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a736a30-ba66-4adb-b87c-57d19476e862
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# Walkthrough: Using Only Stored Procedures (Visual Basic)
+このチュートリアルでは、ストアド プロシージャのみを使用してデータにアクセスする、基本の [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] シナリオ全体を示します。  この方法は、データ ストアへのアクセス方法を制限する目的で、データベース管理者によってよく使用されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アプリケーションでストアド プロシージャを使用して、既定の動作をオーバーライドすることもできます。これは、`Create`、`Update`、および `Delete` の各プロセスで特に役立ちます。  詳細については、「[Customizing Insert, Update, and Delete Operations](../../../../../../docs/framework/data/adonet/sql/linq/customizing-insert-update-and-delete-operations.md)」を参照してください。  
+  
+ このチュートリアルでは、Northwind サンプル データベース内のストアド プロシージャにマップされた 2 つのメソッド \(CustOrdersDetail および CustOrderHist\) を使用します。  SqlMetal コマンド ライン ツールを実行して [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] ファイルを生成すると、対応付けが発生します。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+ このチュートリアルは、[!INCLUDE[vs_ordesigner_long](../../../../../../includes/vs-ordesigner-long-md.md)]には依存しません。  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] を使用している開発者は、[!INCLUDE[vs_ordesigner_short](../../../../../../includes/vs-ordesigner-short-md.md)]を使用して、ストアド プロシージャの機能を実装することもできます。  「[LINQ to Visual Studio での SQL ツール](../Topic/LINQ%20to%20SQL%20Tools%20in%20Visual%20Studio2.md)」を参照してください。  
+  
+ [!INCLUDE[note_settings_general](../../../../../../includes/note-settings-general-md.md)]  
+  
+ このチュートリアルは、Visual Basic 開発設定を使用して記述されています。  
+  
+## 必須コンポーネント  
+ このチュートリアルの前提条件は次のとおりです。  
+  
+-   このチュートリアルでは、専用フォルダー \("c:\\linqtest3"\) を使用してファイルを保持します。  チュートリアルを開始する前に、このフォルダーを作成してください。  
+  
+-   Northwind サンプル データベース。  
+  
+     開発用コンピューターにこのデータベースがない場合は、Microsoft ダウンロード サイトからダウンロードします。  手順については、「[Downloading Sample Databases](../../../../../../docs/framework/data/adonet/sql/linq/downloading-sample-databases.md)」を参照してください。  データベースをダウンロードしたら、northwnd.mdf ファイルを c:\\linqtest3 フォルダーにコピーします。  
+  
+-   Northwind データベースから生成された [!INCLUDE[vbprvb](../../../../../../includes/vbprvb-md.md)] コード ファイル。  
+  
+     このチュートリアルは、SqlMetal ツールを使用して次のコマンド ラインで作成されています。  
+  
+     **sqlmetal \/code:"c:\\linqtest3\\northwind.vb" \/language:vb "c:\\linqtest3\\northwnd.mdf" \/sprocs \/functions \/pluralize**  
+  
+     詳細については、「[SqlMetal.exe \(コード生成ツール\)](../../../../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)」を参照してください。  
+  
+## 概要  
+ このチュートリアルは、主に次の 6 つの手順で構成されています。  
+  
+-   [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] で [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] ソリューションを設定します。  
+  
+-   プロジェクトに System.Data.Linq アセンブリを追加します。  
+  
+-   プロジェクトにデータベース コード ファイルを追加します。  
+  
+-   データベースへの接続を作成します。  
+  
+-   ユーザー インターフェイスを設定します。  
+  
+-   アプリケーションを実行およびテストします。  
+  
+## LINQ to SQL ソリューションを作成する  
+ 最初に、[!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] プロジェクトをビルドおよび実行するために必要な参照を含む [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] ソリューションを作成します。  
+  
+#### LINQ to SQL ソリューションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../../../includes/vs-current-short-md.md)] の **\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの **\[プロジェクトの種類\]** ペインで、**\[Visual Basic\]** を展開し、**\[Windows\]** をクリックします。  
+  
+3.  **\[テンプレート\]** ペインの **\[Windows フォーム アプリケーション\]** をクリックします。  
+  
+4.  **\[名前\]** ボックスに、「SprocOnlyApp」と入力します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+     Windows フォーム デザイナーが開きます。  
+  
+## LINQ to SQL アセンブリ参照を追加する  
+ 標準の Windows フォーム アプリケーション テンプレートには、[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] アセンブリは含まれていません。  次の手順に従って、アセンブリを自分で追加する必要があります。  
+  
+#### System.Data.Linq.dll を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[すべてのファイルを表示\]** をクリックします。  
+  
+2.  **ソリューション エクスプローラー**で、**\[参照設定\]** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+3.  **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** をクリックし、System.Data.Linq アセンブリをクリックします。次に、**\[OK\]** をクリックします。  
+  
+     アセンブリがプロジェクトに追加されます。  
+  
+## プロジェクトに Northwind コード ファイルを追加する  
+ この手順では、事前に SqlMetal ツールを使用して、Northwind サンプル データベースからコード ファイルを生成していることが前提となります。  詳細については、このチュートリアルの「前提条件」を参照してください。  
+  
+#### プロジェクトに Northwind コード ファイルを追加するには  
+  
+1.  \[プロジェクト\] メニューの \[既存のアイテムの追加\] をクリックします。  
+  
+2.  **\[既存項目の追加\]** ダイアログ ボックスで c:\\linqtest3\\northwind.vb ファイルに移動し、**\[追加\]** をクリックします。  
+  
+     プロジェクトに northwind.vb ファイルが追加されます。  
+  
+## データベース接続を作成する  
+ この手順では、Northwind サンプル データベースへの接続を定義します。  このチュートリアルでは、パスとして "c:\\linqtest3\\northwnd.mdf" を使用します。  
+  
+#### データベース接続を作成するには  
+  
+1.  **ソリューション エクスプローラー**で **\[Form1.vb\]** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+     コード エディターに `Class Form1` が表示されます。  
+  
+2.  `Form1` コード ブロックに次のコードを入力します。  
+  
+     [!code-vb[DLinqWalk4VB#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk4VB/vb/Form1.vb#1)]  
+  
+## ユーザー インターフェイスを設定する  
+ この手順では、ユーザーがストアド プロシージャを実行してデータベース内のデータにアクセスできるように、インターフェイスを作成します。  このチュートリアルで作成するアプリケーションでは、ユーザーはアプリケーションに埋め込まれているストアド プロシージャを使用してのみ、データベース内のデータにアクセスできます。  
+  
+#### ユーザー インターフェイスを設定するには  
+  
+1.  Windows フォーム デザイナーに戻ります \(**\[Form1.vb \[デザイン\]\]**\)。  
+  
+2.  **\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+     ツールボックスが表示されます。  
+  
+    > [!NOTE]
+    >  このセクションの残りの手順を実行する間、ツールボックスを開いたままにしておくには、**\[自動的に隠す\]** プッシュピンをクリックします。  
+  
+3.  ツールボックスから、2 つのボタン、2 つのテキスト ボックス、および 2 つのラベルを **Form1** にドラッグします。  
+  
+     図のようにコントロールを配置します。  コントロールを簡単に配置できるように、**Form1** のサイズを拡大します。  
+  
+4.  **\[Label1\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+5.  **Text** プロパティを **\[Label1\]** から **\[Enter OrderID:\]** に変更します。  
+  
+6.  **Label2** についても同様に、**Text** プロパティを **\[Label2\]** から **\[Enter CustomerID:\]** に変更します。  
+  
+7.  同様に、**Button1** の **Text** プロパティを **\[Order Details\]** に変更します。  
+  
+8.  **Button2** の **Text** プロパティを **\[Order History\]** に変更します。  
+  
+     すべてのテキストが表示されるように、ボタン コントロールの幅を広げます。  
+  
+#### ボタン クリックを処理するには  
+  
+1.  **\[Form1\]** の **\[Order Details\]** をダブルクリックして `Button1` イベント ハンドラーを作成し、コード エディターを開きます。  
+  
+2.  `Button1` のハンドラーに次のコードを入力します。  
+  
+     [!code-vb[DLinqWalk4VB#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk4VB/vb/Form1.vb#2)]  
+  
+3.  \[Form1\] の **\[Button2\]** をダブルクリックして `Button2` イベント ハンドラーを作成し、コード エディターを開きます。  
+  
+4.  `Button2` のハンドラーに次のコードを入力します。  
+  
+     [!code-vb[DLinqWalk4VB#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqWalk4VB/vb/Form1.vb#3)]  
+  
+## アプリケーションのテスト  
+ 次に、アプリケーションをテストします。  データ ストアに対する操作は、2 つのストアド プロシージャで実行できる処理に制限されることに注意してください。  つまり、入力した orderID に含まれている製品を返す処理と、入力した CustomerID の注文製品の履歴を返す処理のみを実行できます。  
+  
+#### アプリケーションをテストするには  
+  
+1.  F5 キーを押してデバッグを開始します。  
+  
+     Form1 が表示されます。  
+  
+2.  **\[Enter OrderID\]** ボックスに「10249」と入力し、**\[Order Details\]** をクリックします。  
+  
+     注文 10249 に含まれている製品がメッセージ ボックスに表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+3.  **\[Enter CustomerID\]** ボックスに「`ALFKI`」と入力し、**\[Order History\]** をクリックします。  
+  
+     メッセージ ボックスに、顧客 ALFKI の注文履歴が表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+4.  **\[Enter OrderID\]** ボックスに「`123`」と入力し、**\[Order Details\]** をクリックします。  
+  
+     メッセージ ボックスに "No results" が表示されます。  
+  
+     **\[OK\]** をクリックしてメッセージ ボックスを閉じます。  
+  
+5.  **\[デバッグ\]** メニューの **\[デバッグの停止\]** をクリックします。  
+  
+     デバッグ セッションが終了します。  
+  
+6.  操作が終了したら、**\[ファイル\]** メニューの **\[プロジェクトを閉じる\]** をクリックし、メッセージに従ってプロジェクトを保存します。  
+  
+## 次の手順  
+ いくつかの変更を加えることによって、このプロジェクトを強化できます。  たとえば、使用できるストアド プロシージャの一覧をリスト ボックスに表示し、実行するプロシージャをユーザーに選択させることができます。  レポートの出力をテキスト ファイルに送ることもできます。  
+  
+## 参照  
+ [Learning by Walkthroughs](../../../../../../docs/framework/data/adonet/sql/linq/learning-by-walkthroughs.md)   
+ [Stored Procedures](../../../../../../docs/framework/data/adonet/sql/linq/stored-procedures.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/linq/what-you-can-do-with-linq-to-sql.md b/docs/framework/data/adonet/sql/linq/what-you-can-do-with-linq-to-sql.md
new file mode 100644
index 00000000000..bc4059a29f6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/linq/what-you-can-do-with-linq-to-sql.md
@@ -0,0 +1,60 @@
+---
+title: "LINQ to SQL の主な機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 061d98b2-baa7-4336-8ad2-c14de8134d91
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# LINQ to SQL の主な機能
+[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は、SQL 開発者が期待するすべての主要な機能に対応しています。 情報の照会、テーブルへの情報の挿入、およびテーブルの情報の更新と削除を行うことができます。  
+  
+## 選択  
+ 選択 \(*射影*\) は、[!INCLUDE[vbteclinq](../../../../../../includes/vbteclinq-md.md)] クエリを任意のプログラミング言語で記述し、そのクエリを実行して結果を取得することにより実現されます。[!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] 自体は、必要なすべての操作を、使い慣れた SQL の操作に変換します。 詳細については、「[LINQ to SQL](../../../../../../docs/framework/data/adonet/sql/linq/index.md)」を参照してください。  
+  
+ 次の例では、ロンドン在住の顧客の会社名を取得し、コンソール ウィンドウに表示します。  
+  
+ [!code-csharp[DLinqGettingStarted#1](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqGettingStarted/cs/Program.cs#1)]
+ [!code-vb[DLinqGettingStarted#1](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqGettingStarted/vb/Module1.vb#1)]  
+  
+## 挿入  
+ SQL の `Insert` を実行するには、前もって作成したオブジェクト モデルにオブジェクトを追加し、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> の <xref:System.Data.Linq.DataContext> を呼び出します。  
+  
+ `Customers` を使って、新規の顧客の情報を <xref:System.Data.Linq.Table%601.InsertOnSubmit%2A> テーブルに追加する方法を次の例に示します。  
+  
+ [!code-csharp[DLinqGettingStarted#2](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqGettingStarted/cs/Program.cs#2)]
+ [!code-vb[DLinqGettingStarted#2](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqGettingStarted/vb/Module1.vb#2)]  
+  
+## Updating  
+ データベース エントリの `Update` \(更新\) を実行するには、目的の項目をまず取得し、それをオブジェクト モデル内で直接編集します。 オブジェクトを変更した後で、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> の <xref:System.Data.Linq.DataContext> を呼び出してデータベースを更新します。  
+  
+ ロンドン出身のすべての顧客を取得する例を次に示します。 その後で、市の名前を "London" から "London \- Metro" に変更します。 最後に、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出して、変更をデータベースに送信します。  
+  
+ [!code-csharp[DLinqGettingStarted#3](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqGettingStarted/cs/Program.cs#3)]
+ [!code-vb[DLinqGettingStarted#3](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqGettingStarted/vb/Module1.vb#3)]  
+  
+## 削除中  
+ 項目を `Delete` \(削除\) するには、項目を所属先のコレクションから削除してから、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> の <xref:System.Data.Linq.DataContext> を呼び出して、変更をコミットします。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbtecdlinq](../../../../../../includes/vbtecdlinq-md.md)] は連鎖削除操作を認識しません。 制約を持つテーブルの行を削除する場合は、「[How to: Delete Rows From the Database](../../../../../../docs/framework/data/adonet/sql/linq/how-to-delete-rows-from-the-database.md)」をご覧ください。  
+  
+ 次の例では、`CustomerID` が `98128` の顧客をデータベースから取得します。 次に、顧客の行が取得されたことを確認した後で、<xref:System.Data.Linq.Table%601.DeleteOnSubmit%2A> を呼び出して、このオブジェクトをコレクションから削除します。 最後に、<xref:System.Data.Linq.DataContext.SubmitChanges%2A> を呼び出して、削除をデータベースに転送します。  
+  
+ [!code-csharp[DLinqGettingStarted#4](../../../../../../samples/snippets/csharp/VS_Snippets_Data/DLinqGettingStarted/cs/Program.cs#4)]
+ [!code-vb[DLinqGettingStarted#4](../../../../../../samples/snippets/visualbasic/VS_Snippets_Data/DLinqGettingStarted/vb/Module1.vb#4)]  
+  
+## 参照  
+ [プログラミング ガイド](../../../../../../docs/framework/data/adonet/sql/linq/programming-guide.md)   
+ [The LINQ to SQL Object Model](../../../../../../docs/framework/data/adonet/sql/linq/the-linq-to-sql-object-model.md)   
+ [Getting Started](../../../../../../docs/framework/data/adonet/sql/linq/getting-started.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md b/docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md
new file mode 100644
index 00000000000..bff34c2db1d
--- /dev/null
+++ b/docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md
@@ -0,0 +1,74 @@
+---
+title: "SQL Server でのストアド プロシージャを使用したアクセス許可の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 08fa34e8-2ffa-470d-ba62-e511a5f8558e
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server でのストアド プロシージャを使用したアクセス許可の管理
+データベースを多層的に防御する 1 つの方法として、あらゆるデータ アクセスをストアド プロシージャまたはユーザー定義関数を使って実装することが考えられます。  テーブルなど、基になるオブジェクトに対する権限をすべて取り消すか拒否し、ストアド プロシージャに対して EXECUTE 権限を付与するようにします。  こうすることで、データやデータベース オブジェクトの周囲にセキュリティの境界を設けることができます。  
+  
+## ストアド プロシージャの利点  
+ ストアド プロシージャには、次の利点があります。  
+  
+-   データ ロジックとビジネス ルールがカプセル化されるため、ユーザーが、開発者およびデータベース管理者の想定外の方法でデータやオブジェクトにアクセスするのを防ぐことができます。  
+  
+-   すべてのユーザー入力を検証するパラメーター化されたストアド プロシージャを使用することで、SQL インジェクション攻撃を阻止できます。  動的 SQL を使用する場合は、必ずコマンドをパラメーター化するようにし、パラメーター値を直接クエリ文字列に追加することは避けてください。  
+  
+-   アドホック クエリおよびデータ変更を禁止できます。  悪意からまたは不注意によってデータが破壊されたり、サーバーやネットワークのパフォーマンスを損ねるようなクエリが実行されるのを防ぐことができます。  
+  
+-   エラーをクライアント アプリケーションに直接渡すことなく、プロシージャ コード内で処理できます。  これにより、返されたエラー メッセージがプローブ攻撃に利用されるのを防ぐことができます。  エラーはログに記録しサーバー上で処理するようにします。  
+  
+-   ストアド プロシージャは 1 度作成すれば、さまざまなアプリケーションからアクセスできます。  
+  
+-   クライアント アプリケーションは基になるデータの構造を意識する必要がありません。  パラメーター リストや返されるデータ型に影響が及ばない限り、ストアド プロシージャのコードを変更しても、クライアント アプリケーション側に変更を加える必要はありません。  
+  
+-   ストアド プロシージャによって、複数の操作を 1 回のプロシージャ呼び出しにまとめることができるため、ネットワーク トラフィックを削減できます。  
+  
+## ストアド プロシージャの実行  
+ ストアド プロシージャを使用すると、所有権の継承によるデータ アクセスを利用できるため、データベース オブジェクトにアクセスするための権限をユーザーに明示的に付与する必要がありません。  所有権の継承は、連鎖的にアクセスされる複数のオブジェクトが同じユーザーによって所有されている場合に適用されます。  たとえば、あるストアド プロシージャが別のストアド プロシージャを呼び出したり、特定のストアド プロシージャが複数のテーブルにアクセスしたりすることができます。  実行の連鎖に含まれるすべてのオブジェクトが同じ所有者を共有していた場合、SQL Server は呼び出し元の EXECUTE 権限だけをチェックします。つまり、他のオブジェクトの呼び出し元の権限はチェックされません。  したがって、EXECUTE 権限はストアド プロシージャにのみ付与すればよく、基になるテーブルの権限はすべて取り消すか拒否できます。  
+  
+## ベスト プラクティス  
+ 単にストアド プロシージャを作成するだけでは、アプリケーションを適切に保護することはできません。  同時に、次の点を考慮してセキュリティ ホールを防ぐ必要があります。  
+  
+-   データ アクセスを許可するデータベース ロールに、ストアド プロシージャの EXECUTE 権限を付与する。  
+  
+-   基になるテーブルのすべての権限を取り消すか拒否する。`public` ロールを含め、データベース内のすべてのロールおよびユーザーが対象になります。  すべてのユーザーは public から権限を継承します。  したがって、`public` の権限を拒否することは、所有者と `sysadmin` メンバーだけがアクセス権を持つことを意味します。それ以外のすべてのユーザーは、他のロールのメンバーになっても権限を継承することはできなくなります。  
+  
+-   `sysadmin` ロールまたは `db_owner` ロールに対してユーザーまたはロールを追加することは避ける。  システム管理者およびデータベース所有者は、すべてのデータベース オブジェクトにアクセスできます。  
+  
+-   `guest` アカウントを無効にする。  こうすることで、匿名ユーザーがデータベースに接続することはできなくなります。  新しいデータベースの guest アカウントは既定で無効化されています。  
+  
+-   エラー処理を実装し、エラーのログを記録する。  
+  
+-   すべてのユーザー入力を検証するパラメーター化されたストアド プロシージャを作成する。  どのようなユーザー入力も "信頼できないもの" として扱うようにします。  
+  
+-   どうしても必要な場合を除き、動的 SQL は使用しない。  文字列値を Transact\-SQL の QUOTENAME\(\) 関数に渡すことで、入力文字列に含まれている可能性のある区切り記号をエスケープできます。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server Books Online の「[ストアド プロシージャ \(データベース エンジン\)](http://msdn.microsoft.com/library/ms190782.aspx)」および「[SQL インジェクション](http://go.microsoft.com/fwlink/?LinkId=98234)」|ストアド プロシージャの作成方法と SQL インジェクションのしくみについて説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)   
+ [SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)   
+ [ストアド プロシージャでのデータの変更](../../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/manipulating-data.md b/docs/framework/data/adonet/sql/manipulating-data.md
new file mode 100644
index 00000000000..ab1e6d5a7e1
--- /dev/null
+++ b/docs/framework/data/adonet/sql/manipulating-data.md
@@ -0,0 +1,411 @@
+---
+title: "データの操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51096a2e-8b38-4c4d-a523-799bfdb7ec69
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# データの操作
+複数のアクティブな結果セット \(MARS : Multiple Active Result Set\) の導入前は、開発者は複数の接続またはサーバー側のカーソルのいずれかを使用して特定のシナリオを解決しなければなりませんでした。  さらに、トランザクションの状況で複数の接続を使用するときは、接続をバインド \(**sp\_getbindtoken** と **sp\_bindsession**\) する必要がありました。  以下のシナリオでは、複数の接続の代わりに MARS の有効な接続の使い方について説明します。  
+  
+## MARS で複数のコマンドを使用する  
+ 次のコンソール アプリケーションでは、2 つの <xref:System.Data.SqlClient.SqlDataReader> オブジェクトを 2 つの <xref:System.Data.SqlClient.SqlCommand> オブジェクトと使用する方法、および 1 つの <xref:System.Data.SqlClient.SqlConnection> オブジェクトを MARS を有効にして使用する方法について示します。  
+  
+### 例  
+ この例では、**AdventureWorks** データベースとの接続を 1 つ開きます。  <xref:System.Data.SqlClient.SqlCommand> オブジェクトを使用して、<xref:System.Data.SqlClient.SqlDataReader> が作成されます。  リーダーが使用されると、2 番目の <xref:System.Data.SqlClient.SqlDataReader> リーダーが開かれます。このとき、最初の <xref:System.Data.SqlClient.SqlDataReader> から取得したデータが 2 番目のリーダーの WHERE 句に入力されます。  
+  
+> [!NOTE]
+>  次の例では、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] に含まれるサンプルの **AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```vb  
+Option Strict On  
+Option Explicit On  
+  
+Imports System  
+Imports System.Data  
+Imports System.Data.SqlClient  
+Module Module1  
+  Sub Main()  
+    ' By default, MARS is disabled when connecting  
+    ' to a MARS-enabled host.  
+    ' It must be enabled in the connection string.  
+    Dim connectionString As String = GetConnectionString()  
+  
+    Dim vendorID As Integer  
+  
+    Dim vendorCmd As SqlCommand  
+    Dim productCmd As SqlCommand  
+    Dim productReader As SqlDataReader  
+  
+    Dim vendorSQL As String = & _   
+      "SELECT VendorId, Name FROM Purchasing.Vendor"  
+    Dim productSQL As String = _  
+        "SELECT Production.Product.Name FROM Production.Product " & _  
+        "INNER JOIN Purchasing.ProductVendor " & _  
+        "ON Production.Product.ProductID = " & _  
+        "Purchasing.ProductVendor.ProductID " & _  
+        "WHERE Purchasing.ProductVendor.VendorID = @VendorId"  
+  
+    Using awConnection As New SqlConnection(connectionString)  
+      vendorCmd = New SqlCommand(vendorSQL, awConnection)  
+      productCmd = New SqlCommand(productSQL, awConnection)  
+      productCmd.Parameters.Add("@VendorId", SqlDbType.Int)  
+  
+      awConnection.Open()  
+      Using vendorReader As SqlDataReader = vendorCmd.ExecuteReader()  
+        While vendorReader.Read()  
+          Console.WriteLine(vendorReader("Name"))  
+  
+          vendorID = CInt(vendorReader("VendorId"))  
+  
+          productCmd.Parameters("@VendorId").Value = vendorID  
+  
+          ' The following line of code requires  
+          ' a MARS-enabled connection.  
+          productReader = productCmd.ExecuteReader()  
+          Using productReader  
+            While productReader.Read()  
+              Console.WriteLine("  " & CStr(productReader("Name")))  
+            End While  
+          End Using  
+        End While  
+      End Using  
+    End Using  
+  
+    Console.WriteLine("Press any key to continue")  
+    Console.ReadLine()  
+  End Sub  
+  
+  Function GetConnectionString() As String  
+    ' To avoid storing the connection string in your code,  
+    ' you can retrive it from a configuration file.  
+    Return "Data Source=(local);Integrated Security=SSPI;" & _  
+      "Initial Catalog=AdventureWorks; MultipleActiveResultSets=True"  
+  End Function  
+End Module  
+```  
+  
+```csharp  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+class Class1  
+{  
+static void Main()  
+{  
+  // By default, MARS is disabled when connecting  
+  // to a MARS-enabled host.  
+  // It must be enabled in the connection string.  
+  string connectionString = GetConnectionString();  
+  
+  int vendorID;  
+  SqlDataReader productReader = null;  
+  string vendorSQL =   
+    "SELECT VendorId, Name FROM Purchasing.Vendor";  
+  string productSQL =   
+    "SELECT Production.Product.Name FROM Production.Product " +  
+    "INNER JOIN Purchasing.ProductVendor " +  
+    "ON Production.Product.ProductID = " +   
+    "Purchasing.ProductVendor.ProductID " +  
+    "WHERE Purchasing.ProductVendor.VendorID = @VendorId";  
+  
+  using (SqlConnection awConnection =   
+    new SqlConnection(connectionString))  
+  {  
+    SqlCommand vendorCmd = new SqlCommand(vendorSQL, awConnection);  
+    SqlCommand productCmd =   
+      new SqlCommand(productSQL, awConnection);  
+  
+    productCmd.Parameters.Add("@VendorId", SqlDbType.Int);  
+  
+    awConnection.Open();  
+    using (SqlDataReader vendorReader = vendorCmd.ExecuteReader())  
+    {  
+      while (vendorReader.Read())  
+      {  
+        Console.WriteLine(vendorReader["Name"]);  
+  
+        vendorID = (int)vendorReader["VendorId"];  
+  
+        productCmd.Parameters["@VendorId"].Value = vendorID;  
+        // The following line of code requires  
+        // a MARS-enabled connection.  
+        productReader = productCmd.ExecuteReader();  
+        using (productReader)  
+        {  
+          while (productReader.Read())  
+          {  
+            Console.WriteLine("  " +  
+              productReader["Name"].ToString());  
+          }  
+        }  
+      }  
+  }  
+      Console.WriteLine("Press any key to continue");  
+      Console.ReadLine();  
+    }  
+  }  
+  private static string GetConnectionString()  
+  {  
+    // To avoid storing the connection string in your code,  
+    // you can retrive it from a configuration file.  
+    return "Data Source=(local);Integrated Security=SSPI;" +   
+      "Initial Catalog=AdventureWorks;MultipleActiveResultSets=True";  
+  }  
+}  
+```  
+  
+## MARS によるデータの読み取りと更新  
+ MARS を使用すると、複数の保留中の操作について、読み取り操作と DML \(データ操作言語\) 操作の両方で 1 つの接続を使用することができます。  この機能により、アプリケーションで接続ビジー エラーを処理する必要がなくなります。  さらに、MARS ではサーバー側カーソルのユーザーを置き換えることができます。通常、この処理は多くのリソースを消費します。  最後に、複数の操作を単一の接続で実行できるので、同じトランザクション コンテキストを共有することにより、システムのストアド プロシージャである **sp\_getbindtoken** と **sp\_bindsession** を使用する必要がなくなります。  
+  
+### 例  
+ 次のコンソール アプリケーションでは、2 つの <xref:System.Data.SqlClient.SqlDataReader> オブジェクトを 3 つの <xref:System.Data.SqlClient.SqlCommand> オブジェクトと使用する方法、および 1 つの <xref:System.Data.SqlClient.SqlConnection> オブジェクトを MARS を有効にして使用する方法について示します。  最初のコマンド オブジェクトでは、格付けが 5 のベンダーの一覧を取得します。  2 番目のコマンド オブジェクトでは、<xref:System.Data.SqlClient.SqlDataReader> から提供されるベンダー ID を使用して特定のベンダーのすべての製品について 2 番目の <xref:System.Data.SqlClient.SqlDataReader> を読み取ります。  各製品のレコードは、2 番目の <xref:System.Data.SqlClient.SqlDataReader> によってアクセスされます。  計算が実行され、新規 **OnOrderQty** を判定します。  3 番目のコマンド オブジェクトでは、**ProductVendor** テーブルを新しい値で更新します。  このプロセスはすべて単一のトランザクションで行われ、最後にロールバックされます。  
+  
+> [!NOTE]
+>  次の例では、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] に含まれるサンプルの **AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```vb  
+Option Strict On  
+Option Explicit On  
+  
+Imports System  
+Imports System.Data  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+  
+  Sub Main()  
+    ' By default, MARS is disabled when connecting  
+    ' to a MARS-enabled host.  
+    ' It must be enabled in the connection string.  
+    Dim connectionString As String = GetConnectionString()  
+  
+    Dim updateTx As SqlTransaction  
+    Dim vendorCmd As SqlCommand  
+    Dim prodVendCmd As SqlCommand  
+    Dim updateCmd As SqlCommand  
+  
+    Dim prodVendReader As SqlDataReader  
+  
+    Dim vendorID As Integer  
+    Dim productID As Integer  
+    Dim minOrderQty As Integer  
+    Dim maxOrderQty As Integer  
+    Dim onOrderQty As Integer  
+    Dim recordsUpdated As Integer  
+    Dim totalRecordsUpdated As Integer  
+  
+    Dim vendorSQL As String = _  
+        "SELECT VendorID, Name FROM Purchasing.Vendor " & _  
+        "WHERE CreditRating = 5"  
+    Dim prodVendSQL As String = _  
+        "SELECT ProductID, MaxOrderQty, MinOrderQty, OnOrderQty " & _  
+        "FROM Purchasing.ProductVendor " & _  
+        "WHERE VendorID = @VendorID"  
+    Dim updateSQL As String = _  
+        "UPDATE Purchasing.ProductVendor " & _   
+        "SET OnOrderQty = @OrderQty " & _  
+        "WHERE ProductID = @ProductID AND VendorID = @VendorID"  
+  
+    Using awConnection As New SqlConnection(connectionString)  
+      awConnection.Open()  
+      updateTx = awConnection.BeginTransaction()  
+  
+      vendorCmd = New SqlCommand(vendorSQL, awConnection)  
+      vendorCmd.Transaction = updateTx  
+  
+      prodVendCmd = New SqlCommand(prodVendSQL, awConnection)  
+      prodVendCmd.Transaction = updateTx  
+      prodVendCmd.Parameters.Add("@VendorId", SqlDbType.Int)  
+  
+      updateCmd = New SqlCommand(updateSQL, awConnection)  
+      updateCmd.Transaction = updateTx  
+      updateCmd.Parameters.Add("@OrderQty", SqlDbType.Int)  
+      updateCmd.Parameters.Add("@ProductID", SqlDbType.Int)  
+      updateCmd.Parameters.Add("@VendorID", SqlDbType.Int)  
+  
+      Using vendorReader As SqlDataReader = vendorCmd.ExecuteReader()  
+        While vendorReader.Read()  
+          Console.WriteLine(vendorReader("Name"))  
+  
+          vendorID = CInt(vendorReader("VendorID"))  
+          prodVendCmd.Parameters("@VendorID").Value = vendorID  
+          prodVendReader = prodVendCmd.ExecuteReader()  
+  
+          Using prodVendReader  
+            While (prodVendReader.Read)  
+              productID = CInt(prodVendReader("ProductID"))  
+  
+              If IsDBNull(prodVendReader("OnOrderQty")) Then  
+                minOrderQty = CInt(prodVendReader("MinOrderQty"))  
+                onOrderQty = minOrderQty  
+              Else  
+                maxOrderQty = CInt(prodVendReader("MaxOrderQty"))  
+                onOrderQty = CInt(maxOrderQty / 2)  
+              End If  
+  
+              updateCmd.Parameters("@OrderQty").Value = onOrderQty  
+              updateCmd.Parameters("@ProductID").Value = productID  
+              updateCmd.Parameters("@VendorID").Value = vendorID  
+  
+              recordsUpdated = updateCmd.ExecuteNonQuery()  
+              totalRecordsUpdated += recordsUpdated  
+            End While  
+          End Using  
+        End While  
+      End Using  
+  
+      Console.WriteLine("Total Records Updated: " & _   
+        CStr(totalRecordsUpdated))  
+      updateTx.Rollback()  
+      Console.WriteLine("Transaction Rolled Back")  
+    End Using  
+  
+    Console.WriteLine("Press any key to continue")  
+    Console.ReadLine()  
+  
+  End Sub  
+  
+  Function GetConnectionString() As String  
+    ' To avoid storing the connection string in your code,  
+    ' you can retrive it from a configuration file.  
+    Return "Data Source=(local);Integrated Security=SSPI;" & _  
+      "Initial Catalog=AdventureWorks;MultipleActiveResultSets=True"  
+  End Function  
+End Module  
+```  
+  
+```csharp  
+using System;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+class Program  
+{  
+static void Main()  
+{  
+  // By default, MARS is disabled when connecting  
+  // to a MARS-enabled host.  
+  // It must be enabled in the connection string.  
+  string connectionString = GetConnectionString();  
+  
+  SqlTransaction updateTx = null;  
+  SqlCommand vendorCmd = null;  
+  SqlCommand prodVendCmd = null;  
+  SqlCommand updateCmd = null;  
+  
+  SqlDataReader prodVendReader = null;  
+  
+  int vendorID = 0;  
+  int productID = 0;  
+  int minOrderQty = 0;  
+  int maxOrderQty = 0;  
+  int onOrderQty = 0;  
+  int recordsUpdated = 0;  
+  int totalRecordsUpdated = 0;  
+  
+  string vendorSQL =  
+      "SELECT VendorID, Name FROM Purchasing.Vendor " +   
+      "WHERE CreditRating = 5";  
+  string prodVendSQL =  
+      "SELECT ProductID, MaxOrderQty, MinOrderQty, OnOrderQty " +  
+      "FROM Purchasing.ProductVendor " +   
+      "WHERE VendorID = @VendorID";  
+  string updateSQL =  
+      "UPDATE Purchasing.ProductVendor " +   
+      "SET OnOrderQty = @OrderQty " +  
+      "WHERE ProductID = @ProductID AND VendorID = @VendorID";  
+  
+  using (SqlConnection awConnection =   
+    new SqlConnection(connectionString))  
+  {  
+    awConnection.Open();  
+    updateTx = awConnection.BeginTransaction();  
+  
+    vendorCmd = new SqlCommand(vendorSQL, awConnection);  
+    vendorCmd.Transaction = updateTx;  
+  
+    prodVendCmd = new SqlCommand(prodVendSQL, awConnection);  
+    prodVendCmd.Transaction = updateTx;  
+    prodVendCmd.Parameters.Add("@VendorId", SqlDbType.Int);  
+  
+    updateCmd = new SqlCommand(updateSQL, awConnection);  
+    updateCmd.Transaction = updateTx;  
+    updateCmd.Parameters.Add("@OrderQty", SqlDbType.Int);  
+    updateCmd.Parameters.Add("@ProductID", SqlDbType.Int);  
+    updateCmd.Parameters.Add("@VendorID", SqlDbType.Int);  
+  
+    using (SqlDataReader vendorReader = vendorCmd.ExecuteReader())  
+    {  
+      while (vendorReader.Read())  
+      {  
+        Console.WriteLine(vendorReader["Name"]);  
+  
+        vendorID = (int) vendorReader["VendorID"];  
+        prodVendCmd.Parameters["@VendorID"].Value = vendorID;  
+        prodVendReader = prodVendCmd.ExecuteReader();  
+  
+        using (prodVendReader)  
+        {  
+          while (prodVendReader.Read())  
+          {  
+            productID = (int) prodVendReader["ProductID"];  
+  
+            if (prodVendReader["OnOrderQty"] == DBNull.Value)  
+            {  
+              minOrderQty = (int) prodVendReader["MinOrderQty"];  
+              onOrderQty = minOrderQty;  
+            }  
+            else  
+            {  
+              maxOrderQty = (int) prodVendReader["MaxOrderQty"];  
+              onOrderQty = (int)(maxOrderQty / 2);  
+            }  
+  
+            updateCmd.Parameters["@OrderQty"].Value = onOrderQty;  
+            updateCmd.Parameters["@ProductID"].Value = productID;  
+            updateCmd.Parameters["@VendorID"].Value = vendorID;  
+  
+            recordsUpdated = updateCmd.ExecuteNonQuery();  
+            totalRecordsUpdated += recordsUpdated;  
+          }  
+        }  
+      }  
+    }  
+    Console.WriteLine("Total Records Updated: " +   
+      totalRecordsUpdated.ToString());  
+    updateTx.Rollback();  
+    Console.WriteLine("Transaction Rolled Back");  
+  }  
+  
+  Console.WriteLine("Press any key to continue");  
+  Console.ReadLine();  
+}  
+private static string GetConnectionString()  
+{  
+  // To avoid storing the connection string in your code,  
+  // you can retrive it from a configuration file.  
+  return "Data Source=(local);Integrated Security=SSPI;" +   
+    "Initial Catalog=AdventureWorks;" +   
+    "MultipleActiveResultSets=True";  
+  }  
+}  
+```  
+  
+## 参照  
+ [複数のアクティブな結果セット \(MARS\)](../../../../../docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/modifying-large-value-max-data.md b/docs/framework/data/adonet/sql/modifying-large-value-max-data.md
new file mode 100644
index 00000000000..2c24af53246
--- /dev/null
+++ b/docs/framework/data/adonet/sql/modifying-large-value-max-data.md
@@ -0,0 +1,260 @@
+---
+title: "ADO.NET での大きい値 (max) データの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8aca5f00-d80e-4320-81b3-016d0466f7ee
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET での大きい値 (max) データの変更
+ラージ オブジェクト \(LOB\) データ型は、最大行サイズが 8 KB を超えるデータ型です。  SQL Server では、`varchar`、`nvarchar`、および `varbinary` の各データ型に `max` 指定子が用意されており、2^32 バイトの値を格納できます。  テーブル列および Transact\-SQL 変数により、`varchar(max)`、`nvarchar(max)`、または `varbinary(max)` データ型を指定できます。  ADO.NET では、`max` データ型は、`DataReader` によってフェッチすることができ、特殊な処理を行うことなく入力パラメーターと出力パラメーター両方の値として指定することもできます。  サイズの大きい `varchar` データ型の場合は、データを段階的に取得および更新できます。  
+  
+ `max` データ型は、Transact\-SQL 変数として比較に使用したり、連結に使用したりできます。  これらは SELECT ステートメントの DISTINCT 句、ORDER BY 句、GROUP BY 句で使用できるほか、集約、結合、サブクエリでも使用できます。  
+  
+ 次の表は、SQL Server オンライン ブックのドキュメントへのリンクを提供します。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [大きい値のデータ型の使用](http://go.microsoft.com/fwlink/?LinkId=120498)  
+  
+## 大きい値型の制限事項  
+ `max` データ型には、小さいデータ型にはない、次の制限事項が適用されます。  
+  
+-   `sql_variant` に大きい `varchar` データ型を含めることはできません。  
+  
+-   大きい `varchar` 列はインデックス内のキー列として指定することはできません。  非クラスター化インデックスに含まれる列で使用できます。  
+  
+-   大きい `varchar` 列はパーティション分割のキー列として使用できません。  
+  
+## Transact\-SQL での大きい値型の使用  
+ Transact\-SQL の `OPENROWSET` 関数は、リモート データへの接続およびアクセスに 1 回だけ使用できます。  この関数には、OLE DB データ ソースからリモート データにアクセスするために必要な、すべての接続情報が含まれています。  `OPENROWSET` は、クエリの FROM 句でテーブル名と同様に参照できます。  OLE DB プロバイダーの機能に従って、INSERT、UPDATE、または DELETE ステートメントのターゲット テーブルとして参照することもできます。  
+  
+ `OPENROWSET` 関数には、`BULK` 行セット プロバイダーが含まれており、データをターゲット テーブルに読み込むことなく、ファイルから直接読み取ることができます。  これにより、`OPENROWSET` を単純な INSERT SELECT ステートメントで使用できます。  
+  
+ `OPENROWSET`  `BULK` オプション引数により、データの読み取りの開始位置および終了位置、エラーの処理、データの解釈の制御が大幅に容易になります。  たとえば、データ ファイルを 1 行として、あるいは `varbinary`、`varchar`、または `nvarchar` 型の 1 列の行セットとして読み取るように指定できます。  完全な構文とオプションについては、SQL Server オンライン ブックを参照してください。  
+  
+ 次の例では、AdventureWorks サンプル データベースの ProductPhoto テーブルに写真を挿入しています。  `BULK``OPENROWSET` プロバイダーを使用する場合は、すべての列に値を挿入しない場合でも、列名を挙げてリストを作成する必要があります。  この場合の主キーは ID 列として定義され、列リストから省略することもできます。  ただし、`OPENROWSET` ステートメントの最後に相関関係名 \(この場合は ThumbnailPhoto\) を指定する必要があります。  これにより、ファイルが読み込まれる `ProductPhoto` テーブルの列との相関関係が定義されます。  
+  
+```  
+INSERT Production.ProductPhoto (  
+    ThumbnailPhoto,   
+    ThumbnailPhotoFilePath,   
+    LargePhoto,   
+    LargePhotoFilePath)  
+SELECT ThumbnailPhoto.*, null, null, N'tricycle_pink.gif'  
+FROM OPENROWSET   
+    (BULK 'c:\images\tricycle.jpg', SINGLE_BLOB) ThumbnailPhoto  
+```  
+  
+## UPDATE .WRITE を使用したデータの更新  
+ Transact\-SQL の UPDATE ステートメントでは、`varchar(max)`、`nvarchar(max)`、または `varbinary(max)` 列の内容を変更するための、新しい WRITE 構文を使用できます。  これにより、データの部分的な更新が可能になります。  次に UPDATE .WRITE 構文を省略形で示します。  
+  
+ UPDATE  
+  
+ { *\<object\>* }  
+  
+ SET  
+  
+ { *column\_name* \= { .WRITE \( *expression* , @Offset , @Length \) }  
+  
+ WRITE メソッドは、*column\_name* の値のセクションが変更されることを指定します。  この式は *column\_name* にコピーされる値で、`@Offset` は式が記述される開始位置であり、`@Length` 引数は列のセクションの長さを示します。  
+  
+|If|Then|  
+|--------|----------|  
+|expression が NULL|`@Length` は無視され、*column\_name* の値は指定された `@Offset` で切り捨てられます。|  
+|`@Offset` が NULL|更新操作によって既存の *column\_name* の値の最後に式が追加され、`@Length` が無視されます。|  
+|`@Offset` が column\_name の値の長さより長い|SQL Server からエラーが返されます。|  
+|`@Length` が NULL|更新操作により `column_name` の値の `@Offset` から最後までのすべてのデータが削除されます。|  
+  
+> [!NOTE]
+>  `@Offset` または `@Length` のいずれにも負数を指定することはできません。  
+  
+## 例  
+ この Transact\-SQL の例では、AdventureWorks データベースの Document テーブルの `nvarchar(max)` 列である DocumentSummary の値の一部が更新されます。  置換後の単語、置換する単語の既存データ内での開始位置 \(オフセット\)、置換する文字数 \(長さ\) を指定することで、'components' という単語が 'features' という単語に置換されます。  この例では、結果を比較するために、UPDATE ステートメントの前後に SELECT ステートメントを指定しています。  
+  
+```  
+USE AdventureWorks;  
+GO  
+--View the existing value.  
+SELECT DocumentSummary  
+FROM Production.Document  
+WHERE DocumentID = 3;  
+GO  
+-- The first sentence of the results will be:  
+-- Reflectors are vital safety components of your bicycle.  
+  
+--Modify a single word in the DocumentSummary column  
+UPDATE Production.Document  
+SET DocumentSummary .WRITE (N'features',28,10)  
+WHERE DocumentID = 3 ;  
+GO   
+--View the modified value.  
+SELECT DocumentSummary  
+FROM Production.Document  
+WHERE DocumentID = 3;  
+GO  
+-- The first sentence of the results will be:  
+-- Reflectors are vital safety features of your bicycle.  
+```  
+  
+## ADO.NET での大きい値型の使用  
+ 大きい値型を ADO.NET で使用するには、大きい値型を <xref:System.Data.SqlClient.SqlDataReader> で <xref:System.Data.SqlClient.SqlParameter> オブジェクトとして指定して結果セットを返すようにするか、または <xref:System.Data.SqlClient.SqlDataAdapter> を使用して `DataSet`\/`DataTable` に入力します。  大きい値型と、関連する小さい値型の使用方法に違いはありません。  
+  
+### GetSqlBytes を使用したデータの取得  
+ <xref:System.Data.SqlClient.SqlDataReader> の `GetSqlBytes` メソッドを使用して、`varbinary(max)` 列の内容を取得できます。  次のコード フラグメントでは、`cmd` という名前の <xref:System.Data.SqlClient.SqlCommand> オブジェクトによってテーブルから `varbinary(max)` データが選択され、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによってデータが <xref:System.Data.SqlTypes.SqlBytes> として取得されることを想定しています。  
+  
+```vb  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+While reader.Read()  
+    Dim bytes As SqlBytes = reader.GetSqlBytes(0)  
+End While  
+```  
+  
+```csharp  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection);  
+while (reader.Read())  
+    {  
+        SqlBytes bytes = reader.GetSqlBytes(0);  
+    }  
+```  
+  
+### GetSqlChars を使用したデータの取得  
+ <xref:System.Data.SqlClient.SqlDataReader> の `GetSqlChars` メソッドを使用して、`varchar(max)` または `nvarchar(max)` 列の内容を取得できます。  次のコード フラグメントでは、`cmd` という名前の <xref:System.Data.SqlClient.SqlCommand> オブジェクトによってテーブルから `nvarchar(max)` データが選択され、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによってデータが取得されることを想定しています。  
+  
+```vb  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+While reader.Read()  
+    Dim buffer As SqlChars = reader.GetSqlChars(0)  
+End While  
+```  
+  
+```csharp  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection);  
+while (reader.Read())  
+{  
+    SqlChars buffer = reader.GetSqlChars(0);  
+}  
+```  
+  
+### GetSqlBinary を使用したデータの取得  
+ <xref:System.Data.SqlClient.SqlDataReader> の `GetSqlBinary` メソッドを使用して、`varbinary(max)` 列の内容を取得できます。  次のコード フラグメントでは、`cmd` という名前の <xref:System.Data.SqlClient.SqlCommand> オブジェクトによってテーブルから `varbinary(max)` データが選択され、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによってデータが <xref:System.Data.SqlTypes.SqlBinary> ストリームとして取得されることを想定しています。  
+  
+```vb  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+While reader.Read()  
+    Dim binaryStream As SqlBinary = reader.GetSqlBinary(0)  
+End While  
+```  
+  
+```csharp  
+reader = cmd.ExecuteReader(CommandBehavior.CloseConnection);  
+while (reader.Read())  
+    {  
+        SqlBinary binaryStream = reader.GetSqlBinary(0);  
+    }  
+```  
+  
+### GetBytes を使用したデータの取得  
+ <xref:System.Data.SqlClient.SqlDataReader> の `GetBytes` メソッドにより、指定された配列のオフセットから開始するバイト配列に、指定された列のオフセットからバイトのストリームが読み込まれます。  次のコード フラグメントでは、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによってバイトがバイト配列に読み込まれることが想定されています。  ただし `GetSqlBytes` とは異なり、`GetBytes` では配列バッファーのサイズを指定する必要があります。  
+  
+```vb  
+While reader.Read()  
+    Dim buffer(4000) As Byte  
+    Dim byteCount As Integer = _  
+    CInt(reader.GetBytes(1, 0, buffer, 0, 4000))  
+End While  
+```  
+  
+```csharp  
+while (reader.Read())  
+{  
+    byte[] buffer = new byte[4000];  
+    long byteCount = reader.GetBytes(1, 0, buffer, 0, 4000);  
+}  
+```  
+  
+### GetValue を使用したデータの取得  
+ <xref:System.Data.SqlClient.SqlDataReader> の `GetValue` メソッドにより、指定した列オフセットから値が配列に読み込まれます。  次のコード フラグメントでは、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによって、最初の列のオフセットからバイナリ データが取得され、2 番目の列のオフセットから文字列データが取得されることが想定されています。  
+  
+```vb  
+While reader.Read()  
+    ' Read the data from varbinary(max) column  
+    Dim binaryData() As Byte = CByte(reader.GetValue(0))  
+  
+    ' Read the data from varchar(max) or nvarchar(max) column  
+    Dim stringData() As String = Cstr((reader.GetValue(1))  
+End While  
+```  
+  
+```csharp  
+while (reader.Read())  
+{  
+    // Read the data from varbinary(max) column  
+    byte[] binaryData = (byte[])reader.GetValue(0);  
+  
+    // Read the data from varchar(max) or nvarchar(max) column  
+    String stringData = (String)reader.GetValue(1);  
+}  
+```  
+  
+## 大きい値型から CLR 型への変換  
+ `ToString` などの任意の文字列変換メソッドを使用して、`varchar(max)` または `nvarchar(max)` 列の内容を変換できます。  次のコード フラグメントでは、`reader` という名前の <xref:System.Data.SqlClient.SqlDataReader> オブジェクトによってデータが取得されることが想定されています。  
+  
+```vb  
+While reader.Read()  
+    Dim str as String = reader(0).ToString()  
+    Console.WriteLine(str)  
+End While  
+```  
+  
+```csharp  
+while (reader.Read())  
+{  
+     string str = reader[0].ToString();  
+     Console.WriteLine(str);  
+}  
+```  
+  
+### 例  
+ 次のコードでは、`AdventureWorks` データベースの `ProductPhoto` テーブルから名前と `LargePhoto` オブジェクトが取得され、ファイルに保存されます。  このアセンブリは、<xref:System.Drawing> 名前空間への参照を指定してコンパイルする必要があります。  <xref:System.Data.SqlClient.SqlDataReader> の <xref:System.Data.SqlClient.SqlDataReader.GetSqlBytes%2A> メソッドにより、`Stream` プロパティを公開する <xref:System.Data.SqlTypes.SqlBytes> オブジェクトが返されます。  コードではこのオブジェクトを使用して新しい `Bitmap` オブジェクトが作成され、Gif`ImageFormat` に保存されます。  
+  
+ [!code-csharp[DataWorks LargeValueType.Photo#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks LargeValueType.Photo/CS/source.cs#1)]
+ [!code-vb[DataWorks LargeValueType.Photo#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks LargeValueType.Photo/VB/source.vb#1)]  
+  
+## 大きな値型パラメーターの使用  
+ 大きい値型は、<xref:System.Data.SqlClient.SqlParameter> オブジェクト内の小さい値型と同じ方法で、<xref:System.Data.SqlClient.SqlParameter> オブジェクト内で使用できます。  次の例に示すように、大きい値型は <xref:System.Data.SqlClient.SqlParameter> 値として取得することができます。  このコードでは、次の GetDocumentSummary ストアド プロシージャが、AdventureWorks サンプル データベースに存在することが想定されています。  ストアド プロシージャでは @DocumentID という名前の入力パラメーターを受け取り、@DocumentSummary 出力パラメーターの DocumentSummary 列の内容を返します。  
+  
+```  
+CREATE PROCEDURE GetDocumentSummary   
+(  
+    @DocumentID int,  
+    @DocumentSummary nvarchar(MAX) OUTPUT  
+)  
+AS  
+SET NOCOUNT ON  
+SELECT  @DocumentSummary=Convert(nvarchar(MAX), DocumentSummary)  
+FROM    Production.Document  
+WHERE   DocumentID=@DocumentID  
+```  
+  
+### 例  
+ ADO.NET コードにより、<xref:System.Data.SqlClient.SqlConnection> および <xref:System.Data.SqlClient.SqlCommand> オブジェクトが作成され、GetDocumentSummary ストアド プロシージャが実行されることで、ドキュメントの概要が取得され、大きい値型として格納されます。  このコードによって @DocumentID 入力パラメーターの値が渡され、@DocumentSummary 出力パラメーターに戻された結果がコンソール ウィンドウに表示されます。  
+  
+ [!code-csharp[DataWorks LargeValueType.Param#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks LargeValueType.Param/CS/source.cs#1)]
+ [!code-vb[DataWorks LargeValueType.Param#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks LargeValueType.Param/VB/source.vb#1)]  
+  
+## 参照  
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [ADO.NET における SQL Server データ操作](../../../../../docs/framework/data/adonet/sql/sql-server-data-operations.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md b/docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md
new file mode 100644
index 00000000000..165794467c2
--- /dev/null
+++ b/docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md
@@ -0,0 +1,35 @@
+---
+title: "複数のアクティブな結果セット (MARS) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c90ef863-bac7-44cf-adc1-f05c36fcf57d
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# 複数のアクティブな結果セット (MARS)
+複数のアクティブな結果セット \(MARS : Multiple Active Result Set\) は、複数のバッチを単一の接続で実行できる機能です。  従来のバージョンでは、単一の接続で同時に実行できるバッチは 1 つだけでした。  MARS で複数のバッチを実行することは、同時に操作を実行することではありません。  
+  
+## このセクションの内容  
+ [複数のアクティブな結果セット \(MARS\) の有効化](../../../../../docs/framework/data/adonet/sql/enabling-multiple-active-result-sets.md)  
+ SQL Server で MARS を使用する方法について説明します。  
+  
+ [データの操作](../../../../../docs/framework/data/adonet/sql/manipulating-data.md)  
+ MARS アプリケーションのコーディング例を示します。  
+  
+## 関連項目  
+ [非同期操作](../../../../../docs/framework/data/adonet/sql/asynchronous-operations.md)  
+ ADO.NET での新たな非同期機能の使い方について詳しく説明します。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/multiple-bulk-copy-operations.md b/docs/framework/data/adonet/sql/multiple-bulk-copy-operations.md
new file mode 100644
index 00000000000..011d7217cd8
--- /dev/null
+++ b/docs/framework/data/adonet/sql/multiple-bulk-copy-operations.md
@@ -0,0 +1,35 @@
+---
+title: "複数のバルク コピー操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ad12f94-7459-4a93-a421-4160d1a90715
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# 複数のバルク コピー操作
+<xref:System.Data.SqlClient.SqlBulkCopy> クラスのインスタンスを 1 つ使用すると、バルク コピー操作を複数回実行できます。  コピー元とコピー先の間の操作パラメーターが変更になる場合は \(たとえば、コピー先のテーブル名など\)、**WriteToServer** メソッドを続けて呼び出す前に、次の例で示すようにパラメーターを更新する必要があります。  明示的に変更されている場合を除き、すべてのプロパティ値は、任意のインスタンスに対する前回のバルク コピー操作の状態のまま残っています。  
+  
+> [!NOTE]
+>  通常、バルク コピー操作を複数回実行する場合は、同じ <xref:System.Data.SqlClient.SqlBulkCopy> のインスタンスを使用する方が各操作ごとに別のインスタンスを使用するよりも効率的です。  
+  
+ 同じ <xref:System.Data.SqlClient.SqlBulkCopy> オブジェクトを使用してバルク コピー操作を複数回実行する場合は、コピー元またはコピー先の情報が各操作ごとに一致しているかまたは異なっているかどうかは制限されません。  ただし、サーバーに書き込み処理を行うときは、列の関連情報を毎回正しく設定する必要があります。  
+  
+> [!IMPORTANT]
+>  このサンプルは、「[バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)」で説明しているように作業テーブルを作成してからでないと動作しません。  このコードでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の SQL Server インスタンス内に存在する場合、Transact\-SQL `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+ [!code-csharp[DataWorks SqlBulkCopy.ColumnMappingOrdersDetails#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.ColumnMappingOrdersDetails/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlBulkCopy.ColumnMappingOrdersDetails#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.ColumnMappingOrdersDetails/VB/source.vb#1)]  
+  
+## 参照  
+ [SQL Server でのバルク コピー操作](../../../../../docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/overview-of-sql-server-security.md b/docs/framework/data/adonet/sql/overview-of-sql-server-security.md
new file mode 100644
index 00000000000..05a1df0abfc
--- /dev/null
+++ b/docs/framework/data/adonet/sql/overview-of-sql-server-security.md
@@ -0,0 +1,53 @@
+---
+title: "SQL Server セキュリティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae66dd75-5c16-4cc0-9e12-774dd26d3fb9
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server セキュリティの概要
+セキュリティを幾重にも重ねて講じる多層防御は、セキュリティ上の脅威に対抗する最も有効な手段です。  SQL Server のセキュリティ アーキテクチャは、データベースの管理者および開発者が安全なデータベース アプリケーションを作成して脅威に対応できるように設計されています。  SQL Server は、前のバージョンに新しい機能を導入することによって絶えず進化してきました。  しかし、セキュリティを箱詰めして出荷することはできません。  アプリケーションには、それぞれ固有のセキュリティ要件があります。  開発者は、既知の脅威に対してどのような機能を組み合わせるのが最も効果的かを理解し、将来発生する可能性のある脅威を予測する必要があります。  
+  
+ SQL Server のインスタンスは、サーバーを頂点とする階層形式のエンティティのコレクションを持ちます。  各サーバーには複数のデータベースが存在し、各データベースには、セキュリティ保護可能なオブジェクトのコレクションが存在します。  SQL Server へのアクセスが許可されたユーザー、グループ、またはプロセスをプリンシパルと呼び、SQL Server のセキュリティ保護可能なリソースにはすべて、*プリンシパル*に対して付与することのできる*権限*が関連付けられています。  SQL Server のセキュリティ フレームワークでは、セキュリティ保護可能なリソース エンティティへのアクセスが、*認証*および*承認*によって管理されます。  
+  
+-   認証は SQL Server にログオンするプロセスです。プリンシパルは、サーバーによって評価される資格情報を送信することによってアクセスを要求します。  認証対象となるユーザーまたはプロセスの ID は、認証によって確立されます。  
+  
+-   承認は、プリンシパルがアクセスできる、セキュリティ保護可能なリソースと、これらのリソースに対して許可された操作を特定するプロセスです。  
+  
+ このセクションの各トピックでは、SQL Server のセキュリティの基礎を取り上げています。より詳細な情報を確認できるように、該当するバージョンの SQL Server オンライン ブックへのリンクも用意されています。  
+  
+## このセクションの内容  
+ [認証](../../../../../docs/framework/data/adonet/sql/authentication-in-sql-server.md)  
+ SQL Server のログインと認証の説明のほか、各種リソースへのリンクが記載されています。  
+  
+ [SQL Server のサーバー ロールとデータベース ロール](../../../../../docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md)  
+ 固定サーバー ロールと固定データベース ロール、カスタム データベース ロール、組み込みアカウントの説明のほか、各種リソースへのリンクが記載されています。  
+  
+ [SQL Server における所有権とユーザーとスキーマの分離](../../../../../docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md)  
+ オブジェクトの所有権とユーザーとスキーマの分離の説明のほか、各種リソースへのリンクが記載されています。  
+  
+ [SQL Server の承認とアクセス許可](../../../../../docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md)  
+ 最小特権の原則に基づく権限の付与について説明しているほか、各種リソースへのリンクが記載されています。  
+  
+ [SQL Server でのデータの暗号化](../../../../../docs/framework/data/adonet/sql/data-encryption-in-sql-server.md)  
+ SQL Server におけるデータの暗号化オプションの説明のほか、各種リソースへのリンクが記載されています。  
+  
+ [SQL Server の CLR 統合セキュリティ](../../../../../docs/framework/data/adonet/sql/clr-integration-security-in-sql-server.md)  
+ CLR 統合セキュリティ関連リソースへのリンクが記載されています。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server のセキュリティ](../../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md b/docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md
new file mode 100644
index 00000000000..841c2f29086
--- /dev/null
+++ b/docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md
@@ -0,0 +1,73 @@
+---
+title: "SQL Server における所有権とユーザーとスキーマの分離 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 242830c1-31b5-4427-828c-cc22ff339f30
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server における所有権とユーザーとスキーマの分離
+オブジェクトの所有者は、それを管理するための取り消し不可能な権限を持ちます。これは SQL Server のセキュリティの核となる概念です。  オブジェクトの所有者から権限を削除することはできません。また、特定のユーザーがデータベース内のオブジェクトを所有しているときに、そのユーザーをデータベースから削除することもできません。  
+  
+## ユーザーとスキーマの分離  
+ ユーザーとスキーマの分離により、データベース オブジェクトの権限をより柔軟に管理できるようになりました。  *スキーマ*は、データベース オブジェクトの名前付きのコンテナーです。これにより、複数のオブジェクトを個別の名前空間にグループ化できます。  たとえば、AdventureWorks サンプル データベースには、Production、Sales、および HumanResources というスキーマが格納されています。  
+  
+ オブジェクトを参照する 4 つの部分から成る命名構文では、スキーマ名が指定されます。  
+  
+```  
+Server.Database.DatabaseSchema.DatabaseObject  
+```  
+  
+### スキーマの所有者と権限  
+ スキーマは任意のデータベース プリンシパルが所有できるほか、1 つのプリンシパルが複数のスキーマを所有することもできます。  スキーマにはセキュリティ ルールを適用できます。適用されたセキュリティ ルールは、そのスキーマのすべてのオブジェクトによって継承されます。  スキーマに対してアクセス権限を設定すると、そのスキーマに追加された新しいオブジェクトにこれらの権限が自動的に適用されます。  ユーザーに既定のスキーマを割り当て、複数のデータベース ユーザーでその同じスキーマを共有できます。  
+  
+ 既定では、開発者がスキーマにオブジェクトを作成した場合、そのオブジェクトは、開発者ではなく、そのスキーマを所有するセキュリティ プリンシパルによって所有されることになります。  オブジェクトの所有権は、Transact\-SQL ステートメント ALTER AUTHORIZATION で転送できます。  1 つのスキーマに対し、それぞれ異なるユーザーによって所有されたオブジェクトを追加することもできます。そうすることで、スキーマそのものに割り当てるよりも権限を細かく管理できますが、権限の管理が煩雑になるため、この方法はお勧めできません。  オブジェクトはスキーマ間で移動できるほか、プリンシパル間でスキーマの所有権を転送することもできます。  データベース ユーザーを削除してもスキーマには影響しません。  
+  
+### 組み込みスキーマ  
+ SQL Server には、組み込みのデータベース ユーザーおよびロールと同じ名前を持った 10 個の定義済みスキーマが付属しています。  これらは主に下位互換性を確保するために存在します。  固定データベース ロールと同じ名前のスキーマは、不要であれば削除してもかまいません。  次のスキーマを削除することはできません。  
+  
+-   `dbo`  
+  
+-   `guest`  
+  
+-   `sys`  
+  
+-   `INFORMATION_SCHEMA`  
+  
+ これらを model データベースから削除した場合、新しいデータベースにはこれらのスキーマが存在しなくなります。  
+  
+> [!NOTE]
+>  `sys` スキーマおよび `INFORMATION_SCHEMA` スキーマは、システム オブジェクト用に予約されています。  これらのスキーマにオブジェクトを作成することはできません。また、これらのスキーマを削除することもできません。  
+  
+#### dbo スキーマ  
+ `dbo` スキーマは、新しく作成されたデータベースに使用される既定のスキーマです。  `dbo` スキーマは、`dbo` ユーザー アカウントによって所有されます。  既定では、Transact\-SQL コマンド CREATE USER で作成されたユーザーには、`dbo` が既定のスキーマとして割り当てられます。  
+  
+ `dbo` スキーマが割り当てられたユーザーは、`dbo` ユーザー アカウントの権限を継承しません。  スキーマの権限はユーザーによって継承されるのではなく、そのスキーマに含まれたデータベース オブジェクトによって継承されます。  
+  
+> [!NOTE]
+>  1 部構成の名前を使用してデータベース オブジェクトを参照すると、まずユーザーの既定のスキーマが検索されます。  そこで目的のオブジェクトが見つからなかった場合は、`dbo` スキーマ内が検索されます。  `dbo` スキーマ内にオブジェクトが見つからなかった場合は、エラーが返されます。  
+  
+## 外部リソース  
+ オブジェクトの所有権とスキーマの詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[ユーザーとスキーマの分離](http://msdn.microsoft.com/library/ms190387.aspx)」|ユーザーとスキーマの分離によって導入された変更について説明します。  新しい動作とそれが所有権、カタログ ビュー、および権限に与える影響を取り上げています。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [認証](../../../../../docs/framework/data/adonet/sql/authentication-in-sql-server.md)   
+ [SQL Server のサーバー ロールとデータベース ロール](../../../../../docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md)   
+ [SQL Server の承認とアクセス許可](../../../../../docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/polling-in-console-applications.md b/docs/framework/data/adonet/sql/polling-in-console-applications.md
new file mode 100644
index 00000000000..15afce9d049
--- /dev/null
+++ b/docs/framework/data/adonet/sql/polling-in-console-applications.md
@@ -0,0 +1,203 @@
+---
+title: "コンソール アプリケーションでのポーリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ff084d5-5956-4db1-8e18-c5a66b000882
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# コンソール アプリケーションでのポーリング
+ADO.NET での非同期操作は、1 つのスレッドで他のタスクを実行している間に、別のスレッドで時間のかかるデータベース操作を開始できます。  ただし、ほとんどの場合、データベース操作が完了するまでは、アプリケーションを続行できない状態に最終的に達することになります。  このような場合は、操作が完了したかどうかを確認するために、非同期操作をポーリングすると便利です。  
+  
+ <xref:System.IAsyncResult.IsCompleted%2A> プロパティを使用して、操作が完了したかどうかを確認できます。  
+  
+## 例  
+ 次のコンソール アプリケーションは、操作を非同期に実行して、**AdventureWorks** サンプル データベース内のデータを更新します。  長時間にわたるプロセスをエミュレートするために、この例では、コマンド テキスト内に WAITFOR ステートメントを挿入します。  通常は、コマンドの実行を遅くする必要はありませんが、非同期動作の例をわかりやすく示すために、この場合はあえて遅くしています。  
+  
+ \[Visual Basic\]  
+  
+```  
+Imports System  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+  
+    Sub Main()  
+        ' The WAITFOR statement simply adds enough time to prove the   
+        ' asynchronous nature of the command.  
+        Dim commandText As String = _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint + 1 " & _  
+         "WHERE ReorderPoint Is Not Null;" & _  
+         "WAITFOR DELAY '0:0:3';" & _  
+         "UPDATE Production.Product " & _  
+         "SET ReorderPoint = ReorderPoint - 1 " & _  
+         "WHERE ReorderPoint Is Not Null"  
+  
+        RunCommandAsynchronously(commandText, GetConnectionString())  
+  
+        Console.WriteLine("Press Enter to continue.")  
+        Console.ReadLine()  
+    End Sub  
+  
+    Private Sub RunCommandAsynchronously( _  
+     ByVal commandText As String, ByVal connectionString As String)  
+  
+        ' Given command text and connection string, asynchronously   
+        ' execute the specified command against the connection. For   
+        ' this example, the code displays an indicator as it's working,   
+        ' verifying the asynchronous behavior.   
+        Using connection As New SqlConnection(connectionString)  
+            Try  
+                Dim count As Integer = 0  
+                Dim command As New SqlCommand(commandText, connection)  
+                connection.Open()  
+                Dim result As IAsyncResult = _  
+                 command.BeginExecuteNonQuery()  
+                While Not result.IsCompleted  
+                    Console.WriteLine("Waiting ({0})", count)  
+                    ' Wait for 1/10 second, so the counter  
+                    ' doesn't consume all available resources   
+                    ' on the main thread.  
+                    Threading.Thread.Sleep(100)  
+                    count += 1  
+                End While  
+                Console.WriteLine( _  
+                 "Command complete. Affected {0} rows.", _  
+                 command.EndExecuteNonQuery(result))  
+            Catch ex As SqlException  
+                Console.WriteLine("Error ({0}): {1}", _  
+                 ex.Number, ex.Message)  
+            Catch ex As InvalidOperationException  
+                Console.WriteLine("Error: {0}", ex.Message)  
+            Catch ex As Exception  
+                ' You might want to pass these errors  
+                ' back out to the caller.  
+                Console.WriteLine("Error: {0}", ex.Message)  
+            End Try  
+        End Using  
+    End Sub  
+  
+    Private Function GetConnectionString() As String  
+        ' To avoid storing the connection string in your code,              
+        ' you can retrieve it from a configuration file.   
+  
+        ' If you have not included "Asynchronous Processing=true"   
+        ' in the connection string, the command will not be able  
+        ' to execute asynchronously.  
+        Return "Data Source=(local);Integrated Security=SSPI;" & _  
+          "Initial Catalog=AdventureWorks; " & _  
+          "Asynchronous Processing=true"  
+    End Function  
+End Module   
+```  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+class Class1  
+{  
+    [STAThread]  
+    static void Main()  
+    {  
+        // The WAITFOR statement simply adds enough time to   
+        // prove the asynchronous nature of the command.  
+  
+        string commandText =  
+          "UPDATE Production.Product SET ReorderPoint = " +  
+          "ReorderPoint + 1 " +  
+          "WHERE ReorderPoint Is Not Null;" +  
+          "WAITFOR DELAY '0:0:3';" +  
+          "UPDATE Production.Product SET ReorderPoint = " +  
+          "ReorderPoint - 1 " +  
+          "WHERE ReorderPoint Is Not Null";  
+  
+        RunCommandAsynchronously(  
+            commandText, GetConnectionString());  
+  
+        Console.WriteLine("Press Enter to continue.");  
+        Console.ReadLine();  
+    }  
+  
+    private static void RunCommandAsynchronously(  
+      string commandText, string connectionString)  
+    {  
+        // Given command text and connection string, asynchronously  
+        // execute the specified command against the connection.   
+        // For this example, the code displays an indicator as it's   
+        // working, verifying the asynchronous behavior.   
+        using (SqlConnection connection =  
+          new SqlConnection(connectionString))  
+        {  
+            try  
+            {  
+                int count = 0;  
+                SqlCommand command =   
+                    new SqlCommand(commandText, connection);  
+                connection.Open();  
+  
+                IAsyncResult result =   
+                    command.BeginExecuteNonQuery();  
+                while (!result.IsCompleted)  
+                {  
+                    Console.WriteLine(  
+                                    "Waiting ({0})", count++);  
+                    // Wait for 1/10 second, so the counter  
+                    // doesn't consume all available   
+                    // resources on the main thread.  
+                    System.Threading.Thread.Sleep(100);  
+                }  
+                Console.WriteLine(  
+                    "Command complete. Affected {0} rows.",  
+                command.EndExecuteNonQuery(result));  
+            }  
+            catch (SqlException ex)  
+            {  
+                Console.WriteLine("Error ({0}): {1}",   
+                    ex.Number, ex.Message);  
+            }  
+            catch (InvalidOperationException ex)  
+            {  
+                Console.WriteLine("Error: {0}", ex.Message);  
+            }  
+            catch (Exception ex)  
+            {  
+                // You might want to pass these errors  
+                // back out to the caller.  
+                Console.WriteLine("Error: {0}", ex.Message);  
+            }  
+        }  
+    }  
+  
+    private static string GetConnectionString()  
+    {  
+        // To avoid storing the connection string in your code,              
+        // you can retrieve it from a configuration file.   
+  
+        // If you have not included "Asynchronous Processing=true"  
+        // in the connection string, the command will not be able  
+        // to execute asynchronously.  
+        return "Data Source=(local);Integrated Security=SSPI;" +  
+        "Initial Catalog=AdventureWorks; " +   
+        "Asynchronous Processing=true";  
+    }  
+}  
+```  
+  
+## 参照  
+ [非同期操作](../../../../../docs/framework/data/adonet/sql/asynchronous-operations.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/provider-statistics-for-sql-server.md b/docs/framework/data/adonet/sql/provider-statistics-for-sql-server.md
new file mode 100644
index 00000000000..f87e3bafe51
--- /dev/null
+++ b/docs/framework/data/adonet/sql/provider-statistics-for-sql-server.md
@@ -0,0 +1,349 @@
+---
+title: "SQL Server のプロバイダー統計情報 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 429c9d09-92ac-46ec-829a-fbff0a9575a2
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server のプロバイダー統計情報
+.NET Framework version 2.0 以降では、.NET Framework Data Provider for SQL Server によって実行時の統計がサポートされています。  統計情報を有効にするには、有効な接続オブジェクトを作成した後で、<xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.StatisticsEnabled%2A> プロパティを `True` に設定する必要があります。  統計情報が有効にされると、<xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.RetrieveStatistics%2A> メソッドを通じて <xref:System.Collections.IDictionary> 参照を取得することにより、"時間単位のスナップショット" として統計情報を確認できます。  名前と値がペアになったディクショナリ エントリのセットとして、一覧を列挙します。  これらの名前と値のペアは順序付けられていません。  いつでも <xref:System.Data.SqlClient.SqlConnection> オブジェクトの <xref:System.Data.SqlClient.SqlConnection.ResetStatistics%2A> メソッドを呼び出して、カウンターをリセットすることができます。  統計情報収集が有効になっていない場合、例外は生成されません。  また、<xref:System.Data.SqlClient.SqlConnection.StatisticsEnabled%2A> が最初に呼び出されるずに <xref:System.Data.SqlClient.SqlConnection.RetrieveStatistics%2A> が呼び出されると、取得される値は各エントリの初期値になります。  統計情報を有効にしてからアプリケーションをしばらく実行した後で統計情報を無効にした場合、取得される値には、統計情報が無効にされた時点までに収集された値が含まれます。  すべての統計情報の値は、接続ごとに収集されます。  
+  
+## 使用できる統計情報の値  
+ 現在、Microsoft SQL Server プロバイダーから使用できる項目は 18 種類あります。  使用できる項目の数を確認するには、<xref:System.Data.SqlClient.SqlConnection.RetrieveStatistics%2A> により返される <xref:System.Collections.IDictionary> インターフェイス参照の **Count** プロパティを使用します。  プロバイダーの統計情報のカウンターはすべて、64 ビット幅である共通言語ランタイムの <xref:System.Int64> 型 \(C\# と Visual Basic の場合は **long**\) を使用します。  **int64** データ型の最大値は、**int64.MaxValue** フィールドによって定義されているように、\(\(2^63\)\-1\)\) です。  カウンターの値がこの最大値に達すると、これ以降カウンターは正確ではないと見なされます。  つまり、**int64.MaxValue**\-1 \(\(2^63\)\-2\) は、事実上、すべての統計情報について有効な値の最大値になります。  
+  
+> [!NOTE]
+>  プロバイダーの統計情報を返すためにディクショナリが使用されているのは、返される統計情報の数値、名前、および順序が今後変更される可能性があるためです。  アプリケーションでは、ディクショナリ内で見つかった特定の値に依存する必要はありませんが、値が存在するかどうかや、この値に応じて分岐させるかどうかを確認する必要があります。  
+  
+ 次の表では、使用可能な現在の統計情報の値が説明されています。  個々の値のキー名は、Microsoft .NET Framework の地域別バージョン全体でローカライズされているわけではないことに注意してください。  
+  
+|キー名|説明|  
+|---------|--------|  
+|`BuffersReceived`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後にプロバイダーが SQL Server から受け取る、表形式のデータ ストリーム \(TDS\) パケットの数を返します。|  
+|`BuffersSent`|統計情報が有効になった後に、プロバイダーにより SQL Server に送信された TDS パケットの数を返します。  大量の処理を伴うコマンドでは、複数のバッファーが必要になります。  たとえば、大きなコマンドがサーバーに送信され、6 つのパケットが必要になる場合は、`ServerRoundtrips` は 1 だけインクリメントされ、`BuffersSent` は 6 だけインクリメントされます。|  
+|`BytesReceived`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後にプロバイダーが SQL Server から受け取る、TDS パケット内のデータのバイト数を返します。|  
+|`BytesSent`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に TDS パケット内の SQL Server に送信される、データのバイト数を返します。|  
+|`ConnectionTime`|統計情報が有効になった後に接続が開かれている時間 \(ミリ秒\) を示します \(接続が開かれる前に統計情報が有効になっていた場合は、合計接続時間を示します\)。|  
+|`CursorOpens`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて行われた、カーソルが開かれた回数を返します。<br /><br /> SELECT ステートメントにより返される読み取り専用\/前方参照専用の結果は、カーソルが考慮されないため、このカウンターには影響しません。|  
+|`ExecutionTime`|統計情報が有効になってから、プロバイダーが処理に費やした累計時間 \(ミリ秒\) を返します。この時間には、サーバーからの応答を待つために費やされた時間と、プロバイダー自体がコードを実行するために費やした時間が含まれます。<br /><br /> タイミング コードが含まれるクラスは次のとおりです。<br /><br /> SqlConnection<br /><br /> SqlCommand<br /><br /> SqlDataReader<br /><br /> SqlDataAdapter<br /><br /> SqlTransaction<br /><br /> SqlCommandBuilder<br /><br /> パフォーマンスが重視されるメンバーをできるだけ小規模に保つため、次のメンバーは時刻指定されません。<br /><br /> SqlDataReader<br /><br /> this\[\] operator \(all overloads\)<br /><br /> GetBoolean<br /><br /> GetChar<br /><br /> GetDateTime<br /><br /> GetDecimal<br /><br /> GetDouble<br /><br /> GetFloat<br /><br /> GetGuid<br /><br /> GetInt16<br /><br /> GetInt32<br /><br /> GetInt64<br /><br /> GetName<br /><br /> GetOrdinal<br /><br /> GetSqlBinary<br /><br /> GetSqlBoolean<br /><br /> GetSqlByte<br /><br /> GetSqlDateTime<br /><br /> GetSqlDecimal<br /><br /> GetSqlDouble<br /><br /> GetSqlGuid<br /><br /> GetSqlInt16<br /><br /> GetSqlInt32<br /><br /> GetSqlInt64<br /><br /> GetSqlMoney<br /><br /> GetSqlSingle<br /><br /> GetSqlString<br /><br /> GetString<br /><br /> IsDBNull|  
+|`IduCount`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて実行された、INSERT、DELETE、および UPDATE ステートメントの合計数を返します。|  
+|`IduRows`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて実行された INSERT、DELETE、および UPDATE ステートメントにより影響を受けた、行の合計数を返します。|  
+|`NetworkServerTime`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後にプロバイダーがサーバーからの応答を待つために費やした累計時間 \(ミリ秒\) を返します。|  
+|`PreparedExecs`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて実行された、準備コマンドの数を返します。|  
+|`Prepares`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて準備された、ステートメントの数を返します。|  
+|`SelectCount`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて実行された、SELECT ステートメントの数を返します。  これには、カーソルから行を取得するための FETCH ステートメントが含まれます。SELECT ステートメントのカウントは、<xref:System.Data.SqlClient.SqlDataReader> の末尾に達すると更新されます。|  
+|`SelectRows`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に選択された、行の数を返します。  このカウンターは、実際には呼び出し元により使用されなかった行を含め、SQL ステートメントにより生成されたすべての行を反映します。  たとえば、結果セット全体を読み取る前にデータ リーダーを閉じても、カウントには影響しません。  これには、FETCH ステートメントを通じてカーソルから取得された行が含まれます。|  
+|`ServerRoundtrips`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に発生した、接続がサーバーにコマンドを送信して応答を受け取った回数を返します。|  
+|`SumResultSets`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に使用された、結果セットの数を返します。  たとえば、これにはクライアントに返されるすべての結果セットが含まれます。  カーソルについては、それぞれのフェッチ操作やブロック フェッチ操作は、単独の結果セットと見なされます。|  
+|`Transactions`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に開始された、ユーザー トランザクションの数を返します。これにはロールバックが含まれます。  自動コミットがオンの状態で接続が実行されている場合、各コマンドはトランザクションと見なされます。<br /><br /> このカウンターは、トランザクションがコミットされるかどうか、または後にロール バックされるかどうかに関係なく、BEGIN TRAN ステートメントが実行された直後に、トランザクション カウントをインクリメントします。|  
+|`UnpreparedExecs`|アプリケーションがプロバイダーを使って開始され、統計情報が有効になった後に接続を通じて準備解除された、ステートメントの数を返します。|  
+  
+### 値の取得  
+ 次のコンソール アプリケーションは、接続で統計情報を有効にして、4 つの各統計情報の値を取得し、コンソール ウィンドウに出力する方法を示します。  
+  
+> [!NOTE]
+>  次の例では、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] に含まれるサンプルの **AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```vb  
+Option Strict On  
+  
+Imports System  
+Imports System.Collections  
+Imports System.Data  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+  
+  Sub Main()  
+    Dim connectionString As String = GetConnectionString()  
+  
+    Using awConnection As New SqlConnection(connectionString)  
+      ' StatisticsEnabled is False by default.  
+      ' It must be set to True to start the   
+      ' statistic collection process.  
+      awConnection.StatisticsEnabled = True  
+  
+      Dim productSQL As String = "SELECT * FROM Production.Product"  
+      Dim productAdapter As _  
+          New SqlDataAdapter(productSQL, awConnection)  
+  
+      Dim awDataSet As New DataSet()  
+  
+      awConnection.Open()  
+  
+      productAdapter.Fill(awDataSet, "ProductTable")  
+  
+      ' Retrieve the current statistics as  
+      ' a collection of values at this point  
+      ' and time.  
+      Dim currentStatistics As IDictionary = _  
+          awConnection.RetrieveStatistics()  
+  
+      Console.WriteLine("Total Counters: " & _  
+          currentStatistics.Count.ToString())  
+      Console.WriteLine()  
+  
+      ' Retrieve a few individual values  
+      ' related to the previous command.  
+      Dim bytesReceived As Long = _  
+          CLng(currentStatistics.Item("BytesReceived"))  
+      Dim bytesSent As Long = _  
+          CLng(currentStatistics.Item("BytesSent"))  
+      Dim selectCount As Long = _  
+          CLng(currentStatistics.Item("SelectCount"))  
+      Dim selectRows As Long = _  
+          CLng(currentStatistics.Item("SelectRows"))  
+  
+      Console.WriteLine("BytesReceived: " & bytesReceived.ToString())  
+      Console.WriteLine("BytesSent: " & bytesSent.ToString())  
+      Console.WriteLine("SelectCount: " & selectCount.ToString())  
+      Console.WriteLine("SelectRows: " & selectRows.ToString())  
+  
+      Console.WriteLine()  
+      Console.WriteLine("Press any key to continue")  
+      Console.ReadLine()  
+    End Using  
+  
+  End Sub  
+  
+  Function GetConnectionString() As String  
+    ' To avoid storing the connection string in your code,  
+    ' you can retrive it from a configuration file.  
+    Return "Data Source=localhost;Integrated Security=SSPI;" & _  
+      "Initial Catalog=AdventureWorks"  
+  End Function  
+End Module  
+```  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.Collections;  
+using System.Collections.Generic;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+namespace CS_Stats_Console_GetValue  
+{  
+  class Program  
+  {  
+    static void Main(string[] args)  
+    {  
+      string connectionString = GetConnectionString();  
+  
+      using (SqlConnection awConnection =   
+        new SqlConnection(connectionString))  
+      {  
+        // StatisticsEnabled is False by default.  
+        // It must be set to True to start the   
+        // statistic collection process.  
+        awConnection.StatisticsEnabled = true;  
+  
+        string productSQL = "SELECT * FROM Production.Product";  
+        SqlDataAdapter productAdapter =   
+          new SqlDataAdapter(productSQL, awConnection);  
+  
+        DataSet awDataSet = new DataSet();  
+  
+        awConnection.Open();  
+  
+        productAdapter.Fill(awDataSet, "ProductTable");  
+        // Retrieve the current statistics as  
+        // a collection of values at this point  
+        // and time.  
+        IDictionary currentStatistics =  
+          awConnection.RetrieveStatistics();  
+  
+        Console.WriteLine("Total Counters: " +  
+          currentStatistics.Count.ToString());  
+        Console.WriteLine();  
+  
+        // Retrieve a few individual values  
+        // related to the previous command.  
+        long bytesReceived =  
+            (long) currentStatistics["BytesReceived"];  
+        long bytesSent =  
+            (long) currentStatistics["BytesSent"];  
+        long selectCount =  
+            (long) currentStatistics["SelectCount"];  
+        long selectRows =  
+            (long) currentStatistics["SelectRows"];  
+  
+        Console.WriteLine("BytesReceived: " +  
+            bytesReceived.ToString());  
+        Console.WriteLine("BytesSent: " +  
+            bytesSent.ToString());  
+        Console.WriteLine("SelectCount: " +  
+            selectCount.ToString());  
+        Console.WriteLine("SelectRows: " +  
+            selectRows.ToString());  
+  
+        Console.WriteLine();  
+        Console.WriteLine("Press any key to continue");  
+        Console.ReadLine();  
+      }  
+  
+    }  
+    private static string GetConnectionString()  
+    {  
+      // To avoid storing the connection string in your code,  
+      // you can retrive it from a configuration file.  
+      return "Data Source=localhost;Integrated Security=SSPI;" +   
+        "Initial Catalog=AdventureWorks";  
+    }  
+  }  
+}  
+```  
+  
+### すべての値の取得  
+ 次のコンソール アプリケーションは、接続で統計情報を有効にし、使用可能なすべての統計情報の値を列挙子を使って取得して、コンソール ウィンドウに出力する方法を示します。  
+  
+> [!NOTE]
+>  次の例では、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] に含まれるサンプルの **AdventureWorks** データベースを使用します。  サンプル コードの接続文字列は、データベースがローカルのコンピューターにインストールされて利用可能な状態になっていることを前提としています。  必要に応じて、お使いの環境に合わせて接続文字列を変更してください。  
+  
+```vb  
+Option Strict On  
+  
+Imports System  
+Imports System.Collections  
+Imports System.Data  
+Imports System.Data.SqlClient  
+  
+Module Module1  
+  Sub Main()  
+    Dim connectionString As String = GetConnectionString()  
+  
+    Using awConnection As New SqlConnection(connectionString)  
+      ' StatisticsEnabled is False by default.  
+      ' It must be set to True to start the   
+      ' statistic collection process.  
+      awConnection.StatisticsEnabled = True  
+  
+      Dim productSQL As String = "SELECT * FROM Production.Product"  
+      Dim productAdapter As _  
+          New SqlDataAdapter(productSQL, awConnection)  
+  
+      Dim awDataSet As New DataSet()  
+  
+      awConnection.Open()  
+  
+      productAdapter.Fill(awDataSet, "ProductTable")  
+  
+      ' Retrieve the current statistics as  
+      ' a collection of values at this point  
+      ' and time.  
+      Dim currentStatistics As IDictionary = _  
+          awConnection.RetrieveStatistics()  
+  
+      Console.WriteLine("Total Counters: " & _  
+          currentStatistics.Count.ToString())  
+      Console.WriteLine()  
+  
+      Console.WriteLine("Key Name and Value")  
+  
+      ' Note the entries are unsorted.  
+      For Each entry As DictionaryEntry In currentStatistics  
+        Console.WriteLine(entry.Key.ToString() & _  
+            ": " & entry.Value.ToString())  
+      Next  
+  
+      Console.WriteLine()  
+      Console.WriteLine("Press any key to continue")  
+      Console.ReadLine()  
+    End Using  
+  
+  End Sub  
+  
+  Function GetConnectionString() As String  
+    ' To avoid storing the connection string in your code,  
+    ' you can retrive it from a configuration file.  
+    Return "Data Source=localhost;Integrated Security=SSPI;" & _  
+      "Initial Catalog=AdventureWorks"  
+  End Function  
+End Module  
+```  
+  
+```csharp  
+using System;  
+using System.Collections;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+namespace CS_Stats_Console_GetAll  
+{  
+  class Program  
+  {  
+    static void Main(string[] args)  
+    {  
+      string connectionString = GetConnectionString();  
+  
+      using (SqlConnection awConnection =   
+        new SqlConnection(connectionString))  
+      {  
+        // StatisticsEnabled is False by default.  
+        // It must be set to True to start the   
+        // statistic collection process.  
+        awConnection.StatisticsEnabled = true;  
+  
+        string productSQL = "SELECT * FROM Production.Product";  
+        SqlDataAdapter productAdapter =  
+            new SqlDataAdapter(productSQL, awConnection);  
+  
+        DataSet awDataSet = new DataSet();  
+  
+        awConnection.Open();  
+  
+        productAdapter.Fill(awDataSet, "ProductTable");  
+  
+        // Retrieve the current statistics as  
+        // a collection of values at this point  
+        // and time.  
+        IDictionary currentStatistics =  
+            awConnection.RetrieveStatistics();  
+  
+        Console.WriteLine("Total Counters: " +  
+            currentStatistics.Count.ToString());  
+        Console.WriteLine();  
+  
+        Console.WriteLine("Key Name and Value");  
+  
+        // Note the entries are unsorted.  
+        foreach (DictionaryEntry entry in currentStatistics)  
+        {  
+          Console.WriteLine(entry.Key.ToString() +  
+              ": " + entry.Value.ToString());  
+        }  
+  
+        Console.WriteLine();  
+        Console.WriteLine("Press any key to continue");  
+        Console.ReadLine();  
+      }  
+  
+    }  
+    private static string GetConnectionString()  
+    {  
+      // To avoid storing the connection string in your code,  
+      // you can retrive it from a configuration file.  
+      return "Data Source=localhost;Integrated Security=SSPI;" +   
+        "Initial Catalog=AdventureWorks";  
+    }  
+  }  
+}  
+```  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/query-notifications-in-sql-server.md b/docs/framework/data/adonet/sql/query-notifications-in-sql-server.md
new file mode 100644
index 00000000000..75667e624eb
--- /dev/null
+++ b/docs/framework/data/adonet/sql/query-notifications-in-sql-server.md
@@ -0,0 +1,73 @@
+---
+title: "SQL Server のクエリ通知 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f0ba1a1-3180-4af8-87f7-c795dc8f8f55
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server のクエリ通知
+クエリ通知は Service Broker インフラストラクチャに基づいて構築されており、データが変更されたときにクエリ通知を使用してアプリケーションに通知できます。  この機能は、Web アプリケーションなど、データベースから情報のキャッシュを提供し、ソース データが変更された場合に通知を必要とするアプリケーションに特に役立ちます。  
+  
+ ADO.NET を使用してクエリ通知機能を実装する方法は 3 つあります。  
+  
+1.  基本レベルの実装は、`SqlNotificationRequest` クラスによって行われます。これによってサーバー側の機能が公開され、通知要求を伴うコマンドを実行できます。  
+  
+2.  高レベルの実装は、`SqlDependency` クラスによって行われます。このクラスでは、ソース アプリケーションと SQL Server 間の通知機能が高度に抽象化され、その依存関係を使用してサーバー内の変更を検出することができます。  マネージ クライアント アプリケーションが .NET Framework Data Provider for SQL Server を使用して SQL Server の通知機能を活用するには、ほとんどの場合、これが最も簡単かつ効果的な方法です。  
+  
+3.  さらに、ASP.NET 2.0 以降を使用して構築された Web アプリケーションでは、`SqlCacheDependency` ヘルパー クラスを使用できます。  
+  
+ クエリ通知は、基になるデータの変更に応じて表示またはキャッシュを更新する必要があるアプリケーションで使用されます。  Microsoft SQL Server では、最初に取得したものと異なる結果セットが同じコマンドで得られた場合には、.NET Framework アプリケーションから SQL Server にコマンドを送信して通知を要求することができます。  サーバーで生成された通知は、キューを通じて送信された後に処理されます。  
+  
+ 通知は SELECT ステートメントおよび EXECUTE ステートメントに対して設定できます。  EXECUTE ステートメントを使用した場合、SQL Server では、EXECUTE ステートメント自体ではなく、EXECUTE ステートメントで実行されたコマンドに対する通知が登録されます。  コマンドは、SELECT ステートメントの要件と制限を満たしている必要があります。  通知を登録するコマンドに複数のステートメントが含まれている場合、データベース エンジンによりバッチ内のステートメントごとに通知が作成されます。  
+  
+ データ変更時に、信頼できる即時の通知が必要なアプリケーションを開発している場合は、SQL Server オンライン ブックの「[通知の計画](http://go.microsoft.com/fwlink/?LinkId=211984)」の「**効率的なクエリ通知方法の計画**」および「**クエリ通知に代わる方法**」を参照してください。  クエリ通知と SQL Server Service Broker の詳細については、次の SQL Server オンライン ブックのトピックへのリンクを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+-   [クエリ通知の使用](http://msdn.microsoft.com/library/ms175110.aspx)  
+  
+-   [クエリ通知の作成](http://msdn.microsoft.com/library/ms181122.aspx)  
+  
+-   [開発 \(Service Broker\)](http://msdn.microsoft.com/library/bb522889.aspx)  
+  
+-   [Service Broker 開発者向けの情報](http://msdn.microsoft.com/library/ms166100.aspx)  
+  
+-   [開発者ガイド \(Service Broker\)](http://msdn.microsoft.com/library/bb522908.aspx)  
+  
+## このセクションの内容  
+ [クエリ通知の有効化](../../../../../docs/framework/data/adonet/sql/enabling-query-notifications.md)  
+ クエリ通知を有効にするための要件を含め、クエリ通知の使用方法について説明します。  
+  
+ [ASP.NET アプリケーションでの SqlDependency](../../../../../docs/framework/data/adonet/sql/sqldependency-in-an-aspnet-app.md)  
+ ASP.NET アプリケーションからクエリ通知を使用する方法について説明します。  
+  
+ [SqlDependency を使用した変更の検出](../../../../../docs/framework/data/adonet/sql/detecting-changes-with-sqldependency.md)  
+ 最初に取得された結果と異なるクエリ結果を検出する方法について説明します。  
+  
+ [SqlCommand の実行と SqlNotificationRequest](../../../../../docs/framework/data/adonet/sql/sqlcommand-execution-with-a-sqlnotificationrequest.md)  
+ クエリ通知を使用する <xref:System.Data.SqlClient.SqlCommand> オブジェクトの構成例を示します。  
+  
+## 関連項目  
+ <xref:System.Data.Sql.SqlNotificationRequest>  
+ <xref:System.Data.Sql.SqlNotificationRequest> クラスおよびそのすべてのメンバーについて説明します。  
+  
+ <xref:System.Data.SqlClient.SqlDependency>  
+ <xref:System.Data.SqlClient.SqlDependency> クラスおよびそのすべてのメンバーについて説明します。  
+  
+ <xref:System.Web.Caching.SqlCacheDependency>  
+ <xref:System.Web.Caching.SqlCacheDependency> クラスおよびそのすべてのメンバーについて説明します。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md b/docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md
new file mode 100644
index 00000000000..a7fcfa29aa6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/server-and-database-roles-in-sql-server.md
@@ -0,0 +1,77 @@
+---
+title: "SQL Server のサーバー ロールとデータベース ロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5482dfdb-e498-4614-8652-b174829eed13
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# SQL Server のサーバー ロールとデータベース ロール
+SQL Server では、すべてのバージョンで、個々のユーザーではなくロール \(つまり、ユーザーのグループ\) に対して権限を割り当てることのできるロール ベースのセキュリティが使用されています。  固定サーバー ロールおよび固定データベース ロールには、固定された一連の権限が割り当てられています。  
+  
+## 固定サーバー ロール  
+ 固定サーバー ロールは、固定された一連の権限とサーバー規模のスコープを持ちます。  SQL Server の管理を目的としており、このロールに割り当てられた権限を変更することはできません。  固定サーバー ロールには、データベースにユーザー アカウントがなくても、ログインを割り当てることができます。  
+  
+> [!IMPORTANT]
+>  `sysadmin` 固定サーバー ロールは他のすべてのロールを内包し、無制限のスコープを持ちます。  本当に信頼できる場合以外は、このロールにプリンシパルを追加することは避けてください。  `sysadmin` ロールのメンバーには、サーバーのすべてのデータベースおよびリソースに対する取り消し不可能な管理特権が与えられます。  
+  
+ 固定サーバー ロールに追加するユーザーは慎重に選ぶ必要があります。  たとえば、`bulkadmin` ロールでは、ユーザーがローカル ファイルの内容をテーブルに挿入できるため、データの整合性が損なわれる可能性があります。  固定サーバー ロールと権限を網羅した一覧については、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックを参照してください。  
+  
+## 固定データベース ロール  
+ 固定データベース ロールには、権限のグループを簡単に管理できるように、あらかじめ定義された一連の権限が割り当てられています。  `db_owner` ロールのメンバーは、データベースに対するすべての構成作業とメンテナンス作業を実行できます。  
+  
+ SQL Server の定義済みロールの詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[サーバーレベルのロール](http://msdn.microsoft.com/library/ms188659.aspx)」および「[固定サーバー ロールの権限 \(データベース エンジン\)](http://msdn.microsoft.com/library/ms175892.aspx)」|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の固定サーバー ロールおよびそれに関連付けられている権限について説明します。|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[データベースレベルのロール](http://msdn.microsoft.com/library/ms189121.aspx)」および「[固定データベース ロールの権限 \(データベース エンジン\)](http://msdn.microsoft.com/library/ms189612.aspx)」|固定データベース ロールおよびそれに関連付けられている権限について説明します。|  
+  
+## データベース ロールおよびユーザー  
+ データベース ユーザー アカウントはデータベース オブジェクトを扱う関係上、ログインにマップされている必要があります。  データベース ユーザーをデータベース ロールに追加すると、そのロールに関連付けられたすべての権限セットが継承されます。  すべての権限を付与できます。  
+  
+ アプリケーションのセキュリティを計画する際は、`public` ロール、`dbo` ユーザー アカウント、および `guest` アカウントも考慮する必要があります。  
+  
+### public ロール  
+ `public` ロールは、システム データベースを含め、すべてのデータベースに存在します。  このロールは削除できません。また、ユーザーを追加したり削除したりすることもできません。  他のすべてのユーザーおよびロールは既定で `public` ロールに所属するため、`public` ロールに付与された権限を継承します。  `public` には、すべてのユーザーに割り当てる必要のある権限だけを付与してください。  
+  
+### dbo ユーザー アカウント  
+ `dbo` \(データベース所有者\) は、データベースのすべてのアクティビティを実行する暗黙権限を持ったユーザー アカウントです。  `sysadmin` 固定サーバー ロールのメンバーは、自動的に `dbo` にマップされます。  
+  
+> [!NOTE]
+>  `dbo` はスキーマの名前としても使用されています。詳細については、「[SQL Server における所有権とユーザーとスキーマの分離](../../../../../docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md)」を参照してください。  
+  
+ `dbo` ユーザー アカウントは、よく `db_owner` 固定データベース ロールと混同されます。  `sysadmin` のスコープがサーバー全体であるのに対し、`db_owner` のスコープはデータベースです。  `db_owner` ロールのメンバーであるからといって、`dbo` のユーザー権限があるとは限りません。  
+  
+### guest ユーザー アカウント  
+ 認証されて SQL Server のインスタンスへのログインが許可されたユーザーが、その後、データベースにアクセスするためには各データベースに別個のユーザー アカウントが存在している必要があります。  データベースごとにユーザー アカウントが要求されるため、SQL Server のインスタンスに接続したとしても、ユーザーは、サーバー上のすべてのデータベースにアクセスできるわけではありません。  この要件を回避するには、データベースに `guest` ユーザー アカウントを設定します。guest ユーザーは、データベースにユーザー アカウントがなくてもデータベースにログインしてアクセスできます。  
+  
+ `guest` アカウントは、SQL Server のすべてのバージョンが備えている組み込みのアカウントです。  新しいデータベースでは、既定で無効化されています。  このアカウントを有効にした場合でも、Transact\-SQL の REVOKE CONNECT FROM GUEST ステートメントを実行して、CONNECT 権限を取り消すことによって無効にできます。  
+  
+> [!IMPORTANT]
+>  `guest` アカウントはできるだけ使用しないようにしてください。ユーザーごとに割り当てられたデータベース権限がなくても、すべてのログイン ユーザーが、このアカウントに付与されているデータベース権限を取得できるようになります。  `guest` アカウントを使用する必要がある場合は、最小限の権限を付与するようにしてください。  
+  
+ SQL Server のログイン、ユーザー、およびロールの詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[ID およびアクセス制御 \(データベース エンジン\)](http://msdn.microsoft.com/library/bb510418.aspx)」|プリンシパル、ロール、資格情報、セキュリティ保護可能なリソース、および権限について説明したトピックへのリンクが含まれています。|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[プリンシパル \(データベース エンジン\)](http://msdn.microsoft.com/library/ms181127.aspx)」|プリンシパルの説明のほか、サーバー ロールとデータベース ロールについて説明したトピックへのリンクが含まれています。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [認証](../../../../../docs/framework/data/adonet/sql/authentication-in-sql-server.md)   
+ [SQL Server における所有権とユーザーとスキーマの分離](../../../../../docs/framework/data/adonet/sql/ownership-and-user-schema-separation-in-sql-server.md)   
+ [SQL Server の承認とアクセス許可](../../../../../docs/framework/data/adonet/sql/authorization-and-permissions-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md b/docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md
new file mode 100644
index 00000000000..afa4fa35d89
--- /dev/null
+++ b/docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md
@@ -0,0 +1,61 @@
+---
+title: "SQL Server でのストアド プロシージャの署名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eeed752c-0084-48e5-9dca-381353007a0d
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server でのストアド プロシージャの署名
+証明書や非対称キーを使用してストアド プロシージャに署名することができます。  この機能は、動的 SQL などのように、組み合わせ所有権によって権限を継承できない場合や、組み合わせ所有権が壊れている場合を想定して用意されています。  証明書に割り当てられたユーザーを作成し、その証明書ユーザーにストアド プロシージャがアクセスする必要があるオブジェクトへの権限を与えることができます。  
+  
+ ストアド プロシージャが実行されると、証明書ユーザーの権限が呼び出し元の権限と組み合わされます。  EXECUTE AS 句とは異なり、プロシージャの実行コンテキストは変更されません。  ログイン名とユーザー名を返す組み込み関数を実行すると、証明書ユーザーの名前ではなく、呼び出し元の名前が返されます。  
+  
+ デジタル署名は、署名者の秘密キーで暗号化されたデータ ダイジェストです。  秘密キーにより、デジタル署名がその保持者または所有者に固有であることが保証されます。  ストアド プロシージャ、関数、またはトリガーに署名することができます。  
+  
+> [!NOTE]
+>  マスター データベースに証明書を作成することで、サーバー レベルの権限を許可できます。  
+  
+## 証明書の作成  
+ 証明書を使用してストアド プロシージャに署名すると、ストアド プロシージャのコードの暗号化ハッシュで構成されたデータ ダイジェストが秘密キーを使用して作成されます。  実行時に、このデータ ダイジェストが公開キーを使用して復号化され、ストアド プロシージャのハッシュ値と比較されます。  ストアド プロシージャに変更が加えられるとハッシュ値が無効になり、デジタル署名が一致しなくなります。  これによって、秘密キーにアクセスできない人物によってストアド プロシージャのコードが変更されることを防ぎます。  そのため、プロシージャを変更するたびに署名し直す必要があります。  
+  
+ モジュールへの署名は、次の 4 つの手順で行います。  
+  
+1.  Transact\-SQL ステートメント `CREATE CERTIFICATE [certificateName]` を使用して、証明書を作成します。  このステートメントには、開始日、終了日、パスワードを設定するためのオプションがあります。  既定の有効期限は 1 年間です。  
+  
+2.  Transact\-SQL ステートメント `CREATE USER [userName] FROM CERTIFICATE [certificateName]` を使用して、証明書に関連付けられたデータベース ユーザーを作成します。  このユーザーはデータベース内のみに存在し、ログインには関連付けられません。  
+  
+3.  証明書ユーザーに、データベース オブジェクトに対して必要な権限を与えます。  
+  
+> [!NOTE]
+>  証明書では、DENY ステートメントを使用して権限が取り消されているユーザーに権限を与えることはできません。  DENY は常に GRANT よりも優先されるため、証明書ユーザーに許可された権限を呼び出し元が継承することはできません。  
+  
+1.  Transact\-SQL ステートメント `ADD SIGNATURE TO [procedureName] BY CERTIFICATE [certificateName]` を使用して、証明書によってプロシージャに署名します。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server オンライン ブックの「[モジュールの署名](http://go.microsoft.com/fwlink/?LinkId=98590)」|モジュールの署名について説明し、サンプル シナリオと、関連する Transact\-SQL のトピックへのリンクを示します。|  
+|SQL Server オンライン ブックの「[チュートリアル : 証明書を使用したストアド プロシージャへの署名](http://msdn.microsoft.com/library/bb283630.aspx)」|証明書を使用したストアド プロシージャの署名のチュートリアルです。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)   
+ [SQL Server での安全な動的 SQL の作成](../../../../../docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md)   
+ [SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)   
+ [ストアド プロシージャでのデータの変更](../../../../../docs/framework/data/adonet/modifying-data-with-stored-procedures.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/single-bulk-copy-operations.md b/docs/framework/data/adonet/sql/single-bulk-copy-operations.md
new file mode 100644
index 00000000000..c94859c7e62
--- /dev/null
+++ b/docs/framework/data/adonet/sql/single-bulk-copy-operations.md
@@ -0,0 +1,88 @@
+---
+title: "バルク コピー操作の単一実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e7ff0be-3f23-4996-a92c-bd54d65c3836
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# バルク コピー操作の単一実行
+SQL Server のバルク コピー操作を実行する簡単な方法は、データベースに対して単一操作を実行することです。  既定では、バルク コピー操作は分離された操作として実行されます。このコピー操作は非トランザクション方式で処理され、ロールバックできません。  
+  
+> [!NOTE]
+>  エラーの発生時に、バルク コピー処理の全部または一部をロールバックする必要がある場合は、<xref:System.Data.SqlClient.SqlBulkCopy> が管理するトランザクションを使用するか、または既存のトランザクション内でバルク コピー操作を実行できます。  **SqlBulkCopy** は、**System.Transactions** トランザクションに \(明示的または暗黙的に\) 接続が参加している場合は <xref:System.Transactions> も使用します。  
+>   
+>  詳細については、「[トランザクションとバルク コピー操作](../../../../../docs/framework/data/adonet/sql/transaction-and-bulk-copy-operations.md)」を参照してください。  
+  
+ 通常、バルク コピー操作の実行手順は次のようになります。  
+  
+1.  コピー元のサーバーに接続し、コピーするデータを取得します。  <xref:System.Data.IDataReader> オブジェクトまたは <xref:System.Data.DataTable> オブジェクトからデータを取得できる場合は、他のソースからデータを取得して利用することもできます。  
+  
+2.  コピー先のサーバーに接続します \(**SqlBulkCopy** を使用して接続を確立しない場合\)。  
+  
+3.  <xref:System.Data.SqlClient.SqlBulkCopy> オブジェクトを作成し、必要なプロパティを設定します。  
+  
+4.  バルク挿入操作の対象となるテーブルが示されるように **DestinationTableName** プロパティを設定します。  
+  
+5.  **WriteToServer** メソッドのいずれかを呼び出します。  
+  
+6.  オプションとして、プロパティを更新したり、必要に応じて **WriteToServer** をもう一度呼び出したりします。  
+  
+7.  <xref:System.Data.SqlClient.SqlBulkCopy.Close%2A> を呼び出すか、または `Using` ステートメント内にバルク コピー操作をラップします。  
+  
+> [!CAUTION]
+>  コピー元とコピー先の列のデータ型を一致させることをお勧めします。  データ型が一致していない場合、**SqlBulkCopy** は、<xref:System.Data.SqlClient.SqlParameter.Value%2A> によって採用されている規則を使用して、コピー元の値をコピー先のデータ型にそれぞれ変換しようとします。  この変換はパフォーマンスに影響を及ぼし、予期しないエラーが発生することもあります。  たとえば、`Double` データ型は、多くの場合 `Decimal` データ型に変換されますが、常にというわけではありません。  
+  
+## 例  
+ 次のコンソール アプリケーションでは、<xref:System.Data.SqlClient.SqlBulkCopy> クラスを使用してデータを読み込む方法について示しています。  この例では、<xref:System.Data.SqlClient.SqlDataReader> を使用し、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の **AdventureWorks** データベースに格納された **Production.Product** テーブルのデータを、同じデータベース内の同等のテーブルにコピーします。  
+  
+> [!IMPORTANT]
+>  このサンプルは、「[バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)」で説明しているように作業テーブルを作成してからでないと動作しません。  このコードでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の SQL Server インスタンス内に存在する場合、Transact\-SQL `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+ [!code-csharp[DataWorks BulkCopy.Single#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks BulkCopy.Single/CS/source.cs#1)]
+ [!code-vb[DataWorks BulkCopy.Single#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks BulkCopy.Single/VB/source.vb#1)]  
+  
+## Transact\-SQL および Command クラスを使用したバルク コピー操作の実行  
+ 次の例では、BULK INSERT ステートメントを実行する <xref:System.Data.SqlClient.SqlCommand.ExecuteNonQuery%2A> メソッドの使用方法を説明します。  
+  
+> [!NOTE]
+>  データ ソースのファイル パスはサーバーに対する相対パスです。  サーバー プロセスがこのパスにアクセスできないと、バルク コピー操作は失敗します。  
+  
+```vb  
+Using connection As SqlConnection = New SqlConnection(connectionString)  
+Dim queryString As String = _  
+    "BULK INSERT Northwind.dbo.[Order Details] FROM " & _  
+    "'f:\mydata\data.tbl' WITH (FORMATFILE='f:\mydata\data.fmt' )"  
+connection.Open()  
+SqlCommand command = New SqlCommand(queryString, connection);  
+  
+command.ExecuteNonQuery()  
+End Using  
+```  
+  
+```csharp  
+using (SqlConnection connection = New SqlConnection(connectionString))  
+{  
+string queryString =  "BULK INSERT Northwind.dbo.[Order Details] " +  
+    "FROM 'f:\mydata\data.tbl' " +  
+    "WITH ( FORMATFILE='f:\mydata\data.fmt' )";  
+connection.Open();  
+SqlCommand command = new SqlCommand(queryString, connection);  
+  
+command.ExecuteNonQuery();  
+}  
+```  
+  
+## 参照  
+ [SQL Server でのバルク コピー操作](../../../../../docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/snapshot-isolation-in-sql-server.md b/docs/framework/data/adonet/sql/snapshot-isolation-in-sql-server.md
new file mode 100644
index 00000000000..b980a9c644f
--- /dev/null
+++ b/docs/framework/data/adonet/sql/snapshot-isolation-in-sql-server.md
@@ -0,0 +1,150 @@
+---
+title: "SQL Server でのスナップショット分離 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 43ae5dd3-50f5-43a8-8d01-e37a61664176
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server でのスナップショット分離
+スナップショット分離により、OLTP アプリケーションの同時実行が向上しています。  
+  
+## スナップショット分離と行バージョン管理について  
+ スナップショット分離が有効になると、各トランザクションの更新された行のバージョン管理は、**tempdb** に保持されます。  一意のトランザクション シーケンス番号が各トランザクションを識別し、これらの一意の番号がそれぞれの行バージョン用に記録されます。  トランザクションは、シーケンス番号がトランザクションのシーケンス番号よりも前にある、最新の行バージョンを処理します。  トランザクションが開始された後で作成された最新の行バーションは、トランザクションにより無視されます。  
+  
+ "スナップショット" という用語は、トランザクション内のすべてのクエリが、トランザクションの開始時点のデータベースの状態に基づいて、データベースの同じバージョン、つまりスナップショットを参照するという事実を表しています。  ロックは、スナップショット トランザクション内の基になるデータ行やデータ ページでは取得されません。スナップショット トランザクションでは、先に開始されてまだ完了していないトランザクションによりブロックされることなく、他のトランザクションを実行できます。  データを変更するトランザクションは、データを読み取るトランザクションをブロックしません。また、データを読み取るトランザクションは、データを書き込むトランザクションをブロックしません。この理由は、通常、これらのトランザクションは SQL Server の既定の READ COMMITTED 分離レベルにあるためです。  また、ブロック不可の動作は、複雑なトランザクションのデッドロックの可能性を大幅に軽減します。  
+  
+ スナップショット分離では、オプティミスティック同時実行制御モデルを使用します。  スナップショット トランザクションは、トランザクションの開始後に変更されたデータに対して変更をコミットしようとすると、このトランザクションがロールバックし、エラーになります。  このエラーは、変更されるデータにアクセスする、SELECT ステートメントの UPDLOCK ヒントを使用することにより回避できます。  詳細については、SQL Server オンライン ブックの「ロックのヒント」を参照してください。  
+  
+ スナップショット分離は、トランザクション内で使用する前に、ALLOW\_SNAPSHOT\_ISOLATION ON データベース オプションを設定して有効にする必要があります。  これにより、行バージョンを一時データベース \(**tempdb**\) 内に保存するためのメカニズムがアクティブになります。  Transact\-SQL ALTER DATABASE ステートメントで使用する、各データベース内のスナップショット分離を有効にする必要があります。  この点では、スナップショット分離は、構成を必要としない READ COMMITTED、REPEATABLE READ、SERIALIZABLE、および READ UNCOMMITTED の従来の分離レベルとは異なります。  次のステートメントは、スナップショット分離をアクティブにして、既定の READ COMMITTED 動作を SNAPSHOT で置き換えます。  
+  
+```  
+ALTER DATABASE MyDatabase  
+SET ALLOW_SNAPSHOT_ISOLATION ON  
+  
+ALTER DATABASE MyDatabase  
+SET READ_COMMITTED_SNAPSHOT ON  
+```  
+  
+ READ\_COMMITTED\_SNAPSHOT ON オプションを設定すると、既定の READ COMMITTED 分離レベルの下にあるバージョン管理された行にアクセスできます。  READ\_COMMITTED\_SNAPSHOT オプションが OFF に設定されている場合、バージョン管理された行にアクセスするためには、各セッションのスナップショット分離レベルを明示的に設定する必要があります。  
+  
+## 分離レベルによる同時実行の管理  
+ Transact\-SQL ステートメントを実行する分離レベルは、ロック動作と行バージョン管理動作を決定します。  分離レベルには接続全体のスコープがあり、SET TRANSACTION ISOLATION LEVEL ステートメントで接続に設定されると、その接続が閉じられるか、別の分離レベルが設定されるまでは有効になります。  接続が閉じられてプールに返されると、最後の SET TRANSACTION ISOLATION LEVEL ステートメントからの分離レベルが保持されます。  それ以降、プールされた接続を再利用する接続では、その接続がプールされた時点で有効にされた分離レベルが使用されます。  
+  
+ 接続内で発行される個別のクエリには、接続の分離レベルに影響を与えることなく、1 つのステートメントまたはトランザクションの分離を変更するロック ヒントを含めることができます。  ストアド プロシージャまたは関数内で設定される分離レベルまたはロック ヒントは、これらを呼び出す接続の分離レベルを変更しません。また、分離レベルまたはロック ヒントは、ストアド プロシージャまたは関数呼び出しの間だけ有効になります。  
+  
+ SQL\-92 標準で定義された 4 つの分離レベルが、初期のバージョンの SQL Server ではサポートされていました。  
+  
+-   READ UNCOMMITTED は、他のトランザクションにより配置されたロックを無視するため、最も限定度が低い分離レベルです。  READ UNCOMMITTED の下で実行するトランザクションは、他のトランザクションによりまだコミットされていない、変更されたデータ値を読み取ることができます。これは "ダーティ" リードと呼ばれます。  
+  
+-   READ COMMITTED は、SQL Server の既定の分離レベルです。  この分離レベルは、別のトランザクションによりまだコミットされていない、変更されたデータ値を読み取れないようにステートメントを指定することにより、ダーティ リードを防ぎます。  その他のトランザクションは、現在のトランザクション内で各ステートメントが実行される合間にデータを変更、挿入、削除できますが、反復不可能読み取りや "ファントム" データになります。  
+  
+-   REPEATABLE READ は、READ COMMITTED よりも限定度が高い分離レベルです。  この分離レベルは、READ COMMITTED を含みます。さらに、現在のトランザクションをコミットするまでは、現在のトランザクションにより読み取られているデータを、他のトランザクションによって変更したり削除されたりしないようにします。  同時実行は、READ COMMITTED の場合よりも低くなります。この理由は、読み取りデータ上で共有されるロックが、各ステートメントが終了するごとに解放されず、トランザクションが完了するまで保持されるためです。  
+  
+-   SERIALIZABLE は、最も限定度の高い分離レベルで、トランザクションが完了するまで全範囲のキーをロックし、そのロックを保持します。  この分離レベルは、REPEATABLE READ を含みます。また、トランザクションが完了するまでは、トランザクションにより読み取られる範囲内に、他のトランザクションによって新しい行が挿入されないようにする制限を追加します。  
+  
+ 詳細については、SQL Server オンライン ブックの「分離レベル」を参照してください。  
+  
+### スナップショット分離レベルの拡張機能  
+ SQL Server では、SNAPSHOT 分離レベルの導入および READ COMMITTED の追加実装と共に、SQL\-92 分離レベルの拡張機能が導入されました。  READ\_COMMITTED\_SNAPSHOT 分離レベルは、すべてのトランザクションの READ COMMITTED を自動的に置き換えることができます。  
+  
+-   SNAPSHOT 分離は、トランザクション内で読み取るデータに、他の同時トランザクションによって加えられた変更が反映されないようにします。  トランザクションでは、トランザクションの開始時に存在するデータの行バージョンを使用します。  データの読み取り時にロックがデータに配置されないため、データを書き込まれないようにスナップショット トランザクションによって他のトランザクションがブロックされるというようなことはありません。  データを書き込むトランザクションは、スナップショット トランザクションによるデータの読み取りをブロックしません。  スナップショット分離を使用するには、ALLOW\_SNAPSHOT\_ISOLATION データベース オプションを設定してスナップショット分離を有効にする必要があります。  
+  
+-   READ\_COMMITTED\_SNAPSHOT データベース オプションは、スナップショット分離がデータベース内で有効になっている場合に、既定の READ COMMITTED 分離レベルの動作を決定します。  READ\_COMMITTED\_SNAPSHOT ON を明示的に指定していない場合、READ COMMITTED はすべての暗黙のトランザクションに適用されます。  これにより、READ\_COMMITTED\_SNAPSHOT OFF \(既定\) を設定した場合と同じ動作が生成されます。  READ\_COMMITTED\_SNAPSHOT OFF が有効になっている場合、データベース エンジンは共有ロックを使用して、既定の分離レベルを強制適用します。  READ\_COMMITTED\_SNAPSHOT データベース オプションが ON に設定されている場合、データベース エンジンは、ロックを使用してデータを保護せずに、既定として行バージョン管理とスナップショット分離を使用します。  
+  
+## スナップショット分離と行バージョン管理の機能について  
+ SNAPSHOT 分離レベルが有効になっている場合、行が更新されるたびに、SQL Server データベース エンジンは **tempdb** 内の元の行のコピーを保存し、行にトランザクション シーケンス番号を追加します。  発生するイベントのシーケンスは次のとおりです。  
+  
+-   新しいトランザクションが開始され、トランザクション シーケンス番号が割り当てられます。  
+  
+-   データベース エンジンは、トランザクション内の行を読み取り、トランザクション シーケンス番号より小さくて、トランザクション シーケンス番号に最も近いシーケンス番号の行バージョンを、**tempdb** から取得します。  
+  
+-   データベース エンジンは、スナップショット トランザクションの開始時点でアクティブだったコミットされていないトランザクションのトランザクション シーケンス番号の一覧内に、トランザクション シーケンス番号があるかどうかを確認します。  
+  
+-   トランザクションは、トランザクションの開始時点で最新だった **tempdb** から、行のバージョンを読み取ります。  トランザクションが開始された後で挿入された新しい行は、シーケンス番号の値がトランザクション シーケンス番号の値よりも大きくなるため確認されません。  
+  
+-   現在のトランザクションは、トランザクションの開始後に削除された行を確認します。この理由は、トランザクション シーケンス番号より小さいシーケンス番号の値を持つ行バージョンが **tempdb** 内に存在する可能性があるためです。  
+  
+ スナップショット分離の適用により、トランザクションは、基になるテーブル上でロックを受け付けたり配置したりすることなく、トランザクションの開始時に存在したすべてのデータを確認します。  その結果、競合がある状況でパフォーマンスが向上することになります。  
+  
+ スナップショット トランザクションでは、他のトランザクションによって行が更新されないようにするロックは使用せずに、常にオプティミスティック同時実行制御を使用します。  スナップショット トランザクションは、トランザクションの開始後に変更された行への更新をコミットしようとすると、このトランザクションがロールバックし、エラーになります。  
+  
+## ADO.NET でのスナップショット分離の使用  
+ スナップショット分離は、<xref:System.Data.SqlClient.SqlTransaction> クラスによって ADO.NET 内でサポートされます。  データベースでスナップショット分離が有効になっているが、READ\_COMMITTED\_SNAPSHOT ON に構成されていない場合、<xref:System.Data.SqlClient.SqlConnection.BeginTransaction%2A> メソッドの呼び出し時に **IsolationLevel.Snapshot** 列挙値を使って、<xref:System.Data.SqlClient.SqlTransaction> を開始する必要があります。  このコード フラグメントでは、接続は開かれている <xref:System.Data.SqlClient.SqlConnection> オブジェクトであることを前提としています。  
+  
+```vb  
+Dim sqlTran As SqlTransaction = _  
+  connection.BeginTransaction(IsolationLevel.Snapshot)  
+```  
+  
+```csharp  
+SqlTransaction sqlTran =   
+  connection.BeginTransaction(IsolationLevel.Snapshot);  
+```  
+  
+### 例  
+ ロックされたデータにアクセスしようとすることにより、分離レベルがそれぞれどのように動作するのかを、次の例に示します。このサンプルは、実行用のコードで使用されることは想定していません。  
+  
+ このコードは、SQL Server の **AdventureWorks** サンプル データベースに接続し、**TestSnapshot** というテーブルを作成し、1 行のデータを挿入します。  コードには ALTER DATABASE Transact\-SQL ステートメントを使用し、データベースのスナップショット分離を有効にします。このとき、既定の READ COMMITTED 分離レベルの動作を有効なままにし、READ\_COMMITTED\_SNAPSHOT オプションは設定しません。  続いてコードは、次のアクションを実行します。  
+  
+-   更新トランザクションを開始するために、SERIALIZABLE 分離レベルを使用する sqlTransaction1 を開始し、完了しないようにします。  これには、テーブルがロックするという効果があります。  
+  
+-   2 つ目の接続を開き、SNAPSHOT 分離レベルを使って 2 つ目のトランザクションを開始し、**TestSnapshot** テーブル内のデータを読み取ります。  スナップショット分離が有効になっているため、このトランザクションは、sqlTransaction1 が開始する前に存在していたデータを読み取ることができます。  
+  
+-   3 つ目の接続を開いて、READ COMMITTED 分離レベルを使ってトランザクションを開始し、テーブル内のデータの読み取りを試みます。  この場合、コードはデータを読み取れません。コードは最初のトランザクション内のテーブルに置かれたロックを超えて読み取りを行うことができず、タイムアウトになるためです。  REPEATABLE READ 分離レベルと SERIALIZABLE 分離レベルが使用されている場合は、これらの分離レベルも、最初のトランザクション内に置かれたロックを超えて読み取りを行うことができないため、同じ結果になります。  
+  
+-   4 つ目の接続を開き、sqlTransaction1 内でコミットされていない値のダーティ リードを実行する READ UNCOMMITTED 分離レベルを使用し、トランザクションを開始します。  最初のトランザクションがコミットされていない場合、この値は実際にデータベース内には存在しません。  
+  
+-   **TestSnapshot** テーブルを削除し、**AdventureWorks** データベースのスナップショット分離をオフにすることにより、最初のトランザクションをロールバックおよびクリーンアップします。  
+  
+> [!NOTE]
+>  次の例では、接続プールを無効にした状態で同じ接続文字列を使用します。  接続をプールした場合、その分離レベルをリセットしても、サーバー側の分離レベルはリセットされません。  その結果、同じプールされた内部接続を使用する後続の接続は、プールされた接続と同じ分離レベルで開始されることになります。  接続プールを無効にする代わりに、各接続について分離レベルを明示的に設定することもできます。  
+  
+ [!code-csharp[DataWorks SnapshotIsolation.Demo#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SnapshotIsolation.Demo/CS/source.cs#1)]
+ [!code-vb[DataWorks SnapshotIsolation.Demo#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SnapshotIsolation.Demo/VB/source.vb#1)]  
+  
+### 例  
+ データ変更が行われている間のスナップショット分離の動作の例を次に示します。  コードは、次のアクションを実行します。  
+  
+-   **AdventureWorks** サンプル データベースに接続し、SNAPSHOT 分離を有効にします。  
+  
+-   **TestSnapshotUpdate** という名前のテーブルを作成し、3 行のサンプル データを挿入します。  
+  
+-   SNAPSHOT 分離を使って sqlTransaction1 を開始し、完了しないようにします。  3 行のデータがトランザクション内で選択されます。  
+  
+-   2 つ目の **SqlConnection** を **AdventureWorks** に対して作成し、sqlTransaction1 内で選択された行のうち 1 行の値を更新する READ COMMITTED 分離レベルを使用して、2 つ目のトランザクションを作成します。  
+  
+-   sqlTransaction2 をコミットします。  
+  
+-   sqlTransaction1 に戻り、sqlTransaction1 がコミットした行と同じ行の更新を試みます。  エラー 3960 が発生し、sqlTransaction1 は自動的にロールバックされます。  **SqlException.Number** と **SqlException.Message** がコンソール ウィンドウに表示されます。  
+  
+-   クリーンアップ コードを実行して **AdventureWorks** 内のスナップショット分離をオフにし、**TestSnapshotUpdate** テーブルを削除します。  
+  
+ [!code-csharp[DataWorks SnapshotIsolation.DemoUpdate#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SnapshotIsolation.DemoUpdate/CS/source.cs#1)]
+ [!code-vb[DataWorks SnapshotIsolation.DemoUpdate#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SnapshotIsolation.DemoUpdate/VB/source.vb#1)]  
+  
+### スナップショット分離でのロック ヒントの使用  
+ 前の例では、最初のトランザクションがデータを選択し、このトランザクションが完了する前に 2 つ目のトランザクションがデータを更新しています。その結果、最初のトランザクションが同じ行を更新しようとすると、競合が発生します。  トランザクションの先頭にロック ヒントを指定することにより、長時間にわたるスナップショット トランザクションにおいて更新競合が発生する可能性を軽減できます。  次の SELECT ステートメントでは、選択した行をロックするために、UPDLOCK ヒントが使用されています。  
+  
+```  
+SELECT * FROM TestSnapshotUpdate WITH (UPDLOCK)   
+  WHERE PriKey BETWEEN 1 AND 3  
+```  
+  
+ UPDLOCK ロック ヒントを使用すると、最初のトランザクションが完了する前に行が更新されるのをブロックします。  これにより、選択した行が後にトランザクション内で更新されるときに、競合が発生しないことが保証されます。  SQL Server オンライン ブックの「ロックのヒント」を参照してください。  
+  
+ アプリケーションで競合が多数発生する場合、スナップショット分離は適切な選択肢ではない可能性があります。  ヒントの使用は、本当に必要な場合のみに制限する必要があります。  アプリケーションは、ロック ヒントに常に依存する操作にならないように設計されている必要があります。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/specifying-xml-values-as-parameters.md b/docs/framework/data/adonet/sql/specifying-xml-values-as-parameters.md
new file mode 100644
index 00000000000..20f43edfcbc
--- /dev/null
+++ b/docs/framework/data/adonet/sql/specifying-xml-values-as-parameters.md
@@ -0,0 +1,173 @@
+---
+title: "パラメーターとしての XML 値の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c4d08b8-fc29-4614-97fa-29c8ff7ca5b3
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# パラメーターとしての XML 値の指定
+値が XML 文字列であるパラメーターがクエリに必要な場合、開発者はその値を **SqlXml** のインスタンスを使用して提供することができます。  特別な処理は必要ありません。[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の XML 列は、他のデータ型と同じ方法でパラメーター値を受け入れます。  
+  
+## 例  
+ 次のコンソール アプリケーションでは、**AdventureWorks** データベースに新しいテーブルを作成します。  新しいテーブルには、**SalesID** という名前の列と、**SalesInfo** という名前の XML 列があります。  
+  
+> [!NOTE]
+>  **AdventureWorks** サンプル データベースは、既定では [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のインストール時にはインストールされません。  SQL Server Setup を実行してインストールします。  
+  
+ この例では、新しいテーブルに行を挿入するために <xref:System.Data.SqlClient.SqlCommand> オブジェクトを準備します。  保存されたファイルは、**SalesInfo** 列に必要な XML データを提供します。  
+  
+ この例を実行させるために必要なファイルを作成するには、プロジェクトと同じフォルダー内に新しいテキスト ファイルを作成します。  ファイルに MyTestStoreData.xml という名前を付けます。  ファイルをメモ帳で開き、次のテキストをコピーして貼り付けます。  
+  
+```  
+<StoreSurvey xmlns="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/StoreSurvey">  
+  <AnnualSales>300000</AnnualSales>  
+  <AnnualRevenue>30000</AnnualRevenue>  
+  <BankName>International Bank</BankName>  
+  <BusinessType>BM</BusinessType>  
+  <YearOpened>1970</YearOpened>  
+  <Specialty>Road</Specialty>  
+  <SquareFeet>7000</SquareFeet>  
+  <Brands>3</Brands>  
+  <Internet>T1</Internet>  
+  <NumberEmployees>2</NumberEmployees>  
+</StoreSurvey>  
+```  
+  
+ \[Visual Basic\]  
+  
+```  
+Imports System  
+Imports System.Data.SqlClient  
+Imports System.Data.SqlTypes  
+Imports System.Xml  
+  
+Module Module1  
+    Sub Main()  
+  
+        Using connection As SqlConnection = New SqlConnection(GetConnectionString())  
+        connection.Open()  
+  
+        ' Create a sample table (dropping first if it already  
+        ' exists.)  
+        Dim commandNewTable As String = _  
+         "IF EXISTS (SELECT * FROM dbo.sysobjects " & _  
+         "WHERE id = object_id(N'[dbo].[XmlDataTypeSample]') " & _  
+         "AND OBJECTPROPERTY(id, N'IsUserTable') = 1) " & _  
+         "DROP TABLE [dbo].[XmlDataTypeSample];" & _  
+         "CREATE TABLE [dbo].[XmlDataTypeSample](" & _  
+         "[SalesID] [int] IDENTITY(1,1) NOT NULL, " & _  
+         "[SalesInfo] [xml])"  
+  
+        Dim commandAdd As New _  
+         SqlCommand(commandNewTable, connection)  
+        commandAdd.ExecuteNonQuery()  
+  
+        Dim commandText As String = _  
+         "INSERT INTO [dbo].[XmlDataTypeSample] " & _  
+           "([SalesInfo] ) " & _  
+           "VALUES(@xmlParameter )"  
+  
+        Dim command As New SqlCommand(commandText, connection)  
+  
+        ' Read the saved XML document as a   
+        ' SqlXml-data typed variable.  
+        Dim newXml As SqlXml = _  
+         New SqlXml(New XmlTextReader("MyTestStoreData.xml"))  
+  
+        ' Supply the SqlXml value for the value of the parameter.  
+        command.Parameters.AddWithValue("@xmlParameter", newXml)  
+  
+        Dim result As Integer = command.ExecuteNonQuery()  
+        Console.WriteLine(result & " row was added.")  
+        Console.WriteLine("Press Enter to continue.")  
+        Console.ReadLine()  
+    End Using  
+End Sub  
+  
+    Private Function GetConnectionString() As String  
+        ' To avoid storing the connection string in your code,              
+        ' you can retrieve it from a configuration file.   
+        Return "Data Source=(local);Integrated Security=SSPI;" & _  
+          "Initial Catalog=AdventureWorks"  
+    End Function  
+End Module  
+```  
+  
+ \[C\#\]  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.Xml;  
+using System.Data.SqlTypes;  
+  
+class Class1  
+{  
+    static void Main()  
+    {  
+        using (SqlConnection connection = new SqlConnection(GetConnectionString()))  
+       {  
+        connection.Open();  
+        //  Create a sample table (dropping first if it already  
+        //  exists.)  
+  
+        string commandNewTable =   
+            "IF EXISTS (SELECT * FROM dbo.sysobjects " +   
+            "WHERE id = " +  
+                  "object_id(N'[dbo].[XmlDataTypeSample]') " +   
+            "AND OBJECTPROPERTY(id, N'IsUserTable') = 1) " +   
+            "DROP TABLE [dbo].[XmlDataTypeSample];" +   
+            "CREATE TABLE [dbo].[XmlDataTypeSample](" +   
+            "[SalesID] [int] IDENTITY(1,1) NOT NULL, " +   
+            "[SalesInfo] [xml])";  
+        SqlCommand commandAdd =   
+                   new SqlCommand(commandNewTable, connection);  
+        commandAdd.ExecuteNonQuery();  
+        string commandText =   
+            "INSERT INTO [dbo].[XmlDataTypeSample] " +   
+            "([SalesInfo] ) " +   
+            "VALUES(@xmlParameter )";  
+        SqlCommand command =   
+                  new SqlCommand(commandText, connection);  
+  
+        //  Read the saved XML document as a   
+        //  SqlXml-data typed variable.  
+        SqlXml newXml =   
+            new SqlXml(new XmlTextReader("MyTestStoreData.xml"));  
+  
+        //  Supply the SqlXml value for the value of the parameter.  
+        command.Parameters.AddWithValue("@xmlParameter", newXml);  
+  
+        int result = command.ExecuteNonQuery();  
+        Console.WriteLine(result + " row was added.");  
+        Console.WriteLine("Press Enter to continue.");  
+        Console.ReadLine();  
+    }  
+  }  
+  
+    private static string GetConnectionString()  
+    {  
+        // To avoid storing the connection string in your code,              
+        // you can retrieve it from a configuration file.   
+        return "Data Source=(local);Integrated Security=true;" +  
+        "Initial Catalog=AdventureWorks; ";  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Data.SqlTypes.SqlXml>   
+ [SQL Server における XML データ](../../../../../docs/framework/data/adonet/sql/xml-data-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md b/docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md
new file mode 100644
index 00000000000..83efb088e56
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md
@@ -0,0 +1,35 @@
+---
+title: "SQL Server のバイナリ データと大きな値のデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e00827b3-7511-4b2d-91d7-851ca86cc6b5
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server のバイナリ データと大きな値のデータ
+SQL Server では `max` 指定子が提供されています。これにより、`varchar`、`nvarchar`、および `varbinary` データ型の記憶容量が拡張されています。  `varchar(max)`、`nvarchar(max)`、および `varbinary(max)` は、総称して大きな値のデータ型と呼びます。  大きな値のデータ型を使用すると、最大で 2^31\-1 バイトのデータを格納できます。  
+  
+ SQL Server 2008 では FILESTREAM 属性が導入されました。これはデータ型ではありませんが、列に定義できる属性であり、これを使用すると大きな値のデータをデータベースではなくファイル システムに格納できます。  
+  
+## このセクションの内容  
+ [ADO.NET での大きい値 \(max\) データの変更](../../../../../docs/framework/data/adonet/sql/modifying-large-value-max-data.md)  
+ 大きな値のデータ型を扱う方法について説明します。  
+  
+ [FILESTREAM データ](../../../../../docs/framework/data/adonet/sql/filestream-data.md)  
+ SQL Server 2008 で FILESTREAM 属性を使用して保存された大きな値のデータを扱う方法について説明します。  
+  
+## 参照  
+ [SQL Server データ型と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-data-types.md)   
+ [ADO.NET における SQL Server データ操作](../../../../../docs/framework/data/adonet/sql/sql-server-data-operations.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md b/docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md
new file mode 100644
index 00000000000..f2cece059c7
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md
@@ -0,0 +1,55 @@
+---
+title: "SQL Server の共通言語ランタイム統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7a324c4-160d-44c2-b593-641af06eca61
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SQL Server の共通言語ランタイム統合
+SQL Server 2005 で、Microsoft Windows 用の .NET Framework の共通言語ランタイム \(CLR\) コンポーネントの統合が導入されました。  つまり、Microsoft Visual Basic .NET や Microsoft Visual C\# を含む任意の .NET Framework 言語を使用して、ストアド プロシージャ、トリガー、ユーザー定義型、ユーザー定義関数、ユーザー定義集計、およびストリーミング テーブル値関数を作成できるようになりました。  マネージ コードが Microsoft SQL Server 環境とデータをやり取りできるように、<xref:Microsoft.SqlServer.Server> 名前空間には新しいアプリケーション プログラミング インターフェイス \(API\) のセットが含まれています。  
+  
+ このセクションでは、SQL Server の共通言語ランタイム \(CLR\) 統合および SQL Server のインプロセス固有の ADO.NET の拡張に固有の機能や動作ついて説明します。  
+  
+ このセクションは、SQL Server の CLR 統合を利用したプログラミングを始めるのに十分な情報を提供することを目的としており、包括的な情報の提供は目的としていません。  詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [共通言語ランタイム \(CLR\) 統合プログラミングの概念](http://go.microsoft.com/fwlink/?LinkId=115240)  
+  
+## このセクションの内容  
+ [SQL Server の CLR 統合の概要](../../../../../docs/framework/data/adonet/sql/introduction-to-sql-server-clr-integration.md)  
+ SQL Server の CLR 統合の概要について説明します。  追加情報へのリンクもあります。  
+  
+ [CLR ユーザー定義関数](../../../../../docs/framework/data/adonet/sql/clr-user-defined-functions.md)  
+ テーブル値関数、スカラー関数、ユーザー定義集計関数など、さまざまな種類の CLR 関数の実装方法と使用方法について説明します。  
+  
+ [CLR ユーザー定義型](../../../../../docs/framework/data/adonet/sql/clr-user-defined-types.md)  
+ CLR のユーザー定義型を実装して使用する方法について説明します。  追加情報へのリンクもあります。  
+  
+ [CLR ストアド プロシージャ](../../../../../docs/framework/data/adonet/sql/clr-stored-procedures.md)  
+ CLR のストアド プロシージャを実装して使用する方法について説明します。  追加情報へのリンクもあります。  
+  
+ [CLR トリガー](../../../../../docs/framework/data/adonet/sql/clr-triggers.md)  
+ CLR のトリガーを実装して使用する方法について説明します。  追加情報へのリンクもあります。  
+  
+ [コンテキスト接続](../../../../../docs/framework/data/adonet/sql/the-context-connection.md)  
+ コンテキスト接続について説明します。  
+  
+ [SQL Server のインプロセス固有の ADO.NET の動作](../../../../../docs/framework/data/adonet/sql/sql-server-in-process-specific-behavior-of-adonet.md)  
+ SQL Server のインプロセス固有の ADO.NET の拡張およびコンテキスト接続について説明します。  追加情報へのリンクもあります。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-data-operations.md b/docs/framework/data/adonet/sql/sql-server-data-operations.md
new file mode 100644
index 00000000000..296d56088d4
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-data-operations.md
@@ -0,0 +1,38 @@
+---
+title: "ADO.NET における SQL Server データ操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b864ebc9-ed8e-4059-85fd-36d9198f5521
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# ADO.NET における SQL Server データ操作
+このセクションでは、.NET Framework Data Provider for SQL Server \(<xref:System.Data.SqlClient>\) 固有の SQL Server の機能について説明します。  
+  
+## このセクションの内容  
+ [SQL Server でのバルク コピー操作](../../../../../docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md)  
+ .NET Data Provider for SQL Server のバルク コピー機能について説明します。  
+  
+ [複数のアクティブな結果セット \(MARS\)](../../../../../docs/framework/data/adonet/sql/multiple-active-result-sets-mars.md)  
+ <xref:System.Data.SqlClient.SqlDataReader> の各インスタンスが別々のコマンドで開始されているとき、複数の <xref:System.Data.SqlClient.SqlDataReader> を接続上で開く方法について説明します。  
+  
+ [非同期操作](../../../../../docs/framework/data/adonet/sql/asynchronous-operations.md)  
+ .NET Framework で使用されている非同期モデルに基づいて設計された API を使用して、非同期データベース操作を実行する方法について説明します。  
+  
+ [テーブル値パラメーター](../../../../../docs/framework/data/adonet/sql/table-valued-parameters.md)  
+ SQL Server 2008 で導入された、テーブル値パラメーターの使用方法について説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-data-types.md b/docs/framework/data/adonet/sql/sql-server-data-types.md
new file mode 100644
index 00000000000..5b2a1a1e1dc
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-data-types.md
@@ -0,0 +1,69 @@
+---
+title: "SQL Server データ型と ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81b43550-23e8-43bb-b460-7eb8ac825c33
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server データ型と ADO.NET
+SQL Server と .NET Framework は異なる型システムに基づいているので、両者間でデータ損失が発生する可能性があります。  データの整合性を維持するために、.NET Framework Data Provider for SQL Server \(<xref:System.Data.SqlClient>\) では、SQL Server データを処理するための型指定されたアクセサー メソッドが提供されています。  <xref:System.Data.SqlDbType> クラスの列挙値を使用して、<xref:System.Data.SqlClient.SqlParameter> データ型を指定できます。  
+  
+ SQL Server と .NET Framework の間のデータ型マッピングの詳細については、「[SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)」を参照してください。  
+  
+ SQL Server 2008 では、業務上のニーズに対応して、日時データ、構造化データ、半構造化データ、および非構造化データを扱うための新しいデータ型が導入されました。  新しいデータ型は、SQL Server 2008 オンライン ブックで説明されています。  
+  
+ アプリケーションで使用可能な SQL Server のデータ型は、使用する SQL Server のバージョンによって異なります。  詳細については、次の表にある各バージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [データ型 \(データベース エンジン\)](http://go.microsoft.com/fwlink/?LinkID=107468)  
+  
+## このセクションの内容  
+ [SqlTypes と DataSet](../../../../../docs/framework/data/adonet/sql/sqltypes-and-the-dataset.md)  
+ `DataSet` 内の `SqlTypes` に対する型のサポートについて説明します。  
+  
+ [NULL 値の処理](../../../../../docs/framework/data/adonet/sql/handling-null-values.md)  
+ null 値と 3 値ロジックの使用例を示します。  
+  
+ [GUID と uniqueidentifier 値の比較](../../../../../docs/framework/data/adonet/sql/comparing-guid-and-uniqueidentifier-values.md)  
+ SQL Server と .NET Framework での GUID および uniqueidentifier 値の使用例を示します。  
+  
+ [日付と時刻のデータ](../../../../../docs/framework/data/adonet/sql/date-and-time-data.md)  
+ SQL Server 2008 で導入された新しい日付と時刻のデータ型の使用方法について説明します。  
+  
+ [大きな UDT](../../../../../docs/framework/data/adonet/sql/large-udts.md)  
+ SQL Server 2008 で導入された大きな値の UDT からデータを取り出す方法の例を示します。  
+  
+ [SQL Server における XML データ](../../../../../docs/framework/data/adonet/sql/xml-data-in-sql-server.md)  
+ SQL Server から取得した XML データを使用する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Data.DataSet>  
+ `DataSet` クラスおよびそのすべてのメンバーについて説明します。  
+  
+ <xref:System.Data.SqlTypes>  
+ `SqlTypes` 名前空間およびそのすべてのメンバーについて説明します。  
+  
+ <xref:System.Data.SqlDbType>  
+ `SqlDbType` 列挙型およびそのすべてのメンバーについて説明します。  
+  
+ <xref:System.Data.DbType>  
+ `DbType` 列挙型およびそのすべてのメンバーについて説明します。  
+  
+## 参照  
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [テーブル値パラメーター](../../../../../docs/framework/data/adonet/sql/table-valued-parameters.md)   
+ [SQL Server のバイナリ データと大きな値のデータ](../../../../../docs/framework/data/adonet/sql/sql-server-binary-and-large-value-data.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-express-security.md b/docs/framework/data/adonet/sql/sql-server-express-security.md
new file mode 100644
index 00000000000..a865c30056b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-express-security.md
@@ -0,0 +1,50 @@
+---
+title: "SQL Server Express のセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf9cf6d9-4b05-43e9-ac7b-6cefbfcd6d4e
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server Express のセキュリティ
+Microsoft SQL Server Express Edition \(SQL Server Express\) は Microsoft SQL Server をベースとしており、同データベース エンジンの多くの機能をサポートしています。  必須ではない機能やネットワーク接続は、既定では無効にされています。  これは悪意のあるユーザーに攻撃の隙をできるだけ与えないようにするための配慮です。  
+  
+ 通常、SQL Server Express は名前付きインスタンスとしてインストールされます。  このインスタンスの既定の名前は `SQLExpress` です。  名前付きインスタンスは、コンピューターのネットワーク名と、インストール時に指定したインスタンス名によって識別されます。  
+  
+## ネットワーク アクセス  
+ セキュリティ上の理由により、SQL Server Express では、ネットワーク プロトコルが既定で無効になっています。  これにより、SQL Server Express のインスタンスをホストしているコンピューターを危険にさらすような、外部ユーザーからの攻撃を防ぐことができます。  SQL Server Express インスタンスに別のコンピューターから接続する場合は、ネットワーク接続を明示的に有効にし、SQL Server Browser サービスを開始する必要があります。  
+  
+ ネットワーク接続を有効にした場合、SQL Server Express のインスタンスにも、他のエディションの SQL Server と同じセキュリティ要件が適用されます。  
+  
+## ユーザー インスタンス  
+ ユーザー インスタンスは、SQL Server Express の親インスタンスによって生成される SQL Server Express データベース エンジンの独立したインスタンスです。  ユーザー インスタンスの主要な目的は、Windows を最小限の権限しか持たないユーザー アカウントで実行しているユーザーが、そのローカル コンピューター上の SQL Server Express インスタンスについてはシステム管理者 \(`sysadmin`\) 権限を利用できるようにすることです。  ローカル コンピューターのシステム管理者を想定したものではありません。  
+  
+ ユーザー インスタンスは、SQL Server のプライマリ インスタンス \(SQL Server Express\) が、ユーザーに代わって生成するインスタンスです。  サービスとして実行されるのではなく、ユーザーの Windows セキュリティ コンテキスト下で、ユーザー プロセスとして実行されます。  サポートされているのは Windows ログインのみで、SQL Server ログインは禁止されています。  実行可能な操作はログインしたユーザーの権限に限定されるため、ユーザー インスタンスで実行されているソフトウェアによって、システム全体に及ぶ変更が行われることはありません。  ユーザー インスタンスは子インスタンスまたはクライアント インスタンス、あるいは、"Run As Normal User" の頭文字を取って RANU と呼ばれることもあります。  
+  
+ 各ユーザー インスタンスは、その親インスタンスや同じコンピューター上で実行されている他のユーザー インスタンスとは分離されます。  ユーザー インスタンス上にインストールされたデータベースは、シングル ユーザー モードでのみ開くことができ、複数のユーザーが接続することはできません。  ユーザー インスタンスでは、レプリケーション、分散クエリ、およびリモート接続が無効にされています。  ユーザー インスタンスに接続したユーザーには、親 SQL Server Express インスタンスに対する特別な権限は一切与えられません。  
+  
+## 外部リソース  
+ SQL Server Express の詳細については、次のリソースを参照してください。  
+  
+|||  
+|-|-|  
+|[SQL Server オンライン ブック](http://msdn.microsoft.com/library/bb543165.aspx)|SQL Server Express のドキュメントが含まれます。|  
+|SQL Server オンライン ブックの「[SQL Server Express への接続](http://msdn.microsoft.com/library/ms165679.aspx)」|SQL Server Express Edition をネットワーク上で使用する方法について説明します。|  
+|[Microsoft SQL Server 2005 Express Edition Books Online](http://msdn.microsoft.com/library/ms165706.aspx)|SQL Server 2005 Express Edition の完全なドキュメントです。|  
+|SQL Server オンライン ブックの「[管理者以外のユーザーのためのユーザー インスタンス](http://msdn.microsoft.com/library/ms143684.aspx)」|ユーザー インスタンスの作成方法および配置方法について説明します。|  
+|[SQL Server Express ユーザー インスタンス](../../../../../docs/framework/data/adonet/sql/sql-server-express-user-instances.md)|ADO.NET アプリケーションにおけるユーザー インスタンスの機能について説明します。  ユーザー インスタンスを有効にする方法、<xref:System.Data.SqlClient.SqlConnection> を使ってユーザー インスタンスに接続する方法、ユーザー インスタンスの有効期間、ユーザー インスタンスのシナリオについて情報を提供します。|  
+  
+## 参照  
+ [SQL Server のセキュリティ](../../../../../docs/framework/data/adonet/sql/sql-server-security.md)   
+ [SQL Server Express ユーザー インスタンス](../../../../../docs/framework/data/adonet/sql/sql-server-express-user-instances.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-express-user-instances.md b/docs/framework/data/adonet/sql/sql-server-express-user-instances.md
new file mode 100644
index 00000000000..161fc8138b8
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-express-user-instances.md
@@ -0,0 +1,161 @@
+---
+title: "SQL Server Express ユーザー インスタンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00c12376-cb26-4317-86ad-e6e9c089be57
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server Express ユーザー インスタンス
+Microsoft SQL Server Express Edition \(SQL Server Express\) でサポートされる機能に、ユーザー インスタンスがあります。ユーザー インスタンスは、.NET Framework Data Provider for SQL Server \(`SqlClient`\) を使用している場合にしか利用できません。  ユーザー インスタンスは、親インスタンスによって生成される SQL Server Express データベース エンジンの独立したインスタンスです。  ユーザー インスタンスを使用すると、ローカル コンピューターの管理者以外のユーザーが、SQL Server Express データベースにアタッチして接続できます。  それぞれのインスタンスは、1 ユーザーあたり 1 インスタンスの原則に基づいて、個々のユーザーのセキュリティ コンテキストで実行されます。  
+  
+## ユーザー インスタンスの機能  
+ Windows を LUA \(最小限の特権しか持たないユーザー アカウント\) で実行しているユーザーにとっては、ユーザー インスタンスは特に有効な手段です。なぜなら、各ユーザーには、そのコンピューター上で実行されているインスタンスに対して SQL Server システム管理者 \(`sysadmin`\) の権限が割り当てられ、Windows 管理者として実行する必要がないためです。  SQL Server Express のユーザー インスタンスは、サービスではなく、そのユーザーの非管理者 Windows アカウントで実行されるため、ユーザー インスタンス上で実行されているソフトウェアは権限が限定され、システム全体に及ぶ変更を行うことはできません。  各ユーザー インスタンスは、その親インスタンスや同じコンピューター上で実行されている他のユーザー インスタンスとは分離されます。  ユーザー インスタンスで実行されているデータベースは、シングル ユーザー モードでのみ開くことができ、複数のユーザーが同じユーザー インスタンス上のデータベースに接続することはできません。  ユーザー インスタンスでは、レプリケーションと分散クエリも無効になります。  
+  
+ 詳細については、SQL Server オンライン ブックの「ユーザー インスタンス」を参照してください。  
+  
+> [!NOTE]
+>  既にコンピューターの管理者であるユーザーが、ユーザー インスタンスを使用する必要はありません。また、複数のデータベース ユーザーが関係する場合もユーザー インスタンスは不要です。  
+  
+## ユーザー インスタンスの有効化  
+ ユーザー インスタンスを生成するには、SQL Server Express の親インスタンスが実行されている必要があります。  SQL Server Express がインストールされている場合は、ユーザー インスタンスが既定で有効になります。また、システム管理者は、親インスタンスに対して **sp\_configure** システム ストアド プロシージャを実行することで、ユーザー インスタンスの有効と無効を明示的に切り替えることもできます。  
+  
+```  
+-- Enable user instances.  
+sp_configure 'user instances enabled','1'   
+  
+-- Disable user instances.  
+sp_configure 'user instances enabled','0'  
+```  
+  
+ ユーザー インスタンスのネットワーク プロトコルは、ローカルの名前付きパイプにする必要があります。  ユーザー インスタンスを SQL Server のリモート インスタンスで開始することはできません。また、SQL Server ログインは許可されません。  
+  
+## ユーザー インスタンスへの接続  
+ <xref:System.Data.SqlClient.SqlConnection> でユーザー インスタンスに接続するには、<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> のキーワード `User Instance`  および `AttachDBFilename` を使用します。  ユーザー インスタンスは、<xref:System.Data.SqlClient.SqlConnectionStringBuilder> の `UserInstance` プロパティおよび `AttachDBFilename` プロパティでもサポートされます。  
+  
+ 以下にサンプルの接続文字列を示します。次の点に注意してください。  
+  
+-   `Data Source` キーワードは、ユーザー インスタンスを生成している SQL Server Express の親インスタンスを指します。  既定のインスタンスは .  \\sqlexpress です。  
+  
+-   `Integrated Security` が `true` に設定されます。  ユーザー インスタンスに接続するには Windows 認証が必要です。SQL Server ログインはサポートされません。  
+  
+-   `User Instance` は `true` に設定されます。これにより、ユーザー インスタンスが呼び出されます。  既定値は `false` です。  
+  
+-   プライマリ データベース ファイル \(.mdf\) にアタッチするには、`AttachDbFileName` 接続文字列キーワードで完全パス名を指定します。  また、`AttachDbFileName` は、<xref:System.Data.SqlClient.SqlConnection> 接続文字列内の "extended properties" キーおよび "initial file name" キーに対応しています。  
+  
+-   パイプ記号で囲まれた `|DataDirectory|` の部分には、接続元のアプリケーションのデータ ディレクトリを表す文字列が入ります。データベース ファイルである .mdf と .ldf、およびログ ファイルの格納場所を相対パスで指定します。  これらのファイルを別の場所に移す場合は、ファイルの完全パスを指定する必要があります。  
+  
+```  
+Data Source=.\\SQLExpress;Integrated Security=true;  
+User Instance=true;AttachDBFilename=|DataDirectory|\InstanceDB.mdf;  
+Initial Catalog=InstanceDB;  
+```  
+  
+> [!NOTE]
+>  実行時に接続文字列を作成するために <xref:System.Data.SqlClient.SqlConnectionStringBuilder> <xref:System.Data.SqlClient.SqlConnectionStringBuilder.UserInstance%2A> および <xref:System.Data.SqlClient.SqlConnectionStringBuilder.AttachDBFilename%2A> プロパティを使用することもできます。  
+  
+### &#124;DataDirectory&#124; 置換文字列の使用  
+ ADO.NET 2.0 では、`AttachDbFileName` が拡張されて、`|DataDirectory|` というパイプ記号で囲まれた置換文字列が導入されました。  `AttachDbFileName` に `DataDirectory` を組み合わせて使用することで、データ ファイルへの相対パスを指定でき、完全パスを使用する代わりに、データ ソースの相対パスに基づいて接続文字列を作成できます。   ``  
+  
+ `DataDirectory` が表す物理的な場所は、アプリケーションの種類によって異なります。  次の例では、アタッチする Northwind.mdf ファイルが、アプリケーションの \\app\_data フォルダーに格納されています。  
+  
+```  
+Data Source=.\\SQLExpress;Integrated Security=true;  
+User Instance=true;  
+AttachDBFilename=|DataDirectory|\app_data\Northwind.mdf;  
+Initial Catalog=Northwind;  
+```  
+  
+ `DataDirectory` を使用する場合、最終的なファイル パスが、必ずその置換文字列が表すディレクトリのサブディレクトリとなるように指定する必要があります。  たとえば、`DataDirectory` を展開した結果が C:\\AppDirectory\\app\_data である場合、app\_data は c:\\AppDirectory よりも下位であるため、上の例の接続文字列は適切に動作します。  しかし、`DataDirectory` を「`|DataDirectory|\..\data`」として指定すると、\\data が \\AppDirectory のサブディレクトリではないため、エラーが発生します。  
+  
+ 接続文字列に指定した置換文字列の形式が正しくない場合、<xref:System.ArgumentException> がスローされます。  
+  
+> [!NOTE]
+>  置換文字列は、<xref:System.Data.SqlClient> によってローカル コンピューターのファイル システムと照合されて完全パスに解決されます。  したがって、リモート サーバー、HTTP、および UNC のパス名はサポートされません。  サーバーがローカル コンピューター上に存在しない場合、接続を開こうとすると例外がスローされます。  
+  
+ <xref:System.Data.SqlClient.SqlConnection> を開くと、この接続文字列が、既定の SQL Server Express インスタンスから、実行時に開始された \(呼び出し元のアカウントで実行される\) インスタンスへとリダイレクトされます。  
+  
+> [!NOTE]
+>  ユーザー インスタンスは、通常のインスタンスよりも読み込みに時間がかかる場合があります。その場合は、<xref:System.Data.SqlClient.SqlConnection.ConnectionTimeout%2A> の値を増やす必要があります。  
+  
+ 次のコード フラグメントでは、新しい `SqlConnection` を開き、接続文字列をコンソール ウィンドウに表示した後、`using` コード ブロックを終了した時点で接続を閉じます。  
+  
+```vb  
+Private Sub OpenSqlConnection()  
+    ' Retrieve the connection string.  
+    Dim connectionString As String = GetConnectionString()  
+  
+    Using connection As New SqlConnection(connectionString)  
+        connection.Open()  
+        Console.WriteLine("ConnectionString: {0}", _  
+           connection.ConnectionString)  
+    End Using  
+End Sub  
+```  
+  
+```csharp  
+private static void OpenSqlConnection()  
+{  
+    // Retrieve the connection string.  
+    string connectionString = GetConnectionString();  
+  
+    using (SqlConnection connection =   
+        new SqlConnection(connectionString))  
+    {  
+        connection.Open();  
+        Console.WriteLine("ConnectionString: {0}",   
+             connection.ConnectionString);  
+    }  
+}  
+```  
+  
+> [!NOTE]
+>  SQL Server の内部で実行される共通言語ランタイム \(CLR\) コードでは、ユーザー インスタンスはサポートされません。  <xref:System.Data.SqlClient.SqlConnection> の接続文字列で `User Instance=true` を指定して `Open` を呼び出すと、<xref:System.InvalidOperationException> がスローされます。  
+  
+## ユーザー インスタンスの接続の有効期間  
+ SQL Server にはサービスとして実行されるバージョンもありますが、それらのバージョンとは異なり、SQL Server Express のインスタンスは、開始と停止を手動で行う必要はありません。  既に実行されている場合を除き、ユーザーがログインして接続するたびにユーザー インスタンスが開始されます。  ユーザー インスタンス データベースには `AutoClose` オプションが用意されており、アクティブでない状態が一定期間続くとデータベースが自動的にシャットダウンされます。  開始された sqlservr.exe プロセスは、そのインスタンスに対する最後の接続が閉じられた後も、タイムアウトの期限が切れるまで引き続き実行されます。したがって、タイムアウトの期限が切れる前であれば、再開しなくても、新たに接続を開くことができます。  タイムアウトの期限が切れるまでの間に新しい接続が開かれなかった場合、ユーザー インスタンスは自動的にシャットダウンされます。  親インスタンスのシステム管理者は、**sp\_configure** を使用し、**user instance timeout** オプションを変更することにより、ユーザー インスタンスのタイムアウト期間を設定できます。  既定値は、60 分です。  
+  
+> [!NOTE]
+>  接続文字列の `Min Pool Size` に 0 を超える値を指定した場合、接続プーラーは、開かれているいくつかの接続を常に保持するようになります。この場合、ユーザー インスタンスは自動的にはシャットダウンされません。  
+  
+## ユーザー インスタンスの動作  
+ 各ユーザーに対して最初にユーザー インスタンスが生成された時点で、そのユーザー インスタンスによって排他的に使用されるユーザーのローカル アプリケーション データ リポジトリ ディレクトリの下位パスに、Template Data フォルダーからシステム データベース **master** および **msdb** がコピーされます。  通常、このパスは `C:\Documents and Settings\<UserName>\Local Settings\Application Data\Microsoft\Microsoft SQL Server Data\SQLEXPRESS` です。  ユーザー インスタンスが開始されると、**tempdb**、ログ、およびトレース ファイルもこのディレクトリに書き込まれます。  ユーザー インスタンスには、ユーザーごとに一意の名前が生成されます。  
+  
+ 既定では、Windows Builtin\\Users グループのすべてのメンバーには、ローカル インスタンスへの接続のほか、SQL Server プログラム ファイルの読み取りと実行のための権限が付与されます。  ユーザー インスタンスをホストする呼び出し元ユーザーの資格情報が検証されると、そのユーザーは、そのインスタンスの `sysadmin` になります。  ユーザー インスタンスに対して有効になるのは共有メモリだけです。つまり、ローカル コンピューター上の操作以外は実行できません。  
+  
+ ユーザーには、接続文字列で指定された .mdf ファイルと .ldf ファイルについて、読み取りと書き込みの両方の権限が付与されている必要があります。  
+  
+> [!NOTE]
+>  .mdf ファイルと .ldf ファイルは、それぞれデータベース ファイルおよびログ ファイルを表します。  この 2 つのファイルはペアで存在するため、バックアップや復元操作を行う際は注意が必要です。  データベース ファイルには、ログ ファイルの正確なバージョンについての情報が格納されており、間違ったログ ファイルとペアになっていると、データベースを開くことはできません。  
+  
+ データの破損を防ぐため、ユーザー インスタンスのデータベースは排他アクセスで開かれます。  同じコンピューター上の同じデータベースを 2 つの異なるユーザー インスタンスで共有する場合は、一方のインスタンスのユーザーがデータベースを閉じる必要があります。データベースを閉じない限り、もう一方のインスタンスでそのデータベースを開くことはできません。  
+  
+## ユーザー インスタンスのシナリオ  
+ データベース アプリケーションの開発者は、ユーザー インスタンスを使用することで、開発コンピューター上に自分の管理者アカウントがなくても、SQL Server のデータ ストアを自由に利用できるようになります。  ユーザー インスタンスは Access\/Jet モデルをベースとしています。つまり、データベース アプリケーションは単にファイルにアクセスするだけです。ユーザーには、すべてのデータベース オブジェクトに対する完全な権限が自動的に割り当てられます。システム管理者に権限を付与してもらう必要はありません。  サーバー コンピューターまたはローカル コンピューター上の管理特権を持たず、LUA \(最小限の特権しか持たないユーザー アカウント\) を使用しているユーザーが、データベース オブジェクトやアプリケーションを作成するケースもあります。ユーザー インスタンスには、こうした作業が想定されています。  ユーザー インスタンスを使って実行時にインスタンスを作成することで、より高い特権を持つシステム サービスのセキュリティ コンテキストではなく、そのユーザー自身のセキュリティ コンテキストでインスタンスを実行できます。  
+  
+> [!IMPORTANT]
+>  ユーザー インスタンスは、それを使用するすべてのアプリケーションが完全に信頼できる場合以外は使用しないでください。  
+  
+ ユーザー インスタンスのシナリオ  
+  
+-   データの共有を必要としないシングル ユーザー アプリケーション。  
+  
+-   ClickOnce 配置。  .NET Framework 2.0 以降および SQL Server Express が既にターゲット コンピューターにインストールされている場合、管理者以外のユーザーでも、ClickOnce アクションの結果としてダウンロードされたインストール パッケージをインストールして使用できます。  ただし、SQL Server Express がセットアップの一部として含まれている場合は、管理者が SQL Server Express をインストールする必要があります。  詳細については、「[ClickOnce Deployment for Windows Forms Applications](http://msdn.microsoft.com/ja-jp/34d8c770-48f2-460c-8d67-4ea5684511df)」を参照してください。  
+  
+-   Windows 認証を使用した ASP.NET 専用ホスティング。  イントラネット上で、単一の SQL Server Express インスタンスをホストできます。  アプリケーションは、権限の借用ではなく、ASPNET Windows アカウントを使ってこのインスタンスに接続することになります。  サードパーティ製品を使ったホスティングや共有ホスティングのシナリオでユーザー インスタンスを使用することは避けてください。すべてのアプリケーションで同じユーザー インスタンスが使用され、アプリケーションを互いに分離することができなくなります。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [接続文字列](../../../../../docs/framework/data/adonet/connection-strings.md)   
+ [データ ソースへの接続](../../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-features-and-adonet.md b/docs/framework/data/adonet/sql/sql-server-features-and-adonet.md
new file mode 100644
index 00000000000..10e408169aa
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-features-and-adonet.md
@@ -0,0 +1,61 @@
+---
+title: "SQL Server の機能と ADO.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2839529b-a79b-4450-be5d-07a98dbc7a0f
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# SQL Server の機能と ADO.NET
+このセクションのトピックでは、ADO.NET を使用したデータベース アプリケーションの開発を目的とする SQL Server の機能について説明します。  
+  
+ 詳細については、次の表に示すように、使用する SQL Server のバージョンに対応した SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [開発 \(データベース エンジン\)](http://go.microsoft.com/fwlink/?LinkId=115245)  
+  
+## このセクションの内容  
+ [SQL Server のインスタンスの列挙 \(ADO.NET\)](../../../../../docs/framework/data/adonet/sql/enumerating-instances-of-sql-server.md)  
+ SQL Server のアクティブなインスタンスを列挙する方法について説明します。  
+  
+ [SQL Server のプロバイダー統計情報](../../../../../docs/framework/data/adonet/sql/provider-statistics-for-sql-server.md)  
+ SQL Server の実行時の統計情報の取得のサポートについて説明します。  
+  
+ [SQL Server Express ユーザー インスタンス](../../../../../docs/framework/data/adonet/sql/sql-server-express-user-instances.md)  
+ SQL Server Express のユーザー インターフェイスのサポートについて説明します。  
+  
+ [SQL Server のデータベース ミラーリング](../../../../../docs/framework/data/adonet/sql/database-mirroring-in-sql-server.md)  
+ データベース ミラーリング機能について説明します。  
+  
+ [SQL Server の共通言語ランタイム統合](../../../../../docs/framework/data/adonet/sql/sql-server-common-language-runtime-integration.md)  
+ SQL Server で共通言語ランタイム \(CLR\) データベース オブジェクトからデータにアクセスする方法について説明します。  
+  
+ [SQL Server のクエリ通知](../../../../../docs/framework/data/adonet/sql/query-notifications-in-sql-server.md)  
+ .NET Framework アプリケーションで、データが変更されている場合に SQL Server に対して通知を要求する方法について説明します。  
+  
+ [SQL Server でのスナップショット分離](../../../../../docs/framework/data/adonet/sql/snapshot-isolation-in-sql-server.md)  
+ トランザクション アプリケーションでのブロックの軽減を目的とする行バージョン管理機構であるスナップショット分離のサポートについて説明します。  
+  
+ [高可用性障害復旧のための SqlClient サポート](../../../../../docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md)  
+ 高可用性障害回復 \(AlwaysOn\) 可用性グループの SqlClient サポートについて説明します。  
+  
+ [SqlClient による LocalDB のサポート](../../../../../docs/framework/data/adonet/sql/sqlclient-support-for-localdb.md)  
+ LocalDB データベースの SqlClient サポートについて説明します。  
+  
+## 参照  
+ [ADO.NET における SQL Server データ操作](../../../../../docs/framework/data/adonet/sql/sql-server-data-operations.md)   
+ [ADO.NET でのデータの取得および変更](../../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [LINQ to SQL](../../../../../docs/framework/data/adonet/sql/linq/index.md)   
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-in-process-specific-behavior-of-adonet.md b/docs/framework/data/adonet/sql/sql-server-in-process-specific-behavior-of-adonet.md
new file mode 100644
index 00000000000..d523c3ca52b
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-in-process-specific-behavior-of-adonet.md
@@ -0,0 +1,30 @@
+---
+title: "SQL Server のインプロセス固有の ADO.NET の動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f223948-ae8f-4c16-bdc2-4acc6debed3f
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# SQL Server のインプロセス固有の ADO.NET の動作
+<xref:Microsoft.SqlServer.Server> 名前空間には、インプロセスのみで使用される 4 つの主な ADO.NET の拡張機能として、<xref:Microsoft.SqlServer.Server.SqlContext>、<xref:Microsoft.SqlServer.Server.SqlPipe>、<xref:Microsoft.SqlServer.Server.SqlTriggerContext>、<xref:Microsoft.SqlServer.Server.SqlDataRecord> があります。  
+  
+ 詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [SQL Server ADO.NET のインプロセス固有の拡張](http://go.microsoft.com/fwlink/?LinkId=115403)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-server-security.md b/docs/framework/data/adonet/sql/sql-server-security.md
new file mode 100644
index 00000000000..61b2f47d7f9
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-server-security.md
@@ -0,0 +1,52 @@
+---
+title: "SQL Server のセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9053724d-a1fb-4f0f-b9dc-7f6dd893e8ff
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# SQL Server のセキュリティ
+[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] には、安全なデータベース アプリケーションの作成を支援するさまざまな機能が備わっています。  
+  
+ データの盗難や破壊など、セキュリティに関する基本的な考慮事項は、使用している [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のバージョンに関係なく当てはまります。  また、データの整合性もセキュリティの問題として考慮する必要があります。  データの保護を怠り、その場しのぎでデータの操作を許可すると、不注意でまたは意図的に不正確な値に置き換えられたり、完全に削除されてしまうことによってデータの価値が失われてしまうこともあります。  加えて、機密情報の適切な保管方法など、遵守すべき法的要件が存在します。  特定の司法管轄域の法令によっては、一部の種類の個人データについて、保管すること自体が完全に禁止されている場合もあります。  
+  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の各バージョンにはそれぞれ異なるセキュリティ機能があり、Windows と同様、新しいバージョンほど機能が強化されています。  ただし、セキュリティ機能だけでは、データベース アプリケーションの安全性は保証されません。この点を理解することが重要です。  データベース アプリケーションの要件、実行環境、配置モデル、物理的な場所、およびユーザー数は、アプリケーションごとに異なります。  使用範囲がローカルに限定されている一部のアプリケーションでは最小限のセキュリティで済む場合もありますが、インターネット経由で配置されたアプリケーションには、きわめて強固なセキュリティ対策と継続的な監視および評価が要求されます。  
+  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] データベース アプリケーションのセキュリティ要件は、事後的対策としてではなく設計時に考慮することが大切です。  開発サイクルの初期段階で脅威を評価すれば、どこで脆弱性が見つかろうと潜在的な損害を緩和する機会は得ることができます。  
+  
+ アプリケーションの初期設計に問題がなくても、システムの進化に伴って新しい脅威が出現する可能性があります。  データベースを多層的に防御することにより、セキュリティ侵害によって受ける損害を最小限に抑えることができます。  防御の第 1 段階は、本当に必要な権限以外は決して付与しないという方針の下、攻撃者に与える隙を減らすことです。  
+  
+ このセクションの各トピックでは、開発者に関係のある [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のセキュリティ機能を簡単に説明します。[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの関連項目へのリンクのほか、より掘り下げて解説したリソースへのリンクも示しています。  
+  
+## このセクションの内容  
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のアーキテクチャおよびセキュリティ機能について説明します。  
+  
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)  
+ ADO.NET および [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] アプリケーションに該当するさまざまなセキュリティ シナリオを取り上げます。  
+  
+ [SQL Server Express のセキュリティ](../../../../../docs/framework/data/adonet/sql/sql-server-express-security.md)  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] Express のセキュリティ上の考慮事項について説明します。  
+  
+## 関連項目  
+ [セキュリティと保護 \(データベース エンジン\)](http://msdn2.microsoft.com/library/bb510589\(SQL.100\).aspx.)  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックのセキュリティ トピックです。  
+  
+ [SQL Server のセキュリティの考慮事項](http://go.microsoft.com/fwlink/?LinkId=98587)  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックのセキュリティ トピックです。  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET マネージ プロバイダーおよび DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sql-xml-column-values.md b/docs/framework/data/adonet/sql/sql-xml-column-values.md
new file mode 100644
index 00000000000..87535c120c4
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sql-xml-column-values.md
@@ -0,0 +1,34 @@
+---
+title: "SQL XML 列値 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d97ce4da-f09c-4d1e-85b7-a0ccedd7246a
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL XML 列値
+[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、新たに `xml` データ型をサポートしています。開発者は、<xref:System.Data.SqlClient.SqlCommand> クラスの標準動作を使用して、この型を含む結果セットを取得することができます。  `xml` 列は、その他の列と同じようにして \(<xref:System.Data.SqlClient.SqlDataReader> などに\) 取得することができますが、その列の内容を XML として使用する場合は、<xref:System.Xml.XmlReader> を使用する必要があります。  
+  
+## 例  
+ 次のコンソール アプリケーションでは、**AdventureWorks** データベースの **Sales.Store** テーブルから 2 行を選択し、この行の `xml` 列を <xref:System.Data.SqlClient.SqlDataReader> インスタンスに格納します。  それぞれの行について、`xml` 列の値は、<xref:System.Data.SqlClient.SqlDataReader> の <xref:System.Data.SqlClient.SqlDataReader.GetSqlXml%2A> メソッドを使用して読み取ります。  値は、<xref:System.Xml.XmlReader> に格納されます。  内容を <xref:System.Data.SqlTypes.SqlXml> 変数に設定する場合は、<xref:System.Data.IDataRecord.GetValue%2A> メソッドではなく <xref:System.Data.SqlClient.SqlDataReader.GetSqlXml%2A> を使用する必要があることに注意してください。<xref:System.Data.IDataRecord.GetValue%2A> は、`xml` 列の値を文字列として返します。  
+  
+> [!NOTE]
+>  **AdventureWorks** サンプル データベースは、既定では [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] のインストール時にはインストールされません。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] Setup を実行してインストールします。  
+  
+ [!code-csharp[DataWorks SqlClient.GetXmlDataReader#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.GetXmlDataReader/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.GetXmlDataReader#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.GetXmlDataReader/VB/source.vb#1)]  
+  
+## 参照  
+ <xref:System.Data.SqlTypes.SqlXml>   
+ [SQL Server における XML データ](../../../../../docs/framework/data/adonet/sql/xml-data-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md b/docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md
new file mode 100644
index 00000000000..7f57113eeb6
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md
@@ -0,0 +1,105 @@
+---
+title: "高可用性障害復旧のための SqlClient サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61e0b396-09d7-4e13-9711-7dcbcbd103a0
+caps.latest.revision: 13
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 13
+---
+# 高可用性障害復旧のための SqlClient サポート
+このトピックでは、高可用性、障害回復のための SqlClient サポート \([!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)] に追加\) である AlwaysOn 可用性グループについて説明します。  AlwaysOn 可用性グループの機能は [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 に追加されています。  AlwaysOn 可用性グループの詳細については、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックを参照してください。  
+  
+ 現在は、接続プロパティで、\(高可用性、障害回復\) 可用性グループ \(AG\) の高可用性グループ リスナーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスを指定できます。  フェールオーバーが発生した AlwaysOn データベースに SqlClient アプリケーションが接続される場合、元の接続が途切れるため、アプリケーションがフェールオーバーの後に処理を続行するには、新しい接続を開く必要があります。  
+  
+ 可用性グループ リスナーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスに接続していない場合、複数の IP アドレスがホスト名に関連付けられていると、SqlClient は、DNS エントリに関連付けられたすべての IP アドレスを順に反復処理します。  これは、DNS サーバーによって返された最初の IP アドレスがネットワーク インターフェイス カード \(NIC\) にバインドされていない場合、時間がかかります。  可用性グループ リスナーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスに接続する場合、SqlClient ですべての IP アドレスへの接続確立を並列実行しようとして、接続試行が成功すると、ドライバーは保留状態の接続試行を破棄します。  
+  
+> [!NOTE]
+>  接続タイムアウトの増加および接続の再試行ロジックの実装により、アプリケーションが可用性グループに接続する可能性は向上します。  また、接続がフェールオーバーによって失敗する可能性があるので、接続の再試行ロジックの実装は、失敗した接続が再接続するまで試行されるようにする必要があります。  
+  
+ 次の接続プロパティが、[!INCLUDE[net_v45](../../../../../includes/net-v45-md.md)] の SqlClient に追加されました。  
+  
+-   `ApplicationIntent`  
+  
+-   `MultiSubnetFailover`  
+  
+ プログラムによって、これらの接続文字列キーワードを次のとおりに変更できます。  
+  
+1.  <xref:System.Data.SqlClient.SqlConnectionStringBuilder.ApplicationIntent%2A>  
+  
+2.  <xref:System.Data.SqlClient.SqlConnectionStringBuilder.MultiSubnetFailover%2A>  
+  
+## MultiSubnetFailover を使用した接続  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 可用性グループ リスナーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスに接続する場合は、`MultiSubnetFailover=True` を必ず指定します。  `MultiSubnetFailover` を使用すると、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 のすべての可用性グループやフェールオーバー クラスター インスタンスのより高速なフェールオーバーが可能になるため、単一または複数のサブネットの AlwaysOn トポロジのフェールオーバー時間が削減されます。  複数のサブネットのフェールオーバーでは、クライアントは並列接続を試みます。  サブネットのフェールオーバー中に、積極的に TCP 接続を再試行します。  
+  
+ `MultiSubnetFailover` 接続プロパティは、アプリケーションが可用性グループまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスで展開されていること、およびすべての IP アドレスへの接続を試行することで SqlClient がプライマリ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンスのデータベースに接続を試行することを示します。  `MultiSubnetFailover=True` を接続に指定すると、クライアントは、オペレーティング システムの既定の TCP 再転送間隔よりも高速に接続試行を再試行します。  これは、AlwaysOn 可用性グループまたは AlwaysOn フェールオーバー クラスター インスタンスのフェールオーバー後のより高速な再接続を可能にし、単一および複数のサブネットの可用性グループおよびフェールオーバー クラスター インスタンスの両方に適用可能です。  
+  
+ SqlClient の接続文字列キーワードの詳細については、<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> を参照してください。  
+  
+ 可用性グループ リスナーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンス以外の何かに接続する場合に `MultiSubnetFailover=True` を指定すると、パフォーマンスに負の影響が及ぶ可能性があるため、サポートされていません。  
+  
+ 可用性グループのサーバーまたは [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 フェールオーバー クラスター インスタンスに接続するには、次のガイドラインに従います。  
+  
+-   単一のサブネットまたは複数のサブネットへの接続時には、`MultiSubnetFailover` 接続プロパティを使用します。これにより、両方の場合でパフォーマンスが向上します。  
+  
+-   可用性グループに接続するには、使用する接続文字列でサーバーとして可用性グループの可用性グループ リスナーを指定します。  
+  
+-   64 を超える IP アドレスを使用して構成されている [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンスに接続すると、接続エラーが発生します。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 認証、Kerberos 認証、および Windows 認証という認証の種類に基づいて  `MultiSubnetFailover` 接続プロパティを使用するアプリケーションの動作には影響はありません。  
+  
+-   フェールオーバー時に対応し、アプリケーションの接続の再試行を減らすには、`Connect Timeout` の値を増やします。  
+  
+-   分散トランザクションはサポートされていません。  
+  
+ 読み取り専用のルーティングが有効でない場合は、セカンダリ レプリカの場所への接続は、次の場合に失敗します。  
+  
+1.  セカンダリ レプリカの場所が接続を受け入れないように構成されている場合。  
+  
+2.  アプリケーションが `ApplicationIntent=ReadWrite` \(後で説明\) を使用している場合、セカンダリ レプリカの場所は読み取り専用アクセスとして構成されます。  
+  
+ <xref:System.Data.SqlClient.SqlDependency> は、読み取り専用のセカンダリ レプリカではサポートされていません。  
+  
+ プライマリ レプリカが読み取り専用のワークロードを拒否するように設定され、接続文字列が  `ApplicationIntent=ReadOnly` を含んでいる場合、接続は失敗します。  
+  
+## データベース ミラーリングから複数のサブネット クラスターを使用するためのアップグレード  
+ 接続エラー \(<xref:System.ArgumentException>\) は、`MultiSubnetFailover` および `Failover Partner` 接続のキーワードが接続文字列内に存在する場合や、`MultiSubnetFailover=True` および TCP 以外のプロトコルが使用された場合に発生します。  エラー \(<xref:System.Data.SqlClient.SqlException>\) は、`MultiSubnetFailover` が使用され、フェールオーバー パートナーがデータベース ミラーリング ペアの一部であることを示す応答を [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] が返した場合にも発生します。  
+  
+ 現在データベース ミラーリングを使用している SqlClient アプリケーションを複数のサブネットのシナリオへとアップグレードする場合、`Failover Partner` 接続プロパティを削除し、`True` に設定した `MultiSubnetFailover` で置き換え、接続文字列のサーバー名を可用性グループ リスナーと置き換える必要があります。  接続文字列が `Failover Partner` および `MultiSubnetFailover=True` を使用していると、ドライバーがエラーを生成します。  ただし、接続文字列が `Failover Partner` および `MultiSubnetFailover=False` \(または  `ApplicationIntent=ReadWrite`\) を使用している場合、アプリケーションはデータベース ミラーリングを使用します。  
+  
+ データベース ミラーリングが AG のプライマリ データベースで使用される場合、および  `MultiSubnetFailover=True` が可用性グループ リスナーではなくプライマリ データベースに接続する接続文字列で使用される場合、ドライバーはエラーを返します。  
+  
+## アプリケーションの目的の指定  
+ `ApplicationIntent=ReadOnly` の場合、クライアントは AlwaysOn が有効になったデータベースに接続する場合に、読み取られたワークロードを要求します。  サーバーは、接続時および USE データベース ステートメントの間、その目的を強制しますが、AlwaysOn が有効になったデータベースに対してのみ、これを行います。  
+  
+ `ApplicationIntent` キーワードは従来の読み取り専用のデータベースでは機能しません。  
+  
+ データベースは、対象となる AlwaysOn データベースのワークロードの読み取りを許可または拒否できます。  \(これは `PRIMARY_ROLE` の `ALLOW_CONNECTIONS` 句および `SECONDARY_ROLE` [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] ステートメントを使用して行います。\)  
+  
+ `ApplicationIntent` キーワードは、読み取り専用のルーティングを有効にするために使用されます。  
+  
+## 読み取り専用ルーティング  
+ 読み取り専用のルーティングはデータベースの読み取り専用のレプリカの可用性を確保できる機能です。  読み取り専用のルーティングを有効にするには次のことが必要です。  
+  
+1.  AlwaysOn 可用性グループの可用性グループ リスナーに接続する必要があります。  
+  
+2.  `ApplicationIntent` 接続文字列キーワードを `ReadOnly` に設定する必要があります。  
+  
+3.  可用性グループは、データベース管理者によって、読み取り専用のルーティングを有効にするように構成される必要があります。  
+  
+ 読み取り専用のルーティングを使用する複数の接続のすべてが、同じ読み取り専用のレプリカに接続しないようにすることができます。  データベースの同期変更またはサーバーのルーティング構成の変更は、異なる読み取り専用のレプリカに対するクライアントの接続につながることがあります。  すべての読み取り専用の要求が、確実に同じ読み取り専用のレプリカに接続するようにするには、`Data Source` 接続文字列キーワードに可用性グループ リスナーを渡さないでください。  代わりに、読み取り専用のインスタンスの名前を指定します。  
+  
+ 読み取り専用のルーティングでは、最初にプライマリに接続し、最適な可用性の読み取り可能なセカンダリを検索するため、プライマリに接続するよりも時間がかかる場合があります。  そのため、ログインのタイムアウトを増やす必要があります。  
+  
+## 参照  
+ [SQL Server の機能と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-features-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sqlclient-support-for-localdb.md b/docs/framework/data/adonet/sql/sqlclient-support-for-localdb.md
new file mode 100644
index 00000000000..633922007cf
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sqlclient-support-for-localdb.md
@@ -0,0 +1,58 @@
+---
+title: "SqlClient による LocalDB のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf796898-5575-46f2-ae6e-21e5aa8c4123
+caps.latest.revision: 14
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 14
+---
+# SqlClient による LocalDB のサポート
+コード名 Denali 以降の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、LocalDB という軽量バージョンの [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] を使用できます。 このトピックでは、LocalDB データベースに接続する方法について説明します。  
+  
+## 解説  
+ LocalDB をインストールする方法と LocalDB インスタンスを構成する方法を含む LocalDB の詳細については、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックを参照してください。  
+  
+ LocalDB の主な機能の概要  
+  
+-   sqllocaldb.exe または app.config ファイルを使用して LocalDB インスタンスを作成および開始する。  
+  
+-   sqlcmd.exe を使用して LocalDB インスタンスにデータベースを追加および変更する。 たとえば、`sqlcmd -S (localdb)\myinst` のようにします。  
+  
+-   `AttachDBFilename` 接続文字列キーワードを使用して LocalDB インスタンスにデータベースを追加する。`AttachDBFilename` を使用していて、`Database` 接続文字列キーワードでデータベースの名前を指定しない場合、アプリケーションを閉じると、データベースは LocalDB インスタンスから削除されます。  
+  
+-   接続文字列に LocalDB インスタンスを指定する。 たとえば、インスタンス名が `myInstance` の場合、接続文字列には次の行が含まれます。  
+  
+    ```  
+    server=(localdb)\\myInstance  
+    ```  
+  
+ `User Instance=True` は LocalDB データベースに接続するときに使用することはできません。  
+  
+ LocalDB は [Microsoft SQL Server 2012 Feature Pack](http://www.microsoft.com/download/en/details.aspx?id=29065) からダウンロードできます。 LocalDB インスタンスのデータを変更するために sqlcmd.exe を使用する場合は、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 の sqlcmd が必要です。これも、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2012 Feature Pack から取得できます。  
+  
+## 名前付きインスタンスをプログラムによって作成する  
+ アプリケーションは、次のように名前付きインスタンスを作成してデータベースを指定できます。  
+  
+-   app.config ファイルに作成するための LocalDB インスタンスを次のように指定する。  インスタンスのバージョン番号は LocalDB インストールのバージョン番号と同じである必要があります。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?> <configuration> <configSections> <section name="system.data.localdb" type="System.Data.LocalDBConfigurationSection,System.Data,Version=4.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"/> </configSections> <system.data.localdb> <localdbinstances> <add name="myInstance" version="11.0" /> </localdbinstances> </system.data.localdb> </configuration>  
+    ```  
+  
+-   `server` 接続文字列キーワードを使用してインスタンス名を指定する。`server` 接続文字列キーワードで指定されたインスタンス名は app.config ファイルで指定された名前と一致する必要があります。  
+  
+-   .MDF ファイルを指定するには、`AttachDBFilename` 接続文字列キーワードを使用する。  
+  
+## 参照  
+ [SQL Server の機能と ADO.NET](../../../../../docs/framework/data/adonet/sql/sql-server-features-and-adonet.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sqlcommand-execution-with-a-sqlnotificationrequest.md b/docs/framework/data/adonet/sql/sqlcommand-execution-with-a-sqlnotificationrequest.md
new file mode 100644
index 00000000000..60c6d82e5aa
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sqlcommand-execution-with-a-sqlnotificationrequest.md
@@ -0,0 +1,80 @@
+---
+title: "SqlCommand の実行と SqlNotificationRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1776f48f-9bea-41f6-83a4-c990c7a2c991
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# SqlCommand の実行と SqlNotificationRequest
+サーバーからフェッチした後で、データが変更される場合があります。当然、もう一度クエリを実行すると、前回とは異なる結果セットが得られます。<xref:System.Data.SqlClient.SqlCommand> を適切に構成することで、このような場合に通知を生成することができます。  この機能は、サーバー上でカスタムの通知キューを使用する場合や、実際のオブジェクトを保持しない場合に役に立ちます。  
+  
+## 通知要求の作成  
+ <xref:System.Data.Sql.SqlNotificationRequest> オブジェクトを使用して通知要求を作成し、それを `SqlCommand` オブジェクトにバインドできます。  いったん要求が作成されれば、`SqlNotificationRequest` オブジェクトは不要です。  通知がないかどうかをキューに照会し、適宜、それに応じた処理を行うことができます。  通知は、アプリケーションをシャットダウンしてから再起動した場合でも受けることができます。  
+  
+ コマンドに通知を関連付けて実行した場合、元の結果セットになんらかの変更が生じると、通知要求で構成した SQL Server キューにメッセージが送信されます。  
+  
+ SQL Server のキューをポーリングしメッセージを解釈する方法は、アプリケーションごとに固有なものになります。  メッセージの内容に基づくキューのポーリングや処理は、アプリケーションによって異なります。  
+  
+> [!NOTE]
+>  <xref:System.Data.SqlClient.SqlDependency> によって SQL Server 通知要求を使用する場合は、既定のサービス名を使用せずにキュー名を独自に作成します。  
+  
+ <xref:System.Data.Sql.SqlNotificationRequest> についてクライアント側に新しいセキュリティ要素はありません。  これは主にサーバーの機能であり、サーバーでは通知を要求するために必要となるユーザーの特権を設定します。  
+  
+### 例  
+ 次のコード フラグメントは、<xref:System.Data.Sql.SqlNotificationRequest> を作成し、それを <xref:System.Data.Sql.SqlCommand> に関連付ける方法を示しています。  
+  
+```vb  
+' Assume connection is an open SqlConnection.  
+' Create a new SqlCommand object.  
+Dim command As New SqlCommand( _  
+  "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers", connection)  
+  
+' Create a SqlNotificationRequest object.  
+Dim notficationRequest As New SqlNotificationRequest()  
+notficationRequest.id = "NotificationID"  
+notficationRequest.Service = "mySSBQueue"  
+  
+' Associate the notification request with the command.  
+command.Notification = notficationRequest  
+' Execute the command.  
+command.ExecuteReader()  
+' Process the DataReader.  
+' You can use Transact-SQL syntax to periodically poll the   
+' SQL Server queue to see if you have a new message.  
+```  
+  
+```csharp  
+// Assume connection is an open SqlConnection.  
+// Create a new SqlCommand object.  
+SqlCommand command=new SqlCommand(  
+ "SELECT ShipperID, CompanyName, Phone FROM dbo.Shippers", connection);  
+  
+// Create a SqlNotificationRequest object.  
+SqlNotificationRequest notficationRequest=new SqlNotificationRequest();  
+notficationRequest.id="NotificationID";  
+notficationRequest.Service="mySSBQueue";  
+  
+// Associate the notification request with the command.  
+command.Notification=notficationRequest;  
+// Execute the command.  
+command.ExecuteReader();  
+// Process the DataReader.  
+// You can use Transact-SQL syntax to periodically poll the   
+// SQL Server queue to see if you have a new message.  
+  
+```  
+  
+## 参照  
+ [SQL Server のクエリ通知](../../../../../docs/framework/data/adonet/sql/query-notifications-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sqldependency-in-an-aspnet-app.md b/docs/framework/data/adonet/sql/sqldependency-in-an-aspnet-app.md
new file mode 100644
index 00000000000..81bb7048b53
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sqldependency-in-an-aspnet-app.md
@@ -0,0 +1,67 @@
+---
+title: "ASP.NET アプリケーションでの SqlDependency | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff226ce3-f6b5-47a1-8d22-dc78b67e07f5
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# ASP.NET アプリケーションでの SqlDependency
+ここでは、ASP.NET の <xref:System.Web.Caching.SqlCacheDependency> オブジェクトを使用して、<xref:System.Data.SqlClient.SqlDependency> を間接的に使用する方法の例を示します。  <xref:System.Web.Caching.SqlCacheDependency> オブジェクトでは <xref:System.Data.SqlClient.SqlDependency> を使用して通知をリッスンし、キャッシュを適切に更新します。  
+  
+> [!NOTE]
+>  このサンプル コードを実行するには、「[クエリ通知の有効化](../../../../../docs/framework/data/adonet/sql/enabling-query-notifications.md)」のスクリプトを実行してクエリ通知を有効にしておく必要があります。  
+  
+## サンプル アプリケーションについて  
+ このサンプル アプリケーションでは、1 つの ASP.NET Web ページを使用して、SQL Server データベースである **AdventureWorks** に格納されている製品情報を <xref:System.Web.UI.WebControls.GridView> コントロールに表示します。  ページが読み込まれる際に、<xref:System.Web.UI.WebControls.Label> コントロールに現在の時刻が入力されます。  次に、<xref:System.Web.Caching.SqlCacheDependency> オブジェクトを定義し、最長 3 分間キャッシュ データを格納するように <xref:System.Web.Caching.Cache> オブジェクトのプロパティを設定します。  その後、データベースに接続し、データを取得します。  ページが読み込まれ、アプリケーションが実行されると、ASP.NET ではキャッシュからデータが取得されます。これは、ページ上の時刻が変更されないことで確認できます。  監視しているデータが変化すると、ASP.NET によりキャッシュが無効化され、`GridView` コントロールに最新データが再入力されることで、`Label` コントロールに表示される時刻が更新されます。  
+  
+## サンプル アプリケーションの作成  
+ サンプル アプリケーションを作成して実行するには、次の手順に従います。  
+  
+1.  新しい ASP.NET Web サイトを作成します。  
+  
+2.  Default.aspx ページに <xref:System.Web.UI.WebControls.Label> コントロールと <xref:System.Web.UI.WebControls.GridView> コントロールを追加します。  
+  
+3.  ページのクラス モジュールを開き、次のディレクティブを追加します。  
+  
+    ```vb  
+  
+    Option Strict On  
+    Option Explicit On  
+  
+    Imports System.Data.SqlClient  
+    ```  
+  
+    ```csharp  
+    using System.Data.SqlClient;  
+    using System.Web.Caching;  
+    ```  
+  
+4.  ページの `Page_Load` イベントに次のコードを追加します。  
+  
+     [!code-csharp[DataWorks SqlDependency.AspNet#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlDependency.AspNet/CS/Default.aspx.cs#1)]
+     [!code-vb[DataWorks SqlDependency.AspNet#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlDependency.AspNet/VB/Default.aspx.vb#1)]  
+  
+5.  `GetConnectionString` および `GetSQL` という 2 つのヘルパー メソッドを追加します。  定義される接続文字列は、統合セキュリティを利用します。  使用しているアカウントが、必要とされるデータベースへのアクセス許可を持っており、サンプル データベースの **AdventureWorks** で通知が有効になっていることを確認する必要があります。  詳細については、「[Special Considerations When Using Query Notifications](http://msdn.microsoft.com/ja-jp/a83c8dc8-4fb9-4ffd-a2a5-c07cf4a203c7)」を参照してください。  
+  
+     [!code-csharp[DataWorks SqlDependency.AspNet#2](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlDependency.AspNet/CS/Default.aspx.cs#2)]
+     [!code-vb[DataWorks SqlDependency.AspNet#2](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlDependency.AspNet/VB/Default.aspx.vb#2)]  
+  
+### アプリケーションのテスト  
+ このアプリケーションは Web フォームに表示されるデータをキャッシングし、操作が行われなければ 3 分ごとにデータを更新します。  データベースに変化があれば、キャッシュは直ちに更新されます。  Visual Studio からアプリケーションを実行すると、ブラウザーにページが読み込まれます。  表示されるキャッシュ更新時刻は、最後にキャッシュが更新された時刻を示します。  3 分間の待機後、ページを更新し、ポストバック イベントが発生します。  ページに表示される時刻が変更されることに注意してください。  3 分経過する前にページを更新した場合は、ページに表示される時刻は変わりません。  
+  
+ 次に、Transact\-SQL の UPDATE コマンドを使用して、データベースのデータを更新し、ページを更新します。  表示される時刻を見ると、データベースの新しいデータを使ってキャッシュが更新されたことがわかります。  キャッシュは更新されますが、ページに表示される時刻はポストバック イベントが発生するまで変更されないことに注意してください。  
+  
+## 参照  
+ [SQL Server のクエリ通知](../../../../../docs/framework/data/adonet/sql/query-notifications-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/sqltypes-and-the-dataset.md b/docs/framework/data/adonet/sql/sqltypes-and-the-dataset.md
new file mode 100644
index 00000000000..ee2c7419737
--- /dev/null
+++ b/docs/framework/data/adonet/sql/sqltypes-and-the-dataset.md
@@ -0,0 +1,33 @@
+---
+title: "SqlTypes と DataSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9172c20a-9876-4b3b-9c97-1963c02b1993
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# SqlTypes と DataSet
+ADO.NET 2.0 では、<xref:System.Data.SqlTypes> 名前空間を介した `DataSet` の型のサポートが拡張されました。  <xref:System.Data.SqlTypes> の型は、SQL Server データベースのデータ型と同じセマンティクスと有効桁数を備えたデータ型を用意するように設計されています。  <xref:System.Data.SqlType> の個々のデータ型には、それに相当する SQL Server のデータ型があり、基本となるデータ表現はいずれも同じです。  
+  
+ <xref:System.Data.DataSet> で直接 <xref:System.Data.SqlTypes> を使用できると、SQL Server データ型を操作するときに便利です。  <xref:System.Data.SqlTypes> は、SQL Server ネイティブのデータ型と同じセマンティクスをサポートしています。  <xref:System.Data.DataColumn> の定義でいずれかの <xref:System.Data.SqlTypes> を指定することで、decimal データ型または numeric データ型をいずれかの共通言語ランタイム \(CLR\) データ型に変換するときの精度の低下を防止します。  
+  
+## 例  
+ 次の例では、<xref:System.Data.DataTable> オブジェクトを作成し、CLR データ型の代わりに <xref:System.Data.SqlTypes> を使用して、<xref:System.Data.DataColumn> のデータ型を明示的に定義します。  このコードは、SQL Server の AdventureWorks データベースの Sales.SalesOrderDetail テーブルから取得されたデータを <xref:System.Data.DataTable> に挿入します。  コンソール ウィンドウには、各列のデータ型および SQL Server から取得された値が表示されます。  
+  
+ [!code-csharp[DataWorks SqlTypes.GetTypeAW#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlTypes.GetTypeAW/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlTypes.GetTypeAW#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlTypes.GetTypeAW/VB/source.vb#1)]  
+  
+## 参照  
+ [SQL Server データ型のマッピング](../../../../../docs/framework/data/adonet/sql-server-data-type-mappings.md)   
+ [パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/table-valued-parameters.md b/docs/framework/data/adonet/sql/table-valued-parameters.md
new file mode 100644
index 00000000000..a0a26084eaa
--- /dev/null
+++ b/docs/framework/data/adonet/sql/table-valued-parameters.md
@@ -0,0 +1,296 @@
+---
+title: "テーブル値パラメーター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 370c16d5-db7b-43e3-945b-ccaab35b739b
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# テーブル値パラメーター
+テーブル値パラメーターを使用すると、ラウンド トリップを何度も繰り返したり、サーバー側にデータを処理するための特殊なロジックを組み込んだりすることなく、複数行のデータをクライアント アプリケーションから [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] へと簡単にマーシャリングできます。  テーブル値パラメーターを使用すると、クライアント アプリケーションのデータ行をカプセル化して単一のパラメーター化コマンドでサーバーに送ることができます。  受信データ行はテーブル変数に格納され、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] によって操作できるようになります。  
+  
+ テーブル値パラメーターの列値には、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の標準的な SELECT ステートメントを使ってアクセスできます。  テーブル値パラメーターは厳密に型指定されており、その構造は自動的に検証されます。  テーブル値パラメーターのサイズは、サーバーのメモリによってのみ制限されます。  
+  
+> [!NOTE]
+>  テーブル値パラメーターにデータを取得することはできません。  テーブル値パラメーターは入力専用です。OUTPUT キーワードはサポートされません。  
+  
+ テーブル値パラメーターの詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[テーブル値パラメーター \(データベース エンジン\)](http://go.microsoft.com/fwlink/?LinkId=98363)」|テーブル値パラメーターの作成方法および使用方法について説明します。|  
+|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[ユーザー定義のテーブル型](http://go.microsoft.com/fwlink/?LinkId=98364)」|テーブル値パラメーターを宣言する際に使用するユーザー定義テーブル型について説明します。|  
+|「[CodePlex](http://go.microsoft.com/fwlink/?LinkID=67739)」の「[Microsoft SQL Server データベース エンジン](http://go.microsoft.com/fwlink/?LinkId=120507)」セクション|[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] の機能の使用方法を示すサンプルがあります。|  
+  
+## 旧バージョンの SQL Server での複数行の受け渡し  
+ [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] 2008 にテーブル値パラメーターが導入されるまでは、複数行データをストアド プロシージャまたはパラメーター化 SQL コマンドに渡す方法は限られていました。  複数行をサーバーに渡す方法には、次のオプションがありました。  
+  
+-   複数のデータ列およびデータ行の値を表す一連の個別パラメーターを使用する。  この方法で渡すことのできるデータの量は、使用可能なパラメーターの数によって制限されます。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] プロシージャが持つことのできるパラメーター数は最大 2,100 です。  これらの個々の値をテーブル変数または一時テーブルにまとめて処理するには、サーバー側のロジックが必要です。  
+  
+-   複数のデータを区切られた文字列または XML ドキュメントとしてまとめ、そのテキスト値をプロシージャまたはステートメントに渡す。  これには、データ構造を検証して値を処理するためのロジックをプロシージャまたはステートメントに含める必要があります。  
+  
+-   複数の行に影響を与えるデータ変更のための一連の SQL ステートメントを作成する。たとえば、<xref:System.Data.SqlClient.SqlDataAdapter> の `Update` メソッドを呼び出すことによって作成できます。  変更はサーバーに個別に送ることもグループにまとめて送ることもできます。  ただし、複数のステートメントを含むバッチを送信しても、サーバーでは個々のステートメントが別々に実行されます。  
+  
+-   `bcp` ユーティリティ プログラムまたは <xref:System.Data.SqlClient.SqlBulkCopy> オブジェクトを使用して、多数行のデータをテーブルに読み込む。  この方法は効率的ですが、データが一時テーブルまたはテーブル変数に読み込まれなければ、サーバー側での処理がサポートされません。  
+  
+## テーブル値パラメーター型の作成  
+ テーブル値パラメーターは、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の CREATE TYPE ステートメントを使用して定義された厳密に型指定されたテーブルの構造に基づいています。  クライアント アプリケーションでテーブル値パラメーターを使用するには、まず [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] でテーブル型を作成し、その構造を定義する必要があります。  テーブル型の作成の詳細については、[!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] オンライン ブックの「[ユーザー定義のテーブル型](http://go.microsoft.com/fwlink/?LinkID=98364)」を参照してください。  
+  
+ 次のステートメントは、CategoryID と CategoryName 列から成る CategoryTableType というテーブル型を作成します。  
+  
+```  
+CREATE TYPE dbo.CategoryTableType AS TABLE  
+    ( CategoryID int, CategoryName nvarchar(50) )  
+```  
+  
+ テーブル型を作成したら、その型に基づいてテーブル値パラメーターを宣言できます。  次の [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] フラグメントは、ストアド プロシージャ定義の中でテーブル値パラメーターを宣言する方法を示しています。  テーブル値パラメーターの宣言には READONLY キーワードが必要であることに注意してください。  
+  
+```  
+CREATE PROCEDURE usp_UpdateCategories   
+    (@tvpNewCategories dbo.CategoryTableType READONLY)  
+```  
+  
+## テーブル値パラメーターによるデータの変更 \(Transact\-SQL\)  
+ テーブル値パラメーターは、単一のステートメントを実行して複数行を操作する、セット ベースのデータ変更の中で使用できます。  たとえば、テーブル値パラメーターのすべての行を選択し、それらをデータベース テーブルに挿入できます。また、テーブル値パラメーターを更新対象のテーブルに結合する更新ステートメントを作成することもできます。  
+  
+ 次の [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] UPDATE ステートメントは、テーブル値パラメーターを Categories テーブルに結合して使用する方法を示しています。  テーブル値パラメーターを FROM 句の JOIN で使用するときは、エイリアスを使用する必要があります。この例ではテーブル値パラメーターに "ec" というエイリアスが使用されています。  
+  
+```  
+UPDATE dbo.Categories  
+    SET Categories.CategoryName = ec.CategoryName  
+    FROM dbo.Categories INNER JOIN @tvpEditedCategories AS ec  
+    ON dbo.Categories.CategoryID = ec.CategoryID;  
+```  
+  
+ この [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の例は、単一のセット ベース操作で INSERT を実行するためにテーブル値パラメーターから行を選択する方法を示しています。  
+  
+```  
+INSERT INTO dbo.Categories (CategoryID, CategoryName)  
+    SELECT nc.CategoryID, nc.CategoryName FROM @tvpNewCategories AS nc;  
+```  
+  
+## テーブル値パラメーターの制限  
+ テーブル値パラメーターにはいくつかの制限があります。  
+  
+-   テーブル値パラメーターを[CLR ユーザー定義関数](http://msdn.microsoft.com/library/ms131077.aspx)に渡すことはできません。  
+  
+-   テーブル値パラメーターでは、UNIQUE 制約または PRIMARY KEY 制約をサポートするためにのみ、インデックスを付けることができます。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] はテーブル値パラメーターの統計を保持しません。  
+  
+-   テーブル値パラメーターは [!INCLUDE[tsql](../../../../../includes/tsql-md.md)] コードの中では読み取り専用です。  テーブル値パラメーターの行内の列の値は更新できません。行を挿入することも削除することもできません。  テーブル値パラメーター内のストアド プロシージャやパラメーター化ステートメントに渡すデータを変更するには、一時テーブルまたはテーブル変数にデータを挿入する必要があります。  
+  
+-   ALTER TABLE ステートメントをテーブル値パラメーターの設計変更に使用することはできません。  
+  
+## SqlParameter の構成例  
+ <xref:System.Data.SqlClient> では、テーブル値パラメーターのデータを <xref:System.Data.DataTable>、<xref:System.Data.Common.DbDataReader>、または System.Collections.Generic.IEnumerable\<<xref:Microsoft.SqlServer.Server.SqlDataRecord>\> \(<xref:System.Collections.Generic.IEnumerable%601>?qualifyHint=False&autoUpgrade=True) オブジェクトから読み込むことができます。  <xref:System.Data.SqlClient.SqlParameter> の <xref:System.Data.SqlClient.SqlParameter.TypeName%2A> プロパティを使用して、テーブル値パラメーターの型名を指定する必要があります。  `TypeName` は、既にサーバー上に作成されている、互換性のある型の名前と一致していることが必要です。  次のコード フラグメントは、データを挿入するための <xref:System.Data.SqlClient.SqlParameter> の構成方法を示しています。  
+  
+```csharp  
+// Configure the command and parameter.  
+SqlCommand insertCommand = new SqlCommand(  
+    sqlInsert, connection);  
+SqlParameter tvpParam = insertCommand.Parameters.AddWithValue(  
+    "@tvpNewCategories", addedCategories);  
+tvpParam.SqlDbType = SqlDbType.Structured;  
+tvpParam.TypeName = "dbo.CategoryTableType";  
+```  
+  
+```vb  
+' Configure the command and parameter.  
+Dim insertCommand As New SqlCommand(sqlInsert, connection)  
+Dim tvpParam As SqlParameter = _  
+   insertCommand.Parameters.AddWithValue( _  
+  "@tvpNewCategories", addedCategories)  
+tvpParam.SqlDbType = SqlDbType.Structured  
+tvpParam.TypeName = "dbo.CategoryTableType"  
+  
+```  
+  
+ <xref:System.Data.Common.DbDataReader> から派生した任意のオブジェクトを使用して、一連の行データをテーブル値パラメーターに挿入することもできます。その方法を次のフラグメントに示します。  
+  
+```csharp  
+// Configure the SqlCommand and table-valued parameter.  
+SqlCommand insertCommand = new SqlCommand(  
+  "usp_InsertCategories", connection);  
+insertCommand.CommandType = CommandType.StoredProcedure;  
+SqlParameter tvpParam =   
+   insertCommand.Parameters.AddWithValue(  
+   "@tvpNewCategories", dataReader);  
+tvpParam.SqlDbType = SqlDbType.Structured;  
+```  
+  
+```vb  
+' Configure the SqlCommand and table-valued parameter.  
+Dim insertCommand As New SqlCommand("usp_InsertCategories", connection)  
+insertCommand.CommandType = CommandType.StoredProcedure  
+Dim tvpParam As SqlParameter = _  
+  insertCommand.Parameters.AddWithValue("@tvpNewCategories", _  
+  dataReader)  
+tvpParam.SqlDbType = SqlDbType.Structured  
+  
+```  
+  
+## ストアド プロシージャへのテーブル値パラメーターの受け渡し  
+ この例は、テーブル値パラメーターのデータをストアド プロシージャに渡す方法を示しています。  このコードは、<xref:System.Data.DataTable.GetChanges%2A> メソッドを使用して、追加された行を新しい <xref:System.Data.DataTable> に抽出します。  次に <xref:System.Data.SqlClient.SqlCommand> を定義し、<xref:System.Data.SqlClient.SqlCommand.CommandType%2A> プロパティを <xref:System.Data.CommandType> に設定します。  <xref:System.Data.SqlClient.SqlParameter> へのデータ入力には <xref:System.Data.SqlClient.SqlParameterCollection.AddWithValue%2A> メソッドが使用され、<xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> は `Structured` に設定されます。  次に <xref:System.Data.SqlClient.SqlCommand.ExecuteNonQuery%2A> メソッドを使用して <xref:System.Data.SqlClient.SqlCommand> が実行されます。  
+  
+```csharp  
+// Assumes connection is an open SqlConnection object.  
+using (connection)  
+{  
+// Create a DataTable with the modified rows.  
+DataTable addedCategories =  
+  CategoriesDataTable.GetChanges(DataRowState.Added);  
+  
+// Configure the SqlCommand and SqlParameter.  
+SqlCommand insertCommand = new SqlCommand(  
+    "usp_InsertCategories", connection);  
+insertCommand.CommandType = CommandType.StoredProcedure;  
+SqlParameter tvpParam = insertCommand.Parameters.AddWithValue(  
+    "@tvpNewCategories", addedCategories);  
+tvpParam.SqlDbType = SqlDbType.Structured;  
+  
+// Execute the command.  
+insertCommand.ExecuteNonQuery();  
+}  
+```  
+  
+```vb  
+' Assumes connection is an open SqlConnection object.  
+Using connection  
+   '  Create a DataTable with the modified rows.  
+   Dim addedCategories As DataTable = _  
+     CategoriesDataTable.GetChanges(DataRowState.Added)  
+  
+  ' Configure the SqlCommand and SqlParameter.  
+   Dim insertCommand As New SqlCommand( _  
+     "usp_InsertCategories", connection)  
+   insertCommand.CommandType = CommandType.StoredProcedure  
+   Dim tvpParam As SqlParameter = _  
+     insertCommand.Parameters.AddWithValue( _  
+     "@tvpNewCategories", addedCategories)  
+   tvpParam.SqlDbType = SqlDbType.Structured  
+  
+   '  Execute the command.  
+   insertCommand.ExecuteNonQuery()  
+End Using  
+```  
+  
+### パラメーター化 SQL ステートメントへのテーブル値パラメーターの受け渡し  
+ 次の例は、データ ソースとしてテーブル値パラメーターを持つ SELECT サブクエリ付きの INSERT ステートメントを使用して、dbo.Categories テーブルにデータを挿入する方法を示しています。  テーブル値パラメーターをパラメーター化 SQL ステートメントに渡すときは、<xref:System.Data.SqlClient.SqlParameter> の新しい <xref:System.Data.SqlClient.SqlParameter.TypeName%2A> プロパティを使用して、テーブル値パラメーターの型名を指定する必要があります。  この `TypeName` は、既にサーバー上に作成されている、互換性のある型の名前と一致している必要があります。  このコード例では、dbo.CategoryTableType で定義されている型の構造を参照するために `TypeName` プロパティが使用されています。  
+  
+> [!NOTE]
+>  テーブル値パラメーターで ID 列の値を指定する場合は、そのセッションの SET IDENTITY\_INSERT ステートメントを実行する必要があります。  
+  
+```csharp  
+// Assumes connection is an open SqlConnection.  
+using (connection)  
+{  
+// Create a DataTable with the modified rows.  
+DataTable addedCategories = CategoriesDataTable.GetChanges(  
+    DataRowState.Added);  
+  
+// Define the INSERT-SELECT statement.  
+string sqlInsert =   
+    "INSERT INTO dbo.Categories (CategoryID, CategoryName)"  
+    + " SELECT nc.CategoryID, nc.CategoryName"  
+    + " FROM @tvpNewCategories AS nc;"  
+  
+// Configure the command and parameter.  
+SqlCommand insertCommand = new SqlCommand(  
+    sqlInsert, connection);  
+SqlParameter tvpParam = insertCommand.Parameters.AddWithValue(  
+    "@tvpNewCategories", addedCategories);  
+tvpParam.SqlDbType = SqlDbType.Structured;  
+tvpParam.TypeName = "dbo.CategoryTableType";  
+  
+// Execute the command.  
+insertCommand.ExecuteNonQuery();  
+}  
+```  
+  
+```vb  
+' Assumes connection is an open SqlConnection.  
+Using connection  
+  ' Create a DataTable with the modified rows.  
+  Dim addedCategories As DataTable = _  
+    CategoriesDataTable.GetChanges(DataRowState.Added)  
+  
+  ' Define the INSERT-SELECT statement.  
+  Dim sqlInsert As String = _  
+  "INSERT INTO dbo.Categories (CategoryID, CategoryName)" _  
+  & " SELECT nc.CategoryID, nc.CategoryName" _  
+  & " FROM @tvpNewCategories AS nc;"  
+  
+  ' Configure the command and parameter.  
+  Dim insertCommand As New SqlCommand(sqlInsert, connection)  
+  Dim tvpParam As SqlParameter = _  
+     insertCommand.Parameters.AddWithValue( _  
+    "@tvpNewCategories", addedCategories)  
+  tvpParam.SqlDbType = SqlDbType.Structured  
+  tvpParam.TypeName = "dbo.CategoryTableType"  
+  
+  ' Execute the query  
+  insertCommand.ExecuteNonQuery()  
+End Using  
+```  
+  
+## DataReader による行のストリーミング  
+ テーブル値パラメーターにデータ行をストリーム出力するには、<xref:System.Data.Common.DbDataReader> から派生したオブジェクトを使用します。  次のコード フラグメントは、<xref:System.Data.OracleClient.OracleCommand> と <xref:System.Data.OracleClient.OracleDataReader> を使用して Oracle データベースからデータを取り出す方法を示しています。  このコードは次に、単一の入力パラメーターを持つストアド プロシージャを呼び出すように <xref:System.Data.SqlClient.SqlCommand> を構成します。  <xref:System.Data.SqlClient.SqlParameter> の <xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> プロパティが `Structured` に設定されます。  <xref:System.Data.SqlClient.SqlParameterCollection.AddWithValue%2A> は `OracleDataReader` の結果セットをテーブル値パラメーターとしてストアド プロシージャに渡します。  
+  
+```csharp  
+// Assumes connection is an open SqlConnection.  
+// Retrieve data from Oracle.  
+OracleCommand selectCommand = new OracleCommand(  
+   "Select CategoryID, CategoryName FROM Categories;",  
+   oracleConnection);  
+OracleDataReader oracleReader = selectCommand.ExecuteReader(  
+   CommandBehavior.CloseConnection);  
+  
+ // Configure the SqlCommand and table-valued parameter.  
+ SqlCommand insertCommand = new SqlCommand(  
+   "usp_InsertCategories", connection);  
+ insertCommand.CommandType = CommandType.StoredProcedure;  
+ SqlParameter tvpParam =   
+    insertCommand.Parameters.AddWithValue(  
+    "@tvpNewCategories", oracleReader);  
+ tvpParam.SqlDbType = SqlDbType.Structured;  
+  
+ // Execute the command.  
+ insertCommand.ExecuteNonQuery();  
+```  
+  
+```vb  
+' Assumes connection is an open SqlConnection.  
+' Retrieve data from Oracle.  
+Dim selectCommand As New OracleCommand( _  
+  "Select CategoryID, CategoryName FROM Categories;", _  
+  oracleConnection)  
+Dim oracleReader As OracleDataReader = _  
+  selectCommand.ExecuteReader(CommandBehavior.CloseConnection)  
+  
+' Configure SqlCommand and table-valued parameter.  
+Dim insertCommand As New SqlCommand("usp_InsertCategories", connection)  
+insertCommand.CommandType = CommandType.StoredProcedure  
+Dim tvpParam As SqlParameter = _  
+  insertCommand.Parameters.AddWithValue("@tvpNewCategories", _  
+  oracleReader)  
+tvpParam.SqlDbType = SqlDbType.Structured  
+  
+' Execute the command.  
+insertCommand.ExecuteNonQuery()  
+```  
+  
+## 参照  
+ [パラメーターおよびパラメーター データ型の構成](../../../../../docs/framework/data/adonet/configuring-parameters-and-parameter-data-types.md)   
+ [コマンドとパラメーター](../../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter パラメーター](../../../../../docs/framework/data/adonet/dataadapter-parameters.md)   
+ [ADO.NET における SQL Server データ操作](../../../../../docs/framework/data/adonet/sql/sql-server-data-operations.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/the-context-connection.md b/docs/framework/data/adonet/sql/the-context-connection.md
new file mode 100644
index 00000000000..b9b4e59e8ca
--- /dev/null
+++ b/docs/framework/data/adonet/sql/the-context-connection.md
@@ -0,0 +1,30 @@
+---
+title: "コンテキスト接続 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e443ca86-9243-4234-a822-ed10a53a9de0
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# コンテキスト接続
+内部データ アクセスの問題は、非常に一般的なシナリオです。  つまり、共通言語ランタイム \(CLR\) ストアド プロシージャまたは関数を実行しているサーバーにアクセスする場合の問題です。  1 つの解決方法は、<xref:System.Data.SqlClient.SqlConnection> を使用して接続文字列を作成し、ローカル サーバーをポイントするように接続文字列で指定して、接続を開くことです。  これを行うには、ログインするための資格情報を指定する必要があります。  接続がストアド プロシージャまたは関数とは別のデータベース セッションにある場合や、異なる `SET` オプションが指定されている場合があります。また、別のトランザクション内にある場合や、一時テーブルを参照していない場合もあります。  マネージ ストアド プロシージャまたは関数コードが SQL Server プロセス内で実行されている場合、別のユーザーがサーバーに接続して、そのマネージ ストアド プロシージャまたは関数コードを起動する SQL ステートメントを実行していることを意味します。  接続のコンテキスト内で、ストアド プロシージャまたは関数をトランザクションや `SET` オプションなどと共に実行する必要がある場合もあります。  これは、コンテキスト接続と呼ばれます。  
+  
+ コンテキスト接続を使用すると、コードが初めに起動されたコンテキスト内で Transact\-SQL ステートメントを実行することができます。  詳細については、ご使用中の SQL Server のバージョンに対応するバージョンの SQL Server オンライン ブックを参照してください。  
+  
+ **SQL Server オンライン ブック**  
+  
+1.  [コンテキスト接続](http://go.microsoft.com/fwlink/?LinkId=115395)  
+  
+## 参照  
+ [Creating SQL Server 2005 Objects In Managed Code](http://msdn.microsoft.com/ja-jp/5358a825-e19b-49aa-8214-674ce5fed1da)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/transaction-and-bulk-copy-operations.md b/docs/framework/data/adonet/sql/transaction-and-bulk-copy-operations.md
new file mode 100644
index 00000000000..41b14769985
--- /dev/null
+++ b/docs/framework/data/adonet/sql/transaction-and-bulk-copy-operations.md
@@ -0,0 +1,68 @@
+---
+title: "トランザクションとバルク コピー操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f6f0cbc9-f7bf-4d6e-875f-ad1ba0b4aa62
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# トランザクションとバルク コピー操作
+バルク コピー操作は、単独の操作として、または、手順が複数あるトランザクションの 1 手順として実行されます。  手順が複数あるトランザクションの 1 手順として実行する場合、同一トランザクション内でバルク コピー操作を複数回実行することができます。また、挿入、更新、削除などの他のデータベース操作を実行していても、トランザクション全体をコミットまたはロールバックできます。  
+  
+ 既定では、バルク コピー操作は単独の操作として実行されます。  このバルク コピー操作は非トランザクション方式で処理され、ロールバックできません。  エラーが発生した際に、バルク コピー処理の全部または一部をロールバックする必要がある場合は、<xref:System.Data.SqlClient.SqlBulkCopy> が管理するトランザクションを使用するか、既存のトランザクション内でバルク コピー操作を実行するか、または **System.Transactions** <xref:System.Transactions.Transaction> に参加させることもできます。  
+  
+## 非トランザクション処理のバルク コピー操作の実行  
+ 次のコンソール アプリケーションでは、非トランザクション処理のバルク コピー操作で処理中にエラーが検出されたときに、そのエラーの内容を表示します。  
+  
+ 例では、コピー元のテーブルとコピー先のテーブルにはそれぞれ、**ProductID** という名前の `Identity` 列があります。  コードでは、最初に、行をすべて削除してコピー先のテーブルを用意し、コピー元のテーブルに **ProductID** が存在する行を 1 行挿入しています。  既定では、`Identity` 列の新しい値は追加した各行のコピー先のテーブル内で生成されます。  この例では、代わりに、コピー元のテーブルからの `Identity` 値を使用するバルク ロード処理を強制的に行う接続が開かれている場合、オプションが設定されます。  
+  
+ このバルク コピー操作は、<xref:System.Data.SqlClient.SqlBulkCopy.BatchSize%2A> プロパティを 10 に設定して実行されます。  処理中に無効な行が検出されると、例外がスローされます。  この最初の例では、バルク コピー操作はトランザクション処理ではありません。  エラー発生ポイントまでにコピーされたバッチはすべてコミットされ、重複キーが含まれるバッチはロールバックされます。また、バルク コピー操作は、他のバッチを処理する前に中止されます。  
+  
+> [!NOTE]
+>  このサンプルは、「[バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)」で説明しているように作業テーブルを作成してからでないと動作しません。  このコードでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンス内に存在する場合、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+ [!code-csharp[DataWorks SqlBulkCopy.DefaultTransaction#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.DefaultTransaction/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlBulkCopy.DefaultTransaction#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.DefaultTransaction/VB/source.vb#1)]  
+  
+## トランザクションでの専用のバルク コピー操作の実行  
+ 既定では、バルク コピー操作は専用のトランザクションで実行されます。  専用のバルク コピー操作を実行する場合は、接続文字列を使用して <xref:System.Data.SqlClient.SqlBulkCopy> のインスタンスを新しく作成するか、またはアクティブなトランザクションは使用せずに既存の <xref:System.Data.SqlClient.SqlConnection> オブジェクトを使用します。  いずれの場合も、バルク コピー操作によってトランザクションを作成し、コミットするかまたはロールバックします。  
+  
+ <xref:System.Data.SqlClient.SqlBulkCopy> クラス コンストラクターの <xref:System.Data.SqlClient.SqlBulkCopyOptions> オプションを明示的に指定することで、バルク コピー操作を専用のトランザクションで実行でき、バルク コピー操作の各バッチを別々のトランザクション内で実行できます。  
+  
+> [!NOTE]
+>  異なるバッチは別々のトランザクション内で実行されます。このため、バルク コピー操作中にエラーが発生した場合、現在処理中のバッチの行はすべてロールバックされますが、エラーの発生前にバッチでコピーされた行はデータベースに残ります。  
+  
+ 次のコンソール アプリケーションは前の例とほぼ同じですが、バルク コピー操作で専用のトランザクションが管理される点が異なります。  エラー発生ポイントまでにコピーされたバッチはすべてコミットされ、重複キーが含まれるバッチはロールバックされます。また、バルク コピー操作は、他のバッチを処理する前に中止されます。  
+  
+> [!IMPORTANT]
+>  このサンプルは、「[バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)」で説明しているように作業テーブルを作成してからでないと動作しません。  このコードでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンス内に存在する場合、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+ [!code-csharp[DataWorks SqlBulkCopy.InternalTransaction#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.InternalTransaction/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlBulkCopy.InternalTransaction#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.InternalTransaction/VB/source.vb#1)]  
+  
+## 既存のトランザクションの使用  
+ 既存の <xref:System.Data.SqlClient.SqlBulkCopy> コンストラクターの <xref:System.Data.SqlClient.SqlTransaction> オブジェクトをパラメーターとして指定できます。  この場合、バルク コピー操作は既存のトランザクションで実行されます。このトランザクションの状態は変更されません \(つまり、コミットも中止もされません\)。  これにより、アプリケーションは他のデータベース操作を行うトランザクションでバルク コピー操作を行うことができます。  ただし、<xref:System.Data.SqlClient.SqlTransaction> オブジェクトを指定しない場合、null 参照を渡した場合、接続にアクティブなトランザクションがある場合は、例外がスローされます。  
+  
+ エラーが発生したためすべてのバルク コピー操作をロールバックする必要がある場合、または、ロールバック可能な大きな処理の一部としてバルク コピー処理を実行する場合、<xref:System.Data.SqlClient.SqlTransaction> オブジェクトを <xref:System.Data.SqlClient.SqlBulkCopy> コンストラクターに指定することができます。  
+  
+ 次のコンソール アプリケーションは最初の \(トランザクションのない\) 例とほぼ同じですが、バルク コピー操作がより大きな外部トランザクションに含まれている点が異なります。  主キーの違反エラーが発生した場合、トランザクションはすべてロールバックされ、コピー先のテーブルに行は追加されません。  
+  
+> [!IMPORTANT]
+>  このサンプルは、「[バルク コピー サンプルのセットアップ](../../../../../docs/framework/data/adonet/sql/bulk-copy-example-setup.md)」で説明しているように作業テーブルを作成してからでないと動作しません。  このコードでは、**SqlBulkCopy** だけを使用した構文について説明します。  コピー元およびコピー先のテーブルが同一の [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] インスタンス内に存在する場合、[!INCLUDE[tsql](../../../../../includes/tsql-md.md)] の `INSERT … SELECT` ステートメントを使用すれば簡単かつ高速にデータをコピーすることができます。  
+  
+ [!code-csharp[DataWorks SqlBulkCopy.SqlTransaction#1](../../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.SqlTransaction/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlBulkCopy.SqlTransaction#1](../../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlBulkCopy.SqlTransaction/VB/source.vb#1)]  
+  
+## 参照  
+ [SQL Server でのバルク コピー操作](../../../../../docs/framework/data/adonet/sql/bulk-copy-operations-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/windows-applications-using-callbacks.md b/docs/framework/data/adonet/sql/windows-applications-using-callbacks.md
new file mode 100644
index 00000000000..6274342dcbf
--- /dev/null
+++ b/docs/framework/data/adonet/sql/windows-applications-using-callbacks.md
@@ -0,0 +1,389 @@
+---
+title: "コールバックを使用した Windows アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae2ea457-0764-4b06-8977-713c77e85bd2
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# コールバックを使用した Windows アプリケーション
+非同期処理は多くの場合、データベース操作を開始し、データベース操作が完了するまで待つことなく、他のプロセスの実行を継続できるようにします。  ただし、ほとんどの場合、データベース操作の完了時に何らかの処理を行う必要があります。  たとえば、Windows アプリケーションでは、ユーザー インターフェイス スレッドの応答性を維持しながら、時間のかかる操作をバックグラウンド スレッドに委任することができます。  また一方、データベース操作の完了時に、この結果を使用してフォームを表示することができます。  このような場合、コールバックによって最適に実行されます。  
+  
+ コールバックを定義するには、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery%2A> メソッド、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteReader%2A> メソッド、または <xref:System.Data.SqlClient.SqlCommand.BeginExecuteXmlReader%2A> メソッドで <xref:System.AsyncCallback> デリゲートを指定します。  このデリゲートは、操作の完了時に呼び出されます。  デリゲートに <xref:System.Data.SqlClient.SqlCommand> 自身への参照を渡すことができるため、<xref:System.Data.SqlClient.SqlCommand> オブジェクトにアクセスしたり、グローバル変数を使用することなく適切な `End` メソッドを呼び出したりすることが容易になります。  
+  
+## 例  
+ 次の Windows アプリケーションは、<xref:System.Data.SqlClient.SqlCommand.BeginExecuteNonQuery%2A> メソッドを使って、数秒の遅れを伴う \(時間のかかるコマンドをエミュレートする\) Transact\-SQL ステートメントを実行する例を示しています。  
+  
+ この例では、別のスレッドからのフォームと対話するメソッドを呼び出す方法など、重要なテクニックを多数紹介しています。  また、この例は、ユーザーがコマンドを複数回同時に実行しないようにする方法と、コールバック プロシージャが呼び出される前にフォームが閉じないようにする方法を示しています。  
+  
+ この例をセットアップするには、新しい Windows アプリケーションを作成します。  フォーム上に、<xref:System.Windows.Forms.Button> コントロールと 2 つの <xref:System.Windows.Forms.Label> コントロールを配置します \(各コントロールは既定の名前のまま使用します\)。  お使いの環境に応じて接続文字列を変更し、次のコードをフォームのクラスに追加します。  
+  
+ \[Visual Basic\]  
+  
+```  
+' Add these to the top of the class:  
+Imports System  
+Imports System.Data  
+Imports System.Data.SqlClient  
+  
+' Add this code to the form's class:  
+  
+    ' You'll need this delegate in order to display text from a   
+    ' thread other than the form's thread. See the HandleCallback  
+    ' procedure for more information.  
+    ' This same delegate matches both the DisplayStatus   
+    ' and DisplayResults methods.  
+    Private Delegate Sub DisplayInfoDelegate(ByVal Text As String)  
+  
+    ' This flag ensures that the user doesn't attempt  
+    ' to restart the command or close the form while the   
+    ' asynchronous command is executing.  
+    Private isExecuting As Boolean  
+  
+    ' This example maintains the connection object   
+    ' externally, so that it's available for closing.  
+    Private connection As SqlConnection  
+  
+    Private Function GetConnectionString() As String  
+        ' To avoid storing the connection string in your code,              
+        ' you can retrieve it from a configuration file.   
+  
+        ' If you have not included "Asynchronous Processing=true"  
+        ' in the connection string, the command will not be able  
+        ' to execute asynchronously.  
+        Return "Data Source=(local);Integrated Security=SSPI;" & _  
+          "Initial Catalog=AdventureWorks;" & _  
+          "Asynchronous Processing=true"  
+    End Function  
+  
+    Private Sub DisplayStatus(ByVal Text As String)  
+        Me.Label1.Text = Text  
+    End Sub  
+  
+    Private Sub DisplayResults(ByVal Text As String)  
+        Me.Label1.Text = Text  
+        DisplayStatus("Ready")  
+    End Sub  
+  
+    Private Sub Form1_FormClosing(ByVal sender As Object, _  
+        ByVal e As System.Windows.Forms.FormClosingEventArgs) _  
+        Handles Me.FormClosing  
+        If isExecuting Then  
+            MessageBox.Show(Me, "Can't close the form until " & _  
+             "the pending asynchronous command has completed. " & _  
+             "Please wait...")  
+            e.Cancel = True  
+        End If  
+    End Sub  
+  
+    Private Sub Button1_Click( _  
+        ByVal sender As System.Object, _  
+        ByVal e As System.EventArgs) Handles Button1.Click  
+        If isExecuting Then  
+            MessageBox.Show(Me, _  
+                "Already executing. " & _  
+                "Please wait until the current query " & _  
+                "has completed.")  
+        Else  
+            Dim command As SqlCommand  
+            Try  
+                DisplayResults("")  
+                DisplayStatus("Connecting...")  
+                connection = New SqlConnection(GetConnectionString())  
+                ' To emulate a long-running query, wait for   
+                ' a few seconds before working with the data.  
+                ' This command doesn't do much, but that's the point--  
+                ' it doesn't change your data, in the long run.  
+                Dim commandText As String = _  
+                    "WAITFOR DELAY '0:0:05';" & _  
+                    "UPDATE Production.Product " & _  
+                    "SET ReorderPoint = ReorderPoint + 1 " & _  
+                    "WHERE ReorderPoint Is Not Null;" & _  
+                    "UPDATE Production.Product " & _  
+                    "SET ReorderPoint = ReorderPoint - 1 " & _  
+                    "WHERE ReorderPoint Is Not Null"  
+  
+                command = New SqlCommand(commandText, connection)  
+                connection.Open()  
+  
+                DisplayStatus("Executing...")  
+                isExecuting = True  
+                ' Although it's not required that you pass the   
+                ' SqlCommand object as the second parameter in the   
+                ' BeginExecuteNonQuery call, doing so makes it easier  
+                ' to call EndExecuteNonQuery in the callback procedure.  
+                Dim callback As New _  
+                      AsyncCallback(AddressOf HandleCallback)  
+  
+                ' Once the BeginExecuteNonQuery method is called,  
+                ' the code continues--and the user can interact with  
+                ' the form--while the server executes the query.  
+  
+                command.BeginExecuteNonQuery(callback, command)  
+  
+            Catch ex As Exception  
+                isExecuting = False  
+                DisplayStatus( _  
+                    String.Format("Ready (last error: {0})", _  
+                    ex.Message))  
+                If connection IsNot Nothing Then  
+                    connection.Close()  
+                End If  
+            End Try  
+        End If  
+    End Sub  
+  
+    Private Sub HandleCallback(ByVal result As IAsyncResult)  
+        Try  
+            ' Retrieve the original command object, passed  
+            ' to this procedure in the AsyncState property  
+            ' of the IAsyncResult parameter.  
+            Dim command As SqlCommand = _  
+                CType(result.AsyncState, SqlCommand)  
+            Dim rowCount As Integer = _  
+                command.EndExecuteNonQuery(result)  
+            Dim rowText As String = " rows affected."  
+            If rowCount = 1 Then  
+                rowText = " row affected."  
+            End If  
+            rowText = rowCount & rowText  
+  
+            ' You may not interact with the form and its contents  
+            ' from a different thread, and this callback procedure  
+            ' is all but guaranteed to be running from a different   
+            ' thread than the form. Therefore you cannot simply call   
+            ' code that displays the results, like this:  
+            ' DisplayResults(rowText)  
+  
+            ' Instead, you must call the procedure from the form's  
+            ' thread. One simple way to accomplish this is to call   
+            ' the Invoke method of the form, which calls the delegate   
+            ' you supply from the form's thread.   
+            Dim del As New _  
+                DisplayInfoDelegate(AddressOf DisplayResults)  
+            Me.Invoke(del, rowText)  
+  
+        Catch ex As Exception  
+            ' Because you're now running code in a separate thread,   
+            ' if you don't handle the exception here, none of your   
+            ' other code will catch the exception. Because none of   
+            ' your code is on the call stack in this thread, there's   
+            ' nothing higher up the stack to catch the exception if   
+            ' you don't handle it here. You can either log the   
+            ' exception or invoke a delegate (as in the non-error   
+            ' case in this example) to display the error on the form.   
+            ' In no case can you simply display the error without   
+            ' executing a delegate as in the Try block here.  
+  
+            ' You can create the delegate instance as you   
+            ' invoke it, like this:  
+            Me.Invoke(New _  
+                DisplayInfoDelegate(AddressOf DisplayStatus), _  
+                String.Format("Ready(last error: {0}", ex.Message))  
+        Finally  
+            isExecuting = False  
+            If connection IsNot Nothing Then  
+                connection.Close()  
+            End If  
+        End Try  
+    End Sub  
+```  
+  
+```csharp  
+// Add these to the top of the class, if they're not already there:  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+  
+// Hook up the form's Load event handler (you can double-click on   
+// the form's design surface in Visual Studio), and then add   
+// this code to the form's class:  
+  
+// You'll need this delegate in order to display text from a thread  
+// other than the form's thread. See the HandleCallback  
+// procedure for more information.  
+// This same delegate matches both the DisplayStatus   
+// and DisplayResults methods.  
+private delegate void DisplayInfoDelegate(string Text);  
+  
+// This flag ensures that the user doesn't attempt  
+// to restart the command or close the form while the   
+// asynchronous command is executing.  
+private bool isExecuting;  
+  
+// This example maintains the connection object   
+// externally, so that it's available for closing.  
+private SqlConnection connection;  
+  
+private static string GetConnectionString()  
+{  
+    // To avoid storing the connection string in your code,              
+    // you can retrieve it from a configuration file.   
+  
+    // If you have not included "Asynchronous Processing=true" in the  
+    // connection string, the command will not be able  
+    // to execute asynchronously.  
+    return "Data Source=(local);Integrated Security=SSPI;" +  
+    "Initial Catalog=AdventureWorks; Asynchronous Processing=true";  
+}  
+  
+private void DisplayStatus(string Text)  
+{  
+    this.label1.Text = Text;  
+}  
+  
+private void DisplayResults(string Text)  
+{  
+    this.label1.Text = Text;  
+    DisplayStatus("Ready");  
+}  
+  
+private void Form1_FormClosing(object sender, System.Windows.Forms.FormClosingEventArgs e)  
+{  
+    if (isExecuting)  
+    {  
+        MessageBox.Show(this, "Can't close the form until " +  
+        "the pending asynchronous command has completed. Please " +  
+        wait...");  
+        e.Cancel = true;  
+    }  
+}  
+  
+private void button1_Click(object sender, System.EventArgs e)  
+{  
+    if (isExecuting)  
+    {  
+        MessageBox.Show(this, "Already executing. Please wait until " +  
+        "the current query has completed.");  
+    }  
+    else  
+    {  
+        SqlCommand command = null;  
+        try  
+        {  
+            DisplayResults("");  
+            DisplayStatus("Connecting...");  
+            connection = new SqlConnection(GetConnectionString());  
+            // To emulate a long-running query, wait for   
+            // a few seconds before working with the data.  
+            // This command doesn't do much, but that's the point--  
+            // it doesn't change your data, in the long run.  
+            string commandText =  
+                "WAITFOR DELAY '0:0:05';" +  
+                "UPDATE Production.Product " +  
+                "SET ReorderPoint = ReorderPoint + 1 " +  
+                "WHERE ReorderPoint Is Not Null;" +  
+                "UPDATE Production.Product " +  
+                "SET ReorderPoint = ReorderPoint - 1 " +  
+                "WHERE ReorderPoint Is Not Null";  
+  
+            command = new SqlCommand(commandText, connection);  
+            connection.Open();  
+  
+            DisplayStatus("Executing...");  
+            isExecuting = true;  
+            // Although it's not required that you pass the   
+            // SqlCommand object as the second parameter in the   
+            // BeginExecuteNonQuery call, doing so makes it easier  
+            // to call EndExecuteNonQuery in the callback procedure.  
+            AsyncCallback callback = new AsyncCallback(HandleCallback);  
+  
+            // Once the BeginExecuteNonQuery method is called,  
+            // the code continues--and the user can interact with  
+            // the form--while the server executes the query.  
+            command.BeginExecuteNonQuery(callback, command);  
+  
+        }  
+        catch (Exception ex)  
+        {  
+            isExecuting = false;  
+            DisplayStatus(   
+             string.Format("Ready (last error: {0})", ex.Message));  
+            if (connection != null)  
+            {  
+                connection.Close();  
+            }  
+        }  
+    }  
+}  
+  
+private void HandleCallback(IAsyncResult result)  
+{  
+    try  
+    {  
+        // Retrieve the original command object, passed  
+        // to this procedure in the AsyncState property  
+        // of the IAsyncResult parameter.  
+        SqlCommand command = (SqlCommand)result.AsyncState;  
+        int rowCount = command.EndExecuteNonQuery(result);  
+        string rowText = " rows affected.";  
+        if (rowCount == 1)  
+        {  
+            rowText = " row affected.";  
+        }  
+        rowText = rowCount + rowText;  
+  
+        // You may not interact with the form and its contents  
+        // from a different thread, and this callback procedure  
+        // is all but guaranteed to be running from a different thread  
+        // than the form. Therefore you cannot simply call code that   
+        // displays the results, like this:  
+        // DisplayResults(rowText)  
+  
+        // Instead, you must call the procedure from the form's thread.  
+        // One simple way to accomplish this is to call the Invoke  
+        // method of the form, which calls the delegate you supply  
+        // from the form's thread.   
+        DisplayInfoDelegate del =   
+         new DisplayInfoDelegate(DisplayResults);  
+        this.Invoke(del, rowText);  
+    }  
+    catch (Exception ex)  
+    {  
+        // Because you're now running code in a separate thread,   
+        // if you don't handle the exception here, none of your other  
+        // code will catch the exception. Because none of your  
+        // code is on the call stack in this thread, there's nothing  
+        // higher up the stack to catch the exception if you don't   
+        // handle it here. You can either log the exception or   
+        // invoke a delegate (as in the non-error case in this   
+        // example) to display the error on the form. In no case  
+        // can you simply display the error without executing a   
+        // delegate as in the try block here.   
+  
+        // You can create the delegate instance as you   
+        // invoke it, like this:  
+        this.Invoke(new DisplayInfoDelegate(DisplayStatus),  
+        String.Format("Ready(last error: {0}", ex.Message));  
+    }  
+    finally  
+    {  
+        isExecuting = false;  
+        if (connection != null)  
+        {  
+            connection.Close();  
+        }  
+    }  
+}  
+  
+private void Form1_Load(object sender, System.EventArgs e)  
+{  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+    this.FormClosing += new System.Windows.Forms.  
+        FormClosingEventHandler(this.Form1_FormClosing);  
+}  
+```  
+  
+## 参照  
+ [非同期操作](../../../../../docs/framework/data/adonet/sql/asynchronous-operations.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md b/docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md
new file mode 100644
index 00000000000..2e019a2c2d5
--- /dev/null
+++ b/docs/framework/data/adonet/sql/writing-secure-dynamic-sql-in-sql-server.md
@@ -0,0 +1,84 @@
+---
+title: "SQL Server での安全な動的 SQL の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: df5512b0-c249-40d2-82f9-f9a2ce6665bc
+caps.latest.revision: 9
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 9
+---
+# SQL Server での安全な動的 SQL の作成
+SQL インジェクションとは、悪意のあるユーザーによって、有効な入力データの代わりに Transact\-SQL ステートメントが入力されることをいいます。  この入力データが検証されずにサーバーに直接渡され、挿入されたコードがアプリケーションでそのまま実行された場合、その攻撃によってデータが破損または破壊される可能性があります。  
+  
+ SQL Server では、構文的に有効であれば受信したクエリがすべて実行されるため、SQL ステートメントを構成するすべてのプロシージャに対して、インジェクションに対する脆弱性を検証する必要があります。  高いスキルを持った攻撃者は、その気になればパラメーター化されたデータでさえも操作できます。  動的 SQL を使用する場合は、必ずコマンドをパラメーター化するようにし、パラメーター値を直接クエリ文字列に追加することは避けてください。  
+  
+## SQL インジェクション攻撃の分析  
+ インジェクションのプロセスは、テキスト文字列を途中で終了し、新しいコマンドを追加することによって行われます。  挿入されたコマンドが実行される前に別の文字列が追加される可能性があるため、攻撃者は挿入する文字列をコメント記号 "\-\-" で終了させます。  後続のテキストは実行時には無視されます。  セミコロン \(;\) 区切り記号を使用することで、複数のコマンドを挿入できます。  
+  
+ 挿入された SQL コードが構文的に正しい限り、改ざんをプログラムによって検出するのは不可能です。  そのため、すべてのユーザー入力を検証し、使用しているサーバーで作成された SQL コマンドを実行するコードを注意深く確認する必要があります。  検証されていないユーザー入力は決して連結しないでください。  文字列の連結は、スクリプト インジェクションの最初の段階です。  
+  
+ 次に、有用なガイドラインを示します。  
+  
+-   Transact\-SQL ステートメントはユーザー入力から直接作成しないでください。ストアド プロシージャを使用して、ユーザー入力を検証してください。  
+  
+-   ユーザー入力の型、長さ、形式、範囲をテストし、検証してください。  システム名をエスケープするには Transact\-SQL の QUOTENAME\(\) 関数を使用し、文字列内の任意の文字をエスケープするには REPLACE\(\) 関数を使用します。  
+  
+-   アプリケーションの各層に、複数層の検証を実装します。  
+  
+-   入力のサイズとデータ型をテストし、適切な制限を適用します。  これは、意図的なバッファー オーバーランを防ぐのに役立ちます。  
+  
+-   文字列変数の内容をテストし、期待値のみを許可します。  バイナリ データ、エスケープ シーケンス、およびコメント文字を含む入力は拒否します。  
+  
+-   XML ドキュメントを扱う場合、入力時にすべてのデータをスキーマに照らして検証します。  
+  
+-   多層環境では、信頼済みゾーンに入ることを許可する前にすべてのデータを検証する必要があります。  
+  
+-   フィールド内の文字列からファイル名を作成できる場合、AUX、CLOCK$、COM1 ～ COM8、CON、CONFIG$、LPT1 ～ LPT8、NUL、PRN の各文字列をフィールドに入力できないようにします。  
+  
+-   <xref:System.Data.SqlClient.SqlParameter> オブジェクトにストアド プロシージャとコマンドを組み合わせ、型チェックと長さ検証を実行します。  
+  
+-   クライアント コードで <xref:System.Text.RegularExpressions.Regex> 式を使用して、無効な文字を排除します。  
+  
+## 動的 SQL を利用した手法  
+ プロシージャ コードで動的に生成された SQL ステートメントを実行することで組み合わせ所有権を破棄すると、SQL Server は動的 SQL によりアクセスされるオブジェクトに対する呼び出し元の権限をチェックします。  
+  
+ SQL Server には、動的 SQL を実行するストアド プロシージャやユーザー定義関数を使用したデータ アクセスをユーザーに許可するための方法があります。  
+  
+-   Transact\-SQL EXECUTE AS 句による権限の借用を利用します \(「[SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)」を参照\)。  
+  
+-   証明書を使ってストアド プロシージャに署名します \(「[SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)」を参照\)。  
+  
+### EXECUTE AS  
+ EXECUTE AS 句を使用すると、呼び出し元の権限が EXECUTE AS 句で指定されたユーザーの権限に置き換えられます。  入れ子になったストアド プロシージャやトリガーは、プロキシ ユーザーのセキュリティ コンテキストで実行されることに注意してください。  これにより、行レベルのセキュリティに依存するアプリケーションや監査を必要とするアプリケーションが中断されることがあります。  ユーザーの識別情報を返す関数では、最初の呼び出し元ではなく EXECUTE AS 句で指定されたユーザーが返されます。  プロシージャの実行後、または REVERT ステートメントが発行されたときにのみ、実行コンテキストが最初の呼び出し元に戻ります。  
+  
+### 証明書による署名  
+ 証明書により署名されているストアド プロシージャが実行されると、証明書ユーザーに許可される権限が呼び出し元の権限にマージされます。  実行コンテキストは変わりません。証明書ユーザーは呼び出し元の権限を借用しません。  ストアド プロシージャの署名を実装するには、いくつかの手順を実行する必要があります。  プロシージャが変更されるたびに、再度署名する必要があります。  
+  
+### 複数のデータベースへのアクセス  
+ 動的に生成された SQL ステートメントを実行する場合、複数データベースの組み合わせ所有権は機能しません。  [!INCLUDE[ssNoVersion](../../../../../includes/ssnoversion-md.md)] では、別のデータベースのデータにアクセスするストアド プロシージャを作成し、両方のデータベースに存在する証明書でそのプロシージャに署名することによって、これを回避できます。  これにより、ユーザーは、データベースへのアクセス許可が付与されていなくても、そのプロシージャによって使用されるデータベース リソースにアクセスできるようになります。  
+  
+## 外部リソース  
+ 詳細については、次のリソースを参照してください。  
+  
+|リソース|説明|  
+|----------|--------|  
+|SQL Server Books Online の「[ストアド プロシージャ](http://go.microsoft.com/fwlink/?LinkId=98233)」および「[SQL インジェクション](http://go.microsoft.com/fwlink/?LinkId=98234)」|ストアド プロシージャの作成方法と SQL インジェクションのしくみについて説明します。|  
+|MSDN マガジンの「[SQL インジェクション](http://msdn.microsoft.com/msdnmag/issues/06/11/SQLSecurity/)」|文字と文字列の区切り方法、SQL インジェクション、切り捨て攻撃による変更について説明します。|  
+  
+## 参照  
+ [ADO.NET アプリケーションのセキュリティ保護](../../../../../docs/framework/data/adonet/securing-ado-net-applications.md)   
+ [SQL Server セキュリティの概要](../../../../../docs/framework/data/adonet/sql/overview-of-sql-server-security.md)   
+ [SQL Server におけるアプリケーション セキュリティのシナリオ](../../../../../docs/framework/data/adonet/sql/application-security-scenarios-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャを使用したアクセス許可の管理](../../../../../docs/framework/data/adonet/sql/managing-permissions-with-stored-procedures-in-sql-server.md)   
+ [SQL Server でのストアド プロシージャの署名](../../../../../docs/framework/data/adonet/sql/signing-stored-procedures-in-sql-server.md)   
+ [SQL Server での借用を使用した権限のカスタマイズ](../../../../../docs/framework/data/adonet/sql/customizing-permissions-with-impersonation-in-sql-server.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sql/xml-data-in-sql-server.md b/docs/framework/data/adonet/sql/xml-data-in-sql-server.md
new file mode 100644
index 00000000000..7058a554469
--- /dev/null
+++ b/docs/framework/data/adonet/sql/xml-data-in-sql-server.md
@@ -0,0 +1,31 @@
+---
+title: "SQL Server における XML データ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9849d319-f518-4e3d-a7cd-f8fdcaaa1d4d
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# SQL Server における XML データ
+SQL Server は、.NET Framework 内部の SQLXML の機能を公開します。  開発者は、SQL Server のインスタンスから XML データにアクセスし、データを .NET Framework 環境に持ち込んで処理し、更新を SQL Server に送り返すアプリケーションを作成できます。  SQL Server では、XML データをデータ ストレージなどの目的に、あるいはデータを取得するときのパラメーター値として使用できます。  .NET Framework の **SqlXml** クラスは、SQL Server 内の XML 列に格納されたデータのクライアント側の操作をサポートします。  詳細については、SQL Server オンライン ブックの「SQLXML マネージ クラス」を参照してください。  
+  
+## このセクションの内容  
+ [SQL XML 列値](../../../../../docs/framework/data/adonet/sql/sql-xml-column-values.md)  
+ SQL Server から XML データを取得し、使用する方法について説明します。  
+  
+ [パラメーターとしての XML 値の指定](../../../../../docs/framework/data/adonet/sql/specifying-xml-values-as-parameters.md)  
+ コマンドに XML データをパラメーターとして渡す方法について説明します。  
+  
+## 参照  
+ [SQL Server と ADO.NET](../../../../../docs/framework/data/adonet/sql/index.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/sqlclient-streaming-support.md b/docs/framework/data/adonet/sqlclient-streaming-support.md
new file mode 100644
index 00000000000..d2f75a50e9a
--- /dev/null
+++ b/docs/framework/data/adonet/sqlclient-streaming-support.md
@@ -0,0 +1,530 @@
+---
+title: "SqlClient ストリーミング サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c449365b-470b-4edb-9d61-8353149f5531
+caps.latest.revision: 14
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 14
+---
+# SqlClient ストリーミング サポート
+[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] とアプリケーション間のストリーミング サポート \([!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] の新機能\) では、サーバー上の非構造化データ \(ドキュメント、画像、およびメディア ファイル\) がサポートされます。  [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] データベースはバイナリ ラージ オブジェクト \(BLOB\) を格納できますが、BLOB の取得には大量のメモリが使用される可能性があります。  
+  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] との間のストリーミング サポートにより、データをストリーミングするアプリケーションの作成が簡略化され、データをメモリに完全に読み込む必要がなくなるため、メモリのオーバーフロー例外は減少します。  
+  
+ また、ストリーミング サポートにより、特にビジネス オブジェクトが大きな BLOB を送信、取得、操作するために SQL Azure に接続するシナリオでは、中間層アプリケーションが適切に拡張できるようになります。  
+  
+> [!WARNING]
+>  非同期呼び出しは、アプリケーションで `Context Connection` 接続文字列キーワードも使用されている場合はサポートされません。  
+>   
+>  ストリーミング サポートに追加されたメンバーは、クエリからデータを取得し、クエリおよびストアド プロシージャにパラメーターを渡すために使用されます。  ストリーミング機能は、基本的な OLTP およびデータ移行のシナリオに対処し、社内および社外のデータ移行環境に適用できます。  
+  
+## [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からのストリーミング サポート  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からのストリーミング サポートでは、<xref:System.Data.Common.DbDataReader>、<xref:System.Data.SqlClient.SqlDataReader>、および <xref:System.IO.Stream> の各オブジェクトを取得して対応するために、<xref:System.Xml.XmlReader> クラスと <xref:System.IO.TextReader> クラスに新機能が導入されました。  これらのクラスはクエリからデータを取得するために使用されます。  その結果、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からのストリーミング サポートは、OLTP シナリオに対処し、社内および社外環境に適用されます。  
+  
+ <xref:System.Data.SqlClient.SqlDataReader> からのストリーミング サポートを有効にするために、次のメンバーが [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] に追加されました。  
+  
+1.  <xref:System.Data.SqlClient.SqlDataReader.IsDBNullAsync%2A>  
+  
+2.  <xref:System.Data.SqlClient.SqlDataReader.GetFieldValue%2A?displayProperty=fullName>  
+  
+3.  <xref:System.Data.SqlClient.SqlDataReader.GetFieldValueAsync%2A>  
+  
+4.  <xref:System.Data.SqlClient.SqlDataReader.GetStream%2A>  
+  
+5.  <xref:System.Data.SqlClient.SqlDataReader.GetTextReader%2A>  
+  
+6.  <xref:System.Data.SqlClient.SqlDataReader.GetXmlReader%2A>  
+  
+ <xref:System.Data.Common.DbDataReader> からのストリーミング サポートを有効にするために、次のメンバーが [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] に追加されました。  
+  
+1.  <xref:System.Data.Common.DbDataReader.GetFieldValue%2A>  
+  
+2.  <xref:System.Data.Common.DbDataReader.GetStream%2A>  
+  
+3.  <xref:System.Data.Common.DbDataReader.GetTextReader%2A>  
+  
+## [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] へのストリーミング サポート  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] へのストリーミング サポートでは、<xref:System.Data.SqlClient.SqlParameter>、<xref:System.Xml.XmlReader>、および <xref:System.IO.Stream> の各オブジェクトを受け取って対応するために、<xref:System.IO.TextReader> クラスに新機能が導入されました。  <xref:System.Data.SqlClient.SqlParameter> はクエリおよびストアド プロシージャにパラメーターを渡すために使用されます。  
+  
+ <xref:System.Data.SqlClient.SqlCommand> オブジェクトの破棄または <xref:System.Data.SqlClient.SqlCommand.Cancel%2A> の呼び出しでは、ストリーミング操作を取り消す必要があります。  アプリケーションが <xref:System.Threading.CancellationToken> を送信すると、取り消しは保証されません。  
+  
+ 次の <xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> 型は、<xref:System.Data.SqlClient.SqlParameter.Value%2A> の <xref:System.IO.Stream> を受け取ります。  
+  
+-   **Binary**  
+  
+-   **VarBinary**  
+  
+ 次の <xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> 型は、<xref:System.Data.SqlClient.SqlParameter.Value%2A> の <xref:System.IO.TextReader> を受け取ります。  
+  
+-   **Char**  
+  
+-   **NChar**  
+  
+-   **NVarChar**  
+  
+-   **Xml**  
+  
+ **Xml** <xref:System.Data.SqlClient.SqlParameter.SqlDbType%2A> 型は、<xref:System.Data.SqlClient.SqlParameter.Value%2A> の <xref:System.Xml.XmlReader> を受け取ります。  
+  
+ <xref:System.Data.SqlClient.SqlParameter.SqlValue%2A> は、<xref:System.Xml.XmlReader>、<xref:System.IO.TextReader>、および <xref:System.IO.Stream> 型の値を受け取ることができます。  
+  
+ <xref:System.Xml.XmlReader>、<xref:System.IO.TextReader>、および <xref:System.IO.Stream> の各オブジェクトは、<xref:System.Data.SqlClient.SqlParameter.Size%2A> によって定義された値まで転送されます。  
+  
+## サンプル \-\- [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からのストリーミング  
+ 次の [!INCLUDE[tsql](../../../../includes/tsql-md.md)] を使用して、サンプル データベースを作成します。  
+  
+```  
+CREATE DATABASE [Demo]  
+GO  
+USE [Demo]  
+GO  
+CREATE TABLE [Streams] (  
+[id] INT PRIMARY KEY IDENTITY(1, 1),  
+[textdata] NVARCHAR(MAX),  
+[bindata] VARBINARY(MAX),  
+[xmldata] XML)  
+GO  
+INSERT INTO [Streams] (textdata, bindata, xmldata) VALUES (N'This is a test', 0x48656C6C6F, N'<test>value</test>')  
+INSERT INTO [Streams] (textdata, bindata, xmldata) VALUES (N'Hello, World!', 0x54657374696E67, N'<test>value2</test>')  
+INSERT INTO [Streams] (textdata, bindata, xmldata) VALUES (N'Another row', 0x666F6F626172, N'<fff>bbb</fff><fff>bbc</fff>')  
+GO  
+```  
+  
+ このサンプルでは、次の処理の実行方法を示します。  
+  
+-   大きなファイルを非同期に取得できるようにして、ユーザー インターフェイス スレッドのブロックを回避する。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] で [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] から大きなテキスト ファイルを転送する。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] で [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] から大きな XML ファイルを転送する。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からデータを取得する。  
+  
+-   メモリ不足にならないように、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] データベースから別のデータベースに大きなファイル \(BLOB\) を転送する。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.IO;  
+using System.Threading.Tasks;  
+using System.Xml;  
+  
+namespace StreamingFromServer {  
+   class Program {  
+      // Replace the connection string if needed, for instance to connect to SQL Express: @"Server=(local)\SQLEXPRESS;Database=Demo;Integrated Security=true"  
+      private const string connectionString = @"Server=(localdb)\V11.0;Database=Demo";  
+  
+      static void Main(string[] args) {  
+         CopyBinaryValueToFile().Wait();  
+         PrintTextValues().Wait();  
+         PrintXmlValues().Wait();  
+         PrintXmlValuesViaNVarChar().Wait();  
+  
+         Console.WriteLine("Done");  
+      }  
+  
+      // Application retrieving a large BLOB from SQL Server in .NET 4.5 using the new asynchronous capability  
+      private static async Task CopyBinaryValueToFile() {  
+         string filePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), "binarydata.bin");  
+  
+         using (SqlConnection connection = new SqlConnection(connectionString)) {  
+            await connection.OpenAsync();  
+            using (SqlCommand command = new SqlCommand("SELECT [bindata] FROM [Streams] WHERE [id]=@id", connection)) {  
+               command.Parameters.AddWithValue("id", 1);  
+  
+               // The reader needs to be executed with the SequentialAccess behavior to enable network streaming  
+               // Otherwise ReadAsync will buffer the entire BLOB into memory which can cause scalability issues or even OutOfMemoryExceptions  
+               using (SqlDataReader reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess)) {  
+                  if (await reader.ReadAsync()) {  
+                     if (!(await reader.IsDBNullAsync(0))) {  
+                        using (FileStream file = new FileStream(filePath, FileMode.Create, FileAccess.Write)) {  
+                           using (Stream data = reader.GetStream(0)) {  
+  
+                              // Asynchronously copy the stream from the server to the file we just created  
+                              await data.CopyToAsync(file);  
+                           }  
+                        }  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+  
+      // Application transferring a large Text File from SQL Server in .NET 4.5  
+      private static async Task PrintTextValues() {  
+         using (SqlConnection connection = new SqlConnection(connectionString)) {  
+            await connection.OpenAsync();  
+            using (SqlCommand command = new SqlCommand("SELECT [id], [textdata] FROM [Streams]", connection)) {  
+  
+               // The reader needs to be executed with the SequentialAccess behavior to enable network streaming  
+               // Otherwise ReadAsync will buffer the entire text document into memory which can cause scalability issues or even OutOfMemoryExceptions  
+               using (SqlDataReader reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess)) {  
+                  while (await reader.ReadAsync()) {  
+                     Console.Write("{0}: ", reader.GetInt32(0));  
+  
+                     if (await reader.IsDBNullAsync(1)) {  
+                        Console.Write("(NULL)");  
+                     }  
+                     else {  
+                        char[] buffer = new char[4096];  
+                        int charsRead = 0;  
+                        using (TextReader data = reader.GetTextReader(1)) {  
+                           do {  
+                              // Grab each chunk of text and write it to the console  
+                              // If you are writing to a TextWriter you should use WriteAsync or WriteLineAsync  
+                              charsRead = await data.ReadAsync(buffer, 0, buffer.Length);  
+                              Console.Write(buffer, 0, charsRead);  
+                           } while (charsRead > 0);  
+                        }  
+                     }  
+  
+                     Console.WriteLine();  
+                  }  
+               }  
+            }  
+         }  
+      }  
+  
+      // Application transferring a large Xml Document from SQL Server in .NET 4.5  
+      private static async Task PrintXmlValues() {  
+         using (SqlConnection connection = new SqlConnection(connectionString)) {  
+            await connection.OpenAsync();  
+            using (SqlCommand command = new SqlCommand("SELECT [id], [xmldata] FROM [Streams]", connection)) {  
+  
+               // The reader needs to be executed with the SequentialAccess behavior to enable network streaming  
+               // Otherwise ReadAsync will buffer the entire Xml Document into memory which can cause scalability issues or even OutOfMemoryExceptions  
+               using (SqlDataReader reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess)) {  
+                  while (await reader.ReadAsync()) {  
+                     Console.WriteLine("{0}: ", reader.GetInt32(0));  
+  
+                     if (await reader.IsDBNullAsync(1)) {  
+                        Console.WriteLine("\t(NULL)");  
+                     }  
+                     else {  
+                        using (XmlReader xmlReader = reader.GetXmlReader(1)) {  
+                           int depth = 1;  
+                           // NOTE: The XmlReader returned by GetXmlReader does NOT support async operations  
+                           // See the example below (PrintXmlValuesViaNVarChar) for how to get an XmlReader with asynchronous capabilities  
+                           while (xmlReader.Read()) {  
+                              switch (xmlReader.NodeType) {  
+                                 case XmlNodeType.Element:  
+                                    Console.WriteLine("{0}<{1}>", new string('\t', depth), xmlReader.Name);  
+                                    depth++;  
+                                    break;  
+                                 case XmlNodeType.Text:  
+                                    Console.WriteLine("{0}{1}", new string('\t', depth), xmlReader.Value);  
+                                    break;  
+                                 case XmlNodeType.EndElement:  
+                                    depth--;  
+                                    Console.WriteLine("{0}</{1}>", new string('\t', depth), xmlReader.Name);  
+                                    break;  
+                              }  
+                           }  
+                        }  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+  
+      // Application transferring a large Xml Document from SQL Server in .NET 4.5  
+      // This goes via NVarChar and TextReader to enable asynchronous reading  
+      private static async Task PrintXmlValuesViaNVarChar() {  
+         XmlReaderSettings xmlSettings = new XmlReaderSettings() {  
+            // Async must be explicitly enabled in the XmlReaderSettings otherwise the XmlReader will throw exceptions when async methods are called  
+            Async = true,  
+            // Since we will immediately wrap the TextReader we are creating in an XmlReader, we will permit the XmlReader to take care of closing\disposing it  
+            CloseInput = true,  
+            // If the Xml you are reading is not a valid document (as per http://msdn.microsoft.com/library/6bts1x50.aspx) you will need to set the conformance level to Fragment  
+            ConformanceLevel = ConformanceLevel.Fragment  
+         };  
+  
+         using (SqlConnection connection = new SqlConnection(connectionString)) {  
+            await connection.OpenAsync();  
+  
+            // Cast the XML into NVarChar to enable GetTextReader - trying to use GetTextReader on an XML type will throw an exception  
+            using (SqlCommand command = new SqlCommand("SELECT [id], CAST([xmldata] AS NVARCHAR(MAX)) FROM [Streams]", connection)) {  
+  
+               // The reader needs to be executed with the SequentialAccess behavior to enable network streaming  
+               // Otherwise ReadAsync will buffer the entire Xml Document into memory which can cause scalability issues or even OutOfMemoryExceptions  
+               using (SqlDataReader reader = await command.ExecuteReaderAsync(CommandBehavior.SequentialAccess)) {  
+                  while (await reader.ReadAsync()) {  
+                     Console.WriteLine("{0}:", reader.GetInt32(0));  
+  
+                     if (await reader.IsDBNullAsync(1)) {  
+                        Console.WriteLine("\t(NULL)");  
+                     }  
+                     else {  
+                        // Grab the row as a TextReader, then create an XmlReader on top of it  
+                        // We are not keeping a reference to the TextReader since the XmlReader is created with the "CloseInput" setting (so it will close the TextReader when needed)  
+                        using (XmlReader xmlReader = XmlReader.Create(reader.GetTextReader(1), xmlSettings)) {  
+                           int depth = 1;  
+                           // The XmlReader above now supports asynchronous operations, so we can use ReadAsync here  
+                           while (await xmlReader.ReadAsync()) {  
+                              switch (xmlReader.NodeType) {  
+                                 case XmlNodeType.Element:  
+                                    Console.WriteLine("{0}<{1}>", new string('\t', depth), xmlReader.Name);  
+                                    depth++;  
+                                    break;  
+                                 case XmlNodeType.Text:  
+                                    // Depending on what your data looks like, you should either use Value or GetValueAsync  
+                                    // Value has less overhead (since it doesn't create a Task), but it may also block if additional data is required  
+                                    Console.WriteLine("{0}{1}", new string('\t', depth), await xmlReader.GetValueAsync());  
+                                    break;  
+                                 case XmlNodeType.EndElement:  
+                                    depth--;  
+                                    Console.WriteLine("{0}</{1}>", new string('\t', depth), xmlReader.Name);  
+                                    break;  
+                              }  
+                           }  
+                        }  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+   }  
+}  
+  
+```  
+  
+## サンプル \-\- [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] へのストリーミング  
+ 次の [!INCLUDE[tsql](../../../../includes/tsql-md.md)] を使用して、サンプル データベースを作成します。  
+  
+```  
+CREATE DATABASE [Demo2]  
+GO  
+USE [Demo2]  
+GO  
+CREATE TABLE [BinaryStreams] (  
+[id] INT PRIMARY KEY IDENTITY(1, 1),  
+[bindata] VARBINARY(MAX))  
+GO  
+CREATE TABLE [TextStreams] (  
+[id] INT PRIMARY KEY IDENTITY(1, 1),  
+[textdata] NVARCHAR(MAX))  
+GO  
+CREATE TABLE [BinaryStreamsCopy] (  
+[id] INT PRIMARY KEY IDENTITY(1, 1),  
+[bindata] VARBINARY(MAX))  
+GO  
+```  
+  
+ このサンプルでは、次の処理の実行方法を示します。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] で [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] に大きな BLOB を転送する。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] で [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] に大きなテキスト ファイルを転送する。  
+  
+-   新しい非同期機能を使用して大きな BLOB を転送する。  
+  
+-   新しい非同期機能と Await キーワードを使用して大きな BLOB を転送する。  
+  
+-   大きな BLOB の転送を取り消す。  
+  
+-   新しい非同期機能を使用して [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] から別の SQL Server にストリーミングする。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.IO;  
+using System.Threading;  
+using System.Threading.Tasks;  
+  
+namespace StreamingToServer {  
+   class Program {  
+      // Replace the connection string if needed, for instance to connect to SQL Express: @"Server=(local)\SQLEXPRESS;Database=Demo2;Integrated Security=true"  
+      private const string connectionString = @"Server=(localdb)\V11.0;Database=Demo2";  
+  
+      static void Main(string[] args) {  
+         CreateDemoFiles();  
+  
+         StreamBLOBToServer().Wait();  
+         StreamTextToServer().Wait();  
+  
+         // Create a CancellationTokenSource that will be cancelled after 100ms  
+         // Typically this token source will be cancelled by a user request (e.g. a Cancel button)  
+         CancellationTokenSource tokenSource = new CancellationTokenSource();  
+         tokenSource.CancelAfter(100);  
+         try {  
+            CancelBLOBStream(tokenSource.Token).Wait();  
+         }  
+         catch (AggregateException ex) {  
+            // Cancelling an async operation will throw an exception  
+            // Since we are using the Task's Wait method, this exception will be wrapped in an AggregateException  
+            // If you were using the 'await' keyword, the compiler would take care of unwrapping the AggregateException  
+            // Depending on when the cancellation occurs, you can either get an error from SQL Server or from .Net  
+            if ((ex.InnerException is SqlException) || (ex.InnerException is TaskCanceledException)) {  
+               // This is an expected exception  
+               Console.WriteLine("Got expected exception: {0}", ex.InnerException.Message);  
+            }  
+            else {  
+               // Did not expect this exception - re-throw it  
+               throw;  
+            }  
+         }  
+  
+         Console.WriteLine("Done");  
+      }  
+  
+      // This is used to generate the files which are used by the other sample methods  
+      private static void CreateDemoFiles() {  
+         Random rand = new Random();  
+         byte[] data = new byte[1024];  
+         rand.NextBytes(data);  
+  
+         using (FileStream file = File.Open("binarydata.bin", FileMode.Create)) {  
+            file.Write(data, 0, data.Length);  
+         }  
+  
+         using (StreamWriter writer = new StreamWriter(File.Open("textdata.txt", FileMode.Create))) {  
+            writer.Write(Convert.ToBase64String(data));  
+         }  
+      }  
+  
+      // Application transferring a large BLOB to SQL Server in .Net 4.5  
+      private static async Task StreamBLOBToServer() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            await conn.OpenAsync();  
+            using (SqlCommand cmd = new SqlCommand("INSERT INTO [BinaryStreams] (bindata) VALUES (@bindata)", conn)) {  
+               using (FileStream file = File.Open("binarydata.bin", FileMode.Open)) {  
+  
+                  // Add a parameter which uses the FileStream we just opened  
+                  // Size is set to -1 to indicate "MAX"  
+                  cmd.Parameters.Add("@bindata", SqlDbType.Binary, -1).Value = file;  
+  
+                  // Send the data to the server asynchronously  
+                  await cmd.ExecuteNonQueryAsync();  
+               }  
+            }  
+         }  
+      }  
+  
+      // Application transferring a large Text File to SQL Server in .Net 4.5  
+      private static async Task StreamTextToServer() {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            await conn.OpenAsync();  
+            using (SqlCommand cmd = new SqlCommand("INSERT INTO [TextStreams] (textdata) VALUES (@textdata)", conn)) {  
+               using (StreamReader file = File.OpenText("textdata.txt")) {  
+  
+                  // Add a parameter which uses the StreamReader we just opened  
+                  // Size is set to -1 to indicate "MAX"  
+                  cmd.Parameters.Add("@textdata", SqlDbType.NVarChar, -1).Value = file;  
+  
+                  // Send the data to the server asynchronously  
+                  await cmd.ExecuteNonQueryAsync();  
+               }  
+            }  
+         }  
+      }  
+  
+      // Cancelling the transfer of a large BLOB  
+      private static async Task CancelBLOBStream(CancellationToken cancellationToken) {  
+         using (SqlConnection conn = new SqlConnection(connectionString)) {  
+            // We can cancel not only sending the data to the server, but also opening the connection  
+            await conn.OpenAsync(cancellationToken);  
+  
+            // Artifically delay the command by 100ms  
+            using (SqlCommand cmd = new SqlCommand("WAITFOR DELAY '00:00:00:100';INSERT INTO [BinaryStreams] (bindata) VALUES (@bindata)", conn)) {  
+               using (FileStream file = File.Open("binarydata.bin", FileMode.Open)) {  
+  
+                  // Add a parameter which uses the FileStream we just opened  
+                  // Size is set to -1 to indicate "MAX"  
+                  cmd.Parameters.Add("@bindata", SqlDbType.Binary, -1).Value = file;  
+  
+                  // Send the data to the server asynchronously  
+                  // Pass the cancellation token such that the command will be cancelled if needed  
+                  await cmd.ExecuteNonQueryAsync(cancellationToken);  
+               }  
+            }  
+         }  
+      }  
+   }  
+}  
+  
+```  
+  
+## サンプル \-\- ある [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] から別の [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] へのストリーミング  
+ このサンプルでは、取り消し処理がサポートされている、大きな BLOB を [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] 間で非同期にストリーミングする方法を示します。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.SqlClient;  
+using System.IO;  
+using System.Threading;  
+using System.Threading.Tasks;  
+  
+namespace StreamingFromServerToAnother {  
+   class Program {  
+      // Replace the connection string if needed, for instance to connect to SQL Express: @"Server=(local)\SQLEXPRESS;Database=Demo2;Integrated Security=true"  
+      private const string connectionString = @"Server=(localdb)\V11.0;Database=Demo2";  
+  
+      static void Main(string[] args) {  
+         // For this example, we don't want to cancel  
+         // So we can pass in a "blank" cancellation token  
+         E2EStream(CancellationToken.None).Wait();  
+  
+         Console.WriteLine("Done");  
+      }  
+  
+      // Streaming from one SQL Server to Another One using the new Async.NET  
+      private static async Task E2EStream(CancellationToken cancellationToken) {  
+         using (SqlConnection readConn = new SqlConnection(connectionString)) {  
+            using (SqlConnection writeConn = new SqlConnection(connectionString)) {  
+  
+               // Note that we are using the same cancellation token for calls to both connections\commands  
+               // Also we can start both the connection opening asynchronously, and then wait for both to complete  
+               Task openReadConn = readConn.OpenAsync(cancellationToken);  
+               Task openWriteConn = writeConn.OpenAsync(cancellationToken);  
+               await Task.WhenAll(openReadConn, openWriteConn);  
+  
+               using (SqlCommand readCmd = new SqlCommand("SELECT [bindata] FROM [BinaryStreams]", readConn)) {  
+                  using (SqlCommand writeCmd = new SqlCommand("INSERT INTO [BinaryStreamsCopy] (bindata) VALUES (@bindata)", writeConn)) {  
+  
+                     // Add an empty parameter to the write command which will be used for the streams we are copying  
+                     // Size is set to -1 to indicate "MAX"  
+                     SqlParameter streamParameter = writeCmd.Parameters.Add("@bindata", SqlDbType.Binary, -1);  
+  
+                     // The reader needs to be executed with the SequentialAccess behavior to enable network streaming  
+                     // Otherwise ReadAsync will buffer the entire BLOB into memory which can cause scalability issues or even OutOfMemoryExceptions  
+                     using (SqlDataReader reader = await readCmd.ExecuteReaderAsync(CommandBehavior.SequentialAccess, cancellationToken)) {  
+                        while (await reader.ReadAsync(cancellationToken)) {  
+                           // Grab a stream to the binary data in the source database  
+                           using (Stream dataStream = reader.GetStream(0)) {  
+  
+                              // Set the parameter value to the stream source that was opened  
+                              streamParameter.Value = dataStream;  
+  
+                              // Asynchronously send data from one database to another  
+                              await writeCmd.ExecuteNonQueryAsync(cancellationToken);  
+                           }  
+                        }  
+                     }  
+                  }  
+               }  
+            }  
+         }  
+      }  
+   }  
+}  
+  
+```  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/system-requirements-for-the-dotnet-data-provider-for-oracle.md b/docs/framework/data/adonet/system-requirements-for-the-dotnet-data-provider-for-oracle.md
new file mode 100644
index 00000000000..6700b862bac
--- /dev/null
+++ b/docs/framework/data/adonet/system-requirements-for-the-dotnet-data-provider-for-oracle.md
@@ -0,0 +1,49 @@
+---
+title: ".NET Framework Data Provider for Oracle のシステム要件 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 054f76b9-1737-43f0-8160-84a00a387217
+caps.latest.revision: 3
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 3
+---
+# .NET Framework Data Provider for Oracle のシステム要件
+.NET Framework Data Provider for Oracle を使用するには、MDAC \(Microsoft Data Access Components\) のバージョン 2.6 以降が必要です。  MDAC 2.8 SP1 をインストールすることをお勧めします。  
+  
+ Oracle 8i Release 3 \(8.1.7\) Client 以降もインストールする必要があります。  
+  
+ UTF16 は Oracle 9i の新機能なので、Oracle 9i 以前のバージョンの Oracle Client ソフトウェアでは UTF16 データベースにアクセスできません。  この機能を使用するには、お使いのクライアント ソフトウェアを Oracle 9i 以降にアップグレードする必要があります。  
+  
+## Data Provider for Oracle と Unicode データの使用  
+ .NET Framework Data Provider for Oracle および Oracle クライアント ライブラリを使用するときに考慮が必要な、Unicode に関連する問題の一覧を以下に示します。  詳細については、Oracle のドキュメントを参照してください。  
+  
+### 接続文字列の属性に Unicode 値を設定する  
+ Oracle を操作する場合、接続文字列の属性を使用し、  
+  
+```  
+Unicode=True   
+```  
+  
+ UTF\-16 モードで Oracle クライアント ライブラリを初期化することができます。  これにより、Oracle クライアント ライブラリで、マルチバイト文字列の代わりに UTF\-16 \(UCS\-2 とよく似ています\) が使用できるようになります。  新たに変換作業を行わなくても、Data Provider for Oracle で Oracle のコード ページを常に使用できます。  この構成は、Oracle 9i クライアントを使用して、AL16UTF16 の代替文字セットを持つ Oracle 9i データベースと通信する場合に動作します。  Oracle 9i クライアントが Oracle 9i サーバーと通信するとき、Unicode の **CommandText** 値を Oracle 9i サーバーが使用する適切なマルチバイト文字セットに変換するためのリソースが別に必要になります。  安全な構成が確保されていることがわかっている場合は、`Unicode=True` を接続文字列に追加することにより回避することができます。  
+  
+### Oracle クライアントと Oracle サーバーのバージョンの混在  
+ Oracle 8i クライアントは、サーバーの各国語文字セットが AL16UTF16 \(Oracle 9i の既定の設定\) に指定されている場合、Oracle 9i データベースの **NCHAR**、**NVARCHAR2**、または **NCLOB** データにアクセスできません。  UTF\-16 文字セットのサポートは Oracle 9i まで導入されなかったため、Oracle 8i クライアントでは読み取れません。  
+  
+### UTF\-8 データの使用  
+ 代替文字セットを設定するには、レジストリ キー HKEY\_LOCAL\_MACHINE\\SOFTWARE\\ORACLE\\HOMEID\\NLS\_LANG を UTF8 に設定します。  詳細については、ご使用のプラットフォームに関する Oracle のインストール ノートを参照してください。  既定の設定は、Oracle Client ソフトウェアのインストールに使用する言語の基本文字セットになっています。  接続するデータベースの各国語文字セットと言語が一致するように設定されていないと、パラメーターと列の組み合わせは、各国語文字セットではなくプライマリ データベースの文字セットでデータを送受信します。  
+  
+### OracleLob で更新できるのは Full 文字列のみです。  
+ ユーザビリティ上の理由から、<xref:System.Data.OracleClient.OracleLob> オブジェクトは .NET Framework Stream クラスを継承して、**ReadByte** および **WriteByte** メソッドを提供します。  Oracle **LOB** オブジェクトのセクションで動作する **CopyTo** や **Erase** などのメソッドも実装します。  対照的に、Oracle クライアント ソフトウェアには、文字列 **LOB** \(**CLOB** および **NCLOB**\) で使用できる多くの API があります。  ただし、これらの API は full 文字列でのみ動作します。  こうした違いにより、Data Provider for Oracle の実装では、バイトと同様に UTF\-16 を使用できるよう **Read** および **ReadByte** をサポートしています。  ただし、**OracleLob** オブジェクトのその他のメソッドで使用できるのは、full 文字列操作のみです。  
+  
+## 参照  
+ [Oracle および ADO.NET](../../../../docs/framework/data/adonet/oracle-and-adonet.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/system-transactions-integration-with-sql-server.md b/docs/framework/data/adonet/system-transactions-integration-with-sql-server.md
new file mode 100644
index 00000000000..178ea1131a3
--- /dev/null
+++ b/docs/framework/data/adonet/system-transactions-integration-with-sql-server.md
@@ -0,0 +1,237 @@
+---
+title: "SQL Server と System.Transactions の統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b555544e-7abb-4814-859b-ab9cdd7d8716
+caps.latest.revision: 6
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 6
+---
+# SQL Server と System.Transactions の統合
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] バージョン 2.0 では、<xref:System.Transactions> 名前空間を介してアクセスできるトランザクション フレームワークが導入されました。 このフレームワークでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] を含む [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] に完全に統合された形でトランザクションが公開されます。  
+  
+ プログラミング上の強化に加えて、<xref:System.Transactions> と [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の連係により、トランザクション処理が最適化されます。 昇格可能なトランザクションとは、必要に応じて完全な分散トランザクションに自動的に昇格する、軽量の \(ローカル\) トランザクションです。  
+  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] 2.0 以降では、<xref:System.Data.SqlClient> を組み合わせて使用した場合、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] によって昇格可能なトランザクションがサポートされます。 昇格可能なトランザクションは、必要な場合以外、分散トランザクションのオーバーヘッドの増加を引き起こすことはありません。 昇格可能なトランザクションは自動的に処理され、開発者による介入は必要ありません。  
+  
+ 昇格可能なトランザクションは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for SQL Server \(`SqlClient`\) を [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] で使用する場合のみ使用可能です。  
+  
+## 昇格可能なトランザクションの作成  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Provider for SQL Server では昇格可能なトランザクションをサポートしており、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]<xref:System.Transactions> 名前空間内のクラスを介して処理されます。 昇格可能なトランザクションでは、必要が生じるまで分散トランザクションの作成を延期することで、分散トランザクションが最適化されます。 必要なリソース マネージャーが 1 つだけである場合は、分散トランザクションは発生しません。  
+  
+> [!NOTE]
+>  部分信頼のシナリオで分散トランザクションに昇格するには、<xref:System.Transactions.DistributedTransactionPermission> が必要です。  
+  
+## 昇格可能なトランザクションのシナリオ  
+ 分散トランザクションは一般的にシステム リソースを大量に消費するため、トランザクションでアクセスされるすべてのリソース マネージャーを統合する、Microsoft Distributed Transaction Coordinator \(MS DTC\) で管理されます。 昇格可能なトランザクションは特殊な形式の <xref:System.Transactions> トランザクションで、単純な [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] トランザクションに処理を効果的に委任できます。<xref:System.Transactions>、<xref:System.Data.SqlClient>、および [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] は、トランザクションの処理に関連する作業を調整し、必要に応じて、トランザクションを完全な分散トランザクションに昇格します。  
+  
+ 昇格可能なトランザクションを使用する利点は、アクティブな <xref:System.Transactions.TransactionScope> トランザクションによって接続が開かれ、その他の接続が開いていない場合に、完全な分散トランザクションによるオーバーヘッドが生じることなく、トランザクションが軽量なトランザクションとしてコミットされることです。  
+  
+### 接続文字列キーワード  
+ <xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A> プロパティではキーワード `Enlist` がサポートされており、<xref:System.Data.SqlClient> によってトランザクションのコンテキストが検出され、分散トランザクションに接続が自動的に参加するかどうかが示されます。`Enlist=true` である場合は、開いているスレッドの現在のトランザクション コンテキストに接続が自動的に参加します。`Enlist=false` である場合、`SqlClient` 接続は分散トランザクションとは対話しません。`Enlist` の既定値は true です。`Enlist` が接続文字列で指定されていない場合、接続が開いたときに分散トランザクションがあればそれに自動的に参加します。  
+  
+ 参加する `Transaction Binding` トランザクションと接続の関連付けは、<xref:System.Data.SqlClient.SqlConnection> 接続文字列の `System.Transactions` キーワードによって制御されます。<xref:System.Data.SqlClient.SqlConnectionStringBuilder.TransactionBinding%2A> の <xref:System.Data.SqlClient.SqlConnectionStringBuilder> プロパティを介して利用することもできます。  
+  
+ 次の表で使用可能な値について説明します。  
+  
+|キーワード|説明|  
+|-----------|--------|  
+|Implicit Unbind|これが既定値です。 完了時に接続がトランザクションからデタッチされ、自動コミット モードに切り替わります。|  
+|Explicit Unbind|トランザクションが閉じられるまで、接続がトランザクションにアタッチされたままになります。 関連付けられているトランザクションがアクティブでない場合や、<xref:System.Transactions.Transaction.Current%2A> と一致しない場合、接続は失敗します。|  
+  
+## TransactionScope の使用  
+ <xref:System.Transactions.TransactionScope> クラスでは、接続を分散トランザクションに暗黙的に参加させることで、コード ブロックがトランザクションのコード ブロックになります。<xref:System.Transactions.TransactionScope.Complete%2A> ブロックの末尾では、終了する前に <xref:System.Transactions.TransactionScope> メソッドを呼び出す必要があります。 ブロックを終了すると、<xref:System.Transactions.TransactionScope.Dispose%2A> メソッドが呼び出されます。 例外がスローされてコードがスコープから外れている場合は、トランザクションがアボートされたと見なされます。  
+  
+ 使用中のブロックを終了したときに `using` オブジェクトで <xref:System.Transactions.TransactionScope.Dispose%2A> が呼び出されるように、<xref:System.Transactions.TransactionScope> ブロックを使用することをお勧めします。 保留中のトランザクションのコミットまたはロールバックに失敗すると、<xref:System.Transactions.TransactionScope> の既定のタイムアウトが 1 分であるため、パフォーマンスが大幅に低下する場合があります。`using` ステートメントを使用しない場合は、すべての処理を `Try` ブロックで実行し、<xref:System.Transactions.TransactionScope.Dispose%2A> メソッドを `Finally` ブロック内で明示的に呼び出す必要があります。  
+  
+ <xref:System.Transactions.TransactionScope> 内で例外が発生した場合、そのトランザクションは矛盾しているとしてマークされ、破棄されます。 トランザクションは、<xref:System.Transactions.TransactionScope> が破棄されるとロールバックされます。 例外が発生しない場合は、参加しているトランザクションがコミットされます。  
+  
+> [!NOTE]
+>  既定では、`TransactionScope` クラスは、<xref:System.Transactions.Transaction.IsolationLevel%2A> が `Serializable` であるトランザクションを作成します。 使用しているアプリケーションによっては、アプリケーション内での競合を回避するために、分離レベルを低下させる必要がある場合があります。  
+  
+> [!NOTE]
+>  データベース リソースを大量に消費するため、分散トランザクション内で実行するのは更新、挿入、削除だけにすることをお勧めします。 Select ステートメントを使用すると、データベース リソースが不必要にロックされることがあり、シナリオによっては選択にトランザクションを使用する必要がある場合があります。 処理済みのその他のリソース マネージャーに関係する場合以外、データベース以外の処理はトランザクションのスコープ外で実行する必要があります。 トランザクションのスコープ内で例外が発生するとトランザクションのコミットが防止されますが、<xref:System.Transactions.TransactionScope> クラスでは、作成したコードによってトランザクションのスコープ外で行われた変更はロールバックされません。 トランザクションがロールバックされたときに何らかの動作を行うようにする場合は、<xref:System.Transactions.IEnlistmentNotification> インターフェイスを独自に実装し、トランザクションに明示的に参加する必要があります。  
+  
+## 例  
+ <xref:System.Transactions> を使用する場合は、System.Transactions.dll への参照が必要になります。  
+  
+ 次の関数は、<xref:System.Data.SqlClient.SqlConnection> ブロックでラップされている、異なる 2 つの <xref:System.Transactions.TransactionScope> オブジェクトで表された異なる 2 つの SQL Server インスタンスに対する、昇格可能なトランザクションを作成する方法を示しています。 このコードにより、<xref:System.Transactions.TransactionScope> ステートメントを持つ `using` ブロックが作成され、最初の接続が開き、<xref:System.Transactions.TransactionScope> に自動的に参加します。 このトランザクションは、完全な分散トランザクションとしてではなく、最初に軽量のトランザクションとして参加します。 2 つ目の接続は、1 つ目の接続のコマンドで例外がスローされなかった場合にのみ、<xref:System.Transactions.TransactionScope> に参加します。 2 つ目の接続が開かれると、トランザクションが完全な分散トランザクションに自動的に昇格されます。<xref:System.Transactions.TransactionScope.Complete%2A> メソッドが呼び出され、例外がスローされなかった場合にのみ、トランザクションがコミットされます。<xref:System.Transactions.TransactionScope> ブロックの任意の場所で例外がスローされると、`Complete` が呼び出されず、<xref:System.Transactions.TransactionScope> ブロックの最後で `using` が破棄されたときに分散トランザクションがロールバックされます。  
+  
+```csharp  
+// This function takes arguments for the 2 connection strings and commands in order  
+// to create a transaction involving two SQL Servers. It returns a value > 0 if the  
+// transaction committed, 0 if the transaction rolled back. To test this code, you can   
+// connect to two different databases on the same server by altering the connection string,  
+// or to another RDBMS such as Oracle by altering the code in the connection2 code block.  
+static public int CreateTransactionScope(  
+    string connectString1, string connectString2,  
+    string commandText1, string commandText2)  
+{  
+    // Initialize the return value to zero and create a StringWriter to display results.  
+    int returnValue = 0;  
+    System.IO.StringWriter writer = new System.IO.StringWriter();  
+  
+    // Create the TransactionScope in which to execute the commands, guaranteeing  
+    // that both commands will commit or roll back as a single unit of work.  
+    using (TransactionScope scope = new TransactionScope())  
+    {  
+        using (SqlConnection connection1 = new SqlConnection(connectString1))  
+        {  
+            try  
+            {  
+                // Opening the connection automatically enlists it in the   
+                // TransactionScope as a lightweight transaction.  
+                connection1.Open();  
+  
+                // Create the SqlCommand object and execute the first command.  
+                SqlCommand command1 = new SqlCommand(commandText1, connection1);  
+                returnValue = command1.ExecuteNonQuery();  
+                writer.WriteLine("Rows to be affected by command1: {0}", returnValue);  
+  
+                // if you get here, this means that command1 succeeded. By nesting  
+                // the using block for connection2 inside that of connection1, you  
+                // conserve server and network resources by opening connection2   
+                // only when there is a chance that the transaction can commit.     
+                using (SqlConnection connection2 = new SqlConnection(connectString2))  
+                    try  
+                    {  
+                        // The transaction is promoted to a full distributed  
+                        // transaction when connection2 is opened.  
+                        connection2.Open();  
+  
+                        // Execute the second command in the second database.  
+                        returnValue = 0;  
+                        SqlCommand command2 = new SqlCommand(commandText2, connection2);  
+                        returnValue = command2.ExecuteNonQuery();  
+                        writer.WriteLine("Rows to be affected by command2: {0}", returnValue);  
+                    }  
+                    catch (Exception ex)  
+                    {  
+                        // Display information that command2 failed.  
+                        writer.WriteLine("returnValue for command2: {0}", returnValue);  
+                        writer.WriteLine("Exception Message2: {0}", ex.Message);  
+                    }  
+            }  
+            catch (Exception ex)  
+            {  
+                // Display information that command1 failed.  
+                writer.WriteLine("returnValue for command1: {0}", returnValue);  
+                writer.WriteLine("Exception Message1: {0}", ex.Message);  
+            }  
+        }  
+  
+        // If an exception has been thrown, Complete will not   
+        // be called and the transaction is rolled back.  
+        scope.Complete();  
+    }  
+  
+    // The returnValue is greater than 0 if the transaction committed.  
+    if (returnValue > 0)  
+    {  
+        writer.WriteLine("Transaction was committed.");  
+    }  
+    else  
+    {  
+        // You could write additional business logic here, notify the caller by  
+        // throwing a TransactionAbortedException, or log the failure.  
+        writer.WriteLine("Transaction rolled back.");  
+    }  
+  
+    // Display messages.  
+    Console.WriteLine(writer.ToString());  
+  
+    return returnValue;  
+}  
+```  
+  
+```vb  
+' This function takes arguments for the 2 connection strings and commands in order  
+' to create a transaction involving two SQL Servers. It returns a value > 0 if the  
+' transaction committed, 0 if the transaction rolled back. To test this code, you can   
+' connect to two different databases on the same server by altering the connection string,  
+' or to another RDBMS such as Oracle by altering the code in the connection2 code block.  
+Public Function CreateTransactionScope( _  
+  ByVal connectString1 As String, ByVal connectString2 As String, _  
+  ByVal commandText1 As String, ByVal commandText2 As String) As Integer  
+  
+    ' Initialize the return value to zero and create a StringWriter to display results.  
+    Dim returnValue As Integer = 0  
+    Dim writer As System.IO.StringWriter = New System.IO.StringWriter  
+  
+    ' Create the TransactionScope in which to execute the commands, guaranteeing  
+    ' that both commands will commit or roll back as a single unit of work.  
+    Using scope As New TransactionScope()  
+        Using connection1 As New SqlConnection(connectString1)  
+            Try  
+                ' Opening the connection automatically enlists it in the   
+                ' TransactionScope as a lightweight transaction.  
+                connection1.Open()  
+  
+                ' Create the SqlCommand object and execute the first command.  
+                Dim command1 As SqlCommand = New SqlCommand(commandText1, connection1)  
+                returnValue = command1.ExecuteNonQuery()  
+                writer.WriteLine("Rows to be affected by command1: {0}", returnValue)  
+  
+                ' If you get here, this means that command1 succeeded. By nesting  
+                ' the Using block for connection2 inside that of connection1, you  
+                ' conserve server and network resources by opening connection2   
+                ' only when there is a chance that the transaction can commit.     
+                Using connection2 As New SqlConnection(connectString2)  
+                    Try  
+                        ' The transaction is promoted to a full distributed  
+                        ' transaction when connection2 is opened.  
+                        connection2.Open()  
+  
+                        ' Execute the second command in the second database.  
+                        returnValue = 0  
+                        Dim command2 As SqlCommand = New SqlCommand(commandText2, connection2)  
+                        returnValue = command2.ExecuteNonQuery()  
+                        writer.WriteLine("Rows to be affected by command2: {0}", returnValue)  
+  
+                    Catch ex As Exception  
+                        ' Display information that command2 failed.  
+                        writer.WriteLine("returnValue for command2: {0}", returnValue)  
+                        writer.WriteLine("Exception Message2: {0}", ex.Message)  
+                    End Try  
+                End Using  
+  
+            Catch ex As Exception  
+                ' Display information that command1 failed.  
+                writer.WriteLine("returnValue for command1: {0}", returnValue)  
+                writer.WriteLine("Exception Message1: {0}", ex.Message)  
+            End Try  
+        End Using  
+  
+        ' If an exception has been thrown, Complete will   
+        ' not be called and the transaction is rolled back.  
+        scope.Complete()  
+    End Using  
+  
+    ' The returnValue is greater than 0 if the transaction committed.  
+    If returnValue > 0 Then  
+        writer.WriteLine("Transaction was committed.")  
+    Else  
+        ' You could write additional business logic here, notify the caller by  
+        ' throwing a TransactionAbortedException, or log the failure.  
+       writer.WriteLine("Transaction rolled back.")  
+     End If  
+  
+    ' Display messages.  
+    Console.WriteLine(writer.ToString())  
+  
+    Return returnValue  
+End Function  
+```  
+  
+## 参照  
+ [トランザクションと同時実行](../../../../docs/framework/data/adonet/transactions-and-concurrency.md)   
+ [ADO.NET のマネージ プロバイダーと DataSet デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/transactions-and-concurrency.md b/docs/framework/data/adonet/transactions-and-concurrency.md
new file mode 100644
index 00000000000..106cfc57db5
--- /dev/null
+++ b/docs/framework/data/adonet/transactions-and-concurrency.md
@@ -0,0 +1,50 @@
+---
+title: "トランザクションと同時実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f46570de-9e50-4fe6-8710-a8c31fa8569b
+caps.latest.revision: 5
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 5
+---
+# トランザクションと同時実行
+トランザクションは、単一のコマンド、またはパッケージとして実行されるコマンドのグループで構成されます。  トランザクションを使用することで、複数の操作を 1 つの作業単位にまとめることができます。  トランザクションのあるポイントで障害が発生した場合は、トランザクションが開始される前の状態にすべての更新をロールバックできます。  
+  
+ データの一貫性を保証するために、トランザクションは ACID プロパティ \(原始性、一貫性、分離性、および持続性\) に準拠する必要があります。  Microsoft SQL Server など、ほとんどのリレーショナル データベース システムでは、クライアント アプリケーションが更新、挿入、または削除の操作を行うたびに、ロック、ログ、およびトランザクション管理の機能を提供し、トランザクションをサポートします。  
+  
+> [!NOTE]
+>  複数のリソースがかかわるトランザクションで、ロックがあまりにも長く保持されると、同時実行数が少なくなる場合があります。  そのため、トランザクションはできるだけ短くします。  
+  
+ トランザクションに、同じデータベースまたはサーバーの複数のテーブルが含まれている場合、一般的にストアド プロシージャ内の明示的トランザクションの方がパフォーマンスが向上します。  SQL Server のストアド プロシージャにトランザクションを作成するには、Transact\-SQL ステートメントの `BEGIN TRANSACTION`、`COMMIT TRANSACTION`、および `ROLLBACK TRANSACTION` を使用します。  詳細については、SQL Server オンライン ブックを参照してください。  
+  
+ [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] と Oracle 間のトランザクションなど、種類の異なるリソース マネージャーがトランザクションに含まれる場合、分散トランザクションが必要になります。  
+  
+## このセクションの内容  
+ [ローカル トランザクション](../../../../docs/framework/data/adonet/local-transactions.md)  
+ データベースに対してトランザクションを実行する方法を示します。  
+  
+ [分散トランザクション](../../../../docs/framework/data/adonet/distributed-transactions.md)  
+ ADO.NET で分散トランザクションを実行する方法について説明します。  
+  
+ [SQL Server と System.Transactions の統合](../../../../docs/framework/data/adonet/system-transactions-integration-with-sql-server.md)  
+ 分散トランザクションを使用するための、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] の <xref:System.Transactions> 統合について説明します。  
+  
+ [オプティミスティック同時実行制御](../../../../docs/framework/data/adonet/optimistic-concurrency.md)  
+ オプティミスティック同時実行制御とペシミスティック同時実行制御について、および同時実行違反をテストする方法について説明します。  
+  
+## 参照  
+ [Transaction Fundamentals](http://msdn.microsoft.com/ja-jp/2a476b63-b94f-443f-992d-53943fdf4e5d)   
+ [データ ソースへの接続](../../../../docs/framework/data/adonet/connecting-to-a-data-source.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [DbProviderFactories](../../../../docs/framework/data/adonet/dbproviderfactories.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/updating-data-in-a-data-source.md b/docs/framework/data/adonet/updating-data-in-a-data-source.md
new file mode 100644
index 00000000000..f8cb2bef8dc
--- /dev/null
+++ b/docs/framework/data/adonet/updating-data-in-a-data-source.md
@@ -0,0 +1,102 @@
+---
+title: "データ ソースのデータの更新 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 55c545e5-dcd5-4323-a5b9-3825c2157462
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# データ ソースのデータの更新
+データを変更する SQL ステートメント \(INSERT、UPDATE、DELETE など\) は行を返しません。  同様に、多くのストアド プロシージャは、アクションを実行しても行を返しません。  行を返さないコマンドを実行するには、適切な SQL コマンドを使用して **Command** オブジェクトを作成し、必要な **Parameters** を含む **Connection** を作成します。  **Command** オブジェクトの **ExecuteNonQuery** メソッドでコマンドを実行します。  
+  
+ **ExecuteNonQuery** メソッドは、実行されたステートメントまたはストアド プロシージャの影響を受けた行数を表す整数を返します。  複数のステートメントが実行された場合は、実行された各ステートメントの影響を受けたレコードの合計を示す値が返されます。  
+  
+## 例  
+ INSERT ステートメントを実行して、**ExecuteNonQuery** でデータベースにレコードを挿入するコード サンプルを次に示します。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+connection.Open()  
+  
+Dim queryString As String = "INSERT INTO Customers " & _  
+  "(CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')"  
+  
+Dim command As SqlCommand = New SqlCommand(queryString, connection)  
+Dim recordsAffected As Int32 = command.ExecuteNonQuery()  
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+connection.Open();  
+  
+string queryString = "INSERT INTO Customers " +  
+  "(CustomerID, CompanyName) Values('NWIND', 'Northwind Traders')";  
+  
+SqlCommand command = new SqlCommand(queryString, connection);  
+Int32 recordsAffected = command.ExecuteNonQuery();  
+```  
+  
+ 「[カタログ操作の実行](../../../../docs/framework/data/adonet/performing-catalog-operations.md)」と同じコードで作成されたストアド プロシージャを実行するコード サンプルを次に示します。  ストアド プロシージャは行を返さないため **ExecuteNonQuery** メソッドが使用されていますが、ストアド プロシージャは入力パラメーターを受け取り、出力パラメーターと戻り値を返します。  
+  
+ <xref:System.Data.OleDb.OleDbCommand> オブジェクトの場合は、最初に **Parameters** コレクションに **ReturnValue** パラメーターを追加する必要があります。  
+  
+```vb  
+' Assumes connection is a valid SqlConnection.  
+Dim command As SqlCommand = _  
+   New SqlCommand("InsertCategory" , connection)  
+command.CommandType = CommandType.StoredProcedure  
+  
+Dim parameter As SqlParameter = _  
+ command.Parameters.Add("@RowCount", SqlDbType.Int)  
+parameter.Direction = ParameterDirection.ReturnValue  
+  
+parameter = command.Parameters.Add( _  
+  "@CategoryName", SqlDbType.NChar, 15)  
+  
+parameter = command.Parameters.Add("@Identity", SqlDbType.Int)  
+parameter.Direction = ParameterDirection.Output  
+  
+command.Parameters("@CategoryName").Value = "New Category"  
+command.ExecuteNonQuery()  
+  
+Dim categoryID As Int32 = CInt(command.Parameters("@Identity").Value)  
+Dim rowCount As Int32 = CInt(command.Parameters("@RowCount").Value)   
+```  
+  
+```csharp  
+// Assumes connection is a valid SqlConnection.  
+SqlCommand command = new SqlCommand("InsertCategory" , connection);  
+command.CommandType = CommandType.StoredProcedure;  
+  
+SqlParameter parameter = command.Parameters.Add(  
+  "@RowCount", SqlDbType.Int);  
+parameter.Direction = ParameterDirection.ReturnValue;  
+  
+parameter = command.Parameters.Add(  
+  "@CategoryName", SqlDbType.NChar, 15);  
+  
+parameter = command.Parameters.Add("@Identity", SqlDbType.Int);  
+parameter.Direction = ParameterDirection.Output;  
+  
+command.Parameters["@CategoryName"].Value = "New Category";  
+command.ExecuteNonQuery();  
+  
+Int32 categoryID = (Int32) command.Parameters["@Identity"].Value;  
+Int32 rowCount = (Int32) command.Parameters["@RowCount"].Value;  
+```  
+  
+## 参照  
+ [コマンドを使用したデータ変更](../../../../docs/framework/data/adonet/using-commands-to-modify-data.md)   
+ [DataAdapter によるデータ ソースの更新](../../../../docs/framework/data/adonet/updating-data-sources-with-dataadapters.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/updating-data-sources-with-dataadapters.md b/docs/framework/data/adonet/updating-data-sources-with-dataadapters.md
new file mode 100644
index 00000000000..f50a91d3225
--- /dev/null
+++ b/docs/framework/data/adonet/updating-data-sources-with-dataadapters.md
@@ -0,0 +1,381 @@
+---
+title: "DataAdapter によるデータ ソースの更新 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d1bd9a8c-0e29-40e3-bda8-d89176b72fb1
+caps.latest.revision: 8
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 8
+---
+# DataAdapter によるデータ ソースの更新
+<xref:System.Data.Common.DataAdapter> の `Update` メソッドを呼び出して、変更を <xref:System.Data.DataSet> からデータ ソースに反映します。  `Update` メソッドは、`Fill` メソッドと同様に、引数として `DataSet` のインスタンスおよびオプションの <xref:System.Data.DataTable> オブジェクトまたは `DataTable` 名を受け取ります。  `DataSet` のインスタンスは、行われた変更点を格納する `DataSet` です。`DataTable` は、変更点の取得元のテーブルです。  `DataTable` を指定しなかった場合、`DataSet` 内の最初の `DataTable` が使用されます。  
+  
+ `Update` メソッドを呼び出すと、`DataAdapter` は、既に加えられた変更を解析し、適切なコマンド \(INSERT、UPDATE、または DELETE\) を実行します。  `DataAdapter` は <xref:System.Data.DataRow> へ加えられた変更を検出すると、<xref:System.Data.Common.DbDataAdapter.InsertCommand%2A>、<xref:System.Data.Common.DbDataAdapter.UpdateCommand%2A>、または <xref:System.Data.Common.DbDataAdapter.DeleteCommand%2A> を使用してその変更を処理します。  その結果、デザイン時にコマンド構文を指定し、可能な場合はストアド プロシージャを使用することにより、ADO.NET アプリケーションのパフォーマンスを最適化できます。  コマンドは `Update` を呼び出す前に明示的に設定する必要があります。  `Update` を呼び出し、その更新に関連する適切なコマンドが存在しない場合 \(たとえば、削除済みの行に関連する `DeleteCommand` が存在しない場合\) は、例外がスローされます。  
+  
+> [!NOTE]
+>  SQL Server のストアド プロシージャで、`DataAdapter` を使用してデータを編集または削除する場合、ストアド プロシージャの定義に SET NOCOUNT ON は使用しないでください。  処理された行数がゼロとして返され、`DataAdapter` によって同時実行の競合として解釈されてしまいます。  この場合、<xref:System.Data.DBConcurrencyException> がスローされます。  
+  
+ Command パラメーターを使用して、`DataSet` 内の各変更行に対する SQL ステートメントまたはストアド プロシージャに入力値と出力値を指定できます。  詳細については、「[DataAdapter パラメーター](../../../../docs/framework/data/adonet/dataadapter-parameters.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Data.DataTable> の行を Delete することと、行を Remove することの違いを理解することが大切です。  `Remove` メソッドまたは `RemoveAt` メソッドを呼び出した場合、行は直ちに削除されます。  その後、`DataTable` または `DataSet` を `DataAdapter` に渡し、`Update` を呼び出しても、バックエンド データ ソースの対応する行には影響しません。  `Delete` メソッドを使用した場合、行はそのまま `DataTable` 内に維持され、削除対象としてマークされます。  その後、`DataTable` または `DataSet` を `DataAdapter` に渡し、`Update` を呼び出すと、バックエンド データ ソースから対応する行が削除されます。  
+  
+ `DataTable` を単一データベース テーブルに割り当てたり、単一データベースから生成する場合は、<xref:System.Data.Common.DbCommandBuilder> オブジェクトを利用して自動的に `DataAdapter` の `DeleteCommand` オブジェクト、`InsertCommand` オブジェクト、および `UpdateCommand` オブジェクトを生成できます。  詳細については、「[CommandBuilder でのコマンドの生成](../../../../docs/framework/data/adonet/generating-commands-with-commandbuilders.md)」を参照してください。  
+  
+## UpdatedRowSource を使用した値の DataSet への割り当て  
+ <xref:System.Data.Common.DbCommand> オブジェクトの <xref:System.Data.Common.DbCommand.UpdatedRowSource%2A> プロパティを使用すると、`DataAdapter` の Update メソッドを呼び出した後、データ ソースから返された値を `DataTable` に割り当てる方法を制御できます。  `UpdatedRowSource` プロパティを <xref:System.Data.UpdateRowSource> 列挙型の値の 1 つに設定することで、`DataAdapter` コマンドが返した出力パラメーターを無視するか、`DataSet` 内の変更行に適用するかを制御できます。  最初に返された行 \(存在する場合\) を、`DataTable` 内の変更行に適用するかどうかを指定することもできます。  
+  
+ `UpdateRowSource` 列挙型のさまざまの値と、それらの値が `DataAdapter` で使用されるコマンドの動作にどのように影響するかを次の表で説明します。  
+  
+|UpdatedRowSource 列挙型|説明|  
+|--------------------------|--------|  
+|<xref:System.Data.UpdateRowSource>|出力パラメーターと返された結果セットの最初の行を `DataSet` 内の変更行に割り当てます。|  
+|<xref:System.Data.UpdateRowSource>|返された結果セットの最初の行のデータだけを `DataSet` 内の変更行に割り当てます。|  
+|<xref:System.Data.UpdateRowSource>|出力パラメーターまたは返された結果セットの行が無視されます。|  
+|<xref:System.Data.UpdateRowSource>|出力パラメーターだけを `DataSet` 内の変更行に割り当てます。|  
+  
+ `Update` メソッドは変更点を元のデータ ソースに反映させますが、`DataSet` に最後にデータを格納した後、他のクライアントがデータ ソースのデータを変更した可能性もあります。  `DataSet` を現在のデータで更新するには、`DataAdapter` および `Fill` メソッドを使用します。  新しい行がテーブルに追加され、更新された情報が既存の行に取り込まれます。  `Fill` メソッドは、`DataSet` の行と `SelectCommand` によって返された行の主キーの値を調べて、新しい行が追加されたか、または既存の行が更新されたかを判断します。  `Fill` メソッドは、`SelectCommand` によって返された結果の行に一致する主キーの値を持つ `DataSet` の行を見つけた場合、`SelectCommand` によって返された行の情報で既存の行を更新して、既存の行の <xref:System.Data.DataRow.RowState%2A> を `Unchanged` に設定します。  `SelectCommand` によって返された行の主キーの値が、`DataSet` のどの行の主キーの値にも一致しない場合、`Fill` メソッドは、`RowState` が `Unchanged` の新しい行を追加します。  
+  
+> [!NOTE]
+>  `SelectCommand` が OUTER JOIN の結果を返す場合、`DataAdapter` は、生成される `DataTable` に `PrimaryKey` 値を設定しません。  自分で `PrimaryKey` を定義して、重複行が正しく反映されるようにする必要があります。  詳細については、「[主キーの定義](../../../../docs/framework/data/adonet/dataset-datatable-dataview/defining-primary-keys.md)」を参照してください。  
+  
+ `Update` メソッド呼び出し時に発生する例外を処理するには、行更新エラーが発生したときに `RowUpdated` イベントを使用して応答するか \(「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照\)、または `Update` メソッド呼び出しの前に `DataAdapter.ContinueUpdateOnError` を `true` に設定し、更新が完了した時点で特定の行の `RowError` プロパティに格納されているエラー情報に応答します \(「[行エラー情報](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-error-information.md)」を参照\)。  
+  
+ **注** `DataSet`、`DataTable`、または `DataRow` に対して `AcceptChanges` を呼び出すと、`DataRow` のすべての `Original` 値が `DataRow` の `Current` 値で上書きされます。  行を一意に識別するフィールド値が変更された場合は、`AcceptChanges` 呼び出しの後に `Original` 値がデータ ソースの値と一致しなくなります。  `AcceptChanges` は、`DataAdapter` の Update メソッドを呼び出す間に、各行について自動的に呼び出されます。  Update メソッドの呼び出し中に元の値を維持するには、まず `DataAdapter` の `AcceptChangesDuringUpdate` プロパティを false に設定するか、`RowUpdated` イベントのイベント ハンドラーを作成し、その <xref:System.Data.Common.RowUpdatedEventArgs.Status%2A> を <xref:System.Data.UpdateStatus> に設定します。  詳細については、「[DataSet の内容のマージ](../../../../docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md)」および「[DataAdapter のイベント処理](../../../../docs/framework/data/adonet/handling-dataadapter-events.md)」を参照してください。  
+  
+## 例  
+ `DataAdapter` の `UpdateCommand` を明示的に設定し、その `Update`  メソッドを呼び出すことによって、変更済みの行に対して更新を実行する方法を次の例に示します。  UPDATE ステートメントの WHERE 句に指定したパラメーターが `SourceColumn` の `Original` 値を使用するように設定されていることに注意してください。  `Current` 値が既に変更されている可能性、そしてデータ ソースの値と一致していない可能性があるため、この設定は重要です。  `Original` 値は、データ ソースから `DataTable` にデータを取得するために使用された値です。  
+  
+ [!code-csharp[DataWorks SqlClient.DataAdapterUpdate#1](../../../../samples/snippets/csharp/VS_Snippets_ADO.NET/DataWorks SqlClient.DataAdapterUpdate/CS/source.cs#1)]
+ [!code-vb[DataWorks SqlClient.DataAdapterUpdate#1](../../../../samples/snippets/visualbasic/VS_Snippets_ADO.NET/DataWorks SqlClient.DataAdapterUpdate/VB/source.vb#1)]  
+  
+## AutoIncrement 列  
+ データ ソースから取得したテーブルに自動インクリメント列がある場合、自動インクリメント値をストアド プロシージャの出力パラメーターとして取得してそれをテーブルの列に割り当てるか、ストアド プロシージャまたは SQL ステートメントによって返された結果セットの最初の行の自動インクリメント値を取得するか、または `DataAdapter` の `RowUpdated` イベントを使用して追加の SELECT コマンドを実行することによって、`DataSet` の列に値を格納できます。  使用例を含む詳細については、「[ID 値および Autonumber 値の取得](../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)」を参照してください。  
+  
+## 挿入、更新、削除の順序  
+ 通常の条件下では、`DataSet` を使用して行う変更の順序をデータ ソースに送信することが重要です。  たとえば、既存の行の主キーの値を更新し、その新しい主キーの値を外部キーとして新しい行を追加する場合、更新は挿入の前に処理する必要があります。  
+  
+ `DataTable` の `Select` メソッドを使用すると、特定の `RowState` を持つ行だけを参照する `DataRow` 配列を返すことができます。  その後で、返された `DataRow` 配列を `DataAdapter` の `Update` メソッドに渡して変更行を処理できます。  更新する行のサブセットを指定することで、挿入、更新、および削除の処理順序を制御できます。  
+  
+## 例  
+ たとえば次のコードでは、テーブルの削除行を最初に処理し、次に更新行、最後に挿入行を処理します。  
+  
+```vb  
+Dim table As DataTable = dataSet.Tables("Customers")  
+  
+' First process deletes.  
+dataSet.Update(table.Select(Nothing, Nothing, _  
+  DataViewRowState.Deleted))  
+  
+' Next process updates.  
+adapter.Update(table.Select(Nothing, Nothing, _  
+  DataViewRowState.ModifiedCurrent))  
+  
+' Finally, process inserts.  
+dataAdapater.Update(table.Select(Nothing, Nothing, _  
+  DataViewRowState.Added))  
+```  
+  
+```csharp  
+DataTable table = dataSet.Tables["Customers"];  
+  
+// First process deletes.  
+adapter.Update(table.Select(null, null, DataViewRowState.Deleted));  
+  
+// Next process updates.  
+adapter.Update(table.Select(null, null,   
+  DataViewRowState.ModifiedCurrent));  
+  
+// Finally, process inserts.  
+adapter.Update(table.Select(null, null, DataViewRowState.Added));  
+```  
+  
+## DataAdapter を使用したデータの取得と更新  
+ DataAdapter を使用すると、データを取得および更新できます。  
+  
+-   このサンプルでは、DataAdapter.AcceptChangesDuringFill を使用してデータベース内のデータを複製します。  このプロパティが false として設定されている場合、AcceptChanges はテーブルにデータを格納するときに呼び出されず、新しく追加された行が挿入された行として処理されます。  そのため、このサンプルでは、これらの行を使用して、データベースに新しい行を挿入します。  
+  
+-   このサンプルでは、DataAdapter.TableMappings を使用して、ソース テーブルと DataTable 間のマッピングを定義します。  
+  
+-   このサンプルでは、DataAdapter.FillLoadOption を使用して、アダプターが DbDataReader から DataTable にデータを設定する方法を決定します。  DataTable を作成するときに、プロパティを LoadOption.Upsert または LoadOption.PreserveChanges として設定した場合のみ、データベースのデータを現在のバージョンまたは元のバージョンに書き込むことができます。  
+  
+-   このサンプルでは、DbDataAdapter.UpdateBatchSize を使用してバッチ操作を実行することにより、テーブルを更新します。  
+  
+ サンプルをコンパイルして実行する前に、サンプル データベースを作成する必要があります。  
+  
+```  
+USE [master]  
+GO  
+  
+CREATE DATABASE [MySchool]   
+  
+GO  
+  
+USE [MySchool]  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE TABLE [dbo].[Course]([CourseID] [nvarchar](10) NOT NULL,  
+[Year] [smallint] NOT NULL,  
+[Title] [nvarchar](100) NOT NULL,  
+[Credits] [int] NOT NULL,  
+[DepartmentID] [int] NOT NULL,  
+ CONSTRAINT [PK_Course] PRIMARY KEY CLUSTERED   
+(  
+[CourseID] ASC,  
+[Year] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]  
+  
+GO  
+  
+SET ANSI_NULLS ON  
+GO  
+SET QUOTED_IDENTIFIER ON  
+GO  
+CREATE TABLE [dbo].[Department]([DepartmentID] [int] IDENTITY(1,1) NOT NULL,  
+[Name] [nvarchar](50) NOT NULL,  
+[Budget] [money] NOT NULL,  
+[StartDate] [datetime] NOT NULL,  
+[Administrator] [int] NULL,  
+ CONSTRAINT [PK_Department] PRIMARY KEY CLUSTERED   
+(  
+[DepartmentID] ASC  
+)WITH (PAD_INDEX = OFF, STATISTICS_NORECOMPUTE = OFF, IGNORE_DUP_KEY = OFF, ALLOW_ROW_LOCKS = ON, ALLOW_PAGE_LOCKS = ON) ON [PRIMARY]) ON [PRIMARY]  
+  
+GO  
+  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1045', 2012, N'Calculus', 4, 7)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C1061', 2012, N'Physics', 4, 1)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2021', 2012, N'Composition', 3, 2)  
+INSERT [dbo].[Course] ([CourseID], [Year], [Title], [Credits], [DepartmentID]) VALUES (N'C2042', 2012, N'Literature', 4, 2)  
+  
+SET IDENTITY_INSERT [dbo].[Department] ON   
+  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (1, N'Engineering', 350000.0000, CAST(0x0000999C00000000 AS DateTime), 2)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (2, N'English', 120000.0000, CAST(0x0000999C00000000 AS DateTime), 6)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (4, N'Economics', 200000.0000, CAST(0x0000999C00000000 AS DateTime), 4)  
+INSERT [dbo].[Department] ([DepartmentID], [Name], [Budget], [StartDate], [Administrator]) VALUES (7, N'Mathematics', 250024.0000, CAST(0x0000999C00000000 AS DateTime), 3)  
+SET IDENTITY_INSERT [dbo].[Department] OFF  
+  
+ALTER TABLE [dbo].[Course]  WITH CHECK ADD  CONSTRAINT [FK_Course_Department] FOREIGN KEY([DepartmentID])  
+REFERENCES [dbo].[Department] ([DepartmentID])  
+GO  
+ALTER TABLE [dbo].[Course] CHECK CONSTRAINT [FK_Course_Department]  
+GO  
+```  
+  
+ このコードのサンプルがある C\# および Visual Basic のプロジェクトは、「[コード レシピ:サンプルコードから学ぶ](http://code.msdn.microsoft.com/site/search?f%5B0%5D.Type=SearchText&f%5B0%5D.Value=How%20to%20use%20DataAdapter%20to%20retrieve%20and%20update%20data&f%5B1%5D)」でご確認いただけます。  
+  
+```  
+using System;  
+using System.Data;  
+using System.Data.Common;  
+using System.Data.SqlClient;  
+using System.Linq;  
+using CSDataAdapterOperations.Properties;  
+  
+namespace CSDataAdapterOperations.Properties {  
+   internal sealed partial class Settings : global::System.Configuration.ApplicationSettingsBase {  
+  
+      private static Settings defaultInstance = ((Settings)(global::System.Configuration.ApplicationSettingsBase.Synchronized(new Settings())));  
+  
+      public static Settings Default {  
+         get {  
+            return defaultInstance;  
+         }  
+      }  
+  
+      [global::System.Configuration.ApplicationScopedSettingAttribute()]  
+      [global::System.Configuration.DefaultSettingValueAttribute("Data Source=(local);Initial Catalog=MySchool;Integrated Security=True")]  
+      public string MySchoolConnectionString {  
+         get {  
+            return ((string)(this["MySchoolConnectionString"]));  
+         }  
+      }  
+   }  
+}  
+  
+class Program {  
+   static void Main(string[] args) {  
+      Settings settings = new Settings();  
+  
+      // Copy the data from the database.  Get the table Department and Course from the database.  
+      String selectString = @"SELECT [DepartmentID],[Name],[Budget],[StartDate],[Administrator]  
+                                     FROM [MySchool].[dbo].[Department];  
+  
+                                   SELECT [CourseID],@Year as [Year],Max([Title]) as [Title],  
+                                   Max([Credits]) as [Credits],Max([DepartmentID]) as [DepartmentID]  
+                                   FROM [MySchool].[dbo].[Course]  
+                                   Group by [CourseID]";  
+  
+      DataSet mySchool = new DataSet();  
+  
+      SqlCommand selectCommand = new SqlCommand(selectString);  
+      SqlParameter parameter = selectCommand.Parameters.Add("@Year", SqlDbType.SmallInt, 2);  
+      parameter.Value = new Random(DateTime.Now.Millisecond).Next(9999);  
+  
+      // Use DataTableMapping to map the source tables and the destination tables.  
+      DataTableMapping[] tableMappings = {new DataTableMapping("Table", "Department"), new DataTableMapping("Table1", "Course")};  
+      CopyData(mySchool, settings.MySchoolConnectionString, selectCommand, tableMappings);  
+  
+      Console.WriteLine("The following tables are from the database.");  
+      foreach (DataTable table in mySchool.Tables) {  
+         Console.WriteLine(table.TableName);  
+         ShowDataTable(table);  
+      }  
+  
+      // Roll back the changes  
+      DataTable department = mySchool.Tables["Department"];  
+      DataTable course = mySchool.Tables["Course"];  
+  
+      department.Rows[0]["Name"] = "New" + department.Rows[0][1];  
+      course.Rows[0]["Title"] = "New" + course.Rows[0]["Title"];  
+      course.Rows[0]["Credits"] = 10;  
+  
+      Console.WriteLine("After we changed the tables:");  
+      foreach (DataTable table in mySchool.Tables) {  
+         Console.WriteLine(table.TableName);  
+         ShowDataTable(table);  
+      }  
+  
+      department.RejectChanges();  
+      Console.WriteLine("After use the RejectChanges method in Department table to roll back the changes:");  
+      ShowDataTable(department);  
+  
+      DataColumn[] primaryColumns = { course.Columns["CourseID"] };  
+      DataColumn[] resetColumns = { course.Columns["Title"] };  
+      ResetCourse(course, settings.MySchoolConnectionString, primaryColumns, resetColumns);  
+      Console.WriteLine("After use the ResetCourse method in Course table to roll back the changes:");  
+      ShowDataTable(course);  
+  
+      // Batch update the table.  
+      String insertString = @"Insert into [MySchool].[dbo].[Course]([CourseID],[Year],[Title],   
+                                   [Credits],[DepartmentID])   
+             values (@CourseID,@Year,@Title,@Credits,@DepartmentID)";  
+      SqlCommand insertCommand = new SqlCommand(insertString);  
+      insertCommand.Parameters.Add("@CourseID", SqlDbType.NVarChar, 10, "CourseID");  
+      insertCommand.Parameters.Add("@Year", SqlDbType.SmallInt, 2, "Year");  
+      insertCommand.Parameters.Add("@Title", SqlDbType.NVarChar, 100, "Title");  
+      insertCommand.Parameters.Add("@Credits", SqlDbType.Int, 4, "Credits");  
+      insertCommand.Parameters.Add("@DepartmentID", SqlDbType.Int, 4, "DepartmentID");  
+  
+      const Int32 batchSize = 10;  
+      BatchInsertUpdate(course, settings.MySchoolConnectionString, insertCommand, batchSize);  
+   }  
+  
+   private static void CopyData(DataSet dataSet, String connectionString, SqlCommand selectCommand, DataTableMapping[] tableMappings) {  
+      using (SqlConnection connection = new SqlConnection(connectionString)) {  
+         selectCommand.Connection = connection;  
+  
+         connection.Open();  
+  
+         using (SqlDataAdapter adapter = new SqlDataAdapter(selectCommand)) {adapter.TableMappings.AddRange(tableMappings);  
+            // If set the AcceptChangesDuringFill as the false, AcceptChanges will not be called on a   
+            // DataRow after it is added to the DataTable during any of the Fill operations.  
+            adapter.AcceptChangesDuringFill = false;  
+  
+            adapter.Fill(dataSet);  
+         }  
+      }  
+   }  
+  
+   // Roll back only one column or several columns data of the Course table by call ResetDataTable method.  
+   private static void ResetCourse(DataTable table, String connectionString,  
+       DataColumn[] primaryColumns, DataColumn[] resetColumns) {  
+      table.PrimaryKey = primaryColumns;  
+  
+      // Build the query string  
+      String primaryCols = String.Join(",", primaryColumns.Select(col => col.ColumnName));  
+      String resetCols = String.Join(",", resetColumns.Select(col => "Max(" + col.ColumnName + ") as " + col.ColumnName));  
+  
+      String selectString = String.Format("Select {0},{1} from Course Group by {0}", primaryCols, resetCols);  
+  
+      SqlCommand selectCommand = new SqlCommand(selectString);  
+  
+      ResetDataTable(table, connectionString, selectCommand);  
+   }  
+  
+   // RejectChanges will roll back all changes made to the table since it was loaded, or the last time AcceptChanges   
+   // was called. When you copy from the database, you can lose all the data after calling RejectChanges  
+   // The ResetDataTable method rolls back one or more columns of data.  
+   private static void ResetDataTable(DataTable table, String connectionString,  
+       SqlCommand selectCommand) {  
+      using (SqlConnection connection = new SqlConnection(connectionString)) {  
+         selectCommand.Connection = connection;  
+  
+         connection.Open();  
+  
+         using (SqlDataAdapter adapter = new SqlDataAdapter(selectCommand)) {  
+            // The incoming values for this row will be written to the current version of each   
+            // column. The original version of each column's data will not be changed.  
+            adapter.FillLoadOption = LoadOption.Upsert;  
+  
+            adapter.Fill(table);  
+         }  
+      }  
+   }  
+  
+   private static void BatchInsertUpdate(DataTable table, String connectionString,  
+       SqlCommand insertCommand, Int32 batchSize) {  
+      using (SqlConnection connection = new SqlConnection(connectionString)) {  
+         insertCommand.Connection = connection;  
+         // When setting UpdateBatchSize to a value other than 1, all the commands   
+         // associated with the SqlDataAdapter have to have their UpdatedRowSource   
+         // property set to None or OutputParameters. An exception is thrown otherwise.  
+         insertCommand.UpdatedRowSource = UpdateRowSource.None;  
+  
+         connection.Open();  
+  
+         using (SqlDataAdapter adapter = new SqlDataAdapter()) {  
+            adapter.InsertCommand = insertCommand;  
+            // Gets or sets the number of rows that are processed in each round-trip to the server.  
+            // Setting it to 1 disables batch updates, as rows are sent one at a time.  
+            adapter.UpdateBatchSize = batchSize;  
+  
+            adapter.Update(table);  
+  
+            Console.WriteLine("Successfully to update the table.");  
+         }  
+      }  
+   }  
+  
+   private static void ShowDataTable(DataTable table) {  
+      foreach (DataColumn col in table.Columns) {  
+         Console.Write("{0,-14}", col.ColumnName);  
+      }  
+      Console.WriteLine("{0,-14}", "RowState");  
+  
+      foreach (DataRow row in table.Rows) {  
+         foreach (DataColumn col in table.Columns) {  
+            if (col.DataType.Equals(typeof(DateTime)))  
+               Console.Write("{0,-14:d}", row[col]);  
+            else if (col.DataType.Equals(typeof(Decimal)))  
+               Console.Write("{0,-14:C}", row[col]);  
+            else  
+               Console.Write("{0,-14}", row[col]);  
+         }  
+         Console.WriteLine("{0,-14}", row.RowState);  
+      }  
+   }  
+}  
+```  
+  
+## 参照  
+ [DataAdapter と DataReader](../../../../docs/framework/data/adonet/dataadapters-and-datareaders.md)   
+ [行の状態とバージョン](../../../../docs/framework/data/adonet/dataset-datatable-dataview/row-states-and-row-versions.md)   
+ [AcceptChanges と RejectChanges](../../../../docs/framework/data/adonet/dataset-datatable-dataview/acceptchanges-and-rejectchanges.md)   
+ [DataSet の内容のマージ](../../../../docs/framework/data/adonet/dataset-datatable-dataview/merging-dataset-contents.md)   
+ [ID 値および Autonumber 値の取得](../../../../docs/framework/data/adonet/retrieving-identity-or-autonumber-values.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/using-commands-to-modify-data.md b/docs/framework/data/adonet/using-commands-to-modify-data.md
new file mode 100644
index 00000000000..8a87da726e3
--- /dev/null
+++ b/docs/framework/data/adonet/using-commands-to-modify-data.md
@@ -0,0 +1,36 @@
+---
+title: "コマンドを使用したデータ変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4160389-b9ff-4b74-b655-437c76dcd586
+caps.latest.revision: 4
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 4
+---
+# コマンドを使用したデータ変更
+.NET Framework データ プロバイダーを使用すると、ストアド プロシージャまたはデータ定義言語のステートメント \(たとえば、CREATE TABLE、ALTER COLUMN など\) を実行して、データベースやカタログに対するスキーマ操作を実行できます。  これらのコマンドはクエリとは異なり、行を返さないため、**Command** オブジェクトでは **ExecuteNonQuery** が提供されています。  
+  
+ **ExecuteNonQuery** メソッドを使用すると、スキーマを変更できるだけでなく、データを変更するが行を返さない INSERT、UPDATE、DELETE などの SQL ステートメントも処理できます。  
+  
+ **ExecuteNonQuery** メソッドでは行は返されませんが、**Command** オブジェクトの **Parameters** コレクションを通じて入力パラメーター、出力パラメーター、および戻り値を受け渡しできます。  
+  
+## このセクションの内容  
+ [データ ソースのデータの更新](../../../../docs/framework/data/adonet/updating-data-in-a-data-source.md)  
+ データベース内のデータを変更するコマンドまたはストアド プロシージャを実行する方法について説明します。  
+  
+ [カタログ操作の実行](../../../../docs/framework/data/adonet/performing-catalog-operations.md)  
+ データベース スキーマを変更するコマンドを実行する方法について説明します。  
+  
+## 参照  
+ [ADO.NET でのデータの取得および変更](../../../../docs/framework/data/adonet/retrieving-and-modifying-data.md)   
+ [コマンドとパラメーター](../../../../docs/framework/data/adonet/commands-and-parameters.md)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/adonet/whats-new.md b/docs/framework/data/adonet/whats-new.md
new file mode 100644
index 00000000000..d47606af5a3
--- /dev/null
+++ b/docs/framework/data/adonet/whats-new.md
@@ -0,0 +1,65 @@
+---
+title: "ADO.NET の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-ado"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bb65d38-cce2-46f5-b979-e5c505e95e10
+caps.latest.revision: 25
+author: "JennieHubbard"
+ms.author: "jhubbard"
+manager: "jhubbard"
+caps.handback.revision: 25
+---
+# ADO.NET の新機能
+[!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] の [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では、次の機能が追加されています。  
+  
+## SqlClient Data Provider  
+ [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Data Provider for [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] では、次の機能が追加されています。  
+  
+-   ConnectRetryCount と ConnectRetryInterval の接続文字列キーワード \(<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>\) を使用すると、アイドル状態の接続の復元機能を制御できます。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] からアプリケーションへのストリーミング サポートで、サーバー上のデータが構造化されていないシナリオをサポートします。  詳細については、「[SqlClient ストリーミング サポート](../../../../docs/framework/data/adonet/sqlclient-streaming-support.md)」を参照してください。  
+  
+-   非同期のプログラミングにサポートが追加されています。  詳細については、「[非同期プログラミング](../../../../docs/framework/data/adonet/asynchronous-programming.md)」を参照してください。  
+  
+-   接続エラーは、拡張イベント ログに記録されるようになりました。  詳細については、「[ADO.NET でのデータ トレース](../../../../docs/framework/data/adonet/data-tracing.md)」を参照してください。  
+  
+-   SqlClient は、[!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] の高可用性、障害復旧機能である AlwaysOn をサポートするようになりました。  詳細については、「[高可用性障害復旧のための SqlClient サポート](../../../../docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md)」を参照してください。  
+  
+-   [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] 認証を使用している場合、パスワードは <xref:System.Security.SecureString> として渡すことができます。  詳細については、「<xref:System.Data.SqlClient.SqlCredential>」を参照してください。  
+  
+-   `TrustServerCertificate` が false であり、`Encrypt` が true の場合は、接続文字列に指定されているサーバー名 \(または IP アドレス\) に [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] SSL 証明書が正確に一致する必要があります。  それ以外の場合、接続試行は失敗します。  詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」の `Encrypt` 接続オプションの説明を参照してください。  
+  
+     この変更によって既存のアプリケーションが接続しなくなる場合、次のいずれかを使用してアプリケーションを修正できます。  
+  
+    -   共通名 \(CN\) またはサブジェクト代替名 \(SAN\) フィールドに短い名前を指定する証明書を発行します。  このソリューションは、データベース ミラーリングをする場合に有効です。  
+  
+    -   短い名前を完全修飾ドメイン名にマップする別名を追加します。  
+  
+    -   接続文字列では完全修飾ドメイン名を使用します。  
+  
+-   SqlClient は拡張保護をサポートしています。  拡張保護の詳細については、「[拡張保護を使用したデータベース エンジンへの接続](http://go.microsoft.com/fwlink/?LinkId=219978)」を参照してください。  
+  
+-   SqlClient は LocalDB データベースへの接続をサポートします。  詳細については、「[SqlClient による LocalDB のサポート](../../../../docs/framework/data/adonet/sql/sqlclient-support-for-localdb.md)」を参照してください。  
+  
+-   `Type System Version=SQL Server 2012;` は、`Type System Version` 接続プロパティに渡す新しい値です。  `Type System Version=Latest;` 値は廃止されており、`Type System Version=SQL Server 2008;` と同等になっています。  詳細については、「<xref:System.Data.SqlClient.SqlConnection.ConnectionString%2A>」を参照してください。  
+  
+-   SqlClient は、スパース列に追加のサポートを提供します。このサポートは SQL Server 2008 で追加された機能です。  アプリケーションがスパース列を使用するテーブルのデータに既にアクセスしていると、パフォーマンスが向上します。  <xref:System.Data.SqlClient.SqlDataReader.GetSchemaTable%2A> の IsColumnSet 列は、列が列セットのメンバーであるスパース列であるかどうかを示します。  <xref:System.Data.SqlClient.SqlConnection.GetSchema%2A> は、列がスパース列であるかどうかを示します \(詳細については、[SQL Server スキーマ コレクション](../../../../docs/framework/data/adonet/sql-server-schema-collections.md) を参照してください\)。  スパース列の詳細については、「[スパース列の使用](http://go.microsoft.com/fwlink/?LinkId=224244)」を参照してください。  
+  
+-   空間データ型を含むアセンブリ Microsoft.SqlServer.Types.dll は、Version 10.0 から Version 11.0 にアップグレードされました。  このアセンブリを参照するホスト アプリケーションでは、エラーが発生する可能性があります。  詳細については、「[データベース エンジン機能の重大な変更](http://go.microsoft.com/fwlink/?LinkId=224367)」を参照してください。  
+  
+## ADO.NET Entity Framework  
+ [!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] は、Entity Framework 5.0 を操作するときに、新しいシナリオを有効にする API を追加します。  Entity Framework 5.0 に追加された機能および機能強化に関する詳細については、「[新機能](http://go.microsoft.com/fwlink/?LinkID=251106)」と「[Entity Framework リリースおよびバージョン管理](http://go.microsoft.com/fwlink/?LinkId=234899)」を参照してください。  
+  
+## 参照  
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)   
+ [ADO.NET の概要](../../../../docs/framework/data/adonet/ado-net-overview.md)   
+ [SQL Server と ADO.NET](../../../../docs/framework/data/adonet/sql/index.md)   
+ [What's New in WCF Data Services](http://msdn.microsoft.com/ja-jp/cf22cad5-b8d9-472b-8d7c-b863b64eaae8)   
+ [ADO.NET Managed Providers and DataSet Developer Center \(ADO.NET マネージ プロバイダーと DataSet デベロッパー センター\)](http://go.microsoft.com/fwlink/?LinkId=217917)
\ No newline at end of file
diff --git a/docs/framework/data/index.md b/docs/framework/data/index.md
new file mode 100644
index 00000000000..6b1d5b85708
--- /dev/null
+++ b/docs/framework/data/index.md
@@ -0,0 +1,53 @@
+---
+title: ".NET Framework におけるデータとモデリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, データ アクセス"
+  - "データ [.NET Framework], アクセス"
+  - "データ アクセス [.NET Framework], .NET Framework のデータ アクセスの概要"
+ms.assetid: 8c37635d-e2c1-4b64-a258-61d9e87405e6
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# .NET Framework におけるデータとモデリング
+ここでは、ADO.NET、統合言語クエリ \(LINQ: Language\-Integrated Query\)、WCF Data Services、および XML を使用してデータにアクセスする方法について説明します。  
+  
+## このセクションの内容  
+ [ADO.NET](../../../docs/framework/data/adonet/index.md)  
+ ADO.NET のアーキテクチャについて説明します。また、ADO.NET のクラスを使用してアプリケーション データを管理し、データ ソース \(Microsoft SQL Server、OLE DB データ ソース、および XML を含む\) とやり取りする方法についても説明します。  
+  
+ [LINQ Portal](http://msdn.microsoft.com/ja-jp/6eb15c76-4ee6-4146-981e-b3429a945e6f)  
+ 統合言語クエリ \(LINQ\) に関連するドキュメントへのリンクを示します。  
+  
+ [トランザクション処理 ](../../../docs/framework/data/transactions/index.md)  
+ .NET Framework におけるトランザクションのサポートについて説明します。  
+  
+ [WCF Data Services 4.5](../../../docs/framework/data/wcf/index.md)  
+ WCF Data Services を使用して Web やイントラネットにデータ サービスを配置する方法について説明します。  
+  
+ [XML ドキュメントと XML データ](../../../docs/standard/data/xml/index.md)  
+ .NET Framework で XML ドキュメントおよびデータを処理するための、統合された包括的な一連のクラスについて概説します。  
+  
+ [XML 標準のリファレンス](http://msdn.microsoft.com/ja-jp/79c78508-c9d0-423a-a00f-672e855de401)  
+ Microsoft がサポートする XML 標準に関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Microsoft SQL Server Modeling Technologies](http://go.microsoft.com/fwlink/?LinkId=193039)  
+ データに基づくアプリケーションをカスタム方式で迅速に設計および開発することを可能にする一連のテクノロジについて説明します。  
+  
+ [開発ガイド](../../../docs/framework/development-guide.md)  
+ アプリケーションの作成、構成、デバッグ、セキュリティ、配置、および動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理に関する情報を含む、アプリケーション開発用の主要な技術領域とタスクのすべてについての手引書です。  
+  
+ [セキュリティ](../../../docs/standard/security/index.md)  
+ 共通言語ランタイムおよび .NET Framework において安全なアプリケーションの開発を促進するクラスおよびサービスに関する情報へのリンクを示します。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/TOC.md b/docs/framework/data/transactions/TOC.md
new file mode 100644
index 00000000000..d74b4673f7e
--- /dev/null
+++ b/docs/framework/data/transactions/TOC.md
@@ -0,0 +1,17 @@
+# [リソースへのアクセスでのセキュリティ信頼レベル ](security-trust-levels-in-accessing-resources.md)
+# [トランザクション処理 ](index.md)
+# [System.Transactions で提供される機能 ](features-provided-by-system-transactions.md)
+# [リソース マネージャーの実装 ](implementing-a-resource-manager.md)
+# [Enterprise Services と COM+ トランザクションの相互運用性 ](interoperability-with-enterprise-services-and-com-transactions.md)
+# [DependentTransaction の同時実行の管理 ](managing-concurrency-with-dependenttransaction.md)
+# [トランザクション アプリケーションの作成 ](writing-a-transactional-application.md)
+# [参加要素としてのリソースのトランザクションへの参加 ](enlisting-resources-as-participants-in-a-transaction.md)
+# [回復の実行 ](performing-recovery.md)
+# [単一フェーズおよび複数フェーズでのトランザクションのコミット ](committing-a-transaction-in-single-phase-and-multi-phase.md)
+# [単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](optimization-spc-and-promotable-spn.md)
+# [トランザクション スコープを使用した暗黙的なトランザクションの実装 ](implementing-an-implicit-transaction-using-transaction-scope.md)
+# [トランザクションの基盤 ](transaction-fundamentals.md)
+# [CommittableTransaction を使用した明示的なトランザクションの実装 ](implementing-an-explicit-transaction-using-committabletransaction.md)
+# [診断トレース ](diagnostic-traces.md)
+# [トランザクション管理エスカレーション ](transaction-management-escalation.md)
+# [ASP.NET での System.Transactions の使用](using-system-transactions-in-aspnet.md)
diff --git a/docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md b/docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md
new file mode 100644
index 00000000000..94790ec855d
--- /dev/null
+++ b/docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md
@@ -0,0 +1,117 @@
+---
+title: "単一フェーズおよび複数フェーズでのトランザクションのコミット  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 694ea153-e4db-41ae-96ac-9ac66dcb69a9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 単一フェーズおよび複数フェーズでのトランザクションのコミット 
+トランザクションで使用される各リソースは、リソース マネージャー \(RM\) によって管理され、その動作はトランザクション マネージャー \(TM\) によって調整されます。「[参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)」では、単一 \(または複数\) のリソースがトランザクションに参加する方法について説明しています。ここでは、参加リソース間でトランザクションのコミットメントを調整する方法について説明します。  
+  
+ トランザクションの最後に、アプリケーションはトランザクションのコミットまたはロールバックを要求します。トランザクション マネージャーは、一部のリソース マネージャーがトランザクションのコミットを選択し、他のリソース マネージャーがトランザクションのロールバックを選択するというようなリスクを回避する必要があります。  
+  
+ トランザクションに複数のリソースが含まれる場合は、2 フェーズ コミット \(2PC\) を実行する必要があります。2 フェーズ コミット プロトコル \(準備フェーズとコミット フェーズ\) により、すべてのリソースに対する変更がトランザクションの終了時に完全にコミットされるか、または完全にロールバックされることが保証されます。その後、すべての参加要素に最終結果が通知されます。2 フェーズ コミット プロトコルの詳細については、Jim Gray 著『Transaction Processing : Concepts and Techniques \(Morgan Kaufmann Series in Data Management Systems\) ISBN:1558601902』を参照してください。  
+  
+ 単一フェーズ コミット プロトコルに参加することで、トランザクションのパフォーマンスを最適化することもできます。詳細については、「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」を参照してください。  
+  
+ トランザクション結果の通知を受信するだけで、コミットまたはロールバックの選択には参加しない場合は、<xref:System.Transactions.Transaction.TransactionCompleted> イベントに登録する必要があります。  
+  
+## 2 フェーズ コミット \(2PC\)  
+ 最初のトランザクション フェーズで、トランザクション マネージャーは、トランザクションをコミットするかロールバックするかを決定するため、各リソースに照会します。2 番目のトランザクション フェーズでは、トランザクション マネージャーは照会結果を各リソースに通知し、必要なクリーンアップを実行できるようにします。  
+  
+ この種のトランザクションに参加するために、リソース マネージャーは <xref:System.Transactions.IEnlistmentNotification> インターフェイスを実装する必要があります。このインターフェイスは、2PC 中に通知として TM が呼び出すメソッドを提供します。このような実装の例を次に示します。  
+  
+ [!code-csharp[Tx_Enlist#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/tx_enlist/cs/enlist.cs#2)]
+ [!code-vb[Tx_Enlist#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/tx_enlist/vb/enlist.vb#2)]  
+  
+### 準備フェーズ \(フェーズ 1\)  
+ アプリケーションから <xref:System.Transactions.CommittableTransaction.Commit%2A> 要求を受信すると、トランザクション マネージャーは、各リソースのトランザクションに対する選択を取得するため、各参加リソースに対して <xref:System.Transactions.IEnlistmentNotification.Prepare%2A> メソッドを呼び出し、参加しているすべての参加要素の準備フェーズを開始します。  
+  
+ <xref:System.Transactions.IEnlistmentNotification> インターフェイスを実装するリソース マネージャーは、次の簡単な例に示すように、最初に <xref:System.Transactions.IEnlistmentNotification.Prepare%28System.Transactions.PreparingEnlistment%29> メソッドを実装する必要があります。  
+  
+```  
+public void Prepare(PreparingEnlistment preparingEnlistment)  
+{  
+     Console.WriteLine("Prepare notification received");  
+     //Perform work  
+  
+     Console.Write("reply with prepared? [Y|N] ");  
+     c = Console.ReadKey();  
+     Console.WriteLine();  
+  
+     //If work finished correctly, reply with prepared  
+     if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))  
+     {  
+          preparingEnlistment.Prepared();  
+          break;  
+     }  
+  
+     // otherwise, do a ForceRollback  
+     else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))  
+     {  
+          preparingEnlistment.ForceRollback();  
+          break;  
+     }  
+}  
+  
+```  
+  
+ 永続的リソース マネージャーがこの呼び出しを受信すると、トランザクションの回復情報 \(<xref:System.Transactions.PreparingEnlistment.RecoveryInformation%2A> プロパティの取得により利用可\) と、コミット時にトランザクションを完了させるのに必要な情報をすべてログに記録する必要があります。RM はワーカー スレッドでこれを実行できるため、<xref:System.Transactions.IEnlistmentNotification.Prepare%2A> メソッド内で実行する必要はありません。  
+  
+ この準備操作が完了したら、RM は <xref:System.Transactions.PreparingEnlistment.Prepared%2A> メソッドまたは <xref:System.Transactions.PreparingEnlistment.ForceRollback%2A> メソッドを呼び出して、コミットまたはロールバックを選択する必要があります。<xref:System.Transactions.PreparingEnlistment> クラスは、<xref:System.Transactions.Enlistment> クラスから <xref:System.Transactions.Enlistment.Done%2A> メソッドを継承することに注意してください。準備フェーズ中に <xref:System.Transactions.PreparingEnlistment> コールバックでこのメソッドを呼び出すと、読み取り専用の参加 \(トランザクション保護されたデータを読み取れるが更新できないリソース マネージャー\) であることが TM に通知され、RM はフェーズ 2 でのトランザクションの結果として、トランザクション マネージャーからの通知を受信しなくなります。  
+  
+ すべてのリソース マネージャーが <xref:System.Transactions.PreparingEnlistment.Prepared%2A> を選択すると、トランザクションのコミットメントが成功したことがアプリケーションに通知されます。  
+  
+### コミット フェーズ \(フェーズ 2\)  
+ トランザクションの 2 番目のフェーズで、トランザクション マネージャーがすべてのリソース マネージャーから準備の成功を受信すると \(すべてのリソース マネージャーがフェーズ 1 の終わりで <xref:System.Transactions.PreparingEnlistment.Prepared%2A> を呼び出した場合\)、各リソース マネージャーに対して <xref:System.Transactions.IEnlistmentNotification.Commit%2A> メソッドを呼び出します。これにより、リソース マネージャーは、変更を永続的なものとして、コミットを完了できます。  
+  
+ いずれかのリソース マネージャーがフェーズ 1 での準備の失敗を報告すると、トランザクション マネージャーは、各リソース マネージャーに対して <xref:System.Transactions.IEnlistmentNotification.Rollback%2A> メソッドを呼び出し、アプリケーションにコミットの失敗を通知します。  
+  
+ したがって、リソース マネージャーは次のメソッドを実装する必要があります。  
+  
+```  
+public void Commit (Enlistment enlistment)  
+{  
+     // Do any work necessary when commit notification is received  
+  
+     // Declare done on the enlistment  
+     enlistment.Done();  
+}  
+  
+public void Rollback (Enlistment enlistment)  
+{  
+     // Do any work necessary when rollback notification is received  
+  
+     // Declare done on the enlistment    
+     enlistment.Done();    
+}  
+```  
+  
+ RM は、通知の種類に基づいてトランザクションを終了するために必要な作業を実行し、<xref:System.Transactions.Enlistment> パラメーターで <xref:System.Transactions.Enlistment.Done%2A> メソッドを呼び出すことにより、TM に作業の完了を通知する必要があります。これはワーカー スレッドで実行できます。フェーズ 2 の通知は、フェーズ 1 で <xref:System.Transactions.PreparingEnlistment.Prepared%2A> メソッドを呼び出した同じスレッドで、インラインで発生する可能性があることに注意してください。このため、フェーズ 2 の通知を受け取る前に既に完了したと考えられる作業 \(ロックの解除など\) は、<xref:System.Transactions.PreparingEnlistment.Prepared%2A> 呼び出しの後には実行できません。  
+  
+### InDoubt の実装  
+ 最後に、揮発性リソース マネージャーに <xref:System.Transactions.IEnlistmentNotification.InDoubt%2A> メソッドを実装する必要があります。このメソッドは、トランザクション マネージャーが 1 つ以上の参加要素と接続できなくなり、そのステータスが不明になった場合に呼び出されます。この場合は、トランザクションのいずれかの参加要素が矛盾した状態のままになっていないかどうかを後で調べることができるよう、この事実を記録しておく必要があります。  
+  
+```  
+public void InDoubt (Enlistment enlistment)  
+{  
+     // log this  
+     enlistment.Done();  
+}  
+```  
+  
+## 単一フェーズ コミットの最適化  
+ 単一フェーズ コミット プロトコルは、すべての更新が明示的な調整なしに行われるため、実行時に、より効率的です。このプロトコルの詳細については、「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」を参照してください。  
+  
+## 参照  
+ [単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)   
+ [参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/diagnostic-traces.md b/docs/framework/data/transactions/diagnostic-traces.md
new file mode 100644
index 00000000000..102ef1e6cfc
--- /dev/null
+++ b/docs/framework/data/transactions/diagnostic-traces.md
@@ -0,0 +1,143 @@
+---
+title: "診断トレース  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28e77a63-d20d-4b6a-9caf-ddad86550427
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 診断トレース 
+トレースとは、アプリケーションの実行中に生成される特定のメッセージの発行です。トレースを使用するときには、送信されたメッセージを収集して記録するための機構が必要です。トレース メッセージは "リスナー" によって受け取られます。リスナーの目的は、トレース メッセージの収集、格納、およびルーティングを行うことです。リスナーにより、トレース出力が適切な場所 \(ログ、ウィンドウ、またはテキスト ファイル\) に送られます。  
+  
+ トレースを有効にすると、こうしたリスナーの 1 つである <xref:System.Diagnostics.DefaultTraceListener> が自動的に作成および初期化されます。トレース出力を別のソースに送るには、別のトレース リスナーを作成して初期化する必要があります。作成するリスナーには、個別の要求が反映されている必要があります。たとえば、すべてのトレース出力のテキスト レコードが必要である場合は、有効になったときにすべての出力を新しいテキスト ファイルに書き込むリスナーを作成します。また、アプリケーションの実行時に出力を表示するだけでよい場合は、すべての出力をコンソール ウィンドウに送るリスナーを作成します。<xref:System.Diagnostics.EventLogTraceListener> はイベント ログにトレース出力を転送し、<xref:System.Diagnostics.TextWriterTraceListener> はストリームにトレース出力を書き込みます。  
+  
+## トレースの有効化  
+ トランザクション処理中にトレースを有効にするには、アプリケーションの構成ファイルを編集する必要があります。次に例を示します。  
+  
+```  
+<configuration>  
+<system.diagnostics>  
+     <sources>  
+          <source name="System.Transactions" switchValue="Warning">  
+               <listeners>  
+                    <add name="tx"   
+                     type="System.Diagnostics.XmlWriterTraceListener"   
+                     initializeData= "tx.log" />  
+               </listeners>  
+          </source>  
+     </sources>  
+</system.diagnostics>  
+</configuration>  
+  
+```  
+  
+ <xref:System.Transactions> トレースは、"System.Transactions" という名前のソースに書き込まれます。`add` を使用して、使用するトレース リスナーの名前と種類を指定できます。この例の構成では、リスナーに "tx" という名前を付け、使用する種類として標準の .NET Framework トレース リスナー \(<xref:System.Diagnostics.XmlWriterTraceListener>\) を追加しています。`initializeData` を使用して、リスナーのログ ファイルの名前を設定します。さらに、単純なファイル名と完全修飾パスを置き換えることができます。  
+  
+ 各トレース メッセージの種類は、その重大度を示すレベルに割り当てられます。アプリケーション ドメインのトレース レベルがイベント タイプのレベル以下である場合、そのメッセージが生成されます。トレース レベルは、構成ファイルの `switchValue` 設定で制御します。次の表に、診断トレース メッセージに関連するレベルの定義を示します。  
+  
+|トレース レベル|説明|  
+|--------------|--------|  
+|Critical \(重大\)|次のような重大な障害が発生しました。<br /><br /> -   ユーザー機能が即座に失われる可能性のあるエラー。<br />-   機能が失われるのを防ぐために管理者が対処する必要のあるイベント。<br />-   コードのハング。<br />-   このトレース レベルでは、他の重大なトレースを解釈するための十分なコンテキストも提供できます。これは、重大なエラーにつながる操作シーケンスの特定に役立ちます。|  
+|Error \(エラー\)|ユーザー機能の損失につながるエラー \(無効な設定、ネットワークの動作など\) が発生しました。|  
+|Warning \(警告\)|後続の処理でエラーまたは重大なエラーが起こる可能性のある状態が存在します \(割り当ての失敗、制限への接近など\)。ユーザー コードからのエラーの通常処理 \(トランザクションの中止、タイムアウト、認証の失敗など\) が警告を生成する場合もあります。|  
+|Information \(情報\)|システム ステータスの監視と診断、パフォーマンスの計測、またはプロファイリングに有用なメッセージが生成されます。これには、トランザクションの作成またはコミット、重要な境界の超過、重要なリソースの割り当てなど、トランザクションと参加の有効期間イベントが含まれる場合があります。このような情報は、後で開発者が容量設計やパフォーマンス管理に利用できます。|  
+  
+## トレース コード  
+ 次の表は、<xref:System.Transactions> インフラストラクチャで生成されるトレース コードの一覧です。この表には、トレース コード識別子、トレースの <xref:System.Diagnostics.EventTypeFilter.EventType%2A> 列挙レベル、およびトレースの **TraceRecord** に含まれる追加データが示されています。さらに、そのトレースに対応するトレース レベルも  **TraceRecord** に保存されます。  
+  
+|TraceCode|EventType|TraceRecord の追加データ|  
+|---------------|---------------|------------------------|  
+|TransactionCreated|情報|TransactionTraceId|  
+|TransactionPromoted|情報|Local TransactionTraceId、Distributed TransactionTraceId|  
+|EnlistmentCreated|情報|TransactionTraceId、EnlistmentTraceId、EnlistmentType \(durable\/volatile\)、EnlistmentOptions|  
+|EnlistmentCallbackNegative|警告|TransactionTraceId、EnlistmentTraceId、<br /><br /> Callback \(forcerollback\/aborted\/indoubt\)|  
+|TransactionRollbackCalled|警告|TransactionTraceId|  
+|TransactionAborted|警告|TransactionTraceId|  
+|TransactionInDoubt|警告|TransactionTraceId|  
+|TransactionScopeCreated|情報|TransactionScopeResult \(次のようになります\)<br /><br /> -   新しいトランザクション。<br />-   渡されたトランザクション。<br />-   渡された依存トランザクション。<br />-   現在のトランザクションを使用。<br />-   トランザクションなし。<br /><br /> 新しい現在の TransactionTraceId|  
+|TransactionScopeDisposed|情報|スコープの "想定される" 現在のトランザクションの TransactionTraceId。|  
+|TransactionScopeIncomplete|警告|スコープの "想定される" 現在のトランザクションの TransactionTraceId。|  
+|TransactionScopeNestedIncorrectly|警告|スコープの "想定される" 現在のトランザクションの TransactionTraceId。|  
+|TransactionScopeCurrentTransactionChanged|警告|古い \(現在の\) TransactionTraceId、他の TransactionTraceId|  
+|TransactionScopeTimeout|警告|スコープの "想定される" 現在のトランザクションの TransactionTraceId。|  
+|DependentCloneCreated|情報|TransactionTraceId、作成される依存トランザクションの種類 \(RollbackIfNotComplete\/BlockCommitUntilComplete\)|  
+|DependentCloneComplete|情報|TransactionTraceId|  
+|RecoveryComplete|情報|リソース マネージャー GUID \(ベースから\)|  
+|Reenlist|情報|リソース マネージャー GUID \(ベースから\)|  
+|TransactionSerialized|情報|TransactionTraceId|  
+|TransactionException|エラー|例外メッセージ|  
+|InvalidOperationException|エラー|例外メッセージ|  
+|InternalError|重大|例外メッセージ|  
+|TransferEvent||トランザクションが逆シリアル化されるか、または <xref:System.Transactions> トランザクションから分散トランザクションに昇格される場合、ExecutionContext の現在の ActivityID および分散トランザクション ID が書き込まれます。<br /><br /> DTC がマネージ コードにコールバックする場合、コールバックの間、分散トランザクション ID が ExecutionContext の ActivityID として設定されます。|  
+|ConfiguredDefaultTimeoutAdjusted|警告|追加データなし|  
+|TransactionTimeout|警告|タイムアウトするトランザクションの TransactionTraceId|  
+  
+ 上の各追加データ項目に対する XML スキーマの形式は次のとおりです。  
+  
+### TransactionTraceIdentifier  
+ `<TransactionTraceIdentifier>`  
+  
+ `<TransactionIdentifier >`  
+  
+ `string representation of transaction id`  
+  
+ `</TransactionIdentifier>`  
+  
+ `< CloneIdentifier >`  
+  
+ `the clone id number`  
+  
+ `</CloneIdentifier>`  
+  
+ `</TransactionTraceIdentifier>`  
+  
+### EnlistmentTraceIdentifier  
+ `<EnlistmentTraceIdentifier>`  
+  
+ `<ResourceManagerId>`  
+  
+ `string form of guid`  
+  
+ `</ResourceManagerId>`  
+  
+ `<TransactionTraceIdentifier>`  
+  
+ `<TransactionIdentifier >`  
+  
+ `string representation of transaction id`  
+  
+ `</TransactionIdentifier>`  
+  
+ `<CloneIdentifier >`  
+  
+ `the clone id number`  
+  
+ `</CloneIdentifier>`  
+  
+ `<TransactionTraceIdentifier>`  
+  
+ `<EnlistmentIdentifier>`  
+  
+ `the enlistment id number`  
+  
+ `</EnlistmentIdentifier>`  
+  
+ `</EnlistmentTraceIdentifier>`  
+  
+### リソース マネージャー識別子  
+ `<ResourceManagerId>`  
+  
+ `string form of guid`  
+  
+ `</ResourceManagerId>`  
+  
+## トレースのセキュリティに関する問題  
+ 管理者がトレース機能を有効にすると、既定で、パブリックに表示可能なトレース ログに機密情報が書き込まれる可能性があります。潜在的なセキュリティの脅威を緩和するため、共有およびファイル システムのアクセス許可によって管理される安全な場所にトレース ログを保存することを考慮する必要があります。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md b/docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md
new file mode 100644
index 00000000000..c4d6ed66d47
--- /dev/null
+++ b/docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md
@@ -0,0 +1,55 @@
+---
+title: "参加要素としてのリソースのトランザクションへの参加  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 786a12c2-d530-49f4-9c59-5c973e15a11d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 参加要素としてのリソースのトランザクションへの参加 
+トランザクションに参加する各リソースは、リソース マネージャーによって管理され、その動作はトランザクション マネージャーによって調整されます。この調整は、トランザクション マネージャーを介してトランザクションに参加したサブスクライバーへの通知によって行われます。  
+  
+ ここでは、単一または複数のリソースがトランザクションに参加する方法と、さまざまな種類の参加について説明します。「[単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)」では、参加リソース間でトランザクションのコミットメントを調整する方法について説明します。  
+  
+## トランザクションへのリソースの参加  
+ リソースをトランザクションに参加させるには、リソースをトランザクションに登録する必要があります。<xref:System.Transactions.Transaction> クラスは、この機能を提供する一連のメソッドを定義しています。これらのメソッドの名前は **Enlist** で始まります。さまざまな **Enlist** メソッドは、リソース マネージャーが持つ各種の参加リストにそれぞれ対応しています。具体的には、揮発性リソースには <xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッド、永続性リソースには <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドを使用します。リソース マネージャーの永続性または揮発性とは、リソース マネージャーがエラーの回復をサポートするかどうかを意味します。リソース マネージャーがエラーの回復をサポートする場合、フェーズ 1 \(準備\) 中にデータが永続ストレージに保存されます。したがって、リソース マネージャーがダウンした場合でも、回復時にトランザクションへの再参加を行い、TM から受信した通知に基づいて適切な動作を実行できます。一般に、揮発性リソース マネージャーは、メモリ内のデータ構造 \(たとえば、メモリ内のトランザクション ハッシュ テーブル\) などの揮発性リソースを管理し、永続的リソース マネージャーは、より永続的なバッキング ストアを持つリソース \(たとえば、バッキング ストアがディスクであるデータベース\) を管理します。  
+  
+ 簡単に説明すると、リソースが永続性をサポートするかどうかに応じて、<xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドまたは <xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドのどちらを使用するかを決定した後、リソース マネージャーに <xref:System.Transactions.IEnlistmentNotification> インターフェイスを実装して、2 フェーズ コミット \(2PC\) に参加するようにリソースを登録する必要があります。2PC の詳細については、「[単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)」を参照してください。  
+  
+ <xref:System.Transactions.Transaction.EnlistDurable%2A> および <xref:System.Transactions.Transaction.EnlistVolatile%2A> を複数回呼び出すことにより、これらのプロトコルのうち、複数のプロトコルに単一の参加要素を参加させることができます。  
+  
+### 永続的参加リスト  
+ <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドは、リソース マネージャーを永続性リソースとしてトランザクションに参加させるために使用します。永続的リソース マネージャーがトランザクション中にダウンした場合、リソース マネージャーはオンラインに戻った後、フェーズ 2 が完了していない参加要素を <xref:System.Transactions.TransactionManager.Reenlist%2A> メソッドを使用してすべてのトランザクションに再参加させ、回復を実行します。回復プロセスが完了したら、<xref:System.Transactions.TransactionManager.RecoveryComplete%2A> を呼び出します。回復の詳細については、「[回復の実行 ](../../../../docs/framework/data/transactions/performing-recovery.md)」を参照してください。  
+  
+ すべての <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドは、最初のパラメーターとして <xref:System.Guid> オブジェクトを使用します。トランザクション マネージャーは、この <xref:System.Guid> を使用して、永続参加リストと特定のリソース マネージャーを関連付けます。そのため、リソース マネージャーが再起動時に自身を他のリソース マネージャーと識別できるように、一貫して同じ <xref:System.Guid> を使用することが不可欠です。そうでない場合、回復が失敗する可能性があります。  
+  
+ <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドの第 2 パラメーターは、トランザクション通知を受信するためにリソース マネージャーが実装するオブジェクトへの参照です。使用するオーバーロードにより、リソース マネージャーが単一フェーズ コミット \(SPC\) の最適化をサポートするかどうかがトランザクション マネージャーに通知されます。ほとんどの場合、2 フェーズ コミット \(2PC\) に参加するために <xref:System.Transactions.IEnlistmentNotification> インターフェイスを実装します。ただし、コミット プロセスを最適化する場合は、SPC 用の <xref:System.Transactions.ISinglePhaseNotification> インターフェイスの実装を検討することもできます。SPC の詳細については、「[単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)」および「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」を参照してください。  
+  
+ 第 3 パラメーターは <xref:System.Transactions.EnlistmentOptions> 列挙体であり、その値は <xref:System.Transactions.EnlistmentOptions> または <xref:System.Transactions.EnlistmentOptions> のいずれかです。この値が <xref:System.Transactions.EnlistmentOptions> に設定されている場合、トランザクション マネージャーから Prepare 通知を受信したときに、参加リストが追加リソース マネージャーを参加させる可能性があります。ただし、この種類の参加リストは単一フェーズ コミットの最適化の条件を満たさないことに注意してください。  
+  
+### 揮発性参加リスト  
+ キャッシュなどの揮発性リソースを管理する参加要素は、<xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドを使用して参加させる必要があります。このようなオブジェクトは、トランザクションの結果を取得したり、システム障害の後で、参加しているトランザクションの状態を回復したりできない場合があります。  
+  
+ 前に述べたように、リソース マネージャーはメモリ内の揮発性リソースを管理する場合、揮発性参加リストを作成します。<xref:System.Transactions.Transaction.EnlistVolatile%2A> を使用する利点の 1 つに、トランザクションの不要なエスカレーションを強制しないことがあります。トランザクションのエスカレーションの詳細については、「[トランザクション管理エスカレーション ](../../../../docs/framework/data/transactions/transaction-management-escalation.md)」を参照してください。揮発的な参加を行うことは、トランザクション マネージャーによる参加リストの処理方法、およびトランザクション マネージャーがリソース マネージャーに期待することの両方に相違が生じることを意味します。これは、揮発性リソース マネージャーが回復を実行しないためです。揮発性リソース マネージャーが回復を実行せず、<xref:System.Guid> を必要とする <xref:System.Transactions.TransactionManager.Reenlist%2A> メソッドを呼び出さないため、<xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドは <xref:System.Guid> パラメーターを取得しません。  
+  
+ 永続的参加リストの場合と同様に、どのオーバーロード メソッドを使用して参加する場合でも、リソース マネージャーが単一フェーズ コミットの最適化をサポートするかどうかがトランザクション マネージャーに示されます。揮発性リソース マネージャーが回復を実行できないため、準備フェーズ中、回復情報は揮発性参加リストに書き込まれません。したがって、<xref:System.Transactions.PreparingEnlistment.RecoveryInformation%2A> メソッドを呼び出すと、<xref:System.InvalidOperationException> になります。  
+  
+ 次の例は、<xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドを使用して、このようなオブジェクトを参加要素としてトランザクションに参加させる方法を示しています。  
+  
+ [!code-csharp[Tx_Enlist#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/tx_enlist/cs/enlist.cs#1)]
+ [!code-vb[Tx_Enlist#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/tx_enlist/vb/enlist.vb#1)]  
+  
+### パフォーマンスの最適化  
+ <xref:System.Transactions.Transaction> クラスは、PSPE \(Promotable Single Phase Enlistment\) を参加させるための <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> メソッドも提供しています。これにより、永続的リソース マネージャー \(RM\) は、MSDTC による管理のために後で必要に応じてエスカレートできるトランザクションをホストおよび "所有" できます。詳細については、「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」を参照してください。  
+  
+## 参照  
+ [単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)   
+ [単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/features-provided-by-system-transactions.md b/docs/framework/data/transactions/features-provided-by-system-transactions.md
new file mode 100644
index 00000000000..7937dedfb59
--- /dev/null
+++ b/docs/framework/data/transactions/features-provided-by-system-transactions.md
@@ -0,0 +1,43 @@
+---
+title: "System.Transactions で提供される機能  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e458cef9-63b5-4401-b448-1536dcd9d9e5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# System.Transactions で提供される機能 
+ここでは、<xref:System.Transactions> 名前空間により提供される機能を使用して、独自のトランザクション アプリケーションとリソース マネージャーを作成する方法について説明します。特に、1 つまたは複数の参加要素を含むローカル トランザクションまたは分散トランザクションを作成し、参加する方法について説明します。  
+  
+## System.Transactions の概要  
+ <xref:System.Transactions> 名前空間内のクラスにより提供されるインフラストラクチャは、SQL Server、ADO.NET、メッセージ キュー \(MSMQ\)、および Microsoft 分散トランザクション コーディネーター \(MSDTC\) で開始されたトランザクションをサポートすることにより、トランザクション プログラミングを単純で効率的なものにします。<xref:System.Transactions> 名前空間は、<xref:System.Transactions.Transaction> クラスに基づく明示的なプログラミング モデルだけでなく、インフラストラクチャがトランザクションを自動的に管理する、<xref:System.Transactions.TransactionScope> クラスを使用した暗黙的なプログラミング モデルも提供します。この 2 つのモデルを使用したトランザクション アプリケーション作成方法の詳細については、「[トランザクション アプリケーションの作成 ](../../../../docs/framework/data/transactions/writing-a-transactional-application.md)」を参照してください。  
+  
+ <xref:System.Transactions> 名前空間には、リソース マネージャーを実装するための型も用意されています。リソース マネージャーは、トランザクションで使用する永続性データまたは揮発性データを管理し、トランザクション マネージャーと連携してアプリケーションの原子性と分離を保証します。<xref:System.Transactions> インフラストラクチャにより提供されるトランザクション マネージャーは、複数の揮発性リソースまたは単一の永続性リソースに関連するトランザクションをサポートします。リソース マネージャーの実装の詳細については、「[リソース マネージャーの実装 ](../../../../docs/framework/data/transactions/implementing-a-resource-manager.md)」を参照してください。  
+  
+ また、トランザクション マネージャーは、他の永続的リソース マネージャーがそれ自体をトランザクションに参加させた場合に、DTC などのディスク ベースのトランザクション マネージャーと連携して、ローカル トランザクションを分散トランザクションへと透過的にエスカレートします。<xref:System.Transactions> インフラストラクチャでは、主に 2 つの方法でパフォーマンスを向上させています。  
+  
+-   ダイナミック エスカレーション。これにより、トランザクションが複数の分散リソースにわたる場合、<xref:System.Transactions> インフラストラクチャが MSDTC のみを使用すること保証します。ダイナミック エスカレーションの詳細については、「[トランザクション管理エスカレーション ](../../../../docs/framework/data/transactions/transaction-management-escalation.md)」トピックを参照してください。  
+  
+-   昇格可能参加リスト。これにより、データベースなどのリソースが、トランザクションに参加している唯一のエンティティである場合に、トランザクションの所有権を取得できます。その後、必要に応じて、<xref:System.Transactions> インフラストラクチャがトランザクションの管理を MSDTC にエスカレートすることもできます。これにより、MSDTC の使用頻度をさらに減らすことができます。昇格可能参加リストの詳細については、「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」のトピックで詳しく解説されています。  
+  
+ <xref:System.Transactions> 名前空間は、AllowPartiallyTrustedCallers \(APTCA\)、DistributedTransactionPermission \(DTP\)、および完全な信頼の 3 つの信頼レベルを定義し、公開するリソースの種類へのアクセスを制限しています。各種の信頼レベルの詳細については、「[リソースへのアクセスでのセキュリティ信頼レベル ](../../../../docs/framework/data/transactions/security-trust-levels-in-accessing-resources.md)」を参照してください。  
+  
+## このセクションの内容  
+  
+### トランザクション アプリケーションの作成  
+ <xref:System.Transactions> 名前空間には、トランザクション アプリケーションを作成するための 2 つのモデルが用意されています。「[トランザクション スコープを使用した暗黙的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md)」では、<xref:System.Transactions.TransactionScope> クラスを使用した暗黙的なトランザクションの作成が、<xref:System.Transactions> 名前空間でどのようにサポートされるかについて説明します。  
+  
+ 「[CommittableTransaction を使用した明示的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-explicit-transaction-using-committabletransaction.md)」では、<xref:System.Transactions.CommittableTransaction> クラスを使用した明示的なトランザクションの作成が、<xref:System.Transactions> 名前空間でどのようにサポートされるかについて説明します。  
+  
+ トランザクション アプリケーションの作成の詳細については、「[トランザクション アプリケーションの作成 ](../../../../docs/framework/data/transactions/writing-a-transactional-application.md)」を参照してください。  
+  
+### リソース マネージャーの実装  
+ トランザクションに参加できるリソース マネージャーの実装については、「[リソース マネージャーの実装 ](../../../../docs/framework/data/transactions/implementing-a-resource-manager.md)」を参照してください。ここでは、リソースの参加、トランザクションのコミット、障害後の回復、および最適化のベスト プラクティスについて説明しています。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/implementing-a-resource-manager.md b/docs/framework/data/transactions/implementing-a-resource-manager.md
new file mode 100644
index 00000000000..0a335fbf24b
--- /dev/null
+++ b/docs/framework/data/transactions/implementing-a-resource-manager.md
@@ -0,0 +1,61 @@
+---
+title: "リソース マネージャーの実装  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d5c153f6-4419-49e3-a5f1-a50ae4c81bf3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# リソース マネージャーの実装 
+トランザクションで使用される各リソースはリソース マネージャーによって管理され、その動作はトランザクション マネージャーによって調整されます。リソース マネージャーは、トランザクション マネージャーと連携してアプリケーションに原子性と分離を保証します。Microsoft SQL Server、永続的なメッセージ キュー、メモリ内ハッシュ テーブルはすべて、リソース マネージャーの例です。  
+  
+ リソース マネージャーは、永続性データまたは揮発性データを管理します。リソース マネージャーの永続性または揮発性とは、リソース マネージャーがエラーの回復をサポートするかどうかを意味します。リソース マネージャーがエラーの回復をサポートする場合、フェーズ 1 \(準備\) 中にデータが永続ストレージに保存されます。したがって、リソース マネージャーがダウンした場合でも、回復時にトランザクションへの再参加を行い、トランザクション マネージャーから受信した通知に基づいて適切な動作を実行できます。一般に、揮発性リソース マネージャーは、メモリ内のデータ構造 \(たとえば、メモリ内のトランザクション ハッシュ テーブル\) などの揮発性リソースを管理し、永続的リソース マネージャーは、より永続的なバッキング ストアを持つリソース \(たとえば、バッキング ストアがディスクであるデータベース\) を管理します。  
+  
+ リソースをトランザクションに参加させるには、リソースをトランザクションに登録する必要があります。<xref:System.Transactions.Transaction> クラスは、この機能を提供する一連のメソッドを定義しています。これらのメソッドの名前は **Enlist** で始まります。さまざまな **Enlist** メソッドは、リソース マネージャーが持つ各種の参加リストにそれぞれ対応しています。具体的には、揮発性リソースには <xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッド、永続性リソースには <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドを使用します。簡単に説明すると、リソースが永続性をサポートするかどうかに応じて、<xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドまたは <xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドのどちらを使用するかを決定した後、リソース マネージャーに <xref:System.Transactions.IEnlistmentNotification> インターフェイスを実装して、2 フェーズ コミット \(2PC\) に参加するようにリソースを登録する必要があります。2PC の詳細については、「[単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)」を参照してください。  
+  
+ 参加により、リソース マネージャーは、トランザクションがコミットまたは中止したときに、トランザクション マネージャーからのコールバックを取得することを保証します。各参加リストについて、<xref:System.Transactions.IEnlistmentNotification> のインスタンスが 1 つ存在します。通常、トランザクションごとに 1 つの参加リストが存在しますが、リソース マネージャーは、同じトランザクションへの複数回の参加を選択できます。  
+  
+ 参加後、リソース マネージャーはトランザクションの要求に応答します。永続的リソース マネージャーは、管理するリソースに対するトランザクションの処理を元に戻したり、やり直したりするための十分な情報を格納しています。このためには、さまざまな方法があります。データのバージョン保持と変更ログの保持という 2 つの手法が一般的に使用されます。  
+  
+ アプリケーションがトランザクションをコミットすると、トランザクション マネージャーが 2 フェーズ コミット プロトコルを開始します。トランザクション マネージャーはまず、参加している各リソース マネージャーに、トランザクションをコミットする準備が整っているかどうかを確認します。リソース マネージャーは、コミットの準備、つまりトランザクションをコミットまたは中止できる状態を整える必要があります。  
+  
+ 準備フェーズ中に、永続的リソース マネージャーは安定したストレージに新旧のデータを記録します。したがって、システム障害が発生してもリソース マネージャーはデータを回復できます。リソース マネージャーは準備が整うと、トランザクションをコミットまたは中止するかどうかの決定をトランザクション マネージャーに通知します。いずれかのリソース マネージャーが準備の失敗を報告すると、トランザクション マネージャーは各リソース マネージャーにロールバック コマンドを送信し、アプリケーションにコミットの失敗を通知します。  
+  
+ 準備が整うと、リソース マネージャーは、フェーズ 2 でトランザクション マネージャーからコミットまたは中止のコールバックを取得するまで待機する必要があります。通常、準備とコミット プロトコルの全体は瞬時に完了します。システムまたは通信に障害が発生した場合、コミットまたは中止の通知が数分または数時間経っても到着しないことがあります。この間、リソース マネージャーはトランザクションの結果について判断できず、トランザクションがコミットまたは中止されたかどうかを認識できません。トランザクションについて判断できない間、リソース マネージャーはトランザクションをロックし続けてデータの変更を維持し、これらの変更部分を他のトランザクションから分離した状態にします。  
+  
+ リソース マネージャーが失敗すると、そのすべての参加トランザクションは、失敗前に準備またはコミットされたものを除いて中止されます。永続的リソース マネージャーは再起動時に、準備フェーズで書き込まれた準備情報を取得することにより、管理するリソースのコミット状態を再構築し、それに応じてトランザクションをコミットまたは中止します。  
+  
+ 要約すると、2 フェーズ コミット プロトコルとリソース マネージャーの組み合わせにより、トランザクションの原子性と永続性が実現されます。  
+  
+ <xref:System.Transactions.Transaction> クラスは、PSPE \(Promotable Single Phase Enlistment\) を参加させるための <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> メソッドも提供しています。これにより、永続的リソース マネージャー \(RM\) は、MSDTC による管理のために後で必要に応じてエスカレートできるトランザクションをホストおよび "所有" できます。詳細については、「[単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)」を参照してください。  
+  
+## このセクションの内容  
+ リソース マネージャーが通常実行する手順の概要については、次のトピックを参照してください。  
+  
+ [参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)  
+  
+ 永続性リソースまたは揮発性リソースがトランザクションに参加する方法について説明しています。  
+  
+ [単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)  
+  
+ リソース マネージャーがコミット通知に応答し、コミットの準備を行うしくみについて説明しています。  
+  
+ [回復の実行 ](../../../../docs/framework/data/transactions/performing-recovery.md)  
+  
+ 永続的リソース マネージャーが、どのようにエラーから回復するかについて説明しています。  
+  
+ [リソースへのアクセスでのセキュリティ信頼レベル ](../../../../docs/framework/data/transactions/security-trust-levels-in-accessing-resources.md)  
+  
+ System.Transactions の 3 つの信頼レベルで、<xref:System.Transactions> が公開するリソースの種類に対するアクセスがどのように制限されるかについて説明しています。  
+  
+ [単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 ](../../../../docs/framework/data/transactions/optimization-spc-and-promotable-spn.md)  
+  
+ リソース マネージャーの実装に使用できる最適化の技法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/implementing-an-explicit-transaction-using-committabletransaction.md b/docs/framework/data/transactions/implementing-an-explicit-transaction-using-committabletransaction.md
new file mode 100644
index 00000000000..cd41a1f2bf4
--- /dev/null
+++ b/docs/framework/data/transactions/implementing-an-explicit-transaction-using-committabletransaction.md
@@ -0,0 +1,92 @@
+---
+title: "CommittableTransaction を使用した明示的なトランザクションの実装  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 29efe5e5-897b-46c2-a35f-e599a273acc8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# CommittableTransaction を使用した明示的なトランザクションの実装 
+<xref:System.Transactions.CommittableTransaction> クラスは、<xref:System.Transactions.TransactionScope> クラスが暗黙的に使用されるのと対照的に、アプリケーションがトランザクションを明示的に使用する方法を提供します。これは、複数の関数呼び出しまたは複数のスレッド呼び出しで同じトランザクションを使用するアプリケーションで役立ちます。<xref:System.Transactions.TransactionScope> クラスとは異なり、アプリケーション作成者はトランザクションをコミットまたは中止するために、具体的に <xref:System.Transactions.CommittableTransaction.Commit%2A> メソッドまたは <xref:System.Transactions.Transaction.Rollback%2A> メソッドを呼び出す必要があります。  
+  
+## CommittableTransaction クラスの概要  
+ <xref:System.Transactions.CommittableTransaction> クラスは、<xref:System.Transactions.Transaction> クラスから派生するため、後者のすべての機能を提供します。特に有用なのは、<xref:System.Transactions.Transaction> クラスの <xref:System.Transactions.Transaction.Rollback%2A> メソッドで、これは <xref:System.Transactions.CommittableTransaction> オブジェクトのロールバックにも使用できます。  
+  
+ <xref:System.Transactions.Transaction> クラスは <xref:System.Transactions.CommittableTransaction> クラスに類似していますが、`Commit` メソッドは提供しません。これにより、トランザクションのコミット時に制御を継続しながら、トランザクション オブジェクト \(またはその複製\) を他のメソッド \(他のスレッド上に存在する可能性もあり\) に渡すことができます。呼び出されたコードでは、トランザクションの参加や処理の選択を行えますが、トランザクションをコミットできるのは <xref:System.Transactions.CommittableTransaction> オブジェクトの作成者のみです。  
+  
+ <xref:System.Transactions.CommittableTransaction> クラスを使用する場合には、次のことに注意する必要があります。  
+  
+-   <xref:System.Transactions.CommittableTransaction> トランザクションを作成しても、アンビエント トランザクションは設定されません。リソース マネージャーが必要に応じて正しいトランザクション コンテキストで動作することを保証するには、アンビエント トランザクションを具体的に設定およびリセットする必要があります。現在のアンビエント トランザクションを設定するには、グローバルな <xref:System.Transactions.Transaction> オブジェクトの静的な <xref:System.Transactions.Transaction.Current%2A> プロパティを設定します。  
+  
+-   <xref:System.Transactions.CommittableTransaction> オブジェクトは再利用できません。<xref:System.Transactions.CommittableTransaction> オブジェクトがコミットまたはロールバックされると、トランザクションで再び使用することはできません。つまり、現在のアンビエント トランザクション コンテキストとして設定することはできません。  
+  
+## CommittableTransaction の作成  
+ 新しい <xref:System.Transactions.CommittableTransaction> を作成してコミットする例を次に示します。  
+  
+ [!code-csharp[Tx_CommittableTx#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/tx_committabletx/cs/committabletxwithsql.cs#1)]
+ [!code-vb[Tx_CommittableTx#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/tx_committabletx/vb/committabletxwithsql.vb#1)]  
+  
+ <xref:System.Transactions.CommittableTransaction> のインスタンスを作成しても、アンビエント トランザクション コンテキストは自動的に設定されません。したがって、リソース マネージャーに対する操作は、そのトランザクションの一部に含まれません。アンビエント トランザクションを設定または取得するには、グローバル <xref:System.Transactions.Transaction> オブジェクトの静的な <xref:System.Transactions.Transaction.Current%2A> プロパティを使用します。アプリケーションでは、リソース マネージャーがトランザクションに参加できるようにするために、手動でこのプロパティを設定する必要があります。古いアンビエント トランザクションを保存し、<xref:System.Transactions.CommittableTransaction> オブジェクトの使用が終了したら復元することをお勧めします。  
+  
+ トランザクションをコミットするには、<xref:System.Transactions.CommittableTransaction.Commit%2A> メソッドを明示的に呼び出す必要があります。トランザクションをロールバックするには、<xref:System.Transactions.Transaction.Rollback%2A> メソッドを呼び出す必要があります。<xref:System.Transactions.CommittableTransaction> がコミットまたはロールバックされるまで、そのトランザクションに関連するすべてのリソースはロックされたままであることに注意してください。  
+  
+ <xref:System.Transactions.CommittableTransaction> オブジェクトは、複数の関数呼び出しおよびスレッドにわたって使用できます。ただし、例外を処理し、特に障害発生時に <xref:System.Transactions.Transaction.Rollback%28System.Exception%29> メソッドを呼び出すことはアプリケーション開発者の責任です。  
+  
+## 非同期コミット  
+ <xref:System.Transactions.CommittableTransaction> クラスは、トランザクションを非同期にコミットするための機構も提供します。トランザクションのコミットは、複数回のデータベース アクセスや潜在的なネットワーク待機時間が含まれる場合、かなりの時間を要することがあります。高いスループットのアプリケーションでデッドロックを回避するため、非同期コミットを使用してできるだけ早期にトランザクションの処理を完了し、バックグラウンド タスクとしてコミット処理を実行できます。このために、<xref:System.Transactions.CommittableTransaction> クラスの <xref:System.Transactions.CommittableTransaction.BeginCommit%2A> メソッドおよび <xref:System.Transactions.CommittableTransaction.EndCommit%2A> メソッドを使用できます。  
+  
+ <xref:System.Transactions.CommittableTransaction.BeginCommit%2A> を呼び出すことで、スレッド プールからのスレッドにコミット ホールドアップをディスパッチできます。また、<xref:System.Transactions.CommittableTransaction.EndCommit%2A> を呼び出して、トランザクションが実際にコミットされたかどうかを判断することもできます。なんらかの理由でトランザクションがコミットされなかった場合、<xref:System.Transactions.CommittableTransaction.EndCommit%2A> はトランザクションの例外を発生させます。<xref:System.Transactions.CommittableTransaction.EndCommit%2A> が呼び出された時点でトランザクションがまだコミットされていない場合、トランザクションがコミットまたは中止されるまで、呼び出し元がブロックされます。  
+  
+ 非同期のコミットを行う最も簡単な方法は、コミットの完了時に呼び出されるコールバック メソッドを提供することです。ただし、呼び出しを実行するために使用する元の <xref:System.Transactions.CommittableTransaction> オブジェクトに対して <xref:System.Transactions.CommittableTransaction.EndCommit%2A> メソッドを呼び出す必要があります。このオブジェクトを取得するため、コールバック メソッドの *IAsyncResult* パラメーターをダウンキャストできます。これは、<xref:System.Transactions.CommittableTransaction> クラスが <xref:System.IAsyncResult> クラスを実装しているためです。  
+  
+ 次の例は、非同期コミットの実行方法を示しています。  
+  
+```csharp  
+public void DoTransactionalWork()  
+{  
+     Transaction oldAmbient = Transaction.Current;  
+     CommittableTransaction committableTransaction = new CommittableTransaction();  
+     Transaction.Current = committableTransaction;  
+  
+     try  
+     {  
+          /* Perform transactional work here */  
+          // No errors - commit transaction asynchronously  
+          committableTransaction.BeginCommit(OnCommitted,null);  
+     }  
+     finally  
+     {  
+          //Restore the ambient transaction   
+          Transaction.Current = oldAmbient;  
+     }  
+}  
+void OnCommitted(IAsyncResult asyncResult)  
+{  
+     CommittableTransaction committableTransaction;  
+     committableTransaction = asyncResult as CommittableTransaction;     
+     Debug.Assert(committableTransaction != null);  
+     try  
+     {  
+          using(committableTransaction)  
+          {  
+               committableTransaction.EndCommit(asyncResult);  
+          }  
+     }  
+     catch(TransactionException e)  
+     {  
+          //Handle the failure to commit  
+     }  
+}  
+```  
+  
+## 参照  
+ [トランザクション スコープを使用した暗黙的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md)   
+ [トランザクション処理 ](../../../../docs/framework/data/transactions/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md b/docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md
new file mode 100644
index 00000000000..82c9a03e473
--- /dev/null
+++ b/docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md
@@ -0,0 +1,176 @@
+---
+title: "トランザクション スコープを使用した暗黙的なトランザクションの実装  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49d1706a-1e0c-4c85-9704-75c908372eb9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# トランザクション スコープを使用した暗黙的なトランザクションの実装 
+<xref:System.Transactions.TransactionScope> クラスを使用すると、コード ブロックがトランザクションに参加しているものとして簡単にマークすることができ、トランザクション自体と対話する必要がありません。トランザクション スコープは、アンビエント トランザクションを自動的に選択して管理することができます。トランザクション アプリケーションを開発する際は、使いやすさと効率の点から、<xref:System.Transactions.TransactionScope> クラスを使用することをお勧めします。  
+  
+ また、リソースをトランザクションに明示的に参加させる必要がありません。<xref:System.Transactions> リソース マネージャー \(SQL Server 2005 など\) は、スコープによって作成されたアンビエント トランザクションを検出して、自動的に参加することができます。  
+  
+## トランザクション スコープの作成  
+ 次のサンプルは、<xref:System.Transactions.TransactionScope> クラスの簡単な使用法を示しています。  
+  
+ [!code-csharp[TransactionScope#1](../../../../samples/snippets/csharp/VS_Snippets_Remoting/TransactionScope/cs/ScopeWithSQL.cs#1)]
+ [!code-vb[TransactionScope#1](../../../../samples/snippets/visualbasic/VS_Snippets_Remoting/TransactionScope/vb/ScopeWithSQL.vb#1)]  
+  
+ 新しい <xref:System.Transactions.TransactionScope> オブジェクトを作成すると、トランザクション スコープが開始されます。コード サンプルに示すように、**using** ステートメントを使用してスコープを作成することをお勧めします。**using** ステートメントは C\# と Visual Basic の両方で使用でき、**try...finally** ブロック同様、スコープが正しく破棄されるように機能します。  
+  
+ <xref:System.Transactions.TransactionScope> をインスタンス化するとき、トランザクション マネージャーは参加するトランザクションを決定します。確認されると、そのスコープは常にそのトランザクションに参加します。この決定は 2 つの要因に基づいて行われます。1 つはアンビエント トランザクションが存在するかどうか、もう 1 つはコンストラクターの **TransactionScopeOption** パラメーターの値です。アンビエント トランザクションとは、実行するコードが含まれているトランザクションのことです。<xref:System.Transactions.Transaction> クラスの静的 <xref:System.Transactions.Transaction.Current%2A> プロパティを呼び出すことによってアンビエント トランザクションへの参照を取得できます。このパラメーターの使用法の詳細については、このトピックの「TransactionScopeOption を使用したトランザクション フローの管理」を参照してください。  
+  
+## トランザクション スコープの完了  
+ アプリケーションがトランザクション内で実行する必要のあるすべての作業を完了したら、トランザクションをコミットできることをトランザクション マネージャーに知らせるために、<xref:System.Transactions.TransactionScope.Complete%2A> メソッドを一度だけ呼び出す必要があります。<xref:System.Transactions.TransactionScope.Complete%2A> の呼び出しを **using** ブロックの最後のステートメントとして配置することを強くお勧めします。  
+  
+ この呼び出しを行わないと、トランザクション マネージャーは、システム障害が発生したかまたはトランザクションのスコープ内で例外がスローされたと解釈するため、トランザクションが中止されます。ただし、このメソッドを呼び出したからといって必ずしもトランザクションのコミットが保証されるわけではありません。これはトランザクション マネージャーにステータスを通知する手段にすぎません。<xref:System.Transactions.TransactionScope.Complete%2A> メソッドを呼び出した後は、<xref:System.Transactions.Transaction.Current%2A> プロパティを使用してアンビエント トランザクションにアクセスできなくなります。アクセスしようとすると例外がスローされます。  
+  
+ <xref:System.Transactions.TransactionScope> オブジェクトが最初にトランザクションを作成した場合、トランザクション マネージャーがトランザクションを実際にコミットする作業は **using** ブロックの最後のコード行の後で行われます。このオブジェクトによってトランザクションが作成されていない場合、<xref:System.Transactions.CommittableTransaction> オブジェクトの所有者によって <xref:System.Transactions.CommittableTransaction.Commit%2A> が呼び出されるたびにコミットが発生します。その時点で、トランザクション マネージャーがリソース マネージャーを呼び出し、<xref:System.Transactions.TransactionScope> オブジェクトの <xref:System.Transactions.TransactionScope.Complete%2A> メソッドが呼び出されたかどうかに基づいて、コミットするかロールバックするかを通知します。  
+  
+ **using** ステートメントにより、例外が発生した場合でも必ず <xref:System.Transactions.TransactionScope> オブジェクトの <xref:System.Transactions.TransactionScope.Dispose%2A> メソッドが呼び出されます。<xref:System.Transactions.TransactionScope.Dispose%2A> メソッドは、トランザクション スコープの末尾を表します。このメソッドの呼び出し後に発生した例外は、トランザクションに影響しない場合があります。また、このメソッドはアンビエント トランザクションを前の状態に復元します。  
+  
+ スコープがトランザクションを作成し、そのトランザクションが中止された場合は、<xref:System.Transactions.TransactionAbortedException> がスローされます。トランザクション マネージャーがコミットを判断できない場合は、<xref:System.Transactions.TransactionIndoubtException> がスローされます。トランザクションがコミットされた場合は、例外はスローされません。  
+  
+## トランザクションのロールバック  
+ トランザクションをロールバックする場合は、トランザクション スコープ内で <xref:System.Transactions.TransactionScope.Complete%2A> メソッドを呼び出さないようにしてください。たとえば、スコープ内で例外をスローすると、スコープが参加しているトランザクションがロールバックされます。  
+  
+##  <a name="ManageTxFlow"></a> TransactionScopeOption を使用したトランザクション フローの管理  
+ 次の例にある `RootMethod` メソッドのように、独自のスコープを使用するメソッド内から、<xref:System.Transactions.TransactionScope> を使用するメソッドを呼び出すことによって、トランザクション スコープを入れ子にすることができます。  
+  
+```csharp  
+void RootMethod()  
+{  
+     using(TransactionScope scope = new TransactionScope())  
+     {  
+          /* Perform transactional work here */  
+          SomeMethod();  
+          scope.Complete();  
+     }  
+}  
+  
+void SomeMethod()  
+{  
+     using(TransactionScope scope = new TransactionScope())  
+     {  
+          /* Perform transactional work here */  
+          scope.Complete();  
+     }  
+}  
+```  
+  
+ 最上位のトランザクション スコープをルート スコープと呼びます。  
+  
+ <xref:System.Transactions.TransactionScope> クラスには、スコープのトランザクション動作を定義する <xref:System.Transactions.TransactionScopeOption> 型の列挙体を受け入れる、いくつかのオーバーロードされたコンストラクターがあります。  
+  
+ <xref:System.Transactions.TransactionScope> オブジェクトには次の 3 つのオプションがあります。  
+  
+-   アンビエント トランザクションに参加します \(存在しない場合は新規に作成します\)。  
+  
+-   新しいルート スコープになります。つまり、新しいトランザクションを開始して、そのトランザクションをそれ自身のスコープ内の新しいアンビエント トランザクションにします。  
+  
+-   どのトランザクションにも参加しません。その結果、アンビエント トランザクションは存在しません。  
+  
+ スコープが <xref:System.Transactions.TransactionScopeOption> でインスタンス化された場合、アンビエント トランザクションが存在しているときは、スコープはそのトランザクションに参加します。一方、アンビエント トランザクションが存在しないときは、スコープは新しいトランザクションを作成して、ルート スコープになります。これが既定値です。<xref:System.Transactions.TransactionScopeOption> を使用した場合、スコープがルートのときでも、アンビエント トランザクションに参加するだけのときでも、スコープ内のコードは異なる動作をする必要がありません。いずれの場合にもスコープ内のコードは同じ動作をします。  
+  
+ スコープが <xref:System.Transactions.TransactionScopeOption> でインスタンス化された場合は、常にルート スコープです。スコープが新しいトランザクションを開始し、そのトランザクションがスコープ内の新しいアンビエント トランザクションになります。  
+  
+ スコープが <xref:System.Transactions.TransactionScopeOption> でインスタンス化された場合は、アンビエント トランザクションの有無にかかわらず、スコープがトランザクションに参加することはありません。この値でインスタンス化されたスコープの場合は、スコープのアンビエント トランザクションは常に **null** になります。  
+  
+ 上記のオプションを要約すると、次の表のようになります。  
+  
+|TransactionScopeOption|アンビエント トランザクション|スコープの参加|  
+|----------------------------|---------------------|-------------|  
+|Required|いいえ|新規トランザクション \(ルートになる\)|  
+|RequiresNew|いいえ|新規トランザクション \(ルートになる\)|  
+|Suppress|いいえ|トランザクションなし|  
+|Required|はい|アンビエント トランザクション|  
+|RequiresNew|はい|新規トランザクション \(ルートになる\)|  
+|Suppress|はい|トランザクションなし|  
+  
+ <xref:System.Transactions.TransactionScope> オブジェクトが既存のアンビエント トランザクションに参加した場合、スコープ オブジェクトを破棄してもトランザクションが終了しないことがあります \(スコープがトランザクションを中止した場合を除く\)。アンビエント トランザクションがルート スコープによって作成されたものである場合は、ルート スコープが破棄されたときのみ、トランザクションの <xref:System.Transactions.CommittableTransaction.Commit%2A> が呼び出されます。トランザクションが手動で作成されたものである場合は、中止されるか、その作成者によってコミットされたときに、そのトランザクションは終了します。  
+  
+ 次の例は、入れ子になった 3 つのスコープ オブジェクトを作成する <xref:System.Transactions.TransactionScope> オブジェクトを示しています。各スコープ オブジェクトは異なる <xref:System.Transactions.TransactionScopeOption> 値でインスタンス化しています。  
+  
+```csharp  
+using(TransactionScope scope1 = new TransactionScope())   
+//Default is Required   
+{   
+     using(TransactionScope scope2 = new   
+      TransactionScope(TransactionScopeOption.Required))   
+     {  
+     ...  
+     }   
+  
+     using(TransactionScope scope3 = new TransactionScope(TransactionScopeOption.RequiresNew))   
+     {  
+     ...  
+     }   
+  
+     using(TransactionScope scope4 = new   
+        TransactionScope(TransactionScopeOption.Suppress))   
+    {  
+     ...  
+    }   
+}  
+```  
+  
+ このコード例では、アンビエント トランザクションがない状態で、新しいスコープ `scope1` を <xref:System.Transactions.TransactionScopeOption> で作成しています。スコープ `scope1` は、新しいトランザクション \(トランザクション A\) を作成し、トランザクション A をアンビエント トランザクションにするので、ルート スコープです。`Scope1` は次に、おのおのが異なる <xref:System.Transactions.TransactionScopeOption> 値を持つ 3 つのオブジェクトをさらに作成します。たとえば、`scope2` は <xref:System.Transactions.TransactionScopeOption> で作成されますが、アンビエント トランザクションがあるため、`scope1` によって作成された最初のトランザクションに参加します。`scope3` は新しいトランザクションのルート スコープです。`scope4` にはアンビエント トランザクションがありません。  
+  
+ <xref:System.Transactions.TransactionScopeOption> の既定値でかつ最もよく使用される値は <xref:System.Transactions.TransactionScopeOption> ですが、その他の各値にはそれぞれ固有の用途があります。  
+  
+ <xref:System.Transactions.TransactionScopeOption> は、コード セクションで実行された操作を保持したり、操作が失敗した場合でもアンビエント トランザクションを中止しない場合に役立ちます。たとえば、ログの記録や監査操作を実行する場合や、アンビエント トランザクションがコミットしても中止してもサブスクライバーにイベントを公開する場合などです。次の例で示すように、この値を使用すれば、トランザクション スコープ内に非トランザクション コード セクションを置くことができます。  
+  
+```csharp  
+using(TransactionScope scope1 = new TransactionScope())  
+{  
+     try  
+     {  
+          //Start of non-transactional section   
+          using(TransactionScope scope2 = new  
+             TransactionScope(TransactionScopeOption.Suppress))  
+          {  
+               //Do non-transactional work here  
+          }  
+          //Restores ambient transaction here  
+   }  
+     catch  
+     {}  
+   //Rest of scope1  
+}  
+  
+```  
+  
+### 入れ子になったスコープ内での選択  
+ 入れ子になったスコープはルート スコープのアンビエント トランザクションに参加できますが、入れ子になったスコープ内で <xref:System.Transactions.TransactionScope.Complete%2A> を呼び出してもルート スコープには影響がありません。ルート スコープから、入れ子になった最後のスコープまで、すべてのスコープがトランザクションのコミットを選択した場合にのみ、トランザクションはコミットされます。入れ子になったスコープで <xref:System.Transactions.TransactionScope.Complete%2A> を呼び出さないと、アンビエント トランザクションが即時に中止されるため、ルート スコープに影響します。  
+  
+## TransactionScope タイムアウトの設定  
+ <xref:System.Transactions.TransactionScope> のオーバーロードされたコンストラクターのいくつかは、トランザクションのタイムアウトを制御するために使用される <xref:System.TimeSpan> 型の値を受け入れます。タイムアウトをゼロに設定すると、タイムアウトは無期限になります。無期限のタイムアウトは主にデバッグに役立ちます。つまり、コードをステップ実行することによってビジネス ロジックの問題を切り分け、問題の究明を試みている間はデバッグするトランザクションがタイムアウトにならないようにすることができます。タイムアウト値を無期限にすると、トランザクションのデッドロックに対する保護機能が無効になるため、上記以外の目的でこれを使用する場合は十分注意する必要があります。  
+  
+ 次の 2 つの場合は、通常、<xref:System.Transactions.TransactionScope> タイムアウトを既定以外の値に設定します。第 1 は、開発時に、中止されたトランザクションをアプリケーションがどう処理するかをテストする場合です。タイムアウトを小さい値 \(1 ミリ秒など\) に設定すると、トランザクションが失敗するため、エラー処理コードを確認できます。第 2 は、スコープがリソース競合に関与した結果、デッドロックの発生が考えられるときに、既定のタイムアウト値より小さい値に設定する場合です。この場合は、できるだけ早くトランザクションを中止して、既定のタイムアウトが満了するのを待ちません。  
+  
+ アンビエント トランザクションに参加するスコープが、アンビエント トランザクションのタイムアウト設定値より小さいタイムアウト値を指定すると、<xref:System.Transactions.TransactionScope> オブジェクトに対して、後から指定した短い方のタイムアウトが適用され、スコープは指定した時間内に終了する必要があります。終了しない場合、トランザクションは自動的に中止されます。入れ子になったスコープのタイムアウトがアンビエント トランザクションのタイムアウトより長い場合は、効果はありません。  
+  
+## TransactionScope 分離レベルの設定  
+ <xref:System.Transactions.TransactionScope> のオーバーロードされたコンストラクターのいくつかは、タイムアウト値の他にも、分離レベルを指定する <xref:System.Transactions.TransactionOptions> 型の構造体を受け入れます。既定では、トランザクションは <xref:System.Transactions.IsolationLevel> に設定された分離レベルで実行されます。<xref:System.Transactions.IsolationLevel> 以外の分離レベルは、読み取り集中型のシステムの場合によく使用されます。そのためには、トランザクション処理理論とトランザクション自体の動作、関連する同時実行の問題、およびシステム整合性の影響をよく理解する必要があります。  
+  
+ さらに、すべてのリソース マネージャーがすべての分離レベルをサポートするわけではなく、構成されたレベルより高いレベルのトランザクションへの参加をリソース マネージャーが選択する場合もあります。  
+  
+ <xref:System.Transactions.IsolationLevel> を除くすべての分離レベルは、他のトランザクションが同じ情報にアクセスすることで生じる不整合の影響を受けやすくなっています。分離レベルごとの違いは、読み取りロックおよび書き込みロックの使用方法にあります。ロックには、トランザクションがリソース マネージャーのデータにアクセスするときのみ保持できるか、トランザクションがコミットまたは中止されるまで保持できるかの 2 種類があります。前者はスループットの面で優れており、後者は整合性の面で優れています。2 種類のロックと 2 種類の操作 \(読み取り\/書き込み\) から、4 つの基本分離レベルが構成されます。詳細については、「<xref:System.Transactions.IsolationLevel>」を参照してください。  
+  
+ 入れ子になった <xref:System.Transactions.TransactionScope> オブジェクトを使用する場合、入れ子になったすべてのスコープがアンビエント トランザクションに参加するときには、必ず同じ分離レベルを使用するようにそれらのスコープを構成する必要があります。入れ子になった <xref:System.Transactions.TransactionScope> オブジェクトがアンビエント トランザクションに参加するときに、別の分離レベルが指定された場合は、<xref:System.ArgumentException> がスローされます。  
+  
+## COM\+ との相互運用  
+ 新しい <xref:System.Transactions.TransactionScope> インスタンスを作成する際には、いずれかのコンストラクターで <xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体を使用して、COM\+ との対話方法を指定することができます。詳細については、「[Enterprise Services と COM\+ トランザクションの相互運用性 ](../../../../docs/framework/data/transactions/interoperability-with-enterprise-services-and-com-transactions.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Transactions.Transaction.Clone%2A>   
+ <xref:System.Transactions.TransactionScope>
\ No newline at end of file
diff --git a/docs/framework/data/transactions/index.md b/docs/framework/data/transactions/index.md
new file mode 100644
index 00000000000..e843814daac
--- /dev/null
+++ b/docs/framework/data/transactions/index.md
@@ -0,0 +1,37 @@
+---
+title: "トランザクション処理  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: effdc8e6-accf-41eb-98a5-431603ba218b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# トランザクション処理 
+オンライン書店で書籍を購入する場合、書籍と代金 \(クレジット形式\) を交換します。クレジットに問題がなければ、一連の処理によって顧客は書籍を入手し、書店には代金が入金されます。ただし、一連の取引処理の 1 つでも失敗すると取引全体が失敗し、顧客は書籍を入手できず、書店は代金を受け取れません。  
+  
+ 取引のバランスを取り、予測可能なものにするための技術をトランザクション処理と呼びます。トランザクションは、トランザクション単位内のすべての処理が正常に完了しない限り、データ指向のリソースが永続的に更新されないことを保証します。完全に成功するか、または完全に失敗する 1 つの単位に一連の関連する処理を結合することにより、エラーの回復を単純化し、アプリケーションの信頼性を高めることができます。  
+  
+ トランザクション処理システムは、ビジネスに必要なルーチン トランザクションを実行するためのトランザクション指向アプリケーションをホストする、コンピューター ハードウェアとソフトウェアから構成されます。例としては、発注エントリ、航空券の予約、給与支払い、従業員レコード、製造、出荷などの管理システムが挙げられます。  
+  
+ ここでは、トランザクション処理に関する一般的な情報と、Microsoft .NET Framework を使用したトランザクション アプリケーションおよびリソース マネージャーの具体的な作成方法について説明します。  
+  
+## このセクションの内容  
+ [Transaction Fundamentals](http://msdn.microsoft.com/ja-jp/2a476b63-b94f-443f-992d-53943fdf4e5d)  
+ トランザクション処理の基本的な用語と概念について紹介します。  
+  
+ [System.Transactions で提供される機能 ](../../../../docs/framework/data/transactions/features-provided-by-system-transactions.md)  
+ System.Transactions の機能を使用して、独自のトランザクション アプリケーションを作成する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Transactions>  
+ コードのトランザクションへの参加を許可するクラスを提供します。このクラスは、複数の分散参加要素、複数のフェーズ通知、および永続参加リストを使用するトランザクションをサポートします。  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/data/transactions/interoperability-with-enterprise-services-and-com-transactions.md b/docs/framework/data/transactions/interoperability-with-enterprise-services-and-com-transactions.md
new file mode 100644
index 00000000000..031469d9fea
--- /dev/null
+++ b/docs/framework/data/transactions/interoperability-with-enterprise-services-and-com-transactions.md
@@ -0,0 +1,85 @@
+---
+title: "Enterprise Services と COM+ トランザクションの相互運用性  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0fd0d26-fe86-443b-b208-4d57d39fa4aa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Enterprise Services と COM+ トランザクションの相互運用性 
+<xref:System.Transactions> 名前空間は、この名前空間を使用して作成されたトランザクション オブジェクトと COM\+ によって作成されたトランザクションとの間の相互運用をサポートします。  
+  
+ 新しい <xref:System.Transactions.TransactionScope> インスタンスを作成する際に <xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体を使用すれば、COM\+ との相互運用性のレベルを指定することができます。  
+  
+ 既定では、アプリケーション コードが静的 <xref:System.Transactions.Transaction.Current%2A> プロパティを検査すると、<xref:System.Transactions> は、その他の場合は最新であるトランザクション、または <xref:System.Transactions.Transaction.Current%2A> が **null** であることを指示する <xref:System.Transactions.TransactionScope> オブジェクトを探します。どちらも見つからないと、<xref:System.Transactions> は COM\+ コンテキストに照会してトランザクションを探します。<xref:System.Transactions> は、COM\+ コンテキストからトランザクションが見つかる場合でも、<xref:System.Transactions> にネイティブなトランザクションを優先します。  
+  
+## 相互運用性のレベル  
+ <xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体は、<xref:System.Transactions.EnterpriseServicesInteropOption>、<xref:System.Transactions.EnterpriseServicesInteropOption>、および <xref:System.Transactions.EnterpriseServicesInteropOption> の各相互運用性レベルを定義します。  
+  
+ <xref:System.Transactions.TransactionScope> クラスは、<xref:System.Transactions.EnterpriseServicesInteropOption> をパラメーターとして受け入れるコンストラクターを提供します。  
+  
+ <xref:System.Transactions.EnterpriseServicesInteropOption> は、その名前が示すように、<xref:System.EnterpriseServices> コンテキストとトランザクション スコープとの間に相互運用性がないことを意味します。<xref:System.Transactions.EnterpriseServicesInteropOption> で <xref:System.Transactions.TransactionScope> オブジェクトを作成した場合は、その後 <xref:System.Transactions.Transaction.Current%2A> にどのような変更を加えても、その変更が COM\+ コンテキストに反映されることはありません。同様に、COM\+ コンテキスト内のトランザクションに対する変更も <xref:System.Transactions.Transaction.Current%2A> には反映されません。追加の同期が必要ないため、これは <xref:System.Transactions> の最速のモードです。<xref:System.Transactions.EnterpriseServicesInteropOption> は、<xref:System.Transactions.EnterpriseServicesInteropOption> をパラメーターとして受け入れないすべてのコンストラクターで、<xref:System.Transactions.TransactionScope> よって使用される既定値です。  
+  
+ <xref:System.EnterpriseServices> トランザクションをアンビエント トランザクションと組み合わせる場合は、<xref:System.Transactions.EnterpriseServicesInteropOption> または <xref:System.Transactions.EnterpriseServicesInteropOption> のいずれかを使用する必要があります。これらの値はいずれもコンポーネントのないサービスと呼ばれる機能に依存するため、これらの値を使用する際には Windows XP Service Pack 2 または Windows Server 2003 が稼働している必要があります。  
+  
+ <xref:System.Transactions.EnterpriseServicesInteropOption> は、<xref:System.Transactions> と <xref:System.EnterpriseServices> のアンビエント トランザクションが常に同じものであることを指定します。結果として、新しい <xref:System.EnterpriseServices> トランザクション コンテキストが作成され、そのコンテキストにとって <xref:System.Transactions.TransactionScope> が最新になるようにするため最新のトランザクションが適用されます。そのため、<xref:System.Transactions.Transaction.Current%2A> のトランザクションは <xref:System.EnterpriseServices.ContextUtil.Transaction%2A> のトランザクションと完全に同期することになります。この値を使用すると、新しい COM\+ コンテキストを作成しなければならない場合があるため、パフォーマンスが低下します。  
+  
+ <xref:System.Transactions.EnterpriseServicesInteropOption> は次の要件を指定します。  
+  
+-   <xref:System.Transactions.Transaction.Current%2A> が検査されると、<xref:System.Transactions> は、既定のコンテキスト以外のコンテキストで実行されていることを検出した場合、COM\+ コンテキスト内のトランザクションをサポートする必要があります。既定のコンテキストには、トランザクションを含めることができません。したがって、既定のコンテキストでは、<xref:System.Transactions.EnterpriseServicesInteropOption> を使用した場合でも、<xref:System.Transactions> によって使用されるスレッド ローカル ストレージに格納されているトランザクションが <xref:System.Transactions.Transaction.Current%2A> に対して返されます。  
+  
+-   新しい <xref:System.Transactions.TransactionScope> オブジェクトが作成され、その作成が既定のコンテキスト以外のコンテキストで行われた場合は、<xref:System.Transactions.TransactionScope> オブジェクトにとって最新であるトランザクションが COM\+ に反映される必要があります。この場合、<xref:System.Transactions.EnterpriseServicesInteropOption> は、新しい COM\+ コンテキストを作成するという点で、<xref:System.Transactions.EnterpriseServicesInteropOption> と同様に動作します。  
+  
+ さらに、<xref:System.Transactions.EnterpriseServicesInteropOption> と <xref:System.Transactions.EnterpriseServicesInteropOption> の両方で <xref:System.Transactions.Transaction.Current%2A> が設定されると、これらのモードはいずれも、<xref:System.Transactions.Transaction.Current%2A> を直接設定できないことを示します。<xref:System.Transactions.TransactionScope> を作成する以外に <xref:System.Transactions.Transaction.Current%2A> を直接設定しようとすると、<xref:System.InvalidOperationException> が発生します。<xref:System.Transactions.EnterpriseServicesInteropOption> 列挙値には、使用する値を明示的に指定しない新しいトランザクション スコープが継承されます。たとえば、新しい <xref:System.Transactions.TransactionScope> オブジェクトを <xref:System.Transactions.EnterpriseServicesInteropOption> で作成した後、2 番目の <xref:System.Transactions.TransactionScope> オブジェクトを作成した場合 \(ただし、<xref:System.Transactions.EnterpriseServicesInteropOption> 値を指定しない\)、その 2 番目の <xref:System.Transactions.TransactionScope> オブジェクトも <xref:System.Transactions.EnterpriseServicesInteropOption> を持つことになります。  
+  
+ 要約すると、新しいトランザクション スコープを作成するときには次の規則が適用されます。  
+  
+1.  トランザクションがあるかどうかを調べるため <xref:System.Transactions.Transaction.Current%2A> が検査されます。この検査の結果、次のことが行われます。  
+  
+    -   スコープがあるかどうかが検査されます。  
+  
+    -   スコープがある場合は、そのスコープが最初に作成されたときに渡された <xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体の値が検査されます。  
+  
+    -   <xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体が <xref:System.Transactions.EnterpriseServicesInteropOption> に設定された場合は、COM\+ トランザクション \(<xref:System.EnterpriseServices> トランザクション\) がマネージ スレッド ローカル ストレージ内の <xref:System.Transactions> トランザクションよりも優先されます。  
+  
+         値が <xref:System.Transactions.EnterpriseServicesInteropOption> に設定された場合は、マネージ スレッド ローカル ストレージ内の <xref:System.Transactions> トランザクションが優先されます。  
+  
+         値が <xref:System.Transactions.EnterpriseServicesInteropOption> の場合は、トランザクションは 1 つだけあり、それは COM\+ トランザクションです。  
+  
+2.  <xref:System.Transactions.TransactionScope> コンストラクターによって渡された <xref:System.Transactions.TransactionScopeOption> 列挙体の値が検査されます。これにより、新しいトランザクションを作成する必要があるかどうかが決定されます。  
+  
+3.  新しいトランザクションを作成する場合は、<xref:System.Transactions.EnterpriseServicesInteropOption> の値に応じてそれぞれ次のようになります。  
+  
+    -   <xref:System.Transactions.EnterpriseServicesInteropOption>:  COM\+ コンテキストに関連付けられたトランザクションが作成されます。  
+  
+    -   <xref:System.Transactions.EnterpriseServicesInteropOption>: <xref:System.Transactions> トランザクションが作成されます。  
+  
+    -   <xref:System.Transactions.EnterpriseServicesInteropOption>: COM\+ コンテキストがある場合は、トランザクションが作成され、そのコンテキストに関連付けられます。  
+  
+ 次の表は、Enterprise Services \(ES\) コンテキストと、<xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体を使用するトランザクションを必要とするトランザクション スコープを示しています。  
+  
+|ES コンテキスト|なし|自動|完全|  
+|---------------|--------|--------|--------|  
+|既定のコンテキスト|既定のコンテキスト|既定のコンテキスト|新しいトランザクション コンテキストの作成|  
+|既定以外のコンテキスト|クライアントのコンテキストの保守|新しいトランザクション コンテキストの作成|新しいトランザクション コンテキストの作成|  
+  
+ 次の表は、特定の <xref:System.EnterpriseServices> コンテキストと、<xref:System.Transactions.EnterpriseServicesInteropOption> 列挙体を使用するトランザクションを必要とするトランザクション スコープがあると、アンビエント トランザクションがどうなるかを示しています。  
+  
+|ES コンテキスト|なし|自動|完全|  
+|---------------|--------|--------|--------|  
+|既定のコンテキスト|ST|ST|ES|  
+|既定以外のコンテキスト|ST|ES|ES|  
+  
+ 注:  
+  
+-   ST は、スコープのアンビエント トランザクションが <xref:System.Transactions> によって管理され、どの <xref:System.EnterpriseServices> コンテキストのトランザクション \(存在する場合\) にも関連付けられていないことを示します。  
+  
+-   ES は、スコープのアンビエント トランザクションが <xref:System.EnterpriseServices> コンテキストのトランザクションと同じものであることを示します。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/managing-concurrency-with-dependenttransaction.md b/docs/framework/data/transactions/managing-concurrency-with-dependenttransaction.md
new file mode 100644
index 00000000000..09e661202c5
--- /dev/null
+++ b/docs/framework/data/transactions/managing-concurrency-with-dependenttransaction.md
@@ -0,0 +1,91 @@
+---
+title: "DependentTransaction の同時実行の管理  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b85a97d8-8e02-4555-95df-34c8af095148
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# DependentTransaction の同時実行の管理 
+<xref:System.Transactions.Transaction> オブジェクトは、<xref:System.Transactions.Transaction.DependentClone%2A> メソッドを使用して作成されます。このオブジェクトの唯一の目的は、他のコード \(ワーカー スレッドなど\) でトランザクションの処理を実行している間、トランザクションをコミットできないように保証することです。複製されたトランザクション内の処理が完了してコミットの準備が整うと、<xref:System.Transactions.DependentTransaction.Complete%2A> メソッドを使用して、そのトランザクションの作成者に通知できます。これにより、データの一貫性と正確性を保持できます。  
+  
+ <xref:System.Transactions.DependentTransaction> クラスは、非同期タスク間の同時実行の管理にも使用できます。この場合は、トランザクションに依存している複製が独自のタスクの処理を行う間、親が任意のコードの実行を継続できます。つまり、依存している複製が完了するまで親の実行がブロックされることはありません。  
+  
+## トランザクションに依存している複製の作成  
+ 依存トランザクションを作成するには、<xref:System.Transactions.Transaction.DependentClone%2A> メソッドを呼び出し、パラメーターとして <xref:System.Transactions.DependentCloneOption> 列挙体を渡します。このパラメーターは、トランザクションに依存している複製が <xref:System.Transactions.DependentTransaction.Complete%2A> メソッドを呼び出してトランザクションのコミットの準備が整ったことを示す前に、親トランザクションで `Commit` が呼び出された場合のトランザクションの動作を定義します。このパラメーターで有効な値は次のとおりです。  
+  
+-   <xref:System.Transactions.DependentCloneOption> は、親トランザクションがタイムアウトするまで、またはすべての依存トランザクションで完了を示す <xref:System.Transactions.DependentTransaction.Complete%2A> が呼び出されるまで、親トランザクションのコミット プロセスをブロックする依存トランザクションを作成します。これは、依存トランザクションが完了するまで、クライアントが親トランザクションのコミットを望まない場合に役立ちます。親トランザクションが依存トランザクションより前に処理を完了して <xref:System.Transactions.CommittableTransaction.Commit%2A> を呼び出した場合、すべての依存トランザクションが <xref:System.Transactions.DependentTransaction.Complete%2A> を呼び出すまで、コミット プロセスはブロックされ、そのトランザクションで追加処理を実行し、新しい参加リストを作成できる状態になります。すべての依存トランザクションの処理が完了し、<xref:System.Transactions.DependentTransaction.Complete%2A> を呼び出すとすぐに、トランザクションのコミット プロセスが開始します。  
+  
+-   一方、<xref:System.Transactions.DependentCloneOption> では、<xref:System.Transactions.DependentTransaction.Complete%2A> が呼び出される前に親トランザクションで <xref:System.Transactions.CommittableTransaction.Commit%2A> が呼び出された場合、自動的に中止する依存トランザクションが作成されます。この場合、依存トランザクションで行われたすべての処理は、1 つのトランザクションの有効期間内はそのまま変更されず、その一部でもコミットすることはできません。  
+  
+ アプリケーションが依存トランザクションでその処理を完了した場合、<xref:System.Transactions.DependentTransaction.Complete%2A> メソッドを 1 回だけ呼び出す必要があります。それ以外の場合は、<xref:System.InvalidOperationException> がスローされます。この呼び出しを行った後は、トランザクションで追加作業を行わないでください。例外が発生します。  
+  
+ 次のコード例では、依存トランザクションの複製を作成してワーカー スレッドに渡すことにより、2 つの同時実行タスクを管理する依存トランザクションを作成する方法を示しています。  
+  
+```csharp  
+public class WorkerThread  
+{  
+    public void DoWork(DependentTransaction dependentTransaction)  
+    {  
+        Thread thread = new Thread(ThreadMethod);  
+        thread.Start(dependentTransaction);   
+    }  
+  
+    public void ThreadMethod(object transaction)   
+    {   
+        DependentTransaction dependentTransaction = transaction as DependentTransaction;  
+        Debug.Assert(dependentTransaction != null);   
+        try  
+        {  
+            using(TransactionScope ts = new TransactionScope(dependentTransaction))  
+            {  
+                /* Perform transactional work here */   
+                ts.Complete();  
+            }  
+        }  
+        finally  
+        {  
+            dependentTransaction.Complete();   
+             dependentTransaction.Dispose();   
+        }  
+    }  
+  
+//Client code   
+using(TransactionScope scope = new TransactionScope())  
+{  
+    Transaction currentTransaction = Transaction.Current;  
+    DependentTransaction dependentTransaction;      
+    dependentTransaction = currentTransaction.DependentClone(DependentCloneOption.BlockCommitUntilComplete);  
+    WorkerThread workerThread = new WorkerThread();  
+    workerThread.DoWork(dependentTransaction);  
+    /* Do some transactional work here, then: */  
+    scope.Complete();  
+}  
+  
+```  
+  
+ このクライアント コードは、アンビエント トランザクションの設定も行うトランザクション スコープを作成します。アンビエント トランザクションをワーカー スレッドに渡さないでください。その代わりに、現在のトランザクションで <xref:System.Transactions.Transaction.DependentClone%2A> メソッドを呼び出すことにより、現在の \(アンビエント\) トランザクションを複製し、依存トランザクションをワーカー スレッドに渡す必要があります。  
+  
+ `ThreadMethod` メソッドは、新しいスレッドで実行されます。クライアントは新しいスレッドを開始し、`ThreadMethod` パラメーターとして依存トランザクションを渡します。  
+  
+ 依存トランザクションは <xref:System.Transactions.DependentCloneOption> により作成されるため、2 番目のスレッド上ですべてのトランザクションの処理が完了し、依存トランザクションで <xref:System.Transactions.DependentTransaction.Complete%2A> が呼び出されるまで、トランザクションがコミットされないことが保証されます。つまり、新しいスレッドが依存トランザクションで <xref:System.Transactions.DependentTransaction.Complete%2A> を呼び出す前にクライアントのスコープが終了した場合 \(**using** ステートメントの最後でトランザクション オブジェクトの破棄を試みた場合\)、依存トランザクションで <xref:System.Transactions.DependentTransaction.Complete%2A> が呼び出されるまで、クライアント コードはブロックします。その後、トランザクションはコミットまたは中止の処理を完了できます。  
+  
+## 同時実行に関する問題  
+ 同時実行に関して、<xref:System.Transactions.DependentTransaction> クラスを使用する場合に注意が必要な問題がいくつかあります。  
+  
+-   ワーカー スレッドがトランザクションをロールバックし、親がトランザクションのコミットを試みた場合、<xref:System.Transactions.TransactionAbortedException> がスローされます。  
+  
+-   トランザクション内の各ワーカー スレッドについて、トランザクションに依存している複製を新しく作成する必要があります。同一の依存している複製を複数のスレッドに渡さないでください。その複製に対して <xref:System.Transactions.DependentTransaction.Complete%2A> を呼び出すことができるのは、1 つのスレッドのみであるためです。  
+  
+-   ワーカー スレッドが新しいワーカー スレッドを生成する場合、依存している複製から依存している複製を作成し、それを新しいスレッドに渡してください。  
+  
+## 参照  
+ <xref:System.Transactions.DependentTransaction>
\ No newline at end of file
diff --git a/docs/framework/data/transactions/optimization-spc-and-promotable-spn.md b/docs/framework/data/transactions/optimization-spc-and-promotable-spn.md
new file mode 100644
index 00000000000..06b5ca8679b
--- /dev/null
+++ b/docs/framework/data/transactions/optimization-spc-and-promotable-spn.md
@@ -0,0 +1,70 @@
+---
+title: "単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57beaf1a-fb4d-441a-ab1d-bc0c14ce7899
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 単一フェーズ コミットと昇格可能単一フェーズ通知を使用した最適化 
+ここでは、パフォーマンスを最適化するために <xref:System.Transactions> インフラストラクチャに用意されているメカニズムについて説明します。  
+  
+## PSPE \(Promotable Single Phase Enlistment\)  
+ <xref:System.Transactions> インフラストラクチャは、単一の永続性リソースまたは複数の揮発性リソースを含む単一のアプリケーション ドメイン内のトランザクションを管理します。<xref:System.Transactions> インフラストラクチャは、アプリケーション内ドメインの呼び出しのみを使用するため、最良のスループットおよびパフォーマンスを得られます。  
+  
+ ただし、トランザクションが同じコンピューター上の別のアプリケーション ドメインにある別のオブジェクト \(プロセスやコンピューターの境界にまたがるものを含む\) に供給される場合や、別の永続的リソース マネージャーを参加させる場合、<xref:System.Transactions> インフラストラクチャは、MSDTC によって管理されるトランザクションを自動的にエスカレートします。MSDTC によって管理されるトランザクションは、<xref:System.Transactions> インフラストラクチャによって管理されるトランザクションに比べて、パフォーマンスが落ちます。  
+  
+ パフォーマンスを最適化するため、<xref:System.Transactions> インフラストラクチャには PSPE \(Promotable Single Phase Enlistment\) が用意されており、異なるアプリケーション ドメイン、プロセス、またはコンピューターにある単一のリモート永続性リソースが、MSDTC トランザクションにエスカレートされることなく <xref:System.Transactions> トランザクションに参加できるようになります。このリソース マネージャー \(RM\) は、必要に応じて後で分散トランザクション \(または MSDTC トランザクション\) にエスカレートできるトランザクションをホストおよび "所有" できます。これにより、MSDTC の使用頻度が少なくなります。  
+  
+ この特別なリソース マネージャーは通常、内部に独自の非分散トランザクションを所有しており、実行時にこれらのトランザクションを分散トランザクションに変換する必要があります。たとえば、SQL Server 2005 はこのようなリソース マネージャーです。この場合、<xref:System.Transactions> インフラストラクチャは、トランザクションのエスカレーションが必要かどうかを監視するだけという受動的な管理役割を担います。<xref:System.Transactions> インフラストラクチャとリソース マネージャー間の相互動作をサポートするため、リソース マネージャーは、<xref:System.Transactions.IPromotableSinglePhaseNotification> インターフェイスを実装する必要があります。  
+  
+ <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> メソッドは、後でエスカレートできる単一の永続性リソースを参加させるのに使用されます。このメソッドにより、必要に応じて参加リストをエスカレートできます。参加が成功すると、RM は内部トランザクションを作成し、<xref:System.Transactions> トランザクションに関連付けます。PSPE の参加が失敗すると、RM は代わりに <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドを使用して参加を行います。トランザクションが既に分散トランザクションである場合や、別の RM が既に PSPE の参加を実行している場合、PSPE の参加は失敗します。  
+  
+ 参加すると、<xref:System.Transactions> トランザクションをコミットまたは中止するクライアントからの呼び出しがリソース マネージャーでの呼び出しに変換されます。これは、それぞれ <xref:System.Transactions.IPromotableSinglePhaseNotification.SinglePhaseCommit%2A> メソッドまたは <xref:System.Transactions.IPromotableSinglePhaseNotification.Rollback%2A> を呼び出すことで行われます。  
+  
+ <xref:System.Transactions> トランザクションのエスカレーションが必要ない場合、トランザクションがコミットされると、RM が <xref:System.Transactions.IPromotableSinglePhaseNotification.SinglePhaseCommit%2A> 通知を受信します。次に、最初に作成された内部トランザクションがコミットされます。  
+  
+ <xref:System.Transactions> トランザクションのエスカレートが必要な場合 \(複数の RM をサポートする場合など\) は、<xref:System.Transactions> がリソース マネージャーに通知します。この通知は、<xref:System.Transactions.IPromotableSinglePhaseNotification> インターフェイスの派生元である <xref:System.Transactions.ITransactionPromoter> インターフェイス上の <xref:System.Transactions.ITransactionPromoter.Promote%2A> メソッドを呼び出すことで行われます。次に、リソース マネージャーは、ローカル トランザクション \(ログが不要\) から DTC トランザクションに参加できるトランザクション オブジェクトへ、トランザクションを内部的に変換し、既に実行済みの作業に関連付けます。トランザクションのコミットが要求されると、トランザクション マネージャーが <xref:System.Transactions.IPromotableSinglePhaseNotification.SinglePhaseCommit%2A> 通知をリソース マネージャーに送信し、リソース マネージャーがエスカレーション中に作成される分散トランザクションをコミットします。  
+  
+> [!NOTE]
+>  エスカレートされたトランザクションでコミットが呼び出されたときに生成される **TransactionCommitted** トレースは、DTC トランザクションのアクティビティ ID を含んでいます。  
+  
+ 管理エスカレーションの詳細については、「[トランザクション管理エスカレーション ](../../../../docs/framework/data/transactions/transaction-management-escalation.md)」を参照してください。  
+  
+## トランザクション管理エスカレーションのシナリオ  
+ 次のシナリオは、<xref:System.Data> 名前空間をリソース マネージャーの "プロキシ" として使用して、分散トランザクションにエスカレートする操作を示しています。このシナリオでは、トランザクションで呼び出されたデータベースへの <xref:System.Data> 接続 \(CN1\) が既に存在し、アプリケーションが別の <xref:System.Data> 接続 \(CN2\) を呼び出そうとしている場合を想定しています。トランザクションは、完全な分散 2 フェーズ コミット トランザクションとして、DTC にエスカレートする必要があります。  
+  
+ このシナリオの内容  
+  
+1.  CN1 は、トランザクションに参加するため、<xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> メソッドを呼び出します。ここで、トランザクションはまだローカルであり、トランザクションには他に昇格可能参加リストがないため、<xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> 呼び出しは成功します。  
+  
+2.  2 番目の接続 \(CN2\) が <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A> を呼び出すと、関連する別の昇格可能参加リストがあるため、呼び出しが失敗します。このため、CN2 は、DTC トランザクションを取得して、SQL に渡す必要があります。これには、<xref:System.Transactions.TransactionInterop> クラスで提供されるメソッドの 1 つを使用して、SQL に渡すことができるトランザクションの形式を生成します。  
+  
+3.  <xref:System.Transactions> は、CN1 によって実装された <xref:System.Transactions.ITransactionPromoter> インターフェイス上で、<xref:System.Transactions.ITransactionPromoter.Promote%2A> メソッドを呼び出します。  
+  
+4.  この時点で CN1 は、SQL 2005 固有のメカニズムと <xref:System.Data> を使用して、トランザクションをエスカレートします。  
+  
+5.  <xref:System.Transactions.ITransactionPromoter.Promote%2A> メソッドからの戻り値は、トランザクションの反映トークンを含むバイト配列です。<xref:System.Transactions> は、この反映トークンを使用して、ローカル トランザクションに組み込むことができる DTC トランザクションを作成します。  
+  
+6.  この時点で CN2 は、<xref:System.Transactions.TransactionInterop> によるメソッドの 1 つを呼び出すことで受信したデータを使用して、SQL にトランザクションを渡すことができます。  
+  
+7.  ここで、両方が DTC 分散トランザクションに参加します。  
+  
+## 単一フェーズ コミットの最適化  
+ 単一フェーズ コミット プロトコルは、すべての更新が明示的な調整なしに行われるため、実行時に、より効率的です。この最適化を活用するには、リソースの <xref:System.Transactions.ISinglePhaseNotification> インターフェイスを使用してリソース マネージャーを実装し、<xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドまたは <xref:System.Transactions.Transaction.EnlistVolatile%2A> メソッドを使用してトランザクションに参加する必要があります。特に、単一フェーズ コミットを確実に実行するには、*EnlistmentOptions* パラメーターを <xref:System.Transactions.EnlistmentOptions> と同じにする必要があります。  
+  
+ <xref:System.Transactions.ISinglePhaseNotification> インターフェイスは <xref:System.Transactions.IEnlistmentNotification> インターフェイスから派生するため、RM が単一フェーズ コミットを実行できない場合でも、2 フェーズ コミット通知を受信できます。RM が TM から <xref:System.Transactions.ISinglePhaseNotification.SinglePhaseCommit%2A> 通知を受信した場合は、コミットするために必要な作業を実行する必要があります。そして、それに応じて <xref:System.Transactions.SinglePhaseEnlistment> パラメーター上の <xref:System.Transactions.SinglePhaseEnlistment.Committed%2A>、<xref:System.Transactions.SinglePhaseEnlistment.Aborted%2A>、または <xref:System.Transactions.SinglePhaseEnlistment.InDoubt%2A> メソッドを呼び出すことにより、トランザクションのコミットまたはロールバックのどちらが実行されるかを、トランザクション マネージャーに通知する必要があります。この段階で、参加リストの <xref:System.Transactions.Enlistment.Done%2A> の応答は、ReadOnly セマンティクスを意味します。したがって、他のメソッドに加えて、<xref:System.Transactions.Enlistment.Done%2A> を応答しないでください。  
+  
+ 揮発性参加リストが 1 つだけ存在し、永続参加リストが存在しない場合は、揮発性参加リストが SPC 通知を受信します。揮発性リストが複数、永続参加リストが 1 つだけ存在する場合は、揮発性参加リストが 2PC を受信します。完了すると、永続参加リストが SPC を受信します。  
+  
+## 参照  
+ [参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)   
+ [単一フェーズおよび複数フェーズでのトランザクションのコミット ](../../../../docs/framework/data/transactions/committing-a-transaction-in-single-phase-and-multi-phase.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/performing-recovery.md b/docs/framework/data/transactions/performing-recovery.md
new file mode 100644
index 00000000000..4769e7b3dbb
--- /dev/null
+++ b/docs/framework/data/transactions/performing-recovery.md
@@ -0,0 +1,39 @@
+---
+title: "回復の実行  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6dd17bf6-ba42-460a-a44b-8046f52b10d0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 回復の実行 
+リソース マネージャーは、リソース障害の後にトランザクション参加要素を再参加させることにより、トランザクションの永続参加リストの解決を容易にします。  
+  
+## 回復プロセス  
+ 後で回復できるリソースを永続的に参加させるには \(<xref:System.Transactions.IEnlistmentNotification> インターフェイスの実装により記述\)、<xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドを呼び出す必要があります。さらに、リソース障害発生時にトランザクションの参加要素に一貫したラベル付けを行うためのリソース マネージャー識別子 \(<xref:System.Guid>\) を <xref:System.Transactions.Transaction.EnlistDurable%2A> メソッドに提供する必要があります。このため、最初の Enlist 呼び出し時に提供される <xref:System.Guid> は、回復中の <xref:System.Transactions.TransactionManager.Reenlist%2A> 呼び出しの *resourceManagerIdentifier* パラメーターと同じである必要があります。そうでない場合、<xref:System.Transactions.TransactionException> がスローされます。永続参加リストの詳細については、「[参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)」を参照してください。  
+  
+ 2PC プロトコルの準備フェーズ \(フェーズ 1\) で、永続的リソース マネージャーの実装が <xref:System.Transactions.IEnlistmentNotification.Prepare%2A> 通知を受け取った場合、このフェーズ中にその準備レコードをログに記録する必要があります。このレコードには、コミット時にトランザクションを完了するために必要なすべての情報を含める必要があります。*preparingEnlistment* コールバックの <xref:System.Transactions.PreparingEnlistment.RecoveryInformation%2A> プロパティを取得することにより、後で回復中に準備レコードにアクセスできます。<xref:System.Transactions.IEnlistmentNotification.Prepare%2A> メソッド内でレコードのログ記録を実行する必要はありません。RM がワーカー スレッド上でこの処理を実行できるためです。  
+  
+ 回復プロセスは、次の 2 つの手順から構成されます。  
+  
+### 手順 1 \- 再参加  
+ リソース マネージャーは、不明な各参加の準備情報レコードについて調べます。そのためには、フェーズ 1 の <xref:System.Transactions.IEnlistmentNotification.Prepare%2A> 通知でリソース マネージャーに渡された <xref:System.Transactions.PreparingEnlistment> コールバックの <xref:System.Transactions.PreparingEnlistment.RecoveryInformation%2A> プロパティを調べます。  
+  
+ 対象の各参加について、トランザクション マネージャーで <xref:System.Transactions.TransactionManager.Reenlist%2A> を呼び出します。このメソッドは、リソース マネージャーを識別する一意の <xref:System.Guid> と、バイト配列の参加情報を渡します。新しい <xref:System.Transactions.Enlistment> オブジェクトが返されます。再参加が失敗して例外がスローされた場合、リソース マネージャーは後で再試行する必要があります。  
+  
+ 失敗後にリソース マネージャーを再起動するときは、<xref:System.Transactions.TransactionManager.Reenlist%2A> メソッドのみを呼び出す必要があります。また、2 フェーズ コミットの最初の準備フェーズ中に、リソース マネージャーによってログ記録された未解決トランザクションのみを再参加させる必要があります。無効な時間にこのメソッドを呼び出した場合、間違った結果が生成される可能性があります。  
+  
+ 参加要素がこのメソッドを使用して再参加すると、トランザクションの結果に対応した <xref:System.Transactions.IEnlistmentNotification> のフェーズ 2 のメソッド \(つまり、<xref:System.Transactions.IEnlistmentNotification.Commit%2A>、<xref:System.Transactions.IEnlistmentNotification.Rollback%2A>、または <xref:System.Transactions.IEnlistmentNotification.InDoubt%2A>\) が必要に応じて呼び出されます。  
+  
+### 手順 2 \- 回復の完了  
+ すべての再参加が完了すると、リソース マネージャーは <xref:System.Transactions.TransactionManager.RecoveryComplete%2A> メソッドを呼び出します。このメソッドは回復を完了し、リソース マネージャーに不明なトランザクションがもう存在しないことをトランザクション マネージャーに通知します。これによりリソース マネージャーは、再び <xref:System.Transactions.TransactionManager.Reenlist%2A> メソッドを呼び出さないことを保証します。  
+  
+ リソース マネージャーは、新しいトランザクションに参加する前に、不明なトランザクションをすべて解決する必要はありません。リソース マネージャーは、トランザクション マネージャーとの関係を確立した後、いつでも最初の手順を実行できますが、<xref:System.Transactions.TransactionManager.RecoveryComplete%2A> が呼び出された \(手順 2\) 後で、手順 1 を再実行することはできません。手順 2 は、トランザクションの結果に影響を与えることなく、複数回繰り返すことができます。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/security-trust-levels-in-accessing-resources.md b/docs/framework/data/transactions/security-trust-levels-in-accessing-resources.md
new file mode 100644
index 00000000000..e3c1d7f1aa3
--- /dev/null
+++ b/docs/framework/data/transactions/security-trust-levels-in-accessing-resources.md
@@ -0,0 +1,70 @@
+---
+title: "リソースへのアクセスでのセキュリティ信頼レベル  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb5be924-317d-4d69-b33a-3d18ecfb9d6e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# リソースへのアクセスでのセキュリティ信頼レベル 
+ここでは、<xref:System.Transactions> が公開するリソースの種類に対して、アクセスがどのように制限されるかについて説明します。  
+  
+ <xref:System.Transactions> には、主に 3 つの信頼レベルがあります。信頼レベルは、<xref:System.Transactions> が公開するリソースの種類と、そのリソースにアクセスするために必要な信頼レベルに基づいて定義されます。<xref:System.Transactions> がアクセスを提供するリソースは、システム メモリ、プロセス全体の共有リソース、およびシステム全体のリソースです。次のようなレベルがあります。  
+  
+-   単一のアプリケーション ドメイン内のトランザクションを使用するアプリケーション用の **AllowPartiallyTrustedCallers** \(APTCA\)。  
+  
+-   分散トランザクションを使用するアプリケーション用の **DistributedTransactionPermission** \(DTP\)。  
+  
+-   永続性リソース、構成管理アプリケーション、およびレガシ相互運用アプリケーション用の完全信頼。  
+  
+> [!NOTE]
+>  偽装されたコンテキストで参加インターフェイスを呼び出さないでください。  
+  
+## 信頼レベル  
+  
+### APTCA \(部分的信頼\)  
+ <xref:System.Transactions> アセンブリは、**AllowPartiallyTrustedCallers** 属性 \(APTCA\) でマークされているため、部分的に信頼されているコードから呼び出すことができます。この属性は基本的に、**FullTrust** アクセス許可セットの暗黙的な <xref:System.Security.Permissions.SecurityAction> を削除します。削除しない場合、これは各種類のパブリックにアクセスできるメソッドに自動的に配置されます。ただし、種類やメンバーによっては、さらに強力なアクセス許可が必要となります。  
+  
+ APTCA 属性により、アプリケーションは単一のアプリケーション ドメイン内で、部分的に信頼してトランザクションを使用できます。これにより、エラー処理で使用できる非エスカレーション トランザクションと揮発性の参加リストが有効になります。こうした例の 1 つが、トランザクション処理されたハッシュ テーブルとそれを使用するアプリケーションです。単一トランザクション下で、ハッシュ テーブルに対してデータを追加および削除できます。トランザクションが後でロール バックされた場合、そのトランザクション下でハッシュ テーブルに加えられたすべての変更を元に戻すことができます。  
+  
+### DTP \(DistributedTransactionPermission\)  
+ MSDTC で管理されるように <xref:System.Transactions> トランザクションがエスカレーションされた場合、<xref:System.Transactions> は分散トランザクションを作成するために <xref:System.Transactions.DistributedTransactionPermission> \(DTP\) を要求します。これは、\(シリアル化や追加の永続参加リストなどを介して\) トランザクションをエスカレーションするコードに DTP を付与する必要があることを意味します。<xref:System.Transactions> トランザクションを最初に作成したコードでは、このアクセス許可を必ずしも所有する必要はありません。  
+  
+### FullTrust リンク要求  
+ このアクセス許可レベルは、永続性リソースに書き込むアプリケーションを制限することを目的としています。エラー発生時に、アプリケーションはトランザクション マネージャーにより回復し、トランザクションの最終結果を判定して永続的なデータを更新できるようにする必要があります。この種類のアプリケーションは、永続的リソース マネージャーと呼ばれています。この種類のアプリケーションの典型的な例が SQL です。  
+  
+ 回復を有効にするため、この種類のアプリケーションにはシステム リソースを永続的に消費する機能があります。これは、トランザクションに参加しているすべての永続的リソース マネージャーが結果を受信したことを確認するまで、回復可能なトランザクション マネージャーはコミットしたトランザクションを記憶する必要があるためです。したがって、この種類のアプリケーションには完全な信頼が必要です。完全な信頼レベルが付与されない限り、実行しないでください。  
+  
+ 永続参加リストと回復の詳細については、「[参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)」および「[回復の実行 ](../../../../docs/framework/data/transactions/performing-recovery.md)」を参照してください。  
+  
+ COM\+ とのレガシ相互運用を実行するアプリケーションにも、完全な信頼が必要です。  
+  
+ 以下に示す型とメンバーは、**FullTrust** 宣言セキュリティ属性で装飾されているため、部分的に信頼されたコードで呼び出すことはできません。  
+  
+ `PermissionSetAttribute(SecurityAction.LinkDemand, Name := "FullTrust")`  
+  
+-   <xref:System.Transactions.Transaction.EnlistDurable%2A?displayProperty=fullName>  
+  
+-   <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A>  
+  
+-   <xref:System.Transactions.TransactionInterop>  
+  
+-   <xref:System.Transactions.TransactionManager.DistributedTransactionStarted>  
+  
+-   <xref:System.Transactions.HostCurrentTransactionCallback>  
+  
+-   <xref:System.Transactions.TransactionManager.Reenlist%2A>  
+  
+-   <xref:System.Transactions.TransactionManager.RecoveryComplete%2A>  
+  
+-   <xref:System.Transactions.TransactionScope.%23ctor%28System.Transactions.TransactionScopeOption%2CSystem.Transactions.TransactionOptions%2CSystem.Transactions.EnterpriseServicesInteropOption%29>  
+  
+ これらの型やメソッドを使用するために設定された **FullTrust** アクセス許可を所有する必要があるのは、直前の呼び出し元のみです。
\ No newline at end of file
diff --git a/docs/framework/data/transactions/transaction-fundamentals.md b/docs/framework/data/transactions/transaction-fundamentals.md
new file mode 100644
index 00000000000..5eea9eebac7
--- /dev/null
+++ b/docs/framework/data/transactions/transaction-fundamentals.md
@@ -0,0 +1,33 @@
+---
+title: "トランザクションの基盤  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 353f4ee2-e6bf-4b1c-b1c8-385fc8a486c0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# トランザクションの基盤 
+トランザクションとは、複数のタスクを互いに結合したものです。たとえば、あるアプリケーションが 2 つのタスクを実行するものとします。まず、このアプリケーションはデータベースに新しいテーブルを作成します。次に、データを収集、フォーマットし、新しく作成したテーブルに挿入する特定のオブジェクトを呼び出します。この 2 つのタスクは、単に関連しているだけでなく、相互に依存しており、たとえば、新しいテーブルにデータを格納できなければ新しいテーブルを作成しないようにできます。単一のトランザクションのスコープ内でこの 2 つのタスクを実行すると、両タスク間の結合が行われます。第 2 のタスクが失敗すると、新しいテーブルの作成以前の時点まで第 1 のタスクがロールバックされます。  
+  
+ 動作を予測できるようにするため、すべてのトランザクションは基本 ACID プロパティ \(atomic、consistent、isolated、および durable\) を持つ必要があります。これらのプロパティは、ミッション クリティカルなトランザクションの役割を悉無律型の命題として規定します。ACID の詳細については、「[ACID プロパティ](http://go.microsoft.com/fwlink/?LinkId=98791)」を参照してください。要約すると、ACID を使用すれば、一連の関連タスクを 1 つの単位として成功または失敗させることができます。トランザクション処理の用語でいえば、トランザクションはコミットされるか中止されるかのいずれかである、ということになります。トランザクションをコミットするためには、すべての参加要素が、データに対する変更は永続化されるということを保証する必要があります。システム クラッシュその他の予期しない出来事が発生した場合でも、変更は保持されます。この保証を履行しない参加要素が 1 つでもあると、トランザクション全体が失敗します。そのトランザクションのスコープ内でのデータに対するすべての変更が、特定の時点までロールバックされます。  
+  
+ トランザクションは、データベースやメッセージ キューなどの単一のデータ リソースに収容することができます。このシナリオでは、ローカル トランザクションは、パフォーマンスを向上させる <xref:System.Transactions> が提供するトランザクション マネージャーによって管理されます。これらのトランザクションは、データ リソースによって制御されるため、効率的で管理しやすくなっています。  
+  
+ さらに、トランザクションは複数のデータ リソースにまたがることもできます。分散トランザクションにより、さまざまなシステムで発生する複数の異なる操作を、単一の成功または失敗操作に統合することができます。このシナリオでは、トランザクションは、各システムに常駐する Microsoft 分散トランザクション コーディネーター \(MSDTC\) によって調整されます。  
+  
+ <xref:System.Transactions> の提供するクラスを使用してトランザクション アプリケーションを開発する際は、必要なトランザクションの種類や関連するトランザクション マネージャーを気にする必要はありません。<xref:System.Transactions> インフラストラクチャが自動的にこれらを管理します。  
+  
+ トランザクションの作成時に、トランザクションに適用する分離レベルを指定できます。分離レベルは <xref:System.Transactions.IsolationLevel> クラスによって定義されます。分離レベルにより、特定のトランザクションの影響を受けるデータに対して他のトランザクションが持つアクセス レベルが決定されます。  
+  
+ トランザクションの作成には、ADO.NET、<xref:System.EnterpriseServices>、または <xref:System.Transactions> 名前空間が提供する新しいトランザクション プログラミング モデルを使用できます。<xref:System.Transactions> 名前空間を使用してトランザクション アプリケーションを作成する際に使用できる機能については、「[System.Transactions で提供される機能 ](../../../../docs/framework/data/transactions/features-provided-by-system-transactions.md)」を参照してください。  
+  
+## 参照  
+ [System.Transactions で提供される機能 ](../../../../docs/framework/data/transactions/features-provided-by-system-transactions.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/transaction-management-escalation.md b/docs/framework/data/transactions/transaction-management-escalation.md
new file mode 100644
index 00000000000..701777c2726
--- /dev/null
+++ b/docs/framework/data/transactions/transaction-management-escalation.md
@@ -0,0 +1,43 @@
+---
+title: "トランザクション管理エスカレーション  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e96331e-31b6-4272-bbbd-29ed1e110460
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# トランザクション管理エスカレーション 
+Windows は、トランザクション マネージャーを構成する一連のサービスとモジュールをホストします。トランザクション管理のエスカレーションとは、トランザクション マネージャーのいずれかのコンポーネントから別のコンポーネントにトランザクションを移行するプロセスを表します。  
+  
+ <xref:System.Transactions> には、最大で 1 つの永続的なリソースまたは複数の揮発性リソースが関与するトランザクションを調整する、トランザクション マネージャー コンポーネントが含まれています。トランザクション マネージャーは、アプリケーション内ドメインの呼び出しのみを使用するため、最良のパフォーマンスを得られます。開発者は、トランザクション マネージャーを直接操作する必要はありません。その代わり、インターフェイス、共通する動作、およびヘルパー クラスを定義する共通インフラストラクチャが、<xref:System.Transactions> 名前空間によって用意されています。  
+  
+ 同じコンピューターにある別のアプリケーション ドメイン \(プロセスやマシンの境界をまたぐドメインを含む\) の別のオブジェクトにトランザクションを提供する場合は、<xref:System.Transactions> インフラストラクチャは、トランザクションを自動的にエスカレートして、Microsoft 分散トランザクション コーディネーター \(MSDTC\) によって管理されるようにします。エスカレーションは、別の永続的なリソース マネージャーに参加する際にも発生します。エスカレートされると、トランザクションは完了するまで昇格した状態で管理され続けます。  
+  
+ <xref:System.Transactions> トランザクションと MSDTC トランザクションの間には、PSPE \(Promotable Single Phase Enlistment\) を介して利用できる中間タイプのトランザクションがあります。PSPE は、<xref:System.Transactions> でパフォーマンスを最適化するための重要なメカニズムです。PSPE を使用すると、異なるアプリケーション ドメイン、プロセス、コンピューターにあるリモート永続リソースが、MSDTC トランザクションにエスカレートされることなく、<xref:System.Transactions> トランザクションに参加できるようになります。PSPE の詳細については、「[参加要素としてのリソースのトランザクションへの参加 ](../../../../docs/framework/data/transactions/enlisting-resources-as-participants-in-a-transaction.md)」を参照してください。  
+  
+## エスカレーションの開始方法  
+ トランザクションのエスカレーションが行われると、パフォーマンスが低下します。MSDTC は別のプロセスにあるため、トランザクションを MSDTC にエスカレートすると、プロセス間でメッセージが送信されることになるからです。パフォーマンスを向上させるには、MSDTC へのエスカレーションを遅延または回避します。このため、エスカレーションが開始される方法とその条件を知る必要があります。  
+  
+ <xref:System.Transactions> インフラストラクチャが揮発性リソースと、単一フェーズの通知をサポートする最大 1 つの永続リソースを処理している限り、トランザクションは、<xref:System.Transactions> インフラストラクチャが所有し続けます。トランザクション マネージャーが有効であるのは、同じアプリケーション ドメインに存在し、ログ \(トランザクション結果のディスクへの書き込み\) が必要ないリソースに対してのみです。次の場合には、<xref:System.Transactions> インフラストラクチャにより、トランザクションの所有権が MSDTC に移されます。  
+  
+-   単一フェーズ通知をサポートしない永続リソースが少なくとも 1 つトランザクションに参加している場合。  
+  
+-   単一フェーズ通知をサポートする永続リソースが少なくとも 2 つトランザクションに参加している場合。たとえば、[!INCLUDE[sqprsqlong](../../../../includes/sqprsqlong-md.md)] との単一の接続の参加では、トランザクションの昇格は発生しません。ただし、[!INCLUDE[sqprsqlong](../../../../includes/sqprsqlong-md.md)] データベースへの別の接続を開き、それによってデータベースが参加したときは常に、<xref:System.Transactions> インフラストラクチャが、このトランザクションの 2 つ目の永続リソースであることを検出し、MSDTC トランザクションにエスカレートします。  
+  
+-   別のアプリケーション ドメインまたはプロセスにトランザクションを "マーシャリング" する要求が呼び出された場合。たとえば、アプリケーション ドメイン境界をまたぐトランザクション オブジェクトのシリアル化などです。トランザクション オブジェクトは、値によってマーシャリングされます。つまり、アプリケーション ドメイン境界を越えてトランザクション オブジェクトを渡そうとすると \(同じプロセス内でも\)、トランザクション オブジェクトのシリアル化が発生します。<xref:System.Transactions.Transaction> をパラメーターとして受け取るリモート メソッドを呼び出すことで、トランザクション オブジェクトを渡すことができます。または、リモートのトランザクション サービス コンポーネントにアクセスすることもできます。この場合、トランザクション オブジェクトがシリアル化され、エスカレーションが発生します。アプリケーション ドメインをまたいでトランザクションがシリアル化される場合と同様です。トランザクションが分散されるので、ローカルのトランザクション マネージャーでは不十分になります。  
+  
+ エスカレーション中にスローされる可能性のある例外をすべて次の表に示します。  
+  
+|例外の種類|条件|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|分離レベルが <xref:System.Transactions.IsolationLevel> のトランザクションをエスカレートしようとしました。|  
+|<xref:System.Transactions.TransactionAbortedException>|トランザクション マネージャーがダウンしています。|  
+|<xref:System.Transactions.TransactionException>|エスカレーションが失敗し、アプリケーションが中止されます。|
\ No newline at end of file
diff --git a/docs/framework/data/transactions/using-system-transactions-in-aspnet.md b/docs/framework/data/transactions/using-system-transactions-in-aspnet.md
new file mode 100644
index 00000000000..f60ed4b3f71
--- /dev/null
+++ b/docs/framework/data/transactions/using-system-transactions-in-aspnet.md
@@ -0,0 +1,71 @@
+---
+title: "ASP.NET での System.Transactions の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1982c300-7ea6-4242-95ed-dc28ccfacac9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ASP.NET での System.Transactions の使用
+ここでは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーション内で <xref:System.Transactions> を正しく使用する方法について説明します。  
+  
+## ASP.NET での DistributedTransactionPermission の有効化  
+ <xref:System.Transactions> は、部分的に信頼された呼び出し側をサポートしており、**AllowPartiallyTrustedCallers** 属性 \(APTCA\) を使用してマークされます。<xref:System.Transactions> の信頼レベルは、<xref:System.Transactions> が公開するリソースの種類 \(システム メモリ、共有プロセス全体のリソース、システム全体のリソース、その他のリソースなど\)、およびそれらのリソースにアクセスするのに必要な信頼レベルに基づいて定義されます。 部分的に信頼された環境では、<xref:System.Transactions.DistributedTransactionPermission> が付与されていない限り、完全に信頼されていないアセンブリは、アプリケーション ドメイン内でのみトランザクションを使用できます \(この場合、保護されている唯一のリソースはシステム メモリです\)。  
+  
+ Microsoft 分散トランザクション コーディネーター \(MSDTC\) で管理されるようトランザクション管理がエスカレートされるたびに、<xref:System.Transactions.DistributedTransactionPermission> が要求されます。 この種のシナリオでは、プロセス全体のリソースと特にグローバルなリソースを使用します。グローバルなリソースは、MSDTC ログで予約されたスペースです。 この使用方法の例として、データベース、または供給するサービスの一部としてデータベースを使用するアプリケーションへの Web フロントエンドがあります。  
+  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] は、独自の信頼レベル セットを持ち、ポリシー ファイルを介して特定のアクセス許可セットを、これらの信頼レベルに関連付けます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [ASP.NET Trust Levels and Policy Files](../Topic/ASP.NET%20Trust%20Levels%20and%20Policy%20Files.md)。 Windows SDK を最初にインストールした時点では、既定の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ポリシー ファイルは <xref:System.Transactions.DistributedTransactionPermission> に関連付けられていません。 そのため、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションのトランザクションが MSDTC によって管理されるようにエスカレートされると、<xref:System.Transactions.DistributedTransactionPermission> を要求した時点で、<xref:System.Security.SecurityException> によりエスカレーションが失敗します。 部分的に信頼された [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の環境でトランザクションのエスカレーションを有効にするには、<xref:System.Data.SqlClient.SqlClientPermission> と同じ既定の信頼レベルで、<xref:System.Transactions.DistributedTransactionPermission> を付与する必要があります。 これをサポートする独自のカスタム信頼レベルとポリシー ファイルを構成するか、既定のポリシー ファイルである **Web\_hightrust.config** および **Web\_mediumtrust.config** を変更できます。  
+  
+ ポリシー ファイルを変更するには、System.Transactions について、**DistributedTransactionPermission** の **SecurityClass** 要素を **PolicyLevel** 要素の下の **SecurityClasses** 要素に追加し、さらに [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] **NamedPermissionSet** の下の対応する **IPermission** 要素を追加します。 次の構成ファイルに、この例を示します。  
+  
+```  
+<SecurityClasses>  
+   <SecurityClass Name="DistributedTransactionPermission" Description="System.Transactions.DistributedTransactionPermission, System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
+...  
+</SecurityClasses>  
+  
+<PermissionSet  
+  class="NamedPermissionSet"  
+  version="1"  
+  Name="ASP.Net">  
+     <IPermission  
+        class="System.Transactions.DistributedTransactionPermission, System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"  
+        version="1"  
+        Unrestricted="true"  
+     />  
+...  
+</PermissionSet>  
+  
+```  
+  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] のセキュリティ ポリシーの[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[securityPolicy 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/469d8d22-d263-46bb-8400-40d8d027faba)」を参照してください。  
+  
+## 動的コンパイル  
+ アクセス時に動的にコンパイルされる [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションで <xref:System.Transactions> をインポートして使用する場合、構成ファイルに <xref:System.Transactions> アセンブリへの参照を配置する必要があります。 具体的には、既定のルートの **Web.config** 構成ファイル、または特定の Web アプリケーションの構成ファイルの **compilation**\/**assemblies** セクションに、この参照を追加する必要があります。 次に例を示します。  
+  
+```  
+<configuration>  
+   <system.web>  
+      <compilation>  
+         <assemblies>  
+      <add assembly="System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+         </assemblies>  
+      </compilation>  
+   </system.web>  
+</configuration>  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [compilation の assemblies の add 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/602197e8-108d-4249-b752-ba2a318f75e4)」を参照してください。  
+  
+## 参照  
+ [ASP.NET Trust Levels and Policy Files](../Topic/ASP.NET%20Trust%20Levels%20and%20Policy%20Files.md)   
+ [securityPolicy 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/469d8d22-d263-46bb-8400-40d8d027faba)   
+ [トランザクション管理エスカレーション ](../../../../docs/framework/data/transactions/transaction-management-escalation.md)
\ No newline at end of file
diff --git a/docs/framework/data/transactions/writing-a-transactional-application.md b/docs/framework/data/transactions/writing-a-transactional-application.md
new file mode 100644
index 00000000000..8bbe8bcd30a
--- /dev/null
+++ b/docs/framework/data/transactions/writing-a-transactional-application.md
@@ -0,0 +1,48 @@
+---
+title: "トランザクション アプリケーションの作成  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4d891f2-6fc8-4395-93c6-6819492406e0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# トランザクション アプリケーションの作成 
+トランザクション アプリケーションのプログラマは、<xref:System.Transactions> 名前空間に用意されている 2 つのプログラミング モデルを活用して、トランザクションを作成できます。<xref:System.Transactions.Transaction> クラスを使用した明示的なプログラミング モデルを使用できるほか、<xref:System.Transactions.TransactionScope> クラスを使用して、トランザクションが自動的にインフラストラクチャによって管理される暗黙的なプログラミング モデルも利用できます。開発では、暗黙的なトランザクション モデルを使用することをお勧めします。トランザクション スコープの使用方法については、「[トランザクション スコープを使用した暗黙的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md)」を参照してください。  
+  
+ 両モデルとも、プログラムが整合性の取れた状態に達した時点で、トランザクションのコミットをサポートします。コミットが成功すると、トランザクションは永続的にコミットされます。コミットが失敗すると、トランザクションは中止されます。アプリケーション プログラムがトランザクションを完了できない場合は、トランザクションを中止してその処理内容を取り消すことを試みます。  
+  
+## このセクションの内容  
+  
+### トランザクションの作成  
+ <xref:System.Transactions> 名前空間には、トランザクションを作成する 2 つのモデルが用意されています。これらのモデルは、以下のトピックで取り上げられています。  
+  
+ [トランザクション スコープを使用した暗黙的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-implicit-transaction-using-transaction-scope.md)  
+  
+ <xref:System.Transactions> 名前空間がサポートする、<xref:System.Transactions.TransactionScope> クラスを使用した暗黙的なトランザクションの作成について説明します。  
+  
+ [CommittableTransaction を使用した明示的なトランザクションの実装 ](../../../../docs/framework/data/transactions/implementing-an-explicit-transaction-using-committabletransaction.md)  
+  
+ <xref:System.Transactions> 名前空間がサポートする、<xref:System.Transactions.CommittableTransaction> クラスを使用した明示的なトランザクションの作成について説明します。  
+  
+### トランザクション管理のエスカレート  
+ トランザクションが別のアプリケーション ドメインにあるリソースにアクセスする必要がある場合、または別の永続的なリソース マネージャーに参加する場合は、トランザクションが MSDTC によって管理されるよう自動的にエスカレートされます。トランザクションのエスカレーションの詳細については、「[トランザクション管理エスカレーション ](../../../../docs/framework/data/transactions/transaction-management-escalation.md)」を参照してください。  
+  
+### 同時実行  
+ 「[DependentTransaction の同時実行の管理 ](../../../../docs/framework/data/transactions/managing-concurrency-with-dependenttransaction.md)」では、<xref:System.Transactions.DependentTransaction> クラスを使用して、非同期タスク間で同時実行を実現する方法について説明します。  
+  
+### COM\+ 相互運用  
+ 「[Enterprise Services と COM\+ トランザクションの相互運用性 ](../../../../docs/framework/data/transactions/interoperability-with-enterprise-services-and-com-transactions.md)」では、分散トランザクションを COM\+ トランザクションと連係させる方法について説明します。  
+  
+### 診断  
+ 「[診断トレース ](../../../../docs/framework/data/transactions/diagnostic-traces.md)」では、<xref:System.Transactions> インフラストラクチャによって生成されるトレース コードを使用して、アプリケーションのエラーをトラブルシューティングする方法について説明します。  
+  
+### ASP.NET 内での使用  
+ 「[ASP.NET での System.Transactions の使用](../../../../docs/framework/data/transactions/using-system-transactions-in-aspnet.md)」では、ASP.NET アプリケーション内で <xref:System.Transactions> を正しく使用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/data/wcf/TOC.md b/docs/framework/data/wcf/TOC.md
new file mode 100644
index 00000000000..b689af1edeb
--- /dev/null
+++ b/docs/framework/data/wcf/TOC.md
@@ -0,0 +1,73 @@
+# [方法: Entity Framework プロバイダーでフィードをカスタマイズする](how-to-customize-feeds-with-ef-provider-wcf-data-services.md)
+# [方法: IIS 上で実行する WCF Data Service を開発する](how-to-develop-a-wcf-data-service-running-on-iis.md)
+# [オブジェクトの具体化](object-materialization-wcf-data-services.md)
+# [ストリーミング プロバイダー](streaming-provider-wcf-data-services.md)
+# [リフレクション プロバイダー](reflection-provider-wcf-data-services.md)
+# [カスタム データ サービス プロバイダー](custom-data-service-providers-wcf-data-services.md)
+# [リソース](wcf-data-services-resources.md)
+# [方法: データ サービス クエリにクエリ オプションを追加する](how-to-add-query-options-to-a-data-service-query-wcf-data-services.md)
+# [方法: 既存のエンティティを DataServiceContext にアタッチする](attach-an-existing-entity-to-dc-wcf-data.md)
+# [データ サービスのバージョン管理](data-service-versioning-wcf-data-services.md)
+# [インターセプター](interceptors-wcf-data-services.md)
+# [方法 : サービス操作を定義する](how-to-define-a-service-operation-wcf-data-services.md)
+# [サービスとしてのデータの公開](exposing-your-data-as-a-service-wcf-data-services.md)
+# [方法: Windows Presentation Foundation 要素にデータをバインドする](bind-data-to-wpf-elements-wcf-data-services.md)
+# [LINQ に関する留意点](linq-considerations-wcf-data-services.md)
+# [方法: エンティティ リレーションシップを定義する](how-to-define-entity-relationships-wcf-data-services.md)
+# [概要](getting-started-with-wcf-data-services.md)
+# [方法: ページングされた結果を読み込む](how-to-load-paged-results-wcf-data-services.md)
+# [方法: クライアント データ サービス クラスを手動で生成する](how-to-manually-generate-client-data-service-classes-wcf-data-services.md)
+# [データ サービスのホスティング](hosting-the-data-service-wcf-data-services.md)
+# [コントロールへのデータのバインド](binding-data-to-controls-wcf-data-services.md)
+# [バイナリ データの操作](working-with-binary-data-wcf-data-services.md)
+# [クエリ射影](query-projections-wcf-data-services.md)
+# [データ サービス プロバイダー](data-services-providers-wcf-data-services.md)
+# [方法: エンティティを追加、変更、および削除する](how-to-add-modify-and-delete-entities-wcf-data-services.md)
+# [WCF Data Service クライアント ユーティリティ (DataSvcUtil.exe)](wcf-data-service-client-utility-datasvcutil-exe.md)
+# [方法: データ サービスの結果のページングを有効にする](how-to-enable-paging-of-data-service-results-wcf-data-services.md)
+# [WCF Data Services のセキュリティ保護](securing-wcf-data-services.md)
+# [OData サービスを利用する Windows ストア アプリの開発](writing-a-windows-store-app-that-consumes-an-odata-service.md)
+# [データ サービス リソースへのアクセス](accessing-data-service-resources-wcf-data-services.md)
+# [バッチ処理](batching-operations-wcf-data-services.md)
+# [クライアント アプリケーションでのデータ サービスの使用](using-a-data-service-in-a-client-application-wcf-data-services.md)
+# [方法: 非同期データ サービス クエリを実行する](how-to-execute-asynchronous-data-service-queries-wcf-data-services.md)
+# [方法: 非同期 Windows Presentation Framework アプリケーションを作成する](create-an-asynchronous-wpf-application-wcf-data-services.md)
+# [データ サービスのクエリ](querying-the-data-service-wcf-data-services.md)
+# [アプリケーション シナリオ](application-scenarios-wcf-data-services.md)
+# [クイック スタート](quickstart-wcf-data-services.md)
+# [概要](wcf-data-services-overview.md)
+# [WCF Data Services 4.5](index.md)
+# [方法: リフレクション プロバイダーを使用してデータ サービスを作成する](create-a-data-service-using-rp-wcf-data-services.md)
+# [WCF Data Services プロトコル実装の詳細](wcf-data-services-protocol-implementation-details.md)
+# [方法: 関連エンティティを読み込む](how-to-load-related-entities-wcf-data-services.md)
+# [方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](create-a-data-service-using-an-adonet-ef-data-wcf.md)
+# [非同期操作](asynchronous-operations-wcf-data-services.md)
+# [WCF Data Services の開発と配置](developing-and-deploying-wcf-data-services.md)
+# [Entity Framework プロバイダー](entity-framework-provider-wcf-data-services.md)
+# [方法: データ サービス参照を追加する](how-to-add-a-data-service-reference-wcf-data-services.md)
+# [方法: データ サービス クエリを実行する](how-to-execute-data-service-queries-wcf-data-services.md)
+# [Web ブラウザーからサービスへのアクセス](accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)
+# [データ サービスの構成](configuring-the-data-service-wcf-data-services.md)
+# [サービス操作](service-operations-wcf-data-services.md)
+# [方法: クエリ結果を射影する](how-to-project-query-results-wcf-data-services.md)
+# [.NET Framework クライアント アプリケーションの作成](creating-the-dotnet-client-application-wcf-data-services-quickstart.md)
+# [方法: データ バインディングの動作をカスタマイズする](how-to-customize-data-binding-behaviors-wcf-data-services.md)
+# [方法: データ サービスへのアクセスを有効にする](how-to-enable-access-to-the-data-service-wcf-data-services.md)
+# [方法: クライアント要求のヘッダーを設定する](how-to-set-headers-in-the-client-request-wcf-data-services.md)
+# [方法: クエリをバッチで実行する](how-to-execute-queries-in-a-batch-wcf-data-services.md)
+# [方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](create-a-data-service-using-linq-to-sql-wcf.md)
+# [データ サービスの作成](creating-the-data-service.md)
+# [遅延コンテンツの読み込み](loading-deferred-content-wcf-data-services.md)
+# [データ サービス クライアント ライブラリの生成](generating-the-data-service-client-library-wcf-data-services.md)
+# [方法: データ サービス メッセージを先に取得する](how-to-intercept-data-service-messages-wcf-data-services.md)
+# [方法: プロジェクト データ ソースを使用してデータをバインドする](how-to-bind-data-using-a-project-data-source-wcf-data-services.md)
+# [WCF Data Services クライアント ライブラリ](wcf-data-services-client-library.md)
+# [サービス操作の呼び出し](calling-service-operations-wcf-data-services.md)
+# [方法: データ サービス要求のクライアント資格情報を指定する](specify-client-creds-for-a-data-service-request-wcf.md)
+# [データ サービス コンテキストの管理](managing-the-data-service-context-wcf-data-services.md)
+# [アクションを使用してサーバー側の動作を実装する](using-actions-to-implement-server-side-behavior.md)
+# [フィードのカスタマイズ](feed-customization-wcf-data-services.md)
+# [WCF Data Services の定義](defining-wcf-data-services.md)
+# [方法: クエリで返されたエンティティの数を確認する](number-of-entities-returned-by-a-query-wcf.md)
+# [データ サービスの更新](updating-the-data-service-wcf-data-services.md)
+# [方法: リフレクション プロバイダーでフィードをカスタマイズする](how-to-customize-feeds-with-the-reflection-provider-wcf-data-services.md)
diff --git a/docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md b/docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md
new file mode 100644
index 00000000000..2aa607bfbd5
--- /dev/null
+++ b/docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md
@@ -0,0 +1,107 @@
+---
+title: "データ サービス リソースへのアクセス (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "概要, WCF Data Services"
+  - "データ サービスのクエリ [WCF Data Services]"
+  - "WCF Data Services, データへのアクセス"
+  - "WCF Data Services, 概要"
+  - "WCF Data Services, 照会"
+ms.assetid: 9665ff5b-3e3a-495d-bf83-d531d5d060ed
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# データ サービス リソースへのアクセス (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、URI でアドレス指定できるリソースを使用し、データをフィードとして公開する [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] をサポートしています。  これらのリソースは、[Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md) のエンティティとリレーションシップの規則に従って表現されます。  このモデルでは、エンティティはアプリケーション ドメイン内のデータの操作単位 \(データ型\) を表します \(顧客、注文、項目、製品など\)。  エンティティ データは、Representational State Transfer \(REST\) のセマンティクス \(特に、標準的な HTTP 動詞である GET、PUT、POST、および DELETE\) を使用してアクセスおよび変更できます。  
+  
+## リソースへの対処  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、データ モデルによって公開されたデータを、URI を使用してアドレス指定します。  たとえば、次の URI は Customers エンティティ セットであるフィードを返します。このフィードには、Customer エンティティ型のすべてのインスタンスのエントリが含まれています。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers  
+```  
+  
+ エンティティには、エンティティ キーという特別なプロパティがあります。  エンティティ キーは、エンティティ セット内の 1 つのエンティティを一意に識別するために使用されます。  そのため、エンティティ セット内のエンティティ型の特定のインスタンスのアドレスを指定できます。  たとえば、次の URI は、`ALFKI` のキー値のある Customer エンティティ型の特定のインスタンスのエントリを返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')  
+```  
+  
+ エンティティ インスタンスのプリミティブ プロパティおよび複合プロパティは、個別にアドレス指定することもできます。  たとえば、次の URI は特定の Customer の `ContactName` プロパティ値が含まれた XML 要素を返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName  
+```  
+  
+ 前の URI に `$value` エンドポイントを含めた場合、応答メッセージにはプリミティブ プロパティの値のみが返されます。  次の例では、XML 要素のない "Maria Anders" という文字列のみが返されます。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/ContactName/$value  
+```  
+  
+ エンティティ間のリレーションシップは、アソシエーションによってデータ モデル内で定義されます。  これらのアソシエーションによって、エンティティ インスタンスのナビゲーション プロパティを使用して関連エンティティをアドレス指定することが可能になります。  ナビゲーション プロパティは、単一の関連エンティティ \(多対一のリレーションシップの場合\) または関連エンティティのセット \(一対多のリレーションシップの場合\) のいずれかを返します。  たとえば、次の URI は、特定の Customer に関連付けられたすべての Orders のセットであるフィードを返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders  
+```  
+  
+ リレーションシップは通常は双方向であり、ナビゲーション プロパティのペアで表されます。  前の例で示したリレーションシップとは逆に、次の URI は特定の Order エンティティが属する Customer エンティティへの参照を返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/Customer  
+```  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、クエリ式の結果に基づいてリソースのアドレスを指定できます。  その結果、評価された式に基づいてリソースのセットをフィルターすることが可能になります。  たとえば、次の URI は、リソースをフィルターして特定の Customer に 1997 年 9 月 22 日以降に出荷された Orders だけを返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$filter=ShippedDate gt datetime'1997-09-22T00:00:00'  
+```  
+  
+ 詳細については、「[OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)」を参照してください。  
+  
+## System Query Options \(システム クエリ オプション\)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では一連のシステム クエリ オプションが定義されており、フィルター処理、並べ替え、ページングなど、リソースに対する従来のクエリ操作の実行に使用できます。  たとえば、次の URI は、郵便番号 \(postal code\) の末尾が `100` ではないすべての `Order` エンティティのセットを、関連する `Order_Detail` エンティティと共に返します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Orders?$filter=not endswith(ShipPostalCode,'100')&$expand=Order_Details&$orderby=ShipCity  
+```  
+  
+ 返されたフィードのエントリは、注文の ShipCity プロパティの値でも並べ替えられています。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、次の [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] システム クエリ オプションをサポートしています。  
+  
+|クエリ オプション|説明|  
+|---------------|--------|  
+|`$orderby`|返されるフィードのエンティティについて、既定の並べ替え順序を定義します。  次のクエリで返される Customers フィードは、国 \(County\) と都市 \(City\) で並べ替えられています。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Customers?$orderby=Country,City`<br /><br /> 詳細については、「[OData: OrderBy システム クエリ オプション \($orderby\)](http://go.microsoft.com/fwlink/?LinkId=186968)」を参照してください。|  
+|`$top`|返されるフィードに含まれるエンティティの数を指定します。  次の例では、最初の 10 件の顧客をスキップし、その次の 10 件を返します。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Customers?$skip=10&$top=10`<br /><br /> 詳細については、「[OData: Top システム クエリ オプション \($top\)](http://go.microsoft.com/fwlink/?LinkId=186969)」を参照してください。|  
+|`$skip`|フィードにエンティティを返し始めるまでにスキップするエンティティの数を指定します。  次の例では、最初の 10 件の顧客をスキップし、その次の 10 件を返します。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Customers?$skip=10&$top=10`<br /><br /> 詳細については、「[OData: Skip システム クエリ オプション \($skip\)](http://go.microsoft.com/fwlink/?LinkId=186971)」を参照してください。|  
+|`$filter`|フィードに返されるエンティティを特定の条件に基づいてフィルターする式を定義します。  このクエリ オプションは、フィルター式の評価に使用される一連の論理比較演算子、算術演算子、および定義済みクエリ関数をサポートします。  次の例は、郵便番号の末尾が 100 でないすべての注文を返します。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Orders?$filter=not endswith(ShipPostalCode,'100')`<br /><br /> 詳細については、「[OData: Filter システム クエリ オプション \($filter\)](http://go.microsoft.com/fwlink/?LinkId=186972)」を参照してください。|  
+|`$expand`|クエリで返される関連エンティティを指定します。  関連エンティティは、クエリで返されるエンティティにフィードまたはエントリとしてインラインで含まれています。  次の例では、顧客 'ALFKI' の注文を各注文の品目の詳細と共に返します。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$expand=Order_Details`<br /><br /> 詳細については、「[OData: Expand システム クエリ オプション \($expand\)](http://go.microsoft.com/fwlink/?LinkId=186973)」を参照してください。|  
+|`$select`|フィードとして返されるエンティティのプロパティを指定します。  既定では、エンティティのすべてのプロパティがフィードとして返されます。  次のクエリでは、`Customer` エンティティの 3 つのプロパティが返されます。<br /><br /> `http://services.odata.org/Northwind/Northwind.svc/Customers?$select=CustomerID,CompanyName,City`<br /><br /> 詳細については、「[OData: Select システム クエリ オプション \($select\)](http://go.microsoft.com/fwlink/?LinkID=186076)」を参照してください。|  
+|`$inlinecount`|フィードで返されるエンティティの数のカウントがフィードに含まれるように要求します。  詳細については、「[OData: Inlinecount システム クエリ オプション \($inlinecount\)](http://go.microsoft.com/fwlink/?LinkId=186975)」を参照してください。|  
+  
+## リレーションシップのアドレス指定  
+ エンティティ セットとエンティティ インスタンスのアドレス指定に加えて、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、2 つのエンティティ間のリレーションシップを表すアソシエーションのアドレスを指定することもできます。  この機能は、2 つのエンティティ インスタンス \(Northwind サンプル データベースの注文に関連付けられた配送会社など\) の間のリレーションシップを作成または変更するために必要です。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、エンティティ間のアソシエーションをアドレス指定する `$link` 演算子をサポートします。  たとえば、次の URI を HTTP PUT 要求メッセージで指定した場合、指定した注文の配送会社を新しい配送会社に変更します。  
+  
+```  
+http://services.odata.org/Northwind/Northwind.svc/Orders(10643)/$links/Shipper  
+```  
+  
+ 詳細については、「[OData: エントリ間のリンクのアドレス指定](http://go.microsoft.com/fwlink/?LinkId=187351)」を参照してください。  
+  
+## 返されたフィードの使用  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] リソースの URI を使用すると、サービスによって公開されるエンティティ データのアドレスを指定できます。  Web ブラウザーの \[アドレス\] フィールドに URI を入力すると、要求されたリソースの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィード表現が返されます。  詳細については、「[WCF Data Services クイックスタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)」を参照してください。  Web ブラウザーはデータ サービス リソースが予期されたデータを返すかどうかをテストするために便利ですが、データの作成、更新、および削除も行うことができる運用データ サービスには、一般的にアプリケーション コードや Web ページのスクリプト言語を使用してアクセスします。  詳細については、「[クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [Open Data Protocol Web サイト](http://go.microsoft.com/fwlink/?LinkID=182204)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md b/docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md
new file mode 100644
index 00000000000..52f90b14995
--- /dev/null
+++ b/docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md
@@ -0,0 +1,84 @@
+---
+title: "Web ブラウザーからサービスへのアクセス (WCF Data Services クイックスタート) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a6fa180-3094-4e6e-ba2b-8c80975d18d1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# Web ブラウザーからサービスへのアクセス (WCF Data Services クイックスタート)
+このタスクでは、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] から [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を開始し、必要に応じて Web ブラウザーでのフィード読み取りを無効にします。  次に、公開されているリソースに対して Web ブラウザーから HTTP GET 要求を送信し、サービス定義ドキュメントを取得して、データ サービス リソースにアクセスします。  
+  
+> [!NOTE]
+>  既定では、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] によって、コンピューター上の `localhost` URI にポート番号が自動的に割り当てられます。  このタスクでは、URI の例でポート番号 `12345` を使用しています。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] プロジェクトの指定のポート番号をセットする方法は、「[データ サービスの作成](../../../../docs/framework/data/wcf/creating-the-data-service.md)」を参照してください。  
+  
+### Internet Explorer を使用して既定のサービス ドキュメントを要求するには  
+  
+1.  Internet Explorer の **\[ツール\]** メニューので **\[インターネット オプション\]** をクリックし、**\[コンテンツ\]** タブの **\[設定\]** をクリックして **\[フィードの読み取りビューを有効にする\]** をオフにします。  
+  
+     フィードの読み取りが無効になります。  この機能が無効でなければ、Web ブラウザーは、AtomPub エンコードのドキュメントが返されると生の XML データを表示せずに XML フィードとして処理します。  
+  
+    > [!NOTE]
+    >  ブラウザーでフィードを生の XML データとして表示できない場合は、そのままでフィードをページのソース コードとして表示できます。  
+  
+2.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で F5 キーを押してアプリケーションのデバッグを開始します。  
+  
+3.  ローカル コンピューターで Web ブラウザーを開きます。  アドレス バーに次の URI を入力します。  
+  
+    ```  
+    http://localhost:12345/northwind.svc  
+    ```  
+  
+     既定のサービス ドキュメントが返されます。このドキュメントには、このデータ サービスによって公開されているエンティティ セットの一覧が含まれています。  
+  
+### Web ブラウザーからエンティティ セット リソースにアクセスするには  
+  
+1.  Web ブラウザーのアドレス バーに次の URI を入力します。  
+  
+    ```  
+    http://localhost:12345/northwind.svc/Customers  
+    ```  
+  
+     Northwind サンプル データベース内のすべての顧客のセットが返されます。  
+  
+2.  Web ブラウザーのアドレス バーに次の URI を入力します。  
+  
+    ```  
+    http://localhost:12345/northwind.svc/Customers('ALFKI')  
+    ```  
+  
+     特定の顧客 `ALFKI` のエンティティ インスタンスが返されます。  
+  
+3.  Web ブラウザーのアドレス バーに次の URI を入力します。  
+  
+    ```  
+    http://localhost:12345/northwind.svc/Customers('ALFKI')/Orders  
+    ```  
+  
+     顧客と注文の間のリレーションシップがスキャンされ、特定の顧客 `ALFKI` のすべての注文のセットが返されます。  
+  
+4.  Web ブラウザーのアドレス バーに次の URI を入力します。  
+  
+    ```  
+    http://localhost:12345/northwind.svc/Customers('ALFKI')/Orders?$filter=OrderID eq 10643  
+    ```  
+  
+     特定の顧客 `ALFKI` に属する注文がフィルターされ、指定した `OrderID` 値に基づいた特定の注文だけが返されます。  
+  
+## 次の手順  
+ ここでは、Web ブラウザーから特定のリソースに対して HTTP GET 要求を発行して [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] にアクセスしました。  Web ブラウザーを使用すると、リクエストのアドレス構文を試したり、結果を表示したりすることが簡単にできます。  しかし、一般的に、この方法では運用データ サービスにはアクセスできません。  通常、アプリケーションは、アプリケーション コードまたはスクリプト言語を通し、データ サービスと対話します。次に、共通言語ランタイム \(CLR\) オブジェクトのように、クライアント ライブラリを使用してデータ サービス リソースにアクセスするクライアント アプリケーションを作成します。  
+  
+ [.NET Framework クライアント アプリケーションの作成](../../../../docs/framework/data/wcf/creating-the-dotnet-client-application-wcf-data-services-quickstart.md)  
+  
+## 参照  
+ [データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/application-scenarios-wcf-data-services.md b/docs/framework/data/wcf/application-scenarios-wcf-data-services.md
new file mode 100644
index 00000000000..8983350a46b
--- /dev/null
+++ b/docs/framework/data/wcf/application-scenarios-wcf-data-services.md
@@ -0,0 +1,98 @@
+---
+title: "アプリケーション シナリオ (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 詳細"
+  - "WCF Data Services, シナリオ"
+ms.assetid: 7c82658f-e7c0-46b6-834d-6592f67ab5ea
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# アプリケーション シナリオ (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、データを [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードとして公開および使用するための重要なシナリオをサポートしています。  このトピックでは、これらのシナリオに関連するトピックを紹介します。  
+  
+ データベースからリレーショナル データを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開する。  
+ -   [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+  
+-   [サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)  
+  
+-   [方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md)  
+  
+ 任意の CLR データ クラスを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開する。  
+ -   [サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)  
+  
+-   [方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)  
+  
+-   [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)  
+  
+ .NET Framework ベースのクライアント アプリケーションの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する。  
+ -   [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+  
+-   [クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)  
+  
+-   [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)  
+  
+ Silverlight ベースのクライアント アプリケーションの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する。  
+ -   [WCF Data Services \(Silverlight\)](http://msdn.microsoft.com/ja-jp/c0cd9f4b-1372-48e4-9935-c8421239da30)  
+  
+-   [非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)  
+  
+-   [How to: Bind Data Service Data to Controls \(WCF Data Services\/Silverlight\)](http://msdn.microsoft.com/ja-jp/bda7d82e-7b1f-4690-8a33-c6297465bdd5)  
+  
+ AJAX ベースのクライアント アプリケーションの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する。  
+ -   [クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)  
+  
+-   [OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)  
+  
+-   [OData: JavaScript Object Notation \(JSON\) 形式](http://go.microsoft.com/fwlink/?LinkId=185790)  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を使用してクライアントとサーバーの間のデータ送信を行うエンド ツー エンドのデータ ソリューションを作成する。  
+ -   [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+  
+-   [クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)  
+  
+-   [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)  
+  
+ クライアントの待機時間に伴う問題を回避するために [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを非同期で使用する .NET Framework ベースのクライアント アプリケーションを作成する。  
+ -   [方法: 非同期データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-asynchronous-data-service-queries-wcf-data-services.md)  
+  
+-   [非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)  
+  
+-   [WCF Data Services \(Silverlight\)](http://msdn.microsoft.com/ja-jp/c0cd9f4b-1372-48e4-9935-c8421239da30)  
+  
+ ストリームとしてアクセスおよび変更されるバイナリ ラージ オブジェクトで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開して使用する。  
+ -   [ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)  
+  
+-   [バイナリ データの操作](../../../../docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md)  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを Windows Presentation Framework \(WPF\) アプリケーションのコントロールにバインドする。  
+ -   [コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)  
+  
+-   [方法: Windows Presentation Foundation 要素にデータをバインドする](../../../../docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md)  
+  
+-   [方法: プロジェクト データ ソースを使用してデータをバインドする](../../../../docs/framework/data/wcf/how-to-bind-data-using-a-project-data-source-wcf-data-services.md)  
+  
+ データ サービスへのメッセージを先に取得してクエリのデータ検証およびロール ベースのフィルター処理を実行する。  
+ -   [方法: データ サービス メッセージを先に取得する](../../../../docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md)  
+  
+-   [インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)  
+  
+ データ サービス上にエンドポイントを作成してカスタム サービスの動作を有効にする。  
+ -   [方法 : サービス操作を定義する](../../../../docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md)  
+  
+-   [サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)  
+  
+## 参照  
+ [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)   
+ [リソース](../../../../docs/framework/data/wcf/wcf-data-services-resources.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md b/docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md
new file mode 100644
index 00000000000..48f065ff86a
--- /dev/null
+++ b/docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md
@@ -0,0 +1,47 @@
+---
+title: "非同期操作 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "非同期操作 [WCF Data Services]"
+  - "WCF Data Services, 非同期操作"
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: 679644c7-e3fc-422c-b14a-b44b683900d0
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 非同期操作 (WCF Data Services)
+Web アプリケーションは、内部ネットワーク内で実行するアプリケーションより長い、クライアントとサーバーとの間の待機時間に対応する必要があります。  Web を介して [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] サーバーにアクセスする場合、アプリケーションのパフォーマンスとユーザー エクスペリエンスを最適化するために <xref:System.Data.Services.Client.DataServiceContext> クラスおよび <xref:System.Data.Services.Client.DataServiceQuery%601> クラスの非同期メソッドを使用することをお勧めします。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] サーバーでは、HTTP 要求は非同期として処理されますが、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリの一部のメソッドは同期であり、要求と応答のやり取りがすべて完了するまで待ってから実行を継続します。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリの非同期メソッドは、このやり取りの完了を待たず、アプリケーションはユーザー インターフェイスの応答性を維持できます。  
+  
+ <xref:System.Data.Services.Client.DataServiceContext> クラスと <xref:System.Data.Services.Client.DataServiceQuery%601> クラスでそれぞれ *Begin* および *End* で始まるメソッドのペアを使用して、非同期操作を実行できます。  *Begin* メソッドは、操作が完了したときにサービスが呼び出すデリゲートを登録します。  *End* メソッドは、完了した操作からのコールバックを処理するために登録されたデリゲートで呼び出します。  *End* メソッドを呼び出して非同期操作を完了するときは、操作を開始するために使用したものと同じ <xref:System.Data.Services.Client.DataServiceQuery%601> または <xref:System.Data.Services.Client.DataServiceContext> インスタンスから呼び出しを行う必要があります。  各 *Begin* メソッドは、状態オブジェクトをコールバックに渡すことができる `state` パラメーターを受け取ります。  この状態オブジェクトは、コールバックで指定された <xref:System.IAsyncResult> から取得され、対応する *End* メソッドを呼び出して非同期操作を完了するために使用されます。  たとえば、<xref:System.Data.Services.Client.DataServiceQuery%601> インスタンスで <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッドを呼び出すときにインスタンスを `state` パラメーターとして指定した場合、同じ <xref:System.Data.Services.Client.DataServiceQuery%601> インスタンスが <xref:System.IAsyncResult> によって返されます。  この <xref:System.Data.Services.Client.DataServiceQuery%601> のインスタンスは、<xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドを呼び出してクエリ操作を完了するために使用されます。  詳細については、「[方法: 非同期データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-asynchronous-data-service-queries-wcf-data-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  Silverlight 用の .NET Framework で提供されるクライアント ライブラリでは、非同期操作だけがサポートされます。  詳細については、「[WCF Data Services \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkID=143149)」を参照してください。  
+  
+ .NET Framework クライアント ライブラリは、以下の非同期操作をサポートします。  
+  
+|操作|メソッド|  
+|--------|----------|  
+|<xref:System.Data.Services.Client.DataServiceQuery%601> の実行。|-   <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A><br />-   <xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A>|  
+|<xref:System.Data.Services.Client.DataServiceContext> からのクエリの実行。|-   <xref:System.Data.Services.Client.DataServiceContext.BeginExecute%2A><br />-   <xref:System.Data.Services.Client.DataServiceContext.EndExecute%2A>|  
+|<xref:System.Data.Services.Client.DataServiceContext> からのバッチ クエリの実行。|-   <xref:System.Data.Services.Client.DataServiceContext.BeginExecuteBatch%2A><br />-   <xref:System.Data.Services.Client.DataServiceContext.EndExecuteBatch%2A>|  
+|<xref:System.Data.Services.Client.DataServiceContext> への関連エンティティの読み込み。|-   <xref:System.Data.Services.Client.DataServiceContext.BeginLoadProperty%2A><br />-   <xref:System.Data.Services.Client.DataServiceContext.EndLoadProperty%2A>|  
+|オブジェクトに対する変更の <xref:System.Data.Services.Client.DataServiceContext> への保存。|-   <xref:System.Data.Services.Client.DataServiceContext.BeginSaveChanges%2A><br />-   <xref:System.Data.Services.Client.DataServiceContext.EndSaveChanges%2A>|  
+  
+## 非同期操作のスレッドに関する考慮事項  
+ マルチスレッド アプリケーションでは、非同期操作のコールバックとして登録されたデリゲートは、最初の要求を作成する *Begin* メソッドの呼び出しに使用されたものと同じスレッドで必ずしも呼び出す必要はありません。  特定のスレッドでコールバックを呼び出す必要のあるアプリケーションでは、応答を処理する *End* メソッドの実行を目的のスレッドに明示的にマーシャリングする必要があります。  たとえば、Windows Presentation Foundation \(WPF\) ベースのアプリケーションおよび Silverlight ベースのアプリケーションでは、<xref:System.Windows.Threading.Dispatcher> オブジェクトで <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A> メソッドを使用して応答を UI スレッドにマーシャリングする必要があります。  詳細については、「[Querying the Data Service \(WCF Data Services\/Silverlight\)](http://msdn.microsoft.com/ja-jp/3a7cdc07-c37e-4da2-b98b-c3763fd0970b)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md b/docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md
new file mode 100644
index 00000000000..f0f8c188624
--- /dev/null
+++ b/docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md
@@ -0,0 +1,33 @@
+---
+title: "方法: 既存のエンティティを DataServiceContext にアタッチする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 変更 (データを)"
+ms.assetid: e3f2d71d-434c-4e98-91c3-95adae4702b6
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: 既存のエンティティを DataServiceContext にアタッチする (WCF Data Services)
+データ サービスにエンティティが既に存在する場合、クエリを最初に実行することなく、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用して、エンティティを表すオブジェクトを <xref:System.Data.Services.Client.DataServiceContext> に直接アタッチできます。  詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、データ サービスに保存する変更を含む既存の `Customer` オブジェクトを作成する方法を示します。  オブジェクトがコンテキストにアタッチされ、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出される前に、<xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> メソッドが呼び出されてアタッチされたオブジェクトが <xref:System.Data.Services.Client.EntityStates> としてマークされます。  
+  
+ [!code-csharp[Astoria Northwind Client#AttachObject](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#attachobject)]
+ [!code-vb[Astoria Northwind Client#AttachObject](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#attachobject)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/batching-operations-wcf-data-services.md b/docs/framework/data/wcf/batching-operations-wcf-data-services.md
new file mode 100644
index 00000000000..4bcefb6093e
--- /dev/null
+++ b/docs/framework/data/wcf/batching-operations-wcf-data-services.md
@@ -0,0 +1,35 @@
+---
+title: "バッチ処理 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: 962a49d1-cc11-4b96-bc7d-071dd6607d6c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# バッチ処理 (WCF Data Services)
+[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービスに対する要求のバッチ処理をサポートしています。  詳細については、「[OData: バッチ処理](http://go.microsoft.com/fwlink/?LinkId=186075)」を参照してください。[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、<xref:System.Data.Services.Client.DataServiceContext> を使用する各操作 \(クエリの実行や変更の保存など\) は、データ サービスに個別に送信される要求になります。  操作セットの論理スコープを維持するために、操作バッチを明示的に定義する必要があります。  この定義により、バッチ内のすべての操作が 1 つの HTTP 要求でデータ サービスに送信され、サーバーが操作を自動的に処理できるようになり、データ サービスへのラウンド トリップの数が減少します。  
+  
+## クエリ操作のバッチ処理  
+ 複数のクエリを 1 つのバッチで実行するには、バッチ内の各クエリを <xref:System.Data.Services.Client.DataServiceRequest%601> クラスの個別のインスタンスとして作成する必要があります。  この方法でクエリ要求を作成すると、クエリ自身が URI として定義されます。このクエリは、リソースのアドレス指定のルールに従います。  詳細については、「[データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)」を参照してください。  バッチ化されたクエリ要求は、クエリ要求オブジェクトを含む <xref:System.Data.Services.Client.DataServiceContext.ExecuteBatch%2A> メソッドが呼び出されたときにデータ サービスに送信されます。  このメソッドは、<xref:System.Data.Services.Client.DataServiceResponse> オブジェクトを返します。このオブジェクトは、バッチ内の個々の要求への応答を表す <xref:System.Data.Services.Client.QueryOperationResponse%601> オブジェクトのコレクションです。個々のオブジェクトには、クエリによって返されるオブジェクトのコレクションまたはエラー情報が含まれます。  バッチ内のいずれかのクエリ操作が失敗した場合、<xref:System.Data.Services.Client.QueryOperationResponse%601> オブジェクトで失敗した操作のエラー情報が返され、残りの操作は引き続き実行されます。  詳細については、「[方法: クエリをバッチで実行する](../../../../docs/framework/data/wcf/how-to-execute-queries-in-a-batch-wcf-data-services.md)」を参照してください。  
+  
+ バッチ クエリは、非同期で実行することもできます。  詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+## 変更の保存操作のバッチ処理  
+ <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドを呼び出すとき、コンテキストが追跡するすべての変更が REST ベースの操作に変換され、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに対する要求として送信されます。  既定では、これらの変更は 1 つの要求メッセージで送信されません。  すべての変更を 1 つの要求で送信するには、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%28System.Data.Services.Client.SaveChangesOptions%29> メソッドを呼び出して、メソッドに指定する <xref:System.Data.Services.Client.SaveChangesOptions> 列挙体に <xref:System.Data.Services.Client.SaveChangesOptions> の値を含める必要があります。  
+  
+ バッチ処理された変更を非同期で保存することもできます。  詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md b/docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md
new file mode 100644
index 00000000000..442dc7e2ae9
--- /dev/null
+++ b/docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md
@@ -0,0 +1,47 @@
+---
+title: "方法: Windows Presentation Foundation 要素にデータをバインドする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインド, WCF Data Services"
+  - "WCF Data Services, データ バインド"
+ms.assetid: d6538ab0-0abe-426a-b9d9-e6f3a5ca2016
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: Windows Presentation Foundation 要素にデータをバインドする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、<xref:System.Windows.Controls.ListBox>``や <xref:System.Windows.Controls.ComboBox> などの Windows Presentation Foundation \(WPF\) 要素を <xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスにバインドできます。これにより、コントロールのデータへの変更と <xref:System.Data.Services.Client.DataServiceContext> との同期を維持するためにコントロールによって生成されるイベントを処理できます。  詳細については、「[コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、WPF で `SalesOrders` ウィンドウを定義する XAML \(Extensible Application Markup Language\) の分離コード ページからの抜粋です。  ウィンドウが読み込まれると、国別にフィルターされた顧客を返すクエリの結果に基づいて <xref:System.Data.Services.Client.DataServiceCollection%601> が作成されます。  このページングされた結果のすべてのページが関連する注文と一緒に読み込まれ、WPF ウィンドウのルート レイアウト コントロールである <xref:System.Windows.Controls.StackPanel> の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティにバインドされます。  詳細については、「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。  
+  
+ [!code-csharp[Astoria Northwind Client#BindPagedData](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf3.xaml.cs#bindpageddata)]
+ [!code-vb[Astoria Northwind Client#BindPagedData](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf3.xaml.vb#bindpageddata)]  
+  
+## 使用例  
+ 次の XAML は、前の例の WPF の `SalesOrders` ウィンドウを定義します。  
+  
+ [!code-xml[Astoria Northwind Client#BindPagedDataXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf3.xaml#bindpageddataxaml)]  
+  
+## 使用例  
+ 次の例は、WPF で `SalesOrders` ウィンドウを定義する XAML \(Extensible Application Markup Language\) の分離コード ページからの抜粋です。  ウィンドウが読み込まれると、国別にフィルターされた顧客を関連するオブジェクトと一緒に返すクエリの結果に基づいて <xref:System.Data.Services.Client.DataServiceCollection%601> が作成されます。  この結果は、WPF ウィンドウのルート レイアウト コントロールである <xref:System.Windows.Controls.StackPanel> の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティにバインドされます。  
+  
+ [!code-csharp[Astoria Northwind Client#WpfDataBinding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf.xaml.cs#wpfdatabinding)]
+ [!code-vb[Astoria Northwind Client#WpfDataBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf.xaml.vb#wpfdatabinding)]  
+  
+## 使用例  
+ 次の XAML は、前の例の WPF の `SalesOrders` ウィンドウを定義します。  
+  
+ [!code-xml[Astoria Northwind Client#WpfDataBindingXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf.xaml#wpfdatabindingxaml)]
\ No newline at end of file
diff --git a/docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md b/docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md
new file mode 100644
index 00000000000..359ce90c110
--- /dev/null
+++ b/docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md
@@ -0,0 +1,122 @@
+---
+title: "コントロールへのデータのバインド (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント アプリケーション, WCF Data Services"
+  - "データ バインド, WCF Data Services"
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: b32e1d49-c214-4cb1-867e-88fbb3d08c8d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# コントロールへのデータのバインド (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、`ComboBox` や `ListView` などのコントロールを <xref:System.Data.Services.Client.DataServiceCollection%601> クラスのインスタンスにバインドできます。このコレクションは <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスから継承され、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードのデータを含んでいます。  このクラスは、項目が追加または削除されたときに通知を行う動的なデータ コレクションを表します。  データ バインディングに <xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを使用する場合、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリは、これらのイベントを処理して、<xref:System.Data.Services.Client.DataServiceContext> によって追跡されるオブジェクトとバインドされる UI 要素のデータとの同期を維持します。  
+  
+ <xref:System.Data.Services.Client.DataServiceCollection%601> クラスは、<xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを \(間接的に\) 実装して、コレクションに対してオブジェクトが追加または削除されたときのコンテキストを警告します。  <xref:System.Data.Services.Client.DataServiceCollection%601> と使用するデータ サービス型オブジェクトは、<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスも実装して、バインディング コレクション内のオブジェクトのプロパティが変更されたときに <xref:System.Data.Services.Client.DataServiceCollection%601> に警告する必要があります。  
+  
+> [!NOTE]
+>  **\[サービス参照の追加\]** ダイアログまたは [DataSvcUtil.exe](../../../../docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md) ツールを `/dataservicecollection` オプション付きで使用してクライアント データ サービス クラスを生成すると、生成されたデータ クラスには <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスが実装されます。  詳細については、「[方法: クライアント データ サービス クラスを手動で生成する](../../../../docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md)」を参照してください。  
+  
+## バインディング コレクションの作成  
+ 指定した <xref:System.Data.Services.Client.DataServiceContext> インスタンスでクラス コンストラクター メソッドの 1 つを呼び出し、オプションで <xref:System.Data.Services.Client.DataServiceQuery%601> または実行時に <xref:System.Collections.Generic.IEnumerable%601> インスタンスを返す LINQ クエリを呼び出して <xref:System.Data.Services.Client.DataServiceCollection%601> クラスの新しいインスタンスを作成します。  この <xref:System.Collections.Generic.IEnumerable%601> は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードから具体化されるバインディング コレクションのオブジェクトのソースを提供します。  詳細については、「[オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)」を参照してください。  既定では、バインドされたオブジェクトおよびコレクションに挿入された項目に対する変更は、<xref:System.Data.Services.Client.DataServiceContext> によって自動的に追跡されます。  これらの変更を手動で追跡する必要がある場合は、`trackingMode` パラメーターを受け取るコンストラクター メソッドの 1 つを呼び出して、<xref:System.Data.Services.Client.TrackingMode> 値を指定します。  
+  
+ 次の例は、指定された <xref:System.Data.Services.Client.DataServiceContext> と、すべての顧客と関連する注文を返す <xref:System.Data.Services.Client.DataServiceQuery%601> に基づいて、<xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを作成する方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#CustomersOrders2Binding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorders2.cs#customersorders2binding)]
+ [!code-vb[Astoria Northwind Client#CustomersOrders2Binding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorders2.vb#customersorders2binding)]  
+  
+## Windows Presentation Foundation 要素へのデータのバインド  
+ <xref:System.Data.Services.Client.DataServiceCollection%601> クラスは <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスを継承しているため、バインディングに <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスを使用する場合と同様に、オブジェクトを Windows Presentation Foundation \(WPF\) アプリケーション内の要素 \(またはコントロール\) にバインドできます。  詳細については、「[データ バインディング \(Windows Presentation Foundation\)](../../../../docs/framework/wpf/data/data-binding-wpf.md)」を参照してください。  データ サービスのデータを WPF コントロールにバインドする 1 つの方法は、要素の `DataContext` プロパティをクエリ結果を含む <xref:System.Data.Services.Client.DataServiceCollection%601> クラスのインスタンスに設定することです。  この場合、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを使用して、コントロールのオブジェクト ソースを設定します。  <xref:System.Windows.Controls.ItemsControl.DisplayMemberPath%2A> プロパティを使用して、バインドされたオブジェクトのどのプロパティを表示するかを指定します。  ナビゲーション プロパティから返される関連オブジェクトに要素をバインドする場合は、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティに対して定義されているバインドにパスを含めます。  このパスは、親コントロールの <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティで設定されたルート オブジェクトを基準とした相対パスになります。  次の例では、<xref:System.Windows.Controls.StackPanel> 要素の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを設定して、親コントロールをカスタム オブジェクトの <xref:System.Data.Services.Client.DataServiceCollection%601> にバインドします。  
+  
+ [!code-csharp[Astoria Northwind Client#MasterDetailBinding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderscustom.xaml.cs#masterdetailbinding)]
+ [!code-csharp[Astoria Northwind Client#MasterDetailBinding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf.xaml.cs#masterdetailbinding)]
+ [!code-vb[Astoria Northwind Client#MasterDetailBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom.xaml.vb#masterdetailbinding)]
+ [!code-vb[Astoria Northwind Client#MasterDetailBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf.xaml.vb#masterdetailbinding)]
+ [!code-vb[Astoria Northwind Client#MasterDetailBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom2.xaml.vb#masterdetailbinding)]  
+  
+ 次の例は、子である <xref:System.Windows.Controls.DataGrid> コントロールと <xref:System.Windows.Controls.ComboBox> コントロールの XAML バインド定義を示しています。  
+  
+ [!code-xml[Astoria Northwind Client#MasterDetailXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf.xaml#masterdetailxaml)]  
+  
+ 詳細については、「[方法: Windows Presentation Foundation 要素にデータをバインドする](../../../../docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md)」を参照してください。  
+  
+ 一対多または多対多のリレーションシップのエンティティの場合は、リレーションシップのナビゲーション プロパティは関連するオブジェクトのコレクションを返します。  **\[サービス参照の追加\]** ダイアログ ボックスまたは DataSvcUtil.exe ツールを使用してクライアント サービス クラスを生成すると、ナビゲーション プロパティは、<xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを返します。  そのため、関連するオブジェクトをコントロールにバインドして、関連エンティティのマスター\/詳細バインディング パターンなど、一般的な WPF バインディング シナリオをサポートできます。  前の XAML の例では、XAML コードはマスター <xref:System.Data.Services.Client.DataServiceCollection%601> をルート データ要素にバインドします。  注文 <xref:System.Windows.Controls.DataGrid> が、選択した Customer オブジェクトから返される Orders <xref:System.Data.Services.Client.DataServiceCollection%601> にバインドされ、<xref:System.Windows.Window> のルート データ要素にバインドされます。  
+  
+## Windows フォーム コントロールへのデータのバインド  
+ オブジェクトを Windows フォーム コントロールにバインドするには、コントロールの `DataSource` プロパティをクエリ結果を含む <xref:System.Data.Services.Client.DataServiceCollection%601> クラスのインスタンスに設定します。  
+  
+> [!NOTE]
+>  データ バインディングは、<xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスおよび <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装することで変更イベントをリッスンしているコントロールでのみサポートされます。  コントロールがこの種類の変更通知をサポートしていない場合、基になる <xref:System.Data.Services.Client.DataServiceCollection%601> に対する変更はバインドされたコントロールに反映されません。  
+  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceCollection%601> を <xref:System.Windows.Forms.ComboBox> コントロールにバインドします。  
+  
+ [!code-csharp[Astoria Northwind Client#CustomersOrdersDataBindingSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorders.cs#customersordersdatabindingspecific)]
+ [!code-vb[Astoria Northwind Client#CustomersOrdersDataBindingSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorders.vb#customersordersdatabindingspecific)]  
+  
+ **\[サービス参照の追加\]** ダイアログ ボックスを使用してクライアント データ サービス クラスを生成すると、生成された <xref:System.Data.Services.Client.DataServiceContext> に基づくプロジェクト データ ソースも作成されます。  このデータ ソースでは、**\[データ ソース\]** ウィンドウからデザイナーに項目をドラッグして、データ サービスのデータを表示する UI 要素またはコントロールを作成できます。  これらの項目は、データ ソースにバインドされるアプリケーション UI の要素になります。  詳細については、「[方法: プロジェクト データ ソースを使用してデータをバインドする](../../../../docs/framework/data/wcf/how-to-bind-data-using-a-project-data-source-wcf-data-services.md)」を参照してください。  
+  
+## ページングされたデータのバインド  
+ データ サービスは、1 つの応答メッセージで返されるクエリ データの量を制限するよう構成できます。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  データ サービスによって応答データのページングが行われる場合、各応答には、結果の次のページを返すためのリンクが含まれます。  詳細については、「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。  この場合、次の例に示すように、<xref:System.Data.Services.Client.DataServiceQueryContinuation.NextLinkUri%2A> プロパティから取得した URI を渡すことによって <xref:System.Data.Services.Client.DataServiceCollection%601> で <xref:System.Data.Services.Client.DataServiceCollection%601.Load%2A> メソッドを呼び出してページを明示的に読み込む必要があります。  
+  
+ [!code-csharp[Astoria Northwind Client#BindPagedDataSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf3.xaml.cs#bindpageddataspecific)]
+ [!code-vb[Astoria Northwind Client#BindPagedDataSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf3.xaml.vb#bindpageddataspecific)]  
+  
+ 関連するオブジェクトは同様の方法で読み込まれます。  詳細については、「[方法: Windows Presentation Foundation 要素にデータをバインドする](../../../../docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md)」を参照してください。  
+  
+## データ バインディングの動作のカスタマイズ  
+ <xref:System.Data.Services.Client.DataServiceCollection%601> クラスを使用すると、コレクションへの変更が行われたとき \(オブジェクトが追加または削除されたときなど\)、およびコレクション内のオブジェクトのプロパティに対して変更が行われたときに発生するイベントを先に取得できます。  データ バインディング イベントを変更して、次の制約を含む既定の動作をオーバーライドできます。  
+  
+-   デリゲート内では検証は実行されません。  
+  
+-   エンティティを追加すると関連エンティティが自動的に追加されます。  
+  
+-   エンティティを削除しても関連エンティティは削除されません。  
+  
+ <xref:System.Data.Services.Client.DataServiceCollection%601> の新しいインスタンスを作成するとき、次のパラメーターを指定して、バインドされたオブジェクトが変更されたときに発生するイベントを処理するメソッドに対してデリゲートを定義できます。  
+  
+-   `entityChanged` \- バインドされたオブジェクトのプロパティが変更されたときに呼び出されるメソッド。  この <xref:System.Func%602> デリゲートは、<xref:System.Data.Services.Client.EntityChangedParams> オブジェクトを受け入れ、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> を呼び出す既定の動作を引き続き発生させるかどうかを示すブール値を返します。  
+  
+-   `entityCollectionChanged` \- バインディング コレクションに対してオブジェクトの追加または削除が行われたときに呼び出されるメソッド。  この <xref:System.Func%602> デリゲートは、<xref:System.Data.Services.Client.EntityCollectionChangedParams> オブジェクトを受け入れ、既定の動作 \(<xref:System.Data.Services.Client.DataServiceContext> での <xref:System.Collections.Specialized.NotifyCollectionChangedAction> アクションの <xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> または <xref:System.Collections.Specialized.NotifyCollectionChangedAction> アクションの <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> 呼び出し\) を引き続き発生させるかどうかを示すブール値を返します。  
+  
+> [!NOTE]
+>  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、これらのデリゲートで実装したカスタムの動作を検証しません。  
+  
+ 次の例では、<xref:System.Collections.Specialized.NotifyCollectionChangedAction> アクションがカスタマイズされ、<xref:System.Data.Services.Client.DataServiceContext.DeleteLink%2A> および <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> メソッドが呼び出されて、削除された `Orders` エンティティに属する `Orders_Details` エンティティが削除されます。  親エンティティを削除しても依存エンティティは自動的に削除されないので、このカスタム アクションが実行されます。  
+  
+ [!code-csharp[Astoria Northwind Client#CustomersOrdersDeleteRelated](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderscustom.xaml.cs#customersordersdeleterelated)]
+ [!code-vb[Astoria Northwind Client#CustomersOrdersDeleteRelated](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom.xaml.vb#customersordersdeleterelated)]
+ [!code-vb[Astoria Northwind Client#CustomersOrdersDeleteRelated](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom2.xaml.vb#customersordersdeleterelated)]  
+  
+ 詳細については、「[方法: データ バインディングの動作をカスタマイズする](../../../../docs/framework/data/wcf/how-to-customize-data-binding-behaviors-wcf-data-services.md)」を参照してください。  
+  
+ <xref:System.Collections.ObjectModel.Collection%601.Remove%2A> メソッドを使用して <xref:System.Data.Services.Client.DataServiceCollection%601> からオブジェクトが削除されたときの既定の動作では、オブジェクトは <xref:System.Data.Services.Client.DataServiceContext> でも Deleted とマークされます。  この動作を変更するには、<xref:System.Collections.Specialized.INotifyCollectionChanged.CollectionChanged> イベントが発生すると呼び出される `entityCollectionChanged` パラメーター内のメソッドに対してデリゲートを指定できます。  
+  
+## カスタム クライアント データ クラスでのデータ バインディング  
+ オブジェクトを <xref:System.Data.Services.Client.DataServiceCollection%601> に読み込むには、オブジェクト自身が <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する必要があります。  **\[サービス参照の追加\]** ダイアログ ボックスまたは [DataSvcUtil.exe](../../../../docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md) ツールを使用するときに生成されるデータ サービス クライアント クラスは、このインターフェイスを実装します。  独自のクライアント データ クラスを提供する場合、データ バインディングに別の種類のコレクションを使用する必要があります。  オブジェクトが変更されると、データ バインド コントロール内のイベントを処理して、<xref:System.Data.Services.Client.DataServiceContext> クラスの次のメソッドを呼び出す必要があります。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> \- 新しいオブジェクトがコレクションに追加されたとき。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> \- オブジェクトがコレクションから削除されたとき。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> \- コレクション内のオブジェクトでプロパティが変更されたとき。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> \- オブジェクトが関連オブジェクトのコレクションに追加されたとき。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.SetLink%2A> \- オブジェクトが関連オブジェクトのコレクションに追加されたとき。  
+  
+ 詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [方法: クライアント データ サービス クラスを手動で生成する](../../../../docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md)   
+ [方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/calling-service-operations-wcf-data-services.md b/docs/framework/data/wcf/calling-service-operations-wcf-data-services.md
new file mode 100644
index 00000000000..ab4c3d98409
--- /dev/null
+++ b/docs/framework/data/wcf/calling-service-operations-wcf-data-services.md
@@ -0,0 +1,132 @@
+---
+title: "サービス操作の呼び出し (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1767f3a7-29d2-4834-a763-7d169693fa8b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# サービス操作の呼び出し (WCF Data Services)
+[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] は、データ サービスのサービス操作を定義します。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスのメソッドとしてこのような操作を定義できます。  他のデータ サービス リソースと同様に、これらのサービス操作は URI によってアドレス指定できます。  サービス操作では、エンティティ型のコレクション、1 つのエンティティ型のインスタンス、およびプリミティブ型 \(整数、文字列など\) を返すことができます。  さらに、サービス操作では、`null` \(Visual Basic の場合は `Nothing`\) を返すこともできます。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用して、HTTP GET 要求をサポートするサービス操作にアクセスすることができます。  この種のサービス操作は、<xref:System.ServiceModel.Web.WebGetAttribute> が適用されたメソッドとして定義されます。  詳細については、「[サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)」を参照してください。  
+  
+ サービス操作は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を実装するデータ サービスによって返されるメタデータに公開されます。  メタデータ内で、サービス操作は、`FunctionImport` 要素として表されます。  厳密に型指定された <xref:System.Data.Services.Client.DataServiceContext> を生成するとき、この要素は "サービス参照の追加" と DataSvcUtil.exe ツールで無視されます。  このため、サービス操作を直接呼び出すために使用できるコンテキストにはメソッドはありません。  ただし、次のいずれかの方法を使用して、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントでサービス操作を呼び出すことができます。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.Execute%2A> メソッドを呼び出し、サービス操作の URI をその他のパラメーターと共に指定します。  このメソッドは、GET サービス操作の呼び出しに使用されます。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> メソッドを使用して、<xref:System.Data.Services.Client.DataServiceQuery%601> オブジェクトを作成します。  <xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> を呼び出すとき、サービス操作の名前が `entitySetName` パラメーターに渡されます。  このメソッドは、列挙されたときまたは <xref:System.Data.Services.Client.DataServiceQuery%601.Execute%2A> メソッドが呼び出されたときにサービス操作を呼び出す <xref:System.Data.Services.Client.DataServiceQuery%601> オブジェクトを返します。  このメソッドは、コレクションを返す GET サービス操作の呼び出しに使用されます。  1 つのパラメーターは、<xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを使用して指定することができます。  このメソッドによって返される <xref:System.Data.Services.Client.DataServiceQuery%601> オブジェクトは、クエリ オブジェクトのようにさらに構成できます。  詳細については、「[データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+## サービス操作の呼び出しに関する考慮事項  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントを使用してサービス操作を呼び出す際は、次の点に注意してください。  
+  
+-   データ サービスに非同期にアクセスするときは、<xref:System.Data.Services.Client.DataServiceContext> の同等の非同期 <xref:System.Data.Services.Client.DataServiceContext.BeginExecute%2A>\/<xref:System.Data.Services.Client.DataServiceContext.EndExecute%2A> メソッドまたは <xref:System.Data.Services.Client.DataServiceQuery%601> の <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A>\/<xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドを使用する必要があります。  
+  
+-   [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリは、プリミティブ型のコレクションを返すサービス操作からの結果を具体化できません。  
+  
+-   [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリでは、POST サービス操作の呼び出しをサポートしていません。  HTTP POST によって呼び出されるサービス操作は、<xref:System.ServiceModel.Web.WebInvokeAttribute> に `Method="POST"` パラメーターを使用して定義します。  HTTP POST 要求を使用してサービス操作を呼び出すには、代わりに <xref:System.Net.HttpWebRequest> を使用する必要があります。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> を使用して、エンティティまたはプリミティブ型の単一の結果を返す GET サービス操作または 1 つ以上の入力パラメーターを必要とする GET サービス操作を呼び出すことはできません。  代わりに <xref:System.Data.Services.Client.DataServiceContext.Execute%2A> メソッドを呼び出す必要があります。  
+  
+-   ツールによって生成される厳密に型指定された <xref:System.Data.Services.Client.DataServiceContext> 部分クラスで <xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> メソッドまたは <xref:System.Data.Services.Client.DataServiceContext.Execute%2A> メソッドを使用してサービス操作を呼び出す拡張メソッドを作成することを検討してください。  これにより、コンテキストから直接サービス操作を呼び出すことができます。  詳細については、ブロク投稿「[サービス操作と WCF データ サービス クライアント](http://go.microsoft.com/fwlink/?LinkId=215668)」を参照してください。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> を使用してサービス操作を呼び出す場合、クライアント ライブラリは、アンパサンド \(&\) などの予約文字のパーセント エンコードを実行し、文字列内の単一引用符をエスケープして、<xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> に入力された文字を自動的にエスケープします。  ただし、いずれかの *Execute* メソッドを呼び出してサービス操作を呼び出す場合は、このユーザーが指定した任意の文字列値のエスケープを実行する必要があります。  URI 内の単一引用符は、単一引用符のペアとしてエスケープされます。  
+  
+## サービス操作の呼び出しの例  
+ このセクションには、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用してサービス操作を呼び出す方法を示す次の例が含まれています。  
+  
+-   [Execute&lt;T&gt; を呼び出してエンティティのコレクションを返す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecuteIQueryable)  
+  
+-   [CreateQuery&lt;T&gt; を使用してエンティティのコレクションを返す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#CreateQueryIQueryable)  
+  
+-   [Execute&lt;T&gt; を呼び出して 1 つのエンティティを返す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecuteSingleEntity)  
+  
+-   [Execute&lt;T&gt; を呼び出してプリミティブ値のコレクションを返す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecutePrimitiveCollection)  
+  
+-   [Execute&lt;T&gt; を呼び出して 1 つのプリミティブ値を返す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecutePrimitiveValue)  
+  
+-   [データを返さないサービス操作を呼び出す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecuteVoid)  
+  
+-   [サービス操作を非同期に呼び出す](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md#ExecuteAsync)  
+  
+<a name="ExecuteIQueryable"></a>   
+### Execute\<T\> を呼び出してエンティティのコレクションを返す  
+ 次の例では、文字列パラメーター `city` を受け取り、<xref:System.Linq.IQueryable%601> を返す、GetOrdersByCity という名前のサービス操作を呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationIQueryable](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationiqueryable)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationIQueryable](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationiqueryable)]  
+  
+ この例では、サービス操作は、`Order` オブジェクトのコレクションを関連する `Order_Detail` オブジェクトと共に返します。  
+  
+<a name="CreateQueryIQueryable"></a>   
+### CreateQuery\<T\> を使用してエンティティのコレクションを返す  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> を使用して、同じ GetOrdersByCity サービス操作を呼び出すために使用される <xref:System.Data.Services.Client.DataServiceQuery%601> を返します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationCreateQuery](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationcreatequery)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationCreateQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationcreatequery)]  
+  
+ この例では、<xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを使用してクエリにパラメーターを追加し、<xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドを使用して関連する Order\_Details オブジェクトを結果に含めています。  
+  
+<a name="ExecuteSingleEntity"></a>   
+### Execute\<T\> を呼び出して 1 つのエンティティを返す  
+ 次の例では、単一の Order エンティティのみを返す、GetNewestOrder という名前のサービス操作を呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationSingleEntity](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationsingleentity)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationSingleEntity](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationsingleentity)]  
+  
+ この例では、<xref:System.Linq.Enumerable.FirstOrDefault%2A> メソッドを使用して、実行時に単一の Order エンティティのみを要求します。  
+  
+<a name="ExecutePrimitiveCollection"></a>   
+### Execute\<T\> を呼び出してプリミティブ値のコレクションを返す  
+ 次の例では、文字列値のコレクションを返すサービス操作を呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationEnumString](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationenumstring)]  
+  
+<a name="ExecutePrimitiveValue"></a>   
+### Execute\<T\> を呼び出して 1 つのプリミティブ値を返す  
+ 次の例では、単一の文字列値を返すサービス操作を呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationSingleInt](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationsingleint)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationSingleInt](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationsingleint)]  
+  
+ この例において、<xref:System.Linq.Enumerable.FirstOrDefault%2A> メソッドを使用して、実行時に単一の整数値のみを要求しています。  
+  
+<a name="ExecuteVoid"></a>   
+### データを返さないサービス操作を呼び出す  
+ 次の例では、データを返さないサービス操作を呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationVoid](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationvoid)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationVoid](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationvoid)]  
+  
+ データが返されないため、実行の値は割り当てられません。  要求が成功したことを示す唯一の印は、<xref:System.Data.Services.Client.DataServiceQueryException> が発生しないことです。  
+  
+<a name="ExecuteAsync"></a>   
+### サービス操作を非同期に呼び出す  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext.BeginExecute%2A> と <xref:System.Data.Services.Client.DataServiceContext.EndExecute%2A> を呼び出してサービス操作を非同期に呼び出しています。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationAsync](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationasync)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationAsync](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationasync)]  
+  
+ [!code-csharp[Astoria Northwind Client#OnAsyncExecutionComplete](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#onasyncexecutioncomplete)]
+ [!code-vb[Astoria Northwind Client#OnAsyncExecutionComplete](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#onasyncexecutioncomplete)]  
+  
+ データが返されないため、実行によって返される値は割り当てられません。  要求が成功したことを示す唯一の印は、<xref:System.Data.Services.Client.DataServiceQueryException> が発生しないことです。  
+  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext.CreateQuery%2A> を使用して同じサービス操作を非同期に呼び出しています。  
+  
+ [!code-csharp[Astoria Northwind Client#CallServiceOperationQueryAsync](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#callserviceoperationqueryasync)]
+ [!code-vb[Astoria Northwind Client#CallServiceOperationQueryAsync](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#callserviceoperationqueryasync)]  
+  
+ [!code-csharp[Astoria Northwind Client#OnAsyncQueryExecutionComplete](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#onasyncqueryexecutioncomplete)]
+ [!code-vb[Astoria Northwind Client#OnAsyncQueryExecutionComplete](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#onasyncqueryexecutioncomplete)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md b/docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md
new file mode 100644
index 00000000000..9b352ff88b6
--- /dev/null
+++ b/docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md
@@ -0,0 +1,92 @@
+---
+title: "データ サービスの構成 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 構成"
+ms.assetid: 59efd4c8-cc7a-4800-a0a4-d3f8abe6c55c
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# データ サービスの構成 (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを公開するデータ サービスを作成できます。  これらのフィードには、さまざまなデータ ソースからのデータが含まれることがあります。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、データ プロバイダーを使用して、このデータを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開します。  これらのプロバイダーには、[!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダー、リフレクション プロバイダー、およびカスタム データ サービス プロバイダー インターフェイスのセットがあります。  プロバイダーの実装は、サービスのデータ モデルを定義します。  詳細については、「[データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)」を参照してください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスは、データ サービスの種類がデータ モデルのエンティティ コンテナーである <xref:System.Data.Services.DataService%601> クラスから継承するクラスです。  このエンティティ コンテナーには、データ モデルのエンティティ セットにアクセスするために使用される <xref:System.Linq.IQueryable%601> を返す 1 つ以上のプロパティがあります。  
+  
+ データ サービスの動作は、<xref:System.Data.Services.DataServiceConfiguration> クラスのメンバー、および <xref:System.Data.Services.DataServiceConfiguration> クラスの <xref:System.Data.Services.DataServiceConfiguration.DataServiceBehavior%2A> プロパティからアクセスされる <xref:System.Data.Services.DataServiceBehavior> クラスのメンバーによって定義されます。  <xref:System.Data.Services.DataServiceConfiguration> クラスは、Northwind データ サービスの次の実装のように、データ サービスによって実装される `InitializeService` メソッドに提供されます。  
+  
+ [!code-csharp[Astoria Northwind Service#DataServiceConfigComplete](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind.svc.cs#dataserviceconfigcomplete)]
+ [!code-vb[Astoria Northwind Service#DataServiceConfigComplete](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind.svc.vb#dataserviceconfigcomplete)]  
+  
+## データ サービス構成設定  
+ <xref:System.Data.Services.DataServiceConfiguration> クラスでは、以下のデータ サービスの動作を指定できます。  
+  
+|メンバー|動作|  
+|----------|--------|  
+|<xref:System.Data.Services.DataServiceBehavior.AcceptCountRequests%2A>|`$count` パス セグメントおよび `$inlinecount` クエリ オプションを使用してデータ サービスに送信したカウント要求を無効にできます。  詳細については、「[OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceBehavior.AcceptProjectionRequests%2A>|`$select` クエリ オプションを使用してデータ サービスに送信された要求のデータ プロジェクションのサポートを無効にできます。  詳細については、「[OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.EnableTypeAccess%2A>|<xref:System.Data.Services.Providers.IDataServiceMetadataProvider> インターフェイスを使用して定義された動的メタデータ プロバイダーのメタデータでデータ型を公開します。|  
+|<xref:System.Data.Services.DataServiceConfiguration.EnableTypeConversion%2A>|ペイロードに含まれている型を、要求で指定された実際のプロパティ型にデータ サービス ランタイムで変換するかどうかを指定できます。|  
+|<xref:System.Data.Services.DataServiceBehavior.InvokeInterceptorsOnLinkDelete%2A>|2 つのエンティティ間のリレーションシップ リンクを削除するときに、関連エンティティで登録済みの変更インターセプターを呼び出すかどうかを指定できます。|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxBatchCount%2A>|単一のバッチで許可される変更セットおよびクエリ操作の数を制限できます。  詳細については、「[OData: バッチ](http://go.microsoft.com/fwlink/?LinkId=185602)」および「[バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxChangesetCount%2A>|単一の変更セットに含めることができる変更の数を制限できます。  詳細については、「[方法: データ サービスの結果のページングを有効にする](../../../../docs/framework/data/wcf/how-to-enable-paging-of-data-service-results-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxExpandCount%2A>|`$expand` クエリ演算子を使用して 1 つの要求に含めることのできる関連エンティティの数を制限することによって応答のサイズを制限できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)」および「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxExpandDepth%2A>|`$expand` クエリ演算子を使用して 1 つの要求に含めることのできる関連エンティティのグラフの深度を制限することによって応答のサイズを制限できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[OData: URI 規則](http://go.microsoft.com/fwlink/?LinkId=185564)」および「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxObjectCountOnInsert%2A>|1 つの POST 要求に挿入できるエンティティの数を制限できます。|  
+|<xref:System.Data.Services.DataServiceBehavior.MaxProtocolVersion%2A>|データ サービスによって使用される Atom プロトコルのバージョンを定義します。  <xref:System.Data.Services.DataServiceBehavior.MaxProtocolVersion%2A> に <xref:System.Data.Services.Common.DataServiceProtocolVersion> の最大値よりも低い値を設定した場合、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の最新の機能はデータ サービスにアクセスするクライアントで使用できなくなります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md).|  
+|<xref:System.Data.Services.DataServiceConfiguration.MaxResultsPerCollection%2A>|データ フィードとして返される各エンティティ セットのエンティティの数を制限することによって応答のサイズを制限できます。|  
+|<xref:System.Data.Services.DataServiceConfiguration.RegisterKnownType%2A>|データ サービスで認識される型のリストにデータ型を追加します。|  
+|<xref:System.Data.Services.DataServiceConfiguration.SetEntitySetAccessRule%2A>|データ サービスで使用可能なエンティティ セット リソースへのアクセス権を設定します。  アスタリスク \(`*`\) 値を名前パラメーターに使用すると、残りのすべてのエンティティ セットへのアクセスを同じレベルに設定できます。  エンティティ セットへのアクセスを設定する場合は、クライアント アプリケーションに必要なデータ サービス リソースへの最小アクセス特権を設定することをお勧めします。  詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。  特定の URI および HTTP アクションに必要な最小限のアクセス権の例については、以下の「[最小限のリソース アクセス要件](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md#accessRequirements)」セクションを参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.SetEntitySetPageSize%2A>|エンティティ セット リソースの最大ページ サイズを設定します。  詳細については、「[方法: データ サービスの結果のページングを有効にする](../../../../docs/framework/data/wcf/how-to-enable-paging-of-data-service-results-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.SetServiceOperationAccessRule%2A>|データ サービスで定義されるサービス操作へのアクセス権を設定します。  詳細については、「[サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)」を参照してください。  アスタリスク \(`*`\) 値を名前パラメーターに使用すると、残りのすべてのサービス操作へのアクセスを同じレベルに設定できます。  サービス操作へのアクセスを設定する場合は、クライアント アプリケーションに必要なデータ サービス リソースへの最小アクセス特権を設定することをお勧めします。  詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。|  
+|<xref:System.Data.Services.DataServiceConfiguration.UseVerboseErrors%2A>|この構成プロパティを使用すると、エラー応答メッセージで多くの情報を返すことによってデータ サービスのトラブルシューティングを容易にすることができます。  このオプションは、運用環境で使用することを目的としたものではありません。  詳細については、「[WCF Data Services の開発と配置](../../../../docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md)」を参照してください。|  
+  
+<a name="accessRequirements"></a>   
+## 最小限のリソース アクセス要件  
+ 次の表に、特定の操作を実行するために付与されている必要があるエンティティ セットの最小限の権限を示します。  パスの例は、[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)の完了時に作成される Northwind データ サービスに基づいています。  <xref:System.Data.Services.EntitySetRights> 列挙体および <xref:System.Data.Services.ServiceOperationRights> 列挙体は <xref:System.FlagsAttribute> を使用して定義されているので、論理和演算子を使用して 1 つのエンティティ セットまたは操作に複数のアクセス許可を指定できます。  詳細については、「[方法: データ サービスへのアクセスを有効にする](../../../../docs/framework/data/wcf/how-to-enable-access-to-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+|パス\/アクション|`GET`|`DELETE`|`MERGE`|`POST`|`PUT`|  
+|---------------|-----------|--------------|-------------|------------|-----------|  
+|`/Customers`|<xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|<xref:System.Data.Services.EntitySetRights>|サポートなし|  
+|`/Customers('ALFKI')`|<xref:System.Data.Services.EntitySetRights>|<xref:System.Data.Services.EntitySetRights> および<xref:System.Data.Services.EntitySetRights>|<xref:System.Data.Services.EntitySetRights> および<xref:System.Data.Services.EntitySetRights>|適用なし|<xref:System.Data.Services.EntitySetRights> および<xref:System.Data.Services.EntitySetRights>|  
+|`/Customers('ALFKI')/Orders`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|`Customers`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights> または <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders` `:` および<xref:System.Data.Services.EntitySetRights>|サポートなし|  
+|`/Customers('ALFKI')/Orders(10643)`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|サポートなし|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|  
+|`/Orders(10643)/Customer`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|サポートなし|  
+|`/Customers('ALFKI')/$links/Orders`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|`Customers`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights> または <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|  
+|`/Customers('ALFKI')/$links/Orders(10643)`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights> または <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|サポートなし|  
+|`/Orders(10643)/$links/Customer`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|`Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights> または <xref:System.Data.Services.EntitySetRights>|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|サポートなし|`Customers`: <xref:System.Data.Services.EntitySetRights>;<br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights> および <xref:System.Data.Services.EntitySetRights>|  
+|`/Customers/$count`|<xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|サポートなし|サポートなし|  
+|`/Customers('ALFKI')/ContactName`|<xref:System.Data.Services.EntitySetRights>|サポートなし|<xref:System.Data.Services.EntitySetRights>|サポートなし|<xref:System.Data.Services.EntitySetRights>|  
+|`/Customers('ALFKI')/Address/StreetAddress/$value` <sup>1</sup>|<xref:System.Data.Services.EntitySetRights>|<xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|サポートなし|  
+|`/Customers('ALFKI')/ContactName/$value`|<xref:System.Data.Services.EntitySetRights>|<xref:System.Data.Services.EntitySetRights> および<xref:System.Data.Services.EntitySetRights>|<xref:System.Data.Services.EntitySetRights>|サポートなし|<xref:System.Data.Services.EntitySetRights>|  
+|`/Customers('ALFKI')/$value` <sup>2</sup>|<xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|サポートなし|<xref:System.Data.Services.EntitySetRights>|  
+|`/Customers?$select=Orders/*&$expand=Orders`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|`Customers`: <xref:System.Data.Services.EntitySetRights>|サポートなし|  
+|`/Customers('ALFKI')?$select=Orders/*&$expand=Orders`|`Customers`: <xref:System.Data.Services.EntitySetRights><br /><br /> および<br /><br /> `Orders`: <xref:System.Data.Services.EntitySetRights>|サポートなし|サポートなし|サポートなし|サポートなし|  
+  
+ <sup>1</sup> この例では、`Address` は `StreetAddress` という名前のプロパティを持つ `Customers` エンティティの複合型プロパティを表します。  Northwind データ サービスによって使用されるモデルでは、この複合型は明示的に定義されていません。  [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダーを使用してデータ モデルを定義している場合、[!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)] ツールを使用して、このような複合型を定義できます。  詳細については、「[How to: Create and Modify Complex Types](http://msdn.microsoft.com/ja-jp/afb8e206-0ffe-4597-b6d4-6ab566897e1d)」を参照してください。  
+  
+ <sup>2</sup> この URI は、バイナリ ラージ オブジェクト \(BLOB\) を返すプロパティがメディア リンク エントリであるエンティティ \(この場合、`Customers`\) に属するメディア リソースとして定義されている場合にサポートされます。  詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。  
+  
+<a name="versioning"></a>   
+## バージョン管理の要件  
+ 次のデータ サービス構成の動作には、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのバージョン 2 またはそれ以降のバージョンが必要です。  
+  
+-   カウント要求のサポート。  
+  
+-   射影の $select クエリ オプションのサポート。  
+  
+ 詳細については、「[データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md b/docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md
new file mode 100644
index 00000000000..4bb0af787d7
--- /dev/null
+++ b/docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md
@@ -0,0 +1,80 @@
+---
+title: "方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, Entity Framework"
+  - "WCF Data Services, プロバイダー"
+ms.assetid: 6d11fec8-0108-42f5-8719-2a7866d04428
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、エンティティ データはデータ サービスとして公開されます。  データ ソースがリレーショナル データベースの場合、このエンティティ データは [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] によって提供されます。  このトピックでは、既存のデータベースに基づき、このデータ モデルを使用して新しいデータ サービスを作成する [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] Web アプリケーションで [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] ベースのデータ モデルを作成する方法について説明します。  
+  
+ [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] は、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] プロジェクトの外部に [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] モデルを生成できるコマンド ライン ツールも提供します。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  
+  
+### 既存のデータベースに基づく Entity Framework モデルを既存の Web アプリケーションに追加するには  
+  
+1.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[テンプレート\]** ペインの **\[データ\]** カテゴリをクリックして、**\[ADO.NET エンティティ データ モデル\]** をクリックします。  
+  
+3.  モデル名を入力して **\[追加\]** をクリックします。  
+  
+     [!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)] ウィザードの最初のページが表示されます。  
+  
+4.  **\[モデルのコンテンツの選択\]** ダイアログ ボックスで **\[データベースから生成\]** をクリックします。  その後、**\[次へ\]** をクリックします。  
+  
+5.  **\[新しい接続\]** をクリックします。  
+  
+6.  **\[接続のプロパティ\]** ダイアログ ボックスでサーバー名を入力し、認証方法を選択します。データベース名を入力して **\[OK\]** をクリックします。  
+  
+     指定したデータベース接続の設定に従って **\[データ接続の選択\]** ダイアログ ボックスが更新されます。  
+  
+7.  **\[エンティティ接続設定に名前を付けて App.Config に保存\]** チェックボックスがオンになっていることを確認します。  その後、**\[次へ\]** をクリックします。  
+  
+8.  **\[データベース オブジェクトの選択\]** ダイアログ ボックスで、データ サービスで公開するすべてのデータベース オブジェクトを選択します。  
+  
+    > [!NOTE]
+    >  データ モデルに含まれるオブジェクトは、データ サービスによって自動的には公開されません。  これらのオブジェクトは、サービス自身によって明示的に公開される必要があります。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+9. **\[完了\]** をクリックしてウィザードを終了します。  
+  
+     特定のデータベースに基づく既定のデータ モデルが作成されます。  [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] では、データ モデルをカスタマイズできます。  詳細については、「[Tasks](http://msdn.microsoft.com/ja-jp/7166f1f1-4de8-4bd4-86b5-5e20a2ebaccb)」を参照してください。  
+  
+### 新しいデータ モデルを使用してデータ サービスを作成するには  
+  
+1.  データ モデルを表す .edmx ファイルを [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で開きます。  
+  
+2.  **モデル ブラウザー**でモデルを右クリックし、**\[プロパティ\]** をクリックしてエンティティ コンテナーの名前を確認します。  
+  
+3.  **ソリューション エクスプローラー**で、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+4.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[WCF Data Service\]** をクリックします。  
+  
+5.  サービスの名前を入力して、**\[OK\]** をクリックします。  
+  
+     [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で新しいサービスの XML マークアップおよびコード ファイルが作成されます。  既定では、コード エディターのウィンドウが開きます。  
+  
+6.  データ サービスのコードで、データ サービスを定義するクラスの定義内のコメント `/* TODO: put your data source class name here */` を <xref:System.Data.Objects.ObjectContext> クラスから継承する型で置き換えます。この型はデータ モデルのエンティティ コンテナー \(手順 2 で確認したコンテナー\) です。  
+  
+7.  データ サービスのコードで、承認されたクライアントがデータ サービスによって公開されているエンティティ セットにアクセスできるようにします。  詳細については、「[データ サービスの作成](../../../../docs/framework/data/wcf/creating-the-data-service.md)」を参照してください。  
+  
+8.  Web ブラウザーを使用して Northwind.svc データ サービスをテストするには、トピック「[Web ブラウザーからサービスへのアクセス](../../../../docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)」の手順に従います。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)   
+ [方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md b/docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md
new file mode 100644
index 00000000000..ced77f22d38
--- /dev/null
+++ b/docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md
@@ -0,0 +1,76 @@
+---
+title: "方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, LINQ to SQL"
+  - "WCF Data Services, プロバイダー"
+ms.assetid: 3b01c2fd-8c6e-4bf5-b38f-9e61bdc3c328
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、エンティティ データはデータ サービスとして公開されます。  リフレクション プロバイダーでは、<xref:System.Linq.IQueryable%601> 実装を返すメンバーを公開するクラスに基づいたデータ モデルを定義できます。  データ ソース内のデータに更新を加えるには、これらのクラスも <xref:System.Data.Services.IUpdatable> インターフェイスを実装する必要があります。  詳細については、「[データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)」を参照してください。  このトピックでは、リフレクション プロバイダーを使用して Northwind サンプル データベースにアクセスする LINQ to SQL クラスを作成する方法と、これらのデータ クラスに基づくデータ サービスを作成する方法について説明します。  
+  
+### LINQ to SQL クラスをプロジェクトに追加するには  
+  
+1.  Visual Basic または Visual C\# から、**\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[LINQ to SQL クラス\]** テンプレートをクリックします。  
+  
+3.  名前を「Northwind.dbml」に変更します。  
+  
+4.  **\[追加\]** をクリックします。  
+  
+     Northwind.dbml ファイルがプロジェクトに追加され、オブジェクト リレーショナル デザイナー \(O\/R デザイナー\) が開きます。  
+  
+5.  **サーバー エクスプローラー**または**データベース エクスプローラー**で、Northwind の下にある **\[テーブル\]** を展開して、`Customers` テーブルをオブジェクト リレーショナル デザイナー \(O\/R デザイナー\) にドラッグします。  
+  
+     `Customer` エンティティ クラスが作成され、デザイン サーフェイスに表示されます。  
+  
+6.  `Orders` テーブル、`Order_Details` テーブル、および `Products` テーブルに対して手順 6 を繰り返します。  
+  
+7.  LINQ to SQL クラスを表す新しい .dbml ファイルを右クリックして、**\[コードの表示\]** をクリックします。  
+  
+     <xref:System.Data.Linq.DataContext> クラス \(この場合は `NorthwindDataContext`\) から継承するクラスの部分クラス定義を含む Northwind.cs という新しい分離コード ページが作成されます。  
+  
+8.  Northwind.cs コード ファイルの内容を次のコードに置き換えます。  このコードでは、<xref:System.Data.Linq.DataContext> と、および LINQ to SQL によって生成されたデータ クラスを拡張して、リフレクション プロバイダーを実装します。  
+  
+     [!code-csharp[Astoria Linq Provider#Linq2SqlProvider](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria linq provider/cs/northwind.cs#linq2sqlprovider)]
+     [!code-vb[Astoria Linq Provider#Linq2SqlProvider](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria linq provider/vb/northwind.vb#linq2sqlprovider)]  
+  
+### LINQ to SQL ベースのデータ モデルを使用してデータ サービスを作成するには  
+  
+1.  **ソリューション エクスプローラー**で、ASP.NET プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[WCF Data Service\]** をクリックします。  
+  
+3.  サービスの名前を入力して、**\[OK\]** をクリックします。  
+  
+     Visual Studio で新しいサービスの XML マークアップおよびコード ファイルが作成されます。  既定では、コード エディターのウィンドウが開きます。  
+  
+4.  データ サービスのコードで、データ サービスを定義するクラスの定義にあるコメント `/* TODO: put your data source class name here */` をデータ モデルのエンティティ コンテナーである型 \(この場合は `NorthwindDataContext`\) で置き換えます。  
+  
+5.  データ サービスのコードで、`InitializeService` 関数のプレースホルダーのコードを次の内容で置き換えます。  
+  
+     [!code-csharp[Astoria Linq Provider#EnableAccess](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria linq provider/cs/northwind.svc.cs#enableaccess)]
+     [!code-vb[Astoria Linq Provider#EnableAccess](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria linq provider/vb/northwind.svc.vb#enableaccess)]  
+  
+     指定した 3 つのエンティティ セットのリソースへのクライアント アクセスが承認されます。  
+  
+6.  Web ブラウザーを使用して Northwind.svc データ サービスをテストするには、トピック「[Web ブラウザーからサービスへのアクセス](../../../../docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)」の手順に従います。  
+  
+## 参照  
+ [方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md)   
+ [方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)   
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md b/docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md
new file mode 100644
index 00000000000..ef36173e944
--- /dev/null
+++ b/docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md
@@ -0,0 +1,36 @@
+---
+title: "方法: リフレクション プロバイダーを使用してデータ サービスを作成する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, プロバイダー"
+ms.assetid: 7315c6d8-f452-4fb2-a0c1-76ab0593c146
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: リフレクション プロバイダーを使用してデータ サービスを作成する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、<xref:System.Linq.IQueryable%601> インターフェイスを実装するオブジェクトとして公開されているクラスに基づいてデータ モデルを定義できます。  詳細については、「[データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、`Orders` および `Items` を含むデータ モデルを定義します。  エンティティ コンテナー クラス `OrderItemData` には、<xref:System.Linq.IQueryable%601> インターフェイスを返す 2 つのパブリック メソッドがあります。  これらのインターフェイスは、`Orders` エンティティ型と `Items` エンティティ型のエンティティ セットです。  `Order` には複数の `Items` を含めることができるので、`Orders` エンティティ型には `Items` オブジェクトのコレクションを返す `Items` ナビゲーション プロパティがあります。  `OrderItemData` エンティティ コンテナー クラスは、`OrderItems` データ サービスが派生する <xref:System.Data.Services.DataService%601> クラスのジェネリック型です。  
+  
+> [!NOTE]
+>  この例はメモリ内のデータ プロバイダーを示し、変更は現在のオブジェクト インスタンスの外部で永続化されないので、<xref:System.Data.Services.IUpdatable> インターフェイスを実装する利点はありません。  <xref:System.Data.Services.IUpdatable> インターフェイスを実装する例については、「[方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md)」を参照してください。  
+  
+ [!code-csharp[Astoria Reflection Provider#CustomIQueryable](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria reflection provider/cs/orderitems.svc.cs#customiqueryable)]
+ [!code-vb[Astoria Reflection Provider#CustomIQueryable](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria reflection provider/vb/orderitems.svc.vb#customiqueryable)]  
+  
+## 参照  
+ [方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md)   
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/create-an-asynchronous-wpf-application-wcf-data-services.md b/docs/framework/data/wcf/create-an-asynchronous-wpf-application-wcf-data-services.md
new file mode 100644
index 00000000000..a73dd45c1e6
--- /dev/null
+++ b/docs/framework/data/wcf/create-an-asynchronous-wpf-application-wcf-data-services.md
@@ -0,0 +1,38 @@
+---
+title: "方法: 非同期 Windows Presentation Framework アプリケーションを作成する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 非同期操作"
+ms.assetid: 834614df-1427-4839-b0be-90f68e5afffd
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: 非同期 Windows Presentation Framework アプリケーションを作成する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスから取得したデータを Windows Presentation Framework \(WPF\) アプリケーションの UI 要素にバインドできます。  詳細については、「[コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)」を参照してください。データ サービスに対して非同期で複数の操作を実行することもできます。この場合、アプリケーションは、データ サービス要求に対する応答を待機している間も引き続き応答できます。  データ サービスに非同期でアクセスするには、Silverlight 用のアプリケーションが必要です。  詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+ このトピックでは、データ サービスに非同期でアクセスして、結果を WPF アプリケーションの要素にバインドする方法について説明します。  このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の XAML は、WPF アプリケーションのウィンドウを定義します。  
+  
+ [!code-xml[Astoria Northwind Client#WpfDataBindingAsyncXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerordersasync.xaml#wpfdatabindingasyncxaml)]  
+  
+## 使用例  
+ 次の XAML ファイルの分離コード ページは、データ サービスを使用して非同期クエリを実行し、結果を WPF ウィンドウの要素にバインドします。  
+  
+ [!code-csharp[Astoria Northwind Client#WpfDataBindingAsync](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerordersasync.xaml.cs#wpfdatabindingasync)]
+ [!code-vb[Astoria Northwind Client#WpfDataBindingAsync](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerordersasync.xaml.vb#wpfdatabindingasync)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/creating-the-data-service.md b/docs/framework/data/wcf/creating-the-data-service.md
new file mode 100644
index 00000000000..175682ecade
--- /dev/null
+++ b/docs/framework/data/wcf/creating-the-data-service.md
@@ -0,0 +1,110 @@
+---
+title: "データ サービスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 34d1d971-5e18-4c22-9bf6-d3612e27ea59
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# データ サービスの作成
+このタスクでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用するサンプル データ サービスを作成し、Northwind サンプル データベースに基づく [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを公開します。この作業に必要な基本手順は次のとおりです。  
+  
+1.  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションを作成します。  
+  
+2.  [!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)] ツールを使用して、データ モデルを定義します。  
+  
+3.  データ サービスを Web アプリケーションに追加します。  
+  
+4.  データ サービスへのアクセスを有効にします。  
+  
+> [!NOTE]
+>  このタスクを完了するときに作成する [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションは、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で提供される [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発サーバー上で実行します。  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発サーバーは、ローカル コンピューターからのアクセスのみをサポートします。  開発時にデータ サービスのテストおよびトラブルシューティングを行いやすくするためにも、インターネット インフォメーション サービス \(IIS\) を使用して、データ サービスをホストするアプリケーションを実行することを検討してください。  詳細については、「[方法: IIS 上で実行する WCF Data Service を開発する](../../../../docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md)」を参照してください。  
+  
+### ASP.NET Web アプリケーションを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で、**\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスで、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] の下の **Web** テンプレートを選択し、**\[ASP.NET Web アプリケーション\]** をクリックします。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] Web Developer を使用する場合は、新しい Web アプリケーションではなく新しい Web サイトを作成する必要があります。  
+  
+3.  プロジェクトの名前として「`NorthwindService`」を入力します。  
+  
+4.  **\[OK\]** をクリックします。  
+  
+5.  \(省略可能\) Web アプリケーションに対して特定のポート番号を指定します。  メモ: このクイック スタートの以降の作業では、ポート番号 `12345` を使用します。  
+  
+    1.  **ソリューション エクスプローラー**で、作成した [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトの名前を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    2.  **\[Web\]** タブをクリックし、**\[ポートを指定する\]** ボックスの値を `12345` に設定します。  
+  
+### データ モデルを定義するには  
+  
+1.  **ソリューション エクスプローラー**で、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで **Data** テンプレートをクリックし、**\[ADO.NET エンティティ データ モデル\]** をクリックします。  
+  
+3.  データ モデルの名前として「`Northwind.edmx`」を入力します。  
+  
+4.  [!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)] ウィザードで、**\[データベースから生成\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+5.  次のいずれかの手順を実行し、データ モデルをデータベースに接続してから **\[次へ\]** をクリックします。  
+  
+    -   データベース接続がまだ構成されていない場合は、**\[新しい接続\]** をクリックして新しい接続を作成します。  詳細については、「[SQL Server データベースへの接続の作成方法](http://go.microsoft.com/fwlink/?LinkId=123631)」を参照してください。  この [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] インスタンスには、Northwind サンプル データベースがアタッチされている必要があります。  
+  
+         または  
+  
+    -   Northwind データベースに接続するようにデータベース接続が既に構成されている場合は、一覧からその接続を選択します。  
+  
+6.  ウィザードの最終ページで、データベース内のすべてのテーブルのチェック ボックスをオンにし、ビューおよびストアド プロシージャのチェック ボックスをオフにします。  
+  
+7.  **\[完了\]** をクリックして、ウィザードを終了します。  
+  
+    > [!NOTE]
+    >  この生成されたデータ モデルは、エンティティ型の外部キー プロパティを公開します。  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 2008 を使用して作成したデータ モデルには、これらの外部キー プロパティが含まれません。  そのため、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 2008 を使用して作成された Northwind データ サービスにアクセスしようとする前に、このバージョンの Northwind データ サービスにアクセスするために作成されたクライアント アプリケーションのクライアント データ サービス クラスを更新する必要があります。  
+  
+### データ サービスを作成するには  
+  
+1.  **ソリューション エクスプローラー**で、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[WCF Data Service\]** をクリックします。  
+  
+3.  サービスの名前として「`Northwind`」を入力します。  
+  
+     [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)]Visual Studio で新しいサービスの XML マークアップおよびコード ファイルが作成されます。  既定では、コード エディターのウィンドウが開きます。  **ソリューション エクスプローラー**では、このサービスに Northwind という名前が付き、拡張子は .svc.cs または .svc.vb になります。  
+  
+4.  データ サービスのコードで、データ サービスを定義するクラスの定義にあるコメント `/* TODO: put your data source class name here */` をデータ モデルのエンティティ コンテナーである型 \(この場合は `NorthwindEntities`\) で置き換えます。  クラス定義は次のようになります。  
+  
+     [!code-csharp[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart service/cs/northwind.svc.cs#servicedefinition)]
+     [!code-vb[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart service/vb/northwind.svc.vb#servicedefinition)]  
+  
+### データ サービス リソースへのアクセスを有効にするには  
+  
+1.  データ サービスのコードで、`InitializeService` 関数のプレースホルダーのコードを次の内容で置き換えます。  
+  
+     [!code-csharp[Astoria Quickstart Service#AllReadConfig](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart service/cs/northwind.svc.cs#allreadconfig)]
+     [!code-vb[Astoria Quickstart Service#AllReadConfig](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart service/vb/northwind.svc.vb#allreadconfig)]  
+  
+     これにより、承認されたクライアントは、指定したエンティティ セットのリソースに読み取りおよび書き込みアクセスできるようになります。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションにアクセスできるクライアントは、データ サービスによって公開されるリソースにもアクセスできます。  運用データ サービスで、リソースへの承認されていないアクセスを防止するために、アプリケーション自身もセキュリティで保護する必要があります。  詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。  
+  
+## 次の手順  
+ ここでは、Northwind サンプル データベースに基づいて、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開する新しいデータ サービスを作成し、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションへのアクセス許可を持つクライアントからフィードへのアクセスを有効にしました。  次は、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] からデータ サービスを開始して、Web ブラウザーから HTTP GET 要求を送信して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスします。  
+  
+ [Web ブラウザーからサービスへのアクセス](../../../../docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)  
+  
+## 参照  
+ [ADO.NET Entity Data Model  Tools](http://msdn.microsoft.com/ja-jp/91076853-0881-421b-837a-f582f36be527)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/creating-the-dotnet-client-application-wcf-data-services-quickstart.md b/docs/framework/data/wcf/creating-the-dotnet-client-application-wcf-data-services-quickstart.md
new file mode 100644
index 00000000000..a70cbccdf53
--- /dev/null
+++ b/docs/framework/data/wcf/creating-the-dotnet-client-application-wcf-data-services-quickstart.md
@@ -0,0 +1,89 @@
+---
+title: ".NET Framework クライアント アプリケーションの作成 (WCF Data Services クイック スタート) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41ade767-eeab-437d-9121-9797e8fb8045
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# .NET Framework クライアント アプリケーションの作成 (WCF Data Services クイック スタート)
+これは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クイック スタートの最後のタスクです。  このタスクでは、コンソール アプリケーションをソリューションに追加し、この新しいクライアント アプリケーションに [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードへの参照を追加します。次に、生成されたクライアント データ サービス クラスおよびクライアント ライブラリを使用して、クライアント アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスします。  
+  
+> [!NOTE]
+>  データ フィードへのアクセスには .NET Framework ベースのクライアント アプリケーションは必要ありません。  データ サービスは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する任意のアプリケーション コンポーネントからアクセスできます。  詳細については、「[クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)」を参照してください。  
+  
+### Visual Studio を使用してクライアント アプリケーションを作成するには  
+  
+1.  **ソリューション エクスプローラー**でソリューションを右クリックし、**\[追加\]** をポイントして **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[プロジェクトの種類\]** で **\[Windows\]** をクリックして、**\[テンプレート\]** ペインで **\[WPF アプリケーション\]** を選択します。  
+  
+3.  プロジェクト名として「`NorthwindClient`」を入力し、**\[OK\]** をクリックします。  
+  
+4.  ファイル MainWindow.xaml を開き、XAML コードを次のコードに置き換えます。  
+  
+     [!code-xml[Astoria Quickstart Client#Window1Xaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart client/vb/window1.xaml#window1xaml)]  
+  
+### データ サービス参照をプロジェクトに追加するには  
+  
+1.  NorthwindClient プロジェクトを右クリックして、**\[サービス参照の追加\]**、**\[探索\]** の順にクリックします。  
+  
+     最初のタスクで作成した Northwind データ サービスが表示されます。  
+  
+2.  **\[名前空間\]** ボックスに「`Northwind`」と入力し、**\[OK\]** をクリックします。  
+  
+     プロジェクトに新しいコード ファイルが追加されます。このコード ファイルには、データ サービス リソースにアクセスし、オブジェクトとしてデータ サービス リソースと対話するデータ クラスが含まれています。  データ クラスは、名前空間 `NorthwindClient.Northwind` で作成されます。  
+  
+### WPF アプリケーションのデータ サービスにアクセスするには  
+  
+1.  **NorthwindClient** の下の**ソリューション エクスプローラー**でプロジェクトを右クリックして、**\[参照の追加\]** をクリックします。  
+  
+2.  \[参照の追加\] ダイアログ ボックスで、**\[.NET\]** タブをクリックし、System.Data.Services.Client.dll アセンブリを選択して、**\[OK\]** をクリックします。  **NorthwindClient** の下の**ソリューション エクスプローラー**で、MainWindow.xaml ファイルのコード ページを開き、次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[Astoria Quickstart Client#Using](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart client/cs/window1.xaml.cs#using)]
+     [!code-vb[Astoria Quickstart Client#Using](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart client/vb/window1.xaml.vb#using)]  
+  
+3.  次のコードを挿入します。このコードは、データ サービスをクエリし、<xref:System.Data.Services.Client.DataServiceCollection%601> に対する結果を `MainWindow` クラスにバインドします。  
+  
+    > [!NOTE]
+    >  ホスト名 `localhost:12345` を Northwind データ サービスのインスタンスをホストするサーバーとポートで置き換えます。  
+  
+     [!code-csharp[Astoria Quickstart Client#QueryCode](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart client/cs/window1.xaml.cs#querycode)]
+     [!code-vb[Astoria Quickstart Client#QueryCode](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart client/vb/window1.xaml.vb#querycode)]  
+  
+4.  次のコードを挿入します。このコードは、変更内容を `MainWindow` クラスに保存します。  
+  
+     [!code-csharp[Astoria Quickstart Client#SaveChanges](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart client/cs/window1.xaml.cs#savechanges)]
+     [!code-vb[Astoria Quickstart Client#SaveChanges](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart client/vb/window1.xaml.vb#savechanges)]  
+  
+### NorthwindClient アプリケーションをビルドして実行するには  
+  
+1.  **ソリューション エクスプローラー**で NorthwindClient プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+2.  F5 キーを押してアプリケーションを起動します。  
+  
+     ソリューションがビルドされ、クライアント アプリケーションが起動します。  データがサービスから要求され、コンソールに表示されます。  
+  
+3.  データ グリッドの **Quantity** 列の値を編集し、**\[保存\]** をクリックします。  
+  
+     変更内容はデータ サービスに保存されます。  
+  
+    > [!NOTE]
+    >  このバージョンの NorthwindClient アプリケーションでは、エンティティの追加と削除はサポートされません。  
+  
+## 次の手順  
+ ここでは、サンプル Northwind の [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスするクライアント アプリケーションを作成しました。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クイック スタートも完了しました。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードへのアクセスについては、「[WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)」を参照してください。  
+  
+## 参照  
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)   
+ [リソース](../../../../docs/framework/data/wcf/wcf-data-services-resources.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md b/docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md
new file mode 100644
index 00000000000..7f1813d202d
--- /dev/null
+++ b/docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md
@@ -0,0 +1,37 @@
+---
+title: "カスタム データ サービス プロバイダー (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, プロバイダー"
+ms.assetid: e702ecdb-3419-4743-92a9-c3c0e7d44082
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# カスタム データ サービス プロバイダー (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、遅延バインディング データ型に基づいてデータ モデルを定義できるプロバイダーのセットが含まれています。  
+  
+|プロバイダー|説明|  
+|------------|--------|  
+|メタデータ プロバイダー|これは、<xref:System.Data.Services.Providers.IDataServiceMetadataProvider> インターフェイスを実装することによって実行時にカスタム データ モデルを定義できるコア カスタム データ サービス プロバイダーです。|  
+|クエリ プロバイダー|このプロバイダーを使用すると、<xref:System.Data.Services.Providers.IDataServiceMetadataProvider> インターフェイスを使用して定義されたカスタム データ モデルに対してクエリを実行できます。  クエリ プロバイダーは、<xref:System.Data.Services.Providers.IDataServiceQueryProvider> インターフェイスを実装することによって作成されます。|  
+|更新プロバイダー|このプロバイダーを使用すると、カスタム データ サービス プロバイダー内で公開されている型を更新して同時実行を管理できます。  更新プロバイダーは、<xref:System.Data.Services.Providers.IDataServiceUpdateProvider> インターフェイスを実装することによって作成されます。|  
+|ページング プロバイダー|このプロバイダーは、サーバー ドリブン ページング サポートを有効にするためにカスタム データ サービス プロバイダーと一緒に使用します。  カスタム データ サービスのページング プロバイダーは、<xref:System.Data.Services.Providers.IDataServicePagingProvider> インターフェイスを実装することによって作成されます。|  
+|ストリーミング プロバイダー|このプロバイダーを使用すると、ストリームとしてバイナリ ラージ オブジェクト データ型を公開できます。  ストリーミング プロバイダーは、<xref:System.Data.Services.Providers.IDataServiceStreamProvider> インターフェイスを実装することによって作成されます。  ストリーミング プロバイダーは、Entity Framework プロバイダーおよびリフレクション データ ソース プロバイダーと共に使用することもできます。  詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。|  
+  
+ 詳細については、記事「[カスタム データ サービス プロバイダー](http://go.microsoft.com/fwlink/?LinkID=186850)」および [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] プロバイダー ツールキット \([OData SDK](http://go.microsoft.com/fwlink/?LinkId=186069)\) を参照してください。  
+  
+## 参照  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)   
+ [リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/data-service-versioning-wcf-data-services.md b/docs/framework/data/wcf/data-service-versioning-wcf-data-services.md
new file mode 100644
index 00000000000..8089414f484
--- /dev/null
+++ b/docs/framework/data/wcf/data-service-versioning-wcf-data-services.md
@@ -0,0 +1,85 @@
+---
+title: "データ サービスのバージョン管理 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バージョン管理 [WCF Data Services]"
+  - "バージョン管理, WCF Data Services"
+  - "WCF Data Services, バージョン管理"
+ms.assetid: e3e899cc-7f25-4f67-958f-063f01f79766
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# データ サービスのバージョン管理 (WCF Data Services)
+[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] では、データ サービスを作成できます。これにより、クライアントは、データ モデルに基づく URI を使用してリソースとしてのデータにアクセスできます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、サービス操作の定義もサポートしています。  ビジネス ニーズの変化、情報テクノロジの要件、その他の問題への対処などのさまざまな理由により、サービスの初期導入後と、場合によっては有効期間中に数回、これらのデータ サービスを変更することが必要になる場合があります。  既存のデータ サービスに変更を加える場合は、新しいバージョンのデータ サービスを定義する必要性や、既存のクライアント アプリケーションへの影響を最小限に抑える最善の方法を検討する必要があります。  ここでは、新しいバージョンのデータ サービスをいつどのように作成するかに関するガイダンスを示します。  さらに、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] が [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルの異なるバージョンをサポートするクライアントとデータ サービスの間の交換どのように処理するかについても説明します。  
+  
+## WCF Data Service のバージョン管理  
+ データ サービスが配置され、データが使用されている状況では、データ サービスに変更を加えることで、既存のクライアント アプリケーションとの間に互換性の問題が発生する可能性があります。  ただし、サービスの全体的なビジネス ニーズを受けて変更が求められることも多いため、クライアント アプリケーションへの影響を最小限に抑えながらデータ サービスの新しいバージョンをいつどのように作成するかを検討する必要があります。  
+  
+### 新しいバージョンのデータ サービスが推奨されるデータ モデルの変更  
+ データ サービスの新しいバージョンを発行するかどうかを検討する際は、さまざまな種類の変更がクライアント アプリケーションに与える影響を理解することが重要です。  データ サービスの新しいバージョンを作成する必要があるデータ サービスへの変更は、次の 2 つのカテゴリに分類できます。  
+  
+-   サービス コントラクトに対する変更。これには、サービス操作の更新、エンティティ セット \(フィード\) のアクセシビリティへの変更、バージョンの変更、およびサービスの動作に対するその他の変更が含まれます。  
+  
+-   データ コントラクトに対する変更。これには、データ モデル、フィード形式、またはフィードのカスタマイズが含まれます。  
+  
+ 次の表に、データ サービスの新しいバージョンの発行を考慮する必要がある変更の種類を示します。  
+  
+|変更の種類|新しいバージョンが必要|新しいバージョンは不要|  
+|-----------|-----------------|-----------------|  
+|サービス操作|-   新しいパラメーターの追加<br />-   戻り値の型を変更する<br />-   サービス操作を削除する|-   既存のパラメーターを削除する<br />-   新しいサービス操作を追加する|  
+|サービスの動作|-   カウント要求を無効にする<br />-   投影のサポートを無効にする<br />-   必要なデータ サービスのバージョンを引き上げる|-   カウント要求を有効にする<br />-   投影のサポートを有効にする<br />-   必要なデータ サービスのバージョンを引き下げる|  
+|エンティティ セットのアクセス許可|-   エンティティ セットのアクセス許可を制限する<br />-   応答コードを変更する \(新しい最初の桁の値\)<sup>1</sup>|-   エンティティ セットのアクセス許可の制限を解除する<br />-   応答コードを変更する \(同じ最初の桁の値\)|  
+|エンティティのプロパティ|-   既存のプロパティまたはリレーションシップを削除する<br />-   null 非許容のプロパティを追加する<br />-   既存のプロパティを変更する|-   null 許容のプロパティを追加する<sup>2</sup>|  
+|エンティティ セット|-   エンティティ セットを削除する|-   派生型を追加する<br />-   基本データ型を変更する<br />-   エンティティ セットを追加する|  
+|フィードのカスタマイズ|-   エンティティ プロパティのマッピングを変更する||  
+  
+ <sup>1</sup> 特定のエラー コードを受信することにクライアント アプリケーションがどの程度厳密に依存しているかによって異なります。  
+  
+ <sup>2</sup> <xref:System.Data.Services.Client.DataServiceContext.IgnoreMissingProperties%2A> プロパティを `true` に設定すると、クライアントは、データ サービスによって送信された、クライアント上で定義されていない新しいプロパティを無視します。  ただし、挿入の場合、クライアントによって POST 要求に含められていないプロパティは既定値に設定されます。  更新の場合、クライアントが識別できないプロパティ内の既存のデータは、既定値で上書きされます。  この場合は、更新を MERGE 要求として送信する必要があります \(これは既定の動作です\)。  詳細については、「[データ サービス コンテキストの管理](../../../../docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md)」を参照してください。  
+  
+### データ サービスのバージョンの管理  
+ 必要に応じて、サービス コントラクトまたはデータ モデルが更新されたサービスの新しいインスタンスを作成して、データ サービスの新しいバージョンを定義します。  次に、この新しいサービスを、以前のバージョンと区別する新しい URI エンドポイントを使用して公開します。  次に例を示します。  
+  
+-   古いバージョン: `http://services.odata.org/Northwind/v1/Northwind.svc/`  
+  
+-   新しいバージョン: `http://services.odata.org/Northwind/v2/Northwind.svc/`  
+  
+ データ サービスをアップグレードした場合、新しいルート URI を使用するには、新しいデータ サービス メタデータに基づいてクライアントも更新する必要があります。  可能な場合は、新しいバージョンを使用するためのアップグレードが行われていないクライアントをサポートするために、データ サービスの以前のバージョンを保持してください。  データ サービスの古いバージョンは、必要でなくなった時点で削除できます。  データ サービスのエンドポイント URI を外部の構成ファイルに保持することを検討する必要があります。  
+  
+## OData プロトコルのバージョン  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] の新しいバージョンがリリースされると、データ サービスでサポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルの同バージョンがクライアント アプリケーションで使用されていない可能性がでてきます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] の新しいバージョンをサポートするデータ サービスにアクセスできる古いクライアント アプリケーションもあります。  また、アクセス先のデータ サービスよりも新しいバージョンの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] をサポートする、新しいバージョンの [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用しているクライアント アプリケーションもあります。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、これらのバージョン管理シナリオを処理するために [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] で提供されるサポートを利用しています。  さらに、データ サービスが使用する [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] のバージョンとは異なるバージョンがクライアントで指定されている場合に、データ モデル メタデータを生成および使用してクライアント データ サービス クラスを作成するためのサポートも備えられています。  詳細については、「[OData: プロトコルのバージョン指定](http://go.microsoft.com/fwlink/?LinkId=186071)」を参照してください。  
+  
+### バージョンのネゴシエーション  
+ クライアントが要求するバージョンにかかわらず、サービスによって使用される [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルの最高バージョンを定義するようにデータ サービスを構成できます。  そのためには、データ サービスで使用される <xref:System.Data.Services.DataServiceBehavior> の <xref:System.Data.Services.DataServiceBehavior.MaxProtocolVersion%2A> プロパティに <xref:System.Data.Services.Common.DataServiceProtocolVersion> の値を指定します。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ アプリケーションで [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用してデータ サービスにアクセスする場合、アプリケーションで使用している [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] のバージョンと機能により、ライブラリでは自動的にこれらのヘッダーに正しい値が指定されます。  既定では、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では要求された操作をサポートする最も低いプロトコル バーションが使用されます。  
+  
+ 次の表に、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルの特定のバージョンに対する [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] のサポートが用意されている [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] および [!INCLUDE[silverlight](../../../../includes/silverlight-md.md)] のバージョンを示します。  
+  
+|[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのバージョン|サポートが用意されているバージョン|  
+|------------------------------------------------------------------------------|-----------------------|  
+|バージョン 1|-   [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] Service Pack 1 \(SP1\)<br />-   [!INCLUDE[silverlight](../../../../includes/silverlight-md.md)] Version 3|  
+|バージョン 2|-   [!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)]<br />-   [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] SP1 の更新プログラム。  更新プログラムは、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkId=158125) からダウンロードし、インストールできます。<br />-   [!INCLUDE[silverlight](../../../../includes/silverlight-md.md)] Version 4|  
+|バージョン 3|-   [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] バージョン 3 をサポートするプレリリース版は、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkId=203885)からダウンロードし、インストールできます。|  
+  
+### メタデータのバージョン  
+ 既定では、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] ではデータ モデルを表すために CSDL のバージョン 1.1 が使用されます。  リフレクション プロバイダーまたはカスタム データ サービス プロバイダーに基づくデータ モデルの場合は、常にこの CSDL バージョンが使用されます。  ただし、[!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] を使用してデータ モデルを定義している場合は、返される CSDL のバージョンは [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] で使用されるバージョンと同じになります。  CSDL のバージョンは、[スキーマ要素](http://msdn.microsoft.com/ja-jp/396074d8-f99c-4f50-a073-68bce848224f)の名前空間によって決定されます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 仕様 [\[MC\-CSDL\]: 概念スキーマ定義ファイル形式](http://go.microsoft.com/fwlink/?LinkId=159072)。  
+  
+ 返されたメタデータの `DataServices` 要素には `DataServiceVersion` 属性も含まれます。この属性は、応答メッセージの `DataServiceVersion` ヘッダーの値と同じです。  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の **\[サービス参照の追加\]** ダイアログ ボックスなどのクライアント アプリケーションでは、この情報を使用して、データ サービスをホストする [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] のバージョンと正しく連動するクライアント データ サービス クラスを生成します。  詳細については、「[OData: プロトコルのバージョン指定](http://go.microsoft.com/fwlink/?LinkId=186071)」を参照してください。  
+  
+## 参照  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/data-services-providers-wcf-data-services.md b/docs/framework/data/wcf/data-services-providers-wcf-data-services.md
new file mode 100644
index 00000000000..6738f642f2e
--- /dev/null
+++ b/docs/framework/data/wcf/data-services-providers-wcf-data-services.md
@@ -0,0 +1,43 @@
+---
+title: "データ サービス プロバイダー (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, プロバイダー"
+ms.assetid: a0160b1b-3d9c-4cc8-8391-cb0986a60a41
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# データ サービス プロバイダー (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードとしてデータを公開する複数のプロバイダー モデルをサポートします。  このトピックでは、データ ソースに最適な [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] プロバイダーを選択するための情報を示します。  
+  
+## データ ソース プロバイダー  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、データ サービスのデータ モデルを定義する以下のプロバイダーをサポートします。  
+  
+|プロバイダー|説明|  
+|------------|--------|  
+|Entity Framework プロバイダー|このプロバイダーは、ADO.NET Entity Framework を使用して、リレーショナル データにマップするデータ モデルを定義することによってデータ サービスでリレーショナル データを使用します。  データ ソースとしては、SQL Server 以外にも、Entity Framework をサポートするサードパーティ プロバイダーのある任意のデータ ソースを使用できます。  SQL Server データベースなどのリレーショナル データ ソースの場合は、Entity Framework プロバイダーを使用してください。  詳細については、「[Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)」を参照してください。|  
+|リフレクション プロバイダー|このプロバイダーは、リフレクションを使用して、<xref:System.Linq.IQueryable%601> インターフェイスのインスタンスとして公開できる既存のデータ クラスに基づいてデータ モデルを定義できます。  <xref:System.Data.Services.IUpdatable> インターフェイスを実装することによって更新できます。  実行時に定義される静的なデータ クラス \(LINQ to SQL や型指定された DataSet によって生成されたデータ クラスなど\) がある場合は、このプロバイダーを使用してください。  詳細については、「[リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)」を参照してください。|  
+|カスタム データ サービス プロバイダー|[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、遅延バインディング データ型に基づいてデータ モデルを動的に定義できるプロバイダーのセットが含まれています。  公開されるデータが不明な場合、アプリケーションを設計中の場合、または Entity Framework プロバイダーやリフレクション プロバイダーでは不十分な場合には、これらのインターフェイスを実装する必要があります。  詳細については、「[カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)」を参照してください。|  
+  
+## その他のデータ サービス プロバイダー  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、次の追加のデータ サービス プロバイダーがあり、他のいずれかのプロバイダーを使用して定義されたデータ ソースのパフォーマンスが向上します。  
+  
+|プロバイダー|説明|  
+|------------|--------|  
+|ストリーミング プロバイダー|このプロバイダーを使用すると、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用してバイナリ ラージ オブジェクト データ型を公開できます。  ストリーミング プロバイダーは、<xref:System.Data.Services.Providers.IDataServiceStreamProvider> インターフェイスを実装することによって作成されます。  このプロバイダーは、任意のデータ ソース プロバイダーと共に実装できます。  詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。|  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)   
+ [データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/defining-wcf-data-services.md b/docs/framework/data/wcf/defining-wcf-data-services.md
new file mode 100644
index 00000000000..255fab73775
--- /dev/null
+++ b/docs/framework/data/wcf/defining-wcf-data-services.md
@@ -0,0 +1,58 @@
+---
+title: "WCF Data Services の定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 構成"
+ms.assetid: 05006ff3-02dc-410e-831e-54ec3e7e24ef
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# WCF Data Services の定義
+ここでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を作成および構成し、データを [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードとして公開する方法について説明します。  データ サービスを作成する基本的な手順の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)」を参照してください。  
+  
+## このセクションの内容  
+ [データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] によって提供されるデータ サービス構成オプションについて説明します。  
+  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)  
+ データ サービスとしてデータを公開するプロバイダー モデルについて説明します。  
+  
+ [サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)  
+ サーバー上でメソッドを公開するサービス操作を定義する方法について説明します。  
+  
+ [フィードのカスタマイズ](../../../../docs/framework/data/wcf/feed-customization-wcf-data-services.md)  
+ データ サービス プロバイダーおよびデータ フィードの要素によって定義されるデータ モデルのエンティティ間のマッピングを作成する方法について説明します。  
+  
+ [インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)  
+ インターセプター メソッドを定義してデータ サービスへの要求に対してカスタム ビジネス ロジックを実行する方法について説明します。  
+  
+ [WCF Data Services の開発と配置](../../../../docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md)  
+ Visual Studio を使用してデータ サービスを開発および配置する方法について説明します。  
+  
+ [WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)  
+ データ サービスの認証と承認およびセキュリティに関するその他の考慮事項について説明します。  
+  
+ [データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)  
+ データ サービスのホストを選択する方法について説明します。  
+  
+ [データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)  
+ 異なるバージョンの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を使用する方法について説明します。  
+  
+ [WCF Data Services プロトコル実装の詳細](../../../../docs/framework/data/wcf/wcf-data-services-protocol-implementation-details.md)  
+ WCF Data Services で現在実装されていない [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのオプション機能について説明します。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)   
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md b/docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md
new file mode 100644
index 00000000000..68594d1157a
--- /dev/null
+++ b/docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md
@@ -0,0 +1,132 @@
+---
+title: "WCF Data Services の開発と配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 開発"
+  - "WCF Data Services, 配置"
+  - "配置 [WCF Data Services]"
+  - "アプリケーションの開発 [WCF Data Services]"
+ms.assetid: 6557c0e3-5aea-4f6e-bc14-77ad317a168b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WCF Data Services の開発と配置
+このトピックでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の開発と配置について説明します。[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の他の基本情報については、「[概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)」および「[概要](../../../../docs/framework/data/wcf/wcf-data-services-overview.md)」を参照してください。  
+  
+## WCF Data Services の開発  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] をサポートするデータ サービスを作成する場合、開発時に次の基本的なタスクを実行する必要があります。  
+  
+1.  **データ モデルを定義する**  
+  
+     [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、リレーショナル データベースから遅延バインディング データ型に至るさまざまなデータ ソースのデータに基づいてデータ モデルを定義できるようにする各種のデータ サービス プロバイダーをサポートしています。 詳細については、「[データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)」を参照してください。  
+  
+2.  **データ サービスを作成する**  
+  
+     最も基本的なデータ サービスでは、<xref:System.Data.Services.DataService%601> クラスを継承するクラスを `T` 型 \(エンティティ コンテナーの名前空間修飾名\) と一緒に公開します。 詳細については、「[WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)」を参照してください。  
+  
+3.  **データ サービスを構成する**  
+  
+     既定では、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、エンティティ コンテナーによって公開されているリソースへのアクセスは無効になります。<xref:System.Data.Services.DataServiceConfiguration> インターフェイスを使用すると、リソースとサービス操作へのアクセスの構成、サポートされる [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] のバージョンの指定、およびサービス全体のその他の動作 \(バッチ動作や 1 つの応答フィードで返すことができるエンティティの最大数など\) を定義できます。 詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックでは、主に、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用したデータ サービスの開発と配置について説明します。 データを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開できるようにする [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の柔軟性については、「[WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)」を参照してください。  
+  
+### 開発 Web サーバーの選択  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] を使用して WCF Data Services を [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションまたは [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] Web サイトとして開発する場合、開発時にデータ サービスを実行する Web サーバーを選択できます。 次の Web サーバーを [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] と統合することにより、ローカル コンピューターでデータ サービスを簡単にテストおよびデバッグできるようになります。  
+  
+1.  **ローカル IIS サーバー**  
+  
+     インターネット インフォメーション サービス \(IIS\) で実行される [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションまたは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サイトとしてデータ サービスを作成する場合は、ローカル コンピューターで IIS を使用してデータ サービスを開発およびテストすることをお勧めします。 IIS でデータ サービスを実行すると、デバッグ時における HTTP 要求のトレースが容易になります。 また、データ サービスに必要なファイルやデータベースなどのリソースにアクセスするために IIS で必要とされる権限を事前に確認することもできます。 IIS でデータ サービスを実行するには、IIS と [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] がインストールされて正しく構成されており、ファイル システムおよびデータベースで IIS アカウントにアクセス権が付与されている必要があります。 詳細については、「[方法: IIS 上で実行する WCF Data Service を開発する](../../../../docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  開発環境でローカル IIS サーバーを構成できるようにするには、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を管理者権限で実行する必要があります。  
+  
+2.  **Visual Studio 開発サーバー**  
+  
+     [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] には、組み込みの Web サーバーとして、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] プロジェクトの既定の Web サーバーである [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発サーバーが用意されています。 この Web サーバーは、開発時にローカル コンピューターで [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトを実行するように設計されています。 「[WCF Data Services クイックスタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)」では、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 開発サーバーで実行されるデータ サービスを作成する方法を示しています。  
+  
+     [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 開発サーバーを使用してデータ サービスを開発する場合は、次の制限事項に注意する必要があります。  
+  
+    -   このサーバーにはローカル コンピューター上でしかアクセスできません。  
+  
+    -   このサーバーは、HTTP メッセージの既定のポートであるポート 80 ではなく、`localhost` および特定のポートでリッスンします。 詳細については、「[ASP.NET Web プロジェクト用の Visual Studio の Web サーバー](http://msdn.microsoft.com/ja-jp/31d4f588-df59-4b7e-b9ea-e1f2dd204328)」を参照してください。  
+  
+    -   このサーバーでは、現在のユーザー アカウントのコンテキストでデータ サービスが実行されます。 たとえば、管理者レベルのユーザーとして実行する場合、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 開発サーバーで実行されるデータ サービスは、管理者レベルの特権を持ちます。 そのため、データ サービスは、IIS サーバーに配置されたときにはアクセスする権限を持たないリソースにも、アクセスできることになります。  
+  
+    -   このサーバーには、認証など、IIS の必要以上の機能は含まれていません。  
+  
+    -   このサーバーでは、データ サービスから大きなバイナリ データにアクセスするときに [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントによって既定で送信されるチャンク HTTP ストリームを処理できません。 詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。  
+  
+    -   このサーバーでは、キー値で `.` がピリオド \([!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)]\) 文字をサポートしている場合でも、URL のピリオド文字を適切に処理できません。  
+  
+    > [!TIP]
+    >  開発時に [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] 開発サーバーを使用してデータ サービスをテストできる場合でも、IIS を実行する Web サーバーに配置した後でデータ サービスを再度テストする必要があります。  
+  
+3.  **Microsoft Azure 開発環境**  
+  
+     Microsoft Azure Tools for [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] には、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で Microsoft Azure サービスを開発するためのツールの統合セットが含まれています。 これらのツールでは、Microsoft Azure に配置できるデータ サービスを開発し、配置前にローカル コンピューターでデータ サービスをテストすることができます。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して Microsoft Azure プラットフォームで実行されるデータ サービスを開発する場合は、これらのツールを使用してください。 Microsoft Azure Tools for [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] は、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkID=201848)からダウンロードできます。 Microsoft Azure 上で実行されるデータ サービスの開発の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、ブログの記事「[Deploying an OData Service in Microsoft Azure \(Microsoft Azure での OData サービスの配置\)](http://go.microsoft.com/fwlink/?LinkId=201847)」を参照してください。  
+  
+### 開発のヒント  
+ データ サービスを開発する際は、次の点を考慮してください。  
+  
+-   ユーザーを認証する場合や、特定のユーザーのアクセスを制限する場合は、データ サービスのセキュリティ要件を決定します。 詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。  
+  
+-   データ サービスをデバッグするときは、HTTP 検査プログラムを使用すると、要求メッセージおよび応答メッセージの内容を検査できるので非常に便利です。 生のパケットを表示できるネットワーク パケット アナライザーを使用すると、データ サービスの HTTP 要求および HTTP 応答を検査できます。  
+  
+-   データ サービスのデバッグ時は、通常の操作時以上に、データ サービスの詳細なエラー情報が必要になることがあります。 データ サービスから詳細なエラー情報を取得するには、<xref:System.Data.Services.DataServiceConfiguration.UseVerboseErrors%2A> の <xref:System.Data.Services.DataServiceConfiguration> プロパティを `true` に設定し、データ サービス クラスの <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A> 属性の <xref:System.ServiceModel.Description.ServiceDebugBehavior> プロパティを `true` に設定します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][Debugging WCF Data Services \(WCF Data Services のデバッグ\)](http://go.microsoft.com/fwlink/?LinkId=201868)」を参照してください。 また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でトレースを有効にして、HTTP メッセージング レイヤーで発生した例外を表示することもできます。 詳細については、「[トレースの構成](../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」を参照してください。  
+  
+-   データ サービスは、通常、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーション プロジェクトとして開発されますが、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] Web サイト プロジェクトとしてデータ サービスを作成することもできます。 この 2 種類のプロジェクトの違いについては、「[Web Application Projects versus Web Site Projects in Visual Studio \(Visual Studio での Web アプリケーション プロジェクトと Web サイト プロジェクト\)](http://msdn.microsoft.com/ja-jp/2861815e-f5a2-4378-a2f8-b8a86dc012f5)」を参照してください。  
+  
+-   [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の **\[新しい項目の追加\]** ダイアログ ボックスを使用してデータ サービスを作成すると、そのデータ サービスは IIS の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] でホストされます。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] と IIS がデータ サービスの既定のホストですが、その他のホスト オプションもサポートされています。 詳細については、「[データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+## WCF Data Services の配置  
+ WCF Data Services では、データ サービスをホストするプロセスを柔軟に選択できます。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して、次のプラットフォームにデータ サービスを配置できます。  
+  
+-   **IIS でホストされる Web サーバー**  
+  
+     データ サービスを [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトとして開発すると、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の標準配置プロセスを使用して IIS Web サーバーに配置することができます。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] は、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 向けに、配置するデータ サービスをホストする [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロジェクトの種類に応じて次の配置テクノロジを提供します。  
+  
+    -   **ASP.NET Web アプリケーション用の配置テクノロジ**  
+  
+        -   [Web 配置パッケージ](http://msdn.microsoft.com/ja-jp/1f9713c8-9540-494c-b80d-9893b970ad6f)  
+  
+        -   [ワンクリック発行機能](http://msdn.microsoft.com/ja-jp/59226246-99ad-4aec-975d-7c61e8a8911c)  
+  
+    -   **ASP.NET Web サイト用の配置テクノロジ**  
+  
+        -   [Web サイトのコピー ツール](../Topic/How%20to:%20Deploy%20a%20Web%20Site%20Project%20by%20using%20the%20Copy%20Web%20Site%20Tool.md)  
+  
+        -   [Web サイトの発行ツール](../Topic/How%20to:%20Deploy%20a%20Web%20Site%20Project%20by%20Using%20the%20Publish%20Web%20Site%20Tool.md)  
+  
+        -   [XCopy](../Topic/Walkthrough:%20Deploying%20a%20Web%20Site%20Project%20by%20Using%20XCOPY.md)  
+  
+     [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの配置オプションの[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[Web Deployment Overview for Visual Studio and ASP.NET \(Visual Studio と ASP.NET の Web 配置の概要\)](http://msdn.microsoft.com/ja-jp/99bd1927-b59f-4e02-87b4-55c6ba2adbc3)」を参照してください。  
+  
+    > [!TIP]
+    >  データ サービスを IIS に配置する前に、IIS を実行している Web サーバーへの配置をテストしておく必要があります。 詳細については、「[方法: IIS 上で実行する WCF Data Service を開発する](../../../../docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md)」を参照してください。  
+  
+-   **Windows Azure**  
+  
+     Microsoft Azure Tools for [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して、データ サービスを Microsoft Azure に配置できます。 Microsoft Azure Tools for [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] は、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkID=201848)からダウンロードできます。 Microsoft Azure へのデータ サービスの配置の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、ブログの記事「[Deploying an OData Service in Windows Azure \(Microsoft Azure での OData サービスの配置\)](http://go.microsoft.com/fwlink/?LinkId=201847)」を参照してください。  
+  
+### 配置に関する注意事項  
+ データ サービスを配置する際は、次の点を考慮してください。  
+  
+-   [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダーを使用して SQL Server データベースにアクセスするデータ サービスを配置する場合、データ サービスの配置でのデータ構造、データ、またはその両方の反映も必要になることがあります。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] では対象データベースでこの操作を行うスクリプト \(.sql ファイル\) を自動的に作成することができ、これらのスクリプトを [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの Web 配置パッケージに含めることができます。 詳細については、「[方法: Web アプリケーション プロジェクトと共にデータベースを配置する](http://msdn.microsoft.com/ja-jp/683b33f1-8a3d-45cf-af6e-61ab50fc518b)」を参照してください。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サイトの場合は、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の **\[データベースの発行\]** ウィザードを使用してこの操作を実行できます。 詳細については、「[Deploying a Database by Using the Database Publishing Wizard](../Topic/Deploying%20a%20Database%20by%20Using%20the%20Database%20Publishing%20Wizard.md)」を参照してください。  
+  
+-   [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の実装が含まれているので、Windows Server AppFabric を使用して、Windows Server で実行されている IIS に配置されたデータ サービスを監視できます。 Server AppFabric を使用したデータ サービスの監視の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、ブログの記事「[Tracking WCF Data Services with Windows Server AppFabric \(Windows Server AppFabric による WCF Data Services の追跡\)](http://go.microsoft.com/fwlink/?LinkID=202005)」を参照してください。  
+  
+## 参照  
+ [データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)   
+ [WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)   
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md b/docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md
new file mode 100644
index 00000000000..78fbcda2b17
--- /dev/null
+++ b/docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md
@@ -0,0 +1,33 @@
+---
+title: "Entity Framework プロバイダー (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, プロバイダー"
+ms.assetid: 650b5eb6-c71d-4dc1-8b64-b6beaf752114
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Entity Framework プロバイダー (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] と同様に、ADO.NET Entity Framework は、エンティティ リレーションシップ モデルの型である Entity Data Model をベースにしています。  Entity Framework は、Entity Data Model の実装 \(*概念モデル*\) に対する操作をデータ ソースに対する同等の操作に変換します。  このことから、Entity Framework はリレーショナル データに基づくデータ サービスの理想的なプロバイダーとして使用でき、また、Entity Framework をサポートするデータ プロバイダーが存在するデータベースであれば、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で使用できます。  現在エンティティ フレームワークをサポートしているデータ ソースのリストについては、「[エンティティ フレームワークのサード パーティ プロバイダー](http://go.microsoft.com/fwlink/?LinkId=143699)」を参照してください。  
+  
+ 概念モデルでは、エンティティ コンテナーはサービスのルートです。  データ サービスでデータを公開する前に、Entity Framework で概念モデルを定義する必要があります。  詳細については、「[方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md)」を参照してください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、エンティティの同時実行トークンを定義できるようにすることで、オプティミスティック同時実行制御モデルをサポートしています。  この同時実行トークンは、エンティティの 1 つ以上のプロパティが含まれており、要求、更新、または削除されているデータに対して行われた変更があるかどうかを判断するためにデータ サービスによって使用されます。  要求内の eTag から取得したトークンの値がエンティティの現在の値と異なる場合、データ サービスで例外が発生します。  プロパティが同時実行トークンの一部であることを示す場合、[!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダーで定義されているデータ モデルに属性 `ConcurrencyMode="Fixed"` を適用する必要があります。  同時実行トークンには、キー プロパティまたはナビゲーション プロパティを含めることはできません。詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ Entity Framework の詳細については、「[エンティティ フレームワークの概要](../../../../docs/framework/data/adonet/ef/overview.md)」を参照してください。  
+  
+## 参照  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)   
+ [Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md b/docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md
new file mode 100644
index 00000000000..d75e3c7fc5c
--- /dev/null
+++ b/docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md
@@ -0,0 +1,40 @@
+---
+title: "サービスとしてのデータの公開 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "概要, WCF Data Services"
+  - "WCF Data Services, 構成"
+  - "WCF Data Services, 概要"
+ms.assetid: df0bbcee-f66f-4a88-abb4-4e73c8b9c908
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# サービスとしてのデータの公開 (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を Visual Studio に統合すると、サービスを簡単に定義してデータを [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードとして公開できます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開するデータ サービスを作成するには、次のような基本的な手順を実行します。  
+  
+1.  **データ モデルを定義します。** [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、[ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md) に基づくデータ モデルをネイティブでサポートしています。  詳細については、「[方法: ADO.NET Entity Framework データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-an-adonet-ef-data-wcf.md)」を参照してください。  
+  
+     [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、<xref:System.Linq.IQueryable%601> インターフェイスのインスタンスを返す共通言語ランタイム \(CLR\) オブジェクトに基づくデータ モデルもサポートします。  そのため、.NET Framework のリスト、配列、およびコレクションに基づいてデータ サービスを配置できます。これらのデータ構造での作成、更新、および削除操作を有効にするには、<xref:System.Data.Services.IUpdatable> インターフェイスも実装する必要があります。  詳細については、「[方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)」を参照してください。  
+  
+     より高度なシナリオの場合、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、遅延バインディング データ型に基づいてデータ モデルを定義できるプロバイダーのセットが含まれています。  詳細については、「[カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)」を参照してください。  
+  
+2.  **データ サービスを作成します。**最も基本的なデータ サービスでは、<xref:System.Data.Services.DataService%601> クラスを継承するクラスを `T` 型 \(エンティティ コンテナーの名前空間修飾名\) と一緒に公開します。  詳細については、「[WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)」を参照してください。  
+  
+3.  **データ サービスを構成します。**既定では、エンティティ コンテナーによって公開されているリソースへのアクセスは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] によって無効にされます。<xref:System.Data.Services.DataServiceConfiguration> インターフェイスを使用すると、リソースとサービス操作へのアクセスの構成、サポートされる [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] のバージョンの指定、およびサービス全体のその他の動作 \(バッチ動作、1 つの応答で返すことができるエンティティの最大数など\) の定義を行うことができます。詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ Northwind サンプル データベースに基づく単純なデータ サービスを作成する方法の例については、「[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)   
+ [概要](../../../../docs/framework/data/wcf/wcf-data-services-overview.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/feed-customization-wcf-data-services.md b/docs/framework/data/wcf/feed-customization-wcf-data-services.md
new file mode 100644
index 00000000000..8d381c4e5c2
--- /dev/null
+++ b/docs/framework/data/wcf/feed-customization-wcf-data-services.md
@@ -0,0 +1,100 @@
+---
+title: "フィードのカスタマイズ (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services、フィード"
+  - "WCF Data Services、Atom プロトコル"
+  - "Atom 公開プロトコル [WCF Data Services]"
+  - "WCF Data Services、フィードのカスタマイズ"
+ms.assetid: 0d1a39bc-6462-4683-bd7d-e74e0fd28a85
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# フィードのカスタマイズ (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)]使用して、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)]をフィードとしてデータを公開します。 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]データ フィードを Atom と JavaScript Object Notation (JSON) の両方の形式をサポートします。 Atom フィードを使用すると[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]エンティティおよびリレーションシップを HTTP メッセージの本文に含めることのできる XML 形式などのデータをシリアル化の標準的な方法を提供します。 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]エンティティに含まれるデータと Atom 要素間の既定のエンティティとプロパティのマッピングを定義します。 詳細については、次を参照してください。 [OData: Atom 形式](http://go.microsoft.com/fwlink/?LinkID=185794)します。  
+  
+ 場合によっては、データ サービスから返されるプロパティのデータを、標準のフィードの形式ではなくカスタマイズした方法でシリアル化する必要があります。 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]、またはフィード内のエントリのカスタム要素にエントリの未使用の要素と属性には、エンティティのプロパティをマップできますが、データ フィードのシリアル化をカスタマイズできます。  
+  
+> [!NOTE]
+>  フィードのカスタマイズは、Atom フィードでのみサポートされます。 返されたフィードに対して JSON 形式が要求されたときは、カスタム フィードが返されません。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用すると、Atom ペイロードに対するエンティティとプロパティの代替マッピングは、属性をデータ モデルのエンティティ型に手動で適用することによって定義できます。 これらの属性の適用方法は、データ サービスのデータ ソース プロバイダーによって決定されます。  
+  
+> [!IMPORTANT]
+>  カスタム フィードを定義する場合、カスタム マッピングが定義されているすべてのエンティティ プロパティが投影に含まれることを保証する必要があります。 マップされているエンティティ プロパティがこの射影に含まれていない場合、データの損失が発生することがあります。 詳細については、次を参照してください。[クエリ プロジェクション](../../../../docs/framework/data/wcf/query-projections-wcf-data-services.md)します。  
+  
+## <a name="customizing-feeds-with-the-entity-framework-provider"></a>Entity Framework プロバイダーを使用したフィードのカスタマイズ  
+ [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダーで使用されるデータ モデルは、.edmx ファイルの XML として表現されます。 この場合、カスタム フィードを定義する属性が、データ モデルのエンティティ型とプロパティを表現する `EntityType` および `Property` 要素に追加されます。 これらのフィードのカスタマイズ属性が定義されていない[ \[MC-CSDL\]: 概念スキーマ定義ファイル形式](http://go.microsoft.com/fwlink/?LinkId=159072)、形式であること、[!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)]プロバイダーを使用してデータ モデルを定義します。 したがって、フィードのカスタマイズ属性を特定のスキーマ名前空間で宣言する必要があります。これは、`m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata"` として定義されます。 次の XML フラグメントは、`Property`、`Products`、および `ProductName` プロパティを定義する `ReorderLevel` エンティティ型の `UnitsInStock` 要素に適用されたフィードのカスタマイズ属性を示します。  
+  
+  [Astoria カスタム フィード #EdmFeedAttributes](../CodeSnippet/VS_Snippets_Misc/astoria custom feeds#edmfeedattributes)]  
+  
+ これらの属性によって `Products` エンティティ セットに対して次のカスタム データ フィードが生成されます。 このカスタム データ フィードでは、`ProductName` プロパティ値が `author` 要素内に加えて、`ProductName` プロパティ要素としても表示されます。`UnitsInStock` プロパティは、一意の名前空間、および属性としての `ReorderLevel` プロパティと共にカスタム要素に表示されます。  
+  
+  [Astoria カスタム フィード #EdmFeedResultProduct](../CodeSnippet/VS_Snippets_Misc/astoria custom feeds#edmfeedresultproduct)]  
+  
+ 詳細については、次を参照してください。[方法: Entity Framework プロバイダーでフィードをカスタマイズする](../../../../docs/framework/data/wcf/how-to-customize-feeds-with-ef-provider-wcf-data-services.md)です。  
+  
+> [!NOTE]
+>  データ モデルへの拡張はエンティティ デザイナーでサポートされていないので、データ モデルを含む XML ファイルを手動で変更する必要があります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]によって生成される .edmx ファイル、[!INCLUDE[adonet_edm](../../../../includes/adonet-edm-md.md)]ツールを参照してください[.edmx ファイルの概要](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)します。  
+  
+### <a name="custom-feed-attributes"></a>カスタム フィード属性  
+ 次の表に、データ モデルを定義する概念スキーマ定義言語 (CSDL) に追加できるフィードをカスタマイズする XML 属性を示します。 これらの属性が同等のプロパティには、 <xref:System.Data.Services.Common.EntityPropertyMappingAttribute>リフレクション プロバイダーと共に使用します。  
+  
+|属性名|説明|  
+|--------------------|-----------------|  
+|`FC_ContentKind`|コンテンツの種類を示します。 次のキーワードは、配信コンテンツの種類を定義します。<br /><br /> `text:`プロパティの値はフィード内でテキストとして表示されます。<br /><br /> `html:`プロパティの値はフィード内で HTML として表示されます。<br /><br /> `xhtml:`プロパティの値はフィード内で XML 形式の HTML として表示されます。<br /><br /> これらのキーワードの値に相当、 <xref:System.Data.Services.Common.SyndicationTextContentKind>リフレクション プロバイダーと共に使用される列挙体です。<br /><br /> この属性は、`FC_NsPrefix` および `FC_NsUri` 属性が使用されているときはサポートされません。<br /><br /> `xhtml` 属性の値として `FC_ContentKind` を指定する場合、そのプロパティ値に正しい形式の XML が含まれることを確認する必要があります。 データ サービスは、変換を行わずに値を返します。 さらに、返された XML 内の XML 要素のプレフィックスに名前空間 URI、およびマップされたフィード内で定義されたプレフィックスが含まれている必要があります。|  
+|`FC_KeepInContent`|参照されたプロパティ値をフィードのコンテンツ セクションおよびマップされた場所の両方に含める必要があることを示します。 有効値は `true` または `false` です。 結果のフィードの以前のバージョンとの下位互換性のために[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)]の値を指定して`true`フィードのコンテンツ セクションで、値が含まれていることを確認します。|  
+|`FC_NsPrefix`|非配信マッピング内の XML 要素の名前空間プレフィックス。 この属性は、`FC_NsUri` 属性と一緒に使用する必要があります。この属性は、`FC_ContentKind` 属性と一緒に使用できません。|  
+|`FC_NsUri`|非配信マッピング内の XML 要素の名前空間 URI。 この属性は、`FC_NsPrefix` 属性と一緒に使用する必要があります。この属性は、`FC_ContentKind` 属性と一緒に使用できません。|  
+|`FC_SourcePath`|このフィード マッピング規則が適用されるエンティティのプロパティのパス。 この属性は、`EntityType` 要素で使用されている場合にのみサポートされます。<br /><br /> <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.SourcePath%2A>プロパティが複合型を直接参照できません。 複合型の場合は、プロパティ名が円記号 (`/`) で区切られたパス式を使用する必要があります。 エンティティ型に対して次の値を許可するなどの`Person`整数プロパティを使用して`Age`と複雑なプロパティ<br /><br /> `Address`:<br /><br /> `Age`<br /><br /> `Address/Street`<br /><br /> <xref:System.Data.Services.Common.EntityPropertyMappingAttribute.SourcePath%2A>プロパティはスペースまたはその他のプロパティ名に無効な文字を含む値に設定することはできません。|  
+|`FC_TargetPath`|プロパティのマップ先となる結果のフィードのターゲット要素の名前。 この要素は、Atom 仕様またはカスタム要素によって定義された要素である場合があります。<br /><br /> 次のキーワードは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードの特定の場所をポイントする定義済みの配信ターゲット パス値です。<br /><br /> `SyndicationAuthorEmail:``atom:email`の子要素、`atom:author`要素。<br /><br /> `SyndicationAuthorName:``atom:name`の子要素、`atom:author`要素。<br /><br /> `SyndicationAuthorUri:``atom:uri`の子要素、`atom:author`要素。<br /><br /> `SyndicationContributorEmail:``atom:email`の子要素、`atom:contributor`要素。<br /><br /> `SyndicationContributorName:``atom:name`の子要素、`atom:contributor`要素。<br /><br /> `SyndicationContributorUri:``atom:uri`の子要素、`atom:contributor`要素。<br /><br /> `SyndicationCustomProperty:`カスタム プロパティ要素。 カスタム要素にマップする際、ターゲットは、ネストされた要素が円記号 (`/`) で区切られ、属性がアンパサンド (`@`) で指定されたパス式である必要があります。 次の例では、文字列 `UnitsInStock/@ReorderLevel` によってプロパティ値がルート エントリ要素の `ReorderLevel` という子要素の `UnitsInStock` という属性にマップされます。<br /><br /> `<Property Name="ReorderLevel" Type="Int16"               m:FC_TargetPath="UnitsInStock/@ReorderLevel"               m:FC_NsPrefix="Northwind"               m:FC_NsUri="http://schemas.examples.microsoft.com/dataservices"               m:FC_KeepInContent="false"               />`<br /><br /> ターゲットがカスタム要素名の場合、`FC_NsPrefix` および `FC_NsUri` 属性も指定する必要があります。<br /><br /> `SyndicationPublished:``atom:published`要素。<br /><br /> `SyndicationRights:``atom:rights`要素。<br /><br /> `SyndicationSummary:``atom:summary`要素。<br /><br /> `SyndicationTitle:``atom:title`要素。<br /><br /> `SyndicationUpdated:``atom:updated`要素。<br /><br /> これらのキーワードの値に相当、 <xref:System.Data.Services.Common.SyndicationItemProperty>リフレクション プロバイダーと共に使用される列挙体です。|  
+  
+> [!NOTE]
+>  属性名および値では、大文字と小文字が区別されます。 属性は、`EntityType` 要素または&1; つ以上の `Property` 要素に適用されます (両方には適用されません)。  
+  
+## <a name="customizing-feeds-with-the-reflection-provider"></a>リフレクション プロバイダーを使用したフィードのカスタマイズ  
+ リフレクション プロバイダーを使用して実装されたデータ モデル用にフィードをカスタマイズするには、1 つまたは複数のインスタンスを追加、 <xref:System.Data.Services.Common.EntityPropertyMappingAttribute>属性をデータ モデルのエンティティ型を表すクラス。 プロパティ、 <xref:System.Data.Services.Common.EntityPropertyMappingAttribute>クラスは、前のセクションで説明されているフィードのカスタマイズ属性に対応します。 両方のプロパティに対して定義されたカスタム フィード マッピングと共に `Order` 型の宣言の例を次に示します。  
+  
+> [!NOTE]
+>  この例のデータ モデルの定義は、トピックで[方法: リフレクション プロバイダーを使用してデータ サービスを作成](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)します。  
+  
+  [Astoria カスタム フィード #CustomOrderFeed](../CodeSnippet/VS_Snippets_Misc/astoria custom feeds#customorderfeed)]  
+  
+ これらの属性によって `Orders` エンティティ セットに対して次のカスタム データ フィードが生成されます。 このカスタム フィード、`OrderId`プロパティの値がでのみ表示されます、`title`の要素、`entry`と`Customer`プロパティの値では、両方が表示されます、`author`要素として、`Customer`プロパティ要素。  
+  
+  [Astoria カスタム フィード #IQueryableFeedResult](../CodeSnippet/VS_Snippets_Misc/astoria custom feeds#iqueryablefeedresult)]  
+  
+ 詳細については、次を参照してください。[方法: リフレクション プロバイダーでフィードをカスタマイズする](../../../../docs/framework/data/wcf/how-to-customize-feeds-with-the-reflection-provider-wcf-data-services.md)です。  
+  
+## <a name="customizing-feeds-with-a-custom-data-service-provider"></a>カスタム データ サービス プロバイダーを使用したフィードのカスタマイズ  
+ カスタム データ サービス プロバイダーを使用して定義されたデータ モデルが呼び出すことによってリソースの種類の定義用のフィードのカスタマイズ、 <xref:System.Data.Services.Providers.ResourceType.AddEntityPropertyMappingAttribute%2A>上、 <xref:System.Data.Services.Providers.ResourceType>を表すデータ モデルのエンティティ型。 詳細については、次を参照してください。[カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)します。  
+  
+## <a name="consuming-custom-feeds"></a>カスタム フィードの処理  
+ アプリケーションが直接処理する場合、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]フィード、その必要がありますのカスタム要素および返されたフィード内の属性を処理できません。 データ サービス プロバイダーに関係なく、データ モデルにカスタム フィードを実装した場合、`$metadata` エンドポイントは、データ サービスによって返される CSDL のカスタム フィード属性としてカスタム フィード情報を返します。 使用すると、**サービス参照の追加**ダイアログまたは[datasvcutil.exe](../../../../docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md)クライアント データ サービス クラスを生成するツール、カスタム フィード属性が要求と、データ サービスへの応答が正しく処理することを保証するために使用します。  
+  
+## <a name="feed-customization-considerations"></a>フィードのカスタマイズに関する考慮事項  
+ カスタム フィードのマッピングを定義する場合は、以下を検討してください。  
+  
+-   [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントは、フィード内のマップされた要素に含まれているのが空白のみの場合、その要素を空であると見なします。 そのため、空白のみを含むマップされた要素は、同じ空白を使用するクライアントで具体化されません。 この空白をクライアントで維持するには、フィード マッピング属性で `KeepInContext` の値を `true` に設定する必要があります。  
+  
+## <a name="versioning-requirements"></a>バージョン管理の要件  
+ フィードのカスタマイズには、次に示す [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのバージョン管理の要件があります。  
+  
+-   フィードのカスタマイズを行う場合は、クライアントとデータ サービスの両方でバージョン 2.0 以降の [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルがサポートされている必要があります。  
+  
+ 詳細については、次を参照してください。[データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)   
+ [Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md b/docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md
new file mode 100644
index 00000000000..b885f5c6dfe
--- /dev/null
+++ b/docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md
@@ -0,0 +1,64 @@
+---
+title: "データ サービス クライアント ライブラリの生成 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "[サービス参照の追加] ダイアログ ボックス"
+  - "クライアント アプリケーション, WCF Data Services"
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: 314077c1-ac10-47e1-bed4-940b5462359d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# データ サービス クライアント ライブラリの生成 (WCF Data Services)
+[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] を実装しているデータ サービスは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードによって公開されているデータ モデルが記述されたサービス メタデータ ドキュメントを返すことがあります。  詳細については、「[OData: サービス メタデータ ドキュメント](http://go.microsoft.com/fwlink/?LinkId=186070)」を参照してください。Visual Studio の **\[サービス参照の追加\]** ダイアログを使用すると、 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービスに参照を追加できます。  このツールを使用してクライアント プロジェクト内の [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] によって返されるメタデータに参照を追加すると、次のアクションが実行されます。  
+  
+-   データ サービスからのサービス メタデータ ドキュメントが要求され、返されたメタデータが解釈されます。  
+  
+    > [!NOTE]
+    >  返されたメタデータは、クライアント プロジェクトに .edmx ファイルとして保存されます。  .edmx ファイルは、Entity Framework で使用される .edmx ファイルと形式が異なるので、Entity Data Model デザイナーを使用して開くことができません。  このメタデータ ファイルは、XML エディターまたは任意のテキスト エディターを使用して表示できます。  詳細については、「[\[MC\-EDMX\]: データ サービスのパッケージ形式のエンティティ データ モデル](http://go.microsoft.com/fwlink/?LinkID=178833)」仕様を参照してください。  
+  
+-   <xref:System.Data.Services.Client.DataServiceContext> から継承するエンティティ コンテナー クラスとしてサービスの表現が生成されます。  この生成されたエンティティ コンテナー クラスは、Entity Data Model ツールが生成するエンティティ コンテナーに似ています。  詳細については、「[Object Services Overview \(Entity Framework\)](http://msdn.microsoft.com/ja-jp/43014cf9-c9cb-4538-bfbb-197820b60038)」を参照してください。  
+  
+-   サービス メタデータ内で見つかったデータ モデル型のデータ クラスが生成されます。  
+  
+-   `System.Data.Services.Client` アセンブリへの参照がプロジェクトに追加されます。  
+  
+ 詳細については、「[方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)」を参照してください。  
+  
+ クライアント データ サービス クラスは、コマンド プロンプトで [DataSvcUtil.exe](../../../../docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md) ツールを使用して生成することもできます。  詳細については、「[方法: クライアント データ サービス クラスを手動で生成する](../../../../docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md)」を参照してください。  
+  
+## クライアント データ型のマッピング  
+ Visual Studio の **\[サービス参照の追加\]** ダイアログまたは `DataSvcUtil.exe` ツールを使用して、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードに基づいてクライアント データ クラスを生成する場合、次のように .NET Framework データ型がデータ モデルのプリミティブ型にマップされます。  
+  
+|データ モデル型|.NET Framework データ型|  
+|--------------|-------------------------|  
+|`Edm.Binary`|<xref:System.Byte> `[]`|  
+|`Edm.Boolean`|<xref:System.Boolean>|  
+|`Edm.Byte`|<xref:System.Byte>|  
+|`Edm.DateTime`|<xref:System.DateTime>|  
+|`Edm.Decimal`|<xref:System.Decimal>|  
+|`Edm.Double`|<xref:System.Double>|  
+|`Edm.Guid`|<xref:System.Guid>|  
+|`Edm.Int16`|<xref:System.Int16>|  
+|`Edm.Int32`|<xref:System.Int32>|  
+|`Edm.Int64`|<xref:System.Int64>|  
+|`Edm.SByte`|<xref:System.SByte>|  
+|`Edm.Single`|<xref:System.Single>|  
+|`Edm.String`|<xref:System.String>|  
+  
+ 詳細については、「[OData: プリミティブ データ型](http://go.microsoft.com/fwlink/?LinkId=186072)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/getting-started-with-wcf-data-services.md b/docs/framework/data/wcf/getting-started-with-wcf-data-services.md
new file mode 100644
index 00000000000..d15b68d6dca
--- /dev/null
+++ b/docs/framework/data/wcf/getting-started-with-wcf-data-services.md
@@ -0,0 +1,56 @@
+---
+title: "WCF Data Services を使用した作業の開始 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "WCF Data Services, 概要"
+ms.assetid: c832fa5b-cf86-4690-be5a-a226c0e49530
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF Data Services を使用した作業の開始
+このセクションの各トピックでは、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] と、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開および使用する方法を早く理解できるように、基になるテクノロジについて説明しています。  このセクションには、概念説明と[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md) チュートリアルが含まれています。  
+  
+## このセクションの内容  
+ 以降のトピックでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用してデータ サービスを作成する方法について説明します。  
+  
+ [サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用してデータ サービスを作成するために必要な手順について説明します。  
+  
+ [データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する方法について説明します。  
+  
+ [クライアント アプリケーションでのデータ サービスの使用](../../../../docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md)  
+ .NET Framework クライアント アプリケーションで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する方法について説明します。  
+  
+ [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+ Northwind サンプル データベースに基づいてフィードを公開する簡単な [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービスを作成してアクセスする方法を示します。  
+  
+ [アプリケーション シナリオ](../../../../docs/framework/data/wcf/application-scenarios-wcf-data-services.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] でサポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] シナリオのコア セットを紹介します。  
+  
+ [リソース](../../../../docs/framework/data/wcf/wcf-data-services-resources.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] リソースおよび [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] リソースへのリンクが掲載されています。  
+  
+## 関連項目  
+ [WCF Data Services \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkID=143149)  
+  
+ [はじめに](../../../../docs/framework/data/adonet/ef/getting-started.md)  
+  
+## 参照  
+ [OData SDK](http://go.microsoft.com/fwlink/?LinkID=185248)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md b/docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md
new file mode 100644
index 00000000000..44b627d2dac
--- /dev/null
+++ b/docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md
@@ -0,0 +1,87 @@
+---
+title: "データ サービスのホスティング (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "WCF Data Services, 構成"
+  - "WCF Data Services, Windows Communication Foundation"
+ms.assetid: b48f42ce-22ce-4f8d-8f0d-f7ddac9125ee
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# データ サービスのホスティング (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して、データを [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードとして公開するサービスを作成できます。  このデータ サービスは、<xref:System.Data.Services.DataService%601> から継承されたクラスとして定義されます。  このクラスは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] からの要求に応じて、要求メッセージの処理、データ ソースに対する更新の実行、および応答メッセージの生成に必要な機能を提供します。ただし、データ サービスは、受信 HTTP 要求のネットワーク ソケットにバインドしたり、これをリッスンしたりすることはできません。  この機能要件のため、データ サービスはホスティング コンポーネントに依存します。  
+  
+ データ サービス ホストは、データ サービスに代わって次のタスクを実行します。  
+  
+-   要求をリッスンし、その要求をデータ サービスにルーティングする。  
+  
+-   要求ごとにデータ サービスのインスタンスを作成する。  
+  
+-   受信要求を処理するようデータ サービスに要求する。  
+  
+-   データ サービスに代わって応答を送信する。  
+  
+ データ サービスのホスティングを簡素化するため、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は Windows Communication Foundation \(WCF\) と統合するように設計されています。  データ サービスは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションでデータ サービス ホストとして機能する既定の WCF 実装を提供します。  そのため、次のいずれかの方法でデータ サービスをホストできます。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーション  
+  
+-   自己ホスト型 WCF サービスをサポートするマネージ アプリケーション  
+  
+-   その他のカスタム データ サービス ホスト  
+  
+## ASP.NET アプリケーションでのデータ サービスのホスト  
+ Visual Studio の **\[新しい項目の追加\]** ダイアログを使用して ASP.NET アプリケーションにデータ サービスを定義すると、プロジェクトに 2 つの新しいファイルが生成されます。  そのうち一方のファイル \(拡張子は `.svc`\) は、データ サービスのインスタンス化方法を WCF ランタイムに指示します。  たとえば、[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成される Northwind サンプル データ サービスの .svc ファイルは次のようになります。  
+  
+```  
+<%@ ServiceHost Language="C#"   
+    Factory="System.Data.Services.DataServiceHostFactory,   
+            System.Data.Services, Version=4.0.0.0,   
+            Culture=neutral, PublicKeyToken=b77a5c561934e089"   
+    Service="NorthwindService.Northwind" %>   
+```  
+  
+ このディレクティブは、<xref:System.Data.Services.DataServiceHostFactory> クラスを使用して、名前付きのデータ サービス クラスのサービス ホストを作成するようアプリケーションに指示します。  
+  
+ `.svc` ファイルの分離コード ページには、データ サービス自体の実装であるクラスが含まれます。Northwind サンプル データ サービスの場合、このクラスは次のように定義されます。  
+  
+ [!code-csharp[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart service/cs/northwind.svc.cs#servicedefinition)]
+ [!code-vb[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart service/vb/northwind.svc.vb#servicedefinition)]  
+  
+ データ サービスは WCF サービスと同様に動作するため、データ サービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] と統合され、WCF Web プログラミング モデルに従います。詳細については、「[WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」と「[WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)」を参照してください。  
+  
+## 自己ホスト型 WCF サービス  
+ WCF 実装が組み込まれている [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、WCF サービスとして自己ホスト型のデータ サービスをサポートします。  サービスは、コンソール アプリケーションなどの任意の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションで自己ホスト型とすることができます。  <xref:System.ServiceModel.Web.WebServiceHost> を継承する <xref:System.Data.Services.DataServiceHost> クラスを使用して、特定のアドレスでデータ サービスをインスタンス化します。  
+  
+ 自己ホストを使用するとサービスの配置とトラブルシューティングが容易になるので、開発時やテスト時に役立ちます。  ただし、この種類のホスティングでは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] またはインターネット インフォメーション サービス \(IIS\) に備わっている高度なホスト機能や管理機能を使用できません。詳細については、「[マネージ アプリケーションのホスト](../../../../docs/framework/wcf/feature-details/hosting-in-a-managed-application.md)」を参照してください。  
+  
+## カスタム データ サービス ホストの定義  
+ WCF ホストの実装の制限が厳格すぎる場合、データ サービスのカスタム ホストを定義することもできます。  <xref:System.Data.Services.IDataServiceHost> インターフェイスを実装する任意のクラスをデータ サービスのネットワーク ホストとして使用できます。  カスタム ホストは、<xref:System.Data.Services.IDataServiceHost> インターフェイスを実装し、データ サービス ホストの次の基本的な役割を果たすことができるようにする必要があります。  
+  
+-   データ サービスにサービス ルート パスを提供する。  
+  
+-   適切な <xref:System.Data.Services.IDataServiceHost> メンバーの実装に対する要求ヘッダーおよび応答ヘッダーの情報を処理する。  
+  
+-   データ サービスで発生する例外を処理する。  
+  
+-   クエリ文字列のパラメーターを検証する。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)   
+ [データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md b/docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md
new file mode 100644
index 00000000000..474012b653f
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md
@@ -0,0 +1,41 @@
+---
+title: "方法: データ サービス参照を追加する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 構成"
+ms.assetid: 62c6f318-3ee1-433a-b7a3-efa234c3034c
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービス参照を追加する (WCF Data Services)
+Visual Studio の **\[サービス参照の追加\]** ダイアログを使用して、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] に参照を追加できます。  参照をデータ サービスに追加すると、Visual Studio で開発したクライアント アプリケーションのデータ サービスに容易にアクセスできます。  この手順を完了すると、データ サービスから取得されたメタデータに基づいてデータ クラスが生成されます。  詳細については、「[データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)」を参照してください。  
+  
+### データ サービス参照を追加するには  
+  
+1.  \(オプション\) データ サービスがソリューションの一部ではなく、実行していない場合は、データ サービスを開始して、データ サービスの URI を記録します。  
+  
+2.  クライアント プロジェクトを右クリックして、**\[サービス参照の追加\]** をクリックします。  
+  
+3.  データ サービスが現在のソリューションの一部である場合は、**\[探索\]** をクリックします。  
+  
+     または  
+  
+     **\[アドレス\]** ボックスにデータ サービスのベース URL \(`http://localhost:1234/Northwind.svc` など\) を入力して **\[移動\]** をクリックします。  
+  
+4.  **\[OK\]** をクリックします。  
+  
+     新しいコード ファイルが追加されます。このコード ファイルには、データ サービス リソースにアクセスし、オブジェクトとしてデータ サービス リソースと対話するデータ クラスが含まれています。  
+  
+## 参照  
+ [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-add-modify-and-delete-entities-wcf-data-services.md b/docs/framework/data/wcf/how-to-add-modify-and-delete-entities-wcf-data-services.md
new file mode 100644
index 00000000000..462358f1b11
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-add-modify-and-delete-entities-wcf-data-services.md
@@ -0,0 +1,54 @@
+---
+title: "方法: エンティティを追加、変更、および削除する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 変更 (データを)"
+ms.assetid: a00f8933-b232-4445-95ba-adc634f055d8
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: エンティティを追加、変更、および削除する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリでは、<xref:System.Data.Services.Client.DataServiceContext> のオブジェクトで同等のアクションを実行して、データ サービスのエンティティ データを作成、更新、および削除できます。  詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、新しいオブジェクト インスタンスを作成し、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> メソッドを呼び出してコンテキスト内に項目を作成します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたときに HTTP POST メッセージがデータ サービスに送信されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddProduct](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addproduct)]
+ [!code-vb[Astoria Northwind Client#AddProduct](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addproduct)]  
+  
+## 使用例  
+ 次の例では、既存のオブジェクトを取得および変更してから、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> メソッドを呼び出してコンテキスト内の項目を更新済みとしてマークします。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたとき HTTP MERGE メッセージがデータ サービスに送信されます。  
+  
+ [!code-csharp[Astoria Northwind Client#ModifyCustomer](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#modifycustomer)]
+ [!code-vb[Astoria Northwind Client#ModifyCustomer](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#modifycustomer)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> メソッドを呼び出して、コンテキスト内の項目を Deleted とマークします。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたとき HTTP DELETE メッセージがデータ サービスに送信されます。  
+  
+ [!code-csharp[Astoria Northwind Client#DeleteProduct](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#deleteproduct)]
+ [!code-vb[Astoria Northwind Client#DeleteProduct](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#deleteproduct)]  
+  
+## 使用例  
+ 次の例では、新しいオブジェクト インスタンスを作成し、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.AddRelatedObject%2A> メソッドを呼び出して、関連する注文へのリンクと共に、コンテキスト内に項目を作成します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたときに HTTP POST メッセージがデータ サービスに送信されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddOrderDetailToOrderAuto](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addorderdetailtoorderauto)]
+ [!code-vb[Astoria Northwind Client#AddOrderDetailToOrderAuto](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addorderdetailtoorderauto)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [方法: 既存のエンティティを DataServiceContext にアタッチする](../../../../docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md)   
+ [方法: エンティティ リレーションシップを定義する](../../../../docs/framework/data/wcf/how-to-define-entity-relationships-wcf-data-services.md)   
+ [バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md b/docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md
new file mode 100644
index 00000000000..ebbb3e4d07b
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md
@@ -0,0 +1,54 @@
+---
+title: "方法: データ サービス クエリにクエリ オプションを追加する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ サービスのクエリ [WCF Data Services]"
+  - "WCF Data Services, データへのアクセス"
+  - "WCF Data Services, 照会"
+ms.assetid: e4258526-557e-4e96-91e1-2175400c7c8f
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービス クエリにクエリ オプションを追加する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、生成されたクライアント データ サービス クラスを使用して、.NET Framework ベースのクライアント アプリケーションからデータ サービスをクエリできます。そのための最も簡単な方法は、必要なクエリ オプションを含む統合言語クエリ \(LINQ\) クエリ式を作成することです。  また、一連の LINQ クエリ メソッドを呼び出しても同等のクエリを作成できます。  最後に <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを使用して、クエリにクエリ オプションを追加できます。  これらの場合のそれぞれにおいて、クライアントによって生成される URI には、要求されたエンティティ セットに選択したクエリ オプションを適用したものが含まれます。  詳細については、「[データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、運賃が $30 以上の注文だけを返し、結果を出荷日で降順に並べ替える LINQ クエリ式の作成方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#AddQueryOptionsLinq](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addqueryoptionslinq)]
+ [!code-vb[Astoria Northwind Client#AddQueryOptionsLinq](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addqueryoptionslinq)]  
+  
+## 使用例  
+ 次の例では、前のクエリと同等の LINQ クエリ メソッドを使用して LINQ クエリを作成する方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#AddQueryOptionsLinqExpression](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addqueryoptionslinqexpression)]
+ [!code-vb[Astoria Northwind Client#AddQueryOptionsLinqExpression](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addqueryoptionslinqexpression)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを使用して、前の例と同等の <xref:System.Data.Services.Client.DataServiceQuery%601> を作成する方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#AddQueryOptions](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addqueryoptions)]
+ [!code-vb[Astoria Northwind Client#AddQueryOptions](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addqueryoptions)]  
+  
+## 使用例  
+ 次の例は、`$orderby` クエリ オプションを使用して、返された Orders オブジェクトをフィルターして Freight プロパティで並べ替える方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#OrderWithFilter](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#orderwithfilter)]
+ [!code-vb[Astoria Northwind Client#OrderWithFilter](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#orderwithfilter)]  
+  
+## 参照  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)   
+ [方法: クエリ結果を射影する](../../../../docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-bind-data-using-a-project-data-source-wcf-data-services.md b/docs/framework/data/wcf/how-to-bind-data-using-a-project-data-source-wcf-data-services.md
new file mode 100644
index 00000000000..9a00eabbd94
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-bind-data-using-a-project-data-source-wcf-data-services.md
@@ -0,0 +1,125 @@
+---
+title: "方法: プロジェクト データ ソースを使用してデータをバインドする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, WCF Data Services"
+  - "WCF Data Services, データ バインディング"
+ms.assetid: 2477af0a-676f-44f7-b73d-e66208785509
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: プロジェクト データ ソースを使用してデータをバインドする (WCF Data Services)
+生成されたデータ オブジェクトに基づいて [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント アプリケーション内にデータ ソースを作成できます。  **\[サービス参照の追加\]** ダイアログを使用して参照をデータ サービスに追加すると、生成されたクライアント データ クラスと一緒にプロジェクト データ ソースが作成されます。データ サービスが公開する各エンティティ セットに対して 1 つのデータ ソースが作成されます。  **\[データ ソース\]** ウィンドウからデータ ソースの項目をデザイナーにドラッグして、サービスのデータを表示するフォームを作成できます。  これらの項目は、データ ソースにバインドされているコントロールになります。  実行中、このデータ ソースは <xref:System.Data.Services.Client.DataServiceCollection%601> クラスのインスタンスにバインドされます。このインスタンスには、クエリによってデータ サービスに返されるオブジェクトが挿入されます。  詳細については、「[コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+### WPF ウィンドウでプロジェクト データ ソースを使用するには  
+  
+1.  WPF プロジェクトで Northwind データ サービスへの参照を追加します。  詳細については、「[方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)」を参照してください。  
+  
+2.  **\[データ ソース\]** ウィンドウで **\[NorthwindEntities\]** プロジェクト データ ソースの \[`Customers`\] ノードを展開します。  
+  
+3.  **\[CustomerID\]** 項目をクリックし、一覧から **\[ComboBox\]** を選択して **\[CustomerID\]** 項目を **\[Customers\]** ノードからデザイナーにドラッグします。  
+  
+     ウィンドウの XAML ファイルに次のオブジェクト要素が作成されます。  
+  
+    -   `customersViewSource` という名前の <xref:System.Windows.Data.CollectionViewSource> 要素。  最上位レベルの <xref:System.Windows.Controls.Grid> オブジェクト要素の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティが、この新しい <xref:System.Windows.Data.CollectionViewSource> に設定されます。  
+  
+    -   `CustomerID` という名前のデータ バインド <xref:System.Windows.Controls.ComboBox>。  
+  
+    -   <xref:System.Windows.Controls.Label>  
+  
+4.  **\[Orders\]** ナビゲーション プロパティをデザイナーにドラッグします。  
+  
+     ウィンドウの XAML ファイルに次の追加オブジェクト要素が作成されます。  
+  
+    -   `customersOrdersViewSource` という名前の 2 番目の <xref:System.Windows.Data.CollectionViewSource> 要素。このソースは `customerViewSource` です。  
+  
+    -   `ordersDataGrid` という名前のデータ バインド <xref:System.Windows.Controls.DataGrid> コントロール。  
+  
+5.  \(省略可能\) 追加の項目を **\[Customers\]** ノードからデザイナーにドラッグします。  
+  
+6.  フォームのコード ページを開き、次に示す `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersUsingWpf](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf2.xaml.cs#customersordersusingwpf)]  
+  
+7.  フォームを定義する部分クラスで、<xref:System.Data.Objects.ObjectContext> インスタンスを作成し、`customerID` の定数を定義する次のコードを追加します。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersDefinitionWpf](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf2.xaml.cs#customersordersdefinitionwpf)]
+     [!code-vb[Astoria Northwind Client#CustomersOrdersDefinitionWpf](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf2.xaml.vb#customersordersdefinitionwpf)]  
+  
+8.  デザイナーでウィンドウを選択します。  
+  
+    > [!NOTE]
+    >  ウィンドウ内にある内容を選択するのではなく、ウィンドウ自身を選択します。  ウィンドウを選択すると、**\[プロパティ\]** ウィンドウの上部近くの **\[名前\]** テキスト ボックスにウィンドウ名が表示されます。  
+  
+9. **\[プロパティ\]** ウィンドウで、**\[イベント\]** ボタンをクリックします。  
+  
+10. **\[Loaded\]** イベントを見つけて、このイベントの横にあるドロップダウン リストをダブルクリックします。  
+  
+     Visual Studio でウィンドウの分離コード ファイルが開き、<xref:System.Windows.FrameworkElement.Loaded> イベント ハンドラーが生成されます。  
+  
+11. 新しく作成された <xref:System.Windows.FrameworkElement.Loaded> イベント ハンドラーで、次のコードをコピーして貼り付けます。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersDataBindingWpf](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderswpf2.xaml.cs#customersordersdatabindingwpf)]
+     [!code-vb[Astoria Northwind Client#CustomersOrdersDataBindingWpf](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderswpf2.xaml.vb#customersordersdatabindingwpf)]  
+  
+12. このコードは、関連する `Orders` オブジェクトと一緒に `Customers` の <xref:System.Collections.Generic.IEnumerable%601> を Northwind データ サービスから返す LINQ クエリの実行に基づいて `Customers` 型の <xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを作成し、`customersViewSource` にバインドします。  
+  
+### Windows フォームでプロジェクト データ ソースを使用するには  
+  
+1.  **\[データ ソース\]** ウィンドウで **\[NorthwindEntities\]** プロジェクト データ ソースの \[**Customers**\] ノードを展開します。  
+  
+2.  **\[CustomerID\]** 項目をクリックし、一覧から **\[ComboBox\]** を選択して **\[CustomerID\]** 項目を **\[Customers\]** ノードからデザイナーにドラッグします。  
+  
+     次のコントロールがフォーム上に作成されます。  
+  
+    -   `customersBindingSource` という名前の <xref:System.Windows.Forms.BindingSource> のインスタンス。  
+  
+    -   `customersBindingNavigator` という名前の <xref:System.Windows.Forms.BindingNavigator> のインスタンス。  このコントロールは必要ないので削除できます。  
+  
+    -   `CustomerID` という名前のデータ バインド <xref:System.Windows.Forms.ComboBox>。  
+  
+    -   <xref:System.Windows.Forms.Label>  
+  
+3.  **\[Orders\]** ナビゲーション プロパティをフォームにドラッグします。  
+  
+4.  これにより、<xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティが `customersBindingSource` に設定され、<xref:System.Windows.Forms.BindingSource.DataMember%2A> プロパティが `Customers` に設定された `ordersBindingSource` コントロールが作成されます。  また、`ordersDataGridView` データ バインド コントロールも、適切なタイトルのラベル コントロールと共にフォーム上に作成されます。  
+  
+5.  \(省略可能\) 追加の項目を **\[Customers\]** ノードからデザイナーにドラッグします。  
+  
+6.  フォームのコード ページを開き、次に示す `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersUsing](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorders.cs#customersordersusing)]
+     [!code-vb[Astoria Northwind Client#CustomersOrdersUsing](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorders.vb#customersordersusing)]  
+  
+7.  フォームを定義する部分クラスで、<xref:System.Data.Objects.ObjectContext> インスタンスを作成し、`customerID` の定数を定義する次のコードを追加します。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersDefinition](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorders.cs#customersordersdefinition)]
+     [!code-vb[Astoria Northwind Client#CustomersOrdersDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorders.vb#customersordersdefinition)]  
+  
+8.  フォーム デザイナーで、フォームをダブルクリックします。  
+  
+     フォームのコード ページが開き、フォームの `Load` イベントを処理するメソッドが作成されます。  
+  
+9. `Load` イベント ハンドラーで、次のコードをコピーして貼り付けます。  
+  
+     [!code-csharp[Astoria Northwind Client#CustomersOrdersDataBinding](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorders.cs#customersordersdatabinding)]
+     [!code-vb[Astoria Northwind Client#CustomersOrdersDataBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorders.vb#customersordersdatabinding)]  
+  
+10. このコードは、Northwind データ サービスから `Customers` の <xref:System.Collections.Generic.IEnumerable%601> を返す <xref:System.Data.Services.Client.DataServiceQuery%601> の実行に基づいて `Customers` 型の <xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを作成し、`customersBindingSource` にバインドします。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [方法: Windows Presentation Foundation 要素にデータをバインドする](../../../../docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-customize-data-binding-behaviors-wcf-data-services.md b/docs/framework/data/wcf/how-to-customize-data-binding-behaviors-wcf-data-services.md
new file mode 100644
index 00000000000..f7b26a24ac7
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-customize-data-binding-behaviors-wcf-data-services.md
@@ -0,0 +1,40 @@
+---
+title: "方法: データ バインディングの動作をカスタマイズする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, カスタマイズ"
+  - "WCF Data Services, データ バインド"
+ms.assetid: 40476b89-8941-4771-8d21-2fe430c85a9d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ バインディングの動作をカスタマイズする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、バインディング コレクションにオブジェクトを追加したとき、バインディング コレクションからオブジェクトを削除したとき、またはプロパティ変更が検出されたときに、<xref:System.Data.Services.Client.DataServiceCollection%601> によって呼び出されるカスタム ロジックを指定できます。  このカスタム ロジックは、<xref:System.Func%602> デリゲートと呼ばれるメソッドとして提供されています。これらは、カスタム メソッドの完了時にも既定の動作を実行する必要がある場合は `false` を返し、イベントの後続の処理を停止する必要がある場合は `true` を返します。  
+  
+ このトピックの例は、<xref:System.Data.Services.Client.DataServiceCollection%601> の `entityChanged` パラメーターと `entityCollectionChanged` パラメーターの両方のカスタム メソッドを示します。  このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の XAML ファイルの分離コード ページは、バインディング コレクションにバインドされたデータへの変更が発生すると呼び出される <xref:System.Data.Services.Client.DataServiceCollection%601> とカスタム メソッドを作成します。  <xref:System.Collections.ObjectModel.ObservableCollection%601.CollectionChanged> イベントが発生すると、指定したメソッドは、バインディング コレクションから削除された項目がデータ サービスから削除されることを防止します。  <xref:System.Collections.ObjectModel.ObservableCollection%601.PropertyChanged> イベントが発生すると、出荷済みの注文に対する変更がないことを確認するために、`ShipDate` の値が検証されます。  
+  
+ [!code-csharp[Astoria Northwind Client#WpfDataBindingCustom](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customerorderscustom.xaml.cs#wpfdatabindingcustom)]
+ [!code-vb[Astoria Northwind Client#WpfDataBindingCustom](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom.xaml.vb#wpfdatabindingcustom)]
+ [!code-vb[Astoria Northwind Client#WpfDataBindingCustom](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom2.xaml.vb#wpfdatabindingcustom)]  
+  
+## 使用例  
+ 次の XAML は、前の例のウィンドウを定義します。  
+  
+ [!code-xml[Astoria Northwind Client#WpfDataBindingCustomXaml](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customerorderscustom.xaml#wpfdatabindingcustomxaml)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-customize-feeds-with-ef-provider-wcf-data-services.md b/docs/framework/data/wcf/how-to-customize-feeds-with-ef-provider-wcf-data-services.md
new file mode 100644
index 00000000000..85345825758
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-customize-feeds-with-ef-provider-wcf-data-services.md
@@ -0,0 +1,51 @@
+---
+title: "方法: Entity Framework プロバイダーでフィードをカスタマイズする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, カスタマイズ"
+  - "WCF Data Services, フィードのカスタマイズ"
+ms.assetid: fd16272e-36f2-415e-850e-8a81f2b17525
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法: Entity Framework プロバイダーでフィードをカスタマイズする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービス応答の Atom シリアル化をカスタマイズして、AtomPub プロトコルで定義されている未使用の要素にエンティティのプロパティをマップできます。  このトピックでは、Entity Framework を使用して、.edmx ファイルで定義されているデータ モデルのエンティティ型のマッピング属性を定義する方法について説明します。  詳細については、「[フィードのカスタマイズ](../../../../docs/framework/data/wcf/feed-customization-wcf-data-services.md)」を参照してください。  
+  
+ このトピックでは、ツールによって生成された .edmx file ファイルを手動で変更します \(このファイルには、データ モデルが含まれます\)。  エンティティ デザイナーではデータ モデルへの拡張がサポートされていないので、このファイルは手動で変更する必要があります。  Entity Data Model ツールによって生成される .edmx ファイルの詳細については、「[.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)」を参照してください。  このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+### Northwind.edmx ファイルを手動で変更してフィードのカスタマイズ属性を追加するには  
+  
+1.  **ソリューション エクスプローラー**で `Northwind.edmx` ファイルを右クリックして、**\[プログラムから開く\]** をクリックします。  
+  
+2.  **\[Northwind.edmx を開くアプリケーションの選択\]** ダイアログ ボックスで、**\[XML エディター\]** をクリックし、**\[OK\]** をクリックします。  
+  
+3.  `ConceptualModels` 要素を見つけて、フィードのカスタマイズ マッピング属性を含む次の要素で既存の `Customers` エンティティ型を置き換えます。  
+  
+     [!code-xml[Astoria Custom Feeds#EdmFeedCustomers](../../../../samples/snippets/xml/VS_Snippets_Misc/astoria custom feeds/xml/northwind.csdl#edmfeedcustomers)]  
+  
+4.  変更を保存して Northwind.edmx ファイルを閉じます。  
+  
+5.  \(オプション\) Northwind.edmx ファイルを右クリックして、**\[カスタム ツールの実行\]** をクリックします。  
+  
+     オブジェクト レイヤー ファイルが再生成されます。このファイルが必要になる場合があります。  
+  
+6.  プロジェクトを再コンパイルします。  
+  
+## 使用例  
+ 前の例では、`http://myservice/` `Northwind.svc/Customers('ALFKI')` という URI に対して次の結果が返されます。  
+  
+ [!code-xml[Astoria Custom Feeds#EdmFeedResult](../../../../samples/snippets/xml/VS_Snippets_Misc/astoria custom feeds/xml/edmfeedresult.xml#edmfeedresult)]  
+  
+## 参照  
+ [Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-customize-feeds-with-the-reflection-provider-wcf-data-services.md b/docs/framework/data/wcf/how-to-customize-feeds-with-the-reflection-provider-wcf-data-services.md
new file mode 100644
index 00000000000..87745fa1bb7
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-customize-feeds-with-the-reflection-provider-wcf-data-services.md
@@ -0,0 +1,39 @@
+---
+title: "方法: リフレクション プロバイダーでフィードをカスタマイズする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, カスタマイズ"
+  - "WCF Data Services, フィードのカスタマイズ"
+ms.assetid: 00c23dcf-9bb8-459a-a012-6c4d9bcad7e9
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: リフレクション プロバイダーでフィードをカスタマイズする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービス応答の Atom シリアル化をカスタマイズして、AtomPub プロトコルで定義されている未使用の要素にエンティティのプロパティをマップできます。  このトピックでは、リフレクション プロバイダーを使用して、定義されているデータ モデル内のエンティティ型のマッピング属性を定義する方法について説明します。  詳細については、「[フィードのカスタマイズ](../../../../docs/framework/data/wcf/feed-customization-wcf-data-services.md)」を参照してください。  
+  
+ 次の例のデータ モデルは、トピック「[方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)」で定義されています。  
+  
+## 使用例  
+ 次の例では、`Order` 型の両方のプロパティが既存の Atom 要素にマップされます。  `Item` 型の `Product` プロパティは、別の名前空間のカスタム フィード属性にマップされます。  
+  
+ [!code-csharp[Astoria Custom Feeds#CustomIQueryableFeeds](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria custom feeds/cs/orderitems.svc.cs#customiqueryablefeeds)]
+ [!code-vb[Astoria Custom Feeds#CustomIQueryableFeeds](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria custom feeds/vb/orderitems.svc.vb#customiqueryablefeeds)]  
+  
+## 使用例  
+ 前の例では、URI `http://myservice/OrderItems.svc/Orders(0)?$expand=Items` に次の結果が返されます。  
+  
+ [!code-xml[Astoria Custom Feeds#IQueryableFeedResultInline](../../../../samples/snippets/xml/VS_Snippets_Misc/astoria custom feeds/xml/iqueryablefeedresultinline.xml#iqueryablefeedresultinline)]  
+  
+## 参照  
+ [リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md b/docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md
new file mode 100644
index 00000000000..d0012ffa0dd
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md
@@ -0,0 +1,61 @@
+---
+title: "方法: サービス操作を定義する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス操作 [WCF Data Services]"
+  - "WCF Data Services, サービス操作"
+ms.assetid: dfcd3cb1-2f07-4d0b-b16a-6b056c4f45fa
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: サービス操作を定義する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、サーバー上でサービス操作として定義されたメソッドを公開します。  サービス操作では、データ サービスを使用して、サーバー上で定義されているメソッドに URI を介してアクセスできます。  サービス操作を定義するには、`[WebGet]` 属性または `[WebInvoke]` 属性をメソッドに適用します。  クエリ演算子をサポートするには、サービス操作は、<xref:System.Linq.IQueryable%601> インスタンスを返す必要があります。  サービス操作は、<xref:System.Data.Services.DataService%601> の <xref:System.Data.Services.DataService%601.CurrentDataSource%2A> プロパティを介して、基になるデータ ソースにアクセスできます。詳細については「[サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、`GetOrdersByCity` という名前のサービス操作を定義します。このサービス操作は、`Orders` オブジェクトおよび関連する `Order_Details` オブジェクトのフィルターされた <xref:System.Linq.IQueryable%601> インスタンスを返します。  この例は、Northwind サンプル データ サービスのデータ ソースである <xref:System.Data.Objects.ObjectContext> インスタンスにアクセスします。  このサービスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+### Northwind データ サービスのサービス操作を定義するには  
+  
+1.  Northwind データ サービス プロジェクトで Northwind.svc ファイルを開きます。  
+  
+2.  `Northwind` クラスで、次に示すように `GetOrdersByCity` というサービス操作メソッドを定義します。  
+  
+     [!code-csharp[Astoria Northwind Service#ServiceOperationDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#serviceoperationdef)]
+     [!code-vb[Astoria Northwind Service#ServiceOperationDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#serviceoperationdef)]  
+  
+3.  `Northwind` クラスの `InitializeService` メソッドで次のコードを追加して、サービス操作へのアクセスを有効にします。  
+  
+     [!code-csharp[Astoria Northwind Service#ServiceOperationConfig](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#serviceoperationconfig)]
+     [!code-vb[Astoria Northwind Service#ServiceOperationConfig](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#serviceoperationconfig)]  
+  
+### GetOrdersByCity サービス操作をクエリするには  
+  
+-   Web ブラウザーで次のいずれかの URI を入力して、次の例で定義されているサービス操作を呼び出します。  
+  
+    -   `http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'`  
+  
+    -   `http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$top=2`  
+  
+    -   `http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$expand=Order_Details&$orderby=RequiredDate desc`  
+  
+## 使用例  
+ 次の例は、`GetOrderByCity` という名前のサービス操作を Northwind データ サービスに実装します。  この操作は、ADO.NET Entity Framework を使用して、`Orders` オブジェクトのセットおよび関連する `Order_Details` オブジェクトを、指定した都市名に基づく <xref:System.Linq.IQueryable%601> インスタンスとして返します。  
+  
+> [!NOTE]
+>  メソッドは <xref:System.Linq.IQueryable%601> インスタンスを返すので、クエリ操作は、このサービス操作エンドポイントでサポートされています。  
+  
+ [!code-csharp[Astoria Northwind Service#ServiceOperation](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#serviceoperation)]
+ [!code-vb[Astoria Northwind Service#ServiceOperation](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#serviceoperation)]  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-define-entity-relationships-wcf-data-services.md b/docs/framework/data/wcf/how-to-define-entity-relationships-wcf-data-services.md
new file mode 100644
index 00000000000..b37f6a4592f
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-define-entity-relationships-wcf-data-services.md
@@ -0,0 +1,40 @@
+---
+title: "方法: エンティティ リレーションシップを定義する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 変更 (データを)"
+ms.assetid: cc255524-1534-4fae-b83c-250933d5a72b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: エンティティ リレーションシップを定義する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で新しいエンティティを追加するとき、新しいエンティティと関連エンティティの間のリレーションシップは自動的には定義されません。  エンティティ インスタンス間のリレーションシップを作成および変更し、クライアント ライブラリを使用して、これらの変更をデータ サービスに反映できます。  詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、新しいオブジェクト インスタンスを作成し、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.AddRelatedObject%2A> メソッドを呼び出して、関連する注文へのリンクと共に、コンテキスト内に項目を作成します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたときに HTTP POST メッセージがデータ サービスに送信されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddOrderDetailToOrderAuto](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addorderdetailtoorderauto)]
+ [!code-vb[Astoria Northwind Client#AddOrderDetailToOrderAuto](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addorderdetailtoorderauto)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> メソッドを使用して、特定の `Products` オブジェクトへの参照と共に、`Order_Details` オブジェクトを関連する `Orders` オブジェクトに追加する方法を示します。  <xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> メソッドおよび <xref:System.Data.Services.Client.DataServiceContext.SetLink%2A> メソッドは、リレーションシップを定義します。  この例では、`Order_Details` オブジェクトのナビゲーション プロパティも明示的に設定されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddOrderDetailToOrder](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addorderdetailtoorder)]
+ [!code-vb[Astoria Northwind Client#AddOrderDetailToOrder](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addorderdetailtoorder)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [方法: エンティティを追加、変更、および削除する](../../../../docs/framework/data/wcf/how-to-add-modify-and-delete-entities-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md b/docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md
new file mode 100644
index 00000000000..61d177ee813
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md
@@ -0,0 +1,167 @@
+---
+title: "方法: IIS 上で実行する WCF Data Service を開発する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 配置"
+  - "WCF Data Services, 開発"
+  - "WCF Data Services, ホスティング"
+ms.assetid: f6f768c5-4989-49e3-a36f-896ab4ded86e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 方法: IIS 上で実行する WCF Data Service を開発する
+このトピックでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して、Northwind サンプル データベースに基づいてデータ サービスを作成する方法を示します。このサンプル データベースは、インターネット インフォメーション サービス \(IIS\) 上で動作する ASP.NET Web アプリケーションによってホストされます。  同じ Northwind データ サービスを ASP.NET 開発サーバーで実行する ASP.NET Web アプリケーションとして作成する方法については、「[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  Northwind データ サービスを作成するには、ローカル コンピューターに Northwind サンプル データベースをインストールしておく必要があります。  このサンプル データベースをダウンロードするには、ダウンロード ページ「[SQL Server のサンプル データベース](http://go.microsoft.com/fwlink/?linkid=24758)」を参照してください。  
+  
+ このトピックでは、Entity Framework プロバイダーを使用してデータ サービスを作成する方法を示します。  その他のデータ サービス プロバイダーを利用することもできます。  詳細については、「[データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)」を参照してください。  
+  
+ サービスを作成した後に、データ サービス リソースへのアクセスを明示的に提供する必要があります。  詳細については、「[方法: データ サービスへのアクセスを有効にする](../../../../docs/framework/data/wcf/how-to-enable-access-to-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+### IIS 上で実行する ASP.NET Web アプリケーションを作成するには  
+  
+1.  Visual Studio の **\[ファイル\]** メニューで、**\[新規作成\]**、**\[プロジェクト\]** の順にクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスで、プログラム言語として \[Visual Basic\] または \[Visual C\#\] のいずれかを選択します。  
+  
+3.  **\[テンプレート\]** ペインで、**\[ASP.NET Web アプリケーション\]** を選択します。  メモ : Visual Studio Web Developer を使用する場合は、新しい Web アプリケーションではなく、新しい Web サイトを作成する必要があります。  
+  
+4.  プロジェクトの名前として「`NorthwindService`」を入力します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+6.  **\[プロジェクト\]** メニューで **\[NorthwindService のプロパティ\]** を選択します。  
+  
+7.  **\[Web\]** タブで **\[ローカル IIS Web サーバーを使用する\]** を選択します。  
+  
+8.  **\[仮想ディレクトリの作成\]**、**\[OK\]** の順にクリックします。  
+  
+9. 管理特権を持つコマンド プロンプトから、次のコマンドを実行します \(オペレーティング システムによって異なります\)。  
+  
+    -   32 ビット システム:  
+  
+        ```ms-dos  
+        "%windir%\Microsoft.NET\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -i  
+        ```  
+  
+    -   64 ビット システム:  
+  
+        ```ms-dos  
+        "%windir%\Microsoft.NET\Framework64\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -i  
+        ```  
+  
+     これにより、コンピューターに Windows Communication Foundation \(WCF\) が登録されます。  
+  
+10. 管理特権を持つコマンド プロンプトから、次のコマンドを実行します \(オペレーティング システムによって異なります\)。  
+  
+    -   32 ビット システム:  
+  
+        ```ms-dos  
+        "%windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe" -i -enable  
+        ```  
+  
+    -   64 ビット システム:  
+  
+        ```ms-dos  
+        "%windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe" -i -enable  
+        ```  
+  
+     これにより、WCF がコンピューターにインストールされた後、IIS は正常に実行されます。  IIS の再起動が必要になる場合があります。  
+  
+11. ASP.NET アプリケーションが IIS7 で実行されると、次の手順も実行する必要があります。  
+  
+    1.  IIS マネージャーを開いて **\[既定の Web サイト\]** の下にある PhotoService アプリケーションに移動します。  
+  
+    2.  **\[機能ビュー\]** で、**\[認証\]** をダブルクリックします。  
+  
+    3.  **\[認証\]** ページで、**\[匿名認証\]** をクリックします。  
+  
+    4.  **\[操作\]** ペインで **\[編集\]** をクリックして、匿名ユーザーがサイトに接続するセキュリティ プリンシパルを設定します。  
+  
+    5.  **\[匿名認証資格情報の編集\]** ダイアログ ボックスで、**\[アプリケーション プール ID\]** をクリックします。  
+  
+    > [!IMPORTANT]
+    >  ネットワーク サービス アカウントを使用する際、そのアカウントに関連するすべての内部ネットワーク アクセス権を匿名ユーザーに付与します。  
+  
+12. SQL Server Management Studio、sqlcmd.exe ユーティリティ、または Visual Studio の Transact\-SQL エディターを使用して、Northwind データベースがアタッチされた SQL Server のインスタンスに対して次の Transact\-SQL コマンドを実行します。  
+  
+    ```sql  
+    CREATE LOGIN [NT AUTHORITY\NETWORK SERVICE] FROM WINDOWS;  
+    GO   
+    ```  
+  
+     これにより、IIS の実行に使用される Windows アカウントに対して、SQL Server インスタンスのログインが作成されます。  IIS は、これを使用して SQL Server インスタンスに接続できるようになります。  
+  
+13. Northwind データベースをアタッチして、次の Transact\-SQL コマンドを実行します。  
+  
+    ```sql  
+    USE Northwind  
+    GO  
+    CREATE USER [NT AUTHORITY\NETWORK SERVICE]   
+    FOR LOGIN [NT AUTHORITY\NETWORK SERVICE] WITH DEFAULT_SCHEMA=[dbo];  
+    GO  
+    ALTER LOGIN [NT AUTHORITY\NETWORK SERVICE]   
+    WITH DEFAULT_DATABASE=[Northwind];   
+    GO  
+    EXEC sp_addrolemember 'db_datareader', 'NT AUTHORITY\NETWORK SERVICE'  
+    GO  
+    EXEC sp_addrolemember 'db_datawriter', 'NT AUTHORITY\NETWORK SERVICE'  
+    GO   
+    ```  
+  
+     これにより、新しいログインに権限が付与され、IIS は Northwind データベースに対してデータの読み取りおよび書き込みを行うことができるようになります。  
+  
+### データ モデルを定義するには  
+  
+1.  **ソリューション エクスプローラー**で、ASP.NET プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで **\[ADO.NET エンティティ データ モデル\]** を選択します。  
+  
+3.  データ モデルの名前として「`Northwind.edmx`」を入力します。  
+  
+4.  エンティティ データ モデル ウィザードで、**\[データベースから生成\]** を選択し、**\[次へ\]** をクリックします。  
+  
+5.  次のいずれかの手順を実行し、データ モデルをデータベースに接続してから **\[次へ\]** をクリックします。  
+  
+    -   データベース接続がまだ構成されていない場合は、**\[新しい接続\]** をクリックして新しい接続を作成します。  詳細については、「[SQL Server データベースへの接続の作成方法](http://go.microsoft.com/fwlink/?LinkId=123631)」を参照してください。  この [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] インスタンスには、Northwind サンプル データベースがアタッチされている必要があります。  
+  
+         または  
+  
+    -   Northwind データベースに接続するようにデータベース接続が既に構成されている場合は、一覧からその接続を選択します。  
+  
+6.  ウィザードの最終ページで、データベース内のすべてのテーブルのチェック ボックスをオンにし、ビューおよびストアド プロシージャのチェック ボックスをオフにします。  
+  
+7.  **\[完了\]** をクリックして、ウィザードを終了します。  
+  
+    > [!NOTE]
+    >  この生成されたデータ モデルは、エンティティ型の外部キー プロパティを公開します。  Visual Studio 2008 を使用して作成したデータ モデルには、これらの外部キー プロパティが含まれません。  そのため、Visual Studio 2008 を使用して作成された Northwind データ サービスにアクセスしようとする前に、このバージョンの Northwind データ サービスにアクセスするために作成されたクライアント アプリケーションのクライアント データ サービス クラスを更新する必要があります。  
+  
+### データ サービスを作成するには  
+  
+1.  **ソリューション エクスプローラー**で、ASP.NET プロジェクトの名前を右クリックし、**\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[ADO.NET Data Service\]** を選択します。  
+  
+3.  サービスの名前として「`Northwind`」を入力します。  
+  
+     Visual Studio で新しいサービスの XML マークアップおよびコード ファイルが作成されます。  既定では、コード エディターのウィンドウが開きます。  **ソリューション エクスプローラー**では、このサービスに Northwind という名前が付き、拡張子は .svc.cs または .svc.vb になります。  
+  
+4.  データ サービスのコードで、データ サービスを定義するクラスの定義にあるコメント `/* TODO: put your data source class name here */` をデータ モデルのエンティティ コンテナーである型 \(この場合は `NorthwindEntities`\) で置き換えます。  クラス定義は次のようになります。  
+  
+     [!code-csharp[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart service/cs/northwind.svc.cs#servicedefinition)]
+     [!code-vb[Astoria Quickstart Service#ServiceDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart service/vb/northwind.svc.vb#servicedefinition)]  
+  
+## 参照  
+ [サービスとしてのデータの公開](../../../../docs/framework/data/wcf/exposing-your-data-as-a-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-enable-access-to-the-data-service-wcf-data-services.md b/docs/framework/data/wcf/how-to-enable-access-to-the-data-service-wcf-data-services.md
new file mode 100644
index 00000000000..b5d7b89caf1
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-enable-access-to-the-data-service-wcf-data-services.md
@@ -0,0 +1,38 @@
+---
+title: "方法: データ サービスへのアクセスを有効にする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 構成"
+ms.assetid: 3d830bcd-32b4-4f26-9287-d58a071452c6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法: データ サービスへのアクセスを有効にする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスによって公開されているリソースに明示的にアクセス権を付与する必要があります。  つまり、新しいデータ サービスを作成した後も、個々のリソースに対し、エンティティ セットとして明示的にアクセスを許可する必要があります。  このトピックでは、[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成される Northwind データ サービスの 5 つのエンティティ セットへの読み込みアクセスと書き込みアクセスを有効にする方法を示します。<xref:System.Data.Services.EntitySetRights> の列挙は、<xref:System.FlagsAttribute> を使用して定義するため、論理和演算子を使って 1 つのエンティティ セットに対して複数のアクセス許可を指定することができます。  
+  
+> [!NOTE]
+>  ASP.NET アプリケーションにアクセスできるクライアントは、データ サービスによって公開されるリソースにもアクセスできます。  運用データ サービスで、リソースへの承認されていないアクセスを防止するために、アプリケーション自身もセキュリティで保護する必要があります。  詳細については、「[NIB: ASP.NET Security](http://msdn.microsoft.com/ja-jp/04b37532-18d9-40b4-8e5f-ee09a70b311d)」を参照してください。  
+  
+### データ サービスへのアクセスを有効にするには  
+  
+-   データ サービスのコードで、`InitializeService` 関数のプレースホルダーのコードを次の内容で置き換えます。  
+  
+     [!code-csharp[Astoria Quickstart Service#AllReadConfig](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria quickstart service/cs/northwind.svc.cs#allreadconfig)]
+     [!code-vb[Astoria Quickstart Service#AllReadConfig](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria quickstart service/vb/northwind.svc.vb#allreadconfig)]  
+  
+     これにより、クライアントから `Orders` および `Order_Details` エンティティ セットへの読み取りおよび書き込みアクセスと、`Customers` エンティティ セットへの読み取り専用アクセスが有効になります。  
+  
+## 参照  
+ [方法: IIS 上で実行する WCF Data Service を開発する](../../../../docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md)   
+ [データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-enable-paging-of-data-service-results-wcf-data-services.md b/docs/framework/data/wcf/how-to-enable-paging-of-data-service-results-wcf-data-services.md
new file mode 100644
index 00000000000..0aff7a7f2b9
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-enable-paging-of-data-service-results-wcf-data-services.md
@@ -0,0 +1,37 @@
+---
+title: "方法: データ サービスの結果のページングを有効にする (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ページング出力 [WCF Data Services]"
+ms.assetid: 9a316cbd-9612-4482-a541-a10bc78b2635
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービスの結果のページングを有効にする (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービス クエリによって返されるエンティティの数を制限できます。  ページ制限は、サービスの初期化時に呼び出されるメソッドで定義され、エンティティ セットごとに設定できます。  
+  
+ ページングが有効である場合、フィードの最終的なエントリには、データの次のページへのリンクが含まれます。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックでは、返された `Customers` エンティティ セットおよび `Orders` エンティティ セットのページングを有効にするためにデータ サービスを変更する方法について説明します。  このトピックの例では、Northwind サンプル データ サービスを使用します。  このサービスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+### 返された Customer エンティティ セットおよび Orders エンティティ セットのページングを有効化する方法  
+  
+-   データ サービスのコードで、`InitializeService` 関数のプレースホルダーのコードを次の内容で置き換えます。  
+  
+     [!code-csharp[Astoria Northwind Service#DataServiceConfigPaging](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind.svc.cs#dataserviceconfigpaging)]
+     [!code-vb[Astoria Northwind Service#DataServiceConfigPaging](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind.svc.vb#dataserviceconfigpaging)]  
+  
+## 参照  
+ [遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)   
+ [方法: ページングされた結果を読み込む](../../../../docs/framework/data/wcf/how-to-load-paged-results-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-execute-asynchronous-data-service-queries-wcf-data-services.md b/docs/framework/data/wcf/how-to-execute-asynchronous-data-service-queries-wcf-data-services.md
new file mode 100644
index 00000000000..a695adc055e
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-execute-asynchronous-data-service-queries-wcf-data-services.md
@@ -0,0 +1,37 @@
+---
+title: "方法: 非同期データ サービス クエリを実行する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "非同期操作 [WCF Data Services]"
+  - "WCF Data Services, 非同期操作"
+ms.assetid: 902a2dc1-d0e9-4b00-90a8-becc4cb1f6a7
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: 非同期データ サービス クエリを実行する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用して、クエリの実行や変更の保存などのクライアント サーバー操作を非同期で実行できます。詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  特定のスレッドでコールバックが呼び出される必要のあるアプリケーションでは、<xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドの実行を明示的にマーシャリングする必要があります。  詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッドを呼び出してクエリを開始することで、非同期クエリを実行する方法を示します。  インライン デリゲートは、<xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドを呼び出してクエリ結果を表示します。  
+  
+ [!code-csharp[Astoria Northwind Client#ExecuteQueryAsync](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#executequeryasync)]
+ [!code-vb[Astoria Northwind Client#ExecuteQueryAsync](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#executequeryasync)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md b/docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md
new file mode 100644
index 00000000000..b1d78bdbbc2
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md
@@ -0,0 +1,55 @@
+---
+title: "方法: データ サービス クエリを実行する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ サービスのクエリ [WCF Data Services]"
+  - "WCF Data Services, データへのアクセス"
+  - "WCF Data Services, 照会"
+ms.assetid: 62997821-e0c6-4c4d-9fb7-1273fb5e5d18
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービス クエリを実行する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、生成されたクライアント データ サービス クラスを使用して .NET Framework ベースのクライアント アプリケーションからデータ サービスをクエリできます。  次の方法のいずれかを使用してクエリを実行できます。  
+  
+-   `Add Data Service Reference` ツールによって生成される <xref:System.Data.Services.Client.DataServiceContext> から取得した名前付きの <xref:System.Data.Services.Client.DataServiceQuery%601> に対して LINQ クエリを実行する。  
+  
+-   暗黙的に、`Add Data Service Reference` ツールによって生成される <xref:System.Data.Services.Client.DataServiceContext> から取得した名前付きの <xref:System.Data.Services.Client.DataServiceQuery%601> を列挙する。  
+  
+-   明示的に、<xref:System.Data.Services.Client.DataServiceQuery%601> で <xref:System.Data.Services.Client.DataServiceContext.Execute%2A> メソッド \(非同期実行の場合は <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッド\) を呼び出す。  
+  
+ 詳細については、「[データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、すべての `Customers` を返す LINQ クエリを定義して Northwind データ サービスに対して実行する方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#GetAllCustomersLinq](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getallcustomerslinq)]
+ [!code-vb[Astoria Northwind Client#GetAllCustomersLinq](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getallcustomerslinq)]  
+  
+## 使用例  
+ 次の例は、`Add Data Service Reference` ツールによって生成されるコンテキストを使用して、すべての `Customers` を返すクエリを Northwind データ サービスに対して暗黙的に実行する方法を示します。  要求された `Customers` エンティティ セットの URI は、コンテキストによって自動的に決定されます。  クエリは、列挙が行われるときに暗黙的に実行されます。  
+  
+ [!code-csharp[Astoria Northwind Client#GetAllCustomers](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getallcustomers)]
+ [!code-vb[Astoria Northwind Client#GetAllCustomers](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getallcustomers)]  
+  
+## 使用例  
+ 次の例は、<xref:System.Data.Services.Client.DataServiceContext> を使用して、すべての `Customers` を返すクエリを Northwind データ サービスに対して明示的に実行する方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#GetAllCustomersExplicit](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getallcustomersexplicit)]
+ [!code-vb[Astoria Northwind Client#GetAllCustomersExplicit](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getallcustomersexplicit)]  
+  
+## 参照  
+ [方法: データ サービス クエリにクエリ オプションを追加する](../../../../docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-execute-queries-in-a-batch-wcf-data-services.md b/docs/framework/data/wcf/how-to-execute-queries-in-a-batch-wcf-data-services.md
new file mode 100644
index 00000000000..423a7dc4590
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-execute-queries-in-a-batch-wcf-data-services.md
@@ -0,0 +1,33 @@
+---
+title: "方法: クエリをバッチで実行する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, バッチ要求"
+ms.assetid: 3b4db7df-bd33-43a1-8ea4-63a18e131f97
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: クエリをバッチで実行する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用すると、データ サービスに対する複数のクエリを 1 つのバッチで実行できます。  詳細については、「[バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、<xref:Microsoft.SqlServer.ReportingServices.ReportingService.ExecuteBatch%2A> メソッドを呼び出して、`Customers` オブジェクトと `Products` オブジェクトの両方を Northwind データ サービスから返すクエリを含む <xref:System.Data.Services.Client.DataServiceRequest%601> オブジェクトの配列を実行する方法を示します。  返された <xref:System.Data.Services.Client.DataServiceResponse> 内の <xref:System.Data.Services.Client.QueryOperationResponse%601> オブジェクトのコレクションが列挙され、各 <xref:System.Data.Services.Client.QueryOperationResponse%601> に含まれるオブジェクトのコレクションも列挙されます。  
+  
+ [!code-csharp[Astoria Northwind Client#BatchQuery](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#batchquery)]
+ [!code-vb[Astoria Northwind Client#BatchQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#batchquery)]  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md b/docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md
new file mode 100644
index 00000000000..fdbff6d134f
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md
@@ -0,0 +1,64 @@
+---
+title: "方法: データ サービス メッセージを先に取得する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クエリ インターセプター [WCF Data Services]"
+  - "WCF Data Services, カスタマイズ"
+ms.assetid: 24b9df1b-b54b-4795-a033-edf333675de6
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービス メッセージを先に取得する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、要求メッセージを先に取得して、操作にカスタム ロジックを追加することができます。  メッセージを先に取得するには、データ サービスで特別なメソッドを使用する必要があります。  詳細については、「[インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスを使用します。  このサービスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+### Orders エンティティ セットのクエリ インターセプターを定義するには  
+  
+1.  Northwind データ サービス プロジェクトで Northwind.svc ファイルを開きます。  
+  
+2.  `Northwind` クラスのコード ページで次の `using` ステートメント \(Visual Basic の場合は `Imports`\) を追加します。  
+  
+     [!code-csharp[Astoria Northwind Service#UsingLinqExpressions](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#usinglinqexpressions)]
+     [!code-vb[Astoria Northwind Service#UsingLinqExpressions](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#usinglinqexpressions)]  
+  
+3.  `Northwind` クラスで、次に示すように `OnQueryOrders` というサービス操作メソッドを定義します。  
+  
+     [!code-csharp[Astoria Northwind Service#QueryInterceptorDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#queryinterceptordef)]
+     [!code-vb[Astoria Northwind Service#QueryInterceptorDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#queryinterceptordef)]  
+  
+### Products エンティティ セットの変更インターセプターを定義するには  
+  
+1.  Northwind データ サービス プロジェクトで Northwind.svc ファイルを開きます。  
+  
+2.  `Northwind` クラスで、次に示すように `OnChangeProducts` というサービス操作メソッドを定義します。  
+  
+     [!code-csharp[Astoria Northwind Service#ChangeInterceptorDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#changeinterceptordef)]
+     [!code-vb[Astoria Northwind Service#ChangeInterceptorDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#changeinterceptordef)]  
+  
+## 使用例  
+ この例では、ラムダ式を返す `Orders` エンティティ セットのクエリ インターセプター メソッドを定義します。  この式には、要求された `Orders` を特定の連絡先名が付けられた関連 `Customers` に基づいてフィルターするデリゲートが含まれます。  この名前は、要求ユーザーに基づいて決定されます。  この例では、認証が有効化され、WCF を使用する ASP.NET Web アプリケーション内でデータ サービスがホストされていることを前提とします。  <xref:System.Web.HttpContext> クラスは、現在の要求の原則を取得するために使用されます。  
+  
+ [!code-csharp[Astoria Northwind Service#QueryInterceptor](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#queryinterceptor)]
+ [!code-vb[Astoria Northwind Service#QueryInterceptor](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#queryinterceptor)]  
+  
+## 使用例  
+ この例は、`Products` エンティティ セットの変更インターセプター メソッドを定義します。  このメソッドは、<xref:System.Data.Services.UpdateOperations> 操作または <xref:System.Data.Services.UpdateOperations> 操作に関するサービスへの入力を検証し、生産が中止されている製品への変更が行われた場合に例外を発生させます。  また、サポートされない操作として製品の削除をブロックします。  
+  
+ [!code-csharp[Astoria Northwind Service#ChangeInterceptor](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#changeinterceptor)]
+ [!code-vb[Astoria Northwind Service#ChangeInterceptor](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#changeinterceptor)]  
+  
+## 参照  
+ [方法 : サービス操作を定義する](../../../../docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md)   
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-load-paged-results-wcf-data-services.md b/docs/framework/data/wcf/how-to-load-paged-results-wcf-data-services.md
new file mode 100644
index 00000000000..08ef43811a3
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-load-paged-results-wcf-data-services.md
@@ -0,0 +1,41 @@
+---
+title: "方法: ページングされた結果を読み込む (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 遅延コンテンツ"
+  - "WCF Data Services, データの読み込み"
+ms.assetid: bb786ea4-f3ef-4ad3-9a41-3a0b7feb6a1f
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: ページングされた結果を読み込む (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、1 つの応答フィードで返されるエンティティの数をデータ サービスで制限できます。  この処理を行うと、フィードの最終的なエントリには、データの次のページへのリンクが含まれます。  データの次のページの URI は、<xref:System.Data.Services.Client.DataServiceQuery%601> が実行されたときに返される <xref:System.Data.Services.Client.QueryOperationResponse%601> の<xref:System.Data.Services.Client.QueryOperationResponse%601.GetContinuation%2A> メソッドを呼び出すことによって取得されます。このオブジェクトによって表される URI は、結果の次のページを読み込むために使用されます。  詳細については、「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、`do…while` ループを使用して、データ サービスからのページングされた結果の `Customers` エンティティを読み込みます。  
+  
+ [!code-csharp[Astoria Northwind Client#GetCustomersPaged](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getcustomerspaged)]
+ [!code-vb[Astoria Northwind Client#GetCustomersPaged](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getcustomerspaged)]  
+  
+## 使用例  
+ 次の例は、関連する `Orders` エンティティと各 `Customers` エンティティを返し、`do…while` ループを使用して `Customers` エンティティ ページおよび入れ子になった `while` ループを読み込んで、データ サービスから関連する `Orders` エンティティのページを読み込みます。  
+  
+ [!code-csharp[Astoria Northwind Client#GetCustomersPagedNested](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getcustomerspagednested)]
+ [!code-vb[Astoria Northwind Client#GetCustomersPagedNested](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getcustomerspagednested)]  
+  
+## 参照  
+ [遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)   
+ [方法: 関連エンティティを読み込む](../../../../docs/framework/data/wcf/how-to-load-related-entities-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-load-related-entities-wcf-data-services.md b/docs/framework/data/wcf/how-to-load-related-entities-wcf-data-services.md
new file mode 100644
index 00000000000..af6af4b9c90
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-load-related-entities-wcf-data-services.md
@@ -0,0 +1,40 @@
+---
+title: "方法: 関連エンティティを読み込む (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 遅延コンテンツ"
+  - "WCF Data Services, データの読み込み"
+ms.assetid: 6f143d30-d997-4e6b-bcf0-d5c394ecb108
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: 関連エンティティを読み込む (WCF Data Services)
+関連付けられたエンティティを [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で読み込む必要がある場合、<xref:System.Data.Services.Client.DataServiceContext> クラスで <xref:System.Data.Services.Client.DataServiceContext.LoadProperty%2A> メソッドを使用できます。  <xref:System.Data.Services.Client.DataServiceQuery%601> で <xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドを使用して、関連エンティティが同じクエリ応答で集中的に読み込むよう要求することもできます。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例は、返される各 `Orders` インスタンスに関連付けられた `Customer` を明示的に読み込む方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#LoadRelatedOrderCustomer](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#loadrelatedordercustomer)]
+ [!code-vb[Astoria Northwind Client#LoadRelatedOrderCustomer](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#loadrelatedordercustomer)]  
+  
+## 使用例  
+ 次の例は、<xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドを使用して、クエリによって返される `Orders` に属する `Order Details` を返す方法を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#ExpandOrderDetails](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#expandorderdetails)]
+ [!code-vb[Astoria Northwind Client#ExpandOrderDetails](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#expandorderdetails)]  
+  
+## 参照  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md b/docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md
new file mode 100644
index 00000000000..8ec295e1334
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md
@@ -0,0 +1,106 @@
+---
+title: "方法: クライアント データ サービス クラスを手動で生成する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, 構成"
+ms.assetid: b98cb1d6-956a-4e50-add6-67e4f2587346
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法: クライアント データ サービス クラスを手動で生成する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を Visual Studio に統合すると、**\[サービス参照の追加\]** ダイアログ ボックスを使用して参照を Visual Studio プロジェクト内のデータ サービスに追加するときに、クライアント データ サービス クラスを自動的に生成できるようになります。  詳細については、「[方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)」を参照してください。  コード生成ツールの `DataSvcUtil.exe` を使用して、同じクライアント データ サービス クラスを手動で生成することもできます。[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] に含まれるこのツールは、データ サービス定義から .NET Framework クラスを生成します。  このツールを使用して、概念モデル \(.csdl\) ファイル、および Visual Studio プロジェクトの Entity Framework モデルを表す .edmx ファイルからデータ サービス クラスを生成することもできます。  
+  
+ このトピックの例は、Northwind サンプル データ サービスに基づいてクライアント データ サービス クラスを作成します。  このサービスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  このトピックのいくつかの例では、Northwind モデルの概念モデル ファイルが必要です。  詳細については、「[方法: EdmGen.exe を使用してモデル ファイルとマッピング ファイルを生成する](../../../../docs/framework/data/adonet/ef/how-to-use-edmgen-exe-to-generate-the-model-and-mapping-files.md)」を参照してください。  このトピックのいくつかの例では、Northwind モデルの .edmx ファイルが必要です。  詳細については、「[.edmx File Overview](http://msdn.microsoft.com/ja-jp/f4c8e7ce-1db6-417e-9759-15f8b55155d4)」を参照してください。  
+  
+### データ バインディングをサポートする C\# クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\DataSvcUtil.exe" /dataservicecollection /version:2.0 /language:CSharp /out:Northwind.cs /uri:http://localhost:12345/Northwind.svc  
+    ```  
+  
+    > [!NOTE]
+    >  `/uri:` パラメーターの値は Northwind サンプル データ サービスのインスタンスの URI で置き換える必要があります。  
+  
+### データ バインディングをサポートする Visual Basic クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\DataSvcUtil.exe" /dataservicecollection /version:2.0 /language:VB /out:Northwind.vb /uri:http://localhost:12345/Northwind.svc  
+    ```  
+  
+    > [!NOTE]
+    >  `/uri:` パラメーターの値は Northwind サンプル データ サービスのインスタンスの URI で置き換える必要があります。  
+  
+### サービス URI に基づいて C\# クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\DataSvcUtil.exe" /language:CSharp /out:northwind.cs /uri:http://localhost:12345/Northwind.svc  
+    ```  
+  
+    > [!NOTE]
+    >  `/uri:` パラメーターの値は Northwind サンプル データ サービスのインスタンスの URI で置き換える必要があります。  
+  
+### サービス URI に基づいて Visual Basic クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\datasvcutil.exe" /language:VB /out:Northwind.vb /uri:http://localhost:12345/Northwind.svc  
+    ```  
+  
+    > [!NOTE]
+    >  `/uri:` パラメーターの値は Northwind サンプル データ サービスのインスタンスの URI で置き換える必要があります。  
+  
+### 概念モデル ファイル \(CSDL\) に基づいて C\# を生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\datasvcutil.exe" /language:CSharp /in:Northwind.csdl /out:Northwind.cs  
+    ```  
+  
+### 概念モデル ファイル \(CSDL\) に基づいて Visual Basic を生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\datasvcutil.exe" /language:VB /in:Northwind.csdl /out:Northwind.vb  
+    ```  
+  
+### .edmx ファイルに基づいて C\# クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\datasvcutil.exe" /language:CSharp /in:Northwind.edmx /out:c:\northwind.cs   
+    ```  
+  
+### .edmx ファイルに基づいて Visual Basic クラスを生成するには  
+  
+-   コマンド プロンプトで、次のコマンド \(改行なし\) を実行します。  
+  
+    ```  
+    "%windir%\Microsoft.NET\Framework\v3.5\datasvcutil.exe" /language:VB /in:Northwind.edmx /out:c:\northwind.vb   
+    ```  
+  
+## 参照  
+ [データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)   
+ [方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)   
+ [WCF Data Service クライアント ユーティリティ \(DataSvcUtil.exe\)](../../../../docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md b/docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md
new file mode 100644
index 00000000000..4613bf5850e
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md
@@ -0,0 +1,45 @@
+---
+title: "方法: クエリ結果を射影する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "射影 [WCF Data Services]"
+  - "クエリ射影 [WCF Data Services]"
+  - "WCF Data Services, 射影"
+  - "WCF Data Services, 照会"
+ms.assetid: 474ac625-8770-43ba-8320-d3315ea9530f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法: クエリ結果を射影する (WCF Data Services)
+射影は、エンティティの特定のプロパティのみが応答で返されるように指定することにより、クエリによって返されるデータの量を減らすためのメカニズムです。  クエリの結果に射影を実行するには、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クエリ オプションを使用するか、LINQ クエリで `$select` [select](../Topic/select%20clause%20\(C%23%20Reference\).md) 句 \(Visual Basic の場合は [Select](../Topic/Select%20Clause%20\(Visual%20Basic\).md)\) を使用します。  詳細については、「[データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、アドレス特有のプロパティと Identity プロパティのみを含む新しい CustomerAddress 型に Customer エンティティを射影する LINQ クエリを示します。  この `CustomerAddress` クラスはクライアントで定義され、クライアント ライブラリがエンティティ型として認識できるように属性化されています。  
+  
+ [!code-csharp[Astoria Northwind Client#SelectCustomerAddress](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#selectcustomeraddress)]
+ [!code-vb[Astoria Northwind Client#SelectCustomerAddress](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#selectcustomeraddress)]  
+  
+## 使用例  
+ 次の例では、返された Customers エンティティを、Identity プロパティは含まずにアドレス特有のプロパティのみを含む新しい CustomerAddressNonEntity 型に射影する LINQ クエリを示します。  この `CustomerAddressNonEntity` クラスはクライアントで定義され、エンティティ型としては属性化されません。  
+  
+ [!code-csharp[Astoria Northwind Client#SelectCustomerAddressNonEntity](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#selectcustomeraddressnonentity)]
+ [!code-vb[Astoria Northwind Client#SelectCustomerAddressNonEntity](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#selectcustomeraddressnonentity)]  
+  
+## 使用例  
+ 次の例では、前の例で使用した `CustomerAddress` `CustomerAddressNonEntity` 型の定義を示します。  
+  
+ [!code-csharp[Astoria Northwind Client#CustomerAddressDefinition](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/customeraddress.cs#customeraddressdefinition)]
+ [!code-vb[Astoria Northwind Client#CustomerAddressDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/customeraddress.vb#customeraddressdefinition)]
\ No newline at end of file
diff --git a/docs/framework/data/wcf/how-to-set-headers-in-the-client-request-wcf-data-services.md b/docs/framework/data/wcf/how-to-set-headers-in-the-client-request-wcf-data-services.md
new file mode 100644
index 00000000000..8f9620cd9fa
--- /dev/null
+++ b/docs/framework/data/wcf/how-to-set-headers-in-the-client-request-wcf-data-services.md
@@ -0,0 +1,43 @@
+---
+title: "方法: クライアント要求のヘッダーを設定する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 要求のカスタマイズ"
+ms.assetid: 3d55168d-5901-4f48-8117-6c93da3ab5ae
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: クライアント要求のヘッダーを設定する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用して、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] をサポートするデータ サービスにアクセスする場合、クライアント ライブラリにより、データ サービスに送信される要求メッセージに必要な HTTP ヘッダーが自動的に設定されます。  ただし、クライアント ライブラリでは、データ サービスがクレーム ベース認証やクッキーを要求する場合など、特定の場合に必要とされるメッセージ ヘッダーを設定することはできません。  詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md#clientAuthentication)」を参照してください。  このような場合は、要求メッセージを送信する前にそのメッセージ ヘッダーを手動で設定する必要があります。  このトピックの例では、<xref:System.Data.Services.Client.DataServiceContext.SendingRequest> イベントを処理して、要求メッセージをデータ サービスに送信する前に新しいヘッダーを要求メッセージに追加する方法を示します。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] Web サイトで公開されている [Northwind サンプル データ サービス](http://go.microsoft.com/fwlink/?LinkId=187426)を使用することもできます。このサンプル データ サービスは読み取り専用で、変更を保存しようとするとエラーが返されます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] Web サイトのサンプル データ サービスでは、匿名認証が許可されます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceContext.SendingRequest> イベントのハンドラーを登録し、データ サービスに対してクエリを実行します。  
+  
+> [!NOTE]
+>  要求ごとにメッセージ ヘッダーを手動で設定することがデータ サービスで必要とされる場合は、データ サービスを表すエンティティ コンテナー \(この場合は `NorthwindEntities`\) で `OnContextCreated` 部分メソッドをオーバーライドして、<xref:System.Data.Services.Client.DataServiceContext.SendingRequest> イベントのハンドラーを登録することを検討してください。  
+  
+ [!code-csharp[Astoria Northwind Client#RegisterHeadersQuery](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#registerheadersquery)]
+ [!code-vb[Astoria Northwind Client#RegisterHeadersQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#registerheadersquery)]  
+  
+## 使用例  
+ 次のメソッドは、<xref:System.Data.Services.Client.DataServiceContext.SendingRequest> イベントを処理し、認証ヘッダーを要求に追加します。  
+  
+ [!code-csharp[Astoria Northwind Client#OnSendingRequest](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#onsendingrequest)]
+ [!code-vb[Astoria Northwind Client#OnSendingRequest](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#onsendingrequest)]  
+  
+## 参照  
+ [WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)   
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/index.md b/docs/framework/data/wcf/index.md
new file mode 100644
index 00000000000..4c3475d9e7f
--- /dev/null
+++ b/docs/framework/data/wcf/index.md
@@ -0,0 +1,137 @@
+---
+title: "WCF Data Services 4.5 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "Astoria"
+  - "WCF Data Services, はじめに"
+ms.assetid: 73d2bec3-7c92-4110-b905-11bb0462357a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WCF Data Services 4.5
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] \(従来の "ADO.NET Data Services"\) は .NET Framework のコンポーネントです。このコンポーネントを使用すると、[Representational State Transfer \(REST\)](http://go.microsoft.com/fwlink/?LinkId=113919) のセマンティクスを使用して、Web またはイントラネット上のデータを公開および使用するために [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] を使用するサービスを作成できます。[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、URI でアドレス指定できるリソースとしてデータを公開します。  標準的な HTTP 動詞である GET、PUT、POST、および DELETE を使用してデータにアクセスし、変更できます。[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、[Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md) のエンティティとリレーションシップの変換を使用して、アソシエーションによって関連付けられたエンティティのセットとしてリソースを公開します。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルを使用してリソースのアドレス指定および更新を行います。  このようにして、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] をサポートしている任意のクライアントからこれらのサービスにアクセスできます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を使用すると、XML としてデータを交換および更新するための標準のセットである Atom と、AJAX アプリケーションで広範に使用されるテキスト ベースのデータ交換形式である JavaScript Object Notation \(JSON\) という広く知られている転送形式を使用して、データをリソースに要求または書き込むことができます。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、さまざまなソースからのデータを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開できます。  Visual Studio のツールを使用すると、ADO.NET Entity Framework データ モデルを使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービスを簡単に作成できます。[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードは、共通言語ランタイム \(CLR\) クラスに基づいて作成できます。また、遅延バインディングまたは型指定されていないデータに基づいて作成することもできます。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、クライアント ライブラリのセット \(一般的な .NET Framework クライアント アプリケーション用と Silverlight ベースのアプリケーション用\) も含まれています。  これらのクライアント ライブラリは、.NET Framework や Silverlight などの環境から [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスするときにオブジェクト ベースのプログラミング モデルを提供します。  
+  
+## 開始すべき場所  
+ 各自の興味に応じて、次のトピックのいずれかから [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の使用を開始することを検討してください。  
+  
+ すぐに使用を開始したい  
+ -   [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+  
+-   [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)  
+  
+-   [Silverlight のクイックスタート](http://go.microsoft.com/fwlink/?LinkID=192782)  
+  
+-   [Silverlight のクイックスタート \(Windows Phone 開発向け\)](http://go.microsoft.com/fwlink/?LinkID=214535)  
+  
+ コードを見たい  
+ -   [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)  
+  
+-   [方法: データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md)  
+  
+-   [方法: Windows Presentation Foundation 要素にデータをバインドする](../../../../docs/framework/data/wcf/bind-data-to-wpf-elements-wcf-data-services.md)  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] について詳しく知りたい  
+ -   [ホワイトペーパー: OData の導入](http://go.microsoft.com/fwlink/?LinkId=220867)  
+  
+-   [Open Data Protocol Web サイト](http://go.microsoft.com/fwlink/?LinkID=184554)  
+  
+-   [OData: SDK](http://go.microsoft.com/fwlink/?LinkID=185248)  
+  
+-   [OData: よくある質問](http://go.microsoft.com/fwlink/?LinkId=185867)  
+  
+ ビデオを見たい  
+ -   [WCF Data Services ビギナーズ ガイド](http://go.microsoft.com/fwlink/?LinkId=220864)  
+  
+-   [WCF Data Services 開発者ビデオ](http://go.microsoft.com/fwlink/?LinkId=220861)  
+  
+-   [OData: 開発者 Web サイト](http://go.microsoft.com/fwlink/?LinkId=185866)  
+  
+ エンド ツー エンドのサンプルを見たい  
+ -   [MSDN サンプル ギャラリーにある WCF Data Services ドキュメント サンプル](http://go.microsoft.com/fwlink/?LinkID=220865)  
+  
+-   [MSDN サンプル ギャラリーにあるその他の WCF Data Services ドキュメント サンプル](http://go.microsoft.com/fwlink/?LinkId=220866)  
+  
+-   [OData: SDK](http://go.microsoft.com/fwlink/?LinkID=185248)  
+  
+ Visual Studio との統合について知りたい  
+ -   [データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)  
+  
+-   [データ サービスの作成](../../../../docs/framework/data/wcf/creating-the-data-service.md)  
+  
+-   [Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)  
+  
+ 何に使用できるかを知りたい  
+ -   [概要](../../../../docs/framework/data/wcf/wcf-data-services-overview.md)  
+  
+-   [ホワイトペーパー: OData の導入](http://go.microsoft.com/fwlink/?LinkId=220867)  
+  
+-   [アプリケーション シナリオ](../../../../docs/framework/data/wcf/application-scenarios-wcf-data-services.md)  
+  
+ Silverlight を使用したい  
+ -   [Silverlight のクイックスタート](http://go.microsoft.com/fwlink/?LinkID=192782)  
+  
+-   [WCF Data Services \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkID=143149)  
+  
+-   [Silverlight の概要](http://go.microsoft.com/fwlink/?LinkId=148366)  
+  
+ Windows Phone アプリケーションを作成したい  
+ -   [Silverlight のクイックスタート \(Windows Phone 開発向け\)](http://go.microsoft.com/fwlink/?LinkID=214535)  
+  
+-   [Windows Phone 用 Open Data Protocol \(OData\) クライアント](http://go.microsoft.com/fwlink/?LinkID=208749)  
+  
+ LINQ を使用したい  
+ -   [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)  
+  
+-   [LINQ に関する留意点](../../../../docs/framework/data/wcf/linq-considerations-wcf-data-services.md)  
+  
+-   [方法: データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md)  
+  
+ より詳しい情報が欲しい  
+ -   [WCF Data Services チーム ブログ](http://go.microsoft.com/fwlink/?LinkID=150511)  
+  
+-   [リソース](../../../../docs/framework/data/wcf/wcf-data-services-resources.md)  
+  
+-   [WCF Data Services 開発者センター](http://go.microsoft.com/fwlink/?LinkId=220868)  
+  
+-   [Open Data Protocol Web サイト](http://go.microsoft.com/fwlink/?LinkID=184554)  
+  
+## このセクションの内容  
+ [概要](../../../../docs/framework/data/wcf/wcf-data-services-overview.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で使用可能な機能の概要について説明します。  
+  
+ [What's New in WCF Data Services](http://msdn.microsoft.com/ja-jp/cf22cad5-b8d9-472b-8d7c-b863b64eaae8)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の新機能と、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] の新機能のサポートについて説明します。  
+  
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開および使用する方法について説明します。  
+  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開するデータ サービスを作成および構成する方法について説明します。  
+  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)  
+ クライアント ライブラリを使用して .NET Framework クライアント アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する方法について説明します。  
+  
+## 参照  
+ [Representational State Transfer \(REST\)](http://go.microsoft.com/fwlink/?LinkId=113919)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/interceptors-wcf-data-services.md b/docs/framework/data/wcf/interceptors-wcf-data-services.md
new file mode 100644
index 00000000000..051a6374e55
--- /dev/null
+++ b/docs/framework/data/wcf/interceptors-wcf-data-services.md
@@ -0,0 +1,56 @@
+---
+title: "インターセプター (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クエリ インターセプター [WCF Data Services]"
+  - "WCF Data Services, カスタマイズ"
+ms.assetid: e33ae8dc-8069-41d0-99a0-75ff28db7050
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# インターセプター (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、アプリケーションで要求メッセージを先に取得して、操作にカスタム ロジックを追加することができます。  このカスタム ロジックを使用して、受信メッセージのデータを検証できます。  このカスタム ロジックを使用して、クエリ要求の範囲をさらに制限することもできます \(カスタム認証ポリシーを要求ごとに挿入するなど\)。  
+  
+ 先に取得するには、データ サービスで特別なメソッドを使用します。  これらのメソッドは、メッセージ処理の適切なポイントで [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] によって呼び出されます。  インターセプターはエンティティ セットごとに定義されます。インターセプター メソッドは、サービス操作が行うように要求からパラメーターを受け取ることはできません。  HTTP GET 要求を処理するときに呼び出されるクエリ インターセプター メソッドは、クエリ要求に対してインターセプターのエンティティ セットを返すかどうかを決定するラムダ式を返す必要があります。  この式は、要求された操作をさらに絞り込むためにデータ サービスによって使用されます。  次の例は、クエリ インターセプターの定義の例を示します。  
+  
+ [!code-csharp[Astoria Northwind Service#QueryInterceptorDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#queryinterceptordef)]
+ [!code-vb[Astoria Northwind Service#QueryInterceptorDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#queryinterceptordef)]  
+  
+ 詳細については、「[方法: データ サービス メッセージを先に取得する](../../../../docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md)」を参照してください。  
+  
+ クエリ以外の操作を処理するときに呼び出される変更インターセプターは、`void` \(Visual Basic の場合は `Nothing`\) を返す必要があります。  変更インターセプター メソッドは、次の 2 つのパラメーターを受け取る必要があります。  
+  
+1.  エンティティ セットのエンティティ型との互換性がある型のパラメーター。  データ サービスが変更インターセプターを呼び出すとき、このパラメーターの値には、要求によって送信されたエンティティ情報が反映されます。  
+  
+2.  型 <xref:System.Data.Services.UpdateOperations> のパラメーター。  データ サービスが変更インターセプターを呼び出すとき、このパラメーターの値には、要求が実行しようとしている操作が反映されます。  
+  
+ 次の例は、変更インターセプターの定義の例を示します。  
+  
+ [!code-csharp[Astoria Northwind Service#ChangeInterceptorDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#changeinterceptordef)]
+ [!code-vb[Astoria Northwind Service#ChangeInterceptorDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#changeinterceptordef)]  
+  
+ 詳細については、「[方法: データ サービス メッセージを先に取得する](../../../../docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md)」を参照してください。  
+  
+ 先に取得する処理には、次の属性がサポートされます。  
+  
+ **\[QueryInterceptor\(** *EnitySetName* **\)\]**  
+ ターゲットのエンティティ セット リソースに対する HTTP GET 要求が受信されると、<xref:System.Data.Services.QueryInterceptorAttribute> 属性が適用されたメソッドが呼び出されます。  これらのメソッドは、常に `Expression<Func<T,bool>>` の形式のラムダ式を返す必要があります。  
+  
+ **\[ChangeInterceptor\(** *EnitySetName* **\)\]**  
+ ターゲットのエンティティ セット リソースに対する HTTP GET 以外の HTTP 要求が受信されると、<xref:System.Data.Services.ChangeInterceptorAttribute> 属性が適用されたメソッドが呼び出されます。  これらのメソッドは、常に `void` \(Visual Basic の場合は `Nothing`\) を返します。  
+  
+ 詳細については、「[方法: データ サービス メッセージを先に取得する](../../../../docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/linq-considerations-wcf-data-services.md b/docs/framework/data/wcf/linq-considerations-wcf-data-services.md
new file mode 100644
index 00000000000..7bb090eebd1
--- /dev/null
+++ b/docs/framework/data/wcf/linq-considerations-wcf-data-services.md
@@ -0,0 +1,207 @@
+---
+title: "LINQ に関する留意点 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services、LINQ"
+  - "クエリ (データ サービスに対する) [WCF Data Services]"
+  - "WCF Data Services は、クエリを実行します。"
+ms.assetid: cc4ec9e9-348f-42a6-a78e-1cd40e370656
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# LINQ に関する留意点 (WCF Data Services)
+このトピックでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントを使用しているときに LINQ クエリを作成および実行する方法と、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] を実装するデータ サービスを LINQ で照会する場合の制限について説明します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]に対するクエリの実行を作成し、 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]-ベースのデータ サービスを参照してください[クエリ データ サービスに対する](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)します。  
+  
+## <a name="composing-linq-queries"></a>LINQ クエリの作成  
+ LINQ を実装するオブジェクトのコレクションに対してクエリを作成できます。 <xref:System.Collections.Generic.IEnumerable%601>します。 両方、**サービス参照の追加** ダイアログ ボックスで[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)]DataSvcUtil.exe ツールは、の形式の生成に使用されると、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)]サービスから継承するエンティティ コンテナー クラスとして<xref:System.Data.Services.Client.DataServiceContext>、およびフィードで返されるエンティティを表すオブジェクトします。 これらのツールでは、サービスによってフィードとして公開されるコレクションに対応するエンティティ コンテナー クラスのプロパティも生成されます。 これらの各プロパティの戻り値のデータ サービスをカプセル化するクラス、 <xref:System.Data.Services.Client.DataServiceQuery%601>します。 <xref:System.Data.Services.Client.DataServiceQuery%601>クラスが実装する、 <xref:System.Linq.IQueryable%601> LINQ で定義されているインターフェイスは、クライアント ライブラリによってクエリ要求の実行時にデータ サービスに送信される URI に変換、データ サービスによって公開されるフィードに対する LINQ クエリを作成することができます。  
+  
+> [!IMPORTANT]
+>  LINQ 構文で表現できるクエリのセットは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] データ サービスによって使用される URI 構文で有効なクエリのセットよりも範囲が広くなります。 A <xref:System.NotSupportedException>クエリは、ターゲット データ サービスの URI にマップできない場合に発生します。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サポートされていない LINQ メソッド](../../../../docs/framework/data/wcf/linq-considerations-wcf-data-services.md#unsupportedMethods)」を参照します。  
+  
+ 次の例の LINQ クエリは、輸送費が&30; ドルを超える `Orders` を取得し、結果を出荷日の新しい順に並べ替えます。  
+  
+  [Astoria NorthwindClient #AddQueryOptionsLinqSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#AddQueryOptionsLinqSpecific)]  
+  
+ この LINQ クエリは次のクエリ、Northwind ベースに対して実行される URI に変換[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)データ サービス。  
+  
+```  
+http://localhost:12345/Northwind.svc/Orders?Orderby=ShippedDate&?filter=Freight gt 30  
+```  
+  
+ LINQ の概要については、次を参照してください。 [LINQ (Language-Integrated Query)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)します。  
+  
+ LINQ を使用してクエリを作成する際には、前の例のような言語固有の宣言型のクエリ構文と、標準クエリ演算子と呼ばれる一連のクエリ メソッドの両方を使用できます。 したがって、次の例のように、前の例と同等のクエリをメソッド ベースの構文のみを使用して作成することもできます。  
+  
+  [Astoria NorthwindClient #AddQueryOptionsLinqExpressionSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#AddQueryOptionsLinqExpressionSpecific)]  
+  
+ どちらの方法で作成したクエリも、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントによってクエリ URI に変換されます。クエリ式にクエリ メソッドを追加して LINQ クエリを拡張することもできます。 クエリ式にメソッド構文を追加して LINQ クエリを作成した場合、または<xref:System.Data.Services.Client.DataServiceQuery%601>、操作をメソッドが呼び出される順序でのクエリ URI に追加します。 これは、呼び出すことと同じ、 <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A>というクエリ URI に各クエリ オプションを追加します。  
+  
+## <a name="executing-linq-queries"></a>LINQ クエリの実行  
+ 特定の LINQ などのメソッドのクエリ<xref:System.Linq.Enumerable.First%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29>または<xref:System.Linq.Enumerable.Single%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29>、クエリに追加するときに、クエリを実行します。 クエリは、結果が暗黙的に列挙される場合 (`foreach` ループの間など) や、クエリが `List` コレクションに割り当てられている場合にも実行されます。 詳細については、次を参照してください。[クエリ データ サービスに対する](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)します。  
+  
+ クライアントによる LINQ クエリの実行は&2; つの部分に分かれています。 可能な限り、クエリ内の LINQ 式は最初にクライアントで評価されます。その後、URI ベースのクエリが生成され、データ サービスに送信されて、サービス内のデータに対して評価されます。 詳細については、セクションを参照してください。[クライアントとサーバーでの実行](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md#executingQueries)で[クエリ データ サービスに対する](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)します。  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 準拠のクエリ URI で LINQ クエリを変換できない場合は、クエリを実行しようとすると例外が発生します。 詳細については、次を参照してください。[クエリ データ サービスに対する](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)します。  
+  
+## <a name="linq-query-examples"></a>LINQ クエリの例  
+ 以下のセクションの各例は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに対して実行できる LINQ クエリの種類を示しています。  
+  
+<a name="filtering"></a>   
+### <a name="filtering"></a>フィルター処理  
+ このセクションの LINQ クエリは、サービスによって返されるフィード内のデータをフィルター処理します。  
+  
+ 以下の各例は、返された `Orders` エンティティをフィルター処理して、輸送費が&30; ドルを超える注文のみが返されるようにする同等のクエリを示しています。  
+  
+-   LINQ クエリ構文を使用する場合:  
+  
+      [Astoria NorthwindClient #LinqWhereClauseSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqWhereClauseSpecific)]  
+  
+-   LINQ クエリ メソッドを使用する場合:  
+  
+      [Astoria NorthwindClient #LinqWhereMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqWhereMethodSpecific)]  
+  
+-   URI クエリ文字列オプション `$filter`:  
+  
+      [Astoria NorthwindClient #ExplicitQueryWhereMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#ExplicitQueryWhereMethodSpecific)]  
+  
+ 上の例はすべて、`http://localhost:12345/northwind.svc/Orders()?$filter=Freight gt 30M` というクエリ URI に変換されます。  
+  
+<a name="sorting"></a>   
+### <a name="sorting"></a>並べ替え  
+ 以下の各例は、返されたデータを会社名と郵便番号の降順で並べ替える同等のクエリを示しています。  
+  
+-   LINQ クエリ構文を使用する場合:  
+  
+      [Astoria NorthwindClient #LinqOrderByClauseSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqOrderByClauseSpecific)]  
+  
+-   LINQ クエリ メソッドを使用する場合:  
+  
+      [Astoria NorthwindClient #LinqOrderByMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqOrderByMethodSpecific)]  
+  
+-   URI クエリ文字列オプション `$orderby`:  
+  
+      [Astoria NorthwindClient #ExplicitQueryOrderByMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#ExplicitQueryOrderByMethodSpecific)]  
+  
+ 上の例はすべて、`http://localhost:12345/northwind.svc/Customers()?$orderby=CompanyName,PostalCode desc` というクエリ URI に変換されます。  
+  
+<a name="projection"></a>   
+### <a name="projection"></a>射影  
+ 以下の各例は、返されたデータをより範囲の狭い `CustomerAddress` 型に射影する同等のクエリを示しています。  
+  
+-   LINQ クエリ構文を使用する場合:  
+  
+      [Astoria NorthwindClient #LinqSelectClauseSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqSelectClauseSpecific)]  
+  
+-   LINQ クエリ メソッドを使用する場合:  
+  
+      [Astoria NorthwindClient #LinqSelectMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqSelectMethodSpecific)]  
+  
+> [!NOTE]
+>  `$select`クエリ オプションを使用してクエリ URI に追加できません、 <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A>メソッドです。 LINQ を使用することをお勧め<xref:System.Linq.Enumerable.Select%2A>クライアントを生成するメソッド、`$select`クエリ要求 URI 内のオプション\</TSource, TResult>。  
+  
+ 上の例はいずれも、`"http://localhost:12345/northwind.svc/Customers()?$filter=Country eq 'GerGerm'&$select=CustomerID,Address,City,Region,PostalCode,Country"` というクエリ URI に変換されます。  
+  
+<a name="paging"></a>   
+### <a name="client-paging"></a>クライアントのページング  
+ 以下の各例は、25 件の注文を含む並べ替え済みの注文エンティティのページを、最初の 50 件の注文をスキップして要求する同等のクエリを示しています。  
+  
+-   LINQ クエリにクエリ メソッドを適用する場合:  
+  
+      [Astoria NorthwindClient #LinqSkipTakeMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqSkipTakeMethodSpecific)]  
+  
+-   URI クエリ文字列オプション `$skip` および `$top`:  
+  
+      [Astoria NorthwindClient #ExplicitQuerySkipTakeMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#ExplicitQuerySkipTakeMethodSpecific)]  
+  
+ 上の例はいずれも、`http://localhost:12345/northwind.svc/Orders()?$orderby=OrderDate desc&$skip=50&$top=25` というクエリ URI に変換されます。  
+  
+<a name="expand"></a>   
+### <a name="expand"></a>Expand  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] データ サービスを照会するときに、返されるフィードにクエリの対象のエンティティに関連するエンティティを含めるように要求することができます。 <xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A>メソッドが、 <xref:System.Data.Services.Client.DataServiceQuery%601> LINQ クエリの対象となるエンティティ セットの関連するエンティティ セットの名前として、`path`パラメーター。 詳細については、次を参照してください。[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)します。  
+  
+ 次の例は、使用する同等の方法を示して、<xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A>クエリ内のメソッド。  
+  
+-   LINQ クエリ構文の場合:  
+  
+      [Astoria NorthwindClient #LinqQueryExpandSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqQueryExpandSpecific)]  
+  
+-   LINQ クエリ メソッドの場合:  
+  
+      [Astoria NorthwindClient #LinqQueryExpandMethodSpecific](../../../../amples/snippets/xml/VS_Snippets_Misc/astoria northwind service/astoria.vsmdi NorthwindClient#LinqQueryExpandMethodSpecific)]  
+  
+ 上の例はいずれも、`http://localhost:12345/northwind.svc/Orders()?$filter=CustomerID eq 'ALFKI'&$expand=Order_Details` というクエリ URI に変換されます。  
+  
+<a name="unsupportedMethods"></a>   
+## <a name="unsupported-linq-methods"></a>サポートされていない LINQ メソッド  
+ 次の表に含まれている LINQ メソッドはサポートされていません。[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに対して実行されるクエリにこれらのメソッドを含めることはできません。  
+  
+|演算の種類|サポートされていないメソッド|  
+|--------------------|------------------------|  
+|集合演算子|すべての集合演算子はに対してサポートされている、 <xref:System.Data.Services.Client.DataServiceQuery%601>、次が含まれています。<br /><br /> -   <xref:System.Linq.Enumerable.All%2A><br />-   <xref:System.Linq.Enumerable.Any%2A><br />-   <xref:System.Linq.Enumerable.Concat%2A><br />-   <xref:System.Linq.Enumerable.DefaultIfEmpty%2A><br />-   <xref:System.Linq.Enumerable.Distinct%2A><br />-   <xref:System.Linq.Enumerable.Except%2A><br />-   <xref:System.Linq.Enumerable.Intersect%2A><br />-   <xref:System.Linq.Enumerable.Union%2A><br />-   <xref:System.Linq.Enumerable.Zip%2A>\</TFirst, TSecond, TResult>|  
+|順序付け演算子|次の順序付け演算子を必要とする<xref:System.Collections.Generic.IComparer%601>に対してサポートされていない、 <xref:System.Data.Services.Client.DataServiceQuery%601>:<br /><br /> -   <xref:System.Linq.Enumerable.OrderBy%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Collections.Generic.IComparer%7B%60%601%7D%29> </TSource, TKey> </TSource, TKey><br />-   <xref:System.Linq.Enumerable.OrderByDescending%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Collections.Generic.IComparer%7B%60%601%7D%29> \</TSource, TKey> \</TSource, TKey><br />-   <xref:System.Linq.Enumerable.ThenBy%60%602%28System.Linq.IOrderedEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Collections.Generic.IComparer%7B%60%601%7D%29> </TSource, TKey> </TSource, TKey><br />-   <xref:System.Linq.Enumerable.ThenByDescending%60%602%28System.Linq.IOrderedEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2C%60%601%7D%2CSystem.Collections.Generic.IComparer%7B%60%601%7D%29> \</TSource, TKey> \</TSource, TKey>|  
+|プロジェクション演算子とフィルター演算子|以下のプロジェクションと位置の引数を受け入れるフィルターの演算子がに対してサポートされていない、 <xref:System.Data.Services.Client.DataServiceQuery%601>:<br /><br /> -   <xref:System.Linq.Enumerable.Join%60%604%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%2CSystem.Func%7B%60%600%2C%60%601%2C%60%603%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%602%7D%29> </TOuter, TInner, TResult> </TInner, TKey> </TOuter, TKey> </TOuter, TInner, TKey, TResult><br />-   <xref:System.Linq.Enumerable.Select%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2C%60%601%7D%29> </TSource, Int32, TResult> </TSource, TResult><br />-   <xref:System.Linq.Enumerable.SelectMany%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%7D%29> </TSource, TResult><br />-   <xref:System.Linq.Enumerable.SelectMany%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%7D%29> </TSource, TResult><br />-   <xref:System.Linq.Enumerable.SelectMany%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%7D%2CSystem.Func%7B%60%600%2C%60%601%2C%60%602%7D%29> \</TSource, TCollection, TResult> \</TSource, TCollection, TResult><br />-   <xref:System.Linq.Enumerable.SelectMany%60%603%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%7D%2CSystem.Func%7B%60%600%2C%60%601%2C%60%602%7D%29> </TSource, TCollection, TResult> </TSource, TCollection, TResult><br />-   <xref:System.Linq.Enumerable.Where%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%600%2CSystem.Int32%2CSystem.Boolean%7D%29> \</TSource, Int32, Boolean>|  
+|グループ化演算子|に対するすべてのグループ化演算子がサポートされていない、 <xref:System.Data.Services.Client.DataServiceQuery%601>、次を含みます。<br /><br /> -   <xref:System.Linq.Enumerable.GroupBy%2A>\</TSource, TKey><br />-   <xref:System.Linq.Enumerable.GroupJoin%2A>\</TOuter, TInner, TKey, TResult><br /><br /> グループ化の操作はクライアント側で実行する必要があります。|  
+|集計演算子|に対するすべての集計演算子がサポートされていない、 <xref:System.Data.Services.Client.DataServiceQuery%601>、次を含みます。<br /><br /> -   <xref:System.Linq.Enumerable.Aggregate%2A><br />-   <xref:System.Linq.Enumerable.Average%2A><br />-   <xref:System.Linq.Enumerable.Count%2A><br />-   <xref:System.Linq.Enumerable.LongCount%2A><br />-   <xref:System.Linq.Enumerable.Max%2A><br />-   <xref:System.Linq.Enumerable.Min%2A><br />-   <xref:System.Linq.Enumerable.Sum%2A><br /><br /> 集計操作は、クライアント側で実行するか、サービス操作でカプセル化する必要があります。|  
+|ページング演算子|に対して以下のページング演算子はサポートされていません、 <xref:System.Data.Services.Client.DataServiceQuery%601>:<br /><br /> -   <xref:System.Linq.Enumerable.ElementAt%2A><br />-   <xref:System.Linq.Enumerable.Last%2A><br />-   <xref:System.Linq.Enumerable.LastOrDefault%2A><br />-   <xref:System.Linq.Enumerable.SkipWhile%2A><br />-   <xref:System.Linq.Enumerable.TakeWhile%2A> **注:** null、空のシーケンスで実行されるページング演算子を返します。|  
+|その他の演算子|次に対して他の演算子がサポートされていない、 <xref:System.Data.Services.Client.DataServiceQuery%601>:<br /><br /> 1.<xref:System.Linq.Enumerable.Empty%2A><br />2.<xref:System.Linq.Enumerable.Range%2A><br />3.<xref:System.Linq.Enumerable.Repeat%2A><br />4.<xref:System.Linq.Enumerable.ToDictionary%2A></TSource, TKey><br />5.<xref:System.Linq.Enumerable.ToLookup%2A>\</TSource, TKey>|  
+  
+<a name="supportedExpressions"></a>   
+## <a name="supported-expression-functions"></a>サポートされている式の関数  
+ 共通言語ランタイム (CLR) の以下のメソッドおよびプロパティは、クエリ式で変換して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスへの要求 URI に含めることができるため、サポートされています。  
+  
+|<xref:System.String>メンバー|サポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 関数|  
+|-----------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|  
+|<xref:System.String.Concat%28System.String%2CSystem.String%29>|`string concat(string p0, string p1)`|  
+|<xref:System.String.Contains%28System.String%29>|`bool substringof(string p0, string p1)`|  
+|<xref:System.String.EndsWith%28System.String%29>|`bool endswith(string p0, string p1)`|  
+|<xref:System.String.IndexOf%28System.String%2CSystem.Int32%29>|`int indexof(string p0, string p1)`|  
+|<xref:System.String.Length>|`int length(string p0)`|  
+|<xref:System.String.Replace%28System.String%2CSystem.String%29>|`string replace(string p0, string find, string replace)`|  
+|<xref:System.String.Substring%28System.Int32%29>|`string substring(string p0, int pos)`|  
+|<xref:System.String.Substring%28System.Int32%2CSystem.Int32%29>|`string substring(string p0, int pos, int length)`|  
+|<xref:System.String.ToLower>|`string tolower(string p0)`|  
+|<xref:System.String.ToUpper>|`string toupper(string p0)`|  
+|<xref:System.String.Trim>|`string trim(string p0)`|  
+  
+|<xref:System.DateTime>メンバー<sup>1</sup>|サポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 関数|  
+|-------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|  
+|<xref:System.DateTime.Day>|`int day(DateTime p0)`|  
+|<xref:System.DateTime.Hour>|`int hour(DateTime p0)`|  
+|<xref:System.DateTime.Minute>|`int minute(DateTime p0)`|  
+|<xref:System.DateTime.Month>|`int month(DateTime p0)`|  
+|<xref:System.DateTime.Second>|`int second(DateTime p0)`|  
+|<xref:System.DateTime.Year>|`int year(DateTime p0)`|  
+  
+ <sup>1</sup>と等価な日付と時刻のプロパティの<xref:Microsoft.VisualBasic.DateAndTime?displayProperty=fullName>、だけでなく、 <xref:Microsoft.VisualBasic.DateAndTime.DatePart%2A> Visual Basic のメソッドもサポートされています。  
+  
+|<xref:System.Math>メンバー|サポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 関数|  
+|---------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|  
+|<xref:System.Math.Ceiling%28System.Decimal%29>|`decimal ceiling(decimal p0)`|  
+|<xref:System.Math.Ceiling%28System.Double%29>|`double ceiling(double p0)`|  
+|<xref:System.Math.Floor%28System.Decimal%29>|`decimal floor(decimal p0)`|  
+|<xref:System.Math.Floor%28System.Double%29>|`double floor(double p0)`|  
+|<xref:System.Math.Round%28System.Decimal%29>|`decimal round(decimal p0)`|  
+|<xref:System.Math.Round%28System.Double%29>|`double round(double p0)`|  
+  
+|<xref:> System.Linq.Expressions.Expression?qualifyHint=False&autoUpgrade=Trueメンバー|サポートされている [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 関数|  
+|---------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|  
+|<xref:System.Linq.Expressions.Expression.TypeIs%28System.Linq.Expressions.Expression%2CSystem.Type%29>|`bool isof(type p0)`|  
+  
+ クライアント側でその他の CLR 関数を評価できる場合もあります。 A <xref:System.NotSupportedException>がクライアントで評価できないし、サーバー上での評価の有効な要求 URI に変換できない式に対して発生します。  
+  
+## <a name="see-also"></a>関連項目  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)   
+ [クエリ射影](../../../../docs/framework/data/wcf/query-projections-wcf-data-services.md)   
+ [オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)   
+ [OData: URI 規則](http://go.microsoft.com/fwlink/?LinkID=185564)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md b/docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md
new file mode 100644
index 00000000000..78f225835a0
--- /dev/null
+++ b/docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md
@@ -0,0 +1,66 @@
+---
+title: "遅延コンテンツの読み込み (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, 遅延コンテンツ"
+  - "WCF Data Services, データの読み込み"
+ms.assetid: 32f9b588-c832-44c4-a7e0-fcce635df59a
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 遅延コンテンツの読み込み (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の既定では、クエリが返すデータの量が制限されます。  その一方で、関連エンティティ、ページングされた応答データ、およびバイナリ データ ストリームを含む追加データをデータ サービスから必要に応じて明示的に読み込むことができます。  このトピックでは、このような遅延コンテンツをアプリケーションに読み込む方法について説明します。  
+  
+## 関連エンティティ  
+ クエリを実行すると、アドレス指定したエンティティ セット内のエンティティだけが返されます。  たとえば、Northwind データ サービスに対するクエリが `Customers` エンティティを返す場合、`Customers` と `Orders` の間にリレーションシップがあっても、既定では関連 `Orders` エンティティは返されません。  また、データ サービスでページングが有効になった場合は、以降のデータ ページをサービスから明示的に読み込む必要があります。  関連エンティティを読み込むには、2 つの方法があります。  
+  
+-   **一括読み込み**: `$expand` クエリ オプションを使用して、クエリが要求するエンティティ セットへのアソシエーションによって関連付けられたエンティティをクエリが返すよう要求できます。  <xref:System.Data.Services.Client.DataServiceQuery%601> に対して <xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドを使用して、データ サービスに送信されるクエリに `$expand` オプションを追加します。  次の例に示すように、エンティティ セットをコンマで区切ることによって関連する複数のエンティティ セットを要求できます。  クエリによって要求されたすべてのエンティティは、1 つの応答で返されます。  次の例では、`Order_Details` および `Customers` が `Orders` エンティティ セットと一緒に返されます。  
+  
+     [!code-csharp[Astoria Northwind Client#ExpandOrderDetailsSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#expandorderdetailsspecific)]
+     [!code-vb[Astoria Northwind Client#ExpandOrderDetailsSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#expandorderdetailsspecific)]  
+  
+     [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、`$expand` クエリ オプションを使用して、1 つのクエリに含めることができるエンティティ セットの数を 12 に制限しています。  
+  
+-   **明示的読み込み**: <xref:System.Data.Services.Client.DataServiceContext> インスタンスで <xref:System.Data.Services.Client.DataServiceContext.LoadProperty%2A> メソッドを呼び出して、関連エンティティを明示的に読み込むことができます。  <xref:System.Data.Services.Client.DataServiceContext.LoadProperty%2A> メソッドへの各呼び出しによって、データ サービスへの個別の要求が作成されます。  次の例では、`Orders` エンティティの `Order_Details` を明示的に読み込みます。  
+  
+     [!code-csharp[Astoria Northwind Client#LoadRelatedOrderDetailsSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#loadrelatedorderdetailsspecific)]
+     [!code-vb[Astoria Northwind Client#LoadRelatedOrderDetailsSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#loadrelatedorderdetailsspecific)]  
+  
+ どちらのオプションを使用するかを検討する場合、データ サービスへの要求の数と 1 つの応答で返されるデータの量のバランスを考慮してください。  アプリケーションが関連オブジェクトを必要とし、それらのオブジェクトを明示的に取得するための追加要求による待機時間を回避する場合は、一括読み込みを使用します。  しかし、アプリケーションが特定の関連エンティティ インスタンスのデータしか必要としない場合は、<xref:System.Data.Services.Client.DataServiceContext.LoadProperty%2A> メソッドを呼び出して、これらのエンティティを明示的に読み込むことを検討することをお勧めします。  詳細については、「[方法: 関連エンティティを読み込む](../../../../docs/framework/data/wcf/how-to-load-related-entities-wcf-data-services.md)」を参照してください。  
+  
+## ページングされたコンテンツ  
+ データ サービスでページングが有効化されている場合、データ サービスが返すフィード内のエントリの数はデータ サービスの構成によって制限されます。  ページ制限は、各エンティティ セットに対して個別に設定できます。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  ページングが有効である場合、フィードの最終的なエントリには、データの次のページへのリンクが含まれます。  このリンクは、<xref:System.Data.Services.Client.DataServiceQueryContinuation%601> オブジェクトに含まれます。  データの次のページへの URI は、<xref:System.Data.Services.Client.DataServiceQuery%601> が実行されたときに返される <xref:System.Data.Services.Client.QueryOperationResponse%601> で <xref:System.Data.Services.Client.QueryOperationResponse%601.GetContinuation%2A> メソッドを呼び出すことによって取得します。  返された <xref:System.Data.Services.Client.DataServiceQueryContinuation%601> オブジェクトが使用されて、結果の次のページが読み込まれます。  クエリ結果は、<xref:System.Data.Services.Client.QueryOperationResponse%601.GetContinuation%2A> メソッドを呼び出す前に列挙する必要があります。  最初に `do...while` ループを使用してクエリ結果を列挙した後に、次の `non-null` リンク値をチェックすることをお勧めします。  <xref:System.Data.Services.Client.QueryOperationResponse%601.GetContinuation%2A> メソッドが `null` \(Visual Basic の場合は `Nothing`\) を返す場合、元のクエリに追加の結果ページはありません。  次の例は、Northwind サンプル データ サービスからページングされた顧客データを読み込む `do...while` ループを示します。  
+  
+ [!code-csharp[Astoria Northwind Client#LoadNextLink](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#loadnextlink)]
+ [!code-vb[Astoria Northwind Client#LoadNextLink](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#loadnextlink)]  
+  
+ 要求されたエンティティ セットと一緒に関連エンティティを 1 つの応答で返すようクエリが要求すると、ページング制限は、応答と共にインラインで含まれるネストされたフィードに影響することがあります。  たとえば、Northwind サンプル データ サービスで `Customers` エンティティ セットに対してページング制限が設定されている場合、次の Northwind サンプル データ サービスを定義する Northwind.svc.cs ファイルの例に示すように、独立したページング制限を関連 `Orders` エンティティ セットに設定することもできます。  
+  
+ [!code-csharp[Astoria Northwind Service#DataServiceConfigPaging](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind.svc.cs#dataserviceconfigpaging)]
+ [!code-vb[Astoria Northwind Service#DataServiceConfigPaging](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind.svc.vb#dataserviceconfigpaging)]  
+  
+ この場合、最上位レベルの `Customers` エンティティ フィードとネストされた `Orders` エンティティ フィードの両方にページングを実装する必要があります。  次の例は、選択した `Customers` エンティティに関連する `Orders` エンティティのページを読み込むために使用する `while` ループを示します。  
+  
+ [!code-csharp[Astoria Northwind Client#LoadNextOrdersLink](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#loadnextorderslink)]
+ [!code-vb[Astoria Northwind Client#LoadNextOrdersLink](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#loadnextorderslink)]  
+  
+ 詳細については、「[方法: ページングされた結果を読み込む](../../../../docs/framework/data/wcf/how-to-load-paged-results-wcf-data-services.md)」を参照してください。  
+  
+## バイナリ データ ストリーム  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、バイナリ ラージ オブジェクト \(BLOB\) データにデータ ストリームとしてアクセスできます。  ストリーミングは必要になるまでバイナリ データの読み込みを待機し、クライアントは、このデータを効率的に処理できます。  この機能を活用するには、データ サービスは <xref:System.Data.Services.Providers.IDataServiceStreamProvider> プロバイダーを実装する必要があります。  詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。  ストリーミングが有効である場合、エンティティ型は関連バイナリ データなしで返されます。  この場合、サービスのバイナリ データのデータ ストリームにアクセスするには、<xref:System.Data.Services.Client.DataServiceContext> クラスの <xref:System.Data.Services.Client.DataServiceContext.GetReadStream%2A> メソッドを使用する必要があります。  同様に、<xref:System.Data.Services.Client.DataServiceContext.SetSaveStream%2A> メソッドを使用して、エンティティのバイナリ データをストリームとして追加または変更します。  詳細については、「[バイナリ データの操作](../../../../docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md b/docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md
new file mode 100644
index 00000000000..b4535bd469d
--- /dev/null
+++ b/docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md
@@ -0,0 +1,50 @@
+---
+title: "データ サービス コンテキストの管理 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15b19d09-7de7-4638-9556-6ef396cc45ec
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# データ サービス コンテキストの管理 (WCF Data Services)
+<xref:System.Data.Services.Client.DataServiceContext> クラスは、特定のデータ サービスに対してサポートされている操作をカプセル化します。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスはステートレスですが、コンテキストはステートレスではありません。  このため <xref:System.Data.Services.Client.DataServiceContext> クラスを使用すると、変更管理などの機能をサポートするためにデータ サービスとの対話操作間におけるクライアントの状態を保持できます。  このクラスは、ID の管理と変更の追跡も行います。  
+  
+## マージ オプションおよび ID 解決  
+ <xref:System.Data.Services.Client.DataServiceQuery%601> が実行されると、応答フィードのエンティティはオブジェクトに具体化されます。  詳細については、「[オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)」を参照してください。  応答メッセージのエントリがオブジェクトに具体化される方法は、ID 解決に基づいて実行され、クエリが実行された際のマージ オプションによって決まります。  複数のクエリまたは読み込み要求が単一の <xref:System.Data.Services.Client.DataServiceContext> のスコープで実行される場合、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントは特定のキー値を持つオブジェクトの単一のインスタンスのみを追跡します。  このキーは、ID 解決の実行に使用され、エンティティを一意に識別します。  
+  
+ 既定では、クライアントは <xref:System.Data.Services.Client.DataServiceContext> によってまだ追跡されていないエンティティのオブジェクトに応答フィードのエントリを具体化するだけです。  これは、既にキャッシュ内にあるオブジェクトに対する変更は上書きされないことを意味します。  この動作は、クエリおよび読み込み操作に <xref:System.Data.Services.Client.MergeOption> 値を指定することによって制御されます。  このオプションを指定するには、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.MergeOption%2A> プロパティを設定します。  既定のマージ オプションの値は <xref:System.Data.Services.Client.MergeOption> です。  この既定値を設定した場合、まだ追跡されていないエンティティのオブジェクトのみが具体化されます。これは、既存のオブジェクトが上書きされないことを意味します。  クライアントのオブジェクトに対する変更がデータ サービスからの更新によって上書きされないようにするもう 1 つの方法は、<xref:System.Data.Services.Client.MergeOption> を指定する方法です。  <xref:System.Data.Services.Client.MergeOption> を指定した場合、クライアントのオブジェクトの値は、既に変更が加えられていても、応答フィードのエントリの最新の値によって置換されます。  <xref:System.Data.Services.Client.MergeOption> マージ オプションを使用する場合、<xref:System.Data.Services.Client.DataServiceContext> はクライアント オブジェクトに加えられた変更をデータ サービスに送信できません。  このオプションを使用すると、変更は常にデータ サービスの値によって上書きされます。  
+  
+## 同時実行の管理  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、オプティミスティック同時実行制御がサポートされており、データ サービスで更新の競合を検出できます。  データ サービス プロバイダーは、データ サービスで同時実行トークンを使用してエンティティへの変更をチェックするように構成できます。  このトークンには、リソースが変更されているかどうかを決定するためにデータ サービスによって検証されるエンティティ型の 1 つ以上のプロパティが含まれています。  同時実行トークンは、データ サービスへの要求およびデータ サービスからの応答の eTag ヘッダーに含まれ、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントによって管理されます。詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ <xref:System.Data.Services.Client.DataServiceContext> は、<xref:System.Data.Services.Client.DataServiceContext.AddObject%2A>、<xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A>、および <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> を使用して手動で報告しているか、または <xref:System.Data.Services.Client.DataServiceCollection%601> によって報告されているオブジェクトへの変更を追跡します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドを呼び出すと、クライアントはデータ サービスに変更を送り返します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> は、クライアントでのデータ変更がデータ サービスでの変更と競合する場合に失敗する可能性があります。  このような状況が発生した場合、エンティティ リソースに対してクエリを再度実行し、更新データを受信する必要があります。  データ サービスの変更を上書きするには、<xref:System.Data.Services.Client.MergeOption> マージ オプションを使用してクエリを実行します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> を再度呼び出すと、データ サービスのリソースに対してその他の変更がまだ行われていない場合に限り、クライアントに保存されている変更がデータ サービスに永続化されます。  
+  
+## 変更の保存  
+ 変更は、<xref:System.Data.Services.Client.DataServiceContext> インスタンスで追跡されますが、サーバーには直ちに送信されません。  指定されたアクティビティに対して必要な変更が完了した後、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> を呼び出して、すべての変更をデータ サービスに送信します。  <xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> 操作が完了した後、<xref:System.Data.Services.Client.DataServiceResponse> オブジェクトが返されます。  <xref:System.Data.Services.Client.DataServiceResponse> オブジェクトには、<xref:System.Data.Services.Client.OperationResponse> オブジェクトのシーケンスが含まれます。さらに、これらの各オブジェクトには、永続化または試行された変更を表す、<xref:System.Data.Services.Client.EntityDescriptor> インスタンスまたは <xref:System.Data.Services.Client.LinkDescriptor> インスタンスのシーケンスが含まれます。  データ サービス内でエンティティが作成または変更されると、前の例で生成された `ProductID` 値のようなサーバー生成のプロパティ値も含めて、更新されたエンティティへの参照が <xref:System.Data.Services.Client.EntityDescriptor> に含められます。  クライアント ライブラリは、これらの新しい値を持つように [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトを自動的に更新します。  
+  
+ 挿入操作と更新操作を適切に実行するため、その操作に関連付けられている <xref:System.Data.Services.Client.EntityDescriptor> オブジェクトまたは <xref:System.Data.Services.Client.LinkDescriptor> オブジェクトの状態プロパティが <xref:System.Data.Services.Client.EntityStates> に設定され、新しい値は <xref:System.Data.Services.Client.MergeOption> を使用してマージされます。  データ サービス内で挿入、更新、または削除操作が失敗した場合、エンティティ状態は、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> が呼び出される前と同じままになり、<xref:System.Data.Services.Client.OperationResponse> の <xref:System.Data.Services.Client.OperationResponse.Error%2A> プロパティは、エラーに関する情報を含む <xref:System.Data.Services.Client.DataServiceRequestException> に設定されます。  詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+### 更新用の HTTP メソッドの設定  
+ 既定では、更新は、.NET Framework クライアント ライブラリから既存のエンティティに MERGE 要求として送信されます。  MERGE 要求では、エンティティの選択されたプロパティが更新されますが、クライアントは、常に、変更されていないプロパティを含むすべてのプロパティを MERGE 要求に含めます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルは、エンティティを更新する PUT 要求の送信もサポートしています。  PUT 要求では、既存のエンティティが、クライアントからのプロパティ値を含むエンティティの新しいインスタンスによって本質的に置き換えられます。  PUT 要求を使用するには、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> を呼び出すときに <xref:System.Data.Services.Client.SaveChangesOptions> フラグを <xref:System.Data.Services.Client.SaveChangesOptions> 列挙体に設定します。  
+  
+> [!NOTE]
+>  クライアントがエンティティの一部のプロパティを認識していない場合、PUT 要求は MERGE 要求とは異なる動作になります。  この状況は、クライアントでエンティティ型を新しい型に射影する場合に発生することがあります。  また、新しいプロパティがサービス データ モデルのエンティティに追加されており、このようなクライアントのマッピング エラーを無視するように <xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.IgnoreMissingProperties%2A> プロパティが `true` に設定されている場合にも発生することがあります。  この場合、PUT 要求では、クライアントが認識していないすべてのプロパティが既定値にリセットされます。  
+  
+### POST トンネリング  
+ 既定では、クライアント ライブラリは、作成、読み取り、更新、および削除要求を、POST、GET、PUT\/MERGE\/PATCH、および DELETE の対応する HTTP メソッドを使用して、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに送信します。  これは、Representational State Transfer \(REST\) の基本原則に沿った動作です。  ただし、すべての Web サーバー実装で HTTP メソッドの完全なセットがサポートされるとは限りません。  場合によっては、サポートされているメソッドが GET と POST のみに制限されていることもあります。  このような状況は、ファイアウォールのような仲介物が特定のメソッドの要求をブロックしている場合に発生します。  GET メソッドと POST メソッドは一般的にサポートされているメソッドであるため、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、サポートされていない HTTP メソッドを POST 要求を使用して実行する方法を規定しています。  *メソッド トンネリング*または *POST トンネリング*と呼ばれるこの方法を使うと、クライアントは、カスタムの `X-HTTP-Method` ヘッダーに実際のメソッドが指定された POST 要求を送信できます。  要求の POST トンネリングを有効にするには、<xref:System.Data.Services.Client.DataServiceContext> インスタンスの <xref:System.Data.Services.Client.DataServiceContext.UsePostTunneling%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)   
+ [非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)   
+ [バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/media/addsearchcontract.png b/docs/framework/data/wcf/media/addsearchcontract.png
new file mode 100644
index 00000000000..f4cce2a7fea
Binary files /dev/null and b/docs/framework/data/wcf/media/addsearchcontract.png differ
diff --git a/docs/framework/data/wcf/media/addservicereferenceerror.png b/docs/framework/data/wcf/media/addservicereferenceerror.png
new file mode 100644
index 00000000000..eca8c617912
Binary files /dev/null and b/docs/framework/data/wcf/media/addservicereferenceerror.png differ
diff --git a/docs/framework/data/wcf/media/addservicereferenceodata.png b/docs/framework/data/wcf/media/addservicereferenceodata.png
new file mode 100644
index 00000000000..68900bbc752
Binary files /dev/null and b/docs/framework/data/wcf/media/addservicereferenceodata.png differ
diff --git a/docs/framework/data/wcf/media/appxaml.png b/docs/framework/data/wcf/media/appxaml.png
new file mode 100644
index 00000000000..81ff8c4b85a
Binary files /dev/null and b/docs/framework/data/wcf/media/appxaml.png differ
diff --git a/docs/framework/data/wcf/media/appxmanifest.png b/docs/framework/data/wcf/media/appxmanifest.png
new file mode 100644
index 00000000000..373199d0349
Binary files /dev/null and b/docs/framework/data/wcf/media/appxmanifest.png differ
diff --git a/docs/framework/data/wcf/media/astoriaservicearch.gif b/docs/framework/data/wcf/media/astoriaservicearch.gif
new file mode 100644
index 00000000000..99ac5cbcef8
Binary files /dev/null and b/docs/framework/data/wcf/media/astoriaservicearch.gif differ
diff --git a/docs/framework/data/wcf/media/defaultapplication.png b/docs/framework/data/wcf/media/defaultapplication.png
new file mode 100644
index 00000000000..e1e27ad7fea
Binary files /dev/null and b/docs/framework/data/wcf/media/defaultapplication.png differ
diff --git a/docs/framework/data/wcf/media/defualtappsplash.png b/docs/framework/data/wcf/media/defualtappsplash.png
new file mode 100644
index 00000000000..4d6497a2e61
Binary files /dev/null and b/docs/framework/data/wcf/media/defualtappsplash.png differ
diff --git a/docs/framework/data/wcf/media/win8clientcreatenewproject.png b/docs/framework/data/wcf/media/win8clientcreatenewproject.png
new file mode 100644
index 00000000000..3b4a5be8777
Binary files /dev/null and b/docs/framework/data/wcf/media/win8clientcreatenewproject.png differ
diff --git a/docs/framework/data/wcf/number-of-entities-returned-by-a-query-wcf.md b/docs/framework/data/wcf/number-of-entities-returned-by-a-query-wcf.md
new file mode 100644
index 00000000000..dfd21f22253
--- /dev/null
+++ b/docs/framework/data/wcf/number-of-entities-returned-by-a-query-wcf.md
@@ -0,0 +1,39 @@
+---
+title: "方法: クエリで返されたエンティティの数を確認する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 行数"
+ms.assetid: 03d41a82-df95-40ac-8439-a6c327d37ba8
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: クエリで返されたエンティティの数を確認する (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用すると、クエリ URI によって指定されたエンティティ セット内のエンティティの数を確認できます。  この数は、クエリ結果と一緒に、または整数値として含まれます。  詳細については、「[データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Data.Services.Client.DataServiceQuery%601.IncludeTotalCount%2A> メソッドを呼び出した後でクエリを実行します。  <xref:System.Data.Services.Client.QueryOperationResponse%601.TotalCount%2A> プロパティが、`Customers` エンティティ セット内のエンティティの数を返します。  
+  
+ [!code-csharp[Astoria Northwind Client#CountAllCustomers](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#countallcustomers)]
+ [!code-vb[Astoria Northwind Client#CountAllCustomers](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#countallcustomers)]  
+  
+## 使用例  
+ 次の例では、`Customers` エンティティ セット内のエンティティの数である整数値のみを返す <xref:System.Linq.Enumerable.Count%2A> メソッドを呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#CountAllCustomersValueOnly](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#countallcustomersvalueonly)]
+ [!code-vb[Astoria Northwind Client#CountAllCustomersValueOnly](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#countallcustomersvalueonly)]  
+  
+## 参照  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/object-materialization-wcf-data-services.md b/docs/framework/data/wcf/object-materialization-wcf-data-services.md
new file mode 100644
index 00000000000..da77390876c
--- /dev/null
+++ b/docs/framework/data/wcf/object-materialization-wcf-data-services.md
@@ -0,0 +1,58 @@
+---
+title: "オブジェクトの具体化 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, クエリ"
+ms.assetid: f0dbf7b0-0292-4e31-9ae4-b98288336dc1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# オブジェクトの具体化 (WCF Data Services)
+**\[サービス参照の追加\]** ダイアログを使用して .NET Framework ベースのクライアント アプリケーションの [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを使用すると、フィードによって公開されるデータ モデルの各エンティティ型に対して同等のデータ クラスが生成されます。  詳細については、「[データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)」を参照してください。  クエリによって返されるエンティティ データは、これらの生成されたクライアント データ サービス クラスのいずれかのインスタンスに具体化されます。  マージ オプションおよび追跡オブジェクトの ID 解決については、「[データ サービス コンテキストの管理](../../../../docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md)」を参照してください。  
+  
+ さらに [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、ツールによって生成されたデータ クラスを使用する代わりに、独自のクライアント データ サービス クラスを定義できます。  これにより、"plain\-old CLR object" \(POCO\) データ クラスとして知られる独自のデータ クラスを使用できます。  これらの型のカスタム データ クラスを使用する際は、データ クラスを <xref:System.Data.Services.Common.DataServiceKeyAttribute> または <xref:System.Data.Services.Common.DataServiceEntityAttribute> で属性化し、クライアント上のその型名がデータ サービスのデータ モデル内の型名と一致するようにする必要があります。  
+  
+ ライブラリではクエリ応答メッセージを受け取ると、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードから返されたデータを、クエリの型のクライアント データ サービス クラスのインスタンスに具体化します。  これらのオブジェクトを具体化する一般的なプロセスは次のとおりです。  
+  
+1.  クライアント ライブラリは、応答メッセージ フィード内の `entry` 要素からシリアル化された型を読み取り、次のいずれかの方法で正しい型の新しいインスタンスの作成を試みます。  
+  
+    -   フィードで宣言された型の名前が <xref:System.Data.Services.Client.DataServiceQuery%601> の型と同じ場合は、空のコンストラクターを使用してこの型の新しいインスタンスが作成されます。  
+  
+    -   フィードで宣言された型の名前が <xref:System.Data.Services.Client.DataServiceQuery%601> の型から派生した型と同じ場合は、空のコンストラクターを使用して派生したこの型の新しいインスタンスが作成されます。  
+  
+    -   フィードで宣言された型が <xref:System.Data.Services.Client.DataServiceQuery%601> の型、または派生した型と一致しない場合は、空のコンストラクターを使用してクエリされた型の新しいインスタンスが作成されます。  
+  
+    -   <xref:System.Data.Services.Client.DataServiceContext.ResolveType%2A> プロパティが設定されている場合、指定されたデリゲートが呼び出され、既定の名前ベースの型のマッピングを上書きし、<xref:System.Func%602> によって返された型の新しいインスタンスが代わりに作成されます。  このデリゲートが NULL 値を返した場合、クエリされた型の新しいインスタンスが代わりに作成されます。  継承のシナリオをサポートするために、既定の名前ベースの型名のマッピングを上書きすることが必要な場合があります。  
+  
+2.  クライアント ライブラリは `entry` の `id` 要素から URI 値を読み取ります。これがエンティティの ID 値です。  <xref:System.Data.Services.Client.MergeOption> の  <xref:System.Data.Services.Client.DataServiceContext.MergeOption%2A> 値が使用されない限り、<xref:System.Data.Services.Client.DataServiceContext> のオブジェクトの追跡には、ID 値が使用されます。  さらに、クエリ応答でエンティティが複数回返されたときでも、単一のエンティティ インスタンスのみが作成されることを保証するためにも ID 値を使用します。  
+  
+3.  クライアント ライブラリは、フィード エントリからプロパティを読み取り、新しく作成されたオブジェクトに対応するプロパティを設定します。  <xref:System.Data.Services.Client.DataServiceContext> に同じ ID 値のオブジェクトが既に存在する場合、プロパティは、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.MergeOption> 設定に基づき設定されます。  応答には、クライアント型で対応するプロパティがないプロパティ値が含まれる場合があります。  そのような場合、アクションは、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.IgnoreMissingProperties%2A> プロパティの値によって異なります。  このプロパティが `true` に設定されている場合は、欠落しているプロパティは無視されます。  それ以外の場合は、エラーが発生します。  プロパティは次のように設定されます。  
+  
+    -   スカラー プロパティは、応答メッセージのエントリ内の対応する値に設定されます。  
+  
+    -   複合プロパティは、新しい複合型インスタンスに設定されます。このインスタンスは、応答からの複合型のプロパティとともに設定されます。  
+  
+    -   関連するエンティティのコレクションを返すナビゲーション プロパティは、<xref:System.Collections.Generic.ICollection%601> の新しいまたは既存のインスタンスに設定されます。ここで、`T` は関連エンティティの型です。  このコレクションは、関連オブジェクトが <xref:System.Data.Services.Client.DataServiceContext> に読み込まれていない限り空になります。  詳細については、「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。  
+  
+        > [!NOTE]
+        >  生成されたクライアント データ クラスでデータ バインディングがサポートされる場合、ナビゲーション プロパティは代わりに <xref:System.Data.Services.Client.DataServiceCollection%601> クラスのインスタンスを返します。  詳細については、「[コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)」を参照してください。  
+  
+4.  <xref:System.Data.Services.Client.DataServiceContext.ReadingEntity> イベントが発生します。  
+  
+5.  クライアント ライブラリは <xref:System.Data.Services.Client.DataServiceContext> にオブジェクトをアタッチします。  <xref:System.Data.Services.Client.MergeOption> が <xref:System.Data.Services.Client.MergeOption> の場合は、オブジェクトはアタッチされません。  
+  
+## 参照  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)   
+ [クエリ射影](../../../../docs/framework/data/wcf/query-projections-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/query-projections-wcf-data-services.md b/docs/framework/data/wcf/query-projections-wcf-data-services.md
new file mode 100644
index 00000000000..8c3ab5e7e68
--- /dev/null
+++ b/docs/framework/data/wcf/query-projections-wcf-data-services.md
@@ -0,0 +1,93 @@
+---
+title: "クエリ射影 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "射影 [WCF Data Services]"
+  - "クエリ射影 [WCF Data Services]"
+  - "WCF Data Services, 射影"
+  - "WCF Data Services, 照会"
+ms.assetid: a09f4985-9f0d-48c8-b183-83d67a3dfe5f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# クエリ射影 (WCF Data Services)
+射影は [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] の機能の 1 つであり、エンティティの特定のプロパティのみが応答で返されるように指定することで、クエリによって返されるフィードのデータの量を減らします。  詳細については、「[OData: Select システム クエリ オプション \($select\)](http://go.microsoft.com/fwlink/?LinkId=186076)」を参照してください。  
+  
+ このトピックでは、クエリ射影を定義する方法、エンティティ型、エンティティ型以外の要件、射影された結果に対する更新、射影された型の作成について説明すると共に、射影に関する注意事項をリストします。  
+  
+## クエリ射影の定義  
+ クエリに射影句を追加するには、URI で `$select` クエリ オプションを使用するか、LINQ クエリで [select](../Topic/select%20clause%20\(C%23%20Reference\).md) 句 \(Visual Basic の場合は [Select](../Topic/Select%20Clause%20\(Visual%20Basic\).md)\) を使用します。  返されたエンティティ データは、クライアント上のエンティティ型またはエンティティ型以外に射影できます。  このトピックでは、LINQ クエリで `select` 句を使用する例を取り上げます。  
+  
+> [!IMPORTANT]
+>  射影された型に対して行った更新を保存すると、データ サービスでデータの損失が発生する場合があります。  詳細については、「[射影時の注意事項](#considerations)」を参照してください。  
+  
+## エンティティ型およびエンティティ型以外の要件  
+ エンティティ型には、エンティティ キーを構成する 1 つ以上の Identity プロパティが必要です。  エンティティ型は、次のいずれかの方法によりクライアントで定義されます。  
+  
+-   <xref:System.Data.Services.Common.DataServiceKeyAttribute> または <xref:System.Data.Services.Common.DataServiceEntityAttribute> を型に適用する。  
+  
+-   型に `ID` という名前のプロパティがある場合。  
+  
+-   型に *type*`ID` という名前のプロパティがあり、*type* が型の名前である場合。  
+  
+ 既定では、クライアントで定義された型にクエリ結果を射影した場合、射影で要求されたプロパティがクライアント型に存在する必要があります。  ただし、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.IgnoreMissingProperties%2A> プロパテに `true` という値を指定した場合、射影で指定されたプロパティがクライアント型に含まれる必要はありません。  
+  
+### 射影された結果に対する更新  
+ クエリ結果をクライアント上のエンティティ型に射影する場合、<xref:System.Data.Services.Client.DataServiceContext> はそれらのオブジェクトを追跡し、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されるとデータ サービスに更新内容が送り返されます。  ただし、クライアント上のエンティティ型以外に射影されたデータの更新内容は、データ サービスに送り返すことはできません。  これは、エンティティ インスタンスを識別するキーがなければ、データ サービスはデータ ソース内の正しいエンティティを更新できないためです。  エンティティ型以外は <xref:System.Data.Services.Client.DataServiceContext> にはアタッチされません。  
+  
+ データ サービスで定義されたエンティティ型の 1 つ以上のプロパティが、エンティティの射影先のクライアント型に含まれない場合、新しいエンティティの挿入には、これらの欠損しているプロパティは含まれません。  この場合、欠損しているこれらのプロパティは既存のエンティティに対する更新にも含まれません。  そのようなプロパティに対する値が存在する場合、データ ソースの定義に従い、更新ではその値がそのプロパティの既定値としてリセットされます。  
+  
+### 射影型の作成  
+ 次の例では、`Customers` 型のアドレス関連のプロパティを、クライアントで定義されエンティティ型として属性化された新しい `CustomerAddress` 型に射影する匿名の LINQ クエリを使用します。  
+  
+ [!code-csharp[Astoria Northwind Client#SelectCustomerAddressSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#selectcustomeraddressspecific)]
+ [!code-vb[Astoria Northwind Client#SelectCustomerAddressSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#selectcustomeraddressspecific)]  
+  
+ この例では、コンストラクターを呼び出す代わりに、オブジェクト初期化子パターンを使用して `CustmerAddress` 型の新しいインスタンスを作成します。  コンストラクターは、エンティティ型への射影ではサポートされていませんが、エンティティ型以外および匿名型への射影では使用できます。  `CustomerAddress` は、エンティティ型であるため、変更を加えてデータ サービスに送り返すことができます。  
+  
+ さらに、`Customer` 型からのデータは、匿名型ではなく `CustomerAddress` エンティティ型のインスタンスに射影されます。  匿名型への射影はサポートされていますが、匿名型はエンティティ型以外として扱われるので、データは読み取り専用です。  
+  
+ <xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.MergeOption> 設定は、クエリ射影時の ID 解決に使用されます。  これは、`Customer` 型のインスタンスが <xref:System.Data.Services.Client.DataServiceContext> に存在する場合、同じ ID を持つ `CustomerAddress` のインスタンスは <xref:System.Data.Services.Client.MergeOption> で設定された ID 解決ルールに従うことを意味します。  
+  
+ 次の表では、結果をエンティティ型またはエンティティ型以外に射影する場合の動作について説明します。  
+  
+|動作|エンティティ型|エンティティ型以外|  
+|--------|-------------|---------------|  
+|初期化子を使用して新しい射影インスタンスを作成する。例:<br /><br /> [!code-csharp[Astoria Northwind Client#ProjectWithInitializer](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#projectwithinitializer)]
+ [!code-vb[Astoria Northwind Client#ProjectWithInitializer](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#projectwithinitializer)]|サポート状況|サポート状況|  
+|コンストラクターを使用して新しい射影インスタンスを作成する。例:<br /><br /> [!code-csharp[Astoria Northwind Client#ProjectWithConstructor](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#projectwithconstructor)]
+ [!code-vb[Astoria Northwind Client#ProjectWithConstructor](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#projectwithconstructor)]|<xref:System.NotSupportedException> 発生|サポート状況|  
+|射影を使用してプロパティ値を変換する。例:<br /><br /> [!code-csharp[Astoria Northwind Client#ProjectWithTransform](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#projectwithtransform)]
+ [!code-vb[Astoria Northwind Client#ProjectWithTransform](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#projectwithtransform)]<br /><br /> この変換は、エンティティ型では混乱の原因となり、別のエンティティに属するデータ ソース内のデータを上書きする可能性があるため、サポートされません。|<xref:System.NotSupportedException> 発生|サポート状況|  
+  
+<a name="considerations"></a>   
+## 射影時の注意事項  
+ クエリ射影を定義する場合は、次の点にも注意してください。  
+  
+-   Atom 形式のフィードを独自に定義する場合、カスタム マッピングが定義されているすべてのエンティティ プロパティが射影に含まれることを確認する必要があります。  マップされているエンティティ プロパティがこの射影に含まれていない場合、データの損失が発生することがあります。  詳細については、「[フィードのカスタマイズ](../../../../docs/framework/data/wcf/feed-customization-wcf-data-services.md)」を参照してください。  
+  
+-   データ サービスのデータ モデルのエンティティのすべてのプロパティを含まない射影型に挿入を行った場合、クライアントで射影に含まれていないプロパティは既定値に設定されます。  
+  
+-   データ サービスのデータ モデルのエンティティのすべてのプロパティを含まない射影影型に対して更新を行った場合、クライアントで射影に含まれていない既存の値は初期化されていない既定値で上書きされます。  
+  
+-   射影に複合プロパティが含まれる場合、複合オブジェクト全体が返される必要があります。  
+  
+-   射影にナビゲーション プロパティが含まれる場合、<xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドを呼び出す必要はなく、関連オブジェクトが暗黙的に読み込まれます。  射影されたクエリでの <xref:System.Data.Services.Client.DataServiceQuery%601.Expand%2A> メソッドの使用はサポートされません。  
+  
+-   クライアント上のクエリ射影クエリは、要求 URI の `$select` クエリ オプションを使用するように変換されます。  `$select` クエリ オプションをサポートしない、以前のバージョンの [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] に対して射影のあるクエリを実行すると、エラーが返されます。これは、データ サービスの <xref:System.Data.Services.DataServiceBehavior> の <xref:System.Data.Services.DataServiceBehavior.MaxProtocolVersion%2A> が <xref:System.Data.Services.Common.DataServiceProtocolVersion> という値に設定されている場合にも発生します。  詳細については、「[データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)」を参照してください。  
+  
+ 詳細については、「[方法: クエリ結果を射影する](../../../../docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md b/docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md
new file mode 100644
index 00000000000..b917ebc9407
--- /dev/null
+++ b/docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md
@@ -0,0 +1,150 @@
+---
+title: "データ サービスのクエリ (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, データへのアクセス"
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, 照会"
+ms.assetid: 823e9444-27aa-4f1f-be8e-0486d67f54c0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# データ サービスのクエリ (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用すると、言語統合クエリ \(LINQ\) を含め、使い慣れた [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] プログラミング パターンを使用してデータ サービスに対してクエリを実行できます。  このクライアント ライブラリは、クライアント上で <xref:System.Data.Services.Client.DataServiceQuery%601> クラスのインスタンスとして定義されたクエリを HTTP GET 要求メッセージに変換します。  さらに応答メッセージを受け取り、クライアント データ サービス クラスのインスタンスに変換します。  これらのクラスは、<xref:System.Data.Services.Client.DataServiceQuery%601> が属する <xref:System.Data.Services.Client.DataServiceContext> によって追跡されます。  
+  
+## データ サービス クエリ  
+ <xref:System.Data.Services.Client.DataServiceQuery%601> ジェネリック クラスは、0 個以上のエンティティ型インスタンスのコレクションを返すクエリを表します。  データ サービス クエリは、常に既存のデータ サービス コンテキストに属します。  このコンテキストにより、クエリの作成と実行に必要なサービス URI とメタデータ情報が維持されます。  
+  
+ **\[サービス参照の追加\]** ダイアログを使用してデータ サービスを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ベースのクライアント アプリケーションに追加すると、<xref:System.Data.Services.Client.DataServiceContext> クラスを継承するエンティティ コンテナー クラスが作成されます。  このクラスには、型指定された <xref:System.Data.Services.Client.DataServiceQuery%601> インスタンスを返すプロパティが含まれます。  データ サービスが公開するエンティティ セットごとに 1 つのプロパティがあります。  これらのプロパティを使用すると、型指定された <xref:System.Data.Services.Client.DataServiceQuery%601> のインスタンスを簡単に作成できます。  
+  
+ クエリは次のシナリオで実行されます。  
+  
+-   次のように結果が暗黙的に列挙される場合  
+  
+    -   `foreach` \(C\#\) ループや `For Each` \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]\) ループなどで、エンティティ セットを表す <xref:System.Data.Services.Client.DataServiceContext> のプロパティが列挙されているとき  
+  
+    -   `List` コレクションにクエリが割り当てられているとき  
+  
+-   <xref:System.Data.Services.Client.DataServiceQuery%601.Execute%2A> メソッドまたは <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッドが明示的に呼び出されたとき  
+  
+-   <xref:System.Linq.Enumerable.First%2A> や <xref:System.Linq.Enumerable.Single%2A> などの LINQ クエリ実行演算子が呼び出されたとき。  
+  
+ 次のクエリを実行すると、Northwind データ サービスのすべての `Customers` エンティティが返されます。  
+  
+ [!code-csharp[Astoria Northwind Client#GetAllCustomersSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getallcustomersspecific)]
+ [!code-vb[Astoria Northwind Client#GetAllCustomersSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getallcustomersspecific)]  
+  
+ 詳細については、「[方法: データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md)」を参照してください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントでは遅延バインディング オブジェクトに対するクエリがサポートされていますが \(C\# で*動的*型を使用する場合など\)、  パフォーマンス上の理由から、データ サービスに対しては常に厳密に型指定されたクエリを作成するようにしてください。  <xref:System.Tuple> 型と動的オブジェクトはクライアントでサポートされていません。  
+  
+## LINQ クエリ  
+ <xref:System.Data.Services.Client.DataServiceQuery%601> クラスは LINQ で定義された <xref:System.Linq.IQueryable%601> インターフェイスを実装するので、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリは、エンティティ セット データに対する LINQ クエリを、データ サービス リソースに対して評価されるクエリ式を表す URI に変換できます。  次の例は、前述の <xref:System.Data.Services.Client.DataServiceQuery%601> と同じ LINQ クエリです。ここでは、輸送費が 30 ドルを超える `Orders` を取得し、その結果を輸送費順に並べ替えます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddQueryOptionsLinqSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addqueryoptionslinqspecific)]
+ [!code-vb[Astoria Northwind Client#AddQueryOptionsLinqSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addqueryoptionslinqspecific)]  
+  
+ この LINQ クエリは、Northwind ベースの[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md) データ サービスに対して実行される次のクエリ URI に変換されます。  
+  
+```  
+http://localhost:12345/Northwind.svc/Orders?Orderby=ShippedDate&?filter=Freight gt 30  
+```  
+  
+> [!NOTE]
+>  LINQ 構文で表現できるクエリのセットは、データ サービスによって使用される REST \(Representational State Transfer\) ベースの URI 構文で有効なクエリのセットよりも範囲が広くなります。  クエリを対象データ サービスの URI にマップできない場合、<xref:System.NotSupportedException> が発生します。  
+  
+ 詳細については、「[LINQ に関する留意点](../../../../docs/framework/data/wcf/linq-considerations-wcf-data-services.md)」を参照してください。  
+  
+## クエリ オプションの追加  
+ データ サービス クエリは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で提供されるすべてのクエリ オプションをサポートしています。  <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを呼び出して、クエリ オプションを <xref:System.Data.Services.Client.DataServiceQuery%601> インスタンスに追加します。  <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> は、新しい <xref:System.Data.Services.Client.DataServiceQuery%601> インスタンスを返します。このインスタンスは元のクエリと同等ですが、新しいクエリ オプション セットを含みます。  次のクエリを実行すると、`Freight` 値でフィルターされ、`OrderID` によって降順に並べ替えられた `Orders` が返されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddQueryOptionsSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addqueryoptionsspecific)]
+ [!code-vb[Astoria Northwind Client#AddQueryOptionsSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addqueryoptionsspecific)]  
+  
+ `$orderby` クエリ オプションを使用すると、単一のプロパティに基づくクエリの並べ替えとフィルターの両方が可能です。次の例では、フィルターし、返された `Orders` オブジェクトを `Freight` プロパティの値に基づき並べ替えます。  
+  
+ [!code-csharp[Astoria Northwind Client#OrderWithFilter](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#orderwithfilter)]
+ [!code-vb[Astoria Northwind Client#OrderWithFilter](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#orderwithfilter)]  
+  
+ <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを連続して呼び出すと、複雑なクエリ式を作成できます。  詳細については、「[方法: データ サービス クエリにクエリ オプションを追加する](../../../../docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md)」を参照してください。  
+  
+ クエリ オプションを使用して、LINQ クエリの構文要素を表すことができます。  詳細については、「[LINQ に関する留意点](../../../../docs/framework/data/wcf/linq-considerations-wcf-data-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Data.Services.Client.DataServiceQuery%601.AddQueryOption%2A> メソッドを使用してクエリ URI に `$select` クエリ オプションを追加することはできません。  LINQ の <xref:System.Linq.Enumerable.Select%2A> メソッドを使用して、クライアントによって要求 URI に `$select` クエリ オプションが生成されるようにすることをお勧めします。  
+  
+<a name="executingQueries"></a>   
+## クライアントでの実行とサーバーでの実行  
+ クライアントによるクエリの実行は 2 つの部分に分かれています。  可能な限り、クエリ内の式は最初にクライアントで評価されます。その後、URI ベースのクエリが生成され、データ サービスに送信されて、サービス内のデータに対して評価されます。  次の LINQ クエリについて考えてみましょう。  
+  
+ [!code-csharp[Astoria Northwind Client#LinqQueryClientEvalSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#linqqueryclientevalspecific)]
+ [!code-vb[Astoria Northwind Client#LinqQueryClientEvalSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#linqqueryclientevalspecific)]  
+  
+ この例では、式 `(basePrice – (basePrice * discount))` はクライアントで評価されます。  そのため、データ サービスに送信される実際のクエリ URI \(`http://localhost:12345/northwind.svc/Products()?$filter=(UnitPrice gt 90.00M) and substringof('bike',ProductName)`\) のフィルター句に計算済みの 10 進値 `90` が含まれています。  部分文字列式を含むフィルター式のその他の部分は、データ サービスによって評価されます。  クライアントで評価される式は共通言語ランタイム \(CLR\) セマンティクスに従いますが、データ サービスに送信される式は [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのデータ サービスの実装に依存します。  また、このように別々に評価されることで予期しない結果が生じる場合があることにも注意する必要があります。たとえば、クライアントとサービスの両方で、異なるタイム ゾーンを使用して時間に基づく評価が実行される場合があります。  
+  
+## クエリ応答  
+ <xref:System.Data.Services.Client.DataServiceQuery%601> を実行すると、要求したエンティティ型の <xref:System.Collections.Generic.IEnumerable%601> が返されます。  このクエリ結果は、次の例のように <xref:System.Data.Services.Client.QueryOperationResponse%601> オブジェクトにキャストできます。  
+  
+ [!code-csharp[Astoria Northwind Client#GetResponseSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#getresponsespecific)]
+ [!code-vb[Astoria Northwind Client#GetResponseSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#getresponsespecific)]  
+  
+ データ サービスのエンティティを表すエンティティ型インスタンスは、オブジェクトの具体化というプロセスによってクライアントで作成されます。  詳細については、「[オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)」を参照してください。  <xref:System.Data.Services.Client.QueryOperationResponse%601> オブジェクトは、<xref:System.Collections.Generic.IEnumerable%601> を実装してクエリ結果へのアクセスを提供します。  
+  
+ さらに、<xref:System.Data.Services.Client.QueryOperationResponse%601> には、クエリ結果に関する追加情報へのアクセスを可能にする次のメンバーが含まれます。  
+  
+-   <xref:System.Data.Services.Client.OperationResponse.Error%2A> \- 発生すると、操作によってエラーがスローされます。  
+  
+-   <xref:System.Data.Services.Client.OperationResponse.Headers%2A> \- クエリ応答に関連する HTTP 応答ヘッダーのコレクションが含まれます。  
+  
+-   <xref:System.Data.Services.Client.QueryOperationResponse.Query%2A> \- <xref:System.Data.Services.Client.QueryOperationResponse%601> を生成した元の <xref:System.Data.Services.Client.DataServiceQuery%601> を取得します。  
+  
+-   <xref:System.Data.Services.Client.OperationResponse.StatusCode%2A> \- クエリ応答の HTTP 応答コードを取得します。  
+  
+-   <xref:System.Data.Services.Client.QueryOperationResponse%601.TotalCount%2A> \- <xref:System.Data.Services.Client.DataServiceQuery%601> で <xref:System.Data.Services.Client.DataServiceQuery%601.IncludeTotalCount%2A> メソッドが呼び出されるとエンティティ セット内のエンティティの合計数を取得します。  
+  
+-   <xref:System.Data.Services.Client.QueryOperationResponse.GetContinuation%2A> \- 結果の次のページの URI を含む <xref:System.Data.Services.Client.DataServiceQueryContinuation> オブジェクトを返します。  
+  
+ 既定では、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] はクエリ URI によって明示的に選択されたデータのみを返します。  これにより、必要に応じてデータ サービスから追加のデータを明示的に読み込むことができます。  データ サービスからデータを明示的に読み込むたびに要求がデータ サービスに送られます。  明示的に読み込むことができるデータには、関連エンティティ、ページングされた応答データ、バイナリ データ ストリームがあります。  
+  
+> [!NOTE]
+>  データ サービスはページングされた応答を返す場合があるので、アプリケーションではページングされたデータ サービス応答を処理するプログラミング パターンを使用することをお勧めします。  詳細については、「[遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)」を参照してください。  
+  
+ エンティティの特定のプロパティのみが応答で返されるように指定することにより、クエリによって返されるデータの量を削減することもできます。  詳細については、「[クエリ射影](../../../../docs/framework/data/wcf/query-projections-wcf-data-services.md)」を参照してください。  
+  
+## セット内のエンティティの合計数の取得  
+ 一部のシナリオでは、クエリによって返される数だけではなく、エンティティ セット内のエンティティの合計数を知っておくと役立ちます。  このセット内のエンティティの合計数がクエリ結果に含まれるように要求するには、<xref:System.Data.Services.Client.DataServiceQuery%601> で <xref:System.Data.Services.Client.DataServiceQuery%601.IncludeTotalCount%2A> メソッドを呼び出します。  この場合、返された <xref:System.Data.Services.Client.QueryOperationResponse%601> の <xref:System.Data.Services.Client.QueryOperationResponse%601.TotalCount%2A> プロパティが、セット内のエンティティの合計数を返します。  
+  
+ さらに、<xref:System.Linq.Enumerable.Count%2A> メソッドまたは <xref:System.Linq.Enumerable.LongCount%2A> メソッドを呼び出すことにより、それぞれ <xref:System.Int32> 値または <xref:System.Int64> 値として、セット内のエンティティの合計数のみを取得することもできます。  これらのメソッドを呼び出すと、<xref:System.Data.Services.Client.QueryOperationResponse%601> は返されず、カウント値のみが返されます。  詳細については、「[方法: クエリで返されたエンティティの数を確認する](../../../../docs/framework/data/wcf/number-of-entities-returned-by-a-query-wcf.md)」を参照してください。  
+  
+## このセクションの内容  
+ [クエリ射影](../../../../docs/framework/data/wcf/query-projections-wcf-data-services.md)  
+  
+ [オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)  
+  
+ [LINQ に関する留意点](../../../../docs/framework/data/wcf/linq-considerations-wcf-data-services.md)  
+  
+ [方法: データ サービス クエリを実行する](../../../../docs/framework/data/wcf/how-to-execute-data-service-queries-wcf-data-services.md)  
+  
+ [方法: データ サービス クエリにクエリ オプションを追加する](../../../../docs/framework/data/wcf/how-to-add-query-options-to-a-data-service-query-wcf-data-services.md)  
+  
+ [方法: クエリで返されたエンティティの数を確認する](../../../../docs/framework/data/wcf/number-of-entities-returned-by-a-query-wcf.md)  
+  
+ [方法: データ サービス要求のクライアント資格情報を指定する](../../../../docs/framework/data/wcf/specify-client-creds-for-a-data-service-request-wcf.md)  
+  
+ [方法: クライアント要求のヘッダーを設定する](../../../../docs/framework/data/wcf/how-to-set-headers-in-the-client-request-wcf-data-services.md)  
+  
+ [方法: クエリ結果を射影する](../../../../docs/framework/data/wcf/how-to-project-query-results-wcf-data-services.md)  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/quickstart-wcf-data-services.md b/docs/framework/data/wcf/quickstart-wcf-data-services.md
new file mode 100644
index 00000000000..68847c169af
--- /dev/null
+++ b/docs/framework/data/wcf/quickstart-wcf-data-services.md
@@ -0,0 +1,59 @@
+---
+title: "クイック スタート (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "WCF Data Services, クイックス タートの例"
+  - "WCF Data Services, エンティティ データ モデル (EDM) サービス"
+ms.assetid: 7b18ca1e-d4d6-4c7a-afb9-ce3cebb98a8d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# クイック スタート (WCF Data Services)
+このクイック スタートでは、「[概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)」のトピックをサポートする一連のタスクを通して [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] および [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] を学習できます。  
+  
+## 学習する内容  
+ このクイック スタートの最初のタスクでは、データ サービスを作成し、Northwind サンプル データベースの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開する方法を示します。 後半のトピックでは、Web ブラウザーを使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスします。また、クライアント ライブラリを使用して [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] フィードを使用する [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] クライアント アプリケーションを作成します。  
+  
+## 必須コンポーネント  
+ このクイック スタートを最後まで行うには、次のコンポーネントがインストールされている必要があります。  
+  
+-   [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)]。  
+  
+-   [!INCLUDE[msCoName](../../../../includes/msconame-md.md)] [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] のインスタンス。 これには、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の既定のインストールに含まれる SQL Server Express が含まれます。  
+  
+-   Northwind サンプル データベース。 このサンプル データベースをダウンロードするには、ダウンロード ページ「[SQL Server 用サンプル データベース](http://go.microsoft.com/fwlink/?linkid=24758)」を参照してください。  
+  
+## WCF Data Services クイックスタートのタスク  
+ [データ サービスの作成](../../../../docs/framework/data/wcf/creating-the-data-service.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの定義、データ モデルの定義、データ サービスの作成、およびリソースへのアクセスの有効化を行います。  
+  
+ [Web ブラウザーからサービスへのアクセス](../../../../docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)  
+ [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] からサービスを開始し、公開されているフィードに対して Web ブラウザーから HTTP GET 要求を送信してサービスにアクセスします。  
+  
+ [.NET Framework クライアント アプリケーションの作成](../../../../docs/framework/data/wcf/creating-the-dotnet-client-application-wcf-data-services-quickstart.md)  
+ [!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] クライアント アプリケーションを作成して、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードの使用、Windows コントロールへのデータのバインド、バインドされたコントロールのデータの変更、およびデータ サービスへの変更内容の送信を行います。  
+  
+> [!NOTE]
+>  クイック スタートを完了したプロジェクト ファイルは、「[WCF Data Services ドキュメントのサンプル](http://go.microsoft.com/fwlink/?LinkId=179994)」ページからダウンロードできます。  
+  
+## 次の手順  
+ [クイック スタートの開始](../../../../docs/framework/data/wcf/creating-the-data-service.md)  
+  
+## 参照  
+ [ADO.NET Entity Framework](../../../../docs/framework/data/adonet/ef/index.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/reflection-provider-wcf-data-services.md b/docs/framework/data/wcf/reflection-provider-wcf-data-services.md
new file mode 100644
index 00000000000..c82ae5e56cb
--- /dev/null
+++ b/docs/framework/data/wcf/reflection-provider-wcf-data-services.md
@@ -0,0 +1,105 @@
+---
+title: "リフレクション プロバイダー (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, プロバイダー"
+ms.assetid: ef5ba300-6d7c-455e-a7bd-d0cc6d211ad4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# リフレクション プロバイダー (WCF Data Services)
+Entity Framework を介してデータ モデルからデータを公開することに加えて、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、エンティティ ベースのモデルで厳密に定義されていないデータを公開することもできます。  リフレクション プロバイダーは、<xref:System.Linq.IQueryable%601> インターフェイスを実装する型を返すクラスのデータを公開します。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、リフレクションを使用して、これらのクラスのデータ モデルを推論し、リソースに対するアドレス ベースのクエリを、公開されている <xref:System.Linq.IQueryable%601> 型に対する統合言語クエリ \(LINQ\) ベースのクエリに変換します。  
+  
+> [!NOTE]
+>  <xref:System.Linq.Queryable.AsQueryable%2A> メソッドを使用して、<xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装する任意のクラスから <xref:System.Linq.IQueryable%601> インターフェイスを返すことができます。  これによって、ほとんどのジェネリック コレクション型をデータ サービスのデータ ソースとして使用することが可能になります。  
+  
+ リフレクション プロバイダーは、型の階層をサポートします。  詳細については、「[方法: リフレクション プロバイダーを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-rp-wcf-data-services.md)」を参照してください。  
+  
+## データ モデルの推論  
+ データ サービスを作成すると、プロバイダーはリフレクションを使用してデータ モデルを推論します。  リフレクション プロバイダーがデータ モデルを推論する方法を次の一覧に示します。  
+  
+-   エンティティ コンテナー – <xref:System.Linq.IQueryable%601> インターフェイスを返すプロパティとしてデータを公開するクラス。  リフレクション ベースのデータ モデルを作成すると、エンティティ コンテナーはサービスのルートを表します。  1 つの名前空間でサポートされるエンティティ コンテナー クラスは 1 つだけです。  
+  
+-   エンティティ セット \- <xref:System.Linq.IQueryable%601> インスタンスを返すプロパティはエンティティ セットとして処理されます。  エンティティ セットは、クエリでリソースとして直接アドレス指定されます。  エンティティ コンテナーの 1 つのプロパティが返すことができるのは、1 つの型の <xref:System.Linq.IQueryable%601> インスタンスだけです。  
+  
+-   エンティティ型 – エンティティ セットが返す <xref:System.Linq.IQueryable%601> の `T` 型。  継承階層の一部であるクラスは、リフレクション プロバイダーによって同等のエンティティ型階層に変換されます。  
+  
+-   エンティティ キー – エンティティ型である各データ クラスには 1 つのキー プロパティが必要です。  このプロパティは、<xref:System.Data.Services.Common.DataServiceKeyAttribute> 属性 \(`[DataServiceKeyAttribute]`\) で属性化されています。  
+  
+    > [!NOTE]
+    >  <xref:System.Data.Services.Common.DataServiceKeyAttribute> 属性は、エンティティ型のインスタンスを一意に識別するために使用できるプロパティのみに適用してください。  ナビゲーション プロパティに適用すると、この属性は無視されます。  
+  
+-   エンティティ型プロパティ – リフレクション プロバイダーは、エンティティ キー以外で、次に示すエンティティ型のクラスのアクセス可能な非インデクサー プロパティを処理します。  
+  
+    -   プロパティがプリミティブ型を返す場合、プロパティはエンティティ型のプロパティと見なされます。  
+  
+    -   プロパティがエンティティ型でもある型を返す場合、プロパティは、多対一または一対一のリレーションシップの "一" の側を表すナビゲーション プロパティと見なされます。  
+  
+    -   プロパティがエンティティ型の <xref:System.Collections.Generic.IEnumerable%601> を返す場合、プロパティは、一対多または多対多のリレーションシップの "多" の側を表すナビゲーション プロパティと見なされます。  
+  
+    -   プロパティの戻り値の型が値型である場合、プロパティは複合型を表します。  
+  
+> [!NOTE]
+>  エンティティ リレーショナル モデルに基づくデータ モデルとは異なり、リフレクション プロバイダーに基づくモデルではリレーショナル データは理解されません。  Entity Framework を使用して、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] 経由でリレーショナル データを公開する必要があります。  
+  
+## データ型のマッピング  
+ データ モデルが .NET Framework クラスから推論されると、次に示すようにデータ モデルのプリミティブ型が .NET Framework データ型にマップされます。  
+  
+|.NET Framework データ型|データ モデル型|  
+|-------------------------|--------------|  
+|<xref:System.Byte> `[]`|`Edm.Binary`|  
+|<xref:System.Boolean>|`Edm.Boolean`|  
+|<xref:System.Byte>|`Edm.Byte`|  
+|<xref:System.DateTime>|`Edm.DateTime`|  
+|<xref:System.Decimal>|`Edm.Decimal`|  
+|<xref:System.Double>|`Edm.Double`|  
+|<xref:System.Guid>|`Edm.Guid`|  
+|<xref:System.Int16>|`Edm.Int16`|  
+|<xref:System.Int32>|`Edm.Int32`|  
+|<xref:System.Int64>|`Edm.Int64`|  
+|<xref:System.SByte>|`Edm.SByte`|  
+|<xref:System.Single>|`Edm.Single`|  
+|<xref:System.String>|`Edm.String`|  
+  
+> [!NOTE]
+>  .NET Framework の NULL 許容値型は、対応する値型で NULL を指定できないものと同じデータ モデル型にマップされます。  
+  
+## データ モデルでの更新の有効化  
+ この種類のデータ モデルを介して公開されるデータを更新するために、リフレクション プロバイダーは、<xref:System.Data.Services.IUpdatable> インターフェイスを定義します。  このインターフェイスは、公開されている型への更新を保存する方法をデータ サービスに指示します。  データ モデルによって定義されているリソースへの更新を有効にするには、エンティティ コンテナー クラスは、<xref:System.Data.Services.IUpdatable> インターフェイスを実装する必要があります。  <xref:System.Data.Services.IUpdatable> インターフェイスの実装例については、「[方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md)」を参照してください。  
+  
+ リフレクション プロバイダーを使用してデータ ソースに更新を伝達するには、<xref:System.Data.Services.IUpdatable> インターフェイスに次のメンバーが実装されている必要があります。  
+  
+|メンバー|説明|  
+|----------|--------|  
+|<xref:System.Data.Services.IUpdatable.AddReferenceToCollection%2A>|ナビゲーション プロパティからアクセスされる関連オブジェクトのコレクションにオブジェクトを追加する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.ClearChanges%2A>|データに対する保留中の変更を取り消す機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.CreateResource%2A>|指定したコンテナーに新しいリソースを作成する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.DeleteResource%2A>|リソースを削除する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.GetResource%2A>|特定のクエリおよび型名によって識別されるリソースを取得する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.GetValue%2A>|リソースのプロパティの値を返す機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.RemoveReferenceFromCollection%2A>|ナビゲーション プロパティからアクセスされる関連オブジェクトのコレクションからオブジェクトを削除する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.ResetResource%2A>|指定したリソースを更新する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.ResolveResource%2A>|特定のオブジェクト インスタンスによって表されるリソースを返す機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.SaveChanges%2A>|すべての保留中の変更を保存する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.SetReference%2A>|ナビゲーション プロパティを使用して関連するオブジェクト参照を設定する機能を提供します。|  
+|<xref:System.Data.Services.IUpdatable.SetValue%2A>|リソースのプロパティの値を設定する機能を提供します。|  
+  
+## 同時実行の処理  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、エンティティの同時実行トークンを定義できるようにすることで、オプティミスティック同時実行制御モデルをサポートしています。  この同時実行トークンは、エンティティの 1 つ以上のプロパティが含まれており、要求、更新、または削除されているデータに対して行われた変更があるかどうかを判断するためにデータ サービスによって使用されます。  要求内の eTag から取得したトークンの値がエンティティの現在の値と異なる場合、データ サービスで例外が発生します。  リフレクション プロバイダーの同時実行トークンを定義するために <xref:System.Data.Services.ETagAttribute> がエンティティ型に適用されます。  同時実行トークンには、キー プロパティまたはナビゲーション プロパティを含めることはできません。  詳細については、「[データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+## リフレクション プロバイダーによる SQL への LINQ の使用  
+ 既定では Entity Framework がネイティブでサポートされるので、これが [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] でリレーショナル データを使用する場合の推奨データ プロバイダーです。  ただし、データ サービスで LINQ to SQL クラスを使用するには、リフレクション プロバイダーを使用できます。  LINQ to SQL Object Relational Designer \(O\/R Designer\) によって生成される <xref:System.Data.Linq.DataContext> のメソッドによって返される <xref:System.Data.Linq.Table%601> 結果セットは、<xref:System.Linq.IQueryable%601> インターフェイスを実装します。  そのため、リフレクション プロバイダーは、生成された LINQ to SQL クラスを使用して、これらのメソッドにアクセスし、SQL Server からエンティティ データを返すことができます。  ところが、LINQ to SQL は <xref:System.Data.Services.IUpdatable> インターフェイスを実装しないので、既存の <xref:System.Data.Linq.DataContext> 部分クラスを拡張する部分クラスを追加して、<xref:System.Data.Services.IUpdatable> 実装を追加する必要があります。  詳細については、「[方法: LINQ to SQL データ ソースを使用してデータ サービスを作成する](../../../../docs/framework/data/wcf/create-a-data-service-using-linq-to-sql-wcf.md)」を参照してください。  
+  
+## 参照  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/securing-wcf-data-services.md b/docs/framework/data/wcf/securing-wcf-data-services.md
new file mode 100644
index 00000000000..cf1e61c433b
--- /dev/null
+++ b/docs/framework/data/wcf/securing-wcf-data-services.md
@@ -0,0 +1,109 @@
+---
+title: "WCF Data Services のセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーションのセキュリティ保護 [WCF Data Services]"
+  - "WCF Data Services, セキュリティ"
+ms.assetid: 99fc2baa-a040-4549-bc4d-f683d60298af
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WCF Data Services のセキュリティ保護
+このトピックでは、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] と、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] をサポートするサービスにアクセスするアプリケーションの開発、配置、および実行に特有のセキュリティの注意点について説明します。  このほかに、安全な [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションを作成するための推奨事項にも従うようにしてください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] ベースの [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスをセキュリティで保護する方法を計画するときには、認証 \(プリンシパルの ID を発見および確認するプロセス\) と承認 \(認証されたプリンシパルが要求されたリソースにアクセスできるかどうかを判断するプロセス\) の両方を解決する必要があります。  また、SSL を使用してメッセージを暗号化するかどうかを検討する必要もあります。  
+  
+## クライアント要求の認証  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、認証を独自に実装する代わりにデータ サービス ホストに依存しています。  したがって、ネットワーク ホストによって受信要求が既に認証されていること、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] によって提供されるインターフェイスを使用して要求のプリンシパルが正しく識別されていることが前提とされます。  これらの認証オプションと方法の詳細については、「[OData と認証](http://go.microsoft.com/fwlink/?LinkId=200381)」の一連の記事を参照してください。  
+  
+### WCF Data Service の認証オプション  
+ 次の表に、WCF Data Service への要求を認証するために使用できる認証メカニズムを示します。  
+  
+|認証オプション|説明|  
+|-------------|--------|  
+|匿名認証|匿名 HTTP 認証が有効になっている場合は、すべてのプリンシパルがデータ サービスに接続できます。  匿名アクセスには資格情報は必要ありません。  このオプションは、だれでもデータ サービスにアクセスできるようにする場合にのみ使用します。|  
+|基本認証とダイジェスト認証|ユーザー名とパスワードで構成される資格情報が認証に必要です。  Windows 以外のクライアントの認証がサポートされます。 **Security Note:**  基本認証の資格情報 \(ユーザー名とパスワード\) はクリア テキストで送信されるので、傍受される可能性があります。  ダイジェスト認証では、指定された資格情報に基づくハッシュが送信されるため、基本認証に比べて安全です。  ただし、どちらの方法も man\-in\-the\-middle 攻撃を受ける可能性があります。  これらの認証方法を使用する場合は、SSL \(Secure Sockets Layer\) を使用してクライアントとデータ サービスの間の通信を暗号化することを検討してください。 <br /><br /> Microsoft インターネット インフォメーション サービス \(IIS\) には、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの HTTP 要求に対する基本認証とダイジェスト認証の実装が用意されています。  この Windows 認証プロバイダーの実装を使用すると、.NET Framework クライアント アプリケーションで、資格情報を要求の HTTP ヘッダーでデータ サービスに渡して Windows ユーザーの認証をシームレスにネゴシエートできます。  詳細については、「[ダイジェスト認証のテクニカル リファレンス](http://go.microsoft.com/fwlink/?LinkId=200408)」を参照してください。<br /><br /> データ サービスで Windows 資格情報以外のカスタム認証サービスに基づく基本認証を使用する場合は、認証用のカスタム [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] HTTP モジュールを実装する必要があります。<br /><br /> [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] でカスタム基本認証を使用する方法[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] と認証」の[カスタム基本認証](http://go.microsoft.com/fwlink/?LinkID=200388)についてのブログ記事を参照してください。|  
+|Windows 認証|Windows ベースの資格情報の交換には、NTLM または Kerberos が使用されます。  このメカニズムは基本認証やダイジェスト認証より安全ですが、クライアントが Windows ベースのアプリケーションである必要があります。  IIS には、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの HTTP 要求に対する Windows 認証の実装も用意されています。  詳細については、「[ASP.NET Forms Authentication Overview](../Topic/ASP.NET%20Forms%20Authentication%20Overview.md)」を参照してください。<br /><br /> [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で Windows 認証を使用する方法[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] と認証」の [Windows 認証](http://go.microsoft.com/fwlink/?LinkID=200384)についてのブログ記事を参照してください。|  
+|[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] フォーム認証|フォーム認証では、独自のコードを使用してユーザーを認証し、認証トークンをクッキーまたはページ URL に保存できます。  作成したログイン フォームを使用してユーザーのユーザー名とパスワードを認証します。  認証されない要求はログイン ページにリダイレクトされ、ここでユーザーが資格情報を入力してフォームを送信します。  アプリケーションで要求を認証する場合、後続の要求で使用する ID を再確立するためのキーが含まれたチケットをシステムが発行します。  詳細については、「[Forms Authentication Provider](../Topic/Forms%20Authentication%20Provider.md)」を参照してください。 **Security Note:**  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションでフォーム認証を使用する場合、既定では、フォーム認証チケットを含むクッキーはセキュリティで保護されません。  認証チケットと最初のログイン資格情報の両方を保護するには、SSL を要求することを検討してください。 <br /><br /> [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] でフォーム認証を使用する方法[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] と認証」の[フォーム認証](http://go.microsoft.com/fwlink/?LinkID=200389)についてのブログ記事を参照してください。|  
+|クレーム ベースの認証|クレーム ベースの認証では、データ サービスはユーザー認証を "サードパーティ" の信頼された ID プロバイダー サービスに依存します。  ID プロバイダーは、データ サービス リソースへのアクセスを要求しているユーザーを確実に認証し、要求されたリソースへのアクセスを許可するトークンを発行します。  このトークンがデータ サービスに提示され、そのアクセス トークンを発行した識別情報サービスとの信頼関係に基づいてユーザーのアクセスが許可されます。<br /><br /> クレーム ベースの認証プロバイダーの利点は、信頼ドメイン間でさまざまな種類のクライアントの認証に使用できることです。  このようなサードパーティ プロバイダーを使用することにより、ユーザーの管理と認証の要件をデータ サービスからオフロードできます。  OAuth 2.0 は、サービスとしてのフェデレーション認証のために Microsoft Azure AppFabric アクセス制御によってサポートされているクレーム ベースの認証プロトコルであり、  REST ベースのサービスをサポートします。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で OAuth 2.0 を使用する方法[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] と認証」の [OData と OAuth](http://go.microsoft.com/fwlink/?LinkId=200514) についてのブログ記事を参照してください。|  
+  
+<a name="clientAuthentication"></a>   
+### クライアント ライブラリの認証  
+ 既定では、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに要求を送信する際、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリから資格情報は提供されません。  データ サービスでユーザー認証のためにログイン資格情報が要求されている場合は、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.Credentials%2A> プロパティからアクセスできる <xref:System.Net.NetworkCredential> で資格情報を渡すことができます。以下に例を示します。  
+  
+  
+  
+ 詳細については、「[方法: データ サービス要求のクライアント資格情報を指定する](../../../../docs/framework/data/wcf/specify-client-creds-for-a-data-service-request-wcf.md)」を参照してください。  
+  
+ クレーム ベースのトークンやクッキーなど、<xref:System.Net.NetworkCredential> オブジェクトでは指定できないログイン資格情報がデータ サービスで要求されている場合は、手動で HTTP 要求のヘッダー \(通常は `Authorization` と `Cookie`\) を設定する必要があります。  このような認証シナリオの詳細については、ブログの記事「[OData と認証: クライアント側フック](http://go.microsoft.com/fwlink/?LinkID=200385)」を参照してください。  要求メッセージの HTTP ヘッダーを設定する方法の例については、「[方法: クライアント要求のヘッダーを設定する](../../../../docs/framework/data/wcf/how-to-set-headers-in-the-client-request-wcf-data-services.md)」を参照してください。  
+  
+## 偽装  
+ データ サービスは通常、データ サービスをホストしているワーカー プロセスの資格情報を使用して、要求されたリソース \(サーバー上のファイル、データベースなど\) にアクセスします。  偽装を使用しているときは、要求を出しているユーザーの Window ID \(ユーザー アカウント\) で [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションを実行できます。  偽装は、IIS を使用してユーザーを認証するアプリケーションで使用されるのが一般的です。この場合、要求されたリソースへのアクセスにそのプリンシパルの資格情報が使用されます。  詳細については、「[ASP.NET Impersonation](../Topic/ASP.NET%20Impersonation.md)」を参照してください。  
+  
+## データ サービスの承認の構成  
+ 承認とは、事前に行われた認証に基づいて識別されるプリンシパルまたはプロセスにアプリケーション リソースへのアクセスを許可することです。  一般に、データ サービスのユーザーには、クライアント アプリケーションで必要とされている操作を実行するのに十分な権限のみを与えるようにします。  
+  
+### データ サービス リソースへのアクセスの制限  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスにアクセスできるすべてのユーザーにデータ サービス リソース \(エンティティ セットおよびサービス操作\) に対する共通の読み取りおよび書き込みのアクセス権が既定で付与されます。  読み取りおよび書き込みのアクセスを定義する規則は、データ サービスによって公開される各エンティティ セットおよびサービス操作に対して個別に定義できます。  読み取りおよび書き込みの両方のアクセスを、クライアント アプリケーションで必要なリソースのみに制限することをお勧めします。  詳細については、「[最小限のリソース アクセス要件](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md#accessRequirements)」を参照してください。  
+  
+### ロール ベースのインターセプターの実装  
+ インターセプターを使用すると、データ サービス リソースに対する要求を、データ サービスによって処理される前にインターセプトすることができます。  詳細については、「[インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)」を参照してください。  インターセプターを使用すると、要求を行っている認証されたユーザーに基づいて承認決定を行うことができます。  認証されたユーザーの ID に基づいてデータ サービス リソースへのアクセスを制限する方法[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[方法: データ サービス メッセージを先に取得する](../../../../docs/framework/data/wcf/how-to-intercept-data-service-messages-wcf-data-services.md)」を参照してください。  
+  
+### 永続化データ ストアとローカル リソースへのアクセスの制限  
+ 永続化ストアにアクセスするためのアカウントには、データベースまたはファイル システムでデータ サービスの要件をサポートするのに十分な権限のみを与えるようにしてください。  匿名認証が使用されている場合は、そのアカウントがホスト アプリケーションの実行に使用されます。  詳細については、「[方法: IIS 上で実行する WCF Data Service を開発する](../../../../docs/framework/data/wcf/how-to-develop-a-wcf-data-service-running-on-iis.md)」を参照してください。  偽装を使用する場合は、認証されたユーザーにそれらのリソースへのアクセスを \(通常は Windows グループの一部として\) 許可する必要があります。  
+  
+## その他のセキュリティの考慮事項  
+  
+### ペイロードのデータの保護  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は HTTP プロトコルに基づいています。  データ サービスで実装されている認証によっては、HTTP メッセージのヘッダーに重要なユーザー資格情報が含まれている場合があります。  メッセージの本文にも、保護する必要がある貴重な顧客データが含まれている場合があります。  いずれの場合も、SSL を使用してその情報をネットワークで保護することをお勧めします。  
+  
+### 無視されるメッセージ ヘッダーとクッキー  
+ HTTP 要求のヘッダーは、コンテンツ タイプとリソースの場所を宣言するもの以外は無視されます。また、データ サービスによって設定されることはありません。  
+  
+ クッキーは、認証方式の一部としては使用できますが \([!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] フォーム認証を使用する場合など\)、  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では無視されます。  データ サービスのホストによって処理されることはありますが、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] ランタイムによって分析されたり返されたりすることはありません。  応答で送信されたクッキーが [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリで処理されることもありません。  
+  
+### カスタム ホストの要件  
+ 既定では、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は IIS でホストされる [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションとして作成されます。  そのため、データ サービスでこのプラットフォームのセキュリティ動作を活用できます。  カスタム ホストによってホストされる [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を定義することもできます。  詳細については、「[データ サービスのホスティング](../../../../docs/framework/data/wcf/hosting-the-data-service-wcf-data-services.md)」を参照してください。  データ サービスをホストするコンポーネントとプラットフォームでは、データ サービスへの攻撃を防ぐために次のセキュリティ動作を確保する必要があります。  
+  
+-   可能なすべての操作について、データ サービス要求で受け入れる URI の長さを制限します。  
+  
+-   着信および発信の両方の HTTP メッセージのサイズを制限します。  
+  
+-   任意の時点の未処理の要求の総数を制限します。  
+  
+-   HTTP ヘッダーとその値のサイズを制限し、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] でヘッダーのデータにアクセスできるようにします。  
+  
+-   TCP SYN 攻撃やメッセージ リプレイ攻撃などの既知の攻撃を検出して阻止します。  
+  
+### 値のさらなるエンコード  
+ データ サービスに送信されたプロパティ値が [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] ランタイムによってさらにエンコードされることはありません。  たとえば、書式設定された HTML コンテンツがエンティティの文字列プロパティに含まれていた場合、データ サービスによってタグが HTML エンコードされることはありません。  応答のプロパティ値についても、データ サービスによってさらなるエンコードが行われることはありません。  クライアント ライブラリで追加のエンコードが行われることもありません。  
+  
+### クライアント アプリケーションに関する注意点  
+ 以下のセキュリティの注意点は、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントを使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスにアクセスするアプリケーションに当てはまります。  
+  
+-   クライアント ライブラリは、データ サービスへのアクセスに使用されるプロトコルで十分なレベルのセキュリティが確保されていることを前提としています。  
+  
+-   クライアント ライブラリは、基になるプラットフォームによって提供されるトランスポート スタックのタイムアウトや解析のすべてのオプションに対して既定値を使用します。  
+  
+-   クライアント ライブラリはアプリケーション構成ファイルの設定を読み取りません。  
+  
+-   クライアント ライブラリにはドメイン間アクセスのメカニズムは実装されていません。  基になる HTTP スタックによって提供されるメカニズムが使用されます。  
+  
+-   クライアント ライブラリにはユーザー インターフェイス要素はありません。送受信されるデータの表示は行われません。  
+  
+-   クライアント アプリケーションで常にユーザー入力と信頼されていないサービスからのデータを検証することをお勧めします。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/service-operations-wcf-data-services.md b/docs/framework/data/wcf/service-operations-wcf-data-services.md
new file mode 100644
index 00000000000..79cd0fa5a5f
--- /dev/null
+++ b/docs/framework/data/wcf/service-operations-wcf-data-services.md
@@ -0,0 +1,118 @@
+---
+title: "サービス操作 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "サービス操作 [WCF Data Services]"
+  - "WCF Data Services, サービス操作"
+ms.assetid: 583a690a-e60f-4990-8991-d6efce069d76
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# サービス操作 (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、データ サービスでサービス操作を定義して、サーバーでメソッドを公開できます。  その他のデータ サービス リソースと同様に、サービス操作は URI によってアドレス指定できます。  サービス操作では、データ サービスでビジネス ロジックを公開できます \(検証ロジックの実装、ロール ベースのセキュリティの適用、特殊なクエリ機能の公開など\)。  サービス操作は、<xref:System.Data.Services.DataService%601> から派生したデータ サービス クラスに追加されたメソッドです。他のすべてのデータ サービス リソースのように、サービス操作メソッドにパラメーターを指定できます。たとえば、次のサービス操作 URIでは、[クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md) データ サービスに基づいて、`city` パラメーターに値 `London` を渡します。  
+  
+```  
+http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'  
+```  
+  
+ このサービス操作の定義を次に示します。  
+  
+ [!code-csharp[Astoria Northwind Service#ServiceOperationDef](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#serviceoperationdef)]
+ [!code-vb[Astoria Northwind Service#ServiceOperationDef](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#serviceoperationdef)]  
+  
+ <xref:System.Data.Services.DataService%601> の <xref:System.Data.Services.DataService%601.CurrentDataSource%2A> を使用して、データ サービスが使用するデータ ソースに直接アクセスできます。  詳細については、「[方法 : サービス操作を定義する](../../../../docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md)」を参照してください。  
+  
+ .NET Framework クライアント アプリケーションからサービス操作を呼び出す方法の詳細については、「[サービス操作の呼び出し](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md)」を参照してください。  
+  
+## サービス操作の要件  
+ データ サービスでサービス操作を定義する場合、次の要件が適用されます。  これらの要件を満たしていないメソッドは、データ サービスのサービス操作として公開されません。  
+  
+-   操作は、データ サービス クラスのメンバーであるパブリック インスタンス メソッドである必要があります。  
+  
+-   操作メソッドは入力パラメーターだけを受け取ることができます。  メッセージの本文内で送信されるデータは、データ サービスからアクセスできません。  
+  
+-   パラメーターを定義する場合、各パラメーターの型はプリミティブ型である必要があります。  非プリミティブ型のいずれかのデータもシリアル化され、文字列パラメーターに渡される必要があります。  
+  
+-   メソッドは次のいずれかを返す必要があります。  
+  
+    -   `void` \(Visual Basic の場合は `Nothing`\)。  
+  
+    -   <xref:System.Collections.Generic.IEnumerable%601>  
+  
+    -   <xref:System.Linq.IQueryable%601>  
+  
+    -   データ サービスが公開するデータ モデル内のエンティティ型。                  ``  
+  
+    -   プリミティブ クラス \(整数や文字列など\)。  
+  
+-   並べ替え、ページング、フィルター処理などのクエリ オプションをサポートするために、サービス操作メソッドから <xref:System.Linq.IQueryable%601> が返される必要があります。  クエリ オプションを含むサービス操作への要求は、<xref:System.Collections.Generic.IEnumerable%601> だけを返す操作で拒否されます。  
+  
+-   ナビゲーション プロパティを使用した関連エンティティへのアクセスをサポートするために、サービス操作は <xref:System.Linq.IQueryable%601> を返す必要があります。  
+  
+-   メソッドには、`[WebGet]` 属性または `[WebInvoke]` 属性を使用して注釈を付ける必要があります。  
+  
+    -   `[WebGet]` では、GET 要求を使用してメソッドを呼び出すことができます。  
+  
+    -   `[WebInvoke(Method = "POST")]` では、POST 要求を使用してメソッドを呼び出すことができます。  その他の <xref:System.ServiceModel.Web.WebInvokeAttribute> メソッドはサポートされていません。  
+  
+-   サービス操作には、<xref:System.Data.Services.SingleResultAttribute> を使用して注釈を付けることができます。この属性は、メソッドからの戻り値がエンティティのコレクションではなく 1 つのエンティティとなるように指定します。  この区別により、応答の結果のシリアル化、および追加のナビゲーション プロパティのトラバーサルを URI で表す方法が決定されます。  たとえば、AtomPub シリアル化を使用すると、1 種類のリソースのインスタンスがエントリ要素として表され、一連のインスタンスがフィード要素として表されます。  
+  
+## サービス操作のアドレス指定  
+ メソッドの名前を URI の最初のパス セグメントに配置することによってサービス操作のアドレスを指定できます。  たとえば、次の URI の場合、`Orders` オブジェクトの <xref:System.Linq.IQueryable%601> コレクションを返す `GetOrdersByState` 操作にアクセスします。  
+  
+```  
+http://localhost:12345/Northwind.svc/GetOrdersByState?state='CA'&includeItems=true  
+```  
+  
+ サービス操作を呼び出すときは、パラメーターはクエリのオプションとして指定されます。  前のサービス操作は、文字列パラメーター `state` と、関連する `Order_Detail` オブジェクトを応答に含めるかどうかを指定するブール値パラメーター `includeItems` の両方を受け入れます。  
+  
+ サービス操作の有効な戻り値の型を次に示します。  
+  
+|有効な戻り値の型|URI のルール|  
+|--------------|--------------|  
+|`void` \(Visual Basic の場合は `Nothing`\)。<br /><br /> または<br /><br /> エンティティ型<br /><br /> または<br /><br /> プリミティブ型|URI は、サービス操作の名前である 1 つのパス セグメントである必要があります。  クエリ オプションは許可されません。|  
+|<xref:System.Collections.Generic.IEnumerable%601>|URI は、サービス操作の名前である 1 つのパス セグメントである必要があります。  結果型は <xref:System.Linq.IQueryable%601> 型ではないので、クエリ オプションは使用できません。|  
+|<xref:System.Linq.IQueryable%601>|サービス操作の名前であるパスに追加したクエリ パス セグメント セグメントが許可されます。  クエリ オプションも許可されます。|  
+  
+ サービス操作の戻り値の型によっては、パス セグメントやクエリ オプションをさらに URI に追加できます。  たとえば、次の URI は、関連する `Order_Details` オブジェクトと一緒に `Orders` オブジェクトの <xref:System.Linq.IQueryable%601> コレクションを `RequiredDate` の降順で返す `GetOrdersByCity` 操作にアクセスします。  
+  
+```  
+http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$expand=Order_Details&$orderby=RequiredDate desc  
+  
+```  
+  
+## サービス操作のアクセス制御  
+ サービス操作のサービス全体の表示は、エンティティ セットの表示が <xref:System.Data.Services.IDataServiceConfiguration.SetEntitySetAccessRule%2A> メソッドを使用して制御されるのと同じような方法で、<xref:System.Data.Services.IDataServiceConfiguration> クラスの <xref:System.Data.Services.IDataServiceConfiguration.SetServiceOperationAccessRule%2A> メソッドによって制御されます。  たとえば、データ サービス定義内の次のコード行は、`CustomersByCity` サービス操作へのアクセスを有効にします。  
+  
+ [!code-csharp[Astoria Northwind Service#ServiceOperationConfig](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#serviceoperationconfig)]
+ [!code-vb[Astoria Northwind Service#ServiceOperationConfig](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#serviceoperationconfig)]  
+  
+> [!NOTE]
+>  元になるエンティティ セットの制限アクセスによって非表示にされている戻り値の型がサービス操作にある場合、サービス操作はクライアント アプリケーションで使用できません。  
+  
+ 詳細については、「[方法 : サービス操作を定義する](../../../../docs/framework/data/wcf/how-to-define-a-service-operation-wcf-data-services.md)」を参照してください。  
+  
+## 例外の発生  
+ データ サービスの実行で例外が発生するたびに、<xref:System.Data.Services.DataServiceException> クラスを使用することお勧めします。  これは、データ サービス ランタイムがこの例外のオブジェクトのプロパティを HTTP 応答メッセージに正しくマップする方法を認識しているためです。  サービス操作で <xref:System.Data.Services.DataServiceException> が発生する場合、返された例外は <xref:System.Reflection.TargetInvocationException> にラップされています。  <xref:System.Reflection.TargetInvocationException> をラップせずにベース <xref:System.Data.Services.DataServiceException> を返すには、<xref:System.Data.Services.DataService%601> の <xref:System.Data.Services.DataService%601.HandleException%2A> メソッドをオーバーライドし、<xref:System.Reflection.TargetInvocationException> から <xref:System.Data.Services.DataServiceException> を抽出して、トップ レベル エラーとして返す必要があります。次に例を示します。  
+  
+ [!code-csharp[Astoria Northwind Service#HandleExceptions](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind service/cs/northwind2.svc.cs#handleexceptions)]
+ [!code-vb[Astoria Northwind Service#HandleExceptions](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind service/vb/northwind2.svc.vb#handleexceptions)]  
+  
+## 参照  
+ [インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/specify-client-creds-for-a-data-service-request-wcf.md b/docs/framework/data/wcf/specify-client-creds-for-a-data-service-request-wcf.md
new file mode 100644
index 00000000000..bebc1fbc8f8
--- /dev/null
+++ b/docs/framework/data/wcf/specify-client-creds-for-a-data-service-request-wcf.md
@@ -0,0 +1,59 @@
+---
+title: "方法: データ サービス要求のクライアント資格情報を指定する (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 要求のカスタマイズ"
+ms.assetid: 1632f9af-e45f-4363-9222-03823daa8e28
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 方法: データ サービス要求のクライアント資格情報を指定する (WCF Data Services)
+既定では、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスに要求を送信する際、クライアント ライブラリから資格情報は提供されません。  ただし、<xref:System.Data.Services.Client.DataServiceContext> の <xref:System.Data.Services.Client.DataServiceContext.Credentials%2A> プロパティに <xref:System.Net.NetworkCredential> を設定することで、データ サービスへの要求を認証するために資格情報を送信するように指定できます。  詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。  このトピックの例では、データ サービスのデータを要求する際に [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアントで使用する資格情報を明示的に提供する方法を示します。  
+  
+ このトピックの例では、Northwind サンプル データ サービスおよび自動生成されたクライアント データ サービス クラスを使用します。  このサービスおよびクライアント データ クラスは、[WCF Data Services クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)を完了したときに作成されます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] Web サイトで公開されている [Northwind サンプル データ サービス](http://go.microsoft.com/fwlink/?LinkId=187426)を使用することもできます。このサンプル データ サービスは読み取り専用で、変更を保存しようとするとエラーが返されます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] Web サイトのサンプル データ サービスでは、匿名認証が許可されます。  
+  
+## 使用例  
+ 次の例は、Windows Presentation Framework アプリケーションのメイン ページである Extensible Application Markup Language \(XAML\) ファイルの分離コード ページからの抜粋です。  この例では、`LoginWindow` インスタンスを表示してユーザーから認証資格情報を収集し、データ サービスへの要求を行うときにこれらの資格情報を使用します。  
+  
+  
+  
+## 使用例  
+ 次の XAML は、WPF アプリケーションのメイン ページを定義します。  
+  
+  
+  
+## 使用例  
+ 次の例は、データ サービスへの要求を行う前にユーザーから認証資格情報を収集するために使用するウィンドウの分離コード ページからの抜粋です。  
+  
+  
+  
+## 使用例  
+ 次の XAML は、WPF アプリケーションのログインを定義します。  
+  
+  
+  
+## .NET Framework セキュリティ  
+ このトピックの例には、以下のセキュリティに関する注意点があります。  
+  
+-   このサンプルで指定した資格情報が機能することを確認するには、Northwind データ サービスで匿名アクセス以外の認証方式を使用する必要があります。  そうしない場合、データ サービスをホストする Web サイトが資格情報を要求しません。  
+  
+-   ユーザー資格情報は実行時にのみ要求し、キャッシュしないようにする必要があります。  資格情報は常に安全に格納する必要があります。  
+  
+-   基本認証およびダイジェスト認証で送信されるデータは暗号化されないため、敵対者がデータを見ることができます。  また、基本認証の資格情報 \(ユーザー名とパスワード\) はクリア テキストで送信されるので、傍受される可能性があります。  
+  
+ 詳細については、「[WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services のセキュリティ保護](../../../../docs/framework/data/wcf/securing-wcf-data-services.md)   
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/streaming-provider-wcf-data-services.md b/docs/framework/data/wcf/streaming-provider-wcf-data-services.md
new file mode 100644
index 00000000000..c274e5da8a2
--- /dev/null
+++ b/docs/framework/data/wcf/streaming-provider-wcf-data-services.md
@@ -0,0 +1,139 @@
+---
+title: "ストリーミング プロバイダー (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストリーミング データ プロバイダー (WCF Data Services)"
+  - "WCF Data Services, バイナリ データ"
+  - "WCF Data Services, プロバイダー"
+  - "WCF Data Services, ストリーム"
+ms.assetid: f0978fe4-5f9f-42aa-a5c2-df395d7c9495
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ストリーミング プロバイダー (WCF Data Services)
+データ サービスは、ラージ オブジェクトのバイナリ データを公開できます。  このバイナリ データは、ビデオ ストリームとオーディオ ストリーム、画像、ドキュメント ファイル、またはその他の種類のバイナリのメディアを表すことができます。  データ モデルのエンティティに 1 つ以上のバイナリ プロパティが含まれている場合、データ サービスは、このバイナリ データを応答フィードのエントリ内に Base\-64 としてエンコードして返します。  この方法で大きなバイナリ データを読み込んでシリアル化するとパフォーマンスに影響を及ぼす可能性があるため、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] では、属するエンティティとは独立してバイナリ データを取得するためのメカニズムが定義されています。  これは、バイナリ データとエンティティを分離して 1 つ以上のデータ ストリームを生成することで実現されます。  
+  
+-   メディア リソース \- エンティティに属するバイナリ データ \(ビデオ、オーディオ、画像、その他の種類のメディア リソース ストリームなど\)。  
+  
+-   メディア リンク エントリ \- 関連するメディア リソース ストリームへの参照を含むエンティティ。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、ストリーミング データ プロバイダーを実装してバイナリ リソース ストリームを定義します。  ストリーミング プロバイダーを実装すると、<xref:System.IO.Stream> オブジェクトとして特定のエンティティに関連付けられているメディア リソース ストリームがデータ サービスに提供されます。  この実装によって、データ サービスでは、指定された MIME の種類のバイナリ データ ストリームとしてメディア リソースを HTTP 経由で受け入れて、返すことができます。  
+  
+ バイナリ データのストリーミングをサポートするデータ サービスを構成するには、次の手順に従う必要があります。  
+  
+1.  データ モデル内の 1 つ以上のエンティティをメディア リンク エントリとして属性化します。  これらのエンティティには、ストリーミング対象のバイナリ データを含めないでください。  エンティティのバイナリ プロパティは、常に Base\-64 でエンコードされたバイナリとしてエントリで返されます。  
+  
+2.  T:System.Data.Services.Providers.IDataServiceStreamProvider インターフェイスを実装します。  
+  
+3.  <xref:System.IServiceProvider> インターフェイスを実装するデータ サービスを定義します。  データ サービスは、<xref:System.IServiceProvider.GetService%2A> の実装を使用してストリーミング データ プロバイダーの実装にアクセスします。  このメソッドは、適切なストリーミング プロバイダーの実装を返します。  
+  
+4.  Web アプリケーション構成で大きいメッセージ ストリームを有効にします。  
+  
+5.  サーバー上またはデータ ソース内のバイナリ リソースへのアクセスを有効にします。  
+  
+ このトピックの例はサンプルのストリーミング フォト サービスに基づいています。詳細については、ブログの記事「[Data Services ストリーミング プロバイダー シリーズ: ストリーミング プロバイダーの実装 \(パート 1\)](http://go.microsoft.com/fwlink/?LinkID=198989)」を参照してください。  このサンプル サービスのソース コードは、MSDN コード ギャラリーにある [Streaming Photo Data Service サンプルのページ](http://go.microsoft.com/fwlink/?LinkID=198988)から入手できます。  
+  
+## データ モデル内のメディア リンク エントリの定義  
+ エンティティがデータ モデル内のメディア リンク エントリとして定義される方法は、データ ソース プロバイダーによって決定されます。  
+  
+ **Entity Framework プロバイダー**  
+ エンティティがメディア リンク エントリであることを示すには、概念モデルのエンティティ型定義に `HasStream` 属性を追加します。次にその例を示します。  
+  
+ [!code-xml[Astoria Photo Streaming Service#HasStream](../../../../samples/snippets/xml/VS_Snippets_Misc/astoria photo streaming service/xml/photodata.edmx#hasstream)]  
+  
+ また、エンティティまたはデータ モデルを定義する .edmx ファイルまたは .csdl ファイルのルートに名前空間 `xmlns:m=http://schemas.microsoft.com/ado/2007/08/dataservices/metadata` を追加する必要があります。  
+  
+ [!INCLUDE[crexample](../../../../includes/crexample-md.md)] [!INCLUDE[adonet_ef](../../../../includes/adonet-ef-md.md)] プロバイダーを使用してメディア リソースを公開するデータ サービス 、ブログの記事「[Data Services ストリーミング プロバイダー シリーズ: ストリーミング プロバイダーの実装 \(パート 1\)](http://go.microsoft.com/fwlink/?LinkID=198989)」を参照してください。  
+  
+ **リフレクション プロバイダー**  
+ エンティティがメディア リンク エントリであることを示すには、リフレクション プロバイダーのエンティティ型を定義するクラスに <xref:System.Data.Services.Common.HasStreamAttribute> を追加します。  
+  
+ **カスタム データ サービス プロバイダー**  
+ カスタム サービス プロバイダーを使用する場合は、<xref:System.Data.Services.Providers.IDataServiceMetadataProvider> インターフェイスを実装してデータ サービスのメタデータを定義します。  詳細については、「[カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)」を参照してください。  エンティティ型 \(メディア リンク エントリ\) を表す <xref:System.Data.Services.Providers.ResourceType> で <xref:System.Data.Services.Providers.ResourceType.IsMediaLinkEntry%2A> プロパティを `true` に設定して、バイナリ リソース ストリームが <xref:System.Data.Services.Providers.ResourceType> に属することを示します。  
+  
+## IDataServiceStreamProvider インターフェイスの実装  
+ バイナリ データ ストリームをサポートするデータ サービスを作成するには、<xref:System.Data.Services.Providers.IDataServiceStreamProvider> インターフェイスを実装する必要があります。  これを実装すると、データ サービスはバイナリ データをストリームとしてクライアントに返し、クライアントから送信されたストリームとしてバイナリ データを使用できます。  データ サービスでは、バイナリ データへのストリームとしてのアクセスが必要になるたびに、このインターフェイスのインスタンスを作成します。  <xref:System.Data.Services.Providers.IDataServiceStreamProvider> インターフェイスでは次のメンバーを指定します。  
+  
+|メンバー名|説明|  
+|-----------|--------|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.DeleteStream%2A>|このメソッドはデータ サービスにより呼び出され、メディア リンク エントリが削除されたときに対応するメディア リソースを削除します。  <xref:System.Data.Services.Providers.IDataServiceStreamProvider> を実装する場合、このメソッドには、指定されたメディア リンク エントリに関連付けられたメディア リソースを削除するコードが含まれます。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetReadStream%2A>|このメソッドはデータ サービスにより呼び出され、メディア リソースをストリームとして返します。  <xref:System.Data.Services.Providers.IDataServiceStreamProvider> を実装する場合、このメソッドには、指定されたメディア リンク エントリに関連付けられたメディア リソースを返すためにデータ サービスが使用するストリームを提供するコードが含まれます。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetReadStreamUri%2A>|このメソッドはデータ サービスにより呼び出され、メディア リンク エントリのメディア リソースを要求するために使用される URI を返します。  この値を使用して、メディア リンク エントリのコンテンツ要素の `src` 属性が作成され、データ ストリームが要求されます。  このメソッドから `null` が返されると、データ サービスによって URI が自動的に決定されます。  このメソッドは、ストリーミング プロバイダーを使用しないバイナリ データへの直接アクセスをクライアントに提供する必要がある場合に使用します。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetStreamContentType%2A>|このメソッドはデータ サービスにより呼び出され、指定されたメディア リンク エントリに関連付けられたメディア リソースの Content\-Type 値を返します。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetStreamETag%2A>|このメソッドはデータ サービスにより呼び出され、指定されたエンティティに関連付けられたデータ ストリームの eTag を返します。  このメソッドは、バイナリ データの同時実行を管理する場合に使用されます。  このメソッドが null を返す場合、データ サービスでは同時実行が追跡されません。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A>|このメソッドはデータ サービスにより呼び出され、クライアントから送信されたストリームの受信時に使用されるストリームを取得します。  <xref:System.Data.Services.Providers.IDataServiceStreamProvider> を実装する場合、データ サービスが受信したストリーム データを書き込む先である書き込み可能なストリームを返す必要があります。|  
+|<xref:System.Data.Services.Providers.IDataServiceStreamProvider.ResolveType%2A>|名前空間で修飾された型名を返します。この型は、挿入されるメディア リソースのデータ ストリームに関連付けられたメディア リンク エントリに対してデータ サービス ランタイムが作成する必要がある型を表します。|  
+  
+## ストリーミング データ サービスの作成  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] ランタイムに <xref:System.Data.Services.Providers.IDataServiceStreamProvider> の実装へのアクセスを提供するには、作成するデータ サービスで <xref:System.IServiceProvider> インターフェイスも実装する必要があります。  次の例は、<xref:System.IServiceProvider.GetService%2A> メソッドを実装して、<xref:System.Data.Services.Providers.IDataServiceStreamProvider> を実装する `PhotoServiceStreamProvider` クラスのインスタンスを返す方法を示しています。  
+  
+ [!code-csharp[Astoria Photo Streaming Service#PhotoServiceStreamingProvider](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria photo streaming service/cs/photodata.svc.cs#photoservicestreamingprovider)]
+ [!code-vb[Astoria Photo Streaming Service#PhotoServiceStreamingProvider](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria photo streaming service/vb/photodata.svc.vb#photoservicestreamingprovider)]  
+  
+ データ サービスの作成方法に関する一般的な情報については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。  
+  
+## ホスト環境での大きなバイナリ ストリームの有効化  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションのデータ サービスを作成する場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して HTTP プロトコルが実装されます。既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では HTTP メッセージのサイズは 65K バイトのみに制限されます。  また、データ サービスに対する大きなバイナリ データのストリーミングを可能にするには、大きなバイナリ ファイルを有効にして、転送にストリームを使用するように Web アプリケーションを構成する必要もあります。  そのためには、アプリケーションの Web.config ファイルの `<configuration />` 要素に次の内容を追加します。  
+  
+  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.TransferMode?displayProperty=fullName> 転送モードを使用して、要求メッセージと応答メッセージの両方のバイナリ データをストリーミングし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってバッファリングされないようにする必要があります。  
+  
+ 詳細については、「[メッセージ転送ストリーミング](../../../../docs/framework/wcf/feature-details/streaming-message-transfer.md)」および「[トランスポート クォータ](../../../../docs/framework/wcf/feature-details/transport-quotas.md)」を参照してください。  
+  
+ また、既定では、インターネット インフォメーション サービス \(IIS\) でも要求のサイズが 4 MB に制限されます。  IIS 上で実行時にデータ サービスが 4 MB を超えるストリームを受信できるようにするには、次の例に示すように、`<system.web />` 構成セクション内の [httpRuntime 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/e9b81350-8aaf-47cc-9843-5f7d0c59f369) の `maxRequestLength` 属性を設定する必要があります。  
+  
+  
+  
+## クライアント アプリケーションでのデータ ストリームの使用  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用すると、クライアントのバイナリ ストリームとして公開されたリソースを取得および更新できます。  詳細については、「[バイナリ データの操作](../../../../docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md)」を参照してください。  
+  
+## ストリーミング プロバイダーの使用に関する考慮事項  
+ ストリーミング プロバイダーを実装する場合およびデータ サービスからメディア リソースにアクセスする場合には、次の点を考慮してください。  
+  
+-   MERGE 要求は、メディア リソースではサポートされません。  既存のエンティティのメディア リソースを変更するには、PUT 要求を使用します。  
+  
+-   POST 要求を使用して新しいメディア リンク エントリを作成することはできません。  代わりに、POST 要求を発行して新しいメディア リソースを作成する必要があります。データ サービスによって、既定値で新しいメディア リンク エントリが作成されます。  その後に MERGE 要求または PUT 要求を使用してこの新しいエンティティを更新できます。  プロパティ値を POST 要求の Slug ヘッダーの値に設定するなど、エンティティをキャッシュしてディスポーザーで更新を行うこともできます。  
+  
+-   POST 要求を受信すると、データ サービスは <xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A> を呼び出してメディア リソースを作成してから、<xref:System.Data.Services.IUpdatable.SaveChanges%2A> を呼び出してメディア リンク エントリを作成します。  
+  
+-   <xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A> を実装すると、<xref:System.IO.MemoryStream> オブジェクトは返されません。  この種類のストリームを使用すると、サービスが非常に大きなデータ ストリームを受信した場合に、メモリ リソースの問題が発生します。  
+  
+-   データベースにメディア リソースを格納する場合は、次の点を考慮してください。  
+  
+    -   メディア リソースであるバイナリ プロパティをデータ モデルに含めないようにしてください。  データ モデルで公開されるプロパティはすべて、応答フィードのエントリで返されます。  
+  
+    -   大きなバイナリ ストリームのパフォーマンスを向上させるには、カスタム ストリーム クラスを作成してバイナリ データをデータベースに格納することをお勧めします。  このクラスは、<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A> の実装によって返され、バイナリ データをチャンク単位でデータベースに送信します。  [!INCLUDE[ssNoVersion](../../../../includes/ssnoversion-md.md)] データベースでは、バイナリ データが 1 MB を超える場合、FILESTREAM を使用してデータをデータベースにストリーミングすることをお勧めします。  
+  
+    -   データ サービスによって受信される大きなバイナリ ストリームを格納できるようにデータベースが設計されていることを確認してください。  
+  
+    -   クライアントが POST 要求を送信して、1 回の要求でメディア リソースと共にメディア リンク エントリを挿入する場合は、データ サービスによって新しいエンティティがデータベースに挿入される前に、<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A> を呼び出してストリームを取得します。  ストリーミング プロバイダーは、このデータ サービスの動作を処理できるように実装する必要があります。  エンティティがデータベースに挿入されるまで、個別のデータ テーブルを使用してバイナリ データを格納するか、データ ストリームをファイルに格納することを検討してください。  
+  
+-   <xref:System.Data.Services.Providers.IDataServiceStreamProvider.DeleteStream%2A> メソッド、<xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetReadStream%2A> メソッド、または <xref:System.Data.Services.Providers.IDataServiceStreamProvider.GetWriteStream%2A> メソッドを実装する場合は、メソッドのパラメーターとして指定される eTag 値および Content\-Type 値を使用する必要があります。  <xref:System.Data.Services.Providers.IDataServiceStreamProvider> プロバイダーの実装には、eTag ヘッダーまたは Content\-Type ヘッダーを設定しないでください。  
+  
+-   既定では、クライアントはチャンクされた HTTP Transfer\-Encoding を使用して、大きなバイナリ ストリームを送信します。  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発サーバーはこの種類のエンコーディングをサポートしていないので、この Web サーバーを使用して大きなバイナリ ストリームを受け取る必要があるストリーミング データ サービスをホストすることはできません。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発サーバーの詳細については、「[Web Servers in Visual Studio for ASP.NET Web Projects](http://msdn.microsoft.com/ja-jp/31d4f588-df59-4b7e-b9ea-e1f2dd204328)」を参照してください。  
+  
+<a name="versioning"></a>   
+## バージョン管理の要件  
+ ストリーミング プロバイダーには、次に示す [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルのバージョン管理の要件があります。  
+  
+-   ストリーミング プロバイダーを使用するには、データ サービスでバージョン 2.0 以降の [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルがサポートされている必要があります。  
+  
+ 詳細については、「[データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [データ サービス プロバイダー](../../../../docs/framework/data/wcf/data-services-providers-wcf-data-services.md)   
+ [カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)   
+ [バイナリ データの操作](../../../../docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md b/docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md
new file mode 100644
index 00000000000..742a7dc366f
--- /dev/null
+++ b/docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md
@@ -0,0 +1,106 @@
+---
+title: "データ サービスの更新 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 変更 (データを)"
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: 00d993be-ffed-4dea-baf7-6eea982cdb54
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# データ サービスの更新 (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用して [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを操作する場合、フィード内のエントリがクライアント データ サービス クラスのインスタンスに変換されます。  これらのデータ サービス クラスは、<xref:System.Data.Services.Client.DataServiceQuery%601> が属する <xref:System.Data.Services.Client.DataServiceContext> を使用して追跡されます。クライアントでは、<xref:System.Data.Services.Client.DataServiceContext> にメソッドを使用して報告する、エンティティへの変更が追跡されます。  これらのメソッドを使用すると、クライアントは、追加および削除されたエンティティの追跡に加えて、プロパティ値に対して行われた変更やエンティティ インスタンス間のリレーションシップに対して行われた変更を追跡できます。  追跡されたこれらの変更は、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたときに、REST ベースの操作としてデータ サービスに送り返されます。  
+  
+> [!NOTE]
+>  <xref:System.Data.Services.Client.DataServiceCollection%601> のインスタンスを使用してデータをコントロールにバインドする場合、バインドされたコントロールのデータに対して行われた変更は <xref:System.Data.Services.Client.DataServiceContext> に自動的に報告されます。  詳細については、「[コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)」を参照してください。  
+  
+## エンティティの追加および変更  
+ Visual Studio の **\[サービス参照の追加\]** ダイアログを使用して [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードへの参照を追加した場合、結果のクライアント データ サービス クラスにはそれぞれ、静的な *Create* メソッドが作成されます。このメソッドは、null 非許容のエンティティ プロパティごとに 1 つのパラメーターを受け取ります。  このメソッドを使用すると、次の例に示すように、エンティティ型クラスのインスタンスを作成できます。  
+  
+ [!code-csharp[Astoria Northwind Client#CreateNewProduct](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#createnewproduct)]
+ [!code-vb[Astoria Northwind Client#CreateNewProduct](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#createnewproduct)]  
+  
+ エンティティ インスタンスを追加するには、次の例に示すように、**\[サービス参照の追加\]** ダイアログ ボックスによって生成された <xref:System.Data.Services.Client.DataServiceContext> クラスで適切な *AddTo* メソッドを呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#AddProductSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addproductspecific)]
+ [!code-vb[Astoria Northwind Client#AddProductSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addproductspecific)]  
+  
+ オブジェクトがコンテキストおよび正しいエンティティ セットに追加されます。  <xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> を呼び出すこともできますが、エンティティ セット名を指定する必要があります。  追加したエンティティにその他のエンティティへの 1 つ以上のリレーションシップがある場合は、<xref:System.Data.Services.Client.DataServiceContext.AddRelatedObject%2A> メソッドを使用するか、前のメソッドの 1 つを使用してこれらのリンクを明示的に定義することができます。  これらの操作の詳細については、このトピックの後半で説明します。  
+  
+ 既存のエンティティ インスタンスを変更するには、まずそのエンティティを照会し、このエンティティのプロパティに必要な変更を加えてから、オブジェクトの更新を送信する必要があることをクライアント ライブラリに示すために、次のように <xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> メソッドを呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#ModifyCustomerSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#modifycustomerspecific)]
+ [!code-vb[Astoria Northwind Client#ModifyCustomerSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#modifycustomerspecific)]  
+  
+ エンティティ インスタンスを削除するには、次の例に示すように、<xref:System.Data.Services.Client.DataServiceContext> で <xref:System.Data.Services.Client.DataServiceContext.DeleteObject%2A> メソッドを呼び出します。  
+  
+ [!code-csharp[Astoria Northwind Client#DeleteProductSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#deleteproductspecific)]
+ [!code-vb[Astoria Northwind Client#DeleteProductSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#deleteproductspecific)]  
+  
+ 詳細については、「[方法: エンティティを追加、変更、および削除する](../../../../docs/framework/data/wcf/how-to-add-modify-and-delete-entities-wcf-data-services.md)」を参照してください。  
+  
+## エンティティのアタッチ  
+ クライアント ライブラリでは、クエリを実行してエンティティを <xref:System.Data.Services.Client.DataServiceContext> に読み込むことなく、エンティティに対して行った変更を保存できます。  <xref:System.Data.Services.Client.DataServiceContext.AttachTo%2A> メソッドを使用して、既存のオブジェクトを <xref:System.Data.Services.Client.DataServiceContext> の特定のエンティティ セットにアタッチします。  その後、オブジェクトを変更して、変更内容をデータ サービスに保存できます。  次の例では、変更された顧客オブジェクトがコンテキストにアタッチされた後、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> が呼び出される前に、<xref:System.Data.Services.Client.DataServiceContext.UpdateObject%2A> が呼び出され、アタッチされたオブジェクトが <xref:System.Data.Services.Client.EntityStates> としてマークされます。  
+  
+ [!code-csharp[Astoria Northwind Client#AttachObjectSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#attachobjectspecific)]
+ [!code-vb[Astoria Northwind Client#AttachObjectSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#attachobjectspecific)]  
+  
+ オブジェクトをアタッチする際は、次の点に注意してください。  
+  
+-   オブジェクトは、<xref:System.Data.Services.Client.EntityStates> 状態でアタッチされます。  
+  
+-   オブジェクトがアタッチされるとき、アタッチされるオブジェクトに関連付けられたオブジェクトはアタッチされません。  
+  
+-   エンティティがコンテキストによって既に追跡されている場合は、オブジェクトをアタッチできません。  
+  
+-   eTag 値と一緒に受け取ったエンティティ オブジェクトをアタッチした場合は、<xref:System.Data.Services.Client.DataServiceContext.AttachTo%28System.String%2CSystem.Object%2CSystem.String%29> メソッドの、`etag` パラメーターを受け取るオーバーロードが使用されます。  この eTag 値は、アタッチされたオブジェクトへの変更を保存したときに、同時実行をチェックするために使用されます。  
+  
+ 詳細については、「[方法: 既存のエンティティを DataServiceContext にアタッチする](../../../../docs/framework/data/wcf/attach-an-existing-entity-to-dc-wcf-data.md)」を参照してください。  
+  
+## リレーションシップ リンクの作成および変更  
+ **\[サービス参照の追加\]** ダイアログで生成された <xref:System.Data.Services.Client.DataServiceContext> クラスの <xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> メソッド、または適切な *AddTo* メソッドを使用して新しいエンティティを追加する場合、新しいエンティティと関連付けられたエンティティの間のリレーションシップの自動定義は行われません。  
+  
+ エンティティ インスタンス間のリレーションシップを作成および変更し、クライアント ライブラリを使用して、これらの変更をデータ サービスに反映できます。  エンティティ間のリレーションシップは、モデル内の関連付けとして定義されています。また、<xref:System.Data.Services.Client.DataServiceContext> は、各リレーションシップをコンテキスト内のリンク オブジェクトとして追跡します。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、<xref:System.Data.Services.Client.DataServiceContext> クラスで、これらのリンクを作成、変更、および削除する以下のメソッドを提供します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Data.Services.Client.DataServiceContext.AddRelatedObject%2A>|関連付けられた 2 つのエンティティ オブジェクトの間に新しいリンクを作成します。  このメソッドを呼び出すことは、<xref:System.Data.Services.Client.DataServiceContext.AddObject%2A> と <xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> を呼び出して、新しいオブジェクトを作成すること、および既存のオブジェクトへのリレーションシップを定義することと同じです。|  
+|<xref:System.Data.Services.Client.DataServiceContext.AddLink%2A>|関連付けられた 2 つのエンティティ オブジェクトの間に新しいリンクを作成します。|  
+|<xref:System.Data.Services.Client.DataServiceContext.SetLink%2A>|関連付けられた 2 つのエンティティ オブジェクト間の既存のリンクを更新します。  また、<xref:System.Data.Services.Client.DataServiceContext.SetLink%2A> は、0 または 1 対 1 \(`0..1:1`\) および 1 対 1 \(`1:1`\) の基数を持つリンクの削除にも使用します。  これを行うには、関連付けられたオブジェクトを `null` に設定します。|  
+|<xref:System.Data.Services.Client.DataServiceContext.DeleteLink%2A>|<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドが呼び出されたときに、コンテキストが追跡するリンクに削除のマークを付けます。  このメソッドは、関連付けられたオブジェクトを削除する場合、または既存のオブジェクトへのリンクを削除した後に関連付けられた新しいオブジェクトへのリンクを追加してリレーションシップを変更する場合に使用します。|  
+|<xref:System.Data.Services.Client.DataServiceContext.AttachLink%2A>|2 つのエンティティ オブジェクトの間の既存のリンクのコンテキストを通知します。  コンテキストでは、このリレーションシップがデータ サービス内に既に存在するものと見なされるので、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> メソッドを呼び出してもリンクは作成されません。  このメソッドは、2 つのオブジェクトをコンテキストにアタッチして、オブジェクト間のリンクもアタッチする必要がある場合に使用します。  新しいリレーションシップを定義する場合は、<xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> を使用してください。|  
+|<xref:System.Data.Services.Client.DataServiceContext.DetachLink%2A>|コンテキストでの指定リンクの追跡を停止します。  このメソッドは、一対多 \(`*:*`\) のリレーションシップの削除に使用します。  基数が 1 のリレーションシップ リンクの場合は、<xref:System.Data.Services.Client.DataServiceContext.SetLink%2A> を代わりに使用する必要があります。|  
+  
+ 次の例は、<xref:System.Data.Services.Client.DataServiceContext.AddRelatedObject%2A> メソッドを使用して、既存の `Orders` エンティティに関連付けられた新しい `Order_Detail` を追加する方法を示します。  新しい `Order_Details` オブジェクトは <xref:System.Data.Services.Client.DataServiceContext> によって追跡されるので、既存の `Products` エンティティと追加された `Order_Details` オブジェクトのリレーションシップは、<xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> メソッドを呼び出すことによって定義されます。  
+  
+ [!code-csharp[Astoria Northwind Client#AddOrderDetailToOrderSpecific](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#addorderdetailtoorderspecific)]
+ [!code-vb[Astoria Northwind Client#AddOrderDetailToOrderSpecific](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#addorderdetailtoorderspecific)]  
+  
+ <xref:System.Data.Services.Client.DataServiceContext.AddLink%2A> メソッドは、データ サービス内に作成する必要のあるリンクを定義しますが、これらのリンクをコンテキスト内のオブジェクトに反映させるには、オブジェクト自身でナビゲーション プロパティを設定する必要があります。  前の例では、次のようにナビゲーション プロパティを設定します。  
+  
+ [!code-csharp[Astoria Northwind Client#SetNavProps](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria northwind client/cs/source.cs#setnavprops)]
+ [!code-vb[Astoria Northwind Client#SetNavProps](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria northwind client/vb/source.vb#setnavprops)]  
+  
+ 詳細については、「[方法: エンティティ リレーションシップを定義する](../../../../docs/framework/data/wcf/how-to-define-entity-relationships-wcf-data-services.md)」を参照してください。  
+  
+## 変更の保存  
+ 変更は、<xref:System.Data.Services.Client.DataServiceContext> インスタンスで追跡されますが、サーバーには直ちに送信されません。  指定されたアクティビティに対して必要な変更が完了した後、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> を呼び出して、すべての変更をデータ サービスに送信します。  詳細については、「[データ サービス コンテキストの管理](../../../../docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md)」を参照してください。  変更は、<xref:System.Data.Services.Client.DataServiceContext.BeginSaveChanges%2A> および <xref:System.Data.Services.Client.DataServiceContext.EndSaveChanges%2A> メソッドを使用して、非同期で保存することもできます。  詳細については、「[非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)」を参照してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)   
+ [非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)   
+ [バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)   
+ [オブジェクトの具体化](../../../../docs/framework/data/wcf/object-materialization-wcf-data-services.md)   
+ [データ サービス コンテキストの管理](../../../../docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md b/docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md
new file mode 100644
index 00000000000..37bd349d896
--- /dev/null
+++ b/docs/framework/data/wcf/using-a-data-service-in-a-client-application-wcf-data-services.md
@@ -0,0 +1,63 @@
+---
+title: "クライアント アプリケーションでのデータ サービスの使用 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, 概要"
+ms.assetid: 90872d0c-e989-4490-b3e9-54afb10d33d4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# クライアント アプリケーションでのデータ サービスの使用 (WCF Data Services)
+Web ブラウザーに URI を入力することで、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを公開するサービスにアクセスできます。  URI はリソースのアドレスを提供し、要求メッセージがこれらのアドレスに送信されてリソースが表す基になるデータのアクセスまたは変更を行います。  ブラウザーは HTTP GET コマンドを発行して、要求されたリソースを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして返します。  詳細については、「[Web ブラウザーからサービスへのアクセス](../../../../docs/framework/data/wcf/accessing-the-service-from-a-web-browser-wcf-data-services-quickstart.md)」を参照してください。  
+  
+ Web ブラウザーは [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスが予期されたデータを返すかどうかをテストするために便利ですが、データの作成、更新、および削除も行うことができる運用 [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスは、一般的にアプリケーション コードや Web ページのスクリプト言語を使用してアクセスします。  このトピックでは、クライアント アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにアクセスする方法の概要について説明します。  
+  
+## REST セマンティクスを使用したデータのアクセスおよび変更  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開するサービスと、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用するアプリケーションの間の相互運用性を保証するのに役立ちます。アプリケーションは、特定の HTTP アクションの要求メッセージ、およびアクションを実行するエンティティ リソースのアドレスを指定する URI を送信して、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービス内のデータのアクセスおよび変更を行います。  エンティティ データを指定する必要がある場合、メッセージの本文に、エンコードされたペイロードとして明示的に指定します。  
+  
+### HTTP アクション  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、アドレス指定されたリソースが表すエンティティ データに対する操作の作成、読み取り、更新、および削除を実行する次の HTTP アクションをサポートします。  
+  
+-   **HTTP GET** \- これは、ブラウザーからリソースにアクセスするときの既定のアクションです。  要求メッセージではペイロードは指定されず、要求されたデータを含むペイロードを含む応答メソッドが返されます。  
+  
+-   **HTTP POST** \- 新しいエンティティ データを指定されたリソースに挿入します。  挿入するデータは、要求メッセージのペイロードで指定されます。  応答メッセージのペイロードには、新しく作成されたエンティティのデータが含まれます。  これには自動生成されたキー値が含まれます。  ヘッダーには、新しいエンティティ リソースのアドレスを指定する URI も含まれます。  
+  
+-   **HTTP DELETE** \- 指定したリソースが表すエンティティ データを削除します。  ペイロードは要求メッセージおよび応答メッセージ内に存在しません。  
+  
+-   **HTTP PUT** \- 要求されたリソースの既存のエンティティ データを、要求メッセージのペイロードで指定された新しいデータで置き換えます。  
+  
+-   **HTTP MERGE** \- エンティティ データを変更するためだけに削除を実行した後にデータ ソースへの挿入を実行する非効率性を考慮して、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では新しい HTTP MERGE アクションが導入されています。  要求メッセージのペイロードには、アドレス指定されたエンティティ リソースで変更する必要のあるプロパティが含まれます。  HTTP MERGE は HTTP 仕様で定義されていないので、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 対応のサーバー以外で HTTP MERGE 要求をルーティングするには追加の処理が必要になる場合があります。  
+  
+ 詳細については、「[OData: 操作](http://go.microsoft.com/fwlink/?LinkId=185792)」を参照してください。  
+  
+### ペイロード形式  
+ HTTP PUT、HTTP POST、または HTTP MERGE 要求の場合、要求メッセージのペイロードは、データ サービスに送信するエンティティ データを含んでいます。  ペイロードのコンテンツは、メッセージのデータ形式によって異なります。  そのようなペイロードは、DELETE 以外のすべてのアクションに対する HTTP 応答にも含まれます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、サービスでのデータのアクセスおよび変更を行うために次のペイロード形式をサポートします。  
+  
+-   **Atom** \- Web フィード、ポッドキャスト、Wiki、および XML ベースのインターネット機能用に HTTP を介したデータ交換を有効にするために Atom 公開プロトコル \(AtomPub\) の拡張として [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] で定義されている XML ベースのメッセージ エンコーディング。  詳細については、「[OData: Atom 形式](http://go.microsoft.com/fwlink/?LinkId=185794)」を参照してください。  
+  
+-   **JSON** \- JSON \(JavaScript Object Notation\) は、JavaScript プログラミング言語のサブセットに基づく軽量のデータ交換形式です。  詳細については、「[OData: JSON 形式](http://go.microsoft.com/fwlink/?LinkId=185795)」を参照してください。  
+  
+ ペイロードのメッセージ形式は、HTTP 要求メッセージのヘッダーで要求されます。  詳細については、「[OData: 操作](http://go.microsoft.com/fwlink/?LinkID=185792)」を参照してください。  
+  
+## クライアント ライブラリを使用したデータのアクセスおよび変更  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、.NET Framework ベースのクライアント アプリケーションおよび Silverlight ベースのクライアント アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを簡単に使用できるクライアント ライブラリが含まれています。  これらのライブラリは、HTTP メッセージの送受信を簡略化します。  また、メッセージ ペイロードをエンティティ データを表す CLR オブジェクトに変換します。  クライアント ライブラリには、<xref:System.Data.Services.Client.DataServiceContext> および <xref:System.Data.Services.Client.DataServiceQuery%601> という 2 つのコア クラスがあります。  これらのクラスを使用すると、データ サービスをクエリして、返されるエンティティ データを CLR オブジェクトとして処理できます。  詳細については、「[WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)」および「[WCF Data Services \(Silverlight\)](http://msdn.microsoft.com/ja-jp/c0cd9f4b-1372-48e4-9935-c8421239da30)」を参照してください。  
+  
+ Visual Studio の **\[サービス参照の追加\]** ダイアログを使用して、参照をデータ サービスに追加できます。  このツールは、参照されたデータ サービスからサービス メタデータを要求し、データ サービスを表す <xref:System.Data.Services.Client.DataServiceContext> を生成します。また、エンティティを表すクライアント データ サービス クラスも生成します。  詳細については、「[データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)」を参照してください。  
+  
+ その他の種類のクライアント アプリケーションで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用するためのプログラミング ライブラリを利用できます。  詳細については、「[OData SDK](http://go.microsoft.com/fwlink/?LinkId=185796)」を参照してください。  
+  
+## 参照  
+ [データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)   
+ [クイック スタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/using-actions-to-implement-server-side-behavior.md b/docs/framework/data/wcf/using-actions-to-implement-server-side-behavior.md
new file mode 100644
index 00000000000..376cb6e3418
--- /dev/null
+++ b/docs/framework/data/wcf/using-actions-to-implement-server-side-behavior.md
@@ -0,0 +1,96 @@
+---
+title: "アクションを使用してサーバー側の動作を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11a372db-7168-498b-80d2-9419ff557ba5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# アクションを使用してサーバー側の動作を実装する
+OData アクションを使用すると、OData サービスから取得したリソースに対する動作を実装できます。  たとえば、リソースとしてデジタル ムービーについて考えてみましょう。デジタル ムービーについては、チェックアウト、評価やコメント、チェックインなど、多様な操作が考えられます。  これらはすべて、デジタル ムービーを管理するために WCF Data Services で実装できるアクションの例です。  アクションは、そのアクションを呼び出すことのできる対象のリソースが含まれている OData 応答に記述します。  ユーザーが、デジタル ムービーを表すリソースを要求した場合、WCF Data Services から返される応答には、そのリソースに使用できるアクションに関する情報が含まれています。  アクションを使用できるかどうかは、データ サービスまたはリソースの状態によって変わる場合があります。  たとえば、デジタル ムービーがチェックアウトされている場合、それを別のユーザーがチェックアウトすることはできません。  クライアントは、URL を指定するだけでアクションを呼び出すことができます。  たとえば、「http:\/\/MyServer\/MovieService.svc\/Movies\(6\)」と指定すると特定のデジタル ムービーが示され、「http:\/\/MyServer\/MovieService.svc\/Movies\(6\)\/Checkout」と指定すると特定のムービーに対するアクションが呼び出されます。  アクションを使用すると、データ モデルを公開することなくサービス モデルを公開することができます。  先ほどのムービー サービスを例とすると、評価データをリソースとして直接公開せずにムービーをユーザーが評価できるようにするというケースが考えられます。  そこで、たとえば Rate \(評価\) アクションを実装することにより、リソースとして評価データに直接アクセスせずに、ムービーをユーザーが評価できるようにすることができます。  
+  
+ WCF Data Services アクションの実装の完全な例については、[「Entity Framework 用 WCF Data Services アクション プロバイダー](http://efactionprovider.codeplex.com/)」を参照してください。  
+  
+## アクションの実装  
+ サービス アクションを実装するには、<xref:System.IServiceProvider> インターフェイス、<xref:System.Data.Services.Providers.IDataServiceActionProvider> インターフェイス、および <xref:System.Data.Services.Providers.IDataServiceInvokable> インターフェイスを実装する必要があります。  <xref:System.IServiceProvider> を使用すると WCF Data Services は、<xref:System.Data.Services.Providers.IDataServiceActionProvider> の実装を取得できます。  <xref:System.Data.Services.Providers.IDataServiceActionProvider> を使用すると WCF Data Services は、サービス アクションの作成、検出、記述、および呼び出しを行うことができます。  <xref:System.Data.Services.Providers.IDataServiceInvokable> を使用すると、サービス アクションの動作を実装して結果 \(ある場合\) を取得するコードを呼び出すことができます。  WCF Data Services は呼び出しごとの WCF サービスであり、サービスの新しいインスタンスは、サービスが呼び出されるごとに作成されます。  サービスの作成時に、不要な作業が行われないよう注意してください。  
+  
+### IServiceProvider  
+ <xref:System.IServiceProvider> には、<xref:System.IServiceProvider.GetService%2A> というメソッドが含まれています。  このメソッドは、メタデータ サービス プロバイダーやデータ サービス アクション プロバイダーなど、いくつかのサービス プロバイダーを取得するために、WCF Data Services によって呼び出されます。  データ サービス アクション プロバイダーを求められた場合は、<xref:System.Data.Services.Providers.IDataServiceActionProvider> 実装を返します。  
+  
+### IDataServiceActionProvider  
+ <xref:System.Data.Services.Providers.IDataServiceActionProvider> には、使用可能なアクションに関する情報を取得するためのメソッドが含まれています。  <xref:System.Data.Services.Providers.IDataServiceActionProvider> を実装すると、サービスの <xref:System.Data.Services.Providers.IDataServiceMetadataProvider> 実装で定義されるサービスのメタデータにアクションが追加され、必要に応じてアクションへのディスパッチが処理されます。  
+  
+#### AdvertiseServiceAction  
+ <xref:System.Data.Services.Providers.IDataServiceActionProvider.AdvertiseServiceAction%2A> は、指定されたリソースに対して使用できるアクションを判断するために呼び出されます。  このメソッドは、常時使用可能ではないアクションについてのみ呼び出されます。  このメソッドの用途は、要求されているリソースの状態またはサービスの状態に基づいて、アクションを OData 応答に含めるかどうかを確認することです。  この確認をどのように行うかは、開発者が指定する必要があります。  使用可能かどうかを計算する処理の負荷が高く、現在のリソースがフィード内にある場合は、確認をスキップしてアクションの情報提供を行うこともできます。  返される現在のリソースがフィードの一部である場合は、`inFeed` パラメーターが `true` に設定されます。  
+  
+#### CreateInvokable  
+ [M:System.Data.Services.Providers.IDataServiceActionProvider.CreateInvokable\(System.Data.Services.DataServiceOperationContext,System.Data.Services.Providers.ServiceAction,System.Object\<xref:System.Data.Services.Providers.IDataServiceActionProvider.CreateInvokable%2A> は、アクションの動作が実装されたコードをカプセル化するデリゲートが含まれた <xref:System.Data.Services.Providers.IDataServiceInvokable> を作成する場合に呼び出します。  これにより <xref:System.Data.Services.Providers.IDataServiceInvokable> インスタンスが作成されますが、アクションの呼び出しは行われません。  WCF Data Services のアクションは副作用を伴うため、更新プロバイダーと連携して、その変更をディスクに保存する必要があります。  <xref:System.Data.Services.Providers.IDataServiceInvokable.Invoke%2A> メソッドは、更新プロバイダーの SaveChanges\(\) メソッドが呼び出された後に呼び出されます。  
+  
+#### GetServiceActions  
+ このメソッドは、WCF Data Services が公開するすべてのアクションを表す <xref:System.Data.Services.Providers.ServiceAction> インスタンスのコレクションを返します。  <xref:System.Data.Services.Providers.ServiceAction> は、アクションのメタデータ表現であり、アクションの名前、パラメーター、戻り値の型などの情報を含んでいます。  
+  
+#### GetServiceActionsByBindingParameterType  
+ このメソッドは、指定されたバインディング パラメーターの種類にバインドできるすべての <xref:System.Data.Services.Providers.ServiceAction> インスタンスのコレクションを返します。  つまり、指定されたリソースの種類 \(バインディング パラメーターの種類\) を操作できるすべての <xref:System.Data.Services.Providers.ServiceAction> を表します。サービスがリソースを返すときに、そのリソースに対して呼び出すことのできるアクションの情報を含めるために使用します。  このメソッドが返すアクションは、\(派生型ではなく\) 指定どおりのバインディング パラメーターの種類にバインドできるアクションのみです。  このメソッドは、要求ごと、検出された種類ごとに 1 回呼び出され、結果は WCF Data Services によってキャッシュされます。  
+  
+#### TryResolveServiceAction  
+ このメソッドは、指定された <xref:System.Data.Services.Providers.ServiceAction> を検索し、<xref:System.Data.Services.Providers.ServiceAction> が見つかった場合は `true` を返します。  見つかった場合、`out` パラメーター `serviceAction` で <xref:System.Data.Services.Providers.ServiceAction> が返されます。  
+  
+### IDataServiceInvokable  
+ このインターフェイスは、WCF Data Services アクションの実行方法を提供します。  IDataServiceInvokable を実装する場合は、次の 3 つを行う必要があります。  
+  
+1.  パラメーターをキャプチャし、場合によってはマーシャリングを行う。  
+  
+2.  Invoke\(\) の呼び出し時に、アクションを実際に実装するコードにパラメーターをディスパッチする。  
+  
+3.  GetResult\(\) を使用して取得できるように、Invoke\(\) の結果を保存する。  
+  
+ パラメーターは、トークンとして渡すことができます。  これは、リソースを表すトークンを扱うデータ サービス プロバイダーを作成することができるためです。ただしその場合は、実際のアクションにディスパッチする前に、トークンを実際のリソースに変換 \(マーシャリング\) する必要があります。  アクションが呼び出されたときに発生したリソースへの変更を保存してディスクに書き込むことができるよう、マーシャリングを行ったパラメーターは編集可能な状態にしておく必要があります。  
+  
+ このインターフェイスには、Invoke および GetResult という 2 つのメソッドが必要です。  Invoke はアクションの動作を実装するデリゲートを呼び出し、GetResult はアクションの結果を返します。  
+  
+## WCF Data Services アクションの呼び出し  
+ アクションは HTTP POST 要求を使用して呼び出します。  リソースの後にアクション名を続けて URL を指定します。  パラメーターは、要求の本文を使用して渡します。  たとえば、MovieService というサービスがあり、Rate というアクションが公開されているとします。  この場合、特定のムービーに対して Rate アクションを呼び出すには、次のような URL 使用することができます。  
+  
+ http:\/\/MovieServer\/MovieService.svc\/Movies\(1\)\/Rate  
+  
+ Movies\(1\) は評価対象のムービーを示し、Rate は Rate アクションを指定しています。  次の例に示すように、評価の実際の値は HTTP 要求の本文に含まれます。  
+  
+```  
+POST http://MovieServer/MoviesService.svc/Movies(1)/Rate HTTP/1.1   
+Content-Type: application/json   
+Content-Length: 20   
+Host: localhost:15238  
+{   
+   "rating": 4   
+}  
+  
+```  
+  
+> [!WARNING]
+>  上のサンプル コードが動作するのは、JSON Light をサポートする WCF Data Services 5.2 以降を使用している場合のみです。  それより前のバージョンの WCF Data Services を使用している場合は、Verbose JSON の Content\-Type を「`application/json;odata=verbose`」のように指定する必要があります。  
+  
+ また、次のコード スニペットのように、WCF Data Services クライアントを使用してアクションを呼び出すこともできます。  
+  
+```  
+MoviesModel context = new MoviesModel (new Uri("http://MyServer/MoviesService.svc/"));  
+            //...  
+            context.Execute(new Uri("http://MyServer/MoviesService.svc/Movies(1)/Rate"), "POST", new BodyOperationParameter("rating",4) );           
+```  
+  
+ 上のコード スニペットの `MoviesModel` クラスは、Visual Studio の \[サービス参照の追加\] で WCF Data Services への参照を追加することでが生成されたものです。  
+  
+## 参照  
+ [WCF Data Services 4.5](../../../../docs/framework/data/wcf/index.md)   
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [WCF Data Services の開発と配置](../../../../docs/framework/data/wcf/developing-and-deploying-wcf-data-services.md)   
+ [カスタム データ サービス プロバイダー](../../../../docs/framework/data/wcf/custom-data-service-providers-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md b/docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md
new file mode 100644
index 00000000000..d3014764270
--- /dev/null
+++ b/docs/framework/data/wcf/wcf-data-service-client-utility-datasvcutil-exe.md
@@ -0,0 +1,57 @@
+---
+title: "WCF Data Service クライアント ユーティリティ (DataSvcUtil.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, クライアント ライブラリ"
+  - "WCF Data Services, 利用"
+  - "WCF Data Services, クライアント データ クラスの生成"
+ms.assetid: 9d0af606-929b-4c03-b307-3ef5f705afce
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF Data Service クライアント ユーティリティ (DataSvcUtil.exe)
+DataSvcUtil.exe は、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] に付属するコマンドライン ツールです。このツールは、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードを使用して、.NET Framework クライアント アプリケーションのデータ サービスにアクセスするために必要なクライアント データ サービス クラスを生成します。  このユーティリティでは、以下のメタデータ ソースを使用してデータ クラスを生成できます。  
+  
+-   データ サービスのルート URI。  ユーティリティは、データ サービスによって公開されるデータ モデルが記述されたサービス メタデータ ドキュメントを要求します。  詳細については、[OData: サービス メタデータ ドキュメント](http://go.microsoft.com/fwlink/?LinkId=186070)」を参照してください。  
+  
+-   [\[MC\-CSDL\]: 概念スキーマ定義ファイル形式](http://go.microsoft.com/fwlink/?LinkID=159072)の仕様で定義されているように、概念スキーマ定義言語 \(CSDL\) を使用して定義されるデータ モデル ファイル \(.csdl\)。  
+  
+-   Entity Framework に付属する Entity Data Model ツールを使用して作成された .edmx ファイル。  詳細については、「[\[MC\-EDMX\]: データ サービスのパッケージ形式のエンティティ データ モデル](http://go.microsoft.com/fwlink/?LinkID=178833)」の仕様を参照してください。  
+  
+ 詳細については、「[方法: クライアント データ サービス クラスを手動で生成する](../../../../docs/framework/data/wcf/how-to-manually-generate-client-data-service-classes-wcf-data-services.md)」を参照してください。  
+  
+ DataSvcUtil.exe ツールは [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ディレクトリにインストールされます。  多くの場合、C:\\Windows\\Microsoft.NET\\Framework\\v4.0 にあります。  64 ビット システムの場合は、C:\\Windows\\Microsoft.NET\\Framework64\\v4.0 にあります。  Visual Studio のコマンド プロンプトから DataSvcUtil.exe ツールにアクセスすることもできます \(**\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[Microsoft Visual Studio 2010\]**、**\[Visual Studio ツール\]** の順にポイントして、**\[Visual Studio 2010 コマンド プロンプト\]** をクリックします\)。  
+  
+## 構文  
+  
+```  
+datasvcutil /out:file [/in:file | /uri:serviceuri] [/dataservicecollection] [/language:devlang] [/nologo] [/version:ver] [/help]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/dataservicecollection`|オブジェクトをコントロールにバインドするために必要なコードも生成することを指定します。|  
+|`/help`<br /><br /> または<br /><br /> `/?`|このツールのコマンド構文とオプションを表示します。|  
+|`/in:` *\<file\>*|.csdl ファイルまたは .edmx ファイル、またはファイルがあるディレクトリを指定します。|  
+|`/language:`\[VB&#124;CSharp\]|生成されるソース コード ファイルの言語を指定します。  既定の言語は C\# です。|  
+|`/nologo`|著作権メッセージが表示されないようにします。|  
+|`/out:` *\<file\>*|生成されたクライアント データ サービス クラスを含むソース コード ファイルの名前を指定します。|  
+|`/uri:` *\<string\>*|[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードの URI。|  
+|`/version:`\[1.0&#124;2.0\]|許容される [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] の最上位バージョンを指定します。  バージョンは、返されるデータ サービス メタデータに含まれる DataService 要素の `DataServiceVersion` 属性に基づいて決定されます。  詳細については、「[データ サービスのバージョン管理](../../../../docs/framework/data/wcf/data-service-versioning-wcf-data-services.md)」を参照してください。  `/dataservicecollection` パラメーターを指定する場合は、`/version:2.0` も指定してデータ バインディングを有効にする必要があります。|  
+  
+## 参照  
+ [データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)   
+ [方法: データ サービス参照を追加する](../../../../docs/framework/data/wcf/how-to-add-a-data-service-reference-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/wcf-data-services-client-library.md b/docs/framework/data/wcf/wcf-data-services-client-library.md
new file mode 100644
index 00000000000..5e598098eeb
--- /dev/null
+++ b/docs/framework/data/wcf/wcf-data-services-client-library.md
@@ -0,0 +1,68 @@
+---
+title: "WCF Data Services クライアント ライブラリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "DataServiceContext クラス, DataServiceContext クラスについて"
+  - "DataServiceQuery クラス, DataServiceQuery クラスについて"
+  - "WCF Data Services, クライアント ライブラリ"
+ms.assetid: 21075e50-8917-413e-a8ea-35a0f6e65aa5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF Data Services クライアント ライブラリ
+HTTP 要求を送信し、データ サービスが返す [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィールドを処理できるアプリケーションは [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] ベースのデータ サービスと対話できます。この相互運用性によって、広範な Web 対応アプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのサービスにアクセスすることが可能になります。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、.NET Framework ベースのアプリケーションまたは Silverlight ベースのアプリケーションから [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する際のプログラミング エクスペリエンスを向上させるクライアント ライブラリが含まれています。  
+  
+ クライアント ライブラリの 2 つの主要なクラスは、<xref:System.Data.Services.Client.DataServiceContext> クラスと <xref:System.Data.Services.Client.DataServiceQuery%601> クラスです。  <xref:System.Data.Services.Client.DataServiceContext> クラスは、特定のデータ サービスに対してサポートされている操作をカプセル化します。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスはステートレスですが、コンテキストはステートレスではありません。  このため <xref:System.Data.Services.Client.DataServiceContext> クラスを使用すると、変更管理などの機能をサポートするためにデータ サービスとの対話操作間におけるクライアントの状態を保持できます。  このクラスは、ID の管理と変更の追跡も行います。  <xref:System.Data.Services.Client.DataServiceQuery%601> クラスは、特定のエンティティ セットに対するクエリを表します。  
+  
+ このセクションでは、クライアント ライブラリを使用して .NET Framework クライアント アプリケーションからデータにアクセスしてデータを変更する方法について説明します。  Silverlight ベースのアプリケーションによる [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリの使用方法の詳細については、「[WCF Data Services \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkId=186016)」を参照してください。  その他の種類のアプリケーションで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用する場合は、それぞれに対応したクライアント ライブラリが用意されています。  詳細については、「[OData SDK](http://go.microsoft.com/fwlink/?LinkID=185796)」を参照してください。  
+  
+## このセクションの内容  
+ [データ サービス クライアント ライブラリの生成](../../../../docs/framework/data/wcf/generating-the-data-service-client-library-wcf-data-services.md)  
+ クライアント ライブラリ、および [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードに基づくクライアント データ サービス クラスを生成する方法について説明します。  
+  
+ [データ サービスのクエリ](../../../../docs/framework/data/wcf/querying-the-data-service-wcf-data-services.md)  
+ クライアント ライブラリを使用して .NET Framework ベースのアプリケーションからデータ サービスを照会する方法について説明します。  
+  
+ [遅延コンテンツの読み込み](../../../../docs/framework/data/wcf/loading-deferred-content-wcf-data-services.md)  
+ 最初のクエリ応答に含まれない追加のコンテンツを読み込む方法について説明します。  
+  
+ [データ サービスの更新](../../../../docs/framework/data/wcf/updating-the-data-service-wcf-data-services.md)  
+ クライアント ライブラリを使用してエンティティおよびリレーションシップを作成、変更、および削除する方法について説明します。  
+  
+ [非同期操作](../../../../docs/framework/data/wcf/asynchronous-operations-wcf-data-services.md)  
+ 非同期でデータ サービスを操作するためにクライアント ライブラリで提供される機能について説明します。  
+  
+ [バッチ処理](../../../../docs/framework/data/wcf/batching-operations-wcf-data-services.md)  
+ クライアント ライブラリを使用して複数の要求を 1 つのバッチでデータ サービスに送信する方法について説明します。  
+  
+ [コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)  
+ コントロールをデータ サービスによって返される [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードにバインドする方法について説明します。  
+  
+ [サービス操作の呼び出し](../../../../docs/framework/data/wcf/calling-service-operations-wcf-data-services.md)  
+ クライアント ライブラリを使用してサービス操作を呼び出す方法について説明します。  
+  
+ [データ サービス コンテキストの管理](../../../../docs/framework/data/wcf/managing-the-data-service-context-wcf-data-services.md)  
+ クライアント ライブラリの動作を管理するオプションについて説明します。  
+  
+ [バイナリ データの操作](../../../../docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md)  
+ データ サービスによってデータ ストリームとして返されるバイナリ データにアクセスしてバイナリ データを変更する方法について説明します。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/wcf-data-services-overview.md b/docs/framework/data/wcf/wcf-data-services-overview.md
new file mode 100644
index 00000000000..d716042318b
--- /dev/null
+++ b/docs/framework/data/wcf/wcf-data-services-overview.md
@@ -0,0 +1,76 @@
+---
+title: "WCF Data Services の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "HTML"
+  - "VB"
+  - "CSharp"
+  - "C++"
+helpviewer_keywords: 
+  - "WCF Data Services"
+  - "WCF Data Services, 説明"
+ms.assetid: 7924cf94-c9a6-4015-afc9-f5d22b1743bb
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# WCF Data Services の概要
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] を使用して、Web またはイントラネット用のデータ サービスを作成し、それらを使用することができます。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を使用すると、URI でアドレス指定できるリソースとしてデータを公開できます。  したがって、Representational State Transfer \(REST\) のセマンティクス \(標準的な HTTP 動詞 GET、PUT、POST、DELETE\) を使用してデータにアクセスし、そのデータを変更できます。このトピックでは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] で定義されるパターンとプラクティスの両方の概要について説明します。また、.NET Framework ベースのアプリケーションで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] を利用するために [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で提供される機能についても説明します。  
+  
+## リソースとしてのデータのアドレス指定  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、URI でアドレス指定できるリソースとしてデータを公開します。リソース パスは、Entity Data Model のエンティティとリレーションシップの規則に基づいて構築されます。  このモデルでは、エンティティはアプリケーション ドメイン内のデータの操作単位を表します \(顧客、注文、項目、製品など\)。  詳細については、「[Entity Data Model](../../../../docs/framework/data/adonet/entity-data-model.md)」を参照してください。  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では、エンティティ型のインスタンスを含むエンティティ セットとしてエンティティ リソースのアドレスを指定します。  たとえば、`http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders` という URI を指定すると、`Northwind` データ サービスにアクセスして、`CustomerID` 値が `ALFKI` である顧客のすべての注文を取得できます。  
+  
+ クエリ式を使用して、リソースに対して従来のクエリ操作 \(フィルターの適用、並べ替え、ページングなど\) を実行できます。  たとえば、`http://services.odata.org/Northwind/Northwind.svc/Customers('ALFKI')/Orders?$filter=Freight gt 50` という URI は、リソースをフィルターして、$50 以上の運賃の注文だけを返します。  詳細については、「[データ サービス リソースへのアクセス](../../../../docs/framework/data/wcf/accessing-data-service-resources-wcf-data-services.md)」を参照してください。  
+  
+## 相互運用可能なデータ アクセス  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] では標準的なインターネット プロトコルに基づいてデータ サービスを作成するので、.NET Framework 対応でないアプリケーションとも相互運用が可能です。  標準的な URI を使用してデータのアドレスを指定できるので、アプリケーションは Representational State Transfer \(REST\) のセマンティクス \(特に GET、PUT、POST、および DELETE の HTTP 動詞\) を使用してデータにアクセスして変更できます。  そのため、標準的な HTTP プロトコルを介して転送されるデータの解析、およびこれらのデータへのアクセスを行うことができる任意のクライアントからこれらのサービスにアクセスできます。  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は Atom 公開プロトコル \(AtomPub\) に対する一連の拡張を定義しています。さまざまなクライアント アプリケーションおよびプラットフォームに対応するために、複数のデータ形式による HTTP 要求と応答をサポートしています。  [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードは、Atom、JavaScript Object Notation \(JSON\)、および通常の XML でデータを表現できます。  Atom が既定の形式ですが、フィードの形式は HTTP 要求のヘッダーで指定されます。  詳細については、「[OData: Atom 形式](http://go.microsoft.com/fwlink/?LinkID=185794)」および「[OData: JSON 形式](http://go.microsoft.com/fwlink/?LinkID=185795)」を参照してください。  
+  
+ データを [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードとして公開する場合、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] はその他の既存のインターネット機能をキャッシュや認証などの操作で使用します。  これを可能にするために、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は ASP.NET、Windows Communication Foundation \(WCF\)、インターネット インフォメーション サービス \(IIS\) などの既存のホスト アプリケーションおよびサービスと統合されています。  
+  
+## ストレージの独立性  
+ リソースはエンティティ リレーションシップ モデルに基づいてアドレス指定されますが、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、基になるデータ ソースとは関係なく [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開します。URI で指定されたリソースへの HTTP 要求を [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] が受け取ると、その要求は逆シリアル化され、その要求の表現が [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] プロバイダーに渡されます。  このプロバイダーは、要求をデータ ソース固有の形式に変換し、基になるデータ ソースで要求を実行します。[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] で規定されるリソースをアドレス指定する概念モデルと、基になるデータ ソースのスキーマとを分離することによってストレージの独立性を実現します。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] と ADO.NET Entity Framework の組み合わせにより、リレーショナル データを公開するデータ サービスを作成できます。  Entity Data Model ツールを使用して、エンティティとしてアドレス指定可能なリソースを含むデータ モデルを作成すると同時に、このモデルと基になるデータベースのテーブルの間のマッピングを定義できます。  詳細については、「[Entity Framework プロバイダー](../../../../docs/framework/data/wcf/entity-framework-provider-wcf-data-services.md)」を参照してください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、<xref:System.Linq.IQueryable%601> インターフェイスの実装を返すデータ構造を公開するデータ サービスを作成することもできます。  そのため、.NET Framework 型からデータを公開するデータ サービスを作成できます。  <xref:System.Data.Services.IUpdatable> インターフェイスも実装すると、作成、更新、および削除操作がサポートされます。  詳細については、「[リフレクション プロバイダー](../../../../docs/framework/data/wcf/reflection-provider-wcf-data-services.md)」を参照してください。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] をこれらのデータ プロバイダーと統合する方法については、このトピックの最後にあるアーキテクチャの図を参照してください。  
+  
+## カスタム ビジネス ロジック  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用すると、サービス操作およびインターセプターを介してデータ サービスにカスタム ビジネス ロジックを簡単に追加できます。  サービス操作とは、データ リソースと同じ形態の URI によるアドレス指定が可能な、サーバーで定義されるメソッドです。  サービス操作では、クエリ式構文を使用して、操作によって返されるデータのフィルター、並べ替え、およびページングを行うこともできます。たとえば、`http://localhost:12345/Northwind.svc/GetOrdersByCity?city='London'&$orderby=OrderDate&$top=10&$skip=10` という URI は、ロンドン \(London\) の顧客の注文を Northwind データ サービスから返し、ページングされた結果を `OrderDate` で並べ替える `GetOrdersByCity` というサービス操作への呼び出しを表します。  詳細については、「[サービス操作](../../../../docs/framework/data/wcf/service-operations-wcf-data-services.md)」を参照してください。  
+  
+ インターセプターを使用すると、カスタム アプリケーション ロジックをデータ サービスによる要求メッセージまたは応答メッセージの処理に統合できます。  インターセプターは、指定されたエンティティ セットに対してクエリ、挿入、更新、または削除の各操作が行われたときに呼び出されます。  インターセプターは、その後データの変更や承認ポリシーの強制を行うか、さらには操作を終了することもあります。  インターセプターのメソッドは、データ サービスによって公開される何らかのエンティティ セットに明示的に登録されている必要があります。  詳細については、「[インターセプター](../../../../docs/framework/data/wcf/interceptors-wcf-data-services.md)」を参照してください。  
+  
+## クライアント ライブラリ  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] は、データ サービスと対話する統一パターンのセットを定義します。  その結果、これらのサービスに基づいて再使用可能なコンポーネントを作成できます \(データ サービスの使用を簡略化するクライアント側ライブラリなど\)。  
+  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] には、.NET Framework ベースのクライアント アプリケーションと Silverlight ベースのクライアント アプリケーションの両方のクライアント ライブラリが含まれます。  これらのクライアント ライブラリでは、.NET Framework オブジェクトを使用してデータ サービスと対話できます。  また、オブジェクト ベースのクエリと LINQ クエリ、関連オブジェクトの読み込み、変更の追跡、および ID 解決もサポートしています。詳細については、「[WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)」を参照してください。  
+  
+ .NET Framework および Silverlight に含まれる [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] クライアント ライブラリのほかに、PHP、AJAX、Java アプリケーションなどのクライアント アプリケーションで [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用できるようにするクライアント ライブラリがあります。  詳細については、「[OData SDK](http://go.microsoft.com/fwlink/?LinkID=185796)」を参照してください。  
+  
+## アーキテクチャの概要  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開し、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] 対応クライアント ライブラリでこれらのフィードを使用するための [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] アーキテクチャを次の図に示します。  
+  
+ ![WCF Data Services アーキテクチャ ダイアグラム](../../../../docs/framework/data/wcf/media/astoriaservicearch.gif "AstoriaServiceArch")  
+  
+## 参照  
+ [WCF Data Services 4.5](../../../../docs/framework/data/wcf/index.md)   
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)   
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [Accessing a Data Service \(WCF Data Services\)](http://msdn.microsoft.com/ja-jp/1e54a2b9-2ec6-4002-b8f8-c1d8df37c350)   
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [Representational State Transfer \(REST\)](http://go.microsoft.com/fwlink/?LinkId=113919)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/wcf-data-services-protocol-implementation-details.md b/docs/framework/data/wcf/wcf-data-services-protocol-implementation-details.md
new file mode 100644
index 00000000000..5d090edeb33
--- /dev/null
+++ b/docs/framework/data/wcf/wcf-data-services-protocol-implementation-details.md
@@ -0,0 +1,34 @@
+---
+title: "WCF Data Services プロトコル実装の詳細 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 712d689b-fada-4cbb-bcdb-d65a3ef83b4c
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF Data Services プロトコル実装の詳細
+## OData プロトコル実装の詳細  
+ [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] では、プロトコルを実装するデータ サービスが、特定の機能の最小セットを提供する必要があります。  これらの機能は、「すべきこと」と「必ずしなければならないこと」に関して、プロトコル ドキュメントで説明されています。その他のオプション機能は、「できること」に関して説明されています。このトピックでは、現在 [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で実装されていないオプション機能について説明します。  詳細については、「[OData プロトコル ドキュメント](http://go.microsoft.com/fwlink/?LinkID=184554)」を参照してください。  
+  
+### $format クエリ オプションのサポート  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルは、JavaScript Notation \(JSON\) と Atom フィードの両方をサポートしており、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] の `$format` システム クエリ オプションを使用すると、クライアントは応答フィードの形式を要求できます。  このシステム クエリ オプションは、データ サービスでサポートされている場合、要求の Accept ヘッダーの値をオーバーライドする必要があります。  [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] では、JSON と Atom フィードのどちらでも返すことができます。  ただし、既定の実装では `$format` クエリ オプションをサポートしておらず、Accept ヘッダーの値だけを使用して応答の形式を決定します。  クライアントが Accept ヘッダーを設定できない場合のように、データ サービスで `$format` クエリ オプションをサポートしなければならないこともあります。  このようなシナリオをサポートするには、このオプションを URI で処理するように、データ サービスを拡張する必要があります。  この機能をデータ サービスに追加するには、MSDN コード ギャラリー Web サイトから「[ADO.NET Data Services のための JSONP および URL 制御の形式のサポート](http://go.microsoft.com/fwlink/?LinkId=208228)」のサンプル プロジェクトをダウンロードして、データ サービス プロジェクトに追加します。  このサンプルは、`$format` クエリ オプションを削除し、Accept ヘッダーを `application/json` に変更します。  サンプル プロジェクトを含めるときに、`JSONPSupportBehaviorAttribute` をデータ サービス クラスに追加すると、サービスが `$format` クエリ オプションの `$format=json` を処理できるようになります。  `$format=atom` や他のカスタム形式も処理するには、このサンプル プロジェクトをさらにカスタマイズする必要があります。  
+  
+## WCF Data Services の動作  
+ 次の [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の動作は、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プロトコルでは明示的に定義されていません。  
+  
+### 既定の並べ替え動作  
+ データ サービスに送信されるクエリ要求に、`$top` または `$skip` システム クエリ オプションが含まれ、`$orderby` システム クエリ オプションが含まれていない場合、返されるフィードはキー プロパティで昇順に並べ替えられます。  これは、結果を正しくページングするには並べ替えが必要であるためです。  そのために、データ サービスがクエリに並べ替え式を追加します。  この動作は、データ サービスでサーバー ドリブン ページングが有効になっている場合にも発生します。  詳細については、「[データ サービスの構成](../../../../docs/framework/data/wcf/configuring-the-data-service-wcf-data-services.md)」を参照してください。返されるフィードの並べ替えを制御するには、クエリ URI に `$orderby` を含める必要があります。  
+  
+## 参照  
+ [WCF Data Services の定義](../../../../docs/framework/data/wcf/defining-wcf-data-services.md)   
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/wcf-data-services-resources.md b/docs/framework/data/wcf/wcf-data-services-resources.md
new file mode 100644
index 00000000000..5a00693bb2d
--- /dev/null
+++ b/docs/framework/data/wcf/wcf-data-services-resources.md
@@ -0,0 +1,70 @@
+---
+title: "WCF Data Services リソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, 詳細"
+ms.assetid: e63a9baf-699c-42e2-b11f-fba57bcc14df
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF Data Services リソース
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の概要に関するトピックは次のとおりです。  これらのトピックの多くには、詳細情報が記載された関連トピックへのリンクも含まれています。  
+  
+ [概要](../../../../docs/framework/data/wcf/wcf-data-services-overview.md)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] で使用可能な機能の概要について説明します。  
+  
+ [はじめに](../../../../docs/framework/data/adonet/ef/getting-started.md)  
+ [クイックスタート](../../../../docs/framework/data/wcf/quickstart-wcf-data-services.md)に示すように、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] を使用してデータ サービスのデザインとアクセスを行う方法について説明します。  
+  
+ [アプリケーション シナリオ](../../../../docs/framework/data/wcf/application-scenarios-wcf-data-services.md)  
+ [!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードにアクセスする [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] およびアプリケーションを作成するためのタスク ベースのアプローチを紹介します。  
+  
+ [Visual Studio and .NET Framework Glossary](http://msdn.microsoft.com/ja-jp/6529d7c6-7e25-4426-a120-d57b239ca4eb)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] および [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] のドキュメントで使用される用語について説明します。  
+  
+## 外部リソース  
+ 次の外部リソースでは、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを公開および使用する [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] アプリケーションの作成に関する追加情報とサポートを提供します。  
+  
+ [WCF Data Services フォーラム](http://go.microsoft.com/fwlink/?LinkId=150512)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] 開発者のためのデータ プログラミング サポート。  
+  
+ [WCF Data Services チーム ブログ](http://go.microsoft.com/fwlink/?LinkId=150511)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の機能の最新情報と説明が記載されているブログ。  
+  
+ [OData Web サイト](http://go.microsoft.com/fwlink/?LinkID=184554)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] に関する主要な情報源。  
+  
+ [OData SDK](http://go.microsoft.com/fwlink/?LinkID=185248)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] フィードを使用するためのサンプル サービス、サンプル、およびプログラミング ライブラリが含まれます。  
+  
+ [OData ブログ](http://go.microsoft.com/fwlink/?LinkId=185868)  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] プログラミングに関する議論が記載されているブログ。  
+  
+ [データ アクセスおよびストレージ デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=91903)  
+ データ操作に関する情報やリソースが一度に見つかる場所。  
+  
+ [データ プラットフォーム操作方法ビデオ: WCF Data Services シリーズ](http://go.microsoft.com/fwlink/?LinkId=124600)  
+ データ サービスのビルドおよびアクセス方法について説明するビデオ スクリーン キャストのセットが提供されています。  
+  
+ [WCF Data Services の概要](http://go.microsoft.com/fwlink/?LinkID=131074)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] の利点に関する概要が記載されたホワイト ペーパー。  
+  
+ [Microsoft WCF Data Services の使用](http://go.microsoft.com/fwlink/?LinkID=131075)  
+ 追加情報およびクライアント アプリケーションのデータ サービスの作成とデータ サービスへのアクセスの例が記載されたホワイト ペーパー。  
+  
+ [The Entity\-Relationship Model: Toward a Unified View of Data](http://go.microsoft.com/fwlink/?LinkId=91909) \(マサチューセッツ工科大学、Peter Pin\-Shan Chen\)  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] によって実装されるエンティティ リレーショナル モデルの基礎について説明します。  コンピューター分野で最もよく引用される 1976 年に書かれた論文。  
+  
+## 参照  
+ [概要](../../../../docs/framework/data/wcf/getting-started-with-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md b/docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md
new file mode 100644
index 00000000000..3fa84e52f2f
--- /dev/null
+++ b/docs/framework/data/wcf/working-with-binary-data-wcf-data-services.md
@@ -0,0 +1,75 @@
+---
+title: "バイナリ データの操作 (WCF Data Services) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF Data Services, バイナリ データ"
+  - "WCF Data Services, ストリーム"
+ms.assetid: aeccc45c-d5c5-4671-ad63-a492ac8043ac
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# バイナリ データの操作 (WCF Data Services)
+[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用すると、次のいずれかの方法で、[!INCLUDE[ssODataFull](../../../../includes/ssodatafull-md.md)] フィードからバイナリ データを取得して更新できます。  
+  
+-   エンティティのプリミティブ型のプロパティとして。  メモリに容易に読み込むことができる小さいバイナリ データ オブジェクトを操作する場合は、この方法が適しています。  この場合、バイナリ プロパティは、データ モデルによって公開されるエンティティ プロパティです。データ サービスは、応答メッセージの Base\-64 バイナリ エンコード XML としてバイナリ データをシリアル化します。  
+  
+-   個別のバイナリ リソース ストリームとして。  写真、ビデオ、またはその他の種類のバイナリ エンコード データを表すバイナリ ラージ オブジェクト \(BLOB\) データにアクセスしたり、変更したりする場合は、この方法が適しています。  
+  
+ [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] で定義されているように、[!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] は HTTP を使用してバイナリ データのストリーミングを実装します。  この場合、バイナリ データは、エンティティに関連しているものの、エンティティとは切り離されたメディア リソースとして処理されます。これをメディア リンク エントリといいます。  詳細については、「[ストリーミング プロバイダー](../../../../docs/framework/data/wcf/streaming-provider-wcf-data-services.md)」を参照してください。  
+  
+> [!TIP]
+>  写真を格納している [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスからバイナリ画像ファイルをダウンロードする [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] クライアント アプリケーションの作成方法の例については、ブログの記事「[Data Services ストリーミング プロバイダー シリーズ \- パート 2: クライアントからメディア リソース ストリームへのアクセス](http://go.microsoft.com/fwlink/?LinkId=201637)」を参照してください。  このブログの記事で取り上げられているストリーミング フォト データ サービスのサンプル コードをダウンロードするには、MSDN コード ギャラリーの「[ストリーミング フォト データ サービスのサンプル](http://go.microsoft.com/fwlink/?LinkId=198988)」を参照してください。  
+  
+## エンティティ メタデータ  
+ メディア リソース ストリームが関連付けられているエンティティは、データ サービス メタデータで `HasStream` 属性によって示されます。この属性は、メディア リンク エントリであるエンティティ型に適用されます。  次の例の `PhotoInfo` エンティティは、メディア リソースが関連付けられているメディア リンク エントリであり、`HasStream` 属性によってそのことが示されています。  
+  
+ [!code-xml[Astoria Photo Streaming Service#HasStream](../../../../samples/snippets/xml/VS_Snippets_Misc/astoria photo streaming service/xml/photodata.edmx#hasstream)]  
+  
+ このトピックのその他の例では、メディア リソース ストリームにアクセスし変更する方法を紹介します。  .NET Framework クライアント アプリケーションで [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリを使用してメディア リソース ストリームを使用する方法の完全な例については、ブログの記事「[クライアントからメディア リソース ストリームへのアクセス](http://go.microsoft.com/fwlink/?LinkID=201637)」を参照してください。  
+  
+## バイナリ リソース ストリームへのアクセス  
+ [!INCLUDE[ssAstoria](../../../../includes/ssastoria-md.md)] クライアント ライブラリには、[!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] ベースのデータ サービスからのバイナリ リソース ストリームにアクセスするためのメソッドが用意されています。  メディア リソースをダウンロードするときには、メディア リソースの URI を使用することも、メディア リソース データ自体を含むバイナリ ストリームを取得することもできます。  メディア リソース データをバイナリ ストリームとしてアップロードすることもできます。  
+  
+> [!TIP]
+>  写真を格納している [!INCLUDE[ssODataShort](../../../../includes/ssodatashort-md.md)] サービスからバイナリ画像ファイルをダウンロードする [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] クライアント アプリケーションの作成方法の例については、ブログの記事「[Data Services ストリーミング プロバイダー シリーズ \- パート 2: クライアントからメディア リソース ストリームへのアクセス](http://go.microsoft.com/fwlink/?LinkId=201637)」を参照してください。  このブログの記事で取り上げられているストリーミング フォト データ サービスのサンプル コードをダウンロードするには、MSDN コード ギャラリーの「[ストリーミング フォト データ サービスのサンプル](http://go.microsoft.com/fwlink/?LinkId=198988)」を参照してください。  
+  
+### バイナリ ストリームの URI の取得  
+ 画像やその他のメディア ファイルなど、取得するメディア リソースの種類によっては、アプリケーションでメディア リソースの URI を使用する方がバイナリ データ ストリーム自体を処理するよりも簡単です。  特定のメディア リンク エントリに関連付けられているリソース ストリームの URI を取得するには、そのエンティティを追跡している <xref:System.Data.Services.Client.DataServiceContext.GetReadStreamUri%2A> インスタンスの <xref:System.Data.Services.Client.DataServiceContext> メソッドを呼び出す必要があります。  次の例は、クライアントで新しい画像を作成するために使用するメディア リソース ストリームの URI を取得するために <xref:System.Data.Services.Client.DataServiceContext.GetReadStreamUri%2A> メソッドを呼び出す方法を示しています。  
+  
+ [!code-csharp[Astoria Photo Streaming Client#GetReadStreamUri](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria photo streaming client/cs/photowindow.xaml.cs#getreadstreamuri)]
+ [!code-vb[Astoria Photo Streaming Client#GetReadStreamUri](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria photo streaming client/vb/photowindow.xaml.vb#getreadstreamuri)]  
+  
+### バイナリ リソース ストリームのダウンロード  
+ バイナリ リソース ストリームを取得する場合、メディア リンク エントリを追跡している <xref:System.Data.Services.Client.DataServiceContext> インスタンスの <xref:System.Data.Services.Client.DataServiceContext.GetReadStream%2A> メソッドを呼び出す必要があります。  このメソッドは、<xref:System.Data.Services.Client.DataServiceStreamResponse> オブジェクトを返すデータ サービスに要求を送信します。このオブジェクトは、リソースが含まれるストリームを参照します。  アプリケーションでバイナリ リソースを <xref:System.IO.Stream> として取得する必要がある場合にこのメソッドを使用します。  次の例は、クライアントで新しい画像を作成するために使用するストリームを取得するために <xref:System.Data.Services.Client.DataServiceContext.GetReadStream%2A> メソッドを呼び出す方法を示しています。  
+  
+ [!code-csharp[Astoria Streaming Client#GetReadStreamClient](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria streaming client/cs/customerphotowindow.xaml.cs#getreadstreamclient)]
+ [!code-vb[Astoria Streaming Client#GetReadStreamClient](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria streaming client/vb/customerphotowindow.xaml.vb#getreadstreamclient)]  
+  
+> [!NOTE]
+>  バイナリ ストリームを含む応答メッセージの Content\-Length ヘッダーは、このデータ サービスによって設定されません。  この値は、バイナリ データ ストリームの実際の長さを反映していない場合があります。  
+  
+### ストリームとしてのメディア リソースのアップロード  
+ メディア リソースを挿入または更新するには、エンティティを追跡している <xref:System.Data.Services.Client.DataServiceContext> インスタンスの <xref:System.Data.Services.Client.DataServiceContext.SetSaveStream%2A> メソッドを呼び出します。  このメソッドは、指定ストリームから読み込まれたメディア リソースを含むデータ サービスに要求を送信します。  次の例は、<xref:System.Data.Services.Client.DataServiceContext.SetSaveStream%2A> メソッドを呼び出してデータ サービスに画像を送信する方法を示しています。  
+  
+ [!code-csharp[Astoria Photo Streaming Client#SetSaveStream](../../../../samples/snippets/csharp/VS_Snippets_Misc/astoria photo streaming client/cs/photodetailswindow.xaml.cs#setsavestream)]
+ [!code-vb[Astoria Photo Streaming Client#SetSaveStream](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/astoria photo streaming client/vb/photodetailswindow.xaml.vb#setsavestream)]  
+  
+ この例では、`closeStream` パラメーターに値 `true` を指定して <xref:System.Data.Services.Client.DataServiceContext.SetSaveStream%2A> メソッドを呼び出しています。  したがって、必ず、バイナリ データがデータ サービスにアップロードされた後で <xref:System.Data.Services.Client.DataServiceContext> がストリームを閉じます。  
+  
+> [!NOTE]
+>  <xref:System.Data.Services.Client.DataServiceContext.SetSaveStream%2A> を呼び出すときには、<xref:System.Data.Services.Client.DataServiceContext.SaveChanges%2A> が呼び出されるまでストリームはデータ サービスに送信されないことに注意してください。  
+  
+## 参照  
+ [WCF Data Services クライアント ライブラリ](../../../../docs/framework/data/wcf/wcf-data-services-client-library.md)   
+ [コントロールへのデータのバインド](../../../../docs/framework/data/wcf/binding-data-to-controls-wcf-data-services.md)
\ No newline at end of file
diff --git a/docs/framework/data/wcf/writing-a-windows-store-app-that-consumes-an-odata-service.md b/docs/framework/data/wcf/writing-a-windows-store-app-that-consumes-an-odata-service.md
new file mode 100644
index 00000000000..4d0bcc0ba59
--- /dev/null
+++ b/docs/framework/data/wcf/writing-a-windows-store-app-that-consumes-an-odata-service.md
@@ -0,0 +1,248 @@
+---
+title: "OData サービスを利用する Windows ストア アプリの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-oob"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9917a0e9-ec93-49e5-a366-fd39b892eb8b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# OData サービスを利用する Windows ストア アプリの開発
+Windows 8 では、Windows ストア アプリと呼ばれる新しい種類のアプリケーションが導入されています。  まったく新しい外観を備え、さまざまなデバイス上で実行される Windows ストア アプリは、Windows ストアで入手できます。  このトピックでは、特に NetFlix のカタログで公開されている OData サービスを中心に、OData サービスを利用する Windows ストア アプリの開発方法を説明します。  Windows ストア アプリの詳細については、「[Windows ストア アプリの概要](http://msdn.microsoft.com/library/windows/apps/br211386.aspx)」を参照してください。  
+  
+## 必須コンポーネント  
+  
+1.  [Microsoft Windows 8](http://go.microsoft.com/fwlink/p/?LinkId=266654)  
+  
+2.  [Microsoft Visual Studio 2012](http://go.microsoft.com/fwlink/p/?LinkId=266655)  
+  
+3.  [WCF Data Services](http://msdn.microsoft.com/data/bb931106)  
+  
+#### 既定の Windows ストア グリッド アプリケーションの作成  
+  
+1.  C\# と XAML を使用して、新しい Windows ストア グリッド アプリケーションを作成します。  アプリケーションに OData.WindowsStore.NetflixDemo という名前を付けます。  
+  
+     ![&#91;新しいプロジェクト&#93; ダイアログ](../../../../docs/framework/data/wcf/media/win8clientcreatenewproject.png "Win8ClientCreateNewProject")  
+  
+2.  Package.appxmanifest を開き、\[表示名\] テキスト ボックスに表示名を入力します。  これによって、Windows 8 の検索機能で使用されるアプリケーション名が指定されます。  
+  
+     ![アプリケーション マニフェスト ファイル](../../../../docs/framework/data/wcf/media/appxmanifest.png "appxmanifest")  
+  
+3.  App.xaml ファイルの \<AppName\> 要素に表示名を入力します。  これによってアプリケーションの起動時に表示されるアプリケーション名が設定されます。  
+  
+     ![App.xaml ファイル](../../../../docs/framework/data/wcf/media/appxaml.png "appxaml")  
+  
+4.  アプリケーションをビルドして起動します。  アプリケーションのスプラッシュ スクリーンが最初に表示されます。  以下のスクリーンショットは既定のスプラッシュ スクリーンを示しています。  使用される画像はプロジェクトの Assets フォルダーに格納されています。  
+  
+     ![既定のアプリのスプラッシュ スクリーン](../../../../docs/framework/data/wcf/media/defualtappsplash.png "defualtAppSplash")  
+  
+     次にアプリケーション ウィザードが表示されます。  
+  
+     ![既定のアプリケーション](../../../../docs/framework/data/wcf/media/defaultapplication.png "DefaultApplication")  
+  
+     既定のアプリケーションは、SampleDataSource.cs: SampleDataGroup と SampleDataItem 内のクラスのセットを定義します。これらはいずれも SampleDataCommon から派生しており、SampleDataCommon 自体は BindableBase から派生しています。  SampleDataGroup と SampleDataItem は既定の GridView にバインドされています。  SampleDataSource.cs は NetflixDemo プロジェクトの DataModel フォルダーにあります。  このアプリケーションにはグループ化されたコレクションが表示されます。  各グループには任意の数の項目が含まれており、これらの項目は SampleDataGroup と SampleDataItem によってぞれぞれ表されます。  前のスクリーンショットには、Group Title 1 というグループと、このグループ内のすべての項目が同時に表示されています。  
+  
+     アプリケーションのメイン ページは GroupedItemsPage.xaml です。  このファイルに含まれる GridView に、SampleDataSource.cs クラスが作成するサンプル データが表示されます。  GroupedItemsPage は、rootFrame.Navigate への呼び出しを通して App.xaml.cs によって読み込まれます。  
+  
+    ```csharp  
+    if (!rootFrame.Navigate(typeof(GroupedItemsPage), "AllGroups"))  
+    {  
+        throw new Exception("Failed to create initial page");  
+    }  
+  
+    ```  
+  
+     これによって GroupedItemsPage がインストールされ、LoadState メソッドが呼び出されます。  LoadState によって静的な SampleDataSource インスタンスが作成され、これによって SampleDataGroup オブジェクトのコレクションが作成されます。  SampleDataGroup オブジェクトには SampleDataItem オブジェクトのコレクションが含まれます。  LoadState は、SampleDataGroup オブジェクトのコレクションを DefaultViewModel に格納します。  
+  
+    ```csharp  
+    protected override void LoadState(Object navigationParameter, Dictionary<String, Object> pageState)  
+    {  
+        var sampleDataGroups = SampleDataSource.GetGroups((String)navigationParameter);  
+        this.DefaultViewModel["Groups"] = sampleDataGroups;  
+    }  
+  
+    ```  
+  
+     次に DefaultViewModel が GridView にバインドされます。  これは、データ バインドの構成時に GroupedItemsPage.xaml ファイル内で参照されます。  
+  
+    ```cpp  
+    <CollectionViewSource  
+                x:Name="groupedItemsViewSource"  
+                Source="{Binding Groups}"  
+                IsSourceGrouped="true"  
+                ItemsPath="TopItems"  
+                d:Source="{Binding AllGroups, Source={d:DesignInstance Type=data:SampleDataSource, IsDesignTimeCreatable=True}}"/>  
+  
+    ```  
+  
+     CollectionViewSource は、グループ化されたコレクションの処理時にプロキシとして使用されます。  バインドが発生すると、SampleDataGroup オブジェクトのコレクションを反復処理することによって GridView を設定します。  ItemsPath 属性は、格納されている SampleDataItems の検索に使用する SampleDataGroup のプロパティを CollectionViewSource に指定します。  この場合、各 SampleDataGroup オブジェクトには SampleDataItem オブジェクトの TopItems コレクションが含まれます。  
+  
+     Netflix の場合、ムービーはジャンルでグループ化されます。  このため、アプリケーションはジャンルの数とジャンル内のムービーの一覧を表示します。  
+  
+#### Netflix OData サービスへのサービス参照の追加  
+  
+1.  Netflix OData サービスへの呼び出しを実行する前に、サービス参照を追加する必要があります。  ソリューション エクスプローラーでプロジェクトを右クリックし、\[サービス参照の追加\] をクリックします。  
+  
+     ![&#91;サービス参照の追加&#93; ダイアログ](../../../../docs/framework/data/wcf/media/addservicereferenceodata.png "AddServiceReferenceOData")  
+  
+2.  Netflix OData サービスの URL をアドレス バーに入力し、\[移動\] をクリックします。  Netflix へのサービス参照の名前空間を設定し、\[OK\] をクリックします。  
+  
+     ![サービス参照の追加エラー](../../../../docs/framework/data/wcf/media/addservicereferenceerror.png "AddServiceReferenceError")  
+  
+    > [!NOTE]
+    >  [Windows ストア アプリ用 WCF Data Services ツール](http://go.microsoft.com/fwlink/p/?LinkId=266652)をインストールしていない場合、上記のようなメッセージが表示されます。  続行するには、リンクで参照されているツールをダウンロードしてインストールする必要があります。  
+  
+ サービス参照を追加すると、厳密に型指定されたクラスが生成されます。WCF Data Services はこのクラスを使用して Netflix OData サービスが返す OData を解析します。  SampleDataSource.cs で定義されるクラスは GridView にバインドできます。このため、生成される OData クライアント クラスのデータを、SampleDataSource.cs で定義されるバインド可能なクラスに転送する必要があります。  これを実行するには、SampleDataSource.cs で定義されるデータ モデルにいくつかの変更を加える必要があります。  
+  
+#### アプリケーションで使用するデータ モデルの更新  
+  
+1.  SampleDataSource.cs ファイル内の既存のコードを、[この Gist](https://gist.github.com/3419288) のコードで置き換えます。  更新されたコードにより LoadMovies メソッドが \(SampleDataSource クラスに\) 追加されます。このメソッドによって Netflix OData にクエリが実行されることで、ジャンルの一覧が設定され、各ジャンルにムービーの一覧が設定されます。  SampleDataGroup クラスはジャンルを表すために使用され、SampleDataItem クラスはムービーを表すために使用されます。  
+  
+    ```csharp  
+    public static async void LoadMovies()  
+    {  
+        IEnumerable<Title> titles = await ((DataServiceQuery<Title>)Context.Titles  
+            .Expand("Genres,AudioFormats,AudioFormats/Language,Awards,Cast")  
+            .Where(t => t.Rating == "PG")  
+            .OrderByDescending(t => t.ReleaseYear)  
+            .Take(300)).ExecuteAsync();  
+  
+        foreach (Title title in titles)  
+        {  
+            foreach (Genre netflixGenre in title.Genres)  
+            {  
+                SampleDataGroup genre = GetGroup(netflixGenre.Name);  
+                if (genre == null)  
+                {  
+                    genre = new SampleDataGroup(netflixGenre.Name, netflixGenre.Name, String.Empty, title.BoxArt.LargeUrl, String.Empty);  
+                    Instance.AllGroups.Add(genre);  
+                }  
+                var content = new StringBuilder();  
+                // Write additional things to content here if you want them to display in the item detail.  
+                genre.Items.Add(new SampleDataItem(title.Id, title.Name, String.Format("{0}rnrn{1} ({2})", title.Synopsis, title.Rating, title.ReleaseYear), title.BoxArt.HighDefinitionUrl ?? title.BoxArt.LargeUrl, "Description", content.ToString()));  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+     [タスク ベースの非同期パターン](http://go.microsoft.com/fwlink/p/?LinkId=266651) \(TAP\) を使用して、最近 PG 指定 \(Where\) された 300 件 \(OrderByDescending\) の映画が Netflix から非同期で取得 \(Take\) されます。  コードの残りの部分は、OData フィードで返されるエンティティの SimpleDataItems と SimpleDataGroups で構成されます。  
+  
+     SampleDataSource クラスは、シンプルな検索手法も実装します。  この場合は、読み込まれたムービーのシンプルなインメモリ検索を実行します。  
+  
+    ```csharp  
+    public static IEnumerable<SampleDataItem> Search(string searchString)  
+    {  
+            var regex = new Regex(searchString, RegexOptions.CultureInvariant | RegexOptions.IgnoreCase | RegexOptions.IgnorePatternWhitespace);  
+            return Instance.AllGroups  
+                .SelectMany(g => g.Items)  
+                .Where(m => regex.IsMatch(m.Title) || regex.IsMatch(m.Subtitle))  
+                    .Distinct(new SampleDataItemComparer());  
+    }  
+  
+    ```  
+  
+     SampleDataSource.cs には ExtensionMethods というクラスも定義されています。  これらの拡張メソッドでは、TAP パターンを使用することで、UI のブロックが発生しない SampleDataSource による OData のクエリを可能にしています。  たとえば以下のコードでは、Task.Factory.FromAsync メソッドを使用して TAP を実装しています。  
+  
+    ```csharp  
+    public static async Task<IEnumerable<T>> ExecuteAsync<T>(this DataServiceQuery<T> query)  
+    {  
+        return await Task.Factory.FromAsync<IEnumerable<T>>(query.BeginExecute(null, null), query.EndExecute);  
+    }  
+  
+    ```  
+  
+     既定のアプリケーションと同様、アプリケーションのメイン ページは GroupedItemsPage となります。  ただし今回は、Netflix から取得され、ジャンル別にグループ化されたムービーが表示されます。  GroupedItemsPage がインストールされると、LoadState メソッドが呼び出されます。  前述のとおり、LoadState によって静的な SampleDataSource インスタンスが作成され、Netflix OData サービスへの呼び出しが実行されます。  LoadState は、ジャンル \(SampleDataGroup オブジェクト\) のコレクションを DefaultViewModel に格納します。  
+  
+    ```csharp  
+    protected override void LoadState(Object navigationParameter, Dictionary<String, Object> pageState)  
+    {  
+  
+        var sampleDataGroups = SampleDataSource.GetGroups((String)navigationParameter);  
+        this.DefaultViewModel["Groups"] = sampleDataGroups;  
+    }  
+    ```  
+  
+     前述のとおり、次に DefaultViewModel を使用して GridView にデータがバインドされます。  
+  
+#### 検索コントラクトの追加による、アプリケーションの Windows 検索への参加  
+  
+1.  アプリケーションに検索コントラクトを追加します。  これによってアプリケーションと Windows 8 の検索エクスペリエンスを統合できるようになります。  検索コントラクトに SearchResultsPage.xaml という名前を付けます。  
+  
+     ![検索コントラクトの追加](../../../../docs/framework/data/wcf/media/addsearchcontract.png "AddSearchContract")  
+  
+2.  queryText の周囲に埋め込まれた引用符を削除して、SearchResultsPage.xaml.cs の 58 行目を変更します。  
+  
+    ```csharp  
+    // Communicate results through the view model  
+    this.DefaultViewModel["QueryText"] = queryText;  
+    this.DefaultViewModel["Filters"] = filterList;  
+    this.DefaultViewModel["ShowFilters"] = filterList.Count > 1;  
+  
+    ```  
+  
+3.  検索結果を取得するには、以下の 2 行のコードを SearchResultsPage.xaml.cs の 81 行目に挿入します。  
+  
+    ```csharp  
+    // TODO: Respond to the change in active filter by setting this.DefaultViewModel["Results"]  
+                    //       to a collection of items with bindable Image, Title, Subtitle, and Description properties  
+                    var searchValue = (string)this.DefaultViewModel["QueryText"];  
+                    this.DefaultViewModel["Results"] = new List<SampleDataItem>(SampleDataSource.Search(searchValue));  
+  
+    ```  
+  
+ ユーザーが Windows 検索を起動し、検索用語を入力して、検索バーで Netflix デモ アプリのアイコンをタッチすると、SearchResultsPage の LoadState メソッドが実行されます。  クエリのテキストは LoadState に送信されるナビゲーション パラメーターに含まれています。  次に、Filter\_SelectionChanged メソッドが呼び出され、このメソッドによって SampleDataSource クラスで Search メソッドが呼び出されます。  結果が返され、SearchResultsPage.xaml ページに表示されます。  
+  
+```csharp  
+/// <summary>  
+        /// Invoked when a filter is selected using the ComboBox in snapped view state.  
+        /// </summary>  
+        /// <param name="sender">The ComboBox instance.</param>  
+        /// <param name="e">Event data describing how the selected filter was changed.</param>  
+        void Filter_SelectionChanged(object sender, SelectionChangedEventArgs e)  
+        {  
+            // Determine what filter was selected  
+            var selectedFilter = e.AddedItems.FirstOrDefault() as Filter;  
+            if (selectedFilter != null)  
+            {  
+                // Mirror the results into the corresponding Filter object to allow the  
+                // RadioButton representation used when not snapped to reflect the change  
+                selectedFilter.Active = true;  
+  
+                // TODO: Respond to the change in active filter by setting this.DefaultViewModel["Results"]  
+                //       to a collection of items with bindable Image, Title, Subtitle, and Description properties  
+                var searchValue = (string)this.DefaultViewModel["QueryText"];  
+                this.DefaultViewModel["Results"] = new List<SampleDataItem>(SampleDataSource.Search(searchValue));  
+  
+                // Ensure results are found  
+                object results;  
+                ICollection resultsCollection;  
+                if (this.DefaultViewModel.TryGetValue("Results", out results) &&  
+                    (resultsCollection = results as ICollection) != null &&  
+                    resultsCollection.Count != 0)  
+                {  
+                    VisualStateManager.GoToState(this, "ResultsFound", true);  
+                    return;  
+                }  
+            }  
+  
+            // Display informational text when there are no search results.  
+            VisualStateManager.GoToState(this, "NoResultsFound", true);  
+        }  
+```  
+  
+ アプリケーションに検索を統合する詳細については、「[Windows 8 検索に検索を統合する](http://go.microsoft.com/fwlink/p/?LinkId=266650)」を参照してください。  
+  
+## アプリケーションの実行  
+ F5 キーを押してアプリケーションを起動します。  アプリケーションの起動時には、画像の読み込みに数秒かかります。  また、最初の検索では結果がまったく返されない場合があります。  実際のアプリケーションでは、これらの問題の両方に対処する必要があります。  
+  
+ アプリケーションは、Netflix OData サービスを呼び出し、生成される OData クライアント クラスでデータを受け取り、バインド可能なデータ クラス \(SampleDataSource、SampleDataGroup、および SampleDataItem\) にこのデータを転送します。  これらのバインド可能なクラスが使用され、データが GridView にバインドされます。  XAML におけるデータ バインドの動作の詳細については、「[リストまたはグリッド内の項目をグループ化する方法 \(C\#\/VB\/C\+\+ と XAML を使った Windows ストア アプリ\)](http://msdn.microsoft.com/library/windows/apps/xaml/hh780627)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/TOC.md b/docs/framework/debug-trace-profile/TOC.md
new file mode 100644
index 00000000000..9eb7490c982
--- /dev/null
+++ b/docs/framework/debug-trace-profile/TOC.md
@@ -0,0 +1,60 @@
+# [Enabling JIT-Attach Debugging](enabling-jit-attach-debugging.md)
+# [方法: トレース ソースを作成し初期化する](how-to-create-and-initialize-trace-sources.md)
+# [How to: Add Trace Statements to Application Code](how-to-add-trace-statements-to-application-code.md)
+# [invalidApartmentStateChange](invalidapartmentstatechange-mda.md)
+# [dllMainReturnsFalse](dllmainreturnsfalse-mda.md)
+# [openGenericCERCall](opengenericcercall-mda.md)
+# [invalidVariant](invalidvariant-mda.md)
+# [ランタイム プロファイリング](runtime-profiling.md)
+# [invalidIUnknown](invalidiunknown-mda.md)
+# [dateTimeInvalidLocalFormat](datetimeinvalidlocalformat-mda.md)
+# [invalidCERCall](invalidcercall-mda.md)
+# [raceOnRCWCleanup](raceonrcwcleanup-mda.md)
+# [pInvokeLog](pinvokelog-mda.md)
+# [overlappedFreeError](overlappedfreeerror-mda.md)
+# [moduloObjectHashcode](moduloobjecthashcode-mda.md)
+# [dirtyCastAndCallOnInterface](dirtycastandcalloninterface-mda.md)
+# [loadFromContext](loadfromcontext-mda.md)
+# [invalidMemberDeclaration](invalidmemberdeclaration-mda.md)
+# [reportAvOnComRelease](reportavoncomrelease-mda.md)
+# [nonComVisibleBaseClass](noncomvisiblebaseclass-mda.md)
+# [asynchronousThreadAbort](asynchronousthreadabort-mda.md)
+# [invalidFunctionPointerInDelegate](invalidfunctionpointerindelegate-mda.md)
+# [notMarshalable](notmarshalable-mda.md)
+# [failedQI](failedqi-mda.md)
+# [loaderLock](loaderlock-mda.md)
+# [fatalExecutionEngineError](fatalexecutionengineerror-mda.md)
+# [Trace Switches](trace-switches.md)
+# [Code Contracts](code-contracts.md)
+# [イメージのデバッグの簡略化](making-an-image-easier-to-debug.md)
+# [アプリケーションのトレースとインストルメント](tracing-and-instrumenting-applications.md)
+# [Diagnosing Errors with Managed Debugging Assistants](diagnosing-errors-with-managed-debugging-assistants.md)
+# [gcManagedToUnmanaged](gcmanagedtounmanaged-mda.md)
+# [Enhancing Debugging with the Debugger Display Attributes](enhancing-debugging-with-the-debugger-display-attributes.md)
+# [reentrancy](reentrancy-mda.md)
+# [streamWriterBufferedDataLost](streamwriterbuffereddatalost-mda.md)
+# [Performance Counters and In-Process Side-By-Side Applications](performance-counters-and-in-process-side-by-side-applications.md)
+# [invalidGCHandleCookie](invalidgchandlecookie-mda.md)
+# [jitCompilationStart](jitcompilationstart-mda.md)
+# [memberInfoCacheCreation](memberinfocachecreation-mda.md)
+# [How to: Create, Initialize and Configure Trace Switches](how-to-create-initialize-and-configure-trace-switches.md)
+# [How to: Compile Conditionally with Trace and Debug](how-to-compile-conditionally-with-trace-and-debug.md)
+# [exceptionSwallowedOnCallFromCom](exceptionswallowedoncallfromcom-mda.md)
+# [marshaling](marshaling-mda.md)
+# [Debugging, Tracing, and Profiling](index.md)
+# [releaseHandleFailed](releasehandlefailed-mda.md)
+# [Trace Listeners](trace-listeners.md)
+# [dangerousThreadingAPI](dangerousthreadingapi-mda.md)
+# [callbackOnCollectedDelegate](callbackoncollecteddelegate-mda.md)
+# [pInvokeStackImbalance](pinvokestackimbalance-mda.md)
+# [illegalPrepareConstrainedRegion](illegalprepareconstrainedregion-mda.md)
+# [marshalCleanupError](marshalcleanuperror-mda.md)
+# [invalidOverlappedToPinvoke](invalidoverlappedtopinvoke-mda.md)
+# [contextSwitchDeadlock](contextswitchdeadlock-mda.md)
+# [bindingFailure](bindingfailure-mda.md)
+# [How to: Use TraceSource and Filters with Trace Listeners](how-to-use-tracesource-and-filters-with-trace-listeners.md)
+# [How to: Create and Initialize Trace Listeners](how-to-create-and-initialize-trace-listeners.md)
+# [virtualCERCall](virtualcercall-mda.md)
+# [disconnectedContext](disconnectedcontext-mda.md)
+# [gcUnmanagedToManaged](gcunmanagedtomanaged-mda.md)
+# [Performance Counters](performance-counters.md)
diff --git a/docs/framework/debug-trace-profile/asynchronousthreadabort-mda.md b/docs/framework/debug-trace-profile/asynchronousthreadabort-mda.md
new file mode 100644
index 00000000000..580b8d88203
--- /dev/null
+++ b/docs/framework/debug-trace-profile/asynchronousthreadabort-mda.md
@@ -0,0 +1,85 @@
+---
+title: "asynchronousThreadAbort MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "asynchronous thread aborts"
+  - "AsynchronousThreadAbort MDA"
+  - "managed debugging assistants (MDAs), asynchronous thread aborts"
+  - "threading [.NET Framework], managed debugging assistants"
+  - "MDAs (managed debugging assistants), asynchronous thread aborts"
+ms.assetid: 9ebe40b2-d703-421e-8660-984acc42bfe0
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# asynchronousThreadAbort MDA
+`asynchronousThreadAbort` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、スレッドが別のスレッドに非同期の中止処理を適用しようとするとアクティブになります。  同期のスレッド中止では、`asynchronousThreadAbort` MDA はアクティブになりません。  
+  
+## 症状  
+ メインのアプリケーション スレッドが中止されると、アプリケーションは未処理の <xref:System.Threading.ThreadAbortException> でクラッシュします。  もしもアプリケーションが実行を続けると、アプリケーションがクラッシュした場合よりも悪い結果を招き、データ破損が続くなどの状況になる恐れがあります。  
+  
+ 分割できない操作が部分的に完了した後で中断された可能性があり、アプリケーション データは予測不可能な状態のままになりました。  <xref:System.Threading.ThreadAbortException> は、コード実行中、見かけ上はランダムなポイントから生成でき、例外が発生するとは予期していない場所で生成されることもよくあります。  コードは例外などを処理できず、破損した状態になります。  
+  
+ 問題には偶然性が伴うため、症状は非常に多岐にわたります。  
+  
+## 原因  
+ あるスレッドのコードが、対象スレッド上の <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> メソッドを呼び出し、非同期のスレッド中止を招きました。  <xref:System.Threading.Thread.Abort%2A> への呼び出しを実行するコードは、中止操作の対象スレッドとは異なるため、スレッド中止は非同期になります。  同期のスレッド中止の場合、<xref:System.Threading.Thread.Abort%2A> を実行するスレッドがこの操作を実行するのは、アプリケーション状態に一貫性がある安全なチェックポイントだけなので、問題になりません。  
+  
+ 非同期のスレッド中止は、対象スレッドの実行中に予期しないポイントで実行されるため、問題になります。  これを回避するには、この方法で中断される可能性のあるスレッドで実行するコードでは、ほとんどすべてのコード行で <xref:System.Threading.ThreadAbortException> を処理して、アプリケーション データが一貫性のある状態へ戻すことができるように気を付ける必要があります。  コードがこの問題に備えて作成されることを想定したり、起こりうるすべての状況に対処するコードを作成したりすることは、現実的ではありません。  
+  
+ アンマネージ コードの呼び出しと `finally` ブロックは非同期に中止されませんが、これらのいずれかから終了すると、即座に中止されます。  
+  
+ 問題には偶然性が伴うため、原因を特定することは困難な場合があります。  
+  
+## 解決策  
+ 非同期のスレッド中止を使用しなければならないコード設計を避けます。  対象スレッドが <xref:System.Threading.Thread.Abort%2A> の呼び出しを必要としない場合に、その対象スレッドを中断するのに適した方法はいくつかあります。  最も安全な方法は、対象スレッドが中断を要求していることを示すシグナルとなる、共通プロパティなどの機構を導入することです。  対象スレッドは、特定の安全なチェックポイントで、シグナルをチェックします。  中断が要求されたことが示されている場合は、適切にシャットダウンできます。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  非同期のスレッド中止に関するデータを報告するだけです。  
+  
+## 出力  
+ MDA は、中止を実行するスレッドの ID、および中止の対象となるスレッドの ID を報告します。  これは非同期の中止に限られるため、これらが同じになることはありません。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <asynchronousThreadAbort />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ `asynchronousThreadAbort` MDA は、独立して実行されるスレッドで <xref:System.Threading.Thread.Abort%2A> を呼び出すだけでアクティブになります。  スレッドの開始関数がより複雑な一連の操作で構成され、中止によって中断されるポイントを特定できない場合は、影響を考慮してください。  
+  
+```  
+using System.Threading;  
+void FireMda()  
+{  
+    Thread t = new Thread(delegate() { Thread.Sleep(1000); });  
+    t.Start();  
+    // The following line activates the MDA.  
+    t.Abort();   
+    t.Join();  
+}  
+```  
+  
+## 参照  
+ <xref:System.Threading.Thread>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/bindingfailure-mda.md b/docs/framework/debug-trace-profile/bindingfailure-mda.md
new file mode 100644
index 00000000000..29b0691584f
--- /dev/null
+++ b/docs/framework/debug-trace-profile/bindingfailure-mda.md
@@ -0,0 +1,112 @@
+---
+title: "bindingFailure MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "binding failure"
+  - "binding, failures"
+  - "MDAs (managed debugging assistants), binding failures"
+  - "assemblies [.NET Framework], binding failures"
+  - "managed debugging assistants (MDAs), binding failures"
+  - "BindingFailure MDA"
+ms.assetid: 26ada5af-175c-4576-931a-9f07fa1723e9
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# bindingFailure MDA
+`bindingFailure` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、アセンブリの読み込みに失敗したときにアクティブになります。  
+  
+## 症状  
+ コードは、静的参照またはいずれかのローダー メソッド \(<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> または <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>\) を使用して、アセンブリを読み込みしようとしました。  アセンブリは読み込まれず、<xref:System.IO.FileNotFoundException> 例外または <xref:System.IO.FileLoadException> 例外がスローされました。  
+  
+## 原因  
+ バインディング エラーは、ランタイムがアセンブリを読み込むことができない場合に発生します。  バインディング エラーは、次のいずれかの状況の結果として発生することもあります。  
+  
+-   共通言語ランタイム \(CLR\) は、要求されたアセンブリを見つけることができませんでした。  この理由は数多くあります。たとえば、アセンブリがインストールされていない、アプリケーションがアセンブリを見つけるように正しく設定されていない、などです。  
+  
+-   一般的な問題のシナリオによって型が別のアプリケーション ドメインに渡されているが、このアプリケーション ドメインでは、CLR が読み込むアセンブリは、別のアプリケーション ドメインでその型を含んでいる必要があります。  別のアプリケーション ドメインが元のアプリケーション ドメインとは異なるように構成されていると、ランタイムがアセンブリを読み込むことができないことがあります。  たとえば、2 つのアプリケーション ドメインで、<xref:System.AppDomain.BaseDirectory%2A> プロパティ値が異なる可能性があります。  
+  
+-   要求されたアセンブリは、破損しているか、アセンブリではありません。  
+  
+-   アセンブリを読み込もうとしているコードには、アセンブリを読み込むための適切なコード アクセス セキュリティ許可が設定されていません。  
+  
+-   ユーザー資格情報には、ファイルを読み込むために必要なアクセス許可が設定されていません。  
+  
+## 解決策  
+ 最初の手順は、要求されたアセンブリに CLLR がバインドできなかった原因を決定することです。  たとえば「原因」セクションに一覧表示されたシナリオのように、ランタイムが要求されたアセンブリを見つけられなかったり読み込みできなかったりする理由は、数多く存在します。  バインディング エラーの原因を除去するには、次のアクションをお勧めします。  
+  
+-   `bindingFailure` MDA から提供されるデータを使用して、原因を特定します。  
+  
+    -   アセンブリ バインダーによって生成されるエラー ログを読み取るために、[Fuslogvw.exe \(アセンブリ バインディング ログ ビューアー\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) を実行します。  
+  
+    -   アセンブリが要求された位置にあるかどうかを確認します。  <xref:System.Reflection.Assembly.LoadFrom%2A> メソッドおよび <xref:System.Reflection.Assembly.LoadFile%2A> メソッドの場合は、要求された場所を簡単に確認できます。  <xref:System.Reflection.Assembly.Load%2A> メソッドの場合は、アセンブリ ID を使用してバインドするため、アプリケーション ドメインの <xref:System.AppDomain.BaseDirectory%2A> プロパティ プローブ パスおよびグローバル アセンブリ キャッシュで、アセンブリ ID と一致するアセンブリを検索する必要があります。  
+  
+-   前の手順で確認した情報を基に、原因を解決します。  使用できる解決策は、次のとおりです。  
+  
+    -   要求されたアセンブリをグローバル アセンブリ キャッシュにインストールし、  ID でアセンブリを読み込むために <xref:System.Reflection.Assembly.Load%2A> メソッドを呼び出します。  
+  
+    -   要求されたアセンブリをアプリケーション ディレクトリにコピーし、ID でアセンブリを読み込むために <xref:System.Reflection.Assembly.Load%2A> メソッドを呼び出します。  
+  
+    -   <xref:System.AppDomain.BaseDirectory%2A> プロパティの変更かプローブ パスの追加により、バインディング エラーが発生するアプリケーション ドメインがアセンブリ パスを含むように再構成します。  
+  
+    -   ログオンしているユーザーがファイルを読み込むことができるように、ファイルのアクセス制御リストを変更します。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  バインディング エラーに関するデータを報告するだけです。  
+  
+## 出力  
+ MDA は、読み込みに失敗したアセンブリを報告します。これには、要求されたパスや表示名、バインディング コンテキスト、読み込みが要求されたアプリケーション ドメイン、エラーの理由などが含まれます。  
+  
+ 表示名や要求されたパスは、そのデータが CLR で利用できない場合は空白である場合があります。  失敗した呼び出しが <xref:System.Reflection.Assembly.Load%2A> メソッドに対する呼び出しであった場合、ランタイムは、アセンブリの表示名を決定できなかったことが考えられます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <bindingFailure />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ この MDA をアクティブ化する場合のコード例を次に示します。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.Reflection;  
+namespace ConsoleApplication1  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            // This call attempts to load a nonexistent assembly.  
+            // The call will throw a System.IO.FileNotFound exception  
+            // and cause the activation of the bindingFailure MDA   
+            // if it is registered.  
+            Assembly.Load("NonExistentAssembly");  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/callbackoncollecteddelegate-mda.md b/docs/framework/debug-trace-profile/callbackoncollecteddelegate-mda.md
new file mode 100644
index 00000000000..6578dd5cbcf
--- /dev/null
+++ b/docs/framework/debug-trace-profile/callbackoncollecteddelegate-mda.md
@@ -0,0 +1,124 @@
+---
+title: "callbackOnCollectedDelegate MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), garbage collection"
+  - "managed debugging assistants (MDAs), callback on collected delegates"
+  - "MDAs (managed debugging assistants), callback on collected delegates"
+  - "callback on delegate after garbage collection"
+  - "callbackOnCollectedDelegate MDA"
+  - "managed debugging assistants (MDAs), garbage collection"
+  - "call back collected delegates"
+  - "garbage collection, run-time errors"
+  - "delegates [.NET Framework], garbage collection"
+ms.assetid: 398b0ce0-5cc9-4518-978d-b8263aa21e5b
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# callbackOnCollectedDelegate MDA
+`callbackOnCollectedDelegate` マネージ デバッグ アシスタント \(MDA\) は、デリゲートがマネージ コードからアンマネージ コードに関数ポインターとしてマーシャリングされ、デリゲートがガベージ コレクトされた後にその関数ポインター上にコールバックが配置された場合にアクティブ化されます。  
+  
+## 症状  
+ マネージ デリゲートから取得した関数ポインターを通じてマネージ コードへの呼び出しをしようとすると、アクセス違反が発生します。  このエラーは、共通言語ランタイム \(CLR\) コード内でアクセス違反が発生するため、CLR のバグのように見えますが、実際には違います。  
+  
+ このエラーには一貫性がなく、関数ポインターでの呼び出しが成功することもあれば、失敗することもあります。  高負荷のときのみエラーが発生することがあり、ランダムな試行回数ごとに発生することもあります。  
+  
+## 原因  
+ 関数ポインターが作成されてアンマネージ コードに公開されたデリゲートが、ガベージ コレクトされました。  アンマネージ コンポーネントからその関数ポインターで呼び出しを行おうとすると、アクセス違反が発生します。  
+  
+ このエラーの発生するタイミングはガベージ コレクションが行われるタイミングに依存するため、ランダムに発生するように見えます。  デリゲートがガベージ コレクションの対象になった場合でも、コールバックが行われて成功した後にガベージ コレクションが行われることがあります。  別の時には、コールバックの前にガベージ コレクションが実行されたため、コールバックがアクセス違反を生成し、プログラムが停止します。  
+  
+ エラーの発生確率は、デリゲートのマーシャリングから関数ポインターの呼び出しまでの時間と、ガベージ コレクションの頻度に応じて変わります。  デリゲートのマーシャリングから次のコールバックまでの時間が短い場合、エラーは散発的です。  これは、関数ポインターを受け取るアンマネージ メソッドが後で使用するために関数ポインターを保存することはせず、代わりに関数ポインターをすぐにコールバックし、返る前に操作が完了する場合に当てはまります。  同様に、システムの負荷が高いと頻繁にガベージ コレクションが発生するため、コールバックの前にガベージ コレクションが発生する可能性が高くなります。  
+  
+## 解像度  
+ デリゲートがアンマネージ関数ポインターとしてマーシャリングされた後、ガベージ コレクターはその有効期間を追跡できません。  代わりに、アンマネージ関数ポインターの有効期間にわたってデリゲートへの参照をコードで保持する必要があります。  しかし、それを行うには、まずどのデリゲートがガベージ コレクトされたかを識別する必要があります。  MDA がアクティブになると、デリゲートの型名が提供されます。  この名前を使用してコードを検索し、アンマネージ コードにデリゲートを渡すプラットフォーム呼び出しまたは COM シグネチャを見つけます。  問題が発生したデリゲートは、これらの呼び出しサイトのいずれかを通じて渡されます。  また、`gcUnmanagedToManaged` MDA を有効にして、ランタイムへのコールバックの前にガベージ コレクションを強制することもできます。  これにより、コールバックが行われる前に必ずガベージ コレクションが行われるため、ガベージ コレクションによって持ち込まれる不確実性が排除されます。  ガベージ コレクトされたデリゲートがわかったら、マーシャリングしたアンマネージ関数ポインターの有効期間にわたってデリゲートへの参照をマネージ側に保持するようにコードを変更します。  
+  
+## ランタイムへの影響  
+ デリゲートを関数ポインターとしてマーシャリングすると、ランタイムはアンマネージからマネージへの遷移を行うサンクを割り当てます。  このサンクが、マネージ デリゲートが最終的に呼び出される前に、アンマネージ コードによって実際に呼び出されるものです。  `callbackOnCollectedDelegate` MDA を有効にしない場合、アンマネージのマーシャリング コードはデリゲートがガベージ コレクトされたときに削除されます。  `callbackOnCollectedDelegate` MDA を有効にした場合、アンマネージのマーシャリング コードはデリゲートがガベージ コレクトされたとき、すぐには削除されません。  代わりに、既定では最新の 1,000 個のインスタンスが有効のまま保持され、呼び出されたときに MDA をアクティブ化するように変更されます。  サンクはやがて、さらに 1,001 個のマーシャリングされたデリゲートがガベージ コレクトされた後に削除されます。  
+  
+## 出力  
+ MDA は、デリゲートのアンマネージ関数ポインターへのコールバックが試みられる前に、ガベージ コレクトされたデリゲートの型名を報告します。  
+  
+## 構成  
+ 次の例は、アプリケーションの構成オプションを示します。  MDA が有効に保持するサンクの数を 1,500 に設定しています。  `listSize` の既定値は 1,000、最小値は 50、最大値は 2,000 です。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <callbackOnCollectedDelegate listSize="1500" />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ 次の例は、この MDA がアクティブ化されることのある状況を示しています。  
+  
+```  
+// Library.cpp : Defines the unmanaged entry point for the DLL application.  
+#include "windows.h"  
+#include "stdio.h"  
+  
+void (__stdcall *g_pfTarget)();  
+  
+void __stdcall Initialize(void __stdcall pfTarget())  
+{  
+    g_pfTarget = pfTarget;  
+}  
+  
+void __stdcall Callback()  
+{  
+    g_pfTarget();  
+}  
+// ---------------------------------------------------  
+// C# Client  
+using System;  
+using System.Runtime.InteropServices;  
+  
+public class Entry  
+{  
+    public delegate void DCallback();  
+  
+    public static void Main()  
+    {  
+        new Entry();  
+        Initialize(Target);  
+        GC.Collect();  
+        GC.WaitForPendingFinalizers();  
+        Callback();  
+    }  
+  
+    public static void Target()  
+    {          
+    }  
+  
+    [DllImport("Library", CallingConvention = CallingConvention.StdCall)]  
+    public static extern void Initialize(DCallback pfDelegate);  
+  
+    [DllImport ("Library", CallingConvention = CallingConvention.StdCall)]  
+    public static extern void Callback();  
+  
+    ~Entry() { Console.Error.WriteLine("Entry Collected"); }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)   
+ [gcUnmanagedToManaged](../../../docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/code-contracts.md b/docs/framework/debug-trace-profile/code-contracts.md
new file mode 100644
index 00000000000..02e66ab4eb0
--- /dev/null
+++ b/docs/framework/debug-trace-profile/code-contracts.md
@@ -0,0 +1,202 @@
+---
+title: "Code Contracts | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Code contracts"
+ms.assetid: 84526045-496f-489d-8517-a258cf76f040
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Code Contracts
+コード コントラクトを使用すると、事前条件、事後条件、およびオブジェクト不変条件をコードで指定できます。  事前条件とは、メソッドやプロパティに入るときに満たされている必要がある要件です。  事後条件は、メソッドやプロパティのコードが終了するときの予測を表します。  オブジェクト不変条件は、正しい状態のクラスに対して予期される状態を表します。  
+  
+ コード コントラクトには、コードをマーク付けするためのクラス、コンパイル時の分析のための静的アナライザー、およびランタイム アナライザーが含まれます。  コード コントラクトのクラスは <xref:System.Diagnostics.Contracts> 名前空間にあります。  
+  
+ コード コントラクトには次のような利点があります。  
+  
+-   テストの強化: コード コントラクトでは、コントラクトの静的検証、ランタイム チェック、およびドキュメントの生成がサポートされます。  
+  
+-   自動テスト ツール: コード コントラクトを使用すると、事前条件を満たさない無意味なテスト引数をフィルターで除外して、より意味のある単体テストを生成できます。  
+  
+-   静的検証: 静的チェックにより、コントラクト違反がないかどうかをプログラムを実行せずに確認できます。  暗黙的なコントラクト \(null の逆参照、配列の範囲など\) と明示的なコントラクトがチェックされます。  
+  
+-   リファレンス ドキュメント: ドキュメント生成機能により、既存の XML ドキュメント ファイルにコントラクトの情報が追加されます。  生成されるドキュメントのページにコントラクトのセクションが含まれるようにするための、[Sandcastle](http://go.microsoft.com/fwlink/?LinkID=169253) で使用できるスタイル シートも用意されています。  
+  
+ コントラクトは、すべての .NET Framework 言語ですぐに使用できます。特別なパーサーやコンパイラを記述する必要はありません。  実行するコード コントラクト分析のレベルを指定できる Visual Studio アドインや、  コントラクトの形式が正しいかどうかを確認したり \(型チェックおよび名前解決\)、コンパイルされた形式 \(MSIL \(Microsoft Intermediate Language\) 形式\) のコントラクトを生成したりできるアナライザーも用意されています。  Visual Studio でコントラクトを作成する場合は、Visual Studio の標準の IntelliSense も利用できます。  
+  
+ コントラクト クラスのほとんどのメソッドは、条件付きでコンパイルされます。したがって、それらのメソッドの呼び出しは、`#define` ディレクティブを使用して CONTRACTS\_FULL という特別なシンボルを定義した場合にのみコンパイラで生成されます。  CONTRACTS\_FULL を使用すると、コードで `#ifdef` ディレクティブを使用せずにコントラクトを記述して、コントラクトを含むものと含まないものなど、さまざまなビルドを生成できます。  
+  
+ コード コントラクトを使用するためのツールおよび詳細な手順については、MSDN DevLabs Web サイトの「[Code Contracts \(コード コントラクト\)](http://go.microsoft.com/fwlink/?LinkId=152461)」を参照してください。  
+  
+## 実行前の状態  
+ 事前条件を指定するには、<xref:System.Diagnostics.Contracts.Contract.Requires%2A?displayProperty=fullName> メソッドを使用します。  事前条件では、メソッドが呼び出される状態を指定します。  通常は、有効なパラメーター値を指定するために使用されます。  事前条件で参照されるすべてのメンバーは、アクセス レベルが少なくともメソッド自体と同じである必要があります。そうでない場合、メソッドのすべての呼び出し元がその事前条件を理解できない場合があります。  また、条件に副作用がないようにする必要もあります。  事前条件が満たされなかった場合の実行時の動作は、ランタイム アナライザーによって決定されます。  
+  
+ たとえば、次の事前条件は、パラメーター `x` が null 以外である必要があることを表しています。  
+  
+ `Contract.Requires( x != null );`  
+  
+ 事前条件が満たされなかった場合に特定の例外をスローする必要がある場合には、次のように、<xref:System.Diagnostics.Contracts.Contract.Requires%2A> のジェネリック オーバーロードを使用します。  
+  
+ `Contract.Requires<ArgumentNullException>( x != null, "x" );`  
+  
+### レガシ requires ステートメント  
+ ほとんどのコードには、`if`\-`then`\-`throw` コードの形式のパラメーター検証が含まれています。  以下の場合は、それらのステートメントがコントラクト ツールで事前条件として認識されます。  
+  
+-   それらのステートメントがメソッド内で他のステートメントより前にある場合。  
+  
+-   それらのステートメント全体の後に <xref:System.Diagnostics.Contracts.Contract> メソッドの明示的な呼び出し \(<xref:System.Diagnostics.Contracts.Contract.Requires%2A>、<xref:System.Diagnostics.Contracts.Contract.Ensures%2A>、<xref:System.Diagnostics.Contracts.Contract.EnsuresOnThrow%2A>、または <xref:System.Diagnostics.Contracts.Contract.EndContractBlock%2A> のいずれかのメソッドの呼び出しなど\) がある場合。  
+  
+ `if`\-`then`\-`throw` ステートメントがこのような形式になっている場合、それらのステートメントはレガシ `requires` ステートメントとして認識されます。  `if`\-`then`\-`throw` というシーケンスの後に他のコントラクトがない場合は、<xref:System.Diagnostics.Contracts.Contract.EndContractBlock%2A?displayProperty=fullName> メソッドでコードを終了します。  
+  
+```  
+if ( x == null ) throw new ...  
+Contract.EndContractBlock(); // All previous "if" checks are preconditions  
+```  
+  
+ 上のテストの条件は否定の事前条件であることに注意してください。  \(実際の事前条件は `x != null` です\)。 否定の事前条件には多くの制限があり、上の例のように記述する必要があります \(`else` 句が含まれていてはならない、`then` 句の本体は 1 つの `throw` ステートメントでなければならないなど\)。  `if` テストには純粋性と可視性の両方の規則が適用されますが \(「[使用方法のガイドライン](#usage_guidelines)」を参照\)、`throw` 式に適用されるのは純粋性の規則だけです。  ただし、スローされる例外の型には、そのコントラクトが存在するメソッドと同じレベルの可視性が必要です。  
+  
+## 実行後の状態  
+ 事後条件は、メソッドの終了時の状態についてのコントラクトで、  メソッドが終了する直前にチェックされます。  事後条件が満たされなかった場合の実行時の動作は、ランタイム アナライザーによって決定されます。  
+  
+ 事後条件では、事前条件とは違って、可視性のレベルがメソッドより低いメンバーも参照できます。  事後条件でプライベートの状態を使用して指定した情報は、クライアントが理解できなかったり利用できなかったりする場合もありますが、そのためにクライアントがメソッドを正しく使用できなくなることはありません。  
+  
+### 標準の事後条件  
+ 標準の事後条件を指定するには、<xref:System.Diagnostics.Contracts.Contract.Ensures%2A> メソッドを使用します。  事後条件は、メソッドが正常に終了した場合に `true` になる必要がある条件を表します。  
+  
+ `Contract.Ensures( this .F > 0 );`  
+  
+### 例外の事後条件  
+ 例外の事後条件とは、メソッドによって特定の例外がスローされた場合に `true` になる必要がある事後条件です。  これらの事後条件を指定するには、次の例で示されているように、<xref:System.Diagnostics.Contracts.Contract.EnsuresOnThrow%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ `Contract.EnsuresOnThrow<T>( this.F > 0 );`  
+  
+ 引数は、`T` のサブタイプである例外がスローされた場合に `true` になる必要がある条件です。  
+  
+ 例外型の中には、例外の事後条件で使用するのが困難なものもあります。  たとえば、`T` に対して <xref:System.Exception> 型を使用する場合は、指定する条件が、スローされる例外の型に関係なく \(スタック オーバーフローなどの制御不可能な例外の場合でも\) メソッドによって保証される必要があります。  例外の事後条件は、メンバーが呼び出されたときにスローされる可能性がある特定の例外に対してのみ使用するようにしてください \(<xref:System.TimeZoneInfo> メソッドの呼び出しに対して <xref:System.InvalidTimeZoneException> がスローされる場合など\)。  
+  
+### 特殊な事後条件  
+ 次のメソッドは、事後条件の中でのみ使用できます。  
+  
+-   事後条件でメソッドの戻り値を参照するには、`Contract. Result<T>()` という式を使用します。`T` はメソッドの戻り値の型に置き換えられます。  コンパイラが型を推論できない場合は明示的に指定する必要があります。  たとえば、C\# コンパイラでは、引数を受け取らないメソッドの型は推論できないため、`Contract.Ensures(0 < Contract.Result<int>())` という事後条件を使用する必要があります。戻り値の型が `void` のメソッドの事後条件では `Contract. Result<T>()` を参照できません。  
+  
+-   事後条件の前の状態の値は、メソッドまたはプロパティの開始時の式の値を表します。  使用される式は `Contract.OldValue<T>(e)` で、`T` は `e` の型です。  その型をコンパイラが推論できる場合は、このジェネリック型引数を省略できます  \(たとえば、この式は引数を受け取るため、C\# コンパイラでは常に型が推論されます\)。 `e` に使用できる値と、古い式を使用できるコンテキストについては、いくつかの制限があります。  まず、古い式に別の古い式を含めることはできません。  また、最も重要な点として、古い式で参照する値は、メソッドの事前条件の状態に存在する必要があります。  つまり、古い式は、メソッドの事前条件が `true` であれば評価できる式である必要があります。  この規則のいくつかの例を次に示します。  
+  
+    -   値がメソッドの事前条件の状態に存在する必要があります。  オブジェクトのフィールドを参照するには、オブジェクトが常に null 以外であることが事前条件によって保証される必要があります。  
+  
+    -   古い式でメソッドの戻り値を参照することはできません。  
+  
+        ```  
+        Contract.OldValue(Contract.Result<int>() + x) // ERROR  
+        ```  
+  
+    -   古い式で `out` パラメーターを参照することはできません。  
+  
+    -   量指定子の範囲がメソッドの戻り値に依存する場合は、量指定子のバインド変数に依存する古い式は使用できません。  
+  
+        ```  
+        Contract. ForAll (0,Contract. Result<int>(),  
+        i => Contract.OldValue(xs[i]) > 3 ); // ERROR  
+        ```  
+  
+    -   古い式で <xref:System.Diagnostics.Contracts.Contract.ForAll%2A> または <xref:System.Diagnostics.Contracts.Contract.Exists%2A> の呼び出しの匿名デリゲートのパラメーターを参照することはできません \(メソッド呼び出しのインデクサーまたは引数として使用されている場合を除く\)。  
+  
+        ```  
+        Contract. ForAll (0, xs .Length, i => Contract.OldValue(xs[i]) > 3); // OK  
+        Contract. ForAll (0, xs .Length, i => Contract.OldValue(i) > 3 ); // ERROR  
+        ```  
+  
+    -   古い式の値が匿名デリゲートのパラメーターに依存している場合、古い式をその匿名デリゲートの本体に含めることはできません \(匿名デリゲートが <xref:System.Diagnostics.Contracts.Contract.ForAll%2A> メソッドまたは <xref:System.Diagnostics.Contracts.Contract.Exists%2A> メソッドの引数である場合を除く\)。  
+  
+        ```  
+        Method( ... (T t) => Contract.OldValue(... t ...) ... ); // ERROR  
+        ```  
+  
+    -   コントラクトはメソッド本体の前にあるため、`Out` パラメーターは問題になります。ほとんどのコンパイラでは、事後条件で `out` パラメーターを参照することは許可されていません。  この問題を解決するために、<xref:System.Diagnostics.Contracts.Contract> クラスには <xref:System.Diagnostics.Contracts.Contract.ValueAtReturn%2A> メソッドが用意されています。このメソッドを使用すると、`out` パラメーターに基づく事後条件を使用できます。  
+  
+        ```  
+        public void OutParam(out int x) f  
+        Contract.Ensures(Contract.ValueAtReturn(out x) == 3);  
+        x = 3;  
+        ```  
+  
+         <xref:System.Diagnostics.Contracts.Contract.OldValue%2A> メソッドと同様に、コンパイラが型を推論できる場合はジェネリック型パラメーターを省略できます。  このメソッドの呼び出しは、コントラクト リライターによって `out` パラメーターの値に置き換えられます。  <xref:System.Diagnostics.Contracts.Contract.ValueAtReturn%2A> メソッドは事後条件でしか使用できません。  このメソッドの引数は、`out` パラメーターか、構造体の `out` パラメーターのフィールド  \(構造体コンストラクターの事後条件でフィールドを参照する場合にも便利です\) でなければなりません。  
+  
+        > [!NOTE]
+        >  現在、コード コントラクト分析ツールでは、`out` パラメーターが正しく初期化されているかどうかはチェックされません。事後条件に含まれていても無視されます。  したがって、前の例で、コントラクトの後の行で `x` に整数を代入せずにこの値をそのまま使用しても、コンパイラで適切なエラーが生成されません。  ただし、CONTRACTS\_FULL プリプロセッサ シンボルが定義されていないビルド \( `` リリース ビルドなど\) では、コンパイラでエラーが生成されます。  
+  
+## インバリアント  
+ オブジェクト不変条件とは、そのオブジェクトがクライアントに表示される場合に常にクラスの各インスタンスに対して true になる必要があり、  オブジェクトが正しいと見なされる条件を表します。  
+  
+ インバリアントなメソッドは、<xref:System.Diagnostics.Contracts.ContractInvariantMethodAttribute> 属性でマークされることによって識別されます。  インバリアントなメソッドには、<xref:System.Diagnostics.Contracts.Contract.Invariant%2A> メソッドの一連の呼び出し以外のコードが含まれていない必要があります。それらの呼び出しでは、次の例のように、個々の不変式を指定します。  
+  
+```  
+[ContractInvariantMethod]  
+protected void ObjectInvariant ()   
+{  
+Contract.Invariant ( this.y >= 0 );  
+Contract.Invariant ( this.x > this.y );  
+...  
+}  
+```  
+  
+ 不変式は、CONTRACTS\_FULL プリプロセッサ シンボルによって条件付きで定義され、  ランタイム チェックで各パブリック メソッドの最後にチェックされます。  不変式が同じクラスのパブリック メソッドを参照している場合は、通常ならそのパブリック メソッドの最後に実行される不変式のチェックが無効になり、  そのクラスの一番外側のメソッド呼び出しの最後にのみチェックが実行されます。  別のクラスのメソッドの呼び出しのためにクラスへの再入がなされる場合も同様です。  不変式のチェックは、オブジェクト ファイナライザーや、<xref:System.IDisposable.Dispose%2A> メソッドを実装するメソッドに対しては実行されません。  
+  
+<a name="usage_guidelines"></a>   
+## 使用方法のガイドライン  
+  
+### コントラクトの順序  
+ メソッドのコントラクトを記述する際に使用する必要がある要素の順序を次の表に示します。  
+  
+|||  
+|-|-|  
+|`If-then-throw statements`|下位互換性のあるパブリックな事前条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.Requires%2A>|すべてのパブリックな事前条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.Ensures%2A>|すべてのパブリックな \(標準の\) 事後条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.EnsuresOnThrow%2A>|すべてのパブリックな例外の事後条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.Ensures%2A>|すべてのプライベートな\/内部の \(標準の\) 事後条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.EnsuresOnThrow%2A>|すべてのプライベートな\/内部の例外の事後条件。|  
+|<xref:System.Diagnostics.Contracts.Contract.EndContractBlock%2A>|`if`\-`then`\-`throw` スタイルの事前条件を他のコントラクトなしで使用する場合は、<xref:System.Diagnostics.Contracts.Contract.EndContractBlock%2A> を呼び出して、前の if チェックがすべて事前条件であることを示します。|  
+  
+<a name="purity"></a>   
+### 純粋性  
+ コントラクトの中で呼び出されるメソッドは、すべて純粋である \(既存の状態を更新しない\) 必要があります。  メソッドに入った後に作成されたオブジェクトは、そのピュア メソッドによって変更できます。  
+  
+ コード コントラクト ツールでは、現在、次のコード要素が純粋と見なされます。  
+  
+-   <xref:System.Diagnostics.Contracts.PureAttribute> でマークされたメソッド。  
+  
+-   <xref:System.Diagnostics.Contracts.PureAttribute> でマークされた型 \(この属性はその型のすべてのメソッドに適用されます\)。  
+  
+-   プロパティの get アクセサー。  
+  
+-   演算子 \(名前が "op" で始まり、1 つか 2 つのパラメーターを持ち、戻り値の型が void ではない静的メソッド\)。  
+  
+-   完全修飾名が "System.Diagnostics.Contracts.Contract"、"System.String"、"System.IO.Path"、または "System.Type" で始まるメソッド。  
+  
+-   呼び出されたデリゲート \(デリゲート型自体に <xref:System.Diagnostics.Contracts.PureAttribute> 属性が設定されている場合\)。  デリゲート型の <xref:System.Predicate%601?displayProperty=fullName> と <xref:System.Comparison%601?displayProperty=fullName> は純粋と見なされます。  
+  
+<a name="visibility"></a>   
+### 可視性  
+ コントラクトで参照されるすべてのメンバーには、少なくとも親のメソッドと同じレベルの可視性が必要です。  たとえば、パブリック メソッドの事前条件でプライベート フィールドを参照することはできません。そのようなコントラクトは、クライアントがメソッドの呼び出しの前に検証できません。  ただし、そのフィールドが <xref:System.Diagnostics.Contracts.ContractPublicPropertyNameAttribute> でマークされている場合は、これらの規則から除外されます。  
+  
+## 例  
+ 次に、コード コントラクトの使用例を示します。  
+  
+ [!code-csharp[ContractExample#1](../../../samples/snippets/csharp/VS_Snippets_CLR/contractexample/cs/program.cs#1)]
+ [!code-vb[ContractExample#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/contractexample/vb/program.vb#1)]
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/contextswitchdeadlock-mda.md b/docs/framework/debug-trace-profile/contextswitchdeadlock-mda.md
new file mode 100644
index 00000000000..3db29885952
--- /dev/null
+++ b/docs/framework/debug-trace-profile/contextswitchdeadlock-mda.md
@@ -0,0 +1,82 @@
+---
+title: "contextSwitchDeadlock MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "deadlocks [.NET Framework]"
+  - "pumping messages"
+  - "STA message pumping"
+  - "single-threaded COM components"
+  - "MDAs (managed debugging assistants), context switching deadlocks"
+  - "managed debugging assistants (MDAs), context switching deadlocks"
+  - "ContextSwitchDeadlock MDA"
+  - "message pumping"
+  - "context switching deadlocks"
+ms.assetid: 26dfaa15-9ddb-4b0a-b6da-999bba664fa6
+caps.latest.revision: 22
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# contextSwitchDeadlock MDA
+`contextSwitchDeadlock` マネージ デバッグ アシスタント \(MDA\) は、COM コンテキストの遷移の試行中にデッドロックが検出されるとアクティブ化されます。  
+  
+## 症状  
+ 最も一般的な症状は、マネージ コードから実行されたアンマネージ COM コンポーネントの呼び出しから戻らないことです。  別の症状として、メモリの使用量が時間と共に増加する場合もあります。  
+  
+## 原因  
+ 最も考えられる原因として、シングルスレッド アパートメント \(STA\) スレッドがメッセージ ポンプを行っていないことがあります。  STA スレッドが、メッセージ ポンプを行わずに待機しているか、または時間のかかる操作を実行していて、メッセージ キューのポンプを許可していません。  
+  
+ メモリ使用量が時間の経過と共に増加する症状は、ファイナライザー スレッドがアンマネージ COM コンポーネント上の `Release` を呼び出そうとして、そのコンポーネントが戻らない場合に発生します。  このため、ファイナライザーは他のオブジェクトを再利用できなくなります。  
+  
+ 既定では、Visual Basic コンソール アプリケーションのメイン スレッドのスレッド処理モデルは STA です。  STA スレッドが共通言語ランタイムまたはサードパーティ コントロールを通じて COM 相互運用性を直接または間接的に使用する場合、この MDA がアクティブ化されます。  Visual Basic コンソール アプリケーションでこの MDA がアクティブ化されるのを防ぐには、メイン メソッドに <xref:System.MTAThreadAttribute> 属性を適用するか、またはメッセージをポンプするようにアプリケーションを変更します。  
+  
+ 次のすべての条件が満たされる場合、この MDA が誤ってアクティブ化される可能性があります。  
+  
+-   アプリケーションがライブラリを通じて直接または間接的に STA スレッドから COM コンポーネントを作成する。  
+  
+-   デバッガーでアプリケーションが中断され、ユーザーがアプリケーションを続行したか、またはステップ操作を実行した。  
+  
+-   アンマネージ デバッグが有効になっていない。  
+  
+ MDA が誤ってアクティブ化されたかどうかを判断するには、すべてのブレークポイントを無効にし、アプリケーションを再び実行して、中断なしで実行させます。  MDA がアクティブ化されない場合は、最初のアクティブ化は誤りだった可能性があります。  その場合は、MDA を無効にして、デバッグ セッションとの干渉を防ぎます。  
+  
+> [!NOTE]
+>  この MDA は、[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] 以上のバージョンの既定のセットに含まれています。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でホスティング プロセスが有効にされている場合、既定のセットに含まれる MDA を無効にすることはできません。  ホスティング プロセスは既定で有効になるため、明示的に無効にする必要があります。  MDA を無効にする方法については、「[Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)」の「MDA の有効化と無効化」を参照してください。  
+  
+## 解像度  
+ STA メッセージ ポンプに関する COM 規則に従います。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  COM コンテキストに関するデータを報告するだけです。  
+  
+## 出力  
+ 現在のコンテキストおよびターゲット コンテキストを説明するメッセージです。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <contextSwitchDeadlock />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/dangerousthreadingapi-mda.md b/docs/framework/debug-trace-profile/dangerousthreadingapi-mda.md
new file mode 100644
index 00000000000..dfc41cd3995
--- /dev/null
+++ b/docs/framework/debug-trace-profile/dangerousthreadingapi-mda.md
@@ -0,0 +1,83 @@
+---
+title: "dangerousThreadingAPI MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "suspending threads"
+  - "DangerousThreadingAPI MDA"
+  - "managed debugging assistants (MDAs), dangerous threading operations"
+  - "threading [.NET Framework], suspending"
+  - "MDAs (managed debugging assistants), dangerous threading operations"
+  - "Suspend method"
+  - "threading [.NET Framework], managed debugging assistants"
+ms.assetid: 3e5efbc5-92e4-4229-b31f-ce368a1adb96
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# dangerousThreadingAPI MDA
+`dangerousThreadingAPI` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、現在のスレッド以外のスレッドで <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> メソッドが呼び出されるとアクティブになります。  
+  
+## 症状  
+ アプリケーションがいつまでも応答しないかハングアップしています。  システムまたはアプリケーションのデータが一時的に、またはアプリケーションのシャットダウン後も、予期しない状態のままになっている可能性があります。  一部の操作が予期したとおりに完了していません。  
+  
+ 問題には偶然性が伴うため、症状は非常に多岐にわたります。  
+  
+## 原因  
+ スレッドは、<xref:System.Threading.Thread.Suspend%2A> メソッドを使用する別のスレッドによって、非同期に中断されています。  別のスレッドが操作中である可能性があるときに、そのスレッドを中断するタイミングを判断する方法はありません。  スレッドを中断すると、データの破損やインバリアントの中断が発生することがあります。  スレッドが中断状態になっていて、<xref:System.Threading.Thread.Resume%2A> メソッドで再開されないと、アプリケーションのハングアップ状態がいつまでも続き、アプリケーション データが損害を受けることがあります。  これらのメソッドは、互換性のために残されています。  
+  
+ 同期プリミティブがターゲット スレッドによって保持されている場合は、中断の間も保持されたままになります。  これにより、<xref:System.Threading.Thread.Suspend%2A> を実行するスレッドのように別のスレッドがプリミティブのロックを取得しようとすると、デッドロックが発生することがあります。  この場合、問題自体がデッドロックとして現れます。  
+  
+## 解決策  
+ <xref:System.Threading.Thread.Suspend%2A> および <xref:System.Threading.Thread.Resume%2A> を使用する必要のある設計を避けます。  スレッド間の協調では、<xref:System.Threading.Monitor>、<xref:System.Threading.ReaderWriterLock>、<xref:System.Threading.Mutex> などの同期プリミティブや、C\# の `lock` ステートメントを使用します。  これらのメソッドを使用する必要がある場合は、時間を短くし、スレッドが中断状態にある間に実行されるコードの量を最小限に留めます。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  危険なスレッド処理操作に関するデータを報告するだけです。  
+  
+## 出力  
+ MDA は、アクティブになった原因である危険なスレッド処理メソッドを示します。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <dangerousThreadingAPI />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ `dangerousThreadingAPI` のアクティブ化の原因となる <xref:System.Threading.Thread.Suspend%2A> メソッド呼び出しのコード例を次に示します。  
+  
+```  
+using System.Threading;  
+void FireMda()  
+{  
+    Thread t = new Thread(delegate() { Thread.Sleep(1000); });  
+    t.Start();  
+    // The following line activates the MDA.  
+    t.Suspend();   
+    t.Resume();  
+    t.Join();  
+}  
+```  
+  
+## 参照  
+ <xref:System.Threading.Thread>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [lock ステートメント](../Topic/lock%20Statement%20\(C%23%20Reference\).md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/datetimeinvalidlocalformat-mda.md b/docs/framework/debug-trace-profile/datetimeinvalidlocalformat-mda.md
new file mode 100644
index 00000000000..a670db81951
--- /dev/null
+++ b/docs/framework/debug-trace-profile/datetimeinvalidlocalformat-mda.md
@@ -0,0 +1,101 @@
+---
+title: "dateTimeInvalidLocalFormat MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "dates [.NET Framework], formatting"
+  - "invalid date time local format"
+  - "invalid local formats"
+  - "MDAs (managed debugging assistants), invalid local formats"
+  - "managed debugging assistants (MDAs), invalid local formats"
+  - "dateTimeInvalidLocalFormat MDA"
+  - "date formatting"
+  - "time formatting"
+  - "UTC formatting"
+ms.assetid: c4a942bb-2651-4b65-8718-809f892a0659
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# dateTimeInvalidLocalFormat MDA
+`dateTimeInvalidLocalFormat` MDA は、世界協定時刻 \(UTC: Universal Coordinated Time\) として保存されている <xref:System.DateTime> インスタンスが、ローカル <xref:System.DateTime> インスタンス専用の形式で書式指定されたときにアクティブになります。  この MDA は、未指定または既定の <xref:System.DateTime> インスタンスに対してはアクティブになりません。  
+  
+## 症状  
+ アプリケーションで、次のようなローカル形式を使用して UTC <xref:System.DateTime> インスタンスを手動でシリアル化しています。  
+  
+```  
+DateTime myDateTime = DateTime.UtcNow;  
+Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffzzz"));  
+```  
+  
+### 原因  
+ <xref:System.DateTime.ToString%2A?displayProperty=fullName> メソッドの 'z' 形式には、ローカル タイム ゾーン オフセット \(たとえば、シドニー時間の場合は "\+10:00"\) が含まれます。  そのため、<xref:System.DateTime> の値がローカルの場合にのみ、有意な結果が生成されます。  値が UTC 時刻の場合、<xref:System.DateTime.ToString%2A?displayProperty=fullName> には、ローカル タイム ゾーン オフセットが含まれますが、タイム ゾーン指定子を表示したり、調整したりされません。  
+  
+### 解決策  
+ UTC <xref:System.DateTime> インスタンスが UTC であることを示すように書式指定する必要があります。  UTC 時刻の形式としては、次のように 'Z' を使用して UTC 時刻を示すようにすることをお勧めします。  
+  
+```  
+DateTime myDateTime = DateTime.UtcNow;  
+Serialize(myDateTime.ToString("yyyy-MM-dd'T'HH:mm:ss.fffffffZ"));  
+```  
+  
+ また、インスタンスがローカル、UTC、未指定のいずれの場合でも正しくシリアル化する <xref:System.DateTime.Kind%2A> プロパティを利用して <xref:System.DateTime> をシリアル化する "o" 形式もあります。  
+  
+```  
+DateTime myDateTime = DateTime.UtcNow;  
+Serialize(myDateTime.ToString("o"));  
+```  
+  
+## ランタイムへの影響  
+ この MDA はランタイムに影響しません。  
+  
+## 出力  
+ この MDA がアクティブになっても特別な出力は生成されませんが、呼び出し履歴を使用すると、この MDA をアクティブにした <xref:System.DateTime.ToString%2A> 呼び出しの位置を確認できます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <dateTimeInvalidLocalFormat />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ 次のように、<xref:System.Xml.XmlConvert> クラスや <xref:System.Data.DataSet> クラスを使用して UTC <xref:System.DateTime> 値を間接的にシリアル化するアプリケーションについて考えてみます。  
+  
+```  
+DateTime myDateTime = DateTime.UtcNow;  
+String serialized = XMLConvert.ToString(myDateTime);  
+```  
+  
+ <xref:System.Xml.XmlConvert> と <xref:System.Data.DataSet> のシリアル化では、既定でシリアル化用のローカル形式を使用します。  UTC など、他の種類の <xref:System.DateTime> 値をシリアル化する場合は、追加のオプションが必要です。  
+  
+ この例では、`XmlConvert` での `ToString` 呼び出しに `XmlDateTimeSerializationMode.RoundtripKind` を渡します。  これで、データが UTC 時間としてシリアル化されます。  
+  
+ <xref:System.Data.DataSet> を使用する場合は、<xref:System.Data.DataColumn> オブジェクトの <xref:System.Data.DataColumn.DateTimeMode%2A> プロパティを <xref:System.Data.DataSetDateTime> に設定します。  
+  
+```  
+DateTime myDateTime = DateTime.UtcNow;  
+String serialized = XmlConvert.ToString(myDateTime,   
+    XmlDateTimeSerializationMode.RoundtripKind);  
+```  
+  
+## 参照  
+ <xref:System.Globalization.DateTimeFormatInfo>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md b/docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md
new file mode 100644
index 00000000000..b4a966bc44a
--- /dev/null
+++ b/docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md
@@ -0,0 +1,197 @@
+---
+title: "Diagnosing Errors with Managed Debugging Assistants | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "EHMDA"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "run-time error debugging"
+  - "managed code, run-time debugging"
+  - "resource debugging"
+  - "registry, MDAs"
+  - "common language runtime, debugging"
+  - "MDAs (managed debugging assistants)"
+  - "configuration files [.NET Framework], debugging runtime events"
+  - "messages, managed debugging assistants"
+  - "application configuration files, managed debugging assistants"
+  - "debugging [.NET Framework], managed debugging assistants"
+  - "environment variables, MDAs"
+  - "access violation debugging [.NET Framework]"
+  - "diagnostics, managed debugging assistants"
+  - "unmanaged code, run-time debugging"
+  - "default debug output stream"
+  - "memory, debugging"
+  - "app.config files, managed debugging assistants"
+  - "managed debugging assistants (MDAs)"
+  - "debugging [.NET Framework], run-time errors"
+  - "trapping events"
+  - "runtime, error debugging"
+  - "disabling MDAs"
+  - "output, managed debugging assistants"
+  - "errors [.NET Framework], managed debugging assistants"
+ms.assetid: 76994ee6-9fa9-4059-b813-26578d24427c
+caps.latest.revision: 63
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# Diagnosing Errors with Managed Debugging Assistants
+マネージ デバッグ アシスタント \(MDA\) は、共通言語ランタイム \(CLR: Common Language Runtime\) と連携してランタイム状態に関する情報を提供するデバッグ支援ツールです。  MDA は、これ以外の方法ではトラップできないランタイム イベントに関する情報メッセージを生成します。  MDA を使用すると、マネージ コードからアンマネージ コードへの遷移時に発生する、検出が難しいアプリケーション バグを分離できます。  すべての MDA を有効または無効にするには、Windows レジストリにキーを追加するか、環境変数を設定します。  特定の MDA を有効にするには、アプリケーション構成設定を使用します。  一部の MDA については、アプリケーションの構成ファイルで追加の構成設定を個別に設定できます。  この構成ファイルはランタイムの読み込み時に解析されるため、MDA は、マネージ アプリケーションが起動する前に有効にする必要があります。  MDA は、既に起動しているアプリケーションに対して有効にできません。  
+  
+> [!NOTE]
+>  MDA を有効にすると、コードをデバッガーで実行していないときでも MDA がアクティブになります。  デバッガーが存在しない場合に MDA イベントが発生した場合、そのイベントはハンドルされない例外とは異なりますが、イベント メッセージはハンドルされない例外のダイアログ ボックスに表示されます。  このダイアログ ボックスが表示されないようにするには、デバッグ環境でコードを実行しているのではないときに、MDA を有効にする設定を削除します。  
+  
+> [!NOTE]
+>  Visual Studio の統合開発環境 \(IDE: Integrated Development Environment\) でコードを実行している場合は、特定の MDA イベントを示す例外のダイアログ ボックスを表示しないようにできます。  これを行うには、**\[デバッグ\]** メニューの **\[例外\]** をクリックします   \(**\[デバッグ\]** メニューに **\[例外\]** が表示されない場合は、**\[ツール\]** メニューの **\[カスタマイズ\]** をクリックし、メニュー項目を追加します\)。**\[例外\]** ダイアログ ボックスで、**\[マネージ デバッグ アシスタント\]** の一覧を展開し、個々の MDA に対して **\[スローされるとき\]** チェック ボックスをオフにします。  たとえば、[contextSwitchDeadlock](../../../docs/framework/debug-trace-profile/contextswitchdeadlock-mda.md) の例外のダイアログ ボックスを表示しないようにするには、**\[マネージ デバッグ アシスタント\]** で、この名前の横にある **\[スローされるとき\]** チェック ボックスをオフにします。  このダイアログ ボックスを使用して、MDA 例外ダイアログ ボックスの表示を有効にすることもできます。  
+  
+ .NET Framework に付属する MDA の一覧を次の表に示します。  
+  
+|||  
+|-|-|  
+|[asynchronousThreadAbort](../../../docs/framework/debug-trace-profile/asynchronousthreadabort-mda.md)|[bindingFailure](../../../docs/framework/debug-trace-profile/bindingfailure-mda.md)|  
+|[callbackOnCollectedDelegate](../../../docs/framework/debug-trace-profile/callbackoncollecteddelegate-mda.md)|[contextSwitchDeadlock](../../../docs/framework/debug-trace-profile/contextswitchdeadlock-mda.md)|  
+|[dangerousThreadingAPI](../../../docs/framework/debug-trace-profile/dangerousthreadingapi-mda.md)|[dateTimeInvalidLocalFormat](../../../docs/framework/debug-trace-profile/datetimeinvalidlocalformat-mda.md)|  
+|[dirtyCastAndCallOnInterface](../../../docs/framework/debug-trace-profile/dirtycastandcalloninterface-mda.md)|[disconnectedContext](../../../docs/framework/debug-trace-profile/disconnectedcontext-mda.md)|  
+|[dllMainReturnsFalse](../../../docs/framework/debug-trace-profile/dllmainreturnsfalse-mda.md)|[exceptionSwallowedOnCallFromCom](../../../docs/framework/debug-trace-profile/exceptionswallowedoncallfromcom-mda.md)|  
+|[failedQI](../../../docs/framework/debug-trace-profile/failedqi-mda.md)|[fatalExecutionEngineError](../../../docs/framework/debug-trace-profile/fatalexecutionengineerror-mda.md)|  
+|[gcManagedToUnmanaged](../../../docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md)|[gcUnmanagedToManaged](../../../docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md)|  
+|[illegalPrepareConstrainedRegion](../../../docs/framework/debug-trace-profile/illegalprepareconstrainedregion-mda.md)|[invalidApartmentStateChange](../../../docs/framework/debug-trace-profile/invalidapartmentstatechange-mda.md)|  
+|[invalidCERCall](../../../docs/framework/debug-trace-profile/invalidcercall-mda.md)|[invalidFunctionPointerInDelegate](../../../docs/framework/debug-trace-profile/invalidfunctionpointerindelegate-mda.md)|  
+|[invalidGCHandleCookie](../../../docs/framework/debug-trace-profile/invalidgchandlecookie-mda.md)|[invalidIUnknown](../../../docs/framework/debug-trace-profile/invalidiunknown-mda.md)|  
+|[invalidMemberDeclaration](../../../docs/framework/debug-trace-profile/invalidmemberdeclaration-mda.md)|[invalidOverlappedToPinvoke](../../../docs/framework/debug-trace-profile/invalidoverlappedtopinvoke-mda.md)|  
+|[invalidVariant](../../../docs/framework/debug-trace-profile/invalidvariant-mda.md)|[jitCompilationStart](../../../docs/framework/debug-trace-profile/jitcompilationstart-mda.md)|  
+|[loaderLock](../../../docs/framework/debug-trace-profile/loaderlock-mda.md)|[loadFromContext](../../../docs/framework/debug-trace-profile/loadfromcontext-mda.md)|  
+|[marshalCleanupError](../../../docs/framework/debug-trace-profile/marshalcleanuperror-mda.md)|[marshaling](../../../docs/framework/debug-trace-profile/marshaling-mda.md)|  
+|[memberInfoCacheCreation](../../../docs/framework/debug-trace-profile/memberinfocachecreation-mda.md)|[moduloObjectHashcode](../../../docs/framework/debug-trace-profile/moduloobjecthashcode-mda.md)|  
+|[nonComVisibleBaseClass](../../../docs/framework/debug-trace-profile/noncomvisiblebaseclass-mda.md)|[notMarshalable](../../../docs/framework/debug-trace-profile/notmarshalable-mda.md)|  
+|[openGenericCERCall](../../../docs/framework/debug-trace-profile/opengenericcercall-mda.md)|[overlappedFreeError](../../../docs/framework/debug-trace-profile/overlappedfreeerror-mda.md)|  
+|[pInvokeLog](../../../docs/framework/debug-trace-profile/pinvokelog-mda.md)|[pInvokeStackImbalance](../../../docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md)|  
+|[raceOnRCWCleanup](../../../docs/framework/debug-trace-profile/raceonrcwcleanup-mda.md)|[reentrancy](../../../docs/framework/debug-trace-profile/reentrancy-mda.md)|  
+|[releaseHandleFailed](../../../docs/framework/debug-trace-profile/releasehandlefailed-mda.md)|[reportAvOnComRelease](../../../docs/framework/debug-trace-profile/reportavoncomrelease-mda.md)|  
+|[streamWriterBufferedDataLost](../../../docs/framework/debug-trace-profile/streamwriterbuffereddatalost-mda.md)|[virtualCERCall](../../../docs/framework/debug-trace-profile/virtualcercall-mda.md)|  
+  
+ 既定では、.NET Framework はすべてのマネージ デバッガーに対して MDA のサブセットをアクティブにします。  Visual Studio で既定のセットを表示するには、**\[デバッグ\]** メニューの **\[例外\]** をクリックし、**\[マネージ デバッグ アシスタント\]** の一覧を展開します。  
+  
+## MDA の有効化と無効化  
+ MDA は、レジストリ キー、環境変数、およびアプリケーション構成設定を使用して有効または無効にできます。  アプリケーション構成設定を使用するには、レジストリ キーまたは環境変数を有効にする必要があります。  
+  
+ Visual Studio 2005 以降のバージョンでは、ホスティング プロセスが有効な場合、既定のセットに含まれている MDA を無効にしたり、既定のセットに含まれていない MDA を有効にしたりはできません。  ホスティング プロセスは既定で有効になるため、明示的に無効にする必要があります。  
+  
+ Visual Studio でホスティング プロセスを無効にするには、次の操作を行います。  
+  
+1.  **ソリューション エクスプローラー**でプロジェクトを選択します。  
+  
+2.  **\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+     **\[プロジェクト デザイナー\]** ウィンドウが表示されます。  
+  
+3.  **\[デバッグ\]** タブをクリックします。  
+  
+4.  **\[デバッガーを有効にする\]** セクションで、**\[Visual Studio ホスティング プロセスを有効にする\]** チェック ボックスをオフにします。  
+  
+ ただし、ホスティング プロセスを無効にすると、パフォーマンスに影響する場合があります。  Visual Studio で、MDA 通知を受け取ったときに MDA ダイアログ ボックスが表示されないようにすると、MDA を無効にする必要がありません。  そのためには、**\[デバッグ\]** メニューの **\[例外\]** をクリックし、**\[マネージ デバッグ アシスタント\]** の一覧を展開し、個々の MDA に対して **\[スローされるとき\]** チェック ボックスをオフにします。  
+  
+### レジストリ キーを使用した MDA の有効化と無効化  
+ MDA を有効にするには、Windows レジストリに HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework\\MDA サブキー \(REG\_SZ 型、値 1\) を追加します。  MDAEnable.reg という名前のテキスト ファイルに次の例をコピーします。  Windows レジストリ エディター \(RegEdit.exe\) を開き、**\[ファイル\]** メニューで **\[インポート\]** を選択します。  MDAEnable.reg ファイルを選択します。そのコンピューターで MDA が有効になります。  サブキーを \(DWARD 値 1 ではなく\) 文字列値 1 に設定すると、*ApplicationName.suffix*.mda.config ファイルから MDA の設定を読み取れるようになります。  \(たとえばメモ帳の MDA 構成ファイルは notepad.exe.mda.config になります\)  
+  
+```  
+Windows Registry Editor Version 5.00  
+  
+[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework]  
+"MDA"="1"  
+  
+```  
+  
+ 64 ビット オペレーティング システム上で 32 ビット アプリケーションを実行しているコンピューターでは、MDA キーは次のように設定します。  
+  
+```  
+Windows Registry Editor Version 5.00   
+  
+[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework]  
+"MDA"="1"  
+  
+```  
+  
+ 詳細については、「[アプリケーション固有の構成設定を使用した MDA の有効化と無効化](#appConfig)」を参照してください。  レジストリ設定は、COMPLUS\_MDA 環境変数でオーバーライドできます。  詳細については、「[環境変数を使用した MDA の有効化と無効化](#envVariable)」を参照してください。  
+  
+ MDA を無効にするには、Windows レジストリ エディターを使用して MDA サブキーを 0 \(ゼロ\) に設定します。  
+  
+ MDA には、レジストリ キーを追加しなくても、デバッガーにアタッチされているアプリケーションを実行すると既定で有効になるものがあります。  このようなアシスタントには、[pInvokeStackImbalance](../../../docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md) や [invalidApartmentStateChange](../../../docs/framework/debug-trace-profile/invalidapartmentstatechange-mda.md) などがあります。  これらのアシスタントを無効にするには、このセクションの前述の説明に従って MDADisable.reg ファイルを実行します。  
+  
+<a name="envVariable"></a>   
+### 環境変数を使用した MDA の有効化と無効化  
+ MDA のアクティブ化は、COMPLUS\_MDA 環境変数によって制御することもできます。この環境変数はレジストリ キーをオーバーライドします。  COMPLUS\_MDA の文字列は、MDA 名やその他の特殊制御文字列の、セミコロンで区切られたリストで、大文字小文字の区別はありません。  マネージ デバッガーやアンマネージ デバッガーの下で起動すると、MDA のセットが既定で有効になります。  そのためには、デバッガーの下で既定で有効にする MDA のリスト \(セミコロン区切り\) を、環境変数またはレジストリ キーの値の前に暗黙的に付加します。  特殊制御文字列は次のとおりです。  
+  
+-   `0` \- すべての MDA を非アクティブにします。  
+  
+-   `1` \- *ApplicationName*.mda.config から MDA の設定を読み取ります。  
+  
+-   `managedDebugger` \- デバッガーの下でマネージ実行可能ファイルを起動すると、暗黙的にアクティブ化されているすべての MDA が明示的にアクティブ化されます。  
+  
+-   `unmanagedDebugger` \- デバッガーの下でアンマネージ実行可能ファイルを起動すると、暗黙的にアクティブ化されているすべての MDA が明示的にアクティブ化されます。  
+  
+ 競合する設定がある場合は、最新の設定が以前の設定を次のようにオーバーライドします。  
+  
+-   `COMPLUS_MDA=0` は、デバッガーの下で暗黙的に有効化されている MDA を含め、すべての MDA を無効にします。  
+  
+-   `COMPLUS_MDA=gcUnmanagedToManaged` は、デバッガーの下で暗黙的に有効化される MDA に加えて `gcUnmanagedToManaged` も有効にします。  
+  
+-   `COMPLUS_MDA=0;gcUnmanagedToManaged` は `gcUnmanagedToManaged` を有効にしますが、デバッガーの下で別途暗黙的に有効化されている MDA を無効にします。  
+  
+<a name="appConfig"></a>   
+### アプリケーション固有の構成設定を使用した MDA の有効化と無効化  
+ アプリケーションの MDA 構成ファイルでは、一部のアシスタントを個別に有効化、無効化、および構成できます。  MDA を構成する目的でアプリケーション構成ファイルの使用を有効にするには、MDA レジストリ キーまたは COMPLUS\_MDA 環境変数を設定する必要があります。  アプリケーション構成ファイルは、通常、アプリケーションの実行可能ファイル \(.exe\) と同じディレクトリに置かれます。  このファイル名の形式は、*ApplicationName*.mda.config です \(notepad.exe.mda.config など\)。  アプリケーション構成ファイルで有効にされたアシスタントには、そのアシスタントの動作を制御するために特別にデザインされた属性や要素が存在する場合があります。  [marshaling](../../../docs/framework/debug-trace-profile/marshaling-mda.md) を有効化して設定する方法を次の例に示します。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <marshaling>  
+      <methodFilter>  
+        <match name="*"/>  
+      </methodFilter>  
+      <fieldFilter>  
+        <match name="*"/>  
+      </fieldFilter>  
+    </marshaling>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+ `Marshaling` MDA では、アプリケーションでのマネージ コードからアンマネージ コードへの遷移ごとに、アンマネージ型にマーシャリングされるマネージ型についての情報が出力されます。  また、`Marshaling` MDA では、`<methodFilter>` 子要素と `<fieldFilter>` 子要素でそれぞれ指定されたメソッドと構造体フィールドの名前をフィルター処理できます。  
+  
+ 既定の設定を使用して複数の MDA を有効にする方法を次の例に示します。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <illegalPrepareConstrainedRegion />  
+    <invalidCERCall />  
+    <openGenericCERCall />  
+    <virtualCERCall />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+> [!IMPORTANT]
+>  構成ファイルに複数のアシスタントを指定する場合は、アルファベット順に記述する必要があります。  たとえば、`virtualCERCall` MDA と `invalidCERCall` MDA の両方を有効にする場合は、`<invalidCERCall />` エントリ、`<virtualCERCall />` エントリの順に追加する必要があります。  エントリがアルファベット順になっていない場合、ハンドルされない無効な構成ファイルであることを示す例外メッセージが表示されます。  
+  
+### MDA の出力  
+ MDA の出力例を次に示します。この例は、`pInvokeStackImbalance` MDA の出力を示しています。  
+  
+ `A call to PInvoke function 'MDATest!MDATest.Program::StdCall' has unbalanced the stack.  This is likely because the managed PInvoke signature does not match the unmanaged target signature.  Check that the calling convention and parameters of the PInvoke signature match the target unmanaged signature.`  
+  
+## 参照  
+ [Debugging, Tracing, and Profiling](../../../docs/framework/debug-trace-profile/index.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/dirtycastandcalloninterface-mda.md b/docs/framework/debug-trace-profile/dirtycastandcalloninterface-mda.md
new file mode 100644
index 00000000000..8937bec7369
--- /dev/null
+++ b/docs/framework/debug-trace-profile/dirtycastandcalloninterface-mda.md
@@ -0,0 +1,64 @@
+---
+title: "dirtyCastAndCallOnInterface MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "managed debugging assistants (MDAs), early bound calls AutoDispatch"
+  - "dispatch-only mode"
+  - "dirtyCastAndCallOnInterface"
+  - "early-bound managed classes"
+  - "early bound calls on AutoDispatch"
+  - "MDAs (managed debugging assistants), early bound calls AutoDispatch"
+  - "EarlyBoundCallOnAutorDispatchClassInteface MDA"
+ms.assetid: aa388ed3-7e3d-48ea-a0b5-c47ae19cec38
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# dirtyCastAndCallOnInterface MDA
+`dirtyCastAndCallOnInterface` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、vtable を使用して事前バインディングされた呼び出しが、遅延バインディング専用とマークされたクラス インターフェイスで試行されたときにアクティブ化されます。  
+  
+## 症状  
+ COM 経由で CLR への事前バインディングされた呼び出しが実行されると、アプリケーションはアクセス違反をスローするか、予期しない動作に発生します。  
+  
+## 原因  
+ コードは、遅延バインディング専用のクラス インターフェイス経由で、vtable を使用して事前バインディングされた呼び出しを試行しています。  既定では、クラス インターフェイスは遅延バインディング専用として識別されることに注意してください。  また、<xref:System.Runtime.InteropServices.ClassInterfaceAttribute> 属性に <xref:System.Runtime.InteropServices.ClassInterfaceType> 値 \(`[ClassInterface(ClassInterfaceType.AutoDispatch)]`\) が設定されている場合も、遅延バインディングとして識別されます。  
+  
+## 解決策  
+ 推奨される解決策としては、COM で使用するための明示的なインターフェイスを定義し、自動生成されるクラス インターフェイスを通してではなく、このインターフェイスを通して、COM クライアント呼び出しを実行するようにする方法があります。  代わりに、`IDispatch` を介して、COM からの呼び出しを遅延バインディングされた呼び出しに変換することもできます。  
+  
+ 事前バインディングされた呼び出しを COM から実行できるように、クラスを <xref:System.Runtime.InteropServices.ClassInterfaceType> \(`[ClassInterface(ClassInterfaceType.AutoDual)]`\) として識別することもできます。ただし、「<xref:System.Runtime.InteropServices.ClassInterfaceAttribute>」に記載されているバージョン管理の制約から、<xref:System.Runtime.InteropServices.ClassInterfaceType> を使用しないことを強く推奨します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  遅延バインディングされたインターフェイス上の事前バインディングされた呼び出しに関するデータを報告するだけです。  
+  
+## 出力  
+ 事前バインディングでアクセスされたメソッド名またはフィールド名です。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <dirtyCastAndCallOnInterface />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.ClassInterfaceAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/disconnectedcontext-mda.md b/docs/framework/debug-trace-profile/disconnectedcontext-mda.md
new file mode 100644
index 00000000000..f2536319b57
--- /dev/null
+++ b/docs/framework/debug-trace-profile/disconnectedcontext-mda.md
@@ -0,0 +1,62 @@
+---
+title: "disconnectedContext MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "DisconnectedContext MDA"
+  - "MDAs (managed debugging assistants), disconnected context"
+  - "dead context"
+  - "transitioning disconnected apartment or context"
+  - "context disconnections"
+  - "managed debugging assistants (MDAs), disconnected context"
+ms.assetid: 1887d31d-7006-4491-93b3-68fd5b05f71d
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# disconnectedContext MDA
+CLR が COM オブジェクトに関する要求を処理中に、切断しているアパートメントまたはコンテキストに遷移しようとすると、`disconnectedContext` マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+## 症状  
+ [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW\) に対する呼び出しは、その呼び出しが存在する COM コンポーネントではなく、現在のアパートメントまたはコンテキスト内の基になる COM コンポーネントへ送られます。  シングル スレッド アパートメント \(STA\) コンポーネントのように、COM コンポーネントがマルチスレッド化されていない場合、これが原因で破損やデータ損失が発生する可能性があります。  あるいは RCW 自体がプロキシである場合、呼び出しの結果として <xref:System.Runtime.InteropServices.COMException> がスローされ、HRESULT が RPC\_E\_WRONG\_THREAD になる可能性があります。  
+  
+## 原因  
+ OLE アパートメントまたはコンテキストは、CLR が遷移を試行しようとしたときに、既にシャットダウンしています。  ほとんどの場合これは、STA アパートメントが所有するすべての COM コンポーネントが完全に解放される前に、それらの STA アパートメントがシャットダウンしたことが原因で発生します。また、RCW でユーザー コードからの明示的な呼び出しが実行された結果として発生することや、CLR 自体が COM コンポーネントを操作している場合 \(たとえば関連する RCW がガーベージ コレクションされているのに CRL が COM コンポーネントを解放する場合など\) にも発生する可能性があります。  
+  
+## 解決策  
+ この問題を回避するには、アプリケーションがアパートメントに存在するすべてのオブジェクトの処理を完了する前に、STA を所有するスレッドが強制終了しないようにします。  コンテキストの場合も同様に、アプリケーションがコンテキスト内部に存在するすべての COM コンポーネントの処理を完了するまでは、コンテキストがシャットダウンしないようにします。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  接続していないコンテキストに関するデータを報告するだけです。  
+  
+## 出力  
+ 非接続アパートメントまたはコンテキストのコンテキスト Cookie を報告します。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <disconnectedContext />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/dllmainreturnsfalse-mda.md b/docs/framework/debug-trace-profile/dllmainreturnsfalse-mda.md
new file mode 100644
index 00000000000..41f4541fef7
--- /dev/null
+++ b/docs/framework/debug-trace-profile/dllmainreturnsfalse-mda.md
@@ -0,0 +1,58 @@
+---
+title: "dllMainReturnsFalse MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "managed debugging assistants (MDAs), DllMain returns false"
+  - "DllMainReturnsFalse MDA"
+  - "DllMain function"
+  - "MDAs (managed debugging assistants), DllMain returns false"
+ms.assetid: e2abdd04-f571-4b97-8c16-2221b8588429
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# dllMainReturnsFalse MDA
+`dllMainReturnsFalse` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、ユーザー アセンブリのマネージ `DllMain` 関数が DLL\_PROCESS\_ATTACH という理由で呼び出され、FALSE を返した場合にアクティブ化されます。  
+  
+## 症状  
+ `DllMain` 関数が FALSE を返し、適切に実行されなかったことを示します。  通常、`DllMain` 関数には重要な初期化コードが含まれているため、これにより非決定性の問題が生じることがあります。  
+  
+## 原因  
+ 読み込み時にDLL 初期化で、`DllMain` 関数が理由 DLL\_PROCESS\_ATTACH で呼び出されました。  FALSE が返された場合、DLL 初期化に失敗したことを表します。  
+  
+## 解決策  
+ 失敗した DLL の `DllMain` 関数のコードを分析し、初期化エラーの原因を特定します。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  `DllMain` の戻り値に関するデータを報告するだけです。  
+  
+## 出力  
+ 理由 DLL\_PROCESS\_ATTACH で呼び出された `DllMain` 関数が FALSE を返したことを示すメッセージです。  この MDA は、`DllMain` がマネージ コードで実装されている場合だけ、アクティブ化されます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <dllMainReturnsFalse />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/enabling-jit-attach-debugging.md b/docs/framework/debug-trace-profile/enabling-jit-attach-debugging.md
new file mode 100644
index 00000000000..8d8eb5499b2
--- /dev/null
+++ b/docs/framework/debug-trace-profile/enabling-jit-attach-debugging.md
@@ -0,0 +1,51 @@
+---
+title: "Enabling JIT-Attach Debugging | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "JIT-attach debugging"
+  - "debugging [.NET Framework], JIT-attach debugging"
+ms.assetid: f91fc5f7-de5a-4f23-b6ac-f450e63c662e
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Enabling JIT-Attach Debugging
+JIT アタッチ デバッグとは、エラーが発生したときにデバッガーをプロセスにアタッチすることを記述するために使用される用語です。特定のメソッドまたは関数によって開始することもできます。  
+  
+ JIT アタッチ デバッグは、次のエラー条件下で使用されます。  
+  
+-   \(ネイティブ コードとマネージ コードの両方での\) 未処理の例外。  
+  
+-   <xref:System.Environment.FailFast%2A?displayProperty=fullName> の メソッドまたは [RaiseFailFastException](http://go.microsoft.com/fwlink/?LinkId=182107) 関数 \(Windows 7 ファミリ\)。  
+  
+-   ランタイムの致命的エラー。  
+  
+ JIT アタッチ デバッグは、次のメソッドと関数を呼び出すことでも開始できます。  
+  
+-   <xref:System.Diagnostics.Debugger.Launch%2A?displayProperty=fullName> メソッド  
+  
+-   <xref:System.Diagnostics.Debugger.Break%2A?displayProperty=fullName> メソッド  
+  
+-   [Debugbreak](http://go.microsoft.com/fwlink/?LinkId=182106) 関数 \(Win32\)。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以前は、.NET Framework では、ネイティブ デバッガーとマネージ デバッガーの動作を制御するのに別々のレジストリ キーを提供していました。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降、制御は、HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\Current Version\\AeDebug という単一のレジストリ キーに統合されました。  このキーに設定する値によってデバッガーを呼び出すかどうかを決定できます。呼び出す場合は、ユーザーによる操作が必要なダイアログ ボックスを表示するかどうかを決定できます。  このレジストリ キーの設定に関する詳細については、[設定の自動デバッグ](http://go.microsoft.com/fwlink/?LinkId=181767) MSDN ライブラリを参照してください。  
+  
+## 参照  
+ [Debugging, Tracing, and Profiling](../../../docs/framework/debug-trace-profile/index.md)   
+ [イメージのデバッグの簡略化](../../../docs/framework/debug-trace-profile/making-an-image-easier-to-debug.md)   
+ [Enabling Profiling](http://msdn.microsoft.com/ja-jp/3b669676-f0e0-4ebf-8674-68986dd2020d)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/enhancing-debugging-with-the-debugger-display-attributes.md b/docs/framework/debug-trace-profile/enhancing-debugging-with-the-debugger-display-attributes.md
new file mode 100644
index 00000000000..e99629791b3
--- /dev/null
+++ b/docs/framework/debug-trace-profile/enhancing-debugging-with-the-debugger-display-attributes.md
@@ -0,0 +1,114 @@
+---
+title: "Enhancing Debugging with the Debugger Display Attributes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "debugger, display attributes"
+  - "DebuggerTypeProxyAttribute attribute"
+  - "debugging [.NET Framework], debugger display attributes"
+  - "DebuggerDisplayAttribute attribute"
+  - "display attributes for debugger"
+  - "DebuggerBrowsableAttribute attribute"
+ms.assetid: 72bb7aa9-459b-42c4-9163-9312fab4c410
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Enhancing Debugging with the Debugger Display Attributes
+デバッガー表示属性を使用すると、開発した型の実行時の動作を指定し、その動作を最もよく理解している開発者が、その型がデバッガーに表示されるときの表示形式を指定することもできます。  さらに、`Target` プロパティを提供するデバッガー表示属性は、ソース コードに関する知識を持たないユーザーがアセンブリ レベルで適用できます。  <xref:System.Diagnostics.DebuggerDisplayAttribute> 属性では、デバッガーの変数ウィンドウでの型やメンバーの表示形式を制御できます。  <xref:System.Diagnostics.DebuggerBrowsableAttribute> 属性では、デバッガーの変数ウィンドウでフィールドやプロパティを表示するかどうか、またその表示形式を決定できます。  <xref:System.Diagnostics.DebuggerTypeProxyAttribute> 属性では、型の代替型つまりプロキシを指定し、デバッガー ウィンドウでの型の表示形式を変更できます。  プロキシ \(代替型\) を指定した変数を表示すると、元の型の代わりにプロキシがデバッガー表示ウィンドウに表示されます。デバッガーの変数ウィンドウには、プロキシ型のパブリック メンバーのみが表示されます。  プライベート メンバーは表示されません。  
+  
+## DebuggerDisplayAttribute の使用  
+ <xref:System.Diagnostics.DebuggerDisplayAttribute.%23ctor%2A> コンストラクターの引数は 1 つです。この引数は、型のインスタンスの値列に表示される文字列です。  この文字列には、中かっこ \({ と }\) を含めることができます。  中かっこで囲まれたテキストは、式として評価されます。  たとえば、次の C\# コードでは、正符号 \(\+\) を選択して `MyHashtable` のインスタンスのデバッガー表示を拡張すると "Count \= 4" が表示されます。  
+  
+```  
+[DebuggerDisplay("Count = {count}")]  
+class MyHashtable  
+{  
+    public int count = 4;  
+}  
+```  
+  
+ 式で参照されるプロパティに適用されている属性は処理されません。  C\# コンパイラでは、対象型の現在のインスタンスについて、このような参照に暗黙的にのみアクセスできる一般的な式を使用できます。  この式には制限があり、エイリアス、ローカル、またはポインターへはアクセスできません。  C\# コードでは、対象型の現在のインスタンスのみについて、`this` ポインターに暗黙的にアクセスできる一般的な式を中かっこに囲んで使用できます。  
+  
+ たとえば、C\# オブジェクトにオーバーライドされた `ToString()` がある場合、デバッガーはそのオーバーライドを呼び出し、標準的な `{<typeName>}.` タグ内のピリオド削除ではなくオーバーライドの結果を表示します。そのため、オーバーライドされた `ToString()` がある場合、<xref:System.Diagnostics.DebuggerDisplayAttribute> を使用する必要はありません。  両方を使用すると、<xref:System.Diagnostics.DebuggerDisplayAttribute> 属性が `ToString()` オーバーライドよりも優先されます。  
+  
+## DebuggerBrowsableAttribute の使用  
+ デバッガー ウィンドウに表示されるフィールドやプロパティの表示形式を指定するには、<xref:System.Diagnostics.DebuggerBrowsableAttribute> をフィールドまたはプロパティに適用します。  この属性のコンストラクターは、<xref:System.Diagnostics.DebuggerBrowsableState> 列挙値のいずれかを受け取ります。この列挙値は、次のいずれかの状態を指定します。  
+  
+-   <xref:System.Diagnostics.DebuggerBrowsableState> は、メンバーがデータ ウィンドウに表示されないことを示します。たとえば、フィールドの <xref:System.Diagnostics.DebuggerBrowsableAttribute> にこの値を使用すると、そのフィールドは階層から削除され、型インスタンスの正符号 \(\+\) をクリックして外側の型を展開しても表示されません。  
+  
+-   <xref:System.Diagnostics.DebuggerBrowsableState> は、既定で、メンバーは表示され、展開されないことを示します。これが既定の動作です。  
+  
+-   <xref:System.Diagnostics.DebuggerBrowsableState> は、メンバー自体は表示されず、そのメンバーが配列やコレクションの場合、その内在オブジェクトが表示されることを示します。  
+  
+> [!NOTE]
+>  <xref:System.Diagnostics.DebuggerBrowsableAttribute> は、.NET Framework Version 2.0 の Visual Basic ではサポートされません。  
+  
+ <xref:System.Diagnostics.DebuggerBrowsableAttribute> を使用して、後続のプロパティがクラスのデバッグ ウィンドウに表示されないようにするコード例を次に示します。  
+  
+```  
+[DebuggerBrowsable(DebuggerBrowsableState.Never)]  
+public static string y = "Test String";  
+```  
+  
+## DebuggerTypeProxy の使用  
+ 型のデバッグ ビューを大幅に変更しても、型自体を変更しないときは、<xref:System.Diagnostics.DebuggerTypeProxyAttribute> 属性を使用します。  <xref:System.Diagnostics.DebuggerTypeProxyAttribute> 属性は、型の表示プロキシを指定して、開発者が型のビューを調整できるようにする場合に使用します。<xref:System.Diagnostics.DebuggerDisplayAttribute> と同様に、この属性はアセンブリ レベルで使用できます。その場合、<xref:System.Diagnostics.DebuggerTypeProxyAttribute.Target%2A> プロパティで、プロキシを使用する型を指定します。  この属性は、その適用先の型内で発生する入れ子にされたプライベート型を指定するために使用することをお勧めします。型ビューアーをサポートする式エバリュエーターは、型が表示されるときにこの属性をチェックします。  属性が存在する場合、式エバリュエーターは属性の適用対象の型の代わりに表示プロキシ型を使用します。  
+  
+ <xref:System.Diagnostics.DebuggerTypeProxyAttribute> が存在する場合、デバッガー変数ウィンドウにはプロキシ型のパブリック メンバーのみが表示されます。  プライベート メンバーは表示されません。  データ ウィンドウの動作は、属性拡張ビューによって変更されません。  
+  
+ パフォーマンスへの不必要な影響を避けるために、表示プロキシの属性は、データ ウィンドウ内の型の横にある正符号 \(\+\) をユーザーがクリックするか、または <xref:System.Diagnostics.DebuggerBrowsableAttribute> 属性を適用することによってオブジェクトが展開されるまで処理されません。  したがって、表示型に属性を適用しないことをお勧めします。  属性は表示型の本体内で適用できるようにします。  
+  
+ <xref:System.Diagnostics.DebuggerTypeProxyAttribute> を使用して、デバッガー表示プロキシとして使用する型を指定するコード例を次に示します。  
+  
+```  
+  
+[DebuggerTypeProxy(typeof(HashtableDebugView))]  
+class MyHashtable : Hashtable  
+{  
+    private const string TestString =   
+        "This should not appear in the debug window.";  
+  
+    internal class HashtableDebugView  
+    {  
+        private Hashtable hashtable;  
+        public const string TestStringProxy =   
+            "This should appear in the debug window.";  
+  
+        // The constructor for the type proxy class must have a   
+        // constructor that takes the target type as a parameter.  
+        public HashtableDebugView(Hashtable hashtable)  
+        {  
+            this.hashtable = hashtable;  
+        }  
+    }  
+}  
+```  
+  
+## 例  
+  
+### 説明  
+ 次のコード例を [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] で表示すると、<xref:System.Diagnostics.DebuggerDisplayAttribute>、<xref:System.Diagnostics.DebuggerBrowsableAttribute>、<xref:System.Diagnostics.DebuggerTypeProxyAttribute> の各属性の適用結果を確認できます。  
+  
+### コード  
+ [!code-cpp[System.Diagnostics.DebuggerBrowsableAttribute#1](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Diagnostics.DebuggerBrowsableAttribute/cpp/program.cpp#1)]
+ [!code-csharp[System.Diagnostics.DebuggerBrowsableAttribute#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Diagnostics.DebuggerBrowsableAttribute/CS/program.cs#1)]
+ [!code-vb[System.Diagnostics.DebuggerBrowsableAttribute#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Diagnostics.DebuggerBrowsableAttribute/VB/module1.vb#1)]  
+  
+## 参照  
+ <xref:System.Diagnostics.DebuggerDisplayAttribute>   
+ <xref:System.Diagnostics.DebuggerBrowsableAttribute>   
+ <xref:System.Diagnostics.DebuggerTypeProxyAttribute>
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/exceptionswallowedoncallfromcom-mda.md b/docs/framework/debug-trace-profile/exceptionswallowedoncallfromcom-mda.md
new file mode 100644
index 00000000000..375db92a511
--- /dev/null
+++ b/docs/framework/debug-trace-profile/exceptionswallowedoncallfromcom-mda.md
@@ -0,0 +1,62 @@
+---
+title: "exceptionSwallowedOnCallFromCom MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "messages, informational"
+  - "informational messages"
+  - "managed debugging assistants (MDAs), exceptions"
+  - "exception handling, managed debugging assistants"
+  - "MDAs (managed debugging assistants), exceptions"
+  - "ExceptionSwallowedOnCallFromCOM MDA"
+ms.assetid: 55d6ab12-f251-4aab-aa64-aacbe9d9f974
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# exceptionSwallowedOnCallFromCom MDA
+アンマネージ HRESULT 戻り値型を持たないメソッドを介して COM から呼び出された 共通言語ランタイム \(CLR\) コードから、例外がスローされると、`exceptionSwallowedOnCallFromCOM` マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+## 症状  
+ COM からマネージ コンポーネントを呼び出すと、値 FALSE または 0 が返されます。  あるいは、メソッドの戻り値の型が void の場合、メソッド実行中に例外がスローされたという通知がない可能性があります。  この場合、例外は自動的にキャッチされ、COM 呼び出し元に実行が戻ります。  
+  
+## 原因  
+ 例外がスローされましたが、それを報告する有効な方法がありません。  
+  
+## 解決策  
+ 情報提供専用です。必ずしもバグを示すものではありません。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  自動的にキャッチされた例外を報告するだけです。  
+  
+## 出力  
+ メソッド名、型名、例外メッセージが含まれている情報メッセージ。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <exceptionSwallowedOnCallFromCom />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/failedqi-mda.md b/docs/framework/debug-trace-profile/failedqi-mda.md
new file mode 100644
index 00000000000..71ac0f61b76
--- /dev/null
+++ b/docs/framework/debug-trace-profile/failedqi-mda.md
@@ -0,0 +1,66 @@
+---
+title: "failedQI MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "failed QueryInterface"
+  - "FailedQI MDA"
+  - "QueryInterface call failures"
+  - "MDAs (managed debugging assistants), failed QueryInterface"
+  - "managed debugging assistants (MDAs), failed QueryInterface"
+ms.assetid: 902dc863-34b3-477c-b433-b8a6bb6133c6
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# failedQI MDA
+`failedQI` マネージ デバッグ アシスタント \(MDA: Managed Debugging Asssitant\) は、ランタイムがランタイム呼び出し可能ラッパー \(RCW: Runtime Callable Wrapper\) の代わりに COM インターフェイス ポインター上の `QueryInterface` を呼び出し、その `QueryInterface` 呼び出しに失敗するとアクティブ化されます。  
+  
+## 症状  
+ RCW でのキャストに失敗します。または、RCW からの COM 呼び出しが予期せず失敗します。  
+  
+## 原因  
+  
+-   正しくないコンテキストから呼び出しが実行されました。  
+  
+-   呼び出しが正しくないコンテキストで試行されたため、登録されたプロキシが `QueryInterface` 呼び出しに失敗しています。  
+  
+-   OLE 所有のプロキシがエラー HRESULT を返しました。  
+  
+## 解像度  
+ COM 規則についての MSDN ドキュメントを参照してください。  
+  
+## ランタイムへの影響  
+ `QueryInterface` 呼び出しに失敗すると、コンテキストが切り替えられ、エラー時に正しくないコンテキストであったことを確認するために、`QueryInterface` 呼び出しが再試行されます。  
+  
+## 出力  
+ インターフェイスのマネージ名、インターフェイスの GUID、およびエラー HRESULT です。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <failedQI/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/fatalexecutionengineerror-mda.md b/docs/framework/debug-trace-profile/fatalexecutionengineerror-mda.md
new file mode 100644
index 00000000000..8d614a09a97
--- /dev/null
+++ b/docs/framework/debug-trace-profile/fatalexecutionengineerror-mda.md
@@ -0,0 +1,89 @@
+---
+title: "fatalExecutionEngineError MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "corrupted CLR"
+  - "fatal execution error"
+  - "terminated processes"
+  - "unexpected terminations"
+  - "fatal errors"
+  - "MDAs (managed debugging assistants), fatal errors"
+  - "process termination"
+  - "FatalExecutionEngineError MDA"
+  - "managed debugging assistants (MDAs), fatal errors"
+ms.assetid: 8b559e44-2393-4e4e-8160-7558d37a4a89
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# fatalExecutionEngineError MDA
+`fatalExecutionEngine` `Error` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、共通言語ランタイム \(CLR: Common Language Runtime\) で致命的なエラーが検出されたときにアクティブ化されます。  プロセスは終了します。  
+  
+## 症状  
+ 予期しないプロセス終了が発生します。  CLR エラーはさまざまな理由で発生する可能性があるため、その他の症状は特定できません。  
+  
+## 原因  
+ CLR は、致命的に破損しています。  これはほとんどの場合、データ破損が原因です。データ破損は、不適切なプラットフォーム呼び出し関数を呼び出したり、CLR に無効なデータを渡すなど、さまざまな問題によって起こる場合があります。  
+  
+## 解決策  
+ 追加の MDA を有効にすると、問題の特定に役立つ場合があります。  この問題を診断するために特に役立つ可能性のある MDA を次に示します。  
+  
+-   [invalidOverlappedToPinvoke](../../../docs/framework/debug-trace-profile/invalidoverlappedtopinvoke-mda.md)  
+  
+-   [overlappedFreeError](../../../docs/framework/debug-trace-profile/overlappedfreeerror-mda.md)  
+  
+-   [pInvokeStackImbalance](../../../docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md)  
+  
+-   [gcUnmanagedToManaged](../../../docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md)  
+  
+-   [gcManagedToUnmanaged](../../../docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md)  
+  
+-   [callbackOnCollectedDelegate](../../../docs/framework/debug-trace-profile/callbackoncollecteddelegate-mda.md)  
+  
+-   [reportAvOnComRelease](../../../docs/framework/debug-trace-profile/reportavoncomrelease-mda.md)  
+  
+-   [invalidVariant](../../../docs/framework/debug-trace-profile/invalidvariant-mda.md)  
+  
+-   [invalidIUnknown](../../../docs/framework/debug-trace-profile/invalidiunknown-mda.md)  
+  
+-   [raceOnRCWCleanup](../../../docs/framework/debug-trace-profile/raceonrcwcleanup-mda.md)  
+  
+-   [invalidFunctionPointerInDelegate](../../../docs/framework/debug-trace-profile/invalidfunctionpointerindelegate-mda.md)  
+  
+-   [invalidGCHandleCookie](../../../docs/framework/debug-trace-profile/invalidgchandlecookie-mda.md)  
+  
+## ランタイムへの影響  
+ この MDA は、ランタイムの動作への影響はありません。  
+  
+## 出力  
+ 致命的なエラーの原因となった CLR 関数のアドレス、エラーの発生したスレッドの ID、およびエラー コードです。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <fatalExecutionEngineError />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A>   
+ <xref:System.Runtime.ConstrainedExecution.Cer>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md b/docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md
new file mode 100644
index 00000000000..2af11e4a8cf
--- /dev/null
+++ b/docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md
@@ -0,0 +1,66 @@
+---
+title: "gcManagedToUnmanaged MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), garbage collection"
+  - "GcManagedToUnmanaged MDA"
+  - "GC managed to unmanaged"
+  - "transitioning threads managed to unmanaged code"
+  - "threading [.NET Framework], garbage collection"
+  - "managed to unmanaged garbage collection"
+  - "managed debugging assistants (MDAs), garbage collection"
+  - "threading [.NET Framework], managed debugging assistants"
+  - "garbage collection, run-time errors"
+ms.assetid: 7417f837-805e-4fed-a430-ca919c8421dc
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# gcManagedToUnmanaged MDA
+`gcManagedToUnmanaged` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、スレッドがマネージ コードからアンマネージ コードに遷移する時に、毎回ガベージ コレクションがなされるようにします。  
+  
+## 症状  
+ アンマネージ ユーザー コンポーネントは、COM に公開されたマネージ オブジェクトを使おうとすると、アクセス違反をスローします。  COM オブジェクトはリリース済みのように表示されます。  アクセス違反は非確定です。  
+  
+## 原因  
+ アンマネージ コンポーネントがマネージ COM オブジェクトを正しくカウントする参照でない場合、ランタイムは、アンマネージ コンポーネントがオブジェクトへの参照を保持していると、COM に公開されたマネージ オブジェクトを収集できます。  ランタイムはガベージ コレクション中に <xref:System.Runtime.InteropServices.Marshal.Release%2A> を呼び出すので、ユーザー コンポーネントがガベージ コレクションの発生前にオブジェクトを使用すると、それは収集されないことになります。  これが非確定の原因です。  
+  
+## 解決策  
+ このアシスタントを有効にすると、オブジェクトが収集の対象になってから <xref:System.Runtime.InteropServices.Marshal.Release%2A> が呼び出されるまでの時間が短縮し、収集されるオブジェクトへのアクセスを最初に試みるアンマネージ コンポーネントの追跡に役立ちます。  
+  
+## ランタイムへの影響  
+ スレッドがマネージ コードからアンマネージ コードに遷移する時に、毎回ガベージ コレクションがなされるようになります。  
+  
+## 出力  
+ この MDA は、出力を生成しません。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <gcManagedToUnmanaged/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)   
+ [gcUnmanagedToManaged](../../../docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md b/docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md
new file mode 100644
index 00000000000..b74ef46b4bb
--- /dev/null
+++ b/docs/framework/debug-trace-profile/gcunmanagedtomanaged-mda.md
@@ -0,0 +1,66 @@
+---
+title: "gcUnmanagedToManaged MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), garbage collection"
+  - "GC unmanaged to managed"
+  - "transitioning threads unmanaged to managed code"
+  - "GcUnmanagedToManaged MDA"
+  - "threading [.NET Framework], garbage collection"
+  - "managed debugging assistants (MDAs), garbage collection"
+  - "threading [.NET Framework], managed debugging assistants"
+  - "garbage collection, run-time errors"
+  - "unmanaged to managed garbage collection"
+ms.assetid: 103eb3a3-1cf0-4406-8a9a-a7798fdc22d1
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# gcUnmanagedToManaged MDA
+`gcUnmanagedToManaged` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、スレッドがアンマネージ コードからマネージ コードに遷移する時に、毎回ガベージ コレクションが行われるようにします。  
+  
+## 症状  
+ COM およびプラットフォーム呼び出しを使用してアンマネージ ユーザー コンポーネントを実行中のアプリケーションによって、CLR で非確定的なアクセス違反が発生します。  
+  
+## 原因  
+ アプリケーションがアンマネージ ユーザー コンポーネントを実行中の場合、それらのコンポーネントによって、ガベージ コレクトされたヒープが破損された可能性があります。  これが原因で、ガベージ コレクターがオブジェクト グラフをウォークしようとしたときに、CLR でアクセス違反が発生します。  
+  
+## 解像度  
+ このアシスタントを有効にすると、各マネージ遷移の前にガベージ コレクションが必ず行われるようになるため、アンマネージ コンポーネントがガベージ コレクトされたヒープを破損してから、アクセス違反が発生するまでの時間が短縮されます。  
+  
+## ランタイムへの影響  
+ スレッドがアンマネージ コードからマネージ コードに遷移する時に、毎回ガベージ コレクションが行われるようになります。  
+  
+## 出力  
+ この MDA は、出力を生成しません。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <gcUnmanagedToManaged/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [gcManagedToUnmanaged](../../../docs/framework/debug-trace-profile/gcmanagedtounmanaged-mda.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md b/docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md
new file mode 100644
index 00000000000..91dc0670590
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md
@@ -0,0 +1,108 @@
+---
+title: "How to: Add Trace Statements to Application Code | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "tracing [.NET Framework], conditional writes based on switches"
+  - "trace statements"
+  - "WriteLineIf method"
+  - "tracing [.NET Framework], adding trace statements"
+  - "Assert method, tracing code"
+  - "trace switches, conditional writes based on switches"
+  - "WriteIf method"
+ms.assetid: f3a93fa7-1717-467d-aaff-393e5c9828b4
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# How to: Add Trace Statements to Application Code
+トレースで最も使用頻度の高いメソッドは、出力をリスナーに書き込むメソッドである **Write**、**WriteIf**、**WriteLine**、**WriteLineIf**、**Assert**、および **Fail** です。  これらのメソッドは、次の 2 つのカテゴリに分類できます。**Write**、**WriteLine**、および **Fail** は、すべての出力を無条件に生成します。それに対して、**WriteIf**、**WriteLineIf**、および **Assert** は、ブール条件をテストし、条件の値に基づいて出力を生成したり生成しなかったりします。  **WriteIf** と **WriteLineIf** は条件が `true` の場合に出力を生成し、**Assert** は条件が `false` の場合に出力を生成します。  
+  
+ トレースおよびデバッグの方法をデザインするときは、出力の表示方法について検討する必要があります。  複数の **Write**  ステートメントにより、関連のない情報が埋め尽くされたログが作成されると、それは読みにくいものになります。  その一方で、**WriteLine** を使用して関連のあるステートメントを別々の行に出力すると、どの情報が関連し合っているかを読み取るのが困難になります。  一般に、複数のソースからの情報を結合する場合には複数の **Write** ステートメントを使用して 1 つの情報メッセージを作成し、単一の完全なメッセージを作成する場合には **WriteLine** ステートメントを使用します。  
+  
+### 完結した行を書き込むには  
+  
+1.  <xref:System.Diagnostics.Trace.WriteLine%2A> メソッドまたは <xref:System.Diagnostics.Trace.WriteLineIf%2A> メソッドを呼び出します。  
+  
+     このメソッドが返すメッセージの末尾には、キャリッジ リターンが追加されます。したがって、次回の **Write**、**WriteIf**、**WriteLine**、または **WriteLineIf** が返すメッセージは、次の行から開始されます。  
+  
+    ```vb  
+    Dim errorFlag As Boolean = False  
+    Trace.WriteLine("Error in AppendData procedure.")  
+    Trace.WriteLineIf(errorFlag, "Error in AppendData procedure.")  
+  
+    ```  
+  
+    ```csharp  
+    bool errorFlag = false;  
+    System.Diagnostics.Trace.WriteLine ("Error in AppendData procedure.");  
+    System.Diagnostics.Trace.WriteLineIf(errorFlag,   
+       "Error in AppendData procedure.");  
+  
+    ```  
+  
+### 完結しない行を書き込むには  
+  
+1.  <xref:System.Diagnostics.Trace.Write%2A> メソッドまたは <xref:System.Diagnostics.Trace.WriteIf%2A> メソッドを呼び出します。  
+  
+     **Write**、**WriteIf**、**WriteLine**、または **WriteLineIf** によって次に書き込まれるメッセージは、今回の **Write** または **WriteIf** ステートメントによって書き込まれるメッセージと同じ行から開始されます。  
+  
+    ```vb  
+    Dim errorFlag As Boolean = False  
+    Trace.WriteIf(errorFlag, "Error in AppendData procedure.")  
+    Debug.WriteIf(errorFlag, "Transaction abandoned.")  
+    Trace.Write("Invalid value for data request")  
+  
+    ```  
+  
+    ```csharp  
+    bool errorFlag = false;  
+    System.Diagnostics.Trace.WriteIf(errorFlag,   
+       "Error in AppendData procedure.");  
+    System.Diagnostics.Debug.WriteIf(errorFlag, "Transaction abandoned.");  
+    Trace.Write("Invalid value for data request");  
+  
+    ```  
+  
+### メソッドの実行前または実行後に特定の条件が存在するかどうかを確認するには  
+  
+1.  <xref:System.Diagnostics.Trace.Assert%2A> メソッドを呼び出します。  
+  
+    ```vb  
+    Dim I As Integer = 4  
+    Trace.Assert(I = 5, "I is not equal to 5.")  
+  
+    ```  
+  
+    ```csharp  
+    int I = 4;  
+    System.Diagnostics.Trace.Assert(I == 5, "I is not equal to 5.");  
+  
+    ```  
+  
+    > [!NOTE]
+    >  **Assert** は、トレースとデバッグの両方で使用できます。  この例では、呼び出し履歴を **Listeners** コレクションのリスナーに出力しています。  詳細については、「[マネージ コードのアサーション](../Topic/Assertions%20in%20Managed%20Code.md)」および「<xref:System.Diagnostics.Debug.Assert%2A?displayProperty=fullName>」を参照してください。  
+  
+## 参照  
+ <xref:System.Diagnostics.Debug.WriteIf%2A?displayProperty=fullName>   
+ <xref:System.Diagnostics.Debug.WriteLineIf%2A?displayProperty=fullName>   
+ <xref:System.Diagnostics.Trace.WriteIf%2A?displayProperty=fullName>   
+ <xref:System.Diagnostics.Trace.WriteLineIf%2A?displayProperty=fullName>   
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)   
+ [How to: Create, Initialize and Configure Trace Switches](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)   
+ [Trace Switches](../../../docs/framework/debug-trace-profile/trace-switches.md)   
+ [Trace Listeners](../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md b/docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md
new file mode 100644
index 00000000000..30880aaf4a8
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md
@@ -0,0 +1,115 @@
+---
+title: "How to: Compile Conditionally with Trace and Debug | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "trace compiler options"
+  - "trace statements"
+  - "compiling source code, trace statements"
+  - "tracing [.NET Framework], enabling or disabling"
+  - "tracing [.NET Framework], compiling conditionally"
+  - "TRACE directive"
+  - "conditional compilation, tracing code"
+ms.assetid: 56d051c3-012c-42c1-9a58-7270edc624aa
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Compile Conditionally with Trace and Debug
+開発時にアプリケーションをデバッグするときは、トレース出力とデバッグ出力の両方が Visual Studio の \[出力\] ウィンドウに表示されます。  しかし、配置されるアプリケーションにトレース機能を組み込むには、**TRACE** コンパイラ ディレクティブを有効にして、インストルメント化されたアプリケーションをコンパイルする必要があります。  これにより、コンパイルされたアプリケーションのリリース バージョンに、トレース コードが組み込まれます。  **TRACE** ディレクティブを有効にしないと、コンパイル時にすべてのトレース コードが無視され、配置する実行可能コードに含まれなくなります。  
+  
+ トレース用のメソッドとデバッグ用のメソッドにはどちらも、関連付けられた条件属性があります。  たとえば、トレースの条件属性が **true** の場合は、すべてのトレース ステートメントがアセンブリ \(コンパイル済みの .exe ファイルや .dll ファイル\) に組み込まれます。また、**Trace** の条件属性が **false** の場合、トレース ステートメントはアセンブリに組み込まれません。  
+  
+ ビルドでは、**Trace** 条件属性と **Debug** 条件属性のどちらか一方をオンにすること、両方ともオンにすること、あるいは両方ともオフにすることのいずれも可能です。  つまり、**Debug** のみオン、**Trace** のみオン、両方ともオン、両方ともオフという、4 種類のビルド方法が存在します。  実際の配置用のリリース ビルドでは両方ともオフにする場合もありますが、大半のデバッグ ビルドでは両方ともオンにします。  
+  
+ アプリケーションのコンパイラ設定は、次に示すいくつかの方法で指定できます。  
+  
+-   プロパティ ページ  
+  
+-   コマンド ライン  
+  
+-   **\#CONST** \(Visual Basic の場合\) および **\#define** \(C\# の場合\)  
+  
+### プロパティ ページのダイアログ ボックスでコンパイル設定を変更するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクト ノードを右クリックします。  
+  
+2.  ショートカット メニューの **\[プロパティ\]** を選択します。  
+  
+    -   Visual Basic では、プロパティ ページの左ペインで **\[コンパイル\]** タブをクリックし、**\[詳細コンパイル オプション\]** ボタンをクリックして **\[コンパイラの詳細設定\]** ダイアログ ボックスを表示します。  有効にするコンパイラ設定のチェック ボックスをオンにします。  無効にする設定のチェック ボックスをオフにします。  
+  
+    -   C\# では、プロパティ ページの左ペインで **\[ビルド\]** タブをクリックし、有効にするコンパイラ設定のチェック ボックスをオンにします。  無効にする設定のチェック ボックスをオフにします。  
+  
+### インストルメント化されたコードをコマンド ラインを使用してコンパイルするには  
+  
+1.  コマンド ラインで、条件付きコンパイラ スイッチを設定します。  コンパイラにより、トレース コードまたはデバッグ コードが実行可能ファイルに組み込まれます。  
+  
+     たとえば、コマンド ラインで次のコンパイラ命令を入力すると、コンパイルされた実行可能ファイルにトレース コードが組み込まれます。  
+  
+     Visual Basic の場合: **vbc \/r:System.dll \/d:TRACE\=TRUE \/d:DEBUG\=FALSE MyApplication.vb**  
+  
+     C\# の場合: **csc \/r:System.dll \/d:TRACE \/d:DEBUG\=FALSE MyApplication.cs**  
+  
+    > [!TIP]
+    >  複数のアプリケーション ファイルをコンパイルするには、各ファイル名の間にスペースを 1 つ挿入します。たとえば、「**MyApplication1.vb MyApplication2.vb MyApplication3.vb**」または「**MyApplication1.cs MyApplication2.cs MyApplication3.cs**」とします。  
+  
+     上記の例で使用した条件付きコンパイルのディレクティブの意味は次のとおりです。  
+  
+    |ディレクティブ|説明|  
+    |-------------|--------|  
+    |`vbc`|Visual Basic コンパイラ|  
+    |`csc`|C\# コンパイラ|  
+    |`/r:`|外部アセンブリ \(EXE または DLL\) を参照します。|  
+    |`/d:`|条件付きコンパイル シンボルを定義します。|  
+  
+    > [!NOTE]
+    >  TRACE または DEBUG は大文字で入力する必要があります。  条件付きコンパイル コマンドの詳細情報を参照するには、コマンド プロンプトに `vbc /?` \(Visual Basic の場合\) または `csc /?` \(c\# の場合\) と入力します。  詳細については、「[コマンド ラインからのビルド](../Topic/How%20to:%20Set%20Environment%20Variables%20for%20the%20Visual%20Studio%20Command%20Line.md)」\(C\# の場合\) または「[コマンド ライン コンパイラの起動](../Topic/How%20to:%20Invoke%20the%20Command-Line%20Compiler%20\(Visual%20Basic\).md)」\(Visual Basic の場合\) を参照してください。  
+  
+### \#CONST または \#define を使用して条件付きコンパイルを実行するには  
+  
+1.  ソース コード ファイルの先頭に、使用するプログラミング言語に該当するステートメントを入力します。  
+  
+    |言語|ステートメント|結果|  
+    |--------|-------------|--------|  
+    |**Visual Basic**|**\#CONST TRACE \= true**|トレースを有効にします。|  
+    ||**\#CONST TRACE \= false**|トレースを無効にします。|  
+    ||**\#CONST DEBUG \= true**|デバッグを有効にします。|  
+    ||**\#CONST DEBUG \= false**|デバッグを無効にします。|  
+    |**C\#**|**\#define TRACE**|トレースを有効にします。|  
+    ||**\#undef TRACE**|トレースを無効にします。|  
+    ||**\#define DEBUG**|デバッグを有効にします。|  
+    ||**\#undef DEBUG**|デバッグを無効にします。|  
+  
+### トレースまたはデバッグを無効にするには  
+  
+1.  ソース コードからコンパイラ ディレクティブを削除します。  
+  
+     または  
+  
+2.  コンパイラ ディレクティブをコメント アウトします。  
+  
+    > [!NOTE]
+    >  コンパイルの準備が整ったら、**\[ビルド\]** メニューの **\[ビルド\]** を選択します。または、条件付きコンパイル シンボルを定義するための「**d:**」を入力せずにコマンド ライン メソッドを使用することもできます。  
+  
+## 参照  
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)   
+ [How to: Create, Initialize and Configure Trace Switches](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)   
+ [Trace Switches](../../../docs/framework/debug-trace-profile/trace-switches.md)   
+ [Trace Listeners](../../../docs/framework/debug-trace-profile/trace-listeners.md)   
+ [How to: Add Trace Statements to Application Code](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)   
+ [How to: Set Environment Variables for the Visual Studio Command Line](../Topic/How%20to:%20Set%20Environment%20Variables%20for%20the%20Visual%20Studio%20Command%20Line.md)   
+ [How to: Invoke the Command\-Line Compiler](../Topic/How%20to:%20Invoke%20the%20Command-Line%20Compiler%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners.md b/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners.md
new file mode 100644
index 00000000000..0b223ac203b
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners.md
@@ -0,0 +1,108 @@
+---
+title: "How to: Create and Initialize Trace Listeners | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "initializing trace listeners"
+  - "trace listeners, creating"
+  - "trace listeners, initializing"
+  - "tracing [.NET Framework], trace listeners"
+  - "logs, trace listeners"
+ms.assetid: 21726de1-61ee-4fdc-9dd0-3be49324d066
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# How to: Create and Initialize Trace Listeners
+<xref:System.Diagnostics.Debug?displayProperty=fullName> クラスと <xref:System.Diagnostics.Trace?displayProperty=fullName> クラスは、メッセージの受け取りと処理を実行する、リスナーと呼ばれるオブジェクトにメッセージを送ります。  トレースまたはデバッグを有効にすると、こうしたリスナーの 1 つである <xref:System.Diagnostics.DefaultTraceListener?displayProperty=fullName> が自動的に作成および初期化されます。  <xref:System.Diagnostics.Trace> または <xref:System.Diagnostics.Debug> の出力を別のソースに送るには、別のトレース リスナーを作成して初期化する必要があります。  
+  
+ 作成するリスナーには、アプリケーションのニーズが反映されている必要があります。  たとえば、すべてのトレース出力のテキスト レコードが必要である場合は、有効になったときにすべての出力を新しいテキスト ファイルに書き込む <xref:System.Diagnostics.TextWriterTraceListener> リスナーを作成します。  一方、アプリケーションの実行時にのみ出力を表示する場合は、すべての出力をコンソール ウィンドウに送る <xref:System.Diagnostics.ConsoleTraceListener> リスナーを作成します。  <xref:System.Diagnostics.EventLogTraceListener> は、トレース出力をイベント ログに転送することができます。  詳細については、「[トレース リスナー](../../../docs/framework/debug-trace-profile/trace-listeners.md)」を参照してください。  
+  
+ トレース リスナーは、[アプリケーション構成ファイル](../../../docs/framework/configure-apps/index.md)またはコードで作成できます。  アプリケーション構成ファイルではコードを変更せずにトレース リスナーを追加、変更、または削除できるので、アプリケーション構成ファイルを使用することをお勧めします。  
+  
+### 構成ファイルを使用してトレース リスナーを作成して使用するには  
+  
+1.  アプリケーション構成ファイルでトレース リスナーを宣言します。  作成しているリスナーで他のオブジェクトが必要な場合は、必要なオブジェクトも宣言します。  テキスト ファイル `TextWriterOutput.log` への書き込みを実行する `myListener` というリスナーの作成方法を次の例に示します。  
+  
+    ```  
+    <configuration>  
+      <system.diagnostics>  
+        <trace autoflush="false" indentsize="4">  
+          <listeners>  
+            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
+            <remove name="Default" />  
+          </listeners>  
+        </trace>  
+      </system.diagnostics>  
+    </configuration>  
+    ```  
+  
+2.  コードで <xref:System.Diagnostics.Trace> クラスを使用して、メッセージをトレース リスナーに書き込みます。  
+  
+    ```vb  
+    Trace.TraceInformation("Test message.")  
+    ' You must close or flush the trace to empty the output buffer.  
+    Trace.Flush()  
+    ```  
+  
+    ```csharp  
+    Trace.TraceInformation("Test message.");  
+    // You must close or flush the trace to empty the output buffer.  
+    Trace.Flush();  
+    ```  
+  
+### コードでトレース リスナーを作成して使用するには  
+  
+-   トレース リスナーを <xref:System.Diagnostics.Trace.Listeners%2A> コレクションに追加し、トレース情報をリスナーに送ります。  
+  
+    ```vb  
+    Trace.Listeners.Add(New TextWriterTraceListener("TextWriterOutput.log", "myListener"))  
+    Trace.TraceInformation("Test message.")  
+    ' You must close or flush the trace to empty the output buffer.  
+    Trace.Flush()  
+    ```  
+  
+    ```csharp  
+    Trace.Listeners.Add(new TextWriterTraceListener("TextWriterOutput.log", "myListener"));  
+    Trace.TraceInformation("Test message.");  
+    // You must close or flush the trace to empty the output buffer.  
+    Trace.Flush();  
+    ```  
+  
+     または  
+  
+-   リスナーがトレース出力を受け取らないようにするには、リスナーを <xref:System.Diagnostics.Trace.Listeners%2A> コレクションに追加しないようにします。  リスナー自体の出力メソッドを呼び出すことにより、<xref:System.Diagnostics.Trace.Listeners%2A> コレクションから独立したリスナーを通じて出力を生成できます。  <xref:System.Diagnostics.Trace.Listeners%2A> コレクションに属さないリスナーに行を書き込む方法を次の例に示します。  
+  
+    ```vb  
+    Dim myListener As New TextWriterTraceListener("TextWriterOutput.log", "myListener")  
+    myListener.WriteLine("Test message.")  
+    ' You must close or flush the trace listener to empty the output buffer.  
+    myListener.Flush()  
+    ```  
+  
+    ```csharp  
+    TextWriterTraceListener myListener = new TextWriterTraceListener("TextWriterOutput.log", "myListener");  
+    myListener.WriteLine("Test message.");  
+    // You must close or flush the trace listener to empty the output buffer.  
+    myListener.Flush();  
+    ```  
+  
+## 参照  
+ [Trace Listeners](../../../docs/framework/debug-trace-profile/trace-listeners.md)   
+ [Trace Switches](../../../docs/framework/debug-trace-profile/trace-switches.md)   
+ [How to: Add Trace Statements to Application Code](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)   
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md b/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md
new file mode 100644
index 00000000000..111105b15f6
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md
@@ -0,0 +1,93 @@
+---
+title: "方法: トレース ソースを作成し初期化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "トレース ソース"
+  - "初期化 (トレース ソースを)"
+  - "構成ファイル [.NET Framework]、トレース ソース"
+ms.assetid: f88dda6f-5fda-45be-9b3c-745a9b708c4d
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: トレース ソースを作成し初期化する
+<xref:System.Diagnostics.TraceSource> クラスをアプリケーションで使用すると、アプリケーションに関連付けることができるトレースを生成できます。  <xref:System.Diagnostics.TraceSource> は、イベントのトレース、データのトレース、および情報トレースの発行を簡単に実行できるトレース メソッドを提供します。  <xref:System.Diagnostics.TraceSource> からのトレース出力は、構成ファイルを使用してもしなくても作成および初期化できます。  このトピックでは、この両方の手順について説明しています。  ただし、実行時にトレース ソースによって作成されるトレースの再構成を容易にするために構成ファイルを使用することをお勧めします。  
+  
+### 構成ファイルを使用してトレース ソースを作成し、初期化するには  
+  
+1.  Visual Studio コンソール アプリケーション プロジェクトを作成し、提供されたコードを次のコードに置き換えます。  このコードは、エラーや警告を記録し、コンソールと、構成ファイルのエントリによって作成された myListener ファイルにその一部をそれぞれ出力します。  
+  
+     [!code-csharp[TraceSourceExample1#1](../../../samples/snippets/csharp/VS_Snippets_CLR/tracesourceexample1/cs/program.cs#1)]
+     [!code-vb[TraceSourceExample1#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/tracesourceexample1/vb/program.vb#1)]  
+  
+2.  アプリケーション構成ファイルが存在しない場合は、アプリケーション構成ファイルをプロジェクトに追加して、手順 1. のコード例にある `TraceSourceApp` というトレース ソースを初期化します。  
+  
+3.  既定の構成ファイルの内容を以下の設定に置き換えて、コンソール トレース リスナーと、手順 1. で作成されたトレース ソースのテキスト ライター トレース リスナーを初期化します。  
+  
+    ```  
+    <configuration>  
+      <system.diagnostics>  
+        <sources>  
+          <source name="TraceSourceApp"   
+            switchName="sourceSwitch"   
+            switchType="System.Diagnostics.SourceSwitch">  
+            <listeners>  
+              <add name="console"   
+                type="System.Diagnostics.ConsoleTraceListener">  
+                <filter type="System.Diagnostics.EventTypeFilter"   
+                  initializeData="Error"/>  
+              </add>  
+              <add name="myListener"/>  
+              <remove name="Default"/>  
+            </listeners>  
+          </source>  
+        </sources>  
+        <switches>  
+          <add name="sourceSwitch" value="Error"/>  
+        </switches>  
+        <sharedListeners>  
+          <add name="myListener"   
+            type="System.Diagnostics.TextWriterTraceListener"   
+            initializeData="myListener.log">  
+            <filter type="System.Diagnostics.EventTypeFilter"   
+              initializeData="Error"/>  
+          </add>  
+        </sharedListeners>  
+      </system.diagnostics>  
+    </configuration>  
+    ```  
+  
+     この構成ファイルは、トレース リスナーを設定するだけでなく、両方のリスナーについてフィルターを作成し、トレース ソースのソース スイッチも作成します。  トレース リスナーを追加する 2 つの方法が示されています。1 つは、リスナーをトレース ソースに直接追加する方法で、もう 1 つは、リスナーを共有リスナー コレクションに追加したうえで、名前でリスナーをトレース ソースに追加する方法です。  2 つのリスナーに対して識別されたフィルターは、異なるソース レベルで初期化されます。  この結果、一部のメッセージが 2 つのリスナーのいずれか一方のみによって書き込まれます。  
+  
+     構成ファイルは、アプリケーションが初期化されるときにトレース ソースの設定を初期化します。  アプリケーションは、構成ファイルによって設定されたプロパティを動的に変更し、ユーザーによって指定された設定値をオーバーライドできます。  たとえば、現在の構成設定とは無関係に、警告メッセージが常にテキスト ファイルに送られるようにすることもできます。  このプログラム例は、構成ファイルの設定値をオーバーライドして、警告メッセージがトレース リスナーに出力されるようにする方法を示しています。  
+  
+     アプリケーションの実行中に構成ファイルの設定値を変更しても、初期設定は変更されません。  設定を変更するには、アプリケーションを再起動するか、または <xref:System.Diagnostics.Trace.Refresh%2A?displayProperty=fullName> メソッドを使用して、プログラムによってアプリケーションを更新する必要があります。  
+  
+### 構成ファイルを使わずにトレース ソース、リスナー、およびフィルターを初期化するには  
+  
+-   次のプログラム例を使用すると、構成ファイルを使わずにトレース ソース全体のトレースが有効になります。  この方法はお勧めできませんが、構成ファイルに依存しないでトレース機能を確保する必要がある場合もあります。  
+  
+     [!code-csharp[TraceSourceExample2#1](../../../samples/snippets/csharp/VS_Snippets_CLR/tracesourceexample2/cs/program.cs#1)]
+     [!code-vb[TraceSourceExample2#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/tracesourceexample2/vb/program.vb#1)]  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.ConsoleTraceListener>   
+ <xref:System.Diagnostics.EventTypeFilter>   
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md b/docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md
new file mode 100644
index 00000000000..b8332e8ffc8
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md
@@ -0,0 +1,118 @@
+---
+title: "How to: Create, Initialize and Configure Trace Switches | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "trace switches, configuring"
+  - "tracing [.NET Framework], trace switches"
+  - "switches, trace"
+  - "tracing [.NET Framework], enabling or disabling"
+  - "Web.config configuration file, trace switches"
+ms.assetid: 5a0e41bf-f99c-4692-8799-f89617f5bcf9
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# How to: Create, Initialize and Configure Trace Switches
+トレース スイッチを使用すると、トレース出力を有効\/無効にしたり、トレースの出力をフィルター処理したりできます。  
+  
+<a name="create"></a>   
+## トレース スイッチを作成し、初期化するには  
+ トレース スイッチを使用するには、まずトレース スイッチを作成し、コード内に配置する必要があります。 事前定義されている 2 つのクラスからスイッチ オブジェクトを作成することができます。それは、<xref:System.Diagnostics.BooleanSwitch?displayProperty=fullName> クラスと <xref:System.Diagnostics.TraceSwitch?displayProperty=fullName> クラスです。 トレース メッセージを表示させるかどうかのみ処理すればよい場合は <xref:System.Diagnostics.BooleanSwitch> を使用し、トレースのレベルを区別する必要がある場合は <xref:System.Diagnostics.TraceSwitch> を使用します。<xref:System.Diagnostics.TraceSwitch> を使用する場合は、独自のデバッグ メッセージを定義して、それらのメッセージを異なるトレース レベルに関連付けることができます。 どちらの種類のスイッチも、トレースまたはデバッグの両方で使用できます。 既定では、<xref:System.Diagnostics.BooleanSwitch> は無効に設定され、<xref:System.Diagnostics.TraceSwitch> はレベル <xref:System.Diagnostics.TraceLevel?displayProperty=fullName> に設定されています。 トレース スイッチは、それらを使用する可能性のあるコードの任意の部分に作成して配置することができます。  
+  
+ トレース レベルやその他の構成オプションをコード内に設定することもできますが、構成ファイルを使用してスイッチの状態を管理することをお勧めします。 これは、構成システムでスイッチの構成を管理したほうが柔軟性が高く、アプリケーションを再コンパイルしないでもさまざまなスイッチのオン\/オフを切り替えたりレベルを変更したりできるからです。  
+  
+#### トレース スイッチを作成し、初期化するには  
+  
+1.  スイッチを型 <xref:System.Diagnostics.BooleanSwitch?displayProperty=fullName> または型 <xref:System.Diagnostics.TraceSwitch?displayProperty=fullName> のいずれかに定義し、スイッチの名前と説明を設定します。  
+  
+2.  トレース スイッチを構成します。 詳細については、「[トレース スイッチを設定する](#configure)」を参照してください。  
+  
+     次のコードでは、それぞれの種類のスイッチを 1 つずつ作成します。  
+  
+    ```vb  
+    Dim dataSwitch As New BooleanSwitch("Data", "DataAccess module") Dim generalSwitch As New TraceSwitch("General", "Entire application")  
+  
+    ```  
+  
+    ```csharp  
+    System.Diagnostics.BooleanSwitch dataSwitch = new System.Diagnostics.BooleanSwitch("Data", "DataAccess module"); System.Diagnostics.TraceSwitch generalSwitch = new System.Diagnostics.TraceSwitch("General", "Entire application");  
+  
+    ```  
+  
+<a name="configure"></a>   
+## トレース スイッチを構成する  
+ アプリケーションを配布した後も、引き続き、アプリケーション内のトレース スイッチを構成することによりトレース出力を有効\/無効にできます。 この場合、"スイッチを構成する" とは、初期化された後に外部ソースからその値を変更することを意味します。 構成ファイルを使用してスイッチ オブジェクトの値を変更することができます。 トレース スイッチを構成すると、スイッチのオン\/オフの切り替えやレベル設定を行えるほか、リスナーに引き渡すメッセージの量と種類を決定できます。  
+  
+ スイッチは、.config ファイルを使用して構成されています。 Web アプリケーションでは、これは、プロジェクトに関連付けられた Web.config ファイルです。 Windows アプリケーションでは、このファイルは、\(アプリケーション名\).exe.config という名前です。 配置されたアプリケーションでは、このファイルは実行可能ファイルと同じフォルダーになければなりません。  
+  
+ アプリケーションが、スイッチのインスタンスを作成するコードを初めて実行したときに、構成ファイルを確認して名前付きのスイッチに関するトレース レベルの情報を取得します。 トレース システムが特定のスイッチに関して構成ファイルを調べるのは、アプリケーションが初めてスイッチを作成するとき 1 回のみです。  
+  
+ 配置されたアプリケーションでは、アプリケーションが実行されていないときにスイッチ オブジェクトを再構成することによりトレース コードを有効にできます。 この手順は、通常、スイッチ オブジェクトのオン\/オフの切り替えやトレース レベルの変更を行った後、アプリケーションを再起動します。  
+  
+ スイッチのインスタンスを作成するときに、*displayName* 引数と *description* 引数の 2 つを指定することで、インスタンスを初期化することもできます。 コンストラクターの *displayName* 引数は、<xref:System.Diagnostics.Switch> クラスのインスタンスの <xref:System.Diagnostics.Switch.DisplayName%2A?displayProperty=fullName> プロパティを設定します。*displayName* は .config ファイルでスイッチを構成するために使用されている名前です。*description* 引数は、スイッチとそれがコントロールするメッセージについて簡単な説明を返します。  
+  
+ 構成するスイッチの名前を指定するだけでなく、スイッチの値も指定する必要があります。 この値は整数です。<xref:System.Diagnostics.BooleanSwitch> では、値 0 が **オフ** に相当し、0 以外の値が **オン** に相当します。<xref:System.Diagnostics.TraceSwitch> では、0、1、2、3、および 4 が、それぞれ**オフ**、**エラー**、**警告**、**情報**、および**詳細**に相当します。 4 より大きい数値は**詳細**として扱われ、0 より小さい数値は**オフ**として扱われます。  
+  
+> [!NOTE]
+>  .NET Framework バージョン 2.0 では、スイッチの値を指定するためにテキストを使用できます。 たとえば、<xref:System.Diagnostics.BooleanSwitch> に対して `true` を指定したり、<xref:System.Diagnostics.TraceSwitch> に対して列挙値のテキスト形式である `Error` を指定したりできます。`<add name="myTraceSwitch" value="Error" />` という行は、`<add name="myTraceSwitch" value="1" />` と同じです。  
+  
+ エンドユーザーがアプリケーションのトレース スイッチを構成できるようにするため、アプリケーションのスイッチに関する詳細なドキュメントを提供する必要があります。 どのスイッチで何を制御するのか、およびスイッチのオン\/オフを切り替える方法について詳しく説明してください。 また、.config ファイルのコメントに適切なヘルプを記載して、エンド ユーザーに提供する必要があります。  
+  
+#### トレース スイッチを構成する  
+  
+1.  トレース スイッチを使用するには、「[トレース スイッチを作成して初期化する](#create)」のセクションに説明されているように、それらを作成してコードに配置する必要があります。  
+  
+2.  プロジェクトに構成ファイル \(app.config または Web.config\) が含まれない場合は、**\[プロジェクト\]** メニューから **\[新しい項目の追加\]** を選択します。  
+  
+    -   **Visual Basic:** **\[新しい項目の追加\]** ダイアログ ボックスで **\[アプリケーション構成ファイル\]** を選択します。  
+  
+         アプリケーション構成ファイルが作成され、開かれます。 これは、XML ドキュメントであり、ルート要素は `<configuration>.` です。  
+  
+    -   **Visual C\# :** **\[新しい項目の追加\]** ダイアログ ボックスで **\[XML ファイル\]** を選択します。 このファイルに **app.config** という名前を付けます。 XML エディターで、XML 宣言の後に次の XML を追加します。  
+  
+        ```  
+        <configuration> </configuration>  
+        ```  
+  
+         プロジェクトをコンパイルすると、app.config ファイルがプロジェクトの出力フォルダーにコピーされ、名前が *applicationname*.exe.config に変更されます。  
+  
+3.  `<configuration>`  タグの後、かつ  `</configuration>`  タグの前に、スイッチを構成する適切な XML を追加します。 次の例では、**DisplayName** プロパティに `DataMessageSwitch` を設定した **BooleanSwitch** と、**DisplayName** プロパティに `TraceLevelSwitch` を設定した **TraceSwitch** を構成しています。  
+  
+    ```  
+    <system.diagnostics> <switches> <add name="DataMessagesSwitch" value="0" /> <add name="TraceLevelSwitch" value="0" /> </switches> </system.diagnostics>  
+    ```  
+  
+     この構成では、両方のスイッチがオフになっています。  
+  
+4.  **BooleanSwitch** \(前の例の `DataMessagesSwitch` など\) をオンにする必要がある場合は、**Value** を 0 以外の任意の整数に変更します。  
+  
+5.  **TraceSwitch** \(前の例の `TraceLevelSwitch` など\) をオンにする必要がある場合は、**Value** を適切なレベル設定 \(1 から 4\) に変更します。  
+  
+6.  .config ファイルにコメントを追加して、スイッチを適切に構成するためにどの値を変更すればよいかをエンドユーザーが明確に理解できるようにします。  
+  
+     次の例は、コメントを含む、最終的なコードを示しています。  
+  
+    ```  
+    <system.diagnostics> <switches> <!-- This switch controls data messages. In order to receive data trace messages, change value="0" to value="1" --> <add name="DataMessagesSwitch" value="0" /> <!-- This switch controls general messages. In order to receive general trace messages change the value to the appropriate level. "1" gives error messages, "2" gives errors and warnings, "3" gives more detailed error information, and "4" gives verbose trace information --> <add name="TraceLevelSwitch" value="0" /> </switches> </system.diagnostics>  
+    ```  
+  
+## 参照  
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)   
+ [How to: Add Trace Statements to Application Code](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)   
+ [Trace Switches](../../../docs/framework/debug-trace-profile/trace-switches.md)   
+ [トレースおよびデバッグ設定のスキーマ](../../../docs/framework/configure-apps/file-schema/trace-debug/index.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/how-to-use-tracesource-and-filters-with-trace-listeners.md b/docs/framework/debug-trace-profile/how-to-use-tracesource-and-filters-with-trace-listeners.md
new file mode 100644
index 00000000000..c1e247d1ce2
--- /dev/null
+++ b/docs/framework/debug-trace-profile/how-to-use-tracesource-and-filters-with-trace-listeners.md
@@ -0,0 +1,182 @@
+---
+title: "How to: Use TraceSource and Filters with Trace Listeners | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "initializing trace listeners"
+  - "configuration files [.NET Framework], trace listeners"
+  - "app.config files, trace listeners"
+  - "levels of writing trace messages"
+  - "trace listeners, TraceSource class"
+  - "application configuration files, trace listeners"
+  - "filters, trace listeners"
+  - "TraceSource class, trace listeners"
+  - "trace listeners, creating"
+  - "trace listeners, filters"
+  - "trace listeners, initializing"
+ms.assetid: 21dc2169-947d-453a-b0e2-3dac3ba0cc9f
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Use TraceSource and Filters with Trace Listeners
+.NET Framework Version 2.0 の新機能の 1 つが拡張されたトレース システムです。  基本的な前提は変わっていません。つまり、トレース メッセージはスイッチを介してリスナーに送信され、リスナーは関連付けられている出力媒体にデータを報告します。  Version 2.0 の前バージョンとの大きな違いは、トレースが <xref:System.Diagnostics.TraceSource> クラスのインスタンスを使用して開始できるという点です。  <xref:System.Diagnostics.TraceSource> は拡張されたトレース システムとして機能するためのもので、以前の <xref:System.Diagnostics.Trace> トレース クラスと <xref:System.Diagnostics.Debug> トレース クラスの静的メソッドの代わりに使用できます。  前バージョンの <xref:System.Diagnostics.Trace> クラスと <xref:System.Diagnostics.Debug> クラスも引き続き使用できますが、トレースには <xref:System.Diagnostics.TraceSource> クラスを使用することをお勧めします。  
+  
+ ここでは、アプリケーション構成ファイルと合わせて <xref:System.Diagnostics.TraceSource> を使用する方法について説明します。トレースは、構成ファイルを使用せずに <xref:System.Diagnostics.TraceSource> のみを使用して実行することもできますが、お勧めできません。  構成ファイルを使用しないトレースについては、「[方法: トレース ソースを作成し初期化する](../../../docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md)」を参照してください。  
+  
+### トレース ソースを作成および初期化するには  
+  
+1.  アプリケーションにトレース機能をインストルメントするには、最初にトレース ソースを作成します。  さまざまなコンポーネントを含む大型のプロジェクトでは、コンポーネントごとに別個のトレース ソースを作成できます。  トレース ソースの名前には、アプリケーション名を使用することをお勧めします。  これにより、個々のトレースを別々に維持することが容易になります。  次のコードでは、新しいトレース ソース \(`mySource`\) を作成し、イベントをトレースするメソッド \(`Activity1`\) を呼び出します。トレース メッセージは、既定のトレース リスナーによって書き込まれます。  
+  
+    ```  
+    using System;  
+    using System.Diagnostics;  
+    using System.Threading;  
+  
+    namespace TraceSourceApp  
+    {  
+        class Program  
+        {  
+            private static TraceSource mySource =   
+                new TraceSource("TraceSourceApp");  
+            static void Main(string[] args)  
+            {  
+                Activity1();  
+                mySource.Close();  
+                return;  
+            }  
+            static void Activity1()  
+            {  
+                mySource.TraceEvent(TraceEventType.Error, 1,   
+                    "Error message.");  
+                mySource.TraceEvent(TraceEventType.Warning, 2,   
+                    "Warning message.");  
+            }  
+        }  
+    }  
+    ```  
+  
+### トレース リスナーとフィルターを作成および初期化するには  
+  
+1.  最初のプロシージャのコードは、トレース リスナーとフィルターをプログラムによって識別しません。  このコードでは、単にトレース メッセージが既定のトレース リスナーに書き込まれるだけです。  特定のトレース リスナーとその関連フィルターを設定するには、アプリケーションの名前に対応する構成ファイルを編集します。  このファイルでは、リスナーを追加または削除したり、リスナーのプロパティとフィルターを設定したりできます。また、複数のリスナーを削除することもできます。  前のプロシージャで作成したトレース ソースに対するコンソール トレース リスナーとテキスト ライター トレース リスナーを初期化する方法を次の構成ファイルの例に示します。  この構成ファイルは、トレース リスナーを設定するだけでなく、両方のリスナーについてフィルターを作成し、トレース ソースのソース スイッチも作成します。  トレース リスナーを追加する 2 つの方法が示されています。1 つは、リスナーをトレース ソースに直接追加する方法で、もう 1 つは、リスナーを共有リスナー コレクションに追加したうえで、名前でリスナーをトレース ソースに追加する方法です。  2 つのリスナーに対して識別されたフィルターは、異なるソース レベルで初期化されます。  この結果、一部のメッセージが 2 つのリスナーのいずれか一方のみによって書き込まれます。  
+  
+    ```  
+    <configuration>  
+      <system.diagnostics>  
+        <sources>  
+          <source name="TraceSourceApp"   
+            switchName="sourceSwitch"   
+            switchType="System.Diagnostics.SourceSwitch">  
+            <listeners>  
+              <add name="console"   
+                type="System.Diagnostics.ConsoleTraceListener">  
+                <filter type="System.Diagnostics.EventTypeFilter"   
+                  initializeData="Warning"/>  
+              </add>  
+              <add name="myListener"/>  
+              <remove name="Default"/>  
+            </listeners>  
+          </source>  
+        </sources>  
+        <switches>  
+          <add name="sourceSwitch" value="Warning"/>  
+        </switches>  
+        <sharedListeners>  
+          <add name="myListener"   
+            type="System.Diagnostics.TextWriterTraceListener"   
+            initializeData="myListener.log">  
+            <filter type="System.Diagnostics.EventTypeFilter"   
+              initializeData="Error"/>  
+          </add>  
+        </sharedListeners>  
+      </system.diagnostics>  
+    </configuration>  
+    ```  
+  
+### リスナーがトレース メッセージを書き込むレベルを変更するには  
+  
+1.  構成ファイルは、アプリケーションが初期化されるときにトレース ソースの設定を初期化します。  この設定を変更するには、構成ファイルを変更し、アプリケーションを再起動するか、または <xref:System.Diagnostics.Trace.Refresh%2A?displayProperty=fullName> メソッドを使用して、プログラムによってアプリケーションを更新する必要があります。  アプリケーションは、構成ファイルによって設定されたプロパティを動的に変更し、ユーザーによって指定された設定値をオーバーライドできます。たとえば、現在の構成設定とは関係なく、警告メッセージが常にテキスト ファイルに送られるようにすることもできます。  
+  
+    ```  
+    using System;  
+    using System.Diagnostics;  
+    using System.Threading;  
+  
+    namespace TraceSourceApp  
+    {  
+        class Program  
+        {  
+            private static TraceSource mySource =   
+                new TraceSource("TraceSourceApp");  
+            static void Main(string[] args)  
+            {  
+                Activity1();  
+  
+                // Change the event type for which tracing occurs.  
+                // The console trace listener must be specified   
+                // in the configuration file. First, save the original  
+                // settings from the configuration file.  
+                EventTypeFilter configFilter =   
+                    (EventTypeFilter)mySource.Listeners["console"].Filter;  
+  
+                // Then create a new event type filter that ensures   
+                // critical messages will be written.  
+                mySource.Listeners["console"].Filter =  
+                    new EventTypeFilter(SourceLevels.Critical);  
+                Activity2();  
+  
+                // Allow the trace source to send messages to listeners   
+                // for all event types. This statement will override   
+                // any settings in the configuration file.  
+                mySource.Switch.Level = SourceLevels.All;  
+  
+                // Restore the original filter settings.  
+                mySource.Listeners["console"].Filter = configFilter;  
+                Activity3();  
+                mySource.Close();  
+                return;  
+            }  
+            static void Activity1()  
+            {  
+                mySource.TraceEvent(TraceEventType.Error, 1,   
+                    "Error message.");  
+                mySource.TraceEvent(TraceEventType.Warning, 2,   
+                    "Warning message.");  
+            }  
+            static void Activity2()  
+            {  
+                mySource.TraceEvent(TraceEventType.Critical, 3,   
+                    "Critical message.");  
+                mySource.TraceInformation("Informational message.");  
+            }  
+            static void Activity3()  
+            {  
+                mySource.TraceEvent(TraceEventType.Error, 4,   
+                    "Error message.");  
+                mySource.TraceInformation("Informational message.");  
+            }  
+        }  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Diagnostics.TraceSource>   
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.ConsoleTraceListener>   
+ <xref:System.Diagnostics.EventTypeFilter>   
+ [方法: トレース ソースを作成し初期化する](../../../docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md)   
+ [Trace Listeners](../../../docs/framework/debug-trace-profile/trace-listeners.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/illegalprepareconstrainedregion-mda.md b/docs/framework/debug-trace-profile/illegalprepareconstrainedregion-mda.md
new file mode 100644
index 00000000000..ea18642b873
--- /dev/null
+++ b/docs/framework/debug-trace-profile/illegalprepareconstrainedregion-mda.md
@@ -0,0 +1,81 @@
+---
+title: "illegalPrepareConstrainedRegion MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "PrepareConstrainedRegions method"
+  - "managed debugging assistants (MDAs), illegal PrepareConstrainedRegions"
+  - "try/catch exception handling, managed debugging assistants"
+  - "IllegalPrepareConstrainedRegions MDA"
+  - "MDAs (managed debugging assistants), illegal PrepareConstrainedRegions"
+ms.assetid: 2f9b5031-f910-4e01-a196-f89eab313eaf
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# illegalPrepareConstrainedRegion MDA
+`illegalPrepareConstrainedRegion` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、<xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A?displayProperty=fullName> メソッド呼び出しが例外ハンドラーの `try` ステートメントの直前にない場合にアクティブになります。  この制限は MSIL レベルであるため、呼び出しと `try` の間にコード生成されないソース \(コメントなど\) がある場合は問題ありません。  
+  
+## 症状  
+ 制約された実行領域 \(CER\) が制約された状態として扱われず、簡単な例外処理ブロック block \(`finally` または `catch`\) として扱われる。  結果として、メモリが不足している場合やスレッドが中止された場合に、領域が実行されません。  
+  
+## 原因  
+ CER の準備パターンが正しく続いていません。エラー イベントが発生します。  `catch`\/`finally`\/`fault`\/`filter` ブロック内で CER の導入として例外ハンドラーをマークするために使用される <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> メソッドは、`try` ステートメントの直前で使用する必要があります。  
+  
+## 解決策  
+ <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> への呼び出しが `try` `` ステートメントの直前に行われるようにします。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ MDA は、<xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> メソッドの呼び出し元メソッドの名前、MSIL オフセット、および呼び出しが try ブロックの先頭の直前で行われていないことを示すメッセージを表示します。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <illegalPrepareConstrainedRegion/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ この MDA がアクティブになるパターンのコード例を次に示します。  
+  
+```  
+void MethodWithInvalidPCR()  
+{  
+    RuntimeHelpers.PrepareConstrainedRegions();  
+    Object o = new Object();  
+    try  
+    {  
+        …  
+    }  
+    finally  
+    {  
+        …  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/index.md b/docs/framework/debug-trace-profile/index.md
new file mode 100644
index 00000000000..969acc5951a
--- /dev/null
+++ b/docs/framework/debug-trace-profile/index.md
@@ -0,0 +1,64 @@
+---
+title: "Debugging, Tracing, and Profiling | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "debugging [.NET Framework]"
+  - ".NET Framework application configuration, debugging"
+  - "debugging [.NET Framework], .NET Framework application debugging"
+  - "troubleshooting applications [.NET Framework], profiling"
+  - "application development [.NET Framework], debugging"
+  - ".NET Framework application configuration, profiling"
+  - "profiling applications"
+  - "troubleshooting applications [.NET Framework], debugging"
+  - "troubleshooting applications [.NET Framework]"
+  - "application development [.NET Framework], profiling"
+ms.assetid: 4a04863e-2475-46f4-bc3f-3c11510c2a4b
+caps.latest.revision: 28
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# Debugging, Tracing, and Profiling
+.NET Framework アプリケーションをデバッグするには、アプリケーションにデバッガーをアタッチできるようにコンパイラとランタイム環境を構成する必要があり、可能であれば、アプリケーションとそれに対応する Microsoft Intermediate Language \(MSIL\) について記号マップと行マップの両方を生成する必要があります。  マネージ アプリケーションのデバッグが完了した後は、パフォーマンスを向上するようにプロファイルできます。  プロファイルでは、最も頻繁に実行されるコードを生成するソース コード行と、そのコードの実行に要する時間を評価して記述します。  
+  
+ .NET Framework アプリケーションは、構成の詳細の多くを処理する Visual Studio を使用すると容易にデバッグできます。  Visual Studio がインストールされていない場合は、.NET Framework の <xref:System.Diagnostics> 名前空間に含まれるデバッグ用のクラスを使用して .NET Framework アプリケーションのパフォーマンスを確認して向上させることができます。  この名前空間には、実行フローをトレースするためのクラスとして <xref:System.Diagnostics.Trace>、<xref:System.Diagnostics.Debug>、および <xref:System.Diagnostics.TraceSource> が含まれ、コードをプロファイルするためのクラスとして <xref:System.Diagnostics.Process>、<xref:System.Diagnostics.EventLog>、および <xref:System.Diagnostics.PerformanceCounter> が含まれています。  
+  
+## このセクションの内容  
+ [Enabling JIT\-Attach Debugging](../../../docs/framework/debug-trace-profile/enabling-jit-attach-debugging.md)  
+ .NET Framework アプリケーションにデバッグ エンジンを JIT アタッチするようにレジストリを構成する方法を示します。  
+  
+ [イメージのデバッグの簡略化](../../../docs/framework/debug-trace-profile/making-an-image-easier-to-debug.md)  
+ アセンブリをデバッグしやすくするために JIT 追跡を有効にし、最適化を無効にする方法を示します。  
+  
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)  
+ アプリケーションの実行中にアプリケーションの実行をモニターする方法、アプリケーションの実行が順調かどうか、何かの障害が発生しているかどうかを表示するようにアプリケーションをインストルメント化する方法について説明します。  
+  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)  
+ マネージ デバッグ アシスタント \(MDA\) について説明します。これは、共通言語ランタイム \(CLR: Common Language Runtime\) と連携してランタイム状態に関する情報を提供するデバッグ支援ツールです。  
+  
+ [Enhancing Debugging with the Debugger Display Attributes](../../../docs/framework/debug-trace-profile/enhancing-debugging-with-the-debugger-display-attributes.md)  
+ 型の開発者が、その型をデバッガーで表示した場合にどのように見えるかを指定する方法について説明します。  
+  
+ [Performance Counters](../../../docs/framework/debug-trace-profile/performance-counters.md)  
+ アプリケーションのパフォーマンスを追跡するために使用できるカウンターについて説明します。  
+  
+## 関連項目  
+ [ASP.NET アプリケーションおよび AJAX アプリケーションのデバッグ](../Topic/Debugging%20ASP.NET%20and%20AJAX%20Applications.md)  
+ 開発時と配置後に ASP.NET アプリケーションをデバッグするための要件と手順について説明します。  
+  
+ [開発ガイド](../../../docs/framework/development-guide.md)  
+ アプリケーションの作成、構成、デバッグ、セキュリティ、配置、および動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理に関する情報を含む、アプリケーション開発用の主要な技術領域とタスクのすべてについての手引書です。
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidapartmentstatechange-mda.md b/docs/framework/debug-trace-profile/invalidapartmentstatechange-mda.md
new file mode 100644
index 00000000000..0d97a56ce3f
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidapartmentstatechange-mda.md
@@ -0,0 +1,93 @@
+---
+title: "invalidApartmentStateChange MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), invalid apartment state"
+  - "managed debugging assistants (MDAs), invalid apartment state"
+  - "InvalidApartmentStateChange MDA"
+  - "invalid apartment state changes"
+  - "threading [.NET Framework], apartment states"
+  - "apartment states"
+  - "threading [.NET Framework], managed debugging assistants"
+  - "COM apartment states"
+ms.assetid: e56fb9df-5286-4be7-b313-540c4d876cd7
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# invalidApartmentStateChange MDA
+`invalidApartmentStateChange` マネージ デバッグ アシスタント \(MDS: Managed Debugging Assistant\) は、次の 2 つの問題のいずれかによってアクティブになります。  
+  
+-   COM によって既に初期化されているスレッドの COM アパートメントの状態が、異なるアパートメント状態に変更されようとしました。  
+  
+-   スレッドの COM アパートメントの状態が予期せず変更されました。  
+  
+## 症状  
+  
+-   スレッドの COM アパートメントの状態が、要求された状態と異なります。  これにより、現在とは異なるスレッド処理モデルの COM コンポーネントで、プロキシが使用されることがあります。  そのため、アパートメント間マーシャリングがセットアップされていないインターフェイスを通じて COM オブジェクトが呼び出されるときに、<xref:System.InvalidCastException> がスローされる場合があります。  
+  
+-   スレッドの COM アパートメントの状態が、想定と異なります。  これにより、[ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW\) で呼び出しが行われたときに、RPC\_E\_WRONG\_THREAD 値が HRESULT で <xref:System.Runtime.InteropServices.COMException> が発生したり、<xref:System.InvalidCastException> が発生したりすることがあります。  また、一部のシングルスレッド COM コンポーネントは、複数のスレッドから同時にアクセスされてしまうこともあり、その結果、破損やデータの損失が発生することもあります。  
+  
+## 原因  
+  
+-   スレッドは既に初期化されていて、別の COM アパートメント状態になっています。  スレッドのアパートメント状態は、明示的にも暗黙的にも設定できることに注意してください。  明示的な操作には、<xref:System.Threading.Thread.ApartmentState%2A?displayProperty=fullName> プロパティ、<xref:System.Threading.Thread.SetApartmentState%2A> メソッド、および <xref:System.Threading.Thread.TrySetApartmentState%2A> メソッドが含まれます。  <xref:System.Threading.Thread.Start%2A> メソッドを使用して作成されたスレッドは、スレッドが開始する前に <xref:System.Threading.Thread.SetApartmentState%2A> が呼び出されない限り、暗黙的に <xref:System.Threading.ApartmentState> に設定されます。  また、アプリケーションのメイン スレッドは、<xref:System.STAThreadAttribute> 属性がメイン スレッドで指定されていない限り、暗黙的に <xref:System.Threading.ApartmentState> に初期化されます。  
+  
+-   異なる同時実行モデルの `CoUninitialize` メソッド \(または `CoInitializeEx` メソッド\) が、スレッドで呼び出されました。  
+  
+## 解決策  
+ スレッドの実行開始前に、スレッドのアパートメント状態を設定します。または、アプリケーションのメイン スレッドに、<xref:System.STAThreadAttribute> 属性または <xref:System.MTAThreadAttribute> 属性を適用します。  
+  
+ 2 番目の原因の場合は、`CoUninitialize` メソッドを呼び出すコードを変更して、スレッドが終了するまで呼び出しを遅延させ、スレッドによって使用中のままとなっている RCW とその基本となる COM コンポーネントがないようにすることが理想的です。  ただし、`CoUninitialize` メソッドを呼び出すコードを変更できない場合、この方法で初期化されていないスレッドから RCW を使用しないでください。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ 現在のスレッドの COM アパートメント状態、およびコードに適用しようとした状態です。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidApartmentStateChange />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ この MDA をアクティブにできる状況のコード例を次に示します。  
+  
+```  
+using System.Threading;  
+namespace ApartmentStateMDA  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            Thread.CurrentThread.SetApartmentState(ApartmentState.STA);  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidcercall-mda.md b/docs/framework/debug-trace-profile/invalidcercall-mda.md
new file mode 100644
index 00000000000..40f76af20ca
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidcercall-mda.md
@@ -0,0 +1,70 @@
+---
+title: "invalidCERCall MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "invalid CER calls"
+  - "InvalidCERCall MDA"
+  - "MDAs (managed debugging assistants), CER calls"
+  - "constrained execution regions"
+  - "CER calls"
+  - "managed debugging assistants (MDAs), CER calls"
+ms.assetid: c4577410-602e-44e5-9dab-fea7c55bcdfe
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# invalidCERCall MDA
+`invalidCERCall` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、信頼性のコントラクトを持たないメソッド、または極度に脆弱なコントラクトを持つメソッドへの呼び出しが、制約された実行領域 \(CER: Constrained Execution Region\) グラフ内で行われたときにアクティブになります。  脆弱なコントラクトとは、最悪の場合の状態破損が、呼び出しに渡されるインスタンスよりもスコープが大きいこと、つまり、<xref:System.AppDomain> やプロセスの状態が破損すること、または CER 内で呼び出されたときに呼び出し結果が常に確定的に計算できるとは限らないことを宣言するコントラクトです。  
+  
+## 症状  
+ CER でのコードの実行時に予想外の結果が生じます。  症状は限定されていません。  症状としては、信頼性の低いメソッドへの呼び出し時に予想外の <xref:System.OutOfMemoryException> や <xref:System.Threading.ThreadAbortException> などの例外が発生する可能性があります。これは、ランタイムが、事前にその呼び出しを準備していなかったり、実行時に <xref:System.Threading.ThreadAbortException> 例外から保護していなかったりするためです。  より大きな脅威は、実行時にメソッドから生じる例外により、<xref:System.AppDomain> やプロセスが不安定な状態になる可能性があることです。これは、CER の目的とは正反対です。  CER の作成目的は、このような状態破損を回避することだからです。  破損状態の症状は、一貫した状態の定義がアプリケーションによって異なるため、それぞれのアプリケーションに固有です。  
+  
+## 原因  
+ CER 内のコードが、<xref:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute> を持たない、または CER で実行できない脆弱な <xref:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute> を持つ関数を呼び出しています。  
+  
+ 信頼性のコントラクトの構文という点からすると、脆弱なコントラクトとは、<xref:System.Runtime.ConstrainedExecution.Consistency> 列挙値を指定しないコントラクトや、<xref:System.Runtime.ConstrainedExecution.Consistency>、<xref:System.Runtime.ConstrainedExecution.Consistency>、または <xref:System.Runtime.ConstrainedExecution.Cer> の <xref:System.Runtime.ConstrainedExecution.Consistency> 値を指定するコントラクトです。  これらの条件はいずれも、呼び出されるコードにより、CER 内で一貫した状態を維持しようとする他のコードの試みが阻害される可能性があることを意味します。CER では、コードによってエラーを確定的な方法で処理できるため、アプリケーションにとって重要な内部のインバリアントを保持し、メモリ不足例外などの一時的なエラーが発生した場合にアプリケーションが動作を継続できます。  
+  
+ この MDA がアクティブになった場合は、CER で呼び出されているメソッドが呼び出し元が予期しない形で失敗したり、<xref:System.AppDomain> やプロセスの状態を破損または回復不可能なままにして失敗したりする可能性があります。  呼び出されたコードが正しく実行され、コントラクトの欠落だけが問題となることもあります。  ただし、信頼性の高いコードの記述に関連する問題は軽微であり、コントラクトの欠落は、コードを正しく実行できないことを示す良好な指標です。  コントラクトは、プログラマが信頼できる形でコードを作成していることを示し、またコードの今後のバージョンで信頼性の保証が変わらないと約束していることを示す指標です。つまり、コントラクトとは意志の宣言であり、単なる実装詳細ではありません。  
+  
+ 脆弱なコントラクトを持つメソッドやコントラクトが存在しないメソッドは、予測不可能なさまざまな形で失敗する可能性があるため、ランタイムは、ロードの小さい JIT コンパイル、ジェネリック ディクショナリの読み込み、スレッドの中止などによってもたらされる、予測不可能な固有のエラーをメソッドから削除しようとしません。  つまり、この MDA がアクティブになったときは、ランタイムには、呼び出されたメソッドが、定義されている CER に含まれておらず、このサブツリーの準備を継続すると、潜在的なエラーがマスクされるため、呼び出し先がこのノードで終了したことを示します。  
+  
+## 解決策  
+ 有効な信頼性のコントラクトを関数に追加するか、その関数呼び出しの使用を避けます。  
+  
+## ランタイムへの影響  
+ 脆弱なコントラクトを CER から呼び出すと、CER エラーが発生し、CER の操作が終了する可能性があります。  これにより、<xref:System.AppDomain> プロセス状態が破損することがあります。  
+  
+## 出力  
+ この MDA のサンプル出力を次に示します。  
+  
+ `Method 'MethodWithCer', while executing within a constrained execution region, makes a call at IL offset 0x000C to 'MethodWithWeakContract', which does not have a sufficiently strong reliability contract and might cause non-deterministic results.`  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidCERCall />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A>   
+ <xref:System.Runtime.ConstrainedExecution>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidfunctionpointerindelegate-mda.md b/docs/framework/debug-trace-profile/invalidfunctionpointerindelegate-mda.md
new file mode 100644
index 00000000000..2fb75dfdeed
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidfunctionpointerindelegate-mda.md
@@ -0,0 +1,64 @@
+---
+title: "invalidFunctionPointerInDelegate MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "invalidFunctionPointerInDelegate MDA"
+  - "managed debugging assistants (MDAs), invalid function pointer to delegates"
+  - "MDAs (managed debugging assistants), invalid function pointer to delegates"
+  - "function pointers, invalid"
+  - "marshaling, run-time errors"
+  - "managed debugging assistants (MDAs), marshaling"
+  - "MDAs (managed debugging assistants), marshaling"
+  - "invalid function pointers"
+ms.assetid: 99ae44f1-783e-49a9-9009-24f54bbd0f09
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# invalidFunctionPointerInDelegate MDA
+ネイティブ関数ポインターに対するデリゲートを作成するときに、無効な関数ポインターが渡されると、`invalidFunctionPointerInDelegate` マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+## 症状  
+ 関数ポインターでデリゲートを使用すると、アクセス違反または予期しないメモリの破損が発生します。  
+  
+## 原因  
+ 無効な関数ポインターが指定されました。  
+  
+## 解決策  
+ 有効な関数ポインターを指定します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ 無効な関数ポインター。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidFunctionPointerInDelegate />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidgchandlecookie-mda.md b/docs/framework/debug-trace-profile/invalidgchandlecookie-mda.md
new file mode 100644
index 00000000000..5c6d76d133f
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidgchandlecookie-mda.md
@@ -0,0 +1,61 @@
+---
+title: "invalidGCHandleCookie MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), invalid cookies"
+  - "cookies, invalid"
+  - "managed debugging assistants (MDAs), invalid cookies"
+  - "InvalidGCHandleCookie MDA"
+  - "invalid cookies"
+ms.assetid: 613ad742-3c11-401d-a6b3-893ceb8de4f8
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# invalidGCHandleCookie MDA
+`invalidGCHandleCookie` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、無効な <xref:System.IntPtr> クッキーから <xref:System.Runtime.InteropServices.GCHandle> への変換が試行されたときにアクティブ化されます。  
+  
+## 症状  
+ <xref:System.IntPtr> から <xref:System.Runtime.InteropServices.GCHandle> を使用または取得しようとしたときに、アクセス違反やメモリ破損などの未定義の動作が発生します。  
+  
+## 原因  
+ クッキーが元来、 <xref:System.Runtime.InteropServices.GCHandle> から作成されていないか、既に解放された <xref:System.Runtime.InteropServices.GCHandle> であるか、異なるアプリケーション ドメインの <xref:System.Runtime.InteropServices.GCHandle> に対するクッキーであるか、または<xref:System.Runtime.InteropServices.GCHandle> としてネイティブ コードにマーシャリングされたが、キャストが試行された <xref:System.IntPtr> として CLR に返されたため、クッキーが無効になっている可能性があります。  
+  
+## 解決策  
+ <xref:System.Runtime.InteropServices.GCHandle> に有効な <xref:System.IntPtr> クッキーを指定します。  
+  
+## ランタイムへの影響  
+ この MDA を有効にすると、返されるクッキー値は MDA が無効のときに返されるクッキー値と異なるため、デバッガーはオブジェクトまでのルートをたどることができなくなります。  
+  
+## 出力  
+ 無効な <xref:System.IntPtr> クッキー値が報告されます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidGCHandleCookie />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.GCHandle.FromIntPtr%2A>   
+ <xref:System.Runtime.InteropServices.GCHandle>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidiunknown-mda.md b/docs/framework/debug-trace-profile/invalidiunknown-mda.md
new file mode 100644
index 00000000000..01b298b7924
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidiunknown-mda.md
@@ -0,0 +1,61 @@
+---
+title: "invalidIUnknown MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), invalid IUnknown pointer"
+  - "InvalidIUnknown MDA"
+  - "invalid IUnknown pointers"
+  - "IUnknown pointers"
+  - "managed debugging assistants (MDAs), invalid IUnknown pointer"
+ms.assetid: c7924771-a16b-40fe-b337-ce51dcdf6a12
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# invalidIUnknown MDA
+`invalidIUnknown` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、無効な `IUnknown` ポインターがネイティブ コードからマネージ コードに渡されるとアクティブ化されます。  `IUnknown` インターフェイスが照会されたときに、`IUnknown` は、成功したことを返すことができませんでした。  
+  
+## 症状  
+ 引数のマーシャリング中に COM インターフェイス ポインターをマーシャリングすると、予期しないエラーが発生します。  
+  
+## 原因  
+ CLR に渡された COM インターフェイスで、`QueryInterface` の実装が正しくありません。  
+  
+## 解像度  
+ `QueryInterface` の実装を修正します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ エラーの説明です。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidIUnknown />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidmemberdeclaration-mda.md b/docs/framework/debug-trace-profile/invalidmemberdeclaration-mda.md
new file mode 100644
index 00000000000..6681a059ccd
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidmemberdeclaration-mda.md
@@ -0,0 +1,61 @@
+---
+title: "invalidMemberDeclaration MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "invalid member declaration"
+  - "InvalidMemberDeclaration MDA"
+  - "marshaling, run-time errors"
+  - "managed debugging assistants (MDAs), marshaling"
+  - "MDAs (managed debugging assistants), marshaling"
+ms.assetid: a84dd9a3-d6cf-4824-989a-ecbbf443eeb4
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# invalidMemberDeclaration MDA
+`invalidMemberDeclaration` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、COM から呼び出されるメンバーのパラメーターをマーシャリングする方法を判断しているときに、エラーが発生したことを報告するためにアクティブ化されます。  
+  
+## 症状  
+ マネージ メソッドが呼び出されることなく、COM にエラーの HRESULT が返されます。  
+  
+## 原因  
+ ほとんどの場合、いずれかのパラメーターに互換性のない <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性があることが原因です。  
+  
+## 解像度  
+ パラメーターで有効な <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を指定します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ メンバー名、型名、およびエラー メッセージを含む情報メッセージです。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidMemberDeclaration/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidoverlappedtopinvoke-mda.md b/docs/framework/debug-trace-profile/invalidoverlappedtopinvoke-mda.md
new file mode 100644
index 00000000000..90ae1dd6fd4
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidoverlappedtopinvoke-mda.md
@@ -0,0 +1,88 @@
+---
+title: "invalidOverlappedToPinvoke MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "overlapped pointers"
+  - "managed debugging assistants (MDAs), overlapped pointers"
+  - "invalid overlapped pointer to platform invoke"
+  - "InvalidOverlappedToPinvoke MDA"
+  - "MDAs (managed debugging assistants), overlapped pointers"
+  - "pointers, overlapped"
+ms.assetid: 28876047-58bd-4fed-9452-c7da346d67c0
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# invalidOverlappedToPinvoke MDA
+`invalidOverlappedToPinvoke` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、ガベージ コレクション ヒープで作成されていないオーバーラップ ポインターが特定の Win32 関数に渡されるとアクティブになります。  
+  
+> [!NOTE]
+>  既定では、この MDA は、プラットフォームの起動の呼び出しがコードで定義され、デバッガーが各メソッドの JustMyCode 状態をレポートする場合にのみアクティブになります。  JustMyCode を理解しないデバッガー \(拡張機能なしの MDbg.exe など\) は、この MDA をアクティブにしません。  このようなデバッガーに対してこの MDA を有効にするには、構成ファイルを使用し、.mda.config ファイルで `justMyCode="false"` を明示的に設定します`(<invalidOverlappedToPinvoke enable="true" justMyCode="false"/>`\)。  
+  
+## 症状  
+ クラッシュまたは説明のつかないヒープ破損。  
+  
+## 原因  
+ ガベージ コレクション ヒープで作成されていないオーバーラップ ポインターが特定のオペレーティング システム関数に渡されています。  
+  
+ この MDA が追跡する関数を次の表に示します。  
+  
+|モジュール|関数|  
+|-----------|--------|  
+|HttpApi.dll|`HttpReceiveHttpRequest`|  
+|IpHlpApi.dll|`NotifyAddrChange`|  
+|kernel32.dll|`ReadFile`|  
+|kernel32.dll|`ReadFileEx`|  
+|kernel32.dll|`WriteFile`|  
+|kernel32.dll|`WriteFileEx`|  
+|kernel32.dll|`ReadDirectoryChangesW`|  
+|kernel32.dll|`PostQueuedCompletionStatus`|  
+|MSWSock.dll|`ConnectEx`|  
+|WS2\_32.dll|`WSASend`|  
+|WS2\_32.dll|`WSASendTo`|  
+|WS2\_32.dll|`WSARecv`|  
+|WS2\_32.dll|`WSARecvFrom`|  
+|MQRT.dll|`MQReceiveMessage`|  
+  
+ 呼び出しを行う <xref:System.AppDomain> がアンロードされる可能性があるため、この条件ではヒープが破損する可能性が高くなります。  <xref:System.AppDomain> がアンロードされると、アプリケーション コードがオーバーラップ ポインター用メモリを解放するため、操作終了時に破損が発生します。または、コードによってメモリ リークが発生し、後で問題となります。  
+  
+## 解決策  
+ <xref:System.Threading.Overlapped> オブジェクトを使用して <xref:System.Threading.Overlapped.Pack%2A> メソッドを呼び出し、関数に渡すことができる <xref:System.Threading.NativeOverlapped> 構造体を取得します。  <xref:System.AppDomain> がアンロードされると、CLR は非同期操作が完了するのを待ってからポインターを解放します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ この MDA からの出力の例を次に示します。  
+  
+ `An overlapped pointer (0x00ea3430) that was not allocated on the GC heap was passed via Pinvoke to the Win32 function 'WriteFile' in module 'KERNEL32.DLL'.  If the AppDomain is shut down, this can cause heap corruption when the async I/O completes.  The best solution is to pass a NativeOverlapped structure retrieved from a call to System.Threading.Overlapped.Pack().  If the AppDomain exits, the CLR will keep this structure alive and pinned until the I/O completes.`  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidOverlappedToPinvoke/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/invalidvariant-mda.md b/docs/framework/debug-trace-profile/invalidvariant-mda.md
new file mode 100644
index 00000000000..6aca0b65b4d
--- /dev/null
+++ b/docs/framework/debug-trace-profile/invalidvariant-mda.md
@@ -0,0 +1,61 @@
+---
+title: "invalidVariant MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), invalid variant"
+  - "VARIANT type errors"
+  - "InvalidVariant MDA"
+  - "invalid VARIANT types"
+  - "managed debugging assistants (MDAs), invalid variant"
+ms.assetid: d273e070-d1b1-4a53-a9c7-7af837b04a3d
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# invalidVariant MDA
+`invalidVariant` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、ネイティブ コードまたはアンマネージ コードからマネージ コードへの呼び出し時に、無効な `VARIANT` 構造体が見つかるとアクティブ化されます。  
+  
+## 症状  
+ `VARIANT` からオブジェクトへのマーシャリングを含む、ネイティブ コードとマネージ コードの間の遷移中に、予期しない動作が発生します。  
+  
+## 原因  
+ ネイティブ コードが、不適切な `VARIANT` 構造体をマネージ コードに渡しています。  ランタイムは、この `VARIANT` をオブジェクトにマーシャリングしようとし、`VARIANT` が有効でない場合に MDA がアクティブ化されます。  無効な `VARIANT` には、`VARTYPE` VT\_EMPTY &#124; VT\_BYREF の `VARIANT` や、`VARTYPE` VT\_VARIANT の `VARIANT` などがあります。  
+  
+## 解決策  
+ `VARIANT` を渡すネイティブ コードまたはアンマネージ コードでは、`VARIANT` の形式と初期化が正しいことを確認する必要があります。  
+  
+## ランタイムへの影響  
+ この MDA は、ランタイムの動作への影響はありません。  
+  
+## 出力  
+ 無効な `VARIANT` がアンマネージ モジュールによりマネージ コードに渡されたことを、ランタイムが検出したことを示す MDA メッセージです。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <invalidVariant />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/jitcompilationstart-mda.md b/docs/framework/debug-trace-profile/jitcompilationstart-mda.md
new file mode 100644
index 00000000000..e7dc23421eb
--- /dev/null
+++ b/docs/framework/debug-trace-profile/jitcompilationstart-mda.md
@@ -0,0 +1,173 @@
+---
+title: "jitCompilationStart MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "JIT compilation"
+  - "MDAs (managed debugging assistants), JIT compilation"
+  - "JitCompilationStart MDA"
+  - "managed debugging assistants (MDAs), JIT compilation"
+ms.assetid: 5ffd2857-d0ba-4342-9824-9ffe04ec135d
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# jitCompilationStart MDA
+`jitCompilationStart` マネージ デバッグ アシスタント \(MDA:Managed Debugging Assistant\) は、Just\-In\-Time \(JIT\) コンパイラが関数のコンパイルを開始したことを報告するためにアクティブ化されます。  
+  
+## 症状  
+ mscorjit.dll がプロセスに読み込まれたため、既にネイティブ イメージの形式内にあるプログラムのワーキング セットのサイズが増加します。  
+  
+## 原因  
+ プログラムが依存するアセンブリの一部が、ネイティブ形式に生成されていないか、正しく登録されていません。  
+  
+## 解決策  
+ この MDA を有効にすると、JIT コンパイルされた関数を確認できます。  関数を含むアセンブリがネイティブ形式に生成され、正しく登録されているかどうかを確認します。  
+  
+## ランタイムへの影響  
+ この MDA は、メソッドが JIT コンパイルされる直前に、メッセージを記録します。そのため、この MDA を有効にすると、パフォーマンスに大きな影響を与えます。  メソッドがインラインである場合、この MDA は別のメッセージを生成しないことに注意してください。  
+  
+## 出力  
+ サンプル出力を次のコード例に示します。  この出力例では、アセンブリ Test で、クラス "ns2.CO" のメソッド "m" が JIT コンパイルされたことを示します。  
+  
+```  
+method name="Test!ns2.C0::m"  
+```  
+  
+## 構成  
+ 最初に JIT コンパイルされたときに報告されたメソッドをフィルター処理するために使用できるさまざまなフィルターを、次の構成ファイルに示します。  name 属性の値を \* に設定すると、報告されたすべてのメソッドを指定できます。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <jitCompilationStart>  
+      <methods>  
+        <match name="C0::m" />  
+        <match name="MyMethod" />  
+        <match name="C2::*" />  
+        <match name="ns0::*" />  
+        <match name="ns1.C0::*" />  
+        <match name="ns2.C0::m" />  
+        <match name="ns2.C0+N0::m" />  
+      </methods>  
+    </jitCompilationStart >  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ 前の構成ファイルで使用するコード サンプルを次に示します。  
+  
+```  
+using System;  
+using System.Reflection;  
+using System.Runtime.CompilerServices;  
+using System.Runtime.InteropServices;  
+  
+public class Entry  
+{  
+    public static void Main(string[] args)  
+    {  
+        C0.m();  
+        C1.MyMethod();  
+        C2.m();  
+  
+        ns0.C0.m();  
+        ns0.C0.N0.m();  
+        ns0.C1.m();  
+  
+        ns1.C0.m();  
+        ns1.C0.N0.m();  
+  
+        ns2.C0.m();  
+        ns2.C0.N0.m();  
+    }  
+}  
+  
+public class C0  
+{  
+    [MethodImpl(MethodImplOptions.NoInlining)]  
+    public static void m() { }  
+}  
+  
+public class C1  
+{  
+    [MethodImpl(MethodImplOptions.NoInlining)]  
+    public static void MyMethod() { }  
+}  
+  
+public class C2  
+{  
+    [MethodImpl(MethodImplOptions.NoInlining)]  
+    public static void m() { }  
+}  
+  
+namespace ns0  
+{  
+    public class C0  
+    {  
+        [MethodImpl(MethodImplOptions.NoInlining)]  
+        public static void m() { }  
+  
+        public class N0  
+        {  
+            [MethodImpl(MethodImplOptions.NoInlining)]  
+            public static void m() { }  
+        }  
+    }  
+  
+    public class C1  
+    {  
+        [MethodImpl(MethodImplOptions.NoInlining)]  
+        public static void m() { }  
+    }  
+}  
+  
+namespace ns1  
+{  
+    public class C0  
+    {  
+        [MethodImpl(MethodImplOptions.NoInlining)]  
+        public static void m() { }  
+        public class N0  
+        {  
+            [MethodImpl(MethodImplOptions.NoInlining)]  
+            public static void m() { }  
+        }  
+    }  
+}  
+  
+namespace ns2  
+{  
+    public class C0  
+    {  
+        [MethodImpl(MethodImplOptions.NoInlining)]  
+        public static void m() { }  
+  
+        public class N0  
+        {  
+            [MethodImpl(MethodImplOptions.NoInlining)]  
+            public static void m() { }  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/loaderlock-mda.md b/docs/framework/debug-trace-profile/loaderlock-mda.md
new file mode 100644
index 00000000000..7c41d94b0b6
--- /dev/null
+++ b/docs/framework/debug-trace-profile/loaderlock-mda.md
@@ -0,0 +1,69 @@
+---
+title: "loaderLock MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "deadlocks [.NET Framework]"
+  - "LoaderLock MDA"
+  - "MDAs (managed debugging assistants), loader locks"
+  - "managed debugging assistants (MDAs), loader locks"
+  - "operating system loader locks"
+  - "loader locks"
+  - "locks, threads"
+ms.assetid: 8c10fa02-1b9c-4be5-ab03-451d943ac1ee
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# loaderLock MDA
+`loaderLock` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、Microsoft Windows オペレーティング システムのローダー ロックを保持するスレッドでマネージ コードを実行しようとする試みを検出します。このような実行は不正であり、デッドロックの発生につながり、DLL がオペレーティング システムのローダーによって初期化される前に使用される可能性があります。  
+  
+## 症状  
+ オペレーティング システムのローダー ロック内でコードを実行したときの最も一般的なエラーは、ローダー ロックを必要とする他の Win32 関数の呼び出しを試行したときにスレッドがデッドロックするというエラーです。このような関数には、`LoadLibrary`、`GetProcAddress`、`FreeLibrary`、`GetModuleHandle` などがあります。これらの関数はアプリケーションが直接呼び出すのではなく、<xref:System.Reflection.Assembly.Load%2A> のような高水準の呼び出しや、プラットフォーム呼び出しメソッドの最初の呼び出しの結果として、共通言語ランタイム \(CLR: Common Language Runtime\) によって呼び出されます。  
+  
+ デッドロックは、スレッドが別のスレッドが開始または終了するのに待機している場合にも発生することがあります。スレッドが実行を開始または終了したときは、オペレーティング システムのローダー ロックを取得して、影響を受ける DLL にイベントを配信する必要があります。  
+  
+ さらに、オペレーティング システムのローダーによって DLL が適切に初期化される前に、その DLL への呼び出しが発生することもあります。デッドロック エラーは、デッドロックに関連するすべてのスレッドのスタックをチェックすることにより診断できますが、初期化されていない DLL が使用されていないかどうかの診断は、この MDA を使用しないと非常に困難です。  
+  
+## 原因  
+ .NET Framework Version 1.0 または 1.1 用に構築された、マネージとアンマネージの混合 C\+\+ アセンブリは、**\/NOENTRY** とのリンクなど、特別に注意していない場合には、通常、ローダー ロック内でマネージ コードを実行しようとします。このような問題の詳細については、MSDN ライブラリの「Mixed DLL Loading Problem」を参照してください。  
+  
+ .NET Framework Version 2.0 用に構築されたマネージとアンマネージの混合 C\+\+ アセンブリの場合は、このような問題が発生する可能性が低く、オペレーティング システムの規則に違反するアンマネージ DLL を使用するアプリケーションと同様にリスクが低減されています。たとえば、アンマネージ DLL の `DllMain` エントリ ポイントで、`CoCreateInstance` を呼び出して COM に公開されているマネージ オブジェクトを取得しようとすると、ローダー ロック内でマネージ コードの実行が試みられます。  .NET Framework Version 2.0 以降のローダー ロックに関する問題の詳細については、「[混在アセンブリの初期化](../Topic/Initialization%20of%20Mixed%20Assemblies.md)」を参照してください。  
+  
+## 解決策  
+ Visual C\+\+ .NET 2002 および Visual C\+\+ .NET 2003 では、`/clr` コンパイラ オプションを指定してコンパイルされた DLL は、読み込み時に非確定的にデッドロックを生じる可能性があります。この問題は、混在モード DLL 読み込み時の問題 \(またはローダー ロックの問題\) と呼ばれていました。  Visual C\+\+ 2005 以降では、混在モード DLL の読み込みプロセスで、確定的でない場合にこのような問題が発生することがほとんどなくなりました。  ただし、ローダー ロックが \(確定的に\) 発生する可能性のあるシナリオはいくつか残っています。  残っているローダー ロックの問題の原因と解決方法の詳細については、「[混在アセンブリの初期化](../Topic/Initialization%20of%20Mixed%20Assemblies.md)」を参照してください。  このトピックに記載されていないローダー ロックの問題については、スレッドのスタックをチェックして、ローダー ロックが発生している原因と問題の解決方法を確認する必要があります。  スタック トレースをチェックして、この MDA をアクティブにしたスレッドを見つけます。このスレッドは、オペレーティング システムのローダー ロックを保持しながら、マネージ コードへの不正な呼び出しを試みています。DLL の `DllMain` または同等のエントリ ポイントがスタックで確認される可能性があります。このようなエントリ ポイントの内部から正当に実行できる操作は、オペレーティング システムの規則によって非常に制限されています。これらの規則では、すべてのマネージ実行が不可能になっています。  
+  
+## ランタイムへの影響  
+ 通常、プロセス内部のいくつかのスレッドがデッドロックします。これらのスレッドには、ガベージ コレクションを実行するスレッドが含まれている可能性があるため、このデッドロックによってプロセス全体が重大な影響を受けることがあります。さらに、アセンブリや DLL の読み込みとアンロード、スレッドの開始と終了など、オペレーティング システムのローダー ロックが必要な追加の操作ができなくなります。  
+  
+ また、場合によっては、初期化される前に呼び出された DLL でアクセス違反などの問題が発生することもまれにあります。  
+  
+## 出力  
+ この MDA は、不正なマネージ実行が試みられていることを報告します。スレッドのスタックをチェックして、ローダー ロックが発生している原因と問題の解決方法を確認する必要があります。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <loaderLock/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/loadfromcontext-mda.md b/docs/framework/debug-trace-profile/loadfromcontext-mda.md
new file mode 100644
index 00000000000..6c39a96abc5
--- /dev/null
+++ b/docs/framework/debug-trace-profile/loadfromcontext-mda.md
@@ -0,0 +1,86 @@
+---
+title: "loadFromContext MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), LoadFrom context"
+  - "managed debugging assistants (MDAs), LoadFrom context"
+  - "LoadFrom context"
+  - "LoadFromContext MDA"
+ms.assetid: a9b14db1-d3a9-4150-a767-dcf3aea0071a
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# loadFromContext MDA
+`loadFromContext` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、アセンブリが `LoadFrom` コンテキストに読み込まれるとアクティブ化されます。  <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッド、またはその他の類似メソッドを呼び出すと、この状況が発生することがあります。  
+  
+## 症状  
+ 一部のローダー メソッドを使用すると、アセンブリが `LoadFrom` コンテキストに読み込まれることがあります。  このコンテキストを使用すると、シリアル化、キャスト処理、依存関係解決などで、予期しない動作が発生する可能性があります。  一般的に、この問題を回避するには、アセンブリが `Load` コンテキストに読み込まれるようにしてください。  この MDA を使用しないと、アセンブリが読み込まれたコンテキストを判断するのは困難です。  
+  
+## 原因  
+ 一般に、グローバル アセンブリ キャッシュや <xref:System.AppDomainSetup.ApplicationBase%2A?displayProperty=fullName> プロパティなど、`Load` コンテキストの外部のパスからアセンブリが読み込まれると、そのアセンブリは `LoadFrom` コンテキストに読み込まれます。  
+  
+## 解決策  
+ <xref:System.Reflection.Assembly.LoadFrom%2A> 呼び出しが必要なくなるように、アプリケーションを設定します。  これを行うのに使用するテクニックを次に示します。  
+  
+-   アセンブリをグローバル アセンブリ キャッシュにインストールします。  
+  
+-   <xref:System.AppDomain> の <xref:System.AppDomainSetup.ApplicationBase%2A> ディレクトリにアセンブリを配置します。  既定ドメインの場合、<xref:System.AppDomainSetup.ApplicationBase%2A> ディレクトリは、プロセスを開始する実行可能ファイルが含まれるディレクトリです。  アセンブリを移動することが簡単ではない場合は、新規の <xref:System.AppDomain> を作成する必要もあります。  
+  
+-   依存アセンブリが実行可能ファイルに関連した子ディレクトリ内にある場合は、アプリケーションの構成 \(.config\) ファイルまたは第 2 のアプリケーション ドメインに、プローブ パスを追加します。  
+  
+ いずれの場合も、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを使用するように、コードを変更できます。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR に影響ありません。  読み込み要求の結果使用されたコンテキストが報告されます。  
+  
+## 出力  
+ MDA では、アセンブリが `LoadFrom` コンテキストに読み込まれたことが報告されます。  アセンブリの簡易名およびパスが指定されます。  また、`LoadFrom` コンテキストの使用を避けるための代替方法も提案されます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <loadFromContext />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ この MDA をアクティブ化する場合のコード例を次に示します。  
+  
+```  
+using System.Reflection;  
+namespace ConsoleApplication1  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            // The following call caused the LoadFrom context to be used  
+            // because the assembly is loaded using LoadFrom and the path is   
+            // located outside of the Load context probing path.   
+            Assembly.LoadFrom(@"C:\Text\Test.dll");  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/making-an-image-easier-to-debug.md b/docs/framework/debug-trace-profile/making-an-image-easier-to-debug.md
new file mode 100644
index 00000000000..ade0f9cf697
--- /dev/null
+++ b/docs/framework/debug-trace-profile/making-an-image-easier-to-debug.md
@@ -0,0 +1,71 @@
+---
+title: "イメージのデバッグの簡略化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [.NET Framework]、デバッグ"
+  - "実行可能イメージ (デバッグ用の)"
+  - "デバッグ [.NET Framework]、実行可能イメージ"
+ms.assetid: 7d90ea7a-150f-4f97-98a7-f9c26541b9a3
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# イメージのデバッグの簡略化
+アンマネージ コードをコンパイルするときは、IDE スイッチまたはコマンド ライン オプションを使用して、デバッグ用の実行可能イメージを構成できます。  たとえば、Visual C\+\+ で \/**Zi** コマンド ライン オプションを使用すると、デバッグ シンボル ファイル \(拡張子 .pdb\) が生成されます。  同様に、\/**Od** コマンド ライン オプションを使用すると、コンパイラは最適化処理を無効にします。  出力されるコードの処理速度は低下しますが、デバッグは簡単になるため、デバッグ時にはこれらのオプションを指定することをお勧めします。  
+  
+ .NET Framework マネージ コードをコンパイルするとき、Visual C\+\+、Visual Basic、C\# などのコンパイラは、そのソース プログラムをコンパイルして Microsoft Intermediate Language \(MSIL\) を生成します。  MSIL は、実行される直前にコンパイルされて、ネイティブなマシン語コードになります。  アンマネージ コードでは、IDE スイッチまたはコマンド ライン オプションを設定することにより、デバッグ用の実行可能イメージを構成できます。  さらに、ほとんど同じ方法で、デバッグ用の JIT コンパイルを構成することもできます。  
+  
+ このような目的で JIT を構成する場合、次の 2 つの要素が関係してきます。  
+  
+-   開発者は、JIT コンパイラに対し、追跡情報を生成するように要求できます。  追跡情報を生成すると、デバッガーは、MSIL のチェインをマシン語コードの対応部分に対応させたり、ローカル変数と関数の引数が格納される位置を追跡したりできるようになります。.NET Framework Version 2.0 では、JIT コンパイラは常に追跡情報を生成します。そのため、要求する必要がありません。  
+  
+-   開発者は、JIT コンパイラに対し、出力するマシン語コードを最適化しないように要求できます。  
+  
+ 通常、MSIL を生成するコンパイラは、指定された IDE スイッチまたはコマンド ライン オプション \(\/**Od** など\) に基づいて、これらの JIT コンパイラ オプションを適切に設定します。  
+  
+ 場合によっては、JIT コンパイラが生成するマシン語コードをデバッグしやすくするために、JIT コンパイラの動作の変更が必要となることがあります。  たとえば、製品版またはコントロールを最適化するために JIT 追跡情報の生成が必要となる場合などです。  このような場合は、初期化 \(.ini\) ファイルを使用します。  
+  
+ たとえば、MyApp.exe というアセンブリをデバッグする場合は、MyApp.exe と同じフォルダー内に MyApp.ini というテキスト ファイルを作成します。MyApp.ini ファイルには、次の 3 行を記述します。  
+  
+```  
+[.NET Framework Debugging Control]  
+GenerateTrackingInfo=1  
+AllowOptimize=0  
+```  
+  
+ 各オプションの値として、0 または 1 を設定できます。記述しなかったオプションの値は、既定値の 0 に設定されます。  `GenerateTrackingInfo` を 1 に設定し、`AllowOptimize` を 0 に設定すると、デバッグが最も簡単になります。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では、JIT コンパイラが `GenerateTrackingInfo` の値に関係なく常に追跡情報を生成しますが、`AllowOptimize` の値は引き続き効力を持ちます。  [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用して最適化を行わずにネイティブ イメージをプリコンパイルする場合は、`AllowOptimize=0` が記述された .ini ファイルが、Ngen.exe 実行時にターゲット フォルダー内に存在している必要があります。  最適化を行わずにアセンブリをプリコンパイルした場合は、プリコンパイルされたコードを NGen.exe の **\/uninstall** オプションを使用して削除したうえで、Ngen.exe を再度実行してコードを最適化してプリコンパイルする必要があります。  .ini ファイルがフォルダーにない場合は、Ngen.exe が既定でコードを最適化してプリコンパイルします。  
+  
+> [!NOTE]
+>  アセンブリの設定は、<xref:System.Diagnostics.DebuggableAttribute?displayProperty=fullName> によって制御されます。  **DebuggableAttribute** には、2 つのフィールドがあり、それぞれは、JIT コンパイラが最適化処理を実行するかどうか、および追跡情報を生成するかどうかを設定します。  .NET Framework Version 2.0 では、JIT コンパイラは常に追跡情報を生成します。  
+  
+> [!NOTE]
+>  製品版をビルドする場合、コンパイラは **DebuggableAttribute** のどちらのフィールドも設定しません。  JIT コンパイラの既定の動作では、最大のパフォーマンスを達成する、デバッグが最も困難なマシン語コードを生成します。  JIT 追跡を有効にすると、パフォーマンスが多少低下します。最適化処理を無効にすると、パフォーマンスは大幅に低下します。  
+  
+> [!NOTE]
+>  **DebuggableAttribute** は、アセンブリに含まれる個々のモジュールではなく、アセンブリ全体に適用されます。  そのため開発ツールでは、アセンブリが既に作成されている場合は、カスタム属性をアセンブリのメタデータ トークン、または **System.Runtime.CompilerServices.AssemblyAttributesGoHere** というクラスに追加できる必要があります。  次に、ALink ツールによって、これらの **DebuggableAttribute** 属性は、各モジュールからこれらのモジュールが構成の一部となるアセンブリへと昇格されます。  競合が発生すると、ALink の操作は失敗します。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 では、**\/clr**  および **\/Zi** コンパイラ オプションを指定すると、Microsoft Visual C\+\+ コンパイラによって **DebuggableAttribute** が追加されます。  .NET Framework Version 1.1 では、**DebuggableAttribute** をコードに手動で追加するか、**\/ASSEMBLYDEBUG** リンカー オプションを使用する必要があります。  
+  
+## 参照  
+ [Debugging, Tracing, and Profiling](../../../docs/framework/debug-trace-profile/index.md)   
+ [Enabling JIT\-Attach Debugging](../../../docs/framework/debug-trace-profile/enabling-jit-attach-debugging.md)   
+ [Enabling Profiling](http://msdn.microsoft.com/ja-jp/3b669676-f0e0-4ebf-8674-68986dd2020d)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/marshalcleanuperror-mda.md b/docs/framework/debug-trace-profile/marshalcleanuperror-mda.md
new file mode 100644
index 00000000000..2811bec3327
--- /dev/null
+++ b/docs/framework/debug-trace-profile/marshalcleanuperror-mda.md
@@ -0,0 +1,63 @@
+---
+title: "marshalCleanupError MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "cleanup operations"
+  - "marshaling, run-time errors"
+  - "managed debugging assistants (MDAs), marshaling"
+  - "MDAs (managed debugging assistants), marshaling"
+  - "marshaling cleanup error"
+  - "MarshalCleanupError MDA"
+  - "memory, cleanup errors"
+ms.assetid: 2f5d9e7c-ae51-4155-a435-54347aa1f091
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# marshalCleanupError MDA
+共通言語ランタイム \(CLR\) が、ネイティブ コードとマネージ コードの境界間でのデータ型のマーシャリングに使用した一時的な構造体とメモリをクリーンアップしようとしたときにエラーが発生すると、`marshalCleanupError` マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+## 症状  
+ ネイティブ コードとマネージ コードの遷移を実行する場合、スレッド カルチャなどのランタイム状態が復元されない場合、または<xref:System.Runtime.InteropServices.SafeHandle> をクリーンアップしようしてエラーが発生した場合に、メモリ リークが発生します。  
+  
+## 原因  
+ 一時的な構造体のクリーンアップ中に予期しないエラーが発生しました。  
+  
+## 解決策  
+ すべての <xref:System.Runtime.InteropServices.SafeHandle> デストラクター、ファイナライザー、カスタム マーシャラーの実装を調べ、エラーがないかどうかを確認します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ クリーンアップ中に失敗した操作を報告するメッセージ。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <marshalCleanupError />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/marshaling-mda.md b/docs/framework/debug-trace-profile/marshaling-mda.md
new file mode 100644
index 00000000000..0e61dba10ae
--- /dev/null
+++ b/docs/framework/debug-trace-profile/marshaling-mda.md
@@ -0,0 +1,66 @@
+---
+title: "marshaling MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "marshaling, run-time errors"
+  - "marshaling MDA"
+  - "managed debugging assistants (MDAs), marshaling"
+  - "MDAs (managed debugging assistants), marshaling"
+ms.assetid: 5433b1f8-b0e5-40c9-a49a-0e5bd213363d
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# marshaling MDA
+`marshaling` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、CLR がメソッドのパラメーターまたは構造体のフィールドに関するマーシャリング情報を設定するとアクティブ化されます。  この MDA は、JIT コンパイルされたアセンブリでは機能しません。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ この MDA は、マネージ コンテキストとアンマネージ コンテキストのパラメーターまたはフィールドの型、およびその型を含む構造体またはメソッドを表示します。  フィールドの出力の例を次に示します。  
+  
+```  
+Marshaling from 'Char' to 'ANSI char'  
+name="assembly!Namespace.Class::myChar  
+```  
+  
+## 構成  
+ この MDA の構成では、関連するフィールドまたはメソッドの名前を基にして、報告されたマーシャリング情報をフィルター処理できます。  `methodFilter`、`fieldFilter`、および `match` の各要素を使用してフィルターを指定する方法を次の例に示します。  `name` 属性をアスタリスク \(\*\) に設定すると、すべてに一致します。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <marshaling>  
+      <methodFilter>  
+        <match name="Method1"/>  
+        <match name="Method2"/>  
+      </methodFilter>  
+      <fieldFilter>  
+        <match name="Field1"/>  
+        <match name="Field2"/>  
+       </fieldFilter>  
+    </marshaling>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/memberinfocachecreation-mda.md b/docs/framework/debug-trace-profile/memberinfocachecreation-mda.md
new file mode 100644
index 00000000000..17c8d792251
--- /dev/null
+++ b/docs/framework/debug-trace-profile/memberinfocachecreation-mda.md
@@ -0,0 +1,79 @@
+---
+title: "memberInfoCacheCreation MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "member info cache creation"
+  - "MemberInfoCacheCreation MDA"
+  - "reflection, run-time errors"
+  - "MDAs (managed debugging assistants), cache"
+  - "cache [.NET Framework], reflection"
+  - "managed debugging assistants (MDAs), cache"
+  - "MemberInfo cache"
+ms.assetid: 5abdad23-1335-4744-8acb-934002c0b6fe
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# memberInfoCacheCreation MDA
+`memberInfoCacheCreation` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、<xref:System.Reflection.MemberInfo> キャッシュが作成されるとアクティブになります。  これにより、リソース ロードの大きいリフレクション機能を利用しているプログラムがあることがはっきりとわかります。  
+  
+## 症状  
+ プログラムがリソース ロードの大きいリフレクションを使用しているため、プログラムの作業セットが増大します。  
+  
+## 原因  
+ <xref:System.Reflection.MemberInfo> オブジェクトを使用するリフレクション操作はリソース ロードの大きい操作と見なされます。このような操作では、コールド ページに格納されているメタデータを読み取る必要があり、通常、プログラムである種の遅延バインディング シナリオを使用する必要があるためです。  
+  
+## 解決策  
+ プログラムでリフレクションが使用されている場所を特定するには、この MDA を有効にしたうえで、コードをデバッガーで実行するか、または MDA がアクティブになったときにデバッガーに接続します。  デバッガーで、<xref:System.Reflection.MemberInfo> キャッシュの作成場所を示すスタック トレースを取得し、その場所から、プログラムがリフレクションを使用している場所を判別できます。  
+  
+ 解決策は、コードの目的によって異なります。  この MDA により、プログラムが遅延バインディング シナリオを使用していることが警告されます。  事前バインディング シナリオに置き換えることができるかどうかを確認したり、遅延バインディング シナリオのパフォーマンスを検討したりする必要があります。  
+  
+## ランタイムへの影響  
+ この MDA は、作成されるすべての <xref:System.Reflection.MemberInfo> キャッシュに対してアクティブになります。  パフォーマンスへの影響はほとんどありません。  
+  
+## 出力  
+ MDA は、<xref:System.Reflection.MemberInfo> キャッシュが作成されたことを示すメッセージを出力します。  デバッガーを使用して、プログラムがリフレクションを使用している場所を示すスタック トレースを取得します。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <memberInfoCacheCreation/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ `memberInfoCacheCreation` MDA をアクティブにするサンプル コードを次に示します。  
+  
+```  
+using System;  
+  
+public class Exe  
+{  
+    public static void Main()  
+    {  
+        typeof(object).GetMethods();  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Reflection.MemberInfo>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/moduloobjecthashcode-mda.md b/docs/framework/debug-trace-profile/moduloobjecthashcode-mda.md
new file mode 100644
index 00000000000..261bf717994
--- /dev/null
+++ b/docs/framework/debug-trace-profile/moduloobjecthashcode-mda.md
@@ -0,0 +1,76 @@
+---
+title: "moduloObjectHashcode MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "managed debugging assistants (MDAs), hashcode modulus"
+  - "Modulo object hash code"
+  - "moduloObjectHashcode MDA"
+  - "hashcode modulus"
+  - "MDAs (managed debugging assistants), hashcode modulus"
+  - "GetHashCode method"
+  - "modulus of hashcodes"
+ms.assetid: b45366ff-2a7a-4b8e-ab01-537b72e9de68
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# moduloObjectHashcode MDA
+`moduloObjectHashcode` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、<xref:System.Object> クラスの動作を変更し、<xref:System.Object.GetHashCode%2A> メソッドによって返されたハッシュ コードに対してモジュロ演算を実行します。  この MDA の既定の除数は 1 で、この場合、<xref:System.Object.GetHashCode%2A> はすべてのオブジェクトについて 0 \(ゼロ\) を返します。  
+  
+## 症状  
+ 共通言語ランタイム \(CLR: Common Language Runtime\) の新バージョンに移行した後、プログラムが正常に動作しなくなり、次のような症状を示します。  
+  
+-   プログラムが <xref:System.Collections.Hashtable> から不適切なオブジェクトを取得する。  
+  
+-   <xref:System.Collections.Hashtable> の列挙体の順序が変更され、プログラムが中断される。  
+  
+-   同等であった 2 つのオブジェクトが同等でなくなる。  
+  
+-   同等でなかった 2 つのオブジェクトが同等になる。  
+  
+## 原因  
+ <xref:System.Collections.Hashtable> へのキーのクラスでの <xref:System.Object.Equals%2A> メソッドの実装が、<xref:System.Object.GetHashCode%2A> メソッドの呼び出し結果を比較して、オブジェクトが等しいかどうかをテストするため、プログラムが <xref:System.Collections.Hashtable> から不適切なオブジェクトを取得する可能性があります。  オブジェクトが等しいかどうかをテストする場合は、ハッシュ コードを使用しないでください。その理由は、2 つのオブジェクトが、それぞれのフィールドの値が異なる場合でも、同じハッシュ コードを使用している可能性があるからです。  このようなハッシュ コードの衝突は、実際にはまれですが発生することがあります。  この衝突が <xref:System.Collections.Hashtable> 検索に及ぼす影響で、同等でない 2 つのキーが同等であるかのように表示され、<xref:System.Collections.Hashtable> から不適切なオブジェクトが返されます。  パフォーマンス上の理由から、<xref:System.Object.GetHashCode%2A> の実装はランタイム バージョン間で変更される可能性があるため、あるバージョンで発生しない衝突が後続のバージョンで発生することがあります。  ハッシュ コードの衝突時にコードにバグがあるかどうかをテストするには、この MDA を有効にします。  この MDA を有効にすると、<xref:System.Object.GetHashCode%2A> メソッドが 0 \(ゼロ\) を返し、その結果、すべてのハッシュ コードが衝突します。  この MDA を有効にしたときのプログラムへの影響は、プログラムの実行速度が低下することだけです。  
+  
+ キーのハッシュ コードの計算に使用されるアルゴリズムが変更された場合は、<xref:System.Collections.Hashtable> からの列挙体の順序がランタイムのバージョン間で変化することがあります。  プログラムが、ハッシュ テーブルからのキーまたは値の列挙体の順序に依存しているかどうかをテストする場合は、この MDA を有効にできます。  
+  
+## 解決策  
+ ハッシュ コードをオブジェクト ID の代用として使用しないでください。  ハッシュ コードを比較しない <xref:System.Object.Equals%2A?displayProperty=fullName> メソッドのオーバーライドを実装します。  
+  
+ ハッシュ テーブルのキーまたは値の列挙体の順序への依存関係を作成しないでください。  
+  
+## ランタイムへの影響  
+ この MDA を有効にすると、アプリケーションの実行速度が低下します。  この MDA は、返されたハッシュ コードを受け取り、除数で除算したときの剰余を返すだけです。  
+  
+## 出力  
+ この MDA には、出力がありません。  
+  
+## 構成  
+ `modulus` 属性は、ハッシュ コードで使用する除数を指定します。  既定値は 1 です。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <moduloObjectHashcode modulus="1" />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Object.GetHashCode%2A?displayProperty=fullName>   
+ <xref:System.Object.Equals%2A?displayProperty=fullName>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/noncomvisiblebaseclass-mda.md b/docs/framework/debug-trace-profile/noncomvisiblebaseclass-mda.md
new file mode 100644
index 00000000000..45ed8917d95
--- /dev/null
+++ b/docs/framework/debug-trace-profile/noncomvisiblebaseclass-mda.md
@@ -0,0 +1,70 @@
+---
+title: "nonComVisibleBaseClass MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "visible classes"
+  - "managed debugging assistants (MDAs), COM visible classes"
+  - "nonComVisibleBaseClass MDA"
+  - "COM visible classes"
+  - "QueryInterface call failures"
+  - "MDAs (managed debugging assistants), COM visible classes"
+ms.assetid: 9ec1af27-604b-477e-9ee2-e833eb10d3ce
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# nonComVisibleBaseClass MDA
+`nonComVisibleBaseClass` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、COM 参照可能ではない基本クラスから派生した COM 参照可能マネージ クラスの COM 呼び出し可能ラッパー \(CCW: COM Callable Wrapper\) で、ネイティブ コードまたはアンマネージ コードによって `QueryInterface` 呼び出しがなされるとアクティブになります。  `QueryInterface` 呼び出しによって MDA がアクティブになるのは、COM 参照可能マネージ クラスのクラス インターフェイスまたは既定の `IDispatch` が呼び出しによって要求された場合のみです。  `QueryInterface` 呼び出しが、<xref:System.Runtime.InteropServices.ClassInterfaceAttribute> 属性が適用され、COM 参照可能クラスによって明示的に実装された明示的なインターフェイスに対する呼び出しである場合、この MDA はアクティブになりません。  
+  
+## 症状  
+ ネイティブ コードからなされた `QueryInterface` 呼び出しが COR\_E\_INVALIDOPERATION HRESULT により失敗します。  HRESULT は、この MDA をアクティブにする `QueryInterface` 呼び出しをランタイムが許可しないことによって発生することがあります。  
+  
+## 原因  
+ ランタイムは、COM 参照可能ではないクラスから派生した COM 参照可能クラスのクラス インターフェイスまたは既定の `IDispatch` インターフェイスに対する `QueryInterface` 呼び出しを許可できません。これは、バージョン管理に関係する問題が発生する可能性があるからです。  たとえば、COM 参照可能でない基本クラスにパブリック メンバーを追加した場合、基本クラス メンバーを含む派生クラスの vtable がこの変更によって変更されるため、派生クラスを使用する既存の COM クライアントが破損する可能性があります。  COM に公開されている明示的なインターフェイスの場合は、インターフェイスの基本メンバーが vtable に含まれないため、この問題は発生しません。  
+  
+## 解像度  
+ クラス インターフェイスを公開しないでください。  明示的なインターフェイスを定義し、それに <xref:System.Runtime.InteropServices.ClassInterfaceAttribute> 属性を適用します。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ 非 COM 参照可能クラス `Base` から派生した COM 参照可能クラス `Derived` で `QueryInterface` 呼び出しを実行した場合のメッセージ例を次に示します。  
+  
+```  
+A QueryInterface call was made requesting the class interface of COM   
+visible managed class 'Derived'. However since this class derives from   
+non COM visible class 'Base', the QueryInterface call will fail. This   
+is done to prevent the non COM visible base class from being   
+constrained by the COM versioning rules.   
+```  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <nonComVisibleBaseClass />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/notmarshalable-mda.md b/docs/framework/debug-trace-profile/notmarshalable-mda.md
new file mode 100644
index 00000000000..00ac98363fb
--- /dev/null
+++ b/docs/framework/debug-trace-profile/notmarshalable-mda.md
@@ -0,0 +1,64 @@
+---
+title: "notMarshalable MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "managed debugging assistants (MDAs), interface pointer not marshalable"
+  - "interface pointer not marshalable MDA"
+  - "MDAs (managed debugging assistants), interface pointer not marshalable"
+  - "marshaling, run-time errors"
+  - "managed debugging assistants (MDAs), marshaling"
+  - "marshalable interface pointers"
+  - "MDAs (managed debugging assistants), marshaling"
+  - "notMarshalable MDA"
+ms.assetid: 96e7b2c1-843f-4d64-b519-740c3a18b50a
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# notMarshalable MDA
+共通言語ランタイム \(CLR: Common Language Runtime\) がコンテキスト間でインターフェイスをマーシャリングするときに、有効な登録済みのプロキシやスタブのない COM インターフェイス ポインター、または不正な `IMarshal` インターフェイスの実装を検出すると、`notMarshalable` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) がアクティブになります。  
+  
+## 症状  
+ 呼び出しが処理されないか、COM インターフェイス ポインターの不正なコンテキストで発生します。  
+  
+## 原因  
+ コンテキスト間でインターフェイスのマーシャリングを試みたときに、有効な登録済みのプロキシやスタブがないか、`IMarshal` が不正です。  
+  
+## 解像度  
+ プロキシ スタブを登録済みであることと、`IMarshal` の実装が有効であることを確認します。  
+  
+## ランタイムへの影響  
+ この MDA は、ランタイムに影響しません。  
+  
+## 出力  
+ 問題を説明するメッセージ。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <notMarshalable/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/opengenericcercall-mda.md b/docs/framework/debug-trace-profile/opengenericcercall-mda.md
new file mode 100644
index 00000000000..81d19ebad8a
--- /dev/null
+++ b/docs/framework/debug-trace-profile/opengenericcercall-mda.md
@@ -0,0 +1,122 @@
+---
+title: "openGenericCERCall MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), CER calls"
+  - "open generic CER calls"
+  - "constrained execution regions"
+  - "openGenericCERCall MDA"
+  - "CER calls"
+  - "managed debugging assistants (MDAs), CER calls"
+  - "generics [.NET Framework], open generic CER calls"
+ms.assetid: da3e4ff3-2e67-4668-9720-fa776c97407e
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# openGenericCERCall MDA
+`openGenericCERCall` マネージ デバッグ アシスタントは、ルート メソッドにジェネリック型変数を持つ制約された実行領域 \(CER: Constrained Execution Region\) グラフが JIT コンパイル時またはネイティブ イメージ生成時に処理されている場合に、少なくとも 1 つのジェネリック型変数がオブジェクト参照型であることを警告するためにアクティブ化されます。  
+  
+## 症状  
+ スレッドが中止されたときや、アプリケーション ドメインがアンロードされたときに、CER が実行されません。  
+  
+## 原因  
+ JIT コンパイル時には、処理結果のコードが共有され、オブジェクト参照型変数がそれぞれ任意のオブジェクト参照型になる可能性があるため、オブジェクト参照型を含むインスタンス化は代理にすぎません。  これにより、一部のランタイム リソースを前もって準備することが妨げられることがあります。  
+  
+ 特に、ジェネリック型変数を含むメソッドは、バックグラウンドでリソースを非効率的に割り当てる可能性があります。  これらのメソッドは、ジェネリック辞書エントリと呼ばれます。  たとえば、`T` がジェネリック型変数である `List<T> list = new List<T>();`  というステートメントの場合、ランタイムは、実行時に正確なインスタンス化 \(`List<Object>, List<String>` `` など\) を検索する必要があり、さらにその作成が必要になる場合があります。  この操作は、メモリ不足など、開発者が制御できないさまざまな理由で失敗することがあります。  
+  
+ この MDA は、JIT コンパイル時にのみアクティブになり、正確なインスタンス化が存在するときにはアクティブになりません。  
+  
+ この MDA がアクティブになるときは、CER が不正なインスタンス化に対して機能しないという症状が発生する可能性があります。  実際、MDA がアクティブになる状況下では、ランタイムは CER の実装を試みません。  そのため、開発者が CER の共有インスタンス化を使用している場合、目的の CER の領域内で発生した JIT コンパイル エラー、ジェネリック型の読み込みエラー、スレッドの中止などはキャッチされません。  
+  
+## 解決策  
+ CER が存在する可能性があるメソッドには、オブジェクト参照型であるジェネリック型変数を使用しないでください。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ この MDA の出力サンプルを次に示します。  
+  
+ `Method 'GenericMethodWithCer', which contains at least one constrained execution region, cannot be prepared automatically since it has one or more unbound generic type parameters.`  
+  
+ `The caller must ensure this method is prepared explicitly at run time prior to execution.`  
+  
+ `method name="GenericMethodWithCer"`  
+  
+ `declaringType name="OpenGenericCERCall"`  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <openGenericCERCall/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ CER コードは実行されません。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Runtime.CompilerServices;  
+  
+class Program  
+{  
+    static void Main(string[] args)  
+    {  
+        CallGenericMethods();  
+    }  
+    static void CallGenericMethods()  
+    {  
+        // This call is correct. The instantiation of the method  
+        // contains only nonreference types.  
+        MyClass.GenericMethodWithCer<int>();  
+  
+        // This call is incorrect. A shared version of the method that  
+        // cannot be completely analyzed will be JIT-compiled. The   
+        // MDA will be activated at JIT-compile time, not at run time.  
+        MyClass.GenericMethodWithCer<String>();  
+    }  
+}  
+  
+    class MyClass  
+{  
+    public static void GenericMethodWithCer<T>()  
+    {  
+        RuntimeHelpers.PrepareConstrainedRegions();  
+        try  
+        {  
+  
+        }  
+        finally  
+        {  
+            // This is the start of the CER.  
+            Console.WriteLine("In finally block.");  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A>   
+ <xref:System.Runtime.ConstrainedExecution>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/overlappedfreeerror-mda.md b/docs/framework/debug-trace-profile/overlappedfreeerror-mda.md
new file mode 100644
index 00000000000..f363d2e5ae0
--- /dev/null
+++ b/docs/framework/debug-trace-profile/overlappedfreeerror-mda.md
@@ -0,0 +1,66 @@
+---
+title: "overlappedFreeError MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "OverlappedFreeError MDA"
+  - "overlapped free method call error"
+  - "managed debugging assistants (MDAs), overlapped structures"
+  - "overlapped structures"
+  - "MDAs (managed debugging assistants), overlapped structures"
+  - "freeing overlapped structures"
+ms.assetid: b6ab2d48-6eee-4bab-97a3-046b3b0a5470
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# overlappedFreeError MDA
+オーバーラップされた操作が完了する前に <xref:System.Threading.Overlapped.Free%28System.Threading.NativeOverlapped%2A%29?displayProperty=fullName> メソッドが呼び出されると、`overlappedFreeError` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) がアクティブになります。  
+  
+## 症状  
+ アクセス違反またはガベージ コレクションされたヒープの破損。  
+  
+## 原因  
+ 操作が完了する前にオーバーラップされた構造が解放されました。  オーバーラップされたポインターを使用する関数は、解放された後に構造に書き込む可能性があります。  この場合、別のオブジェクトがこの領域を占有することによってヒープが破損する可能性があります。  
+  
+ オーバーラップされた操作が正常に起動しなかった場合、この MDA はエラーを発生しないことがあります。  
+  
+## 解決策  
+ <xref:System.Threading.Overlapped.Free%28System.Threading.NativeOverlapped%2A%29> メソッドを呼び出す前に、オーバーラップされた構造を使用している I\/O 操作が必ず完了するようにします。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ この MDA のサンプル出力を次に示します。  
+  
+ `An overlapped pointer (0x00ea3430) that was not allocated on the GC heap was passed via Pinvoke to the win32 function 'WriteFile' in module 'KERNEL32.DLL'.  If the AppDomain is shut down, this can cause heap corruption when the async I/O completes.  The best solution is to pass a NativeOverlappedStructure retrieved from a call to System.Threading.Overlapped.Pack().  If the AppDomain exits, the CLR will keep this structure alive and pinned until the I/O completes.`  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <overlappedFreeError/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/performance-counters-and-in-process-side-by-side-applications.md b/docs/framework/debug-trace-profile/performance-counters-and-in-process-side-by-side-applications.md
new file mode 100644
index 00000000000..7bbee270ef4
--- /dev/null
+++ b/docs/framework/debug-trace-profile/performance-counters-and-in-process-side-by-side-applications.md
@@ -0,0 +1,67 @@
+---
+title: "Performance Counters and In-Process Side-By-Side Applications | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "performance counters"
+  - "performance counters,and in-process side-by-side applications"
+  - "performance,.NET Framework applications"
+  - "performance monitoring,counters"
+ms.assetid: 6888f9be-c65b-4b03-a07b-df7ebdee2436
+caps.latest.revision: 26
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# Performance Counters and In-Process Side-By-Side Applications
+パフォーマンス モニター \(Perfmon.exe\) を使用すると、ランタイム単位でパフォーマンス カウンターを区別できます。  このトピックでは、この機能を有効にするために必要なレジストリの変更について説明します。  
+  
+## 既定の動作  
+ 既定では、パフォーマンス モニターにはアプリケーション単位でパフォーマンス カウンターが表示されます。  ただし、これが問題となる状況が 2 つあります。  
+  
+-   同じ名前を持つ 2 つのアプリケーションを監視する場合。  たとえば、どちらのアプリケーションも myapp.exe という名前である場合、**\[インスタンス\]** 列には、一方が **myapp** として、もう一方が **myapp\#1** として表示されます。  この場合、パフォーマンス カウンターとアプリケーションの対応関係がわかりにくくなります。  **myapp\#1** について収集されたデータが、最初の myapp.exe のものであるか、2 番目の myapp.exe のものであるかが明確ではありません。  
+  
+-   1 つのアプリケーションで、共通言語ランタイムの複数のインスタンスが使用される場合。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、インプロセスでの side\-by\-side ホスティングのシナリオに対応しています。つまり、1 つのプロセスまたはアプリケーションで、共通言語ランタイムの複数のインスタンスを読み込むことができます。  myapp.exe という名前の 1 つのアプリケーションで 2 つのランタイム インスタンスを読み込む場合、既定では、**\[インスタンス\]** 列にそれぞれ **myapp** と **myapp\#1** として表示されます。  この場合、**myapp** と **myapp\#1** は、同じ名前を持つ 2 つのアプリケーションを指しているのか、2 つのランタイムを使用する 1 つのアプリケーションを指しているのか明確ではありません。  同じ名前を持つ複数のアプリケーションで複数のランタイムを読み込む場合は、さらにあいまいになります。  
+  
+ レジストリ キーを設定すると、このあいまいさを解消することができます。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を使用して開発されたアプリケーションの場合、このレジストリの変更を行うと、**\[インスタンス\]** 列のアプリケーション名にプロセス ID とランタイム インスタンス ID が付加されます。  *application* または *application*\#1 の代わりに、アプリケーションが **\[インスタンス\]** 列の *application*の\_\_`p`*processID*の`r`*runtimeID* として表示されます。  アプリケーションが以前のバージョンの共通言語ランタイムを使用して開発している場合は、そのインスタンスが*application\_*`p`*processID* として [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされている必要があります。  
+  
+## インプロセス side\-by\-side アプリケーションのパフォーマンス カウンター  
+ 1 つのアプリケーションでホストされる複数の共通言語ランタイム バージョンのパフォーマンス カウンターを設定するには、次の表に示すように、1 つのレジストリ キー設定を変更する必要があります。  
+  
+|||  
+|-|-|  
+|キー名|HKEY\_LOCAL\_MACHINE\\System\\CurrentControlSet\\Services\\.NETFramework\\Performance|  
+|値の名前|ProcessNameFormat|  
+|値の種類|REG\_DWORD|  
+|値|1 \(0x00000001\)|  
+  
+ `ProcessNameFormat` の値が 0 の場合は、既定の動作が有効であることを示します。つまり、Perfmon.exe には、アプリケーション単位でパフォーマンス カウンターが表示されます。  この値を 1 に設定すると、Perfmon.exe では、複数のバージョンのアプリケーションのあいまいさを解消し、ランタイム単位でパフォーマンス カウンターを用意します。  `ProcessNameFormat` レジストリ キー設定のその他の値は、今後使用するために予約されており、サポートされていません。  
+  
+ `ProcessNameFormat` レジストリ キー設定を更新したら、インスタンスの名前付け機能を正常に動作させるために、Perfmon.exe またはパフォーマンス カウンターのその他のコンシューマーを再起動する必要があります。  
+  
+ `ProcessNameFormat` 値をプログラムで変更する方法を次の例に示します。  
+  
+ [!code-csharp[Conceptual.PerfCounters.InProSxS#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.perfcounters.inprosxs/cs/regsetting1.cs#1)]
+ [!code-vb[Conceptual.PerfCounters.InProSxS#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.perfcounters.inprosxs/vb/regsetting1.vb#1)]  
+  
+ このレジストリの変更を行うと、Perfmon.exe では *application* がアプリケーションの名前です。*application*での `p`*processID*\_\_の`r`*runtimeID*として [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]を、*processID* であるアプリケーションのプロセス ID を対象とし、*runtimeID* が共通言語ランタイムの ID であるアプリケーションの名前が表示されます。  たとえば、myapp.exe という名前の 1 つのアプリケーションで共通言語ランタイムの 2 つのインスタンスを読み込む場合、Perfmon.exe では、一方のインスタンスが myapp\_p1416\_r10 として、もう一方が myapp\_p3160\_r10 として識別されます。  ランタイム ID は、プロセス内のランタイムのあいまいさを解消するだけで、ランタイムに関するその他の情報は提供しません \(たとえば、ランタイム ID はランタイムのバージョンや SKU とは関係がありません\)。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされている場合、このレジストリの変更は、以前のバージョンの .NET Framework を使用して開発されたアプリケーションにも適用されます。  これらは  *application\_*`p`*processID*として、Perfmon.exe で *application* がアプリケーションの名前で、*processID* はプロセス ID の場合に表示されます。  たとえば、myapp.exe という名前の 2 つのアプリケーションのパフォーマンス カウンターを監視する場合は、一方のアプリケーションが myapp\_p23900 として、もう一方が myapp\_p24908 として表示されます。  
+  
+> [!NOTE]
+>  プロセス ID によって、以前のバージョンのランタイムを使用する同じ名前の 2 つのアプリケーションを区別するときのあいまいさが解消されます。  以前のバージョンの共通言語ランタイムは side\-by\-side 実行に対応していないため、ランタイム ID は以前のバージョンには必要ありません。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] が存在しないかアンインストールされている場合は、このレジストリ キーを設定しても効果はありません。  これは、同じ名前の 2 種類のアプリケーションが *application* と *application\#1* として、Perfmon.exe で表示することを意味します。たとえば、**\[myapp\]** と **\[myapp\#1\]** として\)。
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/performance-counters.md b/docs/framework/debug-trace-profile/performance-counters.md
new file mode 100644
index 00000000000..c985a3f1fd4
--- /dev/null
+++ b/docs/framework/debug-trace-profile/performance-counters.md
@@ -0,0 +1,267 @@
+---
+title: "Performance Counters in the .NET Framework | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "performance, .NET Framework applications"
+  - "performance counters"
+  - "performance monitoring, counters"
+ms.assetid: 06a4ae8c-eeb2-4d5a-817e-b1b95c0653e1
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Performance Counters in the .NET Framework
+このトピックでは、[パフォーマンス モニター](http://technet.microsoft.com/library/cc749249.aspx)で参照できるパフォーマンス カウンターの一覧を示します。  
+  
+-   [例外パフォーマンス カウンター](#exception)  
+  
+-   [相互運用パフォーマンス カウンター](#interop)  
+  
+-   [JIT パフォーマンス カウンター](#jit)  
+  
+-   [読み込みパフォーマンス カウンター](#loading)  
+  
+-   [ロックおよびスレッド パフォーマンス カウンター](#lockthread)  
+  
+-   [メモリ パフォーマンス カウンター](#memory)  
+  
+-   [ネットワーク パフォーマンス カウンター](#networking)  
+  
+-   [セキュリティ パフォーマンス カウンター](#security)  
+  
+<a name="exception"></a>   
+## 例外パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR 例外カテゴリには、アプリケーションによってスローされた例外に関する情報を示すカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# of Exceps Thrown**|アプリケーションの開始後にスローされた例外の総数を表示します。  この数には、.NET 例外と .NET 例外に変換されるアンマネージ例外の両方が含まれます。  たとえば、アンマネージ コードから返された HRESULT は、マネージ コードの例外に変換されます。<br /><br /> このカウンターには、処理済みの例外と未処理の例外の両方が含まれます。  再スローされる例外は、再びカウントされます。|  
+|**\# of Exceps Thrown \/ Sec**|1 秒間にスローされた例外の数を表示します。  この数には、.NET 例外と .NET 例外に変換されるアンマネージ例外の両方が含まれます。  たとえば、アンマネージ コードから返された HRESULT は、マネージ コードの例外に変換されます。<br /><br /> このカウンターには、処理済みの例外と未処理の例外の両方が含まれます。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集の間隔で割った値が表示されます。  多数 \(数百\) の例外がスローされた場合、このカウンターがパフォーマンス上問題があることを示します。|  
+|**\# of Filters \/ Sec**|1 秒間に実行された .NET 例外フィルターの数を表示します。  例外フィルターの評価は、例外が処理済みかどうかに関係なくなされます。<br /><br /> このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**\# of Finallys \/ Sec**|1 秒間に実行された finally ブロックの数を表示します。  finally ブロックは、try ブロックがどのように終了されたかに関係なく必ず実行されます。  例外に対して実行された finally ブロックだけがカウントされます。通常のコード パスで実行された finally ブロックは、このカウンターではカウントされません。<br /><br /> このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Throw to Catch Depth \/ Sec**|1 秒間に走査されたスタック フレーム \(例外をスローしたフレームから例外を処理したフレームまで\) の数を表示します。  このカウンターは、例外ハンドラーに入ったときに 0 にリセットされます。したがって、入れ子になった例外ではハンドラーからハンドラーへのスタックの深さを示します。<br /><br /> このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+  
+<a name="interop"></a>   
+## 相互運用パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR Interop カテゴリには、アプリケーションと COM コンポーネント、COM\+ サービス、および外部タイプ ライブラリとの相互作用に関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# of CCWs**|CCW \(COM 呼び出し可能ラッパー\) の現在数を表示します。  CCW は、アンマネージ COM クライアントから参照されているマネージ オブジェクトのプロキシです。  このカウンターは、アンマネージ COM コードによって参照されたマネージ オブジェクトの数を示します。|  
+|**\# of marshaling**|アプリケーション開始後に引数および戻り値がマネージ コードからアンマネージ コード \(およびその逆に\) にマーシャリングされた回数の合計を表示します。  このカウンターは、スタブがインライン展開されている場合はインクリメントされません。  \(スタブが、引数と戻り値のマーシャリングを担当します\)。  通常、スタブは、マーシャリングのオーバヘッドが小さい場合にインライン展開されます。|  
+|**\# of Stubs**|共通言語ランタイムによって作成された現在のスタブ数を表示します。  スタブは、COM 相互運用呼び出しまたはプラットフォーム起動呼び出し時に、引数と戻り値をマネージ コードからアンマネージ コードへの \(またはその逆の\) マーシャリングを担当します。|  
+|**\# of TLB exports \/ sec**|将来使用するために予約されています。|  
+|**\# of TLB imports \/ sec**|将来使用するために予約されています。|  
+  
+<a name="jit"></a>   
+## JIT パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR JIT カテゴリには、JIT コンパイラでコンパイルされたコードに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# of IL Bytes JITted**|アプリケーションの開始後にジャスト イン タイム \(JIT\) コンパイラでコンパイルされた Microsoft Intermediate Language \(MSIL\) のバイト総数を表示します。  このカウンターは、**Total \# of IL Bytes Jitted** カウンターと同じです。|  
+|**\# of Methods JITted**|アプリケーションの開始後に JIT コンパイラでコンパイルされたメソッドの総数を表示します。  JIT コンパイラでプリコンパイルされているメソッドは、このカウンターに含まれません。|  
+|**% Time in Jit**|前回の JIT コンパイル フェーズ後に JIT コンパイルに費やされた経過時間の割合を示します。  このカウンターは、JIT コンパイル フェーズが終了するごとに、更新されます。  JIT コンパイル フェーズは、メソッドまたはその依存関係がコンパイルされたときに発生します。|  
+|**IL Bytes Jitted \/ sec**|1 秒間に JIT コンパイルされる MSIL バイト数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Standard Jit Failures**|アプリケーションの開始後に JIT コンパイラがコンパイルに失敗したピーク メソッド数を表示します。  このエラーは、MSIL の検査に失敗したときや JIT コンパイラに内部エラーが検出されたときに発生します。|  
+|**Total \# of IL Bytes Jitted**|アプリケーションの開始後に JIT コンパイラでコンパイルされた MSIL のバイト総数を表示します。  このカウンターは、**\# of IL Bytes Jitted** カウンターと同じです。|  
+  
+<a name="loading"></a>   
+## 読み込みパフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR Loading カテゴリには、読み込まれたアセンブリ、クラス、およびアプリケーション ドメインに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**% Time Loading**|将来使用するために予約されています。|  
+|**Assembly Search Length**|将来使用するために予約されています。|  
+|**Bytes in Loader Heap**|クラス ローダーによって、すべてのアプリケーション ドメインで現在コミットされているメモリのサイズ \(バイト数\) を表示します。  コミットされたメモリとは、ディスク ページング ファイル内で予約された物理領域のことです。|  
+|**Current appdomains**|アプリケーションに読み込まれた現在のアプリケーション ドメイン数を表示します。|  
+|**Current Assemblies**|現在実行中のアプリケーションのすべてのアプリケーション ドメインに読み込まれた現在のアセンブリ数を表示します。  多数のアプリケーション ドメインからアセンブリがドメイン中立として読み込まれた場合、このカウンターは一度だけインクリメントされます。|  
+|**Current Classes Loaded**|すべてのアセンブリに読み込まれた現在のクラス数を表示します。|  
+|**Rate of appdomains**|1 秒間に読み込まれたアプリケーション ドメイン数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Rate of appdomains unloaded**|1 秒間にアンロードされたアプリケーション ドメイン数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Rate of Assemblies**|すべてのアプリケーション ドメインにわたって 1 秒間に読み込まれたアセンブリ数を表示します。  多数のアプリケーション ドメインからアセンブリがドメイン中立として読み込まれた場合、このカウンターは一度だけインクリメントされます。<br /><br /> このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Rate of Classes Loaded**|1 秒間にすべてのアセンブリに読み込まれたクラスの数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Rate of Load Failures**|1 秒間で読み込みに失敗したクラスの数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。<br /><br /> 読み取りエラーは、不十分なセキュリティや無効な書式など、さまざまな理由で発生します。  詳細については、プロファイリング サービスのヘルプを参照してください。|  
+|**Total \# of Load Failures**|アプリケーションの開始後に読み込みに失敗したクラスのピーク数を表示します。<br /><br /> 読み取りエラーは、不十分なセキュリティや無効な書式など、さまざまな理由で発生します。  詳細については、プロファイリング サービスのヘルプを参照してください。|  
+|**Total Appdomains**|アプリケーションの開始後に読み込まれたアプリケーション ドメインのピーク数を表示します。|  
+|**Total appdomains unloaded**|アプリケーションの開始後にアンロードされたアプリケーション ドメインの総数を表示します。  アプリケーション ドメインが複数回読み込まれ、アンロードされた場合、このカウンターは、アプリケーション ドメインがアンロードされるごとにインクリメントされます。|  
+|**Total Assemblies**|アプリケーションの開始後に読み込まれたアセンブリの総数を表示します。  多数のアプリケーション ドメインからアセンブリがドメイン中立として読み込まれた場合、このカウンターは一度だけインクリメントされます。|  
+|**Total Classes Loaded**|アプリケーションの開始後にすべてのアセンブリに読み込まれたクラスの累計数を表示します。|  
+  
+<a name="lockthread"></a>   
+## ロックおよびスレッド パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR LocksAndThreads カテゴリには、アプリケーションが使用するマネージ ロックおよびマネージ スレッドに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# of current logical Threads**|アプリケーションの現在のマネージ スレッド オブジェクト数を表示します。  このカウンターでは、実行中のスレッドと停止中のスレッドの両方がカウントされます。  このカウンターは、全時間を通じての平均値ではなく、最後に計測された値のみが表示されます。|  
+|**\# of current physical Threads**|マネージ スレッド オブジェクトの基になるスレッドとして使用するために共通言語ランタイムによって作成され、所有されているネイティブのオペレーティング システムのスレッド数を表示します。  このカウンターの値には、ランタイムが内部操作で使用するスレッドは含まれません。オペレーティング システム プロセスのスレッドのサブセットがカウントされます。|  
+|**\# of current recognized threads**|ランタイムによって現在認識されているスレッド数を表示します。  これらのスレッドは対応するマネージ スレッド オブジェクトに関連付けられます。  ランタイムはこれらのスレッドを作成しませんが、少なくとも一度はランタイムの内部で実行します。<br /><br /> 一意のスレッドだけが追跡されます。これらのスレッドは同じスレッド ID で、ランタイムに再入力されるか、スレッド終了後に再作成され、2 回はカウントされません。|  
+|**\# of total recognized Threads**|アプリケーションの開始後にランタイムによって認識されたスレッドの総数を表示します。  これらのスレッドは対応するマネージ スレッド オブジェクトに関連付けられます。  ランタイムはこれらのスレッドを作成しませんが、少なくとも一度はランタイムの内部で実行します。<br /><br /> 一意のスレッドだけが追跡されます。これらのスレッドは同じスレッド ID で、ランタイムに再入力されるか、スレッド終了後に再作成され、2 回はカウントされません。|  
+|**Contention Rate \/ Sec**|ランタイムのスレッドがマネージ ロック取得の試みに失敗する競合レートを表示します。|  
+|**Current Queue Length**|アプリケーション内でマネージ ロックを待機中のスレッドの総数を表示します。  このカウンターは、全時間を通じての平均値ではなく、最後に計測された値を表示します。|  
+|**Queue Length \/ sec**|アプリケーション内でロックの取得を待機中の 1 秒あたりのスレッド数を表示します。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Queue Length Peak**|アプリケーションの開始後にマネージ ロックの取得を待機していたスレッドの総数を表示します。|  
+|**rate of recognized threads \/ sec**|1 秒間にランタイムによって認識されたスレッド数を表示します。  これらのスレッドは対応するマネージ スレッド オブジェクトに関連付けられます。  ランタイムはこれらのスレッドを作成しませんが、少なくとも一度はランタイムの内部で実行します。<br /><br /> 一意のスレッドだけが追跡されます。これらのスレッドは同じスレッド ID で、ランタイムに再入力されるか、スレッド終了後に再作成され、2 回はカウントされません。<br /><br /> このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Total \# of Contentions**|ランタイムのスレッドがマネージ ロックを取得しようとして失敗した回数の合計を表示します。|  
+  
+<a name="memory"></a>   
+## メモリ パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR Memory カテゴリには、ガベージ コレクターに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# Bytes in all Heaps**|**Gen 1 Heap Size**、**Gen 2 Heap Size**、および **Large Object Heap Size** カウンターの合計値を表示します。  このカウンターは、ガベージ コレクション ヒープに割り当てられている現在のメモリをバイト数で示します。|  
+|**\# GC Handles**|現在使用中のガベージ コレクション ハンドルの数を表示します。  ガベージ コレクション ハンドルは、共通言語ランタイムおよびマネージ環境の外部のリソースへのハンドルです。|  
+|**\# Gen 0 Collections**|アプリケーションの開始後に、ジェネレーション 0 のオブジェクト \(最後に割り当てられた、最も若いオブジェクト\) がガベージ コレクションされた回数を表示します。<br /><br /> ジェネレーション 0 ガベージ コレクションは、割り当て要求を満たすために利用できるジェネレーション 0 のメモリが不足したときに発生します。  このカウンターは、ジェネレーション 0 のガベージ コレクションの最後にインクリメントされます。  上位のジェネレーションのガベージ コレクションには、それより下位のすべてのジェネレーションのコレクションが含まれます。  このカウンターは、上位のジェネレーション \(ジェネレーション 1 または 2\) ガベージ コレクションが発生したときに明示的にインクリメントされます。<br /><br /> このカウンターは、最後に計測された値を表示します。  **\_Global\_** カウンターの値は正確でないので、無視する必要があります。|  
+|**\# Gen 1 Collections**|アプリケーションの開始後にジェネレーション 1 のオブジェクトをガベージ コレクションした回数を表示します。<br /><br /> このカウンターは、ジェネレーション 1 のガベージ コレクションの最後にインクリメントされます。  上位のジェネレーションのガベージ コレクションには、それより下位のすべてのジェネレーションのコレクションが含まれます。  このカウンターは、上位のジェネレーション \(ジェネレーション 2\) ガベージ コレクションが発生したときに明示的にインクリメントされます。<br /><br /> このカウンターは、最後に計測された値を表示します。  **\_Global\_** カウンターの値は正確でないので、無視する必要があります。|  
+|**\# Gen 2 Collections**|アプリケーションの開始後にジェネレーション 2 のオブジェクトをガベージ コレクションした回数を表示します。  このカウンターは、ジェネレーション 2 ガベージ コレクション \(フル ガベージ コレクションとも呼ばれる\) の最後にインクリメントされます。<br /><br /> このカウンターは、最後に計測された値を表示します。  **\_Global\_** カウンターの値は正確でないので、無視する必要があります。|  
+|**\# Induced GC**|明示的な <xref:System.GC.Collect%2A?displayProperty=fullName> 呼び出しが原因でガベージ コレクションが実行されたピーク回数を表示します。  ガベージ コレクターのコレクションの頻度を調整することをお勧めします。|  
+|**\# of Pinned Objects**|最後のガベージ コレクションで検出されたピン止めオブジェクトの数を表示します。  ピン止めオブジェクトとは、ガベージ コレクターがメモリ内を移動させることのできないオブジェクトです。  このカウンターは、ガベージ コレクションされるヒープ内のピン止めオブジェクトだけを追跡します。  たとえば、ジェネレーション 0 のガベージ コレクションは、ジェネレーション 0 のヒープ内のピン止めオブジェクトだけを列挙します。|  
+|**\# of Sink Blocks in use**|現在使用中の同期ブロックの数を表示します。  同期ブロックは、同期情報を格納するためにオブジェクトごとに割り当てられるデータ構造体です。  同期ブロックは、マネージ オブジェクトへの弱い参照を保持します。ガベージ コレクターは、同期ブロックをスキャンする必要があります。  同期ブロックには、同期情報だけでなく、COM 相互運用メタデータも格納できます。  このカウンターは、同期プリミティブの頻繁な使用に関係するパフォーマンス問題を示します。|  
+|**\# Total committed Bytes**|ガベージ コレクターによって現在コミットされている仮想メモリの量をバイト数で表示します。  コミットされたメモリとは、ディスク ページング ファイル内で領域が予約された物理メモリのことです。|  
+|**\# Total reserved Bytes**|ガベージ コレクターによって現在予約済みの仮想メモリの量をバイト数で表示します。  予約済みのメモリとは、アプリケーション用に予約された仮想メモリ空間のことですが、ディスクやメイン メモリ ページは使用されません。|  
+|**% Time in GC**|前回のガベージ コレクション サイクルにガベージ コレクションの実行に費やされた経過時間の割合を表示します。  このカウンターは、通常、ガベージ コレクターがアプリケーションに代わってメモリをコレクションし、メモリの領域を圧縮するために実行した作業量を示します。  このカウンターは、ガベージ コレクションが終了するごとにのみ、更新されます。  このカウンターは、平均値ではなく、最後に計測された値を反映します。|  
+|**Allocated Bytes\/second**|1 秒間にガベージ コレクション ヒープに割り当てられたバイト数を表示します。  このカウンターは、割り当てがなされるたびに更新されるのではなく、ガベージ コレクションが終了するごとに、更新されます。  このカウンターは、全時間を通しての平均値ではなく、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Finalization Survivors**|ガベージ コレクションされたオブジェクトのうち、終了待機中のためにコレクションされなかったものの数を表示します。  これらのオブジェクトが他のオブジェクトへの参照を保持している場合は、参照先のオブジェクトもコレクションされず、このカウンターではカウントされません。  **Promoted Finalization\-Memory from Gen 0** カウンターは、終了処理のためにコレクションされなかったすべてのメモリを表します。<br /><br /> このカウンターの値は累計値ではありません。カウンター値は、ガベージ コレクションが終了するごとに、各コレクションのみでの残存オブジェクト数に更新されます。  このカウンターは、アプリケーションが終了処理のために必要とする追加のオーバーヘッドを示します。|  
+|**Gen 0 heap size**|ジェネレーション 0 に割り当てることができる最大バイト数を表示します。ジェネレーション 0 に現在割り当てられているバイト数を示すのではありません。<br /><br /> 前回のコレクションの後でなされた割り当てがこのサイズを超えると、ジェネレーション 0 のガベージ コレクションが発生します。  ジェネレーション 0 のサイズは、ガベージ コレクターによって調整され、アプリケーションの実行中に変更できます。  ジェネレーション 0 コレクションの最後には、ジェネレーション 0 ヒープのサイズは 0 バイトになります。  このカウンターは、次のジェネレーション 0 ガベージ コレクションを起動する割り当てのサイズをバイト数で表示します。<br /><br /> このカウンターは、割り当てがなされるたびに更新されるのではなく、ガベージ コレクションが 1 回終了するごとに更新されます。|  
+|**Gen 0 Promoted Bytes\/Sec**|1 秒間にジェネレーション 0 からジェネレーション 1 に昇格されるバイト数を表示します。  メモリは、ガベージ コレクションで回収されなかった場合に昇格されます。  このカウンターは、1 秒間に作成される、比較的有効期間の長いオブジェクトの数を示します。<br /><br /> このカウンターには、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Gen 1 heap size**|ジェネレーション 1 の現在のバイト数を表示します。このカウンターは、ジェネレーション 1 の最大サイズを表示するのではありません。  ジェネレーション 1 では、オブジェクトは直接には割り当てられず、前のジェネレーション 0 ガベージ コレクションから昇格されます。  このカウンターは、割り当てがなされるたびに更新されるのではなく、ガベージ コレクションが 1 回終了するごとに更新されます。|  
+|**Gen 1 Promoted Bytes\/Sec**|1 秒間にジェネレーション 1 からジェネレーション 2 に昇格されるバイト数を表示します。  終了待機中という理由だけで昇格されるオブジェクトは、このカウンターには含まれません。<br /><br /> メモリは、ガベージ コレクションで回収されなかった場合に昇格されます。  ジェネレーション 2 は最も古いジェネレーションであるため、ジェネレーション 2 からは昇格されません。  このカウンターは、1 秒間に作成される非常に有効期間の長いオブジェクトを示します。<br /><br /> このカウンターには、最後の 2 回の収集で計測された値の差を収集間隔で割った値が表示されます。|  
+|**Gen 2 heap size**|ジェネレーション 2 の現在のバイト数を表示します。  ジェネレーション 2 では、オブジェクトは直接には割り当てられず、前のジェネレーション 1 のガベージ コレクション中にジェネレーション 1 から昇格されます。  このカウンターは、割り当てがなされるたびに更新されるのではなく、ガベージ コレクションが 1 回終了するごとに更新されます。|  
+|**Large Object Heap size**|大きいオブジェクトのヒープの現在のサイズをバイト数で表示します。  約 85,000 バイトより大きいオブジェクトは、ガベージ コレクターによって大きいオブジェクトとして扱われ、特殊なヒープに直接割り当てられます。それらに対してジェネレーション間の昇格は実行されません。  このカウンターは、割り当てがなされるたびに更新されるのではなく、ガベージ コレクションが 1 回終了するごとに更新されます。|  
+|**プロセス ID**|監視される CLR プロセス インスタンスのプロセス ID を表示します。|  
+|**Promoted Finalization\-Memory from Gen 0**|ジェネレーション 0 からジェネレーション 1 に昇格されるメモリのうち、終了待機中という理由だけで昇格されるメモリのバイト数を表示します。  このカウンターは累計値ではありません。最後のガベージ コレクションで計測された値を表示します。|  
+|**Promoted Memory from Gen 0**|ガベージ コレクションで回収されず、ジェネレーション 0 からジェネレーション 1 に昇格されるメモリのバイト数を表示します。  終了待機中という理由だけで昇格されるオブジェクトは、このカウンターには含まれません。  このカウンターは累計値ではありません。最後のガベージ コレクションで計測された値を表示します。|  
+|**Promoted Memory from Gen 1**|ガベージ コレクションで回収されず、ジェネレーション 1 からジェネレーション 2 に昇格されるメモリのバイト数を表示します。  終了待機中という理由だけで昇格されるオブジェクトは、このカウンターには含まれません。  このカウンターは累計値ではありません。最後のガベージ コレクションで計測された値を表示します。  このカウンターは、最後のガベージ コレクションがジェネレーション 0 のコレクションである場合だけ、0 にリセットされます。|  
+  
+<a name="networking"></a>   
+## ネットワーク パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR Networking カテゴリには、アプリケーションがネットワーク経由で送受信するデータに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**Bytes Received**|プロセスの開始後に <xref:System.AppDomain> 内のすべての <xref:System.Net.Sockets.Socket> オブジェクトが受信した累計バイト数。  この数には、データおよび TCP\/IP によって定義されていないプロトコル情報が含まれます。|  
+|**Bytes Sent**|プロセスの開始後に <xref:System.AppDomain> 内のすべての <xref:System.Net.Sockets.Socket> オブジェクトが送信した累計バイト数。  この数には、データおよび TCP\/IP によって定義されていないプロトコル情報が含まれます。|  
+|**Connections Established**|プロセスの開始後に <xref:System.AppDomain> 内で接続されていたストリーム ソケットの <xref:System.Net.Sockets.Socket> オブジェクトの累計数。|  
+|**Datagrams Received**|プロセスの開始後に <xref:System.AppDomain> 内のすべての <xref:System.Net.Sockets.Socket> オブジェクトが受信したデータグラム パケットの累計バイト数。|  
+|**Datagrams Sent**|プロセスの開始後に <xref:System.AppDomain> 内のすべての <xref:System.Net.Sockets.Socket> オブジェクトが送信したデータグラム パケットの累計バイト数。|  
+|**HttpWebRequest Average Lifetime**|プロセスの開始後に <xref:System.AppDomain> 内で最後の間隔で終了したすべての <xref:System.Net.HttpWebRequest> オブジェクトの平均完了時間。|  
+|**HttpWebRequest Average Queue Time**|プロセスの開始後に <xref:System.AppDomain> 内で最後の間隔でキューに残ったすべての <xref:System.Net.HttpWebRequest> オブジェクトのキューでの平均待機時間。|  
+|**HttpWebRequests Created\/sec**|<xref:System.AppDomain> 内で 1 秒あたりに作成された <xref:System.Net.HttpWebRequest> オブジェクトの数。|  
+|**HttpWebRequests Queued\/sec**|<xref:System.AppDomain> 内で 1 秒あたりにキューに追加された <xref:System.Net.HttpWebRequest> オブジェクトの数。|  
+|**HttpWebRequests Aborted\/sec**|<xref:System.AppDomain> 内でアプリケーションが <xref:System.Net.HttpWebRequest.Abort%2A> メソッドを呼び出した <xref:System.Net.HttpWebRequest> オブジェクトの 1 秒あたりの数。|  
+|**HttpWebRequests Failed\/sec**|<xref:System.AppDomain> 内でサーバーから失敗したステータス コードを受け取った <xref:System.Net.HttpWebRequest> オブジェクトの 1 秒あたりの数。|  
+  
+ サポートされているネットワーク パフォーマンス カウンターのクラスを次に示します。  
+  
+-   イベントが発生した回数を測定するイベント カウンター。  
+  
+-   送信または受信されたデータの量を測定するデータ カウンター。  
+  
+-   各種プロセスが実行される時間を測定する時間計測カウンター。  時間は、オブジェクトの状態が変わった後に、間隔 \(通常は秒単位\) ごとに計測されます。  
+  
+-   間隔 \(通常は秒単位\) ごとに特定の遷移を形成するオブジェクトの数を測定する間隔ごとのカウンター。  
+  
+ イベントのネットワーク パフォーマンス カウンターには、次のようなものがあります。  
+  
+-   **Connections Established**  
+  
+-   **Datagrams Received**  
+  
+-   **Datagrams Sent**  
+  
+ これらのパフォーマンス カウンターは、プロセス開始後のカウントを提供します。  確立された <xref:System.Net.Sockets.Socket> 接続のカウントには、確立されたストリーム ソケット接続用のアプリケーションによる明示的な <xref:System.Net.Sockets.Socket> メソッド呼び出しと、その他のクラス \(<xref:System.Net.HttpWebRequest>、<xref:System.Net.FtpWebRequest>、<xref:System.Net.WebClient>、<xref:System.Net.Sockets.TcpClient> など\) による <xref:System.Net.Sockets.Socket> クラスの内部呼び出しが含まれます。  
+  
+ **Datagrams Received** と **Datagrams Sent** のカウントには、アプリケーションによる明示的な <xref:System.Net.Sockets.Socket> メソッド呼び出しを使用して送受信されたデータグラム パケットと、その他のクラス \(<xref:System.Net.Sockets.UdpClient> など\) による <xref:System.Net.Sockets.Socket> の内部呼び出しが含まれます。  クラスの新しいインスタンスを初期化します。  **Datagrams Received** と **Datagrams Sent** のカウントは、データグラムの平均的なサイズを推測することで、データグラムを使用して送受信されたバイトの数の概算を提供するためにも使用できます。  
+  
+ データのネットワーク パフォーマンス カウンターには、次のようなものがあります。  
+  
+-   **Bytes Received**  
+  
+-   **Bytes Sent**  
+  
+ これらのカウンターは、プロセス開始後のバイトのカウントを提供します。  
+  
+ <xref:System.Net.HttpWebRequest> オブジェクトが有効期間全体またはその一部を通過するのに要する時間を計測する時間計測カウンターには、次の 2 つがあります。  
+  
+-   **HttpWebRequest Average Lifetime**  
+  
+-   **HttpWebRequest Average Queue Time**  
+  
+ **HttpWebRequest Average Lifetime** カウンターの場合、大部分の <xref:System.Net.HttpWebRequest> オブジェクトの有効期間は、常に、オブジェクトが作成されたときに開始し、アプリケーションによって応答ストリームが閉じられたときに終了します。  ただし、例外的なシナリオが 2 つあります。  
+  
+-   アプリケーションが  <xref:System.Net.HttpWebRequest.GetResponse%2A> メソッドまたは <xref:System.Net.HttpWebRequest.BeginGetResponse%2A> メソッドの呼び出しをしない場合、<xref:System.Net.HttpWebRequest> オブジェクトの有効期間は無視されます。  
+  
+-   <xref:System.Net.HttpWebRequest.GetResponse%2A> メソッドまたは <xref:System.Net.HttpWebRequest.EndGetResponse%2A> メソッドを呼び出したときに <xref:System.Net.HttpWebRequest> オブジェクトが <xref:System.Net.WebException> をスローした場合、その例外がスローされたときに有効期間は終了します。  技術的には、基になる応答ストリームもその時点で閉じられます \(ユーザーに返される応答ストリームは、実際には、応答ストリームのコピーを含むメモリ ストリームです\)。  
+  
+ 間隔ごとに特定の <xref:System.Net.HttpWebRequest> オブジェクトの動作を追跡するカウンターが 4 つあります。  これらのパフォーマンス カウンターは、アプリケーション開発者、管理者、およびサポート スタッフが、<xref:System.Net.HttpWebRequest> オブジェクトの動作をより的確に把握するのに役立ちます。  これらのカウンターは、次のとおりです。  
+  
+-   **HttpWebRequests Created\/sec**  
+  
+-   **HttpWebRequests Queued\/sec**  
+  
+-   **HttpWebRequests Aborted\/sec**  
+  
+-   **HttpWebRequests Failed\/sec**  
+  
+ **HttpWebRequests Aborted\/sec** カウンターでは、<xref:System.Net.HttpWebRequest.Abort%2A> の内部呼び出しもカウントされます。  これらの内部呼び出しは、通常、一部のアプリケーションが測定するタイムアウトによって発生します。  
+  
+ **HttpWebRequests Failed\/sec** カウンターには、サーバーから失敗したステータス コードを受け取った <xref:System.Net.HttpWebRequest> オブジェクトの 1 秒あたりの数が含まれます。  これは、要求の終了時に Http サーバーから受け取ったステータス コードが 200 ～ 299 の範囲内にないことを意味します。  ステータス コードが処理され、結果として新しい要求が発行されると \(401 Unauthorized ステータス コードの大半など\)、ステータス コードは再試行の結果に基づいて失敗または成功します。  再試行においてアプリケーションにエラーがあると、このカウンターはインクリメントされます。  
+  
+ ネットワーク パフォーマンス カウンターにアクセスして管理するには、<xref:System.Diagnostics.PerformanceCounter> および <xref:System.Diagnostics> 名前空間内の関連クラスを使用します。  ネットワーク パフォーマンス カウンターは、Windows パフォーマンス モニター コンソールでも参照できます。  
+  
+ ネットワーク パフォーマンス カウンターは、使用される構成ファイルで有効になっている必要があります。  すべてのネットワーク パフォーマンス カウンターは、構成ファイル内の 1 つの設定で有効または無効にされます。  ネットワーク パフォーマンス カウンターを個別に有効または無効にすることはできません。  詳細については、「[\<performanceCounters\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/performancecounter-element-network-settings.md)」を参照してください。  
+  
+ ネットワーク カウンターが有効であると、per\-AppDomain カウンターとグローバル パフォーマンス カウンターの両方が作成され、更新されます。  無効にすると、アプリケーションはどのネットワーク パフォーマンス カウンターのデータも提供しません。  
+  
+ パフォーマンス カウンターは、カテゴリ別にグループ化されます。  アプリケーションは、次のサンプル コードを使用して、すべてのカテゴリを一覧表示できます。  
+  
+```  
+PerformanceCounterCategory[] Array = PerformanceCounterCategory.GetCategories();  
+for (int i = 0; i < Array.Length; i++)  
+{  
+    Console.Out.WriteLine("{0}. Name={1} Help={2}", i, Array[i].CategoryName, Array[i].CategoryHelp);  
+}  
+  
+```  
+  
+ ネットワーク パフォーマンス カウンターは、次の 2 つのカテゴリに一覧表示されます。  
+  
+-   ".NET CLR Networking" \- .NET Framework Version 2 で導入され、.NET Framework Version 2 以降でサポートされている元のパフォーマンス カウンター。  
+  
+-   ".NET CLR Networking 4.0.0.0" \- 上に示したすべてのソケット カウンターと、.NET Framework Version 4 以降でサポートされている新しいパフォーマンス カウンター。  これらの新しいカウンターは、<xref:System.Net.HttpWebRequest> オブジェクトに関するパフォーマンス情報を提供します。  
+  
+ アプリケーションでパフォーマンス カウンターにアクセスして管理する方法の詳細については、「[Performance Counters](../../../docs/framework/debug-trace-profile/performance-counters.md)」を参照してください。  
+  
+<a name="security"></a>   
+## セキュリティ パフォーマンス カウンター  
+ パフォーマンス コンソール .NET CLR Security カテゴリには、共通言語ランタイムがアプリケーションに対して実行するセキュリティ チェックに関する情報を提供するカウンターが含まれます。  これらのパフォーマンス カウンターについて、次の表で説明します。  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|**\# Link Time Checks**|アプリケーションの開始後に実行されたリンク時のコード アクセス セキュリティ チェックの総数を表示します。  リンク時のコード アクセス セキュリティ チェックは、ジャスト イン タイム \(JIT\) コンパイル時に呼び出し元が特別のアクセス許可を要求したときに実行されます。  リンク時のチェックは、呼び出し元ごとに 1 回実行されます。  このカウントは、重大なパフォーマンス上の問題を示すのではなく、単にセキュリティ システムの実行状況を示します。|  
+|**% Time in RT checks**|最後の収集の後にランタイム コード アクセス セキュリティ チェックの実行に費やされた経過時間の割合を表示します。  このカウンターは、.NET Framework セキュリティ チェックの最後に更新されます。  このカウンターは、平均値ではなく、最後に計測された値を表します。|  
+|**% Time Sig Authenticating**|将来使用するために予約されています。|  
+|**Stack Walk Depth**|最後のランタイム コード アクセス セキュリティ チェック時のスタックの深さを表示します。  ランタイム コード アクセス セキュリティ チェックは、スタックを調査することによって実行されます。  このカウンターは、平均値ではなく、最後に計測された値のみを表示します。|  
+|**Total Runtime Checks**|アプリケーションの開始後に実行されたランタイム コード アクセス セキュリティ チェックの総数を表示します。  ランタイム コード アクセス セキュリティ チェックは、呼び出し元が特別のアクセス許可を要求したときに実行されます。  ランタイム チェックは、呼び出し元からのすべての呼び出しに対して実行され、呼び出し元の現在のスレッド スタックをチェックします。  このカウンターを **Stack Walk Depth** カウンターと共に使用することで、セキュリティ チェック時に発生するパフォーマンス低下を把握できます。|  
+  
+## 参照  
+ [Performance Counters](../../../docs/framework/debug-trace-profile/performance-counters.md)   
+ [ランタイム プロファイリング](../../../docs/framework/debug-trace-profile/runtime-profiling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/pinvokelog-mda.md b/docs/framework/debug-trace-profile/pinvokelog-mda.md
new file mode 100644
index 00000000000..ee32cc5aa72
--- /dev/null
+++ b/docs/framework/debug-trace-profile/pinvokelog-mda.md
@@ -0,0 +1,58 @@
+---
+title: "pInvokeLog MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "signatures, platform invoke"
+  - "MDAs (managed debugging assistants), platform invoke"
+  - "platform invoke, run-time errors"
+  - "platform invoke log"
+  - "PInvokeLog MDA"
+  - "managed debugging assistants (MDAs), platform invoke"
+ms.assetid: b830444a-5003-49fe-b89b-b8bee22f7b1a
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# pInvokeLog MDA
+`pInvokeLog` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、実行中に使用された一意のプラットフォーム呼び出しシグネチャごとにアクティブ化されます。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ 実行中に使用されたプラットフォーム呼び出しシグネチャを示すメッセージです。  
+  
+## 構成  
+ それぞれの一致要素は、プラットフォーム呼び出しが行われた .dll ファイルをフィルター処理します。  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <pInvokeLog>  
+      <filter>  
+        <match dllName="user32.dll"/>  
+        <match dllName="kernel32.dll"/>  
+      </filter>  
+    </pInvokeLog>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md b/docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md
new file mode 100644
index 00000000000..d77f769ca1b
--- /dev/null
+++ b/docs/framework/debug-trace-profile/pinvokestackimbalance-mda.md
@@ -0,0 +1,76 @@
+---
+title: "pInvokeStackImbalance MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "signatures, platform invoke"
+  - "stack depth"
+  - "platform invoke stack imbalance"
+  - "MDAs (managed debugging assistants), platform invoke"
+  - "platform invoke, run-time errors"
+  - "PInvokeStackImbalance MDA"
+  - "managed debugging assistants (MDAs), platform invoke"
+ms.assetid: 34ddc6bd-1675-4f35-86aa-de1645d5c631
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# pInvokeStackImbalance MDA
+<xref:System.Runtime.InteropServices.DllImportAttribute> の属性で指定される呼び出し規約、およびマネージ シグネチャ内のパラメーターの宣言が指定されている場合に、プラットフォーム呼び出しが、予想されるスタックの深さに一致しないことを CLR が検出したときに、`pInvokeStackImbalance` マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+> [!NOTE]
+>  `pInvokeStackImbalance` MDA は 32 ビット x86 プラットフォームに対してのみ実装されています。  
+  
+> [!NOTE]
+>  .NET Framework version 3.5 で、 `pInvokeStackImbalance` MDA は既定で無効になります。  .NET Framework version 3.5 と Visual Studio 2005 を使用すると、`pInvokeStackImbalance` MDA が **\[例外\]** ダイアログ ボックス \(**\[デバッグ\]** メニューの**\[例外\]** をクリックすると表示される\) の **\[マネージ デバッグ アシスタント\]** の一覧に表示されます。  ただし、**\[スローされるとき\]** のチェック ボックスを `pInvokeStackImbalance` をオンまたはオフにしても、MDA は有効または無効になりません。MDA がアクティブ化されたときに Visual Studio が例外をスローするかどうかのみを制御します。  
+  
+## 症状  
+ プラットフォーム呼び出しの実行時または実行後に、アプリケーションでアクセス違反またはメモリ破損が発生します。  
+  
+## 原因  
+ プラットフォーム呼び出しのマネージ シグネチャが、呼び出されているメソッドのアンマネージ シグネチャと一致しない可能性があります。  この不一致は、正しい数のパラメーターを宣言しないか、適切なサイズのパラメーターを指定しないマネージ シグネチャで発生する可能性があります。  また、<xref:System.Runtime.InteropServices.DllImportAttribute> 属性によって指定されている可能性がある呼び出し規約が、アンマネージ呼び出し規約と一致しない場合にも、MDA がアクティブ化される可能性があります。  
+  
+## 解像度  
+ マネージ プラットフォーム呼び出しシグネチャ、および呼び出し規則を確認して、ネイティブ ターゲットのシグネチャと呼び出し規約に一致することを確認します。  マネージ側とアンマネージ側の両方で、呼び出し規約を明示的に指定してください。  また、あまり可能性はありませんが、アンマネージ コンパイラのバグなど、何らかの理由によりアンマネージ関数でスタックの不均衡が発生している場合もあります。  
+  
+## ランタイムへの影響  
+ すべてのプラットフォーム呼び出しが、CLR の最適化されていないパスを取得するよう強制します。  
+  
+## 出力  
+ MDA メッセージが、スタックの不均衡の原因であるプラットフォーム呼び出しメソッド呼び出しの名前を示します。  メソッド `SampleMethod` のプラットフォーム呼び出しのサンプル メッセージは、次のとおりです。  
+  
+```  
+A call to PInvoke function 'SampleMethod' has unbalanced the stack.   
+This is likely because the managed PInvoke signature does not match   
+the unmanaged target signature. Check that the calling convention and   
+parameters of the PInvoke signature match the target unmanaged signature.  
+```  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <pInvokeStackImbalance />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/raceonrcwcleanup-mda.md b/docs/framework/debug-trace-profile/raceonrcwcleanup-mda.md
new file mode 100644
index 00000000000..6d70e7e40e7
--- /dev/null
+++ b/docs/framework/debug-trace-profile/raceonrcwcleanup-mda.md
@@ -0,0 +1,62 @@
+---
+title: "raceOnRCWCleanup MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "RCW"
+  - "managed debugging assistants (MDAs), RCWs"
+  - "race on RCW cleanup"
+  - "MDAs (managed debugging assistants), RCWs"
+  - "RaceOnRCWCleanup MDA"
+  - "runtime callable wrappers"
+ms.assetid: bee1e9b1-50a8-4c89-9cd9-7dd6b2458187
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# raceOnRCWCleanup MDA
+<xref:System.Runtime.InteropServices.Marshal.ReleaseComObject%2A?displayProperty=fullName> メソッドなどのコマンドを使用して [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW: Runtime Callable Wrapper\) を解放する呼び出しがなされた時点でその RCW が使用中であることを共通言語ランタイム \(CLR: Common Language Runtime\) が検出すると、`raceOnRCWCleanup` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) がアクティブ化されます。  
+  
+## 症状  
+ <xref:System.Runtime.InteropServices.Marshal.ReleaseComObject%2A> メソッド、または類似メソッドを使用して RCW が解放中または解放後に、アクセス違反またはメモリ破損が発生します。  
+  
+## 原因  
+ 別のスレッドまたは解放中のスレッド スタックで、RCW が使用中です。  使用中の RCW は解放できません。  
+  
+## 解像度  
+ 現在のスレッドまたは他のスレッドで使用中の可能性がある RCW は、解放しないでください。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ エラーを説明するメッセージです。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <raceOnRCWCleanup/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/reentrancy-mda.md b/docs/framework/debug-trace-profile/reentrancy-mda.md
new file mode 100644
index 00000000000..b3e46d308c5
--- /dev/null
+++ b/docs/framework/debug-trace-profile/reentrancy-mda.md
@@ -0,0 +1,118 @@
+---
+title: "reentrancy MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "unmanaged code, debugging"
+  - "transitioning threads unmanaged to managed code"
+  - "reentrancy MDA"
+  - "reentrancy without an orderly transition"
+  - "managed debugging assistants (MDAs), reentrancy"
+  - "illegal reentrancy"
+  - "MDAs (managed debugging assistants), reentrancy"
+  - "threading [.NET Framework], managed debugging assistants"
+  - "managed code, debugging"
+  - "native debugging, MDAs"
+ms.assetid: 7240c3f3-7df8-4b03-bbf1-17cdce142d45
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# reentrancy MDA
+`reentrancy` マネージ デバッグ アシスタント \(MDA: Managed Debugging Assistant\) は、マネージ コードからネイティブ コードへの以前の切り替えが順序正しい遷移によって行われなかった場合に、ネイティブ コードからマネージ コードへの遷移を実行しようとするとアクティブになります。  
+  
+## 症状  
+ ネイティブ コードからマネージ コードに遷移するときに、オブジェクト ヒープが破損したり、その他の重大なエラーが発生したりします。  
+  
+ ネイティブ コードとマネージ コードの間で両方向に切り替わるスレッドでは、正しい順序で遷移を実行する必要があります。  ただし、ベクトル化例外ハンドラーなど、オペレーティング システムの下位の機能拡張ポイントでは、正しい順序で遷移を実行しなくてもマネージ コードからネイティブ コードに切り替えることができます。このような切り替えは、共通言語ランタイム \(CLR\) ではなく、オペレーティング システムの制御に従います。これらの機能拡張ポイント内で実行されるネイティブ コードでは、マネージ コードへのコールバックを避ける必要があります。  
+  
+## 原因  
+ ベクトル化例外ハンドラーなどの、オペレーティング システムの下位の機能拡張ポイントが、マネージ コードの実行時にアクティブになっています。この機能拡張ポイントを介して呼び出されたアプリケーション コードが、マネージ コードへのコールバックを実行しようとしています。  
+  
+ この問題の原因は、常にアプリケーション コードにあります。  
+  
+## 解決策  
+ スタック トレースを調べて、この MDA をアクティブにしているスレッドがないか確認します。そのスレッドが、マネージ コードへの無効な呼び出しを試みています。スタック トレースを調べることにより、該当する機能拡張ポイントを使用しているアプリケーション コード、この機能拡張ポイントを提供しているオペレーティング システム コード、および機能拡張ポイントによって中断されたマネージ コードが明らかになります。  
+  
+ たとえば、ベクトル化例外ハンドラーの内部からマネージ コードの呼び出しを試みると MDA がアクティブになります。スタックをチェックすると、オペレーティング システムの例外処理コードと一部のマネージ コードが、<xref:System.DivideByZeroException> や <xref:System.AccessViolationException> などの例外の原因となっていることがわかります。  
+  
+ この場合、ベクトル化例外ハンドラーをアンマネージ コードに完全に実装することが適切な解決策です。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+ この MDA によって、無効な再入が試みられていることが報告されます。スレッドのスタックをチェックし、この問題の原因と解決方法を判断します。  出力例を次に示します。  
+  
+```  
+Additional Information: Attempting to call into managed code without   
+transitioning out first.  Do not attempt to run managed code inside   
+low-level native extensibility points. Managed Debugging Assistant   
+'Reentrancy' has detected a problem in 'D:\ConsoleApplication1\  
+ConsoleApplication1\bin\Debug\ConsoleApplication1.vshost.exe'.  
+```  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <reentrancy />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ 次のコード例では、<xref:System.AccessViolationException> がスローされます。この例外がスローされると、ベクター例外処理をサポートする Windows の各バージョンでは、マネージ ベクトル化例外ハンドラーが呼び出されます。`reentrancy` MDA が有効になっていると、オペレーティング システムのベクトル化例外処理サポート コードから `MyHandler` の呼び出しが試みられたときに、この MDA がアクティブになります。  
+  
+```  
+using System;  
+public delegate int ExceptionHandler(IntPtr ptrExceptionInfo);  
+  
+public class Reenter   
+{  
+    public static ExceptionHandler keepAlive;  
+  
+    [System.Runtime.InteropServices.DllImport("kernel32", ExactSpelling=true,   
+        CharSet=System.Runtime.InteropServices.CharSet.Auto)]  
+    public static extern IntPtr AddVectoredExceptionHandler(int bFirst,   
+        ExceptionHandler handler);  
+  
+    static int MyHandler(IntPtr ptrExceptionInfo)   
+    {  
+        // EXCEPTION_CONTINUE_SEARCH  
+        return 0;  
+    }  
+    void Run() {}  
+  
+    static void Main()   
+    {  
+        keepAlive = new ExceptionHandler(Reenter.MyHandler);  
+        IntPtr ret = AddVectoredExceptionHandler(1, keepAlive);  
+        try   
+        {  
+            // Dispatch on null should AV.  
+            Reenter r = null;   
+            r.Run();  
+        }   
+        catch { }  
+    }  
+}  
+```  
+  
+## 参照  
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/releasehandlefailed-mda.md b/docs/framework/debug-trace-profile/releasehandlefailed-mda.md
new file mode 100644
index 00000000000..eddb4bd09ba
--- /dev/null
+++ b/docs/framework/debug-trace-profile/releasehandlefailed-mda.md
@@ -0,0 +1,106 @@
+---
+title: "releaseHandleFailed MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "managed debugging assistants (MDAs), handles"
+  - "release handle failed"
+  - "CriticalHandle class, run-time errors"
+  - "releaseHandleFailed MDA"
+  - "ReleaseHandle method"
+  - "SafeHandle class, run-time errors"
+  - "MDAs (managed debugging assistants), handles"
+ms.assetid: 44cd98ba-95e5-40a1-874d-e8e163612c51
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# releaseHandleFailed MDA
+`releaseHandleFailed` マネージ デバッグ アシスタント \(MDA\) は、<xref:System.Runtime.InteropServices.SafeHandle> または <xref:System.Runtime.InteropServices.CriticalHandle> から派生するクラスの <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドが `false` を返すときに、開発者に通知するためにアクティブ化されます。  
+  
+## 症状  
+ リソースまたはメモリのリーク。  <xref:System.Runtime.InteropServices.SafeHandle> または <xref:System.Runtime.InteropServices.CriticalHandle> から派生するクラスの <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドでエラーが発生する場合、クラスによってカプセル化されたリソースが、解放またはクリーンアップされていない可能性があります。  
+  
+## 原因  
+ ユーザーは、<xref:System.Runtime.InteropServices.SafeHandle> または <xref:System.Runtime.InteropServices.CriticalHandle> から派生するクラスを作成している場合に、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドの実装を行う必要があります。このため、状況は個別のリソースに固有です。  ただし、要件は次のとおりです。  
+  
+-   <xref:System.Runtime.InteropServices.SafeHandle> 型および <xref:System.Runtime.InteropServices.CriticalHandle> 型は、プロセスの重要なリソースのラッパーを表します。  メモリ リークは、時間の経過と共にプロセスを使用不能にしてしまいます。  
+  
+-   <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドは、その機能を実行しないことがあってはなりません。  プロセスがこのようなリソースを取得したら、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> が解放する唯一の方法です。  そのため、実行しないとリソースのリークになってしまいます。  
+  
+-   <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> の実行中に発生する、リソースの解放を妨げるエラーは、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッド自体の実装のバグです。  そのコードが、機能を実行するために他のプログラマが作成したコードを呼び出している場合でも、この規定を実行するようにすることがプログラマの責任です。  
+  
+## 解像度  
+ MDA 通知を発生させた特定の <xref:System.Runtime.InteropServices.SafeHandle> \(または <xref:System.Runtime.InteropServices.CriticalHandle>\) 型を使用するコードを確認し、未処理のハンドル値が<xref:System.Runtime.InteropServices.SafeHandle> から抽出されて、別の場所にコピーされている場所を探します。  これは、未処理のハンドル値の使用がランタイムにより追跡できなくなっているため、<xref:System.Runtime.InteropServices.SafeHandle> または <xref:System.Runtime.InteropServices.CriticalHandle> の実装内のエラーの一般的な原因です。  未処理のハンドルのコピーがその後閉じられると、同じハンドルを閉じようとして無効になるため、後で <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> 呼び出しがエラーになる可能性があります。  
+  
+ 不適切なハンドルの重複は、様々な方法で発生します。  
+  
+-   <xref:System.Runtime.InteropServices.SafeHandle.DangerousGetHandle%2A> メソッドの呼び出しを探します。  このメソッドへの呼び出しは、ごく限られた場合に行い、実行する場合は、<xref:System.Runtime.InteropServices.SafeHandle.DangerousAddRef%2A> メソッドと <xref:System.Runtime.InteropServices.SafeHandle.DangerousRelease%2A> メソッドの呼び出しで囲む必要があります。  後者のメソッドは、未処理のハンドル値を安全に使用できるコードの領域を指定します。  この領域の外、または参照カウントが最初にインクリメントされない場合は、別のスレッドで <xref:System.Runtime.InteropServices.SafeHandle.Dispose%2A> または <xref:System.Runtime.InteropServices.SafeHandle.Close%2A> を呼び出して、いつでもハンドル値を無効化できます。  <xref:System.Runtime.InteropServices.SafeHandle.DangerousGetHandle%2A> のすべての利用を追跡したら、未処理のハンドルが取得するパスに従い、ハンドルを解放する `CloseHandle` または別の低レベル ネイティブ メソッドを最終的に呼び出すコンポーネントに渡されないようにします。  
+  
+-   未処理の有効なハンドル値を使用して <xref:System.Runtime.InteropServices.SafeHandle> を初期化するために使用されるコードがハンドルを所有していることを確認します。  基本コンストラクターで `ownsHandle` パラメーターを `false` に設定せずに、コードで所有していないハンドルの周囲に <xref:System.Runtime.InteropServices.SafeHandle> を作成する場合、<xref:System.Runtime.InteropServices.SafeHandle> と実際のハンドルの所有者の両方がハンドルを閉じようとすることがあり、<xref:System.Runtime.InteropServices.SafeHandle> が閉じることができないと <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> でエラーが発生します。  
+  
+-   <xref:System.Runtime.InteropServices.SafeHandle> がアプリケーション ドメイン間でマーシャリングされる場合、使用されている <xref:System.Runtime.InteropServices.SafeHandle> の派生がシリアル可能とマークされていることを確認してください。  <xref:System.Runtime.InteropServices.SafeHandle> から派生したクラスがシリアル化されているまれなケースでは、<xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装するか、シリアル化と逆シリアル化のプロセスを手動で管理するその他のテクニックのいずれかを使用する必要があります。  これが必要なのは、既定のシリアル化アクションでは、その中の未処理のハンドル値のビットごとのクローンを作成し、結果として 2 つの <xref:System.Runtime.InteropServices.SafeHandle> のインスタンスが同じハンドルを所有すると認識してしまうためです。  両方とも、同じ地点で同じハンドルの <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> を呼び出そうとします。  2 番目の <xref:System.Runtime.InteropServices.SafeHandle> がこれを行おうとすると、エラーが発生します。  <xref:System.Runtime.InteropServices.SafeHandle> をシリアル化するときの適切な一連のアクションは、ネイティブのハンドル型に適した `DuplicateHandle` 関数、または同様の関数を呼び出し、有効なハンドルのコピーを明示的に作成することです。  ハンドル型がこれをサポートしない場合、それをラップしている <xref:System.Runtime.InteropServices.SafeHandle> 型をシリアル化可能にすることはできません。  
+  
+-   ハンドルが早い段階で閉じられ、その結果 <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドが最終的に呼び出されたときにエラーが発生した場所を、`CloseHandle` 関数など、ハンドルの解放に使用されるネイティブ ルーチンにデバッガーのブレークポイントを配置することで追跡することができます。  このようなルーチンは高トラフィックを処理することが多いため、負荷の高いシナリオや、中サイズの機能テストでも、これを実行することができない場合があります。  呼び出し元、または場合によっては完全なスタック トレースの ID と解放されるハンドルの値をキャプチャするために、ネイティブの解放メソッドを呼び出すコードをインストルメント化することが役に立つ場合があります。  ハンドル値は、この MDA から報告された値と比較できます。  
+  
+-   Win32 ハンドルなど、`CloseHandle` 関数により解放される可能性があるネイティブのハンドル型の一部は、同じハンドル名前空間を共有します。  1 つのハンドル型の解放でエラーが発生すると、別のハンドル型でも問題が発生する可能性があります。  たとえば、誤って Win32 イベント ハンドルを 2 回閉じると、一見関連のないファイルのハンドルが早く閉じられてしまう可能性があります。  これは、ハンドルが解放され、ハンドル値が別のリソース、おそらく別の型のものを追跡するために利用できるようになったときに発生します。  この状態が発生し、2 番目の間違った解放が続くと、関連のないスレッドのハンドルが無効になる可能性があります。  
+  
+## ランタイムへの影響  
+ この MDA は CLR に影響しません。  
+  
+## 出力  
+ <xref:System.Runtime.InteropServices.SafeHandle> または <xref:System.Runtime.InteropServices.CriticalHandle> でエラーが発生し、ハンドルを適切に解放できないことを示すメッセージ。  次に例を示します。  
+  
+```  
+"A SafeHandle or CriticalHandle of type 'MyBrokenSafeHandle'   
+failed to properly release the handle with value 0x0000BEEF. This   
+usually indicates that the handle was released incorrectly via   
+another means (such as extracting the handle using DangerousGetHandle   
+and closing it directly or building another SafeHandle around it."  
+```  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <releaseHandleFailed/>  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+ `releaseHandleFailed` MDA をアクティブ化することができるコードの例を、次に示します。  
+  
+```  
+bool ReleaseHandle()  
+{  
+    // Calling the Win32 CloseHandle function to release the   
+    // native handle wrapped by this SafeHandle. This method returns   
+    // false on failure, but should only fail if the input is invalid   
+    // (which should not happen here). The method specifically must not   
+    // fail simply because of lack of resources or other transient   
+    // failures beyond the user’s control. That would make it unacceptable   
+    // to call CloseHandle as part of the implementation of this method.  
+    return CloseHandle(handle);  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/reportavoncomrelease-mda.md b/docs/framework/debug-trace-profile/reportavoncomrelease-mda.md
new file mode 100644
index 00000000000..d529688f261
--- /dev/null
+++ b/docs/framework/debug-trace-profile/reportavoncomrelease-mda.md
@@ -0,0 +1,64 @@
+---
+title: "reportAvOnComRelease MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), reference counting errors"
+  - "exceptions, reference counting errors"
+  - "ReportAvOnComRelease MDA"
+  - "COM release access violations"
+  - "user reference counting errors"
+  - "managed debugging assistants (MDAs), reference counting errors"
+  - "report access violation on Com release"
+  - "reference counting errors"
+ms.assetid: a2b86b63-08b2-4943-b344-3c2cf46ccd31
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# reportAvOnComRelease MDA
+COM 相互運用を実行していて、COM の生呼び出しと組み合わせた `reportAvOnComRelease` または <xref:System.Runtime.InteropServices.Marshal.Release%2A> メソッドを使用しているときに、ユーザー参照カウントのエラーが原因で例外がスローされると、<xref:System.Runtime.InteropServices.Marshal.ReleaseComObject%2A> マネージ デバッグ アシスタント \(MDA\) がアクティブ化されます。  
+  
+## 症状  
+ アクセス違反およびメモリ破損が発生します。  
+  
+## 原因  
+ COM 相互運用を実行していて、生の COM 呼び出しと組み合わせた <xref:System.Runtime.InteropServices.Marshal.Release%2A> または <xref:System.Runtime.InteropServices.Marshal.ReleaseComObject%2A> メソッドを使用しているときに、ユーザー参照カウントのエラーが原因で例外がスローされることがあります。  通常、この例外は破棄されます。これは、破棄しないと CLR でアクセス違反が発生し、ダウンしてしまうためです。  このアシスタントが有効な場合は、そのような例外を単に破棄するのではなく、検出して報告できます。  
+  
+## 解決策  
+ 参照カウントのコードを調べてエラーを探します。また、オブジェクトのネイティブ クライアントに参照カウントのエラーがないかどうかも調べます。  
+  
+## ランタイムへの影響  
+ 2 つのモードを利用できます。  `allowAv` 属性が `true` の場合、アシスタントは、ランタイムがアクセス違反を破棄しないようにします。  `allowAv` が `false` の場合 \(既定\)、ランタイムはアクセス違反を破棄しますが、例外がスローされて破棄されたことを通知する警告メッセージがユーザーに報告されます。  
+  
+## 出力  
+ 可能な場合、出力には COM インターフェイス ポインターの元の vtable が含まれます。  それ以外の場合は、情報メッセージが表示されます。  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <reportAvOnComRelease />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/runtime-profiling.md b/docs/framework/debug-trace-profile/runtime-profiling.md
new file mode 100644
index 00000000000..71421fe4102
--- /dev/null
+++ b/docs/framework/debug-trace-profile/runtime-profiling.md
@@ -0,0 +1,80 @@
+---
+title: "ランタイム プロファイリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "パフォーマンス カウンター"
+  - "共通言語ランタイム、プロファイル"
+  - "Perfmon.exe"
+  - "システム モニター"
+  - "プロファイル"
+  - "ランタイム、プロファイル"
+  - "プロファイリング (アプリケーションの)"
+  - "パフォーマンス コンソール"
+ms.assetid: ccd68284-f3a8-47b8-bc3f-92e5fe3a1640
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# ランタイム プロファイリング
+プロファイリングは、任意の開発シナリオまたは配置シナリオでパフォーマンス データを収集する方法の 1 つです。 このセクションは、アプリケーションのパフォーマンスに関する情報の収集を必要とする開発者およびシステム管理者を対象にしています。  
+  
+## パフォーマンス モニター \(Perfmon.exe\) を使用したパフォーマンスの追跡  
+ パフォーマンス モニターは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションをプロファイリングする場合に最も使いやすいツールです。 パフォーマンス モニターは、共通言語ランタイムおよび [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] と共にインストールされる .NET Framework パフォーマンス カウンター内のデータをグラフィカルに表示します。 これらのカウンターを使用することにより、メモリ管理から Just\-In\-Time \(JIT\) コンパイラのパフォーマンスまで、あらゆる情報を監視できます。 .NET パフォーマンス カウンターは、アプリケーションが使用するリソースに関する情報を提供します。この情報は、アプリケーションのパフォーマンスを判断するための間接的な指標となります。 これらのカウンターは、アプリケーション内部の動作状況を把握するために使用します。  
+  
+#### perfmon.exe を Windows Vista 以降のバージョンで実行するには  
+  
+1.  コマンド プロンプトで、「**perfmon**」と入力します。**\[パフォーマンス モニター\]** コンソールが表示されます。  
+  
+2.  **\[監視ツール\]** フォルダーで、**\[パフォーマンス モニター\]** をクリックします。  
+  
+3.  パフォーマンス モニターのツールバーで、**\[追加\]** アイコン \(正符号\) をクリックします \(表示されている場合\)。 表示されていない場合は、モニター ウィンドウで右クリックし、**\[カウンターの追加\]** オプションを選択します。  
+  
+     **\[接続の追加\]** ダイアログ ボックスが表示されます。**\[使用可能なカウンター\]** リスト ボックスに、使用可能なパフォーマンス オブジェクトが表示されます。 .NET Framework アプリケーション用には、さまざまな定義済みのオブジェクトがあります。これには、メモリ管理 \(**.NET CLR メモリ**\)、相互運用性 \(**.NET CLR の相互運用性**\)、例外処理 \(**.NET CLR 例外**\)、およびマルチスレッド \(**.NET CLR LocksAndThreads**\) が含まれます。 各パフォーマンス オブジェクトには、個々 のパフォーマンス カウンターが多数含まれています。 パフォーマンス モニターで使用可能なパフォーマンス カウンターの一覧は、「[Performance Counters](../../../docs/framework/debug-trace-profile/performance-counters.md)」を参照してください。  
+  
+4.  パフォーマンス オブジェクトの名前の横にあるチェック ボックスをオンにすると、サポートされている個々のパフォーマンス カウンターの一覧が表示されます。  
+  
+5.  表示するパフォーマンス カウンターをクリックします。  
+  
+6.  **\[選択したオブジェクトのインスタンス\]** リスト ボックスで、**\< すべてのインスタンス\>** をクリックして、共通言語ランタイムのパフォーマンス カウンターをグローバルに \(システム全体で\) 監視するように指定します。  
+  
+     または  
+  
+     **\[選択したオブジェクトのインスタンス\]** リスト ボックスで、アプリケーション名をクリックして、そのアプリケーションのパフォーマンス カウンターを監視します。  
+  
+     複数のバージョンのランタイムを区別する必要がある場合、または同じ名前を持つ複数のアプリケーション間のあいまいさを解消する必要がある場合は、レジストリ キーも変更する必要があります。 詳細については、「[Performance Counters and In\-Process Side\-By\-Side Applications](../../../docs/framework/debug-trace-profile/performance-counters-and-in-process-side-by-side-applications.md)」を参照してください。  
+  
+> [!NOTE]
+>  パフォーマンス コンソールの実行中に新しいパフォーマンス カウンターがインストールされた場合は、新しいカウンターが表示されるように、パフォーマンス コンソールを停止して再起動してください。  
+  
+ 特定のゾーンまたはリモート共有に存在するアセンブリをプロファイリングする場合は、リモート アセンブリがパフォーマンス カウンターを実行するコンピューターに対して完全な信頼関係を持っていることを確認してください。 アセンブリが十分な信頼関係を持っていない場合、パフォーマンス カウンターは機能しません。 さまざまなゾーンに対する信頼関係の設定方法については、「[Caspol.exe \(コード アクセス セキュリティ ポリシー ツール\)](../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされているシステムでは、パフォーマンス モニターで、[!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] を使用して開発されたアプリケーションについて、**.NET CLR データ** や **.NET CLR ネットワーク** などの一部のカテゴリでパフォーマンス カウンターのデータが表示されない場合があります。 このような場合、[\<forcePerformanceCounterUniqueSharedMemoryReads\>](../../../docs/framework/configure-apps/file-schema/runtime/forceperformancecounteruniquesharedmemoryreads-element.md) 要素をアプリケーションの構成ファイルに追加することで、このデータを表示するようにパフォーマンス モニターを構成できます。  
+  
+## プログラムを使用したパフォーマンス カウンターの読み取りと作成  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、パフォーマンス コンソールで利用できるものと同じパフォーマンス情報にコードからアクセスするのに使用するクラスが用意されています。 また、これらのクラスを使用すると、カスタム パフォーマンス カウンターを作成できます。[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] に用意されているパフォーマンス監視クラスの一部について、次の表に説明を示します。  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.Diagnostics.PerformanceCounter?displayProperty=fullName>|Windows NT パフォーマンス カウンター コンポーネントを表します。 既存の定義済みカウンターやカスタム カウンターを読み取ったり、カスタム カウンターにパフォーマンス データを書き込むには、このクラスを使用します。|  
+|<xref:System.Diagnostics.PerformanceCounterCategory?displayProperty=fullName>|コンピューター上のカウンターおよびカウンター カテゴリと対話するためのいくつかのメソッドを提供します。|  
+|<xref:System.Diagnostics.PerformanceCounterInstaller?displayProperty=fullName>|`PerformanceCounter` コンポーネントのインストーラーを指定します。|  
+|<xref:System.Diagnostics.PerformanceCounterType?displayProperty=fullName>|`PerformanceCounter` の `NextValue` メソッドを計算する数式を指定します。|  
+  
+## 参照  
+ [Performance Counters](../../../docs/framework/debug-trace-profile/performance-counters.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/streamwriterbuffereddatalost-mda.md b/docs/framework/debug-trace-profile/streamwriterbuffereddatalost-mda.md
new file mode 100644
index 00000000000..ca3e70ab5e5
--- /dev/null
+++ b/docs/framework/debug-trace-profile/streamwriterbuffereddatalost-mda.md
@@ -0,0 +1,119 @@
+---
+title: "streamWriterBufferedDataLost MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "StreamWriter class, data buffering problems"
+  - "managed debugging assistants (MDAs), StreamWriter data buffering"
+  - "buffers, StreamWriter problems"
+  - "MDAs (managed debugging assistants), StreamWriter data buffering"
+  - "StreamWriter buffered data lost"
+  - "data buffering problems"
+  - "streamWriterBufferedDataLost MDA"
+ms.assetid: 6e5c07be-bc5b-437a-8398-8779e23126ab
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# streamWriterBufferedDataLost MDA
+`streamWriterBufferedDataLost` マネージ デバッグ アシスタント \(MDA\) は、<xref:System.IO.StreamWriter> に書き込まれても、その後、<xref:System.IO.StreamWriter> のインスタンスが破棄される前に <xref:System.IO.StreamWriter.Flush%2A> メソッドや <xref:System.IO.StreamWriter.Close%2A> メソッドが呼び出されないときにアクティブになります。  この MDA を有効にすると、ランタイムは、<xref:System.IO.StreamWriter> 内にバッファー データが存在しているかどうかを確認します。  バッファー データが存在する場合、MDA はアクティブになります。  <xref:System.GC.Collect%2A> メソッドや <xref:System.GC.WaitForPendingFinalizers%2A> メソッドを呼び出すと、ファイナライザーを強制的に実行できます。  ファイナライザーは、これ以外では任意の時点で動作し、プロセス終了時に動作する可能性はありません。  この MDA を有効にしてファイナライザーを明示的に実行すると、この種の問題をより確実に再現できるようになります。  
+  
+## 症状  
+ <xref:System.IO.StreamWriter> は、最後の 1 ～ 4 KB のデータをファイルに書き込みません。  
+  
+## 原因  
+ <xref:System.IO.StreamWriter> はデータを内部にバッファリングします。この場合、<xref:System.IO.StreamWriter.Close%2A> メソッドまたは <xref:System.IO.StreamWriter.Flush%2A> メソッドを呼び出して、バッファー データを基になるデータ ストアに書き込む必要があります。  <xref:System.IO.StreamWriter.Close%2A> や <xref:System.IO.StreamWriter.Flush%2A> が適切に呼び出されなかった場合、<xref:System.IO.StreamWriter> インスタンスにバッファリングされたデータが正しく書き込まれないことがあります。  
+  
+ この MDA がキャッチする、記述が不適切なコード例を次に示します。  
+  
+```  
+// Poorly written code.  
+void Write()   
+{  
+    StreamWriter sw = new StreamWriter("file.txt");  
+    sw.WriteLine("Data");  
+    // Problem: forgot to close the StreamWriter.  
+}  
+```  
+  
+ 上のコードでは、ガベージ コレクションがトリガーされ、ファイナライザーが終了するまで中断された場合、この MDA がより確実にアクティブになります。  この種の問題を追跡するには、デバッグ ビルドで前のメソッドの末尾に次のコードを追加します。  これにより、MDA は確実にアクティブになりますが、問題の原因が解決されるというわけではありません。  
+  
+```  
+GC.Collect();  
+GC.WaitForPendingFinalizers();  
+```  
+  
+## 解決策  
+ <xref:System.IO.StreamWriter> のインスタンスを持つアプリケーションまたはコード ブロックを閉じる前に、<xref:System.IO.StreamWriter> で <xref:System.IO.StreamWriter.Close%2A> または <xref:System.IO.StreamWriter.Flush%2A> を呼び出します。  これを実現する最良の機構の 1 つが、C\# の `using` ブロック \(Visual Basic の場合は `Using`\) を使用してインスタンスを作成することです。これにより、ライターの <xref:System.IO.StreamWriter.Dispose%2A> メソッドが呼び出され、その結果、インスタンスが正しく閉じられます。  
+  
+```  
+using(StreamWriter sw = new StreamWriter("file.txt"))   
+{  
+    sw.WriteLine("Data");  
+}  
+```  
+  
+ `using` の代わりに `try/finally` を使用した同様の解決策を次のコードに示します。  
+  
+```  
+StreamWriter sw;  
+try   
+{  
+    sw = new StreamWriter("file.txt"));  
+    sw.WriteLine("Data");  
+}  
+finally   
+{  
+    if (sw != null)  
+        sw.Close();  
+}  
+```  
+  
+ これらの解決策のいずれも使用できない場合 \(たとえば、<xref:System.IO.StreamWriter> が静的変数に格納され、その有効期間の最後にコードを簡単に実行できない場合など\)、<xref:System.IO.StreamWriter> を最後に使用した後に <xref:System.IO.StreamWriter.Flush%2A> を呼び出すか、または最初に使用する前に <xref:System.IO.StreamWriter.AutoFlush%2A> プロパティを `true` に設定すると、この問題を回避できます。  
+  
+```  
+private static StreamWriter log;  
+// static class constructor.  
+static WriteToFile()   
+{  
+    StreamWriter sw = new StreamWriter("log.txt");  
+    sw.AutoFlush = true;  
+  
+    // Publish the StreamWriter for other threads.  
+    log = sw;  
+}  
+```  
+  
+## ランタイムへの影響  
+ この MDA は、ランタイムに影響しません。  
+  
+## 出力  
+ この違反が発生したことを示すメッセージ  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    <streamWriterBufferedDataLost />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 参照  
+ <xref:System.IO.StreamWriter>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/trace-listeners.md b/docs/framework/debug-trace-profile/trace-listeners.md
new file mode 100644
index 00000000000..c3a701373db
--- /dev/null
+++ b/docs/framework/debug-trace-profile/trace-listeners.md
@@ -0,0 +1,92 @@
+---
+title: "Trace Listeners | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Listener object types"
+  - "listeners"
+  - "Trace class, listeners"
+  - "trace listeners, about trace listeners"
+  - "Listeners collection"
+  - "trace listeners"
+  - "tracing [.NET Framework], trace listeners"
+  - "logs, trace listeners"
+ms.assetid: 444b0d33-67ea-4c36-9e94-79c50f839025
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Trace Listeners
+**Trace**、**Debug**、および <xref:System.Diagnostics.TraceSource> を使用するときには、送信されたメッセージを収集して記録するための機構が必要です。  トレース メッセージは*リスナー*によって受け取られます。  リスナーの目的は、トレース メッセージの収集、格納、およびルーティングを行うことです。  リスナーにより、トレース出力が適切な場所 \(ログ、ウィンドウ、またはテキスト ファイル\) に送られます。  
+  
+ リスナーは、**Debug**、**Trace**、および <xref:System.Diagnostics.TraceSource> の各クラスで使用できます。それらのクラスからも出力を各種のリスナー オブジェクトに送ることができます。  一般的に使用される定義済みのリスナーは、次のとおりです。  
+  
+-   <xref:System.Diagnostics.TextWriterTraceListener> は、<xref:System.IO.TextWriter> クラスのインスタンスまたは <xref:System.IO.Stream> クラスの任意の対象に出力をリダイレクトします。  また、コンソールまたはファイルに書き込むこともできます \(これらは <xref:System.IO.Stream> クラスなので\)。  
+  
+-   <xref:System.Diagnostics.EventLogTraceListener> は、出力をイベント ログにリダイレクトします。  
+  
+-   <xref:System.Diagnostics.DefaultTraceListener> は、**Write** メッセージと **WriteLine** メッセージを **OutputDebugString** と **Debugger.Log** メソッドに出力します。  Visual Studio では、これによってデバッグ メッセージが \[出力\] ウィンドウに表示されます。  **Fail** メッセージと、失敗した **Assert** メッセージも **OutputDebugString** Windows API と **Debugger.Log** メソッドに出力され、これらはメッセージ ボックスとしても表示されます。  **DefaultTraceListener** はすべての `Listeners` コレクションに自動的に取り込まれる唯一のリスナーであるため、この動作は **Debug** メッセージと **Trace** メッセージの既定の動作になります。  
+  
+-   <xref:System.Diagnostics.ConsoleTraceListener> は、トレース出力またはデバッグ出力を、標準出力と標準エラー出力ストリームのいずれかに転送します。  
+  
+-   <xref:System.Diagnostics.DelimitedListTraceListener> は、トレース出力またはデバッグ出力を、テキスト ライター \(ストリーム ライターなど\) またはストリーム \(ファイル ストリームなど\) に送ります。 トレース出力は、<xref:System.Diagnostics.DelimitedListTraceListener.Delimiter%2A> プロパティによって指定された区切り記号を使用する、区切られたテキスト形式です。  
+  
+-   <xref:System.Diagnostics.XmlWriterTraceListener> は、トレース出力またはデバッグ出力を、XML でエンコードされたデータとして <xref:System.IO.TextWriter> または <xref:System.IO.Stream> \(<xref:System.IO.FileStream> など\) に送ります。  
+  
+ <xref:System.Diagnostics.DefaultTraceListener> 以外のリスナーが **Debug** 出力、**Trace** 出力、および <xref:System.Diagnostics.TraceSource> 出力を受け取るようにする場合は、目的のリスナーを `Listeners` コレクションに追加する必要があります。  詳細については、「[How to: Create and Initialize Trace Listeners](../../../docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners.md)」と「[How to: Use TraceSource and Filters with Trace Listeners](../../../docs/framework/debug-trace-profile/how-to-use-tracesource-and-filters-with-trace-listeners.md)」を参照してください。  **Listeners** コレクションのすべてのリスナーは、トレース出力のメソッドから同じメッセージを受け取ります。  たとえば、**TextWriterTraceListener** と **EventLogTraceListener** という 2 つのリスナーを設定したとします。  各リスナーは同一のメッセージを受け取ります。  この場合、**TextWriterTraceListener** はストリームに出力を送り、**EventLogTraceListener** はイベント ログに出力を送るなどの動作が可能です。  
+  
+ 出力を **Listeners** コレクションに送る方法を次の例に示します。  
+  
+```vb  
+' Use this example when debugging.  
+Debug.WriteLine("Error in Widget 42")  
+' Use this example when tracing.  
+Trace.WriteLine("Error in Widget 42")  
+```  
+  
+```csharp  
+// Use this example when debugging.  
+System.Diagnostics.Debug.WriteLine("Error in Widget 42");  
+// Use this example when tracing.  
+System.Diagnostics.Trace.WriteLine("Error in Widget 42");  
+```  
+  
+ デバッグとトレースは、同じ **Listeners** コレクションを共有しています。したがって、リスナー オブジェクトをアプリケーションの **Debug.Listeners** コレクションに追加した場合、そのリスナー オブジェクトは **Trace.Listeners** コレクションにも追加されます。  
+  
+ トレース情報をコンソールに送る場合のリスナーの使用方法を次の例に示します。  
+  
+```vb  
+Trace.Listeners.Clear()  
+Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))  
+```  
+  
+```csharp  
+System.Diagnostics.Trace.Listeners.Clear();  
+System.Diagnostics.Trace.Listeners.Add(  
+   new System.Diagnostics.TextWriterTraceListener(Console.Out));  
+```  
+  
+## 開発者が定義するリスナー  
+ **TraceListener** 基底クラスから継承することにより、独自のリスナーを定義し、カスタマイズされたメソッドで既存のメソッドをオーバーライドできます。  開発者が定義するリスナーの作成については、「.NET Framework リファレンス」の「<xref:System.Diagnostics.TraceListener>」を参照してください。  
+  
+## 参照  
+ <xref:System.Diagnostics.TextWriterTraceListener>   
+ <xref:System.Diagnostics.EventLogTraceListener>   
+ <xref:System.Diagnostics.DefaultTraceListener>   
+ <xref:System.Diagnostics.TraceListener>   
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)   
+ [Trace Switches](../../../docs/framework/debug-trace-profile/trace-switches.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/trace-switches.md b/docs/framework/debug-trace-profile/trace-switches.md
new file mode 100644
index 00000000000..f1e28f73d04
--- /dev/null
+++ b/docs/framework/debug-trace-profile/trace-switches.md
@@ -0,0 +1,85 @@
+---
+title: "Trace Switches | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "tracing [.NET Framework], trace switches"
+  - "trace switches, about trace switches"
+  - "tracing [.NET Framework], level of detail"
+  - "switches, trace"
+  - "trace switches"
+  - "trace switches, creating custom"
+ms.assetid: 8ab913aa-f400-4406-9436-f45bc6e54fbe
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Trace Switches
+トレース スイッチを使用すると、トレース出力を有効\/無効にしたり、トレースの出力をフィルター処理したりできます。 トレース スイッチは、コードに存在すれるオブジェクトであり、.config ファイルによって外部的に設定できます。 .NET Framework に用意されたトレース スイッチには、<xref:System.Diagnostics.BooleanSwitch> クラス、<xref:System.Diagnostics.TraceSwitch> クラス、および <xref:System.Diagnostics.SourceSwitch> クラスの 3 種類があります。<xref:System.Diagnostics.BooleanSwitch> クラスは、トグル スイッチとして機能し、各種のトレース ステートメントを有効にしたり無効にしたりできます。<xref:System.Diagnostics.TraceSwitch> クラスと <xref:System.Diagnostics.SourceSwitch> クラスを使用すると、特定のトレース レベルごとにトレース スイッチを有効にすることができます。これにより、該当するレベルおよびそれ以下のすべてのレベルに対して指定された <xref:System.Diagnostics.Trace> メッセージまたは <xref:System.Diagnostics.TraceSource> メッセージが表示されます。 スイッチを無効にした場合、トレース メッセージは表示されません。 すべてのクラスは、他のユーザー定義のスイッチと同様に、どちらも **Switch** という抽象 \(**MustInherit**\) クラスから派生したクラスです。  
+  
+ トレース スイッチは情報のフィルター処理に役立つことがあります。 たとえば、データ アクセス モジュールではすべてのトレース メッセージを表示し、アプリケーションの他の部分ではエラー メッセージだけを表示できます。 この場合は、データ アクセス モジュールに対してトレース スイッチを 1 つ使用し、アプリケーションの他の部分に対してスイッチを 1 つ使用します。 .config ファイルの構成でスイッチを適切に設定することにより、受け取るトレース メッセージの種類を制御できます。 詳細については、「[How to: Create, Initialize and Configure Trace Switches](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)」を参照してください。  
+  
+ 一般に、配置されたアプリケーションはスイッチが無効にされた状態で実行されるため、ユーザーにとって意味のないトレース メッセージが画面に表示されたり、アプリケーションの実行ごとにログ ファイルに書き込んだりする必要はありません。 アプリケーションの実行時に問題が発生した場合は、アプリケーションを中断し、スイッチを有効にしてからアプリケーションを再起動します。 これにより、トレース メッセージが表示されるようになります。  
+  
+ スイッチを使用するには、まず、**BooleanSwitch** クラス、**TraceSwitch** クラス、または開発者が定義したスイッチ クラスからスイッチ オブジェクトを作成する必要があります。 開発者定義スイッチの作成方法については、「.NET Framework リファレンス」の「<xref:System.Diagnostics.Switch> クラス」を参照してください。 次に、スイッチ オブジェクトを使用するタイミングを指定する構成値を設定します。 その後で、スイッチ オブジェクトの設定を各種の **Trace** \(または **Debug**\) トレース メソッドでテストします。  
+  
+## トレース レベル  
+ **TraceSwitch** を使用するときには、いくつかの付加的な考慮事項があります。**TraceSwitch** オブジェクトには、スイッチを特定のレベル以上として設定するかどうかを示す **Boolean** 値を返す、4 つのプロパティがあります。  
+  
+-   <xref:System.Diagnostics.TraceSwitch.TraceError%2A?displayProperty=fullName>  
+  
+-   <xref:System.Diagnostics.TraceSwitch.TraceWarning%2A?displayProperty=fullName>  
+  
+-   <xref:System.Diagnostics.TraceSwitch.TraceInfo%2A?displayProperty=fullName>  
+  
+-   <xref:System.Diagnostics.TraceSwitch.TraceVerbose%2A?displayProperty=fullName>  
+  
+ レベルを使用することにより、受け取るトレース情報を問題解決に必要な情報だけに制限できます。 トレース スイッチを適切なトレース レベルに設定したり構成したりして、トレース出力に必要な詳細レベルを指定します。 エラー メッセージ、警告メッセージ、情報メッセージ、または詳細トレース メッセージを受け取ることができます。また、メッセージを一切受け取らないようにすることもできます。  
+  
+ 各レベルに関連付けるメッセージの種類は、すべて開発者が指定します。 トレース メッセージの内容は、通常、各レベルに関連付けた内容に依存しますが、レベルごとに動作の違いを設定できます。 たとえば、レベル 3 \(**Info**\) の問題については詳細な説明を提供するが、レベル 1 \(**Error**\) の問題についてはエラー参照番号だけを提供する場合があります。 アプリケーションで最適な動作を得ることができるスキームは、独自に判断してください。  
+  
+ これらのプロパティは、**TraceLevel** 列挙型の値 1 から 4 に対応します。**TraceLevel** 列挙型のレベルとそれぞれの値を次の表に示します。  
+  
+|列挙値|整数値|表示されるメッセージ \(または指定された出力対象に書き込まれるメッセージ\) の種類|  
+|---------|---------|-------------------------------------------------|  
+|オフ|0|なし|  
+|エラー|1|エラー メッセージのみ|  
+|警告|2|警告メッセージとエラー メッセージ|  
+|情報|3|通知メッセージ、警告メッセージ、およびエラー メッセージ|  
+|詳細|4|詳細メッセージ、情報メッセージ、警告メッセージ、およびエラー メッセージ|  
+  
+ **TraceSwitch** のプロパティは、スイッチの最大トレース レベルを示します。 つまり、指定されたレベルとそれ以下のすべてのレベルについて、トレース情報が書き込まれます。 たとえば、**TraceInfo** が **true** の場合、**TraceError** と **TraceWarning** も **true** になりますが、**TraceVerbose** は **false** になることがあります。  
+  
+ これらのプロパティは読み取り専用です。**TraceSwitch** オブジェクトは、**TraceLevel** プロパティの設定時にこれらのプロパティを自動的に設定します。 次に例を示します。  
+  
+```vb  
+Dim myTraceSwitch As New TraceSwitch("SwitchOne", "The first switch") myTraceSwitch.Level = TraceLevel.Info ' This message box displays true, because setting the level to ' TraceLevel.Info sets all lower levels to true as well. MessageBox.Show(myTraceSwitch.TraceWarning.ToString()) ' This messagebox displays false. MessageBox.Show(myTraceSwitch.TraceVerbose.ToString())  
+  
+```  
+  
+```csharp  
+System.Diagnostics.TraceSwitch myTraceSwitch = new System.Diagnostics.TraceSwitch("SwitchOne", "The first switch"); myTraceSwitch.Level = System.Diagnostics.TraceLevel.Info; // This message box displays true, because setting the level to // TraceLevel.Info sets all lower levels to true as well. MessageBox.Show(myTraceSwitch.TraceWarning.ToString()); // This message box displays false. MessageBox.Show(myTraceSwitch.TraceVerbose.ToString());  
+  
+```  
+  
+## 開発者が定義するスイッチ  
+ **BooleanSwitch** と **TraceSwitch** を指定する以外に、**Switch** クラスから継承される独自のスイッチを定義して、カスタマイズしたメソッドで基本クラスのメソッドをオーバーライドできます。 開発者定義スイッチの作成方法については、「.NET Framework リファレンス」の「<xref:System.Diagnostics.Switch> クラス」を参照してください。  
+  
+## 参照  
+ [Trace Listeners](../../../docs/framework/debug-trace-profile/trace-listeners.md)   
+ [How to: Add Trace Statements to Application Code](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)   
+ [Tracing and Instrumenting Applications](../../../docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md b/docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md
new file mode 100644
index 00000000000..23e3eb3f6e4
--- /dev/null
+++ b/docs/framework/debug-trace-profile/tracing-and-instrumenting-applications.md
@@ -0,0 +1,164 @@
+---
+title: "アプリケーションのトレースとインストルメント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "トレース [.NET Framework]"
+  - "デバッグ [.NET Framework]、インストルメンテーション"
+  - "パフォーマンスの監視、インストルメンテーション"
+  - "インストルメンテーションは、インストルメンテーションの概要"
+  - "トレースのトレース [.NET Framework]"
+  - "パフォーマンスの監視、トレース コード"
+  - "Trace クラス、.NET アプリケーションのインストルメンテーション"
+ms.assetid: 773b6fc4-9013-4322-b728-5dec7a72e743
+caps.latest.revision: 21
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# アプリケーションのトレースとインストルメント
+トレースとは、実行中のアプリケーションの実行状態を監視する方法です。 .NET Framework アプリケーションの開発時に、トレースとデバッグのインストルメンテーションをアプリケーションに追加できます。このインストルメンテーションは、アプリケーションの開発中でも開発したアプリケーションの配置後でも使用できます。 使用することができます、 <xref:System.Diagnostics.Trace?displayProperty=fullName>、 <xref:System.Diagnostics.Debug?displayProperty=fullName>、および<xref:System.Diagnostics.TraceSource?displayProperty=fullName>エラーおよびアプリケーション ログ、テキスト ファイル、またはその他のデバイスを後で分析の実行に関する情報を記録するクラス。  
+  
+ 用語*インストルメンテーション*製品のパフォーマンスのレベルを監視または測定し、エラーを診断する機能を意味します。 プログラミングでは、組み込むアプリケーションの機能を指します。  
+  
+-   **コードのトレース**-実行時にアプリケーションの実行状態について示すメッセージを受信します。  
+  
+-   **デバッグ**- 追跡して、開発中のアプリケーションのプログラミング エラーを修正します。 詳細については、次を参照してください。[デバッグ](../Topic/Debugging%20in%20Visual%20Studio.md)します。  
+  
+-   **パフォーマンス カウンター** -アプリケーションのパフォーマンスを追跡するためのコンポーネントです。 詳細については、次を参照してください。[パフォーマンス カウンター](../../../docs/framework/debug-trace-profile/performance-counters.md)します。  
+  
+-   **イベント ログ**-できるようにするコンポーネントは、アプリケーションの実行における主要なイベントを追跡します。 詳細については、次を参照してください。、 <xref:System.Diagnostics.EventLog>クラスです。  
+  
+ トレース ステートメントをコード内に計画的に配置することによってアプリケーションをインストルメントすることは、分散アプリケーションでは特に便利です。 トレース ステートメントを使用してアプリケーションをインストルメントすると、不適切な動作についての情報を表示できるだけでなく、アプリケーションの実行状態を監視するための情報も表示できます。  
+  
+ <xref:System.Diagnostics.TraceSource>クラスは拡張されたトレース機能および旧バージョンの静的メソッドの代わりに使用できる提供<xref:System.Diagnostics.Trace>と<xref:System.Diagnostics.Debug>トレース クラスです。 使い慣れた<xref:System.Diagnostics.Trace>と<xref:System.Diagnostics.Debug>クラスも引き続き広く使用されますが、 <xref:System.Diagnostics.TraceSource>クラスがなどの新しいトレース コマンドに推奨<xref:System.Diagnostics.TraceSource.TraceEvent%2A>と<xref:System.Diagnostics.TraceSource.TraceData%2A>します。  
+  
+ <xref:System.Diagnostics.Trace>と<xref:System.Diagnostics.Debug>クラスは同じですが、そのプロシージャおよび関数を除く、<xref:System.Diagnostics.Trace>クラスは既定でにコンパイル リリース ビルドの<xref:System.Diagnostics.Debug>クラスはありません。  
+  
+ <xref:System.Diagnostics.Trace>と<xref:System.Diagnostics.Debug>クラスは、監視し、開発中または配置後のアプリケーションのパフォーマンスを確認するための手段を提供します。 たとえば、使用、<xref:System.Diagnostics.Trace>とようになります (たとえば、新しいデータベース接続の作成)、アプリケーションの効率を監視できる、特定の種類の配置されたアプリケーションでアクションを追跡するクラス。  
+  
+## <a name="code-tracing-and-debugging"></a>コードのトレースとデバッグ  
+ 出力メソッドを使用する開発時に、<xref:System.Diagnostics.Debug>クラスを Visual Studio 統合開発環境 (IDE) の出力ウィンドウにメッセージを表示します。 例:  
+  
+```vb  
+Trace.WriteLine("Hello World!")  
+Debug.WriteLine("Hello World!")  
+  
+```  
+  
+```csharp  
+System.Diagnostics.Trace.WriteLine("Hello World!");  
+System.Diagnostics.Debug.WriteLine("Hello World!");  
+  
+```  
+  
+ これらの例の"Hello World!"が表示されます。 出力 ウィンドウで、デバッガーでアプリケーションを実行します。  
+  
+ これにより、アプリケーションをデバッグし、テスト環境での動作に基づいてアプリケーションのパフォーマンスを最適化できます。 アプリケーションをデバッグするには、デバッグ ビルドで、<xref:System.Diagnostics.Debug>条件付きの属性をすべてのデバッグ出力を受け取るようにをオンにします。 オンにしないでリリース ビルドをコンパイルするには、アプリケーションのリリースの準備ができたら、<xref:System.Diagnostics.Debug>条件属性をコンパイラでは、最終的な実行可能ファイルには、デバッグ コードに含めないようにします。 詳細については、次を参照してください。[方法: トレースとデバッグによる条件付きコンパイル](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md)します。 アプリケーションの別のビルド構成の詳細については、次を参照してください。[コンパイルとビルド](../Topic/Compiling%20and%20Building%20in%20Visual%20Studio.md)します。  
+  
+ トレースすることも、インストールされたアプリケーションのコードが実行される方法を使って、<xref:System.Diagnostics.Trace>クラスです。 配置することで[トレース スイッチ](../../../docs/framework/debug-trace-profile/trace-switches.md)コードでは、トレースが発生したかどうかと、どのくらい広範を制御することができます。 これにより、運用環境におけるアプリケーションのステータスを監視できます。 複数のコンポーネントが複数のコンピューターで実行されるビジネス アプリケーションでは、この監視が特に重要です。 配置後のスイッチの機能は、構成ファイルで制御できます。 詳細については、次を参照してください。[方法: トレース スイッチの構成と初期化を、作成](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)します。  
+  
+ トレースを使用するアプリケーションの開発時には、通常、アプリケーション コードにトレース メッセージとデバッグ メッセージの両方を組み込みます。 オンにせず、リリース ビルドをコンパイルするには、アプリケーションをデプロイする準備ができたら、**デバッグ**条件属性です。 ただし、有効化しても、**トレース**条件属性をコンパイラは、実行可能ファイルにトレース コードを含むようです。 詳細については、次を参照してください。[方法: トレースとデバッグによる条件付きコンパイル](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md)します。  
+  
+### <a name="phases-of-code-tracing"></a>コードのトレースの段階  
+ コードのトレースには、次の&3; つの段階があります。  
+  
+1.  **インストルメンテーション**-トレース コードをアプリケーションに追加します。  
+  
+2.  **トレース**-トレース コードは、指定された対象に情報を書き込みます。  
+  
+3.  **分析**-トレース情報を特定し、アプリケーションの問題の理解を評価します。  
+  
+ 既定の設定では、開発中は、すべてのデバッグ出力メソッドおよびトレース出力メソッドが、Visual Studio の出力ウィンドウに情報を書き込みます。 配置後のアプリケーションでは、メソッドは指定された場所にトレース情報を書き込みます。 トレースまたはデバッグの出力ターゲットを指定する方法の詳細については、次を参照してください。[トレース リスナー](../../../docs/framework/debug-trace-profile/trace-listeners.md)します。  
+  
+ 配置されたアプリケーションで起こりうる問題を、トレースを使用して分析したり修正したりするためにしばしば使用される主要な手順を次に示します。 これらの手順を実行する方法の詳細については、適切なリンクを参照してください。  
+  
+##### <a name="to-use-tracing-in-an-application"></a>アプリケーションでトレースを使用するには  
+  
+1.  アプリケーションを配置した後で受け取るトレース出力の種類を検討します。  
+  
+2.  スイッチのセットを作成します。 詳細については、次を参照してください。[方法: トレース スイッチを設定する](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)です。  
+  
+3.  アプリケーションのコードにトレース ステートメントを追加します。  
+  
+4.  トレース出力を表示する場所を決定し、適切なリスナーを追加します。 詳細については、次を参照してください。[トレース リスナーの初期化と作成](../../../docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-listeners.md)します。  
+  
+5.  アプリケーションおよびそのアプリケーションに含まれるトレース コードをテストおよびデバッグします。  
+  
+6.  次のいずれかのプロシージャを使用して、アプリケーションを実行可能なコードにコンパイルします。  
+  
+    -   使用して、**ビルド**メニューを**デバッグ**のページ、**プロパティ ページ** ダイアログ ボックスで**ソリューション エクスプ ローラー**します。 Visual Studio でコンパイルをする場合は、この方法を使用してください。  
+  
+         \- または  
+  
+    -   使用して、**トレース**と**デバッグ**コンパイラ ディレクティブは、コンパイルのコマンド ライン メソッドです。 詳細については、次を参照してください。[トレースとデバッグによる条件付きコンパイル](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md)します。 コマンド ラインからコンパイルする場合はこの方法を使用してください。  
+  
+7.  問題が実行時に発生する場合は、適切なトレース スイッチをオンにしてください。 詳細については、次を参照してください。[トレース スイッチ](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)します。  
+  
+     トレース コードは、指定された場所 (画面、テキスト ファイル、イベント ログなど) にトレース メッセージを書き込みます。 含まれるリスナーの種類、 **Trace.Listeners**コレクションが決定します。  
+  
+8.  トレース メッセージを分析して、アプリケーションの問題を識別および理解します。  
+  
+## <a name="trace-instrumentation-and-distributed-applications"></a>トレースの実装および分散アプリケーション  
+ 分散アプリケーションを作成するときに、アプリケーションが使用される環境でテストをすることが難しい場合があります。 オペレーティング システムや Web ブラウザーのすべての組み合わせ (ローカライズ言語オプションのすべてのケースも含む) をテストしたり、アプリケーションに同時にアクセスする最大ユーザー数をシミュレートしたりできる開発チームはほとんどありません。 このため、大量の情報、異なる設定、エンド ユーザー固有の動作などの要因に対して分散アプリケーションがどのように応答するかをテストすることはできません。 また、分散アプリケーションを構成する要素の大半には、直接対話したりこれらの構成要素の利用状況を表示したりするためのユーザー インターフェイスは備わっていません。  
+  
+ ただしをシステム管理者、特に不当なによって特定のイベントを記述する分散アプリケーションの有効化することでこれを補うことができます*のインストルメント化*アプリケーション-は、コードの重要な位置にトレース ステートメントを配置することによってです。 これにより、予測不可能な動作 (極度に遅い応答時間など) が実行時に発生した場合でも、原因を判断できます。  
+  
+ トレース ステートメントを使用すると、オリジナル ソース コードを検査、変更、および再コンパイルしたり、デバッグ環境で実行時エラーを生成したりするなど、困難なタスクを避けることができます。  アプリケーションの実装は、エラーの表示だけでなく、パフォーマンスを監視するためにもすることができます。  
+  
+## <a name="strategic-placement-of-trace-statements"></a>トレース ステートメントの計画的な配置  
+ 実行時に使用するトレース ステートメントを配置するときには、十分に注意する必要があります。 考えられるすべてのトレース シナリオが適切に処理されるように、配置されるアプリケーションで必要とされるトレース情報を考慮する必要があります。 しかし、トレースを使用するアプリケーションは多岐にわたっており、トレースの計画的な配置にあたっての一般的なガイドラインはありません。 トレース ステートメント配置の詳細については、次を参照してください。[方法: アプリケーション コードにトレース ステートメントを追加](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)します。  
+  
+## <a name="output-from-tracing"></a>トレースの出力  
+ トレース出力と呼ばれるオブジェクトによって収集された*リスナー*します。 リスナーは、トレースの出力を受け取り、出力デバイス (通常は、ウィンドウ、ログ、またはテキスト ファイル) に書き込むためのオブジェクトです。 追加は、通常、トレース リスナーの作成時に、 <xref:System.Diagnostics.Trace.Listeners%2A?displayProperty=fullName>をすべてのトレース出力を受信するリスナーを収集します。  
+  
+ トレース情報は、常に書き込まれるには、少なくとも既定値に<xref:System.Diagnostics.Trace>出力対象、 <xref:System.Diagnostics.DefaultTraceListener>します。 何らかの理由を削除した場合、 <xref:System.Diagnostics.DefaultTraceListener>に他のリスナーを追加することがなく、<xref:System.Diagnostics.Trace.Listeners%2A>コレクションのトレース メッセージは表示されません。 詳細については、次を参照してください。[トレース リスナー](../../../docs/framework/debug-trace-profile/trace-listeners.md)します。  
+  
+ 6 つ<xref:System.Diagnostics.Debug>メンバーと<xref:System.Diagnostics.Trace>トレース情報を書き込むメソッドを次の表に示します。  
+  
+|メソッド|出力|  
+|------------|------------|  
+|**アサート**|指定されたテキスト。何も指定されない場合は、呼び出し履歴。 出力が書き込まれるだけで引数として指定された条件、 **Assert**ステートメントは**false**します。|  
+|**失敗します。**|指定されたテキスト。何も指定されない場合は、呼び出し履歴。|  
+|**書き込み**|指定されたテキスト。|  
+|**WriteIf**|引数として指定された条件の場合は、指定したテキスト、 **WriteIf**ステートメントが満たしています。|  
+|**WriteLine**|指定されたテキストおよびキャリッジ リターン。|  
+|**WriteLineIf**|引数として指定された条件の場合、指定したテキストおよびキャリッジ リターン、 **WriteLineIf**ステートメントが満たしています。|  
+  
+ 内のすべてのリスナー、<xref:System.Diagnostics.Trace.Listeners%2A>上記の表で説明したメッセージを受信するコレクションが実行された操作がメッセージを受信するリスナーの種類に応じて異なる場合があります。 たとえば、 <xref:System.Diagnostics.DefaultTraceListener>を受け取ったときにアサーションのダイアログ ボックスが表示されます、**失敗**か失敗した**Assert**通知が、 <xref:System.Diagnostics.TextWriterTraceListener>単に、ストリームに出力を書き込みます。  
+  
+ 独自のリスナーを実装することにより、結果をカスタマイズできます。 たとえば、メッセージ ボックスにメッセージを表示するカスタム トレース リスナーや、データベースに接続してメッセージをテーブルに追加するトレース リスナーなどを実装できます。 すべてのカスタム リスナーは、前に示した&6; つのメソッドをサポートする必要があります。 開発者が定義するリスナーの作成の詳細については、次を参照してください。 <xref:System.Diagnostics.TraceListener> 、.NET Framework の参照。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)]、 **Debug.Write**、 **Debug.WriteIf**、 **Debug.WriteLine**、および**Debug.WriteLineIf**メソッドに置き換えた、 **Debug.Print**以前のバージョンの Visual Basic で使用可能なメソッドです。  
+  
+ **書き込み**と**WriteLine**メソッド常にテキストを記述を指定することです。 **Assert**、 **WriteIf**、および**WriteLineIf**のみ、指定したテキストを記述するかどうかは、式が指定したテキストを記述するかどうかを制御するブール型の引数が必要; **true** (の**WriteIf**と**WriteLineIf**)、または**false** (の**Assert**)。 **失敗**メソッドは、常に、指定したテキストを書き込みます。 詳細については、次を参照してください。[方法: アプリケーション コードにトレース ステートメントを追加](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)および .NET Framework リファレンスです。  
+  
+## <a name="security-concerns"></a>セキュリティに関する注意事項  
+ ASP.NET アプリケーションを配置する前にトレースとデバッグを無効にしないと、アプリケーションに関する情報が公開され、悪意を持ったプログラムによって利用される可能性があります。 詳細については、次を参照してください。[する方法: トレースとデバッグによる条件付きコンパイル](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md)、[コンパイルとビルド](../Topic/Compiling%20and%20Building%20in%20Visual%20Studio.md)、と[する方法: トレース スイッチの構成と初期化を、作成](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)します。 デバッグは、IIS (Internet Information Services) で設定することもできます。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Diagnostics.Trace>   
+ <xref:System.Diagnostics.TraceSource>   
+ [コード コントラクト](../../../docs/framework/debug-trace-profile/code-contracts.md)   
+ [C#、f#、および Visual Basic プロジェクトの種類](../Topic/Debugging%20Preparation:%20C%23,%20F%23,%20and%20Visual%20Basic%20Project%20Types.md)   
+ [方法: アプリケーション コードにトレース ステートメントを追加](../../../docs/framework/debug-trace-profile/how-to-add-trace-statements-to-application-code.md)   
+ [方法: トレースとデバッグによる条件付きコンパイル](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md)   
+ [方法: 作成、初期化、およびトレース スイッチを構成します。](../../../docs/framework/debug-trace-profile/how-to-create-initialize-and-configure-trace-switches.md)   
+ [方法: 作成し、トレース ソースの初期化](../../../docs/framework/debug-trace-profile/how-to-create-and-initialize-trace-sources.md)   
+ [方法: TraceSource とフィルターを使用して、トレース リスナー](../../../docs/framework/debug-trace-profile/how-to-use-tracesource-and-filters-with-trace-listeners.md)   
+ [トレース リスナー](../../../docs/framework/debug-trace-profile/trace-listeners.md)   
+ [トレース スイッチ](../../../docs/framework/debug-trace-profile/trace-switches.md)
\ No newline at end of file
diff --git a/docs/framework/debug-trace-profile/virtualcercall-mda.md b/docs/framework/debug-trace-profile/virtualcercall-mda.md
new file mode 100644
index 00000000000..35e21e17fab
--- /dev/null
+++ b/docs/framework/debug-trace-profile/virtualcercall-mda.md
@@ -0,0 +1,112 @@
+---
+title: "virtualCERCall MDA | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDAs (managed debugging assistants), CER calls"
+  - "virtualCERCall MDA"
+  - "virtual CER calls"
+  - "constrained execution regions"
+  - "CER calls"
+  - "managed debugging assistants (MDAs), CER calls"
+ms.assetid: 1eb18c7a-f5e0-443f-80fb-67bfbb047da2
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# virtualCERCall MDA
+`virtualCERCall` マネージ デバッグ アシスタント \(MDA\) は、制約された実行領域 \(CER: Constrained Execution Region\) 呼び出し先内の呼び出しサイトが仮想ターゲット \(つまり、最終でない仮想メソッドの呼び出しまたはインターフェイスを使用した呼び出し\) を参照していることを示す警告としてアクティブになります。  共通言語ランタイム \(CLR: Common Language Runtime\) では、中間言語とメタデータ分析のみに基づいて、これらの呼び出しの対象メソッドを予測することはできません。  その結果、コール ツリーを CER グラフの一部として作成できず、そのサブツリーにおけるスレッドの中止を自動的に回避できません。  この MDA は、実行時に呼び出し対象の計算に必要な追加情報が明らかになると、<xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A> メソッドを明示的に呼び出して CER を拡張する必要がある場合に警告を行います。  
+  
+## 症状  
+ スレッドが中止されている場合や、アプリケーション ドメインがアンロードされている場合に、CER が実行されません。  
+  
+## 原因  
+ 自動的に作成できない仮想メソッドの呼び出しが CER に含まれています。  
+  
+## 解決策  
+ 仮想メソッドの <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A> を呼び出します。  
+  
+## ランタイムへの影響  
+ この MDA は、CLR への影響はありません。  
+  
+## 出力  
+  
+```  
+Method 'MethodWithCer', while executing within a constrained execution region, makes a call  
+at IL offset 0x0024 to 'VirtualMethod', which is virtual and cannot be prepared automatically  
+at compile time. The caller must ensure this method is prepared explicitly at  
+runtime before entering the constrained execution region.  
+method name="VirtualMethod"  
+declaringType name="VirtualCERCall+MyClass"  
+  declaringModule name="mda"  
+    callsite name="MethodWithCer" offset="0x0024"  
+```  
+  
+## 構成  
+  
+```  
+<mdaConfig>  
+  <assistants>  
+    < VirtualCERCall />  
+  </assistants>  
+</mdaConfig>  
+```  
+  
+## 使用例  
+  
+```  
+class MyClass  
+{  
+    [ReliabilityContract(Consistency.MayCorruptProcess, CER.None)]  
+    virtual void VirtualMethod()  
+    {  
+        ...  
+    }  
+}  
+  
+class MyDerivedClass : MyClass  
+{  
+    [ReliabilityContract(Consistency.MayCorruptProcess, CER.None)]  
+    override void VirtualMethod()  
+    {  
+        ...  
+    }  
+}  
+  
+void MethodWithCer(MyClass object)  
+{  
+    RuntimeHelpers.PrepareConstrainedRegions();  
+    try  
+    {  
+        ...  
+    }  
+    finally  
+    {  
+        // Start of the CER.  
+  
+        // Cannot tell at analysis time whether object is a MyClass  
+        // or a MyDerivedClass, so we do not know which version of   
+        // VirtualMethod we are going to call.  
+        object.VirtualMethod();  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute>   
+ [Diagnosing Errors with Managed Debugging Assistants](../../../docs/framework/debug-trace-profile/diagnosing-errors-with-managed-debugging-assistants.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/TOC.md b/docs/framework/deployment/TOC.md
new file mode 100644
index 00000000000..fb9015efe1d
--- /dev/null
+++ b/docs/framework/deployment/TOC.md
@@ -0,0 +1,16 @@
+# [.NET Framework Client Profile](client-profile.md)
+# [アセンブリ バインディングのリダイレクトの構成](configuring-assembly-binding-redirection.md)
+# [配置ガイド (管理者向け)](guide-for-administrators.md)
+# [.NET Framework 4.5 のインストール中のシステム再起動の削減](reducing-system-restarts.md)
+# [ランタイムがアセンブリを検索する方法](how-the-runtime-locates-assemblies.md)
+# [アセンブリの読み込みのベスト プラクティス](best-practices-for-assembly-loading.md)
+# [.NET Framework 初期化エラー: ユーザー エクスペリエンスの管理](initialization-errors-managing-the-user-experience.md)
+# [side-by-side 実行](side-by-side-execution.md)
+# [side-by-side 実行用のコンポーネントを作成するためのガイドライン](guidelines-for-creating-components-for-side-by-side-execution.md)
+# [方法: CLR のアクティブ化に関する問題をデバッグする](how-to-debug-clr-activation-issues.md)
+# [配置](net-framework-and-applications.md)
+# [.NET Framework の配置](index.md)
+# [インプロセスの side-by-side 実行](in-process-side-by-side-execution.md)
+# [.NET Framework アプリケーションの配置](net-framework-applications.md)
+# [方法: .NET Framework 4.5 インストーラーの進行状況を表示する](how-to-get-progress-from-the-dotnet-installer.md)
+# [配置ガイド (開発者向け)](deployment-guide-for-developers.md)
diff --git a/docs/framework/deployment/best-practices-for-assembly-loading.md b/docs/framework/deployment/best-practices-for-assembly-loading.md
new file mode 100644
index 00000000000..f681499d37c
--- /dev/null
+++ b/docs/framework/deployment/best-practices-for-assembly-loading.md
@@ -0,0 +1,182 @@
+---
+title: "アセンブリの読み込みのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ, バインド"
+  - "アセンブリ, 読み込み"
+  - "アセンブリ読み込みエラー"
+  - "既定の読み込みコンテキスト"
+  - "読み込みコンテキスト"
+  - "読み込み元コンテキスト"
+  - "LoadFrom メソッド"
+  - "LoadWithPartialName メソッド"
+  - "TypeLoadException クラス, 原因"
+ms.assetid: 68d1c539-6a47-4614-ab59-4b071c9d4b4c
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アセンブリの読み込みのベスト プラクティス
+ここでは、<xref:System.InvalidCastException>、<xref:System.MissingMethodException>、およびその他のエラーの原因となることがある型 ID の問題を回避する方法について説明します。  ここでは、次の推奨事項について説明します。  
+  
+-   [読み込みコンテキストのメリットとデメリットについて理解する](#load_contexts)  
+  
+-   [部分的なアセンブリ名をバインドしない](#avoid_partial_names)  
+  
+-   [1 つのアセンブリを複数のコンテキストに読み込まない](#avoid_loading_into_multiple_contexts)  
+  
+-   [複数のバージョンのアセンブリを同じコンテキストに読み込まない](#avoid_loading_multiple_versions)  
+  
+-   [既定の読み込みコンテキストへの切り替えを検討する](#switch_to_default)  
+  
+ 最初の推奨事項である「[読み込みコンテキストのメリットとデメリットについて理解する](#load_contexts)」では、その他の推奨事項の背景情報を提供します。他の推奨事項を理解するには、読み込みコンテキストに関する知識が必要となるためです。  
+  
+<a name="load_contexts"></a>   
+## 読み込みコンテキストのメリットとデメリットについて理解する  
+ アプリケーション ドメインでは、アセンブリは、3 つのコンテキストのいずれかに読み込まれるか、コンテキストなしで読み込まれる可能性があります。  
+  
+-   既定の読み込みコンテキストには、グローバル アセンブリ キャッシュを調査して見つかるアセンブリ、ランタイムが \(SQL Server などで\) ホストされる場合のホスト アセンブリ ストア、およびアプリケーション ドメインの <xref:System.AppDomainSetup.ApplicationBase%2A> と <xref:System.AppDomainSetup.PrivateBinPath%2A> が含まれます。  <xref:System.Reflection.Assembly.Load%2A> メソッドのほとんどのオーバーロードは、このコンテキストにアセンブリを読み込みます。  
+  
+-   読み込み元コンテキストには、ローダーによって検索されない場所から読み込まれたアセンブリが含まれます。  たとえば、アドインが、アプリケーション パスではないディレクトリにインストールされることがあります。  <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>、<xref:System.AppDomain.CreateInstanceFrom%2A?displayProperty=fullName>、および <xref:System.AppDomain.ExecuteAssembly%2A?displayProperty=fullName> は、パスを使用して読み込むメソッドの例です。  
+  
+-   リフレクション専用コンテキストには、<xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A> メソッドと <xref:System.Reflection.Assembly.ReflectionOnlyLoadFrom%2A> メソッドを使用して読み込まれたアセンブリが含まれます。  このコンテキスト内のコードは実行できないため、ここでは説明しません。  詳細については、「[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)」を参照してください。  
+  
+-   リフレクション出力を使用して一時動的アセンブリを生成した場合、そのアセンブリはどのコンテキストにも含まれません。  また、<xref:System.Reflection.Assembly.LoadFile%2A> メソッドを使用して読み込まれる大部分のアセンブリは、コンテキストなしで読み込まれます。バイト配列から読み込まれるアセンブリは、\(ポリシーが適用された後の\) アセンブリの ID がグローバル アセンブリ キャッシュ内に存在するように確立される場合を除き、コンテキストなしで読み込まれます。  
+  
+ この実行コンテキストには、次のセクションで説明するようなメリットとデメリットがあります。  
+  
+### 既定の読み込みコンテキスト  
+ アセンブリが既定の読み込みコンテキストに読み込まれると、その依存関係が自動的に読み込まれます。  既定の読み込みコンテキストに読み込まれた依存関係は、既定の読み込みコンテキストまたは読み込み元コンテキストにあるアセンブリに対して自動的に検索されます。  アセンブリ ID による読み込みを行うと、バージョンが不明なアセンブリが使用されなくなるため、アプリケーションの安定性が向上します \(「[部分的なアセンブリ名をバインドしない](#avoid_partial_names)」を参照してください\)。  
+  
+ 既定の読み込みコンテキストを使用すると、次のようなデメリットが生じます。  
+  
+-   他のコンテキストに読み込まれた依存関係は使用できません。  
+  
+-   プローブ パスの外部の場所にあるアセンブリを、既定の読み込みコンテキストに読み込むことはできません。  
+  
+### 読み込み元コンテキスト  
+ 読み込み元コンテキストでは、アプリケーション パスの下にないために調査には含まれないパスから、アセンブリを読み込むことができます。  パス情報はコンテキストによって維持されるため、そのパスから依存関係を見つけて読み込むことができるようになります。  また、このコンテキスト内にあるアセンブリでは、既定の読み込みコンテキストに読み込まれた依存関係を使用できます。  
+  
+ <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッド、またはパスから読み込む他のいずれかのメソッドを使用してアセンブリを読み込むと、次のようなデメリットが生じます。  
+  
+-   同じ ID を持つアセンブリが既に読み込まれている場合、<xref:System.Reflection.Assembly.LoadFrom%2A> は、別のパスが指定されている場合であっても、読み込み済みのアセンブリを返します。  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A> を使用してアセンブリを読み込んだ後、同じアセンブリを、既定の読み込みコンテキストにあるアセンブリが表示名で読み込もうとすると、読み込みが失敗します。  これは、アセンブリが逆シリアル化されるときに発生します。  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A> を使用してアセンブリを読み込み、ID が同じで場所が異なるアセンブリをプローブ パスに含めると、<xref:System.InvalidCastException>、<xref:System.MissingMethodException>、またはその他の予測できない動作が発生します。  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A> には、指定したパスに対する <xref:System.Security.Permissions.FileIOPermissionAccess?displayProperty=fullName> および <xref:System.Security.Permissions.FileIOPermissionAccess?displayProperty=fullName>、または <xref:System.Net.WebPermission> が必要です。  
+  
+-   アセンブリにネイティブ イメージが存在する場合、それは使用されません。  
+  
+-   アセンブリをドメイン中立として読み込むことはできません。  
+  
+-   .NET Framework Version 1.0 および 1.1 では、ポリシーが適用されません。  
+  
+### コンテキストなし  
+ コンテキストなしでの読み込みは、リフレクション出力で生成される一時アセンブリに対する唯一のオプションです。  1 つのアプリケーション ドメイン内に同じ ID を持つ複数のアセンブリを読み込むには、コンテキストなしでの読み込みを行うしか方法がありません。  調査のコストは回避されます。  
+  
+ バイト配列から読み込まれるアセンブリは、ポリシーの適用時に確立されたアセンブリの ID がグローバル アセンブリ キャッシュ内のアセンブリの ID と一致する場合を除き、コンテキストなしで読み込まれます。この場合、アセンブリはグローバル アセンブリ キャッシュから読み込まれます。  
+  
+ コンテキストなしでアセンブリを読み込むと、次のようなデメリットが生じます。  
+  
+-   <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを処理しない限り、他のアセンブリが、コンテキストなしで読み込まれたアセンブリにバインドすることはできません。  
+  
+-   依存関係は自動的に読み込まれません。  <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを処理すると、コンテキストなしでのプリロード、既定の読み込みコンテキストへのプリロード、または読み込みを行うことができます。  
+  
+-   同じ ID を持つ複数のアセンブリをコンテキストなしで読み込むと、同じ ID を持つアセンブリを複数のコンテキストに読み込む場合と同様の型 ID の問題が発生することがあります。  「[1 つのアセンブリを複数のコンテキストに読み込まない](#avoid_loading_into_multiple_contexts)」を参照してください。  
+  
+-   アセンブリにネイティブ イメージが存在する場合、それは使用されません。  
+  
+-   アセンブリをドメイン中立として読み込むことはできません。  
+  
+-   .NET Framework Version 1.0 および 1.1 では、ポリシーが適用されません。  
+  
+<a name="avoid_partial_names"></a>   
+## 部分的なアセンブリ名をバインドしない  
+ アセンブリを読み込むときにアセンブリの表示名 \(<xref:System.Reflection.Assembly.FullName%2A>\) の一部だけを指定すると、部分的な名前のバインディングが行われます。  たとえば、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを呼び出すときに、アセンブリのバージョン、カルチャ、および公開キー トークンを省略して、簡易名だけを指定することがあります。  または、<xref:System.Reflection.Assembly.LoadWithPartialName%2A?displayProperty=fullName> メソッドを呼び出すこともあります。このメソッドは、最初に <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを呼び出しますが、それでアセンブリが見つからなかった場合、グローバル アセンブリ キャッシュを検索し、使用可能な最新バージョンのアセンブリを読み込みます。  
+  
+ 部分的な名前のバインドを使用すると、次のような多数の問題が発生することがあります。  
+  
+-   <xref:System.Reflection.Assembly.LoadWithPartialName%2A?displayProperty=fullName> メソッドが、同じ簡易名を持つ異なるアセンブリを読み込む可能性があります。  たとえば、2 つのアプリケーションによって、`GraphicsLibrary` という簡易名を持つ 2 つのまったく異なるアセンブリがグローバル アセンブリ キャッシュにインストールされることがあります。  
+  
+-   実際に読み込まれるアセンブリには、下位互換性がない場合があります。  たとえば、バージョンを指定しないと、プログラムの作成時に使用した元のバージョンよりも、ずっと後にリリースされたバージョンが読み込まれることがあります。  新しいバージョンに加えられている変更が原因で、アプリケーションでエラーが発生することがあります。  
+  
+-   実際に読み込まれるアセンブリには、上位互換性がない場合があります。  たとえば、最新バージョンのアセンブリを使用してアプリケーションをビルドおよびテストしても、部分的なバインドにより、アプリケーションが使用する機能を備えていない、ずっと以前のバージョンのアセンブリが読み込まれることがあります。  
+  
+-   新しいアプリケーションをインストールすることで、既存のアプリケーションが破損する可能性があります。  <xref:System.Reflection.Assembly.LoadWithPartialName%2A> メソッドを使用するアプリケーションは、より新しい、互換性のないバージョンの共有アセンブリのインストールによって破損することがあります。  
+  
+-   予期しない依存関係の読み込みが発生する可能性があります。  依存関係を共有する 2 つのアセンブリを部分的なバインドによって読み込むと、一方のアセンブリが、ビルドやテストで使われたものではないコンポーネントを使用する結果になることがあります。  
+  
+ このような問題の原因となる可能性から、<xref:System.Reflection.Assembly.LoadWithPartialName%2A> メソッドは、現在は使用されない形式として設定されています。  代わりに <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを使用して、アセンブリの完全な表示名を指定することをお勧めします。  「[読み込みコンテキストのメリットとデメリットについて理解する](#load_contexts)」および「[既定の読み込みコンテキストへの切り替えを検討する](#switch_to_default)」を参照してください。  
+  
+ アセンブリの読み込みが簡単になるという理由で <xref:System.Reflection.Assembly.LoadWithPartialName%2A> メソッドを使用する場合は、アセンブリが見つからないことを示すエラー メッセージを表示してアプリケーションを終了する方が、未知のバージョンのアセンブリを自動的に使用するよりも望ましいユーザー エクスペリエンスになる可能性が高い点を考慮してください。未知のバージョンを使用すると、予測できない動作やセキュリティ ホールを引き起こす可能性があります。  
+  
+<a name="avoid_loading_into_multiple_contexts"></a>   
+## 1 つのアセンブリを複数のコンテキストに読み込まない  
+ 1 つのアセンブリを複数のコンテキストに読み込むと、型 ID の問題が引き起こされることがあります。  2 つの異なるコンテキストに同じアセンブリから同じ型が読み込まれると、同じ名前を持つ 2 つの異なる型が読み込まれたような状態になります。  一方の型を別の型にキャストしようとした場合、<xref:System.InvalidCastException> がスローされ、型 `MyType` を型 `MyType` にキャストできないという混乱を招くメッセージが表示されます。  
+  
+ たとえば、`Utility` という名前のアセンブリで `ICommunicate` インターフェイスが宣言されているとします。このアセンブリは、ユーザーのプログラムで参照され、そのプログラムが読み込む他のアセンブリによっても参照されています。  これらの他のアセンブリには、`ICommunicate` インターフェイスを実装する型が含まれ、ユーザーのプログラムで使用できるようになっています。  
+  
+ では、このプログラムを実行すると何が起きるでしょうか。  プログラムで参照されているアセンブリは、既定の読み込みコンテキストに読み込まれます。  <xref:System.Reflection.Assembly.Load%2A> メソッドを使用し、ID を指定してターゲット アセンブリを読み込んだ場合は、アセンブリが既定の読み込みコンテキストに配置され、その依存関係も同様に扱われます。  プログラムとターゲット アセンブリは、どちらも同じ `Utility` アセンブリを使用することになります。  
+  
+ ただし、ここでは、<xref:System.Reflection.Assembly.LoadFile%2A> メソッドを使用し、ファイル パスを指定してターゲット アセンブリを読み込む場合を想定します。  アセンブリはコンテキストなしで読み込まれるため、その依存関係は自動的には読み込まれません。  そこで、<xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベント ハンドラーを使用して依存関係を指定し、<xref:System.Reflection.Assembly.LoadFile%2A> メソッドを使用して、コンテキストなしで `Utility` アセンブリを読み込むことにします。  この場合、ターゲット アセンブリに含まれる型のインスタンスを作成し、そのインスタンスを型 `ICommunicate` の変数に割り当てようとすると、<xref:System.InvalidCastException> がスローされます。ランタイムでは、`Utility` アセンブリの 2 つのコピーに含まれている `ICommunicate` インターフェイスが、別々の型であると見なされるためです。  
+  
+ 1 つのアセンブリが複数のコンテキストに読み込まれるシナリオは、これ以外にも数多くあります。  このような競合を回避する最善の方法は、ターゲット アセンブリをアプリケーション パスに再配置し、完全な表示名を指定して <xref:System.Reflection.Assembly.Load%2A> メソッドを使用することです。  これにより、アセンブリが既定の読み込みコンテキストに読み込まれ、どちらのアセンブリも同じ `Utility` アセンブリを使用することになります。  
+  
+ ターゲット アセンブリをアプリケーション パスの外部に配置する必要がある場合は、<xref:System.Reflection.Assembly.LoadFrom%2A> メソッドを使用して、読み込み元コンテキストに読み込むことができます。  アプリケーションの `Utility` アセンブリへの参照を使用してコンパイルされたターゲット アセンブリでは、アプリケーションが既定の読み込みコンテキストに読み込んだ `Utility` アセンブリが使用されます。  アプリケーション パスの外部に配置された `Utility` アセンブリのコピーに対してターゲット アセンブリが依存関係を持っている場合は、問題が発生する可能性があることに注意が必要です。  アプリケーションが `Utility` アセンブリを読み込む前に、このような依存関係を持つアセンブリが読み込み元コンテキストに読み込まれると、アプリケーションの読み込みは失敗します。  
+  
+ <xref:System.Reflection.Assembly.LoadFile%2A> や <xref:System.Reflection.Assembly.LoadFrom%2A> などのファイル パスからの読み込みに代わる代替手段については、「[既定の読み込みコンテキストへの切り替えを検討する](#switch_to_default)」で説明します。  
+  
+<a name="avoid_loading_multiple_versions"></a>   
+## 複数のバージョンのアセンブリを同じコンテキストに読み込まない  
+ 複数のバージョンのアセンブリを 1 つの読み込みコンテキストに読み込むと、型 ID の問題が引き起こされることがあります。  同じアセンブリの 2 つのバージョンから同じ型が読み込まれると、同じ名前を持つ 2 つの異なる型が読み込まれたような状態になります。  一方の型を別の型にキャストしようとした場合、<xref:System.InvalidCastException> がスローされ、型 `MyType` を型 `MyType` にキャストできないという混乱を招くメッセージが表示されます。  
+  
+ たとえば、ユーザーのプログラムで、あるバージョンの `Utility` アセンブリを直接読み込み、その後で別のアセンブリを読み込むとします。この別のアセンブリによって、異なるバージョンの `Utility` アセンブリが読み込まれることがあります。  または、コーディング エラーが原因で、アプリケーション内に 2 つの異なるコード パスが生じ、異なるバージョンのアセンブリが読み込まれることも考えられます。  
+  
+ 既定の読み込みコンテキストでは、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを使用し、異なるバージョン番号を含むアセンブリの完全な表示名を指定した場合に、この問題が発生することがあります。  コンテキストなしで読み込まれたアセンブリでは、<xref:System.Reflection.Assembly.LoadFile%2A?displayProperty=fullName> メソッドを使用して別々のパスから同じアセンブリを読み込んだ場合に、この問題が発生することがあります。  ランタイムでは、異なるパスから読み込まれた 2 つのアセンブリは、たとえその ID が同一であっても、別々のアセンブリであると見なされます。  
+  
+ 複数のバージョンのアセンブリが存在すると、型 ID の問題だけでなく、<xref:System.MissingMethodException> が発生することもあります。これは、あるバージョンのアセンブリから読み込まれた型が、それとは異なるバージョンの型を必要とするコードに渡された場合に発生します。  たとえば、より新しいバージョンに追加されたメソッドが、コードで必要とされている場合が考えられます。  
+  
+ 型の動作がバージョン間で変更されていると、明確でないエラーが発生することもあります。  たとえば、メソッドから予期しない例外がスローされたり、予期しない値が返されたりすることがあります。  
+  
+ コードをよく調べ、読み込まれるアセンブリのバージョンが 1 つだけであることを確認してください。  特定の時点で読み込まれているアセンブリを確認するには、<xref:System.AppDomain.GetAssemblies%2A?displayProperty=fullName> メソッドを使用できます。  
+  
+<a name="switch_to_default"></a>   
+## 既定の読み込みコンテキストへの切り替えを検討する  
+ アプリケーションのアセンブリの読み込みと配置のパターンを調査してください。  バイト配列から読み込まれるアセンブリを取り除くことができるかどうかを検討します。  アセンブリをプローブ パスに移動できるかどうかを検討します。  アセンブリがグローバル アセンブリ キャッシュにある場合、またはアプリケーション ドメインのプローブ パス \(つまり、アプリケーション ドメインの <xref:System.AppDomainSetup.ApplicationBase%2A> および <xref:System.AppDomainSetup.PrivateBinPath%2A>\) にある場合は、ID を指定してアセンブリを読み込むことができます。  
+  
+ すべてのアセンブリをプローブ パスに置くことができない場合は、.NET Framework アドイン モデルの使用、アセンブリのグローバル アセンブリ キャッシュ内への配置、アプリケーション ドメインの作成などの代替手段を検討してください。  
+  
+### .NET アドイン モデルの使用を検討する  
+ 読み込み元コンテキストを使用してアドインを実装している場合 \(通常、これらはアプリケーション ベースにはインストールされません\)、.NET Framework アドイン モデルを使用してください。  このモデルでは、アプリケーション ドメインまたはプロセス レベルでの分離が提供されます。アプリケーション ドメインを管理する必要はありません。  アドイン モデルの詳細については、「[アドインおよび拡張機能](../../../ml/index.xml)」を参照してください。  
+  
+### グローバル アセンブリ キャッシュの使用を検討する  
+ アセンブリをグローバル アセンブリ キャッシュに配置すると、アプリケーション ベースの外部にある共有アセンブリ パスの利点を活用できます。既定の読み込みコンテキストのメリットが損なわれたり、その他のコンテキストのデメリットが生じたりすることはありません。  
+  
+### アプリケーション ドメインの使用を検討する  
+ アプリケーションのプローブ パスに配置できないアセンブリがあると判断される場合は、それらのアセンブリに対して新しいアプリケーション ドメインを作成することを検討してください。  <xref:System.AppDomainSetup> を使用して新しいアプリケーション ドメインを作成し、<xref:System.AppDomainSetup.ApplicationBase%2A?displayProperty=fullName> プロパティを使用して読み込むアセンブリのあるパスを指定します。  調査するディレクトリが複数ある場合は、<xref:System.AppDomainSetup.ApplicationBase%2A> をルート ディレクトリに設定し、<xref:System.AppDomainSetup.PrivateBinPath%2A?displayProperty=fullName> プロパティを使用して調査するサブディレクトリを指定します。  または、複数のアプリケーション ドメインを作成し、各アプリケーション ドメインの <xref:System.AppDomainSetup.ApplicationBase%2A> を、そのアセンブリの適切なパスに設定することもできます。  
+  
+ これらのアセンブリは、<xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドを使用して読み込むことができます。  これらはプローブ パスに存在することになるので、読み込み元コンテキストからではなく、既定の読み込みコンテキストに読み込まれるようになります。  ただし、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドに切り替えて、常に最新のバージョンが使用されるようにアセンブリの完全な表示名を指定することをお勧めします。  
+  
+## 参照  
+ <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Assembly.LoadFile%2A?displayProperty=fullName>   
+ <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName>   
+ [アドインおよび拡張機能](../../../ml/index.xml)
\ No newline at end of file
diff --git a/docs/framework/deployment/client-profile.md b/docs/framework/deployment/client-profile.md
new file mode 100644
index 00000000000..252bde98b9c
--- /dev/null
+++ b/docs/framework/deployment/client-profile.md
@@ -0,0 +1,44 @@
+---
+title: ".NET Framework Client Profile | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework Client Profile"
+  - "クライアント プロファイル [.NET Framework Client Profile]"
+  - "プロファイル [.NET Framework Client Profile]"
+  - "WCF [.NET Framework Client Profile]"
+  - "Windows フォーム [.NET Framework Client Profile]"
+  - "WPF [.NET Framework Client Profile]"
+ms.assetid: f0219919-1f02-4588-8704-327a62fd91f1
+caps.latest.revision: 44
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 44
+---
+# .NET Framework Client Profile
+.NET Client Profile は、.NET Framework のサブセットで、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以前のバージョンに含まれ、クライアント アプリケーション用に最適化されていました。  .NET Framework は、Windows、Windows Phone、および Microsoft Azure 用の開発プラットフォームであり、マネージ アプリの実行環境と .NET Framework クラス ライブラリを提供します。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以前のバージョンでは、2 種類の配置オプション \(完全な .NET Framework と Client Profile\) が用意されていました。  完全な .NET Framework に比べて、Client Profile では、配置の迅速化とアプリ インストール パッケージの小型化が実現されました。  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、Client Profile が中止され、完全な再頒布可能パッケージのみが使用できます。  より小さいダウンロード サイズや高速化された配置などの [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の最適化により、別の配置パッケージが不要になりました。  単一の再頒布可能パッケージにより、インストール プロセスが効率化され、アプリケーションの配置オプションが簡略化されます。  
+  
+ ただし .NET Framework 4 または 3.5 を対象としている場合、Client Profile とその使用時期については、.NET Framework 4 ドキュメントの「[.NET Framework Client Profile](http://msdn.microsoft.com/library/cc656912\(v=vs.100\).aspx)」を参照してください。  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] をインストールすると、.NET Framework 4 Client Profile は .NET Framework の完全バージョンに更新されます。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] をインストールする方法については、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+## 参照  
+ [.NET Framework Client Profile \(.NET Framework 4\)](http://msdn.microsoft.com/library/cc656912\(v=vs.100\).aspx)   
+ [Visual Studio のマルチ ターゲットの概要](../Topic/Visual%20Studio%20Multi-Targeting%20Overview.md)   
+ [.NET Framework を対象とするエラーのトラブルシューティング](../Topic/Troubleshooting%20.NET%20Framework%20Targeting%20Errors.md)   
+ [方法: .NET Framework のバージョンをターゲットにする](../Topic/How%20to:%20Target%20a%20Version%20of%20the%20.NET%20Framework.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/configuring-assembly-binding-redirection.md b/docs/framework/deployment/configuring-assembly-binding-redirection.md
new file mode 100644
index 00000000000..05b1ff91fc1
--- /dev/null
+++ b/docs/framework/deployment/configuring-assembly-binding-redirection.md
@@ -0,0 +1,71 @@
+---
+title: "アセンブリ バインディングのリダイレクトの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], バインディングのリダイレクト"
+  - "side-by-side 実行, アセンブリ バインディング リダイレクト"
+ms.assetid: d266cbd8-bf91-41d1-baf0-afbc481a741f
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アセンブリ バインディングのリダイレクトの構成
+既定では、アプリケーションは、アプリケーションのコンパイルに使用したランタイム バージョンと共に出荷された .NET Framework アセンブリのセットを使用します。  アプリケーション構成ファイルで .NET Framework アセンブリの特定のバージョンのアセンブリ バインディング参照をリダイレクトするには [\<assemblyBinding\>](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md) 要素の **appliesTo** 属性を使用できます。  このオプションの属性は、.NET Framework のバージョン番号を使用して、どのバージョンに適用するのかを示します。  **appliesTo** 属性が指定されていない場合、**\<assemblyBinding\>** 要素は、.NET Framework のすべてのバージョンに適用されます。  
+  
+ **appliesTo** 属性は .NET Framework Version 1.1 で導入されたものであり、.NET Framework Version 1.0 では無視されます。  これは **appliesTo** 属性が指定されている場合でも、.NET Framework version 1.0 を使用している場合 **\<assemblyBinding\>** のすべての要素が適用されることを意味します。  
+  
+> [!NOTE]
+>  **appliesTo** 属性は、アセンブリ バインディングのリダイレクトをランタイムの特定のバージョンに制限するために使用します。  
+  
+ たとえば、.NET Framework Version 1.0 アセンブリのアセンブリ バインディングをリダイレクトするには、アプリケーション構成ファイルに次の XML コードを追加します。  
+  
+```  
+<runtime>  
+        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">  
+            <dependentAssembly>   
+               * assembly information goes here *  
+            </dependentAssembly>  
+       </assemblyBinding>  
+</runtime>  
+```  
+  
+ **\<assemblyBinding\>** 要素は、順番が区別されます。  最初に .NET Framework Version 1.0 のアセンブリのアセンブリ バインディング リダイレクト情報を入力し、その次に .NET Framework Version 1.1 のアセンブリのアセンブリ バインディング リダイレクト情報を入力します。  最後に、**appliesTo** 属性を使用せず、すべてのバージョンの .NET Framework に適用される .NET Framework アセンブリ リダイレクトのアセンブリ バインディング リダイレクト情報を入力します。  リダイレクトで矛盾が発生した場合は、構成ファイル内で最初に一致したリダイレクト ステートメントが使用されます。  
+  
+ たとえば、ある参照を .NET Framework Version 1.0 のアセンブリにリダイレクトし、別の参照を .NET Framework Version 1.1 のアセンブリにリダイレクトするには、次の擬似コードに示すパターンを使用します。  
+  
+```  
+<assemblyBinding xmlns="..." appliesTo="v1.0.3705">   
+<! — .NET Framework version 1.0 redirects here. -->   
+</assemblyBinding>   
+  
+<assemblyBinding xmlns="..." appliesTo="v1.1.4322">   
+    <! — .NET Framework version 1.1 redirects here. -->   
+</assemblyBinding>   
+  
+<assemblyBinding xmlns="...">   
+<!-- Redirects meant for all versions of the .NET Framework. -->   
+</assemblyBinding>  
+```  
+  
+## 構成ファイル エラーのデバッグ  
+ ランタイムは、アプリケーション ドメインが作成されるときに構成ファイルを一度解析し、コードをアプリケーション ドメインに読み込みます。  共通言語ランタイムは、エントリを無視することによって構成ファイルに含まれるエラーを処理します。  構成ファイルに不正な XML が含まれる場合、ランタイムは構成ファイル全体を無視します。  無効な XML に対しては、無効なセクションだけを無視します。  
+  
+ アセンブリ バインディングのリダイレクトが発生しているかどうかを調べることによって、構成ファイルが使用されているかどうかを判断できます。  [アセンブリ バインディング ログ ビューアー \(Fuslogvw.exe\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) を使用して、読み込まれたアセンブリを調べます。  すべてのアセンブリ バインドを見るには、レジストリで **ForceLog** のエントリを設定する必要があります。  
+  
+## 参照  
+ [方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/deployment-guide-for-developers.md b/docs/framework/deployment/deployment-guide-for-developers.md
new file mode 100644
index 00000000000..3908067f73d
--- /dev/null
+++ b/docs/framework/deployment/deployment-guide-for-developers.md
@@ -0,0 +1,407 @@
+---
+title: ".NET Framework 配置ガイド (開発者向け) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "開発者向けガイド、.NET Framework の配置"
+  - "配置 [.NET Framework]、開発者向けガイド"
+ms.assetid: 094d043e-33c4-40ba-a503-e0b20b55f4cf
+caps.latest.revision: 108
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 107
+---
+# .NET Framework 配置ガイド (開発者向け)
+このトピックでは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2 または [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]、4.6.1 または 4.6.2 を、それぞれのアプリと共にインストールする開発者向けの情報を提供します。  
+  
+ ダウンロード リンクについては、「[頒布可能パッケージ](#redist)」を参照してください。 再頒布可能パッケージと言語パックは、Microsoft ダウンロード センターの次のページからダウンロードすることもできます。  
+  
+-   すべてのオペレーティング システムの [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=780597)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=780601)\)  
+  
+-   すべてのオペレーティング システムの [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=671729)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=671744)\)  
+  
+-   すべてのオペレーティング システムの [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=528222)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=528232)\)  
+  
+-   すべてのオペレーティング システムの .NET Framework 4.5.2 \([Web インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=397703)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=397706)\)  
+  
+-   すべてのオペレーティング システムの .NET Framework 4.5.1 \([Web インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=310158)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=310159)\)  
+  
+-   [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484)  
+  
+ 重要なメモ:  
+  
+> [!NOTE]
+>  "[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリース" という語句は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、4.6.1、4.6.2 を指します。  
+  
+-   [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]、4.5.2、4.6、4.6.1、4.6.2 は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のインプレース更新です。つまり、同じバージョンのランタイムを使用しますが、アセンブリのバージョンが更新され、新しい型とメンバーが含まれます。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリースは、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] の上にインクリメンタル方式でビルドされます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされているシステムに [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、4.6.1、4.6.2 をインストールすると、バージョン 4 のアセンブリが新しいバージョンに置き換えられます。  
+  
+-   アプリで Microsoft [帯域外のパッケージ](http://msdn.microsoft.com/library/dn151288\(v=vs.110\).aspx) を参照している場合、アセンブリはアプリのパッケージに組み込まれます。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリースをインストールするには、管理者特権が必要です。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、[!INCLUDE[win8](../../../includes/win8-md.md)] と [!INCLUDE[winserver8](../../../includes/winserver8-md.md)] に組み込まれているため、これらのオペレーティング システムではアプリと一緒に配置する必要はありません。 同様に、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] は [!INCLUDE[win81](../../../includes/win81-md.md)] と Windows Server 2012 R2 に組み込まれています。 .NET Framework 4.5.2 はどのオペレーティング システムにも含まれていません。[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] は Windows 10 に含まれます。[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] は Windows 10 の 11 月更新版に含まれます。[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] は Windows 10 Anniversary Update に含まれます。  ハードウェア要件とソフトウェア要件の一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、ユーザーはセットアップ中に、実行している .NET Framework アプリケーションの一覧を表示し、簡単に終了できます。 これにより、.NET Framework のインストールによるシステムの再起動を回避できます。 「[システム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)」を参照してください。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] またはそのポイント リリースのいずれかをアンインストールすると、前に存在していた [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] ファイルも削除されます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] に戻る場合は、そのバージョンとすべての更新プログラムを再インストールする必要があります。 \(「[.NET Framework 4 のインストール](http://msdn.microsoft.com/library/5a4x27ek\(v=vs.100\).aspx)」をご覧ください\)。  
+  
+-   .NET Framework 4.5 再頒布可能パッケージは、2012 年 10 月 9 に更新されています。この更新により、Microsoft によって生成および署名されたファイルへのデジタル署名が途中で有効期限切れになるという、デジタル証明書の不適切なタイムスタンプに関連する問題が解決しました。 2012 年 8 月 16 日付けの .NET Framework 4.5 再頒布可能パッケージをインストールしていた場合は、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/p/?LinkId=245484)から最新の再頒布可能パッケージを入手して更新を行うことをお勧めします。 この問題について詳しくは、「[マイクロソフト セキュリティ アドバイザリ \(2749655\)](http://technet.microsoft.com/security/advisory/2749655)」をご覧ください。  
+  
+ システム管理者が .NET Framework とそのシステムの依存関係をネットワーク経由で配置する方法については、「[配置ガイド \(管理者向け\)](../../../docs/framework/deployment/guide-for-administrators.md)」をご覧ください。  
+  
+<a name="deploy_options"></a>   
+## アプリケーションの配置オプション  
+ ユーザーがアプリケーションをインストールできるように Web サーバーまたは他の一元的な場所にアプリケーションを発行する準備ができたら、複数の配置方法から選択できます。 これらの一部は、Visual Studio に装備されています。 次の表に、アプリケーションの配置オプションの一覧と、各オプションをサポートする .NET Framework 再頒布可能パッケージを示します。 これらに加えて、アプリケーション用のカスタム セットアップ プログラムを作成できます。詳細については、「[アプリケーションのセットアップへの .NET Framework のインストールのチェーン](#chaining)」を参照してください。  
+  
+|アプリケーションの配置戦略|使用できる配置方法|使用する .NET Framework 再頒布可能パッケージ|  
+|-------------------|---------------|------------------------------------|  
+|Web からのインストール|-   [InstallShield](#installshield)<br />-   [WiX ツールセット](#wix)<br />-   [手動インストール](#installing_manually)|[Web インストーラー](#redist)|  
+|ディスクからのインストール|-   [InstallShield](#installshield)<br />-   [WiX ツールセット](#wix)<br />-   [手動インストール](#installing_manually)|[オフライン インストーラー](#redist)|  
+|ローカル エリア ネットワークからのインストール \(エンタープライズ アプリケーションの場合\)|-   [ClickOnce](#clickonce)|[Web インストーラー](#redist) \(制約については「[ClickOnce](#clickonce)」を参照\) または[オフライン インストーラー](#redist)|  
+  
+<a name="redist"></a>   
+## 再頒布可能パッケージ  
+ .NET Framework は、Web インストーラー \(ブートストラップ\) とオフライン インストーラー \(スタンドアロン再頒布可能パッケージ\) の 2 種類の再頒布可能パッケージで入手できます。 2 つのパッケージの比較を次の表に示します。  
+  
+||Web インストーラー|オフライン インストーラー|  
+|-|-----------------|-------------------|  
+|ファイルのダウンロード|[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]: <br />[NDP462\-KB3151802\-Web.exe](http://go.microsoft.com/fwlink/?LinkId=780596)<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]:<br />[NDP461\-KB3102438\-Web.exe](http://go.microsoft.com/fwlink/?LinkId=671728)<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]:<br />[NDP46\-KB3045560\-Web.exe](http://go.microsoft.com/fwlink/?LinkId=528222)<br /><br /> .NET Framework 4.5.2: <br />[NDP452\-KB2901954\-Web.exe](http://go.microsoft.com/fwlink/?LinkId=397707)<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]: <br />[NDP451\-KB2859818\-Web.exe](http://go.microsoft.com/fwlink/?LinkId=322115)<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]: <br />[dotNetFx45\_Full\_setup.exe](http://go.microsoft.com/fwlink/?LinkId=225704)|[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]: <br />[NDP462\-KB3151800\-x86\-x64\-AllOS\-ENU.exe](http://go.microsoft.com/fwlink/?LinkId=780600)<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]: <br />[NDP461\-KB3102436\-x86\-x64\-AllOS\-ENU.exe](http://go.microsoft.com/fwlink/?LinkId=671743)<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]: <br />[NDP46\-KB3045557\-x86\-x64\-AllOS\-ENU.exe](http://go.microsoft.com/fwlink/?LinkId=528232)<br /><br /> .NET Framework 4.5.2: <br />[NDP452\-KB2901907\-x86\-x64\-AllOS\-ENU.exe](http://go.microsoft.com/fwlink/?LinkId=397708)<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]: <br />[NDP451\-KB2858728\-x86\-x64\-AllOS\-ENU.exe](http://go.microsoft.com/fwlink/?LinkId=322116)<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]: <br />[dotNetFx45\_Full\_x86\_x64.exe](http://go.microsoft.com/fwlink/?LinkId=225702)|  
+|インターネット接続の必要性|○|Ｘ|  
+|ダウンロードのサイズ|小 \(ターゲット プラットフォームのインストーラーのみを含む\)\*|Larger\*|  
+|言語パック|含む\*\*|すべてのオペレーティング システムを対象とするパッケージを使用しない場合は、[個別にインストールする](#chain_langpack)必要があります|  
+|配置方法|すべてのメソッドをサポート<br /><br /> -   [ClickOnce](#clickonce)<br />-   [InstallShield](#installshield)<br />-   [Windows インストーラー XML \(WiX\)](#wix)<br />-   [手動インストール](#installing_manually)<br />-   [カスタム セットアップ \(チェーン\)](#chaining)|すべてのメソッドをサポート<br /><br /> -   [ClickOnce](#clickonce)<br />-   [InstallShield](#installshield)<br />-   [Windows インストーラー XML \(WiX\)](#wix)<br />-   [手動インストール](#installing_manually)<br />-   [カスタム セットアップ \(チェーン\)](#chaining)|  
+|ClickOnce 配置のダウンロード場所|Microsoft ダウンロード センター:<br /><br /> -   [.NET Framework 4.6.2](http://go.microsoft.com/fwlink/?LinkId=780596)<br />-   [.NET Framework 4.6.1](http://go.microsoft.com/fwlink/?LinkId=671728)<br />-   [.NET Framework 4.6](http://go.microsoft.com/fwlink/?LinkId=528222)<br />-   [.NET Framework 4.5.2](http://go.microsoft.com/fwlink/?LinkId=397703)<br />-   [.NET Framework 4.5.1](http://go.microsoft.com/fwlink/p/?LinkId=310158)<br />-   [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484)|独自のサーバーまたは Microsoft ダウンロード センター:<br /><br /> -   [.NET Framework 4.6.2](http://go.microsoft.com/fwlink/?LinkId=780600)<br />-   [.NET Framework 4.6.1](http://go.microsoft.com/fwlink/?LinkId=671743)<br />-   [.NET Framework 4.6](http://go.microsoft.com/fwlink/?LinkId=528232)<br />-   [.NET Framework 4.5.2](http://go.microsoft.com/fwlink/p/?LinkId=397706)<br />-   [.NET Framework 4.5.1](http://go.microsoft.com/fwlink/p/?LinkId=310159)<br />-   [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484)|  
+  
+ \* オフライン インストーラーは、すべての対象プラットフォームのコンポーネントを含むため、より大きくなっています。 セットアップの実行が終了すると、Windows オペレーティング システムは使用されたインストーラーのみキャッシュします。 オフライン インストーラーがインストール後に削除されると、使用されるディスク領域は Web インストーラーに使用される領域と同じになります。 アプリのセットアップ プログラムの作成に使用するツール \(たとえば、[InstallShield](#installshield)\) によって、インストール後に削除されるセットアップ ファイル フォルダーが提供される場合は、オフライン インストーラーをそのセットアップ フォルダー内に配置することで自動的に削除できます。  
+  
+ \*\* カスタム設定の Web インストーラーを使用する場合は、ユーザーの複数言語ユーザー インターフェイス \(MUI\) 設定に基づいて既定の言語設定を使用するか、コマンド ラインで `/LCID` オプションを使用して別の言語パックを指定できます。 例については、「[既定の .NET Framework の UI を使用したチェーン](#chaining_default)」を参照してください。  
+  
+<a name="deployment_methods"></a>   
+## 配置方法  
+ 3 の配置方法を使用できます。  
+  
+-   .NET Framework の依存関係を設定できます。 これらのメソッドのいずれかを使用して、アプリケーションのインストールで必須コンポーネントとして .NET Framework を指定できます。  
+  
+    -   [ClickOnce 配置](#clickonce)を使用します \(Visual Studio で使用可能\)  
+  
+    -   [InstallShield プロジェクト](#installshield)を作成します \(Visual Studio で使用可能\)  
+  
+    -   [Windows インストーラー XML \(WiX\) ツール セット](#wix)を使用します。  
+  
+-   [.NET Framework を手動でインストール](#installing_manually)するようにユーザーに依頼できます。  
+  
+-   アプリケーションのセットアップに .NET Framework セットアップ プロセスをチェイン \(インクルード\) して、.NET Framework のインストール環境をどのように処理するかを決定できます。  
+  
+    -   [既定の UI を使用](#chaining_default)します。 .NET Framework のインストーラーによりインストール環境が提供されます。  
+  
+    -   [UI をカスタマイズ](#chaining_custom)して、一元化されたインストール エクスペリエンスを提供し、.NET Framework のインストールの進行状況を監視します。  
+  
+ これらの配置方法の詳細については、以降のセクションで説明します。  
+  
+## .NET Framework の依存関係の設定  
+ アプリケーションの配置に ClickOnce、InstallShield、または WiX を使用した場合、.NET Framework の依存関係を追加して、アプリケーションの一部としてインストールできます。  
+  
+<a name="clickonce"></a>   
+### ClickOnce の配置  
+ ClickOnce 配置は、Visual Basic および Visual C\# を使用して作成したプロジェクトに使用できますが、Visual C\+\+ には使用できません。  
+  
+ Visual Studio で ClickOnce 配置を選択し、.NET Framework の依存関係を追加するには:  
+  
+1.  発行するアプリケーション プロジェクトを開きます。  
+  
+2.  ソリューション エクスプローラーで、プロジェクトのショートカット メニューを開き、**\[プロパティ\]** を選択します。  
+  
+3.  **\[発行\]** ペインを選択します。  
+  
+4.  **\[必須コンポーネント\]** ボタンをクリックします。  
+  
+5.  **\[必須コンポーネント\]** ダイアログ ボックスの **\[必須コンポーネントをインストールするセットアップ プログラムを作成する\]** チェック ボックスをオンにします。  
+  
+6.  必須コンポーネントの一覧で、プロジェクトのビルドに使用した .NET Framework のバージョンを検索して選択します。  
+  
+7.  必須コンポーネントのソースの場所を指定するオプションを選択し、**\[OK\]** をクリックします。  
+  
+     .NET Framework のダウンロード場所の URL を指定する場合は、Microsoft ダウンロード センター サイトまたは独自のサイトを指定できます。 再頒布可能パッケージを独自のサーバーに配置する場合は、Web インストーラーではなく、オフライン インストーラーを使用する必要があります。 Microsoft ダウンロード センターの Web インストーラーにのみリンクできます。 URL には、独自のアプリケーションを配布する CD を指定することもできます。  
+  
+8.  **\[プロパティ ページ\]** ダイアログ ボックスの **\[OK\]** をクリックします。  
+  
+<a name="installshield"></a>   
+### InstallShield 配置  
+ Visual Studio で InstallShield 配置を選択し、.NET Framework の依存関係を追加するには:  
+  
+1.  Visual Studio メニュー バーで、**\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの左ペインで、**\[その他のプロジェクトの種類\]**、**\[セットアップと配置\]**、**\[InstallShield LE\]** の順に選択します。  
+  
+3.  **\[名前\]** ボックスにプロジェクト名を入力し、**\[OK\]** をクリックします。  
+  
+4.  初めてセットアップと配置プロジェクトを作成している場合、**\[InstallShield に移動\]** または **\[InstallShield Limited Edition の有効化\]** を選択し、ご使用の Microsoft Visual Studio のバージョンの InstallShield Limited Edition をダウンロードします。 Visual Studio を再起動します。  
+  
+5.  **プロジェクト アシスタント** ウィザードに移動し、**\[アプリケーション ファイル\]** をクリックしてプロジェクト出力を追加します。 このウィザードを使用して、他のプロジェクト属性を設定できます。  
+  
+6.  **\[インストール要件\]** に移動し、オペレーティング システムと、インストールする .NET Framework のバージョンを選択します。  
+  
+7.  セットアップ プロジェクトのショートカット メニューを開き、**\[ビルド\]** を選択します。  
+  
+<a name="wix"></a>   
+### Windows インストーラー XML \(WiX\) 配置  
+ Windows インストーラー XML \(WiX\) ツールセットは、XML ソース コードから Windows インストール パッケージをビルドします。 WiX は、MSI と MSM セットアップ パッケージのビルド処理に統合できるコマンド ライン環境をサポートします。 WiX を使用すると、[.NET Framework を必須コンポーネントとして指定](http://wixtoolset.org/documentation/manual/v3/howtos/redistributables_and_install_checks/install_dotnet.html)するか、[チェーン元を作成](http://wixtoolset.org/documentation/manual/v3/xsd/wix/exepackage.html)して、.NET Framework の配置操作を完全制御できます。 WiX について詳しくは、「[Windows インストーラー XML \(WiX\) ツールセット](http://wixtoolset.org/)」の Web サイトをご覧ください。  
+  
+<a name="installing_manually"></a>   
+## .NET Framework の手動インストール  
+ アプリと一緒に .NET Framework を自動的にインストールすることが適切でない場合もあります。 そのような場合は、ユーザーが .NET Framework を手動でインストールできます。 頒布可能パッケージは、[2 つのパッケージ](#redist)で使用できます。 セットアップ プロセスでは、.NET Framework を探す方法とインストールする方法についてユーザーに指示する必要があります。  
+  
+<a name="chaining"></a>   
+## アプリケーションのセットアップへの .NET Framework のインストールのチェーン  
+ アプリケーション用のカスタム セットアップ プログラムを作成する場合、.NET Framework セットアップ プロセスをアプリケーションのセットアップ プロセスにチェーン \(インクルード\) することができます。 チェーンは、.NET Framework のインストールに次の 2 種類の UI オプションを提供します。  
+  
+-   .NET Framework のインストーラーによって提供される既定の UI を使用します。  
+  
+-   .NET Framework のインストールのカスタム UI を作成して、アプリケーションのセットアップ プログラムとの一貫性を保ちます。  
+  
+ どちらの方法でも、Web インストーラーまたはオフライン インストーラーを使用できます。 各パッケージには長所があります。  
+  
+-   Web インストーラーを使用した場合、.NET Framework セットアップ プロセスが必要なインストール パッケージを判断し、そのパッケージだけを Web サイトからダウンロードしてインストールします。  
+  
+-   オフライン インストーラーを使用すると、再頒布可能メディアに .NET Framework インストール パッケージの完全なセットを入れることができ、ユーザーがセットアップ中に Web から追加ファイルをダウンロードする必要がなくなります。  
+  
+<a name="chaining_default"></a>   
+### 既定の .NET Framework の UI を使用したチェーン  
+ .NET Framework インストール プロセスをサイレントにチェーンして .NET Framework のインストーラーに UI を提供させるには、セットアップ プログラムに次のコマンドを追加します。  
+  
+```  
+<.NET Framework redistributable> /q /norestart /ChainingPackage <PackageName>  
+```  
+  
+ たとえば、実行可能プログラムが Contoso.exe で、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のオフライン再頒布可能パッケージをサイレント インストールする場合は、次のコマンドを使用します。  
+  
+```  
+dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage Contoso  
+```  
+  
+ 追加のコマンド ライン オプションを使用して、インストールをカスタマイズできます。 次に例を示します。  
+  
+-   システムの再起動を最小限に抑えるために、実行中の .NET Framework アプリケーションを終了する方法をユーザーに提供するには、受動モードを設定して、次のように `/showrmui` オプションを使用します。  
+  
+    ```  
+    dotNetFx45_Full_x86_x64.exe /norestart /passive /showrmui /ChainingPackage Contoso  
+    ```  
+  
+     このコマンドは、.NET Framework をインストールする前に、.NET Framework アプリを終了する機会をユーザーに与えるメッセージ ボックスを、再起動マネージャーが表示できるようにします。  
+  
+-   Web インストーラーを使用する場合、`/LCID` オプションを使用して言語パックを指定できます。 たとえば、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] web インストーラーを Contoso セットアップ プログラムにチェーンして日本語の言語パックをインストールするには、次のコマンドをアプリのセットアップ プロセスに追加します。  
+  
+    ```  
+    dotNetFx45_Full_setup.exe /q /norestart /ChainingPackage Contoso /LCID 1041  
+    ```  
+  
+     `/LCID` オプションを省略すると、セットアップはユーザーの MUI 設定と一致する言語パックをインストールします。  
+  
+    > [!NOTE]
+    >  言語パックのリリース日は、それぞれ異なっている場合があります。 指定した言語パックがダウンロード センターで入手できない場合、セットアップは言語パックなしで .NET Framework をインストールします。 .NET Framework がユーザーのコンピューターに既にインストールされている場合、セットアップは言語パックだけをインストールします。  
+  
+ オプションの完全なリストについては、「[コマンド ライン オプション](#command_line_options)」を参照してください。  
+  
+ 共通の戻りコードについては、「[戻りコード](#return_codes)」を参照してください。  
+  
+<a name="chaining_custom"></a>   
+### カスタム UI を使用したチェーン  
+ カスタム セットアップ パッケージがある場合、セットアップの進行状況のビューを独自に表示する一方で、.NET Framework のセットアップをサイレントで起動および追跡できます。 この場合は、コードが次をカバーしていることを確認します。  
+  
+-   [.NET Framework のハードウェア要件とソフトウェア要件](../../../docs/framework/get-started/system-requirements.md)のチェック。  
+  
+-   .NET Framework の正しいバージョンがユーザーのコンピューターに既にインストールされているかどうかの[検出](#detect_net)。  
+  
+    > [!IMPORTANT]
+    >  正しいバージョンの .NET Framework が既にインストールされているかどうかを判断するには、ターゲット バージョンがインストールされているかどうかではなく、ターゲット バージョン*または*それ以降のバージョンがインストールされているかどうかを確認する必要があります。 言い換えると、レジストリから取得したリリース キーがターゲット バージョンのリリース キーと*同じかどうかを確認するのではなく*、ターゲット バージョンのリリース キーと同じか、それ以降になっているかどうかを確認する必要があります。  
+  
+-   言語パックがユーザーのコンピューターに既にインストールされているかどうかの[検出](#detect_langpack)。  
+  
+-   配置を制御する場合は、.NET Framework セットアップ プロセスをサイレントに起動および追跡 \(「[方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)」をご覧ください\)。  
+  
+-   オフライン インストーラーを配置する場合は、[言語パックを個別にチェーンします](#chain_langpack)。  
+  
+-   [コマンド ライン オプション](#command_line_options)を使用した配置のカスタマイズ。 たとえば、.NET Framework Web インストーラーをチェーンして、既定の言語パックをオーバーライドする場合は、前のセクションで説明したように `/LCID` オプションを使用します。  
+  
+-   [トラブルシューティング](#troubleshooting)。  
+  
+<a name="detect_net"></a>   
+### .NET Framework の検出  
+ .NET Framework のインストーラーは、インストールが成功するとレジストリ キーを書き込みます。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] またはそれ以降がインストールされているかどうかは、`Release` という名前の `DWORD` 値のレジストリで `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full` フォルダーを確認することでテストできます。 \("NET Framework セットアップ" の先頭ががピリオドではないことに注意してください\)。 このキーがある場合は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] またはそれ以降のバージョンがそのコンピューターにインストールされていることを示しています。`Release` の値は、インストールされている .NET Framework のバージョンを示します。  
+  
+> [!IMPORTANT]
+>  特定のバージョンが存在するかどうかを検出するには、Release キーワードの値**以上**の値があるかどうかをチェックする必要があります。  
+  
+|Version|Release DWORD の値|  
+|-------------|----------------------|  
+|Windows 10 Anniversary Edition にインストールされる [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|394802|  
+|Windows 10 Anniversary Edition 以外のすべての OS バージョンにインストールされる [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|394806|  
+|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] Windows 10 の 11 月更新版にインストールされる|394254|  
+|Windows 10 の 11 月更新版以外のすべての OS バージョンにインストールされる [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|394271|  
+|Windows 10 にインストールされる [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|393295|  
+|Windows 10 以外のすべての OS バージョンにインストールされる [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|393297|  
+|.NET Framework 4.5.2|379893|  
+|[!INCLUDE[win81](../../../includes/win81-md.md)] または Windows Server 2012 R2 でインストールされた [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]|378675|  
+|[!INCLUDE[win8](../../../includes/win8-md.md)]、Windows 7 にインストールされる [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]|378758|  
+|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]|378389|  
+  
+<a name="detect_langpack"></a>   
+### 言語パックの検出  
+ という名前の DWORD 値のレジストリで HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4\\Full\\`Release`*LCID* フォルダーをチェックすることにより、特定の言語パックがインストールされているかどうかをテストできます。 \("NET Framework セットアップ" の先頭ががピリオドではないことに注意してください\)。*LCID* はロケール識別子を指定します。これらのリストについては、「[サポートされる言語](#supported_languages)」を参照してください。  
+  
+ たとえば、完全な日本語言語パック \(LCID\=1041\) がインストールされているかどうかを検出するには、レジストリの次の値をチェックします。  
+  
+```  
+Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041  
+Name: Release  
+Type: DWORD  
+```  
+  
+ 言語パックの最終リリース バージョンが [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、4.6.1、4.6.2 にインストールされているかどうかを確認するには、前のセクション「[.NET Framework の検出](#detect_net)」で説明した Release キー DWORD の値を確認します。  
+  
+<a name="chain_langpack"></a>   
+### アプリケーション セットアップへの言語パックのチェーン  
+ .NET Framework には、特定のカルチャにローカライズされたリソースを含むスタンドアロンの言語パックの実行可能ファイルのセットが用意されています。 言語パックは Microsoft ダウンロード センターから入手できます。  
+  
+-   [.NET Framework 4.6.2 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=780604)  
+  
+-   [.NET Framework 4.6.1 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=671747)  
+  
+-   [.NET Framework 4.6 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=528314)  
+  
+-   [.NET Framework 4.5.2 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=397701)  
+  
+-   [.NET Framework 4.5.1 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=322101)  
+  
+-   [.NET Framework 4.5 の言語パック](http://go.microsoft.com/fwlink/p/?LinkId=245451)  
+  
+> [!IMPORTANT]
+>  言語パックには、アプリの実行に必要な .NET Framework コンポーネントは含まれていません。言語パックをインストールする前に、Web インストーラーまたはオフラインのインストーラーを使用して .NET Framework をインストールする必要があります。  
+  
+ [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] より、パッケージ名の形式は NDP\<`version`\>\-KB\<`number`\>\-x86\-x64\-AllOS\-\<`culture`\>.exe になります。`version` は .NET Framework のバージョン番号です。`number` は Microsoft サポート情報記事番号です。`culture` は[国\/地域](#supported_languages)です。 これらのパッケージの一例は、`NDP452-KB2901907-x86-x64-AllOS-JPN.exe` です。 パッケージ名はこの記事の既出の [再頒布可能パッケージ](#redist) セクションに記載されています。  
+  
+ .NET Framework のオフライン インストーラーを言語パックと一緒にインストールするには、言語パックをアプリのセットアップにチェーンする必要があります。 たとえば、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] のオフライン インストーラーを日本語言語パックと一緒に配置するには、次のコマンドを使用します。  
+  
+```  
+NDP451-KB2858728-x86-x64-AllOS-JPN.exe/q /norestart /ChainingPackage <ProductName>  
+```  
+  
+ Web インストーラーを使用する場合は、言語パックをチェーンする必要はありません。セットアップはユーザーの MUI 設定と一致する言語パックをインストールします。 異なる言語をインストールするには、`/LCID` オプションを使用して言語パックを指定します。  
+  
+ コマンド ライン オプションの完全なリストについては、「[コマンド ライン オプション](#command_line_options)」を参照してください。  
+  
+<a name="troubleshooting"></a>   
+### トラブルシューティング  
+  
+<a name="return_codes"></a>   
+#### リターン コード  
+ 次の表は、.NET Framework の再頒布可能インストーラーから返される最も一般的なリターン コードを示しています。 これらのリターン コードは、すべてのバージョンのインストーラーで共通です。 詳細情報へのリンクについては、次のセクションを参照してください。  
+  
+|リターン コード|説明|  
+|--------------|--------|  
+|0|インストールは正常に終了しました。|  
+|1602|ユーザーがインストールをキャンセルしました。|  
+|1603|インストール中に致命的なエラーが発生しました。|  
+|1641|インストールを完了するには再起動する必要があります。 このメッセージが表示された場合、操作は成功しました。|  
+|3010|インストールを完了するには再起動する必要があります。 このメッセージが表示された場合、操作は成功しました。|  
+|5100|ユーザーのコンピューターは、システム要件を満たしていません。|  
+  
+#### ダウンロードのエラー コード  
+ 次の MSDN ライブラリのコンテンツを参照してください。  
+  
+-   [Background Intelligent Transfer Service \(BITS\) のエラー コード](http://go.microsoft.com/fwlink/?LinkId=180946)  
+  
+-   [URL モニカーのエラー コード](http://go.microsoft.com/fwlink/?LinkId=180947)  
+  
+-   [WinHttp エラー コード](http://go.microsoft.com/fwlink/?LinkId=180948)  
+  
+#### その他のエラー コード  
+ 次の MSDN ライブラリのコンテンツを参照してください。  
+  
+-   [Windows インストーラーのエラー コード](http://go.microsoft.com/fwlink/?LinkId=180949)  
+  
+-   [Windows Update エージェントの結果コード](http://go.microsoft.com/fwlink/?LinkId=180951)  
+  
+<a name="uninstalling_net_framework"></a>   
+## .NET Framework のアンインストール  
+ [!INCLUDE[win8](../../../includes/win8-md.md)] 以降では、コントロール パネルの **\[Windows の機能の有効化または無効化\]** を使用して [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、4.6.1、4.6.2 をアンインストールできます。 Windows の旧バージョンでは、コントロール パネルの **\[プログラムの追加と削除\]** を使用して [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、4.6.1、4.6.2 をアンインストールできます。  
+  
+> [!IMPORTANT]
+>  Windows 7 以前のオペレーティング システムでは、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]、4.5.2、4.6、4.6.1、4.6.2 をアンインストールしても [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] ファイルは復元されず、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] をアンインストールしても [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] ファイルは復元されません。 旧バージョンに戻る場合は、更新プログラムと共に再インストールする必要があります。  
+  
+## 付録  
+  
+<a name="command_line_options"></a>   
+### コマンド ライン オプション  
+ 次の表は、アプリケーションのセットアップに [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の再頒布可能パッケージをチェーンするときに指定できるオプションを示しています。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/CEIPConsent**|既定の動作を上書きし、今後の配置操作を改良するための匿名のフィードバックを Microsoft に送信します。 このオプションは、セットアップ プログラムで同意メッセージが表示され、ユーザーが匿名のフィードバックを Microsoft に送信することを許可した場合のみ使用できます。|  
+|**\/chainingpackage** `packageName`|チェーンを行っている実行可能ファイルの名前を指定します。 この情報は、今後の配置操作を改良するための匿名のフィードバックとして Microsoft に送信されます。<br /><br /> パッケージ名にスペースが含まれている場合は、区切り記号として二重引用符を使用します \(例: **\/chainingpackage "Lucerne Publishing"**\)。 チェーン パッケージの例については、MSDN ライブラリの「[インストール パッケージからの進行状況に関する情報の取得](http://go.microsoft.com/fwlink/?LinkId=181926)」をご覧ください。|  
+|**\/LCID**  `LCID`<br /><br /> `LCID` はロケール識別子を指定します \(「[サポートされる言語](#supported_languages)」を参照してください\)。|`LCID` によって指定された言語パックをインストールし、クワイエット モードが設定されていない限り表示される UI をその言語で表示します。<br /><br /> Web インストーラーでは、このオプションは、Web から言語パッケージをチェーンしてインストールします。 **Note:**  このオプションは Web インストーラーだけに使用します。|  
+|**\/log** `file` &#124; `folder`|ログ ファイルの場所を指定します。 既定ではプロセスの一時フォルダーになっており、既定のファイル名はパッケージに基づきます。 ファイル拡張子が .txt の場合、テキスト ログが生成されます。 他の拡張子を指定するか、拡張子がないと、HTML ログが作成されます。|  
+|**\/msioptions**|.msi と .msp の項目に渡されるオプションを指定します。例: `/msioptions "PROPERTY1='Value'"`|  
+|**\/norestart**|セットアップ プログラムが自動的に再起動しないようにします。 このオプションを使用する場合、チェーン アプリがリターン コードをキャプチャし、再起動を処理する必要があります \(MSDN ライブラリの「[インストール パッケージからの進行状況に関する情報の取得](http://go.microsoft.com/fwlink/?LinkId=179606)」をご覧ください\)。|  
+|**\/passive**|受動モードを設定します。 インストールが進行中であることを示す進行状況バーを表示しますが、ユーザーに対してプロンプトやエラー メッセージは表示しません。 このモードでは、セットアップ プログラムによってチェーンされたときに、チェーン パッケージが[リターン コード](#return_codes)を処理する必要があります。|  
+|**\/pipe**|チェーン パッケージが進行状況を取得できるように通信チャネルを作成します。|  
+|**\/promptrestart**|受動モードのみ、セットアップ プログラムの再起動が必要な場合は、ユーザーに対してメッセージが表示されます。 このオプションでは、再起動が必要な場合はユーザーの操作を必要とします。|  
+|**\/q**|クワイエット モードを設定します。|  
+|**\/repair**|修復機能をトリガーします。|  
+|**\/serialdownload**|パッケージをダウンロードした後にのみインストールを強制します。|  
+|**\/showfinalerror**|受動モードを設定します。 インストールが失敗した場合にのみ、エラーを表示します。 このオプションは、インストールが失敗した場合はユーザーの操作を必要とします。|  
+|**\/showrmui**|**\/passive** オプションでのみ使用します。 ユーザーに、現在実行されている .NET Framework アプリケーションを閉じるように求めるメッセージ ボックスを表示します。 このメッセージ ボックスの動作は受動モードでも非受動モードでも同じです。|  
+|**\/uninstall**|.NET Framework 再頒布可能パッケージのアンインストール|  
+  
+<a name="supported_languages"></a>   
+### サポートされる言語  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリースで使用可能な .NET Framework 言語パックを次の表に示します。  
+  
+|LCID|言語 \- 国\/地域|カルチャ|  
+|----------|-----------------|----------|  
+|1025|アラビア語 \- サウジアラビア|ar|  
+|1028|中国語 \- 繁体字|zh\-Hant|  
+|1029|チェコ語|cs|  
+|1030|デンマーク語|da|  
+|1031|ドイツ語 – ドイツ|de|  
+|1032|ギリシャ語|el|  
+|1035|フィンランド語|fi|  
+|1036|フランス語 \- フランス|fr|  
+|1037|ヘブライ語|he|  
+|1038|ハンガリー語|hu|  
+|1040|イタリア語 \- イタリア|it|  
+|1041|日本語|ja|  
+|1042|韓国語|ko|  
+|1043|オランダ語 \- オランダ|nl|  
+|1044|ノルウェー語 \- ブークモール|no|  
+|1045|ポーランド語|pl|  
+|1046|ポルトガル語 \- ブラジル|pt\-BR|  
+|1049|ロシア語|ru|  
+|1053|スウェーデン語|sv|  
+|1055|トルコ語|tr|  
+|2052|中国語 \- 簡体字|zh\-Hans|  
+|2070|ポルトガル語 \- ポルトガル|pt\-PT|  
+|3082|スペイン語 \(スペイン、モダン ソート\)|es|  
+  
+## 参照  
+ [配置ガイド \(管理者向け\)](../../../docs/framework/deployment/guide-for-administrators.md)   
+ [システム要件](../../../docs/framework/get-started/system-requirements.md)   
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)   
+ [トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)   
+ [.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)   
+ [方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/guide-for-administrators.md b/docs/framework/deployment/guide-for-administrators.md
new file mode 100644
index 00000000000..13f61952875
--- /dev/null
+++ b/docs/framework/deployment/guide-for-administrators.md
@@ -0,0 +1,273 @@
+---
+title: ".NET Framework 配置ガイド (管理者向け) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "管理者ガイド, 配置 (.NET Framework を)"
+  - "配置 [.NET Framework], 管理者ガイド"
+ms.assetid: bee14036-0436-44e8-89f5-4bc61317977a
+caps.latest.revision: 40
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 38
+---
+# .NET Framework 配置ガイド (管理者向け)
+この記事では、システム管理者が Microsoft System Center Configuration Manager を使用して [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのシステムの依存関係をネットワーク経由で配置する方法を手順に沿って説明します。  ここでは、すべての対象のクライアント コンピューターが .NET Framework の最小要件を満たしていることを前提としています。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のインストールに必要なソフトウェア要件とハードウェア要件の一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、System Center Configuration Manager、Active Directory など、このドキュメントで言及されるソフトウェアには、ライセンス条項が適用されます。  このドキュメントの内容は、ライセンス条項がソフトウェアの適切なライセンス取得者によって確認され、同意されていることを前提にしています  記載の内容についても、ライセンス条項は効力があるものとします。  
+>   
+>  .NET Framework のサポートの詳細については、Microsoft サポート Web サイトの「[Microsoft .NET Framework のサポート ライフサイクル ポリシー](http://go.microsoft.com/fwlink/?LinkId=196607)」を参照してください。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+ [配置プロセス](#the_deployment_process)   
+ [.NET Framework の配置](#deploying_in_a_test_environment)  
+ [コレクションの作成](#creating_a_collection)  
+ [パッケージとプログラムの作成](#creating_a_package)  
+ [配布ポイントの選択](#select_dist_point)  
+ [パッケージの配置](#deploying_package)  
+ [リソース](#resources)  
+ [トラブルシューティング](#troubleshooting)  
+  
+<a name="the_deployment_process"></a>   
+## 配置プロセス  
+ サポートするインフラストラクチャが整っている場合は、System Center 2012 Configuration Manager を使用して、.NET Framework 再頒布可能パッケージをネットワーク上のコンピューターに配置します。  インフラストラクチャを構築するには、コレクション、ソフトウェアのパッケージとプログラム、配布ポイント、配置という 5 つの主要な項目を作成し定義する必要があります。  
+  
+-   **コレクション**は、ユーザー、ユーザー グループ、コンピューターなど、.NET Framework の配置先となる Configuration Manager リソースのグループです。  詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager のコレクション](http://technet.microsoft.com/library/gg682169.aspx)」を参照してください。  
+  
+-   **パッケージとプログラム**は、通常、クライアント コンピューターにインストールされるソフトウェア アプリケーションを表しますが、個々のファイル、更新プログラム、さらには個々のコマンドが含まれることがあります。  詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager のパッケージとプログラム](http://technet.microsoft.com/library/gg699369.aspx)」を参照してください。  
+  
+-   **配布ポイント**は、ソフトウェアをクライアント コンピューター上で実行するために必要なファイルを格納する Configuration Manager のサイト システムの役割です。  Configuration Manager クライアントは、ソフトウェア配置を受け取って処理するときに、配布ポイントに接続してソフトウェアに関連するコンテンツをダウンロードし、インストール処理を開始します。  詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager のコンテンツ管理の概要](http://technet.microsoft.com/library/gg682083.aspx)」を参照してください。  
+  
+-   **配置**は、指定されたターゲット コレクションの該当するメンバーにソフトウェア パッケージをインストールするよう指示します。  詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager でのアプリケーションの展開方法](http://technet.microsoft.com/library/gg682082.aspx)」を参照してください。  
+  
+> [!IMPORTANT]
+>  このトピックの手順では、パッケージとプログラムを作成するための一般的な設定を使用していて、すべての可能な設定について説明していない場合があります。  その他の Configuration Manager 展開オプションについては、[Configuration Manager のドキュメント ライブラリ](http://technet.microsoft.com/library/gg682041.aspx)を参照してください。  
+  
+<a name="deploying_in_a_test_environment"></a>   
+## .NET Framework の配置  
+ System Center 2012 を使用して、インストール処理時にユーザーが操作しない [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のサイレント インストールを配置できます。  この場合は、以下の手順に従ってください。  
+  
+1.  [コレクションの作成](#creating_a_collection)  
+  
+2.  [.NET Framework 再頒布可能パッケージとプログラムの作成](#creating_a_package)  
+  
+3.  [配布ポイントの選択](#select_dist_point)  
+  
+4.  [パッケージの配置](#deploying_package)  
+  
+<a name="creating_a_collection"></a>   
+### コレクションの作成  
+ この手順では、パッケージとプログラムを配置するコンピューターを選択し、それをデバイス コレクションにグループ化します。  Configuration Manager でコレクションを作成するときは、ダイレクト メンバーシップ規則 \(コレクション メンバーを手動で指定\) またはクエリ規則 \(指定した条件に基づいて Configuration Manager がコレクション メンバーを決定\) を使用できます。  メンバーシップ規則 \(クエリ規則とダイレクト規則も含む\) の詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager のコレクションの概要](http://technet.microsoft.com/library/gg682177.aspx)」を参照してください。  
+  
+ コレクションを作成するには  
+  
+1.  Configuration Manager コンソールで、**\[資産とコンプライアンス\]** をクリックします。  
+  
+2.  **\[資産とコンプライアンス\]** ワークスペースで、**\[デバイス コレクション\]** をクリックします。  
+  
+3.  **\[ホーム\]** タブの **\[作成\]** グループで、**\[デバイス コレクションの作成\]** をクリックします。  
+  
+4.  **デバイス コレクションの作成ウィザード**の **\[全般\]** ページで、コレクションの名前を入力します。  
+  
+5.  **\[参照\]** をクリックして、限定するコレクションを指定します。  
+  
+6.  **\[メンバーシップの規則\]** ページで、**\[規則の追加\]** をクリックし、**\[ダイレクト規則\]** をクリックして**ダイレクト メンバーシップの規則の作成ウィザード**を開きます。  **\[次へ\]** をクリックします。  
+  
+7.  **\[リソースの検索\]** ページで、**\[リソース クラス\]** ボックスの一覧の **\[システム リソース\]** をクリックします。  **\[属性名\]** ボックスの一覧の **\[名前\]** をクリックします。  **\[値\]** フィールドに「`%`」と入力し、**\[次へ\]** をクリックします。  
+  
+8.  **\[リソースの選択\]** ページで、.NET Framework を配置する各コンピューターのチェック ボックスをオンにします。  **\[次へ\]** をクリックして、ウィザードの操作を完了します。  
+  
+9. **デバイス コレクションの作成ウィザード**の **\[メンバーシップの規則\]** ページで、**\[次へ\]** をクリックし、ウィザードの処理を完了します。  
+  
+ 詳細については、Configuration Manager ドキュメント ライブラリの「[Configuration Manager のコレクション](http://technet.microsoft.com/library/bb693730.aspx)」を参照してください。  
+  
+<a name="creating_a_package"></a>   
+### .NET Framework 再頒布可能パッケージとプログラムの作成  
+ 次の手順では、.NET Framework 再頒布可能パッケージを手動で作成します。  パッケージには、.NET Framework をインストールするためのパラメーター、およびターゲット コンピューターへのパッケージの配布元となる場所が含まれます。  
+  
+ パッケージを作成するには  
+  
+1.  Configuration Manager コンソールで、**\[ソフトウェア ライブラリ\]** をクリックします。  
+  
+2.  **\[ソフトウェア ライブラリ\]** ワークスペースで、**\[アプリケーション管理\]** を展開し、**\[パッケージ\]** をクリックします。  
+  
+3.  **\[ホーム\]** タブの **\[作成\]** グループで、**\[パッケージの作成\]** をクリックします。  
+  
+4.  **パッケージとプログラムの作成ウィザード**の **\[パッケージ\]** ページで、次の情報を入力します。  
+  
+    -   名前: `.NET Framework 4.5`  
+  
+    -   製造元: `Microsoft`  
+  
+    -   言語:   `English (US)`  
+  
+5.  **\[このパッケージにソース ファイルを含める\]** チェック ボックスをオンにし、**\[参照\]** をクリックして .NET Framework のインストール ファイルを含むローカルまたはネットワーク フォルダーを選択します。  フォルダーを選択したら、**\[OK\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+6.  ウィザードの **\[プログラミングの種類\]** ページで、**\[標準プログラム\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+7.  **パッケージとプログラムの作成ウィザード**の **\[プログラム\]** ページで、次の情報を入力します。  
+  
+    1.  **名前:** `.NET Framework 4.5`  
+  
+    2.  **コマンド ライン:** `dotNetFx45_Full_x86_x64.exe /q /norestart /ChainingPackage ADMINDEPLOYMENT` \(コマンド ライン オプションは、手順の後の表で説明されている\)  
+  
+    3.  **実行:** **\[非表示\]** をクリックします。  
+  
+    4.  **プログラムの実行条件:** ユーザーがログオンしているかどうかに関係なく、プログラムを実行できることを指定するオプションを選択します。  
+  
+8.  **\[要件\]** ページで、**\[次へ\]** をクリックして既定値を受け入れ、ウィザードの処理を完了します。  
+  
+ 次の表は、手順 7. で指定したコマンド ライン オプションについて説明しています。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/q**|クワイエット モードを設定します。  ユーザー入力は必要なく、出力は表示されません。|  
+|**\/norestart**|セットアップ プログラムが自動的に再起動しないようにします。  このオプションを使用する場合、Configuration Manager でコンピューターの再起動を処理する必要があります。|  
+|**\/chainingpackage** *PackageName*|チェーンを行っているパッケージの名前を指定します。  この情報は、[Microsoft カスタマー エクスペリエンス向上プログラム \(CEIP\)](http://go.microsoft.com/fwlink/p/?LinkId=248244) に登録したユーザーに対し、他のインストール セッションの情報と共に報告されます。  パッケージ名にスペースが含まれている場合は、区切り記号として二重引用符を使用します \(例: **\/chainingpackage "Chaining Product"**\)。|  
+  
+ これらの手順によって、.NET Framework 4.5 という名前のパッケージが作成されます。  プログラムは、.NET Framework 4.5 のサイレント インストールを配置します。  サイレント インストールでは、ユーザーはインストール プロセスと対話しないので、チェーン アプリケーションがリターン コードをキャプチャし、再起動を処理する必要があります。MSDN ライブラリの「[Getting Progress Information from an Installation Package \(インストール パッケージからの進行状況に関する情報の取得\)](http://go.microsoft.com/fwlink/?LinkId=179606)」を参照してください。  
+  
+<a name="select_dist_point"></a>   
+### 配布ポイントの選択  
+ サーバーからクライアント コンピューターにパッケージとプログラムを配布するには、まずサイト システムを配布ポイントとして指定し、次にパッケージを配布ポイントに配布する必要があります。  
+  
+ 以下の手順を使用して、前のセクションで作成した .NET Framework 4.5 パッケージの配布ポイントを選択します。  
+  
+1.  Configuration Manager コンソールで、**\[ソフトウェア ライブラリ\]** をクリックします。  
+  
+2.  **\[ソフトウェア ライブラリ\]** ワークスペースで、**\[アプリケーション管理\]** を展開し、**\[パッケージ\]** をクリックします。  
+  
+3.  パッケージの一覧で、前のセクションで作成したパッケージ **\[.NET Framework 4.5\]** を選択します。  
+  
+4.  **\[ホーム\]** タブの **\[展開\]** グループで、**\[コンテンツの配布\]** をクリックします。  
+  
+5.  **コンテンツの配布ウィザード**の **\[全般\]** タブで、**\[次へ\]** をクリックします。  
+  
+6.  ウィザードの **\[コンテンツの配布先\]** ページで、**\[追加\]** をクリックし、**\[配布ポイント\]** をクリックします。  
+  
+7.  **\[配布ポイントの追加\]** ダイアログ ボックスで、パッケージとプログラムをホストする配布ポイントを選択し、**\[OK\]** をクリックします。  
+  
+8.  ウィザードの指示に従います。  
+  
+ これでパッケージには、.NET Framework 4.5 をサイレントで配置するために必要なすべての情報が含まれています。  パッケージとプログラムを配置する前に、そのパッケージが配布ポイントにインストールされていることを確認します。Configuration Manager ドキュメント ライブラリの「[Configuration Manager のコンテンツ管理の操作とメンテナンス](http://technet.microsoft.com/library/gg712694.aspx#BKMK_MonitorContent)」の「コンテンツの監視」セクションを参照してください。  
+  
+<a name="deploying_package"></a>   
+### パッケージの配置  
+ .NET Framework 4.5 パッケージとプログラムを配置するには  
+  
+1.  Configuration Manager コンソールで、**\[ソフトウェア ライブラリ\]** をクリックします。  
+  
+2.  **\[ソフトウェア ライブラリ\]** ワークスペースで、**\[アプリケーション管理\]** を展開し、**\[パッケージ\]** をクリックします。  
+  
+3.  パッケージの一覧で、作成したパッケージ **\[.NET Framework 4.5\]** を選択します。  
+  
+4.  **\[ホーム\]** タブの **\[展開\]** グループで、**\[展開\]** をクリックします。  
+  
+5.  **ソフトウェアの展開ウィザード**の **\[全般\]** ページで、**\[参照\]** をクリックし、前に作成したコレクションを選択します。  **\[次へ\]** をクリックします。  
+  
+6.  ウィザードの **\[コンテンツ\]** ページで、ソフトウェアを配布するポイントが表示されていることを確認し、**\[次へ\]** をクリックします。  
+  
+7.  ウィザードの **\[展開設定\]** ページで、**\[操作\]** が **\[インストール\]** に設定され、**\[目的\]** が **\[必須\]** に設定されていることを確認します。  これにより、ソフトウェア パッケージがターゲット コンピューターに対する必須インストールになることが保証されます。  **\[次へ\]** をクリックします。  
+  
+8.  ウィザードの **\[スケジュール\]** ページで、.NET Framework をインストールする時期を指定します。  **\[新規\]** をクリックしてインストール時期を指定することも、ユーザーがログオンまたはログオフしたとき、またはできるだけ早い時期にインストールすることもできます。  **\[次へ\]** をクリックします。  
+  
+9. ウィザードの **\[ユーザー側の表示と操作\]** ページで、既定値を使用し、**\[次へ\]** をクリックします。  
+  
+    > [!WARNING]
+    >  稼動環境では、配置スケジュールで異なる選択が必要になるポリシーが適用されている場合があります。  これらのオプションについては、TechNet ライブラリの「[\[提供情報の名前のプロパティ］の［スケジュール］タブ](http://technet.microsoft.com/library/bb694016.aspx)」を参照してください。  
+  
+10. ウィザードの **\[配布ポイント\]** ページで、既定値を使用し、**\[次へ\]** をクリックします。  
+  
+11. ウィザードの指示に従います。  **\[監視\]** ワークスペースの **\[展開\]** ノードで配置の進行状況を監視できます。  
+  
+ これで、対象のコレクションにパッケージが配置され、.NET Framework 4.5 のサイレント インストールが開始されます。  .NET Framework 4.5 のインストールのエラー コードについては、このトピックの「[リターン コード](#return_codes)」セクションを参照してください。  
+  
+<a name="resources"></a>   
+## リソース  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 再頒布可能パッケージの配置をテストするためのインフラストラクチャの詳細については、次のリソースを参照してください。  
+  
+ **Active Directory、DNS、DHCP:**  
+  
+-   [Active Directory Domain Services for Windows Server 2008 \(Windows Server 2008 の Active Directory ドメイン サービス\)](http://technet.microsoft.com/library/dd378891.aspx)  
+  
+-   [Windows Server 2008 Step\-by\-Step Guide for DNS in Small Networks \(小規模なネットワークの DNS に関する Windows Server 2008 ステップ バイ ステップ ガイド\)](http://www.microsoft.com/download/details.aspx?id=17157)  
+  
+-   [DNS サーバー](http://technet.microsoft.com/library/cc732997.aspx)  
+  
+-   [DHCP サーバー](http://technet.microsoft.com/library/cc896553.aspx)  
+  
+ **SQL Server 2008:**  
+  
+-   [SQL Server 2008 のインストール \(SQL Server ビデオ\)](http://technet.microsoft.com/library/dd299415.aspx)  
+  
+-   [SQL Server 2008 Security Overview for Database Administrators \(SQL Server 2008 のデータベース管理者向けセキュリティ概要\)](http://download.microsoft.com/download/a/c/d/acd8e043-d69b-4f09-bc9e-4168b65aaa71/SQL2008SecurityOverviewforAdmins.docx)  
+  
+ **System Center 2012 Configuration Manager \(管理ポイント、配布ポイント\):**  
+  
+-   [System Center 2012 Configuration Manager のサイト管理](http://technet.microsoft.com/library/gg681983.aspx)  
+  
+-   [Configuration Manager の単一サイトの計画と展開](http://technet.microsoft.com/library/bb680961.aspx)  
+  
+ **Windows コンピューター用の System Center 2012 Configuration Manager クライアント:**  
+  
+-   [System Center 2012 Configuration Manager のクライアントの展開](http://technet.microsoft.com/library/gg699391.aspx)  
+  
+<a name="troubleshooting"></a>   
+## トラブルシューティング  
+  
+### ログ ファイルの場所  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のセットアップ中に次のログ ファイルが作成されます。  
+  
+ %temp%\\Microsoft .NET Framework 4.5\*.txt                                 
+ %temp%\\Microsoft .NET Framework 4.5\*.html  
+  
+ [ログ収集ツール](http://www.microsoft.com/download/details.aspx?id=12493)を使用して [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のログ ファイルを収集し、それらのファイルのサイズを縮小した圧縮キャビネット \(.cab\) ファイルを作成できます。  
+  
+<a name="return_codes"></a>   
+### リターン コード  
+ 次の表は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の再頒布可能インストール プログラムから返される最も一般的なリターン コードを示しています。  これらのリターン コードは、すべてのバージョンのインストーラーで共通です。  
+  
+ 詳細情報へのリンクについては、次の「[ダウンロードのエラー コード](#additional_error_codes)」セクションを参照してください。  
+  
+|リターン コード|説明|  
+|--------------|--------|  
+|0|インストールは正常に終了しました。|  
+|1602|ユーザーがインストールをキャンセルしました。|  
+|1603|インストール中に致命的なエラーが発生しました。|  
+|1641|インストールを完了するには再起動する必要があります。  このメッセージが表示された場合、操作は成功しました。|  
+|3010|インストールを完了するには再起動する必要があります。  このメッセージが表示された場合、操作は成功しました。|  
+|5100|ユーザーのコンピューターは、システム要件を満たしていません。|  
+  
+<a name="additional_error_codes"></a>   
+### ダウンロードのエラー コード  
+  
+-   [Background Intelligent Transfer Service \(BITS\) error codes \(Background Intelligent Transfer Service \(BITS\) のエラー コード\)](http://msdn.microsoft.com/library/aa362823.aspx)  
+  
+-   [URL moniker error codes \(URL モニカーのエラー コード\)](http://msdn.microsoft.com/library/ms775145.aspx)  
+  
+-   [WinHttp error codes \(WinHttp のエラー コード\)](http://msdn.microsoft.com/library/aa383770.aspx)  
+  
+ その他のエラー コード:  
+  
+-   [Windows Installer error codes \(Windows インストーラーのエラー コード\)](http://msdn.microsoft.com/library/aa368542.aspx)  
+  
+-   [Windows Update Agent result codes \(Windows Update エージェントの結果コード\)](http://technet.microsoft.com/library/cc720442.aspx)  
+  
+## 参照  
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)   
+ [システム要件](../../../docs/framework/get-started/system-requirements.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/guidelines-for-creating-components-for-side-by-side-execution.md b/docs/framework/deployment/guidelines-for-creating-components-for-side-by-side-execution.md
new file mode 100644
index 00000000000..3a342dbc27e
--- /dev/null
+++ b/docs/framework/deployment/guidelines-for-creating-components-for-side-by-side-execution.md
@@ -0,0 +1,77 @@
+---
+title: "side-by-side 実行用のコンポーネントを作成するためのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "side-by-side 実行, 複数のアプリケーションのバージョン"
+  - "side-by-side 実行, 複数のコンポーネントのバージョン"
+ms.assetid: 5c540161-6e40-42e9-be92-6175aee2c46a
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# side-by-side 実行用のコンポーネントを作成するためのガイドライン
+side\-by\-side 実行用にデザインしたマネージ アプリケーションまたはマネージ コンポーネントを作成するときのガイドラインを次に示します。  
+  
+-   型 ID をファイルの特定のバージョンにバインドします。  
+  
+     共通言語ランタイムは、厳密な名前付きのアセンブリを使用して、型 ID を特定のファイル バージョンにバインドします。  side\-by\-side 実行用のアプリケーションまたはコンポーネントを作成するには、すべてのアセンブリに厳密な名前を付ける必要があります。  これによって精密な型 ID が作成され、どのような型解決でも正しいファイルに接続されます。  厳密な名前付きのアセンブリには、バージョン、カルチャ、および発行元情報が含まれていて、ランタイムはこれを使用して、バインド要求を実行するために正しいファイルを検索します。  
+  
+-   バージョンを認識するストレージを使用します。  
+  
+     ランタイムは、グローバル アセンブリ キャッシュを使用して、バージョンを認識するストレージを提供します。  グローバル アセンブリ キャッシュはバージョンを認識するディレクトリ構造で、.NET Framework を使用するどのコンピューターにもインストールされています。  グローバル アセンブリ キャッシュにインストールされているアセンブリは、そのアセンブリの新しいバージョンがインストールされても、上書きされません。  
+  
+-   分離して実行されるアプリケーションまたはコンポーネントを作成します。  
+  
+     分離して実行されるアプリケーションまたはコンポーネントは、それらのアプリケーションまたはコンポーネントの 2 つのインスタンスが同時に実行されるときの競合を避けるために、リソースを管理する必要があります。  また、アプリケーションまたはコンポーネントは、バージョン固有のファイル構造を使用する必要があります。  
+  
+## アプリケーションとコンポーネントの分離  
+ side\-by\-side 実行用のアプリケーションまたはコンポーネントのデザインを成功させる鍵の 1 つとして、分離が挙げられます。  アプリケーションまたはコンポーネントは、特にファイル I\/O をはじめとするすべてのリソースを、分離された方法で管理する必要があります。  アプリケーションまたはコンポーネントを、確実に分離して実行するには、次のガイドラインに従ってください。  
+  
+-   バージョン固有の方法でレジストリに書き込みます。  バージョンを示したハイブまたはキーに値を格納し、コンポーネントのバージョンをまたいで情報や状態を共有しないようにします。  これにより、同時に実行されている 2 つのアプリケーションまたはコンポーネントが情報を上書きしてしまうことを防げます。  
+  
+-   競合状態が発生しないように、名前付きカーネル オブジェクトをバージョン固有にします。  たとえば、同じアプリケーションの 2 つのバージョンから生成された 2 つのセマフォが相互に待機すると、競合状態が発生します。  
+  
+-   ファイル名とディレクトリ名でバージョンを認識できるようにします。  これは、ファイル構造がバージョン情報に依存することを意味します。  
+  
+-   ユーザー アカウントとグループをバージョン固有の方法で作成します。  アプリケーションによって作成されるユーザー アカウントとグループを、バージョンで識別できるようにする必要があります。  アプリケーションのバージョン間で、ユーザー アカウントとグループを共有しないでください。  
+  
+## バージョンのインストールとアンインストール  
+ side\-by\-side 用のアプリケーションをデザインするときは、バージョンのインストールとアンインストールに関する次のガイドラインに従ってください。  
+  
+-   .NET Framework の異なるバージョンで実行されている他のアプリケーションによって必要になる可能性のある情報をレジストリから削除しないでください。  
+  
+-   .NET Framework の異なるバージョンで実行されている他のアプリケーションによって必要になる可能性のある情報をレジストリ内で置き換えないでください。  
+  
+-   .NET Framework の異なるバージョンで実行されている他のアプリケーションによって必要になる可能性のある COM コンポーネントの登録を解除しないでください。  
+  
+-   既に登録されている COM サーバー用の **InprocServer32** または他のレジストリ エントリを変更しないでください。  
+  
+-   .NET Framework の異なるバージョンで実行されている他のアプリケーションによって必要になる可能性のあるユーザー アカウントまたはグループを削除しないでください。  
+  
+-   バージョン管理されていないパスを含むレジストリには何も追加しないでください。  
+  
+## ファイルのバージョン番号とアセンブリのバージョン番号  
+ ファイルのバージョンは Win32 バージョン リソースであり、ランタイムでは使用されません。  一般に、インプレース更新の場合であっても、ファイルのバージョンを更新してください。  まったく同じ 2 つのファイルが異なるファイル バージョン情報を持つことや、2 つの異なるファイルが同じファイル バージョン情報を持つことがあります。  
+  
+ アセンブリのバージョンは、アセンブリ バインディングのためにランタイムによって使用されます。  2 つの同一のアセンブリであっても、バージョン番号が異なると、ランタイムによって 2 つの異なるアセンブリとして扱われます。  
+  
+ [グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) では、ファイルのバージョン番号が新しい場合にのみ、アセンブリを置換できます。  一般的に、インストーラーは、アセンブリのバージョン番号が大きくない限り、アセンブリを上書きでインストールしません。  
+  
+## 参照  
+ [side\-by\-side 実行](../../../docs/framework/deployment/side-by-side-execution.md)   
+ [方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/how-the-runtime-locates-assemblies.md b/docs/framework/deployment/how-the-runtime-locates-assemblies.md
new file mode 100644
index 00000000000..e4725dff5ee
--- /dev/null
+++ b/docs/framework/deployment/how-the-runtime-locates-assemblies.md
@@ -0,0 +1,239 @@
+---
+title: "ランタイムがアセンブリを検索する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーションの配置, 検索 (アセンブリを)"
+  - "app.config ファイル, アセンブリの場所"
+  - "アプリケーション構成ファイル, 検索 (アセンブリを)"
+  - "アセンブリ [.NET Framework], 位置"
+  - "配置 (アプリケーションを) [.NET Framework] , アセンブリの場所"
+  - "検索 (アセンブリを)"
+ms.assetid: 772ac6f4-64d2-4cfb-92fd-58096dcd6c34
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# ランタイムがアセンブリを検索する方法
+.NET Framework アプリケーションを正しく配置するには、アプリケーションを構成するアセンブリを共通言語ランタイムがどのように検索し、バインドするかを理解している必要があります。 既定では、ランタイムはアプリケーションを構成するアセンブリの正しいバージョンをバインドしようとします。 この既定の動作は、構成ファイルの設定によってオーバーライドできます。  
+  
+ 共通言語ランタイムは、アセンブリを検索し、アセンブリの参照を解決しようとするときにいくつかの手順を実行します。 それぞれの手順については、後続のセクションで説明します。 ランタイムがアセンブリを検索する方法の説明では、「プローブ」という用語が頻繁に使用されます。プローブとは、アセンブリの名前およびカルチャに基づいてアセンブリを特定するための一連のヒューリスティックです。  
+  
+> [!NOTE]
+>  [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に含まれている[アセンブリ バインディング ログ ビューアー \(Fuslogvw.exe\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) を使用すると、ログ ファイル内のバインディング情報を表示できます。  
+  
+## バインドの開始  
+ アセンブリを検索し、バインドするプロセスは、ランタイムが別のアセンブリへの参照を解決しようとしたときに開始します。 この参照は、静的参照または動的参照のいずれかです。 コンパイラは、ビルド時に静的参照をアセンブリ マニフェストのメタデータに記録します。 動的参照は、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> など、各種のメソッド呼び出しの結果として実行時に生成されます。  
+  
+ お勧めするアセンブリの参照方法は、アセンブリ名、バージョン、カルチャ、および公開キー トークン \(存在する場合\) を含む完全参照を使用することです。 ランタイムはこれらの情報を使用して、このセクションで後述する手順に従ってアセンブリを検索します。 静的アセンブリまたは動的アセンブリのいずれかへの参照に関係なく、ランタイムは同じ解決プロセスを使用します。  
+  
+ アセンブリ名だけを指定するなど、アセンブリについての情報の一部だけを指定した呼び出しメソッドを提供することで、アセンブリを動的に参照することもできます。 その場合は、アセンブリの検索はアプリケーション ディレクトリ内だけでなされ、その他のチェックは実行されません。<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> や <xref:System.AppDomain.Load%2A?displayProperty=fullName> などのアセンブリの読み込み用のさまざまなメソッドを使用した部分参照を作成します。  
+  
+ 最後に、[System.Reflection.Assembly.Load](https://msdn.microsoft.com/en-us/library/system.reflection.assembly.load.aspx) などのメソッドを使用して動的参照を作成し、情報の一部だけを提供できます。その後で、アプリケーション構成ファイル内の [\<qualifyAssembly\>](../../../docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md) 要素を使用してその参照を修飾します。 この要素を使用すると、完全な参照情報 \(名前、バージョン、カルチャ、および適用可能な場合は公開キー トークン\) をコード内ではなく、アプリケーション構成ファイル内に提供できます。 アプリケーション ディレクトリ外部のアセンブリへの参照を完全に限定する必要がある場合、またはグローバル アセンブリ キャッシュ内のアセンブリを参照するが、完全参照をコード内ではなく構成ファイル内に指定する方が便利な場合は、この手法を使用します。  
+  
+> [!NOTE]
+>  このタイプの部分参照は、複数のアプリケーションで共有されるアセンブリに対しては使用しないでください。 構成設定はアセンブリ別ではなくアプリケーション別に適用されるため、このタイプの部分参照を使用する共有アセンブリについては、その共有アセンブリを使用するアプリケーションごとに、そのアプリケーションの構成ファイル内に限定情報を含める必要があります。  
+  
+ ランタイムは、次の手順を使用することによってアセンブリ参照を解決します。  
+  
+1.  適用可能な構成ファイル \(アプリケーション構成ファイル、発行者ポリシー ファイル、マシン構成ファイルなど\) をチェックして、[正しいアセンブリ バージョンを決定します。](#step1) 構成ファイルがリモート コンピューターに配置されている場合、ランタイムは最初にアプリケーション構成ファイルを検索し、ダウンロードする必要があります。  
+  
+2.  [以前にアセンブリ名がバインドされているかどうかをチェック](#step2)し、バインドされている場合は、前に読み込んだアセンブリを使用します。 前にアセンブリの読み込み要求が失敗している場合は、アセンブリの読み込みを試みることなく要求が直ちにエラーとなります。  
+  
+    > [!NOTE]
+    >  アセンブリ バインディング エラーのキャッシュは、.NET Framework Version 2.0 で新たに追加されました。  
+  
+3.  [グローバル アセンブリ キャッシュをチェックします](#step3)。 そこにアセンブリが見つかった場合は、ランタイムでそのアセンブリが使用されます。  
+  
+4.  次の手順を使用することによって、[アセンブリのプローブ](#step4)を実行します。  
+  
+    1.  構成と発行者ポリシーが元の参照に影響しない場合およびバインド要求が <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドを使用することによって作成されている場合、ランタイムは位置ヒントをチェックします。  
+  
+    2.  構成ファイル内でコードベースが見つかった場合、ランタイムはその場所だけをチェックします。 このプローブが失敗した場合、ランタイムはバインド要求が失敗したと判断し、それ以上のプローブは実行しません。  
+  
+    3.  「[手順 4: コードベースまたはプローブによるアセンブリの検索](#step4)」で説明するヒューリスティックを使用してアセンブリをプローブします。 プローブしてもアセンブリが見つからなかった場合、ランタイムは Windows Installer に対してアセンブリを提供するように要求します。 これは、オンデマンド インストール機能として実行されます。  
+  
+        > [!NOTE]
+        >  厳密な名前を持たないアセンブリについては、ランタイムはバージョン チェックをしません。また、厳密な名前を持たないアセンブリについては、グローバル アセンブリ キャッシュ内のチェックも実行しません。  
+  
+<a name="step1"></a>   
+## 手順 1: 構成ファイルのチェック  
+ アセンブリ バインディング動作は、次の 3 つの XML ファイルに基づいて、さまざまなレベルで設定できます。  
+  
+-   アプリケーション構成ファイル  
+  
+-   発行者ポリシー ファイル  
+  
+-   マシン構成ファイル  
+  
+ これらのファイルには、特定のアセンブリについて、バインディング リダイレクト、コードの場所、バインディング モードなどの情報が同じ構文で記述されています。 バインディング プロセスをリダイレクトする各構成ファイルは [\<assemblyBinding\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md)を含めることができます。[\<assemblyBinding\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/assemblybinding-element-for-runtime.md)の子要素には [\<dependentAssembly\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md)が含まれます。[\<dependentAssembly\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/dependentassembly-element.md)の子は、[\<assemblyIdentity\> 要素](../Topic/%3CassemblyIdentity%3E%20Element%20\(ClickOnce%20Deployment\).md)、[\<bindingRedirect\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/bindingredirect-element.md)と、[\<codeBase\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md)が含まれます。  
+  
+> [!NOTE]
+>  構成情報は、この 3 つの構成ファイル内に含まれていますが、すべての要素がすべての構成ファイルで有効なわけではありません。 たとえば、バインディング モードやプライベート パス情報は、アプリケーション構成ファイルだけに含めることができます。 各ファイルに含まれる情報の完全な一覧については、「[構成ファイルを使用してアプリを構成する方法](../../../docs/framework/configure-apps/index.md)」を参照してください。  
+  
+### アプリケーション構成ファイル  
+ 最初に、共通言語ランタイムは、アプリケーション構成ファイル内に呼び出し元アセンブリのマニフェストに格納されているバージョン情報をオーバーライドする情報がないかどうかをチェックします。 アプリケーション構成ファイルはアプリケーションと共に配置できますが、アプリケーションの実行にとっては必須ではありません。 通常、このファイルはほとんど瞬時に取得できますが、Internet Explorer Web ベースのシナリオの場合のように、アプリケーション ベースがリモート コンピューターに存在するときは、構成ファイルをダウンロードする必要があります。  
+  
+ クライアント実行可能ファイルの場合、アプリケーション構成ファイルは、アプリケーションの実行可能ファイルと同じディレクトリに配置され、実行可能ファイルと同じ名前に拡張子 .config を付けた基本名が割り当てられます。 たとえば、C:\\Program Files\\Myapp\\Myapp.exe の構成ファイルは、C:\\Program Files\\Myapp\\Myapp.exe.config です。 ブラウザー ベースのシナリオでは、HTML ファイルは明示的に構成ファイルを指すために **\<link\>** 要素を使用する必要があります。  
+  
+ 次のコードは、アプリケーション構成ファイルの簡単な例を示します。 この例では、<xref:System.Diagnostics.TextWriterTraceListener> を <xref:System.Diagnostics.Debug.Listeners%2A> コレクションに追加し、デバッグ情報のファイルへの記録を有効にします。  
+  
+```  
+<configuration> <system.diagnostics> <trace useGlobalLock="false" autoflush="true" indentsize="0"> <listeners> <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" /> </listeners> </trace> </system.diagnostics> </configuration>  
+```  
+  
+### 発行者ポリシー ファイル  
+ 次に、ランタイムは、発行者ポリシー ファイルが存在する場合、このファイルをチェックします。 発行者ポリシー ファイルは、コンポーネントの発行者が共有コンポーネントへの修正または更新として配布します。 それらのファイルには、アセンブリ参照を新しいバージョンに伝える共有コンポーネントの発行者によって発行された互換情報が含まれています。 アプリケーション構成ファイルやマシン構成ファイルとは異なり、発行者ポリシー ファイルは、グローバル アセンブリ キャッシュにインストールする必要のあるその発行者ポリシー ファイルに固有のアセンブリに含める必要があります。  
+  
+ 発行者ポリシーの構成ファイルの例を次に示します。  
+  
+```  
+<configuration> <runtime> <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> <dependentAssembly> <assemblyIdentity name="asm6" publicKeyToken="c0305c36380ba429" /> <bindingRedirect oldVersion="3.0.0.0" newVersion="2.0.0.0"/> </dependentAssembly> </assemblyBinding> </runtime> </configuration>  
+```  
+  
+ アセンブリを作成するには、[Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md) ツールを使用して次のようにコマンドを指定します。  
+  
+```  
+Al.exe /link:asm6.exe.config /out:policy.3.0.asm6.dll /keyfile: compatkey.dat /v:3.0.0.0  
+```  
+  
+ `compatkey.dat` は厳密な名前のキー ファイルです。 このコマンドにより、グローバル アセンブリ キャッシュに配置できる、厳密な名前のアセンブリが作成されます。  
+  
+> [!NOTE]
+>  発行者ポリシーは、同じ共有コンポーネントを使用するすべてのアプリケーションに適用されます。  
+  
+ 発行者ポリシー構成ファイルは、アプリケーションからのバージョン情報 \(つまり、アセンブリ マニフェストまたはアプリケーション構成ファイルからのバージョン情報\) をオーバーライドします。 アプリケーション構成ファイルに、アセンブリ マニフェストに指定されているバージョンをリダイレクトするように指示するステートメントがない場合、発行者ポリシー ファイルは、アセンブリ マニフェストに指定されているバージョンをオーバーライドします。 しかし、アプリケーション構成ファイルにリダイレクト ステートメントがある場合、発行者ポリシーは、マニフェストに指定されているバージョンではなく、アプリケーション構成ファイル内のバージョン情報をオーバーライドします。  
+  
+ 発行者ポリシー ファイルを使用するのは、共有コンポーネントが更新され、そのコンポーネントを使用するすべてのアプリケーションが共有コンポーネントの新しいバージョンを選択する必要がある場合です。 アプリケーション構成ファイルにセーフ モードが適用されていない限り、アプリケーション構成ファイル内の設定は、発行者ポリシー ファイル内の設定によってオーバーライドされます。  
+  
+#### セーフ モード  
+ 通常、発行者ポリシー ファイルは、Service Pack またはプログラム更新の一部として明示的にインストールされます。 アップグレードされた共有コンポーネントに何か問題がある場合は、セーフ モードを使用して発行者ポリシー ファイル内のオーバーライドを無視できます。 セーフ モードは **\<publisherPolicy apply\="yes**&#124;**no"\/\>** 要素によって決まります。この要素は、アプリケーション構成ファイルだけにあります。 この要素は、発行者ポリシーの構成情報をバインディング プロセスから削除するかどうかを指定します。  
+  
+ セーフ モードは、アプリケーション全体に対して設定するか、または選択したアセンブリに対して設定できます。 つまり、アプリケーションを構成するすべてのアセンブリのポリシーをオフに設定するか、または一部のアセンブリについてだけポリシーをオフにし、それ以外はオフにしないように設定できます。 アプリケーションを構成するアセンブリに発行者ポリシーを選択的に適用するには、**\<publisherPolicy apply\=no\/\>** を設定し、\<**dependentAssembly**\> 要素を使用して適用対象のアセンブリを指定します。 アプリケーションを構成するすべてのアセンブリに発行者ポリシーを適用するには、依存アセンブリの場合は、要素なしの **\<publisherPolicy apply\=no\/\>** を設定します。 構成の詳細については、「[構成ファイルを使用してアプリを構成する方法](../../../docs/framework/configure-apps/index.md)」を参照してください。  
+  
+### マシン構成ファイル  
+ 3 番目に、ランタイムはマシン構成ファイルをチェックします。 このファイルは、Machine.config という名前で、ローカル コンピューターの、ランタイムがインストールされているルート ディレクトリの Config サブディレクトリにあります。 管理者は、このマシン構成ファイルを使用して、そのコンピューターに固有のアセンブリ バインディング制限を指定できます。 マシン構成ファイル内の設定は、ほかのすべての構成設定に優先します。ただし、これは、他のすべての構成設定をこのマシン構成ファイルに配置する必要があるという意味ではありません。 管理者ポリシー ファイルによって決定されるバージョンは最終的であり、オーバーライドすることはできません。 Machine.config ファイル内に指定されたオーバーライドは、すべてのアプリケーションに作用します。 構成ファイルの詳細については、「[構成ファイルを使用してアプリを構成する方法](../../../docs/framework/configure-apps/index.md)」を参照してください。  
+  
+<a name="step2"></a>   
+## 手順 2: 前に参照したアセンブリの検索  
+ 要求されたアセンブリが以前の呼び出しでも要求されていた場合、共通言語ランタイムは既に読み込まれているアセンブリを使用します。 アプリケーションを構成するアセンブリの名前付けの場合、これが影響を及ぼすこともあります。 アセンブリの名前付けの詳細については、「[アセンブリ名](../../../docs/framework/app-domains/assembly-names.md)」を参照してください。  
+  
+ アセンブリに対する前の要求が失敗している場合、そのアセンブリに対する後続の要求は、アセンブリの読み込みを試みることなく即座に失敗します。 .NET Framework Version 2.0 からは、アセンブリ バインディング エラーがキャッシュされ、キャッシュされた情報を使用してアセンブリの読み込みを試みるかどうかが判断されるようになりました。  
+  
+> [!NOTE]
+>  バインディング エラーをキャッシュしない .NET Framework Version 1.0 および 1.1 の動作に戻すには、構成ファイルに [\<disableCachingBindingFailures\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/disablecachingbindingfailures-element.md) を追加します。  
+  
+<a name="step3"></a>   
+## 手順 3: グローバル アセンブリ キャッシュのチェック  
+ 厳密な名前の付いたアセンブリの場合、バインディング プロセスは、続いてグローバル アセンブリ キャッシュ内を調べます。 グローバル アセンブリ キャッシュには、コンピューター上の複数のアプリケーションで使用できるアセンブリが格納されています。 グローバル アセンブリ キャッシュに配置するアセンブリには、すべて厳密な名前を付ける必要があります。  
+  
+<a name="step4"></a>   
+## 手順 4 : コードベースまたはプローブによるアセンブリの検索  
+ 共通言語ランタイムは、呼び出し元アセンブリの参照および構成ファイル内の情報を使用して正しいアセンブリ バージョンを決定した後、およびグローバル アセンブリ キャッシュ内をチェック \(厳密な名前が付いたアセンブリの場合だけ\) した後で、アセンブリの検索を試みます。 アセンブリを検索するプロセスは、次のとおりです。  
+  
+1.  [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素は、アプリケーション構成ファイルに格納されている場合、ランタイムはこの要素に指定されている場所を調べます。 一致するアセンブリが見つかった場合は、そのアセンブリが使用され、プローブは実行されません。 指定されている場所でアセンブリが見つからなかった場合、バインド要求は失敗します。  
+  
+2.  次に、ランタイムは、後でこのセクションで指定する規則に従って、参照先アセンブリをプローブします。  
+  
+> [!NOTE]
+>  アセンブリがディレクトリ内に複数バージョンあり、特定バージョンのアセンブリを参照する場合は、[\<probing\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素の `privatePath` 属性ではなく [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素を使用する必要があります。[\<probing\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素を使用すると、ランタイムは、参照されている単純なアセンブリ名に一致するアセンブリを初めて検出した時点で、それが適切な一致かどうかに関係なくプローブを停止します。 適切な一致である場合は、そのアセンブリが使用されます。 適切な一致でない場合、プローブは停止し、バインディングは失敗します。  
+  
+### コードベースによるアセンブリの検索  
+ コードベース情報は、構成ファイルで [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素を使用して指定できます。 コードベースは、ランタイムが参照先アセンブリのプローブを試みる前に、常にチェックされます。 最終バージョンを含む発行者ポリシー ファイルも含まれている場合 [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素を、[\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) の要素が使用されます。 たとえば、アプリケーション構成ファイルに [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素が指定されていて、アプリケーション情報をオーバーライドする発行者ポリシー ファイルにも [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素が指定されている場合、発行者ポリシー ファイルの [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素が使用されます。  
+  
+ 一致が [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素で指定された場所にが見つからなかった場合、バインド要求は失敗し、その後の手順は実行されません。 ランタイムは、アセンブリが呼び出し元アセンブリの検索条件と一致すると判断したときにそのアセンブリを使用します。[\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) の特定の要素に指定されたファイルが読み込まれると、ランタイムは、名前、バージョン、カルチャ、および公開キーが呼び出し元アセンブリの参照と一致するかどうかをチェックします。  
+  
+> [!NOTE]
+>  アプリケーションのルート ディレクトリの外部で参照されているアセンブリは、厳密な名前が付けられていなければならず、グローバル アセンブリ キャッシュにインストールするか、または [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素を使用して指定する必要があります。  
+  
+### プローブによるアセンブリの検索  
+ アプリケーション構成ファイルに [\<codeBase\>](../../../docs/framework/configure-apps/file-schema/runtime/codebase-element.md) 要素がない場合、ランタイムは 4 個の条件を使用してアセンブリをプローブします。  
+  
+-   アプリケーション ベース \(アプリケーションが実行されるルート位置\)。  
+  
+-   カルチャ \(参照先アセンブリのカルチャ属性\)。  
+  
+-   名前 \(参照先アセンブリの名前\)。  
+  
+-   [\<probing\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素の `privatePath` 属性 \(ルート位置の下にあるサブディレクトリのユーザー定義の一覧\)。 この場所は、アプリケーション ドメインの <xref:System.AppDomain.AppendPrivatePath%2A> プロパティを使用して、アプリケーション構成ファイルとマネージ コード内に指定できます。 マネージ コード内に指定した場合は、マネージ コード `privatePath` が先にプローブされ、その後でアプリケーション構成ファイルに指定したパスがプローブされます。  
+  
+#### アプリケーション ベース ディレクトリとカルチャ ディレクトリのプローブ  
+ ランタイムは、常に、アプリケーションのベース \(URL またはコンピューター上のアプリケーションのルート ディレクトリのいずれか\) からプローブを開始します。 アプリケーション ベースで参照先アセンブリが見つからず、カルチャ情報が提供されていない場合、ランタイムはそのアセンブリ名を持つすべてのサブディレクトリ内を検索します。 プローブされるディレクトリは、次のとおりです。  
+  
+ \[application base\] \/ \[assembly name\].dll  
+  
+ \[application base\] \/ \[assembly name\] \/ \[assembly name\].dll  
+  
+ 参照先アセンブリについてのカルチャ情報が指定されている場合は、次のディレクトリだけがプローブされます。  
+  
+ \[application base\] \/ \[culture\] \/ \[assembly name\].dll  
+  
+ \[application base\] \/ \[culture\] \/ \[assembly name\] \/ \[assembly name\].dll  
+  
+#### privatePath 属性を使用したプローブ  
+ 参照アセンブリの名前をカルチャ サブディレクトリとサブディレクトリの他に、ランタイムは、[\<probing\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素の `privatePath` 属性を使用して指定されたディレクトリをプローブします。`privatePath` 属性を使用して指定するディレクトリは、アプリケーションのルート ディレクトリのサブディレクトリである必要があります。 プローブされるディレクトリは、参照先アセンブリ要求にカルチャ情報が含まれているかどうかによって異なります。  
+  
+ ランタイムは、参照されている単純なアセンブリ名に一致するアセンブリを最初に見つけた時点で、それが適切な一致かどうかに関係なく、プローブを停止します。 適切な一致である場合は、そのアセンブリが使用されます。 適切な一致でない場合、プローブは停止し、バインディングは失敗します。  
+  
+ カルチャが含まれている場合は、次のディレクトリがプローブされます。  
+  
+ \[application base\] \/ \[binpath\] \/ \[culture\] \/ \[assembly name\].dll  
+  
+ \[application base\] \/ \[binpath\] \/ \[culture\] \/ \[assembly name\] \/ \[assembly name\].dll  
+  
+ カルチャ情報が含まれていない場合は、次のディレクトリがプローブされます。  
+  
+ \[application base\] \/ \[binpath\] \/ \[assembly name\].dll  
+  
+ \[application base\] \/ \[binpath\] \/ \[assembly name\] \/ \[assembly name\].dll  
+  
+#### プローブの例  
+ 次の情報が指定されています。  
+  
+-   参照先アセンブリの名前: myAssembly  
+  
+-   アプリケーションのルート ディレクトリ: http:\/\/www.code.microsoft.com  
+  
+-   構成ファイルの[\<probing\>](../../../docs/framework/configure-apps/file-schema/runtime/probing-element.md) 要素による指定: bin  
+  
+-   カルチャ: de  
+  
+ ランタイムは、次の URL をプローブします。  
+  
+ http:\/\/www.code.microsoft.com\/de\/myAssembly.dll  
+  
+ http:\/\/www.code.microsoft.com\/de\/myAssembly\/myAssembly.dll  
+  
+ http:\/\/www.code.microsoft.com\/bin\/de\/myAssembly.dll  
+  
+ http:\/\/www.code.microsoft.com\/bin\/de\/myAssembly\/myAssembly.dll  
+  
+##### 同じ名前の複数のアセンブリ  
+ 同じ名前を持つ複数のアセンブリを設定する方法を次の例に示します。  
+  
+```  
+<dependentAssembly> <assemblyIdentity name="Server" publicKeyToken="c0305c36380ba429" /> <codeBase version="1.0.0.0" href="v1/Server.dll"/> <codeBase version="2.0.0.0" href="v2/Server.dll"/> </dependentAssembly>  
+```  
+  
+#### プローブされるその他の場所  
+ 現在のバインディング コンテキストを使用して、アセンブリの場所を特定することもできます。 この方法が最もよく使用されるのは、<xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドが使用されている場合と、COM 相互運用のシナリオの場合です。 アセンブリが <xref:System.Reflection.Assembly.LoadFrom%2A> メソッドを使用して別のアセンブリを参照している場合は、呼び出し元アセンブリの場所が、参照先アセンブリを検索する場所についてのヒントと見なされます。 一致するものが見つかった場合は、そのアセンブリが読み込まれます。 一致するものが見つからない場合は、ランタイムは、その検索セマンティクスを続行した後、Windows Installer に問い合わせて、アセンブリを提供するように求めます。 バインド要求と一致するアセンブリが提供されない場合は、例外がスローされます。 この例外は、型を参照していた場合はマネージ コード内の <xref:System.TypeLoadException> であり、読み込もうとするアセンブリが見つからなかった場合は、<xref:System.IO.FileNotFoundException> です。  
+  
+ たとえば、Assembly1 が Assembly2 を参照し、Assembly1 が http:\/\/www.code.microsoft.com\/utils からダウンロードされていた場合、この場所が、Assembly2.dll を検索する場所についてのヒントと見なされます。 次に、ランタイムは http:\/\/www.code.microsoft.com\/utils\/Assembly2.dll と http:\/\/www.code.microsoft.com\/utils\/Assembly2\/Assembly2.dll のアセンブリをプローブします。 どちらの場所でも Assembly2 が見つからなかった場合は、ランタイムは Windows Installer に問い合わせます。  
+  
+## 参照  
+ [アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)   
+ [配置](../../../docs/framework/deployment/net-framework-and-applications.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/how-to-debug-clr-activation-issues.md b/docs/framework/deployment/how-to-debug-clr-activation-issues.md
new file mode 100644
index 00000000000..8a881071d6f
--- /dev/null
+++ b/docs/framework/deployment/how-to-debug-clr-activation-issues.md
@@ -0,0 +1,136 @@
+---
+title: "方法: CLR のアクティブ化に関する問題をデバッグする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "CLR アクティベーション, デバッグ (問題を)"
+ms.assetid: 4fe17546-d56e-4344-a930-6d8e4a545914
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: CLR のアクティブ化に関する問題をデバッグする
+正しいバージョンの共通言語ランタイム \(CLR\) を使用してアプリケーションを実行したときに問題が発生した場合は、CLR アクティベーション ログを表示してデバッグできます。  これらのログは、アプリケーションが予期していたバージョンとは異なる CLR バージョンを読み込むか、CLR を全く読み込まない場合のアクティベーションの問題の根本原因を突き止める上で非常に役立ちます。  アプリケーションの CLR が見つからない場合については、「[.NET Framework 初期化エラー: ユーザー エクスペリエンスの管理](../../../docs/framework/deployment/initialization-errors-managing-the-user-experience.md)」を参照してください。  
+  
+ CLR アクティベーション ログは、HKEY\_LOCAL\_MACHINE レジストリ キーまたはシステム環境変数を使用してシステム全体で有効にできます。  ログは、レジストリ エントリまたは環境変数が削除されるまで生成されます。  また、ユーザーローカルまたはプロセスローカルの環境変数を使用して、範囲と期間の異なるログを有効にすることもできます。  
+  
+ CLR アクティベーション ログは、[アセンブリ バインディング ログ](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md)と混同しないようにしてください。これは完全に異なるログです。  
+  
+## CLR アクティベーション ログを有効にするには  
+  
+#### レジストリの使用  
+  
+1.  レジストリ エディターで、HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\.NETFramework \(32 ビット コンピューターの場合\) または HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\.NETFramework フォルダー \(64 ビット コンピューターの場合\) に移動します。  
+  
+2.  `CLRLoadLogDir` という名前の文字列値を追加し、CLR アクティベーション ログを格納する既存のディレクトリの完全パスに設定します。  
+  
+ アクティベーション ログは、文字列値を削除するまで有効なままになります。  
+  
+#### 環境変数の使用  
+  
+-   `COMPLUS_CLRLoadLogDir` 環境変数を、CLR アクティベーション ログを格納する既存のディレクトリの完全パスを表す文字列に設定します。  
+  
+     環境変数の設定方法によって、その範囲が以下のように決定されます。  
+  
+    -   システム レベルで設定した場合、アクティベーション ログは環境変数が削除されるまで、そのコンピューターのすべての .NET Framework アプリケーションで有効になります。  
+  
+    -   ユーザー レベルで設定した場合、アクティベーション ログは現在のユーザー アカウントのみに対して有効になります。  ログ記録は環境変数が削除されるまで続行します。  
+  
+    -   CLR を読み込む前にプロセス内から設定した場合、アクティベーション ログはプロセスが終了するまで有効になります。  
+  
+    -   アプリケーションを実行する前にコマンド プロンプトで設定した場合、アクティベーション ログは、そのコマンド プロンプトから実行されるアプリケーションに対して有効になります。  
+  
+     たとえば、アクティベーション ログをプロセスレベルのスコープの c:\\clrloadlogs ディレクトリに格納するには、アプリケーションを実行する前に、コマンド プロンプト ウィンドウを開き、次のように入力します。  
+  
+    ```  
+    set COMPLUS_CLRLoadLogDir=c:\clrloadlogs  
+    ```  
+  
+## 使用例  
+ CLR アクティベーション ログは、CLR のアクティベーションおよび CLR ホスティング API の使用に関する大量のデータを提供します。  この記事で説明されているように、このデータのほとんどはマイクロソフトにより内部で使用されますが、一部のデータは開発者にも役立ちます。  
+  
+ ログは、CLR ホスティング API が呼び出された順序で記録されます。  また、コンピューターで検出された、一連のインストール済みランタイムに関する便利なデータも含まれています。  CLR アクティベーション ログ形式自体は文書化されていませんが、CLR のアクティベーションに関する問題を解決する必要のある開発者の役に立つことがあります。  
+  
+> [!NOTE]
+>  アクティベーション ログは、CLR を使用するプロセスが終了するまで開くことができません。  
+  
+> [!NOTE]
+>  CLR アクティベーション ログはローカライズされず、常に英語で生成されます。  
+  
+ 次のアクティベーション ログの例では、最も役に立つ情報が強調表示されており、ログの後に説明されています。  
+  
+```  
+532,205950.367,CLR Loading log for C:\Tests\myapp.exe   
+532,205950.367,Log started at 4:26:12 PM on 10/6/2011   
+532,205950.367,-----------------------------------   
+532,205950.382,FunctionCall: _CorExeMain   
+532,205950.382,FunctionCall: ClrCreateInstance, Clsid: {2EBCD49A-1B47-4A61-B13A-4A03701E594B}, Iid: {E2190695-77B2-492E-8E14-C4B3A7FDD593}   
+532,205950.382,MethodCall: ICLRMetaHostPolicy::GetRequestedRuntime. Version: (null), Metahost Policy Flags: 0x168, Binary: (null), Iid: {BD39D1D2-BA2F-486A-89B0-B4B0CB466891}   
+532,205950.382,Installed Runtime: v4.0.30319. VERSION_ARCHITECTURE: 0   
+532,205950.382,Input values for ComputeVersionString follow this line   
+532,205950.382,-----------------------------------   
+532,205950.382,Default Application Name: C:\Tests\myapp.exe   
+532,205950.382,IsLegacyBind is: 0   
+532,205950.382,IsCapped is 0   
+532,205950.382,SkuCheckFlags are 0   
+532,205950.382,ShouldEmulateExeLaunch is 0   
+532,205950.382,LegacyBindRequired is 0   
+532,205950.382,-----------------------------------   
+532,205950.382,Parsing config file: C:\Tests\myapp.exe   
+532,205950.382,UseLegacyV2RuntimeActivationPolicy is set to 0   
+532,205950.382,LegacyFunctionCall: GetFileVersion. Filename: C:\Tests\myapp.exe   
+532,205950.382,LegacyFunctionCall: GetFileVersion. Filename: C:\Tests\myapp.exe   
+532,205950.382,C:\Tests\myapp.exe was built with version: v2.0.50727   
+532,205950.382,ERROR: Version v2.0.50727 is not present on the machine.   
+532,205950.398,SEM_FAILCRITICALERRORS is set to 0   
+532,205950.398,Launching feature-on-demand installation. CmdLine: C:\Windows\system32\fondue.exe /enable-feature:NetFx3   
+532,205950.398,FunctionCall: RealDllMain. Reason: 0   
+532,205950.398,FunctionCall: OnShimDllMainCalled. Reason: 0  
+  
+```  
+  
+-   **CLR Loading log** は、マネージ コードを読み込んだプロセスを開始した実行可能ファイルのパスを示します。  これはネイティブ ホストである可能性があります。  
+  
+    ```  
+    532,205950.367,CLR Loading log for C:\Tests\myapp.exe  
+  
+    ```  
+  
+-   **Installed Runtime** は、コンピューター上にインストールされている、アクティベーション要求候補である一連の CLR バージョンです。  
+  
+    ```  
+    532,205950.382,Installed Runtime: v4.0.30319. VERSION_ARCHITECTURE: 0  
+  
+    ```  
+  
+-   **built with version** は、[ICLRMetaHostPolicy::GetRequestedRuntime](../Topic/ICLRMetaHostPolicy::GetRequestedRuntime%20Method.md) などのメソッドに提供されたバイナリを構築するために使用された CLR のバージョンです。  
+  
+    ```  
+    532,205950.382,C:\Tests\myapp.exe was built with version: v2.0.50727  
+  
+    ```  
+  
+-   **feature\-on\-demand installation** は、Windows 8 での .NET Framework 3.5 の有効化に関するものです。   このシナリオの詳細については、「[.NET Framework 初期化エラー: ユーザー エクスペリエンスの管理](../../../docs/framework/deployment/initialization-errors-managing-the-user-experience.md)」を参照してください。  
+  
+    ```  
+    532,205950.398,Launching feature-on-demand installation. CmdLine: C:\Windows\system32\fondue.exe /enable-feature:NetFx3  
+  
+    ```  
+  
+## 参照  
+ [配置](../../../docs/framework/deployment/net-framework-and-applications.md)   
+ [方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md b/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md
new file mode 100644
index 00000000000..eb2e75917f2
--- /dev/null
+++ b/docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md
@@ -0,0 +1,332 @@
+---
+title: "方法: .NET Framework 4.5 インストーラーの進行状況を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, インストール"
+  - "進行状況, .NET Framework インストーラー"
+ms.assetid: 0a1a3ba3-7e46-4df2-afd3-f3a8237e1c4f
+caps.latest.revision: 30
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# 方法: .NET Framework 4.5 インストーラーの進行状況を表示する
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は再頒布可能なランタイムです。  このバージョンの .NET Framework 用アプリを開発する場合は、アプリのセットアップに必要なパーツとして、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップを含める \(チェーンする\) ことができます。  セットアップ手順をカスタマイズまたは統一するために、アプリケーションのセットアップの進行状況を表示する一方で、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップをサイレントで起動し、その進行状況を追跡できます。  サイレントな追跡を可能にするために、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップ \(監視対象\) ではメモリ マップ I\/O \(MMIO\) セグメントを使用してプロトコルを定義し、セットアップ \(ウォッチャーつまりチェーン元\) と通信します。  このプロトコルは、チェーン元が進行状況情報や詳細な結果を取得してメッセージに応答し、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップを取り消す方法を定義します。  
+  
+-   **呼び出し**。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップを呼び出して、MMIO セクションから進行状況情報を受け取るには、セットアップ プログラムで以下の処理を行う必要があります。  
+  
+    1.  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 再頒布可能プログラムを呼び出します。  
+  
+        ```  
+        dotNetFx45_Full_x86_x64.exe /q /norestart /pipe section-name  
+        ```  
+  
+         *section name* は、アプリの識別に使用する名前です。.NET Framework のセットアップでは MMIO セクションに対する読み書きを非同期に行うので、その間、イベントおよびメッセージの使用が役立つ場合があります。  この例では、.NETFramework セットアップ プロセスは、MMIO セクションの割り当て \(`TheSectionName`\) とイベントの定義 \(`TheEventName`\) の両方を行うコンストラクターによって作成されます。  
+  
+        ```  
+        Server():ChainerSample::MmioChainer(L"TheSectionName", L"TheEventName")  
+        ```  
+  
+         これらの名前は、実際のセットアップ プログラムの固有な名前に置き換えてください。  
+  
+    2.  MMIO セクションから読み取ります。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、ダウンロード操作とインストール操作は同時に行われます。.NET Framework の 1 つのパーツがインストールしている間に、別のパーツがダウンロードします。  その結果、進行状況は、0 から 255 まで増加する 2 つの値 \(`m_downloadSoFar` および `m_installSoFar`\) として MMIO セクションに送り返されます \(書き込まれます\)。  255 が書き込まれて、.NET Framework が終了すると、インストールは完了します。  
+  
+-   **終了コード**。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 再頒布可能プログラムを呼び出すためのコマンドからの以下の終了コードは、セットアップが成功または失敗したことを示します。  
+  
+    -   0: セットアップは、正常に完了しました。  
+  
+    -   3010: セットアップは正常に完了しました。システムの再起動が必要です。  
+  
+    -   1602: セットアップは取り消されました。  
+  
+    -   他のすべてのコード: セットアップでエラーが発生しました。詳細については、%temp% に作成されるログ ファイルを調べてください。  
+  
+-   **セットアップの取り消し**。  `Abort` メソッドを使用して MMIO セクションの `m_downloadAbort` フラグと `m_ installAbort` フラグを設定することで、いつでもセットアップを取り消すことができます。  
+  
+## チェーン元のサンプル  
+ チェーン元のサンプルがサイレントで起動し、進行状況を表示しながら [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] セットアップを追跡します。  このサンプルは、.NET Framework 4 用のチェーン元サンプルに似ています。  ただし、.NET Framework 4 アプリケーションを閉じるためのメッセージ ボックスを処理することで、システムの再起動を避けることができます。  このメッセージ ボックスの詳細については、「[.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)」を参照してください。  このサンプルは .NET Framework 4 インストーラーで使用できます。そのシナリオではメッセージは送信されません。  
+  
+> [!WARNING]
+>  例の実行は、管理者として行う必要があります。  
+  
+ MSDN サンプル ギャラリーから [.NET Framework 4.5 チェーン元のサンプル](http://go.microsoft.com/fwlink/?LinkId=231345)の完全な Visual Studio ソリューションをダウンロードできます。  
+  
+ 以下のセクションでは、この例の重要なファイルである MMIOChainer.h、ChainingdotNet4.cpp、および IProgressObserver.h について説明します。  
+  
+#### MMIOChainer.h  
+  
+-   MMIOChainer.h ファイル \([完全なコード](http://go.microsoft.com/fwlink/?LinkId=231369)を参照\) には、データ構造体の定義と、チェーン元クラスが派生する基底クラスが含まれます。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は MMIO データ構造体を拡張し、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] インストーラーが必要とするデータを処理できるようにします。  MMIO 構造体への変更には下位互換性があるため、.NET Framework 4 チェーン元は、再コンパイルを必要とせずに .NET Framework 4.5 のセットアップで機能します。  ただし、このシナリオはシステムの再起動を削減するための機能をサポートしていません。  
+  
+     バージョン フィールドは、構造体およびメッセージ形式へのリビジョンを識別するための手段を提供します。.NET Framework セットアップでは、`VirtualQuery` 関数を呼び出してファイル マップのサイズを判断することで、チェーン元インターフェイスのバージョンを判別します。サイズがバージョン フィールドに対応できる十分な大きさである場合、.NET Framework セットアップでは指定された値を使用します。  .NET Framework 4 の場合のように、バージョン フィールドを含めるにはファイル マップが小さすぎる場合、セットアップ プロセスではバージョン 0 \(4\) を使用します。  .NET Framework セットアップが送信しようとするメッセージのバージョンをチェーン元がサポートしていない場合、.NET Framework セットアップでは応答を無視します。  
+  
+     MMIO データ構造体は以下のように定義されます。  
+  
+    ```cpp  
+    // MMIO data structure for interprocess communication  
+        struct MmioDataStructure  
+        {  
+            bool m_downloadFinished;               // Is download complete?  
+            bool m_installFinished;                // Is installation complete?  
+            bool m_downloadAbort;                  // Set to cause downloader to abort.  
+            bool m_installAbort;                   // Set to cause installer to abort.  
+            HRESULT m_hrDownloadFinished;          // Resulting HRESULT for download.  
+            HRESULT m_hrInstallFinished;           // Resulting HRESULT for installation.  
+            HRESULT m_hrInternalError;  
+            WCHAR m_szCurrentItemStep[MAX_PATH];  
+            unsigned char m_downloadSoFar;         // Download progress 0-255 (0-100% done).   
+            unsigned char m_installSoFar;          // Installation progress 0-255 (0-100% done).  
+            WCHAR m_szEventName[MAX_PATH];         // Event that chainer creates and chainee opens to sync communications.  
+  
+            BYTE m_version;                        // Version of the data structure, set by chainer:  
+                                                   // 0x0: .NET Framework 4   
+                                                   // 0x1: .NET Framework 4.5  
+  
+            DWORD m_messageCode;                   // Current message sent by the chainee; 0 if no message is active.  
+            DWORD m_messageResponse;               // Chainer's response to current message; 0 if not yet handled.  
+            DWORD m_messageDataLength;             // Length of the m_messageData field, in bytes.  
+            BYTE m_messageData[1];                 // Variable-length buffer; content depends on m_messageCode.  
+        };  
+  
+    ```  
+  
+-   `MmioDataStructure` データ構造体を直接使用するのではなく、チェーン元を実装するための `MmioChainer` クラスを使用します。  `MmioChainer` クラスから派生させて、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 再頒布可能プログラムをチェインします。  
+  
+#### IProgressObserver.h  
+  
+-   IProgressObserver.h ファイルは進行状況のオブザーバー \([完全なコードを参照](http://go.microsoft.com/fwlink/?LinkId=231370)\) を実装します。  このオブザーバーは、ダウンロードとインストールの進行状況 \(1% ～ 100% 完了を示す、符号なしの `char` 0 ～ 255 の値で指定\) の通知を受け取ります。  オブザーバーは、チェーン対象がメッセージを送信したときにも通知を受け取ります。通知を受け取ったオブザーバーは、応答を送信する必要があります。  
+  
+    ```cpp  
+        class IProgressObserver  
+        {  
+        public:  
+            virtual void OnProgress(unsigned char) = 0; // 0 - 255:  255 == 100%  
+            virtual void Finished(HRESULT) = 0;         // Called when operation is complete    
+            virtual DWORD Send(DWORD dwMessage, LPVOID pData, DWORD dwDataLength) = 0; // Called when a message is sent  
+        };  
+  
+    ```  
+  
+#### ChainingdotNet4.5.cpp  
+  
+-   [ChainingdotNet4.5.cpp](http://go.microsoft.com/fwlink/?LinkId=231368) ファイルは、`Server` クラスを実装します。このクラスは `MmioChainer` クラスから派生し、適切なメソッドをオーバーライドして進行状況情報を表示します。  MmioChainer は、指定されたセクション名でセクションを作成し、指定されたイベント名でチェーン元を初期化します。  イベント名は、マップされたデータ構造体に保存されます。  セクションとイベント名は一意にする必要があります。  次のコードの `Server` クラスは、指定されたセットアップ プログラムを起動して進行状況を監視し、終了コードを返します。  
+  
+    ```cpp  
+    class Server : public ChainerSample::MmioChainer, public ChainerSample::IProgressObserver  
+    {  
+    public:  
+        …………….  
+        Server():ChainerSample::MmioChainer(L"TheSectionName", L"TheEventName") //customize for your event names  
+        {}  
+  
+    ```  
+  
+     インストールが Main メソッドで開始されます。  
+  
+    ```cpp  
+    // Main entry point for program  
+    int __cdecl main(int argc, _In_count_(argc) char **_argv)  
+    {  
+        int result = 0;  
+        CString args;  
+        if (argc > 1)  
+        {  
+            args = CString(_argv[1]);  
+        }  
+  
+        if (IsNetFx4Present(NETFX45_RC_REVISION))  
+        {  
+            printf(".NET Framework 4.5 is already installed");  
+        }  
+        else  
+        {  
+            result = Server().Launch(args);  
+        }  
+  
+        return result;  
+    }  
+  
+    ```  
+  
+-   インストールを起動する前に、チェーン元では `IsNetFx4Present` を呼び出して、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] が既にインストールされているかどうかを確認します。  
+  
+    ```cpp  
+    ///  Checks for presence of the .NET Framework 4.  
+    ///    A value of 0 for dwMinimumRelease indicates a check for the .NET Framework 4 full  
+    ///    Any other value indicates a check for a specific compatible release of the .NET Framework 4.  
+    #define NETFX40_FULL_REVISION 0  
+    // TODO: Replace with released revision number  
+    #define NETFX45_RC_REVISION MAKELONG(50309, 5)   // .NET Framework 4.5   
+    bool IsNetFx4Present(DWORD dwMinimumRelease)  
+    {  
+        DWORD dwError = ERROR_SUCCESS;  
+        HKEY hKey = NULL;  
+        DWORD dwData = 0;  
+        DWORD dwType = 0;  
+        DWORD dwSize = sizeof(dwData);  
+  
+        dwError = ::RegOpenKeyExW(HKEY_LOCAL_MACHINE, L"SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4\\Full", 0, KEY_READ, &hKey);  
+        if (ERROR_SUCCESS == dwError)  
+        {  
+            dwError = ::RegQueryValueExW(hKey, L"Release", 0, &dwType, (LPBYTE)&dwData, &dwSize);  
+  
+            if ((ERROR_SUCCESS == dwError) && (REG_DWORD != dwType))  
+            {  
+                dwError = ERROR_INVALID_DATA;  
+            }  
+            else if (ERROR_FILE_NOT_FOUND == dwError)  
+            {  
+                // Release value was not found, let's check for 4.0.  
+                dwError = ::RegQueryValueExW(hKey, L"Install", 0, &dwType, (LPBYTE)&dwData, &dwSize);  
+  
+                // Install = (REG_DWORD)1;  
+                if ((ERROR_SUCCESS == dwError) && (REG_DWORD == dwType) && (dwData == 1))  
+                {  
+                    // treat 4.0 as Release = 0  
+                    dwData = 0;  
+                }  
+                else  
+                {  
+                    dwError = ERROR_INVALID_DATA;  
+                }  
+            }  
+        }  
+  
+        if (hKey != NULL)  
+        {  
+            ::RegCloseKey(hKey);  
+        }  
+  
+        return ((ERROR_SUCCESS == dwError) && (dwData >= dwMinimumRelease));  
+    }  
+  
+    ```  
+  
+-   `Launch` メソッド内の実行可能ファイル \(例では Setup.exe\) のパスを正しい場所に変更するか、コードをカスタマイズして場所を判断することができます。  `MmioChainer` 基底クラスは、派生クラスが呼び出すブロッキング `Run()` メソッドを提供します。  
+  
+    ```cpp  
+  
+    bool Launch(const CString& args)  
+    {  
+    CString cmdline = L"dotNetFx45_Full_x86_x64.exe -pipe TheSectionName " + args; // Customize with name and location of setup .exe that you want to run  
+    STARTUPINFO si = {0};  
+    si.cb = sizeof(si);  
+    PROCESS_INFORMATION pi = {0};  
+  
+    // Launch the Setup.exe that installs the .NET Framework 4.5  
+    BOOL bLaunchedSetup = ::CreateProcess(NULL,   
+     cmdline.GetBuffer(),  
+     NULL, NULL, FALSE, 0, NULL, NULL,   
+     &si,  
+     &pi);  
+  
+    // If successful   
+    if (bLaunchedSetup != 0)  
+    {  
+    IProgressObserver& observer = dynamic_cast<IProgressObserver&>(*this);  
+    Run(pi.hProcess, observer);  
+  
+    ……………………..   
+    return (bLaunchedSetup != 0);  
+    }  
+  
+    ```  
+  
+-   `Send` メソッドはメッセージを途中受信して処理します。このバージョンの .NET Framework では、サポートされているメッセージはアプリケーションの終了メッセージのみです。  
+  
+    ```cpp  
+            // SendMessage  
+            //  
+            // Send a message and wait for the response.  
+            // dwMessage: Message to send  
+            // pData: The buffer to copy the data to  
+            // dwDataLength: Initially a pointer to the size of pBuffer.  Upon successful call, the number of bytes copied to pBuffer.  
+            //--------------------------------------------------------------  
+        virtual DWORD Send(DWORD dwMessage, LPVOID pData, DWORD dwDataLength)  
+        {  
+            DWORD dwResult = 0;  
+            printf("recieved message: %d\n", dwMessage);  
+            // Handle message  
+            switch (dwMessage)  
+            {  
+            case MMIO_CLOSE_APPS:  
+                {  
+                    printf("    applications are holding files in use:\n");  
+                    IronMan::MmioCloseApplications* applications = reinterpret_cast<IronMan::MmioCloseApplications*>(pData);  
+                    for(DWORD i = 0; i < applications->m_dwApplicationsSize; i++)  
+                    {  
+                        printf("      %ls (%d)\n", applications->m_applications[i].m_szName, applications->m_applications[i].m_dwPid);  
+                    }  
+  
+                    printf("    should appliations be closed? (Y)es, (N)o, (R)efresh : ");  
+                    while (dwResult == 0)  
+                    {  
+                        switch (toupper(getwchar()))  
+                        {  
+                        case 'Y':  
+                            dwResult = IDYES;  // Close apps  
+                            break;  
+                        case 'N':  
+                            dwResult = IDNO;  
+                            break;  
+                        case 'R':  
+                            dwResult = IDRETRY;  
+                            break;  
+                        }  
+                    }  
+                    printf("\n");  
+                    break;  
+                }  
+            default:  
+                break;  
+            }  
+            printf("  response: %d\n  ", dwResult);  
+            return dwResult;  
+        }  
+    };  
+  
+    ```  
+  
+-   進行状況のデータは、0 \(0%\) ～ 255 \(100%\) の範囲の符号なし `char` です。  
+  
+    ```cpp  
+    private: // IProgressObserver  
+        virtual void OnProgress(unsigned char ubProgressSoFar)  
+        {…………  
+       }  
+  
+    ```  
+  
+-   HRESULT は、`Finished` メソッドに渡されます。  
+  
+    ```cpp  
+    virtual void Finished(HRESULT hr)  
+    {  
+    // This HRESULT is communicated over MMIO and may be different than process  
+    // Exit code of the Chainee Setup.exe itself  
+    printf("\r\nFinished HRESULT: 0x%08X\r\n", hr);  
+    }  
+  
+    ```  
+  
+    > [!IMPORTANT]
+    >  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の再頒布可能プログラムは、通常、多数の進行状況メッセージと、\(チェーン元側で\) 完了を示す 1 つのメッセージを書き込みます。  また、非同期に読み取りを行って、`Abort` レコードを探します。  `Abort` レコードを受け取った場合は、インストールを取り消し、インストールが中止され、セットアップ操作がロールバックされた後に、データとして E\_ABORT を含む終了レコードを書き込みます。  
+  
+ 標準的なサーバーは、ランダムな MMIO ファイル名を作成し、ファイル \(前のコード例の `Server::CreateSection` で示されているファイル\) を作成した後、`CreateProcess` メソッドを使用して `-pipe someFileSectionName` オプションでパイプ名を渡すことによって、再頒布可能プログラムを起動します。  サーバーは、アプリケーションの UI 固有のコードを使用して `OnProgress`、`Send`、および `Finished` の各メソッドを実装する必要があります。  
+  
+## 参照  
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)   
+ [配置](../../../docs/framework/deployment/net-framework-and-applications.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/in-process-side-by-side-execution.md b/docs/framework/deployment/in-process-side-by-side-execution.md
new file mode 100644
index 00000000000..b982335a3d8
--- /dev/null
+++ b/docs/framework/deployment/in-process-side-by-side-execution.md
@@ -0,0 +1,189 @@
+---
+title: "インプロセスの side-by-side 実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インプロセスの side-by-side 実行"
+  - "side-by-side 実行, インプロセス"
+ms.assetid: 18019342-a810-4986-8ec2-b933a17c2267
+caps.latest.revision: 25
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# インプロセスの side-by-side 実行
+[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、インプロセスの side\-by\-side ホスティングを使用して、1 つのプロセスで複数のバージョンの共通言語ランタイム \(CLR: Common Language Runtime\) を実行できます。  既定では、マネージ COM コンポーネントは、プロセスに読み込まれている .NET Framework のバージョンに関係なく、そのコンポーネントのビルドに使用された .NET Framework のバージョンで実行されます。  
+  
+## 背景  
+ .NET Framework では、マネージ コード アプリケーションに対しては side\-by\-side ホスティングを常に提供してきましたが、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] まで、マネージ COM コンポーネントに対しては同様の機能がありませんでした。  これまで、プロセスに読み込まれたマネージ COM コンポーネントは、既に読み込まれているバージョンのランタイムか、インストールされている最新バージョンの .NET Framework で実行されていました。  このバージョンが COM コンポーネントと互換性がない場合、そのコンポーネントは失敗しました。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] には、以下を実現する side\-by\-side ホスティングの新しい方法が用意されています。  
+  
+-   新しいバージョンの .NET Framework をインストールした場合に、既存のアプリケーションに影響を与えません。  
+  
+-   アプリケーションは、ビルドに使用されたバージョンの .NET Framework で実行されます。  新しいバージョンの .NET Framework を使用するには、そのように明示的に指示する必要があります。  ただし、新しいバージョンの .NET Framework を使用するようにアプリケーションを移行する方が簡単です。  
+  
+## ユーザーおよび開発者への影響  
+  
+-   **エンド ユーザーおよびシステム管理者**。  新しいバージョンのランタイムを個別にまたはアプリケーションと共にインストールしても、使用しているコンピューターに影響を与えないので、安心して作業できます。  既存のアプリケーションはこれまでどおり実行されます。  
+  
+-   **アプリケーション開発者**。  アプリケーション開発者にとって、side\-by\-side ホスティングによる影響はほとんどありません。  既定では、アプリケーションは、ビルドに使用されたバージョンの .NET Framework で常に実行されます。この点に変わりはありません。  ただし、開発者は、この動作をオーバーライドし、新しいバージョンの .NET Framework でアプリケーションを実行するように指示できます \([シナリオ 2](#scenarios) を参照してください\)。  
+  
+-   **ライブラリの開発者および使用者**。  side\-by\-side ホスティングでは、ライブラリ開発者が直面する互換性の問題は解決されません。  直接参照または <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> の呼び出しによってアプリケーションで直接読み込まれるライブラリでは、読み込み先の <xref:System.AppDomain> のランタイムを引き続き使用します。  サポートする必要があるすべてのバージョンの .NET Framework に対してライブラリをテストする必要があります。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] ランタイムを使用してアプリケーションをコンパイルするが、アプリケーションに以前のランタイムを使用してビルドされたライブラリが含まれている場合は、そのライブラリでも [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] ランタイムが使用されます。  ただし、以前のランタイムを使用してビルドされたアプリケーションと、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を使用してビルドされたライブラリの場合は、強制的にアプリケーションで [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を使用する必要があります \([シナリオ 3](#scenarios) を参照してください\)。  
+  
+-   **マネージ COM コンポーネントの開発者**。  これまで、マネージ COM コンポーネントは、コンピューターにインストールされている最新バージョンのランタイムを使用して自動的に実行されていました。  現在では、COM コンポーネントは、ビルドに使用されたバージョンのランタイムで実行できます。  
+  
+     次の表に示すように、.NET Framework Version 1.1 でビルドされたコンポーネントは、Version 4 のコンポーネントと並行して実行できますが、Version 2.0、3.0、または 3.5 では side\-by\-side ホスティングを使用できないので、これらのバージョンのコンポーネントと並行して実行することはできません。  
+  
+    |.NET Framework のバージョン|1.1|2.0 \- 3.5|4|  
+    |---------------------------|---------|----------------|-------|  
+    |1.1|該当なし|No|Yes|  
+    |2.0 \- 3.5|No|該当なし|Yes|  
+    |4|Yes|Yes|該当なし|  
+  
+> [!NOTE]
+>  .NET Framework Version 3.0 および 3.5 は、Version 2.0 を基盤としてインクリメント方式で構築されており、並行して実行する必要はありません。  これらのバージョンは、本質的に同じバージョンです。  
+  
+<a name="scenarios"></a>   
+## side\-by\-side ホスティングの一般的なシナリオ  
+  
+-   **シナリオ 1:** 以前のバージョンの .NET Framework でビルドされた COM コンポーネントを使用するネイティブ アプリケーション。  
+  
+     インストールされている .NET Framework のバージョン: [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]、および COM コンポーネントで使用されるその他のすべてのバージョンの .NET Framework。  
+  
+     操作内容: このシナリオでは何もしません。  COM コンポーネントは、そのコンポーネントが登録されているバージョンの .NET Framework で実行されます。  
+  
+-   **シナリオ 2**: [!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] でビルドされたマネージ アプリケーション。[!INCLUDE[dnprdnext](../../../includes/dnprdnext-md.md)] で優先的に実行しますが、Version 2.0 がない場合は [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] で実行します。  
+  
+     インストールされている .NET Framework のバージョン: 以前のバージョンの .NET Framework および [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]。  
+  
+     操作内容: アプリケーション ディレクトリの [アプリケーション構成ファイル](../../../docs/framework/configure-apps/index.md) で、次のように設定されている [\<起動\> 要素](../../../docs/framework/configure-apps/file-schema/startup/startup-element.md) と [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) を使用する:  
+  
+    ```  
+    <configuration>  
+      <startup >  
+        <supportedRuntime version="v2.0.50727" />  
+        <supportedRuntime version="v4.0" />  
+      </startup>  
+    </configuration>  
+    ```  
+  
+-   **シナリオ 3:** 以前のバージョンの .NET Framework でビルドされた COM コンポーネントを使用するネイティブ アプリケーション。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] で実行します。  
+  
+     インストールされている .NET Framework のバージョン: [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]。  
+  
+     操作内容: アプリケーション ディレクトリのアプリケーション構成ファイルで、`useLegacyV2RuntimeActivationPolicy` 属性を `true` に設定した `<startup>` 要素と次のように設定した `<supportedRuntime>` 要素を使用します。  
+  
+    ```  
+    <configuration>  
+      <startup useLegacyV2RuntimeActivationPolicy="true">  
+        <supportedRuntime version="v4.0" />  
+      </startup>  
+    </configuration>  
+    ```  
+  
+## 例  
+ マネージ COM コンポーネントを実行するアンマネージ COM ホストの例を次に示します。マネージ COM コンポーネントの実行には、そのコンパイルで対象としたバージョンの .NET Framework を使用します。  
+  
+ 次のコード例を実行し、次のマネージ COM コンポーネントを登録するには [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)]を使用してコンパイルします。  コンポーネントは、**\[プロジェクト\]** メニューに登録するには、**\[プロパティ\]** をクリックします、**\[ビルド\]** タブをクリックし、**\[COM 相互運用機能の登録\]** チェック ボックスをオンにします。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.Runtime.InteropServices;  
+  
+namespace BasicComObject  
+{  
+    [ComVisible(true), Guid("9C99C4B5-CA54-4c58-8988-49B6811BA53B")]  
+    public class MyObject : SimpleObjectModel.IPrintInfo  
+    {  
+        public MyObject()  
+        {  
+        }  
+        public void PrintInfo()  
+        {  
+            Console.WriteLine("MyObject was activated in {0} runtime in:\n\tAppDomain {1}:{2}", System.Runtime.InteropServices.RuntimeEnvironment.GetSystemVersion(), AppDomain.CurrentDomain.Id, AppDomain.CurrentDomain.FriendlyName);  
+        }  
+    }  
+}  
+```  
+  
+ 次のアンマネージ C\+\+ アプリケーションをコンパイルします。これにより、前の例で作成される COM オブジェクトがアクティブになります。  
+  
+```  
+#include "stdafx.h"  
+#include <string>  
+#include <iostream>  
+#include <objbase.h>  
+#include <string.h>  
+#include <process.h>  
+  
+using namespace std;  
+  
+int _tmain(int argc, _TCHAR* argv[])  
+{  
+    char input;  
+    CoInitialize(NULL) ;  
+    CLSID clsid;  
+    HRESULT hr;  
+    HRESULT clsidhr = CLSIDFromString(L"{9C99C4B5-CA54-4c58-8988-49B6811BA53B}",&clsid);  
+    hr = -1;  
+    if (FAILED(clsidhr))  
+    {  
+        printf("Failed to construct CLSID from String\n");  
+    }  
+    UUID id = __uuidof(IUnknown);  
+    IUnknown * pUnk = NULL;  
+    hr = ::CoCreateInstance(clsid,NULL,CLSCTX_INPROC_SERVER,id,(void **) &pUnk);  
+    if (FAILED(hr))  
+    {  
+        printf("Failed CoCreateInstance\n");  
+    }else  
+    {  
+        pUnk->AddRef();  
+        printf("Succeeded\n");  
+    }  
+  
+    DISPID dispid;  
+    IDispatch* pPrintInfo;  
+    pUnk->QueryInterface(IID_IDispatch, (void**)&pPrintInfo);  
+    OLECHAR FAR* szMethod[1];  
+    szMethod[0]=OLESTR("PrintInfo");   
+    hr = pPrintInfo->GetIDsOfNames(IID_NULL,szMethod, 1, LOCALE_SYSTEM_DEFAULT, &dispid);  
+    DISPPARAMS dispparams;  
+    dispparams.cNamedArgs = 0;  
+    dispparams.cArgs = 0;  
+    VARIANTARG* pvarg = NULL;  
+    EXCEPINFO * pexcepinfo = NULL;  
+    WORD wFlags = DISPATCH_METHOD ;  
+;  
+    LPVARIANT pvRet = NULL;  
+    UINT * pnArgErr = NULL;  
+    hr = pPrintInfo->Invoke(dispid,IID_NULL, LOCALE_USER_DEFAULT, wFlags,  
+        &dispparams, pvRet, pexcepinfo, pnArgErr);  
+    printf("Press Enter to exit");  
+    scanf_s("%c",&input);  
+    CoUninitialize();  
+    return 0;  
+}  
+  
+```  
+  
+## 参照  
+ [\<startup\> 要素](../../../docs/framework/configure-apps/file-schema/startup/startup-element.md)   
+ [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/index.md b/docs/framework/deployment/index.md
new file mode 100644
index 00000000000..81723a6b3d5
--- /dev/null
+++ b/docs/framework/deployment/index.md
@@ -0,0 +1,50 @@
+---
+title: ".NET Framework の配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 配置"
+  - "配置 [.NET Framework]"
+ms.assetid: 238d8284-6042-4a38-a7f6-1ee8efd719da
+caps.latest.revision: 56
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# .NET Framework の配置
+.NET Framework ドキュメントのこのセクションでは、アプリケーションと共に .NET Framework をインストールする開発者と、ネットワーク経由で .NET Framework を配置する管理者向けの情報を提供します。  また、配置に関連したアクティベーションと再起動に関する問題、および .NET Framework のインストールの進行状況を監視する方法についても説明します。  
+  
+## このセクションの内容  
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)  
+ 開発者による .NET Framework とアプリケーションのユーザーのコンピューターへのインストール方法について説明します。  
+  
+ [配置ガイド \(管理者向け\)](../../../docs/framework/deployment/guide-for-administrators.md)  
+ System Center Configuration Manager \(SCCM\) を使用したシステム管理者による .NET Framework の配置方法と、ネットワーク全体でのシステムの依存関係について説明します。  
+  
+ [.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)  
+ 再起動をできる限り回避する再起動マネージャーと、.NET Framework をインストールするアプリケーションがそれをどのように利用できるかを説明しています。  
+  
+ [方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)  
+ 進行状況のビューを独自に表示する一方で、.NET Framework セットアップ プロセスをサイレントで起動および追跡する方法を説明します。  
+  
+ [.NET Framework 初期化エラー: ユーザー エクスペリエンスの管理](../../../docs/framework/deployment/initialization-errors-managing-the-user-experience.md)  
+ ユーザーのコンピューターで無効になっているかインストールされていない CLR バージョンが .NET Framework アプリケーションで必要な場合に生じる現象、そのようなエラーを解決する方法、およびユーザーに表示されるエラー メッセージを制御する方法について説明します。  
+  
+ [方法: CLR のアクティブ化に関する問題をデバッグする](../../../docs/framework/deployment/how-to-debug-clr-activation-issues.md)  
+ 正しいバージョンの CLR を使用してアプリケーションを実行した場合に発生する可能性のある問題を解決するために、CLR アクティベーション ログを表示してデバッグする方法について説明します。  
+  
+## 参照  
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/initialization-errors-managing-the-user-experience.md b/docs/framework/deployment/initialization-errors-managing-the-user-experience.md
new file mode 100644
index 00000000000..6027e5613aa
--- /dev/null
+++ b/docs/framework/deployment/initialization-errors-managing-the-user-experience.md
@@ -0,0 +1,103 @@
+---
+title: ".NET Framework 初期化エラー: ユーザー エクスペリエンスの管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 初期化エラー"
+  - "初期化エラー [.NET Framework]"
+  - "フレームワークが見つからない"
+ms.assetid: 680a7382-957f-4f6e-b178-4e866004a07e
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Framework 初期化エラー: ユーザー エクスペリエンスの管理
+共通言語ランタイムの \(CLR\) のアクティベーション システムでは、マネージ アプリケーション コードの実行に使用する CLR のバージョンを特定します。  アクティベーション システムで、読み込む CLR のバージョンを検出できない場合もあります。  通常、この状況は、特定のコンピューターで無効になっているかインストールされていない CLR バージョンがアプリケーションで必要な場合に発生します。  要求されたバージョンが見つからない場合、CLR アクティベーション システムは、呼び出された関数またはインターフェイスから HRESULT エラー コードを返します。また、アプリケーションを実行しているユーザーにはエラー メッセージが表示されることがあります。  ここでは、HRESULT コードの一覧を示し、エラー メッセージが表示されないようにする方法について説明します。  
+  
+ CLR には、「[方法: CLR のアクティブ化に関する問題をデバッグする](../../../docs/framework/deployment/how-to-debug-clr-activation-issues.md)」で説明されているように、CLR のアクティベーションに関する問題のデバッグに役立つログ インフラストラクチャが用意されています。  このインフラストラクチャと[アセンブリ バインド ログ](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md)は完全に異なりますので混同しないでください。  
+  
+## CLR アクティベーションの HRESULT コード  
+ CLR アクティベーションの API は、ホストにアクティベーション操作の結果を報告する HRESULT コードを返します。  CLR ホストでは、追加操作を続行する前に、これらの戻り値を必ず調べる必要があります。  
+  
+-   CLR\_E\_SHIM\_RUNTIMELOAD  
+  
+-   CLR\_E\_SHIM\_RUNTIMEEXPORT  
+  
+-   CLR\_E\_SHIM\_INSTALLROOT  
+  
+-   CLR\_E\_SHIM\_INSTALLCOMP  
+  
+-   CLR\_E\_SHIM\_LEGACYRUNTIMEALREADYBOUND  
+  
+-   CLR\_E\_SHIM\_SHUTDOWNINPROGRESS  
+  
+## 初期化エラーの UI  
+ CLR アクティベーション システムがアプリケーションで必要なランタイムの正しいバージョンを読み込むことができない場合、ユーザーには、コンピューターがアプリケーションを実行するように正しく構成されていないことを示すエラー メッセージが表示され、この状況を解決できるようになります。  この状況では、通常、次のエラー メッセージが表示されます。  ユーザーは **\[はい\]** を選択すると、アプリケーションに適切な .NET Framework のバージョンをダウンロードできる Microsoft Web サイトに移動します。  
+  
+ ![.NET Framework 初期化エラー ダイアログ ボックス](../../../docs/framework/deployment/media/initerrordialog.png "InitErrorDialog")  
+初期化エラーの一般的なエラー メッセージ  
+  
+## 初期化エラーの解決  
+ 開発者には、.NET Framework の初期化エラー メッセージを制御するさまざまなオプションが用意されています。  たとえば、次のセクションで説明されているように、API フラグを使用してメッセージが表示されないようにすることができます。  ただし、要求されたランタイムがアプリケーションで読み込まれなかった問題を解決する必要があります。  そうしないと、アプリケーションがまったく実行されないか、一部の機能を利用できない可能性があります。  
+  
+ 基になる問題を解決し、最適なユーザー エクスペリエンスを提供する \(エラー メッセージの数を減らす\) には、次のことをお勧めします。  
+  
+-   .NET Framework 3.5 \(以前の\) アプリケーションの場合: .NET Framework 4 または 4.5 をサポートするようにアプリケーションを構成します \([手順](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)を参照\)。  
+  
+-   .NET Framework 4 アプリケーションの場合: アプリケーションのセットアップの一環として .NET Framework 4 再頒布可能パッケージをインストールします。  「[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)」を参照してください。  
+  
+## エラー メッセージの制御  
+ 要求された .NET Framework のバージョンが見つからなかったことを伝えるエラー メッセージを表示することは、ユーザーにとって役立つサービスであると見なされることもあれば、少し不快であると見なされることもあります。  いずれの場合も、アクティベーションの API にフラグを渡すことによってこの UI を制御できます。  
+  
+ [ICLRMetaHostPolicy::GetRequestedRuntime](../Topic/ICLRMetaHostPolicy::GetRequestedRuntime%20Method.md) メソッドは、入力として [METAHOST\_POLICY\_FLAGS](../../../ocs/framework/unmanaged-api/hosting/metahost-policy-flags-enumeration.md) 列挙型のメンバーを受け取ります。  METAHOST\_POLICY\_SHOW\_ERROR\_DIALOG フラグを含めると、CLR の要求されたバージョンが見つからない場合にエラー メッセージを要求することができます。  既定では、エラー メッセージは表示されません \([ICLRMetaHost::GetRuntime](../Topic/ICLRMetaHost::GetRuntime%20Method.md) メソッドは、このフラグを受け取らず、エラー メッセージを表示する他の方法を提供しません\)。  
+  
+ Windows には、プロセス内で実行するコードの結果としてエラー メッセージを表示するかどうかを宣言する際に使用できる [SetErrorMode](http://go.microsoft.com/fwlink/p/?LinkID=255242) 関数が用意されています。  SEM\_FAILCRITICALERRORS フラグを指定すると、エラー メッセージが表示されないようにすることができます。  
+  
+ ただし、一部のシナリオでは、アプリケーション プロセスで設定された SEM\_FAILCRITICALERRORS の設定をオーバーライドすることが重要です。  たとえば、CLR をホストし、SEM\_FAILCRITICALERRORS が設定されているプロセスでホストされるネイティブの COM コンポーネントがある場合、その特定のアプリケーション プロセス内でエラー メッセージを表示する影響に応じて、フラグをオーバーライドできます。  この場合、次のいずれかのフラグを使用して、SEM\_FAILCRITICALERRORS をオーバーライドできます。  
+  
+-   METAHOST\_POLICY\_IGNORE\_ERROR\_MODE は [ICLRMetaHostPolicy::GetRequestedRuntime](../Topic/ICLRMetaHostPolicy::GetRequestedRuntime%20Method.md) メソッドと共に使用します。  
+  
+-   RUNTIME\_INFO\_IGNORE\_ERROR\_MODE は [GetRequestedRuntimeInfo](../../../ocs/framework/unmanaged-api/hosting/getrequestedruntimeinfo-function.md) 関数と共に使用します。  
+  
+## CLR によって提供されているホストの UI ポリシー  
+ CLR にはさまざまなシナリオ向けの一連のホストが含まれています。それらすべてのホストでは、必要なバージョンのランタイムを読み込むときに問題が発生した場合にエラー メッセージを表示します。  次の表に、ホストとそのエラー メッセージ ポリシーの一覧を示します。  
+  
+|CLR ホスト|説明|エラー メッセージ ポリシー|エラー メッセージを無効にできるか|  
+|-------------|--------|--------------------|-----------------------|  
+|マネージ EXE ホスト|マネージ EXE を起動します。|.NET Framework のバージョンが見つからない場合に表示される|No|  
+|マネージ COM ホスト|マネージ COM コンポーネントをプロセスに読み込みます。|.NET Framework のバージョンが見つからない場合に表示される|はい \(SEM\_FAILCRITICALERRORS フラグを設定すると可能\)|  
+|ClickOnce ホスト|ClickOnce アプリケーションを起動します。|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降で、.NET Framework のバージョンが見つからない場合に表示される|No|  
+|XBAP ホスト|WPF XBAP アプリケーションを起動します。|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降で、.NET Framework のバージョンが見つからない場合に表示される|No|  
+  
+## [!INCLUDE[win8](../../../includes/win8-md.md)] の動作と UI  
+ CLR アクティベーション システムでは、他のバージョンの Windows オペレーティング システムで提供しているのと同じ動作と UI を [!INCLUDE[win8](../../../includes/win8-md.md)] でも提供しています。ただし、CLR 2.0 を読み込む際に問題が発生する場合は除きます。  [!INCLUDE[win8](../../../includes/win8-md.md)] には、CLR 4.5 を使用する [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] が含まれています。ただし、[!INCLUDE[win8](../../../includes/win8-md.md)] には CLR 2.0 を使用する .NET Framework 2.0、3.0、3.5 のいずれも含まれていません。  その結果、既定では、CLR 2.0 に依存するアプリケーションが [!INCLUDE[win8](../../../includes/win8-md.md)] で実行されません。  代わりに、ユーザーが .NET Framework 3.5 をインストールできるように、次のダイアログ ボックスが表示されます。  ユーザーは、コントロール パネルで .NET Framework 3.5 を有効にすることもできます。  両方のオプションの説明については、「[Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)」を参照してください。  
+  
+ ![Windows 8 に 3.5 をインストールするためのダイアログ ボックス](../../../docs/framework/deployment/media/installdialog.png "installdialog")  
+必要に応じた .NET Framework 3.5 のインストールのプロンプト  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、ユーザーのコンピューターの .NET Framework 4 \(CLR 4\) を置き換えます。  したがって、[!INCLUDE[win8](../../../includes/win8-md.md)] では、.NET Framework 4 アプリケーションはこのダイアログ ボックスを表示せずにシームレスに実行されます。  
+  
+ .NET Framework 3.5 がインストールされている場合、ユーザーは [!INCLUDE[win8](../../../includes/win8-md.md)] コンピューターで .NET Framework 2.0、3.0、または 3.5 に依存するアプリケーションを実行できます。  また、アプリケーションが .NET Framework 1.0 または 1.1 でのみ実行するように明示的に構成されていなければ、.NET Framework 1.0 および 1.1 のアプリケーションを実行することもできます。  「[.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)」を参照してください。  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、CLR アクティベーション ログは、初期化エラー メッセージが表示された日時とその理由を記録するログ エントリを含むように強化されています。  詳細については、「[方法: CLR のアクティブ化に関する問題をデバッグする](../../../docs/framework/deployment/how-to-debug-clr-activation-issues.md)」を参照してください。  
+  
+## 参照  
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)   
+ [方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)   
+ [方法: CLR のアクティブ化に関する問題をデバッグする](../../../docs/framework/deployment/how-to-debug-clr-activation-issues.md)   
+ [Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/media/closeapplicationdialog.png b/docs/framework/deployment/media/closeapplicationdialog.png
new file mode 100644
index 00000000000..b594214e452
Binary files /dev/null and b/docs/framework/deployment/media/closeapplicationdialog.png differ
diff --git a/docs/framework/deployment/media/compsbs.gif b/docs/framework/deployment/media/compsbs.gif
new file mode 100644
index 00000000000..363af5cba0b
Binary files /dev/null and b/docs/framework/deployment/media/compsbs.gif differ
diff --git a/docs/framework/deployment/media/initerrordialog.png b/docs/framework/deployment/media/initerrordialog.png
new file mode 100644
index 00000000000..519b597b827
Binary files /dev/null and b/docs/framework/deployment/media/initerrordialog.png differ
diff --git a/docs/framework/deployment/media/installdialog.png b/docs/framework/deployment/media/installdialog.png
new file mode 100644
index 00000000000..9cd41ff2601
Binary files /dev/null and b/docs/framework/deployment/media/installdialog.png differ
diff --git a/docs/framework/deployment/media/simplesbs.gif b/docs/framework/deployment/media/simplesbs.gif
new file mode 100644
index 00000000000..f327c6a2929
Binary files /dev/null and b/docs/framework/deployment/media/simplesbs.gif differ
diff --git a/docs/framework/deployment/net-framework-and-applications.md b/docs/framework/deployment/net-framework-and-applications.md
new file mode 100644
index 00000000000..8308af08d18
--- /dev/null
+++ b/docs/framework/deployment/net-framework-and-applications.md
@@ -0,0 +1,179 @@
+---
+title: ".NET Framework およびアプリケーションの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/14/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework アプリケーションの配置"
+  - ".NET Framework, 配置"
+  - "配置 (アプリケーションを) [.NET Framework] "
+  - "配置 (アプリケーションを) [.NET Framework] , 配布"
+  - "配置 (アプリケーションを) [.NET Framework] , 機能"
+  - "配置 (アプリケーションを) [.NET Framework] , パッケージ化"
+ms.assetid: 238d8284-6042-4a38-a7f6-1ee8efd719da
+caps.latest.revision: 56
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+---
+# .NET Framework およびアプリケーションの配置
+ここでは、アプリケーションと共に .NET Framework を配置する方法についての概要を示します。  情報のほとんどは、開発者、OEM、およびエンタープライズ管理者を対象としています。  コンピューターに .NET Framework をインストールするユーザーは、「[Installing the .NET Framework 4.5 \(.NET Framework 4.5 のインストール\)](../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+## 主な配置リソース  
+ .NET Framework の配置とサービスの詳細については、次に示す他の MSDN トピックへのリンク先を参照してください。  
+  
+ **セットアップと配置**  
+  
+-   インストーラーと配置についての一般的な情報:  
+  
+    -   インストーラー オプション:  
+  
+        -   [Web インストーラー](../../../docs/framework/install/guide-for-developers.md#choices)  
+  
+        -   [オフライン インストーラー](../../../docs/framework/install/guide-for-developers.md#choices)  
+  
+    -   インストール モード:  
+  
+        -   [サイレント インストール](../../../docs/framework/deployment/deployment-guide-for-developers.md#chaining_custom)  
+  
+        -   [UI の表示](../../../docs/framework/deployment/deployment-guide-for-developers.md#chaining_default)  
+  
+    -   [.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)  
+  
+    -   [ブロックされた .NET Framework インストールのトラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)  
+  
+-   .NET Framework とクライアント アプリケーションの配置 \(開発者向け\):  
+  
+    -   セットアップと配置プロジェクトでの [InstallShield の使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#installshield)  
+  
+    -   [Visual Studio の ClickOnce アプリケーションの使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#clickonce)  
+  
+    -   [WiX インストール パッケージの作成](../../../docs/framework/deployment/deployment-guide-for-developers.md#wix)  
+  
+    -   [カスタム インストーラーの使用](../../../docs/framework/deployment/deployment-guide-for-developers.md#chaining)  
+  
+    -   開発者向けの[追加情報](../../../docs/framework/deployment/deployment-guide-for-developers.md)  
+  
+-   .NET Framework の配置 \(OEM と管理者向け\):  
+  
+    -   [Windows Assessment and Deployment Kit \(ADK\) \(Windows アセスメント & デプロイメント キット \(ADK\)\)](http://go.microsoft.com/fwlink/p/?LinkId=254976)  
+  
+    -   [管理者ガイド](../../../docs/framework/deployment/guide-for-administrators.md)  
+  
+ **サービス**  
+  
+-   一般情報については、[.NET Framework blog \(.NET Framework ブログ\)](http://go.microsoft.com/fwlink/p/?LinkId=254977) を参照してください。  
+  
+-   [バージョンの検出](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)  
+  
+-   [Service Pack と更新プログラムの検出](../../../docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md)  
+  
+## 配置を簡素化する機能  
+ .NET Framework には、アプリケーションを簡単に配置できるようにするための基本機能が数多く用意されています。  
+  
+-   ゼロインパクト アプリケーション  
+  
+     この機能は、アプリケーションを分離し、DLL の競合を解消します。  既定では、コンポーネントはほかのアプリケーションに影響を与えません。  
+  
+-   プライベート コンポーネント \(既定\)  
+  
+     既定では、コンポーネントはアプリケーション ディレクトリに配置され、コンテナー アプリケーションだけで参照できます。  
+  
+-   制御コードの共有  
+  
+     コードを共有するには、既定の動作を実行する代わりに、共有するためのコードを明示的に作成する必要があります。  
+  
+-   side\-by\-side でのバージョン管理。  
+  
+     コンポーネントまたはアプリケーションの複数のバージョンを共存させ、使用するバージョンを選択できます。共通言語ランタイムによって、バージョン管理ポリシーが適用されます。  
+  
+-   XCOPY による配置およびレプリケーション  
+  
+     自己言及的な、単体で使用できるコンポーネントやアプリケーションは、レジストリ エントリや依存関係を設定せずに配置できます。  
+  
+-   実行時更新  
+  
+     管理者は、ASP.NET などのホストを使用してプログラムの DLL を更新できます。リモート コンピューター上の DLL も更新できます。  
+  
+-   Windows インストーラーとの統合  
+  
+     アプリケーションを配置するときに、通知、発行、修復、およびオンデマンド インストールのすべてを使用できます。  
+  
+-   エンタープライズ配置  
+  
+     この機能を使用すると、Active Directory を使用する場合など、ソフトウェアの配布を簡単に行うことができます。  
+  
+-   ダウンロードとキャッシュ  
+  
+     インクリメンタル ダウンロードにより、ダウンロードのサイズを小さくすることができます。また、コンポーネントを分離して、そのアプリケーションだけで使用されるようにし、配置の影響を抑えることができます。  
+  
+-   完全な権利を与えられていないコード  
+  
+     ID は、ユーザーではなく、コードに基づきます。証明書関連のダイアログ ボックスは表示されません。  
+  
+## .NET Framework アプリケーションのパッケージ化と配布  
+ .NET Framework でのパッケージ化および配置についての情報の一部は、ドキュメントの別のトピックで説明します。  それらのトピックでは、レジストリ エントリを必要としない[アセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)と呼ばれる自己言及的な単位、名前の一意性を保証し、名前の悪用を防止する[厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)、および DLL 競合に関連した問題の多くを解決する[アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)についての情報を提供します。  以下のセクションでは、.NET Framework アプリケーションのパッケージ化および配布について説明します。  
+  
+### パッケージ化  
+ .NET Framework は、アプリケーション パッケージ化のために、次のオプションを提供します。  
+  
+-   単一のアセンブリまたはアセンブリのコレクションとしてパッケージ化する。  
+  
+     このオプションでは、.dll ファイルまたは .exe ファイルは既に作成されているため、単に使用するだけです。  
+  
+-   キャビネット \(CAB\) ファイルとしてパッケージ化する。  
+  
+     このオプションでは、配布やダウンロードの時間を短縮するために、ファイルを .cab ファイルに圧縮します。  
+  
+-   Windows インストーラー パッケージとして、またはその他のインストーラー フォーマットでパッケージ化する。  
+  
+     このオプションでは、Windows インストーラーで使用する .msi ファイルを作成するか、または他のインストーラー用としてアプリケーションをパッケージ化します。  
+  
+### 配布  
+ .NET Framework には、アプリケーション配布のために、次のオプションが用意されています。  
+  
+-   XCOPY または FTP を使用する。  
+  
+     共通言語ランタイム アプリケーションは、自己言及的で、レジストリ エントリを必要としないため、XCOPY または FTP を使用して適切なディレクトリに単純にコピーできます。  その後、そのディレクトリでアプリケーションを実行できます。  
+  
+-   コードのダウンロードを使用する。  
+  
+     アプリケーションをインターネットや企業のイントラネットに配布する場合は、コードをコンピューターにダウンロードし、そこでアプリケーションを実行できます。  
+  
+-   Windows Installer 2.0 などのインストーラー プログラムを使用する。  
+  
+     Windows インストーラー 2.0 を使用して、グローバル アセンブリ キャッシュおよびプライベート ディレクトリへの .NET Framework アセンブリのインストール、修復、または削除を行うことができます。  
+  
+### インストール先  
+ ランタイムがアプリケーションのアセンブリを検索できるようなアセンブリの配置先については、「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+ アプリケーションの配置方法には、セキュリティの考慮事項も関係します。  コードが存在する場所に基づいて、マネージ コードにセキュリティ アクセス許可が付与されます。  インターネットなど、信頼度の低い場所にアプリケーションやコンポーネントを配置すると、そのアプリケーションやコンポーネントが実行できることは制限されます。  配置とセキュリティ上の考慮事項については、「[コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)|共通言語ランタイムが、バインド要求を満たすために、使用するアセンブリをどのように特定するかを説明します。|  
+|[アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)|<xref:System.InvalidCastException>、<xref:System.MissingMethodException>、およびその他のエラーの原因となることがある型 ID の問題を回避する方法について説明します。|  
+|[.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)|再起動をできる限り回避する再起動マネージャーと、.NET Framework をインストールするアプリケーションがそれをどのように利用できるかを説明しています。|  
+|[配置ガイド \(管理者向け\)](../../../docs/framework/deployment/guide-for-administrators.md)|System Center Configuration Manager \(SCCM\) を使用したシステム管理者による .NET Framework の配置方法と、ネットワーク全体でのシステムの依存関係について説明します。|  
+|[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)|開発者による .NET Framework とアプリケーションのユーザーのコンピューターへのインストール方法について説明します。|  
+|[アプリケーション、サービス、およびコンポーネントの配置](../Topic/Deploying%20Applications,%20Services,%20and%20Components.md)|ClickOnce を使用したアプリケーションの発行手順や、Windows インストーラー テクノロジなど、Visual Studio の配置オプションについて説明します。|  
+|[ClickOnce アプリケーションの発行](../Topic/Publishing%20ClickOnce%20Applications.md)|Windows フォーム アプリケーションをパッケージ化し、これを ClickOnce でネットワーク上のクライアント コンピューターに配置する方法を説明します。|  
+|[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)|.NET Framework でリソースのパッケージ化と配置に使用する、ハブ アンド スポーク モデルについて説明します。リソースの名前付け規則、フォールバック プロセス、およびパッケージ化の代替策についても説明します。|  
+|[相互運用アプリケーションの配置](../../../docs/framework/interop/deploying-an-interop-application.md)|相互運用アプリケーションの出荷方法とインストール方法について説明します。通常、相互運用アプリケーションには、.NET Framework クライアント アセンブリ、個別の COM タイプ ライブラリを表す 1 つ以上の相互運用機能アセンブリ、および 1 つ以上の登録済み COM コンポーネントが含まれています。|  
+|[方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)|進行状況のビューを独自に表示する一方で、.NET Framework セットアップ プロセスをサイレントで起動および追跡する方法を説明します。|  
+  
+## 参照  
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/net-framework-applications.md b/docs/framework/deployment/net-framework-applications.md
new file mode 100644
index 00000000000..4cc7a5e772d
--- /dev/null
+++ b/docs/framework/deployment/net-framework-applications.md
@@ -0,0 +1,38 @@
+---
+title: ".NET Framework アプリケーションの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 配置 (アプリを)"
+  - "配置 (アプリケーションを) [.NET Framework] "
+ms.assetid: 139d4cb1-5972-40f4-bdd8-1ce68e4dfb80
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# .NET Framework アプリケーションの配置
+.NET Framework ドキュメントの本セクションでは、アセンブリの読み込み、アセンブリ参照の解決、およびネイティブ イメージの生成を使用したアプリケーションのパフォーマンス向上のためのガイドラインなど、.NET Framework アプリケーションを配置するための重要な情報を提供します。  
+  
+## このセクションの内容  
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)  
+ 共通言語ランタイムが、アプリケーションを構成するアセンブリを検出し、バインドする方法について説明します。  
+  
+ [アセンブリの読み込みのベスト プラクティス](../../../docs/framework/deployment/best-practices-for-assembly-loading.md)  
+ <xref:System.InvalidCastException>、<xref:System.MissingMethodException>、およびその他のエラーの原因となることがある型 ID の問題を回避する方法について説明します。  
+  
+## 参照  
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/reducing-system-restarts.md b/docs/framework/deployment/reducing-system-restarts.md
new file mode 100644
index 00000000000..1018615d3b5
--- /dev/null
+++ b/docs/framework/deployment/reducing-system-restarts.md
@@ -0,0 +1,50 @@
+---
+title: ".NET Framework 4.5 のインストール中のシステム再起動の削減 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 削減 (システム再起動数を)"
+  - "インストール [.NET Framework]"
+  - "インストール (.NET Framework の)"
+ms.assetid: 7aa8cb72-dee9-4716-ac54-b17b9ae8218f
+caps.latest.revision: 18
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# .NET Framework 4.5 のインストール中のシステム再起動の削減
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] インストーラーは[再起動マネージャー](http://go.microsoft.com/fwlink/?LinkId=231425)を使用して、インストール中のシステムの再起動をできる限り回避します。  アプリケーションのセットアップ プログラムで .NET Framework をインストールする場合は、再起動マネージャーとやり取りしてこの機能を利用できます。  詳細については、「[方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)」を参照してください。  
+  
+## 再起動の理由  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のインストールにおいて、.NET Framework 4 アプリケーションがインストール中に使用されている場合は、システムの再起動が必要になります。  これは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] が .NET Framework 4 のファイルを置き換え、インストール中にこれらのファイルが使用可能になっている必要があるためです。  多くの場合、再起動は使用中の .NET Framework 4 アプリケーションをプリエンティブに検出し、終了することで回避できます。  ただし、一部のシステム アプリケーションは終了しないでください。  このような場合、再起動は回避できません。  
+  
+## エンド ユーザー エクスペリエンス  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の完全インストールを行っているエンド ユーザーには、使用中の .NET Framework 4 アプリケーションをインストーラーが検出した場合にシステムの再起動を回避する機会が与えられます。  メッセージには、実行中の .NET Framework 4 アプリケーションがすべて一覧表示され、インストール前にこれらのアプリケーションを終了するオプションが表示されます。  ユーザーが終了を確認すると、これらのアプリケーションはインストーラーによってシャットダウンされ、システムの再起動が回避されます。  一定時間内にユーザーがメッセージに応答しなかった場合、インストールはアプリケーションを終了せずに続行します。  
+  
+ 実行中のアプリケーションが終了してもシステムの再起動が必要な状況を再起動マネージャーが検出した場合、メッセージは表示されません。  
+  
+ ![&#91;アプリケーションの終了&#93; ダイアログ](../../../docs/framework/deployment/media/closeapplicationdialog.png "CloseApplicationDialog")  
+使用中の .NET Framework アプリケーションを終了するためのプロンプト  
+  
+## チェーンされたインストーラーの使用  
+ アプリケーションと共に .NET Framework を再配布し、ただし独自のセットアップ プログラムと UI を使用する場合は、.NET Framework のセットアップ プロセスをセットアップ プロセスにインクルード \(チェーン\) できます。  チェーンされたインストールの詳細については、「[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)」を参照してください。  チェーンされたインストールでのシステムの再起動を減らすために、.NET Framework インストーラーは、終了するアプリケーションの一覧をセットアップ プログラムに提示します。  セットアップ プログラムは、メッセージ ボックスなどのユーザー インターフェイスを経由してこの情報をユーザーに提供し、ユーザーの応答を取得して、応答を .NET Framework インストーラーに渡す必要があります。  チェーンされたインストーラーの例については、「[方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)」を参照してください。  
+  
+ チェーンされたインストーラーを使用しているときに、終了するアプリケーションに対して独自のメッセージ ボックスを非表示にする場合は、.NET Framework セットアップ プロセスをチェーンするときに、コマンド ラインで `/showrmui` と `/passive` のオプションを使用できます。  これらのオプションを一緒に使用すると、システムの再起動を避けるために終了できるアプリケーションを閉じるためのメッセージ ボックスがインストーラーによって表示されます。  このメッセージ ボックスは、完全なユーザー インターフェイスの下でも、パッシブ モードでも同じように動作します。  .NET Framework 再頒布可能パッケージのコマンドライン オプションの完全なセットについては、『[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)』を参照してください。  
+  
+## 参照  
+ [配置](../../../docs/framework/deployment/net-framework-and-applications.md)   
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)   
+ [方法: .NET Framework 4.5 インストーラーの進行状況を表示する](../../../docs/framework/deployment/how-to-get-progress-from-the-dotnet-installer.md)
\ No newline at end of file
diff --git a/docs/framework/deployment/side-by-side-execution.md b/docs/framework/deployment/side-by-side-execution.md
new file mode 100644
index 00000000000..d4673ef1a21
--- /dev/null
+++ b/docs/framework/deployment/side-by-side-execution.md
@@ -0,0 +1,135 @@
+---
+title: ".NET Framework での side-by-side 実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "side-by-side 実行"
+ms.assetid: 649f1342-766b-49e6-a90d-5b019a751e11
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# .NET Framework での side-by-side 実行
+side\-by\-side 実行は、アプリケーションまたはコンポーネントの複数のバージョンを同じコンピューターで実行する機能です。  共通言語ランタイムの複数のバージョン、および 1 つの共通言語ランタイムを使用するアプリケーションとコンポーネントの複数のバージョンを同じコンピューターで同時に実行できます。  
+  
+ 共通言語ランタイムの 2 つの異なるバージョンを同じコンピューターで使用する複数のアプリケーションを次の図に示します。  アプリケーション A、B、および C はランタイム バージョン 1.0 を使用し、アプリケーション D はランタイム バージョン 1.1 を使用します。  
+  
+ ![side&#45;by&#45;side 実行](../../../docs/framework/deployment/media/simplesbs.gif "simplesbs")  
+ランタイムの 2 つのバージョンの side\-by\-side 実行  
+  
+ .NET Framework は、共通言語ランタイムと API 型を含むアセンブリのコレクションで構成されています。  ランタイムと .NET Framework アセンブリは、個別にバージョン管理されます。  たとえば、ランタイムのバージョン 4.0 は実際にはバージョン 4.0.319 で、.NET Framework アセンブリのバージョン 1.0 はバージョン 1.0.3300.0 です。  
+  
+ コンポーネントの 2 つの異なるバージョンを同じコンピューターで使用する複数のアプリケーションを次の図に示します。  アプリケーション A とアプリケーション B はコンポーネントのバージョン 1.0 を使用し、アプリケーション C は同じコンポーネントのバージョン 2.0 を使用します。  
+  
+ ![side&#45;by&#45;side 実行](../../../docs/framework/deployment/media/compsbs.gif "compsbs")  
+コンポーネントの 2 つのバージョンの side\-by\-side 実行  
+  
+ side\-by\-side 実行により、アプリケーションがバインドするコンポーネントのバージョンやアプリケーションが使用するランタイムのバージョンをより詳細に制御できます。  
+  
+## side\-by\-side 実行の利点  
+ Windows XP および .NET Framework 以前では、アプリケーションは同じコードの非互換バージョンを識別できないため、DLL の競合が発生することがありました。  DLL に含まれる型情報は、ファイル名だけに関連付けられていました。  アプリケーションは、DLL に含まれている型とアプリケーションの作成に使用された型が同じであるかどうかを判断できませんでした。  この結果、新しいバージョンのコンポーネントが古いバージョンを書き変え、アプリケーションが壊れてしまうことがありました。  
+  
+ side\-by\-side 実行と .NET Framework によって、DLL の競合を防ぐ次の機能が得られます。  
+  
+-   厳密な名前付きアセンブリ  
+  
+     side\-by\-side 実行機能は、厳密な名前付きアセンブリを使用して、型情報をアセンブリの特定のバージョンにバインドします。  これによって、アプリケーションまたはコンポーネントが、アセンブリの無効なバージョンをバインドするのを防げます。  また、厳密な名前付きアセンブリによって、1 つのファイルの複数のバージョンが同じコンピューター上に存在することが可能で、アプリケーションはこれらを使用できます。  詳細については、「[厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)」を参照してください。  
+  
+-   バージョンを認識するコード ストレージ  
+  
+     .NET Framework のグローバル アセンブリ キャッシュには、バージョンを認識するコード ストレージが用意されています。  グローバル アセンブリ キャッシュは、コンピューター全体にわたるコード キャッシュで、.NET Framework がインストールされているすべてのコンピューターに存在します。  グローバル アセンブリ キャッシュは、バージョン、カルチャ、発行者の情報に基づいてアセンブリを格納し、コンポーネントおよびアプリケーションの複数バージョンをサポートします。  詳細については、「[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)」を参照してください。  
+  
+-   分離  
+  
+     .NET Framework を使用すると、分離して実行できるアプリケーションとコンポーネントを作成できます。  分離は、side\-by\-side 実行に欠くことのできない構成要素です。  分離には、使用しているリソースを認識し、アプリケーションまたはコンポーネントの複数のバージョンでこれを確実に共有する処理も含まれます。  また、分離には、バージョンに固有の方法でファイルを格納する方法も含まれます。  分離の詳細については、「[side\-by\-side 実行用のコンポーネントを作成するためのガイドライン](../../../docs/framework/deployment/guidelines-for-creating-components-for-side-by-side-execution.md)」を参照してください。  
+  
+## バージョンの互換性  
+ .NET Framework Version 1.0 と 1.1 は互換性を持つようにデザインされています。  .NET Framework Version 1.0 で作成されたアプリケーションはバージョン 1.1 で動作し、.NET Framework Version 1.1 で作成されたアプリケーションはバージョン 1.0 で動作する必要があります。  ただし、.NET Framework Version 1.1 で追加された API 機能は、.NET Framework Version 1.0 では動作しません。  .NET Framework Version 2.0 で作成されたアプリケーションは .NET Framework Version 2.0 でのみ動作します。  .NET Framework Version 2.0 で作成されたアプリケーションは、Version 1.1 以前では動作しません。  
+  
+ .NET Framework のバージョンは、ランタイムとそれに対応する .NET Framework アセンブリで構成される単一のユニットとして扱われます。この概念をアセンブリの統一と呼んでいます。  他のバージョンの .NET Framework アセンブリを含むようにアセンブリ バインディングをリダイレクトすることもできますが、既定のアセンブリ バインディングのオーバーライドは危険性が伴うため、配置する前に厳密なテストが必要です。  
+  
+## ランタイム バージョン情報の検索  
+ アプリケーションまたはコンポーネントのコンパイルに使用したランタイム バージョンおよびアプリケーションの実行時に必要なランタイム バージョンは、2 つの場所に格納されています。  アプリケーションまたはコンポーネントをコンパイルするとき、コンパイルに使用したランタイム バージョンの情報がマネージ実行可能ファイルに格納されます。  アプリケーションまたはコンポーネントが要求するランタイム バージョンの情報は、アプリケーション構成ファイルに格納されています。  
+  
+### マネージ実行可能ファイルのランタイム バージョン情報  
+ 各マネージ アプリケーションおよびマネージ コンポーネントのポータブル実行可能 \(PE\) ファイル ヘッダーには、その作成に使用されたランタイム バージョンに関する情報が含まれています。  共通言語ランタイムは、この情報に基づいて、アプリケーションの実行に必要なランタイムの最も適したバージョンを決定します。  
+  
+### アプリケーション構成ファイルのランタイム バージョン情報  
+ PE ファイル ヘッダーの情報に加え、アプリケーションは、ランタイム バージョン情報が含まれるアプリケーション構成ファイルと共に配置できます。  アプリケーション構成ファイルは XML ベースのファイルで、アプリケーションの開発者によって作成され、アプリケーションと共に出荷されます。  [\<RequiredRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md)の [\<startup\> セクション](../../../docs/framework/configure-apps/file-schema/startup/startup-element.md) \(このファイル内に存在する場合\) に、アプリケーションでサポートするランタイムのバージョンとコンポーネントのバージョンを指定します。  また、このファイルを使用して、ランタイムの別のバージョンとアプリケーションの互換性をテストすることができます。  
+  
+ COM アプリケーションおよび COM\+ アプリケーションを含むアンマネージ コードは、ランタイムがマネージ コードとやり取りするときに使用するアプリケーション構成ファイルを持つことができます。  アプリケーション構成ファイルは、COM 経由で起動するどのマネージ コードにも適用されます。  このファイルは、サポートするランタイム バージョンやアセンブリのリダイレクトを指定できます。  既定では、マネージ コードを呼び出す COM 相互運用アプリケーションは、コンピューターにインストールされている最新のバージョンを使用します。  
+  
+ アプリケーション構成ファイルの詳細については、「[アプリの構成](../../../docs/framework/configure-apps/index.md)」を参照してください。  
+  
+## 読み込むランタイム バージョンの決定  
+ 共通言語ランタイムは、次の情報を使用して、アプリケーションのために読み込むランタイム バージョンを決定します。  
+  
+-   利用できるランタイム バージョン  
+  
+-   アプリケーションがサポートするランタイム バージョン  
+  
+### サポートされているランタイム バージョン  
+ ランタイムは、アプリケーション構成ファイルとポータブル実行可能 \(PE\) ファイル ヘッダーを使用して、アプリケーションがサポートするランタイムのバージョンを決定します。  アプリケーション構成ファイルが存在しない場合、ランタイムはアプリケーションの PE ファイル ヘッダーで指定されているランタイム バージョンを読み込みます。ただし、このバージョンが利用できる場合です。  
+  
+ アプリケーション構成ファイルが存在する場合は、次のプロセスの結果に基づいて、ランタイムは読み込むランタイムの適切なバージョンを決定します。  
+  
+1.  ランタイムは、アプリケーション構成ファイルの [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素を調べます。  **\<supportedRuntime\>** 要素で指定されたサポートされるランタイム バージョンが 1 つ以上が見つかった場合、ランタイムは最初の **\<supportedRuntime\>** 要素で指定されているランタイム バージョンを読み込みます。  このバージョンが利用できない場合、ランタイムは **\<supportedRuntime\>** の次の要素を調べ、指定されているランタイム バージョンを読み込むようにしようとします。  このランタイム バージョンが利用できない場合は、**\<supportedRuntime\>** の後続の要素を調べます。  サポートされるランタイム バージョンがどれも利用できない場合、ランタイムはランタイム バージョンの読み込みに失敗し、ユーザーに対してメッセージが表示されます \(手順 3. 参照\)。  
+  
+2.  ランタイムはアプリケーションの実行可能ファイルの PE ファイル ヘッダーを読み込みます。  PE ファイル ヘッダーで指定されたランタイム バージョンが利用できる場合、ランタイムはこのバージョンを読み込みます。  指定されたランタイム バージョンが利用できない場合は、PE ヘッダーのランタイム バージョンと互換性があると Microsoft によって決められたランタイム バージョンがランタイムによって検索されます。  このバージョンが見つからない場合、プロセスは手順 3. に進みます。  
+  
+3.  ランタイムは、アプリケーションがサポートしているランタイム バージョンが利用できないことを示すメッセージを表示します。  ランタイムは読み込まれません。  
+  
+    > [!NOTE]
+    >  このメッセージが表示されないようにするには、レジストリ キー HKLM\\Software\\Microsoft\\.NETFramework の値 NoGuiFromShim を使用するか、環境変数 COMPLUS\_NoGuiFromShim を使用します。  たとえば、無人インストールや Windows サービスなど、一般にはユーザーとの対話が不要なアプリケーションの場合、このメッセージを抑制できます。  このメッセージを抑制すると、ランタイムによって、イベント ログにメッセージが書き込まれます。  レジストリ値 NoGuiFromShim を 1 に設定すると、コンピューター上のすべてのアプリケーションで、このメッセージが抑制されます。  別の方法として、COMPLUS\_NoGuiFromShim 環境変数を 1 に設定すると、特定のユーザー コンテキストで実行されるアプリケーションについてメッセージを抑制できます。  
+  
+> [!NOTE]
+>  ランタイム バージョンが読み込まれた後、アセンブリ バインディングのリダイレクトによって、.NET Framework アセンブリの異なるバージョンを読み込むように指定されることがあります。  これらのバインディングのリダイレクトは、リダイレクトされた特定のアセンブリだけに影響します。  
+  
+## 部分修飾アセンブリ名と side\-by\-side 実行  
+ 部分限定アセンブリ参照は、side\-by\-side 実行の潜在的な問題の原因となり得るので、アプリケーション ディレクトリ内のアセンブリへのバインドだけで使用します。  開発するコード内では、部分限定アセンブリ参照は使用しないでください。  
+  
+ コードの部分修飾アセンブリ参照を軽減するには、アプリケーション構成ファイルで完全にコード内で発生する部分修飾アセンブリ参照を修飾するために [\<qualifyAssembly\>](../../../docs/framework/configure-apps/file-schema/runtime/qualifyassembly-element.md) 要素を使用できます。  部分参照に設定されていないフィールドだけを指定するために **\<qualifyAssembly\>** 要素を使用します。  **fullName** 属性で指定されているアセンブリ ID には、アセンブリ名を完全に修飾するのに必要なすべての情報 \(つまり、アセンブリ名、公開キー、カルチャ、およびバージョン\) が含まれている必要があります。  
+  
+ `myAssembly` というアセンブリを完全に修飾する、アプリケーション構成ファイルのエントリの例を次に示します。  
+  
+```  
+<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">   
+<qualifyAssembly partialName="myAssembly"   
+fullName="myAssembly,  
+      version=1.0.0.0,   
+publicKeyToken=...,   
+      culture=neutral"/>   
+</assemblyBinding>   
+```  
+  
+ アセンブリの読み込みステートメントが `myAssembly` を参照するたびに、構成ファイルのこれらの設定により、ランタイムは部分修飾された `myAssembly` 参照を完全限定参照に自動的に変換します。  たとえば、Assembly.Load\("myAssembly"\) は Assembly.Load\("myAssembly, version\=1.0.0.0, publicKeyToken\=..., culture\=neutral"\) に変換されます。  
+  
+> [!NOTE]
+>  **LoadWithPartialName** メソッドを使用すると、グローバル アセンブリ キャッシュから部分参照アセンブリを読み込むのを禁止する共通言語ランタイムの制限をバイパスできます。  このメソッドは、side\-by\-side 実行で問題になりやすいので、リモート処理のシナリオだけで使用してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)|アプリケーションをアセンブリの特定のバージョンにバインドする方法について説明します。|  
+|[アセンブリ バインディングのリダイレクトの構成](../../../docs/framework/deployment/configuring-assembly-binding-redirection.md)|.NET Framework アセンブリの特定のバージョンへのアセンブリ バインドの参照をリダイレクトする方法について説明します。|  
+|[インプロセスの side\-by\-side 実行](../../../docs/framework/deployment/in-process-side-by-side-execution.md)|インプロセスのランタイム ホストの並行アクティブ化を使用して、1 つのプロセスで複数のバージョンの CLR を実行する方法について説明します。|  
+|[共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)|アセンブリの概念的な概要を説明します。|  
+|[アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)|アプリケーション ドメインの概念的な概要を説明します。|  
+  
+## 参照  
+ [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)
\ No newline at end of file
diff --git a/docs/framework/develop-client-apps.md b/docs/framework/develop-client-apps.md
new file mode 100644
index 00000000000..6daf5e4b2ac
--- /dev/null
+++ b/docs/framework/develop-client-apps.md
@@ -0,0 +1,64 @@
+---
+title: ".NET Framework を使用したクライアント アプリケーションの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET アプリケーション, Windows アプリケーション"
+  - "アプリケーション [Windows フォーム]"
+  - "クライアント アプリケーション サービス"
+  - "クライアント/サーバー アプリケーション, Windows アプリケーション"
+  - "リッチ クライアント アプリケーション"
+  - "Visual Basic コード, 作成 (アプリケーションを)"
+  - "Visual C#, 作成 (アプリケーションを)"
+  - "Windows アプリケーション"
+  - "Windows Presentation Foundation, Visual Studio で"
+  - "WPF, Visual Studio で"
+ms.assetid: 2dfb50b7-5af2-4e12-9bbb-c5ade0e39a68
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# .NET Framework を使用したクライアント アプリケーションの開発
+ユーザーのコンピューターやデバイスでローカルに動作する .NET Framework で、Windows ベースのアプリケーションを開発する方法はいくつかあります。  このセクションには、Windows Presentation Foundation \(WPF\) または Windows Forms を使用して Windows ベースのアプリケーションを作成する方法について説明しているトピックがあります。  ただし、.NET Framework を使用してクライアント アプリケーションを作成し、コンピューターやデバイスの Windows ストアおよび Windows Phone ストア、ブラウザーで表示できる Web アプリケーションを介してユーザーに提供することができます。  
+  
+## このセクションの内容  
+ [Windows Presentation Foundation](../../docs/framework/wpf/index.md)  
+ WPF を使用したアプリケーション開発の詳細について説明します。  
+  
+ [Windows フォーム](../../docs/framework/winforms/index.md)  
+ Windows フォームを使用したアプリケーション開発の詳細について説明します。  
+  
+ [共通クライアント技術](../../docs/framework/common-client-technologies/index.md)  
+ クライアント アプリケーションを開発する場合に使用できる、その他の方法について説明します。  
+  
+## 関連項目  
+ [Windows ストア アプリ](http://msdn.microsoft.com/windows/apps/)  
+ Windows ストアを介してユーザーが利用できるアプリを作成する方法について説明します。  
+  
+ [Windows ストア アプリ用 .NET の概要](http://msdn.microsoft.com/library/windows/apps/br230302.aspx)  
+ Windows コンピューターとデバイスに展開できるストア アプリ用 .NET Framework のサポートについて説明します。  
+  
+ [Windows Phone Silverlight の .NET API](http://msdn.microsoft.com/library/windows/apps/xaml/jj207211\(v=vs.105\).aspx)  
+ Windows Phone Silverlight を使用したアプリを構築するために利用できる .NET Framework API の一覧を示します。  
+  
+ [複数のプラットフォームの開発](../../docs/standard/cross-platform/index.md)  
+ 複数の種類のクライアント アプリを対象にするために .NET Framework を使用できるさまざまな方法について説明します。  
+  
+ [Get Started with ASP.NET Web Sites](http://www.asp.net/get-started/websites)  
+ ASP.NET を使用して Web アプリを開発する方法について説明します。  
+  
+## 参照  
+ [汎用性のあるクラス ライブラリ](../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md)   
+ [概要](../../docs/framework/get-started/overview.md)   
+ [開発ガイド](../../docs/framework/development-guide.md)   
+ [方法: Windows デスクトップ アプリケーションの作成](../Topic/How%20to:%20Create%20a%20Windows%20Desktop%20Application.md)   
+ [Windows Service Applications](../../docs/framework/windows-services/index.md)
\ No newline at end of file
diff --git a/docs/framework/develop-web-apps-with-aspnet.md b/docs/framework/develop-web-apps-with-aspnet.md
new file mode 100644
index 00000000000..398684d4ecb
--- /dev/null
+++ b/docs/framework/develop-web-apps-with-aspnet.md
@@ -0,0 +1,35 @@
+---
+title: "ASP.NET での Web アプリケーションの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-webforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, ASP.NET"
+  - "ASP.NET"
+  - "動的な Web アプリケーション [ASP.NET]"
+ms.assetid: b7861df0-690a-4a58-bd12-f9d0123e40df
+caps.latest.revision: 14
+author: "tdykstra"
+ms.author: "tdykstra"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ASP.NET での Web アプリケーションの開発
+ASP.NET は、Web アプリを作成するための .NET Framework テクノロジです。  ASP.NET のドキュメントは、MSDN ライブラリの「[Web 開発](http://go.microsoft.com/fwlink/p/?LinkID=235794)」セクションと、[www.asp.net の Web サイト](http://go.microsoft.com/fwlink/p/?LinkId=251042)にあります。  参照用の関連リンクを以下に示します。  
+  
+-   [ASP.NET および Web 対応の Visual Studio](../Topic/ASP.NET%20and%20Visual%20Studio%20for%20Web.md)  
+  
+-   [ASP.NET MVC](http://go.microsoft.com/fwlink/p/?LinkID=227227)  
+  
+-   [ASP.NET Web ページ](http://go.microsoft.com/fwlink/p/?LinkId=251040)  
+  
+-   [ASP.NET Web API](http://go.microsoft.com/fwlink/p/?LinkId=251041)  
+  
+## 参照  
+ [開発ガイド](../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/development-guide.md b/docs/framework/development-guide.md
new file mode 100644
index 00000000000..d271efd63e5
--- /dev/null
+++ b/docs/framework/development-guide.md
@@ -0,0 +1,91 @@
+---
+title: ".NET Framework の開発ガイド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, 開発ガイド"
+ms.assetid: 26e3d285-24c3-435c-a797-9fe5affb8525
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# .NET Framework の開発ガイド
+ここでは、.NET Framework アプリの作成、構成、デバッグ、保護、および配置を行う方法について説明します。  また、動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理などの技術領域に関する情報も提供します。  
+  
+## このセクションの内容  
+ [アプリケーションの基本事項](../../docs/standard/application-essentials.md)  
+ アプリ ドメインとアセンブリを利用したプログラミング、属性の使用、基本型の書式指定と解析、コレクションの使用、イベントおよび例外の処理、ファイルおよびデータ ストリームの使用、ジェネリックの使用など、基本的なアプリ開発タスクについて説明します。  
+  
+ [データとモデリング](../../docs/framework/data/index.md)  
+ ADO.NET、統合言語クエリ \(LINQ: Language\-Integrated Query\)、WCF Data Services、および XML を使用してデータにアクセスする方法について説明します。  
+  
+ [クライアント アプリケーション](../../docs/framework/develop-client-apps.md)  
+ Windows Presentation Foundation \(WPF\) または Windows フォームを使用して Windows ベースのアプリを作成する方法について説明します。  
+  
+ [ASP.NET を使用した Web アプリケーション](../../docs/framework/develop-web-apps-with-aspnet.md)  
+ ASP.NET を使用して最小限のコーディングでエンタープライズ クラスの Web アプリケーションを構築する方法に関する情報へのリンクを示します。  
+  
+ [WCF を使用したサービス指向アプリケーション](../../docs/framework/wcf/developing-service-oriented-applications-with-wcf.md)  
+ Windows Communication Foundation \(WCF\) を使用して、安全で信頼できるサービス指向のアプリを構築する方法について説明します。  
+  
+ [Windows Service Applications](../../docs/framework/windows-services/index.md)  
+ Visual Studio および .NET Framework を使用して、サービスとしてインストールされるアプリを作成し、その動作を開始、停止、制御する方法について説明します。  
+  
+ [Parallel Processing and Concurrency](../../docs/standard/parallel-processing-and-concurrency.md)  
+ マネージ スレッド処理、並列プログラミング、および非同期プログラミングのデザイン パターンについて説明します。  
+  
+ [.NET Framework のネットワーク プログラミング](../../docs/framework/network-programming/index.md)  
+ アプリにすばやく簡単に統合できる、複数層の拡張可能なインターネット サービスのマネージ実装について説明します。  
+  
+ [Configuring .NET Framework Apps](http://msdn.microsoft.com/ja-jp/d789b592-fcb5-4e3d-8ac9-e0299adaaa42)  
+ 構成ファイルを使用して、.NET Framework アプリを再コンパイルすることなく設定を変更する方法を説明します。  
+  
+ [.NET ネイティブによるアプリのコンパイル](../../docs/framework/net-native/index.md)  
+ [!INCLUDE[net_native](../../includes/net-native-md.md)] プリコンパイル テクノロジを使用して、Windows ストア アプリをビルドおよび配置する方法について説明します。  [!INCLUDE[net_native](../../includes/net-native-md.md)] は、マネージ コード \(C\#\) で記述され、.NET Framework を対象とするアプリをネイティブ コードにコンパイルします。  
+  
+ [セキュリティ](../../docs/standard/security/index.md)  
+ .NET Framework において安全なアプリの開発を促進するクラスおよびサービスに関する情報を示します。  
+  
+ [Debugging, Tracing, and Profiling](../../docs/framework/debug-trace-profile/index.md)  
+ .NET Framework アプリとアプリ環境のテスト、最適化、およびプロファイリングを行う方法について説明します。  開発者向けの情報だけでなく、管理者向けの情報も記載されています。  
+  
+ [複数のプラットフォームの開発](../../docs/standard/cross-platform/index.md)  
+ .NET Framework を使用して複数のプラットフォームおよび複数のデバイス \(電話、デスクトップ、Web など\) で共有できるアセンブリを作成する方法に関する情報を示します。  
+  
+ [配置](../../docs/framework/deployment/net-framework-and-applications.md)  
+ .NET Framework アプリをパッケージ化して配布する方法を説明します。開発者および管理者向けの配置ガイドも含まれています。  
+  
+ [Performance](../../docs/framework/performance/index.md)  
+ キャッシュ、遅延初期化、信頼性、および ETW イベントについて説明します。  
+  
+ [Building Workflows in the .NET Framework](http://msdn.microsoft.com/ja-jp/cbf3880f-dc7b-466d-b808-1109b1223f4a)  
+ Windows Workflow Foundation \(WF\) を使用するためのプログラミング モデル、サンプル、およびツールについて説明します。  
+  
+ [Advanced Reading for the .NET Framework](http://msdn.microsoft.com/ja-jp/faae8083-fecb-4514-b133-b0a5a32a7c3c)  
+ 相互運用性、スレッド処理、リフレクションなどの .NET Framework における高度な開発タスクと手法について説明します。  また、ランタイム ホスト、コンパイラ、逆アセンブラー、デバッガー、プロファイラーなど、マネージ アプリが使用できるアンマネージ API に関する参照トピックも含まれています。  
+  
+## 関連項目  
+ [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/p/?LinkID=227195)  
+ [!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] の名前空間に含まれる各クラスの構文、コード例、および使用情報を示します。  
+  
+## 関連項目  
+ [作業の開始](../../docs/framework/get-started/index.md)  
+ .NET Framework の包括的な概要と、追加リソースへのリンクを説明します。  
+  
+ [新機能](../../docs/framework/whats-new/index.md)  
+ 最新バージョンの .NET Framework の主要な新機能と変更点について説明します。  新旧の型とメンバーのリストを含み、.NET Framework の以前のバージョンからアプリを移行する方法について説明します。  
+  
+ [ツール](../../docs/framework/tools/index.md)  
+ .NET Framework テクノロジを使ってアプリを開発、構成、配置するのに役立つツールについて説明します。  
+  
+ [.NET Framework Samples](http://msdn.microsoft.com/ja-jp/177055f8-4a1f-43e7-aee6-995c196079b1)  
+ .NET Framework のテクノロジを紹介するサンプル アプリを参照できる MSDN コード サンプル ギャラリーへのリンクです。
\ No newline at end of file
diff --git a/docs/framework/get-started/TOC.md b/docs/framework/get-started/TOC.md
new file mode 100644
index 00000000000..de6d8aba86c
--- /dev/null
+++ b/docs/framework/get-started/TOC.md
@@ -0,0 +1,5 @@
+# [.NET Core とオープン ソース](net-core-and-open-source.md)
+# [作業の開始](index.md)
+# [.NET Framework および特別なリリース](the-net-framework-and-out-of-band-releases.md)
+# [概要](overview.md)
+# [システム要件](system-requirements.md)
diff --git a/docs/framework/get-started/index.md b/docs/framework/get-started/index.md
new file mode 100644
index 00000000000..2123476c236
--- /dev/null
+++ b/docs/framework/get-started/index.md
@@ -0,0 +1,89 @@
+---
+title: ".NET Framework の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework、概要"
+  - "概要 [.NET Framework]"
+ms.assetid: c693fd34-88fe-4d90-b332-19eeadf3b7e7
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# .NET Framework の概要
+.NET Framework は、.NET Framework を対象としたアプリケーションを管理するランタイム実行環境です。 これは、メモリ管理やその他のシステム サービスを提供する共通言語ランタイムと、プログラマがアプリケーション開発のすべての主要領域で堅牢性と信頼性の高いコードを利用できるようにするための広範なクラス ライブラリから構成されています。  
+  
+<a name="Introducing"></a>   
+## .NET Framework とは  
+ .NET Framework は、実行中のアプリケーションにさまざまなサービスを提供するマネージ実行環境です。 これは、実行中のアプリケーションを処理する実行エンジンである共通言語ランタイム \(CLR\) と、開発者が独自のアプリケーションから呼び出すことができる検証済みの再利用可能なコード ライブラリである .NET Framework クラス ライブラリから構成されています。 .NET Framework は実行中のアプリケーションに次のようなサービスを提供します。  
+  
+-   メモリ管理 多くのプログラミング言語では、プログラマがメモリの割り当てと解放およびオブジェクトの有効期間の処理を行う必要があります。 .NET Framework アプリケーションでは、CLR がアプリケーションに代わってこのサービスを提供します。  
+  
+-   共通型システム。 従来のプログラミング言語では、コンパイラによって基本型が定義されており、このために言語間の相互運用性が複雑になります。 .NET Framework では、基本型は .NET Framework の型システムによって定義され、.NET Framework を対象とするすべての言語に共通です。  
+  
+-   広範なクラス ライブラリ。 プログラマは、低レベルの共通プログラミング操作を処理するためのコードを大量に記述する代わりに、簡単にアクセスできる .NET Framework クラス ライブラリの型とメンバーのライブラリを活用できます。  
+  
+-   開発フレームワークとテクノロジ。 .NET Framework には、Web アプリケーション向けの ASP.NET、データ アクセス向けの ADO.NET、サービス指向アプリケーション向けの Windows Communication Foundation などの特定領域のアプリケーション開発のためのライブラリが用意されています。  
+  
+-   言語の相互運用性。 .NET Framework を対象とする言語コンパイラは、共通中間言語 \(CIL\) と呼ばれる中間コードを生成し、このコードが共通言語ランタイムによって実行時にコンパイルされます。 この機能を使用すると、1 つの言語で記述されたルーチンが他の言語でもアクセスでき、プログラマは優先言語でのアプリケーションの作成に集中できます。  
+  
+-   バージョンの互換性。 まれなケースを除き、特定のバージョンの .NET Framework を使用して開発されたアプリケーションは、後続バージョンでも変更の必要なく実行できます。  
+  
+-   side\-by\-side 実行。 .NET Framework では、同じコンピューターに複数バージョンの共通言語ランタイムが共存でき、バージョン競合の解決に役立ちます。 これは、複数バージョンのアプリケーションも共存でき、アプリケーションがビルドされた .NET Framework のバージョンでアプリケーションを実行できることを意味します。  
+  
+-   複数バージョン対応。 開発者は、.NET Framework のポータブル クラス ライブラリを対象にすることで、Windows 7、Windows 8、Windows 8.1、Windows 10、Windows Phone、Xbox 360 などの複数の .NET Framework プラットフォームで機能するアセンブリを作成できます。  
+  
+<a name="ForUsers"></a>   
+## ユーザーにとっての .NET Framework  
+ .NET Framework アプリケーションを開発しなくても、使用するユーザーは、.NET Framework やその操作に関する知識を持つ必要はありません。 ほとんどの場合、.NET Framework は、ユーザーにとって完全に透過的に機能します。  
+  
+ Windows オペレーティング システムを使用している場合は、.NET Framework がコンピューターに既にインストールされている場合があります。 また、.NET Framework を必要とするアプリケーションをインストールすると、アプリケーションのセットアップ プログラムにより、コンピューターに特定バージョンの .NET Framework がインストールされることがあります。 場合によっては、.NET Framework のインストールを求めるダイアログ ボックスが表示されることがあります。 アプリケーションを実行しようとしたときにこのダイアログ ボックスが表示される場合や、コンピューターからインターネットにアクセスできる場合は、必要なバージョンの .NET Framework をインストールするための Web ページにアクセスすることができます。  
+  
+ 通常は、コンピューターにインストールされている .NET Framework のバージョンはいずれもアンインストールしないでください。 これには、次の 2 つの理由があります。  
+  
+-   使用するアプリケーションが特定のバージョンの .NET Framework に依存している場合、そのバージョンが削除されるとアプリケーションの互換性に影響する可能性があります。  
+  
+-   .NET Framework のバージョンの中には、前のバージョンのインプレース更新であるものがあります。 たとえば、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] はバージョン 2.0 のインプレース更新で、.NET Framework 4.6 はバージョン 4、4.5、4.5.1、および 4.5.2 のインプレース更新です。 詳細については、「[.NET Framework のバージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)」を参照してください。  
+  
+ .NET Framework を削除する場合は、必ずコントロール パネルから **\[プログラムと機能\]** を使用してアンインストールしてください。 .NET Framework のバージョンを手動で削除しないでください。  
+  
+ 1 台のコンピューターで複数バージョンの .NET Framework を同時に読み込むことができることに注意してください。 これは、後続バージョンをインストールするために前のバージョンをアンインストールする必要がないことを意味します。  
+  
+<a name="ForDevelopers"></a>   
+## 開発者にとっての .NET Framework  
+ 開発者は、アプリケーションを作成するために .NET Framework をサポートする任意のプログラミング言語を選択できます。 .NET Framework は言語への依存性がなく、相互運用性があるので、開発に使用した言語に関係なく、他の .NET Framework アプリケーションおよびコンポーネントと対話できます。  
+  
+ .NET Framework アプリケーションまたはコンポーネントを開発するには、次の操作を行います。  
+  
+1.  アプリケーションが対象とする .NET Framework のバージョンをインストールします。 最新の製品バージョンは [.NET Framework 4.6.1](http://go.microsoft.com/fwlink/?LinkId=671729) です。 アウトオブバンドでリリースされる追加の .NET Framework パッケージもあります。 これらのパッケージについては、「[.NET Framework および特別なリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)」を参照してください。  
+  
+2.  アプリケーションの開発に使用する .NET Framework の言語を選択します。 Microsoft の Visual Basic、C\#、Visual F\#、および C\+\+ を含む多くの言語から選択できます  \(.NET Framework のアプリケーションを開発できるプログラミング言語は、[共通言語基盤 \(CLI\) 仕様](http://go.microsoft.com/fwlink/?LinkId=199862) に準拠します\)。 使用できるプログラミング言語の一覧については、「[Visual Studio 言語](http://go.microsoft.com/fwlink/?LinkId=199863)」を参照してください。  
+  
+3.  アプリケーションの作成に使用する、選択したプログラミング言語をサポートする開発環境を選択してインストールします。[Visual Studio](http://go.microsoft.com/fwlink/?LinkId=325532) は、.NET Framework アプリケーション用の Microsoft 統合開発環境です。 これには、いくつかのリテール エディションと無料エディションがあります。  
+  
+ .NET Framework を対象にしたアプリの開発の詳細については、「[開発ガイド](../../../docs/framework/development-guide.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[概要](../../../docs/framework/get-started/overview.md)|.NET Framework を対象としたアプリケーションをビルドする開発者向けの詳細情報を提供します。|  
+|[.NET Framework および特別なリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)|.NET Framework のアウトオブバンド リリースと、これらをアプリ内で使用する方法について説明します。|  
+|[システム要件](../../../docs/framework/get-started/system-requirements.md)|.NET Framework を実行するためのハードウェアおよびソフトウェアの要件を示します。|  
+|[.NET Core とオープン ソース](../../../docs/framework/get-started/net-core-and-open-source.md)|.NET Core と .NET Framework の関係性、およびオープン ソースの .NET Core プロジェクトにアクセスする方法について説明します。|  
+|[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)|.NET Framework のインストールに関する情報を提供します。|  
+  
+## 参照  
+ [.NET Framework 4.6 および 4.5](../Topic/.NET%20Framework%204.6%20and%204.5.md)   
+ [新機能](../../../docs/framework/whats-new/index.md)   
+ [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkId=227195)   
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/get-started/media/circle.gif b/docs/framework/get-started/media/circle.gif
new file mode 100644
index 00000000000..c9419aaafc1
Binary files /dev/null and b/docs/framework/get-started/media/circle.gif differ
diff --git a/docs/framework/get-started/media/clrnugetdialog.png b/docs/framework/get-started/media/clrnugetdialog.png
new file mode 100644
index 00000000000..1c880cd8261
Binary files /dev/null and b/docs/framework/get-started/media/clrnugetdialog.png differ
diff --git a/docs/framework/get-started/net-core-and-open-source.md b/docs/framework/get-started/net-core-and-open-source.md
new file mode 100644
index 00000000000..d15bba683cc
--- /dev/null
+++ b/docs/framework/get-started/net-core-and-open-source.md
@@ -0,0 +1,80 @@
+---
+title: ".NET Core とオープン ソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e6bd4655-ce37-4003-8462-468a6fe2c40f
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# .NET Core とオープン ソース
+.NET Core は、コードを最大限に再使用および共有してプラットフォーム間で移植できるように設計されている、.NET Framework モジュール形式バージョンです。 さらに、.NET Core はオープン ソース化され、コミュニティからの投稿を受け入れる予定です。 このトピックでは .NET Core に関するいくつかの一般的な質問と、このオープン ソース パッケージにアクセスして投稿する方法について取り上げます。  
+  
+<a name="BKMK_WhatisNETCore"></a>   
+## .NET Core とは何ですか?  
+ 前述のように、.NET Core は、プラットフォーム間で移植できるように設計されているモジュール形式の .NET Framework バージョンです。  
+  
+ .NET Core は、.NET Framework 全体のサブセットではありますが、ターゲットとするプラットフォームに関係なく、必要とするアプリケーション機能を実装してそのコードを再使用するための主な機能が備わっているため、プラットフォームを超えて移植が可能です。 これまでは、各プラットフォームの .NET バージョンがそれぞれにあり、ローカル ファイルの読み取りなど重要なタスクにおける共有機能が欠けていました。 .NET Core を使用してターゲットとできる Microsoft のプラットフォームには、従来のデスクトップの Windows だけでなく Windows デバイスや携帯電話なども含まれます。 Xamarin などのサードパーティ製のツールを使用すれば、.NET Core は IOS および Android のデバイスにも移植できます。 さらに、.NET Core は、Mac および Linux オペレーティング システムでも間もなく利用可能になる予定で、それらのシステムで Web アプリを実行できるようになります。  
+  
+ .NET Core は、小規模のアセンブリ パッケージで NuGet を介してリリースされるためモジュール形式となっています。 .NET Core はコア機能のほとんどが含まれる 1 つの大きなアセンブリではなく、中心的な機能が含まれる比較的小さなパッケージとして提供されています。 こうすることで、当社は従来よりも柔軟な開発モデルを提供でき、開発者はアプリとライブラリで必要とする機能を選択できます。 NuGet でリリースされる .NET パッケージの詳細については、「[.NET Framework および特別なリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)」を参照してください。  
+  
+ .NET Core についてよく寄せられる質問を以下に取り上げます。  
+  
+### どうすれば .NET Core の利点を最大限に活用できますか?  
+ 既存のアプリの場合 .NET Core を使用してコードの再使用機能を最大限に生かすには、ポータブル クラス ライブラリ \(PCL\) とユニバーサル アプリ プロジェクトを使用して、プラットフォーム固有のコードからビジネス ロジックを分離するという方法が最善です。 アプリを .NET Core に簡単に移行するには、Model\-View\-Controller \(MVC\) パターンまたはModel View\-ViewModel \(MVVM\) パターンが適切な選択肢となります。  
+  
+### .NET Core は互換性と配置にどのような影響を及ぼしますか?  
+ 配置にはいくつかのシナリオがありますが、いずれの場合も簡単に行えます。 この .NET Framework は Windows と共に配布され、現在同様、Microsoft Update を通じて更新される予定です。 ご使用のアプリは、.NET Framework のディスク上の配置に依存する場合もあれば、アプリ パッケージと一緒に配置される .NET アセンブリに依存することもあります。 さらに、バージョン間の互換性は引き続き .NET Framework の最優先事項であるため、ご使用のアプリをコンパイルしたときよりも新しいバージョンのアセンブリでアプリを実行してもそれまでと同じように動作します。  
+  
+|シナリオ|配置|  
+|----------|--------|  
+|Windows デスクトップ アプリ、および Windows コンピューター上で実行される ASP.NET アプリ|配置は現在と同じです。 アプリは、サーバーまたはユーザーのコンピューター上にある .NET Framework のインストールに依存します。 .NET Framework がインストールされていない場合、ユーザーはインストールするように求められます。 または、アプリと .NET インストールを結びつけることも可能です。 .NET Framework に含まれていないアセンブリを .NET Core から使用すると、それらのアセンブリが、アプリ パッケージに組み込まれます。 また、同じアプリで 2 つの異なるバージョンの同一のアセンブリを参照している場合、アプリは新しい方のアセンブリにリダイレクトされます。 詳細については、「[アプリ レベルでのアセンブリ バージョンのリダイレクト](../../../docs/framework/configure-apps/redirect-assembly-versions.md#BKMK_Redirectingassemblyversionsattheapplevel)」および「[方法: 自動バインディング リダイレクトを有効\/無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)」を参照してください。<br /><br /> .NET の配置の詳細については、「[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)」を参照してください。|  
+|Windows ストアおよび Windows Phone ストアから利用できる Windows アプリ と Windows Phone アプリ|配置は現在と同じで、アプリは、オペレーティング システムに含まれている .NET Framework アセンブリを使用します。 アプリが .NET Framework に含まれていない .NET Core アセンブリでリリースされた機能を使用する場合、そのアセンブリはアプリ パッケージに組み込まれます。 アプリが複数のバージョンの同一アセンブリを参照する場合、アセンブリの新しい方のバージョンをアプリは自動的に使用します。|  
+|ASP.NET Core 5.0 アプリ|.NET Core アセンブリはアプリ ローカルです。つまり必須アセンブリはアプリ パッケージによって配置されます。 ASP.NET Core 5.0 の詳細については、「[ASP.NET 5 の概要](http://www.asp.net/vnext/overview/aspnet-vnext/aspnet-5-overview)」を参照してください。|  
+|Xamarin ツールでビルドされた他のプラットフォームで実行されるアプリ|現時点では、これらのアプリケーションは、アプリ パッケージに同梱されている効率化された一連の Monoアセンブリとともに配置されます。 これは、オープン ソース化される .NET Core アセンブリが増えると変更される可能性があります。|  
+  
+<a name="BKMK_NETCoreOpenSourcePackages"></a>   
+## .NET Core オープン ソース パッケージ  
+ Microsoft は .NET Framework のモジュール化に加えて、.NET Core パッケージを [MIT](https://github.com/dotnet/corefx/blob/master/LICENSE) ライセンスに基づいて [GitHub](https://github.com/) でオープン ソース化しています。 つまり、GitHub にある他のオープン ソース パッケージと同様に、Git リポジトリを複製し、コードを読み取ってコンパイルし、プル要求を送信できます。 Microsoft の品質と互換性への取り組みにより、各プル要求が承諾されるにはその前に慎重に評価されます。 よく寄せられる質問をいくつか以下に記します。  
+  
+### どのようにすればコードを入手してビルドできますか?  
+ .NET Core ソース パッケージは `GitHub` にあり、ソース管理システムとして `Git` を使用してます。 コードにアクセスしてビルドするには、[Git](http://git-scm.com/)、[GitHub](https://github.com/dotnet/corefx)、[Visual Studio](http://msdn.microsoft.com/vstudio/aa718325.aspx) に関する基本的知識がいくらか必要になりますが、以下の手順には、使用を開始するために必要な情報とリンクが提供されています。  
+  
+ Git と GitHub をセットアップするには、GitHub サイトの「[Git のセットアップ](https://help.github.com/articles/set-up-git/)」を参照してください。  
+  
+ .NET Framework コードにアクセスするには、当該コードが含まれている Git リポジトリをフォークし、開発用コンピューターに複製する必要があります。 リポジトリに移動して、ブラウザーの右上隅にある \[**フォーク**\] をクリックするとコードのフォークを行えます。 GitHub アプリを使用してまたは GitHub シェルのコマンドラインで、フォークを複製できます。 GitHub シェルでリポジトリを複製するには、次のコマンドを実行します。  
+  
+```  
+git clone https://github.com/dotnet/corefx  
+```  
+  
+ コードをビルドするには、Visual Studio 2013 がインストールされている必要があります。 次に、Visual Studio 2013 でソリューションを開いて F5 を押してビルドするか、開発者コマンド プロンプトを使用してコマンドライン上でビルドできます。 コマンド プロンプトでビルドする場合、開発者コマンド プロンプトを開き、ソース コードを複製したフォルダーに移動します。 その後、次にように入力します。  
+  
+```  
+build.cmd  
+  
+```  
+  
+ 開発者コマンド プロンプトを表示する方法の詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+### コードを送信するためのガイドラインがありますか?  
+ Microsoft がお客様の作業内容をマスター分岐に取りこむ前に、お客様は[投稿者のライセンス契約 \(Contributor License Agreement: CLA\)](https://cla.dotnetfoundation.org/) に署名する必要があります。  
+  
+ Microsoft は、フォークとプル モデルを使用したコミュニティからの投稿を受け入れています。 コードをフォークして複製し、プル要求を .NET Framework のマスター分岐に送信してくささい。 プル要求の詳細については、「[プル要求の使用法](https://help.github.com/articles/using-pull-requests/)」を参照してください。 プル要求の送信に関するガイドラインの詳細については、「[.NET Core の投稿に関するガイド](https://github.com/dotnet/corefx/wiki/Contributing)」を参照してください。  
+  
+### 私のプル要求が承諾されなかったのはなぜですか?  
+ Microsoft がお客様の要求を拒否する場合、その理由をお伝えしますが、多くの場合、Microsoft がコードの品質と互換性に関して高いコミットメントを維持していることが理由となります。 プル要求が承諾されなかった場合、コーディングのガイドラインに準拠していなかったこと、コード送信のテストが不十分だったこと、API 互換性がなかったことなどが考えられます。 また、コード変更は .NET Framework のロードマップに則したものであるべきです。 コーディングのガイドラインの詳細については、「[.NET Core の投稿に関するガイド](https://github.com/dotnet/corefx/wiki/Contributing)」を参照してください。  
+  
+## 参照  
+ [.NET はオープン ソース](http://blogs.msdn.com/b/dotnet/archive/2014/11/12/net-core-is-open-source.aspx)   
+ [.NET オープン ソース Curah](https://curah.microsoft.com/254870/net-core-open-source)   
+ [ASP.NET 5 の概要](http://www.asp.net/vnext/overview/aspnet-vnext/aspnet-5-overview)
\ No newline at end of file
diff --git a/docs/framework/get-started/overview.md b/docs/framework/get-started/overview.md
new file mode 100644
index 00000000000..80c23e3b072
--- /dev/null
+++ b/docs/framework/get-started/overview.md
@@ -0,0 +1,105 @@
+---
+title: ".NET Framework の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [.NET Framework]"
+  - "共通言語ランタイム"
+  - "共通言語ランタイム, 概要"
+  - "共通言語ランタイム, 概要"
+ms.assetid: 29848c96-fc36-462d-8072-ba223a40b697
+caps.latest.revision: 34
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# .NET Framework の概要
+.NET Framework は、次世代アプリケーションや XML Web サービスのビルドと実行をサポートするテクノロジです。  .NET Framework は、次の目的を実現するためにデザインされています。  
+  
+-   オブジェクト コードがローカルに保存され実行されるか、インターネットに分散されローカルに実行されるか、リモートで実行されるかにかかわらず、一貫したオブジェクト指向プログラミング環境を提供すること。  
+  
+-   ソフトウェア配置やバージョン管理の競合を最小化するコード実行環境を提供すること。  
+  
+-   作成者が不明なコードや、完全には信頼できないサード パーティ製のコードも含めて、コードを安全に実行できるようにするためのコード実行環境を提供すること。  
+  
+-   スクリプトやインタープリターが実行される環境でのパフォーマンスの問題を回避するコード実行環境を提供すること。  
+  
+-   Windows ベースのアプリケーションや Windows ベースや Web ベースのアプリケーションなど、多種のアプリケーションの開発において、ユーザーが一貫した方法で作業できること。  
+  
+-   .NET Framework に基づいたコードを他の任意のコードと統合できるように、すべての通信を業界標準に準拠して構築すること。  
+  
+> [!NOTE]
+>  ユーザーと開発者のための .NET Framework の概要については、「[作業の開始](../../../docs/framework/get-started/index.md)」を参照してください。  .NET Framework をダウンロードするには、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+ .NET Framework は、共通言語ランタイムと .NET Framework クラス ライブラリから構成されます。  共通言語ランタイムは、.NET Framework の基礎となるコンポーネントです。  このランタイムは、実行時のコード管理を行うエージェントのようなものであり、メモリ管理、スレッド管理、リモート処理などの重要なサービスを提供したり、セキュリティや保全性を促進するために厳密なタイプ セーフやその他のコード整合性を強制的に適用したりします。  実際、コード管理の概念はこのランタイムの基本原理です。  このランタイムを使用して実行するように作成されたコードはマネージ コードと呼ばれ、そうでないコードはアンマネージ コードと呼ばれます。  クラス ライブラリは、従来のコマンド ラインやグラフィカル ユーザー インターフェイス \(GUI\) を使用したアプリケーションから、ASP.NET がもたらした最新の機構に基づく Web フォームや XML Web サービスなどのアプリケーションに至るまでのアプリケーション開発に使用できる、再利用可能な型の包括的なオブジェクト指向コレクションです。  
+  
+ .NET Framework は、アンマネージ コンポーネントでホストすることもできます。アンマネージ コンポーネントは、共通言語ランタイムをプロセスに読み込み、マネージ コードの実行を開始することで、マネージ機能とアンマネージ機能の両方を利用できるソフトウェア環境を構築できます。  .NET Framework には、いくつかのランタイム ホストが用意されているだけでなく、サードパーティ製ランタイム ホストの開発もサポートします。  
+  
+ たとえば、ASP.NET は、このランタイムをホストして、マネージ コードのためのスケーラブルなサーバー側環境を提供します。  ASP.NET はこのランタイムを直接利用して、ASP.NET アプリケーションや XML Web サービスを有効にします。Web フォーム アプリケーションと XML Web サービスについては、このトピックで後に説明します。  
+  
+ 共通言語ランタイムを MIME 型拡張機能としてホストするアンマネージ アプリケーションの例として、Internet Explorer があります。  Internet Explorer を使用してこのランタイムをホストすることにより、マネージ コンポーネントや Windows フォーム コントロールを HTML ドキュメントに埋め込むことができます。  このランタイムをこの方法でホストすると、マネージ モバイル コードを実現できるだけでなく、それと同時に、中程度に信頼されたコードの実行や、分離ファイル ストレージなどのマネージ コードだけが提供できる重要な拡張機能も利用できます。  
+  
+ 共通言語ランタイムおよびクラス ライブラリの、アプリケーションおよびシステム全体に対する関係を次の図に示します。  この図には、比較的大規模なアーキテクチャの内部でマネージ コードが動作する方法も示されています。  
+  
+ ![大規模アーキテクチャのマネージ コード](../../../docs/framework/get-started/media/circle.gif "circle")  
+.NET Framework とアプリケーションおよびシステム全体との関係  
+  
+ .NET Framework の主要な機能を以降のセクションでより詳細に説明します。  
+  
+## 共通言語ランタイムの機能  
+ 共通言語ランタイムでは、メモリ、スレッドの実行、コードの実行、コードの整合性検査、コンパイル、およびその他のシステム サービスを管理します。  これらの機能は、共通言語ランタイムで実行されるマネージ コードにあらかじめ用意されています。  
+  
+ セキュリティ関連では、マネージ コンポーネントには、その出所 \(インターネット、企業内ネットワーク、ローカル コンピューターなど\) を含めた一連の要因に基づいて、さまざまな程度の信頼が与えられます。  そのためマネージ コンポーネントは、同じアクティブなアプリケーションで使用されていても、ファイル アクセス操作、レジストリ アクセス操作、またはその他の一般に公開されない機能を、実行できる場合と実行できない場合があります。  
+  
+ 共通言語ランタイムは、コード アクセス セキュリティを強制的に適用します。  たとえば、Web ページに埋め込まれた実行可能ファイルがアニメーションや音声を再生できても、ユーザーの個人データ、ファイル システム、またはネットワークにはアクセスできないように信頼されます。  このようにして、このランタイムのセキュリティ機能は、適切な方法でインターネットに配置されたソフトウェアに、豊富な機能を特別に持たせることができます。  
+  
+ 共通言語ランタイムでは、共通型システム \(CTS: Common Type System\) と呼ばれる厳密な型検査およびコード検査のインフラストラクチャを実装することで、コード保全性を強制的に適用します。  CTS は、すべてのマネージ コードが自己言及的であることを保証します。  各種の Microsoft 製およびサードパーティ製言語コンパイラは、CTS に準拠したマネージ コードを生成します。  そのためマネージ コードは、厳密な型の忠実性やタイプ セーフを適用しながら、他のマネージ型やマネージ インスタンスを利用できます。  
+  
+ さらに、共通言語ランタイムのマネージ環境では、ソフトウェアに共通する多くの問題を除去できます。  たとえば、このランタイムは、オブジェクトのレイアウトを自動的に処理し、それらのオブジェクトへの参照を管理し、不要になったオブジェクトを解放します。  この自動メモリ管理により、メモリ リークおよび無効なメモリ参照という、最も頻繁に生じる 2 つのアプリケーション エラーが解決されます。  
+  
+ 共通言語ランタイムを使用することにより、開発者の生産性も向上します。  たとえば、プログラマは任意に選択した開発言語でアプリケーションを記述しながら、このランタイムの機能を十分に利用し、他の開発者が別の言語で記述したクラス ライブラリやコンポーネントを使用できます。  このランタイムをターゲットとして選択したコンパイラの販売元も、これらの利点を享受できます。  .NET Framework をターゲットとする言語コンパイラを使用すると、その言語で記述された既存のコードでも .NET Framework の機能が利用できるようになるため、既存のアプリケーションの移行作業が簡単になります。  
+  
+ このランタイムは、これから開発されるソフトウェアのためにデザインされていますが、現在や過去のソフトウェアもサポートします。  マネージ コードとアンマネージ コードには相互運用性があるため、開発者は必要な COM コンポーネントや DLL を使用し続けることができます。  
+  
+ 共通言語ランタイムは、パフォーマンスを向上させるようにデザインされています。  このランタイムには多くの標準ランタイム サービスが用意されていますが、マネージ コードのインタープリター処理が行われることはありません。  ジャスト イン タイム \(JIT: Just\-In\-Time\) コンパイルと呼ばれる機能により、すべてのマネージ コードは、それが実行されるシステムのネイティブ機械語で実行できます。  また、メモリ マネージャーは、メモリの断片化を防止し、メモリ参照ができる限りローカルで行われるようにすることで、パフォーマンスを向上させます。  
+  
+ 最後に、共通言語ランタイムは、Microsoft SQL Server や Internet Information Services \(IIS\) などの高性能なサーバー側アプリケーションでホストできます。  このインフラストラクチャにより、マネージ コードを使用してビジネス ロジックを記述し、ランタイム ホストをサポートする企業向けサーバーの優れたパフォーマンスを享受できます。  
+  
+## .NET Framework クラス ライブラリ  
+ .NET Framework クラス ライブラリは、共通言語ランタイムと緊密に統合された再利用可能な型のコレクションです。  このクラス ライブラリはオブジェクト指向で、このライブラリが提供する型を使用することにより、独自に作成したマネージ コード内で機能を継承できます。  これは .NET Framework の型を使いやすくするだけでなく、.NET Framework の新機能の学習に必要な時間を減らします。  さらに、.NET Framework のクラスには、サードパーティ製のコンポーネントをシームレスに統合できます。  
+  
+ たとえば、.NET Framework のコレクション クラスは、独自のコレクション クラスの開発に使用できる一連のインターフェイスを実装しています。  作成したコレクション クラスは、.NET Framework のクラスとシームレスに統合して使用できます。  
+  
+ 他のオブジェクト指向クラス ライブラリの場合と同様に、.NET Framework の型を使用することで、文字列の管理、データ コレクション、データベース接続、ファイル アクセスなどを含む、共通性のあるさまざまなプログラミング作業を行うことができます。  これらの共通の作業の他に、クラス ライブラリにはさまざまな特別の開発シナリオをサポートする型も含まれています。  たとえば、.NET Framework を使用すると、次のような種類のアプリケーションやサービスを開発できます。  
+  
+-   コンソール アプリケーション  「[コンソール アプリケーションの構築](../../../docs/standard/building-console-apps.md)」を参照してください。  
+  
+-   Windows GUI アプリケーション \(Windows フォーム\)  「[Windows フォーム](../../../docs/framework/winforms/index.md)」を参照してください。  
+  
+-   Windows Presentation Foundation \(WPF\) アプリケーション  「[Windows Presentation Foundation](../../../docs/framework/wpf/index.md)」を参照してください。  
+  
+-   ASP.NET アプリケーション  「[ASP.NET を使用した Web アプリケーション](../../../docs/framework/develop-web-apps-with-aspnet.md)」を参照してください。  
+  
+-   Windows サービス  「[Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)」を参照してください。  
+  
+-   Windows Communication Foundation \(WCF\) を使用するサービス指向アプリケーション  「[WCF を使用したサービス指向アプリケーション](../../../docs/framework/wcf/developing-service-oriented-applications-with-wcf.md)」を参照してください。  
+  
+-   Windows Workflow Foundation \(WF\) を使用するワークフロー対応アプリケーション  「[.NET Framework におけるワークフローの作成](http://msdn.microsoft.com/ja-jp/cbf3880f-dc7b-466d-b808-1109b1223f4a)」を参照してください。  
+  
+ たとえば Windows フォーム クラスは、Windows GUI の開発を非常に簡単にする、再利用可能な型の包括的なセットです。  ASP.NET Web フォーム アプリケーションを作成する場合は、Web フォーム クラスを使用します。  
+  
+## 参照  
+ [システム要件](../../../docs/framework/get-started/system-requirements.md)   
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)   
+ [開発ガイド](../../../docs/framework/development-guide.md)   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [.NET Framework のサンプル](http://msdn.microsoft.com/ja-jp/177055f8-4a1f-43e7-aee6-995c196079b1)   
+ [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkID=227195)
\ No newline at end of file
diff --git a/docs/framework/get-started/system-requirements.md b/docs/framework/get-started/system-requirements.md
new file mode 100644
index 00000000000..36f4537cebc
--- /dev/null
+++ b/docs/framework/get-started/system-requirements.md
@@ -0,0 +1,95 @@
+---
+title: ".NET Framework システム要件 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ソフトウェア要件"
+  - ".NET Framework、システム要件"
+  - "システム要件"
+  - "オペレーティング システム (サポートされる)"
+  - "ハードウェア要件"
+ms.assetid: 298275e2-da1d-4618-9f74-6a3567832350
+caps.latest.revision: 95
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 91
+---
+# .NET Framework システム要件
+このトピックの表では、.NET Framework 4.5 とそのポイント リリース \(4.5.1 と 4.5.2\)、および [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] とそのポイント リリース \(4.6.1 と 4.6.2\) のハードウェア、オペレーティング システム、およびソフトウェアの要件を示します。 .NET Framework 用のアプリケーションを開発するための開発環境では、要件セットが異なります。  
+  
+ ダウンロード情報とリンクについては、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」をご覧ください。  
+  
+ .NET Framework バージョンのサポート ライフサイクルについては、「[マイクロソフト サポート ライフサイクル](https://support.microsoft.com/en-us/lifecycle/search?sort=PN&alpha=Microsoft%20.NET%20Framework&Filter=FilterNO)」をご覧ください。  
+  
+## ハードウェア要件  
+  
+|||  
+|-|-|  
+|**プロセッサ**|1 GHz|  
+|**RAM**|512 MB|  
+|**ディスク容量 \(最小\)**||  
+|32 ビット|4.5 GB|  
+|64 ビット|4.5 GB|  
+  
+## インストール要件  
+  
+-   .NET Framework をインストールするには管理者権限が必要です。 .NET Framework をインストールするコンピューター上での管理者権限がない場合には、ネットワーク管理者にお問い合わせください。  
+  
+## サポートされているクライアント オペレーティング システム  
+  
+|オペレーティング システム|サポートされているエディション|OS と共にプレインストール済み|個別にインストール可能|  
+|-------------------|---------------------|----------------------|-----------------|  
+|Windows 10 Anniversary Update|32 ビットおよび 64 ビット|[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]||  
+|Windows 10 の 11 月更新版|32 ビットおよび 64 ビット|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|Windows 10|32 ビットおよび 64 ビット|[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|[!INCLUDE[win81](../../../includes/win81-md.md)]|32 ビット、64 ビット、および ARM|[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]|[!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|[!INCLUDE[win8](../../../includes/win8-md.md)]|32 ビット、64 ビット、および ARM|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]|[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|  
+|Windows 7 SP1|32 ビットおよび 64 ビット|\-\-|.NET Framework 4<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|Windows Vista SP2|32 ビットおよび 64 ビット|\-\-|.NET Framework 4<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|  
+|Windows XP|32 ビットおよび 64 ビット|\-\-|.NET Framework 4|  
+  
+ **メモ:**  
+  
+-   Windows 7 システムでは、.NET Framework には Windows 7 SP1 が必要です。 Windows 7 を使用していて Service Pack 1 をインストールしていない場合、.NET Framework をインストールする前に、Service Pack 1 をインストールする必要があります。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、Windows プレインストール環境 \(Windows PE\) でサポートされます。 Windows PE では、すべての機能がサポートされているわけではありません。  
+  
+-   .NET Framework 4 は、IA64 プラットフォームもサポートしています。  
+  
+-   すべてのプラットフォームについて最大限の互換性とセキュリティが得られるように、[Windows Update Web サイト](http://go.microsoft.com/fwlink/?LinkId=168461)から入手できる最新の Windows Service Pack にアップグレードし、重要な更新プログラムをインストールすることをお勧めします。  
+  
+-   64 ビット オペレーティング システムでは、.NET Framework は WOW64 \(64 ビット コンピューター上での 32 ビット処理\) とネイティブ 64 ビット処理の両方をサポートしています。  
+  
+## サポートされているサーバー オペレーティング システム  
+  
+|オペレーティング システム|サポートされているエディション|OS と共にプレインストール済み|個別にインストール可能|  
+|-------------------|---------------------|----------------------|-----------------|  
+|[!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)]|64 ビット|[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]|[!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|[!INCLUDE[winserver8](../../../includes/winserver8-md.md)] \(64 ビット エディション\)|64 ビット|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]|[!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|Windows Server 2008 R2 SP1|64 ビット|\-\-|.NET Framework 4<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]<br /><br /> [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]<br /><br /> [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]|  
+|Windows Server 2008 SP2|32 ビットおよび 64 ビット|\-\-|.NET Framework 4<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]<br /><br /> [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]<br /><br /> [!INCLUDE[net_v452](../../../includes/net-v452-md.md)]<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|  
+  
+ **メモ:**  
+  
+-   [!INCLUDE[winserver8](../../../includes/winserver8-md.md)] には [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] が含まれているため、個別にインストールする必要はありません。 同様に、[!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)] には [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] が含まれます。  
+  
+-   .NET Framework は、Windows Server 2008 R2 SP1 以降の Server Core ロールでサポートされていますが、Itanium ベース システム用の Windows Server 2008 R2 ではサポートされていません。  
+  
+-   Windows Server 2008 SP2 では、.NET Framework は、Server Core ロールでサポートされていません。  
+  
+-   すべてのプラットフォームについて最大限の互換性とセキュリティが得られるように、[Windows Update Web サイト](http://go.microsoft.com/fwlink/?LinkId=168461)から入手できる最新の Windows Service Pack にアップグレードし、重要な更新プログラムを適用することをお勧めします。 一部のオペレーティング システムでは、最新の Windows Service Pack のインストールが必要になる場合があります。  
+  
+-   64 ビット オペレーティング システムでは、.NET Framework は WOW64 \(64 ビット コンピューター上での 32 ビット処理\) とネイティブ 64 ビット処理の両方をサポートしています。  
+  
+## 参照  
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)   
+ [作業の開始](../../../docs/framework/get-started/index.md)   
+ [トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)
\ No newline at end of file
diff --git a/docs/framework/get-started/the-net-framework-and-out-of-band-releases.md b/docs/framework/get-started/the-net-framework-and-out-of-band-releases.md
new file mode 100644
index 00000000000..ca8b312bc8a
--- /dev/null
+++ b/docs/framework/get-started/the-net-framework-and-out-of-band-releases.md
@@ -0,0 +1,63 @@
+---
+title: ".NET Framework および特別なリリース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 721f10fa-3189-4124-a00d-56ddabd889b3
+caps.latest.revision: 19
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# .NET Framework および特別なリリース
+.NET Framework は、従来のデスクトップ アプリや Web アプリに加えて、Windows Phone や Windows ストア アプリなど、さまざまなプラットフォームに対応し、コードを最大限に再利用できるように発展しています。  通常の .NET Framework のリリースに加えて、クロスプラットフォームでの開発の強化や新機能の導入を目的として、新しい機能をアウトオブバンド \(OOB\) リリースによって提供しています。  ここでは、.NET Framework および OOB リリースの将来の方向性について説明します。  
+  
+## OOB リリースの長所  
+ 新しいコンポーネントやコンポーネントに対する更新プログラムをアウトオブバンドで提供することにより、Microsoft では .NET Framework の更新プログラムをより頻繁に提供できます。  また、カスタマーからのフィードバックにすばやく収集して対応できます。  
+  
+ 独自のアプリで OOB 機能を使用する場合、OOB アセンブリはアプリのパッケージで配置されるため、ユーザーはアプリを実行するために最新バージョンの .NET Framework をインストールする必要はありません。  
+  
+## OOB パッケージの配布方法  
+ 共通言語ランタイム \(CLR\) のコア コンポーネントの OOB リリースは、オープン ソースの Visual Studio 拡張機能である [NuGet Package Manager](http://nuget.codeplex.com/) を通じて配布されます。  NuGet によって、Visual Studio のソリューション エクスプローラーから簡単に、.NET Framework プロジェクトを参照したり、ライブラリを追加したりすることができます。  NuGet は、Visual Studio 2012 以降のすべてのエディションに付属しています。  NuGet がインストールされているかどうかを確認するには、Visual Studio の **\[ツール\]** メニューの **\[ライブラリ パッケージ マネージャー\]** を検索します。  インストールされていない場合:  
+  
+1.  Visual Studio のメニュー バーで、**\[ツール\]**、**\[拡張機能と更新プログラム\]** を選択します \(Visual Studio 2010 では、**\[拡張機能マネージャー\]** を選択します\)。  
+  
+     **\[拡張機能と更新プログラム\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[オンライン\]**、**\[NuGet Package Manager\]** を選択し、**\[ダウンロード\]** を選択します。  
+  
+3.  ダウンロードが完了したら、Visual Studio を再起動します。  
+  
+ 詳細なインストール方法については、NuGet Docs Web サイトの「[Installing NuGet \(NuGet のインストール\)](http://docs.nuget.org/docs/start-here/installing-nuget)」を参照してください。  NuGet の詳細については、[NuGet のドキュメント](http://docs.nuget.org/)を参照してください。  
+  
+## NuGet OOB パッケージの使用  
+ NuGet をインストールした後、Visual Studio のソリューション エクスプローラーを使用して NuGet パッケージの表示や、NuGet パッケージへの参照の追加を行うことができます:  
+  
+1.  Visual Studio でプロジェクトのショートカット メニューを開き、**\[Manage NuGet Packages\]** \(NuGet パッケージの管理\) を選択します   \(このオプションは、**\[プロジェクト\]** メニューからも使用できます\)。  
+  
+2.  左ペインで、**\[オンライン\]** を選択します。  
+  
+3.  プレリリースのパッケージを使用する場合は、中央のペインのドロップダウン リスト ボックスで **\[Stable Only\] \(安定しているリリースのみ\)** の代わりに **\[Include Prerelease\] \(プレリリースを含める\)** を選択します。  
+  
+4.  右ペインで、**\[検索\]** ボックスを使用して使用するパッケージを検索します。  Microsoft の一部のパッケージは、Microsoft .NET Framework のロゴで識別され、すべて発行者は Microsoft となっています。  
+  
+ ![NuGet パッケージ マネージャー](../../../docs/framework/get-started/media/clrnugetdialog.png "clrNugetDialog")  
+  
+ OOB パッケージを使用するアプリケーションを配置する場合は、前述のとおり、OOB のアセンブリは、アプリのパッケージに付属しています。  
+  
+## OOB のリリースの種類  
+ 通常、OOB パッケージには、1 つ以上のプレリリース バージョンと 1 つの安定したバージョンがあります。  プレリリースに含まれるライセンスでは通常、再配布は許可されませんが、パッケージを試用して、フィードバックを提供することができます。  フィードバックはパッケージに対する更新プログラムに組み込まれます。  最終リリースは NuGet を使って安定したパッケージとして配布され、アプリと共に NuGet パッケージを再配布できるライセンスが含まれます。  安定したパッケージは Microsoft によってサポートされています。  Microsoft では、IntelliSense のサポートや、ブログの投稿、フォーラムでの回答などの別の種類のドキュメントを、すべてのパッケージについて提供します。  また、すべてのパッケージではありませんが、一部のパッケージについてはソース コードも利用できる場合があります。  新しいパッケージや更新パッケージに関するお知らせについては、「[.NET Framework ブログ](http://blogs.msdn.com/b/dotnet/)」を定期受信できます。  
+  
+ プレリリース パッケージと安定したパッケージの両方を検索するには、NuGet Package Manager で **\[Include Prerelease\] \(プレリリースを含める\)** を選択してください。  
+  
+ 安定したパッケージのリリースについて通知を受ける場合は、[.NET Framework のフィード](https://nuget.org/api/v2/curated-feeds/dotnetframework/Packages/)を定期受信してください。  
+  
+## 参照  
+ [作業の開始](../../../docs/framework/get-started/index.md)
\ No newline at end of file
diff --git a/docs/framework/index.md b/docs/framework/index.md
index f27acdf8009..399cb0064e4 100644
--- a/docs/framework/index.md
+++ b/docs/framework/index.md
@@ -1,30 +1,57 @@
 ---
-title: ".NET Framework ガイド"
-description: ".NET Framework の詳細情報"
-keywords: ".NET, .NET Framework, .NET サーバー, .NET デスクトップ"
-author: BillWagner
-manager: wpickett
-ms.date: 09/28/2016
-ms.topic: article
-ms.prod: .net-framework-4.6
-ms.technology: dotnet-bcl
-ms.devlang: dotnet
-ms.assetid: a27b2ae4-154e-4b2b-b221-0c4c05185274
-translationtype: Human Translation
-ms.sourcegitcommit: 38561c2d25c6950d166bf706f4306c867e683b04
-ms.openlocfilehash: cd7442b304ff28b02826a84684b594dfdd0d9873
-
----
-
-# <a name="net-framework-on-docker-guide"></a>Docker 上の .NET Framework のガイド
-
-.NET Framework は、Windows、Windows Phone、Windows Server、および Microsoft Azure 用のアプリケーションを作成するための開発プラットフォームです。 .NET Framework は、共通言語ランタイム (CLR) と、広範なテクノロジをサポートするクラス、インターフェイス、および値型が含まれる .NET Framework クラス ライブラリで構成されます。 .NET Framework によって、マネージ実行環境の使用、開発と配置の簡略化、Visual Basic、Visual C# および F# を含む各種のプログラミング言語との統合などが可能になります。
-
-[Windows コンテナー](https://msdn.microsoft.com/en-us/virtualization/windowscontainers/about/about_overview)で既存のアプリケーションを実行する方法については、「[.NET Framework で Docker を使用する](docker/index.md)」を参照してください。
- 
-
-
-
-<!--HONumber=Nov16_HO3-->
-
-
+title: ".NET Framework 4.6 および 4.5 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "f61f02f2-2f20-483d-8f56-a9c8f3a54986"
+helpviewer_keywords: 
+  - ".NET Framework, ドキュメント"
+  - "ドキュメント, .NET Framework"
+ms.assetid: f61f02f2-2f20-483d-8f56-a9c8f3a54986
+caps.latest.revision: 75
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 71
+---
+# .NET Framework 4.6 および 4.5
+> [!NOTE]
+>  この .NET Framework コンテンツ セットには .NET Framework バージョン 4.5、4.5.1、4.5.2、4.6、4.6.1 に関する情報が含まれています。 .NET Framework をダウンロードするには、「[.NET Framework のインストール](../../docs/framework/install/guide-for-developers.md)」を参照してください。 NET Framework 4.5 の新機能と変更点、[!INCLUDE[net_v46](../../includes/net-v46-md.md)] とそのポイント リリースについては、「[新機能](../../docs/framework/whats-new/index.md)」をご覧ください。 サポートされているプラットフォームについては、「[.NET Framework のシステム要件](../../docs/framework/get-started/system-requirements.md)」を参照してください。  
+  
+ .NET Framework は、Windows、Windows Phone、Windows Server、および Microsoft Azure 用のアプリを作成するための開発プラットフォームです。 .NET Framework は、共通言語ランタイム \(CLR\) と、広範なテクノロジをサポートするクラス、インターフェイス、および値型が含まれる .NET Framework クラス ライブラリで構成されます。 .NET Framework によって、マネージ実行環境の使用、開発と配置の簡略化、Visual Basic や Visual C\# を含む各種のプログラミング言語との統合などが可能になります。  
+  
+> [!NOTE]
+>  .NET Framework をダウンロードするには、「[.NET Framework のインストール](../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+ ユーザーと開発者のための .NET Framework の概要については、「[Getting Started \(作業の開始\)](../../docs/framework/get-started/index.md)」を参照してください。 .NET Framework のアーキテクチャおよび主要機能の概要については、「[overview \(概要\)](../../docs/framework/get-started/overview.md)」を参照してください。  
+  
+ .NET Framework のドキュメントには、広範なクラス ライブラリ リファレンス、概念説明、手順説明に加えて、サンプル、コンパイラ、およびコマンド ライン ツールに関する情報が含まれています。 必要な情報を見つけるには、以下の主要トピックの一覧を参照してください。  
+  
+## このセクションの内容  
+ [新機能](../../docs/framework/whats-new/index.md)  
+ 最新バージョンの .NET Framework の主要な新機能と変更点について説明します。 現在使用されていない型とメンバーのリストを示し、.NET Framework の以前のバージョンからアプリケーションを移行する方法について説明します。  
+  
+ [作業の開始](../../docs/framework/get-started/index.md)  
+ .NET Framework の包括的な概要と、追加リソースへのリンクを説明します。  
+  
+ [移行ガイド](../Topic/Migration%20Guide%20to%20the%20.NET%20Framework%204.6%20and%204.5%20.md)  
+ アプリケーションを新しいバージョンの .NET Framework に移行する場合に検討する必要のあるリソースと変更の一覧を示します。  
+  
+ [開発ガイド](../../docs/framework/development-guide.md)  
+ アプリケーションの作成、構成、デバッグ、セキュリティ、配置、および動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理に関する情報を含む、アプリケーション開発用の主要な技術領域とタスクのすべてについての手引書です。  
+  
+ [ツール](../../docs/framework/tools/index.md)  
+ .NET Framework テクノロジを使ってアプリケーションを開発、構成、配置するのに役立つツールについて説明します。  
+  
+ [.NET Framework クラス ライブラリ](../Topic/.NET%20Framework%20Class%20Library.md)  
+ .NET Framework の名前空間に含まれる各クラスの構文、コード例、および関連情報を記載しています。  
+  
+ [その他のクラス ライブラリと Api](../../ml/index.xml)  
+ アウトオブバンド \(OOB\) のリリースに含まれるクラスについて説明します。
\ No newline at end of file
diff --git a/docs/framework/install/TOC.md b/docs/framework/install/TOC.md
new file mode 100644
index 00000000000..a21b3483e4c
--- /dev/null
+++ b/docs/framework/install/TOC.md
@@ -0,0 +1,4 @@
+# [Windows 8 以降のバージョンでの .NET Framework 1.1 アプリの実行](run-net-framework-1-1-apps.md)
+# [インストール ガイド](guide-for-developers.md)
+# [トラブルシューティング](troubleshoot-blocked-installations-and-uninstallations.md)
+# [Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](net-framework-3-5-on-windows-8-plus.md)
diff --git a/docs/framework/install/guide-for-developers.md b/docs/framework/install/guide-for-developers.md
new file mode 100644
index 00000000000..33e3b8f71fa
--- /dev/null
+++ b/docs/framework/install/guide-for-developers.md
@@ -0,0 +1,197 @@
+---
+title: ".NET Framework のインストール | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "get-started-article"
+helpviewer_keywords: 
+  - ".NET Framework 再頒布可能パッケージ、ダウンロード"
+  - ".NET Framework、インストール"
+  - "インストール (.NET Framework の)"
+  - "インストール [.NET Framework]"
+ms.assetid: daf9d9d5-84ac-4bd9-a864-27665ffd0f5c
+caps.latest.revision: 165
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 159
+---
+# .NET Framework のインストール
+.NET は、Windows 上で実行されている多数のアプリケーションに不可欠な部分であり、それらのアプリケーションが稼働するための共通の機能を提供します。 .NET Framework は、視覚的に美しいユーザー エクスペリエンスと、シームレスでありながらもセキュリティで保護された通信機能を備えたアプリケーションを構築するための包括的で一貫性のあるプログラミング モデルを開発者に提供します。  
+  
+ この記事には、.NET Framework 4.5 とそのポイント リリース \(4.5.1、4.5.2\)、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] とそのポイント リリース \(4.6.1、4.6.2\) のコンピューターへのインストールに関するリンクがあります。 開発者の場合、これらのリンクを使用して、.NET Framework をダウンロードし、アプリと共に .NET Framework を再配布することもできます。  
+  
+ .NET Framework の新しいバージョンをインストールしても前のバージョンを常に置換するわけではないことに注意してください。 .NET Framework のバージョンの詳しい情報およびコンピューターにインストールされているバージョンを確認する方法については、「[バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)」と「[方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」をご覧ください。 次の表に示されている .NET Framework のバージョンは、すべて .NET Framework 4 のインプレース更新です。 つまり、.NET Framework 4.6 などの以降のバージョンをインストールする場合でも、先だって .NET Framework 4.5、4.5.1、または 4.5.2 など以前のバージョンをインストールする必要がありません。 同様に、.NET Framework 4.6 などの以降のバージョンをインストールする場合に、まず .NET Framework 4.5、4.5.1、または 4.5.2 など以前のバージョンをアンインストールする必要もありません。 これはまた、以降のバージョンが既にインストールされている場合、表に記載されている初期バージョンをインストールできないことを意味します。  
+  
+> [!NOTE]
+>  .NET Framework 3.5 については、「[Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)」をご覧ください。  
+  
+ 次の表をクイック リンクとして使用し、詳細を参照してください。 インストール前に .NET Framework のシステム要件を確認するには、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください。 トラブルシューティングの方法は、「[トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)」を参照してください。  
+  
+|.NET Framework のバージョン|Developer のインストール|再頒布可能なインストール|プラットフォームのサポート|  
+|---------------------------|-----------------------|------------------|-------------------|  
+|**4.6.2**|[NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617)|[4.6.2 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=780597)<br /><br /> [4.6.2 オフライン インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=780601)|インストール可能なバージョン: <br /> Windows 10 <br /> Windows 8.1 以前<br /> Windows Server 2012 R2 以前<br /> \(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)。|  
+|**4.6.1**|[NET Framework 4.6.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=690706)|[4.6.1 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=671729)<br /><br /> [4.6.1 オフライン インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=671744)|インストール可能なバージョン: <br /> Windows 10 <br /> Windows 8.1 以前<br /> Windows Server 2012 R2 以前<br /> \(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)。|  
+|**4.6**|[!INCLUDE[vs_dev14](../../../includes/vs-dev14-md.md)] に含まれています。 詳しくは、「[Visual Studio 2015 へようこそ](http://msdn.microsoft.com/library/dd831853\(v=vs.140\).aspx)」をご覧ください。<br /><br /> [Microsoft .NET Framework 4.6 targeting pack](http://go.microsoft.com/fwlink/?LinkId=528261)|[4.6 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=528259)<br /><br /> [4.6 オフライン インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/?LinkId=528233)|このバージョンを含む製品: <br /> Windows 10 <br />[!INCLUDE[vs_dev14](../../../includes/vs-dev14-md.md)]<br /><br /> インストール可能なバージョン:<br /> Windows 8.1 以前<br /> Windows Server 2012 R2 以前<br /> \(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)。|  
+|**4.5.2**|[Microsoft .NET Framework 4.5.2 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=397702)<br /><br /> [Visual Studio 2013](http://go.microsoft.com/fwlink/?LinkID=325532)、Visual Studio 2012 または他の IDE での使用|[4.5.2 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/p/?LinkId=397703)<br /><br /> [4.5.2 オフライン インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/p/?LinkId=397706)|インストール可能なバージョン:<br /> Windows 8.1 以前<br /> Windows Server 2012 R2 以前<br /> \(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)。|  
+|**4.5.1**|[Microsoft .NET Framework 4.5.1 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=324213)<br /><br /> Visual Studio 2012 または他の IDE での使用|[4.5.1 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/p/?LinkId=310158)<br /><br /> [4.5.1 オフライン インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/p/?LinkId=310159)|このバージョンを含む製品:<br />[!INCLUDE[win81](../../../includes/win81-md.md)]<br /> Windows Server 2012 R2<br />[Visual Studio 2013](http://go.microsoft.com/fwlink/?LinkID=325532)<br /><br /> インストール可能なバージョン:<br />[!INCLUDE[win8](../../../includes/win8-md.md)] 以前<br />[!INCLUDE[winserver8](../../../includes/winserver8-md.md)] 以前<br />\(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)|  
+|**4.5**|Visual Studio 2012 に含まれる<br /><br /> [Windows 8 SDK](http://msdn.microsoft.com/windows/hardware/hh852363) の一部としても使用可能|[4.5 Web インストーラーのダウンロード ページ](http://go.microsoft.com/fwlink/p/?LinkId=245484)|このバージョンを含む製品: <br />[!INCLUDE[win8](../../../includes/win8-md.md)]<br />[!INCLUDE[winserver8](../../../includes/winserver8-md.md)]<br /> Visual Studio 2012<br /><br /> インストール可能なバージョン:<br /> Windows 7 以前<br /> Windows Server 2008 SP2 以前<br /> \(完全な一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」をご覧ください\)。|  
+  
+ ユーザーと開発者のための .NET Framework の概要については、「[Getting Started \(作業の開始\)](../../../docs/framework/get-started/index.md)」を参照してください。 アプリとの .NET Framework の配置については、「[配置ガイド](../../../docs/framework/deployment/deployment-guide-for-developers.md)」を参照してください。 .NET Framework のアーキテクチャおよび主要機能の概要については、[概要](../../../docs/framework/get-started/overview.md)を参照してください。  
+  
+<a name="choices"></a>   
+## インストールの選択肢  
+ 開発者を対象としたパックをインストールして、Visual Studio や他の開発環境で .NET Framework の最新バージョンに合わせた開発を行います。または、再頒布可能な .NET Framework をダウンロードして、アプリやコントロールと一緒に配布します。  
+  
+## .NET Framework Developer Pack または Targeting Pack をインストールするには  
+ .NET Framework 4.5.1 または 4.5.2 の Developer Pack と、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] の Targeting Pack、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] または 4.6.2 の Developer Pack は、Visual Studio などの統合開発環境で使用する .NET Framework 4.5.1、4.5.2 または [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]、4.6.1、4.6.2 の参照アセンブリ、言語パック、IntelliSense ファイルを提供します。  Visual Studio を使用している場合、Developer Pack または Targeting Pack をインストールすると、新しいプロジェクトを作成するときに .NET Framework のインストール済みバージョンがターゲットの選択肢に追加されます。  次のいずれかの Developer Pack または Targeting Pack を選択してください。  
+  
+-   [Microsoft .NET Framework 4.6.2 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=780617)  
+  
+-   [Microsoft .NET Framework 4.6.1 Dev Pack](http://go.microsoft.com/fwlink/?LinkId=690706)  
+  
+-   [Microsoft .NET Framework 4.6 Targeting Pack](http://go.microsoft.com/fwlink/?LinkId=528261)  
+  
+-   [.NET Framework 4.5.2 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=397702) により、Windows 8.1 以前、Visual Studio 2013、Visual Studio 2012、または他の IDE にバージョン 4.5.2 をインストールします。  
+  
+-   [.NET Framework 4.5.1 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=324213) により、Visual Studio 2012 または他の IDE にバージョン 4.5.1 をインストールします。  
+  
+ 開発者パックのダウンロード ページから、**\[ダウンロード\]** を選択します。 次に、**\[実行\]** または **\[保存\]** をクリックし、表示される指示に従います。  
+  
+## 再頒布可能な .NET Framework をインストールまたはダウンロードするには  
+ これらのインストーラーは、アプリやコントロールが対象とするバージョンの .NET Framework について、.NET Framework コンポーネントをダウンロードします。 アプリまたはコントロールを実行する各コンピューターにこれらのコンポーネントをインストールする必要があります。 インストーラーはどちらも再頒布可能であるため、自分のアプリのセットアップ プログラムに含めることができます。  
+  
+ ダウンロード ページは複数の言語で提供されますが、多くのダウンロードは英語でのみ提供されます。 追加の言語サポートについては、言語パックをインストールする必要があります。  
+  
+ 次の 2 種類の再頒布可能なインストールが用意されています。  
+  
+-   **Web インストーラー** \(Web ブートストラップ\) は、インストール先のコンピューターのオペレーティング システムに一致する必須コンポーネントと言語パックを Web からダウンロードします。 このパッケージはオフラインのインストーラーよりもかなり小さくなりますが、安定したインターネット接続が必要です。[スタンドアロンの言語パック](#standalone_language_packs)をダウンロードして、追加の言語サポートをインストールできます。  
+  
+-   **オフライン インストーラー** \(スタンドアロン再頒布可能\) には、.NET Framework をインストールするために必要なすべてのコンポーネントが含まれますが、言語パックは含まれていません。 このダウンロードは、Web インストーラーより大きくなります。 オフライン インストーラーはインターネット接続を必要としません。 オフライン インストーラーを実行した後、[スタンドアロンの言語パック](#standalone_language_packs)をダウンロードして、言語サポートをインストールできます。 安定したインターネット接続に依存できない場合は、オフライン インストーラーを使用します。  
+  
+ Web インストーラーとオフライン インストーラーはどちらも、x86 ベースおよび x64 ベースのコンピューター用に設計されていますが \([システム要件](../../../docs/framework/get-started/system-requirements.md)を参照\)、Itanium ベースのコンピューターはサポートしていません。  
+  
+ Microsoft ダウンロード センターから .NET Framework をインストールまたはダウンロードするには、次の手順に従います。 また、表内のリンクを使用して、.exe ファイルを直接ダウンロードすることもできます。  
+  
+1.  インストールする .NET Framework のバージョンのダウンロード ページを開きます。  
+  
+    -   .NET Framework 4.6.2 \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=780597)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=780601)\)  
+  
+    -   .NET Framework 4.6.1 \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=671729)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=671744)\)  
+  
+    -   .NET Framework 4.6 \([Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=528259)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=528233)\)  
+  
+    -   .NET Framework 4.5.2 \([Web インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=397703)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=397706)\)  
+  
+    -   .NET Framework 4.5.1 \([Web インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=310158)または[オフライン インストーラー](http://go.microsoft.com/fwlink/p/?LinkId=310159)\)  
+  
+    -   [.NET Framework 4.5](http://go.microsoft.com/fwlink/p/?LinkId=245484)  
+  
+2.  ダウンロード ページの言語を選択します。 このオプションによって、.NET Framework のローカライズされたリソースがダウンロードされるわけではありません。これは、ダウンロード ページに表示されるテキストにのみ影響します。  
+  
+3.  **\[ダウンロード\]** を選択します。  
+  
+4.  メッセージが表示されたら、システムのアーキテクチャに一致するダウンロードを選択し、**\[次へ\]** を選択してください。  
+  
+5.  ダウンロードのプロンプトが表示される場合:  
+  
+    -   コンピューターに .NET Framework をインストールする場合は、**\[実行\]** を選択し、画面の指示に従います。  
+        または  
+  
+    -   再頒布のために .NET Framework をダウンロードする場合は、**\[保存\]** を選択し、画面の指示に従います。  
+  
+6.  他の言語用のリソースをダウンロードする場合は、次のセクションの手順に従って、1 つ以上の言語パックをインストールします。  
+  
+> [!NOTE]
+>  インストール中に問題が発生した場合は、「[トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)」をご覧ください。  
+  
+ **インストールに関する注意事項:**  
+  
+-   [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]、4.5.2、および [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]、4.6.1、4.6.2 は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のインプレース更新です。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリース、および [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] とそのポイント リリースは [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] を置き換えます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされたシステムにこれらのバージョンをインストールすると、アセンブリが置換されます。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリース、または [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] とそのポイント リリースをアンインストールすると、前に存在していた [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] のファイルも削除されます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] に戻る場合は、そのバージョンとすべての更新プログラムを再インストールする必要があります。 \(「[.NET Framework 4 のインストール](http://go.microsoft.com/fwlink/p/?LinkId=230665)」をご覧ください。\)  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリース、.NET Framework 4.6 とそのポイント リリースをインストールするには、管理者資格情報が必要です。  
+  
+-   .NET Framework 4.5 再頒布可能パッケージは、2012 年 10 月 9 に更新されています。この更新により、Microsoft によって生成および署名されたファイルへのデジタル署名が途中で有効期限切れになるという、デジタル証明書の不適切なタイムスタンプに関連する問題が解決しました。 2012 年 8 月 16 日付けの .NET Framework 4.5 再頒布可能パッケージをインストールしていた場合は、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/p/?LinkId=245484)から最新の再頒布可能パッケージを入手して更新を行うことをお勧めします。 この問題について詳しくは、「[マイクロソフト セキュリティ アドバイザリ \(2749655\)](http://technet.microsoft.com/security/advisory/2749655)」および「[サポート技術情報 2770445](http://support.microsoft.com/kb/2770445)」をご覧ください。  
+  
+<a name="standalone_language_packs"></a>   
+## 言語パックのインストール  
+ 言語パックは、サポートされている言語用にローカライズされたリソース \(翻訳されたエラー メッセージや UI テキストなど\) を含む実行可能ファイルです。 言語パックをインストールしない場合、.NET Framework のエラー メッセージ、その他のテキストは英語で表示されます。  Web インストーラーによって、オペレーティング システムに対応した言語パックが自動的にインストールされますが、追加の言語パックをコンピューターにダウンロードできます。 オフライン インストーラーには言語パックは含まれていません。  
+  
+> [!IMPORTANT]
+>  言語パックには、アプリの実行に必要な .NET Framework コンポーネントは含まれていません。言語パックをインストールする前に、Web インストーラーまたはオフライン インストーラーを実行する必要があります。 既に言語パックをインストールしてある場合は、まず言語パックをアンインストールしてから、.NET Framework をインストールし、言語パックを再インストールします。  
+  
+1.  インストールした .NET Framework のバージョンに対応する言語パックのダウンロード ページを開きます。  
+  
+    -   [.NET Framework 4.6.2 言語パック](http://go.microsoft.com/fwlink/?LinkID=780604)  
+  
+    -   [.NET Framework 4.6.1 言語パック](http://go.microsoft.com/fwlink/?LinkID=671747)  
+  
+    -   [.NET Framework 4.6 言語パック](http://go.microsoft.com/fwlink/?LinkID=528314)  
+  
+    -   [.NET Framework 4.5.2 言語パック](http://go.microsoft.com/fwlink/?LinkId=397701)  
+  
+    -   [.NET Framework 4.5.1 言語パック](http://go.microsoft.com/fwlink/?LinkId=322101)  
+  
+    -   [.NET Framework 4.5 言語パック](http://go.microsoft.com/fwlink/p/?LinkId=245451)  
+  
+2.  言語の一覧で、ダウンロードする言語を選択し、その言語でページを再び読み込まれるまで数秒待ちます。  
+  
+3.  **\[ダウンロード\]** を選択します。  
+  
+ サポートしている言語の一覧を次の表に示します。  
+  
+|言語|カルチャ|  
+|--------|----------|  
+|アラビア|ar|  
+|チェコ語|cs|  
+|デンマーク語|da|  
+|オランダ語|nl|  
+|フィンランド語|fi|  
+|フランス語|fr|  
+|ドイツ語|de|  
+|ギリシャ語|el|  
+|ヘブライ語|he|  
+|ハンガリー語|hu|  
+|イタリア語|it|  
+|日本語|ja|  
+|韓国語|ko|  
+|ノルウェー語|no|  
+|ポーランド語|pl|  
+|ポルトガル語 \(ブラジル\)|pt\-BR|  
+|ポルトガル語 \(ポルトガル\)|pt\-PT|  
+|ロシア語|ru|  
+|簡体字中国語|zh\-CHS|  
+|スペイン語|es|  
+|スウェーデン語|sv|  
+|繁体字中国語|zh\-CHT|  
+|トルコ語|tr|  
+|英語 \(米国\)|en\-US|  
+  
+## 次の手順  
+  
+-   .NET Framework での経験がない場合は、[概要](../../../docs/framework/get-started/overview.md)を参照して、主な概念とコンポーネントの概要を確認してください。  
+  
+-   [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]、4.5.2、4.5.1、4.5 での新機能と機能強化については、「[新機能](../../../docs/framework/whats-new/index.md)」をご覧ください。  
+  
+-   アプリと共に .NET Framework を配置する方法について詳しくは、「[配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)」をご覧ください。  
+  
+-   アプリとの .NET Framework の配置に影響する変更については、「[.NET Framework 4.5 のインストール中のシステム再起動の削減](../../../docs/framework/deployment/reducing-system-restarts.md)」をご覧ください。  
+  
+-   .NET Framework 4 から [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] またはそのポイント リリースのいずれかへのアプリの移行については、「[移行ガイド](../Topic/Migration%20Guide%20to%20the%20.NET%20Framework%204.6%20and%204.5%20.md)」を参照してください。  
+  
+-   .NET Framework のソース コードをオンラインで参照するには、「[.NET Framework Reference Source](http://referencesource.microsoft.com/)」をご覧ください。 この参照ソースは、[Github](https://github.com/Microsoft/referencesource) から入手することもできます。[リファレンス ソースをダウンロード](http://referencesource.microsoft.com/download.html)してオフラインで表示したり、デバッグ中にソース \(パッチや更新を含む\) をステップ実行したりできます。 詳細については、ブログ記事「[A new look for .NET Reference Source \(.NET Reference Source の新しい外観\)](http://blogs.msdn.com/b/dotnet/archive/2014/02/24/a-new-look-for-net-reference-source.aspx)」を参照してください。  
+  
+## 参照  
+ [配置ガイド \(開発者向け\)](../../../docs/framework/deployment/deployment-guide-for-developers.md)   
+ [配置ガイド \(管理者向け\)](../../../docs/framework/deployment/guide-for-administrators.md)   
+ [Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)   
+ [トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)
\ No newline at end of file
diff --git a/docs/framework/install/media/clr-net35-win8.png b/docs/framework/install/media/clr-net35-win8.png
new file mode 100644
index 00000000000..e0836e768f5
Binary files /dev/null and b/docs/framework/install/media/clr-net35-win8.png differ
diff --git a/docs/framework/install/net-framework-3-5-on-windows-8-plus.md b/docs/framework/install/net-framework-3-5-on-windows-8-plus.md
new file mode 100644
index 00000000000..518ab767a33
--- /dev/null
+++ b/docs/framework/install/net-framework-3-5-on-windows-8-plus.md
@@ -0,0 +1,70 @@
+---
+title: "Windows 8、Windows 8.1、および Windows 10 への .NET Framework 3.5 のインストール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 3.5, インストール (Windows 8 への)"
+  - "Windows 8, インストール (.NET Framework 3.5 の)"
+ms.assetid: 3eab3eb4-4573-42ac-98f8-36fb2c22c7d5
+caps.latest.revision: 69
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# Windows 8、Windows 8.1、および Windows 10 への .NET Framework 3.5 のインストール
+.NET Framework は、Windows 上で実行されている多数のアプリケーションに不可欠な部分であり、それらのアプリケーションが実行するための共通の機能を提供します。 開発者に対し、.NET Framework はアプリケーションを作成するための一貫したプログラミング モデルを提供します。 Windows オペレーティング システムを使用している場合は、.NET Framework がコンピューターに既にインストールされている場合があります。 具体的には、[!INCLUDE[win8](../../../includes/win8-md.md)] には [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] が組み込まれており、[!INCLUDE[win81](../../../includes/win81-md.md)] には [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] が組み込まれており、Windows 10 には [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] が組み込まれています。  
+  
+ ただし、.NET Framework 3.5 は [!INCLUDE[win8](../../../includes/win8-md.md)]、[!INCLUDE[win81](../../../includes/win81-md.md)]、または Windows 10 と一緒に自動的にインストールされません。これに依存するアプリケーションを実行するには、.NET Framework 3.5 を別途有効にする必要があります。 これは、3 つの方法のいずれかで呼び出される、Windows Update を使用して行われる必要があります。 以下の方法はすべて、インターネット接続が必要です。  
+  
+-   [必要に応じて .NET Framework 3.5 をインストールする](#OnDemand)  
+  
+-   [コントロール パネルで .NET Framework 3.5 を有効にする](#ControlPanel)  
+  
+-   [.NET Framework 3.5 インストーラーをダウンロードする](http://www.microsoft.com/en-us/download/details.aspx?id=21) \(注: これは .NET Framework を直接ダウンロードするのでなく、Windows Update を呼び出すインストーラーです\)。  
+  
+ インストール中にエラー 0x800f0906、0x800f0907、または 0x800f081f が発生することがあります。その場合は、「[.NET Framework 3.5 インストール エラー: 0x800f0906、0x800f0907、または 0x800f081f](https://support.microsoft.com/en-us/kb/2734782)」を参照してください。 なお、これらのエラーは、[セキュリティ更新プログラム 3005628](https://support.microsoft.com/kb/3005628) をインストールすれば解決することがあります。  
+  
+ 前述の方法がいずれも失敗した場合、またはインターネット接続がない場合は、Windows のインストール メディアを使用する必要があります。 詳細については、[.NET Framework 3.5 のインストール エラーに関する記事](https://support.microsoft.com/en-us/kb/2734782)に記載されているエラー 0x800f0906 用の方法 3 を参照してください。 インストール メディアがいない場合は、「[Windows 8.1 用のインストール メディアを作成する](http://windows.microsoft.com/en-US/windows-8/create-reset-refresh-media?woldogcb=0)」を参照してください。  
+  
+ 重要なメモ:  
+  
+-   通常は、コンピューターからどのバージョンの .NET Framework もアンインストールしないでください。 アプリごとに異なるバージョンのフレームワークに依存していることがあり、.NET Framework の複数のバージョンを 1 台のコンピューターに同時に読み込むことができます。  
+  
+-   .NET Framework 3.5 は、バージョン 2.0 および 3.0 用にビルドされたアプリでも使用されます。  
+  
+-   .NET Framework 3.5 をインストールする前に Windows の言語パックをインストールすると、.NET Framework 3.5 のインストールが失敗することがあります。 Windows の言語パックをインストールする前に .NET Framework 3.5 をインストールしてください。  
+  
+-   Windows CardSpace は [!INCLUDE[win8](../../../includes/win8-md.md)] の .NET Framework 3.5 では使用できません。  
+  
+-   .NET Framework 3.5 のインストール方法については複雑であるため、残念ながら Windows Update とは独立して実行可能なスタンドアロン インストーラーを個別に提供することはできません。 繰り返しますが、その他の方法がすべて失敗した場合は、前述したインストール メディアを使用してください。  
+  
+<a name="OnDemand"></a>   
+## 必要に応じて .NET Framework 3.5 をインストールする  
+ アプリに .NET Framework 3.5 が必要でも、コンピューター上でこのバージョンが有効化されていることを検出できない場合、インストール中またはアプリの初回起動時に次のメッセージ ボックスが表示されます。 .NET Framework 3.5 を有効にするには、このメッセージ ボックスの **\[Install this feature\]** \(この機能のインストール\) を選択します。 このオプションを使用するには、インターネット接続が必要です。  
+  
+ ![Windows 8 に 3.5 をインストールするためのダイアログ ボックス](../../../docs/framework/deployment/media/installdialog.png "installdialog")  
+  
+<a name="ControlPanel"></a>   
+## コントロール パネルで .NET Framework 3.5 を有効にする  
+ コントロール パネルを使用して自分で .NET Framework 3.5 を有効にできます。 このオプションを使用するには、インターネット接続が必要です。  
+  
+1.  キーボードの Windows キー \(![Windows のロゴ](../../../docs/framework/install/media/windowskeyboardlogo.png "Windowskeyboardlogo")\) を押し、「Windows の機能」と入力して、Enter キーを押します。**\[Windows の機能の有効化または無効化\]** ダイアログ ボックスが表示されます。 あるいは、\[コントロール パネル\] を開き、\[プログラム\] の項目をクリックし、\[プログラムと機能\] で \[Windows の機能の有効化または無効化\] をクリックします。  
+  
+2.  **.NET Framework 3.5 \(.NET 2.0 および 3.0 を含む\)** チェック ボックスをオンにして \[OK\] をクリックし、メッセージが表示された場合はコンピューターを再起動します。  
+  
+ WCF スクリプトおよびハンドラー マッピングの機能を必要とする開発者でない限り、Windows Communication Foundation \(WCF\) HTTP アクティブ化用に子項目を選択する必要はありません。  
+  
+ この方法を次のビデオで示します。  
+  
+ ![Windows 8 または 8.1 への .NET Framework のインストール](../../../docs/framework/install/media/clr-net35-win8.png "CLR\_NET35\_Win8")  
+  
+## 参照  
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)
\ No newline at end of file
diff --git a/docs/framework/install/run-net-framework-1-1-apps.md b/docs/framework/install/run-net-framework-1-1-apps.md
new file mode 100644
index 00000000000..1fa01891390
--- /dev/null
+++ b/docs/framework/install/run-net-framework-1-1-apps.md
@@ -0,0 +1,30 @@
+---
+title: "Windows 8、Windows 8.1、または Windows 10 での .NET Framework 1.1 アプリの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 1.1, 実行 (Windows 8 での)"
+  - "Windows 8, 実行 (.NET Framework 1.1 アプリを)"
+ms.assetid: fb14e195-fea5-4561-b9a8-60a67283edb9
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows 8、Windows 8.1、または Windows 10 での .NET Framework 1.1 アプリの実行
+.NET Framework 1.1 は、[!INCLUDE[win8](../../../includes/win8-md.md)]、[!INCLUDE[win81](../../../includes/win81-md.md)]、[!INCLUDE[winserver8](../../../includes/winserver8-md.md)]、[!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)]、または Windows 10 の各オペレーティング システムではサポートされていません。  場合によっては、アプリケーションの実行に .NET Framework 1.1 が特別に指定されています。  このような場合、[!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] またはそれ以降のバージョンで実行するためにアプリケーションをアップグレードするよう、独立ソフトウェア ベンダー \(ISV\) に連絡する必要があります。  詳しくは、「[.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)」を参照してください。  
+  
+## CD またはダウンロード センターからの .NET Framework 1.1 のインストール  
+ [!INCLUDE[win8](../../../includes/win8-md.md)]、[!INCLUDE[win81](../../../includes/win81-md.md)]、[!INCLUDE[winserver8](../../../includes/winserver8-md.md)]、[!INCLUDE[winblue_server_2](../../../includes/winblue-server-2-md.md)]、または Windows 10 に .NET Framework 1.1 を手動でインストールすることはできません。  サポート対象から除外されました。  パッケージをインストールしようとすると、「このバージョンの .NET Framework は以前にインストールしたバージョンと互換性がないため、セットアップを続行できません。」というエラー メッセージが表示されます。 この問題を解決するには、[.NET Framework 3.5 SP1](http://www.microsoft.com/download/details.aspx?id=22) をインストールします。  このバージョンには .NET Framework 2.0 \(.NET Framework 1.1 の次のリリース\) が含まれており、これは [!INCLUDE[win8](../../../includes/win8-md.md)]、[!INCLUDE[win81](../../../includes/win81-md.md)]、および Windows 10 でサポートされています。  .NET Framework の新しいバージョンに自動的に更新されるかどうかを確認するために、常に最初にアプリケーションのインストールを試す必要があります。  更新されない場合は、アプリケーションの更新について ISV に連絡してください。  
+  
+## 参照  
+ [.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)   
+ [Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)
\ No newline at end of file
diff --git a/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md
new file mode 100644
index 00000000000..79abb5ae87b
--- /dev/null
+++ b/docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md
@@ -0,0 +1,72 @@
+---
+title: ".NET Framework のインストールおよびアンインストールのブロックのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, トラブルシューティング (インストールのブロックの)"
+  - "ブロックされた .NET Framework のインストール, トラブルシューティング"
+ms.assetid: c3fdfbc1-ed99-4202-a2b0-8c4f1646385d
+caps.latest.revision: 57
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 39
+---
+# .NET Framework のインストールおよびアンインストールのブロックのトラブルシューティング
+.NET Framework 4.5、4.5.1、4.5.2、4.6、または 4.6.1 の [Web またはオフライン インストーラー](../../../docs/framework/install/guide-for-developers.md)を実行すると、.NET Framework のインストールを妨げたり、ブロックしたりするような問題が発生することがあります。 次の表に、インストールをブロックすることが考えられる問題と、トラブルシューティング情報へのリンクを示します。  
+  
+ この表で、4.5.*x* は .NET Framework 4.5、そのポイント リリースである 4.5.1、4.5.2、4.6、または 4.6.1 を指します。  
+  
+|ブロッキング メッセージ|詳細情報または問題解決のための参照先|  
+|------------------|------------------------|  
+|Microsoft .NET Framework をアンインストールすると、一部のアプリケーションが機能しなくなる可能性があります。|一般に、コンピューターにインストールされている .NET Framework のバージョンはアンインストールしないでください。使用するアプリケーションが .NET Framework の特定のバージョンに依存している可能性があるからです。 詳細については、*概要ガイド*の「[ユーザーにとっての .NET Framework](../../../docs/framework/get-started/index.md#ForUsers)」を参照してください。|  
+|.NET Framework 4.5*.x*\/4.6*.x* \(*言語*\) には、.NET Framework 4.5*.x*\/4.6*.x* が必要です。 ダウンロード センターから .NET Framework 4.5*.x*\/4.6*.x* をインストールしてセットアップを再実行します。|言語パックをインストールする前に、指定された .NET Framework リリースの英語バージョンをインストールする必要があります。 詳細については、インストール ガイドの [言語パックのインストール](../../../docs/framework/install/guide-for-developers.md#standalone_language_packs) に関するセクションを参照してください。|  
+|.NET Framework 4.5*.x*\/4.6*.x* をインストールできません。 このプログラムと互換性がないアプリケーションがコンピューター上に存在します。<br /><br /> または<br /><br /> このプログラムと互換性がないアプリケーションがコンピューター上に存在します。|このメッセージは、通常 .NET Framework のプレビューまたは RC バージョンがインストールされているために表示されます。 プレビューまたは RC バージョンをアンインストールし、セットアップを再実行します。|  
+|このパッケージを使用して .NET Framework 4.5*.x*\/4.6*.x* をアンインストールすることはできません。 コンピューターから .NET Framework 4.5*.x*\/4.6*.x* をアンインストールするには、**コントロール パネル**に移動して、**\[プログラムと機能\]**、**\[インストールされた更新プログラムを表示\]**、Microsoft Windows 更新プログラム \(KB2828152\) の順に選択し、**\[アンインストール\]** を選択します。|インストールしているパッケージによって、.NET Framework のプレビューまたは RC リリースはアンインストールされません。<br /><br /> コントロール パネルからプレビューまたは RC リリースをアンインストールします。|  
+|.NET Framework 4.5*.x*\/4.6*.x* をアンインストールできません。 このプログラムに依存するアプリケーションがコンピューター上に存在します。|一般に、コンピューターから .NET Framework のバージョンをアンインストールしないでください。使用するアプリケーションが .NET Framework の特定のバージョンに依存している可能性があるからです。 詳細については、*概要ガイド*の「[ユーザーにとっての .NET Framework](../../../docs/framework/get-started/index.md#ForUsers)」を参照してください。|  
+|再頒布可能な .NET Framework 4.5*.x*\/4.6*.x* は、このオペレーティング システムには適用されません。 Microsoft ダウンロード センターから使用しているオペレーティング システム用の .NET Framework 4.5*.x*\/4.6*.x* をダウンロードしてください。|サポートされていないプラットフォームに [!INCLUDE[net_v451](../../../includes/net-v451-md.md)]、4.5.2、4.6、または 4.6.1 をインストールしようとしている可能性があります。または、サポートされているすべてのオペレーティング システム用のコンポーネントが含まれていないインストール パッケージを選択しました。 オフライン インストーラー \([4.5.1 用](http://go.microsoft.com/fwlink/p/?LinkId=309493)、[4.5.2 用](http://go.microsoft.com/fwlink/p/?LinkId=397706)、[4.6 用](http://go.microsoft.com/fwlink/p/?LinkId=528233)、または [4.6.1 用](http://go.microsoft.com/fwlink/p/?LinkId=671744)\) を使用してインストールを再実行します。 サポートされているオペレーティング システムの詳細については、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」および「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+|現在、コンピューターでは Windows Server 2008 オペレーティング システムの Server Core インストールが実行されています。 .NET Framework 4.5.*x* には、新しいリリースのオペレーティング システムが必要です。 Windows Server 2008 R2 SP1 以上をインストールし、.NET Framework 4.5.*x* セットアップを再実行してください。|[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] および 4.5.2 は、Windows Server 2008 R2 SP1 以降の Server Core ロールでサポートされています。 「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+|特権が不十分なため、このコンピューターのすべてのユーザーが使用できるようにセットアップを完了できません。 管理者としてログオンし、**セットアップ**を再度実行してください。|.NET Framework をインストールするには、そのコンピューターの管理者である必要があります。|  
+|前のインストールを完了するためにコンピューターの再起動が必要であるため、セットアップを続行できません。 コンピューターを再起動し、セットアップを再度実行してください。|インストールを完了するために、再起動が必要な場合があります。 手順に従って、コンピューターを再起動し、セットアップを再実行します。|  
+|.NET Framework 4.5*.x*\/4.6*.x* \(ENU\) 以降の更新プログラムがコンピューターに既にインストールされています。|アクションは必要ありません。|  
+|.NET Framework Setup cannot be run in Program Compatibility Mode. \(プログラム互換性モードで .NET Framework セットアップを実行できません。\)|この記事で後述する「[プログラムの互換性問題](#compat)」セクションを参照してください。|  
+|.NET Framework 4.5*.x*\/4.6*.x* は、コンポーネント ストアが破損しているためにインストールされませんでした。|詳細については、「[DISM またはシステム更新準備ツールを使用して Windows Update のエラーを修正する](https://support.microsoft.com/en-us/kb/947821)」を参照してください。|  
+|Setup cannot run because the Windows Installer Service is not available on this computer. \(このコンピューターには利用できる Windows インストーラー サービスがないため、セットアップは実行できません。\)|Microsoft サポート オンラインの「[プログラムをインストールまたは更新するときの Windows インストーラー サービス エラー](http://go.microsoft.com/fwlink/p/?LinkId=248684)」を参照してください。|  
+|Setup may not run properly because the Windows Update Service is not available on this computer. \(このコンピューターには利用できる Windows Update サービスがありません。セットアップは正しく実行されない可能性があります。\)|管理者によって、コンピューターが Microsoft Windows Update ではなく Windows Server Update Services \(WSUS\) を使用するように設定されています。 詳細については、「[Windows 8 または Windows Server 2012 で NET Framework 3.5 をインストールしようとするとエラー コードが表示される](http://support.microsoft.com/kb/2734782)」のエラー コード 0x800F0906 に関するセクションを参照してください。<br /><br /> Microsoft サポート オンラインの「[最新版の Windows Update エージェントの入手方法](http://go.microsoft.com/fwlink/p/?LinkId=248437)」も参照してください。|  
+|Setup may not run properly because the Background Intelligent Transfer Service \(BITS\) is not available on this computer. \(このコンピューターには利用できる Background Intelligent Transfer Service \(BITS\) がありません。セットアップは正しく実行されない可能性があります。\)|Microsoft サポート オンラインの「[Windows Vista ベースのコンピューターでバックグラウンド インテリジェント転送サービス \(BITS\) のクラッシュを防止する更新プログラム](http://go.microsoft.com/fwlink/p/?LinkId=248680)」を参照してください。|  
+|.NET Framework 4.5.*.x*\/4.6 は、すでにこのオペレーティング システムの一部です。 再頒布可能な .NET Framework 4.5*.x*\/4.6 をインストールする必要はありません。|アクションなし。 サポートされているオペレーティング システム用の「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+|.NET Framework 4.5*.x*\/4.6*.x* は、このオペレーティング システムではサポートされていません。|サポートされているオペレーティング システム用の「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。<br /><br /> Windows 7 での .NET Framework のインストールに失敗した場合、通常このメッセージは Windows 7 SP1 がインストールされていないことを示します。 Windows 7 システムでは、.NET Framework には Windows 7 SP1 が必要です。 Windows 7 を使用していて Service Pack 1 をインストールしていない場合、.NET Framework をインストールする前に、Service Pack 1 をインストールする必要があります。|  
+|Your computer is currently running a Server Core installation of Windows Server 2008 operating system. \(現在、コンピューターでは Windows Server 2008 オペレーティング システムの Server Core インストールが実行されています。\) .NET Framework 4.5.*x* には、オペレーティング システムまたは Server Core 2008 R2 SP1 の完全なリリースが必要です。 Windows Server 2008 SP2、Windows Server 2008 R2 SP1、Server Core 2008 R2 SP1 のいずれかの完全バージョンをインストールして、.NET Framework 4.5.*x* セットアップを再実行してください。|.NET Framework は、Windows Server 2008 R2 SP1 以降の Server Core ロールでサポートされています。 「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+|.NET Framework 4.5.*x* は既にこのオペレーティング システムの一部として組み込まれていますが、現在は無効になっています \([!INCLUDE[winserver8](../../../includes/winserver8-md.md)] のみ\)。|Windows Web サイトの「[Windows の機能を有効化または無効化する](http://go.microsoft.com/fwlink/p/?LinkId=248438)」を参照してください。|  
+|このセットアップ プログラムは x86 コンピューターのみを対象としています。 x64 コンピューターまたは IA64 コンピューターにはインストールできません。|MSDN ライブラリの「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+|このセットアップ プログラムは x64 コンピューターまたは x86 コンピューターのみを対象としています。 IA64 コンピューターにはインストールできません。|MSDN ライブラリの「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。|  
+  
+<a name="compat"></a>   
+### プログラムの互換性問題  
+ .NET Framework 4.5 またはそのポイント リリースのインストールを Windows プログラム互換性モードで実行すると、1603 エラー コードで失敗するか、ブロックされます。**プログラム互換性アシスタント**には、.NET Framework が正しくインストールされていない可能性が示され、推奨設定を使用して再インストールするよう求められます \(プログラム互換性モード\)。 プログラム互換性モードは、以前の .NET Framework セットアップの実行が失敗するか取り消されたときにプログラム互換性アシスタントによって設定されている可能性もあります。  
+  
+ プログラム互換性モードで .NET Framework インストーラーを実行できません。 このブロッキング問題を解決するには、レジストリ エディターでシステム全体での互換性モードの設定が無効になっていることを確認する必要があります。  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** を選択します。  
+  
+2.  **\[ファイル名を指定して実行\]** ダイアログ ボックスで、「`regedit`」と入力し、**\[OK\]** をクリックします。  
+  
+3.  レジストリ エディターで、次のサブキーを参照します。  
+  
+    -   HKEY\_CURRENT\_USER\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\AppCompatFlags\\Compatibility Assistant\\Persisted  
+  
+    -   HKEY\_CURRENT\_USER\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\AppCompatFlags\\Layers  
+  
+4.  名前の列で、インストールしているバージョンに応じて [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、または 4.6.1 のダウンロード名を検索し、これらのエントリを削除します。 ダウンロード名については、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」の記事を参照してください。  
+  
+5.  バージョン 4.5、4.5.1、4.5.2、4.6、または 4.6.1 の .NET Framework インストーラーを再実行します。  
+  
+## 参照  
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)
\ No newline at end of file
diff --git a/docs/framework/interop/TOC.md b/docs/framework/interop/TOC.md
new file mode 100644
index 00000000000..cfeaa9b98b2
--- /dev/null
+++ b/docs/framework/interop/TOC.md
@@ -0,0 +1,51 @@
+# [方法: タイプ ライブラリへの参照を追加する](how-to-add-references-to-type-libraries.md)
+# [マネージ コードでのプロトタイプの作成](creating-prototypes-in-managed-code.md)
+# [アンマネージ DLL 関数の処理](consuming-unmanaged-dll-functions.md)
+# [相互運用アプリケーションの配置](deploying-an-interop-application.md)
+# [.NET Framework への COM コンポーネントの公開](exposing-com-components.md)
+# [COM ラッパー](com-wrappers.md)
+# [方法: コールバック関数を実装する](how-to-implement-callback-functions.md)
+# [COM への .NET Framework コンポーネントの公開](exposing-dotnet-components-to-com.md)
+# [文字列のマーシャリング](marshaling-strings.md)
+# [DLL 関数を保持するクラスの作成](creating-a-class-to-hold-dll-functions.md)
+# [プラットフォーム呼び出しによるデータのマーシャリング](marshaling-data-with-platform-invoke.md)
+# [タイプ ライブラリのアセンブリとしてのインポート](importing-a-type-library-as-an-assembly.md)
+# [エントリ ポイントの指定](specifying-an-entry-point.md)
+# [COM 呼び出し可能ラッパー](com-callable-wrapper.md)
+# [Blittable 型と非 Blittable 型](blittable-and-non-blittable-types.md)
+# [アンマネージ コードとの相互運用](index.md)
+# [方法: ラッパを手動で作成する](how-to-create-wrappers-manually.md)
+# [さまざまな型の配列のマーシャリング](marshaling-different-types-of-arrays.md)
+# [オブジェクトに対する既定のマーシャリング](default-marshaling-for-objects.md)
+# [コールバック関数](callback-functions.md)
+# [既定のマーシャリングの動作](default-marshaling-behavior.md)
+# [方法: COM ラッパーを作成する](how-to-create-com-wrappers.md)
+# [相互運用固有の属性の適用](applying-interop-attributes.md)
+# [文字セットの指定](specifying-a-character-set.md)
+# [COM 相互運用機能のサンプル: .NET クライアントおよび COM サーバー](com-interop-sample-net-client-and-com-server.md)
+# [COM 相互運用機能のサンプル: COM クライアントおよび .NET サーバー](com-interop-sample-com-client-and-net-server.md)
+# [MsgBox のサンプル](msgbox-sample.md)
+# [文字列に対する既定のマーシャリング](default-marshaling-for-strings.md)
+# [構造体の受け渡し](passing-structures.md)
+# [登録を必要としない COM 相互運用機能](registration-free-com-interop.md)
+# [配列に対する既定のマーシャリング](default-marshaling-for-arrays.md)
+# [COM へのアセンブリの登録](registering-assemblies-with-com.md)
+# [ランタイム呼び出し可能ラッパー](runtime-callable-wrapper.md)
+# [型の等価性と埋め込まれた相互運用機能型](type-equivalence-and-embedded-interop-types.md)
+# [相互運用プロジェクトのコンパイル](compiling-an-interop-project.md)
+# [コールバック メソッドとしてのデリゲートのマーシャ リング](marshaling-a-delegate-as-a-callback-method.md)
+# [方法: HRESULT に例外を割り当てる](how-to-map-hresults-and-exceptions.md)
+# [方法: COM から .NET 型を参照する](how-to-reference-net-types-from-com.md)
+# [方法: Tlbimp.exe を使用してプライマリ相互運用機能アセンブリを生成する](how-to-generate-primary-interop-assemblies-using-tlbimp-exe.md)
+# [方法: マネージ コード DCOM を WCF に移行する](how-to-migrate-managed-code-dcom-to-wcf.md)
+# [相互運用のための .NET 型の要件](qualifying-net-types-for-interoperation.md)
+# [方法: プライマリ相互運用機能アセンブリを登録する](how-to-register-primary-interop-assemblies.md)
+# [方法: 相互運用機能アセンブリをタイプ ライブラリから生成する](how-to-generate-interop-assemblies-from-type-libraries.md)
+# [COM 用のアセンブリのパッケージ化](packaging-an-assembly-for-com.md)
+# [方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する](configure-net-framework-based-com-components-for-reg.md)
+# [プラットフォーム呼び出しの例](platform-invoke-examples.md)
+# [相互運用マーシャリング](interop-marshaling.md)
+# [DLL 関数の呼び出し](calling-a-dll-function.md)
+# [COM 相互運用機能によるデータのマーシャリング](marshaling-data-with-com-interop.md)
+# [クラス、構造体、および共用体のマーシャリング](marshaling-classes-structures-and-unions.md)
+# [コピーと固定](copying-and-pinning.md)
diff --git a/docs/framework/interop/applying-interop-attributes.md b/docs/framework/interop/applying-interop-attributes.md
new file mode 100644
index 00000000000..f85f89d57e2
--- /dev/null
+++ b/docs/framework/interop/applying-interop-attributes.md
@@ -0,0 +1,85 @@
+---
+title: "相互運用固有の属性の適用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 公開 (COM にコンポーネントを)"
+  - "属性 [.NET Framework], 変換ツール"
+  - "属性 [.NET Framework], デザイン時機能"
+  - "属性 [.NET Framework], 相互運用固有の"
+  - "COM 相互運用機能, 適用 (属性を)"
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "変換ツール属性"
+  - "デザイン時属性"
+  - "相互運用 (アンマネージ コードとの), 適用 (属性を)"
+  - "相互運用 (アンマネージ コードとの), 公開 (.NET Framework コンポーネントを)"
+ms.assetid: b6014613-641c-4912-9e2f-83a99210a037
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 相互運用固有の属性の適用
+<xref:System.Runtime.InteropServices> 名前空間では、デザイン時に作成者が適用する属性、変換処理中に COM 相互運用ツールおよび API によって適用される属性、作成者または COM 相互運用機能によって適用される属性という 3 種類の相互運用固有の属性が提供されます。  
+  
+ マネージ コードに属性を適用する作業に習熟していない場合は、「[属性を使用したメタデータの拡張](../../../docs/standard/attributes/index.md)」を参照してください。  他のカスタム属性の場合と同様に、相互運用固有の属性は、型、メソッド、プロパティ、パラメーター、フィールド、およびその他のメンバーに対して適用できます。  
+  
+## デザイン時属性  
+ COM 相互運用ツールおよび API によって実行された変換処理の結果を調整するには、デザイン時属性を使用します。  マネージ ソース コードに適用できる属性の説明を次の表に示します。  COM 相互運用ツールがこの表で示す属性を適用できる場合もあります。  
+  
+|属性|Description|  
+|--------|-----------------|  
+|<xref:System.Runtime.InteropServices.AutomationProxyAttribute>|Automation Marshaler またはカスタムのプロキシとスタブを使用して、型をマーシャリングするかどうかを指定します。|  
+|<xref:System.Runtime.InteropServices.ClassInterfaceAttribute>|クラスに対して生成されたインターフェイスの型を制御します。|  
+|<xref:System.Runtime.InteropServices.CoClassAttribute>|タイプ ライブラリからインポートされた元のコクラスの CLSID を識別します。<br /><br /> COM 相互運用ツールでは、通常この属性が適用されます。|  
+|<xref:System.Runtime.InteropServices.ComImportAttribute>|コクラスまたはインターフェイス定義が COM タイプ ライブラリからインポートされたことを示します。  ランタイムは、このフラグを使ってその型をアクティブ化およびマーシャリングする方法を識別します。  この属性は、型がタイプ ライブラリにエクスポートされることを禁止します。<br /><br /> COM 相互運用ツールでは、通常この属性が適用されます。|  
+|<xref:System.Runtime.InteropServices.ComRegisterFunctionAttribute>|COM から使用するためにアセンブリを登録するときに、メソッドが呼び出されるようにします。これによって、登録処理中にユーザー作成コードを実行できます。|  
+|<xref:System.Runtime.InteropServices.ComSourceInterfacesAttribute>|クラスのイベントの発生元になるインターフェイスを識別します。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.ComUnregisterFunctionAttribute>|アセンブリが COM から登録解除されるときメソッドが呼び出されるようにして、登録解除処理中にユーザー作成コードを実行できるようにします。|  
+|<xref:System.Runtime.InteropServices.ComVisibleAttribute>|この属性の値を **false** に設定すると、型を COM から参照できなくなります。  この属性は、COM の参照可能範囲を制御するために、個別の型またはアセンブリ全体に適用できます。  既定では、すべてのパブリックなマネージ型は参照可能なので、この属性を使ってこれらの型を参照可能にする必要はありません。|  
+|<xref:System.Runtime.InteropServices.DispIdAttribute>|メソッドまたはフィールドの COM ディスパッチ識別子 \(DISPID: Dispatch Identifier\) を指定します。  この属性には、対象のメソッド、フィールド、またはプロパティの DISPID が含まれています。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.FieldOffsetAttribute>|**StructLayoutAttribute** と共に使用すると、クラス内の各フィールドの物理的位置を示します。さらに、**LayoutKind** が Explicit に設定されます。|  
+|<xref:System.Runtime.InteropServices.GuidAttribute>|クラス、インターフェイス、またはタイプ ライブラリ全体のグローバル一意識別子 \(GUID: Globally Unique Identifier\) を指定します。  この属性に渡す文字列は、**System.Guid** 型の受け入れ可能なコンストラクターの引数の形式であることが必要です。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|[IDispatchImpAttribute](frlrfsystemruntimeinteropservicesidispatchimplattributeclasstopic)|COM にデュアル インターフェイスやディスパッチ インターフェイスを公開するときに、共通言語ランタイムで使用する **IDispatch** インターフェイスの実装の種類を示します。|  
+|<xref:System.Runtime.InteropServices.InAttribute>|呼び出し元に対してデータをマーシャリングして渡すことを示します。  属性パラメーターに対して使用できます。|  
+|<xref:System.Runtime.InteropServices.InterfaceTypeAttribute>|マネージ インターフェイスを COM クライアントに公開する方法を制御します \(デュアル、IUnknown ベース、または IDispatch 限定のいずれか\)。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.LCIDConversionAttribute>|アンマネージ メソッド シグネチャが LCID パラメーターを期待していることを示します。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.MarshalAsAttribute>|マネージ コードとアンマネージ コードとの間で、フィールドまたはパラメーター内のデータをマーシャリングする方法を示します。  各データ型には既定のマーシャリング動作があるため、この属性は常に省略できます。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.OptionalAttribute>|パラメーターが省略可能であることを示します。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.OutAttribute>|フィールドまたはパラメーター内のデータが、呼び出されたオブジェクトから呼び出し元に返されるときに、マーシャリングされる必要のあることを示します。|  
+|<xref:System.Runtime.InteropServices.PreserveSigAttribute>|通常は相互運用呼び出しのときに発生する、HRESULT または retval シグネチャ変換を抑止します。  この属性は、タイプ ライブラリのエクスポートだけでなく、マーシャリングにも影響します。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+|<xref:System.Runtime.InteropServices.ProgIdAttribute>|.NET Framework クラスの ProgID を指定します。  属性クラスに対して使用できます。|  
+|<xref:System.Runtime.InteropServices.StructLayoutAttribute>|クラスのフィールドの物理レイアウトを制御します。<br /><br /> COM 相互運用ツールでは、この属性を適用できます。|  
+  
+## 変換ツールの属性  
+ 変換処理中に COM 相互運用ツールが適用する属性の説明を次の表に示します。  これらの属性は、デザイン時には適用しません。  
+  
+|属性|Description|  
+|--------|-----------------|  
+|<xref:System.Runtime.InteropServices.ComAliasNameAttribute>|パラメーターまたはフィールド型の COM エイリアスを示します。  属性パラメーター、フィールド、または戻り値に対して使用できます。|  
+|<xref:System.Runtime.InteropServices.ComConversionLossAttribute>|クラスまたはインターフェイスに関する情報が、タイプ ライブラリからアセンブリにインポートされるときに失われたことを示します。|  
+|<xref:System.Runtime.InteropServices.ComEventInterfaceAttribute>|ソース インターフェイスと、イベント インターフェイスのメソッドを実装するクラスを識別します。|  
+|<xref:System.Runtime.InteropServices.ImportedFromTypeLibAttribute>|アセンブリが元は COM タイプ ライブラリからインポートされたことを示します。  この属性は、元のタイプ ライブラリのタイプ ライブラリ定義を含んでいます。|  
+|<xref:System.Runtime.InteropServices.TypeLibFuncAttribute>|元はこの関数のために COM タイプ ライブラリからインポートされた **FUNCFLAGS** を含んでいます。|  
+|<xref:System.Runtime.InteropServices.TypeLibTypeAttribute>|元はこの型のために COM タイプ ライブラリからインポートされた **TYPEFLAGS** を含んでいます。|  
+|<xref:System.Runtime.InteropServices.TypeLibVarAttribute>|元はこの変数のために COM タイプ ライブラリからインポートされた **VARFLAGS** を含んでいます。|  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices>   
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [属性](../../../docs/standard/attributes/index.md)   
+ [相互運用のための .NET 型の要件](../../../docs/framework/interop/qualifying-net-types-for-interoperation.md)   
+ [COM 用のアセンブリのパッケージ化](../../../docs/framework/interop/packaging-an-assembly-for-com.md)
\ No newline at end of file
diff --git a/docs/framework/interop/blittable-and-non-blittable-types.md b/docs/framework/interop/blittable-and-non-blittable-types.md
new file mode 100644
index 00000000000..9119929cc22
--- /dev/null
+++ b/docs/framework/interop/blittable-and-non-blittable-types.md
@@ -0,0 +1,87 @@
+---
+title: "Blittable 型と非 Blittable 型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "blittable 型, 相互運用マーシャリング"
+  - "相互運用マーシャリング, blittable 型"
+ms.assetid: d03b050e-2916-49a0-99ba-f19316e5c1b3
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# Blittable 型と非 Blittable 型
+多くのデータ型の場合、マネージ メモリでもアンマネージ メモリでもその表現は共通するため、相互運用マーシャラーによる特別な処理は必要ありません。  これらの型は、マネージ コードとアンマネージ コード間で受け渡しするときに変換する必要がないため、*blittable 型*と呼ばれます。  
+  
+ プラットフォーム呼び出しから返される構造体は blittable 型であることが必要です。  プラットフォーム呼び出しでは、戻り値の型として非 blittable 型の構造体をサポートしません。  
+  
+ <xref:System> 名前空間に属する次の型は blittable 型です。  
+  
+-   <xref:System.Byte?displayProperty=fullName>  
+  
+-   <xref:System.SByte?displayProperty=fullName>  
+  
+-   <xref:System.Int16?displayProperty=fullName>  
+  
+-   <xref:System.UInt16?displayProperty=fullName>  
+  
+-   <xref:System.Int32?displayProperty=fullName>  
+  
+-   <xref:System.UInt32?displayProperty=fullName>  
+  
+-   <xref:System.Int64?displayProperty=fullName>  
+  
+-   <xref:System.UInt64?displayProperty=fullName>  
+  
+-   <xref:System.IntPtr?displayProperty=fullName>  
+  
+-   <xref:System.UIntPtr?displayProperty=fullName>  
+  
+-   <xref:System.Single?displayProperty=fullName>  
+  
+-   <xref:System.Double?displayProperty=fullName>  
+  
+ 次の複合型も blittable 型です。  
+  
+-   整数の配列など、blittable 型の 1 次元配列。  ただし、blittable 型の可変配列を含む型自体は blittable ではありません。  
+  
+-   blittable 型だけを含む、書式指定された値型 \(および、それらが書式指定された型としてマーシャリングされる場合はクラス\)。  書式指定された値型の詳細については、「[Default Marshaling for Value Types](http://msdn.microsoft.com/ja-jp/4d9a876c-e05a-40ba-bd85-bd22877f984a)」を参照してください。  
+  
+ オブジェクト参照は blittable ではありません。  これには、単独では blittable なオブジェクトへの参照の配列も含まれます。  たとえば、blittable な構造体は定義できますが、それらの構造体への参照の配列を含む blittable 型は定義できません。  
+  
+ blittable 型の配列と、blittable 型のメンバーだけを含むクラスは、最適化のために、マーシャリング時にコピーされるのではなく[固定](../../../docs/framework/interop/copying-and-pinning.md)されます。  これらの型は、呼び出し元と呼び出し先が同じアパートメントに属する場合には、In\/Out パラメーターとしてマーシャリングされるように見えることがあります。  ただし、そのような型は実際には In パラメーターとしてマーシャリングされるため、引数を In\/Out パラメーターとしてマーシャリングする必要がある場合には、<xref:System.Runtime.InteropServices.InAttribute> 属性と <xref:System.Runtime.InteropServices.OutAttribute> 属性を適用する必要があります。  
+  
+ 一部のマネージ データ型は、アンマネージ環境では異なる表現が必要です。  これらの非 blittable データ型は、マーシャリングできる形式に変換する必要があります。  たとえば、マネージ文字列は、文字列オブジェクトに変換しないとマーシャリングできないので、非 blittable 型です。  
+  
+ <xref:System> 名前空間に属する非 blittable 型を次の表に示します。  [デリゲート](http://msdn.microsoft.com/ja-jp/d176ee76-f982-494b-b03d-92e4118896e2)は静的メソッドまたはクラス インスタンスを参照するデータ構造体ですが、これも非 blittable 型です。  
+  
+|非 blittable 型|Description|  
+|-------------------|-----------------|  
+|[System.Array](../../../docs/framework/interop/default-marshaling-for-arrays.md)|C スタイルの配列または `SAFEARRAY` に変換されます。|  
+|[System.Boolean](http://msdn.microsoft.com/ja-jp/d4c00537-70f7-4ca6-8197-bfc1ec037ff9)|1、2、または 4 バイトの値に変換されます。`true` の場合は 1、それ以外の場合は \-1 になります。|  
+|[System.Char](http://msdn.microsoft.com/ja-jp/cecc87c1-075e-4cde-aa56-33d189f66feb)|Unicode 文字または ANSI 文字に変換されます。|  
+|[System.Class](http://msdn.microsoft.com/ja-jp/fe334af5-0123-43d8-be84-26f6f023ddb6)|クラス インターフェイスに変換されます。|  
+|[System.Object](../../../docs/framework/interop/default-marshaling-for-objects.md)|バリアントまたはインターフェイスに変換されます。|  
+|[System.Mdarray](../../../docs/framework/interop/default-marshaling-for-arrays.md)|C スタイルの配列または `SAFEARRAY` に変換されます。|  
+|[System.String](../../../docs/framework/interop/default-marshaling-for-strings.md)|null 参照で終わる文字列または BSTR に変換されます。|  
+|[System.Valuetype](http://msdn.microsoft.com/ja-jp/4d9a876c-e05a-40ba-bd85-bd22877f984a)|固定メモリ レイアウトを持つ構造体に変換されます。|  
+|[System.Szarray](../../../docs/framework/interop/default-marshaling-for-arrays.md)|C スタイルの配列または `SAFEARRAY` に変換されます。|  
+  
+ クラス型とオブジェクト型は COM 相互運用機能によってだけサポートされます。  [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)]、C\#、および C\+\+ の対応する型については、「[クラス ライブラリの概要](../../../docs/standard/class-library-overview.md)」を参照してください。  
+  
+## 参照  
+ [既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/interop/callback-functions.md b/docs/framework/interop/callback-functions.md
new file mode 100644
index 00000000000..7ff3c7d1827
--- /dev/null
+++ b/docs/framework/interop/callback-functions.md
@@ -0,0 +1,41 @@
+---
+title: "コールバック関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "callback 関数"
+  - "プラットフォーム呼び出し, 呼び出し (アンマネージ関数の)"
+ms.assetid: c0aa8533-3b3b-42e8-9f60-84919793098c
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# コールバック関数
+コールバック関数は、アンマネージ DLL 関数が作業を完了できるようにするためのマネージ アプリケーション内のコードです。  コールバック関数への呼び出しは、マネージ アプリケーションから DLL 関数を通じて間接的に渡され、マネージ実装に返されます。  プラットフォーム呼び出しで呼び出される DLL 関数の中には、マネージ コードにコールバック関数が記述されていないと、正しく実行できない関数があります。  
+  
+ ほとんどの DLL 関数の場合、マネージ コードから呼び出すには関数のマネージ定義を作成して、それを呼び出します。  この処理は簡単です。  
+  
+ コールバック関数を必要とする DLL 関数を使用する場合は、追加の手順が必要になります。  最初に、関数のドキュメントを参照して、その関数がコールバックを必要とするかどうかを判断します。  次に、マネージ アプリケーション内にコールバック関数を作成します。  最後に、コールバック関数に引数としてポインターを渡し、DLL 関数を呼び出します。  これらのステップを要約した図を次に示します。  
+  
+ ![プラットフォーム呼び出しコールバック](../../../docs/framework/interop/media/pinvokecallback.gif "pinvokecallback")  
+コールバック関数とその実装  
+  
+ コールバック関数は、繰り返し実行されるタスクがある状況での使用に適しています。  もう 1 つの一般的な使い方として、Win32 API の **EnumFontFamilies**、**EnumPrinters**、**EnumWindows** などの列挙関数と組み合わせる方法があります。  **EnumWindows** 関数は、コンピューター上の既存のウィンドウすべてで列挙し、コールバック関数を呼び出して各ウィンドウでタスクを実行します。  手順と例については、「[方法 : コールバック関数を実装する](../../../docs/framework/interop/how-to-implement-callback-functions.md)」を参照してください。  
+  
+## 参照  
+ [方法: コールバック関数を実装する](../../../docs/framework/interop/how-to-implement-callback-functions.md)   
+ [DLL 関数の呼び出し](../../../docs/framework/interop/calling-a-dll-function.md)
\ No newline at end of file
diff --git a/docs/framework/interop/calling-a-dll-function.md b/docs/framework/interop/calling-a-dll-function.md
new file mode 100644
index 00000000000..68d5eddb5c6
--- /dev/null
+++ b/docs/framework/interop/calling-a-dll-function.md
@@ -0,0 +1,51 @@
+---
+title: "DLL 関数の呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, プラットフォーム呼び出し"
+  - "DLL 関数"
+  - "相互運用 (アンマネージ コードとの), プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し, 呼び出し (アンマネージ関数の)"
+  - "アンマネージ関数"
+  - "アンマネージ関数, 呼び出し"
+ms.assetid: 113646de-7ea0-4f0e-8df0-c46dab3e8733
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# DLL 関数の呼び出し
+アンマネージ DLL 関数の呼び出しは、他のマネージ コードの呼び出しとほとんど同じですが、DLL 関数を十分理解するまでは混乱しやすい相違点があります。  このセクションでは、呼び出しに関連する特殊な問題について説明するトピックを示します。  
+  
+ プラットフォーム呼び出しから返される構造体は、マネージ コードとアンマネージ コードで同じ表現になるデータ型である必要があります。  このような型は、変換する必要がないため、*blittable 型*と呼ばれます \(「[Blittable 型と非 Blittable 型](../../../docs/framework/interop/blittable-and-non-blittable-types.md)」を参照してください\)。  戻り値の型が非 blittable 型の構造体である関数を呼び出すためには、非 blittable 型と同じサイズの blittable ヘルパー型を定義し、関数から制御が戻った後にデータを変換します。  
+  
+## このセクションの内容  
+ [構造体の受け渡し](../../../docs/framework/interop/passing-structures.md)  
+ 定義済みレイアウトのデータ構造体を渡すときに生じる問題点を特定します。  
+  
+ [コールバック関数](../../../docs/framework/interop/callback-functions.md)  
+ コールバック機能に関する基本的な情報を提供します。  
+  
+ [方法 : コールバック関数を実装する](../../../docs/framework/interop/how-to-implement-callback-functions.md)  
+ マネージ コードにコールバック関数を実装する方法を説明します。  
+  
+## 関連項目  
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)  
+ プラットフォーム呼び出しを使ってアンマネージ DLL 関数を呼び出す方法を説明します。  
+  
+ [プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)  
+ メソッドのパラメーターの宣言方法と、アンマネージ ライブラリによってエクスポートされる関数に引数を渡す方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/interop/com-callable-wrapper.md b/docs/framework/interop/com-callable-wrapper.md
new file mode 100644
index 00000000000..345408ead47
--- /dev/null
+++ b/docs/framework/interop/com-callable-wrapper.md
@@ -0,0 +1,196 @@
+---
+title: "COM 呼び出し可能ラッパー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "呼び出し可能ラッパー"
+  - "CCW"
+  - "COM 呼び出し可能ラッパー"
+  - "COM 相互運用機能, COM ラッパー"
+  - "COM ラッパー"
+  - "相互運用 (アンマネージ コードとの), COM ラッパー"
+ms.assetid: d04be3b5-27b9-4f5b-8469-a44149fabf78
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# COM 呼び出し可能ラッパー
+COM クライアントが .NET オブジェクトを呼び出すと、共通言語ランタイムがマネージ オブジェクトとそのオブジェクトのための COM 呼び出し可能ラッパー \(CCW: COM Callable Wrapper\) を作成します。  COM クライアントは .NET オブジェクトを直接参照できないため、CCW をマネージ オブジェクトのプロキシとして使用します。  
+  
+ ランタイムは、サービスを要求している COM クライアントの数に関係なく、1 つのマネージ オブジェクトに対して 1 つの CCW を作成します。  次の図に示すように、複数の COM クライアントが、INew インターフェイスを公開する CCW への参照を保持できます。  CCW は、INew インターフェイスを実装するマネージ オブジェクトへの 1 つの参照を保持し、ガベージ コレクションされます。  COM クライアントと .NET クライアントは、同一のマネージ オブジェジェクトに対して同時に要求できます。  
+  
+ ![COM 呼び出し可能ラッパー](../../../docs/framework/interop/media/ccw.gif "ccw")  
+COM 呼び出し可能ラッパー経由の .NET オブジェクト アクセス  
+  
+ CCW は、.NET Framework. 内で実行されている他のクラスからは見えません。  CCW の主な目的は、マネージ コードとアンマネージ コードの間の呼び出しをマーシャリングすることですが、CCW は、CCW にラップされているマネージ オブジェクトのオブジェクト ID やオブジェクトの有効期間の管理も行います。  
+  
+## オブジェクト ID  
+ ランタイムは、ランタイムのガベージ コレクション ヒープから .NET オブジェクトにメモリを割り当てます。これにより、ランタイムは、メモリ内で必要に応じてオブジェクトを移動させることができます。  一方、CCW に対して、ランタイムは、コレクション ヒープ以外からメモリを割り当てます。これにより、COM クライアントはラッパーを直接参照できます。  
+  
+## オブジェクトの有効期間  
+ CCW にラップされている .NET クライアントとは異なり、CCW は、従来の COM 方式で参照カウントを使用します。  CCW の参照カウントが 0 \(ゼロ\) に達すると、ラッパーはマネージ オブジェクトの参照を解放します。  参照が残っていないマネージ オブジェクトは、次のガベージ コレクション サイクルで収集されます。  
+  
+## COM インターフェイスのシミュレート  
+ [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md) \(CCW\) は、パブリックで COM から参照できるすべてのインターフェイス、データ型、および戻り値を、COM によるインターフェイス ベースの対話の適用と整合性のある方法で COM クライアントに公開します。  COM クライアントの場合、.NET Framework オブジェクトのメソッドを呼び出すことは COM オブジェクトのメソッドを呼び出すことと同じです。  
+  
+ このシームレスなアプローチを実現するために、CCW は **IUnknown** や **IDispatch** などの従来の COM インターフェイスを製造します。  次の図が示すように、CCW は、ラップしている .NET オブジェクトの 1 つの参照を保持します。  COM クライアントと .NET オブジェクトの両方は、CCW のプロキシとスタブ構築を介して相互に対話します。  
+  
+ ![COM インターフェイス](../../../docs/framework/interop/media/ccwwithinterfaces.gif "ccwwithinterfaces")  
+COM インターフェイスおよび COM 呼び出し可能ラッパー  
+  
+ マネージ環境でクラスによって明示的実装されるインターフェイスを公開するだけでなく、.NET Framework は、オブジェクトの代わりに、次の表にリストされている COM インターフェイスの実装を提供します。  .NET クラスは、これらのインターフェイスの独自の実装を提供することで、既定の動作をオーバーライドできます。  ただし、ランタイムは **IUnknown** と **IDispatch** インターフェイス実装を常に提供します。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|**Idispatch**|型への遅延バインディングのメカニズムを提供します。|  
+|**IerrorInfo**|エラー、そのソース、ヘルプ ファイル、ヘルプ コンテキスト、およびエラーを定義したインターフェイスの GUID \(.NET クラスでは常に **GUID\_NULL**\) に関する説明文を示します。|  
+|**IprovideClassInfo**|マネージ クラスによって実装される **ITypeInfo** インターフェイスに COM クライアントがアクセスできるようにします。|  
+|**IsupportErrorInfo**|マネージ オブジェクトが **IErrorInfo** インターフェイスをサポートするかどうかを COM クライアントが判別できるようにします。  その場合は、クライアントが最新の例外オブジェクトへのポインターを取得できるようにします。  すべてのマネージ型は、**IErrorInfo** インターフェイスをサポートします。|  
+|**ItypeInfo**|Tlbexp.exe によって生成された型情報と完全に等しい、クラスの型情報を提供します。|  
+|**Iunknown**|COM クライアントが CCW の有効期間を管理し、強制型変換を提供するための、**IUnknown** インターフェイスの標準的な実装を提供します。|  
+  
+ マネージ クラスは、次の表で説明されている COM インターフェイスを提供することもできます。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|\(\_*classname*\) クラス インターフェイス|マネージ オブジェクトで明示的に公開されている、すべてのパブリック インターフェイス、メソッド、プロパティ、およびフィールドを公開する、ランタイムによって公開され、明示的に定義されていない、インターフェイス、|  
+|**IConnectionPoint** と **IconnectionPointContainer**|デリゲート ベースのソース イベント \(イベント サブスクライバーを登録するためのインターフェイス\) を供給するオブジェクトのインターフェイス。|  
+|**IdispatchEx**|クラスが **IExpando** を実装する場合、ランタイムによって提供されているインターフェイス。  **IDispatchEx** インターフェイスは、**IDispatch** インターフェイスの拡張版で、**IDispatch** とは異なり、列挙、追加、削除、および大文字小文字を区別したメンバーの呼び出しが可能になります。|  
+|**IEnumVARIANT**|クラスが **IEnumerable** を実装する場合、コレクション内のオブジェクトを列挙するコレクション型クラスのインターフェイス。|  
+  
+## クラス インターフェイスの概要  
+ マネージ コードで明示的に定義されていないクラス インターフェイスは、.NET オブジェクトで明示的に公開されるすべてのパブリック メソッド、プロパティ、フィールド、およびイベントを公開するインターフェイスです。  このインターフェイスは、デュアルまたはディスパッチ専用インターフェイスです。  クラス インターフェイスは、前にアンダー スコアの付いた、.NET クラス自体の名前を受け取ります。  たとえば、クラス Mammal の場合、クラス インターフェイスは \_Mammal です。  
+  
+ 派生クラスの場合、クラス インターフェイスは、基本クラスのすべてのパブリック メソッド、プロパティ、およびフィールドも公開します。  派生クラスは、各基本クラスのクラス インターフェイスも公開します。  たとえば、クラス Mammal がクラス MammalSuperclass を拡張し、そのクラスがさらに System.Object を拡張する場合、.NET オブジェクトは COM クライアントに \_Mammal、\_MammalSuperclass、および \_Object という名前の 3 つのクラス インターフェイスを公開します。  
+  
+ たとえば、次の .NET クラスを考えます。  
+  
+```vb  
+' Applies the ClassInterfaceAttribute to set the interface to dual.  
+<ClassInterface(ClassInterfaceType.AutoDual)> _  
+' Implicitly extends System.Object.  
+Public Class Mammal  
+    Sub Eat()  
+    Sub Breathe()  
+    Sub Sleep()  
+End Class  
+  
+```  
+  
+```csharp  
+// Applies the ClassInterfaceAttribute to set the interface to dual.  
+[ClassInterface(ClassInterfaceType.AutoDual)]  
+// Implicitly extends System.Object.  
+public class Mammal  
+{  
+    void  Eat();  
+    void  Breathe():  
+    void  Sleep();  
+}  
+```  
+  
+ COM クライアントは、`_Mammal` という名前のクラス インターフェイスへのポインターを取得できます。これについては、[タイプ ライブラリ エクスポーター \(Tlbexp.exe\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md) ツールで生成されるタイプ ライブラリで説明されています。  `Mammal` クラスが 1 つ以上のインターフェイスを実装した場合、それらのインターフェイスはコクラスの下に表示されます。  
+  
+```  
+[odl, uuid(…), hidden, dual, nonextensible, oleautomation]  
+interface _Mammal : IDispatch  
+{  
+    [id(0x00000000), propget] HRESULT ToString([out, retval] BSTR*  
+        pRetVal);  
+    [id(0x60020001)] HRESULT Equals([in] VARIANT obj, [out, retval]  
+        VARIANT_BOOL* pRetVal);  
+    [id(0x60020002)] HRESULT GetHashCode([out, retval] short* pRetVal);  
+    [id(0x60020003)] HRESULT GetType([out, retval] _Type** pRetVal);  
+    [id(0x6002000d)] HRESULT Eat();  
+    [id(0x6002000e)] HRESULT Breathe();  
+    [id(0x6002000f)] HRESULT Sleep();  
+}  
+[uuid(…)]  
+coclass Mammal   
+{  
+    [default] interface _Mammal;  
+}  
+```  
+  
+ クラス インターフェイスの生成はオプションです。  既定では、COM 相互運用が、タイプ ライブラリにエクスポートするクラスごとにディスパッチ専用インターフェイスを生成します。  <xref:System.Runtime.InteropServices.ClassInterfaceAttribute> をクラスに適用することによって、このインターフェイスの自動作成を防止または変更することができます。  クラス インターフェイスにより、マネージ クラスを COM に公開する作業負担を軽減できますが、その使用は制限されています。  
+  
+> [!CAUTION]
+>  独自のものを明示的に定義する代わりにクラス インターフェイスを使用すると、マネージ クラスの将来のバージョン管理が複雑になることがあります。  クラス インターフェイスを使用する前に、次のガイドラインを参照してください。  
+  
+### クラス インターフェイスを生成するのではなく、COM クライアントが使用する明示的なインターフェイスを定義します。  
+ COM 相互運用はクラス インターフェイスを自動的に生成するため、クラスにバージョン後の変更が生じると、共通言語ランタイムによって公開されているクラス インターフェイスのレイアウトが変更されることがあります。  COM クライアントは通常、インターフェイスのレイアウトの変更を処理するように準備されていないため、クラスのメンバー レイアウトを変更した場合に、クライアントが破損します。  
+  
+ このガイドラインは、COM クライアントに公開されるインターフェイスは変更不可にしておく必要があるという概念を促進しています。  間違えてインターフェイスのレイアウトを並べ替えることで COM クライアントが破損するリスクを抑えるため、インターフェイスを明示的に定義して、クラスに対するすべての変更をインターフェイス レイアウトから分離します。  
+  
+ **ClassInterfaceAttribute** を使用してクラス インターフェイスの自動生成を中止し、次のコード フラグメントに示すように、クラスの明示的なインターフェイスを実装します。  
+  
+```vb  
+<ClassInterface(ClassInterfaceType.None)>Public Class LoanApp  
+    Implements IExplicit  
+    Sub M() Implements IExplicit.M  
+…  
+End Class  
+  
+```  
+  
+```csharp  
+[ClassInterface(ClassInterfaceType.None)]  
+public class LoanApp : IExplicit {  
+    void M();  
+}  
+```  
+  
+ **ClassInterfaceType.None** 値により、クラス メタデータをタイプ ライブラリにエクスポートするときに、クラス インターフェイスが生成されなくなります。  前の例では、COM クライアントは `IExplicit` インターフェイスを通してのみ `LoanApp` クラスにアクセスできます。  
+  
+### ディスパッチ識別子 \(DISPID\) をキャッシュしないようにします。  
+ クラス インターフェイスの使用は、インターフェイス メンバーの DISPID をキャッシュしていないスクリプト化されたクライアント、Microsoft Visual Basic 6.0 クライアント、または遅延バインディング クライアントのために許容されるオプションです。  DISPID は遅延バインディングを有効にするインターフェイス メンバーを特定します。  
+  
+ クラス インターフェイスでは、インターフェイス内のメンバーの位置に基づいて DISPID が生成されます。  メンバーの順序を変更してクラスをタイプ ライブラリにエクスポートすると、クラス インターフェイスで生成される DISPID が変更されます。  
+  
+ クラス インターフェイスを使用するとき、遅延バインドされた COM クライアントの中断を回避するには、**ClassInterfaceAttribute** に **ClassInterfaceType.AutoDispatch** 値を指定して適用します。  この値は、ディスパッチ専用のクラスのインターフェイスを実装しますが、タイプ ライブラリからインターフェイスの説明を省略します。  インターフェイスの説明がないと、クライアントはコンパイル時に DISPID をキャッシュできません。  これはクラス インターフェイスの既定のインターフェイス型ですが、属性値を明示的に適用することもできます。  
+  
+```vb  
+<ClassInterface(ClassInterfaceType.AutoDispatch)> Public Class LoanApp  
+    Implements IAnother  
+    Sub M() Implements IAnother.M  
+…  
+End Class  
+  
+```  
+  
+```csharp  
+[ClassInterface(ClassInterfaceType.AutoDispatch]  
+public class LoanApp : IAnother {  
+    void M();  
+}  
+```  
+  
+ 実行時にインターフェイス メンバーの DISPID を取得するために、COM クライアントは **IDispatch.GetIdsOfNames** を呼び出すことができます。  インターフェイスでメソッドを呼び出すには、返された DISPID を **IDispatch.Invoke** への引数として渡します。  
+  
+### クラス インターフェイス用のデュアル インターフェイスのオプションの使用を制限します。  
+ デュアル インターフェイスは、COM クライアントによるインターフェイス メンバーへの事前バインディングと遅延バインディングを有効にします。  デザイン時およびテスト中は、クラス インターフェイスをデュアルに設定すると役に立つ場合があります。  変更されることのないマネージ クラス \(およびその基本クラス\) の場合、このオプションも使用できます。  それ以外の場合はすべて、クラス インターフェイスをデュアルに設定しないでください。  
+  
+ 自動的に生成されたデュアル インターフェイスが適切な場合もまれにありますが、より多くの場合、それはバージョンに関連する複雑さを生じさせます。  たとえば、派生クラスのクラス インターフェイスを使用する COM クライアントは、基本クラスが変更されると簡単に中断します。  サード パーティが基本クラスを提供するとき、クラス インターフェイスのレイアウトを自分で制御することはできません。  さらに、ディスパッチ専用インターフェイスとは異なり、デュアル インターフェイス \(**ClassInterface.AutoDual**\) は、エクスポートされたタイプ ライブラリ内にクラス インターフェイスの説明を提供します。  そのような説明は、遅延バインディングのクライアントが実行時に DISPID をキャッシュすることを促進します。  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.ClassInterfaceAttribute>   
+ [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)   
+ [COM ラッパー](../../../docs/framework/interop/com-wrappers.md)   
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [Simulating COM Interfaces](http://msdn.microsoft.com/ja-jp/ad2ab959-e2be-411b-aaff-275c3fba606c)   
+ [相互運用のための .NET 型の要件](../../../docs/framework/interop/qualifying-net-types-for-interoperation.md)   
+ [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md)
\ No newline at end of file
diff --git a/docs/framework/interop/com-interop-sample-com-client-and-net-server.md b/docs/framework/interop/com-interop-sample-com-client-and-net-server.md
new file mode 100644
index 00000000000..4d22129f7d6
--- /dev/null
+++ b/docs/framework/interop/com-interop-sample-com-client-and-net-server.md
@@ -0,0 +1,401 @@
+---
+title: "COM 相互運用機能のサンプル: COM クライアントおよび .NET サーバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, サンプル"
+  - "相互運用 (アンマネージ コードとの), サンプル"
+ms.assetid: a219cb2c-9fa2-4c90-9b26-939e0788f178
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# COM 相互運用機能のサンプル: COM クライアントおよび .NET サーバー
+[COM クライアント](#cpconcominteropsamplecomclientnetserveranchor1)と [.NET Server](#cpconcominteropsamplecomclientnetserveranchor2) を相互運用して、住宅ローンの計算を行うサンプルを次に示します。  この例では、クライアントはマネージ `Loan` クラスのインスタンスを作成して呼び出し、4 つの引数 \(そのうち 1 つは 0\) をこのインスタンスに渡し、計算結果を表示します。  このセクション全体をとおして、このサンプル内のコード例を使用します。  
+  
+<a name="cpconcominteropsamplecomclientnetserveranchor1"></a>   
+## COM クライアント  
+  
+```cpp  
+// ConLoan.cpp : Defines the entry point for the console application.  
+#include "stdafx.h"  
+#import "..\LoanLib\LoanLib.tlb" raw_interfaces_only  
+using namespace LoanLib;  
+  
+int main(int argc, char* argv[])  
+{  
+    HRESULT hr = CoInitialize(NULL);  
+  
+    ILoanPtr pILoan(__uuidof(Loan));  
+  
+    if (argc < 5)   
+    {  
+        printf("Usage: ConLoan Balance Rate Term Payment\n");  
+        printf("    Either Balance, Rate, Term, or Payment must be 0\n");  
+        return -1;  
+    }  
+  
+    double openingBalance = atof(argv[1]);  
+    double rate = atof(argv[2])/100.0;  
+    short  term = atoi(argv[3]);  
+    double payment = atof(argv[4]);  
+  
+    pILoan->put_OpeningBalance(openingBalance);  
+    pILoan->put_Rate(rate);  
+    pILoan->put_Term(term);  
+    pILoan->put_Payment(payment);  
+  
+    if (openingBalance == 0.00)   
+         pILoan->ComputeOpeningBalance(&openingBalance);  
+    if (rate == 0.00) pILoan->ComputeRate(&rate);  
+    if (term == 0) pILoan->ComputeTerm(&term);  
+    if (payment == 0.00) pILoan->ComputePayment(&payment);  
+  
+    printf("Balance = %.2f\n", openingBalance);  
+    printf("Rate    = %.1f%%\n", rate*100);  
+    printf("Term    = %.2i\n", term);  
+    printf("Payment = %.2f\n", payment);  
+  
+    VARIANT_BOOL MorePmts;  
+    double Balance = 0.0;  
+    double Principal = 0.0;  
+    double Interest = 0.0;  
+  
+    printf("%4s%10s%12s%10s%12s\n", "Nbr", "Payment", "Principal", "Interest", "Balance");  
+    printf("%4s%10s%12s%10s%12s\n", "---", "-------", "---------",   
+"--------", "-------");  
+  
+    pILoan->GetFirstPmtDistribution(payment, &Balance, &Principal, &Interest, &MorePmts);  
+  
+    for (short PmtNbr = 1; MorePmts; PmtNbr++)   
+    {  
+        printf("%4i%10.2f%12.2f%10.2f%12.2f\n",  
+        PmtNbr, payment, Principal, Interest, Balance);  
+  
+        pILoan->GetNextPmtDistribution(payment, &Balance, &Principal, &Interest, &MorePmts);   
+    }  
+  
+    CoUninitialize();  
+    return 0;  
+}  
+```  
+  
+<a name="cpconcominteropsamplecomclientnetserveranchor2"></a>   
+## .NET Server  
+  
+```vb  
+Imports System  
+Imports System.Reflection  
+  
+<Assembly: AssemblyKeyFile("sample.snk")>  
+Namespace LoanLib      
+  
+    Public Interface ILoan          
+        Property OpeningBalance() As Double  
+        Property Rate() As Double         
+        Property Payment() As Double         
+        Property Term() As Short          
+        Property RiskRating() As String  
+        Function ComputePayment() As Double  
+        Function ComputeOpeningBalance() As Double  
+        Function ComputeRate() As Double  
+        Function ComputeTerm() As Short  
+        Function GetFirstPmtDistribution(PmtAmt As Double, _  
+           ByRef Balance As Double, ByRef PrinPortion As Double, _  
+           ByRef IntPortion As Double) As Boolean  
+        Function GetNextPmtDistribution(PmtAmt As Double, _  
+           ByRef Balance As Double, ByRef PrinPortion As Double, _  
+           ByRef IntPortion As Double) As Boolean  
+    End Interface      
+  
+    Public Class Loan  
+        Implements ILoan  
+        Private m_openingBalance As Double  
+        Private m_rate As Double  
+        Private m_payment As Double  
+        Private m_term As Short  
+        Private m_riskRating As String   
+  
+        Public Property OpeningBalance() As Double _  
+        Implements ILoan.OpeningBalance  
+  
+            Get  
+                Return m_openingBalance  
+            End Get  
+            Set  
+                m_openingBalance = value  
+            End Set  
+        End Property   
+  
+        Public Property Rate() As Double _  
+        Implements ILoan.Rate  
+  
+            Get  
+                Return m_rate  
+            End Get  
+            Set  
+                m_rate = value  
+            End Set  
+        End Property   
+  
+        Public Property Payment() As Double _  
+        Implements ILoan.Payment  
+  
+            Get  
+                Return m_payment  
+            End Get  
+            Set  
+                m_payment = value  
+            End Set  
+        End Property   
+  
+        Public Property Term() As Short _  
+        Implements ILoan.Term  
+  
+            Get  
+                Return m_term  
+            End Get  
+            Set  
+                m_term = value  
+            End Set  
+        End Property   
+  
+        Public Property RiskRating() As String _  
+        Implements ILoan.RiskRating  
+  
+            Get  
+                Return m_riskRating  
+            End Get  
+            Set  
+                m_riskRating = value  
+            End Set  
+        End Property  
+  
+        Public Function ComputePayment() As Double _  
+        Implements ILoan.ComputePayment  
+  
+            Payment = Util.Round(OpeningBalance *(Rate / _  
+               (1 - Math.Pow(1 + Rate, - Term))), 2)  
+            Return Payment  
+        End Function          
+  
+        Public Function ComputeOpeningBalance() As Double _  
+        Implements ILoan.ComputeOpeningBalance  
+  
+            OpeningBalance = Util.Round(Payment /(Rate / _  
+               (1 - Math.Pow(1 + Rate, - Term))), 2)  
+            Return OpeningBalance  
+        End Function          
+  
+        Public Function ComputeRate() As Double _  
+        Implements ILoan.ComputeRate  
+  
+            Dim DesiredPayment As Double = Payment  
+  
+            For m_rate = 0.001 To 28.0 - 0.001 Step 0.001  
+                Payment = Util.Round(OpeningBalance *(Rate / _  
+                   (1 - Math.Pow(1 + Rate, - Term))), 2)  
+  
+                If Payment >= DesiredPayment Then  
+                    Exit For  
+                End If  
+            Next  
+            Return Rate  
+        End Function          
+  
+        Public Function ComputeTerm() As Short _  
+        Implements ILoan.ComputeTerm  
+  
+            Dim DesiredPayment As Double = Payment  
+  
+            For m_term = 1 To 479  
+                Payment = Util.Round(OpeningBalance *(Rate / _  
+                   (1 - Math.Pow(1 + Rate, - Term))), 2)  
+  
+                If Payment <= DesiredPayment Then  
+                    Exit For  
+                End If  
+            Next  
+            Return Term  
+        End Function          
+  
+        Public Function GetFirstPmtDistribution(PmtAmt As Double, _  
+        ByRef Balance As Double, ByRef PrinPortion As Double, _  
+        ByRef IntPortion As Double) As Boolean _  
+        Implements ILoan.GetFirstPmtDistribution  
+  
+            Balance = OpeningBalance  
+            Return GetNextPmtDistribution(PmtAmt, Balance, PrinPortion, _  
+               IntPortion)  
+        End Function          
+  
+        Public Function GetNextPmtDistribution(PmtAmt As Double, _  
+        ByRef Balance As Double, ByRef PrinPortion As Double, _  
+        ByRef IntPortion As Double) As Boolean _  
+        Implements ILoan.GetNextPmtDistribution  
+  
+            IntPortion = Util.Round(Balance * Rate, 2)  
+            PrinPortion = Util.Round(PmtAmt - IntPortion, 2)  
+            Balance = Util.Round(Balance - PrinPortion, 2)  
+  
+            If Balance <= 0.0 Then  
+                Return False  
+            End If   
+            Return True  
+        End Function  
+    End Class      
+  
+    Friend Class Util  
+  
+        Public Shared Function Round(value As Double, digits As Short) _  
+                                      As Double  
+            Dim factor As Double = Math.Pow(10, digits)  
+            Return Math.Round((value * factor)) / factor  
+        End Function  
+  
+    End Class  
+  
+End Namespace  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Reflection;  
+  
+[assembly:AssemblyKeyFile("sample.snk")]  
+namespace LoanLib {  
+  
+    public interface ILoan {  
+        double OpeningBalance{get; set;}  
+        double Rate{get; set;}  
+        double Payment{get; set;}     
+        short  Term{get; set;}  
+        String RiskRating{get; set;}  
+  
+        double ComputePayment();  
+        double ComputeOpeningBalance();  
+        double ComputeRate();  
+        short ComputeTerm();  
+        bool GetFirstPmtDistribution(double PmtAmt, ref double Balance,  
+            out double PrinPortion, out double IntPortion);  
+        bool GetNextPmtDistribution(double PmtAmt, ref double Balance,  
+            out double PrinPortion, out double IntPortion);  
+    }  
+  
+    public class Loan : ILoan {  
+        private double openingBalance;  
+        private double rate;  
+        private double payment;  
+        private short  term;  
+        private String riskRating;        
+  
+        public double OpeningBalance {  
+            get { return openingBalance; }  
+            set { openingBalance = value; }  
+        }  
+  
+        public double Rate {  
+            get { return rate; }  
+            set { rate = value; }  
+        }  
+  
+        public double Payment {  
+            get { return payment; }  
+            set { payment = value; }  
+        }  
+  
+        public short Term {  
+            get { return term; }  
+            set { term = value; }  
+        }  
+  
+        public String RiskRating {  
+            get { return riskRating; }  
+            set { riskRating = value; }  
+        }  
+  
+        public double ComputePayment() {  
+             Payment = Util.Round(OpeningBalance * (Rate / (1 –   
+                        Math.Pow((1 + Rate), -Term))), 2);  
+             return Payment;  
+        }  
+  
+        public double ComputeOpeningBalance() {  
+            OpeningBalance = Util.Round(Payment / (Rate / (1 - Math.Pow((1   
+                              + Rate), -Term))), 2);  
+             return OpeningBalance;  
+        }  
+  
+        public double ComputeRate() {  
+            double DesiredPayment = Payment;  
+  
+            for (Rate = 0.001; Rate < 28.0; Rate += 0.001) {  
+                Payment = Util.Round(OpeningBalance * (Rate / (1 –   
+                           Math.Pow((1 + Rate), -Term))), 2);  
+  
+                if (Payment >= DesiredPayment)  
+                    break;  
+            }  
+            return Rate;     
+        }  
+  
+        public short ComputeTerm() {  
+            double DesiredPayment = Payment;  
+  
+            for (Term = 1; Term < 480 ; Term ++) {  
+                Payment = Util.Round(OpeningBalance * (Rate / (1 –   
+                           Math.Pow((1 + Rate), -Term))),2);  
+  
+                if (Payment <= DesiredPayment)  
+                    break;  
+            }  
+  
+            return Term;     
+        }  
+  
+        public bool GetFirstPmtDistribution(double PmtAmt, ref double   
+            Balance, out double PrinPortion, out double IntPortion) {  
+             Balance = OpeningBalance;  
+             return GetNextPmtDistribution(PmtAmt, ref Balance, out   
+             PrinPortion, out IntPortion);   
+        }  
+  
+        public bool GetNextPmtDistribution(double PmtAmt, ref double   
+           Balance, out double PrinPortion, out double IntPortion) {  
+            IntPortion = Util.Round(Balance * Rate, 2);  
+            PrinPortion = Util.Round(PmtAmt - IntPortion,2);  
+            Balance = Util.Round(Balance - PrinPortion,2);  
+  
+            if (Balance <= 0.0)   
+                return false;  
+  
+            return true;  
+        }  
+     }  
+  
+    internal class Util {  
+        public static double Round(double value, short digits) {  
+            double factor = Math.Pow(10, digits);  
+            return Math.Round(value * factor) / factor;  
+         }  
+    }  
+}  
+```  
+  
+## 参照  
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)
\ No newline at end of file
diff --git a/docs/framework/interop/com-interop-sample-net-client-and-com-server.md b/docs/framework/interop/com-interop-sample-net-client-and-com-server.md
new file mode 100644
index 00000000000..b7403a815cb
--- /dev/null
+++ b/docs/framework/interop/com-interop-sample-net-client-and-com-server.md
@@ -0,0 +1,310 @@
+---
+title: "COM 相互運用機能のサンプル: .NET クライアントおよび COM サーバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, サンプル"
+  - "相互運用 (アンマネージ コードとの), サンプル"
+ms.assetid: a3f752bb-8945-4e1b-8163-71def6e9f137
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# COM 相互運用機能のサンプル: .NET クライアントおよび COM サーバー
+このサンプルでは、[COM サーバー](#cpconcominteropsamplenetclientcomserveranchor2)にアクセスするように作成された [.NET クライアント](#cpconcominteropsamplenetclientcomserveranchor1)で、COM コクラスのインスタンスを作成し、クラスのメンバーを呼び出して住宅ローンの計算をする方法を示します。  
+  
+ この例では、クライアントは **Loan** コクラスのインスタンスを作成して呼び出し、4 つの引数 \(そのうち 1 つは 0\) をこのインスタンスに渡し、計算結果を表示します。  このセクション全体をとおして、このサンプル内のコードを使用します。  
+  
+<a name="cpconcominteropsamplenetclientcomserveranchor1"></a>   
+## .NET クライアント  
+  
+```vb  
+Imports System  
+Imports Microsoft.VisualBasic  
+Imports LoanLib  
+  
+Public Class LoanApp  
+  
+    Public Shared Sub Main()  
+        Dim Args As String()  
+        Args = System.Environment.GetCommandLineArgs()  
+  
+        Dim ln As New Loan()  
+  
+        If Args.Length < 5 Then  
+            Console.WriteLine("Usage: ConLoan Balance Rate Term Payment")  
+            Console.WriteLine(" Either Balance, Rate, Term, or Payment " _  
+                                & "must be 0")  
+            Exit Sub  
+        End If  
+  
+        ln.OpeningBalance = Convert.ToDouble(Args(1))  
+        ln.Rate = Convert.ToDouble(Args(2)) / 100.0  
+        ln.Term = Convert.ToInt16(Args(3))  
+        ln.Payment = Convert.ToDouble(Args(4))  
+  
+        If ln.OpeningBalance = 0.0 Then  
+            ln.ComputeOpeningBalance()  
+        End If  
+        If ln.Rate = 0.0 Then  
+            ln.ComputeRate()  
+        End If  
+        If ln.Term = 0 Then  
+            ln.ComputeTerm()  
+        End If  
+        If ln.Payment = 0.0 Then  
+            ln.ComputePayment()  
+        End If   
+        Console.WriteLine("Balance = {0,10:0.00}", ln.OpeningBalance)  
+        Console.WriteLine("Rate    = {0,10:0.0%}", ln.Rate)  
+        Console.WriteLine("Term    = {0,10:0.00}", ln.Term)  
+        Console.WriteLine("Payment = {0,10:0.00}" & ControlChars.Cr, _  
+                          ln.Payment)  
+  
+        Dim MorePmts As Boolean  
+        Dim Balance As Double = 0.0  
+        Dim Principal As Double = 0.0  
+        Dim Interest As Double = 0.0  
+  
+        Console.WriteLine("{0,4}{1,10}{2,12}{3,10}{4,12}", _  
+           "Nbr", "Payment", "Principal", "Interest", "Balance")  
+        Console.WriteLine("{0,4}{1,10}{2,12}{3,10}{4,12}", _  
+           "---", "-------", "---------", "--------", "-------")  
+  
+        MorePmts = ln.GetFirstPmtDistribution(ln.Payment, Balance, _  
+           Principal, Interest)  
+  
+        Dim PmtNbr As Short  
+  
+        While MorePmts  
+  
+            Console.WriteLine("{0,4}{1,10:0.00}{2,12:0.00}{3,10:0.00}" _  
+              & "{4,12:0.00}", PmtNbr, ln.Payment, Principal, Interest,  
+              Balance)  
+            MorePmts = ln.GetNextPmtDistribution(ln.Payment, Balance, _  
+              Principal, Interest)  
+            PmtNbr += CShort(1)  
+        End While  
+    End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using LoanLib;  
+  
+public class LoanApp {  
+   public static void Main(String[] Args) {  
+  
+      Loan ln = new Loan();  
+  
+      if (Args.Length < 4)   
+      {  
+         Console.WriteLine("Usage: ConLoan Balance Rate Term Payment");  
+         Console.WriteLine("    Either Balance, Rate, Term, or Payment   
+            must be 0");  
+         return;  
+      }  
+  
+      ln.OpeningBalance = Convert.ToDouble(Args[0]);  
+      ln.Rate = Convert.ToDouble(Args[1])/100.0;  
+      ln.Term = Convert.ToInt16(Args[2]);  
+      ln.Payment = Convert.ToDouble(Args[3]);  
+  
+      if (ln.OpeningBalance == 0.00) ln.ComputeOpeningBalance();  
+      if (ln.Rate == 0.00) ln.ComputeRate();  
+      if (ln.Term == 0) ln.ComputeTerm();  
+      if (ln.Payment == 0.00) ln.ComputePayment();  
+  
+      Console.WriteLine("Balance = {0,10:0.00}", ln.OpeningBalance);  
+      Console.WriteLine("Rate    = {0,10:0.0%}", ln.Rate);  
+      Console.WriteLine("Term    = {0,10:0.00}", ln.Term);  
+      Console.WriteLine("Payment = {0,10:0.00}\n", ln.Payment);  
+  
+      bool MorePmts;  
+      double Balance = 0.0;  
+      double Principal = 0.0;  
+      double Interest = 0.0;  
+  
+      Console.WriteLine("{0,4}{1,10}{2,12}{3,10}{4,12}", "Nbr", "Payment",  
+        "Principal", "Interest", "Balance");  
+      Console.WriteLine("{0,4}{1,10}{2,12}{3,10}{4,12}", "---", "-------",  
+        "---------", "--------", "-------");  
+  
+      MorePmts = ln.GetFirstPmtDistribution(ln.Payment, out Balance,   
+        out Principal, out Interest);  
+  
+      for (short PmtNbr = 1; MorePmts; PmtNbr++) {  
+         Console.WriteLine("{0,4}{1,10:0.00}{2,12:0.00}{3,10:0.00}  
+           {4,12:0.00}", PmtNbr, ln.Payment, Principal, Interest,  
+            Balance);  
+         MorePmts = ln.GetNextPmtDistribution(ln.Payment, ref Balance,   
+           out Principal, out Interest);   
+      }  
+    }  
+}  
+```  
+  
+<a name="cpconcominteropsamplenetclientcomserveranchor2"></a>   
+## COM Server  
+  
+```cpp  
+// Loan.cpp : Implementation of CLoan  
+#include "stdafx.h"  
+#include "math.h"  
+#include "LoanLib.h"  
+#include "Loan.h"  
+  
+static double Round(double value, short digits);   
+  
+STDMETHODIMP CLoan::get_OpeningBalance(double *pVal)  
+{  
+    *pVal = OpeningBalance;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::put_OpeningBalance(double newVal)  
+{  
+    OpeningBalance = newVal;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::get_Rate(double *pVal)  
+{  
+    *pVal = Rate;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::put_Rate(double newVal)  
+{  
+    Rate = newVal;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::get_Payment(double *pVal)  
+{  
+    *pVal = Payment;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::put_Payment(double newVal)  
+{  
+    Payment = newVal;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::get_Term(short *pVal)  
+{  
+    *pVal = Term;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::put_Term(short newVal)  
+{  
+    Term = newVal;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::ComputePayment(double *pVal)  
+{  
+    Payment = Round(OpeningBalance * (Rate /   
+        (1 - pow((1 + Rate), -Term))),2);  
+    *pVal = Payment;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::ComputeOpeningBalance(double *pVal)  
+{  
+    OpeningBalance = Round(Payment / (Rate /   
+        (1 - pow((1 + Rate), -Term))),2);  
+    *pVal = OpeningBalance ;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::ComputeRate(double *pVal)  
+{  
+    double DesiredPayment = Payment;  
+  
+    for (Rate = 0.001; Rate < 28.0; Rate += 0.001)  
+    {  
+        Payment = Round(OpeningBalance * (Rate /   
+         (1 - pow((1 + Rate), -Term))),2);  
+  
+        if (Payment >= DesiredPayment)  
+            break;  
+    }  
+  
+    *pVal = Rate;     
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::ComputeTerm(short *pVal)  
+{  
+    double DesiredPayment = Payment;  
+    for (Term = 1; Term < 480 ; Term ++)  
+    {  
+        Payment = Round(OpeningBalance * (Rate /   
+         (1 - pow((1 + Rate), -Term))),2);  
+        if (Payment <= DesiredPayment)  
+            break;  
+    }  
+    *pVal = Term;     
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::GetFirstPmtDistribution(double PmtAmt, double *Balance, double *PrinPortion, double *IntPortion, VARIANT_BOOL *pVal)  
+{  
+    *Balance = OpeningBalance;  
+    GetNextPmtDistribution(PmtAmt, Balance, PrinPortion, IntPortion,   
+      pVal);  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::GetNextPmtDistribution(double PmtAmt, double *Balance, double *PrinPortion, double *IntPortion, VARIANT_BOOL *pVal)  
+{  
+    *IntPortion = Round(*Balance * Rate, 2);  
+    *PrinPortion = Round(PmtAmt - *IntPortion, 2);  
+    *Balance = Round(*Balance - *PrinPortion, 2);  
+  
+    if (*Balance <= 0.0)  
+        *pVal = FALSE;  
+    else  
+        *pVal = TRUE;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::get_RiskRating(BSTR *pVal)  
+{  
+    *pVal = (BSTR)RiskRating;  
+    return S_OK;  
+}  
+  
+STDMETHODIMP CLoan::put_RiskRating(BSTR newVal)  
+{  
+    RiskRating = newVal;  
+    return S_OK;  
+}  
+static double Round(double value, short digits)   
+{  
+    double factor = pow(10, digits);  
+    return floor(value * factor + 0.5)/factor;  
+}  
+```  
+  
+## 参照  
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)
\ No newline at end of file
diff --git a/docs/framework/interop/com-wrappers.md b/docs/framework/interop/com-wrappers.md
new file mode 100644
index 00000000000..6736cc291f2
--- /dev/null
+++ b/docs/framework/interop/com-wrappers.md
@@ -0,0 +1,52 @@
+---
+title: "COM ラッパー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 呼び出し可能ラッパー"
+  - "COM 相互運用機能, COM ラッパー"
+  - "COM ラッパー"
+  - "COM, ラッパー"
+  - "相互運用 (アンマネージ コードとの), COM ラッパー"
+  - "ラッパー クラス"
+ms.assetid: e56c485b-6b67-4345-8e66-fd21835a6092
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# COM ラッパー
+COM は、次のいくつかの重要な点で、.NET Framework オブジェクト モデルとは異なります。  
+  
+-   COM オブジェクトのクライアントは、COM オブジェクトの有効期間を管理する必要があります。共通言語ランタイムはその環境でのオブジェクトの有効期間を管理します。  
+  
+-   COM オブジェクトのクライアントは、サービスを提供するインターフェイスを要求し、インターフェイス ポインターを取得して、そのサービスが利用可能かどうかを確認します。  .NET オブジェクトのクライアントは、リフレクションを使用してオブジェクトの機能の記述を取得できます。  
+  
+-   .NET オブジェクトは、.NET Framework の実行環境によって管理されるメモリに常駐します。  .NET Framework の実行環境では、パフォーマンス上の理由からオブジェクトをメモリ内で移動させることができ、移動するオブジェクトに合わせてすべての参照を更新できます。  オブジェクトへのポインターを取得するアンマネージ クライアントは、そのオブジェクトに依存するので同じ場所にとどまります。  アンマネージ クライアントには、場所が固定されていないオブジェクトを扱う機構が用意されていません。  
+  
+ このような相違を克服するために、ランタイムは、ラッパー クラスを用意して、マネージ クライアントとアンマネージ クライアントの両方がそれぞれの環境内でオブジェクトを呼び出していると認識するようにします。  マネージ クライアントが COM オブジェクトのメソッドを呼び出すと、ランタイムが[ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW: Runtime Callable Wrapper\) を作成します。  RCW の主な役割は、マネージ参照機構とアンマネージ参照機構の相違を克服することです。  また、ランタイムは、[COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md) \(CCW: COM Callable Wrapper\) を作成して、その逆のプロセスを使用し、COM クライアントがシームレスに .NET オブジェクトのメソッドを呼び出すことができるようにします。  呼び出し元のコードと、ランタイムが作成するラッパー クラスの関係を示す図を次に示します。  
+  
+ ![COM ラッパーの概要](../../../docs/framework/interop/media/bidirectional.gif "bidirectional")  
+COM ラッパーの概要  
+  
+ ほとんどの場合、ランタイムによって生成される標準の RCW または CCW は、COM と .NET Framework の境界をまたがる呼び出しに対して適切なマーシャリングを提供します。  カスタム属性を使用することにより、オプションで、ランタイムがマネージ コードおよびアンマネージ コードを表現する方法を調整できます。  
+  
+## 参照  
+ [Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)   
+ [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md)   
+ [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)   
+ [Customizing Standard Wrappers](http://msdn.microsoft.com/ja-jp/c40d089b-6a3c-41b5-a20d-d760c215e49d)   
+ [How to: Customize Runtime Callable Wrappers](http://msdn.microsoft.com/ja-jp/4a4bb3da-4d60-4517-99f2-78d46a681732)
\ No newline at end of file
diff --git a/docs/framework/interop/compiling-an-interop-project.md b/docs/framework/interop/compiling-an-interop-project.md
new file mode 100644
index 00000000000..89d31611988
--- /dev/null
+++ b/docs/framework/interop/compiling-an-interop-project.md
@@ -0,0 +1,57 @@
+---
+title: "相互運用プロジェクトのコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, コンパイル"
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "コンパイル (相互運用プロジェクトの)"
+  - "公開 (.NET Framework に COM コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), コンパイル"
+  - "相互運用 (アンマネージ コードとの), 公開 (COM コンポーネントを)"
+ms.assetid: 6fcf6588-5e25-41af-b4ae-780974f2c3df
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 相互運用プロジェクトのコンパイル
+インポートされた COM 型を格納した 1 つ以上のアセンブリを参照する COM 相互運用プロジェクトは、他のマネージ プロジェクトと同じ方法でコンパイルされます。  相互運用機能アセンブリは、Visual Studio などの開発環境で参照できます。または、コマンド ライン コンパイラを使用して参照できます。  どちらの場合でも、正常にコンパイルするには、相互運用機能アセンブリを、その他のプロジェクト ファイルと同じディレクトリに配置する必要があります。  
+  
+ 相互運用機能アセンブリを参照する方法には、次の 2 つがあります。  
+  
+-   埋め込まれた相互運用機能型を使用する: [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] および [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] 以降では、相互運用機能アセンブリから実行可能ファイルに型情報を埋め込むようにコンパイラに指示できます。  この手法を使用することをお勧めします。  
+  
+-   相互運用機能アセンブリを配置する: 相互運用機能アセンブリへの標準の参照を作成できます。  この場合、アプリケーションで相互運用機能アセンブリを配置する必要があります。  
+  
+ この 2 つの方法の違いの詳細については、「[Using COM Types in Managed Code](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)」を参照してください。  
+  
+ Visual Studio での相互運用機能型の埋め込みについては、「[チュートリアル: Microsoft Office アセンブリからの型情報の埋め込み](../Topic/Walkthrough:%20Embedding%20Type%20Information%20from%20Microsoft%20Office%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)」および「[チュートリアル: マネージ アセンブリからの型の埋め込み](../Topic/Walkthrough:%20Embedding%20Types%20from%20Managed%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+ コマンド ライン コンパイラを使用して相互運用機能アセンブリを参照し、実行可能ファイルに型情報を埋め込むには、[\/link \(Link to COM Assembly\)](../Topic/-link%20\(C%23%20Compiler%20Options\).md) コンパイラ スイッチまたは [\/link](../Topic/-link%20\(Visual%20Basic\).md) コンパイラ スイッチを使用し、相互運用機能アセンブリの名前を指定します。  
+  
+> [!NOTE]
+>  Visual C\+\+ アプリケーションは型情報を埋め込むことはできませんが、型情報を埋め込むことができるアプリケーションまたはアドインと相互運用できます。  
+  
+ 配置時にプライマリ相互運用機能アセンブリを含むアプリケーションをコンパイルするには、**\/reference** コンパイラ スイッチを使用し、相互運用機能アセンブリの名前を指定します。  
+  
+## 参照  
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)   
+ [言語への非依存性、および言語非依存コンポーネント](../../../docs/standard/language-independence-and-language-independent-components.md)   
+ [Using COM Types in Managed Code](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)   
+ [チュートリアル: Microsoft Office アセンブリからの型情報の埋め込み](../Topic/Walkthrough:%20Embedding%20Type%20Information%20from%20Microsoft%20Office%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)   
+ [チュートリアル: マネージ アセンブリからの型の埋め込み](../Topic/Walkthrough:%20Embedding%20Types%20from%20Managed%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)   
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)
\ No newline at end of file
diff --git a/docs/framework/interop/configure-net-framework-based-com-components-for-reg.md b/docs/framework/interop/configure-net-framework-based-com-components-for-reg.md
new file mode 100644
index 00000000000..21688efb0f6
--- /dev/null
+++ b/docs/framework/interop/configure-net-framework-based-com-components-for-reg.md
@@ -0,0 +1,189 @@
+---
+title: "方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクティベーション, 登録を必要としない"
+  - "アプリケーション マニフェスト [.NET Framework]"
+  - "コンポーネント [.NET Framework], マニフェスト"
+  - "マニフェスト [.NET Framework]"
+  - "登録を必要としない COM 相互運用機能, 構成 (.NET ベース コンポーネントの)"
+ms.assetid: 32f8b7c6-3f73-455d-8e13-9846895bd43b
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する
+.NET Framework ベースのコンポーネントの登録を必要としないアクティベーションは、COM コンポーネントの場合よりも少しだけ複雑です。  セットアップには 2 つのマニフェストが必要です。  
+  
+-   COM アプリケーションには、マネージ コンポーネントを識別するための Win32 スタイルのアプリケーション マニフェストが必要です。  
+  
+-   .NET Framework ベースのコンポーネントには、実行時に必要なアクティベーション情報のコンポーネント マニフェストが必要です。  
+  
+ このトピックでは、アプリケーション マニフェストをアプリケーションに関連付ける方法、コンポーネント マニフェストをコンポーネントに関連付ける方法、およびコンポーネント マニフェストをアセンブリに埋め込む方法について説明します。  
+  
+### アプリケーション マニフェストを作成するには  
+  
+1.  XML エディターを使用して、1 つ以上のマネージ コンポーネントと相互運用する COM アプリケーションによって所有されるアプリケーション マニフェストを作成または編集します。  
+  
+2.  ファイルの先頭に次の標準ヘッダーを挿入します。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+    ```  
+  
+     マニフェストの要素とその属性については、MSDN Library で「Application Manifests Reference」を検索してください。  
+  
+3.  マニフェストの所有者を指定します。  次の例では、`myComApp` バージョン 1 がマニフェスト ファイルを所有しています。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+      <assemblyIdentity type="win32"   
+                        name="myOrganization.myDivision.myComApp"   
+                        version="1.0.0.0"   
+                        processorArchitecture="msil"   
+      />  
+    ```  
+  
+4.  依存アセンブリを指定します。  `myComApp` が `myManagedComp` に依存する例を次に示します。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+      <assemblyIdentity type="win32"   
+                        name="myOrganization.myDivision.myComApp"   
+                        version="1.0.0.0"   
+                        processorArchitecture="x86"   
+                        publicKeyToken="8275b28176rcbbef"  
+      />  
+      <dependency>  
+        <dependentAssembly>  
+          <assemblyIdentity type="win32"   
+                        name="myOrganization.myDivision.myManagedComp"   
+                        version="6.0.0.0"   
+                        processorArchitecture="X86"   
+                        publicKeyToken="8275b28176rcbbef"  
+          />  
+        </dependentAssembly>  
+      </dependency>  
+    </assembly>  
+    ```  
+  
+5.  マニフェスト ファイルに名前を付けて保存します。  アプリケーション マニフェストの名前は、アセンブリ実行可能ファイルの名前に拡張子 .manifest が付いたものです。  たとえば、myComApp.exe のアプリケーション マニフェスト ファイル名は myComApp.exe.manifest です。  
+  
+ アプリケーション マニフェストは、COM アプリケーションと同じディレクトリにインストールできます。  また、アプリケーションの .exe ファイルにリソースとして追加することもできます。  詳細については、MSDN Library で「Side\-by\-side Assemblies」を検索してください。  
+  
+#### コンポーネント マニフェストを作成するには  
+  
+1.  XML エディターを使用して、マネージ アセンブリを記述するコンポーネント マニフェストを作成します。  
+  
+2.  ファイルの先頭に次の標準ヘッダーを挿入します。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+    ```  
+  
+3.  ファイルの所有者を指定します。  アプリケーション マニフェスト ファイル内の `<dependentAssembly>` 要素の `<assemblyIdentity>` 要素は、コンポーネント マニフェスト内の要素と一致している必要があります。  次の例では、`myManagedComp` バージョン 1.2.3.4 がマニフェスト ファイルを所有しています。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+           <assemblyIdentity  
+                        name="myOrganization.myDivision.myManagedComp"  
+                        version="1.2.3.4"  
+                        publicKeyToken="8275b28176rcbbef"  
+                        processorArchitecture="msil"  
+           />  
+    ```  
+  
+4.  アセンブリ内の各クラスを指定します。  マネージ アセンブリ内の各クラスを一意に識別するには `<clrClass>` 要素を使用します。  この要素は、`<assembly>` 要素のサブ要素であり、次の表に示す属性を持っています。  
+  
+    |属性|説明|必須|  
+    |--------|--------|--------|  
+    |`clsid`|アクティブにするクラスを指定する識別子。|○|  
+    |`description`|ユーザーにコンポーネントを説明する文字列。  既定では文字列は空です。|×|  
+    |`name`|マネージ クラスを表す文字列。|○|  
+    |`progid`|遅延バインディングによるアクティベーションで使用される識別子。|×|  
+    |`threadingModel`|COM スレッド モデル。"Both" が既定値です。|×|  
+    |`runtimeVersion`|使用する共通言語ランタイム \(CLR: Common Language Runtime\) のバージョンを指定します。  この属性を指定せず、CLR がまだ読み込まれていない場合は、インストールされている最新の CLR \(CLR Version 4 よりも前のバージョン\) でコンポーネントが読み込まれます。  v1.0.3705、v1.1.4322、または v2.0.50727 を指定すると、インストールされている最新の CLR バージョン \(CLR Version 4 よりも前のバージョン。通常は v2.0.50727\) に自動的にロールフォワードされます。  別のバージョンの CLR が既に読み込まれていて、指定されたバージョンをインプロセスで並行して \(side\-by\-side で\) 読み込むことができる場合は、指定されたバージョンが読み込まれます。それ以外の場合は、読み込まれた CLR が使用されます。  これにより、読み込みエラーが発生する可能性があります。|Ｘ|  
+    |`tlbid`|クラスに関する型情報を格納するタイプ ライブラリの識別子。|Ｘ|  
+  
+     属性タグはすべて大文字と小文字が区別されます。  OLE\/COM オブジェクト ビューアー \(Oleview.exe\) で、エクスポートされたアセンブリのタイプ ライブラリを表示することによって、CLSID、ProgID、スレッド モデル、およびランタイムのバージョンを取得できます。  
+  
+     `testClass1` および `testClass2` という 2 つのクラスを識別するコンポーネント マニフェストを次に示します。  
+  
+    ```  
+    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
+    <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">  
+           <assemblyIdentity  
+                        name="myOrganization.myDivision.myManagedComp"  
+                        version="1.2.3.4" />  
+                        publicKeyToken="8275b28176rcbbef"  
+           />  
+           <clrClass  
+                        clsid="{65722BE6-3449-4628-ABD3-74B6864F9739}"  
+                        progid="myManagedComp.testClass1"  
+                        threadingModel="Both"  
+                        name="myManagedComp.testClass1"  
+                        runtimeVersion="v1.0.3705">  
+           </clrClass>  
+           <clrClass  
+                        clsid="{367221D6-3559-3328-ABD3-45B6825F9732}"  
+                        progid="myManagedComp.testClass2"  
+                        threadingModel="Both"  
+                        name="myManagedComp.testClass2"  
+                        runtimeVersion="v1.0.3705">  
+           </clrClass>  
+           <file name="MyManagedComp.dll">  
+           </file>  
+    </assembly>  
+    ```  
+  
+5.  マニフェスト ファイルに名前を付けて保存します。  コンポーネント マニフェストの名前は、アセンブリ ライブラリの名前に拡張子 .manifest が付いたものです。  たとえば、myManagedComp.dll の場合は、myManagedComp.manifest になります。  
+  
+ コンポーネント マニフェストはリソースとしてアセンブリに埋め込む必要があります。  
+  
+#### コンポーネント マニフェストをマネージ アセンブリに埋め込むには  
+  
+1.  次のステートメントを含むリソース スクリプトを作成します。  
+  
+     `RT_MANIFEST 1 myManagedComp.manifest`  
+  
+     このステートメントで、`myManagedComp.manifest` は埋め込むコンポーネント マニフェストの名前です。  この例では、スクリプト ファイル名は `myresource.rc` です。  
+  
+2.  Microsoft Windows リソース コンパイラ \(Rc.exe\) を使用してスクリプトをコンパイルします。  コマンド プロンプトに次のコマンドを入力します。  
+  
+     `rc myresource.rc`  
+  
+     Rc.exe は `myresource.res` リソース ファイルを生成します。  
+  
+3.  もう一度アセンブリのソース ファイルをコンパイルし、**\/win32res** オプションを使用してリソース ファイルを指定します。  
+  
+    ```  
+    /win32res:myresource.res  
+    ```  
+  
+     ここでも、`myresource.res` は埋め込むリソースを含むリソース ファイルの名前です。  
+  
+## 参照  
+ [登録を必要としない COM 相互運用機能](../../../docs/framework/interop/registration-free-com-interop.md)   
+ [Requirements for Registration\-Free COM Interop](http://msdn.microsoft.com/ja-jp/0c43bc57-eecf-4e6c-8114-490141cce4da)   
+ [Configuring COM Components for Registration\-Free Activation](http://msdn.microsoft.com/ja-jp/bfe9b02f-d964-4784-960e-a1f94692fbfe)   
+ [Registration\-Free Activation of .NET\-Based Components: A Walkthrough \(.NET ベースのコンポーネントの登録を必要としないアクティベーション: チュートリアル\)](http://go.microsoft.com/fwlink/?LinkId=158812)
\ No newline at end of file
diff --git a/docs/framework/interop/consuming-unmanaged-dll-functions.md b/docs/framework/interop/consuming-unmanaged-dll-functions.md
new file mode 100644
index 00000000000..5f0ea9b8a9c
--- /dev/null
+++ b/docs/framework/interop/consuming-unmanaged-dll-functions.md
@@ -0,0 +1,89 @@
+---
+title: "アンマネージ DLL 関数の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, DLL 関数"
+  - "COM 相互運用機能, プラットフォーム呼び出し"
+  - "DLL 関数"
+  - "DLL 関数, 処理 (アンマネージ)"
+  - "相互運用 (アンマネージ コードとの), DLL 関数"
+  - "相互運用 (アンマネージ コードとの), プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し, プラットフォーム呼び出しの概要"
+  - "アンマネージ関数"
+  - "アンマネージ関数, 呼び出し"
+ms.assetid: eca7606e-ebfb-4f47-b8d9-289903fdc045
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アンマネージ DLL 関数の処理
+プラットフォーム呼び出しは、マネージ コードがダイナミック リンク ライブラリ \(DLL\) に実装されたアンマネージ関数 \(Win32 API に含まれているものなど\) を呼び出すことを可能にするサービスです。  これはエクスポートされた関数を見つけて呼び出し、必要に応じて相互運用の境界を越えて、その引数 \(整数、文字列、配列、構造体、その他\) をマーシャリングします。  このサービスについて詳しくは、「[プラットフォーム呼び出しの詳細](http://msdn.microsoft.com/ja-jp/ba9dd55b-2eaa-45cd-8afd-75cb8d64d243)」を参照してください。  
+  
+ このセクションでは、アンマネージ DLL 関数の使用に関連するいくつかのタスクについて説明します。  以下のタスクに加えて、一般的な考慮事項、および追加情報や例を提供するリンクがあります。  
+  
+#### エクスポートされた DLL 関数を使用するには  
+  
+1.  [DLL 内の関数の識別](../../../docs/framework/interop/identifying-functions-in-dlls.md)  
+  
+     少なくとも、関数の名前とそれを含んでいる DLL の名前を指定する必要があります。  
+  
+2.  [DLL 関数を保持するクラスの作成](../../../docs/framework/interop/creating-a-class-to-hold-dll-functions.md)  
+  
+     既存のクラスを使用して、アンマネージ関数ごとに個別のクラスを作成するか、または関連するアンマネージ関数のセットを格納する 1 つのクラスを作成できます。  
+  
+3.  [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)  
+  
+     \[Visual Basic\] **Declare** ステートメントを **Function** および **Lib** キーワードと共に使用します。  いくつかのまれなケースでは、**DllImportAttribute** を **Shared Function** キーワードと共に使用できます。  それらのケースについては、このセクションで後述します。  
+  
+     \[C\#\] **DllImportAttribute** を使用して DLL と関数を指定します。  メソッドを **static** および **extern** 修飾子でマークします。  
+  
+     \[C\+\+\] **DllImportAttribute** を使用して DLL と関数を指定します。  ラッパー メソッドまたは関数を **extern "C"** でマークします。  
+  
+4.  [DLL 関数を呼び出します。](../../../docs/framework/interop/calling-a-dll-function.md)  
+  
+     他のマネージ メソッドと同様の方法で、マネージ クラスのメソッドを呼び出します。  [構造体の受け渡し](../../../docs/framework/interop/passing-structures.md)および[コールバック関数の実装](../../../docs/framework/interop/callback-functions.md)は、特殊なケースです。  
+  
+ プラットフォームの起動で使用する NET ベースの宣言を作成する方法を示す例については、「[プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)」を参照してください。  
+  
+## プラットフォーム呼び出しの詳細  
+ プラットフォーム呼び出しは、エクスポート関数を検索して、その引数を実行時にマーシャリングするために、メタデータに依存します。  次の図は、このプロセスを表しています。  
+  
+ ![プラットフォーム呼び出し](../../../docs/framework/interop/media/pinvoke.gif "pinvoke")  
+アンマネージ DLL 関数を呼び出すプラットフォーム呼び出し  
+  
+ プラットフォーム呼び出しがアンマネージ関数を呼び出すと、以下の一連のアクションが実行されます。  
+  
+1.  関数を含む DLL を検索します。  
+  
+2.  DLL をメモリに読み込みます。  
+  
+3.  メモリ内の関数のアドレスを検索し、その引数をスタックにプッシュし、必要に応じてデータをマーシャリングします。  
+  
+    > [!NOTE]
+    >  DLL の検索と読み込み、およびメモリ内の関数のアドレスの検索は、その関数を初めて呼び出したときにのみ生じます。  
+  
+4.  アンマネージ関数に制御を移します。  
+  
+ プラットフォーム呼び出しは、アンマネージ関数によって生成された例外を、マネージ呼び出し元にスローします。  
+  
+## 参照  
+ [アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)   
+ [プラットフォーム呼び出しの例](../../../docs/framework/interop/platform-invoke-examples.md)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)   
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)
\ No newline at end of file
diff --git a/docs/framework/interop/copying-and-pinning.md b/docs/framework/interop/copying-and-pinning.md
new file mode 100644
index 00000000000..38d959a5bf4
--- /dev/null
+++ b/docs/framework/interop/copying-and-pinning.md
@@ -0,0 +1,94 @@
+---
+title: "コピーと固定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コピー, 相互運用マーシャリング"
+  - "相互運用マーシャリング, コピー"
+  - "相互運用マーシャリング, 固定"
+  - "固定, 相互運用マーシャリング"
+ms.assetid: 0059f576-e460-4e70-b257-668870e420b8
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# コピーと固定
+データをマーシャリングするときに、相互運用マーシャラーはマーシャリングされるデータをコピーまたは固定できます。  データをコピーすると、あるメモリ位置のデータのコピーが別のメモリ位置に配置されます。  マネージ メモリからアンマネージ メモリにコピーされた値型と、参照渡しされた型の違いを次の図に示します。  
+  
+ ![値と参照別に渡される値型](../../../docs/framework/interop/media/interopmarshalcopy.gif "interopmarshalcopy")  
+値渡しされる値型と参照渡しされる値型  
+  
+ 値渡しされるメソッド引数は、スタック上の値としてアンマネージ コードにマーシャリングされます。  コピーのプロセスは直接的です。  参照渡しされる引数は、ポインターとしてスタック上に渡されます。  参照型も、値渡しまたは参照渡しできます。  値渡しされる参照型がコピーまたは固定されるようすを次の図に示します。  
+  
+ ![COM 相互運用](../../../docs/framework/interop/media/interopmarshalpin.gif "interopmarshalpin")  
+値渡しされる参照型と参照渡しされる参照型  
+  
+ 一時的な固定は、現在のメモリ位置にデータをロックします。したがって、共通言語ランタイムのガベージ コレクターによって、そのデータが再配置されることを回避できます。  マーシャラーはデータを固定することでコピーによるオーバーヘッドを減少させ、パフォーマンスを向上させます。  マーシャリング プロセス中にデータがコピーされるのか固定されるのかは、そのデータの型によって決まります。  一時的な固定は、<xref:System.String> などのオブジェクトのマーシャリング中に自動的に実行されますが、<xref:System.Runtime.InteropServices.GCHandle> クラスを使って手動でメモリを一時的に固定することもできます。  
+  
+## 書式指定された Blittable クラス  
+ 書式指定された [blittable](../../../docs/framework/interop/blittable-and-non-blittable-types.md) クラスは、マネージ メモリ内でもアンマネージ メモリ内でも、固定レイアウト \(書式指定されている\) と共通のデータ表現を持ちます。  このような型をマーシャリングする必要がある場合は、ヒープ内のオブジェクトへのポインターが、呼び出し先に直接渡されます。  呼び出し先はポインターによって参照されるメモリ位置の内容を変更できます。  
+  
+> [!NOTE]
+>  パラメーターに Out または In\/Out のマークが付いている場合、呼び出し先はメモリの内容を変更できます。  逆に、In としてマーシャリングするようにパラメーターが設定されている場合、呼び出し先は内容の変更を避ける必要があります。In は書式指定された blittable 型に対する既定の設定です。  同一クラスをタイプ ライブラリにエクスポートし、アパートメント間呼び出しのために使用した場合に、In オブジェクトを修正すると問題が発生します。  
+  
+## 書式指定された Blittable でないクラス  
+ 書式指定された[blittable でない](../../../docs/framework/interop/blittable-and-non-blittable-types.md)クラスは、固定レイアウト \(書式指定されている\) を持ちますが、マネージ メモリとアンマネージ メモリではデータ表現が異なります。  次の状況では、データを変換する必要が生じる場合があります。  
+  
+-   blittable でないクラスを値渡しでマーシャリングする場合、呼び出し先はデータ構造体のコピーへのポインターを受け取ります。  
+  
+-   blittable でないクラスを参照渡しでマーシャリングする場合、呼び出し先はデータ構造体のコピーへのポインターを指すポインターを受け取ります。  
+  
+-   <xref:System.Runtime.InteropServices.InAttribute> 属性が設定されている場合、このコピーは常にインスタンスの状態に初期化され、必要に応じてマーシャリングされます。  
+  
+-   <xref:System.Runtime.InteropServices.OutAttribute> 属性が設定されている場合、制御が返されるときに常に状態がインスタンスにコピーされ、必要に応じてマーシャリングされます。  
+  
+-   **InAttribute** と **OutAttribute** が両方設定されている場合は、両方のコピーが必要になります。  いずれか一方の属性が省略された場合、一方のコピーが省略されるため、処理が最適化されます。  
+  
+## 参照型  
+ 参照型は値渡しまたは参照渡しできます。  値渡しする場合は、型へのポインターがスタック上に渡されます。  参照渡しする場合、型へのポインターを指すポインターがスタック上に渡されます。  
+  
+ 参照型は、次のように条件付きで動作します。  
+  
+-   参照型が値渡しされ、その参照型のメンバーのいずれかが非 blittable 型の場合、その型は 2 回変換されます。  
+  
+    -   1 回目は引数をアンマネージ側に渡すとき。  
+  
+    -   2 回目は呼び出しから制御が返されるとき。  
+  
+     不要なコピーと変換を避けるために、これらの型は In パラメーターとしてマーシャリングされます。  呼び出し先による変更内容を呼び出し元が確認する必要がある場合には、引数に対して明示的に **InAttribute** 属性と **OutAttribute** 属性を適用する必要があります。  
+  
+-   参照型が値渡しされ、その参照型のメンバーがすべて blittable 型の場合は、マーシャリング中にその参照型を固定できます。また、呼び出し先による型のメンバーへの変更内容は呼び出し元にも反映されます。  このような動作が必要な場合は、**InAttribute** と **OutAttribute** を明示的に適用してください。  これらの方向属性を使用しない場合は、相互運用マーシャラーが方向情報をタイプ ライブラリにエクスポートしない \(既定の In としてエクスポートします\) ため、COM のアパートメント間マーシャリングで問題が生じることがあります。  
+  
+-   参照型を参照渡しする場合は、既定によりその型は In\/Out としてマーシャリングされます。  
+  
+## System.String と System.Text.StringBuilder  
+ アンマネージ コードにデータを値渡しまたは参照しでマーシャリングする場合、一般に、マーシャラーはデータを 2 次バッファーにコピーし \(可能な場合には、コピー中に文字セットを変換\)、そのバッファーへの参照を呼び出し先に渡します。  この参照が **SysAllocString** によって割り当てられた **BSTR** である場合を除き、参照は常に **CoTaskMemAlloc** によって割り当てられます。  
+  
+ 文字列型を値渡しでマーシャリングする \(Unicode 文字列など\) ときの最適化処理として、マーシャラーは新しいバッファーに文字列型をコピーする代わりに、呼び出し先に対して内部 Unicode バッファー内のマネージ文字列への直接ポインターを渡します。  
+  
+> [!CAUTION]
+>  文字列を値渡しする場合には、マーシャラーから渡された参照を呼び出し先で変更しないようにしてください。  変更した場合はマネージ ヒープが破損することがあります。  
+  
+ <xref:System.String?displayProperty=fullName> を参照渡しする場合、マーシャラーは呼び出しを実行する前にその文字列の内容を 2 次バッファーにコピーします。  次に呼び出しから制御が返されるときに、マーシャラーはバッファーの内容を新しい文字列の中にコピーします。  この技法により、変更不可のマネージ文字列が変更されないことが保証されます。  
+  
+ <xref:System.Text.StringBuilder?displayProperty=fullName> を値渡しする場合、マーシャラーは **StringBuilder** の内部バッファーへの参照を直接に呼び出し元に渡します。  呼び出し元と呼び出し先で、バッファーのサイズが一致する必要があります。  呼び出し元は、適切な長さの **StringBuilder** を作成します。  呼び出し先は、バッファーのオーバーランが発生しないように必要な予防措置をとる必要があります。  **StringBuilder** は、値渡しされる参照型は既定により In パラメーターとして渡されるという規則の例外です。  StringBuilder は常に In\/Out として渡されます。  
+  
+## 参照  
+ [既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)   
+ [Memory Management with the Interop Marshaler](http://msdn.microsoft.com/ja-jp/417206ce-ee3e-4619-9529-0c0b686c7bee)   
+ [Directional Attributes](http://msdn.microsoft.com/ja-jp/241ac5b5-928e-4969-8f58-1dbc048f9ea2)   
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)
\ No newline at end of file
diff --git a/docs/framework/interop/creating-a-class-to-hold-dll-functions.md b/docs/framework/interop/creating-a-class-to-hold-dll-functions.md
new file mode 100644
index 00000000000..15f5249fd94
--- /dev/null
+++ b/docs/framework/interop/creating-a-class-to-hold-dll-functions.md
@@ -0,0 +1,53 @@
+---
+title: "DLL 関数を保持するクラスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, DLL 関数"
+  - "COM 相互運用機能, プラットフォーム呼び出し"
+  - "DLL 関数"
+  - "相互運用 (アンマネージ コードとの), DLL 関数"
+  - "相互運用 (アンマネージ コードとの), プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し, 作成 (関数のクラスを)"
+  - "アンマネージ関数"
+ms.assetid: e08e4c34-0223-45f7-aa55-a3d8dd979b0f
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# DLL 関数を保持するクラスの作成
+マネージ クラス内の頻繁に使用される DLL 関数をラップすることは、プラットフォームの機能をカプセル化するための効果的な方法です。  ラップは必須ではありませんが、DLL 関数の定義には手間がかかり、エラーの原因にもなりやすいため、クラス ラッパーを用意しておくと便利です。  Visual Basic や C\# を使ってプログラミングしている場合は、DLL 関数をクラスまたは Visual Basic モジュール内で宣言する必要があります。  
+  
+ クラス内では、呼び出す各 DLL 関数に対して静的メソッドを定義します。  この定義には、メソッド引数を渡すときに使用される文字セットや呼び出し規約などの追加情報を含めることができます。この情報を省略すると、既定の設定が選択されます。  宣言のオプションと、既定の設定の完全なリストについては、「[マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)」を参照してください。  
+  
+ ラッピングが完了すると、他の静的関数のメソッドを呼び出す場合と同じ方法で、関数のメソッドを呼び出すことができます。  プラットフォーム呼び出しでは、基になるエクスポートされた関数が自動的に処理されます。  
+  
+ プラットフォーム呼び出しのためにマネージ クラスをデザインする場合は、クラスと DLL 関数との関係を考慮する必要があります。  たとえば、次のように操作できます。  
+  
+-   既存のクラス内で DLL 関数を宣言する。  
+  
+-   関数を分離し、検索しやすくするために、DLL 関数ごとに別個のクラスを作成する。  
+  
+-   論理的なグループを形成し、オーバーヘッドを減らすため、一連の関連する DLL 関数に対して 1 つのクラスを作成する。  
+  
+ クラスおよびそのメソッドには、任意の名前を付けることができます。  プラットフォーム呼び出しと共に使用する .NET ベースの宣言を構築する方法を示す例については、「[プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)」を参照してください。  
+  
+## 参照  
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)   
+ [DLL 内の関数の識別](../../../docs/framework/interop/identifying-functions-in-dlls.md)   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)   
+ [DLL 関数の呼び出し](../../../docs/framework/interop/calling-a-dll-function.md)
\ No newline at end of file
diff --git a/docs/framework/interop/creating-prototypes-in-managed-code.md b/docs/framework/interop/creating-prototypes-in-managed-code.md
new file mode 100644
index 00000000000..79fdb4613ce
--- /dev/null
+++ b/docs/framework/interop/creating-prototypes-in-managed-code.md
@@ -0,0 +1,242 @@
+---
+title: "マネージ コードでのプロトタイプの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, DLL 関数"
+  - "COM 相互運用機能, プラットフォーム呼び出し"
+  - "DLL 関数"
+  - "相互運用 (アンマネージ コードとの), DLL 関数"
+  - "相互運用 (アンマネージ コードとの), プラットフォーム呼び出し"
+  - "オブジェクト フィールド (プラットフォーム呼び出しにおける)"
+  - "プラットフォーム呼び出し, 作成 (プロトタイプを)"
+  - "プラットフォーム呼び出し, オブジェクト フィールド"
+  - "プロトタイプ (マネージ コード内の)"
+  - "アンマネージ関数"
+ms.assetid: ecdcf25d-cae3-4f07-a2b6-8397ac6dc42d
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# マネージ コードでのプロトタイプの作成
+このトピックは、アンマネージ関数にアクセスする方法について説明し、マネージ コードでメソッドの定義の注釈を設定するいくつかの属性フィールドを紹介しています。  プラットフォームの起動で使用する NET ベースの宣言を作成する方法を示す例については、「[プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)」を参照してください。  
+  
+ マネージ コードからアンマネージ DLL 関数にアクセスする前に、関数の名前とエクスポートする DLL の名前を知っている必要があります。  この情報を使用すると、マネージ DLL に実装されているアンマネージ関数の定義の作成を開始できます。  さらに、プラットフォーム呼び出しが関数を作成し、関数間でデータをマーシャリングする方法を調整できます。  
+  
+> [!NOTE]
+>  文字列を割り当てる Win32 API 関数を使用して、`LocalFree` などのメソッドを使用して文字列を解放できます。  プラットフォーム呼び出しは、このようなパラメーターを異なる方法で処理します。  プラットフォーム呼び出しでは、パラメーターを `String` 型の代わりに `IntPtr` 型にします。  <xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName> クラスにより提供されるメソッドを使用して、型を手動で文字列に変換し、手動で解放します。  
+  
+## 宣言の基本  
+ アンマネージ関数に対するマネージ定義は、次の例で確認できるように、言語に依存します。  完全なコード例については、「[プラットフォーム呼び出しの例](../../../docs/framework/interop/platform-invoke-examples.md)」を参照してください。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+Public Class Win32  
+    Declare Auto Function MessageBox Lib "user32.dll" _  
+       (ByVal hWnd As Integer, _  
+        ByVal txt As String, ByVal caption As String, _  
+        ByVal Typ As Integer) As IntPtr  
+End Class  
+```  
+  
+ <xref:System.Runtime.InteropServices.DllImportAttribute.BestFitMapping>、<xref:System.Runtime.InteropServices.DllImportAttribute.CallingConvention>、<xref:System.Runtime.InteropServices.DllImportAttribute.ExactSpelling>、<xref:System.Runtime.InteropServices.DllImportAttribute.PreserveSig>、<xref:System.Runtime.InteropServices.DllImportAttribute.SetLastError>、または <xref:System.Runtime.InteropServices.DllImportAttribute.ThrowOnUnmappableChar> の各フィールドを [!INCLUDE[vbprvbext](../../../includes/vbprvbext-md.md)] 宣言に適用するには、`Declare` ステートメントの代わりに <xref:System.Runtime.InteropServices.DllImportAttribute> 属性を使用する必要があります。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+Public Class Win32  
+   <DllImport ("user32.dll", CharSet := CharSet.Auto)> _  
+   Public Shared Function MessageBox (ByVal hWnd As Integer, _  
+        ByVal txt As String, ByVal caption As String, _  
+        ByVal Typ As Integer) As IntPtr  
+   End Function  
+End Class  
+  
+```  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+[DllImport("user32.dll")]  
+    public static extern IntPtr MessageBox(int hWnd, String text,   
+                                       String caption, uint type);  
+  
+```  
+  
+```cpp  
+using namespace System::Runtime::InteropServices;  
+[DllImport("user32.dll")]  
+    extern "C" IntPtr MessageBox(int hWnd, String* pText,  
+    String* pCaption unsigned int uType);  
+```  
+  
+## 定義の調整  
+ 明示的に設定するかどうかに関係なく、属性フィールドは作業はマネージ コードの動作を動作中に定義します。  プラットフォーム呼び出しは、アセンブリ内のメタデータとして存在するさまざまなフィールドで設定された既定値どおりに動作します。  1 つまたは複数のフィールドの値を調整することによって、この既定の動作を変更することができます。  多くの場合、<xref:System.Runtime.InteropServices.DllImportAttribute> を使用して値を設定します。  
+  
+ 次の表では、プラットフォーム呼び出しに関連する属性フィールドの完全なセットを一覧表示します。  各フィールドについては、表に既定値とこれらのフィールドを使用してアンマネージ DLL 関数を定義する方法に関する情報へのリンクが含まれます。  
+  
+|フィールド|説明|  
+|-----------|--------|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.BestFitMapping>|最適なマッピングを有効または無効にします。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.CallingConvention>|メソッドの引数を渡すときに使用する呼び出し規約を指定します。  既定値は `WinAPI` で、32 ビットの Intel ベース プラットフォームの `__stdcall` に対応します。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.CharSet>|名前修飾および文字列の引数を関数にマーシャリングする方法を管理します。  既定値は、`CharSet.Ansi` です。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.EntryPoint>|呼び出される DLL エントリ ポイントを指定します。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.ExactSpelling>|文字セットに対応するエントリ ポイントを変更する必要があるかどうかを制御します。  既定値は、プログラミング言語によって異なります。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.PreserveSig>|マネージ メソッドのシグネチャが、HRESULT を返すアンマネージ シグネチャに変換され、戻り値の追加の \[out, retval\] 引数を持つかどうかを制御します。<br /><br /> 既定値は `true` です \(シグネチャは変換されません\)。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.SetLastError>|呼び出し元が `Marshal.GetLastWin32Error` API の関数を使用して、メソッドの実行中にエラーが発生したかどうかを判断できるようにします。  Visual Basic では既定値は `true`、C\# および C\+\+ では既定値は `false` です。|  
+|<xref:System.Runtime.InteropServices.DllImportAttribute.ThrowOnUnmappableChar>|ANSI の"?" 文字に変換されるマップできない Unicode 文字での例外のスローを制御します。|  
+  
+ 詳細なリファレンス情報については、「[DllImportAttribute クラス](frlrfSystemRuntimeInteropServicesDllImportAttributeClassTopic)」を参照してください。  
+  
+## プラットフォーム呼び出しのセキュリティに関する考慮事項  
+ <xref:System.Security.Permissions.SecurityAction> 列挙型の `Assert`、`Deny`、および `PermitOnly` のメンバーは、*スタック ウォーク修飾子*と呼ばれます。  プラットフォーム呼び出しの宣言および COM インターフェイス定義言語 \(IDL\) ステートメントの宣言属性として使用される場合、これらのメンバーは無視されます。  
+  
+### プラットフォーム呼び出しの例  
+ このセクションのプラットフォーム呼び出しのサンプルは、`RegistryPermission` スタック ウォーク修飾子を持つ属性の使用方法を示します。  
+  
+ 次のコード例では、<xref:System.Security.Permissions.SecurityAction> `Assert`、`Deny`、および `PermitOnly` 修飾子は無視されます。  
+  
+```  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+[RegistryPermission(SecurityAction.Assert, Unrestricted = true)]  
+    private static extern bool CallRegistryPermissionAssert();  
+  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+[RegistryPermission(SecurityAction.Deny, Unrestricted = true)]  
+    private static extern bool CallRegistryPermissionDeny();  
+  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+[RegistryPermission(SecurityAction.PermitOnly, Unrestricted = true)]  
+    private static extern bool CallRegistryPermissionDeny();  
+```  
+  
+ ただし、次の例の `Demand` 修飾子は受け入れられます。  
+  
+```  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+[RegistryPermission(SecurityAction.Demand, Unrestricted = true)]  
+    private static extern bool CallRegistryPermissionDeny();  
+```  
+  
+ プラットフォーム呼び出しを含む \(ラップする\) クラスに配置されている場合、<xref:System.Security.Permissions.SecurityAction> 修飾子は正常に機能します。  
+  
+```cpp  
+[RegistryPermission(SecurityAction.Demand, Unrestricted = true)]  
+public ref class PInvokeWrapper  
+{  
+public:  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+    private static extern bool CallRegistryPermissionDeny();  
+};  
+```  
+  
+```csharp  
+[RegistryPermission(SecurityAction.Demand, Unrestricted = true)]  
+class PInvokeWrapper  
+{  
+[DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+    private static extern bool CallRegistryPermissionDeny();  
+}  
+  
+```  
+  
+ <xref:System.Security.Permissions.SecurityAction> 修飾子は、プラットフォーム呼び出しの呼び出し元に配置されたネストしたシナリオでも正しく動作します。  
+  
+```cpp  
+{  
+public ref class PInvokeWrapper  
+public:  
+    [DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+    private static extern bool CallRegistryPermissionDeny();  
+  
+    [RegistryPermission(SecurityAction.Demand, Unrestricted = true)]  
+    public static bool CallRegistryPermission()  
+    {  
+     return CallRegistryPermissionInternal();  
+    }  
+};  
+```  
+  
+```csharp  
+class PInvokeScenario  
+{  
+    [DllImport("MyClass.dll", EntryPoint = "CallRegistryPermission")]  
+    private static extern bool CallRegistryPermissionInternal();  
+  
+    [RegistryPermission(SecurityAction.Assert, Unrestricted = true)]  
+    public static bool CallRegistryPermission()  
+    {  
+     return CallRegistryPermissionInternal();  
+    }  
+}  
+```  
+  
+#### COM 相互運用機能の例  
+ このセクションの次の COM 相互運用機能の例は、スタック ウォーク修飾子を持つ `RegistryPermission` 属性の使用方法を示します。  
+  
+ 次の COM 相互運用機能のインターフェイスの宣言は、前のセクションのプラットフォーム呼び出しの例と同様に、`Assert`、`Deny`、および `PermitOnly` の修飾子を無視します。  
+  
+```  
+[ComImport, Guid("12345678-43E6-43c9-9A13-47F40B338DE0")]  
+interface IAssertStubsItf  
+{  
+[RegistryPermission(SecurityAction.Assert, Unrestricted = true)]  
+    bool CallRegistryPermission();  
+[FileIOPermission(SecurityAction.Assert, Unrestricted = true)]  
+    bool CallFileIoPermission();  
+}  
+  
+[ComImport, Guid("12345678-43E6-43c9-9A13-47F40B338DE0")]  
+interface IDenyStubsItf  
+{  
+[RegistryPermission(SecurityAction.Deny, Unrestricted = true)]  
+    bool CallRegistryPermission();  
+[FileIOPermission(SecurityAction.Deny, Unrestricted = true)]  
+    bool CallFileIoPermission();  
+}  
+  
+[ComImport, Guid("12345678-43E6-43c9-9A13-47F40B338DE0")]  
+interface IAssertStubsItf  
+{  
+[RegistryPermission(SecurityAction.PermitOnly, Unrestricted = true)]  
+    bool CallRegistryPermission();  
+[FileIOPermission(SecurityAction.PermitOnly, Unrestricted = true)]  
+    bool CallFileIoPermission();  
+}  
+  
+```  
+  
+ さらに、次の例に示すように、`Demand` 修飾子は COM 相互運用機能のインターフェイスの宣言のシナリオでは許可されません。  
+  
+```  
+[ComImport, Guid("12345678-43E6-43c9-9A13-47F40B338DE0")]  
+interface IDemandStubsItf  
+{  
+[RegistryPermission(SecurityAction.Demand, Unrestricted = true)]  
+    bool CallRegistryPermission();  
+[FileIOPermission(SecurityAction.Demand, Unrestricted = true)]  
+    bool CallFileIoPermission();  
+}  
+```  
+  
+## 参照  
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)   
+ [エントリ ポイントの指定](../../../docs/framework/interop/specifying-an-entry-point.md)   
+ [文字セットの指定](../../../docs/framework/interop/specifying-a-character-set.md)   
+ [プラットフォーム呼び出しの例](../../../docs/framework/interop/platform-invoke-examples.md)   
+ [Platform Invoke Security Considerations](http://msdn.microsoft.com/ja-jp/bbcc67f7-50b5-4917-88ed-cb15470409fb)   
+ [DLL 内の関数の識別](../../../docs/framework/interop/identifying-functions-in-dlls.md)   
+ [DLL 関数を保持するクラスの作成](../../../docs/framework/interop/creating-a-class-to-hold-dll-functions.md)   
+ [DLL 関数の呼び出し](../../../docs/framework/interop/calling-a-dll-function.md)
\ No newline at end of file
diff --git a/docs/framework/interop/default-marshaling-behavior.md b/docs/framework/interop/default-marshaling-behavior.md
new file mode 100644
index 00000000000..f9c425160dc
--- /dev/null
+++ b/docs/framework/interop/default-marshaling-behavior.md
@@ -0,0 +1,459 @@
+---
+title: "既定のマーシャリングの動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用マーシャリング, 既定値"
+  - "相互運用 (アンマネージ コードとの), マーシャリング"
+  - "マーシャリングの動作"
+ms.assetid: c0a9bcdf-3df8-4db3-b1b6-abbdb2af809a
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 既定のマーシャリングの動作
+相互運用マーシャリングは、メソッドのパラメーターに関連付けられたデータが、マネージ メモリとアンマネージ メモリの間で渡されるときに、どのように動作するかを指示する規則に従って機能します。  これらの組み込みの規則は、データ型の変換などのマーシャリング動作、呼び出し先が渡されたデータを変更してその変更を呼び出し元にこ返すことが可能かどうか、およびどのような状況のときにマーシャラーがパフォーマンスの最適化を実現するかを制御します。  
+  
+ このセクションでは、相互運用マーシャリング サービスの既定の動作特性を示します。  ここでは、配列、ブール型、char 型、デリゲート、クラス、オブジェクト、文字列、および構造体のマーシャリングに関する詳細情報を示します。  
+  
+> [!NOTE]
+>  ジェネリック型のマーシャリングはサポートされていません。  詳しくは、「[Interoperating Using Generic Types](http://msdn.microsoft.com/ja-jp/26b88e03-085b-4b53-94ba-a5a9c709ce58)」を参照してください。  
+  
+## 相互運用マーシャラーによるメモリ管理  
+ 相互運用マーシャラーは、アンマネージ コードによって割り当てられたメモリを常に解放しようとします。  この動作は、COM メモリの管理規則に準拠していますが、ネイティブ C\+\+ を制御する規則とは異なります。  
+  
+ ネイティブ C\+\+ の動作 \(メモリを解放しない\) を予期している場合、ポインターのメモリを自動的に解放するプラットフォーム呼び出しを使用すると、混乱が生じることがあります。  たとえば、C\+\+ DLL からの次のアンマネージ メソッドを呼び出しても、メモリは自動的に解放されません。  
+  
+### アンマネージ シグネチャ  
+  
+```  
+BSTR MethodOne (BSTR b) {  
+     return b;  
+}  
+```  
+  
+ ただし、メソッドをプラットフォーム呼び出しのプロトタイプとして定義する場合は、各 **BSTR** 型を <xref:System.String> 型に置き換えて、`MethodOne` を呼び出します。共通言語ランタイムは、`b` の解放を 2 回試行します。  **文字列**型ではなく <xref:System.IntPtr> 型を使用することにより、マーシャリングの動作を変更できます。  
+  
+ ランタイムは、常に **CoTaskMemFree** メソッドを使用してメモリを解放します。  使用しているメモリが **CoTaskMemAlloc** メソッドで割り当てられていない場合、**IntPtr** を使用し、適切なメソッドを使用して手動でメモリを解放する必要があります。  同様に、カーネル メモリへのポインターを返す **GetCommandLine** 関数を Kernel32.dll から使用するときなど、メモリを解放してはいけない状況のときには、自動的なメモリの解放を防止できます。  手動でメモリを解放する方法について詳しくは、「[Buffers サンプル](http://msdn.microsoft.com/ja-jp/e30d36e8-d7c4-4936-916a-8fdbe4d9ffd5)」を参照してください。  
+  
+## クラスに対する既定のマーシャリング  
+ クラスは、COM 相互運用でのみマーシャリングすることができ、常にインターフェイスとしてマーシャリングされます。  クラスをマーシャリングするために使用されるインターフェイスが、クラス インターフェイスと呼ばれる場合があります。  クラス インターフェイスを任意のインターフェイスでオーバーライドする方法について詳しくは、「[クラス インターフェイスの概要](http://msdn.microsoft.com/ja-jp/733c0dd2-12e5-46e6-8de1-39d5b25df024)」を参照してください。  
+  
+### クラスを COM に渡す  
+ マネージ クラスが COM に渡されると、相互運用マーシャラーは自動的にクラスを COM プロキシでラップし、プロキシによって生成されたクラス インターフェイスを COM メソッド呼び出しに渡します。  その後、プロキシは、クラス インターフェイス上のすべての呼び出しを、マネージ オブジェクトにデリゲートして戻します。  プロキシはまた、クラスによって明示的に実装されていない他のインターフェイスも公開します。  プロキシは、クラスの代わりに、**IUnknown** や **IDispatch** などのインターフェイスを自動的に実装します。  
+  
+### クラスを .NET Code に渡す  
+ コクラスは、通常、COM のメソッド引数として使用されません。  代わりに、通常は既定のインターフェイスがコクラスの代わりに渡されます。  
+  
+ インターフェイスがマネージ コードに渡されると、相互運用マーシャラーは、インターフェイスを適切なラッパーでラップし、そのラッパーをマネージ メソッドに渡すことを担当します。  どのラッパーを使用するかは難しい判断となることがあります。  COM オブジェクトのすべてのインスタンスは、オブジェクトが実装するインターフェイスの数に関係なく、1 つの一意のラッパーを持ちます。  たとえば、5 つの異なるインターフェイスを実装する 1 つの COM オブジェクトには 1 つのラッパーだけがあります。  同一のラッパーが、5 つのすべてのインターフェイスを公開します。  COM オブジェクトの 2 つのインスタンスが作成される場合、ラッパーの 2 つのインスタンスが作成されます。  
+  
+ ラッパーがその有効期間中は同じ型を維持するように、相互運用マーシャラーは、オブジェクトによって公開されるインターフェイスが初めてマーシャラーを介して渡されるときに、正しいラッパーを識別する必要があります。  マーシャラーは、オブジェクトが実装するインターフェイスの 1 つに注目することにより、オブジェクトを識別します。  
+  
+ たとえば、マーシャラーは、マネージ コードに渡されたインターフェイスをラップするために、クラス ラッパーを使用する必要があると判別します。  インターフェイスが初めてマーシャラーを介して渡されるとき、マーシャラーは、インターフェイスが既知のオブジェクトからのものかどうかを確認します。  このチェックは、以下の 2 つの状況で発生します。  
+  
+-   インターフェイスは、他の場所で COM に渡された別のマネージ オブジェクトによって実装されています。  マーシャラーは、マネージ オブジェクトによって公開されるインターフェイスを簡単に特定し、インターフェイスと実装を提供するマネージ オブジェクトとで突き合わせすることができます。  その後、マネージ オブジェクトはメソッドに渡され、ラッパーは必要ありません。  
+  
+-   既ににラップされているオブジェクトは、インターフェイスを実装しています。  このような状況かどうかを確認するために、マーシャラーは **IUnknown** インターフェイスのためにオブジェクトのクエリを実行して、返されたインターフェイスを既にラップされているその他のオブジェクトのインターフェイスと比較します。  インターフェイスが別のラッパーのものと同じ場合、それらのオブジェクトには同じ ID があり、既存のラッパーがメソッドに渡されます。  
+  
+ インターフェイスが既知のオブジェクトからのものではない場合、マーシャラーは以下を実行します。  
+  
+1.  マーシャラーは **IProvideClassInfo2** インターフェイスのためにオブジェクトのクエリを実行します。  提供された場合、マーシャラーは、**IProvideClassInfo2.GetGUID** から返される CLSID を使用して、インターフェイスを提供するコクラスを識別します。  CLSID によって、マーシャラーは、アセンブリが事前に登録されている場合にレジストリからラッパーを見つけることができます。  
+  
+2.  マーシャラーは**IProvideClassInfo** インターフェイスのためにインターフェイスのクエリを実行します。  提供された場合、マーシャラーは、**IProvideClassInfo.GetClassinfo** から返される **ITypeInfo** を使用して、インターフェイスを公開するクラスの CLSID を決定します。  マーシャラーは、CLSID を使用して、ラッパーのメタデータを見つけることができます。  
+  
+3.  マーシャラーは、まだクラスを識別できない場合には、**System.\_\_ComObject** と呼ばれるジェネリック ラッパー クラスを使用してインターフェイスをラップします。  
+  
+## デリゲートに対する既定のマーシャリング  
+ マネージ デリゲートは、呼び出し元のメカニズムに基づいて、COM インターフェイスまたは関数ポインターとしてマーシャリングされます。  
+  
+-   プラットフォーム呼び出しの場合、デリゲートは、既定でアンマネージ関数ポインターとしてマーシャリングされます。  
+  
+-   COM 相互運用の場合、デリゲートは、既定で **\_Delegate** 型の COM インターフェイスとしてマーシャリングされます。  **\_Delegate** インターフェイスは Mscorlib.tlb のタイプ ライブラリで定義され、デリゲートが参照するメソッドの呼び出しを可能にする <xref:System.Delegate.DynamicInvoke%2A?displayProperty=fullName> メソッドが含まれています。  
+  
+ 次の表は、マネージ デリゲート データ型のマーシャリング オプションを示しています。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は、デリゲートをマーシャリングする <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値を提供します。  
+  
+|列挙型|アンマネージ形式の説明|  
+|---------|-----------------|  
+|**UnmanagedType.FunctionPtr**|アンマネージ関数ポインター。|  
+|**UnmanagedType.Interface**|Mscorlib.tlb で定義されている、**\_Delegate** 型のインターフェイス。|  
+  
+ `DelegateTestInterface` のメソッドが COM タイプ ライブラリにエクスポートされる、次のコード例を検討してください。  **ref** \(または **ByRef**\) キーワードでマークされたデリゲートだけが、In\/Out パラメーターとして渡されることに注意してください。  
+  
+```csharp  
+using System;  
+using System.Runtime.InteropServices;  
+  
+public interface DelegateTest {  
+void m1(Delegate d);  
+void m2([MarshalAs(UnmanagedType.Interface)] Delegate d);     
+void m3([MarshalAs(UnmanagedType.Interface)] ref Delegate d);    
+void m4([MarshalAs(UnmanagedType.FunctionPtr)] Delegate d);   
+void m5([MarshalAs(UnmanagedType.FunctionPtr)] ref Delegate d);     
+}  
+```  
+  
+### タイプ ライブラリの表現  
+  
+```  
+importlib("mscorlib.tlb");  
+interface DelegateTest : IDispatch {  
+[id(…)] HRESULT m1([in] _Delegate* d);  
+[id(…)] HRESULT m2([in] _Delegate* d);  
+[id(…)] HRESULT m3([in, out] _Delegate** d);  
+[id()] HRESULT m4([in] int d);  
+[id()] HRESULT m5([in, out] int *d);  
+   };  
+```  
+  
+ 他のアンマネージ関数ポインターが逆参照できるのと同様に、関数ポインターは逆参照できます。  
+  
+> [!NOTE]
+>  アンマネージ コードで保持されている、マネージ デリゲートへの関数ポインターに対する参照は、共通言語ランタイムがマネージ オブジェクトでガベージ コレクションを実行することを防止しません。  
+  
+ たとえば、`SetChangeHandler` メソッドに渡される `cb` オブジェクトへの参照は `Test` メソッドの有効期間を超えて `cb` を有効のまま保持しないので、次のコードは正しくありません。  `cb` オブジェクトでガベージ コレクションを実行した後、`SetChangeHandler` に渡された関数ポインターは無効になります。  
+  
+```csharp  
+public class ExternalAPI {  
+   [DllImport("External.dll")]  
+   public static extern void SetChangeHandler(  
+      [MarshalAs(UnmanagedType.FunctionPtr)]ChangeDelegate d);  
+}  
+public delegate bool ChangeDelegate([MarshalAs(UnmanagedType.LPWStr) string S);  
+public class CallBackClass {  
+   public bool OnChange(string S){ return true;}  
+}  
+internal class DelegateTest {  
+   public static void Test() {  
+      CallBackClass cb = new CallBackClass();  
+      // Caution: The following reference on the cb object does not keep the   
+      // object from being garbage collected after the Main method   
+      // executes.  
+      ExternalAPI.SetChangeHandler(new ChangeDelegate(cb.OnChange));     
+   }  
+}  
+```  
+  
+ 予期しないガベージ コレクションを補正するために、呼び出し元は、アンマネージ関数ポインターの使用中は `cb` オブジェクトが有効のまま保持されるようにする必要があります。  必要に応じて、次の例に示すように、関数ポインターが不要になった際にアンマネージ コードがマネージ コードに通知するようにすることができます。  
+  
+```csharp  
+internal class DelegateTest {  
+   CallBackClass cb;  
+   // Called before ever using the callback function.  
+   public static void SetChangeHandler() {  
+      cb = new CallBackClass();  
+      ExternalAPI.SetChangeHandler(new ChangeDelegate(cb.OnChange));  
+   }  
+   // Called after using the callback function for the last time.  
+   public static void RemoveChangeHandler() {  
+      // The cb object can be collected now. The unmanaged code is   
+      // finished with the callback function.  
+      cb = null;  
+   }  
+}  
+```  
+  
+## 値型に対する既定のマーシャリング  
+ 整数や浮動小数点数など、ほとんどの値型は、[blittable](../../../docs/framework/interop/blittable-and-non-blittable-types.md) であり、マーシャリングを必要としません。  その他の [非 blittable](../../../docs/framework/interop/blittable-and-non-blittable-types.md) 型は、マネージ メモリとアンマネージ メモリに類似しない表現があり、マーシャリングが必要です。  さらに他の型は、相互運用性の境界を越えて、明示的な書式設定が必要です。  
+  
+ このトピックでは、書式設定された値の型について以下の情報を示します。  
+  
+-   [プラットフォーム呼び出しで使用される値型](#cpcondefaultmarshalingforvaluetypesanchor2)  
+  
+-   [COM 相互運用で使用される値型](#cpcondefaultmarshalingforvaluetypesanchor3)  
+  
+ 書式指定された型について説明することに加えて、このトピックでは、マーシャリング動作が通常ではない[システム値型](#cpcondefaultmarshalingforvaluetypesanchor1)について示します。  
+  
+ 書式設定された型は、メモリ内のメンバーのレイアウトを明示的に制御するための情報を含む複合型です。  メンバーのレイアウト情報は、<xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性を使用して示すことができます。  レイアウトは、次のいずれかの <xref:System.Runtime.InteropServices.LayoutKind> 列挙値です。  
+  
+-   **LayoutKind.Automatic**  
+  
+     共通言語ランタイムで、効率を上げるのために、型のメンバーを自由に再配置できることを示します。  ただし、値型がアンマネージ コードに渡されると、メンバーのレイアウトは予測可能です。  このような構造体を自動的にマーシャリングしようとすると、例外が発生します。  
+  
+-   **LayoutKind.Sequential**  
+  
+     型のメンバーは、マネージ型定義での順序と同じ順序で、アンマネージ メモリにレイアウトされることを示します。  
+  
+-   **LayoutKind.Explicit**  
+  
+     メンバーが、各フィールドに指定された <xref:System.Runtime.InteropServices.FieldOffsetAttribute> に基づいてレイアウトされることを示します。  
+  
+<a name="cpcondefaultmarshalingforvaluetypesanchor2"></a>   
+### プラットフォーム呼び出しで使用される値型  
+ 次の例では、`Point` と `Rect` 型が、**StructLayoutAttribute** を使用してメンバーのレイアウト情報を提供します。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+<StructLayout(LayoutKind.Sequential)> Public Structure Point  
+   Public x As Integer  
+   Public y As Integer  
+End Structure  
+<StructLayout(LayoutKind.Explicit)> Public Structure Rect  
+   <FieldOffset(0)> Public left As Integer  
+   <FieldOffset(4)> Public top As Integer  
+   <FieldOffset(8)> Public right As Integer  
+   <FieldOffset(12)> Public bottom As Integer  
+End Structure  
+  
+```  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+[StructLayout(LayoutKind.Sequential)]  
+public struct Point {  
+   public int x;  
+   public int y;  
+}     
+  
+[StructLayout(LayoutKind.Explicit)]  
+public struct Rect {  
+   [FieldOffset(0)] public int left;  
+   [FieldOffset(4)] public int top;  
+   [FieldOffset(8)] public int right;  
+   [FieldOffset(12)] public int bottom;  
+}  
+```  
+  
+ アンマネージ コードにマーシャリングされるとき、これらの書式指定された型は C スタイルの構造体としてマーシャリングされます。  これは、構造体の引数を持つアンマネージ API を呼び出すための、簡単な方法を提供します。  たとえば、次のようにして、`POINT` と `RECT` 構造体を Microsoft Win32 API **PtInRect** 関数に渡すことができます。  
+  
+```  
+BOOL PtInRect(const RECT *lprc, POINT pt);  
+```  
+  
+ 次のプラットフォーム呼び出し定義を使用して、構造体を渡すことができます  
+  
+```vb  
+Class Win32API      
+   Declare Auto Function PtInRect Lib "User32.dll" _  
+    (ByRef r As Rect, p As Point) As Boolean  
+End Class  
+  
+```  
+  
+```csharp  
+class Win32API {  
+   [DllImport("User32.dll")]  
+   public static extern Bool PtInRect(ref Rect r, Point p);  
+}  
+```  
+  
+ アンマネージ API では、`RECT` へのポインターが関数に渡されることが予期されているので、`Rect` 値型は参照によって渡す必要があります。  アンマネージ API では、`POINT` がスタックで渡されることが予期されているので、`Point` 値型は値によって渡します。  この微妙な違いは、非常に重要です。  参照は、ポインターとしてアンマネージ コードに渡されます。  値は、スタックでアンマネージ コードに渡されます。  
+  
+> [!NOTE]
+>  書式設定された型が構造体としてマーシャリングされると、型内のフィールドだけがアクセス可能となります。  型にメソッド、プロパティ、またはイベントがある場合、それらにはアンマネージ コードからアクセスできません。  
+  
+ クラスも、固定のメンバー レイアウトがあれば、C スタイルの構造体としてアンマネージ コードにマーシャリングできます。  クラスのメンバー レイアウト情報も、<xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性で提供されます。  固定レイアウトの値型と固定レイアウトのクラスの主な違いは、それらがアンマネージ コードにマーシャリングされる方法です。  値型は \(スタックで\) 値によって渡されるので、呼び出し先が型のメンバーに変更を加えても、その変更は呼び出し元に示されません。  参照型は参照によって渡される \(型への参照がスタックで渡される\) ので、呼び出し先が型の blittable 型のメンバーに加えるすべての変更は呼び出し元に示されます。  
+  
+> [!NOTE]
+>  参照型に非 blittable 型のメンバーがある場合、変換は 2 回必要となります。1 回目は引数がアンマネージ サイトに渡されるときで、2 回目は呼び出しから返されるときです。  この追加のオーバーヘッドがあるために、呼び出し先による変更を呼び出し元が参照できるようにする場合は、In\/Out パラメーターを引数に明示的に適用する必要があります。  
+  
+ 次の例では、`SystemTime` クラスにシーケンシャル メンバー レイアウトがあり、それを Win32 API **GetSystemTime** 関数に渡すことができます。  
+  
+```vb  
+<StructLayout(LayoutKind.Sequential)> Public Class SystemTime  
+   Public wYear As System.UInt16  
+   Public wMonth As System.UInt16  
+   Public wDayOfWeek As System.UInt16  
+   Public wDay As System.UInt16  
+   Public wHour As System.UInt16  
+   Public wMinute As System.UInt16  
+   Public wSecond As System.UInt16  
+   Public wMilliseconds As System.UInt16  
+End Class  
+  
+```  
+  
+```csharp  
+[StructLayout(LayoutKind.Sequential)]  
+   public class SystemTime {  
+   public ushort wYear;   
+   public ushort wMonth;  
+   public ushort wDayOfWeek;   
+   public ushort wDay;   
+   public ushort wHour;   
+   public ushort wMinute;   
+   public ushort wSecond;   
+   public ushort wMilliseconds;   
+}  
+```  
+  
+ **GetSystemTime** 関数は次のように定義されています。  
+  
+```  
+void GetSystemTime(SYSTEMTIME* SystemTime);  
+```  
+  
+ **GetSystemTime** に対する同等のプラットフォーム呼び出し定義は、次のようになります。  
+  
+```vb  
+Public Class Win32  
+   Declare Auto Sub GetSystemTime Lib "Kernel32.dll" (ByVal sysTime _  
+   As SystemTime)  
+End Class  
+  
+```  
+  
+```csharp  
+class Win32API {  
+   [DllImport("Kernel32.dll", CharSet=CharSet.Auto)]  
+   public static extern void GetSystemTime(SystemTime st);  
+}  
+```  
+  
+ `SystemTime` は値型ではなくクラスなので、`SystemTime` 引数は参照引数として型指定されていないことに注意してください。  値型とは異なり、クラスは常に参照によって渡されます。  
+  
+ 次のコード例は、`SetXY` と呼ばれるメソッドを持つ、異なる `Point` クラスを示しています。  型にはシーケンシャル レイアウトがあるため、それをアンマネージ コードに渡して、構造体としてマーシャリングすることができます。  ただし、`SetXY` メンバーは、オブジェクトが参照によって渡される場合でも、アンマネージ コードから呼び出すことができません。  
+  
+```vb  
+<StructLayout(LayoutKind.Sequential)> Public Class Point  
+   Private x, y As Integer  
+   Public Sub SetXY(x As Integer, y As Integer)  
+      Me.x = x  
+      Me.y = y  
+   End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+[StructLayout(LayoutKind.Sequential)]  
+public class Point {  
+   int x, y;  
+   public void SetXY(int x, int y){   
+      this.x = x;  
+      this.y = y;  
+   }  
+}  
+```  
+  
+<a name="cpcondefaultmarshalingforvaluetypesanchor3"></a>   
+### COM 相互運用で使用される値型  
+ 書式指定された型は、COM 相互運用のメソッドの呼び出しに渡すこともできます。  実際には、タイプ ライブラリにエクスポートされると、値型は構造体に自動的に変換されます。  次の例に示すように、`Point` 値型は `Point` という名前の型定義 \(typedef\) になります。  タイプ ライブラリ内の他の場所にある `Point` 値型へのすべての参照は、`Point` typedef に置き換えられます。  
+  
+ **タイプ ライブラリの表現**  
+  
+```  
+typedef struct tagPoint {  
+   int x;  
+   int y;  
+} Point;  
+interface _Graphics {  
+   …  
+   HRESULT SetPoint ([in] Point p)  
+   HRESULT SetPointRef ([in,out] Point *p)  
+   HRESULT GetPoint ([out,retval] Point *p)  
+}  
+```  
+  
+ 値と参照をプラットフォーム呼び出しにマーシャリングする際に使用されるものと同じ規則が、COM インターフェイスを介してマーシャリングする際にも使用されます。  たとえば、`Point` 値型のインスタンスが .NET Framework から COM に渡されるとき、`Point` は値によって渡されます。  `Point` 値型が参照によって渡される場合、`Point` へのポインターはスタックで渡されます。  相互運用マーシャラーは、どちらの方向でも、より高いレベルの間接参照 \(**Point \*\***\) はサポートしていません。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.InteropServices.LayoutKind> 列挙値が **Explicit** に設定された構造体は、エクスポートされたタイプ ライブラリが明示的なレイアウトを表現できないので、COM 相互運用で使用することはできません。  
+  
+<a name="cpcondefaultmarshalingforvaluetypesanchor1"></a>   
+### システムの値型  
+ <xref:System> 名前空間には、ランタイムのプリミティブ型のボックス化された形式を表す、いくつかの値型があります。  たとえば、値型 <xref:System.Int32?displayProperty=fullName> 構造体は、**ELEMENT\_TYPE\_I4** のボックス化された形式を表します。  これらの型は、書式設定された他の型のように構造体としてマーシャリングするのではなく、それらがボックス化するプリミティブ型と同じ方法でマーシャリングします。  そのため、**System.Int32** は、**long** 型の 1 つのメンバーを含む構造体としてではなく、**ELEMENT\_TYPE\_I4** としてマーシャリングされます。  次の表には、プリミティブ型のボックス化された表現である、**System** 名前空間にある値型の一覧が含まれています。  
+  
+|システムの値型|要素型|  
+|-------------|---------|  
+|<xref:System.Boolean?displayProperty=fullName>|**ELEMENT\_TYPE\_BOOLEAN**|  
+|<xref:System.SByte?displayProperty=fullName>|**ELEMENT\_TYPE\_I1**|  
+|<xref:System.Byte?displayProperty=fullName>|**ELEMENT\_TYPE\_UI1**|  
+|<xref:System.Char?displayProperty=fullName>|**ELEMENT\_TYPE\_CHAR**|  
+|<xref:System.Int16?displayProperty=fullName>|**ELEMENT\_TYPE\_I2**|  
+|<xref:System.UInt16?displayProperty=fullName>|**ELEMENT\_TYPE\_U2**|  
+|<xref:System.Int32?displayProperty=fullName>|**ELEMENT\_TYPE\_I4**|  
+|<xref:System.UInt32?displayProperty=fullName>|**ELEMENT\_TYPE\_U4**|  
+|<xref:System.Int64?displayProperty=fullName>|**ELEMENT\_TYPE\_I8**|  
+|<xref:System.UInt64?displayProperty=fullName>|**ELEMENT\_TYPE\_U8**|  
+|<xref:System.Single?displayProperty=fullName>|**ELEMENT\_TYPE\_R4**|  
+|<xref:System.Double?displayProperty=fullName>|**ELEMENT\_TYPE\_R8**|  
+|<xref:System.String?displayProperty=fullName>|**ELEMENT\_TYPE\_STRING**|  
+|<xref:System.IntPtr?displayProperty=fullName>|**ELEMENT\_TYPE\_I**|  
+|<xref:System.UIntPtr?displayProperty=fullName>|**ELEMENT\_TYPE\_U**|  
+  
+ **System** 名前空間にある他の値型は、処理が異なります。  アンマネージ コードではこれらの型の形式が既に確立されているため、マーシャラーには、それらをマーシャリングするための特別な規則があります。  次の表では、**System** 名前空間にある特殊な値型、およびそれらがマーシャリングされるアンマネージ型を一覧で示します。  
+  
+|システムの値型|IDL 型|  
+|-------------|-----------|  
+|<xref:System.DateTime?displayProperty=fullName>|**DATE**|  
+|<xref:System.Decimal?displayProperty=fullName>|**DECIMAL**|  
+|<xref:System.Guid?displayProperty=fullName>|**GUID**|  
+|<xref:System.Drawing.Color?displayProperty=fullName>|**OLE\_COLOR**|  
+  
+ 次のコードでは、Stdole2 タイプ ライブラリにあるアンマネージ型の **DATE**、**GUID**、**DECIMAL**、および **OLE\_COLOR** の定義を示します。  
+  
+#### タイプ ライブラリの表現  
+  
+```  
+typedef double DATE;  
+typedef DWORD OLE_COLOR;  
+  
+typedef struct tagDEC {  
+    USHORT    wReserved;  
+    BYTE      scale;  
+    BYTE      sign;  
+    ULONG     Hi32;  
+    ULONGLONG Lo64;  
+} DECIMAL;  
+  
+typedef struct tagGUID {  
+    DWORD Data1;  
+    WORD  Data2;  
+    WORD  Data3;  
+    BYTE  Data4[ 8 ];  
+} GUID;  
+```  
+  
+ 次のコードでは、マネージ `IValueTypes` インターフェイスでの対応する定義を示します。  
+  
+```vb  
+Public Interface IValueTypes  
+   Sub M1(d As System.DateTime)  
+   Sub M2(d As System.Guid)  
+   Sub M3(d As System.Decimal)  
+   Sub M4(d As System.Drawing.Color)  
+End Interface  
+  
+```  
+  
+```csharp  
+public interface IValueTypes {  
+   void M1(System.DateTime d);  
+   void M2(System.Guid d);  
+   void M3(System.Decimal d);  
+   void M4(System.Drawing.Color d);  
+}  
+```  
+  
+#### タイプ ライブラリの表現  
+  
+```  
+[…]  
+interface IValueTypes : IDispatch {  
+   HRESULT M1([in] DATE d);  
+   HRESULT M2([in] GUID d);  
+   HRESULT M3([in] DECIMAL d);  
+   HRESULT M4([in] OLE_COLOR d);  
+};  
+```  
+  
+## 参照  
+ [Blittable 型と非 Blittable 型](../../../docs/framework/interop/blittable-and-non-blittable-types.md)   
+ [コピーと固定](../../../docs/framework/interop/copying-and-pinning.md)   
+ [配列に対する既定のマーシャリング](../../../docs/framework/interop/default-marshaling-for-arrays.md)   
+ [オブジェクトに対する既定のマーシャリング](../../../docs/framework/interop/default-marshaling-for-objects.md)   
+ [文字列に対する既定のマーシャリング](../../../docs/framework/interop/default-marshaling-for-strings.md)
\ No newline at end of file
diff --git a/docs/framework/interop/default-marshaling-for-arrays.md b/docs/framework/interop/default-marshaling-for-arrays.md
new file mode 100644
index 00000000000..84ca22eeb4d
--- /dev/null
+++ b/docs/framework/interop/default-marshaling-for-arrays.md
@@ -0,0 +1,398 @@
+---
+title: "配列に対する既定のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "配列, 相互運用マーシャリング"
+  - "相互運用マーシャリング, 配列"
+ms.assetid: 8a3cca8b-dd94-4e3d-ad9a-9ee7590654bc
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 配列に対する既定のマーシャリング
+全体がマネージ コードから構成されるアプリケーションでは、共通言語ランタイムは配列型を In\/Out パラメーターとして渡します。  一方、相互運用マーシャラーは、既定では配列を In パラメーターとして渡します。  
+  
+ [固定による最適化](../../../docs/framework/interop/copying-and-pinning.md)を行う場合、blittable 型の配列は、同一アパートメント内のオブジェクトと対話するときには In\/Out パラメーターとして動作するように見えることがあります。  ただし、コンピューター間のプロキシを生成するときに使用するタイプ ライブラリに後からコードをエクスポートし、そのライブラリを使用してアパートメント間呼び出しをマーシャリングする場合は、その呼び出しの動作が本来の In パラメーターの動作に戻ることがあります。  
+  
+ 本質的に配列は複雑であり、マネージ配列とアンマネージ配列の違いによって、他の非 blittable 型以上の情報が確保されています。  ここでは、配列のマーシャリングに関して次の情報を示します。  
+  
+-   [マネージ配列](#cpcondefaultmarshalingforarraysanchor1)  
+  
+-   [アンマネージ配列](#cpcondefaultmarshalingforarraysanchor2)  
+  
+-   [.NET コードへの配列パラメーターの引き渡し](#cpcondefaultmarshalingforarraysanchor3)  
+  
+-   [COM への配列の引き渡し](#cpcondefaultmarshalingforarraysanchor4)  
+  
+<a name="cpcondefaultmarshalingforarraysanchor1"></a>   
+## マネージ配列  
+ さまざまなマネージ配列型がありますが、<xref:System.Array?displayProperty=fullName> クラスがすべての配列型の基本クラスです。  **System.Array** クラスには、配列のランク、長さ、および下限と上限を決定するプロパティと、配列に対するアクセス、並べ替え、検索、コピー、および作成を行うためのメソッドがあります。  
+  
+ これらの配列型は動的なので、基本クラス ライブラリでは対応する静的型が定義されていません。  要素の型とランクの各組み合わせを、別個の配列の型と考えると便利です。  したがって、整数の 1 次元配列の型は、倍精度浮動小数点型の 1 次元配列の型とは異なります。  同様に、整数の 2 次元配列は、整数の 1 次元配列とは異なります。  型を比較するときに、配列の上下限は考慮されません。  
+  
+ 特定の要素の型、ランク、および下限を持つ必要があるマネージ配列のすべてのインスタンスを次の表に示します。  
+  
+|マネージ配列型|要素の型|順位|下限|シグネチャの表記|  
+|-------------|----------|--------|--------|--------------|  
+|**ELEMENT\_TYPE\_ARRAY**|type で指定します。|rank で指定します。|オプションとして bounds で指定します。|*type* **\[** *n*,*m* **\]**|  
+|**ELEMENT\_TYPE\_CLASS**|Unknown|Unknown|Unknown|**System.Array**|  
+|**ELEMENT\_TYPE\_SZARRAY**|type で指定します。|1|0|*type* **\[** *n* **\]**|  
+  
+<a name="cpcondefaultmarshalingforarraysanchor2"></a>   
+## アンマネージ配列  
+ アンマネージ配列は、COM スタイルのセーフ配列か、または固定長または可変長の C スタイル配列です。  セーフ配列は、関連付けられている配列データの型、ランク、および上下限を共に伝達する自己記述型の配列です。  C スタイルの配列は、下限が 0 で固定され、型が指定されている 1 次元の配列です。  マーシャリング サービスは両方の配列型を制限付きでサポートします。  
+  
+<a name="cpcondefaultmarshalingforarraysanchor3"></a>   
+## .NET コードへの配列パラメーターの引き渡し  
+ C スタイルの配列とセーフ配列の両方を、セーフ配列または C スタイル配列として、アンマネージ コードから .NET コードに渡すことができます。  アンマネージ型の値とインポート後の型を次の表に示します。  
+  
+|アンマネージ型|インポート後の型|  
+|-------------|--------------|  
+|**SafeArray\(** *Type* **\)**|**ELEMENT\_TYPE\_SZARRAY** **\<** *ConvertedType* **\>**<br /><br /> ランク \= 1、下限 \= 0。  サイズは、マネージ シグネチャで指定されている場合にのみ判明します。  ランク \= 1 または下限 \= 0 ではないセーフ配列は、**SZARRAY** としてマーシャリングできません。|  
+|*Type*  **\[\]**|**ELEMENT\_TYPE\_SZARRAY** **\<** *ConvertedType* **\>**<br /><br /> ランク \= 1、下限 \= 0。  サイズは、マネージ シグネチャで指定されている場合にのみ判明します。|  
+  
+### セーフ配列  
+ セーフ配列をタイプ ライブラリから .NET アセンブリにインポートする場合、その配列は既知の型 \(**int** など\) の 1 次元配列に変換されます。  パラメーターに適用されるのと同じ型変換規則が、配列の要素にも適用されます。  たとえば、**BSTR** 型のセーフ配列は文字列のマネージ配列になり、バリアントのセーフ配列はオブジェクトのマネージ配列になります。  **SAFEARRAY** 要素型は、タイプ ライブラリから取り込まれ、<xref:System.Runtime.InteropServices.UnmanagedType> 列挙体の **SAFEARRAY** 値に保存されます。  
+  
+ セーフ配列のランクと下限はタイプ ライブラリからは特定できないため、ランクは 1 に等しく下限は 0 に等しいと想定されます。  ランクと下限は、[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) によって生成されるマネージ シグネチャで定義する必要があります。  実行時にメソッドに渡されるランクが異なる場合には、<xref:System.Runtime.InteropServices.SafeArrayRankMismatchException> がスローされます。  実行時に渡される配列の型が異なる場合には、<xref:System.Runtime.InteropServices.SafeArrayTypeMismatchException> がスローされます。  マネージ コードとアンマネージ コードに含まれるセーフ配列の例を次に示します。  
+  
+ **アンマネージ シグネチャ**  
+  
+```  
+HRESULT New1([in] SAFEARRAY( int ) ar);  
+HRESULT New2([in] SAFEARRAY( DATE ) ar);  
+HRESULT New3([in, out] SAFEARRAY( BSTR ) *ar);  
+```  
+  
+ **マネージ シグネチャ**  
+  
+```vb  
+Sub New1(<MarshalAs(UnmanagedType.SafeArray, SafeArraySubType:=VT_I4)> _  
+   ar() As Integer)  
+Sub New2(<MarshalAs(UnmanagedType.SafeArray, SafeArraySubType:=VT_DATE)> _   
+   ar() As DateTime)  
+Sub New3(ByRef <MarshalAs(UnmanagedType.SafeArray, SafeArraySubType:=VT_BSTR)> _   
+   ar() As String)  
+  
+```  
+  
+```csharp  
+void New1([MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VT_I4)] int[] ar) ;  
+void New2([MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VT_DATE)]   
+   DateTime[] ar);  
+void New3([MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VT_BSTR)]   
+   ref String[] ar);  
+```  
+  
+ Tlbimp.exe によって生成されたメソッド シグネチャが、**ELEMENT\_TYPE\_SZARRAY** 要素型の代わりに **ELEMENT\_TYPE\_ARRAY** 要素型を指定するように修正されている場合は、多次元のセーフ配列または下限がゼロではないセーフ配列をマネージ コードへとマーシャリングできます。  その代わりに、**\/sysarray** スイッチを指定して Tlbimp.exe を使用すると、すべての配列を <xref:System.Array?displayProperty=fullName> オブジェクトとしてインポートできます。  渡す配列が多次元配列であるとわかっている場合には、Tlbimp.exe によって生成された Microsoft Intermediate Language \(MSIL\) コードを編集してから再コンパイルできます。  MSIL コードの修正方法については、「[ランタイム呼び出し可能ラッパーのカスタマイズ](http://msdn.microsoft.com/ja-jp/4652beaf-77d0-4f37-9687-ca193288c0be)」を参照してください。  
+  
+### C スタイルの配列  
+ C スタイルの配列をタイプ ライブラリから .NET アセンブリにインポートする場合、その配列は **ELEMENT\_TYPE\_SZARRAY** に変換されます。  
+  
+ 配列の要素型は、タイプ ライブラリから判断され、インポート時に維持されます。  パラメーターに適用されるのと同じ変換規則が配列の要素にも適用されます。  たとえば、**LPStr** 型の配列は **String** 型の配列になります。  Tlbimp.exe は配列の要素型を取り込み、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性をそのパラメーターに適用します。  
+  
+ 配列のランクは 1 に等しいと想定されます。  ランクが 1 よりも大きい場合、その配列は 1 次元配列として列優先でマーシャリングされます。  下限は常に 0 に等しくなります。  
+  
+ タイプ ライブラリには固定長または可変長の配列を含めることができます。  しかし、タイプ ライブラリには可変長の配列をマーシャリングするために必要な情報が不足しているため、Tlbimp.exe でインポートできるのは固定長の配列だけです。  固定長の配列の場合、サイズはタイプ ライブラリからインポートされて **MarshalAsAttribute** に取り込まれ、パラメーターに適用されます。  
+  
+ 可変長の配列を含むタイプ ライブラリは、次の例に示すように手動で定義する必要があります。  
+  
+ **アンマネージ シグネチャ**  
+  
+```  
+HRESULT New1(int ar[10]);  
+HRESULT New2(double ar[10][20]);  
+HRESULT New3(LPWStr ar[10]);  
+```  
+  
+ **マネージ シグネチャ**  
+  
+```vb  
+Sub New1(<MarshalAs(UnmanagedType.LPArray, SizeConst=10)> _  
+   ar() As Integer)  
+Sub New2(<MarshalAs(UnmanagedType.LPArray, SizeConst=200)> _  
+   ar() As Double)  
+Sub New2(<MarshalAs(UnmanagedType.LPArray, _  
+   ArraySubType=UnmanagedType.LPWStr, SizeConst=10)> _  
+   ar() As String)  
+  
+```  
+  
+```csharp  
+void New1([MarshalAs(UnmanagedType.LPArray, SizeConst=10)] int[] ar);  
+void New2([MarshalAs(UnmanagedType.LPArray, SizeConst=200)] double[] ar);  
+void New2([MarshalAs(UnmanagedType.LPArray,   
+   ArraySubType=UnmanagedType.LPWStr, SizeConst=10)] String[] ar);  
+```  
+  
+ インターフェイス定義言語 \(IDL: Interface Definition Language\) ソース内の配列に **size\_is** 属性または **length\_is** 属性を適用してサイズをクライアントに伝えることはできますが、MIDL \(Microsoft Interface Definition Language\) コンパイラはこの情報をタイプ ライブラリに反映しません。  サイズがわからない場合、相互運用マーシャリング サービスは配列の要素をマーシャリングできません。  その結果、可変長の配列は参照引数としてインポートされます。  次に例を示します。  
+  
+ **アンマネージ シグネチャ**  
+  
+```  
+HRESULT New1(int ar[]);  
+HRESULT New2(int ArSize, [size_is(ArSize)] double ar[]);  
+HRESULT New3(int ElemCnt, [length_is(ElemCnt)] LPStr ar[]);  
+```  
+  
+ **マネージ シグネチャ**  
+  
+```vb  
+Sub New1(ByRef ar As Integer)  
+Sub New2(ByRef ar As Double)  
+Sub New3(ByRef ar As String)  
+  
+```  
+  
+```csharp  
+void New1(ref int ar);    
+void New2(ref double ar);    
+void New3(ref String ar);   
+```  
+  
+ Tlbimp.exe によって生成された Microsoft intermediate language \(MSIL\) コードを編集し、そのコードを再コンパイルすると、マーシャラーに配列のサイズを提供できます。  MSIL コードの修正方法については、「[ランタイム呼び出し可能ラッパーのカスタマイズ](http://msdn.microsoft.com/ja-jp/4652beaf-77d0-4f37-9687-ca193288c0be)」を参照してください。  配列内の要素数を表示するには、次のいずれかの方法によって、マネージ メソッド定義内の配列パラメーターに <xref:System.Runtime.InteropServices.MarshalAsAttribute> 型を適用します。  
+  
+-   配列内の要素数を含む別のパラメーターを識別します。  パラメーターは位置によって識別されます。最初のパラメーターは 0 番です。  \[Visual Basic\]  
+  
+    ```vb  
+    Sub [New](ElemCnt As Integer, _  
+       <MarshalAs(UnmanagedType.LPArray, SizeParamIndex:=1)> _  
+       ar() As Integer)  
+  
+    ```  
+  
+    ```csharp  
+    void New(  
+       int ElemCnt,   
+       [MarshalAs(UnmanagedType.LPArray, SizeParamIndex=0)] int[] ar );  
+    ```  
+  
+-   配列のサイズを定数として定義します。  次に例を示します。  
+  
+    ```vb  
+    Sub [New](<MarshalAs(UnmanagedType.LPArray, SizeConst:=128)> _  
+       ar() As Integer)  
+  
+    ```  
+  
+    ```csharp  
+    void New(  
+       [MarshalAs(UnmanagedType.LPArray, SizeConst=128)] int[] ar );  
+    ```  
+  
+ アンマネージ コードからマネージ コードに配列をマーシャリングする場合、マーシャラーはパラメーターと関連付けられている **MarshalAsAttribute** をチェックして、配列のサイズを判断します。  配列のサイズが指定されていない場合は、1 つの要素だけがマーシャリングされます。  
+  
+> [!NOTE]
+>  **MarshalAsAttribute** は、アンマネージ コードへのマネージ配列のマーシャリングには影響しません。  この方向では、配列のサイズはその配列を調べることで判断できます。  マネージ配列のサブセットをマーシャリングする方法はありません。  
+  
+ 相互運用マーシャラーは **CoTaskMemAlloc** メソッドと **CoTaskMemFree** メソッドを使用して、メモリの割り当てと取得を行います。  アンマネージ コードがメモリを割り当てる場合にも、上のメソッドを使用する必要があります。  
+  
+<a name="cpcondefaultmarshalingforarraysanchor4"></a>   
+## COM への配列の引き渡し  
+ すべてのマネージ配列の型をマネージ コードからアンマネージ コードに渡すことができます。  次の表に示すように、配列には、マネージ型および適用される属性に応じて、セーフ配列または C スタイルの配列としてアクセスできます。  
+  
+|マネージ配列型|エクスポート後の配列|  
+|-------------|----------------|  
+|**ELEMENT\_TYPE\_SZARRAY** **\<** *type* **\>**|<xref:System.Runtime.InteropServices.UnmanagedType> **.SafeArray\(** *type* **\)**<br /><br /> **UnmanagedType.LPArray**<br /><br /> 型がシグネチャに設定されます。  ランクは常に 1 で、下限は常に 0 です。  サイズは常に実行時に判明します。|  
+|**ELEMENT\_TYPE\_ARRAY** **\<** *type* **\>** **\<** *rank* **\>**\[**\<** *bounds* **\>**\]|**UnmanagedType.SafeArray\(** *type* **\)**<br /><br /> **UnmanagedType.LPArray**<br /><br /> 型、ランク、上下限がシグネチャに設定されます。  サイズは常に実行時に判明します。|  
+|**ELEMENT\_TYPE\_CLASS** **\<**<xref:System.Array?displayProperty=fullName>**\>**|**UT\_Interface**<br /><br /> **UnmanagedType.SafeArray\(** *type* **\)**<br /><br /> 型、ランク、境界、およびサイズは常に実行時に判明します。|  
+  
+ LPSTR または LPWSTR を含む構造体の配列に関して、OLE オートメーションには制限があります。  そのため、**String** フィールドは **UnmanagedType.BSTR** としてマーシャリングする必要があります。  この操作を行わない場合、例外がスローされます。  
+  
+### ELEMENT\_TYPE\_SZARRAY  
+ **ELEMENT\_TYPE\_SZARRAY** パラメーター \(1 次元配列\) を含むメソッドを .NET アセンブリからタイプ ライブラリにエクスポートする場合、この配列パラメーターは特定の型の **SAFEARRAY** に変換されます。  同じ変換規則が配列の要素型にも適用されます。  マネージ配列の内容は、自動的にマネージ メモリから **SAFEARRAY** へとコピーされます。  次に例を示します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub [New](ar() As Long)  
+Sub [New](ar() As String)  
+  
+```  
+  
+```csharp  
+void New(long[] ar );  
+void New(String[] ar );  
+```  
+  
+#### アンマネージ シグネチャ  
+  
+```  
+HRESULT New([in] SAFEARRAY( long ) ar);   
+HRESULT New([in] SAFEARRAY( BSTR ) ar);  
+```  
+  
+ セーフ配列のランクは常に 1 で、下限は常に 0 です。  サイズは、渡されるマネージ配列のサイズによって実行時に決定されます。  
+  
+ また、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を使用すると、この配列を C スタイルの配列としてもマーシャリングできます。  次に例を示します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub [New](<MarshalAs(UnmanagedType.LPArray, SizeParamIndex:=1)> _  
+   ar() As Long, size as Integer)  
+Sub [New](<MarshalAs(UnmanagedType.LPArray, SizeParamIndex:=1)> _  
+   ar() As String, size as Integer)  
+Sub [New](<MarshalAs(UnmanagedType.LPArray, _  
+   ArraySubType= UnmanagedType.LPStr, SizeParamIndex:=1)> _  
+   ar() As String, size as Integer)  
+  
+```  
+  
+```csharp  
+void New([MarshalAs(UnmanagedType.LPArray, SizeParamIndex=1)]   
+   long [] ar, int size );  
+void New([MarshalAs(UnmanagedType.LPArray, SizeParamIndex=1)]   
+   String [] ar, int size );  
+void New([MarshalAs(UnmanagedType.LPArray, ArraySubType=   
+   UnmanagedType.LPStr, SizeParamIndex=1)]   
+   String [] ar, int size );  
+```  
+  
+#### アンマネージ シグネチャ  
+  
+```  
+HRESULT New(long ar[]);   
+HRESULT New(BSTR ar[]);   
+HRESULT New(LPStr ar[]);  
+```  
+  
+ マーシャラーは配列をマーシャリングするために必要な長さ情報を保持しますが、通常は、配列の長さは、呼び出し先に長さを伝えるために個別の引数として渡されます。  
+  
+### ELEMENT\_TYPE\_ARRAY  
+ **ELEMENT\_TYPE\_ARRAY** パラメーターを含むメソッドを .NET アセンブリからタイプ ライブラリにエクスポートする場合、その配列パラメーターは特定の型の **SAFEARRAY** に変換されます。  マネージ配列の内容は、自動的にマネージ メモリから **SAFEARRAY** へとコピーされます。  次に例を示します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub [New](ar(,) As Long)  
+Sub [New](ar(,) As String)  
+  
+```  
+  
+```csharp  
+void New( long [,] ar );  
+void New( String [,] ar );  
+```  
+  
+#### アンマネージ シグネチャ  
+  
+```  
+HRESULT New([in] SAFEARRAY( long ) ar);   
+HRESULT New([in] SAFEARRAY( BSTR ) ar);  
+```  
+  
+ セーフ配列のランク、サイズ、および上下限は、マネージ配列の特徴によって実行時に決定されます。  
+  
+ また、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を適用すると、この配列を C スタイルの配列としてもマーシャリングできます。  次に例を示します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub [New](<MarshalAs(UnmanagedType.LPARRAY, SizeParamIndex:=1)> _  
+   ar(,) As Long, size As Integer)  
+Sub [New](<MarshalAs(UnmanagedType.LPARRAY, _  
+   ArraySubType:=UnmanagedType.LPStr, SizeParamIndex:=1)> _  
+   ar(,) As String, size As Integer)  
+  
+```  
+  
+```csharp  
+void New([MarshalAs(UnmanagedType.LPARRAY, SizeParamIndex=1)]   
+   long [,] ar, int size );  
+void New([MarshalAs(UnmanagedType.LPARRAY,   
+   ArraySubType= UnmanagedType.LPStr, SizeParamIndex=1)]   
+   String [,] ar, int size );  
+```  
+  
+#### アンマネージ シグネチャ  
+  
+```  
+HRESULT New(long ar[]);   
+HRESULT New(LPStr ar[]);  
+```  
+  
+ 入れ子の配列はマーシャリングできません。  たとえば、次のシグネチャを[タイプ ライブラリ エクスポーター \(Tlbexp.exe\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md) によってエクスポートするとエラーが発生します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub [New](ar()()() As Long)  
+  
+```  
+  
+```csharp  
+void New(long [][][] ar );  
+```  
+  
+### ELEMENT\_TYPE\_CLASS \<System.Array\>  
+ <xref:System.Array?displayProperty=fullName> パラメーターを含むメソッドを .NET アセンブリからタイプ ライブラリにエクスポートする場合、この配列パラメーターは **\_Array** インターフェイスに変換されます。  このマネージ配列の内容には、**\_Array** インターフェイスのメソッドとプロパティを通じてだけアクセスできます。  また、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を使用すると、**System.Array** を **SAFEARRAY** としてもマーシャリングできます。  セーフ配列としてマーシャリングした場合、配列の要素はバリアントとしてマーシャリングされます。  次に例を示します。  
+  
+#### マネージ シグネチャ  
+  
+```vb  
+Sub New1( ar As System.Array )  
+Sub New2( <MarshalAs(UnmanagedType.Safe array)> ar As System.Array )  
+  
+```  
+  
+```csharp  
+void New1( System.Array ar );  
+void New2( [MarshalAs(UnmanagedType.Safe array)] System.Array ar );  
+```  
+  
+#### アンマネージ シグネチャ  
+  
+```  
+HRESULT New([in] _Array *ar);   
+HRESULT New([in] SAFEARRAY(VARIANT) ar);  
+```  
+  
+### 構造体の中の配列  
+ アンマネージ構造体には配列を埋め込むことができます。  既定では、埋め込まれた配列フィールドは、SAFEARRAY としてマーシャリングされます。  次の例では、`s1` が構造体の中に直接割り当てられている配列です。  
+  
+#### アンマネージ表現  
+  
+```  
+struct MyStruct {  
+    short s1[128];  
+}  
+```  
+  
+ 配列を [UnmanagedType.ByValArray](frlrfSystemRuntimeInteropServicesUnmanagedTypeClassTopic) としてマーシャリングできますが、そのためには [MarshalAsAttribute.SizeConst](frlrfSystemRuntimeInteropServicesMarshalAsAttributeClassTopic) フィールドを設定する必要があります。  サイズは定数としてだけ設定できます。  次のコードでは、 `MyStruct` に対応するマネージ定義を示しています。  
+  
+```vb  
+Public Structure <StructLayout(LayoutKind.Sequential)> MyStruct  
+   Public <MarshalAs(UnmanagedType.ByValArray, SizeConst := 128)> _  
+     s1() As Short  
+End Structure  
+  
+```  
+  
+```csharp  
+[StructLayout(LayoutKind.Sequential)]  
+public struct MyStruct {  
+   [MarshalAs(UnmanagedType.ByValArray, SizeConst=128)] public short[] s1;  
+}  
+```  
+  
+## 参照  
+ [既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)   
+ [Blittable 型と非 Blittable 型](../../../docs/framework/interop/blittable-and-non-blittable-types.md)   
+ [Directional Attributes](http://msdn.microsoft.com/ja-jp/241ac5b5-928e-4969-8f58-1dbc048f9ea2)   
+ [コピーと固定](../../../docs/framework/interop/copying-and-pinning.md)
\ No newline at end of file
diff --git a/docs/framework/interop/default-marshaling-for-objects.md b/docs/framework/interop/default-marshaling-for-objects.md
new file mode 100644
index 00000000000..9e7618cf141
--- /dev/null
+++ b/docs/framework/interop/default-marshaling-for-objects.md
@@ -0,0 +1,348 @@
+---
+title: "オブジェクトに対する既定のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用マーシャリング, オブジェクト"
+  - "オブジェクト, 相互運用マーシャリング"
+ms.assetid: c2ef0284-b061-4e12-b6d3-6a502b9cc558
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# オブジェクトに対する既定のマーシャリング
+<xref:System.Object?displayProperty=fullName> 型として指定されているパラメーターおよびフィールドを、次のいずれかの型としてアンマネージ コードに公開できます。  
+  
+-   そのオブジェクトがパラメーターの場合にはバリアント。  
+  
+-   そのオブジェクトが構造体フィールドの場合にはインターフェイス。  
+  
+ COM 相互運用機能だけがオブジェクト型のマーシャリングをサポートします。  既定の動作では、オブジェクトは COM バリアントへとマーシャリングされます。  これらの規則は **Object** 型だけに適用され、**Object** クラスから派生した、厳密に型指定されたオブジェクトには適用されません。  
+  
+ ここでは、オブジェクト型のマーシャリングに関する追加情報を示します。  
+  
+-   [マーシャリング オプション](#cpcondefaultmarshalingforobjectsanchor7)  
+  
+-   [インターフェイスへのオブジェクトのマーシャリング](#cpcondefaultmarshalingforobjectsanchor2)  
+  
+-   [バリアントへのオブジェクトのマーシャリング](#cpcondefaultmarshalingforobjectsanchor3)  
+  
+-   [オブジェクトへのバリアントのマーシャリング](#cpcondefaultmarshalingforobjectsanchor4)  
+  
+-   [ByRef バリアントのマーシャリング](#cpcondefaultmarshalingforobjectsanchor6)  
+  
+<a name="cpcondefaultmarshalingforobjectsanchor7"></a>   
+## マーシャリング オプション  
+ **Object** データ型に対するマーシャリング オプションを次の表に示します。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は、オブジェクトをマーシャリングするための <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値をいくつか提供します。  
+  
+|列挙型|アンマネージ表現の説明|  
+|---------|-----------------|  
+|**UnmanagedType.Struct**<br /><br /> \(パラメーターの既定値\)|COM スタイルのバリアント。|  
+|**UnmanagedType.Interface**|可能な場合は **IDispatch** インターフェイス。それ以外の場合は **IUnknown** インターフェイス。|  
+|**UnmanagedType.IUnknown**<br /><br /> \(フィールドの既定値\)|**IUnknown** インターフェイス。|  
+|**UnmanagedType.IDispatch**|**IDispatch** インターフェイス。|  
+  
+ `MarshalObject` のマネージ インターフェイス定義を次の例に示します。  
+  
+```vb  
+Interface MarshalObject  
+   Sub SetVariant(o As Object)  
+   Sub SetVariantRef(ByRef o As Object)  
+   Function GetVariant() As Object  
+  
+   Sub SetIDispatch( <MarshalAs(UnmanagedType.IDispatch)> o As Object)  
+   Sub SetIDispatchRef(ByRef <MarshalAs(UnmanagedType.IDispatch)> o _  
+      As Object)  
+   Function GetIDispatch() As <MarshalAs(UnmanagedType.IDispatch)> Object  
+   Sub SetIUnknown( <MarshalAs(UnmanagedType.IUnknown)> o As Object)  
+   Sub SetIUnknownRef(ByRef <MarshalAs(UnmanagedType.IUnknown)> o _  
+      As Object)  
+   Function GetIUnknown() As <MarshalAs(UnmanagedType.IUnknown)> Object  
+End Interface  
+  
+```  
+  
+```csharp  
+interface MarshalObject {  
+   void SetVariant(Object o);  
+   void SetVariantRef(ref Object o);  
+   Object GetVariant();  
+  
+   void SetIDispatch ([MarshalAs(UnmanagedType.IDispatch)]Object o);  
+   void SetIDispatchRef([MarshalAs(UnmanagedType.IDispatch)]ref Object o);  
+   [MarshalAs(UnmanagedType.IDispatch)] Object GetIDispatch();  
+   void SetIUnknown ([MarshalAs(UnmanagedType.IUnknown)]Object o);  
+   void SetIUnknownRef([MarshalAs(UnmanagedType.IUnknown)]ref Object o);  
+   [MarshalAs(UnmanagedType.IUnknown)] Object GetIUnknown();  
+}  
+```  
+  
+ `MarshalObject` インターフェイスをタイプ ライブラリにエクスポートするコード例を次に示します。  
+  
+```  
+interface MarshalObject {  
+   HRESULT SetVariant([in] VARIANT o);  
+   HRESULT SetVariantRef([in,out] VARIANT *o);  
+   HRESULT GetVariant([out,retval] VARIANT *o)   
+   HRESULT SetIDispatch([in] IDispatch *o);  
+   HRESULT SetIDispatchRef([in,out] IDispatch **o);  
+   HRESULT GetIDispatch([out,retval] IDispatch **o)   
+   HRESULT SetIUnknown([in] IUnknown *o);  
+   HRESULT SetIUnknownRef([in,out] IUnknown **o);  
+   HRESULT GetIUnknown([out,retval] IUnknown **o)   
+}  
+```  
+  
+> [!NOTE]
+>  相互運用マーシャラーは、バリアント内に割り当てられたオブジェクトがある場合は、呼び出しの後で自動的にそのオブジェクトを解放します。  
+  
+ 書式指定された値型を次の例に示します。  
+  
+```vb  
+Public Structure ObjectHolder  
+   Dim o1 As Object  
+   <MarshalAs(UnmanagedType.IDispatch)> Public o2 As Object  
+End Structure  
+  
+```  
+  
+```csharp  
+public struct ObjectHolder {  
+   Object o1;  
+   [MarshalAs(UnmanagedType.IDispatch)]public Object o2;  
+}  
+```  
+  
+ 書式指定された型をタイプ ライブラリにエクスポートするコード例を次に示します。  
+  
+```  
+struct ObjectHolder {  
+   VARIANT o1;  
+   IDispatch *o2;  
+}  
+```  
+  
+<a name="cpcondefaultmarshalingforobjectsanchor2"></a>   
+## インターフェイスへのオブジェクトのマーシャリング  
+ オブジェクトをインターフェイスとして COM に公開する場合、そのインターフェイスはマネージ型 <xref:System.Object> 用のクラス インターフェイス \(**\_Object** インターフェイス\) です。  このインターフェイスは、結果のタイプ ライブラリでは、**IDispatch** \([UnmanagedType.IDispatch](frlrfSystemRuntimeInteropServicesUnmanagedTypeClassTopic)\) 型または **IUnknown** \(**UnmanagedType.IUnknown**\) 型として指定されます。  COM クライアントは、マネージ クラスのメンバー、または派生クラスによって実装されるメンバーを **\_Object** インターフェイス経由で動的に呼び出すことができます。  クライアントは **QueryInterface** を呼び出して、マネージ型によって明示的に実装された他の任意のインターフェイスも取得できます。  
+  
+<a name="cpcondefaultmarshalingforobjectsanchor3"></a>   
+## バリアントへのオブジェクトのマーシャリング  
+ オブジェクトをバリアントへとマーシャリングする場合、内部バリアント型は次の規則に従って実行時に決定されます。  
+  
+-   オブジェクト参照が null \(Visual Basic では **Nothing**\) の場合、オブジェクトは **VT\_EMPTY** 型のバリアントへとマーシャリングされます。  
+  
+-   オブジェクトが、次の表に列挙されるいずれかの型のインスタンスである場合、結果として生成されるバリアント型は、表内に示されている、マーシャラーに組み込みの規則によって決定されます。  
+  
+-   マーシャリングの動作を明示的に制御する必要があるその他のオブジェクトは、<xref:System.IConvertible> インターフェイスを実装できます。  その場合、バリアントの型は <xref:System.IConvertible.GetTypeCode%2A?displayProperty=fullName> メソッドから返される型コードによって決定されます。  それ以外の場合、オブジェクトは **VT\_UNKNOWN** 型のバリアントとしてマーシャリングされます。  
+  
+### バリアントへのシステム型のマーシャリング  
+ マネージ オブジェクト型、および対応する COM バリアント型を次の表に示します。  これらの型は、呼び出されるメソッドのシグネチャが <xref:System.Object?displayProperty=fullName> 型の場合に限って変換されます。  
+  
+|オブジェクト型|COM バリアント型|  
+|-------------|----------------|  
+|null オブジェクト参照 \(Visual Basic では **Nothing**\)。|**VT\_EMPTY**|  
+|<xref:System.DBNull?displayProperty=fullName>|**VT\_NULL**|  
+|<xref:System.Runtime.InteropServices.ErrorWrapper?displayProperty=fullName>|**VT\_ERROR**|  
+|<xref:System.Reflection.Missing?displayProperty=fullName>|**VT\_ERROR** と **E\_PARAMNOTFOUND**|  
+|<xref:System.Runtime.InteropServices.DispatchWrapper?displayProperty=fullName>|**VT\_DISPATCH**|  
+|<xref:System.Runtime.InteropServices.UnknownWrapper?displayProperty=fullName>|**VT\_UNKNOWN**|  
+|<xref:System.Runtime.InteropServices.CurrencyWrapper?displayProperty=fullName>|**VT\_CY**|  
+|<xref:System.Boolean?displayProperty=fullName>|**VT\_BOOL**|  
+|<xref:System.SByte?displayProperty=fullName>|**VT\_I1**|  
+|<xref:System.Byte?displayProperty=fullName>|**VT\_UI1**|  
+|<xref:System.Int16?displayProperty=fullName>|**VT\_I2**|  
+|<xref:System.UInt16?displayProperty=fullName>|**VT\_UI2**|  
+|<xref:System.Int32?displayProperty=fullName>|**VT\_I4**|  
+|<xref:System.UInt32?displayProperty=fullName>|**VT\_UI4**|  
+|<xref:System.Int64?displayProperty=fullName>|**VT\_I8**|  
+|<xref:System.UInt64?displayProperty=fullName>|**VT\_UI8**|  
+|<xref:System.Single?displayProperty=fullName>|**VT\_R4**|  
+|<xref:System.Double?displayProperty=fullName>|**VT\_R8**|  
+|<xref:System.Decimal?displayProperty=fullName>|**VT\_DECIMAL**|  
+|<xref:System.DateTime?displayProperty=fullName>|**VT\_DATE**|  
+|<xref:System.String?displayProperty=fullName>|**VT\_BSTR**|  
+|<xref:System.IntPtr?displayProperty=fullName>|**VT\_INT**|  
+|<xref:System.UIntPtr?displayProperty=fullName>|**VT\_UINT**|  
+|<xref:System.Array?displayProperty=fullName>|**VT\_ARRAY**|  
+  
+ 上の例で定義した `MarshalObject` インターフェイスを使用して、次のコード例では各種の型のバリアントを COM サーバーに渡す方法を示します。  
+  
+```vb  
+Dim mo As New MarshalObject()  
+mo.SetVariant(Nothing)         ' Marshal as variant of type VT_EMPTY.  
+mo.SetVariant(System.DBNull.Value) ' Marshal as variant of type VT_NULL.  
+mo.SetVariant(CInt(27))        ' Marshal as variant of type VT_I2.  
+mo.SetVariant(CLng(27))        ' Marshal as variant of type VT_I4.  
+mo.SetVariant(CSng(27.0))      ' Marshal as variant of type VT_R4.  
+mo.SetVariant(CDbl(27.0))      ' Marshal as variant of type VT_R8.  
+  
+```  
+  
+```csharp  
+MarshalObject mo = new MarshalObject();  
+mo.SetVariant(null);            // Marshal as variant of type VT_EMPTY.  
+mo.SetVariant(System.DBNull.Value); // Marshal as variant of type VT_NULL.  
+mo.SetVariant((int)27);          // Marshal as variant of type VT_I2.  
+mo.SetVariant((long)27);          // Marshal as variant of type VT_I4.  
+mo.SetVariant((single)27.0);   // Marshal as variant of type VT_R4.  
+mo.SetVariant((double)27.0);   // Marshal as variant of type VT_R8.  
+```  
+  
+ <xref:System.Runtime.InteropServices.ErrorWrapper>、<xref:System.Runtime.InteropServices.DispatchWrapper>、<xref:System.Runtime.InteropServices.UnknownWrapper>、<xref:System.Runtime.InteropServices.CurrencyWrapper> などのラッパー クラスを使用すると、対応するマネージ型を持たない COM 型をマーシャリングできます。  これらのラッパーを使用して各種の型のバリアントを COM サーバーに渡す方法を次のコード例に示します。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+' Pass inew as a variant of type VT_UNKNOWN interface.  
+mo.SetVariant(New UnknownWrapper(inew))  
+' Pass inew as a variant of type VT_DISPATCH interface.  
+mo.SetVariant(New DispatchWrapper(inew))  
+' Pass a value as a variant of type VT_ERROR interface.  
+mo.SetVariant(New ErrorWrapper(&H80054002))  
+' Pass a value as a variant of type VT_CURRENCY interface.  
+mo.SetVariant(New CurrencyWrapper(New Decimal(5.25)))  
+  
+```  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+// Pass inew as a variant of type VT_UNKNOWN interface.  
+mo.SetVariant(new UnknownWrapper(inew));  
+// Pass inew as a variant of type VT_DISPATCH interface.  
+mo.SetVariant(new DispatchWrapper(inew));  
+// Pass a value as a variant of type VT_ERROR interface.  
+mo.SetVariant(new ErrorWrapper(0x80054002));  
+// Pass a value as a variant of type VT_CURRENCY interface.  
+mo.SetVariant(new CurrencyWrapper(new Decimal(5.25)));  
+```  
+  
+ ラッパー クラスは、<xref:System.Runtime.InteropServices> 名前空間で定義されます。  
+  
+### バリアントへの IConvertible インターフェイスのマーシャリング  
+ 上のセクションで列挙した以外の型は、<xref:System.IConvertible> インターフェイスを実装することにより、型のマーシャリング方法を制御できます。  オブジェクトが **IConvertible** インターフェイスを実装する場合、その COM バリアント型は <xref:System.IConvertible.GetTypeCode%2A?displayProperty=fullName> メソッドから返された <xref:System.TypeCode> 列挙体の値によって実行時に決定されます。  
+  
+ **TypeCode** 列挙体に対して有効な値、およびそれぞれの値に対応する COM バリアント型を次の表に示します。  
+  
+|TypeCode|COM バリアント型|  
+|--------------|----------------|  
+|**TypeCode.Empty**|**VT\_EMPTY**|  
+|**TypeCode.Object**|**VT\_UNKNOWN**|  
+|**TypeCode.DBNull**|**VT\_NULL**|  
+|**TypeCode.Boolean**|**VT\_BOOL**|  
+|**TypeCode.Char**|**VT\_UI2**|  
+|**TypeCode.Sbyte**|**VT\_I1**|  
+|**TypeCode.Byte**|**VT\_UI1**|  
+|**TypeCode.Int16**|**VT\_I2**|  
+|**TypeCode.UInt16**|**VT\_UI2**|  
+|**TypeCode.Int32**|**VT\_I4**|  
+|**TypeCode.UInt32**|**VT\_UI4**|  
+|**TypeCode.Int64**|**VT\_I8**|  
+|**TypeCode.UInt64**|**VT\_UI8**|  
+|**TypeCode.Single**|**VT\_R4**|  
+|**TypeCode.Double**|**VT\_R8**|  
+|**TypeCode.Decimal**|**VT\_DECIMAL**|  
+|**TypeCode.DateTime**|**VT\_DATE**|  
+|**TypeCode.String**|**VT\_BSTR**|  
+|サポートされていません。|**VT\_INT**|  
+|サポートされていません。|**VT\_UINT**|  
+|サポートされていません。|**VT\_ARRAY**|  
+|サポートされていません。|**VT\_RECORD**|  
+|サポートされていません。|**VT\_CY**|  
+|サポートされていません。|**VT\_VARIANT**|  
+  
+ COM バリアントの値は、**IConvertible.To** *Type* インターフェイスを呼び出すことで判断されます。**To** *Type* は、**IConvertible.GetTypeCode** から返された型に対応する変換ルーチンです。  たとえば、**IConvertible.GetTypeCode** から **TypeCode.Double** を返すオブジェクトは、**VT\_R8** 型の COM バリアントとしてマーシャリングされます。  バリアントの値は、**IConvertible** インターフェイスにキャストし、<xref:System.IConvertible.ToDouble%2A> メソッドを呼び出すことで取得でき、その COM バリアントの **dblVal** フィールド内に格納されます。  
+  
+<a name="cpcondefaultmarshalingforobjectsanchor4"></a>   
+## オブジェクトへのバリアントのマーシャリング  
+ バリアントをオブジェクトへとマーシャリングする場合、マーシャリングされるバリアントの型、および場合によっては値が、生成されるオブジェクトの型を決定します。  各バリアント型、および対応するオブジェクト型を次の表に示します。オブジェクト型はバリアントが COM から .NET Framework に渡されるときにマーシャラーによって作成されます。  
+  
+|COM バリアント型|オブジェクト型|  
+|----------------|-------------|  
+|**VT\_EMPTY**|null オブジェクト参照 \(Visual Basic では **Nothing**\)。|  
+|**VT\_NULL**|<xref:System.DBNull?displayProperty=fullName>|  
+|**VT\_DISPATCH**|**System.\_\_ComObject** または \(pdispVal \=\= null\) の場合は null。|  
+|**VT\_UNKNOWN**|**System.\_\_ComObject** または \(punkVal \=\= null\) の場合は null。|  
+|**VT\_ERROR**|<xref:System.UInt32?displayProperty=fullName>|  
+|**VT\_BOOL**|<xref:System.Boolean?displayProperty=fullName>|  
+|**VT\_I1**|<xref:System.SByte?displayProperty=fullName>|  
+|**VT\_UI1**|<xref:System.Byte?displayProperty=fullName>|  
+|**VT\_I2**|<xref:System.Int16?displayProperty=fullName>|  
+|**VT\_UI2**|<xref:System.UInt16?displayProperty=fullName>|  
+|**VT\_I4**|<xref:System.Int32?displayProperty=fullName>|  
+|**VT\_UI4**|<xref:System.UInt32?displayProperty=fullName>|  
+|**VT\_I8**|<xref:System.Int64?displayProperty=fullName>|  
+|**VT\_UI8**|<xref:System.UInt64?displayProperty=fullName>|  
+|**VT\_R4**|<xref:System.Single?displayProperty=fullName>|  
+|**VT\_R8**|<xref:System.Double?displayProperty=fullName>|  
+|**VT\_DECIMAL**|<xref:System.Decimal?displayProperty=fullName>|  
+|**VT\_DATE**|<xref:System.DateTime?displayProperty=fullName>|  
+|**VT\_BSTR**|<xref:System.String?displayProperty=fullName>|  
+|**VT\_INT**|<xref:System.Int32?displayProperty=fullName>|  
+|**VT\_UINT**|<xref:System.UInt32?displayProperty=fullName>|  
+|**VT\_ARRAY** &#124; **VT\_\***|<xref:System.Array?displayProperty=fullName>|  
+|**VT\_CY**|<xref:System.Decimal?displayProperty=fullName>|  
+|**VT\_RECORD**|対応するボックス化された値型。|  
+|**VT\_VARIANT**|サポートされていません。|  
+  
+ COM からマネージ コードに渡された後で COM に返されるバリアント型が、呼び出し中に同じバリアント型を維持しないことがあります。  **VT\_DISPATCH** 型のバリアントが COM から .NET Framework に渡されるときに、何が起こるのかを検討してみます。  マーシャリング時に、バリアントは <xref:System.Object?displayProperty=fullName> に変換されます。  次に **Object** が COM に返される場合には、**VT\_UNKNOWN** 型のバリアントにマーシャリングされます。  オブジェクトをマネージ コードから COM へとマーシャリングするときに、生成されるバリアントの型が、最初にオブジェクトを生成するときに使用したバリアントの型と同じになる保証はありません。  
+  
+<a name="cpcondefaultmarshalingforobjectsanchor6"></a>   
+## ByRef バリアントのマーシャリング  
+ バリアント自体を値渡しまたは参照渡しすることはできますが、**VT\_BYREF** フラグを任意のバリアント型と併用した場合は、そのバリアントの内容を値渡しではなく参照渡しすることを指定できます。  バリアントの参照渡しによるマーシャリングと、**VT\_BYREF** フラグの設定によるバリアントのマーシャリングとの違いは微妙です。  その違いを次の図で明確にします。  
+  
+ ![スタック上で渡されるバリアント](../../../docs/framework/interop/media/interopvariant.gif "interopvariant")  
+値渡しされるバリアントと参照渡しされるバリアント  
+  
+ **オブジェクトとバリアントを値渡しによってマーシャリングする場合の既定の動作**  
+  
+-   オブジェクトをマネージ コードから COM に渡す場合、そのオブジェクトの内容は、「[バリアントへのオブジェクトのマーシャリング](#cpcondefaultmarshalingforobjectsanchor3)」で定義される規則に従ってマーシャラーによって作成される新しいバリアントにコピーされます。  アンマネージ側でバリアントに対して行われた変更の内容は、呼び出しから制御が返されるときに、元のオブジェクトには反映されません。  
+  
+-   バリアントを COM からマネージ コードに渡す場合、そのバリアントの内容は、「[オブジェクトへのバリアントのマーシャリング](#cpcondefaultmarshalingforobjectsanchor4)」で定義される規則に従って新規作成されるオブジェクトにコピーされます。  マネージ側でオブジェクトに対して行われた変更の内容は、呼び出しから制御が返されるときに、元のバリアントには反映されません。  
+  
+ **オブジェクトとバリアントを参照渡しによってマーシャリングする場合の既定の動作**  
+  
+ 変更内容を呼び出し元にも反映させるためには、パラメーターを参照渡しする必要があります。  たとえば、C\# でキーワード **ref** \(Visual Basic マネージ コードの場合は **ByRef**\) を使用すると、パラメーターを参照渡しできます。  COM の場合は、参照パラメーターを渡すには、**variant \*** などのポインターを使用します。  
+  
+-   オブジェクトを COM に参照渡しする場合、マーシャラーは呼び出しを実行する前に新しいバリアントを作成し、オブジェクト参照の内容をそのバリアントにコピーします。  このバリアントはアンマネージ関数に渡されます。ここで、バリアントの内容を自由に変更できます。  呼び出しから制御が返されるときに、アンマネージ側でバリアントが変更されている場合には、その内容が元のオブジェクトに反映されます。  バリアントの型が、呼び出しに渡されたバリアントの型と異なる場合、変更内容は別の型を持つオブジェクトに反映されます。  つまり、呼び出しに渡したオブジェクトの型が、呼び出しから返されるオブジェクトの型と異なることがあります。  
+  
+-   バリアントをマネージ コードに参照渡しする場合、マーシャラーは呼び出しを実行する前に、新しいオブジェクトを作成し、バリアントの内容をそのオブジェクトにコピーします。  オブジェクトへの参照がマネージ関数に渡されます。ここで、オブジェクトを自由に変更できます。  呼び出しから制御が返されるときに、参照先オブジェクトが変更されている場合には、その内容が元のバリアントに反映されます。  オブジェクトの型が、呼び出しに渡されたオブジェクトの型と異なる場合、元のバリアントの型が変更され、値がそのバリアントに反映されます。  ここでも、呼び出しに渡されたバリアントの型が、呼び出しから返されるバリアントの型と異なることがあります。  
+  
+ **VT\_BYREF フラグの設定によるバリアントのマーシャリングの既定の動作**  
+  
+-   マネージ コードに参照渡しするバリアントには、**VT\_BYREF** フラグを設定することによって、そのバリアントが値ではなく参照を含むことを指定できます。  この場合でも、バリアントは値渡しされるため、バリアントは依然としてオブジェクトへとマーシャリングされます。  呼び出しを実行する前に、マーシャラーは自動的にバリアントの内容を逆参照し、その内容を新しく作成されるオブジェクトへとコピーします。  次に、そのオブジェクトがマネージ関数に渡されます。ただし、呼び出しから制御が返されるときに、このオブジェクトの内容は元のバリアントには反映されません。  マネージ オブジェクトに対する変更内容は失われます。  
+  
+    > [!CAUTION]
+    >  バリアントに **VT\_BYREF** フラグが設定されていても、そのバリアントが値渡しされた場合、その値を変更する方法はありません。  
+  
+-   マネージ コードに参照渡しするバリアントについても、**VT\_BYREF** フラグを設定することで、バリアントが別の参照を含むことを指定できます。  このようにすると、バリアントは参照渡しされるため、**ref** オブジェクトにマーシャリングされます。  呼び出しを実行する前に、マーシャラーは自動的にバリアントの内容を逆参照し、その内容を新しく作成されるオブジェクトへとコピーします。  呼び出しから制御が返されるときに、オブジェクトの値が元のバリアントに含まれる参照に反映されるのは、そのオブジェクトの型が呼び出しに渡されたオブジェクトの型と同じ場合に限られます。  つまり、反映によって **VT\_BYREF** フラグが設定されたバリアントの型が変更されることはありません。  呼び出しの間にオブジェクトの型が変更された場合、呼び出しから制御が返されるときに <xref:System.InvalidCastException> が発生します。  
+  
+ バリアントとオブジェクトに関する反映規則を次の表にまとめます。  
+  
+|変換前|目的|変更内容の反映|  
+|---------|--------|-------------|  
+|**Variant**  *v*|**Object**  *o*|なし|  
+|**Object**  *o*|**Variant**  *v*|なし|  
+|**Variant**   ***\****  *pv*|**Ref Object**  *o*|常時|  
+|**Ref object**  *o*|**Variant**   ***\****  *pv*|常時|  
+|**Variant**  *v* **\(VT\_BYREF** *&#124;*  **VT\_\*\)**|**Object**  *o*|なし|  
+|**Variant**  *v* **\(VT\_BYREF** *&#124;*  **VT\_\)**|**Ref Object**  *o*|型が変更されていない場合にだけ反映|  
+  
+## 参照  
+ [既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)   
+ [Blittable 型と非 Blittable 型](../../../docs/framework/interop/blittable-and-non-blittable-types.md)   
+ [Directional Attributes](http://msdn.microsoft.com/ja-jp/241ac5b5-928e-4969-8f58-1dbc048f9ea2)   
+ [コピーと固定](../../../docs/framework/interop/copying-and-pinning.md)
\ No newline at end of file
diff --git a/docs/framework/interop/default-marshaling-for-strings.md b/docs/framework/interop/default-marshaling-for-strings.md
new file mode 100644
index 00000000000..fe05fbecf41
--- /dev/null
+++ b/docs/framework/interop/default-marshaling-for-strings.md
@@ -0,0 +1,278 @@
+---
+title: "文字列に対する既定のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用マーシャリング, 文字列"
+  - "文字列, 相互運用マーシャリング"
+ms.assetid: 9baea3ce-27b3-4b4f-af98-9ad0f9467e6f
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 文字列に対する既定のマーシャリング
+<xref:System.String?displayProperty=fullName> と <xref:System.Text.StringBuilder?displayProperty=fullName> クラスのマーシャリング動作は類似しています。  
+  
+ 文字列は、COM スタイル `BSTR` 型または null で終わる文字列 \(null 文字で終わる文字配列\) としてマーシャリングされます。  文字列内の文字は、Unicode \(Windows システムでの既定値\) または ANSI としてマーシャリングすることができます。  
+  
+ このトピックでは、文字列型のマーシャリングに関する以下の情報を示します。  
+  
+-   [インターフェイスで使用される文字列](#cpcondefaultmarshalingforstringsanchor1)  
+  
+-   [プラットフォーム呼び出しで使用される文字列](#cpcondefaultmarshalingforstringsanchor5)  
+  
+-   [構造体で使用される文字列](#cpcondefaultmarshalingforstringsanchor2)  
+  
+-   [固定長文字列バッファー](#cpcondefaultmarshalingforstringsanchor3)  
+  
+<a name="cpcondefaultmarshalingforstringsanchor1"></a>   
+## インターフェイスで使用される文字列  
+ 次の表は、アンマネージ コードへのメソッド引数としてマーシャリングするときの、文字列データ型のマーシャリングのオプションを示しています。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は、COM インターフェイスへの文字列をマーシャリングする <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値を提供します。  
+  
+|列挙型|アンマネージ形式の説明|  
+|---------|-----------------|  
+|`UnmanagedType.BStr` \(既定値\)|長さと Unicode 文字がプレフィックスされた COM スタイル `BSTR`。|  
+|`UnmanagedType.LPStr`|ANSI 文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.LPWStr`|Unicode 文字の null で終わる配列へのポインター。|  
+  
+ この表は文字列に適用されます。  ただし、<xref:System.Text.StringBuilder> の場合、許可される唯一のオプションは `UnmanagedType.LPStr` と `UnmanagedType.LPWStr`です。  
+  
+ 以下の例では、`IStringWorker` インターフェイスで宣言された文字列を示します。  
+  
+```cpp  
+public interface IStringWorker {  
+void PassString1(String s);  
+void PassString2([MarshalAs(UnmanagedType.BStr)]String s);  
+void PassString3([MarshalAs(UnmanagedType.LPStr)]String s);  
+void PassString4([MarshalAs(UnmanagedType.LPWStr)]String s);  
+void PassStringRef1(ref String s);  
+void PassStringRef2([MarshalAs(UnmanagedType.BStr)]ref String s);  
+void PassStringRef3([MarshalAs(UnmanagedType.LPStr)]ref String s);  
+void PassStringRef4([MarshalAs(UnmanagedType.LPWStr)]ref String s);  
+);  
+```  
+  
+ 以下の例では、タイプ ライブラリに記述された対応するインターフェイスを示します。  
+  
+```  
+[…]  
+interface IStringWorker : IDispatch {  
+HRESULT PassString1([in] BSTR s);  
+HRESULT PassString2([in] BSTR s);  
+HRESULT PassString3([in] LPStr s);  
+HRESULT PassString4([in] LPWStr s);  
+HRESULT PassStringRef1([in, out] BSTR *s);  
+HRESULT PassStringRef2([in, out] BSTR *s);  
+HRESULT PassStringRef3([in, out] LPStr *s);  
+HRESULT PassStringRef4([in, out] LPWStr *s);  
+);  
+```  
+  
+<a name="cpcondefaultmarshalingforstringsanchor5"></a>   
+## プラットフォーム呼び出しで使用される文字列  
+ プラットフォーム呼び出しは、文字列の引数を、.NET Framework 形式 \(Unicode\) から、プラットフォーム アンマネージ形式に変換してコピーします。  文字列は不変であり、呼び出しが戻るときに、アンマネージ メモリから元のマネージ メモリにコピーされることはありません。  
+  
+ 次の表は、文字列をプラットフォーム呼び出しのメソッド引数としてマーシャリングする際のマーシャリング オプションをリストしています。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は、文字列をマーシャリングする <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値を提供します。  
+  
+|列挙型|アンマネージ形式の説明|  
+|---------|-----------------|  
+|`UnmanagedType.AnsiBStr`|長さと ANSI 文字がプレフィックスされた COM スタイル `BSTR`。|  
+|`UnmanagedType.BStr`|長さと Unicode 文字がプレフィックスされた COM スタイル `BSTR`。|  
+|`UnmanagedType.LPStr`|ANSI 文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.LPTStr` \(既定値\)|プラットフォーム依存文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.LPWStr`|Unicode 文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.TBStr`|長さとプラットフォーム依存文字がプレフィックスされた COM スタイル `BSTR`。|  
+|`VBByRefStr`|Visual Basic .NET で、アンマネージ コードの文字列を変更し、結果をマネージ コードに反映できるようにする値。  この値は、プラットフォーム呼び出しでだけサポートされます。|  
+  
+ この表は文字列に適用されます。  ただし、<xref:System.Text.StringBuilder> の場合、許可される唯一のオプションは `LPStr`、`LPTStr`、および `LPWStr` です。  
+  
+ 次の型定義は、プラットフォーム呼び出しで `MarshalAsAttribute` を使用するための正しい方法を示しています。  
+  
+```vb  
+Class StringLibAPI      
+Public Declare Auto Sub PassLPStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.LPStr)> s As String)      
+Public Declare Auto Sub PassLPWStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.LPWStr)> s As String)      
+Public Declare Auto Sub PassLPTStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.LPTStr)> s As String)      
+Public Declare Auto Sub PassBStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.BStr)> s As String)      
+Public Declare Auto Sub PassAnsiBStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.AnsiBStr)> s As String)      
+Public Declare Auto Sub PassTBStr Lib "StringLib.Dll" _  
+(<MarshalAs(UnmanagedType.TBStr)> s As String)  
+End Class  
+  
+```  
+  
+```csharp  
+class StringLibAPI {  
+[DllImport("StringLib.Dll")]  
+public static extern void PassLPStr([MarshalAs(UnmanagedType.LPStr)]  
+String s);  
+[DllImport("StringLib.Dll")]  
+public static extern void   
+PassLPWStr([MarshalAs(UnmanagedType.LPWStr)]String s);  
+[DllImport("StringLib.Dll")]  
+public static extern void   
+PassLPTStr([MarshalAs(UnmanagedType.LPTStr)]String s);  
+[DllImport("StringLib.Dll")]  
+public static extern void PassBStr([MarshalAs(UnmanagedType.BStr)]  
+String s);  
+[DllImport("StringLib.Dll")]  
+public static extern void   
+PassAnsiBStr([MarshalAs(UnmanagedType.AnsiBStr)]String s);  
+[DllImport("StringLib.Dll")]  
+public static extern void PassTBStr([MarshalAs(UnmanagedType.TBStr)]  
+String s);  
+}  
+```  
+  
+<a name="cpcondefaultmarshalingforstringsanchor2"></a>   
+## 構造体で使用される文字列  
+ 文字列は構造体の有効なメンバーです。ただし、<xref:System.Text.StringBuilder> バッファーは構造体では無効です。  次の表は、型をフィールドとしてマーシャリングするときの、文字列データ型のマーシャリングのオプションを示しています。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は、文字列をフィールドにマーシャリングする <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値を提供します。  
+  
+|列挙型|アンマネージ形式の説明|  
+|---------|-----------------|  
+|`UnmanagedType.BStr`|長さと Unicode 文字がプレフィックスされた COM スタイル `BSTR`。|  
+|`UnmanagedType.LPStr`|ANSI 文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.LPTStr`|プラットフォーム依存文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.LPWStr`|Unicode 文字の null で終わる配列へのポインター。|  
+|`UnmanagedType.ByValTStr`|固定長の文字配列。配列の型は、包含構造体の文字セットによって決まります。|  
+  
+ `ByValTStr` 型は、構造体に定義されているインライン固定長文字配列で使用します。  その他の型は、文字列へのポインターを含む構造体に含まれている文字列参照に適用されます。  
+  
+ 包含構造体に適用される <xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性の `CharSet` 引数によって、構造体内の文字列の文字形式が決まります。  以下の構造体の例には、文字列参照とインライン文字列、そして ANSI、Unicode、およびプラットフォーム依存文字が含まれています。  
+  
+### タイプ ライブラリの表現  
+  
+```  
+struct StringInfoA {  
+   char *    f1;  
+   char      f2[256];  
+};  
+struct StringInfoW {  
+   WCHAR *   f1;  
+   WCHAR     f2[256];  
+   BSTR      f3;  
+};  
+struct StringInfoT {  
+   TCHAR *   f1;  
+   TCHAR     f2[256];  
+};  
+```  
+  
+ 次のコード例は、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を使用して、同一の構造体を複数の異なる形式で定義する方法を示しています。  
+  
+```vb  
+<StructLayout(LayoutKind.Sequential, CharSet := CharSet.Ansi)> _  
+Structure StringInfoA  
+<MarshalAs(UnmanagedType.LPStr)> Public f1 As String  
+<MarshalAs(UnmanagedType.ByValTStr, SizeConst := 256)> _  
+Public f2 As String  
+End Structure  
+<StructLayout(LayoutKind.Sequential, CharSet := CharSet.Unicode)> _  
+Structure StringInfoW  
+<MarshalAs(UnmanagedType.LPWStr)> Public f1 As String  
+<MarshalAs(UnmanagedType.ByValTStr, SizeConst := 256)> _  
+Public f2 As String  
+<MarshalAs(UnmanagedType.BStr)> Public f3 As String  
+End Structure  
+<StructLayout(LayoutKind.Sequential, CharSet := CharSet.Auto)> _  
+Structure StringInfoT  
+<MarshalAs(UnmanagedType.LPTStr)> Public f1 As String  
+<MarshalAs(UnmanagedType.ByValTStr, SizeConst := 256)> _  
+Public f2 As String  
+End Structure  
+  
+```  
+  
+```csharp  
+[StructLayout(LayoutKind.Sequential, CharSet=CharSet.Ansi)]  
+struct StringInfoA {  
+   [MarshalAs(UnmanagedType.LPStr)] public String f1;  
+   [MarshalAs(UnmanagedType.ByValTStr, SizeConst=256)] public String f2;  
+}  
+[StructLayout(LayoutKind.Sequential, CharSet=CharSet.Unicode)]  
+struct StringInfoW {  
+   [MarshalAs(UnmanagedType.LPWStr)] public String f1;  
+   [MarshalAs(UnmanagedType.ByValTStr, SizeConst=256)] public String f2;  
+   [MarshalAs(UnmanagedType.BStr)] public String f3;  
+}  
+[StructLayout(LayoutKind.Sequential, CharSet=CharSet.Auto)]  
+struct StringInfoT {  
+   [MarshalAs(UnmanagedType.LPTStr)] public String f1;  
+   [MarshalAs(UnmanagedType.ByValTStr, SizeConst=256)] public String f2;  
+}  
+```  
+  
+<a name="cpcondefaultmarshalingforstringsanchor3"></a>   
+## 固定長文字列バッファー  
+ 状況によっては、固定長の文字列バッファーを、操作するためにアンマネージ コードに渡す必要があります。  この場合、呼び出し先は渡されたバッファーの内容を修正できないので、単に文字列を渡すだけでは不十分です。  文字列が参照によって渡された場合でも、バッファーを特定のサイズに初期化する方法はありません。  
+  
+ この解決策は、<xref:System.Text.StringBuilder> バッファーを文字列ではなく引数として渡すことです。  呼び出し先は、`StringBuilder` の容量を超えない範囲で、`StringBuilder` を逆参照したり変更したりすることができます。  また、固定長に初期化することもできます。  たとえば、`StringBuilder` バッファーを初期化してその容量を `N` にする場合、マーシャラーは \(`N`\+1\) 文字のサイズのバッファーを提供します。  \+1 は、アンマネージ文字列に null 終了文字があることをしめしています。`StringBuilder` にはそれがありません。  
+  
+ たとえば、Microsoft Win32 API `GetWindowText` \(Windows.h に定義されている\) 関数は、固定長の文字バッファーを操作するアンマネージ コードを渡す必要があります。  `LpString` は、呼び出し元が割り当てたサイズ `nMaxCount` のバッファーを示します。  呼び出し元は、バッファーを割り当てて、`nMaxCount` 引数を割り当てられたバッファーのサイズに設定することが期待されています。  次のコードは、Windows.h で定義されている `GetWindowText` 関数宣言を示しています。  
+  
+```  
+int GetWindowText(  
+HWND hWnd,        // Handle to window or control.  
+LPTStr lpString,  // Text buffer.  
+int nMaxCount     // Maximum number of characters to copy.  
+);  
+```  
+  
+ 呼び出し先は、`StringBuilder` の容量を超えない範囲で、`StringBuilder` を逆参照したり変更したりすることができます。  次のコード例は、`StringBuilder` を固定長に初期化する方法を示しています。  
+  
+```vb  
+Public Class Win32API  
+Public Declare Auto Sub GetWindowText Lib "User32.Dll" _  
+(h As Integer, s As StringBuilder, nMaxCount As Integer)  
+End Class  
+Public Class Window  
+   Friend h As Integer ' Friend handle to Window.  
+   Public Function GetText() As String  
+      Dim sb As New StringBuilder(256)  
+      Win32API.GetWindowText(h, sb, sb.Capacity + 1)  
+   Return sb.ToString()  
+   End Function  
+End Class  
+  
+```  
+  
+```csharp  
+public class Win32API {  
+[DllImport("User32.Dll")]  
+public static extern void GetWindowText(int h, StringBuilder s,   
+int nMaxCount);  
+}  
+public class Window {  
+   internal int h;        // Internal handle to Window.  
+   public String GetText() {  
+      StringBuilder sb = new StringBuilder(256);  
+      Win32API.GetWindowText(h, sb, sb.Capacity + 1);  
+   return sb.ToString();  
+   }  
+}  
+```  
+  
+## 参照  
+ [既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)   
+ [Blittable 型と非 Blittable 型](../../../docs/framework/interop/blittable-and-non-blittable-types.md)   
+ [Directional Attributes](http://msdn.microsoft.com/ja-jp/241ac5b5-928e-4969-8f58-1dbc048f9ea2)   
+ [コピーと固定](../../../docs/framework/interop/copying-and-pinning.md)
\ No newline at end of file
diff --git a/docs/framework/interop/deploying-an-interop-application.md b/docs/framework/interop/deploying-an-interop-application.md
new file mode 100644
index 00000000000..c3458c5835f
--- /dev/null
+++ b/docs/framework/interop/deploying-an-interop-application.md
@@ -0,0 +1,63 @@
+---
+title: "相互運用アプリケーションの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 配置 (アプリケーションを)"
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "配置 (アプリケーションを) [.NET Framework] , 相互運用"
+  - "公開 (.NET Framework に COM コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 配置 (アプリケーションを)"
+  - "相互運用 (アンマネージ コードとの), 公開 (COM コンポーネントを)"
+  - "プライベート アセンブリ"
+  - "共有アセンブリ"
+  - "署名されたアセンブリ"
+  - "厳密な名前を付けたアセンブリ, 相互運用アプリケーション"
+  - "署名のないアセンブリ"
+ms.assetid: ea8a403e-ae03-4faa-9d9b-02179ec72992
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 相互運用アプリケーションの配置
+通常、相互運用アプリケーションには、.NET クライアント アセンブリ、個別の COM タイプ ライブラリを表す 1 つ以上の相互運用機能アセンブリ、および 1 つ以上の登録済み COM コンポーネントが含まれています。  Visual Studio および [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] には、タイプ ライブラリを相互運用機能アセンブリにインポートしたり、変換したりするためのツールが用意されています。詳細については、「[タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)」を参照してください。  相互運用アプリケーションを配置する方法には、次の 2 つがあります。  
+  
+-   埋め込まれた相互運用機能型を使用する: [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、相互運用機能アセンブリから実行可能ファイルに型情報を埋め込むようにコンパイラに指示できます。  コンパイラは、アプリケーションが使用する型情報のみを埋め込みます。  アプリケーションで相互運用機能アセンブリを配置する必要はありません。  この手法を使用することをお勧めします。  
+  
+-   相互運用機能アセンブリを配置する: 相互運用機能アセンブリへの標準の参照を作成できます。  この場合、アプリケーションで相互運用機能アセンブリを配置する必要があります。  この手法を採用する場合に、プライベートの COM コンポーネントを使用しないときは、必ず、マネージ コードに組み込む COM コンポーネントの作成者が発行したプライマリ相互運用機能アセンブリ \(PIA\) を参照してください。  プライマリ相互運用機能アセンブリの作成と使用の詳細については、「[プライマリ相互運用機能アセンブリ](http://msdn.microsoft.com/ja-jp/b977a8be-59a0-40a0-a806-b11ffba5c080)」を参照してください。  
+  
+ 埋め込まれた相互運用機能型を使用すると、配置を簡単に行うことができます。  特別な操作を実行する必要はありません。  ここからは、アプリケーションで相互運用機能アセンブリを配置するシナリオについて説明します。  
+  
+## 相互運用機能アセンブリの配置  
+ アセンブリには、厳密な名前を付けることができます。  厳密な名前のアセンブリには、一意な識別子を提供する発行者の公開キーが含まれています。  発行者は、**\/keyfile** オプションを使用して、[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) で作成されたアセンブリに署名できます。  署名付きアセンブリは、グローバル アセンブリ キャッシュにインストールできます。  署名のないアセンブリは、プライベート アセンブリとしてユーザーのコンピューターにインストールする必要があります。  
+  
+### プライベート アセンブリ  
+ プライベートに使用するアセンブリをインストールするには、アプリケーションの実行可能ファイルと、インポートされた COM 型を格納している相互運用機能アセンブリの両方を同じディレクトリ構造にインストールする必要があります。  別個のアプリケーション ディレクトリに配置された Client1.exe および Client2.exe によってプライベートに使用される、署名のない相互運用機能アセンブリを次の図に示します。  この例で LOANLib.dll として示されている相互運用機能アセンブリは、2 回インストールされています。  
+  
+ ![ディレクトリ構造と Windows レジストリ](../../../docs/framework/interop/media/comdeployprivate.gif "comdeployprivate")  
+プライベートに配置する場合のディレクトリ構造とレジストリ エントリ  
+  
+ アプリケーションに関連付けられたすべての COM コンポーネントを、Windows のレジストリに登録する必要があります。  この図の Client1.exe と Client2.exe が別のコンピューターにインストールされている場合は、COM コンポーネントを両方のコンピューターに登録する必要があります。  
+  
+### 共有アセンブリ  
+ 複数のアプリケーションによって共有されるアセンブリは、グローバル アセンブリ キャッシュと呼ばれる集中化されたリポジトリにインストールする必要があります。  .NET クライアントは、署名され、グローバル アセンブリ キャッシュにインストールされた、相互運用機能アセンブリと同一のコピーにアクセスできます。  プライマリ相互運用機能アセンブリの作成と使用の詳細については、「[プライマリ相互運用機能アセンブリ](http://msdn.microsoft.com/ja-jp/b977a8be-59a0-40a0-a806-b11ffba5c080)」を参照してください。  
+  
+## 参照  
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)   
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)   
+ [Using COM Types in Managed Code](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)   
+ [相互運用プロジェクトのコンパイル](../../../docs/framework/interop/compiling-an-interop-project.md)
\ No newline at end of file
diff --git a/docs/framework/interop/exposing-com-components.md b/docs/framework/interop/exposing-com-components.md
new file mode 100644
index 00000000000..87a5114b4dd
--- /dev/null
+++ b/docs/framework/interop/exposing-com-components.md
@@ -0,0 +1,56 @@
+---
+title: ".NET Framework への COM コンポーネントの公開 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "公開 (.NET Framework に COM コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 公開 (COM コンポーネントを)"
+ms.assetid: e78b14f1-e487-43cd-9c6d-1a07483f1730
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# .NET Framework への COM コンポーネントの公開
+このセクションでは、既存の COM コンポーネントをマネージ コードに公開するために必要な処理について要約します。  .NET Framework と緊密に統合された COM サーバーの詳細については、「[相互運用のためのデザインの考慮事項](http://msdn.microsoft.com/ja-jp/b59637f6-fe35-40d6-ae72-901e7a707689)」を参照してください。  
+  
+ 既存の COM コンポーネントは、中間層のビジネス アプリケーションや独立の機能として、マネージ コードでは貴重なリソースとなります。  プライマリ相互運用機能アセンブリを持ち、COM のプログラミング標準に厳密に準拠したコンポーネントが理想的なコンポーネントです。  
+  
+#### .NET Framework に COM コンポーネントを公開するには  
+  
+1.  [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)  
+  
+     共通言語ランタイムでは、COM 型を含め、すべての型についてメタデータが必要です。  メタデータとしてインポートされた COM 型を含んだアセンブリを取得するには、いくつかの方法があります。  
+  
+2.  [マネージ コード内で COM 型を作成します](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)。  
+  
+     通常のマネージ型の場合と同様の方法で、COM 型を検査したり、インスタンスをアクティブにしたり、COM オブジェクトのメソッドを呼び出したりできます。  
+  
+3.  [相互運用プロジェクトをコンパイルします](../../../docs/framework/interop/compiling-an-interop-project.md)。  
+  
+     [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] には、[!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)]、C\#、C\+\+ など、共通言語仕様 \(CLS: Common Language Specification\) に準拠した複数の言語用のコンパイラが用意されています。  
+  
+4.  [相互運用アプリケーションを配置します](../../../docs/framework/interop/deploying-an-interop-application.md)。  
+  
+     相互運用アプリケーションは、[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)が付けられた署名済みアセンブリとして、グローバル アセンブリ キャッシュに配置することをお勧めします。  
+  
+## 参照  
+ [アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)   
+ [Design Considerations for Interoperation](http://msdn.microsoft.com/ja-jp/b59637f6-fe35-40d6-ae72-901e7a707689)   
+ [COM 相互運用機能のサンプル: .NET クライアントおよび COM サーバー](../../../docs/framework/interop/com-interop-sample-net-client-and-com-server.md)   
+ [言語への非依存性、および言語非依存コンポーネント](../../../docs/standard/language-independence-and-language-independent-components.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)
\ No newline at end of file
diff --git a/docs/framework/interop/exposing-dotnet-components-to-com.md b/docs/framework/interop/exposing-dotnet-components-to-com.md
new file mode 100644
index 00000000000..529e0214b02
--- /dev/null
+++ b/docs/framework/interop/exposing-dotnet-components-to-com.md
@@ -0,0 +1,65 @@
+---
+title: "COM への .NET Framework コンポーネントの公開 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "公開 (COM に .NET Framework コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 公開 (.NET Framework コンポーネントを)"
+ms.assetid: e42a65f7-1e61-411f-b09a-aca1bbce24c6
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# COM への .NET Framework コンポーネントの公開
+.NET 型を作成することと、その型をアンマネージ コードから処理することは、開発者にとってはまったく別の作業です。  このセクションでは、COM クライアントと相互運用できるマネージ コードを作成するためのヒントを示します。  
+  
+-   [相互運用のための .NET 型の要件](../../../docs/framework/interop/qualifying-net-types-for-interoperation.md)  
+  
+     COM に対して公開するすべてのマネージ型、マネージ メソッド、マネージ プロパティ、マネージ フィールド、およびマネージ イベントは、パブリックとしてください。  型は、パブリックな既定のコンストラクターを持っている必要があります。このコンストラクターが、COM を通じて呼び出すことができる唯一のコンストラクターです。  
+  
+-   [相互運用固有の属性の適用](../../../docs/framework/interop/applying-interop-attributes.md)  
+  
+     マネージ コード内でカスタム属性を使用すると、コンポーネントの相互運用性を拡張できます。  
+  
+-   [COM 用のアセンブリのパッケージ化](../../../docs/framework/interop/packaging-an-assembly-for-com.md)  
+  
+     作成したアセンブリの参照と配置に必要な手順の要約を COM 開発者が必要とする場合があります。  
+  
+ 補足として、COM クライアントからのマネージ型の処理に関連する作業を説明します。  
+  
+#### COM からマネージ型を処理するには  
+  
+1.  [アセンブリを COM に登録します](../../../docs/framework/interop/registering-assemblies-with-com.md)。  
+  
+     アセンブリ内の型 \(およびタイプ ライブラリ\) は、デザイン時に登録する必要があります。  インストーラーでアセンブリを登録しない場合は、Regasm.exe を使うように COM 開発者に指示してください。  
+  
+2.  [COM から .NET 型を参照します](../../../docs/framework/interop/how-to-reference-net-types-from-com.md)。  
+  
+     COM 開発者は、現在使用しているのと同じツールおよび方法で、アセンブリ内の型を参照できます。  
+  
+3.  [.NET オブジェクトを呼び出します](http://msdn.microsoft.com/ja-jp/40c9626c-aea6-4bad-b8f0-c1de462efd33)。  
+  
+     COM 開発者は、アンマネージ型のメソッドを呼び出す場合と同じ方法で、.NET オブジェクトのメソッドを呼び出すことができます。  たとえば、COM の **CoCreateInstance** API は、.NET オブジェクトをアクティブにします。  
+  
+4.  [COM からアクセスできるようにアプリケーションを配置します](http://msdn.microsoft.com/ja-jp/fb63564c-c1b9-4655-a094-a235625882ce)。  
+  
+     厳密な名前のアセンブリは、グローバル アセンブリ キャッシュにインストールできます。また、発行者からの署名が必要です。  厳密な名前のないアセンブリは、クライアントのアプリケーション ディレクトリにインストールする必要があります。  
+  
+## 参照  
+ [アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)   
+ [COM 相互運用機能のサンプル: COM クライアントおよび .NET サーバー](../../../docs/framework/interop/com-interop-sample-com-client-and-net-server.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-add-references-to-type-libraries.md b/docs/framework/interop/how-to-add-references-to-type-libraries.md
new file mode 100644
index 00000000000..7e50ccd256a
--- /dev/null
+++ b/docs/framework/interop/how-to-add-references-to-type-libraries.md
@@ -0,0 +1,63 @@
+---
+title: "方法: タイプ ライブラリへの参照を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, インポート (タイプ ライブラリの)"
+  - "インポート (タイプ ライブラリの)"
+  - "相互運用機能アセンブリ, 生成"
+  - "タイプ ライブラリ"
+ms.assetid: f5cfa6ba-cc25-4017-82cd-ba7391859113
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法: タイプ ライブラリへの参照を追加する
+Visual Studio は、タイプ ライブラリに参照を追加する際に、メタデータを含む相互運用機能アセンブリを生成します。  プライマリ相互運用機能アセンブリが使用可能な場合、Visual Studio では、新しい相互運用機能アセンブリを生成する前に既存のアセンブリが使用されます。  
+  
+### Visual Studio でタイプ ライブラリへの参照を追加するには  
+  
+1.  Windows Setup.exe ファイルで COM DLL ファイルまたは EXE ファイルがインストールされない場合は、このファイルをコンピューターにインストールします。  
+  
+2.  **\[プロジェクト\]**、**\[参照の追加\]** の順にクリックします。  
+  
+3.  参照マネージャーで、**\[COM\]** をクリックします。  
+  
+4.  一覧からタイプ ライブラリを選択するか、.tlb ファイルを参照します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+6.  ソリューション エクスプローラーで、追加した参照のショートカット メニューを開き、**\[プロパティ\]** を選択します。  
+  
+7.  **\[プロパティ\]** ウィンドウで、**\[相互運用機能型の埋め込み\]** プロパティが **\[True\]** に設定されていることを確認します。  その結果、Visual Studio により、COM 型の型情報が実行可能ファイルに埋め込まれ、アプリでプライマリ相互運用機能アセンブリを配置する必要がなくなります。  
+  
+> [!NOTE]
+>  メニュー オプションおよびダイアログ ボックス オプションは、使用中の Visula Studio のバージョンによって異なる場合があります。  
+  
+### コマンド ライン コンパイルのために参照をタイプ ライブラリに追加するには  
+  
+1.  相互運用機能アセンブリを生成します \(「[方法: 相互運用機能アセンブリをタイプ ライブラリから生成する](../../../docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md)」を参照\)。  
+  
+2.  相互運用機能アセンブリ名を使って「[\/link \(Link to COM Assembly\)](../Topic/-link%20\(C%23%20Compiler%20Options\).md)」または「[\/link](../Topic/-link%20\(Visual%20Basic\).md)」コンパイラ オプションを使用し、COM 型の型情報を実行可能ファイルに埋め込みます。  
+  
+## 参照  
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)   
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)   
+ [チュートリアル: Microsoft Office アセンブリからの型情報の埋め込み](../Topic/Walkthrough:%20Embedding%20Type%20Information%20from%20Microsoft%20Office%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)   
+ [チュートリアル: マネージ アセンブリからの型の埋め込み](../Topic/Walkthrough:%20Embedding%20Types%20from%20Managed%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)   
+ [\/link \(Link to COM Assembly\)](../Topic/-link%20\(C%23%20Compiler%20Options\).md)   
+ [\/link](../Topic/-link%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-create-com-wrappers.md b/docs/framework/interop/how-to-create-com-wrappers.md
new file mode 100644
index 00000000000..90a591eb993
--- /dev/null
+++ b/docs/framework/interop/how-to-create-com-wrappers.md
@@ -0,0 +1,87 @@
+---
+title: "方法: COM ラッパーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM, ラッパーの作成"
+  - "COM, ラッパー Visual Studio"
+ms.assetid: bdf89bea-1623-45ee-a57b-cf7c90395efa
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: COM ラッパーを作成する
+コンポーネント オブジェクト モデル \(COM: Component Object Model\) ラッパーを作成するには、[!INCLUDE[vsprvsext](../../../includes/vsprvsext-md.md)] の機能または .NET Framework のツールである Tlbimp.exe と Regasm.exe を使用します。  どちらの方法でも 2 種類の COM ラッパーが生成されます。  
+  
+-   タイプ ライブラリからの[ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md)。COM オブジェクトをマネージ コードで実行します。  
+  
+-   必要なレジストリ設定を含む [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)。マネージ オブジェクトをネイティブ アプリケーションで実行します。  
+  
+ [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] では、COM ラッパーを参照としてプロジェクトに追加できます。  
+  
+## マネージ アプリケーションでの COM オブジェクトのラップ  
+  
+#### Visual Studio を使用してランタイム呼び出し可能ラッパーを作成するには  
+  
+1.  マネージ アプリケーションのプロジェクトを開きます。  
+  
+2.  **\[プロジェクト\]** メニューの **\[すべてのファイルを表示\]** をクリックします。  
+  
+3.  **\[プロジェクト\]** メニューの **\[参照の追加\]** をクリックします。  
+  
+4.  \[参照の追加\] ダイアログ ボックスで、**\[COM\]** タブをクリックし、使用するコンポーネントを選択して **\[OK\]** をクリックします。  
+  
+     **ソリューション エクスプローラー**で、プロジェクトの \[参照設定\] フォルダーに COM コンポーネントが追加されていることを確認します。  
+  
+ これで、COM オブジェクトにアクセスするためのコードを作成できます。  まずオブジェクトを宣言します。これには、[!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] の `Imports` ステートメント、[!INCLUDE[csprcslong](../../../includes/csprcslong-md.md)] の `Using` ステートメントなどを使用します。  
+  
+> [!NOTE]
+>  Microsoft Office コンポーネントをプログラミングする場合は、最初に Microsoft ダウンロード センターから [Microsoft Office プライマリ相互運用機能アセンブリ](http://go.microsoft.com/fwlink/?LinkId=50479) \(PIA: Primary Interop Assembly\) をインストールします。  手順 4. で、目的の Office 製品向けに用意されているオブジェクト ライブラリの最新バージョンを選択します \(**Microsoft Word 11.0 Object Library** など\)。  [](http://msdn.microsoft.com/ja-jp/c9d2a8b9-69df-4c0b-90ca-4d85bae063c4)  
+  
+#### .NET Framework のツールを使用してランタイム呼び出し可能ラッパーを作成するには  
+  
+-   [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) ツールを実行します。  
+  
+ このツールは、元のタイプ ライブラリで定義された型のランタイム メタデータを含むアセンブリを作成します。  
+  
+## ネイティブ アプリケーションでのマネージ オブジェクトのラップ  
+  
+#### Visual Studio を使用して COM 呼び出し可能ラッパーを作成するには  
+  
+1.  ネイティブ コードで実行するマネージ クラス用にクラス ライブラリ プロジェクトを作成します。  このクラスには既定のコンストラクターが必要です。  
+  
+     AssemblyInfo ファイル内で、4 つの部分で構成される完全なバージョン番号がアセンブリに指定されていることを確認します。  この番号は、Windows レジストリでバージョンを管理するために必要となります。  バージョン番号の詳細については、「[アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)」を参照してください。  
+  
+2.  **\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+3.  **\[コンパイル\]** タブをクリックします。  
+  
+4.  **\[COM の相互運用機能に登録\]** チェック ボックスをオンにします。  
+  
+ プロジェクトをビルドすると、COM 相互運用機能に対してアセンブリが自動的に登録されます。  [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] でネイティブ アプリケーションをビルドする場合は、**\[プロジェクト\]** メニューの **\[参照の追加\]** をクリックすることでアセンブリを使用できます。  
+  
+#### .NET Framework のツールを使用して COM 呼び出し可能ラッパーを作成するには  
+  
+-   [Regasm.exe \(アセンブリ登録ツール\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) ツールを実行します。  
+  
+ このツールは、アセンブリ メタデータを読み取って、必要なエントリをレジストリに追加します。  この結果、COM クライアントが .NET Framework クラスを透過的に作成できるようになります。  アセンブリは、ネイティブ COM クラスと同じように使用できます。  
+  
+ 任意のディレクトリにあるアセンブリで Regasm.exe を実行し、さらに[Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md) を実行してそのアセンブリをグローバル アセンブリ キャッシュに移動できます。  アセンブリを移動しても、場所のレジストリ エントリは無効になりません。これは、アセンブリが他の場所で見つからない場合に常にグローバル アセンブリ キャッシュが調べられるからです。  
+  
+## 参照  
+ [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md)   
+ [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-create-wrappers-manually.md b/docs/framework/interop/how-to-create-wrappers-manually.md
new file mode 100644
index 00000000000..bfab18c9dca
--- /dev/null
+++ b/docs/framework/interop/how-to-create-wrappers-manually.md
@@ -0,0 +1,118 @@
+---
+title: "方法: ラッパを手動で作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ラッパー, 作成 (手動で)"
+ms.assetid: cc2a70d8-6a58-4071-a8cf-ce28c018c09b
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: ラッパを手動で作成する
+マネージ ソース コード内で COM の型を手動で宣言することにした場合、まず既存のインターフェイス定義言語 \(IDL: Interface Definition Language\) ファイルまたはタイプ ライブラリを用意することをお勧めします。  IDL ファイルがないか、またはタイプ ライブラリ ファイルを生成できない場合には、マネージ宣言を作成してその結果のアセンブリをタイプ ライブラリにエクスポートすることで、COM の型をシミュレートできます。  
+  
+### マネージ ソースから COM の型をシミュレートするには  
+  
+1.  共通言語仕様 \(CLS: Common Language Specification\) に準拠した言語を使用して型を宣言してからファイルをコンパイルします。  
+  
+2.  [タイプ ライブラリ エクスポーター \(Tlbexp.exe\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md) を使用して、その型を含むアセンブリをエクスポートします。  
+  
+3.  エクスポートした COM タイプ ライブラリを、COM 指向のマネージ型を宣言するための基礎として使用します。  
+  
+### ランタイム呼び出し可能ラッパー \(RCW: Runtime Callable Wrapper\) を作成するには  
+  
+1.  IDL ファイルまたはタイプ ライブラリ ファイルがあることを前提として、カスタム RCW に含めるクラスとインターフェイスを決定します。  アプリケーション内で直接にも間接にも使用される予定がない型がある場合は、それらを除外できます。  
+  
+2.  CLS 準拠言語でソース ファイルを作成し、型を宣言します。  インポート変換プロセスの詳しい説明については、「[タイプ ライブラリからアセンブリへの変換の要約](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)」を参照してください。  実際には、カスタム RCW を作成する場合は、[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) によって提供される型変換機能を手動で実行していることになります。  次のセクションの例では、IDL またはタイプ ライブラリ ファイル内の型と、C\# コード内でそれぞれに対応する型について示します。  
+  
+3.  宣言が完成したら、他のマネージ ソース コードのコンパイルと同様に、このファイルをコンパイルします。  
+  
+4.  Tlbimp.exe でインポートする型と同様に、追加情報が必要となる場合があります。その場合には、コードに直接追加できます。  詳細については、「[方法 : 相互運用機能アセンブリを編集する](http://msdn.microsoft.com/ja-jp/16aacb20-2269-42bf-a812-b6a7df17e277)」を参照してください。  
+  
+## 使用例  
+ IDL に含まれる `ISATest` インターフェイスおよび `SATest` クラスの例と、C\# ソース コードのそれらに対応する型を次のコードに示します。  
+  
+ **IDL またはタイプ ライブラリ ファイル**  
+  
+```  
+ [  
+object,  
+uuid(40A8C65D-2448-447A-B786-64682CBEF133),  
+dual,  
+helpstring("ISATest Interface"),  
+pointer_default(unique)  
+ ]  
+interface ISATest : IDispatch  
+ {  
+[id(1), helpstring("method InSArray")]   
+HRESULT InSArray([in] SAFEARRAY(int) *ppsa, [out,retval] int *pSum);  
+ };  
+ [  
+uuid(116CCA1E-7E39-4515-9849-90790DA6431E),  
+helpstring("SATest Class")  
+ ]  
+coclass SATest  
+ {  
+  [default] interface ISATest;  
+ };  
+```  
+  
+ **マネージ ソース コード内のラッパー**  
+  
+```csharp  
+using System;  
+using System.Runtime.InteropServices;  
+using System.Runtime.CompilerServices;  
+  
+[assembly:Guid("E4A992B8-6F5C-442C-96E7-C4778924C753")]  
+[assembly:ImportedFromTypeLib("SAServerLib")]  
+namespace SAServer  
+{  
+ [ComImport]  
+ [Guid("40A8C65D-2448-447A-B786-64682CBEF133")]  
+ [TypeLibType(TypeLibTypeFlags.FLicensed)]  
+ public interface ISATest  
+ {  
+  [DispId(1)]  
+  //[MethodImpl(MethodImplOptions.InternalCall,  
+  // MethodCodeType=MethodCodeType.Runtime)]  
+  int InSArray( [MarshalAs(UnmanagedType.SafeArray,  
+      SafeArraySubType=VarEnum.VT_I4)] ref int[] param );  
+ }   
+ [ComImport]  
+ [Guid("116CCA1E-7E39-4515-9849-90790DA6431E")]  
+ [ClassInterface(ClassInterfaceType.None)]   
+ [TypeLibType(TypeLibTypeFlags.FCanCreate)]  
+ public class SATest : ISATest   
+ {  
+  [DispId(1)]  
+  [MethodImpl(MethodImplOptions.InternalCall,   
+  MethodCodeType=MethodCodeType.Runtime)]  
+  extern int ISATest.InSArray( [MarshalAs(UnmanagedType.SafeArray,   
+  SafeArraySubType=VarEnum.VT_I4)] ref int[] param );  
+ }  
+}  
+```  
+  
+## 参照  
+ [Customizing Runtime Callable Wrappers](http://msdn.microsoft.com/ja-jp/4652beaf-77d0-4f37-9687-ca193288c0be)   
+ [COM Data Types](http://msdn.microsoft.com/ja-jp/f93ae35d-a416-4218-8700-c8218cc90061)   
+ [How to: Edit Interop Assemblies](http://msdn.microsoft.com/ja-jp/16aacb20-2269-42bf-a812-b6a7df17e277)   
+ [Type Library to Assembly Conversion Summary](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)   
+ [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)   
+ [Tlbexp.exe \(タイプ ライブラリ エクスポーター\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md b/docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md
new file mode 100644
index 00000000000..6c79c10e1df
--- /dev/null
+++ b/docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md
@@ -0,0 +1,56 @@
+---
+title: "方法: 相互運用機能アセンブリをタイプ ライブラリから生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, インポート (タイプ ライブラリの)"
+  - "インポート (タイプ ライブラリの)"
+  - "相互運用機能アセンブリ, 生成"
+  - "タイプ ライブラリ"
+  - "タイプ ライブラリ インポーター"
+ms.assetid: 4afd40c3-68f2-41c5-8ec1-4951bc148b9c
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法: 相互運用機能アセンブリをタイプ ライブラリから生成する
+[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) は、COM タイプ ライブラリに格納されているコクラスおよびインターフェイスをメタデータに変換するコマンド ライン ツールです。  このツールは、型情報の相互運用機能アセンブリおよび名前空間を自動的に生成します。  クラスのメタデータが利用可能になった後、マネージ クライアントは COM 型のインスタンスを生成し、.NET インスタンスの場合と同様の方法で、そのメソッドを呼び出すことができます。  Tlbimp.exe は、タイプ ライブラリ全体を一度にメタデータに変換しますが、タイプ ライブラリで定義されている型のサブセットの型情報は生成できません。  
+  
+### タイプ ライブラリから相互運用機能アセンブリを生成するには  
+  
+1.  次のコマンドを使用します。  
+  
+     **tlbimp** \<*type\-library\-file*\>  
+  
+     **\/out:** スイッチを追加することによって LOANLib.dll などの別の名前で相互運用機能アセンブリを生成します。  相互運用機能アセンブリの名前を変更しておくと、元の COM DLL との区別が付けやすくなり、名前の重複によって問題が生じることを防ぐことができます。  
+  
+## 使用例  
+ 次のコマンドを使用すると、`Loanlib` 名前空間に Loanlib.dll アセンブリが生成されます。  
+  
+```  
+tlbimp Loanlib.dll  
+```  
+  
+ 次のコマンドを使用すると、別の名前 \(LOANLib.dll\) で相互運用機能アセンブリが生成されます。  
+  
+```  
+tlbimp LoanLib.dll /out: LOANLib.dll  
+```  
+  
+## 参照  
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)   
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-generate-primary-interop-assemblies-using-tlbimp-exe.md b/docs/framework/interop/how-to-generate-primary-interop-assemblies-using-tlbimp-exe.md
new file mode 100644
index 00000000000..222c73b078b
--- /dev/null
+++ b/docs/framework/interop/how-to-generate-primary-interop-assemblies-using-tlbimp-exe.md
@@ -0,0 +1,81 @@
+---
+title: "方法: Tlbimp.exe を使用してプライマリ相互運用機能アセンブリを生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プライマリ相互運用機能アセンブリ, 生成"
+  - "Tlbimp.exe"
+  - "タイプ ライブラリ インポーター"
+ms.assetid: 5419011c-6e57-40f6-8c65-386db8f7a651
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: Tlbimp.exe を使用してプライマリ相互運用機能アセンブリを生成する
+プライマリ相互運用機能アセンブリを生成するには、次の 2 つの方法があります。  
+  
+-   [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] によって提供される[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) を使用します。  
+  
+     プライマリ相互運用機能アセンブリを生成する最も直接的な方法は、[Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) を使用することです。  Tlbimp.exe は、次の保護機能を提供します。  
+  
+    -   新規の相互運用機能アセンブリを作成するときには、その前に登録されている他のプライマリ相互運用機能アセンブリを調べて、入れ子になったタイプ ライブラリの参照がないかを確認してください。  
+  
+    -   プライマリ相互運用機能アセンブリに厳密な名前が付くようにコンテナー名やファイル名を指定しない場合は、プライマリ相互運用機能アセンブリの生成に失敗します。  
+  
+    -   依存アセンブリへの参照を省略した場合は、プライマリ相互運用機能アセンブリの生成に失敗します。  
+  
+    -   プライマリ相互運用機能アセンブリではない依存アセンブリへの参照を追加した場合は、プライマリ相互運用機能アセンブリの生成に失敗します。  
+  
+-   C\# などの共通言語仕様 \(CLS\) に準拠した言語を使用して、ソース コードで手動によりプライマリ相互運用機能アセンブリを作成します。  この方法は、タイプ ライブラリが使用できない場合に便利です。  
+  
+ 厳密な名前でアセンブリに署名するには、暗号キー ペアが必要です。  詳しくは、「[キー ペアを作成する](../../../docs/framework/app-domains/how-to-create-a-public-private-key-pair.md)」を参照してください。  
+  
+### Tlbimp.exe を使用してプライマリ相互運用機能アセンブリを生成する方法  
+  
+1.  コマンド プロンプトで次のように入力します。  
+  
+     **tlbimp** *tlbfile*  **\/primary\/keyfile:** *filename* **\/out:** *assemblyname*  
+  
+     このコマンドで、*tlbfile* は COM タイプ ライブラリを含むファイル、*filename* はキー ペアを含むコンテナーまたはファイルの名前、*assemblyname* は厳密な名前で署名するアセンブリの名前です。  
+  
+ プライマリ相互運用機能アセンブリは、他のプライマリ相互運用機能アセンブリのみを参照できます。  アセンブリがサードパーティの COM タイプ ライブラリからタイプを参照する場合、プライマリ相互運用機能アセンブリを生成する前に、発行者からプライマリ相互運用機能アセンブリを取得する必要があります。  発行者である場合は、参照元のプライマリ相互運用機能アセンブリを生成する前に、依存タイプ ライブラリのプライマリ相互運用機能アセンブリを生成する必要があります。  
+  
+ 元のタイプ ライブラリとは異なるバージョン番号の依存プライマリ相互運用機能アセンブリは、現在のディレクトリにインストールされている場合、検出できません。  依存プライマリ相互運用機能アセンブリを Windows レジストリに登録するか、または **\/reference** オプションを使用して、Tlbimp.exe が依存 DLL を検出できるようにする必要があります。  
+  
+ 複数のバージョンのタイプ ライブラリをラップすることもできます。  その方法については、「[How to: Wrap Multiple Versions of Type Libraries](http://msdn.microsoft.com/ja-jp/79eefe04-a770-4bc3-8ea2-e90ddb8ec31f)」を参照してください。  
+  
+## 使用例  
+ 次の例は、COM タイプ ライブラリ `LibUtil.tlb` をインポートし、アセンブリ `LibUtil.dll` にキー ファイル `CompanyA.snk` を使用して厳密な名前で署名します。  この例では、特定の名前空間名を省略することにより、既定の名前空間 `LibUtil` を生成します。  
+  
+```  
+tlbimp LibUtil.tlb /primary /keyfile:CompanyA.snk /out:LibUtil.dll  
+```  
+  
+ 名前を \(*VendorName*.*LibraryName* の名前付けガイドラインを使用して\) より分かりやすくするために、次の例では既定のアセンブリ ファイル名と名前空間名をオーバーライドします。  
+  
+```  
+tlbimp LibUtil.tlb /primary /keyfile:CompanyA.snk /namespace:CompanyA.LibUtil /out:CompanyA.LibUtil.dll  
+```  
+  
+ 次の例では、`CompanyA.LibUtil.dll` を参照する `MyLib.tlb` をインポートし、アセンブリ `CompanyB.MyLib.dll` にキー ファイル `CompanyB.snk` を使用して厳密な名前で署名します。  名前空間 `CompanyB.MyLib` は、既定の名前空間名をオーバーライドします。  
+  
+```  
+tlbimp MyLib.tlb /primary /keyfile:CompanyB.snk /namespace:CompanyB.MyLib /reference:CompanyA.LibUtil.dll /out:CompanyB.MyLib.dll  
+```  
+  
+## 参照  
+ [方法: プライマリ相互運用機能アセンブリを登録する](../../../docs/framework/interop/how-to-register-primary-interop-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-implement-callback-functions.md b/docs/framework/interop/how-to-implement-callback-functions.md
new file mode 100644
index 00000000000..35e9c349a59
--- /dev/null
+++ b/docs/framework/interop/how-to-implement-callback-functions.md
@@ -0,0 +1,142 @@
+---
+title: "方法: コールバック関数を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "callback 関数, 実装"
+ms.assetid: e55b3712-b9ea-4453-bd9a-ad5cfa2f6bfa
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法: コールバック関数を実装する
+次の手順と例は、マネージ アプリケーションがプラットフォーム呼び出しを使用して、ローカル コンピューター上の各ウィンドウのハンドル値を出力する方法を示しています。  具体的には、この手順と例では **EnumWindows** 関数を使用してウィンドウのリストをステップスルーし、\(CallBack という名前の\) マネージ コールバック関数を使用してウィンドウ ハンドルの値を出力します。  
+  
+### コールバック関数を実装するには  
+  
+1.  実装を進める前に、**EnumWindows** 関数のシグネチャを見てみます。  **EnumWindows** のシグネチャは次のとおりです。  
+  
+    ```  
+    BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam)  
+    ```  
+  
+     この関数がコールバックを必要とする 1 つの手掛かりは、**lpEnumFunc** 引数が存在することです。  コールバック関数へのポインターを使用する引数の名前では、**lp** \(long pointer\) プレフィックスが **Func** サフィックスと組み合わされているのが一般的です。  Win32 の関数に関するドキュメントについては、Microsoft プラットフォーム SDK を参照してください。  
+  
+2.  マネージ コールバック関数を作成します。  この例では、`CallBack` というデリゲート型を宣言しています。この型は 2 つの引数 \(**hwnd** と **lparam**\) を受け取ります。  最初の引数はウィンドウのハンドル、2 番目の引数はアプリケーションで定義します。  このリリースでは、両方の引数が整数でなければなりません。  
+  
+     コールバック関数は通常、成功を示す場合は 0 以外の値を返し、失敗を示す場合は 0 を返します。  この例では、列挙を続けるために戻り値を明示的に **true** に設定します。  
+  
+3.  デリゲートを作成し、**EnumWindows** 関数に引数として渡します。  プラットフォーム呼び出しにより、デリゲートは既知のコールバック形式に自動的に変換されます。  
+  
+4.  コールバック関数がその作業を完了する前にガベージ コレクターがデリゲートをクリアしないようにしてください。  デリゲートをパラメーターとして渡した場合、または構造内のフィールドとして含まれるデリゲートを渡した場合、デリゲートは呼び出しの間収集されないままです。  したがって、次の列挙例と同様に、コールバック関数はその作業を呼び出しが戻る前に完了するので、マネージ呼び出し元による追加操作を必要としません。  
+  
+     ただし、呼び出しが戻った後にコールバック関数を呼び出せる場合、マネージ呼び出し元は、コールバック関数が終了するまでデリゲートが収集されないようにしておくための対策を講じる必要があります。  ガベージ コレクションを回避する方法の詳細については、プラットフォーム呼び出しによる「[相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)」を参照してください。  
+  
+## 使用例  
+  
+```vb  
+Imports System  
+Imports System.Runtime.InteropServices  
+  
+Public Delegate Function CallBack( _  
+hwnd As Integer, lParam As Integer) As Boolean  
+  
+Public Class EnumReportApp  
+  
+    Declare Function EnumWindows Lib "user32" ( _  
+       x As CallBack, y As Integer) As Integer  
+  
+    Public Shared Sub Main()  
+        EnumWindows(AddressOf EnumReportApp.Report, 0)  
+    End Sub 'Main  
+  
+    Public Shared Function Report(hwnd As Integer, lParam As Integer) _  
+    As Boolean  
+        Console.Write("Window handle is ")  
+        Console.WriteLine(hwnd)  
+        Return True  
+    End Function 'Report  
+End Class 'EnumReportApp  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Runtime.InteropServices;  
+  
+public delegate bool CallBack(int hwnd, int lParam);  
+  
+public class EnumReportApp  
+{  
+    [DllImport("user32")]  
+    public static extern int EnumWindows(CallBack x, int y);   
+  
+    public static void Main()   
+    {  
+        CallBack myCallBack = new CallBack(EnumReportApp.Report);  
+        EnumWindows(myCallBack, 0);  
+    }  
+  
+    public static bool Report(int hwnd, int lParam)  
+    {   
+        Console.Write("Window handle is ");  
+        Console.WriteLine(hwnd);  
+        return true;  
+    }  
+}  
+  
+```  
+  
+```cpp  
+using namespace System;  
+using namespace System::Runtime::InteropServices;  
+  
+// A delegate type.  
+delegate bool CallBack(int hwnd, int lParam);  
+  
+// Managed type with the method to call.  
+ref class EnumReport  
+{  
+// Report the window handle.  
+public:  
+    [DllImport("user32")]  
+    static int EnumWindows(CallBack^ x, int y);  
+  
+    static void Main()  
+    {  
+        EnumReport^ er = gcnew EnumReport;  
+        CallBack^ myCallBack = gcnew CallBack(&EnumReport::Report);  
+        EnumWindows(myCallBack, 0);  
+    }  
+  
+    static bool Report(int hwnd, int lParam)  
+    {  
+       Console::Write(L"Window handle is ");  
+       Console::WriteLine(hwnd);  
+       return true;  
+    }  
+};  
+  
+int main()  
+{  
+    EnumReport::Main();  
+}  
+```  
+  
+## 参照  
+ [コールバック関数](../../../docs/framework/interop/callback-functions.md)   
+ [DLL 関数の呼び出し](../../../docs/framework/interop/calling-a-dll-function.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-map-hresults-and-exceptions.md b/docs/framework/interop/how-to-map-hresults-and-exceptions.md
new file mode 100644
index 00000000000..16b1707b5fc
--- /dev/null
+++ b/docs/framework/interop/how-to-map-hresults-and-exceptions.md
@@ -0,0 +1,155 @@
+---
+title: "方法: HRESULT に例外を割り当てる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 例外"
+  - "COM 相互運用機能, HRESULT"
+  - "例外, HRESULT"
+  - "HRESULT"
+  - "相互運用 (アンマネージ コードとの), 例外"
+  - "相互運用 (アンマネージ コードとの), HRESULT"
+ms.assetid: 610b364b-2761-429d-9c4a-afbc3e66f1b9
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: HRESULT に例外を割り当てる
+COM のメソッドは、HRESULT を返すことによってエラーを報告します。.NET のメソッドは、例外をスローすることによってエラーを報告します。  ランタイムは、この 2 つの間の遷移を処理します。  .NET Framework のそれぞれの例外クラスが HRESULT に割り当てられます。  
+  
+ ユーザー定義の例外クラスは、適切な HRESULT であればどの HRESULT でも指定できます。  これらの例外クラスは、例外オブジェクトの **HResult** フィールドを設定することより、例外が生成されたときに返す HRESULT を動的に変更できます。  アンマネージ プロセスの .NET オブジェクトに実装されている **IErrorInfo** インターフェイスを通じて、クライアントに例外についての追加情報が提供されます。  
+  
+ **System.Exception** を拡張するクラスを作成する場合は、構築時に HRESULT フィールドを設定する必要があります。  それ以外の場合、HRESULT の値は基本クラスによって割り当てられます。  例外のコンストラクターに値を供給することにより、既存の HRESULT に新しい例外クラスを割り当てることができます。  
+  
+ スレッドに `IErrorInfo` がある場合、ランタイムが `HRESULT` を無視することがあることに注意してください。  この動作は、`HRESULT` と `IErrorInfo` が同じエラーを表明しない場合に発生します。   ``  
+  
+### 新しい例外クラスを作成し、HRESULT に割り当てるには  
+  
+1.  次のコードを使用し、新しい例外クラス `NoAccessException` を作成し、HRESULT `E_ACCESSDENIED` に割り当てます。  
+  
+    ```cpp  
+    Class NoAccessException : public ApplicationException  
+    {  
+        NoAccessException () {  
+        HResult = E_ACCESSDENIED;   
+    }  
+    }  
+    CMyClass::MethodThatThrows  
+    {  
+    throw new NoAccessException();  
+    }  
+    ```  
+  
+ マネージ コードとアンマネージ コードが同時に使用されているプログラム \(任意のプログラミング言語\) もあります。  たとえば、次のコード例のカスタム マーシャラーは、**Marshal.ThrowExceptionForHR\(int HResult\)** メソッドを使用して、特定の HRESULT 値を持つ例外をスローします。  このメソッドは、HRESULT を調べ、適切な例外型を生成します。  たとえば、次のコードの HRESULT は、**ArgumentException** を生成します。  
+  
+```cpp  
+CMyClass::MethodThatThrows  
+{  
+    Marshal.ThrowExceptionForHR(COR_E_ARGUMENT);  
+}  
+```  
+  
+ 各 HRESULT から対応する .NET Framework の例外クラスへのすべての対応付けを次の表に示します。  
+  
+|HRESULT|.NET の例外|  
+|-------------|--------------|  
+|**MSEE\_E\_APPDOMAINUNLOADED**|**AppDomainUnloadedException**|  
+|**COR\_E\_APPLICATION**|**ApplicationException**|  
+|**COR\_E\_ARGUMENT または E\_INVALIDARG**|**ArgumentException**|  
+|**COR\_E\_ARGUMENTOUTOFRANGE**|**ArgumentOutOfRangeException**|  
+|**COR\_E\_ARITHMETIC または ERROR\_ARITHMETIC\_OVERFLOW**|**ArithmeticException**|  
+|**COR\_E\_ARRAYTYPEMISMATCH**|**ArrayTypeMismatchException**|  
+|**COR\_E\_BADIMAGEFORMAT または RROR\_BAD\_FORMAT**|**BadImageFormatException**|  
+|**COR\_E\_COMEMULATE\_ERROR**|**COMEmulateException**|  
+|**COR\_E\_CONTEXTMARSHAL**|**ContextMarshalException**|  
+|**COR\_E\_CORE**|**CoreException**|  
+|**NTE\_FAIL**|**CryptographicException**|  
+|**COR\_E\_DIRECTORYNOTFOUND または ERROR\_PATH\_NOT\_FOUND**|**DirectoryNotFoundException**|  
+|**COR\_E\_DIVIDEBYZERO**|**DivideByZeroException**|  
+|**COR\_E\_DUPLICATEWAITOBJECT**|**DuplicateWaitObjectException**|  
+|**COR\_E\_ENDOFSTREAM**|**EndOfStreamException**|  
+|**COR\_E\_TYPELOAD**|**EntryPointNotFoundException**|  
+|**COR\_E\_EXCEPTION**|**例外**|  
+|**COR\_E\_EXECUTIONENGINE**|**ExecutionEngineException**|  
+|**COR\_E\_FIELDACCESS**|**FieldAccessException**|  
+|**COR\_E\_FILENOTFOUND または ERROR\_FILE\_NOT\_FOUND**|**FileNotFoundException**|  
+|**COR\_E\_FORMAT**|**FormatException**|  
+|**COR\_E\_INDEXOUTOFRANGE**|**IndexOutOfRangeException**|  
+|**COR\_E\_INVALIDCAST または E\_NOINTERFACE**|**InvalidCastException**|  
+|**COR\_E\_INVALIDCOMOBJECT**|**InvalidComObjectException**|  
+|**COR\_E\_INVALIDFILTERCRITERIA**|**InvalidFilterCriteriaException**|  
+|**COR\_E\_INVALIDOLEVARIANTTYPE**|**InvalidOleVariantTypeException**|  
+|**COR\_E\_INVALIDOPERATION**|**InvalidOperationException**|  
+|**COR\_E\_IO**|**IOException**|  
+|**COR\_E\_MEMBERACCESS**|**AccessException**|  
+|**COR\_E\_METHODACCESS**|**MethodAccessException**|  
+|**COR\_E\_MISSINGFIELD**|**MissingFieldException**|  
+|**COR\_E\_MISSINGMANIFESTRESOURCE**|**MissingManifestResourceException**|  
+|**COR\_E\_MISSINGMEMBER**|**MissingMemberException**|  
+|**COR\_E\_MISSINGMETHOD**|**MissingMethodException**|  
+|**COR\_E\_MULTICASTNOTSUPPORTED**|**MulticastNotSupportedException**|  
+|**COR\_E\_NOTFINITENUMBER**|**NotFiniteNumberException**|  
+|**E\_NOTIMPL**|**NotImplementedException**|  
+|**COR\_E\_NOTSUPPORTED**|**NotSupportedException**|  
+|**COR\_E\_NULLREFERENCE または E\_POINTER**|**NullReferenceException**|  
+|**COR\_E\_OUTOFMEMORY または**<br /><br /> **E\_OUTOFMEMORY**|**OutOfMemoryException**|  
+|**COR\_E\_OVERFLOW**|**OverflowException**|  
+|**COR\_E\_PATHTOOLONG または ERROR\_FILENAME\_EXCED\_RANGE**|**PathTooLongException**|  
+|**COR\_E\_RANK**|**RankException**|  
+|**COR\_E\_REFLECTIONTYPELOAD**|**ReflectionTypeLoadException**|  
+|**COR\_E\_REMOTING**|**RemotingException**|  
+|**COR\_E\_SAFEARRAYTYPEMISMATCH**|**SafeArrayTypeMismatchException**|  
+|**COR\_E\_SECURITY**|**SecurityException**|  
+|**COR\_E\_SERIALIZATION**|**SerializationException**|  
+|**COR\_E\_STACKOVERFLOW または ERROR\_STACK\_OVERFLOW**|**StackOverflowException**|  
+|**COR\_E\_SYNCHRONIZATIONLOCK**|**SynchronizationLockException**|  
+|**COR\_E\_SYSTEM**|**SystemException**|  
+|**COR\_E\_TARGET**|**TargetException**|  
+|**COR\_E\_TARGETINVOCATION**|**TargetInvocationException**|  
+|**COR\_E\_TARGETPARAMCOUNT**|**TargetParameterCountException**|  
+|**COR\_E\_THREADABORTED**|**ThreadAbortException**|  
+|**COR\_E\_THREADINTERRUPTED**|**ThreadInterruptedException**|  
+|**COR\_E\_THREADSTATE**|**ThreadStateException**|  
+|**COR\_E\_THREADSTOP**|**ThreadStopException**|  
+|**COR\_E\_TYPELOAD**|**TypeLoadException**|  
+|**COR\_E\_TYPEINITIALIZATION**|**TypeInitializationException**|  
+|**COR\_E\_VERIFICATION**|**VerificationException**|  
+|**COR\_E\_WEAKREFERENCE**|**WeakReferenceException**|  
+|**COR\_E\_VTABLECALLSNOTSUPPORTED**|**VTableCallsNotSupportedException**|  
+|**上記以外のすべての HRESULT**|**COMException**|  
+  
+ 拡張されたエラー情報を取得するために、マネージ クライアントは、生成された例外オブジェクトの各フィールドを調べます。  例外オブジェクトでエラーについての有益な情報を提供できるようにするには、COM オブジェクトは、**IErrorInfo** インターフェイスを実装している必要があります。  ランタイムは、**IErrorInfo** によって提供される情報を使用して、例外オブジェクトを初期化します。  
+  
+ COM オブジェクトが **IErrorInfo** をサポートしていない場合、ランタイムは既定の値を使用して例外オブジェクトを初期化します。  次の表で、例外オブジェクトに関連付けられた各フィールドを一覧し、COM オブジェクトが **IErrorInfo** をサポートしている場合の既定の情報ソースを示します。  
+  
+ スレッドに `IErrorInfo` がある場合、ランタイムが `HRESULT` を無視することがあることに注意してください。  この動作は、`HRESULT` と `IErrorInfo` が同じエラーを表明しない場合に発生します。   ``  
+  
+|例外フィールド|COM からの情報のソース|  
+|-------------|-------------------|  
+|**ErrorCode**|呼び出しから返された HRESULT。|  
+|**HelpLink**|**IErrorInfo\-\>HelpContext** が 0 \(ゼロ\) 以外の場合は、文字列は **IErrorInfo\-\>GetHelpFile** と "\#" と **IErrorInfo\-\>GetHelpContext** を連結して構成されます。  それ以外の場合は、文字列は、**IErrorInfo\-\>GetHelpFile** から返されます。|  
+|**InnerException**|常に null 参照 \(Visual Basic では **Nothing**\)。|  
+|**Message**|**IErrorInfo\-\>GetDescription** から返された文字列。|  
+|**ソース**|**IErrorInfo\-\>GetSource** から返された文字列。|  
+|**StackTrace**|スタック トレース。|  
+|**TargetSite**|失敗し、HRESULT を返したメソッドの名前。|  
+  
+ **Message**、**Source**、**StackTrace** の各例外フィールドは、**StackOverflowException** では使用できません。  
+  
+## 参照  
+ [Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)   
+ [例外](../../../docs/standard/exceptions/index.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-migrate-managed-code-dcom-to-wcf.md b/docs/framework/interop/how-to-migrate-managed-code-dcom-to-wcf.md
new file mode 100644
index 00000000000..2b7b63008b0
--- /dev/null
+++ b/docs/framework/interop/how-to-migrate-managed-code-dcom-to-wcf.md
@@ -0,0 +1,455 @@
+---
+title: "方法: マネージ コード DCOM を WCF に移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 52961ffc-d1c7-4f83-832c-786444b951ba
+caps.latest.revision: 6
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法: マネージ コード DCOM を WCF に移行する
+Windows Communication Foundation \(WCF\) は、分散コンポーネント オブジェクト モデル \(DCOM\) と比較して、分散環境でサーバーとクライアントの間でマネージ コードを呼び出すための、推奨されているセキュリティで保護された選択肢です。  この記事では、以下のシナリオで、DCOM から WCF にコードを移行する方法を示します。  
+  
+-   リモート サービスからクライアントに値渡しでオブジェクトを返す  
+  
+-   クライアントからリモート サービスに値渡しでオブジェクトを送信する  
+  
+-   リモート サービスからクライアントに参照渡しでオブジェクトを返す  
+  
+ セキュリティ上の理由で、WCF では、クライアントからサービスに参照渡しでオブジェクトを送信することはできません。  クライアントとサーバーの間で対話を必要とするシナリオは、WCF で双方向サービスを使用することによって実現できます。  双方向サービスの詳細については、「[双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)」を参照してください。  
+  
+ WCF サービスの作成方法、およびそれらのサービスのクライアントの作成方法について詳しくは、「[基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)」、「[サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)」および「[クライアントを構築する](../../../docs/framework/wcf/building-clients.md)」を参照してください。  
+  
+## DCOM コード例  
+ これらのシナリオでは、WCF を使用して示されている DCOM インターフェイスに、以下の構造があります。  
+  
+```  
+[ComVisible(true)]  
+[Guid("AA9C4CDB-55EA-4413-90D2-843F1A49E6E6")]  
+public interface IRemoteService  
+{  
+   Customer GetObjectByValue();  
+   IRemoteObject GetObjectByReference();  
+   void SendObjectByValue(Customer customer);  
+}  
+  
+[ComVisible(true)]  
+[Guid("A12C98DE-B6A1-463D-8C24-81E4BBC4351B")]  
+public interface IRemoteObject  
+{  
+}  
+  
+public class Customer  
+{  
+}  
+  
+```  
+  
+## サービスから値渡しでオブジェクトを返す  
+ このシナリオでは、サービスを呼び出し、そのメソッドがオブジェクトを返します。オブジェクトはサーバーからクライアントに値で渡されます。  このシナリオは、次の COM 呼び出しを表しています。  
+  
+```  
+public interface IRemoteService  
+{  
+    Customer GetObjectByValue();  
+}  
+```  
+  
+ このシナリオでは、クライアントは、リモート サービスからオブジェクトの逆シリアル化されたコピーを受け取ります。  クライアントは、サービスにコールバックしなくても、このローカル コピーと対話できます。  つまり、ローカル コピーのメソッドが呼び出されるときに、サービスはまったく関与しないことがクライアントに保証されています。  WCF は常にサービスから値渡しでオブジェクトを返すため、次の各手順では、通常の WCF サービスを作成する方法について説明します。  
+  
+### 手順 1: WCF サービスのインターフェイスを定義する  
+ WCF サービスのパブリック インターフェイスを定義し、\[<xref:System.ServiceModel.ServiceContractAttribute>\] 属性でマークします。  クライアントに公開するメソッドを \[<xref:System.ServiceModel.OperationContractAttribute>\] 属性でマークします。  次の例は、これらの属性を使用して、サーバー側のインターフェイスと、クライアントが呼び出すことのできるインターフェイス メソッドとを識別する方法を示しています。  このシナリオで使用されるメソッドは、太字で示します。  
+  
+```  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Web;   
+. . .  
+[ServiceContract]  
+public interface ICustomerManager  
+{  
+    [OperationContract]  
+    void StoreCustomer(Customer customer);  
+  
+    [OperationContract]     
+    Customer GetCustomer(string firstName, string lastName);   
+  
+}  
+  
+```  
+  
+### 手順 2: データ コントラクトを定義する  
+ 次に、サービスとクライアントの間でデータが交換される方法を説明する、サービスのデータ コントラクトを作成する必要があります。  データ コントラクトで説明されたクラスは、\[<xref:System.Runtime.Serialization.DataContractAttribute>\] 属性でマークする必要があります。  クライアントとサーバーの両方に表示する個々のプロパティやフィールドは、\[<xref:System.Runtime.Serialization.DataMemberAttribute>\] 属性でマークする必要があります。データ コントラクト内のクラスから派生した型を許可する場合は、\[<xref:System.Runtime.Serialization.KnownTypeAttribute>\] 属性でそれらを指定する必要があります。  WCF は、サービス インターフェイス内の型と既知の型として識別される型だけを、シリアル化または逆シリアル化します。  既知の型ではない型を使用しようとすると、例外が発生します。  
+  
+ データ コントラクトの詳細については、「[データ コントラクト](../../../docs/framework/wcf/samples/data-contracts.md)」を参照してください。  
+  
+```  
+[DataContract]  
+[KnownType(typeof(PremiumCustomer))]  
+public class Customer  
+{  
+    [DataMember]  
+    public string Firstname;  
+    [DataMember]  
+    public string Lastname;  
+    [DataMember]  
+    public Address DefaultDeliveryAddress;  
+    [DataMember]  
+    public Address DefaultBillingAddress;  
+}  
+ [DataContract]  
+public class PremiumCustomer : Customer  
+{  
+    [DataMember]  
+    public int AccountID;  
+}  
+  
+ [DataContract]  
+public class Address  
+{  
+    [DataMember]  
+    public string Street;  
+    [DataMember]  
+    public string Zipcode;  
+    [DataMember]  
+    public string City;  
+    [DataMember]  
+    public string State;  
+    [DataMember]  
+    public string Country;  
+}  
+  
+```  
+  
+### 手順 3: WCF サービスを実装する  
+ 次に、前の手順で定義したインターフェイスを実装する、WCF サービス クラスを実装する必要があります。  
+  
+```  
+public class CustomerService: ICustomerManager    
+{  
+    public void StoreCustomer(Customer customer)  
+    {  
+        // write to a database  
+    }  
+    public Customer GetCustomer(string firstName, string lastName)  
+    {  
+        // read from a database  
+    }  
+}  
+```  
+  
+### 手順 4: サービスとクライアントを構成する  
+ WCF サービスを実行するには、特定の WCF バインドを使用して特定の URL で上記のサービス インターフェイスを公開するエンドポイントを宣言する必要があります。  バインディングは、クライアントとサーバーが通信するための、トランスポート、エンコード、およびプロトコルの詳細を指定します。  通常、サービス プロジェクトの構成ファイル \(web.config\) にバインドを追加します。  サービス例のためのバインド エントリを以下に示します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Server.CustomerService">  
+        <endpoint address="http://localhost:8083/CustomerManager"   
+                  binding="basicHttpBinding"  
+                  contract="Shared.ICustomerManager" />  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ 次に、サービスによって指定されたバインド情報と一致するように、クライアントを構成する必要があります。  そのためには、クライアントのアプリケーション構成 \(app.config\) ファイルに以下を追加します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <endpoint name="customermanager"   
+                address="http://localhost:8083/CustomerManager"   
+                binding="basicHttpBinding"   
+                contract="Shared.ICustomerManager"/>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### 手順 5: サービスを実行する  
+ 最後に、サービス アプリに次の行を追加して、アプリを起動することにより、コンソール アプリケーション内で自己ホストすることができます。  WCF サービス アプリケーションをホストするその他の方法について詳しくは、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+```  
+ServiceHost customerServiceHost = new ServiceHost(typeof(CustomerService));  
+customerServiceHost.Open();  
+  
+```  
+  
+### 手順 6: クライアントからサービスを呼び出す  
+ クライアントからのサービスを呼び出すには、サービスのチャネル ファクトリを作成し、チャネルを要求する必要があります。これにより、クライアントから `GetCustomer` メソッドを直接呼び出すことができるようになります。  チャネルはサービスのインターフェイスを実装し、基になる要求\/応答のロジックを処理します。  このメソッドの呼び出しからの戻り値は、サービス応答の逆シリアル化されたコピーです。  
+  
+```  
+ChannelFactory<ICustomerManager> factory =   
+     new ChannelFactory<ICustomerManager>("customermanager");  
+ICustomerManager service = factory.CreateChannel();  
+Customer customer = service.GetCustomer("Mary", "Smith");  
+  
+```  
+  
+## クライアントからサーバーに値渡しのオブジェクトを送信する  
+ このシナリオでは、クライアントがサーバーに値渡しでオブジェクトを送信します。  つまり、サーバーは、オブジェクトの逆シリアル化されたコピーを受け取ります。  サーバーは、そのコピーのメソッドを呼び出すことができ、クライアント コードにコールバックがないことが保証されます。  前述のとおり、WCF での通常のデータ交換は、値渡しでなされます。  これにより、これらのいずれかのオブジェクトのメソッドの呼び出しはローカルでのみ実行され、クライアントではコードは呼び出されないことが保証されます。  
+  
+ このシナリオは、次の COM メソッドの呼び出しを表しています。  
+  
+```  
+public interface IRemoteService  
+{  
+    void SendObjectByValue(Customer customer);  
+}  
+  
+```  
+  
+ このシナリオでは、最初の例で示すものと同じサービス インターフェイスおよびデータ コントラクトを使用します。  さらに、クライアントとサービスが同じ方法で構成されます。  この例では、オブジェクトを送信するためにチャネルが作成されて、同じ方法で実行されます。  ただし、この例では、値渡しでオブジェクトを送信して、サービスを呼び出すクライアントを作成します。  クライアントがサービス コントラクトで呼び出すサービス メソッドは、太字で示されます。  
+  
+```  
+[ServiceContract]  
+public interface ICustomerManager  
+{  
+    [OperationContract]  
+        void StoreCustomer(Customer customer);  
+  
+    [OperationContract]  
+    Customer GetCustomer(string firstName, string lastName);  
+}  
+  
+```  
+  
+### 値渡しのオブジェクトを送信するクライアントにコードを追加する  
+ 次のコードは、クライアントが値渡しの customer オブジェクトを新規に作成する方法、`ICustomerManager` サービスと通信するチャネルを作成する方法、およびそこに customer オブジェクトを送信する方法を示しています。  
+  
+ Customer オブジェクトはシリアル化され、サービスに送信されて、サービスによりそのオブジェクトの新しいコピーへと逆シリアル化されます。  サービスがこのオブジェクトで呼び出すメソッドは、サーバーにおいてローカルでのみ実行します。このコードは、派生型 \(`PremiumCustomer`\) の送信を例示していることに注意してください。  サービス コントラクトは `Customer` オブジェクトを想定していますが、サービス データ コントラクトは \[<xref:System.Runtime.Serialization.KnownTypeAttribute>\] 属性を使用して `PremiumCustomer` も許可されることを示しています。  このサービス インターフェイスを介して他の型をシリアル化または逆シリアル化しようとしても、WCF は失敗します。  
+  
+```  
+PremiumCustomer customer = new PremiumCustomer();  
+customer.Firstname = "John";  
+customer.Lastname = "Doe";  
+customer.DefaultBillingAddress = new Address();  
+customer.DefaultBillingAddress.Street = "One Microsoft Way";  
+customer.DefaultDeliveryAddress = customer.DefaultBillingAddress;  
+customer.AccountID = 42;  
+  
+ChannelFactory<ICustomerManager> factory =  
+   new ChannelFactory<ICustomerManager>("customermanager");  
+ICustomerManager customerManager = factory.CreateChannel();  
+customerManager.StoreCustomer(customer);  
+```  
+  
+## サービスから参照渡しでオブジェクトを返す  
+ このシナリオでは、クライアント アプリがリモート サービスを呼び出し、メソッドがオブジェクトを返します。オブジェクトはサービスからクライアントに参照によって渡されます。  
+  
+ 前述のとおり、WCF サービスは常に値でオブジェクトを返します。  ただし、<xref:System.ServiceModel.EndpointAddress10> クラスを使用して同様の結果を得ることもできます。  <xref:System.ServiceModel.EndpointAddress10> は、サーバー上のセッションフルな参照渡しのオブジェクトを取得するためにクライアントが使用できる、シリアル化可能な値渡しのオブジェクトです。  
+  
+ このシナリオで示される WCF の参照渡しのオブジェクトの動作は、DCOM とは異なります。  DCOM では、サーバーが参照渡しのオブジェクトをクライアントに直接返すことができ、クライアントはそのオブジェクトのメソッドを呼び出して、サーバーで実行することができます。  しかし WCF では、オブジェクトが常に値渡しで返されます。  クライアントは、<xref:System.ServiceModel.EndpointAddress10> によって表されるその値渡しのオブジェクトを取得し、それを使用して独自の参照渡しのセッションフル オブジェクトを作成する必要があります。  セッションフル オブジェクトのクライアント メソッド呼び出しは、サーバーで実行されます。つまり、WCF でのこの参照渡しのオブジェクトは、セッションフルとなるように構成された通常の WCF サービスです。  
+  
+ WCF では、セッションは 2 つのエンドポイント間で送信される複数のメッセージを関連付ける方法です。  つまり、クライアントがこのサービスへの接続を確保すると、クライアントとサーバーの間でセッションが確立されます。  クライアントは、サーバー側オブジェクトの単一で一意のインスタンスを、この 1 つのセッション内でのすべてのやり取りに使用することになります。  セッションフル WCF コントラクトは、接続指向ネットワークの要求\/応答パターンに似ています。  
+  
+ このシナリオは、以下の DCOM メソッドによって表されます。  
+  
+```  
+public interface IRemoteService  
+{  
+    IRemoteObject GetObjectByReference();  
+}  
+```  
+  
+### 手順 1: セッションフル WCF サービスのインターフェイスと実装を定義する  
+ 最初に、セッションフル オブジェクトを含む WCF サービスのインターフェイスを定義します。  
+  
+ このコードでは、セッションフル オブジェクトが `ServiceContract` 属性でマークされ、通常の WCF サービスのインターフェイスとして示されています。  さらに、<xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A> プロパティが設定されて、セッションフル サービスとなることが示されています。  
+  
+```  
+  
+[ServiceContract(SessionMode = SessionMode.Allowed)]  
+public interface ISessionBoundObject  
+{  
+    [OperationContract]  
+    string GetCurrentValue();  
+  
+    [OperationContract]  
+    void SetCurrentValue(string value);  
+}  
+```  
+  
+ サービスの実装を次のコードに示します。  
+  
+ サービスは \[ServiceBehavior\] 属性でマークされ、InstanceContextMode プロパティが InstanceContextMode.PerSessions に設定されて、セッションごとにこの型の一意のインスタンスを作成する必要があることを示しています。  
+  
+```  
+[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]  
+    public class MySessionBoundObject : ISessionBoundObject  
+    {  
+        private string _value;  
+  
+        public string GetCurrentValue()  
+        {  
+            return _value;  
+        }  
+  
+        public void SetCurrentValue(string val)  
+        {  
+            _value = val;  
+        }  
+  
+    }  
+  
+```  
+  
+### 手順 2: セッションフル オブジェクトの WCF ファクトリ サービスを定義する  
+ セッションフル オブジェクトを作成するサービスを定義して実装する必要があります。  この方法を次のコードに示します。  このコードは、<xref:System.ServiceModel.EndpointAddress10> オブジェクトとして返される別の WCF サービスを作成します。  これはセッションフル オブジェクトの作成に使用できる、エンドポイントのシリアル化可能な形式です。  
+  
+```  
+[ServiceContract]  
+    public interface ISessionBoundFactory  
+    {  
+        [OperationContract]  
+        EndpointAddress10 GetInstanceAddress();  
+    }  
+  
+```  
+  
+ このサービスの実装を次に示します。  この実装では、セッションフル オブジェクトを作成するためにシングルトン チャネル ファクトリを保持しています。  チャネル ファクトリは、`GetInstanceAddress` が呼び出されるとチャネルを作成し、このチャネルに関連付けられているリモート アドレスをポイントする <xref:System.ServiceModel.EndpointAddress10> オブジェクトを作成します。  <xref:System.ServiceModel.EndpointAddress10> は、値渡しでクライアントに返すことのできるデータ型です。  
+  
+```  
+public class SessionBoundFactory : ISessionBoundFactory  
+    {  
+        public static ChannelFactory<ISessionBoundObject> _factory =   
+            new ChannelFactory<ISessionBoundObject>("sessionbound");  
+  
+        public SessionBoundFactory()  
+        {  
+        }  
+  
+        public EndpointAddress10 GetInstanceAddress()  
+        {  
+            IClientChannel channel = (IClientChannel)_factory.CreateChannel();  
+            return EndpointAddress10.FromEndpointAddress(channel.RemoteAddress);  
+        }  
+    }  
+  
+```  
+  
+### 手順 3: WCF サービスを構成して開始する  
+ これらのサービスをホストするには、サーバーの構成ファイル \(web.config\) に以下を追加する必要があります。  
+  
+1.  セッションフル オブジェクトのエンドポイントを示す `<client>` セクションを追加します。  このシナリオでは、サーバーもクライアントとして機能するので、それが有効となるように構成する必要があります。  
+  
+2.  `<services>` セクションで、ファクトリおよびセッションフル オブジェクトのサービス エンドポイントを宣言します。  これにより、クライアントは、サービス エンドポイントと通信すること、<xref:System.ServiceModel.EndpointAddress10> を取得すること、およびセッションフル チャネルを作成することが可能になります。  
+  
+ これらの設定のある構成ファイルの例を次に示します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <endpoint name="sessionbound"  
+                address="net.tcp://localhost:8081/SessionBoundObject"  
+                binding="netTcpBinding"  
+                contract="Shared.ISessionBoundObject"/>  
+    </client>  
+  
+    <services>  
+      <service name="Server.MySessionBoundObject">  
+        <endpoint address="net.tcp://localhost:8081/SessionBoundObject"  
+                  binding="netTcpBinding"   
+                  contract="Shared.ISessionBoundObject" />  
+      </service>  
+      <service name="Server.SessionBoundFactory">  
+        <endpoint address="net.tcp://localhost:8081/SessionBoundFactory"  
+                  binding="netTcpBinding"   
+                  contract="Shared.ISessionBoundFactory" />  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ 以下の行をコンソール アプリケーションに追加し、サービスを自己ホストして、アプリを開始します。  
+  
+```  
+ServiceHost factoryHost = new ServiceHost(typeof(SessionBoundFactory));  
+factoryHost.Open();  
+  
+ServiceHost sessionBoundServiceHost = new ServiceHost(  
+typeof(MySessionBoundObject));  
+sessionBoundServiceHost.Open();  
+```  
+  
+### 手順 4: クライアントを構成してサービスを呼び出す  
+ プロジェクトのアプリケーション構成ファイル \(app.config\) に以下のエントリを作成して、クライアントが WCF サービスと通信するように構成します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <endpoint name="sessionbound"   
+                address="net.tcp://localhost:8081/SessionBoundObject"   
+                binding="netTcpBinding"   
+                contract="Shared.ISessionBoundObject"/>  
+      <endpoint name="factory"   
+                address="net.tcp://localhost:8081/SessionBoundFactory"   
+                binding="netTcpBinding"   
+                contract="Shared.ISessionBoundFactory"/>  
+    </client>    
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ サービスを呼び出すには、クライアントにコードを追加して、以下を実行するようにします。  
+  
+1.  `ISessionBoundFactory` サービスへのチャネルを作成します。  
+  
+2.  チャネルを使用して `ISessionBoundFactory` サービスを呼び出し、<xref:System.ServiceModel.EndpointAddress10> オブジェクトを取得します。  
+  
+3.  <xref:System.ServiceModel.EndpointAddress10> を使用してチャネルを作成し、セッションフル オブジェクトを取得します。  
+  
+4.  `SetCurrentValue` および `GetCurrentValue` メソッドを呼び出して、複数の呼び出しの間で同じオブジェクト インスタンスが使用されることを示します。  
+  
+```  
+ChannelFactory<ISessionBoundFactory> factory =  
+        new ChannelFactory<ISessionBoundFactory>("factory");  
+  
+ISessionBoundFactory sessionBoundFactory = factory.CreateChannel();  
+  
+EndpointAddress10 address = sessionBoundFactory.GetInstanceAddress();  
+  
+ChannelFactory<ISessionBoundObject> sessionBoundObjectFactory =  
+    new ChannelFactory<ISessionBoundObject>(  
+        new NetTcpBinding(),  
+        address.ToEndpointAddress());  
+  
+ISessionBoundObject sessionBoundObject =  
+        sessionBoundObjectFactory.CreateChannel();  
+  
+sessionBoundObject.SetCurrentValue("Hello");  
+if (sessionBoundObject.GetCurrentValue() == "Hello")  
+{  
+    Console.WriteLine("Session-full instance management works as expected");  
+}  
+```  
+  
+## 参照  
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)   
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)   
+ [双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-reference-net-types-from-com.md b/docs/framework/interop/how-to-reference-net-types-from-com.md
new file mode 100644
index 00000000000..0a6d9cbd2fb
--- /dev/null
+++ b/docs/framework/interop/how-to-reference-net-types-from-com.md
@@ -0,0 +1,58 @@
+---
+title: "方法: COM から .NET 型を参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, インポート (タイプ ライブラリの)"
+  - "COM 相互運用機能, 参照 (.NET 型の)"
+  - "インポート (タイプ ライブラリの)"
+  - "相互運用 (アンマネージ コードとの), インポート (タイプ ライブラリの)"
+  - "相互運用 (アンマネージ コードとの), 参照 (.NET 型の)"
+  - "参照 (.NET 型の)"
+  - "タイプ ライブラリ"
+ms.assetid: 54917f6f-cb18-4103-b622-856b55da93f3
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: COM から .NET 型を参照する
+クライアント アンド サーバー コードの観点からすると、COM と .NET Framework の違いはほとんどわかりません。  Microsoft Visual Basic クライアントでは、オブジェクト ブラウザーを使って .NET オブジェクトを表示できます。オブジェクト ブラウザーには、オブジェクトのメソッドと構文、プロパティ、およびフィールドが、他の COM オブジェクトの場合と同様に公開されます。  
+  
+ タイプ ライブラリのインポート処理は、COM タイプ ライブラリにメタデータをエクスポートする場合と同じツールを使用しますが、C\+\+ クライアントの場合の方がやや複雑です。  アンマネージ C\+\+ クライアントから .NET オブジェクトのメンバーを参照するには、**\#import** ディレクティブが含まれている TLB ファイル \(Tlbexp.exe により生成\) を参照します。  C\+\+ からタイプ ライブラリを参照する場合は、**raw\_interfaces\_only** オプションを指定するか、または基底クラス ライブラリの Mscorlib.tlb 内の定義をインポートする必要があります。  
+  
+### ライブラリをインポートするには  
+  
+-   **\#import** ディレクティブで **raw\_interfaces\_only** オプションを指定します。  次のように記述します。  
+  
+    ```cpp  
+    #import "..\LoanLib\LoanLib.tlb" raw_interfaces_only  
+    ```  
+  
+     または  
+  
+-   Mscorlib.tlb の \#import ディレクティブを含めます。  次のように記述します。  
+  
+    ```cpp  
+    #import "mscorlib.tlb"  
+    #import "..\LoanLib\LoanLib.tlb"  
+    ```  
+  
+## 参照  
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [COM へのアセンブリの登録](../../../docs/framework/interop/registering-assemblies-with-com.md)   
+ [Calling a .NET Object](http://msdn.microsoft.com/ja-jp/40c9626c-aea6-4bad-b8f0-c1de462efd33)   
+ [Deploying an Application for COM Access](http://msdn.microsoft.com/ja-jp/fb63564c-c1b9-4655-a094-a235625882ce)
\ No newline at end of file
diff --git a/docs/framework/interop/how-to-register-primary-interop-assemblies.md b/docs/framework/interop/how-to-register-primary-interop-assemblies.md
new file mode 100644
index 00000000000..5b655b14413
--- /dev/null
+++ b/docs/framework/interop/how-to-register-primary-interop-assemblies.md
@@ -0,0 +1,64 @@
+---
+title: "方法: プライマリ相互運用機能アセンブリを登録する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プライマリ相互運用機能アセンブリ, 登録"
+  - "登録 (プライマリ相互運用機能アセンブリの)"
+ms.assetid: 4b2fcf8a-429d-43ce-8334-e026040be8bb
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: プライマリ相互運用機能アセンブリを登録する
+クラスは、COM 相互運用でのみマーシャリングすることができ、常にインターフェイスとしてマーシャリングされます。  場合によっては、クラスをマーシャリングするために使用されるインターフェイスが、クラス インターフェイスと呼ばれます。  クラス インターフェイスを任意のインターフェイスでオーバーライドする方法のについて詳しくは、「詳細については、[COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)」を参照してください。  
+  
+ .NET Framework アプリケーションから COM の型を使用するすべての開発者は相互運用機能アセンブリを生成できますが、そのようにすると問題が発生します。  開発者が COM タイプ ライブラリをインポートして署名するたびに、その開発者は、別の開発者によってインポートされて署名されたものとは互換性のない一意の型のセットを作成することになります。  この型の非互換性の問題を解決する方法は、各開発者が、ベンダーによって提供されて署名されたプライマリ相互運用機能アセンブリを取得することです。  
+  
+ サードパーティの COM 型を他のアプリケーションに公開する予定の場合は、それが定義するタイプ ライブラリと同じ発行元によって提供されるプライマリ相互運用機能アセンブリを常に使用してください。  保証された型の互換性を提供することに加えて、多くの場合、プライマリ相互運用機能アセンブリは相互運用性を強化するためにベンダーによってカスタマイズされます。  
+  
+ サードパーティの COM 型を公開する予定がない場合でも、プライマリ相互運用機能アセンブリを使用することで、COM コンポーネントとの相互運用のタスクを容易に実行できます。  ただし、この方法では、プライマリ相互運用機能アセンブリで定義された型に対してベンダーが加える可能性のある変更から隔離されることはありません。  使用するアプリケーションでそのような隔離が必要な場合は、プライマリ相互運用機能アセンブリを使用する代わりに独自の相互運用アセンブリを生成してください。  
+  
+ 取得したすべてのプライマリ相互運用機能アセンブリを開発コンピューターに登録してからでなければ、[!INCLUDE[vsprvsext](../../../includes/vsprvsext-md.md)] でそれらを参照できません。  Visual Studio は、初めて COM タイプ ライブラリから型を参照するときに、プライマリ相互運用機能アセンブリを検索して使用します。  Visual Studio は、タイプ ライブラリに関連付けられているプライマリ相互運用機能アセンブリが見つからない場合、それを取得するように求めるプロンプトを出すか、または相互運用機能アセンブリを代わりに作成することを申し出ます。  同じように、[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) も、レジストリを使用してプライマリ相互運用機能アセンブリを見つけます。  
+  
+ Visual Studio を使用する予定がない限り、プライマリ相互運用機能アセンブリを登録する必要はありませんが、登録には次の 2 つの利点があります。  
+  
+-   登録されているプライマリ相互運用機能アセンブリは、元のタイプ ライブラリのレジストリ キーの下で明白にマークされます。  登録は、コンピューター上のプライマリ相互運用機能アセンブリを検索するための最善の方法です。  
+  
+-   将来のいつか、Visual Studio を使用して登録されていないプライマリ相互運用機能アセンブリのある型を参照する場合に、間違えて新しい相互運用機能アセンブリを生成して使用してしまうことを回避できます。  
+  
+ [アセンブリ登録ツール \(Regasm.exe\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) を使用して、プライマリ相互運用機能アセンブリを登録します。  
+  
+### プライマリ相互運用機能アセンブリを登録する方法  
+  
+1.  コマンド プロンプトで次のように入力します。  
+  
+     **regasm** *assemblyname*  
+  
+     このコマンドで、*assemblyname* は登録されているアセンブリのファイル名です。  Regasm.exe は、元のタイプ ライブラリと同じレジストリ キーの下に、プライマリ相互運用機能アセンブリの項目を追加します。  
+  
+## 使用例  
+ 次の例は、`CompanyA.UtilLib.dll` プライマリ相互運用機能アセンブリを登録します。  
+  
+```  
+regasm CompanyA.UtilLib.dll  
+```  
+  
+## 参照  
+ [Programming with Primary Interop Assemblies](http://msdn.microsoft.com/ja-jp/306fa1d6-0703-4004-9e93-d0a57f1be81e)   
+ [Locating Primary Interop Assemblies](http://msdn.microsoft.com/ja-jp/d6768e4b-cd80-414d-a4f8-05d979eb393b)   
+ [Redistributing Primary Interop Assemblies](http://msdn.microsoft.com/ja-jp/e76384f0-d631-474c-bdbd-13884cba0265)
\ No newline at end of file
diff --git a/docs/framework/interop/importing-a-type-library-as-an-assembly.md b/docs/framework/interop/importing-a-type-library-as-an-assembly.md
new file mode 100644
index 00000000000..1f7aaed00d8
--- /dev/null
+++ b/docs/framework/interop/importing-a-type-library-as-an-assembly.md
@@ -0,0 +1,94 @@
+---
+title: "タイプ ライブラリのアセンブリとしてのインポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "COM 相互運用機能, インポート (タイプ ライブラリの)"
+  - "カスタム ラッパー"
+  - "公開 (.NET Framework に COM コンポーネントを)"
+  - "インポート (タイプ ライブラリの)"
+  - "相互運用 (アンマネージ コードとの), 公開 (COM コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), インポート (タイプ ライブラリの)"
+  - "メタデータ"
+  - "タイプ ライブラリ"
+  - "タイプ ライブラリ インポーター"
+  - "型のメタデータ"
+  - "TypeLibConverter クラス, インポート (タイプ ライブラリをアセンブリとして)"
+ms.assetid: d1898229-cd40-426e-a275-f3eb65fbc79f
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# タイプ ライブラリのアセンブリとしてのインポート
+COM 型の定義は、通常はタイプ ライブラリに存在します。  これに対し、CLS 準拠のコンパイラは、型メタデータをアセンブリ内に生成します。  型情報に関するこれら 2 つのソースは、まったく異なっています。  このトピックでは、タイプ ライブラリからメタデータを生成する方法を説明します。  結果として生成されるアセンブリは相互運用機能アセンブリと呼ばれ、それに含まれる型情報によって .NET Framework アプリケーションは COM 型を使用できます。  
+  
+ この型情報をアプリケーションで使用する方法には、次の 2 つがあります。  
+  
+-   デザイン時のみの相互運用機能アセンブリを使用する: [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、相互運用機能アセンブリから実行可能ファイルに型情報を埋め込むようにコンパイラに指示できます。  コンパイラは、アプリケーションが使用する型情報のみを埋め込みます。  アプリケーションで相互運用機能アセンブリを配置する必要はありません。  この手法を使用することをお勧めします。  
+  
+-   相互運用機能アセンブリを配置する: 相互運用機能アセンブリへの標準の参照を作成できます。  この場合、アプリケーションで相互運用機能アセンブリを配置する必要があります。  この手法を採用する場合に、プライベートの COM コンポーネントを使用しないときは、必ず、マネージ コードに組み込む COM コンポーネントの作成者が発行したプライマリ相互運用機能アセンブリ \(PIA\) を参照してください。  プライマリ相互運用機能アセンブリの作成と使用の詳細については、「[プライマリ相互運用機能アセンブリ](http://msdn.microsoft.com/ja-jp/b977a8be-59a0-40a0-a806-b11ffba5c080)」を参照してください。  
+  
+ デザイン時のみの相互運用機能アセンブリを使用するとき、COM コンポーネントの作成者が発行したプライマリ相互運用機能アセンブリから型情報を埋め込むことができます。  ただし、アプリケーションで相互運用機能アセンブリを配置する必要はありません。  
+  
+ COM コンポーネントのすべての機能を使用するアプリケーションはほとんどないため、デザイン時のみの相互運用機能アセンブリを使用するとアプリケーションのサイズが小さくなります。  コンパイラは、型情報を埋め込むとき、非常に効率的に処理を実行します。アプリケーションが COM インターフェイスの一部のメソッドしか使用しない場合、コンパイラは使用されないメソッドの埋め込みは行いません。  埋め込み型情報を持つアプリケーションが他の同様のアプリケーションと対話したり、プライマリ相互運用機能アセンブリを使用するアプリケーションと対話したりするとき、共通言語ランタイムは型等価性の規則を使用して、同じ名前を持つ 2 つの型が同じ COM 型を表しているかどうかを確認します。  COM オブジェクトを使用するために、これらの規則について理解しておく必要はありません。  この規則に関心がある場合は、「[型の等価性と埋め込まれた相互運用機能型](../../../docs/framework/interop/type-equivalence-and-embedded-interop-types.md)」を参照してください。  
+  
+## メタデータの生成  
+ COM タイプ ライブラリは、Loanlib.tlb などの .tlb 拡張子を持つスタンドアロンのファイルである場合があります。  .dll ファイルまたは .exe ファイルのリソース セクションに埋め込まれるタイプ ライブラリもあります。  タイプ ライブラリ情報のその他のソースとして、.olb ファイルと .ocx ファイルがあります。  
+  
+ 対象の COM 型の実装を含むタイプ ライブラリの場所を特定したら、次のいずれかの方法で型メタデータを格納する相互運用機能アセンブリを生成できます。  
+  
+-   Visual Studio  
+  
+     Visual Studio を使用して、タイプ ライブラリの COM 型をアセンブリのメタデータに自動的に変換します。  手順については、「[方法: タイプ ライブラリへの参照を追加する](../../../docs/framework/interop/how-to-add-references-to-type-libraries.md)」および「[チュートリアル: Microsoft Office アセンブリからの型情報の埋め込み](../Topic/Walkthrough:%20Embedding%20Type%20Information%20from%20Microsoft%20Office%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+-   [タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)  
+  
+     タイプ ライブラリ インポーターには、生成される相互運用ファイル内のメタデータを調整するコマンド ライン オプションが用意されていて、既存のタイプ ライブラリから型をインポートし、相互運用機能アセンブリおよび名前空間を生成します。  手順については、「[方法 : 相互運用アセンブリをタイプ ライブラリから生成する](../../../docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md)」を参照してください。  
+  
+-   <xref:System.Runtime.InteropServices.TypeLibConverter?displayProperty=fullName> クラス  
+  
+     このクラスは、タイプ ライブラリ内のコクラスとインターフェイスをアセンブリ内のメタデータに変換するメソッドを提供します。  これは、Tlbimp.exe と同じメタデータ出力を生成します。  ただし、<xref:System.Runtime.InteropServices.TypeLibConverter> クラスは、Tlbimp.exe とは異なり、インメモリ タイプ ライブラリをメタデータに変換できます。  
+  
+-   カスタム ラッパー  
+  
+     タイプ ライブラリが利用できないか、または無効である場合には、1 つの選択肢として、マネージ ソース コードでクラスまたはインターフェイスの複製定義を作成する方法があります。  その後で、ランタイムを対象とするコンパイラでソース コードをコンパイルし、アセンブリ内にメタデータを生成します。  
+  
+     COM 型を手動で定義するには、次の項目にアクセスできる必要があります。  
+  
+    -   定義するコクラスおよびインターフェイスの詳細な説明。  
+  
+    -   適切な .NET Framework クラス定義を生成できる、C\# コンパイラなどのコンパイラ。  
+  
+    -   タイプ ライブラリからアセンブリへの変換規則に関する知識。  
+  
+     カスタム ラッパーを作成することは、高度な手法です。  カスタム ラッパーを生成する方法の詳細については、「[標準ラッパーのカスタマイズ](http://msdn.microsoft.com/ja-jp/c40d089b-6a3c-41b5-a20d-d760c215e49d)」を参照してください。  
+  
+ COM 相互運用機能のインポート プロセスの詳細については、「[タイプ ライブラリからアセンブリへの変換の要約](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)」を参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.TypeLibConverter>   
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)   
+ [Type Library to Assembly Conversion Summary](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)   
+ [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)   
+ [Customizing Standard Wrappers](http://msdn.microsoft.com/ja-jp/c40d089b-6a3c-41b5-a20d-d760c215e49d)   
+ [Using COM Types in Managed Code](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)   
+ [相互運用プロジェクトのコンパイル](../../../docs/framework/interop/compiling-an-interop-project.md)   
+ [相互運用アプリケーションの配置](../../../docs/framework/interop/deploying-an-interop-application.md)   
+ [方法: タイプ ライブラリへの参照を追加する](../../../docs/framework/interop/how-to-add-references-to-type-libraries.md)   
+ [方法: 相互運用機能アセンブリをタイプ ライブラリから生成する](../../../docs/framework/interop/how-to-generate-interop-assemblies-from-type-libraries.md)   
+ [チュートリアル: Microsoft Office アセンブリからの型情報の埋め込み](../Topic/Walkthrough:%20Embedding%20Type%20Information%20from%20Microsoft%20Office%20Assemblies%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/interop/index.md b/docs/framework/interop/index.md
new file mode 100644
index 00000000000..addc3536f72
--- /dev/null
+++ b/docs/framework/interop/index.md
@@ -0,0 +1,64 @@
+---
+title: "アンマネージ コードとの相互運用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 相互運用 (アンマネージ コードとの)"
+  - "コンポーネント [.NET Framework], 相互運用 (アンマネージ コードとの)"
+  - "相互運用 (アンマネージ コードとの)"
+  - "相互運用 (アンマネージ コードとの), 相互運用の概要"
+  - "マネージ コード, 相互運用 (アンマネージ コードとの)"
+  - "アンマネージ コード"
+  - "アンマネージ コード, 相互運用"
+ms.assetid: ccb68ce7-b0e9-4ffb-839d-03b1cd2c1258
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# アンマネージ コードとの相互運用
+.NET Framework は、COM コンポーネント、COM\+ サービス、外部のタイプ ライブラリ、および多数のオペレーティング システム サービスとの対話を促進します。  データ型、メソッド シグネチャ、およびエラー処理機構は、マネージ オブジェクト モデルとアンマネージ オブジェクト モデルとでは異なります。  .NET Framework コンポーネントとアンマネージ コードとの相互運用を単純化し、.NET Framework への移行を円滑に行うため、共通言語ランタイムでは、これらのオブジェクト モデルの相違点がクライアントからもサーバーからも認識できないようになっています。  
+  
+ このランタイムの制御下で実行されるコードをマネージ コードと呼びます。  それに対し、このランタイムの外部で実行されるコードをアンマネージ コードと呼びます。  アンマネージ コードの例としては、COM コンポーネント、ActiveX インターフェイス、Win32 API 関数があります。  
+  
+## このセクションの内容  
+ [Interoperating with Unmanaged Code How\-to Topics](http://msdn.microsoft.com/ja-jp/ec21c6e1-e233-4cd9-95ae-b9b9cf807f9d)  
+ 概念を説明したドキュメントに用意されている、アンマネージ コードによる相互運用性に関する方法を説明したトピックへのすべてのリンクを示します。  
+  
+ [.NET Framework への COM コンポーネントの公開](../../../docs/framework/interop/exposing-com-components.md)  
+ .NET Framework アプリケーションから COM コンポーネントを使用する方法について説明します。  
+  
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)  
+ COM アプリケーションから .NET Framework コンポーネントを使用する方法について説明します。  
+  
+ [アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)  
+ プラットフォーム呼び出しを使ってアンマネージ DLL 関数を呼び出す方法を説明します。  
+  
+ [相互運用のためのデザインの考慮事項](http://msdn.microsoft.com/ja-jp/b59637f6-fe35-40d6-ae72-901e7a707689)  
+ 統合される COM コンポーネントを記述するためのヒントを示します。  
+  
+ [相互運用マーシャリング](../../../docs/framework/interop/interop-marshaling.md)  
+ COM 相互運用機能とプラットフォーム呼び出しによるマーシャリングについて説明します。  
+  
+ [方法: HRESULT に例外を割り当てる](../../../docs/framework/interop/how-to-map-hresults-and-exceptions.md)  
+ 例外と HRESULT 間の対応付けについて説明します。  
+  
+ [Interoperating Using Generic Types](http://msdn.microsoft.com/ja-jp/26b88e03-085b-4b53-94ba-a5a9c709ce58)  
+ ジェネリック型を COM 相互運用で使用した場合の動作について説明します。  
+  
+## 関連項目  
+ [Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)  
+ .NET Framework アプリケーションへの COM コンポーネントの組み込みに関する詳細な情報へのリンクを提供します。
\ No newline at end of file
diff --git a/docs/framework/interop/interop-marshaling.md b/docs/framework/interop/interop-marshaling.md
new file mode 100644
index 00000000000..bb970e1d965
--- /dev/null
+++ b/docs/framework/interop/interop-marshaling.md
@@ -0,0 +1,175 @@
+---
+title: "相互運用マーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用マーシャリング"
+  - "相互運用マーシャリング, 相互運用マーシャリングの概要"
+  - "マーシャリング, COM 相互運用機能"
+ms.assetid: 115f7a2f-d422-4605-ab36-13a8dd28142a
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 相互運用マーシャリング
+相互運用マーシャリングは、メソッド引数と戻り値によって、呼び出し中にマネージ メモリとアンマネージ メモリの間でデータを渡す方法を制御します。  相互運用マーシャリングは、共通言語ランタイムのマーシャリング サービスによって実行される、ランタイム アクティビティです。  
+  
+ ほとんどのデータ型は、マネージとアンマネージの両方のメモリに共通の表現があります。  相互運用マーシャラーは、これらの型を処理します。  その他の型は、あいまいな型であるか、マネージ メモリでまったく表現されていない型である可能性があります。  
+  
+ あいまいな型は、複数のアンマネージ表現が 1 つのマネージ型にマップされていたり、配列のサイズなどの型情報が欠落していたりします。  あいまいな型の場合、マーシャラーは、既定の表現と複数の表現が存在するときのための代替表現とを提供します。  あいまいな型をマーシャリングする方法について、マーシャラーに明示的な指示を与えることができます。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [プラットフォーム呼び出しと COM 相互運用のモデル](#platform_invoke_and_com_interop_models)  
+  
+-   [マーシャリングと COM アパートメント](#marshaling_and_com_apartments)  
+  
+-   [リモートの呼び出しのマーシャリング](#marshaling_remote_calls)  
+  
+-   [関連トピック](#related_topics)  
+  
+-   [参照](#reference)  
+  
+<a name="platform_invoke_and_com_interop_models"></a>   
+## プラットフォーム呼び出しと COM 相互運用のモデル  
+ 共通言語ランタイムは、アンマネージ コードと相互運用するために、次の 2 つのメカニズムを提供します。  
+  
+-   プラットフォーム呼び出しにより、マネージ コードは、アンマネージ ライブラリからエクスポートされた関数を呼び出すことができます。  
+  
+-   COM 相互運用により、マネージ コードは、インターフェイスを介してコンポーネント オブジェクト モデル \(COM\) オブジェクトと対話できます。  
+  
+ プラットフォーム呼び出しと COM 相互運用はどちらも、必要な場合に、相互運用マーシャリングを使用して呼び出し元と呼び出し先との間でメソッド引数を正確に移動します。  次の図が示すように、プラットフォーム呼び出しメソッドの呼び出しはマネージ コードからアンマネージ コードにフローして、[コールバック関数](../../../docs/framework/interop/callback-functions.md)が関係していない限りその逆の方向にはフローしません。  プラットフォーム呼び出しの呼び出しはマネージ コードからアンマネージ コードにのみフローしますが、データは入出力パラメーターとして双方向にフローできます。  COM 相互運用のメソッド呼び出しは、どちらの方向にもフローできます。  
+  
+ ![プラットフォーム呼び出し](../../../docs/framework/interop/media/interopmarshaling.png "interopmarshaling")  
+プラットフォーム呼び出しと COM 相互運用の呼び出しフロー  
+  
+ 最下位のレベルでは、どちらのメカニズムも同じ相互運用マーシャリング サービスを使用します。ただし、特定のデータ型は、COM 相互運用またはプラットフォーム呼び出しでのみサポートされます。  詳しくは、「[既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="marshaling_and_com_apartments"></a>   
+## マーシャリングと COM アパートメント  
+ 相互運用マーシャラーは、共通言語ランタイム ヒープとアンマネージ ヒープの間でデータをマーシャリングします。  呼び出し元と呼び出し先がデータの同じインスタンスで機能できないときには常に、マーシャリングが生じます。  相互運用マーシャラーにより、呼び出し元と呼び出し先がデータの独自のコピーを持っている場合でも、見かけ上は同じデータに対して機能しているようにすることが可能になります。  
+  
+ COM には、COM アパートメント間や異なる COM プロセス間でデータをマーシャリングするマーシャラーもあります。  同じ COM アパートメント内でマネージ コードとアンマネージ コード間の呼び出しをする場合は、相互運用マーシャラーが関連する唯一のマーシャラーとなります。  異なる COM アパートメントや異なるプロセス内でマネージ コードとアンマネージ コード間の呼び出しをする場合は、相互運用マーシャラーと COM マーシャラーの両方が関連します。  
+  
+### COM クライアントとマネージ サーバー  
+ [Regasm.exe \(アセンブリ登録ツール\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) によって登録されたタイプ ライブラリのあるエクスポートされたマネージ サーバーでは、`ThreadingModel` レジストリ エントリが `Both` に設定されています。  この値は、シングルスレッド アパートメント \(STA\) またはマルチスレッド アパートメント \(MTA\) で、サーバーをアクティブ化できることを示します。  次の表に示すように、サーバー オブジェクトは、その呼び出し元と同じアパートメント内に作成されます。  
+  
+|COM クライアント|.NET サーバー|マーシャリングの要件|  
+|----------------|---------------|----------------|  
+|STA|`Both` は STA になります。|同じアパートメントでのマーシャリング。|  
+|MTA|`Both` は MTA になります。|同じアパートメントでのマーシャリング。|  
+  
+ クライアントとサーバーが同じアパートメント内にあるため、相互運用マーシャリング サービスはすべてのデータのマーシャリングを自動的に処理します。  次の図は、同じ COM スタイル アパートメント内のマネージ ヒープとアンマネージ ヒープの間で機能している、相互運用マーシャリング サービスを示しています。  
+  
+ ![相互運用マーシャリング](../../../docs/framework/interop/media/interopheap.gif "interopheap")  
+同じアパートメントでのマーシャリングのプロセス  
+  
+ マネージ サーバーをエクスポートする予定の場合は、サーバーのアパートメントが COM クライアントによって決定されることに注意してください。  MTA 内で初期化された COM クライアントから呼び出されるマネージ サーバーは、スレッド セーフを確保する必要があります。  
+  
+### マネージ クライアントと COM サーバー  
+ マネージ クライアントのアパートメントの既定の設定は MTA です。ただし、.NET クライアントのアプリケーションの種類によっては、既定の設定が変更されることがあります。  たとえば、[!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] クライアントのアパートメントの設定は STA です。  <xref:System.STAThreadAttribute?displayProperty=fullName>、<xref:System.MTAThreadAttribute?displayProperty=fullName>、<xref:System.Threading.Thread.ApartmentState%2A?displayProperty=fullName> プロパティ、または <xref:System.Web.UI.Page.AspCompatMode%2A?displayProperty=fullName> プロパティを使用して、マネージ クライアントのアパートメントの設定を変更できます。  
+  
+ コンポーネントの作成者は、COM サーバーのスレッド アフィニティを設定します。  次の表は、.NET クライアントと COM サーバーのアパートメント設定の組み合わせを示しています。  また、結果として生じる、組み合わせのためのマーシャリング要件も示しています。  
+  
+|.NET クライアント|COM サーバー|マーシャリングの要件|  
+|-----------------|--------------|----------------|  
+|MTA \(既定\)|MTA<br /><br /> STA|相互運用マーシャリング。<br /><br /> 相互運用と COM マーシャリング。|  
+|STA|MTA<br /><br /> STA|相互運用と COM マーシャリング。<br /><br /> 相互運用マーシャリング。|  
+  
+ マネージ クライアントとアンマネージ サーバーが同じアパートメント内にあるとき、相互運用マーシャリング サービスはすべてのデータのマーシャリングを処理します。  ただし、クライアントとサーバーが異なるアパートメント内で初期化される場合は、COM マーシャリングも必要となります。  次の図は、アパートメント間の呼び出しの要素を示しています。  
+  
+ ![COM マーシャリング](../../../docs/framework/interop/media/singleprocessmultapt.gif "singleprocessmultapt")  
+.NET クライアントと COM オブジェクト間でのアパートメント間の呼び出し  
+  
+ アパートメント間のマーシャリングでは、次の操作を実行できます。  
+  
+-   アパートメント間のマーシャリングのオーバーヘッドを受け入れます。これは、境界を越える呼び出しが多くがある場合にのみ認識されます。  呼び出しがアパートメントの境界を正常に越えるようにするためには、COM コンポーネントのタイプ ライブラリを登録する必要があります。  
+  
+-   クライアント スレッドを STA または MTA に設定して、メイン スレッドを変更します。  たとえば、C\# クライアントが多くの STA COM コンポーネントを呼び出す場合には、メイン スレッドを STA に設定してアパートメント間のマーシャリングを回避できます。  
+  
+    > [!NOTE]
+    >  C\# クライアントのスレッドを STA に設定すると、MTA COM コンポーネントへの呼び出しにはアパートメント間のマーシャリングが必要となります。  
+  
+ アパートメント モデルを明示的に選択する方法については、「[Managed and Unmanaged Threading](http://msdn.microsoft.com/ja-jp/db425c20-4b2f-4433-bf96-76071c7881e5)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="marshaling_remote_calls"></a>   
+## リモートの呼び出しのマーシャリング  
+ アパートメント間のマーシャリングの場合と同様に、COM マーシャリングは、オブジェクトが別個のプロセス内に存在するときには常に、マネージ コードとアンマネージ コード間の各呼び出しに関与します。  次に例を示します。  
+  
+-   リモート ホスト上のマネージ サーバーを呼び出す COM クライアントは、分散 COM \(DCOM\) を使用します。  
+  
+-   リモート ホスト上の COM サーバーを呼び出すマネージ クライアントは、DCOM を使用します。  
+  
+ 次の図は、相互運用マーシャリングと COM マーシャリングが、プロセスとホストの境界を越えて通信チャネルを提供する方法を示しています。  
+  
+ ![COM マーシャリング](../../../docs/framework/interop/media/interophost.gif "interophost")  
+プロセス間のマーシャリング  
+  
+### ID の保持  
+ 共通言語ランタイムは、マネージ参照とアンマネージ参照の ID を保持します。  次の図は、プロセスとホストの境界を越えている、直接アンマネージ参照 \(上の行\) と直接マネージ参照 \(下の行\) のフローを示しています。  
+  
+ ![COM 呼び出し可能ラッパーとランタイム呼び出し可能ラッパー](../../../docs/framework/interop/media/interopdirectref.gif "interopdirectref")  
+プロセスとホストの境界を越えて渡される参照  
+  
+ この図では:  
+  
+-   アンマネージ クライアントは、COM オブジェクトへの参照を、リモート ホストからその参照を取得するマネージ オブジェクトから取得します。  リモート処理のメカニズムは DCOM です。  
+  
+-   マネージ クライアントは、マネージ オブジェクトへの参照を、リモート ホストからその参照を取得している COM オブジェクトから取得します。  リモート処理のメカニズムは DCOM です。  
+  
+    > [!NOTE]
+    >  マネージ サーバーのエクスポート済みタイプ ライブラリを登録する必要があります。  
+  
+ 呼び出し元と呼び出し先の間のプロセス境界の数は関連していません。同じ直接参照が、イン プロセスおよびアウト プロセスの呼び出しで発生します。  
+  
+### マネージ リモート処理  
+ ランタイムは、プロセスとホストの境界を越えてマネージ オブジェクト間に通信チャネルを確立するために使用できる、マネージ リモート処理も提供します。  次の図に示すように、マネージ リモート処理は、通信コンポーネントの間のファイアウォールに対応できます。  
+  
+ ![SOAP または TcpChannel](../../../docs/framework/interop/media/interopremotesoap.gif "interopremotesoap")  
+SOAP または TcpChannel クラスを使用するファイアウォールを越えたリモート呼び出し  
+  
+ [サービス コンポーネント](http://msdn.microsoft.com/ja-jp/f109ee24-81ad-4d99-9892-51ac6f34978c)と COM の間の呼び出しなど、一部のアンマネージ呼び出しは SOAP を介して伝達できます。  マネージ リモート処理の使用方法について詳しくは、「[.NET リモート処理の概要](http://msdn.microsoft.com/ja-jp/eccb1d31-0a22-417a-97fd-f4f1f3aa4462)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[既定のマーシャリングの動作](../../../docs/framework/interop/default-marshaling-behavior.md)|相互運用マーシャリング サービスがデータのマーシャリングに使用する規則について説明します。|  
+|[プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)|メソッドのパラメーターを宣言してアンマネージ ライブラリによってエクスポートされた関数に引数を渡す方法について説明します。|  
+|[COM 相互運用機能によるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-com-interop.md)|COM ラッパーをカスタマイズしてマーシャリング動作を変更する方法について説明します。|  
+|[方法: マネージ コード DCOM を WCF に移行する](../../../docs/framework/interop/how-to-migrate-managed-code-dcom-to-wcf.md)|DCOM から WCF に移行する方法について説明します。|  
+|[方法: HRESULT に例外を割り当てる](../../../docs/framework/interop/how-to-map-hresults-and-exceptions.md)|HRESULT にカスタム例外をマップする方法について説明し、各 HRESULT から .NET Framework での同等の例外クラスへの完全なマッピングを示します。|  
+|[Interoperating Using Generic Types](http://msdn.microsoft.com/ja-jp/26b88e03-085b-4b53-94ba-a5a9c709ce58)|COM 相互運用性のジェネリック型を使用するとき、どのアクションがサポートされるかについて説明します。|  
+|[アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)|共通言語ランタイムが提供する相互運用サービスについて説明します。|  
+|[Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)|.NET Framework アプリケーションに COM コンポーネントを組み込む方法についての詳細情報へのリンクを示します。|  
+|[Design Considerations for Interoperation](http://msdn.microsoft.com/ja-jp/b59637f6-fe35-40d6-ae72-901e7a707689)|統合 COM コンポーネントを記述するためのヒントを示します。|  
+|[.NET リモート処理](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)|.NET Framework でリモート通信に利用できるさまざまな方法について説明します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="reference"></a>   
+## 参照  
+ <xref:System.Runtime.InteropServices?displayProperty=fullName>  
+  
+ [ページのトップへ](#top)
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-a-delegate-as-a-callback-method.md b/docs/framework/interop/marshaling-a-delegate-as-a-callback-method.md
new file mode 100644
index 00000000000..6e90af7d083
--- /dev/null
+++ b/docs/framework/interop/marshaling-a-delegate-as-a-callback-method.md
@@ -0,0 +1,64 @@
+---
+title: "コールバック メソッドとしてのデリゲートのマーシャ リング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, Callback サンプル"
+  - "マーシャリング, Callback サンプル"
+ms.assetid: 6ddd7866-9804-4571-84de-83f5cc017a5a
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# コールバック メソッドとしてのデリゲートのマーシャ リング
+このサンプルでは、関数ポインターを要求するアンマネージ関数にデリゲートを渡す方法を示します。  デリゲートは、メソッドへの参照を保持できるクラスのことであり、タイプ セーフ関数ポインターまたはコールバック関数と等価です。  
+  
+> [!NOTE]
+>  呼び出しの中でデリゲートを使用する場合、共通言語ランタイムは、呼び出しの間にデリゲートがガベージ コレクトされないように保護します。  ただし、呼び出しが完了した後で使用するためにアンマネージ関数がデリゲートを格納する場合には、アンマネージ関数がデリゲートを終了するまでの間、手動でガベージ コレクションを防ぐ必要があります。  詳細については、「[HandleRef のサンプル](http://msdn.microsoft.com/ja-jp/ab23b04e-1d53-4ec7-b27a-e892d9298959)」および「[GCHandle のサンプル](http://msdn.microsoft.com/ja-jp/6acce798-0385-4ded-a790-77da842c113f)」を参照してください。  
+  
+ Callback のサンプルで使用するアンマネージ関数とその関数宣言を次に示します。  
+  
+-   PinvokeLib.dll からエクスポートされる **TestCallBack**  
+  
+    ```  
+    void TestCallBack(FPTR pf, int value);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestCallBack2**  
+  
+    ```  
+    void TestCallBack2(FPTR2 pf2, char* value);  
+    ```  
+  
+ [PinvokeLib.dll](http://msdn.microsoft.com/ja-jp/5d1438d7-9946-489d-8ede-6c694a08f614) はカスタム アンマネージ ライブラリであり、上記の関数に関する実装を含みます。  
+  
+ このサンプルでは、`LibWrap` クラスには `TestCallBack` メソッドと `TestCallBack2` メソッドに関するマネージ プロトタイプが含まれます。  どちらのメソッドも、コールバック関数にパラメーターとしてデリゲートを渡します。  デリゲートのシグネチャは、その参照先メソッドのシグネチャと一致する必要があります。  たとえば、デリゲートの `FPtr` と `FPtr2` は、`DoSomething` メソッドおよび `DoSomething2` メソッドと同じシグネチャを持ちます。  
+  
+## プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#37](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/callback.cpp#37)]
+ [!code-csharp[Conceptual.Interop.Marshaling#37](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/callback.cs#37)]
+ [!code-vb[Conceptual.Interop.Marshaling#37](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/callback.vb#37)]  
+  
+## 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#38](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/callback.cpp#38)]
+ [!code-csharp[Conceptual.Interop.Marshaling#38](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/callback.cs#38)]
+ [!code-vb[Conceptual.Interop.Marshaling#38](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/callback.vb#38)]  
+  
+## 参照  
+ [Miscellaneous Marshaling Samples](http://msdn.microsoft.com/ja-jp/a915c948-54e9-4d0f-a525-95a77fd8ed70)   
+ [Platform Invoke Data Types](http://msdn.microsoft.com/ja-jp/16014d9f-d6bd-481e-83f0-df11377c550f)   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-classes-structures-and-unions.md b/docs/framework/interop/marshaling-classes-structures-and-unions.md
new file mode 100644
index 00000000000..99eff0a435a
--- /dev/null
+++ b/docs/framework/interop/marshaling-classes-structures-and-unions.md
@@ -0,0 +1,301 @@
+---
+title: "クラス、構造体、および共用体のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, クラス"
+  - "データ マーシャリング, プラットフォーム呼び出し"
+  - "データ マーシャリング, サンプル"
+  - "データ マーシャリング, 構造体"
+  - "データ マーシャリング, 共用体"
+  - "マーシャリング, クラス"
+  - "マーシャリング, プラットフォーム呼び出し"
+  - "マーシャリング, サンプル"
+  - "マーシャリング, 構造体"
+  - "マーシャリング, 共用体"
+  - "プラットフォーム呼び出し, マーシャリング (データの)"
+ms.assetid: 027832a2-9b43-4fd9-9b45-7f4196261a4e
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# クラス、構造体、および共用体のマーシャリング
+クラスと構造体は、.NET Framework では類似しています。  どちらもフィールド、プロパティ、およびイベントを持つことができます。  静的メソッドと非静的メソッドを持つこともできます。  1 つの重要な違いは、構造体は値型でクラスは参照型であることです。  
+  
+ 次の表は、クラス、構造体、および共用体のマーシャリング オプションをリストし、それぞれの使用方法を説明し、対応するプラットフォーム呼び出しサンプルへのリンクを示しています。  
+  
+|種類|説明|サンプル|  
+|--------|--------|----------|  
+|値によるクラス。|整数のメンバーを含むクラスは、管理対象クラスと同じように、In\/Out パラメーターとして渡します。|SysTime サンプル|  
+|値による構造体。|In パラメーターとして構造体を渡します。|構造体のサンプル|  
+|参照による構造体|In\/Out パラメーターとして構造体を渡します。|OSInfo サンプル|  
+|入れ子になった構造体を含む構造体 \(フラット化\)。|アンマネージ関数で入れ子になった構造体を含む構造体を表すクラスを渡します。  マネージ プロトタイプで構造体は 1 つの大きな構造体にフラット化されます。|FindFile サンプル|  
+|別の構造体へのポインターを持つ構造体。|2 番目の構造体へのポインターをメンバーとして含む構造体を渡します。|構造体のサンプル|  
+|値による整数のある構造体の配列。|In\/Out パラメーターとして整数のみを含む構造体の配列を渡します。  配列のメンバーを変更することができます。|配列のサンプル|  
+|参照による整数と文字列のある構造体の配列。|Out パラメーターとして整数と文字列を含む構造体の配列を渡します。  呼び出された関数は、配列のメモリを割り当てます。|OutArrayOfStructs のサンプル|  
+|値型の共用体。|値型 \(整数および倍精度\) の共用体を渡します。|Unions サンプル|  
+|混合型の共用体。|混合型 \(整数および文字列\) の共用体を渡します。|Unions サンプル|  
+|構造体の null 値。|値型への参照の代わりに null 参照 \(Visual Basic では **Nothing**\) を渡します。|HandleRef のサンプル|  
+  
+## 構造体のサンプル  
+ このサンプルでは、2 番目の構造体を指す構造体を渡す方法、埋め込み構造体のある構造体を渡す方法、および埋め込み配列のある構造体を渡す方法を示します。  
+  
+ Structs のサンプルで使用するアンマネージ関数とその元の関数宣言を次に示します。  
+  
+-   PinvokeLib.dll からエクスポートされる **TestStructInStruct**  
+  
+    ```  
+    int TestStructInStruct(MYPERSON2* pPerson2);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestStructInStruct3**  
+  
+    ```  
+    void TestStructInStruct3(MYPERSON3 person3);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestArrayInStruct**  
+  
+    ```  
+    void TestArrayInStruct( MYARRAYSTRUCT* pStruct );  
+    ```  
+  
+ [PinvokeLib.dll](http://msdn.microsoft.com/ja-jp/5d1438d7-9946-489d-8ede-6c694a08f614) はカスタム アンマネージ ライブラリであり、上記の関数および 4 つの構造体 **MYPERSON**、**MYPERSON2**、**MYPERSON3**、および **MYARRAYSTRUCT** に関する実装を含んでいます。  これらの構造体には次の要素が含まれます。  
+  
+```  
+typedef struct _MYPERSON  
+{  
+   char* first;   
+   char* last;   
+} MYPERSON, *LP_MYPERSON;  
+  
+typedef struct _MYPERSON2  
+{  
+   MYPERSON* person;  
+   int age;   
+} MYPERSON2, *LP_MYPERSON2;  
+  
+typedef struct _MYPERSON3  
+{  
+   MYPERSON person;  
+   int age;   
+} MYPERSON3;  
+  
+typedef struct _MYARRAYSTRUCT  
+{  
+   bool flag;  
+   int vals[ 3 ];   
+} MYARRAYSTRUCT;  
+```  
+  
+ マネージ `MyPerson`、 `MyPerson2`、`MyPerson3`、および `MyArrayStruct` 構造体には、以下の特性があります。  
+  
+-   `MyPerson` には文字列メンバーだけが含まれます。  [CharSet](../../../docs/framework/interop/specifying-a-character-set.md) フィールドは、アンマネージ関数に渡されるとき、文字列を ANSI 形式に設定します。  
+  
+-   `MyPerson2` には、`MyPerson` 構造体への **IntPtr** が含まれます。  コードが **unsafe** とマークされている場合を除いて、.NET Framework アプリケーションではポインターを使用しないため、**IntPtr** 型は元のポインターをアンマネージ構造体に置き換えます。  
+  
+-   `MyPerson3` には `MyPerson` が埋め込み構造体として含まれます。  別の構造体に埋め込まれた構造体は、埋め込み構造体の要素をメインの構造体に直接配置することでフラット化することができます。またはこのサンプルのように、埋め込み構造体のままにすることもできます。  
+  
+-   `MyArrayStruct` には整数の配列が含まれます。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は <xref:System.Runtime.InteropServices.UnmanagedType> 列挙値を **ByValArray** に設定します。これは配列内の要素の数を示すために使用されます。  
+  
+ このサンプル内のすべての構造体で、各メンバーが出現する順番でメモリ内に順次配列されることを保証するために、<xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性が適用されています。  
+  
+ `LibWrap` クラスには、`App` クラスによって呼び出される `TestStructInStruct`、`TestStructInStruct3`、および `TestArrayInStruct` メソッドのマネージ プロトタイプが含まれます。  各プロトタイプは、1 つのパラメーターを以下のように宣言します。  
+  
+-   `TestStructInStruct` は型 `MyPerson2` への参照をそのパラメーターとして宣言します。  
+  
+-   `TestStructInStruct3` は型 `MyPerson3` をそのパラメーターとして宣言し、パラメーターを値によって渡します。  
+  
+-   `TestArrayInStruct` は型 `MyArrayStruct` への参照をそのパラメーターとして宣言します。  
+  
+ メソッドへの引数としての構造体は、パラメーターに **ref** \(Visual Basic では **ByRef**\) キーワードが含まれない限り、値によって渡されます。  たとえば、`TestStructInStruct` メソッドは型 `MyPerson2` のオブジェクトへの参照 \(アドレスの値\) をアンマネージ コードに渡します。  `MyPerson2` が指定する構造体を操作するために、サンプルは指定したサイズのバッファーを作成し、<xref:System.Runtime.InteropServices.Marshal.AllocCoTaskMem%2A?displayProperty=fullName> と <xref:System.Runtime.InteropServices.Marshal.SizeOf%2A?displayProperty=fullName> のメソッドを結合することでそのアドレスを返します。  次に、サンプルはマネージ構造体の内容をアンマネージ バッファーにコピーします。  最後に、サンプルは <xref:System.Runtime.InteropServices.Marshal.PtrToStructure%2A?displayProperty=fullName> メソッドを使用してアンマネージ バッファーからマネージ オブジェクトにデータをマーシャリングし、<xref:System.Runtime.InteropServices.Marshal.FreeCoTaskMem%2A?displayProperty=fullName> メソッドを使用してメモリのアンマネージ ブロックを解放します。  
+  
+### プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#23](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/structures.cpp#23)]
+ [!code-csharp[Conceptual.Interop.Marshaling#23](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/structures.cs#23)]
+ [!code-vb[Conceptual.Interop.Marshaling#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/structures.vb#23)]  
+  
+### 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#24](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/structures.cpp#24)]
+ [!code-csharp[Conceptual.Interop.Marshaling#24](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/structures.cs#24)]
+ [!code-vb[Conceptual.Interop.Marshaling#24](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/structures.vb#24)]  
+  
+## FindFile サンプル  
+ このサンプルでは、2 番目の埋め込み構造体を含む構造体をアンマネージ関数に渡す方法を示します。  また、<xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を使用して構造体内に固定長配列を宣言する方法も示します。  このサンプルでは、埋め込み構造体の要素が親の構造体に追加されます。  フラット化しない埋め込み構造体のサンプルについては、「[構造体のサンプル](http://msdn.microsoft.com/ja-jp/96a62265-dcf9-4608-bc0a-1f762ab9f48e)」を参照してください。  
+  
+ FindFile のサンプルで使用するアンマネージ関数とその元の関数宣言を次に示します。  
+  
+-   Kernel32.dll からエクスポートされる **FindFirstFile**  
+  
+    ```  
+    HANDLE FindFirstFile(LPCTSTR lpFileName, LPWIN32_FIND_DATA lpFindFileData);  
+    ```  
+  
+ 関数に渡された元の構造体には、次に示す要素が含まれています。  
+  
+```  
+typedef struct _WIN32_FIND_DATA   
+{  
+  DWORD    dwFileAttributes;   
+  FILETIME ftCreationTime;   
+  FILETIME ftLastAccessTime;   
+  FILETIME ftLastWriteTime;   
+  DWORD    nFileSizeHigh;   
+  DWORD    nFileSizeLow;   
+  DWORD    dwReserved0;   
+  DWORD    dwReserved1;   
+  TCHAR    cFileName[ MAX_PATH ];   
+  TCHAR    cAlternateFileName[ 14 ];   
+} WIN32_FIND_DATA, *PWIN32_FIND_DATA;  
+```  
+  
+ このサンプルでは、`FindData` クラスに、元の構造体と埋め込み構造体の各要素に対応するデータ メンバーが含まれています。  このクラスは、元の 2 つの文字バッファーを文字列に置き換えます。  **MarshalAsAttribute** は <xref:System.Runtime.InteropServices.UnmanagedType> 列挙を **ByValTStr** に設定します。これは、アンマネージ構造体に出現するインラインの固定長文字配列を識別するために使用されます。  
+  
+ `LibWrap` クラスには `FindFirstFile` メソッドのマネージ プロトタイプが含まれます。このメソッドは `FindData` クラスをパラメーターとして渡します。  参照型のクラスは既定では In パラメーターとして渡されるため、パラメーターは <xref:System.Runtime.InteropServices.InAttribute> と <xref:System.Runtime.InteropServices.OutAttribute> の属性で宣言する必要があります。  
+  
+### プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#17](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/findfile.cpp#17)]
+ [!code-csharp[Conceptual.Interop.Marshaling#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/findfile.cs#17)]
+ [!code-vb[Conceptual.Interop.Marshaling#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/findfile.vb#17)]  
+  
+### 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#18](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/findfile.cpp#18)]
+ [!code-csharp[Conceptual.Interop.Marshaling#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/findfile.cs#18)]
+ [!code-vb[Conceptual.Interop.Marshaling#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/findfile.vb#18)]  
+  
+## Unions サンプル  
+ このサンプルでは、値型のみを含む構造体、および値型と文字列を含む構造体を、共用体が予期されているアンマネージ関数のパラメーターとして渡す方法を示します。  共用体は、2 つ以上の変数が共有できるメモリ位置を表します。  
+  
+ Unions のサンプルで使用するアンマネージ関数とその元の関数宣言を次に示します。  
+  
+-   PinvokeLib.dll からエクスポートされる **TestUnion**  
+  
+    ```  
+    void TestUnion(MYUNION u, int type);  
+    ```  
+  
+ [PinvokeLib.dll](http://msdn.microsoft.com/ja-jp/5d1438d7-9946-489d-8ede-6c694a08f614) はカスタム アンマネージ ライブラリであり、上記の関数および 2 つの共用体 **MYUNION** および **MYUNION2** に関する実装を含んでいます。  共用体には以下の要素が含まれます。  
+  
+```  
+union MYUNION  
+{  
+    int number;  
+    double d;  
+}  
+  
+union MYUNION2  
+{  
+    int i;  
+    char str[128];  
+};  
+```  
+  
+ マネージ コードでは、共用体は構造体として定義されます。  `MyUnion` 構造体には、メンバーとして整数と倍精度の 2 つの値型が含まれます。  <xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性は、各データ メンバーの正確な位置を制御するために設定されます。  <xref:System.Runtime.InteropServices.FieldOffsetAttribute> 属性は、共用体のアンマネージ表現内に、フィールドの物理的な位置を指定します。  両方のメンバーに同じオフセット値があるので、メンバーはメモリの同じ部分を定義できることに注意してください。  
+  
+ `MyUnion2_1` と `MyUnion2_2` には、それぞれ値型 \(整数\) と文字列が含まれています。  マネージ コードでは、値型と参照型が重複することは許可されません。  このサンプルでは、同じアンマネージ関数を呼び出すときに呼び出し元が両方の型を使用できるようにするため、メソッドのオーバーロードを使用します。  `MyUnion2_1` のレイアウトは明示的で、正確なオフセット値を持っています。  これに対し、`MyUnion2_2` にはシーケンシャル レイアウトがあります。参照型では明示的なレイアウトが許可されていないためです。  <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性は <xref:System.Runtime.InteropServices.UnmanagedType> 列挙を **ByValTStr** に設定します。これは、共用体のアンマネージ表現に出現するインラインの固定長文字配列を識別するために使用されます。  
+  
+ `LibWrap` クラスには、`TestUnion` と `TestUnion2` メソッドのプロトタイプが含まれます。  `TestUnion2` は `MyUnion2_1` または `MyUnion2_2` をパラメーターとして宣言するためにオーバーロードされています。  
+  
+### プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#28](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/unions.cpp#28)]
+ [!code-csharp[Conceptual.Interop.Marshaling#28](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/unions.cs#28)]
+ [!code-vb[Conceptual.Interop.Marshaling#28](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/unions.vb#28)]  
+  
+### 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#29](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/unions.cpp#29)]
+ [!code-csharp[Conceptual.Interop.Marshaling#29](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/unions.cs#29)]
+ [!code-vb[Conceptual.Interop.Marshaling#29](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/unions.vb#29)]  
+  
+## SysTime サンプル  
+ このサンプルでは、構造体へのポインターを要求する、クラスへのポインターをアンマネージ関数に渡す方法について説明します。  
+  
+ SysTime のサンプルで使用するアンマネージ関数とその元の関数宣言を次に示します。  
+  
+-   Kernel32.dll からエクスポートされる **GetSystemTime**  
+  
+    ```  
+    VOID GetSystemTime(LPSYSTEMTIME lpSystemTime);  
+    ```  
+  
+ 関数に渡された元の構造体には、次に示す要素が含まれています。  
+  
+```  
+typedef struct _SYSTEMTIME {   
+    WORD wYear;   
+    WORD wMonth;   
+    WORD wDayOfWeek;   
+    WORD wDay;   
+    WORD wHour;   
+    WORD wMinute;   
+    WORD wSecond;   
+    WORD wMilliseconds;   
+} SYSTEMTIME, *PSYSTEMTIME;  
+```  
+  
+ このサンプルでは、`SystemTime` クラスの中には、クラス メンバーとして表される、元の構造体の要素が含まれます。  各メンバーが出現する順番でメモリ内に順次配列されることを保証するために、<xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性を設定します。  
+  
+ `LibWrap` クラスには `GetSystemTime` メソッドのマネージ プロトタイプが含まれます。このメソッドは既定では `SystemTime` クラスを In\/Out パラメーターとして渡します。  参照型のクラスは既定では In パラメーターとして渡されるため、パラメーターは <xref:System.Runtime.InteropServices.InAttribute> と <xref:System.Runtime.InteropServices.OutAttribute> の属性で宣言する必要があります。  呼び出し元が結果を受け取るには、これらの[方向属性](http://msdn.microsoft.com/ja-jp/241ac5b5-928e-4969-8f58-1dbc048f9ea2)を明示的に適用する必要があります。  `App` クラスは、`SystemTime` クラスの新しいインスタンスを作成して、そのデータ フィールドにアクセスします。  
+  
+### コード サンプル  
+ [!code-cpp[Conceptual.Interop.Marshaling#25](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/systime.cpp#25)]
+ [!code-csharp[Conceptual.Interop.Marshaling#25](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/systime.cs#25)]
+ [!code-vb[Conceptual.Interop.Marshaling#25](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/systime.vb#25)]  
+  
+## OutArrayOfStructs サンプル  
+ このサンプルでは、整数および文字列をアンマネージ関数への Out パラメーターとして含む構造体の配列を渡す方法を示します。  
+  
+ このサンプルでは、<xref:System.Runtime.InteropServices.Marshal> クラスを使用することにより、およびアンセーフ コードを使用することにより、ネイティブ関数を呼び出す方法を例示します。  
+  
+ このサンプルでは、[PinvokeLib.dll](http://msdn.microsoft.com/ja-jp/5d1438d7-9946-489d-8ede-6c694a08f614) で定義されていて、ソース ファイルにも含まれている、ラッパー関数とプラットフォーム呼び出しを使用します。  これは `TestOutArrayOfStructs` 関数および `MYSTRSTRUCT2` 構造を使用します。  構造体には次の要素が含まれます。  
+  
+```  
+typedef struct _MYSTRSTRUCT2  
+{  
+   char* buffer;  
+   UINT size;   
+} MYSTRSTRUCT2;  
+```  
+  
+ `MyStruct` クラスには ANSI 文字の文字列オブジェクトが含まれています。  <xref:System.Runtime.InteropServices.DllImportAttribute.CharSet> フィールドは ANSI 形式を指定します。  `MyUnsafeStruct` は、文字列の代わりに <xref:System.IntPtr> 型を含む構造体です。  
+  
+ `LibWrap` クラスには、オーバーロードされた `TestOutArrayOfStructs` プロトタイプ メソッドが含まれます。  メソッドでポインターをパラメーターとして宣言している場合、クラスには `unsafe` キーワードでマークを付ける必要があります。  [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] はアンセーフ コードを使用できないので、オーバー ロードされたメソッド、unsafe 修飾子、そして `MyUnsafeStruct` 構造は必要ありません。  
+  
+ `App` クラスは、配列を渡すために必要なすべてのタスクを実行する、`UsingMarshaling` メソッドを実装します。  配列には、データが呼び出し先から呼び出し元に渡されることを示すため、`out` \(Visual Basic では `ByRef`\) キーワードでマークが付けられます。  実装は、以下の <xref:System.Runtime.InteropServices.Marshal> クラス メソッドを使用します。  
+  
+-   <xref:System.Runtime.InteropServices.Marshal.PtrToStructure%2A> は、アンマネージ バッファーからマネージ オブジェクトにデータをマーシャリングします。  
+  
+-   <xref:System.Runtime.InteropServices.Marshal.DestroyStructure%2A> は、構造体で文字列用に予約されていたメモリを解放します。  
+  
+-   <xref:System.Runtime.InteropServices.Marshal.FreeCoTaskMem%2A> は、配列用に予約されていたメモリを解放します。  
+  
+ 前述のとおり、C\# ではアンセーフ コードが許可されますが [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] では許可されません。  C\# サンプルで、`UsingUnsafePointer` は、<xref:System.Runtime.InteropServices.Marshal> クラスの代わりにポインターを使用して `MyUnsafeStruct` 構造体を含む配列を戻す、代替のメソッドの実装です。  
+  
+### プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#20](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/outarrayofstructs.cpp#20)]
+ [!code-csharp[Conceptual.Interop.Marshaling#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/outarrayofstructs.cs#20)]
+ [!code-vb[Conceptual.Interop.Marshaling#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/outarrayofstructs.vb#20)]  
+  
+### 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#21](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/outarrayofstructs.cpp#21)]
+ [!code-csharp[Conceptual.Interop.Marshaling#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/outarrayofstructs.cs#21)]
+ [!code-vb[Conceptual.Interop.Marshaling#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/outarrayofstructs.vb#21)]  
+  
+## 参照  
+ [プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)   
+ [Platform Invoke Data Types](http://msdn.microsoft.com/ja-jp/16014d9f-d6bd-481e-83f0-df11377c550f)   
+ [文字列のマーシャリング](../../../docs/framework/interop/marshaling-strings.md)   
+ [Marshaling Arrays of Types](http://msdn.microsoft.com/ja-jp/049b1c1b-228f-4445-88ec-91bc7fd4b1e8)
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-data-with-com-interop.md b/docs/framework/interop/marshaling-data-with-com-interop.md
new file mode 100644
index 00000000000..1e8c2506377
--- /dev/null
+++ b/docs/framework/interop/marshaling-data-with-com-interop.md
@@ -0,0 +1,62 @@
+---
+title: "COM 相互運用機能によるデータのマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, データ マーシャリング"
+  - "マーシャリング (データの), COM 相互運用機能"
+ms.assetid: 0bcdd7bf-5026-43eb-b08b-f03f90db9df9
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# COM 相互運用機能によるデータのマーシャリング
+COM 相互運用は、マネージ コードから COM オブジェクトを使用すること、およびマネージ オブジェクトを COM に公開することの、両方の操作をサポートします。  COM との間でデータをマーシャリングする操作のサポートは広範で、ほとんどの場合、正しいマーシャリング動作が提供されます。  
+  
+ [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] には、以下の COM 相互運用ツールが含まれています。  
+  
+-   [タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)、これは COM タイプ ライブラリを相互運用アセンブリに変換します。  このアセンブリから、相互運用マーシャリング サービスは、マネージ メモリとアンマネージ メモリ間のデータ マーシャリングを実行するラッパーを生成します。  
+  
+-   [タイプ ライブラリ エクスポーター \(Tlbexp.exe\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)、これは COM タイプ ライブラリをアセンブリから生成して、メソッド呼び出しの際にマーシャリングを実行するラッパーを生成します。  
+  
+ このセクションでは、マーシャラーに追加の型情報を提供できる \(またはその必要がある\) ときに、相互運用ラッパーをカスタマイズするためのプロセスについて説明します。  
+  
+## このセクションの内容  
+ [COM のデータ型](http://msdn.microsoft.com/ja-jp/f93ae35d-a416-4218-8700-c8218cc90061)  
+ 対応するマネージとアンマネージのデータ型を提供します。  
+  
+ [COM 呼び出し可能ラッパーのカスタマイズ](http://msdn.microsoft.com/ja-jp/825177d3-4b2c-4723-82be-ce6ca2c34ace)  
+ デザイン時に **MarshalAsAttribute** 属性を使用して、データ型を明示的にマーシャリングする方法について説明します。  
+  
+ [ランタイム呼び出し可能ラッパーのカスタマイズ](http://msdn.microsoft.com/ja-jp/4652beaf-77d0-4f37-9687-ca193288c0be)  
+ 相互運用アセンブリで型のマーシャリング動作を調整する方法、および COM 型を手動で定義する方法について説明します。  
+  
+ [方法: マネージ コード DCOM を WCF に移行する](../../../docs/framework/interop/how-to-migrate-managed-code-dcom-to-wcf.md)  
+ 最も安全なソリューションのために、マネージ DCOM コードを WCF に移行する方法について説明します。  
+  
+## 関連項目  
+ [Advanced COM Interoperability](http://msdn.microsoft.com/ja-jp/3ada36e5-2390-4d70-b490-6ad8de92f2fb)  
+ .NET Framework アプリケーションに COM コンポーネントを組み込む方法についての詳細情報へのリンクを示します。  
+  
+ [Assembly to Type Library Conversion Summary](http://msdn.microsoft.com/ja-jp/3a37eefb-a76c-4000-9080-7dbbf66a4896)  
+ アセンブリからタイプ ライブラリにエクスポート変換するプロセスについて説明します。  
+  
+ [Type Library to Assembly Conversion Summary](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)  
+ タイプ ライブラリからアセンブリにインポート変換するプロセスについて説明します。  
+  
+ [Interoperating Using Generic Types](http://msdn.microsoft.com/ja-jp/26b88e03-085b-4b53-94ba-a5a9c709ce58)  
+ COM 相互運用性のジェネリック型を使用するとき、どのアクションがサポートされるかについて説明します。
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-data-with-platform-invoke.md b/docs/framework/interop/marshaling-data-with-platform-invoke.md
new file mode 100644
index 00000000000..5613267531e
--- /dev/null
+++ b/docs/framework/interop/marshaling-data-with-platform-invoke.md
@@ -0,0 +1,71 @@
+---
+title: "プラットフォーム呼び出しによるデータのマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, プラットフォーム呼び出し"
+  - "マーシャリング, プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し, マーシャリング (データの)"
+ms.assetid: dc5c76cf-7b12-406f-b79c-d1a023ec245d
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# プラットフォーム呼び出しによるデータのマーシャリング
+アンマネージ ライブラリからエクスポートされた関数を呼び出すには、.NET Framework アプリケーションで、マネージ コード内にアンマネージ関数を表す関数プロトタイプが必要です。  プラットフォーム呼び出しがデータを正しくマーシャリングできるようにするプロトタイプを作成するには、次のことを実行する必要があります。  
+  
+-   [DLLImportAttribute](frlrfSystemRuntimeInteropServicesDllImportAttributeClassTopic) 属性をマネージ コード内の静的関数またはメソッドに適用します。  
+  
+-   アンマネージ データ型をマネージ データ型に置き換えます。  
+  
+ アンマネージ関数に付属のドキュメントを使用して、属性とその省略可能なフィールドを適用し、アンマネージ型をマネージ データ型に置き換えることによって、同等のマネージ プロトタイプを作成できます。  **DllImportAttribute** を適用する方法について詳しくは、「[アンマネージ DLL 関数の処理](../../../docs/framework/interop/consuming-unmanaged-dll-functions.md)」を参照してください。  
+  
+ このセクションでは、アンマネージ ライブラリによってエクスポートされた関数に引数を渡し、その関数からの戻り値を受け取るための、マネージ関数のプロトタイプを作成する方法を示すサンプルを示します。  サンプルではまた、いつ <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性と <xref:System.Runtime.InteropServices.Marshal> クラスを使用して明示的にデータをマーシャリングするかをも示しています。  
+  
+## プラットフォーム呼び出しのデータ型  
+ 次の表は、Win32 API \(Wtypes.h にリストされている\) と C スタイルの関数で使用されるデータ型を一覧で示しています。  多くのアンマネージ ライブラリには、これらのデータ型をパラメーターや戻り値として渡す関数が含まれています。  3 番目の列には、マネージ コードで使用する、対応する .NET Framework の組み込みの値型またはクラスを一覧で示します。  場合によっては、表にリストされた型を、同じサイズの型に置き換えることができます。  
+  
+|Wtypes.h でのアンマネージ型|アンマネージ C 言語型|マネージ クラス名|説明|  
+|------------------------|------------------|---------------|--------|  
+|**HANDLE**|**void\***|<xref:System.IntPtr?displayProperty=fullName>|32 ビット Windows オペレーティング システム、64 ビット Windows オペレーティング システムで 64 ビットに 32 ビットです。|  
+|**BYTE**|**unsigned char**|<xref:System.Byte?displayProperty=fullName>|8 ビット|  
+|**SHORT**|**short**|<xref:System.Int16?displayProperty=fullName>|16 ビット|  
+|**WORD**|**unsigned short**|<xref:System.UInt16?displayProperty=fullName>|16 ビット|  
+|**INT**|**int**|<xref:System.Int32?displayProperty=fullName>|32 ビット|  
+|**UINT**|**unsigned int**|<xref:System.UInt32?displayProperty=fullName>|32 ビット|  
+|**LONG**|**long**|<xref:System.Int32?displayProperty=fullName>|32 ビット|  
+|**BOOL**|**long**|[\<caps:sentence id\="tgt48" sentenceid\="f5f846452032b75e5fcec49a05fe125a" class\="tgtSentence"\>System.Int32\<\/caps:sentence\>](https://msdn.microsoft.com/en-us/library/system.byte.aspx)|32 ビット|  
+|**DWORD**|**unsigned long**|<xref:System.UInt32?displayProperty=fullName>|32 ビット|  
+|**ULONG**|**unsigned long**|<xref:System.UInt32?displayProperty=fullName>|32 ビット|  
+|**CHAR**|**char**|<xref:System.Char?displayProperty=fullName>|ANSI で装飾します。|  
+|**WCHAR**|**wchar\_t**|<xref:System.Char?displayProperty=fullName>|Unicode で装飾します。|  
+|**LPSTR**|**char\***|<xref:System.String?displayProperty=fullName> または <xref:System.Text.StringBuilder?displayProperty=fullName>|ANSI で装飾します。|  
+|**LPCSTR**|**Const char\***|<xref:System.String?displayProperty=fullName> または <xref:System.Text.StringBuilder?displayProperty=fullName>|ANSI で装飾します。|  
+|**LPWSTR**|**wchar\_t\***|<xref:System.String?displayProperty=fullName> または <xref:System.Text.StringBuilder?displayProperty=fullName>|Unicode で装飾します。|  
+|**LPCWSTR**|**Const wchar\_t\***|<xref:System.String?displayProperty=fullName> または <xref:System.Text.StringBuilder?displayProperty=fullName>|Unicode で装飾します。|  
+|**FLOAT**|**浮動小数点型**|<xref:System.Single?displayProperty=fullName>|32 ビット|  
+|**DOUBLE**|**倍精度浮動小数点型**|<xref:System.Double?displayProperty=fullName>|64 ビット|  
+  
+ [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)]、C\#、および C\+\+ での対応する型については、「[.NET Framework クラス ライブラリの概要](../../../docs/standard/class-library-overview.md)」を参照してください。  
+  
+## PinvokeLib.dll  
+ 次のコードでは、Pinvoke.dll によって提供されるライブラリ関数を定義します。  このセクションで説明される多くのサンプルでは、このライブラリを呼び出します。  
+  
+### 例  
+ [!code-cpp[PInvokeLib#1](../../../samples/snippets/cpp/VS_Snippets_CLR/pinvokelib/cpp/pinvokelib.cpp#1)]  
+  
+ [!code-cpp[PInvokeLib#2](../../../samples/snippets/cpp/VS_Snippets_CLR/pinvokelib/cpp/pinvokelib.h#2)]
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-different-types-of-arrays.md b/docs/framework/interop/marshaling-different-types-of-arrays.md
new file mode 100644
index 00000000000..118839c7153
--- /dev/null
+++ b/docs/framework/interop/marshaling-different-types-of-arrays.md
@@ -0,0 +1,117 @@
+---
+title: "さまざまな型の配列のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, 配列のサンプル"
+  - "マーシャリング, 配列のサンプル"
+ms.assetid: c5ac9920-5b6e-4dc9-bf2d-1f6f8ad3b0bf
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# さまざまな型の配列のマーシャリング
+配列は、同じ型の 1 つ以上の要素を含むマネージ コード内の参照型です。 配列は参照型ですが、アンマネージ関数には In パラメーターとして渡されます。 この動作は、マネージ配列がマネージ オブジェクトに渡される方法 \(In\/Out パラメーターとして渡される\) と一致しません。 詳細については、「[コピーと固定](../../../docs/framework/interop/copying-and-pinning.md)」を参照してください。  
+  
+ 次の表では、配列のマーシャリング オプションをリストして、それらの使用方法を説明します。  
+  
+|配列|説明|  
+|--------|--------|  
+|値による整数の。|整数の配列を In パラメーターとして渡します。|  
+|参照による整数の。|整数の配列を In\/Out パラメーターとして渡します。|  
+|値による整数の \(2 次元\)。|整数のマトリックスを In パラメーターとして渡します。|  
+|値による文字列の。|文字列の配列を In パラメーターとして渡します。|  
+|整数による構造体の。|In パラメーターとして整数を含む構造体の配列を渡します。|  
+|文字列による構造体の。|In\/Out パラメーターとして整数のみを含む構造体の配列を渡します。 配列のメンバーを変更することができます。|  
+  
+## 例  
+ このサンプルは、以下の種類の配列差を渡す法を示します。  
+  
+-   値による整数の配列。  
+  
+-   サイズを変更できる、参照による整数の配列。  
+  
+-   値による整数の多次元配列 \(マトリックス\)。  
+  
+-   値による文字列の配列。  
+  
+-   整数による構造体の配列。  
+  
+-   文字列による構造体の配列。  
+  
+ 配列が参照によって明示的にマーシャリングされない限り、既定の動作は、配列を In パラメーターとしてマーシャリングすることです。 この動作は、<xref:System.Runtime.InteropServices.InAttribute> と <xref:System.Runtime.InteropServices.OutAttribute> 属性を明示的に適用することで変更できます。  
+  
+ Arrays のサンプルで使用するアンマネージ関数とその元の関数宣言を次に示します。  
+  
+-   PinvokeLib.dll からエクスポートされる **TestArrayOfInts**。  
+  
+    ```  
+    int TestArrayOfInts(int* pArray, int pSize);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestRefArrayOfInts**。  
+  
+    ```  
+    int TestRefArrayOfInts(int** ppArray, int* pSize);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestMatrixOfInts**。  
+  
+    ```  
+    int TestMatrixOfInts(int pMatrix[][COL_DIM], int row);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestArrayOfStrings**。  
+  
+    ```  
+    int TestArrayOfStrings(char** ppStrArray, int size);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestArrayOfStructs**。  
+  
+    ```  
+    int TestArrayOfStructs(MYPOINT* pPointArray, int size);  
+    ```  
+  
+-   PinvokeLib.dll からエクスポートされる **TestArrayOfStructs2**。  
+  
+    ```  
+    int TestArrayOfStructs2 (MYPERSON* pPersonArray, int size);  
+    ```  
+  
+ [PinvokeLib.dll](http://msdn.microsoft.com/ja-jp/5d1438d7-9946-489d-8ede-6c694a08f614) はカスタム アンマネージ ライブラリであり、上記の関数および 2 つの構造体変数 **MYPOINT** および **MYPERSON** に関する実装を含んでいます。 構造体には次の要素が含まれます。  
+  
+```  
+typedef struct _MYPOINT { int x; int y; } MYPOINT; typedef struct _MYPERSON { char* first; char* last; } MYPERSON;  
+```  
+  
+ このサンプルでは、`MyPoint` と `MyPerson` 構造体に埋め込み型が含まれています。 各メンバーが出現する順番でメモリ内に順次配列されることを保証するために、<xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性を設定します。  
+  
+ `LibWrap` クラスには、`App` クラスによって呼び出されるメソッドのセットが含まれます。 配列を渡す特定の方法について詳しくは、次のサンプル内のコメントを参照してください。 参照型の配列は、既定では In パラメーターとして渡されます。 呼び出し元が結果を受け取るためには、**InAttribute** と **OutAttribute** を配列が含まれる引数に明示的に適用する必要があります。  
+  
+### プロトタイプの宣言  
+ [!code-csharp[Conceptual.Interop.Marshaling#31](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/arrays.cs#31)]
+ [!code-vb[Conceptual.Interop.Marshaling#31](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/arrays.vb#31)]  
+  
+### 関数の呼び出し  
+ [!code-csharp[Conceptual.Interop.Marshaling#32](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/arrays.cs#32)]
+ [!code-vb[Conceptual.Interop.Marshaling#32](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/arrays.vb#32)]  
+  
+## 参照  
+ [型の配列のマーシャリング](http://msdn.microsoft.com/ja-jp/049b1c1b-228f-4445-88ec-91bc7fd4b1e8)   
+ [プラットフォーム呼び出しのデータ型](http://msdn.microsoft.com/ja-jp/16014d9f-d6bd-481e-83f0-df11377c550f)   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)
\ No newline at end of file
diff --git a/docs/framework/interop/marshaling-strings.md b/docs/framework/interop/marshaling-strings.md
new file mode 100644
index 00000000000..622d287cf0d
--- /dev/null
+++ b/docs/framework/interop/marshaling-strings.md
@@ -0,0 +1,56 @@
+---
+title: "文字列のマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, プラットフォーム呼び出し"
+  - "データ マーシャリング, サンプル"
+  - "データ マーシャリング, 文字列"
+  - "マーシャリング, プラットフォーム呼び出し"
+  - "マーシャリング, サンプル"
+  - "マーシャリング (文字列の)"
+  - "プラットフォーム呼び出し, マーシャリング (データの)"
+  - "サンプル アプリケーション [.NET Framework], マーシャリング (文字列の)"
+ms.assetid: e21b078b-70fb-4905-be26-c097ab2433ff
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 文字列のマーシャリング
+プラットフォーム呼び出しでは、文字列パラメーターがコピーされ、必要に応じて .NET Framework 形式 \(Unicode\) からアンマネージ形式 \(ANSI\) に変換されます。  マネージ文字列は変更不可なので、プラットフォーム呼び出しでは関数から制御が返されるときに、アンマネージ メモリからマネージ メモリへとマネージ文字列はコピーされません。  
+  
+ 文字列に関するマーシャリングのオプションを次の表に列挙し、その使用方法を説明し、関連 .NET Framework サンプルへのリンクを示します。  
+  
+|\[文字列\]|Description|サンプル|  
+|-------------|-----------------|----------|  
+|値渡し。|文字列を In パラメーターとして渡します。|[MsgBox](../../../docs/framework/interop/msgbox-sample.md)|  
+|結果として渡す。|アンマネージ コードから文字列を返します。|[Strings](http://msdn.microsoft.com/ja-jp/be9e82a3-dc95-4aaa-9396-61b66e467e02)|  
+|参照渡し。|<xref:System.Text.StringBuilder> を使用して、文字列を In\/Out パラメーターとして渡します。|[Buffers](http://msdn.microsoft.com/ja-jp/e30d36e8-d7c4-4936-916a-8fdbe4d9ffd5)|  
+|構造体に組み込んで値渡し。|文字列を In パラメーターである構造体に組み込んで渡します。|[構造体](http://msdn.microsoft.com/ja-jp/96a62265-dcf9-4608-bc0a-1f762ab9f48e)|  
+|構造体に組み込んで参照渡し **\(char\*\)**。|文字列を In\/Out パラメーターである構造体に組み込んで渡します。  アンマネージ関数は文字バッファーへのポインターを要求します。またバッファーのサイズは構造体のメンバーです。|[Strings](http://msdn.microsoft.com/ja-jp/be9e82a3-dc95-4aaa-9396-61b66e467e02)|  
+|構造体に組み込んで参照渡し **\(char\[\]\)**。|文字列を In\/Out パラメーターである構造体に組み込んで渡します。  アンマネージ関数は埋め込み文字バッファーを要求します。|[OSInfo](http://msdn.microsoft.com/ja-jp/69d89067-507b-41fe-859d-30bf3ff29455)|  
+|クラスに組み込んで値渡し **\(char\*\)**。|文字列をクラスに組み込んで渡します \(クラスは In\/Out パラメーターです\)。  アンマネージ関数は、文字バッファーへのポインターを要求します。|[OpenFileDlg](http://msdn.microsoft.com/ja-jp/b7dea792-cb92-4baf-ac7b-6a24803e6c75)|  
+|クラスに組み込んで値渡し **\(char\[\]\)**。|文字列をクラスに組み込んで渡します \(クラスは In\/Out パラメーターです\)。  アンマネージ関数は埋め込み文字バッファーを要求します。|[OSInfo](http://msdn.microsoft.com/ja-jp/69d89067-507b-41fe-859d-30bf3ff29455)|  
+|文字列の配列として値渡し。|値渡しされる文字列の配列を作成します。|[配列](../../../docs/framework/interop/marshaling-different-types-of-arrays.md)|  
+|文字列を含む構造体の配列として値渡し。|文字列を含む構造体の配列を作成し、その配列を値渡しします。|[配列](../../../docs/framework/interop/marshaling-different-types-of-arrays.md)|  
+  
+## 参照  
+ [プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)   
+ [Platform Invoke Data Types](http://msdn.microsoft.com/ja-jp/16014d9f-d6bd-481e-83f0-df11377c550f)   
+ [クラス、構造体、および共用体のマーシャリング](../../../docs/framework/interop/marshaling-classes-structures-and-unions.md)   
+ [Marshaling Arrays of Types](http://msdn.microsoft.com/ja-jp/049b1c1b-228f-4445-88ec-91bc7fd4b1e8)   
+ [Miscellaneous Marshaling Samples](http://msdn.microsoft.com/ja-jp/a915c948-54e9-4d0f-a525-95a77fd8ed70)
\ No newline at end of file
diff --git a/docs/framework/interop/media/bidirectional.gif b/docs/framework/interop/media/bidirectional.gif
new file mode 100644
index 00000000000..6ea919f5bec
Binary files /dev/null and b/docs/framework/interop/media/bidirectional.gif differ
diff --git a/docs/framework/interop/media/ccw.gif b/docs/framework/interop/media/ccw.gif
new file mode 100644
index 00000000000..58da9a7bdf2
Binary files /dev/null and b/docs/framework/interop/media/ccw.gif differ
diff --git a/docs/framework/interop/media/ccwwithinterfaces.gif b/docs/framework/interop/media/ccwwithinterfaces.gif
new file mode 100644
index 00000000000..281096856fe
Binary files /dev/null and b/docs/framework/interop/media/ccwwithinterfaces.gif differ
diff --git a/docs/framework/interop/media/comdeployprivate.gif b/docs/framework/interop/media/comdeployprivate.gif
new file mode 100644
index 00000000000..860b93277a2
Binary files /dev/null and b/docs/framework/interop/media/comdeployprivate.gif differ
diff --git a/docs/framework/interop/media/filter2.gif b/docs/framework/interop/media/filter2.gif
new file mode 100644
index 00000000000..8a2f9b58a6c
Binary files /dev/null and b/docs/framework/interop/media/filter2.gif differ
diff --git a/docs/framework/interop/media/interopdirectref.gif b/docs/framework/interop/media/interopdirectref.gif
new file mode 100644
index 00000000000..7059adbfbc9
Binary files /dev/null and b/docs/framework/interop/media/interopdirectref.gif differ
diff --git a/docs/framework/interop/media/interopheap.gif b/docs/framework/interop/media/interopheap.gif
new file mode 100644
index 00000000000..e8684fba3c7
Binary files /dev/null and b/docs/framework/interop/media/interopheap.gif differ
diff --git a/docs/framework/interop/media/interophost.gif b/docs/framework/interop/media/interophost.gif
new file mode 100644
index 00000000000..56321a3645a
Binary files /dev/null and b/docs/framework/interop/media/interophost.gif differ
diff --git a/docs/framework/interop/media/interopmarshalcopy.gif b/docs/framework/interop/media/interopmarshalcopy.gif
new file mode 100644
index 00000000000..38523bbbd90
Binary files /dev/null and b/docs/framework/interop/media/interopmarshalcopy.gif differ
diff --git a/docs/framework/interop/media/interopmarshaling.png b/docs/framework/interop/media/interopmarshaling.png
new file mode 100644
index 00000000000..b25a5cb0e1c
Binary files /dev/null and b/docs/framework/interop/media/interopmarshaling.png differ
diff --git a/docs/framework/interop/media/interopmarshalpin.gif b/docs/framework/interop/media/interopmarshalpin.gif
new file mode 100644
index 00000000000..04635cb3169
Binary files /dev/null and b/docs/framework/interop/media/interopmarshalpin.gif differ
diff --git a/docs/framework/interop/media/interopremotesoap.gif b/docs/framework/interop/media/interopremotesoap.gif
new file mode 100644
index 00000000000..7695a385f13
Binary files /dev/null and b/docs/framework/interop/media/interopremotesoap.gif differ
diff --git a/docs/framework/interop/media/interopvariant.gif b/docs/framework/interop/media/interopvariant.gif
new file mode 100644
index 00000000000..cd104ad4137
Binary files /dev/null and b/docs/framework/interop/media/interopvariant.gif differ
diff --git a/docs/framework/interop/media/pinvoke.gif b/docs/framework/interop/media/pinvoke.gif
new file mode 100644
index 00000000000..0845a1b0a8b
Binary files /dev/null and b/docs/framework/interop/media/pinvoke.gif differ
diff --git a/docs/framework/interop/media/pinvokecallback.gif b/docs/framework/interop/media/pinvokecallback.gif
new file mode 100644
index 00000000000..aeec9d680ce
Binary files /dev/null and b/docs/framework/interop/media/pinvokecallback.gif differ
diff --git a/docs/framework/interop/media/rcw.gif b/docs/framework/interop/media/rcw.gif
new file mode 100644
index 00000000000..3e067f8c5ab
Binary files /dev/null and b/docs/framework/interop/media/rcw.gif differ
diff --git a/docs/framework/interop/media/rcwwithinterfaces.gif b/docs/framework/interop/media/rcwwithinterfaces.gif
new file mode 100644
index 00000000000..c610109332b
Binary files /dev/null and b/docs/framework/interop/media/rcwwithinterfaces.gif differ
diff --git a/docs/framework/interop/media/singleprocessmultapt.gif b/docs/framework/interop/media/singleprocessmultapt.gif
new file mode 100644
index 00000000000..df6aefa7a1c
Binary files /dev/null and b/docs/framework/interop/media/singleprocessmultapt.gif differ
diff --git a/docs/framework/interop/msgbox-sample.md b/docs/framework/interop/msgbox-sample.md
new file mode 100644
index 00000000000..f6baaf196d9
--- /dev/null
+++ b/docs/framework/interop/msgbox-sample.md
@@ -0,0 +1,58 @@
+---
+title: "MsgBox のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ マーシャリング, MsgBox サンプル"
+  - "マーシャリング, MsgBox サンプル"
+ms.assetid: 9e0edff6-cc0d-4d5c-a445-aecf283d9c3a
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# MsgBox のサンプル
+このサンプルでは、文字列型を In パラメーターとして値渡しする方法と、<xref:System.Runtime.InteropServices.DllImportAttribute.EntryPoint>、<xref:System.Runtime.InteropServices.DllImportAttribute.CharSet>、および <xref:System.Runtime.InteropServices.DllImportAttribute.ExactSpelling> の各フィールドを使用する場合について説明します。  
+  
+ MsgBox のサンプルで使用するアンマネージ関数とその関数宣言を次に示します。  
+  
+-   User32.dll からエクスポートされる **MessageBox**  
+  
+    ```  
+    int MessageBox(HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption,   
+       UINT uType);  
+    ```  
+  
+ このサンプルでは、`LibWrap` クラスの中には、`MsgBoxSample` クラスによって呼び出される各アンマネージ関数に関するマネージ プロトタイプが含まれます。  マネージ プロトタイプ メソッドの `MsgBox`、`MsgBox2`、および `MsgBox3` は、同じアンマネージ関数に対して異なる宣言を持ちます。  
+  
+ `MsgBox2` に対する宣言により、メッセージ ボックス内に不正な出力が生成されます。その原因は、ANSI として指定した文字型が、Unicode 関数の名前であるエントリ ポイント `MessageBoxW` と一致しないからです。  `MsgBox3` に対する宣言により、**EntryPoint**、**CharSet**、および **ExactSpelling** の各フィールド間に不一致が発生します。  `MsgBox3` を呼び出すと例外がスローされます。  文字列の名前付けと名前のマーシャリングの詳細については、「[文字セットの指定](../../../docs/framework/interop/specifying-a-character-set.md)」を参照してください。  
+  
+## プロトタイプの宣言  
+ [!code-cpp[Conceptual.Interop.Marshaling#5](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/msgbox.cpp#5)]
+ [!code-csharp[Conceptual.Interop.Marshaling#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/msgbox.cs#5)]
+ [!code-vb[Conceptual.Interop.Marshaling#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/msgbox.vb#5)]  
+  
+## 関数の呼び出し  
+ [!code-cpp[Conceptual.Interop.Marshaling#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interop.marshaling/cpp/msgbox.cpp#6)]
+ [!code-csharp[Conceptual.Interop.Marshaling#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interop.marshaling/cs/msgbox.cs#6)]
+ [!code-vb[Conceptual.Interop.Marshaling#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interop.marshaling/vb/msgbox.vb#6)]  
+  
+## 参照  
+ [文字列のマーシャリング](../../../docs/framework/interop/marshaling-strings.md)   
+ [Platform Invoke Data Types](http://msdn.microsoft.com/ja-jp/16014d9f-d6bd-481e-83f0-df11377c550f)   
+ [文字列に対する既定のマーシャリング](../../../docs/framework/interop/default-marshaling-for-strings.md)   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)   
+ [文字セットの指定](../../../docs/framework/interop/specifying-a-character-set.md)
\ No newline at end of file
diff --git a/docs/framework/interop/packaging-an-assembly-for-com.md b/docs/framework/interop/packaging-an-assembly-for-com.md
new file mode 100644
index 00000000000..3297fe1c1cf
--- /dev/null
+++ b/docs/framework/interop/packaging-an-assembly-for-com.md
@@ -0,0 +1,102 @@
+---
+title: "COM 用のアセンブリのパッケージ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET サービス インストール ツール"
+  - "アセンブリ登録ツール"
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "COM 相互運用機能, パッケージ化 (アセンブリの)"
+  - "公開 (COM に .NET Framework コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 公開 (.NET Framework コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), パッケージ化 (アセンブリの)"
+  - "パッケージ化 (COM のアセンブリの)"
+  - "Reqasm.exe"
+  - "Reqsvcs.exe"
+  - "Tlbexp.exe"
+  - "タイプ ライブラリ エクスポーター"
+  - "TypeLibConverter クラス"
+ms.assetid: 39dc55aa-f2a1-4093-87bb-f1c0edb6e761
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# COM 用のアセンブリのパッケージ化
+COM 開発者がアプリケーションに組み込むときに役立つ、マネージ型に関する情報を次に示します。  
+  
+-   COM アプリケーションが処理できる型のリスト  
+  
+     マネージ型の中には、COM から参照できない型、参照可能だが作成できない型、および参照と作成の両方が可能な型があります。  アセンブリは、参照できない型、参照できる型、作成できない型、作成できる型を任意に組み合わせて構成できます。  完全を期すために、COM に公開するアセンブリ内の型を識別する必要があります。特に COM に公開するアセンブリ内の型が .NET Framework に公開されている型のサブセットである場合に型の識別が必要になります。  
+  
+     追加情報については、「[相互運用のための .NET 型の要件](../../../docs/framework/interop/qualifying-net-types-for-interoperation.md)」を参照してください。  
+  
+-   バージョン管理に関する注意事項  
+  
+     クラス インターフェイス \(COM 相互運用機能により生成されたインターフェイス\) を実装したマネージ クラスには、バージョン管理に関する制約が生じる場合があります。  
+  
+     クラス インターフェイスを使用する場合のガイドラインについては、「[クラス インターフェイスの概要](http://msdn.microsoft.com/ja-jp/733c0dd2-12e5-46e6-8de1-39d5b25df024)」を参照してください。  
+  
+-   配置に関する注意事項  
+  
+     発行者により署名された厳密な名前のアセンブリは、グローバル アセンブリ キャッシュにインストールできます。  署名のないアセンブリは、プライベート アセンブリとしてユーザーのコンピューターにインストールする必要があります。  
+  
+     追加情報については、「[アセンブリのセキュリティに関する考慮事項](../../../docs/framework/app-domains/assembly-security-considerations.md)」を参照してください。  
+  
+-   タイプ ライブラリのインクルード  
+  
+     大部分の型は、COM アプリケーションで処理されるときにタイプ ライブラリが必要です。  タイプ ライブラリの生成は、自分で行うことも、COM 開発者に任せることもできます。  [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] には、タイプ ライブラリを生成するために次のオプションが用意されています。  
+  
+    -   [タイプ ライブラリ エクスポーター](#cpconpackagingassemblyforcomanchor1)  
+  
+    -   [TypeLibConverter クラス](#cpconpackagingassemblyforcomanchor2)  
+  
+    -   [アセンブリ登録ツール](#cpconpackagingassemblyforcomanchor3)  
+  
+    -   [.NET サービス インストール ツール](#cpconpackagingassemblyforcomanchor4)  
+  
+     どの機構を選択した場合でも、提供するアセンブリ内で定義されたパブリック型だけが、生成されるタイプ ライブラリに含まれます。  
+  
+     タイプ ライブラリは、個別のファイルとしてパッケージ化することも、.NET ベースのアプリケーションに Win32 リソースとして埋め込むこともできます。  Microsoft Visual Basic 6.0 ではこの作業は自動的に実行されますが、[!INCLUDE[vbprvbext](../../../includes/vbprvbext-md.md)] を使用する場合は、手動でタイプ ライブラリを埋め込む必要があります。  手順については、「[方法 : タイプ ライブラリを Win32 リソースとして .NET ベースのアプリケーションに埋め込む](http://msdn.microsoft.com/ja-jp/c97b4b8c-2ab7-4ac7-8fc8-0ba5c5d59c44)」を参照してください。  
+  
+<a name="cpconpackagingassemblyforcomanchor1"></a>   
+## タイプ ライブラリ エクスポーター  
+ [タイプ ライブラリ エクスポーター \(Tlbexp.exe\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md) は、アセンブリに含まれているクラスおよびインターフェイスを COM タイプ ライブラリに変換するコマンド ライン ツールです。  クラスの型情報が利用可能になると、COM クライアントは .NET クラスのインスタンスを生成し、COM オブジェクトの場合と同じ方法でインスタンスのメソッドを呼び出すことができます。  Tlbexp.exe を実行すると、一度に 1 つのアセンブリ全体が変換されます。  Tlbexp.exe を使用しても、アセンブリで定義されている型のサブセットに関する型情報は生成できません。  
+  
+<a name="cpconpackagingassemblyforcomanchor2"></a>   
+## TypeLibConverter クラス  
+ **System.Runtime.Interop** 名前空間にある <xref:System.Runtime.InteropServices.TypeLibConverter> クラスは、アセンブリに含まれているクラスおよびインターフェイスを COM タイプ ライブラリに変換します。  この API は、前のセクションで説明したタイプ ライブラリ エクスポーターと同じ型情報を生成します。  
+  
+ **TypeLibConverter クラス**は、[ITypeLibConverter インターフェイス](frlrfSystemRuntimeInteropServicesITypeLibConverterClassTopic)を実装しています。  
+  
+<a name="cpconpackagingassemblyforcomanchor3"></a>   
+## アセンブリ登録ツール  
+ [アセンブリ登録ツール \(Regasm.exe\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) は、**\/tlb:** オプションを適用すると、タイプ ライブラリを生成および登録できます。  COM クライアントでは、タイプ ライブラリを Windows のレジストリにインストールする必要があります。  このオプションを適用しない場合、Regasm.exe はアセンブリの型だけを登録し、タイプ ライブラリは登録しません。  アセンブリの型を登録することと、タイプ ライブラリを登録することは、まったく別の作業です。  
+  
+<a name="cpconpackagingassemblyforcomanchor4"></a>   
+## .NET サービス インストール ツール  
+ [.NET サービス インストール ツール \(Regsvcs.exe\)](../../../docs/framework/tools/regsvcs-exe-net-services-installation-tool.md) は、Windows 2000 コンポーネント サービスにマネージ クラスを追加したり、1 つのツール内の複数のタスクを統合したりします。  Regsvcs.exe は、アセンブリの読み込および登録だけでなく、タイプ ライブラリの生成、登録、および既存の COM\+ 1.0 アプリケーションへのインストールができます。  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.TypeLibConverter>   
+ <xref:System.Runtime.InteropServices.ITypeLibConverter>   
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [相互運用のための .NET 型の要件](../../../docs/framework/interop/qualifying-net-types-for-interoperation.md)   
+ [Introducing the Class Interface](http://msdn.microsoft.com/ja-jp/733c0dd2-12e5-46e6-8de1-39d5b25df024)   
+ [アセンブリのセキュリティに関する考慮事項](../../../docs/framework/app-domains/assembly-security-considerations.md)   
+ [Tlbexp.exe \(タイプ ライブラリ エクスポーター\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)   
+ [COM へのアセンブリの登録](../../../docs/framework/interop/registering-assemblies-with-com.md)   
+ [How to: Embed Type Libraries as Win32 Resources in Applications](http://msdn.microsoft.com/ja-jp/c97b4b8c-2ab7-4ac7-8fc8-0ba5c5d59c44)
\ No newline at end of file
diff --git a/docs/framework/interop/passing-structures.md b/docs/framework/interop/passing-structures.md
new file mode 100644
index 00000000000..f043aca206d
--- /dev/null
+++ b/docs/framework/interop/passing-structures.md
@@ -0,0 +1,191 @@
+---
+title: "構造体の受け渡し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プラットフォーム呼び出し, 呼び出し (アンマネージ関数の)"
+ms.assetid: 9b92ac73-32b7-4e1b-862e-6d8d950cf169
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 構造体の受け渡し
+多くのアンマネージ関数では、構造体のメンバー \(Visual Basic ではユーザー定義型\) またはマネージ コードで定義されたクラスのメンバーがパラメーターとして渡されることを期待しています。  プラットフォーム呼び出しを使って構造体またはクラスをアンマネージ コードに渡す場合は、元のレイアウトやアラインメントを保持するための追加情報を提供する必要があります。  このトピックでは、フォーマットされた型を定義するために使用する <xref:System.Runtime.InteropServices.StructLayoutAttribute> 属性について説明します。  マネージ構造体やマネージ クラスの場合は、**LayoutKind** 列挙型によって提供される想定されたレイアウト動作から選択できます。  
+  
+ ここで説明する概念の中心は、構造体の型とクラスの型の相違点です。  構造体は値型であり、クラスは参照型です。クラスは常に最低 1 つのレベルのメモリの間接参照 \(値へのポインター\) を提供します。  アンマネージ関数は、次の表の第 1 列のシグネチャに示されているように、間接参照を必要とすることが多いため、この違いは重要です。  他の列のマネージ構造体およびマネージ クラスの宣言は、宣言でどの程度間接参照のレベルを調整できるかを示しています。  宣言は、Visual Basic および Visual C\# の両方で利用できます。  
+  
+|アンマネージ シグネチャ|マネージ宣言               <br /> 間接参照なし               <br />  `Structure MyType`  <br />  `struct MyType;`|マネージ宣言               <br /> 1 レベルの間接参照               <br />  `Class MyType`  <br />  `class MyType;`|  
+|------------------|-----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|  
+|`DoWork(MyType x);`<br /><br /> 0 レベルの間接参照を必要とします。|`DoWork(ByVal x As MyType)`  <br />  `DoWork(MyType x)`<br /><br /> 0 レベルの間接参照を追加します。|既に 1 レベルの間接参照が存在するため調整できません。|  
+|`DoWork(MyType* x);`<br /><br /> 1 レベルの間接参照を必要とします。|`DoWork(ByRef x As MyType)`  <br />  `DoWork(ref MyType x)`<br /><br /> 1 レベルの間接参照を追加します。|`DoWork(ByVal x As MyType)`  <br />  `DoWork(MyType x)`<br /><br /> 0 レベルの間接参照を追加します。|  
+|`DoWork(MyType** x);`<br /><br /> 2 レベルの間接参照を必要とします。|**ByRef** **ByRef** または `ref` `ref` を使用できないため調整できません。|`DoWork(ByRef x As MyType)`  <br />  `DoWork(ref MyType x)`<br /><br /> 1 レベルの間接参照を追加します。|  
+  
+ この表は、プラットフォーム呼び出しの宣言について次のようなガイドラインを示しています。  
+  
+-   アンマネージ関数が間接参照を必要としない場合は、値渡しによる構造体を使用します。  
+  
+-   アンマネージ関数が 1 レベルの間接参照を必要とする場合は、参照渡しによる構造体または値渡しによるクラスのいずれかを使用します。  
+  
+-   アンマネージ関数が 2 レベルの間接参照を必要とする場合は、参照渡しによるクラスを使用します。  
+  
+## 構造体の宣言と受け渡し  
+ マネージ コードで `Point` 型および `Rect` 型を定義し、これらの型を User32.dll ファイル内の **PtInRect** 関数にパラメーターとして渡す方法の例を次に示します。  **PtInRect** は、次に示すアンマネージ シグネチャを持っています。  
+  
+```  
+BOOL PtInRect(const RECT *lprc, POINT pt);  
+```  
+  
+ この関数は RECT 型へのポインターを期待しているため、Rect 構造体は参照渡しする必要があることに注意してください。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+  
+<StructLayout(LayoutKind.Sequential)> Public Structure Point  
+    Public x As Integer  
+    Public y As Integer  
+End Structure  
+  
+Public Structure <StructLayout(LayoutKind.Explicit)> Rect  
+    <FieldOffset(0)> Public left As Integer  
+    <FieldOffset(4)> Public top As Integer  
+    <FieldOffset(8)> Public right As Integer  
+    <FieldOffset(12)> Public bottom As Integer  
+End Structure  
+  
+Class Win32API      
+    Declare Auto Function PtInRect Lib "user32.dll" _  
+    (ByRef r As Rect, p As Point) As Boolean  
+End Class  
+  
+```  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+  
+[StructLayout(LayoutKind.Sequential)]  
+public struct Point {  
+    public int x;  
+    public int y;  
+}     
+  
+[StructLayout(LayoutKind.Explicit)]  
+public struct Rect {  
+    [FieldOffset(0)] public int left;  
+    [FieldOffset(4)] public int top;  
+    [FieldOffset(8)] public int right;  
+    [FieldOffset(12)] public int bottom;  
+}     
+  
+class Win32API {  
+    [DllImport("User32.dll")]  
+    public static extern bool PtInRect(ref Rect r, Point p);  
+}  
+```  
+  
+## クラスの宣言と受け渡し  
+ クラスが固定したメンバー レイアウトを持っている場合に限り、クラスのメンバーをアンマネージ DLL 関数に渡すことができます。  定義の順序で固定されている `MySystemTime` クラスのメンバーを User32.dll ファイル内の **GetSystemTime** に渡す方法の例を次に示します。  **GetSystemTime** は、次に示すアンマネージ シグネチャを持っています。  
+  
+```  
+void GetSystemTime(SYSTEMTIME* SystemTime);  
+```  
+  
+ 値型とは異なり、クラスは常に 1 レベルの間接参照を使用します。  
+  
+```vb  
+Imports System  
+Imports System.Runtime.InteropServices  
+Imports Microsoft.VisualBasic  
+  
+<StructLayout(LayoutKind.Sequential)> Public Class MySystemTime  
+    Public wYear As Short  
+    Public wMonth As Short  
+    Public wDayOfWeek As Short   
+    Public wDay As Short  
+    Public wHour As Short  
+    Public wMinute As Short  
+    Public wSecond As Short  
+    Public wMiliseconds As Short  
+End Class  
+  
+Public Class Win32  
+    Declare Auto Sub GetSystemTime Lib "Kernel32.dll"(sysTime _  
+        As MySystemTime)  
+    Declare Auto Function MessageBox Lib "User32.dll"(hWnd As IntPtr, _  
+        txt As String, caption As String, Typ As Integer) As Integer  
+End Class  
+  
+Public Class TestPlatformInvoke      
+    Public Shared Sub Main()  
+        Dim sysTime As New MySystemTime()  
+        Win32.GetSystemTime(sysTime)  
+  
+        Dim dt As String  
+        dt = "System time is:" & ControlChars.CrLf & _  
+              "Year: " & sysTime.wYear & _  
+              ControlChars.CrLf & "Month: " & sysTime.wMonth & _  
+              ControlChars.CrLf & "DayOfWeek: " & sysTime.wDayOfWeek & _  
+              ControlChars.CrLf & "Day: " & sysTime.wDay  
+        Win32.MessageBox(IntPtr.Zero, dt, "Platform Invoke Sample", 0)        
+    End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+[StructLayout(LayoutKind.Sequential)]  
+public class MySystemTime {  
+    public ushort wYear;   
+    public ushort wMonth;  
+    public ushort wDayOfWeek;   
+    public ushort wDay;   
+    public ushort wHour;   
+    public ushort wMinute;   
+    public ushort wSecond;   
+    public ushort wMilliseconds;   
+}  
+class Win32API {  
+    [DllImport("Kernel32.dll")]  
+    public static extern void GetSystemTime(MySystemTime st);  
+  
+    [DllImport("user32.dll", CharSet=CharSet.Auto)]  
+     public static extern int MessageBox(IntPtr hWnd,  
+         string text, string caption, int options);  
+}  
+  
+public class TestPlatformInvoke  
+{  
+    public static void Main()  
+    {  
+        MySystemTime sysTime = new MySystemTime();  
+        Win32API.GetSystemTime(sysTime);  
+  
+        string dt;  
+        dt = "System time is: \n" +  
+              "Year: " + sysTime.wYear + "\n" +  
+              "Month: " + sysTime.wMonth + "\n" +  
+              "DayOfWeek: " + sysTime.wDayOfWeek + "\n" +  
+              "Day: " + sysTime.wDay;  
+        Win32API.MessageBox(IntPtr.Zero, dt, "Platform Invoke Sample", 0);  
+    }  
+}  
+```  
+  
+## 参照  
+ [DLL 関数の呼び出し](../../../docs/framework/interop/calling-a-dll-function.md)   
+ [StructLayoutAttribute クラス](frlrfSystemRuntimeInteropServicesStructLayoutAttributeClassTopic)   
+ [StructLayoutAttribute クラス](frlrfSystemRuntimeInteropServicesStructLayoutAttributeClassTopic)   
+ [FieldOffsetAttribute クラス](frlrfSystemRuntimeInteropServicesFieldOffsetAttributeClassTopic)
\ No newline at end of file
diff --git a/docs/framework/interop/platform-invoke-examples.md b/docs/framework/interop/platform-invoke-examples.md
new file mode 100644
index 00000000000..6b3dca40184
--- /dev/null
+++ b/docs/framework/interop/platform-invoke-examples.md
@@ -0,0 +1,89 @@
+---
+title: "プラットフォーム呼び出しの例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, プラットフォーム呼び出し"
+  - "DLL 関数"
+  - "例 [.NET Framework], プラットフォーム呼び出し"
+  - "相互運用 (アンマネージ コードとの), プラットフォーム呼び出し"
+  - "プラットフォーム呼び出し, 例"
+  - "アンマネージ関数"
+ms.assetid: 15926806-f0b7-487e-93a6-4e9367ec689f
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# プラットフォーム呼び出しの例
+User32.dll 内の **MessageBox** 関数を定義し、引数として単純な文字列を渡して呼び出す方法の例を次に示します。  この例では、対象となるプラットフォームが文字のバイト幅と文字列のマーシャリング方法を決定できるように、[DllImportAttribute.CharSet Field](frlrfSystemRuntimeInteropServicesDllImportAttributeClassCharSetTopic) フィールドを **Auto** に設定しています。  
+  
+ 同じ内容の例を Visual Basic、C\#、および C\+\+ で示します。  すべての例を表示するには、このページの左上隅にある \[言語のフィルター\] ボタン ![](../../../docs/framework/interop/media/filter2.gif "Filter2") をクリックしてください。  その他の例については、「[プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)」を参照してください。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+  
+Public Class Win32  
+    Declare Auto Function MessageBox Lib "user32.dll" _  
+       (ByVal hWnd As Integer, ByVal txt As String, _  
+       ByVal caption As String, ByVal Typ As Integer) As IntPtr  
+End Class  
+  
+Public Class HelloWorld      
+    Public Shared Sub Main()  
+        Win32.MessageBox(0, "Hello World", "Platform Invoke Sample", 0)  
+    End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+  
+public class Win32 {  
+     [DllImport("user32.dll", CharSet=CharSet.Auto)]  
+     public static extern IntPtr MessageBox(int hWnd, String text,   
+                     String caption, uint type);  
+}  
+  
+public class HelloWorld {  
+    public static void Main() {  
+       Win32.MessageBox(0, "Hello World", "Platform Invoke Sample", 0);  
+    }  
+}  
+  
+```  
+  
+```cpp  
+using namespace System::Runtime::InteropServices;  
+  
+typedef void* HWND;  
+[DllImport("user32", CharSet=CharSet::Auto)]  
+extern "C" IntPtr MessageBox(HWND hWnd,  
+                          String* pText,  
+                          String* pCaption,  
+                          unsigned int uType);  
+void main(void) {  
+     String* pText = L"Hello World!";  
+     String* pCaption = L"Platform Invoke Sample";  
+     MessageBox(0, pText, pCaption, 0);  
+}  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.DllImportAttribute>   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)   
+ [文字セットの指定](../../../docs/framework/interop/specifying-a-character-set.md)
\ No newline at end of file
diff --git a/docs/framework/interop/qualifying-net-types-for-interoperation.md b/docs/framework/interop/qualifying-net-types-for-interoperation.md
new file mode 100644
index 00000000000..c4db84085d6
--- /dev/null
+++ b/docs/framework/interop/qualifying-net-types-for-interoperation.md
@@ -0,0 +1,65 @@
+---
+title: "相互運用のための .NET 型の要件 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 公開 (COM コンポーネントを)"
+  - "COM 相互運用機能, 要件 (.NET 型の)"
+  - "公開 (COM に .NET Framework コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 公開 (.NET Framework コンポーネントを)"
+  - "相互運用 (アンマネージ コードとの), 要件 (.NET 型の)"
+  - "要件 (相互運用のための .NET 型の)"
+ms.assetid: 4b8afb52-fb8d-4e65-b47c-fd82956a3cdd
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 相互運用のための .NET 型の要件
+アセンブリ内の型を COM アプリケーションに公開する場合は、デザイン時に COM 相互運用機能の要件について検討する必要があります。  マネージ型 \(クラス、インターフェイス、構造体、列挙型\) は、次のガイドラインに従うことで、COM 型とシームレスに統合されます。  
+  
+-   クラスでは、インターフェイスを明示的に実装する必要があります。  
+  
+     COM 相互運用機能では、クラスのすべてのメンバーと、その基本クラスのメンバーを含んだインターフェイスを自動的に生成する機能が提供されますが、インターフェイスを明示的に実装する方がはるかに優れています。  自動的に生成されるインターフェイスをクラス インターフェイスと呼びます。  ガイドラインについては、「[クラス インターフェイスの概要](http://msdn.microsoft.com/ja-jp/733c0dd2-12e5-46e6-8de1-39d5b25df024)」を参照してください。  
+  
+     [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)]、C\#、C\+\+ を使うと、インターフェイス定義言語 \(IDL: Interface Definition Language\) またはそれに相当する他の言語を使わなくても、インターフェイス定義をコードに組み込むことができます。  構文の詳細については、使用する言語のドキュメントを参照してください。  
+  
+-   マネージ型はパブリックである必要があります。  
+  
+     アセンブリ内で、登録されたり、タイプ ライブラリにエクスポートされたりするのはパブリック型だけです。  そのため、COM から参照できるのはパブリック型だけです。  
+  
+     マネージ型は他のマネージ コードに対して、COM には公開されない機能を公開します。  たとえば、パラメーター化されたコンストラクター、静的メソッド、定数フィールドは、COM クライアントには公開されません。  また、ランタイムは型のデータを入出力双方にマーシャリングするため、データはコピーまたは変換されることがあります。  
+  
+-   メソッド、プロパティ、フィールド、およびイベントはパブリックである必要があります。  
+  
+     パブリック型のメンバーも、COM から参照できるようにする場合には、パブリックである必要があります。  アセンブリ、パブリック型、またはパブリック型のパブリック メンバーの参照可能範囲を制限するには、<xref:System.Runtime.InteropServices.ComVisibleAttribute> を適用します。  既定では、すべてのパブリック型およびメンバーが参照可能です。  
+  
+-   型は、COM からアクティブ化されるパブリックな既定のコンストラクターを持つ必要があります。  
+  
+     パブリックなマネージ型は COM から参照できます。  ただし、パブリックな既定のコンストラクター \(引数を持たないコンストラクター\) がない場合、COM クライアントでは型を作成できません。  その他のなんらかの方法でアクティブ化された COM クライアントなら、型を使用できます。  
+  
+-   型を抽象型にすることはできません。  
+  
+     COM クライアントでも、.NET クライアントでも、抽象型は生成できません。  
+  
+ マネージ型の継承の階層構造は、COM にエクスポートされると平坦になり、階層がなくなります。  マネージ環境とアンマネージ環境では、バージョン管理も異なります。  COM に公開される型は、他のマネージ型と同じバージョン管理特性を持ちません。  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.ComVisibleAttribute>   
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [Introducing the Class Interface](http://msdn.microsoft.com/ja-jp/733c0dd2-12e5-46e6-8de1-39d5b25df024)   
+ [相互運用固有の属性の適用](../../../docs/framework/interop/applying-interop-attributes.md)   
+ [COM 用のアセンブリのパッケージ化](../../../docs/framework/interop/packaging-an-assembly-for-com.md)
\ No newline at end of file
diff --git a/docs/framework/interop/registering-assemblies-with-com.md b/docs/framework/interop/registering-assemblies-with-com.md
new file mode 100644
index 00000000000..a6f3ceaf58a
--- /dev/null
+++ b/docs/framework/interop/registering-assemblies-with-com.md
@@ -0,0 +1,60 @@
+---
+title: "COM へのアセンブリの登録 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 登録 (アセンブリを)"
+  - "相互運用 (アンマネージ コードとの), 登録 (アセンブリを)"
+  - "登録 (アセンブリを)"
+  - "登録解除 (アセンブリの)"
+ms.assetid: 87925795-a3ae-4833-b138-125413478551
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# COM へのアセンブリの登録
+[アセンブリ登録ツール \(Regasm.exe\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) と呼ばれるコマンド ライン ツールを実行して、COM で使用するアセンブリを登録または登録解除できます。  Regasm.exe はシステム レジストリにクラスの情報を追加するので、COM クライアントが .NET Framework クラスを透過的に使用できます。  <xref:System.Runtime.InteropServices.RegistrationServices> クラスは、これと同等の機能を提供します。  
+  
+ マネージ コンポーネントを COM クライアントからアクティブにするには、Windows レジストリに登録する必要があります。  Regasm.exe によって通常 Windows レジストリに追加されるキーを次の表に示します  \(000000 は実際の GUID 値を示します\)。  
+  
+|GUID|説明|レジストリ キー|  
+|----------|--------|--------------|  
+|CLSID|クラス ID|HKEY\_CLASSES\_ROOT\\CLSID\\{000...000}|  
+|IID|インターフェイス ID|HKEY\_CLASSES\_ROOT\\Interface\\{000...000}|  
+|LIBID|ライブラリ ID|HKEY\_CLASSES\_ROOT\\TypeLib\\{000...000}|  
+|\[ProgID\]|プログラム ID|HKEY\_CLASSES\_ROOT\\000...000|  
+  
+ HKCR\\CLSID\\{0000...0000} キーの下には、既定値としてそのクラスの ProgID が設定され、Class と Assembly という 2 つの名前付きの値が新しく追加されます。  ランタイムは、レジストリから Assembly の値を読み取り、その値をランタイムのアセンブリ リゾルバーに渡します。  アセンブリ リゾルバーは、名前やバージョン番号などのアセンブリ情報に基づいて、そのアセンブリを検索します。  アセンブリ リゾルバーでアセンブリを検出するには、アセンブリが次のいずれかの場所に存在している必要があります。  
+  
+-   グローバル アセンブリ キャッシュ \(厳密な名前を持つアセンブリである必要があります\)。  
+  
+-   アプリケーション ディレクトリ。  アプリケーション パスから読み込まれたアセンブリは、そのアプリケーションからしかアクセスできません。  
+  
+-   Regasm.exe に対して **\/codebase** オプションで指定したファイル パス。  
+  
+ Regasm.exe は HKCR\\CLSID\\{0000....0000} キーの下に、InProcServer32 キーも作成します。  このキーの既定値は、共通言語ランタイム \(Mscoree.dll\) を初期化する DLL の名前に設定されます。  
+  
+## レジストリ エントリのチェック  
+ COM 相互運用機能では、.NET Framework クラスのインスタンスを生成するために、標準のクラス ファクトリの実装が用意されています。  クライアントでは、他の COM コンポーネントの場合と同様に、マネージ DLL 上の **DllGetClassObject** を呼び出してクラス ファクトリを取得し、オブジェクトを生成できます。  
+  
+ `InprocServer32` のサブキーのために、共通言語ランタイムがマネージ オブジェクトが作成されることを示す、Mscoree.dll への参照は、従来の COM タイプ ライブラリの代わりに似ています。  
+  
+## 参照  
+ [COM への .NET Framework コンポーネントの公開](../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [方法: COM から .NET 型を参照する](../../../docs/framework/interop/how-to-reference-net-types-from-com.md)   
+ [Calling a .NET Object](http://msdn.microsoft.com/ja-jp/40c9626c-aea6-4bad-b8f0-c1de462efd33)   
+ [Deploying an Application for COM Access](http://msdn.microsoft.com/ja-jp/fb63564c-c1b9-4655-a094-a235625882ce)
\ No newline at end of file
diff --git a/docs/framework/interop/registration-free-com-interop.md b/docs/framework/interop/registration-free-com-interop.md
new file mode 100644
index 00000000000..5cfbd137ee0
--- /dev/null
+++ b/docs/framework/interop/registration-free-com-interop.md
@@ -0,0 +1,68 @@
+---
+title: "登録を必要としない COM 相互運用機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 相互運用"
+  - "COM 相互運用機能, 登録を必要としない COM 相互運用機能"
+  - "マニフェスト [.NET Framework]"
+  - "オブジェクトのアクティベーション"
+  - "登録を必要としないアクティベーション"
+  - "登録を必要としない COM 相互運用機能"
+  - "登録を必要としない COM 相互運用機能, 登録を必要としない COM 相互運用機能の概要"
+ms.assetid: 90f308b9-82dc-414a-bce1-77e0155e56bd
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 登録を必要としない COM 相互運用機能
+登録を必要としない COM 相互運用機能は、アセンブリ情報を格納するために Windows レジストリを使用しないで、コンポーネントをアクティブにします。  展開中にコンピューター上のコンポーネントを登録するのではなく、バインディングとアクティベーションに関する情報を含む Win32 スタイルのマニフェスト ファイルをデザイン時に作成します。  レジストリ キーではなく、これらのマニフェスト ファイルが、オブジェクトのアクティベーションを指示します。  
+  
+ 展開中に登録するのではなく、登録を必要としないアクティベーションをアセンブリに使用することには、次の 2 つの利点があります。  
+  
+-   複数のバージョンの DLL がコンピューターにインストールされているとき、どのバージョンをアクティブ化するかを制御できます。  
+  
+-   エンドユーザーは XCOPY または FTP を使用して、アプリケーションをコンピューターの適切なディレクトリにコピーできます。  その後、そのディレクトリでアプリケーションを実行できます。  
+  
+ このセクションでは、登録を必要としない COM 相互運用機能に必要な 2 つの種類のマニフェストについて説明します。それらはアプリケーション マニフェストとコンポーネント マニフェストです。  これらのマニフェストは、XML ファイルです。  アプリケーション マニフェストは、アプリケーション開発者によって作成され、アセンブリやアセンブリの依存関係を記述するメタデータを含んでいます。  コンポーネント マニフェストは、コンポーネント開発者によって作成されるものであり、そこには、本来 Windows レジストリに存在する情報が含まれています。  
+  
+### 登録を必要としない COM 相互運用機能の要件  
+  
+1.  登録を必要としない COM 相互運用機能のサポートは、ライブラリ アセンブリの種類に応じて、具体的にはアセンブリがアンマネージ \(COM side\-by\-side\) であるかマネージ \(.NET ベース\) であるかによって、多少異なります。  次の表は、それぞれのアセンブリの種類について、オペレーティング システムと .NET Framework のバージョン要件を示しています。  
+  
+    |アセンブリの種類|オペレーティング システム|.NET Framework のバージョン|  
+    |--------------|-------------------|---------------------------|  
+    |COM side\-by\-side|Microsoft Windows XP|不要。|  
+    |.NET ベース|Windows XP SP2|.NET Framework バージョン 1.1|  
+  
+     Windows Server 2003 ファミリも、.NET ベースのアセンブリで、登録を必要としない COM 相互運用機能をサポートしています。  
+  
+     NET ベースのクラスが COM からのレジストリを必要としないアクティベーションと互換性を持つためには、そのクラスが既定のコンストラクターを持ち、パブリックであることが必要です。  
+  
+### 登録を必要としないアクティベーション用の COM コンポーネントの構成  
+  
+1.  COM コンポーネントが登録を必要としないアクティベーションに含まれるようにするには、それを side\-by\-side アセンブリとして展開する必要があります。  Side\-by\-side アセンブリはアンマネージ アセンブリです。  詳しくは、MSDN ライブラリの「Using Side\-by\-side Assemblies」を参照してください。  
+  
+     COM の side\-by\-side アセンブリを使用するには、.NET ベースのアプリケーション開発者が、バインディングとアクティベーションの情報を含むアプリケーション マニフェストを提供する必要があります。  Windows XP オペレーティング システムには、アンマネージの side\-by\-side アセンブリのサポートが組み込まれています。  オペレーティング システムでサポートされている COM ランタイムは、アクティブ化されるコンポーネントがレジストリに存在しない場合、アプリケーション マニフェストをスキャンしてアクティベーション情報を見つけます。  
+  
+     登録を必要としないアクティベーションは、Windows XP にインストールされている COM コンポーネントでは省略可能です。  アプリケーションに、side\-by\-side アセンブリを追加する方法の詳細な手順については、MSDN ライブラリの「Using Side\-by\-side Assemblies」を参照してください。  
+  
+    > [!NOTE]
+    >  Side\-by\-side 実行は、ランタイムの複数のバージョンと、特定のバージョンのランタイムを使用するアプリケーションおよびコンポーネントの複数のバージョンを、同一のコンピューター上で同時に実行できるようにするための、.NET Framework の機能です。  Side\-by\-side 実行と side\-by\-side アセンブリは、side\-by\-side 機能を提供するための別個のメカニズムです。  
+  
+## 参照  
+ [方法: 登録を必要としないアクティベーション用の .NET Framework ベースの COM コンポーネントを構成する](../../../docs/framework/interop/configure-net-framework-based-com-components-for-reg.md)
\ No newline at end of file
diff --git a/docs/framework/interop/runtime-callable-wrapper.md b/docs/framework/interop/runtime-callable-wrapper.md
new file mode 100644
index 00000000000..5f2ddb7ea30
--- /dev/null
+++ b/docs/framework/interop/runtime-callable-wrapper.md
@@ -0,0 +1,74 @@
+---
+title: "ランタイム呼び出し可能ラッパー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, COM ラッパー"
+  - "COM ラッパー"
+  - "相互運用 (アンマネージ コードとの), COM ラッパー"
+  - "RCW"
+  - "ランタイム呼び出し可能ラッパー"
+ms.assetid: 7e542583-1e31-4e10-b523-8cf2f29cb4a4
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ランタイム呼び出し可能ラッパー
+共通言語ランタイムは、ランタイム呼び出し可能ラッパー \(RCW\) と呼ばれるプロキシを介して COM オブジェクトを公開します。  .NET クライアントでは RCW が普通のオブジェクトとして示されますが、その主な機能は、.NET クライアントと COM オブジェクトの間で呼び出しをマーシャリングすることです。  
+  
+ ランタイムは、COM オブジェクトごとに 1 つの RCW を、そのオブジェクトに存在する参照の数に関係なく作成します。  ランタイムは、各オブジェクトで、プロセスごとに 1 つの RCW を保持します。  1 つのアプリケーション ドメインまたはアパートメントで RCW を作成し、別のアプリケーション ドメインまたはアパートメントへの参照を渡すと、最初のオブジェクトへのプロキシが使用されます。  次の図が示すように、任意の数のマネージ クライアントが、INew および INewer のインターフェイスを公開する COM オブジェクトへの参照を保持できます。  
+  
+ ![RCW](../../../docs/framework/interop/media/rcw.gif "rcw")  
+ランタイム呼び出し可能ラッパーを介して COM オブジェクトにアクセスする  
+  
+ ランタイムは、タイプ ライブラリから派生したメタデータを使用して、呼び出される COM オブジェクトとそのオブジェクトのラッパーの両方を作成します。  各 RCW は、ラップする COM オブジェクトでインターフェイス ポインターのキャッシュを保持し、RCW が不要になった時点で、COM オブジェクトでのその参照を解放します。  ランタイムは、RCW でのガベージ コレクションを実行します。  
+  
+ RCW は、他のさまざまなアクティビティも実行しますが、ラップされたオブジェクトのために、マネージ コードとアンマネージ コードの間でデータをマーシャリングします。  具体的には、RCW はクライアントとサーバーの間でデータの異なる表現が渡されるとき、常にメソッド引数やメソッドの戻り値のマーシャリングを提供します。  
+  
+ 標準ラッパーは、組み込みのマーシャリング規則を適用します。  たとえば、.NET クライアントが文字列型を引数の一部としてアンマネージ オブジェクトに渡すとき、ラッパーは文字列を BSTR 型に変換します。  COM オブジェクトが、マネージ呼び出し元に BSTR を返す場合、呼び出し元は文字列を受信します。  クライアントとサーバーはどちらも、それぞれが使い慣れているデータを送受信します。  その他の型は、変換する必要がありません。  たとえば、標準的なラッパーはマネージ コードとアンマネージ コードの間で、型を変換しないで 4 バイトの整数を常に受け渡しします。  
+  
+## 選択したインターフェイスのマーシャリング  
+ [ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md) \(RCW\) の主な目標は、マネージとアンマネージのプログラミング モデルの違いを見えなくすることです。  次の図に示すように、RCW は選択された COM インターフェイスを .NET クライアントに公開することなく使用して、シームレスな移行を実現します。  
+  
+ ![インターフェイス付き RCW](../../../docs/framework/interop/media/rcwwithinterfaces.gif "rcwwithinterfaces")  
+COM インターフェイスおよびランタイム呼び出し可能ラッパー  
+  
+ 事前バインディングされたオブジェクトとして作成されると、RCW は特定の型になります。  これは、COM オブジェクトが実装するインターフェイスを実装し、オブジェクトのインターフェイスからのメソッド、プロパティ、およびイベントを公開します。  図では、RCW が INew インターフェイスを公開し、**IUnknown** と **IDispatch** インターフェイスを使用します。  さらに、RCW は、INew インターフェイスのすべてのメンバーを .NET クライアントに公開します。  
+  
+ RCW は、それがラップするオブジェクトによって公開されている、次の表にリストされたインターフェイスを使用します。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|**IDispatch**|リフレクションによる COM オブジェクトへの遅延バインディングのために使用します。|  
+|**IErrorInfo**|エラー、そのソース、ヘルプ ファイル、ヘルプ コンテキスト、およびエラーを定義したインターフェイスの GUID \(.NET クラスでは常に **GUID\_NULL**\) に関する説明文を示します。|  
+|**IProvideClassInfo**|ラップされている COM オブジェクトが **IProvideClassInfo** を実装する場合、RCW はこのインターフェイスから型情報を抽出して、より優れた型 ID を提供します。|  
+|**IUnknown**|オブジェクト ID、強制型変換、および有効期間管理のために使用します。<br /><br /> -   オブジェクト ID<br />     ランタイムは、各オブジェクトの **IUnknown** インターフェイスの値を比較することによって、複数の COM オブジェクトを区別します。<br />-   強制型変換<br />     RCW は、**QueryInterface** メソッドによって実行される、動的な型の探索を認識します。<br />-   有効期間管理<br />     RCW は **QueryInterface** メソッドを使用して、アンマネージ オブジェクトへの参照を取得し、ランタイムがラッパーでガベージ コレクションを実行してアンマネージ オブジェクトが解放されるまでその参照を保持します。|  
+  
+ 必要に応じて、RCW はそれがラップするオブジェクトによって公開されている、次の表にリストされたインターフェイスを使用することもできます。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|**IConnectionPoint** と **IConnectionPointContainer**|RCW は、接続ポイントのイベント スタイルを公開するオブジェクトを、デリゲート ベースのイベントに変換します。|  
+|**IDispatchEx**|クラスが **IDispatchEx** を実装する場合、RCW は **IExpando** を実装します。  **IDispatchEx** インターフェイスは、**IDispatch** インターフェイスの拡張版で、**IDispatch** とは異なり、列挙、追加、削除、および大文字小文字を区別したメンバーの呼び出しが可能になります。|  
+|**IEnumVARIANT**|列挙をサポートする COM 型がコレクションとして扱われることを可能にします。|  
+  
+## 参照  
+ [COM ラッパー](../../../docs/framework/interop/com-wrappers.md)   
+ [Marshaling Selected Interfaces](http://msdn.microsoft.com/ja-jp/fdb97fd0-f694-4832-bf15-a4e7cf413840)   
+ [COM 呼び出し可能ラッパー](../../../docs/framework/interop/com-callable-wrapper.md)   
+ [Type Library to Assembly Conversion Summary](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)   
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)
\ No newline at end of file
diff --git a/docs/framework/interop/specifying-a-character-set.md b/docs/framework/interop/specifying-a-character-set.md
new file mode 100644
index 00000000000..c595e9d3088
--- /dev/null
+++ b/docs/framework/interop/specifying-a-character-set.md
@@ -0,0 +1,155 @@
+---
+title: "文字セットの指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性フィールド (プラットフォーム呼び出しにおける), CharSet"
+  - "CharSet フィールド"
+  - "プラットフォーム呼び出し, 属性フィールド"
+ms.assetid: a8347eb1-295f-46b9-8a78-63331f9ecc50
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 文字セットの指定
+<xref:System.Runtime.InteropServices.DllImportAttribute.CharSet?displayProperty=fullName> フィールドは、文字列のマーシャリングを制御したり、プラットフォーム呼び出しで DLL 内の関数名を検索する方法を決定したりします。  このトピックでは、両方の動作について説明します。  
+  
+ 一部の API は、文字列引数がナロー \(ANSI\) とワイド \(Unicode\) の 2 つの関数のバージョンをエクスポートします。  たとえば Win32 API には、**MessageBox** 関数に対して次のエントリ ポイント名が含まれています。  
+  
+-   **MessageBoxA**  
+  
+     1 バイト文字 ANSI 形式を提供します。エントリ ポイント名の末尾の "A" で区別されます。  **MessageBoxA** への呼び出しでは、Windows 95 プラットフォームおよび Windows 98 プラットフォームで通常行われているように、文字列は常に ANSI 形式でマーシャリングされます。  
+  
+-   **MessageBoxW**  
+  
+     2 バイト文字 Unicode 形式を提供します。エントリ ポイント名の末尾の "W" で区別されます。  **MessageBoxW** への呼び出しでは、Windows NT、Windows 2000、Windows XP の各プラットフォームで通常行われているように、文字列は常に Unicode 形式でマーシャリングされます。  
+  
+## 文字列のマーシャリングと名前の一致  
+ **CharSet** フィールドは、次の値を受け入れます。  
+  
+ **CharSet.Ansi** \(既定値\)  
+  
+-   文字列のマーシャリング  
+  
+     プラットフォーム呼び出しでは、文字列をマネージ形式 \(Unicode\) から ANSI 形式にマーシャリングします。  
+  
+-   名前の一致  
+  
+     <xref:System.Runtime.InteropServices.DllImportAttribute.ExactSpelling?displayProperty=fullName> フィールドが **true** \([!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] の既定値\) の場合、プラットフォーム呼び出しでは、指定した名前だけが検索されます。  たとえば **MessageBox** と指定すると、プラットフォーム呼び出しでは **MessageBox** を検索し、正確に一致する名前が見つからない場合には失敗します。  
+  
+     **ExactSpelling** フィールドが **false** \(C\+\+ および C\# の既定値\) の場合、プラットフォーム呼び出しでは、変形処理されていない名前 \(**MessageBox**\) を最初に検索し、それが見つからない場合には、変形処理された名前 \(**MessageBoxA**\) を検索します。  名前の一致の動作は、ANSI と Unicode とでは異なります。  
+  
+ **CharSet.Unicode**  
+  
+-   文字列のマーシャリング  
+  
+     プラットフォーム呼び出しでは、文字列をマネージ形式 \(Unicode\) から Unicode 形式にコピーします。  
+  
+-   名前の一致  
+  
+     **フィールドが** true[!INCLUDE[(vbprvblong]()] の既定値\) の場合、プラットフォーム呼び出しでは、指定した名前だけが検索されます。  たとえば **MessageBox** と指定すると、プラットフォーム呼び出しでは **MessageBox** を検索し、正確に一致する名前が見つからない場合には失敗します。  
+  
+     **ExactSpelling** フィールドが **false** \(C\+\+ および C\# の既定値\) の場合、プラットフォーム呼び出しでは、変形処理された名前 \(**MessageBoxW**\) を最初に検索し、それが見つからない場合には、変形処理されていない名前 \(**MessageBox**\) を検索します。  名前の一致の動作は、Unicode と ANSI とでは異なります。  
+  
+ **CharSet.Auto**  
+  
+-   プラットフォーム呼び出しでは、対象となるプラットフォームに応じて、実行時に ANSI 形式または Unicode 形式を選択します。  
+  
+## Visual Basic での文字セットの指定  
+ **MessageBox** 関数を 3 回宣言し、そのそれぞれで異なる文字セットを指定する例を次に示します。  Visual Basic で文字セットを指定するには、宣言ステートメントに **Ansi**、**Unicode**、または **Auto** キーワードを追加します。  
+  
+ この例の最初の宣言ステートメントのように、文字セット キーワードを省略すると、<xref:System.Runtime.InteropServices.DllImportAttribute.CharSet?displayProperty=fullName> フィールドは既定で ANSI 文字セットに設定されます。  この例の第 2 および第 3 のステートメントでは、キーワードを使用して明示的に文字セットを指定しています。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+  
+Public Class Win32  
+   Declare Function MessageBoxA Lib "user32.dll"(ByVal hWnd As Integer, _  
+       ByVal txt As String, ByVal caption As String, _  
+       ByVal Typ As Integer) As Integer  
+  
+   Declare Unicode Function MessageBoxW Lib "user32.dll" _  
+       (ByVal hWnd As Integer, ByVal txt As String, _  
+        ByVal caption As String, ByVal Typ As Integer) As Integer  
+  
+   Declare Auto Function MessageBox Lib "user32.dll" _  
+       (ByVal hWnd As Integer, ByVal txt As String, _  
+        ByVal caption As String, ByVal Typ As Integer) As Integer  
+End Class  
+```  
+  
+## C\# および C\+\+ での文字セットの指定  
+ <xref:System.Runtime.InteropServices.DllImportAttribute.CharSet?displayProperty=fullName> フィールドでは、基になる文字セットを ANSI または Unicode として識別します。  この文字セットは、メソッドに対する文字列引数をマーシャリングする方法を制御します。  文字セットを指示するには、次のいずれかの書式を使用します。  
+  
+```csharp  
+[DllImport("dllname", CharSet=CharSet.Ansi)]  
+[DllImport("dllname", CharSet=CharSet.Unicode)]  
+[DllImport("dllname", CharSet=CharSet.Auto)]  
+  
+```  
+  
+```cpp  
+[DllImport("dllname", CharSet=CharSet::Ansi)]  
+[DllImport("dllname", CharSet=CharSet::Unicode)]  
+[DllImport("dllname", CharSet=CharSet::Auto)]  
+```  
+  
+ 文字セットを指定する **MessageBox** 関数の 3 種類のマネージ定義の例を次に示します。  最初の定義では、省略によって、**CharSet** フィールドが既定の ANSI 文字セットに設定されます。  
+  
+```csharp  
+[DllImport("user32.dll")]  
+    public static extern int MessageBoxA(int hWnd, String text,   
+        String caption, uint type);  
+[DllImport("user32.dll", CharSet=CharSet.Unicode)]  
+    public static extern int MessageBoxW(int hWnd, String text,   
+        String caption, uint type);  
+[DllImport("user32.dll", CharSet=CharSet.Auto)]  
+    public static extern int MessageBox(int hWnd, String text,   
+        String caption, uint type);  
+  
+```  
+  
+```cpp  
+typedef void* HWND;  
+  
+//Can use MessageBox or MessageBoxA.  
+[DllImport("user32")]  
+extern "C" int MessageBox(HWND hWnd,  
+                          String* pText,  
+                          String* pCaption,  
+                          unsigned int uType);  
+  
+//Can use MessageBox or MessageBoxW.  
+[DllImport("user32", CharSet=CharSet::Unicode)]  
+extern "C" int MessageBoxW(HWND hWnd,  
+                          String* pText,  
+                          String* pCaption,  
+                          unsigned int uType);  
+  
+//Must use MessageBox.  
+[DllImport("user32", CharSet=CharSet::Auto)]  
+extern "C" int MessageBox(HWND hWnd,  
+                          String* pText,  
+                          String* pCaption,  
+                          unsigned int uType);  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.DllImportAttribute>   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)   
+ [プラットフォーム呼び出しの例](../../../docs/framework/interop/platform-invoke-examples.md)   
+ [プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)
\ No newline at end of file
diff --git a/docs/framework/interop/specifying-an-entry-point.md b/docs/framework/interop/specifying-an-entry-point.md
new file mode 100644
index 00000000000..a98a8980d21
--- /dev/null
+++ b/docs/framework/interop/specifying-an-entry-point.md
@@ -0,0 +1,106 @@
+---
+title: "エントリ ポイントの指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性フィールド (プラットフォーム呼び出しにおける), EntryPoint"
+  - "EntryPoint フィールド"
+  - "プラットフォーム呼び出し, 属性フィールド"
+ms.assetid: d1247f08-0965-416a-b978-e0b50652dfe3
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# エントリ ポイントの指定
+エントリ ポイントは、DLL 内の関数の位置を識別します。  マネージ プロジェクト内では、対象となる関数の元の名前または序数エントリ ポイントによって、その関数が相互運用の境界にまたがって識別されます。  また、エントリ ポイントを別の名前に割り当てて、関数の名前を事実上変更できます。  
+  
+ DLL 関数の名前を変更する理由を次に示します。  
+  
+-   大文字と小文字が区別される API 関数名を使わないようにするため  
+  
+-   既存の名前付け標準に合わせるため  
+  
+-   異なるデータ型を受け取る複数の関数を共存させるため \(同じ DLL 関数の複数のバージョンを宣言することによって\)  
+  
+-   ANSI バージョンと Unicode バージョンを持つ API の使用を簡単にするため  
+  
+ このトピックでは、マネージ コード内の DLL 関数の名前を変更する方法について説明します。  
+  
+## Visual Basic での関数名の変更  
+ Visual Basic で <xref:System.Runtime.InteropServices.DllImportAttribute.EntryPoint?displayProperty=fullName> フィールドを設定するには、**Declare** ステートメントで **Function** キーワードを使います。  基本的な宣言を次の例に示します。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+  
+Public Class Win32  
+    Declare Auto Function MessageBox Lib "user32.dll" _  
+       (ByVal hWnd As Integer, ByVal txt As String,_  
+       ByVal caption As String, ByVal Typ As Integer) As Integer  
+End Class  
+```  
+  
+ 定義に **Alias** キーワードを含めることで、**MessageBox** エントリ ポイントを **MsgBox** に置き換えることができます。その例を次に示します。  どちらの例でも、**Auto** キーワードを使って、エントリ ポイントの文字セットのバージョンを指定する手間を省いています。  文字セットの選択の詳細については、「[文字セットの指定](../../../docs/framework/interop/specifying-a-character-set.md)」を参照してください。  
+  
+```vb  
+Imports System.Runtime.InteropServices  
+  
+Public Class Win32  
+    Declare Auto Function MsgBox Lib "user32.dll" _  
+       Alias "MessageBox" (ByVal hWnd As Integer, ByVal txt As String,_  
+       ByVal caption As String, ByVal Typ As Integer) As Integer  
+End Class  
+```  
+  
+## C\# および C\+\+ での関数名の変更  
+ DLL 関数を名前または序数で指定するには、<xref:System.Runtime.InteropServices.DllImportAttribute.EntryPoint?displayProperty=fullName> フィールドを使います。  メソッド定義内の関数の名前が DLL 内のエントリ ポイントと同じである場合は、その関数を **EntryPoint** フィールドで明示的に識別する必要はありません。  同じでない場合は、次のいずれかの属性書式を使って、名前または序数を指示します。  
+  
+```  
+[DllImport("dllname", EntryPoint="Functionname")]  
+[DllImport("dllname", EntryPoint="#123")]  
+```  
+  
+ 序数の前にシャープ記号 \(\#\) を付ける必要があることに注意してください。  
+  
+ **EntryPoint** フィールドを使ってコード内の **MessageBoxA** を **MsgBox** に置き換える方法を次の例に示します。  
+  
+```csharp  
+using System.Runtime.InteropServices;  
+  
+public class Win32 {  
+    [DllImport("user32.dll", EntryPoint="MessageBoxA")]  
+    public static extern int MsgBox(int hWnd, String text, String caption,  
+                                    uint type);  
+}  
+  
+```  
+  
+```cpp  
+using namespace System::Runtime::InteropServices;  
+  
+typedef void* HWND;  
+[DllImport("user32", EntryPoint="MessageBoxA")]  
+extern "C" int MsgBox(HWND hWnd,  
+                      String*  pText,  
+                      String*  pCaption,  
+                      unsigned int uType);  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.DllImportAttribute>   
+ [マネージ コードでのプロトタイプの作成](../../../docs/framework/interop/creating-prototypes-in-managed-code.md)   
+ [プラットフォーム呼び出しの例](../../../docs/framework/interop/platform-invoke-examples.md)   
+ [プラットフォーム呼び出しによるデータのマーシャリング](../../../docs/framework/interop/marshaling-data-with-platform-invoke.md)
\ No newline at end of file
diff --git a/docs/framework/interop/type-equivalence-and-embedded-interop-types.md b/docs/framework/interop/type-equivalence-and-embedded-interop-types.md
new file mode 100644
index 00000000000..3ba21afab29
--- /dev/null
+++ b/docs/framework/interop/type-equivalence-and-embedded-interop-types.md
@@ -0,0 +1,66 @@
+---
+title: "型の等価性と埋め込まれた相互運用機能型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "埋め込まれた相互運用機能型"
+  - "NoPIA"
+  - "プライマリ相互運用機能アセンブリ, 不要 (CLR バージョン 4)"
+  - "型の等価性"
+ms.assetid: 78892eba-2a58-4165-b4b1-0250ee2f41dc
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 型の等価性と埋め込まれた相互運用機能型
+[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降の共通言語ランタイムでは、COM 型の型情報をマネージ アセンブリに直接埋め込むことができ、マネージ アセンブリで COM 型の型情報を相互運用機能アセンブリから取得する必要はありません。  埋め込み型情報に含まれるのはマネージ アセンブリで実際に使用される型とメンバーだけなので、同じ COM 型のビューでも 2 つのマネージ アセンブリで大きく異なる場合があります。  各マネージ アセンブリには、COM 型のビューを表す異なる <xref:System.Type> オブジェクトがあります。  共通言語ランタイムでは、インターフェイス、構造体、列挙体、およびデリゲートについて、これらの異なるビュー間における型の等価性をサポートしています。  
+  
+ 型の等価性とは、あるマネージ アセンブリから別のマネージ アセンブリに渡される COM オブジェクトを、受け取り側のアセンブリの適切なマネージ型にキャストできることです。  
+  
+> [!NOTE]
+>  型の等価性と埋め込まれた相互運用機能型を利用すると、アプリケーションで相互運用機能アセンブリを配置する必要がなくなるため、COM コンポーネントを使用するアプリケーションおよびアドインの配置が簡単になります。  共有 COM コンポーネントの開発者は、それらのコンポーネントを以前のバージョンの .NET Framework で使用するには、これまで同様、プライマリ相互運用機能アセンブリ \(PIA: Primary Interop Assemblies\) を作成する必要があります。  
+  
+## 型の等価性  
+ COM 型の等価性は、インターフェイス、構造体、列挙体、およびデリゲートに対してサポートされます。  COM 型が等価と見なされるのは、次の条件がすべて満たされた場合です。  
+  
+-   型が、どちらもインターフェイス、構造体、列挙体、またはデリゲートである。  
+  
+-   型の ID が同じである。詳細については、次の節を参照してください。  
+  
+-   どちらの型も型の等価性を利用できる。詳細については、「[型の等価性を利用できるように COM 型を指定する](#type_equiv)」を参照してください。  
+  
+### 型の ID  
+ 2 つの型の ID が同じと見なされるのは、それらの型のスコープと ID が一致する場合です。つまり、それぞれの型に <xref:System.Runtime.InteropServices.TypeIdentifierAttribute> 属性があり、この 2 つの属性の <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Scope%2A> プロパティと <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Identifier%2A> プロパティが一致する場合です。  <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Scope%2A> の比較では、大文字と小文字が区別されません。  
+  
+ 型に <xref:System.Runtime.InteropServices.TypeIdentifierAttribute> 属性がない場合でも、または <xref:System.Runtime.InteropServices.TypeIdentifierAttribute> 属性はあるがスコープと ID が指定されていない場合でも、次のように、等価かどうか評価されます。  
+  
+-   インターフェイスの場合、<xref:System.Runtime.InteropServices.GuidAttribute> の値が <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Scope%2A?displayProperty=fullName> プロパティの代わりに使用され、<xref:System.Type.FullName%2A?displayProperty=fullName> プロパティ \(つまり、名前空間を含む型名\) が <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Identifier%2A?displayProperty=fullName> プロパティの代わりに使用されます。  
+  
+-   構造体、列挙体、およびデリゲートの場合、それらを含んでいるアセンブリの <xref:System.Runtime.InteropServices.GuidAttribute> が <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Scope%2A> プロパティの代わりに使用され、<xref:System.Type.FullName%2A?displayProperty=fullName> プロパティが <xref:System.Runtime.InteropServices.TypeIdentifierAttribute.Identifier%2A> プロパティの代わりに使用されます。  
+  
+<a name="type_equiv"></a>   
+### 型の等価性を利用できるように COM 型を指定する  
+ 型の等価性を利用できるように型を指定するには、次の 2 つの方法があります。  
+  
+-   <xref:System.Runtime.InteropServices.TypeIdentifierAttribute> 属性を型に適用します。  
+  
+-   型を COM インポート型にします。  インターフェイスは、<xref:System.Runtime.InteropServices.ComImportAttribute> 属性が設定されている場合、COM インポート型になります。  インターフェイス、構造体、列挙体、またはデリゲートは、その定義元のアセンブリに <xref:System.Runtime.InteropServices.ImportedFromTypeLibAttribute> 属性が設定されている場合、COM インポート型になります。  
+  
+## 参照  
+ <xref:System.Type.IsEquivalentTo%2A>   
+ [Using COM Types in Managed Code](http://msdn.microsoft.com/ja-jp/1a95a8ca-c8b8-4464-90b0-5ee1a1135b66)   
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)
\ No newline at end of file
diff --git a/docs/framework/mef/TOC.md b/docs/framework/mef/TOC.md
new file mode 100644
index 00000000000..dd2c4f31a68
--- /dev/null
+++ b/docs/framework/mef/TOC.md
@@ -0,0 +1,4 @@
+# [コンポジション分析ツール (Mefx)](composition-analysis-tool-mefx.md)
+# [Windows ストア アプリ用 .NET の MEF 名前空間](mef-for-net-for-windows-store-apps.md)
+# [MEF (Managed Extensibility Framework)](index.md)
+# [属性付きプログラミング モデルの概要 (MEF)](attributed-programming-model-overview-mef.md)
diff --git a/docs/framework/mef/attributed-programming-model-overview-mef.md b/docs/framework/mef/attributed-programming-model-overview-mef.md
new file mode 100644
index 00000000000..253c8f0a601
--- /dev/null
+++ b/docs/framework/mef/attributed-programming-model-overview-mef.md
@@ -0,0 +1,380 @@
+---
+title: "属性付きプログラミング モデルの概要 (MEF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "属性付きプログラミング モデル [MEF]"
+  - "MEF, 属性付きプログラミング モデル"
+ms.assetid: 49b787ff-2741-4836-ad51-c3017dc592d4
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 属性付きプログラミング モデルの概要 (MEF)
+MEF \(Managed Extensibility Framework\) における*プログラミング モデル*とは、MEF で操作する一連の概念オブジェクトを定義するための特定の方法です。 これらの概念オブジェクトには、パート、インポート、およびエクスポートが含まれます。 MEF では、これらのオブジェクトが使用されますが、その表現方法は指定されていません。 そのため、カスタマイズしたプログラミング モデルを含むさまざまなプログラミング モデルを使用できます。  
+  
+ MEF で使用される既定のプログラミング モデルは、*属性付きプログラミング モデル*です。 属性付きプログラミング モデルでは、パート、インポート、エクスポート、およびその他のオブジェクトを、通常の .NET Framework クラスを装飾する属性を使用して定義します。 ここでは、属性付きプログラミング モデルの属性を使用して MEF アプリケーションを作成する方法を説明します。  
+  
+<a name="import_and_export_basics"></a>   
+## インポートとエクスポートの基本  
+ *エクスポート*とは、パートがコンテナー内の他のパートに提供する値です。*インポート*とは、パートがコンテナーに対して示す要件で、使用可能なエクスポートによって満たされます。 属性付きプログラミング モデルでインポートとエクスポートを宣言するには、クラスやメンバーを `Import` 属性と `Export` 属性で装飾します。`Export` 属性で装飾できるのは、クラス、フィールド、プロパティ、およびメソッドです。`Import` 属性で装飾できるのは、フィールド、プロパティ、およびコンストラクター パラメーターです。  
+  
+ インポートとエクスポートが一致するには、インポートとエクスポートの*コントラクト*が同じである必要があります。 コントラクトは、*コントラクト名*と呼ばれる文字列と、*コントラクト型*と呼ばれる型 \(エクスポートまたはインポートされるオブジェクトの型\) で構成されます。 エクスポートが特定のインポートを満たすと見なされるのは、コントラクト名とコントラクト型の両方が一致する場合だけです。  
+  
+ これらのコントラクト パラメーターは、どちらも明示的でも暗黙的でもかまいません。 次のコードは、基本的なインポートを宣言するクラスを示しています。  
+  
+```vb  
+Public Class MyClass1 <Import()> Public Property MyAddin As IMyAddin End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import] public IMyAddin MyAddin { get; set; } }  
+```  
+  
+ このインポートでは、`Import` 属性にコントラクト型のパラメーターもコントラクト名のパラメーターもアタッチされていません。 したがって、これらは両方とも、装飾されたプロパティから推論されます。 この例では、コントラクト型は `IMyAddin` になり、コントラクト名は、コントラクト型から作成される一意の文字列になります  \(したがって、このコントラクト名と一致するのは、同じように `IMyAddin` 型から推論された名前を持つエクスポートだけです\)。  
+  
+ 上のインポートと一致するエクスポートの例を次に示します。  
+  
+```vb  
+<Export(GetType(IMyAddin))> Public Class MyLogger Implements IMyAddin End Class  
+```  
+  
+```csharp  
+[Export(typeof(IMyAddin))] public class MyLogger : IMyAddin { }  
+```  
+  
+ このエクスポートのコントラクト型は `IMyAddin` です。これは、`Export` 属性のパラメーターとして指定されています。 エクスポートされる型は、コントラクト型と同じ型、コントラクト型から派生する型、またはコントラクト型を実装する型 \(コントラクト型がインターフェイスの場合\) のいずれかである必要があります。 このエクスポートの実際の型は `MyLogger` で、`IMyAddin` インターフェイスを実装しています。 このエクスポートのコントラクト名はコントラクト型から推論されるため、このエクスポートは前のインポートと一致します。  
+  
+> [!NOTE]
+>  エクスポートとインポートは、パブリック クラスかパブリック メンバーで宣言するのが一般的です。 その他の宣言もサポートされていますが、プライベート、プロテクト、または内部のメンバーをエクスポートしたりインポートしたりすると、パートの分離モデルが壊れるため、推奨されません。  
+  
+ エクスポートとインポートが一致と見なされるには、コントラクト型が厳密に一致している必要があります。 次に例を示します。  
+  
+```vb  
+<Export()> 'WILL NOT match the previous import! Public Class MyLogger Implements IMyAddin End Class  
+```  
+  
+```csharp  
+[Export] //WILL NOT match the previous import! public class MyLogger : IMyAddin { }  
+```  
+  
+ このエクスポートのコントラクト型は、`MyLogger` ではなく `IMyAddin` です。`MyLogger` は `IMyAddin` を実装するため、`IMyAddin` オブジェクトにキャストできますが、コントラクト型が同じではないため、このエクスポートは前のインポートと一致しません。  
+  
+ 一般に、ほとんどのコントラクトはコントラクト型とメタデータで定義する必要があり、コントラクト名を指定する必要はありません。 ただし、コントラクト名を直接指定することが重要である場合もあります。 最も一般的なのは、プリミティブなどの一般的な型を共有する複数の値をクラスでエクスポートする場合です。 コントラクト名を指定するには、`Import` 属性または `Export` 属性の最初のパラメーターを使用します。 次のコードでは、インポートとエクスポートに `MajorRevision` というコントラクト名が指定されています。  
+  
+```vb  
+Public Class MyExportClass 'This one will match <Export("MajorRevision")> Public ReadOnly Property MajorRevision As Integer Get Return 4 End Get End Property <Export("MinorRevision")> Public ReadOnly Property MinorRevision As Integer Get Return 16 End Get End Property End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import("MajorRevision")] public int MajorRevision { get; set; } } public class MyExportClass { [Export("MajorRevision")] //This one will match. public int MajorRevision = 4; [Export("MinorRevision")] public int MinorRevision = 16; }  
+```  
+  
+ コントラクト型は、指定しなくても、インポートやエクスポートの型から推論されます。 ただし、インポートとエクスポートが一致と見なされるには、コントラクト名が明示的に指定されていても、コントラクト型も一致する必要があります。 たとえば、上の `MajorRevision` フィールドが文字列だった場合は、推論されるコントラクト型が一致しなくなるため、コントラクト名が同じであっても、エクスポートとインポートが一致しなくなります。  
+  
+### メソッドのインポートとエクスポート  
+ `Export` 属性は、クラス、プロパティ、または関数と同じようにメソッドを装飾することもできます。 型は推論できないため、メソッドのエクスポートではコントラクト型またはコントラクト名を指定する必要があります。 型には、カスタム デリゲートまたはジェネリック型 \(`Func` など\) を指定できます。 次のクラスは、`DoSomething` というメソッドをエクスポートしています。  
+  
+```vb  
+Public Class MyAddin 'Explicitly specifying a generic type <Export(GetType(Func(Of Integer, String)))> Public Function DoSomething(ByVal TheParam As Integer) As String Return Nothing 'Function body goes here End Function End Class  
+```  
+  
+```csharp  
+public class MyAddin { //Explicitly specifying a generic type. [Export(typeof(Func<int, string>)] public string DoSomething(int TheParam); }  
+```  
+  
+ このクラスの `DoSomething` メソッドは、1 つの `int` パラメーターを受け取って `string` を返します。 このエクスポートに一致するには、インポート側のパートで適切なメンバーが宣言されている必要があります。`DoSomething` メソッドをインポートするクラスを次に示します。  
+  
+```vb  
+Public Class MyClass1 'Contract name must match! <Import()> Public Property MajorRevision As Func(Of Integer, String) End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import] //Contract name must match! public Func<int, string> DoSomething { get; set; } }  
+```  
+  
+ `Func<T, T>` オブジェクトの使用方法の詳細については、「<xref:System.Func%602>」を参照してください。  
+  
+<a name="types_of_imports"></a>   
+## インポートの種類  
+ MEF では、動的インポート、遅延インポート、前提条件インポート、省略可能インポートなど、複数の種類のインポートがサポートされています。  
+  
+### 動的インポート  
+ インポート側のクラスが、特定のコントラクト名を持つ任意の型のエクスポートと一致するようにするには、 クラスで*動的インポート*を宣言します。 次のインポートは、コントラクト名が "TheString" の任意のエクスポートと一致します。  
+  
+```vb  
+Public Class MyClass1 <Import("TheString")> Public Property MyAddin End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import("TheString")] public dynamic MyAddin { get; set; } }  
+```  
+  
+ `dynamic` キーワードから推論されるコントラクト型は、任意のコントラクト型と一致します。 この場合、インポートでコントラクト名を指定する必要があります  \(コントラクト名が指定されていないと、そのインポートはどのエクスポートとも一致しないと見なされます\)。 次のエクスポートは、どちらも前のインポートと一致します。  
+  
+```vb  
+<Export("TheString", GetType(IMyAddin))> Public Class MyLogger Implements IMyAddin End Class <Export("TheString")> Public Class MyToolbar End Class  
+```  
+  
+```csharp  
+[Export("TheString", typeof(IMyAddin))] public class MyLogger : IMyAddin { } [Export("TheString")] public class MyToolbar { }  
+```  
+  
+ 当然ながら、インポート側のクラスが任意の型のオブジェクトに対応できるようになっている必要があります。  
+  
+### 遅延インポート  
+ インポート側のクラスで、インポートされるオブジェクトへの間接参照を使用して、そのオブジェクトがすぐにインスタンス化されないようにするには、 クラスで `Lazy<T>` のコントラクト型を使用して、*遅延インポート*を宣言します。 次のインポート側プロパティは遅延インポートを宣言しています。  
+  
+```vb  
+Public Class MyClass1 <Import()> Public Property MyAddin As Lazy(Of IMyAddin) End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import] public Lazy<IMyAddin> MyAddin { get; set; } }  
+```  
+  
+ `Lazy<T>` のコントラクト型は、合成エンジンでは `T` のコントラクト型と同じと見なされます。 したがって、上のインポートは次のエクスポートと一致します。  
+  
+```vb  
+<Export(GetType(IMyAddin))> Public Class MyLogger Implements IMyAddin End Class  
+```  
+  
+```csharp  
+[Export(typeof(IMyAddin))] public class MyLogger : IMyAddin { }  
+```  
+  
+ `Import` 属性でコントラクト名とコントラクト型を指定する方法については、前の「インポートとエクスポートの基本」を参照してください。  
+  
+### 前提条件インポート  
+ エクスポートされる MEF パートは、通常、直接要求された場合や、一致したインポートを満たす必要がある場合に、合成エンジンによって作成されます。 合成エンジンがパートを作成するとき、既定ではパラメーターなしのコンストラクターが使用されます。 別のコンストラクターが使用されるようにするには、そのコンストラクターを `ImportingConstructor` 属性でマークします。  
+  
+ 合成エンジンで使用するコンストラクターは、各パートで 1 つだけ指定できます。 既定のコンストラクターも `ImportingConstructor` 属性も指定されていない場合や、複数の `ImportingConstructor` 属性が指定されている場合は、エラーになります。  
+  
+ `ImportingConstructor` 属性でマークされたコンストラクターでは、パラメーターを設定するために、すべてのパラメーターが自動的にインポートとして宣言されます。 これは、パートの初期化の際に使用されるインポートを宣言するのに便利です。 次のクラスは、`ImportingConstructor` を使用してインポートを宣言しています。  
+  
+```vb  
+Public Class MyClass1 Private _theAddin As IMyAddin 'Default constructor will NOT be used 'because the ImportingConstructor 'attribute is present. Public Sub New() End Sub 'This constructor will be used. 'An import with contract type IMyAddin 'is declared automatically. <ImportingConstructor()> Public Sub New(ByVal MyAddin As IMyAddin) _theAddin = MyAddin End Sub End Class  
+```  
+  
+```csharp  
+public class MyClass { private IMyAddin _theAddin; //Default constructor will NOT be //used because the ImportingConstructor //attribute is present. public MyClass() { } //This constructor will be used. //An import with contract type IMyAddin is //declared automatically. [ImportingConstructor] public MyClass(IMyAddin MyAddin) { _theAddin = MyAddin; } }  
+```  
+  
+ `ImportingConstructor` 属性では、すべてのパラメーター インポートに対して、推論されるコントラクト型とコントラクト名が既定で使用されます。 これをオーバーライドするには、パラメーターを `Import` 属性で装飾して、コントラクト型とコントラクト名を明示的に定義します。 次のコードは、この構文を使用して親クラスの代わりに派生クラスをインポートするコンストラクターを示しています。  
+  
+```vb  
+<ImportingConstructor()> Public Sub New(<Import(GetType(IMySubAddin))> ByVal MyAddin As IMyAddin) End Sub  
+```  
+  
+```csharp  
+[ImportingConstructor] public MyClass([Import(typeof(IMySubAddin))]IMyAddin MyAddin) { _theAddin = MyAddin; }  
+```  
+  
+ コレクション パラメーターには特別な注意が必要です。 たとえば、`ImportingConstructor` 型のパラメーターを持つコンストラクターに対して `IEnumerable<int>` を指定すると、そのインポートは、`IEnumerable<int>` 型の一連のエクスポートではなく、`int` 型の 1 つのエクスポートと一致します。`int` 型の一連のエクスポートと一致するようにするには、そのパラメーターを `ImportMany` 属性で装飾する必要があります。  
+  
+ `ImportingConstructor` 属性でインポートとして宣言したパラメーターは、*前提条件インポート*としてもマークされます。 MEF では、通常はエクスポートとインポートが*循環参照*を形成することが許可されます。 循環参照とは、たとえば、オブジェクト A がオブジェクト B をインポートし、そのオブジェクト B がオブジェクト A をインポートするような場合です。通常は、循環参照が問題になることはなく、合成コンテナーで両方のオブジェクトが正常に構築されます。  
+  
+ パートのコンストラクターで、インポートされる値が必要な場合、そのオブジェクトは循環参照に参加できません。 オブジェクト A を構築するには先にオブジェクト B が構築されている必要がある場合に、オブジェクト B がオブジェクト A をインポートしていると、循環参照を解決できなくなるため、合成エラーが発生します。 したがって、コンストラクターのパラメーターで宣言されているインポートは前提条件インポートになります。前提条件インポートとは、それらがすべて満たされないと、それらを必要とするオブジェクトのエクスポートを使用できるようにならないインポートです。  
+  
+### 省略可能インポート  
+ `Import` 属性は、パートが機能するための要件を指定します。 インポートが満たされないと、パートの合成が失敗し、そのパートを使用できません。  
+  
+ `AllowDefault` プロパティを使用すると、インポートを*省略可能*として指定できます。 この場合、インポートに一致するエクスポートがなくても合成が成功し、インポート側のプロパティがそのプロパティ型の既定値に設定されます \(オブジェクト プロパティの場合は `null`、ブール型プロパティの場合は `false`、数値プロパティの場合は 0\)。 次のクラスは省略可能インポートを使用しています。  
+  
+```vb  
+Public Class MyClass1 <Import(AllowDefault:=True)> Public Property thePlugin As Plugin 'If no matching export is available, 'thePlugin will be set to null. End Class  
+```  
+  
+```csharp  
+public class MyClass { [Import(AllowDefault = true)] public Plugin thePlugin { get; set; } //If no matching export is avaliable, //thePlugin will be set to null. }  
+```  
+  
+### 複数のオブジェクトのインポート  
+ `Import` 属性が正しく合成されるのは、1 つのエクスポートのみと一致する場合だけです。 それ以外の場合は合成エラーが生成されます。 同じコントラクトに一致する複数のエクスポートをインポートするには、`ImportMany` 属性を使用します。 この属性でマークされているインポートは常に省略可能です。 たとえば、一致するエクスポートが存在しなくても合成は失敗しません。 次のクラスは、`IMyAddin` 型の任意の数のエクスポートをインポートします。  
+  
+```vb  
+Public Class MyClass1 <ImportMany()> Public Property MyAddin As IEnumerable(Of IMyAddin) End Class  
+```  
+  
+```csharp  
+public class MyClass { [ImportMany] public IEnumerable<IMyAddin> MyAddin { get; set; } }  
+```  
+  
+ インポートされた配列にアクセスするには、通常の `IEnumerable<T>` の構文とメソッドを使用します。 通常の配列 \(`IMyAddin[]`\) を使用することもできます。  
+  
+ このパターンは、`Lazy<T>` 構文と組み合わせて使用する場合に非常に重要になる場合があります。 たとえば、`ImportMany`、`IEnumerable<T>`、および `Lazy<T>` を使用すると、任意の数のオブジェクトへの間接参照をインポートして、必要になったものだけをインスタンス化できます。 次のクラスはこのパターンを示しています。  
+  
+```vb  
+Public Class MyClass1 <ImportMany()> Public Property MyAddin As IEnumerable(Of Lazy(Of IMyAddin)) End Class  
+```  
+  
+```csharp  
+public class MyClass { [ImportMany] public IEnumerable<Lazy<IMyAddin>> MyAddin { get; set; } }  
+```  
+  
+<a name="avoiding_discovery"></a>   
+## 検出の回避  
+ パートがカタログの一部として検出されないようにしたい場合があります  \(パートが、使用ではなく継承を目的とする基底クラスである場合など\)。 これを実現するには 2 つの方法があります。 最初の方法は、パート クラスで `abstract` キーワードを使用する方法です。 抽象クラスではエクスポートは提供されませんが、その抽象クラスから派生するクラスに、継承されたエクスポートが提供されます。  
+  
+ クラスを抽象クラスにできない場合は、`PartNotDiscoverable` 属性で装飾できます。 この属性で装飾されたパートは、カタログに含まれません。 次の例は、これらのパターンを示しています。`DataOne` は、カタログによって検出されます。`DataTwo` は、抽象クラスであるため検出されません。`DataThree` は、`PartNotDiscoverable` 属性を使用しているため検出されません。  
+  
+```vb  
+<Export()> Public Class DataOne 'This part will be discovered 'as normal by the catalog. End Class <Export()> Public MustInherit Class DataTwo 'This part will not be discovered 'by the catalog. End Class <PartNotDiscoverable()> <Export()> Public Class DataThree 'This part will also not be discovered 'by the catalog. End Class  
+```  
+  
+```csharp  
+[Export] public class DataOne { //This part will be discovered //as normal by the catalog. } [Export] public abstract class DataTwo { //This part will not be discovered //by the catalog. } [PartNotDiscoverable] [Export] public class DataThree { //This part will also not be discovered //by the catalog. }  
+```  
+  
+<a name="metadata_and_metadata_views"></a>   
+## メタデータとメタデータ ビュー  
+ エクスポートでは、*メタデータ*と呼ばれる自身に関する追加情報を提供できます。 メタデータを使用すると、エクスポートされるオブジェクトのプロパティをインポート側のパートに伝えることができます。 インポート側のパートでは、そのデータを使用して、使用するエクスポートを決定したり、エクスポートを構築せずにその情報を収集したりできます。 そのため、メタデータを使用するインポートは、遅延インポートである必要があります。  
+  
+ メタデータを使用するには、*メタデータ ビュー*と呼ばれるインターフェイスを宣言して、使用できるようにするメタデータを宣言するのが一般的です。 メタデータ ビュー インターフェイスには、それぞれが `get` アクセサーを持つプロパティのみを含める必要があります。 次のインターフェイスはメタデータ ビューの例です。  
+  
+```vb  
+Public Interface IPluginMetadata ReadOnly Property Name As String <DefaultValue(1)> ReadOnly Property Version As Integer End Interface  
+```  
+  
+```csharp  
+public interface IPluginMetadata { string Name { get; } [DefaultValue(1)] int Version { get; } }  
+```  
+  
+ ジェネリック コレクションの `IDictionary<string, object>` をメタデータ ビューとして使用することもできますが、型チェックの利点がなくなるため、使用しないことをお勧めします。  
+  
+ 通常は、メタデータ ビューに含まれているすべてのプロパティが必要になり、それらを提供していないエクスポートは一致と見なされませんが、`DefaultValue` 属性を指定すると、プロパティを省略可能にすることができます。 この場合、そのプロパティが含まれていないと、`DefaultValue` のパラメーターとして指定した既定値が割り当てられます。 次の例は、メタデータで装飾された 2 つの異なるクラスです。 これらのクラスは、どちらも前のメタデータ ビューと一致します。  
+  
+```vb  
+<Export(GetType(IPlugin))> <ExportMetadata("Name", "Logger")> <ExportMetadata("Version", 4)> Public Class MyLogger Implements IPlugin End Class 'Version is not required because of the DefaultValue <Export(GetType(IPlugin))> <ExportMetadata("Name", "Disk Writer")> Public Class DWriter Implements IPlugin End Class  
+```  
+  
+```csharp  
+[Export(typeof(IPlugin)), ExportMetadata("Name", "Logger"), ExportMetadata("Version", 4)] public class Logger : IPlugin { } [Export(typeof(IPlugin)), ExportMetadata("Name", "Disk Writer")] //Version is not required because of the DefaultValue public class DWriter : IPlugin { }  
+```  
+  
+ メタデータは、`Export` 属性の後に `ExportMetadata` 属性を使用して指定します。 各メタデータは名前\/値のペアで構成され、 メタデータの名前の部分が、メタデータ ビューの対応するプロパティの名前と一致する必要があります。一致した場合は、メタデータの値がそのプロパティに割り当てられます。  
+  
+ 使用するメタデータ ビューを指定するのはインポーターです。 メタデータを含むインポートは遅延インポートとして宣言され、`Lazy<T,T>` の 2 番目の型パラメーターとしてメタデータ インターフェイスが指定されます。 次のクラスは、前のパートをメタデータと共にインポートします。  
+  
+```vb  
+Public Class Addin <Import()> Public Property plugin As Lazy(Of IPlugin, IPluginMetadata) End Class  
+```  
+  
+```csharp  
+public class Addin { [Import] public Lazy<IPlugin, IPluginMetadata> plugin; }  
+```  
+  
+ メタデータは、多くの場合、`ImportMany` 属性と組み合わせて使用されます。これにより、使用可能なインポートを解析して 1 つのインポートだけを選択してインスタンス化したり、コレクションをフィルター処理して特定の条件に一致するものを抽出したりできます。 次のクラスでは、`IPlugin` の値が "Logger" である `Name` オブジェクトのみをインスタンス化しています。  
+  
+```vb  
+Public Class User <ImportMany()> Public Property plugins As IEnumerable(Of Lazy(Of IPlugin, IPluginMetadata)) Public Function InstantiateLogger() As IPlugin Dim logger As IPlugin logger = Nothing For Each Plugin As Lazy(Of IPlugin, IPluginMetadata) In plugins If (Plugin.Metadata.Name = "Logger") Then logger = Plugin.Value End If Next Return logger End Function End Class  
+```  
+  
+```csharp  
+public class User { [ImportMany] public IEnumerable<Lazy<IPlugin, IPluginMetadata>> plugins; public IPlugin InstantiateLogger () { IPlugin logger = null; foreach (Lazy<IPlugin, IPluginMetadata> plugin in plugins) { if (plugin.Metadata.Name = "Logger") logger = plugin.Value; } return logger; } }  
+```  
+  
+<a name="import_and_export_inheritance"></a>   
+## インポートとエクスポートの継承  
+ クラスがパートを継承する場合、そのクラスもパートになることがあります。 インポートは常にサブクラスに継承されるため、 パートのサブクラスは常に、同じインポートを親クラスとするパートになります。  
+  
+ `Export` 属性を使用して宣言したエクスポートは、サブクラスに継承されません。 ただし、`InheritedExport` 属性を使用すると、パート自体をエクスポートできます。 この場合、そのパートのサブクラスは、コントラクト名およびコントラクト型を含め、同じエクスポートを継承して提供します。`Export` は、`InheritedExport` 属性とは違って、適用できるのはクラス レベルだけであり、メンバー レベルでは適用できません。 したがって、メンバー レベルのエクスポートを継承することはできません。  
+  
+ 次の 4 つのクラスは、インポートとエクスポートの継承の基本原則を示しています。`NumTwo` は `NumOne` を継承するため、`NumTwo` は `IMyData` をインポートします。 通常のエクスポートは継承されないため、`NumTwo` は何もエクスポートしません。`NumFour` は `NumThree` を継承します。`NumThree` では `InheritedExport` が使用されているため、`NumFour` には、コントラクト型が `NumThree` の 1 つのエクスポートがあります。 メンバー レベルのエクスポートは継承されないため、`IMyData` はエクスポートされません。  
+  
+```vb  
+<Export()> Public Class NumOne <Import()> Public Property MyData As IMyData End Class Public Class NumTwo Inherits NumOne 'Imports are always inherited, so NumTwo will 'Import IMyData 'Ordinary exports are not inherited, so 'NumTwo will NOT export anything.  As a result it 'will not be discovered by the catalog! End Class <InheritedExport()> Public Class NumThree <Export()> Public Property MyData As IMyData 'This part provides two exports, one of 'contract type NumThree, and one of 'contract type IMyData. End Class Public Class NumFour Inherits NumThree 'Because NumThree used InheritedExport, 'this part has one export with contract 'type NumThree. 'Member-level exports are never inherited, 'so IMyData is not exported. End Class  
+```  
+  
+```csharp  
+[Export] public class NumOne { [Import] public IMyData MyData { get; set; } } public class NumTwo : NumOne { //Imports are always inherited, so NumTwo will //import IMyData. //Ordinary exports are not inherited, so //NumTwo will NOT export anything. As a result it //will not be discovered by the catalog! } [InheritedExport] public class NumThree { [Export] Public IMyData MyData { get; set; } //This part provides two exports, one of //contract type NumThree, and one of //contract type IMyData. } public class NumFour : NumThree { //Because NumThree used InheritedExport, //this part has one export with contract //type NumThree. //Member-level exports are never inherited, //so IMyData is not exported. }  
+```  
+  
+ `InheritedExport` 属性にメタデータが関連付けられている場合は、そのメタデータも継承されます  \(詳細については、前の「メタデータとメタデータ ビュー」を参照してください\)。 継承されたメタデータをサブクラスで変更することはできません。 ただし、同じコントラクト名およびコントラクト型と新しいメタデータを使用して `InheritedExport` 属性を再宣言すると、継承されたメタデータをサブクラスで新しいメタデータに置き換えることができます。 次のクラスはこの基本原則を示しています。 ここでは、`MegaLogger` を継承する `Logger` パートに `InheritedExport` 属性が含まれています。`MegaLogger` で Status という新しいメタデータが再宣言されているため、`Logger` のメタデータの Name と Version は継承されません。  
+  
+```vb  
+<InheritedExport(GetType(IPlugin))> <ExportMetadata("Name", "Logger")> <ExportMetadata("Version", 4)> Public Class Logger Implements IPlugin 'Exports with contract type IPlugin 'and metadata "Name" and "Version". End Class Public Class SuperLogger Inherits Logger 'Exports with contract type IPlugin and 'metadata "Name" and "Version", exactly the same 'as the Logger class. End Class <InheritedExport(GetType(IPlugin))> <ExportMetadata("Status", "Green")> Public Class MegaLogger Inherits Logger 'Exports with contract type IPlugin and 'metadata "Status" only. Re-declaring 'the attribute replaces all metadata. End Class  
+```  
+  
+```csharp  
+[InheritedExport(typeof(IPlugin)), ExportMetadata("Name", "Logger"), ExportMetadata("Version", 4)] public class Logger : IPlugin { //Exports with contract type IPlugin and //metadata "Name" and "Version". } public class SuperLogger : Logger { //Exports with contract type IPlugin and //metadata "Name" and "Version", exactly the same //as the Logger class. } [InheritedExport(typeof(IPlugin)), ExportMetadata("Status", "Green")] public class MegaLogger : Logger        { //Exports with contract type IPlugin and //metadata "Status" only. Re-declaring //the attribute replaces all metadata. }  
+```  
+  
+ `InheritedExport` 属性を再宣言してメタデータをオーバーライドする際は、コントラクト型が同じであることを確認してください  \(上の例では、`IPlugin` がコントラクト型です\)。 コントラクト型が違っていると、メタデータがオーバーライドされる代わりに、2 つ目の属性によって別の 2 つ目のエクスポートが作成されます。 したがって、`InheritedExport` 属性をオーバーライドする際は、一般に、上の例のようにコントラクト型を明示的に指定する必要があります。  
+  
+ インターフェイスは直接インスタンス化できないため、通常は `Export` 属性や `Import` 属性で装飾できませんが、 インターフェイス レベルで `InheritedExport` 属性を使用すると、インターフェイスを装飾できます。この場合、そのエクスポートは、関連付けられているメタデータと共に、そのインターフェイスを実装するすべてのクラスに継承されます。 ただし、そのインターフェイス自体をパートとして使用できるようにはなりません。  
+  
+<a name="custom_export_attributes"></a>   
+## カスタム エクスポート属性  
+ 基本エクスポート属性の `Export` および `InheritedExport` を拡張して、メタデータを属性プロパティとして含めることができます。 この手法は、多数のパートに同じようなメタデータを適用したり、メタデータ属性の継承ツリーを作成したりするのに便利です。  
+  
+ カスタム属性では、コントラクト型、コントラクト名、またはその他のメタデータを指定できます。 カスタム属性を定義するには、`ExportAttribute` \(または `InheritedExportAttribute`\) を継承するクラスを `MetadataAttribute` 属性で装飾する必要があります。 次のクラスはカスタム属性を定義しています。  
+  
+```vb  
+<MetadataAttribute()> <AttributeUsage(AttributeTargets.Class, AllowMultiple:=false)> Public Class MyAttribute Inherits ExportAttribute Public Property MyMetadata As String Public Sub New(ByVal myMetadata As String) MyBase.New(GetType(IMyAddin)) myMetadata = myMetadata End Sub End Class  
+```  
+  
+```csharp  
+[MetadataAttribute] [AttributeUsage(AttributeTargets.Class, AllowMultiple=false)] public class MyAttribute : ExportAttribute { public MyAttribute(string myMetadata) : base(typeof(IMyAddin)) { MyMetadata = myMetadata; } public string MyMetadata { get; private set; } }  
+```  
+  
+ このクラスは、`MyAttribute` というコントラクト型と `IMyData` というメタデータを含む `MyMetadata` というカスタム属性を定義しています。`MetadataAttribute` 属性でマークされているクラスのすべてのプロパティは、カスタム属性で定義されているメタデータと見なされます 次の 2 つの宣言は等価です。  
+  
+```vb  
+<Export(GetType(IMyAddin))> <ExportMetadata("MyMetadata", "theData")> Public Property myAddin As MyAddin <MyAttribute("theData")> Public Property myAddin As MyAddin  
+```  
+  
+```csharp  
+[Export(typeof(IMyAddin)), ExportMetadata("MyMetadata", "theData")] public MyAddin myAddin { get; set; }  
+```  
+  
+```  
+[MyAttribute("theData")] public MyAddin myAddin { get; set; }  
+```  
+  
+ 1 つ目の宣言では、コントラクト型とメタデータが明示的に定義されています。 2 つ目の宣言では、コントラクト型とメタデータがカスタム属性で暗黙的に定義されています。 カスタム属性を使用すると、特に、多数のパートに同じ大量のメタデータを適用する必要がある場合 \(著者情報や著作権情報の場合など\) には、多くの時間を節約し、作業の繰り返しを削減できます。 さらに、カスタム属性の継承ツリーを作成して、バリエーションに対応できるようにすることもできます。  
+  
+ カスタム属性で省略可能なメタデータを作成するには、`DefaultValue` 属性を使用します。 この属性をカスタム属性クラスのプロパティに適用すると、そのプロパティが省略可能に指定され、エクスポーターによって指定される必要がなくなります。 値が指定されていない場合は、そのプロパティ型の既定値 \(通常は、`null`、`false`、または 0\) が割り当てられます。  
+  
+<a name="creation_policies"></a>   
+## 作成ポリシー  
+ パートでインポートが指定され、合成が実行される場合、合成コンテナーは、一致するエクスポートを検索します。 インポートと一致するエクスポートが見つかった場合は、インポート側のメンバーが、エクスポートされるオブジェクトのインスタンスに設定されます。 このインスタンスがどこから取得されるかは、エクスポート側のパートの*作成ポリシー*によって制御されます。  
+  
+ 作成ポリシーには、*共有*と*非共有*の 2 種類があります。 共有の作成ポリシーを持つパートは、そのコントラクトを持つパートのコンテナー内のすべてのインポートの間で共有されます。 合成エンジンで一致が検出され、インポート側のプロパティが設定される場合は、そのパートがまだ存在しないときにのみ新しいコピーがインスタンス化され、それ以外のときは既存のコピーが使用されます。 したがって、多数のオブジェクトが同じパートを参照する場合もあります。 このポリシーは、場所によって変化する可能性がある内部状態に依存するパートに対しては使用できません。 このポリシーは、静的なパート、サービスを提供するパート、メモリやその他のリソースを大量に消費するパートに適しています。  
+  
+ 非共有の作成ポリシーを持つパートは、そのいずれかのエクスポートと一致するインポートが検出されるたびに作成されます。 したがって、パートのエクスポートされたコントラクトのいずれかに一致するコンテナー内のすべてのインポートに対して新しいコピーがインスタンス化されます。 それらのコピーの内部状態は共有されません。 このポリシーは、各インポートに固有の内部状態が必要なパートに適しています。  
+  
+ パートの作成ポリシーは、インポートとエクスポートの両方で指定できます。値は、`Shared`、`NonShared`、または `Any` の中から選択できます。 既定値は、インポートもエクスポートも `Any` です。`Shared` または `NonShared` が指定されているエクスポートは、同じ値か `Any` が指定されているインポートとのみ一致します。 同様に、`Shared` または `NonShared` が指定されているインポートは、同じ値か `Any` が指定されているエクスポートとのみ一致します。 互換性のない作成ポリシーを持つインポートとエクスポートは、コントラクト名やコントラクト型が一致しない場合と同様に、一致とは見なされません。 インポートとエクスポートの両方で `Any` が指定されている場合、および作成ポリシーが指定されていないために既定値の `Any` が使用される場合は、既定で共有の作成ポリシーが使用されます。  
+  
+ 次の例では、インポートとエクスポートの両方で作成ポリシーが指定されています。`PartOne` では作成ポリシーが指定されていないため、既定値の `Any` が使用されます。`PartTwo` では作成ポリシーが指定されていないため、既定値の `Any` が使用されます。 インポートとエクスポートの両方で既定値の `Any` が使用されるため、`PartOne` は共有されます。`PartThree` では `Shared` の作成ポリシーが指定されているため、`PartTwo` と `PartThree` は `PartOne` の同じコピーを共有します。`PartFour` では `NonShared` の作成ポリシーが指定されているため、`PartFour` は `PartFive` で共有されません。`PartSix` では `NonShared` の作成ポリシーが指定されているため、`PartFive` と `PartSix` は、どちらも `PartFour` とは別のコピーを受け取ります。`PartSeven` では `Shared` の作成ポリシーが指定されているため、`PartFour` の作成ポリシーを持つ `Shared` はエクスポートされていないため、`PartSeven` のインポートは一致が検出されず、満たされません。  
+  
+```vb  
+<Export()> Public Class PartOne 'The default creation policy for an export is Any. End Class Public Class PartTwo <Import()> Public Property partOne As PartOne 'The default creation policy for an import is Any. 'If both policies are Any, the part will be shared. End Class Public Class PartThree <Import(RequiredCreationPolicy:=CreationPolicy.Shared)> Public Property partOne As PartOne 'The Shared creation policy is explicitly specified. 'PartTwo and PartThree will receive references to the 'SAME copy of PartOne. End Class <Export()> <PartCreationPolicy(CreationPolicy.NonShared)> Public Class PartFour 'The NonShared creation policy is explicitly specified. End Class Public Class PartFive <Import()> Public Property partFour As PartFour 'The default creation policy for an import is Any. 'Since the export's creation policy was explictly 'defined, the creation policy for this property will 'be non-shared. End Class Public Class PartSix <Import(RequiredCreationPolicy:=CreationPolicy.NonShared)> Public Property partFour As PartFour 'Both import and export specify matching creation 'policies.  PartFive and PartSix will each receive 'SEPARATE copies of PartFour, each with its own 'internal state. End Class Public Class PartSeven <Import(RequiredCreationPolicy:=CreationPolicy.Shared)> Public Property partFour As PartFour 'A creation policy mismatch.  Because there is no 'exported PartFour with a creation policy of Shared, 'this import does not match anything and will not be 'filled. End Class  
+```  
+  
+```csharp  
+[Export] public class PartOne { //The default creation policy for an export is Any. } public class PartTwo { [Import] public PartOne partOne { get; set; } //The default creation policy for an import is Any. //If both policies are Any, the part will be shared. } public class PartThree { [Import(RequiredCreationPolicy = CreationPolicy.Shared)] public PartOne partOne { get; set; } //The Shared creation policy is explicitly specified. //PartTwo and PartThree will receive references to the //SAME copy of PartOne. } [Export] [PartCreationPolicy(CreationPolicy.NonShared)] public class PartFour { //The NonShared creation policy is explicitly specified. } public class PartFive { [Import] public PartFour partFour { get; set; } //The default creation policy for an import is Any. //Since the export's creation policy was explictly //defined, the creation policy for this property will //be non-shared. } public class PartSix { [Import(RequiredCreationPolicy = CreationPolicy.NonShared)] public PartFour partFour { get; set; } //Both import and export specify matching creation //policies.  PartFive and PartSix will each receive //SEPARATE copies of PartFour, each with its own //internal state. } public class PartSeven { [Import(RequiredCreationPolicy = CreationPolicy.Shared)] public PartFour partFour { get; set; } //A creation policy mismatch.  Because there is no //exported PartFour with a creation policy of Shared, //this import does not match anything and will not be //filled. }  
+```  
+  
+<a name="life_cycle_and_disposing"></a>   
+## ライフ サイクルと破棄  
+ パートは合成コンテナーでホストされるため、ライフ サイクルが通常のオブジェクトより複雑になることがあります。 パートには、実装できるライフ サイクル関連の重要なインターフェイスが 2 つあります。1 つは `IDisposable`、もう 1 つは `IPartImportsSatisfiedNotification` です。  
+  
+ 終了時に作業を実行したりリソースを解放したりする必要があるパートは、通常の .NET Framework オブジェクトのように `IDisposable` を実装する必要があります。 ただし、パートの作成や参照の管理はコンテナーで行われるため、パートの `Dispose` メソッドを呼び出すのは、そのパートを所有しているコンテナーだけにする必要があります。 コンテナー自体にも `IDisposable` が実装されており、その `Dispose` のクリーンアップの一部として、所有しているすべてのパートの `Dispose` が呼び出されます。 そのため、合成コンテナーと、その合成コンテナーが所有しているパートが不要になった場合は、合成コンテナーを破棄する必要があります。  
+  
+ 有効期間が長い合成コンテナーでは、非共有の作成ポリシーを持つパートによるメモリの消費が問題になることがあります。 これらのパートは共有されないため、何度も作成される可能性がありますが、コンテナー自体が破棄されるまで破棄されません。 この問題に対処するため、コンテナーには `ReleaseExport` メソッドが用意されています。 共有されないエクスポートに対してこのメソッドを呼び出すと、そのエクスポートが合成コンテナーから削除されて破棄されます。 削除されるエクスポートによってのみ使用されるパートも、ツリーの下位にあるものも含め、一緒に削除されて破棄されます。 これにより、合成コンテナー自体を破棄せずにリソースを再利用できます。  
+  
+ `IPartImportsSatisfiedNotification` には、`OnImportsSatisfied` という 1 つのメソッドが含まれています。 このメソッドは、合成コンテナーにより、このインターフェイスを実装するパートに対して、合成が完了してそのパートのインポートを使用できるようになったときに呼び出されます。 パートは、他のパートのインポートを満たすために合成エンジンによって作成されます。 パートのインポートが設定されるまでは、パートのコンストラクターで、インポートされる値に依存する初期化や、インポートされる値を操作する初期化を実行できません。初期化を実行できるようにするには、`ImportingConstructor` 属性を使用して、それらの値を必須として指定します。 通常はこの方法が推奨されますが、コンストラクター インジェクションを使用できない場合もあります。 そのような場合は、`OnImportsSatisfied` で初期化を実行できます。この場合は、パートに `IPartImportsSatisfiedNotification` を実装する必要があります。  
+  
+## 参照  
+ [Channel 9 ビデオ: Managed Extensibility Framework を使用してアプリケーションを開く](http://channel9.msdn.com/events/TechEd/NorthAmerica/2009/DTL328)   
+ [Channel 9 ビデオ: Managed Extensibility Framework \(MEF\) 2.0](http://channel9.msdn.com/posts/NET-45-Oleg-Lvovitch-and-Kevin-Ransom-Managed-Extensibility-Framework-MEF-20)
\ No newline at end of file
diff --git a/docs/framework/mef/composition-analysis-tool-mefx.md b/docs/framework/mef/composition-analysis-tool-mefx.md
new file mode 100644
index 00000000000..53206fe3a59
--- /dev/null
+++ b/docs/framework/mef/composition-analysis-tool-mefx.md
@@ -0,0 +1,134 @@
+---
+title: "コンポジション分析ツール (Mefx) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンポジション分析ツール [MEF]"
+  - "MEF, コンポジション分析ツール"
+  - "Mefx [MEF], コンポジション分析ツール"
+ms.assetid: c48a7f93-83bb-4a06-aea0-d8e7bd1502ad
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# コンポジション分析ツール (Mefx)
+合成分析ツール \(Mefx\) は、Managed Extensibility Framework \(MEF\) のパートが含まれたライブラリ \(.dll\) ファイルとアプリケーション \(.exe\) ファイルを分析するコマンド ライン アプリケーションです。 Mefx の主な目的は、開発者が煩雑なトレース コードをアプリケーション自体に追加することなく、MEF アプリケーションの合成エラーを診断できるようにすることです。 また、Mefx は、サード パーティが提供するライブラリのパートについて理解する際にも役立ちます ここでは、Mefx の使用方法について説明し、構文のリファレンスを示します。  
+  
+<a name="getting_mefx"></a>   
+## Mefx の入手  
+ Mefx は、Codeplex の [Managed Extensibility Framework](http://go.microsoft.com/fwlink/?LinkID=187078) で入手できます。 ツールをダウンロードして解凍してください。  
+  
+<a name="basic_syntax"></a>   
+## 基本構文  
+ Mefx は、次の形式でコマンド ラインから起動します。  
+  
+```  
+mefx [files and directories] [action] [options]  
+```  
+  
+ 引数の最初のセットでは、分析対象のパートの読み込み元となるファイルとディレクトリを指定します。`/file:` スイッチを使用してファイルを指定し、`/directory:` スイッチを使用してディレクトリを指定します。 次の例に示すように、複数のファイルまたはディレクトリを指定できます。  
+  
+```  
+mefx /file:MyAddIn.dll /directory:Program\AddIns [action...]  
+```  
+  
+> [!NOTE]
+>  各 .dll または .exe は一度だけ読み込むようにしてください。 1 つのファイルを何度も読み込むと、ツールから間違った情報が返されることがあります。  
+  
+ ファイルとディレクトリを指定した後、コマンドと、そのコマンドのオプションを指定する必要があります。  
+  
+<a name="listing_available_parts"></a>   
+## 使用可能なパートの一覧を表示する  
+ `/parts` アクションを使用すると、読み込んだファイルで宣言されているすべてのパートの一覧が表示されます。 結果は、パート名の単純なリストです。  
+  
+```  
+mefx /file:MyAddIn.dll /parts  
+MyAddIn.AddIn  
+MyAddIn.MemberPart  
+```  
+  
+ パートの詳細を参照する場合は、`/verbose` オプションを使用します。 利用可能なすべてのパートの詳細が出力されます。 1 つのパートに関する詳細情報を入手する場合は、`/parts` アクションではなく `/type` アクションを使用します。  
+  
+```  
+mefx /file:MyAddIn.dll /type:MyAddIn.AddIn /verbose  
+[Part] MyAddIn.MemberPart from: AssemblyCatalog (Assembly=" MyAddIn, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")  
+  [Export] MyAddIn.MemberPart (ContractName=" MyAddIn.MemberPart")  
+```  
+  
+<a name="listing_imports_and_exports"></a>   
+## インポートとエクスポートの一覧表示  
+ `/imports` アクションと `/exports` アクションでは、インポートされたすべてのパートと、エクスポートされたすべてのパートがそれぞれ一覧表示されます。`/importers` アクションまたは `/exporters` アクションを使用して、特定の型をインポートまたはエクスポートするパートを一覧表示することもできます。  
+  
+```  
+mefx /file:MyAddIn.dll /importers:MyAddin.MemberPart  
+MyAddin.AddIn  
+```  
+  
+ これらのアクションに `/verbose` オプションを適用することもできます。  
+  
+<a name="finding_rejected_parts"></a>   
+## 拒否されたパートの検索  
+ 使用可能なパートを読み込んだ後、Mefx は MEF 合成エンジンを使用してそれらのパートを合成します。 正常に構成できないパートのことを、*拒否された*パートと呼びます。 拒否されたすべてのパートの一覧を表示するには、`/rejected` アクションを使用します。  
+  
+ `/rejected` アクションで `/verbose` オプションを使用すると、拒否されたパートに関する詳細情報が出力されます。 次の例では、`ClassLibrary1` という DLL に `AddIn` パートが含まれています。このパートは、`MemberPart` パートと `ChainOne` パートをインポートします。`ChainOne` は `ChainTwo` をインポートしますが、`ChainTwo` が存在しません。 そのため、`ChainOne` が拒否され、この拒否が原因で `AddIn` も拒否されることになります。  
+  
+```  
+mefx /file:ClassLibrary1.dll /rejected /verbose  
+```  
+  
+ 前のコマンドの完全な出力を次に示します。  
+  
+```  
+[Part] ClassLibrary1.AddIn from: AssemblyCatalog (Assembly="ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")  
+  [Export] ClassLibrary1.AddIn (ContractName="ClassLibrary1.AddIn")  
+  [Import] ClassLibrary1.AddIn.memberPart (ContractName="ClassLibrary1.MemberPart")  
+    [SatisfiedBy] ClassLibrary1.MemberPart (ContractName="ClassLibrary1.MemberPart") from: ClassLibrary1.MemberPart from: AssemblyCatalog (Assembly="ClassLibrar  
+y1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")  
+  [Import] ClassLibrary1.AddIn.chain (ContractName="ClassLibrary1.ChainOne")  
+    [Exception] System.ComponentModel.Composition.ImportCardinalityMismatchException: No valid exports were found that match the constraint '((exportDefinition.ContractName == "ClassLibrary1.ChainOne") AndAlso (exportDefinition.Metadata.ContainsKey("ExportTypeIdentity") AndAlso "ClassLibrary1.ChainOne".Equals(exportDefinition.Metadata.get_Item("ExportTypeIdentity"))))', invalid exports may have been rejected.  
+   at System.ComponentModel.Composition.Hosting.ExportProvider.GetExports(ImportDefinition definition, AtomicComposition atomicComposition)  
+   at Microsoft.ComponentModel.Composition.Diagnostics.CompositionInfo.AnalyzeImportDefinition(ExportProvider host, IEnumerable`1 availableParts, ImportDefinition id)  
+    [Unsuitable] ClassLibrary1.ChainOne (ContractName="ClassLibrary1.ChainOne")  
+from: ClassLibrary1.ChainOne from: AssemblyCatalog (Assembly="ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")  
+      [Because] PartDefinitionIsRejected, The part providing the export is rejected because of other issues.  
+  
+[Part] ClassLibrary1.ChainOne from: AssemblyCatalog (Assembly="ClassLibrary1, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null")  
+  [Primary Rejection]  
+  [Export] ClassLibrary1.ChainOne (ContractName="ClassLibrary1.ChainOne")  
+  [Import] ClassLibrary1.ChainOne.chain (ContractName="ClassLibrary1.ChainTwo")  
+    [Exception] System.ComponentModel.Composition.ImportCardinalityMismatchException: No valid exports were found that match the constraint '((exportDefinition.ContractName == "ClassLibrary1.ChainTwo") AndAlso (exportDefinition.Metadata.ContainsKey("ExportTypeIdentity") AndAlso "ClassLibrary1.ChainTwo".Equals(exportDefinition.Metadata.get_Item("ExportTypeIdentity"))))', invalid exports may have been rejected.  
+   at System.ComponentModel.Composition.Hosting.ExportProvider.GetExports(ImportDefinition definition, AtomicComposition atomicComposition)  
+   at Microsoft.ComponentModel.Composition.Diagnostics.CompositionInfo.AnalyzeImportDefinition(ExportProvider host, IEnumerable`1 availableParts, ImportDefinition id)  
+```  
+  
+ `[Exception]` と `[Unsuitable]` の結果に、有用な情報が含まれています。`[Exception]` の結果には、パートが拒否された理由に関する情報が示されています。`[Unsuitable]` の結果には、他の点では一致するパートを使用してインポートを満たせなかった理由が示されています。ここでは、インポートが見つからないために、パートそのものが拒否されたということが分かります。  
+  
+<a name="analyzing_primary_causes"></a>   
+## 主要な原因を分析する  
+ 長い依存関係チェーンで複数のパートがリンクされている場合、最下位付近のパートに関係する問題によって、チェーン全体が拒否されることがあります。 エラーの根本原因が必ずしも明らかであるとは限らないため、このような問題は診断が難しい場合があります。 問題解決に役立てるために、`/causes` アクションを使用できます。このアクションでは、拒否の連鎖の根本原因を見つけることを試みます。  
+  
+ 前の例で `/causes` アクションを使用すると、`ChainOne` に関する情報だけが示されます。このパートのインポートが満たされなかったことが、`AddIn` が拒否された根本原因であるためです。`/causes` アクションは、通常のオプションと `/verbose` オプションの両方で使用できます。  
+  
+> [!NOTE]
+>  ほとんどの場合、連鎖するエラーの根本原因を Mefx で診断できます。 ただし、パートがプログラムによってコンテナーに追加される場合、階層コンテナーが関係している場合、またはカスタムの `ExportProvider` 実装が関係している場合には、Mefx によって原因を診断することができません これらの状況では一般にエラーの診断が難しいため、できるだけ避けることをお勧めします。  
+  
+<a name="white_lists"></a>   
+## ホワイト リスト  
+ `/whitelist` オプションでは、拒否されることが予想されるパートの一覧を示すテキスト ファイルを指定できます。 予期されない拒否にはフラグが設定されます。 これは、一部の依存関係が見つからない不完全なライブラリまたはサブライブラリを分析する際に役立ちます。`/whitelist` オプションは、`/rejected` アクションまたは `/causes` アクションに適用できます。  
+  
+ "ClassLibrary1.ChainOne" というテキストが含まれた test.txt という名前のファイルがあるとします。 前の例で、`/rejected` アクションに `/whitelist` オプションを指定して実行すると、次の出力が生成されます。  
+  
+```  
+mefx /file:ClassLibrary1.dll /rejected /whitelist:test.txt  
+[Unexpected] ClassLibrary1.AddIn  
+ClassLibrary1.ChainOne  
+```
\ No newline at end of file
diff --git a/docs/framework/mef/index.md b/docs/framework/mef/index.md
new file mode 100644
index 00000000000..df62c861fc7
--- /dev/null
+++ b/docs/framework/mef/index.md
@@ -0,0 +1,478 @@
+---
+title: "MEF (Managed Extensibility Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Managed Extensibility Framework の概要"
+  - "MEF, 概要"
+ms.assetid: 6c61b4ec-c6df-4651-80f1-4854f8b14dde
+caps.latest.revision: 31
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# MEF (Managed Extensibility Framework)
+ここでは、.NET Framework 4 で導入された Managed Extensibility Framework の概要を説明します。  
+  
+<a name="what_is_mef"></a>   
+## <a name="what-is-mef"></a>MEF とは  
+ Managed Extensibility Framework (MEF) は、軽量で拡張可能なアプリケーションを作成するためのライブラリです。 これにより、アプリケーション開発者は、拡張機能を見つけたら、それをそのまま使用できます。構成は必要ありません。 拡張機能の開発者は、コードを簡単にカプセル化できるため、ハードコーディングによる脆弱な依存関係を回避できます。 MEF により、アプリケーション内だけでなく、アプリケーション間でも拡張機能を再利用できます。  
+  
+<a name="the_problem_of_extensibility"></a>   
+## <a name="the-problem-of-extensibility"></a>機能拡張の問題  
+ 機能拡張のサポートを提供する必要のある大規模アプリケーションの設計担当者である場合を想像してください。 アプリケーションには数多くの小規模コンポーネントを含める必要がある可能性があり、アプリケーションはこれらを作成して実行する必要があります。  
+  
+ このような問題を解決する最も簡単な方法は、アプリケーションにコンポーネントをソース コードとして組み込み、これらのコードをコードから直接呼び出すことです。  この方法には、数多くの明らかな欠点があります。  最も重要な点は、ソース コードを変更することなく新しいコンポーネントを追加できないという点です。これは、Web アプリケーションなどでは許容されますが、クライアント アプリケーションでは許容されません。  同様に重要な問題点として、開発元がサードパーティであるためにコンポーネントのソース コードにアクセスできないことがあります。また、同じ理由から、サードパーティ側からの (自分が開発したコンポーネントのソース コードへの) アクセスを許可することもできません。  
+  
+ より高度な方法として、拡張ポイントまたはインターフェイスを提供して、アプリケーションとそのコンポーネントを切り離すことを許可する方法があります。  このモデルでは、必要に応じて、コンポーネントによって実装可能なインターフェイスと、そのインターフェイスがアプリケーションと対話するための API を提供できます。  これにより、ソース コードへのアクセスが必要になるという問題は解決されますが、この方法そのものにまだ問題があります。  
+  
+ アプリケーションには独自にコンポーネントを検出する機能がないため、アプリケーションに対して使用可能なコンポーネントと読み込む必要のあるコンポーネントを明示的に指定する必要があります。  これは、通常、構成ファイルに使用可能なコンポーネントを明示的に登録することで指定します。 これは、登録されたコンポーネントが正しいことが想定されることにより、特に開発者ではなくエンド ユーザーが更新を行う場合は、保守の問題が生じることを意味します。  
+  
+ さらに、アプリケーション自体の厳密に定義されたチャネルを介する場合を除き、コンポーネントは相互に通信することができません。  アプリケーションの設計担当者が特定の通信の必要性が生じる状況を想定しなかった場合、通常、通信は不可能です。  
+  
+ 最後に、コンポーネントの開発者は、どのアセンブリが実装するインターフェイスを含んでいるかに対するハードコーディングによる依存関係を許容する必要があります。  これにより、1 つのコンポーネントを複数のアプリケーションで使用することが困難となり、コンポーネントのテスト フレームワークを作成するときに問題が生じる可能性もあります。  
+  
+<a name="what_mef_provides"></a>   
+## <a name="what-mef-provides"></a>MEF が提供する機能  
+ MEF が暗黙的に検出する方法を提供する使用可能なコンポーネントの明示的なこの登録の代わりに使用して*コンポジション*します。  呼ばれる、MEF コンポーネント、*一部*宣言によって、両方の依存関係を指定 (と呼ばれる*インポート*) とどのような機能 (と呼ばれる*エクスポート*) 利用できます。 パートが作成されると、MEF 合成エンジンは、他のパートから使用可能なパートでそのインポートを満たします。  
+  
+ この方法により、前のセクションで説明した問題が解決されます。  MEF パートは、その機能を宣言的に指定するため、実行時に検出できます。これは、アプリケーションがハードコーディングされた参照または脆弱な構成ファイルを使用せずにパートを使用できることを意味します。  MEF を使用すると、アプリケーションは、メタデータを使用してパートを検出し、検証することができます。これらのパートをインスタンス化したり、そのアセンブリを読み込んだりする必要はありません。 結果として、拡張機能がいつどのように読み込まれる必要があるかを慎重に指定する必要がありません。  
+  
+ パートは、それが提供するエクスポートに加えて、他のパートで満たされるインポートを指定できます。  これにより、パート間の通信が可能になるだけでなく、簡単になり、コードのファクタリングが可能になります。 たとえば、多くのコンポーネントに共通のサービスを個々のパートにファクタリングして、簡単に変更したり置換したりすることができます。  
+  
+ MEF モデルでは、特定のアプリケーション アセンブリでハードコーディングによる依存関係を指定する必要がないため、アプリケーション間で拡張機能を再利用できます。  これによってテスト ハーネスの開発も容易になり、アプリケーションに依存せずに拡張コンポーネントをテストできます。  
+  
+ MEF を使用して記述された拡張アプリケーションは、拡張コンポーネントで満たすことのできるインポートを宣言できます。また、拡張機能に対してアプリケーション サービスを公開するためにエクスポートを宣言できる場合もあります。  各拡張コンポーネントは、エクスポートを宣言するだけではなく、インポートを宣言することもあります。  こうすると、拡張コンポーネント自体が自動的に拡張可能になります。  
+  
+<a name="where_is_mef_available"></a>   
+## <a name="where-is-mef-available"></a>MEF を使用できる環境  
+ MEF は、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の不可欠な構成要素であり、.NET Framework が使用されている環境であればどのような環境でも使用できます。  MEF は、Windows フォームや WPF などのテクノロジを使用するクライアント アプリケーション、または ASP.NET を使用するサーバー アプリケーションで使用できます。  
+  
+<a name="mef_and_maf"></a>   
+## <a name="mef-and-maf"></a>MEF と MAF  
+ アプリケーションが拡張機能を特定および管理できるように設計された MAF (Managed Add-in Framework) は、以前のバージョンの .NET Framework で導入されました。  MAF では MEF と比較してやや高度なレベルに重点が置かれており、MEF では発見可能性、拡張性、および移植性に重点が置かれているのに対し、MAF では拡張機能の特定とアセンブリの読み込みおよびアンロードに重点が置かれています。  この&2; つのフレームワークは円滑に相互運用でき、1 つのアプリケーションで両方を活用することができます。  
+  
+<a name="simplecalculator_an_example_application"></a>   
+## <a name="simplecalculator-an-example-application"></a>SimpleCalculator: サンプル アプリケーション  
+ MEF が実行できる処理を理解する最も簡単な方法は、単純な MEF アプリケーションを作成することです。 この例では、SimpleCalculator という名前の単純な電卓を作成します。 SimpleCalculator の目的は、"5+3" や "6-2" などの形式で基本的な算術命令を受け取り、正しい答えを返すコンソール アプリケーションを作成することです。 MEF を使用すると、アプリケーション コードを変更せずに、新しい演算子を追加できます。  
+  
+ この例の完全なコードをダウンロードするには、 [SimpleCalculator のサンプル](http://code.msdn.microsoft.com/windowsdesktop/Simple-Calculator-MEF-1152654e)します。  
+  
+> [!NOTE]
+>  SimpleCalculator を作成する目的は、これを使用する実際のシナリオを必ずしも提供することではなく、MEF の概念と構文を示すことにあります。 MEF の機能を最大限に活用できるアプリケーションの多くは、SimpleCalculator よりも複雑です。 広範な例については、次を参照してください。、 [Managed Extensibility Framework](http://go.microsoft.com/fwlink/?LinkId=144282) codeplex します。  
+  
+ まず、 [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)]、という名前の新しいコンソール アプリケーション プロジェクトを作成する`SimpleCalculator`です。 MEF が存在する System.ComponentModel.Composition アセンブリへの参照を追加します。 Module1.vb または Program.cs を開き、System.ComponentModel.Composition および System.ComponentModel.Composition.Hosting の `Imports` ステートメントまたは `using` ステートメントを追加します。 これらの&2; つの名前空間には、拡張可能なアプリケーションの開発に必要な MEF 型が含まれています。 Visual Basic では、`Public` モジュールを宣言する行に `Module1` キーワードを追加します。  
+  
+<a name="composition_container_and_catalogs"></a>   
+## <a name="composition-container-and-catalogs"></a>合成コンテナーとカタログ  
+ MEF 合成モデルの中核となるは、*合成コンテナー*、利用可能なすべてのパートが含まれ、合成を実行します。  (つまり、インポートとエクスポートの組み合わせ)。最も一般的な種類の合成コンテナーは<xref:System.ComponentModel.Composition.Hosting.CompositionContainer>SimpleCalculator にこれを使用するとします。  
+  
+ Visual Basic では、Module1.vb に `Program` という名前のパブリック クラスを追加します。 それから、Module1.vb ファイルまたは Program.cs ファイルの `Program` クラスに次の行を追加します。  
+  
+```vb  
+Dim _container As CompositionContainer  
+```  
+  
+```csharp  
+private CompositionContainer _container;  
+```  
+  
+ 合成コンテナーに使用可能なパートを検出するために利用して、*カタログ*します。 カタログは、いくつかのソースから使用できるパートを検出するためのオブジェクトです。  MEF では、指定された型、アセンブリ、またはディレクトリからパートを検出するカタログを提供します。 アプリケーション開発者は、Web サービスなどの他のソースからパートを検出する新しいカタログを簡単に作成できます。  
+  
+ `Program` クラスに次のコンストラクターを追加します。  
+  
+```vb  
+Public Sub New()  
+    'An aggregate catalog that combines multiple catalogs  
+     Dim catalog = New AggregateCatalog()  
+  
+    'Adds all the parts found in the same assembly as the Program class  
+    catalog.Catalogs.Add(New AssemblyCatalog(GetType(Program).Assembly))  
+  
+    'Create the CompositionContainer with the parts in the catalog  
+    _container = New CompositionContainer(catalog)  
+  
+    'Fill the imports of this object  
+    Try  
+        _container.ComposeParts(Me)  
+    Catch ex As Exception  
+        Console.WriteLine(ex.ToString)  
+    End Try  
+End Sub  
+```  
+  
+```csharp  
+private Program()  
+{  
+    //An aggregate catalog that combines multiple catalogs  
+    var catalog = new AggregateCatalog();  
+    //Adds all the parts found in the same assembly as the Program class  
+    catalog.Catalogs.Add(new AssemblyCatalog(typeof(Program).Assembly));  
+  
+    //Create the CompositionContainer with the parts in the catalog  
+    _container = new CompositionContainer(catalog);  
+  
+    //Fill the imports of this object  
+    try  
+    {  
+        this._container.ComposeParts(this);  
+    }  
+    catch (CompositionException compositionException)  
+    {  
+        Console.WriteLine(compositionException.ToString());  
+   }  
+}  
+```  
+  
+ 呼び出し<xref:System.ComponentModel.Composition.AttributedModelServices.ComposeParts%2A> 、合成コンテナーに対してここでは、パーツの特定セットの現在のインスタンスに指示`Program`します。 ただし、この時点では、`Program` に満たす必要のあるインポートがないため、何も実行されません。  
+  
+<a name="imports_and_exports_with_attributes"></a>   
+## <a name="imports-and-exports-with-attributes"></a>属性を使用したインポートとエクスポート  
+ まず、`Program` で電卓をインポートします。 これにより、`Program` に渡されるコンソール入力やコンソール出力などのユーザー インターフェイスに関連する要素が電卓のロジックから切り離されます。  
+  
+ `Program` クラスに次のコードを追加します。  
+  
+```vb  
+<Import(GetType(ICalculator))>  
+Public Property calculator As ICalculator  
+```  
+  
+```csharp  
+[Import(typeof(ICalculator))]  
+public ICalculator calculator;  
+```  
+  
+ 注意しての宣言、`calculator`オブジェクトは特に変わった点はありませんで装飾されている、 <xref:System.ComponentModel.Composition.ImportAttribute>属性です。  この属性は、インポートとなるもの、つまり、オブジェクトが合成されると合成エンジンによって満たされるものを宣言します。  
+  
+ すべてのインポートは、*コントラクト*、これは、対応するエクスポートが決定されます。 コントラクトは、明示的に指定された文字列であったり、指定された型に基づいて MEF によって自動的に生成されたりします (この例では、`ICalculator` というインターフェイス)。  対応するコントラクトで宣言されたエクスポートが、このインポートを満たします。  `calculator` オブジェクトの型は実際には `ICalculator` ですが、これは必須ではありません。 コントラクトは、インポートするオブジェクトの型に依存しません。  この例では、`typeof(ICalculator)` は省略できます。  MEF では、明示的に指定しない限り、インポートの型に基づいて自動的にコントラクトが想定されます。  
+  
+ 次のように、この単純なインターフェイスをモジュールまたは `SimpleCalculator` 名前空間に追加します。  
+  
+```vb  
+Public Interface ICalculator  
+    Function Calculate(ByVal input As String) As String  
+End Interface  
+```  
+  
+```csharp  
+public interface ICalculator  
+{  
+    String Calculate(String input);  
+}  
+```  
+  
+ `ICalculator` を定義したので、これを実装するクラスが必要です。  モジュールまたは `SimpleCalculator` 名前空間に次のクラスを追加します。  
+  
+```vb  
+<Export(GetType(ICalculator))>  
+Public Class MySimpleCalculator  
+   Implements ICalculator  
+  
+End Class  
+```  
+  
+```csharp  
+[Export(typeof(ICalculator))]  
+class MySimpleCalculator : ICalculator  
+{  
+  
+}  
+```  
+  
+ これが、`Program` でインポートに対応するエクスポートになります。 エクスポートがインポートと一致するには、エクスポートで同じコントラクトを使用する必要があります。  `typeof(MySimpleCalculator)` に基づいてコントラクトでエクスポートすると、不一致が発生し、インポートは満たされません。コントラクトは正確に対応している必要があります。  
+  
+ 合成コンテナーはこのアセンブリで使用可能なすべてのパートを使用して設定されるため、`MySimpleCalculator` パートが使用可能になります。  `Program` のコンストラクターが `Program` オブジェクトで合成を実行するとき、そのインポートは、それを満たすために作成される `MySimpleCalculator` オブジェクトで満たされます。  
+  
+ ユーザー インターフェイス レイヤー (`Program`) がそれ以外のことを認識する必要はありません。  したがって、`Main` メソッド内の残りのユーザー インターフェイス ロジックを記述できます。  
+  
+ `Main` メソッドに次のコードを追加します。  
+  
+```vb  
+Sub Main()  
+    Dim p As New Program()  
+    Dim s As String  
+    Console.WriteLine("Enter Command:")  
+    While (True)  
+        s = Console.ReadLine()  
+        Console.WriteLine(p.calculator.Calculate(s))  
+    End While  
+End Sub  
+```  
+  
+```csharp  
+static void Main(string[] args)  
+{  
+    Program p = new Program(); //Composition is performed in the constructor  
+    String s;  
+    Console.WriteLine("Enter Command:");  
+    while (true)  
+    {  
+        s = Console.ReadLine();  
+        Console.WriteLine(p.calculator.Calculate(s));  
+    }  
+}  
+```  
+  
+ このコードは、単純に入力行を読み取り、結果に対して `Calculate` の `ICalculator` 関数を呼び出して、結果をコンソールに出力します。 これが、`Program` で必要なすべてのコードです。  その他の処理は、パート内で行われます。  
+  
+<a name="further_imports_and_importmany"></a>   
+## <a name="further-imports-and-importmany"></a>その他のインポートと ImportMany  
+ SimpleCalculator に拡張性を持たせるためには、演算の一覧をインポートする必要があります。 通常<xref:System.ComponentModel.Composition.ImportAttribute>属性が&1; つだけで埋められた<xref:System.ComponentModel.Composition.ExportAttribute>します。  使用可能なエクスポートが複数あれば、合成エンジンでエラーが発生します。  満たすことのできる任意の数のエクスポートでインポートを作成するには、使用することができます、 <xref:System.ComponentModel.Composition.ImportManyAttribute>属性です。  
+  
+ 次の操作のプロパティを追加、`MySimpleCalculator`クラス。  
+  
+```vb  
+<ImportMany()>  
+Public Property operations As IEnumerable(Of Lazy(Of IOperation, IOperationData))  
+```  
+  
+```csharp  
+[ImportMany]  
+IEnumerable<Lazy<IOperation, IOperationData>> operations;  
+```  
+  
+ <xref:System.Lazy%602>はエクスポートへの間接参照を保持するために MEF によって提供される型です。</T, TMetadata>  ここでは、エクスポートされるオブジェクト自体、だけでなく取得することも*メタデータのエクスポート*、エクスポートされるオブジェクトについて説明する情報です。 各<xref:System.Lazy%602>が含まれています、 `IOperation` 、実際の操作を表すオブジェクトと`IOperationData`そのメタデータを表すオブジェクト\</T, TMetadata>。  
+  
+ 次の単純なインターフェイスをモジュールまたは `SimpleCalculator` 名前空間に追加します。  
+  
+```vb  
+Public Interface IOperation  
+    Function Operate(ByVal left As Integer, ByVal right As Integer) As Integer  
+End Interface  
+  
+Public Interface IOperationData  
+    ReadOnly Property Symbol As Char  
+End Interface  
+```  
+  
+```csharp  
+public interface IOperation  
+{  
+     int Operate(int left, int right);  
+}  
+  
+public interface IOperationData  
+{  
+    Char Symbol { get; }  
+}  
+```  
+  
+ ここでは、各演算のメタデータは、演算を表す +、-、* などの記号です。 加算の演算を使用可能にするには、次のクラスをモジュールまたは `SimpleCalculator` 名前空間に追加します。  
+  
+```vb  
+<Export(GetType(IOperation))>  
+<ExportMetadata("Symbol", "+"c)>  
+Public Class Add  
+    Implements IOperation  
+  
+    Public Function Operate(ByVal left As Integer, ByVal right As Integer) As Integer Implements IOperation.Operate  
+        Return left + right  
+    End Function  
+End Class  
+```  
+  
+```csharp  
+[Export(typeof(IOperation))]  
+[ExportMetadata("Symbol", '+')]  
+class Add: IOperation  
+{  
+    public int Operate(int left, int right)  
+    {  
+        return left + right;  
+    }  
+}  
+```  
+  
+ <xref:System.ComponentModel.Composition.ExportAttribute>以前と同じように関数を属性です。  <xref:System.ComponentModel.Composition.ExportMetadataAttribute>属性はそのエクスポートに名前と値のペアの形式でのメタデータをアタッチします。  `Add` クラスは `IOperation` を実装していますが、`IOperationData` を実装するクラスは明示的に定義されていません。 代わりに、提供されるメタデータの名前に基づくプロパティを使用して、MEF によってクラスが暗黙的に作成されます。  (MEF でメタデータにアクセスする方法にはいくつかありますが、これはその&1; つです)。  
+  
+ MEF での合成は*再帰*します。 先ほど、`Program` オブジェクトを明示的に合成しました。これは `ICalculator` をインポートし、その型は `MySimpleCalculator` であることが判明しました。  この `MySimpleCalculator` は `IOperation` オブジェクトのコレクションをインポートし、このインポートは `MySimpleCalculator` が作成されるときに `Program` のインポートと同時に満たされます。 `Add` クラスがさらに別のインポートを宣言している場合は、そのインポートも満たされる必要があり、宣言されているインポートごとにそれが繰り返されます。 満たされないインポートが残ると、合成エラーが発生します   (省略可能なインポートを宣言する、またはそれらに既定値を割り当てることはできます)。  
+  
+<a name="calculator_logic"></a>   
+## <a name="calculator-logic"></a>電卓のロジック  
+ 3 つのパートを作成したので、残っている作業は電卓ロジックを作成することです。 `MySimpleCalculator` クラスに次のコードを追加して、`Calculate` メソッドを実装します。  
+  
+```vb  
+Public Function Calculate(ByVal input As String) As String Implements ICalculator.Calculate  
+    Dim left, right As Integer  
+    Dim operation As Char  
+    Dim fn = FindFirstNonDigit(input) 'Finds the operator  
+    If fn < 0 Then  
+        Return "Could not parse command."  
+    End If  
+    operation = input(fn)  
+    Try  
+        left = Integer.Parse(input.Substring(0, fn))  
+        right = Integer.Parse(input.Substring(fn + 1))  
+    Catch ex As Exception  
+        Return "Could not parse command."  
+    End Try  
+    For Each i As Lazy(Of IOperation, IOperationData) In operations  
+        If i.Metadata.symbol = operation Then  
+            Return i.Value.Operate(left, right).ToString()  
+        End If  
+    Next  
+    Return "Operation not found!"  
+End Function  
+```  
+  
+```csharp  
+public String Calculate(String input)  
+{  
+    int left;  
+    int right;  
+    Char operation;  
+    int fn = FindFirstNonDigit(input); //finds the operator  
+    if (fn < 0) return "Could not parse command.";  
+  
+    try  
+    {  
+        //separate out the operands  
+        left = int.Parse(input.Substring(0, fn));  
+        right = int.Parse(input.Substring(fn + 1));  
+    }  
+    catch   
+    {  
+        return "Could not parse command.";  
+    }  
+  
+    operation = input[fn];  
+  
+    foreach (Lazy<IOperation, IOperationData> i in operations)  
+    {  
+        if (i.Metadata.Symbol.Equals(operation)) return i.Value.Operate(left, right).ToString();  
+    }  
+    return "Operation Not Found!";  
+}  
+```  
+  
+ 1 つ目のステップでは、入力文字列が解析され、左オペランド、右オペランド、および演算子文字が特定されます。  `foreach` ループでは、`operations` コレクションのすべてのメンバーが検証されます。 これらのオブジェクトは型<xref:System.Lazy%602>、し、そのメタデータ値とエクスポートされるオブジェクトを使用してアクセスできます、<xref:System.Lazy%602.Metadata%2A>プロパティおよび<xref:System.Lazy%601.Value%2A>プロパティそれぞれ</T, TMetadata>。 この場合、`Symbol` オブジェクトの `IOperationData` プロパティが一致することが検出されると、電卓は `Operate` オブジェクトの `IOperation` メソッドを呼び出し、結果を返します。  
+  
+ 電卓を完成させるには、文字列内で最初に出現する数字以外の文字の位置を返すヘルパー メソッドも必要です。  `MySimpleCalculator` クラスに次のヘルパー メソッドを追加します。  
+  
+```vb  
+Private Function FindFirstNonDigit(ByVal s As String) As Integer  
+    For i = 0 To s.Length  
+        If (Not (Char.IsDigit(s(i)))) Then Return i  
+    Next  
+    Return -1  
+End Function  
+```  
+  
+```csharp  
+private int FindFirstNonDigit(String s)  
+{  
+    for (int i = 0; i < s.Length; i++)  
+    {  
+        if (!(Char.IsDigit(s[i]))) return i;  
+    }  
+    return -1;  
+}  
+```  
+  
+ これで、プロジェクトをコンパイルして実行できるようになりました。 Visual Basic の場合、`Public` に `Module1` キーワードを追加していることを確認してください。 コンソール ウィンドウで "5+3" などの加算演算を入力すると、電卓が結果を返します。  その他の演算子は、「操作が見つかりません!」になります メッセージ。  
+  
+<a name="extending_simplecalculator_using_a_new_class"></a>   
+## <a name="extending-simplecalculator-using-a-new-class"></a>新しいクラスを使用した SimpleCalculator の拡張  
+ これで、電卓が機能するようになりました。新しい演算の追加は簡単です。 モジュールまたは `SimpleCalculator` 名前空間に次のクラスを追加します。  
+  
+```vb  
+<Export(GetType(IOperation))>  
+<ExportMetadata("Symbol", "-"c)>  
+Public Class Subtract  
+    Implements IOperation  
+  
+    Public Function Operate(ByVal left As Integer, ByVal right As Integer) As Integer Implements IOperation.Operate  
+        Return left - right  
+    End Function  
+End Class  
+```  
+  
+```csharp  
+[Export(typeof(IOperation))]  
+[ExportMetadata("Symbol", '-')]  
+class Subtract : IOperation  
+{  
+    public int Operate(int left, int right)  
+    {  
+        return left - right;  
+    }  
+}  
+```  
+  
+ プロジェクトをコンパイルして実行します。 "5-3" などの減算演算を入力します。 電卓は、加算だけでなく減算もサポートするようになりました。  
+  
+<a name="extending_simplecalculator_using_a_new_assembly"></a>   
+## <a name="extending-simplecalculator-using-a-new-assembly"></a>新しいアセンブリを使用した SimpleCalculator の拡張  
+ ソース コードにクラスを追加するのは簡単ですが、MEF には、アプリケーション独自のソースの外部でパートを検索する機能が用意されています。 これを示すためには、追加することで、ディレクトリと各部分の場合、独自のアセンブリを検索に SimpleCalculator を変更する必要があります、 <xref:System.ComponentModel.Composition.Hosting.DirectoryCatalog>します。  
+  
+ という名前の新しいディレクトリを追加`Extensions`SimpleCalculator プロジェクトにします。  これは、アプリケーション レベルではなく、プロジェクト レベルで追加してください。 という名前のソリューションに新しいクラス ライブラリ プロジェクトを追加`ExtendedOperations`します。 新しいプロジェクトをコンパイルし、個別のアセンブリを作成します。  
+  
+ ExtendedOperations プロジェクトのプロジェクト プロパティ デザイナーを開き、をクリックして、**コンパイル**または**ビルド** タブをクリックします。 変更、**ビルド出力パス**または**出力パス**SimpleCalculator プロジェクト ディレクトリの Extensions ディレクトリを指す (..\SimpleCalculator\Extensions\\)。  
+  
+ Module1.vb または Program.cs で、`Program` コンストラクターに次の行を追加します。  
+  
+```vb  
+catalog.Catalogs.Add(New DirectoryCatalog("C:\SimpleCalculator\SimpleCalculator\Extensions"))  
+```  
+  
+```csharp  
+catalog.Catalogs.Add(new DirectoryCatalog("C:\\SimpleCalculator\\SimpleCalculator\\Extensions"));  
+```  
+  
+ 例に示されているパスを、Extensions ディレクトリのパスに置き換えます   (この絶対パスはデバッグにのみ使用します。  実稼働アプリケーションでは、相対パスを使用します)。<xref:System.ComponentModel.Composition.Hosting.DirectoryCatalog>が合成コンテナーに Extensions ディレクトリ内のアセンブリで見つかったすべてのパートに追加されます。  
+  
+ ExtendedOperations プロジェクトで、SimpleCalculator と System.ComponentModel.Composition への参照を追加します。 ExtendedOperations クラス ファイルで、System.ComponentModel.Composition の `Imports` ステートメントまたは `using` ステートメントを追加します。 Visual Basic では、SimpleCalculator の `Imports` ステートメントも追加します。 次に、ExtendedOperations クラス ファイルに次のクラスを追加します。  
+  
+```vb  
+<Export(GetType(SimpleCalculator.IOperation))>  
+<ExportMetadata("Symbol", "%"c)>  
+Public Class Modulo  
+    Implements IOperation  
+  
+    Public Function Operate(ByVal left As Integer, ByVal right As Integer) As Integer Implements IOperation.Operate  
+        Return left Mod right  
+    End Function  
+End Class  
+```  
+  
+```csharp  
+[Export(typeof(SimpleCalculator.IOperation))]  
+[ExportMetadata("Symbol", '%')]  
+public class Mod : SimpleCalculator.IOperation  
+{  
+    public int Operate(int left, int right)  
+    {  
+        return left % right;  
+    }  
+}  
+```  
+  
+ させるには、一致するように、コントラクトの<xref:System.ComponentModel.Composition.ExportAttribute>属性と同じ型を持つ必要があります、 <xref:System.ComponentModel.Composition.ImportAttribute>します。  
+  
+ プロジェクトをコンパイルして実行します。 新しい Mod (%) 演算子をテストします。  
+  
+<a name="conclusion"></a>   
+## <a name="conclusion"></a>まとめ  
+ ここでは、MEF の基本的な概念について説明しました。  
+  
+-   パート、カタログ、および合成コンテナー  
+  
+     パートと合成コンテナーは、MEF アプリケーションの基本のビルド ブロックです。 パートは、それ自体までの (自身を含む) 値をインポートまたはエクスポートするオブジェクトです。 カタログは、特定のソースからのパートのコレクションを提供します。  合成コンテナーは、カタログによって提供されるパートを使用して合成 (インポートのエクスポートへの結合) を実行します。  
+  
+-   インポートとエクスポート  
+  
+     インポートとエクスポートは、コンポーネントが通信を行う手段です。 インポートを使用して、コンポーネントは特定の値またはオブジェクトが必要であることを指定します。エクスポートを使用して、コンポーネントは値が使用可能であることを指定します。 各インポートは、コントラクトを通じて、エクスポートの一覧と対応付けされます。  
+  
+<a name="where_do_i_go_now"></a>   
+## <a name="where-do-i-go-now"></a>次のステップ  
+ この例の完全なコードをダウンロードするには、 [SimpleCalculator のサンプル](http://code.msdn.microsoft.com/windowsdesktop/Simple-Calculator-MEF-1152654e)します。  
+  
+ 詳細とコード例については、次を参照してください。 [Managed Extensibility Framework](http://go.microsoft.com/fwlink/?LinkId=144282)します。 MEF 型の一覧は、次を参照してください。、 <xref:System.ComponentModel.Composition?displayProperty=fullName>名前空間。
\ No newline at end of file
diff --git a/docs/framework/mef/mef-for-net-for-windows-store-apps.md b/docs/framework/mef/mef-for-net-for-windows-store-apps.md
new file mode 100644
index 00000000000..1d5e8fc7606
--- /dev/null
+++ b/docs/framework/mef/mef-for-net-for-windows-store-apps.md
@@ -0,0 +1,37 @@
+---
+title: "Windows ストア アプリ用 .NET の MEF 名前空間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7667770e-d163-4ad6-a303-085cf73db2f2
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# Windows ストア アプリ用 .NET の MEF 名前空間
+<xref:System.Composition?displayProperty=fullName> とその子の名前空間には、Managed Extensibility Framework \(MEF\) を使用して拡張可能な [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを開発するための型が含まれています。  これらの名前空間は、[!INCLUDE[win8](../../../includes/win8-md.md)] オペレーティング システムの [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] のサブセットの一部です。  
+  
+ これらの名前空間は、.NET Framework で配布されているコア クラス ライブラリの一部ではありません。  これらの名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、**\[プロジェクト\]** メニューの **\[NuGet パッケージの管理\]** を選択し、Microsoft.Composition パッケージをオンラインで検索します。  
+  
+-   <xref:System.Composition?displayProperty=fullName> は [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリのコア MEF を構成するクラスを提供します。  
+  
+-   <xref:System.Composition.Convention?displayProperty=fullName> は、規則ベースの構成モデルでの MEF の使用をサポートする型を提供します。  
+  
+-   <xref:System.Composition.Hosting?displayProperty=fullName> は、ホスト アプリケーションの開発者に役立つ MEF 型を提供します。  
+  
+-   <xref:System.Composition.Hosting.Core?displayProperty=fullName> は、コンポジション エンジンによって内部的に使用される MEF 型を提供します。  
+  
+ [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] に関する詳細についてと名前空間を含むリストと型は、Windows [Windows ストア アプリのための .NET はアプリケーションの概要を格納します。](http://go.microsoft.com/fwlink/p/?LinkID=238312) デベロッパー センターで、参照します。  
+  
+## 参照  
+ [Windows ストア アプリ用 .NET の概要](http://go.microsoft.com/fwlink/p/?LinkID=238312)   
+ [Windows ストア アプリのための .NET はアプリケーションの–でサポートされる API を格納します。](http://go.microsoft.com/fwlink/p/?LinkID=247912)   
+ [Managed Extensibility Framework \(MEF\)](../../../docs/framework/mef/index.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/TOC.md b/docs/framework/migration-guide/TOC.md
new file mode 100644
index 00000000000..ebc096ccc04
--- /dev/null
+++ b/docs/framework/migration-guide/TOC.md
@@ -0,0 +1,34 @@
+# [変更の再ターゲット](retargeting-changes-in-the-net-framework-4-6.md)
+# [バージョンおよび依存関係](versions-and-dependencies.md)
+# [軽減策: X509CertificiateClaimSet.FindClaims メソッド](mitigation-x509certificateclaimset-findclaims-method.md)
+# [ランタイムの変更点](runtime-changes-in-the-net-framework-4-5-1.md)
+# [軽減策: Icon オブジェクトの PNG フレーム](mitigation-png-frames-in-icon-objects.md)
+# [アプリケーションの互換性](application-compatibility.md)
+# [4.6.1 でのアプリケーションの互換性](application-compatibility-in-the-net-framework-4-6-1.md)
+# [軽減策: XML スキーマ検証](mitigation-xml-schema-validation.md)
+# [軽減策: minFreeMemoryPercentageToActiveService 構成の設定](mitigation-minfreememorypercentagetoactiveservice-configuration-setting.md)
+# [ランタイムの変更点](runtime-changes-in-the-net-framework-4-6-1.md)
+# [軽減策: カスタムの IMessageFilter.PreFilterMessage 実装](mitigation-custom-imessagefilter-prefiltermessage-implementations.md)
+# [ランタイムの変更点](runtime-changes-in-the-net-framework-4-5-2.md)
+# [変更の再ターゲット](retargeting-changes-in-the-net-framework-4-5-1.md)
+# [軽減策: WPF レイアウト](mitigation-wpf-layout.md)
+# [.NET Framework 1.1 からの移行](migrating-from-the-net-framework-1-1.md)
+# [4.6 のアプリケーションの互換性](application-compatibility-in-the-net-framework-4-6.md)
+# [軽減策: 既定の AuthorizationContext](mitigation-default-authorizationcontext.md)
+# [方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する](how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)
+# [.NET の互換性の診断](net-compatibility-diagnostics.md)
+# [4.5 のアプリケーションの互換性](application-compatibility-in-the-net-framework-4-5.md)
+# [方法 : インストールされている .NET Framework の更新プログラムを確認する](how-to-determine-which-net-framework-updates-are-installed.md)
+# [ランタイムの変更点](runtime-changes-in-the-net-framework-4-6.md)
+# [4.5.2 のアプリケーションの互換性](application-compatibility-in-the-net-framework-4-5-2.md)
+# [変更の再ターゲット](retargeting-changes-in-the-net-framework-4-6-1.md)
+# [方法 : インストールされている .NET Framework バージョンを確認する](how-to-determine-which-versions-are-installed.md)
+# [軽減策: TLS プロトコル](mitigation-tls-protocols.md)
+# [軽減策: EventSource.WriteEvent メソッドの呼び出し](mitigation-eventsource-writeevent-method-calls.md)
+# [軽減策: アプリ ドメイン全体でのオブジェクトの逆シリアル化](mitigation-deserialization-of-objects-across-app-domains.md)
+# [バージョンの互換性](version-compatibility.md)
+# [再ターゲットの変更点](retargeting-changes-in-the-net-framework-4-5-2.md)
+# [4.5.1 のアプリケーションの互換性](application-compatibility-in-the-net-framework-4-5-1.md)
+# [軽減策: WPF ウィンドウのレンダリング](mitigation-wpf-window-rendering.md)
+# [軽減策: 製品のバージョン管理](mitigation-product-versioning.md)
+# [移行ガイド](migration-guide-to-the-net-framework-4-7-4-6-and-4-5.md)
diff --git a/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md
new file mode 100644
index 00000000000..e6a0056a898
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md
@@ -0,0 +1,50 @@
+---
+title: ".NET Framework 4.5.1 のアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b07b729-e2bf-4925-8b83-9c9ee6c48612
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# .NET Framework 4.5.1 のアプリケーションの互換性
+このトピックでは、.NET Framework 4.5 と 4.5.1 間のアプリケーションの互換性の問題に関する情報へのリンクを示します。  問題は 2 つのカテゴリに分けられます。  
+  
+ [Runtime changes \(実行時の変更\)](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md)  
+ 実行時の変更は [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] で実行されていて、特定の機能を使用するすべてのアプリに影響します。  
+  
+ [Retargeting changes \(変更の再ターゲット\)](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md)  
+ 変更の再ターゲットは [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象にして再コンパイルされるアプリに影響します。  Windows コモン コントロールには以下が含まれます。  
+  
+-   デザイン時環境の変更。  たとえば、ビルド ツールは以前は出力しなかったときに警告を出力する場合があります。  
+  
+-   ランタイム時環境の変更。  これらは、特に [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象とするアプリにのみ影響します。  .NET Framework の以前のバージョンを対象とするアプリは、それらのバージョンで実行されているときは以前のように動作します。  
+  
+ ランタイムの変更および変更の再ターゲットについて説明するトピックでは、次に示すように、予想される影響ごとに個々の項目を分類しました。  
+  
+ Major  
+ これは、多数のアプリに影響するか、またはコードに重大な変更を加える必要のある重要な変更点です。  
+  
+ Minor  
+ これは、少数のアプリに影響するか、またはコードにわずかな変更を加える必要のある変更点です。  
+  
+ エッジ ケース  
+ これは、一般的ではない特定のシナリオでアプリに影響する変更点です。  
+  
+ 透過的  
+ これはアプリの開発者やユーザーには大きな影響を及ぼさない変更です。  アプリはこの変更のために変更を加える必要はありません。  
+  
+## 参照  
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)   
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md
new file mode 100644
index 00000000000..5a2ccc2a8cf
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md
@@ -0,0 +1,50 @@
+---
+title: ".NET Framework 4.5.2 のアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c6a029d-c565-4f25-b87b-b2361634bd74
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Framework 4.5.2 のアプリケーションの互換性
+このトピックでは、.NET Framework 4.5.1 と 4.5.2 間のアプリケーションの互換性の問題に関する情報へのリンクを示します。  問題は 2 つのカテゴリに分けられます。  
+  
+ [ランタイムの変更](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-2.md)  
+ ランタイムの変更は .NET Framework 4.5.2 で実行されていて、特定の機能を使用するすべてのアプリに影響します。  
+  
+ [再ターゲットの変更](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-2.md)  
+ 変更の再ターゲットは、.NET Framework 4.5、4.5.1、または 4.5.2 を対象として再コンパイルされるアプリに影響します。  Windows コモン コントロールには以下が含まれます。  
+  
+-   デザイン時環境の変更。  たとえば、ビルド ツールは以前は出力しなかったときに警告を出力する場合があります。  
+  
+-   ランタイム時環境の変更。  これらは、特に .NET Framework 4.5.2 を対象とするアプリにのみ影響します。  .NET Framework の以前のバージョンを対象とするアプリは、それらのバージョンで実行されているときは以前のように動作します。  
+  
+ ランタイムの変更および変更の再ターゲットについて説明するトピックでは、次に示すように、予想される影響ごとに個々の項目を分類しました。  
+  
+ Major  
+ これは、多数のアプリに影響するか、またはコードに重大な変更を加える必要のある重要な変更点です。  
+  
+ Minor  
+ これは、少数のアプリに影響するか、またはコードにわずかな変更を加える必要のある変更点です。  
+  
+ エッジ ケース  
+ これは、一般的ではない特定のシナリオでアプリに影響する変更点です。  
+  
+ 透過的  
+ これはアプリの開発者やユーザーには大きな影響を及ぼさない変更です。  アプリはこの変更のために変更を加える必要はありません。  
+  
+## 参照  
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)   
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md
new file mode 100644
index 00000000000..6a88cbb5b31
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md
@@ -0,0 +1,241 @@
+---
+title: ".NET Framework 4.5 のアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーションの互換性、.NET Framework"
+  - "分類 (変更点の) [.NET Framework]"
+ms.assetid: 5c50747c-806c-44a9-ac58-5bbe12a284fa
+caps.latest.revision: 76
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 76
+---
+# .NET Framework 4.5 のアプリケーションの互換性
+このトピックでは、修正や顧客フィードバックに基づく変更点など、.NET Framework 4 と 4.5 のアプリケーションの互換性に関する問題について説明します。 これらの変更点のほとんどは、アプリケーションのプログラミング変更を必要としません。 プログラミング変更が必要になる可能性のある変更点については、表の「影響」列を参照してください。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は [!INCLUDE[winxp](../../../includes/winxp-md.md)] ではサポートされないことに注意してください。  
+  
+ .NET Framework 4.5 と 4.5.1 の互換性の問題については、「[4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)」を参照してください。  
+  
+ このトピックでは、次の分野の主な変更点について説明します。  
+  
+-   [コア](#core)  
+  
+-   [データ](#sql)  
+  
+-   [ネットワーク](#network)  
+  
+-   [シリアル化](#serialize)  
+  
+-   [印刷](#Printing)  
+  
+-   [ツールとリソース](#tools)  
+  
+-   [ASP.NET](#asp)  
+  
+-   [ClickOnce](#ClickOnce)  
+  
+-   [MEF \(Managed Extensibility Framework\)](#mef)  
+  
+-   [Web アプリケーション](#web)  
+  
+-   [Windows Communication Foundation \(WCF\)](#wcf)  
+  
+-   [Windows フォーム](#winForms)  
+  
+-   [Windows Presentation Foundation \(WPF\)](#wpf)  
+  
+-   [Windows Workflow Foundation (WF)](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md#wwf)  
+  
+-   [XML、XSLT](#xml)  
+  
+ このトピックでは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]で廃止と宣言された型およびメンバーについては説明しません。 これらの一覧については、「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)」を参照してください。 新しい機能の詳細については、「[新機能](../../../docs/framework/whats-new/index.md)」を参照してください。  
+  
+<a name="core"></a>   
+## コア  
+ 以下のアプリケーションの互換性の問題に加え、シリアル化に関連する問題について「[シリアル化](#serialize)」のセクションを参照してください。  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|[BlockingCollection\<T\>.TryTakeFromAny\(BlockingCollection\<T\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%29?displayProperty=fullName> メソッドおよび <xref:System.Collections.Concurrent.BlockingCollection%601.TakeFromAny%2A?displayProperty=fullName> メソッド|[BlockingCollection\<T\>.TryTakeFromAny\(BlockingCollection\<T\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%29?displayProperty=fullName> メソッドで \-1 が返されたり、例外がスローされることがなくなりました。<xref:System.Collections.Concurrent.BlockingCollection%601.TakeFromAny%2A?displayProperty=fullName> メソッドでは、コレクションの 1 つに完了のマークが付けられても例外がスローされることがなくなりました。|この変更の結果、コレクションの 1 つが空であったり完了していても、他のコレクションに取得できる項目がある場合にコレクションで作業をすることができるようになりました。|  
+|<xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName>|コンパイル済みの正規表現のアセンブリが [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] でビルドされ、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を対象としている場合、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] がインストールされているシステム上でそのアセンブリの正規表現の 1 つを使用しようとすると、例外をスローします。|この問題を回避するには、次のいずれかの方法を実行します。<br /><br /> [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を使用して正規表現を含むアセンブリをビルドします。<br /><br /> 解釈される正規表現を使用します。|  
+|<xref:System.Threading.Tasks.Task?displayProperty=fullName> の破棄|`Task.IAsyncResult.AsyncWaitHandle`を除き、<xref:System.Threading.Tasks.Task?displayProperty=fullName> メソッドでオブジェクトが破棄された後も <xref:System.ObjectDisposedException> の例外がスローされることがなくなりました。|この変更により、キャッシュされたタスクを使用できるようになりました。 たとえば、メソッドで新しいタスクを割り当てる代わりに、既に完了した操作を表す、キャッシュされたタスクを返すことができます。 これは、タスクの任意のコンシューマーによって破棄されてしまうと、使用不可能になってしまう以前の .NET Framework のバージョンでは不可能でした。|  
+|<xref:System.Threading.Tasks.Task?displayProperty=fullName> 操作での無視された例外|<xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスは非同期操作を表すため、非同期処理中に発生する重大ではない例外がすべてキャッチされます。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、例外が確認されておらず、コードがタスクを待機していない場合、例外がファイナライザー スレッドに反映されなくなり、ガベージ コレクションの実行時にプロセスがクラッシュします。|この変更により、<xref:System.Threading.Tasks.Task> クラスを使用して観察されていない非同期処理を実行するアプリケーションの信頼性が向上します。 以前の動作は <xref:System.Threading.Tasks.TaskScheduler.UnobservedTaskException?displayProperty=fullName> イベントに適切なハンドラーを指定することによって復元できます。|  
+|タイムアウト引数を使用する <xref:System.Threading.Tasks.Task.WaitAll%2A?displayProperty=fullName> メソッド|[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)]では、これらのメソッドは動作が矛盾していました。 タイムアウトの期限が切れたときに、メソッドを呼び出す前に完了した、またはキャンセルされたタスクが 1 つ以上ある場合、メソッドでは <xref:System.AggregateException> 例外がスローされていました。 タイムアウトの期限が切れたときに、メソッドを呼び出す前に完了した、またはキャンセルされたタスクがなく、メソッドを呼び出した後で 1 つ以上のタスクがこれらの状態になると、メソッドでは `false`が返されていました。<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、これらのメソッドはオーバーロードされ、タイムアウト期限が切れたときにいずれかのタスクが実行中の場合は `false` を返します。また、入力タスクが取り消された \(メソッド呼び出しの前と後のどちらで取り消されたかに関わりなく\) 場合、かつ、それ以外に実行中のタスクがない場合に限り、<xref:System.AggregateException> 例外をスローします。|この変更により、メソッドの動作が一貫します。 ただし、タイムアウトの期限が切れる前に少なくとも 1 つのタスクに障害が発生していたり、タスクがキャンセルされていた場合、アプリケーション コードが例外をスローするためにタイムアウト対応の <xref:System.Threading.Tasks.Task.WaitAll%2A?displayProperty=fullName> のオーバーロードに依存する可能性もわずかながらあります。 その場合は、<xref:System.Threading.Tasks.Task.IsCanceled%2A?displayProperty=fullName> プロパティを同じ目的で使用できます。|  
+|複数バージョン対応時の型転送のサポート|新しい CodeDOM の機能を使用すると、mscorlib.dll の [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] バージョンではなく、mscorlib.dll の対象バージョンに対してコンパイルできるようになります。|この変更により、CodeDOM が型転送された 2 つの定義を見つけたときのコンパイラ警告 \(および警告がエラーとして扱われる場合はコンパイル エラー\) が防げるようになりました。 異なるバージョンの参照アセンブリが 1 つの場所に混在している場合にのみ、この変更によって意図しない副作用が生じることがあります。|  
+|<xref:System.Collections.Generic.List%601.ForEach%2A?displayProperty=fullName>|コレクションの要素が変更されると、列挙子によって <xref:System.InvalidOperationException> の例外がスローされます。|この変更は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするアプリケーションにのみ適用され、悪影響が及ぶことはありません。 データの整合性が保護され、競合状態を特定できる確率が高くなります。|  
+|<xref:System.Uri?displayProperty=fullName>|International Resource Identifier \(IRI\) 解析に 2 つの変更を加えたことにより、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションの URI が影響を受けました。<br /><br /> [\<iriParsing\>](../../../docs/framework/configure-apps/file-schema/network/iriparsing-element-uri-settings.md) は既定で有効になり、無効にすることはできません。 以前は、これは既定で無効になっていました。<br /><br /> URI の非ホスト部分では Unicode 正規化形式 C \(NFC\) が実行されなくなりました。 以前は、`<iriParsing>` が有効になっていると URI 全体に対して NFC が実行されていました。|NFC \(正規化形式 C\) ではない正規化されたファイル名が含まれる URI は、C という形式で正規化されません。 IRI 解析が正規化されていない文字列を使用して正規化されたファイル名を持つファイルにアクセスすると、アプリケーション エラーが発生する可能性があります。 これは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションにのみ影響します。|  
+|<xref:System.Uri?displayProperty=fullName>|無効な `mailto:` URL では、<xref:System.Uri> クラスのコンストラクターで例外がスローされます。|これは再コンパイルされ、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするアプリケーションにのみ影響します。|  
+|<xref:System.Uri?displayProperty=fullName>|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするアプリケーションでは、元の URI 文字列のパス セグメントの末尾のドット \(たとえば `http://www.proseware.com/LLC./About.aspx`\) が保持されます。 1 つまたは 2 つのドットから構成されるパス セグメント \(たとえば、`http://www.proseware.com/..`、`http://www.proseware.com/./default.htm`\) は削除されますが、3 つの以上連続するドットを持つパス セグメント \(たとえば、`http://localhost/dir1/.../dir2`\) は保持されます。|この変更は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションにのみ影響します。 末尾のドットが削除されることに依存しているアプリケーションではエラーが発生する場合があります。|  
+|<xref:System.Uri?displayProperty=fullName>|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするアプリケーションでは、`file://` URI 内のクエリが許可されます。 文字 ? は、パスの一部として解釈されるため、エスケープされません。|この変更は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションにのみ影響します。 文字 ? のエスケープに依存するアプリケーション では、エラーが発生する場合があります。|  
+|<xref:System.Uri?displayProperty=fullName>|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするアプリケーションでは、Unicode 制御文字の U\+0080 ～ U\+009F が正確にエンコードされません。|通常、URI には Unicode 制御文字を使用しません。|  
+|<xref:System.Uri.EscapeDataString%2A?displayProperty=fullName>、<xref:System.Uri.EscapeUriString%2A?displayProperty=fullName>、および <xref:System.Uri.UnescapeDataString%2A?displayProperty=fullName>|現在、予約されている文字と予約されていない文字の一覧では、[RFC 3986](http://tools.ietf.org/html/rfc3986) がサポートされています。|具体的な変更内容:<br /><br /> <xref:System.Uri.EscapeDataString%2A> は、予約されている文字を RFC 3986 に基づいてエスケープします。<br /><br /> <xref:System.Uri.EscapeUriString%2A> は、予約されている文字をエスケープしません。<br /><br /> <xref:System.Uri.UnescapeDataString%2A> は、無効なエスケープ シーケンスが発生した場合に例外をスローしません。<br /><br /> 予約されていないエスケープ文字はエスケープ解除されます。|  
+|<xref:System.Uri.IsWellFormedUriString%2A?displayProperty=fullName>|.NET Framework 4.5 以降、文字列は常に [RFC 3986](http://tools.ietf.org/html/rfc3986) と [RFC 3987](http://tools.ietf.org/html/rfc3987) に従って適切な形式と見なされます。 .NET Framework の以前のバージョンでは、URI の解析および IDN 解析が有効である場合にのみ、文字列は RFC 3986 および RFC 3987 に従って適切な形式と見なされます。|.NET Framework 4.5 以降のバージョンを対象とするアプリの場合、このメソッドは、以前のバージョンの .NET Framework を対象とするアプリによって適切な形式と見なされた URI の `false` を返します。 たとえば、最初のセグメントにコロンが含まれる相対 URI \("2013.05.29\_14:33:41" など\) は、適切な形式と見なされません。<br /><br /> この変更は、.NET Framework 4.5 以降のバージョンを対象とするアプリのみに影響します。|  
+|<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A?displayProperty=fullName>|<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A?displayProperty=fullName> は、<xref:System.IAsyncResult.CompletedSynchronously%2A?displayProperty=fullName> プロパティにアクセスできます。<xref:System.IAsyncResult.CompletedSynchronously%2A?displayProperty=fullName> の間違った実装によって、<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A?displayProperty=fullName> メソッドの呼び出しで定義されていない動作が発生する可能性があります。|<xref:System.IAsyncResult.CompletedSynchronously%2A?displayProperty=fullName> プロパティの実装が誤って `true` を返すと、結果のタスクは完了しません。|  
+  
+<a name="sql"></a>   
+## データ  
+  
+### SQLClient  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行されているマネージ コードから SQL Server データベースに接続できる機能。|既存の同期 API コード パスは、非同期サポートを追加するように変更されました。|IFS ではない Winsock ベース サービス プロバイダー \(BSP\) または複層階サービス プロバイダー \(LSP\) が、SQL Server に接続できる機能に干渉する可能性があります。 詳細については、マイクロソフト サポートの Web サイトの「[SetFileCompletionNotificationModes API causes an IO completion port not work correctly with a non\-IFS LSP installed \(SetFileCompletionNotificationModes API が原因で、IFS ではない LSP がインストールされている場合に IO 完了ポートが正常に機能しない\)](http://go.microsoft.com/fwlink/p/?LinkId=256032)」を参照してください。|  
+|<xref:System.Data.SqlClient.SqlConnection?displayProperty=fullName> 型|SQL Server 1997 データベースへの接続はサポートされなくなりました。|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行されているアプリケーションは SQL Server 1997 データベースに接続できません。|  
+|<xref:System.Data.SqlClient.SqlConnection?displayProperty=fullName> 型|仮想インターフェイス アダプター \(VIA\) プロトコルを使用した SQL Server データベースへの接続はサポートされなくなりました。|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行されているアプリケーションは、VIA を使用して SQL Server データベースに接続できません。|  
+|<xref:System.Data.SqlClient.SqlBulkCopy?displayProperty=fullName> 型|データを列に挿入する場合、<xref:System.Data.SqlClient.SqlBulkCopy> は `VARCHAR` と `CHAR` の型の既定エンコードではなく、挿入先の列のエンコードを使用します。|この変更により、挿入先の列が既定のエンコードを使用しない場合に、既定のエンコードを使用することによって発生するデータ破損の可能性がなくなります。 まれに、エンコードに変更を加えることによって、挿入先の列に収まりきらない大きいデータが生成された場合に、既存のアプリケーションで <xref:System.Data.SqlClient.SqlException> の例外がスローされることがあります。|  
+|<xref:System.Data.SqlClient?displayProperty=fullName>の照合順序|`sql_variant` データはデータベースの照合順序ではなく `sql_variant` の照合順序を使用します。|この変更により、データベースの照合順序が `sql_variant` の照合順序と異なる場合にデータ破損が生じる可能性に対応できます。 破損したデータに依存するアプリケーションでは、エラーが発生する場合があります。|  
+  
+### Entity Framework  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Data.Objects.ObjectContext.CreateDatabase%2A?displayProperty=fullName> メソッドによって作成されるログ ファイル|<xref:System.Data.Objects.ObjectContext.CreateDatabase%2A> メソッドが、直接、または SqlClient プロバイダーと共に Code First と接続文字列の `AttachDBFilename` 値を使用して呼び出されると、*filename*.ldf ではなく *filename*\_log.ldf という名前のログ ファイルが作成されます \(*filename* は、`AttachDBFilename` 値で指定されたファイルの名前になります\)。|この変更により、SQL Server の仕様に従ってログ ファイル名が提供されるため、デバッグ機能が向上します。 予期しない副作用はありません。|  
+|データ定義言語 \(DDL: Data Definition Language\) API|`AttachDBFilename` を指定したときの DDL API の動作は次のように変更されました。<br /><br /> 接続文字列で `Initial Catalog` の値を指定する必要がなくなりました。 以前は、`AttatchDBFilename` と `Initial Catalog` の両方が必要でした。<br /><br /> `AttatchDBFilename` と `Initial Catalog` の両方が指定され、所定の MDF ファイルが存在する場合、<xref:System.Data.Objects.ObjectContext.DatabaseExists%2A?displayProperty=fullName> メソッドは `true`を返します。 以前は、`false`が返されていました。<br /><br /> `AttatchDBFilename` と `Initial Catalog` の両方が指定され、所定の MDF ファイルが存在する場合に、<xref:System.Data.Objects.ObjectContext.DeleteDatabase%2A?displayProperty=fullName> メソッドを呼び出すとファイルが削除されます。<br /><br /> 接続文字列で存在しない MDF の <xref:System.Data.Objects.ObjectContext.DeleteDatabase%2A?displayProperty=fullName> 値および存在しない `AttachDBFilename` が指定されたときに `Initial Catalog` が呼び出されると、メソッドでは <xref:System.InvalidOperationException> 例外がスローされます。 以前は、<xref:System.Data.SqlClient.SqlException> の例外がスローされていました。|これらの変更により、DDL API を使用するアプリケーションおよびツールの構築が簡単になりました。 これらの変更は、次のシナリオでアプリケーションの互換性に影響を及ぼす可能性があります。<br /><br /> `DROP DATABASE` で <xref:System.Data.Objects.ObjectContext.DeleteDatabase%2A?displayProperty=fullName> が返されたときに、<xref:System.Data.Objects.ObjectContext.DatabaseExists%2A?displayProperty=fullName> を呼び出す代わりに直接 `true` コマンドを実行するコードをユーザーが作成した場合。 データベースがアタッチされておらず、MDF ファイルが存在する場合、これによって既存のコードが破損します。<br /><br /> <xref:System.Data.Objects.ObjectContext.DeleteDatabase%2A?displayProperty=fullName> と MDF ファイルが存在しない場合に、<xref:System.Data.SqlClient.SqlException> 例外ではなく <xref:System.InvalidOperationException> 例外をスローするように、`Initial Catalog` メソッドを要求するコードをユーザーが作成した場合。|  
+|<xref:System.Data.Objects.ObjectContext.CreateDatabase%2A?displayProperty=fullName> メソッドおよび <xref:System.Data.Common.DbProviderServices.CreateDatabase%2A?displayProperty=fullName> メソッド|空のデータベースを作成した後にデータベース オブジェクトの作成が失敗した場合、メソッドはデータベースの作成を削除して、元の <xref:System.Data.SqlClient.SqlException> 例外を反映させます。 データベースの削除に失敗すると、メソッドは <xref:System.InvalidOperationException> 例外をスローします。|この変更により、空の使用不可能なデータベースが作成できなくなります。 例外処理は、データベースを正常に削除することによって元の <xref:System.Data.SqlClient.SqlException> 例外が反映されるため、多少変更されます。|  
+|<xref:System.Data.Objects.ObjectContext.Translate%2A?displayProperty=fullName> メソッドおよび <xref:System.Data.Objects.ObjectContext.ExecuteStoreQuery%2A?displayProperty=fullName> メソッド|`T` が列挙型の場合、メソッドは正しくデータベースからデータを返します。  以前は、列挙体の型がサポートされていなかったため、結果は常にゼロにキャストされるか、列挙型に変換されていました。<xref:System.UInt16>、<xref:System.UInt32> および <xref:System.UInt64> など、Entity Framework によってサポートされていない基になる型では、従来どおりゼロが返されたり、基の値がゼロの列挙型に変換されたりします。|列挙型のサポートは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]の Entity Framework で新たに追加されました。 ただし、開発者コードがゼロになる結果に依存している場合は、特定のコードによってはアプリケーション エラーが生じることがあります。|  
+  
+### LINQ  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Linq.Enumerable.Empty%2A?displayProperty=fullName> メソッド|メソッドは新しい <xref:System.Collections.Generic.IEnumerable%601> 型を返さず、代わりにキャッシュされた内部インスタンスを返します。|この変更により、パフォーマンスが改善されました。 ただし、複数の呼び出しから <xref:System.Linq.Enumerable.Empty%2A?displayProperty=fullName> まで 2 つの一意の空の型を取得しなければならないコードは失敗します。|  
+  
+<a name="network"></a>   
+## ネットワーキング  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Net.PeerToPeer.Collaboration?displayProperty=fullName> 名前空間の型とメンバー|[!INCLUDE[win8](../../../includes/win8-md.md)]ではこの型とメンバーはサポートされていません。 呼び出そうとすると、<xref:System.PlatformNotSupportedException> の例外がスローされます。|アプリケーションは、[!INCLUDE[win8](../../../includes/win8-md.md)]でこれらの型とメンバーを使用できません。|  
+|<xref:System.Net.Mail.MailMessage> オブジェクトのシリアル化と逆シリアル化。|.NET Framework 4.5 では、メール メッセージに非 ASCII 文字を含めることができます。 .NET Framework 4 では、ASCII 文字しかサポートされていません。|非 ASCII 文字が含まれ、.NET Framework 4.5 でシリアル化された <xref:System.Net.Mail.MailMessage> オブジェクトは、.NET Framework 4 で逆シリアル化することはできません。|  
+  
+<a name="Printing"></a>   
+## 印刷  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Printing.PrintSystemJobInfo.JobStream%2A?displayProperty=fullName>|このプロパティは、印刷ジョブのストリームを公開し、ユーザーがこのストリームに書き込むことによって、基になるオペレーティング システムの印刷コンポーネントに生データを送信できるようにします。<br /><br /> .NET Framework 4.5 以降、Windows 8 より後のバージョンの Windows オペレーティング システムでは、このストリームに書き込むデータは XPS 形式のパッケージ ストリームにする必要があります。|印刷内容を出力するには、次のいずれかの操作を行います。<br /><br /> <xref:System.Windows.Xps.XpsDocumentWriter> クラスを使用して印刷内容を出力します。 これが、推奨される方法です。<br /><br /> <xref:System.Printing.PrintSystemJobInfo.JobStream%2A?displayProperty=fullName> プロパティによって返されるストリームに送信されるデータを、XPS 形式のパッケージ ストリームにします。|  
+  
+<a name="serialize"></a>   
+## シリアル化  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Xml.Serialization.XmlSerializer> クラスを使用したシリアル化|WCF 4.5 では、<xref:System.Xml.Serialization.XmlSerializer> クラスは、C\# コンパイラへの依存関係を削除するように最適化されています。 この変更により、コールド起動シナリオのパフォーマンスが著しく向上します。|この変更により、WCF 4 でコンパイルされ、WCF 4.5 に対して実行される XML シリアル化のコードで問題が発生する可能性があります。 WCF 4.5 で既存の XML シリアル化コードの実行時に問題が発生した場合は、次の構成要素を使用して、WCF 4 の XmlSerializer の動作に戻します。<br /><br /> `<configuration>    <system.xml.serialization>    <xmlSerializer useLegacySerializerGeneration="true"/>    </system.xml.serialization> </configuration>`|  
+|<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter?displayProperty=fullName> クラスによるシリアル化と逆シリアル化|<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> を使用したシリアル化では、オブジェクトの内部状態をエンコードすることができます。この内部状態は、.NET Framework のバージョン間で同じであるとは限りません。  相違がある場合、.NET Framework の 1 つのバージョンでシリアル化されたコンテンツは他のバージョンで逆シリアル化できません。|<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> クラスについては、バージョン間の互換性が保証されません。 代わりに、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter?displayProperty=fullName> クラスおよび <xref:System.Runtime.Serialization.NetDataContractSerializer?displayProperty=fullName> クラスを使用してください。|  
+  
+<a name="tools"></a>   
+## ツールとリソース  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|MSBuild|コマンド プロンプトで MSBuild を実行すると、特定のプロジェクトのビルドを無効にするソリューション構成ファイルが考慮されます。|MSBuild は、Visual Studio で呼び出された場合もコマンド プロンプトで実行された場合も同じように動作します。 別のソリューションを作成したり、ソリューションからプロジェクトを削除して、ソリューションにプロジェクトのサブセットを作成する必要はありません。|  
+|MSBuild|MSBuild プロジェクト ファイルの `TreatAsLocalProperty` プロパティでは、`OutDir` プロパティなどの特定のプロパティがグローバル レベルでオーバーライドされるのを防ぎます。|`OutDir` プロパティをオーバーライドすると、`OutDir` が MS.Common.Targets ファイルがインポートされた後でオーバーライドされたグローバル プロパティだったときに壊れる可能性があります。|  
+|Windows エラー レポート: Watson バケット|マネージ クラッシュはいくつかの条件に基づいてカテゴリに分類されていますが、そのうちの 1 つはアセンブリ バージョンでした。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、アセンブリ バージョンではなくファイルのバージョンが使用されます。|アセンブリのバージョン変更はメジャー リリース間でのみ行われるため、アセンブリのバージョンではなくファイルのバージョンをカテゴリに使用すると、マネージ クラッシュに関係したアセンブリの特定のバージョンを判断できるようになります。|  
+|MSBuild|<xref:Microsoft.Build.Evaluation.ProjectCollection?displayProperty=fullName> コレクションのプロジェクトからのデータは、ガベージ コレクターにより自動的には解放されません。|プロジェクトを明示的に <xref:Microsoft.Build.Evaluation.ProjectCollection> コレクションへ読み込む場合、コレクションの各メンバーに対して <xref:Microsoft.Build.Evaluation.ProjectCollection.UnloadProject%28Microsoft.Build.Evaluation.Project%29> メソッドを呼び出す必要があります。|  
+  
+<a name="asp"></a>   
+## ASP.NET  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|ASP.NET IIS 登録ツール \(aspnet\_regiis.exe\)|[!INCLUDE[win8](../../../includes/win8-md.md)] では、ASP.NET のインストールとアンインストールを実行する `–i` オプションと `–u` オプションはサポートされません。|IIS 8 を使用して ASP.NET 4.5 をインストールまたはアンインストールするには、**\[Windows 機能の有効化または無効化\]** ダイアログ ボックス、サーバー管理ツール、または `dism.exe` コマンド ライン ツールを使用します。|  
+|<xref:System.Web.UI.WebControls.EntityDataSource?displayProperty=fullName> コントロール|<xref:System.Web.UI.Page.LoadComplete?displayProperty=fullName> イベントが原因で、<xref:System.Web.UI.WebControls.EntityDataSource?displayProperty=fullName> のコントロールがパラメーターの作成\/更新\/削除に変更を加えるためにデータ バインディングを呼び出すことがなくなりました。|この変更により、データベースへの不要なアクセスが排除され、コントロールの値がリセットされるのを防ぐことができるほか、<xref:System.Web.UI.WebControls.SqlDataSource> や <xref:System.Web.UI.WebControls.ObjectDataSource>などのように他のデータ コントロールと一貫性の取れた動作が生成されます。 この変更により、アプリケーションが <xref:System.Web.UI.Page.LoadComplete?displayProperty=fullName> イベントのデータ バインディングの呼び出しに依存するような珍しい状況において、異なる動作が生成されるようになりました。|  
+|<xref:System.Net.WebUtility.HtmlDecode%2A?displayProperty=fullName> メソッド、<xref:System.Net.WebUtility.UrlDecode%2A?displayProperty=fullName> メソッド、および [System.Web.Helpers.Json.Decode](https://msdn.microsoft.com/library/system.web.helpers.json.decode.aspx) メソッド|既定では、デコード メソッドによって無効な入力シーケンスが無効な UTF\-16 文字列にデコードされることがなくなりました。 代わりに、元の入力が返されます。|デコーダーの出力の変更は、UTF\-16 データではなくバイナリ データを文字列に格納した場合にのみ影響があります。 明示的にこの動作を制御するには、`aspnet:AllowRelaxedUnicodeDecoding` 要素の [\<appSettings\>](http://msdn.microsoft.com/ja-jp/0d65a3f1-c522-423d-89b6-44921b6daebb) 属性を `true` に設定してレガシの動作を有効にするか、`false` に設定して現在の動作を有効にします。|  
+|<xref:System.Net.WebUtility.HtmlEncode%2A?displayProperty=fullName> メソッド|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションの場合、基本多言語面 \(BMP: Basic Multilingual Plane\) の外部にある文字は、<xref:System.Net.WebUtility.HtmlDecode%2A?displayProperty=fullName> メソッドに渡されたときに正常に往復します。|この変更は、現在のアプリケーションには影響がありません。 元の動作を復元するには、[\<httpRuntime\>](http://msdn.microsoft.com/library/e1f13641\(v=vs.100\).aspx) 要素の `targetFramework` 属性を "4.5" 以外の文字列に設定します。 また、.NET Framework の対象バージョンに関係なくこの動作を制御するために `unicodeEncodingConformance` 構成要素の `unicodeDecodingConformance` 属性と `<webUtility>` 属性を設定することもできます。|  
+|<xref:System.Web.HttpRequest.ContentEncoding%2A?displayProperty=fullName> プロパティ|UTF\-7 エンコードは禁止されています。|UTF\-7 データの受信を必要とするアプリケーションのデータが、正しくデコードされない場合があります。 これはほとんどの場合は起こりませんが、`aspnet:AllowUtf7RequestContentEncoding` 要素の [\<appSettings\>](http://msdn.microsoft.com/ja-jp/0d65a3f1-c522-423d-89b6-44921b6daebb) 属性を使用してレガシ動作に戻すことができます。|  
+|<xref:System.Web.HttpUtility.JavaScriptStringEncode%2A?displayProperty=fullName>|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、このメソッドはアンパサンド \(&\) 文字をエスケープします。|アプリがこのメソッドの以前の動作に依存している場合、`aspnet:JavaScriptDoNotEncodeAmpersand` 設定を構成ファイル内の [ASP.NET appSettings 要素](http://msdn.microsoft.com/ja-jp/bb60e711-0669-4118-a54d-8dd71e009a00)に追加できます。|  
+|<xref:System.Web.Security.MachineKey.Encode%2A?displayProperty=fullName> メソッドおよび <xref:System.Web.Security.MachineKey.Decode%2A?displayProperty=fullName> メソッド|これらのメソッドは今後使用しません。|これらのメソッドを呼び出すコードをコンパイルすると、コンパイラ警告が生成されます。 別の方法として、<xref:System.Web.Security.MachineKey.Protect%2A?displayProperty=fullName> および <xref:System.Web.Security.MachineKey.Unprotect%2A?displayProperty=fullName> を使用することをお勧めします。|  
+  
+<a name="ClickOnce"></a>   
+## ClickOnce  
+  
+|特性|変更|影響|  
+|--------|--------|--------|  
+|SHA\-256 コード署名証明書を使用して ClickOnce で発行されたアプリケーション。|この実行可能ファイルは SHA256 で署名されます。 以前は、コード署名証明書が SHA\-1 か SHA\-256 に関係なく、SHA 1 で署名されました。 この方法は、次の対象に適用されます。<br /><br /> Visual Studio 2012 以降でビルドされたすべてのアプリケーション。<br /><br /> .NET Framework 4.5 がインストールされているシステム上で、Visual Studio 2010 以前でビルドされたアプリケーション。<br /><br /> さらに、.NET Framework 4.5 以降が存在する場合、コンパイル対象となった .NET Framework のバージョンに関係なく、ClickOnce マニフェストはSHA\-256 証明書の SHA 256 で署名されます。|ClickOnce 実行可能ファイルの署名方法に関するこの変更は、Windows Server 2003 システムにのみ影響を及ぼします。これらのシステムには、[KB 938397](http://support.microsoft.com/kb/938397) をインストールする必要があります。<br /><br /> アプリが .NET Framework 4 以前のバージョンをターゲットとしている場合でも、SHA\-256 を使用したマニフェストの署名方法の変更により、.NET Framework 4.5 以降のバージョンに対するランタイム依存関係が導入されます。 この問題は Visual Studio 2013 Update 3 および [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で解決されています。[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] での解決方法については、「[ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md)」を参照してください。|  
+  
+<a name="mef"></a>   
+## MEF \(Managed Extensibility Framework\)  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.ComponentModel.Composition.Primitives.ComposablePartCatalog?displayProperty=fullName> と派生クラス|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、MEF カタログで <xref:System.Collections.IEnumerable> が実装されるようになったため、シリアライザーの作成には使用できなくなりました \(<xref:System.Xml.Serialization.XmlSerializer> オブジェクト\)。|MEF カタログをシリアル化しようとすると、例外がスローされます。|  
+  
+<a name="web"></a>   
+## Web アプリケーション  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|.NET Framework 1.1 および 2.0 からのマネージ ブラウザーでのコントロールのホスト|これらのコントロールのホストは、Internet Explorer でブロックされます。|Internet Explorer では、マネージ ブラウザーを使用してコントロールをホストするアプリケーションは起動できません。 以前の動作を復元するには、レジストリ サブキー HKLM\/SOFTWARE\/MICROSOFT\/.NETFramework の EnableIEHosting 値を、x86 システム用および x64 システム上の 32 ビット プロセス用に 1 に設定し、レジストリ サブキー HKLM\/SOFTWARE\/Wow6432Node\/Microsoft\/.NETFramework の EnableIEHosting 値を x64 システム上の 64 ビット プロセス用に 1 に設定します。|  
+  
+<a name="wcf"></a>   
+## Windows Communication Foundation \(WCF\)  
+ 以下のアプリケーションの互換性の問題に加え、シリアル化に関連する問題について「[シリアル化](#serialize)」のセクションを参照してください。  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|Internet Information Services \(IIS\) または ASP.NET 開発サーバーでホストされており、`maxRequestLength` \(ASP.NET の場合\) または `maxReceivedMessageSize` \(WCF の場合\) を超える WCF Web サービスのメッセージ|HTTP 状態コードは 400 \(正しくない要求\) から 413 \(要求したエンティティが大きすぎます\) に変更され、`maxRequestLength` または `maxReceivedMessageSize` 設定を超えるメッセージでは <xref:System.ServiceModel.ProtocolException> 例外がスローされます。 これには、転送モードが <xref:System.ServiceModel.TransferMode>である場合も含まれます。|この変更により、メッセージ長が ASP.NET または WCF で許可されている制限を超えたときのデバッグが簡単になります。<br /><br /> HTTP 400 状態コードに基づいて処理を実行するコードはすべて変更する必要があります。|  
+|OData URL の `Replace`|OData URL の `Replace` メソッドは既定で無効になっています。|OData `Replace` が無効であると \(既定の設定\)、ユーザー要求は例外をスローし、要求は失敗します。|  
+|<xref:System.ServiceModel.Web.WebServiceHost?displayProperty=fullName>|<xref:System.ServiceModel.Web.WebServiceHost?displayProperty=fullName> オブジェクトでは、アプリケーション コードによって明示的なエンドポイントが追加された場合に、既定のエンドポイントが追加されなくなりました。|クライアント アプリケーションが、既定で追加されなくなったエンドポイントに接続しようとすると、HTTP エラーが発生します。|  
+  
+<a name="winForms"></a>   
+## Windows フォーム  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|System.Drawing.dll|アセンブリの `CheckForOverflowUnderflow` プロパティは、`true` に設定されます。|これまではオーバーフローが発生すると、その結果は自動的に切り捨てられました。 現在では、<xref:System.OverflowException> 例外がスローされます。|  
+|<xref:System.Drawing.Imaging.EncoderParameter.%23ctor%28System.Drawing.Imaging.Encoder%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName> コンストラクター|このコンストラクターの使用は推奨されていません。|このコンストラクターは、64 ビット システムで動作しなくなりました。 代わりに、<xref:System.Drawing.Imaging.EncoderParameter.%23ctor%28System.Drawing.Imaging.Encoder%2CSystem.Int32%2CSystem.Drawing.Imaging.EncoderParameterValueType%2CSystem.IntPtr%29?displayProperty=fullName> コンストラクターを使用してください。|  
+  
+<a name="wpf"></a>   
+## Windows Presentation Foundation \(WPF\)  
+ 以下のアプリケーションの互換性の問題に加え、シリアル化に関連する問題について「[シリアル化](#serialize)」のセクションを参照してください。  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|<xref:System.Windows.Controls.Primitives.TextBoxBase.UndoLimit%2A?displayProperty=fullName> プロパティ|<xref:System.Windows.Controls.TextBox> クラスと <xref:System.Windows.Controls.RichTextBox> クラスを元に戻す操作の最大回数の既定の制限値が、\-1 \(制限なし\) から 100 に変更されました。|この変更によって生じる悪影響はないはずです。 ただし、コントロールをインスタンス化した後に明示的に <xref:System.Windows.Controls.Primitives.TextBoxBase.UndoLimit%2A> プロパティを設定することは可能です。|  
+|<xref:System.Windows.Controls.PageRangeSelection?displayProperty=fullName> 列挙体|<xref:System.Windows.Controls.PageRangeSelection> メンバーと <xref:System.Windows.Controls.PageRangeSelection> メンバーが、列挙型に追加されました。|この変更が、既存のアプリケーションに与える影響はありません。 この列挙型を使用する既存のメンバーの既定値は <xref:System.Windows.Controls.PageRangeSelection?displayProperty=fullName> です。|  
+|<xref:System.Windows.DataTemplate> 要素|<xref:System.Windows.DataTemplate> の要素は、UI オートメーション \(UIA\) ツリーのコントロール ビューに表示されます。|この変更により、ユーザー補助が向上します。 ただし、隣接する要素を検索するために UIA ツリーの以前の構造を必要とするテスト ツールには影響があります。|  
+|<xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> プロパティとバインドされたプロパティの同期|場合によっては、データ バインディングの書き込み操作中にプロパティが変更された場合、<xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> プロパティにデータ バインディング プロパティ値の以前の値が反映されることがあります。|これによって生じる悪影響はないはずです。 ただし、<xref:System.Windows.FrameworkCompatibilityPreferences.KeepTextBoxDisplaySynchronizedWithTextProperty%2A?displayProperty=fullName> プロパティを `false` に設定して、以前の動作を復元することは可能です。|  
+|<xref:System.Windows.Controls.TextBox?displayProperty=fullName> プロパティ|<xref:System.Windows.Controls.TextBox?displayProperty=fullName> のコントロールが非アクティブになると、ボックス内で選択したテキストが、テキスト ボックスがアクティブなときとは異なる色で表示されます。|<xref:System.Windows.FrameworkCompatibilityPreferences.AreInactiveSelectionHighlightBrushKeysSupported%2A?displayProperty=fullName> プロパティを `false` に設定して、以前の動作を復元することができます。|  
+|<xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName>|<xref:System.Windows.Controls.Primitives.MultiSelector.CanSelectMultipleItems%2A> を `true` に設定した <xref:System.Windows.Controls.Primitives.MultiSelector> から派生されたコントロールの <xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクションに重複がある場合、重複した項目が複数回表示されます。 データ ソースからこれらの項目を削除すると \(たとえば、`Items.Clear` を呼び出すことにより\)、<xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクションからそれらの項目を削除できなくなります。最初のインスタンスのみが削除されます。<br /><br /> <xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクションを引き続き使用すると \(`SelectedItems.Clear` の呼び出しなど\)、<xref:System.ArgumentException> などの問題が発生する可能性があります。これは、<xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクション内に、データ ソース内にもはや存在しない項目が含まれているためです。|この問題は、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では対処済みです。<xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクションに重複項目が含まれている場合、データ ソースからそれらを削除し、その後も <xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A?displayProperty=fullName> コレクションを使用するには、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] にアップグレードしてください。|  
+|<xref:System.Windows.Threading.DispatcherSynchronizationContext.CreateCopy%2A?displayProperty=fullName>|[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、メソッドは現在のインスタンスへの参照を返します。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、新しいインスタンスが返されます。|等しい値の参照を前提としているコードは、正しいコンテキストでのスレッドの実行は、現在でも正しく実行されることを示します。 ただし、変更が行われたため、<xref:System.Windows.Threading.DispatcherSynchronizationContext.CreateCopy%2A?displayProperty=fullName> を呼び出すコードはテストする必要があります。|  
+|<xref:System.Windows.Interop.HwndSource.AddHook%2A?displayProperty=fullName> メソッドの呼び出しによって追加されるハンドラーを使用した `WM_POWERBROADCAST` メッセージの監視|ウィンドウはハンドルを [RegisterPowerSettingNotification](https://msdn.microsoft.com/library/windows/desktop/aa373196.aspx) 関数に渡すことによって、`WM_POWERBROADCAST` の通知を受けるための登録を明示的に行う必要があります。 WPF では、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] によってすべてのウィンドウで自動的にこの処理が行われていました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、WPF によって自動的に 1 つの特殊なウィンドウが登録されますが、ほとんどのアプリ ウィンドウは自動的に登録されません。|`WM_POWERBROADCAST` 通知を処理するコードは実行されません。<br /><br /> 引き続き `WM_POWERBROADCAST` 通知を受け取るには、[RegisterPowerSettingNotification](https://msdn.microsoft.com/library/windows/desktop/aa373196.aspx) 関数を呼び出して、WPF ウィンドウ \(通常はアプリケーションのメイン ウィンドウ\) が `WM_POWERBROADCAST` 通知を受け取るための登録を行います。 C\# で開発した WPF アプリでは、このためにプロジェクト プロパティの **\[ビルド\]** タブで **\[アンセーフ コードの許可\]** ボックスをオンにする必要もあります。<br /><br /> さらに、アプリケーションがシャットダウンされるまで保持されないウィンドウを登録する場合は、[UnregisterPowerSettingNotification](https://msdn.microsoft.com/library/windows/desktop/aa373237.aspx) 関数を呼び出し、これに対して [RegisterPowerSettingNotification](https://msdn.microsoft.com/library/windows/desktop/aa373196.aspx) 関数の呼び出しから返された `HPOWERNOTIFY` ハンドルを渡すことで、ウィンドウの登録を解除してください。|  
+  
+<a name="wwf"></a>   
+## Windows Workflow Foundation \(WF\)  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|System.Activities.dll のセキュリティ|アセンブリは <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性でマークされています。|派生クラスに <xref:System.Security.SecurityCriticalAttribute>のマークを付けることはできません。 以前は、派生型に <xref:System.Security.SecurityCriticalAttribute>マークを付ける必要がありました。 ただし、この変更によって生じる実質的な影響はないはずです。|  
+|WF 3.0 の型およびメンバー|WF 3.0 の型とメンバーは互換性のために残されているものとしてマークされるようになりました。|WF 3.0 の型またはメンバーを使用するソース コードをコンパイルすると、コンパイラ エラーが発生します。<xref:System.Activities> 名前空間では WF 4 の型およびメンバーを使用する必要があります。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName> クラス|<xref:System.Activities.Presentation.DragDropHelper> クラスには、複数のオブジェクトでのドラッグ アンド ドロップ操作をサポートする新しいメソッドが含まれています。 1 つのオブジェクトのドラッグをサポートする既存のドラッグ アンド ドロップ メソッドは廃止されました。 \(詳細については、「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)」を参照してください\)。|古いメソッドは廃止されますが、コンパイラと共通言語ランタイムの両方で引き続きサポートされます。 ただし、新しいメソッドの方が機能性が優れています。 既存のメソッドで推奨される代替メソッドは次のとおりです。<br /><br /> <xref:System.Activities.Presentation.DragDropHelper.DoDragMove%28System.Activities.Presentation.WorkflowViewElement%2CSystem.Windows.Point%29?displayProperty=fullName> の代わりに <xref:System.Activities.Presentation.DragDropHelper.DoDragMove%28System.Activities.Presentation.WorkflowViewElement%2CSystem.Windows.Point%29?displayProperty=fullName> を使用します。<br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetCompositeView%28System.Activities.Presentation.WorkflowViewElement%29> の代わりに <xref:System.Activities.Presentation.DragDropHelper.GetCompositeView%28System.Windows.DragEventArgs%29> を使用します。<br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetDraggedModelItems%28System.Windows.DragEventArgs%29> の代わりに <xref:System.Activities.Presentation.DragDropHelper.GetDraggedModelItem%28System.Windows.DragEventArgs%29> を使用します。<br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetDroppedObjects%28System.Windows.DependencyObject%2CSystem.Windows.DragEventArgs%2CSystem.Activities.Presentation.EditingContext%29> の代わりに <xref:System.Activities.Presentation.DragDropHelper.GetDroppedObject%28System.Windows.DependencyObject%2CSystem.Windows.DragEventArgs%2CSystem.Activities.Presentation.EditingContext%29> を使用します。|  
+|<xref:System.Windows.Threading.Dispatcher.Invoke%2A?displayProperty=fullName> メソッドへの呼び出しのオーバーロードの解決|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] には、<xref:System.Action?displayProperty=fullName> 型のパラメーターが含まれる新しいオーバーロードが追加されています。 既存のコードを再コンパイルすると、コンパイラは <xref:System.Windows.Threading.Dispatcher.Invoke%2A?displayProperty=fullName> パラメーターを持つ <xref:System.Delegate> メソッドを <xref:System.Windows.Threading.Dispatcher.Invoke%2A?displayProperty=fullName> パラメーターを持つ <xref:System.Action?displayProperty=fullName> メソッドとして呼び出しを解決することができます。|<xref:System.Windows.Threading.Dispatcher.Invoke%2A?displayProperty=fullName> パラメーターを持つ <xref:System.Delegate> オーバーロードへの呼び出しが <xref:System.Windows.Threading.Dispatcher.Invoke%2A?displayProperty=fullName> パラメーターを持つ <xref:System.Action?displayProperty=fullName> オーバーロードへの呼び出しとして解決されると、次のような動作上の変化が生じることがあります。<br /><br /> 例外が発生した場合、<xref:System.Windows.Threading.Dispatcher.UnhandledExceptionFilter?displayProperty=fullName> イベントと <xref:System.Windows.Threading.Dispatcher.UnhandledException?displayProperty=fullName> イベントは発生しません。 代わりに、例外は <xref:System.Threading.Tasks.TaskScheduler.UnobservedTaskException> イベントによって処理されます。<br /><br /> <xref:System.Windows.Threading.DispatcherOperation.Result%2A?displayProperty=fullName> などの一部のメンバーの呼び出しは、操作が完了するまでブロックされます。|  
+|<xref:System.Activities.Expressions.Literal%601?displayProperty=fullName> クラス|関連した <xref:System.Windows.Markup.ValueSerializer> オブジェクトは、<xref:System.DateTime> コンポーネントと <xref:System.DateTimeOffset> コンポーネントが非ゼロで \(`Second` 値の場合\)、`Millisecond` プロパティが <xref:System.DateTime> ではない <xref:System.DateTime.Kind%2A?displayProperty=fullName> オブジェクトまたは <xref:System.DateTimeKind> オブジェクトを文字列ではなくプロパティ要素構文に変換します。|この変更により、<xref:System.DateTime> 値と <xref:System.DateTimeOffset> 値を往復させることができるようになります。 入力 XAML が属性構文であると想定するカスタム XAML パーサーは正しく機能しません。|  
+  
+<a name="xml"></a>   
+## XML、XSLT  
+  
+|機能|変更|影響|  
+|--------|--------|--------|  
+|`XDocument.Validate` メソッド|<xref:System.Xml.Linq.LoadOptions?displayProperty=fullName> 値が <xref:System.Xml.Linq.XDocument.Load%2A> メソッドに渡されたときに検証エラーが発生すると、<xref:System.Xml.Schema.XmlSchemaException.LineNumber%2A?displayProperty=fullName> プロパティと <xref:System.Xml.Schema.XmlSchemaException.LinePosition%2A?displayProperty=fullName> プロパティに行情報が含まれるようになりました。|<xref:System.Xml.Schema.XmlSchemaException.LineNumber%2A?displayProperty=fullName> プロパティと <xref:System.Xml.Schema.XmlSchemaException.LinePosition%2A?displayProperty=fullName> のプロパティの値を必要とする例外処理コードは機能しなくなります。|  
+|<xref:System.Xml.XmlTextReader?displayProperty=fullName> を使用した XML ファイルの読み込み|DTD エンティティの展開は 10,000,000 文字までに制限されています。|DTD エンティティの展開を使用しない XML ファイルの読み込みや、制限された DTD エンティティの展開を使用した XML ファイルの読み込みは、影響を受けません。 DTD エンティティの展開が 10,000,000 文字を超えるファイルは読み込みに失敗し、例外をスローします。|  
+|<xref:System.Xml.Xsl.XslCompiledTransform?displayProperty=fullName> クラスの上位互換モード|[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)]では、XSLT 1.0 の上位互換性に、次の問題がありました。<br /><br /> バージョンが 2.0 に設定されているときに、パーサーが認識できない XSLT 1.0 コンストラクトに遭遇すると、スタイル シートの読み込みが失敗していました。<br /><br /> スタイル シートのバージョンが 1.1 に設定されている場合、`xsl:sort` コンストラクトでデータを並べ替えることができませんでした。<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、これらの問題は修正され、XSLT 1.0 の上位互換モードが正常に機能するようになりました。|XSLT 1.0 の上位互換モードは、以前と同じように機能します。|  
+|XSLT ファイルが複雑すぎる場合の例外メッセージ|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、XSLT ファイルが複雑すぎる場合のエラー メッセージのテキストが 「スタイル シートが複雑すぎます」になります。 以前のバージョンのエラー メッセージは 「XSLT コンパイル エラー」でした。|エラー メッセージのテキストに依存するアプリケーション コードは機能しなくなります。 ただし、例外の種類は同じなので、この変更による実質的な影響はありません。|  
+|xsd:anyURI の XML スキーマ検証|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、XML スキーマ検証が厳格化されました。 xsd:anyURI を使用して mailto プロトコルなどの URI を検証したときに、URI にスペースが入っていると検証は失敗します。 .NET Framework の以前のバージョンでは、検証は成功していました。|この変更は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]を対象とするアプリケーションにのみ影響します。|  
+  
+## 参照  
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)   
+ [新機能](../../../docs/framework/whats-new/index.md)   
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)   
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)   
+ [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md
new file mode 100644
index 00000000000..4b7519a4272
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md
@@ -0,0 +1,43 @@
+---
+title: ".NET Framework 4.6.1 でのアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b86cc4ad-6a9e-4246-aa96-5aae319d9d55
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# .NET Framework 4.6.1 でのアプリケーションの互換性
+このトピックでは、.NET Framework 4.6 と [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] の間のアプリケーションの互換性の問題に関する情報へのリンクを示します。 すべての問題は、次の 1 つのカテゴリに分類されます。  
+  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6-1.md)  
+ 実行時の変更は [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されていて、特定の機能を使用するすべてのアプリに影響します。  
+  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md)  
+ 変更を再ターゲットすると特に [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象として再コンパイルされるアプリにのみ影響します。 .NET Framework の以前のバージョンを対象とするアプリは、それらのバージョンで実行されているときは以前のように動作します。  
+  
+ 変更の再ターゲットについて説明する項目では、次に示すように、予想される影響ごとに個々の項目を分類しました。  
+  
+ Major  
+ これは、多数のアプリに影響するか、またはコードに重大な変更を加える必要のある重要な変更点です。  
+  
+ Minor  
+ これは、少数のアプリに影響するか、またはコードにわずかな変更を加える必要のある変更点です。  
+  
+ エッジ ケース  
+ これは、一般的ではない特定のシナリオでアプリに影響する変更点です。  
+  
+ 透過的  
+ これはアプリの開発者やユーザーには大きな影響を及ぼさない変更です。 アプリはこの変更のために変更を加える必要はありません。  
+  
+## 参照  
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md
new file mode 100644
index 00000000000..6c2b031389b
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md
@@ -0,0 +1,51 @@
+---
+title: ".NET Framework 4.6 のアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a3fd352-a8ba-4f9a-8250-951f2c994248
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# .NET Framework 4.6 のアプリケーションの互換性
+このトピックでは、.NET Framework 4.5.2 と 4.6 間のアプリケーションの互換性の問題に関する情報へのリンクを示します。  問題は 2 つのカテゴリに分けられます。  
+  
+ [ランタイムの変更](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md)  
+ 実行時の変更は [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で実行されていて、特定の機能を使用するすべてのアプリに影響します。  
+  
+ [再ターゲットの変更](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)  
+ 変更の再ターゲットは、.NET Framework 4.5、4.5.1、4.5.2、または 4.6 を対象として再コンパイルされるアプリに影響します。  Windows コモン コントロールには以下が含まれます。  
+  
+-   デザイン時環境の変更。  たとえば、ビルド ツールは以前は出力しなかったときに警告を出力する場合があります。  
+  
+-   ランタイム時環境の変更。  これらは、特に [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を対象とするアプリにのみ影響します。  .NET Framework の以前のバージョンを対象とするアプリは、それらのバージョンで実行されているときは以前のように動作します。  
+  
+ ランタイムの変更および変更の再ターゲットについて説明するトピックでは、次に示すように、予想される影響ごとに個々の項目を分類しました。  
+  
+ Major  
+ これは、多数のアプリに影響するか、またはコードに重大な変更を加える必要のある重要な変更点です。  
+  
+ Minor  
+ これは、少数のアプリに影響するか、またはコードにわずかな変更を加える必要のある変更点です。  
+  
+ エッジ ケース  
+ これは、一般的ではない特定のシナリオでアプリに影響する変更点です。  
+  
+ 透過的  
+ これはアプリの開発者やユーザーには大きな影響を及ぼさない変更です。  アプリはこの変更のために変更を加える必要はありません。  
+  
+## 参照  
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)   
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)   
+ [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/application-compatibility.md b/docs/framework/migration-guide/application-compatibility.md
new file mode 100644
index 00000000000..d7ad00af266
--- /dev/null
+++ b/docs/framework/migration-guide/application-compatibility.md
@@ -0,0 +1,76 @@
+---
+title: ".NET Framework のアプリケーションの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4ba3ff2-fe59-4c5d-9e0b-86bba3cd865c
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework のアプリケーションの互換性
+次の記事では、.NET Framework の最新バージョンでのアプリケーションの互換性の問題について説明します。  
+  
+-   バージョン 4 と 4.5 の間: [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)  
+  
+-   バージョン 4.5 と 4.5.1 の間: [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)  
+  
+-   バージョン 4.5.1 と 4.5.2 の間: [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)  
+  
+-   バージョン 4.5.2 と 4.6 の間: [4.6 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md)  
+  
+-   バージョン 4.6 と [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] の間: [4.6.1 でのアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)  
+  
+ 一般に、特定のバージョンを対象とするアプリが新しいバージョンで変更せずに実行できるように、.NET Framework のバージョン間の下位互換性を非常に高レベルで維持しようとしていました。 ほとんどのアプリケーションの互換性の問題の影響は少なく、アプリのプログラミング変更を必要とすることはほとんどありません。 プログラミング変更が必要になる変更点については、これらのリンクの表の「影響」列を参照してください。  
+  
+## .NET Framework 4 以前のバージョンからの移行  
+ .NET Framework 4 より前のバージョンの .NET Framework から移行するときは、アプリに影響する可能性があるアプリケーションの互換性の問題について次のトピックを確認してください。  
+  
+-   [.NET framework 4 の移行に関する問題](http://msdn.microsoft.com/library/ee941656\(v=vs.100\).aspx)  
+  
+-   [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)  
+  
+-   [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)  
+  
+-   [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)  
+  
+-   [4.6 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md)  
+  
+-   [4.6.1 でのアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)  
+  
+## .NET Framework 4 からの移行  
+ .NET Framework 4 から 4.6 へ移行するときは、アプリに影響する可能性があるアプリケーションの互換性の問題を扱った次のトピックを確認してください。  
+  
+-   [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)  
+  
+-   [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)  
+  
+-   [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)  
+  
+-   [4.6 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md)  
+  
+-   [4.6.1 でのアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)  
+  
+## .NET Framework 4.5 からの移行  
+ .NET Framework 4.5 からそれ以降のバージョンへ移行するときは、アプリに影響する可能性があるアプリケーションの互換性の問題について次のトピックを確認してください。  
+  
+-   [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)  
+  
+-   [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)  
+  
+-   [4.6 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md)  
+  
+-   [4.6.1 でのアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)  
+  
+## 参照  
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)   
+ [新機能](../../../docs/framework/whats-new/index.md)   
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md b/docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md
new file mode 100644
index 00000000000..e57a834d258
--- /dev/null
+++ b/docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63c6b9a8-0088-4077-9aa3-521ab7290f79
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する
+共通言語ランタイム \(CLR\) をホストするすべてのアプリでは、マネージ コードを実行するために CLR を開始または*アクティブ化*する必要があります。  通常、.NET Framework アプリはビルドされた CLR のバージョンで実行されますが、アプリケーション構成ファイル \(app.config ファイルと呼ばれることもあります\) を使用して、デスクトップ アプリのこの動作を変更できます。  ただし、アプリケーション構成ファイルを使用して Windows ストア アプリまたは Windows Phone アプリの既定のアクティベーション動作は変更できません。  この記事では、デスクトップ アプリを .NET Framework の別のバージョンで実行できるようにする方法を説明し、Version 4 または 4.5 を対象とする方法の例を示します。  
+  
+ アプリが実行される .NET Framework のバージョンは、次の順序で決まります。  
+  
+-   構成ファイル。  
+  
+     アプリケーション構成ファイルに 1 つ以上の .NET Framework のバージョンを指定する [\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) エントリがあり、これらのバージョンの 1 つがユーザーのコンピューターにある場合、アプリはそのバージョンで実行されます。  構成ファイルは、一覧表示された順序で [\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) エントリを読み込み、ユーザーのコンピューターにある、最初に表示される .NET Framework バージョンを使用します   \(Version 1.0 では [\<requiredRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/requiredruntime-element.md)を使用します\)。  
+  
+-   コンパイル後のバージョン。  
+  
+     構成ファイルがなく、アプリがビルドされた .NET Framework のバージョンがユーザーのコンピューターに存在する場合、アプリはそのバージョンで実行されます。  
+  
+-   インストールされた最新バージョン。  
+  
+     アプリがビルドされた .NET Framework のバージョンがなく、構成ファイルの [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)でバージョンが指定されていない場合、アプリはユーザーのコンピューターにある .NET Framework の最新バージョンで実行が試みられます。  
+  
+     ただし、.NET Framework 1.0、1.1、2.0、3.0、および 3.5 のアプリは、.NET Framework 4 以降では自動的に実行されず、場合によっては、エラーが発生し、.NET Framework 3.5 をインストールするように求めるメッセージが表示されることがあります。  また、Windows システムの異なるバージョンには .NET Framework の異なるバージョンが含まれるので、アクティベーション動作はユーザーのオペレーティング システムに応じて異なる場合があります。  アプリが .NET Framework 3.5 と 4、またはそれ以降をサポートしている場合は、構成ファイルの複数のエントリでこれを示して .NET Framework 初期化エラーを回避することをお勧めします。  詳細については、「[バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)」を参照してください。  
+  
+ また、.NET Framework 3.5 がコンピューターにインストールされている場合でも、.NET Framework 4 および 4.5 で実行できるように .NET Framework 3.5 アプリを構成して、Version 4 および 4.5 のパフォーマンス向上を活用することもできます。  
+  
+> [!IMPORTANT]
+>  サポートするすべての .NET Framework のバージョンで必ずアプリをテストすることをお勧めします。  以降の .NET Framework のバージョンをサポートするためのアプリケーションのアップグレードについての詳細は、「[バージョンの互換性](../../../docs/framework/migration-guide/version-compatibility.md)」を参照してください。  
+  
+ .NET Framework 1.0 および 1.1 アプリを変更して Windows 7 と Windows 8 をサポートする方法の詳細については、「[.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)」を参照してください。  
+  
+### .NET Framework 4 または 4.5 で実行できるようにアプリを構成するには  
+  
+1.  .NET Framework プロジェクトの構成ファイルを追加または検索します。  アプリの構成ファイルは、同じディレクトリにあり、アプリと同じ名前ですが、.config 拡張子があります。  たとえば、アプリが MyExecutable.exe という名前であれば、アプリケーション構成ファイルの名前は MyExecutable.exe.config です。  
+  
+     構成ファイルを追加するには、Visual Studio のメニュー バーで **\[プロジェクト\]**、**\[新しい項目の追加\]** の順にクリックします。  左ペインで **\[全般\]** をクリックし、**\[構成ファイル\]** をクリックします。  構成ファイルに  *appName*.exe.config という名前を付けます。  これらのメニューの選択は、Windows ストア アプリ プロジェクトまたは Windows phone アプリ プロジェクトでは使用できません。これらのプラットフォームのアクティベーション ポリシーを変更できないためです。  
+  
+2.  次のように、アプリケーション構成ファイルに [\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素を追加します。  
+  
+    ```  
+    <configuration>  
+      <startup>  
+        <supportedRuntime version="<version>"/>  
+      </startup>  
+    </configuration>  
+  
+    ```  
+  
+     *\<version\>* が、アプリがサポートする .NET Framework のバージョンに合わせて CLR バージョンを指定する場合。  次の文字列を使用します。  
+  
+    -   .NET Framework 1.0: 「v1.0.3705」  
+  
+    -   .NET Framework 1.1: 「v1.1.4322」  
+  
+    -   .NET Framework 2.0、3.0、および 3.5: 「v2.0.50727」  
+  
+    -   .NET Framework 4 および 4.5 \(4.5.1 などのポイント リリースを含む\): 「v4.0」  
+  
+     複数の [\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素を優先順に追加して、複数バージョンの .NET Framework のサポートを指定できます。  
+  
+ アプリケーション構成ファイルの設定およびコンピューターにインストールされている .NET Framework のバージョンによって、.NET Framework 3.5 アプリが実行されるバージョンがどのように決定されるかを次の表に示します。  この例は、.NET Framework 3.5 のアプリケーションに固有ですが、以前の .NET Framework バージョンで作成されたアプリケーションを対象にする場合も同様のロジックを使用できます。  アプリケーション構成ファイルで .NET Framework 3.5 を指定するために、.NET Framework 2.0 のバージョン番号 \(v2.0.50727\) が使用されることに注意してください。  
+  
+|||||  
+|-|-|-|-|  
+|App.config ファイルの設定|バージョン 3.5 がインストールされているコンピューター|バージョン 3.5 と 4 または 4.5 がインストールされているコンピューター|バージョン 4 または 4.5 がインストールされているコンピューター|  
+|なし|3.5 で動作|3.5 で動作|ユーザーに正しいバージョン \* をインストールするように求めるエラー メッセージが表示されます。|  
+|`<supportedRuntime version="v2.0.50727"/>`|3.5 で動作|3.5 で動作|ユーザーに正しいバージョン \* をインストールするように求めるエラー メッセージが表示されます。|  
+|`<supportedRuntime version="v2.0.50727"/>`  <br />  `<supportedRuntime version="v4.0"/>`|3.5 で動作|3.5 で動作|4 または 4.5 で動作|  
+|`<supportedRuntime version="v4.0"/>`  <br />  `<supportedRuntime version="v2.0.50727"/>`|3.5 で動作|4 または 4.5 で動作|4 または 4.5 で動作|  
+|`<supportedRuntime version="v4.0"/>`|ユーザーに正しいバージョン \* をインストールするように求めるエラー メッセージが表示されます。|4 または 4.5 で動作|4 または 4.5 で動作|  
+  
+ \* このエラー メッセージの詳細と回避方法については、「[.NET Framework 初期化エラー: ユーザー エクスペリエンスの管理](../../../docs/framework/deployment/initialization-errors-managing-the-user-experience.md)」を参照してください。  
+  
+## 参照  
+ [.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)   
+ [移行ガイド](../Topic/Migration%20Guide%20to%20the%20.NET%20Framework%204.6%20and%204.5%20.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md b/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md
new file mode 100644
index 00000000000..da3297910dc
--- /dev/null
+++ b/docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : インストールされている .NET Framework の更新プログラムを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, 確認 (更新プログラム)"
+  - "更新, 確認 (.NET Framework の)"
+ms.assetid: 53c7b5f7-d47a-402a-b194-7244a696a88b
+caps.latest.revision: 6
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : インストールされている .NET Framework の更新プログラムを確認する
+コンピューターにインストールされている .NET Framework のバージョンごとのインストール済みの更新プログラムは、Windows レジストリに一覧表示されます。  レジストリ エディター \(regedit.exe\) を使用して、この情報を表示することができます。  
+  
+ レジストリ エディターでは、各バージョンの .NET Framework バージョンとインストールされている更新プログラムが別々のサブキーに格納されます。  インストールされているバージョン番号を検出する方法については、「[方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」をご覧ください。  .NET Framework をインストールする方法については、[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)を参照してください。  
+  
+### インストールされている更新プログラムを確認するには  
+  
+1.  プログラム **regedit.exe** を開きます。  Windows 8 以降の場合、スタート画面を開き、名前を入力します。  それより前のバージョンの Windows では、\[**スタート**\] メニューの \[**ファイル名を指定して実行**\] を選択し、\[ **開く**\] ボックスに **regedit.exe** と入力します。  
+  
+     regedit.exe を実行するには、管理特権が必要です。  
+  
+2.  レジストリ エディターで、次のサブキーを開きます。  
+  
+     HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\Updates  
+  
+     インストールされている更新プログラムは、適用された .NET Framework バージョンを識別するサブキーの下に一覧表示されています。  各更新プログラムは、サポート技術情報の \(KB\) 番号で識別されます。  
+  
+## 使用例  
+ 次のコードは、プログラミングによってコンピューターにインストールされている .NET Framework の更新プログラムを判断します。  この例を実行するには、管理特権が必要です。  
+  
+ [!code-csharp[ListUpdates#1](../../../samples/snippets/csharp/VS_Snippets_CLR/listupdates/cs/program.cs#1)]
+ [!code-vb[ListUpdates#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listupdates/vb/program.vb#1)]  
+  
+ この例では次のような出力が生成されます。  
+  
+```  
+  
+Microsoft .NET Framework 3.5 SP1  
+  KB953595  Hotfix for Microsoft .NET Framework 3.5 SP1 (KB953595)  
+  SP1  
+    KB2657424  Security Update for Microsoft .NET Framework 3.5 SP1 (KB2657424)  
+    KB958484  Hotfix for Microsoft .NET Framework 3.5 SP1 (KB958484)  
+    KB963707  Update for Microsoft .NET Framework 3.5 SP1 (KB963707)  
+Microsoft .NET Framework 4 Client Profile  
+  KB2160841  Security Update for Microsoft .NET Framework 4 Client Profile (KB2160841)  
+  KB2446708  Security Update for Microsoft .NET Framework 4 Client Profile (KB2446708)  
+  KB2468871  Update for Microsoft .NET Framework 4 Client Profile (KB2468871)  
+  KB2478663  Security Update for Microsoft .NET Framework 4 Client Profile (KB2478663)  
+  KB2518870  Security Update for Microsoft .NET Framework 4 Client Profile (KB2518870)  
+  KB2533523  Update for Microsoft .NET Framework 4 Client Profile (KB2533523)  
+  KB2539636  Security Update for Microsoft .NET Framework 4 Client Profile (KB2539636)  
+  KB2572078  Security Update for Microsoft .NET Framework 4 Client Profile (KB2572078)  
+  KB2633870  Security Update for Microsoft .NET Framework 4 Client Profile (KB2633870)  
+  KB2656351  Security Update for Microsoft .NET Framework 4 Client Profile (KB2656351)  
+Microsoft .NET Framework 4 Extended  
+  KB2416472  Security Update for Microsoft .NET Framework 4 Extended (KB2416472)  
+  KB2468871  Update for Microsoft .NET Framework 4 Extended (KB2468871)  
+  KB2487367  Security Update for Microsoft .NET Framework 4 Extended (KB2487367)  
+  KB2533523  Update for Microsoft .NET Framework 4 Extended (KB2533523)  
+  KB2656351  Security Update for Microsoft .NET Framework 4 Extended (KB2656351)  
+  
+```  
+  
+## 参照  
+ [方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)   
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)   
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md b/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md
new file mode 100644
index 00000000000..30031a41887
--- /dev/null
+++ b/docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md
@@ -0,0 +1,185 @@
+---
+title: "方法 : インストールされている .NET Framework バージョンを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, 確認 (バージョンを)"
+  - "バージョン, 確認 (.NET Framework の)"
+ms.assetid: 40a67826-e4df-4f59-a651-d9eb0fdc755d
+caps.latest.revision: 62
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 53
+---
+# 方法 : インストールされている .NET Framework バージョンを確認する
+ユーザーはコンピューターに複数のバージョンの .NET Framework をインストールして実行できます。 アプリを開発または配置する場合、どのバージョンの .NET Framework がユーザーのコンピューターにインストールされているかを確認しなければならない場合があります。 .NET Framework は、個別にバージョン管理される 2 つの主要コンポーネントで構成されています。  
+  
+-   アプリに機能を提供する型やリソースのコレクションである一連のアセンブリ。 .NET Framework とアセンブリは同じバージョン番号を共有します。  
+  
+-   アプリのコードを管理および実行する共通言語ランタイム \(CLR\)。 CLR は独自のバージョン番号で識別されます \(「[バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)」を参照してください\)。  
+  
+ コンピューターにインストールされている .NET Framework バージョンの正確な一覧を取得するには、レジストリを表示するか、コードでレジストリを照会することができます。  
+  
+ [レジストリの表示 \(バージョン 1 ～ 4\)](#net_a)  
+[レジストリの表示 \(バージョン 4.5 以降\)](#net_b)  
+[コードによるレジストリの照会 \(バージョン 1 ～ 4\)](#net_c)  
+[コードによるレジストリの照会 \(バージョン 4.5 以降\)](#net_d)  
+  
+ CLR のバージョンを検索するには、ツールまたはコードを使用できます。  
+  
+ [Clrver ツールの使用](#clr_a)  
+[コードによる System.Environment クラスの照会](#clr_b)  
+  
+ .NET Framework の各バージョン用にインストールされている更新プログラムの検出については、「[方法 : インストールされている .NET Framework の更新プログラムを確認する](../../../docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md)」を参照してください。 .NET Framework をインストールする方法については、[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)を参照してください。  
+  
+<a name="net_a"></a>   
+#### レジストリを表示して .NET Framework のバージョンを検索するには \(.NET Framework 1 ～ 4\)  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックします。  
+  
+2.  **\[開く\]** ボックスに「**regedit.exe**」と入力します。  
+  
+     regedit.exe を実行するには、管理特権が必要です。  
+  
+3.  レジストリ エディターで、次のサブキーを開きます。  
+  
+     `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP`  
+  
+     インストールされているバージョンは NDP のサブキーの下に一覧表示されています。 バージョン番号は、**Version** エントリに格納されています。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、**Version** エントリは、Client サブキーまたは Full サブキー \(NDP の下\)、または両方のサブキーの下にあります。  
+  
+    > [!NOTE]
+    >  レジストリの ".NET Framework セットアップ" フォルダーの先頭はピリオドではありません。  
+  
+<a name="net_b"></a>   
+#### レジストリを表示して .NET Framework のバージョンを検索するには \(.NET Framework 4.5 以降\)  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックします。  
+  
+2.  **\[開く\]** ボックスに「**regedit.exe**」と入力します。  
+  
+     regedit.exe を実行するには、管理特権が必要です。  
+  
+3.  レジストリ エディターで、次のサブキーを開きます。  
+  
+     `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full`  
+  
+     `Full` サブキーへのパスに `.NET Framework` ではなく `Net Framework` サブキーが含まれていることに注意してください。  
+  
+    > [!NOTE]
+    >  `Full` サブキーが存在しない場合は、.NET Framework 4.5 以降がインストールされていません。  
+  
+     `Release` という名前の DWORD 値を確認します。`Release` DWORD がある場合は、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降がコンピューターにインストールされていることを示します。  
+  
+     ![.NET Framework 4.5 のレジストリ エントリ。](../../../docs/framework/migration-guide/media/clr-installdir.png "CLR\_InstallDir")  
+  
+     `Release` の値は、インストールされている .NET Framework のバージョンを示します。  
+  
+    |Release DWORD の値|バージョン|  
+    |----------------------|-----------|  
+    |378389|.NET Framework 4.5|  
+    |378675|Windows 8.1 または Windows Server 2012 R2 でインストールされた .NET Framework 4.5.1|  
+    |378758|Windows 8、Windows 7 SP1、または Windows Vista SP2 上でインストールされた .NET Framework 4.5.1|  
+    |379893|.NET Framework 4.5.2|  
+    |Windows 10 システム上: 393295<br /><br /> その他すべての OS バージョン上: 393297|[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|  
+    |Windows 10 の 11 月更新版のシステムの場合: 394254<br /><br /> 他のすべての OS バージョンの場合: 394271|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|  
+  
+<a name="net_c"></a>   
+#### コードでレジストリを照会して .NET Framework のバージョンを検索するには \(.NET Framework 1 ～ 4\)  
+  
+-   <xref:Microsoft.Win32.RegistryKey?displayProperty=fullName> クラスを使用して、Windows レジストリの HKEY\_LOCAL\_MACHINE の下にある Software\\Microsoft\\NET Framework Setup\\NDP\\ サブキーにアクセスします。  
+  
+     このクエリの例を次のコードに示します。  
+  
+    > [!NOTE]
+    >  このコードは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降を検出する方法を示すコードではありません。 前のセクションで説明したように、これらのバージョンを検出するには、`Release` DWORD を確認してください。  
+  
+     [!code-csharp[ListVersions#0](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#0)]
+     [!code-vb[ListVersions#0](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#0)]  
+    [!code-csharp[ListVersions#1](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#1)]
+    [!code-vb[ListVersions#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#1)]  
+  
+     この例では次のような出力が生成されます。  
+  
+    ```  
+  
+    v2.0.50727  2.0.50727.4016  SP2 v3.0  3.0.30729.4037  SP2 v3.5  3.5.30729.01  SP1 v4 Client  4.0.30319 Full  4.0.30319  
+    ```  
+  
+<a name="net_d"></a>   
+#### コードでレジストリを照会して .NET Framework のバージョンを検索するには \(.NET Framework 4.5 以降\)  
+  
+1.  `Release` DWORD がある場合は、.NET Framework 4.5 以降がコンピューターにインストールされています。 キーワードの値はインストールされているバージョンを示します。 このキーワードを確認するには、<xref:Microsoft.Win32.RegistryKey?displayProperty=fullName> クラスの <xref:Microsoft.Win32.RegistryKey.OpenBaseKey%2A> メソッドと <xref:Microsoft.Win32.RegistryKey.OpenSubKey%2A> メソッドを使って、Windows レジストリの HKEY\_LOCAL\_MACHINE の下にある Software\\Microsoft\\NET Framework Setup\\NDP\\v4\\Full サブキーにアクセスします。  
+  
+2.  `Release` キーワードの値を確認して、インストールされているバージョンを決定します。 上位互換性を確認するには、テーブルに示されている値以上の値があるかを確認します。 .NET Framework のバージョンと関連付けられた `Release` キーワードを次に示します。  
+  
+    |バージョン|Release DWORD の値|  
+    |-----------|----------------------|  
+    |.NET Framework 4.5|378389|  
+    |Windows 8.1 でインストールされた .NET Framework 4.5.1|378675|  
+    |Windows 8、Windows 7 SP1、または Windows Vista SP2 上でインストールされた .NET Framework 4.5.1|378758|  
+    |.NET Framework 4.5.2|379893|  
+    |Windows 10 にインストールされた [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|393295|  
+    |その他のすべての Windows OS バージョンにインストールされた [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]|393297|  
+    |Windows 10 にインストールされる [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|394254|  
+    |その他のすべての Windows OS バージョンにインストールされた [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]|394271|  
+  
+     各バージョンの release キーワードの値以上の値を確認する例を次に示します。  
+  
+     [!code-csharp[ListVersions#0](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#0)]
+     [!code-vb[ListVersions#0](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#0)]  
+    [!code-csharp[ListVersions#3](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#3)]
+    [!code-vb[ListVersions#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#3)]  
+    [!code-csharp[ListVersions#4](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#4)]
+    [!code-vb[ListVersions#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#4)]  
+  
+     この例では次のような出力が生成されます。  
+  
+    ```  
+    Version: 4.5.1 or later  
+    ```  
+  
+<a name="clr_a"></a>   
+#### Clrver ツールを使用して現在のランタイムのバージョンを確認する方法  
+  
+-   CLR バージョン ツール \(Clrver.exe\) を使用して、コンピューターにインストールされている共通言語ランタイムのバージョンを確認します。  
+  
+     Visual Studio コマンド プロンプトで、「`clrver`」と入力します。 次のような出力が表示されます。  
+  
+    ```  
+    Versions installed on the machine: v2.0.50727 v4.0.30319  
+    ```  
+  
+     このツールの使用方法の詳細については、「[Clrver.exe \(CLR バージョン ツール\)](../../../docs/framework/tools/clrver-exe-clr-version-tool.md)」を参照してください。  
+  
+<a name="clr_b"></a>   
+#### コードで Environment クラスを照会して現在のランタイム バージョンを確認するには  
+  
+-   <xref:System.Environment.Version%2A?displayProperty=fullName> プロパティを照会して <xref:System.Version> オブジェクトを取得し、現在コードを実行しているランタイムのバージョンを識別します。 メジャー リリースの識別子 \(バージョン 4.0 の "4" など\) を取得するには <xref:System.Version.Major%2A?displayProperty=fullName> プロパティを、マイナー リリースの識別子 \(バージョン 4.0 の "0" など\) を取得するには <xref:System.Version.Minor%2A?displayProperty=fullName> プロパティを、バージョン文字列全体 \(次のコードに示すような "4.0.30319.18010" など\) を取得するには <xref:System.Object.ToString%2A?displayProperty=fullName> メソッドを使用できます。 このプロパティは、現在コードを実行しているランタイムのバージョンを表す単一の値を返しますが、アセンブリのバージョンやコンピューターにインストールされている可能性があるランタイムの他のバージョンは返しません。  
+  
+     .NET Framework バージョン 4、4.5、4.5.1、および 4.5.2 の場合は、<xref:System.Environment.Version%2A?displayProperty=fullName> プロパティから返される <xref:System.Version> オブジェクトの文字列表現が `4.0.30319.xxxxx` という形式になっています。[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] の場合は、そのフォームは `4.0.30319.42000` となります。  
+  
+     次に、<xref:System.Environment.Version%2A?displayProperty=fullName> プロパティを照会してランタイム バージョン情報を取得する例を示します。  
+  
+     [!code-csharp[ListVersions#0](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#0)]
+     [!code-vb[ListVersions#0](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#0)]  
+    [!code-csharp[ListVersions#2](../../../samples/snippets/csharp/VS_Snippets_CLR/listversions/cs/program.cs#2)]
+    [!code-vb[ListVersions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/listversions/vb/program.vb#2)]  
+  
+     この例では次のような出力が生成されます。  
+  
+    ```  
+    Version: 4.0.30319.18010  
+    ```  
+  
+## 参照  
+ [方法 : インストールされている .NET Framework の更新プログラムを確認する](../../../docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md)   
+ [インストール ガイド](../../../docs/framework/install/guide-for-developers.md)   
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/media/clr-installdir.png b/docs/framework/migration-guide/media/clr-installdir.png
new file mode 100644
index 00000000000..fe99e9eb429
Binary files /dev/null and b/docs/framework/migration-guide/media/clr-installdir.png differ
diff --git a/docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md b/docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md
new file mode 100644
index 00000000000..777407b3197
--- /dev/null
+++ b/docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md
@@ -0,0 +1,66 @@
+---
+title: ".NET Framework 1.1 からの移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 1.1, 移行 (.NET Framework 4.5 への)"
+  - ".NET Framework 4.5, 移行 (1.1 から)"
+ms.assetid: 7ead0cb3-3b19-414a-8417-a1c1fa198d9e
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# .NET Framework 1.1 からの移行
+[!INCLUDE[win7](../../../includes/win7-md.md)] 以降のバージョンの Windows オペレーティング システムでは、[!INCLUDE[net_v11_long](../../../includes/net-v11-long-md.md)] はサポートされません。 このため、[!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] を対象とするアプリケーションは変更を行わないと、[!INCLUDE[win7](../../../includes/win7-md.md)] 以降のバージョンのオペレーティング システムでは実行できません。 このトピックでは、[!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] を対象とするアプリケーションを [!INCLUDE[win7](../../../includes/win7-md.md)] 以降のバージョンの Windows オペレーティング システムで実行するために必要な手順について説明します。[!INCLUDE[net_v11_long](../../../includes/net-v11-long-md.md)] と [!INCLUDE[win8](../../../includes/win8-md.md)] の詳細については、「[Windows 8 以降のバージョンでの .NET Framework 1.1 アプリの実行](../../../docs/framework/install/run-net-framework-1-1-apps.md)」を参照してください。  
+  
+## 再ターゲットまたは再コンパイル  
+ [!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] を使用してコンパイルしたアプリケーションを [!INCLUDE[win7](../../../includes/win7-md.md)] 以降のバージョンの Windows オペレーティング システムで実行するには、次の 2 つの方法があります。  
+  
+-   アプリケーションを [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] に再ターゲットして実行することができます。 再ターゲットするには、[\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素をアプリケーションの構成ファイルに追加して [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] で実行できるようにする必要があります。 そのための構成ファイルの形式は次のとおりです。  
+  
+    ```  
+    <configuration> <startup> <supportedRuntime version="v4.0"/> </startup> </configuration>  
+  
+    ```  
+  
+-   [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] をターゲットとするコンパイラでアプリケーションを再コンパイルできます。 最初に Visual Studio 2003 を使用してソリューションを開発およびコンパイルした場合は、ソリューションを [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] で開きます。これにより、**\[Project Compatibility\]**\(プロジェクト互換性\) ダイアログ ボックスによってソリューションおよびプロジェクト ファイルが Visual Studio 2003 で使用される形式から [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] で使用される Microsoft Build Engine \(MSBuild\) 形式に変換されます。  
+  
+ 再コンパイルまたは再ターゲットのいずれを選択するかに関係なく、アプリケーションが .NET Framework の新しいバージョンで導入された変更の影響を受けるかどうかを確認する必要があります。 変更には次の 2 種類があります。  
+  
+-   [!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] より新しいバージョンで加えられた、互換性に影響する変更。  
+  
+-   [!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] より新しいバージョンで非推奨または旧式とマークされた型と型のメンバー。  
+  
+ アプリケーションを再ターゲットするか、再コンパイルするかに関係なく、[!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] より後にリリースされた .NET Framework の各バージョンについては、互換性に影響する変更と旧式の型および型のメンバーを確認する必要があります。  
+  
+## 互換性に影響する変更点  
+ 互換性に影響する変更が行われた場合は、変更内容に応じて、アプリケーションの再ターゲットおよび再コンパイル時の回避策が提示される場合があります。 場合によっては、アプリケーションの構成ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素に子要素を追加することで、以前の動作を復元できます。 たとえば、次の構成ファイルは [!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] での文字列の並べ替えおよび比較の動作を復元し、アプリケーションの再ターゲットまたは再コンパイルのいずれにも使用できます。  
+  
+```  
+<configuration> <runtime> <CompatSortNLSVersion enabled="4096"/> </runtime> </configuration>  
+  
+```  
+  
+ ただし、ソース コードの変更とアプリケーションの再コンパイルが必要になる場合があります。  
+  
+ 互換性に影響する可能性がある変更点がアプリケーションに与える影響を評価するには、次の変更一覧を確認する必要があります。  
+  
+-   「[.NET Framework 2.0 の互換性に影響する変更点](http://go.microsoft.com/fwlink/?LinkId=125263)」に記載されている、[!INCLUDE[net_v11_short](../../../includes/net-v11-short-md.md)] を対象とするアプリケーションに影響する可能性がある [!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] の変更点。  
+  
+-   「[.NET Framework 3.5 SP1 の変更点](http://go.microsoft.com/fwlink/?LinkID=186989)」に記載されている、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] から [!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] の変更点。  
+  
+-   「[.NET Framework 4 への移行に関する問題](http://msdn.microsoft.com/library/ee941656\(v=vs.100\).aspx)」に記載されている、[!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] から [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の変更点。  
+  
+## 旧式の型およびメンバー  
+ 旧式の型およびメンバーの影響は、アプリケーションを再ターゲットする場合と再コンパイルする場合とでは若干異なります。 旧式の型およびメンバーを使用しても、その型およびメンバーをアセンブリから物理的に削除しない限り、再ターゲットしたアプリケーションには影響しません。 旧式の型およびメンバーを使用してアプリケーションを再コンパイルすると、通常はコンパイラ エラーではなく、コンパイラの警告が発生します。 ただし、場合によってはコンパイラ エラーが発生し、旧式の型またはメンバーを使用したコードをコンパイルできないことがあります。 その場合は、旧式の型またはメンバーを呼び出すソース コードを変更してからアプリケーションを再コンパイルする必要があります。 旧式の型およびメンバーの詳細については、「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)」を参照してください。  
+  
+ [!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] のリリース以後に非推奨になった型およびメンバーの影響を評価するには、「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)」を参照してください。[!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)]、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)]、および [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] について、旧式の型およびメンバーの一覧を確認してください。
\ No newline at end of file
diff --git a/docs/framework/migration-guide/migration-guide-to-the-net-framework-4-7-4-6-and-4-5.md b/docs/framework/migration-guide/migration-guide-to-the-net-framework-4-7-4-6-and-4-5.md
new file mode 100644
index 00000000000..d60f82d4e09
--- /dev/null
+++ b/docs/framework/migration-guide/migration-guide-to-the-net-framework-4-7-4-6-and-4-5.md
@@ -0,0 +1,47 @@
+---
+title: ".NET Framework 4.6 および 4.5 移行ガイド  | Microsoft Docs"
+ms.custom: ""
+ms.date: "02/09/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework、移行する先 (アプリケーションを)"
+  - "移行、.NET Framework"
+ms.assetid: 02d55147-9b3a-4557-a45f-fa936fadae3b
+caps.latest.revision: 56
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+---
+# .NET Framework 4.6 および 4.5 移行ガイド 
+アプリを旧バージョンの .NET Framework を使用して作成した場合、通常は .NET Framework 4.5、4.5.1、または 4.6 に簡単にアップグレードできます。 Visual Studio でプロジェクトを開きます。 プロジェクトが旧バージョンで作成されている場合は、**\[Project Compatibility\]**\(プロジェクト互換性\) ダイアログ ボックスが自動的に開きます。 Visual Studio 2013 におけるプロジェクトのアップグレードの詳細については、「[方法: 旧バージョンの Visual Studio で作成されたプロジェクトをアップグレードする](http://msdn.microsoft.com/library/vstudio/ms185327\(v=vs.100\).aspx)」と「[Visual Studio プロジェクトの移植、移行、およびアップグレード](../Topic/Porting,%20Migrating,%20and%20Upgrading%20Visual%20Studio%20Projects.md)」を参照してください。  
+  
+ ただし、.NET Framework で行われたいくつかの変更により、コードを変更する必要があります。 .NET Framework 4.5、そのポイント リリース、または .NET Framework 4.6 の新しい機能を利用することもできます。 .NET Framework の新しいバージョンに対応するためのアプリに対するこの種の変更は、一般に*移行*と呼ばれます。 アプリを移行する必要がない場合、アプリは再コンパイルなしで .NET Framework 4.5 またはそれ以降のバージョンで実行できます。  
+  
+## 移行のためのリソース  
+ アプリを .NET Framework の旧バージョンから Version 4.5、4.5.1、または 4.5.2 に移行する前に、次のドキュメントを確認します。  
+  
+-   .NET Framework の各バージョンの基になる CLR バージョンを理解し、アプリを正しく対象とするためのガイドラインを確認するには、「[バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)」を参照してください。  
+  
+-   ランタイムおよびアプリに影響を与える可能性のある変更の再ターゲットについて、およびそれらの処理方法を確認するには、「[アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)」を確認します。  
+  
+-   「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)」を参照して、廃止された型またはメンバーがコードに含まれていないか調べ、また、推奨される代替の型またはメンバーを確認します。  
+  
+-   アプリに追加できる可能性のある新機能の説明については、「[新機能](../../../docs/framework/whats-new/index.md)」を参照してください。  
+  
+## 参照  
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [.NET Framework 1.1 からの移行](../../../docs/framework/migration-guide/migrating-from-the-net-framework-1-1.md)   
+ [バージョンの互換性](../../../docs/framework/migration-guide/version-compatibility.md)   
+ [バージョンおよび依存関係](../../../docs/framework/migration-guide/versions-and-dependencies.md)   
+ [方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)   
+ [新機能](../../../docs/framework/whats-new/index.md)   
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)   
+ [.NET Framework のバージョンとアセンブリ情報](http://go.microsoft.com/fwlink/?LinkId=201701)   
+ [Microsoft .NET Framework のサポート ライフサイクル ポリシー](http://go.microsoft.com/fwlink/?LinkId=196607)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-custom-imessagefilter-prefiltermessage-implementations.md b/docs/framework/migration-guide/mitigation-custom-imessagefilter-prefiltermessage-implementations.md
new file mode 100644
index 00000000000..5ac7df6510b
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-custom-imessagefilter-prefiltermessage-implementations.md
@@ -0,0 +1,53 @@
+---
+title: "軽減策: カスタムの IMessageFilter.PreFilterMessage 実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9cf47c5b-0bb2-45df-9437-61cd7e7c2f4d
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 軽減策: カスタムの IMessageFilter.PreFilterMessage 実装
+[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とする Windows フォーム アプリでは、カスタムの <xref:System.Windows.Forms.IMessageFilter.PreFilterMessage%2A?displayProperty=fullName> 実装は、<xref:System.Windows.Forms.IMessageFilter.PreFilterMessage%2A?displayProperty=fullName> 実装が次の場合に <xref:System.Windows.Forms.Application.FilterMessage%2A?displayProperty=fullName> メソッドが呼び出されると、メッセージを安全にフィルター処理することができます。  
+  
+-   次の操作のいずれか、または両方を行う場合:  
+  
+    -   <xref:System.Windows.Forms.Application.AddMessageFilter%2A> メソッドを呼び出してメッセージ フィルターを追加する。  
+  
+    -   <xref:System.Windows.Forms.Application.RemoveMessageFilter%2A> メソッドを呼び出してメッセージ フィルターを削除する。 メソッドをオーバーライドします。  
+  
+-   **および**、<xref:System.Windows.Forms.Application.DoEvents%2A?displayProperty=fullName> メソッドを呼び出してメッセージをポンプする場合。  
+  
+## 影響  
+ この変更は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とする Windows フォーム アプリにのみ影響を与えます。  
+  
+ .NET Framework の以前のバージョンを対象とする Windows フォーム アプリの場合、このような実装で、<xref:System.Windows.Forms.Application.FilterMessage%2A?displayProperty=fullName> メソッドが呼び出されると <xref:System.IndexOutOfRangeException> 例外がスローされることがあります。  
+  
+## 軽減策  
+ この変更が望ましくない場合は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とするアプリでこの変更を無効にできます。この無効化は、そのアプリの構成ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに次の構成設定を追加して行います。  
+  
+```xml  
+  
+<runtime> <AppContextSwitchOverrides value="Switch.System.Windows.Forms.DontSupportReentrantFilterMessage=true" /> </runtime>  
+  
+```  
+  
+ また、.NET Framework の以前のバージョンを対象としているが [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されているアプリでは、そのアプリの構成ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに次の構成設定を追加して、この動作を有効にできます。  
+  
+```xml  
+  
+<runtime> <AppContextSwitchOverrides value="Switch.System.Windows.Forms.DontSupportReentrantFilterMessage=false" /> </runtime>  
+  
+```  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-default-authorizationcontext.md b/docs/framework/migration-guide/mitigation-default-authorizationcontext.md
new file mode 100644
index 00000000000..79200fd4d15
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-default-authorizationcontext.md
@@ -0,0 +1,37 @@
+---
+title: "軽減策: 既定の AuthorizationContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6cfeee63-b148-429a-a7e6-6fe9b0cb7610
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 軽減策: 既定の AuthorizationContext
+`null` の `authorizationPolicies` 引数を指定して <xref:System.IdentityModel.Policy.AuthorizationContext.CreateDefaultAuthorizationContext%28System.Collections.Generic.IList%7BSystem.IdentityModel.Policy.IAuthorizationPolicy%7D%29> を呼び出したときに返される <xref:System.IdentityModel.Policy.AuthorizationContext> の実装が [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で変更されました。  
+  
+## 影響  
+ まれに、カスタム認証を使用する WCF アプリの動作に違いが生じる可能性があります。  
+  
+## 軽減策  
+ 次の 2 つの方法のいずれかで、直前の動作を復元することができます。  
+  
+-   4.6 よりも前のバージョンの .NET Framework を対象とするようにアプリを再コンパイルする。  IIS でホストされるサービスでは、`<httpRuntime targetFramework="x.x" />` の要素を使用して、以前のバージョンの .NET Framework を対象とするようにします。  
+  
+-   app.config ファイルの `<appSettings>` セクションに以下の行を追加します。  
+  
+    ```  
+    <add key="appContext.SetSwitch:Switch.System.IdentityModel.EnableCachedEmptyDefaultAuthorizationContext" value="true" />  
+    ```  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-deserialization-of-objects-across-app-domains.md b/docs/framework/migration-guide/mitigation-deserialization-of-objects-across-app-domains.md
new file mode 100644
index 00000000000..8df39b9d6f1
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-deserialization-of-objects-across-app-domains.md
@@ -0,0 +1,57 @@
+---
+title: "軽減策: アプリ ドメイン全体でのオブジェクトの逆シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 30c2d66c-04a8-41a5-ad31-646b937f61b5
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 軽減策: アプリ ドメイン全体でのオブジェクトの逆シリアル化
+場合によっては、アプリが異なるアプリケーション ベースを持つ複数のアプリ ドメインを使用すると、アプリ ドメイン間で論理呼び出しコンテキストのオブジェクトを逆シリアル化しようとして、例外がスローされます。  
+  
+## 問題の診断  
+ 問題は、次の条件の順序で発生します。  
+  
+1.  アプリケーションが異なるアプリケーション ベースを持つ複数のアプリ ドメインを使用します。  
+  
+2.  一部の型は、<xref:System.Runtime.Remoting.Messaging.LogicalCallContext> や <xref:System.Runtime.Remoting.Messaging.LogicalCallContext.SetData%2A?displayProperty=fullName> などのメソッドを呼び出して <xref:System.Runtime.Remoting.Messaging.CallContext.LogicalSetData%2A?displayProperty=fullName> に明示的に追加されます。  これらの型は、シリアル化可能としてマークされず、グローバル アセンブリ キャッシュに格納されません。  
+  
+3.  後で、既定以外のアプリ ドメインで実行されているコードは、構成ファイルから値を読み取るか、XML を使用してオブジェクトを逆シリアル化しようとします。  
+  
+4.  構成ファイルから読み取るか、オブジェクトを逆シリアル化するために、<xref:System.Xml.XmlReader> オブジェクトは構成システムにアクセスしようとします。  
+  
+5.  構成システムがまだ初期化されていないときは、初期化を完了する必要があります。  これは特に、ランタイムが次のように構成システムの固定のパスを作成する必要があることを意味します。  
+  
+    1.  これは既定以外のアプリ ドメインの証拠を検索します。  
+  
+    2.  既定のアプリ ドメインに基づいて既定以外のアプリ ドメインの証拠を計算しようとします。  
+  
+    3.  既定のアプリ ドメインの証拠を取得するための呼び出しは、既定以外のアプリ ドメインから既定のアプリ ドメインへのアプリ ドメイン間の呼び出しをトリガーします。  
+  
+    4.  .NET Framework のアプリ ドメイン間コントラクトの一部として、論理呼び出しコンテキストの内容も、アプリ ドメインの境界を越えてマーシャリングされる必要があります。  
+  
+6.  論理呼び出しコンテキストに含まれる型が既定のアプリ ドメインで解決できないため、例外がスローされます。  
+  
+## 軽減策  
+ この問題を回避するには、次を実行します  
+  
+1.  例外がスローされたときにコール スタックで `get_Evidence` の呼び出しを検索します。  この例外は、<xref:System.IO.FileNotFoundException> や <xref:System.Runtime.Serialization.SerializationException> などの例外の大きなサブセットであることもあります。  
+  
+2.  オブジェクトが論理呼び出しコンテキストに追加されないアプリ内の場所を特定して、次のコードを追加します。  
+  
+    ```  
+    System.Configuration.ConfigurationManager.GetSection("system.xml/xmlReader");  
+    ```  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-eventsource-writeevent-method-calls.md b/docs/framework/migration-guide/mitigation-eventsource-writeevent-method-calls.md
new file mode 100644
index 00000000000..ad042e87bab
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-eventsource-writeevent-method-calls.md
@@ -0,0 +1,53 @@
+---
+title: "軽減策: EventSource.WriteEvent メソッドの呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 327a9fdb-ba8e-40f7-89e5-4c89b46e594f
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 軽減策: EventSource.WriteEvent メソッドの呼び出し
+[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] は、<xref:System.Diagnostics.Tracing.EventSource?displayProperty=fullName> から派生したクラスの ETW イベント メソッドと基底クラスの <xref:System.Diagnostics.Tracing.EventSource.WriteEvent%2A> メソッド間のコントラクトを強制します。 ETW イベント メソッドは、<xref:System.Diagnostics.Tracing.EventSource.WriteEvent%2A> メソッドをイベント メソッドに渡された同じ引数が続くイベント ID に渡す必要があります。  
+  
+## 影響  
+ 次の方法で定義される ETW イベント メソッドはコントラクトを中断します。  
+  
+```  
+  
+[Event(2, Level = EventLevel.Informational)] public void Info2(string message) { base.WriteEvent(2, message, "-"); }  
+  
+```  
+  
+ このコントラクトに違反している場合、<xref:System.IndexOutOfRangeException> オブジェクトが進行中の <xref:System.Diagnostics.Tracing.EventListener> データを読み取ると <xref:System.Diagnostics.Tracing.EventSource> 例外が実行時にスローされます。  
+  
+ この ETW イベント メソッドの定義は、次のパターンに従う必要があります。  
+  
+```  
+  
+[Event(2, Level = EventLevel.Informational)] public void Info2(string message) { base.WriteEvent(2, message); }  
+  
+```  
+  
+## 軽減策  
+ 必要なパターンに準拠するように既存のコードを変更する必要があります。  
+  
+ 次のように、<xref:System.Diagnostics.Tracing.EventSource.WriteEvent%2A> メソッドを呼び出すための 2 つのメソッドを定義して変更する必要があるコードの量を次のように最小限にできます。  
+  
+```  
+  
+[NonEvent] public void Info2(string message) { Info2Internal(message, "-"); } public void Info2Internal(string message, string prefix) { WriteEvent(2, message, prefix); }  
+  
+```  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-minfreememorypercentagetoactiveservice-configuration-setting.md b/docs/framework/migration-guide/mitigation-minfreememorypercentagetoactiveservice-configuration-setting.md
new file mode 100644
index 00000000000..014afa4b781
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-minfreememorypercentagetoactiveservice-configuration-setting.md
@@ -0,0 +1,47 @@
+---
+title: "軽減策: minFreeMemoryPercentageToActiveService 構成の設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7875f26-0da8-4afe-9846-7a21778f757b
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 軽減策: minFreeMemoryPercentageToActiveService 構成の設定
+[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] では、Web サーバーの使用可能なメモリが [minFreeMemoryPercentageToActivateService](../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) 構成設定で指定されたパーセンテージより小さい場合に例外がスローされます。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、この設定は無視されます。  
+  
+## 影響  
+ ほとんどの場合、[minFreeMemoryPercentageToActivateService](../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) 設定に従うことによる影響は望ましいものです。制約されたメモリを持つシステムで Windows Communication Foundation \(WCF\) サービスが開始されるときに発生する可能性のある <xref:System.OutOfMemoryException> 例外を防ぐことによってシステムの安定性が向上します。  
+  
+ ただし、以前は正常に開始されたサービスが起動できない場合があります。  その場合、詳細なエラー メッセージが表示されます。  
+  
+```Output  
+  
+空きメモリ (nnnn バイト) が総メモリの nn% 未満であるため、メモリ ゲートの確認は失敗しました。  その結果、サービスは受け取る要求に使用できません。  これを解決するには、マシンの負荷を減らすか、serviceHostingEnvironment 構成要素の minFreeMemoryPercentageToActivateService の値を調整します。    
+```  
+  
+## 軽減策  
+ [minFreeMemoryPercentageToActivateService](../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) 設定が無視された、前の動作に戻すには、次に示すように web.config ファイルを変更します。  
+  
+```  
+  
+<serviceHostingEnvironment multipleSiteBindingsEnabled="true"   
+                           minFreeMemoryPercentageToActivateService="0">  
+   <serviceActivations>  
+   ...  
+   </serviceActivations>  
+</serviceHostingEnvironment>  
+  
+```  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-png-frames-in-icon-objects.md b/docs/framework/migration-guide/mitigation-png-frames-in-icon-objects.md
new file mode 100644
index 00000000000..737dc52e229
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-png-frames-in-icon-objects.md
@@ -0,0 +1,43 @@
+---
+title: "軽減策: Icon オブジェクトの PNG フレーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca87fefb-7144-4b4e-8832-5a939adbb4b2
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 軽減策: Icon オブジェクトの PNG フレーム
+.NET Framework 4.6 以降では、<xref:System.Drawing.Icon.ToBitmap%2A?displayProperty=fullName> メソッドで、PNG フレームを含んだアイコンを正常に <xref:System.Drawing.Bitmap> オブジェクトに変換できます。  
+  
+ .NET Framework 4.5.2 以前のバージョンを対象としたアプリでは、<xref:System.Drawing.Icon> オブジェクトに PNG フレームが含まれていると、<xref:System.Drawing.Icon.ToBitmap%2A?displayProperty=fullName> メソッドが <xref:System.ArgumentOutOfRangeException> の例外をスローします。  
+  
+## 影響  
+ この変更は、.NET Framework 4.6 を対象として再コンパイルされたアプリのうち、<xref:System.Drawing.Icon> オブジェクトに PNG フレームが含まれている場合は <xref:System.ArgumentOutOfRangeException> をスローするように特別な処理が実装されているアプリに影響します。 .NET Framework 4.6 で実行している場合は、正常に変換が行われ、<xref:System.ArgumentOutOfRangeException> がスローされることはないため、例外ハンドラーは呼び出されません。  
+  
+### 軽減策  
+ この動作に不都合がある場合は、次に示す要素を app.config ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに追加することで、以前の動作を維持できます。  
+  
+```  
+<AppContextSwitchOverrides value="Switch.System.Drawing.DontSupportPngFramesInIcons=true" />  
+  
+```  
+  
+ app.config に、すでに `AppContextSwitchOverrides` 要素が含まれている場合は、次に示すように新しい値を `value` 属性にマージする必要があります。  
+  
+```  
+<AppContextSwitchOverrides value="Switch.System.Drawing.DontSupportPngFramesInIcons=true;<previous key>=<previous value>" />  
+  
+```  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-product-versioning.md b/docs/framework/migration-guide/mitigation-product-versioning.md
new file mode 100644
index 00000000000..aea1a71eca6
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-product-versioning.md
@@ -0,0 +1,48 @@
+---
+title: "軽減策: 製品のバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c4de9d7-9aba-427a-8f38-0ab9bfb8f85e
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 軽減策: 製品のバージョン管理
+[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] および 4.6.1 では、製品のバージョン管理が .NET Framework の以前のリリース \(.NET Framework 4、4.5、4.5.1、および 4.5.2\) から変更されました。  
+  
+## 製品のバージョン管理の変更点  
+ 変更の詳細は次のとおりです。  
+  
+-   `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full` キーの `Version` エントリの値が `4.6.`*xxxxx* に変更されました。 .NET Framework 4.5、4.5.1、および 4.5.2 では `4.5.`*xxxxx* という形式でした。  
+  
+-   .NET Framework ファイルのファイルおよび製品のバージョン管理が、以前の `4.0.30319.x` というバージョン管理スキームから `4.6.X.0` に変更されました。 ファイルを右クリックしてファイルの **\[プロパティ\]** を表示すると、これらの新しい値が表示されます。  
+  
+-   マネージ アセンブリの <xref:System.Reflection.AssemblyFileVersionAttribute> 属性と <xref:System.Reflection.AssemblyInformationalVersionAttribute> 属性の <xref:System.Version> 値が `4.6.X.0` という形式になりました。  
+  
+-   [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] および 4.6.1 で、<xref:System.Environment.Version%2A?displayProperty=fullName> プロパティは、固定のバージョン文字列 `4.0.30319.42000` を返します。 .NET Framework 4、4.5、4.5.1、および 4.5.2 では、`4.0.30319.xxxxx` の形式でバージョン文字列を返していました \(例: "4.0.30319.18010"\)。 アプリケーションのコードで <xref:System.Environment.Version%2A?displayProperty=fullName> プロパティに新しい依存関係を設定することは推奨していないことに注意してください。  
+  
+### 製品のバージョン管理の変更に対する処置  
+ 一般に、.NET Framework のランタイムのバージョンやインストール ディレクトリを検出する際、アプリケーションは推奨される技法に従う必要があります。  
+  
+-   .NET Framework のランタイム バージョンを検出するには、「[方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照してください。  
+  
+-   .NET Framework のインストール パスを確認するには、`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full` キーの `InstallPath` エントリの値を使用します。  
+  
+    > [!IMPORTANT]
+    >  サブキー名は、`.NET Framework Setup` ではなく、`NET Framework Setup` です。  
+  
+-   .NET Framework の共通言語ランタイムへのディレクトリ パスを確認するには、<xref:System.Runtime.InteropServices.RuntimeEnvironment.GetRuntimeDirectory%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+-   CLR のバージョンを取得するには、<xref:System.Runtime.InteropServices.RuntimeEnvironment.GetSystemVersion%2A?displayProperty=fullName> メソッドを呼び出します。   .NET Framework 4 とそのポイント リリース \(.NET Framework 4.5、4.5.1、4.5.2、および [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] と 4.6.1\) の場合、このメソッドは文字列 `v4.0.30319` を返します。  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-tls-protocols.md b/docs/framework/migration-guide/mitigation-tls-protocols.md
new file mode 100644
index 00000000000..0ff437d0636
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-tls-protocols.md
@@ -0,0 +1,48 @@
+---
+title: "軽減策: TLS プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33f97d13-3022-43da-8b18-cdb5c88df9c2
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 軽減策: TLS プロトコル
+.NET Framework 4.6 から、<xref:System.Net.ServicePointManager?displayProperty=fullName> および <xref:System.Net.Security.SslStream?displayProperty=fullName> クラスで Tls1.0、Tls1.1、または Tls 1.2 の 3 つのプロトコルのいずれかを使用できるようになりました。  SSL3.0 プロトコルと RC4 の暗号化はサポートされていません。  
+  
+## 影響  
+ この変更は、以下のものに影響を与えます。  
+  
+-   SSL を使用して <xref:System.Net.Http.HttpClient>、<xref:System.Net.HttpWebRequest>、<xref:System.Net.FtpWebRequest>、<xref:System.Net.Mail.SmtpClient>、<xref:System.Net.Security.SslStream> のいずれかのタイプで HTTPS サーバーまたはソケット サーバーと対話するすべてのアプリ。  
+  
+-   Tls1.0、Tls1.1、または Tls 1.2 をサポートするためにアップグレードできない、すべてのサーバー サイド アプリ。  
+  
+## 軽減策  
+ 推奨される軽減策はサーバー側のアプリを Tls1.0、Tls1.1、または Tls 1.2 にアップグレードすることです。  これが現実的でない場合、またはクライアント アプリが破損している場合は、次の 2 つの方法のいずれかにより、<xref:System.AppContext> クラスを使用してこの機能を除外できます。  
+  
+-   プログラム的に。次のようにコード スニペットを使用します。  
+  
+     [!code-csharp[AppCompat.SSLProtocols#1](../../../samples/snippets/csharp/VS_Snippets_CLR/appcompat.sslprotocols/cs/program.cs#1)]
+     [!code-vb[AppCompat.SSLProtocols#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/appcompat.sslprotocols/vb/module1.vb#1)]  
+  
+     <xref:System.Net.ServicePointManager> オブジェクトの初期化が行われるのは 1 回だけなので、アプリケーションはこれらの互換性設定の定義を最初に行う必要があります。  
+  
+-   これを行うには、次の行を app.config ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに追加します。  
+  
+    ```xml  
+    <AppContextSwitchOverrides value="Switch.System.Net.DontEnableSchUseStrongCrypto=true"/>  
+    ```  
+  
+ ただし、既定の動作を除外することは、アプリケーションの安全性を低下させるので推奨されません。  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-wpf-layout.md b/docs/framework/migration-guide/mitigation-wpf-layout.md
new file mode 100644
index 00000000000..f3184e6a959
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-wpf-layout.md
@@ -0,0 +1,47 @@
+---
+title: "軽減策: WPF レイアウト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 805ffd7f-8d1e-427e-a648-601ca8ec37a5
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 軽減策: WPF レイアウト
+WPF コントロールのレイアウトは、若干変更される可能性があります。  
+  
+## 影響  
+ この変更の結果、以下のようになります。  
+  
+-   要素の幅または高さが最大で 1 ピクセル拡大または縮小することがあります。  
+  
+-   オブジェクトの配置が最大で 1 ピクセル移動することがあります。  
+  
+-   中央揃えの要素が中央から最大で 1 ピクセル垂直まは水平方向にずれることがあります。  
+  
+ 既定では、この新しいレイアウトは .NET Framework の 4.6 を対象とするアプリに対してのみ有効となります。  
+  
+## 軽減策  
+ この変更では、DPI が高いときにWPF コントロールの一番右または一番下でクリッピングの発生を除去する傾向があるため、app.config ファイルの `<runtime>` セクションに次の行を追加することによって、以前のバージョンの .NET Framework を対象としながら .NET Framework 4.6 上で実行されているアプリがこの新しい動作を選択ことができます。  
+  
+```  
+<AppContextSwitchOverrides value="Switch.MS.Internal.DoNotApplyLayoutRoundingToMarginsAndBorderThickness=false" />  
+```  
+  
+ .NET Framework 4.6 を対象としながら以前のレイアウト アルゴリズムを使用して WPF コントロールをレンダリングする必要があるアプリの場合、app.config ファイルの `<runtime>` セクションに次の行を追加することによってそれを行うことができます。  
+  
+```  
+<AppContextSwitchOverrides value="Switch.MS.Internal.DoNotApplyLayoutRoundingToMarginsAndBorderThickness=true" />  
+```  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-wpf-window-rendering.md b/docs/framework/migration-guide/mitigation-wpf-window-rendering.md
new file mode 100644
index 00000000000..8ebf5cacfb2
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-wpf-window-rendering.md
@@ -0,0 +1,49 @@
+---
+title: "軽減策: WPF ウィンドウのレンダリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28ed6bf8-141b-4b73-a4e3-44a99fae5084
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 軽減策: WPF ウィンドウのレンダリング
+Windows 8 以上で実行している [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] では、マルチ モニターのシナリオで 1 つのディスプレイの外部にウィンドウを拡張すると、ウィンドウ全体がクリッピングなしでレンダリングされます。  
+  
+## 影響  
+ 一般に、複数のモニターで、クリッピングなしでウィンドウ全体を表示することが期待の動作です。  ただし、Windows 7 以前のバージョンでは、2 つ目のモニターにウィンドウの一部をレンダリングするとパフォーマンスに大きな影響があるため、WPF ウィンドウが 1 つのディスプレイの外部に拡張されるときにはクリッピングされます。  
+  
+ Windows 8 以上で複数のモニターに WPF ウィンドウをレンダリングする際の詳細な影響は、多数の要因に依存しているために、正確に数量化することはできません。  場合によっては、グラフィックを多用するアプリケーションを実行するユーザーや複数のモニターに及ぶウィンドウを使用するユーザーの場合は特に、依然としてパフォーマンスに望ましくない影響が生じることがあります。  または、.NET Framework の複数のバージョン間で一貫性のある動作が実現できれば十分な場合もあります 。  
+  
+## 軽減策  
+ この変更を無効にして、WPF ウィンドウが 1 つのディスプレイを超える場合にクリッピングされるという、以前の動作に戻すこともできます。  これには、2 つの方法があります。  
+  
+-   `<EnableMultiMonitorDisplayClipping>` 要素をアプリケーションの構成ファイルの `<appSettings>` セクションに追加することにより、Windows 8 以降で実行中のアプリケーションでこの動作を無効にしたり有効にしたりすることができます。  たとえば、次の構成セクションにより、クリッピングなしのレンダリングが無効になります。  
+  
+    ```  
+  
+    <appSettings>  
+        <add key="EnableMultiMonitorDisplayClipping" value="true"/>  
+      </appSettings>  
+  
+    ```  
+  
+     `<EnableMultiMonitorDisplayClipping>` 構成設定には、次の 2 つの値のいずれかを指定できます。  
+  
+    -   `true` を指定すると、レンダリングの際にウィンドウをモニターの境界でクリッピングすることを有効にします。  
+  
+    -   `false` を指定すると、レンダリングの際にウィンドウをモニターの境界でクリッピングすることを無効にします。  
+  
+-   これを行うには、アプリの起動時に <xref:System.Windows.CoreCompatibilityPreferences.EnableMultiMonitorDisplayClipping%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-x509certificateclaimset-findclaims-method.md b/docs/framework/migration-guide/mitigation-x509certificateclaimset-findclaims-method.md
new file mode 100644
index 00000000000..4b64470c063
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-x509certificateclaimset-findclaims-method.md
@@ -0,0 +1,45 @@
+---
+title: "軽減策: X509CertificiateClaimSet.FindClaims メソッド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee356e3b-f932-48f5-875a-5e42340bee63
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 軽減策: X509CertificiateClaimSet.FindClaims メソッド
+[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象としたアプリを使用して開始すると、<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%2A?displayProperty=fullName> メソッドは `claimType` 引数と、その SAN フィールド内のすべての DNS エントリを一致させようとします。  
+  
+## 影響  
+ この変更は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象としたアプリにのみ影響を与えます。  
+  
+ 以前のバージョンの .NET Framework を対象としたアプリでは、<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%2A?displayProperty=fullName> メソッドは `claimType` 引数と最後の DNS エントリのみを一致させようとします。  
+  
+## 軽減策  
+ この変更が望ましくない場合は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とするアプリでこの変更を無効にできます。この無効化は、そのアプリの構成ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに次の構成設定を追加して行います。  
+  
+```xml  
+  
+<runtime> <AppContextSwitchOverrides value="Switch.System.IdentityModel.DisableMultipleDNSEntriesInSANCertificate=true" /> </runtime>  
+  
+```  
+  
+ また、.NET Framework の以前のバージョンを対象とするものの [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されているアプリでは、そのアプリの構成ファイルの [\<runtime\>](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) セクションに次の構成設定を追加して、この動作を有効にできます。  
+  
+```xml  
+  
+<runtime> <AppContextSwitchOverrides value="Switch.System.IdentityModel.DisableMultipleDNSEntriesInSANCertificate=false" /> </runtime>  
+  
+```  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/mitigation-xml-schema-validation.md b/docs/framework/migration-guide/mitigation-xml-schema-validation.md
new file mode 100644
index 00000000000..315fab3a18f
--- /dev/null
+++ b/docs/framework/migration-guide/mitigation-xml-schema-validation.md
@@ -0,0 +1,43 @@
+---
+title: "軽減策: XML スキーマ検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b73dd4f4-f2dc-47a2-9425-3896e92321fb
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 軽減策: XML スキーマ検証
+[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以降では、複合キーが使用され、1 つのキーが空の場合、XSD スキーマ検証で一意制約の違反が検出されます。  
+  
+## 影響  
+ この変更の影響は最小限のものになります。スキーマの仕様に基づき、複合キーが空のキーと共に使用されて `xsd:unique` の違反が発生した場合、スキーマの検証エラーの発生が予期されます。  
+  
+## 軽減策  
+ 複合キーに空の 1 つのキーがある場合にスキーマ検証エラーが検出されるようにするかどうかは、構成可能な機能です。  
+  
+-   [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以降を対象とするアプリでは、スキーマ検証エラーの検出は既定で有効になっています。ただし、この動作を無効にして、スキーマ検証エラーが検出されないようにすることも可能です。  
+  
+-   [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] の下で実行されているものの、[!INCLUDE[net_v452](../../../includes/net-v452-md.md)] 以前のバージョンを対象とするアプリでは、既定ではスキーマ検証エラーが検出されません。ただし、この動作を有効にして、スキーマ検証エラーが検出されるようにすることも可能です。  
+  
+ この動作は、<xref:System.AppContext> クラスを使用して `System.Xml.IgnoreEmptyKeySequences` スイッチの値を定義することにより構成できます。  スイッチの既定値が `false` \(空のキー シーケンスが無視されない\) であるため、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を対象とするアプリは、以下のコードを使用してスイッチの値を `true` に設定することにより、その動作を無効にすることができます。  
+  
+ [!code-csharp[AppCompat.IgnoreEmptyKeySequences#1](../../../samples/snippets/csharp/VS_Snippets_CLR/appcompat.ignoreemptykeysequences/cs/program.cs#1)]
+ [!code-vb[AppCompat.IgnoreEmptyKeySequences#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/appcompat.ignoreemptykeysequences/vb/module1.vb#1)]  
+  
+ [!INCLUDE[net_v452](../../../includes/net-v452-md.md)] 以前のバージョンを対象とするアプリでは、スイッチの既定値が `true` \(空のキー シーケンスが無視される\) であるため、以下のコードを使用してスイッチの値を `false` に設定することにより、複合キーに空のキーがある場合にスキーマ検証エラーを生成させることが可能です。  
+  
+ [!code-csharp[AppCompat.IgnoreEmptyKeySequences#2](../../../samples/snippets/csharp/VS_Snippets_CLR/appcompat.ignoreemptykeysequences/cs/program.cs#2)]
+ [!code-vb[AppCompat.IgnoreEmptyKeySequences#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/appcompat.ignoreemptykeysequences/vb/module1.vb#2)]  
+  
+## 参照  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/net-compatibility-diagnostics.md b/docs/framework/migration-guide/net-compatibility-diagnostics.md
new file mode 100644
index 00000000000..8e00ad4fb1e
--- /dev/null
+++ b/docs/framework/migration-guide/net-compatibility-diagnostics.md
@@ -0,0 +1,1099 @@
+---
+title: ".NET の互換性の診断 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e481270-b62a-4cb4-8dda-5b4c5b59d61d
+caps.latest.revision: 7
+author: "twsouthwick"
+ms.author: "tasou"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# .NET の互換性の診断
+.NET の互換性の診断は、.NET Framework のバージョン間のアプリケーション互換性の問題を識別できるように - の電源を Roslyn アナライザーです。 この一覧が含まれますがすべて使用可能なアナライザーのサブセットのみが、特定の移行に適用されます。 アナライザーは、どの問題が計画的な移行のためできるものだけが表面化が決まります。 問題が影響を受けるバージョンで分割するを参照してください:[アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)します。  
+  
+ 各問題には、次の情報が含まれています。  
+  
+-   以前のバージョンからの変更点の説明です。  
+  
+-   候補は、変更が顧客に与える影響し、回避策が異なるバージョン間で互換性を保持するために使用できるかどうかの説明を示します。  
+  
+-   変更はどの程度重要な評価。 アプリケーションの互換性の問題は、次のように分類されます。  
+  
+    |||  
+    |-|-|  
+    |Major|多数のアプリに影響や、コードに大幅な変更が必要な重大な変更。|  
+    |マイナー|少数のアプリに影響するか、またはコードの小さな修正が必要な変更。|  
+    |エッジ ケース|珍しいことで非常に特定のシナリオでアプリに影響を与える変更。|  
+    |透明|アプリケーションの開発者やユーザーに大きな影響をなしに変更されました。|  
+  
+-   バージョンは、変更先が表示される場合、フレームワークを示します。 一部の変更は元に戻さし、もが示されます。  
+  
+-   変更の種類:  
+  
+    |||  
+    |-|-|  
+    |再ターゲット中|変更は、新しいバージョンの .NET Framework を対象とする再コンパイルされるアプリに影響します。|  
+    |ランタイム|変更は、既存のアプリを .NET Framework の以前のバージョンを対象とは、以降のバージョンでは実行に影響します。|  
+  
+-   影響を受ける API、存在する場合。  
+  
+-   使用可能な診断の Id  
+  
+<a name="diagnostic1"></a>   
+## <a name="1-soapformatter-cannot-deserialize-hashtable-and-similar-ordered-collection-objects"></a>1: SoapFormatter には、ハッシュ テーブルが逆シリアル化できませんのような順序付けになるコレクション オブジェクト  
+  
+|||  
+|-|-|  
+|詳細|SoapFormatter では、オブジェクトが&1; つの .NET Framework のバージョンの異なるバージョンでは正常に逆シリアル化をシリアル化されることは保証されません。 具体的には、(ハッシュ テーブル) のような順序付けられたコレクションの中では、.NET 4.5 を備えた serialzied の場合と .NET 4.0 でこれらの型のオブジェクトは逆シリアル化されるように 4.0 と 4.5 間のメンバーが追加されます。 シリアル化されたデータがシリアル化して、同じバージョンの .NET Framework と逆シリアル化された場合の問題が発生しないことに注意してください。|  
+|提案される解決策|SoapFormatter シリアル化は、BinaryFormatter シリアル化または .NET Framework の変更に対応できる NetDataContractSerialization に置き換える必要があります。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter.Deserialize%28System.IO.Stream%29?displayProperty=fullName><br /><br /> <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter.Deserialize%28System.IO.Stream%2CSystem.Runtime.Remoting.Messaging.HeaderHandler%29?displayProperty=fullName><br /><br /> <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter.Serialize%28System.IO.Stream%2CSystem.Object%29?displayProperty=fullName><br /><br /> [SoapFormatter.Serialize (ストリーム オブジェクト、ヘッダー\<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter.Serialize%28System.IO.Stream%2CSystem.Object%2CSystem.Runtime.Remoting.Messaging.Header%5B%5D%29?displayProperty=fullName>|  
+|アナライザー|CD0001B<br /><br /> CD0001A|  
+  
+<a name="diagnostic3"></a>   
+## <a name="3-wpf-datatemplate-elements-are-now-visible-to-uia"></a>3: WPF DataTemplate 要素が UIA に表示されます  
+  
+|||  
+|-|-|  
+|詳細|以前は、DataTemplate 要素は、UI オートメーションを使用する表示できませんでした。 4.5 以降では、UI オートメーションではこれらの要素が検出されます。 これは、多くの場合に便利ですが、DataTemplate 要素を含まないために UIA ツリーに依存するテストを中断することができます。|  
+|提案される解決策|UI Auomation テストが必要になるこのアプリには、以前に非表示の DataTemplate 要素を含むために UIA ツリーのアカウントを更新します。 たとえば、互いの横にあるいくつかの要素を必要とするテストでは、以前非表示のために UIA 要素間の予想される必要がありますようになりました。 または、UIA 要素が必要なは、特定の数やインデックスに依存するテストが新しい値で更新します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.DataTemplate.%23ctor?displayProperty=fullName><br /><br /> <xref:System.Windows.DataTemplate.%23ctor%28System.Object%29?displayProperty=fullName>|  
+|アナライザー|CD0003|  
+  
+<a name="diagnostic4"></a>   
+## <a name="4-wpf-textbox-selected-text-appears-a-different-color-when-the-text-box-is-inactive"></a>4: WPF のテキスト ボックスが選択されているテキストでは、テキスト ボックスがアクティブでない場合、それぞれ異なる色が表示されます  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5、WPF のテキスト ボックス コントロールがアクティブでないときに (これにフォーカスがない)、選択したテキスト ボックスの内側には、コントロールがアクティブな場合に異なる色が表示されます。|  
+|提案される解決策|設定前の (.NET 4.0) 動作を復元することがあります、 [FrameworkCompatibilityPreferences.AreInactiveSelectionHighlightBrushKeysSupported](https://msdn.microsoft.com/en-us/library/system.windows.frameworkcompatibilitypreferences.areinactiveselectionhighlightbrushkeyssupported\(v=vs.110\).aspx)プロパティを false にします。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Controls.TextBox?displayProperty=fullName>|  
+|アナライザー|CD0004|  
+  
+<a name="diagnostic5"></a>   
+## <a name="5-listtforeach-can-throw-exception-when-modifying-list-item"></a>5: List<>\>.リスト項目を変更するときに、ForEach は例外をスローできます。  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5 以降で、`List<T>.ForEach`列挙子、呼び出し元のコレクション内の要素が変更された場合、InvalidOperationException 例外がスローされます。 以前は、この例外はスローされませんが、競合する可能性があります。|  
+|提案される解決策|理想的には、安全な操作ではないため、要素の列挙中にリストを変更しないでコードを修正する必要があります。 以前の動作に戻すには、ただし、アプリ可能性がありますターゲットを .NET 4.0。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Collections.Generic.List%601.ForEach%28System.Action%7B%600%7D%29?displayProperty=fullName>|  
+|アナライザー|CD0005|  
+  
+<a name="diagnostic6"></a>   
+## <a name="6-systemuri-parsing-adheres-to-rfc-3987"></a>6: RFC 3987 に準拠して System.Uri 解析  
+  
+|||  
+|-|-|  
+|詳細|URI の解析は、.NET 4.5 でのいくつかの方法で変更されました。 ただし、これらの変更に .NET 4.5 を対象としたコードのみに影響することに注意してください。 バイナリ対象 .NET 4.0 以前の動作が実行されます。 .NET 4.5 で URI の解析中の変更は次のとおりです。<br /><br /> URI 解析が正規化と文字の RFC 3987 の最新の IRI 規則に従ってチェックを実行します。<br /><br /> Unicode 正規形 C は、URI のホスト部分でのみ実行されます。<br /><br /> 無効な mailto: Uri は、例外が発生するようになりました<br /><br /> パス セグメントの最後に末尾のドットが保存されるよう<br /><br /> `file://`Uri がエスケープしない、`?`文字<br /><br /> Unicode 制御文字`U+0080`を通じて`U+009F`はサポートされていません<br /><br /> コンマ文字`,`または`%2c`は自動的にエスケープ解除されません|  
+|提案される解決策|古い .NET 4.0 URI 解析セマンティクスが多くの場合は) 必要な場合は、.NET 4.0 を対象として使用できます。 これは、TargetFrameworkAttribute またはを使用して、アセンブリでは、[プロジェクトのプロパティ] ページの Visual Studio のプロジェクト システム UI によって実現できます。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Uri.%23ctor%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Uri.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Uri.%23ctor%28System.String%2CSystem.UriKind%29?displayProperty=fullName><br /><br /> <xref:System.Uri.%23ctor%28System.Uri%2CSystem.String%29?displayProperty=fullName><br /><br /> <xref:System.Uri.TryCreate%28System.String%2CSystem.UriKind%2CSystem.Uri%40%29?displayProperty=fullName><br /><br /> <xref:System.Uri.TryCreate%28System.Uri%2CSystem.String%2CSystem.Uri%40%29?displayProperty=fullName><br /><br /> <xref:System.Uri.TryCreate%28System.Uri%2CSystem.Uri%2CSystem.Uri%40%29?displayProperty=fullName>|  
+|アナライザー|CD0006D<br /><br /> CD0006C<br /><br /> CD0006F<br /><br /> CD0006E<br /><br /> CD0006A<br /><br /> CD0006G<br /><br /> CD0006B|  
+  
+<a name="diagnostic10"></a>   
+## <a name="10-systemuri-escaping-now-supports-rfc-3986-httptoolsietforghtmlrfc3986"></a>10: System.Uri エスケープ RFC 3986 (http://tools.ietf.org/html/rfc3986) ようになりました  
+  
+|||  
+|-|-|  
+|詳細|URI のエスケープがサポートするために .NET 4.5 で変更された[RFC 3986](http://tools.ietf.org/html/rfc3986)します。 特定の変更は次のとおりです。<br /><br /> `EscapeDataString` は、予約されている文字を RFC 3986 に基づいてエスケープします。<br /><br /> `EscapeUriString` は、予約されている文字をエスケープしません。<br /><br /> `UnescapeDataString` は、無効なエスケープ シーケンスが発生した場合に例外をスローしません。<br /><br /> 予約されていないエスケープ文字はエスケープ解除されます。|  
+|提案される解決策|無効なエスケープ シーケンスの場合にスローする UnescapeDataString に依存しないアプリケーションを更新します。 このようなシーケンスする必要がありますが認識される直接します。<br /><br /> 同様に、Escaped とエスケープ解除された URI、およびデータの文字列が .NET 4.0 および .NET 4.5 で異なる場合があり、.NET のバージョン間で、直接は比較されませんを期待してください。 代わりに、解析して、比較が行われる前に、1 つの .NET バージョンで正規化します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Uri.EscapeDataString%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Uri.EscapeUriString%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Uri.UnescapeDataString%28System.String%29?displayProperty=fullName>|  
+|アナライザー|CD0010A<br /><br /> CD0010B<br /><br /> CD0010C|  
+  
+<a name="diagnostic11"></a>   
+## <a name="11-systemnetpeertopeercollaboration-unavailable-on-windows-8"></a>11: System.Net.PeerToPeer.Collaboration Windows 8 で使用できなくなった  
+  
+|||  
+|-|-|  
+|詳細|System.Net.PeerToPeer.Collaboration 名前空間は、Windows 8 またはそれ以降には使用できません。|  
+|提案される解決策|Windows 8 をサポートするか、上、この名前空間またはそのメンバーに依存しないに更新する必要があるアプリ。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Net.PeerToPeer.Collaboration?displayProperty=fullName>|  
+|アナライザー|CD0011|  
+  
+<a name="diagnostic12"></a>   
+## <a name="12-mef-catalogs-implement-ienumerable-and-therefore-can-no-longer-be-used-to-create-a-serializer"></a>12: MEF カタログは、IEnumerable を実装しが不要になったため、シリアライザーを作成  
+  
+|||  
+|-|-|  
+|詳細|以降、.NET Framework 4.5 では、MEF カタログは IEnumerable を実装しは不要になったため、シリアライザー (XmlSerializer オブジェクト) を作成します。 MEF カタログをシリアル化しようとすると、例外がスローされます。|  
+|提案される解決策|シリアライザーの作成に MEF を使用しないことができます。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0012|  
+  
+<a name="diagnostic13"></a>   
+## <a name="13-missing-target-framework-moniker-results-in-40-behavior"></a>13: ターゲット フレームワーク モニカーのない 4.0 の動作になります  
+  
+|||  
+|-|-|  
+|詳細|アプリケーションは、せず、 [TargetFrameworkAttribute](https://msdn.microsoft.com/en-us/library/system.runtime.versioning.targetframeworkattribute\(v=vs.110\).aspx)アセンブリ レベルで自動的に実行されます (quirks) の .NET Framework 4.0 のセマンティクスを使用して適用します。 高品質の確保、するバイナリはすべて明示的に属性を設定すると、ビルドされた .NET Framework のバージョンを示す TargetFrameworkAttribute をお勧めします。 Caues、TargetFrameworkAttribute を自動的に適用するために MSBuild をプロジェクト ファイルで、ターゲット フレームワーク モニカーを使用することに注意してください。|  
+|提案される解決策|A[ターゲット フレームワーク属性](https://msdn.microsoft.com/en-us/library/system.runtime.versioning.targetframeworkattribute\(v=vs.110\).aspx)のいずれかによって、直接アセンブリまたはでターゲット フレームワークを指定することによって、属性を追加することを指定する必要があります、[プロジェクト ファイルまたは Visual Studio でプロジェクトのプロパティの GUI](http://blogs.msdn.com/b/visualstudio/archive/2010/05/19/visual-studio-managed-multi-targeting-part-1-concepts-target-framework-moniker-target-framework.aspx)します。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0013|  
+  
+<a name="diagnostic14"></a>   
+## <a name="14-no-longer-able-to-set-enableviewstatemac-to-false"></a>14: EnableViewStateMac を false に設定することが不要になった  
+  
+|||  
+|-|-|  
+|詳細|ASP.NET でを指定する開発者は、不要になった`<pages enableViewStateMac="false"/>`または`<@Page EnableViewStateMac="false" %>`です。 ビュー ステートのメッセージ認証コード (MAC) は、ビュー ステートが埋め込まれたすべての要求に強制されています。 明示的に EnableViewStateMac プロパティを false に設定するだけのアプリが影響を受けます。|  
+|提案される解決策|EnableViewStateMac は true に設定すると想定する必要があり、結果として得られる MAC エラーを解決する必要があります (で説明したよう[この](https://support.microsoft.com/en-us/kb/2915218)ガイダンスについては、MAC エラーの原因の詳細によって複数の解像度が含まれています)。|  
+|スコープ|Major|  
+|バージョン|4.5.2|  
+|型|ランタイム|  
+|アナライザー|CD0014|  
+  
+<a name="diagnostic18"></a>   
+## <a name="18-blockingcollectionttrytakefromany-does-not-throw-anymore"></a>18: BlockingCollection<>\>します。TryTakeFromAny がもはやスローしません。  
+  
+|||  
+|-|-|  
+|詳細|入力コレクションの&1; つは、マークされている場合、完了した`BlockingCollection<T>.TryTakeFromAny(BlockingCollection<T>[], T)`-1 が返されなくと`BlockingCollection<T>.TakeFromAny`不要になった例外をスローします。 この変更の結果、コレクションの&1; つが空であったり完了していても、他のコレクションに取得できる項目がある場合にコレクションで作業をすることができるようになりました。|  
+|提案される解決策|このようなコードを使用する変更ようになりました TryTakeFromAny-1 または TakeFromAny をスローすることを返す、完了しているときにブロッキング コレクションの場合、制御フローの目的で使用されていた場合`.Any(b => b.IsCompleted)`その状態を検出します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|[BlockingCollection<>\>します。TakeFromAny (BlockingCollection<>\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%29?displayProperty=fullName><br /><br /> [BlockingCollection<>\>します。TakeFromAny (BlockingCollection<>\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> [BlockingCollection<>\>します。TryTakeFromAny (BlockingCollection<>\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%29?displayProperty=fullName><br /><br /> [BlockingCollection<>\>します。TryTakeFromAny (BlockingCollection<>\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%2CSystem.Int32%29?displayProperty=fullName><br /><br /> [BlockingCollection<>\>します。TryTakeFromAny (BlockingCollection<>\>\<xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%28System.Collections.Concurrent.BlockingCollection%7B%600%7D%5B%5D%2C%600%40%2CSystem.TimeSpan%29?displayProperty=fullName>|  
+|アナライザー|CD0018A<br /><br /> CD0018B|  
+  
+<a name="diagnostic19"></a>   
+## <a name="19-xmlschemaexception-now-sets-line-positions-properly"></a>19: XmlSchemaException セット位置を正しく整列するようになりました  
+  
+|||  
+|-|-|  
+|詳細|LoadOptions.SetLineInfo 値は、Load メソッドに渡される、検証エラーが発生した場合は、XmlSchemaException.LineNumber と XmlSchemaException.LinePosition プロパティが行情報には含まれています。|  
+|提案される解決策|例外処理コード XmlSchemaException.LineNumber と XmlSchemaException.LinePosition が想定することはできませんので、これらのプロパティは今すぐを適切に設定 SetLineInfo を XML の読み込み中に使用する場合、セットを更新する必要があります。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Xml.Linq.LoadOptions?displayProperty=fullName>|  
+|アナライザー|CD0019|  
+  
+<a name="diagnostic20"></a>   
+## <a name="20-systemactivities-is-now-aptca"></a>20: System.Activities は APTCA はようになりました。  
+  
+|||  
+|-|-|  
+|詳細|アセンブリは、AllowPartiallyTrustedCallersAttribute 属性でマークされています。|  
+|提案される解決策|派生クラスは、SecurityCriticalAttribute でマークすることはできません。 以前は、派生型は、SecurityCriticalAttribute でマークする必要があります。 ただし、この変更によって生じる実質的な影響はないはずです。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0020|  
+  
+<a name="diagnostic21"></a>   
+## <a name="21-workflow-30-types-are-obsolete"></a>21: 3.0 のワークフローの種類が廃止されています  
+  
+|||  
+|-|-|  
+|詳細|Windows Workflow Foundation (WWF) 3.0 Api (System.Workflow 名前空間のもの) は廃止されたようになりました。|  
+|提案される解決策|新しい WWF 4.0 Api (System.Activities) は、代わりに使用する必要があります。 新しい Api を使用する例をご覧[ここ](https://msdn.microsoft.com/en-us/library/jj205427.aspx)ガイダンスについてはさらに、[ここ](http://blogs.msdn.com/b/workflowteam/archive/2012/02/08/deprecatingwf3.aspx)します。 または、WWF 3.0 Api がまだサポートされているは、使用される可能性はされ、それを抑制することによって、または以前のコンパイラを使用して、ビルド時に警告が回避されます。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|アナライザー|CD0021|  
+  
+<a name="diagnostic22"></a>   
+## <a name="22-some-workflow-drag-and-drop-apis-are-obsolete"></a>22: 一部のワークフローのドラッグ アンド ドロップ Api が廃止されています  
+  
+|||  
+|-|-|  
+|詳細|このワークフローのドラッグ アンド ドロップ API は今後使用しませんし、4.5 に対して、アプリケーションが再構築する場合は、コンパイラの警告が発生します。|  
+|提案される解決策|新しい[DragDropHelper](https://msdn.microsoft.com/en-us/library/system.activities.presentation.dragdrophelper\(v=vs.110\).aspx)複数のオブジェクトで操作をサポートする Api を代わりに使用する必要があります。 または、ビルド警告を抑制するか、古いコンパイラを使用してそれらを回避できます。 Api は引き続きサポートされます。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Activities.Presentation.DragDropHelper.DoDragMove%28System.Activities.Presentation.WorkflowViewElement%2CSystem.Windows.Point%29?displayProperty=fullName><br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetCompositeView%28System.Windows.DragEventArgs%29?displayProperty=fullName><br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetDraggedModelItem%28System.Windows.DragEventArgs%29?displayProperty=fullName><br /><br /> <xref:System.Activities.Presentation.DragDropHelper.GetDroppedObject%28System.Windows.DependencyObject%2CSystem.Windows.DragEventArgs%2CSystem.Activities.Presentation.EditingContext%29?displayProperty=fullName>|  
+|アナライザー|CD0022|  
+  
+<a name="diagnostic23"></a>   
+## <a name="23-new-ambiguous-dispatcherinvoke-overloads-could-result-in-different-behavior"></a>23: 新しい (あいまい) Dispatcher.Invoke オーバー ロードは、異なる動作になる可能性があります  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 では、System.Action 型のパラメーターを含む Dispatcher.Invoke に新しいオーバー ロードを追加します。 既存のコードを再コンパイルすると、コンパイラは、デリゲートのパラメーターを持つ System.Action パラメーターを持つ Dispatcher.Invoke メソッドへの呼び出しとして Dispatcher.Invoke メソッドの呼び出しを解決します。 デリゲートのパラメーターを持つ Dispatcher.Invoke オーバー ロードの呼び出しが System.Action パラメーターを持つ Dispatcher.Invoke オーバー ロードの呼び出しとして解決されると動作に次の違いが発生します。<br /><br /> 例外が発生する場合、Dispatcher.UnhandledExceptionFilter と Dispatcher.UnhandledException イベントは発生しません。 代わりに、例外は、UnobservedTaskException イベントによって処理されます。<br /><br /> DispatcherOperation.Result などの一部のメンバーへの呼び出しは、操作が完了するまでブロックします。|  
+|提案される解決策|呼び出し元の Dispatcher.Invoke をコードではあいまいさ (および考えられる相違点の処理動作をブロックまたは例外) を渡すことが空のオブジェクトの 2 番目のパラメーターとして、.NET 4.0 メソッドのオーバー ロードに解決されるように、呼び出し。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|[Dispatcher.Invoke (委任、オブジェクトで\<xref:System.Windows.Threading.Dispatcher.Invoke%28System.Delegate%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> [Dispatcher.Invoke (デリゲート、TimeSpan、オブジェクト\<xref:System.Windows.Threading.Dispatcher.Invoke%28System.Delegate%2CSystem.TimeSpan%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> [Dispatcher.Invoke (オブジェクトの代理人、TimeSpan、dispatcherpriority および、\<xref:System.Windows.Threading.Dispatcher.Invoke%28System.Delegate%2CSystem.TimeSpan%2CSystem.Windows.Threading.DispatcherPriority%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> [Dispatcher.Invoke (デリゲート、dispatcherpriority および、オブジェクト\<xref:System.Windows.Threading.Dispatcher.Invoke%28System.Delegate%2CSystem.Windows.Threading.DispatcherPriority%2CSystem.Object%5B%5D%29?displayProperty=fullName>|  
+|アナライザー|CD0023|  
+  
+<a name="diagnostic24"></a>   
+## <a name="24-encoderparameter-ctor-is-obsolete"></a>24: EncoderParameter ctor は今後使用しません  
+  
+|||  
+|-|-|  
+|詳細|`EncoderParameter.EncoderParameter(Encoder, Int32, Int32, Int32)`コンス トラクターは廃止されましたと使用されている場合は、ビルドの警告が発生します。|  
+|提案される解決策|ただし、`EncoderParameter.EncoderParameter(Encoder, Int32, Int32, Int32)`コンス トラクターは引き続き動作、次のコンス トラクターは .NET 4.5 のツールを使用してコードを再コンパイルするときに、古いビルド警告を回避する代わりに使用する必要があります: [EncoderParameter.EncoderParameter (エンコーダー、Int32、EncoderParameterValueType、IntPtr)](https://msdn.microsoft.com/en-us/library/hh875096\(v=vs.110\).aspx)します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Drawing.Imaging.EncoderParameter.%23ctor%28System.Drawing.Imaging.Encoder%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName>|  
+|アナライザー|CD0024|  
+  
+<a name="diagnostic26"></a>   
+## <a name="26-change-in-behavior-for-taskwaitall-methods-with-time-out-arguments"></a>26: Task.WaitAll メソッド タイムアウト引数を使用した場合の動作の変更  
+  
+|||  
+|-|-|  
+|詳細|Task.WaitAll 動作は、.NET 4.5 でより一貫性のある行われました。<br /><br /> .NET Framework 4 でこれらのメソッドは一貫性がない動作です。 1 つまたは複数のタスクが完了したか、メソッド呼び出しの前に取り消される場合、タイムアウトが期限切れ、メソッドには、AggregateException 例外がスローされました。 タイムアウトの期限が切れたタスクはありませんが完了またはメソッド呼び出しの前に取り消された&1; つまたは複数のタスクがこれらの状態、メソッドを呼び出した後、このメソッドが false 返されます。<br />.NET Framework 4.5 でこれらのメソッド オーバー ロード返すようになりましたされたタイムアウト期間の期限が切れて、(かどうか、メソッドの呼び出しの前後にでした) に関係なく、入力タスクが取り消されましたおよびその他のタスクがまだ実行されていない場合にのみ、AggregateException 例外をスローするときに、すべてのタスクが実行中の場合は false。|  
+|提案される解決策|コードを IsCanceled プロパティを使用して同じ検出の実行で代わりに呼び出されている WaitAll 呼び出しの前にキャンセルされたタスクを検出するための手段として、AggregateException を受けたされている場合 (例: です。任意 (t t.IsCanceled =>))、タイムアウトする前に待機中のすべてのタスクが完了した場合、.NET 4.6 はその場合にスローのみためです。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|[Task.WaitAll (タスク\<xref:System.Threading.Tasks.Task.WaitAll%28System.Threading.Tasks.Task%5B%5D%2CSystem.Int32%29?displayProperty=fullName><br /><br /> [Task.WaitAll (タスク\<xref:System.Threading.Tasks.Task.WaitAll%28System.Threading.Tasks.Task%5B%5D%2CSystem.Int32%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> [Task.WaitAll (タスク\<xref:System.Threading.Tasks.Task.WaitAll%28System.Threading.Tasks.Task%5B%5D%2CSystem.TimeSpan%29?displayProperty=fullName>|  
+|アナライザー|CD0026|  
+  
+<a name="diagnostic27"></a>   
+## <a name="27-change-in-behavior-in-data-definition-language-ddl-apis"></a>27: データ定義言語 (DDL) の Api の動作の変更  
+  
+|||  
+|-|-|  
+|詳細|AttachDBFilename を指定すると、DDL Api の動作が次のように変更されました。<br /><br /> 接続文字列は、初期カタログ値を指定しなかった必要があります。 以前は、AttatchDBFilename と初期カタログの両方は必要でした。<br /><br /> AttatchDBFilename と初期カタログの両方が指定された所定の MDF ファイルが存在する場合は、ObjectContext.DatabaseExists メソッドは true を返します。 以前は、false 返されます。<br /><br /> AttatchDBFilename と初期カタログの両方が指定された所定の MDF ファイルが存在する場合、ObjectContext.DeleteDatabase メソッドを呼び出すと、ファイルが削除されます。<br /><br /> ObjectContext.DeleteDatabase は、接続文字列が存在しない MDF および、初期カタログが存在しないことを持つ AttachDBFilename の値を指定するときに呼び出されますが、メソッドは InvalidOperationException 例外をスローします。 以前は、SqlException 例外がスローされました。|  
+|提案される解決策|これらの変更により、DDL API を使用するアプリケーションおよびツールの構築が簡単になりました。 これらの変更は、次のシナリオでアプリケーションの互換性に影響を及ぼす可能性があります。<br /><br /> ObjectContext.DatabaseExists true が返されます DROP DATABASE コマンドを呼び出し元の ObjectContext.DeleteDatabase ではなく直接実行するコードをユーザーが作成されます。 データベースがアタッチされておらず、MDF ファイルが存在する場合、これによって既存のコードが破損します。<br /><br /> ユーザーは、初期カタログと MDF ファイルが存在しない場合、InvalidOperationException 例外ではなく、SqlException 例外をスローする ObjectContext.DeleteDatabase メソッドを要求するコードを作成します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0027|  
+  
+<a name="diagnostic28"></a>   
+## <a name="28-machinekeyencode-and-machinekeydecode-methods-are-now-obsolete"></a>28: MachineKey.Encode および MachineKey.Decode メソッドは、使用されなくなりました  
+  
+|||  
+|-|-|  
+|詳細|これらのメソッドは今後使用しません。 これらのメソッドを呼び出すコードをコンパイルすると、コンパイラ警告が生成されます。|  
+|提案される解決策|推奨される代替手段は[MachineKey.Protect](https://msdn.microsoft.com/en-us/library/system.web.security.machinekey.protect\(v=vs.110\).aspx)と[MachineKey.Unprotect](https://msdn.microsoft.com/en-us/library/system.web.security.machinekey.unprotect\(v=vs.110\).aspx)します。 または、ビルド警告を抑制するか、古いコンパイラを使用してそれらを回避できます。 Api は引き続きサポートされます。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Web.Security.MachineKey.Decode%28System.String%2CSystem.Web.Security.MachineKeyProtection%29?displayProperty=fullName><br /><br /> [MachineKey.Encode (バイト\<xref:System.Web.Security.MachineKey.Encode%28System.Byte%5B%5D%2CSystem.Web.Security.MachineKeyProtection%29?displayProperty=fullName>|  
+|アナライザー|CD0028|  
+  
+<a name="diagnostic29"></a>   
+## <a name="29-the-replace-method-in-odata-urls-is-disabled-by-default"></a>29: OData Url の置換メソッドが既定で無効になっています  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 以降では、OData Url の Replace メソッドは既定で無効にします。 (既定) は、OData の置換が無効である場合 (これは一般的ではない)、replace 関数を含むユーザーの要求は失敗します。|  
+|提案される解決策|Replace メソッドが必要な場合 (これは通常ありません) を再度有効にできます、[構成設定を](https://msdn.microsoft.com/en-us/library/system.data.services.configuration.dataservicesfeaturessection.replacefunction.aspx)します。 ただし、有効になっている replace メソッドを使用して、セキュリティの脆弱性を開く、注意深くレビュー後でのみ使用する必要があります。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Data.Services.DataService%601?displayProperty=fullName>|  
+|アナライザー|CD0029|  
+  
+<a name="diagnostic30"></a>   
+## <a name="30-systemservicemodelwebwebservicehost-object-no-longer-adds-a-default-endpoint"></a>30: System.ServiceModel.Web.WebServiceHost オブジェクトが不要になったに既定のエンドポイントを追加  
+  
+|||  
+|-|-|  
+|詳細|System.ServiceModel.Web.WebServiceHost オブジェクトは、不要になったにはアプリケーション コードで明示的なエンドポイントが追加された場合、既定のエンドポイントの機能を追加します。|  
+|提案される解決策|ユーザーは、既定のエンドポイントに接続できると期待して、他の明示的なエンドポイントは、WebServiceHost に追加されている場合は、既定のエンドポイントが明示的に追加も必要があります (AddDefaultEndpoints を使用)。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%28System.Type%2CSystem.ServiceModel.Channels.Binding%2CSystem.String%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%28System.Type%2CSystem.ServiceModel.Channels.Binding%2CSystem.String%2CSystem.Uri%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%28System.Type%2CSystem.ServiceModel.Channels.Binding%2CSystem.Uri%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%28System.Type%2CSystem.ServiceModel.Channels.Binding%2CSystem.Uri%2CSystem.Uri%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHostBase.AddServiceEndpoint%28System.ServiceModel.Description.ServiceEndpoint%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHostBase.AddServiceEndpoint%28System.String%2CSystem.ServiceModel.Channels.Binding%2CSystem.String%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHostBase.AddServiceEndpoint%28System.String%2CSystem.ServiceModel.Channels.Binding%2CSystem.String%2CSystem.Uri%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHostBase.AddServiceEndpoint%28System.String%2CSystem.ServiceModel.Channels.Binding%2CSystem.Uri%29?displayProperty=fullName><br /><br /> <xref:System.ServiceModel.ServiceHostBase.AddServiceEndpoint%28System.String%2CSystem.ServiceModel.Channels.Binding%2CSystem.Uri%2CSystem.Uri%29?displayProperty=fullName>|  
+|アナライザー|CD0030A<br /><br /> CD0030B|  
+  
+<a name="diagnostic31"></a>   
+## <a name="31-eventsourcewriteevent-impls-must-pass-writeevent-the-same-parameters-that-it-received-plus-id"></a>31: EventSource.WriteEvent impls WriteEvent 渡す必要があります (ID) および受け取った同じパラメーター  
+  
+|||  
+|-|-|  
+|詳細|ランタイムは、次を指定するコントラクトを強制するようになりました: ETW イベント メソッドを定義する EventSource から派生したクラスは、ETW イベント メソッドに渡された同じ引数が続くイベント ID を持つ EventSource.WriteEvent メソッドの基本クラスを呼び出す必要があります。|  
+|提案される解決策|EventListener がこのコントラクトに違反するイベント ソースのプロセス内の EventSource データを読み取り、IndexOutOfRangeException 例外がスローされます。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|ランタイム|  
+|アナライザー|CD0031|  
+  
+<a name="diagnostic32"></a>   
+## <a name="32-minfreememorypercentagetoactiveservice-is-now-respected"></a>32: MinFreeMemoryPercentageToActiveService が順守ようになりました  
+  
+|||  
+|-|-|  
+|詳細|WCF サービスをアクティブ化する前に、サーバーで使用する必要がある最小メモリを設定します。 OutOfMemoryException 例外を回避する設計します。 .NET Framework 4.5 では、この設定には効果はありません。 .NET Framework 4.5.1 で、設定を確認します。|  
+|提案される解決策|Web サーバーで使用できる空きメモリが構成設定によって定義されたパーセンテージよりも小さい場合、例外が発生します。 制約されたメモリ環境で正常に開始し、実行された WCF サービスが今度は失敗することがあります。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|ランタイム|  
+|アナライザー|CD0032|  
+  
+<a name="diagnostic33"></a>   
+## <a name="33-xmltextreader-dtd-entity-expansion-is-limited-to-10000000-characters"></a>33: XmlTextReader DTD エンティティの展開が 10,000, 000 文字に制限されます。  
+  
+|||  
+|-|-|  
+|詳細|DTD エンティティの展開が、10,000, 000 文字に制限されます。 DTD エンティティの展開を使用しない XML ファイルの読み込みや、制限された DTD エンティティの展開を使用した XML ファイルの読み込みは、影響を受けません。 DTD エンティティの展開が 10,000,000 文字を超えるファイルは読み込みに失敗し、例外をスローします。|  
+|提案される解決策|値をオーバーライドできる DTD エンティティの展開の制限が低すぎる 10,000, 000 の場合、 [XmlReaderSettings.MaxCharactersFromEntities](https://msdn.microsoft.com/en-us/library/system.xml.xmlreadersettings.maxcharactersfromentities%28v=vs.110%29.aspx)プロパティです。 適切な MaxCharactersFromEntity 値を持つ、XmlReaderSettings を渡すことができる[XmlReader.Create](https://msdn.microsoft.com/en-us/library/System.Xml.XmlReader.Create\(v=vs.110\).aspx)|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Xml.XmlTextReader.%23ctor?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.IO.Stream%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.IO.Stream%2CSystem.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.IO.Stream%2CSystem.Xml.XmlNodeType%2CSystem.Xml.XmlParserContext%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.IO.TextReader%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.IO.TextReader%2CSystem.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.IO.Stream%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.IO.Stream%2CSystem.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.IO.TextReader%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.IO.TextReader%2CSystem.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.String%2CSystem.Xml.XmlNodeType%2CSystem.Xml.XmlParserContext%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader.%23ctor%28System.Xml.XmlNameTable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.XmlTextReader?displayProperty=fullName>|  
+|アナライザー|CD0033|  
+  
+<a name="diagnostic35"></a>   
+## <a name="35-xslt-style-sheet-exception-message-changed"></a>35: XSLT スタイル シートの例外のメッセージの変更  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 では、XSLT ファイルが複雑すぎる場合のエラー メッセージのテキストは"、スタイル シートが複雑すぎます" 以前のバージョンのエラー メッセージは 「XSLT コンパイル エラー」でした。 エラー メッセージのテキストに依存するアプリケーション コードは機能しなくなります。 ただし、例外の種類、同じまま、この変更は実際の影響があるないためです。|  
+|提案される解決策|このエラー状態から新しいメッセージを期待する excepton メッセージによってアプリケーション コードを更新しますか (さらに良い点) 例外の種類のみに依存するコードを更新 ([XsltException](https://msdn.microsoft.com/en-us/library/system.xml.xsl.xsltexception\(v=vs.110\).aspx))、これは変更されていません。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|[XslCompiledTransform.Load (MethodInfo、バイト\[\]、型\<xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Reflection.MethodInfo%2CSystem.Byte%5B%5D%2CSystem.Type%5B%5D%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.String%2CSystem.Xml.Xsl.XsltSettings%2CSystem.Xml.XmlResolver%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Type%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Xml.XPath.IXPathNavigable%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Xml.XPath.IXPathNavigable%2CSystem.Xml.Xsl.XsltSettings%2CSystem.Xml.XmlResolver%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Xml.XmlReader%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Xml.XmlReader%2CSystem.Xml.Xsl.XsltSettings%2CSystem.Xml.XmlResolver%29?displayProperty=fullName>|  
+|アナライザー|CD0035|  
+  
+<a name="diagnostic36"></a>   
+## <a name="36-wf-serializes-expressionsliteralt-datetimes-differently-now-breaks-custom-xaml-parsers"></a>36: WF Expressions.Literal をシリアル化<>\> DateTimes が異なるので (カスタム XAML パーサーを区切り)  
+  
+|||  
+|-|-|  
+|詳細|関連付けられた[ValueSerializer](https://msdn.microsoft.com/en-us/library/system.windows.markup.valueserializer\(v=vs.110\).aspx)オブジェクトは DateTime または DateTimeOffset オブジェクト変換、秒、ミリ秒のコンポーネントが含まれるが&0; 以外であり (DateTime の値) が DateTime.Kind プロパティは文字列ではなくプロパティ要素構文に指定されていない使用されません。 この変更は、ラウンドト リップする DateTime と DateTimeOffset の値を許可します。 入力 XAML が属性構文であると想定するカスタム XAML パーサーは正しく機能しません。|  
+|提案される解決策|この変更は、ラウンドト リップする DateTime と DateTimeOffset の値を許可します。 入力 XAML が属性構文であると想定するカスタム XAML パーサーは正しく機能しません。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0036|  
+  
+<a name="diagnostic37"></a>   
+## <a name="37-new-enum-values-in-wpfs-pagerangeselection"></a>37: WPF の PageRangeSelection で新しい列挙値  
+  
+|||  
+|-|-|  
+|詳細|2 つの新しいメンバー (CurrentPage および SelectedPage) に追加された、 [PageRangeSelection](https://msdn.microsoft.com/en-us/library/system.windows.controls.pagerangeselection\(v=vs.110\).aspx)列挙型。|  
+|提案される解決策|ほとんどの場合、これらの変更はユーザー コードに影響しません。 型変更する必要が、ただし PageRangeSelection で Enum.GetNames または Enum.GetValues で既存の要素の特定の数に依存するコードを呼び出します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Controls.PageRangeSelection?displayProperty=fullName>|  
+|アナライザー|CD0037|  
+  
+<a name="diagnostic38"></a>   
+## <a name="38-wpf-dispatchersynchronizationcontextcreatecopy-now-returns-a-new-copy-instead-of-the-current-instance"></a>38: WPF DispatcherSynchronizationContext.CreateCopy が現在のインスタンスではなく新しいコピーを返すようになりました  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4 で DispatcherSynchronizationContext.CreateCopy() には、パフォーマンスの最適化として、主に、現在のインスタンスへの参照が返されます。 .NET Framework 4.5 では、これにより、最初に等しい値の参照は、実行中のスレッドが正しく同期コンテキストで指定を完了するまでに新しいインスタンスを返します。  これらの参照の id をチェックするコードに影響は、.NET Framework 4.5 への移行の一部として変更されるため、DispatcherSynchronizationContext.CreateCopy を呼び出すコードをテストする必要がありますがありそうにない、またはそれ以降をお勧めします。|  
+|提案される解決策|DispatcherSynchronizationContext.CreateCopy() は新しい SynchronizationContext オブジェクトを返すようになりましたことに注意してください。  以前は、このように生成された参照の等価性を使用するコードが実際に確認していませんかどうか、適切な状況でがに対して .NET 4.5 以降のビルド時に。  問題が発生するまれに、影響を受けるコード パスを使用することできるようこの場合の問題であるかどうかを判断します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Threading.DispatcherSynchronizationContext.CreateCopy?displayProperty=fullName>|  
+|アナライザー|CD0038|  
+  
+<a name="diagnostic39"></a>   
+## <a name="39-systemthreadingtaskstask-no-longer-throw-objectdisposedexception-after-object-is-disposed"></a>39: System.Threading.Tasks.Task は、オブジェクトが破棄された後に不要になった ObjectDisposedException をスロー  
+  
+|||  
+|-|-|  
+|詳細|Task.IAsyncResult.AsyncWaitHandle、を除き System.Threading.Tasks.Task メソッドでは、オブジェクトが破棄された後に ObjectDisposedException 例外が不要になったスローします。<br />この変更により、キャッシュされたタスクを使用できるようになりました。 たとえば、メソッドで新しいタスクを割り当てる代わりに、既に完了した操作を表す、キャッシュされたタスクを返すことができます。 これは、タスクの任意のコンシューマーによって破棄されてしまうと、使用不可能になってしまう以前の .NET Framework のバージョンでは不可能でした。|  
+|提案される解決策|タスク メソッドが不要になった ObjectDisposedExceptions 場合にスロー オブジェクトが破棄されるときに注意してください。 タスクのステータスを明示的にチェックする更新するか、アプリをタスクが破棄されたことを確認するには、この例外に依存していた場合を使用して[Task.Status](https://msdn.microsoft.com/en-us/library/system.threading.tasks.task.status\(v=vs.110\).aspx)します。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0039|  
+  
+<a name="diagnostic40"></a>   
+## <a name="40-different-exception-handling-for-objectcontextcreatedatabase-and-dbproviderservicescreatedatabase-methods"></a>40: ObjectContext.CreateDatabase および DbProviderServices.CreateDatabase メソッドで処理する別の例外  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5 以降で、データベースの作成が失敗した場合、`CreateDatabase`メソッドは、空のデータベースを削除しようとしています。 その操作が成功すると、元の`SQLException`伝達されます (の代わりに、 `InvalidOperationException` .NET 4.0 でを常がスローされました)|  
+|提案される解決策|ObjectContext.CreateDatabase または DbProviderServices.CreateDatabase 実行中に、InvalidOperationException をキャッチするときに SQLExceptions を今すぐもして捕捉されます。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Data.Common.DbProviderServices.CreateDatabase%28System.Data.Common.DbConnection%2CSystem.Nullable%7BSystem.Int32%7D%2CSystem.Data.Metadata.Edm.StoreItemCollection%29?displayProperty=fullName><br /><br /> <xref:System.Data.Objects.ObjectContext.CreateDatabase?displayProperty=fullName>|  
+|アナライザー|CD0040|  
+  
+<a name="diagnostic41"></a>   
+## <a name="41-objectcontexttranslate-and-objectcontextexecutestorequery-now-support-enum-type"></a>41: ObjectContext.Translate と ObjectContext.ExecuteStoreQuery 列挙型をサポート  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.0 では、ジェネリック パラメーターで`T`の`ObjectContext.Translate`と`ObjectContext.ExecuteStoreQuery`メソッドを列挙できませんでした。 このシナリオはサポートされています。|  
+|提案される解決策|.NET 4.0 で列挙型 翻訳 または ExecuteStoreQuery が呼び出される場合は、'0' が返されました。 動作をすることが望ましい場合は、定数 0 (またはその列挙型と同等) の呼び出しを置き換えてください。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|[ObjectContext.ExecuteStoreQuery<>\>(文字列, オブジェクト\<xref:System.Data.Objects.ObjectContext.ExecuteStoreQuery%60%601%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> [ObjectContext.ExecuteStoreQuery<>\>(オブジェクトの文字列、文字列、MergeOption、\<xref:System.Data.Objects.ObjectContext.ExecuteStoreQuery%60%601%28System.String%2CSystem.String%2CSystem.Data.Objects.MergeOption%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> <xref:System.Data.Objects.ObjectContext.Translate%60%601%28System.Data.Common.DbDataReader%29?displayProperty=fullName><br /><br /> <xref:System.Data.Objects.ObjectContext.Translate%60%601%28System.Data.Common.DbDataReader%2CSystem.String%2CSystem.Data.Objects.MergeOption%29?displayProperty=fullName>|  
+|アナライザー|CD0041|  
+  
+<a name="diagnostic42"></a>   
+## <a name="42-enumerableemptytresult-always-returns-cached-instance"></a>42: Enumerable.Empty<> \</> \>常にインスタンスのキャッシュを返します  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5 以降で`Enumerable.Empty`常にキャッシュされた内部インスタンスを返します`IEnumerable<T>`します。<br /><br /> 以前は、 `Enumerable.Empty` 、空のキャッシュは`IEnumerable<T>`API が呼び出された時点で、つまりをいくつかの条件下で`Enumerable.Empty`が呼び出された迅速かつ同時に、さまざまな API の呼び出しを別の型のインスタンスを返す可能性があります。|  
+|提案される解決策|以前の動作非確定的なので、コードが依存している可能性がありません。 ただし、ありそうにない場合は空の列挙を比較しているし、も等しくない場合に、明示的な空の配列を作成する (`new T[0]`) を使用せずに`Enumerable.Empty`します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Linq.Enumerable.Empty%60%601?displayProperty=fullName>|  
+|アナライザー|CD0042|  
+  
+<a name="diagnostic43"></a>   
+## <a name="43-httprequestcontentencoding-property-prohibits-utf7"></a>43: HttpRequest.ContentEncoding プロパティには、UTF7 が禁止されています  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 以降は、utf-7 エンコードは禁止されています HttpRequests の本文にします。 UTF-7 データの受信を必要とするアプリケーションのデータが、正しくデコードされない場合があります。|  
+|提案される解決策|理想的には、utf-7 は HttpRequests でエンコードを使用しないようにアプリケーションを更新する必要があります。 使用してレガシの動作を復元する代わりに、`aspnet:AllowUtf7RequestContentEncoding`の属性、 [appSettings](https://msdn.microsoft.com/en-us/library/hh975440\(v=vs.110\).aspx)要素。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Web.HttpRequest.ContentEncoding?displayProperty=fullName>|  
+|アナライザー|CD0043|  
+  
+<a name="diagnostic44"></a>   
+## <a name="44-httputilityjavascriptstringencode-escapes-ampersand"></a>44: HttpUtility.JavaScriptStringEncode アンパサンドをエスケープします。  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 以降、JavaScriptStringEncode はアンパサンド (&) 文字をエスケープします。|  
+|提案される解決策|アプリは、このメソッドの以前の動作に依存している場合は、aspnet:JavaScriptDoNotEncodeAmpersand 設定を追加することができます、 [ASP.NET appSettings 要素](https://msdn.microsoft.com/en-us/library/hh975440\(v=vs.110\).aspx)構成ファイルにします。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Web.HttpUtility.JavaScriptStringEncode%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Web.HttpUtility.JavaScriptStringEncode%28System.String%2CSystem.Boolean%29?displayProperty=fullName>|  
+|アナライザー|CD0044A<br /><br /> CD0044B|  
+  
+<a name="diagnostic46"></a>   
+## <a name="46-eventlistener-truncates-strings-with-embedded-nulls"></a>46: EventListener が埋め込まれた null のある文字列を切り捨てます  
+  
+|||  
+|-|-|  
+|詳細|EventListener には、埋め込まれた null のある文字列が切り詰められます。 EventSource クラスでは、null 文字はサポートされていません。 変更は、プロセスの EventSource データを読み取る EventListener を使用し、区切り記号として null 文字を使用するアプリにのみ影響します。|  
+|提案される解決策|EventSource データを更新する、可能であれば、埋め込まれた null 文字を使用しないようにします。|  
+|スコープ|エッジ|  
+|バージョン|4.5.1|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Diagnostics.Tracing.EventListener.%23ctor?displayProperty=fullName><br /><br /> <xref:System.Diagnostics.Tracing.EventListener.EnableEvents%28System.Diagnostics.Tracing.EventSource%2CSystem.Diagnostics.Tracing.EventLevel%29?displayProperty=fullName><br /><br /> <xref:System.Diagnostics.Tracing.EventListener.EnableEvents%28System.Diagnostics.Tracing.EventSource%2CSystem.Diagnostics.Tracing.EventLevel%2CSystem.Diagnostics.Tracing.EventKeywords%29?displayProperty=fullName><br /><br /> <xref:System.Diagnostics.Tracing.EventListener.EnableEvents%28System.Diagnostics.Tracing.EventSource%2CSystem.Diagnostics.Tracing.EventLevel%2CSystem.Diagnostics.Tracing.EventKeywords%2CSystem.Collections.Generic.IDictionary%7BSystem.String%2CSystem.String%7D%29?displayProperty=fullName> \</String, String>|  
+|アナライザー|CD0046|  
+  
+<a name="diagnostic48"></a>   
+## <a name="48-obsoleteattribute-exports-as-both-obsoleteattribute-and-deprecatedattribute-in-winmd-scenarios"></a>48: ObsoleteAttribute WinMD のシナリオで ObsoleteAttribute と DeprecatedAttribute の両方としてエクスポートします。  
+  
+|||  
+|-|-|  
+|詳細|Windows メタデータ ライブラリ (.winmd ファイル) を作成するときに、ObsoleteAttribute 属性は ObsoleteAttribute と Windows.Foundation.DeprecatedAttribute の両方としてエクスポートされます。|  
+|提案される解決策|ObsoleteAttribute 属性を使用する既存のソース コードの再コンパイルからそのコードを使用するときに警告が生成が/cli/CX または JavaScript。<br /><br /> お勧めしません。 管理対象のアセンブリのコードに ObsoleteAttribute と Windows.Foundation.DeprecatedAttribute の両方を適用します。ビルドの警告可能性があります。|  
+|スコープ|エッジ|  
+|バージョン|4.5.1|  
+|型|再ターゲット中|  
+|アナライザー|CD0048A<br /><br /> CD0048B|  
+  
+<a name="diagnostic49"></a>   
+## <a name="49-resolveassemblyreference-task-now-warns-on-dependencies-with-the-wrong-architecture"></a>49: 今すぐ ResolveAssemblyReference タスクは間違ったアーキテクチャと依存関係に関する警告が表示されます  
+  
+|||  
+|-|-|  
+|詳細|タスクは警告 MSB3270 を生成します。これは参照または依存関係がアプリのアーキテクチャと一致しないことを示します。 たとえば、これが発生した [anycpu] オプションを使用してコンパイルされたアプリには、x86 が含まれている場合の参照。 このようなシナリオは、実行時にアプリでエラーが起こった場合に発生することがあります (この場合は、アプリが x64 プロセスとして配置されている場合)。|  
+|提案される解決策|影響には&2; つの領域があります。<br /><br /> 再コンパイルすると、アプリが MSBuild の以前のバージョンでコンパイルされたときには現れなかった警告が生成されます。 ただし、警告はランタイム エラーの可能性のある原因を特定するため、調査と対処が必要です。<br /><br /> 警告がエラーとして扱われると、アプリはコンパイルされません。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|再ターゲット中|  
+|アナライザー|CD0049|  
+  
+<a name="diagnostic51"></a>   
+## <a name="51-wpf-textbox-defaults-to-undo-limit-of-100"></a>51: WPF のテキスト ボックスの既定値の上限が 100 を元に戻す  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5 での WPF のテキスト ボックスの既定の元に戻す制限には、(.NET 4.0 の制限はありませんが) ではなく 100|  
+|提案される解決策|テキスト ボックスの UndoLimit プロパティを使用して元に戻す制限の 100 が低すぎる場合は、制限値を明示的に設定できます。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Controls.TextBox?displayProperty=fullName>|  
+|アナライザー|CD0051|  
+  
+<a name="diagnostic55"></a>   
+## <a name="55-exceptions-during-unobserved-processing-in-systemthreadingtaskstask-no-longer-propagate-on-finalizer-thread"></a>55: System.Threading.Tasks.Task で観察されていない処理中に例外が不要になったファイナライザー スレッドに反映  
+  
+|||  
+|-|-|  
+|詳細|System.Threading.Tasks.Task クラスが非同期操作を表すために、非同期処理中に発生したすべての重大ではない例外をキャッチします。 .NET Framework 4.5 では、例外が確認されていないと、コードは、タスクが待機する場合、例外は、不要になったファイナライザー スレッドに反映し、ガベージ コレクション中に、プロセスがクラッシュします。 この変更は、タスク クラスを使用して観察されていない非同期処理を実行するアプリケーションの信頼性を向上します。|  
+|提案される解決策|適切なハンドラーを提供することによって、以前の動作を復元できますアプリは、観察されない非同期例外がファイナライザー スレッドへの反映に依存している場合、 [TaskScheduler.UnobservedTaskException](https://msdn.microsoft.com/en-us/library/system.threading.tasks.taskscheduler.unobservedtaskexception\(v=vs.110\).aspx)イベントを設定したり、[ランタイムの構成要素](https://msdn.microsoft.com/en-us/library/jj160346%28v=vs.110%29.aspx)します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Threading.Tasks.Task.Run%28System.Action%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%28System.Action%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%28System.Func%7BSystem.Threading.Tasks.Task%7D%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%28System.Func%7BSystem.Threading.Tasks.Task%7D%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%60%601%28System.Func%7BSystem.Threading.Tasks.Task%7B%60%600%7D%7D%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%60%601%28System.Func%7BSystem.Threading.Tasks.Task%7B%60%600%7D%7D%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%60%601%28System.Func%7B%60%600%7D%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Run%60%601%28System.Func%7B%60%600%7D%2CSystem.Threading.CancellationToken%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Start?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.Task.Start%28System.Threading.Tasks.TaskScheduler%29?displayProperty=fullName>|  
+|アナライザー|CD0055|  
+  
+<a name="diagnostic58"></a>   
+## <a name="58-iasyncresultcompletedsynchronously-property-must-be-correct-for-the-resulting-task-to-complete"></a>58: IAsyncResult.CompletedSynchronously プロパティは、結果のタスクを完了するために適切である必要があります  
+  
+|||  
+|-|-|  
+|詳細|TaskFactory.FromAsync を呼び出すときに、IAsyncResult.CompletedSynchronously プロパティの実装は、結果のタスクを完了するために正しくなければなりません。 つまり、プロパティは、実装が同期的に完了した場合のみ、true を返す必要があります。 以前は、このプロパティは確認されていませんでした。|  
+|提案される解決策|IAsyncResult の実装は正しく仕事が同期的に完了した場合にのみ、CompletedSynchronusly プロパティに true を返す場合、break は検出されません。 ユーザーは必要があります (存在する場合) を評価できるように正しく完了したか同期的に作業するかどうかを所有する IAsyncResult の実装を確認します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Threading.Tasks.TaskFactory.FromAsync%28System.Func%7BSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2CSystem.Object%29?displayProperty=fullName> \</AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%28System.Func%7BSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%28System.IAsyncResult%2CSystem.Action%7BSystem.IAsyncResult%7D%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%28System.IAsyncResult%2CSystem.Action%7BSystem.IAsyncResult%7D%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%28System.IAsyncResult%2CSystem.Action%7BSystem.IAsyncResult%7D%2CSystem.Threading.Tasks.TaskCreationOptions%2CSystem.Threading.Tasks.TaskScheduler%29?displayProperty=fullName><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.Func%7BSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%600%7D%2CSystem.Object%29?displayProperty=fullName> \</IAsyncResult, TResult> \</AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.Func%7BSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%600%7D%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</IAsyncResult, TResult> \</AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.Func%7B%60%600%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2CSystem.Object%29?displayProperty=fullName> </TArg1, AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.Func%7B%60%600%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</TArg1, AsyncCallback, Object, IAsyncResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.IAsyncResult%2CSystem.Func%7BSystem.IAsyncResult%2C%60%600%7D%29?displayProperty=fullName> \</IAsyncResult, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.IAsyncResult%2CSystem.Func%7BSystem.IAsyncResult%2C%60%600%7D%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</IAsyncResult, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%601%28System.IAsyncResult%2CSystem.Func%7BSystem.IAsyncResult%2C%60%600%7D%2CSystem.Threading.Tasks.TaskCreationOptions%2CSystem.Threading.Tasks.TaskScheduler%29?displayProperty=fullName> \</IAsyncResult, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%602%28System.Func%7B%60%600%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%601%7D%2C%60%600%2CSystem.Object%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, AsyncCallback, Object, IAsyncResult> \</TArg1, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%602%28System.Func%7B%60%600%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%601%7D%2C%60%600%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, AsyncCallback, Object, IAsyncResult> \</TArg1, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%602%28System.Func%7B%60%600%2C%60%601%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2C%60%601%2CSystem.Object%29?displayProperty=fullName> </TArg1, TArg2, AsyncCallback, Object, IAsyncResult> </TArg1, TArg2><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%602%28System.Func%7B%60%600%2C%60%601%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2C%60%601%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</TArg1, TArg2, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%603%28System.Func%7B%60%600%2C%60%601%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%602%7D%2C%60%600%2C%60%601%2CSystem.Object%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, TArg2, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%603%28System.Func%7B%60%600%2C%60%601%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%602%7D%2C%60%600%2C%60%601%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, TArg2, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%603%28System.Func%7B%60%600%2C%60%601%2C%60%602%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2C%60%601%2C%60%602%2CSystem.Object%29?displayProperty=fullName> </TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult> </TArg1, TArg2, TArg3><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%603%28System.Func%7B%60%600%2C%60%601%2C%60%602%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Action%7BSystem.IAsyncResult%7D%2C%60%600%2C%60%601%2C%60%602%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2, TArg3><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%604%28System.Func%7B%60%600%2C%60%601%2C%60%602%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%603%7D%2C%60%600%2C%60%601%2C%60%602%2CSystem.Object%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2, TArg3, TResult><br /><br /> <xref:System.Threading.Tasks.TaskFactory.FromAsync%60%604%28System.Func%7B%60%600%2C%60%601%2C%60%602%2CSystem.AsyncCallback%2CSystem.Object%2CSystem.IAsyncResult%7D%2CSystem.Func%7BSystem.IAsyncResult%2C%60%603%7D%2C%60%600%2C%60%601%2C%60%602%2CSystem.Object%2CSystem.Threading.Tasks.TaskCreationOptions%29?displayProperty=fullName> \</IAsyncResult, TResult> \</TArg1, TArg2, TArg3, AsyncCallback, Object, IAsyncResult> \</TArg1, TArg2, TArg3, TResult>|  
+|アナライザー|CD0058|  
+  
+<a name="diagnostic59"></a>   
+## <a name="59-log-file-name-created-by-the-objectcontextcreatedatabase-method-has-changed-to-match-sql-server-specifications"></a>59: ObjectContext.CreateDatabase メソッドによって作成されたログ ファイル名が SQL Server の仕様に一致するように変更されました。  
+  
+|||  
+|-|-|  
+|詳細|CreateDatabase メソッドを直接呼び出してまたは SqlClient プロバイダーと接続文字列の AttachDBFilename の値が Code First を使用して、ログ ファイルを作成するときに、コマンドを実行し (ここで、ファイル名は AttachDBFilename の値で指定されたファイルの名前) ではなく filename_log.ldf がという名前です。 この変更により、SQL Server の仕様に従ってログ ファイル名が提供されるため、デバッグ機能が向上します。|  
+|提案される解決策|ログ ファイルの名前がアプリケーションの重要な場合、アプリケーションが標準 _log.ldf ファイル名の形式が要求を更新する必要があります。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Data.Objects.ObjectContext.CreateDatabase?displayProperty=fullName>|  
+|アナライザー|CD0059|  
+  
+<a name="diagnostic60"></a>   
+## <a name="60-pageloadcomplete-event-no-longer-causes-systemwebuiwebcontrolsentitydatasource-control-to-invoke-data-binding"></a>60: Page.LoadComplete イベントは、データ バインディングを呼び出す System.Web.UI.WebControls.EntityDataSource コントロールを不要になったにより  
+  
+|||  
+|-|-|  
+|詳細|`Page.LoadComplete`イベントが作成/更新/削除パラメーター変更を加えるのためのデータ バインディングを呼び出す System.Web.UI.WebControls.EntityDataSource コントロールを不要になったさせます。 この変更は、データベースへの不要なアクセスを排除、コントロールの値がリセットされることを防止し、SqlDataSource、ObjectDataSource などその他のデータ コントロールと一貫性のある動作を生成します。 この変更により、アプリケーションが `Page.LoadComplete` イベントのデータ バインディングの呼び出しに依存するような珍しい状況において、異なる動作が生成されるようになりました。|  
+|提案される解決策|データ バインドの必要性がある場合は、ポストバックの前半であるイベントのデータ バインドを手動で起動します。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0060|  
+  
+<a name="diagnostic61"></a>   
+## <a name="61-webutilityhtmldecode-no-longer-decodes-invalid-input-sequences"></a>61: WebUtility.HtmlDecode が不要になった無効な入力シーケンスをデコード  
+  
+|||  
+|-|-|  
+|詳細|既定では、デコード メソッドによって無効な入力シーケンスが無効な UTF-16 文字列にデコードされることがなくなりました。 代わりに、元の入力が返されます。|  
+|提案される解決策|デコーダーの出力の変更は、UTF-16 データではなくバイナリ データを文字列に格納した場合にのみ影響があります。 この動作を明示的に制御する設定、`aspnet:AllowRelaxedUnicodeDecoding`の属性、 [appSettings](https://msdn.microsoft.com/en-us/library/ms228154\(v=vs.110\).aspx)レガシーの動作を有効にする場合は true または false に設定すると、現在の動作を有効にする要素。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Net.WebUtility.HtmlDecode%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Net.WebUtility.HtmlDecode%28System.String%2CSystem.IO.TextWriter%29?displayProperty=fullName><br /><br /> <xref:System.Net.WebUtility.UrlDecode%28System.String%29?displayProperty=fullName>|  
+|アナライザー|CD0061|  
+  
+<a name="diagnostic63"></a>   
+## <a name="63-apps-published-with-clickonce-that-use-a-sha-256-code-signing-certificate-may-fail-on-windows-2003"></a>63: Windows 2003 で sha-256 コード署名証明書を使用する ClickOnce で発行されたアプリが失敗します。  
+  
+|||  
+|-|-|  
+|詳細|この実行可能ファイルは SHA256 で署名されます。 以前は、コード署名証明書が SHA-1 か SHA-256 に関係なく、SHA&1; で署名されました。 この方法は、次の対象に適用されます。<br /><br /> Visual Studio 2012 以降でビルドされたすべてのアプリケーション。<br /><br /> .NET Framework 4.5 がインストールされているシステム上で、Visual Studio 2010 以前でビルドされたアプリケーション。<br /><br /> さらに、.NET Framework 4.5 以降が存在する場合、コンパイル対象となった .NET Framework のバージョンに関係なく、ClickOnce マニフェストはSHA-256 証明書の SHA 256 で署名されます。|  
+|提案される解決策|ClickOnce 実行可能ファイルの署名に変更が Windows Server 2003 システムだけです。これらは、サポート技術情報 938397 をインストールすることが必要です。<br /><br /> アプリが .NET Framework 4.0 以前のバージョンをターゲットとしている場合でも、SHA-256 を使用したマニフェストの署名方法の変更により、.NET Framework 4.5 以降のバージョンに対するランタイム依存関係が導入されます。|  
+|スコープ|エッジ|  
+|バージョン|4.5-4.6|  
+|型|再ターゲット中|  
+|アナライザー|CD0063|  
+  
+<a name="diagnostic68"></a>   
+## <a name="68-dbparameterprecision-and-dbparameterscale-are-now-public-virtual-members"></a>68: DbParameter.Precision と DbParameter.Scale は、パブリックの仮想メンバー  
+  
+|||  
+|-|-|  
+|詳細|DbParameter.Precision と DbParameter.Scale は、パブリック仮想プロパティとして実装されます。 対応する明示的なインターフェイス実装、DbParameter.IDbDataParameter.Precision と DbParameter.IDbDataParameter.Scale 置き換えられます。|  
+|提案される解決策|ADO.NET データベース プロバイダーを再構築する場合、これらの違いには、精度とスケールのプロパティに適用される 'override' キーワードが必要です。 これは必要になるだけです。 コンポーネントを再構築既存のバイナリは引き続き機能します。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Data.Common.DbParameter.Precision?displayProperty=fullName><br /><br /> <xref:System.Data.Common.DbParameter.Scale?displayProperty=fullName>|  
+|アナライザー|CD0068|  
+  
+<a name="diagnostic73"></a>   
+## <a name="73-dataobjectgetdata-now-retrieves-data-as-utf-8"></a>73: DataObject.GetData にデータを utf-8 として取得  
+  
+|||  
+|-|-|  
+|詳細|対象とする .NET Framework 4 または .NET Framework 4.5.1 以前のバージョンで実行されているアプリの場合は、DataObject.GetData は、HTML 形式のデータを ASCII 文字列として取得します。 結果として、非 ASCII 文字 (ASCII コードが 0x7F よりも大きい文字) は 2 つのランダムな文字で表されます。<br /><br /> .NET Framework 4.5 または以降に、.NET Framework 4.5.2、上で実行を対象とするアプリの`DataObject.GetData`0x7F よりも大きい文字を正しく表す utf-8 として HTML 形式のデータを取得します。|  
+|提案される解決策|(たとえば、UTF8Encoding.GetString メソッドに渡すことによって、クリップボードから取得した HTML 文字列を明示的にエンコード) を HTML 形式の文字列を含むエンコーディングの問題に対する回避策を実装して、バージョン 4 から 4.5 へアプリを再ターゲットしている場合は、その回避策を削除してください。<br /><br /> 以前の動作は何らかの理由のために必要なアプリケーションはその動作を実現する .NET Framework 4.0 を対象することができます。|  
+|スコープ|エッジ|  
+|バージョン|4.5.2|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Windows.DataObject.GetData%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Windows.DataObject.GetData%28System.String%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Windows.DataObject.GetData%28System.Type%29?displayProperty=fullName>|  
+|アナライザー|CD0073|  
+  
+<a name="diagnostic75"></a>   
+## <a name="75-targetframeworkname-for-default-app-domain-no-longer-defaults-to-null-if-not-set"></a>75: 既定のアプリケーション ドメインの TargetFrameworkName 不要になった既定値は null に設定されていない場合  
+  
+|||  
+|-|-|  
+|詳細|TargetFrameworkName は、明示的に設定されている場合を除き、既定のアプリケーション ドメインで以前 null でした。 4.6 以降では、既定のアプリケーション ドメインの TargetFrameworkName プロパティは (ある場合)、TargetFrameworkAttribute から派生した既定値があります。 既定以外のアプリ ドメインが明示的にオーバーライドされない限り、既定のアプリケーション ドメイン (これは 4.6 で null が既定で) から、TargetFrameworkName を継承し続けます。|  
+|提案される解決策|依存するコードを更新するか`AppDomainSetup.TargetFrameworkName`既定では null です。 必要な場合、このプロパティは null と評価を続けます、明示的に設定できますがその値にします。|  
+|スコープ|エッジ|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.AppDomainSetup.TargetFrameworkName?displayProperty=fullName>|  
+|アナライザー|CD0075B<br /><br /> CD0075A|  
+  
+<a name="diagnostic76"></a>   
+## <a name="76-x509certificate2tostringbool-does-not-throw-now-when-net-cannot-handle-the-certificate"></a>76: X509Certificate2.ToString(bool) では、.NET がときに、証明書に処理できないようになりましたはスローされません  
+  
+|||  
+|-|-|  
+|詳細|以前は、このメソッドをスロー 'true' verbose パラメーターに渡され、インストールされた証明書があった場合、.Net でサポートされていないフレームワークです。 これで、メソッドは成功し、アクセスできない、certifiate 部分を省略する有効な文字列が返されます。|  
+|提案される解決策|場合によっては、API を以前スローを返される文字列が場合があります (公開キー、秘密キー、および拡張機能) などのいくつかの証明書データを除外することを期待する X509Certificate2.ToString(bool) に応じて任意のコードを更新する必要があります。|  
+|スコープ|エッジ|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Security.Cryptography.X509Certificates.X509Certificate2.ToString%28System.Boolean%29?displayProperty=fullName>|  
+|アナライザー|CD0076|  
+  
+<a name="diagnostic77"></a>   
+## <a name="77-reflection-objects-can-no-longer-be-passed-from-managed-code-to-out-of-process-dcom-clients"></a>77: アウト プロセス DCOM クライアントにマネージ コードからリフレクション オブジェクトが渡さ不要になったことができます  
+  
+|||  
+|-|-|  
+|詳細|リフレクション オブジェクトはマネージ コードからアウト プロセス DCOM クライアントに渡されなくなりました。 次の種類が影響を受けます。<br /><br /> Assembly<br /><br /> MemberInfo (および最後に、MethodInfo、種類、および間違っています。 その派生型)<br /><br /> MethodBody<br /><br /> モジュール<br /><br /> ParameterInfo。<br /><br /> 呼び出す`IMarshal`戻り値のオブジェクトの`E_NOINTERFACE`です。|  
+|提案される解決策|非リフレクション オブジェクトの処理をマーシャ リング コードを更新します。|  
+|スコープ|マイナー|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|アナライザー|CD0077|  
+  
+<a name="diagnostic78"></a>   
+## <a name="78-contentdisposition-datetimes-returns-slightly-different-string"></a>78: します DateTimes が若干異なる文字列を返します。  
+  
+|||  
+|-|-|  
+|詳細|4.6 では、常に 2 桁の数字を持つ日付時刻の時間部分を表すために、ContentDispositions の文字列形式が更新されました。 これは、遵守[RFC822](http://www.ietf.org/rfc/rfc0822.txt)と[RFC2822](http://www.ietf.org/rfc/rfc2822.txt)します。 これにより、 `ContentDisposition.ToString` 10時 00分 AM 前に、の廃棄の時間要素のいずれかの場所のシナリオで 4.6 で若干異なる文字列を返します。 ContentDispositions がします。 ToString 処理、シリアル化、および GetHashCode 呼び出しを確認する必要がありますので、文字列に変換してから使用してもシリアル化されることに注意してください。|  
+|提案される解決策|ContentDispositions の文字列形式をさまざまな .NET Framework のバージョンが、相互に正しくと比べてみることを期待できません。 可能であれば、比較を行う前に、ContentDispositions に文字列を変換します。|  
+|スコープ|マイナー|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Net.Mime.ContentDisposition.GetHashCode?displayProperty=fullName><br /><br /> <xref:System.Net.Mime.ContentDisposition.ToString?displayProperty=fullName>|  
+|アナライザー|CD0078|  
+  
+<a name="diagnostic82"></a>   
+## <a name="82-workflowdesignerload-doesnt-remove-symbol-property"></a>82: WorkflowDesigner.Load はシンボル プロパティを削除しません。  
+  
+|||  
+|-|-|  
+|詳細|ワークフロー デザイナーおよび WorkflowDesigner.Load() メソッドを使用して再ホストされた 3.5 のワークフローの読み込みで .NET Framework 4.5 を対象とする場合は、ワークフローの保存中に、XamlDuplicateMemberException がスローされます。|  
+|提案される解決策|このバグは、ワークフロー デザイナーでの周りを設定して動作できるように .NET Framework 4.5 を対象とする場合にのみマニフェスト、 `WorkflowDesigner.Context.Services.GetService<DesignerConfigurationService>().TargetFrameworkName` 4.0 の .NET Framework にします。<br /><br /> 使用して、問題を回避する代わりに、 [WorkflowContext.Load(string)](https://msdn.microsoft.com/en-us/library/ee425926\(v=vs.110\).aspx)メソッドの代わりに、ワークフローの読み込みを[WorkflowDesigner.Load()](https://msdn.microsoft.com/en-us/library/ee403482\(v=vs.110\).aspx)します。|  
+|スコープ|Major|  
+|バージョン|4.5-4.5.2|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Activities.Presentation.WorkflowDesigner.Load?displayProperty=fullName>|  
+|アナライザー|CD0082|  
+  
+<a name="diagnostic83"></a>   
+## <a name="83-sqlconnectionopen-fails-on-windows-7-with-non-ifs-winsock-bsp-or-lsp-present"></a>83: IFS Winsock BSP または LSP があると Windows 7 で SqlConnection.Open が失敗します。  
+  
+|||  
+|-|-|  
+|詳細|SqlConneciton.Open および OpenAsync は、コンピューター上に存在する IFS Winsock BSP または LSP が Windows 7 コンピューターで実行されている場合は .NET Framework 4.5 で失敗します。<br /><br /> IFS BSP 以外または LSP がインストールされているかどうかを確認するのには、使用、`netsh WinSock Show Catalog`コマンド、および確認すべて`Winsock Catalog Provider Entry`返される項目です。 サービスのフラグ値がある場合、`0x20000`ビットが設定されて、プロバイダーが IFS のハンドルを使用して、正しく機能します。 場合、`0x20000`ビットはクリアされます (設定しません)、IFS BSP 以外または LSP をお勧めします。|  
+|提案される解決策|このバグについては .NET framework 4.5.2、修正が .NET Framework をアップグレードすることによって回避できるようにします。 また、すべてインストールされている非-IFS Winsock Lsp を削除することで回避できます。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.5.2|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Data.SqlClient.SqlConnection.Open?displayProperty=fullName><br /><br /> <xref:System.Data.SqlClient.SqlConnection.OpenAsync%28System.Threading.CancellationToken%29?displayProperty=fullName>|  
+|アナライザー|CD0083|  
+  
+<a name="diagnostic84"></a>   
+## <a name="84-icommandcanexecutechanged-event-behaviour-changed-in-net-45"></a>84: ICommand.CanExecuteChanged イベントの動作は .NET 4.5 で変更されました。  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 では、イベントの送信元イベントを発生させたオブジェクトと同じオブジェクトされていない限り、CanExecuteChangedEvent が無視されました。 このバグは、.NET Framework 4.5 servcing 更新プログラムで修正されました。|  
+|提案される解決策|このバグは、サービスでは、.NET Framework が最新であることを確認することで、または .NET Framework 4.5.1 へのアップグレードによって回避できるようにをリリース、.NET Framework 4.5 で修正がされています。 または、ICommand を使ったアプリケーション コードを変更して、CanExecuteChanged コマンドを発生させる場合、送信者がイベントを発生させるオブジェクトと同じであるかどうかを確認できます。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Input.ICommand.CanExecuteChanged?displayProperty=fullName>|  
+|アナライザー|CD0084|  
+  
+<a name="diagnostic85"></a>   
+## <a name="85-some-net-apis-cause-first-chance-handled-entrypointnotfoundexceptions"></a>85: 初回 (処理) が発生する一部の .NET Api EntryPointNotFoundExceptions  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 では、少数の .NET メソッドは、初回 EntryPointNotFoundExceptions をスローすることが開始されました。 .Net 内でこれらの例外が処理されたフレームワーク、初回例外が予期しないテスト自動化を損なうことができます。 これらと同じ Api は、HighVersionLie が有効になっているときに、いくつかの ApiVerifier シナリオを中断します。|  
+|提案される解決策|このバグは、.NET Framework 4.5.1 をアップグレードすることで回避できます。 また、テスト自動化に初回 EntryPointNotFoundExceptions で中断しない更新できます。|  
+|スコープ|エッジ|  
+|バージョン|4.5-4.5.1|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Diagnostics.Debug.Assert%28System.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Diagnostics.Debug.Assert%28System.Boolean%2CSystem.String%29?displayProperty=fullName><br /><br /> <xref:System.Diagnostics.Debug.Assert%28System.Boolean%2CSystem.String%2CSystem.String%29?displayProperty=fullName><br /><br /> [Debug.Assert (オブジェクトのブール値、文字列、文字列、\<xref:System.Diagnostics.Debug.Assert%28System.Boolean%2CSystem.String%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName><br /><br /> <xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%29?displayProperty=fullName>|  
+|アナライザー|CD0085|  
+  
+<a name="diagnostic86"></a>   
+## <a name="86-scrolling-a-wpf-treeview-or-grouped-listbox-in-a-virtualizingstackpanel-can-cause-a-hang"></a>86: WPF TreeView コントロールまたは、VirtualizingStackPanel でグループ化された ListBox のスクロール、ハングが発生することができます  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework v4.5、仮想化されたスタック パネルで WPF TreeView をスクロールすることがありますハング (または ItemsPresenter 要素をツリー ビューなどの項目) の間、ビューポートに余白がある場合。 さらに、場合によっては、ビュー内のさまざまなサイズ設定されたアイテムことがありますが不安定になる場合でも、余白はありません。|  
+|提案される解決策|このバグは、.NET Framework 4.5.1 をアップグレードすることで回避できます。 また、格納されているすべての項目が同じサイズである場合は、余白を (Treeview) のような仮想化されたスタック パネル内のビューのコレクションから削除できます。|  
+|スコープ|Major|  
+|バージョン|4.5-4.5.1|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Controls.VirtualizingStackPanel.SetIsVirtualizing%28System.Windows.DependencyObject%2CSystem.Boolean%29?displayProperty=fullName>|  
+|アナライザー|CD0086<br /><br /> CD0086|  
+  
+<a name="diagnostic89"></a>   
+## <a name="89-typeisassignablefrom-returns-wrong-result-for-generic-variables-with-constraints"></a>89: Type.IsAssignableFrom には、制約を持つジェネリック変数の間違った結果が返されます。  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 で Type.IsAssignableFrom は正しくを返すこと`false`いくつかの制約のジェネリック型のすべてのケースにします。|  
+|提案される解決策|この問題は、サービスの更新プログラムで修正されました。 この問題を解決する .NET Framework 4.5、または .NET Framework 4.5.1 へのアップグレード、またはそれ以降に更新してください。 またをジェネリック パラメーターの制約を持つジェネリック型で IsAssignableFrom を使用しないでください。 解決策としては、リフレクション Api を使用できます。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Type.IsAssignableFrom%28System.Type%29?displayProperty=fullName>|  
+|アナライザー|CD0089<br /><br /> CD0089|  
+  
+<a name="diagnostic91"></a>   
+## <a name="91-entityframework-60-loads-very-slowly-in-apps-launched-from-visual-studio"></a>91: entity Framework 6.0 は、Visual Studio から起動されたアプリケーションで非常に遅いが読み込まれる  
+  
+|||  
+|-|-|  
+|詳細|Entity Framework 6.0 を使用する Visual Studio 2013 からアプリを起動すると、非常に遅いことができます。|  
+|提案される解決策|EntityFramework 6.0.2 では、この問題が解決します。 パフォーマンスの問題を回避する entity Framework を更新してください。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0091|  
+  
+<a name="diagnostic92"></a>   
+## <a name="92-multi-line-aspnet-textbox-spacing-changed-when-using-antixssencoder"></a>92: AntiXSSEncoder を使用する場合、ASP.Net の TextBox を複数行の間隔が変更されました  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.0 で行を追加する間に挿入された行のポストバックでは、上の複数行テキスト ボックスを使用する場合、`AntiXSSEncoder`です。 .NET Framework 4.5 でこれらの余分な改行は、web アプリが .NET 4.5 を対象とする場合にのみ|  
+|提案される解決策|複数行テキスト ボックスが不要になった余分な改行を挿入するように改良を 4.0 の web アプリが .NET 4.5 に再ターゲットであることに注意してください。 これが望ましくない場合、アプリケーションで、.NET Framework 4.0 を対象とする .NET Framework 4.5 で実行されているときに以前の動作ができます。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|アナライザー|CD0092|  
+  
+<a name="diagnostic95"></a>   
+## <a name="95-concurrentqueuettrypeek-can-return-an-erroneous-null-via-its-out-parameter"></a>95: ConcurrentQueue<>\>します。TryPeek は、その出力パラメーターを使用してエラーがある null を返すことができます。  
+  
+|||  
+|-|-|  
+|詳細|一部のマルチ スレッドのシナリオで`ConcurentQueue<T>.TryPeek`true を返すことができますが、(適切なピーク値) ではなく null 値を持つ出力パラメーターを設定します。|  
+|提案される解決策|.NET Framework 4.5.1 では、この問題が解決します。 そのフレームワークにアップグレードすると、問題が解決されます。|  
+|スコープ|Major|  
+|バージョン|4.5-4.5.1|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Collections.Concurrent.ConcurrentQueue%601.TryPeek%28%600%40%29?displayProperty=fullName>|  
+|アナライザー|CD0095|  
+  
+<a name="diagnostic98"></a>   
+## <a name="98-multiple-items-in-a-single-tablelayoutpanel-cell-may-be-rearranged"></a>98: 単一 TableLayoutPanel セル内の複数の項目を並べ替えることができます  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 で同じの TableLayoutPanel セル内に複数の項目が配置されている場合可能性がありますで表示されるよう、別の順序よりも、.NET Framework 4.0 にします。|  
+|提案される解決策|この動作は、.NET Framework 4.5 をサービスの更新プログラムに復元されました。 この問題を解決する .NET Framework 4.5、または .NET Framework 4.5.1 へのアップグレード、またはそれ以降に更新してください。 また、同じ TableLayourPanel セル内の複数の項目のあいまいなケースを回避します。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Forms.TableLayoutControlCollection.Add%28System.Windows.Forms.Control%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName>|  
+|アナライザー|CD0098|  
+  
+<a name="diagnostic100"></a>   
+## <a name="100-foreach-iterator-variable-is-now-scoped-within-the-iteration-so-closure-capturing-semantics-are-different-in-c5"></a>100: Foreach 反復子変数の現在のスコープ、イテレーションに含まれるため、クロージャのキャプチャのセマンティクスは、(C&5;) で異なります  
+  
+|||  
+|-|-|  
+|詳細|C# 5 (Visual Studio 2012) 以降では、foreach 反復子変数は、イテレーションごとにスコープされます。 Foreach のクロージャに含まれないように、変数に依存したコードしていた場合は、区切りができます。 という症状は、この変更は、代表に渡された反復子変数が、デリゲートが呼び出された時点の値ではなく、デリゲートの作成時の値として処理することになります。|  
+|提案される解決策|理想的には、新しいコンパイラの動作を期待するコードを更新する必要があります。 古いセマンティクスが必要な場合は、ループのスコープ外で明示的に配置されている別々 の変数を反復子変数を交換できます。|  
+|スコープ|Major|  
+|バージョン|4.5|  
+|型|再ターゲット中|  
+|アナライザー|CD0100|  
+  
+<a name="diagnostic101"></a>   
+## <a name="101-htmltextwriter-does-not-render-br-element-correctly"></a>101: HtmlTextWriter が表示されません。\`<br>\>' 要素正しく  
+  
+|||  
+|-|-|  
+|詳細|呼び出す .NET Framework 4.6 では、以降で`HtmlTextWriter.RenderBeginTag()`と`HtmlTextWriter.RenderEndTag()`で、`<BR />`要素が 1 つだけに挿入することが正しく`<BR />`ではなく 2 つ)|  
+|提案される解決策|アプリは、余分なに依存している場合`<BR />`タグ、`HtmlTextWriter.RenderBeginTag()`をもう一度呼び出す必要があります。 この動作を変更するには、ので、別のオプションは従来の動作を取得するために、.NET Framework の以前のバージョンを対象とする .NET Framework 4.6 では、対象とするアプリにのみ影響します。|  
+|スコープ|エッジ|  
+|バージョン|4.6|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Web.UI.HtmlTextWriter.RenderBeginTag%28System.String%29?displayProperty=fullName><br /><br /> <xref:System.Web.UI.HtmlTextWriter.RenderBeginTag%28System.Web.UI.HtmlTextWriterTag%29?displayProperty=fullName>|  
+|アナライザー|CD0101|  
+  
+<a name="diagnostic104"></a>   
+## <a name="104-calling-itemsrefresh-on-a-wpf-listbox-listview-or-datagrid-with-items-selected-can-cause-duplicate-items-to-appear-in-the-element"></a>104: WPF ListBox、ListView、または選択された項目がある DataGrid での通話 Items.Refresh 要素に表示される項目の重複が発生することができます  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.5 では、リスト ボックス内の項目が選択されている間は、コードから ListBox.Items.Refresh を呼び出すと、選択した項目を一覧内で重複するが発生することができます。 ListView コントロールと DataGrid と同様の問題が発生します。 これは、.NET Framework 4.6 で修正されます。|  
+|提案される解決策|プログラムで選択を解除する項目の更新が呼び出される前に再を選択し、それらの呼び出しが完了した後でこの問題を回避することがあります。 または、この問題は、.NET Framework 4.6 で修正されています、.NET Framework のバージョンにアップグレードすることでアドレス指定すること。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Data.CollectionView.Refresh?displayProperty=fullName>|  
+|アナライザー|CD0104|  
+  
+<a name="diagnostic105"></a>   
+## <a name="105-etw-eventlisteners-do-not-capture-events-from-providers-with-explicit-keywords-like-the-tpl-provider"></a>105: ETW EventListeners (TPL プロバイダー) のような明示的なキーワードとプロバイダーからのイベントがキャプチャされていません。  
+  
+|||  
+|-|-|  
+|詳細|キーワードの空のマスクを持つ ETW EventListeners は、正しく明示的なキーワードとプロバイダーからのイベントをキャプチャしません。 .NET Framework 4.5 では、TPL プロバイダーは、明示的なキーワードを提供することに開始され、この問題が発生します。 .NET Framework 4.6 では、EventListeners が不要になったこの問題があると更新されました。|  
+|提案される解決策|この問題を回避するには、明示的に使用する「キーワード」マスクを指定するオーバー ロードを EnableEvents への呼び出しに EnableEvents (eventSource、レベル) の呼び出しを置き換える:`EnableEvents(eventSource, level, unchecked((EventKeywords)0xFFFFffffFFFFffff))`です。<br /><br /> または、この問題は、.NET Framework 4.6 で修正されています、.NET Framework のバージョンにアップグレードすることでアドレス指定すること。|  
+|スコープ|エッジ|  
+|バージョン|4.5-4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Diagnostics.Tracing.EventListener.EnableEvents%28System.Diagnostics.Tracing.EventSource%2CSystem.Diagnostics.Tracing.EventLevel%29?displayProperty=fullName>|  
+|アナライザー|CD0105|  
+  
+<a name="diagnostic109"></a>   
+## <a name="109-building-an-entity-framework-edmx-with-visual-studio-2013-can-fail-with-error-msb4062-if-using-the-entitydeploysplit-or-entityclean-tasks"></a>109: Visual Studio 2013 で、Entity Framework edmx を構築できる場合エラーで失敗 MSB4062 EntityDeploySplit または EntityClean タスクを使用します。  
+  
+|||  
+|-|-|  
+|詳細|MSBuild 12.0 ツール (Visual Studio 2013 に含まれる) には、古い Entity Framework のターゲット ファイルが無効になる原因と、msbuild ファイルの場所が変更されました。 その結果`EntityDeploySplit`と`EntityClean`を見つけることはないために、タスクが失敗する`Microsoft.Data.Entity.Build.Tasks.dll`です。 この区切りは、ツールセット (msbuild/VS) 変更されるため、.NET Framework の変更のために注意してください。 単なる .NET Framework をアップグレードするときではなく、開発者ツールをアップグレードするときにのみ実行されます。|  
+|提案される解決策|Entity Framework のターゲット ファイルは、msbuild レイアウト以降の新機能には、.NET Framework 4.6 を使用する固定です。 Framework のバージョンにアップグレードすると、この問題を解決します。 または、[この](http://stackoverflow.com/a/24249247/131944)回避策は、ターゲット ファイルを直接修正プログラムを使用できます。|  
+|スコープ|Major|  
+|バージョン|4.5.1-4.6|  
+|型|再ターゲット中|  
+|アナライザー|CD0109|  
+  
+<a name="diagnostic111"></a>   
+## <a name="111-xsd-schema-validation-now-correctly-detects-violations-of-unique-constraints-if-compound-keys-are-used-and-one-key-is-empty"></a>111: 現在、XSD スキーマの検証は、複合キーを使用して、1 つのキーが空の場合正しく unique 制約の違反を検出  
+  
+|||  
+|-|-|  
+|詳細|4.6 の前に .NET Framework のバージョンでは、キーのいずれかが空の場合、複合キーの一意性制約を検出しないように XSD 検証を原因となったバグがありました。 .NET Framework 4.6 では、この問題を修正しました。 適切な検証は、この結果が、以前を持つで検証されないいくつかの XML にする可能性もあります。|  
+|提案される解決策|.NET Framework 4.0 の検証が必要、緩やかな場合は、検証中のアプリケーションがバージョン 4.5 (またはそれ以前) をターゲット .NET Framework のです。 .NET 4.6 に再ターゲットとただし、コード レビューは、重複の複合キーでの説明に従ってこの問題の説明) が予期されていないを検証するかどうかを必ず行ってください。|  
+|スコープ|エッジ|  
+|バージョン|4.6|  
+|型|再ターゲット中|  
+|アナライザー|CD0111|  
+  
+<a name="diagnostic112"></a>   
+## <a name="112-calling-attributegetcustomattributes-on-an-indexer-property-no-longer-throws-ambiguousmatchexception-if-the-ambiguity-can-be-resolved-by-indexs-type"></a>112: 通話 Attribute.GetCustomAttributes インデクサー プロパティには、インデックスの種類によって、あいまいさを解決できる場合は、不要になった AmbiguousMatchException をスロー  
+  
+|||  
+|-|-|  
+|詳細|.NET Framework 4.6 を呼び出す前に`GetCustomAttribute(s)`インデクサー上で、インデックスの種類によってのみ別のプロパティからと一致しません。 プロパティになる、`AmbiguousMatchException`です。 以降、.NET Framework 4.6 では、プロパティの属性が正しく返されます。|  
+|提案される解決策|GetCustomAttribute(s) が動作するより頻繁にここで注意してください。 アプリケーションに依存していた場合、 `AmbiguousMatchException`、明示的に複数のインデクサーの代わりに検索するにリフレクションを使用する必要があります。|  
+|スコープ|エッジ|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Attribute.GetCustomAttribute%28System.Reflection.MemberInfo%2CSystem.Type%29?displayProperty=fullName><br /><br /> <xref:System.Attribute.GetCustomAttribute%28System.Reflection.MemberInfo%2CSystem.Type%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Attribute.GetCustomAttributes%28System.Reflection.MemberInfo%29?displayProperty=fullName><br /><br /> <xref:System.Attribute.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Attribute.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Type%29?displayProperty=fullName><br /><br /> <xref:System.Attribute.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Type%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttribute%28System.Reflection.MemberInfo%2CSystem.Type%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttribute%28System.Reflection.MemberInfo%2CSystem.Type%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttribute%60%601%28System.Reflection.MemberInfo%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttribute%60%601%28System.Reflection.MemberInfo%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%28System.Reflection.MemberInfo%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Type%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%28System.Reflection.MemberInfo%2CSystem.Type%2CSystem.Boolean%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%60%601%28System.Reflection.MemberInfo%29?displayProperty=fullName><br /><br /> <xref:System.Reflection.CustomAttributeExtensions.GetCustomAttributes%60%601%28System.Reflection.MemberInfo%2CSystem.Boolean%29?displayProperty=fullName>|  
+|アナライザー|CD0112|  
+  
+<a name="diagnostic113"></a>   
+## <a name="113-intermittently-unable-to-scroll-to-bottom-item-in-itemscontrols-like-listbox-and-datagrid-when-using-custom-datatemplates"></a>113: ItemsControls (リスト ボックスや DataGrid) などの下位の項目にスクロールすることができません断続的にカスタム Datatemplate を使用する場合  
+  
+|||  
+|-|-|  
+|詳細|場合によっては、.NET Framework 4.5 でのバグを引き起こしている ItemsControls (リスト ボックス、コンボ ボックス、DataGrid など) など、下位の項目にスクロールしないにカスタム Datatemplate を使用するとします。 スクロールが行われると (スクロールすると、バックアップを作成) 後にもう一度動作かどうかは、です。|  
+|提案される解決策|この問題は、.NET framework 4.5.2 は修正され、.NET Framework のバージョン (またはそれ以降のバージョン) にアップグレードすることでアドレス指定することです。 また、ユーザーは、これらのコレクションの最後のアイテムにスクロール バーをドラッグできますが、正常に操作を&2; 回行おうとする必要があります。|  
+|スコープ|マイナー|  
+|バージョン|4.5-4.5.2|  
+|型|ランタイム|  
+|アナライザー|CD0113|  
+  
+<a name="diagnostic114"></a>   
+## <a name="114-glyphruncomputeinkboundingbox-and-formattedtextextent-return-different-values-beginning-in-net-45"></a>114: GlyphRun.ComputeInkBoundingBox() と FormattedText.Extent .NET 4.5 以降で別の値を返す  
+  
+|||  
+|-|-|  
+|詳細|ボックスが小さすぎるため、場合によっては、.NET Framework 4.0 に含まれるグリフの GlyphRun.ComputeInkBoundingBox() と問題に対応する .NET Framework 4.5 で FormattedText.Extent に改善が加えられました。 その結果は、UI レイアウトにわずかな違いに .NET Framework 4.5 での大規模な先頭がいくつかの境界ボックスになります。|  
+|提案される解決策|いくつかのグリフの境界ボックス サイズが増加したことに注意してください。 これらの変更は、通常、向上プレゼンテーション ヒット ボックス、およびテストが、古い (事前 .NET 4.5) の動作を使用する場合は、そのことができます 10 営業日に app.config ファイルに次のエントリを追加することで。<br /><br /> `<appsettings> <add key="IncludeAllInkInBoundingBox" value="false"> </appsettings>`|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Media.GlyphRun.ComputeInkBoundingBox?displayProperty=fullName><br /><br /> <xref:System.Windows.Media.FormattedText.Extent?displayProperty=fullName>|  
+|アナライザー|CD0114|  
+  
+<a name="diagnostic124"></a>   
+## <a name="124-calling-datagridcommitedit-from-a-celleditending-handler-drops-focus"></a>124: CellEditEnding ハンドラーから呼び出す DataGrid.CommitEdit フォーカスを削除します。  
+  
+|||  
+|-|-|  
+|詳細|DataGrid の CellEditEnding イベント ハンドラーのいずれかから DataGrid.CommitEdit を呼び出すと、フォーカスが失われ、DataGrid とします。|  
+|提案される解決策|このバグについては .NET framework 4.5.2、修正が .NET Framework をアップグレードすることによって回避できるようにします。 また、明示的に再 CommitEdit を呼び出した後、データ グリッドを選択して回避できます。|  
+|スコープ|エッジ|  
+|バージョン|4.5-4.5.2|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.Controls.DataGrid.CommitEdit?displayProperty=fullName><br /><br /> <xref:System.Windows.Controls.DataGrid.CommitEdit%28System.Windows.Controls.DataGridEditingUnit%2CSystem.Boolean%29?displayProperty=fullName>|  
+|アナライザー|CD0124|  
+  
+<a name="diagnostic125"></a>   
+## <a name="125-aspnet-mvc-now-escapes-spaces-in-strings-passed-in-via-route-parameters"></a>125: ASP.NET MVC はルート パラメーターに渡された文字列に含まれるスペースをエスケープするようになりました  
+  
+|||  
+|-|-|  
+|詳細|RFC 2396 に準拠させるためにルートからのアクション パラメーターを設定するときに、ルートのパスにスペースはエスケープようになりました。 そのため、一方`/controller/action/some data`ルートと一致した`/controller/action/{data}`でき、`some data`データ パラメーターとしてその機能が追加されました`some%20data`代わりにします。|  
+|提案される解決策|コードを更新すると、ルートから文字列パラメーターをエスケープ解除する必要があります。 元の URI が必要な場合は、Request.RequestUri.OriginalString API にアクセスできます。|  
+|スコープ|マイナー|  
+|バージョン|4.5.2|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Web.Http.RouteAttribute.%23ctor%28System.String%29?displayProperty=fullName>|  
+|アナライザー|CD0125|  
+  
+<a name="diagnostic127"></a>   
+## <a name="127-vbnet-no-longer-supports-partial-namespace-qualification-for-systemwindows-apis"></a>127: VB.NET では System.Windows Api の部分的な名前空間の修飾がサポートしていません  
+  
+|||  
+|-|-|  
+|詳細|.NET 4.5.2 の以降では、VB.NET プロジェクトは部分修飾名前空間を持つ System.Windows Api を指定できません。 たとえばを参照する`Windows.Forms.DialogResult`は失敗します。 代わりに、コードは、完全修飾名を参照する必要があります (`System.Windows.Forms.DialogResult`) または特定の名前空間をインポートし、だけを参照してください`DialogResult`します。|  
+|提案される解決策|参照するコードを更新する必要があります`System.Windows`Api 単純な名前 (および関連する名前空間をインポートする)、または完全修飾名。|  
+|スコープ|マイナー|  
+|バージョン|4.5.2|  
+|型|再ターゲット中|  
+|アナライザー|CD0127|  
+  
+<a name="diagnostic129"></a>   
+## <a name="129-two-way-data-binding-to-a-property-with-a-non-public-setter-is-not-supported"></a>129: 非パブリック setter を使用してプロパティに双方向データ バインドはサポートされていません  
+  
+|||  
+|-|-|  
+|詳細|しようとせず、パブリックな setter プロパティへのデータ バインドがかつてないシナリオをサポートします。 .NET framework 4.5.1 以降では、このシナリオでは、InvalidOperationException がスローされます。 具体的には、.NET Framework 4.5.1 を対象とするアプリに対して新しい例外がスローだけに注意してください。 アプリが .NET Framework 4.5 をターゲットの呼び出しが許可されます。 アプリケーションは、特定の .NET Framework バージョンを対象としない場合、バインドが扱われます一方向として。|  
+|提案される解決策|一方向のバインドを使用するか、プロパティの set アクセス操作子を公開する、アプリケーションを更新する必要があります。 また、.NET Framework 4.5 を対象とするにより、アプリ以前の動作が発生することです。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Windows.Data.BindingMode?displayProperty=fullName>|  
+|アナライザー|CD0129|  
+  
+<a name="diagnostic130"></a>   
+## <a name="130-marshalsizeof-and-marshalptrtostructure-overloads-break-dynamic-code"></a>130: Marshal.SizeOf と Marshal.PtrToStructure オーバー ロード中断動的なコード  
+  
+|||  
+|-|-|  
+|詳細|メソッドに動的に結びつける方法、.NET Framework 4.5.1 以降で`Marshal.SizeOf`または`Marshal.PtrToStructure`(またはを使用して Windows PowerShell、IronPython、たとえば C# で dynamic キーワード、) につながる`MethodInvocationExceptions`スクリプト エンジンをあいまいにする可能性があるこれらのメソッドの新しいオーバー ロードが追加されているためです。|  
+|提案される解決策|スクリプトを更新するために使用するオーバー ロードが明確に表示します。 これは普通とメソッドの型パラメーターを明示的にキャストして`System.Type`します。 参照してください[このリンク](https://support.microsoft.com/en-us/kb/2909958/)詳細と問題を解決する方法の例です。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1|  
+|型|ランタイム|  
+|アナライザー|CD0130|  
+  
+<a name="diagnostic131"></a>   
+## <a name="131-previewlostkeyboardfocus-is-called-repeatedly-if-its-handler-shows-a-windows-forms-message-box"></a>131: PreviewLostKeyboardFocus はそのハンドラーには、Windows フォーム メッセージ ボックスが表示される場合繰り返し呼び出されます。  
+  
+|||  
+|-|-|  
+|詳細|呼び出す .NET Framework 4.5 以降で`System.Windows.Forms.MessageBox.Show`から、`UIElement.PreviewLostKeyboardFocus`ハンドラーと、ハンドラーが再発生する場合、メッセージ ボックスが閉じられると、メッセージ ボックスの無限ループが可能性があります。|  
+|提案される解決策|この問題に回避するために&2; つのオプションがあります。<br /><br /> 呼び出すことによって回避できます`System.Windows.MessageBox.Show`の代わりに`System.Windows.Forms.MessageBox.Show`します。<br /><br /> メッセージ ボックスを表示することによって回避できる場合があります、`LostKeyboardFocus`イベント ハンドラー (代わりに、`PreviewLostKeyboardFocus`イベント ハンドラー)。|  
+|スコープ|エッジ|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Windows.ContentElement.PreviewLostKeyboardFocus?displayProperty=fullName><br /><br /> <xref:System.Windows.IInputElement.PreviewLostKeyboardFocus?displayProperty=fullName><br /><br /> <xref:System.Windows.UIElement.PreviewLostKeyboardFocus?displayProperty=fullName><br /><br /> <xref:System.Windows.UIElement3D.PreviewLostKeyboardFocus?displayProperty=fullName>|  
+|アナライザー|CD0131|  
+  
+<a name="diagnostic133"></a>   
+## <a name="133-a-concurrentdictionary-serialized-in-net-45-with-netdatacontractserializer-cannot-be-deserialized-by-net-451-or-452"></a>133: NetDataContractSerializer で .NET 4.5 でシリアル化された ConcurrentDictionary は .NET 4.5.1 または 4.5.2 で逆シリアル化することはできません  
+  
+|||  
+|-|-|  
+|詳細|型、内部の変更により`System.Collections.Concurrent.ConcurrentDictionary`.NET Framework 4.5 にシリアル化されるオブジェクトを使用して、 `NetDataContractSerializer` .NET framework 4.5.2 または .NET Framework 4.5.1 で逆シリアル化することはできません。<br /><br /> 逆方向の移動に注意してください (.NET Framework でのシリアル化 4.5.x と .NET Framework 4.5 に逆シリアル化) は機能します。 同様に、すべての 4.x バージョン間のシリアル化は、.NET Framework 4.6 で動作します。<br /><br /> シリアル化して、1 つのバージョンの .NET Framework で逆シリアル化は影響はありません。|  
+|提案される解決策|.NET Framework 4.5 と .NET Framework 4.5.1/4.5.2 間 ConcurrentDictionary を逆シリアル化およびシリアル化する必要がある場合は、NetDataContractSerializer ではなく、DataContractSerializer または BinaryFormatter シリアライザーなどの代替のシリアライザーを使用してください。<br /><br /> または、.NET Framework 4.6 は、この問題を説明、.NET Framework のバージョンにアップグレードすることで解決可能性があります。|  
+|スコープ|マイナー|  
+|バージョン|4.5.1-4.6|  
+|型|ランタイム|  
+|アナライザー|CD0133|  
+  
+<a name="diagnostic134"></a>   
+## <a name="134-persian-calendar-now-uses-the-hijri-solar-algorithm"></a>134: ペルシャ暦では、イスラム暦の太陽アルゴリズムを使用  
+  
+|||  
+|-|-|  
+|詳細|以降、.NET Framework 4.6 では、PersianCalendar クラスは、イスラム暦の太陽アルゴリズムを使用します。 PersianCalendar と他のカレンダーの日付に変換すると、1800 より前または 2023 (グレゴリオ暦) よりも後の日付の .NET Framework 4.6 をわずかに異なる結果の先頭が生じる場合があります。<br /><br /> また、`PersianCalendar.MinSupportedDateTime`現在`March 22, 0622 instead of March 21, 0622`します。|  
+|提案される解決策|.NET 4.6 で、PersianCalendar を使用する場合の早期または遅延の日付が若干異なる場合があります注意してください。 また、異なる .NET Framework のバージョンを実行することがプロセス間で日付をシリアル化するときは保存 PersianCalendar 日付文字列として (ため、これらの値が異なる場合があります)。|  
+|スコープ|マイナー|  
+|バージョン|4.6|  
+|型|ランタイム|  
+|影響を受ける Api|<xref:System.Globalization.PersianCalendar?displayProperty=fullName>|  
+|アナライザー|CD0134|  
+  
+<a name="diagnostic138"></a>   
+## <a name="138-calling-createdefaultauthorizationcontext-with-a-null-argument-has-changed"></a>138: null 引数による呼び出し CreateDefaultAuthorizationContext が変更されました。  
+  
+|||  
+|-|-|  
+|詳細|呼び出しによって返される、AuthorizationContext の実装、`CreateDefaultAuthorizationContext(IList<IAuthorizationPolicy>)`引数には null authorizationPolicies と .NET Framework 4.6 では、その実装が変更されました。|  
+|提案される解決策|まれに、カスタム認証を使用する WCF アプリの動作に違いが生じる可能性があります。 このような場合は、2 つの方法のいずれかで、以前の動作を復元できます。<br /><br /> 4.6 よりも前のバージョンの .NET Framework を対象とするようにアプリを再コンパイルする。 IIS でホストされるサービスを使用して、 <httpRuntime targetframework="x.x"></httpRuntime> \>以前のバージョンの .NET Framework を対象とする要素。<br /><br /> 次の行を追加、 `<appSettings>` app.config ファイルのセクション。`<add key="appContext.SetSwitch:Switch.System.IdentityModel.EnableCachedEmptyDefaultAuthorizationContext" value="true" />`|  
+|スコープ|マイナー|  
+|バージョン|4.6|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.IdentityModel.Policy.AuthorizationContext.CreateDefaultAuthorizationContext%28System.Collections.Generic.IList%7BSystem.IdentityModel.Policy.IAuthorizationPolicy%7D%29?displayProperty=fullName>|  
+|アナライザー|CD0138|  
+  
+<a name="diagnostic141"></a>   
+## <a name="141-wpf-treeviewitem-must-be-used-within-a-treeview"></a>141: WPF TreeViewItem をツリー ビュー内で使用する必要があります  
+  
+|||  
+|-|-|  
+|詳細|変更は、外部 TreeView で TreeViewItem 要素の使用量を制限する 4.5 で導入されました。 次の条件下で明らかにします。<br /><br /> TreeViewItem のビジュアルの親は、パネルではありません。 (ツリー ビューの生成 TreeViewItem を含むパネル親として)<br /><br /> リスト コントロール (ListBox、DataGrid、ListView など) の「アイテム ホスト」として機能する VirtualizingStackPanel の子孫である、TreeViewItem です。 仮想化を有効にする必要はありません。<br /><br /> 項目のスクロール、VirtualizingStackPanel は、(`ScrollUnit="Item"`)。<br /><br /> 呼び出されると`VirtualizingStackPanel.MakeVisible(v)`要素をスクロールする`v`表示にします。 これは、ため、明示的または暗黙的にでは、さまざまな方法です。おそらく、最も一般的な方法をクリックするだけで`v`にキーボード フォーカスを設定します。<br /><br /> ビジュアルの親チェーンから`v`TreeViewItem を VirtualizingStackPanel 通過します。<br /><br /> つまり、これは、TreeView の外部で TreeViewItem を使用しに表示を TreeViewItem の子孫である、ユーザーがクリックしたときに発生します。 フォーカスを取得できる子孫、TreeViewItem がない場合は、この問題を決して表示されます。 これは、ヒット、状況の例は、TreeViewItem DataTemplate のルートです。  この問題にヒットした場合は、WPF フレームワーク内で行われる InvalidCastException があります。|  
+|提案される解決策|修正プログラムが利用できるこの。|  
+|スコープ|マイナー|  
+|バージョン|4.5|  
+|型|ランタイム|  
+|アナライザー|CD0141|  
+  
+<a name="diagnostic143"></a>   
+## <a name="143-x509certificateclaimsetfindclaims-considers-all-claimtypes"></a>143: X509CertificateClaimSet.FindClaims すべて claimTypes を考慮します。  
+  
+|||  
+|-|-|  
+|詳細|アプリで .NET Framework 4.6.1、対象とする場合は、SAN フィールド内の複数の DNS エントリを含む証明書から身元証明データ セットが初期化される、X509 FindClaims メソッドしようと claimType 引数のすべての DNS エントリと一致します。<br /><br /> 以前のバージョンの .NET Framework を対象とするアプリの場合は、FindClaims メソッドは、最後の DNS エントリとのみ claimType 引数との照合を試みます。|  
+|提案される解決策|この変更には、.NET Framework 4.6.1 を対象とするアプリケーションのみに影響します。 この変更できないことがあります (場合に有効または対象とする事前&4;.6.1) で、 [DisableMultipleDNSEntries](https://msdn.microsoft.com/en-us/library/mt620030%28v=vs.110%29.aspx)互換性スイッチ。|  
+|スコープ|マイナー|  
+|バージョン|4.6.1|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%28System.String%2CSystem.String%29?displayProperty=fullName>|  
+|アナライザー|CD0143|  
+  
+<a name="diagnostic144"></a>   
+## <a name="144-applicationfiltermessage-no-longer-throws-for-re-entrant-implementations-of-imessagefilterprefiltermessage"></a>144: Application.FilterMessage が不要になった IMessageFilter.PreFilterMessage の再入可能な実装についてをスロー  
+  
+|||  
+|-|-|  
+|詳細|以前の .NET Framework 4.6.1、(Application.DoEvents を呼び出しても) 中、IMessageFilter.PreFilterMessage と Application.FilterMessage どのと呼ばれる AddMessageFilter または RemoveMessageFilter を呼び出すと、IndexOutOfRangeException が発生すると。<br /><br /> 以降、.NET Framework 4.6.1 を対象とするアプリケーションでは、この例外がスローされなく、および再入可能なフィルター上で述べたを使用できます。|  
+|提案される解決策|上記で説明した、再入可能な IMessageFilter.PreFilterMessage 動作のために Application.FilterMessage をスローしないことに注意してください。 これには、.NET Framework 4.6.1 を対象とするアプリケーションのみに影響します。<br /><br /> .NET Framework 4.6.1 を対象とするアプリを解除できますこの変更 (またはアプリのターゲットの古いフレームワークにオプトイン可能性があります) を使用して、 [DontSupportReentrantFilterMessage](https://msdn.microsoft.com/en-us/library/mt620032%28v=vs.110%29.aspx)互換性スイッチ。|  
+|スコープ|エッジ|  
+|バージョン|4.6.1|  
+|型|再ターゲット中|  
+|影響を受ける Api|<xref:System.Windows.Forms.Application.FilterMessage%28System.Windows.Forms.Message%40%29?displayProperty=fullName>|  
+|アナライザー|CD0144|  
+  
+<a name="diagnostic145"></a>   
+## <a name="145-currentculture-is-not-preserved-across-wpf-dispatcher-operations"></a>145: WPF ディスパッチャー操作 CurrentCulture は維持されません  
+  
+|||  
+|-|-|  
+|詳細|以降、.NET Framework 4.6 では、内で行われたか、CurrentCulture、CurrentUICulture への変更、[ディスパッチャー](https://msdn.microsoft.com/en-us/library/system.windows.threading.dispatcher%28v=vs.110%29.aspx)はそのディスパッチャー操作の最後に失われます。 同様に、CurrentCulture または CurrentUICulture ディスパッチャー操作外で行われた変更が反映されないことと操作が実行されます。<br /><br /> 実際には、つまり、CurrentCulture と CurrentUICulture の変更が、WPF の UI のコールバックと WPF アプリケーションでは、その他のコードの間でフロー可能性があります。<br /><br /> これは変更されるため、 [ExecutionContext](https://msdn.microsoft.com/en-us/library/system.threading.executioncontext%28v=vs.110%29.aspx) CurrentCulture と CurrentUICulture は、.NET Framework 4.6 を対象とするアプリで始まる実行コンテキストに格納される原因となった。 WPF ディスパッチャー操作では、操作を開始し、操作が完了したときに、以前のコンテキストを復元するために使用する実行コンテキストを格納します。 CurrentCulture と CurrentUICulture がそのコンテキストの一部に今すぐためディスパッチャー操作内でそれに対する変更は、操作の外部で保持されません。|  
+|提案される解決策|アプリがこの変更によって影響を受ける可能性があることによって回避目的 CurrentCulture を格納するまたは currentuiculture の各フィールドにしてすべてのディスパッチャー操作で確認する、正しい CurrentCulture と CurrentUICulture が設定されている (UI イベントのコールバック ハンドラー) を含む本文。 します。 または、ExecutionContext を変更する基になるため、この WPF 変更では、.NET Framework 4.6 以降を対象とするアプリのみに影響、.NET Framework 4.5.2 を対象とするでは、この中断を回避できます。|  
+|スコープ|マイナー|  
+|バージョン|4.6|  
+|型|再ターゲット中|  
+|アナライザー|CD0145|
\ No newline at end of file
diff --git a/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md
new file mode 100644
index 00000000000..4aa08d6c163
--- /dev/null
+++ b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md
@@ -0,0 +1,62 @@
+---
+title: ".NET Framework 4.5.1 における再ターゲットの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8087326d-77e9-4804-ba33-ff1bb1bec2b8
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework 4.5.1 における再ターゲットの変更点
+まれに、変更を再ターゲットすると [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象として再コンパイルされるアプリに影響する場合があります。 これらは、以前のバージョンの .NET Framework を対象とするバイナリには影響を与えませんが、Version 4.5.1 で実行されるバイナリには影響します。[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] には、次の領域の変更の再ターゲットが含まれます。  
+  
+-   [コア](#Core)  
+  
+-   [ADO.NET](#ADO)  
+  
+-   [MSBuild](#MSBuild)  
+  
+ 次の表の \[スコープ\] 列には、各変更の重要度を指定します。  
+  
+-   メジャー。 多数のアプリに影響するか、またはコードに大幅な変更が必要な、重大な変更。 変更の再ターゲットはこのカテゴリに分類されないことに注意してください。  
+  
+-   マイナー。 少数のアプリに影響するか、またはコードにわずかな変更が必要な、変更。  
+  
+-   エッジ。 一般的ではない特定のシナリオでアプリに影響を与える変更。  
+  
+-   透過。 アプリの開発者やユーザーには大きな影響を及ぼさない変更。 アプリはこの変更のために変更を加える必要はありません。  
+  
+<a name="Core"></a>   
+## コアでの変更の再ターゲット  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.ObsoleteAttribute?displayProperty=fullName> 属性|Windows メタデータ ライブラリ \(.winmd ファイル\) を作成するとき、<xref:System.ObsoleteAttribute> 属性は <xref:System.ObsoleteAttribute> および [Windows.Foundation.DeprecatedAttribute](http://msdn.microsoft.com/library/windows/apps/windows.foundation.metadata.deprecatedattribute.aspx) の両方としてエクスポートされます。|<xref:System.ObsoleteAttribute> 属性を使用する既存のソース コードの再コンパイルが C\+\+\/CX または JavaScript からそのコードを実行すると警告が生成されることがあります。<br /><br /> <xref:System.ObsoleteAttribute> と [Windows.Foundation.DeprecatedAttribute](http://msdn.microsoft.com/library/windows/apps/windows.foundation.metadata.deprecatedattribute.aspx) の両方をマネージ アセンブリのコードに適用することはお勧めしません。ビルド警告が表示されることがあります。<br /><br /> 詳細については、<xref:System.ObsoleteAttribute> のリファレンス トピックを参照してください。|エッジ|  
+  
+<a name="ADO"></a>   
+## ADO.NET での変更の再ターゲット  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Data.Common.DbParameter?displayProperty=fullName> クラス|<xref:System.Data.Common.DbParameter.Precision%2A?displayProperty=fullName> および <xref:System.Data.Common.DbParameter.Scale%2A?displayProperty=fullName> はパブリック仮想プロパティとして実装されます。 これらは、対応する明示的なインターフェイス実装、<xref:System.Data.Common.DbParameter.System%23Data%23IDbDataParameter%23Precision%2A?displayProperty=fullName> と <xref:System.Data.Common.DbParameter.System%23Data%23IDbDataParameter%23Scale%2A?displayProperty=fullName> を置き換えます。|変更は、ADO.NET データベース プロバイダーをビルドする開発者にのみ影響します。|エッジ|  
+  
+<a name="MSBuild"></a>   
+## MSBuild での変更の再ターゲット  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|`ResolveAssemblyReference` タスク|タスクは警告 MSB3270 を生成します。これは参照または依存関係がアプリのアーキテクチャと一致しないことを示します。 たとえば、`anycpu` オプションでコンパイルされたアプリに x86 参照が含まれる場合に発生します。 このようなシナリオは、実行時にアプリでエラーが起こった場合に発生することがあります \(この場合は、アプリが x64 プロセスとして配置されている場合\)。|影響には 2 つの領域があります。<br /><br /> -   再コンパイルすると、アプリが MSBuild の以前のバージョンでコンパイルされたときには現れなかった警告が生成されます。 ただし、警告はランタイム エラーの可能性のある原因を特定するため、調査と対処が必要です。<br />-   警告がエラーとして扱われると、アプリはコンパイルされません。|マイナー|  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-2.md b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-2.md
new file mode 100644
index 00000000000..524d03cf7f8
--- /dev/null
+++ b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-2.md
@@ -0,0 +1,43 @@
+---
+title: ".NET Framework 4.5.2 における再ターゲットの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2be2a828-9052-4738-a965-d4a836cc6384
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Framework 4.5.2 における再ターゲットの変更点
+まれに、変更を再ターゲットすると .NET Framework 4.5.2 を対象として再コンパイルされるアプリに影響する場合があります。 次の表で別途指定がない限り、これらの変化は、以前のバージョンの .NET Framework を対象とするものの、Version 4.5.2 で実行されるバイナリには影響を与えません。 .NET Framework 4.5.2 には、次の領域の変更の再ターゲットが含まれます。  
+  
+-   [Entity Framework](#EF)  
+  
+-   [Windows フォーム](#WinForms)  
+  
+<a name="EF"></a>   
+## Entity Framework の変更の再ターゲット  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|並べ替えられていない制限操作を使用する際のより単純なクエリ|最初に `JOIN` を使用せずに <xref:System.Data.Objects.ObjectQuery%601.OrderBy%2A> ステートメントを生成し、制限操作への呼び出しを含むクエリは、より単純な SQL を生成します。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] へのアップグレード後、これらのクエリは以前のバージョンよりも複雑な SQL を生成しました。|既定では、この機能は無効です。 Entity Framework がパフォーマンスを低下させる追加の `JOIN` ステートメントを生成する場合は、アプリケーション構成 \(app.config\) ファイルの `<appSettings>` セクションへ次のエントリを追加してこの機能を有効にできます。<br /><br /> `<add key="EntityFramework_SimplifyLimitOperations" value="true" />`|マイナー|  
+  
+<a name="WinForms"></a>   
+## Windows フォームの変更の再ターゲット  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Windows.Forms.DataObject.GetData%2A?displayProperty=fullName> メソッドを使用してクリップボードからデータを HTML 形式で取得する|[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を対象とするアプリまたは .NET Framework 4.5.1 以前のバージョンで実行されるアプリでは、<xref:System.Windows.Forms.DataObject.GetData%2A?displayProperty=fullName> は HTML 形式のデータを ASCII 文字列として取得します。 結果として、非 ASCII 文字 \(ASCII コードが 0x7F よりも大きい文字\) は 2 つのランダムな文字で表されます。 たとえば、「é \(0xE9\)」は「é \(0xC3 0xA9\)」により表されます。<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降を対象とするアプリまたは .NET Framework 4.5.2 で実行されるアプリでは、<xref:System.Windows.Forms.DataObject.GetData%2A?displayProperty=fullName> は HTML 形式のデータを UTF\-8 として取得します。これは、0x7F よりも大きい文字を正しく表しています。|HTML 形式の文字列を使用するエンコーディングの問題に対する回避策 \(例: クリップボードから取得した HTML 文字列を <xref:System.Text.UTF8Encoding.GetString%2A?displayProperty=fullName> メソッドに渡して明示的にエンコードすること\) を実装し、アプリをバージョン 4 から 4.5 へ再ターゲットしている場合は、その回避策を削除する必要があります。|マイナー|  
+  
+## 参照  
+ [ランタイムの変更点](../../../docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-2.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md
new file mode 100644
index 00000000000..0456ae95462
--- /dev/null
+++ b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6-1.md
@@ -0,0 +1,43 @@
+---
+title: ".NET Framework 4.6.1 における再ターゲットの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 411ad548-30fa-43da-8716-10eccfc839e6
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# .NET Framework 4.6.1 における再ターゲットの変更点
+まれに、変更を再ターゲットすると [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象として再コンパイルされるアプリに影響する場合があります。 別途指定がない限り、これらの変更が、以前のバージョンの .NET Framework をターゲットとし、かつ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されているバイナリに影響を与えることはありません。  
+  
+ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] には、次の領域の変更の再ターゲットが含まれます。  
+  
+-   [Windows Communication Foundation](#WCF)  
+  
+-   [Windows フォーム](#WinForms)  
+  
+<a name="WCF"></a>   
+## Windows Communication Foundation  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%2A?displayProperty=fullName><br /><br /> \(<xref:System.IdentityModel.Claims> 名前空間\)|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とするアプリで、X509 クレーム セットが、SAN フィールドに複数の DNS エントリが含まれている証明書から初期化される場合、<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%2A> メソッドは `claimType` 引数をすべての DNS エントリと一致させようとします。<br /><br /> 以前のバージョンの .NET Framework を対象としたアプリでは、<xref:System.IdentityModel.Claims.X509CertificateClaimSet.FindClaims%2A> メソッドは `claimType` 引数と最後の DNS エントリのみを一致させようとします。|この変更は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象としたすべてのアプリに影響を与えます。 以前のバージョンの .NET Framework を対象とするアプリには影響しません。<br /><br /> ただし、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とするアプリではこの動作を無効にすることができます。 さらに、以前のバージョンの .NET Framework を対象とするアプリが [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されている場合、この動作を選択することができます。 詳細については、「[軽減策: X509CertificiateClaimSet.FindClaims メソッド](../../../docs/framework/migration-guide/mitigation-x509certificateclaimset-findclaims-method.md)」を参照してください。|マイナー|  
+  
+<a name="WinForms"></a>   
+## Windows フォーム  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Windows.Forms.Application.FilterMessage%2A?displayProperty=fullName> メソッド \(<xref:System.Windows.Forms> 名前空間\)|[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とする Windows フォーム アプリでは、カスタムの <xref:System.Windows.Forms.IMessageFilter.PreFilterMessage%2A?displayProperty=fullName> 実装は、<xref:System.Windows.Forms.IMessageFilter.PreFilterMessage%2A?displayProperty=fullName> 実装が次の場合に <xref:System.Windows.Forms.Application.FilterMessage%2A?displayProperty=fullName> メソッドが呼び出されると、メッセージを安全にフィルター処理することができます。<br /><br /> <ul><li>次の操作のいずれか、または両方を行う場合:<br /><br /> <ul><li><xref:System.Windows.Forms.Application.AddMessageFilter%2A> メソッドを呼び出してメッセージ フィルターを追加する。</li><li><xref:System.Windows.Forms.Application.RemoveMessageFilter%2A> メソッドを呼び出してメッセージ フィルターを削除する。 メソッドをオーバーライドします。</li></ul></li><li>**なおかつ**、<xref:System.Windows.Forms.Application.DoEvents%2A?displayProperty=fullName> メソッドを呼び出してメッセージをポンプする場合。</li></ul><br /> 以前のバージョンの .NET Framework を対象とする Windows フォーム アプリでは、このような実装で、<xref:System.Windows.Forms.Application.FilterMessage%2A?displayProperty=fullName> メソッドが呼び出されると <xref:System.IndexOutOfRangeException> 例外がスローされることがあります。|この変更は、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象としたすべてのアプリに影響を与えます。 以前のバージョンの .NET Framework を対象とするアプリには影響しません。<br /><br /> ただし、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] を対象とするアプリではこの動作を無効にすることができます。 さらに、以前のバージョンの .NET Framework を対象とするアプリが [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で実行されている場合、この動作を選択することができます。 詳細については、「[軽減策: カスタムの IMessageFilter.PreFilterMessage 実装](../../../docs/framework/migration-guide/mitigation-custom-imessagefilter-prefiltermessage-implementations.md)」を参照してください。|エッジ|  
+  
+## 参照  
+ [4.6.1 でのアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md
new file mode 100644
index 00000000000..3a860f0c736
--- /dev/null
+++ b/docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-6.md
@@ -0,0 +1,77 @@
+---
+title: ".NET Framework 4.6 における再ターゲットの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa849255-f90f-4bf1-b0ff-b173c12110d7
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# .NET Framework 4.6 における再ターゲットの変更点
+まれに、変更を再ターゲットすると [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を対象として再コンパイルされるアプリに影響する場合があります。 別途指定がない限り、これらの変更が、以前のバージョンの .NET Framework をターゲットとし、かつ [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で実行されているバイナリに影響を与えることはありません。  
+  
+ [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] には、次の領域の変更の再ターゲットが含まれます。  
+  
+-   [ASP.NET](#ASP)  
+  
+-   [ネットワーク](#Net)  
+  
+-   [Windows Communications Foundation \(WCF\)](#WCF)  
+  
+-   [Windows フォーム](#WinForms)  
+  
+-   [Windows Presentation Foundation \(WPF\)](#WPF)  
+  
+-   [XML](#XML)  
+  
+<a name="ASP"></a>   
+## ASP.NET  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Web.UI.HtmlTextWriterTag?displayProperty=fullName> の `tagKey` 値を使用する <xref:System.Web.UI.HtmlTextWriter.RenderBeginTag%28System.Web.UI.HtmlTextWriterTag%29?displayProperty=fullName>|HTML 標準に準拠して、<xref:System.Web.UI.HtmlTextWriter.RenderBeginTag%28System.Web.UI.HtmlTextWriterTag%29?displayProperty=fullName> メソッドは <xref:System.Web.UI.HtmlTextWriterTag?displayProperty=fullName> を HTML 応答の非終了タグとしてレンダリングします。|これで、BR タグは 1 つの改行を生成します。 以前は 2 つの改行が生成されていました。<br /><br /> `<BR>` タグを使用して 2 つの改行を生成するアプリでは、<xref:System.Web.UI.HtmlTextWriterTag?displayProperty=fullName> 引数を使用した <xref:System.Web.UI.HtmlTextWriter.RenderBeginTag%28System.Web.UI.HtmlTextWriterTag%29?displayProperty=fullName> メソッドの呼び出しを追加することで、以前の動作を復元できます。|マイナー|  
+  
+<a name="Net"></a>   
+## ネットワーク  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Net.ServicePointManager?displayProperty=fullName> および <xref:System.Net.Security.SslStream?displayProperty=fullName>|.NET Framework 4.6 以降を対象とするアプリでは、<xref:System.Net.ServicePointManager?displayProperty=fullName> および <xref:System.Net.Security.SslStream?displayProperty=fullName> クラスで Tls1.0、Tls1.1、または Tls 1.2 の 3 つのプロトコルのいずれかを使用できます。<br /><br /> NET Framework の以前のバージョンを対象とするアプリは、NET Framework 4.6 上で実行する場合でも、影響を受けません。|この変更は、.NET Framework 4.6 を対象とし、SSL を使用して <xref:System.Net.Http.HttpClient>、<xref:System.Net.HttpWebRequest>、<xref:System.Net.FtpWebRequest>、<xref:System.Net.Mail.SmtpClient>、<xref:System.Net.Security.SslStream> のいずれかのタイプで HTTPS サーバーまたはソケット サーバーと対話するすべてのアプリに影響します。  詳細については、「[軽減策: TLS プロトコル](../../../docs/framework/migration-guide/mitigation-tls-protocols.md)」を参照してください。|マイナー|  
+  
+<a name="WCF"></a>   
+## Windows Communications Foundation \(WCF\)  
+  
+|特性|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.IdentityModel.Policy.AuthorizationContext.CreateDefaultAuthorizationContext%2A?displayProperty=fullName>|`null` `authorizationPolicies` 引数を指定して <xref:System.IdentityModel.Policy.AuthorizationContext.CreateDefaultAuthorizationContext%28System.Collections.Generic.IList%7BSystem.IdentityModel.Policy.IAuthorizationPolicy%7D%29> を呼び出したときに返される <xref:System.IdentityModel.Policy.AuthorizationContext> の実装が [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で変更されました。|まれに、カスタム認証を使用する WCF アプリの動作に違いが生じる可能性があります。 以前の動作が必要な場合は、「[軽減策: 既定の AuthorizationContext](../../../docs/framework/migration-guide/mitigation-default-authorizationcontext.md)」をご覧ください。|マイナー|  
+  
+<a name="WinForms"></a>   
+## Windows フォーム  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Drawing.Icon.ToBitmap%2A?displayProperty=fullName>|.NET Framework 4.6 以降を対象にしたアプリでは、<xref:System.Drawing.Icon.ToBitmap%2A?displayProperty=fullName> メソッドで、PNG フレームを含んだアイコンを正常に <xref:System.Drawing.Bitmap> オブジェクトに変換できます。<br /><br /> .NET Framework 4.5.2 以前のバージョンを対象としたアプリでは、<xref:System.Drawing.Icon> オブジェクトに PNG フレームが含まれていると、<xref:System.Drawing.Icon.ToBitmap%2A?displayProperty=fullName> メソッドが <xref:System.ArgumentOutOfRangeException> の例外をスローします。|この変更は、.NET Framework 4.6 を対象として再コンパイルされたアプリのうち、<xref:System.Drawing.Icon> オブジェクトに PNG フレームが含まれている場合は <xref:System.ArgumentOutOfRangeException> 例外をスローするように特別な処理を実行するアプリに影響します。 この動作が望ましくない場合、構成スイッチで以前の動作を復元します。 詳細については、「[軽減策: Icon オブジェクトの PNG フレーム](../../../docs/framework/migration-guide/mitigation-png-frames-in-icon-objects.md)」を参照してください。|マイナー|  
+  
+<a name="WPF"></a>   
+## Windows Presentation Foundation \(WPF\)  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|高 DPI でのレイアウトの丸め処理|余白、境界線、およびそれらの内部の背景の丸め処理の方法が変更されました。|WPF コントロールのレイアウトが若干変化する可能性があります。 詳細については、「[軽減策: WPF レイアウト](../../../docs/framework/migration-guide/mitigation-wpf-layout.md)」を参照してください。|マイナー|  
+  
+<a name="XML"></a>   
+## XML  
+  
+|特性|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|XSD スキーマ検証|.NET Framework 4.6 以降では、複合キーが使用され、1 つのキーが空の場合、XSD スキーマ検証で一意制約の違反が検出されます。|「[軽減策: XML スキーマ検証](../../../docs/framework/migration-guide/mitigation-xml-schema-validation.md)」を参照してください。|マイナー|  
+|<xref:System.Xml.XmlWriter>|.NET Framework 4.5.2 またはそれ以前のバージョンをターゲットとするアプリケーションの場合、例外フォールバック処理を使用した無効なサロゲート ペアを作成しても、必ず例外がスローされるとは限りません。<br /><br /> [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] をターゲットとするアプリケーションでは、無効なサロゲート ペアを作成しようとすると、<xref:System.ArgumentException> の例外がスローされます。|[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] をターゲットとするように再コンパイルされたアプリケーションが、無効なサロゲート ペアを作成すると、これまでスローされなかった例外がスローされるようになります。|エッジ|
\ No newline at end of file
diff --git a/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md
new file mode 100644
index 00000000000..d628f33d77b
--- /dev/null
+++ b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-1.md
@@ -0,0 +1,61 @@
+---
+title: ".NET Framework 4.5.1 におけるランタイムの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーションの互換性"
+  - "ランタイムの変更点"
+  - ".NET Framework 4.5.1"
+ms.assetid: da880ad7-ba0a-4368-b340-705e3533c351
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework 4.5.1 におけるランタイムの変更点
+まれに、実行時の変更は [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] または 4.5 を対象とする既存のアプリに影響を与える可能性がありますが、4.51 ランタイムで実行されます。 次の領域の変更が含まれています。  
+  
+-   [コア](#Core)  
+  
+-   [Windows Communication Foundation (WCF)](#WCF)  
+  
+ 次の表の [スコープ] 列には、各変更の重要度を指定します。  
+  
+-   メジャー。 多数のアプリに影響するか、またはコードに大幅な変更が必要な、重大な変更。 ランタイムの変更はこのカテゴリに分類されないことに注意してください。  
+  
+-   マイナー。 少数のアプリに影響するか、またはコードにわずかな変更が必要な、変更。  
+  
+-   エッジ。 一般的ではない特定のシナリオでアプリに影響を与える変更。  
+  
+-   透過。 アプリの開発者やユーザーには大きな影響を及ぼさない変更。 アプリはこの変更のために変更を加える必要はありません。  
+  
+<a name="Core"></a>   
+## <a name="core-runtime-changes"></a>コアでのランタイム変更  
+  
+|機能|変更|影響|スコープ|  
+|-------------|------------|------------|-----------|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName>シリアル化</TKey, TValue>|A <xref:System.Collections.Concurrent.ConcurrentDictionary%602>と .NET Framework 4.5 でシリアル化されたオブジェクト、 <xref:System.Runtime.Serialization.NetDataContractSerializer>型の内部の変更のためにのみ、.NET Framework 4.5.1 と 4.5.2 で逆シリアル化できません\</TKey, TValue>。<br /><br /> この変更は*いない*次のシナリオに適用します。<br /><br /> A <xref:System.Collections.Concurrent.ConcurrentDictionary%602>オブジェクトは、.NET Framework 4.5 でシリアル化されで逆シリアル化、 [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]</TKey, TValue> 。 <xref:System.Runtime.Serialization.NetDataContractSerializer>で、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]オブジェクトを逆シリアル化することができます。<br /><br /> A <xref:System.Collections.Concurrent.ConcurrentDictionary%602>オブジェクトは、.NET Framework の以降のバージョンでシリアル化され、.NET Framework 4.5 で逆シリアル化します\</TKey, TValue>。 <xref:System.Runtime.Serialization.NetDataContractSerializer> .NET Framework 4.5 では、オブジェクトを逆シリアル化できません。<br /><br /> バージョン間のシリアル化および逆シリアル化、 <xref:System.Collections.Concurrent.ConcurrentDictionary%602> .NET Framework 4.5 の後に .NET Framework のバージョン間でのオブジェクト</TKey, TValue>。 この変更は、.NET Framework 4.5 でシリアル化オブジェクトに適用されます*のみ*します。|2 つの解決策が利用できるは、シリアル化する必要がある場合、 <xref:System.Collections.Concurrent.ConcurrentDictionary%602>オブジェクト、.NET Framework 4.5 および .NET Framework の以降のバージョンに逆シリアル化:\</TKey, TValue><br /><br /> 代替のシリアライザーを使用して、 <xref:System.Runtime.Serialization.DataContractSerializer>または<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>します。<br /><br /> アップグレード、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]の逆シリアル化をサポートする<xref:System.Collections.Concurrent.ConcurrentDictionary%602> .NET Framework 4.5 にシリアル化されたオブジェクト\</TKey, TValue>。|マイナー|  
+|<xref:System.Diagnostics.Tracing.EventListener?displayProperty=fullName>クラス|<xref:System.Diagnostics.Tracing.EventListener>埋め込み null ある文字列を切り捨てます。 は、null 文字はサポートされていない、 <xref:System.Diagnostics.Tracing.EventSource>クラスです。|使用するアプリケーションにのみ影響する変更<xref:System.Diagnostics.Tracing.EventListener>を読み取る<xref:System.Diagnostics.Tracing.EventSource>プロセス内のデータとは、区切り記号として null 文字を使用します。|エッジ|  
+|<xref:System.Diagnostics.Tracing.EventSource?displayProperty=fullName>クラス|ランタイムは、次を指定するコントラクトを強制するようになりました: から派生したクラス<xref:System.Diagnostics.Tracing.EventSource> ETW を定義するイベント メソッドは、基本クラスを呼び出す必要があります<xref:System.Diagnostics.Tracing.EventSource.WriteEvent%2A?displayProperty=fullName> ETW イベント メソッドに渡された同じ引数でイベント ID を持つメソッドの後にします。|<xref:System.IndexOutOfRangeException>例外がスローされます、 <xref:System.Diagnostics.Tracing.EventListener>読み取り<xref:System.Diagnostics.Tracing.EventSource>このコントラクトに違反するイベント ソースのプロセス内のデータです。<br /><br /> 参照してください[対応策: EventSource.WriteEvent メソッドの呼び出し](../../../docs/framework/migration-guide/mitigation-eventsource-writeevent-method-calls.md)|マイナー|  
+|アプリケーション ドメイン間でのオブジェクトの逆シリアル化|場合によっては、アプリが異なるアプリケーション ベースを持つ複数のアプリ ドメインを使用すると、アプリ ドメイン間で論理呼び出しコンテキストのオブジェクトを逆シリアル化しようとして、例外がスローされます。|この問題は、固有のシナリオで発生します。 詳細と対応策は、「[対応策: 逆シリアル化のオブジェクト間でのアプリ ドメイン](../../../docs/framework/migration-guide/mitigation-deserialization-of-objects-across-app-domains.md)します。|エッジ|  
+|<xref:System.IO.Stream.Dispose%2A?displayProperty=fullName>メソッド|[!INCLUDE[win8_appstore_long](../../../includes/win8-appstore-long-md.md)]アプリ、[!INCLUDE[wrt](../../../includes/wrt-md.md)]ストリームのアダプターを呼び出して、 <xref:System.IO.Stream.FlushAsync%2A>メソッドから、 <xref:System.IO.Stream.Dispose%2A>メソッドです。|この変更は透過的である必要があります。 開発者は次のようなコードを記述して以前の動作を復元できます。<br /><br /> `using (System.IO.Stream stream = GetWindowsRuntimeStream() As Stream)  {     // do something     await stream.FlushAsync();   }`|透過的|  
+  
+<a name="WCF"></a>   
+## <a name="windows-communication-foundation-wcf-runtime-changes"></a>Windows Communication Foundation (WCF) ランタイム変更  
+  
+|機能|変更|影響|スコープ|  
+|-------------|------------|------------|-----------|  
+|[minFreeMemoryPercentageToActiveService](http://msdn.microsoft.com/library/ms731336.aspx)構成の設定|WCF サービスがアクティブになる前にサーバーで使用できる必要のある最小限のメモリを設定します。 防ぐために設計されています<xref:System.OutOfMemoryException>例外です。 [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、この設定は影響しません。 [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] では、設定が確認されます。|Web サーバーで使用できる空きメモリが構成設定によって定義されたパーセンテージよりも小さい場合、例外が発生します。 制約されたメモリ環境で正常に開始し、実行された WCF サービスが今度は失敗することがあります。<br /><br /> 参照してください[対応策: minFreeMemoryPercentageToActiveService 構成の設定](../../../docs/framework/migration-guide/mitigation-minfreememorypercentagetoactiveservice-configuration-setting.md)します。|マイナー|  
+  
+## <a name="see-also"></a>関連項目  
+ [変更の再ターゲット](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-1.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-2.md b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-2.md
new file mode 100644
index 00000000000..4dc58e3f5af
--- /dev/null
+++ b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-5-2.md
@@ -0,0 +1,43 @@
+---
+title: ".NET Framework 4.5.2 におけるランタイムの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94ac01ea-8b12-44d2-b12b-5220a5d14d87
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Framework 4.5.2 におけるランタイムの変更点
+まれに、ランタイムの変更が、.NET Framework の以前のバージョンを対象とするものの、.NET Framework 4.5.2 ランタイムで実行される既存のアプリに影響を与える可能性があります。 次の領域の変更が含まれています。  
+  
+-   [ASP.NET](#ASP_NET)  
+  
+-   [Entity Framework](#EF)  
+  
+<a name="ASP_NET"></a>   
+## ASP.NET ランタイムの変更  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|[ページ要素](http://msdn.microsoft.com/ja-jp/4123bb66-3fe4-4d62-b70e-33758656b458)の `enableViewStateMac` 属性|ASP.NET では開発者による次の指定ができなくなりました。<br /><br /> `<pages enableViewStateMac="false" />`<br /><br /> または<br /><br /> `<@Page EnableViewStateMac="false" %>`|ビュー ステートのメッセージ認証コード \(MAC\) は、ビュー ステートが埋め込まれたすべての要求に強制されています。<xref:System.Web.UI.Page.EnableViewStateMac%2A> プロパティを明示的に `false` に設定するアプリだけが影響されます。<br /><br /> 詳細については、「[ビュー ステートのメッセージ認証コード \(MAC\) エラーの解決](http://support.microsoft.com/kb/2915218)」を参照してください。|Major|  
+  
+<a name="EF"></a>   
+## Entity Framework ランタイムの変更  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|QueryView での関係|クエリの一部として関連エンティティを含めようとする 0..1 ナビゲーション プロパティを使用して QueryView に関係するクエリをアプリが実行する場合 \(例: <xref:System.StackOverflowException> の呼び出し\) に、Entity Framework は `.Include(e=>e.RelatedNavProp)` 例外をスローしなくなります。|この変更は、`.Include` を呼び出すクエリの実行時に 1 \- 0..1 の関係にある QueryViews を使用するコードにのみ影響を与えます。 これにより信頼性が向上し、ほとんどすべてのアプリに対して透過的になります。 ただし、予期しない動作が発生する場合、次のエントリをアプリの構成ファイルの `<appSettings>` セクションに追加することにより、この変更を無効にできます。<br /><br /> `<add key="EntityFramework_SimplifyUserSpecifiedViews"  value="false" />`|エッジ|  
+  
+## 参照  
+ [再ターゲットの変更点](../../../docs/framework/migration-guide/retargeting-changes-in-the-net-framework-4-5-2.md)   
+ [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)   
+ [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6-1.md b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6-1.md
new file mode 100644
index 00000000000..e3119a83840
--- /dev/null
+++ b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6-1.md
@@ -0,0 +1,45 @@
+---
+title: ".NET Framework 4.6.1 におけるランタイムの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework のランタイム変更"
+  - ".NET Framework 4.6.1 のランタイム変更"
+  - "アプリケーションの互換性"
+ms.assetid: 9d97421c-5fee-4523-98c9-a158e7e6a1ee
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Framework 4.6.1 におけるランタイムの変更点
+まれに、ランタイムの変更が、.NET Framework の以前のバージョンをターゲットとするものの、それ以降のバージョンの .NET Framework ランタイムで実行される既存のアプリに影響を与える可能性があります。 また、異なる .NET Framework ランタイム環境で実行されるアプリケーション間での動作に違いが生じます。 [!INCLUDE[net_v461](../../../includes/net-v461-md.md)]次の領域の変更が含まれています。  
+  
+-   [Windows Communication Foundation (WCF)](#WCF)  
+  
+-   [Windows Presentation Foundation (WPF)](#WPF)  
+  
+<a name="WCF"></a>   
+## <a name="windows-communication-foundation-wcf"></a>Windows Communication Foundation (WCF)  
+  
+|機能|変更|影響|スコープ|  
+|-------------|------------|------------|-----------|  
+|WCF バインド、`TransportWithMessageCredential`セキュリティ モード|既定では、WCF のバインディングを使用して、`TransportWithMessageCredential`セキュリティ モードは、符号なしでメッセージを許可しない"to"非対称セキュリティ キーのヘッダー。 以降で実行されるアプリで、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]には署名しません"to"ヘッダー メッセージの送受信をこの要件が緩和することはできます。|これはオプトイン動作です。 符号なしの"to"ヘッダーを持つメッセージを許可する、次の構成設定を追加する、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)アプリの構成ファイルのセクション。<br /><br /> `<runtime>     <AppContextSwitchOverrides value="Switch.System.ServiceModel.AllowUnsignedToHeader=true" />  </runtime>`<br /><br /> これはオプトイン機能であるため、既存のアプリの動作に影響はないはずです。|エッジ|  
+  
+<a name="WPF"></a>   
+## <a name="windows-presentation-foundation-wpf"></a>Windows Presentation Foundation (WPF)  
+  
+|機能|変更|影響|スコープ|  
+|-------------|------------|------------|-----------|  
+|<xref:System.Windows.Controls.VirtualizingStackPanel?displayProperty=fullName>|ときに、 <xref:System.Windows.Controls.ItemsControl>仮想化を使用して、コレクションが表示されます (<xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A> = `true`) と項目スクロール (<xref:System.Windows.Controls.VirtualizingPanel.ScrollUnit%2A>=<xref:System.Windows.Controls.ScrollUnit?displayProperty=fullName>)、コントロールのスクロールの高さ (ピクセル単位) は、その近隣ノードによって異なります。 項目を表示するときと、 <xref:System.Windows.Controls.VirtualizingStackPanel?displayProperty=fullName>コレクション内のすべての項目を反復処理します。   この反復処理中には、UI が応答しません。 コレクションのサイズが大きい場合、ハングとこれに認識されることができます。<br /><br /> 前のリリースであっても、他の状況で発生したこのイテレーション、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]です。 ピクセル スクロールする場合に発生するなど (<xref:System.Windows.Controls.VirtualizingPanel.ScrollUnit%2A>=<xref:System.Windows.Controls.ScrollUnit?displayProperty=fullName>) 項目スクロールする場合に、別のピクセルの高さ、および項目を検出したときに階層データ (ようにこのような<xref:System.Windows.Controls.TreeView>コントロールまたは<xref:System.Windows.Controls.ItemsControl>とグループ化を有効になっている) 近隣ノードよりも下位の項目の数が異なる項目に遭遇するとします。<br /><br /> 項目のスクロールと別のピクセルの高さの場合、イテレーションがで導入された、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]階層データのレイアウトでバグを修正します。  データがフラットである場合は必要ありません (持ちません階層)、および[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]されないという点です。|イテレーションが発生した場合、 [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] --つまりの以前のリリースではなく場合、 <xref:System.Windows.Controls.ItemsControl>は項目のスクロール単純なリストに別のピクセルの高さ--の項目は、2 つの対応策。<br /><br /> インストール、 [.NET Framework 4.6.2](../../../docs/framework/install/guide-for-developers.md)します。<br /><br /> インストール[修正プログラム HR 1605](https://support.microsoft.com/en-us/kb/3154529)の[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]です。|マイナー|  
+  
+## <a name="see-also"></a>関連項目  
+ [4.6.1 アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md
new file mode 100644
index 00000000000..21ffa34452c
--- /dev/null
+++ b/docs/framework/migration-guide/runtime-changes-in-the-net-framework-4-6.md
@@ -0,0 +1,78 @@
+---
+title: ".NET Framework 4.6 におけるランタイムの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5262bcfa-6e48-416b-8972-69cb4002d386
+caps.latest.revision: 34
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# .NET Framework 4.6 におけるランタイムの変更点
+まれに、ランタイムの変更が、.NET Framework の以前のバージョンをターゲットとするものの、それ以降のバージョンの .NET Framework ランタイムで実行される既存のアプリに影響を与える可能性があります。 また、異なる .NET Framework ランタイム環境で実行されるアプリケーション間での動作に違いが生じます。 次の領域の変更が含まれています。  
+  
+-   [コア](#Core)  
+  
+-   [ネットワーク](#Networking)  
+  
+-   [Windows Presentation Foundation \(WPF\)](#WPF)  
+  
+-   [セットアップと配置](#Setup)  
+  
+-   [ClickOnce](#ClickOnce)  
+  
+-   [新しい 64 ビット JIT コンパイラ](#RyuJIT)  
+  
+<a name="Core"></a>   
+## コア  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Globalization.PersianCalendar?displayProperty=fullName>|[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以降では、<xref:System.Globalization.PersianCalendar> クラスはイスラム暦の太陽アルゴリズムを使用します。|イスラム暦の太陽アルゴリズムでは、イランとアフガニスタンで現在使用されているペルシャ暦と同じ結果が生成されます。 また、グレゴリオ暦の 1800 年からグレゴリオ暦の 2023 年の日付について、以前のアルゴリズムと同じ日付が生成されます。 この範囲外の日付については、<xref:System.Globalization.PersianCalendar> クラスを使用して日付を変換する \(たとえば、グレゴリオ暦の日付とペルシャ暦の日付の間で\) 場合や、特定の年がうるう年かどうかを決定する場合に影響を受けることがあります。<br /><br /> この変更を理由として、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] がインストールされているシステムで <xref:System.Globalization.PersianCalendar.MinSupportedDateTime%2A?displayProperty=fullName> プロパティの値が 0622 年 3 月 21 日から 0622 年 3 月 22 日に変更されました。<br /><br /> 詳細については、「<xref:System.Globalization.PersianCalendar>」を参照してください。|マイナー|  
+|<xref:System.Runtime.Versioning.TargetFrameworkAttribute>|既定のアプリケーション ドメインに関しては、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> プロパティの値は <xref:System.Runtime.Versioning.TargetFrameworkAttribute> が存在する場合にはこの属性から派生します。ただし、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> プロパティに対して名前が割り当てられて明示的に定義されている場合は除きます。  .NET Framework の以前のバージョンでは、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> 属性の値は `null` でした。ただし、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> プロパティでターゲット フレームワークを明示的に指定しないで、さまざまな特別なコード パスを実行したり、既定以外のアプリ ドメインを作成したりする場合は除きます。<br /><br /> 既定以外のアプリケーション ドメインの場合、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> プロパティの値の決定方法に変更はありません。<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> プロパティに明示的に値が割り当てられていない場合、既定以外のアプリ ドメインは既定のアプリケーション ドメインからターゲット フレームワークの名前を継承します。|既定のアプリケーション ドメインの場合、<xref:System.AppDomainSetup.TargetFrameworkName%2A?displayProperty=fullName> はこれまでは `null` を返していましたが、null 以外の値を返すことあります。 これは、適切な動作です。|エッジ|  
+|<xref:System.Security.Cryptography.X509Certificates.X509Certificate2.ToString%28System.Boolean%29?displayProperty=fullName>|システムにインストールされている証明書が .NET Framework でサポートされていない場合、`verbose` 引数で `True` 値を渡すと有効な文字列が返されます。 .NET Framework の以前のバージョンでは、サポートされていない証明書の公開キーの情報にアクセスしようとすると、例外がスローされることがあります。|このメソッドは情報提供のみが目的で、ドキュメントは .NET Framework のバージョン間で出力に一貫性がない場合があることを示しています。 この変更が影響を及ぼすのは、`ToString(True)` メソッドを呼び出し、.NET Framework によってサポートされていない証明書がインストールされているアプリに対してのみです。 この変更で例外をスローするのではなく文字列を返すことにより、メソッドがより堅牢になっています。|エッジ|  
+|リフレクションと分散 COM \(DCOM\)|リフレクション オブジェクトはマネージ コードからアウト プロセス DCOM クライアントに渡されなくなりました。 以下の型が影響を受けます。<xref:System.Reflection.Assembly>; <xref:System.Reflection.MemberInfo> およびその派生型 \(<xref:System.Reflection.FieldInfo>、<xref:System.Reflection.MethodInfo><xref:System.Type>、<xref:System.Reflection.TypeInfo> を含む\); <xref:System.Reflection.MethodBody>; <xref:System.Reflection.Module>; <xref:System.Reflection.ParameterInfo>。|このオブジェクトの [IMarshal](http://msdn.microsoft.com/library/windows/desktop/dd542707.aspx) を呼び出すと `E_NOINTERFACE` が返されます。|マイナー|  
+  
+<a name="Networking"></a>   
+## ネットワーク  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|<xref:System.Net.Mime.ContentDisposition?displayProperty=fullName> クラスの日付と時刻の値。|[RFC822](http://www.ietf.org/rfc/rfc0822.txt) と [RFC2822](http://www.ietf.org/rfc/rfc2822.txt) に準拠するため、書式設定された日付と時刻の値には 2 桁の時刻が含まれるようになりました。 以前は、午前 10時 00分より前の時間は 1 桁で表されていました。|この変更は、次のような使用シナリオに影響します。<br /><br /> -   .NET Framework の異なるバージョン間でシリアル化された <xref:System.Net.Mime.ContentDisposition> オブジェクトの長さやハッシュ コードを比較する場合。<br />-   .NET Framework の異なるバージョン間で <xref:System.Net.Mime.ContentDisposition.ToString%2A> メソッドの戻り値または <xref:System.Net.Mime.ContentDisposition> 日付と時刻のプロパティ値の文字列表現を比較する場合。|マイナー|  
+  
+<a name="WPF"></a>   
+## Windows Presentation Foundation \(WPF\)  
+  
+|機能|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|マルチ モニターのシナリオにおけるウィンドウのレンダリング|マルチ モニターのシナリオでディスプレイの外部にウィンドウを拡張すると、ウィンドウ全体がクリッピングなしでレンダリングされます。|「[軽減策: WPF ウィンドウのレンダリング](../../../docs/framework/migration-guide/mitigation-wpf-window-rendering.md)」を参照してください。|マイナー|  
+|WPF テキスト対応コントロールのスペル チェック機能|プラットフォームのスペル チェック機能は入力言語リストに存在する言語でしか使用できないため、スペル チェック機能が Windows 10 での実行時に動作しないことがあります。|Windows 10 では、使用可能なキーボードのリストに言語を追加すると、対応するオンデマンド機能 \(FOD\) パッケージが自動的にダウンロードおよびインストールされ、スペル チェック機能が提供されます。 入力言語リストに言語を追加することで、スペル チェック機能がサポートされます。|マイナー|  
+  
+<a name="Setup"></a>   
+## セットアップと配置  
+  
+|特性|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|製品のバージョン管理|製品のバージョン管理が、.NET Framework の以前のリリース \(特に .NET Framework 4、4.5、4.5.1、および 4.5.2\) から変更されました。 詳細については、「[軽減策: 製品のバージョン管理](../../../docs/framework/migration-guide/mitigation-product-versioning.md)」を参照してください。|「[軽減策: 製品のバージョン管理](../../../docs/framework/migration-guide/mitigation-product-versioning.md)」を参照してください。|Medium|  
+  
+<a name="ClickOnce"></a>   
+## ClickOnce  
+  
+|特性|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|SHA\-256 コード署名証明書を使用して ClickOnce で発行されたアプリケーション。|[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] 以前のバージョンをターゲットとし、SHA\-256 証明書で署名された ClickOnce アプリは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降のバージョンに対するランタイム依存関係を持たなくなりました。|これまでは、SHA\-256 証明書を使用して [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] 以前のバージョンをターゲットとする ClickOnce アプリは、ターゲット システム上に [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降のバージョンが存在しなければなりませんでした。 そのため、存在しない場合はエラーが発生しました。 この変更により、その依存関係がなくなったので、[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] 以前のバージョンをターゲットとする ClickOnce アプリの署名にSAH\-256 証明書が使用できるようになりました。|マイナー|  
+  
+<a name="RyuJIT"></a>   
+## 新しい 64 ビット JIT コンパイラ  
+  
+|特性|変更|影響|スコープ|  
+|--------|--------|--------|----------|  
+|例外処理 \(`try` 領域から返す\)|前の JIT64 just\-in\-time コンパイラとは異なり、新しい 64 ビット JIT コンパイラでは、`try` 領域での IL [ret](http://msdn.microsoft.com/library/system.reflection.emit.opcodes.ret.aspx) 命令は許可されません。|ECMA 335 仕様により `try` 領域から戻ることは許可されておらず、そうした IL を生成する既知のマネージ コンパイラはありません。 ただし、JIT64 コンパイラは、リフレクション出力を使用して生成される場合にはこうした IL を実行します。|エッジ|
\ No newline at end of file
diff --git a/docs/framework/migration-guide/version-compatibility.md b/docs/framework/migration-guide/version-compatibility.md
new file mode 100644
index 00000000000..ec88d318c3d
--- /dev/null
+++ b/docs/framework/migration-guide/version-compatibility.md
@@ -0,0 +1,76 @@
+---
+title: ".NET Framework のバージョンの互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 4.5, 旧バージョンとの互換性"
+  - ".NET Framework の各バージョン, 互換性"
+  - ".NET Framework, バージョンの互換性"
+ms.assetid: 2f25e522-456a-48c3-8a53-e5f39275649f
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# .NET Framework のバージョンの互換性
+下位互換とは、プラットフォームの特定のバージョンで開発されたアプリが、そのプラットフォームの新しいバージョンでも実行できることを意味します。  .NET Framework では、下位互換性が最大限に高められています。.NET Framework のあるバージョンで記述されたソース コードは、.NET Framework の新しいバージョンでコンパイルでき、.NET Framework のあるバージョンで実行されるバイナリは、新しいバージョンの .NET Framework でも同じように動作します。  
+  
+<a name="Apps"></a>   
+## アプリのバージョンの互換性  
+ 既定では、アプリは、ビルド対象の .NET Framework のバージョンで実行されます。  そのバージョンが存在せず、アプリの構成ファイルにサポートされるバージョンが定義されていない場合は、.NET Framework 初期化エラーが発生することがあります。  この場合、アプリは実行できません。  
+  
+ アプリが実行される特定のバージョンを定義するには、1 つ以上の [\<supportedRuntime\>](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md) 要素をアプリの構成ファイルに追加します。  各 `<supportedRuntime>` 要素は、サポートされるランタイムのバージョンを示します。最初の要素で最も優先度の高いバージョンを、最後の要素で最も優先度の低いバージョンを指定します。  詳しくは、「[方法 : .NET Framework 4 または 4.5 をサポートするアプリケーションを構成する](../../../docs/framework/migration-guide/how-to-configure-an-app-to-support-net-framework-4-or-4-5.md)」をご覧ください。  
+  
+## コンポーネントのバージョンの互換性  
+ アプリは、それが実行される .NET Framework を制御できますが、コンポーネントは制御できません。  コンポーネントとクラス ライブラリは特定のアプリのコンテキストで読み込まれるので、アプリが実行されるバージョンの .NET Framework で自動的に実行されます。  
+  
+ この制限のため、互換性の保証は、コンポーネントにとって特に重要です。  .NET Framework 4 以降、コンポーネントに <xref:System.Runtime.Versioning.ComponentGuaranteesAttribute?displayProperty=fullName> 属性を適用することにより、複数のバージョンで想定されるコンポーネントの互換性の程度を指定できるようになりました。  ツールは、この属性を使用して、コンポーネントの将来のバージョンでの互換性保証の潜在的な違反を検出できます。  
+  
+## 下位互換性と .NET Framework 4.5  
+ .NET Framework 4.5 およびそのポイント リリースは、以前のバージョンの .NET Framework でビルドされたアプリと下位互換性があります。  つまり、旧バージョンの .NET Framework でビルドしたアプリとコンポーネントは、.NET Framework 4.5 で変更を行わずに動作します。  ただし、既定では、アプリは、開発された共通言語ランタイムのバージョンで動作するため、アプリを .NET Framework 4.5 で実行するには構成ファイルを提供する必要がある場合があります。  詳細については、この記事の前半に記載した「[アプリのバージョンの互換性](#Apps)」を参照してください。  
+  
+ 現実的には、この互換性は、.NET Framework のわずかな変更やプログラミング技法の変化によって損なわれている可能性があります。  たとえば、.NET Framework 4 でのパフォーマンスの向上によって、旧バージョンでは発生しなかった競合条件が顕在化する可能性があります。  同様に、.NET Framework アセンブリへのハードコーディングされたパスの使用、.NET Framework の特定のバージョンでの等値比較の実行、およびリフレクションの使用によるプライベート フィールドの値の取得は、下位互換性のない動作です。  さらに、各バージョンの .NET Framework には、バグの修正とセキュリティに関連する変更が含まれており、これらが一部のアプリとコンポーネントの互換性に影響する可能性があります。  
+  
+ アプリまたはコンポーネントが .NET Framework 4.5、4.5.1、4.5.2、4.6 で期待どおりに動作しない場合は、次のチェック リストを使用してください。  
+  
+-   これらのトピックで、アプリに影響する可能性がある変更を確認し、説明されている代替手段を適用します。  
+  
+    -   [.NET Framework 4 Migration Issues \(.NET Framework 4 への移行に関する問題\)](http://go.microsoft.com/fwlink/p/?LinkId=248212)  
+  
+    -   [4.5 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5.md)  
+  
+    -   [4.5.1 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-1.md)  
+  
+    -   [4.5.2 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-5-2.md)  
+  
+    -   [4.6 のアプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6.md)  
+  
+-   .NET Framework 1.1 アプリがある場合は、次のトピックも確認してください。  
+  
+    -   [Changes in .NET Framework 2.0 \(.NET Framework 2.0 の変更点\)](http://go.microsoft.com/fwlink/?LinkID=125263)  
+  
+    -   [Changes in .NET Framework 3.5 SP1 \(.NET Framework 3.5 SP1 の変更点\)](http://go.microsoft.com/fwlink/?LinkId=186989)  
+  
+-   .NET Framework 4.5 で実行するために既存のソース コードを再コンパイルしている場合、またはバージョン 4.5 をターゲットとするアプリまたはコンポーネントの新しいバージョンを既存のソース コード ベースから開発している場合は、「[クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md) 」で廃止された型とメンバーを確認し、説明されている回避策を適用します。  \(コンパイル済みのコードは、互換性のために残されている旧式の型とメンバーに対して引き続き実行されます\)。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] での変更によってアプリが正常に実行されないことが明らかになった場合は、「[ランタイム設定スキーマ](../../../docs/framework/configure-apps/file-schema/runtime/index.md)」を確認し、アプリの構成ファイルのランタイム設定を使用して以前の動作を復元できるかどうかを判断します。  
+  
+-   説明されていない問題が発生した場合は、[Microsoft Connect](http://go.microsoft.com/fwlink/?LinkID=154815) にバグを報告し、[netfxcf@microsoft.com](mailto:netfxcf@microsoft.com) にバグ番号を連絡してください。  
+  
+## 互換性と side\-by\-side 実行  
+ 問題に対する適切な代替手段が見つからない場合は、.NET Framework 4.5 は Version 1.1、2.0、および 3.5 と side\-by\-side で実行でき、Version 4 を置き換えるインプレース更新であることを思い出してください。  Version 1.1、2.0、3.5 を対象とするアプリでは、適切なバージョンの .NET Framework を対象コンピューターにインストールして、アプリを最良の環境で実行できます。  side\-by\-side 実行について詳しくは、「[side\-by\-side 実行](../../../docs/framework/deployment/side-by-side-execution.md)」を参照してください。  
+  
+## 参照  
+ [新機能](../../../docs/framework/whats-new/index.md)   
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)   
+ [アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)   
+ [Microsoft .NET Framework のサポート ライフ サイクル ポリシー](http://go.microsoft.com/fwlink/p/?LinkId=248212)   
+ [.NET Framework 4 の移行に関する問題](http://go.microsoft.com/fwlink/p/?LinkId=248212)
\ No newline at end of file
diff --git a/docs/framework/migration-guide/versions-and-dependencies.md b/docs/framework/migration-guide/versions-and-dependencies.md
new file mode 100644
index 00000000000..bf5784ab5b6
--- /dev/null
+++ b/docs/framework/migration-guide/versions-and-dependencies.md
@@ -0,0 +1,81 @@
+---
+title: ".NET Framework のバージョンおよび依存関係 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バージョン、.NET Framework"
+ms.assetid: f75a72de-e2f2-4a7a-9574-3f278684ea90
+caps.latest.revision: 122
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 118
+---
+# .NET Framework のバージョンおよび依存関係
+.NET Framework の各バージョンには、共通言語ランタイム \(CLR\)、基底クラス ライブラリ、およびその他のマネージ ライブラリが含まれています。 このトピックでは、.NET Framework の各バージョンの主要な機能について説明し、基になっている CLR のバージョンおよび関連する開発環境に関する情報と、Windows オペレーティング システムでインストールされる .NET Framework のバージョンを示します。  
+  
+> [!NOTE]
+>  .NET Framework のダウンロードとインストールの詳細については、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+ 次の表に、.NET Framework のバージョン履歴を要約し、各バージョンと Visual Studio、Windows、および Windows Server との関係を示します。 Visual Studio ではマルチターゲット機能が提供されているため、記載されている .NET Framework のバージョンに限定される必要はありません。  
+  
+ 新しい各バージョンの .NET Framework には、1 つ前のバージョンの機能が含まれると共に、新機能が追加されています。 CLR は独自のバージョン番号で識別されます。 .NET Framework のバージョン番号はリリースごとにインクリメントされますが、CLR のバージョンは必ずしもインクリメントされるわけではありません。 たとえば、.NET Framework 4、4.5、およびそれ以降のリリースには CLR 4 が含まれますが、.NET Framework 2.0、3.0、3.5 には CLR 2.0 が含まれます。 \(CLR の Version 3 はありません\)。  
+  
+ サポートされるオペレーティング システムの全一覧については、「[システム要件](../../../docs/framework/get-started/system-requirements.md)」を参照してください。 ダウンロードについては、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」を参照してください。 コンピューターにインストールされている .NET Framework のバージョンを確認する方法については、「[方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照してください。  
+  
+ 次の表では、**\[に含まれる\/Windows 上にインストール可能\]** 列と **\[に含まれる\/Windows Server 上にインストール可能\]** 列に \* のマークが付いているオペレーティング システム バージョンにインストールされる .NET Framework のバージョンは[コントロール パネルで有効にする](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)か \(Windows の場合\)、サーバー マネージャーを利用して有効にする \(Windows Server の場合\) 必要があります。  
+  
+|.NET Framework のバージョン|CLR バージョン|フィーチャー|Visual Studio バージョンに含まれる|✓ <br /> に含まれる \+ <br />Windows 上にインストール可能|✓ <br /> に含まれる \+ <br />Windows Server 上にインストール可能|インストールされた .NET バージョンを確認するには|  
+|---------------------------|---------------|------------|------------------------------|----------------------------------------|-----------------------------------------------|---------------------------------|  
+|.NET 4.6.2|4|-   暗号化の機能強化。FIS 186\-3 DSA を含む X509 証明書のサポート、保存されたキーの対称暗号化のサポート、SHA\-2 のハッシュの <xref:System.Security.Cryptography.Xml.SignedXml> サポートが含まれます。また、ECDiffieHellman キー派生ルーチンへの入力がわかりやすくなりました。<br />-   For Windows Presentation Foundation \(WPF\) アプリ、ソフト キーボードのサポート、モニターごとの DPI。<br />-   TLS 1.1 プロトコルと TLS 1.2 プロトコルの ClickOnce サポート。<br />-   Windows フォームおよび WPF アプリの UWP アプリへの変換のサポート。||✓  10 Anniversary Update<br /><br /> \+  10 の 11 月の更新プログラム<br /><br /> \+ 10<br />\+ 8.1<br />\+ 7|\+ 2012 R2<br />\+ 2012<br />\+ 2008 R2 SP1|`Release` DWORD を使用:<br /><br /> -   394802 \(Windows 10 Anniversary Update\)<br />-   394806 \(その他すべての OS バージョン\)<br /><br /> \(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|Net 4.6.1|4|-   ECDSA を含む X509 証明書のサポート<br />-   ADO.NET のハードウェア保護キーに対する「常に暗号化」のサポート<br />-   WPF におけるスペル チェック機能の向上<br />-   [増やす...](../../../docs/framework/whats-new/index.md)||✓  10 の 11 月の更新プログラム<br /><br /> \+ 10<br />\+ 8.1<br />\+ 8<br />\+ 7|\+ 2012 R2<br />\+ 2012<br />\+ 2008 R2 SP1|`Release` DWORD を使用:<br /><br /> -   394254 \(Windows 10 の 11 月の更新プログラム\)<br />-   394271 \(その他すべての OS バージョン\)<br /><br /> \(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|.NET 4.6|4|-   .NET ネイティブによるコンパイル<br />-   ASP.NET Core 5.0<br />-   イベント トレーシング機能の強化<br />-   ページのエンコーディングのサポート<br />-   [増やす...](../../../docs/framework/whats-new/index.md)|2015。ただし、一部の .NET ライブラリは、[NuGet](https://www.nuget.org/) から入手できます。 詳細については、「[.NET Framework および特別なリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)」を参照してください。|✓ 10<br />\+ 8.1<br />\+ 8<br />\+ 7<br />\+ Vista|\+ 2012 R2<br />\+ 2012<br />\+ 2008 R2 SP1<br />\+ 2008 SP2|`Release` DWORD を使用:<br /><br /> -   393295 \(Windows 10\)<br />-   393297 \(その他すべての OS バージョン\)<br /><br /> \(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|4.5.2|4|-   トランザクション システムと ASP.NET のための新しい API<br />-   Windows フォーム コントロールでのシステム DPI のサイズ変更<br />-   プロファイリングの機能強化<br />-   ETW およびストレス ログの改善<br />-   [増やす...](../../../docs/framework/whats-new/index.md)|\-|\+ 8.1<br />\+ 8<br />\+ 7<br />\+ Vista|\+ 2012 R2<br />\+ 2012<br />\+ 2008 R2 SP1<br />\+ 2008 SP2|`Release` DWORD を使用: 379893<br />\(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|4.5.1|4|-   Windows Phone ストア アプリのサポート<br />-   自動バインド リダイレクト<br />-   パフォーマンスとデバッグの改善<br />-   [増やす...](../../../docs/framework/whats-new/index.md)|2013|✓ 8.1<br />\+ 8<br />\+ 7<br />\+ Vista|✓ 2012 R2<br />\+ 2012<br />\+ 2008 R2 SP1<br />\+ 2008 SP2|`Release` DWORD を使用:<br /><br /> -   378675 \(Windows 8.1\)<br />-   378758 \(その他\)<br /><br /> \(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|4.5|4|-   Windows ストア アプリのサポート<br />-   WPF、WCF、WF、ASP.NET の更新<br />-   [増やす...](../../../docs/framework/whats-new/index.md)|2012|✓ 8<br />\+ 7<br />\+ Vista|✓ 2012<br />\+ 2008 R2 SP1<br />\+ 2008 SP2|`Release` DWORD を使用: 378389<br />\(「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照\)|  
+|4|4|-   拡張された基底クラス ライブラリ<br />-   ポータブル クラス ライブラリによるクロスプラットフォームでの開発<br />-   MEF、DLR、コード コントラクト<br />-   [増やす...](http://msdn.microsoft.com/library/ms171868\(v=vs.100\).aspx)|2010|\+ 7<br />\+ Vista|\+ 2008 R2 SP1<br />\+ 2008 SP2<br />\+ 2003|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+|3.5|2.0|-   AJAX 対応の Web サイト<br />-   LINQ<br />-   動的データ<br />-   [増やす...](http://msdn.microsoft.com/library/ms171868\(v=vs.90\).aspx)|2008|✓ 10✓ 8.1\*<br />✓ 8\*<br />✓ 7<br />\+ Vista|✓2008 R2 SP1\*<br />\+ 2012 R2<br />\+ 2012<br />\+ 2008 SP2<br />\+ 2003|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+|3.0|2.0|-   WPF、WCF、WF、CardSpace|\-|✓ Vista|✓ 2008 R2 SP1\*<br />✓ 2008 SP2\*<br />\+ 2003|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+|2.0|2.0|-   ジェネリック<br />-   ASP.NET の機能追加<br />-   [増やす...](http://msdn.microsoft.com/library/t357fb32\(v=vs.80\).aspx)|2005|\-|✓ 2008 R2 SP1<br />✓ 2008 SP2<br />✓ 2003|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+|1.1|1.1|-   ASP.NET と ADO.NET の更新<br />-   side\-by\-side 実行<br />-   [増やす...](http://msdn.microsoft.com/library/9wtde3k4\(v=vs.80\).aspx)|2003|\-|✓ 2003|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+|1.0|1.0|.NET Framework の最初のバージョン。|Visual Studio .NET|\-|\-|「[手順](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」を参照|  
+  
+ 一般に、コンピューターにインストールされている .NET Framework のバージョンはアンインストールしないでください。使用するアプリケーションが特定のバージョンに依存しており、バージョンが削除されると破損する可能性があるからです。 1 台のコンピューターに複数バージョンの .NET Framework を同時に読み込むことができます。 これは、以前のバージョンをアンインストールすることなく、.NET Framework をインストールできることを意味します。 詳細については、「[作業の開始](../../../docs/framework/get-started/index.md)」を参照してください。  
+  
+## .NET Framework 4.5 以降のバージョンをターゲットにして実行する  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] はコンピューターの [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を置き換えるインプレース更新であり、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] 4.5.2、4.6、4.6.1、4.6.2 は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のインプレース更新です。つまり、同じバージョンのランタイムを使用しますが、アセンブリのバージョンが更新され、新しい型とメンバーが含まれます。 これらの更新プログラムのいずれかをインストールした後、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] アプリ、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] アプリ、または [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] アプリは再コンパイルせずに実行を継続します。 ただし、逆はできません。 .NET Framework の新しいバージョンをターゲットとするアプリを .NET Framework の以前のバージョンで実行することは推奨されていません。 たとえば、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] をターゲットとするアプリを [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行することは推奨されていません。 次のガイドラインが適用されます。  
+  
+-   [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] では、プロジェクトのターゲット フレームワークとして [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を選択して \(これにより <xref:Microsoft.Build.Tasks.GetReferenceAssemblyPaths.TargetFrameworkMoniker%2A?displayProperty=fullName> プロパティが設定されます\)、プロジェクトを [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] アセンブリまたは実行可能ファイルとしてコンパイルします。 このアセンブリまたは実行可能ファイルは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、4.5.1、4.5.2、4.6、または 4.6.1 がインストールされているコンピューターで使用できます。  
+  
+-   Visual Studio で、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] をプロジェクトのターゲット フレームワークとして選択して \(これにより <xref:Microsoft.Build.Tasks.GetReferenceAssemblyPaths.TargetFrameworkMoniker%2A?displayProperty=fullName> プロパティが設定されます\)、プロジェクトを [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] アセンブリまたは実行可能ファイルとしてコンパイルできます。 このアセンブリまたは実行可能ファイルは [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] かそれ以降のバージョンの .NET Framework がインストールされているコンピューターでのみ実行する必要があります。[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象とする実行可能ファイルは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] など、初期バージョンの .NET Framework のみがインストールされたコンピューターでは実行がブロックされ、ユーザーに [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] のインストールを求めるメッセージが表示されます。 また、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] アセンブリは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] など、初期バージョンの .NET Framework を対象とするアプリから呼び出さないでください。  
+  
+     ここで使用されている [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] と [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は単なる例にすぎません。 この原則は、実行されているシステムにインストールされているものより新しい .NET Framework のバージョンをターゲットにするアプリに適用されます。  
+  
+ .NET Framework の変更により、アプリケーション コードの変更が必要な場合があります。既存のアプリケーションを [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] またはそれ以降のバージョンで実行する前に、「[アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility.md)」を参照してください。 現行バージョンのインストールの詳細については、「[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)」を参照してください。 .NET Framework のサポートの詳細については、Microsoft サポート Web サイトの「[Microsoft .NET Framework のサポート ライフサイクル ポリシー](http://go.microsoft.com/fwlink/?LinkId=196607)」を参照してください。  
+  
+## 以前のバージョンのアプリの対象化と実行  
+ .NET Framework 2.0、3.0 および 3.5 は、同じバージョンの CLR \(CLR 2.0\) でビルドされています。 これらのバージョンは 1 つのインストールの連続したレイヤーを表します。 各バージョンは、以前のバージョンの上にインクリメンタル方式でビルドされます。 コンピューターでバージョン 2.0、3.0、および 3.5 を side\-by\-side で実行することはできません。 バージョン 3.5 をインストールすると、2.0 と 3.0 のレイヤーが自動的に取得され、バージョン 2.0、3.0、および 3.5 を対象としてビルドされたアプリケーションはすべて、バージョン 3.5 で実行できます。 ただし、.NET Framework 4 でこのレイヤーのアプローチは終了しています。 NET Framework 4 以降では、インプロセスの side\-by\-side ホスティングを使用して、1 つのプロセスで複数のバージョンの CLR を実行できます。 詳細については、「[アセンブリと side\-by\-side 実行](../../../docs/framework/app-domains/assemblies-and-side-by-side-execution.md)」を参照してください。  
+  
+ さらに、アプリケーションがバージョン 2.0、3.0、または 3.5 を対象とする場合、ユーザーがアプリケーションを実行する前に、[!INCLUDE[win8](../../../includes/win8-md.md)] または [!INCLUDE[win81](../../../includes/win81-md.md)] のコンピューター上で .NET Framework 3.5 を有効にするように求められる場合があります。 詳細については、「[Windows 8 以降のバージョンへの .NET Framework 3.5 のインストール](../../../docs/framework/install/net-framework-3-5-on-windows-8-plus.md)」を参照してください。  
+  
+## 次の手順  
+  
+-   .NET Framework での経験がない場合は、[概要](../../../docs/framework/get-started/overview.md)を参照して、主な概念と機能の概要を確認してください。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] とそのポイント リリースでの新機能と機能強化については、「[新機能](../../../docs/framework/whats-new/index.md)」を参照してください。  
+  
+-   .NET Framework 4 から [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] およびそのポイント リリースへのアプリの移行に関する詳細については、「[移行ガイド](../Topic/Migration%20Guide%20to%20the%20.NET%20Framework%204.6%20and%204.5%20.md)」を参照してください。  
+  
+-   コンピューターにどのバージョンまたは更新プログラムがインストールされているかを判別する方法については、「[方法 : インストールされている .NET Framework バージョンを確認する](../../../docs/framework/migration-guide/how-to-determine-which-versions-are-installed.md)」と「[方法 : インストールされている .NET Framework の更新プログラムを確認する](../../../docs/framework/migration-guide/how-to-determine-which-net-framework-updates-are-installed.md)」を参照してください。  
+  
+## 参照  
+ [バージョンの互換性](../../../docs/framework/migration-guide/version-compatibility.md)   
+ [Microsoft .NET Framework のサポート ライフサイクル ポリシー](http://go.microsoft.com/fwlink/?LinkId=196607)   
+ [トラブルシューティング](../../../docs/framework/install/troubleshoot-blocked-installations-and-uninstallations.md)
\ No newline at end of file
diff --git a/docs/framework/misc/TOC.md b/docs/framework/misc/TOC.md
new file mode 100644
index 00000000000..f8c64b905a9
--- /dev/null
+++ b/docs/framework/misc/TOC.md
@@ -0,0 +1,18 @@
+# [メソッド アクセスの保護](securing-method-access.md)
+# [部分信頼コードからのライブラリの使用](using-libraries-from-partially-trusted-code.md)
+# [方法 : サンドボックスで部分信頼コードを実行する](how-to-run-partially-trusted-code-in-a-sandbox.md)
+# [セキュリティとシリアル化](security-and-serialization.md)
+# [リンク確認要求](link-demands.md)
+# [コード アクセス セキュリティ](code-access-security.md)
+# [<binding>](binding.md)
+# [透過的セキュリティ コード、レベル 1](security-transparent-code-level-1.md)
+# [透過的セキュリティ コード](security-transparent-code.md)
+# [コード アクセス セキュリティの基礎](code-access-security-basics.md)
+# [透過的セキュリティ コード、レベル 2](security-transparent-code-level-2.md)
+# [セキュリティとパブリックの読み取り専用配列フィールド](security-and-public-read-only-array-fields.md)
+# [例外処理の保護](securing-exception-handling.md)
+# [Audio Property (My.Computer Object)](using-the-assert-method.md)
+# [ラッパー コードの保護](securing-wrapper-code.md)
+# [コード アクセス セキュリティ ポリシーの互換性と移行](code-access-security-policy-compatibility-and-migration.md)
+# [危険なアクセス許可とポリシー管理](dangerous-permissions-and-policy-administration.md)
+# [セキュリティとリモート処理の考慮事項](security-and-remoting-considerations.md)
diff --git a/docs/framework/misc/binding.md b/docs/framework/misc/binding.md
new file mode 100644
index 00000000000..2cf98bebb0d
--- /dev/null
+++ b/docs/framework/misc/binding.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;binding&gt; | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 666183d6-4d1f-45c7-ac64-bdf93ee8f36f
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# &lt;binding&gt;
+`binding` 要素を使用して、Windows Communication Foundation \(WCF\) によって提供される異なる型の定義済みバインディングを構成できます。  
+  
+## システム指定のバインディング  
+ システム指定のバインディングは、WCF メッセージ スタックの複雑さを隠蔽します。  システム指定のバインディングを使用しているアプリケーションは、スタックを完全に制御する必要はありません。  システム指定の各バインディングに公開される属性は、バインディングが処理する使用シナリオに最適な属性です。  
+  
+ システム指定の各バインディングの構成セクションは、バインディングの構成に使用される複数の構成を定義できます。  各構成は、一意の名前によって識別されます。  
+  
+ 要素または属性をシステム指定のバインディングに追加することはできません。  追加するには、このトピックの「カスタム バインディング」セクションで説明するように、カスタム バインディングを実装する必要があります。  システム指定のバインディングを完全に再現し、ユーザー アプリケーションで制御するいくつかの設定を追加するカスタム バインディングを定義できます。  
+  
+## カスタム バインディング  
+ カスタム バインディングを使用すると、WCF メッセージ スタックのフル コントロールが可能になります。  個別のバインディングは、メッセージ スタックを、スタック要素の構成要素をスタックに出現する順序で指定することにより定義します。  各要素は、スタック内の 1 つの要素を定義および構成します。  各カスタム バインディング内の `transport` 要素は 1 つだけにする必要があります。  この要素がない場合、メッセージ スタックは不完全です。  
+  
+ 要素がスタックに出現する順序は重要です。それは、その順序で操作がメッセージに適用されるためです。  スタック要素で推奨される順序を次に示します。  
+  
+1.  トランザクション \(省略可能\)  
+  
+2.  リライアブル メッセージ機能 \(省略可能\)  
+  
+3.  セキュリティ \(省略可能\)  
+  
+4.  エンコーダー  
+  
+5.  Transport  
+  
+ カスタム バインディングは、`name` 属性によって識別されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.BindingsSection>   
+ <xref:System.ServiceModel.Channels.Binding>   
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ [バインディング](../../../docs/framework/wcf/bindings.md)   
+ [カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [\<customBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/misc/code-access-security-basics.md b/docs/framework/misc/code-access-security-basics.md
new file mode 100644
index 00000000000..b48028835c3
--- /dev/null
+++ b/docs/framework/misc/code-access-security-basics.md
@@ -0,0 +1,115 @@
+---
+title: "コード アクセス セキュリティの基礎 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "セキュリティ [.NET Framework], コード アクセス セキュリティ"
+ms.assetid: 4eaa6535-d9fe-41a1-91d8-b437cfc16921
+caps.latest.revision: 21
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# コード アクセス セキュリティの基礎
+共通言語ランタイムに対応するすべてのアプリケーション \(つまりすべてのマネージ アプリケーション\) は、そのランタイムのセキュリティ システムと対話する必要があります。 マネージ アプリケーションのホストは、そのアプリケーションの起動時に、アプリケーションに対して一連のアクセス許可を付与します。 これらのアクセス許可は、ホストのローカル セキュリティ設定、またはアプリケーションが所属するサンドボックスによって決まります。 これらのアクセス許可に応じて、そのアプリケーションが正常に実行されるか、またはセキュリティ例外が生成されます。  
+  
+ デスクトップ アプリケーションの既定のホストでは、コードが完全な信頼を付与されて実行されます。 このため、アプリケーションの実行対象がデスクトップである場合は、アプリケーションに無制限のアクセス許可セットが付与されます。 その他のホストまたはサンドボックスでは、アプリケーションに対して制限付きのアクセス許可セットが付与されます。 アクセス許可セットはホストごとに異なる場合があるため、アプリケーションの設計時には、対象ホストで許可されているアクセス許可だけを使用するように注意する必要があります。  
+  
+ 共通言語ランタイムに対応した有効なアプリケーションを作成するためには、次に示すコード アクセス セキュリティの概念を把握しておく必要があります。  
+  
+-   **タイプ セーフ コード**: タイプ セーフ コードとは、適切に定義された、許可されている方法でのみ、型にアクセスするコードのことです。 たとえば、有効なオブジェクト参照を例として考えると、タイプ セーフ コードは、実際のフィールド メンバーに対応する固定オフセットが指すメモリ位置にアクセスできます。 オブジェクトがパブリックに公開するフィールドに属しているメモリの範囲外の、任意のオフセットが指すメモリ位置にアクセスするコードは、タイプ セーフとは言えません。 コードがコード アクセス セキュリティを活用できるようにするには、検証可能なタイプ セーフ コードを生成するコンパイラを使用する必要があります。 詳細については、このトピックで後述する「[検証可能なタイプ セーフ コードの作成](#typesafe_code)」を参照してください。  
+  
+-   **強制構文と宣言構文**: 共通言語ランタイムに対応したコードは、アクセス許可を要求したり、呼び出し元が指定のアクセス許可を持つことを確認要求したり、特定のセキュリティ設定をオーバーライドしたりする \(十分な権限がある場合\) ことにより、セキュリティ システムと対話できます。 .NET Framework セキュリティ システムとプログラムによって対話するには、宣言構文および強制構文という 2 つの形式の構文を使用します。 宣言的な呼び出しは属性を使用して実行され、強制的な呼び出しはコード内のクラスの新しいインスタンスを使用して実行されます。 呼び出しには、強制的にだけ実行できるもの、宣言的にだけ実行できるもの、およびどちらの方法でも実行できるものがあります。  
+  
+-   **安全なクラス ライブラリ**: 安全なライブラリとは、セキュリティ確認要求を使用して、そのライブラリの呼び出し元がライブラリにより公開されるリソースへのアクセス許可を持つことを確認するクラス ライブラリのことです。 たとえば、安全なクラス ライブラリにファイルを作成するメソッドがある場合、このメソッドにアクセスする呼び出し元には、ファイルを作成するためのアクセス許可が必要です。 .NET Framework は、安全なクラス ライブラリで構成されています。 作成するコードで使用するすべてのライブラリについて、アクセスするために必要なアクセス許可を確認する必要があります。 詳しくは、このトピックで後述する「[安全なクラス ライブラリの使用](#secure_library)」というセクションをご覧ください。  
+  
+-   **透過的なコード**: [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、必要なアクセス許可を確認するだけでなく、コードをセキュリティ透過 コードとして実行する必要があるかどうかも確認する必要があります。 セキュリティ透過コードは、セキュリティが重要な型またはメンバーを呼び出すことができません。 この規則は、完全に信頼されているアプリケーションと、部分的に信頼されたアプリケーションの両方に対して適用されます。 詳細については、「[透過的セキュリティ コード](../../../docs/framework/misc/security-transparent-code.md)」を参照してください。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+<a name="typesafe_code"></a>   
+## 検証可能なタイプ セーフ コードの作成  
+ JIT \(Just\-in\-time\) コンパイルでは、検証プロセスが実行され、コードが調べられてタイプ セーフかどうかが判断されます。 検証の結果タイプ セーフであることが証明されたコードは、*検証可能なタイプ セーフ コード*と呼ばれます。 検証プロセスやコンパイラに制約があるために検証可能なタイプ セーフ コードではなくても、コードがタイプ セーフである場合があります。 タイプ セーフではない言語もあり、Microsoft Visual C\+\+ などの一部の言語コンパイラは、検証可能なタイプ セーフ マネージ コードを生成できません。 使用している言語コンパイラが検証可能なタイプ セーフ コードを生成するかどうかを確認するには、そのコンパイラのドキュメントを参照してください。 特定の言語構成要素を使用しない場合にだけ検証可能なタイプ セーフ コードを生成する言語コンパイラを使用する場合は、[PEVerify ツール](../../../docs/framework/tools/peverify-exe-peverify-tool.md)を使用して、作成したコードが検証可能なタイプ セーフ コードかどうかを確認できます。  
+  
+ 検証可能なタイプ セーフ コード以外のコードは、セキュリティ ポリシーによって検証を省略することを許可されている場合にだけ、実行を試行できます。 ただし、タイプ セーフは、アセンブリを分離するためのランタイムの機構において重要な要素であるため、コードがタイプ セーフの規則に違反している場合には、信頼度の高いセキュリティを確保することはできません。 既定では、タイプ セーフでないコードは、その発生元がローカル コンピューターである場合にだけ実行できます。 したがって、モバイル コードはタイプ セーフであることが必要です。  
+  
+<a name="secure_library"></a>   
+## 安全なクラス ライブラリの使用  
+ 作成したコードが、クラス ライブラリにより要求されるアクセス許可を要求し、そのアクセス許可を与えられた場合には、そのコードからライブラリにアクセスでき、ライブラリが公開するリソースは承認されていないアクセスから保護されます。 コードが適切なアクセス許可を持っていない場合には、そのコードはクラス ライブラリにアクセスできないため、悪意のあるコードがそのコードを利用して保護されたリソースに間接的にアクセスすることもできません。 作成したコードを呼び出す他のコードも、ライブラリへのアクセス許可が必要になります。 アクセス許可がない場合は、作成したコードの実行も制限されます。  
+  
+ コード アクセス セキュリティを使用しても開発者によるコードの記述エラーがなくなるわけではありません。 ただし、保護されているリソースにアクセスするときにアプリケーションが安全なクラス ライブラリを使用していれば、クラス ライブラリでセキュリティの問題が発生する可能性がないかどうかが詳しく調べられるため、アプリケーション コードに対するセキュリティ リスクも軽減されます。  
+  
+## 宣言セキュリティ  
+ 宣言セキュリティ構文は、[属性](../../../docs/standard/attributes/index.md)を使用して、コードの[メタデータ](../../../docs/standard/metadata-and-self-describing-components.md)にセキュリティ情報を配置します。 属性は、アセンブリ、クラス、またはメンバーの各レベルに適用でき、使用する要求、確認要求、オーバーライドの種類を示します。 要求は、共通言語ランタイムに対応するアプリケーションが、そのアプリケーションに必要なアクセス許可または必要ではないアクセス許可をランタイムのセキュリティ システムに通知するために使用します。 確認要求およびオーバーライドは、呼び出し元からリソースを保護できるようにしたり、既定のセキュリティ動作をオーバーライドしたりするために、ライブラリで使用されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、.NET Framework のセキュリティ モデルと用語に重要な変更が加えられています。 これらの変更について詳しくは、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」をご覧ください。  
+  
+ 宣言セキュリティ呼び出しを行う前に、アクセス許可オブジェクトの状態データを、必要な特定形式のアクセス許可を表すように初期化する必要があります。 組み込みの各アクセス許可は、開発者が実行するセキュリティ操作の種類を示す <xref:System.Security.Permissions.SecurityAction> 列挙として渡される属性を持っています。 しかし、アクセス許可は、それぞれに固有のパラメーターも受け入れます。  
+  
+ コードの呼び出し元がカスタム アクセス許可 `MyPermission` を持つことを要求する宣言構文の例を次のコード片に示します。 このアクセス許可は架空のカスタム許可であり、.NET Framework には実在しません。 この例では、宣言呼び出しはクラス定義の直前に配置されており、このカスタム アクセス許可がクラス レベルで適用されることを示しています。 属性には **SecurityAction.Demand** 構造体が渡され、このコードを実行するには、呼び出し元にこのアクセス許可が与えられている必要があることを指定しています。  
+  
+```vb  
+<MyPermission(SecurityAction.Demand, Unrestricted = True)> Public Class MyClass1 Public Sub New() 'The constructor is protected by the security call. End Sub Public Sub MyMethod() 'This method is protected by the security call. End Sub Public Sub YourMethod() 'This method is protected by the security call. End Sub End Class  
+  
+```  
+  
+```csharp  
+[MyPermission(SecurityAction.Demand, Unrestricted = true)] public class MyClass { public MyClass() { //The constructor is protected by the security call. } public void MyMethod() { //This method is protected by the security call. } public void YourMethod() { //This method is protected by the security call. } }  
+```  
+  
+## 強制セキュリティ  
+ 強制セキュリティ構文は、呼び出す対象のアクセス許可オブジェクトの新しいインスタンスを作成することによって、セキュリティ呼び出しを実行します。 強制構文を使用して確認要求とオーバーライドは実行できますが、要求は実行できません。  
+  
+ セキュリティ呼び出しを行う前に、アクセス許可オブジェクトの状態データを、必要な特定形式のアクセス許可を表すように初期化する必要があります。 たとえば <xref:System.Security.Permissions.FileIOPermission> オブジェクトを作成するときに、コンストラクターを使用して、すべてのファイルに対する無制限のアクセス権、またはファイルへのアクセス禁止を表すように **FileIOPermission** オブジェクトを初期化できます。 または、別の **FileIOPermission**  オブジェクトを使用して、このオブジェクトで表すアクセス権の種類 \(読み込み、追記、または書き込み\) と、このオブジェクトで保護するファイルを示すパラメーターを渡すこともできます。  
+  
+ 強制セキュリティ構文は、単一のセキュリティ オブジェクトを呼び出す他に、アクセス許可セット内のアクセス許可のグループを初期化するためにも使用できます。 たとえば、1 つのメソッドで複数のアクセス許可に対して[アサート](../../../docs/framework/misc/using-the-assert-method.md)呼び出しを確実に実行するためには、このテクニックが唯一の方法となります。 それには、<xref:System.Security.PermissionSet> クラスと <xref:System.Security.NamedPermissionSet> クラスを使用して、アクセス許可のグループを作成し、適切なメソッドを呼び出して必要なセキュリティ呼び出しを実行します。  
+  
+ 強制構文を使用して確認要求とオーバーライドは実行できますが、要求は実行できません。 アクセス許可の状態を初期化するために必要な情報を実行時にしか取得できない場合には、確認要求やオーバーライドを実行するときに、宣言構文の代わりに強制構文を使用します。 たとえば、呼び出し元に特定のファイルを読み取るためのアクセス許可が必要である場合に、読み取り対象のファイルの名前が実行時までわからないときには、強制確認要求を使用します。 また、条件を適用するかどうか、およびテストの結果に基づいてセキュリティ確認要求を実行するかどうかを実行時に決定する必要がある場合にも、宣言チェックの代わりに強制チェックを使用できます。  
+  
+ コードの呼び出し元がカスタム アクセス許可 `MyPermission` を持つことを要求する強制構文の例を次のコード片に示します。 このアクセス許可は架空のカスタム許可であり、.NET Framework には実在しません。`MyPermision` の新しいインスタンスが `MyMethod` で生成され、このメソッドだけをセキュリティ呼び出しで保護します。  
+  
+```vb  
+Public Class MyClass1 Public Sub New() End Sub Public Sub MyMethod() 'MyPermission is demanded using imperative syntax. Dim Perm As New MyPermission() Perm.Demand() 'This method is protected by the security call. End Sub Public Sub YourMethod() 'YourMethod 'This method is not protected by the security call. End Sub End Class  
+  
+```  
+  
+```csharp  
+public class MyClass { public MyClass(){ } public void MyMethod() { //MyPermission is demanded using imperative syntax. MyPermission Perm = new MyPermission(); Perm.Demand(); //This method is protected by the security call. } public void YourMethod() { //This method is not protected by the security call. } }  
+```  
+  
+## マネージ ラッパー クラスの使用  
+ ほとんどのアプリケーションおよびコンポーネント \(安全なライブラリ以外\) では、アンマネージ コードを直接呼び出さないでください。 直接呼び出すべきではないいくつかの理由があります。 コードによってアンマネージ コードが直接呼び出されると、多くの状況では実行が許可されません。コードでは、ネイティブ コードを呼び出すための高い信頼レベルが付与されていなければならないためです。 ポリシーに変更が加えられ、こうしたアプリケーションの実行が許可される場合、アプリケーションではほとんどすべての操作を自由に実行できるようになり、システムのセキュリティがかなり脆弱になる恐れがあります。  
+  
+ さらに、アンマネージ コードにアクセスできるアクセス許可があるコードは、アンマネージ API を呼び出すことによってほとんどすべての操作を実行できるようになる可能性もあります。 たとえば、アンマネージ コードを呼び出すアクセス許可があるコードがファイルにアクセスするには、<xref:System.Security.Permissions.FileIOPermission> は不要です。アンマネージ \(Win32\) ファイル API を直接呼び出すだけで、**FileIOPermission** を要求するマネージ ファイル API を迂回できます。 マネージ コードにアンマネージ コードを呼び出すアクセス許可があり、アンマネージ コードを実際に直接呼び出す場合、セキュリティ システムでは、ランタイムがアンマネージ コードに確実な制限を課すことができないため、セキュリティ制限の適用に信頼性が欠けることになります。  
+  
+ アンマネージ コードにアクセスすることが必要な操作をアプリケーションで実行する場合、必要な機能 をラップする信頼できるマネージ クラス \(存在する場合\) を使用してそうした操作をアプリケーションで実行しなければなりません。 安全なクラス ライブラリ内のラッパー クラスが既に存在する場合には、独自にラッパー クラスを作成しないでください。 ラッパー クラスでは、アンマネージ コードへの呼び出しが許可されるように高度な信頼が付与される必要があります。呼び出し元に適切なアクセス許可があることを確認要求する責任はラッパー クラスにあります。 ラッパー クラスを使用する場合、作成したコードで必要となるのは、ラッパー クラスが確認要求するアクセス許可を要求して付与することのみです。  
+  
+## 参照  
+ <xref:System.Security.PermissionSet>   
+ <xref:System.Security.Permissions.FileIOPermission>   
+ <xref:System.Security.NamedPermissionSet>   
+ <xref:System.Security.Permissions.SecurityAction>   
+ [Audio Property \(My.Computer Object\)](../../../docs/framework/misc/using-the-assert-method.md)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)   
+ [Code Access Security Basics](../../../docs/framework/misc/code-access-security-basics.md)   
+ [属性](../../../docs/standard/attributes/index.md)   
+ [メタデータと自己言及的なコンポーネント](../../../docs/standard/metadata-and-self-describing-components.md)
\ No newline at end of file
diff --git a/docs/framework/misc/code-access-security-policy-compatibility-and-migration.md b/docs/framework/misc/code-access-security-policy-compatibility-and-migration.md
new file mode 100644
index 00000000000..fb89fb10ed8
--- /dev/null
+++ b/docs/framework/misc/code-access-security-policy-compatibility-and-migration.md
@@ -0,0 +1,160 @@
+---
+title: "コード アクセス セキュリティ ポリシーの互換性と移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "CLR ポリシー移行"
+  - "ポリシー移行, 互換性"
+ms.assetid: 19cb4d39-e38a-4262-b507-458915303115
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# コード アクセス セキュリティ ポリシーの互換性と移行
+[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、コード アクセス セキュリティ \(CAS\) のポリシー部分は廃止されました。  その結果、廃止されたポリシーの種類とメンバーを[明示的](#explicit_use)に呼び出したり、\(他の種類およびメンバーを介して\) [暗黙的](#implicit_use)に呼び出したりすると、コンパイルの警告やランタイム例外が発生する可能性があります。  
+  
+ 以下のいずれかの方法で警告やエラーを回避できます。  
+  
+-   廃止された呼び出しに代わる [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の代替方法に[移行](#migration)します。  
+  
+     または  
+  
+-   [\<NetFx40\_LegacySecurityPolicy\> 構成要素](../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)を使用して、レガシーの CAS ポリシー動作を選択します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [明示的な使用](#explicit_use)  
+  
+-   [暗黙的な使用](#implicit_use)  
+  
+-   [エラーと警告](#errors_and_warnings)  
+  
+-   [移行: 廃止された呼び出しの代替方法](#migration)  
+  
+-   [互換性: CAS ポリシーのレガシー オプションを使用する](#compatibility)  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。  発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+<a name="explicit_use"></a>   
+## 明示的な使用  
+ 直接セキュリティ ポリシーを操作するメンバー、または CAS ポリシーをサンドボックス化することが必要なメンバーは廃止され、既定ではエラーを発生するようになりました。  
+  
+ 以下に例を示します。  
+  
+-   <xref:System.AppDomain.SetAppDomainPolicy%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.HostSecurityManager.DomainPolicy%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.Policy.PolicyLevel.CreateAppDomainLevel%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.LoadPolicyLevelFromString%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.LoadPolicyLevelFromFile%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.ResolvePolicy%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.ResolveSystemPolicy%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.ResolvePolicyGroups%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.PolicyHierarchy%2A?displayProperty=fullName>  
+  
+-   <xref:System.Security.SecurityManager.SavePolicy%2A?displayProperty=fullName>  
+  
+<a name="implicit_use"></a>   
+## 暗黙的な使用  
+ アセンブリの読み込みオーバーロードの中にはエラーを生成するものがあります。CAS ポリシーを暗黙的に使用することが原因です。  これらのオーバーロードはCAS ポリシーを解決するために <xref:System.Security.Policy.Evidence> パラメーターを取り、アセンブリにアクセス許可セットを提供します。  
+  
+ 以下に例をいくつか示します。  パラメーターとして <xref:System.Security.Policy.Evidence> を取るオーバーロードが廃止されました。  
+  
+-   <xref:System.Activator.CreateInstanceFrom%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.CreateInstanceFrom%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.CreateInstanceAndUnwrap%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.DefineDynamicAssembly%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.ExecuteAssemblyByName%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.Load%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>  
+  
+<a name="errors_and_warnings"></a>   
+## エラーと警告  
+ 廃止された種類とメンバーが使用されると、以下のエラー メッセージが生成されます。  <xref:System.Security.Policy.Evidence?displayProperty=fullName> 型自体は廃止されていないことに注意してください。  
+  
+ コンパイル時の警告:  
+  
+ `warning CS0618: '<API Name>' is obsolete: 'This method is obsolete and will be removed in a future release of the .NET Framework.  Please use <suggested alternate API>.  See <link> for more information.'`  
+  
+ 実行時の例外:  
+  
+ <xref:System.NotSupportedException>: `This method uses CAS policy, which has been obsoleted by the .NET Framework. In order to enable CAS policy for compatibility reasons, please use the <NetFx40_LegacySecurityPolicy> configuration switch. Please see <link> for more information.`  
+  
+<a name="migration"></a>   
+## 移行: 廃止された呼び出しの代替方法  
+  
+### アセンブリの信頼レベルの判別  
+ CAS ポリシーは多くの場合、アセンブリ、アプリケーション ドメインのアクセス許可セット、または信頼レベルを判断するために使用されます。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、セキュリティ ポリシーを解決する必要のない次の便利なプロパティが公開されています。  
+  
+-   <xref:System.Reflection.Assembly.PermissionSet%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.IsFullyTrusted%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.PermissionSet%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.IsFullyTrusted%2A?displayProperty=fullName>  
+  
+### アプリケーション ドメインのサンドボックス化  
+ 通常 <xref:System.AppDomain.SetAppDomainPolicy%2A?displayProperty=fullName> メソッドは、アプリケーション ドメイン内のアセンブリをサンド ボックス化するために使用します。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、このために <xref:System.Security.Policy.PolicyLevel> を使用する必要がないメンバーが公開されています。 詳しくは、「[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)」をご覧ください。  
+  
+### 部分的に信頼できるコードに対する安全なまたは適切なアクセス許可セットの決定  
+ 多くの場合ホストでは、ホストされているコードをサンドボックス化するための適切なアクセス許可を判別する必要があります。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] より前のバージョンでは、CAS ポリシーでは <xref:System.Security.SecurityManager.ResolvePolicy%2A?displayProperty=fullName> メソッドを使用してこれが行われていました。  代わりに、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では <xref:System.Security.SecurityManager.GetStandardSandbox%2A?displayProperty=fullName> メソッドが提供され、提供されている証拠に基づいて安全な標準のアクセス許可セットが返されます。  
+  
+### サンドボックス化以外のシナリオ: アセンブリ読み込みのオーバーロード  
+ アセンブリ読み込みオーバーロードを使用する目的は、アセンブリのサンドボックス化の代わりに、アセンブリ読み込みオーバーロードでないと使用できないパラメーターを指定することです。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降、<xref:System.Security.Policy.Evidence?displayProperty=fullName> オブジェクトをパラメーターとして必要としないアセンブリ読み込みオーバーロード \([AppDomain.ExecuteAssembly\(String, String\[\], Byte\<xref:System.AppDomain.ExecuteAssembly%28System.String%2CSystem.String%5B%5D%2CSystem.Byte%5B%5D%2CSystem.Configuration.Assemblies.AssemblyHashAlgorithm%29?displayProperty=fullName> など\) をこのシナリオで使用できます。  
+  
+ アセンブリをサンドボックス化する場合には、[AppDomain.CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29?displayProperty=fullName> オーバー ロードを使用します。  
+  
+<a name="compatibility"></a>   
+## 互換性: CAS ポリシーのレガシー オプションを使用する  
+ [\<NetFx40\_LegacySecurityPolicy\> 構成要素](../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)を使用すると、CAS レガシー ポリシーを使用するプロセスまたはライブラリを指定できます。  この要素を有効にすると、ポリシーと証拠のオーバーロードは、framework の以前のバージョンの場合と同様に動作します。  
+  
+> [!NOTE]
+>  CAS ポリシーの動作は特定のランタイム バージョンに固有なので、そのランタイム バージョンの CAS ポリシーを変更しても、別のバージョンの CAS ポリシーには影響しません。  
+  
+```  
+<configuration>  
+   <runtime>  
+      <NetFx40_LegacySecurityPolicy enabled="true"/>  
+   </runtime>  
+</configuration>  
+```  
+  
+## 参照  
+ [方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)
\ No newline at end of file
diff --git a/docs/framework/misc/code-access-security.md b/docs/framework/misc/code-access-security.md
new file mode 100644
index 00000000000..5718bfabdbd
--- /dev/null
+++ b/docs/framework/misc/code-access-security.md
@@ -0,0 +1,89 @@
+---
+title: "コード アクセス セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "呼び出し履歴"
+  - "コード アクセス セキュリティ"
+  - "付与 (アクセス許可の), コード アクセス セキュリティ"
+  - "悪意のあるコード"
+  - "モバイル コード セキュリティ"
+  - "名前付きアクセス許可セット, コード アクセス セキュリティ"
+  - "アクセス許可 [.NET Framework], コード アクセス セキュリティ"
+  - "セキュリティ [.NET Framework], コード アクセス セキュリティ"
+  - "スタック ウォーク"
+  - "信頼されるコード"
+  - "アンマネージ コード, コード アクセス セキュリティ"
+  - "ユーザー認証, コード アクセス セキュリティ"
+ms.assetid: 859af632-c80d-4736-8d6f-1e01b09ce127
+caps.latest.revision: 25
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# コード アクセス セキュリティ
+複雑にリンクされた現在のコンピューター システムには、多種多様な、多くの場合は不明なソースからコードが送信されてきます。  このようなコードは、電子メールに添付されていたり、文書に含まれていたり、インターネットからダウンロードされたりします。  ウイルスやワームのような悪意のあるコードによってコンピューター上のデータを破損または破壊され、時間的にも金銭的にも直接の被害を受けた経験のあるユーザーは少なくありません。  
+  
+ ほとんどのセキュリティ機構では、ログオン資格情報 \(通常はパスワード\) に基づいてユーザーに権限を与え、そのユーザーがアクセスできるリソース \(多くの場合はディレクトリとファイル\) を制限しています。  しかし、この方法では対処できないさまざまな問題が存在します。たとえば、ユーザーはさまざまなソースからコードを入手しますが、中には信頼できない入手先もあります。コードに、悪意のあるコードからねらわれやすいバグがあったり、脆弱性が潜んでいる可能性もあります。また、コードがユーザーの予期しない動作をする場合もあります。  これらの結果、ユーザーが慎重で信頼できるとしても、実行したソフトウェアが悪意のあるソフトウェアやエラーを含むソフトウェアであった場合は、コンピューター システムが損害を受けたり、機密データが漏洩したりする可能性があります。  多くのオペレーティング システムのセキュリティ機構では、Web ページ上のスクリプトなどの場合を除き、コードを実行するためには、その細部にわたるまで完全に信頼されていることが要求されます。  そのため、信頼関係のないコンピューター システム間でも、一方のシステムから送信されたコードをもう一方のシステムで安全に実行できるようにするための、幅広く適用できるセキュリティ機構が必要になります。  
+  
+ コンピューター システムを悪意のあるコードから簡単に保護できるようにしたり、発生元の不明なコードを安全に実行できるようにしたり、信頼されているコードを故意または過失によって露呈したセキュリティの脆弱性から保護できるようにしたりするために、.NET Framework はコード アクセス セキュリティというセキュリティ機構を提供しています。  コード アクセス セキュリティにより、コードの発生元や、そのコードの身元を示すその他の基準に基づいて、コードをさまざまなレベルで信頼できます。  また、コードに対してさまざまな信頼レベルを強制的に適用することにより、実行するために完全に信頼されていなければならないコードの数は少なくなります。  コード アクセス セキュリティを使用することで、作成したコードが悪意のあるコードやバグのあるコードによって誤用される可能性も低くなります。  コードによって実行できる一連の操作を指定できるため、開発者の責任を軽減できます。  コード アクセス セキュリティは、コードにセキュリティの脆弱性があった場合に、それによって被る可能性のある損害を最小限に抑えるためにも役立ちます。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] で、コード アクセス セキュリティ システムに大幅な変更が加えられています。  最も重要な変更点は、[透過的セキュリティ](../../../docs/framework/misc/security-transparent-code.md)の導入ですが、コード アクセス セキュリティに影響を及ぼす重要な変更は、このほかにもあります。  これらの変更については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+ コード アクセス セキュリティは、主にライブラリ コードと部分的に信頼されたアプリケーションに影響します。  ライブラリ開発者は、部分的に信頼されたアプリケーションによる認証されていないアクセスからコードを保護する必要があります。  部分的に信頼されたアプリケーションは、インターネットなどの外部リソースから読み込まれるアプリケーションです。  デスクトップまたはローカル イントラネットにインストールされているアプリケーションは、完全に信頼されたアプリケーションとして実行されます。  完全に信頼されたアプリケーションは、完全に信頼されているため、[セキュリティ透過的](../../../docs/framework/misc/security-transparent-code.md)とマークされている場合を除き、コード アクセス セキュリティの影響を受けません。  完全に信頼されたアプリケーションの唯一の制限事項は、<xref:System.Security.SecurityTransparentAttribute> 属性でマークされているアプリケーションは <xref:System.Security.SecurityCriticalAttribute> 属性でマークされているコードを呼び出すことができない点です。  部分的に信頼されたアプリケーションは、コード アクセス セキュリティを適用できるように、サンドボックス \(Internet Explorer など\) で実行する必要があります。  インターネットからアプリケーションをダウンロードし、デスクトップから実行しようとすると、<xref:System.NotSupportedException> が返されます。このとき、"ネットワーク上の場所からアセンブリの読み込みを試みました。以前のバージョンの .NET Framework では、これによりアセンブリがサンドボックス化されました。  このリリースの .NET Framework では CAS ポリシーが既定で有効ではないため、この読み込みは危険な場合があります。" というメッセージが表示されます。 アプリケーションを確実に信頼できる場合、そのアプリケーションは、[\<loadFromRemoteSources\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/loadfromremotesources-element.md)を使用して、完全に信頼されたアプリケーションとして実行できます。  アプリケーションをサンドボックス内で実行する方法の詳細については、「[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)」をご覧ください。  
+  
+ 共通言語ランタイムに対応したマネージ コードすべては、単一コード アクセス セキュリティ呼び出しを行わない場合でも、コード アクセス セキュリティの利点を享受することになります。  詳しくは、「[コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)」をご覧ください。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。  発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+<a name="key_functions"></a>   
+## コード アクセス セキュリティの主な機能  
+ コード アクセス セキュリティにより、コードがアクセスする対象を保護されたリソースと保護された操作に制限できます。  .NET Framework では、コード アクセス セキュリティは次の機能を果たします。  
+  
+-   各種システム リソースにアクセスするための権限や権限セットを定義する。  
+  
+-   呼び出し元が特定の権限を所有していることをコードから要求できるようにする。  
+  
+-   呼び出し元にデジタル署名があることをコード自身が要求できるようにします。これにより、特定の組織またはサイトからの呼び出し元だけが、保護されたコードを呼び出すことができます。  
+  
+-   呼び出し履歴上で、各呼び出し元に付与された権限を、その呼び出し元に求められる権限と比較することにより、コードに対する制限を実行時に強制する。  
+  
+<a name="walking_the_call_stack"></a>   
+## コール スタック ウォークの実行  
+ コードがリソースにアクセスしたり、操作を実行したりすることを許可されているかどうかを判断するために、ランタイムのセキュリティ システムはコール スタック ウォークを行い、コール スタック内の各呼び出し元に与えられているアクセス許可と、確認要求されているアクセス許可とを比較します。  コール スタックに、確認要求されたアクセス許可を持っていない呼び出し元があった場合は、セキュリティ例外がスローされ、アクセスは拒否されます。  スタック ウォークは、信頼レベルの低いコードが信頼レベルの高いコードを呼び出して利用し、承認されていないアクションを実行しようとする攻撃を防止できるようにするために実行します。  コードの呼び出し元すべてに対して実行時にアクセス許可を確認要求することは、確かにパフォーマンスに影響しますが、信頼レベルの低いコードによる攻撃からコードを保護できるようにするためには必要です。  パフォーマンスを最適化するためにコードが実行するスタック ウォークを減らすこともできますが、その場合は、セキュリティの脆弱性を露呈しないように常に注意する必要があります。  
+  
+ アセンブリ A4 のメソッドが、その呼び出し元にアクセス許可 P が与えられていることを確認要求する場合に、結果として行われるスタック ウォークを次の図に示します。  
+  
+ ![コード アクセス セキュリティ](../../../docs/framework/misc/media/slide-10a.gif "slide\_10a")  
+セキュリティ スタック ウォーク  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)|コード アクセス セキュリティとその最も一般的な使用方法について説明します。|  
+|[透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md)|[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] のセキュリティ透過モデルについて説明します。|  
+|[部分信頼コードからのライブラリの使用](../../../docs/framework/misc/using-libraries-from-partially-trusted-code.md)|ライブラリを有効にしてアンマネージ コードと共に使用できるようにする方法と、アンマネージ コードからライブラリを使用する方法について説明します。|  
+|[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)|.NET Framework セキュリティ システムで使用されるさまざまな重要用語と概念について、概要を示します。|  
+|[ロール ベース セキュリティ](../../../docs/standard/security/role-based-security.md)|ロールに基づいて、セキュリティを組み込む方法について説明します。|  
+|[暗号サービス](../../../docs/standard/security/cryptographic-services.md)|アプリケーションに暗号を組み込む方法について説明します。|
\ No newline at end of file
diff --git a/docs/framework/misc/dangerous-permissions-and-policy-administration.md b/docs/framework/misc/dangerous-permissions-and-policy-administration.md
new file mode 100644
index 00000000000..c31152bb037
--- /dev/null
+++ b/docs/framework/misc/dangerous-permissions-and-policy-administration.md
@@ -0,0 +1,52 @@
+---
+title: "危険なアクセス許可とポリシー管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, 危険なアクセス許可"
+  - "アクセス許可 [.NET Framework], 危険な"
+  - "アクセス許可 [.NET Framework], ポリシー管理"
+  - "安全なコーディング, 危険なアクセス許可"
+  - "セキュリティ [.NET Framework], 危険なアクセス許可"
+ms.assetid: 1929e854-23a0-4bb1-94be-e8aa3b609e32
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 危険なアクセス許可とポリシー管理
+.NET Framework がアクセス許可を提供する保護された操作のいくつかで、セキュリティ システムが回避されてしまう可能性があります。 これらの危険なアクセス許可は信頼できるコードにのみ付与し、その付与は必要な場合に限る必要があります。 これらのアクセス許可が付与されると、通常、悪意のあるコードに対する防御策はありません。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、.NET Framework のセキュリティ モデルと用語に重要な変更が加えられています。 これらの変更の詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+ 危険なアクセス許可については、次の表で説明します。  
+  
+|アクセス許可|潜在的なリスク|  
+|------------|-------------|  
+|<xref:System.Security.Permissions.SecurityPermission>||  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|マネージ コードからアンマネージ コードを呼び出せるようにしますが、これは大抵リスクを伴います。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|検証なしで、コードは何でも実行できます。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|無効な証拠でセキュリティ ポリシーをかいくぐることができます。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|セキュリティ ポリシーを変更する機能によって、セキュリティを無効にできます。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|シリアル化を使用して、ユーザー補助機能のメカニズムを回避できます。 詳細については、「[セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)」を参照してください。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|現行プリンシパルを設定する機能によって、ロール ベースのセキュリティを欺くことができます。|  
+|<xref:System.Security.Permissions.SecurityPermissionFlag>|スレッドにはセキュリティ状態が関連付けられているため、スレッドの操作は危険です。|  
+|<xref:System.Security.Permissions.ReflectionPermission>||  
+|<xref:System.MemberAccessException>|プライベート メンバーを使用して、ユーザー補助機能のメカニズムを無効にすることができます。|  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md b/docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md
new file mode 100644
index 00000000000..b6747e71122
--- /dev/null
+++ b/docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md
@@ -0,0 +1,293 @@
+---
+title: "方法 : サンドボックスで部分信頼コードを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, サンドボックス"
+  - "部分信頼"
+  - "部分的に信頼されるコード"
+  - "制限されたセキュリティ環境"
+  - "サンドボックス"
+ms.assetid: d1ad722b-5b49-4040-bff3-431b94bb8095
+caps.latest.revision: 27
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# 方法 : サンドボックスで部分信頼コードを実行する
+サンドボックス化は、制限されたセキュリティ環境でコードを実行する方法です。この方法を採用すると、コードに付与されるアクセス許可が制限されます。  たとえば、完全に信頼していない発行元のマネージ ライブラリは、完全信頼として実行しないようにする必要があります。  代わりに、必要なアクセス許可 \(<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可など\) のみを与えるサンドボックスにコードを配置します。  
+  
+ また、部分的に信頼された環境で実行する予定のコードについて、サンドボックスを使用してテストすることもできます。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。 .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。  発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+ <xref:System.AppDomain> を使用すると、マネージ アプリケーションのサンドボックスを効果的に提供できます。  部分信頼コードの実行時に使用するアプリケーション ドメインには、<xref:System.AppDomain> 内で実行する際に利用できる保護対象リソースを定義するアクセス許可が与えられます。  <xref:System.AppDomain> 内で実行されるコードは、<xref:System.AppDomain> に関連付けられているアクセス許可によって制約され、指定したリソースにのみアクセスできます。  また、<xref:System.AppDomain> には、完全信頼として読み込むアセンブリを特定する <xref:System.Security.Policy.StrongName> 配列も含まれます。  これによって <xref:System.AppDomain> の作成者は、新しいサンドボックス化されたドメインを開始して、特定のヘルパー アセンブリを完全信頼とすることができます。  アセンブリを完全信頼として読み込むには、グローバル アセンブリ キャッシュに配置する方法もあります。ただし、そのコンピューター上に作成されたすべてのアプリケーション ドメインに、アセンブリが完全信頼として読み込まれます。  厳密な名前の一覧は <xref:System.AppDomain> ごとに決定できるので、対象アセンブリのより限定的な指定が可能になります。  
+  
+ サンドボックスで実行するアプリケーションのアクセス許可セットを指定するには、[AppDomain.CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29?displayProperty=fullName> メソッド オーバーロードを使用します。  このオーバーロードを使用することで、コード アクセス セキュリティのレベルを希望どおりに設定できます。  このオーバーロードを使用して <xref:System.AppDomain> に読み込まれるアセンブリには、指定の許可セットのみを付与することもできますし、完全信頼を付与することもできます。  グローバル アセンブリ キャッシュ内のアセンブリ、または `fullTrustAssemblies` \(<xref:System.Security.Policy.StrongName>\) 配列パラメーターに列挙されているアセンブリには、完全信頼が付与されます。  完全に信頼できるアセンブリだけを `fullTrustAssemblies` リストに追加する必要があります。  
+  
+ オーバーロードは次のシグネチャを持ちます。  
+  
+```  
+AppDomain.CreateDomain( string friendlyName,  
+                        Evidence securityInfo,  
+                        AppDomainSetup info,  
+                        PermissionSet grantSet,  
+                        params StrongName[] fullTrustAssemblies);  
+```  
+  
+ [CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29> メソッド オーバーロードのパラメーターでは、<xref:System.AppDomain> の名前、<xref:System.AppDomain> の証拠、サンドボックスのアプリケーション ベースを指定する <xref:System.AppDomainSetup> オブジェクト、使用するアクセス許可セット、および完全に信頼されたアセンブリの厳密な名前を指定します。  
+  
+ セキュリティ上の理由から、`info` パラメーターに指定するアプリケーション ベースに、ホスト アプリケーションのアプリケーション ベースを指定することはできません。  
+  
+ `grantSet` パラメーターには、明示的に作成したアクセス許可セットを指定するか、<xref:System.Security.SecurityManager.GetStandardSandbox%2A> メソッドによって作成された標準アクセス許可セットを指定します。  
+  
+ 他の多くの <xref:System.AppDomain> 読み込みとは異なり、部分的に信頼されたアセンブリの許可セットの決定に \(`securityInfo` パラメーターで指定される\) <xref:System.AppDomain> の証拠は使用されません。  代わりに、`grantSet` パラメーターによって単独で指定されます。  ただし、分離ストレージのスコープの決定など、他の用途に証拠を使用できます。  
+  
+### サンドボックスでアプリケーションを実行するには  
+  
+1.  信頼関係のないアプリケーションに付与するアクセス許可セットを作成します。  付与できる最小限のアクセス許可は <xref:System.Security.Permissions.SecurityPermissionFlag> です。  また、信頼関係のないコードでも安全と考えられる追加のアクセス許可を付与することもできます。たとえば、<xref:System.Security.Permissions.IsolatedStorageFilePermission> などです。  次のコードでは、<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可のみを含む新しいアクセス許可セットを作成します。  
+  
+    ```  
+    PermissionSet permSet = new PermissionSet(PermissionState.None);  
+    permSet.AddPermission(new SecurityPermission(SecurityPermissionFlag.Execution));  
+    ```  
+  
+     また、"Internet" など、既存の名前付きアクセス許可セットを使用することもできます。  
+  
+    ```  
+    Evidence ev = new Evidence();  
+    ev.AddHostEvidence(new Zone(SecurityZone.Internet));  
+    PermissionSet internetPS = SecurityManager.GetStandardSandbox(ev);  
+    ```  
+  
+     証拠のゾーンに応じて、<xref:System.Security.SecurityManager.GetStandardSandbox%2A> メソッドは `Internet` アクセス許可セットまたは `LocalIntranet` アクセス許可セットを返します。  また、<xref:System.Security.SecurityManager.GetStandardSandbox%2A> は、参照として渡される一部の証拠オブジェクトの ID アクセス許可を構築します。  
+  
+2.  信頼関係のないコードを呼び出すホスト クラス \(この例では `Sandboxer`\) を含むアセンブリに署名します。  アセンブリの署名で使用した <xref:System.Security.Policy.StrongName> を、<xref:System.Security.Policy.StrongName> を呼び出す際の `fullTrustAssemblies` パラメーターに <xref:System.AppDomain.CreateDomain%2A> 配列として追加します。  部分信頼コードを実行できるようにする場合、または部分信頼アプリケーションにサービスを提供する場合は、ホスト クラスを完全信頼として実行する必要があります。  アセンブリの <xref:System.Security.Policy.StrongName> を読み取る方法は次のとおりです。  
+  
+    ```  
+    StrongName fullTrustAssembly = typeof(Sandboxer).Assembly.Evidence.GetHostEvidence<StrongName>();  
+    ```  
+  
+     mscorlib や System.dll などの .NET Framework アセンブリを完全信頼一覧に追加することはできません。グローバル アセンブリ キャッシュから完全信頼として読み込まれているためです。  
+  
+3.  <xref:System.AppDomain.CreateDomain%2A> メソッドの <xref:System.AppDomainSetup> パラメーターを初期化します。  このパラメーターを使用すると、新しい <xref:System.AppDomain> の多くの設定を制御できます。  <xref:System.AppDomainSetup.ApplicationBase%2A> プロパティは重要な設定なので、ホスト アプリケーションの <xref:System.AppDomain> の <xref:System.AppDomainSetup.ApplicationBase%2A> プロパティとは違う設定にする必要があります。  <xref:System.AppDomainSetup.ApplicationBase%2A> 設定が同じ場合、部分的に信頼されたアプリケーションは、ホスト アプリケーションが定義する例外を完全信頼として読み込み、それを悪用できるようになります。  これは、キャッシュ \(例外\) が推奨されないもう 1 つの理由です。  ホストのアプリケーション ベースと、サンドボックス アプリケーションのアプリケーション ベースを異なる設定にすると、悪用のリスクが軽減されます。  
+  
+    ```  
+    AppDomainSetup adSetup = new AppDomainSetup();  
+    adSetup.ApplicationBase = Path.GetFullPath(pathToUntrusted);  
+    ```  
+  
+4.  [CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29> メソッド オーバーロードを呼び出し、指定したパラメーターを使用してアプリケーション ドメインを作成します。  
+  
+     このメソッドのシグネチャは次のとおりです。  
+  
+    ```  
+    public static AppDomain CreateDomain(string friendlyName,   
+        Evidence securityInfo, AppDomainSetup info, PermissionSet grantSet,   
+        params StrongName[] fullTrustAssemblies)  
+    ```  
+  
+     追加情報:  
+  
+    -   これは、パラメーターとして <xref:System.Security.PermissionSet> を使用する <xref:System.AppDomain.CreateDomain%2A> メソッドの唯一のオーバーロードです。つまり、部分信頼設定でアプリケーションを読み込むことができる唯一のオーバーロードになります。  
+  
+    -   `evidence` パラメーターは、アクセス許可セットの計算では使用されません。このパラメーターは、.NET Framework の他の機能が識別目的で使用します。  
+  
+    -   このオーバーロードでは、`info` パラメーターの <xref:System.AppDomainSetup.ApplicationBase%2A> プロパティを必ず設定します。  
+  
+    -   `fullTrustAssemblies` パラメーターには `params` キーワードがあります。これは <xref:System.Security.Policy.StrongName> 配列を作成する必要がないことを示します。  パラメーターとして、0 個、1 個、または複数の厳密な名前を渡すことができます。  
+  
+    -   アプリケーション ドメインを作成するコードは次のとおりです。  
+  
+    ```  
+    AppDomain newDomain = AppDomain.CreateDomain("Sandbox", null, adSetup, permSet, fullTrustAssembly);  
+    ```  
+  
+5.  作成したサンドボックスの <xref:System.AppDomain> にコードを読み込みます。  これは、次の 2 つの方法で行うことができます。  
+  
+    -   アセンブリに対して <xref:System.AppDomain.ExecuteAssembly%2A> メソッドを呼び出します。  
+  
+    -   <xref:System.Activator.CreateInstanceFrom%2A> メソッドを使用して、<xref:System.MarshalByRefObject> から派生したクラスのインスタンスを新しい <xref:System.AppDomain> に作成します。  
+  
+     2 番目の方が望ましい方法です。新しい <xref:System.AppDomain> インスタンスにパラメーターを渡しやすいためです。  <xref:System.Activator.CreateInstanceFrom%2A> メソッドには 2 つの重要な機能があります。  
+  
+    -   アセンブリが保存されていない場所を示すコード ベースを使用できます。  
+  
+    -   <xref:System.Security.CodeAccessPermission.Assert%2A> の下で、完全信頼 \(<xref:System.Security.Permissions.PermissionState?displayProperty=fullName>\) で作成操作を実行できます。こうすることで、重要なクラスのインスタンスを作成できます。  \(この状況は、アセンブリに透過マーキングがなく、完全信頼として読み込まれるときに毎回発生します\)。 そのため、この関数で信頼するコードのみを作成する場合は注意が必要です。新しいアプリケーション ドメインに、完全信頼クラスのインスタンスのみを作成することをお勧めします。  
+  
+    ```  
+    ObjectHandle handle = Activator.CreateInstanceFrom(  
+    newDomain, typeof(Sandboxer).Assembly.ManifestModule.FullyQualifiedName,  
+           typeof(Sandboxer).FullName );  
+    ```  
+  
+     新しいドメインにクラスのインスタンスを作成するには、そのクラスで <xref:System.MarshalByRefObject> クラスを拡張する必要があります。  
+  
+    ```  
+    class Sandboxer:MarshalByRefObject  
+    ```  
+  
+6.  新しいドメイン インスタンスをこのドメイン内の参照にラップ解除します。  この参照は、信頼関係のないコードを実行するときに使用されます。  
+  
+    ```  
+    Sandboxer newDomainInstance = (Sandboxer) handle.Unwrap();  
+    ```  
+  
+7.  作成した `Sandboxer` クラスのインスタンスで、`ExecuteUntrustedCode` メソッドを呼び出します。  
+  
+    ```  
+    newDomainInstance.ExecuteUntrustedCode(untrustedAssembly, untrustedClass, entryPoint, parameters);  
+    ```  
+  
+     この呼び出しは、アクセス許可が制限されているサンドボックス アプリケーション ドメインで実行されます。  
+  
+    ```  
+    public void ExecuteUntrustedCode(string assemblyName, string typeName, string entryPoint, Object[] parameters)  
+        {  
+            //Load the MethodInfo for a method in the new assembly. This might be a method you know, or   
+            //you can use Assembly.EntryPoint to get to the entry point in an executable.  
+            MethodInfo target = Assembly.Load(assemblyName).GetType(typeName).GetMethod(entryPoint);  
+            try  
+            {  
+                // Invoke the method.  
+                target.Invoke(null, parameters);  
+            }  
+            catch (Exception ex)  
+            {  
+            //When information is obtained from a SecurityException extra information is provided if it is   
+            //accessed in full-trust.  
+                (new PermissionSet(PermissionState.Unrestricted)).Assert();  
+                Console.WriteLine("SecurityException caught:\n{0}", ex.ToString());  
+    CodeAccessPermission.RevertAssert();  
+                Console.ReadLine();  
+            }  
+        }  
+    ```  
+  
+     <xref:System.Reflection> を使用して、部分的に信頼されたアセンブリでメソッドのハンドルを取得します。  このハンドルは、最小限のアクセス許可を持つ安全な方法でコードを実行するために使用できます。  
+  
+     上記のコードでは、<xref:System.Security.SecurityException> を出力する前に完全信頼のアクセス許可の <xref:System.Security.PermissionSet.Assert%2A> があることがわかります。  
+  
+    ```  
+    new PermissionSet(PermissionState.Unrestricted)).Assert()  
+    ```  
+  
+     完全信頼アサートは、<xref:System.Security.SecurityException> から拡張情報を取得するために使用します。  <xref:System.Security.PermissionSet.Assert%2A> を使用しない場合、<xref:System.Security.SecurityException> の <xref:System.Security.SecurityException.ToString%2A> メソッドは、スタック上に部分的に信頼されたコードがあることを検出します。また、返される情報を制限します。  部分信頼コードがその情報を読み取ることができる場合、これによってセキュリティ上の問題が発生する可能性もありますが、<xref:System.Security.Permissions.UIPermission> を付与しないことでそのリスクは軽減されます。  完全信頼アサートは慎重に使用する必要があります。部分信頼コードが完全信頼に昇格できないことが確実である場合にのみ使用します。  通則として、信頼できないコードは、完全信頼のアサートを呼び出した後に同じ関数で呼び出すのは避ける必要があります。  アサートの使用を完了したときは、常にアサートを元に戻すことをお勧めします。  
+  
+## 使用例  
+ 次の例では、前のセクションの手順を実装しています。  この例では、Visual Studio ソリューションの `Sandboxer` というプロジェクトにも `UntrustedCode` というプロジェクトが含まれます。これはクラス `UntrustedClass` を実装します。  このシナリオでは、指定した数字がフィボナッチ数かどうかを示すために、`true` または `false` を返すことが期待されているメソッドを含むライブラリ アセンブリをダウンロードしたことを想定しています。  代わりに、このメソッドはコンピューターからのファイルの読み込みを試みます。  次の例は信頼関係のないコードを示します。  
+  
+```  
+using System;  
+using System.IO;  
+namespace UntrustedCode  
+{  
+    public class UntrustedClass  
+    {  
+        // Pretend to be a method checking if a number is a Fibonacci  
+        // but which actually attempts to read a file.  
+        public static bool IsFibonacci(int number)  
+        {  
+           File.ReadAllText("C:\\Temp\\file.txt");  
+           return false;  
+        }  
+    }  
+}  
+```  
+  
+ 次の例は、信頼関係のないコードを実行する `Sandboxer` アプリケーション コードを示します。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.IO;  
+using System.Security;  
+using System.Security.Policy;  
+using System.Security.Permissions;  
+using System.Reflection;  
+using System.Runtime.Remoting;  
+  
+//The Sandboxer class needs to derive from MarshalByRefObject so that we can create it in another   
+// AppDomain and refer to it from the default AppDomain.  
+class Sandboxer : MarshalByRefObject  
+{  
+    const string pathToUntrusted = @"..\..\..\UntrustedCode\bin\Debug";  
+    const string untrustedAssembly = "UntrustedCode";  
+    const string untrustedClass = "UntrustedCode.UntrustedClass";  
+    const string entryPoint = "IsFibonacci";  
+    private static Object[] parameters = { 45 };  
+    static void Main()  
+    {  
+        //Setting the AppDomainSetup. It is very important to set the ApplicationBase to a folder   
+        //other than the one in which the sandboxer resides.  
+        AppDomainSetup adSetup = new AppDomainSetup();  
+        adSetup.ApplicationBase = Path.GetFullPath(pathToUntrusted);  
+  
+        //Setting the permissions for the AppDomain. We give the permission to execute and to   
+        //read/discover the location where the untrusted code is loaded.  
+        PermissionSet permSet = new PermissionSet(PermissionState.None);  
+        permSet.AddPermission(new SecurityPermission(SecurityPermissionFlag.Execution));  
+  
+        //We want the sandboxer assembly's strong name, so that we can add it to the full trust list.  
+        StrongName fullTrustAssembly = typeof(Sandboxer).Assembly.Evidence.GetHostEvidence<StrongName>();  
+  
+        //Now we have everything we need to create the AppDomain, so let's create it.  
+        AppDomain newDomain = AppDomain.CreateDomain("Sandbox", null, adSetup, permSet, fullTrustAssembly);  
+  
+        //Use CreateInstanceFrom to load an instance of the Sandboxer class into the  
+        //new AppDomain.   
+        ObjectHandle handle = Activator.CreateInstanceFrom(  
+            newDomain, typeof(Sandboxer).Assembly.ManifestModule.FullyQualifiedName,  
+            typeof(Sandboxer).FullName  
+            );  
+        //Unwrap the new domain instance into a reference in this domain and use it to execute the   
+        //untrusted code.  
+        Sandboxer newDomainInstance = (Sandboxer) handle.Unwrap();  
+        newDomainInstance.ExecuteUntrustedCode(untrustedAssembly, untrustedClass, entryPoint, parameters);  
+    }  
+    public void ExecuteUntrustedCode(string assemblyName, string typeName, string entryPoint, Object[] parameters)  
+    {  
+        //Load the MethodInfo for a method in the new Assembly. This might be a method you know, or   
+        //you can use Assembly.EntryPoint to get to the main function in an executable.  
+        MethodInfo target = Assembly.Load(assemblyName).GetType(typeName).GetMethod(entryPoint);  
+        try  
+        {  
+            //Now invoke the method.  
+            bool retVal = (bool)target.Invoke(null, parameters);  
+        }  
+        catch (Exception ex)  
+        {  
+            // When we print informations from a SecurityException extra information can be printed if we are   
+            //calling it with a full-trust stack.  
+            (new PermissionSet(PermissionState.Unrestricted)).Assert();  
+            Console.WriteLine("SecurityException caught:\n{0}", ex.ToString());  
+            CodeAccessPermission.RevertAssert();  
+            Console.ReadLine();  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/link-demands.md b/docs/framework/misc/link-demands.md
new file mode 100644
index 00000000000..ca8c28858d9
--- /dev/null
+++ b/docs/framework/misc/link-demands.md
@@ -0,0 +1,64 @@
+---
+title: "リンク確認要求 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "呼び出し元のセキュリティ チェック"
+  - "コード アクセス セキュリティ, 要求"
+  - "要求されるアクセス許可"
+  - "付与 (アクセス許可の), 要求"
+  - "リンク確認要求"
+  - "アクセス許可 [.NET Framework], 要求"
+  - "セキュリティ [.NET Framework], 要求"
+  - "ユーザー要求 (アクセス許可に対する)"
+ms.assetid: a33fd5f9-2de9-4653-a4f0-d9df25082c4d
+caps.latest.revision: 18
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# リンク確認要求
+リンク確認要求では、Just\-In\-Time コンパイル時にセキュリティ チェックが実行され、コードの直前の呼び出し元アセンブリだけがチェックされます。  リンクは、コードを関数ポインターの参照やメソッドの呼び出しなどの型の参照にバインドするときに発生します。  呼び出し元のアセンブリが、コードにリンクするための十分な権限を持たない場合は、リンクは許可されず、コードが読み込まれて実行されると、ランタイム例外がスローされます。  リンク確認要求は、コードから継承するクラスでオーバーライドできます。  
+  
+ この種類の要求では、完全なスタック ウォークが実行されないことと、コードがおびき寄せによる攻撃を受ける可能性があることに注意してください。  たとえば、アセンブリ A 内のメソッドがリンク確認要求によって保護されている場合は、アセンブリ B の直接の呼び出し元が、アセンブリ B のアクセス許可に基づいて評価されます。  ただし、リンク確認要求は、アセンブリ C がアセンブリ B のメソッドを使用してアセンブリ A のメソッドを間接的に呼び出す場合は、アセンブリ C のメソッドを評価しません。  リンク確認要求は、直前の呼び出し元アセンブリにある直接の呼び出し元がコードにリンクするために必要なアクセス許可のみを指定します。  すべての呼び出し元がコードを実行するために必要なアクセス許可は指定しません。  
+  
+ <xref:System.Security.CodeAccessPermission.Assert%2A>、<xref:System.Security.CodeAccessPermission.Deny%2A>、および <xref:System.Security.CodeAccessPermission.PermitOnly%2A> の各スタック ウォーク修飾子は、リンク確認要求の評価に影響を与えません。  リンク確認要求は、スタック ウォークを実行しないため、スタック ウォーク修飾子はリンク確認要求に影響を与えません。  
+  
+ リンク確認要求で保護されているメソッドが[リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)経由でアクセスする場合、リンク確認要求ではリフレクションによってアクセスされたコードの直前の呼び出し元を確認します。  これは、メソッドの探索と、リフレクションを使用して行うメソッド呼び出しの両方に該当します。  たとえば、コードがリフレクションを使用して、リンク確認要求で保護されたメソッドを表す <xref:System.Reflection.MethodInfo> オブジェクトを返してから、その **MethodInfo** オブジェクトを元のメソッドを呼び出すオブジェクトを使用する別のコードに渡すと仮定してください。  この場合、リンク確認要求のチェックは 2 回発生します。1 回は **MethodInfo** オブジェクトを返すコードに対して、もう 1 回はこのオブジェクトを呼び出すコードに対してです。  
+  
+> [!NOTE]
+>  静的クラスのコンストラクターで実行されるリンク確認要求では、静的コンストラクターは保護されません。これは、静的コンストラクターがアプリケーションのコードの実行パスの外側で、システムによって呼び出されるためです。  その結果、リンク確認要求がクラス全体に適用される場合、静的コンストラクターへのアクセスは保護できませんが、クラスの残りの部分は保護されます。  
+  
+ 次のコード フラグメントでは、`ReadData` メソッドにリンクするコードはすべて `CustomPermission` のアクセス許可を持つ必要があることを宣言によって指定しています。  このアクセス許可は架空のカスタム許可であり、.NET Framework には実在しません。  リンク確認要求は、**SecurityAction.LinkDemand** フラグを `CustomPermissionAttribute` に渡して実行します。  
+  
+```vb  
+<CustomPermissionAttribute(SecurityAction.LinkDemand)> _  
+Public Shared Function ReadData() As String  
+    ' Access a custom resource.  
+End Function    
+```  
+  
+```csharp  
+[CustomPermissionAttribute(SecurityAction.LinkDemand)]  
+public static string ReadData()  
+{  
+    // Access a custom resource.  
+}  
+```  
+  
+## 参照  
+ [属性](../../../docs/standard/attributes/index.md)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)
\ No newline at end of file
diff --git a/docs/framework/misc/media/assert.gif b/docs/framework/misc/media/assert.gif
new file mode 100644
index 00000000000..fd525aa93e9
Binary files /dev/null and b/docs/framework/misc/media/assert.gif differ
diff --git a/docs/framework/misc/media/slide-10a.gif b/docs/framework/misc/media/slide-10a.gif
new file mode 100644
index 00000000000..e35e3edfd79
Binary files /dev/null and b/docs/framework/misc/media/slide-10a.gif differ
diff --git a/docs/framework/misc/securing-exception-handling.md b/docs/framework/misc/securing-exception-handling.md
new file mode 100644
index 00000000000..1354dd9af5e
--- /dev/null
+++ b/docs/framework/misc/securing-exception-handling.md
@@ -0,0 +1,173 @@
+---
+title: "例外処理の保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, 例外処理"
+  - "例外処理, セキュリティ"
+  - "安全なコーディング, 例外処理"
+  - "セキュリティ [.NET Framework], 例外処理"
+ms.assetid: 1f3da743-9742-47ff-96e6-d0dd1e9e1c19
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 例外処理の保護
+Visual C\+\+ と Visual Basic では、**finally** ステートメントの前に、スタックの最上位にあるフィルター式が実行されます。  このフィルターに対応した **catch** ブロックは、**finally** ステートメントの後に実行されます。  詳細については、「[ユーザー フィルター例外の使用](../../../docs/standard/exceptions/using-user-filtered-exception-handlers.md)」を参照してください。  このセクションでは、この順番に関するセキュリティについて調べます。  フィルター ステートメントと **finally** ステートメントの実行順序を示す次の架空のサンプル コードについて考慮します。  
+  
+```cpp  
+void Main()   
+{  
+    try   
+    {  
+        Sub();  
+    }   
+    except (Filter())   
+    {  
+        Console.WriteLine("catch");  
+    }  
+}  
+bool Filter () {  
+    Console.WriteLine("filter");  
+    return true;  
+}  
+void Sub()   
+{  
+    try   
+    {  
+        Console.WriteLine("throw");  
+        throw new Exception();  
+    }   
+    finally   
+    {  
+        Console.WriteLine("finally");  
+    }  
+}                        
+```  
+  
+ このコードの出力を次に示します。  
+  
+```  
+Throw  
+Filter  
+Finally  
+Catch  
+```  
+  
+ フィルターは **finally** ステートメントの前に実行されるため、セキュリティの問題は状態を変更する任意のコードによってもたらされ、他のコードの実行を利用される可能性があります。  たとえば、次のようになります。  
+  
+```cpp  
+try   
+{  
+    Alter_Security_State();  
+    // This means changing anything (state variables,  
+    // switching unmanaged context, impersonation, and   
+    // so on) that could be exploited if malicious   
+    // code ran before state is restored.  
+    Do_some_work();  
+}   
+finally   
+{  
+    Restore_Security_State();  
+    // This simply restores the state change above.  
+}  
+```  
+  
+ この架空のコードでは、スタックの上位にあるフィルターが任意のコードを実行できます。  同じような効果を持つ処理の別の例として、他の ID の一時的な偽装があります。この偽装では、いくつかのセキュリティ チェックを迂回する内部フラグが設定されるか、スレッドに対応するカルチャが変更されます。  解決方法として、例外ハンドラーを導入し、コードの変更を呼び出し元のフィルター ブロックからスレッド状態に分離することをお勧めします。  しかし、例外ハンドラーを正しく導入することが重要で、これができないと問題は解決されません。  次の例では、UI カルチャを切り替えますが、どのような種類のスレッド状態の変更も同様に公開されます。  
+  
+```cpp  
+YourObject.YourMethod()  
+{  
+   CultureInfo saveCulture = Thread.CurrentThread.CurrentUICulture;  
+   try {  
+      Thread.CurrentThread.CurrentUICulture = new CultureInfo("de-DE");  
+      // Do something that throws an exception.  
+}  
+   finally {  
+      Thread.CurrentThread.CurrentUICulture = saveCulture;  
+   }  
+}  
+  
+```  
+  
+```vb  
+Public Class UserCode  
+   Public Shared Sub Main()  
+      Try  
+         Dim obj As YourObject = new YourObject  
+         obj.YourMethod()  
+      Catch e As Exception When FilterFunc  
+         Console.WriteLine("An error occurred: '{0}'", e)  
+         Console.WriteLine("Current Culture: {0}",   
+Thread.CurrentThread.CurrentUICulture)  
+      End Try  
+   End Sub  
+  
+   Public Function FilterFunc As Boolean  
+      Console.WriteLine("Current Culture: {0}", Thread.CurrentThread.CurrentUICulture)  
+      Return True  
+   End Sub  
+  
+End Class  
+```  
+  
+ このケースの正しい解決方法は、既存の **try**\/**finally** ブロックを **try**\/**catch** ブロック内にラップすることです。  **catch\-throw** 句を既存の **try**\/**finally** ブロックに単に導入するだけでは、問題は解決されません。この例を次に示します。  
+  
+```cpp  
+YourObject.YourMethod()  
+{  
+    CultureInfo saveCulture = Thread.CurrentThread.CurrentUICulture;  
+  
+    try   
+    {  
+        Thread.CurrentThread.CurrentUICulture = new CultureInfo("de-DE");  
+        // Do something that throws an exception.  
+    }  
+    catch { throw; }  
+    finally   
+    {  
+        Thread.CurrentThread.CurrentUICulture = saveCulture;  
+    }  
+}  
+```  
+  
+ **finally** ステートメントは `FilterFunc` が制御を取得する前に実行されないため、この例では問題を解決できません。  
+  
+ 呼び出し元の例外フィルター ブロックで例外を発生させる前に、**finally** 句を実行することによって問題を解決する例を次に示します。  
+  
+```cpp  
+YourObject.YourMethod()  
+{  
+    CultureInfo saveCulture = Thread.CurrentThread.CurrentUICulture;  
+    try    
+    {  
+        try   
+        {  
+            Thread.CurrentThread.CurrentUICulture = new CultureInfo("de-DE");  
+            // Do something that throws an exception.  
+        }  
+        finally   
+        {  
+            Thread.CurrentThread.CurrentUICulture = saveCulture;  
+        }  
+    }  
+    catch { throw; }  
+}  
+```  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/securing-method-access.md b/docs/framework/misc/securing-method-access.md
new file mode 100644
index 00000000000..751859ee0c5
--- /dev/null
+++ b/docs/framework/misc/securing-method-access.md
@@ -0,0 +1,168 @@
+---
+title: "メソッド アクセスの保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, メソッド アクセス"
+  - "メソッド アクセスのセキュリティ"
+  - "安全なコーディング, メソッド アクセス"
+  - "セキュリティ [.NET Framework], メソッド アクセス"
+ms.assetid: f7c2d6ec-3b18-4e0e-9991-acd97189d818
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# メソッド アクセスの保護
+信頼関係のない任意のコードに呼び出しを許可することが不適切なメソッドがあります。 このようなメソッドは、制限された情報を提供する、渡された任意の情報を信頼する、パラメーターのエラー チェックを行わない、誤ったパラメーターを受け取って正しく機能しないかなんらかの被害をもたらすなどの、いくつかの危険性をもたらします。 これらのケースを認識し、メソッドを保護するために役立つ措置を講じる必要があります。  
+  
+ パブリックでの使用を目的としていないメソッドをパブリックとして使用する場合は、メソッドを制限する必要があることがあります。 たとえば、独自の DLL 経由で呼び出すインターフェイスはパブリックにする必要があります。しかし、顧客がそのインターフェイスを使用したり、悪意のあるコードがコンポーネントへのエントリ ポイントとして攻略したりするのを防ぐために、そのインターフェイスをパブリックとして公開しない場合があります。 また、パブリックではあるものの、パブリック使用を想定していないメソッドを制限する一般的な理由として、非常に内部的なインターフェイスで、ドキュメントを残したり、サポートするのを避けたりする場合も考えられます。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+ マネージ コードには、メソッド アクセスを制限するいくつかの方法があります。  
+  
+-   クラス、アセンブリ、派生クラスが信頼されている場合は、これらへのアクセシビリティのスコープを制限します。 これが、メソッド アクセスを制限する最も簡単な方法です。 派生クラスが親クラスの ID を共有することがありますが、一般的に、派生クラスは派生元のクラスよりも信頼度が低くなる可能性があります。 特に、キーワード **protected** からは信頼を推測しないでください。セキュリティ コンテキストでは、このキーワードの使用は必須ではありません。  
+  
+-   指定した ID の呼び出し元だけにメソッド アクセスを制限します。基本的には、選択した特定の[証拠](http://msdn.microsoft.com/ja-jp/64ceb7c8-a0b4-46c4-97dc-6c22da0539da) \(厳密な名前、発行者、ゾーンなど\) に限定します。  
+  
+-   選択したアクセス許可を持つ呼び出し元だけにメソッド アクセスを制限します。  
+  
+ 同様に、宣言セキュリティを使用すると、クラスの継承を制御できます。 以下を実行する場合は **InheritanceDemand** を使用します。  
+  
+-   派生したクラスに、特定の ID またはアクセス許可を要求します。  
+  
+-   特定のメソッドをオーバーライドする派生クラスに、特定の ID またはアクセス許可を要求します。  
+  
+ 呼び出し元に特定の厳密な名前による署名を要求することによってアクセスを制限し、パブリック クラスの保護に役立つ方法の例を次に示します。 この例では、厳密な名前を要求する **Demand** と共に <xref:System.Security.Permissions.StrongNameIdentityPermissionAttribute> を使用しています。 アセンブリを厳密な名前で署名する方法のタスク ベースの情報については、「[厳密な名前付きアセンブリの作成と使用](../../../docs/framework/app-domains/create-and-use-strong-named-assemblies.md)」を参照してください。  
+  
+```vb  
+<StrongNameIdentityPermissionAttribute(SecurityAction.Demand, PublicKey := "…hex…", Name := "App1", Version := "0.0.0.0")>  _ Public Class Class1 End Class  
+  
+```  
+  
+```csharp  
+[StrongNameIdentityPermissionAttribute(SecurityAction.Demand, PublicKey="…hex…", Name="App1", Version="0.0.0.0")] public class Class1 { }   
+```  
+  
+## クラスとメンバーを信頼関係のないコードが使用できないようにする  
+ このセクションで示す宣言を使用すると、特定のクラスとメソッド、およびプロパティとイベントが部分的な信頼のコードによって使用されるのを防ぐことができます。 これらの宣言をクラスに適用すると、すべてのメソッド、プロパティ、イベントが保護されますが、フィールドへのアクセスは宣言セキュリティの影響を受けないため、注意が必要です。 また、リンク確認要求は直前の呼び出し元に対して保護できるようにするだけで、攻撃を受ける可能性が残っています。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、新しい透過性モデルが導入されました。[透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md) モデルでは、<xref:System.Security.SecurityCriticalAttribute> 属性によって安全なコードを識別します。 セキュリティ クリティカル コードでは、呼び出し元と継承先の両方が完全に信頼されていることが必要です。 .NET Framework の以前のバージョンのコード アクセス セキュリティ規則で実行されているアセンブリは、レベル 2 のアセンブリを呼び出すことができます。 この場合、セキュリティ クリティカル属性は、完全な信頼のためのリンク確認要求として扱われます。  
+  
+ 厳密な名前付きアセンブリでは、パブリックにアクセスされるすべてのメソッド、プロパティ、イベントに [LinkDemand](../../../docs/framework/misc/link-demands.md) が適用され、完全に信頼されている呼び出し元だけに使用を制限できます。 この機能を無効にするには、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性を適用する必要があります。 このため、信頼関係のない呼び出し元を除外するクラスを明示的に指定することは、署名のないアセンブリまたはこの属性を持つアセンブリだけに必要です。これらの宣言を使用して、信頼関係のない呼び出し元からの利用を想定していない型のサブセットをマークできます。  
+  
+ クラスおよびメンバーを信頼関係のないコードによって使用されるのを防ぐ方法の例を次に示します。  
+  
+ パブリックの非シール クラスの場合:  
+  
+```vb  
+<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name := "FullTrust"), _ System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name := "FullTrust")>  _ Public Class CanDeriveFromMe End Class  
+  
+```  
+  
+```csharp  
+[System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name="FullTrust")] [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name="FullTrust")] public class CanDeriveFromMe { }  
+```  
+  
+ パブリックのシール クラスの場合:  
+  
+```vb  
+<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name := "FullTrust")>  _ NotInheritable Public Class CannotDeriveFromMe End Class  
+  
+```  
+  
+```csharp  
+[System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name="FullTrust")] public sealed class CannotDeriveFromMe { }  
+```  
+  
+ パブリックの抽象クラスの場合:  
+  
+```vb  
+<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name := "FullTrust"), _ System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name := "FullTrust")>  _ MustInherit Public Class CannotCreateInstanceOfMe_CanCastToMe End Class  
+```  
+  
+```csharp  
+[System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name="FullTrust")] [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name="FullTrust")] public abstract class CannotCreateInstanceOfMe_CanCastToMe{}  
+```  
+  
+ パブリックの仮想関数の場合:  
+  
+```vb  
+Class Base1 <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name:="FullTrust"), System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name:="FullTrust")> _ Public Overridable Sub CanOverrideOrCallMe() End Sub 'CanOverrideOrCallMe End Class 'Base1  
+```  
+  
+```csharp  
+class Base1 { [System.Security.Permissions.PermissionSetAttribute( System.Security.Permissions.SecurityAction.InheritanceDemand, Name="FullTrust")] [System.Security.Permissions.PermissionSetAttribute( System.Security.Permissions.SecurityAction.LinkDemand, Name="FullTrust")] public virtual void CanOverrideOrCallMe() {} }  
+```  
+  
+ パブリックの抽象関数の場合:  
+  
+```vb  
+MustInherit Class Base2 <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name:="FullTrust"), System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name:="FullTrust")> _ Public Sub MustOverrideMe() End Sub End Class 'Base2  
+```  
+  
+```csharp  
+abstract class Base2{ [System.Security.Permissions.PermissionSetAttribute( System.Security.Permissions.SecurityAction.InheritanceDemand, Name = "FullTrust")] [System.Security.Permissions.PermissionSetAttribute( System.Security.Permissions.SecurityAction.LinkDemand, Name = "FullTrust")] public abstract void MustOverrideMe(); }  
+```  
+  
+ 基本クラスが完全な信頼を確認要求しない、パブリック オーバーライド関数の場合:  
+  
+```vb  
+Class Derived Inherits Base1 <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _ Public Overrides Sub CanOverrideOrCallMe() MyBase.CanOverrideOrCallMe() End Sub 'CanOverrideOrCallMe End Class 'Derived  
+```  
+  
+```csharp  
+class Derived : Base1 { [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] public override void CanOverrideOrCallMe() { base.CanOverrideOrCallMe(); } }  
+```  
+  
+ 基本クラスが完全な信頼を確認要求する、パブリック オーバーライド関数の場合:  
+  
+```vb  
+Class Derived Inherits Base1 <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name:="FullTrust")> _ Public Overrides Sub CanOverrideOrCallMe() MyBase.CanOverrideOrCallMe() End Sub 'CanOverrideOrCallMe End Class 'Derived  
+```  
+  
+```csharp  
+class Derived : Base1 { [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name="FullTrust")] public override void CanOverrideOrCallMe() { base.CanOverrideOrCallMe(); } }  
+```  
+  
+ パブリック インターフェイスの場合:  
+  
+```vb  
+Public Interface ICanCastToMe <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name:="FullTrust"), System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name:="FullTrust")> _ Sub CanImplementMe() End Interface 'ICanCastToMe <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name:="FullTrust"), System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name:="FullTrust")> _ Class Implemented Implements ICanCastToMe Public Sub CanImplementMe() End Sub 'CanImplementMe  
+```  
+  
+```csharp  
+public interface ICanCastToMe { [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name = "FullTrust")] [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name = "FullTrust")] void CanImplementMe(); } [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name = "FullTrust")] [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand, Name = "FullTrust")] class Implemented : ICanCastToMe { public void CanImplementMe() { } }  
+```  
+  
+## Virtual Internal Overrides または Overloads Overridable Friend  
+  
+> [!NOTE]
+>  このセクションではメソッドを `virtual` と `internal` の両方 \(Visual Basic の `Overloads``Overridable``Friend`\) として宣言するときのセキュリティの問題に関する注意事項について説明します。 この注意事項の対象となるのは .NET Framework バージョン 1.0 および 1.1 のみで、バージョン 2.0 は対象になりません。  
+  
+ .NET Framework バージョン 1.0 および 1.1 では、コードを他のアセンブリから使用できないようにする場合、型システムのアクセシビリティの微妙な点を知っておく必要があります。**virtual** および **internal** \(Visual Basic では **Overloads Overridable Friend**\) が宣言されたメソッドは、親クラスの vtable エントリをオーバーライドでき、internal なので同じアセンブリ内だけで使用できます。 しかし、オーバーライドのアクセシビリティは **virtual** キーワードによって決められ、他のアセンブリがクラス自身へアクセスできる限り、そのアセンブリによってこれがオーバーライドされる可能性があります。 オーバーライドの可能性に問題がある場合は、宣言セキュリティを使用してそれを修正するか、**virtual** キーワードが厳密には必要ないときは、このキーワードを削除します。  
+  
+ ある言語コンパイラがコンパイル エラーによってこれらのオーバーライドを防いだとしても、他のコンパイラによって記述されたコードがオーバーライドする可能性があります。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/securing-wrapper-code.md b/docs/framework/misc/securing-wrapper-code.md
new file mode 100644
index 00000000000..d8cc351d096
--- /dev/null
+++ b/docs/framework/misc/securing-wrapper-code.md
@@ -0,0 +1,129 @@
+---
+title: "ラッパー コードの保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, ラッパー コード"
+  - "安全なコーディング, ラッパー コード"
+  - "セキュリティ [.NET Framework], ラッパー コード"
+  - "ラッパー コード, セキュリティ"
+ms.assetid: 1df6c516-5bba-48bd-b450-1070e04b7389
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ラッパー コードの保護
+ラッパー コードで、使用しているコードよりもラッパーの信頼が高い場合には特に、特有のセキュリティ脆弱性が生じる恐れがあります。 呼び出し元の制限されたアクセス許可が適切なセキュリティ チェックに含まれないと、呼び出し元のために実行されるすべての処理が、悪用される可能性のある潜在的な脆弱性となります。  
+  
+ 呼び出し元自体で実行できない処理をラッパーによって行うことがないようにしてください。 完全なスタック ウォーク要求とは対照的に、限定的なセキュリティ チェックしか行われずに何らかの処理が行われる場合に、この状況は特に危険です。 単一レベルのチェックが行われる場合、実際の呼び出し元と対象の API 要素との間にラッパー コードを挿入することによって、本来は成功すべきではないセキュリティ チェックが簡単に成功してしまう原因となる可能性があり、セキュリティが弱体化します。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+## デリゲート  
+ デリゲートのセキュリティは、.NET Framework のバージョンによって異なります。  このセクションでは、各種デリゲートの動作と、関連するセキュリティ上の考慮事項について説明します。  
+  
+### .NET Framework バージョン 1.0 および 1.1 の場合  
+ .NET Framework バージョン 1.0 および 1.1 は、デリゲートの作成者とデリゲートの呼び出し元に対して、次のセキュリティ アクションを実行します。  
+  
+-   デリゲートが作成されると、デリゲート対象メソッドのセキュリティ リンク要求が、デリゲート作成者の許可セットに対して実行されます。  セキュリティ アクションを満たすことができないと、<xref:System.Security.SecurityException> が結果として生じます。  
+  
+-   デリゲートが呼び出されると、デリゲート呼び出し元の既存のセキュリティ要求が実行されます。  
+  
+ ご使用のコードで <xref:System.Delegate> を取得するときに、それを呼び出すことができる信頼性の低いコードから取得する場合には、その信頼性の低いコードによってアクセス許可がエスカレートされることがないようにしてください。 デリゲートを取得して後ほど使用するとき、デリゲートを作成したコードは呼び出しスタック上にはなく、デリゲートのコードまたはデリゲートを行うコードが保護された操作を試みる場合にアクセス許可がテストされないことになります。 ご使用のコードと呼び出し元のコードに作成者よりも高い特権がある場合、作成者は呼び出しスタックの一部になることなく、呼び出しパスを編成できます。  
+  
+### .NET Framework バージョン 2.0 以降の場合  
+ .NET Framework version 2.0 ではそれより前のバージョンとは異なり、デリゲートが作成されて呼び出されるときに、デリゲート作成者に対してセキュリティ アクションを実行します。  
+  
+-   デリゲートが作成されると、デリゲート対象メソッドのセキュリティ リンク要求が、デリゲート作成者の許可セットに対して実行されます。  セキュリティ アクションを満たすことができないと、<xref:System.Security.SecurityException> が結果として生じます。  
+  
+-   デリゲート作成時に、デリゲート作成者の許可セットも取得され、デリゲートと一緒に格納されます。  
+  
+-   デリゲートが呼び出されると、デリゲート作成者と呼び出し元が属するアセンブリが異なる場合には、現在のコンテキストの任意の要求に対して、デリゲート作成者の取得された許可セットが最初に評価されます。  次に、デリゲート呼び出し元の既存のセキュリティ要求が実行されます。  
+  
+## リンク要求とラッパー  
+ リンク要求に関する特別な保護がセキュリティ インフラストラクチャで強化されましたが、依然としてコード内で脆弱性の原因となる可能性があります。  
+  
+ 完全に信頼されるコードが、[LinkDemand](../../../docs/framework/misc/link-demands.md) によって保護されているプロパティ、イベント、メソッドを呼び出す場合、呼び出し元の **LinkDemand** アクセス許可チェックを満たしているとその呼び出しは成功します。 さらに、完全に信頼されるコードがプロパティ名を取るクラスを公開し、リフレクションを使用して**get** アクセサーを呼び出すと、**get** アクセサーに対する呼び出しは、ユーザー コードにこのプロパティにアクセスする権限がない場合であっても成功します。 これは、**LinkDemand** がチェックするのは、完全に信頼できるコードである直接の呼び出し元だけであることに起因します。 基本的に、完全に信頼できるコードは、ユーザー コードに代わって呼び出す権限があり、その際、ユーザー コードに呼び出すための権限があるかどうかの確認は行いません。  
+  
+ こうしたセキュリティ ホールを回避するには、共通言語ランタイムによるチェックを、**LinkDemand** によって保護されているメソッド、コンストラクター、プロパティ、イベントに対する間接呼び出しの完全なスタック ウォーク要求へと拡張します。 この保護により若干のパフォーマンス コストが発生し、セキュリティ チェックのセマンティクスが変更されます。より高速な単一レベルのチェックに合格していた場合にも完全なスタック ウォーク要求が失敗する可能性があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、部分的に信頼されるコードが透過コードとして再定義されました。 透過性モデルは、ネイティブ コードの呼び出しなどの特権的な処理を実行できるコード \(重要なコード\) と、そのような処理を実行できないコード \(透過的なコード\) との間に、障壁を設けます。 透過性では、<xref:System.Security.Permissions.SecurityAction> を使用する代わりに、完全な信頼に関して <xref:System.Security.SecurityCriticalAttribute> を用いて完全に信頼されるコードを特定します。 この変更およびその他の変更の詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+## アセンブリ読み込みラッパー  
+ マネージ コードの読み込みに使用されるいくつかのメソッド \(<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> など\) は、呼び出し元の証拠に基づいてアセンブリを読み込みます。 これらのメソッドのいずれかをラップする場合、セキュリティ システムがアセンブリを読み込むとき、ラッパーに対する呼び出し元のアクセス許可ではなく、ご使用のコードのアクセス許可を使用できることがあります。 信頼性の低いコードに対して、ラッパーへの呼び出し元のアクセス許可より高いアクセス許可が付与されているコードの読み込みを許可しないでください。  
+  
+ 完全な信頼のあるコード、または潜在的な呼び出し元 \(インターネット アクセス許可レベルの呼び出し元など\) よりも信頼が高いコードであっても、こうした方法でセキュリティが弱体化する可能性があります。 コードに、バイト配列を取って、それを **Assembly.Load** に渡すパブリック メソッドが含まれる場合、そうした呼び出し元のためにアセンブリを作成すると、セッキュリティが破られる恐れがあります。  
+  
+ この問題は、次の API 要素に当てはまります。  
+  
+-   <xref:System.AppDomain.DefineDynamicAssembly%2A?displayProperty=fullName>  
+  
+-   <xref:System.AppDomain.Load%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName>  
+  
+-   <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName>  
+  
+## Demand とLinkDemand  
+ 宣言型セキュリティには 2 種類のセキュリティ チェックがあり、どちらも似ていますが、実行するチェックがかなり異なります。 選択を誤るとセキュリティの脆弱性やパフォーマンスの低下を招くことがあるため、両方の形式について理解する必要があります。  
+  
+ 宣言型のセキュリティには、次のセキュリティ チェックがあります。  
+  
+-   <xref:System.Security.Permissions.SecurityAction> はコード アクセス セキュリティのスタック ウォークを指定します。 スタック上の各呼び出し元が合格するには、指定のアクセス許可または ID が必要です。 スタックには異なる呼び出し元が含まれている可能性があるため、**Demand** は呼び出しごとに生じます。 メソッドを繰り返し呼び出す場合は、このセキュリティ チェックが毎回行われます。**Demand** はおびき寄せによる攻撃に対して優れた保護となります。そうした攻撃によって送り込まれようとする未承認のコードが検出されます。  
+  
+-   [LinkDemand](../../../docs/framework/misc/link-demands.md) は JIT\(just\-in\-time\) コンパイル時に生じて、直接の呼び出し元だけをチェックします。 このセキュリティ チェックでは、呼び出し元の呼び出し元はチェックされません。 このチェックに合格すると、呼び出し元が何度も呼び出す場合であってもさらにセキュリティ オーバーヘッドが生じることはありません。 ただし、おびき寄せによる攻撃からの保護機能はありません。**LinkDemand** を使用すると、テストに合格し、ご使用のコードを参照可能なすべてのコードで、セキュリティが破られる可能性が生じます。つまり、悪意のあるコードに対して、承認済みのコードの呼び出しが許可される場合です。 そのため、可能性のあるすべての脆弱性を完全に回避できるのでない限り、**LinkDemand** を使用しないでください。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、<xref:System.Security.SecurityRuleSet> アセンブリの <xref:System.Security.SecurityCriticalAttribute> 属性によってリンク要求が置換されています。<xref:System.Security.SecurityCriticalAttribute> は完全な信頼のリンク要求に相当しますが、継承ルールにも影響を及ぼします。 この変更の詳細については、「[透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md)」を参照してください。  
+  
+ **LinkDemand** を使用するときに必要な特別な措置は、個別にプログラミングする必要があります。セキュリティ システムを実施に役立てられることがあります。 どのようなミスもセキュリティを脆弱化します。 作成したコードを使用する、承認されたすべてのコード側で、次の措置を行うことによって追加セキュリティを実装する責任があります。  
+  
+-   呼び出し元のコードがクラスまたはアセンブリにアクセスするのを制限します。  
+  
+-   呼び出されるコードに現れる呼び出し元のコードで同じセキュリティ チェックを配置し、呼び出し元にその実行義務を課します。 たとえば、<xref:System.Security.Permissions.SecurityPermissionFlag> フラグを指定した <xref:System.Security.Permissions.SecurityPermission> に関して **LinkDemand** で保護されたメソッドを呼び出すコードを作成する場合、ご使用のメソッドもこのアクセス許可の **LinkDemand** \(またはより強力な **Demand**\) を実行する必要があります。 ただし、ご使用のコードで **LinkDemand** 保護されたメソッドを、安全だと判断した限定的な方法でのみ使用していて、コードに他のセキュリティ保護機能 \(Demand など\) がある場合は例外です。 前述の例外的なケースでは、呼び出し側で、基になるコードでのセキュリティ保護の脆弱性に対処する必要があります。  
+  
+-   呼び出し元のコードが、呼び出し先のコードに成り代わって、保護されているコードを呼び出すことがないようにしてください。 つまり、呼び出し元は承認されたコードに対して、保護されているコードに特定のパラメーターを渡したり、結果を送り返させたりすることはできません。  
+  
+### インターフェイスとリンク要求  
+ **LinkDemand** を使用した仮想メソッド、プロパティ、イベントが基本クラス メソッドをオーバーライドする場合、オーバーライド対象メソッドで有効になるように、その基本クラス メソッドにも同じ **LinkDemand** が必要です。 悪意のあるコードが、基本型にキャスト バックを行い、基本クラスのメソッドを呼び出す可能性があります。 リンク要求を、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> アセンブリ レベル属性を持たないアセンブリに暗黙的に追加できるという点にも注意してください。  
+  
+ インターフェイス メソッドでリンク要求も指定されている場合は、メソッドの実装をリンク要求で保護するのは良い方法です。 リンク要求をインターフェイスと一緒に使用する場合、以下の点に注意してください。  
+  
+-   **AllowPartiallyTrustedCallersAttribute** 属性はインターフェイスにも適用されます。  
+  
+-   リンク要求をインターフェイス上に配置することにより、**AllowPartiallyTrustedCallersAttribute** 属性を使用する場合など、部分的に信頼されるコードの使用から特定のインターフェイスを選択的に保護できます。  
+  
+-   使用しているインターフェイスが **AllowPartiallyTrustedCallersAttribute** 属性が含まれないアセンブリで定義されている場合、そのインターフェイスを部分的に信頼されるクラスで実装できます。  
+  
+-   インターフェイス メソッドを実装するクラスのパブリック メソッドに **LinkDemand** を配置すると、そのインターフェイスをキャストしてメソッドを呼び出すときに **LinkDemand** は実施されません。 この場合、インターフェイスに対してリンクされているため、インターフェイス上の **LinkDemand** のみが実行されます。  
+  
+ セキュリティの問題に関して次の項目を確認します。  
+  
+-   インターフェイス メソッドでのリンク要求を明示的に指定します。 こうしたリンク要求が期待どおりの保護を提供することを確認します。 悪意のあるコードがキャストを使用して、前述のようにリンク要求を迂回できるかどうかを判別します。  
+  
+-   リンク要求が適用される仮想メソッド。  
+  
+-   実装する型とインターフェイス。 一貫してリンク要求を使用する必要があります。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-and-public-read-only-array-fields.md b/docs/framework/misc/security-and-public-read-only-array-fields.md
new file mode 100644
index 00000000000..fd20349630e
--- /dev/null
+++ b/docs/framework/misc/security-and-public-read-only-array-fields.md
@@ -0,0 +1,39 @@
+---
+title: "セキュリティとパブリックの読み取り専用配列フィールド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "セキュリティ [.NET Framework], パブリックの読み取り専用配列フィールド"
+ms.assetid: 3df28dee-2a9f-40ff-9852-bfdbe59c27f3
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# セキュリティとパブリックの読み取り専用配列フィールド
+読み取り専用のパブリック配列フィールドは変更できるため、マネージ ライブラリから読み取り専用のパブリック配列フィールドを使用して、アプリケーションの境界動作やセキュリティを定義しないでください。  
+  
+## 解説  
+ .NET Framework の一部のクラスには、プラットフォーム固有の境界パラメーターを含む読み取り専用のパブリック フィールドが含まれます。たとえば <xref:System.IO.Path.InvalidPathChars> フィールドは、ファイル パス文字列で使用できない文字を記述する配列です。.NET Framework には、これに類似したフィールドが数多くあります。  
+  
+ <xref:System.IO.Path.InvalidPathChars> などのパブリックの読み取り専用フィールドの値は、コード、またはコードのアプリケーション ドメインを共有するコードを使用して変更できます。このような読み取り専用のパブリック配列フィールドを使用して、アプリケーションの境界動作を定義しないでください。このようなフィールドを使用してアプリケーションの境界動作を定義すると、悪意のあるコードによって境界定義が変更され、コードが悪用される恐れがあります。  
+  
+ .NET Framework Version 2.0 以降では、パブリック配列フィールドを使用する代わりに、新しい配列を返すメソッドを使用します。たとえば、<xref:System.IO.Path.InvalidPathChars> フィールドを使用する代わりに <xref:System.IO.Path.GetInvalidPathChars%2A> メソッドを使用します。  
+  
+ .NET Framework の型は、パブリック フィールドを使用して境界の種類を内部的に定義しないことに注意してください。代わりに .NET Framework では、個別のプライベート フィールドを使用します。パブリック フィールドの値を変更しても、.NET Framework の型の動作は変わりません。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-and-remoting-considerations.md b/docs/framework/misc/security-and-remoting-considerations.md
new file mode 100644
index 00000000000..934528cde05
--- /dev/null
+++ b/docs/framework/misc/security-and-remoting-considerations.md
@@ -0,0 +1,51 @@
+---
+title: "セキュリティとリモート処理の考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, リモート処理"
+  - "リモート処理, セキュリティ"
+  - "安全なコーディング, リモート処理"
+  - "セキュリティ [.NET Framework], リモート処理"
+ms.assetid: 125d2ab8-55a4-4e5f-af36-a7d401a37ab0
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# セキュリティとリモート処理の考慮事項
+リモート処理を使用すると、アプリケーション ドメイン、プロセス、コンピューターの間で透過的な呼び出しを設定できます。  ただし、コード アクセス セキュリティのスタック ウォークがプロセスやコンピューターの境界を超えることはできません \(これは、同一プロセスのアプリケーション ドメイン間に当てはまります\)。  
+  
+ リモート処理可能な \(<xref:System.MarshalByRefObject> クラスから派生した\) クラスの場合、セキュリティに関する責任を負う必要があります。  呼び出し元のコードを暗黙的に信頼できる閉じた環境でのみコードを使用するか、あるいは、保護対象コードが悪意を持って使用される可能性のある外部エントリの影響を受けないようにリモート呼び出しを設計する必要があります。  
+  
+ 一般に、宣言型の [LinkDemand](../../../docs/framework/misc/link-demands.md) と <xref:System.Security.Permissions.SecurityAction> セキュリティ チェックによって保護されるメソッド、プロパティ、イベントは公開すべきではありません。  リモート処理では、こうしたチェックは実施されません。  <xref:System.Security.Permissions.SecurityAction> や [Assert](../../../docs/framework/misc/using-the-assert-method.md) など他のセキュリティ チェックはプロセス内のアプリケーション ドメインでは機能しますが、プロセス間またはコンピューター間のシナリオでは機能しません。  
+  
+## 保護されているオブジェクト  
+ 一部のオブジェクトはそれ自体でセキュリティ状態を保持します。  これらのオブジェクトを信頼されていないコードに渡してはなりません。こうしたコードに渡すと、独自の権限を超えるセキュリティ承認が取得されかねません。  
+  
+ <xref:System.IO.FileStream> オブジェクトの作成がその例です。  <xref:System.Security.Permissions.FileIOPermission> は作成時に要求され、成功すると、ファイル オブジェクトが返されます。  ただし、このオブジェクト参照がファイルのアクセス許可を持たないコードに渡されると、オブジェクトでこの特定のファイルに対する読み書きが行えるようになります。  
+  
+ このようなオブジェクトに対する最も簡単な防御方法は、パブリック API 要素を介してオブジェクト参照を取得しようとするコードに、同じ **FileIOPermission** を要求することです。  
+  
+## アプリケーション ドメインを越える問題  
+ 管理対象ホスト環境にコードを隔離する場合、各種アセンブリのアクセス許可レベルを減らす明示的なポリシーを使用して、複数の子アプリケーション ドメインを生成するというのが一般的です。  ただし、既定のアプリケーション ドメインでそれらのアセンブリのポリシーは変更されません。  いずれかの子アプリケーション ドメインによって既定のアプリケーション ドメインがアセンブリを読み込むように強制されると、コードの隔離の効果が失われ、強制的に読み込まれたアセンブリにある型がより高いレベルの信頼でコードを実行できることになります。  
+  
+ アプリケーション ドメインは、強制的に他のアプリケーション ドメインがアセンブリを読み込み、そのアプリケーション ドメインでホストされているオブジェクトに対してプロキシを呼び出すことによって、そこに含まれているコードを実行させることができます。  アプリケーション ドメイン間のプロキシを取得するには、オブジェクトをホストしているアプリケーション ドメインが、メソッド呼び出しパラメーターまたは戻り値を使用してプロキシを配布する必要があります。  または、アプリケーション ドメインが作成されたばかりの場合、既定では作成者が <xref:System.AppDomain> オブジェクトに対するプロキシを有しています。  したがって、コードの隔離状態を損なわないためには、高いレベルの信頼を持つアプリケーション ドメインがドメイン内の参照を、低いレベルの信頼を持つアプリケーション ドメインに対して、参照によってマーシャリングされたオブジェクト \(<xref:System.MarshalByRefObject> から派生したクラスのインスタンス\) を配布しないようにする必要があります。  
+  
+ 通常、既定のアプリケーション ドメインによって、それぞれのコントロール オブジェクトが含まれる子アプリケーション ドメインが作成されます。  コントロール オブジェクトが、新しいアプリケーション ドメインを管理し、既定のアプリケーション ドメインからオーダーを受ける場合もありますが、実際にドメインと直接やり取りすることはできません。  場合によっては、既定のアプリケーション ドメインが、コントロール オブジェクトに対してプロキシを呼び出します。  ただし、コントロール オブジェクトが既定のアプリケーション ドメインにコールバックすることが必要になる場合もあります。  このような場合、既定のアプリケーション ドメインは、コントロール オブジェクトのコンストラクターに対して、参照によってマーシャリングされたコールバック オブジェクトを渡します。  このプロキシを保護する責任は、コントロール オブジェクトにあります。  コントロール オブジェクトがパブリック クラスのパブリック静的フィールドにプロキシを配置した場合、またはプロキシを公開している場合には、他のコードが既定のアプリケーション ドメインにコールバックされるという危険なメカニズムが生じることになります。  このため、コントロール オブジェクトはプロキシを非公開に保つことが常に暗黙的に期待されています。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-and-serialization.md b/docs/framework/misc/security-and-serialization.md
new file mode 100644
index 00000000000..cba7bd685b4
--- /dev/null
+++ b/docs/framework/misc/security-and-serialization.md
@@ -0,0 +1,52 @@
+---
+title: "セキュリティとシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, シリアル化"
+  - "安全なコーディング, シリアル化"
+  - "セキュリティ [.NET Framework], シリアル化"
+  - "シリアル化, セキュリティ"
+ms.assetid: b921bc94-bd3a-4c91-9ede-2c8d4f78ea9a
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# セキュリティとシリアル化
+シリアル化によって、他の方法ではアクセスできないオブジェクト インスタンス データを他のコードから参照または変更できるようになるため、シリアル化を実行するコードには、特殊なアクセス許可として、<xref:System.Security.Permissions.SecurityPermissionFlag> フラグが指定された <xref:System.Security.Permissions.SecurityPermission> が必要です。 既定のポリシーでは、インターネットからダウンロードしたコードまたはイントラネット コードにはこのアクセス許可は与えられず、ローカル コンピューター上のコードにだけ付与されます。  
+  
+ 通常、オブジェクト インスタンスのすべてのフィールドはシリアル化されます。つまり、データは、インスタンスのシリアル化されたデータで表されます。 形式を解釈できるコードでは、メンバーのアクセシビリティとは関係なく、データ値を判断できます。 同様に、逆シリアル化でもアクセシビリティ規則に関係なく、シリアル化された表現からデータを抽出し、オブジェクトの状態を直接設定します。  
+  
+ 機密データを含む可能性のあるオブジェクトは、可能であれば、シリアル化できないようにしてください。 そのようなオブジェクトをシリアル化しなければならない場合、機密データを保持する特定のフィールドは、シリアル化できないように維持してください。 これが不可能な場合は、このデータが、シリアル化のアクセス許可を持つあらゆるコードに公開されることに注意し、絶対に、悪質なコードがこのアクセス許可を取得できないようにしてください。  
+  
+ <xref:System.Runtime.Serialization.ISerializable> インターフェイスは、シリアル化インフラストラクチャでのみ使用するためのものです。 ただし、保護されていない場合、機密情報をリリースする可能性があります。**ISerializable** を実装してカスタムのシリアル化を提供する場合は、必ず次の予防措置を取ってください。  
+  
+-   **SerializationFormatter** アクセス許可を指定した **SecurityPermission** を要求するか、メソッドの出力で機密情報がリリースされないことを確実にして、<xref:System.Runtime.Serialization.ISerializable.GetObjectData%2A> メソッドを明示的に保護します。 例:  
+  
+    ```vb  
+    Public Overrides<SecurityPermissionAttribute(SecurityAction.Demand, SerializationFormatter := True)>  _ Sub GetObjectData(info As SerializationInfo, context As StreamingContext) End Sub  
+  
+    ```  
+  
+    ```csharp  
+    [SecurityPermissionAttribute(SecurityAction.Demand,SerializationFormatter =true)] public override void GetObjectData(SerializationInfo info, StreamingContext context) { }  
+    ```  
+  
+-   シリアル化に使用する特殊なコンストラクターでも徹底的な入力検証を行い、悪質なコードによる悪用を防ぐために、コンストラクターを保護するか、またはプライベートにする必要があります。 また、クラスを明示的に作成したり、ある種のファクトリで間接的に作成したりするなど、他の方法でこのようなクラスのインスタンスを取得する場合にも、同じセキュリティ チェックとアクセス許可を適用してください。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-transparent-code-level-1.md b/docs/framework/misc/security-transparent-code-level-1.md
new file mode 100644
index 00000000000..823e1ed3c9c
--- /dev/null
+++ b/docs/framework/misc/security-transparent-code-level-1.md
@@ -0,0 +1,128 @@
+---
+title: "透過的セキュリティ コード、レベル 1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "セキュリティ [.NET Framework], セキュリティが透過的なコード"
+  - "SecurityCriticalAttribute"
+  - "セキュリティが透過的なコード"
+  - "SecurityTransparentAttribute"
+  - "SecurityTreatAsSafeAttribute"
+  - "透明な"
+ms.assetid: 5fd8f46d-3961-46a7-84af-2eb1f48e75cf
+caps.latest.revision: 32
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# 透過的セキュリティ コード、レベル 1
+透過性を使用すると、開発者は、部分的に信頼されるコードに機能を公開する .NET Framework ライブラリのセキュリティを強化できます。 レベル 1 の透過性は、.NET Framework Version 2.0 で導入され、主に Microsoft 内でのみ使用されていました。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、[レベル 2 の透過性](../../../docs/framework/misc/security-transparent-code-level-2.md)を使用できます。 ただし、以前のセキュリティ規則で実行する必要があるレガシ コードを識別できるように、レベル 1 の透過性も残されています。  
+  
+> [!IMPORTANT]
+>  レベル 1 の透過性は、互換性を確保するためにのみ指定してください。つまり、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> を使用するか、透過性モデルを使用しない、.NET Framework 3.5 以前で開発されたコードに対してのみレベル 1 を指定してください。 たとえば、部分的に信頼された呼び出し元からの呼び出しを許可する .NET Framework 2.0 アセンブリ \(APTCA\) にはレベル 1 の透過性を使用します。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 用に開発されたコードには、常にレベル 2 の透過性を使用します。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [レベル 1 の透過性モデル](#the_level_1_transparency_model)  
+  
+-   [透過性属性](#transparency_attributes)  
+  
+-   [透過的セキュリティの例](#security_transparency_examples)  
+  
+<a name="the_level_1_transparency_model"></a>   
+## レベル 1 の透過性モデル  
+ レベル 1 の透過性を使用するときは、セキュリティ透過的、セキュリティ セーフ クリティカル、およびセキュリティ クリティカルの各方式にコードを分離するセキュリティ モデルを使用します。  
+  
+ アセンブリ全体、アセンブリ内の一部のクラス、またはクラス内の一部のメソッドを、セキュリティ透過的なコードとしてマークできます。 セキュリティ透過的なコードは特権を昇格することはできません。 この制限により、次の 3 つの効果が生まれます。  
+  
+-   セキュリティ透過的なコードは、<xref:System.Security.Permissions.SecurityAction> アクションを実行できません。  
+  
+-   セキュリティ透過的なコードによって満たされるリンク確認要求は、フル アクセス要求になります。  
+  
+-   セキュリティ透過的なコードで実行される必要のある安全でない \(検証できない\) コードは、<xref:System.Security.Permissions.SecurityPermissionFlag> セキュリティ アクセス許可に対するフル アクセス要求を発生させます。  
+  
+ これらの規則は、共通言語ランタイム \(CLR: Common Language Runtime\) による実行中に適用されます。 セキュリティ透過的なコードは、呼び出すコードのすべてのセキュリティ要件を、呼び出し元に返します。 セキュリティ透過的なコードを流れる確認要求では、特権を昇格できません。 信頼性の低いアプリケーションによってセキュリティ透過的なコードが呼び出され、高い特権の確認要求が発生した場合、その確認要求は信頼性の低いコードに戻されて失敗します。 セキュリティ透過的なコードはアサート アクションを実行できないので、確認要求を停止できません。 同じセキュリティ透過的なコードが、完全に信頼されているコードから呼び出された場合、確認要求は成功します。  
+  
+ セキュリティ クリティカルは、セキュリティ透過的の反対です。 セキュリティ クリティカルなコードは完全に信頼して実行され、特権が必要な操作をすべて実行できます。 セキュリティ セーフ クリティカルなコードは、広範なセキュリティ監査を経た特権コードであり、部分的に信頼された呼び出し元がアクセスを許可されていないリソースを使用するのを許可しないことが確認されています。  
+  
+ 透過性の適用は明示的に実行する必要があります。 通常、データ操作とロジックを処理するコードの大部分はセキュリティ透過的なコードとしてマークでき、特権の昇格を実行する少数のコードをセキュリティ クリティカルまたはセキュリティ セーフ クリティカルなコードとしてマークします。  
+  
+> [!IMPORTANT]
+>  レベル 1 の透過性は、アセンブリ スコープに限定されます。アセンブリ間には適用されません。 レベル 1 の透過性は、主に Microsoft 内でセキュリティ監査を目的として使用されていました。 レベル 1 アセンブリ内のセキュリティ クリティカルな型およびメンバーには、他のアセンブリのセキュリティ透過的なコードからアクセスできます。 重要なのは、すべてのレベル 1 のセキュリティ クリティカルな型およびメンバーで、完全な信頼のためにリンク確認要求を実行することです。 また、セキュリティ セーフ クリティカルな型およびメンバーでも、それらの型またはメンバーがアクセスする保護リソースに対するアクセス許可を呼び出し元が有していることを確認する必要があります。  
+  
+ 以前のバージョンの .NET Framework との下位互換性を維持するため、透過性属性の注釈が付けられていないメンバーはすべてセキュリティ セーフ クリティカルと見なされます。 注釈が付けられていない型はすべて透過的と見なされます。 透過性を検証するためのスタティック分析規則はありません。 したがって、透過性エラーを実行時にデバッグすることが必要になる場合があります。  
+  
+<a name="transparency_attributes"></a>   
+## 透過性属性  
+ コードの透過性を指定するために使用する 3 つの属性の説明を、次の表に示します。  
+  
+|属性|説明|  
+|--------|--------|  
+|<xref:System.Security.SecurityTransparentAttribute>|アセンブリ レベルでのみ使用できます。 アセンブリ内のすべての型とメンバーをセキュリティ透過的として指定します。 このアセンブリにセキュリティ クリティカルなコードを含めることはできません。|  
+|<xref:System.Security.SecurityCriticalAttribute>|<xref:System.Security.SecurityCriticalAttribute.Scope%2A> プロパティを設定せずにアセンブリ レベルで使用すると、アセンブリ内のすべてのコードは既定でセキュリティ透過的と指定されますが、アセンブリはセキュリティ クリティカルなコードを含むこともできると指定されます。<br /><br /> クラス レベルで使用すると、クラスまたはメソッドはセキュリティ クリティカルになりますが、クラスのメンバーはセキュリティ クリティカルになりません。 すべてのメンバーをセキュリティ クリティカルにするには、<xref:System.Security.SecurityCriticalAttribute.Scope%2A> プロパティを <xref:System.Security.SecurityCriticalScope> に設定します。<br /><br /> メンバー レベルで使用した場合、この属性はそのメンバーのみに適用されます。<br /><br /> セキュリティ クリティカルなクラスまたはメンバーは、特権の昇格を実行できます。 **Important:**  レベル 1 の透過性では、セキュリティ クリティカルな型およびメンバーは、アセンブリの外部から呼び出された場合に、セキュリティ セーフ クリティカルとして扱われます。 承認のない特権の昇格を防ぐために、セキュリティ クリティカルな型およびメンバーを完全な信頼のためのリンク確認要求で保護する必要があります。|  
+|<xref:System.Security.SecuritySafeCriticalAttribute>|アセンブリ内のセキュリティ透過的なコードからアクセスできるセキュリティ クリティカルなコードを指定します。 この属性を指定しない場合、セキュリティ透過的なコードは、同じアセンブリ内のプライベートまたは内部のセキュリティ クリティカルなメンバーにアクセスできません。 この属性を指定した場合、セキュリティ クリティカルなコードに影響が出て、予期しない特権の引き上げが可能になります。 セキュリティ セーフ クリティカルなコードについては、厳しいセキュリティ監査を実行する必要があります。 **Note:**  セキュリティ セーフ クリティカルな型およびメンバーでは、呼び出し元のアクセス許可を確認して、保護リソースにアクセスする権限を呼び出し元が有することを検証する必要があります。|  
+  
+ <xref:System.Security.SecuritySafeCriticalAttribute> 属性を使用すると、セキュリティ透過的なコードが、同じアセンブリ内のセキュリティ クリティカルなメンバーにアクセスできるようになります。 1 つのアセンブリに含まれるセキュリティ透過的なコードとセキュリティ クリティカルなコードは、2 つのアセンブリに分離されていると見なせます。 セキュリティ透過的なコードは、セキュリティ クリティカルなコードのプライベートまたは内部のメンバーを参照できません。 さらに、セキュリティ クリティカルなコードは、通常、そのコードのパブリック インターフェイスへのアクセスについて監査を受けます。 プライベートまたは内部の状態にアセンブリの外部からアクセスすることはできず、状態は分離されていると想定できます。<xref:System.Security.SecuritySafeCriticalAttribute> 属性を使用すると、透過的セキュリティ コードとセキュリティ クリティカルなコードの間で状態の分離を維持しながら、必要なときには分離を無視できるようになります。 セキュリティ クリティカルなコードのプライベートまたは内部のメンバーが <xref:System.Security.SecuritySafeCriticalAttribute> でマークされていない場合、セキュリティ透過的なコードはそのコードにアクセスできません。<xref:System.Security.SecuritySafeCriticalAttribute> を適用する場合は、事前に、パブリックに公開された場合と同じようにしてメンバーを監査してください。  
+  
+### アセンブリ全体の注釈  
+ アセンブリ レベルでセキュリティ属性を使用することの効果について次の表で説明します。  
+  
+|Assembly 属性|アセンブリの状態|  
+|-----------------|--------------|  
+|部分的に信頼されたアセンブリで属性なし|すべての型およびメンバーは透過的です。|  
+|完全に信頼されたアセンブリ \(グローバル アセンブリ キャッシュに存在または `AppDomain` で完全な信頼として指定\) で属性なし。|すべての型は透過的であり、すべてのメンバーはセキュリティ セーフ クリティカルです。|  
+|`SecurityTransparent`|すべての型およびメンバーは透過的です。|  
+|`SecurityCritical(SecurityCriticalScope.Everything)`|すべての型およびメンバーはセキュリティ クリティカルです。|  
+|`SecurityCritical`|すべてのコードは既定で透過的になります。 ただし、個々の型やメンバーに他の属性を設定することもできます。|  
+  
+<a name="security_transparency_examples"></a>   
+## 透過的セキュリティの例  
+ .NET Framework 2.0 の透過性規則 \(レベル 1 の透過性\) を使用するには、次のアセンブリ注釈を使用します。  
+  
+```  
+[assembly: SecurityRules(SecurityRuleSet.Level1)]  
+```  
+  
+ アセンブリ全体を透過的にして、アセンブリがクリティカルなコードを含まず、どのような方法でも特権を昇格しないことを示す必要がある場合は、次の属性を使用して、アセンブリに透過性を明示的に追加できます。  
+  
+```  
+[assembly: SecurityTransparent]  
+```  
+  
+ 同じアセンブリの中にクリティカルなコードと透過的なコードを混在させる場合は、次に示すように、最初に <xref:System.Security.SecurityCriticalAttribute> 属性をアセンブリにマークして、アセンブリがクリティカルなコードを含むことができることを示します。  
+  
+```  
+[assembly: SecurityCritical]  
+```  
+  
+ セキュリティ クリティカルな操作を実行する場合は、次のコード例で示すように、別の <xref:System.Security.SecurityCriticalAttribute> 属性を使用して、クリティカルな操作を実行するコードを明示的にマークする必要があります。  
+  
+```  
+[assembly: SecurityCritical] Public class A { [SecurityCritical] private void Critical() { // critical } public int SomeProperty { get {/* transparent */ } set {/* transparent */ } } } public class B { internal string SomeOtherProperty { get { /* transparent */ } set { /* transparent */ } } }  
+```  
+  
+ 上記のコードは、`Critical` メソッドを明示的にセキュリティ クリティカルとしてマークしている以外は、透過的です。 アセンブリ レベルで <xref:System.Security.SecurityCriticalAttribute> 属性が指定されていても、既定の設定は透過的です。  
+  
+## 参照  
+ [透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md)   
+ [セキュリティの変更点](../../../docs/framework/security/security-changes.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-transparent-code-level-2.md b/docs/framework/misc/security-transparent-code-level-2.md
new file mode 100644
index 00000000000..1362e717c4b
--- /dev/null
+++ b/docs/framework/misc/security-transparent-code-level-2.md
@@ -0,0 +1,210 @@
+---
+title: "透過的セキュリティ コード、レベル 2 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "レベル 2 の透過性"
+  - "セキュリティ クリティカルなコード"
+  - "セキュリティが透過的なコード"
+  - "透明度"
+ms.assetid: 4d05610a-0da6-4f08-acea-d54c9d6143c0
+caps.latest.revision: 37
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# 透過的セキュリティ コード、レベル 2
+<a name="top"></a> レベル 2 の透過性は、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] で導入されました。 このモデルには、透過的なコード、セキュリティ セーフ クリティカル コード、およびセキュリティ クリティカル コードの 3 つの基本思想があります。  
+  
+-   透過的なコード \(完全に信頼されて実行されているコードを含む\) は、他の透過的なコードまたはセキュリティ セーフ クリティカル コードのみを呼び出すことができます。 また、ドメインの部分信頼アクセス許可セット \(存在する場合\) で許可されるアクションのみを実行できます。 透過的なコードでは、次のアクションは実行できません。  
+  
+    -   特権の <xref:System.Security.CodeAccessPermission.Assert%2A> または昇格を実行する。  
+  
+    -   アンセーフ コードまたは検証不可能なコードを含める。  
+  
+    -   クリティカル コードを直接呼び出す。  
+  
+    -   ネイティブ コードまたは <xref:System.Security.SuppressUnmanagedCodeSecurityAttribute> 属性を持つコードを呼び出す。  
+  
+    -   <xref:System.Security.Permissions.SecurityAction> によって保護されているメンバーを呼び出す。  
+  
+    -   クリティカルな型を継承する。  
+  
+     また、透過的メソッドでは、クリティカルな仮想メソッドをオーバーライドしたりクリティカルなインターフェイス メソッドを実装したりすることはできません。  
+  
+-   セーフ クリティカル コードは完全に信頼されていますが、透過的なコードから呼び出すことができます。 また、完全に信頼されたコードのうち限られた領域のみを公開します。正確性とセキュリティの検証はセーフ クリティカル コード内で実行されます。  
+  
+-   セキュリティ クリティカル コードは任意のコードを呼び出すことができ、完全に信頼されていますが、透過的なコードから呼び出すことはできません。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [使用例と動作](#examples)  
+  
+-   [オーバーライドのパターン](#override)  
+  
+-   [継承規則](#inheritance)  
+  
+-   [追加情報と規則](#additional)  
+  
+<a name="examples"></a>   
+## 使用例と動作  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の規則 \(レベル 2 の透過性\) を指定するには、アセンブリに対して次の注釈を使用します。  
+  
+```  
+[assembly: SecurityRules(SecurityRuleSet.Level2)]  
+```  
+  
+ .NET Framework 2.0 のルール \(レベル 1 の透過性\) にロックするには、次の注釈に使用します。  
+  
+```  
+[assembly: SecurityRules(SecurityRuleSet.Level1)]  
+```  
+  
+ アセンブリに注釈を付けない場合は、既定で、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の規則が使用されます。 ただし、既定値に頼らずに、<xref:System.Security.SecurityRulesAttribute> 属性を使用することをお勧めします。  
+  
+### アセンブリ全体の注釈  
+ アセンブリ レベルでの属性の使用には、次の規則が適用されます。  
+  
+-   属性なし: 属性を指定しない場合は、ランタイムによってすべてのコードがセキュリティ クリティカルとして解釈されます。ただし、セキュリティ クリティカルであると継承規則に違反する場合 \(たとえば、透過的な仮想メソッドまたはインターフェイス メソッドをオーバーライドまたは実装する場合\) は除きます。 そのような場合、メソッドはセーフ クリティカルになります。 属性を指定しない場合、透過性規則は共通言語ランタイムによって自動的に判断されます。  
+  
+-   `SecurityTransparent`: すべてのコードが透過的になります。アセンブリ全体で特権の必要な操作や安全でない操作は実行されません。  
+  
+-   `SecurityCritical`: このアセンブリ内の型によって導入されるすべてのコードはクリティカルになり、その他のすべてのコードは透過的になります。 このシナリオは属性を指定しない場合に似ていますが、共通言語ランタイムによって透過性規則が自動的に判断されることはありません。 たとえば、仮想メソッドまたは抽象メソッドをオーバーライドしたり、インターフェイス メソッドを実装したりする場合、既定では、そのメソッドは透過的になります。 そのメソッドには `SecurityCritical` または `SecuritySafeCritical` の注釈を明示的に付ける必要があります。そうしないと、読み込み時に <xref:System.TypeLoadException> がスローされます。 この規則は、基底クラスと派生クラスの両方が同じアセンブリ内にある場合にも適用されます。  
+  
+-   `AllowPartiallyTrustedCallers` \(レベル 2 のみ\): すべてのコードが既定で透過的になります。 ただし、個々の型やメンバーに他の属性を設定することもできます。  
+  
+ レベル 2 とレベル 1 のアセンブリ レベルの動作の比較を次の表に示します。  
+  
+|Assembly 属性|レベル 2|レベル 1|  
+|-----------------|-----------|-----------|  
+|部分的に信頼されたアセンブリで属性なし|型およびメンバーは既定で透過的になりますが、セキュリティ クリティカルまたはセキュリティ セーフ クリティカルにすることもできます。|すべての型およびメンバーは透過的です。|  
+|属性なし|属性を指定しない場合、透過性規則は共通言語ランタイムによって自動的に判断されます。 すべての型およびメンバーはセキュリティ クリティカルになります \(ただし、セキュリティ クリティカルになると継承ルールに違反する場所を除く\)。|完全に信頼されたアセンブリ \(グローバル アセンブリ キャッシュ内に存在するか、`AppDomain` で完全に信頼と指定されている\) では、すべての型は透過的であり、すべてのメンバーはセキュリティ セーフ クリティカルです。|  
+|`SecurityTransparent`|すべての型およびメンバーは透過的です。|すべての型およびメンバーは透過的です。|  
+|`SecurityCritical(SecurityCriticalScope.Everything)`|該当しない。|すべての型およびメンバーはセキュリティ クリティカルです。|  
+|`SecurityCritical`|このアセンブリ内の型によって導入されるすべてのコードはクリティカルになり、その他のすべてのコードは透過的になります。 仮想メソッドまたは抽象メソッドをオーバーライドしたり、インターフェイス メソッドを実装したりする場合は、メソッドに `SecurityCritical` または `SecuritySafeCritical` の注釈を明示的に付ける必要があります。|すべてのコードは既定で透過的になります。 ただし、個々の型やメンバーに他の属性を設定することもできます。|  
+  
+### 型およびメンバーの注釈  
+ 型に適用されるセキュリティ属性は、その型によって導入されるメンバーにも適用されます。 ただし、基底クラスまたはインターフェイスの実装の仮想オーバーライドや抽象オーバーライドには適用されません。 型およびメンバーのレベルでの属性の使用には、次の規則が適用されます。  
+  
+-   `SecurityCritical`: 型またはメンバーはクリティカルで、完全に信頼されているコードからのみ呼び出すことができます。 セキュリティ クリティカルな型で導入されるメソッドはクリティカルです。  
+  
+    > [!IMPORTANT]
+    >  基底クラスまたはインターフェイスで導入されてセキュリティ クリティカルなクラスでオーバーライドまたは実装される仮想メソッドおよび抽象メソッドは、既定では透過的です。 これらのメソッドは、`SecuritySafeCritical` または `SecurityCritical` のいずれかとして指定する必要があります。  
+  
+-   `SecuritySafeCritical`: 型またはメンバーはセーフ クリティカルです。 ただし、型またはメンバーは透過的な \(部分的に信頼された\) コードから呼び出すことができ、機能的に他のクリティカル コードと同等になります。 コードはセキュリティ監査を受ける必要があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="override"></a>   
+## オーバーライドのパターン  
+ レベル 2 の透過性で使用できるメソッドのオーバーライドを次の表に示します。  
+  
+|基底クラスの仮想\/インターフェイス メンバー|オーバーライド\/インターフェイス|  
+|-----------------------------|-----------------------|  
+|`Transparent`|`Transparent`|  
+|`Transparent`|`SafeCritical`|  
+|`SafeCritical`|`Transparent`|  
+|`SafeCritical`|`SafeCritical`|  
+|`Critical`|`Critical`|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="inheritance"></a>   
+## 継承規則  
+ このセクションでは、アクセスおよび機能に基づいて、次の順序が `Transparent`、`Critical`、および `SafeCritical` のコードに割り当てられています。  
+  
+ `Transparent` \< `SafeCritical` \< `Critical`  
+  
+-   型の規則: 左から右に向かってアクセス制限がより厳しくなります。 派生型は、基本型と少なくとも同じ程度に制限する必要があります。  
+  
+-   メソッドの規則。基底メソッドのアクセシビリティを派生メソッドで変更することはできません。 既定の動作では、注釈のない派生メソッドはすべて `Transparent` になります。 クリティカルな型の派生型では、オーバーライドしたメソッドに `SecurityCritical` の注釈が明示的に付けられていない場合に、例外がスローされます。  
+  
+ 次の表に、使用できる型の継承パターンを示します。  
+  
+|基底クラス|派生クラスで可能なレベル|  
+|-----------|------------------|  
+|`Transparent`|`Transparent`|  
+|`Transparent`|`SafeCritical`|  
+|`Transparent`|`Critical`|  
+|`SafeCritical`|`SafeCritical`|  
+|`SafeCritical`|`Critical`|  
+|`Critical`|`Critical`|  
+  
+ 次の表に、使用できない型の継承パターンを示します。  
+  
+|基底クラス|派生クラスで不可のレベル|  
+|-----------|------------------|  
+|`SafeCritical`|`Transparent`|  
+|`Critical`|`Transparent`|  
+|`Critical`|`SafeCritical`|  
+  
+ 次の表に、使用できるメソッドの継承パターンを示します。  
+  
+|基底メソッド|派生メソッドで可能なレベル|  
+|------------|-------------------|  
+|`Transparent`|`Transparent`|  
+|`Transparent`|`SafeCritical`|  
+|`SafeCritical`|`Transparent`|  
+|`SafeCritical`|`SafeCritical`|  
+|`Critical`|`Critical`|  
+  
+ 次の表に、使用できないメソッドの継承パターンを示します。  
+  
+|基底メソッド|派生メソッドで不可のレベル|  
+|------------|-------------------|  
+|`Transparent`|`Critical`|  
+|`SafeCritical`|`Critical`|  
+|`Critical`|`Transparent`|  
+|`Critical`|`SafeCritical`|  
+  
+> [!NOTE]
+>  これらの継承規則は、レベル 2 の型およびメンバーに適用されます。 レベル 1 アセンブリ内の型は、レベル 2 のセキュリティ クリティカルな型およびメンバーから継承できます。 したがって、レベル 2 の型およびメンバーでは、レベル 1 の継承先に対して個別の継承確認要求が必要です。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="additional"></a>   
+## 追加情報と規則  
+  
+### LinkDemand のサポート  
+ レベル 2 の透過性モデルでは、<xref:System.Security.Permissions.SecurityAction> は <xref:System.Security.SecurityCriticalAttribute> 属性に置き換えられます。 レガシ \(レベル 1\) コードでは、<xref:System.Security.Permissions.SecurityAction> は自動的 <xref:System.Security.Permissions.SecurityAction> として扱われます。  
+  
+### 反射  
+ クリティカル メソッドを呼び出したりクリティカル フィールドを読み取ったりすると、完全信頼の確認要求がトリガーされます \(プライベート メソッドまたはプライベート フィールドを呼び出す場合と同様\)。 したがって、完全に信頼されているコードではクリティカル メソッドを呼び出すことができるのに対し、部分的に信頼されたコードでは呼び出すことができません。  
+  
+ <xref:System.Reflection> 名前空間に追加された <xref:System.Type.IsSecurityCritical%2A>、<xref:System.Reflection.MethodBase.IsSecuritySafeCritical%2A>、および <xref:System.Reflection.MethodBase.IsSecurityTransparent%2A> の各プロパティを使用すると、型、メソッド、またはフィールドが `SecurityCritical`、`SecuritySafeCritical`、または `SecurityTransparent` のどれであるかを判断できます。 属性の存在を確認する代わりに、リフレクションを使用して透過性を判断するには、これらのプロパティを使用します。 透過性の規則は複雑なので、属性のチェックでは不十分なことがあります。  
+  
+> [!NOTE]
+>  `SafeCritical` メソッドは、<xref:System.Type.IsSecurityCritical%2A>`` と <xref:System.Reflection.MethodBase.IsSecuritySafeCritical%2A> の両方に対して `true` を返します。`SafeCritical` が実際にクリティカルである \(クリティカル コードと同じ機能を持つが、透過的なコードから呼び出すことができる\) ためです。  
+  
+ 動的メソッドは、関連付けられているモジュールの透過性を継承します。型の透過性は継承しません \(型に関連付けられている場合\)。  
+  
+### 完全な信頼での検証のスキップ  
+ 完全に信頼されている透過的なアセンブリの検証をスキップするには、<xref:System.Security.SecurityRulesAttribute> 属性の <xref:System.Security.SecurityRulesAttribute.SkipVerificationInFullTrust%2A> プロパティを `true` に設定します。  
+  
+ `[assembly: SecurityRules(SecurityRuleSet.Level2, SkipVerificationInFullTrust = true)]`  
+  
+ <xref:System.Security.SecurityRulesAttribute.SkipVerificationInFullTrust%2A> プロパティは既定では `false` であるため、検証をスキップするにはこのプロパティを `true` に設定する必要があります。 これをするのは、最適化のためだけにしてください。 アセンブリの透過的なコードが検証可能なことを確認するために、[PEVerify ツール](../../../docs/framework/tools/peverify-exe-peverify-tool.md) で `transparent` オプションを使用してください。  
+  
+## 参照  
+ [透過的セキュリティ コード、レベル 1](../../../docs/framework/misc/security-transparent-code-level-1.md)   
+ [セキュリティの変更点](../../../docs/framework/security/security-changes.md)
\ No newline at end of file
diff --git a/docs/framework/misc/security-transparent-code.md b/docs/framework/misc/security-transparent-code.md
new file mode 100644
index 00000000000..8b3943de36f
--- /dev/null
+++ b/docs/framework/misc/security-transparent-code.md
@@ -0,0 +1,120 @@
+---
+title: "透過的セキュリティ コード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "セキュリティが透過的なコード"
+  - "透過的なコード"
+ms.assetid: 4f3dd841-82f7-4659-aab0-6d2db2166c65
+caps.latest.revision: 24
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 透過的セキュリティ コード
+<a name="top"></a> [!INCLUDE[net_security_note](../../../includes/net-security-note-md.md)]  
+  
+ セキュリティは、サンドボックス化、アクセス許可、および適用の 3 つの相互作用を伴います。 サンドボックス化とは、完全に信頼されるコードとして扱われるコードとサンドボックスの許可セットのアクセス許可に制限されるコードが存在する分離ドメインを作成することを示します。 サンドボックスの許可セット内で実行されるアプリケーション コードは、透過的と見なされます。つまり、セキュリティに影響する可能性がある操作は実行できません。 サンドボックスの許可セットは、証拠 \(<xref:System.Security.Policy.Evidence> クラス\) によって決定されます。 証拠は、どのアクセス許可がサンドボックスで必要か、およびどの種類のサンドボックスを作成できるかを指定します。 適用とは、透過的なコードを許可セット内でのみ実行できるようにすることを示します。  
+  
+> [!IMPORTANT]
+>  以前のバージョンの .NET Framework では、セキュリティ ポリシーが主要な要素でした。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、セキュリティ ポリシーは廃止されました。 セキュリティ ポリシーの削除は、透過的セキュリティとは別の変更点です。 この変更の影響については、「[コード アクセス セキュリティ ポリシーの互換性と移行](../../../docs/framework/misc/code-access-security-policy-compatibility-and-migration.md)」をご覧ください。  
+  
+ ここでは、透過性モデルについて詳しく説明します。 このチュートリアルは、次のセクションで構成されています。  
+  
+-   [透過性モデルの目的](#purpose)  
+  
+-   [透過度の指定](#level)  
+  
+-   [透過性の適用](#enforcement)  
+  
+<a name="purpose"></a>   
+## 透過性モデルの目的  
+ 透過性は、アプリケーションの一部として実行されるコードをインフラストラクチャの一部として実行されるコードから分離する適用機構です。 透過性は、ネイティブ コードの呼び出しなどの特権的な処理を実行できるコード \(クリティカル コード\) と、そのような処理を実行できないコード \(透過的なコード\) との間に、障壁を設けます。 透過的なコードでは、コードに適用されたアクセス許可セットの範囲内のコマンドを実行できますが、クリティカル コードを実行することはできません。また、クリティカル コードから派生したりクリティカル コードを含めたりすることもできません。  
+  
+ 透過性を適用する主な目的は、特権に基づいてさまざまなコード グループを分離する簡単で効果的な機構を実現することです。 サンドボックス モデルのコンテキストでは、これらの特権グループは完全に信頼されるか \(制限がありません\) 部分的に信頼されます \(サンドボックスに付与されたアクセス許可セットに制限されます\)。  
+  
+> [!IMPORTANT]
+>  透過性モデルは、コード アクセス セキュリティよりも優先されます。 透過性は JIT \(Just\-In\-Time\) コンパイラによって適用され、完全信頼を含むアセンブリの許可セットに関係なく有効になります。  
+  
+ 透過性は、セキュリティ モデルを簡略化して安全なライブラリやアプリケーションを簡単に作成および配置できるようにするために、.NET Framework Version 2.0 で導入されました。 また、透過的なコードは、部分的に信頼されたアプリケーションを簡単に開発できるようにするために Microsoft Silverlight でも使用されます。  
+  
+> [!NOTE]
+>  部分的に信頼されたアプリケーションを開発する場合は、対象ホストで必要とされるアクセス許可に注意する必要があります。 一部のホストで許可されていないリソースを使用するアプリケーションを開発できます。 このアプリケーションではコンパイル エラーは発生しませんが、ホストされた環境に読み込まれるときにエラーが発生します。 Visual Studio を使用してアプリケーションを開発した場合は、開発環境から、部分信頼または制限されたアクセス許可セットでのデバッグを有効にできます。 詳細については、「[方法 : アクセス許可が制限された ClickOnce アプリケーションをデバッグする](../Topic/How%20to:%20Debug%20a%20ClickOnce%20Application%20with%20Restricted%20Permissions.md)」を参照してください。 ClickOnce アプリケーションに対して用意されている "アクセス許可の検出" 機能は、部分的に信頼されたアプリケーションにも使用できます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="level"></a>   
+## 透過度の指定  
+ アセンブリ レベルの <xref:System.Security.SecurityRulesAttribute> 属性では、アセンブリが従う <xref:System.Security.SecurityRuleSet> 規則が明示的に選択されます。 規則は、レベルが高いほどセキュリティ規則の適用が厳密になる数値レベルのシステムで編成されます。  
+  
+ レベルは次のとおりです。  
+  
+-   レベル 2 \(<xref:System.Security.SecurityRuleSet>\) – [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の透過性規則。  
+  
+-   レベル 1 \(<xref:System.Security.SecurityRuleSet>\) – .NET Framework 2.0 の透過性規則。  
+  
+ 2 つの透過度の主な相違点は、レベル 1 はアセンブリの外部からの呼び出しに透過性規則を適用せず、互換性を確保するためにのみ使用されるという点です。  
+  
+> [!IMPORTANT]
+>  レベル 1 の透過性は、互換性を確保するためにのみ指定してください。つまり、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性を使用するか透過性モデルを使用しない .NET Framework 3.5 以前で開発されたコードに対してのみレベル 1 を指定してください。 たとえば、部分的に信頼された呼び出し元からの呼び出しを許可する .NET Framework 2.0 アセンブリ \(APTCA\) にはレベル 1 の透過性を使用します。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 用に開発されたコードには、常にレベル 2 の透過性を使用します。  
+  
+### レベル 2 の透過性  
+ レベル 2 の透過性は、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] で導入されました。 このモデルには、透過的なコード、セキュリティ セーフ クリティカル コード、およびセキュリティ クリティカル コードの 3 つの基本思想があります。  
+  
+-   透過的なコードは、付与されているアクセス許可に関係なく \(完全信頼を含む\)、他の透過的なコードまたはセキュリティ セーフ クリティカル コードのみを呼び出すことができます。 コードが部分的に信頼されている場合は、ドメインのアクセス許可セットで許可されるアクションのみを実行できます。 透過的なコードでは、次のアクションは実行できません。  
+  
+    -   特権の <xref:System.Security.CodeAccessPermission.Assert%2A> 操作または昇格を実行する。  
+  
+    -   アンセーフ コードまたは検証不可能なコードを含める。  
+  
+    -   クリティカル コードを直接呼び出す。  
+  
+    -   ネイティブ コードまたは <xref:System.Security.SuppressUnmanagedCodeSecurityAttribute> 属性を持つコードを呼び出す。  
+  
+    -   <xref:System.Security.Permissions.SecurityAction> によって保護されているメンバーを呼び出す。  
+  
+    -   クリティカルな型を継承する。  
+  
+     また、透過的メソッドでは、クリティカルな仮想メソッドをオーバーライドしたりクリティカルなインターフェイス メソッドを実装したりすることはできません。  
+  
+-   セキュリティ セーフ クリティカル コードは完全に信頼されていますが、透過的なコードから呼び出すことができます。 完全に信頼されているコードの限られた領域しか外部に公開されないようにします。 正確性とセキュリティの検証はセーフ クリティカル コードで実行されます。  
+  
+-   セキュリティ クリティカル コードは任意のコードを呼び出すことができ、完全に信頼されていますが、透過的なコードから呼び出すことはできません。  
+  
+### レベル 1 の透過性  
+ レベル 1 の透過性モデルは、開発者がセキュリティ監査の対象になるコードの量を減らすことができるようにするために、.NET Framework Version 2.0 で導入されました。 レベル 1 の透過性は Version 2.0 で一般に公開されましたが、主に Microsoft 内でのみセキュリティ監査を目的として使用されていました。 注釈を付けることで、セキュリティ昇格やその他の信頼されたアクションを実行できる型およびメンバー \(セキュリティ クリティカル\) と、実行できない型およびメンバー \(透過的セキュリティ\) を宣言できるようになりました。 透過的なコードでは、高度なセキュリティ監査は不要です。 レベル 1 の透過性は、透過性の適用がアセンブリ内に限定されることを示します。 つまり、セキュリティ クリティカルなパブリック型またはメンバーは、アセンブリ内でのみセキュリティ クリティカルです。 アセンブリの外部から呼び出される場合にこのような型およびメンバーにセキュリティを適用するには、完全な信頼のためのリンク確認要求を使用する必要があります。 使用しないと、パブリックに参照できるセキュリティ クリティカルな型およびメンバーは、セキュリティ セーフ クリティカルとして扱われ、部分的に信頼されているコードによってアセンブリの外部から呼び出すことができます。  
+  
+ レベル 1 の透過性モデルには次の制限があります。  
+  
+-   セキュリティ クリティカルなパブリック型およびパブリック メンバーは、透過的セキュリティ コードからアクセスできます。  
+  
+-   透過性注釈はアセンブリ内でのみ適用されます。  
+  
+-   セキュリティ クリティカルな型およびメンバーでは、アセンブリの外部から呼び出される場合にセキュリティを適用するには、リンク確認要求を使用する必要があります。  
+  
+-   継承規則は適用されません。  
+  
+-   透過的なコードは、完全に信頼して実行されると危険性をもたらす可能性があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="enforcement"></a>   
+## 透過性の適用  
+ 透過性規則は、透過性が計算されるまで適用されません。 このとき、透過性規則に違反すると、<xref:System.InvalidOperationException> がスローされます。 透過性が計算されるタイミングは、複数の要因によって左右されるので予測できません。 できる限り遅く計算されます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、アセンブリ レベルの透過性の計算は、.NET Framework 2.0 よりも早く実行されます。 保証されるのは、必要になるまでに透過性の計算が行われるということだけです。 これは、メソッドがコンパイルされてメソッドのエラーが検出される時点が JIT コンパイラで変更される方法に似ています。 透過性の計算は、コードに透過性エラーがない場合は目に見えません。  
+  
+## 参照  
+ [透過的セキュリティ コード、レベル 1](../../../docs/framework/misc/security-transparent-code-level-1.md)   
+ [透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md)
\ No newline at end of file
diff --git a/docs/framework/misc/using-libraries-from-partially-trusted-code.md b/docs/framework/misc/using-libraries-from-partially-trusted-code.md
new file mode 100644
index 00000000000..25f775e3ff4
--- /dev/null
+++ b/docs/framework/misc/using-libraries-from-partially-trusted-code.md
@@ -0,0 +1,70 @@
+---
+title: "部分信頼コードからのライブラリの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "AllowPartiallyTrustedCallersAttribute 属性"
+  - "APTCA"
+  - "コード アクセス セキュリティ, 部分的に信頼されるコード"
+  - "部分信頼"
+  - "部分的に信頼されるコード"
+  - "セキュリティ [.NET Framework], 部分的に信頼されるコード"
+ms.assetid: dd66cd4c-b087-415f-9c3e-94e3a1835f74
+caps.latest.revision: 25
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 部分信頼コードからのライブラリの使用
+> [!NOTE]
+>  このトピックでは、厳密な名前を付けたアセンブリの動作について説明し、[レベル 1](../../../docs/framework/misc/security-transparent-code-level-1.md) のアセンブリにのみ適用します。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降の[透過的セキュリティ コード、レベル 2](../../../docs/framework/misc/security-transparent-code-level-2.md) アセンブリは、厳密な名前の影響を受けません。 セキュリティ システムへの変更の詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework におけるコード アクセス セキュリティを、部分的に信頼できるコード、特に発生元の不明なコードのセキュリティ境界として使用しないでください。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+ ホストまたはサンドボックスから不完全な信頼を受けているアプリケーションは、ライブラリの作成者が <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性を使用して具体的に許可しない限り、共有マネージ ライブラリを呼び出せません。 そのため、アプリケーションの作成者は、ライブラリによっては部分的に信頼されたコンテキストから使用できないことを認識する必要があります。 既定では、部分的に信頼された[サンドボックス](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)で実行し、完全に信頼されたアセンブリの一覧にないコードはすべて、部分的に信頼されたコードです。 部分的に信頼されたコンテキストからコードを実行する、または部分的に信頼されたコードによってコードが呼び出されることはないと考えられる場合は、このセクションの情報を考慮する必要はありません。 ただし、部分的に信頼されたコードと対話する必要があるコード、または部分的に信頼されたコンテキストから操作するコードを記述する場合は、次の要因を考慮する必要があります。  
+  
+-   ライブラリは、複数のアプリケーションで共有するために、厳密な名前で署名する必要があります。 厳密な名前を使用すると、コードをグローバル アセンブリ キャッシュに配置したり、サンドボックス化する <xref:System.AppDomain> の完全信頼一覧に追加したりできます。また、コンシューマーは、実際にあなたが発信する特定のモバイル コードを確認することができます。  
+  
+-   既定では、厳密な名前[レベル 1](../../../docs/framework/misc/security-transparent-code-level-1.md) 共有ライブラリは、完全信頼のために暗黙的な [LinkDemand](../../../docs/framework/misc/link-demands.md) を実行します。ライブラリの作成者は何もする必要はありません。  
+  
+-   呼び出し元に完全な信頼がないにもかかわらず、このようなライブラリを呼び出そうとする場合、ランタイムは <xref:System.Security.SecurityException> をスローします。これにより、呼び出し元はライブラリにリンクできなくなります。  
+  
+-   自動の **LinkDemand** を無効にして例外がスローされないようにするために、**AllowPartiallyTrustedCallersAttribute** 属性を共有ライブラリのアセンブリのスコープに配置することができます。 この属性により、部分的に信頼されたマネージ コードからライブラリを呼び出すことができます。  
+  
+-   それでも、この属性を持つライブラリへのアクセスが許可されている部分的に信頼されたコードは、<xref:System.AppDomain> が定義する追加の制約を受けます。  
+  
+-   部分的に信頼されたコードが **AllowPartiallyTrustedCallersAttribute**  属性を持たないライブラリをプログラム上で呼び出す方法はありません。  
+  
+ 特定のアプリケーションにとってプライベートなライブラリには、厳密な名前または**AllowPartiallyTrustedCallersAttribute** 属性は必要ありません。また、アプリケーションの外部にある潜在的に悪意のあるコードによって参照することはできません。 このようなコードは、部分的に信頼されたモバイル コードの意図的または意図的でない誤使用から保護されています。開発者は追加で何かをする必要はありません。  
+  
+ 次の種類のコードについて、部分的に信頼されたコードによる使用を明示的に有効にすることを検討してください。  
+  
+-   セキュリティの脆弱性を入念にテストされ、「[安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)」に記載されたガイドラインに準拠しているコード。  
+  
+-   部分的に信頼されたシナリオ用に特に記述された厳密な名前のコード ライブラリ。  
+  
+-   インターネットからダウンロードしたコードによって呼び出される、厳密な名前で署名された \(部分的に信頼された、または完全に信頼された\) すべてのコンポーネント。  
+  
+> [!NOTE]
+>  .NET Framework クラス ライブラリの一部のクラスは、**AllowPartiallyTrustedCallersAttribute** 属性がないため、部分的に信頼されたコードから呼び出すことはできません。  
+  
+## 参照  
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)
\ No newline at end of file
diff --git a/docs/framework/misc/using-the-assert-method.md b/docs/framework/misc/using-the-assert-method.md
new file mode 100644
index 00000000000..a8aff23d84e
--- /dev/null
+++ b/docs/framework/misc/using-the-assert-method.md
@@ -0,0 +1,184 @@
+---
+title: "Assert メソッドの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Assert メソッド"
+  - "アサートされたアクセス許可"
+  - "呼び出し元のセキュリティ チェック"
+  - "コード アクセス セキュリティ, オーバーライド (セキュリティ チェックの)"
+  - "付与 (アクセス許可の), オーバーライド (セキュリティ チェックの)"
+  - "オーバーライド (セキュリティ チェックの)"
+  - "アクセス許可 [.NET Framework], アサーション"
+  - "アクセス許可 [.NET Framework], オーバーライド (セキュリティ チェックの)"
+  - "セキュリティ [.NET Framework], アサーション"
+  - "セキュリティ [.NET Framework], オーバーライド (セキュリティ チェックの)"
+ms.assetid: 1e40f4d3-fb7d-4f19-b334-b6076d469ea9
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Assert メソッドの使用
+<xref:System.Security.CodeAccessPermission.Assert%2A> は、コードのアクセス許可のクラスおよび <xref:System.Security.PermissionSet>クラスで呼び出すことができるメソッドです。  **Assert** を使用すると、コード \(および下流の呼び出し元\) が、コードには実行のアクセス許可があるものの、その呼び出し元には実行のアクセス許可がない可能性がある操作を実行できるようになります。  セキュリティ アサーションは、セキュリティ チェック時にランタイムが実行する正常なプロセスを変更します。  アクセス許可をアサートすると、アサートされたアクセス許可のためにコードの呼び出し元をチェックしないようセキュリティ システムに指示します。  
+  
+> [!CAUTION]
+>  アサーションはセキュリティ ホールを開き、セキュリティの制限事項を適用するランタイムのメカニズムを弱体化させる可能性があるため、慎重に使用してください。  
+  
+ アサーションは、ライブラリがアンマネージ コードを呼び出す状況、またはライブラリの使用目的と明らかに関係のないアクセス許可を必要とする呼び出しを行う状況に役立ちます。  たとえば、アンマネージ コードを呼び出すすべてのマネージ コードには、**UnmanagedCode** フラグが指定された **SecurityPermission** が含まれている必要があります。  ローカルのイントラネットからダウンロードするコードなど、ローカル コンピューターから発生していないコードには、既定でこのアクセス許可は付与されません。  そのため、ローカルのイントラネットからダウンロードするコードがアンマネージ コードを使用するライブラリを呼び出せるようにするには、ライブラリによってアサートされたアクセス許可がコードに指定されている必要があります。  さらに、ライブラリによっては呼び出し元からは見えない呼び出し、および特別なアクセス許可を必要とする呼び出しを行う場合があります。  
+  
+ また、コードが呼び出し元から完全に非表示にされる方法でリソースにアクセスする状況において、アサーションを使用することもできます。  たとえば、ライブラリがデータベースから情報を取得しますが、プロセス内でコンピューターのレジストリからも情報を読み取ると仮定してください。  ライブラリを使用する開発者は、ソースにアクセスできないため、開発者のコードがユーザーのコードを使用するために **RegistryPermission** を必要としていることを知る方法がありません。  この場合、コードの呼び出し元がレジストリへのアクセス許可を持つことを求めるのは妥当でないか不必要と判断した場合は、レジストリを読み取るアクセス許可をアサートすることができます。  この状況では、**RegistryPermission** がない呼び出し元がライブラリを使用できるように、ライブラリがアクセス許可をアサートすることが適切です。  
+  
+ アサーションがスタック ウォークに影響を与えるのは、アサートされたアクセス許可および下流の呼び出し元によって要求されるアクセス許可が同じ型である場合、かつ要求されたアクセス許可がアサートされているアクセス許可のサブセットである場合のみです。  たとえば、**FileIOPermission** を C ドライブのすべてのファイルを読み取るようにアサートする場合、かつ **FileIOPermission** に対して C:\\Temp 内のファイルを読み取る下流からの要求が行われた場合、アサーションはスタック ウォークに影響を与える可能性があります。 ただし、要求が **FileIOPermission** に対して C ドライブに書き込む要求であった場合、アサーションの影響はありません。  
+  
+ アサーションを実行する場合、コードにアサートしているアクセス許可と、アサーションを実行する権利を表す <xref:System.Security.Permissions.SecurityPermission> の両方が付与されている必要があります。  コードに付与されていないアクセス許可をアサートすることができますが、アサーションがセキュリティ チェックを成功させようとする前にセキュリティ チェックが失敗するため、アサーションが無意味になってしまいます。  
+  
+ 次の図は、**Assert** を使用する際に発生することを示しています。  次のステートメントについて、アセンブリ A、B、C、E、および F が true であり、P1 と P1A という 2 つのアクセス許可があると仮定してください。  
+  
+-   P1A は C ドライブ上の .txt ファイルを読み取る権限を表します。  
+  
+-   P1 は C ドライブ上のすべてのファイルを読み取る権限を表します。  
+  
+-   P1A と P1 はいずれも**FileIOPermission** 型で、P1A は P1 のサブセットです。  
+  
+-   アセンブリ E と F には P1A のアクセス許可が付与されています。  
+  
+-   アセンブリ C には P1 のアクセス許可が付与されています。  
+  
+-   アセンブリ A と B には P1 と P1A のアクセス許可のいずれも付与されていません。  
+  
+-   メソッド A はアセンブリ A 内にあり、メソッド B はアセンブリ B 内にあり、以下同様です。  
+  
+ ![](../../../docs/framework/misc/media/assert.gif "assert")  
+Assert の使用  
+  
+ このシナリオでは、メソッド A が B を呼び出し、B が C、C が E、E が F をそれぞれ呼び出します。  メソッド C は C ドライブ上のファイルを読み取るアクセス許可 \(P1 のアクセス許可\) をアサートします。メソッド E は C ドライブ上の .txt ファイルを読み取るアクセス許可 \(P1A のアクセス許可\) を要求します。  実行時に F で要求が発生した場合、E から開始して F の全呼び出し元のアクセス許可をチェックするスタック ウォークが実行されます。  E には P1A のアクセス許可が付与されているため、スタック ウォークは、C のアサーションが発見された C のアクセス許可を調べるために続行します。  要求されたアクセス許可 \(P1A\) は、アサートされたアクセス許可 \(P1\) のサブセットであるため、スタック ウォークが停止し、セキュリティ チェックは自動的に成功します。  アセンブリ A と B に P1A のアクセス許可が付与されていないことは関係ありません。  P1 をアサートすることで、メソッド C は、呼び出し元がそのリソースへのアクセス許可を付与されていない場合でも呼び出し元が、P1 で保護されているリソースにアクセスできることを保証します。  
+  
+ クラス ライブラリをデザインし、クラスが保護されたリソースにアクセスする場合は、ほとんどの場合、呼び出し元のクラスが適切なアクセス許可を持つことを求めるセキュリティの要求を行う必要があります。  ほとんどの呼び出し元がアクセス許可を持たないことが分かっている操作をクラスが実行する場合、かつこれらの呼び出し元が自分のコードを呼び出すことへの責任を進んで負う場合は、コードが実行している操作を表すアクセス許可のオブジェクトにある **Assert** メソッドを呼び出してアクセス許可をアサートすることができます。  このように **Assert** を使用すると、通常はそのようにできなかった呼び出し元がコードを呼び出すことができます。  そのため、アクセス許可をアサートする場合、自分のコンポーネントが誤使用されるのを防ぐために、必ず事前に適切なセキュリティ チェックを実行する必要があります。  
+  
+ たとえば、信頼性の高いライブラリのクラスにファイルを削除するメソッドがあると仮定します。  メソッドは、アンマネージ Win32 関数を呼び出してファイルにアクセスします。  呼び出し元は、コードの **Delete** メソッドを呼び出して、削除するファイルの名前 C:\\Test.txt を渡します。  **Delete** メソッド内で、コードは C:\\Test.txt への書き込みのアクセス権を表す <xref:System.Security.Permissions.FileIOPermission> オブジェクトを作成します。  \(ファイルを削除するには書き込みのアクセス権が必要です。\) コードは、**FileIOPermission** オブジェクトの **Demand** メソッドを呼び出して強制セキュリティ チェックを呼び出します。  コール スタックのいずれかの呼び出し元にこのアクセス許可がない場合は、<xref:System.Security.SecurityException> がスローされます。  例外がスローされない場合、すべての呼び出し元に C:\\Test.txt へのアクセス権があることがわかります。  ほとんどの呼び出し元はアンマネージ コードへのアクセス許可が得られないと考えられるため、コードはアンマネージ コードを呼び出す権限を表す <xref:System.Security.Permissions.SecurityPermission> オブジェクトを作成し、オブジェクトの **Assert** メソッドを呼び出します。  最後に、コードは C:\\Text.txt を削除するアンマネージ Win32 関数を呼び出し、呼び出し元にコントロールを返します。  
+  
+> [!CAUTION]
+>  そこで、アサートするためのアクセス許可によって保護されているリソースにアクセスするために自分のコードが他のコードによって使用される状況では、自分のコードでアサーションが使用されていないことを確認する必要があります。  たとえば、あるファイルに書き込むコードにおいて、そのファイル名が呼び出し元によってパラメーターとして指定されている場合は、ファイルに書き込むために **FileIOPermission** をアサートしないでください。コードが第三者によって開かれ、悪用される可能性があるためです。  
+  
+ 強制セキュリティ構文を使用する場合、同じメソッドで複数のアクセス許可の下で **Assert** メソッドを呼び出すと、セキュリティ例外がスローされます。  代わりに、**PermissionSet** オブジェクトを作成し、これに呼び出す個別のアクセス許可を渡してから、**PermissionSet** オブジェクトの **Assert** メソッドを呼び出します。  宣言型のセキュリティ構文を使用する場合は、**Assert** メソッドを複数回呼び出すことができます。  
+  
+ 次の例は、**Assert** メソッドを使用したセキュリティ チェックをオーバーライドする宣言型の構文を示しています。  **FileIOPermissionAttribute** 構文では 2 つの値 \(<xref:System.Security.Permissions.SecurityAction> 列挙体、およびアクセス許可が付与されるファイルまたはディレクトリの場所\) を指定することに注意してください。  呼び出し元がファイルへのアクセス許可のチェックを受けていない場合でも、**Assert** への呼び出しにより、`C:\Log.txt` へのアクセスの要求は成功します。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports System  
+Imports System.IO  
+Imports System.Security.Permissions  
+  
+Namespace LogUtil  
+   Public Class Log  
+      Public Sub New()  
+  
+      End Sub  
+  
+     <FileIOPermission(SecurityAction.Assert, All := "C:\Log.txt")> Public Sub   
+      MakeLog()  
+         Dim TextStream As New StreamWriter("C:\Log.txt")  
+         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now) '  
+         TextStream.Close()  
+      End Sub  
+   End Class  
+End Namespace  
+  
+```  
+  
+```csharp  
+namespace LogUtil  
+{  
+   using System;  
+   using System.IO;  
+   using System.Security.Permissions;  
+  
+   public class Log  
+   {  
+      public Log()  
+      {      
+      }     
+      [FileIOPermission(SecurityAction.Assert, All = @"C:\Log.txt")]  
+      public void MakeLog()  
+      {     
+         StreamWriter TextStream = new StreamWriter(@"C:\Log.txt");  
+         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now);  
+         TextStream.Close();  
+      }  
+   }  
+}   
+```  
+  
+ 次のコード フラグメントは、**Assert** メソッドを使用したセキュリティ チェックをオーバーライドする宣言型の構文を示しています。  この例では、**FileIOPermission** オブジェクトのインスタンスが宣言されています。  許可されるアクセス権の種類を定義するため、コンストラクターに **FileIOPermissionAccess.AllAccess** が渡され、後にファイルの場所を記述した文字列が続きます。  いったん **FileIOPermission** オブジェクトが定義されると、セキュリティ チェックをオーバーライドする際に **Assert** メソッドを呼び出すだけで済みます。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+Imports System  
+Imports System.IO  
+Imports System.Security.Permissions  
+Namespace LogUtil  
+   Public Class Log  
+      Public Sub New()  
+      End Sub 'New  
+  
+      Public Sub MakeLog()  
+         Dim FilePermission As New FileIOPermission(FileIOPermissionAccess.AllAccess, "C:\Log.txt")  
+         FilePermission.Assert()  
+         Dim TextStream As New StreamWriter("C:\Log.txt")  
+         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now)  
+         TextStream.Close()  
+      End Sub  
+   End Class  
+End Namespace  
+  
+```  
+  
+```csharp  
+namespace LogUtil  
+{  
+   using System;  
+   using System.IO;  
+   using System.Security.Permissions;  
+  
+   public class Log  
+   {  
+      public Log()  
+      {      
+      }     
+      public void MakeLog()  
+      {  
+         FileIOPermission FilePermission = new FileIOPermission(FileIOPermissionAccess.AllAccess,@"C:\Log.txt");   
+         FilePermission.Assert();  
+         StreamWriter TextStream = new StreamWriter(@"C:\Log.txt");  
+         TextStream.WriteLine("This  Log was created on {0}", DateTime.Now);  
+         TextStream.Close();  
+      }  
+   }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Security.PermissionSet>   
+ <xref:System.Security.Permissions.SecurityPermission>   
+ <xref:System.Security.Permissions.FileIOPermission>   
+ <xref:System.Security.Permissions.SecurityAction>   
+ [属性](../../../docs/standard/attributes/index.md)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/TOC.md b/docs/framework/net-native/TOC.md
new file mode 100644
index 00000000000..d24487a7078
--- /dev/null
+++ b/docs/framework/net-native/TOC.md
@@ -0,0 +1,37 @@
+# [作業の開始](getting-started-with-net-native.md)
+# [<Subtypes> 要素](subtypes-element-net-native.md)
+# [リフレクションに依存する API](apis-that-rely-on-reflection.md)
+# [<Library> 要素](library-element-net-native.md)
+# [.NET ネイティブの一般的なトラブルシューティング](net-native-general-troubleshooting.md)
+# [MissingInteropDataException クラス](missinginteropdataexception-class-net-native.md)
+# [<Event> 要素](event-element-net-native.md)
+# [.NET Native とコンパイル](net-native-and-compilation.md)
+# [MissingRuntimeArtifactException クラス](missingruntimeartifactexception-class-net-native.md)
+# [<TypeParameter> 要素](typeparameter-element-net-native.md)
+# [<Assembly> 要素](assembly-element-net-native.md)
+# [<GenericParameter> 要素](genericparameter-element-net-native.md)
+# [ランタイム ディレクティブ ポリシーの設定](runtime-directive-policy-settings.md)
+# [.NET ネイティブによる起動時間の改善の測定](measuring-startup-improvement-with-net-native.md)
+# [例: データ バインド時の例外の処理](example-handling-exceptions-when-binding-data.md)
+# [<Application> 要素](application-element-net-native.md)
+# [<Property> 要素](property-element-net-native.md)
+# [<TypeInstantiation> 要素](typeinstantiation-element-net-native.md)
+# [<MethodInstantiation> 要素](methodinstantiation-element-net-native.md)
+# [リフレクションおよび .NET ネイティブ](reflection-and-net-native.md)
+# [<AttributeImplies> 要素](attributeimplies-element-net-native.md)
+# [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](runtime-directives-rd-xml-configuration-file-reference.md)
+# [<Field> 要素](field-element-net-native.md)
+# [シリアル化とメタデータ](serialization-and-metadata.md)
+# [.NET ネイティブ アプリでのランタイム例外](runtime-exceptions-in-net-native-apps.md)
+# [<Namespace> 要素](namespace-element-net-native.md)
+# [.NET ネイティブによるアプリのコンパイル](index.md)
+# [<Directives> 要素](directives-element-net-native.md)
+# [例: 動的プログラミングのトラブルシューティング](example-troubleshooting-dynamic-programming.md)
+# [Windows ストア アプリの .NET ネイティブへの移行](migrating-your-windows-store-app-to-net-native.md)
+# [MissingMetadataException クラス](missingmetadataexception-class-net-native.md)
+# [ランタイム ディレクティブ要素](runtime-directive-elements.md)
+# [<ImpliesType> 要素](impliestype-element-net-native.md)
+# [<Method> 要素](method-element-net-native.md)
+# [<Parameter> 要素](parameter-element-net-native.md)
+# [<Type> 要素](type-element-net-native.md)
+# [リフレクション API リファレンス](net-native-reflection-api-reference.md)
diff --git a/docs/framework/net-native/apis-that-rely-on-reflection.md b/docs/framework/net-native/apis-that-rely-on-reflection.md
new file mode 100644
index 00000000000..2550704e02d
--- /dev/null
+++ b/docs/framework/net-native/apis-that-rely-on-reflection.md
@@ -0,0 +1,110 @@
+---
+title: "リフレクションに依存する API | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f9532629-6594-4a41-909f-d083f30a42f3
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# リフレクションに依存する API
+コード内でのリフレクションの使用は明確ではない場合があるため、[!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンでは、実行時に必要なメタデータを保存しません。  このトピックでは、リフレクション API の一部であるとは見なされないが、正常に実行するためにリフレクションを必要とする、一般的な API と一般的なプログラミング パターンについて説明します。  これらをソース コードで使用している場合、これらに関する情報をランタイム ディレクティブ \(.rd.xml\) ファイルに追加して、これらの API を呼び出しても [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外やその他の例外が実行時にスローされないようにできます。  
+  
+## Type.MakeGenericType メソッド  
+ ジェネリック型 `AppClass<T>` を動的にインスタンス化するには、次のようなコードを使用して <xref:System.Type.MakeGenericType%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+ [!code-csharp[ProjectN#1](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/type_makegenerictype1.cs#1)]  
+  
+ このコードが実行時に成功するためには、いくつかのメタデータ項目が必要です。  1 つ目は、インスタンス化されていないジェネリック型 `Browse` の `AppClass<T>` メタデータです。  
+  
+```  
+<Type Name="App1.AppClass`1" Browse="Required PublicAndInternal" />  
+```  
+  
+ これにより、<xref:System.Type.GetType%28System.String%2CSystem.Boolean%29?displayProperty=fullName> メソッド呼び出しが成功し、有効な <xref:System.Type> オブジェクトが返されます。  
+  
+ インスタンス化されていないジェネリック型のメタデータを追加した場合でも、<xref:System.Type.MakeGenericType%2A?displayProperty=fullName> メソッドを呼び出すと、次のような [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外がスローされます。  
+  
+```  
+  
+This operation cannot be carried out as metadata for the following type was removed for performance reasons:  
+  
+App1.AppClass`1<System.Int32>.  
+  
+```  
+  
+ 次のランタイム ディレクティブをランタイム ディレクティブ ファイルに追加すると、`Activate` の `AppClass<T>` に対する特定のインスタンス化の <xref:System.Int32?displayProperty=fullName> メタデータを追加できます。  
+  
+```  
+  
+<TypeInstantiation Name="App1.AppClass" Arguments="System.Int32"   
+                   Activate="Required Public" />  
+  
+```  
+  
+ `AppClass<T>` に対するそれぞれ異なるインスタンス化は、<xref:System.Type.MakeGenericType%2A?displayProperty=fullName> メソッドにより作成され、静的に使用されていない場合、個別のディレクティブを必要とします。  
+  
+## MethodInfo.MakeGenericMethod メソッド  
+ ジェネリック メソッド `Class1` を持つクラス `GetMethod<T>(T t)` があるとすると、`GetMethod` は、次のようなコードを使用してリフレクションにより呼び出すことができます。  
+  
+ [!code-csharp[ProjectN#2](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/makegenericmethod1.cs#2)]  
+  
+ このコードを正常に実行するには、次のようないくつかのメタデータ項目が必要です。  
+  
+-   呼び出すメソッドを持つ型の `Browse` メタデータ。  
+  
+-   呼び出すメソッドの `Browse` メタデータ。  パブリック メソッドの場合、それを含む型のパブリック `Browse` メタデータを追加しても、メソッドが含められます。  
+  
+-   呼び出すメソッドの動的メタデータ。これにより、リフレクション呼び出しデリゲートが [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンにより削除されなくなります。  メソッドの動的メタデータが欠落している場合、<xref:System.Reflection.MethodInfo.MakeGenericMethod%2A?displayProperty=fullName> メソッドを呼び出すと、次の例外がスローされます。  
+  
+    ```  
+  
+    MakeGenericMethod() cannot create this generic method instantiation because the instantiation was not metadata-enabled: 'App1.Class1.GenMethod<Int32>(Int32)'.  
+  
+    ```  
+  
+ 次のランタイム ディレクティブは、必要なすべてのメタデータが必ず使用可能であるようにします。  
+  
+```  
+  
+<Type Name="App1.Class1" Browse="Required PublicAndInternal">  
+   <MethodInstantiation Name="GenMethod" Arguments="System.Int32" Dynamic="Required"/>  
+</Type>  
+  
+```  
+  
+ `MethodInstantiation` ディレクティブは、動的に呼び出されるメソッドの異なるインスタンス化ごとに必要です。`Arguments` 要素は、それぞれ異なるインスタンス化引数を反映するために更新されます。  
+  
+## Array.CreateInstance メソッドと Type.MakeTypeArray メソッド  
+ 次の例は、<xref:System.Type.MakeArrayType%2A?displayProperty=fullName> 型で <xref:System.Array.CreateInstance%2A?displayProperty=fullName> メソッドと `Class1` メソッドを呼び出します。  
+  
+ [!code-csharp[ProjectN#3](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/array1.cs#3)]  
+  
+ 配列メタデータが存在しない場合、次のエラーが発生します。  
+  
+```  
+This operation cannot be carried out as metadata for the following type was removed for performance reasons:  
+  
+App1.Class1[]  
+  
+Unfortunately, no further information is available.  
+```  
+  
+ 配列型の `Browse` メタデータは、配列を動的にインスタンス化するために必要です。  次のランタイム ディレクティブにより、`Class1[]` を動的にインスタンス化できます。  
+  
+```  
+<Type Name="App1.Class1[]" Browse="Required Public" />  
+```  
+  
+## 参照  
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)   
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/application-element-net-native.md b/docs/framework/net-native/application-element-net-native.md
new file mode 100644
index 00000000000..2be36427559
--- /dev/null
+++ b/docs/framework/net-native/application-element-net-native.md
@@ -0,0 +1,99 @@
+---
+title: "&lt;Application&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b4e9b37a-059b-4076-8f56-cb3f9cef0cd9
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# &lt;Application&gt; 要素 (.NET ネイティブ)
+実行時にリフレクションに使用可能なメタデータを持つアプリケーション全体の型と型のメンバーのコンテナーとして機能し、アプリ内のすべてのプログラム要素にランタイム リフレクション ポリシーを適用します。  
+  
+ <>\>要素  
+<>\>要素 (rd.xml)  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Application Activate="policy_setting"  
+             Browse="policy_setting"  
+             Dynamic="policy_setting"  
+             Serialize="policy_setting"  
+             DataContractSerializer="policy_setting"  
+             DataContractJsonSerializer="policy_setting"  
+             XmlSerializer="policy_setting"  
+             MarshalObject="policy_setting"  
+             MarshalDelegate="policy_setting"  
+             MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。 「子要素」の表では、ポリシーは実行時に特定のプログラム要素で使用可能になるメタデータの種類を示します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 型に関する情報の照会や型の列挙を制御しますが、実行時の動的アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 ネイティブ コードに構造体をマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="all-attributes"></a>すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|アプリで型に適用する、このポリシーの設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/assembly-element-net-native.md)|特定のアセンブリ内のすべての型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/namespace-element-net-native.md)|特定の名前空間内のすべての型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|クラスや構造体などの特定の型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型にポリシーを適用します。 たとえば、 [ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)ポリシーを定義する要素を使用、`List<String>`型です。|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|特定の型のメソッドにポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)|構築されたジェネリック メソッドにポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/property-element-net-native.md)|特定の型のプロパティにポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/field-element-net-native.md)|特定の型のフィールドにポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/event-element-net-native.md)|特定の型のイベントにポリシーを適用します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/directives-element-net-native.md)|ランタイム ディレクティブ ファイルのルート要素です。|  
+  
+## <a name="remarks"></a>コメント  
+ [ <> \> ](../../../docs/framework/net-native/directives-element-net-native.md)&0; または&1; 個の要素を含めることができます`<Application>`要素。 1 つのリフレクション ディレクティブ ファイルに複数の `<Application>` 要素を含めることはサポートされていません。  
+  
+ `<Application>` 要素は、次の&2; とおりの方法で使用できます。  
+  
+-   実行時に必要なメタデータを持つプログラム要素を定義するためのコンテナーとして。 この場合、`<Application>` 要素に属性は必要ありません。 コンパイル時に、コンパイラ ツールは、.NET Framework コア ライブラリを含むすべてのライブラリで、`<Application>` 要素の子要素により示されるプログラム要素を検索します。 これに対し、コンパイラ ツールはにより指定されたライブラリのみを検索、 [ <> \> ](../../../docs/framework/net-native/library-element-net-native.md)要素の子要素により示されるプログラム要素[ <> \</> \>](../../../docs/framework/net-native/library-element-net-native.md)します。  
+  
+-   リフレクション、シリアル化、および相互運用に関するアプリケーション全体のポリシーを設定する要素として。 属性、`<Application>`要素により定義される子要素によってオーバーライドできますアプリケーション全体のポリシーを定義する、`<Application>`または[ <> \> ](../../../docs/framework/net-native/library-element-net-native.md)要素。  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/library-element-net-native.md)   
+ [<>\>要素](../../../docs/framework/net-native/directives-element-net-native.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/assembly-element-net-native.md b/docs/framework/net-native/assembly-element-net-native.md
new file mode 100644
index 00000000000..34ecaa24126
--- /dev/null
+++ b/docs/framework/net-native/assembly-element-net-native.md
@@ -0,0 +1,106 @@
+---
+title: "&lt;Assembly&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cfe629eb-1106-4113-86e1-052f402d8d8b
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# &lt;Assembly&gt; 要素 (.NET ネイティブ)
+指定したアセンブリ内のすべての型にランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Assembly Name="assembly_name"   
+          Activate="policy_setting"  
+          Browse="policy_setting"  
+          Dynamic="policy_setting"  
+          Serialize="policy_setting" />  
+          DataContractSerializer="policy_setting"  
+          DataContractJsonSerializer="policy_setting"  
+          XmlSerializer="policy_setting"  
+          MarshalObject="policy_setting"  
+          MarshalDelegate="policy_setting"  
+          MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 アセンブリの簡易名を指定します。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 アセンブリ内の型に関する情報の照会または型の列挙を制御しますが、実行時の動的アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 ネイティブ コードに構造体をマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*assembly_name*|ファイル拡張子のないアセンブリの簡易名です。 この属性に対応して、 <xref:System.Reflection.AssemblyName.Name%2A?displayProperty=fullName>プロパティです。 たとえば、Extensions.dll というアセンブリの名前は "Extensions" です。<br /><br /> リテラル文字列 `*Application*` を指定して、アプリ パッケージ内のすべてのアセンブリに、読み込みの有無に関係なくポリシーを適用することもできます。 `*Application*` は、.NET Framework アセンブリにポリシーを適用しません。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|アセンブリ内のすべての型について、このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/namespace-element-net-native.md)|子名前空間内のすべての型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型にリフレクション ポリシーを適用します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/application-element-net-native.md)|実行時にリフレクションで使用可能なメタデータを持つ、アプリケーション全体の型と型のメンバーのコンテナーとして機能します。 [ <> \> ](../../../docs/framework/net-native/application-element-net-native.md)要素が&0; または&1; を持つ`<Assembly>`要素。|  
+|[<>\>](../../../docs/framework/net-native/library-element-net-native.md)|実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。 [ <> \> ](../../../docs/framework/net-native/library-element-net-native.md)要素が&0; または&1; を持つ`<Assembly>`要素。|  
+  
+## <a name="remarks"></a>コメント  
+ `<Assembly>` 要素は、アセンブリ内のすべての型の実行時ポリシーを定義します。 異なり、 [ <> \> ](../../../docs/framework/net-native/library-element-net-native.md)要素と、ライブラリの指定は、ランタイム リフレクション ポリシーを定義するためには、その子要素に依存します。 `<Assembly>` 要素は、子要素でオーバーライドされない限り、アセンブリ内のすべての型に適用されます。  
+  
+ 次の例適用方法を説明する実行時ポリシー アセンブリ内のすべての型に、アプリ パッケージ内を割り当てることによって、`Name`属性の値"* アプリケーション\*"です。 `<Assembly>`要素の子である必要があります、 [ <> \> ](../../../docs/framework/net-native/application-element-net-native.md)要素。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">   
+  <Application>   
+     <Assembly Name="*Application*" Dynamic="Required All" />   
+  </Application>   
+</Directives>  
+  
+```  
+  
+ `Activate` 属性、`Browse` 属性、`Dynamic`、および `Serialize` 属性はすべて省略可能です。 ただし、`<Assembly>` 要素にはこれらの属性のいずれか&1; つ以上を含める必要があります。  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/attributeimplies-element-net-native.md b/docs/framework/net-native/attributeimplies-element-net-native.md
new file mode 100644
index 00000000000..0a55e2dcdbc
--- /dev/null
+++ b/docs/framework/net-native/attributeimplies-element-net-native.md
@@ -0,0 +1,81 @@
+---
+title: "&lt;AttributeImplies&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82db7193-a860-418b-84fc-fff2fdf2e025
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;AttributeImplies&gt; 要素 (.NET ネイティブ)
+それを含む属性が適用されるコード要素のポリシーを定義します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<AttributeImplies Activate="policy_type"  
+                  Browse="policy_type"  
+                  Dynamic="policy_type"  
+                  Serialize="policy_type"   
+                  DataContractSerializer="policy_setting"  
+                  DataContractJsonSerializer="policy_setting"  
+                  XmlSerializer="policy_setting"  
+                  MarshalObject="policy_setting"  
+                  MarshalDelegate="policy_setting"  
+                  MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="all-attributes"></a>すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<AttributeImplies>`要素がそれを含む型が属性である場合に使用されます (から派生したクラスは、 <xref:System.Attribute?displayProperty=fullName>)。 特定のプログラム要素に属性が適用される場合、`<AttributeImplies>` 要素によって定義されるポリシーがそのプログラム要素に適用されます。  
+  
+ リフレクション、シリアル化、および相互運用属性はいずれも省略可能ですが、そのうち少なくとも&1; つが存在する必要があります。  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/type-element-net-native.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/directives-element-net-native.md b/docs/framework/net-native/directives-element-net-native.md
new file mode 100644
index 00000000000..702fbe2aefd
--- /dev/null
+++ b/docs/framework/net-native/directives-element-net-native.md
@@ -0,0 +1,53 @@
+---
+title: "&lt;Directives&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 444846f3-48d5-4341-a43e-69f7221389eb
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# &lt;Directives&gt; 要素 (.NET ネイティブ)
+[!INCLUDE[net_native](../../../includes/net-native-md.md)]のすべてのランタイム ディレクティブ ファイルのルート要素です。  
+  
+ **\<Directives xmlns\="http:\/\/schemas.microsoft.com\/netfx\/2013\/01\/metadata"\>**  
+  
+## 構文  
+  
+```xml  
+  
+        <Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <!-- child elements -->   
+</Directives>  
+```  
+  
+## 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`xmlns`|XML 名前空間。  値は常に **"http:\/\/schemas.microsoft.com\/netfx\/2013\/01\/metadata"** です。|  
+  
+## 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md)|リフレクションで使用可能なメタデータを持つアプリケーション全体の型と型のメンバーのコンテナーとして機能します。|  
+|[\<Library\>](../../../docs/framework/net-native/library-element-net-native.md)|実行時にメタデータを必要とする子型と型のメンバーを持つアセンブリを定義します。|  
+  
+## 解説  
+ 各ランタイム ディレクティブ ファイルには、`<Directives>` 要素を 1 つのみ含めることができます。  
+  
+ `<Directives>` 要素には、0 または 1 個の [\<Application\>](../../../docs/framework/net-native/application-element-net-native.md) 要素と、0 個以上の [\<Library\>](../../../docs/framework/net-native/library-element-net-native.md) 要素を含めることができます。  
+  
+## 参照  
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/event-element-net-native.md b/docs/framework/net-native/event-element-net-native.md
new file mode 100644
index 00000000000..3fefdb54c4c
--- /dev/null
+++ b/docs/framework/net-native/event-element-net-native.md
@@ -0,0 +1,71 @@
+---
+title: "&lt;Event&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e53b029c-9d6d-4c0a-9cdc-5cfca8a5ca47
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# &lt;Event&gt; 要素 (.NET ネイティブ)
+イベントにランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Event Name="event_name"   
+       Browse="policy_type"   
+       Dynamic="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 イベントの名前を指定します。|  
+|`Browse`|反射|省略可能な属性です。 イベントに関する情報の照会やイベントの列挙を制御しますが、実行時の動的アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 イベントへの実行時アクセスを制御して、動的プログラミングを有効にします。 このポリシーにより、実行時にイベントを動的に処理できるようになります。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*メソッド名が*|イベントの名前です。 イベントの種類が、親によって定義された[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|イベントのこのポリシーの種類に適用する設定です。 指定できる値は、`Auto`、`Excluded`、`Included`、および `Required` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ イベントのポリシーが明示的に定義されていない場合は、その親要素の実行時ポリシーを継承します。  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/example-handling-exceptions-when-binding-data.md b/docs/framework/net-native/example-handling-exceptions-when-binding-data.md
new file mode 100644
index 00000000000..9c55e319e83
--- /dev/null
+++ b/docs/framework/net-native/example-handling-exceptions-when-binding-data.md
@@ -0,0 +1,73 @@
+---
+title: "例: データ バインド時の例外の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd63ed96-9853-46dc-ade5-7bd1b0f39110
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 例: データ バインド時の例外の処理
+> [!NOTE]
+>  このトピックでは、プレリリース ソフトウェアである .NET Native Developer Preview について述べています。  プレビュー版は、[Microsoft Connect Web サイト](http://go.microsoft.com/fwlink/?LinkId=394611)からダウンロードできます \(登録が必要です\)。  
+  
+ 次の例は、[!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンでコンパイルされたアプリがデータをバインドしようとしたときにスローされる [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外の解決方法を示しています。  例外情報は次のとおりです。  
+  
+```  
+  
+This operation cannot be carried out as metadata for the following type was removed for performance reasons:   
+App.ViewModels.MainPageVM  
+  
+```  
+  
+ 関連付けられている呼び出し履歴は次のとおりです。  
+  
+```  
+  
+Reflection::Execution::ReflectionDomainSetupImplementation.CreateNonInvokabilityException+0x238  
+Reflection::Core::ReflectionDomain.CreateNonInvokabilityException+0x2e  
+Reflection::Core::Execution::ExecutionEnvironment.+0x316  
+System::Reflection::Runtime::PropertyInfos::RuntimePropertyInfo.GetValue+0x1cb  
+System::Reflection::PropertyInfo.GetValue+0x22  
+System::Runtime::InteropServices::WindowsRuntime::CustomPropertyImpl.GetValue+0x42  
+App!$66_Interop::McgNative.Func_IInspectable_IInspectable+0x158  
+App!$66_Interop::McgNative::__vtable_Windows_UI_Xaml_Data__ICustomProperty.GetValue__STUB+0x46  
+Windows_UI_Xaml!DirectUI::PropertyProviderPropertyAccess::GetValue+0x3f   
+Windows_UI_Xaml!DirectUI::PropertyAccessPathStep::GetValue+0x31   
+Windows_UI_Xaml!DirectUI::PropertyPathListener::ConnectPathStep+0x113  
+  
+```  
+  
+## アプリが行っていた動作は何か  
+ スタックの最下位にある [Windows.UI.Xaml](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.aspx) 名前空間のフレームは、XAML レンダリング エンジンが実行されていたことを示します。  <xref:System.Reflection.PropertyInfo.GetValue%2A?displayProperty=fullName> メソッドの使用は、そのメタデータが削除された型での、プロパティ値のリフレクション ベースのルックアップを示します。  
+  
+ メタデータ ディレクティブを提供するための最初の手順は、型の `serialize` メタデータを追加して、そのプロパティすべてをアクセス可能にすることです。  
+  
+```  
+<Type Name="App.ViewModels.MainPageVM" Serialize="Required Public" />  
+```  
+  
+## 特殊なケースかどうか  
+ このシナリオでは、ある `ViewModel` について、データ バインディングに不完全なメタデータが含まれる場合、他のものにも同じことが該当する可能性があります。  アプリのビュー モデルがすべて `App.ViewModels` 名前空間内にあるようにコードが作成されている場合、より一般的なランタイム ディレクティブを使用できます。  
+  
+```  
+<Namespace Name="App.ViewModels " Serialize="Required Public" />  
+```  
+  
+## リフレクションを使用しないようにコードを書き換えることができるか  
+ データ バインディングではリフレクションが多用されるため、リフレクションを使用しないようにコードを変更することはできません。  
+  
+ ただし、`ViewModel` を XAML ページに指定して、ツール チェーンがコンパイル時にプロパティ バインディングを正しい型に関連付けて、ランタイム ディレクティブを使用せずにメタデータを保持できるようにする方法はあります。  たとえば、プロパティに [Windows.UI.Xaml.Data.BindableAttribute](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.data.bindableattribute.aspx) 属性を適用します。  これにより、XAML コンパイラが必要なルックアップ情報を生成するようになり、Default.rd.xml ファイルのランタイム ディレクティブが不要になります。  
+  
+## 参照  
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)   
+ [例: 動的プログラミングのトラブルシューティング](../../../docs/framework/net-native/example-troubleshooting-dynamic-programming.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/example-troubleshooting-dynamic-programming.md b/docs/framework/net-native/example-troubleshooting-dynamic-programming.md
new file mode 100644
index 00000000000..7e98d186409
--- /dev/null
+++ b/docs/framework/net-native/example-troubleshooting-dynamic-programming.md
@@ -0,0 +1,74 @@
+---
+title: "例: 動的プログラミングのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42ed860a-a022-4682-8b7f-7c9870784671
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 例: 動的プログラミングのトラブルシューティング
+> [!NOTE]
+>  このトピックでは、プレリリース ソフトウェアである .NET Native Developer Preview について述べています。  プレビュー版は、[Microsoft Connect Web サイト](http://go.microsoft.com/fwlink/?LinkId=394611)からダウンロードできます \(登録が必要です\)。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンを使用して開発されたアプリでのメタデータ ルックアップの失敗すべてが、例外になるわけではありません。  予測できない方法でアプリに出現するものもあります。  次の例は、null オブジェクトの参照により生じるアクセス違反を示しています。  
+  
+```  
+  
+Access violation - code c0000005 (first chance)  
+App!$3_App::Core::Util::NavigationArgs.Setup  
+App!$3_App::Core::Util::NavigationArgs..ctor  
+App!$0_App::Gibbon::Util::DesktopNavigationArgs..ctor  
+App!$0_App::ViewModels::DesktopAppVM.NavigateToPage  
+App!$3_App::Core::ViewModels::AppViewModel.NavigateToFirstPage  
+App!$3_App::Core::ViewModels::AppViewModel::<HandleLaunch>d__a.MoveNext  
+App!$43_System::Runtime::CompilerServices::AsyncMethodBuilderCore.CallMoveNext  
+App!System::Action.InvokeClosedStaticThunk  
+App!System::Action.Invoke  
+App!$43_System::Threading::Tasks::AwaitTaskContinuation.InvokeAction  
+App!$43_System::Threading::SendOrPostCallback.InvokeOpenStaticThunk  
+[snip]  
+  
+```  
+  
+ 「[作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)」の欠落しているメタデータの手動による解決に関するセクションで説明されている 3 つの手順からなるアプローチを使用して、この例外をトラブルシューティングしてみましょう。  
+  
+## アプリが行っていた動作は何か  
+ 最初に注目するのは、スタックの最下位にある `async` キーワード メカニズムです。  スタックでは元の呼び出しのコンテキストが失われており、別のスレッドで `async` コードを実行しているため、アプリが `async` メソッドで実際に何を行っていたかを決定するのは困難です。  ただし、アプリが最初のページをロードしようとしていたことは推測できます。  `NavigationArgs.Setup` の実装で、次のコードによってアクセス違反が発生しました。  
+  
+```  
+AppViewModel.Current.LayoutVM.PageMap  
+```  
+  
+ この例では、`AppViewModel.Current` の `LayoutVM` プロパティは **null** でした。  メタデータの一部が欠落しているため、わずかな動作の違いが生じ、その結果プロパティはアプリで予期されているように設定されるのではなく、初期化されないままになります。  コードの `LayoutVM` が初期化される必要がある位置にブレークポイントを設定すると、状況の把握に役立ちます。  ただし、`LayoutVM` の型は `App.Core.ViewModels.Layout.LayoutApplicationVM` であることに注意してください。  この時点で rd.xml ファイル内に存在するメタデータ ディレクティブは、次のもののみです。  
+  
+```  
+  
+<Namespace Name="App.ViewModels" Browse="Required Public" Dynamic="Required Public" />  
+  
+```  
+  
+ 失敗の原因として考えられるのは、`App.Core.ViewModels.Layout.LayoutApplicationVM` が別の名前空間にあるために、メタデータが欠落していることです。  
+  
+ この場合、`App.Core.ViewModels` のランタイム ディレクティブを追加すると、問題が解決します。  根本的な原因は、**null** を返した <xref:System.Type.GetType%28System.String%29?displayProperty=fullName> メソッドへの API 呼び出しで、アプリではクラッシュが発生するまでエラーを出さずにこの問題を無視していました。  
+  
+ 動的プログラミングでは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]でリフレクション API を使用する場合、失敗したときに例外をスローする <xref:System.Type.GetType%2A?displayProperty=fullName> オーバーロードを使用することをお勧めします。  
+  
+## 特殊なケースかどうか  
+ `App.Core.ViewModels` を使用する際に、その他の問題が発生することもあります。  メタデータの欠落例外すべてを特定して修正する意味があるかどうか、または大きい型のクラスにディレクティブを追加して時間を節約するかを決定する必要があります。  この場合は、出力バイナリのサイズ増大が問題になるのでなければ、`App.Core.ViewModels` の `dynamic` メタデータを追加するのが最適な方法でしょう。  
+  
+## コードを書き換えることができるか  
+ アプリで `Type.GetType(“LayoutApplicationVM”)` ではなく `typeof(LayoutApplicationVM)` を使用している場合、ツール チェーンに `browse` メタデータが保存されている可能性があります。  ただし、それでも `invoke` メタデータは作成されておらず、そのため型をインスタンス化するときに [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外が発生する可能性があります。  この例外を回避するには、名前空間または `dynamic` ポリシーを指定する型のランタイム ディレクティブを追加する必要があります。  ランタイム ディレクティブの詳細については、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。  
+  
+## 参照  
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)   
+ [例: データ バインド時の例外の処理](../../../docs/framework/net-native/example-handling-exceptions-when-binding-data.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/field-element-net-native.md b/docs/framework/net-native/field-element-net-native.md
new file mode 100644
index 00000000000..77a8976d0e0
--- /dev/null
+++ b/docs/framework/net-native/field-element-net-native.md
@@ -0,0 +1,73 @@
+---
+title: "&lt;Field&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a14125f-1a8d-41a1-8a32-659ca0ad12de
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# &lt;Field&gt; 要素 (.NET ネイティブ)
+フィールドにランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Field Name="field_name"  
+       Browse="policy_type"  
+       Dynamic="policy_type"  
+       Serialize="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 フィールド名を指定します。|  
+|`Browse`|反射|省略可能な属性です。 フィールドに関する情報の照会やフィールドの列挙を制御しますが、実行時の動的アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 フィールドへの実行時アクセスを制御して、動的プログラミングを有効にします。 このポリシーにより、実行時にフィールドを動的に設定または取得できるようになります。|  
+|`Serialize`|シリアル化|省略可能な属性です。 フィールドへの実行時アクセスを制御して、型インスタンスを Newtonsoft の JSON シリアライザーなどのライブラリによってシリアル化できるようにしたり、データ バインディングで使用できるようにしたりします。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*メソッド名が*|フィールド名。 親フィールドの型が定義されている[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|フィールドのこのポリシーの種類に適用する設定です。 指定できる値は、`Auto`、`Excluded`、`Included`、および `Required` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ フィールドのポリシーが明示的に定義されていない場合は、その親要素の実行時ポリシーを継承します。  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/genericparameter-element-net-native.md b/docs/framework/net-native/genericparameter-element-net-native.md
new file mode 100644
index 00000000000..11412e24334
--- /dev/null
+++ b/docs/framework/net-native/genericparameter-element-net-native.md
@@ -0,0 +1,103 @@
+---
+title: "&lt;GenericParameter&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cbd49732-3615-49a5-a900-f96947cdc3e6
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# &lt;GenericParameter&gt; 要素 (.NET ネイティブ)
+ジェネリック型またはメソッドのパラメーターの型にポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<GenericParameter Name="generic_parameter_name"  
+                  Activate="policy_type"  
+                  Browse="policy_type"  
+                  Dynamic="policy_type"  
+                  Serialize="policy_type" />  
+                  DataContractSerializer="policy_type"  
+                  DataContractJsonSerializer="policy_type"  
+                  XmlSerializer="policy_type"  
+                  MarshalObject="policy_type"  
+                  MarshalDelegate="policy_type"  
+                  MarshalStructure="policy_type"  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 ジェネリック パラメーターの名前。 たとえば、ジェネリック デリゲート<xref:System.Func%603>の値、`Name`属性は"TResult"デリゲートの戻り値に実行時ポリシーを適用する\</T1, T2, TResult>。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*generic_parameter_name*|必須の属性です。 ジェネリック型パラメーターの名前。 たとえば、ジェネリック デリゲート<xref:System.Func%603>、 *generic_parameter_name* "TResult"の値には、デリゲートの戻り値に実行時ポリシーが適用されます\</T1, T2, TResult>。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|コンストラクターまたはメソッドにランタイム リフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|クラスや構造体など、特定の型にランタイム リフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<GenericParameter>`要素のいずれかの子では、 [ <> \> ](../../../docs/framework/net-native/method-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)要素、ジェネリック型またはメソッド シグネチャでその名前で指定されている特定のジェネリック型パラメーターにポリシーを適用するために使用します。  
+  
+ `<GenericParameter>` 要素は、シリアライザーで使用する場合に最も役立ちます。 次の例では、`<GenericParameter>`型にポリシーを適用する要素`T`、NewtonSoft の JSON シリアライザーの呼び出しで[JsonConvert.DeserializeObject<>\>(String)](http://james.newtonking.com/json/help/index.html?topic=html/T_Newtonsoft_Json_JsonConvert.htm)メソッドのオーバー ロードします。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Type Name="Newtonsoft.Json.JsonConvert" >  
+      <Method Name="DeserializeObject{T}">  
+         <GenericParameter Name="T" Serialize="Required All" />  
+      </Method>  
+   </Type>  
+</Directives>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/method-element-net-native.md)   
+ [<>\>要素](../../../docs/framework/net-native/type-element-net-native.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/getting-started-with-net-native.md b/docs/framework/net-native/getting-started-with-net-native.md
new file mode 100644
index 00000000000..658788266b6
--- /dev/null
+++ b/docs/framework/net-native/getting-started-with-net-native.md
@@ -0,0 +1,127 @@
+---
+title: ".NET ネイティブの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc9e04e8-2d05-4870-8cd6-5bd276814afc
+caps.latest.revision: 29
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# .NET ネイティブの概要
+Windows 10 用に新しい Windows アプリを作成する場合も、既存の Windows ストア アプリを移行する場合も、次に示す同じ手順を実行することになります。[!INCLUDE[net_native](../../../includes/net-native-md.md)] アプリを作成するには、次の手順を実行します。  
+  
+1.  [Windows 10 を対象とするユニバーサル Windows プラットフォーム \(UWP\) ストア アプリを開発](#Step1)し、アプリのデバッグ ビルドをテストして、そのアプリが適切に動作することを確認します。  
+  
+2.  [追加のリフレクションおよびシリアル化の使用を処理](#Step4)します。  
+  
+3.  [リリース ビルドのアプリを展開して、テストします](#Step5)。  
+  
+4.  [メタデータの欠落を手動で解決し](#Step6)、すべての問題が解決されるまで[手順 3](#Step5) を繰り返します。  
+  
+> [!NOTE]
+>  既存の Windows ストア アプリを [!INCLUDE[net_native](../../../includes/net-native-md.md)] に移行する場合は、「[Windows ストア アプリの .NET ネイティブへの移行](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)」を必ずご覧ください。  
+  
+<a name="Step1"></a>   
+## 手順 1: UWP アプリのデバッグ ビルドを開発してテストする  
+ 新しいアプリを開発するか既存のアプリを移行するかに関係なく、Windows アプリについては同じ手順を実行します。  
+  
+1.  Visual C\# または Visual Basic のユニバーサル Windows アプリ テンプレートを使用して、Visual Studio で新しい UWP プロジェクトを作成します。 既定では、すべての UWP アプリケーションは CoreCLR を対象としていて、.NET ネイティブ ツール チェーンを使用してリリース ビルドがコンパイルされます。  
+  
+2.  UWP アプリ プロジェクトのコンパイルに .NET ネイティブ ツール チェーンを使用する場合と使用しない場合では、両者の間に既知の互換性問題がある点にご注意ください。 詳細については、[移行ガイド](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)を参照してください。  
+  
+ これで、[!INCLUDE[net_native](../../../includes/net-native-md.md)] サーフェス領域に対してローカル システム \(またはシミュレーター\) で実行される C\# または Visual Basic コードを作成できるようになりました。  
+  
+> [!IMPORTANT]
+>  アプリを開発するときに、コードでのシリアル化またはリフレクションを使用する場合は注意してください。  
+  
+ 既定では、デバッグ ビルドは F5 キーを押した時に迅速な配置を有効にするために JIT でコンパイルされますが、リリース ビルドは [!INCLUDE[net_native](../../../includes/net-native-md.md)] プリコンパイル テクノロジを使用してコンパイルされます。 つまり、アプリのデバッグ ビルドが正常に動作するようにするには、.NET ネイティブ ツール チェーンでコンパイルする前に、これをビルドしてテストする必要があるということです。  
+  
+<a name="Step4"></a>   
+## 手順 2: 追加のリフレクションおよびシリアル化の使用を処理する  
+ プロジェクト作成時に Default.rd.xml という名前のランタイム ディレクティブ ファイルがプロジェクトに自動的に追加されます。 C\# で開発する場合、このファイルはプロジェクトの **Properties** フォルダーにあります。 Visual Basic で開発する場合、このファイルはプロジェクトの **My Project** フォルダーにあります。  
+  
+> [!NOTE]
+>  ランタイム ディレクティブ ファイルが必要となる理由の背景を含む .NET ネイティブのコンパイルの概要については、「[.NET ネイティブとコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)」をご覧ください。  
+  
+ ランタイム ディレクティブ ファイルは、アプリの実行時に必要なメタデータを定義するために使用されます。 この既定バージョンのファイルで十分な場合もあります。 ただし、シリアル化やリフレクションに依存するコードには、ランタイム ディレクティブ ファイルに追加のエントリが必要になるものがあります。  
+  
+ **シリアル化**  
+ シリアライザーには 2 つのカテゴリがあり、これらはいずれもランタイム ディレクティブ ファイルに追加エントリを必要とする場合があります。  
+  
+-   非リフレクション ベースのシリアライザー。<xref:System.Runtime.Serialization.DataContractSerializer>、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>、および <xref:System.Xml.Serialization.XmlSerializer> クラスなど、.NET Framework クラス ライブラリ内にあるシリアライザーは、リフレクションに依存しません。 ただし、これらのシリアライザーでは、シリアル化または逆シリアル化されるオブジェクトに基づいてコードが生成される必要があります。  詳しくは、「[シリアル化とメタデータ](../../../docs/framework/net-native/serialization-and-metadata.md)」の「Microsoft のシリアライザー」セクションをご覧ください。  
+  
+-   サードパーティ シリアライザー。 サードパーティのシリアライズ化ライブラリ \(Newtonsoft の JSON シリアライザーが最も一般的\) は、通常はリフレクション ベースであり、オブジェクトのシリアル化と逆シリアル化をサポートするために \*.rd.xml ファイル内のエントリを必要とします。 詳しくは、「[シリアル化とメタデータ](../../../docs/framework/net-native/serialization-and-metadata.md)」の「サードパーティ シリアライザー」セクションをご覧ください。  
+  
+ **リフレクションに依存するメソッド**  
+ コードでのリフレクションの使用は明確ではない場合があります。 一般的な API やプログラミング パターンの中には、リフレクション API の一部とは見なされないが、正常な実行にリフレクションを必要とするものがあります。 これには、次のような型インスタンス化およびメソッド作成方法があります。  
+  
+-   <xref:System.Type.MakeGenericType%2A?displayProperty=fullName> メソッド  
+  
+-   <xref:System.Array.CreateInstance%2A?displayProperty=fullName> メソッドと <xref:System.Type.MakeArrayType%2A?displayProperty=fullName> メソッド  
+  
+-   <xref:System.Reflection.MethodInfo.MakeGenericMethod%2A?displayProperty=fullName> メソッド。  
+  
+ 詳細については、「[リフレクションに依存する API](../../../docs/framework/net-native/apis-that-rely-on-reflection.md)」を参照してください。  
+  
+> [!NOTE]
+>  ランタイム ディレクティブ ファイルで使用される型名は完全修飾である必要があります。 たとえば、ファイルでは "String" ではなく "System.String" を指定する必要があります。  
+  
+<a name="Step5"></a>   
+## 手順 3: リリース ビルドのアプリを展開してテストする  
+ ランタイム ディレクティブ ファイルを更新したら、アプリのリリース ビルドを再ビルドして配置できます。 .NET ネイティブ バイナリは、プロジェクトの **\[プロパティ\]** ダイアログ ボックスの **\[コンパイル\]** タブにある **\[ビルド出力パス\]** テキスト ボックスに指定されているディレクトリの ILC.out サブディレクトリに配置されています。 このフォルダーにないバイナリは、.NET ネイティブでコンパイルされていません。 ターゲット プラットフォームごとに、アプリを十分にテストし、失敗シナリオを含むすべてのシナリオをテストします。  
+  
+ アプリが正常に動作しない場合 \(特に実行時に [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外または [MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md) 例外をスローする場合\)、次のセクション「[手順 5: メタデータの欠落を手動で解決する](#Step6)」の手順を実行してください。 初回例外を有効にすると、このようなバグの検出に役立ちます。  
+  
+ アプリのデバッグ ビルドをテストしてデバッグし、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外と [MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md) 例外を確実に排除したら、アプリを最適化された [!INCLUDE[net_native](../../../includes/net-native-md.md)] アプリとしてテストする必要があります。 これを行うには、アクティブ プロジェクトの構成を **\[デバッグ\]** から **\[リリース\]** に変更します。  
+  
+<a name="Step6"></a>   
+## 手順 4: メタデータの欠落を手動で解決する  
+ デスクトップでは発生せず、[!INCLUDE[net_native](../../../includes/net-native-md.md)]で発生する最も一般的な失敗は、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)、[MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)、または [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) のランタイム例外です。 メタデータの欠落は、予期しない動作やアプリの失敗によって判明することもあります。 このセクションでは、ランタイム ディレクティブ ファイルにディレクティブを追加することによって、これらの例外をデバッグして解決する方法を説明します。 ランタイム ディレクティブの形式について詳しくは、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」をご覧ください。 ランタイム ディレクティブを追加したら、もう一度[アプリを配置およびテスト](#Step5)して、例外が発生しなくなるまで新しい [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)、[MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)、および [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) 例外を解決する必要があります。  
+  
+> [!TIP]
+>  高いレベルでランタイム ディレクティブを指定して、アプリがコードの変更に対応できるようにします。  メンバー レベルではなく、名前空間レベルおよび型レベルでランタイム ディレクティブを追加することをお勧めします。 回復性と、バイナリを大きくすることに伴うコンパイル時間の延長の間にはトレードオフがある場合があることに注意してください。  
+  
+ メタデータの欠落例外に対応する場合は、次のことを確認してください。  
+  
+-   例外が発生する前にアプリが何を実行しようとしていたか。  
+  
+    -   たとえば、データ バインド、シリアル化または逆シリアル化を行っていたか、またはリフレクション API を直接使用していましたか。  
+  
+-   これは特殊なケースか、または他の型でも同じ問題が発生すると考えられるか。  
+  
+    -   たとえば、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外は、アプリのオブジェクト モデル内の型をシリアル化するときにスローされます。  シリアル化されるその他の型がわかっている場合は、それらの型 \(または、コードがどの程度構造的に作成されているかによって、それを含む名前空間\) に同時にランタイム ディレクティブを追加できます。  
+  
+-   リフレクションを使用しないようにコードを書き換えることができるか。  
+  
+    -   たとえば、予期される型がわかっている場合に、コードで `dynamic` キーワードが使用されていますか。  
+  
+    -   より適切な他の方法を使用できる場合に、リフレクションに依存するメソッドをコードで呼び出していますか。  
+  
+> [!NOTE]
+>  デスクトップ アプリと [!INCLUDE[net_native](../../../includes/net-native-md.md)]でのリフレクションとメタデータの可用性の違いから発生する問題の処理について詳しくは、「[リフレクションに依存する API](../../../docs/framework/net-native/apis-that-rely-on-reflection.md)」をご覧ください。  
+  
+ アプリのテスト時に発生する例外およびその他の問題の処理に関する具体的な例については、次のページを参照してください。  
+  
+-   [例: データ バインド時の例外の処理](../../../docs/framework/net-native/example-handling-exceptions-when-binding-data.md)  
+  
+-   [例: 動的プログラミングのトラブルシューティング](../../../docs/framework/net-native/example-troubleshooting-dynamic-programming.md)  
+  
+-   [.NET ネイティブ アプリでのランタイム例外](../../../docs/framework/net-native/runtime-exceptions-in-net-native-apps.md)  
+  
+## 参照  
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [NIB: .NET ネイティブのセットアップおよび構成](http://msdn.microsoft.com/ja-jp/7c9bc375-8b87-4c33-bede-72d513e362ec)   
+ [.NET Native とコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)   
+ [リフレクションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)   
+ [リフレクションに依存する API](../../../docs/framework/net-native/apis-that-rely-on-reflection.md)   
+ [シリアル化とメタデータ](../../../docs/framework/net-native/serialization-and-metadata.md)   
+ [Windows ストア アプリの .NET ネイティブへの移行](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/impliestype-element-net-native.md b/docs/framework/net-native/impliestype-element-net-native.md
new file mode 100644
index 00000000000..cb1d2ce1531
--- /dev/null
+++ b/docs/framework/net-native/impliestype-element-net-native.md
@@ -0,0 +1,129 @@
+---
+title: "&lt;ImpliesType&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3abd2071-0f28-40ba-b9a0-d52bd94cd2f6
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# &lt;ImpliesType&gt; 要素 (.NET ネイティブ)
+型にポリシーを適用します (含んでいる型またはメソッドにそのポリシーが適用されている場合)。  
+  
+## <a name="syntax"></a>構文  
+  
+```vb  
+  
+<ImpliesType Name="type_name"  
+             Activate="policy_type"  
+             Browse="policy_type"  
+             Dynamic="policy_type"  
+             Serialize="policy_type"   
+             DataContractSerializer="policy_setting"  
+             DataContractJsonSerializer="policy_setting"  
+             XmlSerializer="policy_setting"  
+             MarshalObject="policy_setting"  
+             MarshalDelegate="policy_setting"  
+             MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 型名を指定します。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*type_name*|型名。 これによって表される型場合`<ImpliesType>`要素が含まれているのと同じ名前空間にある`<Type>`要素、 *type_name*名前空間なしの型の名前を含めることができます。 それ以外の場合、 *type_name*完全修飾型名を含める必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|メソッドにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<ImpliesType>` 要素は主にライブラリによる使用を想定しています。 これは、次のシナリオに対応します。  
+  
+-   ルーチンを&1; つの型にリフレクションする必要がある場合、2 番目の型にもリフレクションする必要がある。  
+  
+-   スタティック分析で必要であると示されないため、2 番目の型の暗黙的なインスタンス化のメタデータをそれ以外の方法で使用できない。  
+  
+ 最も一般的には、2 つの型は共有型引数を持つジェネリックなインスタンス化です。  
+  
+ `<ImpliesType>` 要素は、その親要素により指定される型へのリフレクションが必要な場合、`<ImpliesType>` 要素によって指定される型へのリフレクションも暗黙的に必要になるという前提により定義されました。 たとえば、次のリフレクション ディレクティブは、`Explicit<T>` と `Implicit<T>` の&2; つの型に適用されます。  
+  
+```xml  
+  
+<Type Name=”Explicit{ET}”>  
+    <ImpliesType Name=”Implicit{ET}” Dynamic=”Required Public” />  
+</Type>  
+  
+```  
+  
+ このディレクティブは、`Explicit` のインスタンス化に `Dynamic` ポリシー設定が定義されていない場合は効果がありません。 たとえば、`Explicit<Int32>` の場合、`Implicit<Int32>` はそのパブリック メンバーをルートとしてインスタンス化され、そのメタデータが動的プログラミングで使用できるようになります。  
+  
+ 1 つ以上のシリアライザーに適用される、実際の例を次に示します。 ディレクティブは、何かへのリフレクションとして型指定されている要件をキャプチャする`IList<`*何か*`>`対応へのリフレクションも必要`List<`*何か*`>`せず、アプリケーションごとの注釈の型。  
+  
+```xml  
+  
+<Type Name=”System.Collections.Generic.IList{T}”>  
+   <ImpliesType Name=”System.Collections.Generic.List{T}” Serialize=”Public” />  
+</Type>  
+  
+```  
+  
+ `<ImpliesType>` 要素は `<Method>` 要素内にも配置できます。これは、ジェネリック メソッドのインスタンス化が型のインスタンス化へのリフレクションを暗黙的に決定する場合があるためです。 たとえば、ジェネリック メソッド`IEnumerable<T> MakeEnumerable<T>(string` `spelling``, T` `defaultValue``)` 、関連すると共に、特定のライブラリが動的にアクセスする<xref:System.Collections.Generic.List%601>と<xref:System.Array>型です。 これは次のように表すことができます。  
+  
+```xml  
+  
+<Type Name=”MyType”>  
+    <Method Name=”MakeEnumerable{T}” Signature=”(System.String, T)” Dynamic=”Included”>  
+        <ImpliesType Name=”T[]” Dynamic=”Public” />  
+        <ImpliesType Name=”System.Collections.Generic.List{T}” Dynamic=”Public”>  
+    </Method>  
+</Type>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/index.md b/docs/framework/net-native/index.md
new file mode 100644
index 00000000000..e107a89fafd
--- /dev/null
+++ b/docs/framework/net-native/index.md
@@ -0,0 +1,87 @@
+---
+title: ".NET ネイティブによるアプリのコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET とネイティブ コード"
+  - ".NET Native"
+  - "C# とネイティブ コンパイル"
+  - ".NET ネイティブによるコンパイル"
+  - "ネイティブ コンパイル"
+ms.assetid: 47cd5648-9469-4b1d-804c-43cc04384045
+caps.latest.revision: 27
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# .NET ネイティブによるアプリのコンパイル
+[!INCLUDE[net_native](../../../includes/net-native-md.md)] は、Windows アプリをビルドして配置するためのプリコンパイル テクノロジで、[!INCLUDE[vs_dev14](../../../includes/vs-dev14-md.md)] に含まれています。 マネージ コード \(C\# または Visual Basic\) で記述された、.NET Framework および Windows 10 を対象とするアプリのリリース バージョンを自動的にネイティブ コードにコンパイルします。  
+  
+ 通常、.NET Framework を対象とするアプリは中間言語 \(IL\) にコンパイルされます。 実行時に、Just\-In\-Time \(JIT\) コンパイラによって IL がネイティブ コードに変換されます。 これに対し、[!INCLUDE[net_native](../../../includes/net-native-md.md)]は、Windows アプリを直接ネイティブ コードにコンパイルします。 開発者にとって、これは次のことを意味します。  
+  
+-   アプリは、ネイティブ コードの優れたパフォーマンスを提供します。  
+  
+-   引き続き C\# または Visual Basic でプログラムを作成できます。  
+  
+-   クラス ライブラリ、自動メモリ管理とガベージ コレクション、例外処理など、.NET Framework で提供されるリソースを引き続き利用できます。  
+  
+ アプリのユーザーにとっては、[!INCLUDE[net_native](../../../includes/net-native-md.md)]には次のような利点があります。  
+  
+-   実行時間の短縮  
+  
+-   常に迅速に起動  
+  
+-   配置と更新コストの削減  
+  
+-   アプリのメモリ使用量の最適化  
+  
+ ただし、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、ネイティブ コードへのコンパイル以上の操作が行われます。 .NET Framework アプリのビルド方法と実行方法が変更されます。 特に次の点に注意してください。  
+  
+-   プリコンパイル時に、.NET Framework の必要な部分がアプリに静的にリンクされます。 これにより、アプリは .NET Framework のアプリ ローカルのライブラリを使用して実行でき、コンパイラはグローバル分析を実行してパフォーマンスを向上させることができます。 その結果、.NET Framework の更新後であっても、アプリは常に高速に起動します。  
+  
+-   [!INCLUDE[net_native](../../../includes/net-native-md.md)] ランタイムは静的プリコンパイル用に最適化されているため、優れたパフォーマンスを提供できます。 同時に、開発者に役立つ主要なリフレクション機能もあります。  
+  
+-   [!INCLUDE[net_native](../../../includes/net-native-md.md)]は、静的プリコンパイル シナリオ用に最適化されている、C\+\+ コンパイラと同じバックエンドを使用します。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)]は、この表に示すように、内部で C\+\+ と同じか類似のツールを使用しているため、マネージド コードの開発者に C\+\+ のパフォーマンス上の利点を提供できます。  
+  
+||[!INCLUDE[net_native](../../../includes/net-native-md.md)]|C\+\+|  
+|-|----------------------------------------------------------------|-----------|  
+|ライブラリ|.NET Framework \+ Windows ランタイム|Win32 \+ Windows ランタイム|  
+|コンパイラ|UTC 最適化コンパイラ|UTC 最適化コンパイラ|  
+|配置|実行可能バイナリ|実行可能バイナリ \(ASM\)|  
+|ランタイム|MRT.dll \(最小 CLR ランタイム\)|CRT.dll \(C ランタイム\)|  
+  
+ Windows 10 用の Windows アプリの場合は、.NET ネイティブ コード コンパイル バイナリをアプリ パッケージ \(.appx ファイル\) に入れて Windows ストアにアップロードします。  
+  
+## このセクションの内容  
+ .NET ネイティブ コード コンパイルを使用したアプリ開発の詳細については、次のトピックを参照してください。  
+  
+-   [.NET ネイティブ コード コンパイルの概要: 開発者向けチュートリアル](../../../docs/framework/net-native/getting-started-with-net-native.md)  
+  
+-   [.NET ネイティブとコンパイル:](../../../docs/framework/net-native/net-native-and-compilation.md) .NET ネイティブがプロジェクトをネイティブ コードにコンパイルする方法を取り上げます。  
+  
+-   [リフレクションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)  
+  
+    -   [リフレクションに依存する API](../../../docs/framework/net-native/apis-that-rely-on-reflection.md)  
+  
+    -   [リフレクション API リファレンス](../../../docs/framework/net-native/net-native-reflection-api-reference.md)  
+  
+    -   [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)  
+  
+-   [シリアル化とメタデータ](../../../docs/framework/net-native/serialization-and-metadata.md)  
+  
+-   [Windows ストア アプリの .NET ネイティブへの移行](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)  
+  
+-   [.NET ネイティブの一般的なトラブルシューティング](../../../docs/framework/net-native/net-native-general-troubleshooting.md)  
+  
+## 参照  
+ [.NET ネイティブに関する FAQ](http://msdn.microsoft.com/vstudio/dn642499.aspx)
\ No newline at end of file
diff --git a/docs/framework/net-native/library-element-net-native.md b/docs/framework/net-native/library-element-net-native.md
new file mode 100644
index 00000000000..b3d5e13ec33
--- /dev/null
+++ b/docs/framework/net-native/library-element-net-native.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;Library&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f642276b-33fb-4a81-b882-8808c31ba69e
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# &lt;Library&gt; 要素 (.NET ネイティブ)
+実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。  
+  
+## 構文  
+  
+```xml  
+<Library Name="assembly_name" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`Name`|必須の属性です。  アセンブリの名前を指定します。  この `<Library>` 要素の子要素によって、このアセンブリ内にある型と型のメンバーのランタイム リフレクション ポリシーが定義されます。|  
+  
+## Name 属性  
+  
+|値|説明|  
+|-------|--------|  
+|*assembly\_name*|ファイル拡張子のないアセンブリの簡易名です。  この属性は、<xref:System.Reflection.AssemblyName.Name%2A?displayProperty=fullName> プロパティに対応します。  たとえば、Extensions.dll というアセンブリの名前は "Extensions" です。  アセンブリのメタデータの条件付きインクルードをサポートする特殊な形式の *assembly\_name* については、「解説」セクションを参照してください。|  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md)|特定のアセンブリ内のすべての型にポリシーを適用します。|  
+|[\<Namespace\>](../../../docs/framework/net-native/namespace-element-net-native.md)|特定の名前空間内のすべての型にポリシーを適用します。|  
+|[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md)|クラスや構造体などの特定の型にポリシーを適用します。|  
+|[\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型にポリシーを適用します。  たとえば、[\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素を使用して `List<String>` 型のポリシーを定義できます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<Directives\>](../../../docs/framework/net-native/directives-element-net-native.md)|ランタイム ディレクティブ ファイルのルート要素です。|  
+  
+## 解説  
+ [\<Directives\>](../../../docs/framework/net-native/directives-element-net-native.md) 要素には、0 個以上の `<Library>` 要素を含めることができます。  
+  
+ `<Library>` 要素は、実行時に必要なメタデータを持つプログラム要素を定義するためのコンテナーとして機能します。この要素はポリシーを表しません。  コンパイル時に、コンパイラ ツールは `<Library>` 要素により指定されたライブラリでのみ、その子要素により示されるプログラム要素を検索します。  一方、[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md) 要素の子要素により示されるプログラム要素を検索する場合、コンパイラ ツールは .NET Framework コア ライブラリを含むすべてのライブラリを検索します。  
+  
+ `<Library>` ディレクティブは、条件付きで使用される場合があります。  `<Library>` 要素の名前の先頭と末尾がアスタリスク \(\*\) の場合、アスタリスク間に指定されているアセンブリがアプリによって参照される場合にのみ、`<Library>` ディレクティブの効果があります。  たとえば、次のランタイム ディレクティブは、Utillities.dll アセンブリがアプリによって参照されている場合にのみ適用されます。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Library Name=”*Utilities*”>  
+   ...  
+  </Library>  
+</Directives>  
+  
+```  
+  
+## 参照  
+ [\<Application\> 要素](../../../docs/framework/net-native/application-element-net-native.md)   
+ [\<Directives\> 要素](../../../docs/framework/net-native/directives-element-net-native.md)   
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/measuring-startup-improvement-with-net-native.md b/docs/framework/net-native/measuring-startup-improvement-with-net-native.md
new file mode 100644
index 00000000000..52293781fab
--- /dev/null
+++ b/docs/framework/net-native/measuring-startup-improvement-with-net-native.md
@@ -0,0 +1,106 @@
+---
+title: ".NET ネイティブによる起動時間の改善の測定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4d25b24-9c1a-4b3e-9705-97ba0d6c0289
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# .NET ネイティブによる起動時間の改善の測定
+[!INCLUDE[net_native](../../../includes/net-native-md.md)]によって、アプリの起動時間が大幅に改善されます。  この改善は、ポータブルの低電力デバイスや複雑なアプリで特に顕著です。  このトピックでは、この起動時間の改善を測定するために必要となる基本的なインストルメンテーションの概要を示します。  
+  
+ パフォーマンスの調査を容易にするために、.NET Framework と Windows では、イベントが発生したときにアプリからツールに通知できるようにする Windows イベント トレーシング \(ETW\) という名前のイベント フレームワークを使用しています。  PerfView というツールを使用して、ETW イベントを簡単に表示および分析できます。  このトピックでは、次の方法を説明します。  
+  
+-   <xref:System.Diagnostics.Tracing.EventSource> クラスを使用したイベントの生成。  
+  
+-   PerfView を使用したこれらのイベントの収集。  
+  
+-   PerfView を使用したこれらのイベントの表示。  
+  
+## EventSource を使用したイベントの生成  
+ <xref:System.Diagnostics.Tracing.EventSource> は、カスタム イベント プロバイダーの作成元となる基底クラスを提供します。  一般的に、<xref:System.Diagnostics.Tracing.EventSource> のサブクラスを作成して、独自のイベント メソッドで `Write*` メソッドをラップします。  通常、シングルトン パターンが各 <xref:System.Diagnostics.Tracing.EventSource> に使用されます。  
+  
+ たとえば、次の例のクラスを使用して、2 つのパフォーマンス特性を測定できます。  
+  
+-   `App` クラス コンストラクターが呼び出されるまでの時間。  
+  
+-   `MainPage` コンストラクターが呼び出されるまでの時間。  
+  
+ [!code-csharp[ProjectN_ETW#1](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_etw/cs/etw1.cs#1)]  
+  
+ ここではいくつか注意する点があります。  1 つ目は、シングルトンが `AppEventSource.Log` で作成されることです。  そのインスタンスが、すべてのログに使用されます。  2 つ目は、各イベント メソッドに <xref:System.Diagnostics.Tracing.EventAttribute> があることです。  これは、ツールが <xref:System.Diagnostics.Tracing.EventSource.WriteEvent%2A> メソッドのインデックスを、`AppEventSource` で呼び出されたメソッドに関連付けるのに役立ちます。  
+  
+ これらのイベントは単に説明を目的としていることに注意してください。  ほとんどのアプリ コードは、これらのイベントの後に実行されます。  ユーザー操作に対して、コード内のどのイベントが対応し、測定し、ベンチマークを改善するかを理解する必要があります。  また、イベント自体は時間内に 1 つのインスタンスのみをログに記録します。  一般的に、操作ごとに開始イベントと停止イベントを対にしておくと便利です。  アプリの起動を調べる場合、開始イベントは通常、オペレーティング システムが生成する "Process\/Start" イベントです。  
+  
+ たとえば、RSS リーダーを作成するとします。  次のような場合にイベントをログに記録すると役立ちます。  
+  
+-   メイン ページが初めて表示された場合。  
+  
+-   ローカル ストレージから古い RSS ストーリーが逆シリアル化された場合。  
+  
+-   アプリが新しいストーリーの同期を開始した場合。  
+  
+-   アプリが新しいストーリーの同期を終了した場合。  
+  
+ アプリのインストルメント化は簡単です。派生クラスで適切なメソッドを呼び出すのみです。  前の例の `AppEventSource` を使用して、次のようにアプリをインストルメント化できます。  
+  
+ [!code-csharp[ProjectN_ETW#2](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_etw/cs/etw2.cs#2)]  
+  
+ アプリがインストルメント化されたら、イベントを収集できるようになります。  
+  
+## PerfView でのイベントの収集  
+ PerfView は ETW イベントを使用して、アプリでさまざまなパフォーマンスを調査できるようにします。  また、さまざまな種類のイベントのログ記録をオンまたはオフにするために使用できる構成 GUI も含まれています。  PerfView は無料のツールで、[Microsoft ダウンロード センター](http://www.microsoft.com/download/details.aspx?id=28567)からダウンロードできます。  詳細については、[PerfView のチュートリアル ビデオ](http://channel9.msdn.com/Series/PerfView-Tutorial)を視聴してください。  
+  
+> [!NOTE]
+>  PerfView を使用して ARM システムでイベントを収集することはできません。  ARM システムでイベントを収集する場合は、Windows Performance Recorder \(WPR\) を使用します。  詳細については、[Vance Morrison のブログの投稿](http://blogs.msdn.com/b/vancem/archive/2012/12/19/collecting-etw-perfview-data-on-an-windows-rt-winrt-arm-surface-device.aspx)を参照してください。  
+  
+ コマンド ラインから PerfView を呼び出すこともできます。  プロバイダーからのイベントのみをログに記録する場合は、コマンドプロンプト ウィンドウを開き、次のコマンドを入力します。  
+  
+```  
+perfview -KernelEvents:Process -OnlyProviders:*MyCompany-MyApp collect outputFile   
+```  
+  
+ それぞれの文字について以下に説明します。  
+  
+ `-KernelEvents:Process`  
+ プロセスが開始および停止したときに通知するよう指定します。  他のイベント時間から減算できるよう、アプリに Process\/Start イベントが必要です。  
+  
+ `-OnlyProviders:*MyCompany-MyApp`  
+ PerfView が既定でオンにするその他のプロバイダーをオフにし、MyCompany\-MyApp プロバイダーをオンにします。  \(アスタリスクは、<xref:System.Diagnostics.Tracing.EventSource> であることを示します。\)  
+  
+ `collect outputFile`  
+ 収集を開始して、データを outputFile.etl.zip に保存するよう指定します。  
+  
+ PerfView の開始後にアプリを実行します。  アプリを実行するときには、次のことに注意してください。  
+  
+-   デバッグ ビルドではなく、リリース ビルドを使用します。  デバッグ ビルドには、多くの場合、アプリの実行に予想よりも時間がかかる原因となる、余分なエラー チェックおよびエラー処理コードが含まれています。  
+  
+-   デバッガーをアタッチしてアプリを実行すると、アプリのパフォーマンスに影響します。  
+  
+-   Windows では、アプリの起動時間を短縮するために複数のキャッシュ戦略を使用しています。  アプリが現在メモリにキャッシュされており、ディスクから読み込む必要がない場合、起動時間は短縮されます。  一貫性を保つために、測定前にアプリを数回起動して停止してください。  
+  
+ 生成されたイベントを PerfView can が収集できるようにアプリを実行した場合は、**\[コレクションの停止\]** を選択します。  通常は、アプリを停止する前にコレクションを停止して、不要なイベントを取得しないようにする必要があります。  ただし、シャットダウンまたは中断のパフォーマンスを測定する場合は、コレクションを続行します。  
+  
+## イベントの表示  
+ 既に収集されたイベントを表示するには、PerfView を使用して作成した .etl ファイルまたは .etl.zip ファイルを開き、**\[Events\]** を選択します。  ETW によって、他のプロセスのイベントを含む、多数のイベントに関する情報が収集されています。  調査の対象を絞り込むために、イベント ビューで次のテキスト ボックスに入力します。  
+  
+-   **\[Process Filter\]** ボックスで、アプリの名前を指定します \(".exe" は含めません\)。  
+  
+-   **\[Event Types Filter\]** ボックスに、「`Process/Start | MyCompany-MyApp`」と指定します。  これにより、MyCompany\-MyApp のイベントと Windows Kernel\/Process\/Start イベントのフィルターが設定されます。  
+  
+ 左ペインに示されているイベントをすべて選択し \(Ctrl \+ A\)、**Enter** キーを押します。  これで、各イベントのタイムスタンプを表示できるようになります。  これらのタイムスタンプは、トレースの開始時間を基準としています。そのため、起動時からの経過時間を調べるには、プロセスの開始時間から各イベントの時間を減算する必要があります。  Ctrl キーを押しながらクリックして 2 つのタイムスタンプを選択すると、ページ下部にあるステータス バーにそれらのタイムスタンプの差が表示されます。  これにより、表示されている 2 つのイベント間の経過時間が簡単にわかるようになります \(プロセスの開始を含む\)。  ビューのショートカット メニューを開いて、CSV ファイルにエクスポートしたり、Microsoft Excel を開いてデータを保存または処理したりするなど、便利なオプションを選択できます。  
+  
+ 元のアプリと [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンを使用してビルドしたバージョンの両方についてこの手順を繰り返し、パフォーマンスの違いを比較できます。  通常、[!INCLUDE[net_native](../../../includes/net-native-md.md)] アプリの方が [!INCLUDE[net_native](../../../includes/net-native-md.md)]以外のアプリよりも速く起動します。  より詳しく調べる場合は、最も時間がかかっているコードの部分を PerfView で特定することもできます。  詳細については、[PerfView のチュートリアル](http://channel9.msdn.com/Series/PerfView-Tutorial)を視聴するか、[Vance Morrison のブログの投稿](http://blogs.msdn.com/b/vancem/archive/2011/12/28/publication-of-the-perfview-performance-analysis-tool.aspx)を参照してください。  
+  
+## 参照  
+ <xref:System.Diagnostics.Tracing.EventSource>
\ No newline at end of file
diff --git a/docs/framework/net-native/method-element-net-native.md b/docs/framework/net-native/method-element-net-native.md
new file mode 100644
index 00000000000..801f72b0a7b
--- /dev/null
+++ b/docs/framework/net-native/method-element-net-native.md
@@ -0,0 +1,161 @@
+---
+title: "&lt;Method&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 348b49e5-589d-4eb2-a597-d6ff60ab52d1
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# &lt;Method&gt; 要素 (.NET ネイティブ)
+コンストラクターまたはメソッドにランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Method Name="method_name"  
+        Signature="method_signature"  
+        Browse="policy_type"  
+        Dynamic="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 メソッド名を指定します。|  
+|`Signature`|全般|省略可能な属性です。 メソッド シグネチャを指定します。 複数のパラメーターが存在する場合はコンマで区切られます。 たとえば、次`<Method>`要素のポリシーを定義、 <xref:System.DateTimeOffset.ToString%28System.String%2CSystem.IFormatProvider%29>メソッドです。<br /><br /> `<Type Name="System.DateTime">    <Method Name="ToString" Signature="System.String,System.IFormatProvider"            Dynamic="Required" /> </Type>`<br /><br /> 属性が存在しない場合、ランタイム ディレクティブは、メソッドのすべてのオーバーロードに適用されます。|  
+|`Browse`|反射|省略可能な属性です。 メソッドに関する情報の照会やメソッドの列挙を制御しますが、実行時の動的呼び出しは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクターまたはメソッドへの実行時アクセスを制御して、動的プログラミングを有効にします。 このポリシーにより、実行時にメンバーを動的に呼び出すことができます。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*メソッド名が*|メソッド名。 メソッドの型が、親によって定義された[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。|  
+  
+## <a name="signature-attribute"></a>シグネチャ属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*method_signature*|メソッド シグネチャを形成するパラメーター型です。 複数のパラメーターは、`"System.String,System.Int32,System.Int32)"` のようにコンマで区切ります。 パラメーターの型名は完全修飾されている必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`Auto`、`Excluded`、`Included`、および `Required` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/parameter-element-net-native.md)|メソッドに渡された引数の型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)|ジェネリック型またはメソッドのパラメーターの型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|型にポリシーを適用します (含んでいる `<Method>` 要素によって表されるメソッドにそのポリシーが適用されている場合)。|  
+|[<>\>](../../../docs/framework/net-native/typeparameter-element-net-native.md)|によって表される型にポリシーを適用、<xref:System.Type>メソッドに渡される引数。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ ジェネリック メソッドの `<Method>` 要素は、独自のポリシーを持たないインスタンス化すべてにそのポリシーを適用します。  
+  
+ `Signature` 属性を使用して、特定のメソッド オーバーロードのポリシーを指定できます。 そうしない場合、`Signature` 属性が存在しないと、メソッドのすべてのオーバーロードにランタイム ディレクティブが適用されます。  
+  
+ `<Method>` 要素を使用してコンストラクターのランタイム リフレクション ポリシーを定義することはできません。 Instead, use the `Activate` attribute of the  [<>\>](../../../docs/framework/net-native/assembly-element-net-native.md), [<>\>](../../../docs/framework/net-native/namespace-element-net-native.md), [<>\>](../../../docs/framework/net-native/type-element-net-native.md), or [<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) element.  
+  
+## <a name="example"></a>例  
+ 次の例の `Stringify` メソッドは、リフレクションを使用してオブジェクトを文字列形式に変換する汎用書式設定メソッドです。 オブジェクトの既定の呼び出しだけでなく`ToString`方法、メソッドでは、書式設定された結果文字列、オブジェクトを渡すことによって`ToString`メソッドに書式文字列、 <xref:System.IFormatProvider>実装、またはその両方です。 いずれかが呼び出すことも、 <xref:System.Convert.ToString%2A?displayProperty=fullName>バイナリ、16 進数、または&8; 進数形式に数値を変換するオーバー ロードします。  
+  
+ [!code-csharp[ProjectN_Reflection#7](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/method1.cs#7)]  
+  
+ `Stringify` メソッドは、次のようなコードによって呼び出すことができます。  
+  
+ [!code-csharp[ProjectN_Reflection#7](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/method1.cs#7)]  
+  
+ ただし、.NET ネイティブでコンパイルしたときに例をスローできます例外の数、実行時に含む<xref:System.NullReferenceException>と[MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)例外を除き、これが発生したため、`Stringify`メソッドは、主に、.NET Framework クラス ライブラリでプリミティブ型を動的に書式設定をサポートします。 ただし、既定のディレクティブ ファイルではそのメタデータを使用できません。 そのメタデータが使用可能になる場合でも、例では、スロー [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)例外のため、適切な`ToString`実装がネイティブ コードに含まれていません。  
+  
+ これらの例外をすべて使用して、除去できる、 [ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)存在し、追加することでメタデータを持つ必要があります型を定義する要素`<Method>`メソッドの実装がオーバー ロードに、要素が動的に呼び出せるも存在します。 これらの例外を排除し、例をエラーなしで実行できるようにした default.rd.xml ファイルを次に示します。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+     <Assembly Name="*Application*" Dynamic="Required All" />  
+  
+     <Type Name = "System.Convert" Browse="Required Public" Dynamic="Required Public" >  
+        <Method Name="ToString"    Dynamic ="Required" />  
+     </Type>  
+     <Type Name="System.Double" Browse="Required Public">  
+        <Method Name="ToString" Dynamic="Required" />  
+     </Type>  
+     <Type Name ="System.Int32" Browse="Required Public" >  
+        <Method Name="ToString" Dynamic="Required" />  
+     </Type>  
+     <Type Name ="System.Int64" Browse="Required Public" >  
+        <Method Name="ToString" Dynamic="Required" />  
+     </Type>  
+     <Namespace Name="System" >  
+        <Type Name="Byte" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="DateTime" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="Decimal" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="Guid" Browse ="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="Int16" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="SByte" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="Single" Browse="Required Public" >  
+          <Method Name="ToString" Dynamic="Required" />           
+        </Type>  
+        <Type Name="TimeSpan" Browse="Required Public" >  
+          <Method Name="ToString" Dynamic="Required" />           
+        </Type>  
+        <Type Name="UInt16" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="UInt32" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+        <Type Name="UInt64" Browse="Required Public" >  
+           <Method Name="ToString" Dynamic="Required" />  
+        </Type>  
+     </Namespace>  
+  </Application>  
+</Directives>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [<>\>要素](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/methodinstantiation-element-net-native.md b/docs/framework/net-native/methodinstantiation-element-net-native.md
new file mode 100644
index 00000000000..5c738e78601
--- /dev/null
+++ b/docs/framework/net-native/methodinstantiation-element-net-native.md
@@ -0,0 +1,88 @@
+---
+title: "&lt;MethodInstantiation&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3355d78-2a88-4109-8521-830d7cae260a
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# &lt;MethodInstantiation&gt; 要素 (.NET ネイティブ)
+構築されたジェネリック メソッドにランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<MethodInstantiation Name="method_name"  
+                     Signature="method_signature"  
+                     Arguments="method_arguments"  
+                     Browse="policy_type"  
+                     Dynamic="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 メソッド名を指定します。|  
+|`Signature`|全般|省略可能な属性です。 メソッドの名前付きパラメーターを指定します。 複数の名前付きパラメーターはコンマで区切られます。 `Signature` 属性は、オーバー ロードされたメソッドを区別するために使用します。|  
+|`Arguments`|全般|必須の属性です。 ジェネリック型の引数を指定します。 複数の引数が存在する場合は、コンマで区切られます。|  
+|`Browse`|反射|省略可能な属性です。 メソッドに関する情報の照会やメソッドの列挙を制御しますが、実行時の動的呼び出しは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクターまたはメソッドへの実行時アクセスを制御して、動的プログラミングを有効にします。 このポリシーにより、実行時にメンバーを動的に呼び出すことができます。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*メソッド名が*|メソッド名。 メソッドの型が、親によって定義された[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。|  
+  
+## <a name="signature-attribute"></a>シグネチャ属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*method_signature*|メソッドの名前付きパラメーターを指定します。 複数のパラメーターが存在する場合はコンマで区切られます。|  
+  
+## <a name="arguments-attribute"></a>引数属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*method_arguments*|ジェネリック型の引数を指定します。 複数の引数が存在する場合は、コンマで区切られます。 各引数は、完全修飾型名で構成されている必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|メソッドのこのポリシーの種類に適用する設定です。 指定できる値は、`Auto`、`Excluded`、`Included`、および `Required` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<MethodInstantiation>` 要素は、対応するオープン ジェネリック メソッドのランタイム リフレクション ポリシーをオーバーライドします。  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [<>\>要素](../../../docs/framework/net-native/method-element-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md b/docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md
new file mode 100644
index 00000000000..b5aefb27e0b
--- /dev/null
+++ b/docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md
@@ -0,0 +1,686 @@
+---
+title: "Windows ストア アプリの .NET ネイティブへの移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4153aa18-6f56-4a0a-865b-d3da743a1d05
+caps.latest.revision: 29
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# Windows ストア アプリの .NET ネイティブへの移行
+[!INCLUDE[net_native](../../../includes/net-native-md.md)]は、Windows ストアまたは開発者のコンピューターでアプリの静的なコンパイルを行います。 これは、デバイス上で Just\-In\-Time \(JIT\) コンパイラまたは[ネイティブ イメージ ジェネレーター \(Ngen.exe\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) によって Windows ストア アプリに対して実行される動的なコンパイルとは異なります。 違いはありますが、[!INCLUDE[net_native](../../../includes/net-native-md.md)] は [Windows ストア アプリ用 .NET](http://msdn.microsoft.com/library/windows/apps/br230302.aspx) との互換性を保持しようとします。 Windows ストア アプリ用 .NET で機能する大部分が [!INCLUDE[net_native](../../../includes/net-native-md.md)]でも機能します。  ただし、動作に違いがある場合もあります。 このドキュメントでは、次の領域における、標準の Windows ストア アプリ用 .NET と [!INCLUDE[net_native](../../../includes/net-native-md.md)]との違いについて説明します。  
+  
+-   [全般的なランタイムの違い](#Runtime)  
+  
+-   [動的プログラミングの違い](#Dynamic)  
+  
+-   [リフレクションに関するその他の違い](#Reflection)  
+  
+-   [サポートされていないシナリオと API](#Unsupported)  
+  
+-   [Visual Studio の違い](#VS)  
+  
+<a name="Runtime"></a>   
+## 全般的なランタイムの違い  
+  
+-   アプリが共通言語ランタイム \(CLR\) で実行されているときに JIT コンパイラによってスローされる <xref:System.TypeLoadException> などの例外は、通常、[!INCLUDE[net_native](../../../includes/net-native-md.md)]によって処理されるときにはコンパイル時エラーになります。  
+  
+-   アプリの UI スレッドから <xref:System.GC.WaitForPendingFinalizers%2A?displayProperty=fullName> メソッドを呼び出さないでください。 これにより [!INCLUDE[net_native](../../../includes/net-native-md.md)]でデッドロックが発生する可能性があります。  
+  
+-   静的クラス コンストラクターの呼び出し順序に依存しないでください。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、呼び出し順序が標準ランタイムでの順序と異なります。 \(標準ランタイムを使用する場合であっても、静的クラス コンストラクターの実行順序に依存しないでください。\)  
+  
+-   スレッドでの呼び出しを行わない無限ループ \(たとえば、`while(true);`\) によって、アプリが停止する可能性があります。 同様に、長時間または無限の待機によってもアプリが停止する可能性があります。  
+  
+-   特定の汎用初期化サイクルは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]で例外をスローしません。 たとえば、次のコードは標準 CLR では <xref:System.TypeLoadException> 例外をスローします。[!INCLUDE[net_native](../../../includes/net-native-md.md)]ではスローしません。  
+  
+     [!code-csharp[ProjectN#8](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/compat1.cs#8)]  
+  
+-   場合によっては、[!INCLUDE[net_native](../../../includes/net-native-md.md)]は、.NET Framework クラス ライブラリのさまざまな実装を提供します。 メソッドから返されるオブジェクトは、常に、返される型のメンバーを実装します。 ただし、その補助的な実装が異なるため、その他の .NET Framework プラットフォームの場合と同じ型セットへのオブジェクトのキャストを行うことができない場合があります。 たとえば、<xref:System.Collections.Generic.IEnumerable%601> や <xref:System.Reflection.TypeInfo.DeclaredMembers%2A?displayProperty=fullName> などのメソッドにより返される <xref:System.Reflection.TypeInfo.DeclaredProperties%2A?displayProperty=fullName> インターフェイス オブジェクトを `T[]` にキャストできない場合があります。  
+  
+-   WinInet キャッシュは、Windows ストア アプリ用 .NET では既定で有効になっていませんが、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では有効になっています。 これによりパフォーマンスが向上しますが、作業セットへの影響があります。 開発者のアクションは必要ありません。  
+  
+<a name="Dynamic"></a>   
+## 動的プログラミングの違い  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)]は、パフォーマンスを最大化するために、.NET Framework のコードに静的にリンクし、アプリにローカルなコードにします。 ただし、バイナリ サイズは小さいままである必要があるため、.NET Framework 全体を取り入れることはできません。[!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラは、未使用のコードへの参照を削除する依存関係レジューサを使用して、この制限を解決します。 ただし、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、一部の型情報をコンパイル時に静的に推論できず、代わりに実行時に動的に取得する場合、そのような型情報やコードを維持または生成しないことがあります。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)]は、リフレクションと動的プログラミングを有効にします。 ただし、すべての型をリフレクション対象としてマークできるわけではありません。そうすると、生成されるコード サイズが大きくなりすぎるため \(特に、.NET Framework での パブリック API へのリフレクションがサポートされているため\) です。[!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラは、どの型でリフレクションをサポートする必要があるかを適切に判断し、それらの型についてのみメタデータを維持し、コードを生成します。  
+  
+ たとえば、データ バインディングは、プロパティ名を関数にマップするためにアプリを必要とします。 Windows ストア アプリ用 .NET では、共通言語ランタイムが自動的にリフレクションを使用して、マネージド型および公開されているネイティブ型にこの機能を提供します。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、データのバインド先の型のメタデータが、コンパイラによって自動的に含められます。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラは、ヒントやディレクティブなしで機能する、<xref:System.Collections.Generic.List%601> や <xref:System.Collections.Generic.Dictionary%602> などの一般的に使用されるジェネリック型も処理できます。[dynamic](../Topic/dynamic%20\(C%23%20Reference\).md) キーワードも、一定の制限の下でサポートされます。  
+  
+> [!NOTE]
+>  アプリを [!INCLUDE[net_native](../../../includes/net-native-md.md)]に移植するときには、すべての動的コード パスを十分にテストする必要があります。  
+  
+ ほとんどの開発者にとっては [!INCLUDE[net_native](../../../includes/net-native-md.md)]の既定の構成で十分ですが、開発者によっては、ランタイム ディレクティブ \(.rd.xml\) ファイルを使用した構成の微調整が必要となる場合もあります。 さらに、場合によっては、[!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラがリフレクションで使用できるようにする必要があるメタデータを判断できず、ヒントを利用することがあります。特に次のような場合です。  
+  
+-   <xref:System.Type.MakeGenericType%2A?displayProperty=fullName> や <xref:System.Reflection.MethodInfo.MakeGenericMethod%2A?displayProperty=fullName> などの一部の構造体は、静的に決定できません。  
+  
+-   コンパイラでインスタンス化を決定できないため、リフレクション対象のジェネリック型をランタイム ディレクティブで指定する必要があります。 これは、すべてのコードを含める必要があるだけではなく、ジェネリック型へのリフレクションによって無限サイクルが生じる可能性があるためです \(たとえば、ジェネリック型でジェネリック メソッドが呼び出された場合\)。  
+  
+> [!NOTE]
+>  ランタイム ディレクティブは、ランタイム ディレクティブ \(.rd.xml\) ファイルで定義されます。 このファイルの使用に関する全般的な情報については、「[作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)」をご覧ください。 ランタイム ディレクティブについては、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」をご覧ください。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)]には、既定セット以外のどの型でリフレクションをサポートするかを開発者が決定するときに役立つプロファイリング ツールも含まれています。  
+  
+<a name="Reflection"></a>   
+## リフレクションに関するその他の違い  
+ Windows ストア アプリ用 .NET と [!INCLUDE[net_native](../../../includes/net-native-md.md)]の間には、その動作にリフレクション関連のその他の個別の違いが多数あります。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] の場合:  
+  
+-   .NET Framework クラス ライブラリでの型とメンバーに対するプライベート リフレクションはサポートされません。 ただし、独自のプライベート型とメンバー、およびサードパーティ ライブラリの型とメンバーに対するリフレクションは行うことができます。  
+  
+-   <xref:System.Reflection.ParameterInfo.HasDefaultValue%2A?displayProperty=fullName> プロパティは、戻り値を表す `false` オブジェクトに対し、正しく <xref:System.Reflection.ParameterInfo> を返します。 Windows ストア アプリ用 .NET の場合、これは `true` を返します。 中間言語 \(IL\) はこれを直接サポートせず、解釈は言語に任されます。  
+  
+-   <xref:System.RuntimeFieldHandle> 構造体と <xref:System.RuntimeMethodHandle> 構造体のパブリック メンバーはサポートされません。 これらの型は、LINQ、式ツリー、および静的な配列の初期化でのみサポートされます。  
+  
+-   <xref:System.Reflection.RuntimeReflectionExtensions.GetRuntimeProperties%2A?displayProperty=fullName> と <xref:System.Reflection.RuntimeReflectionExtensions.GetRuntimeEvents%2A?displayProperty=fullName> の基底クラスには隠ぺいされたメンバーが含まれるため、明示的なオーバーライドなしでオーバーライドできます。 これは、その他の [RuntimeReflectionExtensions.GetRuntime\*](http://msdn.microsoft.com/library/system.reflection.runtimereflectionextensions_methods.aspx) メソッドの場合も同様です。  
+  
+-   <xref:System.Type.MakeArrayType%2A?displayProperty=fullName> と <xref:System.Type.MakeByRefType%2A?displayProperty=fullName> は、特定の組み合わせ \(たとえば、byref の配列\) を作成しようとしたときに失敗しません。  
+  
+-   リフレクションを使用して、ポインター パラメーターを持つメンバーを呼び出すことはできません。  
+  
+-   リフレクションを使用して、ポインター フィールドを取得または設定することはできません。  
+  
+-   引数カウントが間違っていて、いずれかの引数の型が正しくない場合、[!INCLUDE[net_native](../../../includes/net-native-md.md)]は <xref:System.ArgumentException> ではなく <xref:System.Reflection.TargetParameterCountException> をスローします。  
+  
+-   通常、例外のバイナリ シリアル化はサポートされません。 そのため、シリアル化不可能なオブジェクトを <xref:System.Exception.Data%2A?displayProperty=fullName> ディクショナリに追加できます。  
+  
+<a name="Unsupported"></a>   
+## サポートされていないシナリオと API  
+ 次のセクションに、全般的な開発、相互運用、および HTTPClient や Windows Communication Foundation \(WCF\) などの技術でサポートされないシナリオと API を示します。  
+  
+-   [全般的な開発](#General)  
+  
+-   [HttpClient](#HttpClient)  
+  
+-   [Interop](#Interop)  
+  
+-   [サポートされていない API](#APIs)  
+  
+<a name="General"></a>   
+### 全般的な開発の違い  
+ **値型**  
+  
+-   値型の <xref:System.ValueType.Equals%2A?displayProperty=fullName> メソッドと <xref:System.ValueType.GetHashCode%2A?displayProperty=fullName> メソッドをオーバーライドする場合は、基底クラスの実装を呼び出さないでください。 Windows ストア アプリ用 .NET では、これらのメソッドはリフレクションに依存します。 コンパイル時に、[!INCLUDE[net_native](../../../includes/net-native-md.md)]はランタイム リフレクションに依存しない実装を生成します。 つまり、これら 2 つのメソッドをオーバーライドしなければ、[!INCLUDE[net_native](../../../includes/net-native-md.md)]によってコンパイル時に実装が生成されるため、これらのメソッドは期待どおりに動作します。 ただし、基底クラスの実装を呼び出さずにこれらのメソッドをオーバーライドすると、例外が発生します。  
+  
+-   1 メガバイトより大きい値型はサポートされません。  
+  
+-   値型は、[!INCLUDE[net_native](../../../includes/net-native-md.md)]で既定のコンストラクターを持つことができません。 \(C\# と Visual Basic では、値型の既定のコンストラクターが許可されません。 ただし、IL ではこれらを作成できます。\)  
+  
+ **配列**  
+  
+-   ゼロ以外の下限を持つ配列はサポートされません。 通常、これらの配列は [Array.CreateInstance\(Type, Int32\[\], Int32\<xref:System.Array.CreateInstance%28System.Type%2CSystem.Int32%5B%5D%2CSystem.Int32%5B%5D%29?displayProperty=fullName> オーバーロードを呼び出すことで作成されます。  
+  
+-   多次元配列の動的作成はサポートされません。 そのような配列は通常、<xref:System.Array.CreateInstance%2A?displayProperty=fullName> パラメーターを含む `lengths` メソッドのオーバーロードを呼び出すか、<xref:System.Type.MakeArrayType%28System.Int32%29?displayProperty=fullName> メソッドを呼び出すことで作成されます。  
+  
+-   4 つ以上の次元を持つ多次元配列 \(つまり、<xref:System.Array.Rank%2A?displayProperty=fullName> プロパティ値が 4 以上のもの\) はサポートされません。 代わりに[ジャグ配列](../Topic/Jagged%20Arrays%20\(C%23%20Programming%20Guide\).md) \(配列の配列\) を使用してください。 たとえば、`array[x,y,z]` は無効ですが、`array[x][y][z]` は有効です。  
+  
+-   多次元配列の共変性はサポートされず、実行時に <xref:System.InvalidCastException> 例外を発生させます。  
+  
+ **ジェネリック**  
+  
+-   ジェネリック型の無限展開はコンパイル エラーになります。 たとえば、このコードはコンパイルに失敗します。  
+  
+     [!code-csharp[ProjectN#9](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/compat2.cs#9)]  
+  
+ **ポインター**  
+  
+-   ポインターの配列はサポートされていません。  
+  
+-   リフレクションを使用して、ポインター フィールドを取得または設定することはできません。  
+  
+ **シリアル化**  
+  
+ <xref:System.Runtime.Serialization.KnownTypeAttribute.%23ctor%28System.String%29> 属性はサポートされていません。 代わりに <xref:System.Runtime.Serialization.KnownTypeAttribute.%23ctor%28System.Type%29> 属性を使用してください。  
+  
+ **リソース**  
+  
+ <xref:System.Diagnostics.Tracing.EventSource> クラスでのローカライズされたリソースの使用はサポートされません。<xref:System.Diagnostics.Tracing.EventSourceAttribute.LocalizationResources%2A?displayProperty=fullName> プロパティはローカライズされたリソースを定義しません。  
+  
+ **デリゲート**  
+  
+ `Delegate.BeginInvoke` と `Delegate.EndInvoke` はサポートされません。  
+  
+ **Async**  
+  
+ Task IAsync のオーバーロードでのスレッドのロジックはサポートされません。  
+  
+ **その他の API**  
+  
+-   <xref:System.Reflection.TypeInfo.GUID%2A?displayProperty=fullName> 属性が型に適用されない場合、<xref:System.PlatformNotSupportedException> プロパティは <xref:System.Runtime.InteropServices.GuidAttribute> 例外をスローします。 GUID は主に COM サポートで使用されます。  
+  
+-   <xref:System.DateTime.Parse%2A?displayProperty=fullName> メソッドは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]で、短い日付を含む文字列を正しく解析します。 ただし、Microsoft サポート技術情報の記事 [KB2803771](http://support.microsoft.com/kb/2803771) と [KB2803755](http://support.microsoft.com/kb/2803755) で説明されている日付と時刻の解析の変更に対する互換性は保持されません。  
+  
+-   <xref:System.Numerics.BigInteger.ToString%2A?displayProperty=fullName> `("E")` は [!INCLUDE[net_native](../../../includes/net-native-md.md)]で正しく丸められます。 CLR の一部のバージョンでは、結果の文字列が丸められるのではなく、切り捨てられます。  
+  
+<a name="HttpClient"></a>   
+### HttpClient の違い  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] では、<xref:System.Net.Http.HttpClientHandler> クラスは、標準の Windows ストア アプリ用 .NET で使用される <xref:System.Net.WebRequest> クラスと <xref:System.Net.WebResponse> クラスの代わりに、WinINet を \([HttpBaseProtocolFilter](http://msdn.microsoft.com/library/windows/apps/windows.web.http.filters.httpbaseprotocolfilter.aspx) クラスを通じて\) 内部で使用します。  WinINet では、<xref:System.Net.Http.HttpClientHandler> クラスでサポートされる構成オプションがすべてサポートされるわけではありません。  結果は次のようになります。  
+  
+-   <xref:System.Net.Http.HttpClientHandler> の機能プロパティの一部は `false`では [!INCLUDE[net_native](../../../includes/net-native-md.md)] を返しますが、標準の Windows ストア アプリ用 .NET では `true` を返します。  
+  
+-   構成プロパティ `get` アクセサーの一部は、[!INCLUDE[net_native](../../../includes/net-native-md.md)]で、常に、Windows ストア アプリ用 .NET の既定の構成値とは異なる固定値を返します。  
+  
+ 次のサブセクションで、その他の動作の違いについて説明します。  
+  
+ **プロキシ**  
+  
+ [HttpBaseProtocolFilter](http://msdn.microsoft.com/library/windows/apps/windows.web.http.filters.httpbaseprotocolfilter.aspx) クラスは、要求ごとのプロキシの構成とオーバーライドをサポートしません。  つまり、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、すべての要求が、<xref:System.Net.Http.HttpClientHandler.UseProxy%2A?displayProperty=fullName> プロパティの値に応じて、システム構成のプロキシ サーバーを使用するか、プロキシ サーバーを使用しません。  Windows ストア アプリ用 .NET では、プロキシ サーバーは <xref:System.Net.Http.HttpClientHandler.Proxy%2A?displayProperty=fullName> プロパティにより定義されます。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、<xref:System.Net.Http.HttpClientHandler.Proxy%2A?displayProperty=fullName> を `null` 以外の値に設定すると、<xref:System.PlatformNotSupportedException> 例外がスローされます。<xref:System.Net.Http.HttpClientHandler.SupportsProxy%2A?displayProperty=fullName> プロパティは、`false`では [!INCLUDE[net_native](../../../includes/net-native-md.md)] を返しますが、標準の Windows ストア アプリ用 .NET Framework では `true` を返します。  
+  
+ **自動リダイレクト**  
+  
+ [HttpBaseProtocolFilter](http://msdn.microsoft.com/library/windows/apps/windows.web.http.filters.httpbaseprotocolfilter.aspx) クラスでは、自動リダイレクトの最大数の構成が許可されません。  標準の Windows ストア アプリ用 .NET での <xref:System.Net.Http.HttpClientHandler.MaxAutomaticRedirections%2A?displayProperty=fullName> プロパティの値は既定で 50 で、変更できません。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、このプロパティの値は 10 で、変更しようとすると <xref:System.PlatformNotSupportedException> 例外がスローされます。<xref:System.Net.Http.HttpClientHandler.SupportsRedirectConfiguration%2A?displayProperty=fullName> プロパティは `false`では [!INCLUDE[net_native](../../../includes/net-native-md.md)] を返し、Windows ストア アプリ用 .NET では `true` を返します。  
+  
+ **自動展開**  
+  
+ Windows ストア アプリ用 .NET では、<xref:System.Net.Http.HttpClientHandler.AutomaticDecompression%2A?displayProperty=fullName> プロパティを <xref:System.Net.DecompressionMethods>、<xref:System.Net.DecompressionMethods>、<xref:System.Net.DecompressionMethods> と <xref:System.Net.DecompressionMethods> の両方、または <xref:System.Net.DecompressionMethods> に設定できます。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、<xref:System.Net.DecompressionMethods> と <xref:System.Net.DecompressionMethods> を共に設定するか、<xref:System.Net.DecompressionMethods> の設定のみがサポートされます。<xref:System.Net.Http.HttpClientHandler.AutomaticDecompression%2A> プロパティを <xref:System.Net.DecompressionMethods> のみまたは <xref:System.Net.DecompressionMethods> のみに設定しようとすると、<xref:System.Net.DecompressionMethods> と <xref:System.Net.DecompressionMethods> の両方に自動的に設定されます。  
+  
+ **クッキー**  
+  
+ クッキーの処理は、<xref:System.Net.Http.HttpClient> と WinINet により同時に行われます。<xref:System.Net.CookieContainer> のクッキーは、WinINet クッキー キャッシュのクッキーと組み合わされます。<xref:System.Net.CookieContainer> のクッキーを削除すると <xref:System.Net.Http.HttpClient> からクッキーが送信されませんが、クッキーが既に WinINet に示されており、ユーザーによって削除されない場合、WinINet がクッキーを送信します。<xref:System.Net.Http.HttpClient>、<xref:System.Net.Http.HttpClientHandler>、または <xref:System.Net.CookieContainer> API を使用して、プログラムにより WinINet からクッキーを削除することはできません。<xref:System.Net.Http.HttpClientHandler.UseCookies%2A?displayProperty=fullName> プロパティを `false` に設定しても、<xref:System.Net.Http.HttpClient> からクッキーが送信されなくなるのみで、WinINet の要求にはまだそのクッキーが含まれている可能性があります。  
+  
+ **資格情報**  
+  
+ Windows ストア アプリ用 .NET では、<xref:System.Net.Http.HttpClientHandler.UseDefaultCredentials%2A?displayProperty=fullName> プロパティと <xref:System.Net.Http.HttpClientHandler.Credentials%2A?displayProperty=fullName> プロパティは独立して動作します。  また、<xref:System.Net.Http.HttpClientHandler.Credentials%2A> プロパティは <xref:System.Net.ICredentials> インターフェイスを実装するオブジェクトをすべて受け入れます。[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、<xref:System.Net.Http.HttpClientHandler.UseDefaultCredentials%2A> プロパティを `true` に設定すると、<xref:System.Net.Http.HttpClientHandler.Credentials%2A> プロパティが `null` になります。  さらに、<xref:System.Net.Http.HttpClientHandler.Credentials%2A> プロパティは、`null`、<xref:System.Net.CredentialCache.DefaultCredentials%2A>、または <xref:System.Net.NetworkCredential> 型のオブジェクトにしか設定できません。  その他の <xref:System.Net.ICredentials> オブジェクト \(最も一般的なものは <xref:System.Net.CredentialCache>\) を <xref:System.Net.Http.HttpClientHandler.Credentials%2A> プロパティに割り当てると、<xref:System.PlatformNotSupportedException> がスローされます。  
+  
+ **その他のサポートされていない機能または構成できない機能**  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] の場合:  
+  
+-   <xref:System.Net.Http.HttpClientHandler.ClientCertificateOptions%2A?displayProperty=fullName> プロパティの値は常に <xref:System.Net.Http.ClientCertificateOption> です。  Windows ストア アプリ用 .NET での既定値は <xref:System.Net.Http.ClientCertificateOption> です。  
+  
+-   <xref:System.Net.Http.HttpClientHandler.MaxRequestContentBufferSize%2A?displayProperty=fullName> プロパティは構成できません。  
+  
+-   <xref:System.Net.Http.HttpClientHandler.PreAuthenticate%2A?displayProperty=fullName> プロパティは常に `true` です。  Windows ストア アプリ用 .NET での既定値は `false` です。  
+  
+-   応答の `SetCookie2` ヘッダーは廃止されたものとして無視されます。  
+  
+<a name="Interop"></a>   
+### 相互運用の違い  
+ **非推奨 API**  
+  
+ マネージド コードで相互運用性のために使用される頻度が低い API のいくつかが、非推奨になっています。 これらの API を [!INCLUDE[net_native](../../../includes/net-native-md.md)]で使用すると、<xref:System.NotImplementedException> 例外か <xref:System.PlatformNotSupportedException> 例外がスローされるか、コンパイラ エラーになる場合があります。 Windows ストア アプリ用 .NET では、これらの API は廃止としてマークされていますが、これらの API を呼び出すとコンパイラ エラーではなくコンパイラの警告が生成されます。  
+  
+ 非推奨の `VARIANT` マーシャリング用 API:  
+  
+||  
+|-|  
+|<xref:System.Runtime.InteropServices.BStrWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.CurrencyWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.DispatchWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.ErrorWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.UnknownWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.VariantWrapper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.VarEnum?displayProperty=fullName>|  
+  
+ <xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName> はサポートされていますが、[IDispatch](http://msdn.microsoft.com/library/windows/apps/ms221608.aspx) や byref バリアントと共に使用された場合など、一部のシナリオでは例外がスローされます。  
+  
+ 非推奨の [IDispatch](http://msdn.microsoft.com/library/windows/apps/ms221608.aspx) サポート用 API:  
+  
+|型|メンバー|  
+|-------|----------|  
+|<xref:System.Runtime.InteropServices.ClassInterfaceType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.ClassInterfaceType>|  
+|<xref:System.Runtime.InteropServices.ClassInterfaceType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.ClassInterfaceType>|  
+|<xref:System.Runtime.InteropServices.ComDefaultInterfaceAttribute?displayProperty=fullName>|属性はサポートされません。|  
+  
+ 非推奨のクラシック COM イベント用 API:  
+  
+||  
+|-|  
+|<xref:System.Runtime.InteropServices.ComEventsHelper?displayProperty=fullName>|  
+|<xref:System.Runtime.InteropServices.ComSourceInterfacesAttribute>|  
+  
+ 非推奨の <xref:System.Runtime.InteropServices.ICustomQueryInterface?displayProperty=fullName> インターフェイスの API \([!INCLUDE[net_native](../../../includes/net-native-md.md)]では非サポート\):  
+  
+|種類|メンバー|  
+|--------|----------|  
+|<xref:System.Runtime.InteropServices.ICustomQueryInterface?displayProperty=fullName>|すべてのメンバー。|  
+|<xref:System.Runtime.InteropServices.CustomQueryInterfaceMode?displayProperty=fullName>|すべてのメンバー。|  
+|<xref:System.Runtime.InteropServices.CustomQueryInterfaceResult?displayProperty=fullName>|すべてのメンバー。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetComInterfaceForObject%28System.Object%2CSystem.Type%2CSystem.Runtime.InteropServices.CustomQueryInterfaceMode%29?displayProperty=fullName>|  
+  
+ その他のサポートされない相互運用機能:  
+  
+|種類|メンバー|  
+|--------|----------|  
+|<xref:System.Runtime.InteropServices.ICustomAdapter?displayProperty=fullName>|すべてのメンバー。|  
+|<xref:System.Runtime.InteropServices.SafeBuffer?displayProperty=fullName>|すべてのメンバー。|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.UnmanagedType>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.UnmanagedType>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.UnmanagedType>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.UnmanagedType>|  
+|<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.UnmanagedType>|  
+  
+ ほとんど使用されないマーシャリング API:  
+  
+|種類|メンバー|  
+|--------|----------|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReadByte%28System.Object%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReadInt16%28System.Object%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReadInt32%28System.Object%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReadInt64%28System.Object%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReadIntPtr%28System.Object%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.WriteByte%28System.Object%2CSystem.Int32%2CSystem.Byte%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.WriteInt16%28System.Object%2CSystem.Int32%2CSystem.Int16%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.WriteInt32%28System.Object%2CSystem.Int32%2CSystem.Int32%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.WriteInt64%28System.Object%2CSystem.Int32%2CSystem.Int64%29>|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.WriteIntPtr%28System.Object%2CSystem.Int32%2CSystem.IntPtr%29>|  
+  
+ **プラットフォーム呼び出しと COM 相互運用の互換性**  
+  
+ ほとんどのプラットフォーム呼び出しと COM 相互運用シナリオは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]でもサポートされます。 特に、Windows ランタイム \(WinRT\) API とのすべての相互運用性と Windows ランタイムで必要なすべてのマーシャリングがサポートされます。 これには、次のものに対するマーシャリング サポートが含まれます。  
+  
+-   配列 \(<xref:System.Runtime.InteropServices.UnmanagedType?displayProperty=fullName> を含む\)  
+  
+-   `BStr`  
+  
+-   デリゲート  
+  
+-   文字列 \(Unicode、Ansi、および HSTRING\)  
+  
+-   構造体 \(`byref` と `byval`\)  
+  
+-   Unions  
+  
+-   Win32 ハンドル  
+  
+-   すべての WinRT 構造体  
+  
+-   マーシャリング バリアント型の部分的なサポート。 次の型がサポートされます。  
+  
+    -   <xref:System.Boolean>  
+  
+    -   <xref:System.Byte>  
+  
+    -   <xref:System.Decimal>  
+  
+    -   <xref:System.Double>  
+  
+    -   <xref:System.Int16>  
+  
+    -   <xref:System.Int32>  
+  
+    -   <xref:System.Int64>  
+  
+    -   <xref:System.SByte>  
+  
+    -   <xref:System.Single>  
+  
+    -   <xref:System.UInt16>  
+  
+    -   <xref:System.UInt32>  
+  
+    -   <xref:System.UInt64>  
+  
+    -   `BStr`  
+  
+    -   [IUnknown](http://msdn.microsoft.com/library/windows/desktop/ms680509.aspx)  
+  
+ ただし、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、次のことはサポートされません。  
+  
+-   クラシック COM イベントの使用  
+  
+-   マネージド型での <xref:System.Runtime.InteropServices.ICustomQueryInterface?displayProperty=fullName> インターフェイスの実装  
+  
+-   <xref:System.Runtime.InteropServices.ComDefaultInterfaceAttribute?displayProperty=fullName> 属性を使用したマネージ型での [IDispatch](http://msdn.microsoft.com/library/windows/apps/ms221608.aspx) インターフェイスの実装。 ただし、`IDispatch` から COM オブジェクトを呼び出すことはできず、マネージド オブジェクトは `IDispatch` を実装できないことに注意してください。  
+  
+ リフレクションを使用したプラットフォーム呼び出しメソッドの呼び出しはサポートされません。 この制限を回避するには、別のメソッドでメソッド呼び出しをラップし、リフレクションを使用してラッパーを代わりに呼び出します。  
+  
+<a name="APIs"></a>   
+### その他の Windows ストア アプリ用 .NET API との違い  
+ このセクションには、[!INCLUDE[net_native](../../../includes/net-native-md.md)]でサポートされないその他の API を示します。 サポートされない API で最も多いのは、Windows Communication Foundation \(WCF\) API です。  
+  
+ **DataAnnotations \(System.ComponentModel.DataAnnotations\)**  
+  
+ <xref:System.ComponentModel.DataAnnotations> 名前空間と <xref:System.ComponentModel.DataAnnotations.Schema> 名前空間内の型は、[!INCLUDE[net_native](../../../includes/net-native-md.md)]ではサポートされません。 これらには、Windows 8 の Windows ストア アプリ用 .NET に存在する次の型が含まれます。  
+  
+||  
+|-|  
+|<xref:System.ComponentModel.DataAnnotations.AssociationAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.ConcurrencyCheckAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.CustomValidationAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.DataType?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.DataTypeAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.DisplayAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.DisplayColumnAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.DisplayFormatAttribute>|  
+|<xref:System.ComponentModel.DataAnnotations.EditableAttribute>|  
+|<xref:System.ComponentModel.DataAnnotations.EnumDataTypeAttribute>|  
+|<xref:System.ComponentModel.DataAnnotations.FilterUIHintAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.KeyAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.RangeAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.RegularExpressionAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.RequiredAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.StringLengthAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.TimestampAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.UIHintAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.ValidationAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.ValidationContext?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.ValidationException?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.ValidationResult?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.Validator?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.Schema.DatabaseGeneratedAttribute?displayProperty=fullName>|  
+|<xref:System.ComponentModel.DataAnnotations.Schema.DatabaseGeneratedOption?displayProperty=fullName>|  
+  
+ **Visual Basic**  
+  
+ Visual Basic は、現在 [!INCLUDE[net_native](../../../includes/net-native-md.md)]ではサポートされていません。<xref:Microsoft.VisualBasic> 名前空間と <xref:Microsoft.VisualBasic.CompilerServices> 名前空間内の次の型は、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では使用できません。  
+  
+||  
+|-|  
+|<xref:Microsoft.VisualBasic.CallType?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.Constants?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.HideModuleNameAttribute?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.Strings?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.Conversions?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.DesignerGeneratedAttribute?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.IncompleteInitialization?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.ObjectFlowControl?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.ObjectFlowControl.ForLoopControl?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.Operators?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.OptionCompareAttribute?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.OptionTextAttribute?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.ProjectData?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.StandardModuleAttribute?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.StaticLocalInitFlag?displayProperty=fullName>|  
+|<xref:Microsoft.VisualBasic.CompilerServices.Utils?displayProperty=fullName>|  
+  
+ **リフレクション コンテキスト \(System.Reflection.Context 名前空間\)**  
+  
+ <xref:System.Reflection.Context.CustomReflectionContext?displayProperty=fullName> クラスは [!INCLUDE[net_native](../../../includes/net-native-md.md)]ではサポートされません。  
+  
+ **RTC \(System.Net.Http.Rtc\)**  
+  
+ <xref:System.Net.Http.RtcRequestFactory?displayProperty=fullName> クラスは [!INCLUDE[net_native](../../../includes/net-native-md.md)]ではサポートされません。  
+  
+ **Windows Communication Foundation \(WCF\) \(System.ServiceModel.\*\)**  
+  
+ [System.ServiceModel.\* 名前空間](http://msdn.microsoft.com/library/gg145010.aspx) 内の型は、[!INCLUDE[net_native](../../../includes/net-native-md.md)] ではサポートされません。 そうした型には、次のようなものがあります。  
+  
+||  
+|-|  
+|<xref:System.ServiceModel.ActionNotSupportedException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName>|  
+|<xref:System.ServiceModel.BasicHttpMessageCredentialType?displayProperty=fullName>|  
+|<xref:System.ServiceModel.BasicHttpSecurity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.BasicHttpSecurityMode?displayProperty=fullName>|  
+|<xref:System.ServiceModel.CallbackBehaviorAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ChannelFactory?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ClientBase%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ClientBase%601.BeginOperationDelegate?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ClientBase%601.ChannelBase%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ClientBase%601.EndOperationDelegate?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ClientBase%601.InvokeAsyncCompletedEventArgs?displayProperty=fullName>|  
+|<xref:System.ServiceModel.CommunicationException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.CommunicationObjectAbortedException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.CommunicationObjectFaultedException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.CommunicationState?displayProperty=fullName>|  
+|<xref:System.ServiceModel.DataContractFormatAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.DnsEndpointIdentity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.DuplexChannelFactory%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.DuplexClientBase%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.EndpointAddress?displayProperty=fullName>|  
+|<xref:System.ServiceModel.EndpointAddressBuilder?displayProperty=fullName>|  
+|<xref:System.ServiceModel.EndpointIdentity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.EndpointNotFoundException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.EnvelopeVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ExceptionDetail?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultCode?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultException%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultReason?displayProperty=fullName>|  
+|<xref:System.ServiceModel.FaultReasonText?displayProperty=fullName>|  
+|<xref:System.ServiceModel.HttpBindingBase?displayProperty=fullName>|  
+|<xref:System.ServiceModel.HttpClientCredentialType?displayProperty=fullName>|  
+|<xref:System.ServiceModel.HttpTransportSecurity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IClientChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ICommunicationObject?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IContextChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IDefaultCommunicationTimeouts?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IExtensibleObject%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IExtension%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.IExtensionCollection%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.InstanceContext?displayProperty=fullName>|  
+|<xref:System.ServiceModel.InvalidMessageContractException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageBodyMemberAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageContractAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageContractMemberAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageCredentialType?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageHeader%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageHeaderException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageParameterAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageSecurityOverTcp?displayProperty=fullName>|  
+|<xref:System.ServiceModel.MessageSecurityVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.NetHttpBinding?displayProperty=fullName>|  
+|<xref:System.ServiceModel.NetHttpMessageEncoding?displayProperty=fullName>|  
+|<xref:System.ServiceModel.NetTcpBinding?displayProperty=fullName>|  
+|<xref:System.ServiceModel.NetTcpSecurity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.OperationContext?displayProperty=fullName>|  
+|<xref:System.ServiceModel.OperationContextScope?displayProperty=fullName>|  
+|<xref:System.ServiceModel.OperationContractAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.OperationFormatStyle?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ProtocolException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.QuotaExceededException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.SecurityMode?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ServerTooBusyException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ServiceActivationException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ServiceContractAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.ServiceKnownTypeAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.SpnEndpointIdentity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.TcpClientCredentialType?displayProperty=fullName>|  
+|<xref:System.ServiceModel.TcpTransportSecurity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.TransferMode?displayProperty=fullName>|  
+|<xref:System.ServiceModel.UnknownMessageReceivedEventArgs?displayProperty=fullName>|  
+|<xref:System.ServiceModel.UpnEndpointIdentity?displayProperty=fullName>|  
+|<xref:System.ServiceModel.XmlSerializerFormatAttribute?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.AddressHeader?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.AddressHeaderCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.AddressingVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.ChannelManagerBase?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.ChannelParameterCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.CommunicationObject?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.CompressionFormat?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.FaultConverter?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.HttpRequestMessageProperty?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.HttpResponseMessageProperty?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.HttpsTransportBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.HttpTransportBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IChannelFactory?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IChannelFactory%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IDuplexChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IDuplexSession?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IDuplexSessionChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IHttpCookieContainerManager?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IInputChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IInputSession?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IInputSessionChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IMessageProperty?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IOutputChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IOutputSession?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IOutputSessionChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IRequestChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.IRequestSessionChannel?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.ISession?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.ISessionChannel%601?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.LocalClientSecuritySettings?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.Message?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageBuffer?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageEncoder?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageEncoderFactory?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageEncodingBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageFault?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageHeader?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageHeaderInfo?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageHeaders?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageProperties?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageState?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.MessageVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.RequestContext?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.SecurityBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.SecurityHeaderLayout?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.TcpConnectionPoolSettings?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.TcpTransportBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.TransportBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.TransportSecurityBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.WebSocketTransportSettings?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.WebSocketTransportUsage?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.ClientCredentials?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.ContractDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.FaultDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.FaultDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.IOperationBehavior?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageBodyDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageDirection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageHeaderDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessageHeaderDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessagePartDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessagePartDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessagePropertyDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.MessagePropertyDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.OperationDescription?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.OperationDescriptionCollection?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Description.ServiceEndpoint?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.ClientOperation?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.ClientRuntime?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.DispatchOperation?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.DispatchRuntime?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.EndpointDispatcher?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.IClientOperationSelector?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Dispatcher.IParameterInspector?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.BasicSecurityProfileVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.HttpDigestClientCredential?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.MessageSecurityException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.SecureConversationVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.SecurityAccessDeniedException?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.SecurityPolicyVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.SecurityVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.TrustVersion?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.UserNamePasswordClientCredential?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.WindowsClientCredential?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.Tokens.SupportingTokenParameters?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.Tokens.UserNameSecurityTokenParameters?displayProperty=fullName>|  
+  
+### シリアライザーの違い  
+ <xref:System.Runtime.Serialization.DataContractSerializer>、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>、および <xref:System.Xml.Serialization.XmlSerializer> クラスによるシリアル化と逆シリアル化に関する違いを次に示します。  
+  
+-   [!INCLUDE[net_native](../../../includes/net-native-md.md)]では、<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> は、型がルート シリアル化型ではない基底クラス メンバーを持つ派生クラスのシリアル化または逆シリアル化に失敗します。 たとえば、次のコードでは、`Y` をシリアル化または逆シリアル化しようとするとエラーになります。  
+  
+     [!code-csharp[ProjectN#10](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/compat3.cs#10)]  
+  
+     基底クラスのメンバーはシリアル化時にスキャンされないため、`InnerType` 型はシリアライザーに認識されていません。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> は、<xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装するクラスまたは構造体のシリアル化に失敗します。 たとえば、次の型ではシリアル化と逆シリアル化が失敗します。  
+  
+  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> は、シリアル化するオブジェクトの正確な型を認識していないため、次のオブジェクト値をシリアル化できません。  
+  
+  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> は、シリアル化されるオブジェクトの型が <xref:System.Xml.XmlQualifiedName> の場合、シリアル化と逆シリアル化に失敗します。  
+  
+-   すべてのシリアライザー \(<xref:System.Runtime.Serialization.DataContractSerializer>、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>、および <xref:System.Xml.Serialization.XmlSerializer>\) は、<xref:System.Xml.Linq.XElement?displayProperty=fullName> 型または <xref:System.Xml.Linq.XElement> を含む型のシリアル化コードを生成できません。 代わりに、ビルド時エラーが表示されます。  
+  
+-   次のシリアル化型のコンストラクターが、期待どおりに動作する保証はありません。  
+  
+    -   <xref:System.Runtime.Serialization.DataContractSerializer.%23ctor%28System.Type%2CSystem.Collections.Generic.IEnumerable%7BSystem.Type%7D%29?displayProperty=fullName>  
+  
+    -   <xref:System.Runtime.Serialization.DataContractSerializer.%23ctor%28System.Type%2CSystem.Runtime.Serialization.DataContractSerializerSettings%29?displayProperty=fullName>  
+  
+    -   <xref:System.Runtime.Serialization.DataContractSerializer.%23ctor%28System.Type%2CSystem.String%2CSystem.String%2CSystem.Collections.Generic.IEnumerable%7BSystem.Type%7D%29?displayProperty=fullName>  
+  
+    -   <xref:System.Runtime.Serialization.DataContractSerializer.%23ctor%28System.Type%2CSystem.Xml.XmlDictionaryString%2CSystem.Xml.XmlDictionaryString%2CSystem.Collections.Generic.IEnumerable%7BSystem.Type%7D%29?displayProperty=fullName>  
+  
+    -   <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer.%23ctor%28System.Type%2CSystem.Runtime.Serialization.Json.DataContractJsonSerializerSettings%29?displayProperty=fullName>  
+  
+    -   <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer.%23ctor%28System.Type%2CSystem.Collections.Generic.IEnumerable%7BSystem.Type%7D%29?displayProperty=fullName>  
+  
+    -   <xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.String%29?displayProperty=fullName>  
+  
+    -   [XmlSerializer.XmlSerializer\(Type, Type\<xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Type%5B%5D%29?displayProperty=fullName>  
+  
+    -   <xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Xml.Serialization.XmlAttributeOverrides%29?displayProperty=fullName>  
+  
+    -   <xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Xml.Serialization.XmlRootAttribute%29?displayProperty=fullName>  
+  
+    -   [XmlSerializer.XmlSerializer\(Type, XmlAttributeOverrides, Type\<xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Xml.Serialization.XmlAttributeOverrides%2CSystem.Type%5B%5D%2CSystem.Xml.Serialization.XmlRootAttribute%2CSystem.String%29?displayProperty=fullName>  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> は、次のいずれかの属性が設定されているメソッドを持つ型のコードを生成できません。  
+  
+    -   <xref:System.Runtime.Serialization.OnSerializingAttribute>  
+  
+    -   <xref:System.Runtime.Serialization.OnSerializedAttribute>  
+  
+    -   <xref:System.Runtime.Serialization.OnDeserializingAttribute>  
+  
+    -   <xref:System.Runtime.Serialization.OnDeserializedAttribute>  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> は、<xref:System.Xml.Serialization.IXmlSerializable> カスタム シリアル化インターフェイスを受け入れません。 このインターフェイスを実装するクラスがある場合、<xref:System.Xml.Serialization.XmlSerializer> は型を Plain Old CLR Object \(POCO\) 型であると見なし、そのパブリック プロパティのみをシリアル化します。  
+  
+-   次のようなプレーンな <xref:System.Exception> オブジェクトのシリアル化は、<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> では正しく行われません。  
+  
+  
+  
+<a name="VS"></a>   
+## Visual Studio の違い  
+ **例外とデバッグ**  
+  
+ デバッガーで [!INCLUDE[net_native](../../../includes/net-native-md.md)]を使用してコンパイルされたアプリを実行する場合、次の例外の種類について初回例外が有効になります。  
+  
+-   <xref:System.MemberAccessException>  
+  
+-   <xref:System.TypeAccessException>  
+  
+ **アプリのビルド**  
+  
+ Visual Studio で既定で使用される x86 ビルド ツールを使用します。 C:\\Program Files \(x86\)\\MSBuild\\12.0\\bin\\amd64 にある AMD64 MSBuild ツールは、ビルドの問題が発生する可能性があるため、使用しないことをお勧めします。  
+  
+ **プロファイラー**  
+  
+-   Visual Studio CPU プロファイラーと XAML メモリ プロファイラーでは、マイ コードのみは正しく表示されません。  
+  
+-   XAML メモリ プロファイラーでは、マネージド ヒープ データが正しく表示されません。  
+  
+-   CPU プロファイラーでは、モジュールが正しく識別されず、プレフィックス付きの関数名が表示されます。  
+  
+ **単体テスト ライブラリ プロジェクト**  
+  
+ Windows ストア アプリ用単体テスト ライブラリ プロジェクトで [!INCLUDE[net_native](../../../includes/net-native-md.md)]を有効にすることはサポートされていません。有効にすると、プロジェクトはビルドに失敗します。  
+  
+## 参照  
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)   
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [Windows ストア アプリ用 .NET の概要](http://msdn.microsoft.com/library/windows/apps/br230302.aspx)   
+ [Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/missinginteropdataexception-class-net-native.md b/docs/framework/net-native/missinginteropdataexception-class-net-native.md
new file mode 100644
index 00000000000..7b733b84a91
--- /dev/null
+++ b/docs/framework/net-native/missinginteropdataexception-class-net-native.md
@@ -0,0 +1,87 @@
+---
+title: "MissingInteropDataException クラス (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eab4bcf8-9f5f-4731-87d8-842748a6062a
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# MissingInteropDataException クラス (.NET ネイティブ)
+**Windows 10 の Windows アプリ用 .NET \([!INCLUDE[net_native](../../../includes/net-native-md.md)]のみ\)**  
+  
+ この例外は、手動マーシャリング メソッドが呼び出されたが、型のメタデータがスタティック分析でも、ランタイム ディレクティブ ファイルにも見つからない場合にスローされます。  
+  
+ **名前空間:** System.Runtime.CompilerServices  
+  
+> [!IMPORTANT]
+>  `MissingInteropDataException` クラスは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用のみを目的としています。  サード パーティのコードで使用することを目的としていません。また、アプリケーション コードで、例外を処理する必要はありません。  代わりに、[ランタイム ディレクティブ ファイル](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)にエントリを追加することで例外を除去します。  詳細については、「解説」を参照してください。  
+  
+## 構文  
+ [!code-csharp[ProjectN#21](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/missinginteropdataexception_syntax1.cs#21)]
+ [!code-vb[ProjectN#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/projectn/vb/missinginteropdataexception_syntax1.vb#21)]  
+  
+ `MissingInteropDataException` クラスには次のメンバーがあります。  
+  
+## コンストラクター  
+  
+|コンストラクター|説明|  
+|--------------|--------|  
+|`public MissingInteropDataException(String resourceId, Type pertinentType)`|エラーとデータが欠落している型について説明するシステム提供のメッセージの ID を使用して、`MissingInteropDataException` クラスの新しいインスタンスを初期化します。  このコンストラクターは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用専用です。|  
+  
+## プロパティ  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|`public IDictionary Data { get; }`|例外に関する追加のユーザー定義情報を提供する、キー\/値ペアのコレクションを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string HelpLink { get; set; }`|この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int HResult { get; protected set; }`|特定の例外に割り当てられた、コード化された数値である、`HRESULT` を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Exception InnerException { get; }`|現在の例外を引き起こした例外を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string Message { get; }`|現在の例外を説明するメッセージを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Type MissingType { get; private set; }`|データが欠落している型を取得または設定します。|  
+|`public string Source { get; set; }`|エラーの原因になったアプリまたはオブジェクトの名前を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string StackTrace { get; }`|呼び出し履歴で直前のフレームの文字列形式を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public MethodBase TargetSite { get; }`|現在の例外をスローしたメソッドを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## メソッド  
+  
+|メソッド|説明|  
+|----------|--------|  
+|`public bool Equals(Object obj)`|指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。  \(<xref:System.Object> から継承。\)|  
+|`protected void Finalize()`|オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。  \(<xref:System.Object> から継承。\)|  
+|`public Exception GetBaseException()`|1 つ以上の後続の例外の根本原因である例外を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int GetHashCode()`|`MissingInteropDataException` インスタンスのハッシュ コードを返します。  \(<xref:System.Object> から継承。\)|  
+|`public void GetObjectData(SerializationInfo info, StreamingContext context)`|例外に関する情報を使用して、<xref:System.Runtime.Serialization.SerializationInfo> オブジェクトを設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Type GetType()`|現在のインスタンスのランタイム型を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`protected Object MemberwiseClone()`|現在のオブジェクトの簡易コピーを作成します。  \(<xref:System.Object> から継承。\)|  
+|`public string ToString()`|現在の例外の文字列形式を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## イベント  
+  
+|Event|説明|  
+|-----------|--------|  
+|`protected event EventHandler<SafeSerializationEventArgs> SerializeObjectState`|例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## 使用方法の詳細  
+ `MissingInteropDataException` 例外は、型情報が使用できないために COM または Windows ランタイム コンポーネントへのメソッド呼び出しが正常に行えない場合にスローされます。  
+  
+ 実行時にアプリで使用できるメタデータは、ランタイム ディレクティブ \(XML 構成\) ファイルの \*.rd.xml により定義されます。  アプリからこの例外がスローされないようにするには、このファイルを変更して、実行時に存在する必要があるメタデータを定義する必要があります。  このエラーに対する最も一般的な対処法は、ランタイム ディレクティブ ファイルの適切なプログラム要素に `MarshalObject`、`MarshalDelegate`、または `MarshalStructure` 属性を追加することです。  このファイルの形式の詳細については、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  この例外はアプリケーションで必要なメタデータを実行時に使用できないことを示しているため、この例外に `try`\/`catch` ブロックで対処しないでください。  代わりに、例外の原因を診断し、その原因を解消するために、ランタイム ディレクティブ ファイルに適切なエントリを追加します。  
+  
+ `MissingInteropDataException` クラスには、正常なメソッド呼び出しのためにどの型のメタデータが必要かを示す、1 つの一意メンバーである `MissingType` プロパティが含まれています。  その他のメンバーはすべて基底クラス <xref:System.Exception?displayProperty=fullName> から継承されます。  
+  
+## 参照  
+ <xref:System.Exception?displayProperty=fullName>   
+ [MissingMetadataException クラス](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)   
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/missingmetadataexception-class-net-native.md b/docs/framework/net-native/missingmetadataexception-class-net-native.md
new file mode 100644
index 00000000000..cabb30fd9d5
--- /dev/null
+++ b/docs/framework/net-native/missingmetadataexception-class-net-native.md
@@ -0,0 +1,94 @@
+---
+title: "MissingMetadataException クラス (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 408f25c4-6d60-475c-92b1-7b52b777c6db
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# MissingMetadataException クラス (.NET ネイティブ)
+**Windows 10 の Windows アプリ用 .NET \([!INCLUDE[net_native](../../../includes/net-native-md.md)]のみ\)**  
+  
+ この例外は、存在しないメタデータを取得するためにリフレクションが使用された場合にスローされます。  
+  
+ **名前空間:** System.Reflection  
+  
+> [!IMPORTANT]
+>  `MissingMetadataException` クラスは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用のみを目的としています。  サード パーティのコードで使用することを目的としていません。また、アプリケーション コードで、例外を処理する必要はありません。  代わりに、[ランタイム ディレクティブ ファイル](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)にエントリを追加することにより、例外を除去します。  詳細については、「解説」を参照してください。  
+  
+## 構文  
+ [!code-csharp[ProjectN#4](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/missingmetadataexception_syntax1.cs#4)]  
+  
+ `MissingMetadataException` クラスが <xref:System.TypeAccessException> から派生していることに注意してください。  
+  
+ `MissingMetadataException` クラスには、次のメンバーがあります。  
+  
+## コンストラクター  
+  
+|コンストラクター|説明|  
+|--------------|--------|  
+|`public MissingMetadataException()`|エラーを説明するシステム提供のメッセージを使用して、`MissingMetadataException` クラスの新しいインスタンスを初期化します。<br /><br /> このコンストラクターは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用専用です。|  
+|`public MissingMetadataException(String message)`|指定したエラー メッセージを使用して、`MissingMetadataException` クラスの新しいインスタンスを初期化します。<br /><br /> このコンストラクターは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用専用です。|  
+  
+## プロパティ  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|`public IDictionary Data { get; }`|例外に関する追加のユーザー定義情報を提供する、キー\/値ペアのコレクションを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string HelpLink { get; set; }`|この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int HResult { get; protected set; }`|特定の例外に割り当てられた、コード化された数値である、`HRESULT` を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Exception InnerException { get; }`|現在の例外を引き起こした例外を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string Message { get; }`|現在の例外を説明するメッセージを取得します。  \(<xref:System.TypeLoadException> から継承。\)|  
+|`public string Source { get; set; }`|エラーの原因になったアプリケーションまたはオブジェクトの名前を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string StackTrace { get; }`|呼び出し履歴で直前のフレームの文字列形式を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public MethodBase TargetSite { get; }`|現在の例外をスローしたメソッドを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string TypeName { get; ]`|メタデータが欠落している型の完全修飾名を取得します。  \(<xref:System.TypeLoadException> から継承。\)|  
+  
+## メソッド  
+  
+|メソッド|説明|  
+|----------|--------|  
+|`public bool Equals(Object obj)`|指定のオブジェクトが現在のオブジェクトと等しいかどうかを判断します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`protected void Finalize()`|オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。  \(<xref:System.Object> から継承。\)|  
+|`public Exception GetBaseException()`|1 つ以上の後続の例外の根本原因である例外を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int GetHashCode()`|`MissingMetadataException` インスタンスのハッシュ コードを返します。  \(<xref:System.Object> から継承。\)|  
+|`public void GetObjectData(SerializationInfo info, StreamingContext context)`|例外に関する情報を使用して、<xref:System.Runtime.Serialization.SerializationInfo> オブジェクトを設定します。  \(<xref:System.TypeLoadException> から継承。\)|  
+|`public Type GetType()`|現在のインスタンスのランタイム型を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`protected Object MemberwiseClone()`|現在のオブジェクトの簡易コピーを作成します。  \(<xref:System.Object> から継承。\)|  
+|`public string ToString()`|現在の例外の文字列形式を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## イベント  
+  
+|Event|説明|  
+|-----------|--------|  
+|`protected event EventHandler<SafeSerializationEventArgs> SerializeObjectState`|例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## 使用方法の詳細  
+ `MissingMetadataException` 例外は、アセンブリで使用できないメタデータにアクセスするためにリフレクションが使用されるとスローされます。  
+  
+ 実行時にアプリで使用できるメタデータは、ランタイム ディレクティブ \(XML 構成\) ファイルの \*.rd.xml により定義されます。  アプリからこの例外がスローされないようにするには、\*.rd.xml を変更して、実行時に存在する必要があるメタデータを定義する必要があります。  \*.rd.xml ファイルの形式の詳細については、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  この例外はアプリケーションで必要なメタデータを実行時に使用できないことを示しているため、この例外に `try`\/`catch` ブロックで対処しないでください。  代わりに、ランタイム ディレクティブ ファイルを使用して、例外の原因を診断して排除する必要があります。  例外を除去するためにランタイム ディレクティブ ファイルに追加できるエントリを取得するには、次の 2 つのトラブルシューティング ツールのいずれかを使用できます。  
+>   
+>  -   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/type.html) \(型の場合\)。  
+> -   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/method.html) \(メソッドの場合\)。  
+  
+ `MissingMetadataException` クラスには一意のメンバーは含まれていません。メンバーはすべて基底クラスの <xref:System.TypeAccessException> から継承されます。  
+  
+## 参照  
+ <xref:System.Exception?displayProperty=fullName>   
+ <xref:System.TypeAccessException>   
+ [MissingInteropDataException クラス](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)   
+ [MissingRuntimeArtifactException クラス](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)   
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/missingruntimeartifactexception-class-net-native.md b/docs/framework/net-native/missingruntimeartifactexception-class-net-native.md
new file mode 100644
index 00000000000..3b27292abfd
--- /dev/null
+++ b/docs/framework/net-native/missingruntimeartifactexception-class-net-native.md
@@ -0,0 +1,90 @@
+---
+title: "MissingRuntimeArtifactException クラス (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d5b3d13e-689f-4584-8ba6-44f5167a8590
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# MissingRuntimeArtifactException クラス (.NET ネイティブ)
+**Windows 10 の Windows アプリ用 .NET \([!INCLUDE[net_native](../../../includes/net-native-md.md)]のみ\)**  
+  
+ この例外は、型または型のメンバーのメタデータは使用可能だが、その実装が削除されている場合にスローされます。  
+  
+ **名前空間:** System.Reflection  
+  
+> [!IMPORTANT]
+>  `MissingRuntimeArtifactException` クラスは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用のみを目的としています。  サード パーティのコードで使用することを目的としていません。また、アプリケーション コードで、例外を処理する必要はありません。  代わりに、[ランタイム ディレクティブ ファイル](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)にエントリを追加することにより、例外を除去します。  詳細については、「解説」を参照してください。  
+  
+## 構文  
+ [!code-csharp[ProjectN#22](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/missingruntimeartifactexception_syntax1.cs#22)]  
+  
+ `MissingRuntimeArtifactException` クラスが <xref:System.MemberAccessException> から派生していることに注意してください。  
+  
+ `MissingRuntimeArtifactException` クラスには、次のメンバーがあります。  
+  
+## コンストラクター  
+  
+|コンストラクター|説明|  
+|--------------|--------|  
+|`public MissingRuntimeArtifactException()`|エラーを説明するシステム提供のメッセージを使用して、`MissingRuntimeArtifactException` クラスの新しいインスタンスを初期化します。<br /><br /> このコンストラクターは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用専用です。|  
+|`public MissingRuntimeArtifactException(String message)`|指定したエラー メッセージを使用して、`MissingRuntimeArtifactException` クラスの新しいインスタンスを初期化します。<br /><br /> このコンストラクターは [!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンによる内部使用専用です。|  
+  
+## プロパティ  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|`public IDictionary Data { get; }`|例外に関する追加のユーザー定義情報を提供する、キー\/値ペアのコレクションを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string HelpLink { get; set; }`|この例外に関連付けられているヘルプ ファイルへのリンクを取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int HResult { get; protected set; }`|特定の例外に割り当てられた、コード化された数値である、`HRESULT` を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Exception InnerException { get; }`|現在の例外を引き起こした例外を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string Message { get; }`|現在の例外を説明するメッセージを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string Source { get; set; }`|エラーの原因になったアプリケーションまたはオブジェクトの名前を取得または設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public string StackTrace { get; }`|呼び出し履歴で直前のフレームの文字列形式を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public MethodBase TargetSite { get; }`|現在の例外をスローしたメソッドを取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## メソッド  
+  
+|メソッド|説明|  
+|----------|--------|  
+|`public bool Equals(Object obj)`|指定のオブジェクトが現在のオブジェクトと等しいかどうかを判断します。  \(<xref:System.Object> から継承。\)|  
+|`protected void Finalize()`|オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。  \(<xref:System.Object> から継承。\)|  
+|`public Exception GetBaseException()`|1 つ以上の後続の例外の根本原因である例外を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public int GetHashCode()`|`MissingRuntimeArtifactException` インスタンスのハッシュ コードを返します。  \(<xref:System.Object> から継承。\)|  
+|`public void GetObjectData(SerializationInfo info, StreamingContext context)`|例外に関する情報を使用して、<xref:System.Runtime.Serialization.SerializationInfo> オブジェクトを設定します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`public Type GetType()`|現在のインスタンスのランタイム型を取得します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+|`protected Object MemberwiseClone()`|現在のオブジェクトの簡易コピーを作成します。  \(<xref:System.Object> から継承。\)|  
+|`public string ToString()`|現在の例外の文字列形式を返します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## イベント  
+  
+|Event|説明|  
+|-----------|--------|  
+|`protected event EventHandler<SafeSerializationEventArgs> SerializeObjectState`|例外がシリアル化され、例外に関するシリアル化されたデータを含む例外状態オブジェクトが作成されたときに発生します。  \(<xref:System.Exception?displayProperty=fullName> から継承。\)|  
+  
+## 使用方法の詳細  
+ `MissingRuntimeArtifactException` 例外は、型のインスタンス化または型のメンバーの呼び出しが試行され、その型またはメンバーのメタデータは存在するが、実装が削除されている場合にスローされます。  
+  
+ メソッドを動的に実行するためのメタデータと実装コードが実行時にアプリで使用可能かどうかは、ランタイム ディレクティブ \(XML 構成\) ファイルの \*.rd.xml により定義されます。  アプリからこの例外がスローされないようにするには、\*.rd.xml を変更して、型または型のメンバーが必要とするメタデータが実行時に確実に存在するようにする必要があります。  \*.rd.xml ファイルの形式の詳細については、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  この例外はアプリケーションで必要な実装コードを実行時に使用できないことを示しているため、この例外を `try`\/`catch` ブロックで処理しないでください。  代わりに、ランタイム ディレクティブ ファイルを使用して、例外の原因を診断して排除する必要があります。  通常は、ランタイム ディレクティブ ファイル \(\*.rd.xml ファイル\) 内のプログラム要素に適切な `Activate` ポリシーまたは `Dynamic` ポリシーを指定することで、この例外を排除します。  例外を除去するためにランタイム ディレクティブ ファイルに追加できるエントリを取得するには、次の 2 つのトラブルシューティング ツールのいずれかを使用できます。  
+>   
+>  -   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/type.html) \(型の場合\)。  
+> -   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/method.html) \(メソッドの場合\)。  
+  
+ `MissingRuntimeArtifactException` クラスには一意のメンバーは含まれていません。メンバーはすべて基底クラスの <xref:System.MemberAccessException> から継承されます。  
+  
+## 参照  
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/namespace-element-net-native.md b/docs/framework/net-native/namespace-element-net-native.md
new file mode 100644
index 00000000000..08a71831a64
--- /dev/null
+++ b/docs/framework/net-native/namespace-element-net-native.md
@@ -0,0 +1,96 @@
+---
+title: "&lt;Namespace&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57c614e5-18a9-4e87-bfd5-d0fe3396a192
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# &lt;Namespace&gt; 要素 (.NET ネイティブ)
+指定した名前空間内のすべての型にランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Namespace Name="namespace_name"   
+           Activate="policy_type"   
+           Browse="policy_type" />  
+           Dynamic="policy_setting"  
+           Serialize="policy_setting"  
+           DataContractSerializer="policy_setting"  
+           DataContractJsonSerializer="policy_setting"  
+           XmlSerializer="policy_setting"  
+           MarshalObject="policy_setting"  
+           MarshalDelegate="policy_setting"  
+           MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 名前空間の名前を指定します。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 ネイティブ コードに構造体をマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*namespace_name*|名前空間の名前。 場合、 <> \>要素の子では、 [ <> \</> \> ](../../../docs/framework/net-native/application-element-net-native.md)、 [ <> \</> \> ](../../../docs/framework/net-native/library-element-net-native.md)、または[ <> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)要素、 *namespace_name*完全修飾名前空間名である必要があります。 場合、 <> \>要素は、別の子<>\>要素、 *namespace_name*空間の相対名である必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|名前空間内のすべての型について、このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|`<Namespace>`|親名前空間内のすべての型にランタイム リフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型にリフレクション ポリシーを適用します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/application-element-net-native.md)|実行時にリフレクションで使用可能なメタデータを持つ、アプリケーション全体の型と型のメンバーのコンテナーとして機能します。 [ <> \> ](../../../docs/framework/net-native/application-element-net-native.md)要素が&0; または&1; を持つ[ <> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)要素。|  
+|[<>\>](../../../docs/framework/net-native/assembly-element-net-native.md)|指定したアセンブリ内のすべての型にランタイム リフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/library-element-net-native.md)|実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。 [ <> \> ](../../../docs/framework/net-native/library-element-net-native.md)要素が&0; または&1; を持つ[ <> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)要素。|  
+|`<Namespace>`|親名前空間内のすべての型にリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `Activate` 属性、`Browse` 属性、`Dynamic`、および `Serialize` 属性はすべて省略可能です。 いずれも存在しない場合、`<Namespace>` 要素は子要素のコンテナーとしてのみ機能します。 存在する場合は、`<Namespace>` 要素は、指定された名前空間内のすべての型にランタイム リフレクション ポリシーを適用します。  
+  
+ 子である場合、 [ <> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)要素、`<Namespace>`要素によって定義されたランタイム リフレクション ポリシーをオーバーライド、 [ <> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)要素。  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/net-native-and-compilation.md b/docs/framework/net-native/net-native-and-compilation.md
new file mode 100644
index 00000000000..9b0b078365e
--- /dev/null
+++ b/docs/framework/net-native/net-native-and-compilation.md
@@ -0,0 +1,113 @@
+---
+title: ".NET Native とコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e38ae4f3-3e3d-42c3-a4b8-db1aa9d84f85
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# .NET Native とコンパイル
+.NET Framework を対象にした Windows 8.1 アプリケーションと Windows デスクトップ アプリケーションは特定のプログラミング言語で記述し、中間言語 \(IL: Intermediate Language\) にコンパイルされます。  実行時には、メソッドが初めて実行される直前に JIT \(Just\-In\-Time\) コンパイラによって IL がローカル コンピューターのネイティブ コードにコンパイルされます。  それとは対照的に、.NET ネイティブ ツール チェーンでは、コンパイル時にソース コードをネイティブ コードに変換します。  このトピックでは、.NET ネイティブを、.NET Framework アプリをコンパイルする他のテクノロジと比較します。また、.NET ネイティブがネイティブ コードをどのように生成するのかについて実践的な概要を説明しますので、.NET ネイティブでコンパイルしたコードで発生する例外が JIT でコンパイルしたコードでは発生しない理由を理解するために役立ちます。  
+  
+## .NET ネイティブ: ネイティブ バイナリを生成する  
+ .NET Framework を対象にしていても、.NET ネイティブ ツール チェーンを使用してコンパイルされないアプリケーションは、次のようなアプリケーション アセンブリで構成されます。  
+  
+-   アセンブリ、その依存関係、それに含まれる型、そのメンバーを記述したメタデータ。  メタデータは、リフレクションと遅延バインディング アクセスのために使用され、場合によってはコンパイラとビルド ツールによって使用されることもあります。  
+  
+-   実装コード。  これは、中間言語 \(IL\) オペコードで構成されます。  実行時には、JIT \(Just\-In\-Time\) コンパイラが IL コードを対象のプラットフォームのネイティブ コードに変換します。  
+  
+ これらの主要なアプリケーション アセンブリに加えて、アプリは次の項目の存在を必要とします。  
+  
+-   アプリに必要な他のすべてクラス ライブラリまたはサード パーティ製のアセンブリ。  これらのアセンブリには、アプリと同様に、アセンブリ、その型、およびそのメンバーを記述したメタデータが含まれるほか、すべての型のメンバーを実装する IL が含まれます。  
+  
+-   .NET Framework クラス ライブラリ。  これは、.NET Framework のインストール時にローカル システムにインストールされるアセンブリのコレクションです。  .NET Framework クラス ライブラリに含まれるアセンブリには、メタデータと実装コードの完全なセットが含まれます。  
+  
+-   共通言語ランタイム。  これは、アセンブリの読み込み、メモリ管理とガベージ コレクション、例外処理、JIT コンパイル、リモート処理、および相互運用機能などのサービスを実行するダイナミック リンク ライブラリのコレクションです。  クラス ライブラリと同様に、このランタイムは .NET Framework のインストールの一部としてローカル システムにインストールされます。  
+  
+ アプリを正常に実行するためには、共通言語ランタイム全体だけでなく、アプリケーション固有のアセンブリ、サード パーティ製のアセンブリ、およびシステム アセンブリに含まれるすべての型のメタデータと IL が存在している必要があることに注意してください。  
+  
+## .NET ネイティブと Just\-In\-Time コンパイル  
+ .NET ネイティブ ツール チェーンへの入力は、C\# または Visual Basic コンパイラでビルドされた Windows ストア アプリです。  したがって、.NET ネイティブ ツール チェーンの実行が開始されるのは、言語コンパイラが Windows ストア アプリのコンパイルを終了した時点です。  
+  
+> [!TIP]
+>  .NET ネイティブへの入力は、マネージ アセンブリ向けに記述された IL とメタデータであるため、ビルド前またはビルド後のイベントを使用するか、または MSBuild プロジェクト ファイルを変更することにより、カスタム コードの生成やその他のカスタム操作を実行する余地があります。  
+>   
+>  ただし、IL を変更する種類のツール、つまり .NET ツール チェーンがアプリの IL を解析することを妨げるツールはサポートされません。  難読化ツールは、この種類のツールとして代表的なものです。  
+  
+ アプリを IL からネイティブ コードに変換する過程で、.NET ネイティブ ツール チェーンは次のような操作を実行します。  
+  
+-   特定のコード パスについて、リフレクションやメタデータに依存するコードを、静的なネイティブ コードで置き換えます。  たとえば、値型が <xref:System.ValueType.Equals%2A?displayProperty=fullName> メソッドを上書きしない場合、等しいかどうかの既定のテストは、リフレクションを使用して値型のフィールドを表す <xref:System.Reflection.FieldInfo> オブジェクトを取得することによって行われるため、2 つのインスタンスのフィールド値の比較になります。  ネイティブ コードにコンパイルするとき、.NET ネイティブ ツール チェーンは、このリフレクションのコードとメタデータをフィールド値の静的な比較に置き換えます。  
+  
+-   可能であれば、すべてのメタデータを削除しようとします。  
+  
+-   アプリにより実際に呼び出される実装コードのみを、最終的なアプリ アセンブリに組み込みます。  これによる効果は、特にサード パーティ製ライブラリや、.NET Framework クラス ライブラリの場合に発揮されます。  この操作の結果として、アプリケーションはサード パーティ製のライブラリにも完全な .NET Framework クラス ライブラリにも依存しなくなり、サード パーティ製のライブラリおよび .NET Framework クラス ライブラリに含まれるコードがアプリに対してローカルになります。  
+  
+-   完全な CLR を、主としてガベージ コレクターを含む、リファクタリングされたランタイムに置き換えます。  リファクタリングされたランタイムは、アプリに対してローカルで、サイズがわずか数百キロバイトの mrt100\_app.dll という名前のライブラリに含まれます。  これが可能になるのは、静的リンクを使用することにより、共通言語ランタイムによって実行されるサービスの多くが不要になるためです。  
+  
+    > [!NOTE]
+    >  .NET ネイティブでは、標準の共通言語ランタイムと同じガベージ コレクターが使用されます。  .NET ネイティブのガベージ コレクターでは、既定でバックグラウンド ガベージ コレクションが既定で有効になります。  ガベージ コレクションの詳細については、「[Fundamentals of Garbage Collection](../../../docs/standard/garbage-collection/fundamentals.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  .NET ネイティブは、アプリケーション全体をネイティブ アプリケーションにコンパイルします。  ネイティブ コードに対するクラス ライブラリを含む 1 つのアセンブリをコンパイルして、マネージ コードから独立して呼び出せるようにすることはできません。  
+  
+ .NET ネイティブ ツール チェーンによって生成される結果のアプリは、プロジェクト ディレクトリの Debug または Release ディレクトリ内の ilc.out という名前のディレクトリに出力されます。  これは次のようなファイルで構成されます。  
+  
+-   *\<アプリ名\>*.exe。*\<アプリ名\>*.dll 内の特殊な `Main` エクスポートに制御を移すだけのスタブ実行可能ファイルです。  
+  
+-   *\<アプリ名\>*.dll。すべてのアプリケーション コードのほか、依存関係のある .NET Framework クラス ライブラリおよびサード パーティ製のライブラリを格納した Windows のダイナミック リンク ライブラリです。  さらに、たとえば Windows と相互運用するために必要なコードや、アプリ内のオブジェクトをシリアル化するために必要なコードなどのサポート コードも格納しています。  
+  
+-   mrt100\_app.dll。リファクタリングしたランタイムであり、ガベージ コレクションなどのランタイム サービスを提供します。  
+  
+ すべての依存関係は、アプリの APPX マニフェストによってキャプチャされます。  appx パッケージに直接バンドルされるアプリケーションの exe、dll、および mrt100\_app.dll に加えて、さらに次の 2 つのファイルが含まれます。  
+  
+-   msvcr140\_app.dll。mrt100\_app.dll によって使用される C ランタイム \(CRT\) ライブラリです。  これはパッケージ内のフレームワーク参照によって組み込まれます。  
+  
+-   mrt100.dll。  mrt100\_app.dll のパフォーマンスを向上させる関数が含まれるライブラリですが、このファイルが存在しなくても mrt100\_app.dll は機能します。  これが存在する場合は、ローカル コンピューターの system32 ディレクトリから読み込まれます。  
+  
+ .NET ネイティブ ツール チェーンはアプリが実際に呼び出すことがわかっている実装コードのみをアプリにリンクするため、次のシナリオで必要なメタデータや実装コードはアプリに組み込まれないことがあります。  
+  
+-   リフレクション。  
+  
+-   動的呼び出しまたは遅延バインディング呼び出し。  
+  
+-   シリアル化と逆シリアル化。  
+  
+-   COM 相互運用。  
+  
+ 必要なメタデータや実装コードが実行時に存在しない場合は、.NET ネイティブ ランタイムが例外をスローします。  これらの例外を回避し、必要なメタデータと実装コードが .NET ネイティブ ツール チェーンによって組み込まれたことを確認するには、[ランタイム ディレクティブ ファイル](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)という XML ファイルを使用します。このファイルでは、実行時に利用可能であることが必要なメタデータまたは実装コードを含むプログラム要素を指定し、それらのプログラム要素にランタイム ポリシーを割り当てます。  .NET ネイティブ ツール チェーンでコンパイルした Windows ストア プロジェクトに追加される既定のランタイム ディレクティブ ファイルは次のとおりです。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+    <Assembly Name="*Application*" Dynamic="Required All" />  
+  </Application>  
+</Directives>  
+  
+```  
+  
+ これにより、アプリ パッケージ内のすべてのアセンブリに含まれるすべての型と、それに含まれるすべてのメンバーのリフレクションと動的呼び出しが可能になります。  ただし、.NET Framework クラス ライブラリ アセンブリに含まれる型のリフレクションと動的なアクティブ化は可能になりません。  多くの場合、これで十分です。  
+  
+## .NET ネイティブと NGEN  
+ [ネイティブ イメージ ジェネレーター](../../../docs/framework/tools/ngen-exe-native-image-generator.md) \(NGEN\) は、アセンブリをネイティブ コードにコンパイルして、ローカル コンピューター上のネイティブ イメージ キャッシュにインストールします。  ただし、NGEN は、ネイティブ コードを生成するという点では .NET ネイティブと同じですが、いくつかの重要な点で .NET ネイティブと異なります。  
+  
+-   NGEN は、特定のメソッドのネイティブ イメージを利用できない場合に、コードの JIT 処理にフォールバックします。  このため、NGEN が JIT コンパイルにフォールバックする必要がある場合に備えて、メタデータと IL をネイティブ イメージに組み込んでおく必要があります。  これに対して、.NET ネイティブではネイティブ イメージのみが生成され、JIT コンパイルにフォールバックすることはありません。  その結果、一部のリフレクション、シリアル化、および相互運用機能のシナリオに必要なメタデータのみを保持すれは十分です。  
+  
+-   NGEN は、次に挙げるサービスについて完全な共通言語ランタイムに引き続き依存します。アセンブリの読み込み、リモート処理、相互運用性、メモリ管理、ガベージ コレクションなどと、必要な場合は JIT コンパイルです。  .NET ネイティブでは、これらのサービスの多くが不要か \(JIT コンパイル\)、ビルド時に解決されてアプリのアセンブリに組み込まれます。  これら以外のサービス \(最も重要なものはガベージ コレクション\) は、はるかに小さい、リファクタリングされた mrt100\_app.dll という名前のランタイムに含まれています。  
+  
+-   NGEN イメージは、脆弱な傾向があります。  たとえば、依存関係のあるファイルにパッチや変更が適用された場合は、通常、それを使用するアセンブリも再度 NGEN で処理する必要があります。  このことは、特に .NET Framework クラス ライブラリに含まれるシステム アセンブリの場合に当てはまります。  これに対して、.NET ネイティブでは、アプリケーションがそれぞれ個別に実行されます。  
+  
+## 参照  
+ [.NET ネイティブの内部情報 \(Channel 9 ビデオ\)](http://channel9.msdn.com/Shows/Going+Deep/Inside-NET-Native)   
+ [リフレションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)   
+ [.NET ネイティブの一般的なトラブルシューティング](../../../docs/framework/net-native/net-native-general-troubleshooting.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/net-native-general-troubleshooting.md b/docs/framework/net-native/net-native-general-troubleshooting.md
new file mode 100644
index 00000000000..7a37a5b246d
--- /dev/null
+++ b/docs/framework/net-native/net-native-general-troubleshooting.md
@@ -0,0 +1,51 @@
+---
+title: ".NET ネイティブの一般的なトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee8c5e17-35ea-48a1-8767-83298caac1e8
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# .NET ネイティブの一般的なトラブルシューティング
+このトピックでは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]でアプリを開発するときに発生する可能性のある問題のトラブルシューティング方法を説明します。  
+  
+-   **問題:** ビルド出力ウィンドウが正しく更新されない。  
+  
+     **解決方法:** ビルド出力ウィンドウは、ビルドが完了するまで更新されません。  ビルドには数分かかる場合があるため、更新が表示されるまでに遅延が発生することがあります。  
+  
+-   **問題:** ARM 用のアプリの製品ビルド時間が長くなった。  
+  
+     **解決方法:** ARM デバイスにアプリを配置する場合、[!INCLUDE[net_native](../../../includes/net-native-md.md)] インフラストラクチャが呼び出されます。  このコンパイルは、リフレクションなどの非静的セマンティクスの実行が継続された状態で、多数の最適化を実行します。  さらに、パフォーマンスの最適化のために、.NET Framework でアプリが使用する部分は静的リンクされるため、コンパイルしてネイティブ コードにも含める必要があります。  このため、コンパイルの時間が長くなります。  
+  
+     ただし、標準的な開発用コンピューター上で、ほとんどのアプリの標準的なコンパイルにかかる時間は 1 分以内です。  通常、標準的な開発用コンピューターでは、.NET Framework のネイティブ イメージを生成するだけで数分かかります。  生成されるコードを改善するための最適化をすべて行い、.NET Framework を含めても、通常、アプリのビルド時間は 1 ～ 2 分です。  
+  
+     現在も、マルチスレッド コンパイルやその他の最適化を調査して、コンパイルのパフォーマンスを改善する取り組みが続いています。  
+  
+-   **問題:** アプリが [!INCLUDE[net_native](../../../includes/net-native-md.md)]を使用してコンパイルされたかどうかわからない。  
+  
+     **解決方法:** [!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラが起動された場合、ビルド時間が長くなり、タスク マネージャーに ILC.exe や nutc\_driver.exe などのさまざまな [!INCLUDE[net_native](../../../includes/net-native-md.md)] コンポーネント プロセスが表示されます。  
+  
+     [!INCLUDE[net_native](../../../includes/net-native-md.md)]でのプロジェクトのビルドが正常に完了すると、obj\\*config*\\ *arch*\\*projectname*.ilc\\out に出力が生成されます。  最終的なネイティブ パッケージ コンテンツは、bin\\*arch*\\*config*\\AppX にあります。  アプリを配置した場合、最終的なネイティブ パッケージ コンテンツは \\bin\\*arch*\\*config*\\AppX にあります。  
+  
+-   **問題:** .NET Native を使用してアプリをコンパイルすると、.NET Native を使用せずにコンパイルしたときにはスローされないランタイム例外 \(通常は [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) または [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) 例外\) がスローされる。  
+  
+     **解決方法:** これらの例外は、リフレクションを介して使用できるはずのメタデータまたは実装コードが .NET Native では提供されなかったためにスローされます   \(詳細については、「[.NET Native とコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)」を参照してください\)。 例外を取り除くには、[ランタイム ディレクティブ \(rd.xml\) ファイル](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)にエントリを追加して、.NET Native ツール チェーンがメタデータまたは実装コードを実行時に使用できるようにする必要があります。  次の 2 つのトラブルシューティング ツールを使用して、ランタイム ディレクティブ ファイルに追加する必要があるエントリを生成できます。  
+  
+    -   [MissingMetadataException のトラブルシューティング ツール \(型の場合\)](http://dotnet.github.io/native/troubleshooter/type.html)。  
+  
+    -   [MissingMetadataException のトラブルシューティング ツール \(メソッドの場合\)](http://dotnet.github.io/native/troubleshooter/method.html)。  
+  
+     詳細については、「[リフレクションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)」を参照してください。  
+  
+## 参照  
+ [Windows ストア アプリの .NET ネイティブへの移行](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/net-native-reflection-api-reference.md b/docs/framework/net-native/net-native-reflection-api-reference.md
new file mode 100644
index 00000000000..10150089922
--- /dev/null
+++ b/docs/framework/net-native/net-native-reflection-api-reference.md
@@ -0,0 +1,58 @@
+---
+title: ".NET ネイティブ リフレクション API リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0429c049-22a3-4ba1-9cc8-f6ee91e31d9c
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# .NET ネイティブ リフレクション API リファレンス
+[!INCLUDE[net_native](../../../includes/net-native-md.md)]には次の 3 つの新しい例外型が含まれています。[System.Runtime.CompilerServices.MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)、[System.Reflection.MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)、および [System.Reflection.MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) です。 3 つの例外型すべてについて、次の点に注意してください。  
+  
+ これらの型は、内部でのみ使用してください。  
+ これら 3 つの例外型は、[!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンでのみ使用されます。[!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンがデータの欠落を検出し、プログラムの実行を続行できない場合に、これらの例外がスローされます。  
+  
+ これらの例外をコード内で処理しないでください。  
+ これらの例外は、アプリケーションで必要なメタデータが存在しないこと \([MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md) 例外と [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) 例外\)、またはアプリケーションで必要な実装コードが欠落していること \([MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) 例外\) のどちらかを示します。 これらの例外状態を修正するには、ランタイム ディレクティブ \(.rd.xml\) ファイルを変更して必要なメタデータまたは実装コードを実行時に使用できるようにします。 詳細については、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。 次の 2 つのトラブルシューティング ツールを使用して、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) および [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) 例外を取り除くための適切なエントリをランタイム ディレクティブ ファイルに提供できます。  
+  
+-   [MissingMetadataException トラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/type.html) \(型の場合\)。  
+  
+-   [MissingMetadataException トラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/method.html) \(メソッドの場合\)。  
+  
+> [!NOTE]
+>  このリファレンスでは、[!INCLUDE[net_native](../../../includes/net-native-md.md)]に固有の 3 つの例外の型について説明しています。 .NET Framework の主要なリフレクション API に関するリファレンス ドキュメントについては、「[System.Reflection 名前空間](http://msdn.microsoft.com/library/gg145033.aspx)」を参照してください。 .NET Framework の主要な相互運用 API に関するリファレンス ドキュメントについては、「<xref:System.Runtime.InteropServices>」を参照してください。  
+  
+## System.Reflection 名前空間  
+ <xref:System.Reflection> 名前空間には、.NET Framework でリフレクションに使用される主要な型が含まれています。[!INCLUDE[net_native](../../../includes/net-native-md.md)]の場合は、次の 2 つの新しい例外の種類も含まれています。  
+  
+|クラス|説明|  
+|---------|--------|  
+|[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)|この例外は、存在しないメタデータを取得するためにリフレクションが使用された場合にスローされます。|  
+|[MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)|この例外は、型または型のメンバーのメタデータは使用可能だが、その実装が削除されている場合にスローされます。|  
+  
+ この名前空間の他の型に関するドキュメントについては、.NET Framework ドキュメント セットで <xref:System.Reflection> リファレンス ページを参照してください。  
+  
+## System.Runtime.CompilerServices 名前空間  
+ <xref:System.Runtime.CompilerServices> 名前空間には、言語コンパイラによって自動的にデザインされた型が含まれています。[!INCLUDE[net_native](../../../includes/net-native-md.md)]の場合は、次の新しい例外の種類も含まれています。  
+  
+|クラス|説明|  
+|---------|--------|  
+|[MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)|この例外は、手動マーシャリング メソッドが呼び出されたが、型のメタデータがスタティック分析でも、ランタイム ディレクティブ ファイルにも見つからない場合にスローされます。|  
+  
+ この名前空間の他の型に関するドキュメントについては、.NET Framework ドキュメント セットで <xref:System.Runtime.CompilerServices> リファレンス ページを参照してください。  
+  
+## 参照  
+ [MissingInteropDataException クラス](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)   
+ [MissingMetadataException クラス](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)   
+ [MissingRuntimeArtifactException クラス](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)   
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/parameter-element-net-native.md b/docs/framework/net-native/parameter-element-net-native.md
new file mode 100644
index 00000000000..4e07e4335f3
--- /dev/null
+++ b/docs/framework/net-native/parameter-element-net-native.md
@@ -0,0 +1,87 @@
+---
+title: "&lt;Parameter&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22aaa1f3-596f-4733-93db-f4bcabcb5240
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# &lt;Parameter&gt; 要素 (.NET ネイティブ)
+メソッドに渡された引数の型にリフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Parameter Name="parameter_name"  
+           Activate="policy_type"  
+           Browse="policy_type"  
+           Dynamic="policy_type"  
+           Serialize="policy_type"  
+           DataContractSerializer="policy_type"  
+           DataContractJsonSerializer="policy_type"  
+           XmlSerializer="policy_type"  
+           MarshalObject="policy_type"  
+           MarshalDelegate="policy_type"  
+           MarshalStructure="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 パラメーターの名前。 たとえば、メソッド シグネチャ `String.CompareTo(Object value)` の場合、`Name` 属性の値は "value" です。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 WinRT と COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*パラメーター名*|ポリシーが適用されるメソッド パラメーターの名前。 たとえば、メソッド シグネチャ `String.CompareTo(Object value)` の場合、`Name` 属性の値は "value" です。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|コンストラクターまたはメソッドにランタイム リフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<Parameter>`要素の子では、 [ <> \> ](../../../docs/framework/net-native/method-element-net-native.md)要素の特定のメソッド パラメーターにポリシーを適用するために使用します。 特定のメソッド パラメーターは、型ではなく名前で指定されます。 `Activate` や `Dynamic` などのポリシーの種類を表す属性が&1; つ以上必要です。  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/method-element-net-native.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/property-element-net-native.md b/docs/framework/net-native/property-element-net-native.md
new file mode 100644
index 00000000000..6e2f5d27cf3
--- /dev/null
+++ b/docs/framework/net-native/property-element-net-native.md
@@ -0,0 +1,116 @@
+---
+title: "&lt;Property&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad4ba56d-3bcb-4c10-ba90-1cc66e2175a1
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# &lt;Property&gt; 要素 (.NET ネイティブ)
+プロパティにランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Property Name="property_name"  
+          Browse="policy_type"  
+          Dynamic="policy_type"  
+          Serialize="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 プロパティ名を指定します。|  
+|`Browse`|反射|省略可能な属性です。 プロパティに関する情報の照会やプロパティの列挙を制御しますが、実行時の動的アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 プロパティへの実行時アクセスを制御して、動的プログラミングを有効にします。 このポリシーによって、実行時にプロパティを動的に設定または取得できるようになります。|  
+|`Serialize`|シリアル化|省略可能な属性です。 プロパティへの実行時アクセスを制御して、型インスタンスを Newtonsoft の JSON シリアライザーなどのライブラリによってシリアル化できるようにしたり、データ バインディングで使用できるようにしたりします。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*メソッド名が*|プロパティ名。 プロパティの型が、親によって定義された[ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|プロパティのこのポリシーの種類に適用する設定です。 指定できる値は、`Auto`、`Excluded`、`Included`、および `Required` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ プロパティのポリシーが明示的に定義されていない場合は、親要素の実行時ポリシーを継承します。  
+  
+## <a name="example"></a>例  
+ 次の例では、リフレクションを使用して、`Book` オブジェクトをインスタンス化し、そのプロパティ値を表示します。 プロジェクトの既定の default.rd.xml ファイルは、次のように示されます。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Namespace Name="LibraryApplications"  Browse="Required Public" >  
+         <Type Name="Book"   Activate="All" />  
+      </Namespace>  
+   </Application>  
+</Directives>  
+  
+```  
+  
+ このファイルは、`All` クラスの `Activate` ポリシーに `Book` 値を適用します。これにより、リフレクションを介してクラス コンストラクターにアクセスできるようになります。 `Browse` クラスの `Book` ポリシーは、その親名前空間から継承されます。 これは `Required Public` に設定され、メタデータが実行時に使用できるようになります。  
+  
+ この例のソース コードを次に示します。 `outputBlock`変数を表す、 [TextBlock](http://msdn.microsoft.com/library/windows.ui.xaml.controls.textblock.aspx)コントロールです。  
+  
+ [!code-csharp[ProjectN_Reflection#6](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/property1.cs#6)]  
+  
+ ただし、コンパイルしてこの例を実行するスロー、 [MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)例外です。 `Book` 型のメタデータは使用可能になりましたが、プロパティの getter の実装は動的に使用可能になりませんでした。 このエラーは、次の&2; つの方法のいずれかを使用して修正できます。  
+  
+-   定義することで、`Dynamic`のポリシー、`Book`入力、 [ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)要素。  
+  
+-   入れ子になった追加することで[ <> \> ](../../../docs/framework/net-native/property-element-net-native.md)の各プロパティのように呼び出すには、次の default.rd.xml ファイル getter を持つ要素。  
+  
+    ```  
+  
+    <Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+       <Application>  
+          <Namespace Name="LibraryApplications"  Browse="Required Public" >  
+             <Type Name="Book"   Activate="All" >  
+                <Property Name="Title" Dynamic="Required" />  
+                <Property Name="Author" Dynamic="Required" />  
+                  <Property Name="ISBN" Dynamic="Required" />  
+             </Type>  
+          </Namespace>  
+       </Application>  
+    </Directives>  
+  
+    ```  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/reflection-and-net-native.md b/docs/framework/net-native/reflection-and-net-native.md
new file mode 100644
index 00000000000..6afaa12555a
--- /dev/null
+++ b/docs/framework/net-native/reflection-and-net-native.md
@@ -0,0 +1,43 @@
+---
+title: "リフレクションおよび .NET ネイティブ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 91c9eae4-c641-476c-a06e-d7ce39709763
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# リフレクションおよび .NET ネイティブ
+.NET Framework では、マネージ開発はリフレクション API を介してメタプログラミングをサポートします。  リフレクションによって、アプリ内のオブジェクトの検査、検査で検出されたオブジェクトでのメソッドの呼び出し、実行時の新しい型の生成、およびその他多数の動的コード シナリオのサポートが可能になります。  シリアル化と逆シリアル化もサポートしているため、オブジェクトのフィールド値を保持して、後で復元できます。  これらすべてのシナリオで、使用可能なメタデータに基づいてネイティブ コードを生成するために .NET Framework Just\-In\-Time \(JIT\) コンパイラが必要です。  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] ランタイムには JIT コンパイラは含まれていません。  そのため、必要なネイティブ コードすべてを事前に生成しておく必要があります。  生成するコードを決定するために一連のヒューリスティックが使用されますが、これらのヒューリスティックでは、可能性のあるすべてのメタプログラミング シナリオに対処できるわけではありません。  このため、[ランタイム ディレクティブ](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)を使用して、これらのメタプログラミング シナリオにヒントを提供する必要があります。  必要なメタデータまたは実装コードを実行時に使用できない場合、アプリは [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)、[MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md)、または [MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md) 例外をスローします。  次の 2 つのトラブルシューティング ツールを使用すると、この例外を排除するランタイム ディレクティブ ファイルの適切なエントリが生成されます。  
+  
+-   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/type.html) \(型の場合\)。  
+  
+-   [MissingMetadataException のトラブルシューティング ツール](http://dotnet.github.io/native/troubleshooter/method.html) \(メソッドの場合\)。  
+  
+> [!NOTE]
+>  ランタイム ディレクティブ ファイルが必要となる理由の背景を含む .NET ネイティブのコンパイルの概要については、「[.NET Native とコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)」をご覧ください。  
+  
+ また、[!INCLUDE[net_native](../../../includes/net-native-md.md)]では、.NET Framework クラス ライブラリのプライベート メンバーに対するリフレクションを実行できません。  たとえば、.NET Framework クラス ライブラリ型のフィールドを取得するために <xref:System.Reflection.TypeInfo.DeclaredFields%2A?displayProperty=fullName> プロパティを呼び出すと、パブリックまたはプロテクト フィールドのみが返されます。  
+  
+ 次のトピックに、アプリでリフレクションとシリアル化をサポートするために必要な概念を説明したドキュメントとリファレンス ドキュメントを示します。  
+  
+-   [リフレクションに依存する API](../../../docs/framework/net-native/apis-that-rely-on-reflection.md)  
+  
+-   [リフレクション API リファレンス](../../../docs/framework/net-native/net-native-reflection-api-reference.md)  
+  
+-   [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)  
+  
+## 参照  
+ [.NET ネイティブによるアプリのコンパイル](../../../docs/framework/net-native/index.md)   
+ [.NET Native とコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/runtime-directive-elements.md b/docs/framework/net-native/runtime-directive-elements.md
new file mode 100644
index 00000000000..ad9a49dee8c
--- /dev/null
+++ b/docs/framework/net-native/runtime-directive-elements.md
@@ -0,0 +1,77 @@
+---
+title: "ランタイム ディレクティブ要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fe5848c-ecd7-4136-970b-8e48d250bde6
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ランタイム ディレクティブ要素
+ランタイム ディレクティブ \(rd.xml\) ファイル形式は、次のランタイム ディレクティブ要素をサポートします。  階層表現について「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」を参照してください。  
+  
+ [\<Application\>](../../../docs/framework/net-native/application-element-net-native.md)  
+ アプリで使用されるすべての型にランタイム リフレクション ポリシーを適用し、実行時にリフレクションに使用できるメタデータを持つアプリケーション全体の型と型のメンバーのコンテナーとして機能します。  これは、[\<Directives\>](../../../docs/framework/net-native/directives-element-net-native.md) 要素の子です。  
+  
+ [\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md)  
+ アセンブリ内のすべての型に実行時ポリシーを適用します。  これは、[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md) 要素と [\<Library\>](../../../docs/framework/net-native/library-element-net-native.md) 要素の子です。  
+  
+ [\<AttributeImplies\>](../../../docs/framework/net-native/attributeimplies-element-net-native.md)  
+ それを含んでいる [\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) ディレクティブが属性の場合、その属性が適用されるコード要素に実行時ポリシーを適用します。  
+  
+ [\<Directives\>](../../../docs/framework/net-native/directives-element-net-native.md)  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)]のすべてのランタイム ディレクティブ ファイルのルート要素です。  その子要素は、[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md) と [\<Library\>](../../../docs/framework/net-native/library-element-net-native.md) です。  
+  
+ [\<Event\>](../../../docs/framework/net-native/event-element-net-native.md)  
+ イベントに実行時ポリシーを適用します。  これは、[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素と [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素の子です。  
+  
+ [\<Field\>](../../../docs/framework/net-native/field-element-net-native.md)  
+ フィールドに実行時ポリシーを適用します。  これは、[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素と [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素の子です。  
+  
+ [\<GenericParameter\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)  
+ ジェネリック型またはメソッドのパラメーター型に実行時ポリシーを適用します。  
+  
+ [\<ImpliesType\>](../../../docs/framework/net-native/impliestype-element-net-native.md)  
+ 型に実行時ポリシーを適用します \(それを含んでいる型またはメソッドにそのポリシーが適用されている場合\)。  
+  
+ [\<Library\>](../../../docs/framework/net-native/library-element-net-native.md)  
+ アセンブリ内のすべての型に実行時ポリシーを適用します。  これは、[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md) 要素と [\<Library\>](../../../docs/framework/net-native/library-element-net-native.md) 要素の子です。  
+  
+ [\<Method\>](../../../docs/framework/net-native/method-element-net-native.md)  
+ メソッドに実行時ポリシーを適用します。  これは、[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素と [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素の子です。  
+  
+ [\<MethodInstantiation\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)  
+ 構築されたジェネリック メソッドに実行時ポリシーを適用します。  これは、[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素と [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素の子です。  
+  
+ [\<Namespace\>](../../../docs/framework/net-native/namespace-element-net-native.md)  
+ 名前空間内のすべての型に実行時ポリシーを適用します。  
+  
+ [\<Parameter\>](../../../docs/framework/net-native/parameter-element-net-native.md)  
+ メソッドに渡された引数の型に実行時ポリシーを適用します。  
+  
+ [\<Property\>](../../../docs/framework/net-native/property-element-net-native.md)  
+ プロパティに実行時ポリシーを適用します。  これは、[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素と [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) 要素の子です。  
+  
+ [\<Subtypes\>](../../../docs/framework/net-native/subtypes-element-net-native.md)  
+ それを含む型から継承されたすべてのクラスに実行時ポリシーを適用します。  
+  
+ [\<Type\>](../../../docs/framework/net-native/type-element-net-native.md)  
+ 型に実行時ポリシーを適用します。  
+  
+ [\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)  
+ 構築されたジェネリック型に実行時ポリシーを適用します。  
+  
+ [\<TypeParameter\>](../../../docs/framework/net-native/typeparameter-element-net-native.md)  
+ メソッドに渡された <xref:System.Type> 引数によって表される型に実行時ポリシーを適用します。  
+  
+## 参照  
+ [rd.xml 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/runtime-directive-policy-settings.md b/docs/framework/net-native/runtime-directive-policy-settings.md
new file mode 100644
index 00000000000..8f85f7ffa5c
--- /dev/null
+++ b/docs/framework/net-native/runtime-directive-policy-settings.md
@@ -0,0 +1,137 @@
+---
+title: "ランタイム ディレクティブ ポリシーの設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb52b1ef-47fd-4609-b69d-0586c818ac9e
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# ランタイム ディレクティブ ポリシーの設定
+> [!NOTE]
+>  このトピックでは、プレリリース ソフトウェアである .NET Native Developer Preview について述べています。  プレビュー版は、[Microsoft Connect Web サイト](http://go.microsoft.com/fwlink/?LinkId=394611)からダウンロードできます \(登録が必要です\)。  
+  
+ .NET ネイティブのランタイム ディレクティブ ポリシー設定は、実行時に型と型のメンバーのメタデータが使用可能かどうかを決定します。  必要なメタデータがない場合、COM または Windows ランタイムへの .NET Framework 型のリフレクション、シリアル化と逆シリアル化、またはマーシャリングを利用する操作が失敗し、例外をスローする可能性があります。  最も一般的な例外は、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) と \(相互運用の場合は\) [MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md) です。  
+  
+ 実行時ポリシー設定は、ランタイム ディレクティブ \(.rd.xml\) ファイルによって制御されます。  各ランタイム ディレクティブは、アセンブリ \([\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md) 要素\)、型 \([\<Type\>](../../../docs/framework/net-native/type-element-net-native.md) 要素\)、またはメソッド \([\<Method\>](../../../docs/framework/net-native/method-element-net-native.md) 要素\) などの特定のプログラム要素のポリシーを定義します。  ディレクティブには、次のセクションで説明する、リフレクション ポリシー種類、シリアル化ポリシー種類、および相互運用ポリシー種類を定義する属性が 1 つ以上含まれています。  属性の値はポリシー設定を定義します。  
+  
+## ポリシーの種類  
+ ランタイム ディレクティブ ファイルは、ポリシーの種類について、リフレクション、シリアル化、および相互運用の 3 つのカテゴリを認識します。  
+  
+-   リフレクション ポリシー種類は、実行時にリフレクションで使用できるメタデータを決定します。  
+  
+    -   `Activate` はコンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。  
+  
+    -   `Browse` は、プログラム要素に関する情報の照会を制御します。  
+  
+    -   `Dynamic` は、すべての型とメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。  
+  
+     次の表に、リフレクション ポリシー種類と、この種類で使用できるプログラム要素を示します。  
+  
+    |要素|Activate|参照|動的|  
+    |--------|--------------|--------|--------|  
+    |[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md)|✓|✓|✓|  
+    |[\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md)|✓|✓|✓|  
+    |[\<AttributeImplies\>](../../../docs/framework/net-native/attributeimplies-element-net-native.md)|✓|✓|✓|  
+    |[\<Event\>](../../../docs/framework/net-native/event-element-net-native.md)||✓|✓|  
+    |[\<Field\>](../../../docs/framework/net-native/field-element-net-native.md)||✓|✓|  
+    |[\<GenericParameter\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)|✓|✓|✓|  
+    |[\<ImpliesType\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|✓|✓|✓|  
+    |[\<Method\>](../../../docs/framework/net-native/method-element-net-native.md)||✓|✓|  
+    |[\<MethodInstantiation\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)||✓|✓|  
+    |[\<Namespace\>](../../../docs/framework/net-native/namespace-element-net-native.md)|✓|✓|✓|  
+    |[\<Parameter\>](../../../docs/framework/net-native/parameter-element-net-native.md)|✓|✓|✓|  
+    |[\<Property\>](../../../docs/framework/net-native/property-element-net-native.md)||✓|✓|  
+    |[\<Subtypes\>](../../../docs/framework/net-native/subtypes-element-net-native.md)|✓|✓|✓|  
+    |[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md)|✓|✓|✓|  
+    |[\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|✓|✓|✓|  
+    |[\<TypeParameter\>](../../../docs/framework/net-native/typeparameter-element-net-native.md)|✓|✓|✓|  
+  
+-   シリアル化ポリシー種類は、実行時にシリアル化と逆シリアル化で使用できるメタデータを決定します。  
+  
+    -   `Serialize` は、コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのサードパーティ ライブラリによって型インスタンスをシリアル化できるようにします。  
+  
+    -   `DataContractSerializer` はコンストラクター、フィールド、およびプロパティへの実行時アクセスを制御して、型インスタンスを <xref:System.Runtime.Serialization.DataContractSerializer> クラスによりシリアル化できるようにします。  
+  
+    -   `DataContractJsonSerializer` はコンストラクター、フィールド、およびプロパティへの実行時アクセスを制御して、型インスタンスを <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> クラスによりシリアル化できるようにします。  
+  
+    -   `XmlSerializer` はコンストラクター、フィールド、およびプロパティへの実行時アクセスを制御して、型インスタンスを <xref:System.Xml.Serialization.XmlSerializer> クラスによりシリアル化できるようにします。  
+  
+     次の表に、シリアル化ポリシー種類と、この種類で使用できるプログラム要素を示します。  
+  
+    |要素|シリアル化|DataContractSerializer|DataContractJsonSerializer|XmlSerializer|  
+    |--------|-----------|----------------------------|--------------------------------|-------------------|  
+    |[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<AttributeImplies\>](../../../docs/framework/net-native/attributeimplies-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Event\>](../../../docs/framework/net-native/event-element-net-native.md)|||||  
+    |[\<Field\>](../../../docs/framework/net-native/field-element-net-native.md)|✓||||  
+    |[\<GenericParameter\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<ImpliesType\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Method\>](../../../docs/framework/net-native/method-element-net-native.md)|||||  
+    |[\<MethodInstantiation\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)|||||  
+    |[\<Namespace\>](../../../docs/framework/net-native/namespace-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Parameter\>](../../../docs/framework/net-native/parameter-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Property\>](../../../docs/framework/net-native/property-element-net-native.md)|✓||||  
+    |[\<Subtypes\>](../../../docs/framework/net-native/subtypes-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|✓|✓|✓|✓|  
+    |[\<TypeParameter\>](../../../docs/framework/net-native/typeparameter-element-net-native.md)|✓|✓|✓|✓|  
+  
+-   相互運用ポリシー種類は、COM および Windows ランタイムに参照型、値型、および関数ポインターを渡すために実行時に使用できるメタデータを決定します。  
+  
+    -   `MarshalObject` は、参照型の COM および Windows ランタイムへのネイティブ マーシャリングを制御します。  
+  
+    -   `MarshalDelegate` は、関数ポインターとしてのデリゲート型のネイティブ マーシャリングを制御します。  
+  
+    -   `MarshalStructure` は、値型の COM および Windows ランタイムへのネイティブ マーシャリングを制御します。  
+  
+     次の表に、相互運用ポリシー種類と、この種類で使用できるプログラム要素を示します。  
+  
+    |要素|MarshalObject|MarshalDelegate|MarshalStructure|  
+    |--------|-------------------|---------------------|----------------------|  
+    |[\<Application\>](../../../docs/framework/net-native/application-element-net-native.md)|✓|✓|✓|  
+    |[\<Assembly\>](../../../docs/framework/net-native/assembly-element-net-native.md)|✓|✓|✓|  
+    |[\<AttributeImplies\>](../../../docs/framework/net-native/attributeimplies-element-net-native.md)|✓|✓|✓|  
+    |[\<Event\>](../../../docs/framework/net-native/event-element-net-native.md)||||  
+    |[\<Field\>](../../../docs/framework/net-native/field-element-net-native.md)||||  
+    |[\<GenericParameter\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)|✓|✓|✓|  
+    |[\<ImpliesType\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|✓|✓|✓|  
+    |[\<Method\>](../../../docs/framework/net-native/method-element-net-native.md)||||  
+    |[\<MethodInstantiation\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)||||  
+    |[\<Namespace\>](../../../docs/framework/net-native/namespace-element-net-native.md)|✓|✓|✓|  
+    |[\<Parameter\>](../../../docs/framework/net-native/parameter-element-net-native.md)|✓|✓|✓|  
+    |[\<Property\>](../../../docs/framework/net-native/property-element-net-native.md)||||  
+    |[\<Subtypes\>](../../../docs/framework/net-native/subtypes-element-net-native.md)|✓|✓|✓|  
+    |[\<Type\>](../../../docs/framework/net-native/type-element-net-native.md)|✓|✓|✓|  
+    |[\<TypeInstantiation\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|✓|✓|✓|  
+    |[\<TypeParameter\>](../../../docs/framework/net-native/typeparameter-element-net-native.md)|✓|✓|✓|  
+  
+## ポリシーの設定  
+ 各ポリシーの種類は、次の表に示すいずれかの値に設定できます。  型のメンバーを表す要素は、他の要素とは異なる一連のポリシー設定をサポートしていることに注意してください。  
+  
+|ポリシーの設定|説明|`Assembly`、`Namespace`、`Type`、および `TypeInstantiation` 要素|`Event`、`Field`、`Method`、`MethodInstantiation`、および `Property` 要素|  
+|-------------|--------|--------------------------------------------------------------|----------------------------------------------------------------------|  
+|`All`|.NET ネイティブ ツール チェーンが削除しないすべての型とメンバーのポリシーを有効にします。|✓||  
+|`Auto`|そのプログラム要素のポリシーの種類に、既定のポリシーを使用する必要があることを指定します。  これは、そのポリシーの種類のポリシーを省略することと同じです。  `Auto` は通常、ポリシーが親要素から継承されることを示すために使用されます。|✓|✓|  
+|`Excluded`|特定のプログラム要素についてポリシーを無効にすることを指定します。  たとえば、次のランタイム ディレクティブは、<br /><br /> `<Type Name="BusinessClasses.Person" Browse="Excluded" Dynamic="Excluded" />`<br /><br /> `Person` オブジェクトの参照、および動的なインスタンス化と変更のいずれにも、`BusinessClasses.Person` クラスのメタデータを使用できないことを示しています。|✓|✓|  
+|`Included`|親型のメタデータが使用可能な場合に、ポリシーを有効にします。||✓|  
+|`Public`|ツール チェーンによってパブリック型またはパブリック メンバーが不要と判断され、削除されない限り、それらの型またはメンバーのポリシーを有効にします。  この設定は、ツール チェーンによって不要であると判断された場合でもパブリック型とパブリック メンバーのメタデータを常に使用可能にする `Required Public` とは異なります。|✓||  
+|`PublicAndInternal`|ツール チェーンでパブリックおよび内部の型またはメンバーが不要であると判断され、削除されない限り、それらの型またはメンバーのポリシーを有効にします。  この設定は、ツール チェーンによって不要と判断された場合でもパブリックおよび内部の型とメンバーのメタデータを常に使用可能にする `Required PublicAndInternal` とは異なります。|✓||  
+|`Required`|メンバーが使用されていると見なされる場合でも、メンバーのポリシーを有効にし、そのメタデータを使用できるようにすることを指定します。||✓|  
+|`Required Public`|パブリック型またはパブリック メンバーのポリシーを有効にして、パブリック型およびパブリック メンバーのメタデータが常に使用可能であるようにします。  この設定は、ツール チェーンが必要であると判断した場合にのみ、パブリック型とパブリック メンバーのメタデータを使用可能にする `Public` とは異なります。|✓||  
+|`Required PublicAndInternal`|パブリックおよび内部の型またはメンバーのポリシーを有効にして、パブリックおよび内部の型とメンバーのメタデータが常に使用可能であるようにします。  この設定は、ツール チェーンが必要であると判断した場合にのみ、パブリックおよび内部の型とメンバーのメタデータを使用可能にする `PublicAndInternal` とは異なります。|✓||  
+|`Required All`|使用されているかどうかに関係なく、すべての型とメンバーを保持し、そのポリシーを有効にするために、ツール チェーンを要求します。|✓||  
+  
+## 参照  
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md b/docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md
new file mode 100644
index 00000000000..acfc14b13b6
--- /dev/null
+++ b/docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md
@@ -0,0 +1,483 @@
+---
+title: "ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8241523f-d8e1-4fb6-bf6a-b29bfe07b38a
+caps.latest.revision: 27
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス
+ランタイム ディレクティブ \(.rd.xml\) ファイルは、指定されたプログラム要素をリフレクションに使用できるかどうかを示す XML 構成ファイルです。  ランタイム ディレクティブ ファイルの例を次に示します。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+<Application>  
+  <Namespace Name="Contoso.Cloud.AppServices" Serialize="Required Public" />  
+  <Namespace Name="ContosoClient.ViewModels" Serialize="Required Public" />  
+  <Namespace Name="ContosoClient.DataModel" Serialize="Required Public" />  
+  <Namespace Name="Contoso.Reader.UtilityLib" Serialize="Required Public" />  
+  
+  <Namespace Name="System.Collections.ObjectModel" >  
+    <TypeInstantiation Name="ObservableCollection"   
+          Arguments="ContosoClient.DataModel.ProductItem" Serialize="Public" />  
+    <TypeInstantiation Name="ReadOnlyObservableCollection"   
+          Arguments="ContosoClient.DataModel.ProductGroup" Serialize="Public" />  
+  </Namespace>  
+</Application>  
+</Directives>  
+  
+```  
+  
+## ランタイム ディレクティブ ファイルの構造  
+ ランタイム ディレクティブ ファイルは `http://schemas.microsoft.com/netfx/2013/01/metadata` 名前空間を使用します。  
+  
+ ルート要素は [Directives](../../../docs/framework/net-native/directives-element-net-native.md) 要素です。  これには、次の構造に示すように、0 個以上の [Library](../../../docs/framework/net-native/library-element-net-native.md) 要素と 0 または 1 個の [Application](../../../docs/framework/net-native/application-element-net-native.md) 要素を含めることができます。  [Application](http://msdn.microsoft.com/ja-jp/2a038172-1ad5-47b7-a8db-79b2f1212f0a) 要素の属性は、アプリケーション全体のランタイム リフレクション ポリシーを定義できるか、子要素のコンテナーとして機能できます。  一方、[Library](../../../docs/framework/net-native/library-element-net-native.md) 要素は単にコンテナーです。  [Application](../../../docs/framework/net-native/application-element-net-native.md) 要素と [Library](../../../docs/framework/net-native/library-element-net-native.md) 要素の子は、リフレクションで使用できる型、メソッド、フィールド、プロパティ、およびイベントを定義します。  
+  
+ 参照情報については、次の構造から要素を選択するか、「[ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)」を参照してください。  次の階層で、省略記号は再帰構造を示します。  角かっこ内の情報は、その要素が省略可能または必須のいずれであるか、および使用される場合に許可されるインスタンスの数 \(1 つまたは複数\) を示します。  
+  
+ [Directives](../../../docs/framework/net-native/directives-element-net-native.md) \[1:1\]                        
+ [Application](../../../docs/framework/net-native/application-element-net-native.md) \[0:1\]  
+ [Assembly](../../../docs/framework/net-native/assembly-element-net-native.md) \[0:M\]  
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]   
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+ [Subtypes](../../../docs/framework/net-native/subtypes-element-net-native.md) \(それを含む型のサブクラス\) \[O:1\]   
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [AttributeImplies](../../../docs/framework/net-native/attributeimplies-element-net-native.md) \(それを含む型が属性\) \[O:1\]   
+ [GenericParameter](../../../docs/framework/net-native/genericparameter-element-net-native.md) \[0:M\]  
+ [Method](../../../docs/framework/net-native/method-element-net-native.md) \[0:M\]  
+ [Parameter](../../../docs/framework/net-native/parameter-element-net-native.md) \[0:M\]   
+ [TypeParameter](../../../docs/framework/net-native/typeparameter-element-net-native.md) \[0:M\]  
+ [GenericParameter](../../../docs/framework/net-native/genericparameter-element-net-native.md) \[0:M\]  
+ [MethodInstantiation](../../../docs/framework/net-native/methodinstantiation-element-net-native.md) \(構築されたジェネリック メソッド\) \[0:M\]   
+ [Property](../../../docs/framework/net-native/property-element-net-native.md) \[0:M\]  
+ [Field](../../../docs/framework/net-native/field-element-net-native.md) \[0:M\]  
+ [Event](../../../docs/framework/net-native/event-element-net-native.md) \[0:M\]  
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Method](../../../docs/framework/net-native/method-element-net-native.md) \[0:M\]  
+ [Parameter](../../../docs/framework/net-native/parameter-element-net-native.md) \[0:M\]   
+ [TypeParameter](../../../docs/framework/net-native/typeparameter-element-net-native.md) \[0:M\]  
+ [GenericParameter](../../../docs/framework/net-native/genericparameter-element-net-native.md) \[0:M\]  
+ [MethodInstantiation](../../../docs/framework/net-native/methodinstantiation-element-net-native.md) \(構築されたジェネリック メソッド\) \[0:M\]  
+ [Property](../../../docs/framework/net-native/property-element-net-native.md) \[0:M\]  
+ [Field](../../../docs/framework/net-native/field-element-net-native.md) \[0:M\]  
+ [Event](../../../docs/framework/net-native/event-element-net-native.md) \[0:M\]  
+ [Library](../../../docs/framework/net-native/library-element-net-native.md) \[0:M\]  
+ [Assembly](../../../docs/framework/net-native/assembly-element-net-native.md) \[0:M\]  
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+ [Namespace](../../../docs/framework/net-native/namespace-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]   
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+ [Subtypes](../../../docs/framework/net-native/subtypes-element-net-native.md) \(それを含む型のサブクラス\) \[O:1\]   
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [AttributeImplies](../../../docs/framework/net-native/attributeimplies-element-net-native.md) \(それを含む型が属性\) \[O:1\]   
+ [GenericParameter](../../../docs/framework/net-native/genericparameter-element-net-native.md) \[0:M\]  
+ [Method](../../../docs/framework/net-native/method-element-net-native.md) \[0:M\]  
+ [MethodInstantiation](../../../docs/framework/net-native/methodinstantiation-element-net-native.md) \(構築されたジェネリック メソッド\) \[0:M\]   
+ [Property](../../../docs/framework/net-native/property-element-net-native.md) \[0:M\]  
+ [Field](../../../docs/framework/net-native/field-element-net-native.md) \[0:M\]  
+ [Event](../../../docs/framework/net-native/event-element-net-native.md) \[0:M\]  
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+ [Type](../../../docs/framework/net-native/type-element-net-native.md) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [TypeInstantiation](../../../docs/framework/net-native/typeinstantiation-element-net-native.md) \(構築されたジェネリック型\) \[0:M\]  
+からドラッグします。  からドラッグします。  からドラッグします。    
+ [Method](../../../docs/framework/net-native/method-element-net-native.md) \[0:M\]  
+ [MethodInstantiation](../../../docs/framework/net-native/methodinstantiation-element-net-native.md) \(構築されたジェネリック メソッド\) \[0:M\]  
+ [Property](../../../docs/framework/net-native/property-element-net-native.md) \[0:M\]  
+ [Field](../../../docs/framework/net-native/field-element-net-native.md) \[0:M\]  
+ [Event](../../../docs/framework/net-native/event-element-net-native.md) \[0:M\]  
+  
+ [Application](../../../docs/framework/net-native/application-element-net-native.md) 要素は属性を持たないか、「[ランタイム ディレクティブとポリシー](#Directives)」セクションで説明しているポリシー属性を持つことができます。  
+  
+ [Library](../../../docs/framework/net-native/library-element-net-native.md) 要素は、ライブラリまたはアセンブリの名前をファイル拡張子なしで指定する、`Name` 属性 1 つを持ちます。  たとえば、次の [Library](../../../docs/framework/net-native/library-element-net-native.md) 要素は、Extensions.dll という名前のアセンブリに適用されます。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+     <!-- Child elements go here -->    
+  </Application>  
+  <Library Name="Extensions">  
+     <!-- Child elements go here -->    
+  </Library>  
+</Directives>  
+  
+```  
+  
+<a name="Directives"></a>   
+## ランタイム ディレクティブとポリシー  
+ [Application](../../../docs/framework/net-native/application-element-net-native.md) 要素自体と [Library](../../../docs/framework/net-native/library-element-net-native.md) 要素と [Application](../../../docs/framework/net-native/application-element-net-native.md) 要素の子要素はポリシーを表します。つまり、アプリがプログラム要素にリフレクションを適用できる方法を定義します。  ポリシーの種類は要素の属性 \(たとえば、`Serialize`\) により定義されます。  ポリシーの値は属性の値 \(たとえば、`Serialize="Required"`\) により定義されます。  
+  
+ 要素の属性により指定されるすべてのポリシーは、そのポリシーの値を指定しないすべての子要素に適用されます。  たとえば、[Type](../../../docs/framework/net-native/type-element-net-native.md) 要素で指定されたポリシーは、ポリシーが明示的に指定されていない、その要素に含まれる型とメンバーすべてに適用されます。  
+  
+ [Application](../../../docs/framework/net-native/application-element-net-native.md)、[Assembly](../../../docs/framework/net-native/assembly-element-net-native.md)、[AttributeImplies](../../../docs/framework/net-native/attributeimplies-element-net-native.md)、[Namespace](../../../docs/framework/net-native/namespace-element-net-native.md)、[Subtypes](../../../docs/framework/net-native/subtypes-element-net-native.md)、および [Type](../../../docs/framework/net-native/type-element-net-native.md) 要素により表すことができるポリシーは、個々のメンバーについて \([Method](../../../docs/framework/net-native/method-element-net-native.md)、[Property](../../../docs/framework/net-native/property-element-net-native.md)、[Field](../../../docs/framework/net-native/field-element-net-native.md)、および [Event](../../../docs/framework/net-native/event-element-net-native.md) 要素によって\) 表すことができるポリシーとは異なります。  
+  
+### アセンブリ、名前空間、型に対するポリシーの指定  
+ [Application](../../../docs/framework/net-native/application-element-net-native.md)、[Assembly](../../../docs/framework/net-native/assembly-element-net-native.md)、[AttributeImplies](../../../docs/framework/net-native/attributeimplies-element-net-native.md)、[Namespace](../../../docs/framework/net-native/namespace-element-net-native.md)、[Subtypes](../../../docs/framework/net-native/subtypes-element-net-native.md)、および [Type](../../../docs/framework/net-native/type-element-net-native.md) 要素は、次のポリシーの種類をサポートします。  
+  
+-   `Activate`。  コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。  
+  
+-   `Browse`。  プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。  
+  
+-   `Dynamic`。  コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。  
+  
+-   `Serialize`。  コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのサードパーティ ライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。  
+  
+-   `DataContractSerializer`。  <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName> クラスを使用するシリアル化のポリシーを制御します。  
+  
+-   `DataContractJsonSerializer`。  <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName> クラスを使用する JSON シリアル化のポリシーを制御します。  
+  
+-   `XmlSerializer`。  <xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName> クラスを使用する XML シリアル化のポリシーを制御します。  
+  
+-   `MarshalObject`。  WinRT と COM に参照型をマーシャリングするためのポリシーを制御します。  
+  
+-   `MarshalDelegate`。  ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。  
+  
+-   `MarshalStructure` .  ネイティブ コードに構造体をマーシャリングするためのポリシーを制御します。  
+  
+ これらのポリシーの種類に関連付けられている設定を次に示します。  
+  
+-   `All`。  ツール チェーンが削除しないすべての型とメンバーに対するポリシーを有効にします。  
+  
+-   `Auto`。  既定の動作を使用します。  \(親要素などによってポリシーがオーバーライドされない限り、ポリシーを指定しないことは、そのポリシーを `Auto` に設定することと同じです。\)  
+  
+-   `Excluded`。  プログラム要素のポリシーを無効にします。  
+  
+-   `Public`。  ツール チェーンがメンバーが不要なために削除すると判断した場合を除き、パブリック型またはメンバーのポリシーを有効にします。  \(後者の場合は、`Required Public` を使用して、メンバーが保持されており、リフレクション機能があることを確認する必要があります。\)  
+  
+-   `PublicAndInternal`。  パブリックおよび内部型またはメンバーがツール チェーンによって削除されていない場合、それらのポリシーを有効にします。  
+  
+-   `Required Public`。  使用されているかどうかに関係なく、パブリック型とメンバーを保持し、それらのポリシーを有効にするためにツール チェーンを要求します。  
+  
+-   `Required PublicAndInternal`。  使用されているかどうかに関係なく、パブリックおよび内部両方の型とメンバーを保持し、それらのポリシーを有効にするためにツール チェーンを要求します。  
+  
+-   `Required All`。  使用されているかどうかに関係なく、すべての型とメンバーを保持し、それらのポリシーを有効にするために、ツール チェーンを要求します。  
+  
+ たとえば、次のランタイム ディレクティブ ファイルは、DataClasses.dll アセンブリ内のすべての型とメンバーのポリシーを定義します。  これは、すべてのパブリック プロパティのシリアル化のリフレクションを有効にし、すべての型と型のメンバーの参照を有効にし、すべての型のアクティブ化を \(`Dynamic` 属性により\) 有効にして、すべてのパブリック型とメンバーのリフレクションを有効にします。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="DataClasses" Serialize="Required Public"   
+                Browse="All" Activate="PublicAndInternal"   
+                Dynamic="Public"  />  
+   </Application>  
+   <Library Name="UtilityLibrary">  
+     <!-- Child elements go here -->    
+   </Library>  
+</Directives>  
+  
+```  
+  
+### メンバーのポリシーの指定  
+ [Property](../../../docs/framework/net-native/property-element-net-native.md) 要素と [Field](../../../docs/framework/net-native/field-element-net-native.md) 要素は次のポリシーの種類をサポートしています。  
+  
+-   `Browse`: このメンバーに関する情報の照会を制御しますが、実行時アクセスは有効にしません。  
+  
+-   `Dynamic`: コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。  また、それを含む型に関する情報の照会も制御します。  
+  
+-   `Serialize`: メンバーへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。  このポリシーは、コンストラクター、フィールド、およびプロパティに適用できます。  
+  
+ [Method](../../../docs/framework/net-native/method-element-net-native.md) 要素と [Event](../../../docs/framework/net-native/event-element-net-native.md) 要素は次のポリシーの種類をサポートしています。  
+  
+-   `Browse`: このメンバーに関する情報の照会を制御しますが、実行時アクセスは有効にしません。  
+  
+-   `Dynamic`: コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。  また、それを含む型に関する情報の照会も制御します。  
+  
+ これらのポリシーの種類に関連付けられている設定を次に示します。  
+  
+-   `Auto`: 既定の動作を使用します。  \(何かにオーバーライドされない限り、ポリシーを指定しないことは、そのポリシーを `Auto` に設定することと同じです。\)  
+  
+-   `Excluded`: メンバーのメタデータを含めません。  
+  
+-   `Included`: 親型が出力に存在する場合、ポリシーを有効にします。  
+  
+-   `Required`: このメンバーが未使用と見なされる場合でもこれを保持し、そのメンバーのポリシーを有効にするためにツール チェーンを要求します。  
+  
+## ランタイム ディレクティブ ファイルのセマンティクス  
+ ポリシーは、上位レベルと下位レベルの要素両方に同時に定義できます。  たとえば、アセンブリと、そのアセンブリに含まれる型の一部にポリシーを定義できます。  特定の下位レベル要素が表されていない場合、その親のポリシーを継承します。  たとえば、`Assembly` 要素は存在するが `Type` 要素は存在しない場合、`Assembly` 要素で指定されるポリシーはアセンブリ内のすべての型に適用されます。  複数の要素が同じプログラム要素にポリシーを適用することもできます。  たとえば、個別の [Assembly](../../../docs/framework/net-native/assembly-element-net-native.md) 要素が、同じアセンブリの同じポリシー要素を別々に定義するとします。  次のセクションで、このような場合に特定の型のポリシーがどのように解決されるかを説明します。  
+  
+ ジェネリック型またはメソッドの [Type](../../../docs/framework/net-native/type-element-net-native.md) 要素または [Method](../../../docs/framework/net-native/method-element-net-native.md) 要素は、独自のポリシーを持たないすべてのインスタンス化にそのポリシーを適用します。  たとえば、`Type` のポリシーを指定する <xref:System.Collections.Generic.List%601> 要素は、構築された特定のジェネリック型 \(`List<Int32>` など\) について `TypeInstantiation` 要素によってオーバーライドされない限り、そのジェネリック型のすべての構築されたインスタンスに適用されます。  そうでない場合、要素は指定されたプログラム要素のポリシーを定義します。  
+  
+ 要素があいまいな場合、エンジンが一致を検索し、完全一致が見つかるとそれを使用します。  複数の一致が見つかった場合は警告またはエラーになります。  
+  
+### 2 つのディレクティブが同じプログラム要素にポリシーを適用する場合  
+ 別のランタイム ディレクティブ ファイルにある 2 つの要素が同じプログラム要素 \(アセンブリや型など\) の同じポリシーの種類を異なる値に設定しようとした場合、次のように競合が解決されます。  
+  
+1.  `Excluded` 要素が存在する場合はこれが優先されます。  
+  
+2.  `Required` は `Required` 以外より優先されます。  
+  
+3.  `All` は `PublicAndInternal` \(`Public` より優先\) より優先されされます。  
+  
+4.  明示的な設定はいずれも `Auto` より優先されます。  
+  
+ たとえば、1 つのプロジェクトに次の 2 つのランタイム ディレクティブ ファイルが含まれている場合、DataClasses.dll のシリアル化ポリシーは `Required Public` と `All` の両方に設定されます。  この場合、シリアル化ポリシーは `Required All` として解決されます。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="DataClasses" Serialize="Required Public"/>  
+   </Application>  
+   <Library Name="DataClasses">  
+      <!-- any other elements -->  
+   </Library>  
+</Directives>  
+  
+```  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="DataClasses" Serialize="All" />  
+   </Application>  
+   <Library Name="DataClasses">  
+      <!-- any other elements -->  
+   </Library>  
+</Directives>  
+  
+```  
+  
+ ただし、1 つのランタイム ディレクティブ ファイル内の 2 つのディレクティブが同じプログラム要素に同じポリシーの種類を設定しようとした場合、XML スキーマ定義ツールからエラー メッセージが表示されます。  
+  
+### 子要素と親要素が同じポリシーの種類を適用する場合  
+ `Excluded` 設定を含め、子要素はその親要素をオーバーライドします。  オーバーライドは、`Auto` を指定する必要がある主な理由です。  
+  
+ 次の例では、`DataClasses` にはあるが `DataClasses.ViewModels` にはないものすべてのシリアル化ポリシー設定が `Required Public` になり、`DataClasses` と `DataClasses.ViewModels` の両方にあるものすべてのシリアル化ポリシー設定は `All` になります。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="DataClasses" Serialize="Required Public" >  
+         <Namespace Name="DataClasses.ViewModels" Seralize="All" />  
+      </Assembly>  
+   </Appliction>  
+   <Library Name="DataClasses">  
+      <!-- any other elements -->  
+   </Library>  
+</Directives>  
+  
+```  
+  
+### オープン ジェネリックとインスタンス化された要素が同じポリシーの種類を適用する場合  
+ 次の例では、`Dictionary<int,int>` には、特に `Browse` ポリシーを割り当てる理由がエンジンにある場合にのみ、`Browse` ポリシーが割り当てられます \(通常は、これが既定の動作です\)。それ以外の <xref:System.Collections.Generic.Dictionary%602> のすべてのインスタンス化では、そのメンバーのすべてが参照可能になります。  
+  
+```  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="DataClasses" Serialize="Required Public" >  
+         <Namespace Name="DataClasses.ViewModels" Seralize="All" />  
+      </Assembly>  
+      <Namespace Name="DataClasses.Generics" />  
+      <Type Name="Dictionary" Browse="All" />  
+      <TypeInstantiation Name="Dictionary"   
+                         Arguments="System.Int32,System.Int32" Browse="Auto" />  
+   </Application>  
+   <Library Name="DataClasses">  
+      <!-- any other elements -->  
+   </Library>  
+</Directives>  
+  
+```  
+  
+### ポリシーの推論方法  
+ ポリシーの種類ごとに、そのポリシーの種類の存在が他の構造体にどう影響するかを決定する一連のルールが異なります。  
+  
+#### Browse ポリシーの効果  
+ `Browse` ポリシーを型に適用すると、ポリシーが次のように変更されます。  
+  
+-   型の基本型が `Browse` ポリシーでマークされます。  
+  
+-   型がインスタンス化されたジェネリックである場合、インスタンス化されていないその型が `Browse` ポリシーでマークされます。  
+  
+-   型がデリゲートの場合、型の `Invoke` メソッドが `Dynamic` ポリシーでマークされます。  
+  
+-   型の各インターフェイスが `Browse` ポリシーでマークされます。  
+  
+-   型に適用されている各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   型がジェネリックの場合、各制約型が `Browse` ポリシーでマークされます。  
+  
+-   型がジェネリックの場合、その型のインスタンス化対象である型が `Browse` ポリシーでマークされます。  
+  
+ メソッドに `Browse` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   メソッドの各パラメーター型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドの戻り型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドを含む型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドがインスタンス化されたジェネリック メソッドである場合、インスタンス化されていないジェネリック メソッドが `Browse` ポリシーでマークされます。  
+  
+-   メソッドに適用される各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドがジェネリックの場合、各制約型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドがジェネリックの場合、そのメソッドのインスタンス化対象である型が `Browse` ポリシーでマークされます。  
+  
+ フィールドに `Browse` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   フィールドに適用される各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   フィールドの型が `Browse` ポリシーでマークされます。  
+  
+-   フィールドが属する型が `Browse` ポリシーでマークされます。  
+  
+#### Dynamic ポリシーの効果  
+ `Dynamic` ポリシーを型に適用すると、ポリシーが次のように変更されます。  
+  
+-   型の基本型が `Dynamic` ポリシーでマークされます。  
+  
+-   型がインスタンス化されたジェネリックである場合、インスタンス化されていないその型が `Dynamic` ポリシーでマークされます。  
+  
+-   型がデリゲート型の場合、型の `Invoke` メソッドが `Dynamic` ポリシーでマークされます。  
+  
+-   型の各インターフェイスが `Browse` ポリシーでマークされます。  
+  
+-   型に適用されている各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   型がジェネリックの場合、各制約型が `Browse` ポリシーでマークされます。  
+  
+-   型がジェネリックの場合、その型のインスタンス化対象である型が `Browse` ポリシーでマークされます。  
+  
+ メソッドに `Dynamic` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   メソッドの各パラメーター型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドの戻り型が `Dynamic` ポリシーでマークされます。  
+  
+-   メソッドを含む型が `Dynamic` ポリシーでマークされます。  
+  
+-   メソッドがインスタンス化されたジェネリック メソッドである場合、インスタンス化されていないジェネリック メソッドが `Browse` ポリシーでマークされます。  
+  
+-   メソッドに適用される各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドがジェネリックの場合、各制約型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドがジェネリックの場合、そのメソッドのインスタンス化対象である型が `Browse` ポリシーでマークされます。  
+  
+-   メソッドを `MethodInfo.Invoke` により呼び出すことができ、<xref:System.Reflection.MethodInfo.CreateDelegate%2A?displayProperty=fullName> によりデリゲートの作成が可能になります。  
+  
+ フィールドに `Dynamic` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   フィールドに適用される各属性の型が `Browse` ポリシーでマークされます。  
+  
+-   フィールドの型が `Dynamic` ポリシーでマークされます。  
+  
+-   フィールドが属する型が `Dynamic` ポリシーでマークされます。  
+  
+#### Activation ポリシーの効果  
+ 型に Activation ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   型がインスタンス化されたジェネリックである場合、インスタンス化されていないその型が `Browse` ポリシーでマークされます。  
+  
+-   型がデリゲート型の場合、型の `Invoke` メソッドが `Dynamic` ポリシーでマークされます。  
+  
+-   型のコンストラクターが `Activation` ポリシーでマークされます。  
+  
+ メソッドに `Activation` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   コンストラクターを <xref:System.Reflection.ConstructorInfo.Invoke%2A?displayProperty=fullName> メソッドと <xref:System.Activator.CreateInstance%2A?displayProperty=fullName> メソッドにより呼び出すことができます。  メソッドに関しては、`Activation` ポリシーはコンストラクターにのみ影響します。  
+  
+ フィールドに `Activation` ポリシーを適用しても効果はありません。  
+  
+#### Serialize ポリシーの効果  
+ `Serialize` ポリシーにより、一般的なリフレクション ベースのシリアライザーを使用できるようになります。  ただし、Microsoft では、Microsoft 以外のシリアライザーの正確なリフレクション アクセス パターンを認識していないため、このポリシーが常に効果的であるとは限りません。  
+  
+ `Serialize` ポリシーを型に適用すると、ポリシーが次のように変更されます。  
+  
+-   型の基本型が `Serialize` ポリシーでマークされます。  
+  
+-   型がインスタンス化されたジェネリックである場合、インスタンス化されていないその型が `Browse` ポリシーでマークされます。  
+  
+-   型がデリゲート型の場合、型の `Invoke` メソッドが `Dynamic` ポリシーでマークされます。  
+  
+-   型が列挙の場合、型の配列が `Serialize` ポリシーでマークされます。  
+  
+-   型が <xref:System.Collections.Generic.IEnumerable%601> を実装する場合、`T` が `Serialize` ポリシーでマークされます。  
+  
+-   型が <xref:System.Collections.Generic.IEnumerable%601>、<xref:System.Collections.Generic.IList%601>、<xref:System.Collections.Generic.ICollection%601>、<xref:System.Collections.Generic.IReadOnlyCollection%601>、または <xref:System.Collections.Generic.IReadOnlyList%601> の場合、`T[]` と <xref:System.Collections.Generic.List%601> が `Serialize` ポリシーでマークされますが、インターフェイス型のメンバーは `Serialize` ポリシーでマークされません。  
+  
+-   型が <xref:System.Collections.Generic.List%601> の場合、型のどのメンバーも `Serialize` ポリシーでマークされません。  
+  
+-   型が <xref:System.Collections.Generic.IDictionary%602> の場合、<xref:System.Collections.Generic.Dictionary%602> が `Serialize` ポリシーでマークされます。  ただし、型のどのメンバーも `Serialize` ポリシーでマークされません。  
+  
+-   型が <xref:System.Collections.Generic.Dictionary%602> の場合、型のどのメンバーも `Serialize` ポリシーでマークされません。  
+  
+-   型が <xref:System.Collections.Generic.IDictionary%602> を実装している場合、`TKey` と `TValue` が `Serialize` ポリシーでマークされます。  
+  
+-   各コンストラクター、各プロパティ アクセサー、および各フィールドが `Serialize` ポリシーでマークされます。  
+  
+ メソッドに `Serialize` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   それを含む型が `Serialize` ポリシーでマークされます。  
+  
+-   メソッドの戻り型が `Serialize` ポリシーでマークされます。  
+  
+ フィールドに `Serialize` ポリシーを適用すると、ポリシーが次のように変更されます。  
+  
+-   それを含む型が `Serialize` ポリシーでマークされます。  
+  
+-   フィールドの型が `Serialize` ポリシーでマークされます。  
+  
+#### XmlSerializer、DataContractSerializer、および DataContractJsonSerialier ポリシーの効果  
+ リフレクション ベースのシリアライザーを対象とした `Serialize` ポリシーとは異なり、`XmlSerializer`、`DataContractSerializer`、および `DataContractJsonSerializer` ポリシーは、[!INCLUDE[net_native](../../../includes/net-native-md.md)] ツール チェーンで認識されている一連のシリアライザーを有効にするために使用されます。  これらのシリアライザーはリフレクションを使用して実装されるのではなく、実行時にシリアル化可能な型のセットが、リフレクション可能な型と同様の方法で決定されます。  
+  
+ これらのポリシーのいずれかを型に適用すると、対応するシリアライザーで型をシリアル化できるようになります。  また、シリアル化が必要であることをシリアル化エンジンが静的に決定できる、すべての型もシリアル化されます。  
+  
+ これらのポリシーは、メソッドとフィールドには影響しません。  
+  
+ 詳細については、「[Windows ストア アプリの .NET ネイティブへの移行](../../../docs/framework/net-native/migrating-your-windows-store-app-to-net-native.md)」の「シリアライザーの違い」セクションを参照してください。  
+  
+## 参照  
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [リフレクションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/runtime-exceptions-in-net-native-apps.md b/docs/framework/net-native/runtime-exceptions-in-net-native-apps.md
new file mode 100644
index 00000000000..1f98654e6a2
--- /dev/null
+++ b/docs/framework/net-native/runtime-exceptions-in-net-native-apps.md
@@ -0,0 +1,67 @@
+---
+title: ".NET ネイティブ アプリでのランタイム例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f050181-8fdd-4a4e-9d16-f84c22a88a97
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# .NET ネイティブ アプリでのランタイム例外
+デバッグ構成とリリース構成は完全に異なるため、ターゲット プラットフォームでユニバーサル Windows プラットフォーム アプリのリリース ビルドをテストすることは重要です。 既定では、デバッグ構成は .NET Core ランタイムを使用してアプリをコンパイルしますが、リリース構成は .NET ネイティブを使用してアプリをネイティブ コードにコンパイルします。  
+  
+> [!IMPORTANT]
+>  アプリのリリース バージョンをテストするときに発生する可能性のある [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)、[MissingInteropDataException](../../../docs/framework/net-native/missinginteropdataexception-class-net-native.md)、[MissingRuntimeArtifactException](../../../docs/framework/net-native/missingruntimeartifactexception-class-net-native.md) の例外の処理について詳しくは、この [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md) トピックの「手順 4: メタデータの欠落を手動で解決する」、「[リフレクションおよび .NET ネイティブ](../../../docs/framework/net-native/reflection-and-net-native.md)」、「[ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)」をご覧ください。  
+  
+## デバッグ ビルドとリリース ビルド  
+ .NET Core ランタイムに対してデバッグ ビルドを実行した場合は、ネイティブ コードにコンパイルされません。 このため、一般にランタイムによって提供されるすべてのサービスをアプリで使用することができます。  
+  
+ 一方、リリース ビルドの場合は、パフォーマンスを最大化するために、ターゲット プラットフォーム用のネイティブ コードにコンパイルされ、外部のランタイムおよびライブラリに対する依存関係のほとんどが削除され、コードが大幅に最適化されます。  
+  
+ .NET ネイティブを使用してコンパイルされたリリース ビルドをデバッグする場合:  
+  
+-   通常の .NET デバッグ ツールとは異なる、.NET ネイティブのデバッグ エンジンを使用します。  
+  
+-   実行可能ファイルのサイズは、最大限削減されます。 .NET ネイティブが実行可能ファイルのサイズを削減する方法の 1 つは、ランタイムの例外メッセージを大幅にトリミングする方法です。これについては、「[ランタイムの例外メッセージ](#Messages)」セクションでトピックとして詳細に説明しています。  
+  
+-   コードは大幅に最適化されます。 つまり、できる限りインライン展開が使用されます。 \(インライン展開により、コードは外部ルーチンから呼び出し元のルーチンに移動されます。\)   .NET ネイティブは特殊なランタイムを備えていて、積極的なインライン展開を実装するため、デバッグするときに表示される呼び出し履歴が影響を受けます。  詳細については、「[ランタイムの呼び出し履歴](#CallStack)」を参照してください。  
+  
+> [!NOTE]
+>  **\[.NET ネイティブ ツール チェーンを使用してコンパイルする\]** ボックスをオンまたはオフにすることによって、デバッグ ビルドとリリース ビルドを .NET ネイティブ ツール チェーンでコンパイルするかどうかを制御できます。 ただし、Windows ストアは常に .NET ネイティブ ツールのチェーンを使用してアプリの製品バージョンをコンパイルすることに注意してください。  
+  
+<a name="Messages"></a>   
+## ランタイムの例外メッセージ  
+ アプリケーションの実行可能ファイルのサイズを最小限に抑えるために、.NET ネイティブは例外メッセージの全文を組み込みません。 そのため、リリース ビルドでスローされるランタイム例外では、例外メッセージの全文が表示されない場合があります。 代わりに、部分的な文字列を含むテキストが、詳細を示すリンクと共に表示される可能性があります。 たとえば、以下のような例外情報が表示されます。  
+  
+```  
+  
+Exception thrown: '$16_System.AggregateException' in Unknown Module. Additional information: AggregateException_ctor_DefaultMessage If there is a handler for this exception, the program may be safely continued.  
+  
+```  
+  
+ 完全な例外メッセージが必要な場合は、代わりにデバッグ ビルドを実行します。 たとえば、リリース ビルドからの上記の例外情報は、デバッグ ビルドでは以下のように表示されます。  
+  
+```  
+  
+Exception thrown: 'System.AggregateException' in NativeApp.exe. Additional information: Value does not fall within the expected range.  
+  
+```  
+  
+<a name="CallStack"></a>   
+## ランタイムの呼び出し履歴  
+ インライン展開および他の最適化のために、.NET ネイティブ ツール チェーンでコンパイルされたアプリで表示される呼び出し履歴では、ランタイム例外へのパスを明確に識別できない場合があります。  
+  
+ 完全なスタックを取得するには、代わりにデバッグ ビルドを実行します。  
+  
+## 参照  
+ [.NET ネイティブの Windows ユニバーサル アプリのデバッグ](http://blogs.msdn.com/b/visualstudioalm/archive/2015/07/29/debugging-net-native-windows-universal-apps.aspx)   
+ [作業の開始](../../../docs/framework/net-native/getting-started-with-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/serialization-and-metadata.md b/docs/framework/net-native/serialization-and-metadata.md
new file mode 100644
index 00000000000..e272629395b
--- /dev/null
+++ b/docs/framework/net-native/serialization-and-metadata.md
@@ -0,0 +1,76 @@
+---
+title: "シリアル化とメタデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 619ecf1c-1ca5-4d66-8934-62fe7aad78c6
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# シリアル化とメタデータ
+アプリでオブジェクトをシリアル化および逆シリアル化する場合、ランタイム ディレクティブ \(.rd.xml\) ファイルにエントリを追加して、必要なメタデータが実行時に確実に存在するようにする必要があることがあります。  シリアライザーには次の 2 つのカテゴリがあり、それぞれランタイム ディレクティブ ファイルで異なる処理が必要です。  
+  
+-   リフレクション ベースのサードパーティ シリアライザー。  この場合、ランタイム ディレクティブ ファイルの変更が必要です。詳細については次のセクションで説明します。  
+  
+-   .NET Framework クラス ライブラリにある非リフレクション ベースのシリアライザー。  この場合、ランタイム ディレクティブ ファイルの変更が必要なことがあります。詳細については、「[Microsoft のシリアライザー](#Microsoft)」セクションで説明します。  
+  
+<a name="ThirdParty"></a>   
+## サードパーティ シリアライザー  
+ Newtonsoft.JSON などのサードパーティ シリアライザーは通常リフレクション ベースです。  シリアル化データのバイナリ ラージ オブジェクト \(BLOB\) の場合、対象の型のフィールドを名前で検索することで、データ内のフィールドが具象型に割り当てられます。  少なくとも、これらのライブラリを使用すると、[MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md) コレクションでシリアル化または逆シリアル化しようとする <xref:System.Type> オブジェクトごとに `List<Type>` 例外が発生します。  
+  
+ これらのシリアライザーでメタデータの欠落により引き起こされる問題に対処する最も簡単な方法は、1 つの名前空間 \(`App.Models` など\) でシリアル化に使用される型を収集し、`Serialize` メタデータ ディレクティブを適用することです。  
+  
+```  
+<Namespace Name="App.Models" Serialize="Required PublicAndInternal" />  
+```  
+  
+ この例で使用されている構文の詳細については、「[\<Namespace\> 要素](../../../docs/framework/net-native/namespace-element-net-native.md)」を参照してください。  
+  
+<a name="Microsoft"></a>   
+## Microsoft のシリアライザー  
+ <xref:System.Runtime.Serialization.DataContractSerializer>、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>、および <xref:System.Xml.Serialization.XmlSerializer> クラスではリフレクションを利用しませんが、シリアル化または逆シリアル化されるオブジェクトに基づいてコードが生成される必要があります。  各シリアライザーのオーバーロードされたコンストラクターには、シリアル化または逆シリアル化される型を指定する <xref:System.Type> パラメーターが含まれます。  次の 2 つのセクションで説明するように、コードでのその型の指定方法によってユーザーが実行する必要のあるアクションが定義されます。  
+  
+### コンストラクターで使用される typeof  
+ これらのシリアル化クラスのコンストラクターを呼び出し、メソッド呼び出しに C\# [typeof](../Topic/typeof%20\(C%23%20Reference\).md) キーワードを含めた場合、**それ以外に行う必要がある作業はありません**。  たとえば、シリアル化クラス コンストラクターに対する次の各呼び出しでは、`typeof` キーワードがコンストラクターに渡される式の一部として使用されます。  
+  
+ [!code-csharp[ProjectN#5](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/serialize1.cs#5)]  
+  
+ [!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラは、このコードを自動的に処理します。  
+  
+### コンストラクターの外部で使用される typeof  
+ 次のコードのように、これらのシリアル化クラスのコンストラクターを呼び出し、コンストラクターの [typeof](../Topic/typeof%20\(C%23%20Reference\).md) パラメーターに提供する式の外部で C\# <xref:System.Type> キーワードを使用した場合、[!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラは型を解決できません。  
+  
+ [!code-csharp[ProjectN#6](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/serialize1.cs#6)]  
+  
+ この場合は、次のようなエントリを追加して、ランタイム ディレクティブ ファイルで型を指定する必要があります。  
+  
+```  
+<Type Name="DataSet" Browse="Required Public" />  
+```  
+  
+ 同様に、次のコードのように [XmlSerializer.XmlSerializer\(Type, Type\<xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Type%5B%5D%29?displayProperty=fullName> などのコンストラクターを呼び出し、シリアル化する追加の <xref:System.Type> オブジェクトの配列を指定した場合も、[!INCLUDE[net_native](../../../includes/net-native-md.md)] コンパイラはこれらの型を解決できません。  
+  
+ [!code-csharp[ProjectN#7](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn/cs/serialize1.cs#7)]  
+  
+ 型ごとに次のようなエントリをランタイム ディレクティブ ファイルに追加する必要があります。  
+  
+```  
+<Type Name="t" Browse="Required Public" />  
+```  
+  
+ この例で使用されている構文の詳細については、「[\<Type\> 要素](../../../docs/framework/net-native/type-element-net-native.md)」を参照してください。  
+  
+## 参照  
+ [ランタイム ディレクティブ \(rd.xml\) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [\<Type\> 要素](../../../docs/framework/net-native/type-element-net-native.md)   
+ [\<Namespace\> 要素](../../../docs/framework/net-native/namespace-element-net-native.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/subtypes-element-net-native.md b/docs/framework/net-native/subtypes-element-net-native.md
new file mode 100644
index 00000000000..0d90f58046a
--- /dev/null
+++ b/docs/framework/net-native/subtypes-element-net-native.md
@@ -0,0 +1,105 @@
+---
+title: "&lt;Subtypes&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb854070-248b-46cf-9dab-c322e2b4d624
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# &lt;Subtypes&gt; 要素 (.NET ネイティブ)
+それを含む型から継承されたすべてのクラスに実行時ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Subtypes Activate="policy_type"  
+          Browse="policy_type"  
+          Dynamic="policy_type"  
+          Serialize="policy_type"   
+          DataContractSerializer="policy_setting"  
+          DataContractJsonSerializer="policy_setting"  
+          XmlSerializer="policy_setting"  
+          MarshalObject="policy_setting"  
+          MarshalDelegate="policy_setting"  
+          MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="all-attributes"></a>すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<Subtypes>` 要素は、それを含む型のすべてのサブタイプにポリシーを適用します。 派生型および基底クラスに異なるポリシーを適用する場合に使用します。  
+  
+ リフレクション、シリアル化、および相互運用属性はいずれも省略可能ですが、そのうち少なくとも&1; つが存在する必要があります。  
+  
+## <a name="example"></a>例  
+ 次の例では、`BaseClass` という名前のクラスと `Derived1` という名前のサブクラスを定義します。  
+  
+ [!code-csharp[ProjectN_Reflection#4](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/subtypes.cs#4)]  
+  
+ 次のコードに示すように、ランタイム ディレクティブ ファイルは、`Dynamic` の `Activate` ポリシーと `BaseClass` ポリシーを明示的に `Excluded` に設定します。 このため、`BaseClass` 型のオブジェクトは動的に、または `BaseClass` クラス コンストラクターの呼び出しによってインスタンス化できません。 ただし、`<Subtypes>` 要素では、`BaseClass` から派生されたクラスの動的なおよびクラス コンストラクターの呼び出しによるインスタンス化は行えません。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+   <Assembly Name="*Application*" Dynamic="Required All" />  
+     <Type Name="Examples.Libraries.BaseClass" Activate ="Excluded" Dynamic="Excluded" >  
+        <Subtypes Activate="Public" Dynamic ="Public"/>  
+     </Type>  
+  </Application>  
+</Directives>  
+  
+```  
+  
+ ため、`<Subtypes>`ディレクティブ、次のコードをインスタンス化する、`Derived1`呼び出すことによって動的にインスタンス、 <xref:System.Activator.CreateInstance%28System.Type%29?displayProperty=fullName>メソッドが正常に実行されます。  ここでブロック変数は、 <xref:System.Windows.Controls.TextBlock>空の Windows ストア アプリケーション内のオブジェクト。  
+  
+ [!code-csharp[ProjectN_Reflection#5](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/subtypes.cs#5)]  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/type-element-net-native.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/type-element-net-native.md b/docs/framework/net-native/type-element-net-native.md
new file mode 100644
index 00000000000..aeeda8eab4f
--- /dev/null
+++ b/docs/framework/net-native/type-element-net-native.md
@@ -0,0 +1,148 @@
+---
+title: "&lt;Type&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e88d368-a886-4f1e-8eb6-6127979a9fce
+caps.latest.revision: 33
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# &lt;Type&gt; 要素 (.NET ネイティブ)
+クラスや構造体などの特定の型に実行時ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Type Name="type_name"  
+      Activate="policy_type"  
+      Browse="policy_type"  
+      Dynamic="policy_type"  
+      Serialize="policy_type"   
+      DataContractSerializer="policy_setting"  
+      DataContractJsonSerializer="policy_setting"  
+      XmlSerializer="policy_setting"  
+      MarshalObject="policy_setting"  
+      MarshalDelegate="policy_setting"  
+      MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 型名を指定します。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*type_name*|型名。 この場合`<Type>`要素のいずれかの子では、 [ <> \> ](../../../docs/framework/net-native/namespace-element-net-native.md)要素または別`<Type>`要素、 *type_name*名前空間なしの型の名前を含めることができます。 それ以外の場合、 *type_name*完全修飾型名を含める必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/attributeimplies-element-net-native.md)|含んでいる型が属性の場合は、その属性が適用されるコード要素の実行時ポリシーを定義します。|  
+|[<>\>](../../../docs/framework/net-native/event-element-net-native.md)|この型に属するイベントにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/field-element-net-native.md)|この型に属するフィールドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/genericparameter-element-net-native.md)|ジェネリック型のパラメーターの型にポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|型にポリシーを適用します (それを含む `<Type>` 要素により表される型にそのポリシーが適用されている場合)。|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|この型に属するメソッドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)|この型に属する構築されたジェネリック メソッドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/property-element-net-native.md)|この型に属するプロパティにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/subtypes-element-net-native.md)|それを含む型から継承されたすべてのクラスに実行時ポリシーを適用します。|  
+|`<Type>`|入れ子になった型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型にリフレクション ポリシーを適用します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/application-element-net-native.md)|実行時にリフレクションで使用可能なメタデータを持つ、アプリケーション全体の型と型のメンバーのコンテナーとして機能します。|  
+|[<>\>](../../../docs/framework/net-native/assembly-element-net-native.md)|指定したアセンブリ内のすべての型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/library-element-net-native.md)|実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。|  
+|[<>\>](../../../docs/framework/net-native/namespace-element-net-native.md)|名前空間内のすべての型にリフレクション ポリシーを適用します。|  
+|`<Type>`|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ リフレクション、シリアル化、および相互運用属性はすべて省略可能です。 いずれも存在しない場合、`<Type>` 要素は、その子型が個々のメンバーのポリシーを定義するコンテナーとして機能します。  
+  
+ 場合、`<Type>`要素の子では、 [ <> \</> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)、 [ <> \</> \> ](../../../docs/framework/net-native/namespace-element-net-native.md)、 `<Type>`、または[ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素、親要素によって定義されたポリシー設定をオーバーライドしています。  
+  
+ ジェネリック型の `<Type>` 要素は、独自のポリシーを持たないすべてのインスタンス化にそのポリシーを適用します。 によって構築されたジェネリック型のポリシーが定義されている、 [ <> \> ](../../../docs/framework/net-native/typeinstantiation-element-net-native.md)要素。  
+  
+ アクサン グラーブ記号で名前を修飾する型がジェネリック型の場合は、(' ') のジェネリック パラメーターの番号を使用してその後にします。 たとえば、`Name`の属性、`<Type>`の要素、 <xref:System.Collections.Generic.List%601?displayProperty=fullName>クラスとして位置付け`Name="System.Collections.Generic.List`1"'。  
+  
+## <a name="example"></a>例  
+ 次の例では、リフレクションを使用して、フィールド、プロパティ、およびメソッドに関する情報を表示、 <xref:System.Collections.Generic.List%601?displayProperty=fullName>クラスです。 変数`b`の例では、 [TextBlock](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.controls.textblock.aspx)コントロールです。 この例は単に型情報を取得するのみであるため、メタデータの可用性は `Browse` ポリシー設定により制御されます。  
+  
+ [!code-csharp[ProjectN_Reflection#3](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/browsegenerictype1.cs#3)]  
+  
+ のメタデータ、<xref:System.Collections.Generic.List%601>クラスによって自動的に含め、[!INCLUDE[net_native](../../../includes/net-native-md.md)]実行時に指定されたメンバー情報を表示するツール チェーンでは、例では、失敗します。 必要なメタデータを提供するには、次の `<Type>` 要素をランタイム ディレクティブ ファイルに追加します。 親を指定しているため、注意してください。 [ <> \> ](../../../docs/framework/net-native/namespace-element-net-native.md)要素、で完全修飾型名を用意する必要はありません、`<Type>`要素。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Application>  
+      <Assembly Name="*Application*" Dynamic="Required All" />  
+      <Namespace Name ="System.Collections.Generic" >  
+        <Type Name="List`1" Browse="Required All" />   
+     </Namespace>  
+   </Application>  
+</Directives>  
+  
+```  
+  
+## <a name="example"></a>例  
+ 次の例では、リフレクションを使用して、取得、 <xref:System.Reflection.PropertyInfo>を表すオブジェクト、 <xref:System.String.Chars%2A?displayProperty=fullName>プロパティです。 次を使用して、 [PropertyInfo.GetValue (オブジェクトを使用してオブジェクト\<xref:System.Reflection.PropertyInfo.GetValue%28System.Object%2CSystem.Object%5B%5D%29?displayProperty=fullName>メソッド、文字列の&7; 番目の文字の値を取得し、文字列のすべての文字を表示します。 変数`b`の例では、 [TextBlock](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.controls.textblock.aspx)コントロールです。  
+  
+ [!code-csharp[ProjectN_Reflection#1](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/propertyinfo1.cs#1)]  
+  
+ のメタデータ、<xref:System.String>オブジェクトが使用できないへの呼び出し、 [PropertyInfo.GetValue (Object, Object\<xref:System.Reflection.PropertyInfo.GetValue%28System.Object%2CSystem.Object%5B%5D%29?displayProperty=fullName>メソッドがスローされます、 <xref:System.NullReferenceException>実行時例外でコンパイルすると、[!INCLUDE[net_native](../../../includes/net-native-md.md)]ツール チェーン。 例外を排除し、必要なメタデータを提供するには、次の `<Type>` 要素をランタイム ディレクティブ ファイルに追加します。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+    <Assembly Name="*Application*" Dynamic="Required All" />  
+    <Type Name="System.String" Dynamic="Required Public"/> -->  
+  </Application>  
+</Directives>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/typeinstantiation-element-net-native.md b/docs/framework/net-native/typeinstantiation-element-net-native.md
new file mode 100644
index 00000000000..54e7c60e2bc
--- /dev/null
+++ b/docs/framework/net-native/typeinstantiation-element-net-native.md
@@ -0,0 +1,131 @@
+---
+title: "&lt;TypeInstantiation&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5eada64-075b-4162-9655-ded84e4681f2
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# &lt;TypeInstantiation&gt; 要素 (.NET ネイティブ)
+構築されたジェネリック型にランタイム リフレクション ポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<TypeInstantiation Name="type_name"  
+                   Arguments="type_arguments"  
+                   Activate="policy_type"  
+                   Browse="policy_type"  
+                   Dynamic="policy_type"  
+                   Serialize="policy_type"  
+                   DataContractSerializer="policy_setting"  
+                   DataContractJsonSerializer="policy_setting"  
+                   XmlSerializer="policy_setting"  
+                   MarshalObject="policy_setting"  
+                   MarshalDelegate="policy_setting"  
+                   MarshalStructure="policy_setting" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 型名を指定します。|  
+|`Arguments`|全般|必須の属性です。 ジェネリック型の引数を指定します。 複数の引数が存在する場合は、コンマで区切られます。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 ネイティブ コードに構造体をマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*type_name*|型名。 この場合`<TypeInstantiation>`要素の子では、 [ <> \> ](../../../docs/framework/net-native/namespace-element-net-native.md)要素、 [ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)要素、または別`<TypeInstantiation>`要素、 *type_name* 、名前空間なしで型の名前を指定できます。 それ以外の場合、 *type_name*完全修飾型名を含める必要があります。 型名は修飾されません。 たとえば、 <xref:System.Collections.Generic.List%601?displayProperty=fullName>オブジェクト、`<TypeInstantiation>`要素は次のように表示される可能性があります。<br /><br /> `\<TypeInstantiation Name=System.Collections.Generic.List Dynamic="Required Public" />`|  
+  
+## <a name="arguments-attribute"></a>引数属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*type_argument*|ジェネリック型の引数を指定します。 複数の引数が存在する場合は、コンマで区切られます。 各引数は、完全修飾型名で構成されている必要があります。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|構築されたジェネリック型のこのポリシーの種類に適用する設定です。 指定できる値は、`All`、`Auto`、`Excluded`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/event-element-net-native.md)|この型に属するイベントにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/field-element-net-native.md)|この型に属するフィールドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/impliestype-element-net-native.md)|型にポリシーを適用します (それを含む `<TypeInstantiation>` 要素により表される型にそのポリシーが適用されている場合)。|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|この型に属するメソッドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/methodinstantiation-element-net-native.md)|この型に属する構築されたジェネリック メソッドにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/property-element-net-native.md)|この型に属するプロパティにリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|入れ子になった型にリフレクション ポリシーを適用します。|  
+|`<TypeInstantiation>`|入れ子になった構築されたジェネリック型にリフレクション ポリシーを適用します。|  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/application-element-net-native.md)|実行時にリフレクションで使用可能なメタデータを持つ、アプリケーション全体の型と型のメンバーのコンテナーとして機能します。|  
+|[<>\>](../../../docs/framework/net-native/assembly-element-net-native.md)|指定したアセンブリ内のすべての型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/library-element-net-native.md)|実行時にリフレクションに使用可能なメタデータを持つ型と型のメンバーを含むアセンブリを定義します。|  
+|[<>\>](../../../docs/framework/net-native/namespace-element-net-native.md)|名前空間内のすべての型にリフレクション ポリシーを適用します。|  
+|[<>\>](../../../docs/framework/net-native/type-element-net-native.md)|型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+|`<TypeInstantiation>`|構築されたジェネリック型とそのすべてのメンバーにリフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ リフレクション、シリアル化、および相互運用属性はすべて省略可能です。 ただし、そのうち少なくとも&1; つが存在する必要があります。  
+  
+ 場合、`<TypeInstantiation>`要素の子では、 [ <> \</> \> ](../../../docs/framework/net-native/assembly-element-net-native.md)、 [ <> \</> \> ](../../../docs/framework/net-native/namespace-element-net-native.md)、または[ <> \</> \> ](../../../docs/framework/net-native/type-element-net-native.md)、要素、親要素によって定義されたポリシー設定をオーバーライドしています。 場合、 [ <> \> ](../../../docs/framework/net-native/type-element-net-native.md)要素は、対応するジェネリック型定義を定義、`<TypeInstantiation>`要素は指定の構築されたジェネリック型のインスタンス化についてのみランタイム リフレクション ポリシーをオーバーライドします。  
+  
+## <a name="example"></a>例  
+ 次の例では、リフレクションを使用して、構築されたジェネリック型定義を取得<xref:System.Collections.Generic.Dictionary%602>オブジェクト</TKey, TValue>。 情報を表示するリフレクションを使用<xref:System.Type>構築されたジェネリック型とジェネリック型定義を表すオブジェクト。 変数`b`の例では、 [TextBlock](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.controls.textblock.aspx)コントロールです。  
+  
+ [!code-csharp[ProjectN_Reflection#2](../../../samples/snippets/csharp/VS_Snippets_CLR/projectn_reflection/cs/makegenerictype1.cs#2)]  
+  
+ コンパイルされる、[!INCLUDE[net_native](../../../includes/net-native-md.md)]ツール チェーンの例では、スロー、 [MissingMetadataException](../../../docs/framework/net-native/missingmetadataexception-class-net-native.md)を呼び出す行を例外、 <xref:System.Type.GetGenericTypeDefinition%2A?displayProperty=fullName>メソッドです。 次の `<TypeInstantiation>` 要素をランタイム ディレクティブ ファイルに追加すると、この例外を排除して、必要なメタデータを提供できます。  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+  <Application>  
+    <Assembly Name="*Application*" Dynamic="Required All" />  
+     <TypeInstantiation Name="System.Collections.Generic.Dictionary"  
+                        Arguments="System.String,GenericType.Example"  
+                        Dynamic="Required Public" />  
+  </Application>  
+</Directives>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)
\ No newline at end of file
diff --git a/docs/framework/net-native/typeparameter-element-net-native.md b/docs/framework/net-native/typeparameter-element-net-native.md
new file mode 100644
index 00000000000..a2e08c6e2e4
--- /dev/null
+++ b/docs/framework/net-native/typeparameter-element-net-native.md
@@ -0,0 +1,112 @@
+---
+title: "&lt;TypeParameter&gt; 要素 (.NET ネイティブ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d37bb1b7-1ddc-4c6d-8ecf-583f804a2479
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# &lt;TypeParameter&gt; 要素 (.NET ネイティブ)
+メソッドに渡される型引数により表される型にポリシーを適用します。  
+  
+## <a name="syntax"></a>構文  
+  
+```xml  
+  
+<Parameter Name="parameter_name"  
+           Activate="policy_type"  
+           Browse="policy_type"  
+           Dynamic="policy_type"  
+           Serialize="policy_type"  
+           DataContractSerializer="policy_type"  
+           DataContractJsonSerializer="policy_type"  
+           XmlSerializer="policy_type"  
+           MarshalObject="policy_type"  
+           MarshalDelegate="policy_type"  
+           MarshalStructure="policy_type" />  
+  
+```  
+  
+## <a name="attributes-and-elements"></a>属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### <a name="attributes"></a>属性  
+  
+|属性|属性の型|説明|  
+|---------------|--------------------|-----------------|  
+|`Name`|全般|必須の属性です。 型のパラメーターの名前<xref:System.Type>します。 たとえば、メソッド シグネチャ `Type.GetInterfaceMap(Type interfaceType)` の場合、`Name` 属性の値は "interfaceType" です。|  
+|`Activate`|反射|省略可能な属性です。 コンストラクターへの実行時アクセスを制御して、インスタンスのアクティブ化を有効にします。|  
+|`Browse`|反射|省略可能な属性です。 プログラム要素に関する情報の照会を制御しますが、実行時アクセスは有効にしません。|  
+|`Dynamic`|反射|省略可能な属性です。 コンストラクター、メソッド、フィールド、プロパティ、およびイベントを含むすべての型のメンバーへの実行時アクセスを制御して、動的プログラミングを有効にします。|  
+|`Serialize`|シリアル化|省略可能な属性です。 コンストラクター、フィールド、およびプロパティへの実行時アクセスを制御し、Newtonsoft の JSON シリアライザーなどのライブラリによって型インスタンスをシリアル化および逆シリアル化できるようにします。|  
+|`DataContractSerializer`|シリアル化|省略可能な属性です。 使用するシリアル化のポリシーを制御、 <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>クラスです。|  
+|`DataContractJsonSerializer`|シリアル化|省略可能な属性です。 ポリシーを使用する JSON シリアル化を制御、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=fullName>クラスです。|  
+|`XmlSerializer`|シリアル化|省略可能な属性です。 使用する XML シリアル化のポリシーを制御、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>クラスです。|  
+|`MarshalObject`|Interop|省略可能な属性です。 Windows ランタイムと COM に参照型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalDelegate`|Interop|省略可能な属性です。 ネイティブ コードへの関数ポインターとしてデリゲート型をマーシャリングするためのポリシーを制御します。|  
+|`MarshalStructure`|Interop|省略可能な属性です。 値型をネイティブ コードにマーシャリングするためのポリシーを制御します。|  
+  
+## <a name="name-attribute"></a>Name 属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*パラメーター名*|型のパラメーターの名前<xref:System.Type>します。 たとえば、メソッド シグネチャ `Type.GetInterfaceMap(Type interfaceType)` の場合、`Name` 属性の値は "interfaceType" です。|  
+  
+## <a name="all-other-attributes"></a>その他すべての属性  
+  
+|値|説明|  
+|-----------|-----------------|  
+|*policy_setting*|このポリシーの種類に適用する設定です。 指定できる値は、`All`、`Public`、`PublicAndInternal`、`Required Public`、`Required PublicAndInternal`、および `Required All` です。 詳細については、次を参照してください。[ランタイム ディレクティブのポリシー設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)します。|  
+  
+### <a name="child-elements"></a>子要素  
+ なし。  
+  
+### <a name="parent-elements"></a>親要素  
+  
+|要素|説明|  
+|-------------|-----------------|  
+|[<>\>](../../../docs/framework/net-native/method-element-net-native.md)|コンストラクターまたはメソッドにランタイム リフレクション ポリシーを適用します。|  
+  
+## <a name="remarks"></a>コメント  
+ `<TypeParameter>`要素がに似ていますが、 [ <> \> ](../../../docs/framework/net-native/parameter-element-net-native.md)要素、型のパラメーターにのみその it を適用できる点が異なります<xref:System.Type>します。 これは、実行時に `Name` 属性により指定される型引数で表されるすべての型にポリシーを適用します。  
+  
+ たとえば、NewtonSoft の JSON シリアライザーには静的 `JsonConvert.DeserializeObject(String value, Type type)` メソッドが含まれています。 次のリフレクション ディレクティブは、  
+  
+```xml  
+  
+<Directives xmlns="http://schemas.microsoft.com/netfx/2013/01/metadata">  
+   <Type Name="Newtonsoft.Json.JsonConvert" >  
+      <Method Name="DeserializeObject">  
+         <GenericParameter Name="type" Serialize="Required All" />  
+      </Method>  
+   </Type>  
+</Directives>  
+  
+```  
+  
+ によって表されるランタイム型のメタデータが指定して、`type`引数利用できるようにシリアル化します。 これらのランタイム ディレクティブが次のソース コードを含むプロジェクトに適用された場合、  
+  
+```csharp  
+  
+Type t = typeof(StockQuote);  
+Object obj = JsonConvert.DeserializeObject(data, t);  
+  
+```  
+  
+ リフレクション ディレクティブによって、`StockQuote` 型のメタデータが実行時に NewtonSoft の JSON シリアライザーで使用可能になります。  
+  
+## <a name="see-also"></a>関連項目  
+ [<>\>要素](../../../docs/framework/net-native/method-element-net-native.md)   
+ [ランタイム ディレクティブ (rd.xml) 構成ファイル リファレンス](../../../docs/framework/net-native/runtime-directives-rd-xml-configuration-file-reference.md)   
+ [ランタイム ディレクティブ ポリシーの設定](../../../docs/framework/net-native/runtime-directive-policy-settings.md)   
+ [ランタイム ディレクティブ要素](../../../docs/framework/net-native/runtime-directive-elements.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/TOC.md b/docs/framework/network-programming/TOC.md
new file mode 100644
index 00000000000..8e251dd715c
--- /dev/null
+++ b/docs/framework/network-programming/TOC.md
@@ -0,0 +1,101 @@
+# [方法: インターフェイス情報とプロトコル情報を取得する](how-to-get-interface-and-protocol-information.md)
+# [非同期クライアント ソケットの使用](using-an-asynchronous-client-socket.md)
+# [自動プロキシ検出](automatic-proxy-detection.md)
+# [ネットワーク アプリケーションのキャッシュ管理](cache-management-for-network-applications.md)
+# [インターネット要求の作成](creating-internet-requests.md)
+# [方法: HTTP 固有のプロパティにアクセスする](how-to-access-http-specific-properties.md)
+# [ソケットのコード例](socket-code-examples.md)
+# [WebResponse からの派生](deriving-from-webresponse.md)
+# [ピア名の公開と解決](peer-name-publication-and-resolution.md)
+# [.NET Framework のネットワークのトレース](network-tracing.md)
+# [インターネット プロトコル バージョン 6](internet-protocol-version-6.md)
+# [場所ベースのキャッシュ ポリシー](location-based-cache-policies.md)
+# [方法: FTP を使用してファイルをアップロードする](how-to-upload-files-with-ftp.md)
+# [データの要求](requesting-data.md)
+# [TCP/UDP](tcp-udp.md)
+# [方法: WebRequest を型キャストしてプロトコル固有のプロパティにアクセスする](how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md)
+# [方法: WebRequest に一致するプロトコル固有の WebResponse を取得する](how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md)
+# [UDP サービスの使用](using-udp-services.md)
+# [Web およびソケットのアクセス許可](web-and-socket-permissions.md)
+# [非同期クライアント ソケットの例](asynchronous-client-socket-example.md)
+# [方法: ネットワークの可用性とアドレスの変更を検出する](how-to-detect-network-availability-and-address-changes.md)
+# [インターネット認証](internet-authentication.md)
+# [方法: Web ページを要求し、ストリームとして結果を取得する](how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md)
+# [TCP サービスの使用](using-tcp-services.md)
+# [ピアツーピア ネットワーキング シナリオ](peer-to-peer-networking-scenarios.md)
+# [同期サーバー ソケットの使用](using-a-synchronous-server-socket.md)
+# [プロキシを介したインターネットへのアクセス](accessing-the-internet-through-a-proxy.md)
+# [IPv6 のルーティング](ipv6-routing.md)
+# [証明書の選択と検証](certificate-selection-and-validation.md)
+# [方法: ソケットを作成する](how-to-create-a-socket.md)
+# [方法: ホストに対して ping を実行](how-to-ping-a-host.md)
+# [構成 (インターネット アプリケーションを)](configuring-internet-applications.md)
+# [ピアツーピア コラボレーション](peer-to-peer-collaboration.md)
+# [System.Uri での International Resource Identifier のサポート](international-resource-identifier-support-in-system-uri.md)
+# [System.Net.PeerToPeer.Collaboration 名前空間について](about-the-system-net-peertopeer-collaboration-namespace.md)
+# [Windows ストア アプリのネットワーク分離](network-isolation-for-windows-store-apps.md)
+# [ネットワーク プログラミングにおけるセキュリティ](security-in-network-programming.md)
+# [ピア名と PNRP ID](peer-names-and-pnrp-ids.md)
+# [ネットワークのトレースの解釈](interpreting-network-tracing.md)
+# [PNRP クラウド](pnrp-clouds.md)
+# [NTLM 認証および Kerberos 認証](ntlm-and-kerberos-authentication.md)
+# [FTP](ftp.md)
+# [接続の管理](managing-connections.md)
+# [方法: WebRequest を使用してカスタム プロトコルを登録する](how-to-register-a-custom-protocol-using-webrequest.md)
+# [HTTP](http.md)
+# [WebRequest からの派生](deriving-from-webrequest.md)
+# [同期クライアント ソケットの使用](using-a-synchronous-client-socket.md)
+# [ネットワーク プログラミング方法のトピック](network-programming-how-to-topics.md)
+# [ネットワーク プログラミングのサンプル](network-programming-samples.md)
+# [方法: 時間ベースのキャッシュ ポリシーをカスタマイズする](how-to-customize-a-time-based-cache-policy.md)
+# [.NET Framework のネットワーク プログラミング](index.md)
+# [基本認証とダイジェスト認証](basic-and-digest-authentication.md)
+# [バージョン 3.5 SP1 における HttpWebRequest の NTLM 認証への変更](changes-to-ntlm-authentication-for-httpwebrequest-in-version-3-5-sp1.md)
+# [方法: FTP を使用してファイルをダウンロードする](how-to-download-files-with-ftp.md)
+# [クライアント ソケットの使用](using-client-sockets.md)
+# [統合 Windows 認証と拡張保護](integrated-windows-authentication-with-extended-protection.md)
+# [非同期サーバー ソケットの使用](using-an-asynchronous-server-socket.md)
+# [キャッシュ ポリシーの相互作用 — 最大有効期間と最大期限延長](cache-policy-interaction-maximum-age-and-maximum-staleness.md)
+# [方法: グループの接続にユーザー情報を割り当てる](how-to-assign-user-information-to-group-connections.md)
+# [時間ベースのキャッシュ ポリシー](time-based-cache-policies.md)
+# [WebRequest の問題と例外について](understanding-webrequest-problems-and-exceptions.md)
+# [非同期要求を行う](making-asynchronous-requests.md)
+# [System.Net クラスのベスト プラクティス](best-practices-for-system-net-classes.md)
+# [Secure Sockets Layerの使用](using-secure-sockets-layer.md)
+# [方法: アプリケーションの既定の時間ベースのキャッシュ ポリシーを設定します。](how-to-set-the-default-time-based-cache-policy-for-an-application.md)
+# [方法: アプリケーションの場所ベースのキャッシュ ポリシーを設定します。](how-to-set-a-location-based-cache-policy-for-an-application.md)
+# [プラグ可能なプロトコルのプログラミング](programming-pluggable-protocols.md)
+# [方法: WebRequest クラスを使用してデータを送信する](how-to-send-data-using-the-webrequest-class.md)
+# [エラー処理](handling-errors.md)
+# [キャッシュ ポリシーの相互作用 — 最大有効期間と最小鮮度](cache-policy-interaction-maximum-age-and-minimum-freshness.md)
+# [IPv6 の有効化と無効化](enabling-and-disabling-ipv6.md)
+# [方法: WebRequest でインターネットとの通信にプロキシを使用できるようにする](how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md)
+# [ネットワークのトレースの有効化](enabling-network-tracing.md)
+# [方法へまたは: ネットワーク追跡をコンフィギュレーションします。](how-to-configure-network-tracing.md)
+# [HttpListener](httplistener.md)
+# [同期サーバー ソケットの例](synchronous-server-socket-example.md)
+# [IPv6 の自動構成](ipv6-auto-configuration.md)
+# [IPv6 および Teredo を使用した NAT トラバーサル](nat-traversal-using-ipv6-and-teredo.md)
+# [方法: IPv6 のサポートを有効にするようにコンピューター構成ファイルを変更する](how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md)
+# [プラグ可能なプロトコルの概要](introducing-pluggable-protocols.md)
+# [リッスン (ソケットで)](listening-with-sockets.md)
+# [ネットワーク アプリケーションでのキャッシュの構成](configuring-caching-in-network-applications.md)
+# [アプリケーション プロトコルの使用](using-application-protocols.md)
+# [方法: 要求のキャッシュ ポリシーを設定する](how-to-set-cache-policy-for-a-request.md)
+# [方法: WebRequest クラスを使用してデータを要求する](how-to-request-data-using-the-webrequest-class.md)
+# [バージョン 2.0 での System.Uri 名前空間の変更](changes-to-the-system-uri-namespace-in-version-2-0.md)
+# [プロキシ コンフィギュレーション](proxy-configuration.md)
+# [NetworkInformation](networkinformation.md)
+# [接続のグループ化](connection-grouping.md)
+# [同期クライアント ソケットの例](synchronous-client-socket-example.md)
+# [PNRP キャッシュ](pnrp-caches.md)
+# [アプリケーション開発での PNRP](pnrp-in-application-development.md)
+# [バージョン 3.5 のソケット パフォーマンスの強化](socket-performance-enhancements-in-version-3-5.md)
+# [IPv6 アドレス指定](ipv6-addressing.md)
+# [キャッシュ ポリシー](cache-policy.md)
+# [非同期サーバー ソケットの例](asynchronous-server-socket-example.md)
+# [方法: FTP でディレクトリの内容を一覧表示する](how-to-list-directory-contents-with-ftp.md)
+# [Peer Name Resolution Protocol](peer-name-resolution-protocol.md)
+# [ソケット](sockets.md)
+# [方法: グローバル プロキシの選択をオーバーライドする](how-to-override-a-global-proxy-selection.md)
+# [ネットワーク上でストリームを使用する](using-streams-on-the-network.md)
diff --git a/docs/framework/network-programming/about-the-system-net-peertopeer-collaboration-namespace.md b/docs/framework/network-programming/about-the-system-net-peertopeer-collaboration-namespace.md
new file mode 100644
index 00000000000..0df5cdb1318
--- /dev/null
+++ b/docs/framework/network-programming/about-the-system-net-peertopeer-collaboration-namespace.md
@@ -0,0 +1,53 @@
+---
+title: "System.Net.PeerToPeer.Collaboration 名前空間について | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b5d8c1c1-6844-4947-9759-c7f1b564bded
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# System.Net.PeerToPeer.Collaboration 名前空間について
+<xref:System.Net.PeerToPeer.Collaboration> の名前空間がピアツーピア コラボレーションの下部組織を使用してピアのコラボレーション活動を実行するために使用されるおよびクラス API を提供します。  
+  
+## クラス  
+ コラボレーション ピアツーピア活動の実装に使用される主類は次のとおりです:  
+  
+-   ピアの取引連絡先を保存するために使用できる <xref:System.Net.PeerToPeer.Collaboration.ContactManager>。  
+  
+-   ゲーム チャット、のクライアントまたは協議ソリューションなど、連携して動作する <xref:System.Net.PeerToPeer.Collaboration.PeerApplication>。  
+  
+-   活動で協力するピア。  これらの <xref:System.Net.PeerToPeer.Collaboration.PeerContact>ピアは、<xref:System.Net.PeerToPeer.Collaboration.PeerNearMe>、または <xref:System.Net.PeerToPeer.Collaboration.PeerEndPoint> の対象として表すことができます。  
+  
+-   どのアプリケーションを使用できるように、どのピアは、参加するかを指定する <xref:System.Net.PeerToPeer.Collaboration.PeerCollaboration> の静的なクラス自体。  
+  
+ <xref:System.Net.PeerToPeer.Collaboration.PeerContact.Invite%2A> 方法がコラボレーション セッションにピアを依頼するために使用されます。  ピア呼び出しの信号にアプリケーションは、コラボレーションのセッションで提携するオブジェクト、プレゼンス情報を更新するイベントの別のピアに配属できます。  すべての入力がピアに割り当てるか指定するにプレゼンスのクラスが <xref:System.Net.PeerToPeer.Collaboration.Peer> がコラボレーションに使用できる、<xref:System.Net.PeerToPeer.Collaboration.PeerScope> のクラスを使用していますかどうかを指定します: <xref:System.Net.PeerToPeer.Collaboration.PeerScope> \(グローバル\)、<xref:System.Net.PeerToPeer.Collaboration.PeerScope>、\(サブネット\) または <xref:System.Net.PeerToPeer.Collaboration.PeerScope>。  
+  
+ コラボレーションのセッションは、4 種類の手順で構成されます:  
+  
+-   検出。  ピア、アプリケーションやプレゼンス情報を見つけたまたは配分します。  たとえば、同じゲームをインストールする保管場所のサブネットの他の従業員を検索します。  
+  
+-   招待状。  <xref:System.Net.PeerToPeer.Collaboration.PeerCollaboration> セッションを開始、または入力するリモート ピアの安全な招待状を送信、承認します。  
+  
+-   連絡先の管理。  検出された <xref:System.Net.PeerToPeer.Collaboration.ContactManager>に取引連絡先としてピアを追加します。  
+  
+-   通信。  通信を確立されると、<xref:System.Net> API、<xref:System.Net.PeerToPeer> API を使用すると、Windows Communication Foundation ピアのチャンネルは複数政党制通信用の分類されます。  
+  
+ たとえば、ホストのピアは、コラボレーション セッションを開始し、ホスト ピアの連絡先のマネージャに保管場所のピアのリモート ピアと 1 追加するに <xref:System.Net.PeerToPeer.Collaboration.ContactManager.CreateContact%2A> 方法を使用します。  3 人のユーザーが自分のプライベート コラボレーションのセッションに加わります。  
+  
+ 一般的な P2P のアプリケーションは次のとおりです: 関連の注記がまたは whiteboarding の電話会議、serverless チャット、アプリケーションの対話な広告、オンライン賭博セッション。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer.Collaboration>
\ No newline at end of file
diff --git a/docs/framework/network-programming/accessing-the-internet-through-a-proxy.md b/docs/framework/network-programming/accessing-the-internet-through-a-proxy.md
new file mode 100644
index 00000000000..e1daefd2116
--- /dev/null
+++ b/docs/framework/network-programming/accessing-the-internet-through-a-proxy.md
@@ -0,0 +1,47 @@
+---
+title: "プロキシを介したインターネットへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+  - "グローバル プロキシ インスタンス"
+  - "データ要求、プロキシ インスタンス"
+  - "送信 (データを)、プロキシ インスタンス"
+  - "Web プロキシ"
+  - "受信 (データを)、プロキシ インスタンス"
+  - "要求 (インターネットからデータを)、プロキシ インスタンス"
+  - "インターネット、プロキシ インスタンス"
+  - "ネットワーク リソース"
+ms.assetid: cbf46f63-ce28-486d-b827-ec0f1a9d8319
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# プロキシを介したインターネットへのアクセス
+インターネットへのアクセスを提供するために、サービスが拠点プロキシを使用して Web プロキシと通信するユーザーのアプリケーションを有効にする場合は、プロキシ インスタンスをコンフィギュレーションする必要があります。  
+  
+ ここでは、次のトピックについて説明します。  
+  
+-   [プロキシ コンフィギュレーション](../../../docs/framework/network-programming/proxy-configuration.md)  
+  
+-   [自動プロキシ検出](../../../docs/framework/network-programming/automatic-proxy-detection.md)  
+  
+-   [方法: WebRequest でインターネットとの通信にプロキシを使用できるようにする](../../../docs/framework/network-programming/how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md)  
+  
+-   [方法: グローバル プロキシの選択をオーバーライドする](../../../docs/framework/network-programming/how-to-override-a-global-proxy-selection.md)  
+  
+## 参照  
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)   
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/asynchronous-client-socket-example.md b/docs/framework/network-programming/asynchronous-client-socket-example.md
new file mode 100644
index 00000000000..e3abe030b7e
--- /dev/null
+++ b/docs/framework/network-programming/asynchronous-client-socket-example.md
@@ -0,0 +1,334 @@
+---
+title: "非同期クライアント ソケットの例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非同期クライアント ソケット"
+  - "ソケット、コード例"
+  - "ソケット、非同期クライアント ソケット"
+ms.assetid: d4ac53a0-b50b-4232-9726-d47d25fcc38a
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 非同期クライアント ソケットの例
+次の例では、サーバーに接続するクライアントを作成します。  クライアントは非同期なソケットして構築ため、サーバーが応答を戻すと、クライアント アプリケーションの実行が中断されません。  アプリケーション サーバーには、文字列を送信し、次にコンソール サーバーによって返された文字列が表示されます。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Threading  
+Imports System.Text  
+  
+' State object for receiving data from remote device.  
+  
+Public Class StateObject  
+    ' Client socket.  
+    Public workSocket As Socket = Nothing  
+    ' Size of receive buffer.  
+    Public Const BufferSize As Integer = 256  
+    ' Receive buffer.  
+    Public buffer(BufferSize) As Byte  
+    ' Received data string.  
+    Public sb As New StringBuilder  
+End Class 'StateObject  
+  
+Public Class AsynchronousClient  
+    ' The port number for the remote device.  
+    Private Const port As Integer = 11000  
+  
+    ' ManualResetEvent instances signal completion.  
+    Private Shared connectDone As New ManualResetEvent(False)  
+    Private Shared sendDone As New ManualResetEvent(False)  
+    Private Shared receiveDone As New ManualResetEvent(False)  
+  
+    ' The response from the remote device.  
+    Private Shared response As String = String.Empty  
+  
+    Public Shared Sub Main()  
+        ' Establish the remote endpoint for the socket.  
+        ' For this example use local machine.  
+        Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+        Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+        Dim remoteEP As New IPEndPoint(ipAddress, port)  
+  
+        ' Create a TCP/IP socket.  
+        Dim client As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)  
+  
+        ' Connect to the remote endpoint.  
+        client.BeginConnect(remoteEP, New AsyncCallback(AddressOf ConnectCallback), client)  
+  
+        ' Wait for connect.  
+        connectDone.WaitOne()  
+  
+        ' Send test data to the remote device.  
+        Send(client, "This is a test<EOF>")  
+        sendDone.WaitOne()  
+  
+        ' Receive the response from the remote device.  
+        Receive(client)  
+        receiveDone.WaitOne()  
+  
+        ' Write the response to the console.  
+        Console.WriteLine("Response received : {0}", response)  
+  
+        ' Release the socket.  
+        client.Shutdown(SocketShutdown.Both)  
+        client.Close()  
+    End Sub 'Main  
+  
+    Private Shared Sub ConnectCallback(ByVal ar As IAsyncResult)  
+        ' Retrieve the socket from the state object.  
+        Dim client As Socket = CType(ar.AsyncState, Socket)  
+  
+        ' Complete the connection.  
+        client.EndConnect(ar)  
+  
+        Console.WriteLine("Socket connected to {0}", client.RemoteEndPoint.ToString())  
+  
+        ' Signal that the connection has been made.  
+        connectDone.Set()  
+    End Sub 'ConnectCallback  
+  
+    Private Shared Sub Receive(ByVal client As Socket)  
+  
+        ' Create the state object.  
+        Dim state As New StateObject  
+        state.workSocket = client  
+  
+        ' Begin receiving the data from the remote device.  
+        client.BeginReceive(state.buffer, 0, StateObject.BufferSize, 0, New AsyncCallback(AddressOf ReceiveCallback), state)  
+    End Sub 'Receive  
+  
+    Private Shared Sub ReceiveCallback(ByVal ar As IAsyncResult)  
+  
+        ' Retrieve the state object and the client socket   
+        ' from the asynchronous state object.  
+        Dim state As StateObject = CType(ar.AsyncState, StateObject)  
+        Dim client As Socket = state.workSocket  
+  
+        ' Read data from the remote device.  
+        Dim bytesRead As Integer = client.EndReceive(ar)  
+  
+        If bytesRead > 0 Then  
+            ' There might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(state.buffer, 0, bytesRead))  
+  
+            ' Get the rest of the data.  
+            client.BeginReceive(state.buffer, 0, StateObject.BufferSize, 0, New AsyncCallback(AddressOf ReceiveCallback), state)  
+        Else  
+            ' All the data has arrived; put it in response.  
+            If state.sb.Length > 1 Then  
+                response = state.sb.ToString()  
+            End If  
+            ' Signal that all bytes have been received.  
+            receiveDone.Set()  
+        End If  
+    End Sub 'ReceiveCallback  
+  
+    Private Shared Sub Send(ByVal client As Socket, ByVal data As String)  
+        ' Convert the string data to byte data using ASCII encoding.  
+        Dim byteData As Byte() = Encoding.ASCII.GetBytes(data)  
+  
+        ' Begin sending the data to the remote device.  
+        client.BeginSend(byteData, 0, byteData.Length, 0, New AsyncCallback(AddressOf SendCallback), client)  
+    End Sub 'Send  
+  
+    Private Shared Sub SendCallback(ByVal ar As IAsyncResult)  
+        ' Retrieve the socket from the state object.  
+        Dim client As Socket = CType(ar.AsyncState, Socket)  
+  
+        ' Complete sending the data to the remote device.  
+        Dim bytesSent As Integer = client.EndSend(ar)  
+        Console.WriteLine("Sent {0} bytes to server.", bytesSent)  
+  
+        ' Signal that all bytes have been sent.  
+        sendDone.Set()  
+    End Sub 'SendCallback  
+End Class 'AsynchronousClient  
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Threading;  
+using System.Text;  
+  
+// State object for receiving data from remote device.  
+public class StateObject {  
+    // Client socket.  
+    public Socket workSocket = null;  
+    // Size of receive buffer.  
+    public const int BufferSize = 256;  
+    // Receive buffer.  
+    public byte[] buffer = new byte[BufferSize];  
+    // Received data string.  
+    public StringBuilder sb = new StringBuilder();  
+}  
+  
+public class AsynchronousClient {  
+    // The port number for the remote device.  
+    private const int port = 11000;  
+  
+    // ManualResetEvent instances signal completion.  
+    private static ManualResetEvent connectDone =   
+        new ManualResetEvent(false);  
+    private static ManualResetEvent sendDone =   
+        new ManualResetEvent(false);  
+    private static ManualResetEvent receiveDone =   
+        new ManualResetEvent(false);  
+  
+    // The response from the remote device.  
+    private static String response = String.Empty;  
+  
+    private static void StartClient() {  
+        // Connect to a remote device.  
+        try {  
+            // Establish the remote endpoint for the socket.  
+            // The name of the   
+            // remote device is "host.contoso.com".  
+            IPHostEntry ipHostInfo = Dns.Resolve("host.contoso.com");  
+            IPAddress ipAddress = ipHostInfo.AddressList[0];  
+            IPEndPoint remoteEP = new IPEndPoint(ipAddress, port);  
+  
+            // Create a TCP/IP socket.  
+            Socket client = new Socket(AddressFamily.InterNetwork,  
+                SocketType.Stream, ProtocolType.Tcp);  
+  
+            // Connect to the remote endpoint.  
+            client.BeginConnect( remoteEP,   
+                new AsyncCallback(ConnectCallback), client);  
+            connectDone.WaitOne();  
+  
+            // Send test data to the remote device.  
+            Send(client,"This is a test<EOF>");  
+            sendDone.WaitOne();  
+  
+            // Receive the response from the remote device.  
+            Receive(client);  
+            receiveDone.WaitOne();  
+  
+            // Write the response to the console.  
+            Console.WriteLine("Response received : {0}", response);  
+  
+            // Release the socket.  
+            client.Shutdown(SocketShutdown.Both);  
+            client.Close();  
+  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    private static void ConnectCallback(IAsyncResult ar) {  
+        try {  
+            // Retrieve the socket from the state object.  
+            Socket client = (Socket) ar.AsyncState;  
+  
+            // Complete the connection.  
+            client.EndConnect(ar);  
+  
+            Console.WriteLine("Socket connected to {0}",  
+                client.RemoteEndPoint.ToString());  
+  
+            // Signal that the connection has been made.  
+            connectDone.Set();  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    private static void Receive(Socket client) {  
+        try {  
+            // Create the state object.  
+            StateObject state = new StateObject();  
+            state.workSocket = client;  
+  
+            // Begin receiving the data from the remote device.  
+            client.BeginReceive( state.buffer, 0, StateObject.BufferSize, 0,  
+                new AsyncCallback(ReceiveCallback), state);  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    private static void ReceiveCallback( IAsyncResult ar ) {  
+        try {  
+            // Retrieve the state object and the client socket   
+            // from the asynchronous state object.  
+            StateObject state = (StateObject) ar.AsyncState;  
+            Socket client = state.workSocket;  
+  
+            // Read data from the remote device.  
+            int bytesRead = client.EndReceive(ar);  
+  
+            if (bytesRead > 0) {  
+                // There might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(state.buffer,0,bytesRead));  
+  
+                // Get the rest of the data.  
+                client.BeginReceive(state.buffer,0,StateObject.BufferSize,0,  
+                    new AsyncCallback(ReceiveCallback), state);  
+            } else {  
+                // All the data has arrived; put it in response.  
+                if (state.sb.Length > 1) {  
+                    response = state.sb.ToString();  
+                }  
+                // Signal that all bytes have been received.  
+                receiveDone.Set();  
+            }  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    private static void Send(Socket client, String data) {  
+        // Convert the string data to byte data using ASCII encoding.  
+        byte[] byteData = Encoding.ASCII.GetBytes(data);  
+  
+        // Begin sending the data to the remote device.  
+        client.BeginSend(byteData, 0, byteData.Length, 0,  
+            new AsyncCallback(SendCallback), client);  
+    }  
+  
+    private static void SendCallback(IAsyncResult ar) {  
+        try {  
+            // Retrieve the socket from the state object.  
+            Socket client = (Socket) ar.AsyncState;  
+  
+            // Complete sending the data to the remote device.  
+            int bytesSent = client.EndSend(ar);  
+            Console.WriteLine("Sent {0} bytes to server.", bytesSent);  
+  
+            // Signal that all bytes have been sent.  
+            sendDone.Set();  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    public static int Main(String[] args) {  
+        StartClient();  
+        return 0;  
+    }  
+}  
+```  
+  
+## 参照  
+ [非同期サーバー ソケットの例](../../../docs/framework/network-programming/asynchronous-server-socket-example.md)   
+ [同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-server-socket.md)   
+ [ソケットのコード例](../../../docs/framework/network-programming/socket-code-examples.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/asynchronous-server-socket-example.md b/docs/framework/network-programming/asynchronous-server-socket-example.md
new file mode 100644
index 00000000000..b5e762c1577
--- /dev/null
+++ b/docs/framework/network-programming/asynchronous-server-socket-example.md
@@ -0,0 +1,308 @@
+---
+title: "非同期サーバー ソケットの例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ソケット、非同期サーバー ソケット"
+  - "ソケット、コード例"
+  - "非同期サーバー ソケット"
+ms.assetid: 13624cd3-f5c5-4950-8cda-31273b1fa6d1
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# 非同期サーバー ソケットの例
+次の例では、クライアントから接続要求を受け取るサーバーを作成します。  サーバーはソケット非同期な構築しているので、クライアントから接続を待つ間、サーバー アプリケーションの実行が中断されません。  アプリケーションはクライアントの文字列が表示され、コンソールの文字列を表示し、クライアントには文字列をエコーします。  The string クライアントから文字列「」を\<EOF\>メッセージの終了を通知するために含める必要があります。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Text  
+Imports System.Threading  
+Imports Microsoft.VisualBasic  
+  
+' State object for reading client data asynchronously  
+  
+Public Class StateObject  
+    ' Client  socket.  
+    Public workSocket As Socket = Nothing  
+    ' Size of receive buffer.  
+    Public Const BufferSize As Integer = 1024  
+    ' Receive buffer.  
+    Public buffer(BufferSize) As Byte  
+    ' Received data string.  
+    Public sb As New StringBuilder  
+End Class 'StateObject  
+  
+Public Class AsynchronousSocketListener  
+    ' Thread signal.  
+    Public Shared allDone As New ManualResetEvent(False)  
+  
+    ' This server waits for a connection and then uses  asychronous operations to  
+    ' accept the connection, get data from the connected client,   
+    ' echo that data back to the connected client.  
+    ' It then disconnects from the client and waits for another client.   
+    Public Shared Sub Main()  
+        ' Data buffer for incoming data.  
+        Dim bytes() As Byte = New [Byte](1023) {}  
+  
+        ' Establish the local endpoint for the socket.  
+        Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+        Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+        Dim localEndPoint As New IPEndPoint(ipAddress, 11000)  
+  
+        ' Create a TCP/IP socket.  
+        Dim listener As New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)  
+  
+        ' Bind the socket to the local endpoint and listen for incoming connections.  
+        listener.Bind(localEndPoint)  
+        listener.Listen(100)  
+  
+        While True  
+            ' Set the event to nonsignaled state.  
+            allDone.Reset()  
+  
+            ' Start an asynchronous socket to listen for connections.  
+            Console.WriteLine("Waiting for a connection...")  
+            listener.BeginAccept(New AsyncCallback(AddressOf AcceptCallback), listener)  
+  
+            ' Wait until a connection is made and processed before continuing.  
+            allDone.WaitOne()  
+        End While  
+    End Sub 'Main  
+  
+    Public Shared Sub AcceptCallback(ByVal ar As IAsyncResult)  
+        ' Get the socket that handles the client request.  
+        Dim listener As Socket = CType(ar.AsyncState, Socket)  
+        ' End the operation.  
+        Dim handler As Socket = listener.EndAccept(ar)  
+  
+        ' Create the state object for the async receive.  
+        Dim state As New StateObject  
+        state.workSocket = handler  
+        handler.BeginReceive(state.buffer, 0, StateObject.BufferSize, 0, New AsyncCallback(AddressOf ReadCallback), state)  
+    End Sub 'AcceptCallback  
+  
+    Public Shared Sub ReadCallback(ByVal ar As IAsyncResult)  
+        Dim content As String = String.Empty  
+  
+        ' Retrieve the state object and the handler socket  
+        ' from the asynchronous state object.  
+        Dim state As StateObject = CType(ar.AsyncState, StateObject)  
+        Dim handler As Socket = state.workSocket  
+  
+        ' Read data from the client socket.   
+        Dim bytesRead As Integer = handler.EndReceive(ar)  
+  
+        If bytesRead > 0 Then  
+            ' There  might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(state.buffer, 0, bytesRead))  
+  
+            ' Check for end-of-file tag. If it is not there, read   
+            ' more data.  
+            content = state.sb.ToString()  
+            If content.IndexOf("<EOF>") > -1 Then  
+                ' All the data has been read from the   
+                ' client. Display it on the console.  
+                Console.WriteLine("Read {0} bytes from socket. " + vbLf + " Data : {1}", content.Length, content)  
+                ' Echo the data back to the client.  
+                Send(handler, content)  
+            Else  
+                ' Not all data received. Get more.  
+                handler.BeginReceive(state.buffer, 0, StateObject.BufferSize, 0, New AsyncCallback(AddressOf ReadCallback), state)  
+            End If  
+        End If  
+    End Sub 'ReadCallback  
+  
+    Private Shared Sub Send(ByVal handler As Socket, ByVal data As String)  
+        ' Convert the string data to byte data using ASCII encoding.  
+        Dim byteData As Byte() = Encoding.ASCII.GetBytes(data)  
+  
+        ' Begin sending the data to the remote device.  
+        handler.BeginSend(byteData, 0, byteData.Length, 0, New AsyncCallback(AddressOf SendCallback), handler)  
+    End Sub 'Send  
+  
+    Private Shared Sub SendCallback(ByVal ar As IAsyncResult)  
+        ' Retrieve the socket from the state object.  
+        Dim handler As Socket = CType(ar.AsyncState, Socket)  
+  
+        ' Complete sending the data to the remote device.  
+        Dim bytesSent As Integer = handler.EndSend(ar)  
+        Console.WriteLine("Sent {0} bytes to client.", bytesSent)  
+  
+        handler.Shutdown(SocketShutdown.Both)  
+        handler.Close()  
+        ' Signal the main thread to continue.  
+        allDone.Set()  
+    End Sub 'SendCallback  
+End Class 'AsynchronousSocketListener  
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Text;  
+using System.Threading;  
+  
+// State object for reading client data asynchronously  
+public class StateObject {  
+    // Client  socket.  
+    public Socket workSocket = null;  
+    // Size of receive buffer.  
+    public const int BufferSize = 1024;  
+    // Receive buffer.  
+    public byte[] buffer = new byte[BufferSize];  
+// Received data string.  
+    public StringBuilder sb = new StringBuilder();    
+}  
+  
+public class AsynchronousSocketListener {  
+    // Thread signal.  
+    public static ManualResetEvent allDone = new ManualResetEvent(false);  
+  
+    public AsynchronousSocketListener() {  
+    }  
+  
+    public static void StartListening() {  
+        // Data buffer for incoming data.  
+        byte[] bytes = new Byte[1024];  
+  
+        // Establish the local endpoint for the socket.  
+        // The DNS name of the computer  
+        // running the listener is "host.contoso.com".  
+        IPHostEntry ipHostInfo = Dns.Resolve(Dns.GetHostName());  
+        IPAddress ipAddress = ipHostInfo.AddressList[0];  
+        IPEndPoint localEndPoint = new IPEndPoint(ipAddress, 11000);  
+  
+        // Create a TCP/IP socket.  
+        Socket listener = new Socket(AddressFamily.InterNetwork,  
+            SocketType.Stream, ProtocolType.Tcp );  
+  
+        // Bind the socket to the local endpoint and listen for incoming connections.  
+        try {  
+            listener.Bind(localEndPoint);  
+            listener.Listen(100);  
+  
+            while (true) {  
+                // Set the event to nonsignaled state.  
+                allDone.Reset();  
+  
+                // Start an asynchronous socket to listen for connections.  
+                Console.WriteLine("Waiting for a connection...");  
+                listener.BeginAccept(   
+                    new AsyncCallback(AcceptCallback),  
+                    listener );  
+  
+                // Wait until a connection is made before continuing.  
+                allDone.WaitOne();  
+            }  
+  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+  
+        Console.WriteLine("\nPress ENTER to continue...");  
+        Console.Read();  
+  
+    }  
+  
+    public static void AcceptCallback(IAsyncResult ar) {  
+        // Signal the main thread to continue.  
+        allDone.Set();  
+  
+        // Get the socket that handles the client request.  
+        Socket listener = (Socket) ar.AsyncState;  
+        Socket handler = listener.EndAccept(ar);  
+  
+        // Create the state object.  
+        StateObject state = new StateObject();  
+        state.workSocket = handler;  
+        handler.BeginReceive( state.buffer, 0, StateObject.BufferSize, 0,  
+            new AsyncCallback(ReadCallback), state);  
+    }  
+  
+    public static void ReadCallback(IAsyncResult ar) {  
+        String content = String.Empty;  
+  
+        // Retrieve the state object and the handler socket  
+        // from the asynchronous state object.  
+        StateObject state = (StateObject) ar.AsyncState;  
+        Socket handler = state.workSocket;  
+  
+        // Read data from the client socket.   
+        int bytesRead = handler.EndReceive(ar);  
+  
+        if (bytesRead > 0) {  
+            // There  might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(  
+                state.buffer,0,bytesRead));  
+  
+            // Check for end-of-file tag. If it is not there, read   
+            // more data.  
+            content = state.sb.ToString();  
+            if (content.IndexOf("<EOF>") > -1) {  
+                // All the data has been read from the   
+                // client. Display it on the console.  
+                Console.WriteLine("Read {0} bytes from socket. \n Data : {1}",  
+                    content.Length, content );  
+                // Echo the data back to the client.  
+                Send(handler, content);  
+            } else {  
+                // Not all data received. Get more.  
+                handler.BeginReceive(state.buffer, 0, StateObject.BufferSize, 0,  
+                new AsyncCallback(ReadCallback), state);  
+            }  
+        }  
+    }  
+  
+    private static void Send(Socket handler, String data) {  
+        // Convert the string data to byte data using ASCII encoding.  
+        byte[] byteData = Encoding.ASCII.GetBytes(data);  
+  
+        // Begin sending the data to the remote device.  
+        handler.BeginSend(byteData, 0, byteData.Length, 0,  
+            new AsyncCallback(SendCallback), handler);  
+    }  
+  
+    private static void SendCallback(IAsyncResult ar) {  
+        try {  
+            // Retrieve the socket from the state object.  
+            Socket handler = (Socket) ar.AsyncState;  
+  
+            // Complete sending the data to the remote device.  
+            int bytesSent = handler.EndSend(ar);  
+            Console.WriteLine("Sent {0} bytes to client.", bytesSent);  
+  
+            handler.Shutdown(SocketShutdown.Both);  
+            handler.Close();  
+  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+    }  
+  
+    public static int Main(String[] args) {  
+        StartListening();  
+        return 0;  
+    }  
+}  
+```  
+  
+## 参照  
+ [非同期クライアント ソケットの例](../../../docs/framework/network-programming/asynchronous-client-socket-example.md)   
+ [非同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-server-socket.md)   
+ [ソケットのコード例](../../../docs/framework/network-programming/socket-code-examples.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/automatic-proxy-detection.md b/docs/framework/network-programming/automatic-proxy-detection.md
new file mode 100644
index 00000000000..1c4cc172d52
--- /dev/null
+++ b/docs/framework/network-programming/automatic-proxy-detection.md
@@ -0,0 +1,80 @@
+---
+title: "自動プロキシ検出 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "自動プロキシ検出"
+  - "Web プロキシの自動検出"
+  - "Web プロキシ"
+  - "検出 (プロキシを自動的に)"
+  - "WebProxy クラス、自動プロキシ検出"
+  - "プロキシ、自動検出"
+  - "ネットワーク"
+  - "WPAD (Web プロキシ自動検出)"
+ms.assetid: fcd9c3bd-93de-4c92-8ff3-837327ad18de
+caps.latest.revision: 18
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 18
+---
+# 自動プロキシ検出
+自動プロキシの検出は Web プロキシ サーバーがシステムによって確認され、クライアントに代わって要求を送信するに使用されるプロセスです。  この機能は、WPAD \(Web Proxy Auto\-Discovery\) とも呼ばれます。  自動ときにプロキシの検出、要求に使用できるプロキシのセットを返品する担当プロキシ コンポーネントのスクリプトを探すシステムの再試行有効になります。  プロキシ コンポーネントのスクリプトがある場合は、スクリプトがプロキシ情報、要求のストリーム、つまり回答が <xref:System.Net.WebProxy> のインスタンスを使用する要求に対して取得した場合、コンパイル、ローカル コンピュータのダウンロード実行されます。  
+  
+ 自動プロキシの検出は <xref:System.Net.WebProxy> クラスが実行され、コンフィギュレーション ファイルの要求レベルの設定、Internet Explorer の **\[ローカル エリア ネットワーク \(LAN\)\]** のダイアログ ボックスを使用して指定した設定、および設定を使用することもできます。  
+  
+> [!NOTE]
+>  Internet Explorer のメイン メニューから **\[ツール\]** を選択し、**\[インターネット オプション\]**を選択することにより、Internet Explorer の **\[ローカル エリア ネットワーク \(LAN\) の設定\]** のダイアログ ボックスを表示できます。  次 **\[接続\]**、のタブをクリックし、**\[LAN の設定\]**をクリックします。  
+  
+ 自動ときに検出プロキシには、次のように、スクリプト プロキシのコンフィギュレーションを検索 <xref:System.Net.WebProxy> クラスの再試行有効化されます:  
+  
+1.  WinInet の `InternetQueryOption` 機能が最新 Internet Explorer プロキシのコンフィギュレーションが検出するスクリプトの検索に使用されます。  
+  
+2.  スクリプトが見つけられなければ、<xref:System.Net.WebProxy> クラスは、スクリプトの検索に動的ホスト コンフィギュレーション Protocol \(DHCP\) を使用します。  DHCP サーバー、スクリプトの場所 \(ホスト名\) またはスクリプトの完全な URL と応答できます。  
+  
+3.  DHCP が WPAD のホストを識別する名前は、DNS またはエイリアスとして WPAD のホストにただされます。  
+  
+4.  ホストされていないプロキシを識別し、コンフィギュレーションのスクリプトの場所が Internet Explorer の LAN 設定やコンフィギュレーション ファイルを使用して指定されている場合、この場所が使用されます。  
+  
+> [!NOTE]
+>  NT として実行が開始アプリケーションのユーザーの Internet Explorer のプロキシ サーバーの設定 \(利用可能な場合\) サービスまたは ASP.NET の一部として使用されます。  これらの設定は、すべてのサービス アプリケーションに使用可能ではない場合があります。  
+  
+ プロキシに基づいて単位で connectoid でコンフィギュレーションされます。  connectoid は、ネットワーク接続ダイアログの品目で、物理ネットワークのデバイス \(またはモデム イーサネット カード\) または仮想のインターフェイスのいずれかです \(ネットワークのデバイスに実行の接続 VPN など\)。  connectoid が \(たとえば、無線接続がアクセス ポイントを変更、または VPN が有効になります\) 変更すると、プロキシの検出のアルゴリズムを再度実行されます。  
+  
+ 既定では、Internet Explorer のプロキシ設定がプロキシを検出するために使用されます。  自分のアプリケーションが非対話型アカウントで \(IE プロキシの設定をコンフィギュレーションする便利な方法で\) を実行中または IE の設定とは異なるプロキシ設定を使用する場合は、定義された [\<defaultProxy\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md) と [\<proxy\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/proxy-element-network-settings.md) の要素でコンフィギュレーション ファイルの作成に応じて、プロキシをコンフィギュレーションできます。  
+  
+ 作成した要求の場合、次のコード例で示すように要求を含む空白の <xref:System.Net.WebRequest.Proxy%2A> を使用して、レベル自動プロキシの検出を依頼して無効にすることができます。  
+  
+```csharp  
+public static void DisableForMyRequest (Uri resource)  
+{  
+    WebRequest request = WebRequest.Create (resource);  
+    request.Proxy = null;  
+    WebResponse response = request.GetResponse ();  
+}  
+```  
+  
+```vb  
+Public Shared Sub DisableForMyRequest(ByVal resource As Uri)  
+    Dim request As WebRequest = WebRequest.Create(resource)  
+    request.Proxy = Nothing  
+    Dim response As WebResponse = request.GetResponse()  
+    End Sub   
+```  
+  
+ <xref:System.Net.WebRequest.DefaultWebProxy%2A> のプロパティに使用可能であるプロキシの使用が自分のアプリケーション ドメインの既定のプロキシない要求。  
+  
+## 参照  
+ <xref:System.Net.WebProxy>   
+ <xref:System.Net.WebRequest>   
+ [\<system.Net\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/basic-and-digest-authentication.md b/docs/framework/network-programming/basic-and-digest-authentication.md
new file mode 100644
index 00000000000..75508c754ab
--- /dev/null
+++ b/docs/framework/network-programming/basic-and-digest-authentication.md
@@ -0,0 +1,58 @@
+---
+title: "基本認証とダイジェスト認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "認証 [.NET Framework]、クラス"
+  - "基本認証"
+  - "認証 [.NET Framework]、基本"
+  - "クライアント認証、基本"
+  - "ユーザー認証、基本"
+  - "認証 [.NET Framework]、ダイジェスト"
+  - "受信 (データの)、認証"
+  - "クライアント認証、ダイジェスト"
+  - "インターネット、認証"
+  - "ダイジェスト認証"
+  - "送信 (データの)、認証"
+  - "ネットワーク リソース、認証"
+  - "ユーザー認証、ダイジェスト"
+ms.assetid: 8cce2742-8d52-4643-9dd2-64ddf38aa878
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 基本認証とダイジェスト認証
+基本とダイジェストの認証を <xref:System.Net> の実装に RFC2617 – HTTP 認証に従います。: \(www.w3.org から World Wide Web コンソーシアム Web サイトで使用可能\) 基本およびダイジェスト認証。  
+  
+ 基本とダイジェスト認証を使用するには、アプリケーションは次の例で示すように、インターネットからデータを要求する <xref:System.Net.WebRequest> のオブジェクトの <xref:System.Net.WebRequest.Credentials%2A> のプロパティのユーザー名とパスワードを指定する必要があります。  
+  
+```vb  
+Dim MyURI As String = "http://www.contoso.com/"  
+Dim WReq As WebRequest = WebRequest.Create(MyURI)  
+WReq.Credentials = New NetworkCredential(UserName, SecurelyStoredPassword)  
+```  
+  
+```csharp  
+String MyURI = "http://www.contoso.com/";  
+WebRequest WReq = WebRequest.Create(MyURI);  
+WReq.Credentials = new NetworkCredential(UserName, SecurelyStoredPassword);  
+```  
+  
+> [!CAUTION]
+>  基本認証およびダイジェストに送信されるデータを暗号化いないため、データは敵対者で表示できます。  また、基本認証の資格情報は、ユーザー名とパスワード\) 明確に送信され、横取りできます。  
+  
+## 参照  
+ [NTLM 認証および Kerberos 認証](../../../docs/framework/network-programming/ntlm-and-kerberos-authentication.md)   
+ [インターネット認証](../../../docs/framework/network-programming/internet-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/best-practices-for-system-net-classes.md b/docs/framework/network-programming/best-practices-for-system-net-classes.md
new file mode 100644
index 00000000000..348255cdb22
--- /dev/null
+++ b/docs/framework/network-programming/best-practices-for-system-net-classes.md
@@ -0,0 +1,44 @@
+---
+title: "System.Net クラスのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ送信、ベスト プラクティス"
+  - "要求 (インターネットからデータを)、ベスト プラクティス"
+  - "WebRequest クラス、ベスト プラクティス"
+  - "データ要求、ベスト プラクティス"
+  - "WebResponse クラス、ベスト プラクティス"
+  - "ベスト プラクティス、データ要求"
+  - "データ受信、ベスト プラクティス"
+ms.assetid: 716decc6-5952-47b7-9c5a-ba6fc5698684
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# System.Net クラスのベスト プラクティス
+次の推奨で最適な利点に <xref:System.Net> に含まれているクラスを使用できます:  
+  
+-   子孫クラスにキャスト型の代わりに <xref:System.Net.WebRequest> 可能な場合、<xref:System.Net.WebResponse> を使用します。  **\[WebRequest\]** と **WebResponse** を使用するアプリケーションは広範なコードは必要ではありません変更、新しいインターネット プロトコルを使用できます。  
+  
+-   **\[System.Net\]** クラスを使用しているサーバーで実行 ASP.NET のアプリケーションを書き込む場合 <xref:System.Net.WebRequest.GetResponse%2A> と <xref:System.Net.WebResponse.GetResponseStream%2A>に対して非同期な方法を使用するには、通常、パフォーマンスの視点から、ほど。  
+  
+-   開くインターネットのリソースへの接続数は、ネットワーク パフォーマンス、スループットの重要な影響することができます。  **\[System.Net\]** がホストごとのアプリケーションごとの 2 種類の接続を既定で使用されます。  自分のアプリケーションの <xref:System.Net.ServicePoint> の <xref:System.Net.ServicePoint.ConnectionLimit%2A> のプロパティの設定はホストするには、この数は、増やすことができます。  <xref:System.Net.ServicePointManager.DefaultPersistentConnectionLimit?displayProperty=fullName> のプロパティを設定すると、すべてのホストするために、この既定値を高めることができます。  
+  
+-   <xref:System.Net.Sockets.Socket>に入力する代わりに [&#91;TCPClient&#93;](frlrfsystemnetsocketstcpclientclasstopic) または [UDPClient](frlrfsystemnetsocketsudpclientclasstopic) を直接可能であれば使用するソケット レベルのセキュリティを書き込んだ場合、送信  これら二つのクラスはクライアント接続の詳細の処理に必要とせずに TCP UDP ソケットの作成をカプセル化。  
+  
+-   資格情報を要求するアクセスと、サービス拠点を使用して、すべての要求を供給する代わりに、資格情報のキャッシュを作成するに <xref:System.Net.CredentialCache> をクラス。  **\[CredentialCache\]** のクラスが URL に基づいて資格情報を作成および表示職責の軽減する要求を示す適切な信任状を検索するようにキャッシュが検索されます。  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/cache-management-for-network-applications.md b/docs/framework/network-programming/cache-management-for-network-applications.md
new file mode 100644
index 00000000000..b27104c170e
--- /dev/null
+++ b/docs/framework/network-programming/cache-management-for-network-applications.md
@@ -0,0 +1,50 @@
+---
+title: "ネットワーク アプリケーションのキャッシュ管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "キャッシュ [.NET Framework]、ネットワーク アプリケーション"
+  - "ネットワーク リソース、キャッシュ"
+  - "インターネット、キャッシュ"
+ms.assetid: fc258a40-f370-434f-ae09-4a8cb11ddaeb
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# ネットワーク アプリケーションのキャッシュ管理
+このトピックでは、関連のサブトピック <xref:System.Net.WebClient>、<xref:System.Net.WebRequest>、<xref:System.Net.HttpWebRequest>と <xref:System.Net.FtpWebRequest> クラスを使用して派生リソースに対してキャッシュについて説明します。  
+  
+ キャッシュとは、アプリケーションによって要求されたリソースの一時的なストレージです。  アプリケーションで同じリソースを複数回必要な場合は、リソースがサーバーからの再の間接費要求を回避キャッシュから返されるできます。  キャッシュが必要な時間を小さくすると要求されたリソースを取得するためにアプリケーションのパフォーマンスが向上します。  キャッシュは、サーバーに出張の数を減らすことにより、ネットワーク トラフィックを減らすことができます。  キャッシュすることはパフォーマンスを改善するときに、アプリケーションに戻るリソースが古いキャッシュして使用中の場合と送信サーバーによってリソースに同一でないことを意味するリスクを強化します。  
+  
+ キャッシュは無許可のユーザーまたはプロセスが機密データの読み取りようにする場合があります。  キャッシュ Windows 認証された応答は追加の認証なしでキャッシュから取得される場合があります。  キャッシュすることが有効になっている場合、この要求のキャッシュを無効にする <xref:System.Net.Cache.RequestCacheLevel> または <xref:System.Net.Cache.RequestCacheLevel> に <xref:System.Net.WebRequest.CachePolicy%2A> の変更。  
+  
+ 安保問題により、キャッシュすると、中間層のシナリオで推奨される **not** です。  
+  
+## このセクションの内容  
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)  
+ キャッシュされたもののポリシーと 1 種類を定義する方法について説明します。  
+  
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)  
+ アプリケーション転送プロトコル \(https\) http およびリソースの場所に基づくキャッシュのポリシーに使用可能な各タイプを定義します。  
+  
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)  
+ 時間ベースのキャッシュのポリシーをカスタマイズするために使用できる条件について説明します。  
+  
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)  
+ プログラムでは、キャッシュのポリシーを作成する方法について、キャッシュ使用する必要があります。  
+  
+## 関連項目  
+ <xref:System.Net.Cache>  
+ <xref:System.Net.WebRequest>、<xref:System.Net.HttpWebRequest>と <xref:System.Net.FtpWebRequest> クラスを使用して派生したリソースのキャッシュのポリシーを定義するために使用された型および列挙型を定義します。
\ No newline at end of file
diff --git a/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-maximum-staleness.md b/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-maximum-staleness.md
new file mode 100644
index 00000000000..28a0438e0e7
--- /dev/null
+++ b/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-maximum-staleness.md
@@ -0,0 +1,54 @@
+---
+title: "キャッシュ ポリシーの相互作用 — 最大有効期間と最大期限延長 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "最大期限延長"
+  - "キャッシュされたリソースの更新の確認間隔"
+  - "時間、キャッシュされたリソース"
+  - "最大保存期間ポリシー"
+  - "キャッシュされたリソースの期限からの経過期間"
+  - "キャッシュされたリソースの経過期間"
+ms.assetid: 7f775925-89a1-4956-ba90-c869c1749a94
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# キャッシュ ポリシーの相互作用 — 最大有効期間と最大期限延長
+最も新しいコンテンツがクライアント アプリケーションに戻ることを保証するには、のクライアントのキャッシュ ポリシーの相互作用とサーバーの revalidation の条件は、保守的なキャッシュのポリシーは常になります。  このトピックのすべての例は 1 年 1 月 1 日にキャッシュされ、1 年 4.日が切れるリソースのキャッシュのポリシーについて説明します。  
+  
+ 次の例では、最大 staleness の値 \(`maxStale`\) は、最大期日が経過する \(`maxAge`\) とともに使用されます:  
+  
+-   キャッシュのポリシーが `maxAge` \= 5 日時を指定する必要 `maxStale` の値は、`maxAge` の値に応じて、コンテンツ月 1 日まで 6.使用できます。  ただし、サーバーの revalidation 要件に基づいて、内容が 1 年 3 月 4 日に期限が切れます。.  コンテンツ有効期限は、保守的 \(すぐに\) であるため、`maxAge` ポリシーよりも優先されます。  したがって、内容は 1 年 12 月 4 日に最大期日が経過するが達成されていない場合でも、revalidated 切れ必要があります。  
+  
+-   キャッシュ ポリシーのセットが `maxAge` \= 5 日と `maxStale` \= 3 日、`maxAge` の値に応じて、コンテンツ月 1 日まで 6.使用可能な場合\)。  `maxStale` の値に応じて、内容が 1.月 7 日まで使用できます。  したがって、内容は月 1 日に 6. revalidated 表示されます。  
+  
+-   キャッシュ ポリシーのセットが `maxAge` \= 5 日と `maxStale` \= 1 日、`maxAge` の値に応じて、コンテンツ月 1 日まで 6.使用可能な場合\)。  `maxStale` の値に応じて、内容が 1.月 5 日まで使用できます。  したがって、内容は月 1 日に 5. revalidated 表示されます。  
+  
+ 最大期日が経過したコンテンツ有効期限未満の場合より、キャッシュの保守的な動作は常にや、最大の staleness の値は無効です。  次の例では、内容が期限切れに最大期日が経過する \(`maxAge`\) に達すると、最大 staleness \(`maxStale`\) の値を設定する場合の影響を示しています:  
+  
+-   キャッシュのポリシーが `maxAge` を \= 1 日時、`maxStale` の値の値を指定する、内容が 1 年 3 月 2 日に期限切れになっていない準備して revalidated。  
+  
+-   より保守的なポリシーの設定を適用するキャッシュのポリシーの設定`maxAge` が 1 年 3 月 2 日に \= 1 日と `maxStale` \= 3 日、内容 revalidated。  
+  
+-   キャッシュ ポリシーのセット `maxAge` が 1 年 3 月 2 日に. \= 1 日と `maxStale` \= 1 日、内容 revalidated。  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)   
+ [キャッシュ ポリシーの相互作用 — 最大有効期間と最小鮮度](../../../docs/framework/network-programming/cache-policy-interaction-maximum-age-and-minimum-freshness.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-minimum-freshness.md b/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-minimum-freshness.md
new file mode 100644
index 00000000000..c826cd21058
--- /dev/null
+++ b/docs/framework/network-programming/cache-policy-interaction-maximum-age-and-minimum-freshness.md
@@ -0,0 +1,47 @@
+---
+title: "キャッシュ ポリシーの相互作用 — 最大有効期間と最小鮮度 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "時間ベースのキャッシュ ポリシー"
+  - "再検証ポリシー"
+  - "キャッシュ [.NET Framework]、時間ベースのポリシー"
+  - "キャッシュされたリソースの鮮度"
+  - "最大有効期間ポリシー"
+  - "最小鮮度ポリシー"
+  - "キャッシュされたリソースの経過期間"
+ms.assetid: 6567d451-ecec-496c-95a3-a415b99ba52a
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# キャッシュ ポリシーの相互作用 — 最大有効期間と最小鮮度
+最も新しいコンテンツがクライアント アプリケーションに戻ることを保証するには、のクライアントのキャッシュ ポリシーの相互作用とサーバーの revalidation の条件は、保守的なキャッシュのポリシーは常になります。  このトピックのすべての例は 1 年 1 月 1 日にキャッシュされ、1 年 4.日が切れるリソースのキャッシュのポリシーについて説明します。  
+  
+ 次の例は、最大期日が経過する \(`maxAge`\)、最小新鮮さ \(`minFresh`\) の値の相互作用の結果キャッシュのポリシーについて説明します。  
+  
+-   キャッシュのポリシーが `maxAge` を \= 2 日時、`minFresh` が指定されていない場合、内容が 1 年 3 月 3 日に revalidated。.  
+  
+-   キャッシュ ポリシーのセットが `maxAge` \= 2 日と `minFresh` \= 1 日、`maxAge`内容に従って、1 年 12 月 3 日まで新しければ。.  `minFresh`に従って、内容が 1 年 3 月 3 日まで新しいです。.  したがって、内容は月 1 日に 3. revalidated 必要があります。  
+  
+-   キャッシュ ポリシーのセットが `maxAge`\= 2 日と `minFresh` \= 2 日、`maxAge`内容に従って、1 年 12 月 3 日まで新しければ。.  `minFresh` に従って内容は 1 年 12 月 2 日まで新しいです。.  したがって、内容は月 1 日に 2. revalidated 必要があります。  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)   
+ [キャッシュ ポリシーの相互作用 — 最大有効期間と最大期限延長](../../../docs/framework/network-programming/cache-policy-interaction-maximum-age-and-maximum-staleness.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/cache-policy.md b/docs/framework/network-programming/cache-policy.md
new file mode 100644
index 00000000000..ea2b465b604
--- /dev/null
+++ b/docs/framework/network-programming/cache-policy.md
@@ -0,0 +1,55 @@
+---
+title: "キャッシュ ポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "時間ベースのキャッシュ ポリシー"
+  - "場所ベースのキャッシュ ポリシー"
+  - "キャッシュ [.NET Framework]、ポリシー"
+  - "要求のキャッシュ ポリシー"
+  - "キャッシュされたリソースの鮮度"
+  - "コンテンツのキャッシュ ポリシー"
+  - "期限切れのコンテンツ"
+ms.assetid: 1a7e04ec-7872-41c2-96c6-52566dcb412b
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# キャッシュ ポリシー
+要求されたリソースのキャッシュ コピーで要求を満たせるかどうかの判断は、キャッシュ ポリシーによって定義した規則に基づいて行われます。  アプリケーションは新鮮さのクライアントのキャッシュ要件を指定しますが、有効なキャッシュのポリシーは、クライアントのキャッシュ要件、サーバーのコンテンツ有効期限の条件とサーバーの revalidation の条件によって決まります。  クライアントとサーバーのキャッシュのポリシー要件の相互作用が、保守的なキャッシュ ポリシーに、新しいコンテンツがクライアント アプリケーションに戻ることを保証するために、常になります。  
+  
+ キャッシュのポリシーは、場所ベースまたは時間ベースです。  場所に基づくキャッシュのポリシーに基づいてキャッシュされたエントリ要求されたリソースのソースにから取得できるかの新鮮さを定義します。  時間ベースのキャッシュのポリシーは、リソースが取得されたリソースで返される時間、ヘッダー、現在時間を使用してキャッシュされたエントリの新鮮さを定義します。  ほとんどのアプリケーションは RFC 2616 で指定されたキャッシュのポリシーを実装する既定の時間ベースのキャッシュのポリシー、使用可能な [http:\/\/www.ietf.org](http://www.ietf.org/)使用できます。  
+  
+ 次の表に示すクラスがキャッシュのポリシーを指定するために使用されます。  
+  
+|クラス名|説明|  
+|----------|--------|  
+|<xref:System.Net.Cache.HttpRequestCachePolicy>|<xref:System.Net.HttpWebRequest> のオブジェクトを使用して必要なリソースの場所ベースおよび時間ベースのキャッシュのポリシーを表します。|  
+|<xref:System.Net.Cache.RequestCachePolicy>|場所に基づくキャッシュのポリシーを表しますまたは <xref:System.Net.WebRequest> を使用して必要なリソースの <xref:System.Net.Cache.RequestCacheLevel> の時間ベースのキャッシュのポリシーは、counter します。|  
+|<xref:System.Net.Cache.HttpCacheAgeControl>|<xref:System.Net.Cache.HttpRequestCachePolicy> の時間ベースのオブジェクトを作成するために使用する値を指定します。|  
+|<xref:System.Net.Cache.HttpRequestCacheLevel>|<xref:System.Net.Cache.HttpRequestCachePolicy> の場所ベースおよび時間ベースのオブジェクトを作成するために使用する値を指定します。|  
+|<xref:System.Net.Cache.RequestCacheLevel>|場所ベースの作成に使用される値または <xref:System.Net.Cache.RequestCacheLevel> 時間ベースの <xref:System.Net.Cache.RequestCachePolicy> のオブジェクトを指定します。|  
+  
+ 自分のアプリケーションによるすべての要求または個々のキャッシュのポリシーを定義できます。  アプリケーション レベルのキャッシュのポリシーを指定し、その要求レベルがポリシーをキャッシュすると、要求レベルのポリシーが使用されます。  プログラムで、アプリケーションや機械コンフィギュレーション コンフィギュレーション ファイルを使用してアプリケーション レベルのキャッシュのポリシーを指定できます。  詳細については、「[\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)」を参照してください。  
+  
+ キャッシュのポリシーを作成するには、<xref:System.Net.Cache.RequestCachePolicy> または <xref:System.Net.Cache.HttpRequestCachePolicy> クラス インスタンスの作成によってポリシーのオブジェクトを作成する必要があります。  要求のポリシーを指定するには、ポリシーの対象に要求の <xref:System.Net.WebRequest.CachePolicy%2A> のプロパティを設定します。  アプリケーション レベルのポリシーをプログラムでに設定する場合は、ポリシーの対象に <xref:System.Net.HttpWebRequest.DefaultCachePolicy%2A> のプロパティを設定します。  
+  
+ キャッシュのポリシーを作成し、使用方法を示すコード例では、[ネットワーク アプリケーションのキャッシュのコンフィギュレーション](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)を参照してください。  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/certificate-selection-and-validation.md b/docs/framework/network-programming/certificate-selection-and-validation.md
new file mode 100644
index 00000000000..5dc0a9aefd9
--- /dev/null
+++ b/docs/framework/network-programming/certificate-selection-and-validation.md
@@ -0,0 +1,67 @@
+---
+title: "証明書の選択と検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: c933aca2-4cd0-4ff1-9df9-267143f25a6f
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# 証明書の選択と検証
+<xref:System.Net> クラスを選択する方法がサポートされ、<xref:System.Security.Cryptography.X509Certificates> の検証するには、Secure Socket Layer \(SSL\) 接続の。  クライアントとサーバーにはなくを認証する一つ以上の証明書を選択できます。  サーバーは、クライアントに認証証明書の一つ以上の特定の属性を持つように要求することもできます。  
+  
+## 定義  
+ 証明書は公開キー \(属性、バージョン番号、シリアル番号、有効期限など\) および証明機関からのデジタル署名を含む ASCII のバイト ストリームです。  証明書の暗号化された接続を設定またはサーバーにクライアントを認証するために使用されます。  
+  
+## クライアント証明書の選択と検証  
+ クライアント接続で SSL は、特定の一つ以上の証明書を選択できます。  クライアント証明書は Web サーバーまたは SMTP メール サーバーへの接続 SSL に関連付けることができます。  クライアントが <xref:System.Security.Cryptography.X509Certificates.X509Certificate> または <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> クラス オブジェクト コレクションに資格を追加します。  、例として、電子メールを使用して、証明書の集合 <xref:System.Net.Mail.SmtpClient> クラスの <xref:System.Net.Mail.SmtpClient.ClientCertificates%2A> のプロパティに関連付けられている <xref:System.Security.Cryptography.X509Certificates.X509CertificateCollection>のインスタンスです\)。  <xref:System.Net.HttpWebRequest> クラスに <xref:System.Net.HttpWebRequest.ClientCertificates%2A> の同様のプロパティがあります。  
+  
+ <xref:System.Security.Cryptography.X509Certificates.X509Certificate> と <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> クラス間の主な違いは秘密キーが <xref:System.Security.Cryptography.X509Certificates.X509Certificate> クラスの証明書ストアに存在する必要があります。  
+  
+ 証明書のグループに追加され、SSL が特定の接続に関連付けられている、証明書がサーバーにサーバーがその要求を送信する。  複数のクライアント接続証明書がに設定されている場合、最適な 1 がサーバーによって提供される証明書のフィールドの一覧とクライアント証明書のフィールドの名前との一致を考慮するアルゴリズムに基づいて使用されます。  
+  
+ <xref:System.Net.Security.SslStream> のクラスが SSL のハンドシェイクの設定をさらに詳細提供します。  クライアントは、ピッキングに使用するクライアント証明書委任を指定できます。  
+  
+ リモート サーバーは、クライアント、証明書が有効期限、適切な証明機関によって署名できることを確認できます。  委任は <xref:System.Net.ServicePointManager.ServerCertificateValidationCallback%2A> に証明書の検証を適用するに追加できます。  
+  
+## クライアント証明書の選択  
+ .NET Framework サーバーには次のように表示するクライアント証明書を選択します:  
+  
+1.  クライアント証明書がサーバーに指定された場合、証明書が最初に指定されたときにキャッシュされ、それ以降のクライアント証明書の要求に再利用されます。  
+  
+2.  必須の場合は、選択するにはクライアント証明書として必須の結果を常に使用します。  委任が null 値を返品した証明書のコレクションが空白でない可能な月にキャッシュされた証明書を使用するとしますが、キャッシュされた匿名認証情報を使用しないでください。  
+  
+3.  これがクライアント証明書の最初の課題の場合、フレームワークは <xref:System.Security.Cryptography.X509Certificates.X509Certificate> の証明書またはサーバーで提供される証明書のフィールドの一覧とクライアント証明書のフィールドの名前との一致を検索する接続に関連付けられている <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> オブジェクト クラスを列挙。  一致する最初の証明書はサーバーに送信されます。  証明書が一致していないか、証明書のコレクションが空の場合、匿名信任状はサーバーに送信されます。  
+  
+## 証明書のコンフィギュレーションのツール  
+ いくつかのツールはクライアントとサーバー証明書の構成に使用できます。  
+  
+ *\[Winhttpcertcfg.exe\]* のツールがクライアント証明書をコンフィギュレーションすることもできます。  *\[Winhttpcertcfg.exe\]* のツールは、Windows Server 2003 のリソース キットをツールの 1 種類として指定します。  このツールは www.microsoft.com に Windows Server 2003 のリソースのキットのツールの一部としてダウンロードとしても使用できます。  
+  
+ *HttpCfg.exe* のツールが <xref:System.Net.HttpListener> クラスの証明書サーバーをコンフィギュレーションすることもできます。  *\[HttpCfg.exe\]* のツールは、Windows Server 2003 および Windows XP Service Pack 2 のサポート ツールの 1 種類として入力されます。  *\[HttpCfg.exe\]* サポートなどのツールは、Windows Server 2003 または Windows XP に既定では、インストール。  Windows Server 2003。  サポート ツールは、以下のフォルダとは別に、インストール、Windows Server 2003 のファイル CD\-ROM にします:  
+  
+ \\Support\\Tools\\Suptools.msi  
+  
+ Windows XP Service Pack 2 の使用については、Windows XP サポート ツールは www.microsoft.com からダウンロードとして使用できます。  
+  
+ *\[HttpCfg.exe\]* ツールのバージョンのソース・コードは、Windows Server の SDK としてサンプルを指定します。  *\[HttpCfg.exe\]* のサンプルのソース・コードが次のフォルダの下の Windows SDK の一部としてネットワーキングのサンプルなど既定では、インストール:  
+  
+ *C:\\Program Files\\Microsoft SDKs\\Windows\\v1.0\\Samples\\NetDS\\http\\serviceconfig*  
+  
+ これらのツールに加えて、<xref:System.Security.Cryptography.X509Certificates.X509Certificate> と <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> クラス、ファイル システムから証明書を読み込むする方法を提供します。  
+  
+## 参照  
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)   
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/changes-to-ntlm-authentication-for-httpwebrequest-in-version-3-5-sp1.md b/docs/framework/network-programming/changes-to-ntlm-authentication-for-httpwebrequest-in-version-3-5-sp1.md
new file mode 100644
index 00000000000..83715766a13
--- /dev/null
+++ b/docs/framework/network-programming/changes-to-ntlm-authentication-for-httpwebrequest-in-version-3-5-sp1.md
@@ -0,0 +1,66 @@
+---
+title: "バージョン 3.5 SP1 における HttpWebRequest の NTLM 認証への変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8bf0b428-5a21-4299-8d6e-bf8251fd978a
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# バージョン 3.5 SP1 における HttpWebRequest の NTLM 認証への変更
+.NET Framework Version の 3.5 SP1、後でその影響のセキュリティの変更は、統合 Windows 認証が System.Net の名前空間の <xref:System.Net.HttpWebRequest>、<xref:System.Net.HttpListener>、および関連 <xref:System.Net.Security.NegotiateStream>クラス内をどのように処理されるか。されています。  これらの変更は、Web を要求し、NTLM に基づく統合 Windows 認証が使用される応答を受け取るには、これらのクラスを使用するアプリケーションに影響を与える可能性があります。  この変更は、統合 Windows 認証を使用するようにコンフィギュレーションされているクライアント アプリケーションと Web サーバーに影響を与える可能性があります。  
+  
+## 概要  
+ Windows 統合認証のデザインを使用して、します。クレデンシャルの回答を普遍的にするには、には再利用したりできるようになります。  この特定のデザイン制限は、認証が必要であるプロトコル、ターゲットの特定の情報を伴う、特定の情報をまかなう必要です。  サービスは、クレデンシャルの回答をサービスプリンシパル \(SPN\) 名など、サービス別の情報を含んでいることを確認する拡張保護を提供できます。  クレデンシャル交換にこの情報を使用して、サービスは Administrators に計上する可能性があるクレデンシャルの応答悪意のある使用への対策を上書きできます。  
+  
+ <xref:System.Net> の複数のコンポーネントと <xref:System.Net.Security> の名前空間の名前はアプリケーションに代わって統合 Windows 認証を実行します。  このセクションでは、統合 Windows 認証内の拡張保護を追加するに System.Net のコンポーネントに対する変更について説明します。  
+  
+## 変更  
+ Windows 統合認証に使用する NTLM 認証プロセスは先のコンピュータ設定して問題、クライアント コンピュータにレシート実行する課題が含まれます。  コンピュータがそれ自身を生成した課題を受け取る場合、認証が接続がループバックの接続 \(IPv4 の住所 127.0.0.1 など\) である失敗します。  
+  
+ 内部 Web サーバーで実行中のサービスにアクセスと http:\/\/contoso\/service または https:\/\/contoso\/service と同様に、URL を使用してサービスにアクセスするために、共通です。  名前「」contoso は、多くの場合、サービスの展開 \(コンピュータのコンピュータ名ではありません。  Active Directory、DNS、NetBIOS を使用して <xref:System.Net> および関連する名前空間の場合、ローカル コンピュータのホスト \(通常は WWINDOWS\\system32\\drivers\\etc\\hosts など\) ファイルの名前、住所にを決済する場合は、またはローカル コンピュータの lmhosts \(通常 WINDOWS\\system32\\drivers\\etc\\lmhosts など\) ファイルします。  「」contoso に送信する要求が適切なサーバー コンピューターに送信して名前「」contoso が決済されます。  
+  
+ 大規模な配置用にコンフィギュレーションされたときに、そのは、クライアント アプリケーションおよびエンド ユーザーが使用する的なコンピュータの名前で設定するにつれ、単一の仮想サーバーの名前に、共通ではありません。  たとえば、「」contoso のサーバーと内部ネットワークの単に電話 www.contoso.com する場合があります。  この名前は、クライアントのヘルプのホスト要求のヘッダーと呼ばれます。  HTTP プロトコルで指定されるように、ホスト ヘッダーのフィールドは必要なリソースのインターネット ホストとポート番号を指定します。  この情報は、ユーザーが提供またはリソース \(一般に、HTTP URL\) を参照する元の URI から取得されます。  .NET Framework Version 4 で、この情報には、<xref:System.Net.HttpWebRequest.Host%2A> の新しいプロパティを使用するクライアントに設定できます。  
+  
+ <xref:System.Net.AuthenticationManager> のクラスが <xref:System.Net.WebRequest> の派生クラスおよび的な <xref:System.Net.WebClient> クラスで使用される管理の認証のコンポーネント \(「」\) モジュールを制御します。  <xref:System.Net.AuthenticationManager> のクラスが <xref:System.Net.AuthenticationManager.CustomTargetNameDictionary%2A?displayProperty=fullName> のオブジェクトを公開する URI の文字列によって作成されるプロパティされたアプリケーションを認証時に使用される注文の SPN の文字列を提供する提供します。  
+  
+ Version 3.5 SP1 の既定では、<xref:System.Net.AuthenticationManager.CustomTargetNameDictionary%2A> プロパティが設定されていない場合、要求 URL で使用されているホスト名が NTLM \(NT LAN Manager\) 認証交換の SPN に指定されます。  要求 URL で使用されているホスト名は、クライアント要求の <xref:System.Net.HttpRequestHeader?displayProperty=fullName> に指定されている Host ヘッダーと異なる場合があります。  要求 URL で使用されているホスト名は、サーバーの実際のホスト名、サーバーのコンピューター名、コンピューターの IP アドレス、またはループバック アドレスと異なる場合があります。  このような場合は、Windows で認証要求が失敗します。  問題を処理するために、クライアント要求 \(「」contoso 使用されるホスト名がなど\) の URL で実際にローカル コンピュータの Windows 代替名であることを通知する必要があります。  
+  
+ この変更を行うに関してサーバー アプリケーションのいくつかの可能な方法があります。  推奨される方法は、サーバーの `BackConnectionHostNames` レジストリ キーに要求の URL で使用されるホスト名をマップします。  `BackConnectionHostNames` のレジストリ キーは、通常、ループバック住所にホスト名をマップするために使用されます。  手順は次一覧。  
+  
+ ループバック住所にマップされ、ローカル コンピュータの Web サイトに接続できるホスト名を指定するには、次の手順に従います。:  
+  
+ 1.  \[スタート\] ボタンをクリックし、\[ファイル名を指定して実行\] をクリックして「regedit」と入力し、\[OK\] をクリックします。  
+  
+ 2.  レジストリ エディターで、次のレジストリ キーを指定して、をクリックします:  
+  
+ `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Lsa\MSV1_0`  
+  
+ 3.  MSV1\_0 を右クリックし、新しいをポイントして、を複数の文字列の値をクリックします。  
+  
+ 4.  「`BackConnectionHostNames`」と入力して、Enter キーを押します。  
+  
+ 5.  `BackConnectionHostNames`を右クリックし、変更をクリックします。  
+  
+ 6.  値のデータではローカル コンピュータにある入力し、OK をクリックします。入力します。、のホスト名を拠点サービス \(要求の URL で使用されるホスト名\)。  
+  
+ 7.  レジストリ エディターを従業員が退職、を IISAdmin のサービスおよび実行 IISReset を再起動します。  
+  
+ より、安全な作業はループバックの小切手の説明に [http:\/\/support.microsoft.com\/kb\/896861](http://go.microsoft.com/fwlink/?LinkID=179657)従って無効にすることです。  これは、反映されるの攻撃への対策を無効にします。  したがって、機械が実際に使用する予定だけに代替名のセットを強いることをお勧めします。  
+  
+## 参照  
+ <xref:System.Net.AuthenticationManager.CustomTargetNameDictionary%2A?displayProperty=fullName>   
+ <xref:System.Net.HttpRequestHeader?displayProperty=fullName>   
+ <xref:System.Net.HttpWebRequest.Host%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/network-programming/changes-to-the-system-uri-namespace-in-version-2-0.md b/docs/framework/network-programming/changes-to-the-system-uri-namespace-in-version-2-0.md
new file mode 100644
index 00000000000..c9e49e30507
--- /dev/null
+++ b/docs/framework/network-programming/changes-to-the-system-uri-namespace-in-version-2-0.md
@@ -0,0 +1,83 @@
+---
+title: "バージョン 2.0 での System.Uri 名前空間の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 35883fe9-2d09-4d8b-80ca-cf23a941e459
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# バージョン 2.0 での System.Uri 名前空間の変更
+<xref:System.Uri?displayProperty=fullName> クラスに複数の変更が行われています。  これらの変更は、間違った態度、拡張有用性およびセキュリティを強化フィックス。  
+  
+## 古いおよび使用されていないメンバ  
+ :コンストラクター  
+  
+-   `dontEscape`パラメータがあるすべてのコンストラクター。  
+  
+ 方法:  
+  
+-   <xref:System.Uri.CheckSecurity%2A>  
+  
+-   <xref:System.Uri.Escape%2A>  
+  
+-   <xref:System.Uri.Canonicalize%2A>  
+  
+-   <xref:System.Uri.Parse%2A>  
+  
+-   <xref:System.Uri.IsReservedCharacter%2A>  
+  
+-   <xref:System.Uri.IsBadFileSystemCharacter%2A>  
+  
+-   <xref:System.Uri.IsExcludedCharacter%2A>  
+  
+-   <xref:System.Uri.EscapeString%2A>  
+  
+## 変更  
+  
+-   クエリの品目が ftp ファイル \(、など\) に慣れているない URI の設定「または" 行が、<xref:System.Uri.Query%2A> の一部の先頭に常に脱出し、には考慮されません。  
+  
+-   暗黙ファイルの URI \("C:\\directory\\file@name.txt"\) の、フラグメント文字 \('\#'\) は完全に unescaping 要求するまたは <xref:System.Uri.LocalPath%2A> です `true`常にします脱出 。  
+  
+-   ホストネーム UNC のサポートが削除されました。; 国際ホストネームを表すための IDN の仕様は採用されました。  
+  
+-   <xref:System.Uri.LocalPath%2A> は完全に unescaped 文字列を常に返します。  
+  
+-   <xref:System.Uri.ToString%2A> するには脱出「」、「unescape か。」、「\#」文字。  
+  
+-   <xref:System.Uri.Equals%2A> は平等の小切手と終了 <xref:System.Uri.Query%2A> の一部が含まれます。  
+  
+-   オペレータ「」および「\! \=\=\=」上書きされ、<xref:System.Uri.Equals%2A> 方法をにリンク。  
+  
+-   <xref:System.Uri.IsLoopback%2A> は、一貫した結果を少し異なります。  
+  
+-   `file:///path`URI 「file:\/\/path」」と「に、変換されません。  
+  
+-   」終了「&#124; ホスト名のターミネーターとして認識されます。  つまり、「http:\/\/consoto.com\#fragment」http:\/\/contoso.com\/\#fragment」と「に変換されます。  
+  
+-   基準を URI 片と組み合わせるフィックスときにバグ。  
+  
+-   <xref:System.Uri.HostNameType%2A> のバグはフィックス。  
+  
+-   分析する NNTP のバグはフィックス。  
+  
+-   フォームの URI HTTP:contoso.com は、分析の例外を投げます。  
+  
+-   フレームワークが正しく URI の userinfo を処理します。  
+  
+-   URI のパス圧縮は URI の内訳がルート上のファイル システムをスキャンするようにフィックス。  
+  
+## 参照  
+ <xref:System.Uri?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/network-programming/configuring-caching-in-network-applications.md b/docs/framework/network-programming/configuring-caching-in-network-applications.md
new file mode 100644
index 00000000000..8a9f0df6c0e
--- /dev/null
+++ b/docs/framework/network-programming/configuring-caching-in-network-applications.md
@@ -0,0 +1,41 @@
+---
+title: "ネットワーク アプリケーションでのキャッシュの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "キャッシュ [.NET Framework]、構成"
+ms.assetid: 3f694a1c-de5d-47cf-a6eb-cfc369fb8a9f
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# ネットワーク アプリケーションでのキャッシュの構成
+キャッシュをコンフィギュレーションするには、アプリケーションまたは <xref:System.Net.WebRequest> のレベルでキャッシュのポリシーを指定する必要があります。  次のトピックでは、キャッシュを使用するコンフィギュレーションのアプリケーションと要求を示すコード例を示します。  
+  
+-   [方法: アプリケーションの場所に基づくキャッシュのポリシーを設定します](../../../docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md)  
+  
+-   [方法: アプリケーションの既定の時間ベースのキャッシュのポリシーを設定します](../../../docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md)  
+  
+-   [方法: または材料のキャッシュのポリシーをカスタマイズします。](../../../docs/framework/network-programming/how-to-customize-a-time-based-cache-policy.md)  
+  
+-   [方法: 要求のキャッシュのポリシーを設定します](../../../docs/framework/network-programming/how-to-set-cache-policy-for-a-request.md)  
+  
+ アプリケーションや機械コンフィギュレーション コンフィギュレーション ファイルを使用してキャッシュのポリシーをコンフィギュレーションできます。  詳細については、" "を参照してください &#124; [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)。  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/configuring-internet-applications.md b/docs/framework/network-programming/configuring-internet-applications.md
new file mode 100644
index 00000000000..3aa850a5533
--- /dev/null
+++ b/docs/framework/network-programming/configuring-internet-applications.md
@@ -0,0 +1,113 @@
+---
+title: "構成 (インターネット アプリケーションを) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダウンロード (インターネット リソースの)、既定のプロキシ"
+  - "送信 (データを)、既定のプロキシ"
+  - "受信 (データを)、既定のプロキシ"
+  - "ダウンロード (インターネット リソースの)、構成 (インターネット アプリケーションを)"
+  - "プロトコル固有のモジュール"
+  - "カスタム認証モジュール"
+  - "受信 (データを)、構成 (インターネット アプリケーションを)"
+  - "構成の設定 [.NET Framework]、インターネット アプリケーション"
+  - "要求 (インターネットからデータを)、構成 (インターネット アプリケーションを)"
+  - "要求 (インターネットからデータを)、既定のプロキシ"
+  - "インターネット要求への応答、既定のプロキシ"
+  - "インターネット、構成 (インターネット アプリケーションを)"
+  - "インターネット要求への応答、構成 (インターネット アプリケーションを)"
+  - "既定のプロキシ"
+  - "ネットワークのリソース、既定のプロキシ"
+  - "送信 (データを)、構成 (インターネット アプリケーションを)"
+  - "ネットワーク リソース、構成 (インターネット アプリケーションを)"
+  - "インターネット、既定のプロキシ"
+ms.assetid: bb707c72-eed2-4a82-8800-c9e68df2fd4f
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# 構成 (インターネット アプリケーションを)
+[\<system.Net\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md) の構成要素は、アプリケーションのネットワーク コンフィギュレーション情報が含まれます。  [\<system.Net\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md) の要素を使用して、プロキシ サーバーを設定できます。接続管理パラメータの設定、自分のアプリケーションに注文の認証および要求のモジュールが含まれます。  
+  
+ [\<defaultProxy\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings.md) の要素は `GlobalProxySelection` クラスによって返されたプロキシ サーバーを定義します。  どの <xref:System.Net.HttpWebRequest> 特定の値に <xref:System.Net.HttpWebRequest.Proxy%2A> 固有のプロパティがない既定のプロキシを使用します。  プロキシの住所の設定に加えて、プロキシを使用せず、プロキシがこの住所に使用する必要があることを指定できますサーバー住所の一覧を作成します。  
+  
+ 、Microsoft Internet Explorer の設定がコンポーネントの設定と組み合わせて、取得後の優先順位でことを確認することが重要です。  
+  
+ 次の例では、プロキシがこの住所に使用する必要がない contoso.com のドメインにあるサーバーへのすべての要求がプロキシをスキップするように指定されますがことを http:\/\/proxyserver に既定のプロキシ サーバーの住所を、および。  
+  
+```  
+<configuration>  
+    <system.net>  
+        <defaultProxy>  
+            <proxy  
+                usesystemdefault = "false"  
+                proxyaddress = "http://proxyserver:80"  
+                bypassonlocal = "true"  
+            />  
+            <bypasslist>  
+                <add address="http://[a-z]+\.contoso\.com/" />  
+            </bypasslist>  
+        </defaultProxy>  
+    </system.net>  
+</configuration>  
+```  
+  
+ 特定のサーバーまたは他のすべてのサーバーにするには、耐久性がある接続数をコンフィギュレーションするに [\<connectionManagement\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/connectionmanagement-element-network-settings.md) の要素を使用します。  次の例では、サーバーへの www.contoso.com 2 種類の耐久性がある接続、IP アドレス 192.168.1.2 のサーバーへの 4 種類の耐久性がある接続、およびそのほかすべてのサーバーへの 1 種類の耐久性がある接続を使用するアプリケーションのコンフィギュレーションを示します。  
+  
+```  
+<configuration>  
+    <system.net>  
+        <connectionManagement>  
+            <add address="http://www.contoso.com" maxconnection="2" />  
+            <add address="192.168.1.2" maxconnection="4" />  
+            <add address="*" maxconnection="1" />  
+        </connectionManagement>  
+    </system.net>  
+</configuration>  
+```  
+  
+ 注文の認証のモジュールの [\<authenticationModules\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/authenticationmodules-element-network-settings.md) の要素をコンフィギュレーションします。  注文の認証のモジュールの <xref:System.Net.IAuthenticationModule> インターフェイスを行う必要があります。  
+  
+ 次の例では、注文の認証モジュールのコンフィギュレーションを示します。  
+  
+```  
+<configuration>  
+    <system.net>  
+        <authenticationModules>  
+            <add type="MyAuthModule, MyAuthModule.dll" />  
+        </authenticationModules>  
+    </system.net>  
+</configuration>  
+```  
+  
+ インターネットのリソースの情報を要求するに対応する注文プロトコル モジュールを使用するようにアプリケーションをコンフィギュレーションするに [\<webRequestModules\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/webrequestmodules-element-network-settings.md) の要素を使用できます。  モジュールは指定 <xref:System.Net.IWebRequestCreate> インターフェイスを行う必要があります。  次の例のようにコンフィギュレーション ファイルで、カスタムのモジュールを指定して、既定の HTTP、HTTPS とファイルのモジュールを上書きできます。  
+  
+```  
+<configuration>  
+    <system.net>  
+        <webRequestModules>  
+            <add  
+                prefix="HTTP"  
+                type = "MyHttpRequest.dll, MyHttpRequestCreator"  
+            />  
+        </webRequestModules>  
+    </system.net>  
+</configuration>  
+```  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [ネットワーク設定スキーマ](../../../docs/framework/configure-apps/file-schema/network/index.md)   
+ [\<system.Net\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/system-net-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/connection-grouping.md b/docs/framework/network-programming/connection-grouping.md
new file mode 100644
index 00000000000..c0a868cbdab
--- /dev/null
+++ b/docs/framework/network-programming/connection-grouping.md
@@ -0,0 +1,35 @@
+---
+title: "接続のグループ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターネット、接続"
+  - "接続 [.NET Framework]、グループ化"
+  - "WebRequest クラス、接続のグループ化"
+  - "ネットワーク リソース、接続"
+  - "接続プール"
+ms.assetid: 2ec502e8-4ba0-4c22-9410-f28eaf4eee63
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# 接続のグループ化
+接続のグループは、フォームで定義した接続プールに一つのアプリケーション内の特定の要求を関連付けます。  これは、中間層アプリケーションによってユーザーに代わって後部サーバーに要求する接続し、Kerberos など\) または独自の資格情報を提供する次の例のように中間層アプリケーションによって、委任をサポートする認証プロトコルを使用します。  たとえば、ユーザーをその支払名簿の情報を表示する内部 Web サイトとします。健一郎してください。  健一郎を認証すると、支払名簿の情報を取得するために、中間層のアプリケーション サーバーは後部サーバーに接続するに健一郎の資格情報を使用します。  次に、スーザンは、サービス拠点を参照して、自分の支払名簿情報が必要です。  中間層アプリケーションが健一郎の資格情報を使用して既にを接続しているため、後部サーバーは、健一郎の情報と回答します。  ただし、アプリケーションで作成された接続のグループにユーザー名から後部サーバーに送信される各要求を割り当てると、各ユーザー別の接続プールに属していて、別のユーザーに誤って認証情報を共有することはできません。  
+  
+ 特定の接続のグループに要求を割り当てるには、の <xref:System.Net.WebRequest> の <xref:System.Net.WebRequest.ConnectionGroupName%2A> のプロパティに要求する前に名前を割り当てる必要があります。  
+  
+## 参照  
+ [接続の管理](../../../docs/framework/network-programming/managing-connections.md)   
+ [方法: グループの接続にユーザー情報を割り当てる](../../../docs/framework/network-programming/how-to-assign-user-information-to-group-connections.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/creating-internet-requests.md b/docs/framework/network-programming/creating-internet-requests.md
new file mode 100644
index 00000000000..9c72013735b
--- /dev/null
+++ b/docs/framework/network-programming/creating-internet-requests.md
@@ -0,0 +1,42 @@
+---
+title: "インターネット要求の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "WebRequest クラス、送受信 (データを)"
+  - "ネットワーク"
+  - "HttpWebResponse クラス、送受信 (データを)"
+  - "要求 (インターネットからデータを)、作成 (要求を)"
+  - "ネットワーク リソース"
+  - "インターネット、要求 (データを)"
+  - "データの要求、作成 (要求を)"
+ms.assetid: faab683e-3f1e-4eee-b5e9-59f7245033d5
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# インターネット要求の作成
+アプリケーションは <xref:System.Net.WebRequest.Create%2A?displayProperty=fullName> 方法で <xref:System.Net.WebRequest> のインスタンスを作成します。  これに渡される URI の設定に **\[WebRequest\]** から派生クラスを基づいてを作成する方法です。  
+  
+## Web、ファイルと FTP の要求  
+ .NET Framework は処理の HTTP と HTTPS の要求に対する **\[WebRequest\]**から、派生 <xref:System.Net.HttpWebRequest> クラスを説明します。  ほとんどの場合、**\[WebRequest\]** クラスは、要求をする必要があるすべてのプロパティを提供します; 必要に応じて、ことが要求の Http 固有のプロパティにアクセスするに **\[WebRequest.Create\]** 方法によって作成された **HttpWebRequest** タイプに **\[WebRequest\]** のオブジェクトをキャストことが可能です。  同様に、**HttpWebResponse** のオブジェクトは、HTTP と HTTPS の要求からの応答を処理します。  **HttpWebResponse** への Http 固有のプロパティにアクセスするには、**HttpWebResponse** タイプに **WebResponse** のオブジェクトをキャスト必要があります。逆します。  
+  
+ .NET Framework は、「ファイルを使用するリソースに要求の処理に <xref:System.Net.FileWebRequest> と <xref:System.Net.FileWebResponse> クラスを提供します: 」URI の設定。  同様に、<xref:System.Net.FtpWebResponse> の <xref:System.Net.FtpWebRequest> およびクラスは、「ftp を使用するリソースに要求の処理に用意されています: 」設定。  、要求の設定が使用するリソースがである場合、要求をされるオブジェクトを取得するに **\[WebRequest.Create\]** 方法を使用できます。  
+  
+ へ他のアプリケーション レベルのセキュリティを使用する要求を処理するために、**\[WebRequest\]** と **WebResponse**から派生したプロトコル対応クラスを実行する必要があります。  詳細については、[プログラミング プラグインの可能なセキュリティ](../../../docs/framework/network-programming/programming-pluggable-protocols.md)を参照してください。  
+  
+## 参照  
+ [方法: WebRequest クラスを使用してデータを要求する](../../../docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md)   
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/deriving-from-webrequest.md b/docs/framework/network-programming/deriving-from-webrequest.md
new file mode 100644
index 00000000000..c55f2599385
--- /dev/null
+++ b/docs/framework/network-programming/deriving-from-webrequest.md
@@ -0,0 +1,106 @@
+---
+title: "WebRequest からの派生 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "WebRequest クラス、プラグ可能なプロトコル"
+  - "プロトコル固有の要求ハンドラー"
+  - "送信 (データを)、プラグ可能なプロトコル"
+  - "プラグ可能なプロトコル、クラスの基準"
+  - "インターネット、プラグ可能なプロトコル"
+  - "受信 (データを)、プラグ可能なプロトコル"
+  - "プロトコル、プラグ可能"
+ms.assetid: 9810c177-973e-43d7-823c-14960bd625ea
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# WebRequest からの派生
+<xref:System.Net.WebRequest> クラスは、.NET Framework プラグインの可能なプロトコル モデルに対応するプロトコル ハンドラーの要求を作成する基本およびメソッド プロパティを提供する抽象的な基本クラスです。  **\[WebRequest\]** クラスを使用するアプリケーションは、サポートされるプロトコルを使用して使用されるプロトコルを指定する必要なく、データを要求できます。  
+  
+ 2 種類の基準はプラグイン可能なプロトコルとして使用するプロトコル対応クラスに対して満たす必要があります: クラスは、<xref:System.Net.IWebRequestCreate> インターフェイスを実装し <xref:System.Net.WebRequest.RegisterPrefix%2A?displayProperty=fullName> 方法と登録する必要があります。  クラスはプラグイン可能なインターフェイスを提供する **\[WebRequest\]** のすべての抽象的な方法およびプロパティを必要があります。  
+  
+ **\[WebRequest\]** のインスタンスは一度だけの使用を意図しています; 別の要求をする場合は、新しい **\[WebRequest\]**を作成します。  **\[WebRequest\]** は、テンプレート **\[WebRequest\]** を XML し、追加要求のテンプレートを再構築する開発者のを有効にするに <xref:System.Runtime.Serialization.ISerializable> インターフェイスをサポートします。  
+  
+## IWebRequest が方法を作成します  
+ <xref:System.Net.IWebRequestCreate.Create%2A> 方法はプロトコル対応クラスの新しいインスタンスを初期化する責任があります。  新しい **\[WebRequest\]** が作成されると、<xref:System.Net.WebRequest.Create%2A?displayProperty=fullName> 方法は **RegisterPrefix** 方法と登録された URI の接頭辞に要求された URI を照合します。  適切な対応プロトコルその子孫の **\[作成\]** 方法に変更されるプロトコル対応するフィールドは必要ではありませんプロトコルの標準的な要求または応答のトランザクションを実行できる子孫の初期化したインスタンスを戻す必要があります。  
+  
+## ConnectionGroupName のプロパティ  
+ 複数の要求を単一の接続を作成できるように <xref:System.Net.WebRequest.ConnectionGroupName%2A> のプロパティがリソース グループへの接続を表示するために使用します。  接続共有を実行するには、割り当てる接続プール プロトコル対応方法を使用します。  たとえば、<xref:System.Net.HttpWebRequest> クラスで共有する出荷済 <xref:System.Net.ServicePointManager> クラスの実装のつながり。  各接続のグループを特定のサーバーへの接続を提供する **ServicePointManager** のクラスが <xref:System.Net.ServicePoint> を作成します。  
+  
+## ContentLength のプロパティ  
+ <xref:System.Net.WebRequest.ContentLength%2A> のプロパティはデータをアップロードするとサーバーに送信されるデータのバイト数を指定します。  
+  
+ 通常、アップロードが **\[ContentLength\]** のプロパティがゼロより大きい値に設定されている場合行われていることを示すには <xref:System.Net.WebRequest.Method%2A> のプロパティが設定されている必要があります。  
+  
+## ContentType のプロパティ  
+ <xref:System.Net.WebRequest.ContentType%2A> のプロパティは、送信されるコンテンツ タイプを識別するために、プロトコルとサーバーに送信するように要求すると特殊な情報を提供します。  通常、これはアップロードされるすべてのデータの MIME のコンテンツ タイプです。  
+  
+## 資格情報のプロパティ  
+ <xref:System.Net.WebRequest.Credentials%2A> のプロパティは、サーバーと要求を認証するための情報が含まれます。  自分のプロトコルと認証プロセスの詳細を行う必要があります。  <xref:System.Net.AuthenticationManager> のクラスが要求を認証および認証トークンを提供する責任があります。  自分のプロトコルで使用される資格情報を提供するクラスが <xref:System.Net.ICredentials> インターフェイスを行う必要があります。  
+  
+## ヘッダーのプロパティ  
+ <xref:System.Net.WebRequest.Headers%2A> のプロパティは要求に関連付けられたメタデータの名前と値の組み合わせのコレクション オプションが含まれます。  名前と値の組み合わせで表すことができるプロトコルが必要とするしたメタデータが **\[ヘッダー\]** のプロパティに含めることができます。  通常この情報は <xref:System.Net.WebRequest.GetRequestStream%2A> または <xref:System.Net.WebRequest.GetResponse%2A> 方法を追加する前に設定する必要があります; 一度要求は、メタデータ、見なされます読み取り専用に作成されます。  
+  
+ ヘッダーのメタデータを使用するに **\[ヘッダー\]** のプロパティを使用する必要はありません。  プロトコル対応のメタデータをプロパティとして公開できます。; たとえば、<xref:System.Net.HttpWebRequest.UserAgent%2A?displayProperty=fullName> のプロパティは **User\-Agent** の HTTP ヘッダーを公開します。  プロパティとしてヘッダーのメタデータを公開すると、同じプロパティが **\[ヘッダー\]** のプロパティを使用するように設定できません。  
+  
+## 方法のプロパティ  
+ <xref:System.Net.WebRequest.Method%2A> のプロパティは要求がサーバーに実行するように依頼するか動詞アクションが含まれます。  **\[メソッド\]** プロパティの既定値はプロトコル対応するプロパティがある必要はありませんの標準的な要求または応答のアクションを有効にする必要があります。  たとえば、Web サーバーからリソースを要求し、応答を返品 [HttpWebResponse](frlrfSystemNetHttpWebResponseClassMethodTopic) 方法は得るためになります。  
+  
+ 通常ある場合 **\[ContentLength\]** の **\[メソッド\]** のプロパティがアップロードが行われていることを示します動詞アクションまたはに設定されている場合プロパティが大きい値に設定する必要があります。  
+  
+## PreAuthenticate のプロパティ  
+ アプリケーションは認証情報が必要であることを示すに <xref:System.Net.WebRequest.PreAuthenticate%2A> のプロパティを設定チャレンジを待機しています。認証ではなく、初期需要ととも。  **\[前もって認証\]** のプロパティはプロトコルが最初の要求に送信される資格情報を認証をサポート場合にのみ意味を使用しています。  
+  
+## プロキシのプロパティ  
+ <xref:System.Net.WebRequest.Proxy%2A> のプロパティは、要求されたリソースのアクセスに使用される <xref:System.Net.IWebProxy> インターフェイスが含まれます。  **\[プロキシ\]** のプロパティは、プロトコルが proxied 要求をサポートする場合にのみ意味を使用しています。  1 種類が、プロトコルによって要求される既定のプロキシを設定する必要があります。  
+  
+ 会社のファイアウォールの後などのある環境では、プロキシを使用するには、プロトコルが必要な場合があります。  この場合、プロトコルで働くプロキシ クラスを作成するに **IWebProxy** インターフェイスを行う必要があります。  
+  
+## RequestUri のプロパティ  
+ <xref:System.Net.WebRequest.RequestUri%2A> のプロパティは **\[WebRequest.Create\]** 方法に渡した URI が含まれます。  これは **\[WebRequest\]** が作成されている場合は読み取り専用で、変更することはできません。  自分のプロトコルがリダイレクトをサポートしている場合、応答を別の URI によって識別されるリソースから取得できます。  応募した URI へのアクセスを許可する必要がある場合は、その URI を含む追加のプロパティを指定する必要があります。  
+  
+## タイムアウトのプロパティ  
+ <xref:System.Net.WebRequest.Timeout%2A> のプロパティは、時間 \(ミリ秒単位で、要求の前に待機時間を時間を日時投げます例外が含まれます。  **\[タイムアウト\]** は <xref:System.Net.WebRequest.GetResponse%2A> 方法との同期要求に対してのみです; 非同期要求が保留中で要求を取り消すために <xref:System.Net.WebRequest.Abort%2A> 方法を使用する必要があります。  
+  
+ **\[タイムアウト\]** のプロパティの設定はプロトコル対応クラスのタイムアウト プロセスを実行する場合にのみ意味を使用しています。  
+  
+## 中止方法  
+ <xref:System.Net.WebRequest.Abort%2A> 方法は、サーバーは保留中の非同期要求を取り消します。  要求が取り消された後、**GetResponse**を、**BeginGetResponse**すると、**EndGetResponse**、**GetRequestStream**、**BeginGetRequestStream**、または **EndGetRequestStream** は [RequestCanceled](frlrfSystemNetWebExceptionStatusClassTopic)に <xref:System.Net.WebException.Status%2A> のプロパティとの <xref:System.Net.WebException> を投げます。  
+  
+## BeginGetRequestStream と EndGetRequestStream 方法  
+ <xref:System.Net.WebRequest.BeginGetRequestStream%2A> 方法は、サーバーにデータをアップロードするために使用されるストリームの非同期要求を開始します。  <xref:System.Net.WebRequest.EndGetRequestStream%2A> 方法は非同期要求を完了して、要求されたストリームを返します。  これらの方法には標準 .NET Framework 非同期のパターンを使用して **GetRequestStream** 方法を実行します。  
+  
+## BeginGetResponse と EndGetResponse 方法  
+ <xref:System.Net.WebRequest.BeginGetResponse%2A> 方法は非同期サーバーに要求を開始します。  <xref:System.Net.WebRequest.EndGetResponse%2A> 方法は非同期要求を完了して、要求された応答を返します。  これらの方法には標準 .NET Framework 非同期のパターンを使用して **GetResponse** 方法を実行します。  
+  
+## GetRequestStream 方法  
+ <xref:System.Net.WebRequest.GetRequestStream%2A> 方法は、要求されたサーバーにデータを入力するために使用されるストリームを返します。  返品ストリームは検索する書き込み専用ストリーム必要です; これは、サーバーに書き込まれる一方の通行データのベースとして使用されます。  ストリームは <xref:System.IO.Stream.CanRead%2A> と <xref:System.IO.Stream.CanSeek%2A> のプロパティの false を返品した <xref:System.IO.Stream.CanWrite%2A> のプロパティに調整します。  
+  
+ **GetRequestStream** 方法はストリームを行う前に、データがサーバーに送信することをサーバーへの接続を開き、ヘッダー情報を表示します。  **GetRequestStream** が要求を開始するので、**ヘッダー** プロパテや **\[ContentLength\]** のプロパティの設定は **GetRequestStream**を追加した後、通常は許可されません。  
+  
+## GetResponse 方法  
+ <xref:System.Net.WebRequest.GetResponse%2A> 方法がサーバーからの応答を表す <xref:System.Net.WebResponse> クラス プロトコル対応その子孫を返します。  要求が **GetRequestStream** 方法で既に始められなかったら、**GetResponse** 方法は **RequestUri**に応じて、請求要求のタイプを示す送信ヘッダー情報への接続を作成して識別されるリソース、リソースからの応答が表示されます。  
+  
+ **GetResponse** 方法が呼び出されなかった場合、すべてのプロパティは読み取り専用に考慮する必要があります。  **\[WebRequest\]** のインスタンスは一度だけの使用を意図しています; 別の要求をする場合は、新しい **\[WebRequest\]**を作成する必要があります。  
+  
+ **GetResponse** 方法は、受信する応答を含めるに **WebResponse** の適切な子孫を作成する担当者があります。  
+  
+## 参照  
+ <xref:System.Net.WebRequest>   
+ <xref:System.Net.HttpWebRequest>   
+ <xref:System.Net.FileWebRequest>   
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)   
+ [WebResponse からの派生](../../../docs/framework/network-programming/deriving-from-webresponse.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/deriving-from-webresponse.md b/docs/framework/network-programming/deriving-from-webresponse.md
new file mode 100644
index 00000000000..98a62fb2daf
--- /dev/null
+++ b/docs/framework/network-programming/deriving-from-webresponse.md
@@ -0,0 +1,56 @@
+---
+title: "WebResponse からの派生 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "WebResponse からの派生"
+ms.assetid: f11d4866-a199-4087-9306-a5a4c18b13db
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# WebResponse からの派生
+<xref:System.Net.WebResponse> クラスは、.NET Framework プラグインの可能なプロトコル モデルを満たすプロトコル対応する応答を作成する基本およびメソッド プロパティを提供する抽象的な基本クラスです。  リソースのデータを要求するに <xref:System.Net.WebRequest> クラスを使用するアプリケーションは **WebResponse**の応答が表示されます。  **WebResponse** プロトコル対応その子孫は **WebResponse** クラスの抽象的なメンバを行う必要があります。  
+  
+ **\[WebRequest\]** のクラスは、**WebResponse** その子孫を作成する必要があります。  たとえば、<xref:System.Net.HttpWebResponse> のインスタンスは <xref:System.Net.HttpWebRequest.GetResponse%2A?displayProperty=fullName> または <xref:System.Net.HttpWebRequest.EndGetResponse%2A?displayProperty=fullName>を呼び出しの結果のみ作成されます。  各 **WebResponse** は、リソースの要求の結果を含み、再利用ものではありません。  
+  
+## ContentLength のプロパティ  
+ <xref:System.Net.WebResponse.ContentLength%2A> のプロパティは <xref:System.Net.WebResponse.GetResponseStream%2A> 方法によって返されたストリームから使用可能なデータのバイト数を示します。  **\[ContentLength\]** のプロパティはサーバーが返品ヘッダーまたはメタデータ情報のバイト数を参照する; これは、要求されたリソースのデータのバイト数を自体を示します。  
+  
+## ContentType のプロパティ  
+ <xref:System.Net.WebResponse.ContentType%2A> のプロパティは送信サーバーが格納されるデータのタイプを識別するために、セキュリティはクライアントにするように要求すると特殊な情報を提供します。  通常、これは返品データ要素の MIME のコンテンツ タイプです。  
+  
+## ヘッダーのプロパティ  
+ <xref:System.Net.WebResponse.Headers%2A> のプロパティが応答に関連付けられているメタデータの名前と値の組み合わせのコレクション オプションが含まれます。  名前と値の組み合わせで表すことができるプロトコルが必要とするしたメタデータが **\[ヘッダー\]** のプロパティに含めることができます。  
+  
+ ヘッダーのメタデータを使用するに **\[ヘッダー\]** のプロパティを使用する必要はありません。  プロトコル対応のメタデータをプロパティとして公開できます。; たとえば、<xref:System.Net.HttpWebResponse.LastModified%2A?displayProperty=fullName> のプロパティは **Last\-Modified** の HTTP ヘッダーを公開します。  プロパティとしてヘッダーのメタデータを公開すると、同じプロパティが **\[ヘッダー\]** のプロパティを使用するように設定できません。  
+  
+## ResponseUri のプロパティ  
+ <xref:System.Net.WebResponse.ResponseUri%2A> のプロパティは、実際に回答を提供したリソースの URI が含まれます。  リダイレクトをサポート プロトコルとして、**ResponseUri** が応答を作成した **\[WebRequest\]** の <xref:System.Net.WebRequest.RequestUri%2A> のプロパティと同じです。  プロトコルが要求の方向を変更することをサポートしている場合は、**ResponseUri** URI の応答が含まれます。  
+  
+## 原価計算方法  
+ <xref:System.Net.WebResponse.Close%2A> 方法は要求と回答による接続を閉じ、応答で使用されるリソースを遵守します。  **\[閉じる\]** 方法が応答で使用されるストリームのインスタンスを閉じますが応答のベースが <xref:System.IO.Stream.Close%2A?displayProperty=fullName> のメソッドへの呼び出しによって前に閉じられたら例外を投げません。  
+  
+## GetResponseStream 方法  
+ <xref:System.Net.WebResponse.GetResponseStream%2A> 方法は、要求されたリソースから回答を含むストリームを返します。  回答のベースは、リソースから返されたデータのみが含まれます; 応答に含まれるヘッダーまたはメタデータをプロトコル対応するプロパティまたは **\[ヘッダー\]** のプロパティを使用してアプリケーションへの応答から削除され、公開する必要があります。  
+  
+ **GetResponseStream** 方法によって返されたストリームのインスタンスはアプリケーションが所有して、**WebResponse**を閉じないで決済できます。  慣例に、**\[WebResponse.Close\]** 方法を追加すると、**GetResponse**によって返されたストリームを閉じます。  
+  
+## 参照  
+ <xref:System.Net.WebResponse>   
+ <xref:System.Net.HttpWebResponse>   
+ <xref:System.Net.FileWebResponse>   
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)   
+ [WebRequest からの派生](../../../docs/framework/network-programming/deriving-from-webrequest.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/enabling-and-disabling-ipv6.md b/docs/framework/network-programming/enabling-and-disabling-ipv6.md
new file mode 100644
index 00000000000..9452f11afef
--- /dev/null
+++ b/docs/framework/network-programming/enabling-and-disabling-ipv6.md
@@ -0,0 +1,57 @@
+---
+title: "IPv6 の有効化と無効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 6408d3ef-c9ba-49d9-b15e-fe74bd3ef031
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# IPv6 の有効化と無効化
+IPv6 をサポートする移動、オペレーティング システムとネットワーキングのクラスが正しくコンフィギュレーションされていることを確認するオペレーティング システムのバージョンを IPv6 プロトコルを使用するには、確認します。  
+  
+## コンフィギュレーションの手順  
+ 次の表に、さまざまなコンポーネントの一覧  
+  
+|オペレーティング システム IPv6 有効になるか。|IPv6 有効になるネットワーキングのクラスや。|説明|  
+|--------------------------------|------------------------------|--------|  
+|いいえ|いいえ|IPv6 の住所を分析できます。|  
+|いいえ|はい|IPv6 の住所を分析できます。|  
+|はい|いいえ|IPv6 の住所を分析し、名前の決済方法のマークを付けられない古い形式を使用して IPv6 の住所を決済できます。|  
+|はい|はい|これらのマークされた古いを含むすべての方法を使用して IPv6 の住所を分析および決済できます。|  
+  
+ System.Net の名前空間のすべてのクラスの IPv6 のサポートを有効にするには、アプリケーションのコンピュータのコンフィギュレーション ファイルまたはコンフィギュレーション ファイルを変更する必要があるので注意してください。  アプリケーション用にコンフィギュレーション ファイルにコンピュータ上のコンフィギュレーション ファイルの優先順位があります。  
+  
+ Ipv6 サポートを有効にするコンピュータでコンフィギュレーション ファイルを *machine.config*は、変更方法の例では、[方法: Ipv6 サポートを有効にするコンピュータでコンフィギュレーション ファイルを変更します。](../../../docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md)表示されます。  、IPv6 のサポートされているオペレーティング システムで有効であることを確認します。  
+  
+ .NET Framework にコンフィギュレーション ファイルで次のように設定されているコンポーネントの Switch があります。  
+  
+```  
+<system.net>…  
+    <settings>…  
+        <ipv6 enabled="true"/>…  
+    </settings>…  
+</system.net>  
+```  
+  
+ .NET Framework Version 1.1 が、以前の **ipv6 enabled**、コンポーネントの Switch の値はかどうか <xref:System.Net.Dns?displayProperty=fullName> クラスの返品 IPv6 の住所のメンバ指定します。  
+  
+ .NET Framework Version 2.0 と後で、<xref:System.Net.Dns?displayProperty=fullName> クラスのメンバについては、Windows が IPv6 をサポート \(たとえば、<xref:System.Net.Dns.GetHostEntry%2A?displayProperty=fullName> 方法\)、1 種類の制限の IPv6 の住所を返します。  DNS <xref:System.Net.Dns?displayProperty=fullName> の古い形式のメンバは、\(たとえば、<xref:System.Net.Dns.Resolve%2A?displayProperty=fullName> 方法\) ipv6 によって有効にした設定のコンフィギュレーション ファイルの値を読み、確認します。  
+  
+## 参照  
+ [インターネット プロトコル バージョン 6](../../../docs/framework/network-programming/internet-protocol-version-6.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)   
+ [ネットワーク設定スキーマ](../../../docs/framework/configure-apps/file-schema/network/index.md)   
+ [\<ipv6\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/enabling-network-tracing.md b/docs/framework/network-programming/enabling-network-tracing.md
new file mode 100644
index 00000000000..9b63e261927
--- /dev/null
+++ b/docs/framework/network-programming/enabling-network-tracing.md
@@ -0,0 +1,61 @@
+---
+title: "ネットワークのトレースの有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "トレースのターゲット"
+  - "ログ ファイルへのトレースの送信"
+  - "トレース リスナー、ネットワークのトレース"
+  - "ネットワークのトレース、有効化"
+  - "CLR デバッガー"
+  - "既定のリスナー"
+  - "ログ、トレース"
+  - "トレース出力のターゲット"
+ms.assetid: 5fff458c-51a6-4134-ba47-8a6137ddc41e
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# ネットワークのトレースの有効化
+ネットワーク追跡はメソッド呼び出しに関する情報へのアクセスおよび管理アプリケーションによって生成されたネットワーク トラフィックを提供します。  自分のアプリケーションのネットワーク追跡を有効にするために、次の作業を行う必要があります:  
+  
+-   有効になる追跡とのコードをコンパイル。  追跡を有効にするために必要な作成者の Switch に関する詳細については [How to: Compile Conditionally with Trace and Debug](../../../docs/framework/debug-trace-profile/how-to-compile-conditionally-with-trace-and-debug.md) を参照してください。  
+  
+-   トレース出力の相手方を指定します。  
+  
+-   ネットワーク追跡の動作をコンフィギュレーションします。  詳細については [方法: ネットワーク追跡をコンフィギュレーションします。](../../../docs/framework/network-programming/how-to-configure-network-tracing.md) を参照してください。  
+  
+ また、追跡リスナーに対して共通の追跡のコピー先は、既定のリスナーとログ ファイルです。  
+  
+ 追跡は追跡リスナーを指定する既定のリスナーを使用します。  Windows SDK と出荷される .NET Framework SDK と出荷される CLR のデバッガーなどの管理によってコードを有効にするデバッガーのコードで既定のリスナーに送信されるメッセージまたは DBwin32.exe を表示できます。  CLR のデバッガーを使用して、Tracing メッセージが **出力** のウィンドウに表示されます。  
+  
+ 追跡を受け取る場合にファイルを使用するには、次の例で示すように、コンフィギュレーションの設定を使用してログ ファイルを指定できます。  \(コンフィギュレーション ファイルの概論については、[&#91;構成ファイル&#93;](../../../docs/framework/configure-apps/index.md)を参照してください。  
+  
+ ログ ファイルに追跡を送信するには、適切なコンフィギュレーション ファイルの `<system.diagnostics>` ノードに、次のノードの追加 \(アプリケーションまたは設備\)。  ニーズに合うようにファイル \(trace.log\) を変更できます。  
+  
+```  
+<system.diagnostics>  
+  <trace autoflush="true" indentsize="4">  
+    <listeners>  
+      <add name="file" type="System.Diagnostics.TextWriterTraceListener" initializeData="trace.log"/>  
+    </listeners>   
+  </trace>  
+</system.diagnostics>  
+```  
+  
+## 参照  
+ [ネットワークのトレースの解釈](../../../docs/framework/network-programming/interpreting-network-tracing.md)   
+ [.NET Framework のネットワークのトレース](../../../docs/framework/network-programming/network-tracing.md)   
+ [Introduction to Instrumentation and Tracing](http://msdn.microsoft.com/ja-jp/e924e57c-33cf-4b0e-9e7f-a45d13e38f2c)
\ No newline at end of file
diff --git a/docs/framework/network-programming/ftp.md b/docs/framework/network-programming/ftp.md
new file mode 100644
index 00000000000..2b4c02ce39e
--- /dev/null
+++ b/docs/framework/network-programming/ftp.md
@@ -0,0 +1,38 @@
+---
+title: "FTP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "FTP"
+ms.assetid: 9b43f8b4-89d7-46a7-89fc-71aca916dd32
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# FTP
+.NET Framework は <xref:System.Net.FtpWebRequest> と <xref:System.Net.FtpWebResponse> クラスを FTP プロトコルに対する総合的なサポートを提供します。  これらのクラスが <xref:System.Net.WebRequest> と <xref:System.Net.WebResponse>から取得されます。  プロパティとして公開される FTP 特定の機能へのアクセスを必要に応じて要求をする必要がある <xref:System.Net.FtpWebRequest> または <xref:System.Net.FtpWebResponse>にこれらのクラスのタイプにはめるできます。ほとんどの場合、<xref:System.Net.WebResponse> の <xref:System.Net.WebRequest> およびクラスはすべてを提供します。  
+  
+## 例  
+ 詳細については、次のトピックを参照してください: [方法: FTP を使用してファイルをダウンロードする](../../../docs/framework/network-programming/how-to-download-files-with-ftp.md)、[方法: FTP を使用してファイルをアップロードする](../../../docs/framework/network-programming/how-to-upload-files-with-ftp.md)と [方法: FTP でディレクトリの内容を一覧表示する](../../../docs/framework/network-programming/how-to-list-directory-contents-with-ftp.md)。  
+  
+## プロキシと FTP  
+ プロキシは \(<xref:System.Net.FtpWebRequest.Proxy%2A> のプロパティで指定された\) の HTTP プロキシの場合、<xref:System.Net.WebRequestMethods.Ftp.DownloadFile>、<xref:System.Net.WebRequestMethods.Ftp.ListDirectory>と <xref:System.Net.WebRequestMethods.Ftp.ListDirectoryDetails> のコマンドのみがサポートされます。  
+  
+## 参照  
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [クライアントの FTP テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179557)   
+ [FTP の自宅の技術サンプルの参照](http://go.microsoft.com/fwlink/?LinkID=179569)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/handling-errors.md b/docs/framework/network-programming/handling-errors.md
new file mode 100644
index 00000000000..941a0163a93
--- /dev/null
+++ b/docs/framework/network-programming/handling-errors.md
@@ -0,0 +1,179 @@
+---
+title: "エラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターネット、WebRequest クラスおよび WebResponse クラスの例外"
+  - "Status プロパティ"
+  - "WebExceptions クラス, WebExceptions クラスの概要"
+  - "Timeout 列挙型のメンバー"
+  - "ConnectFailure 列挙型のメンバー"
+  - "TrustFailure 列挙型のメンバー"
+  - "WebRequest クラス、例外"
+  - "要求 (インターネットからデータを)、エラー処理"
+  - "Success 列挙型のメンバー"
+  - "受信 (データを)、エラー"
+  - "ProtocolError 列挙型のメンバー"
+  - "ダウンロード (インターネット リソースの)、エラー処理"
+  - "WebResponse クラス、例外"
+  - "SendFailure 列挙型のメンバー"
+  - "エラー [.NET Framework]、WebRequest クラスと WebResponse クラスの例外"
+  - "送信 (データを)、エラー"
+  - "インターネット要求への応答、エラー処理"
+  - "NameResolutionFailure 列挙型のメンバー"
+  - "KeepAliveFailure 列挙型のメンバー"
+  - "ネットワーク リソース、WebRequest クラスと WebResponse クラスの例外"
+  - "RequestCanceled 列挙型のメンバー"
+  - "ReceiveFailure 列挙型のメンバー"
+  - "ServerProtocolViolation 列挙型のメンバー"
+  - "ConnectionClosed 列挙型のメンバー"
+  - "SecureChannelFailure 列挙型のメンバー"
+ms.assetid: 657141cd-5cf5-4fdb-a4b2-4c040eba84b5
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# エラー処理
+<xref:System.Net.WebRequest> と <xref:System.Net.WebResponse> \(クラス <xref:System.Net.WebRequest.GetResponse%2A> 方法で投げられる [WebExceptions](frlrfsystemnetwebexceptionclasstopic) であるシステムの両方\) 例外 \(<xref:System.ArgumentException>など\) および Web 特定の例外投げます。  
+  
+ 各 **WebException** は <xref:System.Net.WebExceptionStatus> の列挙型の値を含む <xref:System.Net.WebException.Status%2A> のプロパティがあります。  エラーを確認するに **\[状態\]** のプロパティを確認し、未収エラーを解決するために必要な手順を実行します。  
+  
+ 次の表に、**\[状態\]** のプロパティの使用可能な値を示します。  
+  
+|状態|説明|  
+|--------|--------|  
+|ConnectFailure|リモートに、サービス レベルで連絡できませんでした。|  
+|ConnectionClosed|関連付けは、時期早尚に閉じられました。|  
+|KeepAliveFailure|サーバーはキープアライブ ヘッダーのセットによる接続を閉じました。|  
+|NameResolutionFailure|名前のサービスをホスト名を解決しませんでした。|  
+|ProtocolError|サーバーから受信された回答が完了が、セキュリティ レベルでエラーが指定された。|  
+|ReceiveFailure|リモート サーバーから完全な応答が受信されませんでした。|  
+|RequestCanceled|要求は取り消されました。|  
+|SecureChannelFailure|エラーは保護されたチャネルのリンクにしました。|  
+|SendFailure|完全な要求をリモート サーバーに送信できませんでした。|  
+|ServerProtocolViolation|サーバー応答が有効な HTTP 応答ではありません。|  
+|成功|エラーは発生しませんでした。|  
+|タイムアウト|予想される反応はありません要求のタイムアウトのセット内で受領されています。|  
+|TrustFailure|サーバー証明書を検証できませんでした。|  
+|MessageLengthLimitExceeded|サーバーに要求を送信、またはサーバーからの応答を受信しているときに、制限長を超えるメッセージが渡されました。|  
+|保留|内部非同期要求が保留中です。|  
+|PipelineFailure|この値は、.NET Framework の下部組織をサポートし、自分のコードで直接使用されるものではありません。|  
+|ProxyNameResolutionFailure|名前解決サービスがプロキシ ホスト名を解決できませんでした。|  
+|UnknownError|未知の種類の例外が発生しました。|  
+  
+ サーバーからの応答を含む **\[状態\]** のプロパティが **WebExceptionStatus.ProtocolError**すると、**WebResponse** が使用できます。  プロトコル エラーの実際のソースを決定するためにこの応答を確認できます。  
+  
+ 次の例で **WebException**をつかまえる方法を示します。  
+  
+```csharp  
+try   
+{  
+    // Create a request instance.  
+    WebRequest myRequest =   
+    WebRequest.Create("http://www.contoso.com");  
+    // Get the response.  
+    WebResponse myResponse = myRequest.GetResponse();  
+    //Get a readable stream from the server.   
+    Stream sr = myResponse.GetResponseStream();  
+  
+    //Read from the stream and write any data to the console.  
+    bytesread = sr.Read( myBuffer, 0, length);  
+    while( bytesread > 0 )   
+    {  
+        for (int i=0; i<bytesread; i++) {  
+            Console.Write( "{0}", myBuffer[i]);  
+        }  
+        Console.WriteLine();  
+        bytesread = sr.Read( myBuffer, 0, length);  
+    }  
+    sr.Close();  
+    myResponse.Close();  
+}  
+catch (WebException webExcp)   
+{  
+    // If you reach this point, an exception has been caught.  
+    Console.WriteLine("A WebException has been caught.");  
+    // Write out the WebException message.  
+    Console.WriteLine(webExcp.ToString());  
+    // Get the WebException status code.  
+    WebExceptionStatus status =  webExcp.Status;  
+    // If status is WebExceptionStatus.ProtocolError,   
+    //   there has been a protocol error and a WebResponse   
+    //   should exist. Display the protocol error.  
+    if (status == WebExceptionStatus.ProtocolError) {  
+        Console.Write("The server returned protocol error ");  
+        // Get HttpWebResponse so that you can check the HTTP status code.  
+        HttpWebResponse httpResponse = (HttpWebResponse)webExcp.Response;  
+        Console.WriteLine((int)httpResponse.StatusCode + " - "  
+           + httpResponse.StatusCode);  
+    }  
+}  
+catch (Exception e)   
+{  
+    // Code to catch other exceptions goes here.  
+}  
+```  
+  
+```vb  
+Try  
+    ' Create a request instance.  
+    Dim myRequest As WebRequest = WebRequest.Create("http://www.contoso.com")  
+    ' Get the response.  
+    Dim myResponse As WebResponse = myRequest.GetResponse()  
+    'Get a readable stream from the server.   
+    Dim sr As Stream = myResponse.GetResponseStream()  
+  
+    Dim i As Integer      
+    'Read from the stream and write any data to the console.  
+    bytesread = sr.Read(myBuffer, 0, length)  
+    While bytesread > 0  
+        For i = 0 To bytesread - 1  
+            Console.Write("{0}", myBuffer(i))  
+        Next i  
+        Console.WriteLine()  
+        bytesread = sr.Read(myBuffer, 0, length)  
+    End While  
+    sr.Close()  
+    myResponse.Close()  
+Catch webExcp As WebException  
+    ' If you reach this point, an exception has been caught.  
+    Console.WriteLine("A WebException has been caught.")  
+    ' Write out the WebException message.  
+    Console.WriteLine(webExcp.ToString())  
+    ' Get the WebException status code.  
+    Dim status As WebExceptionStatus = webExcp.Status  
+    ' If status is WebExceptionStatus.ProtocolError,   
+    '   there has been a protocol error and a WebResponse   
+    '   should exist. Display the protocol error.  
+    If status = WebExceptionStatus.ProtocolError Then  
+        Console.Write("The server returned protocol error ")  
+        ' Get HttpWebResponse so that you can check the HTTP status code.  
+        Dim httpResponse As HttpWebResponse = _  
+           CType(webExcp.Response, HttpWebResponse)  
+        Console.WriteLine(CInt(httpResponse.StatusCode).ToString() & _  
+           " - " & httpResponse.StatusCode.ToString())  
+    End If  
+Catch e As Exception  
+    ' Code to catch other exceptions goes here.  
+End Try  
+```  
+  
+ エラーが Windows のソケットで計上ときに <xref:System.Net.Sockets.Socket> クラスの投球 [SocketExceptions](frlrfsystemnetsocketssocketexceptionclasstopic) を使用するアプリケーション。  [TCPListener](frlrfsystemnetsocketstcplistenerclasstopic)と [UDPClient](frlrfsystemnetsocketsudpclientclasstopic) の [&#91;TCPClient&#93;](frlrfsystemnetsocketstcpclientclasstopic)、クラスは、**\[ソケット\]** クラスの上に構築、**SocketExceptions** も投げます。  
+  
+ **SocketException** が投げられると、**SocketException** のクラスが未収最後のオペレーティング システムのソケットのエラーに <xref:System.Net.Sockets.SocketException.ErrorCode%2A> のプロパティを設定します。  ソケットのエラー コードの詳細については、MSDN の Winsock 2.0 の API のエラー コードのドキュメントを参照してください。  
+  
+## 参照  
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)   
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-access-http-specific-properties.md b/docs/framework/network-programming/how-to-access-http-specific-properties.md
new file mode 100644
index 00000000000..a4d91d51ce3
--- /dev/null
+++ b/docs/framework/network-programming/how-to-access-http-specific-properties.md
@@ -0,0 +1,62 @@
+---
+title: "方法: HTTP 固有のプロパティにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f8848c7e-f5c5-4d42-b86d-9951ff8f4146
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法: HTTP 固有のプロパティにアクセスする
+このオプションは、HTTP の **Keep\-alive** の動作を消し Web サーバーからプロトコルのバージョン番号を取得する方法を示します。  
+  
+## 使用例  
+  
+```vb  
+Dim HttpWReq As HttpWebRequest= _  
+    CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)  
+' Turn off connection keep-alives.  
+HttpWReq.KeepAlive = False  
+  
+Dim HttpWResp As HttpWebResponse = _  
+    CType(HttpWReq.GetResponse(), HttpWebResponse)  
+  
+' Get the HTTP protocol version number returned by the server.  
+Dim ver As String = HttpWResp.ProtocolVersion.ToString()  
+HttpWResp.Close()  
+```  
+  
+```csharp  
+HttpWebRequest HttpWReq =   
+    (HttpWebRequest)WebRequest.Create("http://www.contoso.com");  
+// Turn off connection keep-alives.  
+HttpWReq.KeepAlive = false;  
+  
+HttpWebResponse HttpWResp = (HttpWebResponse)HttpWReq.GetResponse();  
+  
+// Get the HTTP protocol version number returned by the server.  
+String ver = HttpWResp.ProtocolVersion.ToString();  
+HttpWResp.Close();  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 参照  
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)   
+ [HTTP](../../../docs/framework/network-programming/http.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-assign-user-information-to-group-connections.md b/docs/framework/network-programming/how-to-assign-user-information-to-group-connections.md
new file mode 100644
index 00000000000..f1cde2cf9a3
--- /dev/null
+++ b/docs/framework/network-programming/how-to-assign-user-information-to-group-connections.md
@@ -0,0 +1,123 @@
+---
+title: "方法: グループの接続にユーザー情報を割り当てる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 7ce550d6-8f7c-4ea7-add8-5bc27a7b51be
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法: グループの接続にユーザー情報を割り当てる
+[コード サンプル](#tskhowtoassignuserinformationtogroupconnectionsanchor1)  
+  
+ 次の例では、このセクションのコードが呼び出される前に、*ユーザー名は* 一意であるアプリケーションで変数の *ユーザー名*、*SecurelyStoredPassword*と *ドメインを* 設定するグループとの接続情報にユーザーを割り当てる方法を示します。  
+  
+### ユーザー グループの情報を接続に割り当てます。  
+  
+1.  接続のグループ名を作成します。  
+  
+    ```csharp  
+    SHA1Managed Sha1 = new SHA1Managed();  
+    Byte[] updHash = Sha1.ComputeHash(Encoding.UTF8.GetBytes(UserName + SecurelyStoredPassword + Domain));  
+    String secureGroupName = Encoding.Default.GetString(updHash);  
+    ```  
+  
+    ```vb  
+    Dim Sha1 As New SHA1Managed()  
+    Dim updHash As [Byte]() = Sha1.ComputeHash(Encoding.UTF8.GetBytes((UserName + SecurelyStoredPassword + Domain)))  
+    Dim secureGroupName As [String] = Encoding.Default.GetString(updHash)  
+    ```  
+  
+2.  特定の URL 依頼を作成します。  たとえば、次のコードは URL `http://www.contoso.com.`依頼を作成します  
+  
+    ```csharp  
+    WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");  
+    ```  
+  
+    ```vb  
+    Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")  
+    ```  
+  
+3.  **WebResponse** のオブジェクトを取得する Web 要求および通話時間 **GetResponse** の資格情報、接続 GroupName を設定します。  
+  
+    ```csharp  
+    myWebRequest.Credentials = new NetworkCredential(UserName, SecurelyStoredPassword, Domain);   
+    myWebRequest.ConnectionGroupName = secureGroupName;  
+  
+    WebResponse myWebResponse=myWebRequest.GetResponse();  
+    ```  
+  
+    ```vb  
+    myWebRequest.Credentials = New NetworkCredential(UserName, SecurelyStoredPassword, Domain)  
+    myWebRequest.ConnectionGroupName = secureGroupName  
+  
+    Dim myWebResponse As WebResponse = myWebRequest.GetResponse()  
+  
+    ```  
+  
+4.  WebRespose のオブジェクトを使用すると応答のベースを閉じます。  
+  
+    ```csharp  
+    MyWebResponse.Close();  
+  
+    ```  
+  
+    ```vb  
+    MyWebResponse.Close()  
+    ```  
+  
+ 例  
+  
+```csharp  
+// Create a connection group name.  
+SHA1Managed Sha1 = new SHA1Managed();  
+Byte[] updHash = Sha1.ComputeHash(Encoding.UTF8.GetBytes(UserName + SecurelyStoredPassword + Domain));  
+String secureGroupName = Encoding.Default.GetString(updHash);  
+  
+// Create a request for a specific URL.  
+WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");  
+  
+myWebRequest.Credentials = new NetworkCredential(UserName, SecurelyStoredPassword, Domain);   
+myWebRequest.ConnectionGroupName = secureGroupName;  
+  
+WebResponse myWebResponse=myWebRequest.GetResponse();  
+  
+// Insert the code that uses myWebResponse.  
+  
+MyWebResponse.Close();  
+  
+```  
+  
+```vb  
+' Create a secure group name.  
+Dim Sha1 As New SHA1Managed()  
+Dim updHash As [Byte]() = Sha1.ComputeHash(Encoding.UTF8.GetBytes((UserName + SecurelyStoredPassword + Domain)))  
+Dim secureGroupName As [String] = Encoding.Default.GetString(updHash)  
+  
+' Create a request for a specific URL.  
+Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")  
+  
+myWebRequest.Credentials = New NetworkCredential(UserName, SecurelyStoredPassword, Domain)  
+myWebRequest.ConnectionGroupName = secureGroupName  
+  
+Dim myWebResponse As WebResponse = myWebRequest.GetResponse()  
+  
+' Insert the code that uses myWebResponse.  
+MyWebResponse.Close()  
+```  
+  
+## 参照  
+ [接続の管理](../../../docs/framework/network-programming/managing-connections.md)   
+ [接続のグループ化](../../../docs/framework/network-programming/connection-grouping.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-configure-network-tracing.md b/docs/framework/network-programming/how-to-configure-network-tracing.md
new file mode 100644
index 00000000000..42a2b2f4c81
--- /dev/null
+++ b/docs/framework/network-programming/how-to-configure-network-tracing.md
@@ -0,0 +1,113 @@
+---
+title: "方法へまたは: ネットワーク追跡をコンフィギュレーションします。 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "app.config ファイル, ネットワーク追跡"
+  - "アプリケーション構成ファイル, ネットワーク追跡"
+  - "構成ファイル [.NET Framework], ネットワーク追跡"
+  - "書式指定 [.NET Framework], ネットワーク追跡"
+  - "レベル属性"
+  - "ネットワーク追跡, 構成"
+  - "セキュリティ レベルのトレース出力"
+  - "ソケット, トレース出力"
+ms.assetid: 5ef9fe4b-8d3d-490e-9259-1d014b2181af
+caps.latest.revision: 23
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 23
+---
+# 方法へまたは: ネットワーク追跡をコンフィギュレーションします。
+アプリケーションまたはコンピューターの構成ファイルには、ネットワークのトレースの形式と内容を決定する設定が保持されます。 この手順に従う前に、トレースが有効になっていることを確認します。 トレースを有効にする方法については、「[ネットワークのトレースの有効化](../../../docs/framework/network-programming/enabling-network-tracing.md)」を参照してください。  
+  
+ コンピューター構成ファイルの machine.config は、Windows をインストールしたディレクトリの %Windir%\\Microsoft.NET\\Framework フォルダーに格納されます。 コンピューターにインストールされた .NET Framework のバージョンごとに、%Windir%\\Microsoft.NET\\Framework の下のフォルダーに別々の machine.config ファイルがあります \(たとえば、C:\\WINDOWS\\Microsoft.NET\\Framework\\v2.0.50727\\machine.config\)。  
+  
+ これらの設定は、コンピューター構成ファイルよりも優先されるアプリケーション構成ファイルでも行うことができます。  
+  
+### ネットワークのトレースを構成するには  
+  
+-   適切な構成ファイルに次の行を追加します。 これらの設定の値とオプションを次の表に示します。  
+  
+    ```  
+    <configuration>  
+      <system.diagnostics>  
+        <sources>  
+          <source name="System.Net" tracemode="includehex" maxdatasize="1024">  
+            <listeners>  
+              <add name="System.Net"/>  
+            </listeners>  
+          </source>  
+          <source name="System.Net.Cache">  
+            <listeners>  
+              <add name="System.Net"/>  
+            </listeners>  
+          </source>  
+          <source name="System.Net.Http">  
+            <listeners>  
+              <add name="System.Net"/>  
+            </listeners>  
+          </source>  
+          <source name="System.Net.Sockets">  
+            <listeners>  
+              <add name="System.Net"/>  
+            </listeners>  
+          </source>  
+          <source name="System.Net.WebSockets">  
+            <listeners>  
+              <add name="System.Net"/>  
+            </listeners>  
+          </source>  
+        </sources>  
+        <switches>  
+          <add name="System.Net" value="Verbose"/>  
+          <add name="System.Net.Cache" value="Verbose"/>  
+          <add name="System.Net.Http" value="Verbose"/>  
+          <add name="System.Net.Sockets" value="Verbose"/>  
+          <add name="System.Net.WebSockets" value="Verbose"/>  
+        </switches>  
+        <sharedListeners>  
+          <add name="System.Net"  
+            type="System.Diagnostics.TextWriterTraceListener"  
+            initializeData="network.log"  
+          />  
+        </sharedListeners>  
+        <trace autoflush="true"/>  
+      </system.diagnostics>  
+    </configuration>  
+    ```  
+  
+ `<switches>` ブロックに名前を追加すると、トレース出力にその名前に関連する一部のメソッドからの情報が含まれます。 次の表に出力を示します。  
+  
+|名前|出力元|  
+|--------|---------|  
+|`System.Net.Sockets`|<xref:System.Net.Sockets.Socket>、<xref:System.Net.Sockets.TcpListener>、<xref:System.Net.Sockets.TcpClient>、および <xref:System.Net.Dns> クラスの一部のパブリック メソッド。|  
+|`System.Net`|<xref:System.Net.HttpWebRequest>、<xref:System.Net.HttpWebResponse>、<xref:System.Net.FtpWebRequest>、および <xref:System.Net.FtpWebResponse> クラスの一部のパブリック メソッド、および SSL デバッグ情報 \(無効な証明書、不足している発行元一覧、およびクライアント証明書エラー\)。|  
+|`System.Net.HttpListener`|<xref:System.Net.HttpListener>、<xref:System.Net.HttpListenerRequest>、および <xref:System.Net.HttpListenerResponse> クラスの一部のパブリック メソッド。|  
+|`System.Net.Cache`|`System.Net.Cache` 内の一部のプライベート メソッドと内部メソッド。|  
+|`System.Net.Http`|<xref:System.Net.Http.HttpClient>、<xref:System.Net.Http.DelegatingHandler>、<xref:System.Net.Http.HttpClientHandler>、<xref:System.Net.Http.HttpMessageHandler>、<xref:System.Net.Http.MessageProcessingHandler>、および <xref:System.Net.Http.WebRequestHandler> クラスの一部のパブリック メソッド。|  
+|`System.Net.WebSockets.WebSocket`|<xref:System.Net.WebSockets.ClientWebSocket> および <xref:System.Net.WebSockets.WebSocket> クラスの一部のパブリック メソッド。|  
+  
+ 次の表に示した属性で、トレース出力の書式を設定します。  
+  
+|属性名|属性値|  
+|---------|---------|  
+|`Value`|必須の <xref:System.String> 属性です。 出力の詳細度を設定します。 有効な値は、`Critical`、`Error`、`Verbose`、`Warning`、および `Information` です。<br /><br /> この属性は、この例に示すように、\<switches\> 要素の \<add name\> 要素で設定する必要があります。 この属性を \<source\> 要素で設定すると、例外がスローされます。|  
+|`maxdatasize`|省略可能な <xref:System.Int32> 属性です。 各行トレースに含まれるネットワーク データの最大バイト数を設定します。 既定値は 1024 です。<br /><br /> この属性は、この例に示すように、\<source\> 要素で設定する必要があります。 この属性を \<switches\> 要素の下の要素で設定すると、例外がスローされます。|  
+|`Tracemode`|省略可能な <xref:System.String> 属性です。 プロトコル トレースを 16 進数およびテキストの形式で表示するには、`includehex` に設定します。 テキストのみを表示するには、`protocolonly` に設定します。 既定値は `includehex` です。<br /><br /> この属性は、この例に示すように、\<switches\> 要素で設定する必要があります。 この属性を \<source\> 要素の下の要素で設定すると、例外がスローされます。|  
+  
+## 参照  
+ [ネットワークのトレースの解釈](../../../docs/framework/network-programming/interpreting-network-tracing.md)   
+ [.NET Framework のネットワークのトレース](../../../docs/framework/network-programming/network-tracing.md)   
+ [ネットワークのトレースの有効化](../../../docs/framework/network-programming/enabling-network-tracing.md)   
+ [実装とトレースの概要](http://msdn.microsoft.com/ja-jp/e924e57c-33cf-4b0e-9e7f-a45d13e38f2c)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-create-a-socket.md b/docs/framework/network-programming/how-to-create-a-socket.md
new file mode 100644
index 00000000000..86c431fdf47
--- /dev/null
+++ b/docs/framework/network-programming/how-to-create-a-socket.md
@@ -0,0 +1,74 @@
+---
+title: "方法: ソケットを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "ネットワーク"
+  - "送信 (データの)、ソケット"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "ソケット クラス、ソケットの作成"
+  - "ネットワーク リソース"
+  - "受信 (データの)、ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+  - "ソケット、作成"
+ms.assetid: c64a049c-5981-43bc-a2dc-1851473589c7
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# 方法: ソケットを作成する
+リモート デバイスと通信するためにソケットを使用するにはソケット プロトコルとネットワーク アドレス情報を初期化する必要があります。  <xref:System.Net.Sockets.Socket> クラスのコンストラクターはソケットが接続にするために使用する住所ファミリ、ソケットの型およびプロトコル タイプを指定するパラメータがあります。  
+  
+## 使用例  
+ 次の例では、TCP\/IP ベースのネットワークの通信に使用できるインターネットなどのソケットを作成します。  
+  
+```csharp  
+Socket s = new Socket(AddressFamily.InterNetwork,   
+   SocketType.Stream, ProtocolType.Tcp);  
+```  
+  
+```vb  
+Dim s as New Socket(AddressFamily.InterNetwork, _  
+   SocketType.Stream, ProtocolType.Tcp)  
+  
+```  
+  
+ TCP にではなく、UDP を使用するには、次の例でプロトコル タイプを変更します:  
+  
+```csharp  
+Socket s = new Socket(AddressFamily.InterNetwork,   
+   SocketType.Dgram, ProtocolType.Udp);  
+```  
+  
+```vb  
+Dim s as New Socket(AddressFamily.InterNetwork, _  
+   SocketType.Dgram, ProtocolType.Udp)  
+  
+```  
+  
+ <xref:System.Net.Sockets.AddressFamily> の列挙型は、ネットワーク アドレスを決済するには **\[ソケット\]** クラスで使用される標準の住所のファミリーを指定します \(たとえば、**AddressFamily.InterNetwork** のメンバは、IP \(バージョン 4 の住所のファミリーを指定します。  
+  
+ <xref:System.Net.Sockets.SocketType> の列挙型はソケットのタイプを指定します \(たとえば、**SocketType.Stream** のメンバは、フロー制御して、データを送受信するための標準ソケットを表示します\)。  
+  
+ ソケットが TCP を使用することを <xref:System.Net.Sockets.ProtocolType> の **\[ソケット\]** の通信使用するネットワーク プロトコルをいつ指定します \(たとえば、**ProtocolType.Tcp** ;を表示します **ProtocolType.Udp** はソケットを UDP を使用することを示します。\)  
+  
+ **\[ソケット\]** が作成された後、エンドポイントへのリモート接続を開始またはデバイスのリモート接続を受け入れることができます。  
+  
+## 参照  
+ [クライアント ソケットの使用](../../../docs/framework/network-programming/using-client-sockets.md)   
+ [リッスン \(ソケットで\)](../../../docs/framework/network-programming/listening-with-sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-customize-a-time-based-cache-policy.md b/docs/framework/network-programming/how-to-customize-a-time-based-cache-policy.md
new file mode 100644
index 00000000000..1a99ed65941
--- /dev/null
+++ b/docs/framework/network-programming/how-to-customize-a-time-based-cache-policy.md
@@ -0,0 +1,130 @@
+---
+title: "方法: 時間ベースのキャッシュ ポリシーをカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "時間ベースのキャッシュ ポリシー"
+  - "時間ベースのキャッシュ ポリシーのカスタマイズ"
+  - "キャッシュ [.NET Framework]、時間ベースのポリシー"
+ms.assetid: 8d84f936-2376-4356-9264-03162e0f9279
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 15
+---
+# 方法: 時間ベースのキャッシュ ポリシーをカスタマイズする
+時間ベースのキャッシュのポリシーを作成すると、最大期日が経過する新鮮さ、最小、最大の staleness、またはキャッシュの同期の日付値を指定することによってキャッシュの動作をカスタマイズできます。  <xref:System.Net.Cache.HttpRequestCachePolicy> のオブジェクトは、これらの値の有効な組み合わせを指定できるようにする複数のコンストラクターを提供します。  
+  
+### キャッシュの同期の日付を使用する時間ベースのキャッシュのポリシーを作成します。  
+  
+-   <xref:System.Net.Cache.HttpRequestCachePolicy> のコンストラクターに <xref:System.DateTime> のオブジェクトを渡すことによって、キャッシュの同期の日付を使用する時間ベースのキャッシュのポリシーを作成します。  
+  
+    ```csharp  
+    public static HttpRequestCachePolicy CreateLastSyncPolicy(DateTime when)  
+    {  
+        HttpRequestCachePolicy policy =   
+            new HttpRequestCachePolicy(when);  
+        Console.WriteLine("When: {0}", when);  
+        Console.WriteLine(policy.ToString());  
+        return policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Function CreateLastSyncPolicy([when] As DateTime) As HttpRequestCachePolicy  
+        Dim policy As New HttpRequestCachePolicy([when])  
+        Console.WriteLine("When: {0}", [when])  
+        Console.WriteLine(policy.ToString())  
+        Return policy  
+    End Function  
+    ```  
+  
+ 出荷は次に似ています:  
+  
+```  
+When: 1/14/2004 8:07:30 AM  
+Level:Default CacheSyncDate:1/14/2004 8:07:30 AM  
+```  
+  
+### 最小新鮮さに基づく時間ベースのキャッシュのポリシーを作成します。  
+  
+-   最小新鮮さに `cacheAgeControl` パラメータ値として <xref:System.Net.Cache.HttpCacheAgeControl> を指定し、<xref:System.Net.Cache.HttpRequestCachePolicy> のコンストラクターに <xref:System.TimeSpan> のオブジェクトを渡すことに基づく時間ベースのキャッシュのポリシーを作成します。  
+  
+    ```csharp  
+    public static HttpRequestCachePolicy CreateMinFreshPolicy(TimeSpan span)  
+    {  
+        HttpRequestCachePolicy policy =   
+            new HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span);  
+        Console.WriteLine(policy.ToString());  
+        return policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Function CreateMinFreshPolicy(span As TimeSpan) As HttpRequestCachePolicy  
+        Dim policy As New HttpRequestCachePolicy(HttpCacheAgeControl.MinFresh, span)  
+        Console.WriteLine(policy.ToString())  
+        Return policy  
+    End Function  
+    ```  
+  
+ 次の通話の場合:  
+  
+```  
+CreateMinFreshPolicy(new TimeSpan(1,0,0));  
+```  
+  
+```  
+Level:Default MinFresh:3600  
+  
+```  
+  
+### 新鮮さ最小と最大期日が経過に基づく時間ベースのキャッシュのポリシーを作成します。  
+  
+-   最大期日が経過すると最小新鮮さに `cacheAgeControl` パラメータ値として <xref:System.Net.Cache.HttpCacheAgeControl> を指定し、<xref:System.Net.Cache.HttpRequestCachePolicy> のコンストラクターに <xref:System.TimeSpan> の 2 種類のオブジェクトを渡すことに基づく時間ベースのキャッシュのポリシーを、許可されるキャッシュから返されるオブジェクトに最小新鮮さを指定するためにリソースおよび秒\) の間の最大期日が経過するを指定する 1 件作成します。  
+  
+    ```csharp  
+    public static HttpRequestCachePolicy CreateFreshAndAgePolicy(TimeSpan freshMinimum, TimeSpan ageMaximum)  
+    {  
+        HttpRequestCachePolicy policy =   
+        new HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum);  
+        Console.WriteLine(policy.ToString());  
+        return policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Function CreateFreshAndAgePolicy(freshMinimum As TimeSpan, ageMaximum As TimeSpan) As HttpRequestCachePolicy  
+        Dim policy As New HttpRequestCachePolicy(HttpCacheAgeControl.MaxAgeAndMinFresh, ageMaximum, freshMinimum)  
+        Console.WriteLine(policy.ToString())  
+        Return policy  
+    End Function  
+    ```  
+  
+ 次の通話の場合:  
+  
+```  
+CreateFreshAndAgePolicy(new TimeSpan(5,0,0), new TimeSpan(10,0,0));  
+```  
+  
+```  
+Level:Default MaxAge:36000 MinFresh:18000  
+```  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-detect-network-availability-and-address-changes.md b/docs/framework/network-programming/how-to-detect-network-availability-and-address-changes.md
new file mode 100644
index 00000000000..5c86d9e97b8
--- /dev/null
+++ b/docs/framework/network-programming/how-to-detect-network-availability-and-address-changes.md
@@ -0,0 +1,61 @@
+---
+title: "方法: ネットワークの可用性とアドレスの変更を検出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+ms.assetid: d4377115-4a76-4848-ab23-4898d65c771c
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# 方法: ネットワークの可用性とアドレスの変更を検出する
+このオプションは、インターフェイスのネットワーク アドレスの変更を検出する方法を示します。  
+  
+## 使用例  
+  
+```  
+using System;  
+using System.Net;  
+using System.Net.NetworkInformation;  
+  
+namespace Examples.Net.AddressChanges  
+{  
+    public class NetworkingExample  
+    {  
+        public static void Main()  
+        {  
+            NetworkChange.NetworkAddressChanged += new   
+             NetworkAddressChangedEventHandler(AddressChangedCallback);  
+            Console.WriteLine("Listening for address changes. Press any key to exit.");  
+            Console.ReadLine();  
+        }  
+        static void AddressChangedCallback(object sender, EventArgs e)  
+        {  
+  
+            NetworkInterface[] adapters = NetworkInterface.GetAllNetworkInterfaces();  
+            foreach(NetworkInterface n in adapters)  
+            {  
+                Console.WriteLine("   {0} is {1}", n.Name, n.OperationalStatus);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-download-files-with-ftp.md b/docs/framework/network-programming/how-to-download-files-with-ftp.md
new file mode 100644
index 00000000000..2ff97b50c33
--- /dev/null
+++ b/docs/framework/network-programming/how-to-download-files-with-ftp.md
@@ -0,0 +1,68 @@
+---
+title: "方法: FTP を使用してファイルをダウンロードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 892548b8-954a-4f6a-9bca-2ae620c3700f
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# 方法: FTP を使用してファイルをダウンロードする
+このオプションは、FTP サーバーからファイルをダウンロードする方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Net;  
+using System.Text;  
+  
+namespace Examples.System.Net  
+{  
+    public class WebRequestGetExample  
+    {  
+        public static void Main ()  
+        {  
+            // Get the object used to communicate with the server.  
+            FtpWebRequest request = (FtpWebRequest)WebRequest.Create("ftp://www.contoso.com/test.htm");  
+            request.Method = WebRequestMethods.Ftp.DownloadFile;  
+  
+            // This example assumes the FTP site uses anonymous logon.  
+            request.Credentials = new NetworkCredential ("anonymous","janeDoe@contoso.com");  
+  
+            FtpWebResponse response = (FtpWebResponse)request.GetResponse();  
+  
+            Stream responseStream = response.GetResponseStream();  
+            StreamReader reader = new StreamReader(responseStream);  
+            Console.WriteLine(reader.ReadToEnd());  
+  
+            Console.WriteLine("Download Complete, status {0}", response.StatusDescription);  
+  
+            reader.Close();  
+            response.Close();    
+        }  
+    }  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 信頼性の高いプログラミング  
+  
+## .NET Framework セキュリティ
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md b/docs/framework/network-programming/how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md
new file mode 100644
index 00000000000..ce320c91608
--- /dev/null
+++ b/docs/framework/network-programming/how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md
@@ -0,0 +1,44 @@
+---
+title: "方法: WebRequest でインターネットとの通信にプロキシを使用できるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 63c0ef2c-44b5-4c54-9804-ba0b9b001ac7
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# 方法: WebRequest でインターネットとの通信にプロキシを使用できるようにする
+この例では、プロキシを使用することをインターネットと通信するために <xref:System.Net.WebRequest> を使用するグローバルなプロキシ インスタンスを作成します。  たとえば、プロキシ サーバーが `webproxy` というと、ポート 80 の通信と、標準の HTTP ポートとします。  
+  
+## 使用例  
+  
+```csharp  
+WebProxy proxyObject = new WebProxy("http://webproxy:80/");  
+GlobalProxySelection.Select = proxyObject;  
+```  
+  
+```vb  
+Dim proxyObject As WebProxy = New WebProxy("http://webproxy:80/")  
+GlobalProxySelection.Select = proxyObject  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 参照  
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)   
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-get-interface-and-protocol-information.md b/docs/framework/network-programming/how-to-get-interface-and-protocol-information.md
new file mode 100644
index 00000000000..56051946623
--- /dev/null
+++ b/docs/framework/network-programming/how-to-get-interface-and-protocol-information.md
@@ -0,0 +1,85 @@
+---
+title: "方法: インターフェイス情報とプロトコル情報を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+ms.assetid: fd88d26c-4063-495e-a253-736ac3e6b23f
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# 方法: インターフェイス情報とプロトコル情報を取得する
+このオプションは、ネットワーク インターフェイスの TCP 統計量を読み込む方法を示します。  
+  
+## 使用例  
+  
+```  
+public static void ShowTcpStatistics(NetworkInterfaceComponent version)  
+{  
+    IPGlobalProperties properties =  
+          IPGlobalProperties.GetIPGlobalProperties();  
+    TcpStatistics tcpstat = null;  
+    Console.WriteLine("");  
+    switch (version)  
+    {  
+        case NetworkInterfaceComponent.IPv4:  
+             tcpstat = properties.GetTcpIPv4Statistics();  
+            Console.WriteLine("TCP/IPv4 Statistics:");  
+            break;  
+        case NetworkInterfaceComponent.IPv6:  
+            tcpstat = properties.GetTcpIPv6Statistics();  
+            Console.WriteLine("TCP/IPv6 Statistics:");  
+            break;  
+        default:  
+            throw new ArgumentException("version");  
+            break;  
+    }  
+    Console.WriteLine("  Minimum Transmission Timeout. : {0}",   
+        tcpstat.MinimumTransmissionTimeout);  
+    Console.WriteLine("  Maximum Transmission Timeout. : {0}",   
+        tcpstat.MaximumTransmissionTimeout);  
+  
+    Console.WriteLine("  Connection Data:");  
+    Console.WriteLine("      Current : {0}",   
+    tcpstat.CurrentConnections);  
+    Console.WriteLine("      Cumulative : {0}",   
+        tcpstat.CumulativeConnections);  
+    Console.WriteLine("      Initiated  : {0}",   
+        tcpstat.ConnectionsInitiated);  
+    Console.WriteLine("      Accepted : {0}",   
+        tcpstat.ConnectionsAccepted);  
+    Console.WriteLine("      Failed Attempts : {0}",   
+        tcpstat.FailedConnectionAttempts);  
+    Console.WriteLine("      Reset : {0}",   
+        tcpstat.ResetConnections);  
+  
+    Console.WriteLine("");  
+    Console.WriteLine("  Segment Data:");  
+    Console.WriteLine("      Received  ................... : {0}",   
+        tcpstat.SegmentsReceived);  
+    Console.WriteLine("      Sent : {0}",   
+        tcpstat.SegmentsSent);  
+    Console.WriteLine("      Retransmitted : {0}",   
+        tcpstat.SegmentsResent);  
+  
+    Console.WriteLine("");  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-list-directory-contents-with-ftp.md b/docs/framework/network-programming/how-to-list-directory-contents-with-ftp.md
new file mode 100644
index 00000000000..d4ca290a411
--- /dev/null
+++ b/docs/framework/network-programming/how-to-list-directory-contents-with-ftp.md
@@ -0,0 +1,68 @@
+---
+title: "方法: FTP でディレクトリの内容を一覧表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 130c64c9-7b7f-4672-9b3b-d946bd2616c5
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# 方法: FTP でディレクトリの内容を一覧表示する
+このオプションは、FTP サーバー ディレクトリの内容を一覧方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Net;  
+using System.Text;  
+  
+namespace Examples.System.Net  
+{  
+    public class WebRequestGetExample  
+    {  
+        public static void Main ()  
+        {  
+            // Get the object used to communicate with the server.  
+            FtpWebRequest request = (FtpWebRequest)WebRequest.Create("ftp://www.contoso.com/");  
+            request.Method = WebRequestMethods.Ftp.ListDirectoryDetails;  
+  
+            // This example assumes the FTP site uses anonymous logon.  
+            request.Credentials = new NetworkCredential ("anonymous","janeDoe@contoso.com");  
+  
+            FtpWebResponse response = (FtpWebResponse)request.GetResponse();  
+  
+            Stream responseStream = response.GetResponseStream();  
+            StreamReader reader = new StreamReader(responseStream);  
+            Console.WriteLine(reader.ReadToEnd());  
+  
+            Console.WriteLine("Directory List Complete, status {0}", response.StatusDescription);  
+  
+            reader.Close();  
+            response.Close();  
+        }  
+    }  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 信頼性の高いプログラミング  
+  
+## .NET Framework セキュリティ
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md b/docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md
new file mode 100644
index 00000000000..004d91af65b
--- /dev/null
+++ b/docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md
@@ -0,0 +1,51 @@
+---
+title: "方法: IPv6 のサポートを有効にするようにコンピューター構成ファイルを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 5611b677-b9cc-43b8-a434-60e18d89aada
+caps.latest.revision: 18
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 18
+---
+# 方法: IPv6 のサポートを有効にするようにコンピューター構成ファイルを変更する
+次のコード例に示します。コンピュータのコンフィギュレーション ファイル、*machine.config*を IPv6 のサポートを有効にする方法を変更する。  *machine.config* ファイルを Windows がインストール ディレクトリの *%Windir%\\Microsoft.NET\\Framework* のフォルダに保存されます。  .NET Framework コンピュータにインストールされている \(たとえば、*C:\\WINDOWS\\Microsoft.NET\\Framework\\v2.0.50727\\machine.config*\) 各バージョンの *%Windir%\\Microsoft.NET\\Framework* の下に *machine.config* のフォルダに固有のファイル。  
+  
+ これらの設定は、コンフィギュレーション ファイルのコンピュータ上の優先順位があるアプリケーションのコンフィギュレーション ファイルで作成できます。  
+  
+ .NET Framework Version 1.1 が、以前の **ipv6 enabled**、コンポーネントの Switch の値はかどうか <xref:System.Net.Dns?displayProperty=fullName> クラスの返品 IPv6 の住所のメンバ指定します。  
+  
+ .NET Framework Version 2.0 と後で、<xref:System.Net.Dns?displayProperty=fullName> クラスのすべてのメンバーに Windows が IPv6 をサポート \(たとえば、<xref:System.Net.Dns.GetHostEntry%2A?displayProperty=fullName> 方法\)、1 種類の制限の IPv6 の住所を返します。  <xref:System.Net.Dns?displayProperty=fullName> クラスによって不要のメンバは、\(たとえば、<xref:System.Net.Dns.Resolve%2A?displayProperty=fullName> 方法\) コンフィギュレーション ファイルの値を読み、確認します。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 が、後で、IPv6 は、既定で有効になります。  .NET Framework Version 1.1 には、以前の IPv6 は既定で無効になります。  
+  
+## 使用例  
+  
+```  
+<system.net>  
+    …………  
+    <settings>  
+        …………  
+        <ipv6 enabled="true"/>   
+    ……………  
+    </settings>  
+    ………………  
+<system.net>  
+```  
+  
+## 参照  
+ [IPv6 アドレス指定](../../../docs/framework/network-programming/ipv6-addressing.md)   
+ [ネットワーク設定スキーマ](../../../docs/framework/configure-apps/file-schema/network/index.md)   
+ [\<ipv6\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/ipv6-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-override-a-global-proxy-selection.md b/docs/framework/network-programming/how-to-override-a-global-proxy-selection.md
new file mode 100644
index 00000000000..c5e229fe551
--- /dev/null
+++ b/docs/framework/network-programming/how-to-override-a-global-proxy-selection.md
@@ -0,0 +1,44 @@
+---
+title: "方法: グローバル プロキシの選択をオーバーライドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 0da481a9-b414-4230-beb0-e3ceba882fe5
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法: グローバル プロキシの選択をオーバーライドする
+ポート 80 で `alternateproxy` というプロキシ サーバーとのグローバルなプロキシの選択を上書きこの例では、www.contoso.com に **\[WebRequest\]** を送信した示します。  
+  
+## 使用例  
+  
+```csharp  
+WebRequest req = WebRequest.Create("http://www.contoso.com/");  
+req.Proxy = new WebProxy("http://alternateproxy:80/");  
+```  
+  
+```vb  
+Dim req As WebRequest = WebRequest.Create("http://www.contoso.com/")  
+req.Proxy = New WebProxy("http://alternateproxy:80/")  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 参照  
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)   
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-ping-a-host.md b/docs/framework/network-programming/how-to-ping-a-host.md
new file mode 100644
index 00000000000..339879a98b6
--- /dev/null
+++ b/docs/framework/network-programming/how-to-ping-a-host.md
@@ -0,0 +1,136 @@
+---
+title: "方法: ホストに対して ping を実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ping"
+ms.assetid: bbf20f5b-eca1-4661-af04-cb8837f9af05
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# 方法: ホストに対して ping を実行
+このオプションは、リモートをホスト ポーンと音を行う方法を示します。  
+  
+## 使用例  
+  
+```  
+using System;  
+using System.Text;  
+using System.Net;  
+using System.Net.NetworkInformation;  
+using System.ComponentModel;  
+using System.Threading;  
+  
+namespace Examples.System.Net.NetworkInformation.PingTest  
+{  
+    public class PingExample  
+    {  
+        public static void Main (string[] args)  
+        {  
+            if (args.Length == 0)  
+                throw new ArgumentException ("Ping needs a host or IP Address.");  
+  
+            string who = args[0];  
+            AutoResetEvent waiter = new AutoResetEvent (false);  
+  
+            Ping pingSender = new Ping ();  
+  
+            // When the PingCompleted event is raised,  
+            // the PingCompletedCallback method is called.  
+            pingSender.PingCompleted += new PingCompletedEventHandler (PingCompletedCallback);  
+  
+            // Create a buffer of 32 bytes of data to be transmitted.  
+            string data = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";  
+            byte[] buffer = Encoding.ASCII.GetBytes (data);  
+  
+            // Wait 12 seconds for a reply.  
+            int timeout = 12000;  
+  
+            // Set options for transmission:  
+            // The data can go through 64 gateways or routers  
+            // before it is destroyed, and the data packet  
+            // cannot be fragmented.  
+            PingOptions options = new PingOptions (64, true);  
+  
+            Console.WriteLine ("Time to live: {0}", options.Ttl);  
+            Console.WriteLine ("Don't fragment: {0}", options.DontFragment);  
+  
+            // Send the ping asynchronously.  
+            // Use the waiter as the user token.  
+            // When the callback completes, it can wake up this thread.  
+            pingSender.SendAsync(who, timeout, buffer, options, waiter);  
+  
+            // Prevent this example application from ending.  
+            // A real application should do something useful  
+            // when possible.  
+            waiter.WaitOne ();  
+            Console.WriteLine ("Ping example completed.");  
+        }  
+  
+        public static void PingCompletedCallback (object sender, PingCompletedEventArgs e)  
+        {  
+            // If the operation was canceled, display a message to the user.  
+            if (e.Cancelled)  
+            {  
+                Console.WriteLine ("Ping canceled.");  
+  
+                // Let the main thread resume.   
+                // UserToken is the AutoResetEvent object that the main thread   
+                // is waiting for.  
+                ((AutoResetEvent)e.UserState).Set ();  
+            }  
+  
+            // If an error occurred, display the exception to the user.  
+            if (e.Error != null)  
+            {  
+                Console.WriteLine ("Ping failed:");  
+                Console.WriteLine (e.Error.ToString ());  
+  
+                // Let the main thread resume.   
+                ((AutoResetEvent)e.UserState).Set();  
+            }  
+  
+            PingReply reply = e.Reply;  
+  
+            DisplayReply (reply);  
+  
+            // Let the main thread resume.  
+            ((AutoResetEvent)e.UserState).Set();  
+        }  
+  
+        public static void DisplayReply (PingReply reply)  
+        {  
+            if (reply == null)  
+                return;  
+  
+            Console.WriteLine ("ping status: {0}", reply.Status);  
+            if (reply.Status == IPStatus.Success)  
+            {  
+                Console.WriteLine ("Address: {0}", reply.Address.ToString ());  
+                Console.WriteLine ("RoundTrip time: {0}", reply.RoundtripTime);  
+                Console.WriteLine ("Time to live: {0}", reply.Options.Ttl);  
+                Console.WriteLine ("Don't fragment: {0}", reply.Options.DontFragment);  
+                Console.WriteLine ("Buffer size: {0}", reply.Buffer.Length);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-register-a-custom-protocol-using-webrequest.md b/docs/framework/network-programming/how-to-register-a-custom-protocol-using-webrequest.md
new file mode 100644
index 00000000000..176f433f498
--- /dev/null
+++ b/docs/framework/network-programming/how-to-register-a-custom-protocol-using-webrequest.md
@@ -0,0 +1,43 @@
+---
+title: "方法: WebRequest を使用してカスタム プロトコルを登録する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 98ddbdb9-66b1-4080-92ad-51f5c447fcf8
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 方法: WebRequest を使用してカスタム プロトコルを登録する
+この例では、対応する classthat プロトコルを登録する方法を他の場所で定義されますが表示されます。  この例では、`CustomWebRequestCreator` ユーザーが実行されたオブジェクトに実装 `CustomWebRequest` のオブジェクトを返品 **\[作成\]** 方法です。  コード例は、注文プロトコルを実行する `CustomWebRequest` コードを書き込んだいます。  
+  
+## 使用例  
+  
+```csharp  
+WebRequest.RegisterPrefix("custom", new CustomWebRequestCreator());  
+WebRequest req = WebRequest.Create("custom://customHost.contoso.com/");  
+```  
+  
+```vb  
+WebRequest.RegisterPrefix("custom", New CustomWebRequestCreator())  
+Dim req As WebRequest = WebRequest.Create("custom://customHost.contoso.com/")  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+ <xref:System.Net> の名前空間への参照。  
+  
+## 参照  
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md b/docs/framework/network-programming/how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md
new file mode 100644
index 00000000000..9ae1a6c23f9
--- /dev/null
+++ b/docs/framework/network-programming/how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md
@@ -0,0 +1,47 @@
+---
+title: "方法: Web ページを要求し、ストリームとして結果を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d32b7f35-29d8-4fb7-ad71-d219edc5e359
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 方法: Web ページを要求し、ストリームとして結果を取得する
+この例に Web ページを要求しストリームの結果を取得する方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+WebClient myClient = new WebClient();  
+Stream response = myClient.OpenRead("http://www.contoso.com/index.htm");  
+// The stream data is used here.  
+response.Close();  
+```  
+  
+```vb  
+Dim myClient As WebClient = New WebClient()  
+Dim response As Stream = myClient.OpenRead("http://www.contoso.com/index.htm")  
+' The stream data is used here.  
+response.Close()  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   <xref:System.IO> 名前空間および <xref:System.Net> 名前空間への参照。  
+  
+## 参照  
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md b/docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md
new file mode 100644
index 00000000000..a0ddd4ff6b5
--- /dev/null
+++ b/docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md
@@ -0,0 +1,192 @@
+---
+title: "方法: WebRequest クラスを使用してデータを要求する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダウンロード (インターネット リソースの)、手順"
+  - "要求 (インターネットからデータを)、手順"
+  - "WebRequest クラス、受信 (データを)"
+  - "受信 (データを)、使用 (WebRequest クラスを)"
+  - "インターネット、要求 (データを)"
+ms.assetid: 368b8d0f-dc5e-4469-a8b8-b2adbf5dd800
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法: WebRequest クラスを使用してデータを要求する
+次のサーバー プロシージャは、たとえば、Web ページまたはファイルからリソースを要求する手順について説明します。  リソースは URI によって識別する必要があります。  
+  
+### ホスト サーバーからのデータを要求します。  
+  
+1.  リソースの URI の <xref:System.Net.WebRequest.Create%2A> の呼び出し、<xref:System.Net.WebRequest> のインスタンスを作成します。  
+  
+    ```csharp  
+    WebRequest request = WebRequest.Create("http://www.contoso.com/");  
+    ```  
+  
+    ```vb  
+    Dim request as WebRequest = WebRequest.Create("http://www.contoso.com/")  
+  
+    ```  
+  
+    > [!NOTE]
+    >  .NET Framework は、「http で始まる URI に **\[WebRequest\]** と **WebResponse** から派生したプロトコル対応クラスを提供します: 」、「https:'' 「ftp: 」、および「ファイル: 」  他のプロトコルを使用してリソースにアクセスするには、**\[WebRequest\]** と **WebResponse**から取得プロトコル対応クラスを行う必要があります。  詳細については、「[プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)」を参照してください。  
+  
+2.  、**\[WebRequest\]**で必要なプロパティ値を設定します。  たとえば、認証を有効にするには、<xref:System.Net.NetworkCredential> クラスのインスタンスに **\[資格情報\]** のプロパティを設定します。  
+  
+    ```csharp  
+    request.Credentials = CredentialCache.DefaultCredentials;  
+    ```  
+  
+    ```vb  
+    request.Credentials = CredentialCache.DefaultCredentials  
+    ```  
+  
+     ほとんどの場合、**\[WebRequest\]** のクラスは、データを受信する十分です。  ただし、プロトコル対応するプロパティを設定する必要があるプロトコル タイプに対応 **\[WebRequest\]** をキャスト必要があります。  たとえば、<xref:System.Net.HttpWebRequest>の Http 固有のプロパティにアクセスするには、**HttpWebRequest** の参照に **\[WebRequest\]** をキャスト。  次の例は <xref:System.Net.HttpWebRequest.UserAgent%2A> コードの Http 固有のプロパティを設定する方法を示します。  
+  
+    ```csharp  
+    ((HttpWebRequest)request).UserAgent = ".NET Framework Example Client";  
+    ```  
+  
+    ```vb  
+    Ctype(request,HttpWebRequest).UserAgent = ".NET Framework Example Client"  
+  
+    ```  
+  
+3.  サーバーに要求を送信するには、<xref:System.Net.HttpWebRequest.GetResponse%2A>を追加します。  **WebResponse** の返品オブジェクトの実際の型は、要求された URI の設定によって決まります。  
+  
+    ```csharp  
+    WebResponse response = request.GetResponse();  
+    ```  
+  
+    ```vb  
+    Dim response As WebResponse = request.GetResponse()  
+  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Net.WebResponse> のオブジェクトを終了したら、<xref:System.Net.WebResponse.Close%2A> 方法の名前と閉じなければ必要があります。  または応答オブジェクトからの応答ストリームを獲得したとき、<xref:System.IO.Stream.Close%2A?displayProperty=fullName> メソッド呼び出し、ストリームを決済できます。  応答またはストリームを閉じなければ、アプリケーションは、追加情報を処理してサーバーへの接続を使い果たし、なくすることができます。  
+  
+4.  **WebResponse** のプロパティをアクセス プロトコルまたは対応のインスタンスに対応プロトコルのプロパティを読み取る場合に **WebResponse** をキャストできます。  たとえば、<xref:System.Net.HttpWebResponse>の Http 固有のプロパティにアクセスするには、**HttpWebResponse** の参照に **WebResponse** をキャスト。  次の例では、応答コードととも状態情報を表示する方法を示します。  
+  
+    ```csharp  
+    Console.WriteLine (((HttpWebResponse)response).StatusDescription);  
+    ```  
+  
+    ```vb  
+    Console.WriteLine(CType(response,HttpWebResponse).StatusDescription)  
+    ```  
+  
+5.  サーバーが送信する応答のデータを含むストリームを取得するには **WebResponse**の <xref:System.Net.HttpWebResponse.GetResponseStream%2A> 方法を使用します。  
+  
+    ```csharp  
+    Stream dataStream = response.GetResponseStream ();  
+    ```  
+  
+    ```vb  
+    Dim dataStream As Stream = response.GetResponseStream()  
+  
+    ```  
+  
+6.  応答からのデータを読んだと、**\[Stream.Close\]** 方法を使用して応答のベースを決算または **\[WebResponse.Close\]** 方法を使用して応答を閉じなければ必要があります。  両方の **\[閉じる\]** 方法を応答のベースと **WebResponse**というする必要はありませんが、編集することで、破壊試験ではありません。  応答を閉じるときに**\[WebResponse.Close\]** の通話 **\[Stream.Close\]**。  
+  
+    ```csharp  
+    response.Close();  
+    ```  
+  
+    ```vb  
+    response.Close()  
+  
+    ```  
+  
+## 使用例  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Net;  
+using System.Text;  
+  
+namespace Examples.System.Net  
+{  
+    public class WebRequestGetExample  
+    {  
+        public static void Main ()  
+        {  
+            // Create a request for the URL.   
+            WebRequest request = WebRequest.Create (  
+              "http://www.contoso.com/default.html");  
+            // If required by the server, set the credentials.  
+            request.Credentials = CredentialCache.DefaultCredentials;  
+            // Get the response.  
+            WebResponse response = request.GetResponse ();  
+            // Display the status.  
+            Console.WriteLine (((HttpWebResponse)response).StatusDescription);  
+            // Get the stream containing content returned by the server.  
+            Stream dataStream = response.GetResponseStream ();  
+            // Open the stream using a StreamReader for easy access.  
+            StreamReader reader = new StreamReader (dataStream);  
+            // Read the content.  
+            string responseFromServer = reader.ReadToEnd ();  
+            // Display the content.  
+            Console.WriteLine (responseFromServer);  
+            // Clean up the streams and the response.  
+            reader.Close ();  
+            response.Close ();  
+        }  
+    }  
+}  
+```  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Net  
+Imports System.Text  
+Namespace Examples.System.Net  
+    Public Class WebRequestGetExample  
+  
+        Public Shared Sub Main()  
+            ' Create a request for the URL.   
+            Dim request As WebRequest = _  
+              WebRequest.Create("http://www.contoso.com/default.html")  
+            ' If required by the server, set the credentials.  
+            request.Credentials = CredentialCache.DefaultCredentials  
+            ' Get the response.  
+            Dim response As WebResponse = request.GetResponse()  
+            ' Display the status.  
+            Console.WriteLine(CType(response,HttpWebResponse).StatusDescription)  
+            ' Get the stream containing content returned by the server.  
+            Dim dataStream As Stream = response.GetResponseStream()  
+            ' Open the stream using a StreamReader for easy access.  
+            Dim reader As New StreamReader(dataStream)  
+            ' Read the content.  
+            Dim responseFromServer As String = reader.ReadToEnd()  
+            ' Display the content.  
+            Console.WriteLine(responseFromServer)  
+            ' Clean up the streams and the response.  
+            reader.Close()  
+            response.Close()  
+        End Sub   
+    End Class   
+End Namespace  
+```  
+  
+## 参照  
+ [インターネット要求の作成](../../../docs/framework/network-programming/creating-internet-requests.md)   
+ [ネットワーク上でストリームを使用する](../../../docs/framework/network-programming/using-streams-on-the-network.md)   
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)   
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)   
+ [方法: WebRequest クラスを使用してデータを送信する](../../../docs/framework/network-programming/how-to-send-data-using-the-webrequest-class.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md b/docs/framework/network-programming/how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md
new file mode 100644
index 00000000000..8c1f6b62ef6
--- /dev/null
+++ b/docs/framework/network-programming/how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md
@@ -0,0 +1,43 @@
+---
+title: "方法: WebRequest に一致するプロトコル固有の WebResponse を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d8c90785-f16b-42a5-8439-ed2f731b2ba8
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 方法: WebRequest に一致するプロトコル固有の WebResponse を取得する
+この例で WebRequest に一致するプロトコル対応する WebResponse を取得する方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+WebRequest req = WebRequest.Create("http://www.contoso.com/");  
+WebResponse resp = req.GetResponse();  
+```  
+  
+```vb  
+Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")  
+Dim resp As WebResponse = req.GetResponse()  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 参照  
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-send-data-using-the-webrequest-class.md b/docs/framework/network-programming/how-to-send-data-using-the-webrequest-class.md
new file mode 100644
index 00000000000..a32d5aec1f0
--- /dev/null
+++ b/docs/framework/network-programming/how-to-send-data-using-the-webrequest-class.md
@@ -0,0 +1,275 @@
+---
+title: "方法: WebRequest クラスを使用してデータを送信する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "WebRequest クラス、ホストにデータを送信する"
+  - "ホストにデータを送信する、WebRequest クラスを使用する"
+ms.assetid: 66686878-38ac-4aa6-bf42-ffb568ffc459
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 方法: WebRequest クラスを使用してデータを送信する
+次のプロシージャはサーバーにデータを送信するために使用するステップについて説明します。  このプロシージャは一般的 Web ページへのデータの掲示する必要があります。  
+  
+### データをホスト サーバーに送信します。  
+  
+1.  データ、たとえば、ASP.NET のスクリプトまたはページを使用するリソースの URI の <xref:System.Net.WebRequest.Create%2A> の呼び出し、<xref:System.Net.WebRequest> のインスタンスを作成します。  
+  
+    ```csharp  
+    WebRequest request = WebRequest.Create("http://www.contoso.com/");  
+    ```  
+  
+    ```vb  
+    Dim request as WebRequest = WebRequest.Create("http://www.contoso.com/")  
+  
+    ```  
+  
+    > [!NOTE]
+    >  .NET Framework は、「http で始まる URI に **\[WebRequest\]** と **WebResponse** から派生したプロトコル対応クラスを提供します: 」、「https:'' 「ftp: 」、および「ファイル: 」  他のプロトコルを使用してリソースにアクセスするには、**\[WebRequest\]** と **WebResponse**から取得プロトコル対応クラスを行う必要があります。  詳細については、「[プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)」を参照してください。  
+  
+2.  、**\[WebRequest\]**で必要なプロパティ値を設定します。  たとえば、認証を有効にするには、<xref:System.Net.NetworkCredential> クラスのインスタンスに **\[資格情報\]** のプロパティを設定します。  
+  
+    ```csharp  
+    request.Credentials = CredentialCache.DefaultCredentials;  
+    ```  
+  
+    ```vb  
+    request.Credentials = CredentialCache.DefaultCredentials  
+  
+    ```  
+  
+     ほとんどの場合、**\[WebRequest\]** のインスタンス自体はデータを送信十分です。  ただし、プロトコル対応するプロパティを設定する必要があるプロトコル タイプに対応 **\[WebRequest\]** をキャスト必要があります。  たとえば、<xref:System.Net.HttpWebRequest>の Http 固有のプロパティにアクセスするには、**HttpWebRequest** の参照に **\[WebRequest\]** をキャスト。  次の例は <xref:System.Net.HttpWebRequest.UserAgent%2A> コードの Http 固有のプロパティを設定する方法を示します。  
+  
+    ```csharp  
+    ((HttpWebRequest)request).UserAgent = ".NET Framework Example Client";  
+    ```  
+  
+    ```vb  
+    Ctype(request,HttpWebRequest).UserAgent = ".NET Framework Example Client"  
+    ```  
+  
+3.  データの要求に送信して HTTP の **\[投稿\]** する方法など、プロトコル方法を指定します。  
+  
+    ```csharp  
+    request.Method = "POST";  
+    ```  
+  
+    ```vb  
+    request.Method = "POST"  
+    ```  
+  
+4.  **\[ContentLength\]** のプロパティを設定します。  
+  
+    ```csharp  
+    request.ContentLength = byteArray.Length;  
+    ```  
+  
+    ```vb  
+    request.ContentLength = byteArray.Length  
+    ```  
+  
+5.  適切な値に **\[ContentType\]** のプロパティを設定します。  
+  
+    ```csharp  
+    request.ContentType = "application/x-www-form-urlencoded";  
+    ```  
+  
+    ```vb  
+    request.ContentType = "application/x-www-form-urlencoded"  
+    ```  
+  
+6.  <xref:System.Net.WebRequest.GetRequestStream%2A> メソッド呼び出し、要求データを保持するストリームを取得します。  
+  
+    ```csharp  
+    Stream dataStream = request.GetRequestStream ();  
+    ```  
+  
+    ```vb  
+    Stream dataStream = request.GetRequestStream ()  
+    ```  
+  
+7.  この方法により、返品 <xref:System.IO.Stream> の対象にデータを記述します。  
+  
+    ```csharp  
+    dataStream.Write (byteArray, 0, byteArray.Length);  
+    ```  
+  
+    ```vb  
+    dataStream.Write (byteArray, 0, byteArray.Length)  
+    ```  
+  
+8.  **\[Stream.Close\]** メソッド呼び出し、要求のベースを閉じます。  
+  
+    ```csharp  
+    dataStream.Close ();  
+    ```  
+  
+    ```vb  
+    dataStream.Close ()  
+    ```  
+  
+9. <xref:System.Net.WebRequest.GetResponse%2A>の呼び出し、サーバーに要求を送信します。  この方法は、サーバーの応答を含むオブジェクトを返します。  <xref:System.Net.WebResponse> の返品オブジェクト タイプが需要 URI の設定によって決まります。  
+  
+    ```csharp  
+    WebResponse response = request.GetResponse();  
+    ```  
+  
+    ```vb  
+    Dim response As WebResponse = request.GetResponse()  
+  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Net.WebResponse> のオブジェクトを終了したら、<xref:System.Net.WebResponse.Close%2A> 方法の名前と閉じなければ必要があります。  または応答オブジェクトからの応答ストリームを獲得したとき、<xref:System.IO.Stream.Close%2A?displayProperty=fullName> メソッド呼び出し、ストリームを決済できます。  応答またはストリームを閉じなければ、アプリケーションは、追加情報を処理してサーバーへの接続を使い果たし、なくすることができます。  
+  
+10. **WebResponse** のプロパティをアクセス プロトコルまたは対応のインスタンスに対応プロトコルのプロパティを読み取る場合に **WebResponse** をキャストできます。  たとえば、<xref:System.Net.HttpWebResponse>の Http 固有のプロパティにアクセスするには、**HttpWebResponse** の参照に **WebResponse** をキャスト。  
+  
+    ```csharp  
+    Console.WriteLine (((HttpWebResponse)response).StatusDescription);  
+    ```  
+  
+    ```vb  
+    Console.WriteLine(CType(response, HttpWebResponse).StatusDescription)  
+    ```  
+  
+11. サーバーが送信する応答のデータを含むストリームを取得するには **WebResponse**の <xref:System.Net.WebResponse.GetResponseStream%2A> 方法を追加します。  
+  
+    ```csharp  
+    Stream data = response.GetResponseStream;  
+    ```  
+  
+    ```vb  
+    Dim data As Stream = response.GetResponseStream  
+    ```  
+  
+12. 応答からのデータを読んだと、**\[Stream.Close\]** 方法を使用して応答のベースを決算または **\[WebResponse.Close\]** 方法を使用して応答を閉じなければ必要があります。  両方の **\[閉じる\]** 方法を応答のベースと **WebResponse**というする必要はありませんが、編集することで、破壊試験ではありません。  
+  
+    ```csharp  
+    response.Close();  
+    ```  
+  
+    ```vb  
+    response.Close()  
+  
+    ```  
+  
+## 使用例  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Net;  
+using System.Text;  
+  
+namespace Examples.System.Net  
+{  
+    public class WebRequestPostExample  
+    {  
+        public static void Main ()  
+        {  
+            // Create a request using a URL that can receive a post.   
+            WebRequest request = WebRequest.Create ("http://www.contoso.com/PostAccepter.aspx ");  
+            // Set the Method property of the request to POST.  
+            request.Method = "POST";  
+            // Create POST data and convert it to a byte array.  
+            string postData = "This is a test that posts this string to a Web server.";  
+            byte[] byteArray = Encoding.UTF8.GetBytes (postData);  
+            // Set the ContentType property of the WebRequest.  
+            request.ContentType = "application/x-www-form-urlencoded";  
+            // Set the ContentLength property of the WebRequest.  
+            request.ContentLength = byteArray.Length;  
+            // Get the request stream.  
+            Stream dataStream = request.GetRequestStream ();  
+            // Write the data to the request stream.  
+            dataStream.Write (byteArray, 0, byteArray.Length);  
+            // Close the Stream object.  
+            dataStream.Close ();  
+            // Get the response.  
+            WebResponse response = request.GetResponse ();  
+            // Display the status.  
+            Console.WriteLine (((HttpWebResponse)response).StatusDescription);  
+            // Get the stream containing content returned by the server.  
+            dataStream = response.GetResponseStream ();  
+            // Open the stream using a StreamReader for easy access.  
+            StreamReader reader = new StreamReader (dataStream);  
+            // Read the content.  
+            string responseFromServer = reader.ReadToEnd ();  
+            // Display the content.  
+            Console.WriteLine (responseFromServer);  
+            // Clean up the streams.  
+            reader.Close ();  
+            dataStream.Close ();  
+            response.Close ();  
+        }  
+    }  
+}  
+```  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Net  
+Imports System.Text  
+Namespace Examples.System.Net  
+    Public Class WebRequestPostExample  
+  
+        Public Shared Sub Main()  
+            ' Create a request using a URL that can receive a post.   
+            Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/PostAccepter.aspx ")  
+            ' Set the Method property of the request to POST.  
+            request.Method = "POST"  
+            ' Create POST data and convert it to a byte array.  
+            Dim postData As String = "This is a test that posts this string to a Web server."  
+            Dim byteArray As Byte() = Encoding.UTF8.GetBytes(postData)  
+            ' Set the ContentType property of the WebRequest.  
+            request.ContentType = "application/x-www-form-urlencoded"  
+            ' Set the ContentLength property of the WebRequest.  
+            request.ContentLength = byteArray.Length  
+            ' Get the request stream.  
+            Dim dataStream As Stream = request.GetRequestStream()  
+            ' Write the data to the request stream.  
+            dataStream.Write(byteArray, 0, byteArray.Length)  
+            ' Close the Stream object.  
+            dataStream.Close()  
+            ' Get the response.  
+            Dim response As WebResponse = request.GetResponse()  
+            ' Display the status.  
+            Console.WriteLine(CType(response, HttpWebResponse).StatusDescription)  
+            ' Get the stream containing content returned by the server.  
+            dataStream = response.GetResponseStream()  
+            ' Open the stream using a StreamReader for easy access.  
+            Dim reader As New StreamReader(dataStream)  
+            ' Read the content.  
+            Dim responseFromServer As String = reader.ReadToEnd()  
+            ' Display the content.  
+            Console.WriteLine(responseFromServer)  
+            ' Clean up the streams.  
+            reader.Close()  
+            dataStream.Close()  
+            response.Close()  
+        End Sub  
+    End Class  
+End Namespace  
+  
+```  
+  
+## 参照  
+ [インターネット要求の作成](../../../docs/framework/network-programming/creating-internet-requests.md)   
+ [ネットワーク上でストリームを使用する](../../../docs/framework/network-programming/using-streams-on-the-network.md)   
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)   
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)   
+ [方法: WebRequest クラスを使用してデータを要求する](../../../docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md b/docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md
new file mode 100644
index 00000000000..e2be7ff2b42
--- /dev/null
+++ b/docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md
@@ -0,0 +1,169 @@
+---
+title: "方法: アプリケーションの場所ベースのキャッシュ ポリシーを設定します。 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "キャッシュ動作の明示的な定義"
+  - "場所ベースのキャッシュ ポリシー"
+  - "ローカル キャッシュ"
+  - "要求のキャッシュ ポリシー"
+  - "キャッシュ [.NET Framework]、場所ベースのポリシー"
+ms.assetid: 683bb88e-3411-4f46-9686-3411b6ba511c
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# 方法: アプリケーションの場所ベースのキャッシュ ポリシーを設定します。
+場所に基づくキャッシュのポリシーがオフに要求されたリソースの場所に基づいてキャッシュの動作を定義するアプリケーションができます。  このトピックでは、キャッシュのポリシーを割り当てる的にすることを示します。  コンフィギュレーション ファイルを使用してアプリケーションのポリシーを設定することについては、[\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)を参照してください。  
+  
+### アプリケーションの場所に基づくキャッシュのポリシーを設定する  
+  
+1.  <xref:System.Net.Cache.RequestCachePolicy> または <xref:System.Net.Cache.HttpRequestCachePolicy> のオブジェクトを作成します。  
+  
+2.  アプリケーション ドメインの既定値としてポリシーのオブジェクトを設定します。  
+  
+### キャッシュから要求されたリソースのポリシーを設定する  
+  
+-   必要に応じてキャッシュから要求されたリソースの、別の方法で送信すると、要求の作成 <xref:System.Net.Cache.HttpRequestCacheLevel>にキャッシュのレベルに設定することにより、サーバーを、ポリシー。  要求は、キャッシュを含むクライアントとサーバー間のすべてのキャッシュによって、実行できます。  
+  
+    ```csharp  
+    public static void UseCacheIfAvailable()  
+    {  
+        HttpRequestCachePolicy policy = new HttpRequestCachePolicy  
+            (HttpRequestCacheLevel.CacheIfAvailable);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+  
+    ```  
+  
+    ```vb  
+    Public Shared Sub UseCacheIfAvailable()  
+        Dim policy As New HttpRequestCachePolicy _  
+             (HttpRequestCacheLevel.CacheIfAvailable)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+### 供給のリソースからキャッシュがポリシーを設定する  
+  
+-   すべてのキャッシュが <xref:System.Net.Cache.HttpRequestCacheLevel>ことをキャッシュのレベルに設定することにより、要求されたリソースを供給することを妨げるポリシーを作成します。  このポリシー レベルは、ローカル キャッシュからこれらは、リソースを削除することを存在する場合\)、削除、キャッシュにリソースを示します。  
+  
+    ```csharp  
+    public static void DoNotUseCache()  
+    {  
+    HttpRequestCachePolicy policy = new HttpRequestCachePolicy   
+            (HttpRequestCacheLevel.NoCacheNoStore);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Sub DoNotUseCache()  
+        Dim policy As New HttpRequestCachePolicy _  
+            (HttpRequestCacheLevel.NoCacheNoStore)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+### ローカル キャッシュ場合にのみ、要求されたリソースを返品ポリシーを設定する  
+  
+-   ローカル キャッシュにキャッシュの <xref:System.Net.Cache.HttpRequestCacheLevel>にレベルに設定してある場合にのみ、要求されたリソースを返品ポリシーを作成します。  要求されたリソースがキャッシュにある場合は、<xref:System.Net.WebException> の例外は投げられます。  
+  
+    ```csharp  
+    public static void OnlyUseCache()  
+    {  
+        HttpRequestCachePolicy policy = new HttpRequestCachePolicy   
+            (HttpRequestCacheLevel.CacheOnly);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Sub OnlyUseCache()  
+        Dim policy As New HttpRequestCachePolicy _  
+            (HttpRequestCacheLevel.CacheOnly)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+### 供給のリソースからキャッシュがローカル ポリシーを設定する  
+  
+-   ローカル キャッシュが <xref:System.Net.Cache.HttpRequestCacheLevel>ことをキャッシュのレベルに設定することにより、要求されたリソースを供給することを妨げるポリシーを作成します。  要求されたリソースが中間キャッシュに、正常に revalidated、中間キャッシュは、要求されたリソースを提供できます。  
+  
+    ```csharp  
+    public static void DoNotUseLocalCache()  
+    {  
+     HttpRequestCachePolicy policy = new HttpRequestCachePolicy   
+            (HttpRequestCacheLevel.Refresh);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Sub DoNotUseLocalCache()  
+        Dim policy As New HttpRequestCachePolicy _  
+            (HttpRequestCacheLevel.Refresh)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+### すべてのキャッシュが要求されたリソースを供給することを妨げるポリシーを設定する  
+  
+-   すべてのキャッシュが <xref:System.Net.Cache.HttpRequestCacheLevel>ことをキャッシュのレベルに設定することにより、要求されたリソースを供給することを妨げるポリシーを作成します。  サーバーが返品リソースは、キャッシュに保存できます。  
+  
+    ```csharp  
+    public static void SendToServer()  
+    {  
+    HttpRequestCachePolicy policy = new HttpRequestCachePolicy   
+            (HttpRequestCacheLevel.Reload);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Sub SendToServer()  
+        Dim policy As New HttpRequestCachePolicy _  
+            (HttpRequestCacheLevel.Reload)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+### サーバーのリソースがキャッシュが要求されたリソースを提供するためにするキャッシュされたコピーを新しくなければポリシーを設定する  
+  
+-   サーバーのリソースがキャッシュが <xref:System.Net.Cache.HttpRequestCacheLevel>にキャッシュのレベルに設定することにより、キャッシュされたコピーを新しくなかったら要求されたリソースを提供するためにするポリシーを作成します。  
+  
+    ```csharp  
+    public static void CheckServer()  
+    {  
+    HttpRequestCachePolicy policy = new HttpRequestCachePolicy  
+             (HttpRequestCacheLevel.Revalidate);  
+        HttpWebRequest.DefaultCachePolicy = policy;  
+    }  
+    ```  
+  
+    ```vb  
+    Public Shared Sub CheckServer()  
+        Dim policy As New HttpRequestCachePolicy _  
+            (HttpRequestCacheLevel.Revalidate)  
+        HttpWebRequest.DefaultCachePolicy = policy  
+    End Sub  
+    ```  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-set-cache-policy-for-a-request.md b/docs/framework/network-programming/how-to-set-cache-policy-for-a-request.md
new file mode 100644
index 00000000000..d2266b65ae6
--- /dev/null
+++ b/docs/framework/network-programming/how-to-set-cache-policy-for-a-request.md
@@ -0,0 +1,121 @@
+---
+title: "方法: 要求のキャッシュ ポリシーを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "要求のキャッシュ ポリシー"
+ms.assetid: 39c15e40-586b-4ac9-9cce-146f74b7e545
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 方法: 要求のキャッシュ ポリシーを設定する
+次の例では、要求のキャッシュのポリシーを設定することを示します。  例の入力は http:\/\/www.contoso.com\/ などの URI です。  
+  
+## 使用例  
+ 次の例では、コードは 1 日にキャッシュ場合、要求されたリソースがキャッシュから使用される場合と同様にするキャッシュのポリシーを作成します。  たとえば、リソースがキャッシュの例で使用されているかどうか、`"The response was retrieved from the cache : False."`—表示およびリソースを示すメッセージが表示されます。  要求はクライアントとサーバー間のすべてのキャッシュして実行できます。  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Cache;  
+using System.IO;  
+  
+namespace Examples.System.Net.Cache  
+{  
+    public class CacheExample  
+    {     
+        public static void UseCacheForOneDay(Uri resource)  
+        {  
+            // Create a policy that allows items in the cache  
+            // to be used if they have been cached one day or less.  
+            HttpRequestCachePolicy requestPolicy =   
+                new HttpRequestCachePolicy (HttpCacheAgeControl.MaxAge,  
+                TimeSpan.FromDays(1));  
+  
+            WebRequest request = WebRequest.Create (resource);  
+            // Set the policy for this request only.  
+            request.CachePolicy = requestPolicy;  
+            HttpWebResponse response = (HttpWebResponse)request.GetResponse();  
+            // Determine whether the response was retrieved from the cache.  
+            Console.WriteLine ("The response was retrieved from the cache : {0}.",  
+               response.IsFromCache);  
+            Stream s = response.GetResponseStream ();  
+            StreamReader reader = new StreamReader (s);  
+            // Display the requested resource.  
+            Console.WriteLine(reader.ReadToEnd());  
+            reader.Close ();  
+            s.Close();  
+            response.Close();  
+        }  
+        public static void Main(string[] args)  
+        {  
+            if (args == null || args.Length != 1)  
+            {  
+                Console.WriteLine ("You must specify the URI to retrieve.");  
+                return;  
+            }  
+            UseCacheForOneDay (new Uri(args[0]));  
+        }  
+    }  
+}  
+```  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Cache  
+Imports System.IO  
+Namespace Examples.System.Net.Cache  
+    Public Class CacheExample  
+        Public Shared Sub UseCacheForOneDay(ByVal resource As Uri)  
+            ' Create a policy that allows items in the cache  
+            ' to be used if they have been cached one day or less.  
+            Dim requestPolicy As New HttpRequestCachePolicy _  
+                  (HttpCacheAgeControl.MaxAge, TimeSpan.FromDays(1))  
+            Dim request As WebRequest = WebRequest.Create(resource)  
+            ' Set the policy for this request only.  
+            request.CachePolicy = requestPolicy  
+            Dim response As HttpWebResponse = _  
+             CType(request.GetResponse(), HttpWebResponse)  
+            ' Determine whether the response was retrieved from the cache.  
+            Console.WriteLine("The response was retrieved from the cache : {0}.", _  
+                response.IsFromCache)  
+            Dim s As Stream = response.GetResponseStream()  
+            Dim reader As New StreamReader(s)  
+            ' Display the requested resource.  
+            Console.WriteLine(reader.ReadToEnd())  
+            reader.Close()  
+            s.Close()  
+            response.Close()  
+        End Sub  
+        Public Shared Sub Main(ByVal args() As String)  
+            If args Is Nothing OrElse args.Length <> 1 Then  
+                Console.WriteLine("You must specify the URI to retrieve.")  
+                Return  
+            End If  
+            UseCacheForOneDay(New Uri(args(0)))  
+        End Sub  
+    End Class  
+End Namespace  
+  
+```  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md b/docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md
new file mode 100644
index 00000000000..49a61a2967d
--- /dev/null
+++ b/docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md
@@ -0,0 +1,78 @@
+---
+title: "方法: アプリケーションの既定の時間ベースのキャッシュ ポリシーを設定します。 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "時間ベースのキャッシュ ポリシー"
+  - "キャッシュ [.NET Framework]、時間ベースのポリシー"
+  - "既定の時間ベースのキャッシュ ポリシー"
+ms.assetid: 6bfce066-a2e7-4add-a05e-85c12ec9f07f
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# 方法: アプリケーションの既定の時間ベースのキャッシュ ポリシーを設定します。
+既定の時間ベースのキャッシュのポリシーは、アプリケーションでキャッシュされたリソースに送信されるヘッダーで定義したキャッシュの動作と RFC 2616 の使用可能なセクション 13 と 14 で [http:\/\/www.ietf.org](http://www.ietf.org/)定義されたキャッシュの動作がことができます。  これは、ほとんどのアプリケーション用に適切なキャッシュの動作です。  
+  
+### アプリケーションの既定の自動ポリシーを設定する  
+  
+1.  既定の時間ベースのポリシー オブジェクトを作成します。  
+  
+2.  アプリケーション ドメインの既定値としてポリシーのオブジェクトを設定します。  
+  
+## 使用例  
+ このセクションの 2 例は同じポリシーが作成されます。  
+  
+ 次の例では、アプリケーション ドメインの既定値として既定の時間ベースのポリシーおよびセットが作成されます。  
+  
+```csharp  
+public static void SetDefaultTimeBasedPolicy ()  
+{  
+    HttpRequestCachePolicy policy = new HttpRequestCachePolicy ();  
+    HttpWebRequest.DefaultCachePolicy = policy ;  
+}  
+```  
+  
+```vb  
+Public Shared Sub SetDefaultTimeBasedPolicy ()  
+    Dim policy = New HttpRequestCachePolicy ()  
+    HttpWebRequest.DefaultCachePolicy = policy  
+End Sub  
+```  
+  
+ 次の例で示すように <xref:System.Net.Cache.RequestCachePolicy> クラスを使用して既定の時間ベースのキャッシュのポリシーを作成できます:  
+  
+```csharp  
+public static void SetDefaultTimeBasedPolicy2()  
+{  
+    RequestCachePolicy policy = new RequestCachePolicy ();  
+    HttpWebRequest.DefaultCachePolicy = policy ;  
+}  
+```  
+  
+```vb  
+Public Shared Sub SetDefaultTimeBasedPolicy2()  
+    Dim policy As New RequestCachePolicy()  
+    HttpWebRequest.DefaultCachePolicy = policy  
+End Sub  
+  
+```  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md b/docs/framework/network-programming/how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md
new file mode 100644
index 00000000000..ed32ec85215
--- /dev/null
+++ b/docs/framework/network-programming/how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md
@@ -0,0 +1,38 @@
+---
+title: "方法: WebRequest を型キャストしてプロトコル固有のプロパティにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d9a8eae2-7454-46f9-b43b-c98477c5bcde
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# 方法: WebRequest を型キャストしてプロトコル固有のプロパティにアクセスする
+プロトコル対応するプロパティがアクセスできるようにこの例で WebRequest を型にはめる方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+HttpWebRequest httpreq =   
+   (HttpWebRequest) WebRequest.Create("http://www.contoso.com/");  
+```  
+  
+```vb  
+Dim httpreq As HttpWebRequest = _  
+   CType(WebRequest.Create("http://www.contoso.com/"), HttpWebRequest)  
+```  
+  
+## 参照  
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/how-to-upload-files-with-ftp.md b/docs/framework/network-programming/how-to-upload-files-with-ftp.md
new file mode 100644
index 00000000000..9e29d6cb701
--- /dev/null
+++ b/docs/framework/network-programming/how-to-upload-files-with-ftp.md
@@ -0,0 +1,74 @@
+---
+title: "方法: FTP を使用してファイルをアップロードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: e40f17c5-dd12-4c62-9dbf-00ab491382dc
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# 方法: FTP を使用してファイルをアップロードする
+このオプションは、FTP サーバーにファイルをアップロードする方法を示します。  
+  
+## 使用例  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Net;  
+using System.Text;  
+  
+namespace Examples.System.Net  
+{  
+    public class WebRequestGetExample  
+    {  
+        public static void Main ()  
+        {  
+            // Get the object used to communicate with the server.  
+            FtpWebRequest request = (FtpWebRequest)WebRequest.Create("ftp://www.contoso.com/test.htm");  
+            request.Method = WebRequestMethods.Ftp.UploadFile;  
+  
+            // This example assumes the FTP site uses anonymous logon.  
+            request.Credentials = new NetworkCredential ("anonymous","janeDoe@contoso.com");  
+  
+            // Copy the contents of the file to the request stream.  
+            StreamReader sourceStream = new StreamReader("testfile.txt");  
+            byte [] fileContents = Encoding.UTF8.GetBytes(sourceStream.ReadToEnd());  
+            sourceStream.Close();  
+            request.ContentLength = fileContents.Length;  
+  
+            Stream requestStream = request.GetRequestStream();  
+            requestStream.Write(fileContents, 0, fileContents.Length);  
+            requestStream.Close();  
+  
+            FtpWebResponse response = (FtpWebResponse)request.GetResponse();  
+  
+            Console.WriteLine("Upload File Complete, status {0}", response.StatusDescription);  
+  
+            response.Close();  
+            }  
+        }  
+    }  
+}  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 信頼性の高いプログラミング  
+  
+## .NET Framework セキュリティ
\ No newline at end of file
diff --git a/docs/framework/network-programming/http.md b/docs/framework/network-programming/http.md
new file mode 100644
index 00000000000..d3b8f59ca7c
--- /dev/null
+++ b/docs/framework/network-programming/http.md
@@ -0,0 +1,47 @@
+---
+title: "HTTP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロトコル、HTTP"
+  - "送信 (データを)、HTTP"
+  - "HttpWebResponse クラス、送受信 (データを)"
+  - "HTTP"
+  - "受信 (データを)、HTTP"
+  - "アプリケーション プロトコル、HTTP"
+  - "インターネット、HTTP"
+  - "ネットワーク リソース、HTTP"
+  - "HTTP、HTTP の概要"
+  - "HttpWebRequest クラス、送受信 (データを)"
+ms.assetid: 985fe5d8-eb71-4024-b361-41fbdc1618d8
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# HTTP
+.NET Framework は<xref:System.Net.HttpWebRequest> と <xref:System.Net.HttpWebResponse> クラスを使用するすべてのインターネットのトラフィックより大多数を構成する HTTP プロトコルに詳細なサポートを提供します。  <xref:System.Net.WebRequest> と <xref:System.Net.WebResponse>から派生したこれらのクラスは、静的方法 <xref:System.Net.WebRequest.Create%2A?displayProperty=fullName> が http https 「」または「」に従って URI に発生するときに、既定では戻されます。  プロパティとして公開される Http 特定の機能へのアクセスを必要に応じて要求をする必要がある **HttpWebRequest** または **HttpWebResponse**にこれらのクラスのタイプにはめるできます。ほとんどの場合、**WebResponse** の **\[WebRequest\]** およびクラスはすべてを提供します。  
+  
+ **HttpWebRequest** と **HttpWebResponse** は、標準の HTTP の要求および応答のトランザクションをカプセル化、共通の HTTP ヘッダーにアクセスできます。  これらのクラスは、ほとんどの HTTP 1.1 の機能を、チャンク、認証、preauthentication、暗号化、プロキシ サーバーでは、証明書の検証および接続管理のデータを送受信するパイプライニングがサポートされます。  プロパティを使用して提供されていないカスタム ヘッダーとヘッダーには格納され、**\[ヘッダー\]** のプロパティを使用してアクセスできます。  
+  
+ **HttpWebRequest** は **\[WebRequest.Create\]** 方法に URI に合格する前に **\[WebRequest\]** で使用される既定のクラスで、登録する必要はありません。  
+  
+ 自分のアプリケーションに **true**  \(既定値\) に <xref:System.Net.HttpWebRequest.AllowAutoRedirect%2A> のプロパティを設定して HTTP のリダイレクトに自動的に続かせますできます。  アプリケーションは要求の方向を変更および **HttpWebResponse** の [&#91;ResponseURI&#93;](frlrfsystemnethttpwebresponseclassresponseuritopic) のプロパティは要求にな Web 応募した実際のリソースが含まれます。  **false**に設定 **\[AllowAutoRedirect\]**、アプリケーションの HTTP プロトコルのエラーとしてリダイレクトを扱えれば必要がある場合。  
+  
+ アプリケーションは [WebExceptionStatus.ProtocolError](frlrfsystemnetwebexceptionstatusclasstopic)に設定 <xref:System.Net.WebException.Status%2A> の <xref:System.Net.WebException> をつかまえるして HTTP プロトコルのエラーが表示されます。  <xref:System.Net.WebException.Response%2A> のプロパティはサーバーが送信 **WebResponse** を含み、ある実際の HTTP なエラーを表示します。  
+  
+## 参照  
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)   
+ [方法: HTTP 固有のプロパティにアクセスする](../../../docs/framework/network-programming/how-to-access-http-specific-properties.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/httplistener.md b/docs/framework/network-programming/httplistener.md
new file mode 100644
index 00000000000..6f354f1d95c
--- /dev/null
+++ b/docs/framework/network-programming/httplistener.md
@@ -0,0 +1,38 @@
+---
+title: "HttpListener | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "HTTP"
+ms.assetid: 5b89d3fb-3c9a-49e2-af1f-c34c020c68ac
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# HttpListener
+<xref:System.Net.HttpListener> クラスは、プログラムによって制御できる HTTP プロトコル リスナーを提供します。  リスナーは、<xref:System.Net.HttpListener> オブジェクトの有効期間にわたってアクティブで、アプリケーション内で実行されます。  
+  
+## HTTP.SYS  
+ <xref:System.Net.HttpListener> クラスは、Windows のすべての HTTP トラフィックを処理するカーネル モード リスナーである HTTP.sys の上に構築されています。  HTTP.sys は、接続管理、帯域幅の調整、および Web サーバーのログ記録を提供します。  SSL 証明書の追加には `HttpCfg.exe` ツールを使用します。  詳細については、[サーバー](http://go.microsoft.com/fwlink/?LinkID=178285)に関するドキュメント内の [HttpCfg.exe](http://go.microsoft.com/fwlink/?LinkID=178284) ツールに関するドキュメントを参照してください。  
+  
+## 参照  
+ <xref:System.Net.HttpListener>   
+ <xref:System.Net.HttpWebRequest>   
+ <xref:System.Net.HttpWebResponse>   
+ [HTTP サーバー](http://go.microsoft.com/fwlink/?LinkID=178285)   
+ [インターネット インフォメーションにおけるセキュリティの強化](http://go.microsoft.com/fwlink/?LinkID=178286)   
+ [HttpListener ASPX ホスト アプリケーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=179560)   
+ [HttpListener テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179558)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/index.md b/docs/framework/network-programming/index.md
new file mode 100644
index 00000000000..686db921255
--- /dev/null
+++ b/docs/framework/network-programming/index.md
@@ -0,0 +1,150 @@
+---
+title: ".NET Framework のネットワーク プログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーキング"
+  - "インターネット"
+  - "インターネット, .NET Framework のインターネット サービス"
+  - "ネットワーク リソース"
+ms.assetid: 8d455610-67a0-4fa8-a62f-7747064a9256
+caps.latest.revision: 24
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 24
+---
+# .NET Framework のネットワーク プログラミング
+Microsoft .NET Framework は、アプリケーションにすばやく簡単に統合できる、複数層の拡張可能なインターネット サービスのマネージ実装を提供します。 ネットワーク アプリケーションは、プラグ可能なプロトコルを基に自動的に新しいインターネット プロトコルを使用するように作成することも、ソケット レベルでネットワークを使用できるように Windows ソケット インターフェイスのマネージ実装を使用することもできます。  
+  
+## このセクションの内容  
+ [プラグ可能なプロトコルの概要](../../../docs/framework/network-programming/introducing-pluggable-protocols.md)  
+ 必要なアクセス プロトコルに関係なく、インターネット リソースにアクセスする方法について説明します。  
+  
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)  
+ プラグ可能なプロトコルを使用して、インターネット リソースにデータをアップロードしたり、ダウンロードしたりする方法について説明します。  
+  
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)  
+ プロトコル固有のクラスを派生させて、プラグ可能なプロトコルを実装する方法について説明します。  
+  
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)  
+ TCP、UDP、HTTP などのネットワーク プロトコルを利用するアプリケーションのプログラミングについて説明します。  
+  
+ [インターネット プロトコル バージョン 6](../../../docs/framework/network-programming/internet-protocol-version-6.md)  
+ インターネット プロトコル スイート \(IPv4\) の現在のバージョンより優れたインターネット プロトコル Version 6 \(IPv6\) の利点について説明し、IPv6 のアドレス指定、ルーティングおよび自動構成、および IPv6 を有効\/無効にする方法について説明します。  
+  
+ [構成 \(インターネット アプリケーションを\)](../../../docs/framework/network-programming/configuring-internet-applications.md)  
+ .NET Framework 構成ファイルを使用して、インターネット アプリケーションを構成する方法について説明します。  
+  
+ [.NET Framework のネットワークのトレース](../../../docs/framework/network-programming/network-tracing.md)  
+ .NET Framework のネットワークのトレースを使用して、メソッド呼び出しについての情報、およびマネージ アプリケーションによって生成されるネットワーク トラフィックについての情報を取得する方法を説明します。  
+  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)  
+ <xref:System.Net.WebClient?displayProperty=fullName>、<xref:System.Net.WebRequest?displayProperty=fullName>、および <xref:System.Net.HttpWebRequest?displayProperty=fullName> クラスを使用するアプリケーションでキャッシュを使用する方法について説明します。  
+  
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)  
+ 標準のインターネット セキュリティと認証の手法を使用する方法について説明します。  
+  
+ [System.Net クラスのベスト プラクティス](../../../docs/framework/network-programming/best-practices-for-system-net-classes.md)  
+ インターネット アプリケーションを最大限に活用するためのヒントとテクニックを紹介します。  
+  
+ [プロキシを介したインターネットへのアクセス](../../../docs/framework/network-programming/accessing-the-internet-through-a-proxy.md)  
+ プロキシの設定方法について説明します。  
+  
+ [NetworkInformation](../../../docs/framework/network-programming/networkinformation.md)  
+ ネットワーク イベント、変更、統計、およびプロパティの情報を収集する方法について説明し、<xref:System.Net.NetworkInformation.Ping?displayProperty=fullName> クラスを使用してリモート ホストに到達可能であるかどうかを判定する方法についても説明します。  
+  
+ [バージョン 2.0 での System.Uri 名前空間の変更](../../../docs/framework/network-programming/changes-to-the-system-uri-namespace-in-version-2-0.md)  
+ Version 2.0 で正しくない動作を修正し、使いやすさを改善し、セキュリティを強化するために <xref:System.Uri?displayProperty=fullName> クラスに加えられたいくつかの変更について説明します。  
+  
+ [System.Uri での International Resource Identifier のサポート](../../../docs/framework/network-programming/international-resource-identifier-support-in-system-uri.md)  
+ Version 3.5、3.0 SP1、および 2.0 SP1 で、International Resource Identifier \(IRI\) および国際化ドメイン名 \(IDN\) をサポートするために、<xref:System.Uri?displayProperty=fullName> クラスに追加された強化機能について説明します。  
+  
+ [バージョン 3.5 のソケット パフォーマンスの強化](../../../docs/framework/network-programming/socket-performance-enhancements-in-version-3-5.md)  
+ Version 3.5、3.0 SP1、および 2.0 SP1 で、<xref:System.Net.Sockets.Socket?displayProperty=fullName> クラスに追加された一連の強化機能について説明します。これらの機能によって、目的に特化した高パフォーマンスのソケット アプリケーションで使用できる代替非同期パターンが提供されます。  
+  
+ [Peer Name Resolution Protocol](../../../docs/framework/network-programming/peer-name-resolution-protocol.md)  
+ Version 3.5 で、ピア名解決プロトコル \(PNRP\)、サーバーを使用しない動的な名前登録、および名前解決プロトコルをサポートするために追加されたサポートについて説明します。 これらの新機能は、<xref:System.Net.PeerToPeer?displayProperty=fullName> 名前空間によってサポートされます。  
+  
+ [ピアツーピア コラボレーション](../../../docs/framework/network-programming/peer-to-peer-collaboration.md)  
+ Version 3.5 で、PNRP に基づくピア ツー ピア コラボレーションをサポートするために追加されたサポートについて説明します。 これらの新機能は、<xref:System.Net.PeerToPeer.Collaboration?displayProperty=fullName> 名前空間によってサポートされます。  
+  
+ [バージョン 3.5 SP1 における HttpWebRequest の NTLM 認証への変更](../../../docs/framework/network-programming/changes-to-ntlm-authentication-for-httpwebrequest-in-version-3-5-sp1.md)  
+ System.Net 名前空間の <xref:System.Net.HttpWebRequest?displayProperty=fullName>、<xref:System.Net.HttpListener?displayProperty=fullName>、<xref:System.Net.Security.NegotiateStream?displayProperty=fullName>、および関連クラスによる統合 Windows 認証の処理方法に影響を与える、Version 3.5 SP1 で行われたセキュリティの変更について説明します。  
+  
+ [統合 Windows 認証と拡張保護](../../../docs/framework/network-programming/integrated-windows-authentication-with-extended-protection.md)  
+ <xref:System.Net.HttpWebRequest?displayProperty=fullName> 名前空間および関連名前空間の <xref:System.Net.HttpListener?displayProperty=fullName>、<xref:System.Net.Mail.SmtpClient?displayProperty=fullName>、<xref:System.Net.Security.SslStream?displayProperty=fullName>、<xref:System.Net.Security.NegotiateStream?displayProperty=fullName>、<xref:System.Net?displayProperty=fullName>、および関連クラスによる統合 Windows 認証の処理方法に影響を与える、拡張保護用の強化機能について説明します。  
+  
+ [IPv6 および Teredo を使用した NAT トラバーサル](../../../docs/framework/network-programming/nat-traversal-using-ipv6-and-teredo.md)  
+ IPv6 および Teredo を使用する NAT トラバースをサポートするために、<xref:System.Net?displayProperty=fullName>、<xref:System.Net.NetworkInformation?displayProperty=fullName>、および <xref:System.Net.Sockets?displayProperty=fullName> 名前空間に追加された強化機能について説明します。  
+  
+ [Windows ストア アプリのネットワーク分離](../../../docs/framework/network-programming/network-isolation-for-windows-store-apps.md)  
+ <xref:System.Net>、<xref:System.Net.Http>、および <xref:System.Net.Http.Headers> 名前空間のクラスを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションで使用したときのネットワーク分離の影響について説明します。  
+  
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)  
+ <xref:System.Net>、<xref:System.Net.Cache>、<xref:System.Net.Configuration>、<xref:System.Net.Mail>、<xref:System.Net.Mime>、<xref:System.Net.NetworkInformation>、<xref:System.Net.PeerToPeer>、<xref:System.Net.Security>、<xref:System.Net.Sockets> 名前空間のクラスを使用する、ダウンロード可能なネットワーク プログラミング サンプルへのリンク。  
+  
+## 関連項目  
+ <xref:System.Net?displayProperty=fullName>  
+ 最近のネットワークで使用されている多くのプロトコル用の単純なプログラミング インターフェイスを提供します。 この名前空間の <xref:System.Net.WebRequest?displayProperty=fullName> および <xref:System.Net.WebResponse?displayProperty=fullName> クラスは、プラグ可能なプロトコルの基礎です。  
+  
+ <xref:System.Net.Cache?displayProperty=fullName>  
+ 取得したリソースのキャッシュ ポリシーを <xref:System.Net.WebRequest?displayProperty=fullName> クラスおよび <xref:System.Net.HttpWebRequest?displayProperty=fullName> クラスを使用して定義するために使用する型および列挙体を定義します。  
+  
+ <xref:System.Net.Configuration?displayProperty=fullName>  
+ アプリケーションが System.Net 名前空間の構成設定にプログラムでアクセスして更新するために使用するクラス。  
+  
+ <xref:System.Net.Http?displayProperty=fullName>  
+ 最新の HTTP アプリケーション用のプログラミング インターフェイスを提供するクラス。  
+  
+ <xref:System.Net.Http.Headers?displayProperty=fullName>  
+ <xref:System.Net.Http?displayProperty=fullName> 名前空間で使用される HTTP ヘッダーのコレクションのサポートを提供します。  
+  
+ <xref:System.Net.Mail?displayProperty=fullName>  
+ SMTP プロトコルを使用してメールを作成および送信するクラス。  
+  
+ <xref:System.Net.Mime?displayProperty=fullName>  
+ Defines types that are used to represent Multipurpose Internet Mail Exchange \(MIME\) headers used by classes in the <xref:System.Net.Mail?displayProperty=fullName> 名前空間のクラスが、MIME \(Multipurpose Internet Mail Exchange\) ヘッダーを表すために使用する型を定義します。  
+  
+ <xref:System.Net.NetworkInformation?displayProperty=fullName>  
+ ネットワーク イベント、変更、統計、およびプロパティについての情報をプログラムで収集するクラス。  
+  
+ <xref:System.Net.PeerToPeer?displayProperty=fullName>  
+ ピア名前解決プロトコル \(PNRP\) のマネージ実装を開発者に提供します。  
+  
+ <xref:System.Net.PeerToPeer.Collaboration?displayProperty=fullName>  
+ ピア ツー ピア コラボレーション インターフェイスのマネージ実装を開発者に提供します。  
+  
+ <xref:System.Net.Security?displayProperty=fullName>  
+ ホスト間の安全な通信のためのネットワーク ストリームを提供するクラス。  
+  
+ <xref:System.Net.Sockets?displayProperty=fullName>  
+ ネットワークへのアクセスの制御を支援する必要のある開発者のための、Windows ソケット \(Winsock\) インターフェイスのマネージ実装が用意されています。  
+  
+ <xref:System.Net.WebSockets?displayProperty=fullName>  
+ WebSocket インターフェイスのマネージ実装を開発者に提供します。  
+  
+ <xref:System.Uri?displayProperty=fullName>  
+ URI \(Uniform Resource Identifier\) のオブジェクト表現を可能にし、URI の一部へ簡単にアクセスできるようにします。  
+  
+ <xref:System.Security.Authentication.ExtendedProtection?displayProperty=fullName>  
+ アプリケーションの拡張保護を使用した認証をサポートします。  
+  
+ <xref:System.Security.Authentication.ExtendedProtection.Configuration?displayProperty=fullName>  
+ アプリケーションの拡張保護を使用した認証の構成をサポートします。  
+  
+## 参照  
+ [ネットワーク プログラミング方法のトピック](../../../docs/framework/network-programming/network-programming-how-to-topics.md)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [MSDN Code Gallery 上の .NET 用のネットワークのサンプル](http://code.msdn.microsoft.com/Wiki/View.aspx?ProjectName=nclsamples)   
+ [HttpClient のサンプル](http://go.microsoft.com/fwlink/?LinkId=242550)
\ No newline at end of file
diff --git a/docs/framework/network-programming/integrated-windows-authentication-with-extended-protection.md b/docs/framework/network-programming/integrated-windows-authentication-with-extended-protection.md
new file mode 100644
index 00000000000..5ee8f2c2cee
--- /dev/null
+++ b/docs/framework/network-programming/integrated-windows-authentication-with-extended-protection.md
@@ -0,0 +1,163 @@
+---
+title: "統合 Windows 認証と拡張保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 81731998-d5e7-49e4-ad38-c8e6d01689d0
+caps.latest.revision: 13
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# 統合 Windows 認証と拡張保護
+改良は、統合 Windows 認証が <xref:System.Net> の <xref:System.Net.HttpWebRequest>によって、<xref:System.Net.HttpListener>、<xref:System.Net.Mail.SmtpClient>、<xref:System.Net.Security.SslStream>、および関連 <xref:System.Net.Security.NegotiateStream>クラスおよび関連名前空間の処理にその影響に作成されました。  拡張サポートされていますがセキュリティ保護を高めることができるように追加されました。  
+  
+ これらの変更は、Web を要求し、統合 Windows 認証が使用される応答を受け取るには、これらのクラスを使用するアプリケーションに影響を与える可能性があります。  この変更は、統合 Windows 認証を使用するようにコンフィギュレーションされているクライアント アプリケーションと Web サーバーに影響を与える可能性があります。  
+  
+ これらの変更は他のタイプの要求を選択し、統合 Windows 認証が使用される応答を受け取るには、これらのクラスを使用するアプリケーションに影響を与える可能性があります。  
+  
+ 拡張サポートするためにの変更は、Windows 7 および Windows Server 2008 R2 のアプリケーション用にのみ使用できます。  拡張保護機能は、以前のバージョンの Windows で使用できません。  
+  
+## 概要  
+ 統合 Windows 認証は、資格情報のチャレンジ応答が汎用的で、再利用または転送できるように設計されています。  課題応答では、少なくともチャンネルに固有の情報ターゲットの特定の情報と組み立てできる必要があります。  サービスは、クレデンシャルの課題応答をサービスプリンシパル \(SPN\) 名など、サービス別の情報を含んでいることを確認する拡張保護を提供できます。  クレデンシャル交換にこの情報を使用して、サービスは Administrators に使用できるクレデンシャルの課題の応答悪意のある使用への対策を上書きできます。  
+  
+ 拡張保護のデザインが認証リレー攻撃を軽減するように設計されている認証に改良プロトコルです。  これは、チャンネルおよびサービスのバインディング情報の概念に関して有効にします。  
+  
+ 全体的な目的は次があります:  
+  
+1.  拡張保護をサポートするためのクライアント アプリケーションを更新する場合は、すべてのサポートされて認証プロトコルのチャンネルにバインドおよびサービスのバインディング情報を供給する必要があります。  チャンネルの情報はバインディングにバインドされるチャンネル \(TLS\) がある場合にのみ提供できます。  サービスのバインディング情報は常に指定する必要があります。  
+  
+2.  適切にコンフィギュレーションされている更新されたサーバーは、チャンネルののにが一致しない場合は、クライアント認証のトークンに確認し、認証の送信をことがあるかも知れませんチャンネルおよびサービスのバインディング情報を却下します。  配置のシナリオで、サーバーは、チャンネルののに、サービスのにまたは両方を確認することがあります。  
+  
+3.  更新されたサーバーにポリシーに基づいたチャンネルのバインディング情報を含まないレベルのクライアント要求を承認または否認することもできます。  
+  
+ 拡張保護で使用される情報は、次の 2 人の一部の 1 人または両方から構成されています:  
+  
+1.  チャンネルの結合のトークンまたは CBT。  
+  
+2.  サービスプリンシパル名または SPN の形式のサービス バインディング情報。  
+  
+ サービスのバインディング情報は、そのサービス エンドポイントに認証するクライアントの目的を示しますです。  これは次のプロパティとクライアントからサーバーへの伝えられます:  
+  
+-   SPN の値はクリア テキストの認証フォームでクライアントを実行しているサーバーに使用可能である必要があります。  
+  
+-   SPN の値は、パブリックです。  
+  
+-   SPN は男性中間の攻撃の値を挿入、削除、または変更できません。インターネットに輸送中に対して作成された保護する必要があります。  
+  
+ CBT は、内部の認証したチャンネル、クライアント上の通話内容に \(バインド\) それを結ぶに使用される外部の保護されたチャネルのプロパティ \(TLS など\) です。  CBT は、次のプロパティがあります \(または IETF の RFC 5056 で指定\) 場合:  
+  
+-   外部のチャンネルである場合、CBT の値は外部のチャンネルまたは個別に通話内容のクライアントではなく、およびサーバー側の到着サーバーのエンドポイント、識別するプロパティである必要があります。  
+  
+-   クライアントが送信 CBT の値は攻撃者が影響する物である必要があります。  
+  
+-   保証には、CBT の値の秘密について行われません。  ただし、CBT を伝えるプロトコルとしてのサービスのに、チャンネルのバインディング情報の値がそのほかの認証を実行するサーバーでも常に行われることができます。は暗号化する場合があります意味します。  
+  
+-   CBT は攻撃者が値を挿入、削除、または変更できません。輸送中に対して作成された保護されたインターネットに整合性である必要があります。  
+  
+ チャンネルののには tamperproof 方法に SPN サーバーと CBT を移動したクライアントによって行われます。  サーバーは、ポリシーに従ってチャンネルのバインディング情報を検証して、それ自身が意図されている目標にすると信じない認証の送信を却下します。  この方法では、2 種類の暗号チャンネルに組み合わせてバインドされたようになります。  
+  
+ 既存のクライアントのアプリケーションと互換性を管理するには、サーバーは、拡張保護をサポートするいないクライアントによって認証の送信を許可するようにコンフィギュレーションされている場合があります。  これは、「完全に確かされた」コンフィギュレーションとは異なります。「部分的に確かしたコンフィギュレーション」、と呼ばれます。  
+  
+ <xref:System.Net> の複数のコンポーネントと <xref:System.Net.Security> の名前空間の名前はアプリケーションに代わって統合 Windows 認証を実行します。  このセクションでは、統合 Windows 認証内の拡張保護を追加するに System.Net のコンポーネントに対する変更について説明します。  
+  
+ 拡張保護は、Windows 7 で現在サポートされます。  メカニズムは提供されるので、アプリケーションは、オペレーティング システムが拡張保護をサポートするかどうかを決定できます。  
+  
+## 拡張サポートするためにの変更  
+ 使用される認証プロトコルで統合 Windows 認証で使用される認証プロセスは、多くの場合、設定先のコンピュータで発行、クライアント コンピュータにレシート実行する課題が含まれます。  拡張保護は、この承認プロセスに新しい機能を追加  
+  
+ <xref:System.Security.Authentication.ExtendedProtection> 名前空間は、アプリケーションの拡張保護を使用した認証をサポートします。  この名前空間の <xref:System.Security.Authentication.ExtendedProtection.ChannelBinding> クラスは、チャンネルののにを表します。  この名前空間の <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> クラスは、受信するクライアント接続の検証にサーバーが使用する拡張保護するポリシーを表します。  他のクラスのメンバは、拡張ために使用されます。  
+  
+ サーバー アプリケーションの場合は、これらのクラスが含まれています:  
+  
+ <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> 次の要素があります:  
+  
+-   オペレーティング システムには拡張保護する連結ウィンドウの認証をサポートするかどうかを示す <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.OSSupportsExtendedProtection%2A> のプロパティ。  
+  
+-   拡張保護ポリシーを適用するタイミングを示す <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> 値。  
+  
+-   配置のシナリオを示す <xref:System.Security.Authentication.ExtendedProtection.ProtectionScenario> の値。  拡張保護を確認できますが、その影響します。  
+  
+-   オプション <xref:System.Security.Authentication.ExtendedProtection.ServiceNameCollection> はクライアントによって注文の SPN の一覧が表示されます SPN と照合するために使用する際に認証を置くターゲット提供します。  
+  
+-   オプション <xref:System.Security.Authentication.ExtendedProtection.ChannelBinding> 検証に使用する注文のチャンネルののにがあります。  このシナリオでは、一般的なケースではありません  
+  
+ <xref:System.Security.Authentication.ExtendedProtection.Configuration> 名前空間は、アプリケーションの拡張保護を使用した認証の構成をサポートします。  
+  
+ いくつかの機能の変更は <xref:System.Net> の既存の名前空間の拡張保護をサポートするために対しています。  これらの変更は、次が含まれています:  
+  
+-   <xref:System.Net.TransportContext> の新しいクラス、転送のコンテキストを表す <xref:System.Net> の名前空間に追加される日数。  
+  
+-   <xref:System.Net.HttpWebRequest> の新しい <xref:System.Net.HttpWebRequest.EndGetRequestStream%2A> およびクライアント アプリケーションの拡張保護をサポートするために <xref:System.Net.TransportContext> の取得を割り当てる <xref:System.Net.HttpWebRequest.GetRequestStream%2A> 過負荷の方法が分類されます。  
+  
+-   サーバー アプリケーションをサポートする <xref:System.Net.HttpListener> と <xref:System.Net.HttpListenerRequest> クラスに関連付けます。  
+  
+ 機能の変更は <xref:System.Net.Mail> の既存の名前空間の SMTP のクライアント アプリケーションの拡張保護をサポートするされています。:  
+  
+-   拡張ときに保護を SMTP のクライアント アプリケーションで使用する認証に使用する SPN を表す <xref:System.Net.Mail.SmtpClient> クラスの <xref:System.Net.Mail.SmtpClient.TargetName%2A> のプロパティ。  
+  
+ いくつかの機能の変更は <xref:System.Net.Security> の既存の名前空間の拡張保護をサポートするために対しています。  これらの変更は、次が含まれています:  
+  
+-   <xref:System.Net.Security.NegotiateStream> の新しい <xref:System.Net.Security.NegotiateStream.BeginAuthenticateAsClient%2A> およびクライアント アプリケーションのサポートの拡張保護に CBT を渡すことを割り当てる <xref:System.Net.Security.NegotiateStream.AuthenticateAsClient%2A> 過負荷の方法が分類されます。  
+  
+-   <xref:System.Net.Security.NegotiateStream> の新しい <xref:System.Net.Security.NegotiateStream.BeginAuthenticateAsServer%2A> サーバーおよびアプリケーションのサポートの拡張保護に <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> を渡すことを割り当てる <xref:System.Net.Security.NegotiateStream.AuthenticateAsServer%2A> 過負荷の方法が分類されます。  
+  
+-   クライアントとサーバー アプリケーションの拡張保護をサポートする <xref:System.Net.Security.SslStream> クラスの <xref:System.Net.Security.SslStream.TransportContext%2A> の新しいプロパティ。  
+  
+ <xref:System.Net.Configuration.SmtpNetworkElement> のプロパティは <xref:System.Net.Security> の名前空間の SMTP のクライアントの拡張保護する場合のコンフィギュレーションに追加されました。  
+  
+## クライアント アプリケーションの拡張保護  
+ ほとんどのクライアント アプリケーションの拡張やサポートは自動的に行われます。  <xref:System.Net.HttpWebRequest> と <xref:System.Net.Mail.SmtpClient> クラスは、Windows の基になるバージョンが拡張保護をサポートするたびに、拡張保護をサポートします。  <xref:System.Net.HttpWebRequest> のインスタンスは <xref:System.Uri>から組み立て SPN を送信します。  既定では、<xref:System.Net.Mail.SmtpClient> のインスタンスが SMTP メール サーバーのホスト名から組み立て SPN を送信します。  
+  
+ 注文の認証に、クライアント アプリケーションは <xref:System.Net.HttpWebRequest.EndGetRequestStream%28System.IAsyncResult%2CSystem.Net.TransportContext%40%29?displayProperty=fullName> を使用することも、<xref:System.Net.TransportContext.GetChannelBinding%2A> 方法を使用して <xref:System.Net.TransportContext> と CBT の取得を割り当てる <xref:System.Net.HttpWebRequest> の <xref:System.Net.HttpWebRequest.GetRequestStream%28System.Net.TransportContext%40%29?displayProperty=fullName> 方法が分類されます。  
+  
+ 特定のサービスに <xref:System.Net.HttpWebRequest> のインスタンスに送信統合 Windows 認証に使用する SPN は <xref:System.Net.AuthenticationManager.CustomTargetNameDictionary%2A> のプロパティの設定によって上書きできます。  
+  
+ Windows 統合認証に使用する SMTP の接続の場合は <xref:System.Net.Mail.SmtpClient.TargetName%2A> のプロパティが注文の SPN を設定するために使用できます。  
+  
+## サーバー アプリケーションの拡張保護  
+ <xref:System.Net.HttpListener> は、サービスののにを検証するに自動的に HTTP 認証を実行するとメカニズムを提供します。  
+  
+ 最も安全なシナリオは HTTPS:\/\/ の接頭辞の拡張保護を有効にすることです。  この場合、<xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> の <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> に <xref:System.Net.HttpListener.ExtendedProtectionPolicy%2A?displayProperty=fullName> を設定します <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> または <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement>にし、<xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> の <xref:System.Security.Authentication.ExtendedProtection.ProtectionScenario> A の値に設定 <xref:System.Security.Authentication.ExtendedProtection.ProtectionScenario> を部分的に確かした荷渡方法に <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> が完全に確かした荷渡方法に対応しますが、<xref:System.Net.HttpListener> を設定します。  
+  
+ このコンフィギュレーションでは要求が外部の保護されたチャネルによるサーバーに行われると、外部のチャンネルは、チャンネルののににただされます。  このチャンネルの検証するのには、認証 SSPI の呼び出しに認証 BLOB のチャンネルののにを照合するに渡されます。  3 可能な結果があります:  
+  
+1.  サーバーの基になるオペレーティング システムには拡張保護はサポートされません。  要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントになります。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+2.  SSPI の電話のいずれかがクライアント サーバーの拡張保護するポリシーが <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement>用にコンフィギュレーションされたときに該当しなくなり外部のチャンネルまたはクライアントから取得した予測値にバインドのチャンネルを指定されていないのにのチャンネルを指定します。失敗したことを示します。  どちらの場合も、要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントになります。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+3.  クライアントとサーバーの拡張保護するポリシーが要求が処理のアプリケーションに戻ります <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> にコンフィギュレーションされているため、正しいチャンネルののにを指定したり、チャンネルののにを指定せずに接続するに割り当てられます。  サービス名の小切手が自動的に実行されません。  <xref:System.Net.HttpListenerRequest.ServiceName%2A> のプロパティを使用して独自のサービス名の検証を実行するこのような状況で追加です。  
+  
+ HTTP 要求の本文テキスト内で前後の出荷 BLOB に基づいて認証を実行するには、アプリケーションが独自の SSPI の通話を行い、チャンネルののにをサポートたければネイティブ Win32 [AcceptSecurityContext](http://go.microsoft.com/fwlink/?LinkId=147021) 機能に渡すために <xref:System.Net.HttpListener> を使用して外部の保護されたチャネルから予期したチャンネルののにを取得する必要があります。  これを行うには、<xref:System.Net.HttpListenerRequest.TransportContext%2A> のプロパティを使用し、CBT を取得するに <xref:System.Net.TransportContext.GetChannelBinding%2A> 方法を追加します。  エンドポイントののにのみがサポートされます。  何も指定されている場合、他の <xref:System.Security.Authentication.ExtendedProtection.ChannelBindingKind><xref:System.NotSupportedException> は投げられます。  基になるオペレーティング システムのサポートをのにを運べば、<xref:System.Net.TransportContext.GetChannelBinding%2A> 方法は `pInput` パラメータで渡した SecBuffer 構造の pvBuffer のメンバとして機能に [AcceptSecurityContext](http://go.microsoft.com/fwlink/?LinkId=147021) 渡されることに適したチャンネルののににポインタをラップする <xref:System.Security.Authentication.ExtendedProtection.ChannelBinding><xref:System.Runtime.InteropServices.SafeHandle> を返します。  <xref:System.Security.Authentication.ExtendedProtection.ChannelBinding.Size%2A> のプロパティは、チャンネルののにのバイトで、長さが含まれます。  基になるオペレーティング システムのチャンネルをサポートのに、機能を `null`を返します。  
+  
+ 別の可能なシナリオがプロキシを使用しない場合は、HTTP:\/\/ から接頭辞の拡張保護を有効にすることです。  この場合、<xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> の <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> に <xref:System.Net.HttpListener.ExtendedProtectionPolicy%2A?displayProperty=fullName> を設定します <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> または <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement>にし、<xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> の <xref:System.Security.Authentication.ExtendedProtection.ProtectionScenario> A の値に設定 <xref:System.Security.Authentication.ExtendedProtection.ProtectionScenario> を部分的に確かした荷渡方法に <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> が完全に確かした荷渡方法に対応しますが、<xref:System.Net.HttpListener> を設定します。  
+  
+ 許可されるサービス名の既定の一覧は、<xref:System.Net.HttpListener>とともに登録されている接頭辞に基づいて作成されます。  この既定の一覧は、<xref:System.Net.HttpListener.DefaultServiceNames%2A> のプロパティを使用して行われることができます。  このリストを包括的な場合、アプリケーションは既定のサービス名の一覧の代わりに使用される <xref:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy> クラスに対してコンストラクターでカスタム サービス名のコレクションを指定できます。  
+  
+ このコンフィギュレーションで、要求がチャンネルののにの確認なしで保護されたチャネルの外部の認証の利益なしでサーバーに一般に。  認証が成功すると、コンテキストは、クライアントが許容されるサービス名の一覧に対して提供し、検証するサービス名にただされます。  4 可能な結果があります:  
+  
+1.  サーバーの基になるオペレーティング システムには拡張保護はサポートされません。  要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントになります。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+2.  クライアントの基になるオペレーティング システムには拡張保護はサポートされません。  <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> のコンフィギュレーションの認証については、成功し、要求はアプリケーションになります。  <xref:System.Security.Authentication.ExtendedProtection.PolicyEnforcement> のコンフィギュレーションの認証については失敗します。  要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントになります。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+3.  クライアントの基になるオペレーティング システムには拡張保護をサポートしていますが、アプリケーションは、サービスののにを指定していません。  要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントになります。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+4.  クライアントがのサービスのにを指定します。  サービスののには許可されたサービスのにの一覧と比較されます。  これが一致した場合は、要求はアプリケーションになります。  それ以外の場合、要求はアプリケーションに公開されておらず、無許可 \(401\) 回答はクライアントに自動的に戻されます。  メッセージが失敗の理由を指定する <xref:System.Net.HttpListener> の追跡ソースに記録されます。  
+  
+ 許容されるサービス名で許可されるリストを使用してこの単純な方法が不十分である場合、アプリケーションは <xref:System.Net.HttpListenerRequest.ServiceName%2A> のプロパティの問い合わせによって独自のサービス名の検証を提供できます。  ケース 1 と 2 では、上記に、プロパティは `null`を返します。  3 種類のフィールドが空白文字列を返す場合。  4 を、クライアントで指定したサービス名を返す場合。  
+  
+ これらの拡張保護機能は、要求の他の型と認証のサーバー アプリケーションによって信頼されたプロキシを使用する場合に使用します。  
+  
+## 参照  
+ <xref:System.Security.Authentication.ExtendedProtection>   
+ <xref:System.Security.Authentication.ExtendedProtection.Configuration>
\ No newline at end of file
diff --git a/docs/framework/network-programming/international-resource-identifier-support-in-system-uri.md b/docs/framework/network-programming/international-resource-identifier-support-in-system-uri.md
new file mode 100644
index 00000000000..8fb93a4cf32
--- /dev/null
+++ b/docs/framework/network-programming/international-resource-identifier-support-in-system-uri.md
@@ -0,0 +1,60 @@
+---
+title: "System.Uri での International Resource Identifier のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b5e994c3-3535-4aff-8e1b-b69be22e9a22
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# System.Uri での International Resource Identifier のサポート
+<xref:System.Uri?displayProperty=fullName> クラスは、国際 Resource Identifier \(IRI\) およびドメイン名国際化 \(IDN\) のサポートが追加されました。  これらの改善は、.NET Framework 3.5、3.0 SP1 と 2.0 SP1 で使用できます。  
+  
+## IRI と IDN サポート  
+ Web アドレスは非常に、一連の文字で構成される Uniform Resource Identifier \(URI\) を使用して通常使用されます:  
+  
+-   英語のアルファベットの大文字および小文字の ASCII 文字。  
+  
+-   0 ～ 9 の数字。  
+  
+-   その他少数の ASCII 記号。  
+  
+ URI の仕様は、インターネット技術標準化委員会 \(IETF: Internet Engineering Task Force\) から発行された RFC 2396 および RFC 3986 に記述されています。  
+  
+ インターネットの普及と共に、英語以外の言語を使用してリソースを識別する必要も増えてきました。  このニーズを満たし、かつ非 ASCII 文字 \(Unicode\/ISO 10646 文字セットの文字\) を使用できる識別子に、IRI \(International Resource Identifier\) があります。  IRI の仕様は、IETF から発行された RFC 3987 に記述されています。  IRI を使用すると、URL に Unicode 文字を含めることができます。  
+  
+ <xref:System.Uri?displayProperty=fullName> の既存のクラスが RFC 3987 に基づいて IRI サポートを提供することによって延期されました。  現在のユーザーには、明確に IRI を有効にしない限り、.NET Framework 2.0 の動作からの変更点は分かりません。  これにより、以前のバージョンの .NET Framework との互換性が確保されます。  
+  
+ アプリケーションはドメイン名に IRI の分析のルールを適用するかどうかどうかを分析する国際化 \(IDN\) ドメイン名を使用するに適用される、および指定できます。  これは machine.config ファイルまたは app.config ファイルで行うことができます。  
+  
+ IDN を有効にすると、ドメイン名に含まれるすべての Unicode ラベルが等価の Punycode に変換されます。  Punycode 名は ASCII 文字だけで構成され、必ず xn\-\- というプレフィックスで始まります。  この目的は、インターネット上の既存の DNS サーバーをサポートすることです。ほとんどの DNS サーバーは、ASCII 文字しかサポートしていません \(RFC 3940 を参照\)。  
+  
+ IRI および IDN を有効にすると、<xref:System.Uri.DnsSafeHost%2A?displayProperty=fullName> プロパティの値に影響します。  IRI および IDN を有効にすると、<xref:System.Uri.Equals%2A?displayProperty=fullName>, <xref:System.Uri.OriginalString%2A?displayProperty=fullName> メソッド、<xref:System.Uri.GetComponents%2A?displayProperty=fullName> メソッド、および <xref:System.Uri.IsWellFormedOriginalString%2A> メソッドの動作が変わる場合もあります。  
+  
+ <xref:System.GenericUriParser?displayProperty=fullName> クラスも、IRI および IDN をサポートするカスタマイズ可能なパーサーを作成できるように拡張されました。  <xref:System.GenericUriParser?displayProperty=fullName> オブジェクトの動作は、<xref:System.GenericUriParserOptions?displayProperty=fullName> 列挙体で使用可能な値のビットごとの組み合わせを <xref:System.GenericUriParser?displayProperty=fullName> コンストラクターに渡すことによって指定されます。  <xref:System.GenericUriParserOptions?displayProperty=fullName> 型は、このパーサーが、IRI \(International Resource Identifiers\) の RFC 3987 で指定された解析規則をサポートすることを示します。  IRI は、実際に使用されるかを IRI が有効な場合に依存します。  
+  
+ <xref:System.GenericUriParserOptions?displayProperty=fullName> 型は、このパーサーが、国際化ドメイン名 \(IDN: Internationalized Domain Name\) によるホスト名の解析をサポートしていることを示します。  IDN は、実際に使用されるかを IDN が有効な場合に依存します。  
+  
+ 分析する IRI を有効にすると、RFC 3987 の最新の IRI のルールに従って確認すると文字を正規化します。  既定値が無効になるために分析する IRI の正規化するため、および文字確認が RFC 2396 と 3986 RFC に従って実行されます。  
+  
+ <xref:System.Uri?displayProperty=fullName> クラスを処理する IRI と IDN は、<xref:System.Configuration.IriParsingElement?displayProperty=fullName> と <xref:System.Configuration.IdnElement?displayProperty=fullName> のコンフィギュレーション設定のクラスを使用して管理されます。  <xref:System.Configuration.IriParsingElement?displayProperty=fullName> の設定により、<xref:System.Uri?displayProperty=fullName> クラスでの IRI 処理が有効または無効になります。  <xref:System.Configuration.IdnElement?displayProperty=fullName> の設定により、<xref:System.Uri> クラスでの IDN 処理が有効または無効になります。  <xref:System.Configuration.IriParsingElement?displayProperty=fullName> の設定も、IDN を間接的に制御します。  IDN 処理を可能にするには、IRI 処理を有効にする必要があります。  IRI 処理が無効な場合、IDN 処理は既定の設定値に設定されるため、互換性のために .NET Framework 2.0 の動作が使用されて、IDN 名は使用されません。  
+  
+ <xref:System.Configuration.IriParsingElement?displayProperty=fullName> と <xref:System.Configuration.IdnElement?displayProperty=fullName> のコンポーネント クラスのコンフィギュレーション設定が <xref:System.Uri?displayProperty=fullName> の最初のクラスが一度組み立て場合です。  それ以降の構成設定の変更は無視されます。  
+  
+## 参照  
+ <xref:System.Configuration.IdnElement?displayProperty=fullName>   
+ <xref:System.Configuration.IriParsingElement?displayProperty=fullName>   
+ <xref:System.Uri?displayProperty=fullName>   
+ <xref:System.Uri.DnsSafeHost%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/network-programming/internet-authentication.md b/docs/framework/network-programming/internet-authentication.md
new file mode 100644
index 00000000000..9675931cd59
--- /dev/null
+++ b/docs/framework/network-programming/internet-authentication.md
@@ -0,0 +1,55 @@
+---
+title: "インターネット認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "認証 [.NET Framework]、クラス"
+  - "IAuthenticationModule インターフェイス"
+  - "ICredentialLookup インターフェイス"
+  - "CredentialCache クラス、CredentialCache クラスについて"
+  - "受信 (データの)、認証"
+  - "AuthenticationManager クラス、AuthenticationManager クラスについて"
+  - "インターネット、認証"
+  - "送信 (データの)、認証"
+  - "ネットワーク リソース、認証"
+  - "ユーザー認証、認証用のクラス"
+  - "NetworkCredential クラス、NetworkCredential クラスについて"
+  - "クライアント認証、認証用のクラス"
+ms.assetid: d342e87c-f672-4660-a513-41a2f2b80c4a
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# インターネット認証
+<xref:System.Net> クラス、ダイジェスト基本支えましたり、標準的なインターネット認証方法など、さまざまなクライアント認証方法が、NTLM 認証および Kerberos、作成できるカスタム メソッド交渉します。  
+  
+ 認証の資格情報は、<xref:System.Net.ICredentials> のインターフェイスを実装する <xref:System.Net.NetworkCredential> と <xref:System.Net.CredentialCache> クラスに保存されます。  これらのクラスの 1 種類が資格ついてはただされると、**NetworkCredential** クラスのインスタンスを返します。  認証プロセスは <xref:System.Net.AuthenticationManager> クラスによって管理され、実際の認証プロセスは <xref:System.Net.IAuthenticationModule> のインターフェイスを実装する認証のモジュール クラスによって行われます。  使用する前に **AuthenticationManager** の注文の認証のモジュールを登録する必要があります; 基本のモジュール、ダイジェスト、NTLM 交渉 Kerberos 認証および認証方法は既定で登録されます。  
+  
+ **NetworkCredential** は URI によって識別される一つのインターネットのリソースに関連付けられている一連の資格情報を保存したり、必要に応じて <xref:System.Net.NetworkCredential.GetCredential%2A> 方法にそれらを返します。  **NetworkCredential** クラスは、インターネットでのリソースまたは資格情報のセットを同じどちらの場合も使用するアプリケーションによる制限数をアプリケーション アクセスして通常使用されます。  
+  
+ **\[CredentialCache\]** クラスは、さまざまな Web のリソースの資格情報の収集を格納します。  <xref:System.Net.CredentialCache.GetCredential%2A> 方法が呼び出されたときに、**\[CredentialCache\]** は Web リソースおよび要求された認証スキームの URI によって決定されるように適切な資格情報のセットを、返します。  **\[CredentialCache\]** クラスを使用した異なる認証スキームのさまざまなインターネットのリソースを対象に使用するアプリケーションは、必要に応じてすべての資格情報を保存するため、それらを提供します。  
+  
+ インターネットのリソースが認証が必要な場合、<xref:System.Net.WebRequest.GetResponse%2A?displayProperty=fullName> 方法は、資格情報の要求とともに **AuthenticationManager** に <xref:System.Net.WebRequest> を送信します。  要求は次のプロセスに従って、認証します:  
+  
+1.  **AuthenticationManager** は、が登録された順序で登録認証のモジュールそれぞれに <xref:System.Net.IAuthenticationModule.Authenticate%2A> 方法を追加します。  **AuthenticationManager** は、認証プロセスを実行するに **null** を戻さない最初のモジュールを使用します。  プロセスの詳細が含まれる認証のモジュールのタイプによって異なります。  
+  
+2.  認証プロセスが完了すると、インターネット リソースのアクセスを必要な情報を含む認証のモジュールの **\[WebRequest\]** に <xref:System.Net.Authorization> を返します。  
+  
+ ある認証スキームは、リソースのユーザーを認証要求できます。  したがって、アプリケーションは、リソースがより高いユーザーを preauthenticating すると時間を節約できます。サーバーに 1 回以上ラウンド トリップを削除します。  または、プログラムの起動時にユーザーによって関連で認証を後で実行できます。  preauthentication を使用して認証スキームは **true**に [&#91;CanPreAuthenticate&#93;](frlrfsystemnetiauthenticationmoduleclasspreauthenticatetopic) のプロパティを設定します。  
+  
+## 参照  
+ [基本認証とダイジェスト認証](../../../docs/framework/network-programming/basic-and-digest-authentication.md)   
+ [NTLM 認証および Kerberos 認証](../../../docs/framework/network-programming/ntlm-and-kerberos-authentication.md)   
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/internet-protocol-version-6.md b/docs/framework/network-programming/internet-protocol-version-6.md
new file mode 100644
index 00000000000..1292ac68629
--- /dev/null
+++ b/docs/framework/network-programming/internet-protocol-version-6.md
@@ -0,0 +1,73 @@
+---
+title: "インターネット プロトコル バージョン 6 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "IPv6、強化"
+  - "IPv4"
+  - "IPv6"
+  - "インターネット プロトコル バージョン 6、強化"
+  - "インターネット プロトコル バージョン 6"
+ms.assetid: e6fa8ebd-010a-4c48-a5ec-a5102c53c06f
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# インターネット プロトコル バージョン 6
+Internet Protocol version 6 \(IPv6\) は、インターネットでのネットワーク層の標準プロトコル新しいスイートです。  IPv6、住所の枯渇、セキュリティ、自動設定、拡張性に関連してインターネット プロトコル Suite 現在のバージョンの複数の問題 \(IPv4 と呼ぶこともあります\) 決済する場合などに設計されています。  IPv6 は、新しい種類のピアツーピアおよび移動式アプリケーションを含む、アプリケーションを有効にするには、インターネット機能を展開します。  次に、期限内に IPv4 プロトコルの主な問題点です:  
+  
+-   住所領域のまとめます。枯渇。  
+  
+     これは、ネットワーク アドレスの訳者 \(NATs\) を使用して一つのパブリック IP アドレスにそのマップの複数の個人住所を導きました。  このメカニズムによって作成された主要な問題エンドツーエンドの接続および間接費の不足を処理します。  
+  
+-   階層の例の不足。  
+  
+     固有の定義済クラスの組織では、IPv4 が true の階層にサポートを持たないされます。  偽りのネットワーク トポロジをマップする方法で IP アドレスを含めることが不可能です。  この重要な設計上の欠陥には、工順テーブルの必要性をインターネットのすべての場所で IPv4 パケットの出荷を作成します。  
+  
+-   複合ネットワークのコンフィギュレーション。  
+  
+     IPv4 によって、住所が静的に割り当てる DHCP などのコンフィギュレーションのセキュリティを使用します。  理想的な状況では、ホストは DHCP の下部組織の管理に依存必要はありません。  代わりに、ネットワークのある区分に基づいて自体をコンフィギュレーションできます。  
+  
+-   ビルトインな認証および機密の不足。  
+  
+     IPv4 は、交換されたデータの認証または暗号化を提供するすべてのメカニズムにサポートは必要ではありません。  これは IPv6 に変更されます。  選択すると、IPv6 サポートする必要があります。  
+  
+ 新しいプロトコルのスイートは、次の基本条件を満たす必要があります:  
+  
+-   間接費と、大規模な工順と住所。  
+  
+-   さまざまな接続ステータスの自動設定。  
+  
+-   ビルトインな認証および機密。  
+  
+ 詳細については、「[IPv6 アドレス指定](../../../docs/framework/network-programming/ipv6-addressing.md)」、「[IPv6 のルーティング](../../../docs/framework/network-programming/ipv6-routing.md)」、「[IPv6 の自動構成](../../../docs/framework/network-programming/ipv6-auto-configuration.md)」、「[IPv6 の有効化と無効化](../../../docs/framework/network-programming/enabling-and-disabling-ipv6.md)」、および「[方法: IPv6 のサポートを有効にするようにコンピューター構成ファイルを変更する](../../../docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md)」を参照してください。  
+  
+## 参照  
+ 次は、インターネット技術的なサービス委員会の拠点に表示できる、選択した RFC のドキュメントです \([http:\/\/www.ietf.org](http://www.ietf.org/)\) :  
+  
+-   将来のインターネット アーキテクチャに対する 1287 RFC。  
+  
+-   RFC 1454 の IP の次のバージョンの提案を比較。  
+  
+-   RFC 2373 の IP アドレスのバージョン 6 のアーキテクチャ。  
+  
+-   RFC 2374 の IPv6 の Aggregatable のグローバルなユニキャストの住所形式。  
+  
+ 、の [Technet の IPv6 の領域](http://go.microsoft.com/fwlink/?LinkID=179658)IPv6 関連情報を確認できます。  
+  
+## 参照  
+ [IPv6 のソケットのサンプル](http://go.microsoft.com/fwlink/?LinkID=179568)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/interpreting-network-tracing.md b/docs/framework/network-programming/interpreting-network-tracing.md
new file mode 100644
index 00000000000..9d49c77e79a
--- /dev/null
+++ b/docs/framework/network-programming/interpreting-network-tracing.md
@@ -0,0 +1,60 @@
+---
+title: "ネットワークのトレースの解釈 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "TraceMode 属性"
+  - "16 進数データ、ネットワークのトレース出力"
+  - "ネットワークのトレース、分析"
+  - "protocolonly"
+  - "テキスト、ネットワークのトレース出力"
+  - "includehex"
+ms.assetid: ad22b4b8-00af-4778-9cca-cb609ce1f8ff
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# ネットワークのトレースの解釈
+ネットワーク追跡を有効にすると、アプリケーションはさまざまな <xref:System.Net> クラスのメンバにする通話の取り込みに追跡を使用できます。  これらの通話の出力は、次の例に類似する場合があります。  
+  
+```  
+[588]   (4357)   Entering Socket#33574638::Send()  
+[588]   (4387)   Exiting Socket#33574638::Send()-> 61#61  
+```  
+  
+ 前の例では、\[588\]期限内のスレッドの固有 ID です。  \(4357\) および \(4387\) アプリケーションが開始されてから経過したミリ秒数を表示するタイムスタンプがあります。  タイムスタンプのデータが方法 **Socket.Send**を入力し、完了したアプリケーションを示します。  **\[送信\]** 方法を実行している対象に固有 ID として 33574638 があります。  方法の終了の追跡は、戻り値 \(前の例の 61\) が含まれます。  
+  
+ ネットワーク追跡は送信したり、自分のアプリケーションによってアプリケーション \(File Transfer Protocol\) などのアプリケーション レベルのセキュリティを使用して受信されているネットワーク トラフィックを取得できます。  このデータはテキストとして 16 桁数なデータとオプションで取得できます。  小数点以下 16 桁数なデータが **tracemode** の属性値として **\[includehex\]** の指定に使用できます。  \(この属性に関する詳細については、[方法へまたは: ネットワーク追跡をコンフィギュレーションします。](../../../docs/framework/network-programming/how-to-configure-network-tracing.md)を参照してください。次の例の追跡は **\[includehex\]**を使用して生成します。  
+  
+ `[1692]   (1142)   00000000 : 47 45 54 20 2F 77 70 61-64 2E 64 61 74 20 48 54 : GET /wpad.dat HT`  
+  
+ `[1692]   (1142)   00000010 : 54 50 2F 31 2E 31 0D 0A-48 6F 73 74 3A 20 69 74 : TP/1.1..Host: it`  
+  
+ `[1692]   (1142)   00000020 : 67 70 72 6F 78 79 0D 0A-43 6F 6E 6E 65 63 74 69 : gproxy..Connecti`  
+  
+ `[1692]   (1142)   00000030 : 6F 6E 3A 20 43 6C 6F 73-65 0D 0A 0D 0A     : on: Close....`  
+  
+ 小数点以下に 16 のデータを省略するには、**tracemode** の属性の値として **\[protocolonly\]** を指定します。  次の例では、**\[protocolonly\]** が指定されている場合追跡を示します。  
+  
+ `[2444]   (594)   Data from ConnectStream#33574638::WriteHeaders<<GET /wpad.dat HTTP/1.1`  
+  
+ `Host: itgproxy`  
+  
+ `Connection: Close`  
+  
+## 参照  
+ [ネットワークのトレースの有効化](../../../docs/framework/network-programming/enabling-network-tracing.md)   
+ [方法へまたは: ネットワーク追跡をコンフィギュレーションします。](../../../docs/framework/network-programming/how-to-configure-network-tracing.md)   
+ [.NET Framework のネットワークのトレース](../../../docs/framework/network-programming/network-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/introducing-pluggable-protocols.md b/docs/framework/network-programming/introducing-pluggable-protocols.md
new file mode 100644
index 00000000000..2e66c4801fe
--- /dev/null
+++ b/docs/framework/network-programming/introducing-pluggable-protocols.md
@@ -0,0 +1,83 @@
+---
+title: "プラグ可能なプロトコルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ要求、プラグ可能なプロトコル"
+  - "WebRequest クラス、プラグ可能なプロトコル"
+  - "インターネット要求への応答、プラグ可能なプロトコル"
+  - "URI"
+  - "Windows ソケット"
+  - "要求/応答モデル"
+  - "送信 (データを)、プラグ可能なプロトコル"
+  - "プラグ可能なプロトコル"
+  - "WebClient クラス、WebClient クラスの概要"
+  - "プラグ可能なプロトコル、プラグ可能なプロトコルの概要"
+  - "インターネット、プラグ可能なプロトコル"
+  - "パスの識別子"
+  - "Uniform Resource Identifier"
+  - "アプリケーション開発 [.NET Framework]、プラグ可能なプロトコル"
+  - "要求 (インターネットからデータを)、プラグ可能なプロトコル"
+  - "受信 (データを)、プラグ可能なプロトコル"
+  - "プロトコル、プラグ可能"
+  - "サーバーの識別子"
+  - "スキーマの識別子"
+ms.assetid: 4b48e22d-e4e5-48f0-be80-d549bda97415
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# プラグ可能なプロトコルの概要
+Microsoft .NET Framework 層に、スケーラブルを提供し、アプリケーションに迅速かつ簡単に統合できます。インターネット サービスの実装を管理します。  <xref:System.Net> インターネット アクセスのクラスおよび <xref:System.Net.Sockets> の名前空間が Web ベースおよびインターネット ベースのアプリケーションを実行することもできます。  
+  
+## Internet Application  
+ インターネット アプリケーションは 2 種類によって分類できます: クライアントの情報の返信サーバーおよびアプリケーション情報を要求するクライアント アプリケーション。  Web サーバーで世界的に格納されているドキュメントおよびそのほかのデータにアクセスするに古典的のインターネットのクライアント サーバー アプリケーションが World Wide Web ブラウザの使用をです。  
+  
+ アプリケーションはこれらのロールで、1 に限られません; たとえば、よく知られた中間層のアプリケーション サーバー、クライアントからの要求を別のサーバーからのデータの要求と作成者、サーバーとクライアントの両方として機能すると、回答します。  
+  
+ クライアント アプリケーションは、要求されたリソースのインターネット プロトコルの ID と配送に必要と回答に使用する要求を作成します。  必要に応じて、クライアントもプロキシの場所または認証情報 \(ユーザー名、パスワード完了するために必要な追加データをなど\) などの要求を提供します。  一度要求は、要求サーバーに送信できます形作られます。  
+  
+## リソースの ID  
+ .NET Framework は、要求されたインターネットのリソースと通信プロトコルを識別するために Uniform Resource Identifier \(URI\) を使用します。  URI 場合は、少なくとも 3 と 4 の片から構成されています: 要求と回答の通信プロトコルを識別する設定の ID \(; ドメイン ネーム システム \(DNS\) のホスト名またはインターネット サーバーを区別する TCP の住所から構成されるサーバーの ID \(; サーバーの要求された情報を探すパスの ID \(; およびクライアントからサーバーへ情報を渡すオプション クエリの文字列。  たとえば、URI 「http:\/\/www.contoso.com\/whatsnew.aspx?date\=today」\> 設定の ID のから「」http、サーバーの ID 「www.contoso.com」、および「\/whatsnew.aspx」、クエリの文字列または「構成されます。」date\=today。  
+  
+ サーバーが要求を受信した、応答を処理した後、クライアント アプリケーションへの応答を返します。  応答でコンテンツ タイプなどの追加の情報が含まれます \(未加工テキストまたは XML データなど\)。  
+  
+## .NET Framework の要求および応答  
+ 要求または応答のモデルをインターネットでのリソースにアクセスするために必要な 3 情報を提供する .NET Framework を使用:特定のクラス インターネットのリソースの URI を含む <xref:System.Uri> クラス、検索;します。リソースの要求を含む <xref:System.Net.WebRequest> クラス、; および受け取った応答にコンテナを提供する <xref:System.Net.WebResponse> クラス。  
+  
+ クライアント アプリケーションは <xref:System.Net.WebRequest.Create%2A> 方法、ネットワーク リソースの URI を渡すことによって、`WebRequest` のインスタンスを作成します。  この方法は、静的 HTTP など、特定のプロトコルの `WebRequest` を作成します。  `WebRequest` は、返品サーバーに要求と要求時に送信されるデータ ストリームへのアクセスを制御するプロパティの両方にアクセスできます。  `WebRequest` の <xref:System.Net.WebRequest.GetResponse%2A> 方法は、クライアント アプリケーションから URI で指定されているサーバーに要求を送信します。  回答の遅延可能性がある場合は、要求は **\[WebRequest\]**で <xref:System.Net.WebRequest.BeginGetResponse%2A> 方法を使用して回答は非同期的に作成 <xref:System.Net.WebRequest.EndGetResponse%2A> 方法を使用して後から戻すこともできます。  
+  
+ **GetResponse** と **EndGetResponse** 方法は **WebResponse** を返しますサーバーが返品データへアクセスできる。  このデータは <xref:System.Net.WebResponse.GetResponseStream%2A> 方法でストリームとして要求のアプリケーションに配送されるため、アプリケーションのデータ ストリーム常にで使用されます使用できます。  
+  
+ **WebResponse** の **\[WebRequest\]** およびクラスはプラグイン可能な基準プロトコル セキュリティ—特定の詳細を設定した各リソースの使用を継続するインターネットでのリソースを使用するアプリケーションを作成できるネットワーク サービスの実装です。  **\[WebRequest\]** その子孫のクラスが **\[WebRequest\]** のクラスとインターネットのリソースへの実績な接続詳細を管理する登録されます。  
+  
+ 、例として、<xref:System.Net.HttpWebRequest> のクラスは、HTTP を使用してインターネットのリソースに接続の詳細を管理します。  **\[WebRequest.Create\]** 方法が「http で始まる URI が検出と、既定では: 」や「https: 」 \(File、および安全な HTTP のプロトコル ID\) は、**\[WebRequest\]** **HttpWebRequest** に戻るように使用するプロパティをアクセス プロトコル対応することができます、です型にはめます。  ほとんどの場合、**\[WebRequest\]** 要求はすべての必要な情報を提供します。  
+  
+ 要求または応答のトランザクションとして表すことができる、プロトコルでも **\[WebRequest\]**で使用できます。  **\[WebRequest\]** と **WebResponse** からプロトコル対応クラスを取得し、を <xref:System.Net.WebRequest.RegisterPrefix%2A?displayProperty=fullName> の静的な方法のアプリケーションに使用する、品目を登録できます。  
+  
+ インターネット要求のクライアントの認証が必要な場合は、**\[WebRequest\]** の <xref:System.Net.WebRequest.Credentials%2A> のプロパティは、必要な資格情報が提供されます。  これらの資格情報は、NTLM または Kerberos 認証用に設定されている名前とパスワード\/ドメイン基本 HTTP の簡単な名前やパスワードの組み合わせ。また、認証を消化できます。  1 日付セットの資格情報は、[NetworkCredentials](frlrfsystemnetnetworkcredentialclasstopic) のインスタンスに保管するか、複数のセットは <xref:System.Net.CredentialCache> のインスタンス上で同時に保存できます。  **\[CredentialCache\]** は、その要求と認証スキーム URI のサーバーをサポート サーバーに送信いる資格情報を決定します。  
+  
+## Web クライアントの簡単な要求  
+ インターネットのリソースの簡単な要求をする必要があるアプリケーションの場合は <xref:System.Net.WebClient> のクラスは、データをアップロードまたはインターネット サーバーからのデータをダウンロードするに一般的な方法を提供します。  **WebClient** は **\[WebRequest\]** クラスにインターネットのリソースへアクセスできるする際にも; したがって、**WebClient** クラスは登録済プラグイン可能なプロトコルを使用できます。  
+  
+ 要求または応答のモデルを使用できないのアプリケーション用にまたはネットワーク上でリッスン、または要求を送信する必要があるアプリケーション **System.Net.Sockets** の名前空間が [TCPListener](frlrfsystemnetsocketstcplistenerclasstopic)と [UDPClient](frlrfsystemnetsocketsudpclientclasstopic) の [&#91;TCPClient&#93;](frlrfsystemnetsocketstcpclientclasstopic)、クラスを提供します。  これらのクラスは、さまざまなトランスポート プロトコルを使用して接続のための詳細を処理し、ネットワーク接続をストリームとしてアプリケーションに公開します。  
+  
+ Windows ソケットをよく知られた開発者が接続するか、**System.Net.Sockets** クラスのニーズを満たすことがレベルでソケット プログラミングに用意されているコントロールを必要とするユーザーは、判明します。  **System.Net.Sockets** のクラスが管理の **\[System.Net\]** クラス内のネイティブ コードに遷移ポイントです。  ほとんどの場合、**System.Net.Sockets** クラスは、Windows の 32 ビット物にデータをマーシャリングし、必要なセキュリティ検査を処理します。  
+  
+## 参照  
+ [プラグ可能なプロトコルのプログラミング](../../../docs/framework/network-programming/programming-pluggable-protocols.md)   
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [MSDN Code Gallery .NET のネットワーキングのサンプル](http://code.msdn.microsoft.com/Wiki/View.aspx?ProjectName=nclsamples)
\ No newline at end of file
diff --git a/docs/framework/network-programming/ipv6-addressing.md b/docs/framework/network-programming/ipv6-addressing.md
new file mode 100644
index 00000000000..852e2d7b3f8
--- /dev/null
+++ b/docs/framework/network-programming/ipv6-addressing.md
@@ -0,0 +1,87 @@
+---
+title: "IPv6 アドレス指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターネット プロトコル バージョン 6、アドレス"
+  - "近隣探索"
+  - "IPv6、有効化"
+  - "IPv6、モビリティおよび"
+  - "インターネット プロトコル バージョン 6、エニーキャスト アドレス"
+  - "IPv6、近隣探索"
+  - "インターネット プロトコル バージョン 6、自動構成"
+  - "インターネット プロトコル バージョン 6、有効化"
+  - "IPv6、ユニキャスト アドレス"
+  - "IPv6、自動構成"
+  - "インターネット プロトコル バージョン 6、ルーティング"
+  - "IPv6、RFC ドキュメント"
+  - "IPv6、ルーティング"
+  - "インターネット プロトコル バージョン 6、無効化"
+  - "インターネット プロトコル バージョン 6、ユニキャスト アドレス"
+  - "IPv6、マルチキャスト アドレス"
+  - "インターネット プロトコル バージョン 6、モビリティおよび"
+  - "インターネット プロトコル バージョン 6、RFC ドキュメント"
+  - "インターネット プロトコル バージョン 6、近隣探索"
+  - "IPv6、エニーキャスト アドレス"
+  - "インターネット プロトコル バージョン 6、マルチキャスト アドレス"
+  - "IPv6、アドレス"
+  - "IPv6、無効化"
+ms.assetid: 20a104ae-1649-4649-a005-531a5cf74c93
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# IPv6 アドレス指定
+Internet Protocol version 6 \(IPv6\) で、住所は 128 ビットのコードです。  作業する住所領域の 1 種類のは、インターネット トポロジを反映する工順のドメイン階層に使用可能な住所を細分します。  もう一つの理由がネットワークにデバイスを接続するインターフェイス\) またはネットワーク アダプタの住所です \(マップします。  IPv6 は、ネットワーク インターフェイス レベルにある、タスクを設定し、自動の機能が用意下位レベルの住所を解決するために固有の機能を。  
+  
+## テキストの表示  
+ ここでは、文字列として IPv6 の住所を表すために使用される 3 種類の慣習的なフォームがあります:  
+  
+-   **Colon\-hexadecimal form**。  これは、優先フォーム n:n:n:n:n:n:n です。  各 n、住所の 8 種類の 16 ビットの要素の 1 種類の小数点以下 16 桁値を表します。  たとえば、`3FFE:FFFF:7654:FEDA:1245:BA98:3210:4562` のように指定します。  
+  
+-   **Compressed form**。  住所の長さは、その原因で共通ゼロの詳細を含む一連住所があるためです。  これらの住所の書き込を簡略化するために、0 のブロックの一つの連続する番号順序が Double コロンの記号 \(::\) で表される圧縮されたフォームを使用します。  この記号は一度だけ住所に表示できます。  たとえば、圧縮されたフォームのマルチキャストの住所 `FFED:0:0:0:0:BA98:3210:4562` は `FFED::BA98:3210:4562`です。  圧縮されたフォームのユニキャストの住所 `3FFE:FFFF:0:0:8:800:20C4:0` は `3FFE:FFFF::8:800:20C4:0`です。  圧縮されたフォームのループバック住所 `0:0:0:0:0:0:0:1` は 1. `::`です。  圧縮されたフォームで明記されていない住所 `0:0:0:0:0:0:0:0` は `::`です。  
+  
+-   **Mixed form**。  このフォームは、IPv4 と IPv6 の住所を連結します。  この場合、住所形式は n:n:n:n:n:n:d.d.d.d です。ここで各 n が 6 件の IPv6 の高位 16 ビットの住所要素の小数点以下 16 桁の値を表す、および各 d は IPv4 の住所の小数を表します。  
+  
+## 住所タイプ  
+ 住所の先頭のオブジェクト、特定の IPv6 の住所タイプを定義します。  これらの先頭のオブジェクトを含む可変長フィールドの形式は、接頭辞 \(FP\) と呼ばれます。  
+  
+ IPv6 のユニキャストの住所が 2 人の部分に分割。  まず、接頭辞の住所を含み、2 番目の部分、インターフェイス ID が含まれます。  IPv6 の住所\/接頭辞の組み合わせを示す簡単な方法は次のとおりです: IPv6 住所プレフィックス\/長。  
+  
+ は次の 64 ビットの接頭辞の住所の例です。  
+  
+ `3FFE:FFFF:0:CD30:0:0:0:0/64`.  
+  
+ この例では、接頭辞 `3FFE:FFFF:0:CD30`です。  住所は、`3FFE:FFFF:0:CD30::/64`として圧縮された、フォームで作成できます。  
+  
+ IPv6 は、次の住所タイプを定義します:  
+  
+-   **Unicast address**。  一つのインターフェイスの ID。  このアドレスに送信されるパケットを特定したインターフェイスに渡されます。  ユニキャストの住所が高位オクテットの値によってマルチキャストの住所に未払のままになって。  マルチキャストの住所の高位オクテットは FF 小数点以下 16 桁の値が表示されます。  このオクテットの他の値をユニキャストの住所を識別します。  次にユニキャストの住所のさまざまなタイプがあります:  
+  
+    -   **Link\-local addresses**。  これらの住所は、一つのリンクで使用され、次の形式があります: FE80::InterfaceID.  ローカル リンクの住所が自動住所のコンフィギュレーションにリンクのノードの間でルーターがいない場合、横に検出、または使用されます。  ローカル リンクの住所が起動時にシステムがまだを超える範囲の住所を取得いない場合、主に使用されます。  
+  
+    -   **Site\-local addresses**。  これらの住所は、一つのサービス拠点で使用され、次の形式があります: FEC0::*SubnetID*:*InterfaceID*。  サービス拠点ローカルの住所がグローバルな接頭辞の必要性なしでサービス拠点内で住所に使用されます。  
+  
+    -   **Global IPv6 unicast addresses**。  これらの住所は、インターネットに使用され、次の形式を使用できます: 010 \(FP の 3 種類のビット\) TLA ID \(13 ビットのコード\) \(8 種類のビット\) NLA ID \(24 ビットのコードの ID \(SLA\) の 16 ビット\) *InterfaceID* \(64 ビットのコード\) を引当します。  
+  
+-   **Multicast address**。  一連のインターフェイスの ID \(通常はさまざまなノードに属する\)。  このアドレスに送信されるパケット、住所によって識別されるすべてのインターフェイスに渡されます。  マルチキャストの住所の型は、IPv4 の配信住所に代わって代わります。  
+  
+-   **Anycast address**。  一連のインターフェイスの ID \(通常はさまざまなノードに属する\)。  このアドレスに送信されるパケット、住所によって識別される 1 種類のインターフェイスに渡されます。  これは、メトリックの工順によって識別されるように最も近いインターフェイスです。  Anycast の住所がユニキャストの住所領域から取得され、構文上区別することはできません。  住所インターフェイスは、の機能としてユニキャストと anycast の住所間の識別を実行します。  
+  
+ 一般に、ノードにリンク ローカルの住所が常にです。  また、サービス拠点ローカルの住所と一つ以上のグローバル アドレスがあります。  
+  
+## 参照  
+ [インターネット プロトコル バージョン 6](../../../docs/framework/network-programming/internet-protocol-version-6.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/ipv6-auto-configuration.md b/docs/framework/network-programming/ipv6-auto-configuration.md
new file mode 100644
index 00000000000..7e8a88903f0
--- /dev/null
+++ b/docs/framework/network-programming/ipv6-auto-configuration.md
@@ -0,0 +1,39 @@
+---
+title: "IPv6 の自動構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 581c1d21-1013-43a3-bf3e-2d9ead62b79c
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# IPv6 の自動構成
+IPv6 の 1 種類の重要な目的は、ノードのプラグ アンド プレイをサポートするためです。  つまり、ノードを IPv6 のネットワークに差し込み、自動的にその影響介在なしでコンフィギュレーションすることは可能なはずです。  
+  
+## 自動型の設定  
+ IPv6 の設定が自動次の型をサポートしています:  
+  
+-   **Stateful auto\-configuration**。  この種の設定はノードのインストールや管理、IPv6 \(DHCPv6\) サーバーの構成プロトコルをホストで必要なそのための介在の特定のレベルが必要です。  DHCPv6 サーバーは、コンフィギュレーション情報が提供されるノード リストを維持します。  また、ステータス情報を管理します。各アドレスを使用した頻度である場合や、再割当に使用可能な場合があります\) サーバーはわかっています。  
+  
+-   **Stateless auto\-configuration**。  この種の設定が小規模な組織と個人に適しています。  この場合、各ホストは入庫済ルーター広告の内容の住所が決まります。  住所のネットワーク ID の一部を定義する IEEE EUI\-64 の標準を使用してリンク ホストの住所の独自性とすることができますです。  
+  
+ 住所の決定方法に関係なく、ノードであるか、潜在的な住所が保管場所のリンクに固有であることを確認する必要があります。  これは、潜在的な住所に横願いメッセージの送信に使用されます。  ノードが応答を受信すると、アドレスが既に使用中で、別の住所を決定することに気づきます。  
+  
+## IPv6 の移動性  
+ モバイル デバイスに拡散は、新しい条件をもたらしました: デバイスは、必要に応じて IPv6 のインターネット場所を変更または既存の接続を維持必要があります。  この機能を提供するには、携帯電話ノードは常に到達できる自宅住所が割り当てられます。  携帯電話ノードは家庭の場合は、自宅のリンクに接続し、自宅住所を使用します。  携帯電話ノードが自宅、通常の通信の携帯電話ルーター、入念ノード間の通信文およびノードである自宅のエージェントといういるとき。  
+  
+## 参照  
+ [インターネット プロトコル バージョン 6](../../../docs/framework/network-programming/internet-protocol-version-6.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/ipv6-routing.md b/docs/framework/network-programming/ipv6-routing.md
new file mode 100644
index 00000000000..021781a20cb
--- /dev/null
+++ b/docs/framework/network-programming/ipv6-routing.md
@@ -0,0 +1,48 @@
+---
+title: "IPv6 のルーティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: c98731b4-b542-46a2-9947-1cea63c186b2
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# IPv6 のルーティング
+柔軟な処理方法は IPv6 の福利厚生です。  IPv4 のネットワーク ID があり、割り当てられた方法により、大規模な工順の表に、インターネット バックボーンにあるルーターが管理している必要があります。  これらのルーターは、インターネットでの各ノードにべきではインデックスをパケットのようにすべての工順を知る必要があります。  住所を集計する機能と IPv6 は、フレックス住所を使用すると、包括的に工順テーブルのサイズが減少します。  この新しい住所アーキテクチャで、中間ルーターは、メッセージを適切に設定します。にネットワーク内の保管場所の部分のみの追跡を保たなければ必要があります。  
+  
+## 横に検出  
+ 横の検出によって提供される機能は、次のとおりです。:  
+  
+-   Router の検出。  これはホストが保管場所のルーターを識別することができます。  
+  
+-   住所の解決。  これはノードが対応するホップ次の住所 \(決済 ARP プロトコル\[住所\]のリンク レイヤの住所の交換決済されるようにします\)。  
+  
+-   住所の自動設定。  これはホストが自動的にサービス拠点ローカルおよびグローバル アドレスをコンフィギュレーションすることができます。  
+  
+ 横に検出は、次のような IPv6 \(ICMPv6\) メッセージに対して制御メッセージ インターネット プロトコルを使用します:  
+  
+-   Router 広告。  時定期的にまたはルーター願いに応じてのルーターに送信。  住所の状態、接頭辞、およびそのほかのパラメータを提供する IPv6 のルーターを使用ルーター広告。  
+  
+-   Router 願い。  リンクのルーターがルーター広告をすぐにするように要求するにホストで送信する。  
+  
+-   横願い。  、重複する住所の検出住所の決済のノードに送信、または隣人がまだ到達可能であることを確認します。  
+  
+-   横の広告。  横願いに応答するか、またはリンク レイヤの住所の変更の隣人を通知するためにノードに送信。  
+  
+-   リダイレクト。  出荷ノードの特定のデスティネーションでは、次ホップの住所を表示するにルーターに送信。  
+  
+## 参照  
+ [インターネット プロトコル バージョン 6](../../../docs/framework/network-programming/internet-protocol-version-6.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/listening-with-sockets.md b/docs/framework/network-programming/listening-with-sockets.md
new file mode 100644
index 00000000000..c686433de85
--- /dev/null
+++ b/docs/framework/network-programming/listening-with-sockets.md
@@ -0,0 +1,71 @@
+---
+title: "リッスン (ソケットで) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "ソケット、リッスン (ソケットで)"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "受信 (データの)、ソケット"
+  - "プロトコル、ソケット"
+  - "リッスン (ソケットで)"
+  - "インターネット、ソケット"
+ms.assetid: 40e426cc-13db-4371-95eb-f7388bd23ebf
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# リッスン (ソケットで)
+リスナーまたはサーバーのはソケット ネットワークのポートを開き、そのポートに接続するクライアントを待機しています。  そのほかのネットワーク アドレスとプロトコル ファミリがあるが、この例に示します。TCP\/IP ネットワークのリモート サービスを作成する方法に。  
+  
+ TCP\/IP サービスの固有住所がサービス用にエンドポイントを作成するには、サービスのポート番号でホストの IP アドレスを組み合わせることによって定義されます。  <xref:System.Net.Dns> クラスは、ネットワーク住所に関する情報が返品のローカル ネットワーク上のデバイスによって支えた方法を提供します。  ローカル ネットワーク上のデバイスが複数のネットワーク アドレスが存在する場合、ローカル システムが複数のネットワーク デバイスをサポートしている場合、**\[DNS\]** のクラスがすべてのネットワーク アドレスに関する情報を返品、アプリケーションは、サービスの適切な住所を選択する必要があります。  インター ネット住所を \(Iana\) 管理、共通のサービスのポート番号を定義します \(詳細については、www.iana.org\/assignments\/port\-numbers\) を参照してください。  他のサービス範囲は 1,024 に 65,535 のポート番号を登録できます。  
+  
+ 次の例では、ホスト コンピュータの **\[DNS\]** によって返された登録したポート番号から選択するポート番号によって最初の IP アドレスを組み合わせることによってサーバーの <xref:System.Net.IPEndPoint> 及びますを作成します。  
+  
+```vb  
+Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+Dim localEndPoint As New IPEndPoint(ipAddress, 11000)  
+  
+```  
+  
+```csharp  
+IPHostEntry ipHostInfo = Dns.Resolve(Dns.GetHostName());  
+IPAddress ipAddress = ipHostInfo.AddressList[0];  
+IPEndPoint localEndPoint = new IPEndPoint(ipAddress, 11000);  
+```  
+  
+ 保管場所のエンドポイントの決定したら、<xref:System.Net.Sockets.Socket> は <xref:System.Net.Sockets.Socket.Bind%2A> 方法、セットを使用してそのエンドポイントと <xref:System.Net.Sockets.Socket.Listen%2A> 方法を使用してエンドポイントにリッスンに関連付けられている必要があります。  **Bind** を必ず絶対アドレスとポートの組み合わせが既に使用中の場合は例外を投げます。  次の例では、**IPEndPoint**と **\[ソケット\]** を関連付けることを示します。  
+  
+```vb  
+listener.Bind(localEndPoint)  
+listener.Listen(100)  
+```  
+  
+```csharp  
+listener.Bind(localEndPoint);  
+listener.Listen(100);  
+```  
+  
+ **Listen** 方法は、サーバーのビジーなエラーが接続をクライアントに戻る前に **\[ソケット\]** によって保留中の接続を割り当てるか指定する一つのパラメータを取ります。  この場合、100 文字までのクライアントが接続のキューにサーバーのビジー応答がクライアント 101 番目に戻る前に設定されます。  
+  
+## 参照  
+ [同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-server-socket.md)   
+ [非同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-server-socket.md)   
+ [クライアント ソケットの使用](../../../docs/framework/network-programming/using-client-sockets.md)   
+ [方法: ソケットを作成する](../../../docs/framework/network-programming/how-to-create-a-socket.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/location-based-cache-policies.md b/docs/framework/network-programming/location-based-cache-policies.md
new file mode 100644
index 00000000000..51f17be2891
--- /dev/null
+++ b/docs/framework/network-programming/location-based-cache-policies.md
@@ -0,0 +1,64 @@
+---
+title: "場所ベースのキャッシュ ポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ""利用可能ならキャッシュを使用" ポリシー"
+  - "ポリシーの再読み込み"
+  - "場所ベースのキャッシュ ポリシー"
+  - ""キャッシュのみを使用" ポリシー"
+  - "ローカル キャッシュ"
+  - "中間キャッシュ"
+  - ""キャッシュを使用せず格納しない" ポリシー"
+  - "キャッシュ [.NET Framework]、場所ベースのポリシー"
+  - "再検証ポリシー"
+  - "キャッシュされたリソースの更新の確認間隔"
+  - ""キャッシュまたは次のキャッシュのみを使用" ポリシー"
+  - "更新ポリシー"
+ms.assetid: e41d7f1a-0a6a-4dee-97d1-c6a8b6a07fc2
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 場所ベースのキャッシュ ポリシー
+場所に基づくキャッシュのポリシーに基づいて有効なキャッシュされたエントリ要求されたリソースのソースにから取得できるかの新鮮さを定義します。  キャッシュされたリソースは、を使用することに違反するサーバー指定された revalidation の要件に有効です。  場所に基づくキャッシュのポリシーは <xref:System.Net.Cache.RequestCachePolicy> または <xref:System.Net.Cache.HttpRequestCachePolicy> クラスのコンストラクターを使用して、的に作成されます。  場所ベースのポリシー タイプは <xref:System.Net.Cache.RequestCacheLevel> または <xref:System.Net.Cache.HttpRequestCacheLevel> の列挙型の値を使用するコンストラクターに渡されます。  場所に基づくキャッシュのポリシーを作成するコード例では、[方法へまたは: アプリケーションの場所に基づくキャッシュのポリシーを設定します](../../../docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md)を参照してください。  次のセクションでは、アプリケーション転送プロトコル \(https\) http およびリソースの場所に基づくキャッシュのポリシーの各タイプについて説明します。  
+  
+## キャッシュの利用可能なポリシー  
+ 有効で要求されたリソースがローカル キャッシュの場合、キャッシュされたリソースが使用されます; それ以外の場合は、リソースのは、サーバーに送信されます。  要求されたリソースがクライアントとサーバー間のすべてのキャッシュで使用可能な場合は、要求は中間キャッシュによって請求できます。  
+  
+## キャッシュのポリシーのみ  
+ 有効で要求されたリソースがローカル キャッシュの場合、キャッシュされたリソースが使用されます。  このキャッシュのポリシー レベルが指定されている場合、<xref:System.Net.WebException> の例外が、品目がローカルにあるキャッシュ投げられます。  
+  
+## キャッシュが次のキャッシュのポリシーのみ  
+ 有効で要求されたリソースがローカル エリア ネットワークのローカル キャッシュまたは中間キャッシュの場合、キャッシュされたリソースが使用されます。  このような操作を行わない場合、<xref:System.Net.WebException> 例外がスローされます。  プロトコルをキャッシュする HTTP では、出荷がキャッシュされたキャッシュのコントロールの指令を使用して実行されます。  
+  
+## キャッシュ \(店舗のポリシーなし  
+ 要求されたリソースは、キャッシュからは使用されず、すべてのキャッシュには設定されません。  要求されたリソースがローカル キャッシュに応じて削除されます。  このポリシー レベルは、中間キャッシュによって、リソースを削除する必要があることを示します。  プロトコルをキャッシュするには、HTTP これは、店舗のキャッシュのコントロールの指令を使用して実行されます。  
+  
+## 最新の情報を更新のポリシー  
+ 要求されたリソースがサーバーから取得されるとき、またはキャッシュ以外の場合、ローカル キャッシュ使用できます。  中間キャッシュで要求に応じる前に、中間キャッシュに格納されているエントリをサーバーで再検証する必要があります。  プロトコルをキャッシュするには、HTTP これは、最大年齢を使用して \= 指導的な 0 のキャッシュのコントロールと非キャッシュのヘッダー PRAGMA 実行されます。  
+  
+## ポリシーの再読み込み  
+ 要求されたリソースがサーバーから取得する必要があります。  応答キャッシュがローカルに保存されている場合があります。  プロトコルをキャッシュするには、HTTP これは、指導的な非キャッシュのキャッシュのコントロールと非キャッシュ PRAGMA のヘッダーを使用して実行されます。  
+  
+## Revalidate ポリシー  
+ キャッシュされたリソースのコピーをサーバー上のコピーと比較します。  サーバー上のコピーの方が新しい場合、そのコピーを使用して要求に応じ、キャッシュのコピーを置き換えます。  キャッシュのコピーがサーバー上のコピーと同じ場合は、キャッシュにされたコピーが使用されます。  HTTP キャッシュ プロトコルの場合、これは条件付き要求を使用して実現されます。  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [時間ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/time-based-cache-policies.md)   
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/making-asynchronous-requests.md b/docs/framework/network-programming/making-asynchronous-requests.md
new file mode 100644
index 00000000000..bafb6d9b150
--- /dev/null
+++ b/docs/framework/network-programming/making-asynchronous-requests.md
@@ -0,0 +1,345 @@
+---
+title: "非同期要求を行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターネット、非同期アクセス"
+  - "ネットワーク"
+  - "非同期要求、インターネット リソース"
+  - "ネットワーク リソース"
+  - "WebRequest クラス、非同期アクセス"
+ms.assetid: 735d3fce-f80c-437f-b02c-5c47f5739674
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 非同期要求を行う
+<xref:System.Net> クラスは、インターネットのリソースに非同期なアクセス用に .NET フレームワークの標準非同期プログラミング モデルを使用します。  <xref:System.Net.WebRequest> クラスのライフサイクル <xref:System.Net.WebRequest.BeginGetResponse%2A> と <xref:System.Net.WebRequest.EndGetResponse%2A> 方法は、インターネットのリソースの非同期要求を完了します。  
+  
+> [!NOTE]
+>  非同期方法の同期のコールバック電話を使用して厳しいパフォーマンスのペナルティが生成できます。  **\[WebRequest\]** で行ったインターネット要求と子孫は <xref:System.Net.WebResponse.GetResponseStream%2A?displayProperty=fullName> 方法によって返されたストリームの読み取りに <xref:System.IO.Stream.BeginRead%2A?displayProperty=fullName> を使用する必要があります。  
+  
+ 次のサンプル コードは **\[WebRequest\]** のクラスと非同期通話を使用する方法を示します。  サンプル URI は、インターネットで入庫されるため、コマンド ラインから URI のコンソールのプログラム、必要とするリソースを選択し、次にコンソールに印刷するデータです。  
+  
+ プログラムは独自の使用のための 2 種類のクラスを、非同期の呼び出しにわたってデータを渡す、およびインターネットのリソースに非同期要求を実行する **ClientGetAsync** クラスを定義します **RequestState** クラス。  
+  
+ **RequestState** のクラスが要求をサービスする非同期な方法に電話に要求のステータスを管理します。  これは **\[WebRequest\]** とそれに対応受信なリソースおよびストリームに現在の要求、インターネット現在のリソースから受け取ったデータを含む、<xref:System.Text.StringBuilder> を含むバッファ <xref:System.IO.Stream> のインスタンスが含まれます完全な応答があります。  **RequestState**は、*州の* パラメータとして <xref:System.AsyncCallback> 方法が **WebRequest.BeginGetResponse**と登録時に渡されます。  
+  
+ **ClientGetAsync** クラスは、インターネットのリソースに非同期要求を実行し、コンソールへの応答結果を書き込みます。  これは次の一覧で記述方法、およびプロパティがあります。  
+  
+-   `allDone` のプロパティは要求の完了を通知する <xref:System.Threading.ManualResetEvent> クラスのインスタンスが含まれます。  
+  
+-   `Main()` 方法は、コマンド ラインを読み、インターネット指定のリソースの要求されます。  これはコールバックが完了するまでアプリケーションで終了しないように **\[WebRequest\]**`wreq` と **RequestState**`rs`を作成し、要求を処理する際に **BeginGetResponse** を追加し、`allDone.WaitOne()`方法を追加します。  応答をインターネットのリソースから読み取りと、`Main()` はコンソールで作成し、アプリケーションは終了。  
+  
+-   `showusage()` 方法はコンソールの例のコマンド ラインを書き込みます。  これは `Main()` によって URI のコマンド ラインで出荷されていないと呼ばれます。  
+  
+-   `RespCallBack()` 方法は、インターネット要求のコールバック非同期なメソッドを実行します。  これは、インターネットのリソースからの応答を含む **WebResponse** のインスタンスの作成および応答のベースを取得し、ストリームからデータを非同期的に読み取ることを開始します。  
+  
+-   `ReadCallBack()` 方法が応答のベースの読み取り対して非同期なコールバック メソッドを実行します。  これは、インターネットのリソースからデータが返品されるまで応答のベースの読み取り **RequestState** のインスタンスの **\[ResponseData\]** のプロパティに表示されるデータを移しましたりと別の非同期を開始します。  すべてのデータを読まれたら、`ReadCallBack()` が応答のベースを閉じ、全体の回答を **\[ResponseData\]**に指定するに `allDone.Set()` 方法を追加します。  
+  
+    > [!NOTE]
+    >  すべてのネットワーク ストリームが閉じられることが重要です。  各要求のベースと回答を閉じなければ、アプリケーションは、サーバーへの接続を使い果たし、追加情報を処理できなくなります。  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Threading;  
+using System.Text;  
+using System.IO;  
+  
+// The RequestState class passes data across async calls.  
+public class RequestState  
+{  
+   const int BufferSize = 1024;  
+   public StringBuilder RequestData;  
+   public byte[] BufferRead;  
+   public WebRequest Request;  
+   public Stream ResponseStream;  
+   // Create Decoder for appropriate enconding type.  
+   public Decoder StreamDecode = Encoding.UTF8.GetDecoder();  
+  
+   public RequestState()  
+   {  
+      BufferRead = new byte[BufferSize];  
+      RequestData = new StringBuilder(String.Empty);  
+      Request = null;  
+      ResponseStream = null;  
+   }       
+}  
+  
+// ClientGetAsync issues the async request.  
+class ClientGetAsync   
+{  
+   public static ManualResetEvent allDone = new ManualResetEvent(false);  
+   const int BUFFER_SIZE = 1024;  
+  
+   public static void Main(string[] args)   
+   {  
+      if (args.Length < 1)   
+      {  
+         showusage();  
+         return;  
+      }  
+  
+      // Get the URI from the command line.  
+      Uri httpSite = new Uri(args[0]);  
+  
+      // Create the request object.  
+      WebRequest wreq = WebRequest.Create(httpSite);  
+  
+      // Create the state object.  
+      RequestState rs = new RequestState();  
+  
+      // Put the request into the state object so it can be passed around.  
+      rs.Request = wreq;  
+  
+      // Issue the async request.  
+      IAsyncResult r = (IAsyncResult) wreq.BeginGetResponse(  
+         new AsyncCallback(RespCallback), rs);  
+  
+      // Wait until the ManualResetEvent is set so that the application   
+      // does not exit until after the callback is called.  
+      allDone.WaitOne();  
+  
+      Console.WriteLine(rs.RequestData.ToString());  
+   }  
+  
+   public static void showusage() {  
+      Console.WriteLine("Attempts to GET a URL");  
+      Console.WriteLine("\r\nUsage:");  
+      Console.WriteLine("   ClientGetAsync URL");  
+      Console.WriteLine("   Example:");  
+      Console.WriteLine("      ClientGetAsync http://www.contoso.com/");  
+   }  
+  
+   private static void RespCallback(IAsyncResult ar)  
+   {  
+      // Get the RequestState object from the async result.  
+      RequestState rs = (RequestState) ar.AsyncState;  
+  
+      // Get the WebRequest from RequestState.  
+      WebRequest req = rs.Request;  
+  
+      // Call EndGetResponse, which produces the WebResponse object  
+      //  that came from the request issued above.  
+      WebResponse resp = req.EndGetResponse(ar);           
+  
+      //  Start reading data from the response stream.  
+      Stream ResponseStream = resp.GetResponseStream();  
+  
+      // Store the response stream in RequestState to read   
+      // the stream asynchronously.  
+      rs.ResponseStream = ResponseStream;  
+  
+      //  Pass rs.BufferRead to BeginRead. Read data into rs.BufferRead  
+      IAsyncResult iarRead = ResponseStream.BeginRead(rs.BufferRead, 0,   
+         BUFFER_SIZE, new AsyncCallback(ReadCallBack), rs);   
+   }  
+  
+   private static void ReadCallBack(IAsyncResult asyncResult)  
+   {  
+      // Get the RequestState object from AsyncResult.  
+      RequestState rs = (RequestState)asyncResult.AsyncState;  
+  
+      // Retrieve the ResponseStream that was set in RespCallback.   
+      Stream responseStream = rs.ResponseStream;  
+  
+      // Read rs.BufferRead to verify that it contains data.   
+      int read = responseStream.EndRead( asyncResult );  
+      if (read > 0)  
+      {  
+         // Prepare a Char array buffer for converting to Unicode.  
+         Char[] charBuffer = new Char[BUFFER_SIZE];  
+  
+         // Convert byte stream to Char array and then to String.  
+         // len contains the number of characters converted to Unicode.  
+      int len =   
+         rs.StreamDecode.GetChars(rs.BufferRead, 0, read, charBuffer, 0);  
+  
+         String str = new String(charBuffer, 0, len);  
+  
+         // Append the recently read data to the RequestData stringbuilder  
+         // object contained in RequestState.  
+         rs.RequestData.Append(  
+            Encoding.ASCII.GetString(rs.BufferRead, 0, read));           
+  
+         // Continue reading data until   
+         // responseStream.EndRead returns –1.  
+         IAsyncResult ar = responseStream.BeginRead(   
+            rs.BufferRead, 0, BUFFER_SIZE,   
+            new AsyncCallback(ReadCallBack), rs);  
+      }  
+      else  
+      {  
+         if(rs.RequestData.Length>0)  
+         {  
+            //  Display data to the console.  
+            string strContent;                    
+            strContent = rs.RequestData.ToString();  
+         }  
+         // Close down the response stream.  
+         responseStream.Close();           
+         // Set the ManualResetEvent so the main thread can exit.  
+         allDone.Set();                             
+      }  
+      return;  
+   }      
+}  
+```  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Threading  
+Imports System.Text  
+Imports System.IO  
+  
+' The RequestState class passes data across async calls.  
+Public Class RequestState  
+  
+      Public RequestData As New StringBuilder("")  
+      Public BufferRead(1024) As Byte  
+      Public Request As HttpWebRequest  
+      Public ResponseStream As Stream  
+      ' Create Decoder for appropriate encoding type.  
+      Public StreamDecode As Decoder = Encoding.UTF8.GetDecoder()  
+  
+      Public Sub New  
+         Request = Nothing  
+         ResponseStream = Nothing  
+      End Sub  
+End Class  
+  
+' ClientGetAsync issues the async request.  
+Class ClientGetAsync  
+   Shared allDone As New ManualResetEvent(False)  
+      Const BUFFER_SIZE As Integer = 1024  
+  
+    Shared Sub Main()  
+        Dim Args As String() = Environment.GetCommandLineArgs()  
+  
+        If Args.Length < 2 Then  
+            ShowUsage()  
+            Return  
+        End If  
+  
+      ' Get the URI from the command line.  
+        Dim HttpSite As Uri = New Uri(Args(1))  
+  
+      ' Create the request object.  
+        Dim wreq As HttpWebRequest = _  
+           CType(WebRequest.Create(HttpSite), HttpWebRequest)  
+  
+      ' Create the state object.  
+      Dim rs As RequestState = New RequestState()  
+  
+      ' Put the request into the state so it can be passed around.  
+      rs.Request = wreq  
+  
+      ' Issue the async request.  
+        Dim r As IAsyncResult = _  
+           CType(wreq.BeginGetResponse( _  
+           New AsyncCallback(AddressOf RespCallback), rs), IAsyncResult)  
+  
+      ' Wait until the ManualResetEvent is set so that the application  
+      ' does not exit until after the callback is called.  
+        allDone.WaitOne()  
+    End Sub  
+  
+    Shared Sub ShowUsage()  
+        Console.WriteLine("Attempts to GET a URI")  
+        Console.WriteLine()  
+        Console.WriteLine("Usage:")  
+        Console.WriteLine("ClientGetAsync URI")  
+        Console.WriteLine("Examples:")  
+        Console.WriteLine("ClientGetAsync http://www.contoso.com/")  
+    End Sub  
+  
+    Shared Sub RespCallback(ar As IAsyncResult)  
+       ' Get the RequestState object from the async result.  
+       Dim rs As RequestState = CType(ar.AsyncState, RequestState)  
+  
+       ' Get the HttpWebRequest from RequestState.  
+       Dim req As HttpWebRequest= rs.Request  
+  
+       ' Call EndGetResponse, which returns the HttpWebResponse object  
+       ' that came from the request issued above.  
+       Dim resp As HttpWebResponse = _  
+           CType(req.EndGetResponse(ar), HttpWebResponse)  
+  
+       ' Start reading data from the respons stream.  
+       Dim ResponseStream As Stream = resp.GetResponseStream()  
+  
+       ' Store the reponse stream in RequestState to read  
+       ' the stream asynchronously.  
+       rs.ResponseStream = ResponseStream  
+  
+       ' Pass rs.BufferRead to BeginRead. Read data into rs.BufferRead.  
+       Dim iarRead As IAsyncResult = _  
+          ResponseStream.BeginRead(rs.BufferRead, 0, BUFFER_SIZE, _  
+          New AsyncCallback(AddressOf ReadCallBack), rs)  
+    End Sub  
+  
+   Shared Sub ReadCallBack(asyncResult As IAsyncResult)  
+      ' Get the RequestState object from the AsyncResult.  
+      Dim rs As RequestState = CType(asyncResult.AsyncState, RequestState)  
+  
+      ' Retrieve the ResponseStream that was set in RespCallback.  
+      Dim responseStream As Stream = rs.ResponseStream  
+  
+      ' Read rs.BufferRead to verify that it contains data.  
+      Dim read As Integer = responseStream.EndRead( asyncResult )  
+      If read > 0 Then  
+         ' Prepare a Char array buffer for converting to Unicode.  
+         Dim charBuffer(1024) As Char  
+  
+         ' Convert byte stream to Char array and then String.  
+         ' len contains the number of characters converted to Unicode.  
+         Dim len As Integer = _  
+           rs.StreamDecode.GetChars(rs.BufferRead, 0, read, charBuffer, 0)  
+         Dim str As String = new String(charBuffer, 0, len)      
+  
+         ' Append the recently read data to the RequestData stringbuilder   
+         ' object contained in RequestState.  
+         rs.RequestData.Append( _  
+            Encoding.ASCII.GetString(rs.BufferRead, 0, read))  
+  
+         ' Continue reading data until responseStream.EndRead  
+         ' returns –1.  
+         Dim ar As IAsyncResult = _  
+            responseStream.BeginRead(rs.BufferRead, 0, BUFFER_SIZE, _  
+            New AsyncCallback(AddressOf ReadCallBack), rs)  
+      Else  
+          If rs.RequestData.Length > 1 Then  
+            ' Display data to the console.  
+            Dim strContent As String  
+            strContent = rs.RequestData.ToString()  
+            Console.WriteLine(strContent)  
+         End If  
+  
+         ' Close down the response stream.  
+         responseStream.Close()  
+  
+         ' Set the ManualResetEvent so the main thread can exit.  
+         allDone.Set()  
+      End If  
+  
+      Return  
+   End Sub  
+End Class  
+```  
+  
+## 参照  
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/managing-connections.md b/docs/framework/network-programming/managing-connections.md
new file mode 100644
index 00000000000..2ab222a0946
--- /dev/null
+++ b/docs/framework/network-programming/managing-connections.md
@@ -0,0 +1,76 @@
+---
+title: "接続の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターネット、接続"
+  - "HTTP、クラス (接続用の)"
+  - "要求 (インターネットからデータを)、接続"
+  - "送信 (データを)、接続"
+  - "受信 (データを)、接続"
+  - "ServicePoint クラス、ServicePoint クラスの概要"
+  - "インターネット要求への応答、接続"
+  - "接続 [.NET Framework]、クラス"
+  - "ネットワーク リソース、接続"
+  - "ダウンロード (インターネット リソースの)、接続"
+  - "ServicePointManager クラス、ServicePointManager クラスの概要"
+ms.assetid: 9b3d3de7-189f-4f7d-81ae-9c29c441aaaa
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# 接続の管理
+データ リソースに接続して HTTP を使用するアプリケーションは、インターネットへの接続を管理し、最適なスケール、パフォーマンスの実現にするには、.NET フレームワークの <xref:System.Net.ServicePoint> と <xref:System.Net.ServicePointManager> クラスを使用できます。  
+  
+ **ServicePoint** クラスは、インターネットのリソースにアクセスするアプリケーションが接続できるエンドポイントをアプリケーションが提供されます。  各 **ServicePoint** は、パフォーマンスを改善するにヘルプが接続間の最適化情報を共有することで、インターネット サーバーがとの接続を最適化する情報が含まれます。  
+  
+ 各 **ServicePoint** は Uniform Resource Identifier \(URI\) が確認され、URI の設定の ID とホストの片に従って並べ替えられます。  たとえば、**ServicePoint** 同じ URI のインスタンスは http:\/\/www.contoso.com\/index.htm、http:\/\/www.contoso.com\/news.htm?date\=today に同じ設定の ID \(http\) とホストの片 \(www.contoso.com\) がある要求を提供します。  既にアプリケーションにサーバーへの接続が www.contoso.com 耐久性がある場合、2 種類の接続を作成する必要が回避両方の要求を取得するためにその接続を使用します。  
+  
+ **ServicePointManager** は **ServicePoint** のインスタンスの作成と管理を破壊する静的クラスです。  **ServicePointManager** は、アプリケーションが **ServicePoint** のあるインスタンスのグループにない Internet のリソースが必要な場合 **ServicePoint** を作成します。  **ServicePoint** のインスタンスは最大のアイドル時間を超えた場合、または **ServicePoint** のあるインスタンスの数がアプリケーションの **ServicePoint** のインスタンスの最大数を超えた場合に、破壊されます。  **ServicePointManager**の <xref:System.Net.ServicePointManager.MaxServicePointIdleTime%2A> と <xref:System.Net.ServicePointManager.MaxServicePoints%2A> のプロパティの設定によって **ServicePoint** のインスタンスの既定の最大のアイドル時間と最大数の両方を制御できます。  
+  
+ クライアントとサーバー間の接続数は、アプリケーションのスループットの劇的な影響することができます。  既定では、<xref:System.Net.HttpWebRequest> クラスを使用してアプリケーションは最大特定のサーバーへの 2 種類の耐久性がある接続を使用して、アプリケーション基準の接続ごとの最大数を設定できます。  
+  
+> [!NOTE]
+>  制限 HTTP\/1.1 標準アプリケーションからサーバー 1 通の 2 種類の接続に接続する番号。  
+  
+ 接続の最適な番号は、アプリケーションで実行される実際の要件によって異なります。  使用可能なアプリケーションに接続の数は、増やすことは、アプリケーションのパフォーマンスに影響しない場合があります。  接続数を変えて中詳細に接続の影響を決定するため、実行パフォーマンステスト。  次のサンプル コードに示すように、アプリケーションでアプリケーションの初期設定に **ServicePointManager** クラスの <xref:System.Net.ServicePointManager.DefaultConnectionLimit%2A> の静的なプロパティの変更で使用する接続数を変更できます。  
+  
+```csharp  
+// Set the maximum number of connections per server to 4.  
+ServicePointManager.DefaultConnectionLimit = 4;  
+```  
+  
+```vb  
+' Set the maximum number of connections per server to 4.  
+ServicePointManager.DefaultConnectionLimit = 4  
+```  
+  
+ **\[ServicePointManager.DefaultConnectionLimit\]** のプロパティを変更すると、前に **ServicePoint** の初期化したインスタンスには影響しません。  次のコードは `newLimit`に格納されている値にサーバーの http:\/\/www.contoso.com 既存の **ServicePoint** の接続の限度を変更することを示します。  
+  
+```csharp  
+Uri uri = new Uri("http://www.contoso.com/");  
+ServicePoint sp = ServicePointManager.FindServicePoint(uri);  
+sp.ConnectionLimit = newLimit;  
+```  
+  
+```vb  
+Dim uri As New Uri("http://www.contoso.com/")  
+Dim sp As ServicePoint = ServicePointManager.FindServicePoint(uri)  
+sp.ConnectionLimit = newLimit  
+```  
+  
+## 参照  
+ [接続のグループ化](../../../docs/framework/network-programming/connection-grouping.md)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/nat-traversal-using-ipv6-and-teredo.md b/docs/framework/network-programming/nat-traversal-using-ipv6-and-teredo.md
new file mode 100644
index 00000000000..3718c664605
--- /dev/null
+++ b/docs/framework/network-programming/nat-traversal-using-ipv6-and-teredo.md
@@ -0,0 +1,65 @@
+---
+title: "IPv6 および Teredo を使用した NAT トラバーサル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 568cd245-3300-49ef-a995-d81bf845d961
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# IPv6 および Teredo を使用した NAT トラバーサル
+ネットワーク アドレス変換 \(NAT\) の横断をサポートする改善が行われた。  これらの変更は、IPv6 と Teredo 用に設計されていますが、技術にトンネルを掘る他の IP に、適用されるです。  これらの改善は <xref:System.Net> および関連する名前空間のクラスに影響します。  
+  
+ 技術にトンネルを掘る IP の使用を計画するこれらの変更は、クライアントとサーバー アプリケーションに影響を与える可能性があります。  
+  
+ サポート NAT.横断への変更は、.NET Framework Version 4.を使用してアプリケーションにのみ使用できます。  これらの機能は、.NET Framework の以前のバージョンでは使用できません。  
+  
+## 概要  
+ Internet Protocol version 4 \(IPv4\) は、32 ビットのコードと IPv4 の住所をで定義します。  したがって、IPv4 は、約 40億固有の IP アドレス \(2^32\) がサポートされます。  90 時間に配置されたインターネット上のコンピュータおよびネットワーク デバイスの数として IPv4 の住所領域の限度が明確になります。  
+  
+ IPv4 の有効期間を延長するために使用されている技術の 1 が、単一の固有パブリック IP アドレスが複数のプライベート IP アドレス \(プライベート イントラネット\) を表すように NAT を展開します。  NAT.デバイスの後のプライベート IP アドレスは、パブリック IPv4 の住所を共有します。  NAT.デバイスは、専用のハードウェア デバイス \(低な無線アクセス ポイントおよびルーターなど\) または NAT を提供するサービスを実行しているコンピュータである場合があります。  この、各種の IP アドレスのデバイスまたはサービスは、インターネットをプライベート イントラネット間の IP のネットワーク パケットを変換します。  
+  
+ この設定は、プライベート イントラネットで実行されるインターネット他の IP アドレス \(通常は\) サーバーに要求を送信クライアント アプリケーションの場合によくあります。  応答を送信または応答することがわかっている戻す場合 NAT.サーバーまたはデバイスがクライアントのマッピングその要求を保持することができます。  ただし、この設定は NAT.デバイスの後でプライベート イントラネットで実行されるサービスを提供するとともにそばパケット聴覚を立て、対応するアプリケーションの問題を提起します。  これはピアツーピア アプリケーション用に、ケースです。  
+  
+ IPv6 プロトコルは 128 ビットのコードと IPv4 の住所をで定義します。  したがって、IPv6 は非常に大きな 3.2 x 10^38 個の固有 IP アドレス　\(2^128 個\) をサポートします。  この住所領域のサイズによって、一意な住所が許可されるインターネットに関連するすべてのデバイスにできます。  この問題があります。  世界の大部分はまだ IPv4 のみ使用します。  特に、既存のルーター複数の会社と小世帯と、組織が使用する無線アクセス ポイントは IPv6 はサポートされません。  これらの顧客に使用するインターネット サービス プロバイダが IPv6 のサポートをサポートしていませんとコンフィギュレーションしていません。  
+  
+ 複数の IPv6 の切り替えテクノロジは IPv4 のパケットの IPv6 の住所にトンネルを掘るは、セキュリティ面。  これらのテクノロジには、他の IPv6 のネットワークに到達するため IPv6 のネットワーク ホストが IP4 をスキャンする必要がある場合 6to4、ISATAP とユニキャストの IPv6 のトラフィックに住所指定およびホストでホストの自動トンネリングを提供する Teredo のトンネルが含まれます。  パケットの IPv6 は IPv4 のパケットとしてトンネルを掘られて送信されます。  NAT.デバイスを使用して IPv6 の住所の NAT.横断ようにするトンネリング テクノロジが使用されます。  
+  
+ Teredo は IPv4 のネットワークに IPv6 の接続が移動 IPv6 の切り替えテクノロジの 1 つです。  Teredo は、インターネット技術的な委員会 \(IETF\) が発行される RFC 4380 に記載されます。  Windows XP SP2 が範囲 2001:0::\/32 パブリック IPv6 の住所を提供する仮想の Teredo アダプタに、後でサポートを提供します。  この IPv6 の住所は、インターネットからフォワードに接続そば聴覚を立てるには、リッスン サービスに接続する IPv6 によって有効にするクライアントに提供できます。  これは、問題をからアプリケーションで IPv6 の Teredo の住所を使用してに接続できるため、アプリケーションを NAT.デバイスの後のコンピュータ住所をリリースします。  
+  
+## NAT.横断と Teredo をサポートする改良  
+ 改良は NAT.横断をサポートするための <xref:System.Net>、<xref:System.Net.NetworkInformation>と IPv6 と Teredo を使用して <xref:System.Net.Sockets> の名前空間に追加されます。  
+  
+ 複数の方法は <xref:System.Net.NetworkInformation.IPGlobalProperties?displayProperty=fullName> クラスでホストのユニキャストの IP アドレスの一覧を取得するために追加されます。  <xref:System.Net.NetworkInformation.IPGlobalProperties.BeginGetUnicastAddresses%2A> 方法がローカル コンピュータの安定したユニキャストの IP アドレスのテーブルを取得する非同期要求されます。  <xref:System.Net.NetworkInformation.IPGlobalProperties.EndGetUnicastAddresses%2A> 方法がローカル コンピュータの安定したユニキャストの IP アドレスのテーブルを取得する保留中非同期要求を終了。  <xref:System.Net.NetworkInformation.IPGlobalProperties.GetUnicastAddresses%2A> 方法は、アドレス テーブルを必要に応じて紹介するまで待機するローカル コンピュータの安定したユニキャストの IP アドレスのテーブルを同期取得する要求です。  
+  
+ <xref:System.Net.IPAddress.IsIPv6Teredo%2A?displayProperty=fullName> のプロパティが <xref:System.Net.IPAddress> が IPv6 の Teredo 住所であるかどうかを判断するために使用できます。  
+  
+ <xref:System.Net.IPAddress.IsIPv6Teredo%2A> のプロパティを添付これらの新しい <xref:System.Net.NetworkInformation.IPGlobalProperties> クラスの方法を使用して簡単に Teredo の住所を検索するアプリケーションができます。  アプリケーションはリモート アプリケーションにこの情報が含まれている場合に保管場所の Teredo の住所を従業員全体に知らせたくない場合にのみ必要があります。通常  たとえば、ピアツーピア アプリケーションは、アプリケーション配送を有効にする場合は、他に凝視するそれらをようにするマッチメーク サーバーに IPv6 すべての住所を送信する場合があります。  
+  
+ アプリケーションは保管場所の住所 Teredo のではなく <xref:System.Net.IPAddress.IPv6Any?displayProperty=fullName> のリッスンは、リッスン サービスを設定する必要があります。  したがって、リモート クライアントまたはピアがリッスン サービスのホストに直接 IPv6 の工順がある場合は、クライアントまたはピア IPv6 を使用してに直接接続し、を Teredo パケットにトンネルを掘るに使用する必要がない場合。  
+  
+ TCP のアプリケーション用に、<xref:System.Net.Sockets.TcpListener?displayProperty=fullName> クラスに NAT.横断を有効にする <xref:System.Net.Sockets.TcpListener.AllowNatTraversal%2A> の方法があります。  UDP アプリケーションの場合は、<xref:System.Net.Sockets.UdpClient?displayProperty=fullName> クラスに NAT.横断を有効にする <xref:System.Net.Sockets.UdpClient.AllowNatTraversal%2A> の方法があります。  
+  
+ <xref:System.Net.Sockets.Socket?displayProperty=fullName> を使用し、関連する <xref:System.Net.Sockets.Socket.GetSocketOption%2A> クラス、および <xref:System.Net.Sockets.Socket.SetSocketOption%2A> 方法がの <xref:System.Net.Sockets.SocketOptionName?displayProperty=fullName> ソケット オプションおよび照会するに使用できるアプリケーションに対して有効または NAT.横断を無効にします。  
+  
+## 参照  
+ <xref:System.Net.IPAddress.IsIPv6Teredo%2A?displayProperty=fullName>   
+ <xref:System.Net.NetworkInformation.IPGlobalProperties.BeginGetUnicastAddresses%2A?displayProperty=fullName>   
+ <xref:System.Net.NetworkInformation.IPGlobalProperties.EndGetUnicastAddresses%2A?displayProperty=fullName>   
+ <xref:System.Net.NetworkInformation.IPGlobalProperties.GetUnicastAddresses%2A?displayProperty=fullName>   
+ <xref:System.Net.Sockets.IPProtectionLevel?displayProperty=fullName>   
+ <xref:System.Net.Sockets.Socket.SetIPProtectionLevel%2A?displayProperty=fullName>   
+ <xref:System.Net.Sockets.TcpListener.AllowNatTraversal%2A?displayProperty=fullName>   
+ <xref:System.Net.Sockets.UdpClient.AllowNatTraversal%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/network-programming/network-isolation-for-windows-store-apps.md b/docs/framework/network-programming/network-isolation-for-windows-store-apps.md
new file mode 100644
index 00000000000..8302caaeab5
--- /dev/null
+++ b/docs/framework/network-programming/network-isolation-for-windows-store-apps.md
@@ -0,0 +1,44 @@
+---
+title: "Windows ストア アプリのネットワーク分離 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b064497c-d956-46b8-838d-7a0223c7e200
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# Windows ストア アプリのネットワーク分離
+<xref:System.Net>、<xref:System.Net.Http>と <xref:System.Net.Http.Headers> の名前空間のクラスは、Windows の店舗または apps デスクトップ アプリケーションを作成することもできます。  Windows の app 店舗で使用される場合、これらの名前空間のクラスが [!INCLUDE[win8](../../../includes/win8-md.md)]に、ネットワーク上、それぞれ、アプリケーション セキュリティ モデルのコンポーネントによって使用される変化します。  適切なネットワークの機能は、システムの Windows app 店舗の app のマニフェスト ネットワークにアクセスできるように有効にする必要があります。  
+  
+## ネットワーク、それぞれのチェックリスト  
+ ネットワークのそれぞれが Windows の店舗 app にコンフィギュレーションされていることを確認するには、このチェックリストを使用します。  
+  
+1.  app が必要とするネットワーク アクセスの方向を決定します。  これは出庫のクライアント開始された要求になります。また、受信した未承諾の要求がその両方のネットワークで要求タイプの組み合わせにすることができます。  
+  
+2.  その app が通信ネットワーク リソース タイプを定義します。  app はホームの信頼されたリソースと通信するか、ネットワークを証明する必要があります。  app は、インターネットでのリソースと通信する必要があります。  app が必要です。両方のタイプのネットワーク リソースへのアクセスをことがあります。  
+  
+3.  app のマニフェストの必要な最小ネットワーキングの分離の機能をコンフィギュレーションします。  
+  
+4.  、の app を展開し、修復に提供されているネットワーク、それぞれのツールを使用して、をテストするに移動します。  
+  
+ ネットワーク、それぞれのトラブルシューティングするために使用するネットワークの機能と分離のツールをコンフィギュレーションする方法の詳細については [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] の開発者ドキュメント参照 [ネットワーク、それぞれの機能をコンフィギュレーションする方法](http://go.microsoft.com/fwlink/?LinkID=228265) してください。  
+  
+## 参照  
+ [Web サービスへの接続](http://go.microsoft.com/fwlink/?LinkID=245696)   
+ [ネットワーク、それぞれのガイドラインとチェックリスト](http://go.microsoft.com/fwlink/?LinkID=228265)   
+ [: Quickstart HttpClient を使用して接続](http://go.microsoft.com/fwlink/?LinkId=245697)   
+ [HttpClient のハンドラーの使用方法](http://go.microsoft.com/fwlink/?LinkId=245699)   
+ [HttpClient の接続を保護する方法](http://go.microsoft.com/fwlink/?LinkId=245698)   
+ [サンプルの HttpClient](http://go.microsoft.com/fwlink/?LinkId=242550)
\ No newline at end of file
diff --git a/docs/framework/network-programming/network-programming-how-to-topics.md b/docs/framework/network-programming/network-programming-how-to-topics.md
new file mode 100644
index 00000000000..15d9921707a
--- /dev/null
+++ b/docs/framework/network-programming/network-programming-how-to-topics.md
@@ -0,0 +1,93 @@
+---
+title: "ネットワーク プログラミング方法のトピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク リソース"
+  - "ネットワーク [.NET Framework]、プログラミング方法"
+  - "ネットワーキング方法 [.NET Framework]"
+  - "ネットワーク"
+ms.assetid: 8fd6c675-9ea6-4fad-a412-e2c2c1f233d8
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# ネットワーク プログラミング方法のトピック
+次の一覧は、ネットワーク プログラミングに関する概念的なドキュメントに見つかったトピックへのリンクが含まれます。  
+  
+ **データの要求:**  
+  
+-   [方法: Web ページを要求し、ストリームとして結果を取得する](../../../docs/framework/network-programming/how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md)  
+  
+-   [方法: WebRequest クラスを使用してデータを要求する](../../../docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md)  
+  
+-   [方法: WebRequest クラスを使用してデータを送信する](../../../docs/framework/network-programming/how-to-send-data-using-the-webrequest-class.md)  
+  
+-   [方法: WebRequest に一致するプロトコル固有の WebResponse を取得する](../../../docs/framework/network-programming/how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md)  
+  
+ **プラグイン可能なアプリケーション セキュリティ:**  
+  
+-   [方法: WebRequest を使用してカスタム プロトコルを登録する](../../../docs/framework/network-programming/how-to-register-a-custom-protocol-using-webrequest.md)  
+  
+-   [方法: WebRequest を型キャストしてプロトコル固有のプロパティにアクセスする](../../../docs/framework/network-programming/how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md)  
+  
+-   [方法: HTTP 固有のプロパティにアクセスする](../../../docs/framework/network-programming/how-to-access-http-specific-properties.md)  
+  
+-   [方法: グループの接続にユーザー情報を割り当てる](../../../docs/framework/network-programming/how-to-assign-user-information-to-group-connections.md)  
+  
+-   [方法: ソケットを作成する](../../../docs/framework/network-programming/how-to-create-a-socket.md)  
+  
+-   [方法: FTP を使用してファイルをダウンロードする](../../../docs/framework/network-programming/how-to-download-files-with-ftp.md)  
+  
+-   [方法: FTP を使用してファイルをアップロードする](../../../docs/framework/network-programming/how-to-upload-files-with-ftp.md)  
+  
+-   [方法: FTP でディレクトリの内容を一覧表示する](../../../docs/framework/network-programming/how-to-list-directory-contents-with-ftp.md)  
+  
+ **Internet Protocol version 6:**  
+  
+-   [方法: IPv6 のサポートを有効にするようにコンピューター構成ファイルを変更する](../../../docs/framework/network-programming/how-to-modify-the-computer-configuration-file-to-enable-ipv6-support.md)  
+  
+ **追跡:ネットワーク**  
+  
+-   [方法へまたは: ネットワーク追跡をコンフィギュレーションします。](../../../docs/framework/network-programming/how-to-configure-network-tracing.md)  
+  
+ **:キャッシュのコンフィギュレーション**  
+  
+-   [方法: アプリケーションの場所ベースのキャッシュ ポリシーを設定します。](../../../docs/framework/network-programming/how-to-set-a-location-based-cache-policy-for-an-application.md)  
+  
+-   [方法: アプリケーションの既定の時間ベースのキャッシュ ポリシーを設定します。](../../../docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md)  
+  
+-   [方法: 時間ベースのキャッシュ ポリシーをカスタマイズする](../../../docs/framework/network-programming/how-to-customize-a-time-based-cache-policy.md)  
+  
+-   [方法: 要求のキャッシュ ポリシーを設定する](../../../docs/framework/network-programming/how-to-set-cache-policy-for-a-request.md)  
+  
+ **プロキシを使用します:**  
+  
+-   [方法: WebRequest でインターネットとの通信にプロキシを使用できるようにする](../../../docs/framework/network-programming/how-to-enable-a-webrequest-to-use-a-proxy-to-communicate-with-the-internet.md)  
+  
+-   [方法: グローバル プロキシの選択をオーバーライドする](../../../docs/framework/network-programming/how-to-override-a-global-proxy-selection.md)  
+  
+ **ネットワークの情報:**  
+  
+-   [方法: ネットワークの可用性とアドレスの変更を検出する](../../../docs/framework/network-programming/how-to-detect-network-availability-and-address-changes.md)  
+  
+-   [方法: インターフェイス情報とプロトコル情報を取得する](../../../docs/framework/network-programming/how-to-get-interface-and-protocol-information.md)  
+  
+-   [方法: ホストに対して ping を実行](../../../docs/framework/network-programming/how-to-ping-a-host.md)  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [MSDN Code Gallery .NET のネットワーキングのサンプル](http://code.msdn.microsoft.com/Wiki/View.aspx?ProjectName=nclsamples)
\ No newline at end of file
diff --git a/docs/framework/network-programming/network-programming-samples.md b/docs/framework/network-programming/network-programming-samples.md
new file mode 100644
index 00000000000..839944bf44f
--- /dev/null
+++ b/docs/framework/network-programming/network-programming-samples.md
@@ -0,0 +1,80 @@
+---
+title: "ネットワーク プログラミングのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8efacc29-7367-47c2-8638-a4f66385ad91
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# ネットワーク プログラミングのサンプル
+このセクションでは、説明を含み、<xref:System.Net>、<xref:System.Net.Cache>、<xref:System.Net.Configuration>、<xref:System.Net.Mail>、<xref:System.Net.Mime>、<xref:System.Net.NetworkInformation>、<xref:System.Net.PeerToPeer>、<xref:System.Net.Security>、<xref:System.Net.Sockets>および関連の名前空間でクラスを使用するダウンロードできるネットワークのプログラミングのサンプルにリンク。  
+  
+## このセクションの内容  
+ [ダウンロードの進捗状況のインジケータ テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179556)  
+ ファイルのダウンロードの進捗状況を表示する方法を示します。  
+  
+ [クライアントの FTP テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179557)  
+ FTP サーバーに対してファイルをアップロードおよびダウンロードする方法を示します。  
+  
+ [HttpListener テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179558)  
+ 処理中方法をアプリケーションからの HTTP 要求を示します。  
+  
+ [HttpListener の ASPX ホストのアプリケーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=179560)  
+ <xref:System.Net.HttpListener> クラスの機能を ASP.NET のホストされているアプリケーションに電話をルーティング HTTP サーバーの作成に使用する方法を示します。  
+  
+ [メール送信型テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179561)  
+ クライアント アプリケーションから電子メール メッセージを送信する方法を示します。  
+  
+ [NetStat ツール テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179562)  
+ NCLNetStat のネットワーク上の情報のツールを示します。  
+  
+ [ネットワークの情報技術個](http://go.microsoft.com/fwlink/?LinkID=179564)  
+ ネットワークの情報を監視および表示する方法を示します。  
+  
+ [Ping のクライアント テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179565)  
+ リモートをホスト ポーンと音ができるクライアント アプリケーションを示します。  
+  
+ [Web クライアント テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179566)  
+ ファイルまたはデータのアップロードまたはダウンロードなどの共通の操作を行う方法を示します。  
+  
+ [ストリーム個をセキュリティ保護する](http://go.microsoft.com/fwlink/?LinkID=179567)  
+ 安全なストリームをクライアントとサーバー間の通信に使用する方法を示します。  
+  
+ [IPv6 のソケットのサンプル](http://go.microsoft.com/fwlink/?LinkID=179568)  
+ IPv6 を有効にすると、ソケットを使用する方法を示します。  
+  
+ [FTP の自宅の技術サンプルの参照](http://go.microsoft.com/fwlink/?LinkID=179569)  
+ FTP サーバーの内容を一覧方法を示します。  
+  
+ [ソケットのパフォーマンス テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179570)  
+ <xref:System.Net.Sockets.Socket> クラスで高パフォーマンスを改善を実現するために非同期なネットワークの I\/O を使用するアプリケーション サーバーを構築に使用する方法を示します。  
+  
+ [サンプルのピアツーピア技術](http://go.microsoft.com/fwlink/?LinkID=179571)  
+ <xref:System.Net.PeerToPeer> の名前空間で新しいクラスを登録するピアの名前を公開する次にピア名を解決するために使用する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Net>  
+  
+ <xref:System.Net.NetworkInformation>  
+  
+ <xref:System.Net.PeerToPeer>  
+  
+ <xref:System.Net.Sockets>  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [ネットワーク プログラミング方法のトピック](../../../docs/framework/network-programming/network-programming-how-to-topics.md)   
+ [.NET のネットワーキングのサンプル](http://code.msdn.microsoft.com/Wiki/View.aspx?ProjectName=nclsamples)
\ No newline at end of file
diff --git a/docs/framework/network-programming/network-tracing.md b/docs/framework/network-programming/network-tracing.md
new file mode 100644
index 00000000000..8d7d06496d4
--- /dev/null
+++ b/docs/framework/network-programming/network-tracing.md
@@ -0,0 +1,52 @@
+---
+title: ".NET Framework のネットワークのトレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク トラフィックのキャプチャ"
+  - "デバッグ [.NET Framework], ネットワークのトレース"
+  - "配置 (アプリケーションを) [.NET Framework] , ネットワーク トラフィック"
+  - "インターネット, ネットワークのトレース"
+  - "メソッドの呼び出し"
+  - "メソッド, ネットワークのトレース"
+  - "ネットワーク リソース"
+  - "ネットワークのトレース"
+  - "ネットワークのトレース, ネットワークのトレースの概要"
+  - "ネットワーク, ネットワークのトレース"
+  - "ネットワーキング"
+  - "出力, ネットワークのトレース"
+  - "トレースを有効にしたデバッグ"
+  - "トレース [.NET Framework], ネットワーク"
+  - "トラフィックのトレース"
+ms.assetid: e993b7c3-087f-45d8-9c02-9dded936d804
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# .NET Framework のネットワークのトレース
+.NET Framework のネットワークのトレースでは、メソッド呼び出しについての情報、およびマネージ アプリケーションによって生成されるネットワーク トラフィックについての情報にアクセスできます。  この機能は、開発中のアプリケーションのデバッグや、配置済みのアプリケーションの分析に役立ちます。  ネットワークのトレースの出力は、開発時および稼動環境でのさまざまな使用方法をサポートするようにカスタマイズできます。  
+  
+ .NET Framework でのネットワークのトレースを有効にするには、トレースの出力先を選択し、アプリケーションまたはコンピューターの構成ファイルにネットワークのトレースの構成設定を追加する必要があります。  構成ファイルの内容、およびそれらの使用方法については、「[構成ファイル](../../../docs/framework/configure-apps/index.md)」を参照してください。  ネットワークのトレースを有効にする方法については、「[ネットワークのトレースを有効にする](../../../docs/framework/network-programming/enabling-network-tracing.md)」を参照してください。  構成ファイルに追加する必要がある設定については、「[方法: ネットワークのトレースを構成する](../../../docs/framework/network-programming/how-to-configure-network-tracing.md)」を参照してください。  
+  
+ トレースが有効なときは、**System.Net** クラスによって出力されるトレース情報をキャプチャできます。  トレース情報を生成するネットワーク クラスのメンバーについては、.NET Framework クラス ライブラリのドキュメントの「解説」セクションに次のメモが含まれます。  
+  
+> [!NOTE]
+>  このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。  詳細については、「ネットワークのトレース」を参照してください。  
+  
+## 参照  
+ [ネットワークのトレースの有効化](../../../docs/framework/network-programming/enabling-network-tracing.md)   
+ [方法へまたは: ネットワーク追跡をコンフィギュレーションします。](../../../docs/framework/network-programming/how-to-configure-network-tracing.md)   
+ [ネットワークのトレースの解釈](../../../docs/framework/network-programming/interpreting-network-tracing.md)   
+ [Introduction to Instrumentation and Tracing](http://msdn.microsoft.com/ja-jp/e924e57c-33cf-4b0e-9e7f-a45d13e38f2c)
\ No newline at end of file
diff --git a/docs/framework/network-programming/networkinformation.md b/docs/framework/network-programming/networkinformation.md
new file mode 100644
index 00000000000..7bb158948ee
--- /dev/null
+++ b/docs/framework/network-programming/networkinformation.md
@@ -0,0 +1,40 @@
+---
+title: "NetworkInformation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+ms.assetid: 31b44dd3-b903-4a48-8419-40419a3e4038
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# NetworkInformation
+<xref:System.Net.NetworkInformation> の名前空間は、ネットワークのイベント、変更、統計量およびプロパティに関する情報を収集することができます。  また、リモート ホストが <xref:System.Net.NetworkInformation.Ping?displayProperty=fullName> クラスの使用によって到達可能にするかどうかを決定できます。  
+  
+## ネットワークの使用可能性とイベント  
+ <xref:System.Net.NetworkInformation.NetworkChange?displayProperty=fullName> クラスは、ネットワーク アドレスまたは状態が変更されたかどうかを決定することができます。  このクラスを使用するには、変更を処理するようにイベント ハンドラーを作成および <xref:System.Net.NetworkInformation.NetworkAddressChangedEventHandler> または <xref:System.Net.NetworkInformation.NetworkAvailabilityChangedEventHandler>としてを関連付けます。  詳細については、「[方法: ネットワークの可用性とアドレスの変更を検出する](../../../docs/framework/network-programming/how-to-detect-network-availability-and-address-changes.md)」を参照してください。  
+  
+## ネットワークの統計量およびプロパティ  
+ インターフェイスまたはプロトコル基準のネットワーク統計量およびプロパティを集計できます。  <xref:System.Net.NetworkInformation.IPInterfaceProperties>、<xref:System.Net.NetworkInformation.IPGlobalProperties>、<xref:System.Net.NetworkInformation.IPGlobalStatistics>、<xref:System.Net.NetworkInformation.TcpStatistics>と <xref:System.Net.NetworkInformation.UdpStatistics> クラスは、レイヤー 3 と 4 のレイヤ パケットに関する情報を提供するが、<xref:System.Net.NetworkInformation.NetworkInterface>、<xref:System.Net.NetworkInformation.NetworkInterfaceType>と <xref:System.Net.NetworkInformation.PhysicalAddress> クラスは、特定のネットワークのインターフェイスに関する情報が表示されます。  詳細については、「[方法: インターフェイス情報とプロトコル情報を取得する](../../../docs/framework/network-programming/how-to-get-interface-and-protocol-information.md)」を参照してください。  
+  
+## リモート ホストが到達可能にするかどうかを決定します  
+ リモートが、ネットワーク ホストは、到達高くなる可能かどうかを判断するために <xref:System.Net.NetworkInformation.Ping> クラスを使用できます。  詳細については、「[方法: ホストに対して ping を実行](../../../docs/framework/network-programming/how-to-ping-a-host.md)」を参照してください。  
+  
+## 参照  
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [ネットワークの情報技術個](http://go.microsoft.com/fwlink/?LinkID=179564)   
+ [NetStat ツール テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179562)   
+ [Ping のクライアント テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179565)
\ No newline at end of file
diff --git a/docs/framework/network-programming/ntlm-and-kerberos-authentication.md b/docs/framework/network-programming/ntlm-and-kerberos-authentication.md
new file mode 100644
index 00000000000..005faba7d25
--- /dev/null
+++ b/docs/framework/network-programming/ntlm-and-kerberos-authentication.md
@@ -0,0 +1,74 @@
+---
+title: "NTLM 認証および Kerberos 認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "認証 [.NET Framework]、NTLM"
+  - "認証 [.NET Framework]、Kerberos"
+  - "ユーザー認証、Kerberos"
+  - "ユーザー認証、NTLM"
+  - "Kerberos 認証"
+  - "受信 (データの)、認証"
+  - "NTLM 認証"
+  - "インターネット、認証"
+  - "クライアント認証、Kerberos"
+  - "送信 (データの)、認証"
+  - "ネットワーク リソース、認証"
+  - "クラス [.NET Framework]、認証"
+  - "クライアント認証、NTLM"
+ms.assetid: 9ef65560-f596-4469-bcce-f4d5407b55cd
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# NTLM 認証および Kerberos 認証
+既定の NTLM 認証および認証を Kerberos サーバーと認証との間のアプリケーションに関連付けられている Microsoft Windows NT のユーザーの資格情報を使用します。  既定以外 NTLM 認証を使用すると、アプリケーションには NTLM 認証の型を設定し、次の例で示すようにホストにユーザー名、パスワード、およびドメインを渡すために <xref:System.Net.NetworkCredential> のオブジェクトを使用します。  
+  
+```vb  
+Dim MyURI As String = "http://www.contoso.com/"  
+Dim WReq As WebRequest = WebRequest.Create(MyURI)  
+WReq.Credentials = _  
+    New NetworkCredential(UserName, SecurelyStoredPassword, Domain)  
+```  
+  
+```csharp  
+String MyURI = "http://www.contoso.com/";  
+WebRequest WReq = WebRequest.Create (MyURI);  
+WReq.Credentials =   
+    new NetworkCredential(UserName, SecurelyStoredPassword, Domain);  
+```  
+  
+ アプリケーションのユーザーの資格情報を使用してインターネット サービスに接続する必要があるアプリケーションは、次の例で示すように、ユーザーの既定の資格情報を、実行できます。  
+  
+```vb  
+Dim MyURI As String = "http://www.contoso.com/"  
+Dim WReq As WebRequest = WebRequest.Create(MyURI)  
+WReq.Credentials = CredentialCache.DefaultCredentials  
+```  
+  
+```csharp  
+String MyURI = "http://www.contoso.com/";  
+WebRequest WReq = WebRequest.Create (MyURI);  
+WReq.Credentials = CredentialCache.DefaultCredentials;  
+```  
+  
+ 交渉認証のモジュールがリモート サーバーが NTLM または Kerberos 認証を使用する確認し、適切な応答かどうかを送信します。  
+  
+> [!NOTE]
+>  NTLM 認証がプロキシ サーバーを使用して。  
+  
+## 参照  
+ [基本認証とダイジェスト認証](../../../docs/framework/network-programming/basic-and-digest-authentication.md)   
+ [インターネット認証](../../../docs/framework/network-programming/internet-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/peer-name-publication-and-resolution.md b/docs/framework/network-programming/peer-name-publication-and-resolution.md
new file mode 100644
index 00000000000..9a79390eddf
--- /dev/null
+++ b/docs/framework/network-programming/peer-name-publication-and-resolution.md
@@ -0,0 +1,58 @@
+---
+title: "ピア名の公開と解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f0370e08-9fa6-4ee5-ab78-9a58a20a7da2
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# ピア名の公開と解決
+## ピアの名前を公開します  
+ に新しい PNRP ID を公開するには、ピアは以下を実行します:  
+  
+-   キャッシュの下位レベルの PNRP ID を登録したキャッシュの隣人 \(ピア\) に PNRP 書のメッセージをキャッシュの播くために送信されます。  
+  
+-   隣人ではない選択し、それらに独自の P2P ID の名前 PNRP の決済の要求を送信しますクラウドのノードをオプション  結果のエンドポイントを決定するプロセスは未処理の PNRP ピアの ID クラウドのノードのキャッシュ オプションを播きます。  
+  
+ PNRP のバージョン 2 ノードは、他の P2P ID だけを決済する PNRP ID を公開されません。  ピアの名前に対してのみ決済 PNRP を使用することをソフトウェア HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\PeerNet\\PNRP\\IPV6\-Global\\SearchOnly\=1 レジストリの値 \(REG\_DWORD 型\) が書の場合、名前は指定されません。  この値は、レジストリのグループ ポリシーによってコンフィギュレーションできます。  
+  
+## ピアの名前の決済  
+ PNRP のネットワークまたはクラウドの他のピアを検索するには 2 のフェーズで構成されるプロセスです:  
+  
+1.  エンドポイントの決定  
+  
+2.  PNRP ID の決済  
+  
+ エンドポイントの決定フェーズで、決済しようとしているピアは別のコンピュータ上のサービスの PNRP ID、そのピアの IPv6 の住所が決まります。  ピアは、公開した場合は、コンピュータの PNRP ID またはサービス関連付けられます 1 Z。  
+  
+ リモート エンドポイントが PNRP のクラウドに登録されたことを確認した後で、PNRP ID の決済のフェーズのピアが必要なサービスの PNRP ID にそのピアのエンドポイントに要求を送信します。  エンドポイントが需要ピアで計画の通信に使用できる他の情報のサービス、コメント、4 個の KB の PNRP ID を確認する返信を送信します。  たとえば、目的のエンドポイントが賭博サーバーの場合、追加のピアの名前のレコードのデータはゲームに関する情報、演劇のレベル、およびプレーヤーごと\) を含めることができます。  
+  
+ エンドポイントの決定フェーズで、PNRP は、決済を実行するノードがターゲットの PNRP ID に直近の引き続いてあるノードに連絡する責任を負う PNRP ID を公開するノードを検索するための反復するプロセスを使用します  
+  
+ に PNRP 名前で決済を実行するには、ピア、ターゲットの PNRP ID と一致するエントリに関する独自のキャッシュのエントリを確認します  検索する場合は、ピア ピアに PNRP の要求メッセージを送信し、応答を待機しています。  PNRP ID のエントリがない場合、ピアは、とターゲットの PNRP ID に一致する PNRP ID を持つエントリに対応するピアに PNRP の要求メッセージを送信します  PNRP の要求メッセージを受信するノードは独自のキャッシュを確認し、次の手順に従います。:  
+  
+-   PNRP ID が含まれる場合、要求のピアに要求されたエンドポイントのピアの返信直接。  
+  
+-   PNRP ID がない場合は、キャッシュ PNRP の ID がターゲットの PNRP ID に直近の場合、要求されたピアはようにターゲットの PNRP ID と一致していること PNRP ID を持つエントリを表すピアの IPv6 の住所を含む要求のピアへの応答を送信します  応答やキャッシュを調べる IPv6 の住所に対する応答の IP アドレスを使用して、要求のノードの送信別の PNRP の要求メッセージ。  
+  
+-   PNRP ID がなく、ターゲットの PNRP ID の日付にキャッシュに PNRP ID がない場合は、要求されたピアが需要ピアにこの要件を示す応答を送信します。  要求のピアは、最も近い次 PNRP ID を選択します。  
+  
+ 要求のピアは、最終的 PNRP ID を登録したノードを探す連続する繰り返しで、このプロセスを続行します  
+  
+ <xref:System.Net.PeerToPeer> の名前空間の中で、通信エンドポイントと PNRP のクラウドまたはメッシュ含む <xref:System.Net.PeerToPeer.PeerName> 複数のレコード間関係に対して複数があります。  ピアの同じ名前で重複するエントリ古いか、または複数のノードがある場合、PNRP ノードは <xref:System.Net.PeerToPeer.PeerNameResolver> クラスを使用して、現在の情報を得ることができます。  <xref:System.Net.PeerToPeer.PeerNameResolver> 方法は、多くのクラウドに 1 種類のピア多くのピアの名前のレコードと同じ 1 のピアに分析視点を簡略化するために一つのピア名を使用します。  これは、関係テーブルの組み合わせを使用して実行されるクエリに似ています。  正常に完了すると、リゾルバーの指定はピア オブジェクト名の <xref:System.Net.PeerToPeer.PeerNameRecordCollection> を返します。  たとえば、ピアの名前はクラウドによって注文済の回収すべてのピアの名前のレコードに見られます。  これらは、サポート データが PNRP ベースのアプリケーションによって要求する場合があるピアの名前のインスタンスです。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer>
\ No newline at end of file
diff --git a/docs/framework/network-programming/peer-name-resolution-protocol.md b/docs/framework/network-programming/peer-name-resolution-protocol.md
new file mode 100644
index 00000000000..0ebbd622f77
--- /dev/null
+++ b/docs/framework/network-programming/peer-name-resolution-protocol.md
@@ -0,0 +1,63 @@
+---
+title: "Peer Name Resolution Protocol | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 11940511-c124-4d91-ae31-d4ed6e81ee58
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# Peer Name Resolution Protocol
+ID の名前またはそのほかの型のそれぞれのネットワーク上の場所 \(アドレスとポート、プロトコル\) を決済するピアツーピア環境ピアの使用、特定の名前の決済システム。  ピア以前の名前解決策は、ドメイン ネーム システム内の一時本来 \(DNS\) 接続、他の短所が複雑になります。  
+  
+ Microsoft® Windows® のピアツーピア ネットワーキングのプラットフォーム ピア決済 Protocol \(PNRP\) 名は、最初に Windows XP に対して作成され、Windows Vista の™で更新される安全で、スケーラブル、動的名前の登録と名前決済のプロトコルこの問題を解決します。  PNRP の作業アプリケーション開発者向けの還付の新しい可能性を作成する従来の名前の決済システムと非常別々に。  
+  
+ PNRP を使用すると、ピアの名前は、機械の機械、または個々のアプリケーションまたはサービス適用できます。  ピア決済の名前、住所、ポートに公開拡張積荷が含まれます。  このシステムのメリットは、フォールト トレランス、その古い住所を戻さないボトルネックと名前が含まれません;決済 プロトコル携帯電話にユーザーを検索する優秀な解決策をします。  
+  
+ セキュリティの点で、ピアの名前は保護された \(protected\) または保証のない公開できます \(unprotected\)。  PNRP はからかうに対して安全なピアの名前を保護するために公開キーを使用してインターネット; コンピューターとサービスは、PNRP と名前を付けることができます。  
+  
+-   ピア名決済プロトコルは、次のプロパティを表示します:  
+  
+-   配分するとほとんど完全に serverless。  サーバーはブートストラップ プロセスに限られます。  
+  
+-   サード パーティの介入なしに、名前書をセキュリティ保護します。  DNS 名書とは異なり、PNRP の名前は、当座書と財務の原価を伴わないです。  
+  
+-   古い住所の決済されないリアルタイムの PNRP の更新。  
+  
+-   PNRP での名前の解決策は、コンピュータ以外に、サービスの名前決済を許可して、拡張。  
+  
+## System.Net.PeerToPeer の名前空間  
+  
+-   PNRP 機能は、.NET Framework Version 3.5 内の <xref:System.Net.PeerToPeer> の名前空間によって定義されます。  これは、使用可能な PNRP のサービスを使用するピアの名前を登録し、解決するために使用できる一連の型を提供します。  
+  
+-   \(PNRP と注文のピアのリゾルバーは <xref:System.ServiceModel.PeerResolvers> の名前空間に表示される型を使用して作成され、インスタンスを作成できます\)。  
+  
+-   次のように使用可能な PNRP のサービスを使用する名前を登録し、決済する基本的なタイプがあります:  
+  
+-   :<xref:System.Net.PeerToPeer.Cloud>範囲など、使用可能な PNRP のクラウドを表す情報を定義します。  
+  
+-   :<xref:System.Net.PeerToPeer.PeerName>クラウド内のピアを登録し、その後解決するために使用できるピアの名前を定義します。  
+  
+-   :<xref:System.Net.PeerToPeer.PeerNameRecord>ピアが連絡できるネットワーク エンドポイントを含む、ピアの登録情報を含む PNRP のクラウド レコードを定義します。  
+  
+-   :<xref:System.Net.PeerToPeer.PeerNameRegistration>方法を含むピア名の登録プロセスを、ピアの名前の登録を開始および停止するに定義します。  
+  
+-   :<xref:System.Net.PeerToPeer.PeerNameResolver>決済の同期、非同期な方法をエンドポイントに含めるネットワーク ピア名を解決するためのプロセスを定義します。  
+  
+## 参照  
+ <xref:System.ServiceModel.PeerResolvers>   
+ <xref:System.Net.PeerToPeer>   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [サンプルのピアツーピア技術](http://go.microsoft.com/fwlink/?LinkID=179571)
\ No newline at end of file
diff --git a/docs/framework/network-programming/peer-names-and-pnrp-ids.md b/docs/framework/network-programming/peer-names-and-pnrp-ids.md
new file mode 100644
index 00000000000..646cc393243
--- /dev/null
+++ b/docs/framework/network-programming/peer-names-and-pnrp-ids.md
@@ -0,0 +1,45 @@
+---
+title: "ピア名と PNRP ID | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: afa538e8-948f-4a98-aa9f-305134004115
+caps.latest.revision: 5
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 5
+---
+# ピア名と PNRP ID
+ピアの名前は、コンピュータ、ユーザー グループ、サービス、または IPv6 の住所に決済できるピアに関連付けられているあらゆるものになる場合がある通信のエンドポイントを表します。  ピア決済 Protocol \(PNRP\) 名はクラウドのメンバを識別するために使用される PNRP ID の作成の統計的に固有ピアの名前を取得します。  
+  
+## ピアの名前  
+ ピアの名前は、それらのないとして登録されているまたは保証することができます。  保証の名前はないユーザーが重複しない保証の名前を登録できるため、からかうになる、文字列で。  保証のない名前は、プライベートまたは別の方法で保護されたネットワークで保持されます。  保護された名前は証明書およびデジタル署名と保護されます。  元の発行元のみ保護された名前の所有権を証明できます。  
+  
+ クラウドおよび範囲の組み合わせが PNRP 活動を入力するピアに妥当に安全な環境を提供します。  ただし、保護されたピアの名前を使用してネットワーキング アプリケーションの全体的なセキュリティはありません。  アプリケーションのセキュリティは実装に依存します。  
+  
+ 保護されたピアの名前が所有者だけが登録され、公開キーとインターネット保護されます。  ピアの保護された名前に対応するデータ キーを持つピア エンティティによって所有していたと見なされます。  会社データは、コンフィギュレーション キーを使用して署名する認定ピアの住所 \(CPA\) が証明することができます。  悪意のあるユーザーが対応するデータなしでピア キーの名前の所有権を作成することはできません。  
+  
+## PNRP ID  
+ ![PNRP ID](../../../docs/framework/network-programming/media/fdc9e8a0-4a1c-488d-a019-bc3a1973220c.png "fdc9e8a0\-4a1c\-488d\-a019\-bc3a1973220c")  
+  
+ PNRP ID が次に構成されます:  
+  
+-   ピアツーピア \(P2P\) ID として知られる高位 128 ビットのコードは、エンドポイントに割り当てられたピアの名前のハッシュです。  ピアの名前は、次の形式があります: *Authority.Classifier*.  保護された名前に、*権限は* 16 桁数な文字 \(ピアの名前の公開キーの安全なアルゴリズム ハッシュ 1 \(SHA1 ハッシュ\) です。  保証のない名前に、*権限は* 一つの文字「0 "です。  *分類子。* アプリケーションを識別する文字列で。  ピアの名前の分類子。`null` のターミネーターを含む 149 文字以下で超えることはできません。  
+  
+-   最低位 128 ビットのコードが同じクラウドの同じ P2P ID の異なるインスタンスを識別する生成された番号であるサービスの場所に使用されます。  
+  
+ P2P ID およびサービスの場所のこの組み合わせは複数の PNRP ID が単一のコンピュータから登録されます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer.PeerName>   
+ <xref:System.Net.PeerToPeer>
\ No newline at end of file
diff --git a/docs/framework/network-programming/peer-to-peer-collaboration.md b/docs/framework/network-programming/peer-to-peer-collaboration.md
new file mode 100644
index 00000000000..e085bc951fa
--- /dev/null
+++ b/docs/framework/network-programming/peer-to-peer-collaboration.md
@@ -0,0 +1,51 @@
+---
+title: "ピアツーピア コラボレーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b6216d88-bccb-4a59-9f1c-9f751708e811
+caps.latest.revision: 7
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 7
+---
+# ピアツーピア コラボレーション
+ピアツーピアにはネットワーキングにより、クライアント ベースの計算タスクのインターネット末に存在する比較的強力なコンピュータ \(パーソナル コンピュータ\) の使用になります。  現代パーソナル コンピュータ \(PC\) に非常に迅速に、プロセッサ広大なメモリ、なし、電子メールおよび Web 参照のような十分に共通タスクの計算を行う場合に使用されていない、ハード ディスクがあります。  現代 PC は、アプリケーションのさまざまなタイプのクライアントとサーバー \(ピア両方\) として簡単に処理できます。  
+  
+-   コラボレーション ピアツーピアの下部組織は、Windows Vista、後でプラットフォームの近くのユーザーの接続サービスを活用する Microsoft Windows ピアツーピア下部組織の実装簡単です。  これは、直近のユーザーの接続のサービスを行っているサブネット ピア内の有効なアプリケーションに最もよくインターネットのエンドポイントまたはサービス取引連絡先もできますが、使用されます。  これは、取引相手のエンドポイント、状態やプレゼンスを決定する Live Messenger などの稼働中で認識のアプリケーションで使用される共通の連絡先マネージャを取り入れています。  
+  
+## コラボレーションのアプリケーション  
+ 一般的なピアツーピア コラボレーションのアプリケーションは次の手順で構成されます:  
+  
+-   ピアは、コラボレーション セッションをホストに関心を持ってピア ID が決まります  
+  
+-   セッションをホスト要求は、どうかに送信され、ホストのピアは、コラボレーション活動を管理することに合意します。  
+  
+-   ホストはセッションにサブネットの取引連絡先 \(要求を含む元\) 招待します。  
+  
+-   協力するすべてのピアはその連絡先を追加またはマネージャでホストがあります。  
+  
+-   ピア、ほとんどのホストのピアに、承認、または適時に指定するかどうかという案内の応答を送信します。  
+  
+-   協力するすべてのピアがホストのピアに所属します。  
+  
+-   ピアが自分の最初のコラボレーション活動を実行すると、ホスト ピア、連絡先のマネージャに、ピアを追加するかがあります。  また、償却する応答、およびユーザーが承認するかを決定するすべての招待状の応答を処理します。  これは破棄応答、またはそのほかの活動を場合があります担当者にという案内を実行します。  
+  
+-   この時点で、ホストのピアは、すべての招待されたピアのコラボレーションのセッションを開始したり、コラボレーションの下部組織とアプリケーションを登録します。  P2P のアプリケーションはピアツーピア コラボレーションの下部組織と、ゲーム掲示板、協議などの serverless プレゼンスのアプリケーションの通信を調整するに <xref:System.Net.PeerToPeer.Collaboration> の名前空間を使用します。  
+  
+## ピアツーピア ネットワーキングのセキュリティ  
+ Active Directory ドメインで、ドメイン コントローラは Kerberos を使用して認証サービスを提供します。  serverless ピア環境では、ピアは独自の認証を指定する必要があります。  ピアツーピア ネットワーキングの場合、そのノードが各ピアの信頼済ルートの店舗のルート CA 証明書の条件を削除として機能します。  認証証明書は X.509 として書式設定された証明書を使用して署名して入力されます。  これらは公開キー\/秘密キーの組み合わせとデータ キーを使用して署名する証明書の生成、各ピアによって作成された証明書です。  株主証明書署名が認証にピア エンティティに関する情報を提供するために使用されます。  X.509 認証と同様に、ピアのネットワーキング認証は信頼された公開キーには追跡証明書のグループに基づきます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer.Collaboration>   
+ [System.Net.PeerToPeer.Collaboration 名前空間について](../../../docs/framework/network-programming/about-the-system-net-peertopeer-collaboration-namespace.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/peer-to-peer-networking-scenarios.md b/docs/framework/network-programming/peer-to-peer-networking-scenarios.md
new file mode 100644
index 00000000000..4de1eb4d952
--- /dev/null
+++ b/docs/framework/network-programming/peer-to-peer-networking-scenarios.md
@@ -0,0 +1,74 @@
+---
+title: "ピアツーピア ネットワーキング シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d23b1a64-2e08-4014-882a-c1dd766bdcc2
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# ピアツーピア ネットワーキング シナリオ
+ピアツーピア ネットワーキングは次のシナリオを有効または強化します:  
+  
+## 実際の時間通信 \(RTC\)  
+  
+-   Serverless のインスタント メッセージ  
+  
+ RTC は今日あります。  コンピュータのユーザーが自分のピアとの声またはビデオの通話内容を今日関するチャット、使用できます。  ただし、既存の更新、および通信プロトコルの多くはサーバーに機能するように基づきます。  アド ホックなワイヤレス ネットワークに参加したり、個別されたネットワークの一部である場合は、これらの RTC の機能を使用することはできません。  ピアツーピア テクノロジでは、これらの追加ネットワーキング環境に RTC テクノロジの拡張子ができます。  
+  
+-   実際の時間マッチメークと gameplay  
+  
+ RTC に似ています、実際の時間ゲームの演劇は今日あります。  インターネットによって賭博コミュニティに食料調達する多くの Web ベースのゲーム サービスの拠点があります。  これらは、同じな利息の他のゲーマーを検索し、ゲームを一緒にする機能を提供します。  問題ゲーム サービスの拠点は、インターネットにのみ、世界の最適なゲーマーと対戦する専用ゲーマーへの自動にすることです。  これらのサービスが拠点プロセスで役立つように統計量を追跡および表示します。  ただし、これらのサービス ゲーマーが拠点はさまざまなネットワーキング環境の間の友だちアド ホックなゲームを設定するすることはできません。  ピアツーピア ネットワーキングは、この機能を提供できます。  
+  
+## コラボレーション  
+  
+-   目標を決済するプロジェクトのワークスペース  
+  
+ 共有ワークスペース アプリケーションはアド ホックなワークグループの作成を使用すると、ワークグループの所有者がグループが問題を解決できるツールを使用して共有ワークスペースを設定して使用することができます。  これは伝言板、生産性のツールおよびファイルを含めることができます。  
+  
+-   他にファイルを共有できます。  
+  
+ プロジェクトのワークスペースの共有のサブセットはファイルを共有する機能です。  この能力は、Windows の現在のバージョンと今日があるファイルに簡単に、友好的な方法でコンテンツ使用できるようにするには、ピアツーピア ネットワーキングを通じて高めることができます。  インターネットまたはアド ホックには、環境の終了の内容の信じられないい財産に簡単なアクセス権を付与するにはネットワークの計算値を乗算されます。  
+  
+-   経験の比率  
+  
+ 無線接続にすると、一般的なする、ピアツーピア ネットワーキングになると、実行中に、経験を共有ピアのグループであり、オンラインすることができます \(日没、ロックのコンサート、または休暇の巡航\)。  
+  
+## コンテンツ配分  
+  
+-   メッセージ テキスト  
+  
+ ピアツーピア ネットワーキングは、ユーザーに大きなグループに形式でファイルやメッセージのテキストに基づく情報の散布ようにすることができます。  たとえば、ニュースの一覧です。  
+  
+-   オーディオ\/ビデオ  
+  
+ ピアツーピア ネットワーキングも大きいコンサートまたは会社の会議など、ユーザーに大きなグループにオーディオまたはビデオな情報の散布は、を有効にできます。  今日に内容を配分するには、大容量のサーバーを何百ものユーザーまたはロットの負荷を収集して配布するようにコンフィギュレーションする必要があります。  ピアツーピア ネットワーキングによって、いくつかのピアのみ集中化されたサーバーから実際に内容が表示されます。  これらのピアが他にメッセージを送信いくつかの詳細にユーザーにこの情報は、などあふれます。  コンテンツの配布の負荷はクラウドのピアに配分されます。  検索する最も近い配送のピアを内容を受け取るコンテンツを取得し、ピアは、から。  
+  
+-   プロダクト更新の配分  
+  
+ ピアツーピア ネットワーキングは、プロダクト更新などのソフトウェアを配分する有効を提供できます \(セキュリティ メカニズムの更新やサービス パック\)。  ソフトウェアの配信サーバーへの接続があるピアは、製品更新を取得し、グループのそのほかのメンバに反映できます。  
+  
+## 配分処理  
+  
+-   タスクの区分と配布  
+  
+ 大規模な計算タスクはピアの計算のリソースにうってつけ別の小さい計算タスクに最初に分割できます。  ピアには、計算タスクの分割できます。  その後、ピアツーピア ネットワーキングは、グループ内の別のピアに個別のタスクを配分できます。  各ピアは計算タスクを実行し、集中累計ポイントに、結果を報告します。  
+  
+-   コンピュータ リソースの集計  
+  
+ 配分処理のためにピアツーピア ネットワーキングを使用するもう一つの方法は、アイドル\) プロセッサ時間内に各ピアのプログラムを実行すると、中央サーバーによって調整されたより大きい計算タスクの一部です。  複数のコンピュータ プロセッサの集計によって、ピアツーピア ネットワーキングには、計算タスクの大きい並行処理にピアのコンピュータ グループを回転させることができます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer.Collaboration>
\ No newline at end of file
diff --git a/docs/framework/network-programming/pnrp-caches.md b/docs/framework/network-programming/pnrp-caches.md
new file mode 100644
index 00000000000..a8c2f74104a
--- /dev/null
+++ b/docs/framework/network-programming/pnrp-caches.md
@@ -0,0 +1,49 @@
+---
+title: "PNRP キャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 270068d9-1b6b-4eb9-9e14-e02326bb88df
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# PNRP キャッシュ
+ピア名決済 Protocol \(PNRP\) のキャッシュがピアで管理するアルゴリズムに選択したピアのエンドポイントの郷土があります。  
+  
+## PNRP のキャッシュの初期設定  
+ ピア ノードの起動時に PNRP のキャッシュ、またはピアの名前のレコードのコレクションを初期化するには、ノードは次の方法を使用できます:  
+  
+-   ノードが締まったとしていた耐久性があるキャッシュのエントリはハード ディスク磁気ディスクでから読み込まれます。  
+  
+-   アプリケーションで P2P のコラボレーションの下部組織を使用すると、コラボレーションの情報は、そのノードの連絡先マネージャで使用できます。  
+  
+## 複数レベルの名前とキャッシュ ピアの決済を縮小増幅されます。  
+ PNRP キャッシュのサイズを下回って維持するために、ピア ノードは各レベルがエントリの最大数を含む複数レベルのキャッシュを使用します。  キャッシュの各レベルは PNRP ID 番号を選択 \(2\) <sup>256</sup>の 10 分の 1 番の小さい区分を表します。  この番号値上の近くにあるキャッシュの下位レベルはローカルに登録された PNRP ID、および他の PNRP ID が表示されます。  キャッシュのレベルが最大 20 のエントリと注文と、新しい下位レベルが作成されます。  キャッシュの最大レベル数はログ10 \(クラウドの PNRP ID の合計\) オーダーにあります。  たとえば、100， 000,000 PNRP ID のグローバルなクラウドについて、8 以上ではありません \=log10 \(\(100,000,000\)\) キャッシュ ホップの名前と決済時に PNRP ID を決済するような数のレベル。  このメカニズムはオプション PNRP ID が最も近いピア次に PNRP の要求メッセージを設定しますによって対応する CPA のピアが検索される解決できる配送されるハッシュ テーブルができます。  
+  
+ ノードは、キャッシュの最下位レベルにエントリを追加するたびに決済を完了できるようにするには、キャッシュの最後のレベル内のすべてのノードへの入力に転送にあふれます。  
+  
+ キャッシュのエントリはしだいに更新します。  キャッシュから古いのエントリをキャッシュします。  結果は、PNRP ID の配送されるハッシュ テーブルが有効なエンドポイントに基づくことです住所レコードと DNS プロトコルがアドレスに関連付けられているノードがネットワークに積極的にあるという保証を提供していない DNS とは異なり。  
+  
+## 他の PNRP のキャッシュ  
+ 別の耐久性があるデータの店舗はローカル キャッシュです。  PNRP 活動に必要なそのほかのオブジェクトに加えて、クラウドのすべてのメンバの間で必ず発行と同期 PNRP のクラウドまたはコラボレーション セッションに関連付けられているレコードが含まれる場合があります。  この重複した店舗は、すべてのグループ メンバに対して同じ必要があるグループのデータのビューを表します。  正確には、スケジュールされたこれらのオブジェクト、レコードはなく、ローカル キャッシュのアプリケーション プレゼンス、およびデータ オブジェクトです。  PNRP のクラウドの使用は、コラボレーションのセッションまたは PNRP のクラウドのすべてのノードへのオブジェクトががたようにします。  クラウドのメンバ間のレコードをレプリケーションは、データの整合性を提供するに SSL を使用します。  
+  
+ ピアがクラウドを入力すると、自動的にローカル キャッシュのデータを関連付けるホストのピア受け取りません; また、ホストのピア オブジェクトと、アプリケーションにプレゼンス データの更新を表示するに所属する必要があります。  初期同期後は、ピアは、定期的にすべてのグループ メンバに一貫して同じビューがあることを確認するために重複した店舗を再同期します。  コラボレーションのセッション内のコラボレーションのセッションまたはアプリケーションでは、同じ機能を実行することがあります。  
+  
+ コラボレーションのセッションがクラウドに入ると、アプリケーションはピアを登録し、セキュリティを使用してその情報がクラウドの範囲で定義した未処理を開始します。  ピアがクラウドを入力すると、クラウドのセキュリティ メカニズムは、に参加するよう範囲を与えるピアに適用されます。  そのレコードはクラウドの範囲内に必ず公開できます。  クラウドの範囲がコラボレーションのアプリケーション範囲とは異なるはない可能性があることに注意してください。  
+  
+ ピアそのほかのピアのオブジェクトの入荷利息を登録できます。  オブジェクトが更新されると、コラボレーションのアプリケーションは通知、新しいオブジェクトは、アプリケーションのすべてのサブスクライバーに渡されます。  たとえば、グループに関するチャットのアプリケーションのピアは、アプリケーション データとして、すべてのレコードに関するチャットを送信するアプリケーションの情報の入荷利息を登録できます。  これは、クラウド チャット内の活動を監視することができます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer>
\ No newline at end of file
diff --git a/docs/framework/network-programming/pnrp-clouds.md b/docs/framework/network-programming/pnrp-clouds.md
new file mode 100644
index 00000000000..fe09f70aa9a
--- /dev/null
+++ b/docs/framework/network-programming/pnrp-clouds.md
@@ -0,0 +1,46 @@
+---
+title: "PNRP クラウド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a82e2bf1-62ab-4c2d-83f3-3217a6aead2e
+caps.latest.revision: 4
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 4
+---
+# PNRP クラウド
+PNRP 「」クラウドは、ネットワークを通じて互いに通信できる一連のノードを表します。  " 「クラウド ピア メッシュ」および「」ピアツーピア グラフとは」、「同義です。  
+  
+ ノード間の通信は、異なるクラウドにまたがって行うことはできません。  <xref:System.Net.PeerToPeer.Cloud> インスタンスは、大文字と小文字が区別される名前によって一意に識別されます。  1 つのピアまたはノードを、複数のクラウドに割り当てることができます。  
+  
+ クラウドは、ネットワーク インターフェイスと密接な関係があります。  別々のサブネットにアタッチされた 2 枚のネットワーク カードを搭載しているマルチホーム コンピューターでは、3 つのクラウドが返されます。インターフェイスごとの各リンクローカル アドレスに対して 1 つずつのクラウドと、1 つのグローバル スコープ クラウドです。  
+  
+ PNRP の使用は 3 範囲は互いに検索できるコンピュータ グループ範囲にある「」を曇らせます:  
+  
+-   グローバルなクラウドは、グローバルな IPv6 の住所の範囲とグローバル アドレスに対応し、全体の IPv6 のインターネットすべてのコンピュータを表します。  単一のグローバルなクラウドだけです。  
+  
+-   ローカルのリンク クラウド リンクはローカルの IPv6 の住所の範囲とリンク ローカルの住所に対応します。  ローカルのリンク クラウドは、ローカルに関連付けられているサブネットとして通常同じである特定のリンクではです。  複数のローカルのリンク クラウドがあります。  
+  
+ 3 番目のクラウド、サービス拠点特定のクラウドは、サービスの拠点 IPv6 の住所の範囲とサービス拠点ローカルの住所に対応します。  このクラウドは、PNRP でサポートされているが、非難されています。  
+  
+## クラウド  
+ PNRP のクラウドは <xref:System.Net.PeerToPeer.Cloud> クラスのインスタンスで表されます。  クラウド グループは <xref:System.Net.PeerToPeer.CloudCollection> の enumerable クラスのインスタンスを表しますピアを使用します。  期限内なピアにわかる <xref:System.Net.PeerToPeer.Cloud.GetAvailableClouds%2A> の静的な方法を呼び出し、PNRP のクラウドの集合取得できます。  
+  
+ 個々のクラウドに 256 文字は Unicode の文字列として表示される一意の名前があります。  これらの名前は、前の範囲とともに、クラウド クラスの固有インスタンスの製造に使用されます。  キューブのインスタンスは耐久性がある使用する XML され、再構築することができます。  
+  
+ 一度クラウドのインスタンスが作成されます既知のピアのメッシュを作成する場合は、または派生、ピアの名前は、に登録できます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer.Cloud>   
+ [Peer Name Resolution Protocol](../../../docs/framework/network-programming/peer-name-resolution-protocol.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/pnrp-in-application-development.md b/docs/framework/network-programming/pnrp-in-application-development.md
new file mode 100644
index 00000000000..719cb2b72fc
--- /dev/null
+++ b/docs/framework/network-programming/pnrp-in-application-development.md
@@ -0,0 +1,33 @@
+---
+title: "アプリケーション開発での PNRP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 265615d6-4423-4b5d-8626-752e456f4f4e
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# アプリケーション開発での PNRP
+Windows Vista では、ネットワーキング アプリケーションは、単純 PNRP のアプリケーション プログラミング インターフェイス \(API\) を使用して名前の書と決済機能にアクセスできます。  
+  
+## ピア名決済プロトコルの実行  
+ 簡単 PNRP API によって名前と住所を登録するには、クラウド明示的に指定されて; PNRP のコンポーネントが入力するに自動的に適切なクラウドとクラウド内の公開への住所が決まります。  
+  
+ Windows Vista の非常に簡単 PNRP 決済の名前については、PNRP の名前は getaddrinfo\(\) Windows ソケット機能に、連結されます。  IPv6 の住所に名前を決済するに PNRP を使用するには、アプリケーションは完全修飾ドメイン名 name.prnp \(FQDN\) を決済するには getaddrinfo\(\) 機能を使用できます。  名前が解決されるピア名である正味。  pnrp。  正味ドメインの名前は PNRP 決済の Windows Vista の引当ドメインです。  
+  
+ ピアツーピア アプリケーション間のメッセージ パッシングは、PeerChannel、WCF [大規模なデータおよびストリーミング](http://go.microsoft.com/fwlink/?LinkID=179652)などの基になるアーキテクチャによって行われます。  
+  
+## 参照  
+ <xref:System.Net.PeerToPeer>
\ No newline at end of file
diff --git a/docs/framework/network-programming/programming-pluggable-protocols.md b/docs/framework/network-programming/programming-pluggable-protocols.md
new file mode 100644
index 00000000000..d0fdf651e78
--- /dev/null
+++ b/docs/framework/network-programming/programming-pluggable-protocols.md
@@ -0,0 +1,48 @@
+---
+title: "プラグ可能なプロトコルのプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダウンロード (インターネット リソースの)、プラグ可能なプロトコル"
+  - "WebRequest クラス、プラグ可能なプロトコル"
+  - "インターネット要求への応答、プラグ可能なプロトコル"
+  - "WebResponse クラス、プラグ可能なプロトコル"
+  - "送信 (データを)、プラグ可能なプロトコル"
+  - "ネットワーク リソース、プラグ可能なプロトコル"
+  - "インターネット、プラグ可能なプロトコル"
+  - "プラグ可能なプロトコルのプログラミング"
+  - "プラグ可能なプロトコル、プログラミング"
+  - "要求 (インターネットからデータを)、プラグ可能なプロトコル"
+  - "受信 (データを)、プラグ可能なプロトコル"
+  - "プロトコル、プラグ可能"
+ms.assetid: 66ef8456-7576-4e97-8956-959b216373db
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# プラグ可能なプロトコルのプログラミング
+<xref:System.Net.WebResponse> の抽象的な <xref:System.Net.WebRequest> およびクラスはプラグイン可能なプロトコルに基準を提供します。  <xref:System.Net.WebRequest> と <xref:System.Net.WebResponse>からプロトコル対応クラスを取得すると、アプリケーションは、インターネットのリソースのデータを要求し、使用するプロトコルを指定せずに応答を読み取ることができます。  
+  
+ プロトコル対応する <xref:System.Net.WebRequest>を作成する前に作成されます方法を登録する必要があります。  <xref:System.Net.WebRequest> その子孫を特定のインターネット設定に、設定、サーバー、または設定、サーバーとパスに複数の要求を処理するために登録するに <xref:System.Net.WebRequest> の <xref:System.Net.WebRequest.RegisterPrefix%28System.String%2CSystem.Net.IWebRequestCreate%29> の静的な方法を使用します。  
+  
+ ほとんどの場合、送れるデータを <xref:System.Net.WebRequest> 方法およびプロパティを使用して受け取るように分類します。  ただし、対応アクセス プロトコルのプロパティを必要がある場合は、特定の派生クラスのインスタンスに <xref:System.Net.WebRequest> を型にはめるできます。  
+  
+ プラグイン可能なプロトコルを使用するには、<xref:System.Net.WebRequest> のプロトコル子孫は対応するプロパティがある必要はありません既定の要求および応答のトランザクションを入力する必要があります。  たとえば、HTTP の <xref:System.Net.WebRequest> クラスを実行する <xref:System.Net.HttpWebRequest> のクラスが Web サーバーから返されるストリームを含む `GET` の要求を既定では提供します <xref:System.Net.HttpWebResponse> を返します。  
+  
+## 参照  
+ [WebRequest からの派生](../../../docs/framework/network-programming/deriving-from-webrequest.md)   
+ [WebResponse からの派生](../../../docs/framework/network-programming/deriving-from-webresponse.md)   
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [方法: WebRequest を型キャストしてプロトコル固有のプロパティにアクセスする](../../../docs/framework/network-programming/how-to-typecast-a-webrequest-to-access-protocol-specific-properties.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/proxy-configuration.md b/docs/framework/network-programming/proxy-configuration.md
new file mode 100644
index 00000000000..f04d4bcbd81
--- /dev/null
+++ b/docs/framework/network-programming/proxy-configuration.md
@@ -0,0 +1,113 @@
+---
+title: "プロキシ コンフィギュレーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "適応性があるプロキシ"
+  - "インターネット, プロキシ コンフィギュレーション"
+  - "ネットワーク リソース"
+  - "ネットワーク, プロキシ コンフィギュレーション"
+  - "ネットワーキング"
+  - "プロキシ"
+  - "プロキシ, 構成"
+  - "静的プロキシ"
+ms.assetid: 353c0a8b-4cee-44f6-8e65-60e286743df9
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# プロキシ コンフィギュレーション
+プロキシ サーバーは、リソースに対するクライアント要求を処理します。  プロキシは、要求されたリソースをキャッシュから返したり、リソースが存在するサーバーに要求を転送したりできます。  プロキシは、リモート サーバーに送信された要求の数を減らすことで、ネットワークのパフォーマンスを向上できます。  プロキシを使用して、リソースへのアクセスを制限することもできます。  
+  
+## アダプティブ プロキシ  
+ .NET Framework には、アダプティブと静的という 2 種類のプロキシがあります。  アダプティブ プロキシは、ネットワーク構成を変更するときに、その設定を調整します。  たとえば、ラップトップ ユーザーがダイヤルアップ ネットワーク接続を起動する場合、アダプティブ プロキシはこの変更を認識し、新しい構成スクリプトを検出して実行し、その設定を適切に調整します。  
+  
+ アダプティブ プロキシは、構成スクリプトによって構成されます \([自動プロキシ検出](../../../docs/framework/network-programming/automatic-proxy-detection.md) を参照\)。  スクリプトは、一連のアプリケーション プロトコルと、各プロトコル用のプロキシを生成します。  
+  
+ いくつかのオプションは、構成スクリプトの実行方法を制御します。  以下を指定できます。  
+  
+-   構成スクリプトがダウンロードおよび実行される頻度。  
+  
+-   スクリプトをダウンロードするまで待機する時間。  
+  
+-   プロキシにアクセスするためにシステムで使用する資格情報。  
+  
+-   構成スクリプトをダウンロードするためにシステムで使用する資格情報。  
+  
+ ネットワーク環境での変更により、システムで新しい一連のプロキシを使用することが必要となる場合があります。  ネットワーク接続がダウンしたか、新しいネットワーク接続が開始された場合、システムは新しい環境で構成スクリプトの適切なソースを検出し、新しいスクリプトを実行する必要があります。  
+  
+ 次の表に、アダプティブ プロキシの構成オプションを示します。  
+  
+|属性、プロパティ、または構成ファイルの設定|説明|  
+|---------------------------|--------|  
+|`scriptDownloadInterval`|スクリプトをダウンロードする間の経過時間 \(秒単位\)。|  
+|`scriptDownloadTimeout`|スクリプトをダウンロードするまでの待機時間 \(秒単位\)。|  
+|`useDefaultCredentials` または<xref:System.Net.WebProxy.UseDefaultCredentials>|プロキシにアクセスするためにシステムで既定のネットワーク資格情報を使用するかどうかを制御します。|  
+|`useDefaultCredentialForScriptDownload`|構成スクリプトをダウンロードするためにシステムで既定のネットワーク資格情報を使用するかどうかを制御します。|  
+|`usesystemdefaults`|静的プロキシ設定 \(プロキシ アドレス、バイパス リスト、およびローカルでのバイパス\) をユーザーの Internet Explorer プロキシ設定から読み取るかどうかを制御します。  この値を"true"に設定した場合、Internet Explorer の静的プロキシ設定が使用されます。<br /><br /> この値が"false"であるか、または設定しない場合、静的プロキシ設定を構成で指定することができ、Internet Explorer のプロキシ設定をオーバーライドできます。  アダプティブ プロキシを有効にする場合も、この値を"false"に設定するか、または設定しないようにする必要があります。|  
+  
+ 一般的なアダプティブ プロキシの構成例を次に示します。  
+  
+```  
+<system.net>  
+    <defaultProxy>  
+      <proxy  scriptDownloadInterval="600"  
+              scriptDownloadTimeout="30"  
+              useDefaultCredentials="true"  
+              usesystemdefaults="true"  
+      />  
+    </defaultProxy>  
+</system.net>  
+```  
+  
+## 静的プロキシ  
+ 静的プロキシは、通常、アプリケーションによって明示的に構成されるか、アプリケーションまたはシステムによって構成ファイルが呼び出されたときに構成されます。  静的プロキシは、企業ネットワークに接続されているデスクトップ コンピューターなど、トポロジがあまり変更されないネットワークで役立ちます。  
+  
+ いくつかのオプションで静的プロキシの動作を制御します。  以下を指定できます。  
+  
+-   プロキシのアドレス。  
+  
+-   ローカル アドレスに対してプロキシをバイパスするかかどうか。  
+  
+-   一連のアドレスに対してプロキシをバイパスするかかどうか。  
+  
+ 次の表に、静的プロキシの構成オプションを示します。  
+  
+|属性、プロパティ、または構成ファイルの設定|説明|  
+|---------------------------|--------|  
+|`proxyaddress` または<xref:System.Net.WebProxy.Address>|使用するプロキシのアドレス。|  
+|`bypassonlocal` または<xref:System.Net.WebProxy.BypassProxyOnLocal>|ローカル アドレスに対してプロキシをバイパスするかどうかを制御します。|  
+|`bypasslist` または<xref:System.Net.WebProxy.BypassArrayList>|正規表現を使用して、プロキシをバイパスするアドレスのセットを記述します。|  
+|`usesystemdefaults`|静的プロキシ設定 \(プロキシ アドレス、バイパス リスト、およびローカルでのバイパス\) をユーザーの Internet Explorer プロキシ設定から読み取るかどうかを制御します。  この値を"true"に設定した場合、Internet Explorer の静的プロキシ設定が使用されます。  .NET Framework 2.0 でこの値を"true"に設定した場合、Internet Explorer のプロキシ設定は構成ファイル内の他のプロキシ設定でオーバーライドされません。  .NET Framework 1.1 では、構成ファイル内の他のプロキシ設定で Internet Explorer のプロキシ設定をオーバーライドできます。<br /><br /> この値が"false"であるか、または設定しない場合、静的プロキシ設定を構成で指定することができ、Internet Explorer のプロキシ設定をオーバーライドできます。  アダプティブ プロキシを有効にする場合も、この値を"false"に設定するか、または設定しないようにする必要があります。|  
+  
+ 一般的な静的プロキシの構成例を次に示します。  
+  
+```  
+<system.net>  
+    <defaultProxy>  
+        <proxy  proxyaddress="http://proxy.contoso.com:3128"  
+                bypassonlocal="true"  
+        />  
+        <bypasslist>  
+            <add address="[a-z]+.blueyonderairlines.com$" />  
+        </bypasslist>  
+    </defaultProxy>  
+</system.net>  
+```  
+  
+## 参照  
+ <xref:System.Net.WebProxy>   
+ <xref:System.Net.GlobalProxySelection>   
+ [自動プロキシ検出](../../../docs/framework/network-programming/automatic-proxy-detection.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/requesting-data.md b/docs/framework/network-programming/requesting-data.md
new file mode 100644
index 00000000000..d04a4366848
--- /dev/null
+++ b/docs/framework/network-programming/requesting-data.md
@@ -0,0 +1,66 @@
+---
+title: "データの要求 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "送信 (データを)"
+  - "WebRequest クラス、送受信 (データを)"
+  - "要求 (インターネットからデータを)、データ要求の概要"
+  - "WebClient クラス、送受信 (データを)"
+  - "ネットワーク、要求 (データを)"
+  - "受信 (データを)"
+  - "送信 (データを)、データ送信の概要"
+  - "インターネット要求への応答、インターネット要求への応答の概要"
+  - "データ要求"
+  - "受信 (データを)、データ受信の概要"
+  - "インターネット、要求 (データを)"
+ms.assetid: df6f1e1d-6f2a-45dd-8141-4a85c3dafe1d
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# データの要求
+今日のインターネット配送されるオペレーティング環境で実行されるアプリケーションを作成すると、すべての型のリソースからデータを取得するには有効で、使いやすい方法が必要です。  プラグイン可能なセキュリティは複数のインターネット プロトコルからデータを取得するために一つのインターフェイスを使用するアプリケーションを開発することができます。  
+  
+## インターネット サーバーからのデータをアップロードおよびダウンロードします  
+ 単純な要求と回答のトランザクションに対して、<xref:System.Net.WebClient> のクラスは、データをアップロードまたはインターネット サーバーからのデータをダウンロードする最も簡単な方法を提供します。  **WebClient** は、し、ファイルをダウンロードし、送信、ストリームを受け取るには、データをバッファ サーバーに送信と応答を表示する方法を提供します。  **WebClient** は、インターネットのリソースに実際の接続に <xref:System.Net.WebRequest> と <xref:System.Net.WebResponse> クラスを使用します。登録されたプラグイン可能なプロトコルでも使用できます。  
+  
+ さらに複雑なトランザクションを行う必要があるクライアント アプリケーションは **\[WebRequest\]** クラスを使用しているサーバーと子孫のデータが必要です。  **\[WebRequest\]** はサーバーに接続し、要求を送信および応答の入荷の詳細をカプセル化。  **\[WebRequest\]** はプラグイン可能なプロトコルを使用するすべてのアプリケーションに使用可能なおよびメソッドは一連のプロパティを定義する抽象型クラスです。  **\[WebRequest\]**その子孫、<xref:System.Net.HttpWebRequest>などの基になるプロトコルと一致している方法で **\[WebRequest\]** によって定義されたプロパティ、およびメソッドを実行します。  
+  
+ **\[WebRequest\]** クラスは、特定の派生クラスのインスタンスを判断 <xref:System.Net.WebRequest.Create%2A> 方法に渡される URI の値を使用して作成するに **\[WebRequest\]** その子孫プロトコル対応のインスタンスを作成します。  アプリケーションは要求を処理するために **\[WebRequest\]** のどの子孫が <xref:System.Net.WebRequest.RegisterPrefix%2A?displayProperty=fullName> 方法またはその子孫のコンストラクターの登録に使用する方法を示します。  
+  
+ 要求は、インターネットのリソースに **\[WebRequest\]**で <xref:System.Net.WebRequest.GetResponse%2A> 方法を呼び出しに従って行われます。  **GetResponse** 方法は **\[WebRequest\]**のプロパティからプロトコル対応する要求を組み立てましたり、サーバーへの TCP または UDP ソケットの接続を行い、要求を送信します。  HTTP **\[投稿\]** または FTP の **Put** などのサーバーにデータを要求する要求の場合、<xref:System.Net.WebRequest.GetRequestStream%2A?displayProperty=fullName> 方法は、データを送信するネットワーク ストリームを提供します。  
+  
+ **WebRequest.**に一致する **GetResponse** 方法はプロトコル対応する **WebResponse** を返します  
+  
+ **WebResponse** クラスは、プラグイン可能なプロトコルを使用するすべてのアプリケーションに使用可能なおよびメソッド プロパティを定義する抽象型クラスです。  **WebResponse** その子孫は、その基になるプロトコルのこれらのプロパティおよびメソッドを実行します。  <xref:System.Net.HttpWebResponse> クラスは、たとえば、HTTP の **WebResponse** クラスが実装されます。  
+  
+ サーバーが返品データは <xref:System.Net.WebResponse.GetResponseStream%2A?displayProperty=fullName> 方法によって返されたベースのアプリケーションに表示されます。  次の例で示すように、他のすべての期間にストリームも、使用できます。  
+  
+```csharp  
+StreamReader sr =  
+   new StreamReader(resp.GetResponseStream(), Encoding.ASCII);  
+  
+```  
+  
+```vb  
+Dim sr As StreamReader  
+sr = New StreamReader(resp.GetResponseStream(), Encoding.ASCII)  
+```  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [方法: Web ページを要求し、ストリームとして結果を取得する](../../../docs/framework/network-programming/how-to-request-a-web-page-and-retrieve-the-results-as-a-stream.md)   
+ [方法: WebRequest に一致するプロトコル固有の WebResponse を取得する](../../../docs/framework/network-programming/how-to-retrieve-a-protocol-specific-webresponse-that-matches-a-webrequest.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/security-in-network-programming.md b/docs/framework/network-programming/security-in-network-programming.md
new file mode 100644
index 00000000000..21f060beb22
--- /dev/null
+++ b/docs/framework/network-programming/security-in-network-programming.md
@@ -0,0 +1,47 @@
+---
+title: "ネットワーク プログラミングにおけるセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "送信 (データを)、インターネット セキュリティ"
+  - "プロトコル、インターネット セキュリティ"
+  - "ネットワーク セキュリティ"
+  - "ネットワーク リソース、インターネット セキュリティ"
+  - "受信 (データを)、インターネット セキュリティ"
+  - "認証 [.NET Framework]、インターネット セキュリティ"
+  - "インターネット、セキュリティ"
+  - "セキュリティ [.NET Framework]、インターネット"
+  - "アクセス許可 [.NET Framework]、インターネット"
+ms.assetid: afb07899-2707-49ab-a57f-e0caf20d0171
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# ネットワーク プログラミングにおけるセキュリティ
+.NET Framework の <xref:System.Net> の名前空間のクラスが一般的なインターネット アプリケーションの認証スキームと .NET Framework コードのアクセス許可にビルトインなサポートを提供します。  
+  
+## このセクションの内容  
+ [Secure Sockets Layerの使用](../../../docs/framework/network-programming/using-secure-sockets-layer.md)  
+ Secure Sockets Layer \(SSL\) 接続の使用方法について説明します。  
+  
+ [インターネット認証](../../../docs/framework/network-programming/internet-authentication.md)  
+ HTTP 認証方法が HTTP サーバーへの接続した認証を設定するために使用する方法を説明します。  
+  
+ [Web およびソケットのアクセス許可](../../../docs/framework/network-programming/web-and-socket-permissions.md)  
+ インターネット接続を使用するアプリケーションのコード アクセス セキュリティを設定する方法について説明します。  
+  
+## 関連項目  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)  
+ <xref:System.Net.Sockets> の <xref:System.Net> と名前空間のクラスを与えます。
\ No newline at end of file
diff --git a/docs/framework/network-programming/socket-code-examples.md b/docs/framework/network-programming/socket-code-examples.md
new file mode 100644
index 00000000000..a535b85a65d
--- /dev/null
+++ b/docs/framework/network-programming/socket-code-examples.md
@@ -0,0 +1,55 @@
+---
+title: "ソケットのコード例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "ソケット クラス、非同期サーバー ソケット"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "サーバー ソケット"
+  - "ソケット、コード例"
+  - "受信 (データの)、ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+  - "クライアント ソケット"
+ms.assetid: f3fc7533-6956-42c6-bbc3-73e5a221027d
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# ソケットのコード例
+次のコード例は、ネットワーク サービスに接続するにはクライアントとクライアントのリモート接続を立てる聴覚にそばサーバーとして <xref:System.Net.Sockets.Socket> クラスを使用する方法を示します。  
+  
+## このセクションの内容  
+ [同期クライアント ソケットの例](../../../docs/framework/network-programming/synchronous-client-socket-example.md)  
+ サーバーに接続し、サーバーからのデータを表示する <xref:System.Net.Sockets.Socket> クライアントの同期を実行する方法を示します。  
+  
+ [同期サーバー ソケットの例](../../../docs/framework/network-programming/synchronous-server-socket-example.md)  
+ クライアントから接続を受け入れ、エコーがクライアントから受け取ったデータをサポートする <xref:System.Net.Sockets.Socket> の同期サーバーを実行する方法を示します。  
+  
+ [非同期クライアント ソケットの例](../../../docs/framework/network-programming/asynchronous-client-socket-example.md)  
+ サーバーに接続し、サーバーからのデータを表示する <xref:System.Net.Sockets.Socket> の非同期なクライアントの実行方法を示します。  
+  
+ [非同期サーバー ソケットの例](../../../docs/framework/network-programming/asynchronous-server-socket-example.md)  
+ クライアントから接続を受け入れ、エコーがクライアントから受け取ったデータをサポートする <xref:System.Net.Sockets.Socket> の非同期なサーバーを実行する方法を示します。  
+  
+## 関連項目  
+ [ソケット](../../../docs/framework/network-programming/sockets.md)  
+ <xref:System.Net.Sockets> の名前空間、<xref:System.Net.Sockets.Socket> クラスに関する基本情報を提供します。  
+  
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)  
+ 標準的なインターネット セキュリティ技術と認証を使用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/network-programming/socket-performance-enhancements-in-version-3-5.md b/docs/framework/network-programming/socket-performance-enhancements-in-version-3-5.md
new file mode 100644
index 00000000000..f369b4777e7
--- /dev/null
+++ b/docs/framework/network-programming/socket-performance-enhancements-in-version-3-5.md
@@ -0,0 +1,52 @@
+---
+title: "バージョン 3.5 のソケット パフォーマンスの強化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 225aa5f9-c54b-4620-ab64-5cd100cfd54c
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# バージョン 3.5 のソケット パフォーマンスの強化
+<xref:System.Net.Sockets.Socket?displayProperty=fullName> のクラスは、高性能を実現するために非同期なネットワークの I\/O を使用するアプリケーションに使用する Version 3.5 で高められました。  一連の新しいクラスは <xref:System.Net.Sockets.Socket> クラスに特別な高性能ソケット アプリケーションに使用できる代替非同期パターンを提供する一連の改良の一部として追加されました。  これらの高パフォーマンスを改善が必要なサーバー ネットワークのアプリケーションに合わせてデザインされています。  アプリケーションはアプリケーションの対象とした、地域の活動でのみ大量のデータを受け取る場合など\) 拡張非同期パターン、またはのみ使用できます \(。  
+  
+## クラスの改良  
+ これらの強化部分の主な機能として、大量の非同期ソケット I\/O 操作時にオブジェクトの割り当てと同期の繰り返しを回避することが挙げられます。  非同期なソケット現在の I\/O の <xref:System.Net.Sockets.Socket> のクラスが実装される開始\/終了のデザイン パターンは、非同期のなソケットの工程に割り当てられます <xref:System.IAsyncResult?displayProperty=fullName> のオブジェクトを要求します。  
+  
+ 新しい <xref:System.Net.Sockets.Socket> クラスの改良で、非同期の工程はソケットなアプリケーションで配賦され管理する <xref:System.Net.Sockets.SocketAsyncEventArgs?displayProperty=fullName> の再利用可能なオブジェクト クラスによって示されます。  高パフォーマンスのソケット アプリケーションは、維持する必要のある重複したソケット操作の量を十分に認識しています。  アプリケーションでは、必要な数の <xref:System.Net.Sockets.SocketAsyncEventArgs> オブジェクトを作成できます。  たとえば、サーバー アプリケーションは、受信するクライアント接続率をサポートするために、未払の 15 のソケットの承認の工程があるたびに必要がある場合は、その目的の <xref:System.Net.Sockets.SocketAsyncEventArgs> の 15 の再利用可能なオブジェクトを事前に割り当てることができます。  
+  
+ このクラスで非同期ソケット操作を実行するためのパターンは、次の手順で構成されます。  
+  
+1.  新しい <xref:System.Net.Sockets.SocketAsyncEventArgs> コンテキスト オブジェクトを割り当てるか、アプリケーション プールから空きオブジェクトを取得します。  
+  
+2.  実行する工程へのコンテキストでオブジェクトのプロパティを複数設定 \(コールバック指定方法、バッファ データなど\)。  
+  
+3.  適切なソケット メソッド \(xxxAsync\) を呼び出して、非同期操作を開始します。  
+  
+4.  非同期なソケット方法 \(xxxAsync\) がコールバック true、それを完了ステータスのコンテキスト プロパティを照会します。  
+  
+5.  非同期なソケット方法 \(xxxAsync\) がコールバック false を返す場合、工程は同期的に入力されます。  この場合、コンテキスト プロパティに操作の結果を照会できます。  
+  
+6.  コンテキストを別の操作に再利用するか、プールに戻すか、または破棄します。  
+  
+ 新しい非同期なソケットの工程のコンテキストでは、アプリケーション オブジェクトの有効期間コードと非同期の I\/O 参照の参照によって決まります。  非同期ソケット操作コンテキスト オブジェクトが非同期ソケット操作メソッドのいずれかにパラメーターとして送信された後は、アプリケーションでこのオブジェクトへの参照を保持する必要はありません。  完了コールバックから制御が戻るまで、オブジェクトは参照されたままになります。  ただし、は、将来の非同期なソケットの工程で再利用できるよう、コンテキストのオブジェクトへの参照を終了アプリケーションの場合は有効です。  
+  
+## 参照  
+ <xref:System.Net.Sockets.Socket?displayProperty=fullName>   
+ <xref:System.Net.Sockets.SendPacketsElement?displayProperty=fullName>   
+ <xref:System.Net.Sockets.SocketAsyncEventArgs?displayProperty=fullName>   
+ <xref:System.Net.Sockets.SocketAsyncOperation?displayProperty=fullName>   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [ソケットのパフォーマンス テクノロジのサンプル](http://go.microsoft.com/fwlink/?LinkID=179570)
\ No newline at end of file
diff --git a/docs/framework/network-programming/sockets.md b/docs/framework/network-programming/sockets.md
new file mode 100644
index 00000000000..305fd5775af
--- /dev/null
+++ b/docs/framework/network-programming/sockets.md
@@ -0,0 +1,45 @@
+---
+title: "ソケット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データを)、ソケット"
+  - "データ要求、ソケット"
+  - "Windows ソケット"
+  - "ソケット、ソケットの概要"
+  - "Socket クラス、Socket クラスの概要"
+  - "ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "ネットワーク、ソケット"
+  - "受信 (データを)、ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+ms.assetid: 10d22735-bd37-42c1-a2be-c1932f979a7d
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# ソケット
+<xref:System.Net.Sockets> の名前空間はソケット Windows インターフェイスの管理が適用されます。  <xref:System.Net> の名前空間のそのほかのネットワーク アクセスのすべてのクラスはソケットこの実装の先頭に基づきます。  
+  
+ .NET Framework の <xref:System.Net.Sockets.Socket> クラス API は Winsock32 によるソケットのサービス管理コードのバージョンです。  ほとんどの場合、**\[ソケット\]** クラスのメソッドはネイティブ Win32 の対応にデータを単にマーシャリングし、必要なセキュリティ検査を処理します。  
+  
+ **\[ソケット\]** のクラスが 2 基本モード、同期、非同期がサポートされます。  同期モードでは、決済を実行する機能への呼び出しは、ネットワーク アクション \(<xref:System.Net.Sockets.Socket.Send%2A> と <xref:System.Net.Sockets.Socket.Receive%2A>など\) 工程が呼び出されなかったのプログラムへ制御を行う前に完了するまで待機しています。  非同期モード リストで、これらの通話は、戻されます。  
+  
+## 参照  
+ [方法: ソケットを作成する](../../../docs/framework/network-programming/how-to-create-a-socket.md)   
+ [TCP\/UDP](../../../docs/framework/network-programming/tcp-udp.md)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/synchronous-client-socket-example.md b/docs/framework/network-programming/synchronous-client-socket-example.md
new file mode 100644
index 00000000000..2a07dda3ed9
--- /dev/null
+++ b/docs/framework/network-programming/synchronous-client-socket-example.md
@@ -0,0 +1,148 @@
+---
+title: "同期クライアント ソケットの例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ソケット、コード例"
+  - "同期クライアント ソケット"
+  - "ソケット、同期クライアント ソケット"
+ms.assetid: 2c7d5be7-2221-467c-a839-5744ec4d576d
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 同期クライアント ソケットの例
+次の例では、サーバーに接続するクライアントを作成します。  クライアントはソケット同期して構築ため、サーバーが応答を返すまでクライアント アプリケーションの実行が中止されます。  アプリケーション サーバーには、文字列を送信し、次にコンソール サーバーによって返された文字列が表示されます。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Text  
+  
+Public Class SynchronousSocketClient  
+  
+    Public Shared Sub Main()  
+        ' Data buffer for incoming data.  
+        Dim bytes(1024) As Byte  
+  
+        ' Connect to a remote device.  
+  
+        ' Establish the remote endpoint for the socket.  
+        ' This example uses port 11000 on the local computer.  
+        Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+        Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+        Dim remoteEP As New IPEndPoint(ipAddress, 11000)  
+  
+        ' Create a TCP/IP socket.  
+        Dim sender As New Socket(AddressFamily.InterNetwork, _  
+            SocketType.Stream, ProtocolType.Tcp)  
+  
+        ' Connect the socket to the remote endpoint.  
+        sender.Connect(remoteEP)  
+  
+        Console.WriteLine("Socket connected to {0}", _  
+            sender.RemoteEndPoint.ToString())  
+  
+        ' Encode the data string into a byte array.  
+        Dim msg As Byte() = _  
+            Encoding.ASCII.GetBytes("This is a test<EOF>")  
+  
+        ' Send the data through the socket.  
+        Dim bytesSent As Integer = sender.Send(msg)  
+  
+        ' Receive the response from the remote device.  
+        Dim bytesRec As Integer = sender.Receive(bytes)  
+        Console.WriteLine("Echoed test = {0}", _  
+            Encoding.ASCII.GetString(bytes, 0, bytesRec))  
+  
+        ' Release the socket.  
+        sender.Shutdown(SocketShutdown.Both)  
+        sender.Close()  
+    End Sub  
+  
+End Class 'SynchronousSocketClient  
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+public class SynchronousSocketClient {  
+  
+    public static void StartClient() {  
+        // Data buffer for incoming data.  
+        byte[] bytes = new byte[1024];  
+  
+        // Connect to a remote device.  
+        try {  
+            // Establish the remote endpoint for the socket.  
+            // This example uses port 11000 on the local computer.  
+            IPHostEntry ipHostInfo = Dns.Resolve(Dns.GetHostName())  
+            IPAddress ipAddress = ipHostInfo.AddressList[0];  
+            IPEndPoint remoteEP = new IPEndPoint(ipAddress,11000);  
+  
+            // Create a TCP/IP  socket.  
+            Socket sender = new Socket(AddressFamily.InterNetwork,   
+                SocketType.Stream, ProtocolType.Tcp );  
+  
+            // Connect the socket to the remote endpoint. Catch any errors.  
+            try {  
+                sender.Connect(remoteEP);  
+  
+                Console.WriteLine("Socket connected to {0}",  
+                    sender.RemoteEndPoint.ToString());  
+  
+                // Encode the data string into a byte array.  
+                byte[] msg = Encoding.ASCII.GetBytes("This is a test<EOF>");  
+  
+                // Send the data through the socket.  
+                int bytesSent = sender.Send(msg);  
+  
+                // Receive the response from the remote device.  
+                int bytesRec = sender.Receive(bytes);  
+                Console.WriteLine("Echoed test = {0}",  
+                    Encoding.ASCII.GetString(bytes,0,bytesRec));  
+  
+                // Release the socket.  
+                sender.Shutdown(SocketShutdown.Both);  
+                sender.Close();  
+  
+            } catch (ArgumentNullException ane) {  
+                Console.WriteLine("ArgumentNullException : {0}",ane.ToString());  
+            } catch (SocketException se) {  
+                Console.WriteLine("SocketException : {0}",se.ToString());  
+            } catch (Exception e) {  
+                Console.WriteLine("Unexpected exception : {0}", e.ToString());  
+            }  
+  
+        } catch (Exception e) {  
+            Console.WriteLine( e.ToString());  
+        }  
+    }  
+  
+    public static int Main(String[] args) {  
+        StartClient();  
+        return 0;  
+    }  
+}  
+```  
+  
+## 参照  
+ [同期サーバー ソケットの例](../../../docs/framework/network-programming/synchronous-server-socket-example.md)   
+ [同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-client-socket.md)   
+ [ソケットのコード例](../../../docs/framework/network-programming/socket-code-examples.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/synchronous-server-socket-example.md b/docs/framework/network-programming/synchronous-server-socket-example.md
new file mode 100644
index 00000000000..39f2762b153
--- /dev/null
+++ b/docs/framework/network-programming/synchronous-server-socket-example.md
@@ -0,0 +1,171 @@
+---
+title: "同期サーバー ソケットの例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "同期サーバー ソケット"
+  - "ソケット、コード例"
+  - "ソケット、同期サーバー ソケット"
+ms.assetid: 5916c764-879f-4716-99fb-1d21c6237f1c
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# 同期サーバー ソケットの例
+次の例では、クライアントから接続要求を受け取るサーバーを作成します。  サーバーはソケット同期によって基づいているので、クライアントから接続を待つ間、サーバー アプリケーションの実行が中止されます。  アプリケーションはクライアントの文字列が表示され、コンソールの文字列を表示し、クライアントには文字列をエコーします。  The string クライアントから文字列「」を\<EOF\>メッセージの終了を通知するために含める必要があります。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Text  
+Imports Microsoft.VisualBasic  
+  
+Public Class SynchronousSocketListener  
+  
+    ' Incoming data from the client.  
+    Public Shared data As String = Nothing  
+  
+    Public Shared Sub Main()  
+        ' Data buffer for incoming data.  
+        Dim bytes() As Byte = New [Byte](1024) {}  
+  
+        ' Establish the local endpoint for the socket.  
+        ' Dns.GetHostName returns the name of the   
+        ' host running the application.  
+        Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+        Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+        Dim localEndPoint As New IPEndPoint(ipAddress, 11000)  
+  
+        ' Create a TCP/IP socket.  
+        Dim listener As New Socket(AddressFamily.InterNetwork, _  
+            SocketType.Stream, ProtocolType.Tcp)  
+  
+        ' Bind the socket to the local endpoint and   
+        ' listen for incoming connections.  
+  
+        listener.Bind(localEndPoint)  
+        listener.Listen(10)  
+  
+        ' Start listening for connections.  
+        While True  
+            Console.WriteLine("Waiting for a connection...")  
+            ' Program is suspended while waiting for an incoming connection.  
+            Dim handler As Socket = listener.Accept()  
+            data = Nothing  
+  
+            ' An incoming connection needs to be processed.  
+            While True  
+                bytes = New Byte(1024) {}  
+                Dim bytesRec As Integer = handler.Receive(bytes)  
+                data += Encoding.ASCII.GetString(bytes, 0, bytesRec)  
+                If data.IndexOf("<EOF>") > -1 Then  
+                    Exit While  
+                End If  
+            End While  
+            ' Show the data on the console.  
+            Console.WriteLine("Text received : {0}", data)  
+            ' Echo the data back to the client.  
+            Dim msg As Byte() = Encoding.ASCII.GetBytes(data)  
+            handler.Send(msg)  
+            handler.Shutdown(SocketShutdown.Both)  
+            handler.Close()  
+        End While  
+    End Sub  
+  
+End Class 'SynchronousSocketListener  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+public class SynchronousSocketListener {  
+  
+    // Incoming data from the client.  
+    public static string data = null;  
+  
+    public static void StartListening() {  
+        // Data buffer for incoming data.  
+        byte[] bytes = new Byte[1024];  
+  
+        // Establish the local endpoint for the socket.  
+        // Dns.GetHostName returns the name of the   
+        // host running the application.  
+        IPHostEntry ipHostInfo = Dns.Resolve(Dns.GetHostName());  
+        IPAddress ipAddress = ipHostInfo.AddressList[0];  
+        IPEndPoint localEndPoint = new IPEndPoint(ipAddress, 11000);  
+  
+        // Create a TCP/IP socket.  
+        Socket listener = new Socket(AddressFamily.InterNetwork,  
+            SocketType.Stream, ProtocolType.Tcp );  
+  
+        // Bind the socket to the local endpoint and   
+        // listen for incoming connections.  
+        try {  
+            listener.Bind(localEndPoint);  
+            listener.Listen(10);  
+  
+            // Start listening for connections.  
+            while (true) {  
+                Console.WriteLine("Waiting for a connection...");  
+                // Program is suspended while waiting for an incoming connection.  
+                Socket handler = listener.Accept();  
+                data = null;  
+  
+                // An incoming connection needs to be processed.  
+                while (true) {  
+                    bytes = new byte[1024];  
+                    int bytesRec = handler.Receive(bytes);  
+                    data += Encoding.ASCII.GetString(bytes,0,bytesRec);  
+                    if (data.IndexOf("<EOF>") > -1) {  
+                        break;  
+                    }  
+                }  
+  
+                // Show the data on the console.  
+                Console.WriteLine( "Text received : {0}", data);  
+  
+                // Echo the data back to the client.  
+                byte[] msg = Encoding.ASCII.GetBytes(data);  
+  
+                handler.Send(msg);  
+                handler.Shutdown(SocketShutdown.Both);  
+                handler.Close();  
+            }  
+  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+  
+        Console.WriteLine("\nPress ENTER to continue...");  
+        Console.Read();  
+  
+    }  
+  
+    public static int Main(String[] args) {  
+        StartListening();  
+        return 0;  
+    }  
+}  
+```  
+  
+## 参照  
+ [同期クライアント ソケットの例](../../../docs/framework/network-programming/synchronous-client-socket-example.md)   
+ [同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-server-socket.md)   
+ [ソケットのコード例](../../../docs/framework/network-programming/socket-code-examples.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/tcp-udp.md b/docs/framework/network-programming/tcp-udp.md
new file mode 100644
index 00000000000..ff7c61a9f6d
--- /dev/null
+++ b/docs/framework/network-programming/tcp-udp.md
@@ -0,0 +1,51 @@
+---
+title: "TCP/UDP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロトコル、TCP/UDP"
+  - "ネットワーク リソース、TCP/UDP"
+  - "送信 (データを)、TCP/UDP"
+  - "TCP/UDP"
+  - "TcpClient クラス、TcpClient クラスの概要"
+  - "アプリケーション プロトコル、TCP/UDP"
+  - "受信 (データを)、TCP/UDP"
+  - "TcpListener クラス、TcpListener クラスの概要"
+  - "Socket クラス、Socket クラスの概要"
+  - "UDP"
+  - "データ要求、TCP/UDP"
+  - "要求 (インターネットからデータを)、TCP/UDP"
+  - "インターネット、TCP/UDP"
+ms.assetid: df29b4b0-49e8-4923-82b9-13150dfc40f5
+caps.latest.revision: 8
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 8
+---
+# TCP/UDP
+アプリケーションは、サービス <xref:System.Net.Sockets.TcpClient>、<xref:System.Net.Sockets.TcpListener>と <xref:System.Net.Sockets.UdpClient> クラスの伝送制御 Protocol \(TCP\) およびユーザー データグラム Protocol \(UDP\) の使用できます。  これらのプロトコル クラスは、<xref:System.Net.Sockets.Socket?displayProperty=fullName> クラスの上に構築、移動のデータの詳細を使用します。  
+  
+ プロトコル クラスは、管理のステータス情報やセキュリティ対応するソケットの設定の詳細を把握することの間接費なしでネットワーク サービスに簡単で、簡単なアクセスを提供するに **\[ソケット\]** クラスの同期方法を使用します。  への **\[ソケット\]** 非同期な方法を使用するには、<xref:System.Net.Sockets.NetworkStream> クラスによって指定された非同期な方法を使用できます。  **\[ソケット\]** への機能にアクセスするには、プロトコル クラスによって公開されていない **\[ソケット\]** クラスを使用して分類します。  
+  
+ **TcpClient** と **TcpListener** は **\[NetworkStream\]** クラスを使用してネットワークを表します。  ネットワーク ストリームを戻すために <xref:System.Net.Sockets.TcpClient.GetStream%2A> 方法を使用し、ベースの <xref:System.Net.Sockets.NetworkStream.Read%2A> と <xref:System.Net.Sockets.NetworkStream.Write%2A> 方法を追加します。  **\[NetworkStream\]** はプロトコル クラスの下にあるソケットを所有ので、それを閉じるにはソケットに影響しません。  
+  
+ **UdpClient** のクラスは、UDP データグラムを保留にバイトのアレイを使用します。  仕入データグラムを表示する場合は、ネットワーク、<xref:System.Net.Sockets.UdpClient.Receive%2A> 方法にデータを送信するに <xref:System.Net.Sockets.UdpClient.Send%2A> 方法を使用します。  
+  
+## 参照  
+ [TCP サービスの使用](../../../docs/framework/network-programming/using-tcp-services.md)   
+ [UDP サービスの使用](../../../docs/framework/network-programming/using-udp-services.md)   
+ [ネットワーク上でストリームを使用する](../../../docs/framework/network-programming/using-streams-on-the-network.md)   
+ [非同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-server-socket.md)   
+ [非同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-client-socket.md)   
+ [アプリケーション プロトコルの使用](../../../docs/framework/network-programming/using-application-protocols.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/time-based-cache-policies.md b/docs/framework/network-programming/time-based-cache-policies.md
new file mode 100644
index 00000000000..ea250b9b4a2
--- /dev/null
+++ b/docs/framework/network-programming/time-based-cache-policies.md
@@ -0,0 +1,79 @@
+---
+title: "時間ベースのキャッシュ ポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "時間ベースのキャッシュ ポリシー"
+  - "キャッシュの同期の日付のポリシー"
+  - "キャッシュ [.NET Framework]、時間ベースのポリシー"
+  - "キャッシュされたリソースの更新の確認間隔"
+  - "時間、キャッシュされたリソース"
+  - "最大保存期間ポリシー"
+  - "同期、キャッシュ"
+  - "キャッシュされたリソースの期限切れ"
+  - "既定の時間ベースのキャッシュ ポリシー"
+  - "最大の期限切れポリシー"
+  - "コンテンツのキャッシュ ポリシー"
+  - "期限切れのコンテンツ"
+  - "最小の期限切れポリシー"
+  - "キャッシュされたリソースの保存期間"
+ms.assetid: 74f0bcaf-5c95-40c1-9967-f3bbf1d2360a
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 時間ベースのキャッシュ ポリシー
+時間ベースのキャッシュのポリシーは、リソースが取得された時間を使用してキャッシュされたエントリの新鮮さを定義し、ヘッダーは、リソースおよび現在時間と返品済です。  時間ベースのキャッシュのポリシーを設定すると、<xref:System.Net.Cache.HttpRequestCacheLevel> の時間ベースのポリシーを使用し、カスタマイズされた時間ベースのポリシーを作成できます。  既定の時間ベースのポリシーをアプリケーション \(File Transfer Protocol\) を使用してのリソースに使用するとキャッシュの正確な動作は、キャッシュされた回答に含まれるヘッダーと RFC 2616 の使用可能なセクション 13 と 14 で [http:\/\/www.ietf.org](http://www.ietf.org/)指定された動作によって決まります。  HTTP のリソースの既定の時間ベースのポリシーを設定することを示すコード例では、[方法: アプリケーションの既定の時間ベースのキャッシュのポリシーを設定します](../../../docs/framework/network-programming/how-to-set-the-default-time-based-cache-policy-for-an-application.md)を参照してください。  キャッシュのポリシーを作成し、使用方法を示すコード例では、[ネットワーク アプリケーションのキャッシュのコンフィギュレーション](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)を参照してください。  
+  
+## キャッシュされたエントリの新鮮さを決定する条件  
+ 時間ベースのキャッシュのポリシーをカスタマイズするには、キャッシュされたエントリの新鮮さを決定するには、次の基準の一つ以上を使用することを指定できます:  
+  
+-   最大期日が経過する  
+  
+-   最大 staleness  
+  
+-   最小新鮮さ  
+  
+-   キャッシュの同期の日付  
+  
+> [!NOTE]
+>  既定の時間ベースのキャッシュのポリシーを使用して、アプリケーションの既定のキャッシュのポリシーの配置と混同しないでください。  既定の時間ベースのポリシーは、アプリケーション レベル依頼して使用できる特定のポリシーです。  自分のアプリケーションの既定のキャッシュのポリシーは、ポリシーが必須に設定されていない場合、そのポリシー \(場所ベースまたは時間ベースの\) 適用されます。  自分のアプリケーションの既定のキャッシュのポリシーの設定の詳細については、<xref:System.Net.WebRequest.DefaultCachePolicy%2A>を参照してください。  
+  
+### 最大の年齢  
+ 最大期日が経過するポリシーの基準は、リソースのキャッシュされたコピーを使用できる時間を指定します。  リソースのキャッシュされたコピーが指定された時間過ぎている場合にリソースで選択した内容に対してそのチェックすることにより revalidated 必要があります。  切れると最大期日が経過したリソースが使用されるようにする場合は、条件を遵守されません staleness の最大値が指定されていない場合、この。  
+  
+### 最大 Staleness  
+ 最大 staleness ポリシーの基準時間はを使用すると、リソースのキャッシュされたコピーができるコンテンツ指定された有効期限。  これが切れるとリソースが使用されるようにする唯一のキャッシュ ポリシーの基準です。  
+  
+### 最小新鮮さ  
+ 最小新鮮さポリシーの基準時間はを使用する前に、リソースのキャッシュされたコピーができるコンテンツ有効期限指定します。  このポリシーはキャッシュのエントリを有効期限前になるために影響を与えます; したがって、最小および最大新鮮さ staleness の設定は相互に排他的です。  
+  
+## キャッシュの同期の日付  
+ キャッシュの同期の日付のポリシーの基準は、リソースのキャッシュされたコピーがサーバーまたはの内容に対してそのチェックに、いつ revalidated があるかが決まります。  品目は、キャッシュされてから内容を変更する場合は、サーバーから取得され、キャッシュに保管、およびアプリケーションになります。  内容を変更します、タイムスタンプが更新され、アプリケーションは、キャッシュされた内容が表示されます。  
+  
+ キャッシュ同期日時により、キャッシュされたコンテンツの再検証が必要となる具体的な日時を指定できます。  新しいキャッシュのエントリがキャッシュの同期の日付以前に最後に revalidated、サーバーとの revalidation も行われます。  キャッシュの同期の日付が、ここでキャッシュされたエントリを無効にする追加の新鮮さまたはサーバーの revalidation の条件ではないとキャッシュのエントリが revalidated、キャッシュのエントリが使用されます。  キャッシュ同期日時が将来の日付に設定されている場合、エントリは、キャッシュ同期日時が過ぎるまで、要求されるたびに再検証されます。  
+  
+ 次のトピックでは、時間ベースのキャッシュのポリシーの条件を組み合わせた影響について説明します:  
+  
+-   [キャッシュ ポリシーの相互作用 — 最大有効期間と最大期限延長](../../../docs/framework/network-programming/cache-policy-interaction-maximum-age-and-maximum-staleness.md)  
+  
+-   [キャッシュ ポリシーの相互作用 — 最大有効期間と最小鮮度](../../../docs/framework/network-programming/cache-policy-interaction-maximum-age-and-minimum-freshness.md)  
+  
+## 参照  
+ [ネットワーク アプリケーションのキャッシュ管理](../../../docs/framework/network-programming/cache-management-for-network-applications.md)   
+ [キャッシュ ポリシー](../../../docs/framework/network-programming/cache-policy.md)   
+ [場所ベースのキャッシュ ポリシー](../../../docs/framework/network-programming/location-based-cache-policies.md)   
+ [ネットワーク アプリケーションでのキャッシュの構成](../../../docs/framework/network-programming/configuring-caching-in-network-applications.md)   
+ [\<requestCaching\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/requestcaching-element-network-settings.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/understanding-webrequest-problems-and-exceptions.md b/docs/framework/network-programming/understanding-webrequest-problems-and-exceptions.md
new file mode 100644
index 00000000000..c734b130e23
--- /dev/null
+++ b/docs/framework/network-programming/understanding-webrequest-problems-and-exceptions.md
@@ -0,0 +1,44 @@
+---
+title: "WebRequest の問題と例外について | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 74a361a5-e912-42d3-8f2e-8e9a96880a2b
+caps.latest.revision: 6
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 6
+---
+# WebRequest の問題と例外について
+<xref:System.Net.WebRequest> および派生クラス \(<xref:System.Net.HttpWebRequest>、<xref:System.Net.FtpWebRequest>と <xref:System.Net.FileWebRequest>\) が非常にステータスを通知するための例外を投げます。  場合によってはこれらの問題の解決策は明らかではありません。  
+  
+## 解決策  
+ 問題を確認するに <xref:System.Net.WebException> の <xref:System.Net.WebException.Status%2A> のプロパティを確認します。  次の表に、複数のステータスの値と考えられる決済を示します。  
+  
+|状態|詳細|解決方法|  
+|--------|--------|----------|  
+|<xref:System.Net.WebExceptionStatus><br /><br /> または<br /><br /> <xref:System.Net.WebExceptionStatus>|基になるソケットに問題があります。  接続がリセットされる場合があります。|要求を再接続し、再送信します。<br /><br /> 最新のサービス パックをインストールしてください。<br /><br /> <xref:System.Net.ServicePointManager.MaxServicePointIdleTime%2A?displayProperty=fullName> のプロパティの値を増やします。<br /><br /> \[<xref:System.Net.HttpWebRequest.KeepAlive%2A?displayProperty=fullName>\] を \[`false`\] に設定します。<br /><br /> <xref:System.Net.ServicePointManager.DefaultConnectionLimit%2A> のプロパティを含む最大の接続数を上げます。<br /><br /> プロキシ コンフィギュレーションを確認します。<br /><br /> SSL を使用している場合は、サーバー プロセスに証明書ストアをアクセス許可があることを確認します。<br /><br /> 大量のデータを送信する場合は、`false`に <xref:System.Net.HttpWebRequest.AllowWriteStreamBuffering%2A> を設定します。|  
+|<xref:System.Net.WebExceptionStatus>|サーバーる証明書ができませんでした。|Internet Explorer を使用して URI を開くとします。  IE によって表示される警報セキュリティを設定します。  セキュリティ警報を解決できない場合、<xref:System.Net.ICertificatePolicy> を `true`返品を実行し、<xref:System.Net.ServicePointManager.CertificatePolicy%2A>に渡す証明書のポリシーのクラスを作成できます。<br /><br /> 参照 [http:\/\/support.microsoft.com\/?id\=823177](http://go.microsoft.com/fwlink/?LinkID=179653)します。<br /><br /> サーバー証明書に署名する証明機関の証明書が Internet Explorer の信頼済証明機関の一覧に追加されることを確認します。<br /><br /> URL のホスト名がサーバー証明書の共通名と一致していることを確認します。|  
+|<xref:System.Net.WebExceptionStatus>|エラーが SSL のトランザクションの未収、または証明書問題があります。|.NET Framework Version 1.1 が SSL のバージョンのみ 3.0 はできません。  サーバーが TLS のバージョン 1.0 または 2.0 SSL のバージョンを使用すると、例外が投げられます。  .NET Framework Version 2.0 をにアップグレードし、サーバーに合わせて <xref:System.Net.ServicePointManager.SecurityProtocol%2A> を設定します。<br /><br /> 証明書クライアントとサーバーが信頼しない証明機関 \(CA\) が署名されています。  CA 証明書のサーバーをインストール。  " "を参照してください。[http:\/\/support.microsoft.com\/?id\=332077](http://go.microsoft.com/fwlink/?LinkID=179654)<br /><br /> 最新のサービス パックをインストールする必要があります。|  
+|<xref:System.Net.WebExceptionStatus>|接続に失敗しました。|ファイアウォールまたはプロキシは接続をブロック。  接続を許可する場合は、ファイアウォールまたはプロキシを変更します。<br /><br /> 明示的に <xref:System.Net.WebProxy> のコンストラクターの呼び出し、クライアント アプリケーションの <xref:System.Net.WebProxy> を表示します \(WebServiceProxyClass.Proxy \= 新しい WebProxy \([http:\/\/server:80](http://server/)、など\)。\)<br /><br /> ワーカー プロセス ID に WSPWSP.dll、HKLM \\ SYSTEM \\ CurrentControlSet \\ Services \\ DnsCache アクセスを必要なアクセス許可がまたは HKLM \\ SYSTEM \\ CurrentControlSet \\ Services \\ WinSock2 あることを確認するに Filemon または Regmon を実行します。|  
+|<xref:System.Net.WebExceptionStatus>|ドメイン ネーム サービスをホスト名を解決しませんでした。|プロキシを正しくコンフィギュレーションします。  " "を参照してください。[http:\/\/support.microsoft.com\/?id\=318140](http://go.microsoft.com/fwlink/?LinkID=179655)<br /><br /> インストール アンチウィルスのソフトウェアまたはファイアウォールが接続をブロックことを確認します。|  
+|<xref:System.Net.WebExceptionStatus>|<xref:System.Net.WebRequest.Abort%2A> 名前はされた、またはエラーが発生しました。|この問題は、クライアントまたはサーバーの連結負荷によって起こされる場合があります。  負荷の引き下げ。<br /><br /> <xref:System.Net.ServicePointManager.DefaultConnectionLimit%2A> の配置を上げます。<br /><br /> Web サービスの提供の設定を変更するに [http:\/\/support.microsoft.com\/?id\=821268](http://go.microsoft.com/fwlink/?LinkID=179656) は、" "を参照してください。|  
+|<xref:System.Net.WebExceptionStatus>|アプリケーションが既に閉じられているソケットに作成するに努めました。|クライアントまたはサーバーには過ぎられます。  負荷の引き下げ。<br /><br /> <xref:System.Net.ServicePointManager.DefaultConnectionLimit%2A> の配置を上げます。<br /><br /> Web サービスの提供の設定を変更するに [http:\/\/support.microsoft.com\/?id\=821268](http://go.microsoft.com/fwlink/?LinkID=179656) は、" "を参照してください。|  
+|<xref:System.Net.WebExceptionStatus>|メッセージの長さのそのほか \(<xref:System.Net.HttpWebRequest.MaximumResponseHeadersLength%2A>\) を超えています。|<xref:System.Net.HttpWebRequest.MaximumResponseHeadersLength%2A> のプロパティの値を増やします。|  
+|<xref:System.Net.WebExceptionStatus>|ドメイン ネーム サービスがプロキシのホスト名を解決しませんでした。|プロキシを正しくコンフィギュレーションします。  " "を参照してください。[http:\/\/support.microsoft.com\/?id\=318140](http://go.microsoft.com/fwlink/?LinkID=179655)<br /><br /> `null`に <xref:System.Net.HttpWebRequest.Proxy%2A> のプロパティを設定することにより、プロキシを使用するには、<xref:System.Net.HttpWebRequest> を強制的にします。|  
+|<xref:System.Net.WebExceptionStatus>|サーバーからの応答は有効な HTTP 応答ではありません。  この問題は HTTP サーバー 1.1 の RFC に適合しないことを .NET Framework が検出する際に。  この問題が応答に正しくないヘッダーを追加、または誤ったヘッダー delimiters.RFC 2616 がサーバーからの応答の HTTP 1.1 と有効な形式を定義するときに発生することがあります。  詳細については、[http:\/\/www.ietf.org](http://go.microsoft.com/fwlink/?LinkID=147388)" "を参照してください。|トランザクションのネットワーク追跡を取得し、回答のヘッダーを確認します。<br /><br /> \(これはセキュリティ問題にすることもできます\)、アプリケーションで分析せずにサーバーの応答が必要な場合は、コンフィギュレーション ファイルの `true` に `useUnsafeHeaderParsing` を設定します。  「[\<httpWebRequest\> 要素 \(ネットワーク設定\)](../../../docs/framework/configure-apps/file-schema/network/httpwebrequest-element-network-settings.md)」を参照してください。|  
+  
+## 参照  
+ <xref:System.Net.HttpWebRequest>   
+ <xref:System.Net.HttpWebResponse>   
+ <xref:System.Net.Dns>
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-a-synchronous-client-socket.md b/docs/framework/network-programming/using-a-synchronous-client-socket.md
new file mode 100644
index 00000000000..1f527d48a38
--- /dev/null
+++ b/docs/framework/network-programming/using-a-synchronous-client-socket.md
@@ -0,0 +1,85 @@
+---
+title: "同期クライアント ソケットの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "同期クライアント ソケット"
+  - "Socket クラス、同期クライアント ソケット"
+  - "受信 (データの)、ソケット"
+  - "ソケット、同期クライアント ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+  - "クライアント ソケット"
+ms.assetid: 945d00c6-7202-466c-9df9-140b84156d43
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 同期クライアント ソケットの使用
+クライアントの同期はソケット ネットワーク アクションが完了すると、アプリケーション プログラムを中断します。  同期はソケット工程のネットワーク大量に使用できる、他のアプリケーションのネットワーク サービスへの簡単なアクセスできるようにすることもできますアプリケーションに適していない。  
+  
+ データを送信するには、<xref:System.Net.Sockets.Socket> クラスの送信データの方法のうち 1 バイトを配列に出荷します \(<xref:System.Net.Sockets.Socket.Send%2A> と <xref:System.Net.Sockets.Socket.SendTo%2A>\)。  次の例では、<xref:System.Text.Encoding.ASCII%2A?displayProperty=fullName> のプロパティを使用してバイト配列のバッファ、文字列をエンコードし、ネットワークのデバイスに **\[送信\]** 方法を使用してバッファを送信します。  **\[送信\]** 方法は、ネットワークのデバイスに送信されるバイト数を返します。  
+  
+```vb  
+Dim msg As Byte() = _  
+    System.Text.Encoding.ASCII.GetBytes("This is a test.")  
+Dim bytesSent As Integer = s.Send(msg)  
+  
+```  
+  
+```csharp  
+byte[] msg = System.Text.Encoding.ASCII.GetBytes("This is a test");  
+int bytesSent = s.Send(msg);  
+```  
+  
+ **\[送信\]** 方法はバッファからバイトが削除され、ネットワークのデバイスに送信されるネットワークのインターフェイスでの列を作らせます。  接続が <xref:System.Net.Sockets.Socket.Shutdown%2A> 方法として通常、終了、ネットワークのインターフェイスはデータを直ちになく場合がありますが、最終的を送信します。  
+  
+ ネットワークのデバイスからデータを取得するには、**\[ソケット\]** クラスの受信データ メソッドのバッファを 1 に出荷します \(<xref:System.Net.Sockets.Socket.Receive%2A> と <xref:System.Net.Sockets.Socket.ReceiveFrom%2A>\)。  同期はバイト ソケットがネットワークから入庫またはソケットが閉じられるまでアプリケーションを中断します。  次の例では、ネットワーク、表示のデータをコンソールで表示されます。  たとえば、ネットワークから送られてくるデータが ASCII エンコードしたテキストであるとします。  **\[受信\]** 方法は、ネットワークから受け取ったバイト数を返します。  
+  
+```vb  
+Dim bytes(1024) As Byte  
+Dim bytesRec = s.Receive(bytes)  
+Console.WriteLine("Echoed text = {0}", _  
+    System.Text.Encoding.ASCII.GetString(bytes, 0, bytesRec))  
+  
+```  
+  
+```csharp  
+byte[] bytes = new byte[1024];  
+int bytesRec = s.Receive(bytes);  
+Console.WriteLine("Echoed text = {0}",  
+    System.Text.Encoding.ASCII.GetString(bytes, 0, bytesRec));  
+```  
+  
+ ソケットが不要にしない場合、<xref:System.Net.Sockets.Socket.Shutdown%2A> 方法を追加し、**\[閉じる\]** 方法をとしてそれをリリースする必要があります。  次の例では、**\[ソケット\]**をリリースします。  <xref:System.Net.Sockets.SocketShutdown> の列挙型はソケット、受け入れた送信については、またはの両方に終了するかどうかを指定する定数を定義します。  
+  
+```vb  
+s.Shutdown(SocketShutdown.Both)  
+s.Close()  
+```  
+  
+```csharp  
+s.Shutdown(SocketShutdown.Both);  
+s.Close();  
+```  
+  
+## 参照  
+ [非同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-client-socket.md)   
+ [リッスン \(ソケットで\)](../../../docs/framework/network-programming/listening-with-sockets.md)   
+ [同期クライアント ソケットの例](../../../docs/framework/network-programming/synchronous-client-socket-example.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-a-synchronous-server-socket.md b/docs/framework/network-programming/using-a-synchronous-server-socket.md
new file mode 100644
index 00000000000..8b67c7dc1cb
--- /dev/null
+++ b/docs/framework/network-programming/using-a-synchronous-server-socket.md
@@ -0,0 +1,89 @@
+---
+title: "同期サーバー ソケットの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "同期サーバー ソケット"
+  - "送信 (データの)、ソケット"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "サーバー ソケット"
+  - "受信 (データの)、ソケット"
+  - "ソケット クラス、非同期サーバー ソケット"
+  - "プロトコル、ソケット"
+  - "ソケット、同期サーバー ソケット"
+  - "インターネット、ソケット"
+ms.assetid: d1ce882e-653e-41f5-9289-844ec855b804
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# 同期サーバー ソケットの使用
+サーバーの同期はソケット接続要求がソケットに入庫されるまでアプリケーションの実行を中断します。  サーバーの同期はソケット工程ネットワークの大量に使用できる、簡易ネットワーク アプリケーションに適してようにアプリケーションに適していない。  
+  
+ <xref:System.Net.Sockets.Socket> が <xref:System.Net.Sockets.Socket.Bind%2A> と <xref:System.Net.Sockets.Socket.Listen%2A> 方法を使用してエンドポイントのリッスンに設定されていると、<xref:System.Net.Sockets.Socket.Accept%2A> 方法を使用して接続順を承認すると、準備が整いました。  アプリケーションは **\[同意する\]** 方法が呼び出されたときに接続要求を受け取るまで中断されます。  
+  
+ 接続要求を受け取った場合、**\[同意する\]** は、接続のクライアントに関連付けられている **\[ソケット\]** の新しいインスタンスを返します。  次の例は、クライアントからデータを読み、コンソールの表示、およびクライアントにデータを移動エコーします。  メッセージング プロトコルを **\[ソケット\]** は、その文字列「」\<EOF\>のマーキングをメッセージのデータ決算指定しません。  `listener`という **\[ソケット\]** をエンドポイントに初期化され、バインドされたとします。  
+  
+```vb  
+Console.WriteLine("Waiting for a connection...")  
+Dim handler As Socket = listener.Accept()  
+Dim data As String = Nothing  
+  
+While True  
+    bytes = New Byte(1024) {}  
+    Dim bytesRec As Integer = handler.Receive(bytes)  
+    data += Encoding.ASCII.GetString(bytes, 0, bytesRec)  
+    If data.IndexOf("<EOF>") > - 1 Then  
+        Exit While  
+    End If  
+End While  
+  
+Console.WriteLine("Text received : {0}", data)  
+  
+Dim msg As Byte() = Encoding.ASCII.GetBytes(data)  
+handler.Send(msg)  
+handler.Shutdown(SocketShutdown.Both)  
+handler.Close()  
+  
+```  
+  
+```csharp  
+Console.WriteLine("Waiting for a connection...");  
+Socket handler = listener.Accept();  
+String data = null;  
+  
+while (true) {  
+    bytes = new byte[1024];  
+    int bytesRec = handler.Receive(bytes);  
+    data += Encoding.ASCII.GetString(bytes,0,bytesRec);  
+    if (data.IndexOf("<EOF>") > -1) {  
+        break;  
+    }  
+}  
+  
+Console.WriteLine( "Text received : {0}", data);  
+  
+byte[] msg = Encoding.ASCII.GetBytes(data);  
+handler.Send(msg);  
+handler.Shutdown(SocketShutdown.Both);  
+handler.Close();  
+```  
+  
+## 参照  
+ [非同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-server-socket.md)   
+ [同期サーバー ソケットの例](../../../docs/framework/network-programming/synchronous-server-socket-example.md)   
+ [リッスン \(ソケットで\)](../../../docs/framework/network-programming/listening-with-sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-an-asynchronous-client-socket.md b/docs/framework/network-programming/using-an-asynchronous-client-socket.md
new file mode 100644
index 00000000000..5454faf4e79
--- /dev/null
+++ b/docs/framework/network-programming/using-an-asynchronous-client-socket.md
@@ -0,0 +1,304 @@
+---
+title: "非同期クライアント ソケットの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "データ要求、ソケット"
+  - "非同期クライアント ソケット"
+  - "Socket クラス、非同期クライアント ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "ソケット、非同期クライアント ソケット"
+  - "受信 (データの)、ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+  - "クライアント ソケット"
+ms.assetid: fd85bc88-e06c-467d-a30d-9fd7cffcfca1
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 12
+---
+# 非同期クライアント ソケットの使用
+非同期なクライアントのネットワークはソケット実行するアクションを待つ間アプリケーションを中断されなくなります。  代わりに、アプリケーションが元のスレッドで実行される作業のスレッド間、1 種類のネットワーク接続を処理するには、標準 .NET Framework 非同期のプログラミング モデルを使用します。  非同期なソケットは、大量を使用するか、ネットワークの進む前に実行する工程ネットワークを待つことができないアプリケーション用に適切です。  
+  
+ <xref:System.Net.Sockets.Socket> クラスは非同期な方法の .NET Framework のパターンに示す;。たとえば、同期の <xref:System.Net.Sockets.Socket.Receive%2A> 方法は <xref:System.Net.Sockets.Socket.EndReceive%2A> の非同期な <xref:System.Net.Sockets.Socket.BeginReceive%2A> および方法に対応します。  
+  
+ 非同期処理はコールバック方法は、工程の結果が返される必要があります。  自分のアプリケーションで結果を知る必要がなければ、コールバック方法は必要ではありません。  このセクションのコードの例は、方法を完了するには、ネットワークのデバイスがコールバック方法データおよびデータとコールバック方法を受け取ることを開始するために送信を完了するためのコールバック方法の送信を開始する接続を完了する方法、およびメソッドに接続を開始するにはなく、データが表示されます。  
+  
+ 非同期なソケットは、ネットワーク接続を処理するためにシステムのスレッド プールから複数のスレッドを使用します。  1 種類のスレッドは、データの送受信を開始する責任があります; そのほかすべてのネットワーク デバイスと送信への接続に通すまたはデータが表示されます。  次の例では、メイン スレッドの実行を中断し、実行をいつ続行するかを通知に、<xref:System.Threading.ManualResetEvent?displayProperty=fullName> クラスのインスタンスが使用されます。  
+  
+ 次の例では、非同期なソケットをネットワークのデバイスに接続するには、`Connect`方法は **\[ソケット\]** を初期化し、ネットワーク デバイス、接続のコールバック方法と非同期通話中のステータス情報を渡すために使用される、ステータス **\[ソケット\]**オブジェクト \(クライアント\) を表す、エンドポイントを渡す [BeginConnect](frlrfsystemnetsocketssocketclassconnecttopic) 方法を追加します。  例は、指定されたエンドポイントに指定 **\[ソケット\]** を関連付ける場合は、`Connect` 方法を実行します。  これは `connectDone`というグローバルな **\[ManualResetEvent\]** とします。  
+  
+```vb  
+Public Shared Sub Connect(remoteEP As EndPoint, client As Socket)  
+    client.BeginConnect(remoteEP, _  
+       AddressOf ConnectCallback, client)  
+  
+    connectDone.WaitOne()  
+End Sub 'Connect  
+```  
+  
+```csharp  
+public static void Connect(EndPoint remoteEP, Socket client) {  
+    client.BeginConnect(remoteEP,   
+        new AsyncCallback(ConnectCallback), client );  
+  
+   connectDone.WaitOne();  
+}  
+```  
+  
+ 接続のコールバック方法 `ConnectCallback` は <xref:System.AsyncCallback> の委任を実行します。  これは、リモート接続が **\[ManualResetEvent\]** デバイスに `connectDone`の配置に完全であることリモート デバイスが使用可能な接続し、アプリケーションのスレッドに信号を求める場合。  次のコードは `ConnectCallback` 方法を実行します。  
+  
+```vb  
+Private Shared Sub ConnectCallback(ar As IAsyncResult)  
+    Try  
+        ' Retrieve the socket from the state object.  
+        Dim client As Socket = CType(ar.AsyncState, Socket)  
+  
+        ' Complete the connection.  
+        client.EndConnect(ar)  
+  
+        Console.WriteLine("Socket connected to {0}", _  
+            client.RemoteEndPoint.ToString())  
+  
+        ' Signal that the connection has been made.  
+        connectDone.Set()  
+    Catch e As Exception  
+        Console.WriteLine(e.ToString())  
+    End Try  
+End Sub 'ConnectCallback  
+  
+```  
+  
+```csharp  
+private static void ConnectCallback(IAsyncResult ar) {  
+    try {  
+        // Retrieve the socket from the state object.  
+        Socket client = (Socket) ar.AsyncState;  
+  
+        // Complete the connection.  
+        client.EndConnect(ar);  
+  
+        Console.WriteLine("Socket connected to {0}",  
+            client.RemoteEndPoint.ToString());  
+  
+        // Signal that the connection has been made.  
+        connectDone.Set();  
+    } catch (Exception e) {  
+        Console.WriteLine(e.ToString());  
+    }  
+}  
+```  
+  
+ 例 `Send` 指定方法はソケットで表されるネットワークのデバイスに ASCII 形式と送信の特定の文字列のデータを、非同期的にエンコードします。  次の例では、`Send` 方法を実行します。  
+  
+```vb  
+Private Shared Sub Send(client As Socket, data As [String])  
+    ' Convert the string data to byte data using ASCII encoding.  
+    Dim byteData As Byte() = Encoding.ASCII.GetBytes(data)  
+  
+    ' Begin sending the data to the remote device.  
+    client.BeginSend(byteData, 0, byteData.Length, SocketFlags.None, _  
+        AddressOf SendCallback, client)  
+End Sub 'Send  
+  
+```  
+  
+```csharp  
+private static void Send(Socket client, String data) {  
+    // Convert the string data to byte data using ASCII encoding.  
+    byte[] byteData = Encoding.ASCII.GetBytes(data);  
+  
+    // Begin sending the data to the remote device.  
+    client.BeginSend(byteData, 0, byteData.Length, SocketFlags.None,  
+        new AsyncCallback(SendCallback), client);  
+}  
+```  
+  
+ コールバック送信方法 `SendCallback` は <xref:System.AsyncCallback> の委任を実行します。  これは、ネットワークのデバイスが受信する準備が整ったら、データを送信します。  次の例では、`SendCallback` 方法の手順を示します。  これは `sendDone`というグローバルな **\[ManualResetEvent\]** とします。  
+  
+```vb  
+Private Shared Sub SendCallback(ar As IAsyncResult)  
+    Try  
+        ' Retrieve the socket from the state object.  
+        Dim client As Socket = CType(ar.AsyncState, Socket)  
+  
+        ' Complete sending the data to the remote device.  
+        Dim bytesSent As Integer = client.EndSend(ar)  
+        Console.WriteLine("Sent {0} bytes to server.", bytesSent)  
+  
+        ' Signal that all bytes have been sent.  
+        sendDone.Set()  
+    Catch e As Exception  
+        Console.WriteLine(e.ToString())  
+    End Try  
+End Sub 'SendCallback  
+  
+```  
+  
+```csharp  
+private static void SendCallback(IAsyncResult ar) {  
+    try {  
+        // Retrieve the socket from the state object.  
+        Socket client = (Socket) ar.AsyncState;  
+  
+        // Complete sending the data to the remote device.  
+        int bytesSent = client.EndSend(ar);  
+        Console.WriteLine("Sent {0} bytes to server.", bytesSent);  
+  
+        // Signal that all bytes have been sent.  
+        sendDone.Set();  
+    } catch (Exception e) {  
+        Console.WriteLine(e.ToString());  
+    }  
+}  
+```  
+  
+ クライアントのソケットからのデータの読み取りと、非同期の呼び出しの間での値に合格ステータス オブジェクトが必要です。  次のクラスはソケットのクライアントからデータを取得するための例のステータス オブジェクトです。  これは、設定データの文字列を保留に表示されるデータのクライアントのソケット、バッファ、<xref:System.Text.StringBuilder> のフィールドが含まれます。  ステータス オブジェクトにこれらのフィールドの設定はソケット値でクライアントからデータを読み取る際に複数の呼び出しに管理されます。  
+  
+```vb  
+Public Class StateObject  
+    ' Client socket.  
+    Public workSocket As Socket = Nothing   
+    ' Size of receive buffer.  
+    Public BufferSize As Integer = 256  
+    ' Receive buffer.  
+    Public buffer(256) As Byte   
+    ' Received data string.  
+    Public sb As New StringBuilder()  
+End Class 'StateObject  
+  
+```  
+  
+```csharp  
+public class StateObject {  
+    // Client socket.  
+    public Socket workSocket = null;  
+    // Size of receive buffer.  
+    public const int BufferSize = 256;  
+    // Receive buffer.  
+    public byte[] buffer = new byte[BufferSize];  
+    // Received data string.  
+    public StringBuilder sb = new StringBuilder();  
+}  
+```  
+  
+ 例 `Receive` の方法は、ステータス対象を設定し、クライアントのソケットからデータを非同期的に読み取る場合に **BeginReceive** 方法を追加します。  次の例では、`Receive` 方法を実行します。  
+  
+```vb  
+Private Shared Sub Receive(client As Socket)  
+    Try  
+        ' Create the state object.  
+        Dim state As New StateObject()  
+        state.workSocket = client  
+  
+        ' Begin receiving the data from the remote device.  
+        client.BeginReceive(state.buffer, 0, state.BufferSize, 0, _  
+            AddressOf ReceiveCallback, state)  
+    Catch e As Exception  
+        Console.WriteLine(e.ToString())  
+    End Try  
+End Sub 'Receive  
+  
+```  
+  
+```csharp  
+private static void Receive(Socket client) {  
+    try {  
+        // Create the state object.  
+        StateObject state = new StateObject();  
+        state.workSocket = client;  
+  
+        // Begin receiving the data from the remote device.  
+        client.BeginReceive( state.buffer, 0, StateObject.BufferSize, 0,  
+            new AsyncCallback(ReceiveCallback), state);  
+    } catch (Exception e) {  
+        Console.WriteLine(e.ToString());  
+    }  
+}  
+```  
+  
+ 入庫のコールバック方法 `ReceiveCallback` は **AsyncCallback** の委任を実行します。  これは、ネットワークのデバイスからデータを取得し、メッセージの文字列を基づきます。  これは、バッファ データにクライアントが送信するデータが完了するまでネットワーク上のデータのバイトを読込み、を **BeginReceive** 方法をもう一度呼び出すします。  すべてのデータがクライアントから読まれれば、`ReceiveCallback`、データを **\[ManualResetEvent\]** `sendDone`の配置に完全であることアプリケーションのスレッドに信号を送信します。  
+  
+ 次のコードの例は、`ReceiveCallback`方法を実行します。  これは `response` という `receiveDone`受信したという文字列とグローバルな **\[ManualResetEvent\]** を保持するグローバルな文字列とします。  サーバーは、ネットワークのセッションを終了ためのクライアントのソケットを優雅に締めなければ必要があります。  
+  
+```vb  
+Private Shared Sub ReceiveCallback(ar As IAsyncResult)  
+    Try  
+        ' Retrieve the state object and the client socket   
+        ' from the asynchronous state object.  
+        Dim state As StateObject = CType(ar.AsyncState, StateObject)  
+        Dim client As Socket = state.workSocket  
+  
+        ' Read data from the remote device.  
+        Dim bytesRead As Integer = client.EndReceive(ar)  
+  
+        If bytesRead > 0 Then  
+            ' There might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(state.buffer, 0, _  
+                bytesRead))  
+  
+            '  Get the rest of the data.  
+            client.BeginReceive(state.buffer, 0, state.BufferSize, 0, _  
+                AddressOf ReceiveCallback, state)  
+        Else  
+            ' All the data has arrived; put it in response.  
+            If state.sb.Length > 1 Then  
+                response = state.sb.ToString()  
+            End If  
+            ' Signal that all bytes have been received.  
+            receiveDone.Set()  
+        End If  
+    Catch e As Exception  
+        Console.WriteLine(e.ToString())  
+    End Try  
+End Sub 'ReceiveCallback  
+  
+```  
+  
+```csharp  
+private static void ReceiveCallback( IAsyncResult ar ) {  
+    try {  
+        // Retrieve the state object and the client socket   
+        // from the asynchronous state object.  
+        StateObject state = (StateObject) ar.AsyncState;  
+        Socket client = state.workSocket;  
+        // Read data from the remote device.  
+        int bytesRead = client.EndReceive(ar);  
+        if (bytesRead > 0) {  
+            // There might be more data, so store the data received so far.  
+            state.sb.Append(Encoding.ASCII.GetString(state.buffer,0,bytesRead));  
+                //  Get the rest of the data.  
+            client.BeginReceive(state.buffer,0,StateObject.BufferSize,0,  
+                new AsyncCallback(ReceiveCallback), state);  
+        } else {  
+            // All the data has arrived; put it in response.  
+            if (state.sb.Length > 1) {  
+                response = state.sb.ToString();  
+            }  
+            // Signal that all bytes have been received.  
+            receiveDone.Set();  
+        }  
+    } catch (Exception e) {  
+        Console.WriteLine(e.ToString());  
+    }  
+}  
+```  
+  
+## 参照  
+ [同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-client-socket.md)   
+ [リッスン \(ソケットで\)](../../../docs/framework/network-programming/listening-with-sockets.md)   
+ [非同期クライアント ソケットの例](../../../docs/framework/network-programming/asynchronous-client-socket-example.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-an-asynchronous-server-socket.md b/docs/framework/network-programming/using-an-asynchronous-server-socket.md
new file mode 100644
index 00000000000..febd4815b69
--- /dev/null
+++ b/docs/framework/network-programming/using-an-asynchronous-server-socket.md
@@ -0,0 +1,278 @@
+---
+title: "非同期サーバー ソケットの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "ソケット クラス、非同期サーバー ソケット"
+  - "データ要求、ソケット"
+  - "ソケット、非同期サーバー ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "サーバー ソケット"
+  - "受信 (データの)、ソケット"
+  - "非同期サーバー ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+ms.assetid: 813489a9-3efd-41b6-a33f-371d55397676
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 11
+---
+# 非同期サーバー ソケットの使用
+非同期なサーバーはソケットのネットワーク サービス要求の処理に .NET Framework 非同期のプログラミング モデルを使用します。  <xref:System.Net.Sockets.Socket> のクラスが標準の .NET Framework 非同期示すなパターンに従います; たとえば、同期の <xref:System.Net.Sockets.Socket.Accept%2A> 方法は <xref:System.Net.Sockets.Socket.EndAccept%2A> の非同期な <xref:System.Net.Sockets.Socket.BeginAccept%2A> および方法に対応します。  
+  
+ 非同期なサーバーはソケット終了する方法がネットワーク、コールバック方法接続要求して、ネットワークからデータを取得し始めるとコールバック方法から接続要求を承認する際に要求します。データが表示されます。  これらの方法はすべてこのセクションでさらに説明します。  
+  
+ 次の例では、ネットワークから接続要求を承認を開始するには **\[ソケット\]** 方法 `StartListening` を初期化し、新しい接続を受け入れることを開始するに **BeginAccept** 方法を使用します。  承認のコールバック方法が新しい接続要求がソケットに入庫すると呼ばれます。  これは要求を処理するにそのスレッド接続 **\[ソケット\]** を渡すことが処理 **\[ソケット\]** のインスタンスを取得するために行う必要があります。  承認のコールバック方法は <xref:System.AsyncCallback> の委任を実行して; これは無効を返品した <xref:System.IAsyncResult>型の一つのパラメータを取ります。  次の例では、承認のコールバック方法のシェルです。  
+  
+```vb  
+Sub acceptCallback(ar As IAsyncResult)  
+    ' Add the callback code here.  
+End Sub 'acceptCallback  
+```  
+  
+```csharp  
+void acceptCallback( IAsyncResult ar) {  
+    // Add the callback code here.  
+}  
+```  
+  
+ **BeginAccept** 方法は、2 種類のパラメータ、承認のコールバック方法とコールバック方法のステータス情報を渡すために使用されるオブジェクトを表す **AsyncCallback** の委任を取ります。  次の例では、リッスン **\[ソケット\]** は、*州の* パラメータでコールバック方法に渡されます。  この例では、**AsyncCallback** の委任を作成し、ネットワークから接続を受け入れることを開始します。  
+  
+```vb  
+listener.BeginAccept( _  
+    New AsyncCallback(SocketListener.acceptCallback),_  
+    listener)  
+```  
+  
+```csharp  
+listener.BeginAccept(  
+    new AsyncCallback(SocketListener.acceptCallback),   
+    listener);  
+```  
+  
+ 非同期な設定はソケット接続を処理するためにシステムのスレッド プールからスレッドを使用します。  1 種類のスレッドは、接続を承認する責任があります。個々の接続を処理するために、別のスレッドが使用され、他のスレッドは、接続からデータを取得する責任があります。  これらはスレッドをスレッド プールに割り当てられている同じスレッドにすることができます。  次の例では、<xref:System.Threading.ManualResetEvent?displayProperty=fullName> のクラスが実装を続行すると、メイン スレッド信号の実行を中断します。  
+  
+ 次の例では、ローカル コンピュータの非同期の TCP\/IP ソケットを作成し、接続を受け付けるを開始する非同期な方法を示します。  方法が `SocketListener`というクラスのメンバであると、`acceptCallback` というコールバック方法が定義されると `allDone`というグローバルな **\[ManualResetEvent\]** があるとします。  
+  
+```vb  
+Public Sub StartListening()  
+    Dim ipHostInfo As IPHostEntry = Dns.Resolve(Dns.GetHostName())  
+    Dim localEP = New IPEndPoint(ipHostInfo.AddressList(0), 11000)  
+  
+    Console.WriteLine("Local address and port : {0}", localEP.ToString())  
+  
+    Dim listener As New Socket(localEP.Address.AddressFamily, _  
+       SocketType.Stream, ProtocolType.Tcp)  
+  
+    Try  
+        listener.Bind(localEP)  
+        listener.Listen(10)  
+  
+        While True  
+            allDone.Reset()  
+  
+            Console.WriteLine("Waiting for a connection...")  
+            listener.BeginAccept(New _  
+                AsyncCallback(SocketListener.acceptCallback), _  
+                listener)  
+  
+            allDone.WaitOne()  
+        End While  
+    Catch e As Exception  
+        Console.WriteLine(e.ToString())  
+    End Try  
+    Console.WriteLine("Closing the listener...")  
+End Sub 'StartListening  
+  
+```  
+  
+```csharp  
+public void StartListening() {  
+    IPHostEntry ipHostInfo = Dns.Resolve(Dns.GetHostName());  
+    IPEndPoint localEP = new IPEndPoint(ipHostInfo.AddressList[0],11000);  
+  
+    Console.WriteLine("Local address and port : {0}",localEP.ToString());  
+  
+    Socket listener = new Socket( localEP.Address.AddressFamily,  
+        SocketType.Stream, ProtocolType.Tcp );  
+  
+    try {  
+        listener.Bind(localEP);  
+        listener.Listen(10);  
+  
+        while (true) {  
+            allDone.Reset();  
+  
+            Console.WriteLine("Waiting for a connection...");  
+            listener.BeginAccept(  
+                new AsyncCallback(SocketListener.acceptCallback),   
+                listener );  
+  
+            allDone.WaitOne();  
+        }  
+    } catch (Exception e) {  
+        Console.WriteLine(e.ToString());  
+    }  
+  
+    Console.WriteLine( "Closing the listener...");  
+}  
+```  
+  
+ 承認のコールバック方法 \(前の例で`acceptCallback`\)、クライアントからのデータの処理し、クライアントを使用して接続を確立し、非同期を開始することがメイン アプリケーション スレッドを通知するために行う必要があります読みました。  次の例では、`acceptCallback` のメソッドの実装の最初の部分です。  このセクションの方法で処理することがメイン アプリケーション スレッドに信号を送信し、クライアントへの接続を設定します。  これは `allDone`というグローバルな **\[ManualResetEvent\]** とします。  
+  
+```vb  
+Public Sub acceptCallback(ar As IAsyncResult)  
+    allDone.Set()  
+  
+    Dim listener As Socket = CType(ar.AsyncState, Socket)  
+    Dim handler As Socket = listener.EndAccept(ar)  
+  
+    ' Additional code to read data goes here.  
+End Sub 'acceptCallback  
+```  
+  
+```csharp  
+public void acceptCallback(IAsyncResult ar) {  
+    allDone.Set();  
+  
+    Socket listener = (Socket) ar.AsyncState;  
+    Socket handler = listener.EndAccept(ar);  
+  
+    // Additional code to read data goes here.    
+}  
+```  
+  
+ クライアントのソケットからのデータの読み取りと、非同期の呼び出しの間での値に合格ステータス オブジェクトが必要です。  次の例では、リモート クライアントの文字列を表示する対象のステータスを実行します。  これは、データの入荷クライアントのバッファ ソケット、データ、およびクライアントが送信するデータの文字列の作成の <xref:System.Text.StringBuilder> のフィールドが含まれます。  ステータス オブジェクトにこれらのフィールドの設定はソケット値でクライアントからデータを読み取る際に複数の呼び出しに管理されます。  
+  
+```vb  
+Public Class StateObject  
+    Public workSocket As Socket = Nothing  
+    Public BufferSize As Integer = 1024  
+    Public buffer(BufferSize) As Byte  
+    Public sb As New StringBuilder()  
+End Class 'StateObject  
+```  
+  
+```csharp  
+public class StateObject {  
+    public Socket workSocket = null;  
+    public const int BufferSize = 1024;  
+    public byte[] buffer = new byte[BufferSize];  
+    public StringBuilder sb = new StringBuilder();  
+}  
+```  
+  
+ クライアントのソケットからのデータの最初に入庫を開始する `acceptCallback` 方法のセクションでは、`StateObject` クラスのインスタンスを初期化して、クライアントのソケットからデータを非同期的に読み取ることを開始するに <xref:System.Net.Sockets.Socket.BeginReceive%2A> 方法を追加します。  
+  
+ 次の例では、`acceptCallback` の完了原価方法を示します。  `StateObject` クラスが定義されている `readCallback` 方法がクラスで定義されている `SocketListener`を指定された `allDone,` というグローバルな **\[ManualResetEvent\]** があるとします。  
+  
+```vb  
+Public Shared Sub acceptCallback(ar As IAsyncResult)  
+    ' Get the socket that handles the client request.  
+    Dim listener As Socket = CType(ar.AsyncState, Socket)  
+    Dim handler As Socket = listener.EndAccept(ar)  
+  
+    ' Signal the main thread to continue.  
+    allDone.Set()  
+  
+    ' Create the state object.  
+    Dim state As New StateObject()  
+    state.workSocket = handler  
+    handler.BeginReceive(state.buffer, 0, state.BufferSize, 0, _  
+        AddressOf AsynchronousSocketListener.readCallback, state)  
+End Sub 'acceptCallback  
+  
+```  
+  
+```csharp  
+public static void acceptCallback(IAsyncResult ar) {  
+    // Get the socket that handles the client request.  
+    Socket listener = (Socket) ar.AsyncState;  
+    Socket handler = listener.EndAccept(ar);  
+  
+    // Signal the main thread to continue.  
+    allDone.Set();  
+  
+    // Create the state object.  
+    StateObject state = new StateObject();  
+    state.workSocket = handler;  
+    handler.BeginReceive( state.buffer, 0, StateObject.BufferSize, 0,  
+        new AsyncCallback(AsynchronousSocketListener.readCallback), state);  
+}  
+```  
+  
+ 非同期なソケット サーバーの実行する必要がある最終方法は、クライアントが送信するデータを返す読み取りコールバック方法です。  承認のコールバック方法と同様に、読み取りコールバック方法は **AsyncCallback** の必須です。  この方法はバッファ データにクライアントが送信するデータが完了するまでソケットのクライアントから一つ以上のバイトを読込み、を **BeginReceive** 方法をもう一度呼び出すします。  メッセージ全体がクライアントから読まれたらコンソールで、文字列が表示され、クライアントへの接続をサーバーの処理はソケット閉じられます。  
+  
+ 次のオプションが `readCallback` 方法を実行します。  `StateObject` クラスが定義されています。  
+  
+```vb  
+Public Shared Sub readCallback(ar As IAsyncResult)  
+    Dim state As StateObject = CType(ar.AsyncState, StateObject)  
+    Dim handler As Socket = state.workSocket  
+  
+    ' Read data from the client socket.   
+    Dim read As Integer = handler.EndReceive(ar)  
+  
+    ' Data was read from the client socket.  
+    If read > 0 Then  
+        state.sb.Append(Encoding.ASCII.GetString(state.buffer, 0, read))  
+        handler.BeginReceive(state.buffer, 0, state.BufferSize, 0, _  
+            AddressOf readCallback, state)  
+    Else  
+        If state.sb.Length > 1 Then  
+            ' All the data has been read from the client;  
+            ' display it on the console.  
+            Dim content As String = state.sb.ToString()  
+            Console.WriteLine("Read {0} bytes from socket." + _  
+                ControlChars.Cr + " Data : {1}", content.Length, content)  
+        End If  
+    End If  
+End Sub 'readCallback  
+  
+```  
+  
+```csharp  
+public static void readCallback(IAsyncResult ar) {  
+    StateObject state = (StateObject) ar.AsyncState;  
+    Socket handler = state.WorkSocket;  
+  
+    // Read data from the client socket.  
+    int read = handler.EndReceive(ar);  
+  
+    // Data was read from the client socket.  
+    if (read > 0) {  
+        state.sb.Append(Encoding.ASCII.GetString(state.buffer,0,read));  
+        handler.BeginReceive(state.buffer,0,StateObject.BufferSize, 0,  
+            new AsyncCallback(readCallback), state);  
+    } else {  
+        if (state.sb.Length > 1) {  
+            // All the data has been read from the client;  
+            // display it on the console.  
+            string content = state.sb.ToString();  
+            Console.WriteLine("Read {0} bytes from socket.\n Data : {1}",  
+               content.Length, content);  
+        }  
+        handler.Close();  
+    }  
+}  
+```  
+  
+## 参照  
+ [同期サーバー ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-server-socket.md)   
+ [非同期サーバー ソケットの例](../../../docs/framework/network-programming/asynchronous-server-socket-example.md)   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [リッスン \(ソケットで\)](../../../docs/framework/network-programming/listening-with-sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-application-protocols.md b/docs/framework/network-programming/using-application-protocols.md
new file mode 100644
index 00000000000..68f497d9b21
--- /dev/null
+++ b/docs/framework/network-programming/using-application-protocols.md
@@ -0,0 +1,39 @@
+---
+title: "アプリケーション プロトコルの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、種類"
+  - "プロトコル、アプリケーション"
+  - "ダウンロード (インターネット リソースの)、アプリケーション プロトコル"
+  - "送信 (データを)、アプリケーション プロトコル"
+  - "インターネット、アプリケーション プロトコル"
+  - "ネットワーク リソース、アプリケーション プロトコル"
+  - "応答 (インターネット要求へ)、アプリケーション プロトコル"
+  - "アプリケーション プロトコル"
+  - "受信 (データを)、アプリケーション プロトコル"
+  - "要求 (インターネットからデータを)、アプリケーション プロトコル"
+ms.assetid: 3aab4bcc-8397-4e1a-a1b6-bbd837a21430
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# アプリケーション プロトコルの使用
+.NET Framework サポートの一般的なインターネット プロトコル アプリケーション。  このセクションでは、注文のプロトコルを実行するに [&#91;Windows ソケット&#93;](../../../docs/framework/network-programming/sockets.md) インターフェイスの使用の [&#91;HTTP&#93;](../../../docs/framework/network-programming/http.md)の [&#91;TCP&#93;](../../../docs/framework/network-programming/tcp-udp.md)、および [UDP](../../../docs/framework/network-programming/tcp-udp.md) プロトコル、使用、情報の情報が含まれます。  
+  
+## 参照  
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [ネットワーク プログラミングのサンプル](../../../docs/framework/network-programming/network-programming-samples.md)   
+ [MSDN Code Gallery .NET のネットワーキングのサンプル](http://code.msdn.microsoft.com/Wiki/View.aspx?ProjectName=nclsamples)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-client-sockets.md b/docs/framework/network-programming/using-client-sockets.md
new file mode 100644
index 00000000000..8d6d2056a3c
--- /dev/null
+++ b/docs/framework/network-programming/using-client-sockets.md
@@ -0,0 +1,94 @@
+---
+title: "クライアント ソケットの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション プロトコル、ソケット"
+  - "送信 (データの)、ソケット"
+  - "データ要求、ソケット"
+  - "要求 (インターネットからデータを)、ソケット"
+  - "受信 (データの)、ソケット"
+  - "ソケット クラス、クライアント ソケット"
+  - "プロトコル、ソケット"
+  - "インターネット、ソケット"
+  - "ソケット、クライアント ソケット"
+  - "クライアント ソケット"
+ms.assetid: 81de9f59-8177-4d98-b25d-43fc32a98383
+caps.latest.revision: 12
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# クライアント ソケットの使用
+<xref:System.Net.Sockets.Socket>によって通話内容を開始する前に、アプリケーションとリモート デバイス間でデータのパイプを作成する必要があります。  そのほかのネットワーク アドレスとプロトコル ファミリがあるが、この例に示します。サービスへのリモート接続 TCP\/IP を作成する方法に。  
+  
+ TCP\/IP は、ネットワーク アドレスとサービスを識別するためにサービスのポート番号を使用します。  ネットワーク アドレスは、ネットワークの特定のデバイスを識別します; ポート番号は、関連付ける場合は、そのデバイスの特定のサービスを識別します。  ネットワーク アドレス、およびサービスのポートの組み合わせが <xref:System.Net.EndPoint> クラスが .NET Framework で使用するエンドポイントと呼ばれます。  **EndPoint** その子孫は、サポート住所ファミリに対して定義です; IP アドレス ファミリについては、クラスは、<xref:System.Net.IPEndPoint>です。  
+  
+ <xref:System.Net.Dns> クラスには、TCP\/IP インターネット サービスを使用するアプリケーションにドメインの名前でサービスを提供します。  <xref:System.Net.Dns.Resolve%2A> 方法は、数値インターネット アドレスにわかりやすいのドメイン名を host.contoso.com \(「」など\) にマップします。DNS サーバーをクエリ \(192.168.1.1\)。  **Resolve** は [IPHostEnty](frlrfsystemnetiphostentryclasstopic) を返します要求された名前の住所とエイリアスの一覧が表示されます。  ほとんどの場合、<xref:System.Net.IPHostEntry.AddressList%2A> のアレイで再び最初の住所を使用できます。  次のコードは host.contoso.com サーバーの IP アドレスを含む <xref:System.Net.IPAddress> が表示されます。  
+  
+```vb  
+Dim ipHostInfo As IPHostEntry = Dns.Resolve("host.contoso.com")  
+Dim ipAddress As IPAddress = ipHostInfo.AddressList(0)  
+  
+```  
+  
+```csharp  
+IPHostEntry ipHostInfo = Dns.Resolve("host.contoso.com");  
+IPAddress ipAddress = ipHostInfo.AddressList[0];  
+```  
+  
+ インター ネット住所を \(Iana\) 管理、共通のサービスのポート番号を定義します \(詳細については、www.iana.org\/assignments\/port\-numbers\) を参照してください。  他のサービス範囲は 1,024 に 65,535 のポート番号を登録できます。  次のコードはポート番号がリモート接続のエンドポイントを作成するには、host.contoso.com の IP アドレスを連結します。  
+  
+```vb  
+Dim ipe As New IPEndPoint(ipAddress, 11000)  
+  
+```  
+  
+```csharp  
+IPEndPoint ipe = new IPEndPoint(ipAddress,11000);  
+```  
+  
+ リモート デバイスの住所を決定する、接続に使用するポートを選択するとアプリケーションはリモート デバイスを使用して接続の設定を試みることができます。  次の例では、リモート デバイスに接続して既存の **IPEndPoint** を使用して、投げられる例外をつかまえます。  
+  
+```vb  
+Try  
+    s.Connect(ipe)  
+Catch ae As ArgumentNullException  
+    Console.WriteLine("ArgumentNullException : {0}", _  
+        ae.ToString())  
+Catch se As SocketException  
+    Console.WriteLine("SocketException : {0}", se.ToString())  
+Catch e As Exception  
+    Console.WriteLine("Unexpected exception : {0}", e.ToString())  
+End Try  
+  
+```  
+  
+```csharp  
+try {  
+    s.Connect(ipe);  
+} catch(ArgumentNullException ae) {  
+    Console.WriteLine("ArgumentNullException : {0}", ae.ToString());  
+} catch(SocketException se) {  
+    Console.WriteLine("SocketException : {0}", se.ToString());  
+} catch(Exception e) {  
+    Console.WriteLine("Unexpected exception : {0}", e.ToString());  
+}  
+```  
+  
+## 参照  
+ [同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-a-synchronous-client-socket.md)   
+ [非同期クライアント ソケットの使用](../../../docs/framework/network-programming/using-an-asynchronous-client-socket.md)   
+ [方法: ソケットを作成する](../../../docs/framework/network-programming/how-to-create-a-socket.md)   
+ [ソケット](../../../docs/framework/network-programming/sockets.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-secure-sockets-layer.md b/docs/framework/network-programming/using-secure-sockets-layer.md
new file mode 100644
index 00000000000..aac9b1d826f
--- /dev/null
+++ b/docs/framework/network-programming/using-secure-sockets-layer.md
@@ -0,0 +1,75 @@
+---
+title: "Secure Sockets Layerの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+  - "SSL"
+  - "Secure Sockets Layer"
+  - "インターネットからのデータ要求、Secure Sockets Layer"
+  - "データの送信、Secure Sockets Layer"
+  - "ネットワーク リソース"
+  - "データ要求、Secure Sockets Layer"
+  - "データの受信、Secure Sockets Layer"
+  - "インターネット、Secure Sockets Layer"
+ms.assetid: 6e4289e6-d1b7-4e82-ab0d-e83e3b6063ed
+caps.latest.revision: 14
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 14
+---
+# Secure Sockets Layerの使用
+<xref:System.Net> のクラスが複数のネットワーク セキュリティの接続を暗号化するには Secure Sockets Layer \(SSL\) を使用します。  
+  
+ http の接続の場合は、<xref:System.Net.WebRequest> と <xref:System.Net.WebResponse> のクラスが SSL をサポートする Web ホストと通信するために SSL を使用します。  SSL を使用する決定を特定 URI に基づいて <xref:System.Net.WebRequest> クラスが、行われます。  URI の「https から始まれば: 」、SSL が使用されます; URI が「http から始まれば: 」、非暗号化の接続が使用されます。  
+  
+ ファイル Transfer Protocol \(FTP\) で SSL を使用するには、<xref:System.Net.FtpWebRequest.GetResponse>を追加する前に調整するに <xref:System.Net.FtpWebRequest.EnableSsl> のプロパティを設定します。  同様に、Simple Mail 転送プロトコル \(SMTP\) を使用して、SSL は、電子メールを送信する前に調整するに <xref:System.Net.Mail.SmtpClient.EnableSsl> のプロパティを設定します。  
+  
+ <xref:System.Net.Security.SslStream> のクラスが SSL にストリーム ベースの抽象的概念を示し、SSL のハンドシェイクをコンフィギュレーションする方法を説明します。  
+  
+## 例  
+  
+### コード  
+  
+```vb  
+Dim MyURI As String = "https://www.contoso.com/"  
+Dim Wreq As WebRequest = WebRequest.Create(MyURI)  
+  
+Dim serverUri As String = "ftp://ftp.contoso.com/file.txt"  
+Dim request As FtpWebRequest = CType(WebRequest.Create(serverUri), FtpWebRequest)  
+request.Method = WebRequestMethods.Ftp.DeleteFile  
+request.EnableSsl = True  
+Dim response As FtpWebResponse = CType(request.GetResponse(), FtpWebResponse)  
+```  
+  
+```csharp  
+String MyURI = "https://www.contoso.com/";  
+WebRequest WReq = WebRequest.Create(MyURI);  
+  
+String serverUri = "ftp://ftp.contoso.com/file.txt"  
+FtpWebRequest request = (FtpWebRequest)WebRequest.Create(serverUri);  
+request.EnableSsl = true;  
+request.Method = WebRequestMethods.Ftp.DeleteFile;  
+FtpWebResponse response = (FtpWebResponse)request.GetResponse();  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   **\[System.Net\]** の名前空間への参照。  
+  
+## 参照  
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)   
+ [.NET Framework のネットワーク プログラミング](../../../docs/framework/network-programming/index.md)   
+ [証明書の選択と検証](../../../docs/framework/network-programming/certificate-selection-and-validation.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-streams-on-the-network.md b/docs/framework/network-programming/using-streams-on-the-network.md
new file mode 100644
index 00000000000..c93194723a2
--- /dev/null
+++ b/docs/framework/network-programming/using-streams-on-the-network.md
@@ -0,0 +1,115 @@
+---
+title: "ネットワーク上でストリームを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "要求 (インターネットからデータを)、ストリーム"
+  - "ネットワーク"
+  - "インターネット要求への応答、ストリーム"
+  - "ネットワーク リソース、ストリームの機能"
+  - "受信 (データを)、ストリームの機能"
+  - "ネットワーク リソース"
+  - "送信 (データを)、ストリームの機能"
+  - "ダウンロード (インターネット リソースの)、ストリーム"
+  - "ストリーム、機能"
+  - "インターネット、ストリーム"
+  - "ストリーム"
+ms.assetid: 02b05fba-7235-45ce-94e5-060436ee0875
+caps.latest.revision: 10
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 10
+---
+# ネットワーク上でストリームを使用する
+ネットワーク リソース ベースとしては、.NET Framework で表されます。  ストリームを総称的に処理することによって、.NET Framework は次の機能を提供します:  
+  
+-   Web データを送受信する一般的な方法。  データを送受信するために、HTML — XML ファイル、または物別のタイプ—の実際の内容が、アプリケーション <xref:System.IO.Stream.Write%2A?displayProperty=fullName> と <xref:System.IO.Stream.Read%2A?displayProperty=fullName> を使用する任意。  
+  
+-   .NET Framework にストリームと互換性。  ストリームは、.NET Framework 使用されますが、それらを処理するための下部組織で、豊富な。  たとえば、ストリームを初期化するいくつかのコード行を変更して <xref:System.Net.Sockets.NetworkStream> のデータを代わりに読み取る場合に <xref:System.IO.FileStream> の XML データの読み取りアプリケーションを変更できます。  **\[NetworkStream\]** クラスと他のベースとの主な違いは、<xref:System.Net.Sockets.NetworkStream.CanSeek%2A> のプロパティ常に返します **false**を **\[NetworkStream\]** が seekable ではないことで、<xref:System.Net.Sockets.NetworkStream.Seek%2A> と <xref:System.Net.Sockets.NetworkStream.Position%2A> 方法は <xref:System.NotSupportedException>を投げます。  
+  
+-   間に合うようにデータの処理。  ストリームは提供します。ダウンロードする全体のデータ セットを待つ、アプリケーションを強制的する代わりに、ネットワークから入庫としてデータへのアクセスを。  
+  
+ <xref:System.Net.Sockets> の名前空間は、ネットワーク リソース用の <xref:System.IO.Stream> クラスのみを実行する **\[NetworkStream\]** クラスなどがあります。  <xref:System.Net.Sockets> の名前空間のクラスがストリームを表すために **\[NetworkStream\]** クラスを使用します。  
+  
+ 返品ストリームを使用してネットワークにデータを送信するには、の <xref:System.Net.WebRequest>の <xref:System.Net.WebRequest.GetRequestStream%2A> を追加します。  **\[WebRequest\]** はサーバーに要求を送信;ヘッダー その後、ネットワーク リソースに戻すストリームの <xref:System.IO.Stream.BeginWrite%2A>、<xref:System.IO.Stream.EndWrite%2A>、または <xref:System.IO.Stream.Write%2A> メソッド呼び出し、データを送信できます。  あるプロトコル、HTTP などのデータを送信する前にプロトコル対応するプロパティを設定する必要があります。  次のコード例では、データを送信するための Http 固有のプロパティを設定する方法を示します。  変数 `sendData` が送信するデータを含むされている変数 `sendLength` が送信するデータのバイト数であるとします。  
+  
+```csharp  
+HttpWebRequest request =   
+   (HttpWebRequest) WebRequest.Create("http://www.contoso.com/");  
+request.Method = "POST";  
+request.ContentLength = sendLength;  
+try  
+{  
+   Stream sendStream = request.GetRequestStream();  
+   sendStream.Write(sendData,0,sendLength);  
+   sendStream.Close();  
+}  
+catch  
+{  
+   // Handle errors . . .  
+}  
+  
+```  
+  
+```vb  
+Dim request As HttpWebRequest = _  
+   CType(WebRequest.Create("http://www.contoso.com/"), HttpWebRequest)  
+request.Method = "POST"  
+request.ContentLength = sendLength  
+Try  
+   Dim sendStream As Stream = request.GetRequestStream()  
+   sendStream.Write(sendData, 0, sendLength)  
+   sendStream.Close()  
+Catch  
+   ' Handle errors . . .  
+End Try  
+```  
+  
+ ネットワークからデータを取得するには、の <xref:System.Net.WebResponse>の <xref:System.Net.WebResponse.GetResponseStream%2A> を追加します。  <xref:System.IO.Stream.BeginRead%2A>、<xref:System.IO.Stream.EndRead%2A>、または返品ストリームで <xref:System.IO.Stream.Read%2A> の方法として、ネットワーク リソースのデータの読み取りできます。  
+  
+ ネットワーク リソースからストリームを使用する場合、次の点を考えに留めてしてください:  
+  
+-   **\[CanSeek\]** のプロパティは **\[NetworkStream\]** クラスがストリームの位置を変更できなくなります **false** を常に返します。  **\[シーク\]** と **\[位置\]** 方法は **NotSupportedException**を投げます。  
+  
+-   **\[WebRequest\]** と **WebResponse**を使用すると、**GetResponseStream** の呼び出し、作成されたストリームのインスタンスは読み取り専用です **GetRequestStream** の呼び出し、作成されたストリームのインスタンスは、評価減専用です。  
+  
+-   エンコードを容易にするために <xref:System.IO.StreamReader> クラスを使用します。  次の例は **WebResponse** コードの ASCII ストリームを読み取るエンコードされたに **StreamReader** を使用します \(例は、要求を作成することなく\) を示します。  
+  
+-   **GetResponse** への電話のネットワーク リソースを使用できない場合はブロックできます。  <xref:System.Net.WebRequest.BeginGetResponse%2A> と <xref:System.Net.WebRequest.EndGetResponse%2A> 方法の非同期要求を使用することを考慮する必要があります。  
+  
+-   **GetRequestStream** への電話のサーバーへの接続が作成され、ブロックできます。  <xref:System.Net.WebRequest.BeginGetRequestStream%2A> と <xref:System.Net.WebRequest.EndGetRequestStream%2A> 方法のベースに対して非同期要求を使用することを考慮する必要があります。  
+  
+```csharp  
+// Create a response object.  
+WebResponse response = request.GetResponse();  
+// Get a readable stream from the server.  
+StreamReader sr =   
+   new StreamReader(response.GetResponseStream(), Encoding.ASCII);  
+// Use the stream. Remember when you are through with the stream to close it.  
+sr.Close();  
+```  
+  
+```vb  
+' Create a response object.  
+Dim response As WebResponse = request.GetResponse()  
+' Get a readable stream from the server.  
+Dim sr As _   
+   New StreamReader(response.GetResponseStream(), Encoding.ASCII)  
+' Use the stream. Remember when you are through with the stream to close it.  
+sr.Close()  
+```  
+  
+## 参照  
+ [方法: WebRequest クラスを使用してデータを要求する](../../../docs/framework/network-programming/how-to-request-data-using-the-webrequest-class.md)   
+ [データの要求](../../../docs/framework/network-programming/requesting-data.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-tcp-services.md b/docs/framework/network-programming/using-tcp-services.md
new file mode 100644
index 00000000000..415b85f9f2c
--- /dev/null
+++ b/docs/framework/network-programming/using-tcp-services.md
@@ -0,0 +1,206 @@
+---
+title: "TCP サービスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "要求 (インターネットからデータを)、TCP"
+  - "受信 (データを)、TCP"
+  - "TcpClient クラス、TcpClient クラスについて"
+  - "データ要求、TCP"
+  - "アプリケーション プロトコル、TCP"
+  - "ネットワーク リソース、TCP"
+  - "送信 (データを)、TCP"
+  - "TCP"
+  - "プロトコル、TCP"
+  - "インターネット、TCP"
+ms.assetid: d2811830-3bcb-495c-b82d-cda9cf919aad
+caps.latest.revision: 11
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# TCP サービスの使用
+<xref:System.Net.Sockets.TcpClient> のクラスが TCP を使用してインターネットのリソースのデータが必要です。  **TcpClient** 方法およびプロパティは、TCP を使用してデータを要求と入荷の <xref:System.Net.Sockets.Socket> を作成するための詳細を追加します。  デバイスへのリモート接続がストリームとして示されるため、データが技術をストリーム処理と .NET Framework 読み取られ、作成できます。  
+  
+ 次に TCP プロトコルは、データ パケットを送受信する接続エンドポイントと使用による接続を設定します。  TCP が着荷ときにデータ パケットがエンドポイントに送信され、正しい順序で組み立てことを確認する担当者があります。  
+  
+ TCP への接続を確立するには、必要な通信するために使用するサービスが TCP ポートはサービスをホストするネットワークのデバイスの住所がわかります。  インター ネット住所を \(Iana\) 管理、共通のサービスのポート番号を定義します \(www.iana.org\/assignments\/port\-numbers\) を参照してください。  Iana の一覧のサービスはない範囲 1,024 に 65,535 のポート番号を使用できます。  
+  
+ 次の例では、TCP ポート 13 でタイム サーバーに接続する **TcpClient** が設定されていることを示します。  
+  
+```vb  
+Imports System  
+Imports System.Net.Sockets  
+Imports System.Text  
+  
+Public Class TcpTimeClient  
+    Private const portNum As Integer = 13  
+    Private const hostName As String = "host.contoso.com"  
+  
+    ' Entry point  that delegates to C-style main Private Function.  
+    Public Overloads Shared Sub Main()  
+        System.Environment.ExitCode = _  
+            Main(System.Environment.GetCommandLineArgs())  
+    End Sub  
+  
+    Overloads Public Shared Function Main(args() As [String]) As Integer  
+        Try  
+            Dim client As New TcpClient(hostName, portNum)  
+  
+            Dim ns As NetworkStream = client.GetStream()  
+  
+            Dim bytes(1024) As Byte  
+            Dim bytesRead As Integer = ns.Read(bytes, 0, bytes.Length)  
+  
+            Console.WriteLine(Encoding.ASCII.GetString(bytes, 0, bytesRead))  
+  
+        Catch e As Exception  
+            Console.WriteLine(e.ToString())  
+        End Try  
+  
+        client.Close()  
+  
+        Return 0  
+    End Function 'Main  
+End Class 'TcpTimeClient  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+public class TcpTimeClient {  
+    private const int portNum = 13;  
+    private const string hostName = "host.contoso.com";  
+  
+    public static int Main(String[] args) {  
+        try {  
+            TcpClient client = new TcpClient(hostName, portNum);  
+  
+            NetworkStream ns = client.GetStream();  
+  
+            byte[] bytes = new byte[1024];  
+            int bytesRead = ns.Read(bytes, 0, bytes.Length);  
+  
+            Console.WriteLine(Encoding.ASCII.GetString(bytes,0,bytesRead));  
+  
+            client.Close();  
+  
+        } catch (Exception e) {  
+            Console.WriteLine(e.ToString());  
+        }  
+  
+        return 0;  
+    }  
+}  
+```  
+  
+ <xref:System.Net.Sockets.TcpListener> がクライアントへの接続を管理する着呼要求の TCP ポートを監視し、**\[ソケット\]** を **TcpClient** を作成するために使用されます。  <xref:System.Net.Sockets.TcpListener.Start%2A> 方法がリッスン有効にし、<xref:System.Net.Sockets.TcpListener.Stop%2A> 方法でポートがリッスン無効にします。  <xref:System.Net.Sockets.TcpListener.AcceptTcpClient%2A> 方法は、フォワード接続を承認し、要求を処理するために **TcpClient** を作成および <xref:System.Net.Sockets.TcpListener.AcceptSocket%2A> 方法の承認を接続を要求の処理に **\[ソケット\]** を要求し、作成します。  
+  
+ 次の例は、モニターの TCP ポート 13 に **TcpListener** を使用してネットワークのタイム サーバーを作成することを示します。  フォワード接続の要求が承認されると、タイム サーバーがホスト サーバーから現在の日時に回答します。  
+  
+```vb  
+Imports System  
+Imports System.Net.Sockets  
+Imports System.Text  
+  
+Public Class TcpTimeServer  
+  
+    Private const portNum As Integer = 13  
+  
+    ' Entry point that delegates to C-style main Private Function.  
+    Public Overloads Shared Sub Main()  
+        System.Environment.ExitCode = _  
+            Main(System.Environment.GetCommandLineArgs())  
+    End Sub  
+  
+    Overloads Public Shared Function Main(args() As [String]) As Integer  
+        Dim done As Boolean = False  
+  
+        Dim listener As New TcpListener(portNum)  
+  
+        listener.Start()  
+  
+        While Not done  
+            Console.Write("Waiting for connection...")  
+            Dim client As TcpClient = listener.AcceptTcpClient()  
+  
+            Console.WriteLine("Connection accepted.")  
+            Dim ns As NetworkStream = client.GetStream()  
+  
+            Dim byteTime As Byte() = _  
+                Encoding.ASCII.GetBytes(DateTime.Now.ToString())  
+  
+            Try  
+                ns.Write(byteTime, 0, byteTime.Length)  
+                ns.Close()  
+                client.Close()  
+            Catch e As Exception  
+                Console.WriteLine(e.ToString())  
+            End Try  
+        End While  
+  
+        listener.Stop()  
+  
+        Return 0  
+    End Function 'Main  
+End Class 'TcpTimeServer  
+```  
+  
+```csharp  
+using System;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+public class TcpTimeServer {  
+  
+    private const int portNum = 13;  
+  
+    public static int Main(String[] args) {  
+        bool done = false;  
+  
+        TcpListener listener = new TcpListener(portNum);  
+  
+        listener.Start();  
+  
+        while (!done) {  
+            Console.Write("Waiting for connection...");  
+            TcpClient client = listener.AcceptTcpClient();  
+  
+            Console.WriteLine("Connection accepted.");  
+            NetworkStream ns = client.GetStream();  
+  
+            byte[] byteTime = Encoding.ASCII.GetBytes(DateTime.Now.ToString());  
+  
+            try {  
+                ns.Write(byteTime, 0, byteTime.Length);  
+                ns.Close();  
+                client.Close();  
+            } catch (Exception e) {  
+                Console.WriteLine(e.ToString());  
+            }  
+        }  
+  
+        listener.Stop();  
+  
+        return 0;  
+    }  
+  
+}  
+```  
+  
+## 参照  
+ [TCP\/UDP](../../../docs/framework/network-programming/tcp-udp.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/using-udp-services.md b/docs/framework/network-programming/using-udp-services.md
new file mode 100644
index 00000000000..c9ec0db9b1b
--- /dev/null
+++ b/docs/framework/network-programming/using-udp-services.md
@@ -0,0 +1,187 @@
+---
+title: "UDP サービスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロトコル、UDP"
+  - "ネットワーク リソース、UDP"
+  - "要求 (インターネットからデータを)、UDP"
+  - "UDP"
+  - "受信 (データを)、UDP"
+  - "インターネット、UDP"
+  - "複数のアドレスへのメッセージのブロードキャスト"
+  - "データ要求、UDP"
+  - "UdpClient クラス、UdpClient クラスについて"
+  - "送信 (データを)、UDP"
+  - "アプリケーション プロトコル、UDP"
+ms.assetid: d5c3477a-e798-454c-a890-738ba14c5707
+caps.latest.revision: 15
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 13
+---
+# UDP サービスの使用
+<xref:System.Net.Sockets.UdpClient> のクラスは、UDP を使用してネットワーク サービスと通信します。  <xref:System.Net.Sockets.UdpClient> クラスおよびメソッドのプロパティは、UDP を使用してデータを要求と入荷の <xref:System.Net.Sockets.Socket> の作成の詳細を追加します。  
+  
+ ユーザー データグラム Protocol \(UDP\) はリモート ホストにデータを提供するのに最適な努力をする簡単なプロトコルです。  ただし、UDP プロトコルがコネクションレスなプロトコルであるため、リモート エンドポイントに送信される UDP データグラムが着荷対して保証する \(送信\) 同じ順序で到着に対して保証します。  UDP を使用するアプリケーションが不足している、重複および注文が狂ってデータグラムを処理するために準備する必要があります。  
+  
+ に UDP を使用してデータグラムを送信するには、通信するために、サービスを利用する UDP ポート番号必要なサービスをホストしているネットワーク デバイスのネットワーク アドレスを把握している必要があります。  インター ネット住所を \(Iana\) 管理、共通のサービスのポート番号を定義します \(www.iana.org\/assignments\/port\-numbers\) を参照してください。  Iana の一覧のサービスはない範囲 1,024 に 65,535 のポート番号を使用できます。  
+  
+ 特別ネットワーク IP アドレスがベースのネットワーク UDP 配信メッセージをサポートするために使用されます。  次の議論は、インターネットで、例として使用される IP \(バージョン 4 の住所のファミリーを使用します。  
+  
+ IP \(バージョン 4 の住所がネットワーク アドレスを指定するには、32 ビットのコードを使用します。  255.255.255.0 の netmask を使用してクラス C の住所に、これらのオブジェクトは 4 人のオクテットに分けられます。  小数点以下 10 桁で表現した場合、4 人のオクテットは 192.168.100.2 など、知られた点を打クォードの表記を、フォームで行います。  最初の 2 人のオクテット \(この例では、192.168\) は、ネットワーク番号を、3 番目のオクテット \(100\) を定義します \(2\) によってホストの ID である最終オクテットとサブネットが表示されます。  
+  
+ 1 種類の IP アドレスのすべてのオブジェクト、またはフォームの 255.255.255.255 制限されます。住所を設定します  この住所 UDP データグラムの送信は、ローカル ネットワークの区分のすべてのホストにメッセージを提供します。  このアドレスに送信される、ルーターの順方向メッセージの区分のネットワーク ホスト配信のみメッセージが表示されないので。  
+  
+ 配信は、ネットワークの特定の部分でホストの ID のすべてのオブジェクトの設定によって指示できます。  たとえば、192.168.1 と開始する IP アドレスによって識別されるすべてのネットワーク ホストのに配信を送信するに 192.168.1.255 住所を使用します。  
+  
+ 次のコード例は、ポート 11,000 の指示済配信 192.168.1.255 アドレスに送信される UDP データグラム聴覚にそばを立てるに <xref:System.Net.Sockets.UdpClient> を使用します。  クライアントはメッセージの文字列が表示され、コンソールに書き込んだり。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Text  
+  
+Public Class UDPListener  
+   Private Const listenPort As Integer = 11000  
+  
+   Private Shared Sub StartListener()  
+      Dim done As Boolean = False  
+      Dim listener As New UdpClient(listenPort)  
+      Dim groupEP As New IPEndPoint(IPAddress.Any, listenPort)  
+      Try  
+         While Not done  
+            Console.WriteLine("Waiting for broadcast")  
+            Dim bytes As Byte() = listener.Receive(groupEP)  
+            Console.WriteLine("Received broadcast from {0} :", _  
+                groupEP.ToString())   
+            Console.WriteLine( _  
+                Encoding.ASCII.GetString(bytes, 0, bytes.Length))  
+            Console.WriteLine()  
+         End While  
+      Catch e As Exception  
+         Console.WriteLine(e.ToString())  
+      Finally  
+         listener.Close()  
+      End Try  
+   End Sub 'StartListener  
+  
+   Public Shared Function Main() As Integer  
+      StartListener()  
+      Return 0  
+   End Function 'Main  
+End Class 'UDPListener  
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+public class UDPListener   
+{  
+    private const int listenPort = 11000;  
+  
+    private static void StartListener()   
+    {  
+        bool done = false;  
+  
+        UdpClient listener = new UdpClient(listenPort);  
+        IPEndPoint groupEP = new IPEndPoint(IPAddress.Any,listenPort);  
+  
+        try   
+        {  
+            while (!done)   
+            {  
+                Console.WriteLine("Waiting for broadcast");  
+                byte[] bytes = listener.Receive( ref groupEP);  
+  
+                Console.WriteLine("Received broadcast from {0} :\n {1}\n",  
+                    groupEP.ToString(),  
+                    Encoding.ASCII.GetString(bytes,0,bytes.Length));  
+            }  
+  
+        }   
+        catch (Exception e)   
+        {  
+            Console.WriteLine(e.ToString());  
+        }  
+        finally  
+        {  
+            listener.Close();  
+        }  
+    }  
+  
+    public static int Main()   
+    {  
+        StartListener();  
+  
+        return 0;  
+    }  
+}  
+```  
+  
+ 次の例は、ポート 11,000 コードを使用して指示済配信住所 192.168.1.255 に UDP データグラムを送信するに <xref:System.Net.Sockets.UdpClient> を使用します。  クライアントはコマンド ラインで指定されたメッセージの文字列を送信します。  
+  
+```vb  
+Imports System  
+Imports System.Net  
+Imports System.Net.Sockets  
+Imports System.Text  
+  
+Public Class Program  
+  
+    Overloads Public Shared Function Main(args() As [String]) As Integer  
+      Dim s As New Socket(AddressFamily.InterNetwork, SocketType.Dgram,  
+          ProtocolType.Udp)  
+      Dim broadcast As IPAddress = IPAddress.Parse("192.168.1.255")  
+      Dim sendbuf As Byte() = Encoding.ASCII.GetBytes(args(0))  
+      Dim ep As New IPEndPoint(broadcast, 11000)  
+      s.SendTo(sendbuf, ep)  
+      Console.WriteLine("Message sent to the broadcast address")  
+   End Function 'Main  
+End Class   
+```  
+  
+```csharp  
+using System;  
+using System.Net;  
+using System.Net.Sockets;  
+using System.Text;  
+  
+class Program   
+{  
+    static void Main(string[] args)   
+    {  
+        Socket s = new Socket(AddressFamily.InterNetwork, SocketType.Dgram,  
+            ProtocolType.Udp);  
+  
+        IPAddress broadcast = IPAddress.Parse("192.168.1.255");  
+  
+        byte[] sendbuf = Encoding.ASCII.GetBytes(args[0]);  
+        IPEndPoint ep = new IPEndPoint(broadcast, 11000);  
+  
+        s.SendTo(sendbuf, ep);  
+  
+        Console.WriteLine("Message sent to the broadcast address");  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Net.Sockets.UdpClient>   
+ <xref:System.Net.IPAddress>   
+ [TCP\/UDP](../../../docs/framework/network-programming/tcp-udp.md)
\ No newline at end of file
diff --git a/docs/framework/network-programming/web-and-socket-permissions.md b/docs/framework/network-programming/web-and-socket-permissions.md
new file mode 100644
index 00000000000..afef8861d74
--- /dev/null
+++ b/docs/framework/network-programming/web-and-socket-permissions.md
@@ -0,0 +1,48 @@
+---
+title: "Web およびソケットのアクセス許可 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク"
+  - "位置 [.NET Framework]、受け入れ"
+  - "ソケット、アクセス許可"
+  - "ネットワーク、アクセス許可"
+  - "インターネット、アクセス許可"
+  - "ネットワーク リソース"
+  - "SocketPermission クラス、SocketPermission クラスについて"
+  - "位置 [.NET Framework]、接続"
+  - "WebPermission クラス、WebPermission クラスについて"
+  - "アクセス許可 [.NET Framework]、ソケット"
+  - "セキュリティ [.NET Framework]、インターネット"
+  - "位置 [.NET Framework]、付与"
+ms.assetid: d51ad8cb-03ae-4a51-bfcd-cfcf6b98afa9
+caps.latest.revision: 9
+author: "mcleblanc"
+ms.author: "markl"
+manager: "markl"
+caps.handback.revision: 9
+---
+# Web およびソケットのアクセス許可
+<xref:System.Net> の名前空間を使用してアプリケーションのインターネットのセキュリティは <xref:System.Net.WebPermission> と <xref:System.Net.SocketPermission> クラスが提供されます。  **\[WebPermission\]** のクラスが URI のデータが必要か、またはインターネットに URI に役立つアプリケーションの権限を制御します。  **\[SocketPermission\]** クラスは、ローカル ポートのデータを受け入れるか、ソケット ホストのポート番号、および転送プロトコルのような住所で転送プロトコルを使用して、リモート デバイスに連絡するに <xref:System.Net.Sockets.Socket> を使用するアプリケーションの権限を制御します。  
+  
+ アクセス許可、クラスを使用するかは、のアプリケ ション タイプによって。  <xref:System.Net.WebRequest> と子孫を使用するアプリケーションは、アクセス許可を管理するに **\[WebPermission\]** クラスを使用する必要があります。  ソケット レベルのアクセスを使用するアプリケーションは、アクセス許可を管理するに **\[SocketPermission\]** クラスを使用する必要があります。  
+  
+ **\[WebPermission\]** と **\[SocketPermission\]** は、2 種類のアクセス許可を定義します: 受け入れ、接続します。  承認はアプリケーションに別のパーティーからフォワード接続を応答権限を与えます。  接続をアプリケーションに別のパーティーへの接続を開始する権限を与えます。  
+  
+ **\[SocketPermission\]** のインスタンスに、承認は、アプリケーションがローカル配送先住所を接続を受け付けるできることを示します; アプリケーションがリモート \(またはローカル\) 配送先住所に接続できることを示します接続します。  
+  
+ **\[WebPermission\]** のインスタンスに、承認は、アプリケーションが世界に **\[WebPermission\]** によって制御される URI をエクスポートするということです; \(、またはローカルかどうか\) アプリケーションでその URI にアクセスできるようにする接続します。  
+  
+## 参照  
+ [セキュリティ](../../../docs/standard/security/index.md)   
+ [ネットワーク プログラミングにおけるセキュリティ](../../../docs/framework/network-programming/security-in-network-programming.md)
\ No newline at end of file
diff --git a/docs/framework/performance/TOC.md b/docs/framework/performance/TOC.md
new file mode 100644
index 00000000000..ba2be9152c7
--- /dev/null
+++ b/docs/framework/performance/TOC.md
@@ -0,0 +1,29 @@
+# [CLR ETW キーワードおよびレベル](clr-etw-keywords-and-levels.md)
+# [スタック イベント](stack-etw-event.md)
+# [スレッド プール イベント](thread-pool-etw-events.md)
+# [ガベージ コレクション イベント](garbage-collection-etw-events.md)
+# [CLR ETW イベント](clr-etw-events.md)
+# [相互運用イベント](interop-etw-events.md)
+# [ARM のイベント](application-domain-resource-monitoring-arm-etw-events.md)
+# [.NET Framework の ETW イベント](etw-events.md)
+# [信頼性に関するベスト プラクティス](reliability-best-practices.md)
+# [.NET Framework のログ記録の制御](controlling-logging.md)
+# [ローダー イベント](loader-etw-events.md)
+# [.NET Framework アプリケーションでのキャッシュ](caching-in-net-framework-applications.md)
+# [Performance](index.md)
+# [パフォーマンスに関するヒント](performance-tips.md)
+# [制約された実行領域](constrained-execution-regions.md)
+# [JIT トレース イベント](jit-tracing-etw-events.md)
+# [方法: オブジェクトの遅延初期化を実行する](how-to-perform-lazy-initialization-of-objects.md)
+# [タスク並列ライブラリおよび PLINQ での ETW イベント](etw-events-in-task-parallel-library-and-plinq.md)
+# [SQL Server プログラミングとホスト保護属性](sql-server-programming-and-host-protection-attributes.md)
+# [競合イベント](contention-etw-events.md)
+# [ランタイム情報イベント](runtime-information-etw-events.md)
+# [共通言語ランタイムの ETW イベント](etw-events-in-the-common-language-runtime.md)
+# [限定的な初期化](lazy-initialization.md)
+# [信頼性](reliability.md)
+# [メソッド イベント](method-etw-events.md)
+# [規模が大きく、応答性の高い .NET Framework アプリの作成](writing-large-responsive-apps.md)
+# [セキュリティ イベント](security-etw-events.md)
+# [Exception Thrown_V1 イベント](exception-thrown-v1-etw-event.md)
+# [CLR ETW プロバイダー](clr-etw-providers.md)
diff --git a/docs/framework/performance/application-domain-resource-monitoring-arm-etw-events.md b/docs/framework/performance/application-domain-resource-monitoring-arm-etw-events.md
new file mode 100644
index 00000000000..95456eb9254
--- /dev/null
+++ b/docs/framework/performance/application-domain-resource-monitoring-arm-etw-events.md
@@ -0,0 +1,165 @@
+---
+title: "アプリケーション ドメインのリソース監視 (ARM) ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ドメインの監視イベント [.NET Framework]"
+  - "ETW, アプリケーション ドメインの監視イベント"
+ms.assetid: d38ff268-a2ee-434e-b504-d570880e0289
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アプリケーション ドメインのリソース監視 (ARM) ETW イベント
+<a name="top"></a> これらのイベントは、アプリケーション ドメインの状態に関する詳細な診断の情報を提供します。 これらのイベントを使用することもできますが、アプリケーション ドメインのリソース監視 \(ARM\) の機能を使用しても同じ情報を得られます。  
+  
+ このカテゴリは、次のイベントで構成されます。  
+  
+-   [ThreadCreated イベント](#threadcreated_event)  
+  
+-   [AppDomainMemAllocated イベント](#appdomainmemallocated_event)  
+  
+-   [AppDomainMemSurvived イベント](#appdomainmemsurvived_event)  
+  
+-   [ThreadAppDomainEnter イベント](#threadappdomainenter_event)  
+  
+-   [ThreadTerminated イベント](#threadterminated_event)  
+  
+<a name="threadcreated_event"></a>   
+## ThreadCreated イベント  
+ このイベントは、ランダウン プロバイダーで `ThreadDC` としても発生します  \(`AppDomainResourceManagementRundownKeyword` キーワードで発生\)。 これは、このカテゴリでランダウン プロバイダーで発生する唯一のイベントです。  
+  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementKeyword` \(0x800\)|情報通知 \(4\)|  
+|`ThreadingKeyword` \(0x10000\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ThreadCreated`|85|アプリケーション ドメインに対してスレッドが作成された。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ThreadID|win:UInt64|作成されたスレッドの ID。|  
+|AppDomainID|win:UInt64|スレッドのアクティビティの報告対象のアプリケーション ドメインの識別子。|  
+|フラグ|win:UInt32|スレッドの作成フラグ|  
+|ManagedThreadIndex|win:UInt32|作成されたスレッドのマネージ インデックス。|  
+|OSThreadID|win:UInt32|作成されたスレッドのオペレーティング システム ID。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="appdomainmemallocated_event"></a>   
+## AppDomainMemAllocated イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementKeyword` \(0x800\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`AppDomainMemAllocated`|83|アプリケーション ドメインに 4 MB ずつのメモリ \(概算\) が割り当てられる。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AppDomainID|win:UInt64|リソースの使用状況の報告対象のアプリケーション ドメインの識別子。|  
+|Allocated|win:UInt64|アプリケーション ドメインが作成されてから、このアプリケーション ドメインに割り当てられたバイトの合計数 \(解放されたメモリの量は引かれない\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="appdomainmemsurvived_event"></a>   
+## AppDomainMemSurvived イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementKeyword` \(0x800\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`AppDomainMemSurvived`|84|各ガベージ コレクションが終了した。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AppDomainID|win:UInt64|リソースの使用状況の報告対象のドメインの識別子。|  
+|Survived|win:UInt64|最後のコレクションの実行後に残され、このアプリケーション ドメインによって保持されることが判明しているバイト数。 この数は、完全なコレクションの後では正確で完全ですが、短期コレクションの後では完全ではない可能性があります。|  
+|ProcessSurvived|win:UInt64|最後のコレクション後に残った合計バイト数。 完全なコレクションの後では、この数はマネージ ヒープにライブで保持されるバイト数を表します。 短期コレクションの後では、この数は短期のジェネレーションにライブで保持されるバイト数を表します。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="threadappdomainenter_event"></a>   
+## ThreadAppDomainEnter イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementKeyword` \(0x800\)|情報通知 \(4\)|  
+|`ThreadingKeyword` \(0x10000\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ThreadAppDomainEnter`|87|アプリケーション ドメインにスレッドが入力される。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ThreadID|win:UInt64|スレッド ID です|  
+|AppDomainID|win:UInt64|アプリケーション ドメインの識別子。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="threadterminated_event"></a>   
+## ThreadTerminated イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementKeyword` \(0x800\)|情報通知 \(4\)|  
+|`ThreadingKeyword` \(0x10000\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ThreadTerminated`|86|スレッドが終了する。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ThreadID|win:UInt64|スレッド ID です|  
+|AppDomainID|win:UInt64|アプリケーション ドメインの識別子。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/caching-in-net-framework-applications.md b/docs/framework/performance/caching-in-net-framework-applications.md
new file mode 100644
index 00000000000..e4243ee8105
--- /dev/null
+++ b/docs/framework/performance/caching-in-net-framework-applications.md
@@ -0,0 +1,89 @@
+---
+title: ".NET Framework アプリケーションでのキャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ASP.NET のキャッシュ"
+  - "キャッシュ [.NET Framework]"
+  - "キャッシュ [ASP.NET]"
+ms.assetid: c4b47ee0-4b82-4124-9bce-818088385e34
+caps.latest.revision: 26
+author: "tdykstra"
+ms.author: "tdykstra"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# .NET Framework アプリケーションでのキャッシュ
+キャッシュを使用するとメモリにデータを格納しておくことができるのですぐにアクセスできます。  データに再度アクセスするとき、アプリケーションは元のソースからデータを取得する代わりにキャッシュからデータを取得できます。  これにより、パフォーマンスとスケーラビリティが向上します。  さらにキャッシュを使用するとデータ ソースが一時的に使用できない場合もデータが使用可能になります。  
+  
+ .NET Framework のキャッシュ機能を使用すると、Windows のクライアント アプリケーションとサーバー アプリケーション \(ASP.NET を含む\) の両方のパフォーマンスとスケーラビリティが向上します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] 以前のバージョンでは、ASP.NET の <xref:System.Web.Caching> 名前空間にメモリ内キャッシュの実装が含まれていました。  以前のバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、<xref:System.Web> 名前空間でしかキャッシュを使用できないため、ASP.NET クラスに対する依存関係が必要になります。  .NET Framework 4 では、<xref:System.Runtime.Caching> 名前空間に、Web アプリケーションでも Web アプリケーション以外でも使用できるように設計された API が用意されています。  
+  
+## キャッシュされたデータ  
+ 情報のキャッシュは、<xref:System.Runtime.Caching> 名前空間のクラスを使用して行うことができます。  この名前空間のキャッシュ クラスには次の機能があります。  
+  
+-   カスタム キャッシュ実装を作成する基盤となる抽象型  
+  
+-   メモリ内オブジェクト キャッシュの具象実装  
+  
+ 抽象基本キャッシュ クラス \(<xref:System.Runtime.Caching.ObjectCache>\) で、次のキャッシュ操作を定義します。  
+  
+-   キャッシュ エントリの作成と管理  
+  
+-   有効期限と削除の情報の指定  
+  
+-   キャッシュ エントリの変更に応答して発生するイベントのトリガー  
+  
+ <xref:System.Runtime.Caching.MemoryCache> クラスは、<xref:System.Runtime.Caching.ObjectCache> クラスのメモリ内オブジェクト キャッシュの実装です。  <xref:System.Runtime.Caching.MemoryCache> クラスを使用して、ほとんどのキャッシュ操作を実行できます。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Caching.MemoryCache> クラスは、<xref:System.Web.Caching> 名前空間で定義される ASP.NET キャッシュ オブジェクトを原型としています。  そのため、内部キャッシュ ロジックは、以前のバージョンの ASP.NET のロジックに似ています。  
+  
+ WPF アプリケーションでキャッシュを使用する方法の例については、「[チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)」を参照してください。  
+  
+## ASP.NET アプリケーションにおけるキャッシュ  
+ <xref:System.Runtime.Caching> 名前空間のキャッシュ クラスには、ASP.NET でデータをキャッシュするための機能が用意されています。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] 以前のバージョンを対象とするアプリケーションの場合は、<xref:System.Web.Caching> 名前空間に定義されているキャッシュ クラスを使用する必要があります。  詳細については、「[ASP.NET Caching Overview](../Topic/ASP.NET%20Caching%20Overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  新しいアプリケーションを開発するときは、<xref:System.Runtime.Caching.MemoryCache> クラスを使用することをお勧めします。  <xref:System.Runtime.Caching> 名前空間の API は、<xref:System.Web.Caching.Cache> 名前空間の API に似ています。  そのため、以前のバージョンの ASP.NET でキャッシュを使用したことがあれば、この API もすぐに理解できます。ASP.NET アプリケーションでキャッシュを使用する方法の例については、「[Walkthrough: Caching Application Data in ASP.NET](../Topic/Walkthrough:%20Caching%20Application%20Data%20in%20ASP.NET.md)」を参照してください。  
+  
+### 出力のキャッシュ  
+ アプリケーション データを手動でキャッシュするには、ASP.NET の <xref:System.Runtime.Caching.MemoryCache> クラスを使用します。ASP.NET では、出力キャッシュもサポートされており、ページ、コントロール、および HTTP 応答の生成された出力をメモリに格納することができます。  出力キャッシュを構成するには、ASP.NET Web ページで宣言するか、Web.config ファイルの設定を使用します。  詳細については、「[caching の outputCache 要素 \(ASP.NET 設定スキーマ\)](http://msdn.microsoft.com/ja-jp/47cd2b47-316f-4dfd-bbf8-539be3066fee)」を参照してください。  
+  
+ ASP.NET では、カスタム出力キャッシュ プロバイダーを作成して出力キャッシュを拡張できます。  カスタム プロバイダーを使用することで、キャッシュされた内容を、ディスク、クラウド ストレージ、分散キャッシュ エンジンなどの他のストレージ デバイスに格納することができます。  カスタム出力キャッシュ プロバイダーを作成するには、<xref:System.Web.Caching.OutputCacheProvider> クラスから派生するクラスを作成し、そのカスタム出力キャッシュ プロバイダーを使用するようにアプリケーションを構成します。  
+  
+## WCF REST サービスにおけるキャッシュ  
+ .NET Framework では、WCF REST サービスに、ASP.NET で提供されている宣言による出力キャッシュを利用できます。このため、WCF REST サービス操作からの応答をキャッシュできます。  キャッシュ用に構成されているサービスに対してユーザーが HTTP GET 要求を送信すると、ASP.NET はキャッシュされた応答を送り返し、サービス メソッドは呼び出されません。  キャッシュの有効期限が切れると、次にユーザーが HTTP GET 要求を送信したときに、サービス メソッドが呼び出され、応答が再度キャッシュされます。  
+  
+ .NET Framework では、条件付き HTTP GET キャッシュを実装することもできます。  そのほかのシナリオでは、"に説明されているように、インテリジェントな HTTP キャッシュを実装するために、HTTP GET の要求がサービスでよく使用 [HTTP 固有](http://go.microsoft.com/fwlink/?LinkId=165800)されます。  詳細については、参照します [WCF Web HTTP サービスのキャッシュ サポート](http://go.microsoft.com/fwlink/?LinkId=184598)。  
+  
+## .NET Framework のキャッシュの拡張  
+ .NET Framework のキャッシュは拡張できるように設計されています。  <xref:System.Runtime.Caching.ObjectCache> クラスを使用して、カスタム キャッシュ実装を作成することができます。  このクラスには、Windows フォーム、Windows Presentation Foundation \(WPF\)、Windows Communications Foundation \(WCF\) などのあらゆるマネージ アプリケーションで使用できるメンバーが用意されています。  キャッシュの拡張は、別のストレージ機構を使用するキャッシュ クラスを作成したり、キャッシュ操作を詳しく制御したりする場合に行います。  
+  
+ キャッシュを拡張するには、次の操作を行います。  
+  
+-   <xref:System.Runtime.Caching.ObjectCache> クラスから派生するカスタム クラスを作成し、その派生クラスにカスタム キャッシュを実装します。  
+  
+-   <xref:System.Runtime.Caching.MemoryCache> クラスから派生するクラスを作成し、その派生クラスをカスタマイズまたは拡張します。  その方法の例については、"を参照してください [ASP.NET アプリケーションの Caching Application Data by Using Multiple Cache オブジェクト](http://blogs.msdn.com/aspnetue/archive/2010/03/22/caching-application-data-by-using-multiple-cache-objects-in-an-asp-net-application.aspx)。  
+  
+-   <xref:System.Web.Caching.OutputCacheProvider> クラスから派生するクラスを作成し、そのカスタム出力キャッシュ プロバイダーを使用するようにアプリケーションを構成します。  
+  
+ 詳細については、Scott Guthrie のブログ [ASP.NET 4 の Extensible Output Caching \(and .NET 2010 対 4.0 のシリーズ\)](http://go.microsoft.com/fwlink/?LinkId=185772) のエントリを参照します。  
+  
+## 参照  
+ <xref:System.Runtime.Caching.ObjectCache>   
+ <xref:System.Runtime.Caching.MemoryCache>   
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)   
+ [Walkthrough: Caching Application Data in ASP.NET](../Topic/Walkthrough:%20Caching%20Application%20Data%20in%20ASP.NET.md)
\ No newline at end of file
diff --git a/docs/framework/performance/clr-etw-events.md b/docs/framework/performance/clr-etw-events.md
new file mode 100644
index 00000000000..eaf1d715037
--- /dev/null
+++ b/docs/framework/performance/clr-etw-events.md
@@ -0,0 +1,75 @@
+---
+title: "CLR ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR ETW イベント"
+  - "ETW, CLR イベント"
+  - "ETW, 共通言語ランタイム"
+ms.assetid: ef2b31c3-7426-43e7-9924-92339b96556d
+caps.latest.revision: 45
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 45
+---
+# CLR ETW イベント
+このセクションのトピックでは、Windows イベント トレーシング \(ETW: Event Tracing for Windows\) イベントについて説明します。  各イベントには、キーワードとレベルが関連付けられています。キーワードとレベルについては、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」で説明します。  CLR には、イベント用のプロバイダーとして次の 2 つがあります。  
+  
+-   ランタイム プロバイダー。これは、有効になっているキーワードに応じてイベントを発生させます \(キーワードとはイベントのカテゴリです\)。  CLR ランタイム プロバイダーの GUID は e13c0d23\-ccbc\-4e12\-931b\-d9cc2eee27e4 です。  
+  
+-   ランダウン プロバイダー。これには特殊な用途があります。  CLR ランダウン プロバイダーの GUID は a669021c\-c450\-4609\-a035\-5af59af4df18 です。  
+  
+ プロバイダーの詳細については、「[CLR ETW プロバイダー](../../../docs/framework/performance/clr-etw-providers.md)」を参照してください。  
+  
+## このセクションの内容  
+ [ランタイム情報イベント](../../../docs/framework/performance/runtime-information-etw-events.md)  
+ SKU、バージョン番号、アクティブ化の方法、起動時に使用されたコマンド ライン パラメーター、GUID \(該当する場合\) などのランタイムに関する情報をキャプチャします。  
+  
+ [Exception Thrown\_V1 イベント](../../../docs/framework/performance/exception-thrown-v1-etw-event.md)  
+ スローされた例外に関する情報をキャプチャします。  
+  
+ [競合イベント](../../../docs/framework/performance/contention-etw-events.md)  
+ ランタイムが使用するモニター ロックまたはネイティブ ロックの競合に関する情報をキャプチャします。  
+  
+ [スレッド プール イベント](../../../docs/framework/performance/thread-pool-etw-events.md)  
+ ワーカー スレッド プールと I\/O スレッド プールに関する情報をキャプチャします。  
+  
+ [ローダー イベント](../../../docs/framework/performance/loader-etw-events.md)  
+ アプリケーション ドメイン、アセンブリ、およびモジュールの読み込みとアンロードに関する情報をキャプチャします。  
+  
+ [メソッド イベント](../../../docs/framework/performance/method-etw-events.md)  
+ シンボルを解決するための CLR メソッドに関する情報をキャプチャします。  
+  
+ [ガベージ コレクション イベント](../../../docs/framework/performance/garbage-collection-etw-events.md)  
+ ガベージ コレクションに関する情報をキャプチャして、診断とデバッグに役立つ情報を取得します。  
+  
+ [JIT トレース イベント](../../../docs/framework/performance/jit-tracing-etw-events.md)  
+ Just\-In\-Time \(JIT\) のインライン展開と tail 呼び出しに関する情報をキャプチャします。  
+  
+ [相互運用イベント](../../../docs/framework/performance/interop-etw-events.md)  
+ MSIL \(Microsoft Intermediate Language\) のスタブの生成とキャッシュに関する情報をキャプチャします。  
+  
+ [ARM のイベント](../../../docs/framework/performance/application-domain-resource-monitoring-arm-etw-events.md)  
+ アプリケーション ドメインの状態に関する詳細な診断情報をキャプチャします。  
+  
+ [セキュリティ イベント](../../../docs/framework/performance/security-etw-events.md)  
+ 厳密な名前と Authenticode の検証に関する情報をキャプチャします。  
+  
+ [スタック イベント](../../../docs/framework/performance/stack-etw-event.md)  
+ イベントの発生後にスタック トレースを生成するために他のイベントと共に使用される情報をキャプチャします。  
+  
+## 参照  
+ [ETW のデバッグおよびパフォーマンス調整を改善します。](http://go.microsoft.com/fwlink/?LinkId=179696)   
+ [Windows パフォーマンス ブログ](http://go.microsoft.com/fwlink/?LinkId=179509)   
+ [.NET Framework のログ記録の制御](../../../docs/framework/performance/controlling-logging.md)   
+ [CLR ETW プロバイダー](../../../docs/framework/performance/clr-etw-providers.md)   
+ [CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)   
+ [共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/performance/clr-etw-keywords-and-levels.md b/docs/framework/performance/clr-etw-keywords-and-levels.md
new file mode 100644
index 00000000000..26a67431487
--- /dev/null
+++ b/docs/framework/performance/clr-etw-keywords-and-levels.md
@@ -0,0 +1,133 @@
+---
+title: "CLR ETW キーワードおよびレベル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR ETW キーワード"
+  - "CLR ETW レベル"
+  - "ETW, CLR キーワード"
+  - "ETW, CLR レベル"
+ms.assetid: fdf5856d-516b-4042-849d-911c4518a6cb
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# CLR ETW キーワードおよびレベル
+<a name="top"></a> Windows \(ETW\) イベントのイベント トレースは、カテゴリとレベルによってフィルター処理できます。 イベントの [CLR ETW キーワード](#keywords)は、イベントをカテゴリ別にフィルタ処理できます。これらはランタイム プロバイダーとランダウン プロバイダー用に組み合わせて使用します。[イベント レベル](#levels)は、フラグによって識別されます。  
+  
+<a name="keywords"></a>   
+## CLR ETW キーワード  
+ キーワードは、組み合わせて値を生成できるフラグです。 実際には、コマンド ライン ユーティリティを呼び出す際に、キーワード名ではなくキーワードの 16 進数の値を使用します。  
+  
+ これらのキーワードの説明を次の表に示します。  
+  
+-   [CLR ETW ランタイム キーワード](#runtime)  
+  
+-   [CLR ETW ランダウン キーワード](#rundown)  
+  
+-   [ランタイム プロバイダーのシンボル解決のキーワードの組み合わせ](#runtime_combo)  
+  
+-   [ランダウン プロバイダーのシンボル解決のキーワードの組み合わせ](#rundown_combo)  
+  
+<a name="runtime"></a>   
+### CLR ETW ランタイム キーワード  
+ CLR ETW のランタイム キーワード、その値、およびその用途を次の表に示します。  
+  
+|ランタイム キーワード名|値|目的|  
+|------------------|-------|--------|  
+|`GCKeyword`|0x00000001|[ガベージ コレクション イベント](../../../docs/framework/performance/garbage-collection-etw-events.md)のコレクションを有効にします。|  
+|`LoaderKeyword`|0x00000008|[ローダー イベント](../../../docs/framework/performance/loader-etw-events.md)のコレクションを有効にします。|  
+|`JITKeyword`|0x00000010|[Just\-In\-Time \(JIT\) イベント](../../../docs/framework/performance/jit-tracing-etw-events.md)のコレクションを可能にします。|  
+|`NGenKeyword`|0x00000020|ネイティブ イメージ メソッド \(ネイティブ イメージ ジェネレーター、Ngen.exe によって処理されるメソッド\) のイベントの収集を可能にします。`StartEnumerationKeyword` と `EndEnumerationKeyword` で使用します。 このキーワードには高いオーバーヘッドが設定されています。 読み込まれたすべての NGen モジュールの中すべてのメソッドに対してイベントを生成します。 可能であれば、このキーワードを使用する代わりに、プロファイリング ツールによって生成されたプログラム データベース \(PDB\) を使用して、NGen モジュールからメソッドに関する情報を取得することをお勧めします。 この表で後述する `OverrideAndSuppressNGenEventsKeyword` も参照してください。|  
+|`StartEnumerationKeyword`|0x00000040|ランタイム内のすべてのメソッドの列挙を有効にします。`NGenKeyword`と組み合わせて使用します。|  
+|`EndEnumerationKeyword`|0x00000080|ランタイム内の破棄されたすべてのメソッドの列挙を有効にします。`JITKeyword`と`NGenKeyword`を組み合わせて使用します。|  
+|`SecurityKeyword`|0x00000400|[セキュリティ イベント](../../../docs/framework/performance/security-etw-events.md)のコレクションを有効にします。|  
+|`AppDomainResourceManagementKeyword`|0x00000800|アプリケーション ドメイン レベルでのリソース監視イベントのコレクションを有効にします。|  
+|`JITTracingKeyword`|0x00001000|[JIT トレース イベント](../../../docs/framework/performance/jit-tracing-etw-events.md)のコレクションを有効にします。|  
+|`InteropKeyword`|0x00002000|[相互運用イベント](../../../docs/framework/performance/interop-etw-events.md)のコレクションを有効にします。|  
+|`ContentionKeyword`|0x00004000|[競合イベント](../../../docs/framework/performance/contention-etw-events.md)のコレクションを有効にします。|  
+|`ExceptionKeyword`|0x00008000|[例外イベント](../../../docs/framework/performance/exception-thrown-v1-etw-event.md)のコレクションを有効にします。|  
+|`ThreadingKeyword`|0x00010000|[スレッド プール イベント](../../../docs/framework/performance/thread-pool-etw-events.md)のコレクションを有効にします。|  
+|`OverrideAndSuppressNGenEventsKeyword`|0x00040000|\([!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降で使用可能。\) 高いオーバーヘッドの `NGenKeyword` キーワードを非表示にし、NGen モジュール内にあるメソッドのイベントが生成されないようにします。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、プロファイル ツールは `OverrideAndSuppressNGenEventsKeyword` と `NGenKeyword` を一緒に使用して、NGen モジュール内のメソッドのイベントの生成を抑制します。 これにより、プロファイル ツールはより効率的な NGen PDB を使用して NGen モジュール内のメソッドに関する情報を取得できます。 .NET Framework 4 以前のバージョンの CLR では、NGen PDB の作成はサポートされていません。 これらのバージョンにおいて、CLR は `OverrideAndSuppressNGenEventsKeyword` を認識せず、`NGenKeyword` を処理して NGen モジュール内のメソッドのイベントを生成します。|  
+|`PerfTrackKeyWord`|0x2000000|`ModuleLoad` イベントおよび `ModuleRange` イベントのコレクションを有効にします。|  
+|`StackKeyword`|0x40000000|CLR [スタック トレース イベント](../../../docs/framework/performance/stack-etw-event.md)のコレクションを有効にします。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="rundown"></a>   
+### CLR ETW ランダウン キーワード  
+ CLR ETW ランダウン キーワード、その値、およびその用途を次の表に示します。  
+  
+|ランダウン キーワード名|値|目的|  
+|------------------|-------|--------|  
+|`LoaderRundownKeyword`|0x00000008|`StartRundownKeyword` および `EndRundownKeyword` と一緒に使用する場合のローダー イベントのコレクションを有効にします。|  
+|`JitRundownKeyword`|0x00000010|`StartRundownKeyword` および `EndRundownKeyword` と一緒に使用する場合の、メソッド `DCStart` と JIT コンパイルされたメソッドの `DCEnd` イベントのコレクションを有効にします。|  
+|`NGenRundownKeyword`|0x00000020|`StartRundownKeyword` および `EndRundownKeyword` と一緒に使用する場合の、メソッド `DCStart` と NGen ネイティブ イメージ メソッドの `DCEnd` イベントのコレクションを有効にします。 このキーワードには高いオーバーヘッドが設定されています。 読み込まれたすべての NGen モジュールの中すべてのメソッドに対してイベントを生成します。 可能であれば、このキーワードを使用する代わりに、プロファイリング ツールによって生成されたプログラム データベース \(PDB\) を使用して、NGen モジュールからメソッドに関する情報を取得することをお勧めします。 この表で後述する `OverrideAndSuppressNGenEventsRundownKeyword` も参照してください。|  
+|`StartRundownKeyword`|0x00000040|開始ランダウン中のシステム状態の列挙を有効にします。|  
+|`EndRundownKeyword`|0x00000100|終了ランダウン中のシステム状態の列挙を有効にします。|  
+|`AppDomainResourceManagementRundownKeyword`|0x00000800|`StartRundownKeyword` または `EndRundownKeyword` と一緒に使用した場合の、<xref:System.AppDomain> レベルでのリソース監視のイベントのコレクションを有効にします。|  
+|`ThreadingKeyword`|0x00010000|スレッド プール イベントのコレクションを有効にします。|  
+|`OverrideAndSuppressNGenEventsRundownKeyword`|0x00040000|\([!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降で使用可能。\) 高いオーバーヘッドの `NGenRundownKeyword` キーワードを非表示にし、NGen モジュール内にあるメソッドのイベントが生成されないようにします。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、プロファイル ツールは `OverrideAndSuppressNGenEventsRundownKeyword` と `NGenRundownKeyword` を一緒に使用して、NGen モジュール内のメソッドのイベントの生成を抑制します。 これにより、プロファイル ツールはより効率的な NGen PDB を使用して NGen モジュール内のメソッドに関する情報を取得できます。 .NET Framework 4 以前のバージョンの CLR では、NGen PDB の作成はサポートされていません。 これらのバージョンにおいて、CLR は `OverrideAndSuppressNGenEventsRundownKeyword` を認識せず、`NGenRundownKeyword` を処理して NGen モジュール内のメソッドのイベントを生成します。|  
+|`PerfTrackKeyWord`|0x2000000|`ModuleDCStart`、`ModuleDCEnd`、`ModuleRangeDCStart`、および `ModuleRangeDCEnd` の各イベントのコレクションを有効にします。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="runtime_combo"></a>   
+### ランタイム プロバイダーのシンボル解決のキーワードの組み合わせ  
+  
+|キーワードとフラグ|アプリケーション ドメイン、アセンブリ、モジュールのロード\/アンロード イベント|メソッドのロード\/アンロード イベント \(動的イベントを除く\)|動的メソッドのロード\/破棄イベント|  
+|---------------|-----------------------------------------------|----------------------------------------|------------------------|  
+|`LoaderKeyword`|イベントをロードおよびアンロードします。|なし。|なし。|  
+|`JITKeyword`<br /><br /> \(\+ `StartEnumerationKeyword` は何も追加しません\)|なし。|イベントをロードします。|イベントをロードおよびアンロードします。|  
+|`JITKeyword` \+<br /><br /> `EndEnumerationKeyword`|なし。|イベントをロードおよびアンロードします。|イベントをロードおよびアンロードします。|  
+|`NGenKeyword`|なし。|なし。|該当なし。|  
+|`NGenKeyword` \+<br /><br /> `StartEnumerationKeyword`|なし。|イベントをロードします。|該当なし。|  
+|`NGenKeyword` \+<br /><br /> `EndEnumerationKeyword`|なし。|イベントをアンロードします。|該当しない。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="rundown_combo"></a>   
+### ランダウン プロバイダーのシンボル解決のキーワードの組み合わせ  
+  
+|キーワードとフラグ|アプリケーション ドメイン、アセンブリ、モジュールの DCStart\/DCEnd イベント|メソッドの DCStart\/DCEnd イベント \(イベントの動的メソッドを含む\)|  
+|---------------|----------------------------------------------------|--------------------------------------------------|  
+|`LoaderRundownKeyword` \+<br /><br /> `StartRundownKeyword`|`DCStart` イベント。|なし。|  
+|`LoaderRundownKeyword` \+<br /><br /> `EndRundownKeyword`|`DCEnd` イベント。|なし。|  
+|`JITKeyword` \+<br /><br /> `StartRundownKeyword`|なし。|`DCStart` イベント。|  
+|`JITKeyword` \+<br /><br /> `EndRundownKeyword`|なし。|`DCEnd` イベント。|  
+|`NGenKeyword` \+<br /><br /> `StartRundownKeyword`|なし。|`DCStart` イベント。|  
+|`NGenKeyword` \+<br /><br /> `EndRundownKeyword`|なし。|`DCEnd` イベント。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="levels"></a>   
+## ETW イベントのレベル  
+ ETW イベントはレベルでフィルター処理することもできます。 レベルが 0x5 に設定されている場合 0x5 以下を含むすべてのレベルのイベント \(キーワードによって有効になったカテゴリに属するイベント\) が発生します。 レベルが 0x2 に設定されている場合、レベル 0x2 以下に属するイベントのみが発生します。  
+  
+ 各レベルには次のような意味があります。  
+  
+ 0x5 \- 詳細  
+  
+ 0x4 \- 情報  
+  
+ 0x3 \- 警告  
+  
+ 0x2 \- エラー  
+  
+ 0x1 \- 重大  
+  
+ 0x0 \- LogAlways  
+  
+## 参照  
+ [CLR ETW プロバイダー](../../../docs/framework/performance/clr-etw-providers.md)   
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)   
+ [共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/performance/clr-etw-providers.md b/docs/framework/performance/clr-etw-providers.md
new file mode 100644
index 00000000000..d4fd204079e
--- /dev/null
+++ b/docs/framework/performance/clr-etw-providers.md
@@ -0,0 +1,100 @@
+---
+title: "CLR ETW プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR ETW プロバイダー"
+  - "ETW, CLR プロバイダー"
+ms.assetid: 0beafad4-b2c8-47f4-b342-83411d57a51f
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# CLR ETW プロバイダー
+共通言語ランタイム \(CLR: Common Language Runtime\) には、ランタイム プロバイダーとランダウン プロバイダーという 2 つのプロバイダーがあります。  
+  
+ ランタイム プロバイダーは、有効になっているキーワードに応じてイベントを発生させます \(キーワードとはイベントのカテゴリです\)。  たとえば、ローダー イベントを収集するには `LoaderKeyword` キーワードを有効にします。  
+  
+ Windows イベント トレーシング \(ETW: Event Tracing for Windows\) のログは、.etl 拡張子を持つファイルに記録されます。このファイルは、必要に応じてコンマ区切り値 \(.csv\) ファイルで後処理できます。  .etl ファイルを .csv ファイルに変換する方法の詳細については、「[.NET Framework のログ記録の制御](../../../docs/framework/performance/controlling-logging.md)」を参照してください。  
+  
+## ランタイム プロバイダー  
+ ランタイム プロバイダーは、メインの CLR ETW プロバイダーです。  
+  
+ CLR ランタイム プロバイダーの GUID は e13c0d23\-ccbc\-4e12\-931b\-d9cc2eee27e4 です。  
+  
+ 一般に利用可能なツールを使用して CLR ETW イベントを記録および表示する方法の例については、「[.NET Framework のログ記録の制御](../../../docs/framework/performance/controlling-logging.md)」を参照してください。  
+  
+ `LoaderKeyword` などのキーワードを使用する以外にも、発生頻度が高いイベントを記録するためのキーワードを有効にしなければならない場合があります。  `StartEnumerationKeyword` キーワードと `EndEnumerationKeyword` キーワードはこれらのイベントを有効にし、[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md) にまとめられます。  
+  
+## ランダウン プロバイダー  
+ ランダウン プロバイダーは、一部の特殊な用途で有効にする必要があります。  ただし、大半のユーザーにとっては、ランタイム プロバイダーで十分です。  
+  
+ CLR ランダウン プロバイダーの GUID は A669021C\-C450\-4609\-A035\-5AF59AF4DF18 です。  
+  
+ 通常は、プロセスが開始される前に ETW のログを有効にし、プロセスの終了後にログを無効にしますが、  プロセスの実行中に ETW ログを有効にする場合もあります。その場合は、そのプロセスについて追加の情報が必要です。  たとえば、シンボルを解決するには、ログを有効にする前に既に読み込まれていたメソッドのメソッド イベントを記録する必要があります。  
+  
+ `DCStart` イベントと `DCEnd` イベントは、データの収集が開始されたときと停止されたときのプロセスの状態をキャプチャします \(状態とは、既に Just\-In\-Time コンパイルされているメソッド、既に読み込まれているアセンブリなど、高レベルの情報を指します\)。これらの 2 つのイベントを使用すると、そのプロセスで既に行われたことに関する情報 \(どのメソッドが Just\-In\-Time コンパイルされたかなど\) を取得できます。  
+  
+ ランダウン プロバイダーで発生するイベントは、名前に `DC`、`DCStart`、`DCEnd`、または `DCInit` を含むイベントだけです。  また、これらのイベントはランダウン プロバイダーでしか発生しません。  
+  
+ ランダウン プロバイダーでは、イベント キーワード フィルターのほかに、`StartRundownKeyword` と `EndRundownKeyword` というキーワードによるターゲット フィルターもサポートされています。  
+  
+### 開始ランダウン  
+ 開始ランダウンは、`StartRundownKeyword` キーワードを使用してランダウン プロバイダーのイベントの記録を有効にした場合にトリガーされます。  開始ランダウンがトリガーされると、`DCStart` イベントが発生して、システムの状態がキャプチャされます。  列挙の開始前には `DCStartInit` イベントが発生します。  列挙の終了時には `DCStartComplete` イベントが発生して、データの収集が正常に終了したことがコントローラーに通知されます。  
+  
+### 終了ランダウン  
+ 終了ランダウンは、`EndRundownKeyword` キーワードを使用してランダウン プロバイダーのイベントの記録を有効にした場合にトリガーされます。  終了ランダウンでは、実行中のプロセスのプロファイリングが停止され、  `DCEnd` イベントにより、プロファイリングが停止されたときのシステムの状態がキャプチャされます。  
+  
+ 列挙の開始前には `DCEndInit` イベントが発生します。  列挙の終了時には `DCEndComplete` イベントが発生して、データの収集が正常に終了したことがコンシューマーに通知されます。  開始ランダウンと終了ランダウンは、主にマネージ シンボルの解決のために使用されます。  開始ランダウンは、プロファイリング セッションが開始される前に既に Just\-In\-Time コンパイル \(JIT コンパイル\) されていたメソッドのアドレス範囲の情報を提供します。  終了ランダウンは、プロファイリングを停止するときに JIT コンパイルされていたすべてのメソッドのアドレス範囲の情報を提供します。  
+  
+ 終了ランダウンは、プロファイリング セッションが停止されると自動的に発生するわけではありません。  ツールでマネージ シンボルを解決する必要がある場合は、プロファイリングを停止する直前に、`EndRundownKeyword` キーワードを有効にして CLR ランダウン プロバイダー セッションを明示的に呼び出す必要があります。  
+  
+ マネージ シンボルを解決するためのメソッドのアドレス範囲の情報は、開始ランダウンと終了ランダウンのどちらでも取得できますが、`StartRundownKeyword` キーワード \(`DCStart` イベント\) ではなく `EndRundownKeyword` キーワード \(`DCEnd` イベント\) を使用することをお勧めします。  `StartRundownKeyword` を使用すると、プロファイリング セッションの間にランダウンが発生するため、プロファイリング対象のシナリオに影響を与える可能性があります。  
+  
+## ランタイム プロバイダーとランダウン プロバイダーによる ETW データの収集  
+ 次の例は、マネージ プロセスのシンボルを、プロセスの開始または終了がプロファイリング期間の範囲内かどうかに関係なく最小限の影響で解決できるようにするための CLR ランダウン プロバイダーの使用方法を示しています。  
+  
+1.  CLR ランタイム プロバイダーを使用して ETW のログの記録を有効にします。  
+  
+    ```  
+    xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:0x5 -f clr1.etl      
+    ```  
+  
+     ログは、clr1.etl ファイルに保存されます。  
+  
+2.  プロセスの実行中にプロファイリングを停止するには、ランダウン プロバイダーを開始して `DCEnd` イベントをキャプチャします。  
+  
+    ```  
+    xperf -start clrRundown -on A669021C-C450-4609-A035-5AF59AF4DF18:0xB8:0x5 -f clr2.etl      
+    ```  
+  
+     これにより、`DCEnd` イベントの収集を有効にして、ランダウン セッションを開始できます。  すべてのイベントが収集されるまでには 30 ～ 60 秒かかります。  ログは、clr1.et2 ファイルに保存されます。  
+  
+3.  すべての ETW プロファイリングを停止します。  
+  
+    ```  
+    xperf -stop clrRundown   
+    xperf -stop clr  
+    ```  
+  
+4.  プロファイルをマージして 1 つのログ ファイルを作成します。  
+  
+    ```  
+    xperf -merge -d clr1.etl clr2.etl merged.etl  
+    ```  
+  
+     merged.etl ファイルには、ランタイム プロバイダー セッションとランダウン プロバイダー セッションのイベントが含まれます。  
+  
+ ツールを使用して、ユーザーがプロファイリングの停止を要求したときに直ちにプロファイリングを停止する代わりに手順 2. と 3. \(ランダウン セッションを開始してからプロファイリングを終了する\) が実行されるようにすることも、  手順 4. もツールで実行できます。  
+  
+## 参照  
+ [共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/performance/constrained-execution-regions.md b/docs/framework/performance/constrained-execution-regions.md
new file mode 100644
index 00000000000..e707cac6fa4
--- /dev/null
+++ b/docs/framework/performance/constrained-execution-regions.md
@@ -0,0 +1,123 @@
+---
+title: "制約された実行領域 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CER"
+  - "制約された実行領域"
+ms.assetid: 99354547-39c1-4b0b-8553-938e8f8d1808
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 制約された実行領域
+制約された実行領域 \(CER: Constrained Execution Region\) は、信頼性のあるマネージ コードを作成するための機構の一部です。  CER は、領域内のコードが領域全体で実行されるのを防ぐ帯域外の例外を、共通言語ランタイム \(CLR: Common Language Runtime\) がスローすることを制約された領域を定義します。  その領域内では、ユーザー コードは、帯域外の例外がスローされることになるコードの実行を制約されます。  <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> メソッドは、`try` ブロックの直前に呼び出す必要があります。このメソッドによって、`catch`、`finally`、`fault` の各ブロックが制約された実行領域としてマークされます。  制約された領域としてマークされると、コードは信頼性の高いコントラクトでのみ他のコードを呼び出す必要があります。また、コードがエラーを処理できるようになるまで、コードは準備されていないメソッドや信頼性のないメソッドの割り当てや仮想呼び出しを行うことはできません。  CLR は、CER で実行しているコードに対してスレッドの中止を遅らせます。  
+  
+ 制約された実行領域は、注釈付きの `try` ブロックだけでなく、特に <xref:System.Runtime.ConstrainedExecution.CriticalFinalizerObject> クラスから派生したクラス、および <xref:System.Runtime.CompilerServices.RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup%2A> メソッドを使用して実行されるコードで実行する重大なファイナライザーなど、CLR のさまざまな形式で使用されます。  
+  
+## CER の事前準備  
+ CLR は、メモリ不足の状態を回避するために、CER を事前に準備します。  JIT \(Just\-In\-Time\) コンパイル時や型の読み込み時に、CLR がメモリ不足の状態を引き起こさないように、事前準備が必要となります。  
+  
+ 次のように、開発者はコード領域が CER であることを示す必要があります。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute> 属性が適用されたすべての呼び出し先のトップレベルの CER 領域とメソッドは事前に準備されます。  <xref:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute> は、<xref:System.Runtime.ConstrainedExecution.Cer> または <xref:System.Runtime.ConstrainedExecution.Cer> の保証だけを示すことができます。  
+  
+-   仮想ディスパッチなど、静的に決定できない呼び出しに対して事前準備を行うことはできません。  このような場合には、<xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareMethod%2A> メソッドを使用します。  <xref:System.Runtime.CompilerServices.RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup%2A> メソッドを使用する場合は、<xref:System.Runtime.ConstrainedExecution.PrePrepareMethodAttribute> 属性をクリーンアップ コードに適用する必要があります。  
+  
+## 制約  
+ ユーザーは、CER で書き込むことのできるコードの種類で制約を受けます。  コードでは、次の操作によって生じる可能性のある帯域外の例外を発生させることはできません。  
+  
+-   明示的な割り当て  
+  
+-   ボックス化。  
+  
+-   ロックの取得。  
+  
+-   準備されていないメソッドの仮想呼び出し  
+  
+-   信頼性の低いコントラクトまたは信頼性のないコントラクトでのメソッド呼び出し  
+  
+ .NET Framework Version 2.0 では、これらの制約はガイドラインです。  診断はコード分析ツールを通じて提供されます。  
+  
+## 信頼性のコントラクト  
+ <xref:System.Runtime.ConstrainedExecution.ReliabilityContractAttribute> は、信頼性の保証と特定のメソッドの破損状態を定義するカスタム属性です。  
+  
+### 信頼性の保証  
+ <xref:System.Runtime.ConstrainedExecution.Cer> 列挙値によって表される信頼性の保証は、特定のメソッドの信頼度を次のように示します。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Cer>.  例外条件に基づき、メソッドは失敗する可能性があります。  この場合、メソッドは呼び出し元のメソッドに成功したか失敗したかを報告します。  メソッドが戻り値を確実に報告できるように、メソッドは CER に含まれている必要があります。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Cer>.  メソッド、型、またはアセンブリには CER の概念がないため、状態の破損を大幅に軽減しなければ、CER 内での呼び出しが安全ではない可能性が非常に高くなります。  この値は、CER の保証を利用しません。  これは以下を意味します。  
+  
+    1.  例外条件に基づき、メソッドは失敗する可能性があります。  
+  
+    2.  メソッドは、失敗したことを報告する場合もあれば、報告しない場合もあります。  
+  
+    3.  メソッドは、CER の最も可能性の高いシナリオを使用するように作成されるわけではありません。  
+  
+    4.  メソッド、型、またはアセンブリが成功することが明示的に識別されていない場合、暗黙的に <xref:System.Runtime.ConstrainedExecution.Cer> として識別されます。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Cer>.  例外条件に基づき、メソッドは成功することが保証されます。  このレベルの信頼性を実現するには、メソッドが CER 以外の領域内から呼び出される場合でも、呼び出されるメソッドの周辺に CER を常に構築する必要があります。  成功の判断は主観的なものですが、メソッドが意図したとおりに実行された場合、そのメソッドは成功です。  たとえば、Count を `ReliabilityContractAttribute(Cer.Success)` でマークした場合、CER での実行時に、このメソッドが <xref:System.Collections.ArrayList> の要素数を必ず返し、内部フィールドを未確認の状態のままにすることはできないことを意味します。<xref:System.Threading.Interlocked.CompareExchange%2A> メソッドも同様に成功としてマークされますが、この成功は、競合状態によって値を新しい値に置き換えることができなかったことを意味する場合があります。重要な点は、メソッドは定義されたとおりに動作すること、そして、正しいにもかかわらず信頼性のないコードの外見以上の異常な動作を予測して CER コードを記述する必要はないということです。  
+  
+### 破損レベル  
+ <xref:System.Runtime.ConstrainedExecution.Consistency> 列挙値によって表される破損レベルは、特定の環境で状態がどの程度破損する可能性があるかを示します。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Consistency>.  例外条件に基づき、共通言語ランタイム \(CLR\) は、現在のアプリケーション ドメインにおける状態の一貫性に関して一切保証しません。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Consistency>.  例外条件に基づき、メソッドは状態の破損を現在のインスタンスに限定することが保証されます。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Consistency>。例外条件に基づき、CLR は状態の一貫性に関して一切保証しません。つまり、状況によってプロセスが破損する可能性があります。  
+  
+-   <xref:System.Runtime.ConstrainedExecution.Consistency>.  例外条件に基づき、メソッドは状態を破損しないことが保証されます。  
+  
+## 信頼性の try\/catch\/finally  
+ 信頼性の `try/catch/finally` は、予測可能性の保証がアンマネージ バージョンと同じレベルである例外処理機構です。  `catch/finally` ブロックは CER です。  ブロック内のメソッドには事前準備が必要であり、中断不可能であることが必要です。  
+  
+ .NET Framework Version 2.0 では、コードは、try ブロックの直前に <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> を呼び出すことにより、try が信頼できることをランタイムに通知します。  <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> は、コンパイラ サポート クラスである <xref:System.Runtime.CompilerServices.RuntimeHelpers> のメンバーです。  コンパイラによって可用性が保留になっている <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> を直接呼び出します。  
+  
+## 中断不可能な領域  
+ 中断不可能な領域は、一連の命令を CER にグループ化します。  
+  
+ .NET Framework Version 2.0 では、コンパイラによって可用性の保留がサポートされているため、ユーザー コードは、空の try\/catch ブロックの前に <xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> メソッド呼び出しを含む信頼性のある try\/catch\/finally を使用して、中断不可能な領域を作成します。  
+  
+## 重大なファイナライザー オブジェクト  
+ <xref:System.Runtime.ConstrainedExecution.CriticalFinalizerObject> は、ガベージ コレクションがファイナライザーを実行することを保証します。  割り当て時に、ファイナライザーとその呼び出し先は事前に準備されます。  ファイナライザー メソッドは CER で実行されるため、CER とファイナライザーのすべての制約に従う必要があります。  
+  
+ <xref:System.Runtime.InteropServices.SafeHandle> および <xref:System.Runtime.InteropServices.CriticalHandle> から継承するすべての型は、CER 内でファイナライザーが実行されることが保証されます。  <xref:System.Runtime.InteropServices.SafeHandle> の派生クラスで <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> を実装して、ハンドルを解放する必要のあるコードを実行します。  
+  
+## CER で許可されないコード  
+ CER では、次の操作は許可されません。  
+  
+-   明示的な割り当て。  
+  
+-   ロックの取得。  
+  
+-   ボックス化。  
+  
+-   多次元配列アクセス。  
+  
+-   リフレクションを通じたメソッド呼び出し。  
+  
+-   <xref:System.Threading.Monitor.Enter%2A> または <xref:System.IO.FileStream.Lock%2A>。  
+  
+-   セキュリティ チェック。  要求 \(リンク要求のみ\) を実行しないでください。  
+  
+-   COM オブジェクトおよびプロキシの <xref:System.Reflection.Emit.OpCodes.Isinst> と <xref:System.Reflection.Emit.OpCodes.Castclass>。  
+  
+-   透過プロキシでのフィールドの取得または設定。  
+  
+-   シリアル化。  
+  
+-   関数ポインターとデリゲート。  
+  
+## 参照  
+ [信頼性に関するベスト プラクティス](../../../docs/framework/performance/reliability-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/performance/contention-etw-events.md b/docs/framework/performance/contention-etw-events.md
new file mode 100644
index 00000000000..9dd872ec32d
--- /dev/null
+++ b/docs/framework/performance/contention-etw-events.md
@@ -0,0 +1,46 @@
+---
+title: "競合 ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "競合イベント [.NET Framework]"
+  - "ETW, 競合イベント (CLR)"
+ms.assetid: 6933e753-2f2a-425b-ae84-42138c957d76
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 競合 ETW イベント
+競合イベントは、ランタイムによって使用される <xref:System.Threading.Monitor?displayProperty=fullName> ロックまたはネイティブ ロックの競合が発生するたびに発生します。  競合は、別のスレッドが保持しているロックをスレッドが待機しているときに発生します。  
+  
+ 競合イベントが発生するキーワードとイベントのレベルを次の表に示します \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|Level|  
+|---------------------|-----------|  
+|`ContentionKeyword` \(0x4000\)|情報提供 \(4\)|  
+  
+ イベント情報を次の表に示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ContentionStart_V1`|81|競合が開始されたとき。  このイベントには、スレッドがロックの取得を待機する前のスピン時間は含まれません。このイベントが発生するのは、スレッドがロックの取得を待機するときだけです。|  
+|`ContentionStop`|81|競合が終了したとき。|  
+  
+ イベント データを次の表に示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|フラグ|win:UInt8|0 \(マネージ\) または 1 \(ネイティブ\)。|  
+|ClrInstanceID|win:UInt16|CLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/controlling-logging.md b/docs/framework/performance/controlling-logging.md
new file mode 100644
index 00000000000..84c18618db9
--- /dev/null
+++ b/docs/framework/performance/controlling-logging.md
@@ -0,0 +1,118 @@
+---
+title: ".NET Framework のログ記録の制御 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR ETW イベント, ログ記録"
+ms.assetid: ce13088e-3095-4f0e-9f6b-fad30bbd3d41
+caps.latest.revision: 40
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 40
+---
+# .NET Framework のログ記録の制御
+Windows イベント トレーシング \(ETW: Event Tracing for Windows\) を使用して共通言語ランタイム \(CLR: Common Language Runtime\) イベントを記録できます。  トレースの作成および表示には次のツールを使用します。  
+  
+-   Windows オペレーティング システムに含まれる [Logman](http://go.microsoft.com/fwlink/?LinkId=150916) コマンド ライン ツールと [Tracerpt](http://go.microsoft.com/fwlink/?LinkId=150919) コマンド ライン ツール。  
+  
+-   [Windows Performance Toolkit](http://msdn.microsoft.com/library/windows/hardware/hh162945.aspx) の [Xperf](http://msdn.microsoft.com/library/windows/hardware/hh162920.aspx) ツール。  Xperf の詳細については、[Windows Performance Blog \(Windows のパフォーマンスに関するブログ\)](http://go.microsoft.com/fwlink/?LinkId=179509) を参照してください。  
+  
+ CLR イベントの情報をキャプチャするには、コンピューターに CLR プロバイダーがインストールされている必要があります。  プロバイダーがインストールされているかどうかを確認するには、コマンド プロンプトで「`logman query providers`」と入力します。  プロバイダーの一覧が表示されます。  その一覧に、次のような CLR プロバイダーのエントリが含まれている必要があります。  
+  
+```  
+Provider                                 GUID  
+-------------------------------------------------------------------------------  
+.NET Common Language Runtime    {E13C0D23-CCBC-4E12-931B-D9CC2EEE27E4}.  
+```  
+  
+ 一覧に CLR プロバイダーが含まれていない場合は、Windows Vista 以降のオペレーティング システムで Windows [Wevtutil](http://go.microsoft.com/fwlink/?LinkID=150915) コマンド ライン ツールを使用してインストールできます。  管理者としてコマンド プロンプト ウィンドウを開き、  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] のフォルダー \(%WINDIR%\\Microsoft.NET\\Framework\[64\]\\v4.\<.NET version\>\\\) に移動します。  このフォルダーに、CLR\-ETW.man ファイルが含まれています。  コマンド プロンプトで次のコマンドを入力して CLR プロバイダーをインストールします。  
+  
+ `wevtutil im CLR-ETW.man`  
+  
+## CLR ETW イベントのキャプチャ  
+ コマンド ライン ツールの [Logman](http://go.microsoft.com/fwlink/?LinkId=150916) と [Xperf](http://msdn.microsoft.com/library/windows/hardware/hh162920.aspx) を使用して ETW イベントをキャプチャできます。また、[Tracerpt](http://go.microsoft.com/fwlink/?LinkId=150919) ツールと [Xperf](http://msdn.microsoft.com/library/windows/hardware/hh162920.aspx) ツールを使用してトレース イベントをデコードできます。  
+  
+ ログを有効にするには、次の 3 つの項目を指定する必要があります。  
+  
+-   通信先のプロバイダー。  
+  
+-   キーワード セットを表す 64 ビットの数値。  各キーワードは、プロバイダーが有効にできる一連のイベントを表します。  この数値は、有効にするキーワードの組み合わせを表します。  
+  
+-   記録レベル \(詳細度\) を表す小さな数値。  レベル 1 が最も簡易であり、レベル 5 が最も詳細になります。  レベル 0 は既定値であり、プロバイダー固有であることを意味します。  
+  
+#### Logman を使用して CLR ETW イベントをキャプチャするには  
+  
+1.  コマンド プロンプトに次のように入力します。  
+  
+     `logman start clrevents -p {e13c0d23-ccbc-4e12-931b-d9cc2eee27e4} 0x1CCBD 0x5 -ets -ct perf`  
+  
+     それぞれの文字について以下に説明します。  
+  
+    -   `-p` パラメーターはプロバイダーの GUID を識別します。  
+  
+    -   `0x1CCBD` は、発生するイベントのカテゴリを指定しています。  
+  
+    -   `0x5` は、ログ レベルを設定しています \(この場合は詳細 \(5\)\)。  
+  
+    -   `-ets` パラメーターは、コマンドをイベント トレース セッションに送信するように指定します。  
+  
+    -   `-ct perf` パラメーターは、`QueryPerformanceCounter` 関数を使用して各イベントのタイム スタンプを記録するように指定します。  
+  
+2.  イベントの記録を停止するには、次のように入力します。  
+  
+     `logman stop clrevents -ets`  
+  
+     これにより、clrevents.etl という名前のバイナリ トレース ファイルが作成されます。  
+  
+#### Xperf を使用して CLR ETW イベントをキャプチャするには  
+  
+1.  コマンド プロンプトで次のように入力します。  
+  
+     `xperf -start clr -on e13c0d23-ccbc-4e12-931b-d9cc2eee27e4:0x1CCBD:5 -f clrevents.etl`  
+  
+     GUID には CLR ETW プロバイダーの GUID を指定します。`0x1CCBD:5` を指定すると、レベル 5 \(詳細\) 以下のすべての内容がトレースされます。  
+  
+2.  トレースを停止するには、次のように入力します。  
+  
+     `Xperf -stop clr`  
+  
+     これにより、clrevents.etl という名前のトレース ファイルが作成されます。  
+  
+## CLR ETW イベントの表示  
+ CLR ETW イベントを表示するには、以下のコマンドを使用します。  イベントの詳細については、「[CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)」を参照してください。  
+  
+#### Tracerpt を使用して CLR ETW イベントを表示するには  
+  
+-   コマンド プロンプトで次のように入力します。  
+  
+     `tracerpt clrevents.etl`  
+  
+     これにより、dumpfile.xml と summary.txt という 2 つのファイルが作成されます。  dumpfile.xml ファイルはすべてのイベントの一覧で、summary.txt はイベントの概要です。  
+  
+#### Xperf を使用して CLR ETW イベントを表示するには  
+  
+-   コマンド プロンプトで次のように入力します。  
+  
+     `xperf clrevents.etl`  
+  
+     Xperf ETL ファイル ビューアーが開きます。  このビューアーでは、CLR イベントは、**\[一般的なイベント\]** ビューに表示されます。  種類別に分類されたイベントのデータ グリッドを表示するには、このビューで時間帯を選択し、マウスを右クリックし、**\[概要\]** をクリックします。  
+  
+#### .etl ファイルをコンマ区切り値ファイルに変換するには  
+  
+-   コマンド プロンプトで次のように入力します。  
+  
+     `xperf -i clrevents.etl -f clrevents.csv`  
+  
+     このコマンドを使用すると、XPerf によって、表示可能なコンマ区切り値 \(CSV\) ファイルとしてイベントがダンプされます。  イベントが異なればフィールドも異なるので、この CSV ファイルには、データの前に複数のヘッダー行が含まれます。  すべての行の先頭のフィールドはイベントの種類を表します。このフィールドは、残りのフィールドを判別するために使用されるヘッダーを示します。  
+  
+## 参照  
+ [Windows Performance Toolkit](http://go.microsoft.com/fwlink/?LinkID=161141)   
+ [共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/framework/performance/etw-events-in-task-parallel-library-and-plinq.md b/docs/framework/performance/etw-events-in-task-parallel-library-and-plinq.md
new file mode 100644
index 00000000000..9874701739b
--- /dev/null
+++ b/docs/framework/performance/etw-events-in-task-parallel-library-and-plinq.md
@@ -0,0 +1,126 @@
+---
+title: "タスク並列ライブラリおよび PLINQ での ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タスク、ETW イベント"
+ms.assetid: 87a9cff5-d86f-4e44-a06e-d12764d0dce2
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# タスク並列ライブラリおよび PLINQ での ETW イベント
+タスク並列ライブラリと PLINQ は、どちらも Event Trace for Windows \(ETW\) イベントを生成します。これらのイベントと Windows パフォーマンス最適化ツールなどのツールを使用すると、アプリケーションのプロファイリンやトラブルシューティングを行うことができます。  ただし、ほとんどのシナリオでは、並列アプリケーション コードのプロファイリングを行うための最善の方法は、[!INCLUDE[vsUltShort](../../../includes/vsultshort-md.md)]で [同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md) を使用します。  
+  
+## タスク並列ライブラリでの ETW イベント  
+ EVENT\_HEADER 構造体で、<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName>、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName>、および <xref:System.Threading.Tasks.Parallel.Invoke%2A?displayProperty=fullName> によって生成されるイベントの ProviderId GUID を次に示します。  
+  
+```  
+0x2e5dba47, 0xa3d2, 0x4d16, 0x8e, 0xe0, 0x66, 0x71, 0xff, 0xdc, 0xd7, 0xb5  
+```  
+  
+### 並列ループの開始  
+ EVENT\_DESCRIPTOR.Task \= 1  
+  
+ EVENT\_DESCRIPTOR.Id \= 1  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|ForkJoinContextID|<xref:System.Int32?displayProperty=fullName>|fork\/join セマンティクスのあるイベントの入れ子とペアの関係を示すために使用される一意の識別子。|  
+|OperationType|<xref:System.Int32?displayProperty=fullName>|ループの種類。<br /><br /> 1 \= ParallelInvoke<br /><br /> 2 \= ParallelFor<br /><br /> 3 \= ParallelForEach|  
+|InclusiveFrom|<xref:System.Int64?displayProperty=fullName>|ループ カウンターの開始値。|  
+|ExclusiveTo|<xref:System.Int64?displayProperty=fullName>|ループ カウンターの終了値。|  
+  
+### 並列ループの終了  
+ EVENT\_DESCRIPTOR.Task \= 2  
+  
+ EVENT\_DESCRIPTOR.Id \= 2  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|ForkJoinContextID|<xref:System.Int32?displayProperty=fullName>|fork\/join セマンティクスのあるイベントの入れ子とペアの関係を示すために使用される一意の識別子。|  
+|totalIterations|<xref:System.Int64?displayProperty=fullName>|イテレーションの総数。|  
+  
+### 並列呼び出しの開始  
+ EVENT\_DESCRIPTOR.Task \= 3  
+  
+ EVENT\_DESCRIPTOR.Id \= 3  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|ForkJoinContextID|<xref:System.Int32?displayProperty=fullName>|fork\/join セマンティクスのあるイベントの入れ子とペアの関係を示すために使用される一意の識別子。|  
+|totalIterations|<xref:System.Int64?displayProperty=fullName>|イテレーションの総数。|  
+|operationType|<xref:System.Int32?displayProperty=fullName>|ループの種類。<br /><br /> 1 \= ParallelInvoke<br /><br /> 2 \= ParallelFor<br /><br /> 3 \= ParallelForEach|  
+|ActionCount|<xref:System.Int32?displayProperty=fullName>|並列呼び出しで実行されるアクションの数。|  
+  
+### 並列呼び出しの終了  
+ EVENT\_DESCRIPTOR.Task \= 4  
+  
+ EVENT\_DESCRIPTOR.Id \= 4  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|ForkJoinContextID|<xref:System.Int32?displayProperty=fullName>|fork\/join セマンティクスのあるイベントの入れ子とペアの関係を示すために使用される一意の識別子。|  
+  
+## PLINQ での ETW イベント  
+ PLINQ での EVENT\_HEADER.ProviderId GUID を次に示します。  
+  
+```  
+0x159eeeec, 0x4a14, 0x4418, 0xa8, 0xfe, 0xfa, 0xab, 0xcd, 0x98, 0x78, 0x87  
+```  
+  
+### 並列クエリの開始  
+ EVENT\_DESCRIPTOR.Task \= 1  
+  
+ EVENT\_DESCRIPTOR.Id \= 1  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|QueryID|<xref:System.Int32?displayProperty=fullName>|一意のクエリ識別子。|  
+  
+### 並列クエリの終了  
+ EVENT\_DESCRIPTOR.Task \= 2  
+  
+ EVENT\_DESCRIPTOR.Id \= 2  
+  
+#### \[ユーザー データ\]  
+  
+|**名前**|**型**|**説明**|  
+|------------|-----------|------------|  
+|OriginatingTaskSchedulerID|<xref:System.Int32?displayProperty=fullName>|ループを開始した TaskScheduler の ID。|  
+|OriginatingTaskID|<xref:System.Int32?displayProperty=fullName>|ループを開始したタスクの ID。|  
+|QueryID|<xref:System.Int32?displayProperty=fullName>|一意のクエリ識別子。|  
+  
+## 参照  
+ [.NET Framework の ETW イベント](../../../docs/framework/performance/etw-events.md)   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/framework/performance/etw-events-in-the-common-language-runtime.md b/docs/framework/performance/etw-events-in-the-common-language-runtime.md
new file mode 100644
index 00000000000..70f3c063d53
--- /dev/null
+++ b/docs/framework/performance/etw-events-in-the-common-language-runtime.md
@@ -0,0 +1,46 @@
+---
+title: "共通言語ランタイムの ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR ETW イベント"
+  - "ETW, CLR イベント"
+  - "ETW, 共通言語ランタイム"
+ms.assetid: 5bb9b6a2-7b57-4aea-8809-32b28bc73e88
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 共通言語ランタイムの ETW イベント
+共通言語ランタイム \(CLR: Common Language Runtime\) は、さまざまなデバッグ イベントやプロファイリング イベントを通じて、有用な Windows イベント トレーシング \(ETW: Event Tracing for Windows\) 診断情報を提供します。  CLR ETW イベントは、Windows の ETW トレース システムを活用して、共通言語ランタイムの既存のプロファイリングとデバッグのサポートを補足します。  
+  
+ ETW の詳細については、MSDN の記事を参照してください。[ETW のデバッグおよびパフォーマンス調整を改善します。](http://go.microsoft.com/fwlink/?LinkID=161142) Xperf については NTDebugging ブログのエントリ [Windows Performance Toolkit \- Xperf](http://go.microsoft.com/fwlink/?LinkID=161144) "を参照してください。  
+  
+ そのほかの CLR ETW ツールが使用可能に [CodePlex Web サイト](http://go.microsoft.com/fwlink/?LinkID=111138) なるように提供されます。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降のイベントに関するトピックで説明するすべてのイベントに必要です。  Windows Vista オペレーティング システムでは、最小限のサポートされているクライアントであり、Windows Server 2008 では、最小限のサポートされているサーバーです。  
+  
+## このセクションの内容  
+ [.NET Framework のログ記録の制御](../../../docs/framework/performance/controlling-logging.md)  
+ ETW イベントをキャプチャして表示するためのツールとコマンドについて説明します。  
+  
+ [CLR ETW プロバイダー](../../../docs/framework/performance/clr-etw-providers.md)  
+ ランタイム プロバイダーとランダウン プロバイダーに関する情報を提供し、ETW データ コレクションでこれらのプロバイダーを使用する方法について説明します。  
+  
+ [CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)  
+ イベントのフィルター処理を可能にするランタイム プロバイダーとランダウン プロバイダーのキーワードを、カテゴリ別に説明します。  
+  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)  
+ CLR ETW イベント、キーワード、レベル、およびイベント データについて、詳しく説明します。  
+  
+## 参照  
+ [.NET Framework の ETW イベント](../../../docs/framework/performance/etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/etw-events.md b/docs/framework/performance/etw-events.md
new file mode 100644
index 00000000000..ce63128cb8e
--- /dev/null
+++ b/docs/framework/performance/etw-events.md
@@ -0,0 +1,37 @@
+---
+title: ".NET Framework の ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework ETW イベント"
+  - "ETW イベント (.NET Framework の)"
+ms.assetid: d186276f-6afb-4dfd-bf3c-4251edc2c299
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# .NET Framework の ETW イベント
+Windows イベント トレーシング \(ETW: Event Tracing for Windows\) は、パフォーマンスが高くオーバーヘッドの低いスケーラブルなトレース システムで、Windows オペレーティング システムに含まれています。  .NET Framework のプロファイリングとデバッグのサポートを補足する機能として、さまざまなシナリオのトラブルシューティングに使用できます。  ETW に関する一般的な情報については、[ETW のデバッグおよびパフォーマンス調整を改善します。](http://go.microsoft.com/fwlink/?LinkID=161142) MSDN ライブラリを参照してください。  
+  
+ .NET Framework では、共通言語ランタイム \(CLR: Common Language Runtime\)、[タスク並列ライブラリ](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)、および [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md) で ETW を使用できます。  
+  
+## このセクションの内容  
+ [タスク並列ライブラリおよび PLINQ での ETW イベント](../../../docs/framework/performance/etw-events-in-task-parallel-library-and-plinq.md)  
+ 並列アプリケーション コードのプロファイリングの方法について説明します。  
+  
+ [共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)  
+ CLR ETW イベントが共通言語ランタイムのプロファイリングとデバッグのサポートを補足する方法について説明します。  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/framework/performance/exception-thrown-v1-etw-event.md b/docs/framework/performance/exception-thrown-v1-etw-event.md
new file mode 100644
index 00000000000..e6b7ab13018
--- /dev/null
+++ b/docs/framework/performance/exception-thrown-v1-etw-event.md
@@ -0,0 +1,49 @@
+---
+title: "Exception Thrown_V1 ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, ExceptionThrown_V1 イベント (CLR)"
+  - "ExceptionThrown_V1 イベント [.NET Framework]"
+ms.assetid: 0d3da389-6b7b-40f6-a877-fac546d6019c
+caps.latest.revision: 6
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Exception Thrown_V1 ETW イベント
+このイベントは、スローされた例外に関する情報をキャプチャします。  
+  
+ このイベントが発生するキーワードとイベントのレベルを次の表に示します \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|Level|  
+|---------------------|-----------|  
+|`ExceptionKeyword` \(0x8000\)|警告 \(2\)|  
+  
+ イベント情報を次の表に示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ExceptionThrown_V1`|80|マネージ例外がスローされました。|  
+  
+ イベント データを次の表に示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|例外の種類|win:UnicodeString|例外の型 \(`System.NullReferenceException` など\)。|  
+|Exception Message|win:UnicodeString|実際の例外メッセージ。|  
+|EIPCodeThrow|win:Pointer|例外が発生した命令ポインター。|  
+|ExceptionHR|win:UInt32|例外 [HRESULT](http://go.microsoft.com/fwlink/?LinkId=179679)。|  
+|ExceptionFlags|win:UInt16|0x01: HasInnerException \(Visual Basic のドキュメントの「[CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)」を参照してください\)。<br /><br /> 0x02: IsNestedException。<br /><br /> 0x04: IsRethrownException。<br /><br /> 0x08: プロセス状態が破損していることを示しています \(IsCorruptedStateException; MSDN [破損した状態の例外処理](http://go.microsoft.com/fwlink/?LinkId=179681) で参照してください。<br /><br /> 0x10: IsCLSCompliant \(<xref:System.Exception> から派生する例外は CLS 準拠です。それ以外の例外は CLS 準拠ではありません\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/garbage-collection-etw-events.md b/docs/framework/performance/garbage-collection-etw-events.md
new file mode 100644
index 00000000000..57b370ac1bd
--- /dev/null
+++ b/docs/framework/performance/garbage-collection-etw-events.md
@@ -0,0 +1,375 @@
+---
+title: "ガベージ コレクション ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, ガベージ コレクション イベント (CLR)"
+  - "ガベージ コレクション イベント [.NET Framework]"
+  - "GC イベント"
+ms.assetid: f14b6fd7-0966-4d87-bc89-54ef3a44a94a
+caps.latest.revision: 21
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# ガベージ コレクション ETW イベント
+<a name="top"></a> これらのイベントは、ガベージ コレクションに関連する情報を収集します。 ガベージ コレクションが実行された回数、ガベージ コレクションの間に解放されたメモリの量など、診断やデバッグに役立つ情報を入手できます。  
+  
+ このカテゴリは、次のイベントで構成されます。  
+  
+-   [GCStart\_V1 イベント](#gcstart_v1_event)  
+  
+-   [GCEnd\_V1 イベント](#gcend_v1_event)  
+  
+-   [GCHeapStats\_V1 イベント](#gcheapstats_v1_event)  
+  
+-   [GCCreateSegment\_V1 イベント](#gccreatesegment_v1_event)  
+  
+-   [GCFreeSegment\_V1 イベント](#gcfreesegment_v1_event)  
+  
+-   [GCRestartEEBegin\_V1 イベント](#gcrestarteebegin_v1_event)  
+  
+-   [GCRestartEEEnd\_V1 イベント](#gcrestarteeend_v1_event)  
+  
+-   [GCSuspendEE\_V1 イベント](#gcsuspendee_v1_event)  
+  
+-   [GCSuspendEEEnd\_V1 イベント](#gcsuspendeeend_v1_event)  
+  
+-   [GCAllocationTick\_V2 イベント](#gcallocationtick_v2_event)  
+  
+-   [GCFinalizersBegin\_V1 イベント](#gcfinalizersbegin_v1_event)  
+  
+-   [GCFinalizersEnd\_V1 イベント](#gcfinalizersend_v1_event)  
+  
+-   [GCCreateConcurrentThread\_V1 イベント](#gccreateconcurrentthread_v1_event)  
+  
+-   [GCTerminateConcurrentThread\_V1 イベント](#gcterminateconcurrentthread_v1_event)  
+  
+<a name="gcstart_v1_event"></a>   
+## GCStart\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCStart_V1`|1|ガベージ コレクションが開始されました。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt32|*n* 回めのガベージ コレクション。|  
+|奥行|win:UInt32|収集されるジェネレーション。|  
+|理由|win:UInt32|ガベージ コレクションが発生した理由:<br /><br /> 0x0 \- 小さなオブジェクト ヒープの割り当て。<br /><br /> 0x1 \- 強制実行。<br /><br /> 0x2 \- メモリ不足。<br /><br /> 0x3 \- 空。<br /><br /> 0x4 \- 大きなオブジェクト ヒープの割り当て。<br /><br /> 0x5 \- 領域不足 \(小さなオブジェクト ヒープが対象\)。<br /><br /> 0x6 \- 領域不足 \(大きなオブジェクト ヒープが対象\)。<br /><br /> 0x7 \- 強制実行されるが、ブロッキングとして強制されない。|  
+|型|win:UInt32|0x0 \- バックグラウンド ガベージ コレクションの外部で発生するブロッキング ガベージ コレクション。<br /><br /> 0x1 \- バックグラウンド ガベージ コレクション。<br /><br /> 0x2 \- バックグラウンド ガベージ コレクションの実行中に発生するブロッキング ガベージ コレクション。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcend_v1_event"></a>   
+## GCEnd\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCEnd_V1`|2|ガベージ コレクションが終了しました。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt32|*n* 回めのガベージ コレクション。|  
+|奥行|win:UInt32|収集されたジェネレーション。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcheapstats_v1_event"></a>   
+## GCHeapStats\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`GCHeapStats_V1`|4|各ガベージ コレクション終了時のヒープの統計情報を示します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|GenerationSize0|win:UInt64|ジェネレーション 0 メモリのサイズ \(バイト単位\)。|  
+|TotalPromotedSize0|win:UInt64|ジェネレーション 0 からジェネレーション 1 に移されたバイト数。|  
+|GenerationSize1|win:UInt64|ジェネレーション 1 メモリのサイズ \(バイト単位\)。|  
+|TotalPromotedSize1|win:UInt64|ジェネレーション 1 からジェネレーション 2 に移されたバイト数。|  
+|GenerationSize2|win:UInt64|ジェネレーション 2 メモリのサイズ \(バイト単位\)。|  
+|TotalPromotedSize2|win:UInt64|最後のガベージ コレクションの後にジェネレーション 2 に残ったバイト数。|  
+|GenerationSize3|win:UInt64|大きなオブジェクト ヒープのサイズ \(バイト単位\)。|  
+|TotalPromotedSize3|win:UInt64|最後のガベージ コレクションの後に大きなオブジェクト ヒープに残ったバイト数。|  
+|FinalizationPromotedSize|win:UInt64|終了準備が完了しているオブジェクトの合計サイズ \(バイト単位\)。|  
+|FinalizationPromotedCount|win:UInt64|終了準備が完了しているオブジェクトの数。|  
+|PinnedObjectCount|win:UInt32|ピン止めオブジェクト \(移動できないオブジェクト\) の数。|  
+|SinkBlockCount|win:UInt32|使用中の同期ブロックの数。|  
+|GCHandleCount|win:UInt32|使用中のガベージ コレクション ハンドルの数。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gccreatesegment_v1_event"></a>   
+## GCCreateSegment\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCCreateSegment_V1`|5|新しいガベージ コレクション セグメントが作成されました。 既に実行されているプロセスでトレースを有効にした場合は、このイベントが各既存セグメントについて発生します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|アドレス|win:UInt64|セグメントのアドレス。|  
+|サイズ|win:UInt64|セグメントのサイズ。|  
+|型|win:UInt32|0x0 \- 小さなオブジェクト ヒープ。<br /><br /> 0x1 \- 大きなオブジェクト ヒープ。<br /><br /> 0x2 \- 読み取り専用ヒープ。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ ガベージ コレクターによって割り当てられるセグメントのサイズは実装に固有であり、定期的な更新プログラムによる場合を含め、いつでも変更されることがあります。 アプリでは、セグメント サイズを推測することや、特定のセグメント サイズに依存することを絶対に避けてください。また、セグメントの割り当てに使用可能なメモリの量を構成しようとしてもなりません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcfreesegment_v1_event"></a>   
+## GCFreeSegment\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCFreeSegment_V1`|6|ガベージ コレクション セグメントが解放されました。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|アドレス|win:UInt64|セグメントのアドレス。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcrestarteebegin_v1_event"></a>   
+## GCRestartEEBegin\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCRestartEEBegin_V1`|7|共通言語ランタイムの中断からの再開が開始されました。|  
+  
+ イベント データはありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcrestarteeend_v1_event"></a>   
+## GCRestartEEEnd\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCRestartEEEnd_V1`|3|共通言語ランタイムの中断からの再開が終了しました。|  
+  
+ イベント データはありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcsuspendee_v1_event"></a>   
+## GCSuspendEE\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCSuspendEE_V1`|9|ガベージ コレクションのための実行エンジンの中断の開始。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|理由|win:UInt16|0x0 \- その他。<br /><br /> 0x1 \- ガベージ コレクション。<br /><br /> 0x2 \- アプリケーション ドメインのシャットダウン。<br /><br /> 0x3 \- コード ピッチ。<br /><br /> 0x4 \- シャットダウン。<br /><br /> 0x5 \- デバッガー。<br /><br /> 0x6 \- ガベージ コレクションの準備。|  
+|カウント|win:UInt32|中断されるスレッドの数。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcsuspendeeend_v1_event"></a>   
+## GCSuspendEEEnd\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCSuspendEEEnd_V1`|9|ガベージ コレクションのための実行エンジンの中断の終了。|  
+  
+ イベント データはありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcallocationtick_v2_event"></a>   
+## GCAllocationTick\_V2 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCAllocationTick_V2`|10|約 100 KB が割り当てられるたび。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AllocationAmount|win:UInt32|割り当てサイズ \(バイト単位\)。 この値は、ULONG \(4,294,967,295 バイト\) の長さより短い割り当ての場合に正確です。 割り当てがこれを超える場合、このフィールドには切り捨てられた値が含まれます。 非常に大きな割り当てには `AllocationAmount64` を使用します。|  
+|AllocationKind|win:UInt32|0x0 \- 小さなオブジェクトの割り当て \(小さなオブジェクト ヒープへの割り当て\)。<br /><br /> 0x1 \- 大きなオブジェクトの割り当て \(大きなオブジェクト ヒープへの割り当て\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+|AllocationAmount64|win:UInt64|割り当てサイズ \(バイト単位\)。 この値は非常に大きな割り当ての場合に正確です。|  
+|TypeId|win:Pointer|MethodTable のアドレス。 このイベント中に複数の型のオブジェクトが割り当てられた場合、これは最後に割り当てられたオブジェクト \(100 KB のしきい値を超えたオブジェクト\) に対応する MethodTable のアドレスです。|  
+|TypeName|win:UnicodeString|割り当てられた型の名前。 このイベント中に複数の型のオブジェクトが割り当てられた場合は、これは最後に割り当てられたオブジェクト \(100 KB のしきい値を超えたオブジェクト\) の型です。|  
+|HeapIndex|win:UInt32|オブジェクトが割り当てられたヒープ。 ワークステーションのガベージ コレクションと共に実行する場合、この値は 0 \(ゼロ\) になります。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcfinalizersbegin_v1_event"></a>   
+## GCFinalizersBegin\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCFinalizersBegin_V1`|14|ファイナライザーの実行の開始。|  
+  
+ イベント データはありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcfinalizersend_v1_event"></a>   
+## GCFinalizersEnd\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCFinalizersEnd_V1`|13|ファイナライザーの実行の終了。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt32|実行されたファイナライザーの数。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gccreateconcurrentthread_v1_event"></a>   
+## GCCreateConcurrentThread\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCCreateConcurrentThread_V1`|11|同時実行ガベージ コレクション スレッドが作成されました。|  
+  
+ イベント データはありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="gcterminateconcurrentthread_v1_event"></a>   
+## GCTerminateConcurrentThread\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`GCKeyword` \(0x1\)|情報提供 \(4\)|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`GCTerminateConcurrentThread_V1`|12|同時実行ガベージ コレクションスレッドが終了しました。|  
+  
+ イベント データはありません。  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/how-to-perform-lazy-initialization-of-objects.md b/docs/framework/performance/how-to-perform-lazy-initialization-of-objects.md
new file mode 100644
index 00000000000..819f6e89969
--- /dev/null
+++ b/docs/framework/performance/how-to-perform-lazy-initialization-of-objects.md
@@ -0,0 +1,83 @@
+---
+title: "方法: オブジェクトの遅延初期化を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "限定的な初期化 (.NET での), 方法 (実行する)"
+ms.assetid: 8cd68620-dcc3-4f20-8835-c728a6820e71
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: オブジェクトの遅延初期化を実行する
+<xref:System.Lazy%601?displayProperty=fullName> クラスを使用すると、オブジェクトの限定的な初期化およびインスタンス化を実行する操作が簡略化されます。  限定的な方法でオブジェクトを初期化することにより、不要なオブジェクトを作成する必要がなくなります。また、オブジェクトに初めてアクセスするときまで、そのオブジェクトの初期化を延期できます。  詳細については、「[限定的な初期化](../../../docs/framework/performance/lazy-initialization.md)」を参照してください。  
+  
+## 使用例  
+ <xref:System.Lazy%601> で値を初期化する方法を次の例に示します。  `someCondition` 変数を true または false に設定する他の一部のコードでは、限定的な変数は必要ないものとします。  
+  
+```vb  
+Dim someCondition As Boolean = False  
+  
+Sub Main()  
+    'Initializing a value with a big computation, computed in parallel  
+    Dim _data As Lazy(Of Integer) = New Lazy(Of Integer)(Function()  
+                                                             Dim result =  
+                                                                 ParallelEnumerable.Range(0, 1000).  
+                                                                 Aggregate(Function(x, y)  
+                                                                               Return x + y  
+                                                                           End Function)  
+                                                             Return result  
+                                                         End Function)  
+  
+    '  do work that may or may not set someCondition to True  
+    ' ...  
+    '  Initialize the data only if needed  
+    If someCondition = True Then  
+  
+        If (_data.Value > 100) Then  
+  
+            Console.WriteLine("Good data")  
+        End If  
+    End If  
+End Sub  
+```  
+  
+```csharp  
+  static bool someCondition = false;    
+  //Initializing a value with a big computation, computed in parallel  
+  Lazy<int> _data = new Lazy<int>(delegate  
+  {  
+      return ParallelEnumerable.Range(0, 1000).  
+          Select(i => Compute(i)).Aggregate((x,y) => x + y);  
+  }, LazyExecutionMode.EnsureSingleThreadSafeExecution);  
+  
+  // Do some work that may or may not set someCondition to true.  
+  //  ...  
+  // Initialize the data only if necessary  
+  if (someCondition)  
+{  
+    if (_data.Value > 100)  
+      {  
+          Console.WriteLine("Good data");  
+      }  
+}  
+```  
+  
+## 使用例  
+ 次の例は、<xref:System.Threading.ThreadLocal%601?displayProperty=fullName> クラスを使用して、現在のスレッド上の現在のオブジェクト インスタンスからのみアクセスできる型を初期化する方法を示しています。  
+  
+ [!code-csharp[CDS#13](../../../samples/snippets/csharp/VS_Snippets_Misc/cds/cs/cds2.cs#13)]
+ [!code-vb[CDS#13](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds/vb/lazyhowto.vb#13)]  
+  
+## 参照  
+ <xref:System.Threading.LazyInitializer?displayProperty=fullName>   
+ [限定的な初期化](../../../docs/framework/performance/lazy-initialization.md)
\ No newline at end of file
diff --git a/docs/framework/performance/index.md b/docs/framework/performance/index.md
new file mode 100644
index 00000000000..ece8ea9f38f
--- /dev/null
+++ b/docs/framework/performance/index.md
@@ -0,0 +1,68 @@
+---
+title: ".NET Framework Performance | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "performance [.NET Framework]"
+  - "reliability [.NET Framework]"
+ms.assetid: c1676cca-3f1a-41ec-b469-9029566074fc
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# .NET Framework Performance
+優れたパフォーマンスのアプリを作成する場合は、アプリのその他の機能を設計する場合と同様に、パフォーマンスについて設計および計画する必要があります。  Microsoft が提供するツールを使用して、アプリのパフォーマンスを測定し、必要に応じて、メモリの使用、コードのスループット コード、および応答性を向上させることができます。  ここでは、Microsoft が提供するパフォーマンス分析ツールの一覧と、アプリ開発の特定の領域のパフォーマンスに関する他のトピックへのリンクを示します。  
+  
+## パフォーマンスのための設計と計画  
+ 優れたパフォーマンスのアプリが必要な場合は、他の機能を設計する場合と同様に、パフォーマンスの設計をアプリに組み込む必要があります。  アプリのパフォーマンスが重要なシナリオを決定し、パフォーマンスの目標を設定して、それらのアプリのシナリオのパフォーマンスを早い段階から頻繁に計測する必要があります。  アプリはそれぞれ異なり、パフォーマンスが重要な実行パスも異なるため、このようなパスを早期に特定し、労力を集中させることによって生産性を最大化できます。  
+  
+ 高いパフォーマンスのアプリを作成するために、ターゲット プラットフォームを完全に理解する必要はありません。  ただし、ターゲット プラットフォームのどの部分が、パフォーマンスの面で大きな負担が生じるのかを理解しておく必要があります。  開発プロセスの早い段階でパフォーマンスの計測することで、これを実現できます。  
+  
+ パフォーマンスにとって重要な領域を特定し、パフォーマンスの目標を確立するには、ユーザー エクスペリエンスを常に検討します。  起動時間と応答性は、ユーザーのアプリに対する認識に影響する 2 つの重要な部分です。  アプリが多くのメモリを使用する場合、ユーザーにとっては動作が遅いように見えたり、システムで実行中の他のアプリに影響を与える可能性があります。また、Windows ストアや Windows Phone ストアの送信プロセスでエラーとなる可能性もあります。  また、コードのどの部分を頻繁に実行するかを判断すると、コード内でこれらの部分が適切に最適化されていることを確認できます。  
+  
+## パフォーマンスを分析する  
+ 全体的な開発計画の一部として、開発中にアプリのパフォーマンスを計測し、その結果を以前に設定した目標と比較するポイントを設定します。  ユーザーが使用すると想定している環境およびハードウェアでアプリを計測します。  アプリのパフォーマンスを早い段階で頻繁に分析することによって、開発サイクルの後半ではコストがかかり、負担の大きいアーキテクチャの決定を変更できます。  次のセクションでは、アプリの分析に使用できるパフォーマンス ツールと、これらのツールによって使用さえるイベント トレーシングについて説明します。  
+  
+### パフォーマンス ツール  
+ .NET Framework アプリで使用できるパフォーマンス ツールの一部を次に示します。  
+  
+|ツール|説明|  
+|---------|--------|  
+|Visual Studio パフォーマンス分析|Windows オペレーティング システムを実行しているコンピューターに配置されている .NET Framework アプリの CPU 使用量の分析に使用します。<br /><br /> このツールは、Visual Studio でプロジェクトを開いた後、**\[デバッグ\]** メニューから使用できます。  詳細については、「[プロファイリング ツールの使用](../Topic/Performance%20Explorer.md)」を参照してください。 **Note:**  Windows Phone を対象とする場合は、Windows Phone アプリケーション分析を使用します \(次の行を参照してください\)。|  
+|Windows Phone アプリケーション分析|Windows Phone アプリの CPU やメモリ、ネットワーク データ転送率、アプリの応答性、バッテリの使用量の分析に使用します。<br /><br /> このツールは、[Windows Phone SDK](http://go.microsoft.com/fwlink/?LinkId=265773) のインストール後に、 WIndows Phone プロジェクトの **\[デバッグ\]** メニューから使用できます。  詳細については、「[Windows Phone のアプリのプロファイリング](http://msdn.microsoft.com/library/windowsphone/develop/jj215908\(v=vs.105\).aspx)」を参照してください。|  
+|[PerfView](http://www.microsoft.com/download/details.aspx?id=28567)|CPU とメモリ関連のパフォーマンスの問題を識別するために使用します。  このツールは、Windows イベント トレーシング \(ETW\) と CLR プロファイル API を使用して、メモリと CPU の高度な調査およびガベージ コレクションや JIT コンパイルに関する情報を提供します。  PerfView を使用する方法の詳細については、アプリに含まれるチュートリアルやヘルプ ファイル、[Channel 9 のビデオ チュートリアル](http://channel9.msdn.com/Series/PerfView-Tutorial)、および[ブログの投稿](http://blogs.msdn.com/b/vancem/archive/tags/perfview/) を参照してください。<br /><br /> メモリ固有の問題については、「[Using PerfView for Memory Investigations \(PerfView を使用したメモリの調査\)](http://channel9.msdn.com/Series/PerfView-Tutorial/PerfView-Tutorial-9-NET-Memory-Investigation-Basics-of-GC-Heap-Snapshots)」を参照してください。|  
+|[Windows Performance Analyzer](http://www.microsoft.com/download/details.aspx?id=30652)|複数のアプリが同じコンピューターで実行されているときに、アプリのメモリやストレージの使用量などの全体的なシステム パフォーマンスを特定するために使用します。  このツールは、[!INCLUDE[win8](../../../includes/win8-md.md)] 用の Windows アセスメント & デプロイメント キット \(ADK\) の一部としてダウンロード センターから使用できます。  詳細については、「[Windows Performance Analyzer](http://msdn.microsoft.com/library/windows/desktop/hh448170.aspx)」を参照してください。|  
+  
+### Windows イベント トレーシング \(ETW\)  
+ ETW は、実行中のコードに関する診断情報を取得できるようにする手法であり、前に説明したパフォーマンス ツールの多くで必要なテクノロジです。  ETW は、特定のイベントが .NET Framework アプリおよび Windows によって発生したときにログを作成します。  ETW を使用すると、ログの記録を動的に有効または無効にすることができ、稼動環境でアプリを再起動せずに詳細なトレースを実行できます。  .NET Framework は ETW イベントをサポートしており、ETW はパフォーマンス データを生成する多くのプロファイル ツールやパフォーマンス ツールで使用されます。  これらのツールは、ETW イベントを有効または無効にするため、ETW イベントの知識が役立ちます。  アプリの特定のコンポーネントに関するパフォーマンス情報を収集するために、特定の ETW イベントを使用できます。  .NET Framework での ETW のサポートの詳細については、「[共通言語ランタイムの ETW イベント](../../../docs/framework/performance/etw-events-in-the-common-language-runtime.md)」と「[タスク並列ライブラリおよび PLINQ での ETW イベント](../../../docs/framework/performance/etw-events-in-task-parallel-library-and-plinq.md)」を参照してください。  
+  
+## アプリの種類別のパフォーマンス  
+ .NET Framework アプリの種類ごとに、パフォーマンスを評価するためのベスト プラクティス、考慮事項、およびツールがあります。  次の表では、特定の種類の .NET Framework アプリのパフォーマンスに関するトピックへのリンクを示します。  
+  
+|アプリの種類|参照トピック|  
+|------------|------------|  
+|すべてのプラットフォームに対応した .NET Framework アプリ|[Garbage Collection and Performance](../../../docs/standard/garbage-collection/performance.md)<br /><br /> [パフォーマンスに関するヒント](../../../docs/framework/performance/performance-tips.md)|  
+|C\+\+、C\#、および Visual Basic で記述された [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリ|[C\+\+、C\#、または Visual Basic を使った Windows ストア アプリのパフォーマンスのベスト プラクティス](http://msdn.microsoft.com/library/windows/apps/hh750313.aspx)|  
+|Windows Phone|[Windows Phone 用アプリのパフォーマンス上の考慮事項](http://msdn.microsoft.com/library/windowsphone/develop/ff967560\(v=vs.105\).aspx)<br /><br /> [Windows Phone アプリケーションの分析](http://msdn.microsoft.com/library/windowsphone/develop/hh202934\(v=vs.105\).aspx)<br /><br /> [Windows Phone アプリケーションを Marketplace にいち早く公開する](http://msdn.microsoft.com/magazine/hh781024.aspx)|  
+|Windows Presentation Foundation \(WPF\)|[WPF Performance Suite](../Topic/WPF%20Performance%20Suite.md)|  
+|Silverlight|[パフォーマンスに関するヒント](http://msdn.microsoft.com/library/cc189071\(v=vs.95\).aspx)|  
+|ASP.NET|[ASP.NET Performance Overview](../Topic/ASP.NET%20Performance%20Overview.md)|  
+|Windows フォーム|[Practical Tips for Boosting the Performance of Windows Forms Apps \(Windows フォーム アプリのパフォーマンスを向上させるための実践的なヒント\)](http://msdn.microsoft.com/magazine/cc163630.aspx)|  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[.NET Framework アプリケーションでのキャッシュ](../../../docs/framework/performance/caching-in-net-framework-applications.md)|データをキャッシュしてアプリケーションのパフォーマンスを向上させる手法について説明します。|  
+|[限定的な初期化](../../../docs/framework/performance/lazy-initialization.md)|特にアプリの起動時にパフォーマンスを向上させるために、必要に応じてオブジェクトを初期化する方法について説明します。|  
+|[信頼性](../../../docs/framework/performance/reliability.md)|サーバー環境での非同期例外の発生防止について説明します。|  
+|[規模が大きく、応答性の高い .NET Framework アプリの作成](../../../docs/framework/performance/writing-large-responsive-apps.md)|マネージ コードで C\# および Visual Basic コンパイラを再作成する際に得られたパフォーマンスに関するヒントを説明し、C\# コンパイラでの実際の例をいくつか紹介します。|
\ No newline at end of file
diff --git a/docs/framework/performance/interop-etw-events.md b/docs/framework/performance/interop-etw-events.md
new file mode 100644
index 00000000000..ecfb7eb594c
--- /dev/null
+++ b/docs/framework/performance/interop-etw-events.md
@@ -0,0 +1,92 @@
+---
+title: "相互運用 ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, 相互運用イベント (CLR)"
+  - "相互運用イベント [.NET Framework]"
+ms.assetid: eb6eac2e-45f4-4923-a32c-38f203da66df
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 相互運用 ETW イベント
+<a name="top"></a> 相互運用イベントは、Microsoft intermediate language \(MSIL\) のスタブ生成とキャッシュに関する情報をキャプチャします。  
+  
+ このカテゴリは、次のイベントで構成されます。  
+  
+-   [ILStubGenerated イベント](#ilstubgenerated_event)  
+  
+-   [ILStubCacheHit イベント](#ilstubcachehit_event)  
+  
+<a name="ilstubgenerated_event"></a>   
+## ILStubGenerated イベント  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`InteropKeyword` \(0x2000\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ILStubGenerated`|88|MSIL スタブが生成された。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ModuleID|win:UInt16|モジュールの識別子。|  
+|StubMethodID|win:UInt64|スタブのメソッド識別子。|  
+|StubFlags|win:UInt64|スタブのフラグ:<br /><br /> 0x1 \- 逆方向の相互運用。<br /><br /> 0x2 \- COM 相互運用。<br /><br /> 0x4 \- NGen.exe で生成されたスタブ。<br /><br /> 0x8 \- デリゲート。<br /><br /> 0x10 \- 可変個引数。<br /><br /> 0x20 \- アンマネージ呼び出し先。|  
+|ManagedInteropMethodToken|win:UInt32|マネージ相互運用メソッドのトークンです。|  
+|ManagedInteropMethodNameSpace|win:UnicodeString|マネージ相互運用メソッドの名前空間。|  
+|ManagedInteropMethodName|win:UnicodeString|マネージ相互運用メソッドの名前。|  
+|ManagedInteropMethodSignature|win:UnicodeString|マネージ相互運用メソッドのシグネチャ。|  
+|NativeMethodSignature|win:UnicodeString|ネイティブ メソッド シグネチャ。|  
+|StubMethodSignature|win:UnicodeString|スタブ メソッド シグネチャ。|  
+|StubMethodILCode|win:UnicodeString|スタブ メソッドの MSIL コード。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="ilstubcachehit_event"></a>   
+## ILStubCacheHit イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`InteropKeyword` \(0x2000\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`ILStubCacheHit`|89|MSIL のキャッシュにアクセスがあった。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ModuleID|win:UInt16|モジュールの識別子。|  
+|StubMethodID|win:UInt64|スタブのメソッド識別子。|  
+|ManagedInteropMethodToken|win:UInt32|マネージ相互運用メソッドのトークンです。|  
+|ManagedInteropMethodNameSpace|win:UnicodeString|マネージ相互運用メソッドの名前空間。|  
+|ManagedInteropMethodName|win:UnicodeString|マネージ相互運用メソッドの名前。|  
+|ManagedInteropMethodSignature|win:UnicodeString|マネージ相互運用メソッドのシグネチャ。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/jit-tracing-etw-events.md b/docs/framework/performance/jit-tracing-etw-events.md
new file mode 100644
index 00000000000..dcaf1d3e08b
--- /dev/null
+++ b/docs/framework/performance/jit-tracing-etw-events.md
@@ -0,0 +1,158 @@
+---
+title: "JIT トレース ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, JIT トレース イベント (CLR)"
+  - "JIT トレース イベント [.NET Framework]"
+ms.assetid: 926adde2-c123-452e-bf4f-4b977bf06ffb
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# JIT トレース ETW イベント
+<a name="top"></a> これらのイベントは、Just\-in\-time \(JIT\) インライン展開と JIT 末尾呼び出しの成功または失敗に関する情報を収集します。  
+  
+ JIT トレース イベントは、次の 2 つのカテゴリで構成されます。  
+  
+-   [JIT インライン展開イベント](#jit_inlining_events)  
+  
+-   [JIT 末尾呼び出しイベント](#jit_tail_call_events)  
+  
+<a name="jit_inlining_events"></a>   
+## JIT インライン展開イベント  
+  
+### MethodJitInliningFailed イベント  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITTracingKeyword` \(0x10\)|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`MethodJitInliningFailed`|186|JIT インライン展開が失敗した。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodBeingCompiledNameSpace|win:UnicodeString|コンパイルされるメソッドの名前空間。|  
+|MethodBeingCompiledName|win:UnicodeString|コンパイルされるメソッドの名前。|  
+|MethodBeingCompiledNameSignature|win:UnicodeString|コンパイルされるメソッドのシグネチャ。|  
+|InlinerNamespace|win:UnicodeString|JIT コンパイラのコード生成の対象であるメソッドの名前空間。|  
+|InlinerName|win:UnicodeString|コンパイラのコード生成の対象であるメソッドの名前。 コンパイラが `InlinerName` への呼び出しを生成するのではなく `MethodBeingCompiledName` へのインライン コードを生成しようとしている場合、これは `MethodBeingCompiledName` とは異なる可能性があります。|  
+|InlinerNameSignature|win:UnicodeString|このインライナのシグネチャは次のとおりです。|  
+|InlineeNamespace|win:UnicodeString|インライン展開先の名前空間。|  
+|InlineeName|win:UnicodeString|コンパイラによるインライン先のメソッド \(呼び出しの生成先ではない\)。|  
+|InlineeNameSignature|win:UnicodeString|インライン展開先のシグネチャ。|  
+|FailAlways|win:Boolean|そのインライン展開先に対してインライン展開が常に失敗するという JIT コンパイラへのヒント。|  
+|FailReason|win:UnicodeString|INLINE\_NEVER は、前回のインライン展開の試みで、インライン展開が他の理由により成功しないと判断されたことを意味します。それ以外の場合は、自由形式のテキストです。|  
+|ClrInstanceID|win:UnicodeString|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### MethodJitInliningSucceeded イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITTracingKeyword` \(0x10\)|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`MethodJitInliningSucceeded`|185|メソッドのインライン展開が成功した。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodBeingCompiledNameSpace|win:UnicodeString|コンパイルされるメソッドの名前空間。|  
+|MethodBeingCompiledName|win:UnicodeString|コンパイルされるメソッドの名前。|  
+|MethodBeingCompiledNameSignature|win:UnicodeString|コンパイルされるメソッドのシグネチャ。|  
+|InlinerNamespace|win:UnicodeString|JIT コンパイラのコード生成の対象であるメソッドの名前空間。|  
+|InlinerName|win:UnicodeString|コンパイラのコード生成の対象であるメソッドの名前。 コンパイラが `InlinerName` への呼び出しを生成するのではなく `MethodBeingCompiledName` へのインライン コードを生成しようとしている場合、これは `MethodBeingCompiledName` とは異なる可能性があります。|  
+|InlinerNameSignature|win:UnicodeString|このインライナのシグネチャは次のとおりです。|  
+|InlineeNamespace|win:UnicodeString|インライン展開先の名前空間。|  
+|InlineeName|win:UnicodeString|コンパイラによるインライン先のメソッド \(呼び出しの生成先ではない\)。|  
+|InlineeNameSignature|win:UnicodeString|インライン展開先のシグネチャ。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="jit_tail_call_events"></a>   
+## JIT 末尾呼び出しイベント  
+  
+### MethodJITTailCallFailed イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITTracingKeyword` \(0x10\)|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`MethodJitTailCallFailed`|189|メソッドの末尾の呼び出しが失敗した。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodBeingCompiledNameSpace|win:UnicodeString|コンパイルされるメソッドの名前空間。|  
+|MethodBeingCompiledName|win:UnicodeString|コンパイルされるメソッドの名前。|  
+|MethodBeingCompiledNameSignature|win:UnicodeString|コンパイルされるメソッドのシグネチャ。|  
+|CallerNamespace|win:UnicodeString|JIT コンパイラのコード生成の対象であるメソッドの名前空間。|  
+|CallerName|win:UnicodeString|コンパイラのコード生成の対象であるメソッドの名前。|  
+|CallerNameSignature|win:UnicodeString|呼び出し元のシグネチャ。|  
+|CalleeNamespace|win:UnicodeString|呼び出し先の名前空間。|  
+|CalleeName|win:UnicodeString|コンパイラによる末尾呼び出し先のメソッド \(呼び出しの生成先ではない\)。|  
+|CalleeNameSignature|win:UnicodeString|呼び出し先のシグネチャ。|  
+|TailPrefix|win:Boolean|末尾呼び出しのプレフィックス。|  
+|FailReason|win:UnicodeString|末尾の呼び出しが失敗した理由。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### MethodJITTailCallSucceeded イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITTracingKeyword` \(0x10\)|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`MethodJitTailCallSucceeded`|188|メソッドの末尾の呼び出しが成功した。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodBeingCompiledNameSpace|win:UnicodeString|コンパイルされるメソッドの名前空間。|  
+|MethodBeingCompiledName|win:UnicodeString|コンパイルされるメソッドの名前。|  
+|MethodBeingCompiledNameSignature|win:UnicodeString|コンパイルされるメソッドのシグネチャ。|  
+|CallerNamespace|win:UnicodeString|JIT コンパイラのコード生成の対象であるメソッドの名前空間。|  
+|CallerName|win:UnicodeString|コンパイラのコード生成の対象であるメソッドの名前。|  
+|CallerNameSignature|win:UnicodeString|呼び出し元のシグネチャ。|  
+|CalleeNamespace|win:UnicodeString|呼び出し先の名前空間。|  
+|CalleeName|win:UnicodeString|コンパイラによる末尾呼び出し先のメソッド \(呼び出しの生成先ではない\)。|  
+|CalleeNameSignature|win:UnicodeString|呼び出し先のシグネチャ。|  
+|TailPrefix|win:Boolean|末尾呼び出しのプレフィックス。|  
+|TailCallType|win:UnicodeString|末尾呼び出しの種類。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/lazy-initialization.md b/docs/framework/performance/lazy-initialization.md
new file mode 100644
index 00000000000..2746d6ec9a6
--- /dev/null
+++ b/docs/framework/performance/lazy-initialization.md
@@ -0,0 +1,161 @@
+---
+title: "限定的な初期化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "限定的な初期化 (.NET での), 概要"
+ms.assetid: 56b4ae5c-4745-44ff-ad78-ffe4fcde6b9b
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 限定的な初期化
+オブジェクトの*限定的な初期化*とは、初めて使用されるときまでオブジェクトの作成を延期することです \(このトピックでは、"*限定的な初期化*" と "*限定的なインスタンス化*" という用語を同じ意味で使用しています\)。限定的な初期化は主に、パフォーマンスの向上、無駄な計算の回避、およびプログラムのメモリ要件の軽減を目的として使用されます。  最も一般的なシナリオは次のとおりです。  
+  
+-   オブジェクトの作成時の負荷が高く、プログラムではそれを使用しない可能性がある場合。  たとえば、メモリにある `Customer` オブジェクトの `Orders` プロパティに `Order` オブジェクトの大きな配列が格納されていて、このオブジェクトを初期化するにはデータベースに接続する必要があるとします。  Orders のデータを表示したり計算で使用したりすることをユーザーから要求されない限り、そのオブジェクトを作成するためにシステム メモリや計算サイクルを使用する必要はありません。  `Orders` オブジェクトの宣言で `Lazy<Orders>` を使用して限定的な初期化を指定すると、オブジェクトが使用されていないときのシステム リソースの浪費を回避できます。  
+  
+-   オブジェクトの作成時の負荷が高く、負荷が高い他の操作が完了するまでそのオブジェクトの作成を延期する場合。  たとえば、プログラムの起動時にいくつかのオブジェクト インスタンスが読み込まれても、すぐに必要なものはそのうちの一部だけであるとします。  この場合、必要なオブジェクトが作成されるまで不要なオブジェクトの初期化を延期すると、プログラムの起動時のパフォーマンスを向上させることができます。  
+  
+ 限定的な初期化を実行するためのコードは独自に記述することもできますが、代わりに <xref:System.Lazy%601> を使用することをお勧めします。  <xref:System.Lazy%601> とその関連型はスレッド セーフもサポートしており、例外の反映ポリシーにも一貫性があります。  
+  
+ 限定的な初期化をさまざまなシナリオで有効にするために用意されている .NET Framework Version 4 の型の一覧を次に示します。  
+  
+|型|説明|  
+|-------|--------|  
+|<xref:System.Lazy%601>|任意のクラス ライブラリまたはユーザー定義の型に限定的な初期化のセマンティクスを提供するラッパー クラスです。|  
+|<xref:System.Threading.ThreadLocal%601>|<xref:System.Lazy%601> に似ていますが、スレッド ローカルに基づく限定的な初期化のセマンティクスを提供します。  各スレッドは、独自の一意の値にアクセスできます。|  
+|<xref:System.Threading.LazyInitializer>|クラスのオーバーヘッドがないオブジェクトの限定的な初期化のために、高度な `static` \(Visual Basic では `Shared`\) メソッドを提供します。|  
+  
+## 基本の限定的な初期化  
+ たとえば `MyType` という限定的に初期化された型を定義するには、次の例に示すように、`Lazy<MyType>` \(Visual Basic では `Lazy(Of MyType)`\) を使用します。  <xref:System.Lazy%601> コンストラクターにデリゲートが渡されていない場合、値プロパティに最初にアクセスしたときに、ラップされた型が <xref:System.Activator.CreateInstance%2A?displayProperty=fullName> を使用して作成されます。  型に既定のコンストラクターがない場合は、実行時例外がスローされます。  
+  
+ 次の例では、`Orders` というクラスに、データベースから取得される `Order` オブジェクトの配列が含まれているものとします。  `Customer` オブジェクトに `Orders` のインスタンスが含まれていますが、ユーザーの操作によっては、`Orders` オブジェクトのデータが不要な場合があります。  
+  
+ [!code-csharp[Lazy#1](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#1)]
+ [!code-vb[Lazy#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#1)]  
+  
+ 次の例に示すように、ラップされた型に対する特定のコンストラクター オーバーロードを作成時に呼び出す <xref:System.Lazy%601> コンストラクターにデリゲートを渡して、必要な他の初期化の手順を実行することもできます。  
+  
+ [!code-csharp[Lazy#2](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#2)]
+ [!code-vb[Lazy#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#2)]  
+  
+ 限定的なオブジェクトの作成後、限定的な変数の <xref:System.Lazy%601.Value%2A> プロパティに初めてアクセスするまでは、`Orders` は作成されません。  最初のアクセス時に、ラップされた型が作成されて返され、後でアクセスできるように保存されます。  
+  
+ [!code-csharp[Lazy#3](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#3)]
+ [!code-vb[Lazy#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#3)]  
+  
+ <xref:System.Lazy%601> オブジェクトは、初期化の際に使用されたものと同じオブジェクトまたは値を常に返します。  したがって、<xref:System.Lazy%601.Value%2A> プロパティは読み取り専用です。  <xref:System.Lazy%601.Value%2A> に参照型が格納されている場合、それに新しいオブジェクトを割り当てることはできません \(ただし、設定可能なパブリック フィールドとプロパティの値は変更できます\)。<xref:System.Lazy%601.Value%2A> に値型が格納されている場合、その値を変更することはできません。  ただし、新しい引数を使用して変数のコンストラクターをもう一度呼び出すと、新しい変数を作成できます。  
+  
+ [!code-csharp[Lazy#4](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#4)]
+ [!code-vb[Lazy#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#4)]  
+  
+ 前の例と同様に、この新しい限定的なインスタンスでは、<xref:System.Lazy%601.Value%2A> プロパティに初めてアクセスするまで `Orders` がインスタンス化されません。  
+  
+### スレッド セーフな初期化  
+ 既定では、<xref:System.Lazy%601> オブジェクトはスレッド セーフです。  つまり、コンストラクターでスレッド セーフの種類を指定しない場合、作成される <xref:System.Lazy%601> オブジェクトはスレッド セーフです。  マルチスレッドのシナリオでは、スレッド セーフな <xref:System.Lazy%601> オブジェクトの <xref:System.Lazy%601.Value%2A> プロパティに最初にアクセスしたスレッドが初期化を行います。その後はどのスレッドからもそのデータにアクセスするため、すべてのスレッドで同じデータが共有されます。  したがって、どのスレッドがオブジェクトを初期化したかは問題にならず、競合状態が発生しません。  
+  
+> [!NOTE]
+>  例外のキャッシュを使用する場合、この一貫性はエラー状態にも当てはまります。  詳細については、次のセクション" [遅延オブジェクトの例外](../../../docs/framework/performance/lazy-initialization.md#ExceptionsInLazyObjects)参照します。  
+  
+ 3 つの異なるスレッドで、同じ値を持つ同じ `Lazy<int>` インスタンスを使用している例を次に示します。  
+  
+ [!code-csharp[Lazy#8](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#8)]
+ [!code-vb[Lazy#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#8)]  
+  
+ スレッドごとに異なるデータが必要な場合は、この後で説明するように <xref:System.Threading.ThreadLocal%601> 型を使用します。  
+  
+ 一部の <xref:System.Lazy%601> コンストラクターには、`isThreadSafe` という名前のブール値パラメーターがあります。これは、<xref:System.Lazy%601.Value%2A> プロパティに複数のスレッドからアクセスするかどうかを指定するために使用します。  プロパティに 1 つのスレッドからのみアクセスする場合は、少しでもパフォーマンスが向上するように `false` を渡します。  プロパティに複数のスレッドからアクセスする場合は、`true` を渡して、初期化時にいずれかのスレッドから例外がスローされたときに競合状態を正しく処理できるように <xref:System.Lazy%601> インスタンスに指示します。  
+  
+ 一部の <xref:System.Lazy%601> コンストラクターには、`mode` という名前の <xref:System.Threading.LazyThreadSafetyMode> パラメーターがあります。  これらのコンストラクターでは、追加のスレッド セーフ モードが提供されます。  <xref:System.Lazy%601> オブジェクトのスレッド セーフが、スレッド セーフを指定するコンストラクター パラメーターによって受ける影響を次の表に示します。  各コンストラクターには、このようなパラメーターが 1 つのみあります。  
+  
+|オブジェクトのスレッド セーフ|`LazyThreadSafetyMode` `mode` パラメーター|`isThreadSafe` ブール値パラメーター|スレッド セーフ パラメーターなし|  
+|---------------------|------------------------------------------|-------------------------------|-----------------------|  
+|完全なスレッドセーフ。値の初期化を試行するスレッドは一度に 1 つのみです。|<xref:System.Threading.LazyThreadSafetyMode>|`true`|はい。|  
+|スレッド セーフではない。|<xref:System.Threading.LazyThreadSafetyMode>|`false`|使用できません。|  
+|完全なスレッドセーフ。値を初期化するためにスレッドが競合します。|<xref:System.Threading.LazyThreadSafetyMode>|使用できません。|使用できません。|  
+  
+ 表に示されているように、`mode` パラメーターに <xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> を指定することは、`isThreadSafe` パラメーターに `true` を指定することと同じです。また、<xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> を指定することは、`false` を指定することと同じです。  
+  
+ <xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> を指定すると、複数のスレッドで <xref:System.Lazy%601> インスタンスの初期化を試行します。  実際に初期化を実行できるスレッドは 1 つだけで、その他のすべてのスレッドは初期化に成功したスレッドによって初期化された値を受け取ります。  初期化時にスレッドで例外がスローされた場合、そのスレッドは成功したスレッドによって設定された値を受け取りません。  例外はキャッシュされないため、後で <xref:System.Lazy%601.Value%2A> プロパティにアクセスしようとした場合、初期化に成功することがあります。  これは、他のモードでの例外処理方法とは異なります。その点については、次のセクションで説明します。  詳細については、<xref:System.Threading.LazyThreadSafetyMode> 列挙体の解説を参照してください。  
+  
+<a name="ExceptionsInLazyObjects"></a>   
+## 遅延オブジェクトの例外  
+ 既に説明したとおり、<xref:System.Lazy%601> オブジェクトは、初期化の際に使用されたものと同じオブジェクトまたは値を常に返すため、<xref:System.Lazy%601.Value%2A> プロパティは読み取り専用です。  例外のキャッシュを有効にしている場合、この不変性は、例外の動作にも当てはまります。  限定的に初期化されたオブジェクトで、例外のキャッシュが有効になっており、<xref:System.Lazy%601.Value%2A> プロパティに最初にアクセスしたときにそのオブジェクトの初期化メソッドから例外がスローされた場合、後で <xref:System.Lazy%601.Value%2A> プロパティにアクセスしようとした場合も常に同じ例外がスローされます。  つまり、マルチスレッドのシナリオでも、ラップされた型のコンストラクターが再度呼び出されることはありません。  したがって、<xref:System.Lazy%601> オブジェクトで、いずれかのアクセスでは例外をスローし、その後のアクセスでは値を返すということはできません。  
+  
+ 例外のキャッシュは、初期化メソッド \(`valueFactory` パラメーター\) を受け取る <xref:System.Lazy%601?displayProperty=fullName> コンストラクターを使用すると有効になります。たとえば、`Lazy(T)(Func(T))` コンストラクターを使用すると有効になります。  コンストラクターが <xref:System.Threading.LazyThreadSafetyMode> の値 \(`mode` パラメーター\) も受け取る場合は、<xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> または <xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> を指定します。  初期化メソッドを指定すると、これら 2 つのモードで例外のキャッシュが有効になります。  初期化メソッドは非常に簡単なものにできます。  たとえば、`T` の既定のコンストラクター \(C\# では `new Lazy<Contents>(() => new Contents(), mode)`、Visual Basic では `New Lazy(Of Contents)(Function() New Contents())`\) を呼び出すことができます。  初期化メソッドを指定しない <xref:System.Lazy%601?displayProperty=fullName> コンストラクターを使用する場合、`T` の既定のコンストラクターによってスローされる例外はキャッシュされません。  詳細については、<xref:System.Threading.LazyThreadSafetyMode> 列挙体の解説を参照してください。  
+  
+> [!NOTE]
+>  `isThreadSafe` コンストラクターのパラメーターが `false` に設定されている、または `mode` コンストラクターのパラメーターが <xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> に設定されている <xref:System.Lazy%601> オブジェクトを作成する場合は、シングル スレッドから <xref:System.Lazy%601> オブジェクトにアクセスするか、独自に同期を行う必要があります。  これは、例外のキャッシュを含む、オブジェクトのあらゆる面に当てはまります。  
+  
+ 前のセクションで説明したように、<xref:System.Threading.LazyThreadSafetyMode?displayProperty=fullName> を指定して作成した <xref:System.Lazy%601> オブジェクトでは、例外の処理が異なります。  <xref:System.Threading.LazyThreadSafetyMode> を指定すると、<xref:System.Lazy%601> インスタンスを初期化する際に、複数のスレッドが競合します。  この場合、例外はキャッシュされず、<xref:System.Lazy%601.Value%2A> プロパティへのアクセス試行は、初期化が成功するまで続行されます。  
+  
+ 次の表に、<xref:System.Lazy%601> コンストラクターによる例外のキャッシュの制御方法の概要を示します。  
+  
+|コンストラクター|スレッド セーフ モード|初期化メソッドを使用する|例外がキャッシュされる|  
+|--------------|------------------|------------------|-----------------|  
+|Lazy\(T\)\(\)|\(<xref:> System.Threading.LazyThreadSafetyMode.ExecutionAndPublication?qualifyHint=False&autoUpgrade=True\)|No|No|  
+|Lazy\(T\)\(Func\(T\)\)|\(<xref:> System.Threading.LazyThreadSafetyMode.ExecutionAndPublication?qualifyHint=False&autoUpgrade=True\)|Yes|Yes|  
+|Lazy\(T\)\(Boolean\)|`True` \(<xref:> System.Threading.LazyThreadSafetyMode.ExecutionAndPublication?qualifyHint=False&autoUpgrade=True\) または `false` \(<xref:> System.Threading.LazyThreadSafetyMode.None?qualifyHint=False&autoUpgrade=True\)|No|No|  
+|Lazy\(T\)\(Func\(T\), Boolean\)|`True` \(<xref:> System.Threading.LazyThreadSafetyMode.ExecutionAndPublication?qualifyHint=False&autoUpgrade=True\) または `false` \(<xref:> System.Threading.LazyThreadSafetyMode.None?qualifyHint=False&autoUpgrade=True\)|Yes|Yes|  
+|Lazy\(T\)\(LazyThreadSafetyMode\)|ユーザー指定|No|No|  
+|Lazy\(T\)\(Func\(T\), LazyThreadSafetyMode\)|ユーザー指定|Yes|ユーザーが <xref:> System.Threading.LazyThreadSafetyMode.PublicationOnly?qualifyHint=False&autoUpgrade=True を指定した場合は×、それ以外の場合は○。|  
+  
+## 限定的に初期化されたプロパティの実装  
+ 限定的な初期化を使用してパブリック プロパティを実装するには、プロパティのバッキング フィールドを <xref:System.Lazy%601> として定義し、<xref:System.Lazy%601.Value%2A> プロパティをそのプロパティの `get` アクセサーから返します。  
+  
+ [!code-csharp[Lazy#5](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#5)]
+ [!code-vb[Lazy#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#5)]  
+  
+ <xref:System.Lazy%601.Value%2A> プロパティは読み取り専用です。したがって、このプロパティを公開するプロパティには `set` アクセサーはありません。  <xref:System.Lazy%601> オブジェクトによってサポートされる読み取り\/書き込みプロパティが必要な場合は、`set` アクセサーで新しい <xref:System.Lazy%601> オブジェクトを作成し、それをバッキング ストアに割り当てる必要があります。  `set` アクセサーでは、`set` アクセサーに渡された新しいプロパティ値を返すラムダ式を作成し、そのラムダ式を新しい <xref:System.Lazy%601> オブジェクトのコンストラクターに渡す必要があります。  <xref:System.Lazy%601.Value%2A> プロパティに次にアクセスしたときに、新しい <xref:System.Lazy%601> が初期化されます。その後、その <xref:System.Lazy%601.Value%2A> プロパティは、そのプロパティに代入された新しい値を返します。  このような複雑な処理を行うのは、<xref:System.Lazy%601> に組み込まれているマルチスレッド保護を維持するためです。  そのようにしないと、プロパティ アクセサーでは <xref:System.Lazy%601.Value%2A> プロパティから返された最初の値をキャッシュし、キャッシュされた値のみを変更するようになり、マルチスレッド保護を維持するには独自のスレッド セーフなコードを記述することが必要になります。  <xref:System.Lazy%601> オブジェクトでサポートされる読み取り\/書き込みプロパティによって必要な初期化処理が追加されるため、パフォーマンスが許容範囲を下回る可能性があります。  さらに、特定のシナリオでは、setter と getter との間の競合状態を回避するために、追加の調整が必要になることがあります。  
+  
+## スレッド ローカルな限定的な初期化  
+ マルチスレッドの一部のシナリオでは、スレッドごとに独自のプライベート データを提供することもできます。  このようなデータのことを*スレッド ローカル データ*と呼びます。  .NET Framework Version 3.5 以前では、`ThreadStatic` 属性を静的変数に割り当てることでスレッド ローカルにすることができます。  ただし、`ThreadStatic` 属性を使用すると、明確でないエラーが発生する場合があります。  たとえば、次の例に示すように、基本的な初期化ステートメントでも、最初にアクセスしたスレッドでしか変数が初期化されないことがあります。  
+  
+ [!code-csharp[Lazy#6](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#6)]
+ [!code-vb[Lazy#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#6)]  
+  
+ 他のすべてのスレッドでは、既定値 \(0\) を使用して変数が初期化されます。  .NET Framework Version 4 では、代わりに <xref:System.Threading.ThreadLocal%601?displayProperty=fullName> 型を使用して、指定した <xref:System.Action%601> デリゲートによってすべてのスレッドで初期化されるインスタンス ベースのスレッド ローカルな変数を作成できます。  次の例では、`counter` にアクセスするすべてのスレッドで開始値が 1 と見なされます。  
+  
+ [!code-csharp[Lazy#7](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#7)]
+ [!code-vb[Lazy#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#7)]  
+  
+ <xref:System.Threading.ThreadLocal%601> は、<xref:System.Lazy%601> とほぼ同じ方法でオブジェクトをラップしますが、本質的には次のように異なります。  
+  
+-   各スレッドでは、他のスレッドからはアクセスできない独自のプライベート データを使用してスレッド ローカル変数を初期化します。  
+  
+-   <xref:System.Threading.ThreadLocal%601.Value%2A?displayProperty=fullName> プロパティは読み書き可能であり、何回でも変更できます。  これは例外の反映にも影響し、たとえば、いずれかの `get` 操作では例外を発生させ、次の操作では値を正常に初期化ということができます。  
+  
+-   初期化デリゲートが指定されていない場合、<xref:System.Threading.ThreadLocal%601> では、ラップされた型をその型の既定値を使用して初期化します。  この点で、<xref:System.Threading.ThreadLocal%601> は <xref:System.ThreadStaticAttribute> 属性と一貫しています。  
+  
+ `ThreadLocal<int>` インスタンスにアクセスするすべてのスレッドで、データの独自の一意のコピーを取得する例を次に示します。  
+  
+ [!code-csharp[Lazy#9](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#9)]
+ [!code-vb[Lazy#9](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#9)]  
+  
+## Parallel.For と ForEach のスレッド ローカル変数  
+ <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドまたは <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> メソッドを使用してデータ ソースを並行して反復処理する場合、スレッド ローカル データのサポートが組み込まれたオーバーロードを使用できます。  これらのメソッドでは、データの作成、アクセス、およびクリーンアップにローカル デリゲートを使用することでスレッド ローカルが可能です。  詳細については、「[How to: Write a Parallel.For Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md)」および「[How to: Write a Parallel.ForEach Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md)」を参照してください。  
+  
+## オーバーヘッドが少ないシナリオでの限定的な初期化の使用  
+ 多数のオブジェクトを限定的に初期化する必要があるシナリオで、<xref:System.Lazy%601> では各オブジェクトをラップするために必要なメモリまたはコンピューティング リソースが多くなりすぎる場合があります。  また、限定的な初期化の公開方法について厳しい要件がある場合もあります。  そのような場合は、<xref:System.Threading.LazyInitializer?displayProperty=fullName> クラスの `static` \(Visual Basic では `Shared`\) メソッドを使用すると、<xref:System.Lazy%601> のインスタンスではラップせずに各オブジェクトを限定的に初期化できます。  
+  
+ 次の例では、`Orders` オブジェクト全体を 1 つの <xref:System.Lazy%601> オブジェクトでラップするのではなく、それぞれの `Order` オブジェクトを必要になったときにのみ限定的に初期化したものとします。  
+  
+ [!code-csharp[Lazy#10](../../../samples/snippets/csharp/VS_Snippets_Misc/lazy/cs/cs_lazycodefile.cs#10)]
+ [!code-vb[Lazy#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/lazy/vb/lazy_vb.vb#10)]  
+  
+ この例では、ループが繰り返されるたびに初期化プロシージャが呼び出されることに注意してください。  マルチスレッドのシナリオでは、初期化プロシージャを最初に呼び出したスレッドの値がすべてのスレッドで参照されます。  以降のスレッドも初期化プロシージャを呼び出しますが、それらの結果は使用されません。  このような潜在的な競合状態を受け入れられない場合は、ブール型の引数と同期オブジェクトを受け取る <xref:System.Threading.LazyInitializer.EnsureInitialized%2A?displayProperty=fullName> のオーバーロードを使用します。  
+  
+## 参照  
+ [Managed Threading Basics](../../../docs/standard/threading/managed-threading-basics.md)   
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [方法: オブジェクトの遅延初期化を実行する](../../../docs/framework/performance/how-to-perform-lazy-initialization-of-objects.md)
\ No newline at end of file
diff --git a/docs/framework/performance/loader-etw-events.md b/docs/framework/performance/loader-etw-events.md
new file mode 100644
index 00000000000..281bdd7f994
--- /dev/null
+++ b/docs/framework/performance/loader-etw-events.md
@@ -0,0 +1,221 @@
+---
+title: "ローダー ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, ローダー イベント (CLR)"
+  - "ローダー イベント [.NET Framework]"
+ms.assetid: cb403cc6-56f8-4609-b467-cdfa09f07909
+caps.latest.revision: 18
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# ローダー ETW イベント
+<a name="top"></a> これらのイベントは、アプリケーションのドメイン、アセンブリ、およびモジュールのロードとアンロードに関連する情報を収集します。  
+  
+ すべてのローダー イベントは、`LoaderKeyword` \(0x8\) キーワードで発生します。`DCStart` および `DCEnd` のイベントは、`StartRundown`\/`EndRundown` が有効になっている `LoaderRundownKeyword` \(0x8\) で発生します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+ ローダー イベントは、次のように細分化されています。  
+  
+-   [アプリケーション ドメイン イベント](#application_domain_events)  
+  
+-   [CLR ローダー アセンブリ イベント](#clr_loader_assembly_events)  
+  
+-   [モジュール イベント](#module_events)  
+  
+-   [CLR ドメイン モジュール イベント](#clr_domain_module_events)  
+  
+-   [モジュールの範囲イベント](#module_range_events)  
+  
+<a name="application_domain_events"></a>   
+## アプリケーション ドメイン イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|イベント|レベル|  
+|---------------------|----------|---------|  
+|`LoaderKeyword` \(0x8\)|`AppDomainLoad_V1` および `AppDomainUnLoad_V1`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `StartRundownKeyword`|`AppDomainDCStart_V1`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `EndRundownKeyword`|`AppDomainDCEnd_V1`|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`AppDomainLoad_V1` \(すべてのアプリケーション ドメインについて記録\)|156|プロセスの有効期間中に、アプリケーション ドメインが作成されるたびに発生します。|  
+|`AppDomainUnLoad_V1`|157|プロセスの有効期間中に、アプリケーション ドメインが破壊されるたびに発生します。|  
+|`AppDomainDCStart_V1`|157|開始ランダウン中にアプリケーション ドメインを列挙します。|  
+|`AppDomainDCEnd_V1`|158|終了ランダウン中にアプリケーション ドメインを列挙します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AppDomainID|win:UInt64|アプリケーション ドメインの一意の識別子。|  
+|AppDomainFlags|win:UInt32|0x1: 既定のドメイン。<br /><br /> 0x2: 実行可能ファイル。<br /><br /> 0x4: アプリケーション ドメイン、ビット 28 ～ 31: このドメインの共有ポリシー。<br /><br /> 0: 共有ドメイン。|  
+|AppDomainName|win:UnicodeString|わかりやすいアプリケーション ドメイン名。 プロセスの有効期間中に変更することがあります。|  
+|AppDomainIndex|Win:UInt32|このアプリケーション ドメインのインデックス。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="clr_loader_assembly_events"></a>   
+## CLR ローダー アセンブリ イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|イベント|レベル|  
+|---------------------|----------|---------|  
+|`LoaderKeyword` \(0x8\)|`AssemblyLoad` および `AssemblyUnload`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `StartRundownKeyword`|`AssemblyDCStart`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `EndRundownKeyword`|`AssemblyDCEnd`|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`AssemblyLoad_V1`|154|アセンブリが読み込まれたときに発生します。|  
+|`AssemblyUnload_V1`|155|アセンブリがアンロードされたときに発生します。|  
+|`AssemblyDCStart_V1`|155|開始ランダウン中にアセンブリを列挙します。|  
+|`AssemblyDCEnd_V1`|156|終了ランダウン中にアセンブリを列挙します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AssemblyID|win:UInt64|アセンブリの一意の ID。|  
+|AppDomainID|win:UInt64|このアセンブリのドメインの ID。|  
+|BindingID|win:UInt64|アセンブリ バインディングを一意に識別する ID。|  
+|AssemblyFlags|win:UInt32|0x1: ドメインに中立的なアセンブリ。<br /><br /> 0x2: 動的アセンブリ。<br /><br /> 0x4: アセンブリにネイティブ イメージがある。<br /><br /> 0x8: 収集可能なアセンブリ。|  
+|AssemblyName|win:UnicodeString|完全修飾アセンブリ名。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="module_events"></a>   
+## モジュール イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|イベント|レベル|  
+|---------------------|----------|---------|  
+|`LoaderKeyword` \(0x8\)|`ModuleLoad_V2` および `ModuleUnload_V2`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `StartRundownKeyword`|`ModuleDCStart_V2`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `EndRundownKeyword`|`ModuleDCEnd_V2`|情報提供 \(4\)|  
+||||  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`ModuleLoad_V2`|152|プロセスの有効期間中にモジュールが読み込まれるときに発生します。|  
+|`ModuleUnload_V2`|153|プロセスの有効期間中にモジュールがアンロードされるときに発生します。|  
+|`ModuleDCStart_V2`|153|開始ランダウン中にモジュールを列挙します。|  
+|`ModuleDCEnd_V2`|154|終了ランダウン中にモジュールを列挙します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ModuleID|win:UInt64|モジュールの一意な ID。|  
+|AssemblyID|win:UInt64|このモジュールが存在するアセンブリの ID。|  
+|ModuleFlags|win:UInt32|0x1: ドメインに中立的なモジュール。<br /><br /> 0x2: モジュールにネイティブ イメージがある。<br /><br /> 0x4: 動的モジュール。<br /><br /> 0x8: マニフェスト モジュール。|  
+|Reserved1|win:UInt32|予約済みのフィールド。|  
+|ModuleILPath|win:UnicodeString|モジュールの Microsoft intermediate language \(MSIL\) のイメージのパス、またはそれが動的アセンブリ \(null で終わる\) である場合は動的モジュール名。|  
+|ModuleNativePath|win:UnicodeString|モジュール ネイティブ イメージがある場合、そのパス \(null で終わる\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+|ManagedPdbSignature|win:GUID|このモジュールに一致するマネージ プログラム データベース \(PDB\) の GUID の署名。 \(「解説」を参照してください。\)|  
+|ManagedPdbAge|win:UInt32|このモジュールに一致する管理対象 PDB に書き込まれた期間を表す数値。 \(「解説」を参照してください。\)|  
+|ManagedPdbBuildPath|win:UnicodeString|このモジュールに一致する管理対象の PDB が構成されている場所へのパス。 これは、ファイル名だけの場合もあります。 \(「解説」を参照してください。\)|  
+|NativePdbSignature|win:GUID|このモジュールに一致するネイティブ イメージ ジェネレーター \(NGen\) PDB の GUID の署名 \(該当する場合\)。 \(「解説」を参照してください。\)|  
+|NativePdbAge|win:UInt32|このモジュールに一致する NGen PDB に書き込まれた期間を表す数値 \(該当する場合\)。 \(「解説」を参照してください。\)|  
+|NativePdbBuildPath|win:UnicodeString|このモジュールに一致する管理対象の NGen PDB が構成されている場所へのパス \(該当する場合\)。 これは、ファイル名だけの場合もあります。 \(「解説」を参照してください。\)|  
+  
+### コメント  
+  
+-   名前に"Pdb"が付いているフィールドは、プロファイル セッション中に読み込まれたモジュールに一致する PDB を検索するプロファイリング ツールによって使用できます。 これらのフィールドの値は、読み込まれたモジュールに一致する PDB の位置を特定するためにデバッガーが通常使用する、モジュールの IMAGE\_DIRECTORY\_ENTRY\_DEBUG のセクションに書き込まれたデータに対応します。  
+  
+-   "ManagedPdb"で始まるフィールド名は、マネージ コンパイラ \(c\# または Visual Basic コンパイラなど\) によって生成された MSIL モジュールに対応する管理対象の PDB を参照します。 この PDB は、管理対象の PDB 形式を使用して、ファイル、行番号、およびシンボルの名前など、元のマネージ ソース コードからの要素が MSIL モジュールにコンパイルされている MSIL 要素にどのようにマップされるかについて説明します。  
+  
+-   "NativePdb"で始まるフィールド名は、`NGEN createPDB` を呼び出すことによって生成された NGen PDB を参照します。 この PDB は、ネイティブ PDB 形式を使用して、ファイル、行番号、およびシンボルの名前など、元のマネージ ソース コードからの要素が NGen モジュールにコンパイルされているネイティブ要素にどのようにマップされるかについて説明します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="clr_domain_module_events"></a>   
+## CLR ドメイン モジュール イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|イベント|レベル|  
+|---------------------|----------|---------|  
+|`LoaderKeyword` \(0x8\)|`DomainModuleLoad_V1`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `StartRundownKeyword`|`DomainModuleDCStart_V1`|情報提供 \(4\)|  
+|`LoaderRundownKeyword` \(0x8\) \+<br /><br /> `EndRundownKeyword`|`DomainModuleDCEnd_V1`|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`DomainModuleLoad_V1`|151|モジュールがアプリケーション ドメインに読み込まれるときに発生します。|  
+|`DomainModuleDCStart_V1`|151|開始ランダウン中にアプリケーション ドメインに読み込まれたモジュールを列挙し、すべてのアプリケーション ドメインについてログに記録されます。|  
+|`DomainModuleDCEnd_V1`|152|終了ランダウン中にアプリケーション ドメインに読み込まれたモジュールを列挙し、すべてのアプリケーション ドメインについてログに記録されます。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ModuleID|win:UInt64|このモジュールが所属するアセンブリを識別します。|  
+|AssemblyID|win:UInt64|このモジュールが存在するアセンブリの ID。|  
+|AppDomainID|win:UInt64|このモジュールを使用する、アプリケーション ドメインの ID。|  
+|ModuleFlags|win:UInt32|0x1: ドメインに中立的なモジュール。<br /><br /> 0x2: モジュールにネイティブ イメージがある。<br /><br /> 0x4: 動的モジュール。<br /><br /> 0x8: マニフェスト モジュール。|  
+|Reserved1|win:UInt32|予約済みのフィールド。|  
+|ModuleILPath|win:UnicodeString|モジュールの MSIL のイメージのパス、またはそれが動的アセンブリ \(null で終わる\) である場合は動的モジュール名。|  
+|ModuleNativePath|win:UnicodeString|モジュール ネイティブ イメージがある場合、そのパス \(null で終わる\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="module_range_events"></a>   
+## モジュールの範囲イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|イベント|レベル|  
+|---------------------|----------|---------|  
+|`PerfTrackKeyWord`\)|`ModuleRange`|情報提供 \(4\)|  
+|`PerfTrackKeyWord`|`ModuleRangeDCStart`|情報提供 \(4\)|  
+|`PerfTrackKeyWord`|`ModuleRangeDCEnd`|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`ModuleRange`|158|ロードされたネイティブ イメージ ジェネレーター \(NGen\) のイメージが IBC によって最適化されていて、NGen イメージのホット セクションに関する情報が含まれる場合は、このイベントが存在します。|  
+|`ModuleRangeDCStart`|160|ランダウンの開始時に発生する `ModuleRange` イベント。|  
+|`ModuleRangeDCEnd`|161|ランダウンの終了時に発生する `ModuleRange` イベント。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ClrInstanceID|win:UInt16|CLR の複数のインスタンスが読み込まれている場合、プロセス内の CLR の特定のインスタンスを一意に識別します。|  
+|ModuleID|win:UInt64|このモジュールが所属するアセンブリを識別します。|  
+|RangeBegin|win:UInt32|指定された範囲の種類の範囲の開始を表す、モジュール内のオフセット。|  
+|RangeSize|win:UInt32|指定された範囲のサイズ \(バイト単位\)。|  
+|RangeType|win:UInt32|コールド IBC 範囲を表す単一の値、0x4。 このフィールドは、後により多くの値を表すことができるようになります。|  
+|RangeSize1|win:UInt32|0 は無効なデータを示します。|  
+|RangeBegin2|win:UnicodeString||  
+  
+### コメント  
+ .NET Framework のプロセスで読み込まれた NGen イメージが IBC に最適化されている場合、NGen イメージにホットの範囲を含む `ModuleRange` イベントが `moduleID` と `ClrInstanceID` と共にログに記録されます。  NGen イメージが IBC に最適化されていない場合は、このイベントは記録されません。 モジュール名を確認するには、このイベントをモジュールの読み込みの ETW イベントで照合する必要があります。  
+  
+ このイベントのペイロードのサイズは変数です。`Count` フィールドは、イベントに含まれている範囲オフセットの数を示します。  このイベントは、実際の範囲を判断するために Windows `IStart` イベントと照合する必要があります。 Windows Image Load イベントは、イメージが読み込まれ、読み込まれたイメージの仮想アドレスが含まれている場合は必ず記録されます。  
+  
+ モジュールの範囲イベントは、4 以上のすべての ETW レベルで発行され、情報イベントに分類されます。  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/method-etw-events.md b/docs/framework/performance/method-etw-events.md
new file mode 100644
index 00000000000..e3355f3fdff
--- /dev/null
+++ b/docs/framework/performance/method-etw-events.md
@@ -0,0 +1,170 @@
+---
+title: "メソッド ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, メソッド イベント (CLR)"
+  - "メソッド イベント [.NET Framework]"
+ms.assetid: 167a4459-bb6e-476c-9046-7920880f2bb5
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# メソッド ETW イベント
+<a name="top"></a> これらのイベントは、メソッド固有の情報を収集します。 これらのイベントのペイロードは、シンボルの解決に必要です。 さらに、これらのイベントは、メソッドが呼び出された回数などの有用な情報を提供します。  
+  
+ すべてのメソッド イベントのレベルは「情報提供 \(4\)」です。 すべてのメソッド詳細イベントのレベルは「詳細 \(5\)」です。  
+  
+ すべてのメソッド イベントは、ランタイム プロバイダーのもとでは `JITKeyword` \(0x10\) キーワードまたは `NGenKeyword` \(0x20\) キーワードが発生させ、ランダウン プロバイダーのもとでは `JitRundownKeyword` \(0x10\) または `NGENRundownKeyword` \(0x20\) が発生させます。  
+  
+ CLR メソッド イベントは、さらに次のように細分化されます。  
+  
+-   [CLR メソッド イベント](#clr_method_events)  
+  
+-   [CLR メソッド マーカー イベント](#clr_method_marker_events)  
+  
+-   [CLR メソッド詳細イベント](#clr_method_verbose_events)  
+  
+-   [MethodJittingStarted イベント](#methodjittingstarted_event)  
+  
+<a name="clr_method_events"></a>   
+## CLR メソッド イベント  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITKeyword` \(0x10\) ランタイム プロバイダー|情報提供 \(4\)|  
+|`NGenKeyword` \(0x20\) ランタイム プロバイダー|情報提供 \(4\)|  
+|`JitRundownKeyword` \(0x10\) ランダウン プロバイダー|情報提供 \(4\)|  
+|`NGENRundownKeyword` \(0x20\) ランダウン プロバイダー|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`MethodLoad_V1`|136|メソッドが Just\-In\-Time 読み込み \(JIT 読み込み\) される時点、または NGEN イメージが読み込まれる時点で発生します。 動的メソッドとジェネリック メソッドは、メソッドの読み込みにこのバージョンを使用しません。 JIT ヘルパーがこのバージョンを使用することはありません。|  
+|`MethodUnLoad_V1`|137|モジュールがアンロードされるとき、またはアプリケーション ドメインが破棄されるときに発生します。 動的メソッドがメソッドのアンロードにこのバージョンを使用することはありません。|  
+|`MethodDCStart_V1`|137|開始ランダウン中にメソッドを列挙します。|  
+|`MethodDCEnd_V1`|138|終了ランダウン中にメソッドを列挙します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodID|win:UInt64|メソッドの一意の識別子。 JIT ヘルパー メソッドの場合、これはメソッドの開始アドレスに設定されます。|  
+|ModuleID|win:UInt64|このメソッドが属するモジュールの識別子 \(JIT ヘルパーの場合は 0\)。|  
+|MethodStartAddress|win:UInt64|メソッドの開始アドレス。|  
+|MethodSize|win:UInt32|メソッドのサイズ。|  
+|MethodToken|win:UInt32|動的メソッドおよび JIT ヘルパーの場合は 0。|  
+|MethodFlags|win:UInt32|0x1: 動的メソッド。<br /><br /> 0x2: ジェネリック メソッド。<br /><br /> 0x4: JIT コンパイル済みコード メソッド \(それ以外の場合は NGEN ネイティブ イメージ コード\)。<br /><br /> 0x8: ヘルパー メソッド。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="clr_method_marker_events"></a>   
+## CLR メソッド マーカー イベント  
+ これらのイベントはランダウン プロバイダーのもとでしか発生しません。 これらは、開始ランダウンまたは終了ランダウン中にメソッド列挙体の終わりを示します。 \(つまり、`NGENRundownKeyword`、`JitRundownKeyword`、`LoaderRundownKeyword`、または `AppDomainResourceManagementRundownKeyword` のキーワードが有効な場合に発生します。\)  
+  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`AppDomainResourceManagementRundownKeyword` \(0x800\) ランダウン プロバイダー|情報提供 \(4\)|  
+|`JitRundownKeyword` \(0x10\) ランダウン プロバイダー|情報提供 \(4\)|  
+|`NGENRundownKeyword` \(0x20\) ランダウン プロバイダー|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`DCStartInit_V1`|147|開始ランダウン中に列挙体の始まりの前に送信されます。|  
+|`DCStartComplete_V1`|145|開始ランダウン中に列挙体の終わりに送信されます。|  
+|`DCEndInit_V1`|148|終了ランダウン中に列挙体の始まりの前に送信されます。|  
+|`DCEndComplete_V1`|146|終了ランダウン中に列挙体の終わりに送信されます。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="clr_method_verbose_events"></a>   
+## CLR メソッド詳細イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITKeyword` \(0x10\) ランタイム プロバイダー|詳細 \(5\)|  
+|`NGenKeyword` \(0x20\) ランタイム プロバイダー|詳細 \(5\)|  
+|`JitRundownKeyword` \(0x10\) ランダウン プロバイダー|詳細 \(5\)|  
+|`NGENRundownKeyword` \(0x20\) ランダウン プロバイダー|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`MethodLoadVerbose_V1`|143|メソッドが JIT 読み込みされるとき、または NGEN イメージが読み込まれるときに発生します。 動的メソッドとジェネリック メソッドは、メソッドの読み込みに常にこのバージョンを使用します。 JIT ヘルパーは常にこのバージョンを使用します。|  
+|`MethodUnLoadVerbose_V1`|144|動的メソッドが破棄されるとき、またはモジュールがアンロードされるとき、あるいはアプリケーション ドメインが破棄されるときに発生します。 動的メソッドは、メソッドのアンロードに常にこのバージョンを使用します。|  
+|`MethodDCStartVerbose_V1`|141|開始ランダウン中にメソッドを列挙します。|  
+|`MethodDCEndVerbose_V1`|142|終了ランダウン中にメソッドを列挙します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodID|win:UInt64|メソッドの一意の識別子。 JIT ヘルパー メソッドの場合は、メソッドの開始アドレスに設定されます。|  
+|ModuleID|win:UInt64|このメソッドが属するモジュールの識別子 \(JIT ヘルパーの場合は 0\)。|  
+|MethodStartAddress|win:UInt64|開始アドレス。|  
+|MethodSize|win:UInt32|メソッドの長さ。|  
+|MethodToken|win:UInt32|動的メソッドおよび JIT ヘルパーの場合は 0。|  
+|MethodFlags|win:UInt32|0x1: 動的メソッド。<br /><br /> 0x2: ジェネリック メソッド。<br /><br /> 0x4: JIT コンパイル済みメソッド \(それ以外の場合は NGen.exe により生成\)<br /><br /> 0x8: ヘルパー メソッド。|  
+|MethodNameSpace|win:UnicodeString|メソッドに関連付けられた完全な名前空間名。|  
+|MethodName|win:UnicodeString|メソッドに関連付けられた完全クラス名。|  
+|MethodSignature|win:UnicodeString|メソッドのシグネチャ \(型名のコンマ区切りリスト\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="methodjittingstarted_event"></a>   
+## MethodJittingStarted イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`JITKeyword` \(0x10\) ランタイム プロバイダー|詳細 \(5\)|  
+|`NGenKeyword` \(0x20\) ランタイム プロバイダー|詳細 \(5\)|  
+|`JitRundownKeyword` \(0x10\) ランダウン プロバイダー|詳細 \(5\)|  
+|`NGENRundownKeyword` \(0x20\) ランダウン プロバイダー|詳細 \(5\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`MethodJittingStarted`|145|メソッドが JIT コンパイルされているときに発生します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|MethodID|win:UInt64|メソッドの一意の識別子。|  
+|ModuleID|win:UInt64|このメソッドが属するモジュールの識別子。|  
+|MethodToken|win:UInt32|動的メソッドおよび JIT ヘルパーの場合は 0。|  
+|MethodILSize|win:UInt32|JIT コンパイルされているメソッドの Microsoft intermediate language \(MSIL\) のサイズ。|  
+|MethodNameSpace|win:UnicodeString|メソッドに関連付けられた完全クラス名。|  
+|MethodName|win:UnicodeString|メソッドの名前です。|  
+|MethodSignature|win:UnicodeString|メソッドのシグネチャ \(型名のコンマ区切りリスト\)。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/performance-tips.md b/docs/framework/performance/performance-tips.md
new file mode 100644
index 00000000000..605ad7cc63a
--- /dev/null
+++ b/docs/framework/performance/performance-tips.md
@@ -0,0 +1,54 @@
+---
+title: ".NET のパフォーマンスに関するヒント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "C# 言語, パフォーマンス"
+  - "パフォーマンス [C#]"
+  - "パフォーマンス [Visual Basic]"
+  - "Visual Basic, パフォーマンス"
+ms.assetid: ae275793-857d-4102-9095-b4c2a02d57f4
+caps.latest.revision: 36
+author: "BillWagner"
+ms.author: "wiwagn"
+manager: "wpickett"
+caps.handback.revision: 36
+---
+# .NET のパフォーマンスに関するヒント
+*パフォーマンス*という用語は、プログラムの実行速度を表す一般的な用語です。  ソース コード内で特定の基本規則に従うことにより、実行速度を上げることができることもあります。  プログラムによっては、コードを綿密に調べることが重要で、プロファイラーを使用して、可能な限り速く実行しているかどうかを確認することが必要な場合もあります。  一方、記述どおりに許容可能な速度でコードが実行されているため、このような最適化が必要ないプログラムもあります。  ここでは、パフォーマンスの低下が発生する一般的な状況と、パフォーマンスを向上させるためのヒント、およびパフォーマンスに関する追加のトピックについて説明します。  パフォーマンスの計画と計測の詳細については、「[Performance](../../../docs/framework/performance/index.md)」を参照してください。  
+  
+## ボックス化とボックス化解除  
+ たとえば、<xref:System.Collections.ArrayList?displayProperty=fullName> などの非ジェネリック コレクション クラスで、頻繁に値型をボックス化する必要がある状況では、値型の使用を回避するのが最も適しています。  <xref:System.Collections.Generic.List%601?displayProperty=fullName> などのジェネリック コレクションを使用することで、値型のボックス化を回避できます。  ボックス化とボックス化解除は、負荷の大きい処理です。  値型をボックス化するときは、完全に新しいオブジェクトを作成する必要があります。  これには、単純な参照割り当てと比較して最大 20 倍もの時間がかかることがあります。  また、ボックス化を解除するときは、キャストのプロセスで代入の 4 倍の時間がかかることがあります。  詳細については、「[ボックス化とボックス化解除](../Topic/Boxing%20and%20Unboxing%20\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+## 文字列  
+ たとえば、短いループ内で多くの文字列変数を連結する場合は、C\# の [\+ 演算子](../Topic/+%20Operator%20\(C%23%20Reference\).md)または Visual Basic の[連結演算子](../Topic/Concatenation%20Operators%20\(Visual%20Basic\).md)ではなく、<xref:System.Text.StringBuilder?displayProperty=fullName> を使用します。  詳細については、「[方法: 複数の文字列を連結する](../Topic/How%20to:%20Concatenate%20Multiple%20Strings%20\(C%23%20Programming%20Guide\).md)」および「[Concatenation Operators in Visual Basic](../Topic/Concatenation%20Operators%20in%20Visual%20Basic.md)」を参照してください。  
+  
+## デストラクター  
+ 空のデストラクターは使用しないでください。  デストラクターがクラスに存在するときは、エントリが終了キューで作成されます。  デストラクターを呼び出すと、ガベージ コレクターが呼び出され、このキューを処理します。  デストラクターが空の場合は、これによってパフォーマンスが低下します。  詳細については、「[デストラクター](../Topic/Destructors%20\(C%23%20Programming%20Guide\).md)」および「[Object Lifetime: How Objects Are Created and Destroyed](../Topic/Object%20Lifetime:%20How%20Objects%20Are%20Created%20and%20Destroyed%20\(Visual%20Basic\).md)」を参照してください。  
+  
+## その他のリソース  
+  
+-   [Writing Faster Managed Code: Know What Things Cost \(高速なマネージ コードを書く: 何にコストがかかるのかを知る\)](http://go.microsoft.com/fwlink/?LinkId=99294)  
+  
+-   [Writing High\-Performance Managed Applications: A Primer \(高パフォーマンスのマネージ アプリケーションを書く: 入門編\)](http://go.microsoft.com/fwlink/?LinkId=99295)  
+  
+-   [ガベージ コレクターの基本とパフォーマンスのヒント](http://go.microsoft.com/fwlink/?LinkId=99296)  
+  
+-   [.NET アプリケーションのパフォーマンス関連のヒントとトリック](http://go.microsoft.com/fwlink/?LinkId=99297)  
+  
+-   [Inside Diagnostic Tools for .NET \(.NET の診断ツールの裏側\)](http://go.microsoft.com/fwlink/?LinkId=112407)  
+  
+-   [Rico Mariani's Performance Tidbits \(Rico Mariani が紹介するパフォーマンスに関するニュース\)](http://go.microsoft.com/fwlink/?LinkId=115679)  
+  
+## 参照  
+ [Performance](../../../docs/framework/performance/index.md)   
+ [プログラミングの概念](../Topic/Programming%20Concepts.md)   
+ [Visual Basic Programming Guide](../Topic/Visual%20Basic%20Programming%20Guide.md)   
+ [C\# プログラミング ガイド](../Topic/C%23%20Programming%20Guide.md)
\ No newline at end of file
diff --git a/docs/framework/performance/reliability-best-practices.md b/docs/framework/performance/reliability-best-practices.md
new file mode 100644
index 00000000000..f80e6b17ee9
--- /dev/null
+++ b/docs/framework/performance/reliability-best-practices.md
@@ -0,0 +1,288 @@
+---
+title: "信頼性に関するベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "非同期の例外処理"
+  - "バックアウト コード"
+  - "ブロック, 信頼性"
+  - "catch ブロック"
+  - "CER"
+  - "クリーンアップ操作"
+  - "制約された実行領域"
+  - "アプリケーション間のドメイン共有状態"
+  - "サービス拒否 (DoS) 攻撃"
+  - "ファイバー"
+  - "ファイナライザー, 信頼性"
+  - "finally 句"
+  - "GC.KeepAlive メソッド"
+  - "識別 (ロックを)"
+  - "偽装"
+  - "リークしたリソース [.NET Framework]"
+  - "ロック, 信頼性"
+  - "マネージ スレッド"
+  - "マーク (ロックを)"
+  - "メモリ, 信頼性"
+  - "プロセス全体のドメイン共有状態"
+  - "再起動 (データベースを)"
+  - "信頼性 [.NET Framework]"
+  - "信頼性のコントラクト [.NET Framework]"
+  - "SafeHandle クラス, 信頼性"
+  - "共有状態"
+  - "シングルスレッド COM コンポーネント"
+  - "スロー リーク"
+  - "SQL Server [.NET Framework], 信頼性"
+  - "STA に依存しない機能"
+  - "中断 (スレッドを)"
+  - "同期, 信頼性"
+  - "スレッド化 [.NET Framework], 信頼性"
+  - "アンマネージ メモリ"
+  - "記述 (信頼性の高いコードを)"
+ms.assetid: cf624c1f-c160-46a1-bb2b-213587688da7
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 信頼性に関するベスト プラクティス
+以下の信頼性の規則は SQL Server 向けの規則ですが、ホスト ベースのサーバー アプリケーションにも適用されます。  SQL Server のようなサーバーでは、リソースをリークしたり、停止したりしないことが非常に重要となります。ただし、オブジェクトの状態を変更するすべてのメソッドのバックアウト コードを記述しても、これは実現できません。バックアウト コードによってあらゆる場所でエラーから回復する、100% 信頼できるマネージ コードを作成することが目標ではありません。これは、成功の見込みがほとんどない困難な作業です。共通言語ランタイム \(CLR: Common Language Runtime\) は、完璧なコードの記述を実現できるほど強力な保証をマネージ コードに対して容易に提供できるわけではありません。ASP.NET とは異なり、SQL Server が使用するプロセスは 1 つだけです。このプロセスは、許容範囲を超える長時間にわたってデータベースを停止させなければリサイクルできません。  
+  
+ このように保証が十分ではなく、単一のプロセスで実行する場合、信頼性の基盤となるのは、必要なときにスレッドの終了やアプリケーション ドメインのリサイクルを行い、予防措置を講じて、ハンドルやメモリなどのオペレーティング システム リソースがリークされないようにすることです。この簡単な信頼性の制約がある場合でも、次のような信頼性の重要な要件が存在します。  
+  
+-   オペレーティング システム リソースをリークしない。  
+  
+-   CLR に対してあらゆる形式のすべてのマネージ ロックを示す。  
+  
+-   <xref:System.AppDomain> のリサイクルが円滑に機能できるように、アプリケーション ドメイン間の共有の状態を破損しない。  
+  
+ <xref:System.Threading.ThreadAbortException>、<xref:System.StackOverflowException>、<xref:System.OutOfMemoryException> の各例外を処理するマネージ コードを記述することは理論上では可能ですが、アプリケーション全体にわたり、このような信頼性の高いコードを記述することを開発者に期待するのは現実的とはいえません。このため、帯域外の例外が発生し、実行中のスレッドが終了することになります。終了したスレッドが共有の状態を編集中だった場合 \(これは、スレッドがロックを保持しているかどうかによって判断できます\)、<xref:System.AppDomain> はアンロードされます。共有の状態を更新するための信頼性のあるバックアウト コードを記述することはできないため、共有の状態を編集中のメソッドを終了すると、その状態は破損することになります。  
+  
+ .NET Framework Version 2.0 では、信頼性を必要とするホストは SQL Server だけです。SQL Server でアセンブリを実行する場合、データベースでの実行時に無効にする特定の機能が存在する場合でも、そのアセンブリのあらゆる部分に対して信頼性を実現するための作業を行う必要があります。これが必要となるのは、コード分析エンジンはアセンブリ レベルでコードをチェックし、無効になっているコードを区別できないためです。  SQL Server のプログラミングにおけるもう 1 つの考慮事項は、SQL Server は 1 つのプロセス内ですべてのタスクを実行し、<xref:System.AppDomain> のリサイクルは、メモリやオペレーティング システム ハンドルなどのすべてのリソースをクリーンアップするために使用されるということです。  
+  
+ ファイナライザーやデストラクター、またはバックアウト コードの `try/finally` ブロックに依存することはできません。  これらは、中断されたり呼び出されなかったりする可能性があります。  
+  
+ <xref:System.Threading.ThreadAbortException>、<xref:System.StackOverflowException>、および <xref:System.OutOfMemoryException> の各非同期例外は、予測不可能な場所 \(場合によっては各マシン語命令\) でスローされる可能性があります。  
+  
+ SQL では、マネージ スレッドは必ずしも Win32 スレッドであるとは限らず、ファイバーの場合もあります。  
+  
+ プロセス全体またはアプリケーション ドメイン間における変更可能な共有の状態を安全に変更することは非常に難しいため、できる限り回避する必要があります。  
+  
+ SQL Server では、メモリ不足の状態は珍しいことではありません。  
+  
+ SQL Server 内でホストされているライブラリが共有の状態を適切に更新していない場合、データベースが再起動されるまでコードでは回復されない可能性が高くなります。また、極端な場合には、このことが原因で SQL Server プロセスが失敗し、データベースの再起動につながる可能性もあります。データベースを再起動すると、Web サイトを停止したり、会社の業務に影響を及ぼしたりする可能性があり、可用性が損なわれます。メモリやハンドルなどのオペレーティング システム リソースが徐々にリークされると、回復の見込みのない状態で、サーバーがハンドルの割り当てに最終的に失敗する可能性があります。また、サーバーのパフォーマンスが徐々に低下し、顧客のアプリケーションの可用性が低下することもあります。これらのシナリオを回避することが望ましいのは明らかです。  
+  
+## ベスト プラクティスの規則  
+ ここでは、サーバーで実行するマネージ コードに関するコード レビューの内容に重点を置いています。フレームワークの安定性と信頼性を向上させるうえで、これらを理解しておくことが必要です。  これらのチェックは、すべて一般的に推奨される方法であり、サーバーには不可欠です。  
+  
+ デッドロックまたはリソースの制約が発生した場合、SQL Server はスレッドを中止するか、<xref:System.AppDomain> を破棄します。この状態が発生した場合、実行が保証されるのは、制約された実行領域 \(CER: Constrained Execution Region\) 内のバックアウト コードだけです。  
+  
+### SafeHandle を使用してリソース リークを回避する  
+ <xref:System.AppDomain> のアンロードが発生した場合、`finally` ブロックまたはファイナライザーの実行に依存することはできません。したがって、<xref:System.IntPtr>、<xref:System.Runtime.InteropServices.HandleRef>、またはこれらに類似するクラスではなく、<xref:System.Runtime.InteropServices.SafeHandle> クラスを通じてオペレーティング システム リソースへのすべてのアクセスを抽出することが重要となります。  これは、CLR が、<xref:System.AppDomain> の終了処理の場合に使用するハンドルを追跡し、閉じることができます。<xref:System.Runtime.InteropServices.SafeHandle> は、CLR が必ず実行するクリティカル ファイナライザーを使用します。  
+  
+ オペレーティング システム ハンドルは、作成された時点から解放されるまでの間、セーフ ハンドルに格納されます。<xref:System.Threading.ThreadAbortException> が発生してハンドルをリークする可能性のある間、ウィンドウは存在しません。また、プラットフォーム呼び出しではハンドルの参照カウントを行うため、ハンドルの有効期間の追跡を終了し、`Dispose` とハンドルを現在使用しているメソッドとの競合状態に伴うセキュリティ上の問題を防ぐことができます。  
+  
+ オペレーティング システム ハンドルを単にクリーンアップするためにファイナライザーを現在保持しているほとんどのクラスでは、ファイナライザーは今後必要ではなくなります。  代わりに、ファイナライザーは <xref:System.Runtime.InteropServices.SafeHandle> の派生クラスで保持されることになります。  
+  
+ <xref:System.Runtime.InteropServices.SafeHandle> は、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> に代わるものではありません。リソースの競合が発生する可能性はやはり存在するため、オペレーティング システム リソースを明示的に破棄することにはパフォーマンス上の利点があります。リソースを明示的に破棄する `finally` ブロックは、実行されない場合もあることを認識してください。  
+  
+ <xref:System.Runtime.InteropServices.SafeHandle> を使用すると、ハンドルを解放する処理 \(ルーチンを解放したり、ループ内の一連のハンドルを解放したりするオペレーティング システム ハンドルに状態を渡すなど\) を実行する独自の <xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドを実装できます。このメソッドの実行は CLR によって保証されます。<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> 実装の作成者は、どのような状況においてもハンドルが確実に解放されるようにする必要があります。  ハンドルを解放できないと、ハンドルはリークされることになり、多くの場合、そのハンドルに関連付けられたネイティブ リソースのリークにつながります。  したがって、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> 実装が呼び出し時に利用できない可能性のあるリソースの割り当てを必要としない、<xref:System.Runtime.InteropServices.SafeHandle> の派生クラスを構築することが非常に重要です。  コードがこのようなエラーを処理し、コントラクトをすべて満たしてネイティブ ハンドルを解放できることを条件に、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> の実装内で失敗する可能性のあるメソッドを呼び出すことが許可されます。  デバッグのために、<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> は <xref:System.Boolean> の戻り値を返します。この戻り値は、リソースの解放を妨げる深刻なエラーが発生した場合に、`false` に設定されます。  このとき、[releaseHandleFailed](../../../docs/framework/debug-trace-profile/releasehandlefailed-mda.md) MDA が有効であれば、問題の特定を支援するためにアクティブになります。  これは、その他の点ではランタイムに影響を及ぼしません。<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> は、同じリソースに対して再度呼び出されることはないため、ハンドルがリークされることになります。  
+  
+ 一部のコンテキストでは、<xref:System.Runtime.InteropServices.SafeHandle> は適切ではありません。<xref:System.Runtime.InteropServices.SafeHandle.ReleaseHandle%2A> メソッドは、<xref:System.GC> ファイナライザー スレッドで実行できるため、特定のスレッドで解放する必要のあるハンドルを <xref:System.Runtime.InteropServices.SafeHandle> にラップする必要はありません。  
+  
+ ランタイム呼び出し可能ラッパー \(RCW: Runtime Callable Wrapper\) は、追加のコードを必要とせずに CLR によって削除できます。プラットフォーム呼び出しを使用し、`IUnknown*` または <xref:System.IntPtr>として COM オブジェクトを扱う RCW を使用するコードでは、コードは書き直す必要があります。<xref:System.Runtime.InteropServices.SafeHandle> が、マネージ コードへのコールバック アンマネージ解放メソッドの可能性があるため、このシナリオに対して十分でない場合があります。  
+  
+#### コード分析規則  
+ <xref:System.Runtime.InteropServices.SafeHandle> を使用して、オペレーティング システム リソースをカプセル化します。  <xref:System.Runtime.InteropServices.HandleRef> または <xref:System.IntPtr> 型のフィールドは使用しないでください。  
+  
+### オペレーティング システム リソースのリークを防ぐために、ファイナライザーを実行する必要がないことを確認する  
+ ファイナライザーを入念に見直して、ファイナライザーが実行されない場合でも、重大なオペレーティング システム リソースがリークされないようにします。アプリケーションが安定した状態で実行されているときや、SQL Server などのサーバーがシャットダウンしたときに発生する <xref:System.AppDomain> の正常なアンロードとは異なり、<xref:System.AppDomain> が突然アンロードされたときには、オブジェクトは終了されません。アプリケーションの正確さは保証できなくても、リソースをリークしないことでサーバーの整合性を保つ必要があるため、アンロードが突然発生した場合に、リソースがリークされないようにします。<xref:System.Runtime.InteropServices.SafeHandle> を使用して、オペレーティング システム リソースを解放します。  
+  
+### オペレーティング システム リソースのリークを防ぐために、finally 句を実行する必要がないことを確認する  
+ CER 以外の領域では、`finally` 句が実行されるという保証はないため、ライブラリ開発者には、アンマネージ リソースを解放するために `finally` ブロック内のコードに依存しないことが求められます。この解決策として、<xref:System.Runtime.InteropServices.SafeHandle> を使用することをお勧めします。  
+  
+#### コード分析規則  
+ オペレーティング システム リソースのクリーンアップには、`Finalize` ではなく <xref:System.Runtime.InteropServices.SafeHandle> を使用します。  <xref:System.IntPtr> は使用しないでください。<xref:System.Runtime.InteropServices.SafeHandle> を使用して、リソースをカプセル化します。  finally 句を実行する必要がある場合は CER に配置します。  
+  
+### すべてのロックは既存のマネージ ロック コードを完了する必要がある  
+ CLR は、スレッドをただ中止するのではなく、<xref:System.AppDomain> を破棄するために、コードがいつロック状態になっているかを認識する必要があります。スレッドを中止すると、そのスレッドで処理されているデータが矛盾した状態のままになる可能性があるため、危険な場合があります。  したがって、<xref:System.AppDomain> 全体をリサイクルする必要があります。ロックを識別できないと、デッドロックや不正な結果を招くおそれがあります。  ロック領域を識別するには、<xref:System.Threading.Thread.BeginCriticalRegion%2A> メソッドと <xref:System.Threading.Thread.EndCriticalRegion%2A> メソッドを使用します。この 2 つのメソッドは、現在のスレッドにだけ適用される <xref:System.Threading.Thread> クラスの静的メソッドです。これらを使用すると、あるスレッドが別のスレッドのロック カウントを編集するのを防ぐことができます。  
+  
+ <xref:System.Threading.Monitor.Enter%2A> と <xref:System.Threading.Monitor.Exit%2A> にはこの CLR 通知が組み込まれているため、これらを使用することをお勧めします。これらのメソッドを使用する [lock ステートメント](../Topic/lock%20Statement%20\(C%23%20Reference\).md) を使うこともできます。  
+  
+ スピン ロックなどの他のロック機構と <xref:System.Threading.AutoResetEvent> は、これらのメソッドを呼び出して、クリティカル セクションに入ったことを CLR に通知します。これらのメソッドはロックを取得するわけではありません。コードがクリティカル セクションで実行されており、スレッドを中止すると、共有の状態が矛盾したままになる可能性があることを CLR に通知します。カスタムの <xref:System.Threading.ReaderWriterLock> クラスなど、独自の種類のロックを定義している場合は、これらのロック カウント メソッドを使用します。  
+  
+#### コード分析規則  
+ <xref:System.Threading.Thread.BeginCriticalRegion%2A> と <xref:System.Threading.Thread.EndCriticalRegion%2A> を使用して、すべてのロックをマークし、識別します。  ループ内で、<xref:System.Threading.Interlocked.CompareExchange%2A>、<xref:System.Threading.Interlocked.Increment%2A>、および <xref:System.Threading.Interlocked.Decrement%2A> を使用しないでください。これらのメソッドの Win32 バリアントのプラットフォーム呼び出しを実行しないでください。ループ内で <xref:System.Threading.Thread.Sleep%2A> を使用しないでください。揮発性フィールドを使用しないでください。  
+  
+### クリーンアップ コードは、catch の後ではなく、finally または catch ブロックに配置する必要がある  
+ クリーンアップ コードを `catch` ブロックの後に配置することはできません。`finally` または `catch` ブロック自体に配置する必要があります。これは、通常推奨される方法です。`finally` ブロックは、例外がスローされたときと `try` ブロックの末尾まで正常に到達したときに同じコードを実行するため、通常はこのブロックが使用されます。<xref:System.Threading.ThreadAbortException> などの予期しない例外がスローされた場合には、クリーンアップ コードは実行されません。`finally` でクリーンアップするすべてのアンマネージ リソースは、リークを防ぐために <xref:System.Runtime.InteropServices.SafeHandle> にラップすることが理想的です。C\# の `using` キーワードを効果的に使用することで、ハンドルなどのオブジェクトを破棄できます。  
+  
+ <xref:System.AppDomain> のリサイクルによって、ファイナライザー スレッドのリソースをクリーンアップできますが、クリーンアップ コードを適切な場所に配置することも重要です。スレッドがロックを保持せずに非同期例外を受け取った場合、CLR は <xref:System.AppDomain> をリサイクルする必要なく、そのスレッド自体の終了を試みます。リソースが必ずクリーンアップされるようにすることで、より多くのリソースが利用可能になり、有効期間を適切に管理することもできます。あるエラー コードのパスにあるファイルへのハンドルを明示的に閉じずに、<xref:System.Runtime.InteropServices.SafeHandle> ファイナライザーがこれをクリーンアップするまで待機した場合、コードを次回実行したときに、ファイナライザーがまだ実行されていなければ、この同じファイルへのアクセス試行は失敗する可能性があります。このため、クリーンアップ コードが厳密には必要ない場合でも、クリーンアップ コードが存在し、正しく動作することを保証することで、完全かつ迅速にエラーから回復できます。  
+  
+#### コード分析規則  
+ `catch` の後のクリーンアップ コードは、`finally` ブロックにあることが必要です。  finally ブロックで破棄するための呼び出しを挿入します。`catch` ブロックがスローで終了するか、再スローする必要があります。例外が発生する可能性があるコード、例えばネットワーク接続を確立できるかどうかを確認するコードのように、そこで何らかの例外が発生する可能性があるコードでは、通常の状況でも多数の例外をキャッチする必要があるため、そのコードをテストして成功するかどうか確認する必要があります。  
+  
+### アプリケーション ドメイン間におけるプロセス全体の変更可能な共有の状態は、削除するか、制約された実行領域を使用する必要がある  
+ 導入部分で説明したように、複数のアプリケーション ドメインにわたるプロセス全体の共有の状態を信頼できる方法で監視するマネージ コードを記述することは、非常に困難であると考えられます。Win32 コード内、CLR 内部、またはリモート処理を使用するマネージ コード内において、プロセス全体の共有の状態はアプリケーション ドメイン間で共有されたある種のデータ構造です。変更可能な共有の状態は、マネージ コードに正確に記述することは非常に難しいため、静的な共有の状態を扱う場合は細心の注意が必要です。プロセス全体またはコンピューター全体の共有の状態がある場合、その状態を削除するか、制約された実行領域 \(CER: Constrained Execution Region\) を使用して共有の状態を保護するための何らかの方法を考えてください。ライブラリの共有の状態が特定または修正されていない場合、<xref:System.AppDomain> の完全なアンロードを必要とする SQL Server などのホストがクラッシュする原因になる可能性があります。  
+  
+ コードで COM オブジェクトを使用する場合は、アプリケーション ドメイン間でその COM オブジェクトを共有しないようにします。  
+  
+### プロセス全体またはアプリケーション ドメイン間ではロックは動作しない  
+ これまでは、<xref:System.Threading.Monitor.Enter%2A> と [lock ステートメント](../Topic/lock%20Statement%20\(C%23%20Reference\).md) を使用してプロセスのグローバル ロックを作成していました。この状況が発生するのは、共有されていないアセンブリの <xref:System.Type> インスタンス、<xref:System.Threading.Thread> オブジェクト、内部文字列、リモート処理を使用してアプリケーション ドメイン間で共有される一部の文字列など、<xref:System.AppDomain> の非バインド クラスでロックを行う場合などです。これらのロックは、プロセス全体にわたるロックではなくなっています。プロセス全体にわたるアプリケーション ドメイン間のロックの存在を特定するには、ロック内のコードが外部の永続化されたリソース \(ディスク上のファイルや場合によってはデータベースなど\) を使用しているかどうかを確認します。  
+  
+ 保護されたコードが外部リソースを使用している場合、そのコードは複数のアプリケーション ドメインで同時に実行される可能性があるため、<xref:System.AppDomain> 内でロックを取得すると問題が生じる場合があります。これは、1 つのログ ファイルへの書き込み時やプロセス全体のソケットにバインドするときに問題になる可能性があります。これらの変更は、名前付き <xref:System.Threading.Mutex> または <xref:System.Threading.Semaphore> インスタンスを使用する以外には、マネージ コードを使用してプロセスのグローバル ロックを容易に取得する方法はないことを意味します。2 つのアプリケーション ドメインで同時に実行されることのないコードを作成するか、<xref:System.Threading.Mutex> クラスまたは <xref:System.Threading.Semaphore> クラスを使用します。ファイバー モードでの実行は、ミューテックスの取得と解放を同じオペレーティング システム スレッドが行うことを保証できないことを意味するため、既存のコードを変更できない場合は、Win32 の名前付きミューテックスを使用してこの同期を行わないでください。アンマネージ コードを使用してロックを同期するのではなく、マネージ <xref:System.Threading.Mutex> クラス \(名前付き <xref:System.Threading.ManualResetEvent>\)、<xref:System.Threading.AutoResetEvent>、または <xref:System.Threading.Semaphore> を使用して、CLR が認識できる方法でコードのロックを同期します。  
+  
+#### lock\(typeof\(MyType\)\) を避ける  
+ すべてのアプリケーション ドメイン間で共有するコードのコピーを 1 つしか持たない共有アセンブリに含まれる、プライベートおよびパブリック <xref:System.Type> オブジェクトにも問題があります。共有アセンブリの場合、<xref:System.Type> のインスタンスはプロセスごとに 1 つしか存在しません。つまり、複数のアプリケーション ドメインが、まったく同じ <xref:System.Type> インスタンスを共有します。<xref:System.Type> インスタンスのロックを取得すると、<xref:System.AppDomain> だけでなくプロセス全体に影響するロックが取得されます。ある <xref:System.AppDomain> が <xref:System.Type> オブジェクトのロックを取得したときに、そのスレッドが突然中止された場合、ロックは解放されません。このロックによって、他のアプリケーション ドメインがデッドロック状態になる可能性があります。  
+  
+ 静的メソッド内でロックを取得する適切な方法は、静的な内部同期オブジェクトをコードに追加することです。これは、クラス コンストラクターが存在する場合はそのコンストラクターで初期化できますが、存在しない場合は次のように初期化できます。  
+  
+```  
+private static Object s_InternalSyncObject;  
+private static Object InternalSyncObject   
+{  
+    get   
+    {  
+        if (s_InternalSyncObject == null)   
+        {  
+            Object o = new Object();  
+            Interlocked.CompareExchange(  
+                ref s_InternalSyncObject, o, null);  
+        }  
+        return s_InternalSyncObject;  
+    }  
+}  
+```  
+  
+ 次に、ロックを取得するときに、`InternalSyncObject` プロパティを使用してロック対象のオブジェクトを取得します。クラス コンストラクターで内部同期オブジェクトを初期化した場合は、このプロパティを使用する必要はありません。ロック初期化コードの二重チェックは、この例のように行う必要があります。  
+  
+```  
+public static MyClass SingletonProperty   
+{  
+    get   
+    {  
+        if (s_SingletonProperty == null)   
+        {  
+            lock(InternalSyncObject)   
+            {  
+                // Do not use lock(typeof(MyClass))   
+                if (s_SingletonProperty == null)   
+                {  
+                    MyClass tmp = new MyClass(…);     
+                    // Do all initialization before publishing  
+                    s_SingletonProperty = tmp;  
+                }  
+            }  
+        }  
+        return s_SingletonProperty;  
+    }  
+}  
+```  
+  
+#### Lock\(this\) に関する注意  
+ パブリックにアクセスできる各オブジェクトのロックを取得することは、通常は許容できます。ただし、そのオブジェクトがサブシステム全体のデッドロックの原因となる可能性がある場合は、前述のデザイン パターンも使用することを検討してください。たとえば、1 つの <xref:System.Security.SecurityManager> オブジェクトのロックによって、<xref:System.AppDomain> 内でデッドロックが発生すると、<xref:System.AppDomain> 全体が使用できなくなります。  この種のパブリックにアクセスできるオブジェクトのロックは取得しないことをお勧めします。通常、個々のコレクションまたは配列のロックは問題ありません。  
+  
+#### コード分析規則  
+ 複数のアプリケーション ドメインにわたって使用する可能性のある型のロックを取得したり、同一性をあまり意識しないでください。  <xref:System.Type>、<xref:System.Reflection.MethodInfo>、<xref:System.Reflection.PropertyInfo>、<xref:System.String>、<xref:System.ValueType>、<xref:System.Threading.Thread>、または <xref:System.MarshalByRefObject> から派生したオブジェクトで <xref:System.Threading.Monitor.Enter%2A> を呼び出さないでください。  
+  
+### GC.KeepAlive 呼び出しを削除する  
+ <xref:System.GC.KeepAlive%2A> を使用する必要があるときに使用していなかったり、適切ではないときに使用していたりする既存のコードが多数存在します。クラスがファイナライザーを持たず、オペレーティング システム ハンドルを終了する際に <xref:System.Runtime.InteropServices.SafeHandle> に依存していることを前提として、<xref:System.Runtime.InteropServices.SafeHandle> に変換した後は、クラスで <xref:System.GC.KeepAlive%2A> を呼び出す必要はありません。<xref:System.GC.KeepAlive%2A> の呼び出しを保持するパフォーマンス コストはおそらくごくわずかであるにもかかわらず、既に存在しない場合もある有効期間の問題を解決するために <xref:System.GC.KeepAlive%2A> の呼び出しが必要である、またはこの呼び出しで十分であるという認識は、コードの維持を困難にします。ただし、COM 相互運用の CLR 呼び出し可能ラッパー \(RCW\) を使用する場合は、<xref:System.GC.KeepAlive%2A> はコードでやはり必要となります。  
+  
+#### コード分析規則  
+ <xref:System.GC.KeepAlive%2A> を削除します。  
+  
+### ホスト保護属性を使用する  
+ <xref:System.Security.Permissions.HostProtectionAttribute> \(HPA\) を使用すると、ホスト保護の要件を決定する宣言セキュリティ アクションを使用できます。これにより、ホストは、完全に信頼されるコードであっても、特定のホストには適さない一部のメソッド \(SQL Server の <xref:System.Environment.Exit%2A> や <xref:System.Windows.Forms.MessageBox.Show%2A> など\) の呼び出しを防ぐことができます。  
+  
+ HPA が影響するのは、共通言語ランタイムをホストし、ホスト保護を実装するアンマネージ アプリケーションだけです \(SQL Server など\)。  この属性を適用すると、セキュリティ アクションによって、クラスまたはメソッドが公開するホスト リソースに基づいたリンク確認要求が作成されます。  クライアント アプリケーション、またはホスト保護されていないサーバー \("evaporates" 属性が適用されたサーバー\) でコードを実行した場合、この属性は検出されないため適用されません。  
+  
+> [!IMPORTANT]
+>  この属性の目的は、セキュリティ動作ではなく、ホスト固有のプログラミング モデルのガイドラインを強制的に適用することです。リンク確認要求はプログラミング モデル要件への準拠性の確認に使用されますが、<xref:System.Security.Permissions.HostProtectionAttribute> はセキュリティ アクセス許可ではありません。  
+  
+ ホストにプログラミング モデル要件が設定されていない場合、リンク確認要求は発生しません。  
+  
+ この属性は、次のメソッドまたはクラスを識別します。  
+  
+-   ホストのプログラミング モデルに適合しないが、害のないメソッドまたはクラス  
+  
+-   ホストのプログラミング モデルに適合せず、サーバーが管理するユーザー コードを不安定にする可能性があるメソッドまたはクラス  
+  
+-   ホストのプログラミング モデルに適合せず、サーバー プロセス自体を不安定にする可能性があるメソッドまたはクラス  
+  
+> [!NOTE]
+>  ホスト保護環境で実行する可能性があるアプリケーションで呼び出すクラス ライブラリを作成する場合、<xref:System.Security.Permissions.HostProtectionResource> リソース カテゴリを公開するメンバーにこの属性を適用してください。  この属性を持つ .NET Framework クラス ライブラリのメンバーによって、直接の呼び出し元だけがチェックされます。作成したライブラリ メンバーも、これと同様に直前の呼び出し元のチェックを行う必要があります。  
+  
+ HPA の詳細については、<xref:System.Security.Permissions.HostProtectionAttribute> のトピックを参照してください。  
+  
+#### コード分析規則  
+ SQL Server の場合、同期またはスレッド処理を導入するために使用するすべてのメソッドは、HPA で識別する必要があります。  これには、状態を共有するメソッド、同期されたメソッド、外部プロセスを管理するメソッドが含まれます。  SQL Server に影響を及ぼす <xref:System.Security.Permissions.HostProtectionResource> 値は、<xref:System.Security.Permissions.HostProtectionResource>、<xref:System.Security.Permissions.HostProtectionResource>、および <xref:System.Security.Permissions.HostProtectionResource> です。  ただし、<xref:System.Security.Permissions.HostProtectionResource> を公開するメソッドは、SQL に影響を及ぼすリソースを使用するこれらの値だけでなく、HPA によって識別する必要があります。  
+  
+### アンマネージ コード内で無期限にブロックしない  
+ マネージ コードではなく、アンマネージ コード内でブロッキングすると、CLR がスレッドを中止できないため、サービス拒否攻撃の原因になる可能性があります。スレッドがブロックされると、CLR は一部の非常に安全性の低い操作を実行しなければ、<xref:System.AppDomain> をアンロードできなくなります。Win32 同期プリミティブを使用したブロッキングは、容認できないブロッキングの一例です。ソケットの `ReadFile` の呼び出しにおけるブロッキングは、できるだけ避ける必要があります。このような操作がタイムアウトする機構を Win32 API で提供するのが理想的です。  
+  
+ ネイティブに呼び出すメソッドでは、適切な有限のタイムアウトを設定して Win32 呼び出しを使用することが望まれます。ユーザーがタイムアウトを指定できるようにする場合、特定のセキュリティ アクセス許可がなければ無限のタイムアウトを指定できないようにする必要があります。1 つのガイドラインとして、メソッドが 10 秒以上ブロックする場合には、タイムアウトをサポートするバージョンを使用するか、CLR の追加サポートが必要です。  
+  
+ 問題のある API の例を紹介します。パイプ \(匿名パイプと名前付きパイプの両方\) は、タイムアウトを指定して作成できますが、コードでは NMPWAIT\_WAIT\_FOREVER で `CreateNamedPipe` と `WaitNamedPipe` のいずれも呼び出さないようにする必要があります。また、タイムアウトが指定されている場合でも、予測不可能なブロッキングが発生する可能性もあります。匿名パイプで `WriteFile` を呼び出すと、すべてのバイトが書き込まれるまでブロックされます。つまり、バッファーに読み取られていないデータがある場合、リーダーがパイプのバッファー内の領域を解放するまで、`WriteFile` 呼び出しによってブロックされます。ソケットでは、タイムアウト機構を重視する API を必ず使用する必要があります。  
+  
+#### コード分析規則  
+ アンマネージ コード内のタイムアウトのないブロッキングは、サービス拒否攻撃です。  プラットフォーム呼び出しを実行して、`WaitForSingleObject`、`WaitForSingleObjectEx`、`WaitForMultipleObjects`、`MsgWaitForMultipleObjects`、および `MsgWaitForMultipleObjectsEx` を呼び出さないでください。NMPWAIT\_WAIT\_FOREVER は使用しないでください。  
+  
+### STA に依存する機能を識別する  
+ COM シングルスレッド アパートメント \(STA: Single\-Threaded Apartment\) を使用するコードを識別します。SQL Server プロセスでは、STA は無効になります。パフォーマンス カウンターやクリップボードなど、`CoInitialize` に依存する機能は SQL Server 内では無効にする必要があります。  
+  
+### ファイナライザーに同期の問題がないことを確認する  
+ .NET Framework の今後のバージョンでは、複数のファイナライザー スレッドが存在できます。つまり、同じ型の異なるインスタンスのファイナライザーが同時に実行されます。これらは、完全にスレッド セーフである必要はありません。ガベージ コレクターは、オブジェクトの特定のインスタンスのファイナライザーを実行するスレッドは 1 つだけであることを保証します。ただし、オブジェクトの複数の異なるインスタンスで同時に実行するときに、競合状態やデッドロック状態にならないように、ファイナライザーをコーディングする必要があります。ファイナライザーで外部の状態 \(ログ ファイルへの書き込みなど\) を使用する場合は、スレッド処理の問題に対処する必要があります。スレッド セーフにするために、終了処理に依存しないでください。  スレッド ローカル ストレージ \(マネージまたはネイティブ\) を使用して、ファイナライザー スレッドの状態を格納しないでください。  
+  
+#### コード分析規則  
+ ファイナライザーには、同期の問題がないことが必要です。  ファイナライザーで静的に変更可能な状態を使用しないでください。  
+  
+### アンマネージ メモリはできるだけ避ける  
+ オペレーティング システム ハンドルと同様に、アンマネージ メモリもリークされる可能性があります。できれば、[stackalloc](../Topic/stackalloc%20\(C%23%20Reference\).md) を使用してスタックにメモリを割り当てるか、固定されたマネージ オブジェクト \([fixed ステートメント](../Topic/fixed%20Statement%20\(C%23%20Reference\).md) や byte\[\] を使用した <xref:System.Runtime.InteropServices.GCHandle> など\) を使用するようにします。<xref:System.GC> は、最終的にこれらをクリーンアップします。ただし、アンマネージ メモリを割り当てる必要がある場合は、<xref:System.Runtime.InteropServices.SafeHandle> から派生したクラスを使用して、メモリの割り当てをラップするよう考慮してください。  
+  
+ <xref:System.Runtime.InteropServices.SafeHandle> が適さないケースが少なくとも 1 つあります。メモリの割り当てまたは解放を行う COM メソッド呼び出しでは、ある DLL が `CoTaskMemAlloc` によってメモリを割り当て、別の DLL が `CoTaskMemFree` によってそのメモリを解放するのが一般的です。<xref:System.Runtime.InteropServices.SafeHandle> は、一方の DLL がメモリの有効期間を制御できるようにする代わりに、アンマネージ メモリの有効期間を <xref:System.Runtime.InteropServices.SafeHandle> の有効期間と結び付けようとするため、このような状況で使用することは適切ではありません。  
+  
+### catch\(Exception\) のすべての使用を見直す  
+ ある特定の例外ではなく、すべての例外をキャッチする catch ブロックは、非同期例外もキャッチします。すべての catch\(Exception\) ブロックをチェックし、重要ではないリソースの解放やスキップできるバックアウト コード、および <xref:System.Threading.ThreadAbortException>、<xref:System.StackOverflowException>、または <xref:System.OutOfMemoryException> を処理するために catch ブロック自体に含まれる不正と思われる動作を探します。このコードは、ログを記録する可能性もあれば、特定の例外だけを確認することを想定していたり、例外が発生するたびに、ある特別な原因に当てはまる場合にだけ失敗することを想定していたりする可能性もあります。これらの想定を更新し、<xref:System.Threading.ThreadAbortException> を含めることが必要な場合があります。  
+  
+ すべての例外をキャッチするすべての場所を、スローされることが予測される特定の種類の例外 \(文字列の書式指定メソッドの <xref:System.FormatException> など\) をキャッチするように変更することを検討します。これにより、catch ブロックが予測不可能な例外に対して実行されなくなります。また、予測不可能な例外をキャッチすることにより、コードに含まれるバグを明らかにすることもできます。原則として、ライブラリ コード内の例外は処理しないでください \(例外をキャッチする必要のあるコードは、呼び出すコード内のデザイン上の欠陥を示す場合があります\)。例外をキャッチし、別の種類の例外をスローして、より多くのデータを提供することが望ましい場合もあります。この場合、入れ子になった例外を使用して、新しい例外の <xref:System.Exception.InnerException%2A> プロパティにエラーの実際の原因を格納します。  
+  
+#### コード分析規則  
+ すべてのオブジェクトを受け取るマネージ コード、またはすべての例外をキャッチするマネージ コード内のすべての catch ブロックを見直します。C\# の場合、これは、`catch` {} と `catch(Exception)` {} の両方にフラグを設定するということです。例外の種類をきわめて特殊なものにするよう考慮するか、コードを見直して、予測不可能な例外の種類をキャッチした場合に不適切に動作しないようにします。  
+  
+### Win32 スレッドはファイバーであるため、マネージ スレッドが Win32 スレッドであることを想定しない  
+ マネージ スレッド ローカル ストレージは使用できますが、アンマネージ スレッド ローカル ストレージを使用することはできません。また、コードが現在のオペレーティング システム スレッドで再度実行されることも想定しないでください。スレッドのロケールと同様に設定を変更しないでください。`InitializeCriticalSection` および `CreateMutex` では、ロック状態に入るオペレーティング システム スレッドがそのロックを終了させる必要があるため、プラットフォーム呼び出しによってこれらを呼び出さないでください。これは、ファイバーを使用するケースではないため、Win32 のクリティカル セクションとミューテックスを SQL で直接使用することはできません。マネージ <xref:System.Threading.Mutex> クラスは、これらのスレッド アフィニティの懸念事項には対処しません。  
+  
+ マネージ スレッド ローカル ストレージやスレッドの現在の UI カルチャを含め、マネージ <xref:System.Threading.Thread> オブジェクトのほとんどの状態を安全に使用できます。また、現在のマネージ スレッドでのみ既存の静的変数の値をアクセス可能にする <xref:System.ThreadStaticAttribute> を使用することもできます \(これは、CLR でファイバー ローカル ストレージを使用するもう 1 つの方法です\)。プログラミング モデルに関する理由から、SQL での実行時にスレッドの現在のカルチャを変更することはできません。  
+  
+#### コード分析規則  
+ SQL Server はファイバー モードで実行します。スレッド ローカル ストレージは使用しないでください。  プラットフォーム呼び出しによって、`TlsAlloc`、`TlsFree`、`TlsGetValue`、および `TlsSetValue.` を呼び出すことは避けます。  
+  
+### SQL Server に偽装を処理させる  
+ 偽装はスレッド レベルで機能し、SQL はファイバー モードで実行できるため、マネージ コードでユーザーを偽装する必要はありません。また、`RevertToSelf` を呼び出す必要もありません。  
+  
+#### コード分析規則  
+ SQL Server に偽装を処理させます。  `RevertToSelf`、`ImpersonateAnonymousToken`、`DdeImpersonateClient`、`ImpersonateDdeClientWindow`、`ImpersonateLoggedOnUser`、`ImpersonateNamedPipeClient`、`ImpersonateSelf`、`RpcImpersonateClient`、`RpcRevertToSelf`、`RpcRevertToSelfEx`、`SetThreadToken` を使用しないでください。  
+  
+### Thread::Suspend を呼び出さない  
+ スレッドを中断する機能は単純な動作のように思われますが、デッドロック状態の原因になる可能性があります。ロックを保持するスレッドが 2 番目のスレッドによって中断されてから、2 番目のスレッドが同じロックを取得しようとすると、デッドロックが発生します。<xref:System.Threading.Thread.Suspend%2A> は、セキュリティ、クラスの読み込み、リモート処理、および現在のリフレクションに干渉する。  
+  
+#### コード分析規則  
+ <xref:System.Threading.Thread.Suspend%2A> を呼び出さないでください。  代わりに、<xref:System.Threading.Semaphore> や <xref:System.Threading.ManualResetEvent> など、同期プリミティブを使用するよう考慮します。  
+  
+### 制約された実行領域と信頼性のコントラクトを使用して重大な操作を保護する  
+ 共有の状態を更新する複雑な操作や、完全に成功するか、完全に失敗するかのいずれかであることを必要とする複雑な操作を実行するときには、制約された実行領域 \(CER: Constrained Execution Region\) によって必ず保護します。  これにより、スレッドが突然中止されたり、<xref:System.AppDomain> が突然アンロードされた場合も含め、どのような場合にもコードが実行されることが保証されます。  
+  
+ CER は、<xref:System.Runtime.CompilerServices.RuntimeHelpers.PrepareConstrainedRegions%2A> の呼び出しの直後に配置された特殊な `try/finally` ブロックです。  
+  
+ CER を使用すると、`try` ブロックを実行する前に、finally ブロックにすべてのコードを準備するよう JIT \(Just\-In\-Time\) コンパイラに指示します。  これにより、どのような場合でも finally ブロック内のコードがビルドされ、実行されることが保証されます。  CER に空の `try` ブロックを配置することはまれです。  CER を使用すると、非同期スレッドの中止とメモリ不足の例外から保護できます。  非常に複雑なコードのスタック オーバーフローを追加処理する CER の形式については、<xref:System.Runtime.CompilerServices.RuntimeHelpers.ExecuteCodeWithGuaranteedCleanup%2A> のトピックを参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.ConstrainedExecution>   
+ [SQL Server プログラミングとホスト保護属性](../../../docs/framework/performance/sql-server-programming-and-host-protection-attributes.md)
\ No newline at end of file
diff --git a/docs/framework/performance/reliability.md b/docs/framework/performance/reliability.md
new file mode 100644
index 00000000000..d8bd8dedeb6
--- /dev/null
+++ b/docs/framework/performance/reliability.md
@@ -0,0 +1,43 @@
+---
+title: "信頼性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コード, 信頼性"
+  - "マネージ コード, 信頼性"
+  - "信頼性 [.NET Framework]"
+  - "SQL Server [.NET Framework]"
+  - "記述 (信頼性の高いコードを)"
+ms.assetid: 294aa306-0afe-4cbe-b397-86ba9f1860f8
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 信頼性
+SQL Server などのサーバー環境で実行されるコードでは、非同期例外に対して保護することが重要です。  ここで説明する信頼性は、SQL Server に固有のものではなく、.NET Framework Version 2.0 環境で実行されるすべてのホスト用に信頼性のあるコードを記述するためのものです。  ただし、ここでは SQL Server を例として使用しています。これは、SQL Server が Version 2.0 の新しい信頼性機能を広範に利用する最初のサービスであるためです。  
+  
+ SQL Server で実行されるコードには、信頼性に関して他のサーバー環境よりも厳しいガイドラインを使用する必要があります。  これは、リソース使用の端に SQL Server が安定して動作させるためです。<xref:System.OutOfMemoryException> と <xref:System.Threading.ThreadAbortException> 例外が SQL Server 環境でよくあります。  一般に、このようなガイドラインでは、信頼性よりも、完全に信頼されているマネージ コードが <xref:System.AppDomain> レベルのリサイクル \(サーバーが一貫性と可用性を維持するための主要な方法\) に直面した場合に適切に失敗できるようにすることに重点が置かれています。  
+  
+## このセクションの内容  
+ [SQL Server プログラミングとホスト保護属性](../../../docs/framework/performance/sql-server-programming-and-host-protection-attributes.md)  
+ アンマネージ コードの実行を制限するために、SQL Server が <xref:System.Security.Permissions.HostProtectionAttribute> 属性をどのように使用するかについて説明します。  
+  
+ [信頼性に関するベスト プラクティス](../../../docs/framework/performance/reliability-best-practices.md)  
+ 信頼性の要件を満たすコードを記述するためのガイドラインを示します。  
+  
+ [制約された実行領域](../../../docs/framework/performance/constrained-execution-regions.md)  
+ 制約された実行領域 \(CER: Constrained Execution Region\) の機能および動作について説明します。  
+  
+## 関連項目  
+ <xref:System.Security.Permissions.HostProtectionAttribute>  
+  
+ <xref:System.Security.Permissions.HostProtectionResource>
\ No newline at end of file
diff --git a/docs/framework/performance/runtime-information-etw-events.md b/docs/framework/performance/runtime-information-etw-events.md
new file mode 100644
index 00000000000..8090c222270
--- /dev/null
+++ b/docs/framework/performance/runtime-information-etw-events.md
@@ -0,0 +1,53 @@
+---
+title: "ランタイム情報 ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, ランタイム情報イベント"
+  - "ランタイム情報イベント [.NET Framework]"
+ms.assetid: 68b4edbc-7f3b-45f6-ab75-4fd066d6af9a
+caps.latest.revision: 6
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ランタイム情報 ETW イベント
+これらの ETW イベントは、SKU、バージョン番号、アクティブ化の方法、起動時に使用されたコマンド ライン パラメーター、GUID \(該当する場合\) などのランタイムに関する情報をログに記録します。  1 つのプロセスで複数のランタイムが実行されている場合は、これらのイベントの情報 \(ClrInstanceID\) によってあいまいさを解消できます。  
+  
+ 次の表に、2 つのランタイム情報イベントを示します。  これらのイベントは、すべてのキーワードまたはマスクで発生させることができます \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベント|イベント ID|プロバイダー|説明|  
+|----------|-------------|------------|--------|  
+|`RuntimeInformationEvent`|187|CLRRuntime|ランタイムが読み込まれたときに発生します。|  
+|`RuntimeInformationDCStart`|187|CLRRundown|読み込まれているランタイムを列挙します。|  
+  
+ イベント データを次の表に示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+|Sku|win:UInt16|1 – デスクトップ CLR。<br /><br /> 2 – CoreCLR。|  
+|BclVersion – Major Version|win:UInt16|mscorlib.dll のメジャー バージョン。|  
+|BclVersion – Minor Version|win:UInt16|mscorlib.dll のマイナー バージョン番号。|  
+|BclVersion – Build Number|win:UInt16|mscorlib.dll のビルド番号。|  
+|BclVersion – QFE|win:UInt16|mscorlib.dll の修正プログラムのバージョン番号。|  
+|VMVersion – Major Version|win:UInt16|clr.dll または coreclr.dll \(SKU によって決まります\) のバージョン。|  
+|VMVersion – Minor Version|win:UInt16|clr.dll または coreclr.dll \(SKU によって決まります\) のマイナー バージョン。|  
+|VMVersion – Build Number|win:UInt16|clr.dll または coreclr.dll のビルド番号。|  
+|VMVersion – QFE|win:UInt16|clr.dll または coreclr.dll の修正プログラムのバージョン番号。|  
+|StartupFlags|win:UInt32|mscoree.h に定義された起動フラグ。|  
+|StartupMode|win:UInt8|0x01 \- マネージ実行可能ファイル。<br /><br /> 0x02 \- ホストされた CLR。<br /><br /> 0x04 \- C\+\+ マネージ相互運用。<br /><br /> 0x08 \- COM アクティブ化。<br /><br /> 0x10 \- その他。|  
+|CommandLine|win:UnicodeString|StartupMode\=0x01 の場合のみ null 以外。|  
+|ComObjectGUID|win:GUID|StartupMode\=0x08 の場合のみ null 以外。|  
+|RuntimeDLLPath|win:UnicodeString|プロセスに読み込まれた CLR .dll ファイルへのパス。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/security-etw-events.md b/docs/framework/performance/security-etw-events.md
new file mode 100644
index 00000000000..d83ef3aa282
--- /dev/null
+++ b/docs/framework/performance/security-etw-events.md
@@ -0,0 +1,82 @@
+---
+title: "セキュリティ ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, セキュリティ イベント (CLR)"
+  - "セキュリティ イベント [.NET Framework]"
+ms.assetid: 0ed69f73-5c01-4514-bd63-979c6e38d41d
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# セキュリティ ETW イベント
+<a name="top"></a> セキュリティ イベントは、厳密な名前の検証時と Authenticode の検証時に発生します。  
+  
+ このカテゴリは、次のイベントで構成されます。  
+  
+-   [StrongNameVerificationStart\_V1 イベントと StrongNameVerificationStop\_V1 イベント](#strongnameverificationstart_v1_and_strongnameverificationstop_v1_events)  
+  
+-   [AuthenticodeVerificationStart\_V1 イベントと AuthenticodeVerificationStop\_V1 イベント](#authenticodeverificationstart_v1_and_authenticodeverificationstop_v1_events)  
+  
+<a name="strongnameverificationstart_v1_and_strongnameverificationstop_v1_events"></a>   
+## StrongNameVerificationStart\_V1 イベントと StrongNameVerificationStop\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`SecurityKeyword` \(0x400\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`StrongNameVerificationStart_V1`|181|厳密な名前の検証の開始。|  
+|`StrongNameVerificationStop_V1`|182|厳密な名前の検証の終了。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|VerificationFlags|win:UInt32|検証フラグ。|  
+|ErrorCode|win:UInt32|HResult エラー コード。|  
+|FullyQualifiedAssemblyName|win:UnicodeString|完全修飾アセンブリ名。|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="authenticodeverificationstart_v1_and_authenticodeverificationstop_v1_events"></a>   
+## AuthenticodeVerificationStart\_V1 イベントと AuthenticodeVerificationStop\_V1 イベント  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`SecurityKeyword` \(0x400\)|情報通知 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`AuthenticodeVerificationStart_V1`|183|Authenticode 検証の開始。|  
+|`AuthenticodeVerificationStop_V1`|184|Authenticode 検証の終了。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|VerificationFlags|win:UInt32|検証フラグ。|  
+|ErrorCode|win:UInt32|HResult エラー コード。|  
+|ModulePath|win:UnicodeString|モジュール パス|  
+|ClrInstanceID|win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/sql-server-programming-and-host-protection-attributes.md b/docs/framework/performance/sql-server-programming-and-host-protection-attributes.md
new file mode 100644
index 00000000000..0b66c9460f4
--- /dev/null
+++ b/docs/framework/performance/sql-server-programming-and-host-protection-attributes.md
@@ -0,0 +1,85 @@
+---
+title: "SQL Server プログラミングとホスト保護属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト保護属性"
+  - "HostProtectionAttribute クラス, 信頼性"
+  - "ホスト, 信頼性"
+  - "マネージ コード, SQL Server"
+  - "アクセス許可セット, SQL Server"
+  - "信頼性 [.NET Framework]"
+  - "SQL Server [.NET Framework]"
+  - "SQL Server プログラミングとホスト保護属性"
+  - "記述 (信頼性の高いコードを)"
+ms.assetid: 7dfa36b4-e773-4c75-a3ff-ff1af3ce4c4f
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# SQL Server プログラミングとホスト保護属性
+SQL Server ホストでマネージ コードを読み込んで実行するには、コード アクセス セキュリティとホスト リソース保護の両方に対するホストの要件を満たす必要があります。コード アクセス セキュリティ要件は、SAFE、EXTERNAL\-ACCESS、UNSAFE という 3 つの SQL Server アクセス許可セットのうちのいずれかによって指定されます。  SAFE アクセス許可セットまたは EXTERNAL\-ACCESS アクセス許可セット内で実行するコードでは、<xref:System.Security.Permissions.HostProtectionAttribute> 属性が適用されている特定の型またはメンバーの使用を避ける必要があります。  <xref:System.Security.Permissions.HostProtectionAttribute> は、ホストによって許可されない可能性がある特定のコード コンストラクター \(型またはメソッド\) を識別するという点で、信頼性の保証に相当するほどのセキュリティ アクセス許可とは言えません。<xref:System.Security.Permissions.HostProtectionAttribute> を使用すると、ホストの安定性を保護するのに役立つプログラミング モデルが適用されます。  
+  
+## ホスト保護属性  
+ ホスト保護属性は、ホスト プログラミング モデルに適合せず、次のような信頼性に対する脅威を表す型やメンバーを識別します。  
+  
+-   ホスト プログラミング モデルに適合しないこと以外に問題がない。  
+  
+-   サーバー管理ユーザー コードの不安定化につながる可能性がある。  
+  
+-   サーバー プロセス自体の不安定化につながる可能性がある。  
+  
+ SQL Server は、<xref:System.Security.Permissions.HostProtectionResource>、<xref:System.Security.Permissions.HostProtectionResource>、<xref:System.Security.Permissions.HostProtectionResource>、または <xref:System.Security.Permissions.HostProtectionResource> の <xref:System.Security.Permissions.HostProtectionResource> 値を指定する <xref:System.Security.Permissions.HostProtectionAttribute> を持つ型またはメンバーを許可しません。  これにより、共有状態を有効にしたり、同期を実行したり、終了時にリソース リークの原因になったり、SQL Server プロセスの整合性に影響したりするメンバーのアセンブリによる呼び出しが防止されます。  
+  
+### 許可されない型およびメンバー  
+ <xref:System.Security.Permissions.HostProtectionResource> 値が SQL Server によって許可されない型とメンバーを次の表に示します。  
+  
+|名前空間|型またはメンバー|  
+|----------|--------------|  
+|`Microsoft.Win32`|<xref:Microsoft.Win32.PowerModeChangedEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.PowerModeChangedEventHandler> デリゲート<br /><br /> <xref:Microsoft.Win32.SessionEndedEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.SessionEndedEventHandler> デリゲート<br /><br /> <xref:Microsoft.Win32.SessionEndingEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.SessionEndingEventHandler> デリゲート<br /><br /> <xref:Microsoft.Win32.SessionSwitchEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.SessionSwitchEventHandler> デリゲート<br /><br /> <xref:Microsoft.Win32.SystemEvents> クラス<br /><br /> <xref:Microsoft.Win32.TimerElapsedEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.TimerElapsedEventHandler> デリゲート<br /><br /> <xref:Microsoft.Win32.UserPreferenceChangedEventArgs> クラス<br /><br /> <xref:Microsoft.Win32.UserPreferenceChangingEventArgs> クラス|  
+|`System.Collections`|<xref:System.Collections.ArrayList.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Collections.Hashtable.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Collections.Queue.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Collections.SortedList.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Collections.Stack.Synchronized%2A?displayProperty=fullName> メソッド|  
+|`System.ComponentModel`|<xref:System.ComponentModel.AddingNewEventArgs> クラス<br /><br /> <xref:System.ComponentModel.AddingNewEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.ArrayConverter> クラス<br /><br /> <xref:System.ComponentModel.AsyncCompletedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.AsyncCompletedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.AsyncOperation> クラス<br /><br /> <xref:System.ComponentModel.AsyncOperationManager> クラス<br /><br /> <xref:System.ComponentModel.AttributeCollection> クラス<br /><br /> <xref:System.ComponentModel.BackgroundWorker> クラス<br /><br /> <xref:System.ComponentModel.BaseNumberConverter> クラス<br /><br /> <xref:System.ComponentModel.BindingList%601> クラス<br /><br /> <xref:System.ComponentModel.BooleanConverter> クラス<br /><br /> <xref:System.ComponentModel.ByteConverter> クラス<br /><br /> <xref:System.ComponentModel.CancelEventArgs> クラス<br /><br /> <xref:System.ComponentModel.CancelEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.CharConverter> クラス<br /><br /> <xref:System.ComponentModel.CollectionChangeEventArgs> クラス<br /><br /> <xref:System.ComponentModel.CollectionChangeEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.CollectionConverter> クラス<br /><br /> <xref:System.ComponentModel.ComponentCollection> クラス<br /><br /> <xref:System.ComponentModel.ComponentConverter> クラス<br /><br /> <xref:System.ComponentModel.ComponentEditor> クラス<br /><br /> <xref:System.ComponentModel.ComponentResourceManager> クラス<br /><br /> <xref:System.ComponentModel.Container> クラス<br /><br /> <xref:System.ComponentModel.ContainerFilterService> クラス<br /><br /> <xref:System.ComponentModel.CultureInfoConverter> クラス<br /><br /> <xref:System.ComponentModel.CustomTypeDescriptor> クラス<br /><br /> <xref:System.ComponentModel.DateTimeConverter> クラス<br /><br /> <xref:System.ComponentModel.DecimalConverter> クラス<br /><br /> <xref:System.ComponentModel.Design.ActiveDesignerEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.ActiveDesignerEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.CheckoutException> クラス<br /><br /> <xref:System.ComponentModel.Design.CommandID> クラス<br /><br /> <xref:System.ComponentModel.Design.ComponentChangedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.ComponentChangedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.ComponentChangingEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.ComponentChangingEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.ComponentEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.ComponentEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.ComponentRenameEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.ComponentRenameEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.DesignerCollection> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.DesignerOptionService> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerTransaction> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerTransactionCloseEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerTransactionCloseEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.DesignerVerb> クラス<br /><br /> <xref:System.ComponentModel.Design.DesignerVerbCollection> クラス<br /><br /> <xref:System.ComponentModel.Design.DesigntimeLicenseContext> クラス<br /><br /> <xref:System.ComponentModel.Design.DesigntimeLicenseContextSerializer> クラス<br /><br /> <xref:System.ComponentModel.Design.MenuCommand> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.ComponentSerializationService> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.ContextStack> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.DesignerLoader> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.InstanceDescriptor> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.MemberRelationshipService> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.ResolveNameEventArgs> クラス<br /><br /> <xref:System.ComponentModel.Design.Serialization.ResolveNameEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.Design.Serialization.SerializationStore> クラス<br /><br /> <xref:System.ComponentModel.Design.ServiceContainer> クラス<br /><br /> <xref:System.ComponentModel.Design.ServiceCreatorCallback> デリゲート<br /><br /> <xref:System.ComponentModel.Design.StandardCommands> クラス<br /><br /> <xref:System.ComponentModel.Design.StandardToolWindows> クラス<br /><br /> <xref:System.ComponentModel.DoubleConverter> クラス<br /><br /> <xref:System.ComponentModel.DoWorkEventArgs> クラス<br /><br /> <xref:System.ComponentModel.DoWorkEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.EnumConverter> クラス<br /><br /> <xref:System.ComponentModel.EventDescriptor> クラス<br /><br /> <xref:System.ComponentModel.EventDescriptorCollection> クラス<br /><br /> <xref:System.ComponentModel.EventHandlerList> クラス<br /><br /> <xref:System.ComponentModel.ExpandableObjectConverter> クラス<br /><br /> <xref:System.ComponentModel.HandledEventArgs> クラス<br /><br /> <xref:System.ComponentModel.HandledEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.InstanceCreationEditor> クラス<br /><br /> <xref:System.ComponentModel.Int16Converter> クラス<br /><br /> <xref:System.ComponentModel.Int32Converter> クラス<br /><br /> <xref:System.ComponentModel.Int64Converter> クラス<br /><br /> <xref:System.ComponentModel.InvalidAsynchronousStateException> クラス<br /><br /> <xref:System.ComponentModel.InvalidEnumArgumentException> クラス<br /><br /> <xref:System.ComponentModel.ISynchronizeInvoke.BeginInvoke%2A> メソッド<br /><br /> <xref:System.ComponentModel.License> クラス<br /><br /> <xref:System.ComponentModel.LicenseContext> クラス<br /><br /> <xref:System.ComponentModel.LicenseException> クラス<br /><br /> <xref:System.ComponentModel.LicenseManager> クラス<br /><br /> <xref:System.ComponentModel.LicenseProvider> クラス<br /><br /> <xref:System.ComponentModel.LicFileLicenseProvider> クラス<br /><br /> <xref:System.ComponentModel.ListChangedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.ListChangedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.ListSortDescription> クラス<br /><br /> <xref:System.ComponentModel.ListSortDescriptionCollection> クラス<br /><br /> <xref:System.ComponentModel.MaskedTextProvider> クラス<br /><br /> <xref:System.ComponentModel.MemberDescriptor> クラス<br /><br /> <xref:System.ComponentModel.MultilineStringConverter> クラス<br /><br /> <xref:System.ComponentModel.NestedContainer> クラス<br /><br /> <xref:System.ComponentModel.NullableConverter> クラス<br /><br /> <xref:System.ComponentModel.ProgressChangedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.ProgressChangedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.PropertyChangedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.PropertyChangedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.PropertyDescriptor> クラス<br /><br /> <xref:System.ComponentModel.PropertyDescriptorCollection> クラス<br /><br /> <xref:System.ComponentModel.ReferenceConverter> クラス<br /><br /> <xref:System.ComponentModel.RefreshEventArgs> クラス<br /><br /> <xref:System.ComponentModel.RefreshEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.RunWorkerCompletedEventArgs> クラス<br /><br /> <xref:System.ComponentModel.RunWorkerCompletedEventHandler> デリゲート<br /><br /> <xref:System.ComponentModel.SByteConverter> クラス<br /><br /> <xref:System.ComponentModel.SingleConverter> クラス<br /><br /> <xref:System.ComponentModel.StringConverter> クラス<br /><br /> <xref:System.ComponentModel.SyntaxCheck> クラス<br /><br /> <xref:System.ComponentModel.TimeSpanConverter> クラス<br /><br /> <xref:System.ComponentModel.TypeConverter> クラス<br /><br /> <xref:System.ComponentModel.TypeDescriptionProvider> クラス<br /><br /> <xref:System.ComponentModel.TypeDescriptor> クラス<br /><br /> <xref:System.ComponentModel.TypeListConverter> クラス<br /><br /> <xref:System.ComponentModel.UInt16Converter> クラス<br /><br /> <xref:System.ComponentModel.UInt32Converter> クラス<br /><br /> <xref:System.ComponentModel.UInt64Converter> クラス<br /><br /> <xref:System.ComponentModel.WarningException> クラス<br /><br /> <xref:System.ComponentModel.Win32Exception> クラス|  
+|`System.Diagnostics`|<xref:System.Diagnostics.Debug.Listeners%2A?displayProperty=fullName> プロパティ<br /><br /> <xref:System.Diagnostics.Trace.Listeners%2A?displayProperty=fullName> プロパティ<br /><br /> <xref:System.Diagnostics.EventLog.SynchronizingObject%2A?displayProperty=fullName> プロパティ<br /><br /> <xref:System.Diagnostics.ConsoleTraceListener> クラス<br /><br /> <xref:System.Diagnostics.DefaultTraceListener> クラス<br /><br /> <xref:System.Diagnostics.DelimitedListTraceListener> クラス<br /><br /> <xref:System.Diagnostics.EventLogTraceListener> クラス<br /><br /> <xref:System.Diagnostics.PerformanceCounter> クラス<br /><br /> <xref:System.Diagnostics.PerformanceCounterCategory> クラス<br /><br /> <xref:System.Diagnostics.Process> クラス<br /><br /> <xref:System.Diagnostics.ProcessStartInfo> クラス<br /><br /> <xref:System.Diagnostics.TextWriterTraceListener> クラス<br /><br /> <xref:System.Diagnostics.TraceListener> クラス<br /><br /> <xref:System.Diagnostics.XmlWriterTraceListener> クラス<br /><br /> <xref:System.Diagnostics.TraceSource.Listeners%2A?displayProperty=fullName> プロパティ|  
+|`System.IO`|<xref:System.IO.Stream.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.TextReader.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.TextWriter.Synchronized%2A?displayProperty=fullName> メソッド|  
+|`System.Reflection.Emit`|<xref:System.Reflection.Emit.ConstructorBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.EventBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.FieldBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.MethodBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.CustomAttributeBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.MethodRental> クラス<br /><br /> <xref:System.Reflection.Emit.ModuleBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.PropertyBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.TypeBuilder> クラス<br /><br /> <xref:System.Reflection.Emit.UnmanagedMarshal> クラス|  
+|`System.Text`|<xref:System.Text.RegularExpressions.Group.Synchronized%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Text.RegularExpressions.Match.Synchronized%2A?displayProperty=fullName> メソッド|  
+|`System.Threading`|<xref:System.Threading.AutoResetEvent> クラス<br /><br /> <xref:System.Threading.EventWaitHandle> クラス<br /><br /> <xref:System.Threading.ManualResetEvent> クラス<br /><br /> <xref:System.Threading.Monitor> クラス<br /><br /> <xref:System.Threading.Mutex> クラス<br /><br /> <xref:System.Threading.ReaderWriterLock> クラス<br /><br /> <xref:System.Threading.Semaphore> クラス<br /><br /> <xref:System.Threading.Thread.AllocateNamedDataSlot%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.BeginCriticalRegion%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.EndCriticalRegion%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.FreeNamedDataSlot%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.GetData%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.Join%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.SetApartmentState%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.SetData%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.SpinWait%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.Start%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.Thread.TrySetApartmentState%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.Threading.ThreadPool> クラス<br /><br /> <xref:System.Threading.Timer> クラス|  
+|`System.Timers`|<xref:System.Timers.Timer> クラス|  
+|`System.Web.Configuration`|<xref:System.Web.Configuration.MachineKeyValidationConverter> クラス|  
+|`System.Windows.Forms`|<xref:System.Windows.Forms.AutoCompleteStringCollection.SyncRoot%2A?displayProperty=fullName> プロパティ|  
+  
+## SQL Server アクセス許可セット  
+ SQL Server では、データベースに配置されるコードの信頼性要件をユーザーが指定できます。  アセンブリをデータベースにアップロードする際に、アセンブリの作成者は、そのアセンブリのアクセス許可セットとして、SAFE、EXTERNAL\-ACCESS、UNSAFE の 3 つのうちのいずれかを指定できます。  
+  
+|アクセス許可セット|SAFE|EXTERNAL\-ACCESS|UNSAFE|  
+|---------------|----------|----------------------|------------|  
+|コード アクセス セキュリティ|実行のみ|実行 \+ 外部リソースへのアクセス|制限なし|  
+|プログラミング モデルの制限|Yes|Yes|制限なし|  
+|検証可能性の要求|Yes|Yes|No|  
+|ネイティブ コードの呼び出し|No|No|Yes|  
+  
+ SAFE は、許可されるプログラミング モデルに関連付けられている制限を持つ、最も信頼できる安全なモードです。  SAFE コードは、高い信頼性とセキュリティ機能を備えています。  SAFE アセンブリには、動作、計算の実行、およびローカル データベースへのアクセスに関して十分なアクセス許可が与えられます。  SAFE アセンブリは、検証可能という点でタイプ セーフである必要があり、アンマネージ コードを呼び出すことができません。  
+  
+ EXTERNAL\-ACCESS は中間的なセキュリティ オプションであり、コードに対してデータベース外部のリソースへのアクセスを許可しますが、SAFE と同じ信頼性と安全性を備えています。  
+  
+ UNSAFE は、データベース管理者のみが作成できる信頼性の高いコードを対象にしています。  この信頼されたコードにはコード アクセス制限がなく、アンマネージ \(ネイティブ\) コードを呼び出すことができます。  
+  
+ SQL Server では、ホスト レベルのコード アクセス セキュリティ ポリシー レイヤーを使って、SQL Server カタログに格納されているアクセス許可セットを基に 3 つのアクセス許可セットのいずれかを付与するホスト ポリシーを設定します。  データベース内部で動作するマネージ コードは、常にこれらのコード アクセス許可セットのいずれかを取得します。  
+  
+## プログラミング モデルの制限  
+ SQL Server におけるマネージ コードのプログラミング モデルでは、複数の呼び出しにまたがって保持される状態を使用したり、複数のユーザー セッションにまたがって状態を共有したりする必要がない関数、プロシージャ、および型が必要です。  さらに、前述したように共有状態が存在すると、アプリケーションのスケーラビリティと信頼性に影響する重大な例外が発生する可能性があります。  
+  
+ これらの考慮事項により、SQL Server では、静的変数と静的データ メンバーを使用できません。  SAFE アセンブリや EXTERNAL\-ACCESS アセンブリでは、SQL Server は、CREATE ASSEMBLY の実行時にアセンブリのメタデータを調べ、静的データ メンバーや静的変数の使用が認められた場合には、これらのアセンブリを作成しません。  
+  
+## 参照  
+ <xref:System.Security.Permissions.HostProtectionAttribute>   
+ <xref:System.Security.Permissions.HostProtectionResource>
\ No newline at end of file
diff --git a/docs/framework/performance/stack-etw-event.md b/docs/framework/performance/stack-etw-event.md
new file mode 100644
index 00000000000..21ee53a77e7
--- /dev/null
+++ b/docs/framework/performance/stack-etw-event.md
@@ -0,0 +1,48 @@
+---
+title: "スタック ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, スタック イベント (CLR)"
+  - "スタック イベント [.NET Framework]"
+ms.assetid: f612fa5b-4b62-4593-a19e-85c9b1018dce
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# スタック ETW イベント
+スタック イベントは、イベントの発生後にスタック トレースを生成するために他のイベントと組み合わせて使用します。  このイベントは、ランタイム プロバイダーが有効になっている場合に記録されます。  他のランタイム イベントが発生するたびに発生するため、非常に発生頻度が高く、  使用する際には注意が必要です。  
+  
+ 次の表に、キーワードとレベルを示します。\(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|Level|  
+|---------------------|-----------|  
+|`StackKeyword` \(0x40000000\)|LogAlways\(0\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`CLRStackWalk`|82|他のイベントとの組み合わせによって発生し、イベントの発生後にスタック トレースを生成します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ClrInstanceID|win:Uint16|一意のランタイム識別子。|  
+|Reserved1|win:UInt8|予約済み。|  
+|Reserved2|win:UInt8|予約済み。|  
+|FrameCount|win:UInt32|スタック トレース内のフレーム数。|  
+|Stack|win:Pointer|命令ポインターの列。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/thread-pool-etw-events.md b/docs/framework/performance/thread-pool-etw-events.md
new file mode 100644
index 00000000000..9e43843a102
--- /dev/null
+++ b/docs/framework/performance/thread-pool-etw-events.md
@@ -0,0 +1,226 @@
+---
+title: "スレッド プール ETW イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ETW, スレッド プール イベント (CLR)"
+  - "スレッド プール イベント [.NET Framework]"
+ms.assetid: f2a21e3a-3b6c-4433-97f3-47ff16855ecc
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# スレッド プール ETW イベント
+<a name="top"></a> これらのイベントは、ワーカー スレッドと I\/O スレッドに関する情報を収集します。  
+  
+ スレッド プール イベントには 2 つのグループがあります。  
+  
+-   [ワーカー スレッド プール イベント](#worker)は、アプリケーションがどのようにスレッド プールを使用するかに関する情報と、同時実行制御におけるワークロードの効果に関する情報を提供します。  
+  
+-   [I\/O スレッド プール イベント](#io)は、スレッド プールで作成、無効化、無効化解除、または終了した I\/O スレッドに関する情報を提供します。  
+  
+<a name="worker"></a>   
+## ワーカー スレッド プール イベント  
+ これらのイベントは、ランタイムのワーカー スレッドのプールに関連付けられており、スレッド イベントに関する通知 \(スレッドが作成されたり停止されたりした場合など\) を提供します。 ワーカー スレッド プールは、スレッドの数が計測されたスループットに基づいて計算されるアダプティブ アルゴリズムを使用して、同時実行制御を実行します。 ワーカー スレッド プール イベントを使用すると、アプリケーションで使用されるスレッド プールの様子や特定のワークロードが同時実行制御に与える影響などを理解することができます。  
+  
+### ThreadPoolWorkerThreadStart および ThreadPoolWorkerThreadStop  
+ 次の表に、これらのイベントのキーワードとレベルを示します。 \(詳細については、「[CLR ETW キーワードおよびレベル](../../../docs/framework/performance/clr-etw-keywords-and-levels.md)」を参照してください\)。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+||||  
+|-|-|-|  
+|イベント|イベント ID|いつ発生するか|  
+|`ThreadPoolWorkerThreadStart`|50|ワーカー スレッドが作成された。|  
+|`ThreadPoolWorkerThreadStop`|51|ワーカー スレッドが停止された。|  
+|`ThreadPoolWorkerThreadRetirementStart`|52|ワーカー スレッドが無効にされた。|  
+|`ThreadPoolWorkerThreadRetirementStop`|53|提供終了になったワーカー スレッドが再びアクティブになった。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|ActiveWorkerThreadCount|win:UInt32|作業の処理に使用可能なワーカー スレッド \(既に作業の処理中のもの含む\) の数。|  
+|RetiredWorkerThreadCount|win:UInt32|作業の処理に使用できないものの、後にさらに多くのスレッドが必要になった場合に備えて予約されているワーカー スレッドの数。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### ThreadPoolWorkerThreadAdjustment  
+ これらのスレッド プール イベントは、スレッドの挿入 \(同時実行制御\) アルゴリズムの動作を理解したりデバッグしたりするための情報を提供します。 この情報は、ワーカー スレッド プールによって内部で使用されます。  
+  
+#### ThreadPoolWorkerThreadAdjustmentSample  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`ThreadPoolWorkerThreadAdjustmentSample`|54|1 つのサンプルの情報のコレクションを参照します。つまり、特定の同時実行レベルの特定の時刻におけるスループットの測定値です。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|スループット|win:Double|時間の単位あたりの入力候補の数です。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+#### ThreadPoolWorkerThreadAdjustmentAdjustment  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`ThreadPoolWorkerThreadAdjustmentAdjustment`|55|スレッドの挿入 \(山登り法\) アルゴリズムが、同時実行レベルに変更があったと判断した場合に、コントロールの変更を記録します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|AverageThroughput|win:Double|計測のサンプルの平均のスループット。|  
+|NewWorkerThreadCount|win:UInt32|新しいアクティブなワーカー スレッド数。|  
+|理由|win:UInt32|調整の理由。<br /><br /> 0x00 \- ウォーム アップ。<br /><br /> 0x01 \- 初期化。<br /><br /> 0x02 \- ランダムな移動。<br /><br /> 0x03 \- 上昇移動。<br /><br /> 0x04 \- 変更点。<br /><br /> 0x05 \- 安定化。<br /><br /> 0x06 \- 不足。<br /><br /> 0x07 \- スレッドのタイムアウト。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+#### ThreadPoolWorkerThreadAdjustmentStats  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|説明|  
+|----------|-------------|--------|  
+|`ThreadPoolWorkerThreadAdjustmentStats`|56|スレッド プールに関するデータを収集します。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|期間|win:Double|これらの統計情報が収集される時間数 \(秒\)。|  
+|スループット|win:Double|この間隔中の 1 秒あたりの入力候補の平均数。|  
+|ThreadWave|win:Double|内部使用のために予約されています。|  
+|ThroughputWave|win:Double|内部使用のために予約されています。|  
+|ThroughputErrorEstimate|win:Double|内部使用のために予約されています。|  
+|AverageThroughputErrorEstimate|win:Double|内部使用のために予約されています。|  
+|ThroughputRatio|win:Double|この間隔中にアクティブなワーカー スレッドの数の変動によって引き起こされる、スループットの相対的な向上。|  
+|信頼度|win:Double|ThroughputRatio フィールドの有効性の測定結果。|  
+|NewcontrolSetting|win:Double|アクティブなスレッド数の将来のバリエーションのベースラインとして使用するアクティブなワーカー スレッドの数。|  
+|NewThreadWaveMagnitude|Win:UInt16|アクティブなスレッド数の、将来のバリエーションの大きさを指定します。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="io"></a>   
+## I\/O スレッド イベント  
+ これらのスレッド プール イベントは、I\/O スレッド プール \(完了ポート\) にあるスレッドで発生します。これは非同期です。  
+  
+### IOThreadCreate\_V1  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+||||  
+|-|-|-|  
+|イベント|イベント ID|いつ発生するか|  
+|`IOThreadCreate_V1`|44|I\/O スレッドがスレッド プールに作成された。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt64|新しく作成されたスレッドを含む、I\/O のスレッドの数です。|  
+|NumRetired|win:UInt64|提供終了になったワーカー スレッドの数。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### IOThreadRetire\_V1  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`IOThreadRetire_V1`|46|I\/O スレッドが、提供終了の候補になる。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt64|スレッド プールに残っている I\/O スレッドの数。|  
+|NumRetired|win:UInt64|提供終了になった I\/O スレッドの数。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### IOThreadUnretire\_V1  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`IOThreadUnretire_V1`|47|スレッドが提供終了の候補になってから待機期間内に I\/O が到着したため I\/O スレッドが提供終了解除された。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt64|これを含む、スレッド プール内の I\/O スレッドの数。|  
+|NumRetired|win:UInt64|提供終了になった I\/O スレッドの数。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+### IOThreadTerminate  
+ 次の表に、キーワードとレベルを示します。  
+  
+|イベントを発生させるキーワード|レベル|  
+|---------------------|---------|  
+|`ThreadingKeyword` \(0x10000\)|情報提供 \(4\)|  
+  
+ 次の表に、イベント情報を示します。  
+  
+|イベント|イベント ID|いつ発生するか|  
+|----------|-------------|-------------|  
+|`IOThreadTerminate`|45|I\/O スレッドがスレッド プールに作成された。|  
+  
+ 次の表に、イベント データを示します。  
+  
+|フィールド名|データ型|説明|  
+|------------|----------|--------|  
+|カウント|win:UInt64|スレッド プールに残っている I\/O スレッドの数。|  
+|NumRetired|win:UInt64|提供終了になった I\/O スレッドの数。|  
+|ClrInstanceID|Win:UInt16|CLR または CoreCLR のインスタンスの一意の ID。|  
+  
+## 参照  
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/framework/performance/writing-large-responsive-apps.md b/docs/framework/performance/writing-large-responsive-apps.md
new file mode 100644
index 00000000000..c09014eeb82
--- /dev/null
+++ b/docs/framework/performance/writing-large-responsive-apps.md
@@ -0,0 +1,494 @@
+---
+title: "規模が大きく、応答性の高い .NET Framework アプリの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 123457ac-4223-4273-bb58-3bc0e4957e9d
+caps.latest.revision: 25
+author: "BillWagner"
+ms.author: "wiwagn"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 規模が大きく、応答性の高い .NET Framework アプリの作成
+この記事では、大規模な .NET Framework アプリや、ファイルやデータベースなど大量のデータを処理するアプリのパフォーマンス改善のヒントを説明します。  説明するヒントは C\# および Visual Basic コンパイラを マネージ コードで作成し直した際に得られたものです。この記事では C\# コンパイラでの実際の例をいくつか紹介します。  
+  
+ .NET Framework は、生産性の高いアプリ開発環境です。  強力で安全な言語と豊富なライブラリにより、アプリの開発生産性が高くなります。  ただし、高い生産性には責任が伴います。  .NET Framework のあらゆる機能を使用するするのであれば、必要に応じてコードのパフォーマンスを調整できるようにしておく必要があります。  
+  
+## 新しいコンパイラのパフォーマンスがアプリに適用される理由  
+ .NET コンパイラ プラットフォーム \("Roslyn"\) チームは、コードのモデリングと分析、ツールの開発、そして Visual Studio でのより充実したコード対応エクスペリエンスの実現のための新たな API を提供するため、C\# および Visual Basic コンパイラをマネージ コードで再作成しました。  コンパイラの全体的な書き直しと、新しいコンパイラでの Visual Studio 機能の構築を通して、大規模 .NET Framework アプリや、大量データを処理するアプリに適用できる有用なパフォーマンス情報が明らかになりました。  C\# コンパイラについてのこのような情報や例を活用するために、コンパイラについて理解しておく必要はありません。  
+  
+ Visual Studio ではコンパイラ API を使用して、ユーザーに人気のある IntelliSense 機能 \(識別子とキーワードの色づけ、構文の入力候補一覧、エラーを示す波線、パラメーターのヒント、コードの問題、コードアクションなど\) を作成します。  Visual Studio では、開発者がコードを入力するときや変更するときにこのヘルプが表示されます。コンパイラがコード開発者による編集内容をモデル化している間も、Visual Studio は応答性を維持する必要があります。  
+  
+ エンド ユーザはアプリを操作するときに、アプリが応答するものであると期待します。  入力またはコマンドの処理がブロックされることがあってはなりません。  ヘルプはすぐにポップアップ表示され、またユーザーが入力を続けるときには閉じる必要があります。  処理時間がかかっている UI スレッドがあり、これが原因でアプリの動作が遅くなっていると判断される場合でも、アプリがその UI スレッドをブロックしないようにする必要があります。  
+  
+ 新しいコンパイラの詳細については、[.NET Compiler Platform \("Roslyn"\) オープン ソース プロジェクト](http://roslyn.codeplex.com/) を参照してください。  
+  
+## .NET Framework についての事実  
+ パフォーマンスを調整し、応答性のある .NET Framework アプリを作成する際には、次に説明する事実を考慮してください。  
+  
+### 事実 1: 不完全な最適化は行わない  
+ 必要以上に複雑なコードを記述すると、保守、デバッグ、細かな調整に伴うコストが発生します。  経験豊富なプログラマは、コーディングの問題の解決方法を直観的に把握し、より効率的なコードを記述します。  しかし、コードの最適化が不完全になることがあります。  たとえば、単純な配列で十分な場合にハッシュ テーブルを使用したり、単に値を再計算する代わりに、メモリ リークが発生する恐れのある複雑なキャッシュを使用したりします。  経験豊富なプログラマであっても、パフォーマンスを確認するテストを実施し、問題がある場合にはコードを分析してください。  
+  
+### 事実 2: 測定していないのであれば、それは推測である  
+ プロファイルと測定は嘘をつきません。  プロファイルから、CPU の負荷が上限になっているかどうか、またはディスク I\/O でブロックされているかどうかがわかります。  プロファイルは、割り当てるメモリのサイズと種類、[ガベージ コレクション](../../../docs/standard/garbage-collection/index.md) \(GC\) の処理に CPU が長い時間を取られていないか示します。  
+  
+ アプリでの主要な顧客エクスペリエンスやシナリオについてパフォーマンスの目標を設定し、パフォーマンスを測定するテストを作成してください。  テスト失敗の調査には科学的な手法を使用します。ガイドとなるプロファイルを使用して、どのような問題が発生しているかを仮定し、実験やコード変更によってその仮定を検証します。  定期的にテストを実施して、時間の経過と共にベースライン パフォーマンス測定を確立します。これにより、パフォーマンス後退を引き起こしている変更を切り分けることができます。  パフォーマンス測定を厳密に実施することで、不要なコード更新に時間をかけることを回避できます。  
+  
+### 事実 3: 優れたツールには大きな効果がある  
+ 優れたツールを使用すれば、最も大きなパフォーマンスの問題 \(CPU、メモリ、またはディスク\) の詳細を迅速に確認し、このようなボトルネックを引き起こしているコードを特定できます。  Microsoft は、[Visual Studio Profiler](../Topic/Beginners%20Guide%20to%20Performance%20Profiling.md)、[Windows Phone Analysis Tool](http://msdn.microsoft.com/ja-jp/e67e3199-ea43-4d14-ab7e-f7f19266253f)、[PerfView](http://www.microsoft.com/download/details.aspx?id=28567) など、さまざまなパフォーマンス ツールを提供しています。.  
+  
+ PerfView は、ディスク I\/O、GC イベント、メモリなどの深刻な問題に取り組む際に役立つ極めて強力な無償のツールです。  パフォーマンスに関連する [Windows イベント トレーシング](../../../docs/framework/wcf/samples/etw-tracing.md) \(ETW\) イベントをキャプチャし、アプリ別、プロセス別、スタック別、およびスレッド別に情報を容易に確認できます。  PerfView は、アプリによって割り当てられるメモリの種類と量、そしてメモリの割り当てにどの関数またはコール スタックがどの程度関与しているのかを示します。  詳細については、ツールに付属している詳しいヘルプ トピック、デモ、ビデオ \(Channel 9 の [PerfView チュートリアル](http://channel9.msdn.com/Series/PerfView-Tutorial) など\) を参照してください。  
+  
+### 事実 4: すべては割り当てで決まる  
+ 応答性の高い .NET Framework アプリ開発の要となるのはアルゴリズム \(例: バブル ソートの代わりにクイック ソートを使用\) であると思うかもしれませんが、それは正しくありません。  応答性の高いアプリを開発する上で最も重要なのは、メモリの割り当てです。これは特に、アプリが非常に大規模であり大量データを処理する場合に該当します。  
+  
+ 新しいコンパイラ API の応答性の高い IDE 機能のほとんどの開発作業には、割り当てを回避し、キャッシュ ストラテジを管理することが関連していました。  PerfView トレースから、新しい C\# および Visual Basic コンパイラのパフォーマンスはほとんど CPU とは関連していないことが判明しています。  これらのコンパイラは、数十万行から数百万行のコード行の読み取り、メタデータの読み取り、または生成されたコードの出力の時点では I\/O と関連しています。  UI スレッドの遅延の原因は、ほぼガベージ コレクションにあります。  .NET Framework GC は、パフォーマンスのために高度に調整されており、その処理のほとんどはアプリ コードの実行中に同時に実行されます。  ただし、1 回の割り当てによって負荷の高い [gen2](../../../docs/standard/garbage-collection/fundamentals.md) コレクションが実行され、これによってすべてのスレッドが停止されることがあります。  
+  
+## 一般的な割り当てと例  
+ このセクションの例の式では、小規模な割り当てについては特に問題になりません。  ただし、大きなアプリが式をかなりの回数にわたって実行すると、数百メガバイトまたはギガバイトのメモリが割り当てられることがあります。  たとえば、開発者によるエディターへの入力をシミュレーションする 1 分間のテストを実行したところ、ギガバイト単位のメモリが割り当てられたため、パフォーマンス チームは入力に関するシナリオに重点を置いて取り組みました。  
+  
+### ボックス化とボックス化解除  
+ 通常はスタックまたはデータ構造体内にある値型がオブジェクトでラップされると、[ボックス化](../Topic/Boxing%20and%20Unboxing%20\(C%23%20Programming%20Guide\).md)が発生します。  つまり、データを保持するオブジェクトを割り当て、そのオブジェクトを指すポインタを返します。  .NET Framework では、メソッドのシグネチャや格納場所の種類が原因で、値がボックス化されることがあります。  オブジェクト内で値型がラップされると、メモリ割り当てが行われます。  多くのボックス化操作を実行すると、アプリへメガバイト単位またはギガバイト単位のメモリが割り当てられ、アプリがさらに多くの GC の原因になります。  .NET Framework と言語コンパイラでは可能な限りボックス化を回避しますが、場合によっては、ほとんど予期していない状況でボックス化が行われることがあります。  
+  
+ PerｆView でボックス化を確認するには、トレースを開き、アプリのプロセス名の下の \[GC Heap Alloc Stacks \(GC ヒープ割り当てスタック\)\] を参照します \(PerfView はすべてのプロセスについて報告する点に注意してください\)。  <xref:System.Int32?displayProperty=fullName> や <xref:System.Char?displayProperty=fullName> のような型が割り当ての下に表示される場合は、値型をボックス化しています。  このような型のいずれか 1 つを選択すると、型がボックス化されているスタックと関数が表示されます。  
+  
+ **例 1: string メソッドと値型引数**  
+  
+ このサンプル コードは、過剰であり不要である可能性のあるボックス化を示します。  
+  
+```csharp  
+public class Logger  
+{  
+    public static void WriteLine(string s) { /*...*/ }  
+}  
+  
+public class BoxingExample  
+{  
+    public void Log(int id, int size)  
+    {  
+        var s = string.Format("{0}:{1}", id, size);  
+        Logger.WriteLine(s);  
+    }  
+}  
+  
+```  
+  
+ このコードはログ機能を提供するので、アプリは `Log` 関数を頻繁に \(数百万回\) 呼び出すことがあります。  ここで問題となるのは、`string.Format` の呼び出しが <xref:System.String.Format%28System.String%2CSystem.Object%2CSystem.Object%29> オーバーロードに解決されることです。  
+  
+ このオーバーロードでは、.NET Framework が `int` 値をオブジェクトにボックス化し、このメソッド呼び出しに渡す必要があります。  部分的な修正として、`id.ToString()` と `size.ToString()` を呼び出し、すべての文字列 \(オブジェクト\) を `string.Format` 呼び出しに渡す方法があります。  `ToString()` を呼び出すと文字列が割り当てられますが、この割り当ては `string.Format` 内部で行われます。  
+  
+ この基本的な `string.Format` 呼び出しは単なる文字列の連結であると考え、代わりに次のようなコードを記述することがあります。  
+  
+```csharp  
+var s = id.ToString() + ':' + size.ToString();  
+```  
+  
+ ただしこのコード行は <xref:System.String.Concat%28System.Object%2CSystem.Object%2CSystem.Object%29> にコンパイルされるため、ボックス化割り当てが行われます。  .NET Framework は `Concat` を呼び出すために文字リテラルをボックス化する必要があります。  
+  
+ **例 1 の修正**  
+  
+ 完全な修正策は単純です。  文字リテラルを文字列リテラルに置き換えるだけです。この場合、文字列は既にオブジェクトであるためボックス化は発生しません。  
+  
+```csharp  
+var s = id.ToString() + ":" + size.ToString();  
+  
+```  
+  
+ **例 2: 列挙型のボックス化**  
+  
+ この例では、特にディクショナリ検索操作で列挙型が頻繁に使用されることが原因で、新しい C\# および Visual Basic コンパイラでメモリが大量に割り当てられます。  
+  
+```csharp  
+public enum Color  
+{  
+    Red, Green, Blue  
+}  
+  
+public class BoxingExample  
+{  
+    private string name;  
+    private Color color;  
+    public override int GetHashCode()  
+    {  
+        return name.GetHashCode() ^ color.GetHashCode();  
+    }  
+}  
+  
+```  
+  
+ これは、非常に微妙な問題です。  PerfView ではこれは <xref:System.Enum.GetHashCode> によるボックス化として報告されます。これは、実装上の理由からこのメソッドが列挙型の基になる表現をボックス化するためです。  PerfView で詳しく調べると、<xref:System.Enum.GetHashCode> への呼び出しごとに、ボックス化割り当てが 2 つあることが分かります。  コンパイラと .NET Framework がそれぞれ 1 つずつ挿入します。  
+  
+ **例 2 の修正**  
+  
+ 両方の割り当てを容易に回避できます。このためには、<xref:System.Enum.GetHashCode> を呼び出す前に基となる表現にキャストします。  
+  
+```csharp  
+((int)color).GetHashCode()  
+  
+```  
+  
+ 列挙型に対するボックス化のもう 1 つの一般的な原因は、<xref:System.Enum.HasFlag%28System.Enum%29?displayProperty=fullName> メソッドです。  <xref:System.Enum.HasFlag%28System.Enum%29> に渡す引数をボックス化する必要があります。  ほとんどの場合、<xref:System.Enum.HasFlag%28System.Enum%29?displayProperty=fullName> の呼び出しをビット演算テストに置き換える方法のほうが簡単であり、また割り当てが発生しません。  
+  
+ パフォーマンスに関する 1 番目の事実 \(不完全な最適化は行わない\) に留意し、このような方法でコード全体を作成し直さないでください。  このようなボックス化にかかるコストに注意してください。また、コードの変更は、アプリのプロファイリングとホットスポットの検出の後に行ってください。  
+  
+### 文字列  
+ 文字列操作は、割り当てが発生する最も大きな原因の 1 つであり、PerfView で上位 5 件の割り当てに表示されることがよくあります。  プログラムはシリアル化、JSON、および REST API に文字列を使用します。  列挙型を使用できない場合は、システムとの相互運用のためにプログラム定数として文字列を使用できます。  文字列がパフォーマンスに大きく影響していることがプロファイリングによって明らかになる場合は、<xref:System.String> メソッド \(<xref:System.String.Format%2A>、<xref:System.String.Concat%2A>、<xref:System.String.Split%2A>、<xref:System.String.Join%2A>、<xref:System.String.Substring%2A> など\) の呼び出しを探します。  <xref:System.Text.StringBuilder> を使用すると、複数の要素から 1 つの文字列を作成するコストを回避できます。ただし <xref:System.Text.StringBuilder> オブジェクトの割り当てでさえも、管理する必要があるボトルネックとなることがあります。  
+  
+ **例 3: 文字列操作**  
+  
+ C\# コンパイラには、書式設定された XML Doc コメントのテキストを書き込む次のコードがありました。  
+  
+```csharp  
+public void WriteFormattedDocComment(string text)  
+{  
+    string[] lines = text.Split(new[] { "\r\n", "\r", "\n" },  
+                                StringSplitOptions.None);  
+    int numLines = lines.Length;  
+    bool skipSpace = true;  
+    if (lines[0].TrimStart().StartsWith("///"))  
+    {  
+        for (int i = 0; i < numLines; i++)  
+        {  
+            string trimmed = lines[i].TrimStart();  
+            if (trimmed.Length < 4 || !char.IsWhiteSpace(trimmed[3]))  
+            {  
+                skipSpace = false;  
+                break;  
+            }  
+        }  
+        int substringStart = skipSpace ? 4 : 3;  
+        for (int i = 0; i < numLines; i++)  
+            WriteLine(lines[i].TrimStart().Substring(substringStart));  
+    }  
+    else { /* ... */ }  
+  
+```  
+  
+ このコードによって大量の文字列操作が実行されていることがわかります。  このコードはライブラリ メソッドを使用して、行を個々の文字列に分割し、空白をトリミングし、引数 `text` が XML ドキュメント コメントであるかどうかを確認し、行から部分文字列を抽出します。  
+  
+ `WriteFormattedDocComment` 内部の最初の行では、`text.Split` が呼び出されるたびに、3 つの要素からなる新しい配列が引数として割り当てられます。  コンパイラは、この配列を割り当てるコードを毎回出力する必要があります。  これは、<xref:System.String.Split%2A> による配列の格納先で、この配列が他のコードによって変更される可能性があるかどうかをコンパイラが認識できないためです。変更される場合は、後の `WriteFormattedDocComment` 呼び出しに影響があります。  <xref:System.String.Split%2A> の呼び出しでは、`text` のすべての行に文字列が割り当てられ、操作を実行するために他のメモリが割り当てられます。  
+  
+ `WriteFormattedDocComment` には <xref:System.String.TrimStart%2A> メソッド呼び出しが 3 つあります。  このうちの 2 つは、処理と割り当てが重複する内側のループ内にあります。  さらに悪いことに、引数なしで <xref:System.String.TrimStart%2A> メソッドを呼び出すと、文字列結果の他に空の配列 \(`params` パラメーター\) が割り当てられます。  
+  
+ 最後に、<xref:System.String.Substring%2A> メソッドが呼び出されます。このメソッドは通常、新しい文字列を割り当てます。  
+  
+ **例 3 の修正**  
+  
+ 前述の例と異なり、小規模な編集ではこれらの割り当てを修正できません。  さかのぼって問題を調べ、異なる方法で対処する必要があります。  たとえば、`WriteFormattedDocComment()` の引数が、このメソッドに必要な情報がすべて含まれている文字列の場合、コードでは複数の部分文字列を割り当てる代わりに、その分多くのインデックス作成処理を実行できます。  
+  
+ コンパイラのパフォーマンス チームは、このような割り当てに対処するため次のようなコードを使用しました。  
+  
+```csharp  
+private int IndexOfFirstNonWhiteSpaceChar(string text, int start) {  
+    while (start < text.Length && char.IsWhiteSpace(text[start])) start++;  
+    return start;  
+}  
+  
+private bool TrimmedStringStartsWith(string text, int start, string prefix) {  
+    start = IndexOfFirstNonWhiteSpaceChar(text, start);  
+    int len = text.Length - start;  
+    if (len < prefix.Length) return false;  
+    for (int i = 0; i < len; i++)  
+    {  
+        if (prefix[i] != text[start + i]) return false;  
+    }  
+    return true;  
+}  
+  
+// etc...  
+  
+```  
+  
+ `WriteFormattedDocComment()` の最初のバージョンでは、配列、複数の部分文字列、トリミングされた部分文字列と空の `params` 配列が割り当てられました。  また、`“///”` の有無が確認されました。  修正後のコードは、インデックス作成のみを使用し、割り当てを行いません。  空白以外の最初の文字を検出し、文字を 1 つずつ調べて文字列が `“///”` で始まっているかどうかを確認します。  この新しいコードは `IndexOfFirstNonWhiteSpaceChar` の代わりに <xref:System.String.TrimStart%2A> を使用し、\(指定された開始インデックスより後で\) 空白以外の文字が含まれる最初のインデックスを返します。  この修正は完全ではありませんが、完全な解決策として類似の修正を適用する方法がわかります。  コード全体でこの方法を適用することで、`WriteFormattedDocComment()` 内のすべての割り当てを削除できます。  
+  
+ **例 4: StringBuilder**  
+  
+ この例は <xref:System.Text.StringBuilder> オブジェクトを使用します。  次の関数は、ジェネリック型の完全な型名を生成します。  
+  
+```csharp  
+public class Example  
+{  
+    // Constructs a name like "SomeType<T1, T2, T3>"  
+    public string GenerateFullTypeName(string name, int arity)  
+    {  
+        StringBuilder sb = new StringBuilder();  
+  
+        sb.Append(name);  
+        if (arity != 0)  
+        {  
+            sb.Append("<");  
+            for (int i = 1; i < arity; i++)  
+            {  
+                sb.Append("T"); sb.Append(i.ToString()); sb.Append(", ");  
+            }  
+            sb.Append("T"); sb.Append(i.ToString()); sb.Append(">");  
+        }  
+  
+        return sb.ToString();  
+    }  
+}  
+  
+```  
+  
+ 新しい <xref:System.Text.StringBuilder> インスタンスを作成する行に注目します。  このコードが原因で、`sb.ToString()` の割り当てと <xref:System.Text.StringBuilder> 実装内での内部割り当てが発生しますが、文字列の結果が必要な場合はこれらの割り当てを制御できません。  
+  
+ **例 4 の修正**  
+  
+ `StringBuilder` オブジェクトの割り当てを修正するには、このオブジェクトをキャッシュします。  破棄される可能性がある 1 つのインスタンスをキャッシュするだけでも、パフォーマンスが大幅に改善されることがあります。  これは関数の新しい実装であり、新しい最初の行と最後の行を除くすべてのコードを省略しています。  
+  
+```csharp  
+// Constructs a name like "MyType<T1, T2, T3>"  
+public string GenerateFullTypeName(string name, int arity)  
+{  
+    StringBuilder sb = AcquireBuilder();  
+    /* Use sb as before */  
+    return GetStringAndReleaseBuilder(sb);  
+}  
+  
+```  
+  
+ 重要なのは、新しい `AcquireBuilder()` および `GetStringAndReleaseBuilder()` 関数です。  
+  
+```csharp  
+[ThreadStatic]  
+private static StringBuilder cachedStringBuilder;  
+  
+private static StringBuilder AcquireBuilder()  
+{  
+    StringBuilder result = cachedStringBuilder;  
+    if (result == null)  
+    {  
+        return new StringBuilder();  
+    }  
+    result.Clear();  
+    cachedStringBuilder = null;  
+    return result;  
+}  
+  
+private static string GetStringAndReleaseBuilder(StringBuilder sb)  
+{  
+    string result = sb.ToString();  
+    cachedStringBuilder = sb;  
+    return result;  
+}  
+  
+```  
+  
+ 新しいコンパイラはスレッド処理を使用するため、このような実装は thread\-static フィールド \(<xref:System.ThreadStaticAttribute> 属性\) を使用して <xref:System.Text.StringBuilder> をキャッシュします。このため `ThreadStatic` 宣言を使用せずに済ませることができます。  thread\-static フィールドには、このコードを実行する各スレッドの一意の値が格納されます。  
+  
+ `AcquireBuilder()` は、キャッシュされた <xref:System.Text.StringBuilder> インスタンスがある場合はそのインスタンスを返します。その後、そのインスタンスをクリアしてフィールドまたはキャッシュを Null に設定します。  それ以外の場合は、`AcquireBuilder()` は新規インスタンスを作成して返し、フィールドまたはキャッシュは Null に設定したままにします。  
+  
+ <xref:System.Text.StringBuilder> の処理が完了したら、`GetStringAndReleaseBuilder()` を呼び出して文字列結果を取得し、フィールドまたはキャッシュに <xref:System.Text.StringBuilder> インスタンスを保存し、結果を返します。  実行時にこのコードに再び入り、複数の <xref:System.Text.StringBuilder> オブジェクトが作成される可能性があります \(ただし複数オブジェクトが作成されることはほとんどありません\)。  このコードは最後に解放された <xref:System.Text.StringBuilder> インスタンスだけを、後で使用できるように保存します。  この単純なキャッシュ対策によって、新しいコンパイラでの割り当てが大幅に減少しました。  .NET Framework と MSBuild \([MSBuild1](../Topic/MSBuild1.md)\) の一部では、パフォーマンス改善のために類似の手法が使用されています。  
+  
+ サイズ制限があるため、この単純なキャッシュ対策は適切なキャッシュ設計に準拠しています。  ただし、元のバージョンよりもコードが増えたため、保守コストも増加します。  このキャッシュ対策を取り入れるのは、パフォーマンスの問題を検出し、PerfView で <xref:System.Text.StringBuilder> 割り当てがその問題の大きな原因であることが示されている場合だけにしてください。  
+  
+### LINQ とラムダ  
+ 生産性の高い機能を使用するものの、コードがパフォーマンスに大きく影響する場合に、この機能を全体的に変更する必要があることが判明する例として、統合言語クエリ \( LINQ\) とラムダ式の使用があります。  
+  
+ **例 5: ラムダ、List\<T\>、および IEnumerable\<T\>**  
+  
+ この例では「[LINQ and functional style code \(LINQ と関数スタイルのコード\)](http://blogs.msdn.com/b/charlie/archive/2007/01/26/anders-hejlsberg-on-linq-and-functional-programming.aspx)」を使用して、名前文字列が指定された場合にコンパイラのモデル内でシンボルを検索します。  
+  
+```csharp  
+class Symbol {  
+    public string Name { get; private set; }  
+    /*...*/  
+}  
+  
+class Compiler {  
+    private List<Symbol> symbols;  
+    public Symbol FindMatchingSymbol(string name)  
+    {  
+        return symbols.FirstOrDefault(s => s.Name == name);  
+    }  
+}  
+  
+```  
+  
+ 新しいコンパイラと、このコンパイラ上に構築された IDE 機能は `FindMatchingSymbol()` をかなり頻繁に呼び出します。この関数を記述する 1 行のコードには、割り当てがいくつか隠されています。  このような割り当てを調べるには、まず関数を記述する 1 行のコードを 2 行に分割します。  
+  
+```csharp  
+Func<Symbol, bool> predicate = s => s.Name == name;  
+     return symbols.FirstOrDefault(predicate);  
+  
+```  
+  
+ 最初の行では [ラムダ式](../Topic/Lambda%20Expressions%20\(C%23%20Programming%20Guide\).md) `s => s.Name == name` がローカル変数 を[閉じ込めています](http://blogs.msdn.com/b/ericlippert/archive/2003/09/17/53028.aspx) `name`。  つまり、このコードは[が保持している](../Topic/delegate%20\(C%23%20Reference\).md) `predicate`デリゲート にオブジェクトを割り当てる以外に、`name` の値をキャプチャする環境を保持する静的クラスを割り当てます。  コンパイラは次のようなコードを生成します。  
+  
+```csharp  
+// Compiler-generated class to hold environment state for lambda  
+private class Lambda1Environment  
+{  
+    public string capturedName;  
+    public bool Evaluate(Symbol s)  
+    {  
+        return s.Name == this.capturedName;  
+    }  
+}  
+  
+// Expanded Func<Symbol, bool> predicate = s => s.Name == name;  
+Lambda1Environment l = new Lambda1Environment() { capturedName = name };  
+var predicate = new Func<Symbol, bool>(l.Evaluate);  
+  
+```  
+  
+ ここでは 2 つの `new` 割り当て \(環境クラスに対する割り当てとデリゲートに対する割り当て\) が明示的に行われます。  
+  
+ 次に `FirstOrDefault`. の呼び出しを調べます。  <xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> 型に対するこの拡張メソッドでも割り当てが発生します。  `FirstOrDefault` が <xref:System.Collections.Generic.IEnumerable%601> オブジェクトを最初の引数として受け取るため、この呼び出しを拡張して次のコードのようにできます \(このコードは説明のため単純化されています\)。  
+  
+```csharp  
+// Expanded return symbols.FirstOrDefault(predicate) ...  
+     IEnumerable<Symbol> enumerable = symbols;  
+     IEnumerator<Symbol> enumerator = enumerable.GetEnumerator();  
+     while(enumerator.MoveNext())  
+     {  
+         if (predicate(enumerator.Current))  
+             return enumerator.Current;  
+     }  
+     return default(Symbol);  
+  
+```  
+  
+ `symbols` 変数の型は <xref:System.Collections.Generic.List%601> です。  <xref:System.Collections.Generic.List%601> コレクション型は <xref:System.Collections.Generic.IEnumerable%601> を実装し、<xref:System.Collections.Generic.IEnumerator%601> が <xref:System.Collections.Generic.List%601>を使用して実装する列挙子 \(`struct` インターフェイス\) を適切に定義します。  クラスの代わりに構造体を使用すると、通常ヒープ割り当てが回避されます。ヒープ割り当ては、ガベージ コレクションのパフォーマンスに影響することがあります。  通常、列挙子は言語の `foreach` ループで使用されます。このループは、コール スタックで返される列挙子構造を使用します。  オブジェクトのスペースを確保するためにコール スタック ポインターをインクリメントしても、GC はヒープ割り当てのような影響を受けません。  
+  
+ 拡張 `FirstOrDefault` 呼び出しの場合、このコードは`GetEnumerator()` に対して <xref:System.Collections.Generic.IEnumerable%601> を呼び出す必要があります。  `symbols` を `enumerable` 型の `IEnumerable<Symbol>` 変数に割り当てると、実際のオブジェクトが <xref:System.Collections.Generic.List%601> であるという情報が失われます。.  つまり、コードが `enumerable.GetEnumerator()` で列挙子をフェッチするときには、.NET Framework は返される構造体をボックス化し、`enumerator` 変数に割り当てる必要があります。  
+  
+ **例 5 の修正**  
+  
+ この修正では、`FindMatchingSymbol` を次のように書き直し、1 つのコード行を 6 行のコード行に置き換えます。この 6 行のコードは簡潔であり、読んで理解しやすく、また保守が容易です。  
+  
+```csharp  
+public Symbol FindMatchingSymbol(string name)  
+    {  
+        foreach (Symbol s in symbols)  
+        {  
+            if (s.Name == name)  
+                return s;  
+        }  
+        return null;  
+    }  
+  
+```  
+  
+ このコードは LINQ 拡張メソッド、ラムダ、列挙子を使用しないため、割り当ての問題は発生しません。  `symbols` コレクションが <xref:System.Collections.Generic.List%601> であることをコンパイラが認識でき、結果列挙子 \(構造体\) を適切な型のローカル変数にバインドしてボックス化を回避できるため、割り当てが発生しません。  この関数の元のバージョンは、C\# の高い性能と .NET Framework の生産性を示す最適な例でした。  この新しく効率性が高いバージョンは、保守のために複雑なコードを追加することなく、このような品質を保持します。  
+  
+### 非同期のメソッド キャッシュ  
+ 次の例は、キャッシュされた結果を [非同期](../Topic/Asynchronous%20Programming%20with%20Async%20and%20Await%20\(C%23%20and%20Visual%20Basic\).md)メソッドで使用しようとすると発生する一般的な問題を示します。  
+  
+ **例 6: 非同期メソッドでのキャッシュ**  
+  
+ 新しい C\# および Visual Basic コンパイラ上に構築された Visual Studio IDE 機能は、構文ツリーを頻繁にフェッチします。コンパイラは、Visual Studio の応答性を維持するために非同期を使用します。  構文ツリーを取得する目的で作成するコードの最初のバージョンを次に示します。  
+  
+```csharp  
+class SyntaxTree { /*...*/ }  
+  
+class Parser { /*...*/  
+    public SyntaxTree Syntax { get; }  
+    public Task ParseSourceCode() { /*...*/ }  
+}  
+  
+class Compilation { /*...*/  
+    public async Task<SyntaxTree> GetSyntaxTreeAsync()  
+    {  
+        var parser = new Parser(); // allocation  
+        await parser.ParseSourceCode(); // expensive  
+        return parser.Syntax;  
+    }  
+}  
+  
+```  
+  
+ `GetSyntaxTreeAsync()` を呼び出すと `Parser` がインスタンス化され、コードが解析され、<xref:System.Threading.Tasks.Task> オブジェクトが返されることがわかります。`Task<SyntaxTree>`.  コストがかかる部分は、`Parser` インスタンスの割り当てとコードの解析です。  この関数は <xref:System.Threading.Tasks.Task> を返すので、呼び出し元はユーザー入力に応答するために解析作業を待ち、UI スレッドを解放できます。  
+  
+ Visual Studio の複数の機能が同じ構文ツリーを取得しようとすることがあるため、解析結果をキャッシュする次のコードを記述すると、時間と割り当てを節約できます。  ただしこのコードでは割り当てが発生します。  
+  
+```csharp  
+class Compilation { /*...*/  
+  
+    private SyntaxTree cachedResult;  
+  
+    public async Task<SyntaxTree> GetSyntaxTreeAsync()  
+    {  
+        if (this.cachedResult == null)  
+        {  
+            var parser = new Parser(); // allocation  
+            await parser.ParseSourceCode(); // expensive  
+            this.cachedResult = parser.Syntax;  
+        }  
+        return this.cachedResult;  
+    }  
+}  
+  
+```  
+  
+ キャッシュに関する新しいコードには `SyntaxTree` という名前の `cachedResult` フィールドがあります。  このフィールドが Null の場合、`GetSyntaxTreeAsync()` が処理を行い、キャッシュに結果が保存されます。  `GetSyntaxTreeAsync()` は `SyntaxTree` オブジェクトを返します。  ここで問題となるのは、`async` 型の `Task<SyntaxTree>` 関数があり、`SyntaxTree` 型の値を返す場合、コンパイラが、\(`Task<SyntaxTree>.FromResult()` を使用して\) 結果を保持するために Task を割り当てるコードを出力することです。  Task は完了済みとしてマークされ、結果が即時に利用可能になります。  新しいコンパイラのコードでは、既に完了している <xref:System.Threading.Tasks.Task> オブジェクトが頻繁に発生するため、このような割り当てを修正すると応答性が著しく向上することがよくありました。  
+  
+ **例 6 の修正**  
+  
+ 完了した <xref:System.Threading.Tasks.Task> 割り当てを削除するには、完了した結果とともに Task オブジェクトをキャッシュできます。  
+  
+```csharp  
+class Compilation { /*...*/  
+  
+    private Task<SyntaxTree> cachedResult;  
+  
+    public Task<SyntaxTree> GetSyntaxTreeAsync()  
+    {  
+        return this.cachedResult ??   
+               (this.cachedResult = GetSyntaxTreeUncachedAsync());  
+    }  
+  
+    private async Task<SyntaxTree> GetSyntaxTreeUncachedAsync()  
+    {  
+        var parser = new Parser(); // allocation  
+        await parser.ParseSourceCode(); // expensive  
+        return parser.Syntax;  
+    }  
+}  
+  
+```  
+  
+ このコードは `cachedResult` の型を `Task<SyntaxTree>` に変更し、`async` からの元のコードを保持する `GetSyntaxTreeAsync()` ヘルパー関数を採用しています。  `GetSyntaxTreeAsync()` は [null 合体演算子](../Topic/??%20Operator%20\(C%23%20Reference\).md)を使用して、`cachedResult` が null でない場合にそれを返します。  `cachedResult` が null の場合、`GetSyntaxTreeAsync()` は `GetSyntaxTreeUncachedAsync()` を呼び出し、結果をキャッシュします。  `GetSyntaxTreeAsync()` は、通常のコードのようには、`GetSyntaxTreeUncachedAsync()` 呼び出しを待たないことに注意してください。  待機しないということは、`GetSyntaxTreeUncachedAsync()` がその <xref:System.Threading.Tasks.Task> オブジェクトを返す場合、`GetSyntaxTreeAsync()` が即時に<xref:System.Threading.Tasks.Task> を返すことになります。  この時点で、キャッシュされた結果は <xref:System.Threading.Tasks.Task> であるため、キャシュされた結果を返すための割り当ては行われません。  
+  
+### その他の考慮事項  
+ 大きなアプリまたは大量データを処理するアプリで発生する可能性がある問題に関するその他の点を次に説明します。  
+  
+ **ディクショナリ**  
+  
+ ディクショナリは多くのプログラムで随所に使用されており、非常に便利で本質的に効率的です。  ただし、使い方が不適切なことがよくあります。  Visual Studio と新しいコンパイラでは、分析から、多くのディクショナリでは含まれている要素が 1つだけであるか、何も含まれていないことが判明しました。  x86 マシンでは、空の <xref:System.Collections.Generic.Dictionary%602> には 10 個のフィールドがあり、ヒープで 48 バイトを占有しています。  ディクショナリが役立つのは、一定時間内の検索のマッピングまたは関連データ構造体が必要な場合です。  ただし要素の数が少ない場合は、ディクショナリを使用するとスペースを無駄に使用することになります。  代わりに、たとえば `List<KeyValuePair\<K,V>>` の繰り返し検索も、同じ速度で行えます。  ディクショナリにデータを読み込み、ディクショナリから読み取るだけのためにディクショナリを使用する場合 \(非常に一般的なパターン\)、N\(log\(N\)\) ルックアップで並べ替えた配列を使用すると、使用している要素の数に応じて、ほぼ同程度の速度を得ることができます。  
+  
+ **クラスと  構造体**  
+  
+ クラスと構造体は、アプリを調整する上で従来型のスペース\/時間のトレードオフを生じさせます。  フィールドが含まれていないクラスでは、x86 マシンで 12 バイトのオーバーヘッドが生じますが、クラス インスタンスを指すポインタをだけを受け取るので、クラスの受け渡しにかかるコストは低くなります。  ボックス化されていない構造体の場合、ヒープ割り当ては行われませんが、大きな構造体を関数の引数または戻り値として渡すと、構造体のすべてのデータ メンバーをアトミックにコピーするために、CPU 時間がかかります。  構造体を返すプロパティ呼び出しの繰り返しに注意し、過剰なデータ コピーを行わないようにするため、プロパティの値をローカル変数にキャッシュします。  
+  
+ **キャッシュ**  
+  
+ 一般的なパフォーマンス向上のためのテクニックは、結果をキャッシュすることです。  ただし、サイズ制限や破棄ポリシーが設定されていないキャッシュはメモリ リークとなる可能性があります。  大量のデータを処理するときに、キャッシュに大量のメモリを維持すると、ガベージ コレクションによって、キャッシュしたルックアップによるメリットが無効になります。  
+  
+ この記事では、特に大規模システムや大量のデータを処理するシステムにおいて、アプリの応答性に影響する可能性があるパフォーマンスのボトルネックの症状にどのように注意したらよいかを説明しました。  一般的な問題には、ボックス化、文字列操作、LINQ およびラムダ、非同期方式でのキャッシュ、サイズ制限または破棄ポリシーのないキャッシュ、不適切なディクショナリの使用、構造体の受け渡しなどがあります。  アプリの調整に関する 4 つの事実に注意してください。  
+  
+-   不完全な最適化は行わない \- 生産的に作業し、問題を見つけたらアプリを調整します。  
+  
+-   プロファイルは嘘をつかない \- 測定していないのであれば、推測にすぎません。  
+  
+-   優れたツールには大きな効果がある \- PerfView をダウンロードして試してみてください。  
+  
+-   すべては割り当てで決まる \- コンパイラ プラットフォーム チームは、新しいコンパイラのパフォーマンスの向上のため、この分野に最も多くの時間をかけました。  
+  
+## 参照  
+ [このトピックのプレゼンテーション ビデオ](http://channel9.msdn.com/Events/TechEd/NorthAmerica/2013/DEV-B333)   
+ [パフォーマンス プロファイリングのビギナーズ ガイド](../Topic/Beginners%20Guide%20to%20Performance%20Profiling.md)   
+ [Performance](../../../docs/framework/performance/index.md)   
+ [.NET のパフォーマンスのヒント](http://msdn.microsoft.com/library/ms973839.aspx)   
+ [Windows Phone パフォーマンス 分析 ツール](http://msdn.microsoft.com/magazine/hh781024.aspx)   
+ [Visual Studio プロファイラーでアプリケーションのボトルネックを見つける](http://msdn.microsoft.com/magazine/cc337887.aspx)   
+ [チャネル 9 PerfView チュートリアル](http://channel9.msdn.com/Series/PerfView-Tutorial)   
+ [パフォーマンスのヒントの概要](http://curah.microsoft.com/4604/improving-your-net-apps-startup-performance)   
+ [.NET コンパイラ プラットフォーム \("Roslyn"\) オープン ソース プロジェクト](http://roslyn.codeplex.com/)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/TOC.md b/docs/framework/reflection-and-codedom/TOC.md
new file mode 100644
index 00000000000..c7a9557a561
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/TOC.md
@@ -0,0 +1,24 @@
+# [方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する](how-to-examine-and-instantiate-generic-types-with-reflection.md)
+# [動的プログラミング](index.md)
+# [動的言語ランタイムの概要](dynamic-language-runtime-overview.md)
+# [リフレクションとジェネリック型](reflection-and-generic-types.md)
+# [方法: CodeDOM を使用して XML ドキュメント ファイルを作成する](how-to-create-an-xml-documentation-file-using-codedom.md)
+# [型の動的な読み込みおよび使用](dynamically-loading-and-using-types.md)
+# [完全修飾型名の指定](specifying-fully-qualified-type-names.md)
+# [リフレクション](reflection.md)
+# [動的なソース コードの生成とコンパイル](dynamic-source-code-generation-and-compilation.md)
+# [チュートリアル: 部分信頼シナリオにおけるコード出力](walkthrough-emitting-code-in-partial-trust-scenarios.md)
+# [方法 : リフレクションのみのコンテキストにアセンブリを読み込む](how-to-load-assemblies-into-the-reflection-only-context.md)
+# [方法: リフレクション出力を使用してジェネリック メソッドを定義する](how-to-define-a-generic-method-with-reflection-emit.md)
+# [動的メソッドおよびアセンブリの出力](emitting-dynamic-methods-and-assemblies.md)
+# [型情報の表示](viewing-type-information.md)
+# [CodeDOM グラフからのソース コードの生成およびコンパイル](generating-and-compiling-source-code-from-a-codedom-graph.md)
+# [リフレクションに関するセキュリティ上の考慮事項](security-considerations-for-reflection.md)
+# [カスタム属性へのアクセス](accessing-custom-attributes.md)
+# [リフレクション出力のセキュリティ関連事項](security-issues-in-reflection-emit.md)
+# [Reflection in the .NET Framework for Windows Store Apps](reflection-for-windows-store-apps.md)
+# [方法 : CodeDOM を使用してクラスを作成する](how-to-create-a-class-using-codedom.md)
+# [方法: リフレクション出力を使用してジェネリック型を定義する](how-to-define-a-generic-type-with-reflection-emit.md)
+# [方法: 動的メソッドを定義および実行する](how-to-define-and-execute-dynamic-methods.md)
+# [方法 : リフレクションを使用してデリゲートをフックする](how-to-hook-up-a-delegate-using-reflection.md)
+# [CodeDOM の使用方法](using-the-codedom.md)
diff --git a/docs/framework/reflection-and-codedom/accessing-custom-attributes.md b/docs/framework/reflection-and-codedom/accessing-custom-attributes.md
new file mode 100644
index 00000000000..49a1ec24885
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/accessing-custom-attributes.md
@@ -0,0 +1,80 @@
+---
+title: "カスタム属性へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "属性 [.NET Framework], アクセス"
+  - "カスタム属性, アクセシビリティ"
+  - "リフレクション, カスタム属性"
+ms.assetid: 1d8e3398-00d8-47d5-a084-214f9859d3d7
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# カスタム属性へのアクセス
+プログラムの要素に属性を関連付けた後、リフレクションを使用して、属性の有無と属性値を照会できます。  .NET Framework Version 1.0 および 1.1 では、カスタム属性は実行コンテキストでチェックされます。  一方、.NET Framework Version 2.0 には、"リフレクションのみのコンテキスト" という新しい読み込みのコンテキストが用意されています。これを使用して、実行用に読み込むことができないコードをチェックできます。  
+  
+## リフレクションのみのコンテキスト  
+ リフレクションのみのコンテキストに読み込まれたコードは実行できません。  つまり、カスタム属性のインスタンスを作成できません。カスタム属性のインスタンスを作成するには、そのコンストラクターを実行する必要があります。  リフレクションのみのコンテキストでカスタム属性を読み込んでチェックするには、<xref:System.Reflection.CustomAttributeData> クラスを使用します。  このクラスのインスタンスは、<xref:System.Reflection.CustomAttributeData.GetCustomAttributes%2A?displayProperty=fullName> 静的メソッドの適切なオーバーロードを使用して取得できます。  「[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)」を参照してください。  
+  
+## 実行コンテキスト  
+ 実行コンテキストの属性を照会するための主なリフレクション メソッドには、<xref:System.Reflection.MemberInfo.GetCustomAttributes%2A?displayProperty=fullName> と <xref:System.Attribute.GetCustomAttributes%2A?displayProperty=fullName> があります。  
+  
+ カスタム属性のアクセシビリティの確認は、カスタム属性がアタッチされているアセンブリに対して行われます。  アクセシビリティを確認することは、カスタム属性がアタッチされているアセンブリ内の型に対するメソッドがカスタム属性のコンストラクターを呼び出すことができるかどうかを確認することと同じです。  
+  
+ <xref:System.Reflection.Assembly.GetCustomAttributes%28System.Boolean%29?displayProperty=fullName> のようなメソッドは、型引数の参照可能範囲とアクセシビリティを確認します。  ユーザー定義型を含むアセンブリ内のコードだけが、**GetCustomAttributes** を使用してその型のカスタム属性を取得できます。  
+  
+ 代表的なカスタム属性のデザイン パターンを次の C\# のコード例に示します。  この例は、ランタイム カスタム属性リフレクション モデルを示しています。  
+  
+```  
+System.DLL  
+public class DescriptionAttribute : Attribute  
+{  
+}  
+  
+System.Web.DLL  
+internal class MyDescriptionAttribute : DescriptionAttribute  
+{  
+}  
+  
+public class LocalizationExtenderProvider  
+{  
+    [MyDescriptionAttribute(...)]  
+    public CultureInfo GetLanguage(...)  
+    {  
+    }  
+}  
+```  
+  
+ ランタイムが **GetLanguage** メソッドにアタッチされたパブリック カスタム属性型 <xref:System.ComponentModel.DescriptionAttribute> のカスタム属性の取得を試みる場合は、次のアクションを実行します。  
+  
+1.  ランタイムは、**Type.GetCustomAttributes** \(*type* 型\) への型引数 **DescriptionAttribute** がパブリックで、参照可能およびアクセス可能であることをチェックします。  
+  
+2.  **DescriptionAttribute** から派生したユーザー定義型 **MyDescriptionAttribute** が、**GetLanguage**\(\) メソッドに **DescriptionAttribute** がアタッチされている **System.Web.DLL** アセンブリ内で参照可能であり、アクセス可能であることを確認します。  
+  
+3.  **MyDescriptionAttribute** のコンストラクターが、**System.Web.DLL** アセンブリ内で参照可能であり、アクセス可能であることを確認します。  
+  
+4.  カスタム属性パラメーターを持つ **MyDescriptionAttribute** のコンストラクターを呼び出し、呼び出し元に新しいオブジェクトを返します。  
+  
+ カスタム属性リフレクション モデルが、ユーザー定義型のインスタンスを、その型が定義されているアセンブリの外部にリークする場合があります。  これは、[Type.GetMethods\(\)](frlrfSystemTypeClassGetMethodsTopic) のようなユーザー定義型のインスタンスを返すランタイム システム ライブラリ内のメンバーが、**RuntimeMethodInfo** オブジェクトの配列を返すのと同じです。  クライアントがユーザー定義のカスタム属性型についての情報を探索できないようにするには、その型のメンバーを非パブリックとして定義します。  
+  
+ リフレクションを使用してカスタム属性へのアクセス許可を取得する基本的な方法を次の例で示します。  
+  
+ [!code-cpp[CustomAttributeData#2](../../../samples/snippets/cpp/VS_Snippets_CLR/CustomAttributeData/CPP/source2.cpp#2)]
+ [!code-csharp[CustomAttributeData#2](../../../samples/snippets/csharp/VS_Snippets_CLR/CustomAttributeData/CS/source2.cs#2)]
+ [!code-vb[CustomAttributeData#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CustomAttributeData/VB/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.Reflection.MemberInfo.GetCustomAttributes%2A?displayProperty=fullName>   
+ <xref:System.Attribute.GetCustomAttributes%2A?displayProperty=fullName>   
+ [型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)   
+ [リフレクションに関するセキュリティ上の考慮事項](../../../docs/framework/reflection-and-codedom/security-considerations-for-reflection.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/dynamic-language-runtime-overview.md b/docs/framework/reflection-and-codedom/dynamic-language-runtime-overview.md
new file mode 100644
index 00000000000..0f66513380f
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/dynamic-language-runtime-overview.md
@@ -0,0 +1,104 @@
+---
+title: "動的言語ランタイムの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DLR"
+  - "動的言語ランタイム"
+  - "IronPython"
+  - "IronRuby"
+ms.assetid: f769a271-8aff-4bea-bfab-6160217ce23d
+caps.latest.revision: 26
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# 動的言語ランタイムの概要
+*動的言語ランタイム* \(DLR: Dynamic Language Runtime\) は、動的言語のための一連のサービスを共通言語ランタイム \(CLR: Common Language Runtime\) に追加するランタイム環境です。  DLR により、.NET Framework 上で実行される動的言語の開発や、静的に型指定された言語への動的機能の追加が簡単になります。  
+  
+ 静的に型指定された言語である C\# や Visual Basic \(`Option Explicit On` を使用する場合\) では、オブジェクトの型をデザイン時に指定する必要があるのに対して、動的言語では、オブジェクトの型を実行時に識別できます。  動的言語の例には、Lisp、Smalltalk、JavaScript、PHP、Ruby、Python、ColdFusion、Lua、Cobra、Groovy などがあります。  
+  
+ 開発者にとって、動的言語の多くには次の利点があります。  
+  
+-   高速フィードバック ループ \(REPL、つまり Read\-Evaluate\-Print Loop\) を使用する機能。  この機能により、いくつかのステートメントを入力し、すぐに実行して結果を表示できます。  
+  
+-   トップダウン式の開発と従来のボトムアップ式の開発の両方に対するサポート。  たとえば、トップダウン アプローチを使用する場合は、まだ実装されていない関数を呼び出し、後で必要なときに基になる実装を追加できます。  
+  
+-   リファクタリングとコード変更の容易さ。コード全体で静的な型宣言を変更する必要がありません。  
+  
+ 動的言語は、スクリプト言語として優れています。  動的言語使用して作成されたアプリケーションは、新しいコマンドや機能を追加してユーザーが簡単に拡張できます。  動的言語は、Web サイトやテスト ハーネスの作成、サーバー ファームの管理、さまざまなユーティリティの開発、データ変換の実行にもよく使用されます。  
+  
+ DLR の目的は、動的言語のシステムを .NET Framework 上で実行できるようにし、.NET 相互運用性を提供することです。  DLR は、Visual Studio 2010 の C\# と Visual Basic に動的オブジェクトを導入して、これらの言語での動的な動作をサポートし、動的言語との相互運用を可能にします。  
+  
+ DLR は、動的な操作をサポートするライブラリを作成する場合にも役立ちます。  たとえば、XML オブジェクトまたは JavaScript Object Notation \(JSON\) オブジェクトを使用するライブラリがある場合、DLR を使用する言語では、それらのオブジェクトを動的オブジェクトとして利用できます。  このため、ライブラリ ユーザーは、構文的に簡単でわかりやすいコードを作成して、オブジェクトの操作やオブジェクト メンバーへのアクセスを行うことができます。  
+  
+ たとえば、C\# では、XML のカウンターをインクリメントする場合に次のコードを使用します。  
+  
+ `Scriptobj.SetProperty("Count", ((int)GetProperty("Count")) + 1);`  
+  
+ DLR を使用すると、次のコードを代わりに使用して同じ操作を実行できます。  
+  
+ `scriptobj.Count += 1;`  
+  
+ CLR と同様に、DLR は .NET Framework の一部であり、.NET Framework および Visual Studio のインストール パッケージに付属しています。  オープン ソース バージョンの DLR には、Web サイトのダウンロードすることもできます [CodePlex](http://go.microsoft.com/fwlink/?LinkId=141028)。  
+  
+> [!NOTE]
+>  オープン ソース バージョンの DLR には、Visual Studio および .NET Framework に含まれている DLR の機能がすべて組み込まれています。  また、言語実装者向けの追加サポートも用意されています。  詳細については、サイト内のドキュメントを [CodePlex](http://go.microsoft.com/fwlink/?LinkId=141028) 参照します。  
+  
+ 以下は、DLR を使用して開発された言語の例です。  
+  
+-   IronPython。  Web サイトからのオープン ソース ソフトウェアとして [CodePlex](http://go.microsoft.com/fwlink/?LinkId=141040) 使用できます。  
+  
+-   IronRuby。  Web サイトからのオープン ソース ソフトウェアとして [RubyForge](http://go.microsoft.com/fwlink/?LinkId=141044) 使用できます。  
+  
+## DLR の主な利点  
+ DLR には、次の利点があります。  
+  
+### 動的言語を .NET Framework に簡単に移植できる  
+ DLR により、言語実装者は、構文アナライザー、パーサー、セマンティクス アナライザー、コード ジェネレーター、および従来は自身で作成する必要があったその他のツールを作成せずに済みます。  DLR を使用する言語では、言語レベルのコードをツリー状の構造で表す*式ツリー*、ランタイム ヘルパー ルーチン、およびオプションとして <xref:System.Dynamic.IDynamicMetaObjectProvider> インターフェイスを実装する動的オブジェクトを生成する必要があります。  コード分析タスクやコード生成タスクの多くの部分は、DLR と .NET Framework によって自動化されます。  このため、言語実装者は固有の言語機能に集中できます。  
+  
+### 静的に型指定された言語で動的機能を使用できる  
+ C\# や Visual Basic などの既存の .NET Framework 言語で、動的オブジェクトを作成し、静的に型指定されたオブジェクトと一緒に使用できます。  たとえば、C\# や Visual Basic で、HTML、ドキュメント オブジェクト モデル \(DOM: Document Object Model\)、および .NET リフレクションの動的オブジェクトを使用できます。  
+  
+### DLR と .NET Framework の今後の強化点を活用できる  
+ DLR を使用して実装された言語では、DLR と .NET Framework の今後の強化点を活用できます。  たとえば、ガベージ コレクターの強化やアセンブリの読み込み時間の高速化が盛り込まれた .NET Framework の新しいバージョンがリリースされた場合、DLR を使用して実装された言語は、その恩恵をすぐに受けることができます。  同様に、コンパイルの向上など、DLR の最適化が行われた場合は、DLR を使用して実装されたすべての言語でもパフォーマンスが向上します。  
+  
+### ライブラリとオブジェクトの共有が可能になる  
+ ある言語で実装されたオブジェクトとライブラリを、他の言語で使用できます。  また、DLR では、静的に型指定された言語と動的言語の間の相互運用も可能になります。  たとえば、動的言語で記述されたライブラリを使用する動的オブジェクトを C\# で宣言できます。  同時に、.NET Framework のライブラリを動的言語で使用できます。  
+  
+### 動的なディスパッチと呼び出しを高速に実行できる  
+ DLR では、高度なポリモーフィック キャッシュをサポートすることで、動的操作を高速に実行します。  DLR は、オブジェクトを使用する操作を必要なランタイムの実装にバインドする規則を作成し、それらの規則をキャッシュします。これにより、同じ型のオブジェクトで同じコードが連続的に実行されるときに、リソースを大量に消費するバインド計算が発生するのを防ぎます。  
+  
+## DLR アーキテクチャ  
+ 動的言語ランタイムのアーキテクチャを次の図に示します。  
+  
+ ![動的言語ランタイム アーキテクチャの概要](../../../docs/framework/reflection-and-codedom/media/dlr-archoverview.png "DLR\_ArchOverview")  
+DLR アーキテクチャ  
+  
+ DLR は、動的言語のサポートを強化するために一連のサービスを CLR に追加します。  これらのサービスには、次のようなものが含まれます。  
+  
+-   式ツリー。  DLR では、式ツリーを使用して言語のセマンティクスを表します。  この目的から、DLR では LINQ の式ツリーが拡張され、制御フロー、代入、およびその他の言語モデリング ノードが追加されています。  詳細については、「[式ツリー](../Topic/Expression%20Trees%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+-   呼び出しサイトのキャッシュ。  *動的呼び出しサイト*とは、動的オブジェクトについて `a + b` や `a.b()` などの操作を実行するコード内の場所です。  DLR は、`a` と `b` の特性 \(通常はこれらのオブジェクトの型\) や操作に関する情報をキャッシュします。  同様の操作が以前に実行されていた場合、DLR は、必要なすべての情報をキャッシュから取得して、高速なディスパッチを実現します。  
+  
+-   動的オブジェクトの相互運用性。  DLR には、動的オブジェクトと操作を表し、言語実装者や動的ライブラリの作成者が使用できるクラスとインターフェイスのセットが用意されています。  このようなクラスやインターフェイスとして、<xref:System.Dynamic.IDynamicMetaObjectProvider>、<xref:System.Dynamic.DynamicMetaObject>、<xref:System.Dynamic.DynamicObject>、および <xref:System.Dynamic.ExpandoObject> があります。  
+  
+ DLR では、呼び出しサイトのバインダーを使用して、.NET Framework だけでなく、Silverlight や COM などの他のインフラストラクチャやサービスとも通信します。  バインダーは、言語のセマンティクスをカプセル化し、式ツリーを使用して呼び出しサイトの操作を実行する方法を指定します。  これにより、DLR を使用する動的言語および静的に型指定された言語で、ライブラリを共有し、DLR がサポートするすべてのテクノロジを利用できるようになります。  
+  
+## DLR ドキュメント  
+ "言語に動的な動作を、または方法の詳細については .NET Framework の動的言語を使用できるようにする追加するオープン ソース バージョンの DLR を使用する Web サイトのドキュメントを [CodePlex](http://go.microsoft.com/fwlink/?LinkId=141028) 参照します。  
+  
+## 参照  
+ <xref:System.Dynamic.ExpandoObject>   
+ <xref:System.Dynamic.DynamicObject>   
+ [共通言語ランタイム](../../../docs/standard/clr.md)   
+ [式ツリー](../Topic/Expression%20Trees%20\(C%23%20and%20Visual%20Basic\).md)   
+ [チュートリアル: 動的オブジェクトの作成と使用](../Topic/Walkthrough:%20Creating%20and%20Using%20Dynamic%20Objects%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md b/docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md
new file mode 100644
index 00000000000..ca46a50d6aa
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md
@@ -0,0 +1,60 @@
+---
+title: "動的なソース コードの生成とコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Code Document Object Model"
+  - "CodeDOM"
+  - "言語に依存しないソース コードのモデル化"
+  - "言語, 複数言語のサポート (CodeDOM による)"
+  - "複数言語 (CodeDOM によりサポートされる)"
+  - "ソース コード (複数言語を使用した)"
+  - "System.CodeDom 名前空間"
+ms.assetid: d077a3e8-bd81-4bdf-b6a3-323857ea30fb
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 動的なソース コードの生成とコンパイル
+.NET Framework には、CodeDOM \(Code Document Object Model\) と呼ばれる機構が用意されています。CodeDOM を使用すると、ソース コードを出力するプログラムの開発者は、レンダリング対象となるコードを表す単一のモデルに基づいて、実行時に複数のプログラミング言語でソース コードを生成するプログラムを開発できます。  
+  
+ ソース コードを表現するために、CodeDOM 要素が相互にリンクされ、CodeDOM グラフと呼ばれるデータ構造体が形成されます。このデータ構造体は、ソース コードの構造をモデル化します。  
+  
+ `System.CodeDom` 名前空間は、特定のプログラミング言語に依存せずに、ソース コードの論理構造を表すことができる型を定義します。  `System.CodeDom.Compiler` 名前空間は、CodeDOM グラフからソース コードを生成し、サポートされている言語でソース コードのコンパイルを管理する型を定義します。  コンパイラの販売元および開発者は、サポートされている言語のセットを拡張できます。  
+  
+ 言語に依存しないソース コードのモデル化は、プログラムで複数の言語または不特定の対象言語のプログラム モデルのソース コードを生成する必要がある場合に役立ちます。  たとえば、言語の CodeDOM サポートが利用できる場合は、デザイン時に CodeDOM を言語抽象化インターフェイスとして使用し、適切なプログラミング言語でソース コードを生成できます。  
+  
+ .NET Framework には、[C\#](frlrfMicrosoftCSharpCSharpCodeProviderClassTopic) 用、[JScript](frlrfMicrosoftJScriptJScriptCodeProviderClassTopic) 用、および [Visual Basic](frlrfMicrosoftVisualBasicVBCodeProviderClassTopic) 用のコード ジェネレーターとコード コンパイラが用意されています。  
+  
+## このセクションの内容  
+ [CodeDOM の使用方法](../../../docs/framework/reflection-and-codedom/using-the-codedom.md)  
+ CodeDOM の一般的な使用方法を説明し、CodeDOM を使って簡単なオブジェクト グラフを構築する例を示します。  
+  
+ [CodeDOM グラフからのソース コードの生成およびプログラムのコンパイル](../../../docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md)  
+ ソース コードを生成する方法と、生成されたコードを `System.CodeDom.Compiler` 名前空間で定義されているクラスを使って外部コンパイラでコンパイルする方法について説明します。  
+  
+ [方法: CodeDOM を使用して XML ドキュメント ファイルを作成する](../../../docs/framework/reflection-and-codedom/how-to-create-an-xml-documentation-file-using-codedom.md)  
+ CodeDOM を使用して XML ドキュメントのコメント付きのコードを生成する方法、および生成されたコードをコンパイルして XML ドキュメント出力を作成する方法について説明します。  
+  
+ [方法 : CodeDOM を使用してクラスを作成する](../../../docs/framework/reflection-and-codedom/how-to-create-a-class-using-codedom.md)  
+ CodeDOM を使用してフィールド、プロパティ、メソッド、コンストラクター、およびエントリ ポイントを持つクラスを生成する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.CodeDom>  
+ 共通言語ランタイムを対象とするプログラミング言語のコード要素を表す要素を定義します。  
+  
+ <xref:System.CodeDom.Compiler>  
+ 実行時にコードを生成およびコンパイルするためのインターフェイスを定義します。  
+  
+## 関連項目  
+ [CodeDOM Quick Reference](http://msdn.microsoft.com/ja-jp/c77b8bfd-0a32-4e36-b59a-4f687f32c524)  
+ ソース コードの要素を表す CodeDOM 要素を簡単に検索するための方法が用意されています。
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/dynamically-loading-and-using-types.md b/docs/framework/reflection-and-codedom/dynamically-loading-and-using-types.md
new file mode 100644
index 00000000000..8157b2af1fb
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/dynamically-loading-and-using-types.md
@@ -0,0 +1,107 @@
+---
+title: "型の動的な読み込みおよび使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "動的な読み込みおよび使用 (型の)"
+  - "事前バインディング"
+  - "暗黙の遅延バインディング"
+  - "遅延バインディング, 遅延バインディングの概要"
+  - "リフレクション, 動的な使用 (型の)"
+ms.assetid: db985bec-5942-40ec-b13a-771ae98623dc
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 型の動的な読み込みおよび使用
+リフレクションは、[!INCLUDE[vbprvbext](../../../includes/vbprvbext-md.md)] や JScript などの言語コンパイラで使用されるインフラストラクチャを提供することにより、暗黙の遅延バインディングを実装します。  バインディングとは、一意に指定された型に対応する宣言 \(つまり、実装\) を特定するプロセスのことです。  このプロセスがコンパイル時でなく実行時に発生する場合、遅延バインディングと呼びます。  [!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] では、コード内で暗黙の遅延バインディングを使用できます。Visual Basic コンパイラは、オブジェクトの型を取得するためにリフレクションを使用するヘルパー メソッドを呼び出します。  ヘルパー メソッドに渡された引数によって、実行時に適切なメソッドが呼び出されます。  ヘルパー メソッドに渡される引数は、そのメソッド呼び出しの対象であるインスタンス \(オブジェクト\)、呼び出すメソッドの名前 \(文字列\)、および呼び出すメソッドに渡す引数 \(オブジェクト配列\) です。  
+  
+ Visual Basic コンパイラが暗黙にリフレクションを使用して、コンパイル時に型が不明であるオブジェクトに対してメソッドを呼び出す例を次に示します。  **HelloWorld** クラスは、**PrintHello** メソッドを持っています。**PrintHello** メソッドは、渡されたテキストに "Hello World" という文字を連結して出力します。  この例で呼び出される **PrintHello** メソッドは、実際には、<xref:System.Type.InvokeMember%2A?displayProperty=fullName> です。Visual Basic コードでは、オブジェクト \(helloObj\) の型が、実行時 \(遅延バインディング\) ではなく、コンパイル時 \(事前バインディング\) に既にわかっていた場合と同様に、**PrintHello** メソッドを呼び出すことができます。  
+  
+```  
+Imports System  
+Module Hello  
+    Sub Main()  
+        ' Sets up the variable.  
+        Dim helloObj As Object  
+        ' Creates the object.  
+        helloObj = new HelloWorld()  
+        ' Invokes the print method as if it was early bound  
+        ' even though it is really late bound.  
+        helloObj.PrintHello("Visual Basic Late Bound")  
+    End Sub  
+End Module  
+```  
+  
+## カスタム バインディング  
+ リフレクションは、遅延バインディングのためにコンパイラによって暗黙に使用されるだけでなく、遅延バインディングを行うためにコード内で明示的に使用することもできます。  
+  
+ [共通言語ランタイム](../../../docs/standard/clr.md)は、複数のプログラミング言語をサポートしています。バインディング規則は、言語ごとに異なります。  事前バインディングの場合、バインディングはコード ジェネレーターによって完全に制御できます。  ただし、リフレクションによる遅延バインディングでは、カスタマイズしたバインディングによって制御する必要があります。  <xref:System.Reflection.Binder> クラスは、メンバー選択および呼び出しのカスタム コントロールを提供します。  
+  
+ カスタム バインディングを使用すると、実行時にアセンブリを読み込み、そのアセンブリ内の型についての情報を取得し、必要な型を指定し、その後でメソッドを呼び出したり、その型のフィールドやプロパティにアクセスできます。  この方法は、コンパイル時にオブジェクトの型を特定できない場合、たとえば、オブジェクトの型がユーザーの入力に依存するような場合に便利です。  
+  
+ 引数の型変換のない単純なカスタム バインダーの例を次に示します。  `Simple_Type.dll` のコードを、メインのコードの前に示してあります。  まず `Simple_Type.dll` をビルドし、プロジェクトのビルド時に、その参照を含めます。  
+  
+ [!code-cpp[Conceptual.Types.Dynamic#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.dynamic/cpp/source1.cpp#1)]
+ [!code-csharp[Conceptual.Types.Dynamic#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.dynamic/cs/source1.cs#1)]
+ [!code-vb[Conceptual.Types.Dynamic#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.dynamic/vb/source1.vb#1)]  
+  
+### InvokeMember と CreateInstance  
+ 型のメンバーを呼び出すには、<xref:System.Type.InvokeMember%2A?displayProperty=fullName> を使用します。  さまざまなクラスの **CreateInstance** メソッド \([System.Activator](frlrfSystemActivatorClassCreateInstanceTopic) および [System.Reflection.Assembly](frlrfSystemReflectionAssemblyClassCreateInstanceTopic) など\) は、指定された型の新しいインスタンスを作成する **InvokeMember** の特殊な形態のメソッドです。  **Binder** クラスは、これらのメソッドのオーバーロード解決や引数の強制変換のために使用されます。  
+  
+ 引数の強制変換 \(型変換\) とメンバー選択の可能な 3 つの組み合わせの例を次に示します。  ケース 1 では、引数の強制変換やメンバー選択は不要です。  ケース 2 では、メンバー選択だけが必要です。  ケース 3 では、引数の強制変換だけが必要です。  
+  
+ [!code-cpp[Conceptual.Types.Dynamic#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.dynamic/cpp/source2.cpp#2)]
+ [!code-csharp[Conceptual.Types.Dynamic#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.dynamic/cs/source2.cs#2)]
+ [!code-vb[Conceptual.Types.Dynamic#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.dynamic/vb/source2.vb#2)]  
+  
+ オーバーロード解決は、同じ名前のメンバーを複数使用できる場合に必要です。  <xref:System.Reflection.Binder.BindToMethod%2A?displayProperty=fullName> メソッドおよび <xref:System.Reflection.Binder.BindToField%2A?displayProperty=fullName> メソッドは、単一のメンバーへのバインディングを解決します。  また、**Binder.BindToMethod** は、**get** プロパティ アクセサーおよび **set** プロパティ アクセサーを使用するプロパティ解決も提供します。  
+  
+ **BindToMethod** は、呼び出す <xref:System.Reflection.MethodBase> を返します。このような呼び出しが不可能な場合は、null 参照 \(Visual Basic では **Nothing**\) を返します。  **MethodBase** の戻り値は、*match* パラメーターに含める必要はありませんが、通常は含まれています。  
+  
+ ByRef 引数が存在する場合、呼び出し元はその引数を取得することが必要な場合があります。  ByRef 引数を取得するために、**BindToMethod** が引数配列を操作した場合、クライアントは、**Binder** を使用して、引数配列を元の形態に対応付けることができます。  引数配列を元の形態に対応付けるには、呼び出し元に対して引数の順序が変更されていないことを保証する必要があります。  引数が名前で渡された場合、**Binder** は、引数配列の最順序付けを行います。呼び出し元に返されるのは、並べ替えられた後の引数配列です。  詳細については、「<xref:System.Reflection.Binder.ReorderArgumentArray%2A?displayProperty=fullName>」を参照してください。  
+  
+ 利用可能なメンバーのセットは、その型と任意の基本型に定義されているメンバーです。  [BindingFlags.NonPublic](frlrfSystemReflectionBindingFlagsClassTopic) が指定されている場合は、いずれかのアクセシビリティのメンバーがそのセットに返されます。  **BindingFlags.NonPublic** が指定されていない場合は、バインダーはアクセシビリティ規則を適用する必要があります。  **Public** または **NonPublic** バインディング フラグを指定するときは、**Instance** または **Static** バインディング フラグも指定する必要があります。指定しなかった場合、メンバーは返されません。  
+  
+ 指定された名前のメンバーが 1 つしか存在しない場合は、コールバックは不要です。バインディングは、そのメソッドで実行されます。  コード例のケース 1 は、コールバックが不要な場合を示しています。使用可能な **PrintBob** メソッドが 1 つしか存在しないため、コールバックは不要です。  
+  
+ 利用可能なセットに複数のメンバーが存在する場合は、そのすべてのメソッドが **BindToMethod** に返されます。BindToMethod は適切なメソッドを選択し、それを返します。  コード例のケース 2 では、**PrintValue** という名前のメソッドが 2 つあります。  **BindToMethod** を呼び出すと、適切なメソッドが選択されます。  
+  
+ <xref:System.Reflection.Binder.ChangeType%2A> は、実引数を選択されたメソッドの仮引数の型に変換する引数の強制変換 \(型変換\) を行います。  **ChangeType** は、型が正確に一致した場合でも、すべての引数について呼び出されます。  
+  
+ コード例のケース 3 では、値 "5.5" の **String** 型の実引数が、**Double** 型の仮引数のメソッドに渡されます。  呼び出しを成功させるには、文字列値 "5.5" を倍精度浮動小数点値に変換する必要があります。  この変換は、**ChangeType** によって実行されます。  
+  
+ **ChangeType** は、次の表に示すように、ロスのない型の強制変換、つまり、[拡大変換](../../../docs/standard/base-types/type-conversion.md)だけを行います。  
+  
+|変換元の型|変換先の型|  
+|-----------|-----------|  
+|任意の型|その基本型|  
+|任意の型|実装するインターフェイス|  
+|Char|UInt16、UInt32、Int32、UInt64、Int64、Single、Double|  
+|Byte|Char、UInt16、Int16、UInt32、Int32、UInt64、Int64、Single、Double|  
+|SByte|Int16、Int32、Int64、Single、Double|  
+|UInt16|UInt32、Int32、UInt64、Int64、Single、Double|  
+|Int16|Int32、Int64、Single、Double|  
+|UInt32|UInt64、Int64、Single、Double|  
+|Int32|Int64、Single、Double|  
+|UInt64|Single、Double|  
+|Int64|Single、Double|  
+|Single|Double|  
+|非参照型|参照の種類|  
+  
+ <xref:System.Type> クラスは、参照を特定のメンバーとして解決する **Binder** 型のパラメーターを使用する **Get** メソッドを持っています。  <xref:System.Type.GetConstructor%2A?displayProperty=fullName>、<xref:System.Type.GetMethod%2A?displayProperty=fullName> 、および <xref:System.Type.GetProperty%2A?displayProperty=fullName> は、現在の型の特定のメンバーに関するシグネチャ情報を提供して、そのメンバーを検索します。  該当するメソッドの指定されたシグネチャ情報を選択するために、<xref:System.Reflection.Binder.SelectMethod%2A?displayProperty=fullName> および <xref:System.Reflection.Binder.SelectProperty%2A?displayProperty=fullName> がコールバックされます。  
+  
+## 参照  
+ <xref:System.Type.InvokeMember%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName>   
+ [型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)   
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md b/docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md
new file mode 100644
index 00000000000..7b4bd9e03c7
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md
@@ -0,0 +1,68 @@
+---
+title: "動的メソッドおよびアセンブリの出力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 出力 (動的アセンブリを)"
+  - "動的アセンブリ"
+  - "メタデータ, 出力 (インターフェイスを)"
+  - "リフレクション出力"
+  - "リフレクション出力, 概要"
+ms.assetid: 8e8e2631-62fd-40e7-a8ee-0039b06749bc
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 動的メソッドおよびアセンブリの出力
+ここでは、<xref:System.Reflection.Emit> 名前空間のマネージ型のセットについて説明します。これらのマネージ型を使用すると、コンパイラやツールでメタデータおよび Microsoft Intermediate Language \(MSIL\) を実行時に出力できます。また、ポータブル実行可能 \(PE\) ファイルをディスク上に生成することもできます。  この名前空間を使用する主な機能は、スクリプト エンジンとコンパイラです。  ここでは、リフレクション出力と呼ばれる <xref:System.Reflection.Emit> 名前空間の機能について説明します。  
+  
+ リフレクション出力は、以下の機能を提供します。  
+  
+-   実行時に <xref:System.Reflection.Emit.DynamicMethod> クラスを使用して軽量のグローバル メソッドを定義し、デリゲートを使用してそのメソッドを実行します。  
+  
+-   実行時にアセンブリを定義し、次に、それらを実行するか、ディスクに保存します。  
+  
+-   実行時にアセンブリを定義し、それらを実行した後、それらをアンロードし、ガベージ コレクションがリソースを再利用できるようにします。  
+  
+-   実行時に新しいアセンブリのモジュールを定義し、次に、モジュールを実行するか、ディスクに保存します。  
+  
+-   実行時にモジュール内の型を定義し、その型のインスタンスを作成してメソッドを呼び出します。  
+  
+-   デバッガーまたはコード プロファイラなどのツールで使用できる、定義されたモジュールのシンボリック情報を定義します。  
+  
+ <xref:System.Reflection.Emit> 名前空間のマネージ型に加えて、アンマネージ メタデータ インターフェイスもあります。これについては、[メタデータ インターフェイス](../../../ocs/framework/unmanaged-api/metadata/metadata-interfaces.md)に関するリファレンス ドキュメントを参照してください。  マネージ リフレクション出力は、アンマネージ メタデータ インターフェイスよりも強力なセマンティック エラー チェック機能、より高水準なメタデータの抽象化クラスを提供します。  
+  
+ メタデータと MSIL を使用する際に役立つリソースとしては、他に、共通言語基盤 \(CLI: Common Language Infrastructure\) のドキュメント、特に「Partition II: Metadata Definition and Semantics」と「Partition III: CIL Instruction Set」などもあります。  ドキュメントは、[MSDN](http://go.microsoft.com/fwlink/?LinkID=65555) および [Ecma Web サイト](http://go.microsoft.com/fwlink/?LinkId=116487) からオンラインで入手できます。  
+  
+## このセクションの内容  
+ [リフレクション出力のセキュリティ関連事項](../../../docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md)  
+ リフレクション出力を使用した動的アセンブリの作成時のセキュリティ関連事項について説明します。  
+  
+## 関連項目  
+ <xref:System.Reflection.Emit.OpCodes>  
+ メソッド本体の構築に使用できる MSIL 命令コードのカタログを作成します。  
+  
+ <xref:System.Reflection.Emit>  
+ 動的メソッド、アセンブリ、および型の出力に使用するマネージ クラスが含まれます。  
+  
+ <xref:System.Type>  
+ <xref:System.Type> クラスについて説明します。このクラスは、マネージ リフレクションとリフレクション出力の型を表し、これらのテクノロジを使用するうえで重要なクラスです。  
+  
+ <xref:System.Reflection>  
+ メタデータとマネージ コードの探索に使用するマネージ クラスが含まれます。  
+  
+## 関連項目  
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)  
+ メタデータとマネージ コードの探索方法について説明します。  
+  
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)  
+ .NET Framework のアセンブリの概要を説明します。
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md b/docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md
new file mode 100644
index 00000000000..988a72e3b3a
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md
@@ -0,0 +1,101 @@
+---
+title: "CodeDOM グラフからのソース コードの生成およびコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], CodeDOM"
+  - "コード コンパイラ"
+  - "Code Document Object Model, 生成 (ソース コードの)"
+  - "Code Document Object Model, グラフ"
+  - "コード ジェネレーター"
+  - "CodeDOM, 生成 (ソース コードの)"
+  - "CodeDOM, グラフ"
+  - "コンパイル (アセンブリの)"
+  - "コンパイル (ソース コードを), 複数言語"
+  - "動的コンパイル"
+  - "動的表現 (ソース コードの)"
+  - "生成 (CodeDOM グラフの)"
+  - "生成 (複数言語でのソース コードの)"
+  - "グラフ化 (CodeDOM による)"
+  - "出力 (CodeDOM によるソース コードの)"
+  - "ソース コードの生成"
+  - "ソース コード, 生成"
+  - "テンプレートを使ったコード生成"
+  - "翻訳 (言語から言語への)"
+ms.assetid: 6c864c8e-6dd3-4a65-ace0-36879d9a9c42
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# CodeDOM グラフからのソース コードの生成およびコンパイル
+<xref:System.CodeDom.Compiler> 名前空間には、CodeDOM オブジェクト グラフからソース コードを生成するためのインターフェイスや、サポートされているコンパイラでコンパイルを管理するためのインターフェイスが用意されています。  コード プロバイダーでは、CodeDOM グラフに基づいて、特定のプログラミング言語でソース コードを生成できます。  <xref:System.CodeDom.Compiler.CodeDomProvider> から派生したクラスは、一般にプロバイダーがサポートする言語でコードを生成してコンパイルするためのメソッドを提供します。  
+  
+## CodeDOM コード プロバイダーを使用したソース コードの生成  
+ 特定の言語でソース コードを生成するには、生成するソース コードの構造を表す CodeDOM グラフが必要です。  
+  
+ 次に示すのは、<xref:Microsoft.CSharp.CSharpCodeProvider> のインスタンスを作成する方法のコード例です。  
+  
+ [!code-cpp[CodeDomExample#21](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source3.cpp#21)]
+ [!code-csharp[CodeDomExample#21](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source3.cs#21)]
+ [!code-vb[CodeDomExample#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source3.vb#21)]  
+  
+ コードを生成するためのグラフは、通常、<xref:System.CodeDom.CodeCompileUnit> に格納されます。  CodeDOM グラフを含む **CodeCompileUnit** のコードを生成するには、コード プロバイダーの <xref:System.CodeDom.Compiler.CodeDomProvider.GenerateCodeFromCompileUnit%2A> メソッドを呼び出します。  このメソッドは、ソース コードを生成するために使用する <xref:System.IO.TextWriter> のパラメーターを使用するため、まず、書き込み可能な **TextWriter** を作成することが必要な場合もあります。  **CodeCompileUnit** からコードを生成し、生成したソース コードを HelloWorld.cs という名前のファイルに書き込む例を次に示します。  
+  
+ [!code-cpp[CodeDomExample#22](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source3.cpp#22)]
+ [!code-csharp[CodeDomExample#22](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source3.cs#22)]
+ [!code-vb[CodeDomExample#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source3.vb#22)]  
+  
+## CodeDOM コード プロバイダーを使用したアセンブリのコンパイル  
+ **コンパイルの実行**  
+  
+ CodeDom プロバイダーを使用してアセンブリをコンパイルするには、コンパイラが用意されている言語でコンパイルするソース コードか、コンパイルするソース コードを生成できる CodeDOM グラフのいずれかが必要です。  
+  
+ CodeDOM グラフからコンパイルする場合は、グラフを格納している <xref:System.CodeDom.CodeCompileUnit> をコード プロバイダーの <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromDom%2A> メソッドに渡します。  コンパイラが認識できる言語のソース コード ファイルがある場合は、ソース コードを含むファイルの名前を、コード プロバイダーの <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromFile%2A> メソッドに渡します。  コンパイラが認識できる言語のソース コードを含む文字列を、CodeDom プロバイダーの <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromSource%2A> メソッドに渡すこともできます。  
+  
+ **コンパイル パラメーターの構成**  
+  
+ CodeDom プロバイダーの標準的なコンパイル実行メソッドはすべて、コンパイルに使用するオプションを示す <xref:System.CodeDom.Compiler.CompilerParameters> 型のパラメーターを使用します。  
+  
+ **CompilerParameters** の <xref:System.CodeDom.Compiler.CompilerParameters.OutputAssembly%2A> プロパティで、出力アセンブリのファイル名を指定できます。  このファイル名を指定しない場合は、既定の出力ファイル名が使用されます。  
+  
+ 既定では、新しい **CompilerParameters** は、<xref:System.CodeDom.Compiler.CompilerParameters.GenerateExecutable%2A> プロパティが **false** に設定された状態で初期化されます。  実行可能プログラムをコンパイルする場合は、**GenerateExecutable** プロパティを **true** に設定する必要があります。  **GenerateExecutable** が **false** に設定されている場合、コンパイラはクラス ライブラリを生成します。  
+  
+ CodeDOM グラフから実行可能ファイルをコンパイルする場合は、<xref:System.CodeDom.CodeEntryPointMethod> がグラフで定義されている必要があります。  複数のコード エントリ ポイントがある場合は、**CompilerParameters** の <xref:System.CodeDom.Compiler.CompilerParameters.MainClass%2A> プロパティを、使用するエントリ ポイントを定義するクラスの名前に設定する必要があります。  
+  
+ 生成された実行可能ファイルにデバッグ情報を含めるには、<xref:System.CodeDom.Compiler.CompilerParameters.IncludeDebugInformation%2A> プロパティを **true** に設定します。  
+  
+ プロジェクトがアセンブリを参照する場合は、<xref:System.Collections.Specialized.StringCollection> 内の項目としてのアセンブリ名を、コンパイル時に使用する **CompilerParameters** の <xref:System.CodeDom.Compiler.CompilerParameters.ReferencedAssemblies%2A> プロパティとして指定する必要があります。  
+  
+ <xref:System.CodeDom.Compiler.CompilerParameters.GenerateInMemory%2A> プロパティを **true** に設定することで、ディスクではなくメモリに書き込まれるアセンブリをコンパイルできます。  アセンブリをメモリ上に生成すると、コードでは、生成されたアセンブリへの参照を <xref:System.CodeDom.Compiler.CompilerResults> の <xref:System.CodeDom.Compiler.CompilerResults.CompiledAssembly%2A> プロパティから取得できます。  アセンブリがディスクに書き込まれる場合は、生成されたアセンブリへのパスを、**CompilerResults** の <xref:System.CodeDom.Compiler.CompilerResults.PathToAssembly%2A> プロパティから取得できます。  
+  
+ コンパイル処理を実行するときに使用するカスタム コマンド ライン引数の文字列を指定するには、<xref:System.CodeDom.Compiler.CompilerParameters.CompilerOptions%2A> プロパティに文字列を設定します。  
+  
+ コンパイラ プロセスを起動するために Win32 セキュリティ トークンが必要な場合は、そのトークンを <xref:System.CodeDom.Compiler.CompilerParameters.UserToken%2A> プロパティに指定します。  
+  
+ コンパイルされるアセンブリに Win32 リソース ファイルへのリンクを設定するには、Win32 リソース ファイルの名前を <xref:System.CodeDom.Compiler.CompilerParameters.Win32Resource%2A> プロパティに指定します。  
+  
+ コンパイルを中断する警告レベルを指定するには、<xref:System.CodeDom.Compiler.CompilerParameters.WarningLevel%2A> プロパティに、コンパイルを中断する警告レベルを表す整数を設定します。  <xref:System.CodeDom.Compiler.CompilerParameters.TreatWarningsAsErrors%2A> プロパティを **true** に設定して、警告が発生した場合にコンパイルを中断するようにコンパイラを構成することもできます。  
+  
+ <xref:System.CodeDom.Compiler.CodeDomProvider> クラスから派生する CodeDom プロバイダーを使用してソース ファイルをコンパイルする方法のコード例を次に示します。  
+  
+ [!code-cpp[CodeDomExample#23](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source3.cpp#23)]
+ [!code-csharp[CodeDomExample#23](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source3.cs#23)]
+ [!code-vb[CodeDomExample#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source3.vb#23)]  
+  
+## 既定でサポートされる言語  
+ .NET Framework には、C\#、Visual Basic、C\+\+、および JScript の各言語に対応したコード コンパイラとコード ジェネレーターが用意されています。  CodeDOM に、言語固有のコード ジェネレーターおよびコード コンパイラを実装することで、これら以外の言語もサポートできます。  
+  
+## 参照  
+ <xref:System.CodeDom>   
+ <xref:System.CodeDom.Compiler>   
+ [動的なソース コードの生成とコンパイル](../../../docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md)   
+ [CodeDOM Quick Reference](http://msdn.microsoft.com/ja-jp/c77b8bfd-0a32-4e36-b59a-4f687f32c524)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-create-a-class-using-codedom.md b/docs/framework/reflection-and-codedom/how-to-create-a-class-using-codedom.md
new file mode 100644
index 00000000000..d308a5984ba
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-create-a-class-using-codedom.md
@@ -0,0 +1,125 @@
+---
+title: "方法 : CodeDOM を使用してクラスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Code Document Object Model, 作成 (クラスを)"
+  - "Code Document Object Model, グラフ"
+  - "CodeDOM, 作成 (クラスを)"
+  - "CodeDOM, グラフ"
+  - "グラフ化 (CodeDOM による)"
+ms.assetid: 0ceb70fe-36e1-49bb-922b-e9f615c20a14
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : CodeDOM を使用してクラスを作成する
+次の手順は、2 つのフィールド、3 つのプロパティ、1 つのメソッド、1 つのコンストラクター、および 1 つのエントリ ポイントを持つクラスを生成する CodeDOM グラフの作成方法およびコンパイル方法を示しています。  
+  
+1.  CodeDOM コードを使用してクラス用のソース コードを生成するコンソール アプリケーションを作成します。  
+  
+     この例では、生成クラスに `Sample` という名前が付けられ、生成されたコードは SampleCode という名前のファイルに書き込まれた `CodeDOMCreatedClass` という名前のクラスになります。  
+  
+2.  生成クラスで、CodeDOM グラフを初期化し、生成されたクラスのメンバー、コンストラクター、およびエントリ ポイント \(`Main` メソッド\) を CodeDOM メソッドを使用して定義します。  
+  
+     この例では、生成されたクラスには 2 つのフィールド、3 つのプロパティ、1 つのコンストラクター、1 つのメソッド、および `Main` メソッドがあります。  
+  
+3.  生成クラスで、言語に固有のコード プロバイダーを作成し、その <xref:System.CodeDom.Compiler.CodeDomProvider.GenerateCodeFromCompileUnit%2A> メソッドを呼び出して、グラフからコードを生成します。  
+  
+4.  アプリケーションをコンパイルおよび実行して、コードを生成します。  
+  
+     この例では、生成されたコードは SampleCode という名前のファイルに書き込まれています。  そのコードをコンパイルおよび実行して、サンプル出力を確認します。  
+  
+### CodeDOM コードを実行するアプリケーションを作成するには  
+  
+-   CodeDOM コードを含むコンソール アプリケーション クラスを作成します。  クラスでアセンブリ \(<xref:System.CodeDom.CodeCompileUnit>\) およびクラス \(<xref:System.CodeDom.CodeTypeDeclaration>\) を参照するために使用するグローバル フィールドを定義し、生成されたソース ファイルの名前を指定し、`Main` メソッドを宣言します。  
+  
+     [!code-csharp[CodeDOM Class Sample Main#1](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample Main/CS/program.cs#1)]
+     [!code-vb[CodeDOM Class Sample Main#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample Main/VB/program.vb#1)]  
+  
+### CodeDOM グラフを初期化するには  
+  
+-   コンソール アプリケーション クラス用のコンストラクターで、アセンブリおよびクラスを初期化し、適切な宣言を CodeDOM グラフに追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#2](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#2)]
+     [!code-vb[CodeDOM Class Sample#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#2)]  
+  
+### CodeDOM グラフにメンバーを追加するには  
+  
+-   クラスの <xref:System.CodeDom.CodeTypeDeclaration.Members%2A> プロパティに <xref:System.CodeDom.CodeMemberField> オブジェクトを追加することによって、CodeDOM グラフにフィールドを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#3](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#3)]
+     [!code-vb[CodeDOM Class Sample#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#3)]  
+  
+-   クラスの <xref:System.CodeDom.CodeTypeDeclaration.Members%2A> プロパティに <xref:System.CodeDom.CodeMemberProperty> オブジェクトを追加することによって、CodeDOM グラフにプロパティを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#4](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#4)]
+     [!code-vb[CodeDOM Class Sample#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#4)]  
+  
+-   クラスの <xref:System.CodeDom.CodeTypeDeclaration.Members%2A> プロパティに <xref:System.CodeDom.CodeMemberMethod> オブジェクトを追加することによって、CodeDOM グラフにメソッドを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#5](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#5)]
+     [!code-vb[CodeDOM Class Sample#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#5)]  
+  
+-   クラスの <xref:System.CodeDom.CodeTypeDeclaration.Members%2A> プロパティに <xref:System.CodeDom.CodeConstructor> オブジェクトを追加することによって、CodeDOM グラフにコンストラクターを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#6](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#6)]
+     [!code-vb[CodeDOM Class Sample#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#6)]  
+  
+-   クラスの <xref:System.CodeDom.CodeTypeDeclaration.Members%2A> プロパティに <xref:System.CodeDom.CodeEntryPointMethod> オブジェクトを追加することによって、CodeDOM グラフにエントリ ポイントを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#7](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#7)]
+     [!code-vb[CodeDOM Class Sample#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#7)]  
+  
+### CodeDOM グラフからコードを生成するには  
+  
+-   <xref:System.CodeDom.Compiler.CodeDomProvider.GenerateCodeFromCompileUnit%2A> メソッドを呼び出すことによって、CodeDOM グラフからソース コードを生成します。  
+  
+     [!code-csharp[CodeDOM Class Sample#8](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#8)]
+     [!code-vb[CodeDOM Class Sample#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#8)]  
+  
+### グラフを作成し、コードを生成するには  
+  
+1.  最初の手順で定義した `Main` メソッドに、前の手順で作成したメソッドを追加します。  
+  
+     [!code-csharp[CodeDOM Class Sample#9](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#9)]
+     [!code-vb[CodeDOM Class Sample#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#9)]  
+  
+2.  生成クラスをコンパイルおよび実行します。  
+  
+## 使用例  
+ 前の手順のコードを、次のコード例に示します。  
+  
+ [!code-csharp[CodeDOM Class Sample#1](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/program.cs#1)]
+ [!code-vb[CodeDOM Class Sample#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/program.vb#1)]  
+  
+ 前の例をコンパイルおよび実行すると、次のソース コードが生成されます。  
+  
+ [!code-csharp[CodeDOM Class Sample#99](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDOM Class Sample/CS/SampleCode.cs#99)]
+ [!code-vb[CodeDOM Class Sample#99](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDOM Class Sample/VB/SampleCode.vb#99)]  
+  
+ 生成されたソース コードをコンパイルおよび実行すると、次の出力が生成されます。  
+  
+```  
+The object:  
+ width = 5.3,  
+ height = 6.9,  
+ area = 36.57  
+```  
+  
+## コードのコンパイル  
+  
+-   このコード例を正常に実行するには、`FullTrust` アクセス許可セットが必要です。  
+  
+## 参照  
+ [CodeDOM の使用方法](../../../docs/framework/reflection-and-codedom/using-the-codedom.md)   
+ [CodeDOM グラフからのソース コードの生成およびコンパイル](../../../docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-create-an-xml-documentation-file-using-codedom.md b/docs/framework/reflection-and-codedom/how-to-create-an-xml-documentation-file-using-codedom.md
new file mode 100644
index 00000000000..405b0ea453a
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-create-an-xml-documentation-file-using-codedom.md
@@ -0,0 +1,87 @@
+---
+title: "方法: CodeDOM を使用して XML ドキュメント ファイルを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Code Document Object Model, 生成 (XML ドキュメントを)"
+  - "CodeDOM, 生成 (XML ドキュメントを)"
+  - "XML ドキュメント, 作成 (CodeDOM を使用して)"
+ms.assetid: e3b80484-36b9-41dd-9d21-a2f9a36381dc
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: CodeDOM を使用して XML ドキュメント ファイルを作成する
+CodeDOM を使用して、XML ドキュメントを生成するコードを作成できます。  このプロセスには、XML ドキュメント コメントを含む CodeDOM グラフの作成、コードの生成、および生成されたコードのコンパイル \(XML ドキュメント出力を作成するコンパイラ オプションを使用\) が含まれます。  
+  
+### XML ドキュメント コメントを含む CodeDOM グラフを作成するには  
+  
+1.  サンプル アプリケーション用の CodeDOM グラフを含む <xref:System.CodeDom.CodeCompileUnit> を作成します。  
+  
+2.  `docComment` パラメーターを `true` に設定して <xref:System.CodeDom.CodeCommentStatement.%23ctor%2A> コンストラクターを使用し、XML ドキュメント コメントの要素およびテキストを作成します。  
+  
+     [!code-csharp[CodeDomHelloWorldSample#4](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs#4)]
+     [!code-vb[CodeDomHelloWorldSample#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb#4)]  
+  
+### CodeCompileUnit からコードを生成するには  
+  
+1.  <xref:System.CodeDom.Compiler.CodeDomProvider.GenerateCodeFromCompileUnit%2A> メソッドを使用してコードを生成し、コンパイルするソース ファイルを作成します。  
+  
+     [!code-csharp[CodeDomHelloWorldSample#5](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs#5)]
+     [!code-vb[CodeDomHelloWorldSample#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb#5)]  
+  
+### コードをコンパイルし、ドキュメント ファイルを生成するには  
+  
+1.  <xref:System.CodeDom.Compiler.CompilerParameters> オブジェクトの <xref:System.CodeDom.Compiler.CompilerParameters.CompilerOptions%2A> プロパティに **\/doc** コンパイラ オプションを追加し、そのオブジェクトを <xref:System.CodeDom.Compiler.CodeDomProvider.CompileAssemblyFromFile%2A> メソッドに渡して、コードがコンパイルされるときに XML ドキュメント ファイルを作成します。  
+  
+     [!code-csharp[CodeDomHelloWorldSample#6](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs#6)]
+     [!code-vb[CodeDomHelloWorldSample#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb#6)]  
+  
+## 使用例  
+ 次のコード例では、ドキュメント コメントのある CodeDOM グラフを作成し、そのグラフからコード ファイルを生成し、そのファイルをコンパイルし、関連付けられた XML ドキュメント ファイルを作成します。  
+  
+ [!code-csharp[CodeDomHelloWorldSample#1](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomHelloWorldSample/cs/program.cs#1)]
+ [!code-vb[CodeDomHelloWorldSample#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomHelloWorldSample/vb/program.vb#1)]  
+  
+ このコード例では、HelloWorldDoc.xml ファイルとして次の XML ドキュメントを作成します。  
+  
+```  
+<?xml version="1.0" ?>   
+<doc>  
+  <assembly>  
+    <name>HelloWorld</name>   
+  </assembly>  
+  <members>  
+    <member name="T:Samples.Class1">  
+      <summary>  
+        Create a Hello World application.   
+        <seealso cref="M:Samples.Class1.Main" />   
+      </summary>  
+    </member>  
+    <member name="M:Samples.Class1.Main">  
+      <summary>  
+        Main method for HelloWorld application.   
+        <para>Add a new paragraph to the description.</para>   
+      </summary>  
+    </member>  
+  </members>  
+</doc>  
+```  
+  
+## コードのコンパイル  
+  
+-   このコード例を正常に実行するには、`FullTrust` アクセス許可セットが必要です。  
+  
+## 参照  
+ [Documenting Your Code with XML](../Topic/Documenting%20Your%20Code%20with%20XML%20\(Visual%20Basic\).md)   
+ [XML ドキュメント コメント](../Topic/XML%20Documentation%20Comments%20\(C%23%20Programming%20Guide\).md)   
+ [XML に関するドキュメント](../Topic/XML%20Documentation%20\(Visual%20C++\).md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-define-a-generic-method-with-reflection-emit.md b/docs/framework/reflection-and-codedom/how-to-define-a-generic-method-with-reflection-emit.md
new file mode 100644
index 00000000000..12e0bd5f017
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-define-a-generic-method-with-reflection-emit.md
@@ -0,0 +1,177 @@
+---
+title: "方法: リフレクション出力を使用してジェネリック メソッドを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック [.NET Framework], 動的な型"
+  - "ジェネリック [.NET Framework], リフレクション出力"
+  - "リフレクション出力, ジェネリック メソッド"
+ms.assetid: 93892fa4-90b3-4ec4-b147-4bec9880de2b
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法: リフレクション出力を使用してジェネリック メソッドを定義する
+最初の手順では、2 つの型パラメーターを持つ単純なジェネリック メソッドを作成する方法と、クラスの制約、インターフェイスの制約、および特殊な制約を型パラメーターに適用する方法を示します。  
+  
+ 2 番目の手順では、メソッド本体を出力する方法と、ジェネリック メソッドの型パラメーターを使用して、ジェネリック型のインスタンスを作成し、それらのメソッドを呼び出す方法を示します。  
+  
+ 3 番目の手順では、ジェネリック メソッドを呼び出す方法を示します。  
+  
+> [!IMPORTANT]
+>  メソッドはジェネリック型に属し、その型の型パラメーターを使用するだけであるため、ジェネリックではありません。  メソッドがジェネリックになるのは、そのメソッドが独自の型パラメーター リストを持つ場合だけです。  この例のように、ジェネリック メソッドは非ジェネリック型で表すことができます。  ジェネリック型の非ジェネリック メソッドの例については、「[方法: リフレクション出力を使用してジェネリック型を定義する](../../../docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md)」を参照してください。  
+  
+### ジェネリック メソッドを定義するには  
+  
+1.  作業を始める前に、高水準言語を使用して記述したときに、ジェネリック メソッドがどのように表されるかを確認しておくと役立ちます。  次のコードは、ジェネリック メソッドを呼び出すコードと共に、このトピックのプログラム例に含まれています。  このメソッドは、`TInput` と `TOutput` の 2 つの型パラメーターを持ちます。2 つ目の型パラメーターは、参照型 \(`class`\) であることが必要です。さらに、パラメーターなしのコンストラクター \(`new`\) を持ち、`ICollection(Of TInput)` \(C\# では `ICollection<TInput>`\) を実装する必要があります。  このインターフェイスの制約によって、<xref:System.Collections.Generic.ICollection%601.Add%2A?displayProperty=fullName> メソッドを使用して、メソッドによって作成される `TOutput` コレクションに要素を確実に追加できるようになります。  メソッドは、`TInput` の配列である仮パラメーター `input` を 1 つ持ちます。  メソッドは、`TOutput` 型のコレクションを作成し、`input` の要素をコレクションにコピーします。  
+  
+     [!code-csharp[GenericMethodHowTo#20](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#20)]
+     [!code-vb[GenericMethodHowTo#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#20)]  
+  
+2.  動的アセンブリと動的モジュールを定義して、ジェネリック メソッドが属する型を格納します。  この場合、アセンブリには `DemoMethodBuilder1` という名前のモジュールが 1 つだけ含まれます。モジュール名はアセンブリ名に拡張子が付いたものです。  この例では、アセンブリをディスクに保存したうえで実行するため、<xref:System.Reflection.Emit.AssemblyBuilderAccess?displayProperty=fullName> を指定します。  [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用すると、DemoMethodBuilder1.dll をチェックし、手順 1. に示すメソッドの Microsoft Intermediate Language \(MSIL\) と比較できます。  
+  
+     [!code-csharp[GenericMethodHowTo#2](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#2)]
+     [!code-vb[GenericMethodHowTo#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#2)]  
+  
+3.  ジェネリック メソッドが属する型を定義します。  型はジェネリックである必要はありません。  ジェネリック メソッドは、ジェネリック型と非ジェネリック型のどちらにでも属することができます。  この例では、型はクラスであり、ジェネリックではありません。型の名前は `DemoType` です。  
+  
+     [!code-csharp[GenericMethodHowTo#3](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#3)]
+     [!code-vb[GenericMethodHowTo#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#3)]  
+  
+4.  ジェネリック メソッドを定義します。  ジェネリック メソッドの仮パラメーターの型が、ジェネリック メソッドのジェネリック型パラメーターで指定されている場合は、<xref:System.Reflection.Emit.TypeBuilder.DefineMethod%28System.String%2CSystem.Reflection.MethodAttributes%29> メソッド オーバーロードを使用してメソッドを定義します。  メソッドのジェネリック型パラメーターはまだ定義されていないため、<xref:System.Reflection.Emit.TypeBuilder.DefineMethod%2A> の呼び出しでメソッドの仮パラメーターの型を指定することはできません。  この例では、メソッドの名前は `Factory` です。  メソッドは、パブリックかつ `static` \(Visual Basic では `Shared`\) です。  
+  
+     [!code-csharp[GenericMethodHowTo#4](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#4)]
+     [!code-vb[GenericMethodHowTo#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#4)]  
+  
+5.  パラメーターの名前を格納している文字列の配列を <xref:System.Reflection.Emit.MethodBuilder.DefineGenericParameters%2A?displayProperty=fullName> メソッドに渡して、`DemoMethod` のジェネリック型パラメーターを定義します。  これにより、メソッドはジェネリック メソッドになります。  次のコードによって、`Factory` を型パラメーター `TInput` と `TOutput` を持つジェネリック メソッドにします。  コードを読みやすくするために、これらの名前の変数を作成し、2 つの型パラメーターを表す <xref:System.Reflection.Emit.GenericTypeParameterBuilder> オブジェクトを保持します。  
+  
+     [!code-csharp[GenericMethodHowTo#5](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#5)]
+     [!code-vb[GenericMethodHowTo#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#5)]  
+  
+6.  オプションで、型パラメーターに特殊な制約を追加します。  特殊な制約は、<xref:System.Reflection.Emit.GenericTypeParameterBuilder.SetGenericParameterAttributes%2A> メソッドを使用して追加します。  この例では、`TOutput` は参照型であり、パラメーターなしのコンストラクターを持つように制約されます。  
+  
+     [!code-csharp[GenericMethodHowTo#6](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#6)]
+     [!code-vb[GenericMethodHowTo#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#6)]  
+  
+7.  オプションで、型パラメーターにクラスの制約とインターフェイスの制約を追加します。  この例では、型パラメーター `TOutput` は、`ICollection(Of TInput)` \(C\# では `ICollection<TInput>`\) インターフェイスを実装する型に制約されます。  これにより、<xref:System.Collections.Generic.ICollection%601.Add%2A> メソッドを使用して要素を確実に追加できます。  
+  
+     [!code-csharp[GenericMethodHowTo#7](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#7)]
+     [!code-vb[GenericMethodHowTo#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#7)]  
+  
+8.  <xref:System.Reflection.Emit.MethodBuilder.SetParameters%2A> メソッドを使用して、メソッドの仮パラメーターを定義します。  この例では、`Factory` メソッドは、`TInput` の配列であるパラメーターを 1 つ持ちます。  この型は、`TInput` を表す <xref:System.Reflection.Emit.GenericTypeParameterBuilder> で <xref:System.Type.MakeArrayType%2A> メソッドを呼び出すことによって作成されます。  <xref:System.Reflection.Emit.MethodBuilder.SetParameters%2A> の引数は、<xref:System.Type> オブジェクトの配列です。  
+  
+     [!code-csharp[GenericMethodHowTo#8](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#8)]
+     [!code-vb[GenericMethodHowTo#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#8)]  
+  
+9. <xref:System.Reflection.Emit.MethodBuilder.SetReturnType%2A> メソッドを使用して、メソッドの戻り値の型を定義します。  この例では、`TOutput` のインスタンスが返されます。  
+  
+     [!code-csharp[GenericMethodHowTo#9](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#9)]
+     [!code-vb[GenericMethodHowTo#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#9)]  
+  
+10. <xref:System.Reflection.Emit.ILGenerator> を使用して、メソッド本体を出力します。  詳細については、メソッド本体を出力する際の手順を参照してください。  
+  
+    > [!IMPORTANT]
+    >  ジェネリック型のメソッド呼び出しを出力し、それらの型の型引数がジェネリック メソッドの型パラメーターである場合、<xref:System.Reflection.Emit.TypeBuilder> クラスの `static` <xref:System.Reflection.Emit.TypeBuilder.GetConstructor%28System.Type%2CSystem.Reflection.ConstructorInfo%29>、<xref:System.Reflection.Emit.TypeBuilder.GetMethod%28System.Type%2CSystem.Reflection.MethodInfo%29>、<xref:System.Reflection.Emit.TypeBuilder.GetField%28System.Type%2CSystem.Reflection.FieldInfo%29> の各メソッド オーバーロードを使用して、メソッドの構築された形式を取得します。  メソッド本体を出力する手順にこの例が示されています。  
+  
+11. メソッドを格納する型を完成させ、アセンブリを保存します。  ジェネリック メソッドを呼び出すための手順には、完成したメソッドを呼び出す 2 とおりの方法が示されています。  
+  
+     [!code-csharp[GenericMethodHowTo#14](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#14)]
+     [!code-vb[GenericMethodHowTo#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#14)]  
+  
+<a name="procedureSection1"></a>   
+### メソッド本体を出力するには  
+  
+1.  コード ジェネレーターを取得し、ローカル変数とラベルを宣言します。  ローカル変数を宣言するには、<xref:System.Reflection.Emit.ILGenerator.DeclareLocal%2A> メソッドを使用します。  `Factory` メソッドには、4 つのローカル変数があります。メソッドによって返される新しい `TOutput` を保持する `retVal`、 `ICollection(Of TInput)` \(C\# では `ICollection<TInput>`\) にキャストされた `TOutput` を保持する `ic`、`TInput` オブジェクトの入力配列を保持する `input`、および配列を反復処理するための `index` です。  また、ラベルも 2 つあります。ループに入るためのラベル \(`enterLoop`\) およびループの先頭に使用するラベル \(`loopAgain`\) であり、<xref:System.Reflection.Emit.ILGenerator.DefineLabel%2A> メソッドを使用して定義されます。  
+  
+     メソッドは、まず、<xref:System.Reflection.Emit.OpCodes.Ldarg_0> オペコードを使用して引数を読み込み、<xref:System.Reflection.Emit.OpCodes.Stloc_S> オペコードを使用してローカル変数 `input` に格納します。  
+  
+     [!code-csharp[GenericMethodHowTo#10](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#10)]
+     [!code-vb[GenericMethodHowTo#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#10)]  
+  
+2.  <xref:System.Activator.CreateInstance%2A?displayProperty=fullName> メソッドのジェネリック メソッド オーバーロードを使用して、`TOutput` のインスタンスを作成するコードを出力します。  このオーバーロードを使用する場合、指定した型はパラメーターなしのコンストラクターを持つ必要があります。`TOutput` にこの制約を追加したのはこのためです。  `TOutput` を <xref:System.Reflection.MethodInfo.MakeGenericMethod%2A> に渡して、構築されたジェネリック メソッドを作成します。  メソッドを呼び出すコードを出力したら、<xref:System.Reflection.Emit.OpCodes.Stloc_S> を使用してローカル変数 `retVal` に格納するコードを出力します。  
+  
+     [!code-csharp[GenericMethodHowTo#11](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#11)]
+     [!code-vb[GenericMethodHowTo#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#11)]  
+  
+3.  新しい `TOutput` オブジェクトを `ICollection(Of TInput)` にキャストし、ローカル変数 `ic` に格納するコードを出力します。  
+  
+     [!code-csharp[GenericMethodHowTo#31](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#31)]
+     [!code-vb[GenericMethodHowTo#31](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#31)]  
+  
+4.  <xref:System.Collections.Generic.ICollection%601.Add%2A?displayProperty=fullName> メソッドを表す <xref:System.Reflection.MethodInfo> を取得します。  このメソッドは、`ICollection(Of TInput)` \(C\# では `ICollection<TInput>`\) で動作するため、この構築された型に固有の `Add` メソッドを取得する必要があります。  <xref:System.Type.GetMethod%2A> は、<xref:System.Reflection.Emit.GenericTypeParameterBuilder> で構築された型ではサポートされていないため、<xref:System.Type.GetMethod%2A> メソッドを使用して、`icollOfTInput` からこの <xref:System.Reflection.MethodInfo> を直接取得することはできません。  代わりに、<xref:System.Collections.Generic.ICollection%601> ジェネリック インターフェイスのジェネリック型の定義を格納する `icoll` で、<xref:System.Type.GetMethod%2A> を呼び出します。  次に、<xref:System.Reflection.Emit.TypeBuilder.GetMethod%28System.Type%2CSystem.Reflection.MethodInfo%29> `static` メソッドを使用して、構築された型の <xref:System.Reflection.MethodInfo> を作成します。  次のコードでこれを示します。  
+  
+     [!code-csharp[GenericMethodHowTo#12](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#12)]
+     [!code-vb[GenericMethodHowTo#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#12)]  
+  
+5.  32 ビット整数 0 を読み込み、変数に格納することにより、変数 `index` を初期化するコードを出力します。  `enterLoop` ラベルに分岐するコードを出力します。  このラベルはループ内部にあるため、まだマークされていません。  ループのコードは、次の手順で出力されます。  
+  
+     [!code-csharp[GenericMethodHowTo#32](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#32)]
+     [!code-vb[GenericMethodHowTo#32](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#32)]  
+  
+6.  ループのコードを出力します。  まず、`loopAgain` ラベルを使用して <xref:System.Reflection.Emit.ILGenerator.MarkLabel%2A> を呼び出し、ループの先頭をマークします。  これで、このラベルを使用する分岐ステートメントは、コードのこのポイントに分岐するようになります。  次の手順では、`ICollection(Of TInput)` にキャストされた `TOutput` オブジェクトをスタックにプッシュします。  このオブジェクトはすぐに必要なわけではありませんが、`Add` メソッドを呼び出すための適切な位置にあることが必要です。  次に、入力配列がスタックにプッシュされ、現在のインデックスを格納する変数 `index` が配列にプッシュされます。  <xref:System.Reflection.Emit.OpCodes.Ldelem> オペコードによってインデックスと配列がスタックからポップされ、インデックスが付けられた配列要素がスタックにプッシュされます。  これで、スタックは <xref:System.Collections.Generic.ICollection%601.Add%2A?displayProperty=fullName> メソッドの呼び出しに対応できるようになりました。このメソッドは、スタックからコレクションと新しい要素をポップし、その要素をコレクションに追加します。  
+  
+     ループのコードの残りの部分では、インデックスをインクリメントし、ループが終了したかどうかを確認するテストを行います。インデックスと 32 ビット整数 1 がスタックにプッシュされて加算され、その合計がスタックに残されます。合計は `index` に格納されます。  <xref:System.Reflection.Emit.ILGenerator.MarkLabel%2A> を呼び出して、このポイントをループのエントリ ポイントとして設定します。  インデックスが再び読み込まれます。  入力配列がスタックにプッシュされ、その長さを取得するために <xref:System.Reflection.Emit.OpCodes.Ldlen> が出力されます。  現在、インデックスと長さはスタックにあります。<xref:System.Reflection.Emit.OpCodes.Clt> を出力してこれらを比較します。  インデックスが長さ未満の場合、<xref:System.Reflection.Emit.OpCodes.Brtrue_S> はループの先頭に分岐して戻ります。  
+  
+     [!code-csharp[GenericMethodHowTo#13](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#13)]
+     [!code-vb[GenericMethodHowTo#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#13)]  
+  
+7.  `TOutput` オブジェクトをスタックにプッシュし、メソッドから返すコードを出力します。  ローカル変数 `retVal` と `ic` には、新しい `TOutput` への参照が格納されます。`ic` は、<xref:System.Collections.Generic.ICollection%601.Add%2A?displayProperty=fullName> メソッドにアクセスする目的でのみ使用されます。  
+  
+     [!code-csharp[GenericMethodHowTo#33](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#33)]
+     [!code-vb[GenericMethodHowTo#33](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#33)]  
+  
+<a name="procedureSection2"></a>   
+### ジェネリック メソッドを呼び出すには  
+  
+1.  `Factory` は、ジェネリック メソッドの定義です。  これを呼び出すには、ジェネリック型パラメーターに型を割り当てる必要があります。  これを行うには、<xref:System.Reflection.MethodInfo.MakeGenericMethod%2A> メソッドを使用します。  次のコードでは、`TInput` に <xref:System.String>、`TOutput` に `List(Of String)` \(C\# では `List<string>`\) を指定して、構築されたジェネリック メソッドを作成し、メソッドの文字列形式を表示します。  
+  
+     [!code-csharp[GenericMethodHowTo#21](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#21)]
+     [!code-vb[GenericMethodHowTo#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#21)]  
+  
+2.  遅延バインディングによってメソッドを呼び出すには、<xref:System.Reflection.MethodBase.Invoke%2A> メソッドを使用します。  次のコードでは、唯一の要素として文字列の配列を格納する <xref:System.Object> の配列を作成し、ジェネリック メソッドの引数リストとして渡します。  このメソッドは `static` であるため、<xref:System.Reflection.MethodBase.Invoke%2A> の 1 つ目のパラメーターは null 参照です。  戻り値は `List(Of String)` にキャストされ、最初の要素が表示されます。  
+  
+     [!code-csharp[GenericMethodHowTo#22](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#22)]
+     [!code-vb[GenericMethodHowTo#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#22)]  
+  
+3.  デリゲートを使用してメソッドを呼び出すには、構築されたジェネリック メソッドのシグネチャと一致するデリゲートを用意する必要があります。  汎用デリゲートを作成すると、これを簡単に行うことができます。  次のコードでは、<xref:System.Delegate.CreateDelegate%28System.Type%2CSystem.Reflection.MethodInfo%29?displayProperty=fullName> メソッド オーバーロードを使用して、プログラム例で定義した `D` 汎用デリゲートのインスタンスを作成し、デリゲートを呼び出します。  デリゲートは、遅延バインディングによる呼び出しよりもパフォーマンスが優れています。  
+  
+     [!code-csharp[GenericMethodHowTo#23](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#23)]
+     [!code-vb[GenericMethodHowTo#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#23)]  
+  
+4.  出力されたメソッドは、保存されたアセンブリを参照するプログラムから呼び出すこともできます。  
+  
+## 使用例  
+ ジェネリック メソッド `Factory` と共に、非ジェネリック型 `DemoType` を作成するコード例を次に示します。  このメソッドは、入力の種類を指定する `TInput` と、出力の種類を指定する `TOutput` の 2 つのジェネリック型パラメーターを持ちます。  型パラメーター `TOutput` は、`ICollection<TInput>` \(Visual Basic では `ICollection(Of TInput)`\) を実装し、参照型であり、パラメーターなしのコンストラクターを持つように制約されています。  
+  
+ メソッドは、`TInput` の配列である仮パラメーターを 1 つ持ちます。  メソッドは、入力配列のすべての要素を格納する `TOutput` のインスタンスを返します。  `TOutput` は <xref:System.Collections.Generic.ICollection%601> ジェネリック インターフェイスを実装するジェネリック コレクション型に指定できます。  
+  
+ コードを実行すると、動的アセンブリが DemoGenericMethod1.dll という名前で保存され、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用してチェックできます。  
+  
+> [!NOTE]
+>  コードを出力する方法を習得するためのよい方法は、出力しようとしているタスクを実行するプログラムを Visual Basic、C\#、または Visual C\+\+ で記述し、逆アセンブラーを使用して、コンパイラによって生成された MSIL をチェックすることです。  
+  
+ このコード例には、出力されたメソッドに相当するソース コードが含まれています。  出力されたメソッドは、遅延バインディングによって呼び出されます。また、このコード例で宣言された汎用デリゲートを使用することによっても呼び出されます。  
+  
+ [!code-csharp[GenericMethodHowTo#1](../../../samples/snippets/csharp/VS_Snippets_CLR/GenericMethodHowTo/CS/source.cs#1)]
+ [!code-vb[GenericMethodHowTo#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GenericMethodHowTo/VB/source.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコードには、コンパイルに必要な C\# の `using` ステートメント \(Visual Basic では `Imports`\) が含まれています。  
+  
+-   追加のアセンブリ参照は不要です。  
+  
+-   コマンド ラインで csc.exe、vbc.exe、または cl.exe を使用して、コードをコンパイルします。  Visual Studio でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Reflection.Emit.MethodBuilder>   
+ [方法: リフレクション出力を使用してジェネリック型を定義する](../../../docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md b/docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md
new file mode 100644
index 00000000000..9e5818be895
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md
@@ -0,0 +1,142 @@
+---
+title: "方法: リフレクション出力を使用してジェネリック型を定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック [.NET Framework], 動的な型"
+  - "ジェネリック [.NET Framework], リフレクション出力"
+  - "リフレクション出力, ジェネリック型"
+ms.assetid: 07d5f01a-7b5b-40ea-9b15-f21561098fe4
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法: リフレクション出力を使用してジェネリック型を定義する
+このトピックでは、2 つの型パラメーターを持つ単純なジェネリック型を作成する方法、クラスの制約、インターフェイスの制約、および特殊な制約を型パラメーターに適用する方法、クラスの型パラメーターをパラメーターの型および戻り値の型として使用するメンバーを作成する方法について説明します。  
+  
+> [!IMPORTANT]
+>  メソッドはジェネリック型に属し、その型の型パラメーターを使用するだけであるため、ジェネリックではありません。  メソッドがジェネリックになるのは、そのメソッドが独自の型パラメーター リストを持つ場合だけです。  この例のように、ジェネリック型のほとんどのメソッドはジェネリックではありません。  ジェネリック メソッドの出力の例については、「[方法: リフレクション出力を使用してジェネリック メソッドを定義する](../../../docs/framework/reflection-and-codedom/how-to-define-a-generic-method-with-reflection-emit.md)」を参照してください。  
+  
+### ジェネリック型を定義するには  
+  
+1.  `GenericEmitExample1` という名前の動的アセンブリを定義します。  この例では、アセンブリを実行し、ディスクに保存するため、<xref:System.Reflection.Emit.AssemblyBuilderAccess?displayProperty=fullName> を指定します。  
+  
+     [!code-cpp[EmitGenericType#2](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#2)]
+     [!code-csharp[EmitGenericType#2](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#2)]
+     [!code-vb[EmitGenericType#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#2)]  
+  
+2.  動的モジュールを定義します。  アセンブリは、実行可能モジュールで構成されます。  単一モジュールのアセンブリの場合、モジュール名はアセンブリ名と同じであり、ファイル名はモジュール名に拡張子が付いたものです。  
+  
+     [!code-cpp[EmitGenericType#3](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#3)]
+     [!code-csharp[EmitGenericType#3](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#3)]
+     [!code-vb[EmitGenericType#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#3)]  
+  
+3.  クラスを定義します。  この例では、クラスの名前は `Sample` です。  
+  
+     [!code-cpp[EmitGenericType#4](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#4)]
+     [!code-csharp[EmitGenericType#4](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#4)]
+     [!code-vb[EmitGenericType#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#4)]  
+  
+4.  パラメーターの名前を格納している文字列の配列を <xref:System.Reflection.Emit.TypeBuilder.DefineGenericParameters%2A?displayProperty=fullName> メソッドに渡して、`Sample` のジェネリック型パラメーターを定義します。  これにより、クラスはジェネリック型になります。  戻り値は、型パラメーターを表す <xref:System.Reflection.Emit.GenericTypeParameterBuilder> オブジェクトの配列で、出力されたコードで使用できます。  
+  
+     次のコードでは、`Sample` は型パラメーター `TFirst` と `TSecond` を持つジェネリック型になります。  コードを読みやすくするために、各 <xref:System.Reflection.Emit.GenericTypeParameterBuilder> を型パラメーターと同じ名前の変数に配置します。  
+  
+     [!code-cpp[EmitGenericType#5](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#5)]
+     [!code-csharp[EmitGenericType#5](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#5)]
+     [!code-vb[EmitGenericType#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#5)]  
+  
+5.  型パラメーターに特殊な制約を追加します。  この例では、型パラメーター `TFirst` は、パラメーターなしのコンストラクターを持つ型で、参照型に制約されています。  
+  
+     [!code-cpp[EmitGenericType#6](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#6)]
+     [!code-csharp[EmitGenericType#6](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#6)]
+     [!code-vb[EmitGenericType#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#6)]  
+  
+6.  オプションで、型パラメーターにクラスの制約とインターフェイスの制約を追加します。  この例では、型パラメーター `TFirst` は、変数 `baseType` に格納された <xref:System.Type> オブジェクトによって表される基本クラスから派生し、型が変数 `interfaceA` と `interfaceB` に格納されたインターフェイスを実装する型に制約されています。  これらの変数の宣言および割り当てについては、コード例を参照してください。  
+  
+     [!code-cpp[EmitGenericType#7](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#7)]
+     [!code-csharp[EmitGenericType#7](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#7)]
+     [!code-vb[EmitGenericType#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#7)]  
+  
+7.  フィールドを定義します。  この例では、フィールドの型は型パラメーター `TFirst` で指定されます。  <xref:System.Reflection.Emit.GenericTypeParameterBuilder> は <xref:System.Type> から派生するため、型を使用できる場合はいつでもジェネリック型パラメーターを使用できます。  
+  
+     [!code-cpp[EmitGenericType#21](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#21)]
+     [!code-csharp[EmitGenericType#21](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#21)]
+     [!code-vb[EmitGenericType#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#21)]  
+  
+8.  ジェネリック型の型パラメーターを使用するメソッドを定義します。  このようなメソッドが独自の型パラメーター リストを持たない限り、メソッドはジェネリックではありません。  次のコードでは、`TFirst` の配列を受け取り、その配列のすべての要素を格納する `List<TFirst>` \(Visual Basic では `List(Of TFirst)`\) を返す `static` メソッド \(Visual Basic では `Shared`\) を定義します。  このメソッドを定義するには、ジェネリック型の定義 `List<T>` で <xref:System.Type.MakeGenericType%2A> を呼び出して、`List<TFirst>` 型を作成する必要があります \(`typeof` 演算子 \(Visual Basic では `GetType`\) を使用してジェネリック型の定義を取得する場合、`T` は省略されます\)。パラメーターの型は、<xref:System.Type.MakeArrayType%2A> メソッドを使用して作成されます。  
+  
+     [!code-cpp[EmitGenericType#22](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#22)]
+     [!code-csharp[EmitGenericType#22](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#22)]
+     [!code-vb[EmitGenericType#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#22)]  
+  
+9. メソッド本体を出力します。  メソッド本体は、入力配列をスタックに読み込む 3 つのオペコードで構成され、`IEnumerable<TFirst>` \(入力要素をリストに配置するすべての処理を実行\) を受け取る `List<TFirst>` コンストラクターを呼び出し、返されます \(新しい <xref:System.Collections.Generic.List%601> オブジェクトをスタックに残します\)。  このコードの出力の困難な部分は、コンストラクターの取得です。  
+  
+     <xref:System.Type.GetConstructor%2A> メソッドは <xref:System.Reflection.Emit.GenericTypeParameterBuilder> でサポートされていないため、`List<TFirst>` のコンストラクターを直接取得することはできません。  まず、ジェネリック型の定義 `List<T>` のコンストラクターを取得し、次に、このコンストラクターを `List<TFirst>` の対応するコンストラクターに変換するメソッドを呼び出す必要があります。  
+  
+     このコード例で使用するコンストラクターは、`IEnumerable<T>` を受け取ります。  ただし、これは <xref:System.Collections.Generic.IEnumerable%601> ジェネリック インターフェイスのジェネリック型の定義ではない点に注意してください。代わりに、`List<T>` の型パラメーター `T` を、`IEnumerable<T>` の型パラメーター `T` と置き換える必要があります \(両方の型が `T` という名前の型パラメーターを持つというだけで、わかりづらいように思われます。  このコード例で、`TFirst` と `TSecond` という名前を使用しているのはそのためです\)。コンストラクターの引数の型を取得するには、ジェネリック型の定義 `IEnumerable<T>` から開始し、`List<T>` の 1 つ目のジェネリック型パラメーターで <xref:System.Type.MakeGenericType%2A> を呼び出します。  コンストラクターの引数リストは、配列 \(この場合は引数を 1 つだけ持つ配列\) として渡す必要があります。  
+  
+    > [!NOTE]
+    >  ジェネリック型の定義は、C\# の `typeof` 演算子を使用する場合は `IEnumerable<>` として表し、Visual Basic の `GetType` 演算子を使用する場合は `IEnumerable(Of )` として表します。  
+  
+     これで、ジェネリック型の定義で <xref:System.Type.GetConstructor%2A> を呼び出して、`List<T>` のコンストラクターを取得できるようになりました。  このコンストラクターを `List<TFirst>` の対応するコンストラクターに変換するには、`List<TFirst>` および `List<T>` のコンストラクターを静的 <xref:System.Reflection.Emit.TypeBuilder.GetConstructor%28System.Type%2CSystem.Reflection.ConstructorInfo%29?displayProperty=fullName> メソッドに渡します。  
+  
+     [!code-cpp[EmitGenericType#23](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#23)]
+     [!code-csharp[EmitGenericType#23](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#23)]
+     [!code-vb[EmitGenericType#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#23)]  
+  
+10. 型を作成し、ファイルを保存します。  
+  
+     [!code-cpp[EmitGenericType#8](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#8)]
+     [!code-csharp[EmitGenericType#8](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#8)]
+     [!code-vb[EmitGenericType#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#8)]  
+  
+11. メソッドを呼び出します。  `ExampleMethod` はジェネリックではありませんが、属する型はジェネリックです。したがって、呼び出すことのできる <xref:System.Reflection.MethodInfo> を取得するためには、`Sample` の型定義から構築された型を作成する必要があります。  構築された型は、`Example` クラスを使用します。このクラスは参照型であり、既定のパラメーターなしのコンストラクターと、`TSecond` の制約を満たす `ExampleDerived` クラスを持つため、`TFirst` の制約を満たしています \(`ExampleDerived` のコードは、プログラム例のセクションにあります\)。この 2 つの型は、<xref:System.Type.MakeGenericType%2A> に渡されて、構築された型を作成します。  次に、<xref:System.Type.GetMethod%2A> メソッドを使用して <xref:System.Reflection.MethodInfo> が取得されます。  
+  
+     [!code-cpp[EmitGenericType#9](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#9)]
+     [!code-csharp[EmitGenericType#9](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#9)]
+     [!code-vb[EmitGenericType#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#9)]  
+  
+12. 次のコードでは、`Example` オブジェクトの配列を作成し、この配列を呼び出されるメソッドの引数を表す <xref:System.Object> 型の配列に配置し、[Invoke\(Object, Object\<xref:System.Reflection.MethodBase.Invoke%28System.Object%2CSystem.Object%5B%5D%29> メソッドに渡します。  <xref:System.Reflection.MethodBase.Invoke%2A> メソッドは `static` であるため、このメソッドの最初の引数は null 参照です。  
+  
+     [!code-cpp[EmitGenericType#10](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#10)]
+     [!code-csharp[EmitGenericType#10](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#10)]
+     [!code-vb[EmitGenericType#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#10)]  
+  
+## 使用例  
+ 基本クラスと 2 つのインターフェイスと共に、`Sample` という名前のクラスを定義するコード例を次に示します。  このプログラムは、`Sample` の 2 つのジェネリック型パラメーターを定義し、これをジェネリック型にします。  型をジェネリックにするのは、型パラメーターだけです。  このプログラムでは、型パラメーターの定義の前後にテスト メッセージを表示することによってこれを示します。  
+  
+ 型パラメーター `TSecond` を使用して、基本クラスとインターフェイスを使用するためのクラスの制約とインターフェイスの制約を示し、型パラメーター `TFirst` を使用して特殊な制約を示します。  
+  
+ このコード例では、フィールドの種類およびメソッドのパラメーターの型と戻り値の型にクラスの型パラメーターを使用して、フィールドとメソッドを定義します。  
+  
+ `Sample` クラスが作成されると、メソッドが呼び出されます。  
+  
+ プログラムには、ジェネリック型の情報を示すメソッドと、型パラメーターの特殊な制約を示すメソッドが含まれています。  これらのメソッドを使用して、完成した `Sample` クラスの情報を表示します。  
+  
+ このプログラムでは、完了したモジュールを `GenericEmitExample1.dll` という名前でディスクに保存します。したがって、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) でこれを開き、`Sample` クラスの MSIL をチェックできます。  
+  
+ [!code-cpp[EmitGenericType#1](../../../samples/snippets/cpp/VS_Snippets_CLR/EmitGenericType/CPP/source.cpp#1)]
+ [!code-csharp[EmitGenericType#1](../../../samples/snippets/csharp/VS_Snippets_CLR/EmitGenericType/CS/source.cs#1)]
+ [!code-vb[EmitGenericType#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/EmitGenericType/VB/source.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコードには、コンパイルに必要な C\# の `using` ステートメント \(Visual Basic では `Imports`\) が含まれています。  
+  
+-   追加のアセンブリ参照は不要です。  
+  
+-   コマンド ラインで csc.exe、vbc.exe、または cl.exe を使用して、コードをコンパイルします。  Visual Studio でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Reflection.Emit.GenericTypeParameterBuilder>   
+ [Using Reflection Emit](http://msdn.microsoft.com/ja-jp/ccc6540d-0e2c-4d89-b456-eb7353f9e9ac)   
+ [Reflection Emit Dynamic Assembly Scenarios](http://msdn.microsoft.com/ja-jp/e1cc6750-e20f-473b-bb4e-f43bc66aecce)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-define-and-execute-dynamic-methods.md b/docs/framework/reflection-and-codedom/how-to-define-and-execute-dynamic-methods.md
new file mode 100644
index 00000000000..8426b1dc169
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-define-and-execute-dynamic-methods.md
@@ -0,0 +1,129 @@
+---
+title: "方法: 動的メソッドを定義および実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "動的メソッド"
+  - "リフレクション出力, 動的メソッド"
+ms.assetid: 07d08a99-62c5-4254-bce2-2a75e55a18ab
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法: 動的メソッドを定義および実行する
+単純な動的メソッドとクラスのインスタンスにバインドされた動的メソッドを定義し、実行する手順を次に示します。  動的メソッドの詳細については、<xref:System.Reflection.Emit.DynamicMethod> クラスに関するトピックおよび「[Reflection Emit Dynamic Method Scenarios](http://msdn.microsoft.com/ja-jp/7c27ea3d-0f24-4bf3-8ceb-f49d33faca5e)」を参照してください。  
+  
+### 動的メソッドを定義および実行するには  
+  
+1.  メソッドを実行するために、デリゲート型を宣言します。  汎用デリゲートを使用して、宣言する必要のあるデリゲート型の数を最小限に抑えるよう考慮してください。  次のコードでは、`SquareIt` メソッドで使用できる 2 つのデリゲート型 \(1 つはジェネリック\) を宣言します。  
+  
+     [!code-cpp[DynamicMethodHowTo#2](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#2)]
+     [!code-csharp[DynamicMethodHowTo#2](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#2)]
+     [!code-vb[DynamicMethodHowTo#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#2)]  
+  
+2.  動的メソッドのパラメーターの型を指定する配列を作成します。  この例では、唯一のパラメーターが `int` \(Visual Basic では `Integer`\) であるため、配列には要素は 1 つしかありません。  
+  
+     [!code-cpp[DynamicMethodHowTo#3](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#3)]
+     [!code-csharp[DynamicMethodHowTo#3](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#3)]
+     [!code-vb[DynamicMethodHowTo#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#3)]  
+  
+3.  <xref:System.Reflection.Emit.DynamicMethod> を作成します。  この例では、メソッドの名前は `SquareIt` です。  
+  
+    > [!NOTE]
+    >  動的メソッドに名前を付ける必要はありません。動的メソッドは名前で呼び出すことはできません。  複数の動的メソッドに同じ名前を付けることができます。  ただし、名前は呼び出し履歴に表示されるため、デバッグの際に役立つ場合があります。  
+  
+     戻り値の型は、`long` として指定します。  プログラム例を格納する `Example` クラスを含むモジュールにメソッドを関連付けます。  読み込むモジュールを指定できます。  動的メソッドは、モジュール レベルの `static` メソッド \(Visual Basic `Shared`\) と同様に機能します。  
+  
+     [!code-cpp[DynamicMethodHowTo#4](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#4)]
+     [!code-csharp[DynamicMethodHowTo#4](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#4)]
+     [!code-vb[DynamicMethodHowTo#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#4)]  
+  
+4.  メソッド本体を出力します。  この例では、<xref:System.Reflection.Emit.ILGenerator> オブジェクトを使用して、MSIL \(Microsoft Intermediate Language\) を出力します。  また、<xref:System.Reflection.Emit.DynamicILInfo> オブジェクトをアンマネージ コード ジェネレーターと組み合わせて使用して、<xref:System.Reflection.Emit.DynamicMethod> のメソッド本体を出力することもできます。  
+  
+     この例の MSIL は、`int` である引数をスタックに読み込み、これを `long` に変換します。次に、`long` を複製し、2 つの数値を乗算します。  これにより、スタックには 2 乗された結果が残され、メソッドで実行する必要のあるすべてが返されます。  
+  
+     [!code-cpp[DynamicMethodHowTo#5](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#5)]
+     [!code-csharp[DynamicMethodHowTo#5](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#5)]
+     [!code-vb[DynamicMethodHowTo#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#5)]  
+  
+5.  <xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%2A> メソッドを呼び出して、動的メソッドを表す \(手順 1 で宣言した\) デリゲートのインスタンスを作成します。  デリゲートを作成すると、メソッドは完了します。メソッドにそれ以上変更を加えようとしても \(MSIL の追加など\) 無視されます。  次のコードでは、汎用デリゲートを使用して、デリゲートを作成し呼び出します。  
+  
+     [!code-cpp[DynamicMethodHowTo#6](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#6)]
+     [!code-csharp[DynamicMethodHowTo#6](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#6)]
+     [!code-vb[DynamicMethodHowTo#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#6)]  
+  
+### オブジェクトにバインドされた動的メソッドを定義および実行するには  
+  
+1.  メソッドを実行するために、デリゲート型を宣言します。  汎用デリゲートを使用して、宣言する必要のあるデリゲート型の数を最小限に抑えるよう考慮してください。  次のコードでは、1 つのパラメーターと戻り値を持つ任意のメソッド、またはデリゲートがオブジェクトにバインドされている場合は 2 つのパラメーターと戻り値を持つメソッドの実行に使用できる汎用デリゲート型を宣言します。  
+  
+     [!code-cpp[DynamicMethodHowTo#12](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#12)]
+     [!code-csharp[DynamicMethodHowTo#12](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#12)]
+     [!code-vb[DynamicMethodHowTo#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#12)]  
+  
+2.  動的メソッドのパラメーターの型を指定する配列を作成します。  メソッドを表すデリゲートをオブジェクトにバインドする場合、1 つ目のパラメーターは、デリゲートのバインド先となる型と一致する必要があります。  この例では、`Example` 型と `int` 型 \(Visual Basic では `Integer`\) の 2 つのパラメーターがあります。  
+  
+     [!code-cpp[DynamicMethodHowTo#13](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#13)]
+     [!code-csharp[DynamicMethodHowTo#13](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#13)]
+     [!code-vb[DynamicMethodHowTo#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#13)]  
+  
+3.  <xref:System.Reflection.Emit.DynamicMethod> を作成します。  この例では、メソッドには名前はありません。  戻り値の型は、`int` \(Visual Basic では `Integer`\) として指定します。  このメソッドは、`Example` クラスのプライベート メンバーとプロテクト メンバーにアクセスできます。  
+  
+     [!code-cpp[DynamicMethodHowTo#14](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#14)]
+     [!code-csharp[DynamicMethodHowTo#14](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#14)]
+     [!code-vb[DynamicMethodHowTo#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#14)]  
+  
+4.  メソッド本体を出力します。  この例では、<xref:System.Reflection.Emit.ILGenerator> オブジェクトを使用して、MSIL \(Microsoft Intermediate Language\) を出力します。  また、<xref:System.Reflection.Emit.DynamicILInfo> オブジェクトをアンマネージ コード ジェネレーターと組み合わせて使用して、<xref:System.Reflection.Emit.DynamicMethod> のメソッド本体を出力することもできます。  
+  
+     この例の MSIL は、`Example` クラスのインスタンスである 1 つ目の引数を読み込み、この引数を使用して、`int` 型のプライベート インスタンス フィールドの値を読み込みます。  2 つ目の引数が読み込まれ、この 2 つの数値が乗算されます。  この結果が `int` よりも大きい場合、値は切り捨てられ、上位ビットは破棄されます。  戻り値がスタックに配置されて、メソッドが返されます。  
+  
+     [!code-cpp[DynamicMethodHowTo#15](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#15)]
+     [!code-csharp[DynamicMethodHowTo#15](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#15)]
+     [!code-vb[DynamicMethodHowTo#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#15)]  
+  
+5.  <xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%28System.Type%2CSystem.Object%29> メソッド オーバーロードを呼び出して、動的メソッドを表す \(手順 1 で宣言した\) デリゲートのインスタンスを作成します。  デリゲートを作成すると、メソッドは完了します。メソッドにそれ以上変更を加えようとしても \(MSIL の追加など\) 無視されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%2A> メソッドを複数回呼び出して、対象の型の他のインスタンスにバインドされたデリゲートを作成できます。  
+  
+     次のコードでは、プライベート テスト フィールドが 42 に設定された `Example` クラスの新しいインスタンスにメソッドをバインドします。  つまり、デリゲートが呼び出されるたびに、`Example` のインスタンスがメソッドの 1 つ目のパラメーターに渡されます。  
+  
+     メソッドの 1 つ目のパラメーターは、常に `Example` のインスタンスを受け取るため、`OneParameter` デリゲートが使用されます。  デリゲートの呼び出し時には、2 つ目のパラメーターだけが必要となります。  
+  
+     [!code-cpp[DynamicMethodHowTo#16](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#16)]
+     [!code-csharp[DynamicMethodHowTo#16](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#16)]
+     [!code-vb[DynamicMethodHowTo#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#16)]  
+  
+## 使用例  
+ 単純な動的メソッドおよびクラスのインスタンスにバインドされた動的メソッドを次のコード例に示します。  
+  
+ この単純な動的メソッドは、32 ビット整数である引数を 1 つ受け取り、その整数の 2 乗を 64 ビットで返します。  汎用デリゲートを使用して、メソッドを呼び出します。  
+  
+ 2 つ目の動的メソッドには、`Example` 型と `int` 型 \(Visual Basic では `Integer`\) の 2 つのパラメーターがあります。  動的メソッドが作成されると、`int` 型の引数を 1 つ持つ汎用デリゲートを使用して、`Example` のインスタンスにバインドされます。  メソッドの 1 つ目のパラメーターは、常に `Example` のバインドされたインスタンスを受け取るため、デリゲートは `Example` 型の引数を持ちません。  デリゲートの呼び出し時には、`int` 型の引数だけが提供されます。  動的メソッドは、`Example` クラスのプライベート フィールドにアクセスし、プライベート フィールドと `int` 型の引数の積を返します。  
+  
+ メソッドの実行に使用できるデリゲートを定義するコード例を次に示します。  
+  
+ [!code-cpp[DynamicMethodHowTo#1](../../../samples/snippets/cpp/VS_Snippets_CLR/DynamicMethodHowTo/cpp/source.cpp#1)]
+ [!code-csharp[DynamicMethodHowTo#1](../../../samples/snippets/csharp/VS_Snippets_CLR/DynamicMethodHowTo/cs/source.cs#1)]
+ [!code-vb[DynamicMethodHowTo#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DynamicMethodHowTo/vb/source.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコードには、コンパイルに必要な C\# の `using` ステートメント \(Visual Basic では `Imports`\) が含まれています。  
+  
+-   追加のアセンブリ参照は不要です。  
+  
+-   コマンド ラインで csc.exe、vbc.exe、または cl.exe を使用して、コードをコンパイルします。  Visual Studio でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Reflection.Emit.DynamicMethod>   
+ [Using Reflection Emit](http://msdn.microsoft.com/ja-jp/ccc6540d-0e2c-4d89-b456-eb7353f9e9ac)   
+ [Reflection Emit Dynamic Method Scenarios](http://msdn.microsoft.com/ja-jp/7c27ea3d-0f24-4bf3-8ceb-f49d33faca5e)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md b/docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md
new file mode 100644
index 00000000000..c8c4f025a89
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md
@@ -0,0 +1,132 @@
+---
+title: "方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック [.NET Framework], リフレクション"
+  - "リフレクション, ジェネリック型"
+ms.assetid: f93b03b0-1778-43fc-bc6d-35983d210e74
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する
+ジェネリック型の情報は、他の型の情報と同じ方法で取得します。つまり、ジェネリック型を表す <xref:System.Type> オブジェクトをチェックすることによって取得します。  根本的な違いとして、ジェネリック型には、そのジェネリック型パラメーターを表す <xref:System.Type> オブジェクトの一覧が含まれています。  このセクションでは、まず、ジェネリック型をチェックする手順を示します。  
+  
+ ジェネリック型の定義の型パラメーターに型引数をバインドすることにより、構築された型を表す <xref:System.Type> オブジェクトを作成できます。  2 番目の手順でこの方法を示します。  
+  
+### ジェネリック型とその型パラメーターをチェックするには  
+  
+1.  ジェネリック型を表す <xref:System.Type> のインスタンスを取得します。  次のコードでは、C\# の `typeof` 演算子 \(Visual Basic では `GetType`、Visual C\+\+ では `typeid`\) を使用して型を取得します。  <xref:System.Type> オブジェクトを取得する他の方法については、<xref:System.Type> クラスのトピックを参照してください。  この手順では、これ以降、型は `t` という名前のメソッド パラメーターに格納されます。  
+  
+     [!code-cpp[HowToGeneric#2](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#2)]
+     [!code-csharp[HowToGeneric#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#2)]
+     [!code-vb[HowToGeneric#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#2)]  
+  
+2.  <xref:System.Type.IsGenericType%2A> プロパティを使用して、型がジェネリックかどうかを確認し、<xref:System.Type.IsGenericTypeDefinition%2A> プロパティを使用して型がジェネリック型の定義かどうかを確認します。  
+  
+     [!code-cpp[HowToGeneric#3](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#3)]
+     [!code-csharp[HowToGeneric#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#3)]
+     [!code-vb[HowToGeneric#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#3)]  
+  
+3.  <xref:System.Type.GetGenericArguments%2A> メソッドを使用して、ジェネリック型引数が格納された配列を取得します。  
+  
+     [!code-cpp[HowToGeneric#4](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#4)]
+     [!code-csharp[HowToGeneric#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#4)]
+     [!code-vb[HowToGeneric#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#4)]  
+  
+4.  各型引数について、<xref:System.Type.IsGenericParameter%2A> プロパティを使用して、その型引数が型パラメーター \(ジェネリック型定義の型パラメーターなど\) であるか、型パラメーターに指定された型 \(構築された型の型パラメーターなど\) であるかを確認します。  
+  
+     [!code-cpp[HowToGeneric#5](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#5)]
+     [!code-csharp[HowToGeneric#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#5)]
+     [!code-vb[HowToGeneric#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#5)]  
+  
+5.  型システムでは、ジェネリック型パラメーターは、通常の型と同様に <xref:System.Type> のインスタンスによって表されます。  次のコードでは、ジェネリック型パラメーターを表す <xref:System.Type> オブジェクトの名前とパラメーター位置を表示します。  パラメーター位置はここでは重要な情報ではありませんが、別のジェネリック型の型引数として使用されている型パラメーターをチェックする場合に重要となります。  
+  
+     [!code-cpp[HowToGeneric#6](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#6)]
+     [!code-csharp[HowToGeneric#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#6)]
+     [!code-vb[HowToGeneric#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#6)]  
+  
+6.  <xref:System.Type.GetGenericParameterConstraints%2A> メソッドを使用して、ジェネリック型パラメーターの基本型の制約とインターフェイスの制約を確認し、単一の配列内のすべての制約を取得します。  制約は、特定の順序であるという保証はありません。  
+  
+     [!code-cpp[HowToGeneric#7](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#7)]
+     [!code-csharp[HowToGeneric#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#7)]
+     [!code-vb[HowToGeneric#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#7)]  
+  
+7.  <xref:System.Type.GenericParameterAttributes%2A> プロパティを使用して、型パラメーターの特殊な制約 \(参照型であることが必要など\) を確認します。  このプロパティには、分散を表す値も含まれています。次のコードに示すように、この値にはマスクを設定できます。  
+  
+     [!code-cpp[HowToGeneric#8](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#8)]
+     [!code-csharp[HowToGeneric#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#8)]
+     [!code-vb[HowToGeneric#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#8)]  
+  
+8.  特殊な制約の属性はフラグであり、特殊な制約がないことを表すフラグ \(<xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName>\) と同じフラグが、共変性や反変性がないことも表します。  したがって、これらの条件のいずれかを調べるには、適切なマスクを使用する必要があります。  ここでは、<xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName> を使用して、特殊な制約のフラグを切り分けます。  
+  
+     [!code-cpp[HowToGeneric#9](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#9)]
+     [!code-csharp[HowToGeneric#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#9)]
+     [!code-vb[HowToGeneric#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#9)]  
+  
+## ジェネリック型のインスタンスの構築  
+ ジェネリック型はテンプレートに似ています。  ジェネリック型パラメーターの実際の型を指定しない限り、インスタンスを作成することはできません。  リフレクションを使用して実行時にこれを行うには、<xref:System.Type.MakeGenericType%2A> メソッドが必要です。  
+  
+#### ジェネリック型のインスタンスを構築するには  
+  
+1.  ジェネリック型を表す <xref:System.Type> オブジェクトを取得します。  次のコードでは、2 とおりの方法でジェネリック型 <xref:System.Collections.Generic.Dictionary%602> を取得します。型を示す文字列を指定して <xref:System.Type.GetType%28System.String%29?displayProperty=fullName> メソッド オーバーロードを使用する方法と、構築された型 `Dictionary\<String, Example>` \(Visual Basic では `Dictionary(Of String, Example)`\) で <xref:System.Type.GetGenericTypeDefinition%2A> メソッドを呼び出す方法です。  <xref:System.Type.MakeGenericType%2A> メソッドには、ジェネリック型の定義が必要です。  
+  
+     [!code-cpp[HowToGeneric#10](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#10)]
+     [!code-csharp[HowToGeneric#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#10)]
+     [!code-vb[HowToGeneric#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#10)]  
+  
+2.  型引数の配列を構築して、型パラメーターと置き換えます。  配列には、型パラメーター リストに表示される順序と同じ順序で、正確な数の <xref:System.Type> オブジェクトを格納する必要があります。  この場合、キー \(最初の型パラメーター\) の型は <xref:System.String> であり、ディクショナリの値は `Example` というクラスのインスタンスです。  
+  
+     [!code-cpp[HowToGeneric#11](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#11)]
+     [!code-csharp[HowToGeneric#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#11)]
+     [!code-vb[HowToGeneric#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#11)]  
+  
+3.  <xref:System.Type.MakeGenericType%2A> メソッドを呼び出して型引数を型パラメーターにバインドし、型を構築します。  
+  
+     [!code-cpp[HowToGeneric#12](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#12)]
+     [!code-csharp[HowToGeneric#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#12)]
+     [!code-vb[HowToGeneric#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#12)]  
+  
+4.  <xref:System.Activator.CreateInstance%28System.Type%29> メソッド オーバーロードを使用して、構築された型のオブジェクトを作成します。  次のコードでは、作成された `Dictionary<String, Example>` オブジェクトに、`Example` クラスの 2 つのインスタンスを格納します。  
+  
+     [!code-cpp[HowToGeneric#13](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#13)]
+     [!code-csharp[HowToGeneric#13](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#13)]
+     [!code-vb[HowToGeneric#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#13)]  
+  
+## 使用例  
+ `DisplayGenericType` メソッドを定義して、コードで使用されているジェネリック型の定義と構築された型をチェックし、この情報を表示するコード例を次に示します。  `DisplayGenericType` メソッドは、<xref:System.Type.IsGenericType%2A>、<xref:System.Type.IsGenericParameter%2A>、<xref:System.Type.GenericParameterPosition%2A> の各プロパティと <xref:System.Type.GetGenericArguments%2A> メソッドの使用方法を示します。  
+  
+ この例では、`DisplayGenericParameter` メソッドも定義してジェネリック型パラメーターをチェックし、その制約を表示します。  
+  
+ このコード例では、型パラメーターの制約を示すジェネリック型を含む一連のテスト用の型を定義し、これらの型の情報を表示する方法を示します。  
+  
+ この例では、型引数の配列を作成し、<xref:System.Type.MakeGenericType%2A> メソッドを呼び出して、<xref:System.Collections.Generic.Dictionary%602> クラスから型を構築します。  プログラムでは、<xref:System.Type.MakeGenericType%2A> を使用して構築された <xref:System.Type> オブジェクトと、`typeof` \(Visual Basic では `GetType`\) を使用して取得した <xref:System.Type> オブジェクトを比較し、これらが同じであることを示します。  同様に、<xref:System.Type.GetGenericTypeDefinition%2A> メソッドを使用して構築された型のジェネリック型の定義を取得し、<xref:System.Collections.Generic.Dictionary%602> クラスを表す <xref:System.Type> オブジェクトと比較します。  
+  
+ [!code-cpp[HowToGeneric#1](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/ur.cpp#1)]
+ [!code-csharp[HowToGeneric#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/ur.cs#1)]
+ [!code-vb[HowToGeneric#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/ur.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコードには、コンパイルに必要な C\# の `using` ステートメント \(Visual Basic では `Imports`\) が含まれています。  
+  
+-   追加のアセンブリ参照は不要です。  
+  
+-   コマンド ラインで csc.exe、vbc.exe、または cl.exe を使用して、コードをコンパイルします。  Visual Studio でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Type>   
+ <xref:System.Reflection.MethodInfo>   
+ [リフレクションとジェネリック型](../../../docs/framework/reflection-and-codedom/reflection-and-generic-types.md)   
+ [型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)   
+ [ジェネリック](../../../docs/standard/generics/index.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-hook-up-a-delegate-using-reflection.md b/docs/framework/reflection-and-codedom/how-to-hook-up-a-delegate-using-reflection.md
new file mode 100644
index 00000000000..21af8b51eae
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-hook-up-a-delegate-using-reflection.md
@@ -0,0 +1,123 @@
+---
+title: "方法 : リフレクションを使用してデリゲートをフックする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デリゲート [.NET Framework], 追加 (リフレクションでイベント ハンドラーを)"
+  - "イベント [.NET Framework], 追加 (リフレクションでイベント ハンドラーを)"
+  - "リフレクション, 追加 (イベント ハンドラーのデリゲートを)"
+ms.assetid: 076ee62d-a964-449e-a447-c31b33518b81
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : リフレクションを使用してデリゲートをフックする
+リフレクションを使用して、アセンブリを読み込んで実行する場合、C\# の `+=` 演算子や Visual Basic の [AddHandler ステートメント](../../../ocs/visual-basic/language-reference/statements/addhandler-statement.md)のような言語機能を使用してイベントをフックすることはできません。  次の手順では、必要なすべての型をリフレクションによって取得することで、既存のメソッドをイベントにフックする方法と、リフレクション出力を使用して動的メソッドを作成し、それをイベントにフックする方法を示します。  
+  
+> [!NOTE]
+>  イベント処理デリゲートをフックするもう 1 つの方法については、<xref:System.Reflection.EventInfo> クラスの <xref:System.Reflection.EventInfo.AddEventHandler%2A> メソッドのコード例を参照してください。  
+  
+### リフレクションを使用してデリゲートをフックするには  
+  
+1.  イベントを発生させる型を格納するアセンブリを読み込みます。  通常、アセンブリは <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドで読み込まれます。  この例を簡単にするために、現在のアセンブリの派生フォームを使用します。したがって、<xref:System.Reflection.Assembly.GetExecutingAssembly%2A> メソッドを使用して、現在のアセンブリを読み込みます。  
+  
+     [!code-cpp[HookUpDelegate#3](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#3)]
+     [!code-csharp[HookUpDelegate#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#3)]
+     [!code-vb[HookUpDelegate#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#3)]  
+  
+2.  型を表す <xref:System.Type> オブジェクトを取得し、型のインスタンスを作成します。  このフォームは既定のコンストラクターを持つため、次のコードでは <xref:System.Activator.CreateInstance%28System.Type%29> メソッドを使用します。  作成する型が既定のコンストラクターを持たない場合に使用できる <xref:System.Activator.CreateInstance%2A> メソッドの他のオーバーロードが複数あります。  アセンブリについては何もわからないという架空の状態を保つために、新しいインスタンスは <xref:System.Object> 型として格納されます \(リフレクションを使用すると、事前に型名がわからなくてもアセンブリ内の型を取得できます\)。  
+  
+     [!code-cpp[HookUpDelegate#4](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#4)]
+     [!code-csharp[HookUpDelegate#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#4)]
+     [!code-vb[HookUpDelegate#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#4)]  
+  
+3.  イベントを表す <xref:System.Reflection.EventInfo> オブジェクトを取得し、<xref:System.Reflection.EventInfo.EventHandlerType%2A> プロパティを使用して、イベントの処理に使用するデリゲートの型を取得します。  次のコードでは、<xref:System.Windows.Forms.Control.Click> イベントの <xref:System.Reflection.EventInfo> が取得されます。  
+  
+     [!code-cpp[HookUpDelegate#5](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#5)]
+     [!code-csharp[HookUpDelegate#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#5)]
+     [!code-vb[HookUpDelegate#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#5)]  
+  
+4.  イベントを処理するメソッドを表す <xref:System.Reflection.MethodInfo> オブジェクトを取得します。  このトピックで後ほど示す「使用例」セクションの完全なプログラム コードには、<xref:System.Windows.Forms.Control.Click> イベントを処理する <xref:System.EventHandler> デリゲートのシグネチャと一致するメソッドが含まれていますが、実行時に動的メソッドを生成することもできます。  詳細については、動的メソッドを使用して実行時にイベント ハンドラーを生成する場合の手順を参照してください。  
+  
+     [!code-cpp[HookUpDelegate#6](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#6)]
+     [!code-csharp[HookUpDelegate#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#6)]
+     [!code-vb[HookUpDelegate#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#6)]  
+  
+5.  <xref:System.Delegate.CreateDelegate%2A> メソッドを使用して、デリゲートのインスタンスを作成します。  このメソッドは static \(Visual Basic では `Shared`\) であるため、デリゲート型を指定する必要があります。  <xref:System.Reflection.MethodInfo> を受け取る <xref:System.Delegate.CreateDelegate%2A> のオーバーロードを使用することをお勧めします。  
+  
+     [!code-cpp[HookUpDelegate#7](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#7)]
+     [!code-csharp[HookUpDelegate#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#7)]
+     [!code-vb[HookUpDelegate#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#7)]  
+  
+6.  `add` アクセサー メソッドを取得し、このメソッドを呼び出してイベントをフックします。  すべてのイベントに、`add` アクセサーと `remove` アクセサーがあります。これらのアクセサーは高水準言語の構文によって隠ぺいされます。  たとえば、C\# では `+=` 演算子を使用してイベントをフックし、Visual Basic では [AddHandler ステートメント](../../../ocs/visual-basic/language-reference/statements/addhandler-statement.md)を使用します。  次のコードでは、<xref:System.Windows.Forms.Control.Click> イベントの `add` アクセサーを取得し、遅延バインディングによってこれを呼び出して、デリゲート インスタンスに渡します。  引数は配列として渡す必要があります。  
+  
+     [!code-cpp[HookUpDelegate#8](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#8)]
+     [!code-csharp[HookUpDelegate#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#8)]
+     [!code-vb[HookUpDelegate#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#8)]  
+  
+7.  イベントをテストします。  次のコードで、このコード例で定義したフォームを表示します。  フォームをクリックすると、イベント ハンドラーが呼び出されます。  
+  
+     [!code-cpp[HookUpDelegate#12](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#12)]
+     [!code-csharp[HookUpDelegate#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#12)]
+     [!code-vb[HookUpDelegate#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#12)]  
+  
+<a name="procedureSection1"></a>   
+### 動的メソッドを使用して実行時にイベント ハンドラーを生成するには  
+  
+1.  軽量の動的メソッドとリフレクション出力を使用して、イベント ハンドラーのメソッドを実行時に生成できます。  イベント ハンドラーを作成するには、デリゲートの戻り値の型とパラメーターの型が必要です。  これらは、デリゲートの `Invoke` メソッドを調べることによって入手できます。  次のコードでは、`GetDelegateReturnType` メソッドと `GetDelegateParameterTypes` メソッドを使用して、この情報を取得します。  これらのメソッドのコードは、このトピックで後ほど示す「使用例」セクションにあります。  
+  
+     <xref:System.Reflection.Emit.DynamicMethod> に名前を付ける必要はないため、空の文字列を使用できます。  次のコードでは、最後の引数が動的メソッドを現在の型に関連付け、デリゲートが `Example` クラスのすべてのパブリック メンバーとプライベート メンバーにアクセスできるようにします。  
+  
+     [!code-cpp[HookUpDelegate#9](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#9)]
+     [!code-csharp[HookUpDelegate#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#9)]
+     [!code-vb[HookUpDelegate#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#9)]  
+  
+2.  メソッド本体を生成します。  このメソッドは文字列を読み込み、文字列を受け取る <xref:System.Windows.Forms.MessageBox.Show%2A?displayProperty=fullName> メソッドのオーバーロードを呼び出します。次に、戻り値をスタックからポップし \(ハンドラーには戻り値の型がないため\)、返されます。  動的メソッドの出力の詳細については、「[方法: 動的メソッドを定義および実行する](../../../docs/framework/reflection-and-codedom/how-to-define-and-execute-dynamic-methods.md)」を参照してください。  
+  
+     [!code-cpp[HookUpDelegate#10](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#10)]
+     [!code-csharp[HookUpDelegate#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#10)]
+     [!code-vb[HookUpDelegate#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#10)]  
+  
+3.  <xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%2A> メソッドを呼び出して、動的メソッドを完了します。  `add` アクセサーを使用して、イベントの呼び出しリストにデリゲートを追加します。  
+  
+     [!code-cpp[HookUpDelegate#11](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#11)]
+     [!code-csharp[HookUpDelegate#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#11)]
+     [!code-vb[HookUpDelegate#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#11)]  
+  
+4.  イベントをテストします。  次のコードでは、このコード例で定義したフォームを読み込みます。  フォームをクリックすると、定義済みイベント ハンドラーと出力されたイベント ハンドラーの両方が呼び出されます。  
+  
+     [!code-cpp[HookUpDelegate#12](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#12)]
+     [!code-csharp[HookUpDelegate#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#12)]
+     [!code-vb[HookUpDelegate#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#12)]  
+  
+## 使用例  
+ リフレクションを使用して既存のメソッドをイベントにフックする方法、および <xref:System.Reflection.Emit.DynamicMethod> クラスを使用してメソッドを実行時に出力し、イベントにフックする方法を次のコード例に示します。  
+  
+ [!code-cpp[HookUpDelegate#1](../../../samples/snippets/cpp/VS_Snippets_CLR/HookUpDelegate/cpp/source.cpp#1)]
+ [!code-csharp[HookUpDelegate#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HookUpDelegate/cs/source.cs#1)]
+ [!code-vb[HookUpDelegate#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HookUpDelegate/vb/source.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコードには、コンパイルに必要な C\# の `using` ステートメント \(Visual Basic では `Imports`\) が含まれています。  
+  
+-   コマンド ラインからコンパイルするために、追加のアセンブリ参照は必要ありません。  この例はコンソール アプリケーションであるため、Visual Studio では、System.Windows.Forms.dll への参照を追加する必要があります。  
+  
+-   コマンド ラインで csc.exe、vbc.exe、または cl.exe を使用して、コードをコンパイルします。  Visual Studio でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Emit.DynamicMethod>   
+ <xref:System.Activator.CreateInstance%2A>   
+ <xref:System.Delegate.CreateDelegate%2A>   
+ [方法: 動的メソッドを定義および実行する](../../../docs/framework/reflection-and-codedom/how-to-define-and-execute-dynamic-methods.md)   
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md b/docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md
new file mode 100644
index 00000000000..6a13d8f6af8
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : リフレクションのみのコンテキストにアセンブリを読み込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 読み込み (リフレクション)"
+  - "アセンブリ [.NET Framework], リフレクションのみのローダー コンテキスト"
+  - "属性 [.NET Framework], 取得"
+  - "リフレクション, リフレクションのみのローダー コンテキスト"
+  - "リフレクションのみのローダー コンテキスト"
+ms.assetid: 9818b660-52f5-423d-a9af-e75163aa7068
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : リフレクションのみのコンテキストにアセンブリを読み込む
+リフレクションのみの読み込みのコンテキストでは、他のプラットフォームや .NET Framework の他のバージョン用にコンパイルされたアセンブリをチェックできます。  このコンテキストに読み込まれたコードはチェックのみ可能で、実行できません。  そのため、コンストラクターを実行できないので、オブジェクトは作成できません。  また、コードを実行できないため、依存関係は自動的には読み込まれません。  依存関係をチェックする必要がある場合は、依存関係を独自に読み込む必要があります。  
+  
+### アセンブリをリフレクションのみの読み込みのコンテキストに読み込むには  
+  
+1.  表示名が指定されたアセンブリを読み込むには、<xref:System.Reflection.Assembly.ReflectionOnlyLoad%28System.String%29> メソッド オーバーロードを使用し、パスが指定されたアセンブリを読み込むには、<xref:System.Reflection.Assembly.ReflectionOnlyLoadFrom%2A> メソッドを使用します。  アセンブリがバイナリ イメージの場合は、[ReflectionOnlyLoad\(Byte\<xref:System.Reflection.Assembly.ReflectionOnlyLoad%28System.Byte%5B%5D%29> メソッド オーバーロードを使用します。  
+  
+    > [!NOTE]
+    >  リフレクションのみのコンテキストを使用して、実行コンテキストのバージョン以外の .NET Framework のバージョンから mscorlib.dll のバージョンを読み込むことはできません。  
+  
+2.  アセンブリに依存関係がある場合、<xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A> メソッドは依存関係を読み込みません。  依存関係をチェックする場合は、依存関係を独自に読み込む必要があります。  
+  
+3.  アセンブリの <xref:System.Reflection.Assembly.ReflectionOnly%2A> プロパティを使用して、アセンブリをリフレクションのみのコンテキストに読み込むかどうかを決定します。  
+  
+4.  アセンブリまたはアセンブリ内の型に属性が適用されている場合は、<xref:System.Reflection.CustomAttributeData> クラスを使用してこれらの属性をチェックし、リフレクションのみのコンテキストでコードが実行されないことを確認します。  <xref:System.Reflection.CustomAttributeData.GetCustomAttributes%2A?displayProperty=fullName> メソッドの適切なオーバーロードを使用して、アセンブリ、メンバー、またはパラメーターに適用されている属性を表す <xref:System.Reflection.CustomAttributeData> オブジェクトを取得します。  
+  
+    > [!NOTE]
+    >  アセンブリまたはそのコンテンツに適用されている属性はそのアセンブリで定義されていることもありますし、リフレクションのみのコンテキストに読み込まれた別のアセンブリで定義されていることもあります。  属性がどこで定義されているかを事前に確認する方法はありません。  
+  
+## 使用例  
+ リフレクションのみのコンテキストに読み込まれたアセンブリに適用されている属性をチェックする方法を以下のコード例に示します。  
+  
+ このコード例では、2 つのコンストラクターと 1 つのプロパティでカスタム属性を定義します。  この属性は、アセンブリ、アセンブリで宣言された型、型のメソッド、およびメソッドのパラメーターに適用されます。  このコード例を実行すると、アセンブリがそれ自体をリフレクションのみのコンテキストに読み込み、アセンブリとそれに含まれている型およびメンバーに適用されているカスタム属性に関する情報を表示します。  
+  
+> [!NOTE]
+>  コード例を簡素にするために、アセンブリがそれ自体を読み込んでチェックします。  通常、同じアセンブリが実行コンテキストとリフレクションのみのコンテキストの両方に読み込まれることはありません。  
+  
+ [!code-cpp[CustomAttributeData#1](../../../samples/snippets/cpp/VS_Snippets_CLR/CustomAttributeData/CPP/source.cpp#1)]
+ [!code-csharp[CustomAttributeData#1](../../../samples/snippets/csharp/VS_Snippets_CLR/CustomAttributeData/CS/source.cs#1)]
+ [!code-vb[CustomAttributeData#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CustomAttributeData/VB/source.vb#1)]  
+  
+## 参照  
+ <xref:System.Reflection.Assembly.ReflectionOnlyLoad%2A>   
+ <xref:System.Reflection.Assembly.ReflectionOnly%2A>   
+ <xref:System.Reflection.CustomAttributeData>
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/index.md b/docs/framework/reflection-and-codedom/index.md
new file mode 100644
index 00000000000..3a7b6ab0e83
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/index.md
@@ -0,0 +1,41 @@
+---
+title: ".NET Framework の動的プログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, 動的プログラミング"
+  - "動的プログラミング [.NET Framework]"
+ms.assetid: f78ec137-df0e-48c9-a7a0-5f6a1055f011
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# .NET Framework の動的プログラミング
+このセクションでは、.NET Framework での動的プログラミングについて説明します。  
+  
+## このセクションの内容  
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)  
+ リフレクションを使用して実行時にオブジェクトを操作する方法について説明します。  
+  
+ [動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)  
+ Reflection.Emit を使用して実行時にメソッドとアセンブリを作成する方法について説明します。  
+  
+ [動的言語ランタイムの概要](../../../docs/framework/reflection-and-codedom/dynamic-language-runtime-overview.md)  
+ 動的言語ランタイムの機能について説明します。  
+  
+ [動的なソース コードの生成とコンパイル](../../../docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md)  
+ 動的ソース コードを生成およびコンパイルする方法について説明します。  
+  
+## 関連項目  
+ [開発ガイド](../../../docs/framework/development-guide.md)  
+  
+ [Advanced Reading for the .NET Framework](http://msdn.microsoft.com/ja-jp/faae8083-fecb-4514-b133-b0a5a32a7c3c)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/media/dlr-archoverview.png b/docs/framework/reflection-and-codedom/media/dlr-archoverview.png
new file mode 100644
index 00000000000..391f0d798ea
Binary files /dev/null and b/docs/framework/reflection-and-codedom/media/dlr-archoverview.png differ
diff --git a/docs/framework/reflection-and-codedom/reflection-and-generic-types.md b/docs/framework/reflection-and-codedom/reflection-and-generic-types.md
new file mode 100644
index 00000000000..83434547180
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/reflection-and-generic-types.md
@@ -0,0 +1,151 @@
+---
+title: "リフレクションとジェネリック型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック [.NET Framework], リフレクション"
+  - "ジェネリック [.NET Framework], リフレクション出力"
+  - "リフレクション出力, ジェネリック型"
+  - "リフレクション, ジェネリック型"
+  - "型引数"
+  - "型情報, 表示"
+  - "型パラメーター"
+  - "型, 汎用"
+  - "表示 (型情報を)"
+ms.assetid: f7180fc5-dd41-42d4-8a8e-1b34288e06de
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# リフレクションとジェネリック型
+<a name="top"></a> リフレクションの観点から言えば、ジェネリック型は、それがジェネリック型定義である場合は型パラメーター セットが、構築された型である場合は型引数セットが関連付けられているという点で通常の型と異なります。 ジェネリック メソッドと通常のメソッドの違いも、それと同様です。  
+  
+ リフレクションでジェネリック型とジェネリック メソッドが処理されるしくみを理解するうえで、次の 2 つの点が重要となります。  
+  
+-   ジェネリック型の定義とジェネリック メソッドの定義の型パラメーターは、<xref:System.Type> クラスのインスタンスによって表されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Type> オブジェクトがジェネリック型パラメーターを表す場合、<xref:System.Type> の多数のプロパティとメソッドの動作が異なります。 これらの相違点については、該当するプロパティおよびメソッドに関するトピックに記載されています。 たとえば、<xref:System.Type.IsAutoClass%2A> や <xref:System.Type.DeclaringType%2A> を参照してください。 さらに、一部のメンバーは <xref:System.Type> オブジェクトがジェネリック型パラメーターを表す場合にのみ有効です。 例については、「<xref:System.Type.GetGenericTypeDefinition%2A>」を参照してください。  
+  
+-   <xref:System.Type> のインスタンスがジェネリック型を表す場合、そのインスタンスには、型パラメーター \(ジェネリック型の定義の場合\) または型引数 \(構築された型の場合\) を表す型の配列が含まれます。 ジェネリック メソッドを表す <xref:System.Reflection.MethodInfo> クラスのインスタンスの場合も同様です。  
+  
+ リフレクションが提供する <xref:System.Type> および <xref:System.Reflection.MethodInfo> のメソッドを使用すると、型パラメーターの配列にアクセスしたり、<xref:System.Type> のインスタンスが型パラメーターと実際の型のどちらを表しているかを確認したりできます。  
+  
+ ここで説明するメソッドを示すコード例については、「[方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する](../../../docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md)」をご覧ください。  
+  
+ 以下の説明は、型パラメーターと型引数の違いや、オープン構築型とクローズ構築型の違いなど、ジェネリックの用語を十分に理解していることを前提としています。 詳細については、「[ジェネリック](../../../docs/standard/generics/index.md)」を参照してください。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [ジェネリック型またはジェネリック メソッドであるかどうかの確認](#is_this_a_generic_type_or_method)  
+  
+-   [クローズ ジェネリック型の生成](#generating_closed_generic_types)  
+  
+-   [型引数と型パラメーターの確認](#examining_type_arguments)  
+  
+-   [インバリアント](#invariants)  
+  
+-   [関連トピック](#related_topics)  
+  
+<a name="is_this_a_generic_type_or_method"></a>   
+## ジェネリック型またはジェネリック メソッドであるかどうかの確認  
+ リフレクションを使用して、<xref:System.Type> のインスタンスによって表される不明な型を調べる場合は、<xref:System.Type.IsGenericType%2A> プロパティを使用してその不明な型がジェネリックかどうかを確認します。 型がジェネリックの場合、`true` を返します。 同様に、<xref:System.Reflection.MethodInfo> クラスのインスタンスによって表される不明なメソッドを調べる場合には、<xref:System.Reflection.MethodInfo.IsGenericMethod%2A> プロパティを使用してそのメソッドがジェネリックかどうかを確認します。  
+  
+### ジェネリック型の定義またはジェネリック メソッドの定義であるかどうかの確認  
+ <xref:System.Type> オブジェクトがジェネリック型の定義を表しているかどうかを確認するには、<xref:System.Type.IsGenericTypeDefinition%2A> プロパティを使用します。また、<xref:System.Reflection.MethodInfo> がジェネリック メソッドの定義を表しているかどうかを確認するには、<xref:System.Reflection.MethodInfo.IsGenericMethodDefinition%2A> メソッドを使用します。  
+  
+ ジェネリック型の定義とジェネリック メソッドの定義は、インスタンス化可能な型の作成元となるテンプレートです。<xref:System.Collections.Generic.Dictionary%602> など、.NET Framework クラス ライブラリのジェネリック型は、ジェネリック型の定義です  
+  
+### 型またはメソッドがオープンかクローズか  
+ すべての型パラメーター \(すべての内包する型のすべての型パラメーターを含む\) がインスタンス化可能な型に置き換えられている場合、ジェネリック型またはジェネリック メソッドはクローズであるといいます。 ジェネリック型のインスタンスを作成できるのは、それがクローズである場合だけです。 型がオープンである場合、<xref:System.Type.ContainsGenericParameters%2A?displayProperty=fullName> プロパティは `true` を返します。 メソッドの場合、<xref:System.Reflection.MethodInfo.ContainsGenericParameters%2A?displayProperty=fullName> メソッドで同じ機能が実行されます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="generating_closed_generic_types"></a>   
+## クローズ ジェネリック型の生成  
+ ジェネリック型の定義を取得したら、<xref:System.Type.MakeGenericType%2A> メソッドを使用してクローズ ジェネリック型を作成します。また、ジェネリック メソッドの定義を取得したら、<xref:System.Reflection.MethodInfo.MakeGenericMethod%2A> メソッドを使用してクローズ ジェネリック メソッドの <xref:System.Reflection.MethodInfo> を作成します。  
+  
+### ジェネリック型の定義またはジェネリック メソッドの定義の取得  
+ ジェネリック型またはジェネリック メソッドの定義ではないオープン ジェネリック型またはオープン ジェネリック メソッドがある場合、そのインスタンスを作成することはできず、欠落している型パラメーターを指定することもできません。 ジェネリック型の定義またはジェネリック メソッドの定義が必要です。 ジェネリック型の定義を取得するには <xref:System.Type.GetGenericTypeDefinition%2A> メソッドを使用し、ジェネリック メソッドの定義を取得するには <xref:System.Reflection.MethodInfo.GetGenericMethodDefinition%2A> メソッドを使用します。  
+  
+ たとえば、`Dictionary<int, string>` \(Visual Basic では `Dictionary(Of Integer, String)`\) を表す <xref:System.Type> オブジェクトがあり、`Dictionary<string, MyClass>` 型を作成する必要がある場合は、<xref:System.Type.GetGenericTypeDefinition%2A> メソッドを使用して `Dictionary<TKey, TValue>` を表す <xref:System.Type> を取得し、<xref:System.Type.MakeGenericType%2A> メソッドを使用して `Dictionary<int, MyClass>` を表す <xref:System.Type> を作成します。  
+  
+ ジェネリック型ではないオープン ジェネリック型の例は、この後の「型パラメーターまたは型引数」セクションを参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="examining_type_arguments"></a>   
+## 型引数と型パラメーターの確認  
+ ジェネリック型の型パラメーターまたは型引数を表す <xref:System.Type> オブジェクトの配列を取得するには、<xref:System.Type.GetGenericArguments%2A?displayProperty=fullName> メソッドを使用します。また、ジェネリック メソッドに対して同じ操作を実行するには、<xref:System.Reflection.MethodInfo.GetGenericArguments%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ <xref:System.Type> オブジェクトが型パラメーターを表していることがわかったら、リフレクションによって他の多くの詳細を確認できます 型パラメーターのソース、その位置、およびその制約を確認できます。  
+  
+### 型パラメーターまたは型引数  
+ 配列の特定の要素が型パラメーターと型引数のどちらであるかを確認するには、<xref:System.Type.IsGenericParameter%2A> プロパティを使用します。 要素が型パラメーターの場合、<xref:System.Type.IsGenericParameter%2A> プロパティは `true` です。  
+  
+ ジェネリック型には、ジェネリック型の定義がないことがあります。その場合のジェネリック型はオープンであり、型引数と型パラメーターが混在しています。 たとえば、次のコードでは、クラス `D` は `B` の 2 つ目の型パラメーターを `D` の 1 つ目の型パラメーターに置き換えることによって作成された型から派生します。  
+  
+```csharp  
+class B<T, U> {} class D<V, W> : B<int, V> {}  
+```  
+  
+```vb  
+Class B(Of T, U) End Class Class D(Of V, W) Inherits B(Of Integer, V) End Class  
+```  
+  
+```cpp#  
+generic<typename T, typename U> ref class B {}; generic<typename V, typename W> ref class D : B<int, V> {};  
+```  
+  
+ `D<V, W>` を表す <xref:System.Type> オブジェクトを取得し、<xref:System.Type.BaseType%2A> プロパティを使用してその基本型を取得した場合、結果として得られる `type B<int, V>` はオープンであり、ジェネリック型の定義ではありません。  
+  
+### ジェネリック パラメーターのソース  
+ ジェネリック型パラメーターのソースとしては、開発者が今調べている型、外側の型、またはジェネリック メソッドが考えられます。 ジェネリック型パラメーターのソースを特定するには、次の手順を実行します。  
+  
+-   まず、<xref:System.Type.DeclaringMethod%2A> プロパティを使用して、型パラメーターのソースがジェネリック メソッドかどうかを判定します。 このプロパティの値が null 参照 \(Visual Basic では `Nothing`\) ではない場合、ソースはジェネリック メソッドです。  
+  
+-   ソースがジェネリック メソッドでない場合は、<xref:System.Type.DeclaringType%2A> プロパティを使用して、ジェネリック型パラメーターが属しているジェネリック型を判定します。  
+  
+ 型パラメーターがジェネリック メソッドに属している場合、<xref:System.Type.DeclaringType%2A> プロパティはそのジェネリック メソッドを宣言した型を返しますが、これは無関係です。  
+  
+### ジェネリック パラメーターの位置  
+ まれなケースですが、宣言するクラスの型パラメーター リスト内の型パラメーターの位置を確認することが必要な場合があります。 たとえば、上の例の `B<int, V>` 型を表す <xref:System.Type> オブジェクトについて考えてみます。<xref:System.Type.GetGenericArguments%2A> メソッドからは、型引数のリストが提供されます。`V` を調べるときには、<xref:System.Type.DeclaringMethod%2A> プロパティと <xref:System.Type.DeclaringType%2A> プロパティを使用してそれがどこからのものかを確認できます 次に、<xref:System.Type.GenericParameterPosition%2A> プロパティを使用することにより、型パラメーター リストの中でそれが定義されていた位置を判定できます。 この例では、`V` は、定義された型パラメーター リスト内の 0 \(ゼロ\) の位置にあります。  
+  
+### 基本データ型とインターフェイスの制約  
+ <xref:System.Type.GetGenericParameterConstraints%2A> メソッドを使用すると、基本データ型の制約と型パラメーターのインターフェイス制約を取得できます。 配列の要素の順序は重要ではありません。 要素がインターフェイス型の場合、その要素はインターフェイスの制約を表します。  
+  
+### ジェネリック パラメーターの属性  
+ <xref:System.Type.GenericParameterAttributes%2A> プロパティを使用すると、型パラメーターの変化 \(共変性または反変性\) と特殊な制約を示す <xref:System.Reflection.GenericParameterAttributes> 値を取得できます。  
+  
+#### 共変性と反変性  
+ 型パラメーターが共変性と反変性のどちらであるかを判定するには、<xref:System.Type.GenericParameterAttributes%2A> プロパティから返される <xref:System.Reflection.GenericParameterAttributes> 値に <xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName> マスクを適用します。 結果が <xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName> の場合、型パラメーターはインバリアント \(不変\) です。 「[共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)」を参照してください。  
+  
+#### 特殊な制約  
+ 型パラメーターの特殊な制約を判定するには、<xref:System.Type.GenericParameterAttributes%2A> プロパティから返される <xref:System.Reflection.GenericParameterAttributes> 値に <xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName> マスクを適用します。 結果が <xref:System.Reflection.GenericParameterAttributes?displayProperty=fullName> の場合、特殊な制約はありません。 型パラメーターに対する制約としては、参照型であること、null 非許容値型であること、既定のコンストラクターが存在すること、があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="invariants"></a>   
+## インバリアント  
+ ジェネリック型のリフレクションで使用される一般的な用語に対するインバリアント条件を記載した表は、<xref:System.Type.IsGenericType%2A?displayProperty=fullName> を参照してください。 ジェネリック メソッドに関連するその他の用語については、<xref:System.Reflection.MethodInfo.IsGenericMethod%2A?displayProperty=fullName> を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する](../../../docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md)|<xref:System.Type> と <xref:System.Reflection.MethodInfo> のプロパティとメソッドを使用してジェネリック型について調べる方法を説明します。|  
+|[ジェネリック](../../../docs/standard/generics/index.md)|ジェネリックの機能と .NET Framework におけるサポートについて説明します。|  
+|[方法: リフレクション出力を使用してジェネリック型を定義する](../../../docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md)|リフレクション出力を使用して動的アセンブリにジェネリック型を生成する方法について説明します。|  
+|[型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)|<xref:System.Type> クラスについて説明します。また、<xref:System.Type> をさまざまなリフレクション クラスと共に使用して、コンストラクター、メソッド、フィールド、プロパティ、およびイベントについての情報を取得する方法を示すコード例を提供します。|
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/reflection-for-windows-store-apps.md b/docs/framework/reflection-and-codedom/reflection-for-windows-store-apps.md
new file mode 100644
index 00000000000..49ba9e679f5
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/reflection-for-windows-store-apps.md
@@ -0,0 +1,48 @@
+---
+title: "Reflection in the .NET Framework for Windows Store Apps | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "reflection, Windows Store apps"
+  - ".NET for Windows Store apps, TypeInfo class"
+ms.assetid: 0d07090c-9b47-4ecc-81d1-29d539603c9b
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Reflection in the .NET Framework for Windows Store Apps
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、.NET Framework には、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリで使用される一連の使用のリフレクション型およびメンバーのセットが含まれます。  これらの型およびメンバーは、完全な .NET Framework だけでなく [Windows ストア アプリ用 .NET](http://go.microsoft.com/fwlink/?LinkID=225700) でも使用できます。  このドキュメントでは、これらと .NET Framework 4 以前のバージョンでの対応するものとの主な相違点について説明します。  
+  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを作成する場合は、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] でリフレクション型とメンバーを使用する必要があります。  デスクトップ アプリを使用する場合もこれらの型およびメンバーを使用できますが、必須ではないため、両方のタイプのアプリに同じコードを使用できます。  
+  
+## TypeInfo およびアセンブリの読み込み  
+ [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] では、<xref:System.Reflection.TypeInfo> クラスに .NET Framework 4 <xref:System.Type> クラスの機能の一部が含まれます。  <xref:System.Type> オブジェクトは型定義への参照を表し、<xref:System.Reflection.TypeInfo> オブジェクトは型定義自体を表します。  これによって、参照するアセンブリをランタイムが必ずしも読み込まなくても、<xref:System.Type> オブジェクトを操作できるようになります。  関連付けられた <xref:System.Reflection.TypeInfo> オブジェクトを取得すると、アセンブリが強制的に読み込まれます。  
+  
+ <xref:System.Reflection.TypeInfo> には <xref:System.Type> で使用できるメンバーの多くが含まれ、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] のリフレクションのプロパティの多くは <xref:System.Reflection.TypeInfo> オブジェクトのコレクションを返します。  <xref:System.Reflection.TypeInfo> オブジェクトから <xref:System.Type> オブジェクトを取得するには、<xref:System.Reflection.IReflectableType.GetTypeInfo%2A> メソッドを使用します。  
+  
+## クエリ メソッド  
+ [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] では、配列を返すメソッドではなく、<xref:System.Collections.Generic.IEnumerable%601> コレクションを返すリフレクション プロパティを使用します。  リフレクション コンテキストは、大型のアセンブリまたは型用に、これらのコレクションの限定的な走査を実装できます。  
+  
+ リフレクション プロパティは、継承ツリーを走査する代わりに、特定オブジェクトの宣言されたメソッドのみを返します。  また、フィルター処理に <xref:System.Reflection.BindingFlags> パラメーターを使用しません。  代わりに、返されるコレクションで LINQ クエリを使用することにより、フィルター処理をユーザー コード内で発生させます。  \(`typeof(Object)` の結果などにより\) ランタイムから始まるリフレクション オブジェクトの場合、継承ツリーを走査するには <xref:System.Reflection.RuntimeReflectionExtensions> クラスのヘルパー メソッドを使用するのが最も適切です。  カスタマイズされたリフレクション コンテキストのオブジェクトのコンシューマーは、これらのメソッドを使用できず、独自に継承ツリーを走査する必要があります。  
+  
+## 制約  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでは、.NET Framework の一部の型とメンバーへのアクセスが制限されます。  たとえば、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] オブジェクトを使用して、<xref:System.Reflection.MethodInfo> に含まれない .NET Framework のメソッドを呼び出すことはできません。  また、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] メンバーおよび <xref:System.Runtime.InteropServices.Marshal> メンバーと同様に、<xref:System.Runtime.InteropServices.WindowsRuntime.WindowsRuntimeMarshal> アプリにおいて安全とは見なされない特定の型およびメンバーはブロックされます。  この制限は、.NET Framework の型とメンバーにのみ適用されます。ユーザー コードやサードパーティ コードは通常どおり呼び出すことができます。  
+  
+## 例  
+ この例は、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] のリフレクション型とメンバーを使用して、<xref:System.Globalization.Calendar> 型のメソッドとプロパティを、継承されたメソッドとプロパティも含めて取得します。  このコードを実行するには、Reflection という名前のプロジェクトの `textblock1` という名前の [Windows.UI.Xaml.Controls.Textblock](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.controls.textblock.aspx) コントロールを含む [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] ページ用のコード ファイルにこのコードを貼り付けます。  別の名前のプロジェクトにこのコードを張り付ける場合は、名前空間の名前をプロジェクトに一致するように変更してください。  
+  
+ [!code-csharp[System.ReflectionWinStoreApp#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.reflectionwinstoreapp/cs/mainpage.xaml.cs#1)]
+ [!code-vb[System.ReflectionWinStoreApp#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.reflectionwinstoreapp/vb/mainpage.xaml.vb#1)]  
+  
+## 参照  
+ [リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)   
+ [Windows ストア アプリ用 .NET の API](http://go.microsoft.com/fwlink/?LinkID=225700)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/reflection.md b/docs/framework/reflection-and-codedom/reflection.md
new file mode 100644
index 00000000000..ad8ccfbd380
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/reflection.md
@@ -0,0 +1,98 @@
+---
+title: ".NET Framework のリフレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], リフレクション"
+  - "Assembly クラス, リフレクション"
+  - "共通言語ランタイム, リフレクション"
+  - "ConstructorInfo クラス, リフレクション"
+  - "探索 (実行時に型情報を)"
+  - "EventInfo クラス, リフレクション"
+  - "FieldInfo クラス, リフレクション"
+  - "MethodInfo クラス, リフレクション"
+  - "Module クラス, リフレクション"
+  - "モジュール, リフレクション"
+  - "ParameterInfo クラス, リフレクション"
+  - "PropertyInfo クラス, リフレクション"
+  - "リフレクション"
+  - "リフレクション, 概要 (リフレクションの)"
+  - "ランタイム, リフレクション"
+  - "型ブラウザー"
+  - "型システム, リフレクション"
+  - "値型, リフレクション"
+ms.assetid: d1a58e7f-fb39-4d50-bf84-e3b8f9bf9775
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# .NET Framework のリフレクション
+<xref:System.Reflection> 名前空間のクラスを <xref:System.Type?displayProperty=fullName> と共に使用すると、読み込まれた[アセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)についての情報、およびそのアセンブリ内に定義されている[クラス](http://msdn.microsoft.com/ja-jp/ad7d3561-271e-4546-82fc-e00b059f27a9)、[インターフェイス](http://msdn.microsoft.com/ja-jp/fd9d5975-5363-4bc9-b883-609f887895e5)、[値型](http://msdn.microsoft.com/ja-jp/c9c567f8-8ab1-4d88-834d-00f7d92418de)などの型を取得できます。  また、リフレクションを使用すると、実行時に型インスタンスを作成したり、作成した型インスタンスを呼び出したり、アクセスしたりできます。  リフレクションのさまざまな面に関するトピックについては、この概要の最後の「[関連トピック](#related_topics)」を参照してください。  
+  
+ [共通言語ランタイム](../../../docs/standard/clr.md) ローダーは、[アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)を管理します。アプリケーション ドメインは、同じアプリケーション スコープのオブジェクトの周りに定義された境界を構成します。  アプリケーション ドメインの管理には、該当アプリケーション ドメインへの各アセンブリの読み込み、および各アセンブリ内の型階層のメモリ レイアウトの制御などが含まれます。  
+  
+ [アセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)には、モジュールが含まれています。モジュールには、型が含まれています。また、型にはメンバーが含まれています。  リフレクションは、アセンブリ、モジュール、および型をカプセル化するオブジェクトを提供します。  リフレクションを使用すると、動的に型のインスタンスを作成したり、その型を既存のオブジェクトにバインドしたり、既存のオブジェクトから型を取得できます。  その後で、型のメソッドを呼び出したり、型のフィールドやプロパティにアクセスしたりできます。  リフレクションの代表的な用途は、次のとおりです。  
+  
+-   <xref:System.Reflection.Assembly> を使用して、アセンブリを定義または読み込み、アセンブリ マニフェストにリストされているモジュールを読み込み、そのアセンブリから型を検索し、そのインスタンスを作成します。  
+  
+-   モジュールを含んでいるアセンブリや、モジュール内のクラスなどの情報を探索するには、<xref:System.Reflection.Module> を使用します。  また、すべてのグローバル メソッドも取得できます。その他、モジュールに定義されている固有の非グローバルなメソッドも取得できます。  
+  
+-   名前、パラメーター、アクセス修飾子 \(`public` または `private` など\)、およびコンストラクターの実装詳細 \(`abstract` または `virtual` など\) の情報を探索するには、<xref:System.Reflection.ConstructorInfo> を使用します。  特定のコンストラクターを呼び出すには、<xref:System.Type> の <xref:System.Type.GetConstructors%2A> メソッドまたは <xref:System.Type.GetConstructor%2A> メソッドを使用します。  
+  
+-   名前、戻り値の型、パラメーター、アクセス修飾子 \(`public` または `private` など\)、およびメソッドの実装詳細 \(`abstract` または `virtual` など\) の情報を探索するには、<xref:System.Reflection.MethodInfo> を使用します。  特定のメソッドを呼び出すには、<xref:System.Type> の <xref:System.Type.GetMethods%2A> メソッドまたは <xref:System.Type.GetMethod%2A> メソッドを使用します。  
+  
+-   フィールドの名前、アクセス修飾子 \(`public` または `private` など\)、フィールドの実装詳細 \(`static` など\) などの情報を探索したり、フィールドの値を取得または設定したりするには、<xref:System.Reflection.FieldInfo> を使用します。  
+  
+-   名前、イベント ハンドラーのデータ型、カスタム属性、宣言型、イベントのリフレクションされた型などの情報を探索したり、イベント ハンドラーを追加および削除したりするには、<xref:System.Reflection.EventInfo> を使用します。  
+  
+-   プロパティの名前、データ型、宣言型、リフレクションされた型、読み取り専用または書き込み可能のステータスなどの情報を探索したり、プロパティの値を取得または設定したりするには、<xref:System.Reflection.PropertyInfo> を使用します。  
+  
+-   パラメーターの名前、データ型、パラメーターが入力パラメーターか出力パラメーターかなどの情報を探索したり、メソッド シグネチャ内のパラメーターの位置を探索したりするには、<xref:System.Reflection.ParameterInfo> を使用します。  
+  
+-   アプリケーション ドメインのリフレクション専用のコンテキストで作業する際に、カスタム属性に関する情報を検索するには、<xref:System.Reflection.CustomAttributeData> を使用します。  <xref:System.Reflection.CustomAttributeData> を使用すると、それらのインスタンスを作成せずに属性を調べることができます。  
+  
+ <xref:System.Reflection.Emit> 名前空間のクラスは、実行時に型を作成できる特殊な形態のリフレクションを提供します。  
+  
+ また、リフレクションを使用すると、ユーザーが型を選択し、型についての情報を表示できる、型ブラウザーと呼ばれるアプリケーションを作成することもできます。  
+  
+ リフレクションには、他の用途もあります。  JScript のような言語のコンパイラは、リフレクションを使用してシンボル テーブルを構築します。  <xref:System.Runtime.Serialization> 名前空間のクラスは、リフレクションを使用して、データにアクセスし、永続化するフィールドを決定します。  <xref:System.Runtime.Remoting> 名前空間のクラスは、シリアル化を通じて間接的にリフレクションを使用します。  
+  
+## リフレクションのランタイム型  
+ リフレクションは <xref:System.Type> や <xref:System.Reflection.MethodInfo> などのクラスを提供して、型、メンバー、パラメーター、およびその他のコード エンティティを示します。  ただし、リフレクションを使用する場合は、これらのクラスを直接利用しません。これらの大部分は抽象 \(Visual Basic では `MustInherit`\) です。  代わりに、共通言語ランタイム \(CLR\) によって提供される型を利用します。  
+  
+ たとえば、C\# `typeof` 演算子 \(Visual Basic では `GetType`\) を使用して <xref:System.Type> オブジェクトを取得する場合、オブジェクトは実際には `RuntimeType` です。  `RuntimeType` は <xref:System.Type> から派生し、すべての抽象メソッドの実装を提供します。  
+  
+ これらのランタイム クラスは `internal` \(Visual Basic では `Friend`\) です。  それらは基本クラスと別のドキュメントでは説明していません。それらの動作は基本クラスのドキュメントで説明されています。  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)|<xref:System.Type> クラスについて説明します。<xref:System.Type> をさまざまなリフレクション クラスと共に使用して、コンストラクター、メソッド、フィールド、プロパティ、およびイベントについての情報を取得する方法を示すコード例を提供します。|  
+|[リフレクションとジェネリック型](../../../docs/framework/reflection-and-codedom/reflection-and-generic-types.md)|ジェネリック型およびジェネリック メソッドの型パラメーターと型引数がリフレクションでどのように処理されるかについて説明します。|  
+|[リフレクションに関するセキュリティ上の考慮事項](../../../docs/framework/reflection-and-codedom/security-considerations-for-reflection.md)|型情報を探索し、型にアクセスするためにどの程度までリフレクションを使用できるかを決定する規則を説明します。|  
+|[型の動的な読み込みおよび使用](../../../docs/framework/reflection-and-codedom/dynamically-loading-and-using-types.md)|遅延バインディングをサポートするリフレクション カスタム バインディング インターフェイスについて説明します。|  
+|[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)|リフレクションのみの読み込みのコンテキストについて説明します。  アセンブリを読み込む方法、そのコンテキストをテストする方法、およびリフレクションのみのコンテキストでアセンブリに適用されている属性を調べる方法を紹介します。|  
+|[カスタム属性へのアクセス](../../../docs/framework/reflection-and-codedom/accessing-custom-attributes.md)|リフレクションを使用して、属性の有無および属性値を照会する方法を説明します。|  
+|[完全修飾型名の指定](../../../docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md)|Backus\-Naur form \(BNF\) に基づく完全修飾型名の書式と、特殊文字、アセンブリ名、ポインター、参照、および配列を指定する際に必要な構文を説明します。|  
+|[方法 : リフレクションを使用してデリゲートをフックする](../../../docs/framework/reflection-and-codedom/how-to-hook-up-a-delegate-using-reflection.md)|メソッドのデリゲートを作成し、デリゲートをイベントにフックする方法について説明します。  また、<xref:System.Reflection.Emit.DynamicMethod> を使用して実行時にイベント処理メソッドを作成する方法について説明します。|  
+|[動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)|動的アセンブリや動的メソッドを生成する方法について説明します。|  
+  
+## 参照  
+ <xref:System.Type?displayProperty=fullName>  
+  
+ <xref:System.Reflection>  
+  
+ <xref:System.Reflection.Emit>  
+  
+ [ページのトップへ](#top)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/security-considerations-for-reflection.md b/docs/framework/reflection-and-codedom/security-considerations-for-reflection.md
new file mode 100644
index 00000000000..d77d98bcf01
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/security-considerations-for-reflection.md
@@ -0,0 +1,121 @@
+---
+title: "リフレクションに関するセキュリティ上の考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "リンク確認要求"
+  - "MethodInfo パラメーター"
+  - "非パブリック メンバー"
+  - "部分信頼, リフレクション"
+  - "アクセス許可 [.NET Framework], リフレクション"
+  - "リフレクション, セキュリティ"
+  - "リフレクション, 部分信頼"
+ms.assetid: 42d9dc2a-8fcc-4ff3-b002-4ff260ef3dc5
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# リフレクションに関するセキュリティ上の考慮事項
+リフレクションを使用すると、型とメンバーに関する情報を取得し、メンバーにアクセスできます \(つまり、メソッドやコンストラクターの呼び出し、プロパティ値の取得と設定、イベント ハンドラーの追加と削除などを実行できます\)。  リフレクションを使用した型とメンバーに関する情報の取得には、制限がありません。  すべてのコードで、次のタスクを実行するためにリフレクションを使用できます。  
+  
+-   型とメンバーを列挙し、そのメタデータを確認する。  
+  
+-   アセンブリとモジュールを列挙し、確認する。  
+  
+ これに対して、リフレクションを使用したメンバーへのアクセスには、制限があります。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降、リフレクションを使用してセキュリティ クリティカルなメンバーにアクセスできるのは、信頼されているコードだけになりました。さらに、コンパイル済みコードに直接アクセスできない非パブリック メンバーに、リフレクションを使用してアクセスできるのも信頼されたコードだけです。最後に、セーフ クリティカルなメンバーにアクセスするリフレクションを使用するコードには、コンパイル済みコードと同様、セーフ クリティカル メンバーが要求するすべてのアクセス許可が必要です。  
+  
+ 必要なアクセス許可がある場合、コードはリフレクションを使用して次の種類のアクセスを実行できます。  
+  
+-   セキュリティ クリティカルではないをパブリック メンバーへのアクセス。  
+  
+-   コンパイル済みコードにアクセスできる非パブリック メンバーへのアクセス \(そのメンバーがセキュリティ クリティカルでない場合\)。  このような非パブリック メンバーの例を次に示します。  
+  
+    -   呼び出し元コードの基本クラスのプロテクト メンバー。  \(リフレクションの場合、これはファミリレベル アクセスと呼ばれます。\)  
+  
+    -   呼び出し元コードのアセンブリの `internal` メンバー \(Visual Basic では `Friend` メンバー\)  \(リフレクションの場合、これはアセンブリレベル アクセスと呼ばれます\)。  
+  
+    -   呼び出し元コードを含むクラスの他のインスタンスのプライベート メンバー。  
+  
+ たとえば、サンドボックス化されたアプリケーション ドメインで実行されるコードは、アプリケーション ドメインから追加のアクセス許可が付与されていない限り、この一覧に示したアクセスに限定されます。  
+  
+ [!INCLUDE[net_v20SP1_long](../../../includes/net-v20sp1-long-md.md)] 以降では、通常はアクセスできないメンバーにアクセスしようとすると、対象オブジェクトと <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが設定された <xref:System.Security.Permissions.ReflectionPermission> の許可セットに対する要求が生成されます。  完全信頼で実行されているコード \(コマンド ラインから起動されるアプリケーションのコードなど\) には、必要とされるこれらのアクセス許可が常にあります。  \(ただし、後で説明するように、セキュリティ クリティカルなメンバーにアクセスする場合は制限があります\)。  
+  
+ 必要に応じて、サンドボックス化されたアプリケーション ドメインから、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが設定された <xref:System.Security.Permissions.ReflectionPermission> を付与できます。これについては、後半の「[通常はアクセスできないメンバーへのアクセス](#accessingNormallyInaccessible)」で説明します。  
+  
+<a name="accessingSecurityCritical"></a>   
+## セキュリティ クリティカルなメンバーへのアクセス  
+ メンバーは、<xref:System.Security.SecurityCriticalAttribute> が指定されている場合、<xref:System.Security.SecurityCriticalAttribute> が指定されている型に属する場合、またはセキュリティ クリティカルなアセンブリ内にある場合は、セキュリティ クリティカルです。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、セキュリティ クリティカルなメンバーにアクセスする場合の規則は次のとおりです。  
+  
+-   透過的なコードでは、コードが完全に信頼されている場合でも、リフレクションを使用してセキュリティ クリティカルなメンバーにアクセスすることはできません。  <xref:System.MethodAccessException>、<xref:System.FieldAccessException>、または <xref:System.TypeAccessException> がスローされます。  
+  
+-   部分信頼で実行されているコードは透過的として扱われます。  
+  
+ これらの規則は、セキュリティ クリティカルなメンバーにコンパイルされたコードから直接アクセスする場合でも、リフレクションを使用してアクセスする場合でも同じです。  
+  
+ コマンド ラインから実行されるアプリケーション コードは完全信頼で実行されます。  この場合、透過的とマークされていない限り、リフレクションを使用してセキュリティ クリティカルなメンバーにアクセスできます。  同じコードが部分信頼で実行される場合 \(サンドボックス化されたアプリケーション ドメイン内など\)、セキュリティ クリティカル コードにアクセスできるかどうかは、アセンブリの信頼レベルによって決まります。アセンブリが厳密な名前を持ち、グローバル アセンブリ キャッシュにインストールされている場合は、信頼されたアセンブリとして、セキュリティ クリティカルなメンバーを呼び出すことができます。  信頼されない場合は、透過的とマークされていなくても透過的として扱われ、セキュリティ クリティカルなメンバーにはアクセスできません。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] のセキュリティ モデルの詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+## リフレクションと透過  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、型またはメンバーの透過度は、アセンブリの信頼レベルやアプリケーション ドメインの信頼レベルなど、複数の要素に基づいて共通言語ランタイムによって決定されます。  リフレクションには、型の透過度を確認できる <xref:System.Type.IsSecurityCritical%2A>、<xref:System.Type.IsSecuritySafeCritical%2A>、<xref:System.Type.IsSecurityTransparent%2A> の各プロパティが用意されています。  これらのプロパティの有効な組み合わせを、次の表に示します。  
+  
+|セキュリティ レベル|IsSecurityCritical|IsSecuritySafeCritical|IsSecurityTransparent|  
+|----------------|------------------------|----------------------------|---------------------------|  
+|重大|`true`|`false`|`false`|  
+|セーフ クリティカル|`true`|`true`|`false`|  
+|透明|`false`|`false`|`true`|  
+  
+ これらのプロパティを使用する方が、アセンブリとその型のセキュリティの注釈を調べたり、現在の信頼レベルを確認したり、ランタイムの規則を複製したりするより、はるかに簡単です。  たとえば、同じ型でも、コマンド ラインから実行される場合はセキュリティ クリティカルとなり、サンドボックス化されたアプリケーション ドメインで実行される場合は透過的セキュリティとなります。  
+  
+ <xref:System.Reflection.MethodBase>、<xref:System.Reflection.FieldInfo>、<xref:System.Reflection.Emit.TypeBuilder>、<xref:System.Reflection.Emit.MethodBuilder>、<xref:System.Reflection.Emit.DynamicMethod> の各クラスには、同様のプロパティがあります  \(プロパティ アクセサーに適用されるプロパティの場合など、その他のリフレクションとリフレクション出力の抽象クラスでは、関連付けられたメソッドにセキュリティ属性が適用されます\)。  
+  
+<a name="accessingNormallyInaccessible"></a>   
+## 通常はアクセスできないメンバーへのアクセス  
+ リフレクションを使用して、共通言語ランタイムのアクセシビリティ規則によりアクセスできないメンバーを呼び出すには、次の 2 つのアクセス許可のどちらかをコードに許可する必要があります。  
+  
+-   コードから非パブリック メンバーを呼び出せるようにするには、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが設定された <xref:System.Security.Permissions.ReflectionPermission> をコードに与える必要があります。  
+  
+    > [!NOTE]
+    >  既定で、インターネットを起源とするコードにこのアクセス許可を与えることは、セキュリティ ポリシーによって禁じられています。  インターネットを起源とするコードには、このアクセス許可を絶対に与えないでください。  
+  
+-   呼び出されるメンバーが格納されているアセンブリの許可セットが、呼び出し元のコードが格納されているアセンブリの許可セットと同じか、またはそのサブセットである場合に限り、コードから非パブリック メンバーを呼び出せるようにするには、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが設定された <xref:System.Security.Permissions.ReflectionPermission> をコードに与える必要があります。  
+  
+ たとえば、アプリケーション ドメインにインターネット アクセス許可を付与すると共に、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> に <xref:System.Security.Permissions.ReflectionPermission> フラグを指定するとします。次に、A と B の 2 つのアセンブリを使用して、インターネット アプリケーションを実行します。  
+  
+-   アセンブリ B の許可セットには、アセンブリ A に付与されていないアクセス許可が含まれていないため、アセンブリ A でリフレクションを使用してアセンブリ B のプライベート メンバーにアクセスできます。  
+  
+-   アセンブリ A では、リフレクションを使用して mscorlib.dll などの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アセンブリのプライベート メンバーにアクセスすることはできません。これは、mscorlib.dll が完全に信頼されており、アセンブリ A に付与されていないアクセス許可を持つためです。  実行時にコード アクセス セキュリティによりスタックを走査すると、<xref:System.MemberAccessException> がスローされます。  
+  
+## シリアル化  
+ シリアル化の目的で、<xref:System.Security.Permissions.SecurityPermission> に <xref:System.Security.Permissions.SecurityPermissionAttribute.SerializationFormatter%2A?displayProperty=fullName> フラグを指定することで、アクセシビリティに関係なく、シリアル化が可能な型のメンバーを取得および設定できるようになります。  このアクセス許可があると、コードで、インスタンスのプライベート状態を探索したり、変更したりできます。  型に対して適切なアクセス許可が与えられていると同時に、メタデータ内でシリアル化可能として[マークされている](../../../docs/standard/attributes/applying-attributes.md)必要があります。  
+  
+## MethodInfo 型のパラメーター  
+ 特に、信頼されているコードには、<xref:System.Reflection.MethodInfo> パラメーターを受け取るパブリック メンバーを記述しないでください。  このようなメンバーは、悪意のあるコードの攻撃を受けやすい場合があります。  たとえば、信頼性の高いコード内で、<xref:System.Reflection.MethodInfo> パラメーターを受け取るパブリック メンバーの場合を考えてみましょう。  このパブリック メンバーが、渡されたパラメーターに対して間接的に <xref:System.Reflection.MethodBase.Invoke%2A> メソッドを呼び出すとします。  パブリック メンバーが必要なアクセス許可を確認しない場合、セキュリティ システムは呼び出し元が大きな権限を持っていると判断するため、その <xref:System.Reflection.MethodBase.Invoke%2A> メソッド呼び出しは常に成功します。  悪意のあるコードがそのメソッドを直接呼び出すアクセス許可を持っていなくても、パブリック メンバーを呼び出すことによって間接的にこのメソッドを呼び出すことができます。  
+  
+## バージョン情報  
+  
+-   [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、透過的なコードからリフレクションを使用してセキュリティ クリティカルなメンバーにアクセスすることはできません。  
+  
+-   <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグは、[!INCLUDE[net_v20SP1_long](../../../includes/net-v20sp1-long-md.md)] で導入されました。  以前のバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、コードから非パブリック メンバーにアクセスするためにリフレクションを使用するには <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要がありました。  このアクセス許可は、部分的に信頼されるコードには絶対に付与しないでください。  
+  
+-   [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] 以降、リフレクションを使用して非パブリックな型とメンバーに関する情報を取得する場合、アクセス許可が不要になりました。  以前のバージョンでは、<xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要があります。  
+  
+## 参照  
+ <xref:System.Security.Permissions.ReflectionPermissionFlag>   
+ <xref:System.Security.Permissions.ReflectionPermission>   
+ <xref:System.Security.Permissions.SecurityPermission>   
+ [セキュリティの変更点](../../../docs/framework/security/security-changes.md)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)   
+ [リフレクション出力のセキュリティ関連事項](../../../docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md)   
+ [型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)   
+ [属性の適用](../../../docs/standard/attributes/applying-attributes.md)   
+ [カスタム属性へのアクセス](../../../docs/framework/reflection-and-codedom/accessing-custom-attributes.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md b/docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md
new file mode 100644
index 00000000000..c20c5081870
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md
@@ -0,0 +1,163 @@
+---
+title: "リフレクション出力のセキュリティ関連事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "匿名でホストされる動的メソッド [.NET Framework]"
+  - "動的アセンブリ, セキュリティ"
+  - "出力 (動的アセンブリを), セキュリティ"
+  - "出力 (動的アセンブリを), 部分信頼シナリオ"
+  - "部分信頼, 出力 (動的メソッドを)"
+  - "部分的に信頼されるコード"
+  - "リフレクション出力, 部分信頼シナリオ"
+  - "リフレクション出力, セキュリティ"
+ms.assetid: 0f8bf8fa-b993-478f-87ab-1a1a7976d298
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# リフレクション出力のセキュリティ関連事項
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、Microsoft Intermediate Language \(MSIL\) を出力する方法が 3 種類ありますが、それぞれに固有のセキュリティ問題があります。  
+  
+-   [動的アセンブリ](#Dynamic_Assemblies)  
+  
+-   [匿名でホストされる動的メソッド](#Anonymously_Hosted_Dynamic_Methods)  
+  
+-   [既存のアセンブリに関連付けられている動的メソッド](#Dynamic_Methods_Associated_with_Existing_Assemblies)  
+  
+ 動的コードの生成方法に関係なく、生成済みコードを実行するには、生成済みコードで使用される型やメソッドに必要なすべてのアクセス許可が必要です。  
+  
+> [!NOTE]
+>  コードでのリフレクションとコードの出力に必要なアクセス許可は、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のリリースによって異なります。  このトピックの「[バージョン情報](#Version_Information)」を参照してください。  
+  
+<a name="Dynamic_Assemblies"></a>   
+## 動的アセンブリ  
+ 動的アセンブリを作成するには、<xref:System.AppDomain.DefineDynamicAssembly%2A?displayProperty=fullName> メソッドのオーバーロードを使用します。  コンピューター全体のセキュリティ ポリシーが削除されたため、このメソッドのほとんどのオーバーロードは [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では使用されていません \(非推奨\)。  \(「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照\)。 残りのオーバーロードは、信頼レベルに関係なく、任意のコードによって実行できます。  これらのオーバーロードは 2 つのグループに分けられます。1 つは、動的アセンブリの作成時に適用する属性の一覧を指定するグループで、もう 1 つは属性の一覧を指定しないグループです。  アセンブリの透過性モデルを指定しない場合は、アセンブリの作成時に <xref:System.Security.SecurityRulesAttribute> 属性を適用することによって、出力アセンブリから透過性モデルが継承されます。  
+  
+> [!NOTE]
+>  <xref:System.Reflection.Emit.AssemblyBuilder.SetCustomAttribute%2A> メソッドを使用すると、動的アセンブリの作成後に適用する属性は、そのアセンブリがディスクに保存され、メモリに再び読み込まれるまでは有効になりません。  
+  
+ 動的アセンブリのコードからは、参照できる型と他のアセンブリのメンバーのみにアクセスできます。  
+  
+> [!NOTE]
+>  動的アセンブリでは、動的メソッドが非パブリックな型とメンバーにアクセスすることを許可する <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグと <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが使用されません。  
+  
+ 一時動的アセンブリはメモリ内に作成され、ディスクに保存されることがないため、ファイルへのアクセス許可は不要です。  動的アセンブリをディスクに保存するには、<xref:System.Security.Permissions.FileIOPermission> に適切なフラグを指定する必要があります。  
+  
+### 部分信頼コードからの動的アセンブリの生成  
+ インターネット アクセス許可が設定されたアセンブリで一時動的アセンブリを生成し、そのコードを実行するための条件を考えてみましょう。  
+  
+-   動的アセンブリで使用されるのが、パブリック型と他のアセンブリのメンバーのみである。  
+  
+-   その型およびメンバーで必要なアクセス許可が、部分信頼のアセンブリの許可セットに含まれている。  
+  
+-   アセンブリがディスクに保存されていない。  
+  
+-   デバッグ シンボルが生成されていない。  \(`Internet` および `LocalIntranet` のアクセス許可セットに必要なアクセス許可が指定されていない\)  
+  
+<a name="Anonymously_Hosted_Dynamic_Methods"></a>   
+## 匿名でホストされる動的メソッド  
+ 関連付けられる型やモジュールを指定しない 2 つの <xref:System.Reflection.Emit.DynamicMethod> コンストラクター \([DynamicMethod\(String, Type, Type\<xref:System.Reflection.Emit.DynamicMethod.%23ctor%28System.String%2CSystem.Type%2CSystem.Type%5B%5D%29> および [DynamicMethod\(String, Type, Type\<xref:System.Reflection.Emit.DynamicMethod.%23ctor%28System.String%2CSystem.Type%2CSystem.Type%5B%5D%2CSystem.Boolean%29>\) を使用して、匿名でホストされる動的メソッドを作成します。  このコンストラクターにより、システムで指定された完全に信頼される透過的セキュリティ アセンブリに動的メソッドが置かれます。  このコンストラクターの使用や動的メソッドのコード出力のために、特別なアクセス許可は必要ありません。  
+  
+ ただし、匿名でホストされる動的メソッドが作成されるとき、コール スタックがキャプチャされます。  メソッドの作成時に、キャプチャされたコール スタックに対してセキュリティ要求がなされます。  
+  
+> [!NOTE]
+>  概念的には、メソッドの作成中に要求がなされます。  つまり、MSIL 命令が生成されるたびに要求を実行できます。  現在の実装では、<xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%2A?displayProperty=fullName> メソッドが呼び出されたとき \(<xref:System.Reflection.Emit.DynamicMethod.CreateDelegate%2A> を呼び出さずにこのメソッドが呼び出される場合\)、または Just\-In\-Time \(JIT\) コンパイラが呼び出されたときに、すべての要求がなされます。  
+  
+ アプリケーション ドメインで許可されている場合、匿名でホストされる動的メソッドでは、JIT の参照範囲チェックを省略できますが、制限があります。匿名でホストされる動的メソッドによりアクセスされる非パブリックの型とメンバーがアセンブリに含まれ、そのアセンブリの許可セットが、出力元のコール スタックの許可セットに等しいか、または、そのサブセットであることが必要です。  アプリケーション ドメインで <xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが指定されている場合は、この制限付き機能を使って JIT 参照範囲チェックを省略できます。  
+  
+-   メソッドでパブリックな型とメンバーのみを使用する場合は、作成中にアクセス許可は不要です。  
+  
+-   JIT 参照範囲チェックを省略するように指定した場合、メソッドの作成時になされる要求には <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが指定された <xref:System.Security.Permissions.ReflectionPermission> と、アクセスされる非パブリック メンバーを含むアセンブリの許可セットが含まれます。  
+  
+ 非パブリック メンバーの許可セットが考慮されるため、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> によって許可された部分信頼コードでは、信頼されるアセンブリの非パブリック メンバーを実行しても特権を昇格することができません。  
+  
+ 他の出力済みコードと同じように、動的メソッドを実行するには、動的メソッドで使用されるメソッドで必要なアクセス許可がすべて必要になります。  
+  
+ 匿名でホストされる動的メソッドをホストするシステム アセンブリでは、<xref:System.Security.SecurityRuleSet?displayProperty=fullName> 透過性モデルを使用します。これは、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] より前の .NET Framework で使用されていた透過性モデルです。  
+  
+ 詳細については、<xref:System.Reflection.Emit.DynamicMethod> クラスを参照してください。  
+  
+### 部分的に信頼されるコードによる匿名でホストされる動的メソッドの生成  
+ インターネット アクセス許可が設定されたアセンブリで、匿名でホストされる動的メソッドを生成し、それを実行するための条件を考えてみましょう。  
+  
+-   動的メソッドで使用されるのが、パブリックな型とメンバーのみである。  許可セットに <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> が含まれる場合、許可セットが出力元アセンブリの許可セットと同じか、またはそのサブセットであるアセンブリの非パブリックの型とメンバーを使用できます。  
+  
+-   動的メソッドで使用されるすべての型およびメンバーで必要なアクセス許可が、部分信頼のアセンブリの許可セットに含まれている。  
+  
+> [!NOTE]
+>  動的メソッドではデバッグ シンボルがサポートされていません。  
+  
+<a name="Dynamic_Methods_Associated_with_Existing_Assemblies"></a>   
+## 既存のアセンブリに関連付けられている動的メソッド  
+ 動的メソッドに既存アセンブリの型またはモジュールを関連付けるには、関連付ける型またはモジュールを指定する <xref:System.Reflection.Emit.DynamicMethod> コンストラクターのどれかを使用します。  動的メソッドに既存の型またはモジュールを関連付けると、動的メソッドが非パブリックの型とメンバーにアクセスできるようになるため、これらのコンストラクターを呼び出すにはアクセス許可が必要です。  
+  
+-   型に関連付けられる動的メソッドは、その型のすべてのメンバー \(プライベート メンバーを含む\) にアクセスでき、関連付けられた型が含まれるアセンブリ内部のすべての型およびメンバーにアクセスできます。  
+  
+-   モジュールに関連付けられる動的メソッドは、モジュールのすべての `internal` 型およびメンバー \(Visual Basic では `Friend`、共通言語ランタイムのメタデータでは `assembly`\) にアクセスできます。  
+  
+ さらに、JIT コンパイラの参照範囲チェックを省略する機能を指定するコンストラクターを使用できます。  これを使用した場合、アクセス レベルに関係なく、動的メソッドからすべてのアセンブリのすべての型およびメンバーにアクセスできます。  
+  
+ コンストラクターで必要なアクセス許可は、動的メソッドに与えるアクセス許可のレベルに応じて決まります。  
+  
+-   メソッドでパブリックな型とメンバーのみを使用し、それに独自の型や独自のモジュールを関連付ける場合は、アクセス許可が不要です。  
+  
+-   JIT 参照範囲チェックを省略するように指定する場合、コンストラクターでは <xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要があります。  
+  
+-   動的メソッドに別の型を関連付ける場合 \(独自に作成したアセンブリ内の別の型でも\)、コンストラクターでは <xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定し、<xref:System.Security.Permissions.SecurityPermission> に <xref:System.Security.Permissions.SecurityPermissionFlag?displayProperty=fullName> フラグを指定する必要があります。  
+  
+-   動的メソッドに別のアセンブリの型またはモジュールを関連付ける場合、コンストラクターでは 2 つの操作が必要です。それは、<xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定することと、他方のモジュールを含むアセンブリの許可セットを用意することです。  つまり、対象のモジュールの許可セットにあるすべてのアクセス許可に加えて、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> がコール スタックに含まれる必要があります。  
+  
+    > [!NOTE]
+    >  下位互換性を確保するために、対象の許可セットと <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> の両方の要件が満たされなかった場合、コンストラクターでは <xref:System.Security.Permissions.SecurityPermission> に <xref:System.Security.Permissions.SecurityPermissionFlag?displayProperty=fullName> フラグを指定する必要があります。  
+  
+ この一覧の項目は出力アセンブリの許可セットの観点から書かれていますが、要求はコール スタック全体 \(アプリケーション ドメイン境界を含む\) に対してなされることに注意してください。  
+  
+ 詳細については、<xref:System.Reflection.Emit.DynamicMethod> クラスを参照してください。  
+  
+### 部分信頼コードからの動的メソッドの生成  
+  
+> [!NOTE]
+>  部分的に信頼されるコードから動的メソッドを生成する方法として推奨されるのは、[匿名でホストされる動的メソッドを使用する方法です](#Anonymously_Hosted_Dynamic_Methods)。  
+  
+ インターネット アクセス許可が設定されたアセンブリで、動的メソッドを生成し、それを実行するための条件を考えてみましょう。  
+  
+-   動的メソッドにそれを出力するモジュールまたは型が関連付けられているか、その許可セットに <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> が含まれている。さらに、関連付けられているモジュールが含まれているアセンブリの許可セットが出力アセンブリの許可セットと等しいか、そのサブセットである。  
+  
+-   動的メソッドで使用されるのが、パブリックな型とメンバーのみである。  許可セットに <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> が含まれ、関連付けられているモジュールが含まれているアセンブリの許可セットが出力アセンブリの許可セットと等しいか、そのサブセットである場合、その関連モジュールの中で `internal` と指定されている \(Visual Basic では `Friend`、共通言語ランタイム メタデータでは `assembly`\) 型とメンバーを使用できます。  
+  
+-   動的メソッドで使用されるすべての型およびメンバーで必要なアクセス許可が、部分信頼のアセンブリの許可セットに含まれている。  
+  
+-   動的メソッドで JIT 参照範囲チェックを省略しない。  
+  
+> [!NOTE]
+>  動的メソッドではデバッグ シンボルがサポートされていません。  
+  
+<a name="Version_Information"></a>   
+## バージョン情報  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、コンピューター全体のセキュリティ ポリシーが削除され、透過的セキュリティが既定の適用機構になりました。  「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+ [!INCLUDE[net_v20SP1_long](../../../includes/net-v20sp1-long-md.md)] 以降では、動的アセンブリと動的メソッドを出力する際に、<xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要がなくなりました。  このフラグは、それ以前のすべてのバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では必要となります。  
+  
+> [!NOTE]
+>  `FullTrust` および `LocalIntranet` の名前付きアクセス許可セットでは、既定で <xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが指定されますが、`Internet` アクセス許可セットでは指定されません。  そのため、以前のバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、<xref:System.Security.Permissions.ReflectionPermissionFlag> に対して <xref:System.Security.PermissionSet.Assert%2A> を実行する場合にのみ、インターネット アクセス許可でライブラリを使用できます。  このようなライブラリでは、コーディング エラーがあるとセキュリティ ホールが発生するおそれがあるため、セキュリティを慎重に確認する必要があります。  コードの生成は本質的に特権を必要とする操作ではないため、[!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] はセキュリティ確認要求を発行せずに部分信頼シナリオでコードを出力できます。  これは、生成されたコードには、コードを出力したアセンブリと同等以下のアクセス許可しかないことを意味します。  これにより、コードを出力するライブラリは透過的セキュリティになるため、<xref:System.Security.Permissions.ReflectionPermissionFlag> を要求する必要がなくなります。そのため、安全なライブラリを簡単に作成できるようになります。  
+  
+ さらに、[!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] では部分的に信頼される動的メソッドの非パブリックの型およびメンバーにアクセスできるように、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが導入されています。  以前のバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、動的メソッドで非パブリックの型およびメンバーにアクセスするには <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが必要でした。これは、部分信頼のコードには付与されないアクセス許可です。  
+  
+ 最終的に、[!INCLUDE[net_v20SP1_short](../../../includes/net-v20sp1-short-md.md)] では、匿名でホストされるメソッドが導入されました。  
+  
+### 型およびメンバーの情報の取得  
+ [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] 以降から、非パブリックな型とメンバーに関する情報を取得する際にアクセス許可は不要になりました。  動的メソッドを出力するために必要な情報を取得するには、リフレクションを使用します。  たとえば、<xref:System.Reflection.MethodInfo> オブジェクトを使用してメソッド呼び出しを出力します。  以前のバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、<xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要があります。  詳細については、「[リフレクションに関するセキュリティ上の考慮事項](../../../docs/framework/reflection-and-codedom/security-considerations-for-reflection.md)」を参照してください。  
+  
+## 参照  
+ [リフレクションに関するセキュリティ上の考慮事項](../../../docs/framework/reflection-and-codedom/security-considerations-for-reflection.md)   
+ [動的メソッドおよびアセンブリの出力](../../../docs/framework/reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md b/docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md
new file mode 100644
index 00000000000..7c2b460ccf5
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/specifying-fully-qualified-type-names.md
@@ -0,0 +1,157 @@
+---
+title: "完全修飾型名の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 名前"
+  - "Backus-Naur form"
+  - "BNF"
+  - "完全修飾型名"
+  - "IDENTIFIER"
+  - "言語, BNF 文法"
+  - "名前 [.NET Framework], アセンブリ"
+  - "名前 [.NET Framework], 完全修飾型名"
+  - "リフレクション, 完全修飾型名"
+  - "特殊文字"
+  - "トークン"
+  - "型名"
+ms.assetid: d90b1e39-9115-4f2a-81c0-05e7e74e5580
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 完全修飾型名の指定
+さまざまなリフレクション操作に対して有効な入力を行うには、型名を指定する必要があります。  完全限定型名は、アセンブリ名指定、名前空間指定、および型名で構成されます。  型名指定は、<xref:System.Type.GetType%2A?displayProperty=fullName>、<xref:System.Reflection.Module.GetType%2A?displayProperty=fullName>、<xref:System.Reflection.Emit.ModuleBuilder.GetType%2A?displayProperty=fullName>、<xref:System.Reflection.Assembly.GetType%2A?displayProperty=fullName> などのメソッドで使用されます。  
+  
+## 型名の Backus\-Naur Form 文法  
+ Backus\-Naur form \(BNF\) は、公式言語の構文を定義します。  有効な入力がどのように認識されるかを説明する BNF 構文規則の表を次に示します。  必須要素 \(それ以上省略できない要素\) は、すべて英大文字で示します。  必須ではない要素 \(省略可能な要素\) は、大文字と小文字を組み合わせた文字列、または単一引用符で囲んだ文字列で示します。ただし、単一引用符 \('\) はその構文自体の一部ではありません  パイプ文字 \(&#124;\) は、サブ規則を持つ規則を表します。  
+  
+|完全限定型名の BNF 文法|  
+|--------------------|  
+|TypeSpec                          :\=   ReferenceTypeSpec<br /><br /> &#124;     SimpleTypeSpec|  
+|ReferenceTypeSpec: SimpleTypeSpec '&\= 「|  
+|SimpleTypeSpec                :\=   PointerTypeSpec<br /><br /> &#124;     ArrayTypeSpec<br /><br /> &#124;     TypeName|  
+|PointerTypeSpec                :\=   SimpleTypeSpec '\*'|  
+|ArrayTypeSpec                  :\=   SimpleTypeSpec '\[ReflectionDimension\]'<br /><br /> &#124;     SimpleTypeSpec '\[ReflectionEmitDimension\]'|  
+|ReflectionDimension           :\=   '\*'<br /><br /> &#124;     ReflectionDimension ',' ReflectionDimension<br /><br /> &#124;     NOTOKEN|  
+|ReflectionEmitDimension    :\=   '\*'<br /><br /> &#124;     Number '..'数値<br /><br /> &#124;     Number '…'<br /><br /> &#124;     ReflectionDimension ',' ReflectionDimension<br /><br /> &#124;     NOTOKEN|  
+|Number                            :\=   \[0\-9\]\+|  
+|TypeName                         :\=   NamespaceTypeName<br /><br /> &#124;     NamespaceTypeName ',' AssemblyNameSpec|  
+|NamespaceTypeName        :\=   NestedTypeName<br /><br /> &#124;     NamespaceSpec '.'NestedTypeName|  
+|NestedTypeName               :\=   IDENTIFIER<br /><br /> &#124;     NestedTypeName '\+' IDENTIFIER|  
+|NamespaceSpec                 :\=   IDENTIFIER<br /><br /> &#124;     NamespaceSpec '.'IDENTIFIER|  
+|AssemblyNameSpec           :\=   IDENTIFIER<br /><br /> &#124;     IDENTIFIER ',' AssemblyProperties|  
+|AssemblyProperties            :\=   AssemblyProperty<br /><br /> &#124;     AssemblyProperties ',' AssemblyProperty|  
+|AssemblyProperty              :\=   AssemblyPropertyName '\=' AssemblyPropertyValue|  
+  
+## 特殊文字の指定  
+ 型名の IDENTIFIER は、言語の規則によって決定される任意の有効な名前です。  
+  
+ IDENTIFIER の一部として使用される次のトークンを区切るには、エスケープ文字として円記号 \(\\\) を使用します。  
+  
+|トークン|説明|  
+|----------|--------|  
+|\\,|アセンブリの区切り記号|  
+|\\\+|入れ子にされた型の区切り記号|  
+|\\&|参照型|  
+|\\\*|ポインター型|  
+|\\\[|配列次元の区切り記号|  
+|\\\]|配列次元の区切り記号|  
+|\\.|配列指定にピリオドが使用されているときだけ、ピリオドの前に円記号を使用します。  NamespaceSpec 内のピリオドには、円記号は付けません。|  
+|\\\\|リテラル文字列として使用する円記号|  
+  
+ AssemblyNameSpec を除くすべての TypeSpec コンポーネントで、スペースに意味があることに注意してください。  AssemblyNameSpec では、区切り記号 ',' の前のスペースには意味がありますが、区切り記号 ',' 後のスペースは無視されます。  
+  
+ <xref:System.Type.FullName%2A?displayProperty=fullName> などのリフレクション クラスは、分解された名前を返すため、返された名前を `MyType.GetType(myType.FullName)` のように、<xref:System.Type.GetType%2A> の呼び出しで使用できます。  
+  
+ たとえば、型の完全限定名を `Ozzy.OutBack.Kangaroo+Wallaby,MyAssembly` のように記述できます。  
+  
+ 名前空間が `Ozzy.Out+Back` の場合は、プラス記号の前に円記号が必要です。  円記号がない場合、パーサーは、プラス記号を入れ子になった区切り記号と解釈します。  リフレクションでは、この文字列は、`Ozzy.Out\+Back.Kangaroo+Wallaby,MyAssembly` として出力されます。  
+  
+## アセンブリ名の指定  
+ アセンブリ名指定で最小限必要な情報は、文字列のアセンブリ名 \(IDENTIFIER\) です。  次の表で示すように、IDENTIFIER の後に、プロパティと値のペアをコンマで区切ったリストを記述できます。  IDENTIFIER の名前付けは、ファイル命名規則に従って行う必要があります。  IDENTIFIER は、大文字\/小文字を区別しません。  
+  
+|プロパティ名|説明|使用できる値|  
+|------------|--------|------------|  
+|**Version**|アセンブリのバージョン番号|*Major.Minor.Build.Revision*。ここで、*Major*、*Minor*、*Build*、および *Revision* は 0 ～ 65535 の整数を表します。|  
+|**PublicKey**|完全公開キー。|16 進形式の文字列値の完全公開キー。  プライベート アセンブリを明示的に示すには、null 参照 \(Visual Basic では **Nothing**\) を指定します。|  
+|**PublicKeyToken**|公開キー トークン \(完全公開キーの 8 バイト ハッシュ\)。|16 進形式の文字列値の公開キー トークン。  プライベート アセンブリを明示的に示すには、null 参照 \(Visual Basic では **Nothing**\) を指定します。|  
+|**カルチャ**|アセンブリのカルチャ設定。|RFC\-1766 形式のアセンブリのカルチャ設定。言語に依存しないアセンブリの場合は "neutral"\(非サテライト\)。|  
+|**Custom**|カスタムのバイナリ ラージ オブジェクト \(BLOB\)。  これは、現在は[ネイティブ イメージ ジェネレーター \(Ngen\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) で生成されたアセンブリだけで使用されています。|インストールするアセンブリがネイティブ イメージなので、ネイティブ イメージ キャッシュにインストールすることをアセンブリ キャッシュに通知するために、ネイティブ イメージ ジェネレーターが使用するカスタム文字列。  zap 文字列とも呼ばれます。|  
+  
+ 既定のカルチャ設定を持つ簡易名のアセンブリの **AssemblyName** の例を次に示します。  
+  
+```csharp  
+com.microsoft.crypto, Culture=""   
+```  
+  
+ カルチャ設定 "en" の厳密な名前のアセンブリに対する、完全指定の参照の例を次に示します。  
+  
+```csharp  
+com.microsoft.crypto, Culture=en, PublicKeyToken=a5d015c7d5a0b012,  
+    Version=1.0.0.0   
+```  
+  
+ 厳密または単純な名前のアセンブリで条件を満たすことができる、部分指定の **AssemblyName** の例を次に示します。  
+  
+```csharp  
+com.microsoft.crypto  
+com.microsoft.crypto, Culture=""  
+com.microsoft.crypto, Culture=en   
+```  
+  
+ 簡易名のアセンブリで条件を満たす必要がある、部分指定の **AssemblyName** の例を次に示します。  
+  
+```csharp  
+com.microsoft.crypto, Culture="", PublicKeyToken=null   
+com.microsoft.crypto, Culture=en, PublicKeyToken=null  
+```  
+  
+ 厳密な名前のアセンブリで条件を満たす必要がある、部分指定の **AssemblyName** の例を次に示します。  
+  
+```csharp  
+com.microsoft.crypto, Culture="", PublicKeyToken=a5d015c7d5a0b012  
+com.microsoft.crypto, Culture=en, PublicKeyToken=a5d015c7d5a0b012,  
+    Version=1.0.0.0  
+```  
+  
+## ポインターの指定  
+ SimpleTypeSpec\* は、アンマネージ ポインターを表します。  たとえば、MyType 型へのポインターを取得するには、`Type.GetType("MyType*")` を使用します。  MyType 型へのポインターへのポインターを取得するには、`Type.GetType("MyType**")` を使用します。  
+  
+## 参照の指定  
+ SimpleTypeSpec は & マネージ ポインターまたは参照を表します。  たとえば、MyType 型への参照を取得するには、`Type.GetType("MyType &")` を使用します。  ポインターとは異なり、参照は、1 レベルに限定されることに注意してください。  
+  
+## 配列の指定  
+ BNF 文法では、ReflectionEmitDimension は、<xref:System.Reflection.Emit.ModuleBuilder.GetType%2A?displayProperty=fullName> を使用して取得した不完全な型定義だけに適用されます。  不完全な型定義は、[Reflection.Emit](frlrfSystemReflectionEmit) を使用して構築された <xref:System.Reflection.Emit.TypeBuilder> オブジェクトのうち、<xref:System.Reflection.Emit.TypeBuilder.CreateType%2A?displayProperty=fullName> が呼び出されていないオブジェクトです。  ReflectionDimension を使用すると、完成した任意の型定義、つまり、読み込まれている型を取得できます。  
+  
+ リフレクションでは、配列のランクを指定することにより、配列にアクセスします。  
+  
+-   `Type.GetType("MyArray[]")` は、下限 0 の 1 次元配列を取得します。  
+  
+-   `Type.GetType("MyArray[*]")` は、下限が不明の 1 次元配列を取得します。  
+  
+-   `Type.GetType("MyArray[][]")` は、2 次元配列の配列を取得します。  
+  
+-   `Type.GetType("MyArray[*,*]")` および `Type.GetType("MyArray[,]")` は、下限が不明の四角形の 2 次元配列を取得します。  
+  
+ ランタイムから見ると、`MyArray[] != MyArray[*]` ですが、多次元配列の場合は、この 2 つの表記は同等です。  つまり、`Type.GetType("MyArray [,]") == Type.GetType("MyArray[*,*]")` は **true** と評価されます。  
+  
+ **ModuleBuilder.GetType** では、`MyArray[0..5]` は、サイズが 6 で、下限 0 の 1 次元配列を示します。 `MyArray[4…]` は、サイズが不明で、下限 4 の 1 次元配列を示します。  
+  
+## 参照  
+ <xref:System.Reflection.AssemblyName>   
+ <xref:System.Reflection.Emit.ModuleBuilder>   
+ <xref:System.Reflection.Emit.TypeBuilder>   
+ <xref:System.Type.FullName%2A?displayProperty=fullName>   
+ <xref:System.Type.GetType%2A?displayProperty=fullName>   
+ <xref:System.Type.AssemblyQualifiedName%2A?displayProperty=fullName>   
+ [型情報の表示](../../../docs/framework/reflection-and-codedom/viewing-type-information.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/using-the-codedom.md b/docs/framework/reflection-and-codedom/using-the-codedom.md
new file mode 100644
index 00000000000..4a51ac2828b
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/using-the-codedom.md
@@ -0,0 +1,131 @@
+---
+title: "CodeDOM の使用方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コード コンパイラ"
+  - "Code Document Object Model"
+  - "Code Document Object Model, グラフ"
+  - "コード ジェネレーター"
+  - "CodeDOM"
+  - "CodeDOM, グラフ"
+  - "動的コンパイル"
+  - "動的表現 (ソース コードの)"
+  - "グラフ化 (CodeDOM による)"
+  - "名前空間 [.NET Framework], CodeDOM"
+  - "ソース コード モデル"
+  - "テンプレートを使ったコード生成"
+  - "型, CodeDOM"
+ms.assetid: 0444ddf3-c3f6-44ed-a999-f710d9c3e0cf
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# CodeDOM の使用方法
+CodeDOM には一般的なさまざま種類のソース コード要素を表す型が用意されています。  オブジェクト グラフをアセンブルする CodeDOM 要素を使用すると、ソース コード モデルを構築するプログラムをデザインできます。  このオブジェクト グラフは、サポートされているプログラミング言語用の CodeDOM コード ジェネレーターを使用して、ソース コードとしてレンダリングできます。  また、CodeDOM を使用して、ソース コードをバイナリ アセンブリにコンパイルすることもできます。  
+  
+ CodeDOM の一般的な使用方法の例は次のとおりです。  
+  
+-   テンプレートを使ったコード生成。ASP.NET、XML Web サービス クライアント プロキシ、コード ウィザード、デザイナー、またはその他のコード出力機構のためのコードを生成します。  
+  
+-   動的コンパイル。1 つ以上の言語でのコードのコンパイルをサポートします。  
+  
+## CodeDOM グラフの構築  
+ <xref:System.CodeDom> 名前空間には、言語の構文に依存しない、ソース コードの論理構造を表すクラスが用意されています。  
+  
+### CodeDOM グラフの構造  
+ CodeDOM グラフの構造はコンテナーのツリーに似ています。  コンパイル可能な CodeDOM グラフの最上位のコンテナー、つまりルートのコンテナーは <xref:System.CodeDom.CodeCompileUnit> です。  ソース コード モデルの各要素は、CodeDOM グラフ内の <xref:System.CodeDom.CodeObject> のプロパティを通じて CodeDOM グラフにリンクされている必要があります。  
+  
+### サンプルの Hello World プログラム用ソース コード モデルの構築  
+ 単純な Hello World アプリケーションのコードを表す CodeDOM オブジェクト グラフを構築する手順の例を次に示します。  このコード サンプルのソース コード例全体については、「<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName>」を参照してください。  
+  
+#### コンパイル単位の作成  
+ CodeDOM は、<xref:System.CodeDom.CodeCompileUnit> と呼ばれるオブジェクトを定義します。このオブジェクトでは、コンパイルするソース コードをモデル化した CodeDOM オブジェクト グラフを参照できます。  **CodeCompileUnit** には、属性、名前空間、およびアセンブリへの参照を格納するためのプロパティが用意されています。  
+  
+ <xref:System.CodeDom.Compiler.CodeDomProvider> クラスから派生する CodeDom プロバイダーには、**CodeCompileUnit** が参照するオブジェクト グラフを処理するメソッドが含まれています。  
+  
+ 簡単なアプリケーション用のオブジェクト グラフを作成するには、ソース コード モデルをアセンブルし、生成されたオブジェクト グラフを **CodeCompileUnit** から参照する必要があります。  
+  
+ 新しいコンパイル単位を作成するには、次の例に示す構文を使います。  
+  
+ [!code-cpp[CodeDomExample#12](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#12)]
+ [!code-csharp[CodeDomExample#12](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#12)]
+ [!code-vb[CodeDomExample#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#12)]  
+  
+ <xref:System.CodeDom.CodeSnippetCompileUnit> には、既に対象言語で記述されているソース コードのセクションを格納できますが、この単位は別の言語にはレンダリングできません。  
+  
+#### 名前空間の定義  
+ 名前空間を定義するには、<xref:System.CodeDom.CodeNamespace> を作成してから、適切なコンストラクターを使用するか **Name** プロパティを設定することにより、定義する名前空間の名前を割り当てます。  
+  
+ [!code-cpp[CodeDomExample#13](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#13)]
+ [!code-csharp[CodeDomExample#13](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#13)]
+ [!code-vb[CodeDomExample#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#13)]  
+  
+#### 名前空間のインポート  
+ 名前空間のインポート ディレクティブを名前空間に追加するには、インポートする名前空間を示す <xref:System.CodeDom.CodeNamespaceImport> を **CodeNamespace.Imports** コレクションに追加します。  
+  
+ **System** 名前空間のインポートを、`samples` という名前の **CodeNamespace** の **Imports** コレクションに追加するコードを次に示します。  
+  
+ [!code-cpp[CodeDomExample#14](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#14)]
+ [!code-csharp[CodeDomExample#14](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#14)]
+ [!code-vb[CodeDomExample#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#14)]  
+  
+#### コード要素のオブジェクト グラフへのリンク  
+ CodeDOM グラフを形成するすべてのコード要素は、CodeDOM グラフのルート オブジェクトのプロパティから直接参照される要素間の一連の参照によって、ツリーのルート要素である <xref:System.CodeDom.CodeCompileUnit> にリンクする必要があります。  オブジェクトをコンテナー オブジェクトのプロパティに設定し、コンテナー オブジェクトからの参照を確立します。  
+  
+ `samples` **CodeNamespace** をルートの **CodeCompileUnit** の **Namespaces** コレクション プロパティに追加するステートメントを次に示します。  
+  
+ [!code-cpp[CodeDomExample#15](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#15)]
+ [!code-csharp[CodeDomExample#15](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#15)]
+ [!code-vb[CodeDomExample#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#15)]  
+  
+#### 型の定義  
+ CodeDOM を使ってクラス、構造体、インターフェイス、または列挙体を宣言するには、新しい <xref:System.CodeDom.CodeTypeDeclaration> を作成し、名前を割り当てます。  このために、**Name** プロパティを設定するコンストラクターのオーバーロードを使用する例を次に示します。  
+  
+ [!code-cpp[CodeDomExample#16](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#16)]
+ [!code-csharp[CodeDomExample#16](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#16)]
+ [!code-vb[CodeDomExample#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#16)]  
+  
+ 名前空間に型を追加するには、名前空間に追加する型を表す <xref:System.CodeDom.CodeTypeDeclaration> を、**CodeNamespace** の **Types** コレクションに追加します。  
+  
+ `class1` という名前のクラスを `samples` という名前の **CodeNamespace** に追加する例を次に示します。  
+  
+ [!code-cpp[CodeDomExample#17](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#17)]
+ [!code-csharp[CodeDomExample#17](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#17)]
+ [!code-vb[CodeDomExample#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#17)]  
+  
+#### クラスへのクラス メンバーの追加  
+ <xref:System.CodeDom> 名前空間には、クラス メンバーを表すために使用できるさまざまな要素が用意されています。  各クラス メンバーは、<xref:System.CodeDom.CodeTypeDeclaration> の **Members** コレクションに追加できます。  
+  
+#### 実行可能プログラムのコード エントリ ポイント メソッドの定義  
+ 実行可能プログラムのコードを記述する場合は、プログラムの実行を開始するメソッドを表す <xref:System.CodeDom.CodeEntryPointMethod> を作成して、プログラムのエントリ ポイントを指定する必要があります。  
+  
+ "Hello World\!" と出力するための **System.Console.WriteLine** を呼び出す <xref:System.CodeDom.CodeMethodInvokeExpression> を格納しているエントリ ポイント メソッドを定義する例を次に示します。  
+  
+ [!code-cpp[CodeDomExample#18](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#18)]
+ [!code-csharp[CodeDomExample#18](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#18)]
+ [!code-vb[CodeDomExample#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#18)]  
+  
+ `Start` という名前のエントリ ポイント メソッドを `class1` の **Members** コレクションに追加するステートメントを次に示します。  
+  
+ [!code-cpp[CodeDomExample#19](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeDomExample/CPP/source2.cpp#19)]
+ [!code-csharp[CodeDomExample#19](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeDomExample/CS/source2.cs#19)]
+ [!code-vb[CodeDomExample#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeDomExample/VB/source2.vb#19)]  
+  
+ これで、`compileUnit` という名前の <xref:System.CodeDom.CodeCompileUnit> に、簡単な Hello World プログラムの CodeDOM グラフが追加されました。  CodeDOM グラフからのコードの生成およびコンパイルについては、「[CodeDOM グラフからのソース コードの生成およびプログラムのコンパイル](../../../docs/framework/reflection-and-codedom/generating-and-compiling-source-code-from-a-codedom-graph.md)」を参照してください。  
+  
+### CodeDOM グラフの構築に関する詳細  
+ CodeDOM では、共通言語ランタイムをサポートするプログラミング言語の一般的なさまざまな種類のコード要素をサポートします。  CodeDOM は、プログラミング言語のすべての機能を表す要素を提供するようにはデザインされていません。  CodeDOM 要素で簡単に表すことができないコードは、<xref:System.CodeDom.CodeSnippetExpression>、<xref:System.CodeDom.CodeSnippetStatement>、<xref:System.CodeDom.CodeSnippetTypeMember>、または <xref:System.CodeDom.CodeSnippetCompileUnit> にカプセル化できます。  ただし、CodeDOM ではコードを自動的に他の言語に変換することはできません。  
+  
+ CodeDOM のそれぞれの型については、<xref:System.CodeDom> 名前空間の説明を参照してください。  
+  
+ 特定の種類のコード要素を表す CodeDOM 要素を探すための一覧については、「[CodeDOM Quick Reference](http://msdn.microsoft.com/ja-jp/c77b8bfd-0a32-4e36-b59a-4f687f32c524)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/viewing-type-information.md b/docs/framework/reflection-and-codedom/viewing-type-information.md
new file mode 100644
index 00000000000..1f21701ac24
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/viewing-type-information.md
@@ -0,0 +1,96 @@
+---
+title: "型情報の表示 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "リフレクション, 表示 (型情報を)"
+  - "Type オブジェクト"
+  - "型, 表示 (型情報を)"
+  - "表示 (型情報を)"
+ms.assetid: 7e7303a9-4064-4738-b4e7-b75974ed70d2
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 型情報の表示
+<xref:System.Type?displayProperty=fullName> クラスは、リフレクションの中枢です。  リフレクションが **Type** の作成を要求すると、共通言語ランタイムは、読み込まれた型に対して **Type** オブジェクトを作成します。  **Type** オブジェクトのメソッド、フィールド、プロパティ、および入れ子クラスを使用すると、その型についてのすべての情報を調べることができます。  
+  
+ まだ読み込まれていないアセンブリから **Type** オブジェクトを取得するには、<xref:System.Reflection.Assembly.GetType%2A?displayProperty=fullName> または <xref:System.Reflection.Assembly.GetTypes%2A?displayProperty=fullName> を使用し、必要な型の名前を 1 つ以上渡します。  既に読み込まれているアプリケーションから **Type** オブジェクトを取得するには、<xref:System.Type.GetType%2A?displayProperty=fullName> を使用します。  モジュールの **Type** オブジェクトを取得するには、<xref:System.Reflection.Module.GetType%2A?displayProperty=fullName> および <xref:System.Reflection.Module.GetTypes%2A?displayProperty=fullName> を使用します。  
+  
+> [!NOTE]
+>  ジェネリック型およびメソッドを調べたり操作したりする場合は、「[リフレクションとジェネリック型](../../../docs/framework/reflection-and-codedom/reflection-and-generic-types.md)」および「[方法 : リフレクションを使用してジェネリック型をチェックおよびインスタンス化する](../../../docs/framework/reflection-and-codedom/how-to-examine-and-instantiate-generic-types-with-reflection.md)」を参照してください。  
+  
+ アセンブリの <xref:System.Reflection.Assembly> オブジェクトおよびモジュールを取得するための構文を示すコード例は、次のとおりです。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source5.cpp#6)]
+ [!code-csharp[Conceptual.Types.ViewInfo#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source5.cs#6)]
+ [!code-vb[Conceptual.Types.ViewInfo#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source5.vb#6)]  
+  
+ 既に読み込まれているアセンブリから **Type** オブジェクトを取得する例を次に示します。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#7](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source5.cpp#7)]
+ [!code-csharp[Conceptual.Types.ViewInfo#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source5.cs#7)]
+ [!code-vb[Conceptual.Types.ViewInfo#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source5.vb#7)]  
+  
+ **Type** を取得した後は、さまざまな方法で、この型のメンバーに関する情報を探索できます。  たとえば、現在の型の各メンバーが記述されている <xref:System.Reflection.MemberInfo> オブジェクトの配列を取得する <xref:System.Type.GetMembers%2A?displayProperty=fullName> メソッドを呼び出すと、その型のすべてのメンバーについて調べることができます。  
+  
+ また、**Type** クラスのメソッドを使用し、名前を指定することで、1 つ以上のコンストラクター、メソッド、イベント、フィールド、またはプロパティについての情報を取得できます。  たとえば、<xref:System.Type.GetConstructor%2A?displayProperty=fullName> は、現在のクラスの特定のコンストラクターをカプセル化します。  
+  
+ **Type** が存在する場合は、<xref:System.Type.Module%2A?displayProperty=fullName> プロパティを使用して、その型を含んでいるモジュールをカプセル化するオブジェクトを取得できます。  そのモジュールを含んでいるアセンブリをカプセル化するオブジェクトを検索するには、<xref:System.Reflection.Module.Assembly%2A?displayProperty=fullName> プロパティを使用します。  <xref:System.Type.Assembly%2A?displayProperty=fullName> プロパティを使用すると、型をカプセル化するアセンブリを直接取得できます。  
+  
+## System.Type および ConstructorInfo  
+ 特定のクラスのコンストラクター \(ここでは <xref:System.String> クラスのコンストラクター\) を一覧する方法を次の例で示します。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source1.cpp#1)]
+ [!code-csharp[Conceptual.Types.ViewInfo#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source1.cs#1)]
+ [!code-vb[Conceptual.Types.ViewInfo#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source1.vb#1)]  
+  
+## MemberInfo、MethodInfo、FieldInfo、および PropertyInfo  
+ <xref:System.Reflection.MemberInfo>、<xref:System.Reflection.MethodInfo>、<xref:System.Reflection.FieldInfo>、または <xref:System.Reflection.PropertyInfo> の各オブジェクトを使用して、型のメソッド、プロパティ、イベント、およびフィールドについての情報を取得します。  
+  
+ **MemberInfo** を使用して **System.IO.File** クラスのメンバー数を一覧し、[System.Type.IsPublic](frlrfSystemTypeClassIsPublicTopic) プロパティを使用して、このクラスの参照範囲を確認する例を次に示します。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source2.cpp#2)]
+ [!code-csharp[Conceptual.Types.ViewInfo#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source2.cs#2)]
+ [!code-vb[Conceptual.Types.ViewInfo#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source2.vb#2)]  
+  
+ 特定のメンバーの型を調べる例を次に示します。  **MemberInfo** クラスのメンバーに対してリフレクションを実行し、そのメンバーの型を一覧します。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source3.cpp#3)]
+ [!code-csharp[Conceptual.Types.ViewInfo#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source3.cs#3)]
+ [!code-vb[Conceptual.Types.ViewInfo#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source3.vb#3)]  
+  
+ すべてのリフレクション **\*Info** クラスを <xref:System.Reflection.BindingFlags> と共に使用して、指定したクラスのすべてのメンバー \(コンストラクター、フィールド、プロパティ、イベント、およびメソッド\) を一覧し、メンバーを静的カテゴリとインスタンス カテゴリに分割する例を次に示します。  
+  
+ [!code-cpp[Conceptual.Types.ViewInfo#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.types.viewinfo/cpp/source4.cpp#4)]
+ [!code-csharp[Conceptual.Types.ViewInfo#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.viewinfo/cs/source4.cs#4)]
+ [!code-vb[Conceptual.Types.ViewInfo#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.viewinfo/vb/source4.vb#4)]  
+  
+## 参照  
+ <xref:System.Reflection.BindingFlags>   
+ <xref:System.Reflection.Assembly.GetType%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Assembly.GetTypes%2A?displayProperty=fullName>   
+ <xref:System.Type.GetType%2A?displayProperty=fullName>   
+ <xref:System.Type.GetMembers%2A?displayProperty=fullName>   
+ <xref:System.Type.GetFields%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Module.GetType%2A?displayProperty=fullName>   
+ <xref:System.Reflection.Module.GetTypes%2A?displayProperty=fullName>   
+ <xref:System.Reflection.MemberInfo>   
+ <xref:System.Reflection.ConstructorInfo>   
+ <xref:System.Reflection.MethodInfo>   
+ <xref:System.Reflection.FieldInfo>   
+ <xref:System.Reflection.EventInfo>   
+ <xref:System.Reflection.ParameterInfo>   
+ [リフレクションとジェネリック型](../../../docs/framework/reflection-and-codedom/reflection-and-generic-types.md)
\ No newline at end of file
diff --git a/docs/framework/reflection-and-codedom/walkthrough-emitting-code-in-partial-trust-scenarios.md b/docs/framework/reflection-and-codedom/walkthrough-emitting-code-in-partial-trust-scenarios.md
new file mode 100644
index 00000000000..23ac56519f3
--- /dev/null
+++ b/docs/framework/reflection-and-codedom/walkthrough-emitting-code-in-partial-trust-scenarios.md
@@ -0,0 +1,218 @@
+---
+title: "チュートリアル: 部分信頼シナリオにおけるコード出力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "匿名でホストされる動的メソッド [.NET Framework]"
+  - "動的メソッド"
+  - "出力 (動的アセンブリを), 部分信頼シナリオ"
+  - "部分信頼, 出力 (動的メソッドを)"
+  - "部分信頼, リフレクション"
+  - "リフレクション出力, 匿名でホストされる動的メソッド"
+  - "リフレクション出力, 動的メソッド"
+  - "リフレクション出力, 部分信頼シナリオ"
+ms.assetid: c45be261-2a9d-4c4e-9bd6-27f0931b7d25
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# チュートリアル: 部分信頼シナリオにおけるコード出力
+リフレクション出力は、完全信頼または部分信頼において同じ API セットを使用しますが、部分的に信頼されるコードでは実行する機能によって特定のアクセス許可が必要になります。  リフレクション出力には、匿名でホストされる動的メソッドという機能があります。この機能は、透過的セキュリティ アセンブリによって部分信頼で使用されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] 以前では、コード出力を行うには <xref:System.Security.Permissions.ReflectionPermission> に <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを指定する必要がありました。  このアクセス許可は、既定で `FullTrust` および `Intranet` の名前付きアクセス許可セットには含まれますが、`Internet` アクセス許可セットには含まれません。  したがって、ライブラリを部分信頼で使用するには、<xref:System.Security.SecurityCriticalAttribute> 属性を設定し、<xref:System.Security.Permissions.ReflectionPermissionFlag> に対して <xref:System.Security.PermissionSet.Assert%2A> メソッドを実行する必要がありました。  このようなライブラリでは、コーディング エラーがあるとセキュリティ ホールが発生するおそれがあるため、セキュリティを慎重に確認する必要があります。  コードの生成は本質的に特権を必要とする操作ではないため、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] はセキュリティ確認要求を発行せずに部分信頼シナリオでコードを出力できます。  これは、生成されたコードには、コードを出力したアセンブリと同等以下のアクセス許可しかないことを意味します。  これにより、コードを出力するライブラリは透過的セキュリティになるため、<xref:System.Security.Permissions.ReflectionPermissionFlag> を要求する必要がなくなります。つまり、安全なライブラリを記述するためにセキュリティを入念に確認する必要がなくなります。  
+  
+ このチュートリアルでは、次の作業について説明します。  
+  
+-   [部分的に信頼されたコードのテスト用に単純なサンドボックスを設定する](#Setting_up)  
+  
+    > [!IMPORTANT]
+    >  これは、部分信頼でコードを試す簡単な方法です。  実際に信頼できない場所から取得されたコードを実行する方法については、「[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)」を参照してください。  
+  
+-   [部分的に信頼されたアプリケーション ドメインでコードを実行する](#Running_code)  
+  
+-   [匿名でホストされる動的メソッドを使用して部分信頼でコードを出力し実行する](#Using_methods)  
+  
+ 部分信頼シナリオでのコード出力の詳細については、「[リフレクション出力のセキュリティ関連事項](../../../docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md)」を参照してください。  
+  
+ ここで説明する手順に示すコードの完全な一覧については、このチュートリアルの最後の「[例](#Example)」を参照してください。  
+  
+<a name="Setting_up"></a>   
+## 部分的に信頼された場所を設定する  
+ 次の 2 つの手順では、部分信頼でテストできるコードの場所を設定する方法を説明します。  
+  
+-   最初の手順では、サンドボックス化されたアプリケーション ドメインを作成する方法について説明します。このドメインでは、インターネット アクセス許可がコードに付与されます。  
+  
+-   2 番目の手順では、部分的に信頼されたアプリケーション ドメインに対し、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグを設定して <xref:System.Security.Permissions.ReflectionPermission> を追加する方法を説明します。これにより、信頼レベルが同等以下のアセンブリでプライベート データにアクセスできるようになります。  
+  
+### サンドボックス化されたアプリケーション ドメインを作成する  
+ 部分信頼でアセンブリを実行するアプリケーション ドメインを作成するには、[AppDomain.CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29?displayProperty=fullName> メソッド オーバーロードを使用して、アセンブリに付与するアクセス許可セットを指定する必要があります。  許可セットを指定するための最も簡単な方法として、セキュリティ ポリシーから名前付きアクセス許可セットを取得する方法があります。  
+  
+ 次の手順では、部分信頼でコードを実行するサンドボックス化されたアプリケーション ドメインを作成し、出力されるコードが、パブリック型のパブリック メンバーにのみアクセスできるというシナリオをテストします。  後続の手順では、<xref:System.Security.Permissions.ReflectionPermissionFlag> を追加する方法を説明し、出力されるコードが、同等以下のアクセス許可を付与されたアセンブリ内にある非パブリックな型とメンバーにアクセスできるというシナリオをテストします。  
+  
+##### 部分信頼でアプリケーション ドメインを作成するには  
+  
+1.  サンドボックス化されたアプリケーション ドメイン内のアセンブリに付与するアクセス許可セットを作成します。  ここでは、インターネット ゾーンのアクセス許可セットを使用します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#2)]
+     [!code-vb[HowToEmitCodeInPartialTrust#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#2)]  
+  
+2.  アプリケーション ドメインをアプリケーション パスで初期化するため、<xref:System.AppDomainSetup> オブジェクトを作成します。  
+  
+    > [!IMPORTANT]
+    >  単純にするため、このコード例では現在のフォルダーを使用します。  実際にインターネットから取得されたコードを実行する場合は、信頼できないコード用の別のフォルダーを使用してください。詳細については、「[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)」を参照してください。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#3)]
+     [!code-vb[HowToEmitCodeInPartialTrust#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#3)]  
+  
+3.  アプリケーション ドメインで実行されるすべてのアセンブリについて、アプリケーション ドメイン設定情報、および許可セットを指定して、アプリケーション ドメインを作成します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#5)]
+     [!code-vb[HowToEmitCodeInPartialTrust#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#5)]  
+  
+     [AppDomain.CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29?displayProperty=fullName> メソッド オーバーロードの最後のパラメーターを使用すると、アプリケーション ドメインの許可セットではなく、完全な信頼が付与されたアセンブリのセットを指定できます。  これらのアセンブリはグローバル アセンブリ キャッシュに存在するため、アプリケーションが使用する [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アセンブリを指定する必要はありません。  グローバル アセンブリ キャッシュにあるアセンブリは、常に完全に信頼されます。  このパラメーターを使用して、グローバル アセンブリ キャッシュには存在しない厳密名のアセンブリを指定できます。  
+  
+### サンドボックス化されたドメインに RestrictedMemberAccess を追加する  
+ ホスト アプリケーションは、匿名でホストされる動的メソッドが、コードを出力するアセンブリの信頼レベルと同等以下の信頼レベルが設定されたアセンブリ内のプライベート データにアクセスすることを許可できます。  この制限付き機能を有効にして Just\-In\-Time \(JIT\) 参照範囲チェックをスキップするため、ホスト アプリケーションは、許可セットに対し、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> \(RMA\) フラグを設定した <xref:System.Security.Permissions.ReflectionPermission> オブジェクトを追加します。  
+  
+ たとえば、ホストはインターネット アプリケーションに対し、RMA を設定した Internet アクセス許可を付与し、インターネット アプリケーションが独自のアセンブリ内にあるプライベート データにアクセスするコードを出力できるようにすることが可能です。  このアクセスは、信頼レベルが同等以下であるアセンブリに限定されるため、インターネット アプリケーションは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アセンブリのような完全に信頼されたアセンブリのメンバーにはアクセスできません。  
+  
+> [!NOTE]
+>  特権の昇格を回避するため、匿名でホストされる動的メソッドの作成時にはアセンブリ出力の履歴情報が含まれます。  メソッドの呼び出し時に履歴情報がチェックされるため、  完全に信頼されたコードから呼び出された、匿名でホストされる動的メソッドは、依然として出力アセンブリの信頼レベルに制限されます。  
+  
+##### RMA を設定した部分信頼でアプリケーション ドメインを作成するには  
+  
+1.  <xref:System.Security.Permissions.ReflectionPermissionFlag> \(RMA\) フラグを指定した新しい <xref:System.Security.Permissions.ReflectionPermission> オブジェクトを作成し、<xref:System.Security.PermissionSet.SetPermission%2A?displayProperty=fullName> メソッドを使用して、許可セットにアクセス許可を追加します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#7)]
+     [!code-vb[HowToEmitCodeInPartialTrust#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#7)]  
+  
+     許可セットにアクセス許可が含まれていない場合、<xref:System.Security.PermissionSet.AddPermission%2A> メソッドによって、許可セットにアクセス許可が追加されます。  許可セットにアクセス許可が含まれている場合は、既存のアクセス許可に指定フラグが追加されます。  
+  
+    > [!NOTE]
+    >  RMA は、匿名でホストされる動的メソッドの 1 つの機能です。  通常の動的メソッドが JIT 参照範囲チェックをスキップした場合、出力コードには完全信頼が必要です。  
+  
+2.  アプリケーション ドメイン設定情報、および許可セットを指定して、アプリケーション ドメインを作成します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#8)]
+     [!code-vb[HowToEmitCodeInPartialTrust#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#8)]  
+  
+<a name="Running_code"></a>   
+## サンドボックス化されたアプリケーション ドメインでコードを実行する  
+ 次の手順では、アプリケーション ドメインで実行可能なメソッドを使用してクラスを定義する方法、そのドメインでクラスのインスタンスを作成する方法、そのメソッドを実行する方法について説明します。  
+  
+#### アプリケーション ドメインでメソッドを定義して実行するには  
+  
+1.  <xref:System.MarshalByRefObject> から派生するクラスを定義します。  これにより、他のアプリケーション ドメインにクラスのインスタンスを作成し、アプリケーション ドメインの境界を越えてメソッドを呼び出すことができます。  この例のクラスの名前は `Worker` です。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#10)]
+     [!code-vb[HowToEmitCodeInPartialTrust#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#10)]  
+  
+2.  実行するコードを含むパブリック メソッドを定義します。  この例では、コードは単純な動的メソッドを出力し、メソッドを実行するためのデリゲートを作成して、デリゲートを呼び出します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#11)]
+     [!code-vb[HowToEmitCodeInPartialTrust#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#11)]  
+  
+3.  メイン プログラムで、アセンブリの表示名を取得します。  この名前は、サンドボックス化されたアプリケーション ドメインで `Worker` クラスのインスタンスを作成するときに使用します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#14](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#14)]
+     [!code-vb[HowToEmitCodeInPartialTrust#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#14)]  
+  
+4.  メイン プログラムでは、このチュートリアルの[最初の手順](#Setting_up)で説明したとおり、サンドボックス化されたアプリケーション ドメインを作成します。  `SimpleEmitDemo` メソッドはパブリック メソッドのみを使用するため、`Internet` アクセス許可セットに任意のアクセス許可を追加しないでください。  
+  
+5.  メイン プログラムで、サンドボックス化されたアプリケーション ドメインに `Worker` クラスのインスタンスを作成します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#12)]
+     [!code-vb[HowToEmitCodeInPartialTrust#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#12)]  
+  
+     <xref:System.AppDomain.CreateInstanceAndUnwrap%2A> メソッドにより、対象のアプリケーション ドメイン内にオブジェクトが作成され、オブジェクトのプロパティおよびメソッドの呼び出しに使用できるプロキシが返されます。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこのコードを使用する場合は、名前空間を含むようにクラスの名前を変更する必要があります。  既定では、名前空間がプロジェクト名になります。  たとえば、プロジェクト名が "PartialTrust" である場合、クラス名は "PartialTrust.Worker" にする必要があります。  
+  
+6.  `SimpleEmitDemo` メソッドを呼び出すコードを追加します。  呼び出しはアプリケーションのドメイン境界を越えてマーシャリングされ、コードはサンドボックス化されたアプリケーション ドメインで実行されます。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#13](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#13)]
+     [!code-vb[HowToEmitCodeInPartialTrust#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#13)]  
+  
+<a name="Using_methods"></a>   
+## 匿名でホストされる動的メソッドを使用する  
+ 匿名でホストされる動的メソッドは、システムが提供する透過的なアセンブリに関連付けられます。  そのため、これらのメッソドに含まれるコードは透過的になります。  それに対し、通常の動的メソッドは、直接指定されるか関連付けられた型から推論されるかに関係なく、既存のモジュールに関連付ける必要があり、そのモジュールからセキュリティ レベルを引き継ぎます。  
+  
+> [!NOTE]
+>  次の手順では、匿名のホストを提供するアセンブリに動的メソッドを関連付ける唯一の方法であるコンストラクターの使用法について説明します。  匿名のホスト アセンブリでモジュールを明示的に指定することはできません。  
+  
+ 通常の動的メソッドは、関連付けられているモジュールの内部メンバーまたは関連付けられている型のプライベート メンバーにアクセスできます。  匿名でホストされる動的メソッドは他のコードから分離されているため、プライベート データにアクセスすることはできません。  ただし、JIT 参照範囲チェックをスキップしてプライベート データにアクセスするための、制限付き機能が設定されています。  この機能が設定されるのは、コードを出力するアセンブリの信頼レベルと同等以下の信頼レベルが設定されたアセンブリに限定されます。  
+  
+ 特権の昇格を回避するため、匿名でホストされる動的メソッドの作成時にはアセンブリ出力の履歴情報が含まれます。  メソッドの呼び出し時に履歴情報がチェックされるため、  完全に信頼されたコードから呼び出された、匿名でホストされる動的メソッドは、依然として出力アセンブリの信頼レベルに制限されます。  
+  
+#### 匿名でホストされる動的メソッドを使用するには  
+  
+-   関連付けられたモジュールや型を指定しないコンストラクターを使用して、匿名でホストされる動的メソッドを作成します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#15](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#15)]
+     [!code-vb[HowToEmitCodeInPartialTrust#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#15)]  
+  
+     匿名でホストされる動的メソッドが使用するのがパブリック型とパブリック メソッドのみである場合、メンバー アクセスを制限する必要はなく、JIT 参照範囲チェックをスキップする必要もありません。  
+  
+     動的メソッドの出力に必要なアクセス許可はありませんが、出力コードには、そのコードが使用する型やメソッドに応じたアクセス許可が必要です。  たとえば、ファイルにアクセスするメソッドを呼び出す出力コードには、<xref:System.Security.Permissions.FileIOPermission> が必要です。  信頼レベルに該当のアクセス許可が含まれていないと、出力コードの実行時にセキュリティ例外がスローされます。  ここでは、<xref:System.Console.WriteLine%2A?displayProperty=fullName> メソッドのみを使用する動的メソッドを出力するコードを示します。  このコードは、部分的に信頼された場所から実行できます。  
+  
+-   または、JIT 参照範囲チェックをスキップするために機能を制限した、匿名でホストされる動的メソッドを作成します。これを行うには、[DynamicMethod\(String, Type, Type\<xref:System.Reflection.Emit.DynamicMethod.%23ctor%28System.String%2CSystem.Type%2CSystem.Type%5B%5D%2CSystem.Boolean%29> コンストラクターを使用して、`restrictedSkipVisibility` パラメーターに `true` を指定します。  
+  
+     [!code-csharp[HowToEmitCodeInPartialTrust#16](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#16)]
+     [!code-vb[HowToEmitCodeInPartialTrust#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#16)]  
+  
+     ここでの制限は、匿名でホストされる動的メソッドがアクセスできるプライベート データは、出力アセンブリの信頼レベルと同等以下の信頼レベルが設定されたアセンブリ内にあるプライベート データに限定されることを意味します。  たとえば、動的メソッドをインターネット信頼で実行している場合、同様にインターネット信頼で実行している他のアセンブリ内にあるプライベート データにはアクセスできますが、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アセンブリのプライベート データにはアクセスできません。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アセンブリは、グローバル アセンブリ キャッシュにインストールされているもので、常に完全に信頼されます。  
+  
+     匿名でホストされる動的メソッドは、ホスト アプリケーションが <xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> フラグが設定された <xref:System.Security.Permissions.ReflectionPermission> を付与している場合のみ、JIT 参照範囲チェックをスキップして制限付き機能を使用できます。  このアクセス許可は、メソッドの呼び出し時に要求されます。  
+  
+    > [!NOTE]
+    >  出力アセンブリの呼び出し履歴情報は、動的メソッドの作成時に含まれます。  したがって、この要求は、メソッドを呼び出すアセンブリではなく、出力アセンブリのアクセス許可に対して発行されます。  これにより、昇格されたアクセス権で出力コードが実行されることを回避します。  
+  
+     制限付きメンバー アクセスの使用と制約については、このチュートリアルの最後の「[完全なコード例](#Example)」に示します。  `Worker` クラスには、参照範囲チェックをスキップするための制限付き機能の有無に関係なく匿名でホストされる動的メソッドを作成できるメソッドが含まれます。例では、異なる信頼レベルを設定したアプリケーション ドメインでこのメソッドを実行した結果も示します。  
+  
+    > [!NOTE]
+    >  参照範囲チェックをスキップするための制限付き機能は、匿名でホストされる動的メソッドの 1 つの機能です。  通常の動的メソッドが JIT 参照範囲チェックをスキップした場合、完全信頼が与えられている必要があります。  
+  
+<a name="Example"></a>   
+## 例  
+  
+### 説明  
+ <xref:System.Security.Permissions.ReflectionPermissionFlag> フラグを使用して、匿名でホストされる動的メソッドが JIT の参照範囲チェックをスキップできるようにするコード例を次に示します。ただし、対象のメンバーの信頼レベルは、コードを出力するアセンブリ以下であることを前提とします。  
+  
+ この例では、アプリケーション ドメインの境界を越えてマーシャリングできる `Worker` クラスを定義します。  クラスには、動的メソッドを出力して実行する、`AccessPrivateMethod` メソッド オーバーロードが 2 つあります。  最初のオーバーロードは、`Worker` クラスのプライベート `PrivateMethod` メソッドを呼び出す動的メソッドを出力します。これは、JIT の参照範囲チェックを実行するかどうかにかかわらず、動的メソッドを出力できます。  2 番目のオーバーロードは、<xref:System.String> クラスの `internal` プロパティ \(Visual Basic では `Friend` プロパティ\) にアクセスする動的メソッドを出力します。  
+  
+ この例では、ヘルパー メソッドを使用して、`Internet` アクセス許可に制限される許可セットを作成します。次に、[AppDomain.CreateDomain\(String, Evidence, AppDomainSetup, PermissionSet, StrongName\<xref:System.AppDomain.CreateDomain%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.AppDomainSetup%2CSystem.Security.PermissionSet%2CSystem.Security.Policy.StrongName%5B%5D%29?displayProperty=fullName> メソッド オーバーロードを使用してアプリケーション ドメインを作成し、この許可セットを使用するドメインで実行するすべてのコードを指定します。  アプリケーション ドメインに `Worker` クラスのインスタンスを作成し、`AccessPrivateMethod` メソッドを 2 回実行します。  
+  
+-   `AccessPrivateMethod` メソッドを初めて実行すると、JIT の参照範囲チェックが強制的に実行されます。  動的メソッドは、JIT の参照範囲チェックによってプライベート メソッドにアクセスできなくなるため、呼び出し時に失敗します。  
+  
+-   `AccessPrivateMethod` メソッドの 2 回目の実行では、JIT 参照範囲チェックをスキップします。  `Internet` 許可セットでは、参照範囲チェックをスキップするのに十分なアクセス許可が付与されていないため、動的メソッドはコンパイル時に失敗します。  
+  
+ この例では、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> を指定した <xref:System.Security.Permissions.ReflectionPermission> を許可セットに追加します。  次に、2 番目のドメインを作成し、新しい許可セットにアクセス許可が付与されるドメインで実行するすべてのコードを指定します。  新しいアプリケーション ドメインに `Worker` クラスのインスタンスを作成し、`AccessPrivateMethod` メソッドの両方のオーバーロードを実行します。  
+  
+-   `AccessPrivateMethod` メソッドの最初のオーバーロードが実行され、JIT の参照範囲チェックがスキップされます。  コードを出力するアセンブリがプライベート メソッドを含むアセンブリと同じであるため、動的メソッドのコンパイルと実行は成功します。  したがって、信頼レベルは同等です。  `Worker` クラスを含むアプリケーションに複数のアセンブリが存在する場合、これらは同じ信頼レベルにあるため、どのアセンブリでも同じプロセスが成功します。  
+  
+-   `AccessPrivateMethod` メソッドの 2 番目のオーバーロードが実行され、JIT の参照範囲チェックは再度スキップされます。  <xref:System.String> クラスの `internal` `FirstChar` プロパティへのアクセスを試行するため、ここでは、動的メソッドはコンパイル時に失敗します。  <xref:System.String> クラスを含むアセンブリは完全に信頼されます。  したがって、コードを出力するアセンブリよりも信頼レベルが高くなります。  
+  
+ この比較により、<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName> によって、信頼されたコードのセキュリティを損なうことなく、部分的に信頼されたコードが、部分的に信頼された他のコードの参照範囲チェックをスキップできるようにする方法を示します。  
+  
+### コード  
+ [!code-csharp[HowToEmitCodeInPartialTrust#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/cs/source.cs#1)]
+ [!code-vb[HowToEmitCodeInPartialTrust#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEmitCodeInPartialTrust/vb/source.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコード例を [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でビルドする場合は、クラスを <xref:System.AppDomain.CreateInstanceAndUnwrap%2A> メソッドに渡すときに、名前空間を含むようにクラスの名前を変更する必要があります。  既定では、名前空間がプロジェクト名になります。  たとえば、プロジェクト名が "PartialTrust" である場合、クラス名は "PartialTrust.Worker" にする必要があります。  
+  
+## 参照  
+ [リフレクション出力のセキュリティ関連事項](../../../docs/framework/reflection-and-codedom/security-issues-in-reflection-emit.md)   
+ [方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)
\ No newline at end of file
diff --git a/docs/framework/resources/TOC.md b/docs/framework/resources/TOC.md
new file mode 100644
index 00000000000..ec2c622f22d
--- /dev/null
+++ b/docs/framework/resources/TOC.md
@@ -0,0 +1,6 @@
+# [リソースの取得](retrieving-resources-in-desktop-apps.md)
+# [リソースのパッケージ化と配置](packaging-and-deploying-resources-in-desktop-apps.md)
+# [サテライト アセンブリの作成](creating-satellite-assemblies-for-desktop-apps.md)
+# [デスクトップ アプリケーションのリソース](index.md)
+# [リソース ファイルの作成](creating-resource-files-for-desktop-apps.md)
+# [プログラムによる .resx ファイルの使用](working-with-resx-files-programmatically.md)
diff --git a/docs/framework/resources/creating-resource-files-for-desktop-apps.md b/docs/framework/resources/creating-resource-files-for-desktop-apps.md
new file mode 100644
index 00000000000..49c88e6899a
--- /dev/null
+++ b/docs/framework/resources/creating-resource-files-for-desktop-apps.md
@@ -0,0 +1,206 @@
+---
+title: "デスクトップ アプリケーションに対するリソース ファイルの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".resources ファイル"
+  - "アプリケーション リソース, 作成 (ファイルを)"
+  - "リソース ファイル, .resources ファイル"
+  - "リソース ファイル, 作成"
+ms.assetid: 6c5ad891-66a0-4e7a-adcf-f41863ba6d8d
+caps.latest.revision: 25
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# デスクトップ アプリケーションに対するリソース ファイルの作成
+リソース ファイルにリソース \(文字列、イメージ、オブジェクト データなど\) を追加して、アプリケーションで簡単に使用できるようにすることが可能です。  .NET Framework では、次の 5 つの方法でリソース ファイルを作成できます。  
+  
+-   文字列リソースを格納するテキスト ファイルを作成します。  [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用すると、テキスト ファイルをバイナリ リソース \(.resources\) ファイルに変換できます。  次に、そのバイナリ リソース ファイルを、言語コンパイラを使用してアプリケーションの実行可能ファイルまたはアプリケーション ライブラリに埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  詳細については、「[テキスト ファイル内のリソース](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#TextFiles)」を参照してください。  
+  
+-   文字列、イメージ、またはオブジェクト データを格納する XML リソース \(.resx\) ファイルを作成します。  [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用すると、.resx ファイルをバイナリ リソース \(.resources\) ファイルに変換できます。  次に、そのバイナリ リソース ファイルを、言語コンパイラを使用してアプリケーションの実行可能ファイルまたはアプリケーション ライブラリに埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  詳細については、「[.resx ファイル内のリソース](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#ResxFiles)」を参照してください。  
+  
+-   <xref:System.Resources> 名前空間の型を使用して、XML リソース \(.resx\) ファイルをプログラムによって作成します。  .resx ファイルを作成し、そのリソースを列挙して、特定のリソースを名前で取得することができます。  詳細については、「[プログラムによる .resx ファイルの使用](../../../docs/framework/resources/working-with-resx-files-programmatically.md)」を参照してください。  
+  
+-   バイナリ リソース \(.resources\) ファイルをプログラムによって作成します。  次に、そのファイルを、言語コンパイラを使用してアプリケーションの実行可能ファイルまたはアプリケーション ライブラリに埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  詳細については、「[.resources ファイル内のリソース](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#ResourcesFiles)」を参照してください。  
+  
+-   Visual Studio を使用してリソース ファイルを作成し、そのファイルをプロジェクトに追加します。  Visual Studio には、リソースを追加、削除、および変更するためのリソース エディターがあります。  コンパイル時には、リソース ファイルが自動的にバイナリ .resources ファイルに変換されて、アプリケーション アセンブリまたはサテライト アセンブリに埋め込まれます。  詳細については、「[Visual Studio のリソース ファイル](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#VSResFiles)」を参照してください。  
+  
+<a name="TextFiles"></a>   
+## テキスト ファイル内のリソース  
+ テキスト \(.txt または .restext\) ファイルを使用すると、文字列リソースのみ格納できます。文字列以外のリソースの場合は、.resx ファイルを使用するか、.resx ファイルをプログラムによって作成します。  文字列リソースを格納するテキスト ファイルの形式は次のとおりです。  
+  
+```  
+# This is an optional comment.  
+name = value  
+  
+; This is another optional comment.  
+name = value  
+  
+; The following supports conditional compilation if X is defined.  
+#ifdef X  
+name1=value1  
+name2=value2  
+#endif  
+  
+# The following supports conditional compilation if Y is undefined.  
+#if !Y  
+name1=value1  
+name2=value2  
+#endif  
+  
+```  
+  
+ .txt ファイルと .restext ファイルのリソース ファイル形式は同じです。  .restext ファイル拡張子は、テキスト ファイルがテキスト ベースのリソース ファイルであることをすぐに識別するために使用します。  
+  
+ 文字列リソースは、*name\/value* のペアとして表示されます。ここで、*name* はリソースを識別する文字列です。*value* は、リソース取得メソッド \(<xref:System.Resources.ResourceManager.GetString%2A?displayProperty=fullName> など\) に *name* を渡すときに返されるリソース文字列です。  *name* と *value* は等号 \(\=\) で区切る必要があります。  たとえば、次のようになります。  
+  
+```  
+  
+FileMenuName=File  
+EditMenuName=Edit  
+ViewMenuName=View  
+HelpMenuName=Help  
+  
+```  
+  
+> [!CAUTION]
+>  パスワード、セキュリティの配慮が必要な情報、プライベートなデータなどの格納には、リソース ファイルを使用しないでください。  
+  
+ 空の文字列 \(つまり、値が <xref:System.String.Empty?displayProperty=fullName> であるリソース\) はテキスト ファイルで使用できます。  たとえば、次のようになります。  
+  
+```  
+EmptyString=  
+```  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]以降では、テキスト ファイルをサポートします `#ifdef`*symbol*の条件付きコンパイルが…  `#endif` および `#if !`*symbol*...  `#endif` 構成体を使用した条件付きコンパイルがサポートされます。  次に、`/define` スイッチと[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用して、シンボルを定義できます。  各リソースが一つの独自の `#ifdef`*symbol*を…  `#endif` または `#if !`*symbol*...  `#endif` 構成体が必要です。  `#ifdef` ステートメントを使用した場合、*symbol* を定義した場合に関連付けられたリソースが .resources ファイルに追加されます。定義していない場合は追加されません。  `#if !` ステートメントを使用する場合、*symbol* を定義していない場合に関連付けられたリソースが .resources ファイルに追加されます。定義した場合は追加されません。  
+  
+ テキスト ファイルでは、コメントはオプションです。コメントの行頭にはセミコロン \(;\) またはシャープ記号 \(\#\) が付きます。  コメントの行はファイル内の任意の場所に配置できます。  [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用して作成されたコンパイル済みの .resources ファイルにはコメントが含まれません。  
+  
+ テキスト ファイル内の空白行はすべて空白と見なされて無視されます。  
+  
+ 次の例では、`OKButton` および `CancelButton` という名前の 2 つの文字列リソースを定義します。  
+  
+```  
+#Define resources for buttons in the user interface.  
+OKButton=OK  
+CancelButton=Cancel  
+```  
+  
+ テキスト ファイルに *name* が重複して出現する場合、[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) によって警告が表示され、2 番目の名前が無視されます。  
+  
+ *value* に改行文字を含めることはできませんが、C 言語形式のエスケープ文字で、改行を表す `\n` やタブを表す `\t` は使用できます。  エスケープする場合は、円記号を含めることができます \(たとえば、"\\\\"\)。  空の文字列を使用することもできます。  
+  
+ リトル エンディアンまたはビッグ エンディアンのバイト順の UTF\-8 エンコーディングまたは UTF\-16 エンコーディングを使用して、テキスト ファイル形式でリソースを保存する必要があります。  ただし、.txt ファイルを .resources ファイルに変換する[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) では、ファイルを既定では UTF\-8 として扱います。  UTF\-16 でエンコードされたファイルを Resgen.exe が認識できるようにする場合は、ファイルの先頭に Unicode バイト順マーク \(U\+FEFF\) を置く必要があります。  
+  
+ テキスト形式のリソース ファイルを .NET Framework アセンブリに埋め込むには、[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用してファイルをバイナリ リソース \(.resources\) ファイルに変換する必要があります。  次に、その .resources ファイルを、言語コンパイラを使用して .NET Framework アセンブリに埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  
+  
+ 次の例では、単純な "Hello World" コンソール アプリケーションで、GreetingResources.txt という名前のテキスト形式のリソース ファイルを使用します。  このテキスト ファイルでは、ユーザーに名前の入力を求め、あいさつ文を表示する 2 つの文字列 \(`prompt` および `greeting`\) を定義します。  
+  
+```  
+# GreetingResources.txt   
+# A resource file in text format for a "Hello World" application.  
+#  
+# Initial prompt to the user.  
+prompt=Enter your name:   
+# Format string to display the result.  
+greeting=Hello, {0}!  
+```  
+  
+ このテキスト ファイルは、次のコマンドを使用して .resources ファイルに変換できます。  
+  
+ **resgen GreetingResources.txt**  
+  
+ 次の例は、.resources ファイルを使用してユーザーにメッセージを表示するコンソール アプリケーションのソース コードを示しています。  
+  
+ [!code-csharp[Conceptual.Resources.TextFiles#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.textfiles/cs/greeting.cs#1)]
+ [!code-vb[Conceptual.Resources.TextFiles#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.textfiles/vb/greeting.vb#1)]  
+  
+ Visual Basic を使用している場合、ソース コード ファイル名が Greeting.vb であれば、埋め込みの .resources ファイルを含む実行可能ファイルを次のコマンドによって作成します。  
+  
+ **vbc greeting.vb \/resource:GreetingResources.resources**  
+  
+ C\# を使用している場合、ソース コード ファイル名が Greeting.cs であれば、埋め込みの .resources ファイルを含む実行可能ファイルを次のコマンドによって作成します。  
+  
+ **csc greeting.cs \/resource:GreetingResources.resources**  
+  
+<a name="ResxFiles"></a>   
+## .resx ファイル内のリソース  
+ 文字列リソースのみの格納が可能なテキスト ファイルとは異なり、XML リソース \(.resx\) ファイルは文字列、バイナリ データ \(イメージ、アイコン、オーディオ クリップなど\)、およびプログラム オブジェクトを格納できます。  .resx ファイルには、リソース エントリの形式を説明し、データの解析に使用する XML のバージョン管理情報を示す標準ヘッダーが含まれます。  XML ヘッダーの後に、リソース ファイル データが続きます。  各データ項目は、`data` タグに含まれる名前と値のペアで構成されます。  `name` 属性ではリソース名を定義し、入れ子になった `value` タグにはリソースの値を格納します。  文字列データの場合は、`value` タグに文字列が格納されます。  
+  
+ たとえば、次の `data` タグでは、`prompt` という名前の文字列リソースを定義します。このリソースの値は "Enter your name:" です。  
+  
+```  
+<data name="prompt" xml:space="preserve">  
+  <value>Enter your name:</value>  
+</data>  
+```  
+  
+> [!WARNING]
+>  パスワード、セキュリティの配慮が必要な情報、プライベートなデータなどの格納には、リソース ファイルを使用しないでください。  
+  
+ リソース オブジェクトの場合は、リソースのデータ型を示す `type` 属性が **data** タグに含まれます。  バイナリ データで構成されるオブジェクトの場合、`data` タグには、バイナリ データの `base64` 型を示す `mimetype` 属性も含まれます。  
+  
+> [!NOTE]
+>  すべての .resx ファイルは、指定された型のバイナリ データを生成し解析するために、バイナリのシリアル化フォーマッタを使用します。  このため、オブジェクトのバイナリ シリアル化形式が互換性のない形式に変更されると、.resx ファイルは無効になる可能性があります。  
+  
+ 次の例は、<xref:System.Int32> リソースおよびビットマップ イメージを含む .resx ファイルの一部を示しています。  
+  
+```  
+  
+<data name="i1" type="System.Int32, mscorlib">  
+  <value>20</value>  
+</data>  
+  
+<data name="flag" type="System.Drawing.Bitmap, System.Drawing,     
+    Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"   
+    mimetype="application/x-microsoft.net.object.bytearray.base64">  
+  <value>  
+    AAEAAAD/////AQAAAAAAAAAMAgAAADtTeX…  
+  </value>  
+</data>  
+```  
+  
+> [!IMPORTANT]
+>  .resx ファイルは定義されている形式の整形式 XML で構成する必要があるため、特に文字列以外のリソースが .resx ファイルに格納されている場合に、.resx ファイルを手動で操作することはお勧めしません。  その代わりに、Visual Studio には、.resx ファイルを作成および操作するための透過的なインターフェイスが用意されています。詳細については、「[Visual Studio のリソース ファイル](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#VSResFiles)」を参照してください。  .resx ファイルは、プログラムによって作成および操作することもできます。  詳細については、「[プログラムによる .resx ファイルの使用](../../../docs/framework/resources/working-with-resx-files-programmatically.md)」を参照してください。  
+  
+<a name="ResourcesFiles"></a>   
+## .resources ファイル内のリソース  
+ <xref:System.Resources.ResourceWriter?displayProperty=fullName> クラスを使用すると、プログラムによってコードから直接、バイナリ リソース \(.resources\) ファイルを作成できます。  また、[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用して、テキスト ファイルまたは .resx ファイルから .resources ファイルを作成することもできます。  .resources ファイルには、文字列データに加えて、バイナリ データ \(バイト配列\) およびオブジェクト データを格納できます。  .resources ファイルをプログラムによって作成するには、次の手順が必要です。  
+  
+1.  一意のファイル名を付けて <xref:System.Resources.ResourceWriter> オブジェクトを作成します。  そのためには、ファイル名またはファイル ストリームを <xref:System.Resources.ResourceWriter> クラス コンストラクターに指定します。  
+  
+2.  ファイルに追加する名前付きリソースごとに <xref:System.Resources.ResourceWriter.AddResource%2A?displayProperty=fullName> メソッドのオーバーロードの 1 つを呼び出します。  リソースには、文字列、オブジェクト、またはバイナリ データのコレクション \(バイト配列\) を指定できます。  
+  
+3.  <xref:System.Resources.ResourceWriter.Close%2A?displayProperty=fullName> メソッドを呼び出してファイルにリソースを書き込み、<xref:System.Resources.ResourceWriter> オブジェクトを閉じます。  
+  
+> [!NOTE]
+>  パスワード、セキュリティの配慮が必要な情報、プライベートなデータなどの格納には、リソース ファイルを使用しないでください。  
+  
+ 次の例では、6 つの文字列、1 つのアイコン、2 つのアプリケーション定義オブジェクト \(2 つの `Automobile` オブジェクト\) を格納する、CarResources.resources という名前の .resources ファイルをプログラムによって作成します。  この例で定義およびインスタンス化される `Automobile` クラスは、<xref:System.SerializableAttribute> 属性でタグ付けされます。これにより、バイナリのシリアル化フォーマッタによってクラスを永続化できます。  
+  
+ [!code-csharp[Conceptual.Resources.Resources#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.resources/cs/resources1.cs#1)]
+ [!code-vb[Conceptual.Resources.Resources#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.resources/vb/resources1.vb#1)]  
+  
+ 作成した .resources ファイルは、言語コンパイラの `/resource` スイッチを追加してランタイム実行可能ファイルまたはライブラリに埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  
+  
+<a name="VSResFiles"></a>   
+## Visual Studio のリソース ファイル  
+ Visual Studio プロジェクトにリソース ファイルを追加すると、Visual Studio のプロジェクト ディレクトリに .resx ファイルが作成されます。  Visual Studio には、文字列、イメージ、およびバイナリ オブジェクトを追加するためのリソース エディターがあります。  このエディターは静的データのみを処理するように設計されているので、プログラム オブジェクトを格納するために使用することはできません。オブジェクト データは、.resx ファイルまたは .resources ファイルにプログラムによって書き込む必要があります。  詳細については、「[プログラムによる .resx ファイルの使用](../../../docs/framework/resources/working-with-resx-files-programmatically.md)」および「[.resources ファイル内のリソース](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md#ResourcesFiles)」を参照してください。  
+  
+ ローカライズされたリソースを追加する場合は、メイン リソース ファイルと同じルート ファイル名をそれらのリソースに指定し、ファイル名にリソースのカルチャを指定する必要があります。  たとえば、Resources.resx という名前のリソース ファイルを追加する場合に、英語 \(米国\) とフランス語 \(フランス\) の各カルチャ用にローカライズされたリソースを保持するには、Resources.en\-US.resx および Resources.fr\-FR.resx という名前のリソース ファイルを作成します。  また、アプリケーションの既定のカルチャも指定しておく必要があります。  この情報は、特定のカルチャ用にローカライズされたリソースが見つからない場合に、どのカルチャのリソースを使用するか決定するために使用されます。  既定のカルチャを指定するには、Visual Studio のソリューション エクスプローラーで、プロジェクト名を右クリックし、\[アプリケーション\] をポイントして、**\[アセンブリ情報\]** をクリックします。次に、**\[ニュートラル言語\]** ボックスの一覧で適切な言語\/カルチャをクリックします。  
+  
+ コンパイル時に、Visual Studio ではまずプロジェクト内の .resx ファイルをバイナリ リソース \(.resources\) ファイルに変換して、プロジェクトの obj ディレクトリのサブディレクトリに格納します。  ローカライズされたリソースが格納されていないリソース ファイルは、プロジェクトで生成されたメイン アセンブリに埋め込みます。  ローカライズされたリソースがリソース ファイルに格納されている場合、Visual Studio では、各ローカライズ カルチャの個別のサテライト アセンブリにそのファイルを埋め込みます。  各サテライト アセンブリは、ローカライズ カルチャに対応する名前のディレクトリに格納します。  たとえば、ローカライズされた英語 \(米国\) リソースは、en\-US サブディレクトリ内のサテライト アセンブリに格納されます。  
+  
+## 参照  
+ <xref:System.Resources>   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)
\ No newline at end of file
diff --git a/docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md b/docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md
new file mode 100644
index 00000000000..41ab80e14ff
--- /dev/null
+++ b/docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md
@@ -0,0 +1,321 @@
+---
+title: "デスクトップ アプリケーションに対するサテライト アセンブリの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (アプリケーションを) [.NET Framework]、リソース"
+  - "リソース ファイル、配置"
+  - "ハブ アンド スポーク リソース配置モデル"
+  - "リソース ファイル、パッケージ化"
+  - "アプリケーション リソース、パッケージ化"
+  - "公開キー、取得"
+  - "サテライト アセンブリ"
+  - "アセンブリ [.NET Framework]、署名"
+  - "アプリケーション リソース、配置"
+  - "Al.exe"
+  - "GAC (グローバル アセンブリ キャッシュ)、サテライト アセンブリ"
+  - "アセンブリ リンカー"
+  - "ディレクトリの位置 (サテライト アセンブリ用の)"
+  - "グローバル アセンブリ キャッシュ、サテライト アセンブリ"
+  - "パッケージ化 (アプリケーション リソースの)"
+  - "コンパイル (サテライト アセンブリの)"
+  - "再署名 (アセンブリへの)"
+ms.assetid: 8d5c6044-2919-41d2-8321-274706b295ac
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# デスクトップ アプリケーションに対するサテライト アセンブリの作成
+リソース ファイルはローカライズされたアプリケーションの中心的な役割を果たします。  これは、通常、ユーザーがそれぞれの使用言語とカルチャの表示文字列、イメージ、およびそのほかのデータにユーザー固有の言語またはカルチャ用のリソースが使用できない場合、アプリケーションを、代替データを提供できるようになります。  .NET Framework には、ローカライズされたリソースを探し、取得するために、ハブ アンド スポーク モデルを使用します。  ハブはニュートラルまたは既定のカルチャと呼ばれる、単一カルチャ用のローカライズできない実行可能コードを含むメイン アセンブリです。  既定のカルチャは、アプリケーションで使用されるフォールバック カルチャです; これは、ローカライズされたリソースが使用できない場合に使用されます。  アプリケーションの既定のカルチャにカルチャを指定するために <xref:System.Resources.NeutralResourcesLanguageAttribute> 属性を使用します。  各スポークは、単一のローカライズされたカルチャ用のリソースを含むが、接続してコードを含まないサテライト アセンブリに。  サテライト アセンブリはメイン アセンブリの一部には含まれないため、簡単に特定のカルチャにアプリケーションのメイン アセンブリを交換しなくても、に対応するリソースだけを更新するか、または置換できます。  
+  
+> [!NOTE]
+>  アプリケーションの既定のカルチャのリソースは、サテライト アセンブリに格納できます。  これを行うには、<xref:System.Resources.NeutralResourcesLanguageAttribute> 属性に <xref:System.Resources.UltimateResourceFallbackLocation?displayProperty=fullName>の値を割り当てます。  
+  
+## サテライト アセンブリの名前と場所  
+ ハブ アンド スポーク モデルは、簡単に見つけて使用できるように、リソースを特定の場所に配置する必要があります。  、名前のリソースが正常にコンパイルするか、適切な場所に配置する場合、共通言語ランタイムはリソースを検出し、既定のカルチャのリソースを使用します。  <xref:System.Resources.ResourceManager> オブジェクトによって表される .NET Framework リソース マネージャーに自動的にローカライズされたリソースにアクセスするために使用されます。  リソース マネージャーは、次の項目が必要です。T:  
+  
+-   一つのサテライト アセンブリが特定のカルチャ用のリソースを含める必要があります。  つまり、複数の .txt をコンパイルする必要があります。また、単一のバイナリ .resources への .resx ファイルします。  
+  
+-   それぞれのローカライズされたカルチャ用のアプリケーション ディレクトリに個別のサブディレクトリが必要で、そのカルチャのリソースを格納します。  サブディレクトリ名は、カルチャ名と同じである必要があります。  また、グローバル アセンブリ キャッシュにサテライト アセンブリを格納できます。  この場合、アセンブリの厳密な名前のカルチャ情報のコンポーネントには、カルチャを指定する必要があります。このトピックで [グローバル アセンブリ キャッシュにサテライト アセンブリをインストールできます。](#SN) セクション"を参照してください\)。  
+  
+    > [!NOTE]
+    >  アプリケーションにサブカルチャ用のリソースを含める場合は、アプリケーション ディレクトリに固有のサブディレクトリに各サブカルチャを配置します。  メイン カルチャのディレクトリのサブディレクトリにサブカルチャを入れないでください。  
+  
+-   サテライト アセンブリは、アプリケーションと同じ名前を持つファイル名拡張子「.resources.dll」を使用する必要があります。  たとえば、アプリケーションが Example.exe の場合、各サテライト アセンブリの名前は Example.resources.dll 必要があります。  サテライト アセンブリの名前は、リソース ファイルのカルチャがないことに注意してください。  ただし、サテライト アセンブリがカルチャを指定するディレクトリに表示されます。  
+  
+-   サテライト アセンブリのカルチャに関する情報は、アセンブリのメタデータに含まれている必要があります。  サテライト アセンブリ内のリソースを埋め込むために [Assembly Linker](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用する場合、サテライト アセンブリのメタデータにカルチャ名を保存するには、`/culture` オプションを指定します。  
+  
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)内にインストールしないアプリケーションについて、サンプルのディレクトリ構造と位置に関する要件を次の図に示します。  .txt および .resources 拡張の項目は、最終的なアプリケーションには付属していません。  それらは、最終的なサテライト リソース アセンブリを作成するまでの中間リソース ファイルです。  この例では、.txt ファイルを .resx ファイルに置き換えることもできます。  詳細については、「[" Packaging and Deploying Resources](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)」を参照してください。  
+  
+ ![サテライト アセンブリ](../../../docs/framework/resources/media/satelliteassemblydir.gif "satelliteassemblydir")  
+サテライト アセンブリ ディレクトリ  
+  
+## サテライト アセンブリのコンパイル  
+ バイナリ .resources ファイルにリソースを含む XML ファイル \(.resx\) または、テキスト ファイルをコンパイルするために [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用します。  その後、サテライト アセンブリに .resources ファイルをコンパイルするために [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用します。  Al.exe は、指定された .resources ファイルからアセンブリを作成します。  サテライト アセンブリにはリソースのみを含めることができます。; 管理者として実行可能コードを含めることはできません。  
+  
+ 次のコマンドは、Al.exe ドイツ語のリソース ファイル strings.de.resources からアプリケーション `Example` 用のサテライト アセンブリを作成します。  
+  
+```  
+al /target:lib /embed:strings.de.resources /culture:de /out:Example.resources.dll  
+```  
+  
+ 次のコマンドは、Al.exe ファイル strings.de.resources からアプリケーション `Example` 用のサテライト アセンブリを作成します。  **\/template** オプションは、サテライト アセンブリは親アセンブリ \(Example.dll\) のカルチャ情報を除き、すべてのアセンブリ メタデータを継承します。  
+  
+```  
+al /target:lib /embed:strings.de.resources /culture:de /out:Example.resources.dll /template:Example.dll  
+```  
+  
+ 次の表は、これらのコマンドで使用した Al.exe のオプションを示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/target:**ライブラリ|サテライト アセンブリがライブラリ \(.dll\) ファイルとしてコンパイルすることを指定します。  サテライト アセンブリが実行可能コードを含まず、アプリケーションのメイン アセンブリではないため、サテライト アセンブリは DLL として保存する必要があります。|  
+|**\/embed:**strings.de.resources|リソース ファイルの名前を、Al.exe がアセンブリをコンパイルするときに埋め込むに指定します。  サテライト アセンブリに複数の .resources ファイルを埋め込むことができます。ハブ アンド スポーク モデルに従う場合は、カルチャごとに、1 個のサテライト アセンブリをコンパイルする必要があります。  ただし、文字列、オブジェクトの別の .resources ファイルを作成できます。|  
+|**\/culture:**de|リソースのカルチャをコンパイルするように指定します。  共通言語ランタイムは、指定されたカルチャ用のリソースを検索するときに、この情報を使用します。  このオプションを省略すると、Al.exe はリソースがコンパイルされ、ランタイムはそのリソースを検出できなくユーザーが要求した場合。|  
+|**\/out:**Example.resources.dll|出力ファイルの名前を指定します。  名前は名前付け標準 *baseName*.resources に従う必要があります。*baseName* はメイン アセンブリと *extension* の名前の*extension*は、有効なファイル名拡張子 \(.dll\) です。  ランタイムは、出力ファイル名からサテライト アセンブリのカルチャを判断することはできません。; これを指定するために **\/culture** オプションを使用する必要があります。|  
+|**\/template:**Example.dll|サテライト アセンブリのカルチャ フィールドを除く、すべてのアセンブリ メタデータを継承するアセンブリを指定します。  このオプションは [厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)が指定されたアセンブリを指定している場合にのみサテライト アセンブリに影響します。|  
+  
+ 有効な Al.exe のオプションの一覧については [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md)を参照してください。  
+  
+## サテライト アセンブリ: 例  
+ 次にローカライズされたメッセージを含むメッセージ ボックスを表示する「Hello world」の簡単な例です。  例では、英語 \(米国\)、フランス語 \(フランス\)、ロシア語 \(ロシア語\) のカルチャのリソースが含まれ、フォールバック カルチャは英語です。  例を作成するには、次の手順を実行します。:  
+  
+1.  Create a resource ファイルは既定のカルチャ用のリソースを含めるに Greeting.resx または Greeting.txt を指定します。  値が「Hello world\!」という `HelloString` という名前の一つの文字列を格納します。このファイル。  
+  
+2.  English \(en\) がアプリケーションの既定のカルチャであることを示すには、アプリケーションの AssemblyInfo ファイルまたはアプリケーションのメイン アセンブリにコンパイルされる主要なソース ファイルに <xref:System.Resources.NeutralResourcesLanguageAttribute?displayProperty=fullName> の次の属性を追加します。  
+  
+     [!code-csharp[Conceptual.Resources.Locating#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.locating/cs/assemblyinfo.cs#2)]
+     [!code-vb[Conceptual.Resources.Locating#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.locating/vb/assemblyinfo.vb#2)]  
+  
+3.  次のようにアプリケーションに新しいカルチャ \(en\-US、fr\-FR と ru RU\) のサポートを追加する:  
+  
+    -   英語 \(米国\) en\-US または English カルチャを、Greeting.en\-US.resx または Greeting.en\-US.txt をサポートするには、ストアを作成するための指定されたリソース ファイルは、一つの文字列値が「Hello World\!」が `HelloString` という名前です。  
+  
+    -   \(フランス語\) fr\-FR またはフランスのカルチャを、Greeting.fr\-FR.resx または Greeting.fr\-FR.txt をサポートするには、ストアを作成するための指定されたリソース ファイルは、一つの文字列は、値が「Salut ダフ屋 le Monde が\!」であるという `HelloString`  
+  
+    -   ru RU またはロシア語個 \(ロシア語\) カルチャを、Greeting.ru\-RU.resx または Greeting.ru\-RU.txt をサポートするには、ストアを作成するための指定されたリソース ファイルは、一つの文字列は、値が「Всем привет\!」が `HelloString` という名前です。  
+  
+4.  バイナリ .resources ファイルに各テキストまたは XML リソース ファイルをコンパイルするために [Resgen.exe](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用します。  出力は、.resx ファイルまたは .txt ファイルと同じルート ファイル名を持つ、拡張子 .resources ファイル セットです。  Visual Studio と例を作成すると、コンパイル処理は自動的に処理されます。  Visual Studio を使用していない場合は、.resx ファイルを .resources ファイルにコンパイルするには、次のコマンドを実行する:  
+  
+    ```  
+  
+    resgen Greeting.resx  
+    resgen Greeting.en-us.resx  
+    resgen Greeting.fr-FR.resx  
+    resgen Greeting.ru-RU.resx  
+  
+    ```  
+  
+     リソースが XML ファイルではなく、テキスト ファイルの場合は、.txt と .resx 拡張子を置き換えます。  
+  
+5.  アプリケーションのメイン アセンブリに既定のカルチャのリソース ファイルとともに次のソース・コードをコンパイルする:  
+  
+    > [!IMPORTANT]
+    >  例を作成したときに、Visual Studio ではなく、コマンド ラインを使用すると、次に <xref:System.Resources.ResourceManager> クラス コンストラクターの呼び出しを変更する必要があります: `ResourceManager rm = new ResourceManager("Greetings",``typeof(Example).Assembly);`  
+  
+     [!code-csharp[Conceptual.Resources.Locating#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.locating/cs/program.cs#1)]
+     [!code-vb[Conceptual.Resources.Locating#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.locating/vb/module1.vb#1)]  
+  
+     アプリケーションが Example という名前で、コマンド ラインからコンパイルする場合、C\# コンパイラのコマンドは、次の操作:  
+  
+    ```  
+    csc Example.cs /res:Greeting.resources  
+    ```  
+  
+     Visual Basic の対応するコンパイラのコマンドは、次の操作:  
+  
+    ```  
+    vbc Example.vb /res:Greeting.resources  
+    ```  
+  
+6.  アプリケーションでサポートされているそれぞれのローカライズされたカルチャのメイン アプリケーション ディレクトリのサブディレクトリを作成します。  en\-US、fr\-FR と ru RU サブディレクトリを作成する必要があります。  Visual Studio は、コンパイル処理の一部としてこれらのサブディレクトリを自動的に作成されます。  
+  
+7.  各カルチャ固有の .resources ファイルをサテライト アセンブリに埋め込み、適切なディレクトリに保存します。  各 .resources ファイルの要素を指定するコマンドを次に示します。:  
+  
+    ```  
+    al /target:lib /embed:Greeting.culture.resources /culture:culture /out:culture\Example.resources.dll  
+    ```  
+  
+     *culture* がリソースをサテライト アセンブリに含まれるカルチャの名前です。  Visual Studio は、この処理を自動的に処理します。  
+  
+ この例を実行できます。  これはランダムにサポートされているカルチャの 1 に現在のカルチャを、ローカライズされたメッセージを表示します。  
+  
+<a name="SN"></a>   
+## グローバル アセンブリ キャッシュにサテライト アセンブリをインストールできます。  
+ ローカル アプリケーション サブディレクトリにアセンブリをインストールする代わりに、グローバル アセンブリ キャッシュにインストールできます。  これは、複数のアプリケーションで使用されるクラス ライブラリのリソース アセンブリとクラス ライブラリがある場合に特に便利です。  
+  
+ アセンブリをグローバル アセンブリ キャッシュにインストールするには、アセンブリに厳密な名前が必要です。  厳密な名前を持つアセンブリには、有効な公開\/秘密キーのペアによる署名が付いています。  これらは、バインド要求を満たすために使用するアセンブリ バージョンを決定するためにランタイムが使用するバージョン情報が含まれています。  厳密な名前とバージョン管理の詳細については、「[Assembly Versioning](../../../docs/framework/app-domains/assembly-versioning.md)」を参照してください。  厳密な名前の詳細については、「[Strong\-Named Assemblies](../../../docs/framework/app-domains/strong-named-assemblies.md)」を参照してください。  
+  
+ 通常、アプリケーションの開発中に、最終的な公開\/秘密キーのペアにアクセスすることはありません。  サテライト アセンブリをグローバル アセンブリ キャッシュ内にインストールし、そのアセンブリが確実に予測どおりに機能するようにするために、遅延署名と呼ばれる技術を使用できます。  厳密な名前の署名のためにアセンブリに遅延署名ビルド時のアセンブリ、ファイル内の領域を確保します。  実際の署名は後で、最終的な公開\/秘密キーのペアを使用できる場合、遅延します。  遅延署名に関する詳細については、「[アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)」を参照してください。  
+  
+### 公開キーの取得  
+ アセンブリへの署名を遅延するには、公開キーにアクセスする必要があります。  [Strong Name Tool \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)の使用、または最終的な署名を行う、または公開キーを作成します。できます企業の組織の実際の公開キーを取得します。  
+  
+ 次のコマンドは、Sn.exe テスト用の公開キーと秘密キーのペアを生成します。  **–k** オプションは、Sn.exe で新しいキー ペアを作成し、TestKeyPair.snk というファイルに格納するように指定します。  
+  
+```  
+sn –k TestKeyPair.snk   
+```  
+  
+ テスト用のキー ペアを含むファイルから公開キーを抽出できます。  次のコマンドは、TestKeyPair.snk から公開キーを抽出し、PublicKey.snk に保存する:  
+  
+```  
+sn –p TestKeyPair.snk PublicKey.snk  
+```  
+  
+### アセンブリへの遅延署名  
+ 公開キーを取得または作成したら、アセンブリをコンパイルし、遅延署名を指定するために [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用します。  
+  
+ 次のコマンドは、Al.exe strings.ja.resources ファイルからアプリケーション StringLibrary の強名前付きなサテライト アセンブリを作成する:  
+  
+```  
+al /target:lib /embed:strings.ja.resources /culture:ja /out:StringLibrary.resources.dll /delay+ /keyfile:PublicKey.snk  
+```  
+  
+ **\/delay\+** オプションは、アセンブリへの署名とアセンブリ \(Assembly Linker ことを指定します。  **\/keyfile** オプションは、アセンブリへの署名を遅延するために使用する公開キーを含むキー ファイルの名前を指定します。  
+  
+### アセンブリへの再署名  
+ アプリケーションを配置する前に、実際のキー ペアで遅延署名されたサテライト アセンブリを再署名する必要があります。  Sn.exe を使用して行うことができます。  
+  
+ 次のコマンドは、Sn.exe ファイル RealKeyPair.snk に格納されているキーのペアで StringLibrary.resources.dll に署名します。  **–R** オプションは、以前に符号付きなまたはの遅延署名されたアセンブリを再署名する必要があることを指定します。  
+  
+```  
+sn –R StringLibrary.resources.dll RealKeyPair.snk   
+```  
+  
+### グローバル アセンブリ キャッシュへのサテライト アセンブリのインストール  
+ ランタイムがリソース フォールバック プロセスによってリソースを検索するときには、[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md) を最初になります。\(詳細については、[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md) 「の"リソース フォールバック プロセス」を参照します。サテライト アセンブリが厳密な名前で署名すると、グローバル アセンブリ キャッシュに [Global Assembly Cache Tool \(Gacutil.exe\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)を使用してインストールできます。  
+  
+ 次のコマンドは、Gacutil.exe はグローバル アセンブリ キャッシュに StringLibrary.resources.dll をインストールする:  
+  
+```  
+gacutil /i:StringLibrary.resources.dll  
+```  
+  
+ **\/i** オプションは、Gacutil.exe をグローバル アセンブリ キャッシュに指定されたアセンブリをインストールする必要があることを指定します。  サテライト アセンブリのキャッシュにインストールされた後で、サテライト アセンブリを使用するようにデザインされたすべてのアプリケーションで使用できるようになった含むリソース。  
+  
+### グローバル アセンブリ キャッシュのリソース: 例  
+ 次の例は、.NET Framework クラス ライブラリでリソース ファイルからローカライズされたメッセージを取得して返すためにメソッドを使用します。  ライブラリやリソースをグローバル アセンブリ キャッシュに登録されます。  例では、英語 \(米国\)、フランス語 \(フランス\)、ロシア語 \(ロシア語\)、および English カルチャのリソースが含まれています。  英語では既定のカルチャです。; このリソースは、メイン アセンブリに格納されます。  最初の例では、アセンブリに遅延署名が公開キーと秘密キーのペアの公開キーを使用してライブラリとサテライト アセンブリし、それらに再署名します。  例を作成するには、次の手順を実行します。:  
+  
+1.  Visual Studio を使用して、公開キーという名前の ResKey.snk 秘密キーのペアを作成する [Strong Name Tool \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) 次のコマンドを使用します。:  
+  
+    ```  
+    sn –k ResKey.snk  
+    ```  
+  
+     Visual Studio を使用している場合は、キー ファイルを生成するには、プロジェクトの **\[プロパティ\]** ダイアログ ボックスの **\[署名\]** タブを使用します。  
+  
+2.  PublicKey.snk という名前の公開キー ファイルを作成する [Strong Name Tool \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) 次のコマンドを使用します。:  
+  
+    ```  
+    sn –p ResKey.snk PublicKey.snk  
+    ```  
+  
+3.  Create a resource ファイルは既定のカルチャ用のリソースを含めるに Strings.resx という名前です。  か」のように、値を持つ `Greeting` という名前の一つの文字列を格納します。そのファイル。  
+  
+4.  「en」がアプリケーションの既定のカルチャであることを示すには、アプリケーションの AssemblyInfo ファイルまたはアプリケーションのメイン アセンブリにコンパイルされる主要なソース ファイルに <xref:System.Resources.NeutralResourcesLanguageAttribute?displayProperty=fullName> の次の属性を追加する:  
+  
+     [!code-csharp[Conceptual.Resources.Satellites#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.satellites/cs/stringlibrary.cs#2)]
+     [!code-vb[Conceptual.Resources.Satellites#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.satellites/vb/stringlibrary.vb#2)]  
+  
+5.  次のようにアプリケーションに新しいカルチャ \(en\-US、fr\-FR カルチャと ru RU\) のサポートを追加する:  
+  
+    -   「en\-US」、つまり英語 \(米国\) カルチャを、Strings.en\-US.resx または Strings.en\-US.txt をサポートするには、ストアを作成するための指定されたリソース ファイルは、一つの文字列は、値が「Hello\!」を持つ `Greeting` という名前です。  
+  
+    -   「fr\-FR」、つまりフランス語 \(フランス\) のカルチャをサポートするには、Strings.fr\-FR.resx または Strings.fr\-FR.txt とストアという名前のリソース ファイルを作成するには、一つの文字列は、値が「糖菓 jour\!」が `Greeting` という名前です。  
+  
+    -   「ru\-RU」の各または \(ロシア語ロシア語\) のカルチャをサポートするには、Strings.ru\-RU.resx または Strings.ru\-RU.txt とストアという名前のリソース ファイルを作成するには、一つの文字列は、値が「Привет\!」が `Greeting` という名前です。  
+  
+6.  バイナリ .resources ファイルに各テキストまたは XML リソース ファイルをコンパイルするために [Resgen.exe](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用します。  出力は、.resx ファイルまたは .txt ファイルと同じルート ファイル名を持つ、拡張子 .resources ファイル セットです。  Visual Studio と例を作成すると、コンパイル処理は自動的に処理されます。  Visual Studio を使用していない場合は、.resx ファイルを .resources ファイルにコンパイルするには、次のコマンドを実行する:  
+  
+    ```  
+    resgen filename  
+    ```  
+  
+     *filename* が .resx ファイルまたはテキスト ファイルの省略可能なパス、ファイル名と拡張子です。  
+  
+7.  遅延署名されたライブラリ アセンブリという StringLibrary.dll に既定のカルチャのリソース ファイルとともに StringLibrary.cs の次のソース・コードをコンパイルする:  
+  
+    > [!IMPORTANT]
+    >  例を作成したときに、Visual Studio ではなく、コマンド ラインを使用して `ResourceManager rm = new ResourceManager("Strings",` `typeof(Example).Assembly);`に <xref:System.Resources.ResourceManager> クラス コンストラクターの呼び出しを変更する必要があります。  
+  
+     [!code-csharp[Conceptual.Resources.Satellites#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.satellites/cs/stringlibrary.cs#1)]
+     [!code-vb[Conceptual.Resources.Satellites#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.satellites/vb/stringlibrary.vb#1)]  
+  
+     C\# コンパイラのコマンドは、次の操作:  
+  
+    ```  
+    csc /t:library /resource:Strings.resources /delaysign+ /keyfile:publickey.snk StringLibrary.cs  
+    ```  
+  
+     Visual Basic の対応するコンパイラのコマンドは、次の操作:  
+  
+    ```  
+    vbc /t:library /resource:Strings.resources /delaysign+ /keyfile:publickey.snk StringLibrary.vb  
+    ```  
+  
+8.  アプリケーションでサポートされているそれぞれのローカライズされたカルチャのメイン アプリケーション ディレクトリのサブディレクトリを作成します。  en\-US、fr\-FR と ru RU サブディレクトリを作成する必要があります。  Visual Studio は、コンパイル処理の一部としてこれらのサブディレクトリを自動的に作成されます。  すべてのサテライト アセンブリが同じファイル名を持つため、個々のカルチャのサテライト アセンブリを格納するために、公開キーと秘密キーのキー ペアで署名するまでサブディレクトリが使用されます。  
+  
+9. 各カルチャ固有の .resources ファイルを遅延署名されたサテライト アセンブリに埋め込み、適切なディレクトリに保存します。  各 .resources ファイルの要素を指定するコマンドを次に示します。:  
+  
+    ```  
+    al /target:lib /embed:Strings.culture.resources /culture:culture /out:culture\StringLibrary.resources.dll /delay+ /keyfile:publickey.snk  
+    ```  
+  
+     *culture* がカルチャの名前です。  この例では、カルチャ名は en\-US、fr\-FR と ru RU です。  
+  
+10. [Strong Name Tool \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用して StringLibrary.dll に再署名します。次のよう:  
+  
+    ```  
+    sn –R StringLibrary.dll RealKeyPair.snk  
+    ```  
+  
+11. 個々のサテライト アセンブリに再署名します。  次のように、各サテライト アセンブリでこれを行うには、[Strong Name Tool \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用する:  
+  
+    ```  
+    sn –R StringLibrary.resources.dll RealKeyPair.snk  
+    ```  
+  
+12. 次のコマンドを使用して StringLibrary.dll、グローバル アセンブリ キャッシュのサテライト アセンブリに登録する:  
+  
+    ```  
+    gacutil /i filename  
+    ```  
+  
+     *filename* を登録するファイルの名前です。  
+  
+13. Visual Studio を使用している場合は、`Example`という名前の **\[コンソール アプリケーション\]** の新しいプロジェクトを作成し、StringLibrary.dll への参照、および次のソース・コードを追加し、コンパイルします。  
+  
+     [!code-csharp[Conceptual.Resources.Satellites#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.satellites/cs/example.cs#3)]
+     [!code-vb[Conceptual.Resources.Satellites#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.satellites/vb/example.vb#3)]  
+  
+     コマンド ラインからコンパイルするには、C\# コンパイラでは、次のコマンドを使用します。:  
+  
+    ```  
+    csc Example.cs /r:StringLibrary.dll   
+    ```  
+  
+     Visual Basic コンパイラのコマンド ラインでは、次の操作:  
+  
+    ```  
+    vbc Example.vb /r:StringLibrary.dll   
+    ```  
+  
+14. Example.exe を実行します。  
+  
+## 参照  
+ [リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)   
+ [アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)   
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)
\ No newline at end of file
diff --git a/docs/framework/resources/index.md b/docs/framework/resources/index.md
new file mode 100644
index 00000000000..2247724757b
--- /dev/null
+++ b/docs/framework/resources/index.md
@@ -0,0 +1,76 @@
+---
+title: "デスクトップ アプリケーションのリソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション リソース"
+  - "配置 (アプリケーションを) [.NET Framework] , リソース"
+  - "ローカリゼーション"
+  - "ローカライズ (リソースを)"
+  - "パッケージ化 (アプリケーション リソースの)"
+  - "リソース ファイル"
+  - "サテライト アセンブリ"
+ms.assetid: 8ad495d4-2941-40cf-bf64-e82e85825890
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# デスクトップ アプリケーションのリソース
+ほとんどの製品レベルのアプリでは、リソースを使用する必要があります。  リソースは実行不可能なデータであり、アプリと共に論理的に配置されます。  このリソースは、アプリ内ではエラー メッセージまたはユーザー インターフェイスの一部として表示できます。  リソースには、文字列、イメージ、永続化されたオブジェクトなど、多数の形式のデータを含めることができます。\(永続化されたオブジェクトをリソース ファイルに書き込むには、そのオブジェクトをシリアル化できることが必要です\)。データをリソース ファイルに格納しておけば、アプリ全体を再コンパイルすることなくデータを変更できます。  また、データの格納場所が 1 つになり、複数の場所に格納されているハードコーディングされたデータを利用する必要がなくなります。  
+  
+ .NET Framework は、デスクトップ アプリのリソースの作成とローカライズを包括的にサポートします。  さらに、.NET Framework は、デスクトップ アプリのローカライズされたリソースのパッケージ化および配置のためのシンプルなモデルもサポートしています。  
+  
+ ASP.NET のリソースの詳細については、Internet Explorer デベロッパー センターの「[ASP.NET Web Page Resources Overview](../Topic/ASP.NET%20Web%20Page%20Resources%20Overview.md)」を参照してください。  
+  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリは、デスクトップ アプリとは異なるリソース モデルを使用して、1 つのパッケージ リソース インデックス \(PRI\) ファイルにリソースを格納します。  [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリのリソースの詳細については、Windows デベロッパー センターの「[Windows ストア アプリでのリソースの作成と取得](http://go.microsoft.com/fwlink/p/?LinkId=241674)」を参照してください。  
+  
+## リソースの作成とローカライズ  
+ ローカライズされていないアプリでは、リソース ファイルをアプリ データ、特にソース コード内の複数の場所にハードコーディングされる可能性がある文字列のリポジトリとして使用できます。  ほとんどの場合、リソースはテキスト \(.txt\) ファイルまたは XML \(.resx\) ファイルとして作成し、[Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使用して .resources バイナリ ファイルにコンパイルします。  これらのファイルは、言語コンパイラでアプリの実行可能ファイルに埋め込むことができます。  リソースの作成の詳細については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」を参照してください。  
+  
+ アプリのリソースを特定のカルチャに合わせてローカライズすることもできます。  これにより、アプリのローカライズ \(翻訳\) バージョンを構築できます。  ローカライズされたリソースを使用するアプリを開発する場合、ニュートラル カルチャまたはフォールバック カルチャとして使用するカルチャを指定します。適切なリソースがない場合はそのカルチャのリソースが使用されます。  一般に、ニュートラル カルチャのリソースはアプリの実行可能ファイルに格納されます。  個々のローカライズされたカルチャのその他のリソースはスタンドアロンのサテライト アセンブリに格納されます。  詳細については、「[サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md)」を参照してください。  
+  
+## リソースのパッケージ化と配置  
+ ローカライズされたアプリ リソースは[サテライト アセンブリ](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)に配置します。  サテライト アセンブリには 1 つのカルチャのリソースが含まれます。アプリケーション コードは含まれません。  サテライト アセンブリの配置モデルでは、1 つの既定アセンブリ \(一般的にはメイン アセンブリ\) と、アプリがサポートするカルチャごとに 1 つのサテライト アセンブリを使用するアプリを作成します。  サテライト アセンブリはメイン アセンブリには含まれないため、アプリのメイン アセンブリを交換しなくても、特定のカルチャに対応するリソースのみを簡単に交換または更新できます。  
+  
+ どのリソースをアプリの既定のリソース アセンブリに含めるかは、慎重に決定してください。  これはメイン アセンブリの一部に含まれるため、変更するためにはメイン アセンブリを交換する必要が生じます。  既定のリソースを提供しないと、[リソース フォールバック プロセス](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)によって既定リソースが検索されるときに例外が発生します。  アプリが適切にデザインされていれば、リソースの使用によって例外が発生することはありません。  
+  
+ 詳細については、「[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)」の記事を参照してください。  
+  
+## リソースの取得  
+ 実行時に、アプリは、<xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName> プロパティで指定されるカルチャに基づいて、適切なローカライズ バージョンのリソースをスレッド単位で読み込みます。  このプロパティ値の派生は次のように行われます。  
+  
+-   ローカライズされたカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトを <xref:System.Threading.Thread.CurrentUICulture%2A?displayProperty=fullName> プロパティに直接割り当てます。  
+  
+-   カルチャが明示的に割り当てられていない場合は、<xref:System.Globalization.CultureInfo.DefaultThreadCurrentUICulture%2A?displayProperty=fullName> プロパティから既定のスレッド UI カルチャを取得します。  
+  
+-   既定のスレッド UI カルチャが明示的に割り当てられていない場合は、Windows の `GetUserDefaultUILanguage` 関数を呼び出して、ローカル コンピューター上の現在のユーザーのカルチャを取得します。  
+  
+ 現在の UI カルチャを設定する方法の詳細については、「<xref:System.Globalization.CultureInfo>」リファレンス ページと「<xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName>」リファレンス ページを参照してください。  
+  
+ これで、<xref:System.Resources.ResourceManager?displayProperty=fullName> クラスを使用して、現在の UI カルチャまたは特定のカルチャのリソースを取得できます。  <xref:System.Resources.ResourceManager> クラスはデスクトップ アプリのリソースを取得する場合に最もよく使用されますが、<xref:System.Resources?displayProperty=fullName> 名前空間には、リソースの取得に使用できるその他のタイプも含まれています。  次にその例を示します。  
+  
+-   <xref:System.Resources.ResourceReader> クラス。アセンブリに埋め込まれているリソースまたはスタンドアロンの .resources バイナリ ファイルに格納されているリソースを列挙できます。  これは、実行時に使用可能なリソースの正確な名前がわからない場合に役立ちます。  
+  
+-   <xref:System.Resources.ResXResourceReader> クラス。XML \(.resx\) ファイルからリソースを取得できます。  
+  
+-   <xref:System.Resources.ResourceSet> クラス。フォールバック規則に従わずに特定のカルチャのリソースを取得できます。  リソースは、アセンブリ、またはスタンドアロンの .resources バイナリ ファイルに格納できます。  また、<xref:System.Resources.IResourceReader> の実装も開発できます。この実装によって、<xref:System.Resources.ResourceSet> クラスを使用して他のソースからリソースを取得できるようになります。  
+  
+-   <xref:System.Resources.ResXResourceSet> クラス。XML リソース ファイル内のすべての項目を取得してメモリに格納できます。  
+  
+## 参照  
+ <xref:System.Globalization.CultureInfo>   
+ <xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName>   
+ [アプリケーションの基本事項](../../../docs/standard/application-essentials.md)   
+ [リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)   
+ [リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)   
+ [サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md)   
+ [リソースの取得](../../../docs/framework/resources/retrieving-resources-in-desktop-apps.md)
\ No newline at end of file
diff --git a/docs/framework/resources/media/resappdir.gif b/docs/framework/resources/media/resappdir.gif
new file mode 100644
index 00000000000..22ac3fd944d
Binary files /dev/null and b/docs/framework/resources/media/resappdir.gif differ
diff --git a/docs/framework/resources/media/satelliteassemblydir.gif b/docs/framework/resources/media/satelliteassemblydir.gif
new file mode 100644
index 00000000000..da61836ace3
Binary files /dev/null and b/docs/framework/resources/media/satelliteassemblydir.gif differ
diff --git a/docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md b/docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md
new file mode 100644
index 00000000000..72e81380a58
--- /dev/null
+++ b/docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md
@@ -0,0 +1,194 @@
+---
+title: "デスクトップ アプリケーションでのリソースのパッケージ化と配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (アプリケーションを) [.NET Framework]、リソース"
+  - "リソース ファイル、配置"
+  - "ハブ アンド スポーク リソース配置モデル"
+  - "リソース ファイル、パッケージ化"
+  - "アプリケーション リソース、パッケージ化"
+  - "単一リソース アセンブリ"
+  - "サテライト アセンブリ"
+  - "既定のカルチャ (アプリケーションの)"
+  - "名前 [.NET Framework]、リソース"
+  - "フォールバック プロセス (リソースの)"
+  - "グループ化 (カルチャの)"
+  - "アプリケーション リソース、配置"
+  - "アプリケーション リソース、名前付け規則"
+  - "カルチャ、パッケージ化と配置 (リソースの)"
+  - "リソース ファイル、名前付け規則"
+  - "パッケージ化 (アプリケーション リソースの)"
+  - "アプリケーション リソース、フォールバック プロセス"
+  - "リソース ファイル、フォールバック プロセス"
+  - "ローカライズ (リソースを)"
+  - "ニュートラル カルチャ"
+ms.assetid: b224d7c0-35f8-4e82-a705-dd76795e8d16
+caps.latest.revision: 26
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# デスクトップ アプリケーションでのリソースのパッケージ化と配置
+アプリケーションがローカライズされたリソースを取得するに <xref:System.Resources.ResourceManager> クラスによって表される .NET Framework リソース マネージャーに依存します。  リソース マネージャーは、リソースのパッケージ化と配置にハブ アンド スポーク モデルを使用していることを前提としています。  ハブは、ローカライズできない実行可能コードと、ニュートラルまたは既定のカルチャと呼ばれる単一のカルチャのリソースを含むメイン アセンブリです。  既定のカルチャは、アプリケーションで使用されるフォールバック カルチャです; ローカライズされたリソースが見つからない場合は、リソースを使用するのはカルチャです。  各スポークは、単一のカルチャ用のリソースを含むが、コードはまったく含まないサテライト アセンブリにつながります。  
+  
+ このモデルにはいくつかのメリットがあります。  
+  
+-   アプリケーションを配置した後で、新しいカルチャ用のリソースを徐々に追加していくことができます。  アプリケーションの開発後に、カルチャ固有のリソースを開発するために長時間を要する場合があります。このモデルを使用すると、まずメイン アプリケーションをリリースし、後日にカルチャ固有のリソースをリリースできます。  
+  
+-   アプリケーションのサテライト アセンブリを更新または変更するときに、アプリケーションを再コンパイルしなくても済みます。  
+  
+-   アプリケーションは、特定のカルチャに必要なリソースを含むサテライト アセンブリだけを読み込みます。  このため、システム リソースの使用率を大幅に下げることができます。  
+  
+ ただし、このモデルにはデメリットもあります。  
+  
+-   複数のリソース セットを管理する必要があります。  
+  
+-   複数の構成をテストする必要があるので、アプリケーションのテストにかかる初期費用が増大します。  しかし、長い期間で捉えると、複数の国際バージョンを平行してテストおよび保守するよりも、複数のサテライトを持つ 1 つのコア アプリケーションをテストする方が簡単で負荷もかかりません。  
+  
+## リソースの名前付け規則  
+ アプリケーションのリソースをパッケージ化するときには、共通言語ランタイムが要求するリソースの名前付け規則を使用して、各リソースに名前を付ける必要があります。  ランタイムはカルチャ名でリソースを識別します。  各カルチャは、言語と関連付けられた 2 文字の小文字のカルチャ名と、組み合わせやには一意の名前、国に関連付けられた 2 文字の大文字のサブカルチャ、の名前または空白を必要に応じて設定されます。  サブカルチャ名がある場合は、カルチャ名の後ろにダッシュ \(\-\) で区切って続けます。  例では、日本語、米国、ドイツ語の de\-AT ドイツで、オーストリアで話されるで話されるドイツ語にの de\-DE で話される英語にの en\-US で話されるに日本語の ja\-JP が含まれます。  カルチャ名の [各国語サポート \(NLS\) のリファレンス](http://go.microsoft.com/fwlink/?LinkId=200048) 一覧については、Go Global Developer Center で参照してください。  
+  
+> [!NOTE]
+>  リソース ファイルの作成方法の詳細については、MSDN ライブラリの [リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md) と [サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md) を参照してください。  
+  
+<a name="cpconpackagingdeployingresourcesanchor1"></a>   
+## リソース フォールバック プロセス  
+ リソースをパッケージ化および配置するためのハブ アンド スポーク モデルは、代替プロセスを使用して適切なリソースを検索します。  アプリケーションが利用できないローカライズされたリソースを要求した場合、共通言語ランタイムによって、ユーザーの要求に一致する検索し、最終的な解決策としては例外をスローします、適切なフォールバック カルチャのリソースを階層を示します。  階層の各レベルにおいて、適切なリソースが見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからない場合、次のレベルへ移って検索が続行されます。  
+  
+ 検索のパフォーマンスを向上させるには、<xref:System.Resources.NeutralResourcesLanguageAttribute> 属性をメイン アセンブリに適用して、メイン アセンブリで使用するニュートラル言語の名前を渡します。  
+  
+> [!TIP]
+>  ランタイムがリソース アセンブリのプローブ リソース フォールバック プロセスとプロセスを最適化するために [\<relativeBindForResources\>](../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md) 構成要素を使用する方法があります。  詳細については、[リソース フォールバック プロセスを最適化する](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md#Optimizing) セクションを参照します。  
+  
+ リソース フォールバック プロセスは、次の手順があります。:  
+  
+1.  実行時の 1 番目のアプリケーションの要求されたカルチャと一致するアセンブリに [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md) を確認します。  
+  
+     グローバル アセンブリ キャッシュには、多数のアプリケーションによって共有されるリソース アセンブリを格納できます。  このため、作成するすべてのアプリケーションのディレクトリ構造内に、特定のリソース セットを含める必要がなくなります。  アセンブリへの参照が検出されると、そのアセンブリの中に要求されたリソースがあるかどうかが検索されます。  要求されたリソースがアセンブリ内に見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからなかった場合、ランタイムは検索を続行します。  
+  
+2.  次に、ランタイム チェック、要求されたカルチャと一致するディレクトリの現在実行しているアセンブリのディレクトリ。  ディレクトリが見つかった場合、そのディレクトリの中に、要求されたカルチャ用の有効なサテライト アセンブリがあるかどうかが検索されます。  次に、見つかったサテライト アセンブリの中で、要求されたリソースが検索されます。  アセンブリ内でリソースが見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからなかった場合、ランタイムは検索を続行します。  
+  
+3.  次に、ランタイムはクエリのサテライト アセンブリがオンデマンドでインストールされるかどうかを判定する Windows インストーラー。  その場合は、インストールを処理し、アセンブリを読み込み、それ以降は、要求されたリソースを検索します。  アセンブリ内でリソースが見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからなかった場合、ランタイムは検索を続行します。  
+  
+4.  ランタイムは、サテライト アセンブリを見つけることができないことを示すために <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを発生させます。  イベントを処理することを選択した場合、イベント ハンドラーはリソースの参照に使用するサテライト アセンブリへの参照を返すことができます。  それ以外の場合、イベント ハンドラーは `null` を返し、検索を示します。  
+  
+5.  次に、ランタイムはもう一度グローバル アセンブリ キャッシュを検索します、要求されたカルチャの親アセンブリを示します。  グローバル アセンブリ キャッシュ内に親アセンブリが存在する場合、ランタイムはそのアセンブリの中で、要求されたリソースを検索します。  
+  
+     親カルチャは、適切なフォールバック カルチャとして定義されます。  リソースを用意することが例外をスローすることで目的のため、フォールバック候補として親を検討してください。  このプロセスを使用して、リソースを再利用することもできます。  子のカルチャが要求されたリソースをローカライズする必要がない場合は、親のレベルだけに特定のリソースが含まれている必要があります。  たとえば、en \(ニュートラル英語\)、en\-GB \(英国で話される英語\)、および en\-US \(米国で話される英語\) 用のサテライト アセンブリを作成する場合、サテライト、共通用語が含まれ、en\-GB および en\-US サテライトは、それらの用語にのみオーバーライドを提供します。  
+  
+6.  ランタイムは次に、現在実行されているアセンブリのディレクトリの中に、親ディレクトリが含まれるかどうかをチェックします。  親ディレクトリが存在する場合、そのディレクトリの中で、親カルチャ用の有効なサテライト アセンブリが検索されます。  アセンブリが見つかった場合、そのアセンブリの中で要求されたリソースが検索されます。  リソースが見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからなかった場合、ランタイムは検索を続行します。  
+  
+7.  次に、ランタイムはクエリの親サテライト アセンブリがオンデマンドでインストールされるかどうかを判定する Windows インストーラー。  その場合は、インストールを処理し、アセンブリを読み込み、それ以降は、要求されたリソースを検索します。  アセンブリ内でリソースが見つかった場合、ランタイムはそのリソースを使用します。  リソースが見つからなかった場合、ランタイムは検索を続行します。  
+  
+8.  ランタイムは適切なフォールバック リソースを見つけることができないことを示すために <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを発生させます。  イベントを処理することを選択した場合、イベント ハンドラーはリソースの参照に使用するサテライト アセンブリへの参照を返すことができます。  それ以外の場合、イベント ハンドラーは `null` を返し、検索を示します。  
+  
+9. 次に、ランタイムの検索は多くの潜在的なレベルで前の手順 3 のようにアセンブリを、表示されます。  各カルチャに <xref:System.Globalization.CultureInfo.Parent%2A?displayProperty=fullName> のプロパティによって定義されている、親が独自の親があります。1 回の親は一つだけです。  親カルチャの検索は、カルチャの <xref:System.Globalization.CultureInfo.Parent%2A> のプロパティが <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName>を返すと停止します; リソース フォールバックの場合、インバリアント カルチャはリソースを使用するために、カルチャまたは親カルチャとは見なされません。  
+  
+10. もともと指定されたカルチャとそのすべての親を検索してもリソースが見つからない場合は、既定 \(フォールバック\) カルチャ用のリソースが使用されます。  通常、既定のカルチャのリソースは、メイン アプリケーション アセンブリに含まれています。  ただし、<xref:System.Resources.NeutralResourcesLanguageAttribute> 属性の <xref:System.Resources.NeutralResourcesLanguageAttribute.Location%2A> のプロパティには、リソースの最終フォールバック位置のサテライト アセンブリであるメイン アセンブリではなくことを示すために <xref:System.Resources.UltimateResourceFallbackLocation> の値を指定できます。  
+  
+    > [!NOTE]
+    >  既定のリソースは、メイン アセンブリとともにコンパイルできる唯一のリソースです。  <xref:System.Resources.NeutralResourcesLanguageAttribute> 属性を使用してサテライト アセンブリを指定しない限り、最終フォールバック \(最終的な親\) です。  したがって、メイン アセンブリに既定のリソース セットを常に組み込むことをお勧めします。  これにより、例外がスローされることを防止できます。  既定のリソース ファイルを含めておくことにより、すべてのリソース用のフォールバック リソースを用意して、カルチャに固有のリソースではなくても、少なくとも 1 つは利用できるリソースが確実に存在するようにしておくことができます。  
+  
+11. 最後に、ランタイムは、既定 \(フォールバック\) カルチャ用のリソースが見つからなかった場合、<xref:System.Resources.MissingManifestResourceException> または <xref:System.Resources.MissingSatelliteAssemblyException> 例外がリソースが見つからないことを示すためにスローされます。  
+  
+ たとえば、リソースがスペイン語 \(メキシコ\) 用に es\-MX \(カルチャ\) ローカライズしたアプリケーション要求とします。  ランタイムは、es\-MX に一致しますが、捜しましたりはアセンブリを最初にグローバル アセンブリ キャッシュを。  ランタイムは、es\-MX ディレクトリを実行しているアセンブリのディレクトリの現在検索します。  それが失敗すると、ランタイムは、適切なフォールバック カルチャを \(この場合は英語反映する親アセンブリをグローバル アセンブリ キャッシュを再度検索 \(スペイン語\)   親アセンブリが見つからなかった場合、ランタイムは es\-MX カルチャに対応するリソースが見つかるまで親アセンブリにあるすべてのレベルを検索します。  リソースが見つからなかった場合、ランタイムは既定のカルチャ用のリソースが使用されます。  
+  
+<a name="Optimizing"></a>   
+### リソース フォールバック プロセスを最適化する  
+ 次の状況では、ランタイムはサテライト アセンブリのリソースを検索するプロセスを最適化する  
+  
+-   サテライト アセンブリは、コード アセンブリと同じ場所に配置されます。  コードのアセンブリが [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)にインストールされている場合、サテライト アセンブリは、グローバル アセンブリ キャッシュにインストールされます。  コードのアセンブリがディレクトリにインストールされている場合、サテライト アセンブリは、ディレクトリのカルチャ固有のフォルダーにインストールされます。  
+  
+-   サテライト アセンブリは、オンデマンド インストールされていません。  
+  
+-   アプリケーション コードは <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを処理しません。  
+  
+ [\<relativeBindForResources\>](../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md) 要素を追加し、次の例に示すように、アプリケーションの構成ファイルで `true` へ `enabled` 属性を設定することによって、サテライト アセンブリのプローブを最適化します。  
+  
+```  
+  
+<configuration>  
+   <runtime>  
+      <relativeBindForResources enabled="true" />  
+   </runtime>  
+</configuration>  
+  
+```  
+  
+ サテライト アセンブリの最適化されたプローブが選択機能です。  つまり、ランタイムは [\<relativeBindForResources\>](../../../docs/framework/configure-apps/file-schema/runtime/relativebindforresources-element.md) 要素は、アプリケーションの構成ファイルで、`enabled` 属性が `true`に設定されている場合 [リソース フォールバック プロセス](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md#cpconpackagingdeployingresourcesanchor1) に記載されている手順に従います。  この場合、サテライト アセンブリのプローブのプロセスは、次のように変更します。:  
+  
+-   ランタイムでは、サテライト アセンブリのプローブに親コード アセンブリの場所が使用されます。  親アセンブリがグローバル アセンブリ キャッシュにインストールされている場合、ランタイムはキャッシュのアプリケーションのディレクトリにプローブします。  親アセンブリをアプリケーション ディレクトリにインストールされている場合、ランタイムは、アプリケーション ディレクトリに、グローバル アセンブリ キャッシュにプローブします。  
+  
+-   ランタイムでは、サテライト アセンブリのオンデマンド インストール用の Windows インストーラーを問い合わせません。  
+  
+-   特定のリソース アセンブリのプローブが失敗した場合、ランタイムは <xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントを発生させません。  
+  
+### サテライト アセンブリへの最終フォールバック  
+ オプションでメイン アセンブリからリソースを削除し、ランタイムが特定のカルチャに対応するサテライト アセンブリから最終フォールバック リソースを読み込むように指定できます。  フォールバック プロセスを制御するには、<xref:System.Resources.NeutralResourcesLanguageAttribute.%23ctor%28System.String%2CSystem.Resources.UltimateResourceFallbackLocation%29?displayProperty=fullName> のコンストラクターを使用して、リソース マネージャーは、メイン アセンブリとサテライト アセンブリからフォールバック リソースを取得する必要があるかどうかを指定する <xref:System.Resources.UltimateResourceFallbackLocation> パラメーターの値を指定します。  
+  
+ 次の例は、\(fr\) のフランス語の言語のサテライト アセンブリでアプリケーションのフォールバック リソースを格納するために <xref:System.Resources.NeutralResourcesLanguageAttribute> 属性を使用します。例に `Greeting`という名前の一つの文字列リソースを定義するには、2 とおりの、テキスト ベースのリソース ファイルがあります。  1 番目は、resources.fr.txt フランス語のリソースが含まれています。  
+  
+```  
+Greeting=Bon jour!  
+```  
+  
+ 2 番目のリソース、ru.txt、ロシア語のリソースが含まれています。  
+  
+```  
+Greeting=Добрый день  
+```  
+  
+ これら二つのファイルを .resources ファイルにコマンド ラインから [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を実行することによってコンパイルされます。フランス語のリソースの場合は、次の操作:  
+  
+ **resgen.exe resources.fr.txt**  
+  
+ ロシア語リソースに対して、次の操作:  
+  
+ **resgen.exe resources.ru.txt**  
+  
+ .resources ファイル、ダイナミック リンク ライブラリにフランス語のリソースのコマンド ラインから [アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を実行すると、次のように埋め込まれます:  
+  
+ **al \/t:lib \/embed:resources.fr.resources \/culture:fr \/out:fr\\Example1.resources.dll**  
+  
+ とロシア語のリソースに対しては次のように:  
+  
+ **al \/t:lib \/embed:resources.ru.resources \/culture:ru \/out:ru\\Example1.resources.dll**  
+  
+ アプリケーションのソース・コードは Example1.cs または Example1.vb という名前のファイルにあります。  これは、既定のアプリケーション リソースを fr サブディレクトリにあることを示すために <xref:System.Resources.NeutralResourcesLanguageAttribute> 属性が含まれています。  このメソッドは、リソース マネージャーをインスタンス化し、`Greeting` リソースの値を取得し、コンソールに表示されます。  
+  
+ [!code-csharp[Conceptual.Resources.Packaging#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.packaging/cs/example1.cs#1)]
+ [!code-vb[Conceptual.Resources.Packaging#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.packaging/vb/example1.vb#1)]  
+  
+ 次のようにコマンド ラインから C\# ソース・コードをコンパイルする:  
+  
+ **csc Example1.cs**  
+  
+ Visual Basic コンパイラのコマンドはよく似ています:  
+  
+ **vbc Example1.vb**  
+  
+ メイン アセンブリに埋め込まれるリソースがないため `/resource` スイッチを使用してコンパイルする必要はありません。  
+  
+ 言語がロシア語以外はであるシステムで例を実行すると、次の出力を表示する:  
+  
+```  
+Bon jour!  
+```  
+  
+## パッケージ化に関して提案される代替手段  
+ 期間または予算制約は、一連のアプリケーションがサポートするすべてのサブカルチャ用のリソースを作成しない場合もあります。  代わりに、すべての関連のサブカルチャが使用できる親カルチャ用に単一のサテライト アセンブリを作成できます。  たとえば、地域固有の英語のリソースを要求する、地域固有のドイツ語のリソースを要求するユーザーごとに一つの、サテライト アセンブリ German \(de\) をユーザーによって取得される単一の英語のサテライト アセンブリ \(en\-US\) を指定できます。  たとえば、ドイツのドイツ語 \(de\-DE\)、オーストリア \(de\-AT\)、およびスイス \(de\-CH\) で話されるドイツ語にの要求は、サテライト アセンブリ German \(de\) に戻ります。  したがって、既定のリソースは、最終フォールバックで、ほとんどのアプリケーション ユーザーから要求されるため、慎重に選択してこれらのリソースをリソース必要があります。  この方法はあまりカルチャに固有である配置しますが、アプリケーションのローカライズ費用をリソースを削減できます。  
+  
+## 参照  
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)   
+ [サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md)
\ No newline at end of file
diff --git a/docs/framework/resources/retrieving-resources-in-desktop-apps.md b/docs/framework/resources/retrieving-resources-in-desktop-apps.md
new file mode 100644
index 00000000000..c8a16f920b4
--- /dev/null
+++ b/docs/framework/resources/retrieving-resources-in-desktop-apps.md
@@ -0,0 +1,218 @@
+---
+title: "デスクトップ アプリケーションのリソースの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (アプリケーションを) [.NET Framework]、リソース"
+  - "リソース ファイル、配置"
+  - "リソース ファイル、パッケージ化"
+  - "アプリケーション リソース、パッケージ化"
+  - "ローカリゼーション"
+  - "バージョン管理 (サテライト アセンブリの)"
+  - "取得 (ローカライズされたリソースを)"
+  - "アプリケーション リソース、配置"
+  - "パッケージ化 (アプリケーション リソースの)"
+  - "バージョン管理 (リソースの)"
+  - "翻訳 (リソースから言語への)"
+  - "ローカライズ (リソースを)"
+ms.assetid: eca16922-1c46-4f68-aefe-e7a12283641f
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# デスクトップ アプリケーションのリソースの取得
+ローカライズされたリソースを NET Framework デスクトップ アプリケーションで使用する場合は、既定カルチャまたはニュートラル カルチャ用のリソースをメイン アセンブリと共にパッケージ化し、アプリでサポートされている言語またはカルチャごとに個別のサテライト アセンブリを作成することが理想的です。 名前付きリソースには、次のセクションで説明する <xref:System.Resources.ResourceManager> クラスを使用してアクセスすることができます。 目的のリソースをメイン アセンブリおよびサテライト アセンブリに埋め込まない場合でも、.resources バイナリ ファイルには直接アクセスすることができます。詳細については、「[.resources ファイルからのリソースの取得](#from_file)」セクションを参照してください。[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでリソースを取得するには、Windows デベロッパー センターの「[Windows ストア アプリでのリソースの作成と取得](http://go.microsoft.com/fwlink/p/?LinkID=241674)」を参照してください。  
+  
+<a name="from_assembly"></a>   
+## アセンブリからのリソースの取得  
+ <xref:System.Resources.ResourceManager> クラスでは、実行時にリソースにアクセスすることができます。 文字列リソースを取得するには <xref:System.Resources.ResourceManager.GetString%2A?displayProperty=fullName> メソッドを使用し、文字列以外のリソースを取得するには <xref:System.Resources.ResourceManager.GetObject%2A?displayProperty=fullName> メソッドまたは <xref:System.Resources.ResourceManager.GetStream%2A?displayProperty=fullName> メソッドを使用します。 各メソッドには、次の 2 つのオーバーロードが含まれます。  
+  
+-   唯一のパラメーターがリソースの名前を含む文字列であるオーバーロード。 メソッドでは、現在のスレッド カルチャ用にそのリソースの取得を試みます。 詳細については、<xref:System.Resources.ResourceManager.GetString%28System.String%29> メソッド、<xref:System.Resources.ResourceManager.GetObject%28System.String%29> メソッド、および <xref:System.Resources.ResourceManager.GetStream%28System.String%29> メソッドを参照してください。  
+  
+-   2 つのパラメーターを持つオーバー ロード。1 つは、リソースの名前が含まれる文字列で、もう 1 つは、リソースが取得されるカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトです。 そのカルチャ用に設定されたリソースが見つからない場合、リソース マネージャーはフォールバック規則を使用して適切なリソースを取得します。 詳細については、<xref:System.Resources.ResourceManager.GetString%28System.String%2CSystem.Globalization.CultureInfo%29> メソッド、<xref:System.Resources.ResourceManager.GetObject%28System.String%2CSystem.Globalization.CultureInfo%29> メソッド、および <xref:System.Resources.ResourceManager.GetStream%28System.String%2CSystem.Globalization.CultureInfo%29> メソッドを参照してください。  
+  
+ リソース マネージャーでは、アプリケーションでカルチャ固有のリソースを取得する方法を、リソース フォールバック プロセスを使用して制御します。 詳細については、「[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)」の「リソース フォールバック プロセス」セクションを参照してください。<xref:System.Resources.ResourceManager> オブジェクトをインスタンス化する方法については、<xref:System.Resources.ResourceManager> クラスに関するトピックの「ResourceManager オブジェクトのインスタンス化」セクションを参照してください。  
+  
+### 文字列データの取得: 例  
+ 次の例では、<xref:System.Resources.ResourceManager.GetString%28System.String%29> メソッドを呼び出すことで、現在の UI カルチャの文字列リソースを取得します。 ここでは、英語 \(米国\) カルチャ用のニュートラル文字列リソースと、フランス語 \(フランス\) カルチャおよびロシア語 \(ロシア\) カルチャ用のローカライズされたリソースが対象となります。 次の英語 \(米国\) リソースは、Strings.txt という名前のファイルに入っています。  
+  
+```  
+TimeHeader=The current time is  
+```  
+  
+ フランス語 \(フランス\) リソースは、Strings.fr\-FR.txt という名前のファイルに入っています。  
+  
+```  
+TimeHeader=L'heure actuelle est  
+```  
+  
+ ロシア語 \(ロシア\) リソースは、Strings.ru\-RU\-txt という名前のファイルに入っています。  
+  
+```  
+TimeHeader=Текущее время —  
+```  
+  
+ この例のソース コード \(C\# バージョンのコードについては GetString.cs という名前のファイルに、Visual Basic バージョンのコードについては GetString.vb という名前のファイルに入っています\) では、4 つのカルチャの名前を含む文字列配列が定義されます。具体的には、リソースが提供されている 3 つのカルチャと、スペイン語 \(スペイン\) カルチャです。 ランダムに 5 回実行されるループでは、これらのカルチャのいずれかを選択し、それを <xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティと <xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName> プロパティに割り当てます。 次に、<xref:System.Resources.ResourceManager.GetString%28System.String%29> メソッドを呼び出して、ローカライズされた文字列を取得します。この文字列は時刻と一緒に表示されます。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/getstring.cs#3)]
+ [!code-vb[Conceptual.Resources.Retrieving#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/getstring.vb#3)]  
+  
+ 次のバッチ \(.bat\) ファイルは、この例をコンパイルし、適切なディレクトリにサテライト アセンブリを生成します。 C\# 言語とコンパイラの場合は、コマンドが提供されています。 Visual Basic の場合は、`csc` を `vbc` に変更し、`GetString.cs` を `GetString.vb` に変更します。  
+  
+```  
+  
+resgen strings.txt  
+csc GetString.cs /resource:strings.resources  
+  
+resgen strings.fr-FR.txt  
+md fr-FR  
+al /embed:strings.fr-FR.resources /culture:fr-FR /out:fr-FR\GetString.resources.dll  
+  
+resgen strings.ru-RU.txt  
+md ru-RU  
+al /embed:strings.ru-RU.resources /culture:ru-RU /out:ru-RU\GetString.resources.dll  
+  
+```  
+  
+ 現在の UI カルチャがスペイン語 \(スペイン\) である場合、この例で表示されるのは英語リソースです。スペイン語のリソースは利用できず、この例の既定のカルチャは英語であるということが理由です。  
+  
+### オブジェクト データの取得: 2 つの例  
+ オブジェクト データを取得するには、<xref:System.Resources.ResourceManager.GetObject%2A> メソッドと <xref:System.Resources.ResourceManager.GetStream%2A> メソッドを使用します。 プリミティブ データ型、シリアル化可能なオブジェクト、およびバイナリ形式で格納されているオブジェクト \(画像など\) が取得対象となります。  
+  
+ 次の例では、<xref:System.Resources.ResourceManager.GetStream%28System.String%29> メソッドを使用して、アプリの開始スプラッシュ ウィンドウで使用されるビットマップを取得します。 CreateResources.cs \(C\# の場合\) または CreateResources.vb \(Visual Basic の場合\) に入っている次のソース コードは、シリアル化された画像を含む .resx ファイルを生成します。 この場合、画像は SplashScreen.jpg という名前のファイルから読み込まれます。ファイル名を変更して、独自の画像に置き換えることができます。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/createresources.cs#4)]
+ [!code-vb[Conceptual.Resources.Retrieving#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/createresources.vb#4)]  
+  
+ 次のコードでは、リソースを取得して画像を <xref:System.Windows.Forms.PictureBox> コントロール内に表示します。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/getstream.cs#5)]
+ [!code-vb[Conceptual.Resources.Retrieving#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/getstream.vb#5)]  
+  
+ 次のバッチ ファイルを使用すると、C\# の例をビルドできます。 Visual Basic の場合は、`csc` を `vbc` に変更し、さらにソース コード ファイルの拡張子を `.cs` から `.vb` に変更します。  
+  
+```  
+  
+csc CreateResources.cs  
+CreateResources  
+  
+resgen AppResources.resx  
+  
+csc GetStream.cs /resource:AppResources.resources  
+  
+```  
+  
+ 次の例では、<xref:System.Resources.ResourceManager.GetObject%28System.String%29?displayProperty=fullName> メソッドを使用して、カスタム オブジェクトを逆シリアル化します。 この例では、次に示す `PersonTable` という名前の構造体が定義されている UIElements.cs \(Visual Basic の場合は UIElements.vb\) という名前のソース コード ファイルを使用しています。 この構造体は、ローカライズされたテーブル列名を表示する一般的なテーブル表示ルーチンでの使用を目的としています。`PersonTable` 構造体は、<xref:System.SerializableAttribute> 属性でマークされています。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/example.cs#6)]
+ [!code-vb[Conceptual.Resources.Retrieving#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/example.vb#6)]  
+  
+ CreateResources.cs \(Visual Basic の場合は CreateResources.vb\) という名前のファイルに入っている次のコードは、UIResources.resx という名前の XML リソース ファイルを作成します。このリソース ファイルには、テーブルのタイトルに加えて、英語にローカライズされたアプリに関する情報を含む `PersonTable` オブジェクトが格納されます。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/example1.cs#7)]
+ [!code-vb[Conceptual.Resources.Retrieving#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/example.vb#7)]  
+  
+ GetObject.cs \(GetObject.vb\) という名前のソース コード ファイルに含まれる次のコードは、リソースを取得し、コンソールに表示します。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/example2.cs#8)]
+ [!code-vb[Conceptual.Resources.Retrieving#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/example2.vb#8)]  
+  
+ 次のバッチ ファイルを実行することで、必要なリソース ファイルとアセンブリをビルドし、アプリケーションを実行することができます。`PersonTable` 構造体に関する情報にアクセスできるように、`/r` オプションを使用して Resgen.exe を指定し、UIElements.dll への参照を含める必要があります。 C\# を使用している場合は、`vbc` コンパイラ名を `csc` に置換し、`.vb` 拡張子を `.cs` に置換します。  
+  
+```  
+  
+vbc /t:library UIElements.vb  
+vbc CreateResources.vb /r:UIElements.dll  
+CreateResources  
+  
+resgen UIResources.resx  /r:UIElements.dll  
+vbc GetObject.vb /r:UIElements.dll /resource:UIResources.resources  
+  
+GetObject.exe  
+  
+```  
+  
+## サテライト アセンブリのバージョン管理  
+ 既定では、<xref:System.Resources.ResourceManager> オブジェクトは、要求されたリソースを取得するとき、メイン アセンブリのバージョン番号と一致するバージョン番号を持つサテライト アセンブリを検索します。 アプリを展開したら、メイン アセンブリまたは特定のリソース サテライト アセンブリを更新することをお勧めします。 .NET Framework では、メイン アセンブリとサテライト アセンブリのバージョン管理をサポートしています。  
+  
+ メイン アセンブリのバージョン管理のサポートは、<xref:System.Resources.SatelliteContractVersionAttribute> 属性で指定されます。 この属性をアプリのメイン アセンブリで指定すると、サテライト アセンブリを更新しなくてもメイン アセンブリの更新および再展開を行うことができます。 メイン アセンブリを更新すると、メイン アセンブリのバージョン番号はインクリメントされますが、サテライト コントラクト バージョン番号はそのままで変わりありません。 リソース マネージャーは、要求されたリソースを取得するとき、この属性で指定されたサテライト アセンブリのバージョンを読み込みます。  
+  
+ 発行者ポリシー アセンブリでは、サテライト アセンブリのバージョン管理をサポートしています。 メイン アセンブリを更新することなく、サテライト アセンブリの更新および再展開を行うことができます。 サテライト アセンブリを更新すると、そのバージョン番号はインクリメントされ、発行者ポリシー アセンブリと一緒に出力されます。 発行者ポリシー アセンブリ内では、新しいサテライト アセンブリが旧バージョンと互換性があるように指定します。 リソース マネージャーでは、<xref:System.Resources.SatelliteContractVersionAttribute> 属性を使用してサテライト アセンブリのバージョンを特定しますが、アセンブリ ローダーは、発行元ポリシーで指定されたサテライト アセンブリのバージョンにバインドします。 発行者ポリシー アセンブリの詳細については、「[発行者ポリシー ファイルを作成する](../../../docs/framework/configure-apps/how-to-create-a-publisher-policy.md)」を参照してください。  
+  
+ アセンブリの完全なバージョン管理サポートを有効にするには、[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)内に厳密な名前を付けたアセンブリを展開し、アプリケーション ディレクトリ内に厳密な名前を持たないアセンブリを展開することをお勧めします。 厳密な名前を付けたアセンブリをアプリケーション ディレクトリに展開すると、更新時に、サテライト アセンブリのバージョン番号をインクリメントできなくなります。 そのため、インプレース更新を実行する必要があります。インプレース更新では、既存のコードを更新されたコードに置き換えて、同じバージョン番号を維持します。 たとえば、サテライト アセンブリのバージョン 1.0.0.0 を、完全に指定されたアセンブリ名 "myApp.resources, Version\=1.0.0.0, Culture\=de, PublicKeyToken\=b03f5f11d50a3a" で更新する場合は、完全に指定された同じアセンブリ名 "myApp.resources, Version\=1.0.0.0, Culture\=de, PublicKeyToken\=b03f5f11d50a3a" でコンパイルされた更新済みの myApp.resources.dll で上書きします。 サテライト アセンブリ ファイルに対してインプレース更新を使用すると、サテライト アセンブリのバージョンをアプリケーションで正確に特定するのが難しくなります。  
+  
+ アセンブリのバージョン管理の詳細については、「[アセンブリのバージョン管理](../../../docs/framework/app-domains/assembly-versioning.md)」と「[ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)」を参照してください。  
+  
+<a name="from_file"></a>   
+## .resources ファイルからのリソースの取得  
+ サテライト アセンブリにリソースを展開しないように選択した場合でも、<xref:System.Resources.ResourceManager> オブジェクトを使用して、.resources ファイルからリソースに直接アクセスすることができます。 そのためには、.resources ファイルを正しく展開する必要があります。 次に、<xref:System.Resources.ResourceManager.CreateFileBasedResourceManager%2A?displayProperty=fullName> メソッドを使用して <xref:System.Resources.ResourceManager> オブジェクトをインスタンス化し、スタンドアロンの .resources ファイルを含むディレクトリを指定します。  
+  
+### .resources ファイルの展開  
+ アプリケーション アセンブリとサテライト アセンブリに .resources ファイルを埋め込むと、各サテライト アセンブリのファイル名は同じになりますが、各サテライト アセンブリが配置される場所はそれぞれのカルチャを反映するサブディレクトリとなります。 これに対して、.resources ファイルからリソースに直接アクセスする場合は、すべての .resources ファイルを単一のディレクトリ \(通常は、アプリケーション ディレクトリのサブディレクトリ\) に配置することができます。 アプリの既定の .resources ファイルの名前は、ルート名のみで構成され、カルチャ名はありません \(たとえば、strings.resources\)。 ローカライズされた各カルチャのリソースが格納されるファイルの名前は、ルート名の後にカルチャが続きます \(たとえば、strings.ja.resources または strings.de\-DE.resources\)。 次の図では、ディレクトリ構造内のどこにリソース ファイルを配置する必要があるかを示しています。  
+  
+ ![アプリケーションのメイン ディレクトリ](../../../docs/framework/resources/media/resappdir.gif "resappdir")  
+ディレクトリ構造と .resources ファイルの名前付け規則  
+  
+### リソース マネージャーの使用  
+ リソースを作成し、それを適切なディレクトリに配置したら、<xref:System.Resources.ResourceManager.CreateFileBasedResourceManager%28System.String%2CSystem.String%2CSystem.Type%29> メソッドを呼び出して、リソースを使用する <xref:System.Resources.ResourceManager> オブジェクトを作成します。 最初のパラメーターでは、アプリの既定の .resources ファイルのルート名を指定します \(前のセクションの例では、"strings" でした\)。 2 番目のパラメーターでは、リソースの場所を指定します \(前の例では "Resources"\)。 3 番目のパラメーターでは、使用する <xref:System.Resources.ResourceSet> 実装を指定します。 3 番目のパラメーターが `null` である場合、既定のランタイム <xref:System.Resources.ResourceSet> が使用されます。  
+  
+> [!NOTE]
+>  ASP.NET アプリを展開する場合には、スタンドアロン .resources ファイルを使用しないでください。 このファイルを使用すると、ロックの問題が生じ、XCOPY 展開が破損する恐れがあります。 ASP.NET リソースの展開先はサテライト アセンブリにすることをお勧めします。 詳細については、「[ASP.NET Web Page Resources Overview](../Topic/ASP.NET%20Web%20Page%20Resources%20Overview.md)」を参照してください。  
+  
+ <xref:System.Resources.ResourceManager> オブジェクトをインスタンス化したら、前述したように <xref:System.Resources.ResourceManager.GetString%2A> メソッド、<xref:System.Resources.ResourceManager.GetObject%2A> メソッド、<xref:System.Resources.ResourceManager.GetStream%2A> メソッドを使用してリソースを取得します。 ただし、.resources ファイルからリソースを直接取得することは、アセンブリから埋め込みリソースを取得することとは異なります。 .resources ファイルからリソースを取得する場合、<xref:System.Resources.ResourceManager.GetString%28System.String%29> メソッド、<xref:System.Resources.ResourceManager.GetObject%28System.String%29> メソッド、および <xref:System.Resources.ResourceManager.GetStream%28System.String%29> メソッドは、現在のカルチャに関係なく、常に既定のカルチャのリソースを取得します。 アプリケーションの現在のカルチャまたは特定のカルチャのリソースを取得するには、<xref:System.Resources.ResourceManager.GetString%28System.String%2CSystem.Globalization.CultureInfo%29> メソッド、<xref:System.Resources.ResourceManager.GetObject%28System.String%2CSystem.Globalization.CultureInfo%29> メソッド、または <xref:System.Resources.ResourceManager.GetStream%28System.String%2CSystem.Globalization.CultureInfo%29> メソッドを呼び出して、どのカルチャのリソースを取得するのか指定する必要があります。 現在のカルチャのリソースを取得するには、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティの値を `culture` 引数として指定します。 リソース マネージャーは、`culture` のリソースを取得できない場合、標準的なリソース フォールバック規則を使用して適切なリソースを取得します。  
+  
+### 例  
+ 次の例では、リソース マネージャーが .resources ファイルからリソースを直接取得する方法を示しています。 この例は、英語 \(米国\) カルチャ、フランス語 \(フランス\) カルチャ、ロシア語 \(ロシア\) カルチャ用の 3 つのテキスト ベースのリソース ファイルで構成されます。 英語 \(米国\) は、この例の既定のカルチャです。 このリソースは、次の Strings.txt という名前のファイルに格納されています。  
+  
+```  
+Greeting=Hello  
+Prompt=What is your name?  
+```  
+  
+ フランス語 \(フランス\) カルチャのリソースは、次の Strings.fr\-FR.txt という名前のファイルに格納されています。  
+  
+```  
+Greeting=Bon jour  
+Prompt=Comment vous appelez-vous?  
+```  
+  
+ ロシア語 \(ロシア\) カルチャのリソースは、次の Strings.ru\-RU.txt という名前のファイルに格納されています。  
+  
+```  
+Greeting=Здравствуйте  
+Prompt=Как вас зовут?  
+```  
+  
+ この例のソース コードを次に示します。 この例では、英語 \(米国\)、英語 \(カナダ\)、フランス語 \(フランス\)、およびロシア語 \(ロシア\) カルチャ用の <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化し、それぞれを現在のカルチャとします。 次に、<xref:System.Resources.ResourceManager.GetString%28System.String%2CSystem.Globalization.CultureInfo%29?displayProperty=fullName> メソッドで、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティの値を `culture` 引数として指定して、カルチャ固有の適切なリソースを取得します。  
+  
+ [!code-csharp[Conceptual.Resources.Retrieving#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.retrieving/cs/example3.cs#9)]
+ [!code-vb[Conceptual.Resources.Retrieving#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.retrieving/vb/example3.vb#9)]  
+  
+ この例の C\# バージョンをコンパイルするには、次のバッチ ファイルを実行します。 Visual Basic を使用している場合は、`csc` を `vbc` に置換し、`.cs` 拡張子を `.vb` に置換します。  
+  
+```  
+  
+Md Resources  
+Resgen Strings.txt Resources\Strings.resources  
+Resgen Strings.fr-FR.txt Resources\Strings.fr-FR.resources  
+Resgen Strings.ru-RU.txt Resources\Strings.ru-RU.resources  
+  
+csc Example.cs  
+  
+```  
+  
+## 参照  
+ <xref:System.Resources.ResourceManager>   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [Windows ストア アプリでのリソースの作成と取得](http://go.microsoft.com/fwlink/p/?LinkID=241674)
\ No newline at end of file
diff --git a/docs/framework/resources/working-with-resx-files-programmatically.md b/docs/framework/resources/working-with-resx-files-programmatically.md
new file mode 100644
index 00000000000..407f39ed4e6
--- /dev/null
+++ b/docs/framework/resources/working-with-resx-files-programmatically.md
@@ -0,0 +1,92 @@
+---
+title: "プログラムによる .resx ファイルの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "リソース ファイル、.resx ファイル"
+  - ".resx ファイル"
+ms.assetid: 168f941a-2b84-43f8-933f-cf4a8548d824
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# プログラムによる .resx ファイルの使用
+XML リソース \(.resx\) ファイルは適切に定義された XML で構成する必要があり、特定のスキーマに従ったヘッダーの後に、名前と値のペアになったデータが続きます。そのため、手動で作成するとエラーが発生しやすくなります。 代わりに、.NET Framework クラス ライブラリの型とメンバーを使って、.resx ファイルをプログラムで作成できます。 また、.resx ファイルに格納されているリソースを取得するために、.NET Framework クラス ライブラリを使うこともできます。 このトピックでは、<xref:System.Resources> 名前空間の型とメンバーを使って、.resx ファイルを操作する方法を説明します。  
+  
+ なお、この記事では、リソースを含む XML \(.resx\) ファイルの操作について説明します。 アセンブリに埋め込まれたバイナリ リソース ファイルの操作について詳しくは、<xref:System.Resources.ResourceManager> トピックをご覧ください。  
+  
+> [!WARNING]
+>  プログラムでの操作以外にも、.resx ファイルを操作する方法はあります。 リソース ファイルを Visual Studio プロジェクトに追加すると、Visual Studio では、.resx ファイルを作成して維持するためのインターフェイスが提供され、コンパイル時に .resx ファイルは .resources ファイルに自動的に変換されます。 .resx ファイルを直接操作するためにテキスト エディターを使うこともできます。 ただし、ファイルの破損を避けるため、ファイルに格納されているバイナリ情報を変更しないように注意してください。  
+  
+## .resx ファイルを作成する  
+ <xref:System.Resources.ResXResourceWriter?displayProperty=fullName> クラスを使い、次の手順に従って .resx ファイルをプログラムで作成できます。  
+  
+1.  <xref:System.Resources.ResXResourceWriter.%23ctor%28System.String%29?displayProperty=fullName> メソッドを呼び出して、.resx ファイルの名前を指定することにより、<xref:System.Resources.ResXResourceWriter> オブジェクトをインスタンス化します。 ファイル名には、.resx 拡張子を含める必要があります。`using` ブロック内の <xref:System.Resources.ResXResourceWriter> オブジェクトをインスタンス化する場合、手順 3 で <xref:System.Resources.ResXResourceWriter.Close%2A?displayProperty=fullName> メソッドを明示的に呼び出す必要はありません。  
+  
+2.  ファイルに追加するリソースごとに <xref:System.Resources.ResXResourceWriter.AddResource%2A?displayProperty=fullName> メソッドを呼び出します。 このメソッドのオーバーロードを使って、文字列、オブジェクト、バイナリ \(バイト配列\) のデータを追加します。 リソースがオブジェクトの場合は、シリアル化可能でなければなりません。  
+  
+3.  <xref:System.Resources.ResXResourceWriter.Close%2A?displayProperty=fullName> メソッドを呼び出して、リソース ファイルを生成し、すべてのリソースを解放します。<xref:System.Resources.ResXResourceWriter> オブジェクトが `using` ブロック内で作成された場合、リソースは .resx ファイルに書き込まれ、<xref:System.Resources.ResXResourceWriter> オブジェクトが使うリソースは `using` ブロックの最後に解放されます。  
+  
+ 結果として得られる .resx ファイルには、適切なヘッダーと <xref:System.Resources.ResXResourceWriter.AddResource%2A?displayProperty=fullName> メソッドによって追加された各リソースの `data` タグが含まれます。  
+  
+> [!WARNING]
+>  パスワード、セキュリティの配慮が必要な情報、プライベートなデータなどの格納には、リソース ファイルを使用しないでください。  
+  
+ 次の例では、6 つの文字列、1 つのアイコン、2 つのアプリケーション定義オブジェクト \(2 つの `Automobile` オブジェクト\) を格納する CarResources.resx という名前の .resx ファイルを作成します。 例で定義されてインスタンス化された `Automobile` クラスは、<xref:System.SerializableAttribute> 属性でタグ付けされることに注意してください。  
+  
+ [!code-csharp[Conceptual.Resources.ResX#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.resx/cs/create1.cs#1)]
+ [!code-vb[Conceptual.Resources.ResX#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.resx/vb/create1.vb#1)]  
+  
+> [!IMPORTANT]
+>  Visual Studio を使って .resx ファイルを作成することもできます。 コンパイル時に、Visual Studio は [リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使って、.resx ファイルをバイナリ リソース \(.resources\) ファイルに変換し、アプリケーション アセンブリかサテライト アセンブリのいずれかに埋め込みます。  
+  
+ .resx ファイルをランタイムの実行可能ファイルに埋め込むことや、サテライト アセンブリにコンパイルすることはできません。[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使って、.resx ファイルをバイナリ リソース \(.resources\) ファイルに変換する必要があります。 結果として得られる .resources ファイルは、アプリケーション アセンブリやサテライト アセンブリに埋め込むことができます。 詳細については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」を参照してください。  
+  
+## リソースを列挙する  
+ 場合によっては、.resx ファイルから、特定のリソースではなく、すべてのリソースを取得したいことがあります。 これを行うには、.resx ファイル内のすべてのリソースの列挙子を提供する <xref:System.Resources.ResXResourceReader?displayProperty=fullName> クラスを使います。<xref:System.Resources.ResXResourceReader?displayProperty=fullName> クラスは <xref:System.Collections.IDictionaryEnumerator> を実装します。これは、ループの反復処理ごとに特定のリソースを示す <xref:System.Collections.DictionaryEntry> を返します。 その <xref:System.Collections.DictionaryEntry.Key%2A?displayProperty=fullName> プロパティはリソースのキーを返し、その <xref:System.Collections.DictionaryEntry.Value%2A?displayProperty=fullName> プロパティはリソースの値を返します。  
+  
+ 次の例では、前の例で作成した CarResources.resx ファイルの <xref:System.Resources.ResXResourceReader> オブジェクトを作成して、リソース ファイルを反復処理します。 リソース ファイルに定義された 2 つの `Automobile` オブジェクトを <xref:System.Collections.Generic.List%601?displayProperty=fullName> オブジェクトに追加し、6 個中 5 個の文字列を <xref:System.Collections.SortedList> オブジェクトに追加します。<xref:System.Collections.SortedList> オブジェクト内の値は、コンソールに列見出しを表示するために使われるパラメーター配列に変換されます。`Automobile` プロパティ値もコンソールに表示されます。  
+  
+ [!code-csharp[Conceptual.Resources.ResX#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.resx/cs/enumerate1.cs#2)]
+ [!code-vb[Conceptual.Resources.ResX#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.resx/vb/enumerate1.vb#2)]  
+  
+## 特定のリソースを取得する  
+ .resx ファイル内の項目を列挙することに加えて、<xref:System.Resources.ResXResourceSet?displayProperty=fullName> クラスを使って特定のリソースを名前によって取得できます。<xref:System.Resources.ResourceSet.GetString%28System.String%29?displayProperty=fullName> メソッドは、名前付きの文字列リソースの値を取得します。<xref:System.Resources.ResourceSet.GetObject%28System.String%29?displayProperty=fullName> メソッドは、名前付きオブジェクトの値やバイナリ データを取得します。 メソッドはオブジェクトを返します。そのオブジェクトはその後適切な型のオブジェクトにキャスト \(C\#\) するか、変換 \(Visual Basic\) する必要があります。  
+  
+ 次の例では、そのリソース名を使って、フォームのキャプション文字列とアイコンを取得します。 また、前の例で使ったアプリケーション定義の `Automobile` オブジェクトを取得して、<xref:System.Windows.Forms.DataGridView> コントロールに表示します。  
+  
+ [!code-csharp[Conceptual.Resources.ResX#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.resx/cs/retrieve1.cs#3)]
+ [!code-vb[Conceptual.Resources.ResX#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.resx/vb/retrieve1.vb#3)]  
+  
+## .resx ファイルをバイナリ .resources ファイルに変換する  
+ .resx ファイルを埋め込みバイナリ リソース \(.resources\) ファイルに変換することには、大きな利点があります。 .resx ファイルは、アプリケーション開発中の読み取りや保守を容易に行うことができますが、完成したアプリケーションに含まれることはほとんどありません。 .resx ファイルがアプリケーションと共に配布される場合、アプリケーションの実行可能ファイルとそれに付随するライブラリとは異なる独立したファイルとして存在します。 これに対し、.resources ファイルは、アプリケーションの実行可能ファイルやそれに付随するアセンブリに埋め込まれます。 また、ローカライズされたアプリケーションの場合、実行時に .resx ファイルに依存すると、開発者がリソース フォールバックを処理することになります。 これに対し、埋め込みの .resources ファイルを含むサテライト アセンブリのセットが作成された場合、共通言語ランタイムがリソース フォールバック プロセスを処理します。  
+  
+ .resx ファイルを .resources ファイルに変換するには、[リソース ファイル ジェネレーター \(Resgen.exe\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md) を使います。リソース ファイル ジェネレーターの基本的な構文は次のとおりです。  
+  
+ **Resgen.exe** *.resxFilename*  
+  
+ 結果は、.resx ファイルと同じルート ファイル名と .resources ファイル拡張子を持つバイナリ リソース ファイルになります。 その後、コンパイル時に、このファイルを実行可能ファイルやライブラリにコンパイルできます。 Visual Basic コンパイラを使っている場合、次の構文を使って、.resources ファイルをアプリケーションの実行可能ファイルに埋め込みます。  
+  
+ **vbc** *filename* **.vb \/resource:** *.resourcesFilename*  
+  
+ C\# を使っている場合、構文は次のとおりです。  
+  
+ **csc** *filename* **.cs \/resource:** *.resourcesFilename*  
+  
+ [アセンブリ リンカー \(AL.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使って、.resources ファイルをサテライト アセンブリに埋め込むこともできます。アセンブリ リンカーの基本的な構文は次のとおりです。  
+  
+ **al** *resourcesFilename* **\/out:** *assemblyFilename*  
+  
+## 参照  
+ [リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)   
+ [Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)
\ No newline at end of file
diff --git a/docs/framework/security/TOC.md b/docs/framework/security/TOC.md
new file mode 100644
index 00000000000..404438b95c4
--- /dev/null
+++ b/docs/framework/security/TOC.md
@@ -0,0 +1,43 @@
+# [発行者名レジストリの検証パッケージのダウンロード](downloading-the-validating-issuer-name-registry-package.md)
+# [WIF および Web ファーム](wif-and-web-farms.md)
+# [WIF 構成スキーマの規則](wif-configuration-schema-conventions.md)
+# [方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする](how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md)
+# [WIF を使用したクレーム ベースの承認](claims-based-authorization-using-wif.md)
+# [初めてのクレーム対応 WCF サービスのビルド](building-my-first-claims-aware-wcf-service.md)
+# [JSON Web トークン ハンドラー パッケージのダウンロード](downloading-the-json-web-token-handler-package.md)
+# [発行者名レジストリの検証](validating-issuer-name-registry.md)
+# [操作方法: WCF Web サービス アプリケーションの WIF を有効にする](how-to-enable-wif-for-a-wcf-web-service-application.md)
+# [WIF の拡張](wif-extensions.md)
+# [アンマネージ コードの安全なコーディングのガイドライン](secure-coding-guidelines-for-unmanaged-code.md)
+# [WIF の概要](getting-started-with-wif.md)
+# [WIF 3.5 と WIF 4.5 間での名前空間マッピング](namespace-mapping-between-wif-3-5-and-wif-4-5.md)
+# [WIF API リファレンス](wif-api-reference.md)
+# [API リファレンス](json-web-token-handler-api-reference.md)
+# [JSON Web トークン ハンドラー](json-web-token-handler.md)
+# [WIF セッション管理](wif-session-management.md)
+# [方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](claims-aware-aspnet-app-forms-authentication.md)
+# [WSTrustChannelFactory および WSTrustChannel](wstrustchannelfactory-and-wstrustchannel.md)
+# [Identity and Access Tool for Visual Studio 2012](identity-and-access-tool-for-vs.md)
+# [Windows Identity Foundation](windows-identity-foundation.md)
+# [WIF の機能](wif-features.md)
+# [WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)
+# [WIF コード サンプル インデックス](wif-code-sample-index.md)
+# [Windows Identity Foundation 4.5 の概要](wif-overview.md)
+# [セキュリティの変更点](security-changes.md)
+# [方法: トークン再生検出を有効にする](how-to-enable-token-replay-detection.md)
+# [カスタムのトークン ハンドラー](custom-token-handlers.md)
+# [WIF の「方法」のインデックス](wif-how-tos-index.md)
+# [方法: WIF を使用してサインイン状態を表示する](how-to-display-signed-in-status-using-wif.md)
+# [クレームベースの ID モデル](claims-based-identity-model.md)
+# [クレーム対応の ASP.NET Web アプリケーションを初めて構築する](building-my-first-claims-aware-aspnet-web-app.md)
+# [方法: WIF トレースを使用してクレーム対応アプリケーションおよびサービスをデバッグする](how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md)
+# [Windows Identity Foundation 4.5 の新機能](whats-new-in-wif.md)
+# [WIF のガイドライン](wif-guidelines.md)
+# [方法: 入力方向の要求の変換](how-to-transform-incoming-claims.md)
+# [方法: WIF トレースの有効化](how-to-enable-wif-tracing.md)
+# [API リファレンス](validating-issuer-name-registry-api-reference.md)
+# [WIF 要求プログラミング モデル](wif-claims-programming-model.md)
+# [方法: Windows 認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](how-to-build-claims-aware-aspnet-app-using-windows-authentication.md)
+# [方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする](how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md)
+# [WIF 構成のリファレンス](wif-configuration-reference.md)
+# [WSFederation 認証モジュールの概要](wsfederation-authentication-module-overview.md)
diff --git a/docs/framework/security/building-my-first-claims-aware-aspnet-web-app.md b/docs/framework/security/building-my-first-claims-aware-aspnet-web-app.md
new file mode 100644
index 00000000000..59d2f48e9b8
--- /dev/null
+++ b/docs/framework/security/building-my-first-claims-aware-aspnet-web-app.md
@@ -0,0 +1,56 @@
+---
+title: "クレーム対応の ASP.NET Web アプリケーションを初めて構築する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3ee8ee7f-caba-4267-9343-e313fae2876d
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# クレーム対応の ASP.NET Web アプリケーションを初めて構築する
+## 対象  
+  
+-   Windows Identity Foundation \(WIF\)  
+  
+-   ASP.NET  
+  
+ このトピックでは、WIF を使用してクレーム対応 ASP.NET Web アプリケーションをビルドするシナリオの概要について説明します。  クレーム対応アプリケーションのシナリオには、通常、アプリケーション、エンド ユーザー、セキュリティ トークン サービス \(STS\) の 3 つ参加要素が存在します。  次の図は、このシナリオについて説明しています。  
+  
+ ![WIF 基本 Web アプリ](../../../docs/framework/security/media/wifbasicwebapp.png "WIFBasicWebApp")  
+  
+1.  クレーム対応アプリケーションは、認証されていない要求を WIF で特定し、その要求を STS にリダイレクトします。  
+  
+2.  エンド ユーザーは資格情報を STS に提供します。認証が正常に行われると、STS はそのユーザーに対してトークンを発行します。  
+  
+3.  ユーザーは、要求内の STS 発行のトークンと共に、STS からクレーム対応アプリケーションにリダイレクトされます。  
+  
+4.  クレーム対応アプリケーションは、STS とその STS が発行したトークンを信頼するように構成され、  WIF を使用してトークンを検証し、解析します。  開発者は、承認の実装などのアプリケーションのニーズに応じて、適切な WIF API と種類 \(**ClaimsPrincpal** など\) を使用します。  
+  
+ .NET 4.5 以降、WIF は .NET Framework パッケージに含まれています。  .NET Framework 自体で直接 WIF クラスを使用できるため、.NET プラットフォームでクレーム ベースの ID をより深く統合し、クレームをさらに簡単に使用できます。  WIF 4.5 を使用すると、クレーム対応アプリケーションの開発を開始する目的で、帯域外コンポーネントをインストールする必要がありません。  WIF クラスは、さまざまなアセンブリに分散されています。主なものは、System.Security.Claims、System.IdentityModel、および System.IdentityModel.Services です。  
+  
+ STS は、認証が正常に行われたときにトークンを発行するサービスです。  Microsoft では、2 つの業界標準 STS を提供します。  
+  
+-   [Active Directory フェデレーション サービス \(AD FS\) 2.0](http://go.microsoft.com/fwlink/?LinkID=247516) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=247516\)  
+  
+-   [Microsoft Azure のアクセス制御サービス \(ACS\)](http://go.microsoft.com/fwlink/?LinkID=247517) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=247517\)。  
+  
+ AD FS 2.0 は、Windows Server R2 に含まれており、設置型シナリオの STS として使用できます。  ACS は、Microsoft Azure プラットフォームの一部として提供されるクラウド サービスです。  テストまたは学習の目的で、他の STS を使用して、クレーム対応アプリケーションをビルドすることもできます。  たとえば、オンラインで自由に入手できる [Identity and Access Tool for Visual Studio 2012](http://go.microsoft.com/fwlink/?LinkID=245849) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=245849\) に含まれる、ローカル開発用 STS を使用できます。  
+  
+ WIF を使用してクレーム対応 ASP.NET アプリケーションを初めてビルドするには、次のいずれかの手順に従ってください。  
+  
+-   [方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md)  
+  
+-   [方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md)  
+  
+-   [方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](../../../docs/framework/security/claims-aware-aspnet-app-forms-authentication.md)  
+  
+## 参照  
+ [WIF の概要](../../../docs/framework/security/getting-started-with-wif.md)
\ No newline at end of file
diff --git a/docs/framework/security/building-my-first-claims-aware-wcf-service.md b/docs/framework/security/building-my-first-claims-aware-wcf-service.md
new file mode 100644
index 00000000000..f95ed5b4771
--- /dev/null
+++ b/docs/framework/security/building-my-first-claims-aware-wcf-service.md
@@ -0,0 +1,49 @@
+---
+title: "初めてのクレーム対応 WCF サービスのビルド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0e6d091-9a97-4888-8f2c-cbcee42d90ee
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# 初めてのクレーム対応 WCF サービスのビルド
+## 対象  
+  
+-   Windows Identity Foundation \(WIF\)  
+  
+-   Windows Communication Foundation \(WCF\)  
+  
+## 概要  
+ このトピックでは、WIF を使用してクレーム対応 WCF サービスをビルドするシナリオの概要について説明します。  クレーム対応 Web サービスのシナリオには、通常、Web サービス、エンド ユーザー、セキュリティ トークン サービス \(STS\) の 3 つ参加要素が存在します。  次の図は、このシナリオについて説明しています。  
+  
+ ![WIF 基本要求に対応する WCF サービス](../../../docs/framework/security/media/wifbasicclaimsawarewcfservice.png "WIFBasicClaimsAwareWCFService")  
+  
+1.  WCF サービス クライアント \(エージェントと呼ばれることもあります\) は、WIF を使用して資格情報を STS に送信します。認証が正常に行われると、STS はそのエージェントに対してトークンを発行します。  
+  
+2.  エージェントは、この STS によって発行されたトークンを WCF サービスに送信します。  
+  
+3.  クレーム対応 WCF サービスは、STS とその STS が発行したトークンを信頼するように構成され、  WIF を使用してトークンを検証し、解析します。  開発者は、承認の実装などのアプリケーションのニーズに応じて、適切な WIF API と種類 \(**ClaimsPrincipal** など\) を使用します。  
+  
+ .NET 4.5 以降、WIF は .NET Framework パッケージに含まれています。  .NET Framework 自体で直接 WIF クラスを使用できるため、.NET プラットフォームでクレーム ベースの ID をより深く統合し、クレームをさらに簡単に使用できます。  WIF 4.5 を使用すると、クレーム対応アプリケーションの開発を開始する目的で、帯域外コンポーネントをインストールする必要がありません。  WIF クラスは、さまざまなアセンブリに分散されています。主なものは、System.Security.Claims、System.IdentityModel、および System.IdentityModel.Services です。  
+  
+ STS は、認証が正常に行われたときにトークンを発行するサービスです。  Microsoft では、2 つの業界標準 STS を提供します。  
+  
+-   [Active Directory フェデレーション サービス \(AD FS\) 2.0](http://go.microsoft.com/fwlink/?LinkID=247516) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=247516\)  
+  
+-   [Windows Azure Access Control Service \(ACS\)](http://go.microsoft.com/fwlink/?LinkID=247517) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=247517\).  
+  
+ AD FS 2.0 は、Windows Server R2 に含まれており、設置型シナリオの STS として使用できます。  Azure Active Directory アクセス制御 \(Access Control Service または ACS とも呼ばれます\) は、Microsoft Azure の一部として提供されるクラウド サービスです。  テストまたは学習の目的で、他の STS を使用して、クレーム対応アプリケーションをビルドすることもできます。  たとえば、オンラインで自由に入手できる [Identity and Access Tool for Visual Studio](http://go.microsoft.com/fwlink/?LinkID=245849) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=245849\) に含まれる、ローカル開発用 STS を使用できます。  
+  
+ WIF を使用して初めてのクレーム対応 WCF サービスをビルドするには、「[How To: Build Claims\-Aware WCF Service Using WIF](http://msdn.microsoft.com/ja-jp/431e6415-62ed-4a9f-af03-f14d2b4dfe6d)」を参照してください。  
+  
+## 参照  
+ [WIF の概要](../../../docs/framework/security/getting-started-with-wif.md)
\ No newline at end of file
diff --git a/docs/framework/security/claims-aware-aspnet-app-forms-authentication.md b/docs/framework/security/claims-aware-aspnet-app-forms-authentication.md
new file mode 100644
index 00000000000..847fa2c1841
--- /dev/null
+++ b/docs/framework/security/claims-aware-aspnet-app-forms-authentication.md
@@ -0,0 +1,135 @@
+---
+title: "方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98a3e029-1a9b-4e0c-b5d0-29d3f23f5b15
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# 方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   Web フォーム ASP.NET®  
+  
+## 概要  
+ ここでは、フォーム認証を使用する単純な要求対応の ASP.NET Web フォーム アプリケーションを作成する詳細な手順を示します。  また、方法にユーザーがフォーム認証を使用するときに命令が必要があることを確認するアプリケーションをテストできます。  
+  
+## 内容  
+  
+-   対象  
+  
+-   概要  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- フォーム認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 対象  
+  
+-   フォーム認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   正常に動作しているかどうかを ASP.NET Web フォーム アプリケーションをテストします。  
+  
+## 概要  
+ .NET 4.5 では、要求と WIF ベースの承認はフレームワークの重要な部分として含まれていました。  以前は、ASP.NET ユーザーからの要求が必要な場合は、WIF をインストールするように要求し `Thread.CurrentPrincipal` または `HttpContext.Current.User`などの主なオブジェクトにインターフェイスをキャストします。  これで、要求はこれらの主なオブジェクトによって自動的に処理されます。  
+  
+ フォーム認証は、.NET 4.5 の WIF に含まれないように、フォーム認証されているすべてのユーザーに自動的に関連付けられた要求があるためパフォーマンスが向上しました。  示します。これとしてフォーム認証を使用する ASP.NET アプリケーションでこれらの要求をすぐに、どのように使用できます。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- フォーム認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成します。  
+  
+#### 単純な ASP.NET アプリケーションを作成するには  
+  
+1.  次に、Visual Studio を起動し、**ファイル**、**新規作成**と **プロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクト** のペインで、**ASP.NET Web フォーム アプリケーション**をクリックします。  
+  
+3.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+## 手順 2 \- フォーム認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+ この手順では、*Web.config* 構成ファイルに構成エントリを追加し、アカウントの要求情報を表示するに *Default.aspx* を編集します。  
+  
+#### 要求の ASP.NET アプリケーションをフォーム認証を使用して構成するには  
+  
+1.  *Default.aspx ファイル* で、既存のマークアップに置き換えます。:  
+  
+    ```  
+    <%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="TestApp._Default" %>  
+  
+    <asp:Content runat="server" ID="BodyContent" ContentPlaceHolderID="MainContent">  
+        <p>  
+            This page displays the claims associated with a Forms authenticated user.          
+        </p>  
+        <h3>Your Claims</h3>  
+        <p>  
+            <asp:GridView ID="ClaimsGridView" runat="server" CellPadding="3">  
+                <AlternatingRowStyle BackColor="White" />  
+                <HeaderStyle BackColor="#7AC0DA" ForeColor="White" />  
+            </asp:GridView>  
+        </p>  
+    </asp:Content>  
+  
+    ```  
+  
+     この手順は、フォーム認証から取得された要求が設定された *Default.aspx ページ* に GridView コントロールを追加します。  
+  
+2.  Save the *Default.aspx* ファイルを保存して、*Default.aspx.cs*という名前の分離コード ファイルを開きます。  次に、既存のコードに置き換えます。:  
+  
+    ```csharp  
+    using System;  
+    using System.Web.UI;  
+    using System.Security.Claims;  
+  
+    namespace TestApp  
+    {  
+        public partial class _Default : Page  
+        {  
+            protected void Page_Load(object sender, EventArgs e)  
+            {  
+                ClaimsPrincipal claimsPrincipal = Page.User as ClaimsPrincipal;  
+  
+                if (claimsPrincipal != null)  
+                {  
+                    this.ClaimsGridView.DataSource = claimsPrincipal.Claims;  
+                    this.ClaimsGridView.DataBind();  
+                }  
+            }  
+        }  
+    }  
+    ```  
+  
+     上のコードはフォーム認証によって識別されたユーザーを含む認証されたユーザーに関する要求を表示します。  
+  
+## 手順 3 \- ソリューションをテストします。  
+ この手順では、ASP.NET Web フォーム アプリケーションをテストし、ユーザーがフォーム認証を使用する場合、要求があることを確認します。  
+  
+#### 要求の ASP.NET Web フォーム アプリケーションのフォーム認証を使用してテストするには  
+  
+1.  F5 キーを押してアプリケーションをビルドし、実行します。  **登録** があり、**ログイン** がページの右上で *Default.aspx*という名前のリンクする必要があります。  **\[登録\]** をクリックします。  
+  
+2.  **登録** のページで、ユーザー アカウントを作成し、**登録**をクリックします。  このアカウントは、フォーム認証を使用して作成され、自動的に署名されています。  
+  
+3.  ホーム ページにリダイレクトを変えた後、**発行者**、**OriginalIssuer**、**種類**、**値**、このアカウントに関する **ValueType** の要求情報含む **アプリケーションで要求** の、見出しの下のテーブルが表示されます。
\ No newline at end of file
diff --git a/docs/framework/security/claims-based-authorization-using-wif.md b/docs/framework/security/claims-based-authorization-using-wif.md
new file mode 100644
index 00000000000..15515bb3099
--- /dev/null
+++ b/docs/framework/security/claims-based-authorization-using-wif.md
@@ -0,0 +1,68 @@
+---
+title: "WIF を使用したクレーム ベースの承認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e24000a3-8fd8-4c0e-bdf0-39882cc0f6d8
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# WIF を使用したクレーム ベースの承認
+証明書利用者アプリケーションでは、承認によって、認証済み ID がアクセスできるリソースと、そのリソースで実行できる操作が決まります。  承認が不適切だったり弱かったりすると、それは情報漏えいとデータの改ざんにつながります。  ここでは、Windows Identity Foundation \(WIF\) とセキュリティ トークン サービス \(STS\)、たとえば Microsoft Azure のアクセス制御サービス \(ACS\) を使用して、クレーム対応 ASP.NET の Web アプリケーションとサービスの承認を実装する方法の概要を説明します。  
+  
+## 概要  
+ .NET Framework は、最初のバージョンから柔軟な承認実装機構を提供してきました。  この機構は、2 つのシンプルなインターフェイス、**IPrincipal** と **IIdentity** に基づいています。  **IIdentity** の具体的な実装は、認証されたユーザーを表します。  たとえば、**WindowsIdentity** 実装は、Active Directory で認証されているユーザーを表します。また、**GenericIdentity** は、ID がカスタム認証プロセスによって検証されるユーザーを表します。  **IPrincipal** の具体的な実装は、ロール ストアに応じて、ロールを使用してアクセス許可を確認する際に役に立ちます。  たとえば、**WindowsPrincipal** は、**WindowsIdentity** で、Active Directory グループのメンバーシップがないかどうかをチェックします。  このチェックを実行するには、**IPrincipal** インターフェイスで **IsInRole** メソッドを呼び出します。  ロールに基づいたアクセス チェックは、ロール ベースのアクセス制御 \(RBAC\) と呼ばれます。  詳細については、「[ロール ベースのアクセス制御](../../../docs/framework/security/claims-based-authorization-using-wif.md#BKMK_1)」を参照してください。ロールに関する情報をクレームに含めると、使い慣れたロール ベースの承認機構をサポートできます。  
+  
+ また、クレームを使用して、ロールの枠を越えた、より複雑な承認決定を行うこともできます。  クレームは、年齢、郵便番号、靴のサイズなど、事実上あらゆる情報をベースにできます。任意のクレームに基づくアクセス制御機構が、クレーム ベースの承認と呼ばれます。  詳細については、「[クレーム ベースの承認](../../../docs/framework/security/claims-based-authorization-using-wif.md#BKMK_2)」を参照してください。  
+  
+<a name="BKMK_1"></a>   
+## ロール ベースのアクセス制御  
+ RBAC による承認では、ユーザーのアクセス許可は、ユーザー ロールに基づいてアプリケーションによって管理および適用されます。  アクションの実行に必要なロールがユーザーにある場合、アクセスは許可され、それ以外の場合は拒否されます。  
+  
+### IPrincipal.IsInRole メソッド  
+ クレーム対応アプリケーションで RBAC アプローチを実装するには、クレーム対応ではないアプリケーションと同じように、**IPrinicpal** インターフェイスで **IsInRole\(\)** メソッドを使用します。  **IsInRole\(\)** メソッドを使用する方法は複数あります。  
+  
+-   **IPrincipal.IsInRole\(“Administrator”\)** を明示的に要求する。  この場合、結果はブール値になります。  これを条件付きステートメントで使用します。  これはコード内のすべての場所で任意に使用できます。  
+  
+-   セキュリティ要求 **PrincipalPermission.Demand\(\)** を使用する。  この場合、要求が満たされないと、結果は例外になります。  これは例外処理の方針に適合している必要があります。  パフォーマンスの観点から見た場合、例外をスローすることは、ブール値を無効にするよりもはるかに高くつきます。  これはコード内の任意の場所で使用できます。  
+  
+-   宣言属性 **\[PrincipalPermission\(SecurityAction.Demand, Role \= “Administrator”\)\]** を使用する。  この方法は、メソッドの修飾に使用されるため宣言と呼ばれます。  メソッドの実装内のコード ブロックで使用することはできません。  要求が満たされない場合、結果は例外になります。  これが例外処理の方針に適合していることを確認する必要があります。  
+  
+-   **web.config** の **\<authorization\>** セクションを使って、URL 承認を使用する。  URL レベルで承認を管理している場合は、この方法が適しています。  これは、前に説明した方法の中では最も大雑把です。  この方法の利点は、構成ファイルに変更が行われるため、コードをコンパイルしなくても変更を利用できるということです。  
+  
+### クレームとしてのロールの表現  
+ **IsInRole\(\)** メソッドが呼び出されると、現在のユーザーにそのロールがあるかどうかがチェックされます。  クレーム対応アプリケーションでは、ロールは、トークンで使用できるロール クレームの種類によって表されます。  ロール クレームの種類は、次の URI を使用して表されます。  
+  
+ http:\/\/schemas.microsoft.com\/ws\/2008\/06\/identity\/claims\/role  
+  
+ ロール クレームの種類でトークンを強化する方法は複数あります。  
+  
+-   **トークン発行中**。  ユーザーが認証されるときに、Microsoft Azure のアクセス制御サービス \(ACS\) などのフェデレーション プロバイダーや ID プロバイダー STS によってロール クレームを発行できます。  
+  
+-   **ClaimsAuthenticationManager を使用して、任意のクレームを、ロール タイプのクレームに変換する**。  ClaimsAuthenticationManager は、WIF に含まれているコンポーネントです。  このコンポーネントは、トークンを調べ、クレームを追加、変更、または削除することでそれを変換し、アプリケーションの起動時に要求を受け取れるようにします。  ClaimsAuthenticationManager を使用してクレームを変換する方法の詳細については、「[方法:WIF および ACS を使用して要求対応の ASP.NET アプリケーションで役割ベースのアクセス管理 \(RBAC\) を実装する](http://go.microsoft.com/fwlink/?LinkID=247445)」\(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=247445\) を参照してください。  
+  
+-   **samlSecurityTokenRequirement 構成セクションを使用して、任意のクレームをロールの種類に対応付ける**。宣言を使用したアプローチで、構成のみを使ってクレーム変換が行われます。その際、コーディングは必要ありません。  
+  
+<a name="BKMK_2"></a>   
+## クレーム ベースの承認  
+ クレーム ベースの承認では、アクセスの許可または拒否の承認決定が、クレームで使用できるデータを使って決定を行う任意のロジックに基づいています。  RBAC の場合は、使用される唯一のクレームがロール タイプのクレームでした。  ロール タイプのクレームは、ユーザーが特定のロールに所属するかどうかを確認するときに使用されます。  クレーム ベースの承認を使用した承認決定のプロセスを説明するために、次の手順について考えてみましょう。  
+  
+1.  アプリケーションは、ユーザー認証を求める要求を受け取ります。  
+  
+2.  WIF はユーザーを ID プロバイダーにリダイレクトします。ユーザーが認証されたら、アプリケーション要求が、ユーザーを表す関連セキュリティ トークンを使用して行われます。そのトークンには、ユーザーに関するクレームが含まれています。  WIF は、そのクレームを、ユーザーを表すプリンシパルに関連付けます。  
+  
+3.  アプリケーションは、クレームを決定ロジック機構に渡します。  これには Web サービスへの呼び出し、データベースに対するクエリ、または高度な規則エンジンを使用できます。また、ClaimsAuthorizationManager を使用することもできます。  
+  
+4.  決定機構では、クレームに基づいて結果が計算されます。  
+  
+5.  結果が true の場合はアクセスが許可され、false の場合は拒否されます。  たとえば、ワシントン州に住む 21 歳以上のユーザーという規則を使用できます。  
+  
+ <xref:System.Security.Claims.ClaimsAuthorizationManager> は、アプリケーションでクレーム ベースの承認の決定ロジックを外部化するときに役に立ちます。  ClaimsAuthorizationManager は、.NET 4.5 に含まれている WIF コンポーネントです。ClaimsAuthorizationManager を使用すると、着信要求を受け取り、任意のロジックを実装して、受信クレームに基づいて承認決定を行うことができます。  これは、承認ロジックを変更する必要があるときに重要になります。  この状況で ClaimsAuthorizationManager を使用してもアプリケーションの整合性には影響しないため、変更によってアプリケーション エラーが発生する可能性は少なくなります。  ClaimsAuthorizationManager を使用してクレーム ベースのアクセス制御を実装する方法の詳細については、「[方法:WIF および ACS を使用して要求対応の ASP.NET アプリケーションで要求承認を実装する](http://go.microsoft.com/fwlink/?LinkID=247446)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/security/claims-based-identity-model.md b/docs/framework/security/claims-based-identity-model.md
new file mode 100644
index 00000000000..f91b5d86cc7
--- /dev/null
+++ b/docs/framework/security/claims-based-identity-model.md
@@ -0,0 +1,87 @@
+---
+title: "クレームベースの ID モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a96a9af-d980-43be-bf91-341a23401431
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# クレームベースの ID モデル
+クレーム対応アプリケーションをビルドすると、ユーザー ID はアプリケーションでクレーム セットとして表されます。  たとえば、ユーザーの名前を表すクレームや、電子メール アドレスを表すクレームがあります。  これは、ユーザーが要求を行うたびにユーザーの識別に必要なすべての情報がアプリケーションに提供されるように外部 ID システムを構成し、同時に、信頼できるソースから提供される ID データを暗号化によって保護するという考え方です。  
+  
+ このモデルでは、シングル サインオンが非常に簡単になり、アプリケーションで次の処理を実行する必要がありません。  
+  
+-   ユーザーを認証する。  
+  
+-   ユーザー アカウントとパスワードを格納する。  
+  
+-   エンタープライズ ディレクトリを呼び出して、ユーザー ID の詳細を検索する。  
+  
+-   他のプラットフォームまたは企業の ID システムを統合する。  
+  
+ このモデルでは、ユーザーを認証したシステムによって提供されたクレームに基づいて、アプリケーションが ID 関連の決定を行います。  たとえば、ユーザーの名前を使用してアプリケーションの簡単なパーソナル化を行ったり、アプリケーションのより重要な機能やリソースへのユーザー アクセスを承認したりできます。  
+  
+ ここでは、次の情報について説明します。  
+  
+-   [クレーム ベース ID の概要](../../../docs/framework/security/claims-based-identity-model.md#BKMK_1)  
+  
+-   [クレーム ベース ID モデルの基本的なシナリオ](../../../docs/framework/security/claims-based-identity-model.md#BKMK_2)  
+  
+<a name="BKMK_1"></a>   
+## クレーム ベース ID の概要  
+ ここでは、この新しい ID アーキテクチャを理解するうえで役に立つ用語および概念について説明します。  
+  
+### ID  
+ Windows Identity Foundation \(WIF\) でプログラミング モデルを説明する目的で、ここでは "ID" という用語を使用して、保護するシステムのユーザーやその他のエンティティを説明する属性のセットを表しています。  
+  
+### クレーム  
+ クレームは、販売ロールにおける名前、電子メール アドレス、年齢、メンバーシップなど、ID 情報の一部と考えてください。  アプリケーションが受け取るクレームが多くなるほど、ユーザーに関して得られる情報が増えます。  これがエンタープライズ ディレクトリの説明で一般的に使用される "属性" ではなく、"クレーム" と呼ばれているのはなぜでしょうか。  その理由は、配信方法に関係があります。  このモデルでは、アプリケーションはユーザー属性をディレクトリで検索しません。  代わりに、ユーザーがクレームをアプリケーションに配信し、アプリケーションはそのクレームを調べます。  各要求は発行者により作成され、クレームの信頼度は、その発行者の信頼度に基づきます。  たとえば、自分の会社のドメイン コントローラーで作成されたクレームの方が、ユーザーによって作成されたクレームよりも信頼できます。  WIF は <xref:System.Security.Claims.Claim> 型でクレームを表します。この型には、クレームの発行者を見つけるために使用できる <xref:System.Security.Claims.Claim.Issuer%2A> プロパティが含まれます。  
+  
+### セキュリティ トークン  
+ ユーザーは、要求と共にクレーム セットをアプリケーションに配信します。  Web サービスでは、これらのクレームは、SOAP エンベロープのセキュリティ ヘッダーに含まれます。  ブラウザー ベースの Web アプリケーションでは、クレームは、ユーザーのブラウザーから HTTP POST 経由で受け取ります。  これらのクレームは受信方法に関係なく、シリアル化されていなければなりません。ここでセキュリティ トークンが提供されます。  セキュリティ トークンは、シリアル化されたクレーム セットであり、発行機関によってデジタル署名されています。  署名は重要です。署名により、ユーザーが単に多数のクレームを作成して送信しただけではないことが保証されます。  暗号化が不要な \(要求されない\) セキュリティ レベルの低い状況では、署名されていないトークンを使用できますが、このシナリオについてはここでは説明しません。  
+  
+ セキュリティ トークンを作成して読み取る機能は、WIF の中心的な機能の 1 つです。  WIF および .NET Framework は、すべての暗号化作業を処理し、読み取り可能なクレーム セットでアプリケーションを表します。  
+  
+### 発行機関  
+ 発行機関の種類は、Kerberos チケットを発行するドメイン コントローラーから、X.509 証明書を発行する証明機関まで数多くありますが、ここで説明するのは、クレームが含まれるセキュリティ トークンを発行する機関です。  この発行機関は、セキュリティ トークンの発行方法を認識する Web アプリケーションまたは Web サービスです。  発行機関では、適切なクレームを発行するために、要求を行う対象の証明書利用者およびユーザーに関する十分な情報が必要です。また、ユーザー ストアとやり取りしてクレームを検索し、ユーザー認証を独自に行う場合もあります。  
+  
+ どの発行機関を選択しても、その機関は ID ソリューションで中心的な役割を果たします。  クレームを信頼することでアプリケーションから認証を除外すると、その機関に認証機能が委任され、その機関でユーザーの認証が行われます。  
+  
+### STS \(セキュリティ トークン サービス\)  
+ セキュリティ トークン サービス \(STS\) は、WS\-Trust プロトコルおよび WS\-Federation プロトコルに従って、セキュリティ トークンの構築、署名、および発行を行うサービス コンポーネントです。  これらのプロトコルを実装するには多大な労力を伴いますが、必要な作業はすべて WIF が吸収するため、これらのプロトコルに習熟していなくても、無理なく STS を利用し、最小限の作業量で運用することができます。  [Active Directory® フェデレーション サービス \(AD FS\) 2.0](http://go.microsoft.com/fwlink/?LinkID=247516) などの既成の STS や、[Microsoft Azure のアクセス制御サービス \(ACS\)](http://go.microsoft.com/fwlink/?LinkID=247517) などのクラウド STS を使用することもできますが、カスタム トークンを発行したり、カスタム認証\/承認の機能を実装する必要がある場合には、WIF を使用してカスタム STS を自分で作成することもできます。  WIF を使用すると、独自の STS を簡単に作成できます。  
+  
+### 証明書利用者アプリケーション  
+ クレームに依存するアプリケーションをビルドする場合は、証明書利用者 \(RP\) アプリケーションをビルドします。  RP は、"クレーム対応アプリケーション"、"クレーム ベースのアプリケーション" とも呼ばれます。  Web アプリケーションと Web サービスは両方とも RP にできます。  RP アプリケーションは STS によって発行されたトークンを使用し、トークンからクレームを抽出して、それを ID 関連のタスクに使用します。  WIF には、RP アプリケーションのビルドに役立つ機能が用意されています。  
+  
+### 標準  
+ このすべての相互運用を実現するために、前のシナリオでは WS\-\* 標準がいくつか使用されています。  ポリシーは WS\-MetadataExchange を使用して取得されますが、そのポリシー自体は WS\-Policy 仕様に準拠しています。  STS では、WS\-Trust 仕様が実装されているエンドポイントを公開します。この仕様には、セキュリティ トークンを要求および受信する方法が記述されています。  現在の STS はほとんどが、SAML \(Security Assertion Markup Langauge\) で書式設定されたトークンを発行しています。  SAML は、相互運用可能な方法でクレームを表現できる、業界で認められた XML ボキャブラリです。  つまり、マルチプラットフォームでは、まったく異なるプラットフォーム上の STS と通信でき、プラットフォームに関係なくすべてのアプリケーションでシングル サインオンを実現できます。  
+  
+### ブラウザー ベースのアプリケーション  
+ クレーム ベースの ID モデルを使用できるのはスマート クライアントだけではありません。  この ID モデルは、ブラウザーベースのアプリケーション \(パッシブ クライアントとも呼ばれます\) でも使用できます。  次のシナリオでは、そのしくみについて説明します。  
+  
+ 最初に、ユーザーがブラウザーでクレーム対応アプリケーション \(証明書利用者アプリケーション\) にアクセスします。  Web アプリケーションは、ユーザーを認証できるようにブラウザーを STS にリダイレクトします。  STS は単純な Web アプリケーションでホストされています。このアプリケーションで、受信した要求を読み取り、標準的な HTTP メカニズムを使用してユーザーを認証してから、SAML トークンを作成し、JavaScript コードを使用して応答します。このコードによって、ブラウザーで SAML トークンを RP に送り返す HTTP POST が開始されます。  この POST の本文に、RP が要求したクレームが含まれています。  ここでは、一般的に RP ではクレームを Cookie にパッケージ化して、要求が行われるたびにユーザーをリダイレクトする必要がないようにします。  
+  
+<a name="BKMK_2"></a>   
+## クレーム ベース ID モデルの基本的なシナリオ  
+ 次に、クレーム ベースのシステムの例を示します。  
+  
+ ![パートナー認証の依存のフロー](../../../docs/framework/security/media/conc-relying-partner-processc.png "conc\_relying\_partner\_processc")  
+  
+ この図は、認証に WIF を使用するように構成された Web サイト \(証明書利用者アプリケーション、RP\) と、そのサイトを使用するクライアント \(Web ブラウザー\) を示しています。  
+  
+1.  認証されていないユーザーがページを要求すると、ブラウザーが、ID プロバイダー \(IP\) ページにリダイレクトされます。  
+  
+2.  IP では、ユーザーは、資格情報 \(ユーザー名\/パスワード、Kerberos など\) を提示する必要があります。  
+  
+3.  IP はトークンを発行し、それをブラウザーに返します。  
+  
+4.  ブラウザーは、最初に要求されたページにリダイレクトされます。ここで WIF は、トークンがページにアクセスするための要件を満たしているかどうかを判断します。  満たしている場合は、Cookie が発行されてセッションが確立されるため、認証が必要なのは 1 回だけです。その後、コントロールはアプリケーションに渡されます。
\ No newline at end of file
diff --git a/docs/framework/security/custom-token-handlers.md b/docs/framework/security/custom-token-handlers.md
new file mode 100644
index 00000000000..cb9e86f04b1
--- /dev/null
+++ b/docs/framework/security/custom-token-handlers.md
@@ -0,0 +1,89 @@
+---
+title: "カスタムのトークン ハンドラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5062669f-8bfc-420a-a25d-d8ab992ab10e
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# カスタムのトークン ハンドラー
+このトピックでは、WIF にトークンの処理にどのように使用するかトークン ハンドラーについて説明します。  WIF トピックでは、既定ではサポートされていないトークンの種類のカスタム トークン ハンドラーを作成する必要のあるものについて説明します。  
+  
+## WIF トークン ハンドラーの概要  
+ WIF は、セキュリティ トークンのハンドラーに、作成するために、書き込み、依存し、証明書利用者の \(RP\) アプリケーションまたはセキュリティ トークン サービス \(STS\) のトークンを検証します。  トークン ハンドラーは WIF パイプラインのカスタム トークン ハンドラーを追加したり、既存のトークン ハンドラーがトークンを管理する方法をカスタマイズする機能拡張ポイントです。  WIF、必要に応じて機能を変更できるように変更するか、完全にオーバーライドできる 9 種類の組み込みセキュリティ トークンのハンドラーを提供します。  
+  
+## WIF の組み込みセキュリティ トークンのハンドラー  
+ WIF 4.5 は、抽象基本クラスから派生 <xref:System.IdentityModel.Tokens.SecurityTokenHandler>9 種類のセキュリティ トークンのハンドラー クラスが含まれています:  
+  
+-   <xref:System.IdentityModel.Tokens.EncryptedSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.KerberosSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.RsaSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.Saml2SecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.UserNameSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.WindowsUserNameSecurityTokenHandler>  
+  
+-   <xref:System.IdentityModel.Tokens.X509SecurityTokenHandler>  
+  
+## カスタム トークン ハンドラーの追加  
+ 簡単な Web トークン \(SWT\) と JSON Web トークン \(JWT\) など、トークンの種類に、WIF に用意されている組み込みのトークン ハンドラーはありません。  これらのトークンの種類と組み込みハンドラーがないそのほか、カスタム トークン ハンドラーを作成するには、次の手順を実行する必要があります。  
+  
+#### カスタム トークン ハンドラーの追加  
+  
+1.  <xref:System.IdentityModel.Tokens.SecurityTokenHandler>から派生する新しいクラスを作成します。  
+  
+2.  次のメソッドをオーバーライドして、独自の実装を提供する:  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.CanReadToken%2A>  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.ReadToken%2A>  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.CanWriteToken%2A>  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.WriteToken%2A>  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.CanValidateToken%2A>  
+  
+    -   <xref:System.IdentityModel.Tokens.SecurityTokenHandler.ValidateToken%2A>  
+  
+3.  WIF に適用する **\<system.identityModel\>** のセクション内の *Web.config* または *App.config* の新しいカスタム トークン ハンドラーへの参照を追加します。  たとえば、次の構成のマークアップは **MyCustomTokenHandler** という名前の **CustomToken** の名前空間を設定する新しいトークン ハンドラーを指定します。  
+  
+    ```  
+    <system.identityModel>  
+        <identityConfiguration saveBootstrapContext="true">  
+            <securityTokenHandlers>  
+                <add type="CustomToken.MyCustomTokenHandler, CustomToken" />  
+            </securityTokenHandlers>  
+        </identityConfiguration>  
+    </system.identityModel>  
+    ```  
+  
+     既に組み込みのトークン ハンドラーを持つ型トークンを処理する独自のトークン ハンドラーを提供する場合は、既定のハンドラーを削除して、カスタム ハンドラーを使用するように **\<remove\>** の要素を追加する必要があることに注意してください。  たとえば、次の構成にカスタム トークン ハンドラーで既定値を置き換えます <xref:System.IdentityModel.Tokens.SamlSecurityTokenHandler> :  
+  
+    ```  
+    <system.identityModel>  
+        <identityConfiguration saveBootstrapContext="true">  
+            <securityTokenHandlers>  
+                <remove type=”System.IdentityModel.Tokens.SamlSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=abcdefg123456789”>  
+                <add type="CustomToken.MyCustomTokenHandler, CustomToken" />  
+            </securityTokenHandlers>  
+        </identityConfiguration>  
+    </system.identityModel>  
+    ```
\ No newline at end of file
diff --git a/docs/framework/security/downloading-the-json-web-token-handler-package.md b/docs/framework/security/downloading-the-json-web-token-handler-package.md
new file mode 100644
index 00000000000..024099a29dc
--- /dev/null
+++ b/docs/framework/security/downloading-the-json-web-token-handler-package.md
@@ -0,0 +1,46 @@
+---
+title: "JSON Web トークン ハンドラー パッケージのダウンロード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d12b3f5b-f1f1-4a9d-a159-0c13e5976c90
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# JSON Web トークン ハンドラー パッケージのダウンロード
+このトピックでは、JSON Web トークン ハンドラーをダウンロードしてプロジェクトで使用する方法について説明します。  
+  
+## JSON Web トークン ハンドラーのダウンロード  
+ JSON Web トークン ハンドラー拡張機能は、プロジェクトに必要なアセンブリと参照を追加する NuGet パッケージとして入手できます。  まだ NuGet がインストールされていない場合は、[nuget.org](http://nuget.org) にアクセスしてインストールしてください。  NuGet の「[JSON Web Token Handler \(JSON Web トークン ハンドラー\)](http://www.nuget.org/packages/System.IdentityModel.Tokens.Jwt/)」ページにアクセスすると、拡張機能のバージョン履歴を参照できます。  
+  
+#### パッケージ マネージャーの GUI を使用した JSON Web トークン ハンドラーのダウンロード  
+  
+1.  Visual Studio の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[NuGet パッケージの管理\]** を選択します。  
+  
+2.  **\[NuGet パッケージの管理\]** ウィンドウで、検索ボックスをクリックし、「`JWT Token Handler`」と入力して **Enter** キーを押します。  
+  
+3.  結果ペインから、最初の結果の **\[インストール\]** をクリックします。  
+  
+4.  パッケージのダウンロードが開始されます。  プロジェクトに追加される前に、\[License Acceptance\] ダイアログ ボックスが表示されます。  ライセンス条項に同意する場合は、**\[I Accept\]** をクリックします。  
+  
+5.  最新の JSON Web トークン ハンドラー アセンブリがダウンロードされ、プロジェクトに追加されます。  
+  
+#### パッケージ マネージャー コンソールを使用した JSON Web トークン ハンドラーのダウンロード  
+  
+1.  Visual Studio で、**\[ツール\]**、**\[ライブラリ パッケージ マネージャー\]**、**\[パッケージ マネージャー コンソール\]** の順にクリックします。  
+  
+2.  **\[パッケージ マネージャー コンソール\]** が表示されます。  次のテキストを入力し、**Enter** キーを押します。  
+  
+    ```powershell  
+    Install-Package System.IdentityModel.Tokens.Jwt  
+    ```  
+  
+3.  最新の JSON Web トークン ハンドラー アセンブリがダウンロードされ、プロジェクトに追加されます。
\ No newline at end of file
diff --git a/docs/framework/security/downloading-the-validating-issuer-name-registry-package.md b/docs/framework/security/downloading-the-validating-issuer-name-registry-package.md
new file mode 100644
index 00000000000..0b2d4d8b6b7
--- /dev/null
+++ b/docs/framework/security/downloading-the-validating-issuer-name-registry-package.md
@@ -0,0 +1,46 @@
+---
+title: "発行者名レジストリの検証パッケージのダウンロード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff8b0014-c5d4-4614-90f0-13fcc0ba777a
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 発行者名レジストリの検証パッケージのダウンロード
+このトピックでは、Validating Issuer Name Registry \(VINR\) をダウンロードしてプロジェクトで使用する方法について説明します。  
+  
+## Validating Issuer Name Registry のダウンロード  
+ VINR は、プロジェクトに必要なアセンブリと参照を追加する NuGet パッケージとして入手できます。  まだ NuGet がインストールされていない場合は、[nuget.org](http://nuget.org) にアクセスしてインストールしてください。  NuGet の「[Microsoft Validating Issuer Name Registry](https://nuget.org/packages/System.IdentityModel.Tokens.ValidatingIssuerNameRegistry/)」ページにアクセスすると、拡張機能のバージョン履歴を参照できます。  
+  
+#### パッケージ マネージャーの GUI を使用した Validating Issuer Name Registry のダウンロード  
+  
+1.  Visual Studio の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[NuGet パッケージの管理\]** を選択します。  
+  
+2.  **\[NuGet パッケージの管理\]** ウィンドウで、検索ボックスをクリックし、「`ValidatingIssuerNameRegistry`」と入力して **Enter** キーを押します。  
+  
+3.  結果ペインから、最初の結果の **\[インストール\]** をクリックします。  
+  
+4.  パッケージのダウンロードが開始されます。  プロジェクトに追加される前に、\[License Acceptance\] ダイアログ ボックスが表示されます。  ライセンス条項に同意する場合は、**\[I Accept\]** をクリックします。  
+  
+5.  最新の VINR アセンブリがダウンロードされ、プロジェクトに追加されます。  
+  
+#### パッケージ マネージャー コンソールを使用した Validating Issuer Name Registry のダウンロード  
+  
+1.  Visual Studio で、**\[ツール\]**、**\[ライブラリ パッケージ マネージャー\]**、**\[パッケージ マネージャー コンソール\]** の順にクリックします。  
+  
+2.  **\[パッケージ マネージャー コンソール\]** が表示されます。  次のテキストを入力し、**Enter** キーを押します。  
+  
+    ```powershell  
+    Install-Package System.IdentityModel.Tokens.ValidatingIssuerNameRegistry  
+    ```  
+  
+3.  The latest VINR assemblies will be downloaded and added to your project.
\ No newline at end of file
diff --git a/docs/framework/security/getting-started-with-wif.md b/docs/framework/security/getting-started-with-wif.md
new file mode 100644
index 00000000000..2ae65f503d6
--- /dev/null
+++ b/docs/framework/security/getting-started-with-wif.md
@@ -0,0 +1,24 @@
+---
+title: "WIF の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3e13659-2efd-457b-ab54-c8fc0bd89f67
+caps.latest.revision: 2
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 2
+---
+# WIF の概要
+-   [クレーム対応の ASP.NET Web アプリケーションを初めて構築する](../../../docs/framework/security/building-my-first-claims-aware-aspnet-web-app.md)  
+  
+-   [初めてのクレーム対応 WCF サービスのビルド](../../../docs/framework/security/building-my-first-claims-aware-wcf-service.md)  
+  
+## 参照  
+ [Windows Identity Foundation](../../../docs/framework/security/windows-identity-foundation.md)
\ No newline at end of file
diff --git a/docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md b/docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md
new file mode 100644
index 00000000000..2ffcfec081c
--- /dev/null
+++ b/docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md
@@ -0,0 +1,182 @@
+---
+title: "WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a32fe6e-5f68-4693-9371-19411fa8063c
+caps.latest.revision: 12
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 12
+---
+# WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン
+## 対象  
+  
+-   Microsoft® Windows® Identity Foundation \(WIF\) 3.5 および 4.5。  
+  
+## 概要  
+ Windows Identity Foundation \(WIF\) は、もともと .NET 3.5 SP1 タイム フレームでリリースされました。  その WIF のバージョンは WIF 3.5 と呼ばれています。  WIF は個別のランタイムおよび SDK としてリリースされました。つまりこれは、WIF 対応アプリケーションを実行しているすべてコンピューターには WIF のランタイムがインストールされている必要があり、開発者は WIF 対応アプリケーションを開発できる Visual Studio のテンプレートとツールを取得するため WIF SDK をダウンロードしてインストールする必要があることを意味します。  .NET 4.5 以降では、WIF は .NET Framework に完全に統合されています。  個別のランタイムが不要になり、WIF のツールは、Visual Studio Extensions Manager を使用して Visual Studio 2012 にインストールできます。  この WIF のバージョンは WIF 4.5 と呼ばれています。  
+  
+ .NET への WIF の統合には WIF API サーフェイスの複数の変更が必要でした。  WIF 4.5 には、Visual Studio 用の新しい名前空間、構成要素の変更、および新しいツールが含まれます。  このトピックでは、WIF 3.5 から WIF 4.5 を使用してビルドされたアプリケーションを移行するうえでのガイダンスを示します。Windows 8 または Windows Server 2012 を実行するコンピューターで WIF 3.5 を使用してビルドされたレガシ アプリケーションを実行する必要がある場合があります。  またこのトピックでは、これらのオペレーティング システム向けに WIF 3.5 を有効にする方法についてのガイダンスも示します。  
+  
+## WIF 4.5 に必要な変更  
+ ここでは、WIF 3.5 アプリケーションを WIF 4.5 に移行するために必要な変更について説明します。  
+  
+### アセンブリおよび名前空間の変更  
+ WIF 3.5 では、WIF クラスはすべて `Microsoft.IdentityModel` アセンブリ \(microsoft.identitymicrosoft.identitymodel.dll\) に含まれています。  WIF 4.5 では、WIF クラスは、`mscorlib` \(mscorlib.dll\)、`System.IdentityModel` \(System.IdentityModel.dll\)、`System.IdentityModel.Services` \(System.IdentityModel.Services.dll\)、および `System.ServiceModel` \(System.ServiceModel.dll\) というアセンブリに分割されています。  
+  
+ WIF 3.5 クラスはすべて `Microsoft.IdentityModel` 名前空間 \(`Microsoft.IdentityModel`、`Microsoft.IdentityModel.Tokens`、`Microsoft.IdentityModel.Web` など\) の 1 つに含まれていました。  WIF 4.5 では、WIF クラスは [System.IdentityModel](http://go.microsoft.com/fwlink/?LinkId=272004) 名前空間、<xref:System.Security.Claims?displayProperty=fullName> 名前空間、および <xref:System.ServiceModel.Security?displayProperty=fullName> 名前空間に分散されています。  この再編成に加えて、一部の WIF 3.5 クラスは WIF 4.5 では削除されました。  
+  
+ 次の表に、より重要な WIF 4.5 の名前空間とそれに含まれるクラスの種類を示します。  WIF 3.5 および WIF 4.5 間で名前空間を対応付ける方法および WIF 4.5 で削除された名前空間とクラスの詳細については、「[WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)」を参照してください。  
+  
+|WIF 4.5 名前空間|説明|  
+|------------------|--------|  
+|<xref:System.IdentityModel?displayProperty=fullName>|クッキーの変換、セキュリティ トークン サービス、および特殊な XML ディクショナリ リーダーを表すクラスが含まれます。  `Microsoft.IdentityModel`、`Microsoft.IdentityModel.SecurityTokenService`、および `Microsoft.IdentityModel.Threading` という WIF 3.5 名前空間のクラスが含まれます。|  
+|<xref:System.Security.Claims?displayProperty=fullName>|クレーム、クレーム ベースの ID、クレーム ベースの原則、およびその他のクレーム ベースの ID モデル成果物を表すクラスが含まれます。  `Microsoft.IdentityModel.Claims` 名前空間のクラスが含まれます。|  
+|<xref:System.IdentityModel.Tokens?displayProperty=fullName>|セキュリティ トークン、セキュリティ トークン ハンドラー、およびその他のセキュリティ トークンの成果物を表すクラスが含まれます。  `Microsoft.IdentityModel.Tokens`、`Microsoft.IdentityModel.Tokens.Saml11`、および `Microsoft.IdentityModel.Tokens.Saml2` という WIF 3.5 名前空間のクラスが含まれます。|  
+|<xref:System.IdentityModel.Services?displayProperty=fullName>|受動的な \(WS\-Federation\) シナリオで使用されるクラスが含まれます。  `Microsoft.IdentityModel.Web` 名前空間のクラスが含まれます。|  
+|<xref:System.ServiceModel.Security?displayProperty=fullName>|アクティブな \(WS\-Trust\) シナリオで使用される WCF のコントラクト、チャネル、サービス ホスト、およびその他の成果物を表すクラスは、現在はこの名前空間にあります。  WIF 3.5 では、これらのクラスは `Microsoft.IdentityModel.Protocols.WSTrust` 名前空間にありました。|  
+  
+> [!IMPORTANT]
+>  <xref:System.IdentityModel.Claims?displayProperty=fullName>、<xref:System.IdentityModel.Policy?displayProperty=fullName>、および <xref:System.IdentityModel.Selectors?displayProperty=fullName> という `System.IdentityModel` 名前空間には、WCF クレーム ベースの ID モデルを実装するクラスが含まれます。  WCF クレーム ベース ID モデルは WIF に置き換えられています。  WIF に基づいてソリューションをビルドする際は、これら 3 つの名前空間でクラスを使用しないでください。  
+  
+### .NET の統合による変更  
+ WIF は現在、.NET Framework に統合されています。  ほとんどの .NET の ID とプリンシパル クラスは、<xref:System.Security.Claims.ClaimsIdentity?displayProperty=fullName> と <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName> から派生します。  WIF 4.5 での次の変更による結果:  
+  
+-   クレーム、ID、およびプリンシパルを表す WIF クラスは、現在は <xref:System.Security.Claims?displayProperty=fullName> 名前空間にあります。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.IdentityModel.Claims?displayProperty=fullName> 名前空間には、WCF クレーム ベースの ID モデルで成果物を表すクラスが含まれます。  これらのクラスの多くは、WIF クラスと同じ名前を持ちます \(`Claims` など\)。  WIF に基づいてソリューションをビルドする場合は、これらのクラスは使用しないでください。  
+  
+-   .NET の ID およびプリンシパル クラスは、直接 <xref:System.Security.Claims.ClaimsIdentity?displayProperty=fullName> と <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName> から派生します。  したがって、WIF 3.5 インターフェイス `IClaimsIdentity` と `IClaimsPrincipal` は不要になり、WIF 4.5 では使用できません。  
+  
+-   <xref:System.Security.Principal.WindowsIdentity?displayProperty=fullName> および <xref:System.Security.Principal.WindowsPrincipal?displayProperty=fullName> などの .NET の ID およびプリンシパル クラスは、<xref:System.Security.Claims.ClaimsIdentity> および <xref:System.Security.Claims.ClaimsPrincipal> から派生し、組み込みのクレーム機能を備えています。  したがって、WIF 3.5 にあった `WindowsClaimsIdentity` と `WindowsClaimsPrincipal` などのクレーム固有の ID およびプリンシパル クラスは不要になり、WIF 4.5 には存在しません。  
+  
+### WIF 機能のその他の変更  
+ 名前空間の変更と.NET との統合による変更に加えて、WIF 4.5 では WIF 機能に対する次の一般的な変更が行われています。  
+  
+-   特定の SOAP エラーに例外を対応付ける機能を備えていた `Microsoft.IdentityModel.ExceptionMapper` クラスは削除されます。  
+  
+-   例外のサーフェイスは大幅に削減されました。  
+  
+-   プロトコルまたは WS\-\* 固有の定数を定義したクラスの多く \(たとえば、WS\-Addressing 1.0 に関連する定数を定義した `Microsoft.IdentityModel.WSAddressing10Constants` クラスなど\) は削除されます。  
+  
+-   `Microsoft.IdentityModel.WindowsTokenService` 名前空間の Claims to Windows Token Service \(c2wts\) とその関連クラスが削除されます。  
+  
+### WIF 構成の変更  
+ 構成ファイルの変更の多くは WIF 4.5 での名前空間の更新により発生しました。たとえば、WS\-Federation Authentication Manager をアプリケーションに追加するため、`<httpModules>` セクションの次の WIF 3.5 エントリについて考えます。  
+  
+```  
+<add name="WSFederationAuthenticationModule" type="Microsoft.IdentityModel.Web.WSFederationAuthenticationModule, Microsoft.IdentityModel, Version=3.5.0.0, Culture=neutral, PublicKeyToken=abcd … 5678" />  
+```  
+  
+ このエントリは WIF 4.5 で新しい名前空間とアセンブリのバージョンを含むように更新されています。  
+  
+```  
+<add name="WSFederationAuthenticationModule" type="System.IdentityModel.Services.WSFederationAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=abcd … 5678"/>  
+```  
+  
+ 次の一覧に、WIF 4.5 用の構成ファイルへの主要な変更を示します。  
+  
+-   `<microsoft.identityModel>` セクションは現在、[\<system.identityModel\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md) セクションです。  
+  
+-   `<service>` 要素は現在、[\<identityConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md) 要素です。  
+  
+-   新しいセクション [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md) は、受動的な \(WS\-Federation\) シナリオで動作を制御する設定を指定するために追加されました。  
+  
+-   [\<federationConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md) 要素とその子要素は、WIF 3.5 の `<service>` 要素から新しい `<system.identityModel.services>` 要素に移動されました。  
+  
+-   WIF 3.5 では `<service>` 要素の直下のサービスレベルで指定できた複数の要素が、[\<securityTokenHandlerConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/securitytokenhandlerconfiguration.md) 要素での指定に制限されました\(WIF 4.5 では、下位互換性を維持するため、これらは [\<identityConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md) 要素で指定できます\)。  
+  
+ WIF 4.5 の構成要素の詳細な一覧については、「[WIF 構成スキーマ](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md)」を参照してください。  
+  
+### Visual Studio ツールの変更  
+ WIF 3.5 SDK では、スタンドアロンのフェデレーション ユーティリティである FedUtil.exe \(FedUtil\) が用意されており、これを使用して WIF 対応アプリケーションでの ID 管理をセキュリティ トークン サービス \(STS\) に外部委託できました。  このツールにより、WIF の設定がアプリケーション構成ファイルに追加され、アプリケーションは 1 つ以上の STS からセキュリティ トークンを取得できました。また **\[STS サービス参照の追加\]** ボタンによって Visual Studio に表示されました。  FedUtil は WIF 4.5 には付属していません。代わりに、WIF 4.5 は Identity and Access Tool for Visual Studio 2012 という名前の新しい Visual Studio の拡張ツールをサポートします。これを使用することで、ID 管理を STS に外部委託するために必要な WIF の設定を備えたアプリケーションの構成ファイルを変更できます。  また Identity and Access Tool は、WIF 対応アプリケーションのテストに使用できる Local STS と呼ばれる STS を実装しています。  多くの場合、この機能により、開発中のソリューションをテストするのに WIF 3.5 で頻繁に必要とされたカスタム STS をビルドする必要がなくなりました。  したがって、STS のテンプレートは、Visual Studio 2012 でサポートされなくなりました。ただし、STS の開発をサポートするクラスは WIF 4.5 でも使用できます。  
+  
+ Visual Studio の Extensions and Updates Manager から Identity and Access Tool をインストールするか、または Code Gallery の「[Identity and Access Tool for Visual Studio 2012](http://go.microsoft.com/fwlink/?LinkID=245849)」ページからダウンロードできます。  Visual Studio ツールの変更を次のリストにまとめます。  
+  
+-   \[STS サービス参照の追加\] 機能は削除されています。  その代わりとなるのが Identity and Access Tool です。  
+  
+-   Visual Studio STS のテンプレートは削除されています。  Identity and Access Tool で入手可能な Local STS を使用でき、WIF を使用して開発した ID ソリューションをテストできます。  Local STS 構成を変更して、クレームをカスタマイズできます。  
+  
+-   スタンドアロンのフェデレーション ユーティリティ \(FedUtil\) は WIF 4.5 では使用できません。Identity and Access Tool を使用して、構成ファイルを変更し、ID 管理を STS に外部委託できます。  
+  
+ Identity and Access Tool の詳細については、「[Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)」を参照してください。  
+  
+<a name="BKMK_ToolingChanges"></a>   
+### 受動的な \(WS\-Federation\) シナリオ:  
+  
+-   受動的なシナリオをサポートするクラスが <xref:System.IdentityModel.Services?displayProperty=fullName> 名前空間に移動されました。  WIF 3.5 では、これらのクラスは `Microsoft.IdentityModel.Web` 名前空間にありました。  
+  
+-   `Microsoft.IdentityModel.Web.Configuration` 名前空間のクラスは <xref:System.IdentityModel.Services.Configuration?displayProperty=fullName>に移動されました。  これらのクラスは、受動的なシナリオの構成に固有のオブジェクトを表します。  
+  
+-   `FederatedPasssiveSignInControl` はサポートされていません。`Microsoft.IdentityModel.Web.Controls` 名前空間のすべてのクラスは、WIF 4.5 から削除されました。  
+  
+-   WS\-Federation 認証モジュール \(<xref:System.IdentityModel.Services.WSFederationAuthenticationModule>\) のサインアウト機能は WIF 3.5 とは異なります。  WIF 4.5 でのサインアウトの機能の詳細については、<xref:System.IdentityModel.Services.WSFederationAuthenticationModule> クラスのトピックを参照してください。  
+  
+### アクティブな \(WCF\/WS\-Trust\) シナリオ:  
+  
+-   `Microsoft.IdentityModel.Protocols.WSTrust` 名前空間は、WIF 4.5 の主に 2 つの名前空間に分割されています。WS\-Trust プロトコル固有の成果物を表すクラスは <xref:System.IdentityModel.Protocols.WSTrust?displayProperty=fullName> にあります。  これには <xref:System.IdentityModel.Protocols.WSTrust.RequestSecurityToken> などのクラスが含まれます。  WCF アプリケーションで WS\-Trust を使用して、含まれているサービス コントラクト、チャネル、サービス ホスト、およびその他の成果物を表すクラスは、<xref:System.ServiceModel.Security?displayProperty=fullName> に移動されました \(<xref:System.ServiceModel.Security.IWSTrust13AsyncContract> インターフェイスなど\)。  
+  
+-   WIF を使用するための WCF アプリケーションの構成は、大幅に単純化されました。  以前は `Microsoft.IdentityModel.Configuration.ConfigureServiceHostBehaviorExtensionElement` は動作拡張として追加する必要があり、`<federatedServiceHostConfiguration>` 要素を指定することで、この機能を使用して WIF をサービス動作に追加していました。  WIF 4.5 は WCF とより密接に統合されました。  これで、次の XML に示すように `<system.serviceModel>`\/`<behaviors>`\/`<serviceBehaviors>`\/`<serviceCredentials>` 要素で `useIdentityConfiguration` 属性を指定することで WCF サービス上で WIF を有効にできます。  
+  
+    ```xml  
+    <serviceCredentials useIdentityConfiguration="true">  
+        <!--Certificate added by Identity And Access VS Package.  Subject='CN=localhost', Issuer='CN=localhost'. Make sure you have this certificate installed. The Identity and Access tool does not install this certificate.-->  
+        <serviceCertificate findValue="CN=localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectDistinguishedName" />  
+    </serviceCredentials>  
+    ```  
+  
+-   WIF 4.5 では、アクティブな \(WCF\) サービスが使用するサービス証明書はサービス ホストで指定する必要があります。  構成では、前の例に示すように `<system.serviceModel>`\/`<behaviors>`\/`<serviceBehaviors>`\/`<serviceCredentials>`\/`<serviceCertificate>` 要素でこれを指定できます。  WIF 3.5 では、サービス証明書は WIF の `<service>` 要素の `<serviceCertificate>` 子要素により指定できます。  この機能は WIF 4.5 にはないため、代わりに `<serviceCredentials>` 要素の `<serviceCertificate>` 要素を指定します。  
+  
+-   WCF に WIF 3.5 を追加するために使用されていたクラスは存在しません。  これには `Microsoft.IdentityModel.Tokens` 名前空間の `FederatedSecurityTokenManager`、`FederatedServiceCredentials`、`IdentityModelServiceAuthorizationManager`、および `Microsoft.IdentityModel.Configuration.ConfigureServiceHostBehaviorExtensionElement` クラスが含まれています。  
+  
+## Windows 8 で WIF 3.5 を有効にする  
+ WIF 4.5 は .NET 4.5 の一部であるため、Windows 8 および Windows Server 2012 を実行するコンピューターで自動的に有効になり、WIF 4.5 を使用して作成されたアプリケーションは、既定では Windows 8 または Windows Server 2012 で実行されます。  ただし、WIF 3.5 を使用して作成されたアプリケーションは、Windows 8 または Windows Server 2012 を実行しているコンピューター上で実行することが必要になる場合があります。  この場合、ターゲット コンピューターで WIF 3.5 を有効にする必要があります。  これは、Windows 8 を実行するコンピューター上で、展開イメージのサービスと管理 \(DISM\) ツールを使用して行うことができます。  Windows Server 2012 を実行するコンピューターで、DISM ツールを使用するか、または Windows PowerShell の `Add-WindowsFeature` コマンドレットを使用できます。  どちらの場合も、適切なコマンドは、コマンド ラインまたは Windows PowerShell の環境内から呼び出すことができます。  
+  
+ 次のコマンドは、DISM ツールをコマンド ラインまたは Windows PowerShell の環境内から使用する方法を示します。  既定では、DISM PowerShell モジュールは Windows 8 および Windows Server 2012 に含まれるので、インポートする必要はありません。  Windows PowerShell を使用した DISM の使い方の詳細については、「[Windows PowerShell の DISM の使用方法](http://go.microsoft.com/fwlink/?LinkId=254419)」を参照してください。  
+  
+ DISM を使用して WIF 3.5 を有効にするには:  
+  
+```  
+dism /online /enable-feature:windows-identity-foundation  
+```  
+  
+ DISM を使用して WIF 3.5 を無効にするには:  
+  
+```  
+dism /online /disable-feature:windows-identity-foundation  
+```  
+  
+ DISM を使用して有効または無効にする機能を確認するには:  
+  
+```  
+dism /online /get-features  
+```  
+  
+ または、Windows Server 2012 を実行するコンピューターで Windows PowerShell コマンドレット `Add-WindowsFeature` を使用して WIF 3.5 を有効にすることができます。  コマンド ラインから実行するには、次のコマンドを入力します。  
+  
+```  
+powershell "add-windowsfeature windows-identity-foundation"  
+```  
+  
+ Windows PowerShell の環境内から、直接コマンドを入力できます。  
+  
+```  
+add-windowsfeature windows-identity-foundation  
+```  
+  
+> [!NOTE]
+>  WIF 3.5 および WIF 4.5 では多くのクラスが同じ名前を持つため、WIF 3.5 と WIF 4.5 の両方を使用している場合は、完全修飾クラス名、または WIF 3.5 および WIF 4.5 でクラスを区別するための名前空間エイリアスを必ず使用してください。  
+  
+## 参照  
+ [WIF 構成スキーマ](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md)   
+ [WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)   
+ [Windows Identity Foundation 4.5 の新機能](../../../docs/framework/security/whats-new-in-wif.md)   
+ [Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/security/how-to-build-claims-aware-aspnet-app-using-windows-authentication.md b/docs/framework/security/how-to-build-claims-aware-aspnet-app-using-windows-authentication.md
new file mode 100644
index 00000000000..f9d56734592
--- /dev/null
+++ b/docs/framework/security/how-to-build-claims-aware-aspnet-app-using-windows-authentication.md
@@ -0,0 +1,147 @@
+---
+title: "方法: Windows 認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11c53d9d-d34a-44b4-8b5e-22e3eaeaee93
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# 方法: Windows 認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   Web フォーム ASP.NET®  
+  
+## 概要  
+ ここでは、Windows 認証を使用する単純な要求対応の ASP.NET Web フォーム アプリケーションを作成する詳細な手順を示します。  また、方法にユーザーが Windows 認証を使用して署名を行う場合は、命令が必要であることを確認するアプリケーションをテストできます。  
+  
+## 内容  
+  
+-   対象  
+  
+-   概要  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- Windows 認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 対象  
+  
+-   Windows 認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   正常に動作しているかどうかを ASP.NET Web フォーム アプリケーションをテストします。  
+  
+## 概要  
+ .NET 4.5 では、要求と WIF ベースの承認はフレームワークの重要な部分として含まれていました。  以前は、ASP.NET ユーザーからの要求が必要な場合は、WIF をインストールするように要求し `Thread.CurrentPrincipal` または `HttpContext.Current.User`などの主なオブジェクトにインターフェイスをキャストします。  これで、要求はこれらの主なオブジェクトによって自動的に処理されます。  
+  
+ Windows 認証は、.NET 4.5 の WIF に含まれないよう Windows の資格情報に、認証されているすべてのユーザーに自動的に関連付けられた要求があるためパフォーマンスが向上しました。  示します。これとして Windows 認証を使用する ASP.NET アプリケーションでこれらの要求をすぐに、どのように使用できます。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- Windows 認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成します。  
+  
+#### 単純な ASP.NET アプリケーションを作成するには  
+  
+1.  次に、Visual Studio を起動し、**ファイル**、**新規作成**と **プロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクト** のペインで、**ASP.NET Web フォーム アプリケーション**をクリックします。  
+  
+3.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+4.  **TestApp** のプロジェクトを作成したら、その **ソリューション エクスプローラー**のをクリックします。  プロジェクトのプロパティは **ソリューション エクスプローラー**の下に **プロパティ** のペインに表示されます。  **有効**に **Windows 認証** のプロパティを設定します。  
+  
+    > [!WARNING]
+    >  Windows 認証は、新しい ASP.NET アプリケーションで既定で無効になっているため、手動で有効にする必要があります。  
+  
+## 手順 2 \- Windows 認証を使用する要求の ASP.NET Web フォーム アプリケーションを構成します。  
+ この手順では、*Web.config* 構成ファイルに構成エントリを追加し、アカウントの要求情報を表示するに *Default.aspx* を変更します。  
+  
+#### 要求の ASP.NET アプリケーションが Windows 認証を使用して構成するには  
+  
+1.  **TestApp** のプロジェクトで *Default.aspx ファイル* では、既存のマークアップに置き換えます。:  
+  
+    ```  
+    <%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true"  
+        CodeBehind="Default.aspx.cs" Inherits="TestApp._Default" %>  
+  
+    <asp:Content runat="server" ID="BodyContent" ContentPlaceHolderID="MainContent">  
+        <p>  
+            This page displays the claims associated with a Windows authenticated user.          
+        </p>  
+        <h3>Your Claims</h3>  
+        <p>  
+            <asp:GridView ID="ClaimsGridView" runat="server" CellPadding="3">  
+                <AlternatingRowStyle BackColor="White" />  
+                <HeaderStyle BackColor="#7AC0DA" ForeColor="White" />  
+            </asp:GridView>  
+        </p>  
+    </asp:Content>  
+  
+    ```  
+  
+     この手順は、Windows 認証から取得された要求が設定された *Default.aspx ページ* に GridView コントロールを追加します。  
+  
+2.  Save the *Default.aspx* ファイルを保存して、*Default.aspx.cs*という名前の分離コード ファイルを開きます。  次に、既存のコードに置き換えます。:  
+  
+    ```csharp  
+    using System;  
+    using System.Web.UI;  
+    using System.Security.Claims;  
+  
+    namespace TestApp  
+    {  
+        public partial class _Default : Page  
+        {  
+            protected void Page_Load(object sender, EventArgs e)  
+            {  
+                ClaimsPrincipal claimsPrincipal = Page.User as ClaimsPrincipal;  
+                this.ClaimsGridView.DataSource = claimsPrincipal.Claims;  
+                this.ClaimsGridView.DataBind();  
+            }  
+        }  
+    }  
+    ```  
+  
+     上のコードは認証されたユーザーに関する要求が表示されます。  
+  
+3.  次の構成エントリだけを含むように、アプリケーションの認証タイプを変更するには、プロジェクトのルートの *Web.config ファイル* の **\<system.web\>** のセクションの **\<authentication\>** ブロックを変更する:  
+  
+    ```  
+    <authentication mode="Windows" />  
+    ```  
+  
+4.  最後に、認証を強制的に同じ *Web.config ファイル* の **\<system.web\>** のセクションの **\<authorization\>** ブロックを変更する:  
+  
+    ```  
+    <authorization>  
+        <deny users="?" />  
+    </authorization>  
+    ```  
+  
+## 手順 3 \- ソリューションをテストします。  
+ この手順では、ASP.NET Web フォーム アプリケーションをテストし、ユーザーが Windows 認証を使用する場合、要求があることを確認します。  
+  
+#### 要求の ASP.NET Web フォーム アプリケーションを Windows 認証を使用してテストするには  
+  
+1.  F5 キーを押してアプリケーションをビルドし、実行します。  *Default.aspx*、という名前の Windows アカウント名は、ページの右上の認証済みユーザーとしてドメイン名 \(など\) が表示されます。  ページの内容は、Windows のアカウントから取得された要求が設定されているテーブルを含める必要があります。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md b/docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md
new file mode 100644
index 00000000000..1f6bd127ba6
--- /dev/null
+++ b/docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md
@@ -0,0 +1,229 @@
+---
+title: "方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0efb76bc-9f7b-4afe-be1c-2a57c917010b
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# 方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   MVC ASP.NET®  
+  
+## 概要  
+ ここでは、単純な要求に対応した ASP.NET MVC Web アプリケーションを作成する詳細な手順を示します。  また、命令をクレームベース認証の正常な実装の単純な要求に対応した ASP.NET MVC Web アプリケーションをテストする方法を提供します。  ここでは、セキュリティ トークン Services \(STS\) を作成するための詳細な手順がなく、既に STS を構成していることを前提としています。  
+  
+## 内容  
+  
+-   対象  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET MVC アプリケーションを作成します。  
+  
+-   手順 2 \- クレームベース認証用の ASP.NET MVC アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+-   関連項目  
+  
+## 対象  
+  
+-   クレームベース認証用の ASP.NET MVC Web アプリケーションを構成します。  
+  
+-   正常な要求に対応した ASP.NET MVC Web アプリケーションをテストします。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET MVC アプリケーションを作成します。  
+  
+-   手順 2 \- クレームベース認証用の ASP.NET MVC アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET MVC アプリケーションを作成します。  
+ この手順では、新しい ASP.NET MVC アプリケーションを作成します。  
+  
+#### 単純な ASP.NET MVC アプリケーションを作成するには  
+  
+1.  次に、Visual Studio を起動し、**ファイル**、**新規作成**と **プロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクト** のペインで、**ASP.NET MVC 3 Web アプリケーション**をクリックします。  
+  
+3.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+4.  **新しい ASP.NET MVC 3 プロジェクト** ダイアログ ボックスで、**エンジンの表示** が **Razor**に設定され、次にをクリック **OK**するために使用できるテンプレートから **インターネット アプリケーション** になります選択します。  
+  
+5.  新しいプロジェクトが開かれると、**ソリューション エクスプローラー** の **TestApp** プロジェクトを右クリックし、**プロパティ** のオプションを選択します。  
+  
+6.  プロジェクトのプロパティ ページで、左側の **Web** のタブをクリックし、**ローカル IIS Web サーバーを使用する** のが選択されていることを確認します。  
+  
+## 手順 2 \- クレームベース認証用の ASP.NET MVC アプリケーションを構成します。  
+ この手順で必要な認識する、ASP.NET MVC Web アプリケーションの *Web.config 構成ファイル* に構成エントリを追加します。  
+  
+#### クレームベース認証用の ASP.NET MVC アプリケーションを構成するには  
+  
+1.  *Web.config 構成ファイル* に次の構成セクションの定義を追加します。  これらは Windows ID の基本に必要な構成セクションを定義します。  **\<configuration\>** の開始要素の直後の定義を追加します:  
+  
+    ```xml  
+    <configSections>  
+        <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+        <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+    </configSections>  
+    ```  
+  
+2.  アプリケーションのフェデレーションのメタデータへのアクセスを可能にする **\<location\>** の要素を追加します:  
+  
+    ```xml  
+    <location path="FederationMetadata">  
+        <system.web>  
+            <authorization>  
+                <allow users="*" />  
+            </authorization>  
+        </system.web>  
+    </location>  
+    ```  
+  
+3.  ユーザーを拒否するに **\<system.web\>** の要素内に次の構成エントリを追加してネイティブの認証を無効にし、認証を管理できます。は WIF ができます。  
+  
+    ```xml  
+    <authorization>  
+        <deny users="?" />  
+    </authorization>  
+    <authentication mode="None" />  
+    ```  
+  
+4.  次の Windows ID の基本関連構成エントリを追加し、ASP.NET アプリケーションの URL とポート番号が **\<wsFederation\>** の要素の **\<audienceUris\>** エントリ、**領域** の属性、および **\<wsFederation\>** の要素の **応答** の属性の値が一致することを確認します。  また **発行者** の値がセキュリティ トークン サービスの \(STS\) の URL を満たしていることを確認します。  
+  
+    ```xml  
+    <system.identityModel>  
+        <identityConfiguration>  
+            <audienceUris>  
+                <add value="http://localhost:28503/" />  
+            </audienceUris>  
+            <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+                <trustedIssuers>  
+                    <add thumbprint="1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234" name="YourSTSName" />  
+                </trustedIssuers>   
+            </issuerNameRegistry>  
+            <certificateValidation certificateValidationMode="None" />  
+        </identityConfiguration>  
+    </system.identityModel>  
+    <system.identityModel.services>  
+        <federationConfiguration>  
+            <cookieHandler requireSsl="false" />  
+            <wsFederation passiveRedirectEnabled="true" issuer="http://localhost:13922/wsFederationSTS/Issue" realm="http://localhost:28503/" reply="http://localhost:28503/" requireHttps="false" />  
+        </federationConfiguration>  
+    </system.identityModel.services>  
+    ```  
+  
+5.  [System.IdentityModel](assetId:///System.IdentityModel?qualifyHint=False&amp;autoUpgrade=True) のアセンブリへの参照を追加します。  
+  
+6.  エラーを得るためにソリューションをコンパイルします。  
+  
+## 手順 3 \- ソリューションをテストします。  
+ この手順で構成されたクレームベース認証用の ASP.NET MVC Web アプリケーションをテストします。  基本的なテストを実行するには、単純なコードは、セキュリティ トークン Services \(STS\) によって発行されたトークンの表示の要求追加します。  
+  
+#### クレームベース認証用の ASP.NET、MVC アプリケーションをテストできます。  
+  
+1.  **ソリューション エクスプローラー**に、エディターの **コントローラ** のフォルダーを開きます *HomeController.cs ファイルを* 展開します。  **インデックス** のメソッドに次のコードを追加します:  
+  
+    ```csharp  
+    public ActionResult Index()  
+    {  
+        ViewBag.ClaimsIdentity = Thread.CurrentPrincipal.Identity;  
+  
+        return View();  
+    }  
+  
+    ```  
+  
+2.  次に **ソリューション エクスプローラー** エディターでの **ビュー** と **ホーム** フォルダーを開きます *Index.cshtml ファイルを* 配置します。  コンテンツを削除し、次のマークアップを追加します:  
+  
+    ```html  
+  
+    @{  
+        ViewBag.Title = "Home Page";  
+    }  
+  
+    <h2>Welcome: @ViewBag.ClaimsIdentity.Name</h2>  
+    <h3>Values from Identity</h3>  
+    <table>  
+        <tr>  
+            <th>  
+                IsAuthenticated   
+            </th>  
+            <td>  
+                @ViewBag.ClaimsIdentity.IsAuthenticated   
+            </td>  
+        </tr>  
+        <tr>  
+            <th>  
+                Name   
+            </th>          
+            <td>  
+                @ViewBag.ClaimsIdentity.Name  
+            </td>          
+        </tr>  
+    </table>  
+    <h3>Claims from ClaimsIdentity</h3>  
+    <table>  
+        <tr>  
+            <th>  
+                Claim Type  
+            </th>  
+            <th>  
+                Claim Value  
+            </th>  
+            <th>  
+                Value Type  
+            </th>  
+            <th>  
+                Subject Name  
+            </th>          
+            <th>  
+                Issuer Name  
+            </th>          
+        </tr>  
+            @foreach (System.Security.Claims.Claim claim in ViewBag.ClaimsIdentity.Claims ) {  
+        <tr>  
+            <td>  
+                @claim.Type  
+            </td>  
+            <td>  
+                @claim.Value  
+            </td>  
+            <td>  
+                @claim.ValueType  
+            </td>  
+            <td>  
+                @claim.Subject.Name  
+            </td>  
+            <td>  
+                @claim.Issuer  
+            </td>  
+        </tr>  
+    }  
+    </table>  
+  
+    ```  
+  
+3.  **F5** キーを押してソリューションを実行します。  
+  
+4.  セキュリティ トークン サービスにより、に発行されたトークンの要求を表示するページという名前を付ける必要があります。  
+  
+## 関連項目  
+  
+-   [方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md)
\ No newline at end of file
diff --git a/docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md b/docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md
new file mode 100644
index 00000000000..7f49ecbbee0
--- /dev/null
+++ b/docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md
@@ -0,0 +1,214 @@
+---
+title: "方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efb264dd-f47b-49a9-85ee-9f45d4425765
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# 方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   Web フォーム ASP.NET®  
+  
+## 概要  
+ ここでは、単純な要求対応の ASP.NET Web フォーム アプリケーションを作成する詳細な手順を示します。  また、方法についてフェデレーションな認証の正常な実装の単純な要求対応の ASP.NET Web フォーム アプリケーションをテストできます。  ここでは、セキュリティ トークン Services \(STS\) を作成するための詳細な手順がなく、既に STS を構成していることを前提としています。  
+  
+## 内容  
+  
+-   対象  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- クレームベース認証用の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 対象  
+  
+-   クレームベース認証用の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   正常な要求対応の ASP.NET Web フォーム アプリケーションをテストします。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- フェデレーションな認証用の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成します。  
+  
+#### 単純な ASP.NET アプリケーションを作成するには  
+  
+1.  次に、Visual Studio を起動し、**ファイル**、**新規作成**と **プロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクト** のペインで、**ASP.NET Web フォーム アプリケーション**をクリックします。  
+  
+3.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+## 手順 2 \- クレームベース認証用の ASP.NET Web フォーム アプリケーションを構成します。  
+ この手順で必要な認識するように ASP.NET Web フォーム アプリケーションの *Web.config 構成ファイル* に構成エントリを追加します。  
+  
+#### クレームベース認証を使用するように ASP.NET アプリケーションを構成するには  
+  
+1.  **\<configuration\>** の開始要素の直後の *Web.config 構成ファイル* に次の構成セクションのエントリを追加します:  
+  
+    ```xml  
+    <configSections>  
+      <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+      <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+    </configSections>  
+    ```  
+  
+2.  アプリケーションのフェデレーションのメタデータへのアクセスを可能にする **\<location\>** の要素を追加します:  
+  
+    ```xml  
+    <location path="FederationMetadata">  
+      <system.web>  
+        <authorization>  
+          <allow users="*" />  
+        </authorization>  
+      </system.web>  
+    </location>  
+    ```  
+  
+3.  ユーザーを拒否するに **\<system.web\>** の要素内に次の構成エントリを追加してネイティブの認証を無効にし、認証を管理できます。は WIF ができます。  
+  
+    ```xml  
+    <authorization>  
+      <deny users="?" />  
+    </authorization>  
+    <authentication mode="None" />  
+    ```  
+  
+4.  フェデレーションな認証のモジュールを定義する **\<system.webServer\>** の要素を追加します。  *PublicKeyToken の* 属性が **\<configSections\>** のエントリの *PublicKeyToken の* 属性が、前に追加した同じであることに注意してください:  
+  
+    ```  
+    <system.webServer>  
+      <modules>  
+        <add name="WSFederationAuthenticationModule" type="System.IdentityModel.Services.WSFederationAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />  
+        <add name="SessionAuthenticationModule" type="System.IdentityModel.Services.SessionAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />  
+      </modules>  
+    </system.webServer>  
+    ```  
+  
+5.  次の Windows ID の基本関連構成エントリを追加し、ASP.NET アプリケーションの URL とポート番号が **\<wsFederation\>** の要素の **\<audienceUris\>** エントリ、**領域** の属性、および **\<wsFederation\>** の要素の **応答** の属性の値が一致することを確認します。  また **発行者** の値がセキュリティ トークン サービスの \(STS\) の URL を満たしていることを確認します。  
+  
+    ```xml  
+    <system.identityModel>  
+        <identityConfiguration>  
+            <audienceUris>  
+                <add value="http://localhost:28503/" />  
+            </audienceUris>  
+            <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+                <trustedIssuers>  
+                    <add thumbprint="1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZ1234" name="YourSTSName" />  
+                </trustedIssuers>   
+            </issuerNameRegistry>  
+            <certificateValidation certificateValidationMode="None" />  
+        </identityConfiguration>  
+    </system.identityModel>  
+    <system.identityModel.services>  
+        <federationConfiguration>  
+            <cookieHandler requireSsl="false" />  
+            <wsFederation passiveRedirectEnabled="true" issuer="http://localhost:13922/wsFederationSTS/Issue" realm="http://localhost:28503/" reply="http://localhost:28503/" requireHttps="false" />  
+        </federationConfiguration>  
+    </system.identityModel.services>  
+    ```  
+  
+6.  [System.IdentityModel](assetId:///System.IdentityModel?qualifyHint=False&amp;autoUpgrade=True) のアセンブリへの参照を追加します。  
+  
+7.  エラーを得るためにソリューションをコンパイルします。  
+  
+## 手順 3 \- ソリューションをテストします。  
+ この手順で構成されたクレームベース認証の ASP.NET Web フォーム アプリケーションをテストします。  基本的なテストを実行するには、コードをそのセキュリティ トークン Services \(STS\) によって発行されたトークンの表示の要求追加します。  
+  
+#### ASP.NET Web をテストするにはクレームベース認証を使用するようにアプリケーションを設定します  
+  
+1.  **Default.aspx** ファイルを **TestApp** のプロジェクトで開き、既存のマークアップに置き換えます。:  
+  
+    ```  
+    %@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>  
+  
+    <!DOCTYPE html>  
+  
+    <html>  
+    <head id="Head1" runat="server">  
+        <title></title>  
+    </head>  
+    <body>  
+        <h1><asp:label ID="signedIn" runat="server" /></h1>  
+        <asp:label ID="claimType" runat="server" />  
+        <asp:label ID="claimValue" runat="server" />  
+        <asp:label ID="claimValueType" runat="server" />  
+        <asp:label ID="claimSubjectName" runat="server" />  
+        <asp:label ID="claimIssuer" runat="server" />  
+    </body>  
+    </html>  
+    ```  
+  
+2.  **Default.aspx**を保存し、ファイルによって指定 **Default.aspx.cs**の後ろにコードを開きます。  
+  
+    > [!NOTE]
+    >  **Default.aspx.cs** は、ソリューション エクスプローラーの **Default.aspx** の下に非表示になる場合があります。  **Default.aspx.cs** が表示されない場合は、その横の三角形をクリックして **Default.aspx** を展開します。  
+  
+3.  次のコードで **Default.aspx.cs** の **Page\_Load** のメソッドの既存のコードに置き換えます。:  
+  
+    ```csharp  
+    using System;  
+    using System.IdentityModel;  
+    using System.Security.Claims;  
+    using System.Threading;  
+    using System.Web.UI;  
+  
+    namespace TestApp  
+    {  
+        public partial class _Default : System.Web.UI.Page  
+        {  
+            protected void Page_Load(object sender, EventArgs e)  
+            {  
+                ClaimsPrincipal claimsPrincipal = Thread.CurrentPrincipal as ClaimsPrincipal;  
+  
+                if (claimsPrincipal != null)  
+                {  
+                    signedIn.Text = "You are signed in.";  
+  
+                    foreach (Claim claim in claimsPrincipal.Claims)  
+                    {  
+                        claimType.Text = claim.Type;  
+                        claimValue.Text = claim.Value;  
+                        claimValueType.Text = claim.ValueType;  
+                        claimSubjectName.Text = claim.Subject.Name;  
+                        claimIssuer.Text = claim.Issuer;  
+                    }  
+                }  
+                else  
+                {  
+                    signedIn.Text = "You are not signed in.";  
+                }  
+            }  
+        }  
+    }  
+    ```  
+  
+4.  **Default.aspx.cs**を保存し、ソリューションをビルドします。  
+  
+5.  **F5** キーを押してソリューションを実行します。  
+  
+6.  セキュリティ トークン サービスにより、に発行されたトークンの要求を表示するページという名前を付ける必要があります。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md b/docs/framework/security/how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md
new file mode 100644
index 00000000000..c461c033e40
--- /dev/null
+++ b/docs/framework/security/how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md
@@ -0,0 +1,117 @@
+---
+title: "方法: WIF トレースを使用してクレーム対応アプリケーションおよびサービスをデバッグする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d51ba59-3adb-4ca4-bd33-5027531af687
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# 方法: WIF トレースを使用してクレーム対応アプリケーションおよびサービスをデバッグする
+## 対象  
+  
+-   Microsoft® Windows® Identity Foundation \(WIF\)  
+  
+-   サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)  
+  
+-   WIF アプリケーションのトラブルシューティングとデバッグ  
+  
+## 概要  
+ この方法では、WIF トレースの構成方法、トレース ログの収集方法、およびトレース ビューアー ツールを使用してトレース ログを分析する方法について、必要な手順を説明します。  WIF に関連する問題をトラブルシューティングするために、必要なアクションに対してトレース エントリの全般的なマッピングを行います。  
+  
+## 目次  
+  
+-   目的  
+  
+-   手順の要約  
+  
+-   手順 1 – Web.config 構成ファイルを使用して WIF のトレースを構成する  
+  
+-   手順 2 – トレース ビューアー ツールを使用して WIF のトレース ファイルを分析する  
+  
+-   手順 3 – WIF 関連の問題を修復するための解決策を特定する  
+  
+-   関連項目  
+  
+## 目的  
+  
+-   WIF トレースを構成する。  
+  
+-   トレース ビューアー ツールでトレース ログを表示する。  
+  
+-   トレース ログで WIF 関連の問題を特定する。  
+  
+-   トレース ログで検出された WIF 関連の問題に修正措置を適用する。  
+  
+## 手順の要約  
+  
+-   手順 1 – Web.config 構成ファイルを使用して WIF のトレースを構成する  
+  
+-   手順 2 – トレース ビューアー ツールを使用して WIF のトレース ファイルを分析する  
+  
+-   手順 3 – WIF 関連の問題を修復するための解決策を特定する  
+  
+## 手順 1 – Web.config 構成ファイルを使用して WIF のトレースを構成する  
+ この手順では、*Web.config* ファイルの構成セクションに変更を加えて、WIF がイベントをトレースしてトレース ログに格納できるようにします。  
+  
+#### Web.config 構成ファイルを使用して WIF のトレースを構成するには  
+  
+1.  **ソリューション エクスプローラー** で、Visual Studio エディターのルートの **Web.config** または **App.config** 構成ファイルをダブルクリックして、ファイルを開きます。  ソリューションに **Web.config** または **App.config** 構成ファイルがない場合は、**ソリューション エクスプローラー**でソリューションを右クリックして、**\[追加\]**、**\[新しい項目...\]** の順にクリックして追加します。  **\[新しい項目\]** ダイアログ ボックスで、一覧から **\[アプリケーション構成ファイル\]** \(**App.config の場合**\) または **\[Web 構成ファイル\]** \(**Web.config の場合**\) を選択してから、**\[OK\]** をクリックします。  
+  
+2.  構成ファイルの最後にある **\< configuration \>** ノード内に、以下のような構成エントリを追加します。  
+  
+    ```xml  
+    <system.diagnostics>  
+        <sources>  
+            <source name="System.IdentityModel" switchValue="Verbose">  
+                <listeners>  
+                    <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="WIFTrace.e2e"/>  
+                </listeners>  
+            </source>  
+        </sources>  
+        <trace autoflush="true"/>  
+    </system.diagnostics>  
+    ```  
+  
+3.  上記の構成は、トレース イベントの詳細を生成し、*WIFTrace.e2e* ファイルにログを記録するよう WIF に指示します。  **switchValue** スイッチの値の完全なリストについては、トピック「[トレースの構成](http://msdn.microsoft.com/library/ms733025.aspx)」にあるトレース レベルの表を参照してください。  
+  
+## 手順 2 – トレース ビューアー ツールを使用して WIF のトレース ファイルを分析する  
+ このステップでは、トレース ビューアー ツール \(SvcTraceViewer.exe\) を使用して WIF のトレース ログを分析します。  
+  
+#### トレース ビューアー ツール \(SvcTraceViewer.exe\) を使用して WIF のトレース ログを分析するには  
+  
+1.  トレース ビューアー ツール \(SvcTraceViewer.exe\) は、Windows SDK の一部として同梱されています。  Windows SDK をまだインストールしていない場合は、こちら \([Windows SDK](http://www.microsoft.com/download/en/details.aspx?id=8279)\) からダウンロードできます。  
+  
+2.  トレース ビューアー ツール \(SvcTraceViewer.exe\) を実行します。  通常、これはインストール パスの **Bin** フォルダーから使用できます。  
+  
+3.  たとえば、メニューで **\[ファイル\]**、**\[開く...\]** オプションをクリックするか、**Ctrl キーを押しながら O キーを押す**ショートカットを使用して、WIF トレースのログ ファイル WIFTrace.e2e を開きます。  トレース ビューアー ツールでトレース ログ ファイルが開きます。  
+  
+4.  **\[アクティビティ\]** タブでエントリを確認します。  各エントリには、アクティビティの数、ログに記録されたトレースの数、アクティビティの期間および開始と終了のタイムスタンプが含まれているはずです。  
+  
+5.  **\[アクティビティ\]** タブをクリックします。  ツールのメイン領域に詳細なトレース エントリが表示されます。  メニューにある **\[レベル\]** ドロップダウン リストを使用して、たとえば **\[すべて\]**、**\[警告\]**、**\[エラー\]**、**\[情報\]** など、特定のレベルのトレースをフィルター処理します。  
+  
+6.  特定のトレース エントリをクリックすると、ツールの下部の領域で詳細を確認できます。  詳細は、対応するタブを選択することで、**書式付き**および **XML** ビューで表示することができます。  
+  
+## 手順 3 – WIF 関連の問題を修復するための解決策を特定する  
+ この手順では、WIF のトレース ログとトレース ビューアー ツールを使用して、WIF に関連する問題の解決方法を特定できます。  WIF 関連の例外と、問題をトラブルシューティングするための可能性のある解決策や必要な操作との全般的なマッピングを概説しています。  
+  
+#### WIF 関連の問題を修復するための解決策を特定するには  
+  
+1.  WIF の例外と問題を修正するために必要な操作に関する次の表を確認します。  
+  
+||||  
+|-|-|-|  
+|**エラー ID**|**エラー メッセージ**|**エラーを修復するために必要な操作**|  
+|ID4175|セキュリティ トークンの発行者は、IssuerNameRegistry で認識されませんでした。  この発行者からのセキュリティ トークンを承認するには、この発行者の有効な名前を返すように IssuerNameRegistry を構成します。|このエラーは、MMC スナップインから拇印をコピーして、*Web.config* ファイルに貼り付けると発生する可能性があります。  具体的には、\[証明書のプロパティ\] ウィンドウからコピーするときに、テキスト文字列内で余分な印刷できない文字を取得することがあります。  この余分な文字により、拇印との照合が失敗します。正しく拇印をコピーするための手順は以下を参照してください。 [http:\/\/msdn.microsoft.com\/library\/ff359102.aspx](http://msdn.microsoft.com/library/ff359102.aspx)|  
+  
+## 関連項目  
+  
+-   [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](http://msdn.microsoft.com/library/aa751795.aspx)
\ No newline at end of file
diff --git a/docs/framework/security/how-to-display-signed-in-status-using-wif.md b/docs/framework/security/how-to-display-signed-in-status-using-wif.md
new file mode 100644
index 00000000000..14639e2d247
--- /dev/null
+++ b/docs/framework/security/how-to-display-signed-in-status-using-wif.md
@@ -0,0 +1,161 @@
+---
+title: "方法: WIF を使用してサインイン状態を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d1174e4-5397-4962-9a5f-3b1ad7b3fc14
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# 方法: WIF を使用してサインイン状態を表示する
+## 対象  
+  
+-   Microsoft® Windows® Identity Foundation \(WIF\) 4.5  
+  
+-   ASP.NET® Web フォーム  
+  
+## 要約  
+ このトピックでは、WIF 対応 ASP.NET アプリケーションでサインイン状態を表示する方法について説明します。  WIF には、アプリケーションでクレームが認識されるようにする機能、およびアプリケーション リソースの認証と承認を管理する機能があります。  
+  
+## 内容  
+  
+-   概要  
+  
+-   手順の要約  
+  
+-   手順 1 – Identity and Access 拡張機能をインストールする  
+  
+-   手順 2 – 証明書利用者の ASP.NET アプリケーションの作成  
+  
+-   手順 3 – ユーザー認証のためのローカル開発用 STS の有効化  
+  
+-   手順 4 – ASP.NET アプリケーションを変更してサインイン状態を表示する  
+  
+-   手順 5 – WIF と ASP.NET アプリケーション間の統合のテスト  
+  
+## 概要  
+ このトピックでは、WIF を使用して簡単なクレーム対応アプリケーションを作成する方法と、ユーザーがサインインしているかどうかを簡単に表示する方法について説明します。  次の手順では、Visual Studio の Identity and Access 拡張機能に含まれるローカル開発用 STS を使用します。  ローカル開発用 STS は、アプリケーションにクレームを統合する簡単な方法を提供する目的で、テストおよび開発環境向けに用意されたものです。  これは、実際の認証を行わず、資格情報も不要なため、稼動環境で使用しないでください。  ただし、次の手順の命令型コードは、実際の認証を使用した運用環境で使用できるアプリケーションの場合と同じです。  
+  
+## 手順の要約  
+  
+-   手順 1 – Identity and Access 拡張機能をインストールする  
+  
+-   手順 2 – 証明書利用者の ASP.NET アプリケーションの作成  
+  
+-   手順 3 – ユーザー認証のためのローカル開発用 STS の有効化  
+  
+-   手順 4 – ASP.NET アプリケーションを変更してサインイン状態を表示する  
+  
+-   手順 5 – WIF と ASP.NET アプリケーション間の統合のテスト  
+  
+## 手順 1 – Identity and Access 拡張機能をインストールする  
+ この手順では、Identity and Access 拡張機能を Visual Studio 2012 用に構成する方法を説明します。  この拡張機能により、STS エンドポイントと通信するようにアプリケーションを構成するプロセスが自動化されます。  
+  
+#### Identity and Access 拡張機能をインストールするには  
+  
+1.  システム特権のあるモードで管理者として Visual Studio を起動します。  
+  
+2.  Visual Studio で、**\[ツール\]** をポイントし、**\[拡張機能マネージャー\]** をクリックします。  **\[拡張機能マネージャー\]** ウィンドウが表示されます。  
+  
+3.  **拡張機能マネージャー**の左メニューから **\[オンラインの拡張機能\]**、**\[Visual Studio ギャラリー\]** の順にクリックします。  
+  
+4.  **拡張機能マネージャー**の右上隅で、"*Identity and Access*" を検索します。  
+  
+5.  **Identity and Access** の項目が検索結果に表示されます。  それをクリックしてから、**\[ダウンロード\]** をクリックします。  
+  
+6.  **\[ダウンロードとインストール\]** ダイアログ ボックスが表示されます。  ライセンス条項に同意する場合は、**\[インストール\]** をクリックします。  
+  
+7.  **Identity and Access** の拡張機能のインストールが終了すると、管理者モードで Visual Studio を再起動します。  
+  
+## 手順 2 – 証明書利用者の ASP.NET アプリケーションの作成  
+ この手順では、WIF と統合する証明書利用者の ASP.NET Web フォーム アプリケーションを作成する方法について説明します。  
+  
+#### 簡単な ASP.NET アプリケーションを作成するには  
+  
+1.  Visual Studio を起動し、**\[ファイル\]**、**\[新規作成\]** の順にポイントして、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ウィンドウで、**\[ASP.NET Web フォーム アプリケーション\]** をクリックします。  
+  
+3.  **\[名前\]** で、「`TestApp`」と入力し、**\[OK\]** をクリックします。  
+  
+## 手順 3 – ユーザー認証のためのローカル開発用 STS の有効化  
+ この手順では、アプリケーションでローカル開発用 STS を有効にする方法について説明します。  ローカル開発用 STS は、Visual Studio 用の Identity and Access 拡張機能を使用することによって有効になります。  
+  
+#### ASP.NET アプリケーションでローカル開発用 STS を有効にするには  
+  
+1.  Visual Studio の**ソリューション エクスプローラー**で **\[TestApp\]** プロジェクトを右クリックし、**\[Identity and Access\]** をクリックします。  
+  
+2.  **\[Identity and Access\]** ウィンドウが表示されます。  **\[Providers\]** で **\[Test your application with the Local Development STS\]** を選択し、**\[Apply\]** をクリックします。  
+  
+## 手順 4 – ASP.NET アプリケーションを変更してサインイン状態を表示する  
+ この手順では、現在のユーザーがサインインしているかどうかを動的に表示するように ASP.NET アプリケーションを変更する方法について説明します。  STS プロバイダーを構成すると、WIF は受信クレームを処理します。  次に、認証の結果を表示するために、アプリケーション コードを構成する必要があります。  
+  
+#### サインイン状態を表示するには  
+  
+1.  Visual Studio で **\[TestApp\]** プロジェクトの下にある**Default.aspx** ファイルを開きます。  
+  
+2.  **Default.aspx** ファイルの既存のマークアップを次のマークアップに置き換えます。  
+  
+    ```  
+    <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>  
+  
+    <!DOCTYPE html>  
+  
+    <html>  
+    <head runat="server">  
+        <title>Logged In Status</title>  
+    </head>  
+    <body>  
+        <asp:label ID="myLabel" runat="server" />  
+    </body>  
+    </html>  
+    ```  
+  
+3.  **Default.aspx** を保存し、**Default.aspx.cs** という名前のファイルに隠れているコードを開きます。  
+  
+    > [!NOTE]
+    >  **Default.aspx.cs** は、ソリューション エクスプローラーで **Default.aspx** の下に隠れていることがあります。  **Default.aspx.cs** が表示されない場合は、**Default.aspx** の横の三角形をクリックして展開します。  
+  
+4.  **Default.aspx.cs** の既存のコードを次のコードに置き換えます。  
+  
+    ```csharp  
+    using System;  
+    using System.Web.UI;  
+    using System.Security.Claims;  
+  
+    namespace TestApp  
+    {  
+        protected void Page_Load(object sender, EventArgs e)  
+        {  
+            ClaimsPrincipal claimsPrincipal = Thread.CurrentPrincipal as ClaimsPrincipal;  
+  
+            if (claimsPrincipal != null)  
+            {  
+                myLabel.Text = "You are signed in.";  
+            }  
+            else  
+            {  
+                myLabel.Text = "You are not signed in.";  
+            }  
+        }  
+    }  
+    ```  
+  
+5.  **Default.aspx.cs** を保存し、アプリケーションをビルドします。  
+  
+## 手順 5 – WIF と ASP.NET アプリケーション間の統合のテスト  
+ この手順では、WIF と ASP.NET アプリケーション間の統合をテストする方法について説明します。  
+  
+#### WIF と ASP.NET 間の統合をテストするには  
+  
+1.  Visual Studio で **F5** キーを押して、アプリケーションのデバッグを開始します。  エラーがなければ、新しいブラウザー ウィンドウが開きます。  
+  
+2.  ブラウザーが STS に自動的に要求をリダイレクトし、Default.aspx ページが開きます。  WIF が正しく構成されている場合は、サイトに **"You are signed in"** というテキストが表示されます。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-enable-token-replay-detection.md b/docs/framework/security/how-to-enable-token-replay-detection.md
new file mode 100644
index 00000000000..3f82ff36a14
--- /dev/null
+++ b/docs/framework/security/how-to-enable-token-replay-detection.md
@@ -0,0 +1,89 @@
+---
+title: "方法: トークン再生検出を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a9f5771-f5f6-4100-8501-406aa20d731a
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# 方法: トークン再生検出を有効にする
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   Web フォーム ASP.NET®  
+  
+## 概要  
+ ここでは、WIF を使用する ASP.NET アプリケーションの再生トークンの検出を有効にする詳細な手順を示します。  また、トークンを再生する手順の検出が有効になっていることを確認するアプリケーションをテストできます。  ここでは、セキュリティ トークン Services \(STS\) を作成するための詳細な手順がない場合、代わりに ID およびアクセス ツールに付属の開発の STS を使用します。  開発の STS は、実際の認証を実行せずにのみテストのために用意されています。  これをどのように実行する ID とアクセス ツールをインストールする必要があります。  これは、次の場所からダウンロードすることもできます: [ID アクセスおよびツール](http://go.microsoft.com/fwlink/?LinkID=245849)  
+  
+## 内容  
+  
+-   対象  
+  
+-   概要  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成し、再生の検出を有効にします。  
+  
+-   手順 2 \- ソリューションをテストします。  
+  
+## 対象  
+  
+-   ID から WIF および開発の STS を使用して作成し、ツールにアクセスする簡単な ASP.NET アプリケーションを  
+  
+-   再生トークンの検出を有効にし、動作していることを確認します。  
+  
+## 概要  
+ 再生攻撃は、クライアントがクライアントが既に使用している STS のトークンを使用して証明書利用者に認証しようとすると発生します。  この攻撃を防止するために、WIF は既に使用されている STS トークンの再生の検出のキャッシュが含まれます。  有効にすると、再生の検出は、受信した要求のトークンをチェックし、そのトークンが既に使用されているかどうかを確認します。  トークンが既に使用されている場合は、要求は断られ、<xref:System.IdentityModel.Tokens.SecurityTokenReplayDetectedException> 例外がスローされます。  
+  
+ 次の手順では、再生の検出を有効にするために必要な設定を示します。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成し、再生の検出を有効にします。  
+  
+-   手順 2 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成し、再生の検出を有効にします。  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成し、再生の検出を有効にするには、*Web.config ファイルを* 変更します。  
+  
+#### 単純な ASP.NET アプリケーションを作成するには  
+  
+1.  次に、Visual Studio を起動し、**ファイル**、**新規作成**と **プロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクト** のペインで、**ASP.NET Web フォーム アプリケーション**をクリックします。  
+  
+3.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+4.  **TestApp** のプロジェクトを **ソリューション エクスプローラー**の下にあるを右クリックして、を **Identity and Access**を選択します。  
+  
+5.  **Identity and Access** のウィンドウが表示されます。  **プロバイダ**の\[ **ローカルの開発用 STS でアプリケーションをテストします。**は、を **適用**をクリックします。  
+  
+6.  示したのような **\<system.identityModel\>** と **\<identityConfiguration\>** の要素の後に *Web.config 構成ファイル* に **\<tokenReplayDetection\>** の次の要素を追加します:  
+  
+    ```  
+    <system.identityModel>  
+        <identityConfiguration>  
+            <tokenReplayDetection enabled=”true”/>  
+    ```  
+  
+## 手順 2 \- ソリューションをテストします。  
+ この手順では、再生の検出が有効になっていることを検証する、ASP.NET WIF 対応アプリケーションをテストします。  
+  
+#### 再生の検出の、ASP.NET WIF 対応アプリケーションをテストするには  
+  
+1.  **F5** キーを押してソリューションを実行します。  既定の ASP.NET のホーム ページという名前で、開発 STS によって返される既定のユーザーであるユーザー名と *テリー*自動的に認証されます。  
+  
+2.  ブラウザーの **\[戻る\]** のをクリックします。  次の説明を含める **「\/」のサーバー アプリケーション エラー** のページという名前を付ける必要があります: *ID1062: 再生が検出されました: トークン: 'System.IdentityModel.Tokens.SamlSecurityToken'*、*AssertionId* および *発行元が*表示されている。  
+  
+     トークン再生が検出されたときに型 <xref:System.IdentityModel.Tokens.SecurityTokenReplayDetectedException> の例外がスローされたため、このエラー ページが表示されています。  このエラーは、トークンが最初に指定した場合に、最初の POST 要求を送信し直すしようとしているからです。  **\[戻る\]** のボタンにより、サーバーへの以降の要求でこの動作は発生しません。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-enable-wif-for-a-wcf-web-service-application.md b/docs/framework/security/how-to-enable-wif-for-a-wcf-web-service-application.md
new file mode 100644
index 00000000000..6bebd0601bc
--- /dev/null
+++ b/docs/framework/security/how-to-enable-wif-for-a-wcf-web-service-application.md
@@ -0,0 +1,264 @@
+---
+title: "操作方法: WCF Web サービス アプリケーションの WIF を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bfc64b3d-64e9-4093-a6a4-72e933917af7
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# 操作方法: WCF Web サービス アプリケーションの WIF を有効にする
+## 対象  
+  
+-   Microsoft® Windows® Identity Foundation \(WIF\)  
+  
+-   Microsoft® Windows® Communication Foundation \(WCF\)  
+  
+## 要約  
+ ここでは、WCF Web サービスの WIF を有効にするための詳細な操作手順を示します。  また、アプリケーションの実行中に Web サービスが正しくクレームを表示しているかどうかを確認するためにアプリケーションをテストする方法についても説明します。  ここでは、セキュリティ トークン サービス \(STS\) を作成するための詳細な手順については説明しません。代わりに、Identity and Access Tool に付属している開発用 STS を使用します。  開発用 STS はテスト用に用意されたもので、実際の認証は行いません。  このページの内容を完了するには、Identity and Access Tool をインストールする必要があります。  これは、「[Identity and Access Tool](http://go.microsoft.com/fwlink/?LinkID=245849)」からダウンロードできます。  
+  
+## 内容  
+  
+-   目的  
+  
+-   概要  
+  
+-   手順の要約  
+  
+-   手順 1 – 簡単な WCF サービスの作成  
+  
+-   手順 2 – WCF サービスのクライアント アプリケーションの作成  
+  
+-   手順 3 – ソリューションのテスト  
+  
+## 目的  
+  
+-   発行済みトークンを必要とする WCF サービスを作成する  
+  
+-   STS のトークンを要求し、それを WCF サービスに渡す WCF クライアントを作成する  
+  
+## 概要  
+ ここでは、WCF サービス開発時に開発者がフェデレーション認証を使用する方法を示します。  WCF サービスでフェデレーションを使用する利点には、次のものが含まれます。  
+  
+1.  WCF サービス コード外の認証ロジックのファクタリング  
+  
+2.  既存の ID 管理ソリューションの再利用  
+  
+3.  他の ID ソリューションとの相互運用性  
+  
+4.  今後の変更に対する柔軟性と回復力  
+  
+ 次の手順に示すように、WIF および関連する Identity and Access Tool を使用すると、フェデレーション認証を使用した WCF サービスの開発およびテストが簡単になります。  
+  
+## 手順の要約  
+  
+-   手順 1 – 簡単な WCF サービスの作成  
+  
+-   手順 2 – WCF サービスのクライアント アプリケーションの作成  
+  
+-   手順 3 – ソリューションのテスト  
+  
+## 手順 1 – 簡単な WCF サービスの作成  
+ この手順では、Identity and Access Tool に付属している開発用 STS を使用する新しい WCF サービスを作成します。  
+  
+#### 簡単な WCF サービスを作成するには  
+  
+1.  システム特権のあるモードで管理者として Visual Studio を起動します。  
+  
+2.  Visual Studio で、**\[ファイル\]**、**\[新規作成\]** の順にポイントし、**\[プロジェクト\]** をクリックします。  
+  
+3.  **\[新しいプロジェクト\]** ウィンドウで、**\[WCF サービス アプリケーション\]** をクリックします。  
+  
+4.  **\[名前\]** で、「`TestService`」と入力し、**\[OK\]** をクリックします。  
+  
+5.  **ソリューション エクスプローラー**で **\[TestService\]** プロジェクトを右クリックし、**\[Identity and Access\]** をクリックします。  
+  
+6.  **\[Identity and Access\]** ウィンドウが表示されます。  **\[Providers\]** で **\[Test your application with the Local Development STS\]** を選択し、**\[Apply\]** をクリックします。  Identity and Access Tool は、サービスが WIF を使用し、*Web.config* ファイルに構成要素を追加することによって認証をローカル開発用の STS \(**LocalSTS**\) に外部委託するように構成します。  
+  
+7.  *Service1.svc.cs* ファイルで、**System.Security.Claims** 名前空間に `using` ディレクティブを追加し、既存のコードを次のコードに置き換え、ファイルを保存します。  
+  
+    ```csharp  
+    public class Service1 : IService1  
+    {  
+        public string ComputeResponse(string input)  
+        {  
+            // Get the caller's identity from ClaimsPrincipal.Current  
+            ClaimsPrincipal claimsPrincipal = OperationContext.Current.ClaimsPrincipal;  
+  
+            // Start generating the output  
+            StringBuilder builder = new StringBuilder();  
+            builder.AppendLine("Computed by ClaimsAwareWebService");  
+            builder.AppendLine("Input received from client:" + input);  
+  
+            if (claimsPrincipal != null)  
+            {  
+                // Display the claims from the caller. Do not use this code in a production application.  
+                ClaimsIdentity identity = claimsPrincipal.Identity as ClaimsIdentity;  
+                builder.AppendLine("Client Name:" + identity.Name);  
+                builder.AppendLine("IsAuthenticated:" + identity.IsAuthenticated);  
+                builder.AppendLine("The service received the following issued claims of the client:");  
+  
+                // Iterate over the caller’s claims and append to the output  
+                foreach (Claim claim in claimsPrincipal.Claims)  
+                {  
+                    builder.AppendLine("ClaimType :" + claim.Type + "   ClaimValue:" + claim.Value);  
+                }  
+            }  
+  
+            return builder.ToString();  
+        }  
+    }  
+    ```  
+  
+     `ComputeResponse` メソッドでは、**LocalSTS** が発行するさまざまなクレームのプロパティが表示されます。  
+  
+8.  *IService1.cs* ファイルでは、既存のコードを次のコードに置き換え、ファイルを保存します。  
+  
+    ```csharp  
+    [ServiceContract]  
+    public interface IService1  
+    {  
+        [OperationContract]  
+        string ComputeResponse(string input);  
+    }  
+    ```  
+  
+9. プロジェクトをビルドします。  
+  
+10. デバッガーを起動せずにサービスを実行するには、**Ctrl \+ F5** を押します。  Web ページが開いてサービスが表示されます。通知領域 \(システム トレイ\) を見ると、**LocalSTS** が実行中であることが確認できます。  
+  
+    > [!IMPORTANT]
+    >  次の手順でクライアント アプリケーションにサービス参照を追加するとき、**TestService** と **LocalSTS** の両方が実行されている必要があります。  
+  
+## 手順 2 – WCF サービスのクライアント アプリケーションの作成  
+ この手順では、前の手順で作成した WCF サービスとの認証に開発用 STS を使用するコンソール アプリケーションを作成します。  
+  
+#### クライアント アプリケーションを作成するには  
+  
+1.  Visual Studio でソリューションを右クリックし、**\[追加\]** をポイントして **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクトの追加\]** ウィンドウで、**\[Visual C\#\]** テンプレート一覧から **\[コンソール アプリケーション\]** をクリックし、「`Client`」と入力して **\[OK\]** をクリックします。  新しいプロジェクトがソリューション フォルダーに作成されます。  
+  
+3.  **\[Client\]** プロジェクトの下の **\[参照\]** を右クリックし、**\[サービス参照の追加\]** をクリックします。  
+  
+4.  **\[サービス参照の追加\]** ウィンドウで、**\[探索\]** ボタンのドロップダウン矢印をクリックし、**\[ソリューションのサービス\]** をクリックします。  **\[アドレス\]** には、前の手順で作成した WCF サービスが自動的に入力されます。**\[名前空間\]** は、**\[ServiceReference1\]** に設定されます。  **\[OK\]** をクリックします。  
+  
+    > [!IMPORTANT]
+    >  クライアントにサービス参照を追加するとき、**TestService** と **LocalSTS** の両方が実行されている必要があります。  
+  
+5.  Visual Studio は、WCF サービスのプロキシ クラスを生成し、必要なリファレンス情報をすべて追加します。  また、*App.config* ファイルに要素を追加して、サービスでの認証のために STS からトークンを取得するようにクライアントを構成します。  このプロセスが完了したら、**Program.cs** ファイルが開きます。  **System.ServiceModel** と **Client.ServiceReference1** それぞれに `using` ディレクティブを追加し、**Main** メソッドを次のコードに置き換えて、ファイルを保存します。  
+  
+    ```csharp  
+    static void Main(string[] args)  
+    {  
+        // Create the client for the service  
+        Service1Client client = new Service1Client();  
+        Console.WriteLine("-------------WCF Client Application--------------\n");  
+  
+        while (!ShouldQuitApplication())  
+        {  
+            try  
+            {  
+                Console.WriteLine(client.ComputeResponse("Hello World"));  
+            }  
+            catch (CommunicationException e)  
+            {  
+                Console.WriteLine(e.Message);  
+                Console.WriteLine(e.StackTrace);  
+                Exception ex = e.InnerException;  
+                while (ex != null)  
+                {  
+                    Console.WriteLine("===========================");  
+                    Console.WriteLine(ex.Message);  
+                    Console.WriteLine(ex.StackTrace);  
+                    ex = ex.InnerException;  
+                }  
+            }  
+            catch (TimeoutException)  
+            {  
+                Console.WriteLine("Timed out...");  
+            }  
+            catch (Exception e)  
+            {  
+                Console.WriteLine("An unexpected exception occurred.");  
+                Console.WriteLine(e.StackTrace);  
+            }  
+        }  
+  
+        client.Close();  
+  
+        if (client != null)  
+        {  
+            client.Abort();  
+        }  
+    }  
+  
+    static bool ShouldQuitApplication()  
+    {  
+        Console.WriteLine("---------------------------------------------------------------------");  
+        Console.WriteLine("Press Enter key to invoke service, any other key to quit application:");  
+        Console.WriteLine("----------------------------------------------------------------------");  
+  
+        ConsoleKeyInfo keyInfo = Console.ReadKey();  
+        if (keyInfo.Key == ConsoleKey.Enter)  
+            return false;  
+        return true;  
+    }  
+    ```  
+  
+6.  *App.config* ファイルを開き、`<system.serviceModel>` 要素の下に最初の子要素として次の XML を追加し、ファイルを保存します。  
+  
+    ```  
+    <behaviors>  
+       <endpointBehaviors>  
+         <behavior>  
+           <clientCredentials>  
+             <serviceCertificate>  
+               <authentication certificateValidationMode="None"/>  
+             </serviceCertificate>  
+           </clientCredentials>  
+         </behavior>  
+       </endpointBehaviors>  
+     </behaviors>  
+  
+    ```  
+  
+     これにより、証明書の検証が無効になります。  
+  
+7.  **\[TestService\]** ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。  **\[スタートアップ プロジェクト\]** プロパティ ページが表示されます。  **\[スタートアップ プロジェクト\]** プロパティ ページで、**\[マルチ スタートアップ プロジェクト\]** をクリックします。次に、各プロジェクトの **\[アクション\]** フィールドをクリックし、ドロップダウン メニューの **\[開始\]** をクリックします。  **\[OK\]** をクリックして設定を保存します。  
+  
+8.  ソリューションをビルドします。  
+  
+## 手順 3 – ソリューションのテスト  
+ この手順では、WIF 対応 WCF アプリケーションをテストし、クレームが表示されることを確認します。  
+  
+#### WIF 対応 WCF アプリケーションをテストしてクレームを確認するには  
+  
+1.  F5 キーを押してアプリケーションをビルドし、実行します。  "**Press Enter key to invoke service, any other key to quit application:**" というテキストが表示されたコンソール ウィンドウが開きます。  
+  
+2.  **Enter** キーを押すと、コンソールに以下のクレーム情報が表示されます。  
+  
+    ```  
+    Computed by Service1  
+    Input received from client: Hello World  
+    Client Name: Terry  
+    IsAuthenticated: True  
+    The service received the following issued claims of the client:  
+    ClaimType :http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name    ClaimValue:Terry  
+    ClaimType :http://schema.xmlsoap.org/ws/2005/05/identity/claims/surname    ClaimValue:Adams  
+    ClaimType :http://schemas.microsoft.com/ws/2008/06/identity/claims/role    ClaimValue:developer  
+    ClaimType :http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress    ClaimValue:terry@contoso.com  
+    ```  
+  
+    > [!IMPORTANT]
+    >  **Enter** キーを押す前に **TestService** と **LocalSTS** の両方が実行されている必要があります。  Web ページが開いてサービスが表示されます。通知領域 \(システム トレイ\) を見ると、**LocalSTS** が実行中であることが確認できます。  
+  
+3.  これらのクレームがコンソールに表示されている場合、WCF サービスのクレームを表示するための STS での認証が正常に完了しています。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-enable-wif-tracing.md b/docs/framework/security/how-to-enable-wif-tracing.md
new file mode 100644
index 00000000000..153d1049229
--- /dev/null
+++ b/docs/framework/security/how-to-enable-wif-tracing.md
@@ -0,0 +1,108 @@
+---
+title: "方法: WIF トレースの有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 271b6889-3454-46ff-96ab-9feb15e742ee
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# 方法: WIF トレースの有効化
+## 対象  
+  
+-   Microsoft® Windows® Identity Foundation \(WIF\)  
+  
+-   ASP.NET® Web フォーム  
+  
+## 要約  
+ ここでは、ASP.NET アプリケーションの WIF トレースを有効にするための詳細な操作手順を示します。  また、トレース リスナーとログが正しく動作していることを確認するためにアプリケーションをテストする方法についても説明します。  ここでは、セキュリティ トークン サービス \(STS\) を作成するための詳細な手順については説明しません。代わりに、Identity and Access Tool に付属している開発用 STS を使用します。  開発用 STS はテスト用に用意されたもので、実際の認証は行いません。  このページの内容を完了するには、Identity and Access Tool をインストールする必要があります。  これは、「[Identity and Access Tool](http://go.microsoft.com/fwlink/?LinkID=245849)」からダウンロードできます。  
+  
+> [!IMPORTANT]
+>  パッシブ アプリケーション \(つまり、WS フェデレーション プロトコルを使用するアプリケーション\) の WIF トレースを有効にすると、アプリケーションをサービス拒否 \(DoS\) 攻撃に晒したり、悪意のあるユーザーに情報を開示する可能性があります。  これにはパッシブ RP とパッシブ STS の両方が含まれます。  したがって、稼動環境ではパッシブ RP またはパッシブ STS の WIF トレースを有効にしないことをお勧めします。  
+  
+## 内容  
+  
+-   目的  
+  
+-   概要  
+  
+-   手順の要約  
+  
+-   手順 1 – 簡単な ASP.NET Web フォーム アプリケーションの作成とトレースの有効化  
+  
+-   手順 2 – ソリューションのテスト  
+  
+## 目的  
+  
+-   Identity and Access Tool の WIF および開発用 STS を使用する簡単な ASP.NET アプリケーションの作成  
+  
+-   トレースの有効化と動作確認  
+  
+## 概要  
+ トレースすると、トークン、クッキー、クレーム、プロトコル メッセージなどを含む、さまざまな種類の WIF の問題をデバッグおよびトラブルシューティングすることができます。  WIF トレースは、WCF トレースに似ています。たとえば、トレースの詳細レベルを選択して、警告メッセージから全メッセージまで、すべてを表示させることができます。  WIF トレースは、**.xml** ファイル、またはサービス トレース ビューアー ツールを使用して表示できる **.svclog** ファイルで作成できます。  このツールは、コンピューターの Windows SDK インストール パスの **bin** ディレクトリにあります \(例: **C:\\Program Files\\Microsoft SDKs\\Windows\\v7.1\\Bin\\SvcTraceViewer.exe**\)。  
+  
+## 手順の要約  
+  
+-   手順 1 – 簡単な ASP.NET Web フォーム アプリケーションの作成とトレースの有効化  
+  
+-   手順 2 – ソリューションのテスト  
+  
+## 手順 1 – 簡単な ASP.NET Web フォーム アプリケーションの作成とトレースの有効化  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成し、トレースを有効にするために *Web.config* ファイルを変更します。  
+  
+#### 簡単な ASP.NET アプリケーションを作成するには  
+  
+1.  Visual Studio を起動し、**\[ファイル\]**、**\[新規作成\]** の順にポイントして、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ウィンドウで、**\[ASP.NET Web フォーム アプリケーション\]** をクリックします。  
+  
+3.  **\[名前\]** で、「`TestApp`」と入力し、**\[OK\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **\[TestApp\]** プロジェクトを右クリックし、**\[Identity and Access\]** をクリックします。  
+  
+5.  **\[Identity and Access\]** ウィンドウが表示されます。  **\[Providers\]** で **\[Test your application with the Local Development STS\]** を選択し、**\[Apply\]** をクリックします。  
+  
+6.  表示されている例 \(**C:\\logs**\) のように、**C:** ドライブのルートに **logs** という名前の新しいフォルダーを作成します。  
+  
+7.  表示されている例のように、終了要素 **\<\/configSections\>** の直後に、以下の **\<system.diagnostics\>** 要素を *Web.config* 構成ファイルに追加します。  
+  
+    ```  
+    <configuration>  
+        <configSections>  
+        …  
+        </configSections>  
+        <system.diagnostics>  
+            <sources>  
+                <source name="System.IdentityModel" switchValue="Verbose">  
+                    <listeners>  
+                        <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="C:\logs\WIF.xml" />  
+                    </listeners>  
+                </source>  
+            </sources>  
+            <trace autoflush="true" />  
+        </system.diagnostics>  
+    ```  
+  
+    > [!NOTE]
+    >  **initializeData** 属性で指定されたディレクトリの場所は、ログが開始される前に存在している必要があります。  この場所が存在しない場合、ログは作成されません。  
+  
+     上記の構成設定では、**詳細**な WIF トレースが有効になり、**C:\\logs\\WIF.xml** ファイルに結果のログが保存されます。  
+  
+## 手順 2 – ソリューションのテスト  
+ この手順では、WIF 対応 ASP.NET アプリケーションをテストし、ログが記録されていることを確認します。  
+  
+#### 正常なトレースのために WIF 対応 ASP.NET アプリケーションをテストするには  
+  
+1.  **F5** キーを押して、ソリューションを実行します。  既定の ASP.NET ホーム ページが開き、ユーザー名 *Terry* \(開発用 STS によって返される既定のユーザー\) で自動的に認証されます。  
+  
+2.  ブラウザー ウィンドウを閉じ、**C:\\logs** フォルダーに移動します。  テキスト エディターを使用して **C:\\logs\\WIF.xml** ファイルを開きます。  
+  
+3.  **WIF.xml** ファイルを確認し、**\<E2ETraceEvent\>** で始まるエントリが含まれていることを確認します。  これらのトレースには、**\<TraceRecord\>** 要素と、トレースされるアクティビティ \(**Validating SecurityToken** など\) の説明が含まれています。
\ No newline at end of file
diff --git a/docs/framework/security/how-to-transform-incoming-claims.md b/docs/framework/security/how-to-transform-incoming-claims.md
new file mode 100644
index 00000000000..2adbf1fac15
--- /dev/null
+++ b/docs/framework/security/how-to-transform-incoming-claims.md
@@ -0,0 +1,182 @@
+---
+title: "方法: 入力方向の要求の変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2831d514-d9d8-4200-9192-954bb6da1126
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# 方法: 入力方向の要求の変換
+## 対象  
+  
+-   Microsoft® Windows® の ID Foundation \(WIF\)  
+  
+-   Web フォーム ASP.NET®  
+  
+## 概要  
+ ここでは、単純な要求対応の ASP.NET Web フォーム アプリケーションを作成し、着信要求を変換するための詳細な手順を示します。  また、メソッドにアプリケーションの実行時に命令を追加する必要があることを確認するアプリケーションをテストできます。  
+  
+## 内容  
+  
+-   対象  
+  
+-   概要  
+  
+-   手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- カスタム ClaimsAuthenticationManager を使用して要求の変換を実行します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 対象  
+  
+-   クレームベース認証用の ASP.NET Web フォーム アプリケーションを構成します。  
+  
+-   要求管理者ロールに追加することにより、着信要求を変換します。  
+  
+-   正常に動作しているかどうかを ASP.NET Web フォーム アプリケーションをテストします。  
+  
+## 概要  
+ WIF には、証明書利用者の \(RP\) アプリケーションにという名前の前に <xref:System.Security.Claims.ClaimsAuthenticationManager> という要求を変更することを可能にするクラスを公開します。  <xref:System.Security.Claims.ClaimsAuthenticationManager> は認証と基になるアプリケーション コードの関心の分離に便利です。  次のの例は、RP によって必要とされる <xref:System.Security.Claims.ClaimsPrincipal> 受信した要求にロールを追加する方法を示します。  
+  
+## 手順の概要  
+  
+-   手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+  
+-   手順 2 \- カスタム ClaimsAuthenticationManager を使用して要求の変換を実行します。  
+  
+-   手順 3 \- ソリューションをテストします。  
+  
+## 手順 1 \- 単純な ASP.NET Web フォーム アプリケーションを作成します。  
+ この手順では、新しい ASP.NET Web フォーム アプリケーションを作成します。  
+  
+#### 単純な ASP.NET アプリケーションを作成するには  
+  
+1.  管理者としてのあるモードで開始の Visual Studio。  
+  
+2.  Visual Studio で、をクリック **ファイル**の **新規作成**クリックし、を **プロジェクト**をクリックします。  
+  
+3.  **新しいプロジェクト** のペインで、**ASP.NET Web フォーム アプリケーション**をクリックします。  
+  
+4.  **名前**では、`TestApp` を入力し、**OK**を押します。  
+  
+5.  **TestApp** のプロジェクトを **ソリューション エクスプローラー**の下にあるを右クリックして、を **Identity and Access**を選択します。  
+  
+6.  **Identity and Access** のウィンドウが表示されます。  **プロバイダ**の\[ **ローカルの開発用 STS でアプリケーションをテストします。**は、を **適用**をクリックします。  
+  
+7.  *Default.aspx ファイル* で、既存のマークアップを次に置き換え、ファイルを保存します:  
+  
+    ```  
+    <%@ Page Title="Home Page" Language="C#" MasterPageFile="~/Site.Master" AutoEventWireup="true"  
+        CodeBehind="Default.aspx.cs" Inherits="TestApp._Default" %>  
+  
+    <asp:Content runat="server" ID="BodyContent" ContentPlaceHolderID="MainContent">  
+          <h3>Your Claims</h3>  
+        <p>  
+            <asp:GridView ID="ClaimsGridView" runat="server" CellPadding="3">  
+                <AlternatingRowStyle BackColor="White" />  
+                <HeaderStyle BackColor="#7AC0DA" ForeColor="White" />  
+            </asp:GridView>  
+        </p>  
+    </asp:Content>  
+  
+    ```  
+  
+8.  *Default.aspx.cs*  という名前の分離コード ファイルを開きます。  既存のコードを次に置き換え、ファイルを保存します:  
+  
+    ```csharp  
+    using System;  
+    using System.Web.UI;  
+    using System.Security.Claims;  
+  
+    namespace TestApp  
+    {  
+        public partial class _Default : Page  
+        {  
+            protected void Page_Load(object sender, EventArgs e)  
+            {  
+                ClaimsPrincipal claimsPrincipal = Page.User as ClaimsPrincipal;  
+                this.ClaimsGridView.DataSource = claimsPrincipal.Claims;  
+                this.ClaimsGridView.DataBind();  
+            }  
+        }  
+    }  
+    ```  
+  
+## 手順 2 \- カスタム ClaimsAuthenticationManager を使用して要求の変換を実行します。  
+ この手順で入力されるプリンシパルに管理者ロールを追加するに <xref:System.Security.Claims.ClaimsAuthenticationManager> クラスの既定の機能をオーバーライドします。  
+  
+#### 要求の変換をカスタム ClaimsAuthenticationManager を使用して実行するには  
+  
+1.  Visual Studio で、ソリューションを右クリックし、**追加**をクリックし、を **新しいプロジェクト**をクリックします。  
+  
+2.  **新しいプロジェクトの追加** のペインで、**Visual C\#** テンプレートから選択 **クラス ライブラリ** には、`ClaimsTransformation`を入力し、を **OK**を押します。  新しいプロジェクトがソリューション フォルダーに作成されます。  
+  
+3.  **ClaimsTransformation** のプロジェクトの下の **参照** を右クリックし、を **参照の追加**をクリックします。  
+  
+4.  **参照マネージャー** のペインで、を選択します **System.IdentityModel**は、を **OK**をクリックします。  
+  
+5.  開いている **Class1.cs**、またはをクリック **クラス\]**するには、右クリックします **ClaimsTransformation**を、**追加**をクリックすると、  
+  
+6.  コード ファイルには、ディレクティブを使用して次のように追加します:  
+  
+    ```csharp  
+    using System.Security.Claims;  
+    using System.Security.Principal;  
+    ```  
+  
+7.  コード ファイルに次のクラスとメソッドを追加します。  
+  
+    > [!WARNING]
+    >  次のコードは、デモンストレーションのためだけに作成されています; 製品コードで、目的のアクセス許可を確認してください。  
+  
+    ```csharp  
+    public class ClaimsTransformationModule : ClaimsAuthenticationManager  
+    {  
+        public override ClaimsPrincipal Authenticate(string resourceName, ClaimsPrincipal incomingPrincipal)  
+        {  
+            if (incomingPrincipal != null && incomingPrincipal.Identity.IsAuthenticated == true)  
+            {  
+               ((ClaimsIdentity)incomingPrincipal.Identity).AddClaim(new Claim(ClaimTypes.Role, "Admin"));  
+            }  
+  
+            return incomingPrincipal;  
+        }  
+    }  
+    ```  
+  
+8.  ファイルを保存し、**ClaimsTransformation** プロジェクトをビルドします。  
+  
+9. 参照の **TestApp**、ASP.NET のプロジェクトでは、を右クリックし、を **参照の追加**をクリックします。  
+  
+10. **参照マネージャー** のウィンドウでは、左のメニューから選択 **ソリューション**、データが設定されたオプションから選択 **ClaimsTransformation** は、を **OK**をクリックします。  
+  
+11. ルートの **Web.config** ファイルで、**\<system.identityModel\>** のエントリに移動します。  **\<identityConfiguration\>** の要素内に次の行を追加し、ファイルを保存します:  
+  
+    ```  
+    <claimsAuthenticationManager type="ClaimsTransformation.ClaimsTransformationModule, ClaimsTransformation" />  
+    ```  
+  
+## 手順 3 \- ソリューションをテストします。  
+ この手順では、ASP.NET Web フォーム アプリケーションをテストし、ユーザーがフォーム認証を使用する場合、要求があることを確認します。  
+  
+#### 要求の ASP.NET Web フォーム アプリケーションのフォーム認証を使用してテストするには  
+  
+1.  F5 キーを押してアプリケーションをビルドし、実行します。  *Default.aspx*という必要があります。  
+  
+2.  *Default.aspx ページ* で、**発行者**、**OriginalIssuer**、**種類**、**値**、このアカウントに関する **ValueType** の要求情報含む **アプリケーションで要求** の、見出しの下のテーブルが表示されます。  最後の行には、次の方法で名前を付ける必要があります:  
+  
+    ||||||  
+    |-|-|-|-|-|  
+    |地方自治体|地方自治体|http:\/\/schemas.microsoft.com\/ws\/2008\/06\/identity\/claims\/role|Admin|http:\/\/www.w3.org\/2001\/XMLSchema\#string|
\ No newline at end of file
diff --git a/docs/framework/security/identity-and-access-tool-for-vs.md b/docs/framework/security/identity-and-access-tool-for-vs.md
new file mode 100644
index 00000000000..9305e2e10cc
--- /dev/null
+++ b/docs/framework/security/identity-and-access-tool-for-vs.md
@@ -0,0 +1,36 @@
+---
+title: "Identity and Access Tool for Visual Studio 2012 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 87b8f8f2-4074-44fd-9fd6-08278e877390
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# Identity and Access Tool for Visual Studio 2012
+このトピックでは、新しい Identity and Access Tool for Visual Studio 11 について説明します。  このツールは [http:\/\/go.microsoft.com\/fwlink\/?LinkID\=245849](http://go.microsoft.com/fwlink/?LinkID=245849) からダウンロードできます。また、拡張機能マネージャーで直接 "ID" を検索して、Visual Studio 11 から直接ダウンロードすることもできます。  
+  
+ Identity and Access Tool for Visual Studio 11 の特長を次に示します。これにより、開発時の操作性が大幅に簡素化されます。  
+  
+-   新しいツールを使用すると、Web アプリケーション プロジェクトの種類およびターゲット IIS Express を使用して開発できます。  
+  
+-   ブランケット保護のみの認証とは異なり、新しいツールによって、ローカルのホーム レルム探索ページ\/コントローラー \(または、アプリケーション内で認証によって実行されるその他のエンドポイント処理\) を指定できます。WIF は要求の構成を変更して、認証されていないすべての要求が、STS ではなくその場所にリダイレクトされるようにします。  
+  
+-   ツールには、テスト セキュリティ トークン サービス \(STS\) が含まれています。この STS は、デバッグ セッションの起動時にローカル コンピューターで実行されます。  したがって、アプリケーションのテストに必要なクレームを取得する目的で、カスタム STS プロジェクトを作成して調整する必要はありません。  クレームの種類と値は完全にカスタマイズできます。  
+  
+-   ツールの UI を使用して共通の設定を直接変更できます。web.config を編集する必要はありません。  
+  
+-   Active Directory フェデレーション サービス \(AD FS\) 2.0 \(または、他の WS\-Federation プロバイダー\) を使用して、1 つの画面でフェデレーションを確立できます。  
+  
+-   ツールでは Microsoft Azure のアクセス制御サービス \(ACS\) の機能を使用できます。この機能には、使用するすべての ID プロバイダー \(Facebook、Google、Live ID、Yahoo\! などの OpenID プロバイダー、および WS\-Federation プロバイダー\) のチェック ボックスが用意されています。  ID プロバイダーのチェック ボックスをオンにして、\[OK\] をクリックし、F5 キーを押すと、アプリケーションと ACS の両方が自動的に構成され、テスト アプリケーションが ACS 対応になります。  
+  
+## 参照  
+ [WIF の機能](../../../docs/framework/security/wif-features.md)
\ No newline at end of file
diff --git a/docs/framework/security/json-web-token-handler-api-reference.md b/docs/framework/security/json-web-token-handler-api-reference.md
new file mode 100644
index 00000000000..519d607716d
--- /dev/null
+++ b/docs/framework/security/json-web-token-handler-api-reference.md
@@ -0,0 +1,19 @@
+---
+title: "JSON Web トークン ハンドラー API リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9c4b4acf-7442-4895-993c-0fa89b2a45d1
+caps.latest.revision: 2
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# JSON Web トークン ハンドラー API リファレンス
+このセクションでは、WIF の JSON Web Token Handler 拡張機能の API リファレンスを提供します。
\ No newline at end of file
diff --git a/docs/framework/security/json-web-token-handler.md b/docs/framework/security/json-web-token-handler.md
new file mode 100644
index 00000000000..7e4abce9c9d
--- /dev/null
+++ b/docs/framework/security/json-web-token-handler.md
@@ -0,0 +1,35 @@
+---
+title: "JSON Web トークン ハンドラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9968f12e-e05d-4e6a-9b65-6896c0e31ab1
+caps.latest.revision: 5
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# JSON Web トークン ハンドラー
+Windows Identity Foundation の JSON Web トークン ハンドラー拡張機能を使用すると、アプリケーションで JSON Web トークン \(JWT\) を作成して検証できます。  JWT トークン ハンドラーは、他の組み込みセキュリティ トークン ハンドラーのような WIF パイプラインで実行されるように構成できますが、別個に使用して軽量のアプリケーションでトークン検証を実行することもできます。  Microsoft Azure Active Directory での認証など、OAuth 2.0 ベアラー トークン スキームを使用している場合は、JWT トークン ハンドラーが特に役立ちます。  
+  
+ JWT トークン ハンドラーは、NuGet パッケージとして入手できます。  詳細については、「[JSON Web トークン ハンドラー パッケージのダウンロード](../../../docs/framework/security/downloading-the-json-web-token-handler-package.md)」を参照してください。  
+  
+## シナリオ  
+ JWT トークン ハンドラーにより、次の主要なシナリオが可能になります。  
+  
+-   **サーバー アプリケーションで JWT トークンを検証する**: このシナリオでは、Litware という会社が、WIF を使用して Web サインオン要求を処理するサーバー アプリケーションを保有しています。  Litware は、アプリケーションが認証に JWT トークンを使用できるようにしたいと思っています。  このアプリケーションが JWT トークン ハンドラーで更新された後、アプリケーション構成が更新されて、WIF パイプラインに JWT トークン ハンドラーが追加されます。  更新が行われてから新しい要求が WIF パイプラインに入ると、新しいハンドラーを使用して JWT トークンが検証され、正常な認証が行われます。  
+  
+-   **REST Web サービスで JWT トークンを検証する**: このシナリオでは、Litware という会社が、Microsoft Azure Active Directory で保護された REST Web サービスを利用しています。  Web サービスへの要求は、正常な認証時 JWT トークンを発行する Microsoft Azure AD により認証する必要があります。  Litware には、Web サービスへのアクセスが必要なクライアント アプリケーションがあります。  このクライアントが Web サービスに要求を行い、Microsoft Azure AD から取得した JWT トークンを提示した後、Web サービスにより JWT トークン ハンドラーを使用してトークンが検証されます。  JWT トークン ハンドラーがトークンを検証した後、Web サービスによって目的のリソースがクライアントに返されます。  
+  
+## 機能  
+ JWT トークン ハンドラーには、次の機能が備わっています。  
+  
+-   **JWT トークンを検証する**: JWT トークンは、アプリケーションの WIF パイプラインの一部として、または WIF とは別個に呼び出されたトークン ハンドラーの検証ロジックにより簡単に検証できます。  
+  
+-   **JWT トークンを作成する**: JWT トークン ハンドラーを使用すると、下位サービスの承認用に JWT トークンを作成できます。
\ No newline at end of file
diff --git a/docs/framework/security/media/conc-relying-partner-processc.png b/docs/framework/security/media/conc-relying-partner-processc.png
new file mode 100644
index 00000000000..e1c27b0720b
Binary files /dev/null and b/docs/framework/security/media/conc-relying-partner-processc.png differ
diff --git a/docs/framework/security/media/wifclaimsprogrammingmodel.png b/docs/framework/security/media/wifclaimsprogrammingmodel.png
new file mode 100644
index 00000000000..a9ed3058137
Binary files /dev/null and b/docs/framework/security/media/wifclaimsprogrammingmodel.png differ
diff --git a/docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md b/docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md
new file mode 100644
index 00000000000..657ddaaa058
--- /dev/null
+++ b/docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md
@@ -0,0 +1,55 @@
+---
+title: "WIF 3.5 と WIF 4.5 間での名前空間マッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a092d98c-444d-4336-a644-63c2e11e96c8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# WIF 3.5 と WIF 4.5 間での名前空間マッピング
+.NET 4.5 以降では、Windows ID Foundation \(WIF\) は、.NET Framework に完全に統合されています。  この統合には、WIF の名前空間と API サーフェイスの名前変更と連結を生成しました。  このトピックでは、WIF 3.5 の名前空間と WIF 4.5 の名前空間の間の一般的なガイダンスとマッピングを提供します。  を網羅したものではないはなく WIF 4.5 の使い慣れた WIF 3.5 のクラスの場所に関する一般的な情報を検索するか提供します。  WIF WIF 3.5 と 4.5 の違いに関する詳細については、[Windows Identity Foundation 4.5 の新機能](../../../docs/framework/security/whats-new-in-wif.md)を参照してください。  WIF WIF 3.5 ~ 4.5 を使用して作成されたアプリケーションを移行する方法については、[WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)を参照してください。  
+  
+## WIF WIF 3.5 ~ 4.5 の名前空間の割り当て  
+ WIF 3.5 の `Microsoft.IdentityModel` の名前空間の下で収集された WIF のクラスは名前空間間で配布されます: WIF 4.5 の `System.Security.Claims`、`System.ServiceModel.Security`と `System.IdentityModel` の名前空間。  WIF さらに 3.5 の名前空間は WIF 4.5 に統合されているか、完全にドロップします。  
+  
+> [!IMPORTANT]
+>  `System.IdentityModel` に次の名前空間は、WCF クレームベース ID モデルを実装するクラスが含まれています: <xref:System.IdentityModel.Claims?displayProperty=fullName>、<xref:System.IdentityModel.Policy?displayProperty=fullName>と <xref:System.IdentityModel.Selectors?displayProperty=fullName>。  WCF クレームベース ID モデルは WIF に置き換えられました。  WIF に基づいてソリューションをビルドする場合は、この 3 は、名前空間のクラスを使用する必要があります。  
+  
+ 次の表は、に関する WIF 3.5 のクラスが WIF 4.5 である、情報を示します。  
+  
+||||  
+|-|-|-|  
+|**WIF 3.5 の名前空間**|**WIF 4.5 の名前空間**|**コメント**|  
+|`Microsoft.IdentityModel`|<xref:System.IdentityModel?displayProperty=fullName>|-   定数を表すクラスのほとんどは実行されません。<br />-   セキュリティ トークン サービスのビルドに使用されるクラスは `Microsoft.IdentityModel.SecurityTokenService` から <xref:System.IdentityModel?displayProperty=fullName>に移動されています。<br />-   `Microsoft.IdentityModel.Threading` のクラスは <xref:System.IdentityModel?displayProperty=fullName>に移動されました。<br />-   `ExceptionMapper` と `MruSecurityTokenCache` のクラスは実行されません。|  
+|`Microsoft.IdentityModel.Claims`|<xref:System.Security.Claims?displayProperty=fullName>|-   `IClaimsPrincipal` と `IClaimsIdentity` のインターフェイスは WIF 4.5 では実装されません。  代わりに、現在は <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName> と <xref:System.Security.Claims.ClaimsIdentity?displayProperty=fullName> は、ほとんどの .NET プリンシパル オブジェクトと ID のクラスの派生元となる基本クラスです。  これは、特殊な要求プリンシパルおよび WIF 4.5、使用中 <xref:System.Security.Principal.WindowsPrincipal?displayProperty=fullName> と <xref:System.Security.Principal.WindowsIdentity?displayProperty=fullName> の `Microsoft.IdentityModel.Claims.WindowsClaimsPrincipal` と `Microsoft.IdentityModel.Claims.WindowsClaimsIdentity` などの ID クラスの代わりに必要ないことを意味します。  同じ WIF には 3.5 の ID クラスなどの特殊な要求プリンシパルの他にも当てはまります。<br />-   `Microsoft.IdentityModel.Claims.ClaimsCollection` のクラスは WIF 4.5 では実装されません。  代わりに、要求のコレクションは型 <xref:System.Security.Claims.Claim?displayProperty=fullName>の列挙可能なコレクションとして公開されます。<br />-   <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName> と <xref:System.Security.Claims.ClaimsIdentity?displayProperty=fullName> は、完全に LINQ をサポートするメソッドを提供します。|  
+|`Microsoft.IdentityModel.Configuration`|<xref:System.IdentityModel.Configuration?displayProperty=fullName>|ある要素とクラスは、変更が行われます。このとき、ユーザーは WIF 4.5 にドロップ; これで、たとえば `Microsoft.IdentityModel.Configuraiton.ServiceConfiguration` は <xref:System.IdentityModel.Configuration.IdentityConfiguration?displayProperty=fullName>です。|  
+|`Microsoft.IdentityModel.Protocols`|<xref:System.IdentityModel.Services?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Protocols.WSFederation`|<xref:System.IdentityModel.Services?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Protocols.WSFederation.Metadata`|<xref:System.IdentityModel.Metadata?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Protocols.WSIdentity`|WIF 4.5 に実装されていません|WIF 3.5 ではクラスを WIF 4.5 で実行されなかった場合、CardSpace をサポートするために含まれています。|  
+|`Microsoft.IdentityModel.Protocols.WSTrust`|<xref:System.ServiceModel.Security?displayProperty=fullName> の <xref:System.IdentityModel.Protocols.WSTrust?displayProperty=fullName> と名前空間の間のされました。|クラスは <xref:System.IdentityModel.Protocols.WSTrust?displayProperty=fullName> の名前空間に WS\-Trust 項目を表す;あります。たとえば、<xref:System.IdentityModel.Protocols.WSTrust.RequestSecurityToken> のクラス。  WS\-Trust プロトコルを使用して通信するための WCF サービスを有効にする WCF サービス コントラクト、ホスト サービスとチャネルを表すクラスは <xref:System.ServiceModel.Security?displayProperty=fullName> の名前空間に含まれています; たとえば、<xref:System.ServiceModel.Security.WSTrustServiceHost> のクラス。|  
+|`Microsoft.IdentityModel.Protocols.WSTrust.Bindings`|WIF 4.5 に実装されていません|\-|  
+|`Microsoft.IdentityModel.Protocols.XmlEncryption`|WIF 4.5 に実装されていません|WIF 3.5 の XML 暗号化の定数を表す含まれるクラス。  これらの定数は WIF 4.5 では実装されません。|  
+|`Microsoft.IdentityModel.Protocols.XmlSignature`|<xref:System.IdentityModel?displayProperty=fullName>|定数を表すクラスおよび `EnvelopingSignature` のクラスは実行されません。|  
+|`Microsoft.IdentityModel.SecurityTokenService`|<xref:System.IdentityModel?displayProperty=fullName>、<xref:System.IdentityModel.Protocols.WSTrust?displayProperty=fullName>と <xref:System.IdentityModel.Tokens?displayProperty=fullName> の名前空間に分割します。|\-|  
+|`Microsoft.IdentityModel.Threading`|<xref:System.IdentityModel?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Tokens`|<xref:System.IdentityModel.Tokens?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Tokens.Saml11`|<xref:System.IdentityModel.Tokens?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Tokens.Saml2`|<xref:System.IdentityModel.Tokens?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Web`|<xref:System.IdentityModel.Services?displayProperty=fullName>|\-|  
+|`Microsoft.IdentityModel.Web.Configuration`|<xref:System.IdentityModel.Services.Configuration?displayProperty=fullName>|受動的な \(WS\-Federation\) のシナリオに構成を提供するクラスには <xref:System.IdentityModel.Services.Configuration?displayProperty=fullName>主として実行されていました; ただし、これらのクラスには、<xref:System.IdentityModel.Services?displayProperty=fullName>にあります。|  
+|`Microsoft.IdentityModel.Web.Controls`|WIF 4.5 に実装されていません|`Microsoft.IdentityModel.Web.Controls` のクラスは WIF 4.5 に存在しないフェデレーションな受動的な署名のコントロールを実装します。|  
+|`Microsoft.IdentityModel.WindowsTokenService`|WIF 4.5 に実装されていません|\-|  
+  
+## 参照  
+ [Windows Identity Foundation 4.5 の新機能](../../../docs/framework/security/whats-new-in-wif.md)   
+ [WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)
\ No newline at end of file
diff --git a/docs/framework/security/secure-coding-guidelines-for-unmanaged-code.md b/docs/framework/security/secure-coding-guidelines-for-unmanaged-code.md
new file mode 100644
index 00000000000..793c05ecc18
--- /dev/null
+++ b/docs/framework/security/secure-coding-guidelines-for-unmanaged-code.md
@@ -0,0 +1,65 @@
+---
+title: "アンマネージ コードの安全なコーディングのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, アンマネージ コード"
+  - "安全なコーディング, アンマネージ コード"
+  - "セキュリティ [.NET Framework], アンマネージ コード"
+  - "アンマネージ コード, セキュリティ"
+ms.assetid: a8d15139-d368-4c9c-a747-ba757781117c
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# アンマネージ コードの安全なコーディングのガイドライン
+一部のライブラリ コードは、アンマネージ コードを呼び出す必要があります \(たとえば、Win32 などのネイティブ コード API\)。 これは、マネージ コード用のセキュリティの境界の外部に出ることなので、注意が必要です。 セキュリティ的に中立なコードである場合、コードとそのコードを呼び出すコードは、アンマネージ コードのアクセス許可 \(<xref:System.Security.Permissions.SecurityPermissionFlag> フラグを指定した <xref:System.Security.Permissions.SecurityPermission>\) を持つ必要があります。  
+  
+ しかし、呼び出し元がこのような強力なアクセス許可を持つことが不適切な場合もあります。 このようなケースでは、信頼されるコードが、「[ラッパー コードの保護](../../../docs/framework/misc/securing-wrapper-code.md)」で説明したマネージ ラッパーまたはライブラリ コードのように、仲介役になってしまう可能性があります。 基になるアンマネージ コードの機能が総合的に安全な場合は、それを直接公開できます。それ以外の場合は、最初に適切なアクセス許可のチェック \(確認要求: demand\) が必要です。  
+  
+ コードがアンマネージ コードを呼び出すとき、呼び出し元にアンマネージ コードへのアクセス許可を与えたくない場合は、その権限をアサートする必要があります。 アサーションは、フレーム内でのスタック ウォークをブロックします。 このプロセスで、セキュリティ ホールを作らないように注意が必要です。 通常、これは、呼び出し元の適切なアクセス許可を確認要求し、アンマネージ コードを使用して、アクセス許可で認められていることだけを実行し、それ以上のことは実行しないことを意味します。 日付関数の時刻の取得など、いくつかのケースでは、セキュリティ チェックを一切行わずにアンマネージ コードを呼び出し元に直接公開することがあります。 どのようなケースでも、アサートを行うコードはセキュリティ対策を実施することが必要です。  
+  
+ ネイティブ コードへのコード パスを提供するどのようなマネージ コードも、悪意のあるコードのターゲットになる可能性があります。このため、安全に使用できるアンマネージ コードやその使用方法を決めるには、十分な注意が必要です。 一般に、どのアンマネージ コードも、部分的な信頼の呼び出し元に直接公開するべきではありません。 部分的な信頼のコードから呼び出せるアンマネージ コードをライブラリで使用することの安全性を評価するには、主に次の 2 つの点について考慮する必要があります。  
+  
+-   **機能**。 呼び出し元が危険性のある操作を実行できないようにする機能がアンマネージ API によって提供されているかどうかを考慮します。 コード アクセス セキュリティはアクセス許可を使用してリソースへのアクセスを強制するため、API がファイル、ユーザー インターフェイス、またはスレッドを使用するかどうか、あるいは、保護されている情報を公開するかどうかを考慮します。 API がこれを行うときは、それをラップするマネージ コードが、実行前に必要なアクセス許可を確認要求する必要があります。 また、アクセス許可で保護されていない場合は、メモリへのアクセスを厳密なタイプ セーフに制限する必要があります。  
+  
+-   **パラメーターのチェック**。 一般的な攻撃は、公開されているアンマネージ コードの API メソッドに予期しないパラメーターを渡し、仕様とは異なる動作をさせようと試みます。 範囲外のインデックス値やオフセット値を使用するバッファー オーバーラン攻撃は、この種の攻撃の一例であり、パラメーターの基のコードのバグを攻略します。 このため、アンマネージ コード API が部分的な信頼の呼び出し元に対して安全に機能している場合でも \(必要な確認要求の後\)、マネージ コードもパラメーターの正当性を二重にチェックし、悪意のあるコードが、マネージ コードのラッパー レイヤーを使用して予期しない呼び出しを行うのを不可能にすることが必要です。  
+  
+## SuppressUnmanagedCodeSecurityAttribute の使用  
+ アサートの後でアンマネージ コードを呼び出すのは、パフォーマンスの面で問題があります。 このような呼び出しのたびに、セキュリティ システムはアンマネージ コードのアクセス許可を自動的に確認要求し、結果として毎回スタック ウォークが発生します。 アサート直後にアンマネージ コードを呼び出すと、スタック ウォークは意味がなくなります。それは、アサートとアンマネージ コードの呼び出しで構成されるからです。  
+  
+ <xref:System.Security.SuppressUnmanagedCodeSecurityAttribute> というカスタム属性をアンマネージ コードのエントリ ポイントに適用して、<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可を指定した <xref:System.Security.Permissions.SecurityPermission> を確認要求する通常のセキュリティ チェックを無効にできます。 このアクションは、実行時のセキュリティ チェックがない状態で、アンマネージ コードに通じるドアを開くことになるため、これを実行するときは大きな注意が必要です。**SuppressUnmanagedCodeSecurityAttribute**  を適用した場合でも、Just\-In\-Time \(JIT\) コンパイル時に 1 回だけセキュリティ チェックが発生し、直前の呼び出し元がアンマネージ コードを呼び出すアクセス許可を持っていることを確認します。  
+  
+ **SuppressUnmanagedCodeSecurityAttribute** を使用する場合は、次の点をチェックしてください。  
+  
+-   アンマネージ コードのエントリ ポイントを内部にするか、またはコード外からはアクセスできないようにします。  
+  
+-   アンマネージ コードを呼び出すと、セキュリティ ホールになる可能性があります。 悪意のあるコードが間接的にアンマネージ コードを呼び出し、セキュリティ チェックを回避するポータルとして、自分のコードが使用されていないことを確認します。 必要な場合は、アクセス許可を確認要求します。  
+  
+-   以下のセクションで説明されているように、アンマネージ コードへの危険なパスを作成するときは、名前付け規則を使用して明示的に識別します。  
+  
+## アンマネージ コード メソッド用の名前付け規則  
+ 有用な名前付け規則がアンマネージ コード メソッド用に確立されているので、使用されることを強くお勧めします。 すべてのアンマネージ コード メソッドは、**safe**、**native**、**unsafe** の 3 つのカテゴリに分類されます。 これらのキーワードは、内部にさまざまな種類のアンマネージ コード エントリ ポイントを定義するクラス名として使用できます。 ソース コードでは、これらのキーワードをクラス名に追加する必要があります。たとえば、`Safe.GetTimeOfDay`、`Native.Xyz`、または `Unsafe.DangerousAPI` のように表記します。 次の表に示すように、各キーワードはそのクラスを使用する開発者に有用なセキュリティ情報を提供します。  
+  
+|キーワード|セキュリティの考慮事項|  
+|-----------|-----------------|  
+|**safe**|任意のコードにとって \(悪意のあるコードにも\)、呼び出すことがまったく安全です。 他のマネージ コードと同じように使用できます。 たとえば、1 日の時刻を取得する関数は典型的に安全です。|  
+|**native**|セキュリティに中立的。つまり、呼び出すためにアンマネージ コードのアクセス許可を必要とするアンマネージ コードです。 セキュリティがチェックされ、承認のない呼び出し元は停止されます。|  
+|**unsafe**|セキュリティが抑止された、危険性のあるアンマネージ コード エントリ ポイントです。 このようなアンマネージ コードを使用するとき、開発者は最大限の注意を払う必要があり、セキュリティ脆弱性を避けるための別の手段の保護機能が設定されていることを確認します。 このキーワードはセキュリティ システムをオーバーライドするため、開発者がセキュリティ対策を行う必要があります。|  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/framework/security/security-changes.md b/docs/framework/security/security-changes.md
new file mode 100644
index 00000000000..b7cadefc9d3
--- /dev/null
+++ b/docs/framework/security/security-changes.md
@@ -0,0 +1,34 @@
+---
+title: ".NET Framework におけるセキュリティの変更点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Allow Partially Trusted Callers Attribute"
+  - ".NET framework 4、セキュリティの変更"
+  - ".NET Framework のセキュリティ"
+  - "セキュリティが透過的なコード"
+  - "セキュリティ クリティカルなコード"
+  - "コード アクセス セキュリティ、変更"
+ms.assetid: 5e87881c-9c13-4b52-8ad1-e34bb46e8aaa
+caps.latest.revision: 52
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# .NET Framework におけるセキュリティの変更点
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] のセキュリティにおける最も重要な変更は、厳密な名前付けの変更です。 これらの変更の詳細については、「[拡張された厳密な名前付け](../../../docs/framework/app-domains/enhanced-strong-naming.md)」を参照してください。  
+  
+ .NET Framework は、マネージ アプリケーションに 2 階層のセキュリティ モデルを提供します。[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリはリソースへのアクセスを制限する Windows セキュリティ コンテナーで実行されます。 そのコンテナー内では、マネージ アプリケーションは完全に信頼された状態で実行します。 コード アクセス セキュリティの \(CAS\) の観点からは、権限を昇格するために開発者が実行できる操作はありません。 Windows で与えられる権限の詳細については、Windows デベロッパー センターの「[App capability declarations \(Windows Store apps\)](http://go.microsoft.com/fwlink/?LinkId=230436)」 \(アプリの機能宣言 \(Windows ストア アプリ\)\) を参照してください。[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリの作成については、「[C\# または Visual Basic を使った初めての Windows ストア アプリの作成](http://go.microsoft.com/fwlink/?LinkId=230461)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/security/validating-issuer-name-registry-api-reference.md b/docs/framework/security/validating-issuer-name-registry-api-reference.md
new file mode 100644
index 00000000000..e5386c471a1
--- /dev/null
+++ b/docs/framework/security/validating-issuer-name-registry-api-reference.md
@@ -0,0 +1,19 @@
+---
+title: "発行者名レジストリ API リファレンスの検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ecb66f6-af65-47e9-93bc-afd1c1575a9a
+caps.latest.revision: 2
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 発行者名レジストリ API リファレンスの検証
+このセクションでは、WIF の Validating Issuer Name Registry 拡張機能の API リファレンスを提供します。
\ No newline at end of file
diff --git a/docs/framework/security/validating-issuer-name-registry.md b/docs/framework/security/validating-issuer-name-registry.md
new file mode 100644
index 00000000000..9f31c8a14a9
--- /dev/null
+++ b/docs/framework/security/validating-issuer-name-registry.md
@@ -0,0 +1,33 @@
+---
+title: "発行者名レジストリの検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4644dd1-dead-48ff-abeb-7bffae69a6ac
+caps.latest.revision: 4
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 発行者名レジストリの検証
+Windows Identity Foundation の Validating Issuer Name Registry \(VINR\) 拡張機能を使用すると、受信トークンが信頼できるテナントおよび ID プロバイダーから発行されたことをマルチテナント アプリケーションが確認できます。  Microsoft Azure AD によって発行されるすべてのトークンは同じ証明書を使用して署名されているため、この機能は Microsoft Azure Active Directory を使用するマルチテナント アプリケーションに特に役立ちます。  同じ証明書を使用する \(つまり、母音が同じ\) 複数のテナントからの要求を区別するため、アプリケーションはテナントごとに発行者名を維持して検証ロジックを実行する必要があります。  VINR にはこの機能が備わっており、カスタム検証ロジックを追加したり、構成ファイル以外の場所に発行者のレジストリ データを格納したりすることができます。  この拡張機能は、アプリケーションの WIF パイプラインに追加したり、別個に使用することができます。  
+  
+ VINR は NuGet パッケージとして入手できます。  詳細については、「[発行者名レジストリの検証パッケージのダウンロード](../../../docs/framework/security/downloading-the-validating-issuer-name-registry-package.md)」を参照してください。  
+  
+## シナリオ  
+ VINR により、次の主要なシナリオが可能になります。  
+  
+-   **マルチテナント アプリケーションのトークンを検証する**: このシナリオでは、Litware という会社が Microsoft Azure AD として ID プロバイダーを使用するマルチテナント アプリケーションを開発しました。  このアプリケーションは、2 つの顧客 \(Contoso および Fabrikam\) にサービスを提供しています。  Fabrikam のユーザーが Litware のアプリケーションで認証を行うと、Microsoft Azure AD から生成されるトークンは標準の証明書を使用して署名され、要求は Fabrikam により発行されます。  アプリケーションは発行者名とトークンの両方が有効であることを検証し、Microsoft Azure AD の同じ証明書を使用して署名された Contoso からの要求を区別する必要があります。  VINR を使用すると、Litware アプリケーションが Contoso や Fabrikam などのマルチテナントからの要求を簡単に区別できるようになります。  
+  
+## 機能  
+ VINR には次の機能があります。  
+  
+-   **マルチテナント アプリケーションの発行者名とトークンの検証**: 発行者名 \(テナント\) と、トークンが ID プロバイダーの有効な証明書を使用して署名されたかどうかを確認することで、受信トークンを検証します。  
+  
+-   **カスタム検証ロジックとデータ ストアの機能拡張**: 独自の検証ロジックを挿入し、既定の構成ファイル以外のデータ ストアを指定するための機能拡張を提供します。
\ No newline at end of file
diff --git a/docs/framework/security/whats-new-in-wif.md b/docs/framework/security/whats-new-in-wif.md
new file mode 100644
index 00000000000..233ce16b885
--- /dev/null
+++ b/docs/framework/security/whats-new-in-wif.md
@@ -0,0 +1,68 @@
+---
+title: "Windows Identity Foundation 4.5 の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b381f04-593b-471f-bd33-0362be1aade5
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# Windows Identity Foundation 4.5 の新機能
+Windows Identity Foundation \(WIF\) の最初のバージョンは、スタンドアロンのダウンロードとして提供され、.NET 3.5 SP1 タイム フレームで導入されたため、WIF 3.5 と呼ばれています。  .NET 4.5 以降、WIF は .NET Framework の一部になっています。  .NET Framework 自体で直接 WIF クラスを使用できるようになったため、.NET プラットフォームでクレーム ベースの ID をより深く統合できるようになり、クレームを簡単に使用できるようになりました。  WIF 3.5 用に作成されたアプリケーションは、新しいモデルを利用するために、変更する必要があります。詳細については、「[WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)」を参照してください。  
+  
+ 主な変更点は、以下のとおりです。  
+  
+## WIF の .NET Framework への組み込み  
+ WIF クラスは、複数のアセンブリに分散されています。主なものは、`mscorlib`、`System.IdentityModel`、`System.IdentityModel.Services`、および `System.ServiceModel` です。  同様に、WIF クラスは、複数の名前空間 \(<xref:System.Security.Claims?displayProperty=fullName>、複数の[System.IdentityModel](http://go.microsoft.com/fwlink/?LinkId=272004) 名前空間、および <xref:System.ServiceModel.Security?displayProperty=fullName>\) に分散されています。  <xref:System.Security.Claims?displayProperty=fullName> 名前空間には、新しい <xref:System.Security.Claims.ClaimsPrincipal> クラスと <xref:System.Security.Claims.ClaimsIdentity> クラスが含まれています \(以下を参照\)。  .NET のすべての原則は、<xref:System.Security.Claims.ClaimsPrincipal> から派生しています。  WIF の名前空間およびそれに含まれるクラスの種類の詳細については、「[WIF API リファレンス](../../../docs/framework/security/wif-api-reference.md)」を参照してください。  WIF 3.5 と WIF 4.5 間の名前空間のマッピング方法の詳細については、「[WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)」を参照してください。  
+  
+## 新しいクレームのモデルとプリンシパル オブジェクト  
+ クレームは、.NET Framework 4.5 の中核にあります。基本クレーム クラス \(<xref:System.Security.Claims.Claim>、<xref:System.Security.Claims.ClaimsIdentity>、<xref:System.Security.Claims.ClaimsPrincipal>、<xref:System.Security.Claims.ClaimTypes>および <xref:System.Security.Claims.ClaimValueTypes>\) はすべて、<xref:System.Security.Claims?displayProperty=fullName> 名前空間の `mscorlib` 直下に存在しています。  インターフェイスを使用しなくても、.NET の ID システムにクレームを入力できるようになりました。<xref:System.Security.Principal.WindowsPrincipal>、<xref:System.Security.Principal.GenericPrincipal>、および <xref:System.Web.Security.RolePrincipal> は、<xref:System.Security.Claims.ClaimsPrincipal> から継承されるようになりました。また、<xref:System.Security.Principal.WindowsIdentity>、<xref:System.Security.Principal.GenericIdentity>、および <xref:System.Web.Security.FormsIdentity> は、<xref:System.Security.Claims.ClaimsIdentity> から継承されるようになりました。  つまり、主要なクラスはすべて、クレームに対応しています。  WIF 3.5 の統合クラスとインターフェイス \(`WindowsClaimsIdentity`、`WindowsClaimsPrincipal`、`IClaimsPrincipal`、および `IClaimsIdentity`\) は削除されました。  また、<xref:System.Security.Claims.ClaimsIdentity> クラスはメソッドを公開しているため、その ID のクレームのコレクションを照会しやすくなっています。  
+  
+## WIF 4.5 の Visual Studio の機能の変更点  
+  
+-   **\[STS 参照の追加\]** という Visual Studio の機能 \(cmdline ユーティリティの FedUtil\) は既に存在しません。代わりに、新しい Visual Studio の拡張機能 **Identity and Access Tool for Visual Studio 2012** を使用できるようになっています。  これにより、既存の STS を使用してフェデレーションを行うか、LocalSTS を使用して、ソリューションをテストできるようになりました。  拡張機能をインストールした後で、プロジェクトを右クリックし、コンテキスト メニューで **\[Identity and Access\]** を探してください。  
+  
+-   ASP.NET、Web サイト、および WCF の既存のプロジェクト テンプレートでクレームを直接使用できるようになったため、ASP.NET および STS のテンプレートは現在提供されていません。  
+  
+-   `Microsoft.IdentityModel.Web.Controls` 名前空間 \(`SignInControl`、`FederatedPassiveSignInControl`、および `FederatedPassiveSignInStatus`\) のコントロールは、WIF 4.5 に引き継がれません。  
+  
+## WIF 4.5 API の変更点  
+  
+-   一般的に、クレーム関連クラスは <xref:System.Security.Claims?displayProperty=fullName> 名前空間にあります。WCF 関連クラス \(WS\-Trust シナリオに使用されるサービス コントラクト、チャネル、チャネル ファクトリ、およびサービス ホスト\) は <xref:System.ServiceModel.Security?displayProperty=fullName> にあります。また、他のすべての WIF クラスは、さまざまな [System.IdentityModel](http://go.microsoft.com/fwlink/?LinkId=272004) 名前空間 \(たとえば、WS\-\* および SAML 成果物を表すクラス、トークン ハンドラーおよび関連クラス、WS フェデレーション シナリオで使用されるクラスなど\) に分散されています。  詳細については、「[WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)」および「[WIF API リファレンス](../../../docs/framework/security/wif-api-reference.md)」を参照してください。  
+  
+-   マシン キーは、Web ファームのシナリオのセッション クッキーで使用できるように有効化されています。  詳細については、「[WIF および Web ファーム](../../../docs/framework/security/wif-and-web-farms.md)」を参照してください。  
+  
+-   [\<system.identityModel\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md) および [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md) 要素の下で、宣言によって WIF を構成できます。  WIF 構成の詳細については、「[WIF 構成のリファレンス](../../../docs/framework/security/wif-configuration-reference.md)」を参照してください。  
+  
+## .NET に WIF を統合したことによるその他の主な .NET の変更点および機能  
+  
+-   クレーム ベースの承認 \(CBAC\) を実行する潜在力が、.NET Framework に不可欠になりました。  <xref:System.Security.Claims.ClaimsAuthorizationManager> オブジェクトを構成し、<xref:System.IdentityModel.Services.ClaimsPrincipalPermission> クラスおよび <xref:System.IdentityModel.Services.ClaimsPrincipalPermissionAttribute> クラスを使用して、強制アクセス チェックおよび宣言アクセス チェックをコードで実行できます。  CBAC は、従来のロール ベース アクセス チェック \(RBAC\) より柔軟かつ詳細です。  また、ビジネス ロジックは特定のクレームまたはクレーム セットおよび承認ポリシーに基づいてアクセス チェックを実行でき、これらのクレームは宣言によって [\<claimsAuthorizationManager\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/claimsauthorizationmanager.md) 要素の下で構成できることから、承認ポリシーとビジネス ロジックの分離が向上しています。  
+  
+## WIF 統合の結果としての WCF の変更点:  
+  
+-   WCF クレーム ベース ID モデルは WIF に置き換えられています。  これは、WIF クラスの使用を優先し、<xref:System.IdentityModel.Claims?displayProperty=fullName>、<xref:System.IdentityModel.Policy?displayProperty=fullName>、および <xref:System.IdentityModel.Selectors?displayProperty=fullName> 名前空間のクラスは削除する必要があることを意味します。  
+  
+-   次の XML に示すように `<system.serviceModel>`\/`<behaviors>`\/`<serviceBehaviors>`\/`<serviceCredentials>` 要素で `useIdentityConfiguration` 属性が指定され、WCF サービス上で WIF が有効になりました。  
+  
+    ```xml  
+    <serviceCredentials useIdentityConfiguration="true">  
+        <!--Certificate added by Identity And Access VS Package.  Subject='CN=localhost', Issuer='CN=localhost'. Make sure you have this certificate installed. The Identity and Access tool does not install this certificate.-->  
+        <serviceCertificate findValue="CN=localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectDistinguishedName" />  
+    </serviceCredentials>  
+    ```  
+  
+     **Identity and Access Tool for Visual Studio 2012** \(前の「**Visual Studio の機能の変更点**」を参照\) を使用する場合、`useIdentityConfiguration` 属性が構成ファイルに設定された `<serviceCredentials>` 要素が追加されます。  また、WIF 構成設定が含まれ、対応する [\<system.identityModel\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md) 要素も追加されます。選択した STS に認証を外部委託するために必要なバインディングやその他の設定も追加されます。  
+  
+## 参照  
+ [WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)   
+ [WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)   
+ [WIF API リファレンス](../../../docs/framework/security/wif-api-reference.md)   
+ [WIF 構成のリファレンス](../../../docs/framework/security/wif-configuration-reference.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-and-web-farms.md b/docs/framework/security/wif-and-web-farms.md
new file mode 100644
index 00000000000..b748cd148e6
--- /dev/null
+++ b/docs/framework/security/wif-and-web-farms.md
@@ -0,0 +1,262 @@
+---
+title: "WIF および Web ファーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc3cd7fa-2b45-4614-a44f-8fa9b9d15284
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# WIF および Web ファーム
+たんだ Windows アイデンティティ基盤 \(ぜ\) を使用して、web ファームでの展開は、依存元のパーティ \(RP\) アプリケーションのリソースをセキュリティで保護する場合は、たんだぜトークン、ファーム内の別のコンピューター上で実行して、RP アプリケーションのインスタンスからを処理できることを確認するのには、特定の手順を実行する必要があります。  暗号化セッション トークンの署名を検証します。 この処理を含むし、セッション トークンを復号化するには、セッション トークンをキャッシュおよび検出、セキュリティ トークンを再生します。  
+  
+ 一般的なケースでは、RP が 1 台のコンピューター上または web ファーム： を実行しているかどうかたんだぜ RP アプリケーションのリソースをセキュリティで保護するために使用されている場合、セキュリティ トークン サービス \(STS\) から取得したセキュリティ トークンに基づいて、クライアントをセッションが確立されます。  これは、たんだぜを使用してセキュリティ保護されているすべてのアプリケーション リソースの STS で認証するために、クライアントを強制的を避けるためです。  たんだぜセッションを処理する方法の詳細についてを参照してください[WIF セッション管理](../../../docs/framework/security/wif-session-management.md)。  
+  
+ 既定の設定を使用すると、たんだぜは、次を行います。  
+  
+-   インスタンスを使用して、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler> 、セッション トークンを読み書きするためのクラス \(インスタンスの<xref:System.IdentityModel.Tokens.SessionSecurityToken>クラス\) 請求」、および「セッション自体に関する情報だけでなく、その他情報認証に使用されたセキュリティ トークンを実行します。  セッション トークンはパッケージ化されをセッション cookie に格納されます。  既定では、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>を使用して、 <xref:System.IdentityModel.ProtectedDataCookieTransform>クラスでは、データ保護 API \(DPAPI\) を使用して、セッション トークンを保護するために。  DPAPI は、ユーザーまたはコンピューターの資格情報を使用して、保護を提供し、ユーザーのプロファイルにキーのデータを格納します。  
+  
+-   それを使用して、既定のメモリ内の実装の<xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>を格納し、セッション トークンを処理するクラス。  
+  
+ これらの既定の設定は、RP のアプリケーションを 1 台のコンピューターに展開するシナリオで機能します。 ただし、web ファームに展開すると、各 HTTP 要求は送信して RP アプリケーションを別のコンピューター上で実行中の別のインスタンスによって処理されます。  トークン保護およびトークンのキャッシュは、特定のコンピューターに依存しているためこのシナリオでは、上記で説明した既定のたんだぜ設定は行われません。  
+  
+ RP アプリケーションが web ファームに展開するには、セッション トークン \(およびその再生されたトークン\) の処理は、特定のコンピューターで実行されているアプリケーションに依存である必要があります。  これを行うには、1 つの方法は、ASP で提供される機能を使用するように、RP アプリケーションを実装するためにです。NET `<machineKey>`の構成要素と分散セッション トークンを処理するためのキャッシュを提供し、トークンを再生します。  `<machineKey>`要素を使用すると、検証、暗号化、および構成ファイルは、web ファーム内の別のコンピューターに同じキーを指定することができます内のトークンを復号化に必要なキーを指定します。  たんだぜ、特殊なセッション トークン ハンドラーが用意されています、 <xref:System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler>、保護は、トークンと指定されたキーを使用して、 `<machineKey>`要素。  この方法を実装するには、次のガイドラインを実行します。  
+  
+-   ASP を使用します。NET `<machineKey>`では、ファーム内のコンピューター間で使用できるデジタル署名と暗号化のキーを明示的に指定する構成要素。  次の XML の仕様を示しています、 `<machineKey>`要素の下、 `<system.web>`は、構成ファイル内の要素。  
+  
+    ```xml  
+    <machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />  
+    ```  
+  
+-   使用するアプリケーションを構成する、 <xref:System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler> 、トークン ハンドラー コレクションに追加します。  最初に削除する必要があります、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler> \(またはいずれかのハンドラーから派生、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>クラス\) このようなハンドラーが存在する場合、トークン ハンドラーのコレクションから。  <xref:System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler>を使用して、 <xref:System.IdentityModel.Services.MachineKeyTransform>クラスでは、指定された暗号の材料を使用して、セッションの cookie データを保護、 `<machineKey>`要素。  次の XML を追加する方法を示しています、 <xref:System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler> 、トークン ハンドラーのコレクション。  
+  
+    ```xml  
+    <securityTokenHandlers>  
+      <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+      <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+    </securityTokenHandlers>  
+    ```  
+  
+-   派生<xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>と実装は分散、RP 可能性があります実行、ファーム内のすべてのコンピューターからアクセス可能なキャッシュのキャッシュします。  分散キャッシュを使用するのには、RP の構成、 [\<sessionSecurityTokenCache\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md) 、構成ファイル内の要素。  オーバーライドできる、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenCache.LoadCustomConfiguration%2A?displayProperty=fullName>の子要素を実装するために、派生クラスのメソッド、 `<sessionSecurityTokenCache>`必要がある場合、要素。  
+  
+    ```xml  
+    <caches>  
+      <sessionSecurityTokenCache type="MyCacheLibrary.MySharedSessionSecurityTokenCache, MyCacheLibrary">  
+        <!—optional child configuration elements, if implemented by the derived class -->  
+      </sessionSecurityTokenCache>  
+    </caches>  
+    ```  
+  
+     分散キャッシュを実装する方法の 1 つは、独自のキャッシュに、WCF のフロント エンドを提供するためにです。  サービス キャッシュを WCF 実装の詳細についてを参照してください[WCF サービスのキャッシュ](#BKMK_TheWCFCachingService)。  RP アプリケーション キャッシュ サービスを呼び出すために使用できる WCF クライアントを実装する場合の詳細についてを参照してください[WCF クライアントのキャッシュ](#BKMK_TheWCFClient)。  
+  
+-   アプリケーションに再生されたトークンが検出された場合は、ような分散から派生することによって戦略の再実行のトークン キャッシュのキャッシュに必要<xref:System.IdentityModel.Tokens.TokenReplayCache>と、トークンにポイントを再生キャッシュ サービスで、 [\<tokenReplayCache\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/tokenreplaycache.md)の構成要素。  
+  
+> [!IMPORTANT]
+>  すべての XML の例では、このトピックのコードから取得、 [ClaimsAwareWebFarm](http://go.microsoft.com/fwlink/?LinkID=248408) \(記事 160324LinkID 248408 \=\) サンプル。  
+  
+> [!IMPORTANT]
+>  このトピックの例として提供されています\- あり、製品コードを変更せずに使用するものではありません。  
+  
+<a name="BKMK_TheWCFCachingService"></a>   
+## WCF サービスのキャッシュ  
+ 次のインターフェイスは、依存元のサードパーティ製アプリケーションが通信に使用する WCF クライアント ～ WCF キャッシング サービスのコントラクトを定義します。  本質的に、メソッドの公開、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>クラスは、サービス操作します。  
+  
+```  
+[ServiceContract()]  
+public interface ISessionSecurityTokenCacheService  
+{  
+    [OperationContract]  
+    void AddOrUpdate(string endpointId, string contextId, string keyGeneration, SessionSecurityToken value, DateTime expiryTime);  
+  
+    [OperationContract]  
+    IEnumerable<SessionSecurityToken> GetAll(string endpointId, string contextId);  
+  
+    [OperationContract]  
+    SessionSecurityToken Get(string endpointId, string contextId, string keyGeneration);  
+  
+    [OperationContract(Name = "RemoveAll")]  
+    void RemoveAll(string endpointId, string contextId);  
+  
+    [OperationContract(Name = "RemoveAllByEndpointId")]  
+    void RemoveAll(string endpointId);  
+  
+    [OperationContract]  
+    void Remove(string endpointId, string contextId, string keyGeneration);  
+}  
+```  
+  
+ 次のコードでは、サービスのキャッシュの WCF の実装を示しています。  この例では、既定では、メモリ内セッション トークンのキャッシュたんだぜでの実装が使用されます。  また、データベースでのバックアップ永続キャッシュを実装できます。  `ISessionSecurityTokenCacheService`上記のインターフェイスを定義します。  この例では、すべてのインターフェイスを実装するために必要なメソッドを簡潔にするために表示されます。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.IdentityModel.Configuration;  
+using System.IdentityModel.Tokens;  
+using System.ServiceModel;  
+using System.Xml;  
+  
+namespace WcfSessionSecurityTokenCacheService  
+{  
+    [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]  
+    public class SessionSecurityTokenCacheService : ISessionSecurityTokenCacheService  
+    {  
+        SessionSecurityTokenCache internalCache;  
+  
+        // sets the internal cache used by the service to the default WIF in-memory cache.  
+        public SessionSecurityTokenCacheService()  
+        {  
+            internalCache = new IdentityModelCaches().SessionSecurityTokenCache;  
+        }  
+  
+        ...  
+  
+        public SessionSecurityToken Get(string endpointId, string contextId, string keyGeneration)  
+        {  
+            // Delegates to the default, in-memory MruSessionSecurityTokenCache used by WIF  
+            SessionSecurityToken token = internalCache.Get(new SessionSecurityTokenCacheKey(endpointId, GetContextId(contextId), GetKeyGeneration(keyGeneration)));  
+            return token;  
+        }  
+  
+        ...  
+  
+        private static UniqueId GetContextId(string contextIdString)  
+        {  
+            return contextIdString == null ? null : new UniqueId(contextIdString);  
+        }  
+  
+        private static UniqueId GetKeyGeneration(string keyGenerationString)  
+        {  
+            return keyGenerationString == null ? null : new UniqueId(keyGenerationString);  
+        }  
+    }  
+}  
+```  
+  
+<a name="BKMK_TheWCFClient"></a>   
+## WCF クライアントのキャッシュ  
+ ここから派生したクラスの実装を示しています<xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>され、デリゲート呼び出し、キャッシュ サービスにします。  RP を通じてこのクラスを使用するアプリケーションの構成、 [\<sessionSecurityTokenCache\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/sessionsecuritytokencache.md)で、次の XML 要素  
+  
+```  
+<caches>  
+  <sessionSecurityTokenCache type="CacheLibrary.SharedSessionSecurityTokenCache, CacheLibrary">  
+    <!--cacheServiceAddress points to the centralized session security token cache service running in the web farm.-->  
+    <cacheServiceAddress url="http://localhost:4161/SessionSecurityTokenCacheService.svc" />  
+  </sessionSecurityTokenCache>  
+</caches>  
+```  
+  
+ クラスのオーバーライド、 <xref:System.IdentityModel.Tokens.SessionSecurityTokenCache.LoadCustomConfiguration%2A>からカスタム、サービス エンドポイントを取得する方法`<cacheServiceAddress>`の子要素を`<sessionSecurityTokenCache>`要素。  このエンドポイントを使用して初期化する、 `ISessionSecurityTokenCacheService`ができる通信サービスでのチャネル。  この例では、すべてのメソッドを実装する必要が<xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>簡潔にするためのクラスを表示します。  
+  
+```  
+using System;  
+using System.Configuration;  
+using System.IdentityModel.Configuration;  
+using System.IdentityModel.Tokens;  
+using System.ServiceModel;  
+using System.Xml;  
+  
+namespace CacheLibrary  
+{  
+    /// <summary>  
+    /// This class acts as a proxy to the WcfSessionSecurityTokenCacheService.  
+    /// </summary>  
+    public class SharedSessionSecurityTokenCache : SessionSecurityTokenCache, ICustomIdentityConfiguration  
+    {  
+        private ISessionSecurityTokenCacheService WcfSessionSecurityTokenCacheServiceClient;  
+  
+        internal SharedSessionSecurityTokenCache()  
+        {  
+        }  
+  
+        /// <summary>  
+        /// Creates a client channel to call the service host.  
+        /// </summary>  
+        protected void Initialize(string cacheServiceAddress)  
+        {  
+            if (this.WcfSessionSecurityTokenCacheServiceClient != null)  
+            {  
+                return;  
+            }  
+  
+            ChannelFactory<ISessionSecurityTokenCacheService> cf = new ChannelFactory<ISessionSecurityTokenCacheService>(  
+                new WS2007HttpBinding(SecurityMode.None),  
+                new EndpointAddress(cacheServiceAddress));  
+            this.WcfSessionSecurityTokenCacheServiceClient = cf.CreateChannel();  
+        }  
+  
+        #region SessionSecurityTokenCache Members  
+        // Delegates the following operations to the centralized session security token cache service in the web farm.  
+  
+        ...  
+  
+        public override SessionSecurityToken Get(SessionSecurityTokenCacheKey key)  
+        {  
+            return this.WcfSessionSecurityTokenCacheServiceClient.Get(key.EndpointId, GetContextIdString(key), GetKeyGenerationString(key));  
+        }  
+  
+        ...  
+  
+        #endregion  
+  
+        #region ICustomIdentityConfiguration Members  
+        // Called from configuration infrastructure to load custom elements  
+        public void LoadCustomConfiguration(XmlNodeList nodeList)  
+        {  
+            // Retrieve the endpoint address of the centralized session security token cache service running in the web farm  
+            if (nodeList.Count == 0)  
+            {  
+                throw new ConfigurationException("No child config element found under <sessionSecurityTokenCache>.");  
+            }  
+  
+            XmlElement cacheServiceAddressElement = nodeList.Item(0) as XmlElement;  
+            if (cacheServiceAddressElement.LocalName != "cacheServiceAddress")  
+            {  
+                throw new ConfigurationException("First child config element under <sessionSecurityTokenCache> is expected to be <cacheServiceAddress>.");  
+            }  
+  
+            string cacheServiceAddress = null;  
+            if (cacheServiceAddressElement.Attributes["url"] != null)  
+            {  
+                cacheServiceAddress = cacheServiceAddressElement.Attributes["url"].Value;  
+            }  
+            else  
+            {  
+                throw new ConfigurationException("<cacheServiceAddress> is expected to contain a 'url' attribute.");  
+            }  
+  
+            // Initialize the proxy to the WebFarmSessionSecurityTokenCacheService  
+            this.Initialize(cacheServiceAddress);  
+        }  
+        #endregion  
+  
+        private static string GetKeyGenerationString(SessionSecurityTokenCacheKey key)  
+        {  
+            return key.KeyGeneration == null ? null : key.KeyGeneration.ToString();  
+        }  
+  
+        private static string GetContextIdString(SessionSecurityTokenCacheKey key)  
+        {  
+            return GetContextIdString(key.ContextId);  
+        }  
+  
+        private static string GetContextIdString(UniqueId contextId)  
+        {  
+            return contextId == null ? null : contextId.ToString();  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SessionSecurityTokenCache>   
+ <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler>   
+ <xref:System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler>   
+ [WIF セッション管理](../../../docs/framework/security/wif-session-management.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-api-reference.md b/docs/framework/security/wif-api-reference.md
new file mode 100644
index 00000000000..2e22e1acebe
--- /dev/null
+++ b/docs/framework/security/wif-api-reference.md
@@ -0,0 +1,56 @@
+---
+title: "WIF API リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a027d902-9314-4bfd-b172-4e81847b1d68
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# WIF API リファレンス
+Windows Identity Foundation \(WIF\) classes are split across the following assemblies: `mscorlib` \(mscorlib.dll\), `System.IdentityModel` \(System.IdentityModel.dll\), `System.IdentityModel.Services` \(System.IdentityModel.Services.dll\), and `System.ServiceModel` \(System.ServiceModel.dll\).  This topic provides links to the WIF namespaces and brief explanations of the classes that each namespace contains.  
+  
+> [!IMPORTANT]
+>  The following `System.IdentityModel` namespaces contain classes that implement the WCF claims\-based identity model: <xref:System.IdentityModel.Claims?displayProperty=fullName>, <xref:System.IdentityModel.Policy?displayProperty=fullName>, and <xref:System.IdentityModel.Selectors?displayProperty=fullName>.  Starting with .NET Framework 4.5, the WCF claims\-based identity model is superseded by WIF.  You should not use classes in these three namespaces when building solutions based on WIF.  
+  
+ <xref:System.IdentityModel?displayProperty=fullName>  
+ Contains classes that represent cookie transforms, security token services, and specialized XML dictionary readers.  
+  
+ <xref:System.IdentityModel.Configuration?displayProperty=fullName>  
+ Contains classes that provide configuration for applications and services built using the Windows Identity Foundation \(WIF\).  この名前空間のクラスは [\<identityConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md) の要素下の設定を表します。  
+  
+ <xref:System.IdentityModel.Metadata?displayProperty=fullName>  
+ Contains classes that represent elements in a Federation Metadata document.  
+  
+ <xref:System.IdentityModel.Protocols.WSTrust?displayProperty=fullName>  
+ Contains classes that represent WS\-Trust artifacts.  
+  
+ <xref:System.IdentityModel.Services?displayProperty=fullName>  
+ Contains classes that are used in passive \(WS\-Federation\) scenarios.  Also contains some classes that represent settings under the [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md) element.  Settings under this element configure WS\-Federation for applications.  The `System.IdentityModel.Services.Configuration` namespace contains most of the classes that are used to configure WS\-Federation.  
+  
+ <xref:System.IdentityModel.Services.Configuration?displayProperty=fullName>  
+ Contains classes that provide configuration for WIF applications that use the WS\-Federation protocol.  この名前空間のクラスは [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md) の要素下の設定を表します。  The `System.IdentityModel.Services` namespace also contains some classes that are used to configure WS\-Federation.  
+  
+ <xref:System.IdentityModel.Services.Tokens?displayProperty=fullName>  
+ Contains specialized security token handlers for Web farm scenarios.  
+  
+ <xref:System.IdentityModel.Tokens?displayProperty=fullName>  
+ Contains classes that represent security tokens, security token handlers, and other security token artifacts.  
+  
+ <xref:System.Security.Claims?displayProperty=fullName>  
+ Contains classes that represent claims, claims\-based identities, claims\-based principals, and other claims\-based identity model artifacts.  
+  
+ <xref:System.ServiceModel.Security?displayProperty=fullName>  
+ Contains classes that represent WCF contracts, channels, service hosts and other artifacts that are used in active \(WS\-Trust\) scenarios.  This namespace also contains classes that are specific to Windows Communication Foundation \(WCF\) and that are not used by WIF.  
+  
+## 参照  
+ [WIF 構成のリファレンス](../../../docs/framework/security/wif-configuration-reference.md)   
+ [WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-claims-programming-model.md b/docs/framework/security/wif-claims-programming-model.md
new file mode 100644
index 00000000000..ef2dafd0770
--- /dev/null
+++ b/docs/framework/security/wif-claims-programming-model.md
@@ -0,0 +1,83 @@
+---
+title: "WIF 要求プログラミング モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 149cb875-9b1c-4695-b88a-fbf1725a02f9
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# WIF 要求プログラミング モデル
+ASP。NET と Windows 通信基盤 \(WCF\) の開発者は、IIdentity と IPrincipal インターフェイスを使用して、ユーザーの id 情報を使用通常。  します。NET 4.5、たんだ Windows アイデンティティ基盤 \(ぜ） が統合されています要求が常に存在を次の図に示すように、プリンシパルが。  
+  
+ ![WIF 要求プログラミング モデル](../../../docs/framework/security/media/wifclaimsprogrammingmodel.png "WIFClaimsProgrammingModel")  
+  
+ します。NET の 4.5 には System.Security.Claims に \(上の図を参照\)、新しい ClaimsPrincipal と ClaimsIdentity のクラスが含まれています。  すべてのプリンシパル。今すぐ NET から ClaimsPrincipal を派生します。  組み込みアイデンティティのすべてのクラスと FormsIdentity ASP。今すぐ NET と WindowsIdentity を ClaimsIdentity を派生します。  同様に、組み込みのすべてのプリンシパル クラス GenericPrincipal および WindowsPrincipal ClaimsPrincipal から派生します。  
+  
+ 要求によって表される<xref:System.Security.Claims.Claim>クラス。  このクラスには、次の重要なプロパティがあります。  
+  
+-   <xref:System.Security.Claims.Claim.Type%2A>クレームの種類を表すし、URI は通常です。  たとえば、として電子メール アドレスの要求が表示されます`http://schemas.microsoft.com/ws/2008/06/identity/claims/email`。  
+  
+-   <xref:System.Security.Claims.Claim.Value%2A>要求の値が含まれているし、文字列として表されます。  たとえば、電子メール アドレス"someone@contoso.com"として表されます。  
+  
+-   <xref:System.Security.Claims.Claim.ValueType%2A>要求の値の型を表すし、URI は通常です。  例えば、string 型として表されます`http://www.w3.org/2001/XMLSchema#string`。  値型は、QName に XML スキーマに従って必要があります。  形式を指定する必要があります`namespace#format`は有効な QName 値を出力するには、たんだぜを有効にします。  名前空間を明確に定義された名前空間ではない場合、されませんので、公開されている XSD ファイルをその名前空間も、生成された XML スキーマの検証、おそらくすることはできません。  既定値の型は`http://www.w3.org/2001/XMLSchema#string`。  参照してください[http:\/\/www.w3.org\/2001\/XMLSchema](http://go.microsoft.com/fwlink/?LinkId=209155)既知の値の型の安全に使用できます。  
+  
+-   <xref:System.Security.Claims.Claim.Issuer%2A>要求を発行するセキュリティ トークン サービス \(STS\) の識別子です。  これは、STS のように、STS を表す名前 URL として表すことができます`https://sts1.contoso.com/sts`。  
+  
+-   <xref:System.Security.Claims.Claim.OriginalIssuer%2A>STSs の数に関係なく、要求が最初にリリース、STS の識別子は、チェーン内です。  これと同じように表されます<xref:System.Security.Claims.Claim.Issuer%2A>。  
+  
+-   <xref:System.Security.Claims.Claim.Subject%2A>id を調べている主題です。  これには、<xref:System.Security.Claims.ClaimsIdentity> が含まれます。  
+  
+-   <xref:System.Security.Claims.Claim.Properties%2A>開発することができますは、辞書と他のプロパティでは、ワイヤの転送するアプリケーション固有のデータを提供し、カスタムの検証に使用できます。  
+  
+## Id の委任  
+ 重要なプロパティの<xref:System.Security.Claims.ClaimsIdentity>です<xref:System.Security.Claims.ClaimsIdentity.Actor%2A>。  このプロパティで、バックエンド サービスに要求を作成するのには、クライアントと中間層を動作する多層システムで資格情報の委任を有効になります。  
+  
+### Thread.CurrentPrincipal からクレームへのアクセス  
+ 使用して、現在のユーザーの一連のクレームを RP のアプリケーションにアクセスするには、 `Thread.CurrentPrincipal`。  
+  
+ 次のコード例は、System.Security.Claims.ClaimsIdentity を取得するには、このメソッドの使用方法を示しています。  
+  
+```  
+ClaimsPrincipal claimsPrincipal = Thread.CurrentPrincipal as ClaimsPrincipal;  
+  
+```  
+  
+ 詳細については、「<xref:System.Security.Claims>」を参照してください。  
+  
+### 役割要求の種類  
+ RP アプリケーションの構成の一部であるどのような役割を決定する要求の種類をする必要があります。  この要求の種類は、System.Security.Claims.ClaimsPrincipal.IsInRole\(System.String\) が使用されます。  既定の要求の種類は`http://schemas.microsoft.com/ws/2008/06/identity/claims/role`。  
+  
+### クレームの Windows アイデンティティの基盤のトークンの種類からを抽出します。  
+ たんだぜ、ボックスの外の認証メカニズムのいくつかの組み合わせをサポートしています。  たんだぜのさまざまな種類のトークンを抽出し、要求を次に示します。  
+  
+||||  
+|-|-|-|  
+|トークンの種類|請求書の生成|マップする Windows アクセス トークン|  
+|SAML 1.1|1.  System.IdentityModel.SecurityTokenService.GetOutputClaimsIdentity\(System.Security.Claims.ClaimsPrincipal,System.IdentityModel.Protocols.WSTrust.RequestSecurityToken,System.IdentityModel.Scope\) からのすべての要求。<br />2.  `http://schemas.microsoft.com/ws/2008/06/identity/claims/confirmationkey`トークン、証明トークンが含まれている場合は、確認キーの XML シリアル化を含む請求します。<br />3.  `http://schemas.microsoft.com/ws/2008/06/identity/claims/samlissuername`から発行者要素を要求します。<br />4.  トークンは、認証のステートメントが含まれている場合は、AuthenticationMethod と AuthenticationInstant 請求。|要求するだけでなく表示「SAML」型に 1.1、請求を除く`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`、Windows 認証に関連するクレームを追加すると、id WindowsClaimsIdentity で表されます。|  
+|SAML 2.0|「SAML 1.1」と同じです。|「SAML 1.1 の Windows アカウントにマップされている」と同じです。|  
+|X509|1.  主張に、x500 識別名、使用、dnsName、SimpleName、UpnName、UrlName、拇印 \(このできますされる抽出、RSACryptoServiceProvider.ExportParameters メソッドは、X509Certificate2.PublicKey.Key プロパティを使用して\) RsaKey、\(このできますされる抽出、DSACryptoServiceProvider.ExportParameters メソッドは、X509Certificate2.PublicKey.Key プロパティを使用して\)、DsaKey、SerialNumber プロパティが x509 証明書。<br />2.  AuthenticationMethod 要求値`http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/x509`。  AuthenticationInstant を主張する XmlSchema DateTime 形式で証明書を検証した場合、時間の値を使用します。|1.  Windows アカウントの完全修飾ドメイン名としてを使用して、 `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`値を要求します。  .<br />2.  X509 証明書が Windows には、マップされていないからのクレームとクレーム Windows に証明書をマップすることによって取得した windows アカウントから。|  
+|UPN|1.  クレームは、Windows 認証での要求のようです。<br />2.  AuthenticationMethod 要求値`http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/password`。  AuthenticationInstant 要求 XmlSchema DateTime 形式でパスワードを検証した場合、時間の値を使用します。||  
+|Windows \(Kerberos または NTLM\)|1.  などからのアクセス トークンを生成するクレーム： PrimarySID、DenyOnlyPrimarySID、PrimaryGroupSID、DenyOnlyPrimaryGroupSID、GroupSID、DenyOnlySID、および名前<br />2.  AuthenticationMethod 値`http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/windows`。  AuthenticationInstant、Windows トークンをアクセスするとき、時刻の値が、XMLSchema を DateTime 形式でが作成されました。||  
+|RSA キー ペア|1.  `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/rsa` 、RSAKeyValue の値を要求します。<br />2.  AuthenticationMethod 要求値`http://schemas.microsoft.com/ws/2008/06/identity/authenticationmethod/signature`。  AuthenticationInstant 要求と RSA キーは認証されて、時間の値 \(つまり、署名が検証された\) XMLSchema DateTime 形式で。||  
+  
+|||  
+|-|-|  
+|認証の種類|「AuthenticationMethod」要求で放射される URI|  
+|パスワード|`urn:oasis:names:tc:SAML:1.0:am:password`|  
+|Kerberos|`urn:ietf:rfc:1510`|  
+|SecureRemotePassword|`urn:ietf:rfc:2945`|  
+|TLSClient|`urn:ietf:rfc:2246`|  
+|X509|`urn:oasis:names:tc:SAML:1.0:am:X509-PKI`|  
+|PGP|`urn:oasis:names:tc:SAML:1.0:am:PGP`|  
+|Spki|`urn:oasis:names:tc:SAML:1.0:am:SPKI`|  
+|XmlDSig|`urn:ietf:rfc:3075`|  
+|Unspecified|`urn:oasis:names:tc:SAML:1.0:am:unspecified`|
\ No newline at end of file
diff --git a/docs/framework/security/wif-code-sample-index.md b/docs/framework/security/wif-code-sample-index.md
new file mode 100644
index 00000000000..6569a708ad8
--- /dev/null
+++ b/docs/framework/security/wif-code-sample-index.md
@@ -0,0 +1,38 @@
+---
+title: "WIF コード サンプル インデックス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6711f01a-4743-43ce-95ab-5e2302a363ea
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# WIF コード サンプル インデックス
+Windows アイデンティティ基盤の 4.5 のコード サンプルを次に示します。  
+  
+-   [ClaimsAwareWebApp](http://go.microsoft.com/fwlink/?LinkID=248405) \-この認証 externalization の基本的な使い方 （、ローカルをテストするセキュリティ トークン サービスの Id およびアクセス ツールから Visual Studio 11\) は、従来の ASP のサンプルします。NET アプリケーション \(としてではなく、web サイトへ\)。  
+  
+-   [ClaimsAwareWebService](http://go.microsoft.com/fwlink/?LinkID=248406) 、このサンプルでは、従来の WCF サービスでの認証 externalization の基本的な使用します。  
+  
+-   [ClaimsAwareMvcApplication](http://go.microsoft.com/fwlink/?LinkID=248407) \- このサンプルたんだぜを一括ではない保護などの MVC に統合する方法を示していて、フォーム認証を使用するコード ログオンのコント ローラーをリダイレクトします。  
+  
+-   [ClaimsAwareWebFarm](http://go.microsoft.com/fwlink/?LinkID=248408) \-大きなクッキーを交換するのではなく参照によってセッションを使用することができますようにこのサンプル ファーム準備がセッション キャッシュには、tokenreplycache\) を示します。  また、ファーム内の cookie をセキュリティ保護する簡単な方法を示します。  
+  
+-   [ClaimsAwareFormsAuthentication](http://go.microsoft.com/fwlink/?LinkID=248409)ので、この非常に単純な例を示します。NET 4.5 がユーザーを認証する方法に関係なく、プリンシパルにクレームを取得します。  
+  
+-   [ClaimsBasedAuthorization](http://go.microsoft.com/fwlink/?LinkID=248410)\- このサンプルは、独自の承認ポリシーを適用するため、CLaimsAuthorizationManager のクラスと、ClaimsAuthorizationModule を使用する方法を示しています。  
+  
+-   [FederationMetadata](http://go.microsoft.com/fwlink/?LinkID=248411) ： このサンプル \(カスタム STS\) での動的な生成と動的消費 \(には、依存元のサードパーティ製アプリケーション\) のメタデータ ドキュメントの両方を示しています。  
+  
+-   [CustomToken](http://go.microsoft.com/fwlink/?LinkID=248412) ： このサンプル簡易 Web トークン \(SWT） のカスタム トークン型を構築する方法を示しています。  
+  
+## 参照  
+ [Windows Identity Foundation](../../../docs/framework/security/windows-identity-foundation.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-configuration-reference.md b/docs/framework/security/wif-configuration-reference.md
new file mode 100644
index 00000000000..9bc5b0a7ce5
--- /dev/null
+++ b/docs/framework/security/wif-configuration-reference.md
@@ -0,0 +1,25 @@
+---
+title: "WIF 構成のリファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 098b80ba-9ebd-4078-a1cb-c1151036a207
+caps.latest.revision: 2
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 2
+---
+# WIF 構成のリファレンス
+You can configure Windows Identity Foundation \(WIF\) in your applications by adding elements to a configuration file.  This topic contains links to reference topics for the WIF configuration elements.  
+  
+ [WIF 構成スキーマ](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/index.md)  
+ The reference for the WIF configuration elements.  
+  
+ [WIF 構成スキーマの規則](../../../docs/framework/security/wif-configuration-schema-conventions.md)  
+ Contains information about general attributes and formats used by the WIF configuration elements.
\ No newline at end of file
diff --git a/docs/framework/security/wif-configuration-schema-conventions.md b/docs/framework/security/wif-configuration-schema-conventions.md
new file mode 100644
index 00000000000..209670dffc3
--- /dev/null
+++ b/docs/framework/security/wif-configuration-schema-conventions.md
@@ -0,0 +1,54 @@
+---
+title: "WIF 構成スキーマの規則 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f7864356-f72f-4cae-995c-18e0431f8a58
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# WIF 構成スキーマの規則
+このトピックでは、Windows ID Foundation \(WIF\) の構成に関するトピック全体で使用される規則について説明し、[\<system.identityModel\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md) と [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md) のセクションで使用される共通機能と属性について説明します。  
+  
+<a name="BKMK_Modes"></a>   
+## モード  
+ WIF の構成要素の多くに `mode` の属性があります。  処理の特定の部分にクラスが使用される構成要素が現在の要素の子要素として指定し、この属性は通常、制御します。  構成エラーは、構成ファイルに含まれる要素がモードの設定では、は無視されます発生します。  
+  
+<a name="BKMK_TimespanValues"></a>   
+## 時刻値  
+ 許可される書式を表示するには、属性の型は、<xref:System.TimeSpan.Parse%28System.String%29> のメソッドを表示するときに <xref:System.TimeSpan> を使用する場所。  この形式は、次の仕様に準拠します。  
+  
+```  
+[ws][-]{ d | [d.]hh:mm[:ss[.ff]] }[ws]  
+```  
+  
+ たとえば、「30 "、「30.00:00」、「30.00:00: すべて平均 30 日 00 "; および「00:05」、「00:05: 00 "、「0.00:05: すべて 5 分 00.00 "を意味します。  
+  
+<a name="BKMK_CertificateReferences"></a>   
+## 証明書の参照  
+ `<certificateReference;>` の要素を使用して証明書複数の要素への参照の取得。  証明書を参照すると、次の属性があります。  
+  
+|||  
+|-|-|  
+|`storeLocation`|<xref:System.Security.Cryptography.X509Certificates.StoreLocation> の列挙値: `CurrentUser` か `CurrentMachine`。|  
+|`storeName`|<xref:System.Security.Cryptography.X509Certificates.StoreName> の列挙値; このコンテキストの最も役立つの `My` と `TrustedPeople`です。|  
+|`x509FindType`|<xref:System.Security.Cryptography.X509Certificates.X509FindType> の列挙値; このコンテキストの最も役立つの `FindBySubjectName` と `FindByThumbprint`です。  `FindByThumbprint` の型が稼働環境で使用するエラーの可能性を削減することをお勧めします。|  
+|`findValue`|`x509FindType` の属性に基づいて証明書を検索するために使用される値。  `FindByThumbprint` の型が稼働環境で使用するエラーの可能性を削減することをお勧めします。  `FindByThumbPrint` が指定された場合、この属性は証明書のサムプリントの 16 進数文字列の形式である値を受け取ります; たとえば、「」97249e1a5fa6bee5e515b82111ef524a4c91583f。|  
+  
+<a name="BKMK_CustomTypeReferences"></a>   
+## カスタム型の参照  
+ `type` の属性を使用して複数の要素の参照のカスタム型。  この属性は、カスタムの型の名前を指定する必要があります。  グローバル アセンブリ キャッシュ \(GAC\) の型を参照するには、厳密な名前を使用する必要があります。  Bin ディレクトリにアセンブリの型を参照するには、単純なアセンブリ修飾参照を使用することがあります。  App\_Code\/ディレクトリに定義された型は、アセンブリ修飾なしの型名だけを指定することによって参照できます。  
+  
+ カスタム型で指定された型から派生していない場合、`public` の既定値 \(0\) コンストラクターの引数を指定する必要があります。  
+  
+## 参照  
+ [\<system.identityModel\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel.md)   
+ [\<system.identityModel.services\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/system-identitymodel-services.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-extensions.md b/docs/framework/security/wif-extensions.md
new file mode 100644
index 00000000000..2e1fcb81278
--- /dev/null
+++ b/docs/framework/security/wif-extensions.md
@@ -0,0 +1,23 @@
+---
+title: "WIF の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a9608a51-d61f-4802-8d2e-ee2dc64d9ae1
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# WIF の拡張
+ここでは、Windows Identity Foundation の拡張機能について説明します。  
+  
+-   [JSON Web トークン ハンドラー](../../../docs/framework/security/json-web-token-handler.md)  
+  
+-   [発行者名レジストリの検証](../../../docs/framework/security/validating-issuer-name-registry.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-features.md b/docs/framework/security/wif-features.md
new file mode 100644
index 00000000000..ce139170a1f
--- /dev/null
+++ b/docs/framework/security/wif-features.md
@@ -0,0 +1,30 @@
+---
+title: "WIF の機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e13cae9-7cd1-491f-aa75-0735320a7be6
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# WIF の機能
+-   [Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)  
+  
+-   [WIF セッション管理](../../../docs/framework/security/wif-session-management.md)  
+  
+-   [WIF および Web ファーム](../../../docs/framework/security/wif-and-web-farms.md)  
+  
+-   [WSFederation 認証モジュールの概要](../../../docs/framework/security/wsfederation-authentication-module-overview.md)  
+  
+-   [WSTrustChannelFactory および WSTrustChannel](../../../docs/framework/security/wstrustchannelfactory-and-wstrustchannel.md)  
+  
+## 参照  
+ [Windows Identity Foundation](../../../docs/framework/security/windows-identity-foundation.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-guidelines.md b/docs/framework/security/wif-guidelines.md
new file mode 100644
index 00000000000..cbc58c6b863
--- /dev/null
+++ b/docs/framework/security/wif-guidelines.md
@@ -0,0 +1,24 @@
+---
+title: "WIF のガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2fc76a0b-e33c-44c1-8f32-44934eb03dd4
+caps.latest.revision: 2
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 2
+---
+# WIF のガイドライン
+-   [WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)  
+  
+-   [WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)  
+  
+## 参照  
+ [Windows Identity Foundation](../../../docs/framework/security/windows-identity-foundation.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-how-tos-index.md b/docs/framework/security/wif-how-tos-index.md
new file mode 100644
index 00000000000..c76b9a76e28
--- /dev/null
+++ b/docs/framework/security/wif-how-tos-index.md
@@ -0,0 +1,37 @@
+---
+title: "WIF の「方法」のインデックス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e8c6d04-fc2e-4b55-8717-c4cbaf681381
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# WIF の「方法」のインデックス
+-   [方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md)  
+  
+-   [方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md)  
+  
+-   [方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](../../../docs/framework/security/claims-aware-aspnet-app-forms-authentication.md)  
+  
+-   [方法: Windows 認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-app-using-windows-authentication.md)  
+  
+-   [方法: WIF トレースを使用してクレーム対応アプリケーションおよびサービスをデバッグする](../../../docs/framework/security/how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md)  
+  
+-   [方法: WIF を使用してサインイン状態を表示する](../../../docs/framework/security/how-to-display-signed-in-status-using-wif.md)  
+  
+-   [方法: トークン再生検出を有効にする](../../../docs/framework/security/how-to-enable-token-replay-detection.md)  
+  
+-   [方法: WIF トレースの有効化](../../../docs/framework/security/how-to-enable-wif-tracing.md)  
+  
+-   [操作方法: WCF Web サービス アプリケーションの WIF を有効にする](../../../docs/framework/security/how-to-enable-wif-for-a-wcf-web-service-application.md)  
+  
+-   [方法: 入力方向の要求の変換](../../../docs/framework/security/how-to-transform-incoming-claims.md)
\ No newline at end of file
diff --git a/docs/framework/security/wif-overview.md b/docs/framework/security/wif-overview.md
new file mode 100644
index 00000000000..f8f5fe264ac
--- /dev/null
+++ b/docs/framework/security/wif-overview.md
@@ -0,0 +1,46 @@
+---
+title: "Windows Identity Foundation 4.5 の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f723345-7270-49e2-b638-b3a34bd40517
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# Windows Identity Foundation 4.5 の概要
+Windows Identity Foundation 4.5 は、アプリケーション内でクレーム ベース ID を実装するための一連の .NET Framework クラスです。  このクラスを使用することで、クレーム対応アプリケーションおよびサービスのメリットを簡単に得られるようになります。  WIF 4.5 は、.NET Framework Version 4.5 以降が使用されているすべての Web アプリケーションまたは Web サービスで使用できます。  WIF は、オープン スタンダードに基づく業界共通の構想を取り入れた Microsoft のフェデレーション ID ソフトウェア ファミリの 1 つにすぎません。  フェデレーション ID は、[Active Directory® フェデレーション サービス](http://go.microsoft.com/fwlink/?LinkID=247516) \(AD FS\)、[Microsoft Azure のアクセス制御サービス](http://go.microsoft.com/fwlink/?LinkID=247517) \(ACS\)、および WIF の 3 つのコンポーネントで構成されます。  この 3 つのコンポーネントが一体となって、Microsoft の新しいクレーム ベースのクラウド ID およびアクセス プラットフォームのコアを形成しています。  
+  
+ WIF の詳細については、MSDN のセキュリティ デベロッパー センターの [Windows Identity Foundation の Web サイト](http://go.microsoft.com/fwlink/?LinkId=149009) \(http:\/\/go.microsoft.com\/fwlink\/?LinkId\=149009\) を参照してください。  WIF を使用したアプリケーション作成の概要については、「[Programming Windows Identity Foundation \(Windows Identity Foundation のプログラミング\)](http://go.microsoft.com/fwlink/?LinkId=210158)」\(http:\/\/go.microsoft.com\/fwlink\/?LinkId\=210158\) \(Vittorio Bertocci 著、Microsoft Press 発行\) を参照してください。  
+  
+## WIF 4.5 の機能  
+ WIF 4.5 は、ID 対応アプリケーションをビルドするためのフレームワークです。  このフレームワークは、WS\-Trust プロトコルと WS\-Federation プロトコルを抽象化し、クレーム対応アプリケーションと、必要に応じてセキュリティ トークン サービス \(STS\) をビルドするための API を開発者に提供します。  アプリケーションでは、WIF を使用して、AD FS 2.0、ACS などの STS から発行されたトークンを処理し、Web アプリケーションまたは Web サービスで ID ベースの決定を下すことができます。  
+  
+ WIF 4.5 の主な機能は次のとおりです。  
+  
+-   クレーム対応アプリケーション \(証明書利用者アプリケーション\) のビルド。  WIF は、開発者がクレーム対応アプリケーションをビルドするときに役立ちます。  WIF には、新しいクレーム モデルだけでなく豊富な API が用意されており、アプリケーション開発者は、この API を使用して、クレームに基づいてユーザー アクセスに関する決定を行うことができます。また、アプリケーションを構築する環境として ASP.NET または WCF のどちらを選択した場合でも、WIF により一貫したプログラミングの操作性が実現します。  
+  
+-   クレーム対応アプリケーションに対する ID 委任のサポートの構築。WIF には、複数のサービスの境界を越えて元の要求元の ID を保持する機能が用意されています。  この機能を有効にするには、フレームワークで "ActAs" 機能または "OnBehalfOf" 機能のいずれかを使用します。開発者は、この機能を使用して、ID 委任のサポートをクレーム対応アプリケーションに追加できます。  
+  
+-   カスタム STS のビルド。WIF により、WS\-Trust プロトコルをサポートするカスタム STS のビルドがかなり容易になりました。  この STS は、アクティブ STS とも呼ばれます。  
+  
+     また、フレームワークでは、WS\-Federation をサポートする STS をビルドすることもでき、これにより Web ブラウザー クライアントが有効になります。  この STS は、パッシブ STS とも呼ばれます。  
+  
+-   新しい Identity and Access Tool for Visual Studio 11。このツールを使用すると、クレーム ベース ID を使用してアプリケーションを保護しながら、複数の ID プロバイダーからユーザーを受け入れることができます。  この WIF ツールは [http:\/\/go.microsoft.com\/fwlink\/?LinkID\=245849](http://go.microsoft.com/fwlink/?LinkID=245849) からダウンロードできます。また、拡張機能マネージャーで直接 "ID" を検索して、Visual Studio 11 から直接ダウンロードすることもできます。  詳細については、「[Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)」を参照してください。  
+  
+ WIF がサポートする主なシナリオを次に示します。  
+  
+-   フェデレーション。WIF では、複数のパートナー間のフェデレーションを有効にできます。  開発者はクレーム対応アプリケーション \(RP\) およびカスタム STS をビルドするための機能を使用して、このシナリオを実現します。  
+  
+-   ID の委任。WIF ではサービスの境界を越えて ID を保持できるため、開発者は ID 委任のシナリオを簡単に実現できます。  
+  
+-   ステップアップ認証。  同じアプリケーション内でも、リソースによって認証の要件が異なる場合があります。  WIF では、認証要件を段階的に厳しくする必要がある \(たとえば、最初はユーザー名とパスワード認証でログインし、その後、スマート カード認証にステップアップする\) アプリケーションを、開発者がビルドできます。  
+  
+ WIF を使用すると、クレーム ベースの ID モデルのメリットを簡単に利用できます。  詳細については、[開発者向けの Windows Identity Foundation のホワイト ペーパー](http://go.microsoft.com/fwlink/?LinkId=122266)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/security/wif-session-management.md b/docs/framework/security/wif-session-management.md
new file mode 100644
index 00000000000..7028e8a9a7b
--- /dev/null
+++ b/docs/framework/security/wif-session-management.md
@@ -0,0 +1,37 @@
+---
+title: "WIF セッション管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98bce126-18a9-401b-b20d-67ee462a5f8a
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# WIF セッション管理
+クライアントが最初に証明書利用者によってホスト保護されたリソースにアクセスしようとしたときに、クライアント証明書は、ユーザーによって信頼されるセキュリティ トークン Services \(STS\) に最初に認証する必要があります。  STS はクライアントに、セキュリティ トークンを発行します。  クライアントは、保護されているリソースへのクライアント アクセスを許可する証明書利用者にこのトークンを示します。  ただし、特に証明書利用者と同じコンピューターにまたは同じドメイン内に存在しない場合があるため、クライアントへの各要求に関する STS に再認証する側に必要です。  代わりに、Windows ID Foundation \(WIF\) は、クライアント証明書利用者にすべての要求の証明書利用者に認証にクライアントがセッションのセキュリティ トークンを後の最初の要求を使用するセッション設定されている。  証明書利用者はクッキー内に格納されているクライアントの <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName>を再度確立するためにこのセッションのセキュリティ トークンを使用できます。  
+  
+ STS は、認証を提供するクライアントがあるかを定義します。  ただし、クライアントが STS に認証できる複数の資格情報がある場合があります。  たとえば、Windows Live からトークン、ユーザー名とパスワード、および証明書 smartkey がある場合があります。  この場合、STS はクライアントに示す資格情報の 1 種類に対応するクライアントに各 ID を持つ複数の ID を与えます。  証明書利用者はクライアントに与えられる許可するアクセスのレベルを決定するときにこれらの ID を一つ以上使用できます。  
+  
+ <xref:System.IdentityModel.Tokens.SessionSecurityToken?displayProperty=fullName> がクライアントの <xref:System.Security.Claims.ClaimsPrincipal?displayProperty=fullName>を再確立するために使用されます。<xref:System.Security.Claims.ClaimsPrincipal.Identities%2A>でクライアント ID をすべて備えた。  コレクションの各 <xref:System.Security.Claims.ClaimsIdentity?displayProperty=fullName> は、その ID に関連付けられているブートストラップのトークンが含まれています。  
+  
+ 新しいセッションのトークンが元のセッションのトークンのセッション ID に問題 <xref:System.IdentityModel.Tokens.SessionSecurityTokenHandler?displayProperty=fullName> トークンは、キャッシュのセッションのトークンを更新しません。  一意のセッション ID を持つセッションのトークンを常にインスタンス化する必要があります  
+  
+> [!NOTE]
+>  Session.SecurityTokenHandler.ReadToken は無効な入力を受け取る場合は <xref:System.Xml.XmlException> の例外をスローします; たとえば、セッションのトークンを含むクッキーの破損。  この例外をキャッチする推奨し、アプリケーション固有の動作を提供します。  
+  
+ 保護された Web ページが保護されたドメインにあるリソースの多くが含まれている場合、グラフィックスなど\) は、クライアント証明書利用者にこれらのリソースをダウンロードするに再認証する必要があります。  セッションの認証トークンの使用は、要求ごとの STS に認証する必要はありませんが、多くのクッキーが送信されることを意味します。まだ  マイナー項目が保護されていないドメインに格納され、メイン Web ページからリンク間に、重要なデータやリソースが保護されたドメインに格納するために Web ページを設定することがあります。  また、保護されたドメインだけを参照するようにクッキーのパスを設定します。  
+  
+ 参照モードで動作するように、マイクロソフトは、ハンドラーを **global.asax.cs** ファイルの <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SessionSecurityTokenCreated> のイベントに提供し、<xref:System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs.SessionToken%2A> のプロパティに渡されるトークンで **IsReferenceMode** のプロパティを設定することをお勧めします。  これらの更新はセッションのトークンを要求ごとの参照モードで動作し、のみセッションの認証モジュールの <xref:System.IdentityModel.Services.SessionAuthenticationModule.IsReferenceMode%2A> のプロパティを設定することでサポートされていることを確認します。  
+  
+## 機能拡張  
+ セッション管理機構を拡張できます。  このの 1 種類の理由は、パフォーマンスを向上させることです。  たとえば、メモリの状態間のセッションのセキュリティ トークンを示しますがクッキーになる変換するか、最適化するクッキーのカスタム ハンドラーを作成できます。  そのためには、<xref:System.IdentityModel.Services.CookieHandler?displayProperty=fullName>から派生したカスタムのクッキーのハンドラーを使用するように <xref:System.IdentityModel.Services.SessionAuthenticationModule?displayProperty=fullName> の <xref:System.IdentityModel.Services.SessionAuthenticationModule.CookieHandler%2A?displayProperty=fullName> のプロパティを構成できます。  <xref:System.IdentityModel.Services.ChunkedCookieHandler?displayProperty=fullName> は、クッキーのハイパーテキスト転送プロトコル \(HTTP\) に対する許容サイズを超えるため、既定のクッキーのハンドラーです; カスタムのクッキーのハンドラーを使用すると、chunking を実装する必要があります。  
+  
+ 詳細については、" [ClaimsAwareWebFarm](http://go.microsoft.com/fwlink/?LinkID=248408) " \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=248408\) のサンプル。  この例は、参照によって大きいクッキーを交換する代わりに、セッションを使用できるように準備完了ファームにセッション キャッシュを示します \(tokenreplycache ではなく\) ; このサンプルには、ファームのクッキーを保護する簡単な方法を示します。  セッション キャッシュは、WCF ベースです。  保護しているセッションに関連するサンプルは、web.config の適切なスニペットを単純に貼り付けてアクティブにできる MachineKey に基づいて、クッキーの変換の WIF 4.5 の新機能について示します。  サンプル自体は「されませんが」、ファームのファーム アプリケーションを準備完了ようにするために必要な情報を示します。
\ No newline at end of file
diff --git a/docs/framework/security/windows-identity-foundation.md b/docs/framework/security/windows-identity-foundation.md
new file mode 100644
index 00000000000..c2d657158d7
--- /dev/null
+++ b/docs/framework/security/windows-identity-foundation.md
@@ -0,0 +1,82 @@
+---
+title: "Windows Identity Foundation | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/14/2016"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7eb50bcb-38d8-4afb-86aa-2573586697c2
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+---
+# Windows Identity Foundation
+-   [Windows Identity Foundation 4.5 の新機能](../../../docs/framework/security/whats-new-in-wif.md)  
+  
+-   [Windows Identity Foundation 4.5 の概要](../../../docs/framework/security/wif-overview.md)  
+  
+    -   [クレームベースの ID モデル](../../../docs/framework/security/claims-based-identity-model.md)  
+  
+    -   [WIF を使用したクレーム ベースの承認](../../../docs/framework/security/claims-based-authorization-using-wif.md)  
+  
+    -   [WIF 要求プログラミング モデル](../../../docs/framework/security/wif-claims-programming-model.md)  
+  
+-   [WIF の概要](../../../docs/framework/security/getting-started-with-wif.md)  
+  
+    -   [クレーム対応の ASP.NET Web アプリケーションを初めて構築する](../../../docs/framework/security/building-my-first-claims-aware-aspnet-web-app.md)  
+  
+    -   [初めてのクレーム対応 WCF サービスのビルド](../../../docs/framework/security/building-my-first-claims-aware-wcf-service.md)  
+  
+-   [WIF の機能](../../../docs/framework/security/wif-features.md)  
+  
+    -   [Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)  
+  
+    -   [WIF セッション管理](../../../docs/framework/security/wif-session-management.md)  
+  
+    -   [WIF および Web ファーム](../../../docs/framework/security/wif-and-web-farms.md)  
+  
+    -   [WSFederation 認証モジュールの概要](../../../docs/framework/security/wsfederation-authentication-module-overview.md)  
+  
+    -   [WSTrustChannelFactory および WSTrustChannel](../../../docs/framework/security/wstrustchannelfactory-and-wstrustchannel.md)  
+  
+-   [WIF の「方法」のインデックス](../../../docs/framework/security/wif-how-tos-index.md)  
+  
+    -   [方法: WIF を使用してクレーム対応 ASP.NET MVC Web アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-mvc-web-app-using-wif.md)  
+  
+    -   [方法: WIF を使用してクレーム対応 ASP.NET Web フォーム アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-web-forms-app-using-wif.md)  
+  
+    -   [方法: フォームベースの認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](../../../docs/framework/security/claims-aware-aspnet-app-forms-authentication.md)  
+  
+    -   [方法: Windows 認証を使用するクレーム対応 ASP.NET アプリケーションをビルドする](../../../docs/framework/security/how-to-build-claims-aware-aspnet-app-using-windows-authentication.md)  
+  
+    -   [方法: WIF トレースを使用してクレーム対応アプリケーションおよびサービスをデバッグする](../../../docs/framework/security/how-to-debug-claims-aware-applications-and-services-using-wif-tracing.md)  
+  
+    -   [方法: WIF を使用してサインイン状態を表示する](../../../docs/framework/security/how-to-display-signed-in-status-using-wif.md)  
+  
+    -   [方法: トークン再生検出を有効にする](../../../docs/framework/security/how-to-enable-token-replay-detection.md)  
+  
+    -   [方法: WIF トレースの有効化](../../../docs/framework/security/how-to-enable-wif-tracing.md)  
+  
+    -   [操作方法: WCF Web サービス アプリケーションの WIF を有効にする](../../../docs/framework/security/how-to-enable-wif-for-a-wcf-web-service-application.md)  
+  
+    -   [方法: 入力方向の要求の変換](../../../docs/framework/security/how-to-transform-incoming-claims.md)  
+  
+-   [WIF のガイドライン](../../../docs/framework/security/wif-guidelines.md)  
+  
+    -   [WIF 3.5 でビルドされたアプリケーションを WIF 4.5 に移行するためのガイドライン](../../../docs/framework/security/guidelines-for-migrating-an-application-built-using-wif-3-5-to-wif-4-5.md)  
+  
+    -   [WIF 3.5 と WIF 4.5 間での名前空間マッピング](../../../docs/framework/security/namespace-mapping-between-wif-3-5-and-wif-4-5.md)  
+  
+-   [WIF コード サンプル インデックス](../../../docs/framework/security/wif-code-sample-index.md)  
+  
+-   [WIF の拡張](../../../docs/framework/security/wif-extensions.md)  
+  
+-   [WIF API リファレンス](../../../docs/framework/security/wif-api-reference.md)  
+  
+-   [WIF 構成のリファレンス](../../../docs/framework/security/wif-configuration-reference.md)  
+  
+    -   [WIF 構成スキーマの規則](../../../docs/framework/security/wif-configuration-schema-conventions.md)
\ No newline at end of file
diff --git a/docs/framework/security/wsfederation-authentication-module-overview.md b/docs/framework/security/wsfederation-authentication-module-overview.md
new file mode 100644
index 00000000000..49029b4b529
--- /dev/null
+++ b/docs/framework/security/wsfederation-authentication-module-overview.md
@@ -0,0 +1,150 @@
+---
+title: "WSFederation 認証モジュールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02c4d5e8-f0a7-49ee-9cf5-3647578510ad
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# WSFederation 認証モジュールの概要
+Windows Identity Foundation \(WIF\) は、WS\-Federated Authentication Module \(WS\-FAM\) を通じて ASP.NET アプリケーションでのフェデレーション認証をサポートします。  このトピックは、フェデレーション認証の動作とその使用方法の理解に役立ちます。  
+  
+### フェデレーション認証の概要  
+ 2 つのドメイン間に信頼関係がある場合、フェデレーション認証により、一方の信頼するドメイン内のセキュリティ トークン サービス \(STS\) から、他方の信頼するドメイン内の STS へ認証情報を提供できます。  この例を次の図に示します。  
+  
+ ![Federation 認証シナリオ](../../../docs/framework/security/media/federatedauthentication.png "FederatedAuthentication")  
+  
+1.  Fabrikam 信頼ドメインのクライアントが、Contoso 信頼ドメインの証明書利用者 \(RP\) アプリケーションに要求を送信します。  
+  
+2.  RP は Contoso 信頼ドメインの STS にクライアントをリダイレクトします。  この STS はクライアントについては関知しません。  
+  
+3.  Contoso STS は Contoso 信頼ドメインと信頼関係がある Fabrikam 信頼ドメインの STS にクライアントをリダイレクトします。  
+  
+4.  Fabrikam STS がクライアント ID を確認し、Contoso STS にセキュリティ トークンを発行します。  
+  
+5.  Contoso STS は、Fabrikam トークンを使用して RP が使用できる独自のトークンを作成したり、作成されたトークンを RP へ送信します。  
+  
+6.  RP はセキュリティ トークンからクライアントのクレームを抽出し、承認決定を実行します。  
+  
+### ASP.NET を使用したフェデレーション認証モジュールの使用  
+ <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> \(WS\-FAM\) は [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションにフェデレーション認証を追加可能にする HTTP モジュールです。  フェデレーション認証により、認証ロジックが STS によって処理されるので、ビジネス ロジックの作成に集中できます。  
+  
+ WS\-FAM を構成して、未認証の要求のリダイレクト先に対して STS を指定します。  WIF では次の 2 つの方法でユーザーを認証できます。  
+  
+1.  受動リダイレクト: 未認証ユーザーが保護されたリソースにアクセスしようとした場合、ログイン ページを必要とすることなく STS にリダイレクトできます。これは適切な方法です。  STS はユーザーの ID を検証し、そのユーザーの適切なクレームを含むセキュリティ トークンを発行します。  このオプションでは WS\-FAM を HTTP モジュールのパイプラインに追加する必要があります。  Identity and Access Tool for Visual Studio 2012 を使用することで、WS\-FAM を使用して STS でフェデレーションを実行するようアプリケーションの構成ファイルを変更できます。  詳細については、「[Identity and Access Tool for Visual Studio 2012](../../../docs/framework/security/identity-and-access-tool-for-vs.md)」を参照してください。  
+  
+2.  RP アプリケーションのサインイン ページ用の分離コードから <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SignIn%2A?displayProperty=fullName> メソッドまたは <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.RedirectToIdentityProvider%2A> メソッドを呼び出すことができます。  
+  
+ 受動リダイレクトでは、すべての通信は、クライアント \(通常はブラウザー\) からの応答\/リダイレクトによって実行されます。  アプリケーションの HTTP パイプラインに WS\-FAM を追加できます。ここで WS\-FAM は未認証のユーザー要求を監視し、指定した STS にユーザーをリダイレクトします。  
+  
+ また WS\-FAM は、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションで機能をカスタマイズするための複数のイベントを発生させます。  
+  
+### WS\-FAM の動作  
+ WS\-FAM は <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> クラスに実装されます。  通常、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] RP アプリケーションの HTTP パイプラインに WS\-FAM を追加します。  未認証のユーザーが保護されたリソースにアクセスしようとすると、RP は \[401 authorization denied \(401 承認が拒否されました\)\] という HTTP 応答を返します。  WS\-FAM は、クライアントがこれを受け取ることを許可する代わりにこの応答を先に取得し、指定されている STS にユーザーをリダイレクトします。  STS はセキュリティ トークンを発行し、WS\-FAM がそれを再び受け取ります。  WS\-FAM はトークンを使用して、認証ユーザー向けに <xref:System.Security.Claims.ClaimsPrincipal> のインスタンスを作成します。これにより、通常の [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の承認機能が機能します。  
+  
+ HTTP はステートレスであるため、保護されている別のリソースにユーザーがアクセスしようとするたびに、このプロセス全体が繰り返し行われないようにする必要があります。  このような場合に <xref:System.IdentityModel.Services.SessionAuthenticationModule> が役に立ちます。  STS がユーザーにセキュリティ トークンを発行すると、<xref:System.IdentityModel.Services.SessionAuthenticationModule> もユーザーにセッションのセキュリティ トークンを作成して、クッキーにします。  以降の要求では、<xref:System.IdentityModel.Services.SessionAuthenticationModule> はこのクッキーを受け取り、これを使用してユーザーの <xref:System.Security.Claims.ClaimsPrincipal> を構築します。  
+  
+ 次の図に、受動リダイレクトのケースの全体的な情報のフローを示します。  要求は STS を通じて自動的にリダイレクトされ、ログイン ページなしで資格情報が作成されます。  
+  
+ ![パッシブ リダイレクトを使用するサインインのタイミング ダイアグラム](../../../docs/framework/security/media/signinusingpassiveredirect.png "SignInUsingPassiveRedirect")  
+  
+ 次の図は、ユーザーが STS に認証されており、セキュリティ トークンが <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> によって処理されるときに発生する状況を詳細に示します。  
+  
+ ![パッシブ リダイレクトを使用するトークン処理のタイミング](../../../docs/framework/security/media/signinusingpassiveredirect-tokenprocessing.png "SignInUsingPassiveRedirect\_TokenProcessing")  
+  
+ 次の図は、ユーザーのセキュリティ トークンがクッキーにシリアル化されていて <xref:System.IdentityModel.Services.SessionAuthenticationModule> 先に取得されている場合に発生する状況を詳細に示します。  
+  
+ ![コントロールを使用するサインインを表示する SAM タイミング ダイアグラム](../../../docs/framework/security/media/signinusingconrols-sam.png "SignInUsingConrols\_SAM")  
+  
+### イベント  
+ <xref:System.IdentityModel.Services.WSFederationAuthenticationModule>、<xref:System.IdentityModel.Services.SessionAuthenticationModule>、および親クラス <xref:System.IdentityModel.Services.HttpModuleBase> は、HTTP 要求処理のさまざまな段階でイベントを発生させます。  [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションの `global.asax` ファイルでこれらのイベントを処理できます。  
+  
+-   ASP.NET のインフラストラクチャは、モジュールを初期化するためにモジュールの <xref:System.IdentityModel.Services.HttpModuleBase.Init%2A> メソッドを呼び出します。  
+  
+-   <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfigurationCreated?displayProperty=fullName> イベントは、<xref:System.IdentityModel.Services.HttpModuleBase> から派生するアプリケーションのモジュールのいずれか 1 つで ASP.NET インフラストラクチャが <xref:System.IdentityModel.Services.HttpModuleBase.Init%2A> メソッドを初めて呼び出す場合に発生します。  このメソッドは静的な <xref:System.IdentityModel.Services.FederatedAuthentication.FederationConfiguration%2A?displayProperty=fullName> のプロパティにアクセスし、これにより構成が Web.config ファイルから読み込まれます。  このイベントが発生するのは、このプロパティに初めてアクセスした場合だけです。  構成から初期化される <xref:System.IdentityModel.Services.Configuration.FederationConfiguration> オブジェクトは、イベント ハンドラーの <xref:System.IdentityModel.Services.Configuration.FederationConfigurationCreatedEventArgs.FederationConfiguration%2A?displayProperty=fullName> のプロパティを通じてアクセスできます。  構成がモジュールに適用される前に、このイベントを使用して構成を変更できます。  Application\_Start イベントでこのイベントのハンドラーを追加できます。  
+  
+    ```  
+    void Application_Start(object sender, EventArgs e)  
+    {  
+        FederatedAuthentication.FederationConfigurationCreated += new EventHandler<FederationConfigurationCreatedEventArgs>(FederatedAuthentication_FederationConfigurationCreated);  
+    }  
+    ```  
+  
+     各モジュールが <xref:System.IdentityModel.Services.HttpModuleBase.InitializeModule%2A?displayProperty=fullName> と <xref:System.IdentityModel.Services.HttpModuleBase.InitializePropertiesFromConfiguration%2A?displayProperty=fullName> 抽象メソッドをオーバーライドします。  これらのメソッドの 1 番目は、モジュールにとって重要な ASP.NET パイプライン イベントのハンドラーを追加します。  ほとんどの場合、モジュールの既定の実装で十分です。  これらのメソッドの 2 番目は、<xref:System.IdentityModel.Services.HttpModuleBase.FederationConfiguration%2A?displayProperty=fullName> プロパティからモジュールのプロパティを初期化します\(これは、以前に読み込まれた構成のコピーです\)。<xref:System.IdentityModel.Services.WSFederationAuthenticationModule> または <xref:System.IdentityModel.Services.SessionAuthenticationModule> から派生するクラスの構成から新しいプロパティの初期化をサポートするには、2 番目のメソッドをオーバーライドすることが必要になる場合があります。  このような場合、追加された構成プロパティをサポートするために、<xref:System.IdentityModel.Configuration.IdentityConfiguration>、<xref:System.IdentityModel.Services.Configuration.WsFederationConfiguration>、または <xref:System.IdentityModel.Services.Configuration.FederationConfiguration> などの適切な構成オブジェクトから派生することが必要になる場合があります。  
+  
+-   WS\-FAM は STS によって発行されたセキュリティ トークンを受け取る場合、<xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SecurityTokenReceived> イベントを発生させます。  
+  
+-   WS\-FAM はトークンを検証した後 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SecurityTokenValidated> イベントを発生させます。  
+  
+-   <xref:System.IdentityModel.Services.SessionAuthenticationModule> はユーザーのセッションのセキュリティ トークンを作成するとき <xref:System.IdentityModel.Services.SessionAuthenticationModule.SessionSecurityTokenCreated> イベントを発生させます。  
+  
+-   <xref:System.IdentityModel.Services.SessionAuthenticationModule> は、セッションのセキュリティ トークンを含むクッキーを使用してそれ以降の要求を受け取る場合、<xref:System.IdentityModel.Services.SessionAuthenticationModule.SessionSecurityTokenReceived> イベントを発生させます。  
+  
+-   WS\-FAM はユーザーを発行者にリダイレクトする前に、<xref:System.IdentityModel.Services.WSFederationAuthenticationModule.RedirectingToIdentityProvider> イベントを発生させます。  WS\-Federation のサインイン要求は、イベントに渡される <xref:System.IdentityModel.Services.RedirectingToIdentityProviderEventArgs> の <xref:System.IdentityModel.Services.RedirectingToIdentityProviderEventArgs.SignInRequestMessage%2A> のプロパティを通じて利用できます。  この要求は、発行者に送信する前に変更できます。  
+  
+-   WS\-FAM は、クッキーが正常に作成され、ユーザーがサインインしている場合に、<xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SignedIn> イベントを発生させます。  
+  
+-   WS\-FAM は、各ユーザーのセッションが閉じられる際に各セッションにつき 1 回 <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.SigningOut> イベントを発生させます。  セッションがクライアント側で閉じられた場合、このイベントは発生しません \(たとえば、セッション クッキーを削除するなど\)。  SSO 環境では、IP\-STS は各 RP にサインアウトするよう要求することもできます。  また、これによりこのイベントが発生し、<xref:System.IdentityModel.Services.SigningOutEventArgs.IsIPInitiated%2A> は `true` に設定されます。  
+  
+> [!NOTE]
+>  <xref:System.IdentityModel.Services.WSFederationAuthenticationModule> または <xref:System.IdentityModel.Services.SessionAuthenticationModule> により発生したイベント中は、<xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティを使用しないでください。  これは、イベントは認証プロセス中に発生するが、<xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> は認証プロセスの後に設定されるためです。  
+  
+### フェデレーション認証の構成  
+ WS\-FAM と SAM は [\<federationConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md) 要素で構成されます。  [\<wsFederation\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/wsfederation.md) の子要素は、WS\-FAM プロパティの既定値 \(<xref:System.IdentityModel.Services.WSFederationAuthenticationModule.Issuer%2A> プロパティおよび <xref:System.IdentityModel.Services.WSFederationAuthenticationModule.Realm%2A> プロパティなど\) を構成します\(これらの値は、一部の WS\-FAM イベントのハンドラーを用意することにより要求ごとに変更できます \(<xref:System.IdentityModel.Services.WSFederationAuthenticationModule.RedirectingToIdentityProvider> など\)\)。SAM で使用されるクッキー ハンドラーは [\<cookieHandler\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/cookiehandler.md) 子要素によって構成されます。  WIF には <xref:System.IdentityModel.Services.ChunkedCookieHandler> に実装されている既定のクッキー ハンドラーが用意されており、チャンク サイズは [\<chunkedCookieHandler\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/chunkedcookiehandler.md) 要素で設定できます。  `<federationConfiguration>` 要素は <xref:System.IdentityModel.Configuration.IdentityConfiguration> を参照し、この要素にはアプリケーションで使用される他の WIF コンポーネント \(<xref:System.Security.Claims.ClaimsAuthenticationManager>、<xref:System.Security.Claims.ClaimsAuthorizationManager> など\) の構成が用意されています。  ID の構成は、`<federationConfiguration>` 要素の `identityConfigurationName` 属性で [\<identityConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/identityconfiguration.md) 名前付き要素を指定することで明示的に参照できます。  ID 構成を明示的に参照しない場合、既定の ID 構成が使用されます。  
+  
+ 次の XML は、ASP.NET の証明書利用者 \(RP\) アプリケーションの構成を示します。  <xref:System.IdentityModel.Configuration.SystemIdentityModelSection> および <xref:System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection> 構成セクションは `<configSections>` 要素の下に追加されます。  SAM および WS\-FAM は、`<system.webServer>` および `<modules>` 要素の下にある HTTP モジュールに追加されます。  最後に、WIF コンポーネントは `<system.identityModel>`\/`<identityConfiguration>` および `<system.identityModel.services>`\/`<federationConfiguration>` 要素の下に構成されます。  この構成では、既定のクッキー ハンドラーであり、`<cookieHandler>` 要素で指定されたクッキー ハンドラー型ではない、チャンクされたクッキー ハンドラーを指定します。  
+  
+> [!WARNING]
+>  次の例では、`<wsFederation>` 要素の `requireHttps` 属性と `<cookieHandler>` 要素の `requireSsl` 属性は `false` です。  これは、セキュリティ上の脅威になる可能性があります。  稼働環境では、これらの値は両方とも `true` に設定する必要があります。  
+  
+```  
+<configuration>  
+  <configSections>  
+    <section name="system.identityModel" type="System.IdentityModel.Configuration.SystemIdentityModelSection, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+    <section name="system.identityModel.services" type="System.IdentityModel.Services.Configuration.SystemIdentityModelServicesSection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" />  
+  </configSections>  
+  
+  ...  
+  
+  <system.webServer>  
+    <modules>  
+      <add name="WSFederationAuthenticationModule" type="System.IdentityModel.Services.WSFederationAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />  
+      <add name="SessionAuthenticationModule" type="System.IdentityModel.Services.SessionAuthenticationModule, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />  
+    </modules>  
+  </system.webServer>  
+  
+  <system.identityModel>  
+    <identityConfiguration>  
+      <audienceUris>  
+        <add value="http://localhost:50969/" />  
+      </audienceUris>  
+      <certificateValidation certificateValidationMode="None" />  
+      <issuerNameRegistry type="System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+        <trustedIssuers>  
+          <add thumbprint="9B74CB2F320F7AAFC156E1252270B1DC01EF40D0" name="LocalSTS" />  
+        </trustedIssuers>  
+      </issuerNameRegistry>  
+    </identityConfiguration>  
+  </system.identityModel>  
+  <system.identityModel.services>  
+    <federationConfiguration>  
+      <wsFederation passiveRedirectEnabled="true" issuer="http://localhost:15839/wsFederationSTS/Issue" realm="http://localhost:50969/" reply="http://localhost:50969/" requireHttps="false" />  
+      <cookieHandler requireSsl="false" />  
+    </federationConfiguration>  
+  </system.identityModel.services>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.IdentityModel.Services.SessionAuthenticationModule>   
+ <xref:System.IdentityModel.Services.WSFederationAuthenticationModule>   
+ [\<federationConfiguration\>](../../../docs/framework/configure-apps/file-schema/windows-identity-foundation/federationconfiguration.md)
\ No newline at end of file
diff --git a/docs/framework/security/wstrustchannelfactory-and-wstrustchannel.md b/docs/framework/security/wstrustchannelfactory-and-wstrustchannel.md
new file mode 100644
index 00000000000..1d909e5bd17
--- /dev/null
+++ b/docs/framework/security/wstrustchannelfactory-and-wstrustchannel.md
@@ -0,0 +1,108 @@
+---
+title: "WSTrustChannelFactory および WSTrustChannel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96cec467-e963-4132-b18b-7d0b3a2e979f
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# WSTrustChannelFactory および WSTrustChannel
+Windows Communication Foundation \(WCF\) をよくご存じの方は、WCF クライアントが既にフェデレーションに対応していることを理解されていると思います。  <xref:System.ServiceModel.WSFederationHttpBinding> または同様のカスタム バインドを使用して WCF クライアントを構成することで、サービスに対するフェデレーション認証を有効にすることができます。  
+  
+ WCF は、背後でセキュリティ トークン サービス \(STS\) によって発行されるトークンを取得し、このトークンを使用してサービスに対する認証を行います。  この方法の主要な制限は、クライアントのサーバーとの通信に可視性がないことです。  WCF は、バインドの発行済みトークンのパラメーターに基づいて、STS へのセキュリティ トークン要求 \(RST\) を自動的に生成します。  つまり、クライアントは、要求ごとに RST パラメーターを変更したり、表示クレームなどの情報を取得するためにセキュリティ トークン要求に対する応答 \(RSTR\) を調べたりできません。また、トークンを後で使用できるようにキャッシュできません。  
+  
+ 現在、WCF クライアントは基本的なフェデレーション シナリオに適しています。  ただし、Windows Identity Foundation \(WIF\) によってサポートされる主要なシナリオの 1 つでは、WCF で簡単に実現できないレベルで RST を制御する必要があります。  このため、WIF には、STS との通信をより細かく制御できる機能が追加されています。  
+  
+ WIF は、次のフェデレーション シナリオをサポートします。  
+  
+-   WIF の依存関係のない WCF クライアントを使用して、フェデレーション サービスに対して認証を行う。  
+  
+-   WCF クライアントで WIF を有効にして、ActAs 要素または OnBehalfOf 要素を STS への RST に挿入する。  
+  
+-   WIF を単独で使用して、STS からトークンを取得し、WCF クライアントがこのトークンを使用して認証できるようにする。  詳細については、[ClaimsAwareWebService](http://go.microsoft.com/fwlink/?LinkID=248406) サンプルを参照してください。  
+  
+ 最初のシナリオは明快であるため、改めて説明しません。既存の WCF クライアントは、引き続き WIF 証明書利用者および STS と動作します。  このトピックでは、残りの 2 つのシナリオについて説明します。  
+  
+## ActAs または OnBehalfOf を使用した既存の WCF クライアントの拡張  
+ 一般的な ID 委任シナリオでは、クライアントは、中間層サービスを呼び出します。この中間層サービスによって、バックエンド サービスが呼び出されます。  中間層サービスは、クライアントとして、またはクライアントの代わりに機能します。  
+  
+> [!TIP]
+>  ActAs と OnBehalfOf の違い  
+>   
+>  WS\-Trust プロトコルの観点から:  
+>   
+>  1.  ActAs RST 要素は、要求元が 2 つの個別のエンティティに関するクレームを含んだトークンを要求していることを示します。それは、要求元と、ActAs 要素内のトークンによって表される外部エンティティです。  
+> 2.  OnBehalfOf RST 要素は、要求元が 1 つのエンティティに関するクレームだけを含んだトークンを要求していることを示します。それは、OnBehalfOf 要素内のトークンによって表される外部エンティティです。  
+>   
+>  ActAs 機能は、通常、発行されたトークンの最終受信者が委任チェーン全体を調べて、クライアントだけでなく、すべての中継者を参照できる複合委任を必要とするシナリオで使用されます。  これにより、最終受信者は、ID 委任チェーン全体に基づいてアクセス制御、監査、その他の関連アクティビティを実行できます。  ActAs 機能は、アプリケーション層\/ビジネス ロジック層で ID に関する情報を渡さずに、層間で ID に関する情報を認証して渡すために多階層システムでよく使用されます。  
+>   
+>  OnBehalfOf 機能は、元のクライアントの ID のみが重要であるシナリオで使用されます。この機能は、Windows で使用できる ID 偽装機能と実質的に同じです。  OnBehalfOf を使用すると、発行されたトークンの最終受信者は、元のクライアントに関するクレームのみを参照できます。中継者に関する情報は保持されません。  OnBehalfOf 機能が使用される一般的なパターンの 1 つは、クライアントが STS に直接アクセスできず、代わりにプロキシ ゲートウェイを経由して通信するプロキシ パターンです。  プロキシ ゲートウェイは、呼び出し元を認証し、RST メッセージの OnBehalfOf 要素に呼び出し元に関する情報を格納します。そのメッセージは、実際の STS に送信され、処理されます。  生成されるトークンには、プロキシのクライアントに関連するクレームだけが含まれるので、プロキシは、発行されたトークンの受信者にとって完全に透過的に機能します。WIF では、\<wsse:SecurityTokenReference\> または \<wsa:EndpointReferences\> を \<wst:OnBehalfOf\> の子としてサポートしていません。  WS\-Trust の仕様では、\(プロキシが代理を務めている\) 元の要求元を識別する方法が 3 つ用意されています。  これらの数値は、次のとおりです。  
+>   
+>  -   セキュリティ トークンの参照。  メッセージに含まれるトークンまたはアウトオブバンドで取得される可能性があるトークンへの参照。  
+> -   エンドポイント参照。  アウトオブバンドでデータを再度検索するためにキーとして使用されます。  
+> -   セキュリティ トークン。  元の要求元を直接識別します。  
+>   
+>  WIF では、\<wst:OnBehalfOf\> の直接の子要素として、\(暗号化されたまたは暗号化されていない\) セキュリティ トークンをサポートします。  
+  
+ この情報は、RST の ActAs トークン要素と OnBehalfOf トークン要素を使用して WS\-Trust 発行者に伝達されます。  
+  
+ WCF では、任意の XML 要素を RST に追加できる、バインドの機能拡張ポイントを公開しています。  ただし、機能拡張ポイントはバインドに関連付けられているため、呼び出しごとに RST の内容を変更する必要があるシナリオでは、呼び出しごとにクライアントを再作成する必要があります。この場合、パフォーマンスが低下します。  WIF では、`ChannelFactory` クラスの拡張メソッドを使用して、アウトオブバンドで取得した任意のトークンを開発者が RST に添付できるようにします。  次のコード例では、クライアント \(X.509、ユーザー名、SAML \(Security Assertion Markup Language\) トークンなど\) を表すトークンを取得し、発行者に送信される RST にそれを添付する方法を示します。  
+  
+```  
+IHelloService serviceChannel = channelFactory.CreateChannelActingAs<IHelloService>( clientSamlToken );  
+serviceChannel.Hello(“Hi!”);  
+```  
+  
+ WIF には次のような利点があります。  
+  
+-   RST をチャネルごとに変更できます。したがって、中間層サービスは、各クライアントのチャネル ファクトリを再作成する必要がないので、パフォーマンスが向上します。  
+  
+-   既存の WCF クライアントと動作するので、ID 委任セマンティクスを有効にする必要がある既存の WCF 中間層サービスの簡単なアップグレード パスとなります。  
+  
+ ただし、それでもクライアントの STS との通信に可視性はありません。  3 番目のシナリオでは、これについて説明します。  
+  
+## 発行者との直接通信および発行されたトークンを使った認証  
+ 一部の高度なシナリオでは、WCF クライアントを拡張するだけでは十分ではありません。  WCF だけを使用する開発者は、通常、Message In\/Message Out コントラクトを使用し、発行者の応答のクライアント側解析を手動で処理します。  
+  
+ WIF には、クライアントが WS\-Trust 発行者と直接通信できる <xref:System.ServiceModel.Security.WSTrustChannelFactory> クラスと <xref:System.ServiceModel.Security.WSTrustChannel> クラスが用意されています。  次のコード例に示すように、<xref:System.ServiceModel.Security.WSTrustChannelFactory> クラスと <xref:System.ServiceModel.Security.WSTrustChannel> クラスを使用すると、厳密に型指定された RST オブジェクトと RSTR オブジェクトをクライアントと発行者の間でやり取りできます。  
+  
+```  
+WSTrustChannelFactory trustChannelFactory = new WSTrustChannelFactory( stsBinding, stsAddress );  
+WSTrustChannel channel = (WSTrustChannel) trustChannelFactory.CreateChannel();  
+RequestSecurityToken rst = new RequestSecurityToken(RequestTypes.Issue);  
+rst.AppliesTo = new EndpointAddress(serviceAddress);  
+RequestSecurityTokenResponse rstr = null;  
+SecurityToken token = channel.Issue(rst, out rstr);  
+```  
+  
+ <xref:System.ServiceModel.Security.WSTrustChannel.Issue%2A> メソッドで `out` パラメーターを指定することで、クライアント側で検査するために RSTR にアクセスできます。  
+  
+ ここまでは、トークンの取得方法だけを説明しました。  <xref:System.ServiceModel.Security.WSTrustChannel> オブジェクトから返されるトークンは、証明書利用者に対して認証を行うために必要な情報がすべて格納された `GenericXmlSecurityToken` オブジェクトです。  次のコード例では、このトークンを使用する方法を示します。  
+  
+```  
+IHelloService serviceChannel = channelFactory.CreateChannelWithIssuedToken<IHelloService>( token ); serviceChannel.Hello(“Hi!”);  
+```  
+  
+ `ChannelFactory` オブジェクトの <xref:System.ServiceModel.ChannelFactory%601.CreateChannelWithIssuedToken%2A> 拡張メソッドは、トークンをアウトオブバンドで取得したこと、発行者に対する通常の WCF 呼び出しを停止して、代わりに取得したトークンを使用して証明書利用者に対して認証を行う必要があることを WIF に示します。  これには、次のような利点があります。  
+  
+-   トークン発行プロセスを完全に制御できます。  
+  
+-   送信 RST で ActAs または OnBehalfOf のプロパティを直接設定することで、ActAs または OnBehalfOf のシナリオをサポートします。  
+  
+-   動的なクライアント側の信頼の決定を RSTR の内容に基づいて行うことができます。  
+  
+-   <xref:System.ServiceModel.Security.WSTrustChannel.Issue%2A> メソッドから返されたトークンをキャッシュして再利用できます。  
+  
+-   <xref:System.ServiceModel.Security.WSTrustChannelFactory> と <xref:System.ServiceModel.Security.WSTrustChannel> により、WCF のベスト プラクティスに従ってチャネル キャッシュ、エラー、および復元のセマンティクスを制御できます。  
+  
+## 参照  
+ [WIF の機能](../../../docs/framework/security/wif-features.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/TOC.md b/docs/framework/serialization/TOC.md
new file mode 100644
index 00000000000..3ffaa8632b3
--- /dev/null
+++ b/docs/framework/serialization/TOC.md
@@ -0,0 +1,44 @@
+# [XML シリアル化の例](examples-of-xml-serialization.md)
+# [値渡しによるマーシャリング](marshal-by-value.md)
+# [シリアル化のガイドライン](serialization-guidelines.md)
+# [シリアル化の概念](serialization-concepts.md)
+# [基本的なシリアル化](basic-serialization.md)
+# [<xmlSerializer> 要素](xmlserializer-element.md)
+# [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](how-to-override-encoded-soap-xml-serialization.md)
+# [Web サービス ジェネリック シリアル化の技術サンプル](web-services-generics-serialization-technology-sample.md)
+# [XML シリアライザー ジェネレーター ツール (Sgen.exe)](xml-serializer-generator-tool-sgen-exe.md)
+# [方法 : 派生クラスのシリアル化を制御する](how-to-control-serialization-of-derived-classes.md)
+# [<xmlSchemaImporterExtensions> の <add> 要素](add-element-for-xmlschemaimporterextensions.md)
+# [バージョン トレラントなシリアル化](version-tolerant-serialization.md)
+# [永続ストレージ](persistent-storage.md)
+# [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)
+# [XML スキーマ定義ツール (Xsd.exe)](xml-schema-definition-tool-xsd-exe.md)
+# [XML Web サービスを使用した XML シリアル化](xml-serialization-with-xml-web-services.md)
+# [方法 : オブジェクトをシリアル化する](how-to-serialize-an-object.md)
+# [基本的なシリアル化の技術サンプル](basic-serialization-technology-sample.md)
+# [XmlSerializer によるカスタム シリアル化順序](custom-serialization-order-with-xmlserializer.md)
+# [エンコード済み SOAP シリアル化を制御する属性](attributes-that-control-encoded-soap-serialization.md)
+# [<dateTimeSerialization> 要素](datetimeserialization-element.md)
+# [XML シリアル化の概要](introducing-xml-serialization.md)
+# [XML シリアル化および SOAP シリアル化](xml-and-soap-serialization.md)
+# [シリアル化のサンプル](serialization-samples.md)
+# [方法 : XML ストリームの代替要素名を指定する](how-to-specify-an-alternate-element-name-for-an-xml-stream.md)
+# [シリアル化ツール](serialization-tools.md)
+# [方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する](xml-schema-def-tool-gen.md)
+# [シリアル化](index.md)
+# [シリアル化プロセスの手順](steps-in-the-serialization-process.md)
+# [属性を使用した XML シリアル化の制御](controlling-xml-serialization-using-attributes.md)
+# [シリアル化に関する「方法」トピック](serialization-how-to-topics.md)
+# [<schemaImporterExtensions> 要素](schemaimporterextensions-element.md)
+# [方法 : XML 要素および XML 属性名を修飾する](how-to-qualify-xml-element-and-xml-attribute-names.md)
+# [XML シリアル化を制御する属性](attributes-that-control-xml-serialization.md)
+# [SchemaImporterExtension の技術サンプル](schemaimporterextension-technology-sample.md)
+# [<system.xml.serialization> 要素](system-xml-serialization-element.md)
+# [XML スキーマ定義ツールと XML シリアル化](the-xml-schema-definition-tool-and-xml-serialization.md)
+# [選択的シリアル化](selective-serialization.md)
+# [バイナリ シリアル化](binary-serialization.md)
+# [バージョン間の耐性があるシリアル化に対応する技術サンプル](version-tolerant-serialization-technology-sample.md)
+# [方法 : オブジェクトを逆シリアル化する](how-to-deserialize-an-object.md)
+# [方法 : シリアル化されたデータをチャンクする](how-to-chunk-serialized-data.md)
+# [カスタムのシリアル化](custom-serialization.md)
+# [Web サービス IXmlSerializable の技術サンプル](web-services-ixmlserializable-technology-sample.md)
diff --git a/docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md b/docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md
new file mode 100644
index 00000000000..614e9a8b113
--- /dev/null
+++ b/docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md
@@ -0,0 +1,75 @@
+---
+title: "&lt;xmlSchemaImporterExtensions&gt; の &lt;add&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<xmlSchemaImporterExtensions> 要素の <add> 要素"
+  - "XML シリアル化, 構成"
+ms.assetid: c828a558-094b-441e-9065-790b87315fa0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;xmlSchemaImporterExtensions&gt; の &lt;add&gt; 要素
+XSD 型を .NET Framework 型に対応付けるために、<xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を追加します。  構成ファイルの詳細については、「[構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)」を参照してください。  
+  
+ \<XmlSchemaImporterExtensions\>  
+\<add\>  
+  
+## 構文  
+  
+```  
+  
+<add name = "typeName" type="fully qualified type [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|**name**|インスタンスの検索に使用される簡易名。|  
+|**type**|必ず指定します。  追加するスキーマ拡張クラスを指定します。  **type** 属性の値は 1 行で指定し、完全修飾型名を含める必要があります。  アセンブリをグローバル アセンブリ キャッシュ \(GAC: Global Assembly Cache\) に配置する場合は、バージョン、カルチャ、およびアセンブリの署名に使用した公開キーのトークンも含める必要があります。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|\<xmlSchemaImporterExtensions\>|<xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型が含まれます。|  
+  
+## 使用例  
+ 型を対応付けるときに XmlSchemaImporter が使用できる拡張の型を追加するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.xml.serialization>  
+    <xmlSchemaImporterExtensions>  
+       <add name="contoso" type="System.Web.Mobile.MobileCapabilities,   
+       System.Web.Mobile, Version=2.0.0.0, Culture=neutral,   
+       PublicKeyToken=b03f5f7f11d50a3a" />   
+    </xmlSchemaImporterExtensions>  
+  </system.xml.serialization>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Xml.Serialization.XmlSchemaImporter>   
+ [\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)   
+ [\<schemaImporterExtensions\> 要素](../../../docs/framework/serialization/schemaimporterextensions-element.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md b/docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md
new file mode 100644
index 00000000000..25a754ac820
--- /dev/null
+++ b/docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md
@@ -0,0 +1,51 @@
+---
+title: "エンコード済み SOAP シリアル化を制御する属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性 [.NET Framework], XML シリアル化"
+  - "シリアル化, 属性"
+  - "SOAP, XML シリアル化"
+  - "XML シリアル化, 属性"
+  - "XML シリアル化, SOAP"
+ms.assetid: 93ee258c-9c0f-4a08-897c-c10db7a00f91
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# エンコード済み SOAP シリアル化を制御する属性
+W3C \(World Wide Web Consortium\) \(www.w3.org\) のドキュメント『Simple Object Access Protocol \(SOAP\) 1.1』には、SOAP パラメーターのエンコード方法について説明したオプションのセクション \(セクション 5\) が含まれています。このセクション 5 の仕様に準拠するには、[System.Xml.Serialization](frlrfSystemXmlSerialization) 名前空間で指定されている特殊な属性のセットを使用する必要があります。これらの属性をクラスやクラスのメンバーに適宜適用し、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) を使用して、クラスのインスタンスをシリアル化します。  
+  
+ これらの属性、およびその適用対象と機能を次の表に示します。これらの属性を使用して XML シリアル化を制御する方法の詳細については、「[方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)」および「[方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)」を参照してください。  
+  
+ 属性の詳細については、「[属性](../../../docs/standard/attributes/index.md)」を参照してください。  
+  
+|属性|対象|機能|  
+|--------|--------|--------|  
+|[SoapAttributeAttribute](frlrfSystemXmlSerializationSoapAttributeAttributeClassTopic)|パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|クラス メンバーを XML 属性としてシリアル化します。|  
+|[SoapElementAttribute](frlrfSystemXmlSerializationSoapElementAttributeClassTopic)|パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|クラスを XML 要素としてシリアル化します。|  
+|[SoapEnumAttribute](frlrfSystemXmlSerializationSoapEnumAttributeClassTopic)|列挙体識別子であるパブリック フィールド|列挙体のメンバーの要素名を指定します。|  
+|[SoapIgnoreAttribute](frlrfSystemXmlSerializationSoapIgnoreAttributeClassTopic)|パブリック プロパティとパブリック フィールド|クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。|  
+|[SoapIncludeAttribute](frlrfSystemXmlSerializationSoapIncludeAttributeClassTopic)|パブリック派生クラス宣言、およびパブリック メソッド \(Web サービス記述言語 \(WSDL: Web Service Description Language\) ドキュメント用\)|シリアル化時に認識されるように、スキーマの生成時にその型を対象に含めます。|  
+|[SoapTypeAttribute](frlrfSystemXmlSerializationSoapTypeAttributeClassTopic)|パブリック クラス宣言|クラスを XML 型としてシリアル化します。|  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)   
+ [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)   
+ [属性](../../../docs/standard/attributes/index.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/attributes-that-control-xml-serialization.md b/docs/framework/serialization/attributes-that-control-xml-serialization.md
new file mode 100644
index 00000000000..99c196452b4
--- /dev/null
+++ b/docs/framework/serialization/attributes-that-control-xml-serialization.md
@@ -0,0 +1,62 @@
+---
+title: "XML シリアル化を制御する属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性 [.NET Framework], XML シリアル化"
+  - "クラス, シリアル化"
+  - "シリアル化, 属性"
+  - "XML スキーマ, シリアル化"
+  - "XML シリアル化, 属性"
+  - "XmlSerializer クラス, シリアル化"
+ms.assetid: 414b820f-a696-4206-b576-2711d85490c7
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# XML シリアル化を制御する属性
+次の表に示す属性をクラスおよびクラス メンバーに適用すると、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) がそのクラスのインスタンスをシリアル化または逆シリアル化する方法を制御できます。これらの属性で XML シリアル化を制御する方法については、「[属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)」を参照してください。  
+  
+ また、これらの属性を使用して、XML Web サービスによって生成されるリテラル スタイルの SOAP メッセージを制御することもできます。これらの属性を XML Web サービス メソッドに適用する方法の詳細については、「[XML Web サービスを使用した XML シリアル化](../../../docs/framework/serialization/xml-serialization-with-xml-web-services.md)」を参照してください。  
+  
+ 属性の詳細については、「[属性](../../../docs/standard/attributes/index.md)」を参照してください。  
+  
+|属性|対象|機能|  
+|--------|--------|--------|  
+|[XmlAnyAttributeAttribute](frlrfSystemXmlSerializationXmlAnyAttributeAttributeClassTopic)|[XmlAttribute](frlrfSystemXmlXmlAttributeClassTopic) オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|逆シリアル化時に、スキーマで未定義のすべての XML 属性を表す [XmlAttribute](frlrfSystemXmlXmlAttributeClassTopic) オブジェクトを配列に挿入します。|  
+|[XmlAnyElementAttribute](frlrfSystemXmlSerializationXmlAnyElementAttributeClassTopic)|[XmlElement](frlrfSystemXmlXmlElementClassTopic) オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|逆シリアル化時に、スキーマで未定義のすべての XML 要素を表す [XmlElement](frlrfSystemXmlXmlElementClassTopic) オブジェクトを配列に挿入します。|  
+|[XmlArrayAttribute](frlrfSystemXmlSerializationXmlArrayAttributeClassTopic)|複合オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|配列のメンバーを XML 配列のメンバーとして生成します。|  
+|[XmlArrayItemAttribute](frlrfSystemXmlSerializationXmlArrayItemAttributeClassTopic)|複合オブジェクトの配列を返すパブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|配列に挿入できる派生型を指定します。通常、[XmlArrayAttribute](frlrfSystemXmlSerializationXmlArrayAttributeClassTopic) と共に適用されます。|  
+|[XmlAttributeAttribute](frlrfSystemXmlSerializationXmlAttributeAttributeClassTopic)|パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|メンバーを XML 属性としてシリアル化します。|  
+|[XmlChoiceIdentifierAttribute](frlrfSystemXmlSerializationXmlChoiceIdentifierAttributeClassTopic)|パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|列挙体を使用して、メンバーを明確に区別できるようにします。|  
+|[XmlElementAttribute](frlrfSystemXmlSerializationXmlElementAttributeClassTopic)|パブリック フィールド、パブリック プロパティ、パブリック パラメーター、または戻り値|フィールドまたはプロパティを XML 要素としてシリアル化します。|  
+|[XmlEnumAttribute](frlrfSystemXmlSerializationXmlEnumAttributeClassTopic)|列挙体識別子であるパブリック フィールド|列挙体のメンバーの要素名を指定します。|  
+|[XmlIgnoreAttribute](frlrfSystemXmlSerializationXmlIgnoreAttributeClassTopic)|パブリック プロパティとパブリック フィールド|クラスのシリアル化時に、そのクラスに含まれているプロパティまたはフィールドを無視します。|  
+|[XmlIncludeAttribute](frlrfSystemXmlSerializationXmlIncludeAttributeClassTopic)|パブリック派生クラス宣言、およびパブリック メソッドの戻り値 \(Web サービス記述言語 \(WSDL: Web Service Description Language\) ドキュメント用\)|シリアル化されたときにクラスが認識されるように、スキーマの生成時にそのクラスを対象に含めます。|  
+|[XmlRootAttribute](frlrfSystemXmlSerializationXmlRootAttributeClassTopic)|パブリック クラス宣言|属性ターゲットを XML ルート要素として XML シリアル化する方法を制御します。この属性を使用して、さらに名前空間と要素名を指定できます。|  
+|[XmlTextAttribute](frlrfSystemXmlSerializationXmlTextAttributeClassTopic)|パブリック プロパティとパブリック フィールド|プロパティまたはフィールドを XML テキストとしてシリアル化します。|  
+|[XmlTypeAttribute](frlrfSystemXmlSerializationXmlTypeAttributeClassTopic)|パブリック クラス宣言|XML 型の名前および名前空間を指定します。|  
+  
+ [System.Xml.Serialization](frlrfSystemxmlserialization) 名前空間にあるこれらの属性の他に、[System.ComponentModel.DefaultValueAttribute](frlrfSystemComponentModelDefaultValueAttributeClassTopic) 属性もフィールドに適用できます。**DefaultValueAttribute** は、メンバーの値が指定されていない場合に、メンバーに自動的に割り当てられる値を設定します。  
+  
+ エンコード済みの SOAP XML シリアル化を制御する方法については、「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」を参照してください。  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)   
+ [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/basic-serialization-technology-sample.md b/docs/framework/serialization/basic-serialization-technology-sample.md
new file mode 100644
index 00000000000..e123ab2541c
--- /dev/null
+++ b/docs/framework/serialization/basic-serialization-technology-sample.md
@@ -0,0 +1,104 @@
+---
+title: "基本的なシリアル化の技術サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d824e16-08d1-4a36-bc7f-2388c1f75f34
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 基本的なシリアル化の技術サンプル
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Runtime%20Serialization/Basic.zip.exe)  
+  
+ このサンプルでは、メモリ内のオブジェクト グラフをシリアル化してストリームに変換する、共通言語ランタイムの機能の例を示します。このサンプルでは、<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> または <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> のいずれかを使用して、シリアル化を行います。データを格納したリンク リストは、ファイル ストリームとの間でシリアル化または逆シリアル化されます。いずれの場合でも、リストが表示されるので、結果を参照できます。このリンク リストは `LinkedList` の一種で、このサンプルで定義してある型です。  
+  
+ シリアル化の詳細については、ソース コード ファイルおよび build.proj ファイル内のコメントを参照してください。  
+  
+### コマンド プロンプトを使用してサンプルをビルドするには  
+  
+1.  コマンド プロンプトを使用して、Technologies\\Serialization\\Runtime Serialization\\Basic ディレクトリにある、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  使用しているプログラミング言語に応じて、コマンド ラインで、「**msbuild SerializationCS.sln**」、「**msbuild SerializationJSL.sln**」、または「**msbuild SerializationVB.sln**」と入力します。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、サンプルが格納されている、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  使用しているプログラミング言語に応じて、SerializationCS.sln ファイル、SerializationJSL.sln ファイル、または SerializationVB.sln ファイルのアイコンをダブルクリックして、このファイルを Visual Studio で開きます。  
+  
+3.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+ サンプル アプリケーションは、既定の \\bin サブディレクトリまたは \\bin\\Debug サブディレクトリにビルドされます。  
+  
+### サンプルを実行するには  
+  
+1.  ビルドした実行可能ファイルが格納されているディレクトリに移動します。  
+  
+2.  コマンド ラインで、「**Serialization.exe**」と入力し、任意のパラメーター値を指定します。  
+  
+    > [!NOTE]
+    >  このサンプルでは、コンソール アプリケーションをビルドします。出力を表示するには、コマンド プロンプトでこれを実行する必要があります。  
+  
+## 解説  
+ このサンプル アプリケーションは、実行するテストを示すコマンド ライン パラメーターを受け取ります。SOAP フォーマッタを使用して、ノード数 10 個のリストを **Test.xml** というファイルにシリアル化するには、「**sx Test.xml 10**」というパラメーターを使用します。  
+  
+ たとえば、次のように入力します。  
+  
+ **Serialize.exe \-sx Test.xml 10**  
+  
+ 前例の **Test.xml** ファイルを逆シリアル化するには、「**dx Test.xml**」というパラメーターを使用します。  
+  
+ たとえば、次のように入力します。  
+  
+ **Serialize.exe \-dx Test.xml**  
+  
+ 上の 2 つの例で、コマンド ライン スイッチに指定した "x" は、XML SOAP シリアル化を行うことを示しています。バイナリ シリアル化を使用するには、代わりに "b" を使用します。ノード数が非常に多いデータをシリアル化する場合は、コンソール出力をファイルにリダイレクトすると便利です。  
+  
+ たとえば、次のように入力します。  
+  
+ **Serialize.exe \-sb Test.bin 10000 \>somefile.txt**  
+  
+ このサンプルで使用するクラスと技術についての簡単な説明を、以下に箇条書きします。  
+  
+-   ランタイム シリアル化  
+  
+    -   <xref:System.Runtime.Serialization.IFormatter> は、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> オブジェクトまたは <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> オブジェクトを参照するために使用します。  
+  
+    -   <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> は、リンク リストをバイナリ形式のストリームにシリアル化するために使用します。バイナリ フォーマッタでは、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> 型でのみ理解できる形式を使用します。ただし、データは簡潔です。  
+  
+    -   <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> は、リンク リストを SOAP 形式のストリームにシリアル化するために使用します。SOAP は標準の形式です。  
+  
+-   ストリーム入出力  
+  
+    -   <xref:System.IO.Stream> は、シリアル化および逆シリアル化に使用します。このサンプルで使用する特有のストリーム型として、<xref:System.IO.FileStream> 型があります。ただし、シリアル化は、<xref:System.IO.Stream> から派生する任意の型で行うことができます。  
+  
+    -   <xref:System.IO.File> は、ディスク上のファイルを読み込み、作成するための <xref:System.IO.FileStream> オブジェクトを作成するために使用します。  
+  
+    -   <xref:System.IO.FileStream> は、リンク リストのシリアル化および逆シリアル化に使用します。  
+  
+## 参照  
+ [BinaryFormatter クラス](frlrfSystemRuntimeSerializationFormattersBinaryBinaryFormatterClassTopic)   
+ [File クラス](frlrfSystemIOFileClassTopic)   
+ [FileStream クラス](frlrfSystemIOFileStreamClassTopic)   
+ [IFormatter インターフェイス](frlrfSystemRuntimeSerializationIFormatterClassTopic)   
+ [Random クラス](https://msdn.microsoft.com/en-us/library/system.random.aspx)   
+ [SerializableAttribute 属性](frlrfSystemSerializableAttributeClassTopic)   
+ [SoapFormatter クラス](frlrfSystemRuntimeSerializationFormattersSoapSoapFormatterClassTopic)   
+ [Stream クラス](frlrfSystemIOStreamClassTopic)   
+ [System.IO 名前空間](https://msdn.microsoft.com/en-us/library/system.io.aspx)   
+ [System.Runtime.Serialization 名前空間](frlrfSystemRuntimeSerialization)   
+ [System.Xml.Serialization 名前空間](frlrfSystemXmlSerialization)   
+ [基本的なシリアル化](../../../docs/framework/serialization/basic-serialization.md)   
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [シリアル化](../../../docs/framework/serialization/index.md)   
+ [SOAP Service](http://msdn.microsoft.com/ja-jp/2051c992-28d1-499e-961f-17e9b675cec9)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/basic-serialization.md b/docs/framework/serialization/basic-serialization.md
new file mode 100644
index 00000000000..c640d9de91a
--- /dev/null
+++ b/docs/framework/serialization/basic-serialization.md
@@ -0,0 +1,105 @@
+---
+title: "基本的なシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 基本的なシリアル化"
+  - "シリアル化, 基本的なシリアル化"
+ms.assetid: d899d43c-335a-433e-a589-cd187192984f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 基本的なシリアル化
+クラスをシリアル化できるようにするための最も簡単な方法は、次に示すように [Serializable](frlrfSystemSerializableAttributeClassTopic) 属性でマークすることです。  
+  
+```csharp  
+[Serializable]  
+public class MyObject {  
+  public int n1 = 0;  
+  public int n2 = 0;  
+  public String str = null;  
+}  
+```  
+  
+ このクラスのインスタンスをファイルにシリアル化する方法を、次のコード例に示します。  
+  
+```csharp  
+MyObject obj = new MyObject();  
+obj.n1 = 1;  
+obj.n2 = 24;  
+obj.str = "Some String";  
+IFormatter formatter = new BinaryFormatter();  
+Stream stream = new FileStream("MyFile.bin", FileMode.Create, FileAccess.Write, FileShare.None);  
+formatter.Serialize(stream, obj);  
+stream.Close();  
+```  
+  
+ この例では、バイナリ フォーマッタを使用してシリアル化します。必要な作業は、使用するストリームのインスタンスとフォーマッタを作成し、フォーマッタで **Serialize** メソッドを呼び出すことだけです。ストリームとシリアル化するオブジェクトを、この呼び出しのパラメーターとして指定します。この例では明示的に示されていませんが、クラスのすべてのメンバー変数は、変数がプライベートとして指定されている場合でもシリアル化されます。この点で、バイナリ シリアル化は、パブリック フィールドのみをシリアル化する [XMLSerializer クラス](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)とは異なります。バイナリ シリアル化からメンバー変数を除外する方法については、「[選択的シリアル化](../../../docs/framework/serialization/selective-serialization.md)」を参照してください。  
+  
+ オブジェクトを元の状態に復元することも、同じように簡単にできます。最初に、読み取るストリームと[フォーマッタ](frlrfSystemRuntimeSerializationFormatterClassTopic)を作成してから、フォーマッタに対してオブジェクトの逆シリアル化を指示します。この処理を行うコード例を次に示します。  
+  
+```csharp  
+IFormatter formatter = new BinaryFormatter();  
+Stream stream = new FileStream("MyFile.bin", FileMode.Open, FileAccess.Read, FileShare.Read);  
+MyObject obj = (MyObject) formatter.Deserialize(stream);  
+stream.Close();  
+  
+// Here's the proof.  
+Console.WriteLine("n1: {0}", obj.n1);  
+Console.WriteLine("n2: {0}", obj.n2);  
+Console.WriteLine("str: {0}", obj.str);  
+```  
+  
+ 前の例で使用している [BinaryFormatter](frlrfSystemRuntimeSerializationFormattersBinaryBinaryFormatterClassTopic) は効率的であり、コンパクトなバイト ストリームを生成します。このフォーマッタでシリアル化されたすべてのオブジェクトは、同じフォーマッタで逆シリアル化することもできるため、これは .NET Framework で逆シリアル化されるオブジェクトをシリアル化するための最適なツールです。オブジェクトの逆シリアル化中は、コンストラクターが呼び出されないことに注意してください。パフォーマンス上の理由から、逆シリアル化に対してこの制約が設けられています。ただし、この制約はランタイムがオブジェクト作成者と結ぶ通常の協定の一部に違反するため、開発者は、オブジェクトをシリアル化可能としてマークするときに生じる影響を理解する必要があります。  
+  
+ 移植性が必要な場合には、代わりに [SoapFormatter](frlrfSystemRuntimeSerializationFormattersSoapSoapFormatterClassTopic) を使用します。その場合は、コード内の **BinaryFormatter** を **SoapFormatter** に置き換え、前のコードと同様に **Serialize** および **Deserialize** を呼び出します。前の例では、このフォーマッタの出力は、次のようになります。  
+  
+```  
+<SOAP-ENV:Envelope  
+  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
+  xmlns:xsd="http://www.w3.org/2001/XMLSchema"   
+  xmlns:SOAP- ENC="http://schemas.xmlsoap.org/soap/encoding/"  
+  xmlns:SOAP- ENV="http://schemas.xmlsoap.org/soap/envelope/"  
+  SOAP-ENV:encodingStyle=  
+  "http://schemas.microsoft.com/soap/encoding/clr/1.0"  
+  "http://schemas.xmlsoap.org/soap/encoding/"  
+  xmlns:a1="http://schemas.microsoft.com/clr/assem/ToFile">  
+  
+  <SOAP-ENV:Body>  
+    <a1:MyObject id="ref-1">  
+      <n1>1</n1>  
+      <n2>24</n2>  
+      <str id="ref-3">Some String</str>  
+    </a1:MyObject>  
+  </SOAP-ENV:Body>  
+</SOAP-ENV:Envelope>  
+```  
+  
+ **Serializable** 属性は継承できないことに注意してください。`MyObject` から新しいクラスを派生させる場合は、その新しいクラスもこの属性でマークする必要があります。マークしないと、このクラスをシリアル化できません。たとえば、次に示すクラスのインスタンスをシリアル化しようとすると、`MyStuff` 型がシリアル化可能としてマークされていないことを通知する [SerializationException](frlrfSystemRuntimeSerializationSerializationExceptionClassTopic) が表示されます。  
+  
+```csharp  
+public class MyStuff : MyObject   
+{  
+  public int n3;  
+}  
+```  
+  
+ **Serializable** 属性を使用すると便利ですが、このような制限事項があります。クラスをコンパイルした後はシリアル化を追加できないため、シリアル化するクラスをシリアル化可能なクラスとしてマークするタイミングについては、「[シリアル化のガイドライン](../../../docs/framework/serialization/serialization-guidelines.md)」を参照してください。  
+  
+## 参照  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/binary-serialization.md b/docs/framework/serialization/binary-serialization.md
new file mode 100644
index 00000000000..ad2028dfa8d
--- /dev/null
+++ b/docs/framework/serialization/binary-serialization.md
@@ -0,0 +1,72 @@
+---
+title: "バイナリ シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化"
+  - "バイナリ シリアル化, シリアル化について"
+  - "逆シリアル化"
+  - "シリアル化, シリアル化について"
+ms.assetid: 2b1ea3be-1152-4032-b2b3-07794054c405
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# バイナリ シリアル化
+シリアル化は、オブジェクトの状態をストレージ メディアに格納するプロセスとして定義することができます。このプロセスの実行中に、オブジェクトのパブリックおよびプライベートなフィールドとクラス \(クラスを格納しているアセンブリを含む\) の名前がバイト ストリームに変換され、データ ストリームに書き込まれます。続いてオブジェクトが逆シリアル化され、元のオブジェクトの完全な複製が作成されます。  
+  
+ オブジェクト指向環境でシリアル化機構を実装する場合は、使いやすさと柔軟性の間での数多くのトレードオフについて考慮する必要があります。プロセスを十分に制御できる場合は、プロセスの大部分を自動化できます。たとえば、単純なバイナリ シリアル化では不十分な状況が発生する場合や、シリアル化が必要なクラス内のフィールドを決定するだけの明確な理由がある場合があります。以下のセクションでは、.NET Framework に用意されている堅牢なシリアル化機構について検討し、必要に応じてプロセスをカスタマイズするためのいくつかの重要な機能について説明します。  
+  
+> [!NOTE]
+>  オブジェクトのシリアル化と逆シリアル化を行う際に使用した .NET Framework のバージョンが異なる場合、UTF\-8 または UTF\-7 でエンコードされたオブジェクトの状態は保持されません。  
+  
+## このセクションの内容  
+ [シリアル化の概念](../../../docs/framework/serialization/serialization-concepts.md)  
+ データをストレージに永続化するシナリオと、アプリケーション ドメインを越えてオブジェクトを受け渡しするシナリオの 2 つを例として、シリアル化の有効な利用方法について説明します。  
+  
+ [基本的なシリアル化](../../../docs/framework/serialization/basic-serialization.md)  
+ バイナリ フォーマッタと SOAP フォーマッタを使用してオブジェクトをシリアル化する方法について説明します。  
+  
+ [選択的シリアル化](../../../docs/framework/serialization/selective-serialization.md)  
+ クラスの一部のメンバーがシリアル化されないようにする方法について説明します。  
+  
+ [カスタムのシリアル化](../../../docs/framework/serialization/custom-serialization.md)  
+ <xref:System.Runtime.Serialization.ISerializable> インターフェイスを使用してクラスのシリアル化をカスタマイズする方法について説明します。  
+  
+ [シリアル化プロセスの手順](../../../docs/framework/serialization/steps-in-the-serialization-process.md)  
+ フォーマッタで <xref:System.Runtime.Serialization.Formatter.Serialize%2A> メソッドを呼び出した場合のシリアル化方法について説明します。  
+  
+ [バージョン トレラントなシリアル化](../../../docs/framework/serialization/version-tolerant-serialization.md)  
+ アプリケーションに例外をスローさせることなく後から変更できる、シリアル化可能な型の作成方法について説明します。  
+  
+ [シリアル化のガイドライン](../../../docs/framework/serialization/serialization-guidelines.md)  
+ オブジェクトをシリアル化するタイミングを決定するのに役立つ、いくつかの一般的なガイドラインを示します。  
+  
+## 関連項目  
+ <xref:System.Runtime.Serialization>  
+ オブジェクトのシリアル化と逆シリアル化に使用できるクラスが含まれています。  
+  
+## 関連項目  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)  
+ 共通言語ランタイムに付属している XML シリアル化機構について説明します。  
+  
+ [セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)  
+ シリアル化を実行するコードを記述する際に従う必要がある、安全なコーディングのガイドラインについて説明します。  
+  
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)  
+ .NET Framework でリモート通信に利用できるさまざまな通信方法について説明します。  
+  
+ [XML Web Services Created Using ASP.NET and XML Web Service Clients](http://msdn.microsoft.com/ja-jp/1e64af78-d705-4384-b08d-591a45f4379c)  
+ ASP.NET を使用して作成した XML Web サービスのプログラミング方法について説明するトピックを示します。
\ No newline at end of file
diff --git a/docs/framework/serialization/controlling-xml-serialization-using-attributes.md b/docs/framework/serialization/controlling-xml-serialization-using-attributes.md
new file mode 100644
index 00000000000..4aa8f9a2d30
--- /dev/null
+++ b/docs/framework/serialization/controlling-xml-serialization-using-attributes.md
@@ -0,0 +1,333 @@
+---
+title: "属性を使用した XML シリアル化の制御 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "配列, シリアル化"
+  - "属性 [.NET Framework], XML シリアル化"
+  - "クラス, シリアル化"
+  - "派生クラス, シリアル化"
+  - "シリアル化の防止"
+  - "シリアル化, 属性"
+  - "シリアル化, 例"
+  - "XML シリアル化, 属性"
+  - "XML シリアル化, 例"
+ms.assetid: 47d4c39d-30e1-4c7b-8a2e-301325390647
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 属性を使用した XML シリアル化の制御
+属性を使用すると、オブジェクトの XML シリアル化を制御したり、同じ一連のクラスから代替 XML ストリームを作成したりできます。代替 XML ストリームの作成の詳細については、「[方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)」を参照してください。  
+  
+> [!NOTE]
+>  生成される XML が、W3C \(World Wide Web Consortium\) \(www.w3.org\) のドキュメント『Simple Object Access Protocol \(SOAP\) 1.1』のセクション 5 に準拠している必要がある場合は、「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」に記載されている属性を使用します。  
+  
+ 既定では、クラス名またはメンバー名によって XML 要素名が決まります。次の例に示すように、`Book` という名前の単純なクラスでは、`ISBN` という名前のフィールドから \<ISBN\> という XML 要素タグが生成されます。  
+  
+```vb  
+Public Class Book  
+    Public ISBN As String  
+End Class  
+' When an instance of the Book class is serialized, it might   
+' produce this XML:  
+' <ISBN>1234567890</ISBN>.  
+  
+```  
+  
+```csharp  
+public class Book  
+{  
+    public string ISBN;  
+}  
+// When an instance of the Book class is serialized, it might   
+// produce this XML:  
+// <ISBN>1234567890</ISBN>.  
+```  
+  
+ この既定の動作を変更して、要素に新しい名前を付けることもできます。次のコードでは、<xref:System.Xml.Serialization.XmlElementAttribute> の <xref:System.Xml.Serialization.XmlElementAttribute.ElementName%2A> プロパティを設定することにより、属性でこの変更を実現する方法を示します。  
+  
+```vb  
+Public Class TaxRates  
+   < XmlElement(ElementName = "TaxRate")> _  
+    Public ReturnTaxRate As Decimal  
+End Class  
+  
+```  
+  
+```csharp  
+public class TaxRates{  
+    [XmlElement(ElementName = "TaxRate")]  
+    public decimal ReturnTaxRate;  
+}  
+```  
+  
+ 属性の詳細については、「[属性](../../../docs/standard/attributes/index.md)」を参照してください。XML シリアル化を制御する属性の一覧については、「[XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)」を参照してください。  
+  
+## 配列のシリアル化の制御  
+ <xref:System.Xml.Serialization.XmlArrayAttribute> 属性および <xref:System.Xml.Serialization.XmlArrayItemAttribute> 属性は、配列のシリアル化を制御できるようにデザインされています。この 2 つの属性を使用して、要素名、名前空間、および XML スキーマ \(XSD\) データ型 \(W3C \(www.w3.org\) のドキュメント『XML Schema Part 2: Datatypes』で定義\) を制御できます。また、配列に挿入できる型も指定できます。  
+  
+ <xref:System.Xml.Serialization.XmlArrayAttribute> は、配列をシリアル化すると生成される外側の XML 要素のプロパティを決定します。たとえば、次に示す配列をシリアル化すると、既定で `Employees` という名前の XML 要素が生成されます。この `Employees` 要素は、`Employee` 配列型に基づいた名前の一連の要素で構成されます。  
+  
+```vb  
+Public Class Group  
+    Public Employees() As Employee  
+End Class  
+Public Class Employee  
+    Public Name As String  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    public Employee[] Employees;  
+}  
+public class Employee{  
+    public string Name;  
+}  
+```  
+  
+ シリアル化されたインスタンスは次のようになります。  
+  
+```  
+<Group>  
+<Employees>  
+    <Employee>  
+        <Name>Haley</Name>  
+    </Employee>  
+</Employees >  
+</Group>  
+```  
+  
+ <xref:System.Xml.Serialization.XmlArrayAttribute> を適用すると、この XML 要素の名前を次のように変更できます。  
+  
+```vb  
+Public Class Group  
+    <XmlArray("TeamMembers")> _  
+    Public Employees() As Employee  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    [XmlArray("TeamMembers")]  
+    public Employee[] Employees;  
+}  
+```  
+  
+ その結果、次のような XML が生成されます。  
+  
+```  
+<Group>  
+<TeamMembers>  
+    <Employee>  
+        <Name>Haley</Name>  
+    </Employee>  
+</TeamMembers>  
+```  
+  
+ 一方、<xref:System.Xml.Serialization.XmlArrayItemAttribute> は、配列内の項目をシリアル化する方法を制御します。この属性は、配列を返すフィールドに適用されます。  
+  
+```vb  
+Public Class Group  
+    <XmlArrayItem("MemberName")> _  
+    Public Employee() As Employees  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    [XmlArrayItem("MemberName")]  
+    public Employee[] Employees;  
+}  
+```  
+  
+ その結果、次のような XML が生成されます。  
+  
+```  
+<Group>  
+<Employees>  
+    <MemberName>Haley</MemberName>  
+</Employees>  
+</Group>  
+```  
+  
+## 派生クラスのシリアル化  
+ <xref:System.Xml.Serialization.XmlArrayItemAttribute> のもう 1 つの用途は、派生クラスをシリアル化することです。たとえば、`Employee` から派生した `Manager` という名前の別のクラスを、前の例に追加できます。<xref:System.Xml.Serialization.XmlArrayItemAttribute> を適用しないと、この派生クラス型が認識されないため、実行時にコードが失敗します。これを回避するには、この属性を 2 回適用し、受け入れ可能な各型 \(基本型と派生型\) の <xref:System.Xml.Serialization.XmlArrayItemAttribute.Type%2A> プロパティをそれぞれ設定します。  
+  
+```vb  
+Public Class Group  
+    <XmlArrayItem(Type:=GetType(Employee)), _  
+    XmlArrayItem(Type:=GetType(Manager))> _  
+    Public Employees() As Employee  
+End Class  
+Public Class Employee  
+    Public Name As String  
+End Class  
+Public Class Manager  
+Inherits Employee  
+    Public Level As Integer  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    [XmlArrayItem(Type = typeof(Employee)),  
+    XmlArrayItem(Type = typeof(Manager))]  
+    public Employee[] Employees;  
+}  
+public class Employee{  
+    public string Name;  
+}  
+public class Manager:Employee{  
+    public int Level;  
+}  
+```  
+  
+ シリアル化されたインスタンスは次のようになります。  
+  
+```  
+<Group>  
+<Employees>  
+    <Employee>  
+        <Name>Haley</Name>  
+    </Employee>  
+    <Employee xsi:type = "Manager">  
+        <Name>Ann</Name>  
+        <Level>3</Level>  
+    <Employee>  
+</Employees >  
+</Group>  
+```  
+  
+## 要素のシーケンスとしての配列のシリアル化  
+ 次の例に示すように、配列を返すフィールドに <xref:System.Xml.Serialization.XmlElementAttribute> を適用して、配列を XML 要素のフラットなシーケンスとしてシリアル化することもできます。  
+  
+```vb  
+Public Class Group  
+    <XmlElement> _  
+    Public Employees() As Employee  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    [XmlElement]  
+    public Employee[] Employees;  
+}  
+```  
+  
+ シリアル化されたインスタンスは次のようになります。  
+  
+```  
+<Group>  
+<Employees>  
+    <Name>Haley</Name>  
+</Employees>  
+<Employees>  
+    <Name>Noriko</Name>  
+</Employees>  
+<Employees>  
+    <Name>Marco</Name>  
+</Employees>  
+</Group>  
+```  
+  
+ 2 つの XML ストリームを区別するもう 1 つの方法は、XML スキーマ定義ツールを使用して、コンパイル済みのコードから XML スキーマ \(XSD\) ドキュメント ファイルを生成することです \(このツールの使用方法の詳細については、「[XML スキーマ定義ツールと XML シリアル化](../../../docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md)」を参照してください\)。フィールドに属性を適用しないと、スキーマには次のように要素が記述されます。  
+  
+```  
+<xs:element minOccurs="0" maxOccurs ="1" name="Employees" type="ArrayOfEmployee" />  
+```  
+  
+ フィールドに <xref:System.Xml.Serialization.XmlElementAttribute> を適用すると、生成されたスキーマには次のように要素が記述されます。  
+  
+```  
+<xs:element minOccurs="0" maxOccurs="unbounded" name="Employees" type="Employee" />   
+```  
+  
+## ArrayList のシリアル化  
+ <xref:System.Collections.ArrayList> クラスには、さまざまなオブジェクトのコレクションを含めることができます。このため、<xref:System.Collections.ArrayList> は配列とほとんど同じように使用できます。型指定されたオブジェクトの配列を返すフィールドを作成する代わりに、単一の <xref:System.Collections.ArrayList> を返すフィールドを作成することもできます。ただし、配列の場合と同様に、<xref:System.Collections.ArrayList> に含まれるオブジェクトの型を <xref:System.Xml.Serialization.XmlSerializer> に通知する必要があります。そのためには、次の例に示すように、<xref:System.Xml.Serialization.XmlElementAttribute> の複数のインスタンスをフィールドに割り当てます。  
+  
+```vb  
+Public Class Group  
+    <XmlElement(Type:=GetType(Employee)), _  
+    XmlElement(Type:=GetType(Manager))> _  
+    Public Info As ArrayList  
+End Class  
+  
+```  
+  
+```csharp  
+public class Group{  
+    [XmlElement(Type = typeof(Employee)),   
+    XmlElement(Type = typeof(Manager))]  
+    public ArrayList Info;  
+}  
+```  
+  
+## XmlRootAttribute と XmlTypeAttribute を使用したクラスのシリアル化の制御  
+ クラスのみに適用できる、<xref:System.Xml.Serialization.XmlRootAttribute> と <xref:System.Xml.Serialization.XmlTypeAttribute> という属性があります。この 2 つの属性は非常に似ています。<xref:System.Xml.Serialization.XmlRootAttribute> は、シリアル化されたときに XML ドキュメントの開始要素と終了要素、つまりルート要素を表す 1 つのクラスにのみ適用できます。一方 <xref:System.Xml.Serialization.XmlTypeAttribute> は、ルート クラスを含む任意のクラスに適用できます。  
+  
+ たとえば、前の例では、`Group` クラスがルート クラスであり、そのすべてのパブリック フィールドとパブリック プロパティは、XML ドキュメント内の XML 要素になります。したがって、存在するルート クラスは 1 つだけです。<xref:System.Xml.Serialization.XmlRootAttribute> を適用することで、<xref:System.Xml.Serialization.XmlSerializer> によって生成される XML ストリームを制御できます。たとえば、要素名や名前空間を変更できます。  
+  
+ <xref:System.Xml.Serialization.XmlTypeAttribute> を使用すると、生成される XML のスキーマを制御できます。この機能は、XML Web サービスを通じてスキーマを公開する必要がある場合に役立ちます。次の例では、<xref:System.Xml.Serialization.XmlTypeAttribute> と <xref:System.Xml.Serialization.XmlRootAttribute> の両方を同じクラスに適用しています。  
+  
+```vb  
+<XmlRoot("NewGroupName"), _  
+XmlType("NewTypeName")> _  
+Public Class Group  
+    Public Employees() As Employee  
+End Class  
+  
+```  
+  
+```csharp  
+[XmlRoot("NewGroupName")]  
+[XmlType("NewTypeName")]  
+public class Group{  
+    public Employee[] Employees;  
+}  
+```  
+  
+ このクラスをコンパイルし、XML スキーマ定義ツールを使用してそのスキーマを生成すると、`Group` を記述する次の XML が生成されます。  
+  
+```  
+<xs:element name="NewGroupName" type="NewTypeName">  
+```  
+  
+ これに対し、クラスのインスタンスをシリアル化した場合は、XML ドキュメントに `NewGroupName` のみが生成されます。  
+  
+```  
+<NewGroupName>  
+    . . .  
+</NewGroupName>  
+```  
+  
+## XmlIgnoreAttribute によるシリアル化の回避  
+ パブリック プロパティやパブリック フィールドをシリアル化する必要がない場合があります。たとえば、メタデータの格納に使用しているフィールドまたはプロパティの場合、<xref:System.Xml.Serialization.XmlIgnoreAttribute> を適用すると、<xref:System.Xml.Serialization.XmlSerializer> がそのフィールドまたはプロパティをスキップします。  
+  
+## 参照  
+ [XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)   
+ [エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)   
+ [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/custom-serialization-order-with-xmlserializer.md b/docs/framework/serialization/custom-serialization-order-with-xmlserializer.md
new file mode 100644
index 00000000000..27926cd39c1
--- /dev/null
+++ b/docs/framework/serialization/custom-serialization-order-with-xmlserializer.md
@@ -0,0 +1,49 @@
+---
+title: "XmlSerializer によるカスタム シリアル化順序 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 975abd20-2a1d-42db-aed3-e898025ccce7
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# XmlSerializer によるカスタム シリアル化順序
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Xml%20Serialization/CustomOrder.zip.exe)  
+  
+ このサンプルでは、XML シリアル化で、シリアル化される要素および逆シリアル化される要素の順序を制御する方法を示します。  
+  
+ シリアル化の詳細については、ソース コード ファイルおよび build.proj ファイル内のコメントを参照してください。  
+  
+### コマンド プロンプトを使用してサンプルをビルドするには  
+  
+1.  コマンド プロンプト ウィンドウを開き、サンプルの使用言語に対応するサブディレクトリに移動します。  
+  
+2.  コマンド ラインで「**msbuild CustomOrder.sln**」と入力します。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、サンプルが格納されている、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  CustomOrder.sln ファイルのアイコンをダブルクリックして、このファイルを Visual Studio で開きます。  
+  
+3.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+4.  サンプル アプリケーションは、既定の \\bin ディレクトリまたは \\bin\\Debug ディレクトリにビルドされます。  
+  
+## 参照  
+ [System.Runtime.Serialization 名前空間](frlrfSystemRuntimeSerialization)   
+ [System.Xml.Serialization 名前空間](frlrfSystemXmlSerialization)   
+ [基本的なシリアル化](../../../docs/framework/serialization/basic-serialization.md)   
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [シリアル化](../../../docs/framework/serialization/index.md)   
+ [SOAP Service](http://msdn.microsoft.com/ja-jp/2051c992-28d1-499e-961f-17e9b675cec9)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/custom-serialization.md b/docs/framework/serialization/custom-serialization.md
new file mode 100644
index 00000000000..35d324eadd7
--- /dev/null
+++ b/docs/framework/serialization/custom-serialization.md
@@ -0,0 +1,197 @@
+---
+title: "カスタムのシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 制御"
+  - "バイナリ シリアル化, カスタムのシリアル化"
+  - "カスタムのシリアル化"
+  - "ISerializable インターフェイス, カスタムのシリアル化"
+  - "OnDeserializedAttribute クラス, カスタムのシリアル化"
+  - "OnDeserializingAttribute クラス, カスタムのシリアル化"
+  - "OnSerializedAttribute クラス, カスタムのシリアル化"
+  - "OnSerializingAttribute クラス, カスタムのシリアル化"
+  - "OptionalFieldAttribute クラス, カスタムのシリアル化"
+  - "シリアル化, 制御"
+  - "シリアル化, カスタムのシリアル化"
+ms.assetid: 12ed422d-5280-49b8-9b71-a2ed129c0384
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# カスタムのシリアル化
+カスタムのシリアル化は、型のシリアル化と逆シリアル化を制御するプロセスです。シリアル化を制御することで、シリアル化の互換性を保証できます。つまり、型のコア機能を損なうことなく、1 つの型の複数のバージョン間でシリアル化および逆シリアル化を行うことができます。たとえば、最初のバージョンの型では、フィールドが 2 つだけあるとします。新しいバージョンでは、これにいくつかのフィールドが追加されています。この場合、2 番目のバージョンのアプリケーションでは、両方の型をシリアル化および逆シリアル化できる必要があります。以下のセクションでは、シリアル化の制御方法について説明します。  
+  
+> [!IMPORTANT]
+>  .NET Framework 4 よりも前のバージョンでは、部分的に信頼されたアセンブリでのカスタム ユーザー データのシリアル化は <xref:System.Exception.GetObjectData%2A> method?qualifyHint=False&autoUpgrade=True を使用して実行していました。バージョン 4.0 以降では、そのメソッドは、部分的に信頼されたアセンブリで実行できないようにする <xref:System.Security.SecurityCriticalAttribute> 属性でマークされています。この状況に対処するには、<xref:System.Runtime.Serialization.ISafeSerializationData> インターフェイスを実装します。  
+  
+## シリアル化時およびシリアル化後のカスタム メソッドの実行  
+ ベスト プラクティスかつ最も簡単な方法 \(.Net Framework Version 2.0 で導入されました\) は、シリアル化時およびシリアル化後にデータを修正するための各メソッドに、以下の属性を適用することです。  
+  
+-   <xref:System.Runtime.Serialization.OnDeserializedAttribute>  
+  
+-   <xref:System.Runtime.Serialization.OnDeserializingAttribute>  
+  
+-   <xref:System.Runtime.Serialization.OnSerializedAttribute>  
+  
+-   <xref:System.Runtime.Serialization.OnSerializingAttribute>  
+  
+ これらの属性を適用すると、シリアル化プロセスと逆シリアル化プロセスの 4 つのフェーズのうち、いずれか、またはすべてに型を参加させることができます。これらの属性は、各フェーズで呼び出す必要がある型のメソッドを指定します。これらのメソッドはシリアル化ストリームにはアクセスしませんが、これらを使用すると、シリアル化の前後、または逆シリアル化の前後にオブジェクトを変更できます。これらの属性は型の継承階層の全レベルで適用でき、各メソッドは、基本クラスから最派生クラスまで、階層内で呼び出されます。このしくみでは、最派生実装でシリアル化および逆シリアル化が行われるため、<xref:System.Runtime.Serialization.ISerializable> インターフェイスの実装の複雑性やその実装によって発生する問題が回避されます。また、フォーマッタは、フィールド値の設定およびシリアル化ストリームからの取得を無視できます。シリアル化および逆シリアル化の制御の詳細と例については、上記の各リンクをクリックしてください。  
+  
+ また、既存のシリアル化可能な型に新しいフィールドを追加する場合は、このフィールドに <xref:System.Runtime.Serialization.OptionalFieldAttribute> 属性を適用します。新しいフィールドが含まれていないストリームを処理する際に、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> および <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> はこのフィールドの不足を無視します。  
+  
+## ISerializable インターフェイスの実装  
+ シリアル化を制御するもう 1 つの方法は、オブジェクトに [ISerializable](frlrfSystemRuntimeSerializationISerializableClassTopic) インターフェイスを実装することです。ただし、シリアル化の制御では、前のセクションで説明した方法がこの方法よりも優先されることに注意してください。  
+  
+ また、[Serializable](frlrfSystemSerializableAttributeClassTopic) 属性を使ってマークされ、クラス レベルまたはクラスのコンストラクターで宣言セキュリティまたは強制セキュリティが設定されたクラスでは、既定のシリアル化を使用しないでください。代わりに、このようなクラスでは、常に **ISerializable** インターフェイスを実装する必要があります。  
+  
+ **ISerializable** を実装すると、[GetObjectData](frlrfSystemRuntimeSerializationISerializableClassGetObjectDataTopic) メソッドと、このオブジェクトが逆シリアル化されるときに使用される専用のコンストラクターも実装されます。前のセクションで使用した `MyObject` クラスに **ISerializable** を実装する方法を次のコード例に示します。  
+  
+```csharp  
+[Serializable]  
+public class MyObject : ISerializable   
+{  
+  public int n1;  
+  public int n2;  
+  public String str;  
+  
+  public MyObject()  
+  {  
+  }  
+  
+  protected MyObject(SerializationInfo info, StreamingContext context)  
+  {  
+    n1 = info.GetInt32("i");  
+    n2 = info.GetInt32("j");  
+    str = info.GetString("k");  
+  }  
+[SecurityPermissionAttribute(SecurityAction.Demand,   
+SerializationFormatter =true)]  
+  
+public virtual void GetObjectData(SerializationInfo info, StreamingContext context)  
+  {  
+    info.AddValue("i", n1);  
+    info.AddValue("j", n2);  
+    info.AddValue("k", str);  
+  }  
+}  
+```  
+  
+```vb  
+<Serializable()>  _  
+Public Class MyObject  
+    Implements ISerializable  
+    Public n1 As Integer  
+    Public n2 As Integer  
+    Public str As String  
+  
+    Public Sub New()   
+    End Sub   
+  
+    Protected Sub New(ByVal info As SerializationInfo, _  
+    ByVal context As StreamingContext)   
+        n1 = info.GetInt32("i")  
+        n2 = info.GetInt32("j")  
+        str = info.GetString("k")  
+    End Sub 'New  
+  
+    <SecurityPermissionAttribute(SecurityAction.Demand, SerializationFormatter := True)>  _  
+    Public Overridable Sub GetObjectData(ByVal info As _  
+    SerializationInfo, ByVal context As StreamingContext)   
+        info.AddValue("i", n1)  
+        info.AddValue("j", n2)  
+        info.AddValue("k", str)  
+    End Sub   
+End Class  
+```  
+  
+ シリアル化時に **GetObjectData** を呼び出す場合は、メソッド呼び出しで提供される [SerializationInfo](frlrfSystemRuntimeSerializationSerializationInfoClassTopic) を設定する必要があります。シリアル化の対象とする変数は、名前と値のペアとして追加します。名前には、任意のテキストを使用できます。逆シリアル化時にオブジェクトを復元するのに十分なデータがシリアル化される場合は、**SerializationInfo** に追加するメンバー変数を自由に決定できます。派生クラスの基本オブジェクトが **ISerializable** を実装している場合は、派生クラスが基本オブジェクトの **GetObjectData** メソッドを呼び出す必要があります。  
+  
+ シリアル化によって、他の方法ではアクセスできないオブジェクト インスタンス データを他のコードから参照または変更できるようになります。したがって、シリアル化を実行するコードには、[SerializationFormatter](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) フラグが指定された [SecurityPermission](frlrfSystemSecurityPermissionsSecurityPermissionClassTopic) が必要です。既定のポリシーでは、インターネットからダウンロードしたコードまたはイントラネット コードにはこのアクセス許可は与えられず、ローカル コンピューター上のコードにだけ付与されます。**GetObjectData** メソッドは、**SerializationFormatter** フラグが指定された **SecurityPermission** を要求するか、プライベート データの保護に役立つ他の特別なアクセス許可を要求することによって、明示的に保護する必要があります。  
+  
+ プライベート フィールドに機密情報が格納されている場合は、**GetObjectData** で適切なアクセス許可を要求してデータを保護してください。**SerializationFormatter** フラグが指定された **SecurityPermission** を付与されているコードは、プライベート フィールドに格納されているデータを参照および変更できます。悪意のある呼び出し元にこの **SecurityPermission** が付与されている場合、この呼び出し元によって、隠しディレクトリの位置や付与されたアクセス許可などのデータが参照され、コンピューター上のセキュリティの脆弱性が利用される可能性があります。指定できるセキュリティ アクセス許可フラグの完全な一覧については、「[SecurityPermissionFlag 列挙体](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic)」を参照してください。  
+  
+ **ISerializable** をクラスに追加する場合は、**GetObjectData** と専用のコンストラクターの両方を実装する必要があることに注意してください。**GetObjectData** が指定されていない場合、コンパイラから警告が出力されます。ただし、コンストラクターの実装を強制することはできないため、コンストラクターが指定されていなくても警告は表示されず、コンストラクターがないクラスの逆シリアル化が試行された時点で例外がスローされます。  
+  
+ セキュリティやバージョン管理に関して発生する可能性がある問題を回避するために、現在のデザインは <xref:System.Runtime.Serialization.ISerializationSurrogate.SetObjectData%2A> メソッドよりも優先されています。たとえば、[SetObjectData](frlrfSystemRuntimeSerializationISerializationSurrogateClassSetObjectDataTopic) メソッドは、インターフェイスの一部として定義された場合にはパブリックである必要があるため、ユーザーは **SetObjectData** メソッドが複数回呼び出されることを防ぐようにコードを記述する必要があります。そうしないと、悪意のあるアプリケーションが、操作を実行しているオブジェクトの **SetObjectData** メソッドを呼び出すことによって、さまざまな問題が発生する可能性があります。  
+  
+ 逆シリアル化時に、**SerializationInfo** は、これをクラスに渡すために提供されているコンストラクターを使用してクラスに渡されます。オブジェクトが逆シリアル化されるときには、コンストラクターに対して設定された参照可能範囲の制限は無視されるため、パブリック、プロテクト、内部、またはプライベートとしてクラスをマークできます。ただし、クラスがシールされている場合を除いて、コンストラクターをプロテクトにすることがベスト プラクティスです。クラスがシールされている場合は、コンストラクターをプライベートとマークする必要があります。コンストラクターは入力の検証も実行する必要があります。悪意のあるコードによる不適切な使用を回避するために、コンストラクターは、他のコンストラクターを使用してクラスのインスタンスを取得する場合と同様のセキュリティ チェックおよびアクセス許可を適用する必要があります。そうしないと、パブリック コンストラクターによる通常のインスタンスの構築時に適用されるはずのセキュリティが適用されず、悪意のあるコードが、オブジェクトを事前にシリアル化し、**SerializationFormatter** フラグが指定された **SecurityPermission** によって制御を取得して、クライアント コンピューター上でオブジェクトを逆シリアル化することが可能になります。  
+  
+ オブジェクトの状態を復元するには、シリアル化時に使用した名前を使って、**SerializationInfo** から変数の値を取得します。基本クラスに **ISerializable** が実装されている場合は、基本オブジェクトがその変数を復元できるようにするために、基本コンストラクターを呼び出す必要があります。  
+  
+ **ISerializable** を実装しているクラスから新しいクラスを派生させる場合に、派生クラスにシリアル化する必要がある変数があるときは、派生クラスにコンストラクターと **GetObjectData** メソッドの両方を実装する必要があります。上記の `MyObject` クラスを使用してこれを行う方法を次のコード例に示します。  
+  
+```csharp  
+[Serializable]  
+public class ObjectTwo : MyObject  
+{  
+    public int num;  
+  
+    public ObjectTwo() : base()  
+    {  
+    }  
+  
+    protected ObjectTwo(SerializationInfo si,   
+    StreamingContext context) : base(si,context)  
+    {  
+        num = si.GetInt32("num");  
+    }  
+[SecurityPermissionAttribute(SecurityAction.Demand,  
+SerializationFormatter = true)]  
+    public override void GetObjectData(SerializationInfo si,   
+    StreamingContext context)  
+    {  
+        base.GetObjectData(si,context);  
+        si.AddValue("num", num);  
+    }  
+}  
+```  
+  
+```vb  
+<Serializable()>  _  
+Public Class ObjectTwo  
+    Inherits MyObject  
+    Public num As Integer  
+  
+    Public Sub New()   
+  
+    End Sub       
+  
+    Protected Sub New(ByVal si As SerializationInfo, _  
+    ByVal context As StreamingContext)   
+        MyBase.New(si, context)  
+        num = si.GetInt32("num")      
+    End Sub   
+  
+    <SecurityPermissionAttribute(SecurityAction.Demand, _  
+    SerializationFormatter := True)>  _  
+    Public Overrides Sub GetObjectData(ByVal si As _  
+    SerializationInfo, ByVal context As StreamingContext)   
+        MyBase.GetObjectData(si, context)  
+        si.AddValue("num", num)      
+    End Sub   
+End Class  
+```  
+  
+ 必ず、逆シリアル化コンストラクターで、基本クラスを呼び出すようにしてください。そうしないと、基本クラスのコンストラクターが呼び出されず、逆シリアル化後にオブジェクトが完全には構築されません。  
+  
+ オブジェクトは内側から外側に向かって再構築されるため、逆シリアル化時にメソッドを呼び出すと、望ましくない副作用を引き起こす可能性があります。これは、呼び出されるメソッドが、呼び出しの時点では逆シリアル化されていないオブジェクト参照を参照することがあるためです。逆シリアル化対象のクラスが [IDeserializationCallback](frlrfsystemruntimeserializationideserializationcallbackclasstopic) を実装している場合、オブジェクト グラフ全体が逆シリアル化された時点で [OnDeserialization](frlrfSystemRuntimeSerializationIDeserializationCallbackClassOnDeserializationTopic) メソッドが自動的に呼び出されます。この時点で、参照されているすべての子オブジェクトが完全に復元されます。ハッシュ テーブルは、イベント リスナーを使用せずに逆シリアル化することが困難なクラスの典型的な例です。逆シリアル化時にキーと値のペアを取得することは簡単ですが、これらのオブジェクトをハッシュ テーブルに戻すと、このハッシュ テーブルから派生したクラスが逆シリアル化されているかどうかわからないため、問題が発生する可能性があります。したがって、この段階でハッシュ テーブルのメソッドを呼び出すことはお勧めできません。  
+  
+## 参照  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)   
+ [Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)
\ No newline at end of file
diff --git a/docs/framework/serialization/datetimeserialization-element.md b/docs/framework/serialization/datetimeserialization-element.md
new file mode 100644
index 00000000000..ded5148891a
--- /dev/null
+++ b/docs/framework/serialization/datetimeserialization-element.md
@@ -0,0 +1,68 @@
+---
+title: "&lt;dateTimeSerialization&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<dateTimeSerialization> 要素"
+  - "dateTimeSerialization 要素"
+  - "XML シリアル化, 構成"
+ms.assetid: 90fda55c-7730-41e9-bc4b-6423a4b920af
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;dateTimeSerialization&gt; 要素
+<xref:System.DateTime> オブジェクトのシリアル化モードを決定します。  
+  
+## 構文  
+  
+```  
+  
+<dateTimeSerialization  
+    mode = "Roundtrip" | "Local"  
+/>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|`mode`|省略可能です。  シリアル化モードを指定します。  <xref:System.Xml.Serialization.Configuration.DateTimeSerializationSection.DateTimeSerializationMode> 値のいずれかに設定します。  既定値は、**RoundTrip** です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|system.xml.serialization|XML シリアル化を制御する最上位の要素です。|  
+  
+## 解説  
+ .NET Framework の 1.0、1.1、2.0、およびそれ以降のバージョンで、このプロパティを **Local** に設定した場合、<xref:System.DateTime> オブジェクトは常に現地時刻形式になります。  つまり、ローカル タイム ゾーンの情報が、シリアル化されたデータに必ず組み込まれます。  .NET Framework の以前のバージョンとの互換性を保証するには、このプロパティを **Local** に設定します。  
+  
+ バージョン 2.0 以降の .NET Framework で、このプロパティを **Roundtrip** に設定すると、<xref:System.DateTime> オブジェクトが調べられ、タイム ゾーンが現地時刻、UTC、または未指定のいずれであるかが特定されます。  その後、この特定された情報を保持する形で、<xref:System.DateTime> オブジェクトがシリアル化されます。  これは既定の動作であり、.NET Framework の以前のバージョンと通信を行わない、すべての新しいアプリケーションで推奨されます。  
+  
+## 参照  
+ <xref:System.DateTime>   
+ <xref:System.Xml.Serialization.XmlSchemaImporter>   
+ <xref:System.Xml.Serialization.Configuration.DateTimeSerializationSection.DateTimeSerializationMode>   
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<schemaImporterExtensions\> 要素](../../../docs/framework/serialization/schemaimporterextensions-element.md)   
+ [\<xmlSchemaImporterExtensions\> の \<add\> 要素](../../../docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md)   
+ [\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/examples-of-xml-serialization.md b/docs/framework/serialization/examples-of-xml-serialization.md
new file mode 100644
index 00000000000..f06d26e9833
--- /dev/null
+++ b/docs/framework/serialization/examples-of-xml-serialization.md
@@ -0,0 +1,785 @@
+---
+title: "XML シリアル化の例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "配列, シリアル化"
+  - "DataSet クラス, シリアル化"
+  - "ICollection インターフェイス, シリアル化"
+  - "シリアル化, 例"
+  - "XML スキーマ, シリアル化"
+  - "XML シリアル化, 例"
+  - "XmlSerializer クラス, シリアル化"
+ms.assetid: eec46337-9696-435b-a375-dc5effae6992
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# XML シリアル化の例
+XML シリアル化は、単純な形式から複雑な形式に至るまで、さまざまな形で実行できます。たとえば、「[XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)」に示すように、パブリック フィールドとパブリック プロパティだけで構成されるクラスをシリアル化できます。次の例では、XML シリアル化を使用して特定の XML スキーマ \(XSD\) ドキュメントに準拠する XML ストリームを生成する方法など、各種の高度なシナリオに対応するコード例を示します。  
+  
+## データセットのシリアル化  
+ 次のコード例に示すように、パブリック クラスのインスタンスだけでなく、<xref:System.Data.DataSet> のインスタンスもシリアル化できます。  
+  
+```vb  
+Private Sub SerializeDataSet(filename As String)  
+    Dim ser As XmlSerializer = new XmlSerializer(GetType(DataSet))  
+    ' Creates a DataSet; adds a table, column, and ten rows.  
+    Dim ds As DataSet = new DataSet("myDataSet")  
+    Dim t As DataTable = new DataTable("table1")  
+    Dim c As DataColumn = new DataColumn("thing")  
+    t.Columns.Add(c)  
+    ds.Tables.Add(t)  
+    Dim r As DataRow  
+    Dim i As Integer  
+    for i = 0 to 10  
+        r = t.NewRow()  
+        r(0) = "Thing " &  i  
+        t.Rows.Add(r)  
+    Next  
+    Dim writer As TextWriter = new StreamWriter(filename)  
+    ser.Serialize(writer, ds)  
+    writer.Close()  
+End Sub  
+  
+```  
+  
+```csharp  
+private void SerializeDataSet(string filename){  
+    XmlSerializer ser = new XmlSerializer(typeof(DataSet));  
+  
+    // Creates a DataSet; adds a table, column, and ten rows.  
+    DataSet ds = new DataSet("myDataSet");  
+    DataTable t = new DataTable("table1");  
+    DataColumn c = new DataColumn("thing");  
+    t.Columns.Add(c);  
+    ds.Tables.Add(t);  
+    DataRow r;  
+    for(int i = 0; i<10;i++){  
+        r = t.NewRow();  
+        r[0] = "Thing " + i;  
+        t.Rows.Add(r);  
+    }  
+    TextWriter writer = new StreamWriter(filename);  
+    ser.Serialize(writer, ds);  
+    writer.Close();  
+}  
+```  
+  
+## XmlElement および XmlNode のシリアル化  
+ 次のコード例に示すように、<xref:System.Xml.XmlElement> クラスまたは <xref:System.Xml.XmlNode> クラスのインスタンスもシリアル化できます。  
+  
+```vb  
+private Sub SerializeElement(filename As String)  
+    Dim ser As XmlSerializer = new XmlSerializer(GetType(XmlElement))  
+    Dim myElement As XmlElement = _  
+    new XmlDocument().CreateElement("MyElement", "ns")  
+    myElement.InnerText = "Hello World"  
+    Dim writer As TextWriter = new StreamWriter(filename)  
+    ser.Serialize(writer, myElement)  
+    writer.Close()  
+End Sub  
+  
+Private Sub SerializeNode(filename As String)  
+    Dim ser As XmlSerializer = _  
+    new XmlSerializer(GetType(XmlNode))  
+    Dim myNode As XmlNode = new XmlDocument(). _  
+    CreateNode(XmlNodeType.Element, "MyNode", "ns")  
+    myNode.InnerText = "Hello Node"  
+    Dim writer As TextWriter = new StreamWriter(filename)  
+    ser.Serialize(writer, myNode)  
+    writer.Close()  
+End Sub  
+  
+```  
+  
+```csharp  
+private void SerializeElement(string filename){  
+    XmlSerializer ser = new XmlSerializer(typeof(XmlElement));  
+    XmlElement myElement=   
+    new XmlDocument().CreateElement("MyElement", "ns");  
+    myElement.InnerText = "Hello World";  
+    TextWriter writer = new StreamWriter(filename);  
+    ser.Serialize(writer, myElement);  
+    writer.Close();  
+}  
+  
+private void SerializeNode(string filename){  
+    XmlSerializer ser = new XmlSerializer(typeof(XmlNode));  
+    XmlNode myNode= new XmlDocument().  
+    CreateNode(XmlNodeType.Element, "MyNode", "ns");  
+    myNode.InnerText = "Hello Node";  
+    TextWriter writer = new StreamWriter(filename);  
+    ser.Serialize(writer, myNode);  
+    writer.Close();  
+}  
+```  
+  
+## 複雑なオブジェクトを返すフィールドを含むクラスのシリアル化  
+ プロパティやフィールドが複雑なオブジェクト \(配列やクラス インスタンスなど\) を返す場合、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) は、そのオブジェクトを、メイン XML ドキュメント内で入れ子になっている要素に変換します。たとえば、次のコード例の最初のクラスは、2 番目のクラスのインスタンスを返します。  
+  
+```vb  
+Public Class PurchaseOrder  
+    Public MyAdress As Address  
+End Class  
+  
+Public Class Address  
+    Public FirstName As String  
+End Class  
+  
+```  
+  
+```csharp  
+public class PurchaseOrder  
+{  
+    public Address MyAddress;  
+}  
+public class Address  
+{  
+    public string FirstName;  
+}  
+```  
+  
+ シリアル化された XML 出力は次のようになります。  
+  
+```  
+<PurchaseOrder>  
+    <Address>  
+        <FirstName>George</FirstName>  
+    </Address>  
+</PurchaseOrder>  
+```  
+  
+## オブジェクト配列のシリアル化  
+ 次のコード例に示すように、オブジェクトの配列を返すフィールドをシリアル化することもできます。  
+  
+```vb  
+Public Class PurchaseOrder  
+    public ItemsOrders () As Item  
+End Class  
+  
+Public Class Item  
+    Public ItemID As String  
+    Public ItemPrice As decimal  
+End Class  
+  
+```  
+  
+```csharp  
+public class PurchaseOrder  
+{  
+    public Item [] ItemsOrders  
+}  
+  
+public class Item  
+{  
+    public string ItemID  
+    public decimal ItemPrice  
+}  
+  
+```  
+  
+ シリアル化されたクラスのインスタンスは、2 つの品目が注文された場合、次のようになります。  
+  
+```  
+<PurchaseOrder xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
+    <Items>  
+        <Item>  
+            <ItemID>aaa111</ItemID>  
+            <ItemPrice>34.22</ItemPrice>  
+        <Item>  
+        <Item>  
+            <ItemID>bbb222</ItemID>  
+            <ItemPrice>2.89</ItemPrice>  
+        <Item>  
+    </Items>  
+</PurchaseOrder>  
+```  
+  
+## ICollection インターフェイスを実装するクラスのシリアル化  
+ <xref:System.Collections.ICollection> インターフェイスを実装して独自のコレクション クラスを作成し、<xref:System.Xml.Serialization.XmlSerializer> を使用して、これらのクラスのインスタンスをシリアル化できます。クラスが <xref:System.Collections.ICollection> インターフェイスを実装する場合、そのクラスに含まれているコレクションだけがシリアル化されます。このクラスに追加されたパブリック プロパティやパブリック フィールドはシリアル化されません。シリアル化するには、クラスに **Add** メソッドと **Item** プロパティ \(C\# の場合はインデクサー\) を含める必要があります。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Collections  
+Imports System.Xml.Serialization  
+  
+Public Class Test  
+    Shared Sub Main()  
+        Dim t As Test= new Test()  
+        t.SerializeCollection("coll.xml")  
+    End Sub  
+  
+    Private Sub SerializeCollection(filename As String)  
+        Dim Emps As Employees  = new Employees()  
+        ' Note that only the collection is serialized -- not the   
+        ' CollectionName or any other public property of the class.  
+        Emps.CollectionName = "Employees"  
+        Dim John100 As Employee = new Employee("John", "100xxx")  
+        Emps.Add(John100)  
+        Dim x As XmlSerializer = new XmlSerializer(GetType(Employees))  
+        Dim writer As TextWriter = new StreamWriter(filename)  
+        x.Serialize(writer, Emps)  
+        writer.Close()  
+    End Sub  
+End Class  
+  
+Public Class Employees  
+    Implements ICollection  
+    Public CollectionName As String   
+    Private empArray As ArrayList = new ArrayList()   
+  
+    Public ReadOnly Default Overloads _  
+    Property Item(index As Integer) As Employee  
+        get  
+        return CType (empArray(index), Employee)  
+        End Get  
+    End Property  
+  
+    Public Sub CopyTo(a As Array, index As Integer) _  
+    Implements ICollection.CopyTo  
+        empArray.CopyTo(a, index)  
+    End Sub  
+  
+    Public ReadOnly Property Count () As integer Implements _  
+    ICollection.Count  
+        get   
+            Count = empArray.Count  
+        End Get  
+  
+    End Property  
+  
+    Public ReadOnly Property SyncRoot ()As Object _  
+    Implements ICollection.SyncRoot  
+        get  
+        return me  
+        End Get  
+    End Property  
+  
+    Public ReadOnly Property IsSynchronized () As Boolean _  
+    Implements ICollection.IsSynchronized  
+        get   
+        return false  
+        End Get  
+    End Property  
+  
+    Public Function GetEnumerator() As IEnumerator _  
+    Implements IEnumerable.GetEnumerator  
+  
+        return empArray.GetEnumerator()  
+    End Function   
+  
+    Public Function Add(newEmployee As Employee) As Integer  
+        empArray.Add(newEmployee)  
+        return empArray.Count  
+    End Function  
+End Class  
+  
+Public Class Employee  
+    Public EmpName As String   
+    Public EmpID As String   
+  
+    Public Sub New ()  
+    End Sub  
+  
+    Public Sub New (newName As String , newID As String )   
+        EmpName = newName  
+        EmpID = newID  
+    End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Collections;  
+using System.Xml.Serialization;  
+  
+public class Test{  
+    static void Main(){  
+        Test t = new Test();  
+        t.SerializeCollection("coll.xml");  
+    }  
+  
+    private void SerializeCollection(string filename){  
+        Employees Emps = new Employees();  
+        // Note that only the collection is serialized -- not the   
+        // CollectionName or any other public property of the class.  
+        Emps.CollectionName = "Employees";  
+        Employee John100 = new Employee("John", "100xxx");  
+        Emps.Add(John100);  
+        XmlSerializer x = new XmlSerializer(typeof(Employees));  
+        TextWriter writer = new StreamWriter(filename);  
+        x.Serialize(writer, Emps);  
+    }  
+}  
+public class Employees:ICollection{  
+    public string CollectionName;  
+    private ArrayList empArray = new ArrayList();   
+  
+    public Employee this[int index]{  
+        get{return (Employee) empArray[index];}  
+    }  
+  
+    public void CopyTo(Array a, int index){  
+        empArray.CopyTo(a, index);  
+    }  
+    public int Count{  
+        get{return empArray.Count;}  
+    }  
+    public object SyncRoot{  
+        get{return this;}  
+    }  
+    public bool IsSynchronized{  
+        get{return false;}  
+    }  
+    public IEnumerator GetEnumerator(){  
+        return empArray.GetEnumerator();  
+    }  
+  
+    public void Add(Employee newEmployee){  
+        empArray.Add(newEmployee);  
+    }  
+}  
+  
+public class Employee{  
+    public string EmpName;  
+    public string EmpID;  
+    public Employee(){}  
+    public Employee(string empName, string empID){  
+        EmpName = empName;  
+        EmpID = empID;  
+    }  
+}  
+```  
+  
+## 注文書の例  
+ 次のコード例を切り取って、.cs または .vb というファイル名拡張子を付けて名前を変更したテキスト ファイルに貼り付けます。そのファイルを、C\# コンパイラまたは Visual Basic コンパイラを使用してコンパイルします。その後、実行可能ファイルの名前を使用して、このコードを実行します。  
+  
+ この例では、単純なシナリオとして、<xref:System.Xml.Serialization.XmlSerializer.Serialize%2A> メソッドを使用してオブジェクトのインスタンスを作成し、ファイル ストリームにシリアル化する方法を示しています。この XML ストリームをファイルに保存した後、<xref:System.Xml.Serialization.XmlSerializer.Deserialize%2A> メソッドを使用して同じファイルを再び読み込み、元のオブジェクトのコピーを再構築します。  
+  
+ この例では、`PurchaseOrder` という名前のクラスをシリアル化し、さらに逆シリアル化します。また、`ShipTo` という名前のパブリック フィールドを `Address` に設定する必要があるため、`Address` という名前の 2 番目のクラスも含まれています。同様に、`OrderedItem` オブジェクトの配列を `OrderedItems` フィールドに設定する必要があるため、`OrderedItem` クラスも含まれています。最後に、`Test` という名前のクラスには、これらのクラスをシリアル化および逆シリアル化するコードが含まれています。  
+  
+ `CreatePO` メソッドは、`PurchaseOrder`、`Address`、`OrderedItem` の各クラス オブジェクトを作成し、それらのパブリック フィールドの値を設定します。このメソッドは、`PurchaseOrder` のシリアル化および逆シリアル化に使用される <xref:System.Xml.Serialization.XmlSerializer> クラスのインスタンスも生成します。このコードは、シリアル化されるクラスの型をコンストラクターに渡します。さらに、XML ストリームを XML ドキュメントに書き込むために使用する [FileStream](frlrfSystemIOFileStreamClassTopic) も作成します。  
+  
+ `ReadPo` メソッドは、もう少し単純です。このメソッドは、逆シリアル化する対象となるオブジェクトを作成し、その値を読み取るだけです。`CreatePo` メソッドの場合と同様に、まず、逆シリアル化の対象となるクラスの型をコンストラクターに渡して、<xref:System.Xml.Serialization.XmlSerializer> を生成する必要があります。また、XML ドキュメントを読み取るため、<xref:System.IO.FileStream> も必要です。オブジェクトを逆シリアル化するには、この <xref:System.IO.FileStream> を引数として <xref:System.Xml.Serialization.XmlSerializer.Deserialize%2A> メソッドを呼び出します。逆シリアル化されたオブジェクトは、`PurchaseOrder` 型のオブジェクト変数にキャストする必要があります。その後で、逆シリアル化された `PurchaseOrder` の値を読み取ります。作成された PO.xml ファイルを読み取って、実際の XML 出力を確認することもできます。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+Imports System.Xml.Serialization  
+Imports System.IO  
+Imports Microsoft.VisualBasic  
+  
+' The XmlRootAttribute allows you to set an alternate name  
+' (PurchaseOrder) for the XML element and its namespace. By  
+' default, the XmlSerializer uses the class name. The attribute  
+' also allows you to set the XML namespace for the element. Lastly,  
+' the attribute sets the IsNullable property, which specifies whether  
+' the xsi:null attribute appears if the class instance is set to  
+' a null reference.   
+<XmlRootAttribute("PurchaseOrder", _  
+ Namespace := "http://www.cpandl.com", IsNullable := False)> _  
+Public Class PurchaseOrder  
+    Public ShipTo As Address  
+    Public OrderDate As String  
+    ' The XmlArrayAttribute changes the XML element name  
+    ' from the default of "OrderedItems" to "Items".   
+    <XmlArrayAttribute("Items")> _  
+    Public OrderedItems() As OrderedItem  
+    Public SubTotal As Decimal  
+    Public ShipCost As Decimal  
+    Public TotalCost As Decimal  
+End Class   
+  
+Public Class Address  
+    ' The XmlAttribute instructs the XmlSerializer to serialize the   
+    ' Name field as an XML attribute instead of an XML element (the   
+    ' default behavior).   
+    <XmlAttribute()> _  
+    Public Name As String  
+    Public Line1 As String  
+  
+    ' Setting the IsNullable property to false instructs the  
+    ' XmlSerializer that the XML attribute will not appear if  
+    ' the City field is set to a null reference.   
+    <XmlElementAttribute(IsNullable := False)> _  
+    Public City As String  
+    Public State As String  
+    Public Zip As String  
+End Class   
+  
+Public Class OrderedItem  
+    Public ItemName As String  
+    Public Description As String  
+    Public UnitPrice As Decimal  
+    Public Quantity As Integer  
+    Public LineTotal As Decimal  
+  
+    ' Calculate is a custom method that calculates the price per item  
+    ' and stores the value in a field.   
+    Public Sub Calculate()  
+    LineTotal = UnitPrice * Quantity  
+    End Sub   
+End Class   
+  
+Public Class Test  
+        Public Shared Sub Main()  
+    ' Read and write purchase orders.  
+    Dim t As New Test()  
+    t.CreatePO("po.xml")  
+    t.ReadPO("po.xml")  
+    End Sub   
+  
+    Private Sub CreatePO(filename As String)  
+        ' Creates an instance of the XmlSerializer class;  
+        ' specifies the type of object to serialize.  
+        Dim serializer As New XmlSerializer(GetType(PurchaseOrder))  
+        Dim writer As New StreamWriter(filename)  
+        Dim po As New PurchaseOrder()  
+  
+        ' Creates an address to ship and bill to.  
+        Dim billAddress As New Address()  
+        billAddress.Name = "Teresa Atkinson"  
+        billAddress.Line1 = "1 Main St."  
+        billAddress.City = "AnyTown"  
+        billAddress.State = "WA"  
+        billAddress.Zip = "00000"  
+        ' Set ShipTo and BillTo to the same addressee.  
+        po.ShipTo = billAddress  
+        po.OrderDate = System.DateTime.Now.ToLongDateString()  
+  
+        ' Creates an OrderedItem.  
+        Dim i1 As New OrderedItem()  
+        i1.ItemName = "Widget S"  
+        i1.Description = "Small widget"  
+        i1.UnitPrice = CDec(5.23)  
+        i1.Quantity = 3  
+        i1.Calculate()  
+  
+        ' Inserts the item into the array.  
+        Dim items(0) As OrderedItem  
+        items(0) = i1  
+        po.OrderedItems = items  
+        ' Calculates the total cost.  
+        Dim subTotal As New Decimal()  
+        Dim oi As OrderedItem  
+        For Each oi In  items  
+            subTotal += oi.LineTotal  
+        Next oi  
+        po.SubTotal = subTotal  
+        po.ShipCost = CDec(12.51)  
+        po.TotalCost = po.SubTotal + po.ShipCost  
+        ' Serializes the purchase order, and close the TextWriter.  
+        serializer.Serialize(writer, po)  
+        writer.Close()  
+    End Sub   
+  
+    Protected Sub ReadPO(filename As String)  
+        ' Creates an instance of the XmlSerializer class;  
+        ' specifies the type of object to be deserialized.  
+        Dim serializer As New XmlSerializer(GetType(PurchaseOrder))  
+        ' If the XML document has been altered with unknown  
+        ' nodes or attributes, handles them with the  
+        ' UnknownNode and UnknownAttribute events.  
+        AddHandler serializer.UnknownNode, AddressOf serializer_UnknownNode  
+        AddHandler serializer.UnknownAttribute, AddressOf _  
+        serializer_UnknownAttribute  
+  
+        ' A FileStream is needed to read the XML document.  
+        Dim fs As New FileStream(filename, FileMode.Open)  
+        ' Declare an object variable of the type to be deserialized.  
+        Dim po As PurchaseOrder  
+        ' Uses the Deserialize method to restore the object's state   
+        ' with data from the XML document.   
+        po = CType(serializer.Deserialize(fs), PurchaseOrder)  
+        ' Reads the order date.  
+        Console.WriteLine(("OrderDate: " & po.OrderDate))  
+  
+        ' Reads the shipping address.  
+        Dim shipTo As Address = po.ShipTo  
+        ReadAddress(shipTo, "Ship To:")  
+        ' Reads the list of ordered items.  
+        Dim items As OrderedItem() = po.OrderedItems  
+        Console.WriteLine("Items to be shipped:")  
+        Dim oi As OrderedItem  
+        For Each oi In items  
+            Console.WriteLine((ControlChars.Tab & oi.ItemName & _  
+            ControlChars.Tab & _  
+                oi.Description & ControlChars.Tab & oi.UnitPrice & _  
+                ControlChars.Tab & _  
+                oi.Quantity & ControlChars.Tab & oi.LineTotal))  
+        Next oi  
+        ' Reads the subtotal, shipping cost, and total cost.  
+        Console.WriteLine((ControlChars.Cr & New String _  
+        (ControlChars.Tab, 5) & _  
+        " Subtotal" & ControlChars.Tab & po.SubTotal & ControlChars.Cr & _  
+        New String(ControlChars.Tab, 5) & " Shipping" & ControlChars.Tab & _  
+        po.ShipCost & ControlChars.Cr &  New String(ControlChars.Tab, 5) & _  
+        " Total" & New String(ControlChars.Tab, 2) & po.TotalCost))  
+    End Sub   
+  
+    Protected Sub ReadAddress(a As Address, label As String)  
+        ' Reads the fields of the Address.  
+        Console.WriteLine(label)  
+        Console.Write((ControlChars.Tab & a.Name & ControlChars.Cr & _  
+        ControlChars.Tab & a.Line1 & ControlChars.Cr & ControlChars.Tab & _  
+        a.City & ControlChars.Tab & a.State & ControlChars.Cr & _  
+        ControlChars.Tab & a.Zip & ControlChars.Cr))  
+    End Sub   
+  
+    Protected Sub serializer_UnknownNode(sender As Object, e As _  
+    XmlNodeEventArgs)  
+        Console.WriteLine(("Unknown Node:" & e.Name & _  
+        ControlChars.Tab & e.Text))  
+    End Sub   
+  
+    Protected Sub serializer_UnknownAttribute(sender As Object, _  
+    e As XmlAttributeEventArgs)  
+        Dim attr As System.Xml.XmlAttribute = e.Attr  
+        Console.WriteLine(("Unknown attribute " & attr.Name & "='" & _  
+        attr.Value & "'"))  
+    End Sub 'serializer_UnknownAttribute  
+End Class 'Test  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+using System.Xml.Serialization;  
+using System.IO;  
+  
+// The XmlRootAttribute allows you to set an alternate name   
+// (PurchaseOrder) for the XML element and its namespace. By   
+// default, the XmlSerializer uses the class name. The attribute   
+// also allows you to set the XML namespace for the element. Lastly,  
+// the attribute sets the IsNullable property, which specifies whether   
+// the xsi:null attribute appears if the class instance is set to   
+// a null reference.  
+[XmlRootAttribute("PurchaseOrder", Namespace="http://www.cpandl.com",   
+IsNullable = false)]  
+public class PurchaseOrder  
+{  
+    public Address ShipTo;  
+    public string OrderDate;   
+    // The XmlArrayAttribute changes the XML element name  
+    // from the default of "OrderedItems" to "Items".  
+    [XmlArrayAttribute("Items")]  
+    public OrderedItem[] OrderedItems;  
+    public decimal SubTotal;  
+    public decimal ShipCost;  
+    public decimal TotalCost;     
+}  
+  
+public class Address  
+{  
+    // The XmlAttribute instructs the XmlSerializer to serialize the   
+    // Name field as an XML attribute instead of an XML element (the   
+    // default behavior).  
+    [XmlAttribute]  
+    public string Name;  
+    public string Line1;  
+  
+    // Setting the IsNullable property to false instructs the   
+    // XmlSerializer that the XML attribute will not appear if   
+    // the City field is set to a null reference.  
+    [XmlElementAttribute(IsNullable = false)]  
+    public string City;  
+    public string State;  
+    public string Zip;  
+}  
+  
+public class OrderedItem  
+{  
+    public string ItemName;  
+    public string Description;  
+    public decimal UnitPrice;  
+    public int Quantity;  
+    public decimal LineTotal;  
+  
+    // Calculate is a custom method that calculates the price per item  
+    // and stores the value in a field.  
+    public void Calculate()  
+    {  
+        LineTotal = UnitPrice * Quantity;  
+    }  
+}  
+  
+public class Test  
+{  
+    public static void Main()  
+    {  
+        // Read and write purchase orders.  
+        Test t = new Test();  
+        t.CreatePO("po.xml");  
+        t.ReadPO("po.xml");  
+    }  
+  
+    private void CreatePO(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class;  
+        // specifies the type of object to serialize.  
+        XmlSerializer serializer =   
+        new XmlSerializer(typeof(PurchaseOrder));  
+        TextWriter writer = new StreamWriter(filename);  
+        PurchaseOrder po=new PurchaseOrder();  
+  
+        // Creates an address to ship and bill to.  
+        Address billAddress = new Address();  
+        billAddress.Name = "Teresa Atkinson";  
+        billAddress.Line1 = "1 Main St.";  
+        billAddress.City = "AnyTown";  
+        billAddress.State = "WA";  
+        billAddress.Zip = "00000";  
+        // Sets ShipTo and BillTo to the same addressee.  
+        po.ShipTo = billAddress;  
+        po.OrderDate = System.DateTime.Now.ToLongDateString();  
+  
+        // Creates an OrderedItem.  
+        OrderedItem i1 = new OrderedItem();  
+        i1.ItemName = "Widget S";  
+        i1.Description = "Small widget";  
+        i1.UnitPrice = (decimal) 5.23;  
+        i1.Quantity = 3;  
+        i1.Calculate();  
+  
+        // Inserts the item into the array.  
+        OrderedItem [] items = {i1};  
+        po.OrderedItems = items;  
+        // Calculate the total cost.  
+        decimal subTotal = new decimal();  
+        foreach(OrderedItem oi in items)  
+        {  
+            subTotal += oi.LineTotal;  
+        }  
+        po.SubTotal = subTotal;  
+        po.ShipCost = (decimal) 12.51;   
+        po.TotalCost = po.SubTotal + po.ShipCost;   
+        // Serializes the purchase order, and closes the TextWriter.  
+        serializer.Serialize(writer, po);  
+        writer.Close();  
+    }  
+  
+    protected void ReadPO(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class;  
+        // specifies the type of object to be deserialized.  
+        XmlSerializer serializer = new XmlSerializer(typeof(PurchaseOrder));  
+        // If the XML document has been altered with unknown   
+        // nodes or attributes, handles them with the   
+        // UnknownNode and UnknownAttribute events.  
+        serializer.UnknownNode+= new   
+        XmlNodeEventHandler(serializer_UnknownNode);  
+        serializer.UnknownAttribute+= new   
+        XmlAttributeEventHandler(serializer_UnknownAttribute);  
+  
+        // A FileStream is needed to read the XML document.  
+        FileStream fs = new FileStream(filename, FileMode.Open);  
+        // Declares an object variable of the type to be deserialized.  
+        PurchaseOrder po;  
+        // Uses the Deserialize method to restore the object's state   
+        // with data from the XML document. */  
+        po = (PurchaseOrder) serializer.Deserialize(fs);  
+        // Reads the order date.  
+        Console.WriteLine ("OrderDate: " + po.OrderDate);  
+  
+        // Reads the shipping address.  
+        Address shipTo = po.ShipTo;  
+        ReadAddress(shipTo, "Ship To:");  
+        // Reads the list of ordered items.  
+        OrderedItem [] items = po.OrderedItems;  
+        Console.WriteLine("Items to be shipped:");  
+        foreach(OrderedItem oi in items)  
+        {  
+            Console.WriteLine("\t"+  
+            oi.ItemName + "\t" +   
+            oi.Description + "\t" +  
+            oi.UnitPrice + "\t" +  
+            oi.Quantity + "\t" +  
+            oi.LineTotal);  
+        }  
+        // Reads the subtotal, shipping cost, and total cost.  
+        Console.WriteLine(  
+        "\n\t\t\t\t\t Subtotal\t" + po.SubTotal +   
+        "\n\t\t\t\t\t Shipping\t" + po.ShipCost +   
+        "\n\t\t\t\t\t Total\t\t" + po.TotalCost  
+        );  
+    }  
+  
+    protected void ReadAddress(Address a, string label)  
+    {  
+        // Reads the fields of the Address.  
+        Console.WriteLine(label);  
+        Console.Write("\t"+  
+        a.Name +"\n\t" +  
+        a.Line1 +"\n\t" +  
+        a.City +"\t" +  
+        a.State +"\n\t" +  
+        a.Zip +"\n");  
+    }  
+  
+    protected void serializer_UnknownNode  
+    (object sender, XmlNodeEventArgs e)  
+    {  
+        Console.WriteLine("Unknown Node:" +   e.Name + "\t" + e.Text);  
+    }  
+  
+    protected void serializer_UnknownAttribute  
+    (object sender, XmlAttributeEventArgs e)  
+    {  
+        System.Xml.XmlAttribute attr = e.Attr;  
+        Console.WriteLine("Unknown attribute " +   
+        attr.Name + "='" + attr.Value + "'");  
+    }  
+}  
+```  
+  
+ XML 出力は、次のようになります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<PurchaseOrder xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.cpandl.com">  
+    <ShipTo Name="Teresa Atkinson">  
+        <Line1>1 Main St.</Line1>  
+        <City>AnyTown</City>  
+        <State>WA</State>  
+        <Zip>00000</Zip>  
+    </ShipTo>  
+    <OrderDate>Wednesday, June 27, 2001</OrderDate>  
+    <Items>  
+        <OrderedItem>  
+            <ItemName>Widget S</ItemName>  
+            <Description>Small widget</Description>  
+            <UnitPrice>5.23</UnitPrice>  
+            <Quantity>3</Quantity>  
+            <LineTotal>15.69</LineTotal>  
+        </OrderedItem>  
+    </Items>  
+    <SubTotal>15.69</SubTotal>  
+    <ShipCost>12.51</ShipCost>  
+    <TotalCost>28.2</TotalCost>  
+</PurchaseOrder>  
+```  
+  
+## 参照  
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)   
+ [XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)   
+ [XmlSerializer Class](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-chunk-serialized-data.md b/docs/framework/serialization/how-to-chunk-serialized-data.md
new file mode 100644
index 00000000000..b979f6346a9
--- /dev/null
+++ b/docs/framework/serialization/how-to-chunk-serialized-data.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : シリアル化されたデータをチャンクする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, データのチャンク"
+  - "バイナリ シリアル化, 例"
+  - "シリアル化されたデータのチャンク"
+  - "データのチャンク"
+  - "大規模なデータ セットのチャンク"
+  - "シリアル化, データのチャンク"
+  - "シリアル化, 例"
+ms.assetid: 22f1b818-7e0d-428a-8680-f17d6ebdd185
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : シリアル化されたデータをチャンクする
+Web サービス メッセージ内で大きなデータ セットを送信すると、次の 2 つの問題が発生します。  
+  
+1.  シリアル化エンジンのバッファリングによるワーキング セット \(メモリ\) の巨大化  
+  
+2.  Base64 エンコーディングの実行後はサイズが 33% 増大することによる、帯域幅の過剰消費  
+  
+ これらの問題を解決するには、シリアル化と逆シリアル化を制御する <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装します。特に、<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> メソッドと <xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> メソッドを実装することで、データをチャンクします。  
+  
+### サーバー側チャンク処理を実装するには  
+  
+1.  サーバー コンピューター上で、Web メソッドが ASP.NET バッファリングを無効にし、<xref:System.Xml.Serialization.IXmlSerializable> を実装する型を返す必要があります。  
+  
+2.  <xref:System.Xml.Serialization.IXmlSerializable> を実装する型は、<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> メソッド内でデータをチャンクします。  
+  
+### クライアント側の処理を実装するには  
+  
+1.  クライアント プロキシ上で <xref:System.Xml.Serialization.IXmlSerializable> を実装する型を返すように Web メソッドを変更します。<xref:System.Xml.Serialization.Advanced.SchemaImporterExtension> を使用するとこの処理を自動化できますが、この方法はここでは説明しません。  
+  
+2.  チャンクされたデータ ストリームを読み込み、バイトをディスクに書き込むための <xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> メソッドを実装します。この実装により、進行状況イベントも発生します。これは、プログレス バーなどのグラフィック コントロールに使用できます。  
+  
+## 使用例  
+ 次のコード例では、クライアント上で ASP.NET バッファリングを無効にする Web メソッドを示します。また、<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> メソッドにおいてデータをチャンクする <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスをクライアント側で実装する方法も示します。  
+  
+ [!code-csharp[HowToChunkSerializedData#1](../../../samples/snippets/csharp/VS_Snippets_Remoting/HowToChunkSerializedData/CS/SerializationChunk.cs#1)]
+ [!code-vb[HowToChunkSerializedData#1](../../../samples/snippets/visualbasic/VS_Snippets_Remoting/HowToChunkSerializedData/VB/SerializationChunk.vb#1)]  
+[!code-csharp[HowToChunkSerializedData#2](../../../samples/snippets/csharp/VS_Snippets_Remoting/HowToChunkSerializedData/CS/SerializationChunk.cs#2)]
+[!code-vb[HowToChunkSerializedData#2](../../../samples/snippets/visualbasic/VS_Snippets_Remoting/HowToChunkSerializedData/VB/SerializationChunk.vb#2)]  
+[!code-csharp[HowToChunkSerializedData#3](../../../samples/snippets/csharp/VS_Snippets_Remoting/HowToChunkSerializedData/CS/SerializationChunk.cs#3)]
+[!code-vb[HowToChunkSerializedData#3](../../../samples/snippets/visualbasic/VS_Snippets_Remoting/HowToChunkSerializedData/VB/SerializationChunk.vb#3)]  
+  
+## コードのコンパイル  
+  
+-   このコードでは、<xref:System>、<xref:System.Runtime.Serialization>、<xref:System.Web.Services>、<xref:System.Web.Services.Protocols>、<xref:System.Xml>、<xref:System.Xml.Serialization>、および <xref:System.Xml.Schema> の各名前空間を使用しています。  
+  
+## 参照  
+ [カスタムのシリアル化](../../../docs/framework/serialization/custom-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-control-serialization-of-derived-classes.md b/docs/framework/serialization/how-to-control-serialization-of-derived-classes.md
new file mode 100644
index 00000000000..01d5604feaa
--- /dev/null
+++ b/docs/framework/serialization/how-to-control-serialization-of-derived-classes.md
@@ -0,0 +1,250 @@
+---
+title: "方法 : 派生クラスのシリアル化を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: caa92596-9e15-4d91-acbe-56911ef47a84
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : 派生クラスのシリアル化を制御する
+**XmlElementAttribute** 属性を使用して XML 要素の名前を変更することが、オブジェクトのシリアル化をカスタマイズする唯一の方法というわけではありません。既存のクラスからクラスを派生させ、この新しいクラスをシリアル化する方法を <xref:System.Xml.Serialization.XmlSerializer> インスタンスに指示することでも、XML ストリームをカスタマイズできます。  
+  
+ たとえば、`Book` クラスからクラスを派生させ、より多くのプロパティを持つ `ExpandedBook` クラスを作成できます。ただし、**XmlSerializer** に対して、シリアル化または逆シリアル化するときに、作成した派生型を受け入れるように指示する必要があります。そのためには、<xref:System.Xml.Serialization.XmlElementAttribute> インスタンスを作成し、その **Type** プロパティを該当する派生クラス型に設定します。**XmlElementAttribute** を <xref:System.Xml.Serialization.XmlAttributes> インスタンスに追加します。次に、**XmlAttributes** を <xref:System.Xml.Serialization.XmlAttributeOverrides> インスタンスに追加して、オーバーライドされる型、および派生クラスを受け入れるメンバーの名前を指定します。これを次の例に示します。  
+  
+## 使用例  
+  
+```vb  
+Public Class Orders  
+    public Books() As Book  
+End Class     
+  
+Public Class Book  
+    public ISBN As String   
+End Class  
+  
+Public Class ExpandedBook  
+    Inherits Book  
+    public NewEdition As Boolean  
+End Class  
+  
+Public Class Run  
+    Shared Sub Main()  
+        Dim t As Run = New Run()  
+        t.SerializeObject("Book.xml")  
+        t.DeserializeObject("Book.xml")  
+    End Sub  
+  
+    Public Sub SerializeObject(filename As String)  
+        ' Each overridden field, property, or type requires   
+        ' an XmlAttributes instance.   
+        Dim attrs As XmlAttributes = New XmlAttributes()  
+  
+        ' Creates an XmlElementAttribute instance to override the   
+        ' field that returns Book objects. The overridden field  
+        ' returns Expanded objects instead.  
+        Dim attr As XmlElementAttribute = _  
+        New XmlElementAttribute()  
+        attr.ElementName = "NewBook"  
+        attr.Type = GetType(ExpandedBook)  
+  
+        ' Adds the element to the collection of elements.  
+        attrs.XmlElements.Add(attr)  
+  
+        ' Creates the XmlAttributeOverrides.  
+        Dim attrOverrides As XmlAttributeOverrides = _  
+        New XmlAttributeOverrides()  
+  
+        ' Adds the type of the class that contains the overridden   
+        ' member, as well as the XmlAttributes instance to override it   
+        ' with, to the XmlAttributeOverrides instance.   
+        attrOverrides.Add(GetType(Orders), "Books", attrs)  
+  
+        ' Creates the XmlSerializer using the XmlAttributeOverrides.  
+        Dim s As XmlSerializer  = _  
+        New XmlSerializer(GetType(Orders), attrOverrides)  
+  
+        ' Writing the file requires a TextWriter instance.  
+        Dim writer As TextWriter = New StreamWriter(filename)  
+  
+        ' Creates the object to be serialized.  
+        Dim myOrders As Orders = New Orders()  
+  
+        ' Creates an object of the derived type.  
+        Dim b As ExpandedBook = New ExpandedBook()  
+        b.ISBN= "123456789"  
+        b.NewEdition = True  
+        myOrders.Books = New ExpandedBook(){b}  
+  
+        ' Serializes the object.  
+        s.Serialize(writer,myOrders)  
+        writer.Close()  
+    End Sub  
+  
+    Public Sub DeserializeObject(filename As String)  
+        Dim attrOverrides As XmlAttributeOverrides = _  
+        New XmlAttributeOverrides()  
+        Dim attrs As XmlAttributes = New XmlAttributes()  
+  
+        ' Creates an XmlElementAttribute to override the   
+        ' field that returns Book objects. The overridden field  
+        ' returns Expanded objects instead.   
+        Dim attr As XmlElementAttribute = _  
+        New XmlElementAttribute()  
+        attr.ElementName = "NewBook"  
+        attr.Type = GetType(ExpandedBook)  
+  
+        ' Adds the XmlElementAttribute to the collection of objects.  
+        attrs.XmlElements.Add(attr)  
+  
+        attrOverrides.Add(GetType(Orders), "Books", attrs)  
+  
+        ' Creates the XmlSerializer using the XmlAttributeOverrides.  
+        Dim s As XmlSerializer = _  
+        New XmlSerializer(GetType(Orders), attrOverrides)  
+  
+        Dim fs As FileStream = New FileStream(filename, FileMode.Open)  
+        Dim myOrders As Orders = CType( s.Deserialize(fs), Orders)  
+        Console.WriteLine("ExpandedBook:")  
+  
+        ' The difference between deserializing the overridden   
+        ' XML document and serializing it is this: To read the derived   
+        ' object values, you must declare an object of the derived type   
+        ' and cast the returned object to it.   
+        Dim expanded As ExpandedBook   
+        Dim b As Book  
+        for each b  in myOrders.Books  
+            expanded = CType(b, ExpandedBook)  
+            Console.WriteLine(expanded.ISBN)  
+            Console.WriteLine(expanded.NewEdition)  
+        Next  
+    End Sub  
+End Class  
+```  
+  
+```csharp  
+public class Orders  
+{  
+    public Book[] Books;  
+}      
+  
+public class Book  
+{  
+    public string ISBN;  
+}  
+  
+public class ExpandedBook:Book  
+{  
+    public bool NewEdition;  
+}  
+  
+public class Run  
+{  
+    public void SerializeObject(string filename)  
+    {  
+        // Each overridden field, property, or type requires   
+        // an XmlAttributes instance.  
+        XmlAttributes attrs = new XmlAttributes();  
+  
+        // Creates an XmlElementAttribute instance to override the   
+        // field that returns Book objects. The overridden field  
+        // returns Expanded objects instead.  
+        XmlElementAttribute attr = new XmlElementAttribute();  
+        attr.ElementName = "NewBook";  
+        attr.Type = typeof(ExpandedBook);  
+  
+        // Adds the element to the collection of elements.  
+        attrs.XmlElements.Add(attr);  
+  
+        // Creates the XmlAttributeOverrides instance.  
+        XmlAttributeOverrides attrOverrides = new XmlAttributeOverrides();  
+  
+        // Adds the type of the class that contains the overridden   
+        // member, as well as the XmlAttributes instance to override it   
+        // with, to the XmlAttributeOverrides.  
+        attrOverrides.Add(typeof(Orders), "Books", attrs);  
+  
+        // Creates the XmlSerializer using the XmlAttributeOverrides.  
+        XmlSerializer s =   
+        new XmlSerializer(typeof(Orders), attrOverrides);  
+  
+        // Writing the file requires a TextWriter instance.  
+        TextWriter writer = new StreamWriter(filename);  
+  
+        // Creates the object to be serialized.  
+        Orders myOrders = new Orders();  
+  
+        // Creates an object of the derived type.  
+        ExpandedBook b = new ExpandedBook();  
+        b.ISBN= "123456789";  
+        b.NewEdition = true;  
+        myOrders.Books = new ExpandedBook[]{b};  
+  
+        // Serializes the object.  
+        s.Serialize(writer,myOrders);  
+        writer.Close();  
+    }  
+  
+    public void DeserializeObject(string filename)  
+    {  
+        XmlAttributeOverrides attrOverrides =   
+            new XmlAttributeOverrides();  
+        XmlAttributes attrs = new XmlAttributes();  
+  
+        // Creates an XmlElementAttribute to override the   
+        // field that returns Book objects. The overridden field  
+        // returns Expanded objects instead.  
+        XmlElementAttribute attr = new XmlElementAttribute();  
+        attr.ElementName = "NewBook";  
+        attr.Type = typeof(ExpandedBook);  
+  
+        // Adds the XmlElementAttribute to the collection of objects.  
+        attrs.XmlElements.Add(attr);  
+  
+        attrOverrides.Add(typeof(Orders), "Books", attrs);  
+  
+        // Creates the XmlSerializer using the XmlAttributeOverrides.  
+        XmlSerializer s =   
+        new XmlSerializer(typeof(Orders), attrOverrides);  
+  
+        FileStream fs = new FileStream(filename, FileMode.Open);  
+        Orders myOrders = (Orders) s.Deserialize(fs);  
+        Console.WriteLine("ExpandedBook:");  
+  
+        // The difference between deserializing the overridden   
+        // XML document and serializing it is this: To read the derived   
+        // object values, you must declare an object of the derived type   
+        // and cast the returned object to it.  
+        ExpandedBook expanded;  
+        foreach(Book b in myOrders.Books)   
+        {  
+            expanded = (ExpandedBook)b;  
+            Console.WriteLine(  
+            expanded.ISBN + "\n" +   
+            expanded.NewEdition);  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ <xref:System.Xml.Serialization.XmlElementAttribute>   
+ <xref:System.Xml.Serialization.XmlAttributes>   
+ <xref:System.Xml.Serialization.XmlAttributeOverrides>   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-deserialize-an-object.md b/docs/framework/serialization/how-to-deserialize-an-object.md
new file mode 100644
index 00000000000..9dcc82584a5
--- /dev/null
+++ b/docs/framework/serialization/how-to-deserialize-an-object.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : オブジェクトを逆シリアル化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "オブジェクトの逆シリアル化"
+  - "オブジェクト, 逆シリアル化の手順"
+ms.assetid: 287129c8-035a-4fea-b7b3-4790057ca076
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 方法 : オブジェクトを逆シリアル化する
+オブジェクトを逆シリアル化する場合、転送形式によって、ストリーム オブジェクトとファイル オブジェクトのどちらを作成するかが決定されます。転送形式を決定したら、必要に応じて <xref:System.Xml.Serialization.XmlSerializer.Serialize%2A> メソッドまたは <xref:System.Xml.Serialization.XmlSerializer.Deserialize%2A> メソッドを呼び出すことができます。  
+  
+### オブジェクトを逆シリアル化するには  
+  
+1.  逆シリアル化するオブジェクトの型を使用して、<xref:System.Xml.Serialization.XmlSerializer> を構築します。  
+  
+2.  <xref:System.Xml.Serialization.XmlSerializer.Deserialize%2A> メソッドを呼び出して、オブジェクトのレプリカを生成します。逆シリアル化を行う際には、次の例に示すように、返されたオブジェクトを元の型にキャストする必要があります。この例では、オブジェクトをファイルに逆シリアル化しています \(ストリームに逆シリアル化することもできます\)。  
+  
+    ```vb  
+    Dim myObject As MySerializableClass  
+    ' Construct an instance of the XmlSerializer with the type  
+    ' of object that is being deserialized.  
+    Dim mySerializer As XmlSerializer = New XmlSerializer(GetType(MySerializableClass))  
+    ' To read the file, create a FileStream.  
+    Dim myFileStream As FileStream = _  
+    New FileStream("myFileName.xml", FileMode.Open)  
+    ' Call the Deserialize method and cast to the object type.  
+    myObject = CType( _  
+    mySerializer.Deserialize(myFileStream), MySerializableClass)  
+  
+    ```  
+  
+    ```csharp  
+    MySerializableClass myObject;  
+    // Construct an instance of the XmlSerializer with the type  
+    // of object that is being deserialized.  
+    XmlSerializer mySerializer =   
+    new XmlSerializer(typeof(MySerializableClass));  
+    // To read the file, create a FileStream.  
+    FileStream myFileStream =   
+    new FileStream("myFileName.xml", FileMode.Open);  
+    // Call the Deserialize method and cast to the object type.  
+    myObject = (MySerializableClass)   
+    mySerializer.Deserialize(myFileStream)  
+    ```  
+  
+## 参照  
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md b/docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md
new file mode 100644
index 00000000000..20ba7de0ad8
--- /dev/null
+++ b/docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md
@@ -0,0 +1,297 @@
+---
+title: "方法 : SOAP エンコード済み XML シリアル化をオーバーライドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "XML シリアル化のオーバーライド"
+  - "SOAP, エンコード済み XML シリアル化のオーバーライド"
+ms.assetid: d0791df8-04e3-46b4-a6be-fe0ed09267e8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : SOAP エンコード済み XML シリアル化をオーバーライドする
+[コード例](#tskhowtooverrideencodedsoapxmlserializationanchor1)  
+  
+ SOAP メッセージとしてオブジェクトの XML シリアル化をオーバーライドするプロセスは、標準の XML シリアル化をオーバーライドするプロセスに似ています。標準の XML シリアル化をオーバーライドする方法については、「[方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)」を参照してください。  
+  
+### SOAP メッセージとしてオブジェクトのシリアル化をオーバーライドするには  
+  
+1.  [SoapAttributeOverrides](frlrfSystemXmlSerializationSoapAttributeOverridesClassTopic) クラスのインスタンスを作成します。  
+  
+2.  シリアル化するクラス メンバーごとに **SoapAttributes** を作成します。  
+  
+3.  シリアル化するメンバーに対し、XML シリアル化に影響を与える 1 つ以上の属性のインスタンスを必要に応じて作成します。詳細については、「エンコード済み SOAP シリアル化を制御する属性」を参照してください。  
+  
+4.  手順 3. で作成した属性に、**SoapAttributes** の適切なプロパティを設定します。  
+  
+5.  **SoapAttributes** を **SoapAttributeOverrides** に追加します。  
+  
+6.  **SoapAttributeOverrides** を使用して **XmlTypeMapping** を作成します。**SoapReflectionImporter.ImportTypeMapping** メソッドを使用します。  
+  
+7.  **XmlTypeMapping** を使用して **XmlSerializer** を作成します。  
+  
+8.  オブジェクトをシリアル化または逆シリアル化します。  
+  
+## 使用例  
+ ファイルを 2 つの方法でシリアル化するコード例を次に示します。最初の方法では `XmlSerializer` クラスの動作をオーバーライドせずにシリアル化し、2 番目の方法ではこのクラスの動作をオーバーライドしてシリアル化します。この例には、複数のメンバーを持つ `Group` という名前のクラスが含まれています。クラス メンバーには、`SoapElementAttribute` などのさまざまな属性が適用されています。`SerializeOriginal` メソッドでこのクラスをシリアル化すると、これらの属性によって SOAP メッセージの内容が制御されます。この `SerializeOverride` メソッドを呼び出すと、さまざまな属性を作成し、それらの属性に `SoapAttributes` のプロパティを設定することによって、`XmlSerializer` の動作がオーバーライドされます。  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Serialization;  
+using System.Xml.Schema;  
+  
+public class Group  
+{  
+    [SoapAttribute (Namespace = "http://www.cpandl.com")]  
+    public string GroupName;  
+  
+    [SoapAttribute(DataType = "base64Binary")]  
+    public Byte [] GroupNumber;  
+  
+    [SoapAttribute(DataType = "date", AttributeName = "CreationDate")]  
+    public DateTime Today;  
+    [SoapElement(DataType = "nonNegativeInteger", ElementName = "PosInt")]  
+    public string PostitiveInt;  
+    // This is ignored when serialized unless it is overridden.  
+    [SoapIgnore]   
+    public bool IgnoreThis;  
+  
+    public GroupType Grouptype;  
+  
+    [SoapInclude(typeof(Car))]  
+    public Vehicle myCar(string licNumber)  
+    {  
+        Vehicle v;  
+        if(licNumber == "")  
+            {  
+                v = new Car();  
+            v.licenseNumber = "!!!!!!";  
+        }  
+        else  
+        {  
+            v = new Car();  
+            v.licenseNumber = licNumber;  
+        }  
+        return v;  
+    }  
+}  
+  
+public abstract class Vehicle  
+{  
+    public string licenseNumber;  
+    public DateTime makeDate;  
+}  
+  
+public class Car: Vehicle  
+{  
+}  
+  
+public enum GroupType  
+{  
+    // These enums can be overridden.  
+    small,  
+    large  
+}  
+  
+public class Run  
+{  
+    public static void Main()  
+    {  
+        Run test = new Run();  
+        test.SerializeOriginal("SoapOriginal.xml");  
+        test.SerializeOverride("SoapOverrides.xml");  
+        test.DeserializeOriginal("SoapOriginal.xml");  
+        test.DeserializeOverride("SoapOverrides.xml");  
+  
+    }  
+    public void SerializeOriginal(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class.  
+        XmlTypeMapping myMapping =   
+        (new SoapReflectionImporter().ImportTypeMapping(  
+        typeof(Group)));  
+        XmlSerializer mySerializer =    
+        new XmlSerializer(myMapping);  
+  
+        // Writing the file requires a TextWriter.  
+        TextWriter writer = new StreamWriter(filename);  
+  
+        // Creates an instance of the class that will be serialized.  
+        Group myGroup = new Group();  
+  
+        // Sets the object properties.  
+        myGroup.GroupName = ".NET";  
+  
+        Byte [] hexByte = new Byte[2]{Convert.ToByte(100),  
+        Convert.ToByte(50)};  
+        myGroup.GroupNumber = hexByte;  
+  
+        DateTime myDate = new DateTime(2002,5,2);  
+        myGroup.Today = myDate;  
+  
+        myGroup.PostitiveInt= "10000";  
+        myGroup.IgnoreThis=true;  
+        myGroup.Grouptype= GroupType.small;  
+        Car thisCar =(Car)  myGroup.myCar("1234566");  
+  
+        // Prints the license number just to prove the car was created.  
+        Console.WriteLine("License#: " + thisCar.licenseNumber + "\n");  
+  
+        // Serializes the class and closes the TextWriter.  
+        mySerializer.Serialize(writer, myGroup);  
+        writer.Close();  
+    }  
+  
+    public void SerializeOverride(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class  
+        // that overrides the serialization.  
+        XmlSerializer overRideSerializer = CreateOverrideSerializer();  
+  
+        // Writing the file requires a TextWriter.  
+        TextWriter writer = new StreamWriter(filename);  
+  
+        // Creates an instance of the class that will be serialized.  
+        Group myGroup = new Group();  
+  
+        // Sets the object properties.  
+        myGroup.GroupName = ".NET";  
+  
+        Byte [] hexByte = new Byte[2]{Convert.ToByte(100),  
+        Convert.ToByte(50)};  
+        myGroup.GroupNumber = hexByte;  
+  
+        DateTime myDate = new DateTime(2002,5,2);  
+        myGroup.Today = myDate;  
+  
+        myGroup.PostitiveInt= "10000";  
+        myGroup.IgnoreThis=true;  
+        myGroup.Grouptype= GroupType.small;  
+        Car thisCar =(Car)  myGroup.myCar("1234566");  
+  
+        // Serializes the class and closes the TextWriter.  
+        overRideSerializer.Serialize(writer, myGroup);  
+         writer.Close();  
+    }  
+  
+    public void DeserializeOriginal(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class.  
+        XmlTypeMapping myMapping =   
+        (new SoapReflectionImporter().ImportTypeMapping(  
+        typeof(Group)));  
+        XmlSerializer mySerializer =    
+        new XmlSerializer(myMapping);  
+  
+        TextReader reader = new StreamReader(filename);  
+  
+        // Deserializes and casts the object.  
+        Group myGroup;   
+        myGroup = (Group) mySerializer.Deserialize(reader);  
+  
+        Console.WriteLine(myGroup.GroupName);  
+        Console.WriteLine(myGroup.GroupNumber[0]);  
+        Console.WriteLine(myGroup.GroupNumber[1]);  
+        Console.WriteLine(myGroup.Today);  
+        Console.WriteLine(myGroup.PostitiveInt);  
+        Console.WriteLine(myGroup.IgnoreThis);  
+        Console.WriteLine();  
+    }  
+  
+    public void DeserializeOverride(string filename)  
+    {  
+        // Creates an instance of the XmlSerializer class.  
+        XmlSerializer overRideSerializer = CreateOverrideSerializer();  
+        // Reading the file requires a TextReader.  
+        TextReader reader = new StreamReader(filename);  
+  
+        // Deserializes and casts the object.  
+        Group myGroup;   
+        myGroup = (Group) overRideSerializer.Deserialize(reader);  
+  
+        Console.WriteLine(myGroup.GroupName);  
+        Console.WriteLine(myGroup.GroupNumber[0]);  
+        Console.WriteLine(myGroup.GroupNumber[1]);  
+        Console.WriteLine(myGroup.Today);  
+        Console.WriteLine(myGroup.PostitiveInt);  
+        Console.WriteLine(myGroup.IgnoreThis);  
+    }  
+  
+    private XmlSerializer CreateOverrideSerializer()  
+    {  
+        SoapAttributeOverrides mySoapAttributeOverrides =   
+        new SoapAttributeOverrides();  
+        SoapAttributes soapAtts = new SoapAttributes();  
+  
+        SoapElementAttribute mySoapElement = new SoapElementAttribute();  
+        mySoapElement.ElementName = "xxxx";  
+        soapAtts.SoapElement = mySoapElement;  
+        mySoapAttributeOverrides.Add(typeof(Group), "PostitiveInt",   
+        soapAtts);  
+  
+        // Overrides the IgnoreThis property.  
+        SoapIgnoreAttribute myIgnore = new SoapIgnoreAttribute();  
+        soapAtts = new SoapAttributes();  
+        soapAtts.SoapIgnore = false;        
+        mySoapAttributeOverrides.Add(typeof(Group), "IgnoreThis",   
+        soapAtts);  
+  
+        // Overrides the GroupType enumeration.  
+        soapAtts = new SoapAttributes();  
+        SoapEnumAttribute xSoapEnum = new SoapEnumAttribute();  
+        xSoapEnum.Name = "Over1000";  
+        soapAtts.SoapEnum = xSoapEnum;  
+  
+        // Adds the SoapAttributes to the   
+        // mySoapAttributeOverridesrides.  
+        mySoapAttributeOverrides.Add(typeof(GroupType), "large",   
+        soapAtts);  
+  
+        // Creates a second enumeration and adds it.  
+        soapAtts = new SoapAttributes();  
+        xSoapEnum = new SoapEnumAttribute();  
+        xSoapEnum.Name = "ZeroTo1000";  
+        soapAtts.SoapEnum = xSoapEnum;  
+        mySoapAttributeOverrides.Add(typeof(GroupType), "small",   
+        soapAtts);  
+  
+        // Overrides the Group type.  
+        soapAtts = new SoapAttributes();  
+        SoapTypeAttribute soapType = new SoapTypeAttribute();  
+        soapType.TypeName = "Team";  
+        soapAtts.SoapType = soapType;  
+        mySoapAttributeOverrides.Add(typeof(Group),soapAtts);  
+  
+        // Creates an XmlTypeMapping that is used to create an instance   
+        // of the XmlSerializer class. Then returns the XmlSerializer.  
+        XmlTypeMapping myMapping = (new SoapReflectionImporter(  
+        mySoapAttributeOverrides)).ImportTypeMapping(typeof(Group));  
+  
+        XmlSerializer ser = new XmlSerializer(myMapping);  
+        return ser;  
+    }  
+}  
+```  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)   
+ [XML Web サービスを使用した XML シリアル化](../../../docs/framework/serialization/xml-serialization-with-xml-web-services.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)   
+ [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-qualify-xml-element-and-xml-attribute-names.md b/docs/framework/serialization/how-to-qualify-xml-element-and-xml-attribute-names.md
new file mode 100644
index 00000000000..77cf6d4e1f3
--- /dev/null
+++ b/docs/framework/serialization/how-to-qualify-xml-element-and-xml-attribute-names.md
@@ -0,0 +1,188 @@
+---
+title: "方法 : XML 要素および XML 属性名を修飾する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "XML 要素の修飾"
+  - "XML 名の修飾"
+  - "XML 名前空間, 要素と名前の修飾"
+ms.assetid: 44719f90-7e15-42e8-a9e2-282287e2b5bf
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : XML 要素および XML 属性名を修飾する
+[コード例](#cpconworkingwithxmlnamespacesanchor1)  
+  
+ [XmlSerializerNamespaces](frlrfSystemXmlSerializationXmlSerializerNamespacesClassTopic) クラスのインスタンスに格納される XML 名前空間は、W3C \(World Wide Web Consortium\) \(www.w3.org\) の仕様『Namespaces in XML』に準拠する必要があります。  
+  
+ XML 名前空間を使用すると、XML ドキュメント内の XML 要素および XML 属性の名前を修飾できます。修飾名は、プレフィックスとローカル名がコロンで区切られた構成になっています。プレフィックスはプレースホルダーとしてのみ機能し、名前空間を指定する URI に割り当てられます。汎用的に管理される URI 名前空間とローカル名を組み合わせることにより、生成される名前は、必ず汎用的に一意になります。  
+  
+ **XmlSerializerNamespaces** のインスタンスを作成し、そのオブジェクトに名前空間のペアを追加することで、XML ドキュメントで使用されるプレフィックスを指定できます。  
+  
+### XML ドキュメントにおける修飾名を作成するには  
+  
+1.  **XmlSerializerNamespaces** クラスのインスタンスを作成します。  
+  
+2.  すべてのプレフィックスと名前空間のペアを **XmlSerializerNamespaces** に追加します。  
+  
+3.  [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) が XML ドキュメントにシリアル化する各メンバーやクラスに、適切な **System.Xml.Serialization** 属性を適用します。  
+  
+     適用できる属性は、[XmlAnyElementAttribute](frlrfSystemXmlSerializationXmlAnyElementAttributeClassTopic)、[XmlArrayAttribute](frlrfSystemXmlSerializationXmlArrayAttributeClassTopic)、[XmlArrayItemAttribute](frlrfSystemXmlSerializationXmlArrayItemAttributeClassTopic)、[XmlAttributeAttribute](frlrfSystemXmlSerializationXmlAttributeAttributeClassTopic)、[XmlElementAttribute](frlrfSystemXmlSerializationXmlElementAttributeClassTopic)、[XmlRootAttribute](frlrfSystemXmlSerializationXmlRootAttributeClassTopic)、および [XmlTypeAttribute](frlrfSystemXmlSerializationXmlTypeAttributeClassTopic) です。  
+  
+4.  各属性の **Namespace** プロパティを、**XmlSerializerNamespaces** のいずれかの名前空間値に設定します。  
+  
+5.  **XmlSerializerNamespaces** を **XmlSerializer** の **Serialize** メソッドに渡します。  
+  
+## 使用例  
+ **XmlSerializerNamespaces** を作成し、このオブジェクトにプレフィックスと名前空間のペアを 2 つ追加する例を次に示します。このコードでは、`Books` クラスのインスタンスをシリアル化するために使用される **XmlSerializer** を作成します。また、**XmlSerializerNamespaces** を使用して **Serialize** メソッドを呼び出し、XML にプレフィックス付き名前空間を含めることができるようにします。  
+  
+```vb  
+Option Explicit   
+public class Price  
+{  
+    [XmlAttribute(Namespace = "http://www.cpandl.com")]  
+    public string currency;  
+    [XmlElement(Namespace = "http://www.cohowinery.com")]  
+    public decimal price;  
+}  
+  
+Option Strict  
+  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.Serialization  
+  
+Public Class Run  
+  
+    Public Shared Sub Main()  
+        Dim test As New Run()  
+        test.SerializeObject("XmlNamespaces.xml")  
+    End Sub 'Main  
+  
+    Public Sub SerializeObject(filename As String)  
+        Dim mySerializer As New XmlSerializer(GetType(Books))  
+        ' Writing a file requires a TextWriter.  
+        Dim myWriter As New StreamWriter(filename)  
+  
+        ' Creates an XmlSerializerNamespaces and adds two  
+        ' prefix-namespace pairs.   
+        Dim myNamespaces As New XmlSerializerNamespaces()  
+        myNamespaces.Add("books", "http://www.cpandl.com")  
+        myNamespaces.Add("money", "http://www.cohowinery.com")  
+  
+        ' Creates a Book.  
+        Dim myBook As New Book()  
+        myBook.TITLE = "A Book Title"  
+        Dim myPrice As New Price()  
+        myPrice.price = CDec(9.95)  
+        myPrice.currency = "US Dollar"  
+        myBook.PRICE = myPrice  
+        Dim myBooks As New Books()  
+        myBooks.Book = myBook  
+        mySerializer.Serialize(myWriter, myBooks, myNamespaces)  
+        myWriter.Close()  
+    End Sub  
+End Class  
+  
+Public Class Books  
+    <XmlElement([Namespace] := "http://www.cohowinery.com")> _  
+    Public Book As Book  
+End Class 'Books  
+  
+<XmlType([Namespace] := "http://www.cpandl.com")> _  
+Public Class Book  
+  
+    <XmlElement([Namespace] := "http://www.cpandl.com")> _  
+    Public TITLE As String  
+    <XmlElement([Namespace] := "http://www.cohowinery.com")> _  
+    Public PRICE As Price  
+End Class  
+  
+Public Class Price  
+    <XmlAttribute([Namespace] := "http://www.cpandl.com")> _  
+    Public currency As String  
+    Public <XmlElement([Namespace] := "http://www.cohowinery.com")> _  
+        price As Decimal  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Serialization;  
+  
+public class Run  
+{  
+    public static void Main()  
+    {  
+        Run test = new Run();  
+        test.SerializeObject("XmlNamespaces.xml");  
+    }  
+    public void SerializeObject(string filename)  
+    {  
+        XmlSerializer mySerializer = new XmlSerializer(typeof(Books));  
+        // Writing a file requires a TextWriter.  
+        TextWriter myWriter = new StreamWriter(filename);  
+  
+        // Creates an XmlSerializerNamespaces and adds two  
+        // prefix-namespace pairs.  
+        XmlSerializerNamespaces myNamespaces =   
+        new XmlSerializerNamespaces();  
+        myNamespaces.Add("books", "http://www.cpandl.com");  
+        myNamespaces.Add("money", "http://www.cohowinery.com");  
+  
+        // Creates a Book.  
+        Book myBook = new Book();  
+        myBook.TITLE = "A Book Title";  
+        Price myPrice = new Price();  
+        myPrice.price = (decimal) 9.95;  
+        myPrice.currency = "US Dollar";  
+        myBook.PRICE = myPrice;  
+        Books myBooks = new Books();  
+        myBooks.Book = myBook;  
+        mySerializer.Serialize(myWriter,myBooks,myNamespaces);  
+        myWriter.Close();  
+    }  
+}  
+  
+public class Books  
+{  
+    [XmlElement(Namespace = "http://www.cohowinery.com")]  
+    public Book Book;  
+}  
+  
+[XmlType(Namespace ="http://www.cpandl.com")]  
+public class Book  
+{  
+    [XmlElement(Namespace = "http://www.cpandl.com")]  
+    public string TITLE;  
+    [XmlElement(Namespace ="http://www.cohowinery.com")]  
+    public Price PRICE;  
+}  
+```  
+  
+## 参照  
+ [XML スキーマ定義ツールと XML シリアル化](../../../docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [XmlSerializer Class](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)   
+ [XmlSerializerNamespaces Class](frlrfSystemXmlSerializationXmlSerializerNamespacesClassTopic)   
+ [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md b/docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md
new file mode 100644
index 00000000000..6897e546404
--- /dev/null
+++ b/docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "シリアル化, SOAP"
+  - "SOAP, XML シリアル化"
+  - "XML シリアル化, SOAP"
+ms.assetid: af406e0a-fa3a-46dd-a7ba-c80731eba3a0
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する
+[コード例](#cpconxmlserializationusingsoapprotocolanchor1)  
+  
+ SOAP メッセージは XML を使用して作成されるため、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) を使用してクラスをシリアル化し、エンコード済みの SOAP メッセージを生成できます。生成される XML は、W3C \(World Wide Web Consortium\) \(www.w3.org\) のドキュメント『Simple Object Access Protocol \(SOAP\) 1.1』のセクション 5 に準拠します。SOAP メッセージを使用して通信を行う XML Web サービスを作成する場合、特殊な SOAP 属性のセットをクラスやクラスのメンバーに適用することで、生成される XML ストリームをカスタマイズできます。属性の一覧については、「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」を参照してください。  
+  
+### オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化するには  
+  
+1.  [XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md) を使用して、クラスを作成します。  
+  
+2.  **System.Xml.Serialization** の特別な属性を 1 つ以上適用します。「エンコード済み SOAP シリアル化を制御する属性」の一覧を参照してください。  
+  
+3.  新しい **SoapReflectionImporter** を作成し、シリアル化されるクラスの型を使用して **ImportTypeMapping** メソッドを呼び出して、**XmlTypeMapping** を作成します。  
+  
+     **SoapReflectionImporter** クラスの **ImportTypeMapping** メソッドを呼び出して **XmlTypeMapping** を作成するコード例を次に示します。  
+  
+    ```vb  
+    ' Serializes a class named Group as a SOAP message.  
+    Dim myTypeMapping As XmlTypeMapping = (New SoapReflectionImporter(). _  
+    ImportTypeMapping(GetType(Group))  
+  
+    ```  
+  
+    ```csharp  
+    // Serializes a class named Group as a SOAP message.  
+    XmlTypeMapping myTypeMapping = (new SoapReflectionImporter().  
+    ImportTypeMapping(typeof(Group));  
+    ```  
+  
+4.  **XmlTypeMapping** を <xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Xml.Serialization.XmlTypeMapping%29> コンストラクターに渡して、**XmlSerializer** クラスのインスタンスを作成します。  
+  
+    ```vb  
+    Dim mySerializer As XmlSerializer = New XmlSerializer(myTypeMapping)  
+  
+    ```  
+  
+    ```csharp  
+    XmlSerializer mySerializer = new XmlSerializer(myTypeMapping);  
+    ```  
+  
+5.  **Serialize** メソッドまたは **Deserialize** メソッドを呼び出します。  
+  
+## 使用例  
+  
+```vb  
+' Serializes a class named Group as a SOAP message.  
+Dim myTypeMapping As XmlTypeMapping = (New SoapReflectionImporter(). _  
+ImportTypeMapping(GetType(Group))  
+Dim mySerializer As XmlSerializer = New XmlSerializer(myTypeMapping)  
+  
+```  
+  
+```csharp  
+// Serializes a class named Group as a SOAP message.  
+XmlTypeMapping myTypeMapping = (new SoapReflectionImporter().ImportTypeMapping(typeof(Group));  
+XmlSerializer mySerializer = new XmlSerializer(myTypeMapping);  
+```  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)   
+ [XML Web サービスを使用した XML シリアル化](../../../docs/framework/serialization/xml-serialization-with-xml-web-services.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)   
+ [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-serialize-an-object.md b/docs/framework/serialization/how-to-serialize-an-object.md
new file mode 100644
index 00000000000..57c6f707081
--- /dev/null
+++ b/docs/framework/serialization/how-to-serialize-an-object.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : オブジェクトをシリアル化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "オブジェクト, シリアル化の手順"
+  - "オブジェクトのシリアル化"
+ms.assetid: a1207d05-32b2-4953-8582-959607991227
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : オブジェクトをシリアル化する
+オブジェクトをシリアル化するには、まず、シリアル化の対象となるオブジェクトを作成し、パブリック プロパティとパブリック フィールドを設定します。この処理を行うには、転送形式、つまり XML ストリームをストリームとファイルのいずれとして格納するかを決定する必要があります。たとえば、XML ストリームを永続的な形式で保存する必要がある場合は、[FileStream](frlrfSystemIOFileStreamClassTopic) オブジェクトを作成します。  
+  
+> [!NOTE]
+>  XML シリアル化の例については、「[XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)」を参照してください。  
+  
+### オブジェクトをシリアル化するには  
+  
+1.  オブジェクトを作成し、パブリック フィールドとパブリック プロパティを設定します。  
+  
+2.  そのオブジェクトの型を使用して、<xref:System.Xml.Serialization.XmlSerializer> を構築します。詳細については、<xref:System.Xml.Serialization.XmlSerializer> クラスのコンストラクターを参照してください。  
+  
+3.  <xref:System.Xml.Serialization.XmlSerializer.Serialize%2A> メソッドを呼び出して、オブジェクトのパブリック プロパティとパブリック フィールドを XML ストリーム形式またはファイル形式のいずれかで生成します。ファイルを作成する例を次に示します。  
+  
+    ```vb  
+    Dim myObject As MySerializableClass = New MySerializableClass()  
+    ' Insert code to set properties and fields of the object.  
+    Dim mySerializer As XmlSerializer = New XmlSerializer(GetType(MySerializableClass))  
+    ' To write to a file, create a StreamWriter object.  
+    Dim myWriter As StreamWriter = New StreamWriter("myFileName.xml")  
+    mySerializer.Serialize(myWriter, myObject)  
+    myWriter.Close()  
+    ```  
+  
+    ```csharp  
+    MySerializableClass myObject = new MySerializableClass();  
+    // Insert code to set properties and fields of the object.  
+    XmlSerializer mySerializer = new   
+    XmlSerializer(typeof(MySerializableClass));  
+    // To write to a file, create a StreamWriter object.  
+    StreamWriter myWriter = new StreamWriter("myFileName.xml");  
+    mySerializer.Serialize(myWriter, myObject);  
+    myWriter.Close();  
+    ```  
+  
+## 参照  
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md b/docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md
new file mode 100644
index 00000000000..0f0c3e7b8dd
--- /dev/null
+++ b/docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md
@@ -0,0 +1,111 @@
+---
+title: "方法 : XML ストリームの代替要素名を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス, オーバーライド"
+  - "クラスのオーバーライド"
+  - "XML シリアル化のオーバーライド"
+  - "シリアル化, オーバーライド"
+  - "XML シリアル化, オーバーライド"
+  - "XML ストリーム, 代替要素名の指定"
+ms.assetid: 5cc1c0b0-f94b-4525-9a41-88a582cd6668
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : XML ストリームの代替要素名を指定する
+[コード例](#cpconoverridingserializationofclasseswithxmlattributeoverridesclassanchor1)  
+  
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) を使用して、クラスのセットが同じである XML ストリームを複数生成できます。このような作業が必要になるのは、2 つの異なる XML Web サービスが、若干の違いのある同じ基本情報を要求するような場合です。たとえば、書籍の注文を処理する 2 つの XML Web サービスがあり、どちらにも ISBN 番号が必要であるとします。一方のサービスは \<ISBN\> タグを使用しますが、もう一方は \<BookID\> タグを使用します。`ISBN` という名前のフィールドを含む、`Book` という名前のクラスがあります。`Book` クラスのインスタンスがシリアル化されると、既定では、メンバー名 \(ISBN\) がタグ要素名として使用されます。最初の XML Web サービスの場合、この既定どおりで問題ありません。一方、2 つ目の XML Web サービスに XML ストリームを送信するには、タグの要素名が `BookID` になるようにシリアル化をオーバーライドする必要があります。  
+  
+### 代替要素名で XML ストリームを作成するには  
+  
+1.  [XmlElementAttribute](frlrfSystemXmlSerializationXmlElementAttributeClassTopic) クラスのインスタンスを作成します。  
+  
+2.  <xref:System.Xml.Serialization.XmlElementAttribute> の <xref:System.Xml.Serialization.XmlElementAttribute.ElementName%2A> を "BookID" に設定します。  
+  
+3.  [XmlAttributes](frlrfSystemXmlSerializationXmlAttributesClassTopic) クラスのインスタンスを作成します。  
+  
+4.  **XmlElementAttribute** オブジェクトを <xref:System.Xml.Serialization.XmlAttributes> の <xref:System.Xml.Serialization.XmlAttributes.XmlElements%2A> プロパティによってアクセスされるコレクションに追加します。  
+  
+5.  [XmlAttributeOverrides](frlrfSystemXmlSerializationXmlAttributeOverridesClassTopic) クラスのインスタンスを作成します。  
+  
+6.  **XmlAttributes** を <xref:System.Xml.Serialization.XmlAttributeOverrides> に追加し、オーバーライドするオブジェクトの型とオーバーライドされるメンバーの名前を渡します。  
+  
+7.  **XmlAttributeOverrides** を使用して、**XmlSerializer** クラスのインスタンスを作成します。  
+  
+8.  `Book` クラスのインスタンスを作成し、シリアル化または逆シリアル化します。  
+  
+## 使用例  
+  
+```vb  
+Public Class SerializeOverride()  
+    ' Creates an XmlElementAttribute with the alternate name.  
+    Dim myElementAttribute As XmlElementAttribute = _  
+    New XmlElementAttribute()  
+    myElementAttribute.ElementName = "BookID"  
+    Dim myAttributes As XmlAttributes = New XmlAttributes()  
+    myAttributes.XmlElements.Add(myElementAttribute)  
+    Dim myOverrides As XmlAttributeOverrides = New XmlAttributeOverrides()  
+    myOverrides.Add(typeof(Book), "ISBN", myAttributes)  
+    Dim mySerializer As XmlSerializer = _  
+    New XmlSerializer(GetType(Book), myOverrides)  
+    Dim b As Book = New Book()  
+    b.ISBN = "123456789"  
+    ' Creates a StreamWriter to write the XML stream to.  
+    Dim writer As StreamWriter = New StreamWriter("Book.xml")  
+    mySerializer.Serialize(writer, b);  
+End Class  
+  
+```  
+  
+```csharp  
+public class SerializeOverride()  
+{  
+    // Creates an XmlElementAttribute with the alternate name.  
+    XmlElementAttribute myElementAttribute = new XmlElementAttribute();  
+    myElementAttribute.ElementName = "BookID";  
+    XmlAttributes myAttributes = new XmlAttributes();  
+    myAttributes.XmlElements.Add(myElementAttribute);  
+    XmlAttributeOverrides myOverrides = new XmlAttributeOverrides();  
+    myOverrides.Add(typeof(Book), "ISBN", myAttributes);  
+    XmlSerializer mySerializer =   
+    new XmlSerializer(typeof(Book), myOverrides)  
+    Book b = new Book();  
+    b.ISBN = "123456789"  
+    // Creates a StreamWriter to write the XML stream to.  
+    StreamWriter writer = new StreamWriter("Book.xml");  
+    mySerializer.Serialize(writer, b);  
+}  
+```  
+  
+ XML ストリームは、次のようになります。  
+  
+```  
+<Book>  
+    <BookID>123456789</BookID>  
+</Book>  
+```  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [XmlElementAttribute](frlrfSystemXmlSerializationXmlElementAttributeClassTopic)   
+ [XmlAttributes](frlrfSystemXmlSerializationXmlAttributesClassTopic)   
+ [XmlAttributeOverrides](frlrfSystemXmlSerializationXmlAttributeOverridesClassTopic)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/index.md b/docs/framework/serialization/index.md
new file mode 100644
index 00000000000..e517c271183
--- /dev/null
+++ b/docs/framework/serialization/index.md
@@ -0,0 +1,68 @@
+---
+title: "シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化"
+  - "オブジェクト, シリアル化"
+  - "シリアル化"
+  - "オブジェクトのシリアル化"
+  - "XML シリアル化, が定義されている場合"
+ms.assetid: 4d1111c0-9447-4231-a997-96a2b74b3453
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# シリアル化
+シリアル化とは、オブジェクトの状態を永続化または転送できる形式に変換するプロセスのことです。シリアル化を補完するプロセスとして、ストリームをオブジェクトに変換する逆シリアル化があります。これらのプロセスを組み合わせて使用することで、データを簡単に格納および転送できます。  
+  
+ .NET Framework には、次の 2 つのシリアル化技術が用意されています。  
+  
+-   バイナリ シリアル化は、型そのものを正確に維持するため、アプリケーションを次回起動するまでの間、オブジェクトの状態を維持するのに役立ちます。たとえば、クリップボードを出力先としてオブジェクトをシリアル化することによって、そのオブジェクトを異なるアプリケーション間で共有できます。オブジェクトをシリアル化して、ストリーム、ディスク、メモリ、ネットワーク上などに出力できます。リモート処理では、シリアル化を使用して、コンピューター間やアプリケーション ドメイン間でオブジェクトを "値渡し" します。  
+  
+-   XML シリアル化では、パブリック プロパティとパブリック フィールドのみがシリアル化され、型そのものは維持されません。これは、データを使用するアプリケーションに制限を加えずに、データを提供または処理する場合に有効です。XML はオープン標準であるため、Web 経由でデータを共有する場合には有用な選択肢となります。SOAP も同様のオープン標準であるため、有用な選択肢です。  
+  
+## このセクションの内容  
+ [シリアル化に関する「方法」トピック](../../../docs/framework/serialization/serialization-how-to-topics.md)  
+ このセクションに含まれる、方法を説明したトピックへのリンクを示します。  
+  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)  
+ 共通言語ランタイムに付属しているバイナリ シリアル化機構について説明します。  
+  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)  
+ 共通言語ランタイムに付属している XML シリアル化および SOAP シリアル化機構について説明します。  
+  
+ [シリアル化ツール](../../../docs/framework/serialization/serialization-tools.md)  
+ これらのツールは、シリアル化コードの開発に役立ちます。  
+  
+ [シリアル化のサンプル](../../../docs/framework/serialization/serialization-samples.md)  
+ サンプルでは、シリアル化の方法を示します。  
+  
+## 関連項目  
+ <xref:System.Runtime.Serialization>  
+ オブジェクトのシリアル化と逆シリアル化に使用できるクラスが含まれています。  
+  
+ <xref:System.Xml.Serialization>  
+ オブジェクトを XML 形式のドキュメントまたはストリームにシリアル化するために使用できるクラスが含まれています。  
+  
+## 関連項目  
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)  
+ .NET Framework でリモート通信に利用できるさまざまな通信方法について説明します。  
+  
+ [Advanced Development Technologies](http://msdn.microsoft.com/ja-jp/c4a7e341-f0c6-4df4-a74f-223387ac6e4e)  
+ .NET Framework での高度な開発タスクと技法に関する詳細情報へのリンクを示します。  
+  
+ [XML Web Services Created Using ASP.NET and XML Web Service Clients](http://msdn.microsoft.com/ja-jp/1e64af78-d705-4384-b08d-591a45f4379c)  
+ ASP.NET を使用して作成した XML Web サービスのプログラミング方法について説明するトピックを示します。
\ No newline at end of file
diff --git a/docs/framework/serialization/introducing-xml-serialization.md b/docs/framework/serialization/introducing-xml-serialization.md
new file mode 100644
index 00000000000..fa742866807
--- /dev/null
+++ b/docs/framework/serialization/introducing-xml-serialization.md
@@ -0,0 +1,190 @@
+---
+title: "XML シリアル化の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataSet クラス, シリアル化"
+  - "ICollection インターフェイス, シリアル化"
+  - "シリアル化, シリアル化について"
+  - "XML スキーマ, シリアル化"
+  - "XML シリアル化, XML シリアル化について"
+  - "XmlSerializer クラス, シリアル化"
+ms.assetid: 8c63200d-db63-4a03-a93d-21641623df62
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# XML シリアル化の概要
+シリアル化とは、転送できる形式にオブジェクトを変換するプロセスのことです。たとえば、オブジェクトをシリアル化し、HTTP を使用してインターネット経由でクライアントとサーバー間で転送できます。一方、逆シリアル化とは、ストリームから元のオブジェクトを再構築する処理です。  
+  
+ XML シリアル化では、オブジェクトのパブリック フィールドとプロパティ値のみを XML ストリームにシリアル化します。型情報は対象に含まれません。たとえば、**Library** 名前空間に **Book** オブジェクトがある場合、逆シリアル化時に、ストリームから同じ型のオブジェクトが再構築されるという保証はありません。  
+  
+> [!NOTE]
+>  XML シリアル化では、メソッド、インデクサー、プライベート フィールド、または読み取り専用プロパティ \(読み取り専用コレクションを除く\) は変換されません。オブジェクトのフィールドとプロパティをすべてシリアル化するには、パブリックとプライベートのいずれの場合も、XML シリアル化ではなく、<xref:System.Runtime.Serialization.DataContractSerializer> を使用します。  
+  
+ XML シリアル化の中核となるクラスは [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) クラスです。このクラスの最も重要なメソッドは、**Serialize** メソッドと **Deserialize** メソッドです。<xref:System.Xml.Serialization.XmlSerializer> は、C\# ファイルを作成し、これを .dll ファイルにコンパイルすることによってシリアル化を行います。.NET Framework 2.0 では、これらのシリアル化アセンブリをあらかじめ生成してアプリケーションと共に配置し、起動時のパフォーマンスを向上させるため、[XML シリアライザー ジェネレーター ツール \(Sgen.exe\)](../../../docs/framework/serialization/xml-serializer-generator-tool-sgen-exe.md) が用意されています。**XmlSerializer** によって生成される XML ストリームは、W3C \(World Wide Web Consortium\) \(www.w3.org\) による勧告『XML Schema definition language \(XSD\) 1.0』に準拠します。さらに、生成されるデータ型は、ドキュメント『XML Schema Part 2: Datatypes』に準拠します。  
+  
+ オブジェクトのデータは、クラス、フィールド、プロパティ、プリミティブ型、配列などのプログラミング構成要素、および **XmlElement** オブジェクトまたは **XmlAttribute** オブジェクトの形で埋め込まれている XML を使用して記述されます。属性で注釈を付けて独自のクラスを作成するか、または XML スキーマ定義ツールを使用して、既存の XML スキーマに基づいたクラスを生成できます。  
+  
+ XML スキーマがある場合は、XML スキーマ定義ツールを実行して、そのスキーマに厳密に型指定された一連のクラスを生成し、属性を使用して注釈を付けることができます。このようなクラスのインスタンスをシリアル化すると、元の XML スキーマに準拠した XML が生成されます。このようなクラスを用意することにより、操作が簡単なオブジェクト モデルを使用してプログラミングできると同時に、生成される XML も確実に XML スキーマに準拠したものになります。.NET Framework の他のクラス \(**XmlReader** クラス、**XmlWriter** クラスなど\) を使用する代わりに、この方法を使用して XML ストリームの解析や書き込みを実行できます。詳細については、「[XML ドキュメントと XML データ](../../../docs/standard/data/xml/index.md)」を参照してください。これらのクラスを使用すると、任意の XML ストリームを解析できます。これに対し、既知の XML スキーマに準拠した XML ストリームが求められる場合には、**XmlSerializer** を使用します。  
+  
+ 属性を使用して XML ストリームの XML 名前空間、要素名、属性名などを設定することで、**XmlSerializer** クラスによって生成される XML ストリームを制御できます。これらの属性、および属性による XML シリアル化の制御方法については、「[属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)」を参照してください。また、生成される XML を制御するこれらの属性の一覧については、「[XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)」を参照してください。  
+  
+ さらに、**XmlSerializer** クラスでは、オブジェクトをシリアル化し、エンコードされた SOAP XML ストリームを生成することができます。このようにして生成される XML は、W3C のドキュメント『Simple Object Access Protocol \(SOAP\) 1.1』のセクション 5 に準拠します。このプロセスの詳細については、「[方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)」を参照してください。生成される XML を制御する属性の一覧については、「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」を参照してください。  
+  
+ **XmlSerializer** クラスは、XML Web サービスによって作成され、XML Web サービスに渡される SOAP メッセージを生成します。この SOAP メッセージを制御するには、XML Web サービス ファイル \(.asmx\) 内のクラス、戻り値、パラメーター、およびフィールドに属性を適用します。XML Web サービスでは、リテラルまたはエンコード済みのいずれの SOAP スタイルも使用できるため、「XML シリアル化を制御する属性」と「エンコード済み SOAP シリアル化を制御する属性」の両方に示されている属性を使用できます。XML Web サービスによって生成された XML を属性を使用して制御する方法については、「[XML Web サービスを使用した XML シリアル化](../../../docs/framework/serialization/xml-serialization-with-xml-web-services.md)」を参照してください。SOAP と XML Web サービスの詳細については、「[Customizing SOAP Messages](http://msdn.microsoft.com/ja-jp/1d777288-c0d9-4e6a-b638-f010da031952)」を参照してください。  
+  
+## XmlSerializer アプリケーションのセキュリティに関する考慮事項  
+ **XmlSerializer** クラスを使用するアプリケーションを作成する場合は、次の項目とその影響に注意してください。  
+  
+-   **XmlSerializer** は、TEMP 環境変数で指定されたディレクトリ内に C\# ファイル \(.cs\) を作成し、これらを .dll ファイルにコンパイルします。シリアル化はこれらの DLL で行われます。  
+  
+    > [!NOTE]
+    >  SGen.exe ツールを使用すると、このシリアル化アセンブリを事前に生成して署名することができます。これは、サーバー側の Web サービスに対しては機能せず、クライアント側での手動シリアル化にのみ使用できます。  
+  
+     作成時とコンパイル時、このコードと DLL には悪意のあるプロセスに対する脆弱性があります。Microsoft Windows NT 4.0 以降を実行しているコンピューターでは、複数のユーザーが一時ディレクトリを共有する可能性があります。2 つのアカウントが異なるセキュリティ特権を持ち、高い特権を持つアカウントが **XmlSerializer** を使用してアプリケーションを実行する場合、一時ディレクトリの共有は危険です。この場合、一方のユーザーが .cs ファイルまたはコンパイルされた .dll ファイルのいずれかを置き換えることにより、コンピューターのセキュリティが侵害される可能性があります。これを防ぐためには、コンピューター上の各アカウントが常に固有のプロファイルを持つようにしてください。既定では、TEMP 環境変数はアカウントごとに異なるディレクトリを示します。  
+  
+-   悪意のあるユーザーが XML データの連続ストリームを Web サーバーに送り続けた場合 \(サービス拒否攻撃\)、**XmlSerializer** はコンピューターがリソース不足に陥るまでデータの処理を続行します。  
+  
+     インターネット インフォメーション サービス \(IIS\) を実行しているコンピューターを使用し、IIS 内でアプリケーションを実行することによって、この種の攻撃を防ぐことができます。IIS には、一定量 \(既定では 4 KB\) を超える長さのストリームを処理しないゲート機能があります。IIS を使用しないアプリケーションを作成し、**XmlSerializer** による逆シリアル化を行う場合は、同様のゲート機能を実装してサービス拒否攻撃を防ぐ必要があります。  
+  
+-   **XmlSerializer** はデータをシリアル化し、指定された任意の型を使用してすべてのコードを実行します。  
+  
+     悪意のあるオブジェクトが脅威を与える方法には、次の 2 とおりがあります。悪意のあるコードを実行する方法と、**XmlSerializer** によって作成された C\# ファイルに悪意のあるコードを挿入する方法です。最初のケースでは、悪意のあるオブジェクトが破壊的なプロシージャを実行しようとしたときに、コード アクセス セキュリティによって実行が防止され、被害を防ぐことができます。2 番目のケースでは、**XmlSerializer** によって作成された C\# ファイルに、悪意のあるオブジェクトがなんらかの方法でコードを挿入する可能性が論理的にあります。この問題は十分に調査されており、このような攻撃を受ける可能性は低いと考えられますが、不明または信頼されていない型のデータは絶対にシリアル化しないことが重要です。  
+  
+-   機密情報をシリアル化すると脆弱性が生じる可能性があります。  
+  
+     **XmlSerializer** がシリアル化したデータは、XML ファイルなどのデータ ストアとして格納されます。このデータ ストアが他のプロセスからも利用できたり、イントラネットまたはインターネットで表示できたりする場合、データの盗用や悪用の可能性が生じます。たとえば、クレジット カード番号を含む注文をシリアル化するアプリケーションを作成すると、データは非常に脆弱になります。これを避けるには、データ ストアを常に保護し、機密を保つための処置が必要です。  
+  
+## 単純なクラスのシリアル化  
+ パブリック フィールドを持つ基本クラスのコード例を次に示します。  
+  
+```vb  
+Public Class OrderForm  
+    Public OrderDate As DateTime  
+End Class  
+  
+```  
+  
+```csharp  
+public class OrderForm  
+{  
+    public DateTime OrderDate;  
+}  
+```  
+  
+ このクラスのインスタンスをシリアル化すると、次のようなストリームが生成されます。  
+  
+```  
+<OrderForm>  
+    <OrderDate>12/12/01</OrderDate>  
+</OrderForm>  
+```  
+  
+ シリアル化の例については、「[XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)」を参照してください。  
+  
+## シリアル化できる項目  
+ **XmLSerializer** クラスを使用して、次の項目をシリアル化できます。  
+  
+-   パブリックな読み取り\/書き込みプロパティとパブリック クラスのフィールド  
+  
+-   **ICollection** または **IEnumerable** を実装するクラス  
+  
+    > [!NOTE]
+    >  パブリック プロパティではなく、コレクションのみがシリアル化されます。  
+  
+-   **XmlElement** オブジェクト  
+  
+-   **XmlNode** オブジェクト  
+  
+-   **DataSet** オブジェクト  
+  
+ オブジェクトのシリアル化と逆シリアル化の詳細については、「[方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)」および「[方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)」参照してください。  
+  
+## XML シリアル化を使用する利点  
+ **XmlSerializer** クラスを使用すると、オブジェクトを XML としてシリアル化するときに、シリアル化を完全かつ柔軟に制御できます。XML Web サービスを作成する場合は、シリアル化を制御する属性をクラスやメンバーに適用して、XML 出力を特定のスキーマに準拠させることができます。  
+  
+ たとえば、**XmlSerializer** を使用すると、次のような内容を指定できます。  
+  
+-   フィールドやプロパティを属性または要素としてエンコードするかどうか  
+  
+-   使用する XML 名前空間  
+  
+-   要素または属性の名前 \(フィールド名やプロパティ名が適切ではない場合\)  
+  
+ XML シリアル化のもう 1 つの利点は、生成される XML ストリームが特定のスキーマに準拠している限りは、開発するアプリケーションに制約が課されないことです。たとえば、書籍の説明に使用するスキーマがあるとします。このスキーマでは、書籍名、著者、出版社、ISBN 番号などの要素を扱います。書籍発注や在庫管理など、この XML データを任意の方法で処理するアプリケーションを開発できます。いずれの場合も、指定された XML スキーマ定義言語 \(XSD\) スキーマに XML ストリームが準拠していることが唯一の要件です。  
+  
+## XML シリアル化に関する考慮事項  
+ **XmlSerializer** クラスを使用する場合には、次の点を考慮する必要があります。  
+  
+-   Sgen.exe ツールは、特に、シリアル化アセンブリを生成して最適なパフォーマンスを実現するように設計されています。  
+  
+-   シリアル化されたデータには、データ自体とクラスの構造のみが含まれます。型の ID やアセンブリの情報は含まれません。  
+  
+-   シリアル化できるのは、パブリック プロパティとパブリック フィールドのみです。プロパティにパブリック アクセサー \(get メソッドおよび set メソッド\) が存在する必要があります。非パブリック データをシリアル化する必要がある場合は、XML シリアル化ではなく <xref:System.Runtime.Serialization.DataContractSerializer> クラスを使用します。  
+  
+-   クラスを **XmlSerializer** でシリアル化するには、そのクラスが既定のコンストラクターを持つ必要があります。  
+  
+-   メソッドはシリアル化できません。  
+  
+-   **IEnumerable** または **ICollection** を異なる方法で実装しているクラスは、次のような特定の要件を満たしていれば、**XmlSerializer** で処理できます。  
+  
+     **IEnumerable** を実装するクラスは、単一のパラメーターを受け取るパブリックな **Add** メソッドを実装している必要があります。**Add** メソッドのパラメーターは、**GetEnumerator** メソッドによって返される **IEnumerator.Current** プロパティから返される型と一致している \(ポリモーフィックである\) 必要があります。  
+  
+     **IEnumerable** の他に **ICollection** も実装するクラス \(**CollectionBase** など\) は、整数を受け取るパブリックなインデックス付き **Item** プロパティ \(C\# の場合はインデクサー\) と、**integer** 型のパブリックな **Count** プロパティを持つ必要があります。**Add** メソッドに渡されるパラメーターは、**Item** プロパティから返された型と同じ型か、またはその型の基本型の 1 つである必要があります。  
+  
+     **ICollection** を実装するクラスの場合、シリアル化される値は、**GetEnumerator** を呼び出して取得されるのではなく、インデックス付き **Item** プロパティから取得されます。また、パブリック フィールドとパブリック プロパティは、別のコレクション クラス \(**ICollection** を実装するクラス\) を返すパブリック フィールドを除き、シリアル化されません。例については、「[XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)」を参照してください。  
+  
+## XSD データ型のマッピング  
+ W3C \(World Wide Web Consortium\) \(www.w3.org\) のドキュメント『XML Schema Part 2: Datatypes』では、XML スキーマ定義言語 \(XSD\) スキーマで使用できる単純なデータ型が指定されています。これらのデータ型の多く \(**int**、**decimal** など\) については、対応するデータ型が .NET Framework にあります。ただし、**NMTOKEN** データ型など、.NET Framework には対応するものがない XML データ型もあります。その場合、XML スキーマ定義ツール \([XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)\) を使用してスキーマからクラスを生成すると、適切な属性が文字列型のメンバーに適用され、その **DataType** プロパティが XML データ型名に設定されます。たとえば、XML データ型が **NMTOKEN** である "MyToken" という名前の要素がスキーマに含まれている場合、生成されるクラスには、次の例に示すようなメンバーが含まれます。  
+  
+```vb  
+<XmlElement(DataType:="NMTOKEN")> _  
+Public MyToken As String  
+  
+```  
+  
+```csharp  
+[XmlElement(DataType = "NMTOKEN")]  
+public string MyToken;  
+```  
+  
+ 同様に、特定の XML スキーマ \(XSD\) に準拠する必要があるクラスを作成する場合は、そのクラスに適切な属性を適用し、**DataType** プロパティを必要な XML データ型名に設定する必要があります。  
+  
+ 型のマップの一覧については、次の属性クラスの **DataType** プロパティを参照してください。  
+  
+-   <xref:System.Xml.Serialization.SoapAttributeAttribute>  
+  
+-   <xref:System.Xml.Serialization.SoapElementAttribute>  
+  
+-   <xref:System.Xml.Serialization.XmlArrayItemAttribute>  
+  
+-   <xref:System.Xml.Serialization.XmlAttributeAttribute>  
+  
+-   <xref:System.Xml.Serialization.XmlElementAttribute>  
+  
+-   <xref:System.Xml.Serialization.XmlRootAttribute>  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [XMLSerializer.Serialize](frlrfSystemXmlSerializationXmlSerializerClassSerializeTopic)   
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [シリアル化](../../../docs/framework/serialization/index.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [FileStream](frlrfSystemIOFileStreamClassTopic)   
+ [XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/marshal-by-value.md b/docs/framework/serialization/marshal-by-value.md
new file mode 100644
index 00000000000..c684f0aac0f
--- /dev/null
+++ b/docs/framework/serialization/marshal-by-value.md
@@ -0,0 +1,34 @@
+---
+title: "値渡しによるマーシャリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 値渡しによるマーシャリング"
+  - "値渡しのマーシャリング オブジェクト"
+  - "シリアル化, 値渡しによるマーシャリング"
+ms.assetid: ee91e8f0-92e0-4732-8015-d17dee154be1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 値渡しによるマーシャリング
+オブジェクトは、作成されたアプリケーション ドメイン内でのみ有効です。オブジェクトをパラメーターとして渡したり、結果として返したりする処理を試行すると、そのオブジェクトが [MarshalByRefObject](frlrfSystemMarshalByRefObjectClassTopic) から派生しているか、または [Serializable](frlrfSystemSerializableAttributeClassTopic) としてマークされている場合を除いて、その試行は失敗します。**Serializable** としてマークされていると、オブジェクトは自動的にシリアル化され、アプリケーション ドメイン間で転送されます。その後、逆シリアル化され、転送先のアプリケーション ドメインにそのオブジェクトの同一コピーが作成されます。この処理は一般に、値渡しによるマーシャリングと呼ばれます。  
+  
+ オブジェクトが **MarshalByRefObject** から派生している場合は、そのオブジェクト自体ではなく、オブジェクト参照がアプリケーション ドメイン間で渡されます。**MarshalByRefObject** から派生したオブジェクトを、**Serializable** としてマークすることもできます。このオブジェクトがリモート処理で使用されると、サロゲート セレクター \([SurrogateSelector](frlrfSystemRuntimeSerializationSurrogateSelectorClassTopic)\) によって事前構成された、シリアル化を実行するフォーマッタがシリアル化プロセスを制御し、[MarshalByRefObject](frlrfSystemMarshalByRefObjectClassTopic) から派生したすべてのオブジェクトをプロキシに置き換えます。[SurrogateSelector](frlrfSystemRuntimeSerializationSurrogateSelectorClassTopic) を使用しない場合、シリアル化アーキテクチャは「[シリアル化プロセスの手順](../../../docs/framework/serialization/steps-in-the-serialization-process.md)」で説明されている標準のシリアル化のルールに従います。  
+  
+## 参照  
+ [シリアル化の概念](../../../docs/framework/serialization/serialization-concepts.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/persistent-storage.md b/docs/framework/serialization/persistent-storage.md
new file mode 100644
index 00000000000..fac1ab4ff34
--- /dev/null
+++ b/docs/framework/serialization/persistent-storage.md
@@ -0,0 +1,36 @@
+---
+title: "永続ストレージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 永続ストレージ"
+  - "永続ストレージ"
+  - "シリアル化, 永続ストレージ"
+ms.assetid: b112c0dd-93e2-4eef-908d-5963f80bab65
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 永続ストレージ
+オブジェクトのフィールドの値をディスクに格納しておき、後でこのデータを取得する必要が生じることはよくあります。これはシリアル化を使用しなくても簡単に実現できますが、シリアル化を使用しない方法は煩雑でエラーの原因となることが多く、オブジェクトの階層を追跡する必要がある場合にはさらに複雑になります。何千ものオブジェクトを含む大規模なビジネス アプリケーションを作成し、それぞれのオブジェクトのフィールドやプロパティをディスクに保存したり、ディスクから復元したりするコードを記述することを想像してみてください。シリアル化は、この目的を実現するための便利なメカニズムを提供します。  
+  
+ 共通言語ランタイムは、オブジェクトがメモリに格納される方法を管理し、[リフレクション](../../../docs/framework/reflection-and-codedom/reflection.md)を使用して自動シリアル化のメカニズムを提供します。オブジェクトをシリアル化すると、クラスの名前、アセンブリ、およびそのクラス インスタンスのすべてのデータ メンバーがストレージに書き込まれます。オブジェクトのメンバー変数には、他のインスタンスへの参照が格納されていることがよくあります。クラスをシリアル化するとき、シリアル化エンジンは、既にシリアル化されている参照先オブジェクトを追跡し、同じオブジェクトが複数回シリアル化されないようにします。[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] に用意されているシリアル化アーキテクチャは、オブジェクト グラフおよび循環参照を自動的に正しく処理します。オブジェクト グラフに対する唯一の要件は、シリアル化されたオブジェクトによって参照されるすべてのオブジェクトを、[Serializable](frlrfSystemSerializableAttributeClassTopic) としてもマークすることです。詳細については、「[基本的なシリアル化](../../../docs/framework/serialization/basic-serialization.md)」を参照してください。Serializable としてマークしないと、マークされていないオブジェクトをシリアライザーがシリアル化しようとしたときに例外がスローされます。  
+  
+ シリアル化されたクラスを逆シリアル化すると、そのクラスが再作成され、すべてのデータ メンバーの値は自動的に復元されます。  
+  
+## 参照  
+ [シリアル化の概念](../../../docs/framework/serialization/serialization-concepts.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/schemaimporterextension-technology-sample.md b/docs/framework/serialization/schemaimporterextension-technology-sample.md
new file mode 100644
index 00000000000..4f70006dfd5
--- /dev/null
+++ b/docs/framework/serialization/schemaimporterextension-technology-sample.md
@@ -0,0 +1,62 @@
+---
+title: "SchemaImporterExtension の技術サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f5eb78f-0ef6-433a-b095-3a63b1ce0bc9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# SchemaImporterExtension の技術サンプル
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Xml%20Serialization/SchemaImporterExtension.zip.exe)  
+  
+ このサンプルでは、XML スキーマをインポートするときのコード生成を微調整する、<xref:System.Xml.Serialization.Advanced.SchemaImporterExtension> のカスタム化を示します。このアプリケーションは、この拡張機能のビルド、登録および起動の方法を示しています。  
+  
+### コマンド プロンプトを使用してサンプルをビルドするには  
+  
+1.  コマンド プロンプト ウィンドウを開き、サンプルが格納されている、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  コマンド ラインで「**msbuild.exe OrderSchemaImporterExtension.sln**」と入力します。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、サンプルが格納されている、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  OrderSchemaImporterExtension.sln ファイルのアイコンをダブルクリックして、このファイルを Visual Studio で開きます。  
+  
+3.  \[ビルド\] メニューの \[ソリューションのビルド\] をクリックします。  
+  
+ アプリケーションは、既定の \\bin ディレクトリまたは \\bin\\Debug ディレクトリにビルドされます。  
+  
+### サンプルを実行するには  
+  
+1.  コマンド プロンプトを使用して、新しい実行可能ファイルが格納されているディレクトリに移動します。  
+  
+2.  コマンド ラインで実行ファイル名を入力します。  
+  
+## 解説  
+ サンプルのバイナリ ファイルを作成する方法およびサンプルを登録する手順の詳細については、ソース コード ファイルおよび build.proj ファイル内のコメントを参照してください。  
+  
+## 参照  
+ <xref:System.CodeDom.CodeCompileUnit>   
+ <xref:System.CodeDom.CodeNamespace>   
+ <xref:System.CodeDom.CodeNamespaceImport>   
+ <xref:Microsoft.CSharp.CSharpCodeProvider>   
+ <xref:System.Xml.Serialization.IXmlSerializable>   
+ <xref:System.Xml.Serialization.Advanced.SchemaImporterExtension>   
+ <xref:System.CodeDom>   
+ <xref:System.CodeDom.Compiler>   
+ <xref:System.Web.Services.Description>   
+ <xref:System.Web.Services.Discovery>   
+ <xref:System.Xml.Serialization>   
+ <xref:System.Uri>   
+ <xref:Microsoft.VisualBasic.VBCodeProvider>   
+ <xref:System.Web.Services.Description.WebReference>   
+ <xref:System.Xml.Serialization.XmlSchemaImporter>
\ No newline at end of file
diff --git a/docs/framework/serialization/schemaimporterextensions-element.md b/docs/framework/serialization/schemaimporterextensions-element.md
new file mode 100644
index 00000000000..5a1ee43573a
--- /dev/null
+++ b/docs/framework/serialization/schemaimporterextensions-element.md
@@ -0,0 +1,70 @@
+---
+title: "&lt;schemaImporterExtensions&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<schemaImporterExtensions> 要素"
+  - "schemaImporterExtensions 要素"
+  - "XML シリアル化, 構成"
+ms.assetid: 465ef2a0-f909-4ac1-9a56-0ead5c849698
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# &lt;schemaImporterExtensions&gt; 要素
+XSD の型を .NET Framework の型にマッピングするために <xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を含みます。  構成ファイルの詳細については、「[構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<schemaImporterExtensions>  
+    <!-- Add types -->  
+</SchemaImporterExtension>  
+```  
+  
+## 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<xmlSchemaImporterExtensions\> の \<add\> 要素](../../../docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md)|マッピングを作成するために <xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を追加します。|  
+  
+## 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)|XML シリアル化を制御する最上位の要素です。|  
+  
+## 使用例  
+ XSD の型を .NET Framework の型にマッピングする際に <xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を追加する方法を次のコード例に示します。  
+  
+```  
+<system.xml.serialization>  
+    <schemaImporterExtensions>  
+        <add name = "MobileCapabilities" type =   
+        "System.Web.Mobile.MobileCapabilities,   
+        System.Web.Mobile, Version - 2.0.0.0, Culture = neutral,   
+        PublicKeyToken = b03f5f6f11d40a3a" />  
+    </schemaImporterExtensions>  
+/system.sxml.serializaiton>  
+```  
+  
+## 参照  
+ <xref:System.Xml.Serialization.XmlSchemaImporter>   
+ <xref:System.Xml.Serialization.Configuration.DateTimeSerializationSection.DateTimeSerializationMode>   
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<dateTimeSerialization\> 要素](../../../docs/framework/serialization/datetimeserialization-element.md)   
+ [\<xmlSchemaImporterExtensions\> の \<add\> 要素](../../../docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md)   
+ [\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/selective-serialization.md b/docs/framework/serialization/selective-serialization.md
new file mode 100644
index 00000000000..c65191faf71
--- /dev/null
+++ b/docs/framework/serialization/selective-serialization.md
@@ -0,0 +1,44 @@
+---
+title: "選択的シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 選択的シリアル化"
+  - "シリアル化, 選択的シリアル化"
+ms.assetid: 39c56635-95d2-4afd-aff1-b022e7649bb3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 選択的シリアル化
+クラスには、シリアル化できないフィールドが含まれていることがよくあります。たとえば、クラスのメンバー変数の 1 つにスレッド ID が格納されているとします。クラスを逆シリアル化すると、クラスのシリアル化時に格納された ID を持つスレッドが実行されなくなることがあります。この場合、ID 値をシリアル化しても意味はありません。メンバー変数に [NonSerialized](frlrfSystemNonSerializedAttributeClassTopic) 属性を使用してマークすることで、メンバー変数がシリアル化されないようにすることができます。以下に例を示します。  
+  
+```csharp  
+[Serializable]  
+public class MyObject   
+{  
+  public int n1;  
+  [NonSerialized] public int n2;  
+  public String str;  
+}  
+```  
+  
+ 機密データを含むオブジェクトは、可能であれば、シリアル化できないようにしてください。オブジェクトをシリアル化する必要がある場合は、機密データを格納する特定のフィールドに **NonSerialized** 属性を適用します。これらのフィールドをシリアル化の対象から除外しない場合は、フィールドに格納されているデータがシリアル化の許可を持つ任意のコードに公開されることに注意する必要があります。安全なシリアル化コードの記述方法の詳細については、「[セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)」を参照してください。  
+  
+## 参照  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/serialization-concepts.md b/docs/framework/serialization/serialization-concepts.md
new file mode 100644
index 00000000000..4118571b249
--- /dev/null
+++ b/docs/framework/serialization/serialization-concepts.md
@@ -0,0 +1,40 @@
+---
+title: "シリアル化の概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: e1ff4740-20a1-4c76-a8ad-d857db307054
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# シリアル化の概念
+シリアル化が必要となる理由について考えてみます。最も重要な理由として、オブジェクトの状態をストレージ メディアに保持し、後の段階で同一コピーを再作成できるようにすることと、アプリケーション ドメイン間でオブジェクトを値渡しで送信することの 2 つが挙げられます。たとえば、シリアル化は ASP.NET でのセッション状態を保存したり、オブジェクトを Windows フォームのクリップボードにコピーしたりするために使用されます。また、リモート処理でオブジェクトを 1 つのアプリケーション ドメインから別のアプリケーション ドメインに値渡しするためにも使用されます。  
+  
+## このセクションの内容  
+ [永続ストレージ](../../../docs/framework/serialization/persistent-storage.md)  
+ オブジェクトをシリアル化する必要性について説明します。  
+  
+ [値渡しによるマーシャリング](../../../docs/framework/serialization/marshal-by-value.md)  
+ 値渡しによるマーシャリングの処理について説明します。  
+  
+## 関連項目  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)  
+ 共通言語ランタイムに付属しているバイナリ シリアル化機構について説明します。  
+  
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)  
+ .NET Framework でリモート通信に利用できるさまざまな通信方法について説明します。  
+  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)  
+ 共通言語ランタイムに付属している XML シリアル化および SOAP シリアル化機構について説明します。
\ No newline at end of file
diff --git a/docs/framework/serialization/serialization-guidelines.md b/docs/framework/serialization/serialization-guidelines.md
new file mode 100644
index 00000000000..9e9003ecb75
--- /dev/null
+++ b/docs/framework/serialization/serialization-guidelines.md
@@ -0,0 +1,152 @@
+---
+title: "シリアル化のガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, ガイドライン"
+  - "シリアル化, ガイドライン"
+ms.assetid: ebbeddff-179d-443f-bf08-9c373199a73a
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# シリアル化のガイドライン
+このドキュメントには、シリアル化できるように API をデザインする際に考慮すべきガイドラインを示します。  
+  
+ .NET Framework には、さまざまなシリアル化シナリオに合わせて最適化できる 3 つの主なシリアル化テクノロジがあります。これらのテクノロジ、およびテクノロジに関連した主な Framework 型を次の表に示します。  
+  
+|テクノロジ|関連するクラス|メモ|  
+|-----------|-------------|--------|  
+|データ コントラクトのシリアル化|<xref:System.Runtime.Serialization.DataContractAttribute><br /><br /> <xref:System.Runtime.Serialization.DataMemberAttribute><br /><br /> <xref:System.Runtime.Serialization.DataContractSerializer><br /><br /> <xref:System.Runtime.Serialization.NetDataContractSerializer><br /><br /> <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer><br /><br /> <xref:System.Runtime.Serialization.ISerializable>|永続化全般<br /><br /> Web サービス<br /><br /> JSON|  
+|XML シリアル化|<xref:System.Xml.Serialization.XmlSerializer>|XML 形式<br />フル コントロール|  
+|ランタイム シリアル化 \(バイナリおよび SOAP\)|<xref:System.SerializableAttribute><br /><br /> <xref:System.Runtime.Serialization.ISerializable><br /><br /> <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter><br /><br /> <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>|.NET リモート処理|  
+  
+ 新しい型をデザインする際は、新しい型でどのテクノロジをサポートするかを決める必要があります。次のガイドラインでその選択方法とサポートの提供方法について説明します。このガイドラインは、アプリケーションまたはライブラリの実装時に使用するシリアル化テクノロジを決定するためのものではありません。そのようなガイドラインは API のデザインには直接関係ないため、このトピックのスコープの範囲外となります。  
+  
+## ガイドライン  
+  
+-   新しい型をデザインする際にはシリアル化について考えてください。  
+  
+     シリアル化は、プログラムで型のインスタンスを永続化または変換しなければならないことがあるため、どのような型においてもデザイン上の重要な考慮事項です。  
+  
+### サポートする適切なシリアル化テクノロジの選択  
+ 任意の型で 0、または 1 つ以上のシリアル化テクノロジをサポートできます。  
+  
+-   使用する型のインスタンスを Web サービスで永続化させる、または使用する必要がある場合は、*データ コントラクトのシリアル化*をサポートすることを検討してください。  
+  
+-   型をシリアル化したときに作成される XML 形式の制御を強化する必要がある場合は、データ コントラクトのシリアル化の代わり、またはこれに加えて *XML シリアル化*をサポートすることを検討してください。  
+  
+     これは、データ コントラクトのシリアル化でサポートされていない XML 構築を使用して XML 属性を作成するような一部の相互運用シナリオで必要になることがあります。  
+  
+-   使用する型のインスタンスが .NET リモート処理境界を超えて移動する必要がある場合は、*ランタイムのシリアル化*をサポートすることを検討してください。  
+  
+-   一般的な永続化のためにランタイムのシリアル化や XML のシリアル化をサポートしないでください。データ コントラクトのシリアル化を優先的に使用してください。  
+  
+#### データ コントラクトのシリアル化のサポート  
+ **DataContractAttribute** を型に適用し、**DataMemberAttribute** をその型のメンバー \(フィールドおよびプロパティ\) に適用することによって、型でデータ コントラクトのシリアル化をサポートすることができます。  
+  
+ [!code-csharp[SerializationGuidelines#1](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#1)]
+ [!code-vb[SerializationGuidelines#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#1)]  
+  
+1.  型を部分信頼で使用する場合は、型のデータ メンバーをパブリックにすることを検討してください。完全な信頼では、データ コントラクト シリアライザーでパブリックではない型とメンバーのシリアル化と逆シリアル化を行うことが可能ですが、部分信頼の場合、パブリック メンバーのみをシリアル化および逆シリアル化できます。  
+  
+2.  Data\-MemberAttribute を持つすべてのプロパティに getter と setter を実装してください。データ コントラクト シリアライザーでは、この型の getter と setter の両方がシリアル化可能と見なされる必要があります。型を部分信頼で使用しない場合は、1 つまたは両方のプロパティ アクセサーを非パブリックにできます。  
+  
+     [!code-csharp[SerializationGuidelines#2](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#2)]
+     [!code-vb[SerializationGuidelines#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#2)]  
+  
+3.  逆シリアル化されたインスタンスの初期化には、シリアル化コールバックを使用することを検討してください。  
+  
+     オブジェクトの逆シリアル化時にはコンストラクターは呼び出されません。このため、通常の構築時に実行されるすべてのロジックは、*シリアル化のコールバック*の 1 つとして実装する必要があります。  
+  
+     [!code-csharp[SerializationGuidelines#3](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#3)]
+     [!code-vb[SerializationGuidelines#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#3)]  
+  
+     <xref:System.Runtime.Serialization.OnDeserializedAttribute> 属性は最もよく使用されるコールバック属性です。その他の属性には、<xref:System.Runtime.Serialization.OnDeserializingAttribute>、<xref:System.Runtime.Serialization.OnSeralizingAttribute>、および <xref:System.Runtime.Serialization.OnSerializedAttribute> があります。これらを使用して、逆シリアル化前、シリアル化前、およびシリアル化後に実行されるコールバックをマークすることができます。  
+  
+4.  複雑なオブジェクト グラフを逆シリアル化する場合は、使用する具象型を示す <xref:System.Runtime.Serialization.KnownTypeAttribute> を使用することを検討してください。  
+  
+     たとえば、逆シリアル化されたデータ メンバーの型を抽象クラスで表す場合、シリアライザーはインスタンス化してメンバーに割り当てる具象型を判断するために、*既知の型*の情報が必要になります。属性を使用して既知の型を指定しない場合、明示的にシリアライザーに渡す \(既知の型をシリアライザーのコンストラクターに渡します\) か、構成ファイルで指定する必要があります。  
+  
+     [!code-csharp[SerializationGuidelines#4](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#4)]
+     [!code-vb[SerializationGuidelines#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#4)]  
+  
+     既知の型のリストが静的にわからない場合 \(**Person** クラスをコンパイルした場合\)、**KnownTypeAttribute** で実行時に既知の型の一覧を返すメソッドを指すこともできます。  
+  
+5.  シリアル化可能な型を作成または変更する場合は、上位互換性と下位互換性を考慮してください。  
+  
+     シリアル化した型の将来のバージョンは、現在のバージョンの型に逆シリアル化でき、その逆も可能であることを念頭に置いてください。明示的なパラメーターを使用してデータ コントラクト属性にコントラクトを保存する特別な措置を取らない限り、データ メンバーはプライベートで内部データであっても、型の将来のバージョンで名前、型、順序を変更することはできないことを理解しておいてください。シリアル化可能な型に変更を加えるときは、シリアル化の互換性をテストしてください。新しいバージョンを古いバージョンに逆シリアル化したり、その逆も試してみてください。  
+  
+6.  異なるバージョンの型の間でラウンドトリッピングができるように、<xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装することを検討してください。  
+  
+     インターフェイスを使用すると、ラウンドトリッピングの間にデータが失われないようにシリアライザーで確認することができます。<xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティにより、現在のバージョンでは未知の、将来使用される型の任意のデータが格納されます。現在のバージョンを将来のバージョンにシリアル化または逆シリアル化するときに、**ExtensionData** プロパティ値を通じて、シリアル化されたストリーム内で追加データを使用できます。  
+  
+     [!code-csharp[SerializationGuidelines#5](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#5)]
+     [!code-vb[SerializationGuidelines#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#5)]  
+  
+     詳細については、「[上位互換性のあるデータ コントラクト](../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」を参照してください。  
+  
+#### XML シリアル化のサポート  
+ データ コントラクトのシリアル化は .NET Framework の主な \(既定の\) シリアル化テクノロジですが、データ コントラクトのシリアル化ではサポートされないシリアル化シナリオがあります。たとえば、シリアライザーによって作成または使用された XML の形状は完全に制御できません。そのような微調整が必要な場合は、*XML シリアル化*を使用する必要があり、このシリアル化テクノロジをサポートする型を自分でデザインする必要があります。  
+  
+1.  作成された XML の形状を制御しなければならない強力な理由がない限り、XML シリアル化のために特別に型をデザインすることは避けてください。このシリアル化テクノロジは、前のセクションで説明したデータ コントラクトのシリアル化よりも優先されます。  
+  
+     言い換えれば、XML シリアル化で使用する型であることがわかっている場合を除き、<xref:System.Runtime.Serialization> 名前空間の属性を新しい型に適用しないでください。**System.Xml.Serialization** を使用して、作成された XML の形状を制御する方法を次の例に示します。  
+  
+     [!code-csharp[SerializationGuidelines#6](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#6)]
+     [!code-vb[SerializationGuidelines#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#6)]  
+  
+2.  XML シリアル化属性を適用することで提供される、シリアル化された XML の形状をより細かく制御する場合は、<xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装することを検討してください。2 つのインターフェイスのメソッド、<xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> と <xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> を使用することで、シリアル化された XML ストリームを完全制御できます。また、<xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性を適用することで、その型用に生成される XML スキーマを制御することもできます。  
+  
+#### ランタイム シリアル化のサポート  
+ *ランタイム シリアル化*は .NET リモート処理で使用されるテクノロジです。.NET リモート処理を使用して型を変換する場合、ランタイム シリアル化がサポートされていることを確認する必要があります。  
+  
+ *ランタイム シリアル化*の基本的なサポートは <xref:System.SerializableAttribute> 属性を適用して提供できますが、より高度なシナリオでは単純な*ランタイム シリアル化可能パターン* \(\-<xref:System.Runtime.Serialization.ISerializable> を実装してシリアル化コンストラクターを指定\) を実装することが必要になります。  
+  
+1.  使用する型で .NET リモート処理を使用する場合は、ランタイムのシリアル化をサポートすることを検討してください。たとえば、<xref:System.AddIn> 名前空間は .NET リモート処理を使用するため、**System.AddIn** アドイン間で交換されるすべての型でランタイム シリアル化をサポートする必要があります。  
+  
+     [!code-csharp[SerializationGuidelines#7](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#7)]
+     [!code-vb[SerializationGuidelines#7](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#7)]  
+  
+2.  シリアル化プロセスを完全制御する場合は、*ランタイム シリアル化可能パターン*を実装することを検討してください。たとえば、シリアル化または逆シリアル化されたデータを変換したいとします。  
+  
+     パターンは単純です。必要な作業は、**ISerializable** インターフェイスを実装し、オブジェクトを逆シリアル化するときに使用する特別なコンストラクターを指定するだけです。  
+  
+     [!code-csharp[SerializationGuidelines#8](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#8)]
+     [!code-vb[SerializationGuidelines#8](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#8)]  
+  
+3.  このサンプルに示すように、シリアル化コンストラクターを保護し、型と名前を指定した 2 つのパラメーターを用意してください。  
+  
+     [!code-csharp[SerializationGuidelines#9](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#9)]
+     [!code-vb[SerializationGuidelines#9](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#9)]  
+  
+4.  ISerializable メンバーを明示的に実装してください。  
+  
+     [!code-csharp[SerializationGuidelines#10](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#10)]
+     [!code-vb[SerializationGuidelines#10](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#10)]  
+  
+5.  **ISerializable.GetObjectData** の実装にはリンク確認要求を適用してください。こうすることで、完全に信頼できるコア、およびランタイムのシリアライザーだけがメンバーにアクセスできるようになります。  
+  
+     [!code-csharp[SerializationGuidelines#11](../../../samples/snippets/csharp/VS_Snippets_CFX/serializationguidelines/cs/source.cs#11)]
+     [!code-vb[SerializationGuidelines#11](../../../samples/snippets/visualbasic/VS_Snippets_CFX/serializationguidelines/vb/source.vb#11)]  
+  
+## 参照  
+ [データ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [データ コントラクト シリアライザー](../../../docs/framework/wcf/feature-details/data-contract-serializer.md)   
+ [データ コントラクト シリアライザーでサポートされる型](../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)   
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/serialization-how-to-topics.md b/docs/framework/serialization/serialization-how-to-topics.md
new file mode 100644
index 00000000000..3558ef6a052
--- /dev/null
+++ b/docs/framework/serialization/serialization-how-to-topics.md
@@ -0,0 +1,46 @@
+---
+title: "シリアル化に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "シリアル化, 方法"
+ms.assetid: 46c972ab-2193-4f72-9413-eca4521ed4b0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# シリアル化に関する「方法」トピック
+概念を説明したドキュメントに用意されている、シリアル化に関する方法を説明したトピックへのリンクの一覧を次に示します。  
+  
+-   [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)  
+  
+-   [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)  
+  
+-   [方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する](../../../docs/framework/serialization/xml-schema-def-tool-gen.md)  
+  
+-   [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)  
+  
+-   [方法 : 派生クラスのシリアル化を制御する](../../../docs/framework/serialization/how-to-control-serialization-of-derived-classes.md)  
+  
+-   [方法 : XML 要素および XML 属性名を修飾する](../../../docs/framework/serialization/how-to-qualify-xml-element-and-xml-attribute-names.md)  
+  
+-   [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)  
+  
+-   [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)  
+  
+-   [方法 : シリアル化されたデータをチャンクする](../../../docs/framework/serialization/how-to-chunk-serialized-data.md)  
+  
+## 参照  
+ [シリアル化](../../../docs/framework/serialization/index.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/serialization-samples.md b/docs/framework/serialization/serialization-samples.md
new file mode 100644
index 00000000000..cc5ea419b31
--- /dev/null
+++ b/docs/framework/serialization/serialization-samples.md
@@ -0,0 +1,40 @@
+---
+title: "シリアル化のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a56f66d-c80a-43e9-8e50-fb9b61120222
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# シリアル化のサンプル
+ここでは、.NET Framework でのオブジェクトのシリアル化について説明します。  
+  
+## このセクションの内容  
+ [基本的なシリアル化の技術サンプル](../../../docs/framework/serialization/basic-serialization-technology-sample.md)  
+ メモリ内のオブジェクト グラフをストリームにシリアル化する方法について説明します。  
+  
+ [バージョン間の耐性があるシリアル化に対応する技術サンプル](../../../docs/framework/serialization/version-tolerant-serialization-technology-sample.md)  
+ .NET シリアル化の複数バージョンに対応する機能について説明します。  
+  
+ [Web サービス ジェネリック シリアル化の技術サンプル](../../../docs/framework/serialization/web-services-generics-serialization-technology-sample.md)  
+ ASP.NET Web サービスで、ジェネリックのシリアル化を使用および制御する方法について説明します。  
+  
+ [Web サービス IXmlSerializable の技術サンプル](../../../docs/framework/serialization/web-services-ixmlserializable-technology-sample.md)  
+ ASP.NET Web サービスで、<xref:System.Xml.Serialization.IXmlSerializable> を使用してカスタム型のシリアル化を制御する方法について説明します。  
+  
+ [SchemaImporterExtension の技術サンプル](../../../docs/framework/serialization/schemaimporterextension-technology-sample.md)  
+ カスタムの <xref:System.Xml.Serialization.Advanced.SchemaImporterExtension> について説明します。  
+  
+ [XmlSerializer によるカスタム シリアル化順序](../../../docs/framework/serialization/custom-serialization-order-with-xmlserializer.md)  
+ XML シリアル化で、シリアル化および逆シリアル化された要素の順序を制御する方法について説明します。  
+  
+## 関連項目  
+ [シリアル化](../../../docs/framework/serialization/index.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/serialization-tools.md b/docs/framework/serialization/serialization-tools.md
new file mode 100644
index 00000000000..c16684cd67d
--- /dev/null
+++ b/docs/framework/serialization/serialization-tools.md
@@ -0,0 +1,31 @@
+---
+title: "シリアル化ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 593b675f-938c-44ff-807b-0ca9fea30103
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# シリアル化ツール
+ここでは、シリアル化ツールについて詳しく説明します。すべてのツールは、コマンド ラインから実行できます。  
+  
+> [!IMPORTANT]
+>  .NET Framework ツールが適切に機能するには、Path、Include、および Lib の各環境変数を正しく設定する必要があります。これらの環境変数を設定するには、\<SDK\>\\v2.0\\Bin ディレクトリにある SDKVars.bat を実行します。SDKVars.bat は、コマンド シェルごとに実行する必要があります。  
+  
+## このセクションの内容  
+  
+|ツール|説明|  
+|---------|--------|  
+|[XML シリアライザー ジェネレーター ツール \(Sgen.exe\)](../../../docs/framework/serialization/xml-serializer-generator-tool-sgen-exe.md)|指定されたアセンブリの種類に対応する XML シリアル化アセンブリを作成して、<xref:System.Xml.Serialization.XmlSerializer> のランタイム パフォーマンスを向上させます。|  
+|[XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)|W3C \(World Wide Web Consortium\) により提案された XSD 言語に準拠する XML スキーマを生成します。このツールは、XSD スキーマ ファイルから共通言語ランタイム クラスと <xref:System.Data.DataSet> クラスを生成します。|  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/steps-in-the-serialization-process.md b/docs/framework/serialization/steps-in-the-serialization-process.md
new file mode 100644
index 00000000000..51c4c50a508
--- /dev/null
+++ b/docs/framework/serialization/steps-in-the-serialization-process.md
@@ -0,0 +1,39 @@
+---
+title: "シリアル化プロセスの手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "バイナリ シリアル化, 手順"
+  - "シリアル化, 手順"
+ms.assetid: 4bcbc883-2a91-418f-b968-6c86a25e9737
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# シリアル化プロセスの手順
+[フォーマッタ](frlrfSystemRuntimeSerializationFormatterClassTopic)で [Serialize](frlrfSystemRuntimeSerializationFormatterClassSerializeTopic) メソッドが呼び出されると、次の一連の規則に従って、オブジェクトのシリアル化プロセスが実行されます。  
+  
+-   フォーマッタにサロゲート セレクターが存在するかどうかをチェックします。サロゲート セレクターが存在する場合は、そのサロゲート セレクターが指定された型のオブジェクトを処理できるかどうかをチェックします。そのオブジェクトの型を処理できる場合は、サロゲート セレクターで **ISerializable.GetObjectData** を呼び出します。  
+  
+-   サロゲート セレクターが存在しないか、またはサロゲート セレクターがそのオブジェクトの型を処理しない場合は、オブジェクトが [Serializable](frlrfSystemSerializableAttributeClassTopic) 属性でマークされているかどうかをチェックします。マークされていない場合は、[SerializationException](frlrfSystemRuntimeSerializationSerializationExceptionClassTopic) をスローします。  
+  
+-   オブジェクトが適切にマークされている場合は、オブジェクトが [ISerializable](frlrfSystemRuntimeSerializationISerializableClassTopic) インターフェイスを実装しているかどうかをチェックします。実装している場合は、そのオブジェクトで [GetObjectData](frlrfSystemRuntimeSerializationISerializableClassGetObjectDataTopic) を呼び出します。  
+  
+-   オブジェクトが **ISerializable** を実装していない場合は、既定のシリアル化ポリシーを適用して、[NonSerialized](frlrfSystemNonSerializedAttributeClassTopic) としてマークされていないすべてのフィールドをシリアル化します。  
+  
+## 参照  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)   
+ [Remote Objects](http://msdn.microsoft.com/ja-jp/515686e6-0a8d-42f7-8188-73abede57c58)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/system-xml-serialization-element.md b/docs/framework/serialization/system-xml-serialization-element.md
new file mode 100644
index 00000000000..e4dec814c24
--- /dev/null
+++ b/docs/framework/serialization/system-xml-serialization-element.md
@@ -0,0 +1,79 @@
+---
+title: "&lt;system.xml.serialization&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<system.xml.serialization> 要素"
+  - "system.xml.serialization 要素"
+  - "XML シリアル化, 構成"
+ms.assetid: 3ce45919-388a-418c-8968-6df0372c73ec
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# &lt;system.xml.serialization&gt; 要素
+XML シリアル化を制御する最上位の要素です。  構成ファイルの詳細については、「[構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)」を参照してください。  
+  
+## 構文  
+  
+```  
+  
+<system.xml.serialization>  
+</system.xml.serialization>  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+ なし。  
+  
+### 子要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<dateTimeSerialization\> 要素](../../../docs/framework/serialization/datetimeserialization-element.md)|<xref:System.DateTime> オブジェクトのシリアル化モードを決定します。|  
+|[\<schemaImporterExtensions\> 要素](../../../docs/framework/serialization/schemaimporterextensions-element.md)|XSD の型を .NET Framework の型にマッピングするために <xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を含みます。|  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<configuration\> 要素](../../../docs/framework/configure-apps/file-schema/configuration-element.md)|共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。|  
+  
+## 使用例  
+ 次のコード例は、<xref:System.DateTime> オブジェクトのシリアル化モードを指定し、XSD の型を .NET Framework の型にマッピングするために <xref:System.Xml.Serialization.XmlSchemaImporter> によって使用される型を追加する方法を示します。  
+  
+```  
+<system.xml.serialization>  
+    <xmlSerializer checkDeserializeAdvances="false" />  
+    <dateTimeSerialization mode = "Local" />  
+    <schemaImporterExtensions>  
+        <add   
+        name = "MobileCapabilities"   
+        type = "System.Web.Mobile.MobileCapabilities,   
+        System.Web.Mobile, Version - 2.0.0.0, Culture = neuutral,   
+        PublicKeyToken = b03f5f6f11d40a3a" />  
+    </schemaImporterExtensions>  
+</system.sxml.serialization>  
+```  
+  
+## 参照  
+ <xref:System.Xml.Serialization.XmlSchemaImporter>   
+ <xref:System.Xml.Serialization.Configuration.DateTimeSerializationSection.DateTimeSerializationMode>   
+ [構成ファイル スキーマ](../../../docs/framework/configure-apps/file-schema/index.md)   
+ [\<dateTimeSerialization\> 要素](../../../docs/framework/serialization/datetimeserialization-element.md)   
+ [\<schemaImporterExtensions\> 要素](../../../docs/framework/serialization/schemaimporterextensions-element.md)   
+ [\<xmlSchemaImporterExtensions\> の \<add\> 要素](../../../docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md b/docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md
new file mode 100644
index 00000000000..6aa0699c310
--- /dev/null
+++ b/docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md
@@ -0,0 +1,44 @@
+---
+title: "XML スキーマ定義ツールと XML シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Xsd.exe"
+  - "XML シリアル化、XML スキーマ定義ツール"
+  - "XML スキーマ定義ツール"
+  - "シリアル化、XML スキーマ定義ツール"
+ms.assetid: 3c03f855-f931-47ff-bbc6-50c0367a16e4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# XML スキーマ定義ツールと XML シリアル化
+XML スキーマ定義ツール \([XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)\) は、Windows® Software Development Kit \(SDK\) の一部として、.NET Framework ツールと共にインストールされます。 このツールは、主に次の 2 つの目的を実現するためにデザインされています。  
+  
+-   特定の XML スキーマ定義言語 \(XSD\) スキーマに準拠する C\# クラス ファイルまたは Visual Basic クラス ファイルの生成。 このツールは、XML スキーマを引数として受け取り、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) を使用してシリアル化された場合にそのスキーマに準拠した多数のクラスを含むファイルを出力します。 このツールを使用して、特定のスキーマに準拠するクラスを生成する方法については、「[方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する](../../../docs/framework/serialization/xml-schema-def-tool-gen.md)」を参照してください。  
+  
+-   .dll ファイルまたは .exe ファイルからの XML スキーマ ドキュメントの生成。 作成済み、または属性を使用して変更済みの一連のファイルのスキーマを確認するには、このツールに DLL または EXE を引数として渡し、その XML スキーマを生成します。 このツールを使用して、一連のクラスから XML スキーマ ドキュメントを生成する方法については、「[方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する](../../../docs/framework/serialization/xml-schema-def-tool-gen.md)」を参照してください。  
+  
+ このツールおよびその他のツールの詳細については、「[ツール](../../../docs/framework/tools/index.md)」を参照してください。 ツールのオプションの詳細については、「[XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)」を参照してください。  
+  
+## 参照  
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [DataSet](frlrfSystemDataDataSetClassTopic)   
+ [XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)   
+ [方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する](../../../docs/framework/serialization/xml-schema-def-tool-gen.md)   
+ [.NET Framework での XML スキーマのバインディング サポート](http://msdn.microsoft.com/ja-jp/8f0619dd-f1fc-4895-ae21-6d45d0382cc1)
\ No newline at end of file
diff --git a/docs/framework/serialization/version-tolerant-serialization-technology-sample.md b/docs/framework/serialization/version-tolerant-serialization-technology-sample.md
new file mode 100644
index 00000000000..f529d826895
--- /dev/null
+++ b/docs/framework/serialization/version-tolerant-serialization-technology-sample.md
@@ -0,0 +1,55 @@
+---
+title: "バージョン間の耐性があるシリアル化に対応する技術サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2a183664-bfbf-4ff0-96f6-c836284ea916
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# バージョン間の耐性があるシリアル化に対応する技術サンプル
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Runtime%20Serialization/VTS.zip.exe)  
+  
+ このサンプルでは、.NET でのバージョン間の耐性があるシリアル化に対応する機能を示します。このサンプルでは、バージョンの異なる複数の <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> を使用するアプリケーションをビルドし、データをシリアル化および逆シリアル化します。さまざまなバージョンがありますが、このアプリケーションではシームレスに処理できます。詳細については、「[バージョン トレラントなシリアル化](../../../docs/framework/serialization/version-tolerant-serialization.md)」を参照してください。  
+  
+### コマンド プロンプトを使用してサンプルをビルドするには  
+  
+1.  コマンド プロンプト ウィンドウを表示し、サンプルの使用言語に対応するサブディレクトリ \(V1 Application または V2 Application の下\) に移動します。  
+  
+2.  コマンド ラインで「**msbuild.exe \<ver\> application.sln**」と入力します \(ここで、\<ver\> は v1 または v2\)。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、サンプルが格納されている、言語固有のサブディレクトリのいずれかに移動します。  
+  
+2.  前の手順で選択したディレクトリの V1 Application サブディレクトリに移動します。  
+  
+3.  V1 Application.sln ファイルのアイコンをダブルクリックして、このファイルを Visual Studio で開きます。  
+  
+4.  \[ビルド\] メニューの \[ソリューションのビルド\] をクリックします。  
+  
+5.  V2 Application サブディレクトリに移動し、前の 2 つの手順を実行して、V2 Application をビルドします。  
+  
+ 各アプリケーションは、既定で、それぞれのプロジェクト ディレクトリの \\bin または \\bin\\Debug サブディレクトリにビルドされます。  
+  
+### サンプルを実行するには  
+  
+1.  コマンド プロンプト ウィンドウで、サンプル アプリケーションをビルドしたときに選択した言語に対応する、言語固有のサブディレクトリに移動します。  
+  
+2.  コマンド ラインで「**runme.cmd**」と入力し、両方のアプリケーションを一度に実行します。  
+  
+ または、新しい実行可能ファイルが格納されているディレクトリに移動し、これらを順に実行します。  
+  
+> [!NOTE]
+>  このサンプルでは、コンソール アプリケーションをビルドします。出力を表示するには、コマンド プロンプト ウィンドウでこれらを起動し、実行する必要があります。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>   
+ <xref:System.IO.FileStream>
\ No newline at end of file
diff --git a/docs/framework/serialization/version-tolerant-serialization.md b/docs/framework/serialization/version-tolerant-serialization.md
new file mode 100644
index 00000000000..ad411db35ad
--- /dev/null
+++ b/docs/framework/serialization/version-tolerant-serialization.md
@@ -0,0 +1,302 @@
+---
+title: "バージョン トレラントなシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "BinaryFormatter クラス, サンプル"
+  - "シリアル化, 属性"
+  - "シリアル化, 制御"
+  - "シリアル化, カスタムのシリアル化"
+  - "シリアル化, バージョン トレラント"
+  - "バージョン トレラントなシリアル化"
+  - "バージョンとシリアル化"
+ms.assetid: bea0ffe3-2708-4a16-ac7d-e586ed6b8e8d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# バージョン トレラントなシリアル化
+.NET Framework のバージョン 1.0 および 1.1 では、アプリケーションのあるバージョンから次のバージョンに移行しても再利用できる、シリアル化可能な型の作成に問題がありました。フィールドを追加して型を変更すると、次のような問題が発生していました。  
+  
+-   以前のバージョンのアプリケーションは、古い型の新しいバージョンを逆シリアル化するように要求すると例外をスローする。  
+  
+-   新しいバージョンのアプリケーションは、データが欠落している以前のバージョンの型を逆シリアル化すると例外をスローする。  
+  
+ バージョン トレラントなシリアル化 \(VTS: Version Tolerant Serialization\) は、.NET Framework 2.0 で導入された機能セットで、シリアル化可能な型を、長期にわたって簡単に変更できるようにします。具体的には、VTS 機能が、ジェネリック型を含め、<xref:System.SerializableAttribute> 属性が適用されているクラスに対して有効です。VTS を使用すると、他のバージョンの型との互換性を失うことなく、これらのクラスに新しいフィールドを追加できます。実際に動作するサンプル アプリケーションについては、「[バージョン間の耐性があるシリアル化に対応する技術サンプル](../../../docs/framework/serialization/version-tolerant-serialization-technology-sample.md)」を参照してください。  
+  
+ VTS 機能は、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> を使用する場合に有効になります。また、<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> を使用する場合は、外部データの複数バージョン対応機能を除くすべての機能が有効になります。シリアル化でこれらのクラスを使用する方法の詳細については、「[バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)」を参照してください。  
+  
+## 機能の一覧  
+ この機能セットの内容は次のとおりです。  
+  
+-   外部データまたは予期しないデータの複数バージョン対応。これにより、型の新しいバージョンから以前のバージョンにデータを送信できます。  
+  
+-   欠落しているオプション データの複数バージョン対応。これにより、以前のバージョンから新しいバージョンにデータを送信できます。  
+  
+-   シリアル化のコールバック。これにより、データが欠落している場合に、既定値の高度な設定ができます。  
+  
+ さらに、オプション フィールドが新たに追加されたときに宣言を生成する機能があります。これは、<xref:System.Runtime.Serialization.OptionalFieldAttribute> 属性の <xref:System.Runtime.Serialization.OptionalFieldAttribute.VersionAdded%2A> プロパティです。  
+  
+ これらの機能の詳細については、以下で説明します。  
+  
+## 外部データまたは予期しないデータの複数バージョン対応  
+ これまで、逆シリアル化中に外部データまたは予期しないデータが検出されると、例外がスローされていました。VTS ではこのような場合、例外がスローされるのではなく、外部データまたは予期しないデータがすべて無視されます。これにより、新しいバージョンの型 \(フィールドが追加されたバージョン\) を使用するアプリケーションが、同じ型の以前のバージョンを必要とするアプリケーションに情報を送ることができます。  
+  
+ 次の例では、バージョン 2.0 の `Address` クラスの `CountryField` に含まれる追加データは、以前のアプリケーションで新しいバージョンを逆シリアル化する場合、無視されます。  
+  
+```csharp  
+// Version 1 of the Address class.  
+[Serializable]  
+public class Address  
+{  
+    public string Street;  
+    public string City;  
+}  
+// Version 2.0 of the Address class.  
+[Serializable]  
+public class Address  
+{  
+    public string Street;  
+    public string City;  
+    // The older application ignores this data.  
+    public string CountryField;  
+}  
+```  
+  
+```vb  
+' Version 1 of the Address class.  
+<Serializable> _  
+Public Class Address  
+    Public Street As String  
+    Public City As String  
+End Class  
+  
+' Version 2.0 of the Address class.  
+<Serializable> _  
+Public Class Address  
+    Public Street As String  
+    Public City As String  
+    ' The older application ignores this data.  
+    Public CountryField As String  
+End Class  
+```  
+  
+## 欠落しているデータの複数バージョン対応  
+ <xref:System.Runtime.Serialization.OptionalFieldAttribute> 属性をフィールドに適用すると、そのフィールドをオプションとしてマークできます。逆シリアル化中に、オプション データの欠落が検出されても、シリアル化エンジンはデータが存在しないことを無視し、例外をスローしません。そのため、以前のバージョンの型を必要とするアプリケーションから、同じ型の新しいバージョンを必要とするアプリケーションにデータを送信できます。  
+  
+ バージョン 2.0 の `Address` クラスで、`CountryField` フィールドをオプションとしてマークする方法を次の例に示します。バージョン 2.0 を必要とする新しいアプリケーションに対して、以前のアプリケーションがバージョン 1 を送信した場合、データが存在しないことは無視されます。  
+  
+```csharp  
+[Serializable]  
+public class Address  
+{  
+    public string Street;  
+    public string City;  
+  
+    [OptionalField]  
+    public string CountryField;  
+}  
+```  
+  
+```vb  
+<Serializable> _  
+Public Class Address  
+    Public Street As String  
+    Public City As String  
+  
+    <OptionalField> _  
+    Public CountryField As String  
+End Class  
+```  
+  
+## シリアル化のコールバック  
+ シリアル化のコールバックは、次の 4 つの時点でシリアル化プロセスおよび逆シリアル化プロセスにフックする機構です。  
+  
+|属性|関連するメソッドが呼び出されるタイミング|一般的な用途|  
+|--------|--------------------------|------------|  
+|<xref:System.Runtime.Serialization.OnDeserializingAttribute>|逆シリアル化の前 \*|オプション フィールドの既定値を初期化します。|  
+|<xref:System.Runtime.Serialization.OnDeserializedAttribute>|逆シリアル化の後|他のフィールドの内容に基づいて、オプション フィールドの値を修正します。|  
+|<xref:System.Runtime.Serialization.OnSerializingAttribute>|シリアル化の前|シリアル化の準備をします。たとえば、オプションのデータ構造を作成します。|  
+|<xref:System.Runtime.Serialization.OnSerializedAttribute>|シリアル化の後|シリアル化イベントのログを記録します。|  
+  
+ \* このコールバックは、逆シリアル化コンストラクターの前に呼び出されます \(存在する場合\)。  
+  
+### コールバックの使用  
+ コールバックを使用するには、<xref:System.Runtime.Serialization.StreamingContext> パラメーターを受け取るメソッドに、適切な属性を適用します。各属性でマークできるのは、クラスごとに 1 つのメソッドだけです。次に例を示します。  
+  
+```csharp  
+[OnDeserializing]  
+private void SetCountryRegionDefault(StreamingContext sc)  
+{  
+    CountryField = "Japan";  
+}  
+  
+```  
+  
+```vb  
+<OnDeserializing>  
+Private Sub SetCountryRegionDefault(StreamingContext sc)  
+    CountryField = "Japan";  
+End Sub  
+```  
+  
+ これらのメソッドの使用目的は、バージョン管理です。オプション フィールドにデータがない場合、逆シリアル化の実行中に、このフィールドが正しく初期化されないことがあります。この問題を解決するには、正しい値を割り当てるメソッドを作成してから、このメソッドに **OnDeserializingAttribute** 属性または **OnDeserializedAttribute** 属性のいずれかを適用します。  
+  
+ 型のコンテキストで使用されるメソッドを次に示します。以前のバージョンのアプリケーションが新しいバージョンのアプリケーションに `Address` クラスのインスタンスを送信すると、`CountryField` フィールドのデータが欠落します。しかし、逆シリアル化を行うと、このフィールドは既定値である "Japan" に設定されます。  
+  
+```csharp  
+[Serializable]  
+public class Address  
+{  
+    public string Street;  
+    public string City;  
+    [OptionalField]  
+    public string CountryField;  
+  
+    [OnDeserializing]  
+    private void SetCountryRegionDefault (StreamingContext sc)  
+    {  
+        CountryField = "Japan";  
+    }  
+}  
+  
+```  
+  
+```vb  
+<Serializable> _  
+Public Class Address  
+    Public Street As String  
+    Public City As String  
+    <OptionalField> _  
+    Public CountryField As String  
+  
+    <OnDeserializing> _  
+    Private Sub SetCountryRegionDefault(StreamingContext sc)  
+        CountryField = "Japan";  
+    End Sub  
+End Class  
+```  
+  
+## VersionAdded プロパティ  
+ **OptionalFieldAttribute** には、**VersionAdded** プロパティがあります。.NET Framework バージョン 2.0 では、このプロパティは使用されません。ただし、このプロパティを正しく設定して、型が今後のシリアル化エンジンと互換性を保つようにすることが重要です。  
+  
+ このプロパティは、指定されたフィールドに追加された型のバージョンを示します。次の例に示すように、このプロパティの値は 2 を開始値として、型が変更されるたびに常に 1 ずつインクリメントする必要があります。  
+  
+```csharp  
+// Version 1.0  
+[Serializable]  
+public class Person  
+{  
+    public string FullName;  
+}  
+  
+// Version 2.0  
+[Serializable]  
+public class Person  
+{  
+    public string FullName;  
+  
+    [OptionalField(VersionAdded = 2)]  
+    public string NickName;  
+    [OptionalField(VersionAdded = 2)]  
+    public DateTime BirthDate;  
+}  
+  
+// Version 3.0  
+[Serializable]  
+public class Person  
+{  
+    public string FullName;  
+  
+    [OptionalField(VersionAdded=2)]  
+    public string NickName;  
+    [OptionalField(VersionAdded=2)]  
+    public DateTime BirthDate;  
+  
+    [OptionalField(VersionAdded=3)]  
+    public int Weight;  
+}  
+```  
+  
+```vb  
+' Version 1.0  
+<Serializable> _  
+Public Class Person  
+    Public FullName  
+End Class  
+  
+' Version 2.0  
+<Serializable> _  
+Public Class Person  
+    Public FullName As String  
+  
+    <OptionalField(VersionAdded := 2)> _  
+    Public NickName As String  
+    <OptionalField(VersionAdded := 2)> _  
+    Public BirthDate As DateTime  
+End Class  
+  
+' Version 3.0  
+<Serializable> _  
+Public Class Person  
+    Public FullName As String  
+  
+    <OptionalField(VersionAdded := 2)> _  
+    Public NickName As String  
+    <OptionalField(VersionAdded := 2)> _  
+    Public BirthDate As DateTime  
+  
+    <OptionalField(VersionAdded := 3)> _  
+    Public Weight As Integer  
+End Class  
+```  
+  
+## SerializationBinder  
+ 異なるバージョンのクラスがサーバー上およびクライアント上で必要であるため、一部のユーザーはどのクラスをシリアル化および非シリアル化するかの制御が必要な場合があります。<xref:System.RuntimeSerialization.SerializationBinder> は、シリアル化中および逆シリアル化中に使用される実際の型を制御するために使用される抽象クラスです。このクラスを使用するには、クラスを <xref:System.RuntimeSerialization.SerializationBinder> から派生させ、<xref:System.Runtime.Serialization.SerializationBinder.BindToName%2A> System.String, System.String)?qualifyHint=False&autoUpgrade=True メソッドと <xref:System.Runtime.Serialization.SerializationBinder.BindToType%2A> System.String)?qualifyHint=False&autoUpgrade=True メソッドをオーバーライドします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][SerializationBinder を使用したシリアル化および逆シリアル化の制御](../../../docs/framework/wcf/feature-details/controlling-serialization-and-deserialization-with-serializationbinder.md).  
+  
+## ベスト プラクティス  
+ バージョン管理が正しく行われるように、バージョン間で型を変更するときは次の規則に従ってください。  
+  
+-   シリアル化したフィールドを削除しない。  
+  
+-   以前のバージョンでフィールドに <xref:System.NonSerializedAttribute> 属性が適用されていない場合、新しいバージョンでもこの属性を適用しない。  
+  
+-   シリアル化したフィールドの名前または型を変更しない。  
+  
+-   新しいシリアル化フィールドを追加する場合は、**OptionalFieldAttribute** 属性を適用する。  
+  
+-   以前のバージョンでシリアル化できなかったフィールドから **NonSerializedAttribute** 属性を削除する場合は、**OptionalFieldAttribute** 属性を適用する。  
+  
+-   すべてのオプション フィールドに対して、既定値として 0 または **null** が許容される場合以外は、シリアル化コールバックを使用して意味のある既定値を設定する。  
+  
+ 型が今後のシリアル化エンジンと互換性を保つようにするには、次のガイドラインに従ってください。  
+  
+-   **OptionalFieldAttribute** 属性の **VersionAdded** プロパティを常に正しく設定する。  
+  
+-   バージョンの分岐は避ける。  
+  
+## 参照  
+ <xref:System.SerializableAttribute>   
+ <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>   
+ <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>   
+ <xref:System.Runtime.Serialization.OptionalFieldAttribute.VersionAdded%2A>   
+ <xref:System.Runtime.Serialization.OptionalFieldAttribute>   
+ <xref:System.Runtime.Serialization.OnDeserializingAttribute>   
+ <xref:System.Runtime.Serialization.OnDeserializedAttribute>   
+ <xref:System.Runtime.Serialization.OnDeserializingAttribute>   
+ <xref:System.Runtime.Serialization.OnSerializedAttribute>   
+ <xref:System.Runtime.Serialization.StreamingContext>   
+ <xref:System.NonSerializedAttribute>   
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/web-services-generics-serialization-technology-sample.md b/docs/framework/serialization/web-services-generics-serialization-technology-sample.md
new file mode 100644
index 00000000000..5569a2e2a29
--- /dev/null
+++ b/docs/framework/serialization/web-services-generics-serialization-technology-sample.md
@@ -0,0 +1,76 @@
+---
+title: "Web サービス ジェネリック シリアル化の技術サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cdc15ea4-f678-4729-8ebe-188ae720bef7
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Web サービス ジェネリック シリアル化の技術サンプル
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Xml%20Serialization/GenericsSerialization.zip.exe)  
+  
+ このサンプルでは、ASP.NET Web サービスで、ジェネリックのシリアル化を使用および制御する方法について説明します。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  Visual Studio を起動し、**\[ファイル\]** メニューの **\[新しい Web サイト\]** をクリックします。  
+  
+2.  **\[新しい Web サイト\]** ダイアログ ボックスの左ペインで、目的のプログラミング言語を選択し、右ペインの **\[ASP.NET Web サービス\]** をクリックします。  
+  
+3.  **\[参照\]** をクリックし、\\CS\\GenericsService サブディレクトリに移動します。  
+  
+4.  Service.asmx を選択して、このファイルを Visual Studio で開きます。  
+  
+5.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+> [!NOTE]
+>  この一覧の最初の 5 つの手順は省略可能です。サービスが最初に要求されたときに、.NET Framework ランタイムによって Web サービスが自動的に生成されます。  
+  
+> [!NOTE]
+>  サンプルをビルドするには、次の手順が必要です。  
+  
+1.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、\\CS サブディレクトリに移動します。  
+  
+2.  GenericsService サブディレクトリのアイコンを右クリックし、**\[共有とセキュリティ\]** をクリックします。  
+  
+3.  **\[共有\]** タブの **\[このフォルダーを共有する\]** をオンにします。  
+  
+> [!IMPORTANT]
+>  **\[別名\]** ペインに表示される仮想ディレクトリ名をメモします。このディレクトリ名は、サンプルを実行するために必要になります。  
+  
+### インターネット インフォメーション サービス \(IIS: Internet Information Services\) を使用してサンプルをビルドするには  
+  
+1.  **\[インターネット インフォメーション サービス\]** 管理スナップインを開き、**\[Web サイト\]** を展開します。  
+  
+2.  **\[既定の Web サイト\]** を左クリックして **\[新規作成\]**、**\[仮想ディレクトリ\]** の順にクリックし、**仮想ディレクトリの作成ウィザード**を作成します。  
+  
+3.  **\[次へ\]** をクリックし、仮想ディレクトリのパブリック別名を入力し、**\[次へ\]** をクリックします。  
+  
+4.  サンプルを保存したディレクトリへのパス \(通常は \\CS\\GenericsService サブディレクトリ\) を入力し、**\[次へ\]** をクリックします。**\[次へ\]** をクリックして、ウィザードを終了します。  
+  
+> [!IMPORTANT]
+>  **\[別名\]** ペインに表示される仮想ディレクトリ名をメモします。このディレクトリ名は、サンプルを実行するために必要になります。  
+  
+### サンプルを実行するには  
+  
+1.  Web ブラウザー ウィンドウを開き、アドレス バーをクリックします。  
+  
+2.  **http:\/\/localhost\/**\[virtual directory\]**\/Service.asmx** と入力します。\[virtual directory\] は、サンプルのビルド時に作成した仮想ディレクトリを表します。  
+  
+## 解説  
+ サンプルでは、Web サービスの定義へのリンクを含む既定の ASP.NET ページが表示されます。Web サービスのソース コードの変更に加えて、表示のカスタマイズも可能です。詳細については、「[Building XML Web Service Clients](http://msdn.microsoft.com/ja-jp/c606f3cb-4111-45b4-ae42-9300420fa16c)」を参照してください。  
+  
+## 参照  
+ <xref:System.Collections.Generic>   
+ <xref:System.Web.Services>   
+ <xref:System.Xml.Serialization>   
+ [シリアル化](../../../docs/framework/serialization/index.md)   
+ [XML Web Services Created Using ASP.NET and XML Web Service Clients](http://msdn.microsoft.com/ja-jp/1e64af78-d705-4384-b08d-591a45f4379c)
\ No newline at end of file
diff --git a/docs/framework/serialization/web-services-ixmlserializable-technology-sample.md b/docs/framework/serialization/web-services-ixmlserializable-technology-sample.md
new file mode 100644
index 00000000000..a47952602d6
--- /dev/null
+++ b/docs/framework/serialization/web-services-ixmlserializable-technology-sample.md
@@ -0,0 +1,59 @@
+---
+title: "Web サービス IXmlSerializable の技術サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0202d3f1-a50b-427d-a5bb-79208b8f1c22
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Web サービス IXmlSerializable の技術サンプル
+[サンプルのダウンロード](http://download.microsoft.com/download/4/7/B/47B2164C-E780-4B10-8DE4-2CB5B886E0A6/Technologies/Serialization/Xml%20Serialization/IXmlSerializable.zip.exe)  
+  
+ このサンプルでは、<xref:System.Xml.Serialization.IXmlSerializable> を使用して、ASP.NET Web サービスでカスタム型のシリアル化を制御する方法を示します。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] を起動し、**\[ファイル\]** メニューの **\[新しい Web サイト\]** をクリックします。  
+  
+2.  **\[新しい Web サイト\]** ダイアログ ボックスの左ペインで、目的のプログラミング言語を選択し、右ペインの **\[ASP.NET Web サービス\]** をクリックします。  
+  
+3.  Web サービスの名前として、「**IXmlSerializable**」と入力します。  
+  
+4.  ソリューション エクスプローラー ウィンドウで、Service.asmx のアイコンを右クリックし、**\[削除\]** をクリックします。この手順を Service.asmx Codebehind ファイルに対して繰り返します。  
+  
+5.  プロジェクト ディレクトリを右クリックし、**\[既存項目の追加\]** をクリックします。ダイアログ ボックスで、言語固有のディレクトリにある Service サブディレクトリに移動します。  
+  
+6.  Service.asmx をクリックします。この手順を Service.asmx Codebehind ファイルに対して繰り返します。  
+  
+7.  [!INCLUDE[fileExplorer](../../../includes/fileexplorer-md.md)] を開き、上記の手順 3 で作成した、IXmlSerializable ディレクトリがあるディレクトリまで移動します。  
+  
+8.  IXmlSerializable ディレクトリを右クリックし、**\[共有とセキュリティ\]** をクリックします。  
+  
+9. \[Web 共有\] タブで、**\[このフォルダーを共有する\]** をクリックし、名前 IXmlSerializable など既定の設定を確認します。  
+  
+10. **\[OK\]** をクリックします。  
+  
+### サンプルを実行するには  
+  
+1.  Web ブラウザー ウィンドウを開き、アドレス バーをクリックします。  
+  
+2.  「**http:\/\/localhost\/IXmlSerializable\/Service.asmx**」と入力します。  
+  
+## 参照  
+ <xref:System.Xml.Serialization.IXmlSerializable>   
+ <xref:System.Xml.Serialization>   
+ <xref:System.Xml.XmlConvert>   
+ <xref:System.Xml.XmlQualifiedName>   
+ <xref:System.Xml.XmlReader>   
+ <xref:System.Xml.Schema.XmlSchema>   
+ <xref:System.Xml.Schema.XmlSchemaSet>   
+ <xref:System.Xml.XmlUrlResolver>   
+ <xref:System.Xml.XmlWriter>
\ No newline at end of file
diff --git a/docs/framework/serialization/xml-and-soap-serialization.md b/docs/framework/serialization/xml-and-soap-serialization.md
new file mode 100644
index 00000000000..64491039ea6
--- /dev/null
+++ b/docs/framework/serialization/xml-and-soap-serialization.md
@@ -0,0 +1,101 @@
+---
+title: "XML シリアル化および SOAP シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "シリアル化"
+  - "シリアル化, シリアル化について"
+  - "シリアル化, SOAP"
+  - "SOAP, XML シリアル化"
+  - "XML シリアル化"
+  - "XML シリアル化, SOAP"
+ms.assetid: 832ac524-21bc-419a-a27b-ca8bfc45840f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# XML シリアル化および SOAP シリアル化
+XML シリアル化とは、オブジェクトのパブリック フィールドやパブリック プロパティ、またはメソッドのパラメーターや戻り値を、特定の XML スキーマ定義言語 \(XSD: XML Schema Definition Language\) ドキュメントに準拠する XML ストリームに変換 \(シリアル化\) する処理です。XML シリアル化によって、パブリック プロパティおよびパブリック フィールドを含むクラスの型が厳密に指定され、それらのパブリック メンバーは格納または転送できるようにシリアル形式 \(この場合は XML\) に変換されます。  
+  
+ XML はオープン標準であるため、XML ストリームは、プラットフォームに関係なく、必要に応じて任意のアプリケーションで処理できます。たとえば、ASP.NET を使用して作成された XML Web サービスは、<xref:System.Xml.Serialization.XmlSerializer> クラスを使用して、インターネット全体またはイントラネット上の XML Web サービス アプリケーション間でデータを受け渡しする XML ストリームを作成します。一方、逆シリアル化は、このような XML ストリームからデータを取得して、元のオブジェクトを再構築します。  
+  
+ XML シリアル化を使用して、SOAP 仕様に準拠する XML ストリームにオブジェクトをシリアル化することもできます。SOAP は、XML を使用してプロシージャ呼び出しを転送するために特別にデザインされた、XML に基づくプロトコルです。  
+  
+ オブジェクトをシリアル化または逆シリアル化するには、<xref:System.Xml.Serialization.XmlSerializer> クラスを使用します。また、シリアル化する対象のクラスを作成するには、XML スキーマ定義ツールを使用します。  
+  
+## このセクションの内容  
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)  
+ シリアル化 \(特に XML シリアル化\) の一般的な定義を示します。  
+  
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)  
+ オブジェクトをシリアル化するための詳細な手順について説明します。  
+  
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)  
+ オブジェクトを逆シリアル化するための詳細な手順について説明します。  
+  
+ [XML シリアル化の例](../../../docs/framework/serialization/examples-of-xml-serialization.md)  
+ XML シリアル化の基本事項を示す例を紹介します。  
+  
+ [XML スキーマ定義ツールと XML シリアル化](../../../docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md)  
+ XML スキーマ定義ツールを使用して、特定の XML スキーマ定義言語 \(XSD\) スキーマに準拠するクラスを作成したり、.dll ファイルから XML スキーマを生成したりする方法について説明します。  
+  
+ [属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)  
+ 属性を使用してシリアル化を制御する方法について説明します。  
+  
+ [XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)  
+ XML シリアル化の制御に使用する属性を示します。  
+  
+ [方法 : XML ストリームの代替要素名を指定する](../../../docs/framework/serialization/how-to-specify-an-alternate-element-name-for-an-xml-stream.md)  
+ シリアル化のオーバーライドにより、複数の XML ストリームを生成する方法を示す高度なシナリオを紹介します。  
+  
+ [方法 : 派生クラスのシリアル化を制御する](../../../docs/framework/serialization/how-to-control-serialization-of-derived-classes.md)  
+ 派生クラスのシリアル化の制御方法を示す例を紹介します。  
+  
+ [方法 : XML 要素および XML 属性名を修飾する](../../../docs/framework/serialization/how-to-qualify-xml-element-and-xml-attribute-names.md)  
+ XML ストリームでの XML 名前空間の使用方法を定義および制御する方法について説明します。  
+  
+ [XML Web サービスを使用した XML シリアル化](../../../docs/framework/serialization/xml-serialization-with-xml-web-services.md)  
+ XML Web サービスでの XML シリアル化の使用方法について説明します。  
+  
+ [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスを使用して、W3C \(World Wide Web Consortium\) \(www.w3.org\) のドキュメント『Simple Object Access Protocol \(SOAP\) 1.1』のセクション 5 に準拠する、エンコード済みの SOAP XML ストリームを作成する方法について説明します。  
+  
+ [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)  
+ SOAP メッセージとしてのオブジェクトの XML シリアル化をオーバーライドするプロセスについて説明します。  
+  
+ [エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)  
+ SOAP エンコード済みのシリアル化の制御に使用する属性を示します。  
+  
+ [\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)  
+ XML シリアル化を制御する最上位の構成要素です。  
+  
+ [\<dateTimeSerialization\> 要素](../../../docs/framework/serialization/datetimeserialization-element.md)  
+ <xref:System.DateTime> オブジェクトのシリアル化モードを制御します。  
+  
+ [\<schemaImporterExtensions\> 要素](../../../docs/framework/serialization/schemaimporterextensions-element.md)  
+ <xref:System.Xml.Serialization.XmlSchemaImporter> クラスによって使用される型を含みます。  
+  
+ [\<xmlSchemaImporterExtensions\> の \<add\> 要素](../../../docs/framework/serialization/add-element-for-xmlschemaimporterextensions.md)  
+ <xref:System.Xml.Serialization.XmlSchemaImporter> クラスによって使用される型を追加します。  
+  
+## 関連項目  
+ [Advanced Development Technologies](http://msdn.microsoft.com/ja-jp/c4a7e341-f0c6-4df4-a74f-223387ac6e4e)  
+ .NET Framework での高度な開発タスクと技法に関する詳細情報へのリンクを示します。  
+  
+ [XML Web Services Created Using ASP.NET and XML Web Service Clients](http://msdn.microsoft.com/ja-jp/1e64af78-d705-4384-b08d-591a45f4379c)  
+ ASP.NET を使用した XML Web サービスのプログラミング方法について説明するトピックを示します。  
+  
+## 参照  
+ [バイナリ シリアル化](../../../docs/framework/serialization/binary-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/xml-schema-def-tool-gen.md b/docs/framework/serialization/xml-schema-def-tool-gen.md
new file mode 100644
index 00000000000..c564a84b26d
--- /dev/null
+++ b/docs/framework/serialization/xml-schema-def-tool-gen.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "XML スキーマ定義ツールを使用した XML クラスの生成"
+  - "XML スキーマ定義ツールを使用した XML スキーマ ドキュメントの生成"
+  - "XML スキーマ定義ツール, 特定のスキーマに準拠するクラスの生成に使用"
+  - "XML スキーマ定義ツール, XML スキーマ ドキュメントの生成に使用"
+ms.assetid: 51f0edc3-993d-4051-b7f2-77753694d3d1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法 : XML スキーマ定義ツールを使用してクラスと XML スキーマ ドキュメントを生成する
+XML スキーマ定義ツール \(Xsd.exe\) を使用して、クラスを説明する XML スキーマを生成したり、XML スキーマで定義されるクラスを生成したりできます。次の手順では、これらの操作の実行方法を示します。  
+  
+### 特定のスキーマに準拠するクラスを生成するには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  XML スキーマ定義ツールに XML スキーマを引数として渡します。XML スキーマ定義ツールは、次のように XML スキーマに正確に一致するクラスのセットを作成します。  
+  
+    ```  
+    xsd mySchema.xsd  
+    ```  
+  
+     ツールは、2001 年 3 月 16 日付けの World Wide Web Consortium XML 仕様を参照するスキーマのみを処理できます。つまり、XML スキーマ名前空間は、次の例に示すように "http:\/\/www.w3.org\/2001\/XMLSchema" になる必要があります。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8"?>  
+    <xs:schema attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+    ```  
+  
+3.  必要に応じて、クラスのメソッド、プロパティ、またはフィールドを変更します。属性によるクラスの変更の詳細については、「[属性を使用した XML シリアル化の制御](../../../docs/framework/serialization/controlling-xml-serialization-using-attributes.md)」および「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」を参照してください。  
+  
+ クラスのインスタンスがシリアル化されるときに生成される XML ストリームのスキーマを調べることは、さまざまな場合に役立ちます。たとえば、他のユーザーが使用できるようにスキーマを公開したり、準拠しようとしているスキーマと自分のスキーマを比較したりできます。  
+  
+#### クラスのセットから XML スキーマ ドキュメントを生成するには  
+  
+1.  クラスを DLL にコンパイルします。  
+  
+2.  コマンド プロンプトを開きます。  
+  
+3.  次の例に示すように、DLL を引数として Xsd.exe に渡します。  
+  
+    ```  
+    xsd MyFile.dll  
+    ```  
+  
+     スキーマが、"schema0.xsd" という名前から順に書き込まれます。  
+  
+## 参照  
+ [XML スキーマ定義ツールと XML シリアル化](../../../docs/framework/serialization/the-xml-schema-definition-tool-and-xml-serialization.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [DataSet](frlrfSystemDataDataSetClassTopic)   
+ [XML スキーマ定義ツール \(Xsd.exe\)](../../../docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md)   
+ [XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md b/docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md
new file mode 100644
index 00000000000..0f3dc760ac0
--- /dev/null
+++ b/docs/framework/serialization/xml-schema-definition-tool-xsd-exe.md
@@ -0,0 +1,242 @@
+---
+title: "XML スキーマ定義ツール (Xsd.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6e6e65c-347f-4494-9457-653bf29baac2
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# XML スキーマ定義ツール (Xsd.exe)
+XML スキーマ定義ツール \(Xsd.exe\) は、XDR、XML、および XSD ファイル、またはランタイム アセンブリ内のクラスから XML スキーマ クラスまたは共通言語ランタイム クラスを生成します。  
+  
+## 構文  
+  
+```  
+  
+xsd file.xdr [/outputdir:directory][/parameters:file.xml]  
+xsd file.xml [/outputdir:directory] [/parameters:file.xml]  
+xsd file.xsd {/classes | /dataset} [/element:element]   
+             [/enableLinqDataSet] [/language:language]   
+                          [/namespace:namespace] [/outputdir:directory] [URI:uri]   
+                          [/parameters:file.xml]  
+xsd {file.dll | file.exe} [/outputdir:directory] [/type:typename [...]][/parameters:file.xml]  
+```  
+  
+## 引数  
+  
+|引数|説明|  
+|--------|--------|  
+|*file.extension*|変換元の入力ファイルを指定します。  拡張子として、.xdr、.xml、.xsd、.dll、または .exe のいずれかを指定する必要があります。<br /><br /> XDR スキーマ ファイル \(拡張子 .xdr\) を指定すると、Xsd.exe は XDR スキーマを XSD スキーマに変換します。  出力ファイルの名前は XDR スキーマと同じですが、拡張子は .xsd となります。<br /><br /> XML ファイル \(拡張子 .xml\) を指定すると、Xsd.exe はそのファイル内のデータからスキーマを推測して XSD スキーマを生成します。  出力ファイルの名前は XML ファイルと同じですが、拡張子は .xsd となります。<br /><br /> XML スキーマ ファイル \(拡張子 .xsd\) を指定すると、XML スキーマと対応するランタイム オブジェクト用のソース コードが生成されます。<br /><br /> ランタイム アセンブリ ファイル \(拡張子 .exe または .dll\) を指定すると、そのアセンブリに含まれる 1 つ以上の型用のスキーマが生成されます。  **\/type** オプションを使用して、スキーマを生成する対象の型を指定できます。  出力スキーマには、schema0.xsd、schema1.xsd などの名前が付けられます。  Xsd.exe が複数のスキーマを生成するのは、指定した型によって、カスタム属性 **XMLRoot** を使用する名前空間が特定される場合のみです。|  
+  
+## 一般オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/h**\[**elp**\]|このツールのコマンド構文とオプションを表示します。|  
+|**\/o**\[**utputdir**\]**:***directory*|出力ファイル用のディレクトリを指定します。  この引数は 1 回だけ指定できます。  既定値は、現在のディレクトリです。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+|**\/P\[arameters\]:** *file.xml*|指定された .xml ファイルから各種のオペレーション モードのためのオプションを読み込みます。  省略形は '\/p:' です。  詳細については、「解説」を参照してください。|  
+  
+## XSD ファイルのオプション  
+ .xsd ファイルについては、次のオプションのうち 1 つだけを指定する必要があります。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/c**\[**lasses**\]|指定したスキーマと対応するクラスを生成します。  XML データをオブジェクトに読み込むには、[System.Xml.Serialization.XmlSerializer.Deserializer](frlrfSystemXmlSerializationXmlSerializerClassDeserializeTopic) メソッドを使用します。|  
+|**\/d**\[**ataset**\]|指定したスキーマに対応する <xref:System.Data.DataSet> から派生したクラスを生成します。  XML データを派生クラスに読み込むには、メソッド [System.Data.DataSet.ReadXml](frlrfSystemDataDataSetClassReadXmlTopic) を使用します。|  
+  
+ .xsd ファイルについては、次のオプションのうち任意のオプションを指定できます。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/e**\[**lement**\]**:***element*|コードを生成する対象とする、スキーマ内の要素を指定します。  既定では、すべての要素が指定されます。  この引数は、複数回指定できます。|  
+|**\/enableDataBinding**|データ バインディングを有効にするために、生成されたすべての型に <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装します。  省略形は '**\/edb**' です。|  
+|**\/enableLinqDataSet**|\(短縮形 : **\/eld**\)。LINQ to DataSet を使用して、生成された DataSet を照会できるように指定します。  このオプションは \/dataset オプションも指定した場合に使用されます。  詳細については、次のトピックを参照してください。[LINQ to DataSet Overview](../../../docs/framework/data/adonet/linq-to-dataset-overview.md) および[Querying Typed DataSets](../../../docs/framework/data/adonet/querying-typed-datasets.md).  LINQ の使用に関する一般的な情報については、「[LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)」を参照してください。|  
+|**\/f**\[**ields**\]|プロパティの代わりにフィールドを生成します。  既定では、プロパティが生成されます。|  
+|**\/l**\[**anguage**\]**:***language*|使用するプログラミング言語を指定します。  **CS** \(C\#、既定値\)、**VB** \(Visual Basic\)、**JS** \(JScript\)、または **VJS** \(Visual J\#\) から選択します。  <xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> を実装するクラスの完全修飾名を指定することもできます。|  
+|**\/n**\[**amespace**\]**:***namespace*|生成する型のランタイム名前空間を指定します。  既定の名前空間は **Schemas** です。|  
+|**\/nologo**|バナーを表示しません。|  
+|**\/order**|すべてのパーティクル メンバーに明示的な順序 ID を生成します。|  
+|**\/o\[ut\]:** *directoryName*|ファイルを格納する出力ディレクトリを指定します。  既定値は、現在のディレクトリです。|  
+|**\/u**\[**ri**\]**:***uri*|コードを生成する対象とする、スキーマ内の要素の URI を指定します。  指定した場合、この URI は **\/element** オプションで指定したすべての要素に適用されます。|  
+  
+## DLL ファイルと EXE ファイルのオプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/t**\[**ype**\]**:***typename*|スキーマの作成対象とする型の名前を指定します。  複数の型の引数を指定できます。  *typename* によって名前空間が特定されない場合、指定された型を持つアセンブリに含まれるすべての型が対象となります。  *typename* によって名前空間が特定される場合は、その型だけが対象になります。  *typename* の末尾がアスタリスク \(\*\) の場合は、\* の前にある文字列で始まる型のすべてが対象となります。  **\/type** オプションを省略すると、アセンブリに含まれるすべての型についてスキーマが生成されます。|  
+  
+## 解説  
+ Xsd.exe が実行する操作を次の表に示します。  
+  
+ XDR から XSD へ  
+ XML\-Data\-Reduced スキーマ ファイルから XML スキーマを生成します。  XDR は初期の XML ベースのスキーマ形式です。  
+  
+ XML から XSD へ  
+ XML ファイルから XML スキーマを生成します。  
+  
+ XSD から DataSet へ  
+ XSD スキーマ ファイルから共通言語ランタイムの <xref:System.Data.DataSet> クラスを生成します。  生成されるクラスには、標準の XML データ用のリッチ オブジェクト モデルが用意されています。  
+  
+ XSD からクラスへ  
+ XSD スキーマ ファイルからランタイム クラスを生成します。  生成されたクラスを <xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName> と組み合わせて使用すると、このスキーマに従う XML コードの読み書きを実行できます。  
+  
+ クラスから XSD へ  
+ ランタイム アセンブリ ファイルに含まれる 1 つ以上の型から XML スキーマを生成します。  生成されたスキーマは、**System.Xml.Serialization.XmlSerializer** で使用される XML 形式を定義します。  
+  
+ Xsd.exe によって操作できるのは、W3C \(World Wide Web Consortium\) が提唱する XSD \(XML スキーマ定義\) に準拠した XML スキーマだけです。  XML スキーマ定義の提唱や XML 標準の詳細については、http:\/\/w3.org を参照してください。  
+  
+## XML ファイルによるオプションの設定  
+ **\/parameters** スイッチを使用すると、各種のオプションを設定する単一の XML ファイルを指定できます。  設定できるオプションは、XSD.exe ツールの使用方法によって異なります。  選択肢には、スキーマの生成、コード ファイルの生成、または **DataSet** 機能を含むコード ファイルの生成があります。  たとえば、コード ファイルではなくスキーマを生成する場合、実行可能ファイル \(.exe\) またはタイプ ライブラリ \(.dll\) ファイルの名前に **\<assembly\>** 要素を設定できます。  次の XML に、指定された実行可能ファイルで **\<generateSchemas\>** 要素を使用する方法を示します。  
+  
+```  
+<!-- This is in a file named GenerateSchemas.xml. -->  
+<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>  
+<generateSchemas>  
+   <assembly>ConsoleApplication1.exe</assembly>  
+</generateSchemas>  
+</xsd>  
+```  
+  
+ この XML が GenerateSchemas.xml というファイルに含まれる場合、コマンド プロンプトで、**\/parameters** スイッチを使用して次のように入力し、Enter キーを押します。  
+  
+ **xsd \/p:GenerateSchemas.xml**  
+  
+ アセンブリにある単一の型のスキーマを生成する場合は、次のような XML を使用します。  
+  
+```  
+<!-- This is in a file named GenerateSchemaFromType.xml. -->  
+<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>  
+<generateSchemas>  
+   <type>IDItems</type>  
+</generateSchemas>  
+</xsd>  
+```  
+  
+ しかし、上のコードを使用するには、コマンド プロンプトでアセンブリの名前も指定する必要があります。  コマンド プロンプトで次のように入力します \(XML ファイルの名前を GenerateSchemaFromType.xml と仮定します\)。  
+  
+ **xsd \/p:GenerateSchemaFromType.xml ConsoleApplication1.exe**  
+  
+ **\<generateSchemas\>** 要素に対しては、次のオプションのうち 1 つだけを指定する必要があります。  
+  
+|要素|説明|  
+|--------|--------|  
+|\<assembly\>|スキーマを生成するアセンブリを指定します。|  
+|\<type\>|スキーマを生成するアセンブリに含まれる型を指定します。|  
+|\<xml\>|スキーマを生成する XML ファイルを指定します。|  
+|\<xdr\>|スキーマを生成する XDR ファイルを指定します。|  
+  
+ コード ファイルを生成するには、**\<generateClasses\>** 要素を使用します。  コード ファイルを生成する例を次に示します。  この例では、生成されるファイルのプログラミング言語と名前空間を設定するための 2 つの属性も示されています。  
+  
+```  
+<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>  
+<generateClasses language='VB' namespace='Microsoft.Serialization.Examples'/>  
+</xsd>  
+<!-- You must supply an .xsd file when typing in the command line.-->  
+<!-- For example: xsd /p:genClasses mySchema.xsd -->  
+```  
+  
+ **\<generateClasses\>** 要素に設定できるオプションは次のとおりです。  
+  
+|要素|説明|  
+|--------|--------|  
+|\<element\>|コードを生成する対象となる .xsd ファイルの要素を指定します。|  
+|\<schemaImporterExtensions\>|<xref:System.Xml.Serialization.Advanced.SchemaImporterExtension> クラスから派生する型を指定します。|  
+|\<schema\>|コードを生成する XML スキーマ ファイルを指定します。  複数の \<schema\> 要素を使用して、複数の XML スキーマ ファイルを指定できます。|  
+  
+ 次の表に、**\<generateClasses\>** 要素と共に使用するその他の属性を示します。  
+  
+|属性|説明|  
+|--------|--------|  
+|language|使用するプログラミング言語を指定します。  **CS** \(C\#、既定値\)、**VB** \(Visual Basic\)、**JS** \(JScript\)、または **VJS** \(Visual J\#\) から選択します。  <xref:System.CodeDom.Compiler.CodeDomProvider> を実装するクラスの完全修飾名を指定することもできます。|  
+|namespace|生成するコードの名前空間を指定します。  名前空間は、スペースやバックスラッシュ文字を使用しないなどの CLR 標準に準拠する必要があります。|  
+|options|**none**、**properties** \(パブリック フィールドの代わりにプロパティを生成\)、**order**、または **enableDataBinding** \(前の「XSD ファイルのオプション」セクションの **\/order** と **\/enableDataBinding** スイッチを参照\) のいずれかの値です。|  
+  
+ **\<generateDataSets\>** 要素を使用すると、**DataSet** コードを生成する方法を制御できます。  次の XML は、生成されたコードが `` **DataSet** 構造体 \(<xref:System.Data.DataTable> クラスなど\) を使用して指定された要素のための Visual Basic コードを作成するように指定します。  生成された DataSet 構造体では LINQ クエリがサポートされます。  
+  
+ `\<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/'>`  
+  
+ `<generateDataSet language='VB' namespace='Microsoft.Serialization.Examples' enableLinqDataSet='true'>`  
+  
+ `</generateDataSet>`  
+  
+ `</xsd>`  
+  
+ **\<generateDataSet\>** 要素に設定できるオプションは次のとおりです。  
+  
+|要素|説明|  
+|--------|--------|  
+|\<schema\>|コードを生成する XML スキーマ ファイルを指定します。  複数の \<schema\> 要素を使用して、複数の XML スキーマ ファイルを指定できます。|  
+  
+ **\<generateDataSet\>** 要素と共に使用できる属性を次の表に示します。  
+  
+|属性|説明|  
+|--------|--------|  
+|enableLinqDataSet|LINQ to DataSet を使用して、生成された DataSet を照会できるように指定します。  既定値は false です。|  
+|language|使用するプログラミング言語を指定します。  **CS** \(C\#、既定値\)、**VB** \(Visual Basic\)、**JS** \(JScript\)、または **VJS** \(Visual J\#\) から選択します。  <xref:System.CodeDom.Compiler.CodeDomProvider> を実装するクラスの完全修飾名を指定することもできます。|  
+|namespace|生成するコードの名前空間を指定します。  名前空間は、スペースやバックスラッシュ文字を使用しないなどの CLR 標準に準拠する必要があります。|  
+  
+ トップ レベルの **\<xsd\>** 要素に設定できる属性があります。  これらのオプションは、**\<generateSchemas\>**、**\<generateClasses\>**、または **\<generateDataSet\>** の各子要素と共に使用できます。  次の XML コードは、"MyOutputDirectory" という出力ディレクトリの "IDItems" という要素のコードを生成します。  
+  
+```  
+<xsd xmlns='http://microsoft.com/dotnet/tools/xsd/' output='MyOutputDirectory'>  
+<generateClasses>  
+<element>IDItems</element>  
+</generateClasses>  
+</xsd>  
+```  
+  
+ 次の表に、**\<xsd\>** 要素と共に使用するその他の属性を示します。  
+  
+|属性|説明|  
+|--------|--------|  
+|出力|生成されたスキーマまたはコード ファイルが格納されるディレクトリの名前です。|  
+|nologo|バナーを表示しません。  **true** または **false** に設定します。|  
+|ヘルプ|このツールのコマンド構文とオプションを表示します。  **true** または **false** に設定します。|  
+  
+```  
+  
+```  
+  
+## 例  
+ `myFile.xdr` から XML スキーマを生成し、現在のディレクトリに保存するコマンドを次に示します。  
+  
+```  
+xsd myFile.xdr   
+```  
+  
+ `myFile.xml` から XML スキーマを生成し、指定したディレクトリに保存するコマンドを次に示します。  
+  
+```  
+xsd myFile.xml /outputdir:myOutputDir  
+```  
+  
+ 指定したスキーマと対応するデータセットを C\# 言語で生成し、現在のディレクトリ内に `XSDSchemaFile.cs` として保存するコマンドを次に示します。  
+  
+```  
+xsd /dataset /language:CS XSDSchemaFile.xsd  
+```  
+  
+ `myAssembly.dll` アセンブリ内のすべての型について XML スキーマを生成し、それらを `schema0.xsd` として現在のディレクトリ内に保存するコマンドを次に示します。  
+  
+```  
+xsd myAssembly.dll    
+```  
+  
+## 参照  
+ <xref:System.Data.DataSet>   
+ <xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [System.Xml.Serialization.XmlSerializer.Deserializer](frlrfSystemXmlSerializationXmlSerializerClassDeserializeTopic)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)   
+ [LINQ to DataSet Overview](../../../docs/framework/data/adonet/linq-to-dataset-overview.md)   
+ [Querying Typed DataSets](../../../docs/framework/data/adonet/querying-typed-datasets.md)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)
\ No newline at end of file
diff --git a/docs/framework/serialization/xml-serialization-with-xml-web-services.md b/docs/framework/serialization/xml-serialization-with-xml-web-services.md
new file mode 100644
index 00000000000..b75fa9bd326
--- /dev/null
+++ b/docs/framework/serialization/xml-serialization-with-xml-web-services.md
@@ -0,0 +1,278 @@
+---
+title: "XML Web サービスを使用した XML シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".asmx ファイル"
+  - "asmx ファイル"
+  - "属性 [.NET Framework], XML シリアル化"
+  - "エンコード済み XML シリアル化"
+  - "リテラル XML シリアル化"
+  - "シリアル化, 属性"
+  - "シリアル化, SOAP"
+  - "SOAP, XML シリアル化"
+  - "XML シリアル化, 属性"
+  - "XML シリアル化, XML Web サービス"
+  - "XML Web サービス, XML シリアル化"
+ms.assetid: a416192f-8102-458e-bc0a-0b8f3f784da9
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# XML Web サービスを使用した XML シリアル化
+XML シリアル化は、XML Web サービス アーキテクチャで使用される基礎的なトランスポート機構であり、[XmlSerializer](https://msdn.microsoft.com/en-us/library/system.xml.serialization.xmlserializer.aspx) クラスによって実行されます。XML Web サービスによって生成される XML を制御するには、「[XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)」および「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」の一覧に示されている属性を、XML Web サービスの作成に使用するファイル \(.asmx\) のクラス、戻り値、パラメーター、およびフィールドに適用します。XML Web サービスの作成の詳細については、「[Building XML Web Services Using ASP.NET](http://msdn.microsoft.com/ja-jp/01dfc27c-c68e-4910-a0aa-5e4c2a766b0c)」を参照してください。  
+  
+## リテラル スタイルとエンコード済みスタイル  
+ XML Web サービスによって生成される XML は、「[Customizing SOAP Messages](http://msdn.microsoft.com/ja-jp/1d777288-c0d9-4e6a-b638-f010da031952)」で説明されているリテラルおよびエンコード済みの 2 種類のうち、いずれかの形式を指定できます。このため、XML シリアル化を制御する属性セットは 2 つになります。「[XML シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-xml-serialization.md)」の一覧に示される属性は、リテラル スタイルの XML を制御するように設計されています。一方、「[エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)」の一覧に示される属性は、エンコード済みスタイルを制御します。これらの属性を選択的に適用することで、2 つのスタイルのいずれかまたは両方を返すようにアプリケーションを調整できます。さらに、これらの属性は、必要に応じて戻り値やパラメーターにも適用できます。  
+  
+### 両方のスタイルの使用例  
+ XML Web サービスを作成する場合、両方の属性セットをメソッドで使用できます。次のコード例では、`MyService` という名前のクラスに、`MyLiteralMethod` と `MyEncodedMethod` という 2 つの XML Web サービス メソッドが含まれています。いずれのメソッドも、`Order` クラスのインスタンスを返すという同じ機能を実行します。`Order`  クラスでは、[XmlTypeAttribute](frlrfSystemXmlSerializationXmlTypeAttributeClassTopic) 属性と [SoapTypeAttribute](frlrfSystemXmlSerializationSoapTypeAttributeClassTopic) 属性の両方が `OrderID` フィールドに適用され、両方の属性の `ElementName` プロパティには異なる値が設定されます。  
+  
+ この例を実行するには、拡張子 .asmx のファイルにコードを貼り付け、そのファイルをインターネット インフォメーション サービス \(IIS\) によって管理される仮想ディレクトリに配置して、Internet Explorer などの HTML ブラウザーから、コンピューター名、仮想ディレクトリ名、およびファイル名を入力します。  
+  
+```vb  
+<%@ WebService Language="VB" Class="MyService" %>  
+Imports System  
+Imports System.Web.Services  
+Imports System.Web.Services.Protocols  
+Imports System.Xml.Serialization  
+Public Class Order  
+    ' Both types of attributes can be applied. Depending on which type  
+    ' the method used, either one will affect the call.  
+    <SoapElement(ElementName:= "EncodedOrderID"), _  
+    XmlElement(ElementName:= "LiteralOrderID")> _  
+    public OrderID As String  
+End Class  
+  
+Public Class MyService  
+    <WebMethod, SoapDocumentMethod> _  
+    public Function MyLiteralMethod() As Order   
+        Dim myOrder As Order = New Order()  
+        return myOrder  
+    End Function  
+    <WebMethod, SoapRpcMethod> _  
+    public Function MyEncodedMethod() As Order   
+        Dim myOrder As Order = New Order()  
+        return myOrder  
+    End Function  
+End Class  
+  
+```  
+  
+```csharp  
+<%@ WebService Language="C#" Class="MyService" %>  
+using System;  
+using System.Web.Services;  
+using System.Web.Services.Protocols;  
+using System.Xml.Serialization;  
+public class Order{  
+    // Both types of attributes can be applied. Depending on which type  
+    // the method used, either one will affect the call.  
+    [SoapElement(ElementName = "EncodedOrderID")]  
+    [XmlElement(ElementName = "LiteralOrderID")]  
+    public String OrderID;  
+}  
+public class MyService{  
+    [WebMethod][SoapDocumentMethod]  
+    public Order MyLiteralMethod(){  
+        Order myOrder = new Order();  
+        return myOrder;  
+    }  
+    [WebMethod][SoapRpcMethod]  
+    public Order MyEncodedMethod(){  
+        Order myOrder = new Order();  
+        return myOrder;  
+    }  
+}  
+```  
+  
+ `MyLiteralMethod` を呼び出すコード例を次に示します。要素名は "LiteralOrderID" に変更されています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
+    <soap:Body>  
+        <MyLiteralMethodResponse xmlns="http://tempuri.org/">  
+            <MyLiteralMethodResult>  
+                <LiteralOrderID>string</LiteralOrderID>  
+            </MyLiteralMethodResult>  
+        </MyLiteralMethodResponse>  
+    </soap:Body>  
+</soap:Envelope>  
+```  
+  
+ `MyEncodedMethod` を呼び出すコード例を次に示します。要素名は "EncodedOrderID" です。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://tempuri.org/" xmlns:types="http://tempuri.org/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
+    <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">  
+        <tns:MyEncodedMethodResponse>  
+            <MyEncodedMethodResult href="#id1" />  
+        </tns:MyEncodedMethodResponse>  
+        <types:Order id="id1" xsi:type="types:Order">  
+            <EncodedOrderID xsi:type="xsd:string">string</EncodedOrderID>  
+        </types:Order>  
+    </soap:Body>  
+</soap:Envelope>  
+```  
+  
+### 戻り値への属性の適用  
+ 属性を戻り値に適用して、名前空間や要素名などを制御することもできます。次のコード例では、`XmlElementAttribute` 属性を `MyLiteralMethod` メソッドの戻り値に適用しています。このように属性を適用すると、名前空間や要素名を制御できます。  
+  
+```vb  
+<WebMethod, SoapDocumentMethod> _  
+public Function MyLiteralMethod() As _  
+<XmlElement(Namespace:="http://www.cohowinery.com", _  
+ElementName:= "BookOrder")> _  
+Order   
+    Dim myOrder As Order = New Order()  
+    return myOrder  
+End Function  
+  
+```  
+  
+```csharp  
+[return: XmlElement(Namespace = "http://www.cohowinery.com",  
+ElementName = "BookOrder")]  
+[WebMethod][SoapDocumentMethod]  
+public Order MyLiteralMethod(){  
+    Order myOrder = new Order();  
+    return myOrder;  
+}  
+```  
+  
+ このコードを呼び出すと、次のような XML が返されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
+    <soap:Body>  
+        <MyLiteralMethodResponse xmlns="http://tempuri.org/">  
+            <BookOrder xmlns="http://www.cohowinery.com">  
+                <LiteralOrderID>string</LiteralOrderID>  
+            </BookOrder>  
+        </MyLiteralMethodResponse>  
+    </soap:Body>  
+</soap:Envelope>  
+```  
+  
+### パラメーターに適用される属性  
+ 属性をパラメーターに適用して、名前空間や要素名などを指定することもできます。次のコード例では、`MyLiteralMethodResponse` メソッドにパラメーターを追加し、そのパラメーターに `XmlAttributeAttribute` 属性を適用しています。パラメーターに対して、要素名と名前空間の両方が設定されます。  
+  
+```vb  
+<WebMethod, SoapDocumentMethod> _  
+public Function MyLiteralMethod(<XmlElement _  
+("MyOrderID", Namespace:="http://www.microsoft.com")>ID As String) As _  
+<XmlElement(Namespace:="http://www.cohowinery.com", _  
+ElementName:= "BookOrder")> _  
+Order   
+    Dim myOrder As Order = New Order()  
+    myOrder.OrderID = ID  
+    return myOrder  
+End Function  
+  
+```  
+  
+```csharp  
+[return: XmlElement(Namespace = "http://www.cohowinery.com",  
+ElementName = "BookOrder")]  
+[WebMethod][SoapDocumentMethod]  
+public Order MyLiteralMethod([XmlElement("MyOrderID",   
+Namespace="http://www.microsoft.com")] string ID){  
+    Order myOrder = new Order();  
+    myOrder.OrderID = ID;  
+    return myOrder;  
+}   
+```  
+  
+ SOAP 要求は、次のようになります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
+    <soap:Body>  
+        <MyLiteralMethod xmlns="http://tempuri.org/">  
+            <MyOrderID xmlns="http://www.microsoft.com">string</MyOrderID>  
+        </MyLiteralMethod>  
+    </soap:Body>  
+</soap:Envelope>  
+```  
+  
+### クラスへの属性の適用  
+ クラスと相関関係を持つ要素の名前空間を制御する必要がある場合は、必要に応じて `XmlTypeAttribute`、`XmlRootAttribute`、および `SoapTypeAttribute` を適用します。次のコード例では、3 つの属性すべてを `Order` クラスに適用しています。  
+  
+```vb  
+<XmlType("BigBookService"), _  
+SoapType("SoapBookService"), _  
+XmlRoot("BookOrderForm")> _  
+Public Class Order  
+    ' Both types of attributes can be applied. Depending on which  
+    ' the method used, either one will affect the call.  
+    <SoapElement(ElementName:= "EncodedOrderID"), _  
+    XmlElement(ElementName:= "LiteralOrderID")> _  
+    public OrderID As String  
+End Class  
+  
+```  
+  
+```csharp  
+[XmlType("BigBooksService", Namespace = "http://www.cpandl.com")]  
+[SoapType("SoapBookService")]  
+[XmlRoot("BookOrderForm")]  
+public class Order{  
+    // Both types of attributes can be applied. Depending on which  
+    // the method used, either one will affect the call.  
+    [SoapElement(ElementName = "EncodedOrderID")]  
+    [XmlElement(ElementName = "LiteralOrderID")]  
+    public String OrderID;  
+}  
+```  
+  
+ 次のコード例に示すように、`XmlTypeAttribute` と `SoapTypeAttribute` を適用した結果は、サービスの説明を調べると確認できます。  
+  
+```  
+    <s:element name="BookOrderForm" type="s0:BigBookService" />   
+- <s:complexType name="BigBookService">  
+- <s:sequence>  
+    <s:element minOccurs="0" maxOccurs="1" name="LiteralOrderID" type="s:string" />   
+    </s:sequence>  
+  
+- <s:schema targetNamespace="http://tempuri.org/encodedTypes">  
+- <s:complexType name="SoapBookService">  
+- <s:sequence>  
+    <s:element minOccurs="1" maxOccurs="1" name="EncodedOrderID" type="s:string" />   
+    </s:sequence>  
+    </s:complexType>  
+    </s:schema>  
+```  
+  
+ また、`XmlRootAttribute` を適用した結果も、次に示す HTTP GET と HTTP POST の結果から確認できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<BookOrderForm xmlns="http://tempuri.org/">  
+    <LiteralOrderID>string</LiteralOrderID>  
+</BookOrderForm>  
+```  
+  
+## 参照  
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)   
+ [エンコード済み SOAP シリアル化を制御する属性](../../../docs/framework/serialization/attributes-that-control-encoded-soap-serialization.md)   
+ [方法 : オブジェクトを SOAP エンコード済み XML ストリームとしてシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object-as-a-soap-encoded-xml-stream.md)   
+ [方法 : SOAP エンコード済み XML シリアル化をオーバーライドする](../../../docs/framework/serialization/how-to-override-encoded-soap-xml-serialization.md)   
+ [XML シリアル化の概要](../../../docs/framework/serialization/introducing-xml-serialization.md)   
+ [方法 : オブジェクトをシリアル化する](../../../docs/framework/serialization/how-to-serialize-an-object.md)   
+ [方法 : オブジェクトを逆シリアル化する](../../../docs/framework/serialization/how-to-deserialize-an-object.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/xml-serializer-generator-tool-sgen-exe.md b/docs/framework/serialization/xml-serializer-generator-tool-sgen-exe.md
new file mode 100644
index 00000000000..1cc6a81385e
--- /dev/null
+++ b/docs/framework/serialization/xml-serializer-generator-tool-sgen-exe.md
@@ -0,0 +1,67 @@
+---
+title: "XML シリアライザー ジェネレーター ツール (Sgen.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc1d1f1c-fb26-4be9-885a-3fe84c81cec6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# XML シリアライザー ジェネレーター ツール (Sgen.exe)
+XML シリアライザー ジェネレーターは、指定された型のオブジェクトをシリアル化または逆シリアル化するとき、<xref:System.Xml.Serialization.XmlSerializer> の起動パフォーマンスを向上させるために、指定されたアセンブリの型に対して XML シリアル化アセンブリを作成します。  
+  
+## 構文  
+  
+```  
+  
+sgen [options]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/a**\[**ssembly**\]**:***filename*|アセンブリ、または *filename* によって指定される実行可能ファイルに含まれるすべての型に対して、シリアル化コードを生成します。  指定できるファイル名は 1 つのみです。  この引数を複数指定した場合は、最後のファイル名が使用されます。|  
+|**\/c\[ompiler\]:** *options*|オプションを C\# コンパイラに渡すように指定します。  csc.exe のすべてのオプションがサポートされ、コンパイラに渡されます。  このオプションを使用して、アセンブリに署名してキー ファイルを指定するように指定できます。|  
+|**\/d**\[**ebug**\]|デバッガーで使用できるイメージを生成します。|  
+|**\/f\[orce\]**|同じ名前の既存のアセンブリに上書きします。  既定値は、**false** です。|  
+|**\/help or \/?**|このツールのコマンド構文とオプションを表示します。|  
+|**\/k**\[**eep**\]|生成されたソース ファイルとその他の一時ファイルをシリアル化アセンブリにコンパイルした後、元のファイルを削除しません。  このオプションを使用して、ツールが特定の型に対してシリアル化コードを生成するかどうかを指定できます。|  
+|**\/n**\[**ologo**\]|Microsoft の著作権情報を表示しません。|  
+|**\/o**\[**ut**\]**:***path*|生成されたアセンブリの保存先のディレクトリを指定します。 **Note:**  生成されたアセンブリの名前は、入力アセンブリの名前と "xmlSerializers.dll" で構成されます。|  
+|**\/p**\[**roxytypes**\]|XML Web サービス プロキシ型に対してのみシリアル化コードを生成します。|  
+|**\/r**\[**eference**\]**:***assemblyfiles*|XML シリアル化が必要な型によって参照されるアセンブリを指定します。  コンマで区切られた複数のアセンブリ ファイルを受け入れます。|  
+|**\/s**\[**ilent**\]|成功メッセージを表示しません。|  
+|**\/t**\[**ype**\]**:***type*|指定された型に対してのみ、シリアル化コードを生成します。|  
+|**\/v**\[**erbose**\]|デバッグに関する詳細出力を表示します。  <xref:System.Xml.Serialization.XmlSerializer> でシリアル化できない対象アセンブリの型を一覧表示します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ XML シリアライザー ジェネレーターを使用しない場合、<xref:System.Xml.Serialization.XmlSerializer> はアプリケーションを実行するたびに、各型に対してシリアル化コードとシリアル化アセンブリを生成します。  XML シリアル化起動のパフォーマンスを向上させるには、Sgen.exe ツールを使用して、あらかじめこれらのアセンブリを生成します。  生成したアセンブリは、アプリケーションで配置できます。  
+  
+ XML シリアライザー ジェネレーターは、サーバーとの通信に XML Web サービス プロキシを使用するクライアントのパフォーマンスも向上させますが、これは型が初めて読み込まれるとき、シリアル化プロセスによってパフォーマンスが低下しないためです。  
+  
+ これらの生成されたアセンブリは、Web サービスのサーバー側では使用できません。  このツールは、Web サービス クライアントと手動シリアル化シナリオに対してのみ使用できます。  
+  
+ シリアル化する型を含むアセンブリの名前が MyType.dll の場合、関連するシリアル化アセンブリの名前は MyType.XmlSerializers.dll となります。  
+  
+## 例  
+ 次のコマンドは、Data.dll という名前のアセンブリに含まれるすべての型をシリアル化するために、Data.XmlSerializers.dll という名前のアセンブリを作成します。  
+  
+```  
+sgen Data.dll   
+```  
+  
+ Data.XmlSerializers.dll アセンブリは、Data.dll の型をシリアル化および逆シリアル化する必要のあるコードから参照できます。  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [XML Web Services Overview](http://msdn.microsoft.com/ja-jp/9db0c7b8-bca6-462b-9be5-f5f9a7f05a4d)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/serialization/xmlserializer-element.md b/docs/framework/serialization/xmlserializer-element.md
new file mode 100644
index 00000000000..2c7541cf2b2
--- /dev/null
+++ b/docs/framework/serialization/xmlserializer-element.md
@@ -0,0 +1,74 @@
+---
+title: "&lt;xmlSerializer&gt; 要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "<xmlSerializer> 要素"
+  - "XML シリアル化, 構成"
+  - "xmlSerializer 要素"
+ms.assetid: d129d10c-3eb7-45d9-8098-5fa853825e47
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# &lt;xmlSerializer&gt; 要素
+<xref:System.Xml.Serialization.XmlSerializer> の進行状況の追加チェックを行うかどうかを指定します。  
+  
+## 構文  
+  
+```  
+  
+<xmlSerializer checkDeserializerAdvance = "true"|"false" />  
+```  
+  
+## 属性および要素  
+ 以降のセクションでは、属性、子要素、および親要素について説明します。  
+  
+### 属性  
+  
+|属性|説明|  
+|--------|--------|  
+|**checkDeserializeAdvances**|<xref:System.Xml.Serialization.XmlSerializer> の進行状況をチェックするかどうかを指定します。  属性は "true" または "false" に設定します。  既定値は "true" です。|  
+|**useLegacySerializationGeneration**|C\# コードをファイルに記述し、それをアセンブリにコンパイルすることによってアセンブリを生成する従来のシリアル化の生成を、<xref:System.Xml.Serialization.XmlSerializer> で使用するかどうかを指定します。  既定値は、**false** です。|  
+  
+### 子要素  
+ なし。  
+  
+### 親要素  
+  
+|要素|説明|  
+|--------|--------|  
+|[\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)|<xref:System.Xml.Serialization.XmlSerializer> クラスおよび <xref:System.Xml.Serialization.XmlSchemaImporter> クラスの構成設定を含みます。|  
+  
+## 解説  
+ 既定では、<xref:System.Xml.Serialization.XmlSerializer> は、信頼できないデータを逆シリアル化する際に、サービス拒否攻撃の可能性に対するセキュリティをさらに高めることができます。  これは、逆シリアル化中に無限ループを検出することにより行われます。  このような状態が検出されると例外がスローされ、"内部エラー: 逆シリアル化は基になるストリームのセキュリティの強化に失敗しました。" というメッセージが表示されます。  
+  
+ このメッセージは、必ずしもサービス拒否攻撃を受けていることを示すわけではありません。  まれに、無限ループ検出機構で誤検出が発生し、適正な受信メッセージに対して例外がスローされる場合があります。  特定のアプリケーションにおいて、セキュリティの強化によって適正なメッセージが拒否される場合は、**checkDeserializeAdvances** 属性を "false" に設定します。  
+  
+## 使用例  
+ **checkDeserializeAdvances** 属性を "false" に設定するコード例を次に示します。  
+  
+```  
+<configuration>  
+  <system.xml.serialization>  
+    <xmlSerializer checkDeserializeAdvances="false" />  
+  </system.xml.serialization>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ [\<system.xml.serialization\> 要素](../../../docs/framework/serialization/system-xml-serialization-element.md)   
+ [XML シリアル化および SOAP シリアル化](../../../docs/framework/serialization/xml-and-soap-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/tools/TOC.md b/docs/framework/tools/TOC.md
new file mode 100644
index 00000000000..7086fe84987
--- /dev/null
+++ b/docs/framework/tools/TOC.md
@@ -0,0 +1,36 @@
+# [MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント)](mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)
+# [Mpgo.exe (マネージ プロファイル ガイド付き最適化ツール)](mpgo-exe-managed-profile-guided-optimization-tool.md)
+# [Peverify.exe (PEVerify ツール)](peverify-exe-peverify-tool.md)
+# [CorFlags.exe (CorFlags 変換ツール)](corflags-exe-corflags-conversion-tool.md)
+# [Tlbimp.exe (タイプ ライブラリ インポーター)](tlbimp-exe-type-library-importer.md)
+# [Fuslogvw.exe (アセンブリ バインディング ログ ビューアー)](fuslogvw-exe-assembly-binding-log-viewer.md)
+# [Regasm.exe (アセンブリ登録ツール)](regasm-exe-assembly-registration-tool.md)
+# [Ildasm.exe (IL 逆アセンブラー)](ildasm-exe-il-disassembler.md)
+# [Winmdexp.exe (Windows ランタイム メタデータのエクスポート ツール)](winmdexp-exe-windows-runtime-metadata-export-tool.md)
+# [Caspol.exe (コード アクセス セキュリティ ポリシー ツール)](caspol-exe-code-access-security-policy-tool.md)
+# [Clrver.exe (CLR バージョン ツール)](clrver-exe-clr-version-tool.md)
+# [Winres.exe (Windows フォーム リソース エディター)](winres-exe-windows-forms-resource-editor.md)
+# [Sn.exe (厳密名ツール)](sn-exe-strong-name-tool.md)
+# [Cert2spc.exe (ソフトウェア発行元証明書テスト ツール)](cert2spc-exe-software-publisher-certificate-test-tool.md)
+# [Storeadm.exe (分離ストレージ ツール)](storeadm-exe-isolated-storage-tool.md)
+# [Al.exe (アセンブリ リンカー)](al-exe-assembly-linker.md)
+# [Tlbexp.exe (タイプ ライブラリ エクスポーター)](tlbexp-exe-type-library-exporter.md)
+# [ツール](index.md)
+# [SOS.dll (SOS デバッガー拡張)](sos-dll-sos-debugging-extension.md)
+# [コマンド プロンプト](developer-command-prompt-for-vs.md)
+# [Resgen.exe (リソース ファイル ジェネレーター)](resgen-exe-resource-file-generator.md)
+# [Winmdexp.exe のエラー メッセージ](winmdexp-exe-error-messages.md)
+# [SqlMetal.exe (コード生成ツール)](sqlmetal-exe-code-generation-tool.md)
+# [SecAnnotate.exe (.NET セキュリティ アノテーター ツール)](secannotate-exe-net-security-annotator-tool.md)
+# [Certmgr.exe (証明書マネージャー ツール)](certmgr-exe-certificate-manager-tool.md)
+# [Mage.exe (マニフェストの生成および編集ツール)](mage-exe-manifest-generation-and-editing-tool.md)
+# [Regsvcs.exe (.NET サービス インストール ツール)](regsvcs-exe-net-services-installation-tool.md)
+# [Ilasm.exe (IL アセンブラー)](ilasm-exe-il-assembler.md)
+# [Gacutil.exe (グローバル アセンブリ キャッシュ ツール)](gacutil-exe-gac-tool.md)
+# [Aximp.exe (Windows フォーム ActiveX コントロール インポーター)](aximp-exe-windows-forms-activex-control-importer.md)
+# [Ngen.exe (ネイティブ イメージ ジェネレーター)](ngen-exe-native-image-generator.md)
+# [Installutil.exe (インストーラー ツール)](installutil-exe-installer-tool.md)
+# [Lc.exe (ライセンス コンパイラ)](lc-exe-license-compiler.md)
+# [MDbg.exe (.NET Framework コマンド ライン デバッガー)](mdbg-exe.md)
+# [SignTool.exe (署名ツール)](signtool-exe.md)
+# [Mgmtclassgen.exe (厳密型クラス ジェネレーター)](mgmtclassgen-exe.md)
diff --git a/docs/framework/tools/al-exe-assembly-linker.md b/docs/framework/tools/al-exe-assembly-linker.md
new file mode 100644
index 00000000000..0cff2032ddd
--- /dev/null
+++ b/docs/framework/tools/al-exe-assembly-linker.md
@@ -0,0 +1,186 @@
+---
+title: "Al.exe (アセンブリ リンカー) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Al.exe"
+  - "アセンブリ リンカー"
+  - "モジュール, アセンブリ リンカー"
+  - "アセンブリ マニフェスト, アセンブリ リンカー"
+ms.assetid: b5382965-0053-47cf-b92f-862860275a01
+caps.latest.revision: 37
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# Al.exe (アセンブリ リンカー)
+アセンブリ リンカーは、モジュールまたはリソース ファイルのいずれかである&1; つ以上のファイルから、アセンブリのマニフェストを含むファイルを生成します。 モジュールとは、アセンブリ マニフェストを含まない中間言語 (IL: Intermediate Language) ファイルのことです。  
+  
+> [!NOTE]
+>  Windows Vista コンピューターで仮想化されることを回避するには、要求実行レベルを指定した Win32 マニフェストがアセンブリに含まれていることが必要です。 コマンド ラインから al.exe を直接使用するときには、Win32 リソース ファイルにマニフェストを埋め込むことができます。または、ビルド プロセスの後の段階で mt.exe を使用してマニフェストを追加することも可能です。 [!INCLUDE[vs_orcas_long](../../../includes/vs-orcas-long-md.md)] 以降では、C# と Visual Basic のどちらのコンパイラを使用しても、Win32 マニフェストはアセンブリに自動的に埋め込まれます。 詳細については、次を参照してください。 [/win32manifest (c# コンパイラ オプション)](../Topic/-win32manifest%20\(C%23%20Compiler%20Options\).md)します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト (または、Windows 7 の Visual Studio コマンド プロンプト) を使用します。 詳細については、次を参照してください。[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)します。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## <a name="syntax"></a>構文  
+  
+```  
+al sources options  
+```  
+  
+#### <a name="parameters"></a>パラメーター  
+ 次の `sources` を&1; つ以上組み合わせて指定できます。  
+  
+|ソース|説明|  
+|------------|-----------------|  
+|`file`[,`target`]|`file` (モジュール) の内容を `target` で名前が指定されたファイルにコピーします。 コピーが完了すると、Al.exe は `target` をコンパイルしてアセンブリを生成します。|  
+|**/embed**[`resource`]`:``file`[,`name`[,`private`]]|`file` で指定したリソースをアセンブリ マニフェストを含むイメージに埋め込みます。Al.exe は、`file` の内容をポータブル実行可能 (PE) イメージにコピーします。<br /><br /> `name` パラメーターは、リソースの内部識別子です。 既定では、リソースはアセンブリでパブリックに指定されており、他のアセンブリから参照できます。 `private` を指定すると、そのリソースを他のアセンブリから参照できなくなります。<br /><br /> 場合`file`で作成された場合など、.NET Framework リソース ファイルには、[リソース ファイル ジェネレーター (Resgen.exe)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)または開発環境でアクセスできるメンバー間で、 <xref:System.Resources>します。 詳細については、次を参照してください。 <xref:System.Resources.ResourceManager>します。 他のすべてのリソースを使用して、 `GetManifestResource`* 内のメソッド、<xref:System.Reflection.Assembly>実行時にリソースにアクセスします。<br /><br /> リソース ファイルだけが Al.exe に渡された場合は、出力ファイルはサテライト リソース アセンブリになります。|  
+|**/link**[`resource`]:`file`[,`name`[,`target`[,`private`]]]|リソース ファイルをアセンブリにリンクします。 `file` によって指定されたリソースがアセンブリの一部になります。ファイルはコピーされません。 `file` パラメーターには、任意のファイル形式を指定できます。 たとえば、`file` パラメーターとしてネイティブ DLL を指定できます。 このようにすると、ネイティブ DLL はアセンブリの一部になるので、グローバル アセンブリ キャッシュにインストールして、アセンブリ内のマネージ コードからアクセスできます。 使用して実行することもできる、 **/linkresource**コンパイラ オプション。 詳細については、次を参照してください。 [/linkresource (c# コンパイラ オプション)](../Topic/-linkresource%20\(C%23%20Compiler%20Options\).md)します。<br /><br /> `name`パラメーターは、リソースの内部識別子。 `target`パラメーター Al.exe コピーする対象へのパスとファイル名の指定、 `file`*します。* コピーが完了すると、Al.exe は `target` をコンパイルしてアセンブリを生成します。 既定では、リソースはアセンブリでパブリックに指定されており、他のアセンブリから参照できます。 `private` を指定すると、そのリソースを他のアセンブリから参照できなくなります。<br /><br /> 場合`file`作成されると、.NET Framework リソース ファイルは、たとえば、リソース ファイル ジェネレーター (Resgen.exe) や開発環境などでアクセスできるメンバー間で、 <xref:System.Resources>名前空間。 詳細については、次を参照してください。 <xref:System.Resources.ResourceManager>します。 他のすべてのリソースを使用して、 `GetManifestResource` * 内のメソッド、<xref:System.Reflection.Assembly>実行時にリソースにアクセスするクラス。<br /><br /> リソース ファイルだけが Al.exe に渡された場合は、出力ファイルはサテライト リソース アセンブリになります。|  
+  
+ 次を指定する`options`; を指定する必要があります**/out**します。  
+  
+|オプション|説明|  
+|------------|-----------------|  
+|**/algid**:`id`|アセンブリ マニフェストを含むファイルを除き、マルチファイル アセンブリ内の全ファイルをハッシュするためのアルゴリズムを指定します。 既定のアルゴリズムは CALG_SHA1 です。 その他のアルゴリズムについては、プラットフォーム SDK の ALG_ID のトピックを参照してください。 .NET Framework の最初のリリースでは、CALG_SHA1 および CALG_MD5 だけがサポートされています。<br /><br /> ハッシュ値は、アセンブリ マニフェストのファイル テーブルに格納されます。 インストール時や読み込み時に、アセンブリのファイルがそのハッシュと突き合わせされてチェックされます。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyAlgorithmIdAttribute>) 任意のモジュールのソース コードにします。|  
+|**/base**[`address`]:`addr`|実行時にユーザーのコンピューターに DLL を読み込む先のアドレスを指定します。 オペレーティング システムにプロセス空間内で DLL を再配置させる代わりに DLL のベース アドレスを指定しておくと、アプリケーションの読み込み速度が速くなります。|  
+|**/bugreport**:`filename`|バグ レポート用の情報を含むファイル (`filename`) を作成します。|  
+|**/comp**[`any`]:`text`|アセンブリの Company フィールドに文字列を指定します。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、`text`としてエクスプ ローラーに表示される、`Company`ファイルのプロパティです。 指定した場合**/win32res**、として指定したリソース ファイル内の企業情報が表示されます、`Company`ファイル エクスプ ローラーのプロパティです。<br /><br /> テキストが空の文字列 ("") の場合、Win32 `Company` リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、**お客様/貴社**Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyCompanyAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/config**[`uration`]:`text`|アセンブリの Configuration フィールドに文字列を指定します。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> テキストが空の文字列の場合、Win32 Configuration リソースは単一の空白として表示されます。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyConfigurationAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/copy**[`right`]:`text`|アセンブリの Copyright フィールドに文字列を指定します。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **著作権/**著作権 Win32 リソースとしてエクスプ ローラーに表示されます。<br /><br /> テキストが空の文字列の場合、Win32 Copyright リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、 **著作権/** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyCopyrightAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/c**[**ulture**]:`text`|アセンブリに関連付けるカルチャ文字列を指定します。 カルチャとして有効な値は、RFC (Internet Requests for Comments) ドキュメント 1766 『Tags for the Identification of Languages』で定義されている値です。<br /><br /> `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 既定のカルチャ文字列はありません。 この文字列は、リフレクションを使用して表示するために使用できます。<br /><br /> 有効な方法について`text`、文字列を参照してください、 <xref:System.Globalization.CultureInfo>します。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyCultureAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/delay**[`sign`][`+&#124;-`]|アセンブリに完全に署名するか、部分的に署名するかを指定します。 使用**/delaysign-**完全署名されたアセンブリを作成する場合。 使用**/delaysign +**アセンブリに公開キーを含めるだけの場合。<br /><br /> アセンブリに完全に署名するように指定すると、Al.exe はマニフェスト (アセンブリ メタデータ) を含むファイルをハッシュし、秘密キーでそのハッシュに署名します。 結果として得られるデジタル署名は、マニフェストを含むファイルに格納されます。 アセンブリに遅延署名した場合は、署名は算出および格納されず、後で署名を追加できるようにファイル内の空間が予約されます。<br /><br /> 既定値は**/delaysign-**します。<br /><br /> **/Delaysign**オプションも何も起こりませんと共に使用しなければ**/keyfile**または**/keyname**します。<br /><br /> たとえばを使用して**/delaysign +**により、テスト時にアセンブリをグローバル キャッシュに格納します。 テスト後に、アセンブリに秘密キーを含めることにより、そのアセンブリに完全署名できます。<br /><br /> 注: を使用する前に、 [Gacutil.exe (グローバル アセンブリ キャッシュ ツール)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)に遅延署名アセンブリをグローバル キャッシュに組み込むを使用して、 [Sn.exe (厳密名ツール)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)検証をスキップ アセンブリを登録します。 たとえば、`Sn.exe –Vr delaySignedAssembly` のようにします。 これは、開発にのみ使用してください。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyDelaySignAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/descr**[**iption**]**:**`text`|文字列を示す、<xref:System.Reflection.AssemblyDescriptionAttribute.Description%2A>アセンブリのです。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **/description** Win32 としてエクスプ ローラーに表示される**コメント**リソースです。<br /><br /> テキストが空の文字列は、Win32 場合**コメント**リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、 **/description** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyDescriptionAttribute.Description%2A>) の任意の MSIL モジュールのソース コードにします。|  
+|**/e [vidence]:**`file`|Security.Evidence のリソース名を持つアセンブリに `file` を埋め込みます。<br /><br /> 通常のリソースに対して Security.Evidence を使用することはできません。|  
+|**/fileversion:**`version`|文字列を示す、**ファイル バージョン**アセンブリのです。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **/fileversion** Win32 として使用される**ファイル バージョン**リソースです。 指定しない場合**/fileversion**、Win32**ファイル バージョン**、Win32 リソースに設定されます**アセンブリ バージョン**リソースです。<br /><br /> 場合**/win32res**が指定されている**/fileversion** Win32 リソースには影響しません。<br /><br /> このオプションは、任意の MSIL モジュールのソース コードでカスタム属性 (AssemblyFileVersionAttribute) として指定することもできます。|  
+|**/flags:**`flags`|アセンブリの `Flags` フィールドに値を指定します。 `flags` に指定できる値は次のとおりです。<br /><br /> 0x0000<br /> アセンブリは side-by-side 実行をサポートしています。<br /><br /> 0x0010<br /> アセンブリは別のバージョンが同じアプリケーション ドメインで実行されている場合には実行できません。<br /><br /> 0x0020<br /> アセンブリは別のバージョンが同じプロセスで実行されている場合には実行できません。<br /><br /> 0x0030<br /> アセンブリは別のバージョンが同じコンピューターで実行されている場合には実行できません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyFlagsAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/fullpaths**|エラー メッセージで報告されるすべてのファイルについて、Al.exe が絶対パスを使用するように指定します。|  
+|**/help**|このツールのコマンド構文とオプションを表示します。|  
+|**/keyf [ile]:**`filename`|アセンブリに署名するためのキー ペアまたは公開キーだけを含むファイル (`filename`) を指定します。 コンパイラは、アセンブリ マニフェストに公開キーを挿入し、最終的なアセンブリに秘密キーで署名します。 参照してください、[厳密名ツール (Sn.exe)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)については、キー ファイルを生成して、キー コンテナーへのキー ペアをインストールします。<br /><br /> 遅延署名を使用する場合は、通常、このファイルには公開キーだけが含まれ、秘密キーは含まれません。<br /><br /> キー ペアの公開キー情報は、アセンブリの .publickey フィールドに表示されます。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyKeyFileAttribute>) の任意の MSIL モジュールのソース コードにします。<br /><br /> 両方**/keyfile**と**/keyname** (コマンド ライン オプションまたはカスタム属性によって) を指定された、同じコンパイル時に Al.exe はまずで指定された、コンテナーで**/keyname**します。 成功すると、キー コンテナー内の情報を使用して、アセンブリが署名されます。 Al.exe にキー コンテナーが見つからない場合に指定されたファイルはしようとする**/keyfile**します。 成功すると、キー ファイルの情報は、アセンブリが署名され、キー情報は、キー コンテナーにインストールされます (-i のようなオプションに[Sn.exe](../../../docs/framework/tools/sn-exe-strong-name-tool.md)) できるように、次のコンパイル時に、 **/keyname**オプションが有効になります。|  
+|**/keyn \\ [名前]:**`text`|キー ペアを保持するコンテナーを指定します。 これにより、公開キーがアセンブリ マニフェストに挿入され、アセンブリに署名 (厳密な名前が指定) されます。 次に、Al.exe は最終的なアセンブリに秘密キーで署名します。<br /><br /> Sn.exe を使用して、キー ペアを生成します。<br /><br /> キー情報は、アセンブリの .publickey フィールドに表示されます。<br /><br /> 空白が埋め込まれている場合は、`text` を二重引用符 (" ") で囲みます。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyKeyNameAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/main:**`method`|モジュールを実行可能ファイルに変換するときに、エントリ ポイントとして使用するメソッドの完全修飾名 (`class`.`method`) を指定します。|  
+|**/nologo**|Al.exe の起動時に、著作権情報またはロゴをコマンド ラインに表示しないようにします。|  
+|**/out:**`filename`|Al.exe で作成されるファイルの名前を指定します。 これは必須オプションです。|  
+|**/platform**:`text`|コードを実行できるプラットフォームを制限します。x86、Itanium、x64、anycpu (既定値)、anycpu32bitpreferred のいずれかである必要があります。|  
+|**[uct] prod/:**`text`|文字列を示す、**製品**アセンブリのです。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **/product** Win32 としてエクスプ ローラーに表示される**製品名**リソースです。<br /><br /> テキストが空の文字列は、Win32 場合**製品名**リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、 **/product** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyProductAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/productv [バージョン]:**`text`|文字列を示す、**製品バージョン**アセンブリのです。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **/productversion** Win32 として使用される**製品バージョン**リソースです。 指定しない場合**/productversion**、Win32**製品バージョン**、Win32 リソースに設定されます**ファイル バージョン**リソースです。<br /><br /> 指定した場合**/win32res**、 **/productversion** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyInformationalVersionAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/t [arget]: lib [rary] |exe |win [exe]**|出力ファイルのファイル形式として、lib[rary] (コード ライブラリ)、exe (コンソール アプリケーション)、または win[exe] (Windows ベースのアプリケーション) のいずれかを指定します。 既定値は lib[rary] です。|  
+|**/template:**`filename`|カルチャ フィールドを除く、すべてのアセンブリ メタデータの継承元であるアセンブリ (`filename`) を指定します。<br /><br /> 使用して作成したアセンブリ**/template**サテライト アセンブリになります。|  
+|**/title:**`text`|文字列を示す、**タイトル**アセンブリのです。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、 **/title** Win32 としてエクスプ ローラーに表示される**説明**リソースで、アプリケーションのフレンドリ名としてシェルによって使用されます。 表示されますが、**ファイルを開く**は、複数のアプリケーションでサポートしているすべてのファイルの種類のショートカット メニューのサブメニュー。<br /><br /> テキストが空の文字列は、Win32 場合**説明**リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、 **/title** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyTitleAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**[マーク] を交換/:**`text`|文字列を示す、**商標**アセンブリのです。 `text` に空白が含まれている場合は、文字列を二重引用符 (" ") で囲みます。 この文字列はアセンブリのカスタム属性であり、リフレクションを使用して表示するために使用できます。<br /><br /> 指定しない場合**/win32res**、**商標/** Win32 としてエクスプ ローラーに表示される**商標**リソースです。<br /><br /> テキストが空の文字列は、Win32 場合**商標**リソースは単一の空白として表示されます。<br /><br /> 指定した場合**/win32res**、 **商標/** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyTrademarkAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/v [バージョン]:**`version`|アセンブリのバージョン情報を指定します。 バージョン文字列の形式は `major`.`minor`.`build`.`revision` です。 既定値は 0 です。<br /><br /> 指定した場合**/version**を指定する必要があります`major`します。 指定した場合`major`と`minor`、アスタリスクを指定することができます (\*) の`build`です。 その場合、`build` は現地時間の 2000 年 1 月 1 日以降の経過日数と等しい値になり、`revision` は現地時間の当日の午前 0 時以降の経過秒数を 2 で割った値と等しくなります。<br /><br /> `major`、`minor`、および `build` を指定する場合、`revision` に対してアスタリスクを指定できます。 その場合、`revision` は現地時間の当日の午前 0 時以降の経過秒数を 2 で割った値と等しくなります。<br /><br /> まとめると、有効なバージョン文字列は次のようになります。<br /><br /> X<br /><br /> X.X<br /><br /> X.X.\*<br /><br /> X.X.X<br /><br /> X.X.X.\*<br /><br /> X.X.X.X<br /><br /> X は 65535 を除く unsigned short 定数 (0 ～ 65534) です。<br /><br /> 指定しない場合**/win32res**、 **/version** Win32 として使用される**アセンブリ バージョン**リソースです。<br /><br /> 指定しない場合**/win32res**、 **/productversion**、および**/fileversion**、 **/version**に使用される、**アセンブリのバージョン**、ファイルのバージョン、および**製品バージョン**Win32 リソースです。<br /><br /> 指定した場合**/win32res**、 **/version** Win32 リソース情報は変わりません。<br /><br /> カスタム属性として、このオプションを指定することもできます (<xref:System.Reflection.AssemblyVersionAttribute>) の任意の MSIL モジュールのソース コードにします。|  
+|**/win32icon:**`filename`|.ico ファイルをアセンブリに挿入します。 この .ico ファイルは、エクスプローラーにおける出力ファイルの視覚的な表現を提供します。|  
+|**/win32res:**`filename`|Win32 リソース (.res ファイル) を出力ファイルに挿入します。 Win32 リソース ファイルは、リソース コンパイラを使用して作成できます。 リソース コンパイラは、Visual C++ プログラムをコンパイルするときに呼び出されます。.res ファイルは .rc ファイルから作成されます。|  
+|`@filename`|Al.exe コマンドが格納されている応答ファイルを指定します。<br /><br /> 応答ファイルでは、コマンドは各行に&1; つずつ指定されるか、複数のコマンドが&1; 行に空白で区切られて指定されます。|  
+|**/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## <a name="remarks"></a>コメント  
+ すべての Visual Studio コンパイラは、アセンブリを生成します。 ただし、モジュール (マニフェストを含まないメタデータ) が&1; つ以上ある場合は、Al.exe を使用して、マニフェストを別個のファイルに含むアセンブリを作成できます。  
+  
+ キャッシュにアセンブリをインストールする、キャッシュからアセンブリを削除またはキャッシュの内容の一覧表示、使用する、[グローバル アセンブリ キャッシュ ツール (Gacutil.exe)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)します。  
+  
+## <a name="errors-and-warnings"></a>エラーと警告  
+ Al.exe で発生するエラーの一覧を次の表に示します。  
+  
+|エラー|説明|  
+|-----------|-----------------|  
+|al1001|内部コンパイル エラー<br /><br /> エラーの発生原因が、予期しない構文を解析できなかったためかどうかを調べてください。 その後、マイクロソフト製品 サポート サービスにお問い合わせください。|  
+|al1002|メモリが不足しています<br /><br /> Al.exe がメモリ不足のため、停止しました。 使用できるメモリの容量を増やしてください。|  
+|al1003|コンパイラ オプション 'option' の後には引数が必要です。<br /><br /> コマンド ライン オプションに引数を渡す必要があります。 たとえば、指定した**/algid:**、アルゴリズム識別子を渡す必要があります。|  
+|al1004|予期しない共通言語ランタイム初期化エラーです — '理由'<br /><br /> メッセージに示された原因により、Visual Studio または共通言語ランタイムのインストールに関するエラーが発生しました。|  
+|al1005|ファイル 'file' のサイズが大きすぎて開けません<br /><br /> Al.exe で開くファイルは、4 ギガバイト (GB) 未満であることが必要です。|  
+|al1006|応答ファイル 'file' は既に含まれています<br /><br /> 同じ応答ファイルが、コマンド ライン (`@file`) で複数回指定されました。 応答ファイルを指定できるのは&1; 回だけです。|  
+|al1007|応答ファイル 'file' を開いているときにエラーが発生しました -- '理由'<br /><br /> メッセージに示された原因により、指定された応答ファイルを開くことができません。|  
+|al1008|'option' コマンド ライン オプションに対するファイル指定がありません。<br /><br /> コマンド ライン オプションにファイルを渡す必要があります。 たとえば、指定した場合、 **/out**オプション、ファイルを指定する必要があります。|  
+|al1009|'file' を書き込むために開くことができません<br /><br /> 出力アセンブリ ファイルなどのファイルに書き込みできませんでした。 ディスクがいっぱいである、ファイルが読み取り専用である、ファイルに対するアクセス許可がないなどの理由が考えられます。|  
+|al1010|コマンドライン構文エラー: 'option' オプションの ':text' がありません<br /><br /> コマンド ライン オプションに引数を渡す必要があります。 たとえば、指定した場合、 **/title**オプション文字列を渡す必要があります。|  
+|al1011|ファイル 'file' は実行可能ファイルです。テキスト ファイルとして開くことはできません<br /><br /> テキスト ファイルを指定する必要があるところにバイナリ ファイルが指定されました。 たとえば、コマンド ラインで応答ファイルとしてバイナリ ファイルが渡されると、このエラーが発生します。|  
+|al1012|'value' はオプション 'option' に対する有効な設定ではありません<br /><br /> コマンド ライン オプションに予期しない値が渡されました。 このエラーは発生に無効な値を指定する場合など、 **/target**オプション。|  
+|al1013|認識できないコマンド ライン オプション : 'option'<br /><br /> 指定されたコマンド ライン オプションが無効です。|  
+|al1014|予期しない初期化エラーです — '理由'<br /><br /> COM を初期化できなかったことが検出されました。 このエラーの原因としては、メモリ不足も考えられますが、システム DLL ファイルが原因であるケースが一般的です。 この場合、オートメーションや COM に対応したプログラム (Microsoft Visual Studio など) を実行する場合にも類似のエラーが発生するはずです。<br /><br /> オペレーティング システムを再インストールしてください。|  
+|al1015|メッセージ ファイル 'alinkui.dll' が見つかりません<br /><br /> Al.exe には Alinkui.dll が必要です。 このファイルがパス上にあるかどうかを確認してください。 必要な場合は、製品 CD から Alinkui.dll をコピーしてください。|  
+|al1016|有効な入力ファイルが指定されませんでした<br /><br /> アセンブリ情報を含んでいない&1; つ以上の入力ファイルを指定する必要があります。|  
+|al1017|ターゲット ファイル名が指定されませんでした<br /><br /> 必要な**/out**オプションを使用してターゲット ファイル名がありませんでした。|  
+|al1018|必要なファイル 'file' を読み込めませんでした<br /><br /> 特定の DLL ファイルを読み込めません。 Visual Studio または [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] を再インストールしてください。|  
+|al1019|アセンブリを作成中にメタデータが失敗しました — 理由<br /><br /> メッセージに示された原因により、アセンブリの生成が中断されました。 たとえば、このエラーが発生で指定したファイル、 **/win32res**オプションが見つかりません。|  
+|al1020|含まれているアセンブリ 'file' を無視します<br /><br /> 指定した入力ファイルにアセンブリが含まれています。 アセンブリを含むファイルを Al.exe 入力ファイルとして指定することはできません。|  
+|al1021|'設定' : 今までの設定をオーバーライドしています<br /><br /> モジュールには、カスタム属性によって割り当てられた可能性のある特定の設定について値が指定されていましたが、Al.exe コマンド ライン オプションを使用して渡された値によって、この値がオーバーライドされました。|  
+|al1022|埋め込みリソース 'file' の読み込みエラーです — 理由<br /><br /> Al.exe に渡されたファイルを読み取ることができません、 **/embedresource**オプションの指定した理由。|  
+|al1023|リソース 'file' の埋め込みエラーです — 理由<br /><br /> メッセージに示された原因により、オペレーティング システムがアセンブリにリソース ファイルを埋め込めません。|  
+|al1025|ComType レコード 'record' は無効なファイル レコード 'record' を指しています<br /><br /> 入力モジュール内のメタデータが無効です。 モジュールを作成したツールを修復する必要があります。|  
+|al1026|指定されたバージョン 'version' は無効です<br /><br /> 情報を参照してください、 **/version**適しています。 有効な形式です。|  
+|al1028|キー ファイル 'file' は署名に必要な秘密キーがありません<br /><br /> 渡された公開キーのみを含むキー ファイルが、 **/keyfile**オプション。 使用して、[厳密名ツール (Sn.exe)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)の次のコマンドに示すように両方をパブリックとプライベート キーを持つファイルを生成します。<br /><br /> `sn -k keypair.snk.`|  
+|al1029|キーのコンテナー名 'container' は存在しません<br /><br /> 渡される値、 **/keyname**オプションが有効なコンテナーではありません。 使用して、[厳密名ツール (Sn.exe)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)コンテナーを作成します。|  
+|al1030|適切な暗号サービスが正しくインストールされていないか、適切なキー プロバイダーがありません<br /><br /> 多くの場合は、オペレーティング システムを再インストールするか、キーの作成に使用した暗号ユーティリティをインストールする必要があります。|  
+|al1031|アイコン 'file' を読み込み中にエラーが発生しました— 理由<br /><br /> Al.exe に渡されたファイルを読み取ることができません、 **/win32icon**オプションの指定した理由|  
+|al1032|'file' のリソースを生成中にエラーが発生しました — 理由<br /><br /> ディスク容量の不足またはその他のエラーが原因でファイルを作成できません。 指定すると、このエラーが発生した、 **/win32icon** (ファイルを生成する .ico) をオプションかを指定しない、 **/win32res**オプション (リソースの情報を持つファイルが生成されます)。<br /><br /> ファイル生成に関するこの問題を解決できない場合は使用**/win32res**バージョンが含まれてまたはビットマップ (アイコン) 情報ファイルを指定します。|  
+|al1033|アセンブリ カスタム属性 'attribute' が異なる値で複数回指定されました<br /><br /> Al.exe に対する入力ファイルとして指定されたソース モジュール内で、同じカスタム属性が&2; 回使用されており、それぞれに異なる値が渡されています。|  
+|al1034|アセンブリ 'file' のコピーおよび名前の変更はできません<br /><br /> 入力ファイルの指定やコピーを実行できる Al.exe 構文を使用しているときに、名前の競合が発生し、コンパイラが停止しました。 たとえば、`input.dll,somename.dll /out:somename.dll` と指定すると、このエラーが発生します。|  
+|al1035|ライブラリはエントリ ポイントを持てません<br /><br /> 両方を指定することはできません、 **/target:lib**オプション (既定) および**/main**オプション。|  
+|al1036|実行可能アプリケーションにエントリ ポイントが必要です<br /><br /> 使用する場合、 **/target:exe**または**/target:win**オプションも指定してください、 **/main**オプション。|  
+|al1037|エントリ ポイント メソッド 'main' が見つかりません<br /><br /> Al.exe が見つけられない、`Main`メソッドで指定された場所に、 **/main**オプション。|  
+|al1039|グローバル アセンブリ キャッシュ マネージャーの初期化に失敗しました — 理由<br /><br /> Visual Studio または [!INCLUDE[winsdkshort](../../../includes/winsdkshort-md.md)] を再インストールしてください。|  
+|al1040|キャッシュにアセンブリをインストールできませんでした — 理由<br /><br /> キャッシュにインストールできるのは署名されたアセンブリだけです。 参照してください[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)の詳細。|  
+|al1041|'method' : 署名または表示が正しくないか、ジェネリックであるため、エントリ ポイントになれません。<br /><br /> メソッドが指定されました、 **/main**オプション、メソッドは静的ではありませんが、返さない`int`または`void`、ジェネリックであったか、引数が無効です。|  
+|al1042|'exe': EXE を追加モジュールにすることはできません<br /><br /> アセンブリを含まない .exe ファイルが、Al.exe への入力ファイルとして指定されました。 Al.exe で入力ファイルとして指定できるのは、アセンブリを含まない .dll ファイルだけです。|  
+|al1043|マニフェスト ファイル名 'name' をモジュール名と同じにすることはできません<br /><br /> 指定した名前、 **/out**オプションは、Al.exe に対する入力として指定されているファイル名のいずれかと同じにすることはできません。|  
+|al1044|キー ファイル 'file' の読み込み中にエラーが発生しました -- 理由<br /><br /> 開いているかを指定したファイルから読み取っているときにエラーが発生しました**/keyfile**または<xref:System.Reflection.AssemblyKeyFileAttribute>します。|  
+|al1045|ファイル名 'file' が長すぎるか無効です<br /><br /> 260 文字より長いファイル名が Al.exe に渡されました。 それよりも文字数の少ないファイル名または短いパスを選択するか、ファイルの名前を変更してください。|  
+|al1046|リソース識別子 'ID' はアセンブリで既に使用されています<br /><br /> 埋め込まれたかリンクされた&2; つのリソースの ID または名前 (2 番目の引数) が同じです。 競合するリソースのうちのいずれか&1; つを削除するか、名前を変更してください。|  
+|al1047|ファイル 'file' のインポート中にエラーが発生しました — 理由 <br /><br /> メッセージに示された原因により、モジュール ファイルを開くことができません。|  
+|al1048|アセンブリ 'assembly' のモジュール 'module' のインポート中にエラーが発生しました -- 理由<br /><br /> マルチファイル アセンブリの非マニフェスト ファイルを開いているときにエラーが発生しました。 このエラーは、Al.exe によって直接は出力されませんが、プログラムによって、Al.exe を使用するプロセスに渡すことができます。|  
+|al1049|2000 年 1 月 1 日以前のビルドとリビジョン バージョン番号は自動生成できません。<br /><br /> コンピューターのシステム時計が 2000 年 1 月 1 日よりも前の日付に設定されています。|  
+|al1050|使用している機能 'old feature' は現在サポートされていません。'new feature' を代わりに使用してください。<br /><br /> Al.exe によって以前にサポートされていた機能がサポートされなくなっています。 代わりとして推奨されている機能を使用してください。|  
+|al1051|'attribute' 属性を作成時にエラーが発生しました — 理由<br /><br /> メッセージに示された原因により、アセンブリのカスタム属性が処理されませんでした。|  
+|al1052|ファイル 'filename' はアセンブリではありません<br /><br /> 指定されたファイル**/template**アセンブリ メタデータを含める必要があります。 このエラーは指定されたファイルを示します**/template**アセンブリが含まれていませんでした。|  
+|al1053|'option' に指定されたバージョン 'version' は正常な 'major.minor.build.revision' フォーマットではありません<br /><br /> Al.exe で指定されたバージョンの形式が間違っている情報の検出、 **/fileversion**または**/productversion**オプション。|  
+|al1054|'option' に指定されたバージョン 'version' は正常な 'major.minor.build.revision' フォーマットではありません<br /><br /> Al.exe で指定されたバージョンの形式が間違っている情報の検出、 <xref:System.Resources.SatelliteContractVersionAttribute>します。|  
+|al1055|参照されたアセンブリ 'filename' は厳密な名前を持っていません<br /><br /> このエラーは、厳密な名前を持つアセンブリを作成するときに、厳密な名前を持たないアセンブリを参照した場合に発生します。 これを解決するには、厳密な名前でアセンブリを再生成か sn.exe を使用してアセンブリに厳密な名前を追加 (ドキュメントを参照して[sn.exe](../../../docs/framework/tools/sn-exe-strong-name-tool.md))。<br /><br /> このエラーは、一般的には COM モジュールへの参照を Visual Studio IDE を介して C# プロジェクトに追加するときなど、ラッパー アセンブリを介して COM オブジェクトを使用しているときに発生します。 このエラーを回避するために、プロジェクト プロパティ "Wrapper Assembly Key File/Name" で COM ラッパー アセンブリに対して厳密な名前のキー ファイルを指定できます。<br /><br /> Tlbimp を介してラッパー アセンブリを作成する場合を参照してください、 [tlbimp](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)をラッパー アセンブリに厳密な名前を割り当てる方法についてはドキュメントです。<br /><br /> アセンブリが厳密な名前を持つ場合、そのアセンブリはグローバル アセンブリ キャッシュにインストールできます。 したがって、参照されるアセンブリもグローバル アセンブリ キャッシュに格納する必要があります。 グローバル アセンブリ キャッシュには、厳密な名前を持つアセンブしか格納できません。|  
+|al1056|参照されたアセンブリ 'filename' はローカライズされたサテライト アセンブリです<br /><br /> 使用して作成されたアセンブリ、 <xref:System.Reflection.AssemblyCultureAttribute>属性は、現在のアセンブリの作成で参照されています。 <xref:System.Reflection.AssemblyCultureAttribute>属性は、ファイルはローカライズされたサテライト アセンブリとサテライト アセンブリの参照が適切ではないことを示します。 多くの場合、代わりにメインの親アセンブリを参照する必要があります。|  
+|al1057|実行可能ファイルはローカライズできません。カルチャは常に空でなければなりません<br /><br /> 使用して、アセンブリが作成される**/target:exe**が**カルチャ/**が指定されました。 .exe 内のアセンブリには、Culture フィールド内の情報を含むことができません。|  
+|al1058|'file' はアセンブリです。モジュールとして追加することはできません<br /><br /> C++ のコンパイルで**/assemblymodule** (リンカー オプション) には、アセンブリを含むファイルが渡されました。|  
+|al1059|不明なエラー (コード)<br /><br /> Al.exe が不明なエラー コード (`code`) を受け取りました。<br /><br /> 解決策として次の方法が挙げられます。<br /><br /> Visual Studio を再インストールしてください。<br /><br /> [!INCLUDE[winsdkshort](../../../includes/winsdkshort-md.md)] を再インストールします。<br /><br /> ファイルが不足していないかどうかを確認します。<br /><br /> 十分なディスク容量があるかどうかを確認します。<br /><br /> 十分なメモリがあるかどうかを確認します。<br /><br /> 同じファイルにアクセスしている可能性のある他のプロセスを停止します。<br /><br /> コンピューターを再起動します。|  
+|al1060|ハッシュを作成中に暗号化に失敗しました — 理由<br /><br /> マルチファイルのアセンブリのファイル ハッシュを作成中にエラーが発生しました。|  
+|al1061|'reason' のため、オプション 'option' を設定できません<br /><br /> メッセージに示された理由により、このオプションに指定された値は無効です。|  
+|al1062|モジュール 'module' が複数回指定されました。指定できるのは&1; 回だけです<br /><br /> この警告は、コマンド ラインで同じソース ファイル、入力ファイル、またはモジュール ファイルを複数回指定した場合に発生します。 ファイル名は&1; 回だけ指定してください。|  
+|al1063|パブリック型 'type' がこのアセンブリ内の複数の場所で定義されています: 'file1' および 'file2'<br /><br /> アセンブリ内の複数のモジュールで、同じ型が見つかりました。 それぞれの型では、1 つのバージョンのみがアセンブリに存在できます。|  
+|al1064|複数の /bugreport オプションを指定することはできません<br /><br /> 1 つだけ**/bugreport**オプションを使用します。|  
+|al1065|ファイル名 'File Name' が長すぎるか無効です<br /><br /> 指定されたファイル名が許可される最大値を超えています。|  
+|al1066|文字 'character' は、コマンド ラインまたは応答ファイルに許可されていません<br /><br /> コマンド ラインまたはファイル内に、無効な文字が見つかりました。|  
+|al1067|'filename' はテキスト ファイルではなく、バイナリ ファイルです<br /><br /> ファイルはテキストではなく、バイナリ形式です。|  
+|al1068|モジュール 'ModuleName' はこのアセンブリ内で既に定義されています。 リンクされた各リソースおよびモジュールには一意のファイル名を指定しなければなりません。<br /><br /> モジュールが、このアセンブリに複数回現れています。|  
+|al1069|同じ短いファイル名を使用している長いファイル名が既に存在するとき、短いファイル名 'filename' を作成することはできません<br /><br /> 現在のファイルには、既に存在するファイル名の短いバージョンの名前が付いています。 たとえば、LongFileName.cs をコンパイルしてから LongFi~1.cs という名前で再コンパイルすると、これに似たコンパイラ エラーが発生します。 名前が長いコンパイラ出力ファイルが削除されても、類似のリンカー ファイルが残っていると、このエラーが発生することがあります。|  
+|al1070|agnostic なアセンブリにプロセッサ固有モジュール 'Module Name' を指定することはできません<br /><br /> 使用して構築する場合は**/platform:agnostic** (を指定しないまたは**/platform**)、モジュールを追加しようとする場合、エラーが生成されます (を使用して**/addmodule**) agnostic ではないです。 これは、i386 obj ファイルから ia64 obj ファイルにリンクを試みているのに似ています。<br /><br /> agnostic でないモジュールの主なソースは C++ です。 使用している場合は、 **/addmodule** C++ モジュールでは、ビルド スクリプトを適切な指定を変更する必要があります**/platform**設定します。|  
+|al1072|アセンブリとモジュール 'Module Name' は、異なるプロセッサを対象にすることはできません<br /><br /> 異なるプロセッサを対象とするアセンブリとモジュールをリンクすることはできません。結果は&1; つのプロセッサで実行する必要があります。|  
+|al1073|参照アセンブリ 'assembly' は異なるプロセッサを対象にしています<br /><br /> 異なるプロセッサを対象とする複数のアセンブリをリンクすることはできません。結果は&1; つのプロセッサで実行する必要があります。|  
+|al1074|'File Name' に格納されているモジュール名 'Module Name' は、そのファイル名と一致していなければなりません<br /><br /> これは、リンカーで必要とされる条件です。 この問題を解決するには、2 つの名前が一致するようにします。|  
+|al1075|遅延署名が要求されましたが、キーが指定されませんでした<br /><br /> アセンブリを遅延署名に設定すると、コンパイラは署名の計算も格納も行いませんが、後で署名を追加できるようにファイルに領域を確保します。<br /><br /> たとえばを使用して**/delaysign +**により、テスト時にアセンブリをグローバル キャッシュに格納します。 テスト後に、アセンブリ リンカー ユーティリティを使用してアセンブリに秘密キーを追加することにより、そのアセンブリに完全署名できます。|  
+|al1076|型 'type' は複数のアセンブリに転送されています: 'assembly' および 'assembly'<br /><br /> 型は&1; つのアセンブリにのみ転送できます。|  
+|al1077|パブリック型 'type' は 'assembly' で定義され、'assembly' に転送されています。<br /><br /> 生成するアセンブリに重複するパブリック型があります。 1 つが有効な型定義で、その他は型フォワーダーです。|  
+  
+## <a name="example"></a>例  
+ `t2a.exe` モジュールからアセンブリを含む実行可能ファイル `t2.netmodule` を作成するコマンドを次に示します。 エントリ ポイントは、`Main` 内の `MyClass` メソッドです。  
+  
+```  
+al t2.netmodule /target:exe /out:t2a.exe /main:MyClass.Main  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Sn.exe (厳密名ツール)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [Gacutil.exe (グローバル アセンブリ キャッシュ ツール)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)   
+ [アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md b/docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md
new file mode 100644
index 00000000000..59d60568f9f
--- /dev/null
+++ b/docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md
@@ -0,0 +1,94 @@
+---
+title: "Aximp.exe (Windows フォーム ActiveX コントロール インポーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ActiveX コントロール インポーター"
+  - "ActiveX コントロール, ホスト (Windows フォームで)"
+  - "Aximp.exe"
+  - "型定義, 変換"
+  - "Windows フォーム ActiveX コントロール インポーター"
+ms.assetid: 482c0d83-7144-4497-b626-87d2351b78d0
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Aximp.exe (Windows フォーム ActiveX コントロール インポーター)
+ActiveX コントロール インポーターは、ActiveX コントロール用の COM タイプ ライブラリに属する型定義を Windows フォーム コントロールに変換します。  
+  
+ Windows フォームがホストできるのは、<xref:System.Windows.Forms.Control> から派生するクラスである Windows フォームのコントロールだけです。  Aximp.exe は Windows フォーム上でホストできる ActiveX コントロール用のラッパー クラスを生成します。  このため、他の Windows フォーム コントロールに適用できるのと同じデザイン時サポートとプログラミング手順を使用できます。  
+  
+ ActiveX コントロールをホストするには、<xref:System.Windows.Forms.AxHost> から派生するラッパー コントロールを生成する必要があります。  ラッパー コントロールには、基になる ActiveX コントロールのインスタンスが 1 つ含まれます。  このインスタンスは、ActiveX コントロールとの通信方法を認識しますが、Windows フォーム コントロールとして表示されます。  生成されたコントロールは、ActiveX コントロールをホストし、そのプロパティ、メソッド、およびイベントを、生成されたコントロールのプロパティ、メソッド、およびイベントとして公開します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+aximp [options]{file.dll | file.ocx}  
+```  
+  
+## 解説  
+  
+|引数|説明|  
+|--------|--------|  
+|*file*|変換する ActiveX コントロールを含むソース ファイルの名前。  引数 file の拡張子は .dll または .ocx であることが必要です。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/delaysign`|Aximp.exe が遅延署名を使用して、生成されたコントロールに名前を割り当てるように指定します。  このオプションは、`/keycontainer:`、`/keyfile:`、または `/publickey:` のいずれかのオプションと共に指定する必要があります。  遅延署名プロセスの詳細については、「[アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)」を参照してください。|  
+|`/help`|このツールのコマンド構文とオプションを表示します。|  
+|`/keycontainer:` *containerName*|*containerName* で指定されたキー コンテナーの公開キーと秘密キーのペアを使用して、生成されたコントロールに厳密な名前で署名します。|  
+|`/keyfile:` *filename*|*filename* にある発行者の正式な公開キーと秘密キーのペアを使用して、生成されたコントロールに厳密な名前で署名します。|  
+|`/nologo`|Microsoft 著作権情報を表示しません。|  
+|`/out:` *filename*|作成するアセンブリの名前を指定します。|  
+|`/publickey:` *filename*|*filename* で指定されたファイルの公開キーを使用して、生成されたコントロールに厳密な名前で署名します。|  
+|`/rcw:` *filename*|新しいものを生成する代わりに、指定したランタイム呼び出し可能ラッパーを使用します。  複数のインスタンスを指定できます。  現在のディレクトリは相対パスに使用されます。  詳細については、「[ランタイム呼び出し可能ラッパー](../../../docs/framework/interop/runtime-callable-wrapper.md)」を参照してください。|  
+|`/silent`|成功メッセージを表示しません。|  
+|`/source`|Windows フォーム ラッパーの C\# ソース コードを生成します。|  
+|`/verbose`|詳細出力モードを指定します。進行状況に関する追加情報が表示されます。|  
+|`/?`|このツールのコマンド構文とオプションを表示します。|  
+  
+ Aximp.exe は、ActiveX コントロール タイプ ライブラリの全体を一度に変換し、元のタイプ ライブラリの中で定義されていたタイプのための共通言語ランタイム メタデータとコントロール実装を含む、アセンブリのセットを生成します。  生成されるファイルには、次のパターンに従って名前が付けられます。  
+  
+ COM タイプ用の共通言語ランタイム プロキシ : *progid*.dll  
+  
+ ActiveX コントロール用の Windows フォーム プロキシ \(Ax は ActiveX を表します\): Ax*progid*.dll  
+  
+> [!NOTE]
+>  ActiveX コントロールのメンバーの名前が .NET Framework で定義された名前と一致する場合、Aximp.exe は、AxHost 派生クラスを作成するときにメンバー名の前に "Ctl" を付けます。  たとえば、ActiveX コントロールに "Layout" というメンバーが含まれている場合、.NET Framework 内で Layout イベントが定義されているため、メンバー名は、AxHost 派生クラスでは "CtlLayout" に変更されます。  
+  
+ これらの生成されたファイルは、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) などのツールでチェックできます。  
+  
+ Aximp.exe を使用して ActiveX WebBrowser コントロール \(shdocvw.dll\) 用の .NET アセンブリを生成する方法はサポートされていません。  
+  
+ shdocvw.dll に対して Aximp.exe を実行すると、ツールが実行されるディレクトリに shdocvw.dll という名前の別のファイルが常に作成されます。  この生成されたファイルが Documents ディレクトリおよび Settings ディレクトリに置かれると、Microsoft Internet Explorer や Windows エクスプローラーに対して問題を引き起こします。  コンピューターを再起動すると、Windows は shdocvw.dll のコピーを見つけるために、system32 ディレクトリの前に Documents and Settings ディレクトリを調べます。  Windows は Documents and Settings で見つけたコピーを使用して、マネージ ラッパーを読み込もうとします。  Internet Explorer と Windows エクスプローラーは、system32 ディレクトリにある shdocvw.dll のバージョンのレンダリング エンジンに依存しているため、正しく機能しません。  このような問題が発生したら、Documents ディレクトリおよび Settings ディレクトリにある shdocvw.dll を削除して、コンピューターを再起動します。  
+  
+ shdocvw.dll で Aximp.exe を使用して、アプリケーション開発で使用する .NET アセンブリを作成する場合にも、問題が発生する可能性があります。  この場合、アプリケーションは、システム バージョンと生成されたバージョンの両方の shdocvw.dll を読み込み、システム バージョンを優先します。  このとき、WebBrowser ActiveX コントロール内部の Web ページを読み込もうとすると、\[開いて保存\] ダイアログ ボックスが表示される場合があります。  ユーザーが **\[開く\]** をクリックすると、Internet Explorer で Web ページが開きます。  これは、Internet Explorer version 6 以前を実行しているコンピューターでのみ発生します。  この問題の発生を防ぐには、「[方法: タイプ ライブラリへの参照を追加する](../../../docs/framework/interop/how-to-add-references-to-type-libraries.md)」に説明されているように、マネージ <xref:System.Windows.Forms.WebBrowser> コントロールまたは [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用してマネージ shdocvw.dll を生成します。  
+  
+## 使用例  
+ Media Player コントロール `msdxm.ocx` の MediaPlayer.dll と AxMediaPlayer.dll を生成するコマンドを次に示します。  
+  
+```  
+aximp c:\systemroot\system32\msdxm.ocx  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)
\ No newline at end of file
diff --git a/docs/framework/tools/caspol-exe-code-access-security-policy-tool.md b/docs/framework/tools/caspol-exe-code-access-security-policy-tool.md
new file mode 100644
index 00000000000..1ed6591114f
--- /dev/null
+++ b/docs/framework/tools/caspol-exe-code-access-security-policy-tool.md
@@ -0,0 +1,262 @@
+---
+title: "Caspol.exe (コード アクセス セキュリティ ポリシー ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション開発 [.NET Framework], セキュリティ"
+  - "Caspol.exe"
+  - "コード アクセス セキュリティ ポリシー ツール"
+  - "コード グループ, 変更 (セキュリティ ポリシーを)"
+  - "エンタープライズ セキュリティ ポリシー"
+  - "コンピューター セキュリティ ポリシー"
+  - "手動による編集 (セキュリティ構成ファイルの)"
+  - "アクセス許可セット, 変更 (セキュリティ ポリシーを)"
+  - "参照 (コード グループとアクセス許可セットの)"
+  - "セキュリティ ポリシー [.NET Framework], コード アクセス セキュリティ ポリシー ツール"
+  - "セキュリティ ポリシー [.NET Framework], 変更"
+  - "ユーザー セキュリティ ポリシー"
+ms.assetid: d2bf6123-7b0c-4e60-87ad-a39a1c3eb2e0
+caps.latest.revision: 44
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 43
+---
+# Caspol.exe (コード アクセス セキュリティ ポリシー ツール)
+ユーザーと管理者は、コード アクセス セキュリティ \(CAS\) ポリシー ツール \(Caspol.exe\) を使用して、コンピューター ポリシー レベル、ユーザー ポリシー レベル、およびエンタープライズ ポリシー レベルのセキュリティ ポリシーを変更できます。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、[\<legacyCasPolicy\> 要素が](../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)`true` に設定されていない限り、Caspol.exe は CAS ポリシーに影響を与えません。  CasPol.exe によって表示または変更された設定は、CAS ポリシーの使用が選択されているアプリケーションにのみ影響します。  詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+> [!NOTE]
+>  64 ビット コンピューターには、64 ビット バージョンと 32 ビット バージョンの両方のセキュリティ ポリシーが含まれます。  32 ビット アプリケーションと 64 ビット アプリケーションの両方にポリシーの変更を適用するには、Caspol.exe の 32 ビット バージョンと 64 ビット バージョンの両方を実行します。  
+  
+ コード アクセス セキュリティ ポリシー ツールは、.NET Framework および Visual Studio と共に自動的にインストールされます。  Caspol.exe は、32 ビット システムでは %windir%\\Microsoft.NET\\Framework\\*version* に、64 ビット システムでは %windir%\\Microsoft.NET\\Framework64\\*version* にあります。\(たとえば、場所は、64 ビット システムの .NET Framework 4 では %windir%\\Microsoft.NET\\Framework64\\v4.030319\\caspol.exe\)。コンピューターで複数のバージョンの .NET Framework を side\-by\-side で実行している場合は、複数のバージョンのツールがインストールされると考えられます。  インストール ディレクトリからツールを実行できます。  ただし、インストール フォルダーに移動する必要のない [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md) を使用することをお勧めします。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+caspol [options]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\-addfulltrust** *assembly\_file*<br /><br /> または<br /><br /> **\-af** *assembly\_file*|カスタム セキュリティ オブジェクト \(カスタム アクセス許可またはカスタム メンバーシップ条件\) を実装するアセンブリを、特定のポリシー レベルの完全信頼アセンブリの一覧に追加します。  引数 *assembly\_file* は、追加するアセンブリを指定します。  このファイルは、[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)で署名する必要があります。  アセンブリに厳密な名前で署名するには、[厳密名ツール \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md) を使用します。<br /><br /> カスタム アクセス許可を含むアクセス許可セットをポリシーに追加するたびに、そのカスタム アクセス許可を実装するアセンブリを、該当するポリシー レベルの完全信頼一覧に追加する必要があります。  セキュリティ ポリシー \(コンピューター ポリシーなど\) の中で使用されるカスタム セキュリティ オブジェクト \(カスタム コード グループやメンバーシップ条件など\) を実装するすべてのアセンブリを、完全信頼アセンブリの一覧に常に追加する必要があります。 **Caution:**  カスタム セキュリティ オブジェクトを実装するアセンブリが他のアセンブリを参照している場合は、参照先アセンブリを最初に完全信頼アセンブリの一覧に追加する必要があります。  Visual Basic、C\+\+、および JScript を使用して作成されたカスタム セキュリティ オブジェクトは、それぞれ Microsoft.VisualBasic.dll、Microsoft.VisualC.dll、Microsoft.JScript.dll をこの順で参照します。  これらのアセンブリは、既定では、完全な信頼を持つアセンブリのリストには含まれていません。  カスタム セキュリティ オブジェクトを追加する前に、適切なアセンブリを完全な信頼のリストに追加する必要があります。  これができない場合は、セキュリティ システムが壊れ、すべてのアセンブリの読み込みに失敗します。  この状況では、Caspol.exe **\-all \-reset** オプションを使用してもセキュリティを修復できません。  セキュリティを修復するには、セキュリティ ファイルを手動で編集し、カスタム セキュリティ オブジェクトを削除する必要があります。|  
+|**\-addgroup** {*parent\_label &#124; parent\_name*} *mship pset\_name* \[*flags*\]<br /><br /> または<br /><br /> **\-ag** {*parent\_label &#124; parent\_name*} *mship pset\_name* \[*flags*\]|新しいコード グループをコード グループ階層に追加します。  *parent\_label* または *parent\_name* を指定できます。  *parent\_label* 引数は、追加するコード グループの親となるコード グループのラベル \(1. や 1.1. など\) を指定します。  引数 *parent\_name* は、追加するコード グループの親となるコード グループの名前を指定します。  *parent\_label* と *parent\_name* は交換して使用できるため、Caspol.exe がこの 2 つを区別できる必要があります。  したがって、*parent\_name* の先頭を数字にすることはできません。  また、*parent\_name* に含めることができるのは、A\-Z、0\-9、およびアンダースコア文字だけです。<br /><br /> 引数 *mship* は、新しいコード グループのメンバーシップ条件を指定します。  詳細については、このセクションの *mship* 引数の表を参照してください。<br /><br /> 引数 *pset\_name* は、新しいコード グループと関連付けられるアクセス許可セットの名前です。  新しいグループに 1 つ以上の *flags* を設定することもできます。  詳細については、このセクションの *flags* 引数の表を参照してください。|  
+|**\-addpset** {*psfile* &#124; *psfile* p*set\_name*}<br /><br /> または<br /><br /> **\-ap** {*named*\_*psfile* &#124; *psfile* *pset\_name*}|新しい名前付きアクセス許可セットをポリシーに追加します。  アクセス許可セットは XML で編集し、.xml ファイルとして格納する必要があります。  XML ファイルにアクセス許可セットの名前が含まれる場合は、そのファイル \(*psfile*\) だけが指定されます。  XML ファイルにアクセス許可セットの名前が含まれない場合は、XML ファイルの名前 \(*psfile*\) とアクセス許可セットの名前 \(*pset\_name*\) を両方を指定する必要があります。<br /><br /> アクセス許可セットで使用するすべてのアクセス許可を、グローバル アセンブリ キャッシュ内にあるアセンブリに定義する必要があります。|  
+|**\-a**\[**ll**\]|このオプションの後に続くすべてのオプションを、コンピューター、ユーザー、エンタープライズの各ポリシーに適用します。  **\-all** オプションは、常に現在ログオンしているユーザーのポリシーを参照します。  現在のユーザー以外のユーザーのポリシーの参照方法については **\-customall** オプションを参照してください。|  
+|**\-chggroup** {*label &#124;name*} {*mship* &#124; *pset\_name* &#124;<br /><br /> *flags* `}`<br /><br /> または<br /><br /> **\-cg** {*label &#124;name*} {*mship* &#124; *pset\_name* &#124;<br /><br /> *flags* `}`|コード グループのメンバーシップ条件、アクセス許可セット、**exclusive**、**levelfinal**、**name**、**description** の各フラグの設定を変更します。  *label* または *name* を指定できます。  *label* 引数は、コード グループのラベル \(1.、1.1. など\) を指定します。  *name* 引数は、変更するコード グループの名前を指定します。  *label* と *name* は交換して使用できるため、Caspol.exe がこの 2 つを区別できる必要があります。  したがって、*name* の先頭を数字にすることはできません。  また、*name* に含めることができるのは、A\-Z、0\-9、およびアンダースコア文字だけです。<br /><br /> 引数 *pset\_name* は、コード グループと関連付けるアクセス許可セットの名前を指定します。  引数 *mship* および *flags* については、後の表を参照してください。|  
+|**\-chgpset**  *psfile pset\_name*<br /><br /> または<br /><br /> **\-cp** *psfile pset\_name*|名前付きアクセス許可セットを変更します。  引数 *psfile* は、アクセス許可セットの新しい定義を指定します。この定義はシリアル化された XML 形式のアクセス許可セット ファイルです。  引数 *pset\_name* は、変更するアクセス許可セットの名前を指定します。|  
+|**\-customall**  *path*<br /><br /> または<br /><br /> **\-ca**  *path*|このオプションの後に続くすべてのオプションを、コンピューター、エンタープライズ、指定したカスタム ユーザーの各ポリシーに適用します。  カスタム ユーザーのセキュリティ構成ファイルの位置を引数 *path* で指定する必要があります。|  
+|**\-cu**\[**stomuser**\] *path*|現在実行中の Caspol.exe を実行したユーザーに属さないカスタム ユーザー ポリシーを管理できます。  カスタム ユーザーのセキュリティ構成ファイルの位置を引数 *path* で指定する必要があります。|  
+|**\-enterprise**<br /><br /> または<br /><br /> **\-en**|このオプションの後に続くすべてのオプションを、エンタープライズ レベル ポリシーに適用します。  エンタープライズ管理者ではないユーザーは、エンタープライズ ポリシーを変更するための十分な権限を持ちませんが、参照はできます。  エンタープライズ以外の場合、既定では、このポリシーがコンピューター ポリシーやユーザー ポリシーに干渉することはありません。|  
+|**\-e**\[**xecution**\] {**on** &#124; **off**}|コードの実行が開始される前に実行許可を確認する機構のオンとオフを切り替えます。 **Note:**  このスイッチは、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降のバージョンでは削除されています。  詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。|  
+|**\-f**\[**orce**\]|ツールの自己破棄テストを行わず、ユーザーに指定されたとおりにポリシーを変更します。  通常、Caspol.exe は、ポリシーを変更した結果 Caspol.exe 自体の適切な動作が妨げられることにならないかどうかをチェックします。妨げられる場合は、Caspol.exe は変更されたポリシーを保存せず、エラー メッセージを表示します。  Caspol.exe が動作できなくなる場合でも強制的に Caspol.exe にポリシーを変更する場合は **–force** オプションを使用します。|  
+|**\-h**\[**elp**\]|Caspol.exe のコマンド構文とオプションを表示します。|  
+|**\-l**\[**ist**\]|指定されたコンピューター、ユーザー、エンタープライズ、またはすべてのポリシー レベルにかかわる、コード グループの階層とアクセス許可セットの一覧を表示します。  Caspol.exe は、最初にコード グループのラベルを、次に \(null でない場合\) 名前を表示します。|  
+|**\-listdescription**<br /><br /> または<br /><br /> **\-ld**|指定されたポリシー レベルのすべてのコード グループの説明を一覧表示します。|  
+|**\-listfulltrust**<br /><br /> または<br /><br /> **\-lf**|指定されたポリシー レベルの完全信頼アセンブリ一覧の内容を一覧表示します。|  
+|**\-listgroups**<br /><br /> または<br /><br /> **\-lg**|指定されたポリシー レベルまたはすべてのポリシー レベルのコード グループを表示します。  Caspol.exe は、最初にコード グループのラベルを、次に \(null でない場合\) 名前を表示します。|  
+|**\-listpset** または **\-lp**|指定されたポリシー レベルまたはすべてのポリシー レベルのアクセス許可セットを表示します。|  
+|**\-m**\[**achine**\]|このオプションの後に続くすべてのオプションをコンピューター レベル ポリシーに適用します。  管理者ではないユーザーは、コンピューター ポリシーを変更するための十分な権限を持ちませんが、参照はできます。  管理者の場合は、**\-machine** が既定値です。|  
+|**\-polchgprompt** {**on** &#124; **off**}<br /><br /> または<br /><br /> **\-pp** {**on** &#124; **off**}|ポリシーを変更するオプションを使用して、Caspol.exe が実行されるたびに表示されるプロンプトを有効または無効にします。|  
+|**\-quiet**<br /><br /> または<br /><br /> **\-q**|ポリシーを変更するオプションに対して通常表示されるプロンプトを一時的に無効にします。  グローバル変更プロンプトの設定は変更されません。  このオプションは、すべての Caspol.exe コマンドに対してプロンプトを無効にすることを避けるため、単一のコマンドに対してだけ使用してください。|  
+|**\-r**\[**ecover**\]|バックアップ ファイルからポリシーを復元します。  ポリシーが変更されるたびに、古いポリシーが Caspol.exe によってバックアップ ファイルの中に格納されます。|  
+|**\-remfulltrust** *assembly\_file*<br /><br /> または<br /><br /> **\-rf**  *assembly\_file*|ポリシー レベルの完全信頼一覧からアセンブリを削除します。  この操作を実行する必要があるのは、カスタム アクセス許可を含むアクセス許可セットがポリシーによって使用されなくなった場合です。  ただし、カスタム アクセス許可を実装するアセンブリを完全信頼一覧から削除するのは、そのアセンブリが、まだ使用されている他のカスタム アクセス許可を実装していない場合に限ります。  一覧からアセンブリを削除するときは、そのアセンブリが依存している他のすべてのアセンブリも削除する必要があります。|  
+|**\-remgroup** {*label &#124;name*}<br /><br /> または<br /><br /> **\-rg** {l*abel &#124; name*}|ラベルまたは名前で指定したコード グループを削除します。  指定したコード グループが子コード グループを持つ場合は、Caspol.exe によってすべての子コード グループも削除されます。|  
+|**\-rempset** *pset\_name*<br /><br /> または<br /><br /> **\-rp** *pset\_name*|指定したアクセス許可セットをポリシーから削除します。  引数 *pset\_name* は、削除するアクセス許可セットを指定します。  Caspol.exe がアクセス許可セットを削除するのは、そのアクセス許可セットがどのコード グループにも関連付けられていない場合だけです。  既定の \(組み込み\) アクセス許可セットは削除できません。|  
+|**\-reset**<br /><br /> または<br /><br /> **\-rs**|ポリシーを既定のステータスに戻し、ディスクに永続化します。  このオプションは、変更後のポリシーが修復できそうになく、インストール時点の既定値からやり直す場合に便利です。  特定のセキュリティ構成ファイルに対する変更の開始点として既定のポリシーを使用する場合にも、リセット オプションは便利です。  詳細については「[手動によるセキュリティ構成ファイルの編集](#cpgrfcodeaccesssecuritypolicyutilitycaspolexeanchor1)」を参照してください。|  
+|**\-resetlockdown**<br /><br /> または<br /><br /> **\-rsld**|ポリシーを既定の状態のより制限されたバージョンに戻してディスクに永続化します。前のコンピューター ポリシーのバックアップを作成し、`security.config.bac` というファイルに永続化します。ロック ダウンされているポリシーは、`Local Intranet`、`Trusted Sites`、および `Internet` の各ゾーンに属し、対応するコード グループに子コード グループがないコードにアクセスを許可しないことを除いて、既定のポリシーと同じです。|  
+|**\-resolvegroup** *assembly\_file*<br /><br /> または<br /><br /> **\-rsg**  *assembly\_file*|特定のアセンブリ \(*assembly\_file*\) が所属するコード グループを表示します。  既定では、このオプションは、アセンブリが属するコンピューター、ユーザー、エンタープライズの各ポリシー レベルを表示します。  1 つのポリシー レベルだけを参照するには、このオプションと共に **\-machine**、**\-user**、または **\-enterprise** のいずれかのオプションを使用します。|  
+|**\-resolveperm** *assembly\_file*<br /><br /> または<br /><br /> **\-rsp** *assembly\_file*|アセンブリの実行が許可されていた場合は、指定した \(または既定の\) レベルのセキュリティ ポリシーによってそのアセンブリに与えられるすべてのアクセス許可を表示します。  引数 *assembly\_file* はアセンブリを指定します。  **\-all** オプションを指定すると、Caspol.exe は、ユーザー ポリシー、コンピューター ポリシー、およびエンタープライズ ポリシーに基づいて、アセンブリに与えられるアクセス許可を計算します。それ以外の場合は、既定の動作規則が適用されます。|  
+|**\-s**\[**ecurity**\] {**on** &#124; **off**}|コード アクセス セキュリティのオンとオフを切り替えます。  **\-s off** オプションを指定しても、ロール ベース セキュリティは無効になりません。 **Note:**  このスイッチは、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降のバージョンでは削除されています。  詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。 **Caution:**  コード アクセス セキュリティを無効にすると、すべてのコード アクセス要求が成功します。  コード アクセス セキュリティを無効にすると、システムは、ウイルスやワームなどの悪意のあるコードの攻撃を受けやすくなります。  セキュリティをオフにすると、パフォーマンスは多少向上しますが、他のセキュリティ対策を講じて、システム セキュリティ全体が損なわれていないことを確認した場合にだけ、オフにしてください。  その他のセキュリティ対策の例としては、公衆ネットワークからの切断、コンピューターの物理的な保護などがあります。|  
+|**\-u**\[**ser**\]|このオプションの後に続くすべてのオプションを、Caspol.exe を実行したユーザーにかかわるユーザー レベル ポリシーに適用します。  管理者以外のユーザーの場合は、**\-user** が既定値です。|  
+|**\-?**|Caspol.exe のコマンド構文とオプションを表示します。|  
+  
+ コード グループのメンバーシップ条件を指定する引数 *mship* は、**\-addgroup** オプションおよび **\-chggroup** オプションと併用できます。  各引数 *mship* は .NET Framework クラスとして実装されます。  *mship* を指定するには、次のいずれかを使用します。  
+  
+|引数|説明|  
+|--------|--------|  
+|**\-allcode**|すべてのコードを指定します。  このメンバーシップ条件の詳細については、「[AllMembershipCondition クラス](frlrfSystemSecurityPolicyAllMembershipConditionClassTopic)」を参照してください。|  
+|**\-appdir**|アプリケーション ディレクトリを指定します。  メンバーシップ条件として **–appdir** を指定する場合は、コードの URL 証拠が、そのコードのアプリケーション ディレクトリ証拠と比較されます。  両方の証拠の値が同じである場合は、このメンバーシップ条件が成立します。  このメンバーシップ条件の詳細については、「[ApplicationDirectoryMembershipCondition クラス](frlrfSystemSecurityPolicyApplicationDirectoryMembershipConditionClassTopic)」を参照してください。|  
+|**\-custom**  *xmlfile*|カスタム メンバーシップ条件を追加します。  必須引数の *xmlfile* は、XML シリアル化したカスタム メンバーシップ条件を含む .xml ファイルを指定します。|  
+|**\-hash** *hashAlg* {**\-hex** *hashValue* &#124; **\-file** *assembly\_file* }|指定されたアセンブリ ハッシュを持つコードを指定します。  コード グループのメンバーシップ条件としてハッシュを使用するには、ハッシュ値またはアセンブリ ファイルを指定する必要があります。  このメンバーシップ条件の詳細については、「[HashMembershipCondition クラス](frlrfSystemSecurityPolicyHashMembershipConditionClassTopic)」を参照してください。|  
+|**\-pub** { **\-cert** *cert\_file\_name* &#124;<br /><br /> **\-file** *signed\_file\_name* &#124; **\-hex**  *hex\_string* }|指定されたソフトウェア発行者を持つコードを、証明書ファイル、ファイル上の署名、または X509 証明書の 16 進表示で指定します。  このメンバーシップ条件の詳細については、「[PublisherMembershipCondition クラス](frlrfSystemSecurityPolicyPublisherMembershipConditionClassTopic)」を参照してください。|  
+|**\-site** *website*|指定されたサイトがソースであるコードを指定します。  次のように記述します。<br /><br /> **\-site** www.proseware.com<br /><br /> このメンバーシップ条件の詳細については、「[SiteMembershipCondition クラス](frlrfSystemSecurityPolicySiteMembershipConditionClassTopic)」を参照してください。|  
+|**\-strong \-file** *file\_name* {*name* &#124; **\-noname**} {*version* &#124; **\-noversion**}|特定の厳密な名前を持つコードを、ファイル名、文字列としてのアセンブリ名、および *major*.*minor*.*build*.*revision* 形式のアセンブリ バージョンで指定します。  次のように記述します。<br /><br /> **\-strong \-file** myAssembly.exe myAssembly 1.2.3.4<br /><br /> このメンバーシップ条件の詳細については、「[StrongNameMembershipCondition クラス](frlrfSystemSecurityPolicyStrongNameMembershipConditionClassTopic)」を参照してください。|  
+|**\-url** *URL*|指定された URL をソースとするコードを指定します。  URL には、http:\/\/ や ftp:\/\/ などのプロトコルを含める必要があります。  さらに、ワイルドカード文字 \(\*\) を使用して、特定の URL から複数のアセンブリを指定できます。 **Note:**  複数の名前を使用して 1 つの URL を識別できるため、URL をメンバーシップ条件として使用する方法は、コードの識別情報を安全に確認できる方法ではありません。  できるだけ厳密な名前メンバーシップ条件、発行元メンバーシップ条件、またはハッシュ メンバーシップ条件を使用してください。 <br /><br /> このメンバーシップ条件の詳細については、「[UrlMembershipCondition クラス](frlrfSystemSecurityPolicyURLMembershipConditionClassTopic)」を参照してください。|  
+|**\-zone** *zonename*|指定されたゾーンがソースであるコードを指定します。  引数 *zonename* として、**MyComputer**、**Intranet**、**Trusted**、**Internet**、または **Untrusted** のいずれかの値を指定できます。  このメンバーシップ条件の詳細については、「<xref:System.Security.Policy.ZoneMembershipCondition> クラス」を参照してください。|  
+  
+ **–addgroup** オプションまたは **–chggroup** オプションと併用できる引数 *flags* は、次のいずれかの方法で指定します。  
+  
+|引数|説明|  
+|--------|--------|  
+|**\-description "** *description* **"**|**–addgroup** オプションと共に使用した場合、追加するコード グループの説明を指定します。  **–chggroup** オプションと共に使用した場合、編集するコード グループの説明を指定します。  引数 *description* を二重引用符で囲む必要があります。|  
+|**\-exclusive** {**on**&#124;**off**}|**on** に設定すると、コード グループのメンバーシップ条件になんらかのコードが適合する場合、追加または修正しているコード グループと関連付けられたアクセス許可セットだけが考慮されます。  このオプションを **off** に設定すると、ポリシー レベルの中で適合するすべてのコード グループのアクセス許可セットが Caspol.exe で考慮されます。|  
+|**\-levelfinal** {**on**&#124;**off**}|**on** に設定すると、追加または変更するコード グループが出現するレベルよりも下にあるポリシー レベルは考慮されなくなります。  通常、このオプションはコンピューター ポリシー レベルで使用されます。  たとえば、このフラグをコンピューター レベルでコード グループに設定し、なんらかのコードがこのコード グループのメンバーシップ条件に適合した場合、Caspol.exe はそのコードのユーザー レベル ポリシーの計算または適用を行いません。|  
+|**\-name "** *name* **"**|**–addgroup** オプションと共に使用した場合、追加するコード グループのスクリプト名を指定します。  **\-chggroup** オプションと共に使用した場合、編集するコード グループのスクリプト名を指定します。  引数 *name* を二重引用符で囲む必要があります。  引数 *name* には A\-Z、0\-9、およびアンダースコア文字だけを含めることができます。また、先頭には数字を使用できません。  コード グループは、数値のラベルではなくこの *name* によって参照できます。  *name* は、スクリプト目的で使用する場合にも便利です。|  
+  
+## 解説  
+ セキュリティ ポリシーは 3 種類のポリシー レベル、つまりコンピューター ポリシー、ユーザー ポリシー、エンタープライズ ポリシーによって表現されます。  アセンブリが受信するアクセス許可のセットは、これらの 3 種類のポリシー レベルで許可されるアクセス許可セットの積集合によって決定されます。  それぞれのポリシー レベルは、コード グループの階層で表現されます。  すべてのコード グループは、どのコードをそのグループのメンバーとするのかを決定するためのメンバーシップ条件を持ちます。  名前付きアクセス許可セットも、各コード グループと関連付けられます。  このアクセス許可セットは、メンバーシップ条件を満たすコードに対してランタイムから与えられるアクセス許可を指定します。  コード グループの階層、および関連する名前付きアクセス許可セットによって、各レベルのセキュリティ ポリシーの定義と保守が行われます。  **–user**、**\-customuser**、**–machine**、**\-enterprise** の各オプションを使用して、セキュリティ ポリシーのレベルを設定できます。  
+  
+ セキュリティ ポリシーの詳細、およびランタイムがコードに与えるアクセス許可を決定する方法については、「[セキュリティ ポリシーの管理](http://msdn.microsoft.com/ja-jp/d754e05d-29dc-4d3a-a2c2-95eaaf1b82b9)」を参照してください。  
+  
+## コード グループとアクセス許可セットの参照  
+ **\-list** オプションを使用すると、階層に属するコード グループを簡単に参照できるように、インデントされたコード グループの一覧とその数値ラベル \(1、1.1、1.1.1 など\) が表示されます。  コード グループを対象とするその他のコマンド ライン操作でも、特定のコード グループを参照するために数値ラベルが使用されます。  
+  
+ 名前付きアクセス許可セットを参照する場合は、名前を使用します。  **–list** オプションでは、最初にコード グループの一覧、次にそのポリシーの中で利用できる名前付きアクセス許可セットの一覧が表示されます。  
+  
+## Caspol.exe の動作  
+ **\-s**\[**ecurity**\] {**on** &#124;**off**} を除くすべてのオプションが、Caspol.exe と共にインストールされたバージョンの .NET Framework を使用します。  あるバージョンのランタイムと共にインストールされた Caspol.exe を実行する場合、変更内容はそのバージョンだけに適用されます。  その他のランタイムが共存する場合、それらのランタイムは影響を受けません。  特定のランタイム バージョンのディレクトリに切り替えずに Caspol.exe をコマンド ラインで実行する場合、Caspol.exe はパスに含まれる最初のランタイム バージョン \(通常は最後にインストールされたランタイム バージョン\) のディレクトリから実行されます。  
+  
+ **\-s**\[**ecurity**\] {**on** &#124;**off**} オプションは、コンピューター全体に対する操作です。  コード アクセス セキュリティをオフにすると、すべてのマネージ コードおよびコンピューター上のすべてのユーザーに対するセキュリティ チェックが中止されます。  side\-by\-side 実行バージョンの .NET Framework がインストールされている場合は、このコマンドによってコンピューターにインストールされているすべてのバージョンのセキュリティがオフになります。  **\-list** オプションを使用するとセキュリティがオフになっていることが示されますが、他のユーザーに対してセキュリティがオフになっていることが明確に示されることはありません。  
+  
+ 管理者の権限を持たないユーザーが Caspol.exe を実行する場合、**–machine** オプションが指定されていない限り、すべてのオプションはユーザー レベル ポリシーを参照します。  管理者が Caspol.exe を実行する場合、**–user** オプションが指定されていない限り、すべてのオプションはコンピューター ポリシーを参照します。  
+  
+ Caspol.exe が正しく機能するには、**Everything** アクセス許可セットと等価の許可を与えられている必要があります。  Caspol.exe には防御機構があるため、Caspol.exe が動作するために必要なアクセス許可を得られなくなるような方法でポリシーを変更することはできません。  変更を実行しようとすると、Caspol.exe は、要求されたポリシーの変更で Caspol.exe の実行が中断されること、およびポリシーの変更が拒否されることをユーザーに通知します。  特定のコマンドについてこの防御機構をオフにするには、**–force** オプションを使用します。  
+  
+<a name="cpgrfcodeaccesssecuritypolicyutilitycaspolexeanchor1"></a>   
+## 手動によるセキュリティ構成ファイルの編集  
+ 3 種類のセキュリティ構成ファイルは、Caspol.exe でサポートされる 3 種類のポリシー レベル、つまりコンピューター ポリシー、指定されたユーザーのポリシー、およびエンタープライズ ポリシーと対応します。  これらのファイルがディスク上に作成されるのは、コンピューター ポリシー、ユーザー ポリシー、またはエンタープライズ ポリシーが Caspol.exe によって変更される場合だけです。  必要な場合は、Caspol.exe の **–reset** オプションを使用して、既定のセキュリティ ポリシーをディスクに保存できます。  
+  
+ ほとんどの場合、手動によるセキュリティ構成ファイルの編集はお勧めしません。  ただし、これらのファイルを変更する必要が生じることもあります。たとえば、管理者が特定のユーザーについてセキュリティ設定を編集する場合などです。  
+  
+## 例  
+ **\-addfulltrust**  
+  
+ カスタム アクセス許可を含むアクセス許可セットがコンピューター ポリシーに追加されたものと見なします。  このカスタム アクセス許可は、`MyPerm.exe` と、`MyOther.exe` の `MyPerm.exe` 参照クラスに実装されます。  両方のアセンブリとも、完全信頼アセンブリ一覧に追加する必要があります。  `MyPerm.exe` アセンブリをコンピューター ポリシーの完全信頼一覧に追加するコマンドを次に示します。  
+  
+```  
+caspol -machine -addfulltrust MyPerm.exe  
+```  
+  
+ `MyOther.exe` アセンブリをコンピューター ポリシーの完全信頼一覧に追加するコマンドを次に示します。  
+  
+```  
+caspol -machine -addfulltrust MyOther.exe  
+```  
+  
+ **\-addgroup**  
+  
+ 子コード グループをコンピューター ポリシー コード グループ階層のルートに追加するコマンドを次に示します。  新しいコード グループは **Internet** ゾーンのメンバーであり、**Execution** アクセス許可セットと関連付けられます。  
+  
+```  
+caspol -machine -addgroup 1.  -zone Internet Execution  
+```  
+  
+ 共有 \\\\netserver\\netshare にローカル イントラネット アクセス許可を与える子コード グループを追加するコマンドを次に示します。  
+  
+```  
+caspol -machine -addgroup 1. -url \\netserver\netshare\* LocalIntranet  
+```  
+  
+ **\-addpset**  
+  
+ `Mypset` アクセス許可セットをユーザー ポリシーに追加するコマンドを次に示します。  
+  
+```  
+caspol -user -addpset Mypset.xml Mypset  
+```  
+  
+ **\-chggroup**  
+  
+ 1.2. というラベルの付いたコード グループのユーザー ポリシーに含まれるアクセス許可セットを **Execution** アクセス許可セットに変更するコマンドを次に示します。  
+  
+```  
+caspol -user -chggroup 1.2. Execution  
+```  
+  
+ 次のコマンドは、1.2.1. というラベルの付いたコード グループの既定のポリシーのメンバーシップ条件を変更し、**exclusive** フラグの設定を変更します。  メンバーシップ条件は、**Internet** ゾーンをソースとするコードとなるように定義され、**exclusive** フラグはオンになります。  
+  
+```  
+caspol -chggroup 1.2.1. -zone Internet -exclusive on  
+```  
+  
+ **\-chgpset**  
+  
+ `Mypset` という名前のアクセス許可セットを `newpset.xml` に含まれるアクセス許可セットに変更するコマンドを次に示します。  現在のリリースでは、コード グループ階層で使用されているアクセス許可の変更はサポートしていません。  
+  
+```  
+caspol -chgpset Mypset newpset.xml  
+```  
+  
+ **\-force**  
+  
+ ユーザー ポリシーのルート コード グループ \(ラベル 1\) を名前付きアクセス許可セット **Nothing** と関連付けるコマンドを次に示します。  このコマンドにより Caspol.exe は動作できなくなります。  
+  
+```  
+caspol -force -user -chggroup 1 Nothing  
+```  
+  
+ **\-recover**  
+  
+ 最後に保存されたコンピューター ポリシーを復元するコマンドを次に示します。  
+  
+```  
+caspol -machine -recover  
+```  
+  
+ **\-remgroup**  
+  
+ 1.1 というラベルの付いたコード グループを削除するコマンドを次に示します。  このコード グループが子コード グループを持つ場合は、子グループも削除されます。  
+  
+```  
+caspol -remgroup 1.1.  
+```  
+  
+ **\-rempset**  
+  
+ ユーザー ポリシーから **Execution** アクセス許可セットを削除するコマンドを次に示します。  
+  
+```  
+caspol -user -rempset Execution  
+```  
+  
+ `Mypset` をユーザー ポリシー レベルから削除するコマンドを次に示します。  
+  
+```  
+caspol -rempset MyPset  
+```  
+  
+ **\-resolvegroup**  
+  
+ `myassembly` が所属するコンピューター ポリシーのすべてのコード グループを表示するコマンドを次に示します。  
+  
+```  
+caspol -machine -resolvegroup myassembly  
+```  
+  
+ `myassembly` が所属するコンピューター ポリシー、エンタープライズ ポリシー、および指定されたカスタム ユーザー ポリシーのすべてのコード グループを表示するコマンドを次に示します。  
+  
+```  
+caspol -customall "c:\config_test\security.config" -resolvegroup myassembly  
+```  
+  
+ **\-resolveperm**  
+  
+ コンピューター ポリシー レベルとユーザー ポリシー レベルに基づいて `testassembly` のアクセス許可を計算するコマンドを次に示します。  
+  
+```  
+caspol -all -resolveperm testassembly  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md b/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md
new file mode 100644
index 00000000000..6ff539d8b9d
--- /dev/null
+++ b/docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md
@@ -0,0 +1,72 @@
+---
+title: "Cert2spc.exe (ソフトウェア発行元証明書テスト ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Cert2spc.exe"
+  - "証明書, ソフトウェア発行元の証明書"
+  - "ソフトウェア発行元証明書"
+  - "ソフトウェア発行元証明書テスト ツール"
+  - "SPC"
+ms.assetid: be434d7d-9c0d-46e7-8392-58a9b542d11d
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Cert2spc.exe (ソフトウェア発行元証明書テスト ツール)
+ソフトウェア発行元証明書テスト ツールは、1 つ以上の X.509 証明書からソフトウェア発行元証明書 \(SPC: Software Publisher's Certificate\) を作成します。  Cert2spc.exe はテスト専用のツールです。  有効な SPC は、VeriSign や Thawte などの証明書発行機関から入手できます。  X.509 証明書の作成の詳細については、「[Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md)」を参照してください。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+cert2spc cert1.cer | crl1.crl [... certN.cer | crlN.crl] outputSPCfile.spc  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|`certN.cer`|SPC ファイルに組み込む X.509 証明書の名前。  スペースで区切ることによって、複数の名前を指定できます。|  
+|`crlN.crl`|SPC ファイルに組み込む証明書失効リストの名前。  スペースで区切ることによって、複数の名前を指定できます。|  
+|`outputSPCfile.spc`|X.509 証明書が格納される PKCS \#7 オブジェクトの名前。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 例  
+ `myCertificate.cer` から SPC を作成し、`mySPCFile.spc` に格納するコマンドを次に示します。  
+  
+```  
+cert2spc myCertificate.cer mySPCFile.spc  
+```  
+  
+ `oneCertificate.cer` と `twoCertificate.cer` から SPC を作成し、`mySPCFile.spc` に格納するコマンドを次に示します。  
+  
+```  
+cert2spc oneCertificate.cer twoCertificate.cer mySPCFile.spc  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/certmgr-exe-certificate-manager-tool.md b/docs/framework/tools/certmgr-exe-certificate-manager-tool.md
new file mode 100644
index 00000000000..84138e7e49c
--- /dev/null
+++ b/docs/framework/tools/certmgr-exe-certificate-manager-tool.md
@@ -0,0 +1,149 @@
+---
+title: "Certmgr.exe (証明書マネージャー ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "証明書マネージャー ツール"
+  - "証明書失効リスト"
+  - "証明書信頼リスト"
+  - "証明書, 管理"
+  - "Certmgr.exe"
+  - "CRL"
+  - "CTL"
+ms.assetid: 7e953b43-1374-4bbc-814f-53ca1b6b52bb
+caps.latest.revision: 27
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# Certmgr.exe (証明書マネージャー ツール)
+証明書マネージャー ツール \(Certmgr.exe\) は、証明書、証明書信頼リスト \(CTL: Certificate Trust List\)、および証明書失効リスト \(CRL: Certificate Revocation List\) を管理します。  
+  
+ 証明書マネージャーは Visual Studio と共に自動的にインストールされます。  ツールを開始するには、[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md) を使用します。  
+  
+> [!NOTE]
+>  証明書マネージャー ツール \(Certmgr.exe\) はコマンド ライン ユーティリティですが、証明書 \(Certmgr.msc\) は Microsoft 管理コンソール \(MMC: Microsoft Management Console\) スナップインです。  通常、Certmgr.msc は Windows のシステム ディレクトリにあるので、コマンド ラインで「`certmgr`」と入力すると、Visual Studio コマンド プロンプトを開いていた場合でも証明書 MMC スナップインが読み込まれることがあります。  これは、PATH 環境変数で、スナップインのパスが証明書マネージャー ツールのパスよりも前に指定されているためです。  この問題が発生した場合は、実行可能ファイルのパスを指定して Certmgr.exe コマンドを実行できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ X.509 証明書の概要については、「[証明書の使用](../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+certmgr [/add | /del | /put] [options] [/s[/r registryLocation]] [sourceStorename] [/s[/r registryLocation]] [destinationStorename]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*sourceStorename*|追加、削除、保存、または表示する既存の証明書、CTL、または CRL を含む証明書ストア。  ストア ファイルまたはシステム ストアを指定できます。|  
+|*destinationStorename*|出力証明書ストアまたはファイル。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/add**|証明書、CTL、および CRL を証明書ストアに追加します。|  
+|**\/all**|**\/add** を指定して使用した場合は、すべてのエントリを追加します。  **\/del** を指定して使用した場合は、すべてのエントリを削除します。  **\/add**、**\/del** のいずれのオプションも指定せずに使用した場合は、すべてのエントリを表示します。  **\/all** オプションは、**\/put** オプションと共に指定できません。|  
+|**\/c**|**\/add** を指定して使用した場合は、証明書を追加します。  **\/del** を指定して使用した場合は、証明書を削除します。  **\/put** を指定して使用した場合は、証明書を保存します。  **\/add**、**\/del**、**\/put** のいずれのオプションも指定せずに使用した場合は、証明書を表示します。|  
+|**\/CRL**|**\/add** を指定して使用した場合は、CRL を追加します。  **\/del** を指定して使用した場合は、CRL を削除します。  **\/put** を指定して使用した場合は、CRL を保存します。  **\/add**、**\/del**、**\/put** のいずれのオプションも指定せずに使用した場合は、CRL を表示します。|  
+|**\/CTL**|**\/add** を指定して使用した場合は、CTL を追加します。  **\/del** を指定して使用した場合は、CTL を削除します。  **\/put** を指定して使用した場合は、CTL を保存します。  **\/add**、**\/del**、**\/put** のいずれのオプションも指定せずに使用した場合は、CTL を表示します。|  
+|**\/del**|証明書、CTL、および CRL を証明書ストアから削除します。|  
+|**\/e** *encodingType*|証明書のエンコード タイプを指定します。  既定値は、`X509_ASN_ENCODING` です。|  
+|**\/f** *dwFlags*|ストア オープン フラグを指定します。  これは **CertOpenStore** に渡される *dwFlags* パラメーターです。  既定値は CERT\_SYSTEM\_STORE\_CURRENT\_USER です。  このオプションは **\/y** オプションを使用した場合にだけ有効です。|  
+|**\/h**\[**elp**\]|このツールのコマンド構文とオプションを表示します。|  
+|**\/n** *nam*|追加、削除、または保存する証明書の共通名を指定します。  このオプションは証明書についてだけ使用できます。CTL または CRL については使用できません。|  
+|**\/put**|証明書ストアに含まれている X.509 証明書、CTL、または CRL をファイルに保存します。  ファイルは X.509 形式で保存されます。  **\/7** オプションを **\/put** オプションと一緒に使用すると、ファイルを PKCS \#7 形式で保存できます。  **\/put** オプションの後ろには、**\/c**、**\/CTL**、**\/CRL** のいずれかのオプションを指定する必要があります。  **\/all** オプションは、**\/put** オプションと共に指定できません。|  
+|**\/r** *location*|システム ストアのレジストリの位置を指定します。  このオプションは、**\/s** オプションを指定した場合にだけ有効です。  *location* には、次のいずれかを指定する必要があります。<br /><br /> -   証明書ストアが HKEY\_CURRENT\_USER キーに含まれる場合は `currentUser` を指定します。  既定値です。<br />-   証明書ストアが HKEY\_LOCAL\_MACHINE キーに含まれる場合は `localMachine` を指定します。|  
+|**\/s**|証明書ストアがシステム ストアであることを指定します。  このオプションを指定しない場合、ストアは **StoreFile** と見なされます。|  
+|**\/sha1** *sha1Hash*|追加、削除、または保存する証明書、CTL、または CRL の SHA1 ハッシュを指定します。|  
+|**\/v**|詳細出力モードを指定します。このモードでは、証明書、CTL、および CRL に関する詳細情報が表示されます。  このオプションは、**\/add**、**\/del**、または **\/put** のオプションと共に指定できません。|  
+|**\/y** *provider*|ストア プロバイダー名を指定します。|  
+|**\/7**|出力証明書ストアを PKCS \#7 オブジェクトとして保存します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ Certmgr.exe は次の基本的な機能を実行します。  
+  
+-   証明書、CTL、および CRL をコンソールに表示します。  
+  
+-   証明書、CTL、および CRL を証明書ストアに追加します。  
+  
+-   証明書、CTL、および CRL を証明書ストアから削除します。  
+  
+-   証明書ストアに含まれている X.509 証明書、CTL、または CRL をファイルに保存します。  
+  
+ Certmgr.exe は、**StoreFile** とシステム ストアという 2 つの種類の証明書ストアに対して機能します。  証明書ストアの種類を指定する必要はありません。Certmgr.exe がストアの種類を識別し、適切な操作を実行します。  
+  
+ オプションを何も指定せずに Certmgr.exe を実行すると、証明書の管理タスクの実行時に役立つ GUI を備えた certmgr.msc スナップインが起動します。これらのタスクはコマンド ラインでも実行できます。  この GUI には、証明書、CTL、および CRL をディスクから証明書ストアへとコピーする、インポート ウィザードが用意されています。  
+  
+ 次のコードをコンパイルおよび実行することによって、`sourceStorename` パラメーターおよび `destinationStorename` パラメーターについて X509Certificate ストアの名前を検索できます。  
+  
+ [!code-csharp[Tools.CertMgr#1](../../../samples/snippets/csharp/VS_Snippets_CLR/tools.certmgr/cs/storenames1.cs#1)]
+ [!code-vb[Tools.CertMgr#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/tools.certmgr/vb/storenames1.vb#1)]  
+  
+ 証明書の詳細については、「[証明書の使用](../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+## 例  
+ 既定のシステム ストアである `my` を詳細出力モードで表示するコマンドを次に示します。  
+  
+```  
+certmgr /v /s my  
+```  
+  
+ `myFile.ext` という名前のファイルに含まれるすべての証明書を `newFile.ext` という名前の新しいファイルに追加するコマンドを次に示します。  
+  
+```  
+certmgr /add /all /c myFile.ext newFile.ext  
+```  
+  
+ `testcert.cer` という名前のファイルに含まれる証明書をシステム ストア `my` に追加するコマンドを次に示します。  
+  
+```  
+certmgr /add /c testcert.cer /s my  
+```  
+  
+ `TrustedCert.cer` という名前のファイルに含まれる証明書をルート証明書ストアに追加するコマンドを次に示します。  
+  
+```  
+certmgr /c /add TrustedCert.cer /s root  
+```  
+  
+ システム ストア `my` に含まれていて共通名が `myCert` の証明書を `newCert.cer` という名前のファイルに保存するコマンドを次に示します。  
+  
+```  
+certmgr /add /c /n myCert /s my newCert.cer  
+```  
+  
+ システム ストア `my` に含まれるすべての CTL を削除し、その結果得られるストアを `newStore.str` という名前のファイルに格納するコマンドを次に示します。  
+  
+```  
+certmgr /del /all /ctl /s my newStore.str  
+```  
+  
+ システム ストア `my` に含まれる証明書をファイル `newFile` に保存するコマンドを次に示します。  `my` から `newFile` に保存する証明書の番号を入力するためのプロンプトが表示されます。  
+  
+```  
+certmgr /put /c /s my newFile  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/clrver-exe-clr-version-tool.md b/docs/framework/tools/clrver-exe-clr-version-tool.md
new file mode 100644
index 00000000000..022154b8501
--- /dev/null
+++ b/docs/framework/tools/clrver-exe-clr-version-tool.md
@@ -0,0 +1,72 @@
+---
+title: "Clrver.exe (CLR バージョン ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "CLR バージョン ツール"
+  - "Clrver.exe"
+ms.assetid: cbc2ee86-bdc8-4a65-a8f1-ba23bce3a699
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Clrver.exe (CLR バージョン ツール)
+CLR バージョン ツール \(Clrver.exe\) は、コンピューターにインストールされている共通言語ランタイム \(CLR: Common Language Runtime\) のすべてのバージョンを報告します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+clrver [option]  
+```  
+  
+## オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`-all`|CLR を使用しているコンピューター上のすべてのプロセスを表示します。|  
+|*pid*|指定したプロセス ID \(PID\) のプロセスで使用されている CLR のバージョンを表示します。|  
+|`-?`|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ オプションを指定せずに Clrver.exe を呼び出した場合、インストールされている CLR のすべてのバージョンが表示されます。  別のユーザーの PID を指定する場合、バージョン情報を取得するには、管理アクセス許可が必要です。  
+  
+> [!NOTE]
+>  Windows Vista 以降では、ユーザー アカウント制御 \(UAC: User Account Control\) でユーザーの権限が決定されます。  ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。  既定では、ユーザーは標準ユーザー ロールに所属します。  管理アクセス許可を必要とするコードを実行するには、最初に、ユーザーの権限を標準ユーザーから管理者に昇格させる必要があります。  この操作は、コマンド プロンプトの起動時にコマンド プロンプト アイコンを右クリックし、管理者として実行することを指定して行うことができます。  
+  
+ SYSTEM、LOCAL SERVICE、および NETWORK SERVICE の各プロセスの CLR バージョンを確認しようとすると、PID が存在しないことを示すメッセージが表示されます。  
+  
+## 例  
+ コンピューターにインストールされている CLR のすべてのバージョンを表示するコマンドを次に示します。  
+  
+ `clrver`  
+  
+ プロセス 128 で使用されている CLR のバージョンを表示するコマンドを次に示します。  
+  
+ `clrver 128`  
+  
+ すべてのマネージ プロセスとそれらのプロセスで使用されている CLR のバージョンを表示するコマンドを次に示します。  
+  
+ `Clrver -all`  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/corflags-exe-corflags-conversion-tool.md b/docs/framework/tools/corflags-exe-corflags-conversion-tool.md
new file mode 100644
index 00000000000..ea4a709c55e
--- /dev/null
+++ b/docs/framework/tools/corflags-exe-corflags-conversion-tool.md
@@ -0,0 +1,68 @@
+---
+title: "CorFlags.exe (CorFlags 変換ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "CorFlags 変換ツール"
+  - "CorFlags.exe"
+  - "移植可能な実行可能 (PE) ファイル, CorFlags セクション"
+ms.assetid: ef900f8f-71ca-4dde-9b8c-95ddb0d7d89c
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# CorFlags.exe (CorFlags 変換ツール)
+CorFlags 変換ツールを使用して、ポータブル実行可能 \(PE\) ファイル イメージのヘッダー内の CorFlags セクションを設定できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+CorFlags.exe assembly [options]  
+```  
+  
+#### パラメーター  
+  
+|必須パラメーター|説明|  
+|--------------|--------|  
+|`assembly`|CorFlags を設定するアセンブリの名前。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/32BIT\[REQ\]\+**|32BITREQUIRED フラグを設定します。|  
+|**\/32BIT\[REQ\]\-**|32BITREQUIRED フラグをクリアします。|  
+|**\/32BITPREF\+**|32BITPREFERRED フラグを設定します。  アプリは、64 ビット プラットフォーム上でも 32 ビット プロセスとして実行します。  このフラグは、EXE ファイルでのみ設定します。  このフラグを DLL で設定した場合、64 ビット プロセスで DLL を読み込むことができず、<xref:System.BadImageFormatException> 例外がスローされます。  このフラグを設定した EXE ファイルは、64 ビット プロセスで読み込むことができます。<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の新機能。|  
+|**\/32BITPREF\-**|32BITPREFERRED フラグをクリアします。<br /><br /> [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の新機能。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+|**\/Force**|厳密な名前が付けられているアセンブリであっても、強制的に更新します。 **Important:**  厳密な名前が付けられているアセンブリを更新する場合は、そのコードを実行する前に再署名する必要があります。|  
+|**\/help**|このツールのコマンド構文とオプションを表示します。|  
+|**\/ILONLY\+**|ILONLY フラグを設定します。|  
+|**\/ILONLY\-**|ILONLY フラグをクリアします。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/RevertCLRHeader**|CLR ヘッダー バージョンを 2.0 に戻します。|  
+|**\/UpgradeCLRHeader**|CLR ヘッダー バージョンを 2.5 にアップグレードします。 **Note:**  アセンブリをネイティブに実行するには、CLR ヘッダー バージョン 2.5 以降が必要です。|  
+  
+## 解説  
+ オプションが何も指定されていない場合、CorFlags 変換ツールは指定されているアセンブリのフラグを表示します。  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [64 ビット アプリケーション](../../../docs/framework/64-bit-apps.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/developer-command-prompt-for-vs.md b/docs/framework/tools/developer-command-prompt-for-vs.md
new file mode 100644
index 00000000000..bf1fd995f8d
--- /dev/null
+++ b/docs/framework/tools/developer-command-prompt-for-vs.md
@@ -0,0 +1,101 @@
+---
+title: "Visual Studio 用開発者コマンド プロンプト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コマンド プロンプト、Windows SDK"
+  - "Visual Studio コマンド プロンプト"
+  - "コマンド プロンプト、Visual Studio"
+  - "SDK のコマンド プロンプト"
+  - "ツール [.NET Framework]、環境変数の設定"
+  - "環境変数、ツールへの設定"
+  - "開発者コマンド プロンプト"
+ms.assetid: 94fcf524-9045-4993-bfb2-e2d8bad44219
+caps.latest.revision: 45
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 45
+---
+# Visual Studio 用開発者コマンド プロンプト
+Visual Studio の開発者コマンド プロンプトでは、.NET Framework ツールを使いやすくするための環境変数が自動的に設定されます。 開発者コマンド プロンプトは、完全版または Community Edition の Visual Studio でインストールされます。 Express バージョンの Visual Studio ではインストールされません。  
+  
+<a name="find"></a>   
+## コンピューター上でのコマンド プロンプトの検索  
+ Visual Studio のバージョンと、インストールした追加の SDK に応じて、複数のコマンド プロンプトが表示される場合があります。 たとえば、Visual Studio の 64 ビット バージョンには、32 ビットと 64 ビットのコマンド プロンプトが用意されています \(ほとんどのツールでは、32 ビット バージョンと 64 ビット バージョンに違いはありませんが、一部のツールでは、32 ビット環境と 64 ビット環境に固有の変更が加えられています\)。 次の手順でうまくいかない場合は、「[コンピューター上のファイルを手動で探す](#alternative)」または「[Visual Studio 内からコマンド プロンプトを実行する](#visualstudio)」を試してください。  
+  
+ **Windows 10 の場合**  
+  
+1.  キーボードの Windows ロゴ キー ![Windows のロゴ](../../../docs/framework/install/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**\[スタート\]** メニューを開きます。  
+  
+2.  **\[スタート\]** メニューで、「`dev`」と入力します。 これにより、検索パターンに一致する、インストールされているアプリの一覧が表示されます。 別のコマンド プロンプトを探す場合は、別の検索語句 \(「`prompt`」など\) を入力してください。  
+  
+3.  **\[開発者コマンド プロンプト\]** \(または、使用するコマンド プロンプト\) を選択します。  
+  
+ **Windows 8.1 の場合**  
+  
+1.  キーボードの Windows ロゴ キー ![Windows のロゴ](../../../docs/framework/install/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**\[スタート\]** 画面に移動します。  
+  
+2.  **\[スタート\]** 画面で、`CTRL + TAB` キーを押して **\[アプリ\]** 一覧を開き、「`V`」と入力します。 これにより、インストールされているすべての Visual Studio コマンド プロンプトが含まれた一覧が表示されます。  
+  
+3.  **\[開発者コマンド プロンプト\]** \(または、使用するコマンド プロンプト\) を選択します。  
+  
+ **Windows 8 の場合**  
+  
+1.  キーボードの Windows ロゴ キー ![Windows のロゴ](../../../docs/framework/install/media/windowskeyboardlogo.png "Windowskeyboardlogo") を押すなどして、**\[スタート\]** 画面に移動します。  
+  
+2.  **\[スタート\]** 画面で、Windows ロゴ キー ![Windows のロゴ](../../../docs/framework/install/media/windowskeyboardlogo.png "Windowskeyboardlogo") `+ Z` を押します。  
+  
+3.  画面下部にある**アプリ ビュー** アイコンを選択し、「`V`」と入力します。 これにより、インストールされているすべての Visual Studio コマンド プロンプトが含まれた一覧が表示されます。  
+  
+4.  **\[開発者コマンド プロンプト\]** \(または、使用するコマンド プロンプト\) を選択します。  
+  
+ **Windows 7 の場合**  
+  
+1.  **\[スタート\]** を選択し、**\[すべてのプログラム\]**、**\[Microsoft Visual Studio\]** の順に展開します。  
+  
+2.  インストールされている Visual Studio のバージョンに応じて、**\[Visual Studio ツール\]**、**\[Visual Studio コマンド プロンプト\]**、または使用するコマンド プロンプトを選択します。  
+  
+ [Windows SDK](http://msdn.microsoft.com/windows/desktop/aa904949) または [Windows Phone SDK](https://dev.windowsphone.com/downloadsdk) をインストールしている場合は、ARM、x86、または x64 の各アーキテクチャ用のコマンド プロンプトがさらに表示される場合があります。 各ツールのドキュメントを参照して、どのバージョンのコマンド プロンプトを使用する必要があるかを確認してください。  
+  
+<a name="alternative"></a>   
+## コンピューター上のファイルを手動で探す  
+  インストール済みのコマンド プロンプトのショートカットは、通常 Visual Studio の**\[スタート\] メニュー** 用のフォルダー \(C:\\ProgramData\\Microsoft\\Windows\\Start Menu\\Programs\\Visual Studio 2015\\Visual Studio Tools 内など\) にあります。    ただし、コマンド プロンプトを探しても、何らかの理由によって期待した結果を得られない場合は、そのショートカットを使用するために、コンピューター上でそのショートカットを手動で探すことができます。   VsDevCmd.bat などのコマンド プロンプトのファイル名を検索するか、または Tools フォルダー \(C:\\Program Files \(x86\)\\Microsoft Visual Studio 14.0\\Common7\\Tools など\) に移動します \(パスは、Visual Studio のバージョンとインストール先に応じて変わります\)。  
+  
+<a name="visualstudio"></a>   
+## Visual Studio 内からコマンド プロンプトを実行する  
+ 簡単にアクセスできるように、Visual Studio の開発者コマンド プロンプトまたは他のコマンド プロンプトを Visual Studio の \[ツール\] メニューに追加することができます。このためには、\[外部ツール一覧\] にそのコマンド プロンプトを追加します。 この追加を行う方法は、次のとおりです。  
+  
+1.  Visual Studio を開きます。  
+  
+2.  **\[ツール\]** メニューを選択し、**\[外部ツール...\]** をクリックします。  
+  
+3.  **\[外部ツール\]** ダイアログ ボックスで、**\[追加\]** ボタンをクリックします。 新しいエントリが表示されます  
+  
+4.  新しいメニュー項目の **\[タイトル\]** を入力します \(「`コマンド プロンプト`」など\)。  
+  
+5.  **\[コマンド\]** フィールドに、起動するファイル \(`%comspec%` や `C:\Windows\System32\cmd.exe` など\) を指定します。  
+  
+6.  **\[引数\]** フィールドに、使用する特定のコマンド プロンプトのある場所を指定します \(`/k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"` など \(これにより、[!INCLUDE[vs_dev14](../../../includes/vs-dev14-md.md)] でインストールされた開発者コマンド プロンプトが起動されます\)\)。 この値は、Visual Studio のバージョンとインストール先に応じて変更する必要があります。  
+  
+7.  **\[初期ディレクトリ\]** フィールドの値 \(**\[プロジェクト ディレクトリ\]** など\) を選択します。  
+  
+8.  **\[OK\]** を選択します。  
+  
+ この後、新しいメニュー項目が追加され、このコマンド プロンプトに **\[ツール\]** メニューからアクセスできるようになります。  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Visual Studio の外部ツール](../Topic/Managing%20External%20Tools.md)
\ No newline at end of file
diff --git a/docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md b/docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md
new file mode 100644
index 00000000000..366621a39d5
--- /dev/null
+++ b/docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md
@@ -0,0 +1,246 @@
+---
+title: "Fuslogvw.exe (アセンブリ バインディング ログ ビューアー) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 失敗したアセンブリ バインド"
+  - "アセンブリ バインディング ログ ビューアー"
+  - "表示 (失敗したアセンブリ バインドの詳細を)"
+  - "失敗したアセンブリ バインド"
+  - "Fuslogvw.exe"
+  - "検索 (アセンブリを)"
+ms.assetid: e32fa443-0778-4cc3-bf36-5c8ea297d296
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# Fuslogvw.exe (アセンブリ バインディング ログ ビューアー)
+アセンブリ バインディング ログ ビューアーは、アセンブリ バインドの詳細を表示します。  この情報は、.NET Framework が実行時にアセンブリを見つけられない原因を診断する場合に役立ちます。  通常、このようなエラーは、アセンブリが間違った位置に配置されているか、無効になったネイティブ イメージが存在するか、バージョン番号またはカルチャの不一致が存在する場合に発生します。  通常、共通言語ランタイムによるアセンブリ検出エラーは、アプリケーション内で <xref:System.TypeLoadException> として示されます。  
+  
+> [!IMPORTANT]
+>  fuslogvw.exe は、管理者特権で実行する必要があります。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、管理者の資格情報で開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+```  
+fuslogvw  
+```  
+  
+ ビューアーには、失敗したアセンブリ バインドごとに 1 つのエントリが表示されます。  バインドを開始したアプリケーション、バインドの対象となるアセンブリ \(名前、バージョン、カルチャ、公開キーなど\)、およびエラーの日時の情報が、エラーごとにビューアーに表示されます。  
+  
+### ログ位置ビューを変更するには  
+  
+1.  **Default** を選択すると、すべてのアプリケーションの種類のバインド エラーが表示されます。  既定では、ログ エントリは wininet キャッシュのディスクのユーザーごとのディレクトリに格納されます。  
+  
+2.  \[Custom\] を選択すると、指定したカスタム ディレクトリのバインド エラーが表示されます。  **\[ログ設定\]** ダイアログの \[カスタム ログのパス\] を使用して、ランタイムがログを格納するカスタムの場所を有効なディレクトリ名に指定する必要があります。  このディレクトリはクリーンで、ランタイムが生成するファイルだけが含まれている必要があります。  このディレクトリに、ログに記録するエラーを生成する実行可能ファイルが含まれている場合は、その実行可能ファイルと同じ名前でディレクトリの作成が試行されるため、そのエラーはログに記録されません。  また、ログの位置から実行可能ファイルを実行しようとすると、失敗します。  
+  
+    > [!NOTE]
+    >  カスタム バインド位置ではなく、既定のバインド位置を使用することをお勧めします。  ランタイムは wininet キャッシュに既定のバインド位置を格納するので、この位置は自動的に消去されます。  カスタム バインド位置を指定する場合は、この位置を削除する手段を独自に組み込む必要があります。  
+  
+### 特定のエラーの詳細を表示するには  
+  
+1.  ビューアーにエントリを表示するアプリケーション名を選択します。  
+  
+2.  \[View Log\] をクリックします。  また、選択したエントリをダブルクリックすることもできます。  
+  
+     選択したバインド エラーについて、次の詳細が表示されます。  
+  
+    -   "ファイルが見つからない" や "バージョンの不一致" など、バインド エラーの具体的な原因。  
+  
+    -   バインドを開始したアプリケーションについての情報 \(アプリケーション名、アプリケーションのルート ディレクトリ \(AppBase\)、プライベート検索パスが存在する場合にはそのパスなど\)。  
+  
+    -   検索対象となるアセンブリの ID。  
+  
+    -   Application、Publisher、または Administrator バージョンのポリシーが適用されている場合は、その説明。  
+  
+    -   [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)でのアセンブリの検出の有無。  
+  
+    -   すべてのプローブ URL の一覧。  
+  
+ 失敗したアセンブリ バインドについての詳細情報を表示するサンプル ログ エントリを次に示します。  
+  
+```  
+*** Assembly Binder Log Entry  (3/5/2007 @ 12:54:20 PM) ***  
+  
+The operation failed.  
+Bind result: hr = 0x80070002. The system cannot find the file specified.  
+  
+Assembly manager loaded from:  C:\WINNT\Microsoft.NET\Framework\v2.0.50727\fusion.dll  
+Running under executable  C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\graphicfailtest.exe  
+--- A detailed error log follows.   
+  
+=== Pre-bind state information ===  
+LOG: DisplayName = graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null  
+ (Fully-specified)  
+LOG: Appbase = C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\  
+LOG: Initial PrivatePath = NULL  
+LOG: Dynamic Base = NULL  
+LOG: Cache Base = NULL  
+LOG: AppName = NULL  
+Calling assembly : graphicfailtest, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+===  
+  
+LOG: Processing DEVPATH.  
+LOG: DEVPATH is not set. Falling through to regular bind.  
+LOG: Policy not being applied to reference at this time (private, custom, partial, or location-based assembly bind).  
+LOG: Post-policy reference: graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null  
+LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources.DLL.  
+LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources/graphicfailtest.resources.DLL.  
+LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources.EXE.  
+LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/graphicfailtest.resources/graphicfailtest.resources.EXE.  
+LOG: All probing URLs attempted and failed.  
+```  
+  
+### ログから単一のエントリを削除するには  
+  
+1.  ビューアーでエントリを選択します。  
+  
+2.  \[Delete Entry\] をクリックします。  
+  
+### ログからすべてのエントリを削除するには  
+  
+-   \[Delete All\] をクリックします。  
+  
+### ユーザー インターフェイスに最新の情報を表示するには  
+  
+-   \[最新の情報に更新\] をクリックします。  ビューアーの実行中に新しいログ エントリが自動的に検出されることはありません。  新しいログ エントリを表示するには、\[Refresh\] を使用する必要があります。  
+  
+### ログ設定を変更するには、次の処理手順に従います。  
+  
+-   **\[設定\]** をクリックして **\[ログ設定\]** ダイアログ ボックスを表示します。  
+  
+### \[バージョン情報\] ダイアログを表示するには  
+  
+-   **\[バージョン情報\]** をクリックします。  
+  
+## ネイティブ イメージのバインディング ログ  
+ 既定では、Fuslogvw.exe は通常のアセンブリ バインド要求をログに記録します。  代わりに、[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用して作成されたネイティブ イメージのアセンブリ バインドをログに記録することもできます。  
+  
+#### ネイティブ イメージのアセンブリ バインドをログに記録するには  
+  
+-   \[ログのカテゴリ\] グループで、\[ネイティブ イメージ\] をクリックします。  
+  
+ 次のログは、アプリケーションのネイティブ イメージの作成時には存在しなかった依存関係が原因で発生したエラーを示しています。  実行時の依存関係が Ngen.exe を実行したときの依存関係と異なる場合、ネイティブ イメージへのバインドはできません。  
+  
+```  
+*** Assembly Binder Log Entry  (12/8/2006 @ 5:22:07 PM) ***  
+  
+The operation failed.  
+Bind result: hr = 0x80070002. The system cannot find the file specified.  
+  
+Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll  
+Running under executable  E:\test\App.exe  
+--- A detailed error log follows.   
+  
+LOG: Start binding of native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+LOG: IL assembly loaded from E:\test\App.exe.  
+LOG: Start validating native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+LOG: Start validating all the dependencies.  
+LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.  
+LOG: Dependency evaluation succeeded.  
+LOG: [Level 1]Start validating IL dependency b, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+WRN: Dependency assembly was not found at ngen time, but is found at binding time. Disallow using this native image.  
+WRN: No matching native image found.  
+LOG: Bind to native image assembly did not succeed. Use IL image.  
+```  
+  
+ 次のログは、アプリケーションが実行されたときのコンピューターのセキュリティ設定が、ネイティブ イメージの作成時のセキュリティ設定と異なるために発生したネイティブ イメージのバインディング エラーを示しています。  
+  
+```  
+*** Assembly Binder Log Entry  (12/8/2006 @ 5:29:09 PM) ***  
+  
+The operation failed.  
+Bind result: hr = 0x80004005. Unspecified error  
+  
+Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll  
+Running under executable  E:\test\Application101622.exe  
+--- A detailed error log follows.   
+  
+LOG: Start binding of native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+LOG: IL assembly loaded from E:\test\Application101622.exe.  
+LOG: Start validating native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+LOG: Start validating all the dependencies.  
+LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.  
+LOG: Dependency evaluation succeeded.  
+LOG: [Level 1]Start validating IL dependency Dependency101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.  
+LOG: Dependency evaluation succeeded.  
+LOG: Validation of dependencies succeeded.  
+LOG: Start loading all the dependencies into load context.  
+LOG: Loading of dependencies succeeded.  
+LOG: Bind to native image succeeded.  
+Native image has correct version information.  
+Attempting to use native image E:\Windows\assembly\NativeImages_v2.0.50727_64\Application101622\1ac7fadabec4f72575d807501e9fdc72\Application101622.ni.exe.  
+Rejecting native image because it failed the security check. The assembly's permissions must have changed since the time it was ngenned, or it is running with a different security context.  
+Discarding native image.  
+```  
+  
+## \[ログ設定\] ダイアログ  
+ **\[ログ設定\]** ダイアログを使用すると、次のようなアクションを実行できます。  
+  
+#### ログを無効にするには  
+  
+-   **\[ログを無効にする\]** をクリックします。  このオプションの既定値はオンです。  
+  
+#### アセンブリ バインドの例外をログに記録するには  
+  
+-   **\[例外テキストに記録する\]** をクリックします。  詳細度が最も低い fusion ログ情報だけが例外テキストに記録されます。  完全な情報を表示するには、その他の設定のいずれかを使用します。  
+  
+     ドメインに中立的に読み込まれたアセンブリに関する「重要」メモを参照してください。  
+  
+#### アセンブリ バインドの失敗をログに記録するには  
+  
+-   **\[バインドの失敗をディスクに記録する\]** をクリックします。  
+  
+     ドメインに中立的に読み込まれたアセンブリに関する「重要」メモを参照してください。  
+  
+#### すべてのアセンブリ バインドをログに記録するには  
+  
+-   **\[すべてのバインドをディスクに記録する\]** をクリックします。  
+  
+     ドメインに中立的に読み込まれたアセンブリに関する「重要」メモを参照してください。  
+  
+> [!IMPORTANT]
+>  アセンブリがドメインに中立的に読み込まれた場合 \(<xref:System.AppDomainSetup.LoaderOptimization%2A> プロパティを <xref:System.LoaderOptimization?displayProperty=fullName> または <xref:System.LoaderOptimization?displayProperty=fullName> に設定した場合など\)、ログが有効になっているとメモリがリークすることがあります。  これが起こるのは、ドメインに中立的なモジュールがアプリケーション ドメインに読み込まれているときにログ エントリが作成され、その後でアプリケーション ドメインがアンロードされた場合です。  このログ エントリは、プロセスが終了するまで解放されません。  一部のデバッガーは、自動的にログを有効にします。  
+  
+#### カスタムのログ パスを有効にするには  
+  
+1.  **\[カスタム ログを有効にする\]** をクリックします。  
+  
+2.  **\[カスタム ログのパス\]** テキスト ボックスにパスを入力します。  
+  
+> [!NOTE]
+>  [アセンブリ バインディング ログ ビューアー \(Fuslogvw.exe\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) では、バインディング ログの格納に Internet Explorer \(IE\) のキャッシュを使用します。  IE キャッシュは時折破損することがあるため、[アセンブリ バインディング ログ ビューアー \(Fuslogvw.exe\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) の表示ウィンドウに新しいバインディング ログが表示されなくなることがあります。  IE キャッシュが破損した場合、.NET バインディング インフラストラクチャ \(fusion\) ではバインディング ログの読み書きができなくなります   \(この問題はカスタム ログ パスを使用している場合は発生しません\)。  破損を修復し、fusion でバインディング ログが再度表示されるようにするには、IE の \[インターネット オプション\] ダイアログで一時インターネット ファイルを削除して IE キャッシュを消去します。  
+>   
+>  アンマネージ アプリケーションが、`IHostAssemblyManager` インターフェイスと `IHostAssemblyStore` インターフェイスを実装して共通言語ランタイムをホストしている場合、ログ エントリを wininet キャッシュに格納できません。  これらのインターフェイスを実装したカスタム ホストのログ エントリを表示するには、別のログ パスを指定する必要があります。  
+  
+#### Windows アプリ コンテナー内で実行するアプリに対してログを有効にするには  
+  
+1.  前の手順に従って、カスタム ログのパスを有効にします。  既定では、Windows アプリ コンテナー内で実行しているアプリでは、ハード ディスクへのアクセスが制限されます。  指定するディレクトリでは、アプリ コンテナー内のすべてのアプリに対する読み取り\/書き込みアクセスが与えられます。  
+  
+2.  **\[没入型のログを有効にします\]** チェック ボックスをオンにします。  
+  
+    > [!NOTE]
+    >  このチェック ボックスは、Windows 8 以降でのみ有効になります。  
+  
+## 参照  
+ <xref:System.TypeLoadException>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/gacutil-exe-gac-tool.md b/docs/framework/tools/gacutil-exe-gac-tool.md
new file mode 100644
index 00000000000..6760617b7ad
--- /dev/null
+++ b/docs/framework/tools/gacutil-exe-gac-tool.md
@@ -0,0 +1,167 @@
+---
+title: "Gacutil.exe (グローバル アセンブリ キャッシュ ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "キャッシュ [.NET Framework], グローバル アセンブリ キャッシュ"
+  - "GAC (グローバル アセンブリ キャッシュ), Gacutil.exe"
+  - "GAC (グローバル アセンブリ キャッシュ), 操作 (内容の)"
+  - "GAC (グローバル アセンブリ キャッシュ), 表示 (内容を)"
+  - "Gacutil.exe"
+  - "グローバル アセンブリ キャッシュ ツール"
+  - "グローバル アセンブリ キャッシュ, Gacutil.exe"
+  - "グローバル アセンブリ キャッシュ, 操作 (内容の)"
+  - "グローバル アセンブリ キャッシュ, 表示 (内容を)"
+  - "インストール (グローバル アセンブリ キャッシュへのアセンブリの)"
+  - "一覧 (グローバル アセンブリ キャッシュ内のアセンブリの)"
+  - "削除 (グローバル アセンブリ キャッシュからアセンブリを)"
+  - "表示 (グローバル アセンブリ キャッシュ内のアセンブリを)"
+ms.assetid: 4c7be9c8-72ae-481f-a01c-1a4716806e99
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Gacutil.exe (グローバル アセンブリ キャッシュ ツール)
+グローバル アセンブリ キャッシュ ツールを使用すると、グローバル アセンブリ キャッシュとダウンロード キャッシュの内容を表示および操作できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+gacutil [options] [assemblyName | assemblyPath | assemblyListFile]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*assemblyName*|アセンブリの名前。  `myAssembly` などの部分的に指定したアセンブリ名、または `myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5` などの完全に指定したアセンブリ名を指定できます。|  
+|*assemblyPath*|アセンブリ マニフェストを含むファイルの名前。|  
+|*assemblyListFile*|インストールまたはアンインストールするアセンブリを一覧表示する ANSI テキスト ファイルへのパス。  テキスト ファイルを使用してアセンブリをインストールするには、ファイルの行ごとに各アセンブリへのパスを指定します。  このツールは、*assemblyListFil* の位置を基準にして相対パスを解釈します。  テキスト ファイルを使用してアセンブリをアンインストールするには、ファイルの行ごとに各アセンブリの完全限定アセンブリ名を指定します。  このトピックの後半にある *assemblyListFile* の内容の例を参照してください。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/cdl**|ダウンロード キャッシュの内容を削除します。|  
+|**\/f**|このオプションを **\/i** オプションまたは **\/il** オプションと共に使用して、アセンブリを強制的に再インストールします。  同じ名前のアセンブリがグローバル アセンブリ キャッシュに既に存在する場合、既存のアセンブリは上書きされます。|  
+|**\/h**\[**elp**\]|このツールのコマンド構文とオプションを表示します。|  
+|**\/i** *assemblyPath*|アセンブリをグローバル アセンブリ キャッシュにインストールします。|  
+|**\/if**  *assemblyPath*|アセンブリをグローバル アセンブリ キャッシュにインストールします。  同じ名前のアセンブリがグローバル アセンブリ キャッシュに既に存在する場合、既存のアセンブリは上書きされます。<br /><br /> このオプションを指定するのは、**\/i** オプションと **\/f** オプションを一緒に指定するのと同じです。|  
+|**\/il** *assemblyListFile*|*assemblyListFile* で指定された 1 つ以上のアセンブリをグローバル アセンブリ キャッシュにインストールします。|  
+|**\/ir**  *assemblyPath*<br /><br /> *scheme*<br /><br /> *id*<br /><br /> *description*|アセンブリをグローバル アセンブリ キャッシュにインストールし、そのアセンブリをカウントするための参照を追加します。  このオプションと共に *assemblyPath*、*scheme*、*id*、および *description* の各パラメーターを指定する必要があります。  これらのパラメーターとして指定できる有効な値については、**\/r** オプションを参照してください。<br /><br /> このオプションを指定するのは、**\/i** オプションと **\/r** オプションを一緒に指定するのと同じです。|  
+|**\/l** \[*assemblyName*\]|グローバル アセンブリ キャッシュの内容を一覧表示します。  *assemblyName*  パラメーターを指定した場合は、その名前と一致するアセンブリだけが一覧表示されます。|  
+|**\/ldl**|ダウンロードされたファイルのキャッシュの内容を一覧表示します。|  
+|**\/lr** \[*assemblyName*\]|すべてのアセンブリとそれらに該当する参照カウントを一覧表示します。  *assemblyName* パラメーターを指定した場合は、その名前と一致するアセンブリと、それらに該当する参照カウントだけが一覧表示されます。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/r** \[*assemblyName &#124; assemblyPath*\]<br /><br /> *scheme*<br /><br /> *id*<br /><br /> *description*|インストールまたはアンインストールするアセンブリへのトレースされた参照を指定します。  このオプションは、**\/i**、**\/il**、**\/u**、または **\/ul** の各オプションと共に指定します。<br /><br /> アセンブリをインストールするには、このオプションと共に *assemblyPath*、*scheme*、 *id*、および *description* の各パラメーターを指定します。  アセンブリをアンインストールするには、*assemblyName*、*scheme*、*id*、および *description* の各パラメーターを指定します。<br /><br /> アセンブリへの参照を削除するには、アセンブリをインストールしたときに **\/i** オプションおよび **\/r** \(または **\/ir**\) オプションと共に指定したのと同じ *scheme*、*id*、および *description* の各パラメーターを指定する必要があります。  アセンブリをアンインストールする場合、それが削除する最後の参照で、Windows インストーラーにアセンブリへの未解決の参照がまったくないときには、アセンブリもグローバル アセンブリ キャッシュから削除されます。<br /><br /> *scheme* パラメーターはインストール スキームのタイプを指定します。  次のいずれかの値を指定できます。<br /><br /> -   UNINSTALL\_KEY: インストーラーがアプリケーションを Microsoft Windows の \[アプリケーションの追加と削除\] に追加する場合は、この値を指定します。  アプリケーションは、レジストリ キーを HKLM\\Software\\Microsoft\\Windows\\CurrentVersion に追加して、そのアプリケーション自体を \[アプリケーションの追加と削除\] に追加します。<br />-   FILEPATH: インストーラーがアプリケーションを \[アプリケーションの追加と削除\] に追加しない場合は、この値を指定します。<br />-   OPAQUE: レジストリ キーまたはファイル パスの指定をインストール シナリオで行わない場合は、この値を指定します。  この値を指定した場合には、*id* パラメーターとしてカスタム情報を指定できます。<br /><br /> *id* パラメーターとして指定する値は、*scheme* パラメーターに指定した値によって決まります。<br /><br /> -   *scheme* パラメーターとして UNINSTALL\_KEY を指定した場合は、HKLM\\Software\\Microsoft\\Windows\\CurrentVersion レジストリ キーに設定したアプリケーションの名前を指定します。  たとえば、レジストリ キーが HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\MyApp の場合は、*id* パラメーターとして MyApp を指定します。<br />-   *scheme* パラメーターとして FILEPATH を指定した場合は、*id* パラメーターとして、アセンブリをインストールする実行可能ファイルへの完全パスを指定します。<br />-   *scheme* パラメーターとして OPAQUE を指定した場合は、*id* パラメーターとして任意のデータを指定できます。  指定するデータは二重引用符 \(""\) で囲む必要があります。<br /><br /> *description* パラメーターを使用して、インストールするアプリケーションに関する説明を指定できます。  この情報は、参照を列挙した場合に表示されます。|  
+|**\/silent**|すべての出力を表示しません。|  
+|**\/u**  *assemblyName*|アセンブリをグローバル アセンブリ キャッシュからアンインストールします。|  
+|**\/uf**  *assemblyName*|指定したアセンブリへのすべての参照を削除して、アセンブリを強制的にアンインストールします。<br /><br /> このオプションを指定するのは、**\/u** オプションと **\/f** オプションを一緒に指定するのと同じです。 **Note:**  このオプションを使用しても、Microsoft Windows インストーラーを使用してインストールされたアセンブリを削除することはできません。  削除しようとすると、エラー メッセージが表示されます。|  
+|**\/ul** *assemblyListFile*|*assemblyListFile* で指定された 1 つ以上のアセンブリをグローバル アセンブリ キャッシュからアンインストールします。|  
+|**\/u**\[**ngen**\] *assemblyName*|指定したアセンブリをグローバル アセンブリ キャッシュからアンインストールします。  指定したアセンブリが既存の参照カウントを持っている場合、参照カウントは表示されますが、アセンブリはグローバル アセンブリ キャッシュから削除されません。 **Note:**  .NET Framework Version 2.0 では、`/ungen` はサポートされていません。  代わりに、[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) の `uninstall` コマンドを使用します。 <br /><br /> .NET Framework Version 1.0 と 1.1 で **\/ungen** を指定すると、Gacutil.exe はネイティブ イメージ キャッシュからアセンブリを削除します。  このキャッシュは、[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用して作成したアセンブリのネイティブ イメージを格納します。|  
+|**\/ur**  *assemblyName*<br /><br /> *scheme*<br /><br /> *id*<br /><br /> *description*|指定したアセンブリへの参照をグローバル アセンブリ キャッシュからアンインストールします。  アセンブリへの参照を削除するには、アセンブリをインストールしたときに **\/i** オプションおよび **\/r** \(または **\/ir**\) オプションと共に指定したのと同じ *scheme*、*id*、および *description* の各パラメーターを指定する必要があります。  これらのパラメーターとして指定できる有効な値については、**\/r** オプションを参照してください。<br /><br /> このオプションを指定するのは、**\/u** オプションと **\/r** オプションを一緒に指定するのと同じです。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+  
+> [!NOTE]
+>  Gacutil.exe を使用するには管理者権限が必要です。  
+  
+ Gacutil.exe を使用すると、アセンブリのキャッシュへのインストールやキャッシュからの削除、およびキャッシュ内容の一覧表示を実行できます。  
+  
+ Gacutil.exe には、Windows インストーラーでサポートされる参照カウント スキームに類似した参照カウントをサポートするオプションが用意されています。  Gacutil.exe を使用して、同じアセンブリをインストールする 2 つのアプリケーションをインストールできます。このツールは、アセンブリへの参照の数を追跡します。  その結果、両方のアプリケーションがアンインストールされるまで、アセンブリはコンピューター上にとどまります。  実際の製品のインストールに Gacutil.exe を使用する場合は、参照カウントをサポートするオプションを使用してください。  アセンブリをインストールし、それをカウントするための参照を追加するには、**\/i** オプションと **\/r** オプションを一緒に使用します。  アセンブリの参照カウントを削除するには、**\/u** オプションと **\/r** オプションを一緒に使用します。  **\/i** オプションと **\/u** オプションを単独で使用しても、参照カウントはサポートされないので注意してください。  これらのオプションは、製品開発中に使用するのには適していますが、実際の製品のインストールには適していません。  
+  
+ ANSI テキスト ファイルに格納されているアセンブリの一覧をインストールまたはアンインストールするには、それぞれ **\/il** オプションまたは **\/ul** オプションを使用します。  テキスト ファイルの内容は正しく書式設定されている必要があります。  テキスト ファイルを使用してアセンブリをインストールするには、ファイルの行ごとに各アセンブリへのパスを指定します。  インストールするアセンブリを含むファイルの内容を表示する例を次に示します。  
+  
+```  
+myAssembly1.dll  
+myAssembly2.dll  
+myAssembly3.dll  
+```  
+  
+ テキスト ファイルを使用してアセンブリをアンインストールするには、ファイルの行ごとに各アセンブリの完全限定アセンブリ名を指定します。  アンインストールするアセンブリを含むファイルの内容を表示する例を次に示します。  
+  
+```  
+myAssembly1,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab  
+myAssembly2,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab  
+myAssembly3,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab  
+```  
+  
+## 例  
+ アセンブリ `mydll.dll` をグローバル アセンブリ キャッシュにインストールするコマンドを次に示します。  
+  
+```  
+gacutil /i mydll.dll  
+```  
+  
+ アセンブリ `hello` への参照カウントがない場合に、そのアセンブリをグローバル アセンブリ キャッシュから削除するコマンドを次に示します。  
+  
+```  
+gacutil /u hello  
+```  
+  
+ 上のコマンドでは、アセンブリ名が完全に指定されていないため、複数のアセンブリがアセンブリ キャッシュから削除される可能性もあります。  たとえば、キャッシュ内に `hello` のバージョン 1.0.0.0 と 3.2.2.1 が両方ともインストールされている場合にコマンド `gacutil /u hello` を実行すると、アセンブリは両方とも削除されます。  
+  
+ 複数のアセンブリを削除しないようにするには、次の例のようなコードを使用します。  このコマンドでは、完全に指定したバージョン番号、カルチャ、および公開キーと一致するアセンブリ `hello` だけが削除されます。  
+  
+```  
+gacutil /u hello, Version=1.0.0.1, Culture="de",PublicKeyToken=45e343aae32233ca  
+```  
+  
+ ファイル `assemblyList.txt` で指定されたアセンブリをグローバル アセンブリ キャッシュにインストールするコマンドを次に示します。  
+  
+ `gacutil /il assemblyList.txt`  
+  
+ ファイル `assemblyList.txt` で指定されたアセンブリをグローバル アセンブリ キャッシュから削除するコマンドを次に示します。  
+  
+ `gacutil /ul assemblyList.txt`  
+  
+ 次のコマンドにより `myDll.dll` がグローバル アセンブリ キャッシュにインストールされ、myDll.dll をカウントするための参照が追加されます。  アセンブリ `myDll.dll` はアプリケーション `MyApp` によって使用されます。  `UNINSTALL_KEY MyApp` パラメーターは、Windows の \[アプリケーションの追加と削除\] に `MyApp` を追加するレジストリ キーを指定します。  description パラメーターは `My Application Description` と指定されています。  
+  
+```  
+gacutil /i /r myDll.dll UNINSTALL_KEY MyApp "My Application Description"  
+```  
+  
+ 次のコマンドにより `myDll.dll` がグローバル アセンブリ キャッシュにインストールされ、myDll.dll をカウントするための参照が追加されます。  scheme パラメーター `FILEPATH` と id パラメーター `c:\applications\myApp\myApp.exe` は、`myDll.dll.` をインストールするアプリケーションへのパスを指定します。description パラメーターは `MyApp` として指定されています。  
+  
+ `gacutil /i /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp`  
+  
+ 次のコマンドにより `myDll.dll` がグローバル アセンブリ キャッシュにインストールされ、myDll.dll をカウントするための参照が追加されます。  scheme パラメーター `OPAQUE` が指定されているので、id パラメーターと description パラメーターをカスタマイズできます。  
+  
+```  
+gacutil /i /r mydll.dll OPAQUE "Insert custom application details here" "Insert Custom description information here"  
+```  
+  
+ アプリケーション `myApp` による `myDll.dll` への参照を削除するコマンドを次に示します。  これがアセンブリへの最後の参照の場合は、アセンブリもグローバル アセンブリ キャッシュから削除されます。  
+  
+ `gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp`  
+  
+ グローバル アセンブリ キャッシュの内容を一覧表示するコマンドを次に示します。  
+  
+```  
+gacutil /l  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)   
+ [Regasm.exe \(アセンブリ登録ツール\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/ilasm-exe-il-assembler.md b/docs/framework/tools/ilasm-exe-il-assembler.md
new file mode 100644
index 00000000000..148212694a9
--- /dev/null
+++ b/docs/framework/tools/ilasm-exe-il-assembler.md
@@ -0,0 +1,170 @@
+---
+title: "Ilasm.exe (IL アセンブラー) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Ilasm.exe"
+  - "メタデータ, MSIL アセンブラー"
+  - "MSIL"
+  - "MSIL アセンブラー"
+  - "MSIL ジェネレーター"
+  - "PE ファイル, MSIL アセンブラー"
+  - "移植可能な実行可能 (PE) ファイル, MSIL アセンブラー"
+  - "検査 (MSIL パフォーマンスを)"
+ms.assetid: 4ca3a4f0-4400-47ce-8936-8e219961c76f
+caps.latest.revision: 41
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 41
+---
+# Ilasm.exe (IL アセンブラー)
+IL アセンブラーは、ポータブル実行可能 \(PE\) ファイルを IL \(Intermediate Language\) から生成します \(IL について詳しくは、「[マネージ実行プロセス](../../../docs/standard/managed-execution-process.md)」をご覧ください\)。 IL と必要なメタデータを含む実行可能ファイルを実行すると、IL が予測どおりに動作するかどうかを確認できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+ilasm [options] filename [[options]filename...]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*ファイル名*|.il ソース ファイルの名前。 このファイルは、メタデータ宣言ディレクティブとシンボリック IL 命令で構成されます。 複数のソース ファイル引数を指定すると、Ilasm.exe で 1 つの PE ファイルを作成できます。 **Note:**  .il ソース ファイルのコードの最後の行に、後続の空白または行末文字のいずれかがあることを確認してください。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/32bitpreferred**|32 ビット優先イメージ \(PE32\) を作成します。|  
+|**\/alignment**\=*integer*|NT オプション ヘッダーの FileAlignment を *integer* で指定された値に設定します。 このオプションは、ファイル指定されている .alignment IL ディレクティブをオーバーライドします。|  
+|**\/appcontainer**|出力として、Windows アプリ コンテナー内で実行する .dll ファイルまたは .exe ファイルを作成します。|  
+|**\/arm**|ターゲット プロセッサとして Advanced RISC Machine \(ARM\) を指定します。<br /><br /> イメージのビット数を指定しない場合、既定は **\/32bitpreferred** です。|  
+|**\/base**\=*integer*|NT オプション ヘッダーの ImageBase を *integer* で指定された値に設定します。 このオプションは、ファイルに指定されている .imagebase IL ディレクティブをオーバーライドします。|  
+|**\/clock**|指定した .il ソース ファイルのコンパイル時間を計測して報告します。<br /><br /> **Total Run**: 後に続く特定の操作の実行に要した合計時間。<br /><br /> **Startup**: ファイルの読み込みとオープン。<br /><br /> **Emitting MD**: メタデータの生成。<br /><br /> **Ref to Def Resolution**: ファイルの定義への参照の解決。<br /><br /> **CEE File Generation**: メモリ内のファイル イメージの生成。<br /><br /> **PE File Writing**: PE へのイメージの書き込み。|  
+|**\/debug**\[\=`IMPL`&#124;`OPT`\]|デバッグ情報 \(ローカル変数と引数名、および行番号\) を組み込みます。 PDB ファイルを作成します。<br /><br /> **\/debug** に値を追加しなければ、JIT の最適化が無効になり、PDB ファイルのシーケンス ポイントが使用されます。<br /><br /> **IMPL** を指定すると、JIT 最適化が無効になり、暗黙のシーケンス ポイントが使用されます。<br /><br /> **OPT** を指定すると、JIT 最適化が有効になり、暗黙のシーケンス ポイントが使用されます。|  
+|**\/dll**|出力として .dll ファイルを生成します。|  
+|**\/enc**\=`file`|指定されたソース ファイルからエディット コンティニュ デルタを作成します。<br /><br /> この引数は教育機関専用のため、商業目的の使用はサポートされていません。|  
+|**\/exe**|出力として実行可能ファイルを生成します。 既定値です。|  
+|**\/flags**\=*integer*|共通言語ランタイム ヘッダーの ImageFlags を *integer* で指定された値に設定します。 このオプションは、ファイルに指定されている .corflags IL ディレクティブをオーバーライドします。 有効な *integer* の値の一覧については、CorHdr.h で COMIMAGE\_FLAGS を参照してください。|  
+|**\/fold**|複数の同じメソッド本体を 1 つに折りたたみます。|  
+|\/**highentropyva**|高エントロピ ASLR \(Address Space Layout Randomization\) をサポートする出力実行可能プログラムを作成します。 \(既定では **\/appcontainer**\)。|  
+|**\/include**\=`includePath`|`#include` によってインクルードされるファイルの検索パスを設定します。|  
+|**\/itanium**|ターゲット プロセッサとして Intel Itanium を指定します。<br /><br /> イメージのビット数を指定しない場合、既定は **\/pe64** です。|  
+|**\/key:** *keyFile*|*keyFile* に含まれる秘密キーを使って、厳密な署名を持つ *filename* をコンパイルします。|  
+|**\/key:@** *keySource*|*keySource* で生成された秘密キーを使って、厳密な署名を持つ *filename* をコンパイルします。|  
+|**\/listing**|標準出力にリスティング ファイルを生成します。 このオプションを省略すると、リスティング ファイルは生成されません。<br /><br /> このパラメーターは、.NET Framework 2.0 以降ではサポートされません。|  
+|**\/mdv**\=`versionString`|メタデータのバージョン文字列を設定します。|  
+|**\/msv**\=`major``.``minor`|メタデータのストリーム バージョンを設定します。ここで、`major` と `minor` は整数です。|  
+|**\/noautoinherit**|基底クラスが指定されていない場合、<xref:System.Object> からの既定の継承を無効にします。|  
+|**\/nocorstub**|CORExeMain スタブの生成を抑止します。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/output:** *22*|出力ファイルの名前と拡張子を指定します。 既定では、出力ファイルの名前は最初のソース ファイルの名前と同じです。 既定の拡張子は .exe です。**\/dll** オプションを指定した場合の既定の拡張子は .dll です。 **Note:**  **\/output:**myfile.dll と指定しても **\/dll** オプションは設定されません。**\/dll** を指定しないと、myfile.dll という名前の実行可能ファイルになります。|  
+|**\/optimize**|長いインストラクションを短く最適化します。 たとえば `br` を `br.s` にします。|  
+|**\/pe64**|64 ビットのイメージ \(PE32\+\) を作成します。<br /><br /> ターゲット プロセッサを指定しない場合、既定は `/itanium` です。|  
+|**\/pdb**|デバッグ情報の追跡を有効にせずに PDB ファイルを作成します。|  
+|**\/quiet**|クワイエット モードを指定します。アセンブリの進行状況はレポートされません。|  
+|**\/resource:** *file.res*|指定した \*.res 形式のリソース ファイルを生成される .exe ファイルまたは .dll ファイルに組み込みます。**\/resource** オプションで指定できる .res ファイルは 1 つだけです。|  
+|**\/ssver**\=`int`.`int`|NT オプション ヘッダーのサブシステム バージョン番号を設定します。**\/appcontainer** および **\/arm** では、最小バージョン番号は 6.02 です。|  
+|**\/stack**\=`stackSize`|NT Optional ヘッダーの SizeOfStackReserve 値を `stackSize` に設定します。|  
+|**\/stripreloc**|ベースの再配置が不要であることを指定します。|  
+|**\/subsystem**\=*integer*|NT オプション ヘッダーのサブシステムを *integer* で指定された値に設定します。 このコマンドは、ファイルに指定されている .subsystem IL ディレクティブをオーバーライドします。 有効な *integer* の値の一覧については、winnt.h で IMAGE\_SUBSYSTEM を参照してください。|  
+|**\/x64**|ターゲット プロセッサとして 64 ビットの AMD プロセッサを指定します。<br /><br /> イメージのビット数を指定しない場合、既定は **\/pe64** です。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+> [!NOTE]
+>  Ilasm.exe に関するすべてのオプションでは大文字と小文字が区別されず、先頭の 3 文字で認識されます。 たとえば、**\/lis** は **\/listing** と等価であり、**\/res:**myresfile.res は **\/resource:**myresfile.res と等価です。 引数を伴うオプションの場合は、オプションと引数の間に区切り記号としてコロン \(:\) または等号 \(\=\) を挿入できます。 たとえば、**\/output:** *file.ext* は **\/output\=** *file.ext* と等価です。  
+  
+## 解説  
+ IL アセンブラーは、IL ジェネレーターを設計および実装するツールの販売元を支援します。 ツールとコンパイラの開発者は、Ilasm.exe を使用することで、PE ファイル形式での IL の出力にかかわることなく、IL とメタデータの生成に集中できます。  
+  
+ C\# および Visual Basic など、ランタイムを対象とした他のコンパイラと同様に、Ilasm.exe も中間オブジェクト ファイルを生成しません。このため、PE ファイルを形成するためのリンク ステージが必要ありません。  
+  
+ IL アセンブラーは、すべての既存メタデータ、およびランタイムを対象としたプログラミング言語の IL 機能を表現できます。 このため、このようなプログラミング言語で記述されたマネージ コードを IL アセンブラーで適切に表現し、Ilasm.exe でコンパイルできます。  
+  
+> [!NOTE]
+>  .il ソース ファイルのコードの最後の行に、後続の空白または行末文字がない場合、コンパイルに失敗することがあります。  
+  
+ Ilasm.exe と、その対をなすツール [Ildasm.exe](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を併用できます。 Ildasm.exe は、IL コードを含む PE ファイルを使用して、Ilasm.exe への入力として適したテキスト ファイルを作成します。 これは、必ずしもランタイム メタデータ属性のすべてをサポートしないプログラミング言語で記述されたコードをコンパイルするときなどに便利です。 コードをコンパイルし、その出力を Ildasm.exe で実行した後、生成された IL テキスト ファイルを手作業で編集して足りない属性を追加できます。 このテキスト ファイルを Ilasm.exe で実行すると、最終的な実行可能ファイルを生成できます。  
+  
+ この方法を使用して、異なるコンパイラによって生成された複数の PE ファイルから 1 つの PE ファイルを生成することもできます。  
+  
+> [!NOTE]
+>  現時点では、埋め込みのネイティブ コード \(たとえば Visual C\+\+ で生成された PE ファイル\) を含む PE ファイルについては、この手法を使用できません。  
+  
+ この Ildasm.exe と Ilasm.exe の組み合わせをできる限り正確に使用するため、アセンブラーは、既定では、IL ソース内に記述されている可能性がある \(または別のコンパイラによって出力される可能性がある\) 長いエンコーディングを短いエンコーディングに置換しません。 可能な場合は、常に **\/optimize** オプションを使用して、短いエンコーディングを置換します。  
+  
+> [!NOTE]
+>  Ildasm.exe はディスク上のファイルについてだけ動作します。 グローバル アセンブリ キャッシュ内にインストールされたファイルについては動作しません。  
+  
+ IL の文法の詳細については、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] の asmparse.grammar ファイルを参照してください。  
+  
+## バージョン情報  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、次のようなコードを使用してインターフェイス実装にカスタム属性を追加できます。  
+  
+```  
+.class interface public abstract auto ansi IMyInterface { .method public hidebysig newslot abstract virtual instance int32 method1() cil managed { } // end of method IMyInterface::method1 } // end of class IMyInterface .class public auto ansi beforefieldinit MyClass extends [mscorlib]System.Object implements IMyInterface { .interfaceimpl type IMyInterface .custom instance void [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 ) …  
+  
+```  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、次のコードに示すように、未処理のバイナリ表現を使用して、任意のマーシャリング BLOB \(バイナリ ラージ オブジェクト\) を指定できます。  
+  
+```  
+.method public hidebysig abstract virtual instance void marshal({ 38 01 02 FF }) Test(object A_1) cil managed  
+  
+```  
+  
+ IL の文法の詳細については、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] の asmparse.grammar ファイルを参照してください。  
+  
+## 例  
+ IL ファイル `myTestFile.il` をアセンブルして実行可能ファイル `myTestFile.exe.` を生成するコマンドを次に示します。  
+  
+```  
+ilasm myTestFile  
+```  
+  
+ IL ファイル `myTestFile.il` をアセンブルして .dll ファイル `myTestFile.dll` を生成するコマンドを次に示します。  
+  
+```  
+ilasm myTestFile /dll   
+```  
+  
+ IL ファイル `myTestFile.il` をアセンブルして .dll ファイル `myNewTestFile.dll` を生成するコマンドを次に示します。  
+  
+```  
+ilasm myTestFile /dll /output:myNewTestFile.dll  
+```  
+  
+ コンソールに "Hello World\!" を表示する非常に簡単なアプリケーションのコード例を次に示します。  このコードのコンパイル後に [Ildasm.exe](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) ツールを使用して、IL ファイルを生成できます。  
+  
+```csharp  
+using System; public class Hello { public static void Main(String[] args) { Console.WriteLine("Hello World!"); } }  
+```  
+  
+ 次の IL コードの例は、前の C\# のコード例に対応しています。  IL アセンブラー ツールを使うと、このコードをアセンブリにコンパイルできます。  IL コードと C\# コードの例は、どちらもコンソールに "Hello World\!" を表示します。  
+  
+```  
+// Metadata version: v2.0.50215 .assembly extern mscorlib { .publickeytoken = (B7 7A 5C 56 19 34 E0 89 )                         // .z\V.4.. .ver 2:0:0:0 } .assembly sample { .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilationRelaxationsAttribute::.ctor(int32) = ( 01 00 08 00 00 00 00 00 ) .hash algorithm 0x00008004 .ver 0:0:0:0 } .module sample.exe // MVID: {A224F460-A049-4A03-9E71-80A36DBBBCD3} .imagebase 0x00400000 .file alignment 0x00000200 .stackreserve 0x00100000 .subsystem 0x0003       // WINDOWS_CUI .corflags 0x00000001    //  ILONLY // Image base: 0x02F20000 // =============== CLASS MEMBERS DECLARATION =================== .class public auto ansi beforefieldinit Hello extends [mscorlib]System.Object { .method public hidebysig static void  Main(string[] args) cil managed { .entrypoint // Code size       13 (0xd) .maxstack  8 IL_0000:  nop IL_0001:  ldstr      "Hello World!" IL_0006:  call       void [mscorlib]System.Console::WriteLine(string) IL_000b:  nop IL_000c:  ret } // end of method Hello::Main .method public hidebysig specialname rtspecialname instance void  .ctor() cil managed { // Code size       7 (0x7) .maxstack  8 IL_0000:  ldarg.0 IL_0001:  call       instance void [mscorlib]System.Object::.ctor() IL_0006:  ret } // end of method Hello::.ctor } // end of class Hello  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)   
+ [マネージ実行プロセス](../../../docs/standard/managed-execution-process.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/ildasm-exe-il-disassembler.md b/docs/framework/tools/ildasm-exe-il-disassembler.md
new file mode 100644
index 00000000000..32c6ef897b0
--- /dev/null
+++ b/docs/framework/tools/ildasm-exe-il-disassembler.md
@@ -0,0 +1,199 @@
+---
+title: "Ildasm.exe (IL 逆アセンブラー) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "逆アセンブリ (MSIL アセンブラー入力のファイルの)"
+  - "Ildasm.exe"
+  - "MSIL 逆アセンブラー"
+  - "PE ファイル, MSIL 逆アセンブラー"
+  - "移植可能な実行可能 (PE) ファイル, MSIL 逆アセンブラー"
+  - "テキスト ファイル (MSIL 逆アセンブラーによって生成された)"
+ms.assetid: db27f6b2-f1ec-499e-be3a-7eecf95ca42b
+caps.latest.revision: 33
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# Ildasm.exe (IL 逆アセンブラー)
+IL 逆アセンブラーは、IL アセンブラー \(Ilasm.exe\) と対をなすツールです。  Ildasm.exe は、中間言語 \(IL: Intermediate Language\) コードを含む、ポータブル実行可能 \(PE\) ファイルを使用して、Ilasm.exe に対する入力として適したテキスト ファイルを作成します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+ildasm [options] [PEfilename] [options]  
+```  
+  
+#### パラメーター  
+ .exe、.dll、.obj、.lib、および .winmd の各ファイルについて、次のオプションを使用できます。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/out\=** *filename*|結果をグラフィカル ユーザー インターフェイスに表示せずに、指定した *filename* を持つ出力ファイルを作成します。|  
+|**\/rtf**|出力をリッチ テキスト形式で生成します。  **\/text** オプションと共に使用すると無効になります。|  
+|**\/text**|結果をグラフィカル ユーザー インターフェイスまたは出力ファイルに出力せずに、コンソール ウィンドウに表示します。|  
+|**\/html**|出力を HTML 形式で生成します。  **\/output** オプションと共に使用する場合に有効です。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+ .exe ファイル、.dll ファイル、および .winmd ファイルについては、次のオプションも利用できます。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/bytes**|実際のバイトを 16 進形式の命令コメントとして表示します。|  
+|**\/caverbal**|カスタム属性の BLOB を Verbal 形式で生成します。  既定はバイナリ形式です。|  
+|**\/linenum**|元のソース行への参照を組み込みます。|  
+|**\/nobar**|逆アセンブルのプログレス インジケーター ポップアップ ウィンドウの表示を中止します。|  
+|**\/noca**|カスタム属性の出力を抑止します。|  
+|**\/project**|ネイティブ [!INCLUDE[wrt](../../../includes/wrt-md.md)] に表示される方法ではなく、マネージ コードに表示される方法でメタデータを示します。  `PEfilename` が Windows メタデータ \(.winmd\) ファイルではない場合、このオプションは無効になります。  「[Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)」を参照してください。|  
+|**\/pubonly**|パブリックな型とメンバーだけを逆アセンブルします。  **\/visibility:PUB** と等価です。|  
+|**\/quoteallnames**|すべての名前を単一引用符で囲みます。|  
+|**\/raweh**|例外処理句を生の形式で表示します。|  
+|**\/source**|元のソース行をコメントとして表示します。|  
+|**\/tokens**|クラスとメンバーのメタデータ トークンを表示します。|  
+|**\/visibility:** *vis*\[\+*vis*...\]|指定した参照可能範囲を持つ型またはメンバーだけを逆アセンブルします。  *vis* の有効な値を次に示します。<br /><br /> **PUB** — Public<br /><br /> **PRI** — Private<br /><br /> **FAM** — Family<br /><br /> **ASM** — Assembly<br /><br /> **FAA** — Family and Assembly<br /><br /> **FOA** — Family or Assembly<br /><br /> **PSC** — Private Scope<br /><br /> 以上の可視性修飾子の定義については、「<xref:System.Reflection.MethodAttributes>」と「<xref:System.Reflection.TypeAttributes>」を参照してください。|  
+  
+ 次のオプションは、.exe ファイル、.dll ファイル、および .winmd ファイルをファイル出力またはコンソール出力する場合にだけ有効です。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/all**|**\/header**、**\/bytes**、**\/stats**、**\/classlist**、および **\/tokens** の各オプションの組み合わせを指定します。|  
+|**\/classlist**|モジュールで定義されているクラスの一覧を含めます。|  
+|**\/forward**|事前のクラス宣言を使用します。|  
+|**\/headers**|出力にファイル ヘッダー情報を組み込みます。|  
+|**\/item:** *class*\[**::** *member*\[`(`*sig*\]\]|指定した引数に応じて、次の要素を逆アセンブルします。<br /><br /> -   指定した *class* を逆アセンブルします。<br />-   指定した *class* の `member` を逆アセンブルします。<br />-   指定したシグネチャ *sig* を持つ *class* の `member` ``  を逆アセンブルします。  *sig* の書式は次のとおりです。<br />     \[`instance`\] `returnType`\(`parameterType1`, `parameterType2`, …, `parameterTypeN`\)<br />     **メモ** .NET Framework Version 1.0 および 1.1 では、\(`sig`\) のように、`sig` の後に閉じかっこを付ける必要があります。  .NET Framework Version 2.0 以降では、閉じかっこを省略して \(`sig` とする必要があります。|  
+|**\/noil**|IL アセンブリ コードが出力されなくなります。|  
+|**\/stats**|イメージの統計情報を含めます。|  
+|**\/typelist**|ラウンド トリップの型の順序を保存するために、型の完全な一覧を生成します。|  
+|**\/unicode**|出力に Unicode エンコードを使用します。|  
+|**\/utf8**|出力に UTF\-8 エンコードを使用します。  既定値は ANSI です。|  
+  
+ 次のオプションは、.exe、.dll、.obj、.lib、および .winmd の各ファイルをファイル出力またはコンソール出力する場合にだけ有効です。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/metadata**\[\=`specifier`\]|メタデータを表示します。ここで、`specifier` は次のとおりです。<br /><br /> **MDHEADER** — メタデータのヘッダー情報とサイズを表示します。<br /><br /> **HEX** — ワードおよび 16 進で情報を表示します。<br /><br /> **CSV** — レコード カウントとヒープ サイズを表示します。<br /><br /> **UNREX** — 未解決の外部項目を表示します。<br /><br /> **SCHEMA** — メタデータのヘッダー情報とスキーマ情報を表示します。<br /><br /> **RAW** — 未処理のメタデータ テーブルを表示します。<br /><br /> **HEAPS** — 未処理のヒープを表示します。<br /><br /> **VALIDATE** — メタデータの一貫性を検証します。<br /><br /> **\/metadata** に複数の項目を指定し、`specifier` に異なる値を指定できます。|  
+  
+ 次のオプションは、.lib ファイルをファイル出力またはコンソール出力する場合にだけ有効です。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/objectfile**\=`filename`|指定したライブラリ内の単一のオブジェクト ファイルのメタデータを表示します。|  
+  
+> [!NOTE]
+>  Ildasm.exe に関するすべてのオプションでは大文字と小文字が区別されず、先頭の 3 文字で認識されます。  たとえば、**\/quo** は **\/quoteallnames** と等価です。  引数を伴うオプションの場合は、オプションと引数の間に区切り記号としてコロン \(:\) または等号 \(\=\) を挿入できます。  たとえば、**\/output:** *filename* は **\/output\=** *filename* と等価です。  
+  
+## 解説  
+ Ildasm.exe はディスク上のファイルについてだけ動作します。  グローバル アセンブリ キャッシュ内にインストールされたファイルについては動作しません。  
+  
+ Ildasm.exe で生成されるテキスト ファイルを IL アセンブラー \(Ilasm.exe\) に対する入力として使用できます。  これは、必ずしもランタイム メタデータ属性のすべてをサポートしないプログラミング言語で記述されたコードをコンパイルするときなどに便利です。  コードをコンパイルし、その出力を Ildasm.exe で実行した後、生成された IL テキスト ファイルを手作業で編集して足りない属性を追加できます。  このテキスト ファイルを IL アセンブラーで実行すると、最終的な実行可能ファイルを生成できます。  
+  
+> [!NOTE]
+>  現時点では、埋め込みのネイティブ コード \(たとえば Visual C\+\+ で生成された PE ファイル\) を含む PE ファイルについては、この手法を使用できません。  
+  
+ IL 逆アセンブラーで既定の GUI を使用すると、既存のどの PE ファイルのメタデータおよび逆アセンブルしたコードでも、階層ツリー ビューで表示できます。  GUI を使用するには、引数 *PEfilename* またはその他のオプションを指定せずに、コマンド行で「**ildasm**」と入力します。  \[ファイル\] メニューで、Ildasm.exe に読み込む PE ファイルまで移動できます。  選択した PE ファイルについて表示されたメタデータおよび逆アセンブルしたコードを保存するには、\[ファイル\] メニューの \[ダンプ\] をクリックします。  階層ツリー ビューだけを保存するには、\[ファイル\] メニューの \[ツリービューをダンプ\] をクリックします。  Ildasm.exe へのファイルの読み込みおよび出力の解釈の詳細については、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に用意されている Samples フォルダー内の Ildasm.exe のチュートリアルを参照してください。  
+  
+ Ildasm.exe に対して、埋め込みリソースを含む引数 *PEfilename* を指定した場合は、複数の出力ファイルが生成されます。生成されるファイルは、IL コードを含む 1 つのテキスト ファイルと、埋め込みマネージ リソースごとにリソース名を使用してメタデータから生成した .resources ファイルです。  アンマネージ リソースが *PEfilename* の中に埋め込まれている場合は、IL 出力に対して **\/output** オプションで指定されたファイル名を使用して、.res ファイルが生成されます。  
+  
+> [!NOTE]
+>  Ildasm.exe では、入力ファイルの .obj と .lib についてはメタデータの説明だけが表示されます。  これらの種類のファイルの場合、IL コードは逆アセンブルされません。  
+  
+ Ildasm.exe を .exe ファイルまたは .dll ファイルに対して実行し、ファイルが管理されているかどうかを確認できます。  ファイルが管理されていない場合は、そのファイルに有効な共通言語ランタイム ヘッダーがないため、逆アセンブルできないことを示すメッセージが表示されます。  ファイルが管理されている場合は、処理が正常に行われます。  
+  
+## バージョン情報  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、Ildasm.exe は、未処理のバイナリ コンテンツを表示することにより、認識できないマーシャリング バイナリ ラージ オブジェクト \(BLOB: Binary Large Object\) を処理します。  たとえば、C\# プログラムで生成されたマーシャル BLOB の表示方法を次のコードに示します。  
+  
+```  
+  // C#  
+  public void Test([MarshalAs((short)70)] int test) { }  
+  
+// IL from Ildasm.exe output  
+.method public hidebysig instance void  
+  Test(int32  marshal({ 46 }) test) cil managed  
+  
+```  
+  
+ 次の Ildasm.exe の出力抜粋に示すように、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、Ildasm.exe はインターフェイス実装に適用される属性を表示します。  
+  
+```  
+.class public auto ansi beforefieldinit MyClass  
+  extends [mscorlib]System.Object  
+  implements IMyInterface  
+  {  
+    .interfaceimpl type IMyInterface  
+    .custom instance void  
+      [mscorlib]System.Diagnostics.DebuggerNonUserCodeAttribute::.ctor() = ( 01 00 00 00 )  
+      …  
+  
+```  
+  
+## 例  
+ PE ファイル `MyHello.exe` のメタデータと逆アセンブルしたコードを、Ildasm.exe の既定の GUI で表示するコマンドを次に示します。  
+  
+```  
+ildasm myHello.exe  
+```  
+  
+ ファイル `MyFile.exe` を逆アセンブルし、生成される IL アセンブラー テキストをファイル `MyFile.il` に格納するコマンドを、次に示します。  
+  
+```  
+ildasm MyFile.exe /output:MyFile.il  
+```  
+  
+ ファイル `MyFile.exe` を逆アセンブルし、生成される IL アセンブラーをコンソール ウィンドウに表示するコマンドを次に示します。  
+  
+```  
+ildasm MyFile.exe /text  
+```  
+  
+ `MyApp.exe` に埋め込みのマネージ リソースとアンマネージ リソースが含まれる場合に次のコマンドを実行すると、4 つのファイル、`MyApp.il`、`MyApp.res`、`Icons.resources,` 、および `Message.resources` が生成されます。  
+  
+```  
+ildasm MyApp.exe /output:MyApp.il  
+```  
+  
+ `MyFile.exe`  内のクラス `MyClass` に属するメソッド `MyMethod` を逆アセンブルし、その出力をコンソール ウィンドウに表示するコマンドを次に示します。  
+  
+```  
+ildasm /item:MyClass::MyMethod MyFile.exe /text  
+```  
+  
+ 上の例では、異なるシグネチャを持つ `MyMethod` という名前のメソッドが複数存在する可能性があります。  戻り値の型 **void**、およびパラメーターの型 **int32** と **string** を指定してインスタンス メソッド `MyMethod` を逆アセンブルするコマンドを次に示します。  
+  
+```  
+ildasm /item:"MyClass::MyMethod(instance void(int32,string)" MyFile.exe /text  
+```  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、メソッド名の後にある左かっことシグネチャの後にある右かっこの数が一致するように `MyMethod(instance void(int32))` とする必要があります。  .NET Framework Version 2.0 以降では、閉じかっこを省略して `MyMethod(instance void(int32)` とする必要があります。  
+  
+ `static` メソッド \(Visual Basic の `Shared` メソッド\) を取得するには、キーワード `instance` を省略します。  `int32` や `string` のようなプリミティブ型でないクラス型には名前空間を含め、キーワード `class` を前に付ける必要があります。  外部の型には、角かっこで囲んだライブラリ名を前に付ける必要があります。  <xref:System.AppDomain> 型の 1 つのパラメーターと <xref:System.AppDomain> 型の戻り値を持つ、`MyMethod` という名前の静的メソッドを逆アセンブルするコマンドを次に示します。  
+  
+```  
+ildasm /item:"MyClass::MyMethod(class [mscorlib]System.AppDomain(class [mscorlib]System.AppDomain)" MyFile.exe /text  
+```  
+  
+ 入れ子になった型は、クラスを前に付けてスラッシュで区切る必要があります。  たとえば、`MyNamespace.MyClass` クラスに `NestedClass` という名前の入れ子になったクラスが含まれている場合は、`class MyNamespace.MyClass/NestedClass` のように指定します。  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Ilasm.exe \(IL アセンブラー\)](../../../docs/framework/tools/ilasm-exe-il-assembler.md)   
+ [マネージ実行プロセス](../../../docs/standard/managed-execution-process.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/index.md b/docs/framework/tools/index.md
new file mode 100644
index 00000000000..ea868b98420
--- /dev/null
+++ b/docs/framework/tools/index.md
@@ -0,0 +1,146 @@
+---
+title: ".NET Framework ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, ツール"
+  - "コマンド ライン, .NET Framework ツール"
+  - "実行 (.NET Framework ツールを)"
+  - "ツール [.NET Framework]"
+ms.assetid: a2ca532d-91f7-426a-9303-417c2ee1247c
+caps.latest.revision: 65
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# .NET Framework ツール
+.NET Framework ツールを使用すると、.NET Framework に対応したアプリケーションやコンポーネントを簡単に作成、配置、および管理できます。  
+  
+ ここで説明する .NET Framework ツールの大半は、Visual Studio のインストール時に自動的にインストールされます。 \(インストールに関する情報については、「[Visual Studio のダウンロード](http://go.microsoft.com/fwlink/?LinkID=325532)」を参照してください。\)  
+  
+ アセンブリ キャッシュ ビューアー \(Shfusion.dll\) を除き、これらのツールはすべてコマンド ラインから実行できます。 エクスプローラーから Shfusion.dll にアクセスする必要があります。  
+  
+ コマンド ライン ツールの最適な実行方法は、Visual Studio 用開発者コマンド プロンプトを使用することです。 これらのユーティリティを使用すると、インストール フォルダーに移動することなくツールを簡単に実行できます。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+> [!NOTE]
+>  ツールの中には、32 ビット コンピューターまたは 64 ビット コンピューターに固有のものもあります。 該当するコンピューターに適切なバージョンのツールを実行します。  
+  
+## このセクションの内容  
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)  
+ モジュール ファイルまたはリソース ファイルから、アセンブリ マニフェストを含むファイルを生成します。  
+  
+ [Aximp.exe \(Windows フォーム ActiveX コントロール インポーター\)](../../../docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md)  
+ ActiveX コントロール用の COM タイプ ライブラリに属する型定義を Windows フォーム コントロールに変換します。  
+  
+ [Caspol.exe \(コード アクセス セキュリティ ポリシー ツール\)](../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md)  
+ コンピューター ポリシー レベル、ユーザー ポリシー レベル、およびエンタープライズ ポリシー レベルのセキュリティ ポリシーを表示および構成できます。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、[\<legacyCasPolicy\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/netfx40-legacysecuritypolicy-element.md)が `true` に設定されていない限り、このツールがコード アクセス セキュリティ \(CAS: Code Access Security\) ポリシーに影響を与えることはありません。 詳細については、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」を参照してください。  
+  
+ [Cert2spc.exe \(ソフトウェア発行元証明書テスト ツール\)](../../../docs/framework/tools/cert2spc-exe-software-publisher-certificate-test-tool.md)  
+ 1 つ以上の X.509 証明書からソフトウェア発行元証明書 \(SPC: Software Publisher's Certificate\) を作成します。 このツールはテスト専用です。  
+  
+ [Certmgr.exe \(証明書マネージャー ツール\)](../../../docs/framework/tools/certmgr-exe-certificate-manager-tool.md)  
+ 証明書、証明書信頼リスト \(CTL: Certificate Trust Lists\)、および証明書失効リスト \(CRL: Certificate Revocation Lists\) を管理します。  
+  
+ [Clrver.exe \(CLR バージョン ツール\)](../../../docs/framework/tools/clrver-exe-clr-version-tool.md)  
+ コンピューターにインストールされている共通言語ランタイム \(CLR: Common Language Runtime\) のすべてのバージョンを報告します。  
+  
+ [CorFlags.exe \(CorFlags 変換ツール\)](../../../docs/framework/tools/corflags-exe-corflags-conversion-tool.md)  
+ 移植可能な実行可能 \(PE\) イメージのヘッダー内の CorFlags セクションを構成します。  
+  
+ [Fuslogvw.exe \(アセンブリ バインディング ログ ビューアー\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md)  
+ アセンブリ バインドに関する情報を表示します。これは、.NET Framework が実行時にアセンブリを見つけられない原因を診断する場合に役立ちます。  
+  
+ [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../docs/framework/tools/gacutil-exe-gac-tool.md)  
+ グローバル アセンブリ キャッシュおよびダウンロード キャッシュの内容の表示と操作を行います。  
+  
+ [Ilasm.exe \(IL アセンブラー\)](../../../docs/framework/tools/ilasm-exe-il-assembler.md)  
+ 中間言語 \(IL\) から移植可能な実行可能 \(PE\) ファイルを生成します。 生成された実行可能ファイルを実行すると、IL が期待どおりに動作するかどうかを確認できます。  
+  
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)  
+ 中間言語 \(IL\) コードを含む移植可能な実行可能 \(PE\) ファイルを受け取り、IL アセンブラー \(Ilasm.exe\) への入力として使用できるテキスト ファイルを作成します。  
+  
+ [Installutil.exe \(インストーラー ツール\)](../../../docs/framework/tools/installutil-exe-installer-tool.md)  
+ 指定したアセンブリのインストーラー コンポーネントを実行することによって、サーバー リソースのインストールとアンインストールを実行できます  \(<xref:System.Configuration.Install> 名前空間のクラスと連携して動作します\)。 指定したアセンブリのインストーラー コンポーネントを実行することによって、サーバー リソースのインストールとアンインストールを実行できます  \(<xref:System.Configuration.Install> 名前空間のクラスと連携して動作します\)。  
+  
+ [Lc.exe \(ライセンス コンパイラ\)](../../../docs/framework/tools/lc-exe-license-compiler.md)  
+ ライセンス情報を含むテキスト ファイルを読み込んで、.licenses ファイルを生成します。この .licenses ファイルは、共通言語ランタイムの実行可能ファイルにリソースとして埋め込むことができます。 ライセンス情報を含むテキスト ファイルを読み込んで、.licenses ファイルを生成します。この .licenses ファイルは、共通言語ランタイムの実行可能ファイルにリソースとして埋め込むことができます。  
+  
+ [Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)  
+ アプリケーション マニフェストと配置マニフェストの作成、編集、および署名を行います。 Mage.exe はコマンド ライン ツールであるため、バッチ スクリプトから実行したり、ASP.NET アプリケーションなどの他の Windows ベースのアプリケーションから実行したりできます。  
+  
+ [MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)  
+ コマンド ライン ツールの Mage.exe と同じ機能をサポートしますが、Windows ベースのユーザー インターフェイス \(UI\) を使用します。 コマンド ライン ツールの Mage.exe と同じ機能をサポートしますが、Windows ベースのユーザー インターフェイス \(UI\) を使用します。  
+  
+ [MDbg.exe \(.NET Framework コマンド ライン デバッガー\)](../../../docs/framework/tools/mdbg-exe.md)  
+ .NET Framework 共通言語ランタイムを対象としたプログラムに含まれるバグの発見と修正について、ツールの販売元とアプリケーション開発者を支援するツールです。 このツールは、ランタイムのデバッグ API を使用してデバッグ サービスを提供します。  
+  
+ [Mgmtclassgen.exe \(厳密型クラス ジェネレーター\)](../../../docs/framework/tools/mgmtclassgen-exe.md)  
+ 指定した WMI \(Windows Management Instrumentation\) クラスに対して、事前バインディングされたマネージ クラスを生成できます。  
+  
+ [Mpgo.exe \(マネージ プロファイル ガイド付き最適化ツール\)](../../../docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md)  
+ 一般的なエンド ユーザーのシナリオを使用してネイティブ イメージのアセンブリを調整できるようにします。 Mpgo.exe により、アプリケーション開発者によって選択されたトレーニング シナリオを使用したネイティブ イメージ アプリケーション アセンブリ \(.NET Framework アセンブリではない\) のプロファイル データの生成と消費が可能になります。  
+  
+ [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md)  
+ ネイティブ イメージ \(コンパイルされたプロセッサ固有のマシン語コードを格納しているファイル\) を使用することで、マネージ アプリケーションのパフォーマンスを改善します。 ランタイムは、Just\-In\-Time \(JIT\) コンパイラを使用してオリジナルのアセンブリをコンパイルする代わりに、キャッシュにあるネイティブ イメージを使用できます。  
+  
+ [Peverify.exe \(PEVerify ツール\)](../../../docs/framework/tools/peverify-exe-peverify-tool.md)  
+ Microsoft Intermediate Language \(MSIL\) コードと関連メタデータがタイプ セーフ要件を満たしているかどうかを検証する場合に役立ちます。 Microsoft Intermediate Language \(MSIL\) コードと関連メタデータがタイプ セーフ要件を満たしているかどうかを検証する場合に役立ちます。  
+  
+ [Regasm.exe \(アセンブリ登録ツール\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md)  
+ アセンブリ内のメタデータを読み取り、必要なエントリをレジストリに追加します。 これにより、COM クライアントが .NET Framework クラスとして表示されるようになります。  
+  
+ [Regsvcs.exe \(.NET サービス インストール ツール\)](../../../docs/framework/tools/regsvcs-exe-net-services-installation-tool.md)  
+ アセンブリを読み込んで登録し、タイプ ライブラリを生成して指定された COM\+ Version 1.0 アプリケーションにインストールし、プログラムによってクラスに追加されたサービスを構成します。  
+  
+ [Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)  
+ テキスト ファイル \(.txt または .restext\) と XML ベースのリソース形式ファイル \(.resx\) を、共通言語ランタイムのバイナリ ファイル \(.resources\) に変換します。このバイナリ ファイルは、ランタイム バイナリ実行可能ファイルに埋め込んだり、サテライト アセンブリにコンパイルしたりできます。  
+  
+ [SecAnnotate.exe \(.NET セキュリティ アノテーター ツール\)](../../../docs/framework/tools/secannotate-exe-net-security-annotator-tool.md)  
+ アセンブリの SecurityCritical 部分と SecuritySafeCritical 部分を識別します。 アセンブリの `SecurityCritical` 部分と `SecuritySafeCritical` 部分を識別します。  
+  
+ [SignTool.exe \(署名ツール\)](../../../docs/framework/tools/signtool-exe.md)  
+ ファイルにデジタル署名を添付し、ファイルの署名を検証し、ファイルにタイム スタンプを付けます。  
+  
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)  
+ 厳密な名前を持つアセンブリを作成するときに役立ちます。 このツールには、キーの管理、署名の生成、署名の検査に関する各オプションが用意されています。  
+  
+ [SOS.dll \(SOS デバッガー拡張\)](../../../docs/framework/tools/sos-dll-sos-debugging-extension.md)  
+ 内部の共通言語ランタイム環境に関する情報を提供して、WinDbg.exe デバッガーおよび Visual Studio におけるマネージ プログラムのデバッグを支援します。  
+  
+ [SqlMetal.exe \(コード生成ツール\)](../../../docs/framework/tools/sqlmetal-exe-code-generation-tool.md)  
+ .NET Framework の LINQ to SQL コンポーネント用のコードとマッピングを生成します。  
+  
+ [Storeadm.exe \(分離ストレージ ツール\)](../../../docs/framework/tools/storeadm-exe-isolated-storage-tool.md)  
+ 分離ストレージを管理します。ユーザーのストアの一覧表示や削除を行うためのオプションが用意されています。  
+  
+ [Tlbexp.exe \(タイプ ライブラリ エクスポーター\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)  
+ 共通言語ランタイム アセンブリで定義されている型を記述するタイプ ライブラリを生成します。  
+  
+ [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)  
+ COM タイプ ライブラリ内の型定義を、共通言語ランタイム アセンブリで等価な定義に変換します。  
+  
+ [Winmdexp.exe \(Windows ランタイム メタデータのエクスポート ツール\)](../../../docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md)  
+ .winmdobj ファイルとしてコンパイルされた .NET Framework アセンブリを Windows ランタイム コンポーネントにエクスポートします。このコンポーネントは、Windows ランタイム メタデータと実装情報の両方を含む .winmd ファイルとしてパッケージされたものです。  
+  
+ [Winres.exe \(Windows フォーム リソース エディター\)](../../../docs/framework/tools/winres-exe-windows-forms-resource-editor.md)  
+ Windows フォームで使用されるユーザー インターフェイス \(UI\) リソース \(.resx ファイルまたは .resources ファイル\) のローカライズを支援します。 文字列を翻訳した後、ローカライズされた文字列に合わせて、コントロールのサイズを変更したり、コントロールを移動したり、非表示にしたりできます。  
+  
+## 関連項目  
+ [Tools](../Topic/WPF%20Tools.md)  
+ isXPS 適合性ツール \(isXPS.exe\)、パフォーマンス プロファイリング ツール、XamlPad などのツールを含みます。XamlPad は Extensible Application Markup Language \(XAML\) 用の基本的なビジュアル エディターです。  
+  
+ [Windows Communication Foundation ツール](../../../docs/framework/wcf/tools.md)  
+ WCF \(Windows Communication Foundation\) アプリケーションの作成、配置、および管理を効率化するツールを含みます。
\ No newline at end of file
diff --git a/docs/framework/tools/installutil-exe-installer-tool.md b/docs/framework/tools/installutil-exe-installer-tool.md
new file mode 100644
index 00000000000..ea49a52a631
--- /dev/null
+++ b/docs/framework/tools/installutil-exe-installer-tool.md
@@ -0,0 +1,178 @@
+---
+title: "Installutil.exe (インストーラー ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "ファイル, インストーラー ツール"
+  - "インストールの進行状況レポート"
+  - "インストーラー ツール"
+  - "インストール (サーバー リソースの)"
+  - "Installutil.exe"
+  - "進行状況に関する情報 (インストールの)"
+  - "削除 (サーバー リソースを)"
+  - "レポート (インストールの進行状況の)"
+  - "ステータス情報 (インストールの)"
+  - "アンインストール (サーバー リソースの)"
+ms.assetid: 3f9d0533-f895-4897-b4ea-528284e0241d
+caps.latest.revision: 40
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 38
+---
+# Installutil.exe (インストーラー ツール)
+インストーラー ツールは、指定したアセンブリ内のインストーラー コンポーネントを実行することによってサーバー リソースのインストールとアンインストールを実行できるコマンド ライン ユーティリティです。  このツールは、<xref:System.Configuration.Install> 名前空間のクラスと組み合わせることによって動作します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+installutil [/u[ninstall]] [options] assembly [[options] assembly] ...   
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|`assembly`|インストーラー コンポーネントを実行するアセンブリのファイル名。  `/AssemblyName` オプションを使用してアセンブリの厳密な名前を指定する場合は、このパラメーターを省略します。|  
+  
+<a name="options"></a>   
+## オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/h[elp]`<br /><br /> または<br /><br /> `/?`|このツールのコマンド構文とオプションを表示します。|  
+|`/help` *assembly*<br /><br /> または<br /><br /> `/?` *assembly*|InstallUtil.exe のコマンド構文とオプションと共に、指定したアセンブリ内でそれぞれのインストーラーによって認識される追加オプションを表示します。  このオプションを指定すると、各インストーラー コンポーネントの <xref:System.Configuration.Install.Installer.HelpText%2A?displayProperty=fullName> プロパティによって返されるテキストが InstallUtil.exe のヘルプ テキストに追加されます。|  
+|`/AssemblyName`"*assemblyName*<br /><br /> ,バージョン\=4.5*major.minor.build.revision*<br /><br /> ,カルチャ\=*locale*<br /><br /> ,PublicKeyToken\=*publicKeyToken*"|グローバル アセンブリ キャッシュに登録されている必要があるアセンブリの厳密な名前を指定します。  アセンブリ名は、バージョン、カルチャ、およびアセンブリの公開キー トークンによって完全修飾にする必要があります。  完全修飾名は、引用符で囲む必要があります。<br /><br /> たとえば、"myAssembly, Culture\=neutral, PublicKeyToken\=0038abc9deabfle5, Version\=4.0.0.0" は、完全修飾のアセンブリ名です。|  
+|`/InstallStateDir=[` *directoryName* `]`|アセンブリをアンインストールするために使用されるデータを格納する .InstallState ファイルのディレクトリを指定します。  既定のディレクトリは、アセンブリを格納しているディレクトリです。|  
+|`/LogFile=`\[*filename*\]|インストールの進行状況を記録するログ ファイルの名前を指定します。  既定では、`/LogFile` オプションを省略した場合は、*assemblyname*.InstallLog という名前のログ ファイルが作成されます。  *filename* を省略した場合、ログ ファイルは生成されません。|  
+|`/LogToConsole`\={`true`&#124;`false`}|`true` の場合は出力がコンソールに表示されます。  `false` \(既定値\) の場合はコンソールへの出力が中止されます。|  
+|`/ShowCallStack`|インストール中に例外が発生した場合、コール スタックがログ ファイルに出力されます。|  
+|`/u`\[`ninstall`\]|指定されたアセンブリをアンインストールします。  他のオプションとは異なり、コマンド ラインのどこにオプションを指定するかとは無関係に、`/u` はすべてのアセンブリに適用されます。|  
+  
+<a name="cmdline"></a>   
+## その他のインストーラー オプション  
+ アセンブリ内で使用されるそれぞれのインストーラーでは、「[オプション](#options)」で示したオプション以外のオプションも認識される場合があります。  これらのオプションを確認するには、コマンド ラインで `/?` オプションまたは `/help` オプションと共にアセンブリのパスを指定して InstallUtil.exe を実行します。  これらのオプションを指定するには、InstallUtil.exe で認識されるオプションと共にそれらのオプションをコマンド ラインに含めます。  
+  
+> [!NOTE]
+>  個々のインストーラー コンポーネントでサポートされるオプションのヘルプ テキストは、<xref:System.Configuration.Install.Installer.HelpText%2A?displayProperty=fullName> プロパティによって返されます。  コマンド ラインで入力された個々のオプションには、<xref:System.Configuration.Install.Installer.Context%2A?displayProperty=fullName> プロパティからプログラムでアクセスできます。  
+  
+ オプションとコマンド ライン パラメーターはすべてインストール ログ ファイルに書き込まれます。  ただし、一部のインストーラー コンポーネントで認識される `/Password` パラメーターを使用する場合、パスワード情報は 8 つのアスタリスク \(\*\) に置き換えられ、ログ ファイルに表示されません。  
+  
+> [!IMPORTANT]
+>  インストーラーに渡されるパラメーターには機密情報または個人を特定できる情報が含まれる場合があり、既定ではプレーンテキスト ログ ファイルに書き込まれます。  この動作を回避するには、コマンド ラインで Installutil.exe の後に \(*filename* 引数を指定せずに\) `/LogFile=` を指定して、ログ ファイルが生成されないようにします。  
+  
+## 解説  
+ .NET Framework アプリケーションは、従来のプログラム ファイルと関連リソースで構成されます。関連リソースには、メッセージ キュー、イベント ログ、パフォーマンス カウンターなどがあり、アプリケーションを配置するときにこれらのリソースを作成する必要があります。  アセンブリのインストーラー コンポーネントを使用すると、アプリケーションのインストール時にこれらのリソースを作成したり、アプリケーションのアンインストール時に削除したりできます。  Installutil.exe は、これらのインストーラー コンポーネントを検出して実行します。  
+  
+ 同じコマンド行に複数のアセンブリを指定できます。  アセンブリ名の前に指定したオプションは、そのアセンブリのインストールに適用されます。  `/u` と `/AssemblyName` 以外のオプションは、累積されますがオーバーライドできます。  つまり、あるアセンブリに指定したオプションは、そのオプションを新しい値と共に指定しない限り、後続のすべてのアセンブリに適用されます。  
+  
+ オプションを指定せずにアセンブリに対して Installutil.exe を実行すると、次の 3 つのファイルがアセンブリのディレクトリ内に作成されます。  
+  
+-   InstallUtil.InstallLog \- インストールの進行状況に関する一般的な説明が含まれます。  
+  
+-   *assemblyname*.InstallLog \- インストール プロセスのコミット フェーズに固有の情報が含まれます。  コミット フェーズの詳細については、「<xref:System.Configuration.Install.Installer.Commit%2A> メソッド」を参照してください。  
+  
+-   *assemblyname*.InstallState \- アセンブリをアンインストールするために使用されるデータが含まれます。  
+  
+ Installutil.exe は、リフレクションを使用して指定されたアセンブリを調査し、<xref:System.ComponentModel.RunInstallerAttribute?displayProperty=fullName> 属性が `true` に設定されたすべての <xref:System.Configuration.Install.Installer> タイプを検索します。  次に、<xref:System.Configuration.Install.Installer> タイプの各インスタンスについて、<xref:System.Configuration.Install.Installer.Install%2A?displayProperty=fullName> メソッドまたは <xref:System.Configuration.Install.Installer.Uninstall%2A?displayProperty=fullName> メソッドを実行します。  Installutil.exe は、トランザクション的な方法でインストールを実行します。つまり、いずれかのアセンブリのインストールに失敗した場合には、他のすべてのアセンブリのインストールをロールバックします。  アンインストールはトランザクション的な方法では実行されません。  
+  
+ Installutil.exe では、遅延署名されたアセンブリのインストールおよびアンインストールはできませんが、厳密な名前付きアセンブリのインストールおよびアンインストールはできます。  
+  
+ .NET Framework Version 2.0 から、32 ビット バージョンの共通言語ランタイム \(CLR\) は 32 ビット バージョンのインストーラー ツールにのみ付属し、64 ビット バージョンの CLR は 32 ビットおよび 64 ビットの両方のバージョンのインストーラー ツールに付属するようになりました。  64 ビットの CLR を使用しているときは、32 ビットのアセンブリをインストールするには 32 ビットのインストーラーを使用し、64 ビットおよび Microsoft Intermediate Language \(MSIL\) のアセンブリをインストールするには 64 ビットのインストーラーを使用します。  どちらのバージョンのインストーラー ツールも同様に動作します。  
+  
+ C\+\+ を使用して作成した Windows サービスを Installutil.exe で配置することはできません。Installutil.exe は、C\+\+ コンパイラで作成される埋め込みのネイティブ コードを認識できません。  C\+\+ Windows サービスを Installutil.exe で配置しようとすると、<xref:System.BadImageFormatException> などの例外がスローされます。  これを行うには、サービス コードを C\+\+ モジュールに移行し、インストーラー オブジェクトを C\# または Visual Basic で記述します。  
+  
+## 例  
+ InstallUtil.exe のコマンド構文とオプションの説明を表示するコマンドを次に示します。  
+  
+```  
+installutil /?  
+```  
+  
+ InstallUtil.exe のコマンド構文とオプションの説明を表示するコマンドを次に示します。  インストーラーの <xref:System.Configuration.Install.Installer.HelpText%2A?displayProperty=fullName> プロパティにヘルプ テキストが割り当てられている場合は、`myAssembly.exe` のインストーラー コンポーネントでサポートされるオプションの説明とリストも表示されます。  
+  
+```  
+installutil /? myAssembly.exe  
+```  
+  
+ アセンブリ `myAssembly.exe` 内のインストーラー コンポーネントを実行するコマンドを次に示します。  
+  
+```  
+installutil myAssembly.exe  
+```  
+  
+ `/AssemblyName` スイッチと完全修飾名を使用してアセンブリのインストーラー コンポーネントを実行するコマンドを次に示します。  
+  
+```  
+installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"  
+```  
+  
+ ファイル名で指定されたアセンブリと厳密な名前で指定されたアセンブリのインストーラー コンポーネントを実行するコマンドを次に示します。  `/AssemblyName` オプションはオーバーライドできないので、コマンド ラインではファイル名で指定するすべてのアセンブリを厳密な名前で指定するアセンブリよりも前に記述する必要があります。  
+  
+```  
+installutil myAssembly.exe /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"  
+```  
+  
+ アセンブリ `myAssembly.exe` 内のアンインストーラー コンポーネントを実行するコマンドを次に示します。  
+  
+```  
+installutil /u myAssembly.exe   
+```  
+  
+ アセンブリ `myAssembly1.exe` および `myAssembly2.exe` 内のアンインストーラー コンポーネントを実行するコマンドを次に示します。  
+  
+```  
+installutil myAssembly1.exe /u myAssembly2.exe  
+```  
+  
+ コマンド ラインでの `/u` オプションの位置は重要ではないので、これは次のコマンドと同等です。  
+  
+```  
+installutil /u myAssembly1.exe myAssembly2.exe  
+```  
+  
+ アセンブリ `myAssembly.exe` 内のインストーラーを実行し、進行状況に関する情報を `myLog.InstallLog` に書き込むように指定するコマンドを次に示します。  
+  
+```  
+installutil /LogFile=myLog.InstallLog myAssembly.exe   
+```  
+  
+ アセンブリ `myAssembly.exe` 内のインストーラーを実行し、進行状況に関する情報を `myLog.InstallLog` に書き込むように指定し、インストーラーのカスタム オプション `/reg` を使用してシステム レジストリを更新するように指定するコマンドを次に示します。  
+  
+```  
+installutil /LogFile=myLog.InstallLog /reg=true myAssembly.exe  
+```  
+  
+ アセンブリ `myAssembly.exe` 内のインストーラーを実行し、インストーラーのカスタム オプション `/email` を使用してユーザーの電子メール アドレスを指定し、ログ ファイルに出力しないようにするコマンドを次に示します。  
+  
+```  
+installutil /LogFile= /email=admin@mycompany.com myAssembly.exe  
+```  
+  
+ `myAssembly.exe` に関するインストールの進行状況を `myLog.InstallLog` に書き込み、`myTestAssembly.exe` に関する進行状況を `myTestLog.InstallLog` に書き込むコマンドを次に示します。  
+  
+```  
+installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe  
+```  
+  
+## 参照  
+ <xref:System.Configuration.Install>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/lc-exe-license-compiler.md b/docs/framework/tools/lc-exe-license-compiler.md
new file mode 100644
index 00000000000..b7f7add7287
--- /dev/null
+++ b/docs/framework/tools/lc-exe-license-compiler.md
@@ -0,0 +1,112 @@
+---
+title: "Lc.exe (ライセンス コンパイラ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".licenses ファイル"
+  - ".licx ファイル"
+  - "コンパイル (licenses ファイルの)"
+  - "コントロールのライセンス [Windows フォーム]"
+  - "Lc.exe"
+  - "ライセンス コンパイラ"
+  - "ライセンス ファイル"
+  - "ライセンスされたコントロール [Windows フォーム]"
+  - "Windows フォーム, コントロールのライセンス"
+ms.assetid: 2de803b8-495e-4982-b209-19a72aba0460
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Lc.exe (ライセンス コンパイラ)
+ライセンス コンパイラは、ライセンス情報を含むテキスト ファイルを読み込んで、バイナリ ファイルを生成します。このバイナリ ファイルは、リソースとして共通言語ランタイムの実行可能ファイルに埋め込むことができます。  
+  
+ .licx テキスト ファイルは、ライセンスされたコントロールがフォームに追加されると、Windows フォーム デザイナーによって自動的に生成または更新されます。  プロジェクト システムは、コンパイルの過程で、.licx テキスト ファイルを、.NET のコントロール ライセンス サポートを提供する .licenses バイナリのリソースに変換します。  バイナリのリソースは、その後、プロジェクト出力に埋め込まれます。  
+  
+ プロジェクトをビルドするときにライセンス コンパイラを使用した場合は、32 ビットと 64 ビットの間のクロス コンパイルはサポートされません。  これは、ライセンス コンパイラはアセンブリを読み込む必要があり、32 ビット アプリケーションからの 64 ビット アセンブリの読み込みおよびその逆は、許可されないためです。  この場合は、コマンド ラインからライセンス コンパイラを使用して手動でライセンスをコンパイルし、対応するアーキテクチャを指定します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+        lc /target:  
+        targetPE /complist:filename [/outdir:path]  
+/i:modules [/nologo] [/v]  
+```  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/complist:** *filename*|.licenses ファイルに組み込むライセンス付きコンポーネントの一覧を含むファイルの名前を指定します。  各コンポーネントを参照するにはフルネームを使用し、各行にコンポーネントを 1 つだけ指定します。<br /><br /> コマンド行を使用する場合は、プロジェクトに属するフォームごとに個別のファイルを指定できます。  Lc.exe は複数の入力ファイルを受け付けて、1 つの .licenses ファイルを生成します。|  
+|**\/h**\[**elp**\]|このツールのコマンド構文とオプションを表示します。|  
+|**\/i:** *module*|**\/complist** ファイル内に一覧表示されたコンポーネントを含むモジュールを指定します。  複数のモジュールを指定するには、複数の **\/i** フラグを使用します。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/outdir:** *path*|出力 .licenses ファイルを格納するディレクトリを指定します。|  
+|**\/target:** *targetPE*|.licenses ファイルを生成する実行可能ファイルを指定します。|  
+|**\/v**|詳細出力モードを指定します。コンパイルの進行状況に関する情報が表示されます。|  
+|**@** *file*|応答 \(.rsp\) ファイルを指定します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 使用例  
+  
+1.  `HostApp.exe` という名前のアプリケーション内の `Samples.DLL` に格納されているライセンス付きコントロール `MyCompany.Samples.LicControl1` を使用すると、次の内容を含む `HostAppLic.txt` を作成できます。  
+  
+    ```  
+    MyCompany.Samples.LicControl1, Samples.DLL  
+    ```  
+  
+2.  `HostApp.exe.licenses` という名前の .licenses ファイルを次のコマンドで作成します。  
+  
+    ```  
+    lc /target:HostApp.exe /complist:hostapplic.txt /i:Samples.DLL /outdir:c:\bindir  
+    ```  
+  
+3.  この .licenses ファイルをリソースとして含む  `HostApp.exe` を作成します。  C\# アプリケーションを作成していた場合は、次のコマンドを使用してアプリケーションを作成します。  
+  
+    ```  
+    csc /res:HostApp.exe.licenses /out:HostApp.exe *.cs  
+    ```  
+  
+ `myApp.licenses`、`hostapplic.txt`、および `hostapplic2.txt` で指定されるライセンス付きコンポーネントの一覧から `hostapplic3.txt` をコンパイルするコマンドを次に示します。  引数 `modulesList` によって、ライセンス付きコンポーネントを含むモジュールを指定します。  
+  
+```  
+lc /target:myApp /complist:hostapplic.txt /complist:hostapplic2.txt /complist: hostapplic3.txt /i:modulesList  
+```  
+  
+## 応答ファイルの例  
+ 次のリストは、`response.rsp` 応答ファイルの例を示しています。  応答ファイルの詳細については、「[Response Files](../Topic/MSBuild%20Response%20Files.md)」をご覧ください。  
+  
+```  
+/target:hostapp.exe  
+/complist:hostapplic.txt   
+/i:WFCPrj.dll   
+/outdir:"C:\My Folder"  
+  
+```  
+  
+ 次のコマンドラインで、この `response.rsp` ファイルを使用します。  
+  
+```  
+lc @response.rsp  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md b/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md
new file mode 100644
index 00000000000..159372099ae
--- /dev/null
+++ b/docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md
@@ -0,0 +1,209 @@
+---
+title: "Mage.exe (マニフェストの生成および編集ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "マニフェストの生成および編集ツール"
+  - "Mage.exe"
+ms.assetid: 77dfe576-2962-407e-af13-82255df725a1
+caps.latest.revision: 68
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# Mage.exe (マニフェストの生成および編集ツール)
+マニフェストの生成および編集ツール \(Mage.exe\) は、アプリケーション マニフェストおよび配置マニフェストの作成と編集をサポートするコマンド ライン ツールです。 コマンド ライン ツールであるため、Mage.exe は、バッチ スクリプトから実行することも、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションなど他の Windows ベースのアプリケーションから実行することもできます。  
+  
+ Mage.exe の代わりに、グラフィカルなアプリケーション プログラムである MageUI.exe を使用することもできます。 詳細については、「[MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)」を参照してください。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。 このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] セットアップには、2 つのバージョンの Mage.exe および MageUI.exe がコンポーネントとして含まれています。 バージョン情報を確認するには、MageUI.exe を実行し、**\[ヘルプ\]** をクリックして、**\[バージョン情報\]** をクリックします。 このドキュメントでは、バージョン 4.0.x.x の Mage.exe および MageUI.exe について説明します。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+Mage [commands] [commandOptions]  
+```  
+  
+#### パラメーター  
+ 次の表に、Mage.exe でサポートされているコマンドを示します。 これらのコマンドでサポートされるオプションの詳細については、「[New コマンド オプションと Update コマンド オプション](#NewUpdate)」および「[Sign コマンド オプション](#Sign)」を参照してください。  
+  
+|コマンド|説明|  
+|----------|--------|  
+|**\-cc, ClearApplicationCache**|すべてのオンライン専用アプリケーションのダウンロード アプリケーション キャッシュをクリアします。|  
+|**\-n, \-New** *fileType \[newOptions\]*|指定された種類のファイルを新規作成します。 有効な種類は、次のとおりです。<br /><br /> -   \[`Deployment`\] : 配置マニフェストを新規作成します。<br />-   \[`Application`\] : アプリケーション マニフェストを新規作成します。<br /><br /> このコマンドで他のパラメーターを指定しなかった場合は、適切な既定のタグおよび属性値を使用して、適切な種類のファイルが作成されます。<br /><br /> **\-ToFile** オプション \(次の表を参照\) を使用して、新しいファイルの名前とパスを指定します。<br /><br /> マニフェストの \<dependency\> セクションに追加されたアプリケーション用のすべてのアセンブリを使用して、アプリケーション マニフェストを作成する場合は、**\-FromDirectory** オプション \(次の表を参照\) を使用します。|  
+|**\-u, \-Update** *\[filePath\] \[updateOptions\]*|1 つ以上の変更をマニフェスト ファイルに加えます。 編集中のファイルの種類を指定する必要はありません。 Mage.exe は、一連のヒューリスティックを使用してファイルを調査し、配置マニフェストであるのか、アプリケーション マニフェストであるのかを判定します。<br /><br /> ファイルが証明書で署名済みの場合に **\-Update** を指定すると、キー署名ブロックが削除されます。 これは、キー署名にはファイルのハッシュが含まれているため、ファイルを変更するとハッシュが無効になるためです。<br /><br /> **\-ToFile** オプション \(次の表を参照\) を使用して、既存のテキストに上書きするのではなく、新しいファイルの名前とパスを指定します。|  
+|**\-s, \-Sign** `[signOptions]`|キー ペアまたは X509 証明書を使用してファイルに署名します。 署名は、XML 要素としてファイルに挿入されます。<br /><br /> **\-TimestampUri** 値を指定するマニフェストに署名するときには、インターネットに接続している必要があります。|  
+|**\-h, \-?, \-Help** *\[verbose\]*|使用可能なすべてのコマンドおよびそのオプションの説明が表示されます。`verbose` を指定して、詳細なヘルプを表示します。|  
+  
+<a name="NewUpdate"></a>   
+## New コマンド オプションと Update コマンド オプション  
+ 次の表は、`-New` コマンドおよび `-Update` コマンドでサポートされているオプションを示しています。  
+  
+|オプション|既定値|対象|説明|  
+|-----------|---------|--------|--------|  
+|**\-a, \-Algorithm**|sha1RSA|アプリケーション マニフェスト<br /><br /> 配置マニフェスト|アルゴリズムの依存関係のダイジェストを生成するように指定します。 値は、"sha256RSA" または "sha1RSA" であることが必要です。<br /><br /> "\-Update" オプションでのみ使用します。 "\-Sign" オプションを使用した場合、このオプションは無視されます|  
+|**\-appc, \-AppCodeBase** `manifestReference`||配置マニフェスト|アプリケーション マニフェスト ファイルへの URL またはファイル パス参照を挿入します。 この値は、アプリケーション マニフェストへの完全パスである必要があります。|  
+|**\-appm, \-AppManifest** `manifestPath`||配置マニフェスト|配置のアプリケーション マニフェストへの参照を、その配置マニフェストに挿入します。<br /><br /> `manifestPath` に指定したファイルは存在する必要があります。存在しない場合、Mage.exe はエラーを発行します。`manifestPath` の参照先のファイルがアプリケーション マニフェストでない場合、Mage.exe はエラーを発行します。|  
+|**\-cf, \-CertFile** `filePath`||すべてのファイルの種類|マニフェストに署名するための X509 デジタル証明書の場所を指定します。 証明書にパスワードが必要な場合は、このオプションを **\-Password** オプションと共に使用できます。|  
+|**\-ch, \-CertHash** `hashSignature`||すべてのファイルの種類|クライアント コンピューターの個人証明書ストアに格納されているデジタル証明書のハッシュです。 これは、Windows の証明書コンソールに表示されるデジタル証明書のサムプリント文字列に対応しています。<br /><br /> `hashSignature` には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット \(8 ビット\) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。|  
+|**\-fd, \-FromDirectory** `directoryPath`||アプリケーション マニフェスト|`directoryPath` およびそのすべてのサブディレクトリで見つかったすべてのアセンブリとファイルの説明を含んでいるアプリケーション マニフェストを作成します。ここで、`directoryPath` は、配置対象のアプリケーションが格納されているディレクトリです。 Mage.exe では、ディレクトリ内のファイルごとに、そのファイルがアセンブリなのかスタティック ファイルなのかが判断されます。 アセンブリの場合は、`<dependency>` タグおよび `installFrom` 属性が、アセンブリ名、コード ベースおよびバージョンと共に、アプリケーションに追加されます。 スタティック ファイルの場合は、`<file>` タグが追加されます。 また、Mage.exe は、簡単な一連のヒューリスティックによってアプリケーションのメイン実行可能モジュールを検出し、この実行可能モジュールを ClickOnce アプリケーションのエントリ ポイントとしてマニフェストでマークします。<br /><br /> Mage.exe では、ファイルが "データ" ファイルとして自動的にマークされることはありません。 これは手動で行う必要があります。 詳細については、「[方法 : ClickOnce アプリケーションにデータ ファイルを含める](../Topic/How%20to:%20Include%20a%20Data%20File%20in%20a%20ClickOnce%20Application.md)」を参照してください。<br /><br /> Mage.exe では、各ファイルのサイズに基づいて、各ファイルのハッシュも生成されます。 ClickOnce では、マニフェスト作成後に、配置の各ファイルが改ざんされていないことを確認するためにこれらのハッシュを使用します。 配置対象のファイルに変更を加えた場合には、Mage.exe を **\-Update** コマンドおよび **\-FromDirectory** オプションを付けて実行すると、参照している全ファイルのハッシュおよびアセンブリ バージョンを更新できます。<br /><br /> **\-FromDirectory** を指定すると、`directoryPath` で見つかった全サブディレクトリの全ファイルが含まれます。<br /><br /> **\-FromDirectory** を **\-Update** コマンドと共に使用すると、アプリケーション マニフェスト内のファイルのうち、このディレクトリに存在しなくなったファイルが Mage.exe によってマニフェストから削除されます。|  
+|**\-if, \-IconFile**  `filePath`||アプリケーション マニフェスト|.ICO アイコン ファイルの完全パスを指定します。 このアイコンは、\[スタート\] メニューおよび \[プログラムの追加と削除\] エントリのアプリケーション名の横に表示されます。 アイコンを指定しない場合は、既定のアイコンが使用されます。|  
+|**\-ip, \-IncludeProviderURL**  `url`|true|配置マニフェスト|**\-ProviderURL** で設定された更新プログラムの場所の値が配置マニフェストに含まれているかどうかを示します。|  
+|**\-i, \-Install** `willInstall`|true|配置マニフェスト|ClickOnce アプリケーションをローカル コンピューターにインストールするのか、Web サイトで実行するのかを指定します。 アプリケーションをインストールすると、アプリケーションは Windows の **\[スタート\]** メニューに表示されます。 有効な値は、"true" または "t"、および "false" または "f" です。<br /><br /> **\-MinVersion** オプションを指定し、ユーザーが **\-MinVersion** より前のバージョンをインストールしていた場合は、**\-Install** に渡した値に関係なく、アプリケーションがインストールされます。<br /><br /> このオプションは、**\-BrowserHosted** オプションと一緒に使用することはできません。 1 つのマニフェストに両方のオプションを使用しようとすると、エラーが発生します。|  
+|**\-mv, \-MinVersion**  `[version]`|**\-Version** フラグで指定された、ClickOnce 配置マニフェストに示されたバージョン。|配置マニフェスト|ユーザーが実行できる、このアプリケーションの最小バージョンです。 このフラグで指定したバージョンが、アプリケーションの最低限必要なバージョンになります。 大幅に変更された更新プログラムを含むバージョンや、重大なセキュリティ問題を解決したバージョンの製品をリリースした場合に、このフラグを使用すると、この更新バージョンを必ずインストールするように指定でき、ユーザーは古いバージョンを実行できなくなります。<br /><br /> `version` は、**\-Version** フラグの引数と同じ意味を持ちます。|  
+|**\-n, \-Name** `nameString`|配置|すべてのファイルの種類|アプリケーションを識別するための名前です。 ClickOnce では、**\[スタート\]** メニュー \(アプリケーションをインストールする場合\) や \[Permission Elevation\] ダイアログ ボックスでこのアプリケーションを示す名前として、この名前が使用されます。 **Note:**  既存のマニフェストを更新するときにこのオプションで発行者名を指定しない場合、Mage.exe はコンピューターで定義された組織名でマニフェストを更新します。 別の名前を使用するには、必ずこのオプションを使用して希望する発行者名を指定してください。|  
+|**\-pwd, \-Password** `passwd`||すべてのファイルの種類|デジタル証明書でマニフェストに署名する場合に使用するパスワードです。**\-CertFile** オプションと共に使用する必要があります。|  
+|**\-p, Processor** `processorValue`|Msil|アプリケーション マニフェスト<br /><br /> 配置マニフェスト|このアプリケーションを実行するマイクロプロセッサのアーキテクチャです。 特定のマイクロプロセッサ用にアセンブリがプリコンパイルされている、1 つ以上のアプリケーションを配置する場合は、この値を指定する必要があります。 有効な値には、`msil`、`x86`、`ia64`、および `amd64` があります。`msil` \(Microsoft Intermediate Language\) は、すべてのアセンブリがどのプラットフォームにも依存していないことを示します。この場合、共通言語ランタイム \(CLR: Common Language Runtime\) は、アプリケーションの最初の実行時にアセンブリの Just\-In\-Time コンパイルを行います。|  
+|**\-pu,** **\-ProviderURL** `url`||配置マニフェスト|ClickOnce でアプリケーションの更新プログラムのチェックを行う場合に参照する URL を指定します。|  
+|**\-pub, \-Publisher** `publisherName`||アプリケーション マニフェスト<br /><br /> 配置マニフェスト|配置マニフェストとアプリケーション マニフェストのいずれかの description 要素に発行者名を追加します。 アプリケーション マニフェストで使用する場合、**\-UseManifestForTrust** も指定する必要があります \(値は "true" または "t" に設定します\)。指定しないと、エラーが発生します。|  
+|**\-s, \-SupportURL**  `url`||アプリケーション マニフェスト<br /><br /> 配置マニフェスト|\[プログラムの追加と削除\] で、ClickOnce アプリケーションのエントリに表示されるリンクを指定します。|  
+|**\-ti, \-TimestampUri** `uri`||アプリケーション マニフェスト<br /><br /> 配置マニフェスト|デジタル タイムスタンプ サービスの URL です。 マニフェストにタイムスタンプを設定すると、マニフェストに再署名することを防止できますが、アプリケーションの次のバージョンを配置する前にデジタル証明書の有効期限が切れるようにする必要があります。 詳細については、[Windows ルート証明書プログラムのメンバー](http://go.microsoft.com/fwlink/?LinkId=159000)を参照してください。|  
+|**\-t, \-ToFile** `filePath`|-   新規 :<br />-   配置マニフェストの場合 : deploy.application<br />-   アプリケーション マニフェストの場合 : application.exe.manifest<br />-   Update コマンド オプション :<br />-   入力ファイル|すべてのファイルの種類|作成または変更されたファイルの出力パスを指定します。<br /><br /> **\-New** を使用するときに **\-ToFile** を指定しなかった場合、出力ファイルは現在の作業ディレクトリに書き込まれます。**\-Update** を使用する場合に **\-ToFile** を指定しなかった場合、Mage.exe では、入力ファイルにファイルが書き戻されます。|  
+|**\-tr, \-TrustLevel** `level`|アプリケーション URL が存在するゾーンに基づいて。|アプリケーション マニフェスト|クライアント コンピューター上のアプリケーションに与える信頼のレベルです。 有効な値には、"Internet"、"Intranet"、および "FullTrust" が含まれます。|  
+|**\-um, \-UseManifestForTrust** `willUseForTrust`|False|アプリケーション マニフェスト|アプリケーションをクライアントで実行するときに、アプリケーション マニフェストのデジタル署名を信頼の決定に使用するかどうかを指定します。 "true" または "t" を指定すると、信頼の決定にアプリケーション マニフェストが使用されます。 "false" または "f" を指定すると、信頼の決定に配置マニフェストの署名が使用されます。|  
+|**\-v, \-Version** `versionNumber`|1.0.0.0|アプリケーション マニフェスト<br /><br /> 配置マニフェスト|配置のバージョンです。 引数は "*N.N.N.N*" という形式の有効なバージョン文字列である必要があります。ここで "*N*" は、32 ビット符号なし整数です。|  
+|**\-wpf, \-WPFBrowserApp**  `isWPFApp`|false|アプリケーション マニフェスト<br /><br /> 配置マニフェスト|このフラグは、アプリケーションが Internet Explorer の内部でホストされ、スタンドアロンの実行可能ファイルではない Windows Presentation Foundation \(WPF\) アプリケーションである場合にのみ使用します。 有効な値は、"true" または "t"、および "false" または "f" です。<br /><br /> アプリケーション マニフェストの場合、そのアプリケーション マニフェストの `hostInBrowser` 要素に `entryPoint` 属性を追加します。<br /><br /> 配置マニフェストの場合、`install` 要素の `deployment` 属性に false を設定し、.xbap 拡張子を指定して配置マニフェストを保存します。 この引数を **\-Install** 引数と共に指定すると、ブラウザーによってホストされるアプリケーションをインストールできず、アプリケーションがオフラインになるため、エラーが発生します。|  
+  
+<a name="Sign"></a>   
+## Sign コマンド オプション  
+ 次の表は、`-Sign` コマンドでサポートされているオプションを示しています。このコマンドは、すべての種類のファイルに適用されます。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\-cf, \-CertFile** `filePath`|マニフェストに署名するための証明書の場所を指定します。 このオプションは **\-Password** オプションと共に使用できます。|  
+|**\-ch, \-CertHash** `hashSignature`|クライアント コンピューターの個人証明書ストアに格納されているデジタル証明書のハッシュです。 これは、Windows の証明書コンソールに表示されるデジタル証明書の拇印プロパティに対応しています。<br /><br /> `hashSignature` には、大文字も小文字も使用できます。また、1 つの文字列で指定することも、サムプリント文字の各オクテット \(8 ビット\) を空白で区切り、サムプリント全体を引用符で囲んで指定することもできます。|  
+|**\-pwd, \-Password** `passwd`|デジタル証明書でマニフェストに署名する場合に使用するパスワードです。**\-CertFile** オプションと共に使用する必要があります。|  
+|**\-t, \-ToFile** `filePath`|作成または変更されたファイルの出力パスを指定します。|  
+  
+## 解説  
+ Mage.exe では、どの引数も大文字と小文字が区別されません。 コマンドおよびオプションの前には、ダッシュ \(\-\) またはスラッシュ \(\/\) を付けることができます。  
+  
+ **\-Sign** コマンドと共に使用できる引数は、すべて、**\-New** コマンドまたは **\-Update** コマンドでも、常に使用できます。 次のコマンドは同等です。  
+  
+```  
+mage -Sign c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx  
+mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx  
+```  
+  
+ 署名済みのファイルでは、文書のシグネチャが有効であるかどうかがファイルのハッシュによって確認されるため、署名は最後に行う必要があります。 署名済みのファイルに変更を加えた場合には、再度署名する必要があります。 署名済みの文書に再度署名した場合、Mage.exe では、古い署名が新しい署名で置換されます。  
+  
+ **\-AppManifest** オプションを使用して配置マニフェストを作成した場合、Mage.exe は、配置マニフェストと同じディレクトリにアプリケーション マニフェストが存在し、サブディレクトリには現在の配置のバージョンから名前が付けてあると仮定して、配置マニフェストを適切に構成します。 アプリケーション マニフェストを別の場所に格納する場合は、**\-AppCodeBase** オプションを使用して、他の場所を設定します。  
+  
+ 配置マニフェストおよびアプリケーション マニフェストは、アプリケーションを配置する前に、署名される必要があります。 マニフェストに署名する方法については、「[信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)」を参照してください。  
+  
+ アプリケーション マニフェストに **\-TrustLevel** オプションを指定すると、アプリケーションをクライアント コンピューターで実行するために必要なアクセス許可セットが表示されます。 既定では、アプリケーションの URL が存在する*ゾーン*に基づいてアプリケーションに信頼レベルが割り当てられます。 会社のネットワーク上にアプリケーションを配置する場合、アプリケーションは通常、イントラネット ゾーンに格納されます。一方、インターネット上にアプリケーションを配置する場合には、インターネット ゾーンに格納されます。 どちらのセキュリティ ゾーンでも、アプリケーションからローカル リソースへのアクセスは制限されますが、イントラネット ゾーンはインターネット ゾーンに比べ、制限が少し緩くなっています。 FullTrust ゾーンのアプリケーションの場合には、コンピューターのローカル リソースに制限なしでアクセスできます。**\-TrustLevel** オプションを使用してアプリケーションのゾーンを指定すると、高いレベルの信頼を与えるかどうかを決定するように求めるメッセージが、CLR の Trust Manager コンポーネントによってユーザーに表示されます。 会社のネットワーク上にアプリケーションを配置する場合は、信頼されたアプリケーションの配置を使用すると、ユーザーにメッセージで確認することなく、アプリケーションの信頼レベルを引き上げることができます。  
+  
+ アプリケーション マニフェストでは、カスタム信頼セクションもサポートされています。 この機能では、アプリケーションの実行に必要な特定のアクセス許可だけを要求するマニフェストを構成できるため、最低限のアクセス許可を要求するセキュリティ プリンシパルにアプリケーションを従わせることができます。 Mage.exe では、カスタム信頼セクションの追加は直接サポートされていません。 これを追加するには、テキスト エディター、XML パーサー、またはグラフィカルなツールである MageUI.exe を使用してください。 MageUI.exe を使用してカスタム信頼セクションを追加する方法の詳細については、「[MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)」を参照してください。  
+  
+ [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] に含まれているバージョン 4 の Mage.exe で作成される新しいマニフェストは、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とします。 旧バージョンの .NET Framework を対象にするには、旧バージョンの Mage.exe を使用する必要があります。 既存のマニフェストに対してアセンブリの追加または削除を実行しても、既存のマニフェストに再署名しても、Mage.exe は [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象にするようにマニフェストを更新しません。 これらの機能および制限事項を次の表に示します。  
+  
+|マニフェストのバージョン|操作|Mage v2.0|Mage v4.0|  
+|------------------|--------|---------------|---------------|  
+|.NET Framework 2.0 または 3.x を対象とするアプリケーションのマニフェスト|開く|OK|OK|  
+||閉じる|OK|OK|  
+||保存|OK|OK|  
+||再署名|OK|OK|  
+||新規作成|OK|サポートなし|  
+||更新 \(以下を参照\)|OK|OK|  
+|.NET Framework 4 を対象とするアプリケーションのマニフェスト|開く|OK|OK|  
+||閉じる|OK|OK|  
+||保存|OK|OK|  
+||再署名|OK|OK|  
+||新規作成|サポートなし|OK|  
+||更新 \(以下を参照\)|サポートなし|OK|  
+  
+|マニフェストのバージョン|更新操作の詳細|Mage v2.0|Mage v4.0|  
+|------------------|-------------|---------------|---------------|  
+|.NET Framework 2.0 または 3.x を対象とするアプリケーションのマニフェスト|アセンブリの変更|OK|OK|  
+||アセンブリの追加|OK|OK|  
+||アセンブリの削除|OK|OK|  
+|.NET Framework 4 を対象とするアプリケーションのマニフェスト|アセンブリの変更|サポートなし|OK|  
+||アセンブリの追加|サポートなし|OK|  
+||アセンブリの削除|サポートなし|OK|  
+  
+ Mage.exe は、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とする新しいマニフェストを作成します。[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とする ClickOnce アプリケーションは、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] と完全版の [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の両方で実行できます。 アプリケーションが完全版の [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を対象としていて、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] で実行できない場合は、テキスト エディターを使用してクライアントの `<framework>` 要素を削除し、マニフェストに再署名します。`<framework>` を対象とする [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] 要素の例を次に示します。  
+  
+```  
+<framework targetVersion="4.0" profile="client" supportedRuntime="4.0.20506" />  
+```  
+  
+## 例  
+ Mage 用のユーザー インターフェイス \(MageUI.exe\) を開く例を次に示します。  
+  
+```  
+mage  
+```  
+  
+ 既定の配置マニフェストおよびアプリケーション マニフェストを作成する例を次に示します。 これらのファイルは、すべて現在の作業ディレクトリに作成され、それぞれ deploy.application と application.exe.manifest という名前が付けられます。  
+  
+```  
+mage -New Deployment  
+mage -New Application  
+```  
+  
+ 現在のディレクトリにあるすべてのアセンブリとすべてのリソース ファイルを含めたアプリケーション マニフェストを作成する例を次に示します。  
+  
+```  
+mage -New Application -FromDirectory . -Version 1.0.0.0  
+```  
+  
+ 次の例は、前の例に続いて、配置名および対象のマイクロプロセッサを指定します。 ここでは、ClickOnce が更新プログラムを確認する対象の URL も指定します。  
+  
+```  
+mage -New Application -FromDirectory . -Name "Hello, World! Application" -Version 1.0.0.0 -Processor "x86" -ProviderUrl http://internalserver/HelloWorld/  
+```  
+  
+ Internet Explorer でホストされる WPF アプリケーションを配置するための一組のマニフェストを作成する方法を次の例に示します。  
+  
+```  
+mage -New Application -FromDirectory . -Version 1.0.0.0 -WPFBrowserApp true  
+mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true  
+```  
+  
+ アプリケーション マニフェストから取得した情報で配置マニフェストを更新し、アプリケーション マニフェストの場所のコード ベースを設定する例を次に示します。  
+  
+```  
+mage -Update HelloWorld.deploy -AppManifest 1.0.0.0\application.manifest -AppCodeBase http://internalserver/HelloWorld.deploy  
+```  
+  
+ ユーザーがインストールしているバージョンを強制的に更新するように、配置マニフェストを更新する例を次に示します。  
+  
+```  
+mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -MinVersion 1.1.0.0  
+```  
+  
+ 他のディレクトリからアプリケーション マニフェストを取得するように、配置マニフェストに指定する例を次に示します。  
+  
+```  
+mage -Update HelloWorld.deploy -AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/  
+```  
+  
+ 現在の作業ディレクトリにあるデジタル証明書を使用して、既存の配置マニフェストに署名する例を次に示します。  
+  
+```  
+mage -Sign deploy.application -CertFile cert.pfx -Password <passwd>  
+```  
+  
+## 参照  
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)   
+ [チュートリアル : ClickOnce アプリケーションを手動で配置する](../Topic/Walkthrough:%20Manually%20Deploying%20a%20ClickOnce%20Application.md)   
+ [信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)   
+ [MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md b/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md
new file mode 100644
index 00000000000..a2fb3312865
--- /dev/null
+++ b/docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md
@@ -0,0 +1,207 @@
+---
+title: "MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MageUI.exe"
+  - "マニフェストの生成および編集ツール"
+ms.assetid: f9e130a6-8117-49c4-839c-c988f641dc14
+caps.latest.revision: 38
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 38
+---
+# MageUI.exe (マニフェスト生成および編集ツールのグラフィカル クライアント)
+MageUI.exe でサポートされている機能は、コマンド ライン ツール Mage.exe の機能と同じですが、MageUI.exe には、Windows ベースのユーザー インターフェイス \(UI\) があります。  このツールを使用すると、配置マニフェストおよびアプリケーション マニフェストを作成および編集でき、これらのマニフェストに署名することができます。  MageUI.exe で作成される新しいマニフェストは、[!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象とします。  以前のバージョンの .NET Framework を対象にするには、以前のバージョンの MageUI.exe を使用する必要があります。  マニフェストに対してアセンブリの追加または削除を実行しても、既存のマニフェストに再署名しても、MageUI.exe は [!INCLUDE[net_client_v40_long](../../../includes/net-client-v40-long-md.md)] を対象にするようにマニフェストを更新しません。  詳しくは、「[Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)」をご覧ください。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] セットアップには、2 つのバージョンの Mage.exe および MageUI.exe がコンポーネントとして含まれています。  バージョン情報を確認するには、MageUI.exe を実行し、**\[ヘルプ\]** をクリックして、**\[バージョン情報\]** をクリックします。  このドキュメントでは、バージョン 4.0.x.x の Mage.exe および MageUI.exe について説明します。  
+  
+> [!NOTE]
+>  MageUI.exe は、MageUI.exe を使用して証明書で署名済みのアプリケーション マニフェストを保存する場合、[compatibleFrameworks](../Topic/%3CcompatibleFrameworks%3E%20Element%20\(ClickOnce%20Deployment\).md) 要素をサポートしません。  代わりに [Mage.exe](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md) を使用する必要があります。  
+  
+## UIElement の一覧  
+ 次の表に、利用できるメニューおよびツール バー項目の一覧を表示します。  
+  
+|コマンド|メニュー|ショートカット|説明|  
+|----------|----------|-------------|--------|  
+|**\[Application Manifest\]**|**\[File\] \> \[New\]**||アプリケーション マニフェストを新規作成します。|  
+|**\[Deployment Manifest\]**|**\[File\] \> \[New\]**||配置マニフェストを新規作成します。|  
+|**開く**|**ファイル**|Ctrl \+ O|既存の配置マニフェスト、アプリケーション マニフェストまたは信用ライセンスを編集用に開きます。|  
+|**閉じる**|**ファイル**|Ctrl \+ F4|開いているファイルを閉じます。<br /><br /> 閉じるファイルが変更されていた場合は、公開キー、キー ペア、または格納済みの証明書を使ってファイルに再度署名することを求めるメッセージが表示されます。|  
+|**上書き保存**|**ファイル**|Ctrl \+ S|ユーザー入力のフォーカスがある文書をディスクに保存します。|  
+|**名前を付けて保存**|**ファイル**||ファイルをディスクに保存します。この場合、ユーザーは新しいファイル名や場所を指定できます。|  
+|**\[Save All\]**|**ファイル**||MageUI.exe 内で現在開かれている各ファイルに対して行った変更を保存します。|  
+|**\[Preferences\]**|**ファイル**||**\[Preferences\]** ダイアログ ボックスを開きます。  詳細については、以下のセクションを参照してください。|  
+|**終了**|**ファイル**|Alt \+ F4|MageUI.exe を終了します。|  
+|**切り取り**|**Edit**|Ctrl \+ X|現在選択されているテキストをアプリケーションから削除し、システムのクリップボードに移動します。|  
+|**コピー**|**Edit**|Ctrl \+ C|現在選択されているテキストを、システムのクリップボードにコピーします。|  
+|**貼り付け**|**Edit**|Ctrl \+ V|システム クリップボードから現在アクティブなテキスト要素にテキストを貼り付けます。|  
+|**削除**|**Edit**||現在選択されている一覧、たとえば **\[Deployment Manifest\]** タブの信用ライセンスなどで現在選択されている要素を削除します。|  
+|**\[Close All\]**|**ウィンドウ**||現在 MageUI.exe で開かれているすべてのファイルを閉じます。  保存する必要のあるファイルが存在する場合は、それらのファイルを保存するように要求するメッセージが表示されます。  また、未署名のファイルや変更されたファイルについては、署名キーを選択するように示すメッセージもファイルごとに表示されます。|  
+|**バージョン情報**|**ヘルプ**||MageUI.exe のバージョンおよび著作権についての情報が表示されます。|  
+  
+## \[Preferences\] ダイアログ ボックス  
+ **\[Preferences\]** ダイアログ ボックスには、以下の項目があります。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**\[Sign on save\]**|変更内容を保存するたびに、ファイルへの署名を促すメッセージが表示されます。|  
+|**\[Use default signing certificate\]**|どのファイルに署名する場合でも **\[Certificate file\]** ボックスに入力されたキーを使用します。  こうすると、**\[Sign on Save\]** チェック ボックスをオンにした状態でファイルを保存した場合などに表示される、署名を要求するメッセージが表示されなくなります。  キー ファイルを選択するには、**\[Certificate file\]** ボックスの横の省略記号 \(**...**\) ボタンをクリックします。|  
+|ダイジェスト アルゴリズム|アルゴリズムの依存関係のダイジェストを生成するように指定します。  値は、"sha256RSA" または "sha1RSA" であることが必要です。  既定として SHA1 を使用します。  アプリケーション マニフェストと配置マニフェストの両方に署名します。  ユーザーがマニフェストの保存時に証明書を提供した場合、依存関係ダイジェストを生成するために証明書内のアルゴリズムを使用します。|  
+  
+## \[Signing Options\] ダイアログ ボックス  
+ **\[Signing Options\]** ダイアログ ボックスは、マニフェストや信用ライセンスを初めて保存する場合、またはマニフェストや信用ライセンスを変更する場合に表示されます。  **\[Preferences\]** ダイアログ ボックスの **\[Sign on Save\]** チェック ボックスがオンの場合にだけ表示されます。  **\[TimeStamping URI\]** ボックスの値を指定するマニフェストに署名するときには、インターネットに接続している必要があります。  
+  
+ このダイアログ ボックスには、以下の項目があります。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**\[Sign with certificate file\]**|ファイル システムに格納されているデジタル証明書でマニフェストに署名します。|  
+|**ファイル**|証明書を表す .pfx ファイルのパスの入力欄です。|  
+|**...**|既存の .pfx ファイルを選択するための **\[Choose File\]** ダイアログ ボックスを開きます。|  
+|**新規作成**|証明機関 \(CA: Certificate Authority\) によって証明できない、.pfx ファイルを新規作成します。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の配置に署名するために使用する証明書の種類の詳細については、「[信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)」を参照してください。|  
+|**パスワード**|この証明書で署名するために使用するパスワードの入力欄です。  該当しない場合は、空白にできます。|  
+|**\[Sign with stored certificate\]**|使用しているコンピューターの証明書ストアに格納されている、選択可能なデジタル署名が一覧表示されます。|  
+|**\[TimeStamping URI\]**|デジタル タイムスタンプ サービスの URI \(Uniform Resource Locator\) が表示されます。  次のバージョンのアプリケーションを配置する前にデジタル証明書の有効期限が切れる場合、マニフェストにタイムスタンプを設定すると、マニフェストに再署名する必要がなくなります。  詳しくは、「[Windows ルート証明書プログラム \- メンバー](http://go.microsoft.com/fwlink/?LinkId=159000)」および「[ClickOnce と Authenticode](../Topic/ClickOnce%20and%20Authenticode.md)」をご覧ください。|  
+|**\[Don't Sign\]**|デジタル証明書から署名を追加せずにマニフェストを保存できます。|  
+  
+## タブおよびパネルの説明  
+ MageUI.exe で文書を開くと、その文書用のタブ ページに文書が表示されます。  各タブには、一連のプロパティ パネルがあります。  パネルには、文書のデータをグループ化したサブセットが表示されています。  
+  
+### \[アプリケーション マニフェスト\] タブ  
+ \[**アプリケーション マニフェスト**\] タブには、アプリケーション マニフェストの内容が表示されます。  アプリケーション マニフェストには、配置に含まれるすべてのファイル、およびクライアントでアプリケーションを実行するために必要なアクセス許可が記述されています。  
+  
+ \[**アプリケーション マニフェスト**\] タブには、次のタブが含まれます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**名前**|この配置に関する識別情報を指定します。|  
+|**説明**|発行者、製品、およびサポート情報を指定します。|  
+|**アプリケーション オプション**|これがブラウザー アプリケーションであるかどうか、このマニフェストが信頼情報のソースであるかどうかを指定します。|  
+|**ファイル**|この配置を構成するすべてのファイルを指定します。|  
+|**\[必要なアクセス許可\]**|アプリケーションをクライアント上で実行するために必要な、最小のアクセス許可セットを指定します。|  
+  
+### \[名前\] タブ  
+ \[**名前**\] タブは、アプリケーション マニフェストを初めて作成したり開いたりしたときに表示されます。  このタブでは、配置を一意に識別するほか、オプションで有効な対象プラットフォームを指定できます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**名前**|必ず指定します。  アプリケーション マニフェストの名前です。  通常、ファイル名と同じです。|  
+|**Version**|必ず指定します。  *N.N.N.N* という形式の配置バージョン番号です。  先頭のメジャー ビルド番号だけが必須です。  たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1`、`1.0`、`1.0.0`、`1.0.0.0` です。|  
+|**プロセッサ**|省略可能です。  この配置を実行できるコンピューターのアーキテクチャです。  既定値は `msil` \(Microsoft Intermediate Language\) です。これは、すべてのマネージ アセンブリでの既定の形式です。  アプリケーションのアセンブリを特定のアーキテクチャ用にプリコンパイルした場合は、このフィールドを変更します。  プリコンパイルの詳細については、「[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md)」を参照してください。|  
+|**カルチャ**|省略可能です。  このアプリケーションが実行される国\/地域を、2 つの部分で構成される ISO のコードで指定します。  既定値は `neutral` です。|  
+|**公開キー トークン**|省略可能です。  このアプリケーション マニフェストが署名されたときの公開キーです。  新しいマニフェストまたは未署名のマニフェストでは、このフィールドに \[`署名されていません`\] と表示されます。|  
+  
+### \[説明\] タブ  
+ 通常、この情報は配置マニフェスト内で指定します。  これらのフィールドは、\[**アプリケーション オプション**\] タブの \[**信頼情報のアプリケーション マニフェストを使用する**\] チェック ボックスをオンにした場合にのみ変更できます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**発行者**|このアプリケーションの責任を負う個人または組織の名前です。  この値は、\[スタート\] メニューのフォルダー名として使用されます。|  
+|**製品**|製品の完全な名前です。  配置マニフェストの \[**配置オプション**\] タブで \[**アプリケーションの種類**\] の \[**ローカルにインストール**\] を選択した場合は、\[**スタート**\] メニューおよび \[**プログラムの追加と削除**\] に、このアプリケーションを示す項目としてこの名前が表示されます。|  
+|**サポート URL**|このアプリケーションのヘルプおよびサポート情報をユーザーが入手できるサイトの URL です。|  
+  
+### \[アプリケーション オプション\] タブ  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**Windows Presentation Foundation ブラウザー アプリケーション**|これが XAML ブラウザー アプリケーション \(XBAP\) としてブラウザーで実行される WPF アプリケーションであるかどうかを指定します。|  
+|**信頼情報のアプリケーション マニフェストを使用する**|このマニフェストに信頼情報を含めるかどうかを指定します。|  
+  
+### \[ファイル\] タブ  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**アプリケーション ディレクトリ**|アプリケーションのファイルが格納されているディレクトリです。  ディレクトリを選択するには、省略記号 \(**…**\) ボタンをクリックします。|  
+|**作成**|アプリケーション ディレクトリとサブディレクトリにあるすべてのファイルをアプリケーション マニフェストに追加します。  ディレクトリ内に実行可能ファイルが 1 つしか見つからなかった場合は、このファイルがエントリ ポイントとして自動的にマークされます。エントリ ポイントは、ClickOnce アプリケーションをクライアントで起動したときに、最初に実行されます。|  
+|**アプリケーション ファイル**|アプリケーション内のすべてのファイルの一覧を示します。  各ファイルには、以下で説明する 3 つの編集可能な属性があります。|  
+|**ファイルの種類**|ファイルの種類は以下の 4 つのうちのいずれかです。<br /><br /> -   なし。<br />-   エントリ ポイント。  アプリケーションのプライマリ実行可能ファイルです。  エントリ ポイントとしてマークできる実行可能ファイルは 1 つだけです。<br />-   データ ファイル。  XML ファイルなど、アプリケーションにデータを提供するためのファイルです。<br />-   アイコン ファイル。  アプリケーション ウィンドウの隅やデスクトップに表示されるアプリケーション アイコンです。|  
+|**省略可能**|省略可能のマークを付けたファイルは初期インストール時や更新時にはダウンロードされませんが、System.Deployment オンデマンド API を使用して実行時にダウンロードできます。  詳細については、「[チュートリアル : デザイナーを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする](../Topic/Walkthrough:%20Downloading%20Assemblies%20on%20Demand%20with%20the%20ClickOnce%20Deployment%20API%20Using%20the%20Designer.md)」を参照してください。|  
+|**グループ化**|省略可能なファイル セットのラベルです。  ファイル セットにはグループ ラベルを付けることができ、オンデマンド API を使用して、1 回の API 呼び出しで一連のファイルをダウンロードできます。|  
+  
+### \[必要なアクセス許可\] タブ  
+ アプリケーションに対して、既定で付与される以上のローカル コンピューターへのアクセス許可を与える必要がある場合は、\[**必要なアクセス許可**\] タブを使用します。  詳しくは、「[ClickOnce アプリケーションのセキュリティ](../Topic/Securing%20ClickOnce%20Applications.md)」をご覧ください。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**アクセス許可セットの種類**|‏このアプリケーションをクライアントで実行するために必要な、最小のアクセス許可セットです。  これらのアクセス許可セットおよび必要なアクセス許可については、「 [NIB: Named Permission Sets](http://msdn.microsoft.com/ja-jp/08250d67-c99d-4ab0-8d2b-b0e12019f6e3)」を参照してください。|  
+|**詳細**|アクセス許可セットを表すために作成された、アプリケーション マニフェスト用の XML です。  アプリケーション マニフェストの XML 形式に精通している場合を除き、この XML を手動で編集しないでください。  詳細については、「[ClickOnce アプリケーション マニフェスト](../Topic/ClickOnce%20Application%20Manifest.md)」を参照してください。|  
+  
+### \[配置マニフェスト\] タブ  
+ \[**配置マニフェスト**\] タブには、次のタブが含まれます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**名前**|この配置に関する識別情報を指定します。|  
+|**説明**|発行者、製品、およびサポート情報を指定します。|  
+|**配置オプション**|アプリケーションの種類や開始場所など、配置に関する追加情報を指定します。|  
+|**更新オプション**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] がアプリケーションの更新プログラムを確認する頻度を指定します。|  
+|**アプリケーション参照**|この配置のアプリケーション マニフェストを指定します。|  
+  
+### \[名前\] タブ  
+ \[**名前**\] タブは、配置マニフェストを初めて作成したり開いたりしたときに表示されます。  このタブでは、配置を一意に識別するほか、オプションで有効な対象プラットフォームを指定できます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**名前**|必ず指定します。  配置マニフェストの名前です。  通常、ファイル名と同じです。|  
+|**Version**|必ず指定します。  *N.N.N.N* という形式の配置バージョン番号です。  先頭のメジャー ビルド番号だけが必須です。  たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1`、`1.0`、`1.0.0`、`1.0.0.0` です。|  
+|**プロセッサ**|省略可能です。  この配置を実行できるコンピューターのアーキテクチャです。  既定値は `msil` \(Microsoft Intermediate Language\) です。これは、すべてのマネージ アセンブリの既定の形式です。  アプリケーションのアセンブリを特定のアーキテクチャ用にコンパイルした場合は、このフィールドを変更します。|  
+|**カルチャ**|省略可能です。  このアプリケーションの実行環境となる、ISO の国\/地域コードです。2 つの部分で構成されています。  既定値は `neutral` です。|  
+|**公開キー トークン**|省略可能です。  この配置マニフェストが署名されたときの公開キーです。  新しいマニフェストまたは未署名のマニフェストでは、このフィールドに \[`署名されていません`\] と表示されます。|  
+  
+### \[説明\] タブ  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**発行者**|必ず指定します。  このアプリケーションの責任を負う個人または組織の名前です。  この値は、\[スタート\] メニューのフォルダー名として使用されます。|  
+|**製品**|必ず指定します。  製品の完全な名前です。  \[**配置オプション**\] タブで \[**アプリケーションの種類**\] の \[**ローカルにインストール**\] を選択した場合は、\[**スタート**\] メニューおよび \[**プログラムの追加と削除**\] に、このアプリケーションを示す項目としてこの名前が表示されます。|  
+|**サポート URL**|省略可能です。  このアプリケーションのヘルプおよびサポート情報をユーザーが入手できるサイトの URL です。|  
+  
+### \[配置オプション\] タブ  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**\[アプリケーションの種類\]**|省略可能です。  このアプリケーションが、クライアント コンピューターにインストールされるか \(\[**ローカルにインストール**\]\)、オンラインで実行されるか \(\[**オンラインのみ**\]\)、ブラウザーで実行される WPF アプリケーションか \(\[**WPF ブラウザー アプリケーション**\]\) を指定します。  既定値は \[**ローカルにインストール**\] です。|  
+|**開始位置**|省略可能です。  アプリケーションを実際に起動するサイトの URL です。  CD からアプリケーションを配置し、Web サイト経由で更新する必要がある場合に便利です。|  
+|**開始場所 \(ProviderURL\) をマニフェストに含める**|省略可能です。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] でアプリケーションの更新プログラムを確認する場合に参照する URL を指定します。|  
+|**インストール後にアプリケーションを自動的に実行する**|必ず指定します。  URL からの最初のインストールが完了したら、すぐにアプリケーションを実行するように [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] に指定します。  既定では、チェック ボックスがオンになっています。|  
+|**URL パラメーターをアプリケーションに渡すことを許可する**|必ず指定します。  配置マニフェストの URL にクエリ文字列を追加することで、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションにパラメーター データを渡すことができるようにします。  既定では、チェック ボックスがオフになっています。|  
+|**.deploy ファイル拡張子を使用する**|必ず指定します。  オンにした場合、アプリケーション マニフェストのすべてのファイルの拡張子が .deploy になります。  既定では、チェック ボックスがオフになっています。|  
+  
+### \[更新オプション\] タブ  
+ \[**更新オプション**\] タブには、\[**名前**\] タブの \[**アプリケーションの種類**\] 選択ボックスで \[**ローカルにインストール**\] が選択されている場合にのみ、ここで説明するオプションが表示されます。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**このアプリケーションの更新プログラムを確認する**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] でアプリケーションの更新プログラムを確認する必要があるかどうかを指定します。  このチェック ボックスをオフにした場合、アプリケーションの更新情報は確認されません。ただし、<xref:System.Deployment.Application> 名前空間の API を使用すると、プログラムによってアプリケーションを更新できます。|  
+|**アプリケーションの更新を確認する方法を選択してください**|更新プログラムの確認について次の 2 つのオプションがあります。<br /><br /> -   \[**アプリケーションの開始前に行う**\]。  アプリケーションを実行する前に更新プログラムを確認します。<br />-   \[**アプリケーションの開始後に行う**\]。  アプリケーションのメイン フォームが初期化されると更新プログラムの確認が開始され、アプリケーションが次に起動されたときに更新プログラムの確認が実行されます。|  
+|**更新プログラムの確認の頻度**|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] で更新プログラムを確認する頻度を指定します。<br /><br /> -   \[**アプリケーションが実行するたびに確認する**\]。  ユーザーがアプリケーションを起動するたびに、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] によって更新プログラムが確認されます。<br />-   \[**確認する間隔**\]: 更新プログラムを確認するまでの経過時間の間隔と単位 \(時間、日、または週\) を選択します。|  
+|**このアプリケーションに最低限必要なバージョンを指定する**|省略可能です。  アプリケーションの特定のバージョンを必須インストールとして指定し、ユーザーが旧バージョンを使用しないようにします。|  
+|**Version**|\[**このアプリケーションに最低限必要なバージョンを指定する**\] チェック ボックスをオンにした場合は必須です。  指定されたバージョン番号 が*N.N.N.N* という形式である必要があります。  先頭のメジャー ビルド番号だけが必須です。  たとえば、アプリケーションのバージョンが 1.0 の場合、有効な値は、`1`、`1.0`、`1.0.0`、`1.0.0.0` です。|  
+  
+### \[アプリケーション参照\] タブ  
+ \[**アプリケーション参照**\] タブには、このトピックで既に説明した \[**名前**\] タブと同じフィールドがあります。  ただし、次のフィールドだけが異なります。  
+  
+|UI 要素|説明|  
+|-----------|--------|  
+|**マニフェストの選択**|アプリケーション マニフェストを選択できます。  アプリケーション マニフェストを選択すると、このページの他のすべてのフィールドの値が設定されます。|  
+  
+## 参照  
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)   
+ [チュートリアル : ClickOnce アプリケーションを手動で配置する](../Topic/Walkthrough:%20Manually%20Deploying%20a%20ClickOnce%20Application.md)   
+ [Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)
\ No newline at end of file
diff --git a/docs/framework/tools/mdbg-exe.md b/docs/framework/tools/mdbg-exe.md
new file mode 100644
index 00000000000..1769879e1fe
--- /dev/null
+++ b/docs/framework/tools/mdbg-exe.md
@@ -0,0 +1,121 @@
+---
+title: "MDbg.exe (.NET Framework コマンド ライン デバッガー) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コマンド ライン デバッガー [.NET Framework]"
+  - "MDbg.exe"
+ms.assetid: 28a3f509-07e2-4dbe-81df-874c5e969cc4
+caps.latest.revision: 27
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# MDbg.exe (.NET Framework コマンド ライン デバッガー)
+.NET Framework コマンド ライン デバッガーは、.NET Framework 共通言語ランタイムを対象としたプログラムに含まれるバグの検索と修復について、ツールの販売元とアプリケーション開発者を支援するツールです。  このツールは、ランタイムのデバッグ API を使用してデバッグ サービスを提供します。  MDbg.exe を使用してもマネージ コードのデバッグしか実行できません。アンマネージ コードのデバッグはサポートされていません。  
+  
+ このツールは NuGet からは入手できません。  インストールについては、「[MDbg 0.1.0](http://www.nuget.org/packages/MDbg/0.1.0)」を参照してください。  このツールを実行するには、パッケージ マネージャー コンソールを使用します。  パッケージ マネージャー コンソールの使用法についての詳細は、「[Using the Package Manager Console \(パッケージ マネージャー コンソールの使用法\)](http://docs.nuget.org/docs/start-here/Using-the-Package-Manager-Console)」を参照してください。  
+  
+ パッケージ マネージャー プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+MDbg [ProgramName[arguments]] [options]  
+```  
+  
+## コマンド  
+ デバッガーが起動したら \(**mdbg\>** プロンプトで示されます\)、次のセクションで説明するコマンドのいずれかを入力します。  
+  
+ **command** \[*arguments*\]  
+  
+ MDbg.exe コマンドでは、大文字と小文字が区別されます。  
+  
+|コマンド|説明|  
+|----------|--------|  
+|**ap**\[**rocess**\] \[*number*\]|デバッグされている別のプロセスに切り替えたり、使用できるプロセスを出力したりします。  この番号は実際のプロセス ID \(PID\) ではなく、インデックスが 0 から始まるリストです。|  
+|**a**\[**ttach**\] \[*pid*\]|プロセスにアタッチしたり、使用できるプロセスを出力したりします。|  
+|**b**\[**reak**\] \[*ClassName.Method* &#124; *FileName:LineNo*\]|指定したメソッドにブレークポイントを設定します。  モジュールは順次スキャンされます。<br /><br /> -   **break** *FileName:LineNo* は、ソース内の位置にブレークポイントを設定します。<br />-   **break** *~number* は、**x** コマンドで最近表示されたシンボルにブレークポイントを設定します。<br />-   **break** *module\!ClassName.Method\+IlOffset* は、完全修飾位置にブレークポイントを設定します。|  
+|**block**\[**ingObjects**\]|ブロッキング スレッドであるモニター ロックを表示します。|  
+|**ca**\[**tch**\] \[*exceptionType*\]|未処理の例外だけでなく、すべての例外でデバッガーが中断されます。|  
+|**cl**\[**earException**\]|実行を継続できるように、現在の例外を処理済みとしてマークします。  例外の原因が処理されていない場合は、例外がすぐに再スローされる可能性があります。|  
+|**conf**\[**ig**\] \[*option value*\]|設定可能なすべてのオプションと、省略可能な値を指定せずにオプションを起動する方法を表示します。  オプションを指定する場合は、`value` を現在のオプションとして設定します。  次の各オプションを現在使用できます。<br /><br /> -   `extpath`: `load` コマンドの使用時に、拡張機能の検索対象となるパスを設定します。<br />-   `extpath+`: 拡張機能を読み込むパスを追加します。|  
+|**del**\[**ete**\]|ブレークポイントを削除します。|  
+|**de**\[**tach**\]|デバッグされているプロセスからデタッチします。|  
+|**d**\[**own**\] \[*frames*\]|アクティブなスタック フレームを下へ移動します。|  
+|**echo**|メッセージをコンソールにエコーします。|  
+|**enableNotif**\[**ication**\] *typeName* 0&#124;1|指定した種類のカスタム通知を有効 \(1\) または無効 \(0\) にします。|  
+|**ex**\[**it**\] \[*exitcode*\]|MDbg.exe シェルを終了します。プロセス終了コードを指定することもできます。|  
+|**fo**\[**reach**\] \[*OtherCommand*\]|すべてのスレッドでコマンドを実行します。  *OtherCommand* は、1 つのスレッドで動作する有効なコマンドです。**foreach** *OtherCommand* は、すべてのスレッドで同じコマンドを実行します。|  
+|**f**\[**unceval**\] \[`-ad` *Num*\] *functionName* \[*args ...*\]|現在のアクティブ スレッドで関数評価を実行します。*functionName* は、評価する関数です。  関数名には、名前空間を含めた完全修飾名を指定する必要があります。<br /><br /> `-ad` オプションは、関数の解決に使用するアプリケーション ドメインを指定します。  `-ad` オプションが指定されていない場合、解決に使用するアプリケーション ドメインは、関数評価に使用するスレッドが配置されたアプリケーション ドメインに既定で設定されます。<br /><br /> 評価対象の関数が静的ではない場合、渡される最初のパラメーターは `this` ポインターであることが必要です。  すべてのアプリケーション ドメインで、関数評価のための引数が検索されます。<br /><br /> アプリケーション ドメインから値を要求するには、変数の先頭にモジュール名とアプリケーション ドメイン名を付けます。たとえば、`funceval -ad 0 System.Object.ToString hello.exe#0!MyClass.g_rootRef` のようにします。  このコマンドは、アプリケーション ドメイン `0` の `System.Object.ToString` 関数を評価します。  `ToString` メソッドはインスタンス関数であるため、最初のパラメーターは `this` ポインターであることが必要です。|  
+|**g**\[**o**\]|ブレークポイントに到達し、プログラムが終了するか、イベント \(未処理の例外など\) によってプログラムが中断されるまで、プログラムは続行されます。|  
+|**h**\[**elp**\] \[*command*\]<br /><br /> または<br /><br /> **?** \[*command*\]|すべてのコマンドの説明、または指定したコマンドの詳細な説明を表示します。|  
+|**ig**\[**nore**\] \[*event*\]|未処理の例外の発生時にだけデバッガーが停止します。|  
+|**int**\[**ercept**\] *FrameNumber*|デバッガーを指定したフレーム番号にロールバックします。<br /><br /> デバッガーの実行時に例外が発生した場合は、このコマンドを使用してデバッガーを指定したフレーム番号にロールバックします。  **set** コマンドを使用してプログラムの状態を変更し、**go** コマンドを使用して続行できます。|  
+|**k**\[**ill**\]|アクティブ プロセスを停止します。|  
+|**l**\[**ist**\] \[*modules* &#124; *appdomains*&#124; *assemblies*\]|読み込まれたモジュール、アプリケーション ドメイン、またはアセンブリを表示します。|  
+|**lo**\[**ad**\] *assemblyName*|拡張機能を読み込みます。指定したアセンブリが読み込まれた後、`Microsoft.Tools.Mdbg.Extension.Extension` 型の静的メソッド `LoadExtension` の実行が試行され、拡張機能が読み込まれます。|  
+|**log** \[*eventType*\]|ログに記録するイベントを設定または表示します。|  
+|**mo**\[**de**\] \[*option on\/off*\]|デバッガーのさまざまなオプションを設定します。  オプションを指定せずに `mode` を使用すると、デバッグ モードとその現在の設定のリストが取得されます。|  
+|**mon**\[**itorInfo**\] *monitorReference*|オブジェクトのモニター ロックの情報を表示します。|  
+|**newo**\[**bj**\] *typeName* \[*arguments...*\]|*typeName* 型の新しいオブジェクトを作成します。|  
+|**n**\[**ext**\]|コードを実行し、次の行に移動します \(次の行に多数の関数呼び出しが含まれている場合も同様です\)。|  
+|**Opendump** *pathToDumpFile*|指定されたダンプ ファイルをデバッグ用に開きます。|  
+|**o**\[**ut**\]|現在の関数の末尾に移動します。|  
+|**pa**\[**th**\] \[*pathName*\]|バイナリの場所が使用できない場合に、指定したパスでソース ファイルを検索します。|  
+|**p**\[**rint**\] \[*var*\] &#124; \[`-d`\]|スコープ内のすべての変数の出力 \(**print**\)、指定した変数の出力 \(**print** *var*\)、またはデバッガー変数の出力 \(**print** `-d`\) を実行します。|  
+|**printe**\[**xception**\] \[*\-r*\]|現在のスレッドで最後にスローされた例外を出力します。  `–r` \(再帰的\) オプションを使用すると、例外オブジェクトで `InnerException` プロパティが走査され、例外のチェーン全体に関する情報が取得されます。|  
+|**pro**\[**cessenum**\]|アクティブ プロセスを表示します。|  
+|**q**\[**uit**\] \[*exitcode*\]|MDbg.exe シェルを終了します。プロセス終了コードを指定することもできます。|  
+|**re**\[**sume**\] \[`*` &#124; \[`~`\]*threadNumber*\]|現在のスレッドまたは *threadNumber* パラメーターで指定したスレッドを再開します。<br /><br /> *threadNumber* パラメーターに `*` を指定した場合、またはスレッド番号が `~` で始まる場合には、コマンドは *threadNumber* で指定したスレッドを除くすべてのスレッドに適用されます。<br /><br /> 中断されていないスレッドを再開しても無効になります。|  
+|**r**\[**un**\] \[`-d`\(`ebug`\) &#124; \-`o`\(`ptimize`\) &#124;`-enc`\] \[\[*path\_to\_exe*\] \[*args\_to\_exe*\]\]|現在のプロセス \(存在する場合\) を停止し、新しいプロセスを起動します。  実行可能な引数が渡されなかった場合、このコマンドは `run` コマンドによって以前に実行されたプログラムを実行します。  実行可能な引数が渡された場合は、オプションで指定した引数を使用して、指定したプログラムが実行されます。<br /><br /> クラス読み込みイベント、モジュール読み込みイベント、およびスレッド起動イベントが無視される場合 \(既定の状態\)、このプログラムはメイン スレッドの最初の実行可能命令で停止します。<br /><br /> 次の 3 つのフラグのいずれかを使用すると、デバッガーに強制的にコードを JIT \(Just\-In\-Time\) コンパイルさせることができます。<br /><br /> -   `-d`*\(*`ebug`*\)* は、最適化を無効にします。  これは MDbg.exe の既定値です。<br />-   `-o`*\(*`ptimize`*\)* は、デバッガーの外部で実行する場合のように、コードを強制的に実行しますが、デバッグが困難になります。  これは、デバッガーの外部で使用するための既定値です。<br />-   `-enc` は、エディット コンティニュ機能を有効にしますが、パフォーマンスに影響します。|  
+|**Set** *variable*\=*value*|スコープ内の変数の値を変更します。<br /><br /> 独自のデバッガー変数を作成し、アプリケーション内から参照値を割り当てることもできます。  元の値がスコープの外であっても、これらの値は元の値に対するハンドルとして機能します。  すべてのデバッガー変数は、`$` で始まる必要があります \(例: `$var`\)。  次のコマンドを使用して、これらのハンドルに何も設定しないことでハンドルを削除できます。<br /><br /> `set $var=`|  
+|**Setip** \[`-il`\] *number*|ファイル内の現在の命令ポインター \(IP: Instruction Pointer\) を指定した位置に設定します。  `-il` オプションを指定した場合、数値はメソッド内の Microsoft Intermediate Language \(MSIL\) のオフセットを表します。  それ以外の場合は、数値はソースの行番号を表します。|  
+|**sh**\[**ow**\] \[*lines*\]|表示する行数を指定します。|  
+|**s**\[**tep**\]|現在の行の次の関数の実行に移ります。実行する関数がない場合は、次の行に移動します。|  
+|**su**\[**spend**\] \[\* &#124; \[~\]*threadNumber*\]|現在のスレッドまたは *threadNumber* パラメーターで指定したスレッドを中断します。  *threadNumber* に `*` を指定した場合、コマンドはすべてのスレッドに適用されます。  スレッド番号が `~` で始まる場合、コマンドは *threadNumber* で指定したスレッドを除くすべてのスレッドに適用されます。  プロセスが **go** コマンドまたは **step** コマンドによって実行されている場合、中断されたスレッドは実行から除外されます。  プロセス内に中断されているスレッドがない場合に **go** コマンドを実行しても、プロセスは続行されません。  この場合、Ctrl キーを押しながら C キーを押してプロセスを中止する必要があります。|  
+|**sy**\[**mbol**\] *commandName* \[*commandValue*\]|次のコマンドのいずれかを指定します。<br /><br /> -   `symbol path` \[`"``value``"`\] \- 現在のシンボル パスを表示または設定します。<br />-   `symbol addpath` `"``value``"` \- 現在のシンボル パスに追加します。<br />-   `symbol reload` \[`"``module``"`\] \- すべてのシンボルまたは指定したモジュールのシンボルを再読み込みします。<br />-   `symbol list` \[`module`\] \- すべてのモジュールまたは指定したモジュールの現在読み込まれているシンボルを表示します。|  
+|**t**\[**hread**\] \[*newThread*\] \[\-*nick nickname*`]`|パラメーターを指定しないで thread コマンドを実行すると、現在のプロセス内のすべてのマネージ スレッドが表示されます。  通常、スレッドはスレッド番号で識別されますが、スレッドにニックネームが割り当てられている場合は、スレッド番号ではなくニックネームが表示されます。  `-nick` パラメーターを使用すると、スレッドにニックネームを割り当てることができます。<br /><br /> -   **thread** `-nick` *threadName* を実行すると、現在実行中のスレッドにニックネームが割り当てられます。<br /><br /> ニックネームを数字にすることはできません。  現在のスレッドにニックネームが既に割り当てられている場合、古いニックネームは新しいニックネームに置き換えられます。  新しいニックネームが空の文字列 \(""\) の場合は、現在のスレッドのニックネームが削除され、新しいニックネームはスレッドに割り当てられません。|  
+|**u**\[**p**\]|アクティブなスタック フレームを上へ移動します。|  
+|**uwgc**\[**handle**\] \[*var*\] &#124; \[*address*\]|ハンドルによって追跡された変数を出力します。  ハンドルは、名前またはアドレスで指定できます。|  
+|**when**|現在アクティブな `when` ステートメントを表示します。<br /><br /> **when** **delete all** &#124; `num` \[`num` \[`num` …\]\] \- 番号で指定された `when` ステートメントを削除します。`all` が指定されている場合は、すべての `when` ステートメントを削除します。<br /><br /> **when** `stopReason` \[`specific_condition`\] **do** `cmd` \[`cmd` \[`cmd` …\] \] \- *stopReason* パラメーターには、次のいずれかの値を指定できます。<br /><br /> `StepComplete`, `ProcessExited`, `ThreadCreated`, `BreakpointHit`, `ModuleLoaded`, `ClassLoaded`, `AssemblyLoaded`, `AssemblyUnloaded`, `ControlCTrapped`, `ExceptionThrown`, `UnhandledExceptionThrown`, `AsyncStop`, `AttachComplete`, `UserBreak`, `EvalComplete`, `EvalException`, `RemapOpportunityReached`, `NativeStop`.<br /><br /> *specific\_condition* には、次のいずれかの値を指定できます。<br /><br /> -   *number* \- `ThreadCreated` および `BreakpointHit` の場合、同じ値を持つスレッド ID 番号とブレークポイント番号によって停止した場合にだけアクションを発生させます。<br />-   \[`!`\]*name* \- `ModuleLoaded`、`ClassLoaded`、`AssemblyLoaded`、`AssemblyUnloaded`、`ExceptionThrown`、および `UnhandledExceptionThrown` の場合、名前が *stopReason* の名前と一致する場合にだけアクションを発生させます。<br /><br /> *specific\_condition* は、*stopReason* の他の値に対しては空であることが必要です。|  
+|**w**\[**here**\] \[`-v`\] \[`-c` *depth*\] \[*threadID*\]|スタック フレームのデバッグ情報を表示します。<br /><br /> -   `-v` オプションを指定すると、表示された各スタック フレームの詳細情報が表示されます。<br />-   `depth` に数値を指定すると、表示するフレームの数を制限できます。  すべてのフレームを表示するには、**all** コマンドを使用します。  既定値は 100 です。<br />-   *threadID* パラメーターを指定すると、スタックに関連付けるスレッドを制御できます。  既定値は、現在のスレッドのみです。  すべてのスレッドを取得するには、**all** コマンドを使用します。|  
+|**x** \[`-c` *numSymbols*\] \[*module*\[`!`*pattern*\]\]|モジュールの `pattern` に一致する関数を表示します。<br /><br /> *numSymbols* を指定すると、出力が指定した数に制限されます。  `!` \(正規表現を示す\) が *pattern* に対して指定されていない場合は、すべての関数が表示されます。  *module* が指定されていない場合は、読み込まれたすべてのモジュールが表示されます。  **break** コマンドを使用してブレークポイントを設定するには、シンボル \(*~\#*\) を使用します。|  
+  
+## 解説  
+ デバッグするアプリケーションをコンパイルするときは、コンパイラ固有のフラグを使用します。このフラグによって、コンパイラがデバッグ シンボルを生成します。  コンパイラ固有のフラグの詳細については、コンパイラのドキュメントを参照してください。  最適化したアプリケーションでもデバッグはできますが、一部のデバッグ情報が欠落しています。  たとえば、ローカル変数の多くを表示できなくなり、ソース行も不正確になります。  
+  
+ アプリケーションをコンパイルした後、コマンド プロンプトに「**mdbg**」と入力してデバッグ セッションを開始します。例を次に示します。  
+  
+```  
+C:\Program Files\Microsoft Visual Studio 8\VC>mdbg  
+MDbg (Managed debugger) v2.0.50727.42 (RTM.050727-4200) started.  
+Copyright (C) Microsoft Corporation. All rights reserved.  
+  
+For information about commands type "help";  
+to exit program type "quit".  
+mdbg>  
+```  
+  
+ `mdbg>` プロンプトは、デバッガーが起動したことを表します。  
+  
+ デバッガーが起動したら、前のセクションで説明したコマンドと引数を使用します。  
+  
+## 例  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/mgmtclassgen-exe.md b/docs/framework/tools/mgmtclassgen-exe.md
new file mode 100644
index 00000000000..6ea5ef879df
--- /dev/null
+++ b/docs/framework/tools/mgmtclassgen-exe.md
@@ -0,0 +1,167 @@
+---
+title: "Mgmtclassgen.exe (厳密型クラス ジェネレーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "CIM 型"
+  - "事前バインディングされたマネージ クラス"
+  - "厳密型クラス ジェネレーター"
+  - "Mgmtclassgen.exe"
+  - "WMI クラス"
+ms.assetid: 02ce6699-49b5-4a0b-b0d5-1003c491232e
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Mgmtclassgen.exe (厳密型クラス ジェネレーター)
+厳密型クラス ジェネレーター \(Mgmtclassgen.exe\) ツールを使用すると、指定した WMI \(Windows Management Instrumentation\) クラスに対して、事前バインディングされたマネージ クラスをすばやく生成できます。  生成されたクラスを使用すると、WMI クラスのインスタンスにアクセスするために書く必要のあるコードを簡略化できます。  
+  
+## 構文  
+  
+```  
+  
+mgmtclassgen   
+WMIClass [options]   
+```  
+  
+|引数|説明|  
+|--------|--------|  
+|*WMIClass*|事前バインディングしたマネージ クラスを生成する対象の WMI クラスです。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/l**  *language*|事前バインディングされたマネージ クラスの生成に使用する言語を指定します。  language 引数として **CS** \(C\#、既定値\)、**VB** \(Visual Basic\)、**MC** \(C\+\+\)、または **JS** \(JScript\) を指定できます。|  
+|**\/m**  *machine*|WMI クラスが常駐する、接続先のコンピューターを指定します。  既定値はローカル コンピューターです。|  
+|**\/n**  *path*|WMI クラスが含まれている WMI 名前空間へのパスを指定します。  このオプションを指定しない場合、このツールは既定の **Root\\cimv2** 名前空間に *WMIClass* のコードを生成します。|  
+|**\/o**  *classnamespace*|マネージ コード クラスを生成する先の .NET 名前空間を指定します。  このオプションを指定しない場合、このツールは WMI 名前空間およびスキーマ プリフィックスを使用して名前空間を指定します。  スキーマ プリフィックスはクラス名の一部で、アンダースコア \(\_\) 文字の前に付きます。  たとえば、**Root\\cimv2** 名前空間内の **Win32\_OperatingSystem** クラスの場合、このツールは **ROOT.CIMV2.Win32** にクラスを生成します。|  
+|**\/p**  *filepath*|生成されたコードを保存するファイルへのパスを指定します。  このオプションを指定しない場合、このツールは現在のディレクトリにファイルを作成します。  *WMIClass* 引数を使用して生成したクラスと、そのクラスを保存したファイルには名前が付けられます。  クラスおよびファイルの名前は、*WMIClass* の名前と同じです。*WMIClass* にアンダースコア \(\_\) 文字が含まれている場合は、アンダースコア \(\_\) 文字の後に続く、クラス名の一部が使用されます。  たとえば、*WMIClass* 名が **Win32\_LogicalDisk** という形式の場合、生成されたクラスおよびファイルには "logicaldisk" という名前が付けられます。  ファイルが既に存在している場合は、既存のファイルが上書きされます。|  
+|**\/pw**  *password*|**\/m** オプションで指定したコンピューターにログオンするときに使用するパスワードを指定します。|  
+|**\/u**  *user name*|**\/m** オプションで指定したコンピューターにログオンするときに使用するユーザー名を指定します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ Mgmtclassgen.exe は、<xref:System.Management.ManagementClass.GetStronglyTypedClassCode%2A?displayProperty=fullName> メソッドを使用します。  したがって、任意のカスタム コード プロバイダーを使用して、C\#、Visual Basic、および JScript 以外のマネージ言語でコードを生成できます。  
+  
+ 生成されたクラスは、それらのクラスを生成する目的となったスキーマにバインドされます。  基になるスキーマが変更された場合に、その変更をこのスキーマに反映するには、クラスを生成し直す必要があります。  
+  
+ WMI CIM \(Common Information Model\) 型の、生成されたクラスのデータ型への割り当てを次の表に示します。  
+  
+|CIM 型|生成したクラスのデータ型|  
+|-----------|------------------|  
+|CIM\_SINT8|**SByte**|  
+|CIM\_UINT8|**Byte**|  
+|CIM\_SINT16|**Int16**|  
+|CIM\_UINT16|**UInt16**|  
+|CIM\_SINT32|**Int32**|  
+|SIM\_UINT32|**UInt32**|  
+|CIM\_SINT64|**Int64**|  
+|CIM\_UINT64|**UInt64**|  
+|CIM\_REAL32|**Single**|  
+|CIM\_REAL64|**Double**|  
+|CIM\_BOOLEAN|**Boolean**|  
+|CIM\_String|**String**|  
+|CIM\_DATETIME|**DateTime** または **TimeSpan**|  
+|CIM\_REFERENCE|**ManagementPath**|  
+|CIM\_CHAR16|**Char**|  
+|CIM\_OBJECT|**ManagementBaseObject**|  
+|CIM\_IUNKNOWN|**Object**|  
+|CIM\_ARRAY|上記のオブジェクトの配列|  
+  
+ WMI クラスを生成する場合は、次の動作に注意してください｡  
+  
+-   標準パブリック プロパティまたはメソッドの名前と既存のプロパティまたはメソッドの名前が同じになる可能性があります。  このような事態が発生した場合、このツールは生成したクラスのプロパティまたはメソッドの名前を変更して、名前付けの競合を回避します。  
+  
+-   生成したクラスのプロパティまたはメソッドの名前がプログラミング言語のキーワード名と同じになる可能性があります。  このような事態が発生した場合、このツールは生成したクラスのプロパティまたはメソッドの名前を変更して、名前付けの競合を回避します。  
+  
+-   WMI では、修飾子は、クラス、インスタンス、プロパティ、またはメソッドを説明する情報を含む修飾子となります。  WMI は、**Read**、**Write**、**Key** などの標準の修飾子を使用して、生成したクラスのプロパティについて説明します。  たとえば、**Read** 修飾子で修飾されたプロパティは、生成したクラスではプロパティ **get** アクセサーだけを伴って定義されます。  **Read** 修飾子でマークされたプロパティは読み取り専用であるため、**set** アクセサーは定義されません。  
+  
+-   数値プロパティを **Values** 修飾子および **ValueMaps** 修飾子によって修飾すると、このプロパティには、指定した許容値しか設定できないことを示すことができます。  列挙体は、このような **Values** および **ValueMaps** を使用して生成され、このプロパティは列挙体に割り当てられます。  
+  
+-   WMI では、インスタンスを 1 つだけを持つことのできるクラスを説明するために、シングルトンという用語を使用します。  シングルトン クラスの既定のコンストラクターは、クラスをそのクラスの唯一のインスタンスに初期化します。  
+  
+-   WMI クラスは、オブジェクトであるプロパティを持つ場合があります。  そのような型の WMI クラスに対して、厳密に型指定されたクラスを生成する場合は、埋め込まれたオブジェクト プロパティの型それぞれに対して厳密に型指定されたクラスを生成することを検討してください。  これにより、厳密に型指定する方法で、埋め込まれたオブジェクトにアクセスできるようになります。  生成されたコードが、埋め込まれたオブジェクトの型を検出できない場合もあります。  このような場合は、生成されたコード内に、その旨をユーザーに通知するコメントが作成されます。  これに応じて、生成された他のクラスをプロパティの型として指定するように、生成したコードを変更できます。  
+  
+-   WMI では、CIM\_DATETIME データ型のデータ値は、特定の日時または時間間隔を表すことができます。  データ値が日時を表す場合、生成されたクラスのデータ型は **DateTime** です。  データ値が時間間隔を表す場合、生成されたクラスのデータ型は **TimeSpan** です。  
+  
+ Visual Studio .NET のサーバー エクスプローラー管理拡張機能を使用して、厳密に型指定されクラスを生成することもできます。  
+  
+ WMI の詳細については、プラットフォーム SDK の「Windows Management Instrumentation」のトピックを参照してください。  
+  
+## 例  
+ **Root\\cimv2** 名前空間内の **Win32\_LogicalDisk** WMI クラスに対してマネージ クラスを C\# コードで生成するコマンドを次に示します。  このツールは、**ROOT.CIMV2.Win32** 名前空間内の c:\\disk.cs にあるソース ファイルにマネージ クラスを書き込みます。  
+  
+```  
+mgmtclassgen Win32_LogicalDisk /n root\cimv2 /l CS /p c:\disk.cs  
+```  
+  
+ 生成したクラスをプログラムによって使用する方法を次のコード例に示します。  まず、クラスのインスタンスが列挙され、パスが出力されます。  次に、初期化の対象となる生成したクラスのインスタンスが、WMI のインスタンスを使用して作成されます。  **Root\\cimv2** 名前空間において `Process` は **Win32\_Process** に対して生成されたクラスであり、`LogicalDisk` は **Win32\_LogicalDisk** に対して生成されたクラスです。  
+  
+```vb  
+Imports System  
+Imports System.Management  
+Imports ROOT.CIMV2.Win32  
+  
+Public Class App     
+   Public Shared Sub Main()        
+      ' Enumerate instances of the Win32_process.  
+      ' Print the Name property of the instance.  
+      Dim ps As Process     
+      For Each ps In  Process.GetInstances()  
+         Console.WriteLine(ps.Name)  
+      Next ps  
+  
+      ' Initialize the instance of LogicalDisk with  
+      ' the WMI instance pointing to logical drive d:.  
+      Dim dskD As New LogicalDisk(New _  
+         ManagementPath("win32_LogicalDisk.DeviceId=""d:"""))  
+      Console.WriteLine(dskD.Caption)  
+   End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Management;  
+using ROOT.CIMV2.Win32;  
+  
+public class App  
+{  
+   public static void Main()  
+   {  
+      // Enumerate instances of the Win32_process.  
+      // Print the Name property of the instance.  
+      foreach(Process ps in Process.GetInstances())  
+      {  
+         Console.WriteLine(ps.Name);  
+      }  
+  
+      // Initialize the instance of LogicalDisk with  
+      // the WMI instance pointing to logical drive d:.  
+      LogicalDisk dskD = new LogicalDisk(new ManagementPath(  
+        "win32_LogicalDisk.DeviceId=\"d:\""));  
+      Console.WriteLine(dskD.Caption);  
+   }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Management>   
+ <xref:System.Management.ManagementClass.GetStronglyTypedClassCode%2A?displayProperty=fullName>   
+ <xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md b/docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md
new file mode 100644
index 00000000000..e4a6bda3eda
--- /dev/null
+++ b/docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md
@@ -0,0 +1,145 @@
+---
+title: "Mpgo.exe (マネージ プロファイル ガイド付き最適化ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "マネージ プロファイル ガイド付き最適化ツール"
+  - "Mpgo.exe"
+  - "Ngen.exe"
+  - "Ngen.exe, プロファイラーおよびネイティブ イメージ"
+  - "トレーニング シナリオ, プロファイルの生成"
+ms.assetid: f6976502-a000-4fbe-aaf5-a7aab9ce4ec2
+caps.latest.revision: 31
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# Mpgo.exe (マネージ プロファイル ガイド付き最適化ツール)
+マネージ プロファイル ガイド付き最適化ツール \(Mpgo.exe\) は、[ネイティブ イメージ ジェネレーター \(Ngen.exe\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) によって作成されたネイティブ イメージ アセンブリを最適化するために一般的なエンド ユーザー シナリオを使用するコマンド ライン ツールです。  このツールによって、プロファイル データを生成するトレーニング シナリオを実行できます。  [ネイティブ イメージ ジェネレーター \(Ngen.exe\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) は、このデータを使用して、生成されたネイティブ イメージ アプリケーション アセンブリを最適化します。  トレーニングのシナリオでは、アプリケーションで予期される使用について試行します。  Mpgo.exe は、Visual Studio Ultimate 2012 以降のバージョンで使用できます。  また、[!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] から、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを最適化するために、Mpgo.exe を使用できます。  
+  
+ ガイド付き最適化のプロファイルは、トレーニング シナリオからデータを収集し、ネイティブ イメージのレイアウトを最適化するためにそのデータを使用することによって、アプリケーションの起動時間、メモリ使用率 \(ワーキング セット サイズ\)、およびスループットを向上させます。  
+  
+ 中間言語 \(IL\) アセンブリの起動時間および作業セット サイズでパフォーマンスの問題が見つかった場合、Just\-In\-Time \(JIT\) コンパイルのコストを回避し、コード共有を容易にするために、最初に Ngen.exe を使用することをお勧めします。  さらなる向上が必要な場合は、アプリケーションを最適化するために Mpgo.exe を使用できます。  パフォーマンスの向上を評価するためのベースラインとして、最適化されていないネイティブ イメージ アセンブリからのパフォーマンス データを使用できます。  Mpgo.exe を使用することにより、コールド スタートの時間を短縮し、作業セットのサイズを縮小できます。  Mpgo.exe は、最適化されたネイティブ イメージ アセンブリを作成するために Ngen.exe で使用される IL アセンブリに情報を追加します。  詳細については、.NET ブログ エントリの「[デスクトップ アプリケーションの起動時のパフォーマンスの向上](http://go.microsoft.com/fwlink/p/?LinkId=248943)」を参照してください。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、管理者の資格情報で開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用し、コマンド プロンプトで次のように入力します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ デスクトップ アプリの場合:  
+  
+```  
+mpgo –Scenario <command> [-Import <directory>] –AssemblyList <assembly1>  <assembly2> ... -OutDir <directory> [options]  
+```  
+  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリの場合:  
+  
+## 構文  
+  
+```  
+mpgo –Scenario <packageName> -AppID <appId> -Timeout <seconds>  
+```  
+  
+#### パラメーター  
+ Mpgo.exe では、どの引数も大文字と小文字が区別されません。  コマンドには、ダッシュがプレフィックスとして付けられます。  
+  
+> [!NOTE]
+>  必要なコマンドとして `–Scenario` または `–Import` のいずれかを使用できますが、両方は使用できません。  `–Reset` オプションを指定する場合、必須パラメーターのいずれも使用されません。  
+  
+|必須パラメーター|説明|  
+|--------------|--------|  
+|`-Scenario` \<*command*\><br /><br /> または<br /><br /> `-Scenario` \<*packageName*\><br /><br /> または<br /><br /> `-Import` \<*directory*\>|デスクトップ アプリでは、コマンド ライン引数も含めて、最適化するアプリケーションを実行するためのコマンド指定のために `–Scenario` を使用します。  スペースを含むパスを指定する場合は、*コマンド* を 3 組の二重引用符で囲みます \(例: `mpgo.exe -scenario """C:\My App\myapp.exe""" -assemblylist """C:\My App\myapp.exe""" -outdir "C:\optimized files"`\)。  二重引用符は使用しません。*command* にスペースが含まれる場合に、正しく機能しません。<br /><br /> または<br /><br /> [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでは、プロファイル情報を生成するパッケージを指定するために `–Scenario` を使用します。  完全なパッケージ名ではなく、パッケージの表示名またはファミリ名を指定した場合、Mpgo.exe では単一の一致のみが存在するときに指定の名前に一致するパッケージが選択されます。  指定の名前に複数のパッケージが一致する場合、Mpgo.exe ではパッケージを選択するように求めるプロンプトが表示されます。<br /><br /> または<br /><br /> `-Import` でアセンブリを最適化するために、以前に最適化されたアセンブリからの最適化データを使用する旨を指定するには `-AssemblyList` を使用します。  *directory* では、以前に最適化されたファイルを含めるディレクトリを指定します。  `–AssemblyList` または `–AssemblyListFile` で指定するアセンブリは、インポートされたファイルのデータを使用して最適化されるアセンブリの新しいバージョンです。  古いバージョンのアセンブリからの最適化データを使用することによって、シナリオを再実行しなくてもアセンブリの新しいバージョンを最適化できます。  ただし、インポートしたターゲット アセンブリのコードが大きく異なる場合は、最適化データは非効率的になります。  `–AssemblyList` または `–AssemblyListFile` で指定するアセンブリ名は、`–Import` *ディレクトリ* によって指定するディレクトリに存在する必要があります。  スペースを含むパスを指定する場合は、*directory* を 3 組の二重引用符で囲みます。<br /><br /> `–Scenario` または `–Import` のいずれかを指定する必要がありますが、両方のパラメーターを指定する必要はありません。|  
+|`-OutDir` \<*directory*\>|最適化されたアセンブリを配置するディレクトリ。  出力ディレクトリ フォルダーにアセンブリが既に存在する場合、新しいコピーが作成され、その名前にインデックス番号が付加されます \(例: *assemblyname*\-1.exe\)。  スペースを含むパスを指定する場合は、*directory* を二重引用符で囲みます。|  
+|`-AssemblyList` \<*assembly1 assembly2 ...*\><br /><br /> または<br /><br /> `-AssemblyListFile` \<*file*\>|プロファイル情報を収集するスペースで区切った \(.exe ファイルおよび .dll ファイルを含む\) アセンブリのリスト。  `C:\Dir\*.dll` または `*.dll` を指定して、指定した作業ディレクトリまたは現在の作業ディレクトリのアセンブリをすべて選択できます。  詳細については、次の「解説」を参照してください。<br /><br /> または<br /><br /> 行ごとに 1 つのアセンブリを記述した、プロファイル情報を収集するアセンブリのリストを含むテキスト ファイル。  アセンブリ名の先頭がハイフン \(\-\) である場合は、アセンブリ ファイル リストを使用するか、またはアセンブリ名を変更します。|  
+|`-AppID` \<*appId*\>|指定したパッケージのアプリケーション ID。  ワイルドカード \(\*\) を使用した場合、Mpgo.exe はパッケージ内の AppID の列挙を試み、失敗した場合は \<*package\_family\_name*\>\!App にフォール バックします。  感嘆符 \(\!\) のプレフィックスを付けた文字列を指定した場合、Mpgo.exe ではパッケージ ファミリ名と指定した引数が連結されます。|  
+|`-Timeout` \<*seconds*\>|[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリが終了するまでに実行を許可される時間。|  
+  
+|省略可能なパラメーター|説明|  
+|-----------------|--------|  
+|`-64bit`|64 ビット システムのアセンブリをインストルメント化します。  アセンブリ自体が 64 ビットとして宣言していても、このパラメーターを 64 ビット アセンブリ用に指定する必要があります。|  
+|`-ExeConfig` \<*filename*\>|シナリオがバージョンおよびローダーの情報を指定するために使用する構成ファイルを指定します。|  
+|`-f`|バイナリ アセンブリには、署名済みであってもプロファイル データを強制的に含めます。  アセンブリが署名されている場合、再署名が必要です。再署名しない場合は、アセンブリの読み込みおよび実行が失敗します。|  
+|`-Reset`|中止されたプロファイル セッションがアセンブリに影響しないことを確認するために環境をリセットして、終了します。  環境は、プロファイル セッションの前後に既定でリセットされます。|  
+|`-Timeout` \<*time in seconds*\>|プロファイルの継続期間を秒単位で指定します。  計測した GUI アプリケーションの起動時間よりも少し大きい値を使用します。  タイムアウト期間の終了時に、アプリケーションは実行を続行しますが、プロファイル データが記録されます。  このオプションを設定しない場合、プロファイリングはアプリケーションのシャットダウンまで続行され、その時点までデータが記録されます。|  
+|`-LeaveNativeImages`|インストルメント化されたネイティブ イメージはシナリオの実行後に削除されないことを指定します。  このオプションは、主に、実行中のシナリオ用に指定したアプリケーションを取得するときに使用されます。  これにより、Mpgo.exe のその後の実行に対してネイティブ イメージを再生成できなくなります。  このオプションを指定した場合、アプリケーションの実行の完了後に、キャッシュ内に孤立したネイティブ イメージが存在する可能性があります。  この場合、同じシナリオおよびアセンブリ リストと共に Mpgo.exe を実行し、`–RemoveNativeImages` パラメーターを使用することによって、こうしたネイティブ イメージを削除します。|  
+|`-RemoveNativeImages`|`–LeaveNativeImages` が指定された実行からクリーンアップします。  `-RemoveNativeImages` を指定すると、Mpgo.exe は `-64bit` と `–AssemblyList` を除く引数を無視して、すべてのインストルメントされたネイティブ イメージを削除すると終了します。|  
+  
+## 解説  
+ `–AssemblyList` と `- AssemblyListFile` の両方をコマンド行で複数回、使用できます。  
+  
+ アセンブリを指定する際に完全パス名を指定しないと、Mpgo.exe は現在のディレクトリ内を調べます。  正しくないパスを指定した場合、Mpgo.exe がエラー メッセージを表示しますが、他のアセンブリに対するデータの生成は続行されます。  トレーニング シナリオの実行中に読み込まれていないアセンブリを指定すると、トレーニングのデータがそのアセンブリに対して生成されません。  
+  
+ リストのアセンブリがグローバル アセンブリ キャッシュ内にある場合、そのアセンブリはプロファイル情報を含めるように更新されません。  プロファイル情報を収集するには、グローバル アセンブリ キャッシュから削除します。  
+  
+ プリコンパイルされたネイティブ イメージの利点は一般的に、実行時の JIT コンパイルが大幅に除外される場合に限り得られるので、大規模なマネージ アプリケーションでのみ、Ngen.exe および Mpgo.exe を使用することをお勧めします。  作業セットを集中的に使用しない "Hello World" スタイルのアプリケーションに対して Mpgo.exe を実行すると、利点は得られず、Mpgo.exe でプロファイル データの収集に失敗することすらあります。  
+  
+> [!NOTE]
+>  Ngen.exe および Mpgo.exe は、ASP.NET アプリケーションおよび Windows Communication Foundation \(WCF\) サービスでは推奨されません。  
+  
+## Mpgo.exe を使用するには  
+  
+1.  Visual Studio Ultimate 2012 およびアプリケーションがインストールされたコンピューターを使用します。  
+  
+2.  管理者として必要なパラメーターと共に Mpgo.exe を実行します。  サンプル コマンドについては、次のセクションを参照してください。  
+  
+     最適化された中間言語 \(IL\) アセンブリが `–OutDir` パラメーターによって指定したフォルダー内に作成されます \(この例では、`C:\Optimized` フォルダー\)。  
+  
+3.  `–OutDir` によって指定したディレクトリからのプロファイル情報を含む新しい IL アセンブリにより、Ngen.exe で使用する IL アセンブリを置き換えます。  
+  
+4.  \(Mpgo.exe によって提供されるイメージを使用した\) アプリケーション セットアップでは、最適化されたネイティブなイメージがインストールされます。  
+  
+## 推奨されるワークフロー  
+  
+1.  `–Scenario` パラメーターと共に Mpgo.exe を使用することにより、一連の最適化された IL アセンブリを作成します。  
+  
+2.  ソース管理に最適化された IL アセンブリをチェックインします。  
+  
+3.  ビルド プロセスで、Ngen.exe に渡す最適化された IL イメージを生成するために、ビルド後のステップとして `–Import` パラメーターと共に Mpgo.exe を呼び出します。  
+  
+ このプロセスでは、すべてのアセンブリが最適化データを持つことが保証されます。  更新および最適化されたアセンブリのチェックインをより頻繁に行う場合 \(ステップ 1 および 2\)、製品開発全体でパフォーマンス値はより一貫したものになります。  
+  
+## Visual Studio の Mpgo.exe の使用  
+ Visual Studio から次の制限で Mpgo.exe を実行できます \(記事 [方法 : ビルド イベントを指定する \(C\#\)](../Topic/How%20to:%20Specify%20Build%20Events%20\(C%23\).md) を参照してください\)。  
+  
+-   既定では Visual Studio マクロも末尾でスラッシュを使用するので、末尾にスラッシュを含む引用符付きのパスを使用することはできません。  \(たとえば、`–OutDir "C:\Output Folder\"` は無効です。\) この制限を回避するために、末尾のスラッシュをエスケープできます。  \(たとえば、代わりに `-OutDir "$(OutDir)\"` を使用します。\)  
+  
+-   既定では、Mpgo.exe は Visual Studio のビルド パス上にありません。  Visual Studio にこのパスを追加するか、Mpgo のコマンド ラインで完全パスを指定する必要があります。  Visual Studio でビルド後イベントに `–Scenario` または `–Import` パラメーターのいずれかを使用できます。  ただし、通常のプロセスは開発者コマンド プロンプトから `–Scenario` を 1 度使用し、その後各ビルド後に最適化されたアセンブリを更新するために `–Import` を使用します \(たとえば、`"C:\Program Files\Microsoft Visual Studio 11.0\Team Tools\Performance Tools\mpgo.exe" -import "$(OutDir)tmp" -assemblylist "$(TargetPath)" -outdir "$(OutDir)\"`\)。  
+  
+<a name="samples"></a>   
+## 使用例  
+ Visual Studio 開発者コマンド プロンプトから次の Mpgo.exe コマンドにより税処理アプリケーションを最適化します。  
+  
+```  
+mpgo –scenario "C:\MyApp\MyTax.exe /params par" –AssemblyList Mytax.dll MyTaxUtil2011.dll –OutDir C:\Optimized –TimeOut 15  
+  
+```  
+  
+ 次の Mpgo.exe コマンドはサウンド アプリケーションを最適化します。  
+  
+```  
+mpgo –scenario "C:\MyApp\wav2wma.exe –input song1.wav –output song1.wma" –AssemblyList transcode.dll –OutDir C:\Optimized –TimeOut 15  
+  
+```  
+  
+ 次の Mpgo.exe コマンドは、新しいバージョンのアセンブリを最適化するために、以前に最適化されたアセンブリからのデータを使用します。  
+  
+```  
+mpgo.exe -import "C:\Optimized" -assemblylist "C:\MyApp\MyTax.dll" "C:\MyApp\MyTaxUtil2011.dll" -outdir C:\ReOptimized  
+  
+```  
+  
+## 参照  
+ [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)   
+ [デスクトップ アプリケーションの起動時のパフォーマンスの向上](http://go.microsoft.com/fwlink/p/?LinkId=248943)   
+ [.NET 4.5 におけるパフォーマンス向上の概要](http://go.microsoft.com/fwlink/p/?LinkId=249131)
\ No newline at end of file
diff --git a/docs/framework/tools/ngen-exe-native-image-generator.md b/docs/framework/tools/ngen-exe-native-image-generator.md
new file mode 100644
index 00000000000..dfee5da8a04
--- /dev/null
+++ b/docs/framework/tools/ngen-exe-native-image-generator.md
@@ -0,0 +1,528 @@
+---
+title: "Ngen.exe (ネイティブ イメージ ジェネレーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], ネイティブ イメージ"
+  - "イメージ [.NET Framework], native"
+  - "無効なイメージ"
+  - "ネイティブ イメージ キャッシュ"
+  - "ネイティブ イメージの生成"
+  - "ネイティブ イメージ ジェネレーター"
+  - "Ngen.exe"
+  - "発行者ポリシー (ネイティブ イメージに適用される)"
+  - "side-by-side 実行, ネイティブ イメージ"
+ms.assetid: 44bf97aa-a9a4-4eba-9a0d-cfaa6fc53a66
+caps.latest.revision: 57
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# Ngen.exe (ネイティブ イメージ ジェネレーター)
+ネイティブ イメージ ジェネレーター \(Ngen.exe\) は、マネージ アプリケーションのパフォーマンスを向上するツールです。  Ngen.exe は、コンパイルされたプロセッサ固有のマシン コードを含むファイルであるネイティブ イメージを作成してローカル コンピューターのネイティブ イメージ キャッシュにインストールします。  ランタイムは、Just\-In\-Time \(JIT\) コンパイラを使用してオリジナルのアセンブリをコンパイルする代わりに、キャッシュにあるネイティブ イメージを使用できます。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、次の変更が Ngen.exe に加えられました。  
+  
+-   Ngen.exe によるアセンブリのコンパイルが完全信頼で行われるようになり、コード アクセス セキュリティ \(CAS: Code Access Security\) ポリシーが評価されなくなりました。  
+  
+-   Ngen.exe で生成されたネイティブ イメージを、部分信頼で実行されているアプリケーションに読み込むことができなくなりました。  
+  
+ .NET Framework Version 2.0 では、次の変更が Ngen.exe に加えられました。  
+  
+-   アセンブリと共にその依存関係もインストールされることで、Ngen.exe の構文が簡略化されました。  
+  
+-   ネイティブ イメージをアプリケーション ドメイン間で共有できるようになりました。  
+  
+-   新しいアクションの `update` は、無効になっていたイメージを再作成します。  
+  
+-   アクションの実行は、コンピューターのアイドル時間を使用してイメージを生成してインストールするサービスによって遅らせることができます。  
+  
+-   イメージを無効化する原因の一部が解決されました。  
+  
+ Windows 8 の場合、「[Native Image Task](http://msdn.microsoft.com/ja-jp/9b1f7590-4e0d-4737-90ef-eaf696932afb)」をご覧ください。  
+  
+ Ngen.exe とネイティブ イメージ サービスの使用に関する追加情報については、「[Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)」をご覧ください。  
+  
+> [!NOTE]
+>  .NET Framework バージョン 1.0 とバージョン 1.1 の Ngen.exe 構文は、「[Native Image Generator \(Ngen.exe\) Legacy Syntax](http://msdn.microsoft.com/ja-jp/5a69fc7a-103f-4afc-8ab4-606adcb46324)」に記されています。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+        ngen action [options]  
+ngen /? | /help  
+```  
+  
+## アクション  
+ 各 `action` の構文を示す表を次に示します。  `action` の各部分の説明については、「[引数](#ArgumentTable)」、「[優先順位](#PriorityTable)」、「[シナリオ](#ScenarioTable)」、および「[構成](#ConfigTable)」の各表を参照してください。  [およびヘルプ スイッチについては](#OptionTable)、「`options`オプション」の表を参照してください。  
+  
+|アクション|説明|  
+|-----------|--------|  
+|`install` \[`assemblyName` &#124; `assemblyPath`\] \[`scenarios`\] \[`config`\] \[`/queue`\[`:`{`1`&#124;`2`&#124;`3`}\]\]|アセンブリおよびそれに依存する項目のネイティブ イメージを生成してネイティブ イメージ キャッシュにインストールします。<br /><br /> `/queue` を指定すると、アクションはネイティブ イメージ サービスのキューに置かれます。  既定の優先順位は 3 です。  「[優先順位](#PriorityTable)」の表を参照してください。|  
+|`uninstall` \[`assemblyName` &#124; `assemblyPath`\] \[`scenarios`\] \[`config`\]|アセンブリのネイティブ イメージとその依存関係をネイティブ イメージ キャッシュから削除します。<br /><br /> 単一のイメージとその依存関係をアンインストールするには、そのイメージをインストールしたときと同じコマンド ライン引数を使用します。 **Note:**  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、アクション `uninstall` \* はサポートされなくなりました。|  
+|`update` \[`/queue`\]|無効になったネイティブ イメージを更新します。<br /><br /> `/queue` を指定すると、更新はネイティブ イメージ サービスのキューに置かれます。  更新は常に優先順位 3 でスケジュールされるため、コンピューターがアイドル状態のときに実行されます。|  
+|`display` \[`assemblyName` &#124; `assemblyPath`\]|アセンブリのネイティブ イメージとその依存関係の状態を表示します。<br /><br /> 引数を指定しなければ、ネイティブ イメージ キャッシュのすべての内容が表示されます。|  
+|`executeQueuedItems` \[`1` `&#124;`  `2`  `&#124;` `3`\]<br /><br /> または<br /><br /> `eqi` \[1&#124;2&#124;3\]|キューに置かれているコンパイル ジョブを実行します。<br /><br /> 優先順位を指定すると、優先順位が高いかまたは同じコンパイル ジョブが実行されます。  優先順位を指定しなければ、キューに置かれているすべてのコンパイル ジョブが実行されます。|  
+|`queue` {`pause` &#124; `continue` &#124; `status`}|ネイティブ イメージ サービスを一時停止するか、停止しているサービスを再開するか、またはサービスの状態を照会します。|  
+  
+<a name="ArgumentTable"></a>   
+## 引数  
+  
+|引数|説明|  
+|--------|--------|  
+|`assemblyName`|アセンブリの完全な表示名。  たとえば、`"myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5"` のようにします。 **Note:**  `myAssembly` アクションおよび `display` アクションに対しては、`uninstall` などのように部分的なアセンブリ名を指定できます。 <br /><br /> Ngen.exe の各コマンド ラインに指定できるアセンブリは 1 つだけです。|  
+|`assemblyPath`|アセンブリの明示的なパスを返します。  フル パスまたは相対パスを指定できます。<br /><br /> パスを指定せずにファイル名を指定する場合、アセンブリは現在のディレクトリに存在する必要があります。<br /><br /> Ngen.exe の各コマンド ラインに指定できるアセンブリは 1 つだけです。|  
+  
+<a name="PriorityTable"></a>   
+## 優先順位  
+  
+|優先度|説明|  
+|---------|--------|  
+|`1`|ネイティブ イメージが生成され、アイドル時間まで待たずに直ちにインストールされます。|  
+|`2`|ネイティブ イメージが生成され、アイドル時間まで待たずにインストールされますが、優先順位 1 のすべてのアクション \(およびその依存関係\) が完了した後にインストールされます。|  
+|`3`|コンピューターがアイドル状態になったことをネイティブ イメージ サービスが検出するとネイティブ イメージがインストールされます。  「[Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)」をご覧ください。|  
+  
+<a name="ScenarioTable"></a>   
+## シナリオ  
+  
+|シナリオ|説明|  
+|----------|--------|  
+|`/Debug`|デバッガーで使用できるネイティブ イメージを生成します。|  
+|`/Profile`|プロファイラーで使用できるネイティブ イメージを生成します。|  
+|`/NoDependencies`|指定されたシナリオのオプションに必要なネイティブ イメージの最小数を生成します。|  
+  
+<a name="ConfigTable"></a>   
+## 構成  
+  
+|構成|説明|  
+|--------|--------|  
+|`/ExeConfig:` `exePath`|指定された実行可能アセンブリの構成を使用します。<br /><br /> Ngen.exe は、依存関係にバインドする際に、ローダーと同じ決定をする必要があります。  <xref:System.Reflection.Assembly.Load%2A> メソッドを使用して共有コンポーネントが実行時に読み込まれると、読み込まれた依存関係のバージョンなどの共有コンポーネント用に読み込まれた依存関係はアプリケーションの構成ファイルによって決定されます。  `/ExeConfig` スイッチは、実行時にどの依存関係を読み込むかに関するガイダンスを Ngen.exe に提供します。|  
+|`/AppBase:` `directoryPath`|依存関係を検索するときは、アプリケーション ベースに指定されているディレクトリを使用します。|  
+  
+<a name="OptionTable"></a>   
+## オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/nologo`|Microsoft 著作権情報を表示しません。|  
+|`/silent`|成功メッセージを表示しません。|  
+|`/verbose`|デバッグの詳細情報を表示します。 **Note:**  オペレーティング システムの制限により、Windows 98 と Windows Millennium Edition では追加情報は表示されません。|  
+|`/help`, `/?`|現在のリリースのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ Ngen.exe を実行するには、管理特権が必要です。  
+  
+> [!CAUTION]
+>  完全に信頼されていないアセンブリで Ngen.exe を実行しないでください。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、Ngen.exe によるアセンブリのコンパイルが完全信頼で行われるようになり、コード アクセス セキュリティ \(CAS\) ポリシーが評価されなくなりました。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、Ngen.exe で生成されたネイティブ イメージを、部分信頼で実行されているアプリケーションに読み込むことができなくなりました。  代わりに、Just\-In\-Time \(JIT\) コンパイラが呼び出されます。  
+  
+ Ngen.exe は、指定されたアセンブリおよびそのすべての依存項目のネイティブ イメージを生成します。  依存関係は、アセンブリ マニフェストを参照して決定されます。  依存関係を別個にインストールする必要があるのは、アプリケーションがリフレクションを使用して依存関係を読み込む場合だけです。たとえば <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを呼び出して依存関係を読み込む場合などです。  
+  
+> [!IMPORTANT]
+>  ネイティブ イメージに <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> メソッドは使用しないでください。  実行コンテキストの他のアセンブリは、このメソッドを使用して読み込まれるイメージを使用できません。  
+  
+ Ngen.exe は依存関係のカウントを保持します。  たとえば、`MyAssembly.exe` と `YourAssembly.exe` がネイティブ イメージ キャッシュにインストールされており、この両方とも `OurDependency.dll` を参照するとします。  `MyAssembly.exe` がアンインストールされても、`OurDependency.dll` はアンインストールされません。  これが削除されるのは、`YourAssembly.exe` もアンインストールされた場合だけです。  
+  
+ アセンブリのネイティブ イメージをグローバル アセンブリ キャッシュに生成している場合は表示名を指定します。  「<xref:System.Reflection.Assembly.FullName%2A?displayProperty=fullName>」を参照してください。  
+  
+ Ngen.exe が生成するネイティブ イメージは、アプリケーション ドメイン間で共有できます。  つまり、アプリケーション ドメイン間でアセンブリを共有する必要のあるアプリケーション シナリオでは Ngen.exe を使用できます。  ドメイン中立性は、次の手順で指定します。  
+  
+-   アプリケーションに <xref:System.LoaderOptimizationAttribute> 属性を適用します。  
+  
+-   新しいアプリケーション ドメインのセットアップ情報を作成するときは、<xref:System.AppDomainSetup.LoaderOptimization%2A?displayProperty=fullName> プロパティを設定します。  
+  
+ 複数のアプリケーション ドメインに同じアセンブリを読み込むときは、必ずドメイン中立のコードを使用します。  共有ドメインに読み込んだ後に非共有アプリケーション ドメインに読み込んだネイティブ イメージは使用できません。  
+  
+> [!NOTE]
+>  ドメイン中立コードはアンロードできません。また、特に静的メンバーにアクセスする際にパフォーマンスがわずかに低下します。  
+  
+## 別のシナリオのためのイメージの生成  
+ アセンブリのネイティブ イメージが生成された後でそのアセンブリを実行する場合、ランタイムは、常にこのネイティブ イメージを自動的に検索して使用しようとします。  使用シナリオによっては、複数のイメージを生成できます。  
+  
+ たとえば、デバッグまたはプロファイルの目的でアセンブリを実行する場合、ランタイムは、`/Debug` または `/Profile` の各オプションを指定して生成されたネイティブ イメージを検索します。  一致するネイティブ イメージが見つからない場合、ランタイムは標準の JIT コンパイルに戻ります。  ネイティブ イメージをデバッグする唯一の方法は、`/Debug` オプションを使用してネイティブ イメージを作成することです。  
+  
+ `uninstall` アクションもシナリオを認識するため、すべてのシナリオまたは指定したシナリオだけをアンインストールできます。  
+  
+## ネイティブ イメージを使用する状況の決定  
+ ネイティブ イメージによって、メモリ使用の改善と起動時間の短縮の 2 つの領域においてパフォーマンスが向上します。  
+  
+> [!NOTE]
+>  ネイティブ イメージのパフォーマンスは、コード、データ アクセス パターン、モジュール境界を超える呼び出しの数、他のアプリケーションによって既に読み込まれている依存関係の数などの多くの要素に依存するため分析が困難です。  ネイティブ イメージがアプリケーションの利益になるかどうかを確認する唯一の方法は、主な配置シナリオにおいて慎重にパフォーマンスを測定することです。  
+  
+### メモリ使用の改善  
+ プロセス間でコードを共有する場合は、ネイティブ イメージによってメモリ使用を大いに改善できます。  ネイティブ イメージは Windows PE ファイルのため、.dll ファイルの単一のコピーを複数のプロセスで共有できます。これに対して、JIT コンパイラが生成するネイティブ コードは、プライベート メモリに格納されるため共有できません。  
+  
+ ターミナル サービスで実行されるアプリケーションも、共有されたコード ページの恩恵を受けることができます。  
+  
+ さらに、JIT コンパイラを読み込まないため、各アプリケーション インスタンスが使用する固定メモリの量も減らすことができます。  
+  
+### アプリケーションの起動の高速化  
+ Ngen.exe によってアセンブリをプリコンパイルすることにより、一部のアプリケーションの起動時間が短縮されます。  一般に、最初のアプリケーションが起動されると、その後のアプリケーションが使用する共有コンポーネントが読み込まれるため、アプリケーションがコンポーネント アセンブリを共有している場合にアプリケーションの起動時間が短縮されます。  アプリケーションのすべてのアセンブリをハード ディスクから読み込む必要があるコールド スタートでは、ハード ディスクのアクセス時間の影響の方が大きいため、ネイティブ イメージから受け取る恩恵はそれほど大きくありません。  
+  
+ メイン アプリケーション アセンブリにハード バインディングされているすべてのイメージは同時に読み込む必要があるため、ハード バインディングは起動時間に影響します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v35SP1_long](../../../includes/net-v35sp1-long-md.md)] より前のバージョンでは、厳密な名前付きの共有コンポーネントをグローバル アセンブリ キャッシュに配置する必要があります。これは、グローバル アセンブリ キャッシュ以外に配置されている厳密な名前付きのアセンブリに対してローダーが余分な検証を行うため、起動時間は短縮されず、実質的にネイティブ イメージを使用する意味がなくなります。  [!INCLUDE[net_v35SP1_short](../../../includes/net-v35sp1-short-md.md)] で導入された最適化により、この余分な検証は削除されました。  
+  
+### アセンブリのベース アドレスの重要性  
+ ネイティブ イメージは Windows PE ファイルのため、他の実行可能ファイルと同様に再ベースの問題があります。  ハード バインディングを使用する場合、再配置のパフォーマンス コストはさらに増大します。  
+  
+ ネイティブ イメージにベース アドレスを設定するには、コンパイラの適切なオプションを使用してアセンブリのベース アドレスを設定します。  Ngen.exe は、このベース アドレスをネイティブ イメージに使用します。  
+  
+> [!NOTE]
+>  ネイティブ イメージは、元になるマネージ アセンブリより大きくなります。  ベース アドレスは、この大きなサイズを考慮して算出する必要があります。  
+  
+ dumpbin.exe などのツールを使用すると、ネイティブ イメージの推奨ベース アドレスを表示できます。  
+  
+### 使用における考慮事項のまとめ  
+ 次の一般的な考慮事項とアプリケーションの考慮事項は、アプリケーションにネイティブ イメージを使用するかどうかを評価する際に役立ちます。  
+  
+-   ネイティブ イメージでは、JIT コンパイル、タイプ セーフ検証などの多くの起動時アクティビティが不要なため、MSIL より読み込みが高速になります。  
+  
+-   ネイティブ イメージでは JIT コンパイラが不要なため、必要な初期作業セットが少なくてすみます。  
+  
+-   ネイティブ イメージによって、プロセス間でコードを共有できます。  
+  
+-   ネイティブ イメージは MSIL アセンブリよりも多くのハード ディスク容量を必要とし、生成にかなりの時間を要する場合があります。  
+  
+-   ネイティブ イメージは保持する必要があります。  
+  
+    -   元のアセンブリまたはその依存関係のいずれかに対してサービスを提供する場合は、イメージを再生成する必要があります。  
+  
+    -   アプリケーションまたはシナリオごとに異なるネイティブ イメージを使用する場合、1 つのアセンブリで複数のネイティブ イメージが必要な場合があります。  たとえば、2 つのアプリケーションの構成情報で、同じ依存アセンブリに対してバインディング決定が異なる場合です。  
+  
+    -   ネイティブ イメージは管理者が作成する必要があります。つまり Administrators グループの Windows アカウントから作成します。  
+  
+ このような一般的な考慮事項に加えて、ネイティブ イメージによってパフォーマンスが向上するかどうかを検討する場合は、アプリケーションの特性も考慮する必要があります。  
+  
+-   多くの共有コンポーネントを使用する環境でアプリケーションを実行する場合は、ネイティブ イメージによってコンポーネントを複数のプロセスで共有できます。  
+  
+-   アプリケーションが複数のアプリケーション ドメインを使用する場合は、ネイティブ イメージによってドメイン間でコード ページを共有できます。  
+  
+    > [!NOTE]
+    >  .NET Framework Version 1.0 と 1.1 では、アプリケーション ドメイン間でネイティブ イメージを共有することはできません。  Version 2.0 以降では可能です。  
+  
+-   アプリケーションをターミナル サーバーで実行する場合は、ネイティブ イメージによってコード ページを共有できます。  
+  
+-   サイズの大きなアプリケーションでは、一般にネイティブ イメージにコンパイルすることでパフォーマンスが向上します。  サイズの小さなアプリケーションでは、一般にあまり有効ではありません。  
+  
+-   長時間実行するアプリケーションでは、ランタイム JIT コンパイルのパフォーマンスの方がネイティブ イメージよりも若干優れています。  ハード バインディングによって、このパフォーマンスの違いをある程度緩和できます。  
+  
+## ハード バインディング  
+ ハード バインディングによってスループットが向上し、ネイティブ イメージの作業セットのサイズが小さくなります。  ハード バインディングの短所は、アセンブリを読み込む際にアセンブリにハード バインディングされているすべてのイメージを読み込む必要があることです。  これによって、大きなアプリケーションの起動時間がかなり長くなります。  
+  
+ ハード バインディングは、すべてのアプリケーションのパフォーマンスが重要な意味を持つシナリオで読み込まれる依存関係に適しています。  ネイティブ イメージの使用のすべての局面において言えることですが、ハード バインディングによってアプリケーションのパフォーマンスが向上するかどうかを確認する唯一の方法は、パフォーマンスを慎重に測定することです。  
+  
+ <xref:System.Runtime.CompilerServices.DependencyAttribute> 属性と <xref:System.Runtime.CompilerServices.DefaultDependencyAttribute> 属性によって、ハード バインディング ヒントを Ngen.exe に提供できます。  
+  
+> [!NOTE]
+>  この 2 つの属性は、コマンドではなく Ngen.exe へのヒントです。  これらの属性を使用してもハード バインディングは保証されません。  属性の意味は、今後のリリースで変更される可能性があります。  
+  
+### 依存関係のバインディング ヒントの指定  
+ アセンブリに <xref:System.Runtime.CompilerServices.DependencyAttribute> を適用して、指定された依存関係が読み込まれるかどうかを示します  <xref:System.Runtime.CompilerServices.LoadHint?displayProperty=fullName> は、ハード バインディングが適切であることを示します。<xref:System.Runtime.CompilerServices.LoadHint> は、依存関係の既定値を使用する必要があることを示します。<xref:System.Runtime.CompilerServices.LoadHint> は、ハード バインディングが適切ではないことを示します。  
+  
+ 2 つの依存関係があるアセンブリのための属性のコードを次に示します。  最初の依存関係 \(Assembly1\) はハード バインディングに適しており、2 番目 \(Assembly2\) は適していません。  
+  
+```vb  
+Imports System.Runtime.CompilerServices  
+<Assembly:DependencyAttribute("Assembly1", LoadHint.Always)>  
+<Assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)>  
+```  
+  
+```csharp  
+using System.Runtime.CompilerServices;  
+[assembly:DependencyAttribute("Assembly1", LoadHint.Always)]  
+[assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)]  
+```  
+  
+```cpp#  
+using namespace System::Runtime::CompilerServices;  
+[assembly:DependencyAttribute("Assembly1", LoadHint.Always)];  
+[assembly:DependencyAttribute("Assembly2", LoadHint.Sometimes)];  
+```  
+  
+ アセンブリ名には、ファイル名拡張子は含めません。  表示名を使用できます。  
+  
+### アセンブリの既定のバインディング ヒントの指定  
+ 既定のバインディング ヒントは、依存するアプリケーションが即座に頻繁に使用するアセンブリだけに必要です。  そのようなアセンブリには、<xref:System.Runtime.CompilerServices.DefaultDependencyAttribute> と共に <xref:System.Runtime.CompilerServices.LoadHint?displayProperty=fullName> を適用して、ハード バインディングを使用することを指定します。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.CompilerServices.DefaultDependencyAttribute> 以外の値を使用してこの属性を適用しても、この属性をまったく適用しない場合と結果は同じため、このカテゴリに属さない .dll アセンブリに <xref:System.Runtime.CompilerServices.LoadHint?displayProperty=fullName> を適用する理由はありません。  
+  
+ Microsoft では、<xref:System.Runtime.CompilerServices.DefaultDependencyAttribute> を使用して、mscorlib.dll などのごく一部の .NET Framework のアセンブリの既定値としてハード バインディングを指定します。  
+  
+## トラブルシューティング  
+ アプリケーションでネイティブ イメージが使用されているかどうかを確認するには、[Fuslogvw.exe \(アセンブリ バインディング ログ ビューアー\)](../../../docs/framework/tools/fuslogvw-exe-assembly-binding-log-viewer.md) を使用できます。  バインディング ログ ビューアーのウィンドウの **\[ログのカテゴリ\]** ボックスで、**\[ネイティブ イメージ\]** をクリックします。  Fuslogvw.exe は、ネイティブ イメージが拒否された理由に関する情報を提供します。  
+  
+ [jitCompilationStart](../../../docs/framework/debug-trace-profile/jitcompilationstart-mda.md) マネージ デバッグ アシスタント \(MDA\) を使用すると、JIT コンパイラが関数のコンパイルを開始するタイミングを判別できます。  
+  
+## 遅延処理  
+ 非常に大きいアプリケーションのネイティブ イメージの生成には、かなりの時間がかかります。  同様に、共有コンポーネントへの変更またはコンピューター設定への変更には、多くのネイティブ イメージの更新が必要になります。  `install` アクションと `update` アクションには `/queue` オプションがあり、これによって、ネイティブ イメージ サービスによる遅延実行をキューに置くことができます。  さらに、Ngen.exe には、サービスを制御するための `queue` アクションと `executeQueuedItems` アクションがあります。  詳細については、「[Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)をご覧ください。  
+  
+## ネイティブ イメージと JIT コンパイル  
+ 生成できないメソッドがアセンブリ内にある場合、Ngen.exe が生成するネイティブ イメージにそのメソッドは含まれません。  ランタイムは、このアセンブリの実行中に JIT コンパイルに戻し、ネイティブ イメージから除外されたこれらのメソッドを処理します。  
+  
+ さらに、アセンブリがアップグレードされた場合、または何らかの理解によってイメージが無効になった場合、ネイティブ イメージは使用されません。  
+  
+### 無効なイメージ  
+ Ngen.exe を使用してアセンブリのネイティブ イメージを作成する場合、出力は指定したコマンド ライン オプションおよび使用するコンピューター上の設定に依存します。  影響のある設定は次のとおりです。  
+  
+-   .NET Framework Version。  
+  
+-   オペレーティング システムのバージョン \(Windows 9x ファミリから Windows NT ファミリに変更した場合\)。  
+  
+-   アセンブリの正確な ID \(ID は再コンパイル時に変更されます\)。  
+  
+-   アセンブリが参照するすべてのアセンブリの正確な ID \(ID は再コンパイル時に変更されます\)。  
+  
+-   セキュリティ関連の要因。  
+  
+ Ngen.exe は、ネイティブ イメージを生成するときに上記の情報を記録します。  アセンブリが実行されると、ランタイムは、コンピューターの現在の環境と一致するオプションおよび設定を指定して生成されたネイティブ イメージを検索します。  一致するネイティブ イメージが見つからない場合、ランタイムはアセンブリを JIT コンパイルに戻します。  コンピューターの設定および環境が次のように変更されると、ネイティブ イメージは無効になります。  
+  
+-   .NET Framework Version。  
+  
+     更新プログラムを .NET Framework に適用すると、Ngen.exe を使用して作成したすべてのネイティブ イメージは、無効になります。  したがって、.NET Framework の更新では、常に `Ngen Update` コマンドが実行されてすべてのネイティブ イメージが再生成されます。  .NET Framework は、インストールする .NET Framework ライブラリの新しいネイティブ イメージを自動的に作成します。  
+  
+-   オペレーティング システムのバージョン \(Windows 9x ファミリから Windows NT ファミリに変更した場合\)。  
+  
+     たとえば、コンピューターで稼動しているオペレーティング システムのバージョンが Windows 98 から Windows XP に変更されると、ネイティブ イメージ キャッシュに格納されたすべてのネイティブ イメージは無効になります。  ただし、オペレーティング システムを Windows 2000 から Windows XP に変更した場合は、イメージは無効になりません。  
+  
+-   アセンブリの正確な ID。  
+  
+     アセンブリを再コンパイルすると、アセンブリの対応するネイティブ イメージは無効になります。  
+  
+-   アセンブリが参照するすべてのアセンブリの正確な ID。  
+  
+     マネージ アセンブリを更新する場合、そのアセンブリに直接または間接に依存するすべてのネイティブ イメージが無効になるため、これらを再生成する必要があります。  これには、通常の参照と強くバインドされた依存関係も含まれます。  ソフトウェア更新プログラムを適用するときには、インストール プログラムで `Ngen Update` コマンドを実行して、依存するすべてのネイティブ イメージを再生成する必要があります。  
+  
+-   セキュリティ関連の要因。  
+  
+     アセンブリに事前に与えられていたアクセス許可を制限するマシン セキュリティ ポリシーを変更すると、そのアセンブリのコンパイル済みのネイティブ イメージが無効になることがあります。  
+  
+     共通言語ランタイムがコード アクセス セキュリティを管理する方法と、アクセス許可を使用する方法について詳しくは、「[コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)」を参照してください。  
+  
+## 例  
+ 次のコマンドは、現在のディレクトリにある `ClientApp.exe` のネイティブ イメージを生成し、ネイティブ イメージ キャッシュにインストールします。  アセンブリの構成ファイルが存在する場合、Ngen.exe はその構成ファイルを使用します。  さらに、ネイティブ イメージは、`ClientApp.exe` が参照するあらゆる .dll ファイルに対して生成されます。  
+  
+```  
+ngen install ClientApp.exe  
+```  
+  
+ Ngen.exe によってインストールされるイメージは、ルートとも呼ばれます。  ルートは、アプリケーションまたは共有コンポーネントです。  
+  
+ 指定したパスにある `MyAssembly.exe` のネイティブ イメージを生成するコマンドを次に示します。  
+  
+```  
+ngen install c:\myfiles\MyAssembly.exe  
+```  
+  
+ アセンブリおよびその依存関係を検索する場合、Ngen.exe は共通言語ランタイムと同じプローブ ロジックを使用します。  既定では、`ClientApp.exe` が格納されているディレクトリがアプリケーションのベース ディレクトリとして使用され、すべてのアセンブリのプローブはこのディレクトリから始まります。  この動作は、`/AppBase` オプションを使用してオーバーライドできます。  
+  
+> [!NOTE]
+>  この動作は、アプリケーション ベースが現在のディレクトリに設定される .NET Framework Version 1.0 と 1.1 における Ngen.exe から変更されています。  
+  
+ アセンブリは、参照を伴わない依存関係を持つことができます。たとえば、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> メソッドを使用して .dll ファイルを読み込む場合などです。  アプリケーション アセンブリの構成情報と `/ExeConfig` オプションを使用して、このような .dll ファイルのネイティブ イメージを作成できます。  `MyLib.dll,` の構成情報を使用して `MyApp.exe` のネイティブ イメージを生成するコマンドを次に示します。  
+  
+```  
+ngen install c:\myfiles\MyLib.dll /ExeConfig:c:\myapps\MyApp.exe  
+```  
+  
+ この方法でインストールされたアセンブリは、アプリケーションと共に削除されません。  
+  
+ 依存関係をアンインストールするには、それをインストールしたときと同じコマンド ライン オプションを使用します。  前の例から `MyLib.dll` をアンインストールするコマンドを次に示します。  
+  
+```  
+ngen uninstall c:\myfiles\MyLib.dll /ExeConfig:c:\myapps\MyApp.exe  
+```  
+  
+ グローバル アセンブリ キャッシュにアセンブリのネイティブ イメージを作成するには、アセンブリの表示名を使用します。  次に例を示します。  
+  
+```  
+ngen install "ClientApp, Version=1.0.0.0, Culture=neutral,   
+  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL"  
+```  
+  
+ NGen.exe は、インストールする各シナリオに対して個別のイメージ セットを生成します。  たとえば、次のコマンドはネイティブ イメージの通常操作用の完全なセット、デバッグ用の完全なセット、およびプロファイル用の第 3 のセットをインストールします。  
+  
+```  
+ngen install MyApp.exe  
+ngen install MyApp.exe /debug  
+ngen install MyApp.exe /profile  
+```  
+  
+### ネイティブ イメージ キャッシュの表示  
+ ネイティブ イメージは、キャッシュにインストールすると、Ngen.exe を使用して表示できます。  ネイティブ イメージ キャッシュ内のすべてのネイティブ イメージを表示するコマンドを次に示します。  
+  
+```  
+ngen display  
+```  
+  
+ `display` アクションは最初にすべてのルート アセンブリを表示し、次にコンピューター上のすべてのネイティブ イメージの一覧を表示します。  
+  
+ アセンブリの情報だけを表示する場合は、アセンブリの簡易名を使用します。  次のコマンドは、部分名 `MyAssembly` に一致するネイティブ イメージ キャッシュのすべてのネイティブ イメージ、その依存関係、および `MyAssembly` に依存するすべてのルートを表示します。  
+  
+```  
+ngen display MyAssembly  
+```  
+  
+ 共有コンポーネント アセンブリに依存するルートを知ることは、共有コンポーネントがアップグレードされた後の `update` アクションの影響を予測する際に役立ちます。  
+  
+ アセンブリのファイル拡張子を指定する場合は、パスを指定するか、またはアセンブリが格納されているディレクトリから Ngen.exe を実行する必要があります。  
+  
+```  
+ngen display c:\myApps\MyAssembly.exe  
+```  
+  
+ ネイティブ イメージ キャッシュ内で `MyAssembly`  という名前を持ち、バージョン 1.0.0.0 であるすべてのネイティブ イメージを表示するコマンドを次に示します。  
+  
+```  
+ngen display "myAssembly, version=1.0.0.0"  
+```  
+  
+### イメージの更新  
+ 一般に、共有コンポーネントがアップグレードされると、イメージが更新されます。  イメージまたは依存関係が変更されたすべてのネイティブ イメージを更新するには、引数なしで `update` アクションを使用します。  
+  
+```  
+ngen update  
+```  
+  
+ すべてのイメージを更新するプロセスは、長くなることがあります。  ネイティブ イメージ サービスによる更新は、`/queue` オプションを使用してキューに置くことができます。  `/queue` オプションとインストールの優先順位の詳細については、「[Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)」をご覧ください。  
+  
+```  
+ngen update /queue  
+```  
+  
+### イメージのアンインストール  
+ Ngen.exe は、共有コンポーネントに依存するすべてのアセンブリが削除された場合だけ共有コンポーネントが削除されるように依存関係の一覧を維持します。  また、ルートとしてインストールされた共有コンポーネントは削除されません。  
+  
+ 次のコマンドは、ルートの `ClientApp.exe` のすべてのシナリオをアンインストールします。  
+  
+```  
+ngen uninstall ClientApp  
+```  
+  
+ `uninstall` アクションは、特定のシナリオを削除するために使用できます。  次のコマンドは、ルートの `ClientApp.exe` のすべてのデバッグ シナリオをアンインストールします。  
+  
+```  
+ngen uninstall ClientApp /debug  
+```  
+  
+> [!NOTE]
+>  `/debug` シナリオをアンインストールしても、`/profile` と `/debug.` の両方を含むシナリオはアンインストールされません。  
+  
+ 次のコマンドは、`ClientApp.exe` の特定のバージョンのすべてのシナリオをアンインストールします。  
+  
+```  
+ngen uninstall "ClientApp, Version=1.0.0.0"  
+```  
+  
+ 次のコマンドは、`"ClientApp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL",` のすべてのシナリオまたはアセンブリのデバッグ シナリオだけをアンインストールします。  
+  
+```  
+ngen uninstall "ClientApp, Version=1.0.0.0, Culture=neutral,   
+  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL"  
+ngen uninstall "ClientApp, Version=1.0.0.0, Culture=neutral,   
+  PublicKeyToken=3c7ba247adcd2081, processorArchitecture=MSIL" /debug  
+```  
+  
+ `install` アクションと同様に、拡張子を指定する場合は、アセンブリが格納されているディレクトリから Ngen.exe を実行するか、またはフル パスを指定する必要があります。  
+  
+ ネイティブ イメージ サービスに関連する例については、「[Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)」をご覧ください。  
+  
+## ネイティブ イメージ タスク  
+ ネイティブ イメージ タスクは、ネイティブ イメージを生成および保持する Windows タスクです。  ネイティブ イメージ タスクは、サポートされるシナリオでネイティブ イメージを自動的に生成し、解放します。  \(「[Creating Native Images](http://msdn.microsoft.com/ja-jp/2bc8b678-dd8d-4742-ad82-319e9bf52418)」をご覧ください\)。 また、インストーラーが、[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用して、遅延時にネイティブ イメージを生成および更新できるようにします。  
+  
+ 各アーキテクチャを対象とするアプリケーションのコンパイルを許可するために、ネイティブ イメージ タスクはコンピューターでサポートされる CPU アーキテクチャごとに一度登録されます。  
+  
+|タスク名|32 ビット コンピューター|64 ビット コンピューター|  
+|----------|--------------------|--------------------|  
+|NET Framework NGEN v4.0.30319|はい|はい|  
+|NET Framework NGEN v4.0.30319 64|いいえ|はい|  
+  
+ ネイティブ イメージ タスクは、Windows 8 以降の実行時に .NET Framework 4.5 以降のバージョンで使用できます。  Windows の以前のバージョンでは、.NET Framework は [Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)を使用します。  
+  
+### タスクの有効期間  
+ 一般に、Windows タスク スケジューラは、毎晩、コンピューターがアイドル状態のときにネイティブ イメージ タスクを開始します。  このタスクでは、アプリケーション インストーラーによってキューに入れられている遅延作業、遅延されているネイティブ イメージ更新要求、自動イメージ作成がないかどうかをチェックします。  このタスクは未完了の作業項目を完了すると、停止します。  このタスクの実行中にコンピューターがアイドル状態になると、タスクは停止します。  
+  
+ また、ネイティブ イメージ タスクは手動で開始することもできます。その場合には、タスク スケジューラ UI を使用するか、NGen.exe を手動で呼び出します。  このいずれかの方法でこのタスクを開始すると、コンピューターがアイドル状態でなくなると実行を続行します。  NGen.exe を使用して手動で作成されたイメージは、アプリケーション インストーラーで予測可能な動作を有効にするために優先順位が設定されます。  
+  
+## ネイティブ イメージ サービス  
+ ネイティブ イメージ サービスは、ネイティブ イメージを生成および保持する Windows サービスです。  ネイティブ イメージ サービスによって、開発者はコンピューターがアイドル状態になるまでネイティブ イメージのインストールと更新を遅延できます。  
+  
+ 通常ネイティブ イメージ サービスは、アプリケーションまたはアップデートのインストール プログラム \(インストーラー\) によって開始されます。  優先順位 3 のアクションでは、サービスはコンピューターのアイドル時間に実行します。  このサービスは自身の状態を保存するため、再起動を繰り返しても必要に応じて続けて実行できます。  複数のイメージ コンパイルをキューに配置できます。  
+  
+ このサービスは、手動の Ngen.exe コマンドともやり取りします。  手動で実行するコマンドは、バックグラウンド アクティビティより優先されます。  
+  
+> [!NOTE]
+>  Windows Vista では、ネイティブ イメージ サービスに表示される名前は "Microsoft.NET Framework NGEN v2.0.50727\_X86" または "Microsoft.NET Framework NGEN v2.0.50727\_X64" です。  これより前のすべてのバージョンの Microsoft Windows では、名前は ".NET Runtime Optimization Service v2.0.50727\_X86" または ".NET Runtime Optimization Service v2.0.50727\_X64" です。  
+  
+### 遅延の操作の起動  
+ インストールまたはアップグレードを開始する前に、サービスを停止する必要があります。  これによって、インストーラーがファイルをコピーするか、またはアセンブリをグローバル アセンブリ キャッシュに格納している間に、サービスが実行されないようにできます。  次の Ngen.exe のコマンド ラインによって、サービスを停止します。  
+  
+```  
+ngen queue pause  
+```  
+  
+ すべての遅延操作がキューに置かれた後に、次のコマンドによってサービスを再開します。  
+  
+```  
+ngen queue continue  
+```  
+  
+ 新しいアプリケーションをインストールする場合または共有コンポーネントを更新する場合にネイティブ イメージの生成を遅延するには、`install` アクションまたは `update` アクションで `/queue` オプションを使用します。  次の Ngen.exe のコマンド ラインは、共有コンポーネントのネイティブ イメージをインストールし、影響を受けるすべてのルートの更新を実行します。  
+  
+```  
+ngen install MyComponent /queue  
+ngen update /queue  
+```  
+  
+ `update` アクションは、`MyComponent` を使用するネイティブ イメージだけでなく、無効になったすべてのネイティブ イメージを再作成します。  
+  
+ 多くのルートで構成されるアプリケーションでは、遅延されたアクションの優先順位を指定できます。  次のコマンドは、次の 3 つのルートのインストールをキューに置きます。  `Assembly1` がアイドル時間まで待たずに最初にインストールされます。  `Assembly2` もアイドル時間まで待たずにインストールされますが、優先順位 1 のアクションがすべてインストールされた後にインストールされます。  `Assembly3` は、コンピューターがアイドル状態になったことをサービスが検出するとインストールされます。  
+  
+```  
+ngen install Assembly1 /queue:1  
+ngen install Assembly2 /queue:2  
+ngen install Assembly3 /queue:3  
+```  
+  
+ `executeQueuedItems` アクションを使用すると、キューに置かれているアクションを同時に強制的に実行できます。  オプションの優先順位を指定すると、このアクションは同等またはそれ以下の優先順位を持っているキュー内のアクションだけに適用されます。  既定の優先順位は 3 であるため、次の Ngen.exe コマンドは、キューに置かれているすべてのアクションを即座に処理し、その処理が完了するまで戻りません。  
+  
+```  
+ngen executeQueuedItems  
+```  
+  
+ Ngen.exe は同期コマンドを実行し、ネイティブ イメージ サービスは使用しません。  ネイティブ イメージ サービスの実行中に Ngen.exe を使用してアクションを実行できます。  
+  
+### サービスのシャットダウン  
+ `/queue` オプションを組み込んだ Ngen.exe コマンドの実行によって開始されたサービスは、すべてのアクションが完了するまでバックグラウンドで実行されます。  このサービスは自身の状態を保存するため、再起動を繰り返しても必要に応じて処理を継続できます。  キューに待機しているアクションがないことを検出したサービスは、次回コンピューターの再起動のときに再起動されないように自身の状態をリセットしてから、シャットダウンします。  
+  
+### クライアントとサービスとのやり取り  
+ .NET Framework Version 2.0 では、必ず Ngen.exe というコマンド ライン ツールを使用してネイティブ イメージ サービスとやり取りします。  インストール スクリプトでコマンド ライン ツールを使用してネイティブ イメージ サービスのアクションをキューに置いたり、サービスとやり取りしたりします。  
+  
+## 参照  
+ [Native Image Service](http://msdn.microsoft.com/ja-jp/b15e0e32-59cb-4ae4-967c-6c9527781309)   
+ [Native Image Task](http://msdn.microsoft.com/ja-jp/9b1f7590-4e0d-4737-90ef-eaf696932afb)   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [マネージ実行プロセス](../../../docs/standard/managed-execution-process.md)   
+ [ランタイムがアセンブリを検索する方法](../../../docs/framework/deployment/how-the-runtime-locates-assemblies.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/peverify-exe-peverify-tool.md b/docs/framework/tools/peverify-exe-peverify-tool.md
new file mode 100644
index 00000000000..fae670043fc
--- /dev/null
+++ b/docs/framework/tools/peverify-exe-peverify-tool.md
@@ -0,0 +1,138 @@
+---
+title: "Peverify.exe (PEVerify ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "MSIL"
+  - "PE ファイル, PEVerify"
+  - "PEVerify ツール"
+  - "PEverify.exe"
+  - "移植可能な実行可能 (PE) ファイル, PEVerify"
+  - "タイプ セーフ要件"
+  - "検査 (MSIL とメタデータを)"
+ms.assetid: f4f46f9e-8d08-4e66-a94b-0c69c9b0bbfa
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Peverify.exe (PEVerify ツール)
+PEVerify ツールは、Microsoft Intermediate Language \(MSIL\) を生成する開発者 \(コンパイラの作成者、スクリプト エンジンの開発者など\) が、生成する MSIL コードと関連メタデータがタイプ セーフ要件を満たしているかどうかを確認する場合に役立ちます。  一部のコンパイラでは、特定の言語構成を使用しなかった場合にだけ、検査可能でタイプ セーフなコードが生成されます。  このようなコンパイラを使用している場合、生成したコードがタイプ セーフかどうかを確認する必要があると思う開発者もいるはずです。  そのような場合は、ファイルに対して PEVerify ツールを実行し、MSIL とメタデータを検査できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+peverify filename [options]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*ファイル名*|MSIL とメタデータを検査する対象のポータブル実行可能 \(PE\) ファイル。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/break\=** *maxErrorCount*|*maxErrorCount* のエラーが発生した後で検査を中止します。<br /><br /> このパラメーターは、.NET Framework Version 2.0 以降ではサポートされません。|  
+|**\/clock**|次の検査時間をミリ秒単位で計測して報告します。<br /><br /> **MD Val. cycle**<br /> メタデータ検証サイクル<br /><br /> **MD Val. pure**<br /> メタデータ検証のみ<br /><br /> **IL Ver. cycle**<br /> Microsoft Intermediate Language \(MSIL\) 検証サイクル<br /><br /> **IL Ver pure**<br /> MSIL 検証のみ<br /><br /> **MD Val. cycle** 時間および **IL Ver. cycle** 時間には、必要なスタートアップ手順およびシャットダウン手順を実行するために必要な時間が含まれます。  **MD Val. pure** 時間および **IL Ver pure** 時間は、検査または検証だけを行うために要する時間を反映します。|  
+|**\/help**|このツールのコマンド構文とオプションを表示します。|  
+|**\/hresult**|エラーコードを 16 進形式で表示します。|  
+|**\/ignore\=** *hex.code* \[, *hex.code*\]|指定したエラー コードを無視します。|  
+|**\/ignore\=@** *responseFile*|指定した応答ファイル内に一覧表示されているエラー コードを無視します。|  
+|**\/il**|*filename* で指定したアセンブリに実装されているメソッドに対して、MSIL がタイプ セーフかどうかを検査します。  **\/quiet** オプションを指定した場合を除き、検出された問題ごとに詳細な説明が返されます。|  
+|**\/md**|*filename* で指定したアセンブリに対して、メタデータを検査します。  この場合、ファイル内のすべてのメタデータ構造が検査され、検出された問題がすべて報告されます。|  
+|**\/nologo**|製品バージョンと著作権情報を表示しません。|  
+|**\/nosymbols**|.NET Framework Version 2.0 で、後方互換性のために行番号を表示しません。|  
+|**\/quiet**|クワイエット モードを指定します。このモードでは、検査により検出された問題の報告が簡略化されます。  ファイルがタイプ セーフかどうかは報告されますが、タイプ セーフでない場合に、その問題に関する情報は報告されません。|  
+|`/transparent`|透過的なメソッドのみを検証します。|  
+|**\/unique**|繰り返し発生するエラー コードを無視します。|  
+|**\/verbose**|.NET Framework Version 2.0 で、MSIL 検証メッセージに追加情報を表示します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ 共通言語ランタイムは、セキュリティ機構や分離機構の実施を簡単にするために、アプリケーション コードがタイプ セーフに実行されることに依存しています。  通常、[検査可能でタイプ セーフ](http://msdn.microsoft.com/ja-jp/095cd1f6-d8db-4c0e-bce2-83ccb34dd5dc)なコード以外のコードは実行できません。しかし、信頼できるが検査を実行できないコードを実行可能にするセキュリティ ポリシーを設定することはできます。  
+  
+ **\/md** と **\/il** のいずれのオプションも指定しない場合は、両方の種類の検査が実行されます。  まず、**\/md** オプションによる検査が実行されます。  エラーが検出されない場合は、**\/il** オプションによる検査が実行されます。  **\/md** と **\/il** の両方のオプションを指定した場合は、メタデータの検査でエラーが検出された場合でも、**\/il** オプションによる検査が実行されます。  つまり、メタデータの検査でエラーが検出されないときは、**peverify** *filename* と **peverify** *filename* **\/md** **\/il** のいずれを指定しても同じ検査が実行されます。  
+  
+ Peverify.exe は、データ フローの分析と、メタデータの有効性に関する多数の規則のリストに基づいて、MSIL に対する包括的な検査を実行します。  Peverify.exe によって実行される検査の詳細については、[!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] の Tools Developers Guide フォルダー内にある Metadata Validation の仕様および MSIL Instruction Set の仕様を参照してください。  
+  
+ .NET Framework Version 2.0 以降では、`dup`、`ldsflda`、`ldflda`、`ldelema`、`call`、および `unbox` の各 MSIL 命令を使用して指定する検証可能な `byref` 戻り値をサポートします。  
+  
+## 例  
+ アセンブリ `myAssembly.exe` に実装されているメソッドに対して、メタデータの有効性および MSIL がタイプ セーフかどうかについて検査するコマンドを次に示します。  
+  
+```  
+peverify myAssembly.exe /md /il  
+```  
+  
+ 上記の要求が正常に終了した場合は、次のメッセージが表示されます。  
+  
+```  
+All classes and methods in myAssembly.exe Verified  
+```  
+  
+ アセンブリ `myAssembly.exe` に実装されているメソッドに対して、メタデータの有効性および MSIL がタイプ セーフかどうかについて検査するコマンドを次に示します。  このツールは、これらの検査に要する時間を表示します。  
+  
+```  
+peverify myAssembly.exe /md /il /clock  
+```  
+  
+ 上記の要求が正常に終了した場合は、次のメッセージが表示されます。  
+  
+```  
+All classes and methods in myAssembly.exe Verified  
+Timing: Total run     320 msec  
+        MD Val.cycle  40 msec  
+        MD Val.pure   10 msec  
+        IL Ver.cycle  270 msec  
+        IL Ver.pure   230 msec  
+```  
+  
+ アセンブリ `myAssembly.exe` に実装されているメソッドに対して、メタデータの有効性および MSIL がタイプ セーフかどうかについて検査するコマンドを次に示します。  しかし、Peverify.exe は、最大エラー カウントである 100 に達すると、停止します。  このツールは、指定されたエラー コードも無視します。  
+  
+```  
+peverify myAssembly.exe /break=100 /ignore=0x12345678,0xABCD1234  
+```  
+  
+ 上記の例と結果は同じですが、無視するエラー コードを応答ファイル `ignoreErrors.rsp` に指定するコマンドを次に示します。  
+  
+```  
+peverify myAssembly.exe /break=100 /ignore@ignoreErrors.rsp  
+```  
+  
+ この応答ファイルには、エラー コードの一覧をコンマで区切って指定できます。  
+  
+```  
+0x12345678, 0xABCD1234  
+```  
+  
+ また、エラー コードを 1 行に 1 つという形式で指定することもできます。  
+  
+```  
+0x12345678  
+0xABCD1234  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [NIB: Writing Verifiably Type\-Safe Code](http://msdn.microsoft.com/ja-jp/d18f10ef-3b48-4f47-8726-96714021547b)   
+ [Type Safety and Security](http://msdn.microsoft.com/ja-jp/095cd1f6-d8db-4c0e-bce2-83ccb34dd5dc)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/regasm-exe-assembly-registration-tool.md b/docs/framework/tools/regasm-exe-assembly-registration-tool.md
new file mode 100644
index 00000000000..07ad1a0dd86
--- /dev/null
+++ b/docs/framework/tools/regasm-exe-assembly-registration-tool.md
@@ -0,0 +1,100 @@
+---
+title: "Regasm.exe (アセンブリ登録ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 登録"
+  - "アセンブリ登録ツール"
+  - "Regasm.exe"
+  - "登録 (アセンブリを)"
+ms.assetid: e190e342-36ef-4651-a0b4-0e8c2c0281cb
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Regasm.exe (アセンブリ登録ツール)
+アセンブリ登録ツールは、1 つのアセンブリに含まれるメタデータを読み込み、必要なエントリをレジストリに追加します。これにより、COM クライアントによって .NET Framework クラスが自動的に作成されます。  クラスが登録されると、どの COM クライアントでも、そのクラスを COM クラスであるかのように使用できます。  クラスの登録は、アセンブリのインストール時に 1 回だけ行われます。  実際に登録されるまでは、アセンブリに含まれるクラスのインスタンスを COM から作成することはできません。  
+  
+ このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+regasm assemblyFile [options]  
+```  
+  
+#### パラメーター  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|*assemblyFile*|COM に登録するアセンブリ。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/codebase**|レジストリに Codebase エントリを作成します。  Codebase エントリは、グローバル アセンブリ キャッシュにインストールされないアセンブリのファイル パスを指定します。  登録しようとしているアセンブリを、後でグローバル アセンブリ キャッシュにインストールする場合は、このオプションを指定する必要はありません。  **\/codebase** オプションと共に指定する *assemblyFile* 引数は、[厳密な名前付きのアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)である必要があります。|  
+|**\/registered**|このツールが既に登録されているタイプ ライブラリだけを参照するように指定します。|  
+|**\/asmpath:directory**|アセンブリ参照を含むディレクトリを指定します。  **\/regfile** オプションと共に使用する必要があります。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/regfile** \[**:** *regFile*\]|アセンブリについて指定した .reg ファイルを生成します。このファイルには必要なレジストリ エントリが含まれます。  このオプションを指定してもレジストリは変更されません。  このオプションは **\/u** または **\/tlb** オプションとは併用できません。|  
+|**\/silent** または **\/s**|成功メッセージを表示しません。|  
+|**\/tlb** \[**:** *typeLibFile*\]|指定したアセンブリからタイプ ライブラリを生成します。このアセンブリには、アセンブリ内で定義されたアクセス可能な型の定義が含まれます。|  
+|**\/unregister** または **\/u**|*assemblyFile* 内で見つかった、作成可能なクラスの登録を取り消します。  このオプションを省略すると、アセンブリ内の作成可能なクラスが Regasm.exe で登録されます。|  
+|**\/verbose**|詳細出力モードを指定します。**\/tlb** オプションと共に指定した場合、タイプ ライブラリを生成する必要のある参照先アセンブリの一覧が表示されます。|  
+|**\/?** または **\/help**|このツールのコマンド構文とオプションを表示します。|  
+  
+> [!NOTE]
+>  Regasm.exe のコマンド行オプションでは大文字と小文字が区別されません。  オプションの一部を指定するだけで一意に識別できます。  たとえば、**\/n** は **\/nologo** と等価であり、**\/t:** *outfile.tlb* は **\/tlb:** *outfile.tlb* と等価です。  
+  
+## 解説  
+ **\/regfile** オプションを使用すると、直接にレジストリを変更しなくても、レジストリ エントリを含む .reg ファイルを生成できます。  コンピューターのレジストリを更新するには、レジストリ エディター ツール \(Regedit.exe\) を使用して .reg ファイルをインポートします。  .reg ファイルには、ユーザー定義の登録機能で行われるレジストリの更新についての情報は含まれません。  **\/regfile** オプションは、マネージ クラスのレジストリ エントリだけを生成します。  このオプションは、`TypeLibID` と `InterfaceID` のエントリは生成しません。  
+  
+ **\/tlb** オプションを指定すると、アセンブリ内で見つかった型を記述するタイプ ライブラリが Regasm.exe で生成および登録されます。  生成されたタイプ ライブラリは、現在の作業ディレクトリ、または出力ファイル用に指定されたディレクトリ内に格納されます。  他のアセンブリを参照するアセンブリについてタイプ ライブラリを生成すると、一度に複数のタイプ ライブラリが生成されることがあります。  タイプ ライブラリを使用して、[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] などの開発用ツールに対して型情報を提供できます。  登録するアセンブリがタイプ ライブラリ インポーター \([Tlbimp.exe](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)\) で生成されたアセンブリである場合には、**\/tlb** オプションを使用しないでください。  タイプ ライブラリからインポートされたアセンブリからは、タイプ ライブラリをエクスポートできません。  **\/tlb** オプションを使用した場合の効果は、タイプ ライブラリ エクスポーター \([Tlbexp.exe](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)\) と Regasm.exe を使用した場合と同じです。ただし、Tlbexp.exe では、生成されたタイプ ライブラリが登録されません。  **\/tlb** オプションを使用してタイプ ライブラリを登録する場合、**\/tlb** オプションと **\/unregister** オプションを使用してタイプ ライブラリの登録を解除できます。  この 2 つのオプションを使用すると、タイプ ライブラリとインターフェイス エントリの登録を解除でき、これによって、レジストリをかなり整理できます。  
+  
+ COM で使用するためにアセンブリを登録すると、Regasm.exe は、ローカル コンピューターのレジストリにエントリを追加します。  より具体的には、バージョンに依存するレジストリ キーを作成して、同じアセンブリの複数のバージョンが同じコンピューターで side\-by\-side 実行できるようにします。  アセンブリが初めて登録される場合は、そのアセンブリの最上位キーが 1 つ作成され、特定のバージョンに対する一意なサブキーが作成されます。  アセンブリの新しいバージョンを登録するたびに、Regasm.exe は、新しいバージョンに対するサブキーを作成します。  
+  
+ たとえば、COM で使用するために、マネージ コンポーネント myComp.dll のバージョン 1.0.0.0 を登録しているとします。  その後、myComp.dll バージョン 2.0.0.0 を登録します。  コンピューター上のすべての COM クライアント アプリケーションは myComp.dll バージョン 2.0.0.0 を使用しているため、myComponent.dll バージョン 1.0.0.0 を登録解除することにしました。  このレジストリ スキームでは、myComp.dll バージョン 1.0.0.0 のサブキーだけが削除されるため、バージョン 1.0.0.0 を登録解除できます。  
+  
+ Regasm.exe を使用してアセンブリを登録した後で、そのアセンブリを[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)内に登録すると、どの COM クライアントからもアクティブにできます。  アセンブリをアクティブにするアプリケーションが 1 つだけの場合は、そのアプリケーションのディレクトリ内にアセンブリを格納できます。  
+  
+## 例  
+ `myTest.dll` に含まれるすべてのパブリック クラスを登録するコマンドを次に示します。  
+  
+```  
+regasm myTest.dll  
+```  
+  
+ ファイル `myTest.reg` を生成するコマンドを次に示します。このファイルには、必要なレジストリ エントリがすべて含まれます。  このコマンドを実行してもレジストリは更新されません。  
+  
+```  
+regasm myTest.dll /regfile:myTest.reg  
+```  
+  
+ `myTest.dll` に含まれるすべてのパブリック クラスを登録し、タイプ ライブラリ `myTest.tlb` を生成および登録するコマンドを次に示します。このタイプ ライブラリには、`myTest.dll` で定義されたすべてのパブリック型の定義が含まれます。  
+  
+```  
+regasm myTest.dll /tlb:myTest.tlb  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Tlbexp.exe \(タイプ ライブラリ エクスポーター\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)   
+ [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)   
+ [COM へのアセンブリの登録](../../../docs/framework/interop/registering-assemblies-with-com.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/regsvcs-exe-net-services-installation-tool.md b/docs/framework/tools/regsvcs-exe-net-services-installation-tool.md
new file mode 100644
index 00000000000..b2689d08916
--- /dev/null
+++ b/docs/framework/tools/regsvcs-exe-net-services-installation-tool.md
@@ -0,0 +1,101 @@
+---
+title: "Regsvcs.exe (.NET サービス インストール ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET サービス インストール ツール"
+  - "アセンブリ [.NET Framework], 登録"
+  - "読み込み (アセンブリを)"
+  - "登録 (アセンブリを)"
+  - "Regsvcs.exe"
+  - "タイプ ライブラリ"
+ms.assetid: 5220fe58-5aaf-4e8e-8bc3-b78c63025804
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Regsvcs.exe (.NET サービス インストール ツール)
+.NET サービス インストール ツールは、次のアクションを実行します。  
+  
+-   アセンブリの読み込みと登録。  
+  
+-   タイプ ライブラリの生成、登録、および指定された COM\+ アプリケーションへのインストール。  
+  
+-   プログラムでクラスに追加したサービスの設定。  
+  
+ このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+regsvcs [/c | /fc | /u] [/tlb:typeLibraryFile] [/extlb] [/reconfig] [/componly] [/appname:applicationName] [/nologo] [/quiet]assemblyFile.dll   
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*assemblyFile.dll*|ソース アセンブリ ファイル。  アセンブリは、厳密な名前で署名する必要があります。  詳細については、「[厳密な名前でのアセンブリへの署名](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)」を参照してください。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/appdir:** *path*|アプリケーションのルート ディレクトリを示します。|  
+|**\/appname:** *applicationName*|検索または作成する COM\+ アプリケーションの名前を指定します。|  
+|**\/c**|ターゲット アプリケーションを作成します。|  
+|**\/componly**|コンポーネントだけを設定します。メソッドとインターフェイスは無視されます。|  
+|**\/exapp**|このツールが既存のアプリケーションを要求するように指定します。|  
+|**\/extlb**|既存のタイプ ライブラリを使用します。|  
+|**\/fc**|対象アプリケーションを検索または作成します。|  
+|**\/help**|このツールのコマンド構文とオプションを表示します。|  
+|**\/noreconfig**|既存の対象アプリケーションを再設定しません。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/parname:** *name*|検索または作成する COM\+ アプリケーションの名前または ID を指定します。|  
+|**\/reconfig**|既存の対象アプリケーションを再設定します。  既定値です。|  
+|**\/tlb:** *typelibraryfile*|インストールするタイプ ライブラリ ファイルを指定します。|  
+|**\/u**|対象アプリケーションをアンインストールします。|  
+|**\/quiet**|クワイエット モードを指定します。ロゴと成功メッセージは表示されません。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ Regsvcs.exe には、*assemblyFile.dll* で指定されているソース アセンブリ ファイルが必要です。  このアセンブリは、厳密な名前で署名する必要があります。  厳密な名前での署名の詳細については、「[厳密な名前でのアセンブリへの署名](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)」を参照してください。  対象アプリケーションおよびタイプ ライブラリの名前は、オプションです。  引数 *applicationName* はソース アセンブリ ファイルから生成できます。存在しない場合は、Regsvcs.exe によって作成されます。  引数 *typelibraryfile* にはタイプ ライブラリ名を指定できます。  タイプ ライブラリ名を指定しない場合、Regsvcs.exe は既定値としてアセンブリ名を使用します。  
+  
+ Regsvcs.exe がコンポーネントのメソッドを登録する場合は、それらのメソッドに対する[確認要求](http://msdn.microsoft.com/ja-jp/e5283e28-2366-4519-b27d-ef5c1ddc1f48)と[リンク確認要求](../../../docs/framework/misc/link-demands.md)の影響を受けます。  このツールは完全に信頼された環境で実行されるため、アクセス許可に対するほとんどの確認要求は成功します。  ただし、Regsvcs.exe では、<xref:System.Security.Permissions.StrongNameIdentityPermission> または <xref:System.Security.Permissions.PublisherIdentityPermission> に対する確認要求やリンク確認要求によって保護されたメソッドを含むコンポーネントを登録することはできません。  
+  
+ Regsvcs.exe を使用するには、ローカル コンピューターの管理特権が必要です。  
+  
+ 上記のアクションの実行中に Regsvcs.exe が異常終了した場合は、対応するエラー メッセージが表示されます。  
+  
+## 例  
+ `myTest.dll` に含まれるすべてのパブリック クラスを `myTargetApp` \(既存の COM\+ アプリケーション\) に追加し、タイプ ライブラリ `myTest.tlb` を生成するコマンドを次に示します。  
+  
+```  
+regsvcs /appname:myTargetApp myTest.dll  
+```  
+  
+ `myTest.dll` に含まれるすべてのパブリック クラスを `myTargetApp` \(既存の COM\+ アプリケーション\) に追加し、タイプ ライブラリ `newTest.tlb` を生成するコマンドを次に示します。  
+  
+```  
+regsvcs /appname:myTargetApp /tlb:newTest.tlb myTest.dll  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/resgen-exe-resource-file-generator.md b/docs/framework/tools/resgen-exe-resource-file-generator.md
new file mode 100644
index 00000000000..524d25fe105
--- /dev/null
+++ b/docs/framework/tools/resgen-exe-resource-file-generator.md
@@ -0,0 +1,353 @@
+---
+title: "Resgen.exe (リソース ファイル ジェネレーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".resources ファイル"
+  - ".resx ファイル"
+  - "バイナリ リソース ファイル"
+  - "変換 (ファイルの), リソース ファイル ジェネレーター"
+  - "埋め込み (ランタイム バイナリ実行可能ファイルへのファイルの)"
+  - "ファイル, 変換"
+  - "Resgen.exe"
+  - "リソース ファイル ジェネレーター"
+  - "リソース ファイル, .resources ファイル"
+  - "リソース ファイル, .resx ファイル"
+  - "リソース ファイル, 変換"
+  - "resx ファイル (リソース ファイル)"
+ms.assetid: 8ef159de-b660-4bec-9213-c3fbc4d1c6f4
+caps.latest.revision: 46
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 46
+---
+# Resgen.exe (リソース ファイル ジェネレーター)
+リソース ファイル ジェネレーター \(Resgen.exe\) は、テキスト \(.txt または .restext\) ファイルおよび XML ベースのリソース形式 \(.resx\) ファイルを共通言語ランタイムのバイナリ \(.resources\) ファイルに変換します。この .resources ファイルは、ランタイム バイナリ実行可能ファイルまたはサテライト アセンブリに埋め込むことができます。\(「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」を参照\)。  
+  
+ Resgen.exe は、次のタスクを実行する汎用のリソース変換ユーティリィティです。  
+  
+-   .txt または .restext ファイルから .resources または .resx ファイルへの変換。\(.restext ファイルの形式は .txt ファイルの形式と同じです。  ただし、拡張子 .restext を使用すると、リソース定義を含むテキスト ファイルをより簡単に識別できます\)。  
+  
+-   .resources ファイルからテキスト ファイルまたは .resx ファイルへの変換。  
+  
+-   .resx ファイルからテキスト ファイルまたは .resources ファイルへの変換。  
+  
+-   アセンブリからの文字列リソースを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションでの使用に適した .resw ファイルに抽出します。  
+  
+-   個々の名前付きリソースと <xref:System.Resources.ResourceManager> インスタンスへのアクセスを提供する厳密に型指定されたクラスを作成します。  
+  
+ 何らかの理由により Resgen.exe が失敗した場合は、戻り値は –1 です。  
+  
+ Resgen.exe のヘルプを表示する場合は、オプションを指定せずに次のコマンドを使用して Resgen.exe のコマンド構文およびオプションを表示できます。  
+  
+```  
+resgen  
+```  
+  
+ `/?` スイッチを使用することもできます。  
+  
+```  
+resgen /?  
+```  
+  
+ Resgen.exe を使用してバイナリ .resources ファイルを生成する場合は、言語コンパイラを使用して実行可能アセンブリにバイナリ ファイルを埋め込むか、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリにコンパイルできます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+      resgen  [/define:symbol1[,symbol2,...]] [/useSourcePath] filename.extension  | /compile filename.extension... [outputFilename.extension]   
+[/r:assembly]   
+[/str:lang[,namespace[,class[,file]]] [/publicclass]]   
+```  
+  
+```  
+  
+resgen filename.extension [outputDirectory]  
+```  
+  
+#### パラメーター  
+  
+|パラメーターまたはスイッチ|説明|  
+|-------------------|--------|  
+|`/define:` *symbol1*\[, *symbol2*,...\]|[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、テキスト ベース \(.txt または .restext\) リソース ファイル内の条件付きコンパイルがサポートされています。  *symbol* が `#ifdef` 内の入力テキスト ファイルに含まれているシンボルに対応している場合は、関連の文字列リソースが .resources ファイルに含まれます。  `/define` スイッチによって定義されていないシンボルと共に `#if !` ステートメントが入力テキスト ファイルに含まれている場合、関連の文字列リソースがリソース ファイルに含まれます。<br /><br /> テキスト ファイル以外で使用される場合、`/define` は無視されます。  シンボルでは、大文字と小文字が区別されます。<br /><br /> このオプションの詳細については、このトピックの「[リソースの条件付きコンパイル](#Conditional)」を参照してください。|  
+|`useSourcePath`|入力ファイルの現在のディレクトリを使用して相対ファイル パスを解決することを指定します。|  
+|`/compile`|複数の .resx ファイルまたはテキスト ファイルを指定して、一括した操作で複数の .resources ファイルに変換できるようにします。  このオプションを指定しない場合、指定できる入力ファイル引数は 1 つだけです。  出力ファイルには、*filename*.resources という名前が付けられます。<br /><br /> このオプションは、`/str:` オプションと一緒に使用することはできません。<br /><br /> このオプションの詳細については、このトピックの「[複数のファイルのコンパイルまたは変換](#Multiple)」を参照してください。|  
+|`/r:` `assembly`|指定されたアセンブリからメタデータを参照します。  これは、.resx ファイルを変換するときに使用され、Resgen.exe がオブジェクト リソースをシリアル化または非シリアル化できるようにします。  C\# および Visual Basic コンパイラの `/reference:` や `/r:` オプションに似ています。|  
+|`filename.extension`|変換対象の入力ファイルの名前を指定します。  この表の前に示した 1 番目の長いコマンド ライン構文を使用する場合は、`extension` が以下のいずれかであることが必要です。<br /><br /> .txt または .restext<br /> .resources ファイルまたは .resx ファイルに変換するテキスト ファイル。  テキスト ファイルには、文字列リソースだけを含めることができます。  ファイル形式については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」の「テキスト ファイル内のリソース」を参照してください。<br /><br /> .resx<br /> .resources ファイルまたはテキスト \(.txt または .restext\) ファイルに変換する、XML ベースのリソース ファイル。<br /><br /> .resources<br /> .resx ファイルまたはテキスト \(.txt または .restext\) ファイルに変換するバイナリ リソース ファイル。<br /><br /> この表の前に示した 2 番目の短いコマンド ライン構文を使用する場合は、`extension` が以下のいずれかであることが必要です。<br /><br /> .exe または .dll<br /> 文字列リソースが [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションの開発で使用するための .resw ファイルに抽出される .NET Framework アセンブリ \(実行可能ファイルまたはライブラリ\)。|  
+|`outputFilename.extension`|作成するリソース ファイルの名前および種類を指定します。<br /><br /> .txt ファイル、.restext ファイル、または .resx ファイルから .resources ファイルへ変換する場合、この引数は省略できます。  `outputFilename` を指定しないと、入力 `filename` ファイルに拡張子 .resources が追加され、そのファイルが `filename,extension` を含むディレクトリに書き込まれます。<br /><br /> .resources ファイルから変換する場合、引数 `outputFilename.extension` は必ず指定する必要があります。  .resources ファイルを XML ベースのリソース ファイルに変換する場合は、拡張子が .resx のファイル名を指定します。  .resources ファイルをテキスト ファイルに変換する場合は、拡張子が .txt または .restext のファイル名を指定します。  .resources ファイルを .txt ファイルに変換するのは、.resource ファイルに文字列値だけが含まれている場合に限ります。|  
+|`outputDirectory`|[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションの場合は、`filename.extension` に文字列リソースを含む .resw ファイルが書き込まれるディレクトリを指定します。  `outputDirectory` は既に存在している必要があります。|  
+|`/str:` `language[,namespace[,classname[,filename]]]`|`language` オプションで指定されたプログラミング言語で、厳密に型指定されたリソース クラス ファイルを作成します。  `language` は、次のリテラルの 1 つで構成できます:<br /><br /> -   C\# の場合: `c#`、`cs`、または `csharp`。<br />-   Visual Basic の場合: `vb` または `visualbasic`。<br />-   VBScript の場合: `vbs` または `vbscript`。<br />-   C\+\+ の場合: `c++`、`mc`、または `cpp`。<br />-   JavaScript の場合: `js`、`jscript`、または `javascript`。<br /><br /> `namespace` オプションではプロジェクトの既定の名前空間を指定し、`classname` オプションでは生成されるクラスの名前を指定し、`filename` オプションではクラス ファイルの名前を指定します。<br /><br /> `/str:` オプションは 1 つの入力ファイルにのみ対応しているため、`/compile` オプションと一緒に使用することはできません。<br /><br /> `namespace` を指定して、`classname` を指定しない場合、出力ファイル名からクラス名が派生します \(たとえば、ピリオドがアンダースコアに置き換えられます\)。  このため、厳密に型指定されたリソースが正常に機能しないことがあります。  この問題を回避するには、クラス名と出力ファイル名の両方を指定します。<br /><br /> このオプションの詳細については、このトピックの「[厳密に型指定されたリソース クラスの生成](#Strong)」を参照してください。|  
+|`/publicClass`|厳密に型指定されたリソース クラスをパブリック クラスとして作成します。  既定では、リソース クラスは、C\# の場合 `internal`、Visual Basic の場合 `Friend` です。<br /><br /> `/str:` オプションを使用しない場合、このオプションは無視されます。|  
+  
+## Resgen.exe とリソース ファイルの種類  
+ Resgen.exe で正常にリソースを変換するには、テキストおよび .resx ファイルが正しい形式になっている必要があります。  
+  
+### テキスト \(.txt および .restext\) ファイル  
+ テキスト \(.txt または .restext\) ファイルには、文字列リソースのみを含めることができます。  文字列リソースは、文字列を複数の言語に翻訳する必要があるアプリケーションを記述する場合に便利です。  たとえば、適切な文字列リソースを使用することで、メニュー文字列を簡単に地域固有の文字列に変更できます。  Resgen.exe は名前と値のペアを含むテキスト ファイルを読み取ります。名前はリソースを説明する文字列で、値はリソース文字列そのものです。  
+  
+> [!NOTE]
+>  .txt ファイルと .restext ファイルの形式については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」の「テキスト ファイル内のリソース」を参照してください。  
+  
+ リソースを格納するテキスト ファイルは、基本ラテンの範囲の文字だけ \(U\+007F まで\) が含まれていない限り、UTF\-8 エンコーディングまたは Unicode \(UTF\-16\) エンコーディングで格納する必要があります。  Resgen.exe は、ANSI エンコーディングを使用して保存されたテキスト ファイルを処理するときに拡張 ANSI 文字を削除します。  
+  
+ Resgen.exe は、テキスト ファイルの中でリソース名が重複していないかどうかを確認します。  テキスト ファイルの中でリソース名が重複している場合は、警告メッセージが出され、2 つ目の値は無視されます。  
+  
+### .resx ファイル  
+ .resx リソース ファイル形式は、XML エントリから構成されます。  テキスト ファイルの場合と同様に、これらの XML エントリの中に文字列リソースを指定できます。  .resx ファイルがテキスト ファイルよりも優れている点は、オブジェクトの指定や埋め込みもできることです。  .resx ファイルを表示してみると、埋め込みオブジェクト \(画像など\) のバイナリ形式を参照できます \(このバイナリ情報がリソース マニフェストの一部に含まれている場合\)。  テキスト ファイルと同様に、.resx ファイルはテキスト エディター \(メモ帳や Microsoft Word など\) で開き、内容を書き込み、解析、操作できます。  そのためには、XML のタグや .resx ファイルの構造を十分に知っておく必要があります。  .resx ファイル形式の詳細については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」の「.resx ファイル内のリソース」セクションを参照してください。  
+  
+ 文字列以外の埋め込みオブジェクトを含む .resources ファイルを作成するには、それらのオブジェクトを含む .resx ファイルを Resgen.exe で変換するか、<xref:System.Resources.ResourceWriter> クラスで提供されているメソッドを呼び出して、オブジェクト リソースをコードから直接ファイルに追加する必要があります。  
+  
+ .resx または .resources ファイルにオブジェクトが含まれ、Resgen.exe を使用してそれをテキスト ファイルに変換する場合、文字列リソースはすべて正しく変換されますが、非文字列オブジェクトのデータ型も文字列としてファイルに書き込まれることになります。  この変換処理では埋め込みオブジェクトが失われるため、リソースの取得時にエラーが発生したと報告されます。  
+  
+### リソース ファイルの種類間の変換  
+ 異なる種類のリソース ファイル間で変換を行うと、変換元と変換先のファイルの種類によっては、Resgen.exe が変換を実行できないか、特定のリソースに関する情報が失われる場合があります。  次の表は、あるリソース ファイルの種類から別の種類に変換するとき、正常な変換の種類を指定しています。  
+  
+|変換元|テキスト ファイルへ|.resx ファイルへ|.resw ファイルへ|.resources ファイルへ|  
+|---------|----------------|-----------------|-----------------|----------------------|  
+|テキスト \(.txt または .restext\) ファイル|\-\-|問題なし|サポートなし|問題なし|  
+|.resx ファイル|変換は、ファイルに文字列以外のリソース \(ファイル リンクを含む\) が含まれている場合は失敗します|\-\-|サポートなし|問題なし|  
+|.resources ファイル|変換は、ファイルに文字列以外のリソース \(ファイル リンクを含む\) が含まれている場合は失敗します|問題なし|サポートなし|\-\-|  
+|.exe または .dll アセンブリ|サポートなし|サポートなし|文字列リソース \(パス名を含む\) だけがリソースとして認識されます。|サポートなし|  
+  
+## 特定の Resgen.exe タスクの実行  
+ さまざまな方法で Resgen.exe を使用できます。テキストベースまたは XML ベースのリソース ファイルをバイナリ ファイルにコンパイルすることや、リソース ファイル形式を別のリソース ファイル形式に変換することや、<xref:System.Resources.ResourceManager> 機能をラップしてリソースへのアクセスを提供するクラスを生成することができます。  このセクションには、各タスクに関する詳細な情報があります。  
+  
+-   [リソースのバイナリ ファイルへのコンパイル](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Compiling)  
+  
+-   [リソース ファイルの種類間の変換](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Convert)  
+  
+-   [複数のファイルのコンパイルまたは変換](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Multiple)  
+  
+-   [.resw ファイルへのリソースのエクスポート](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Exporting)  
+  
+-   [リソースの条件付きコンパイル](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Conditional)  
+  
+-   [厳密に型指定されたリソース クラスを生成しています](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Strong)  
+  
+<a name="Compiling"></a>   
+### リソースのバイナリ ファイルへのコンパイル  
+ Resgen.exe の最も一般的な用途は、テキスト ベースのリソース ファイル \(.txt または .restext ファイル\) または XML ベースのリソース ファイル \(.resx ファイル\) をバイナリ .resources ファイルにコンパイルすることです。  次に、出力ファイルは、言語コンパイラを使用してメインのアセンブリに、または[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) を使用してサテライト アセンブリに埋め込むことができます。  
+  
+ リソース ファイルをコンパイルする構文は次のとおりです。  
+  
+```  
+resgen inputFilename [outputFilename]   
+```  
+  
+ パラメーターは次のとおりです。  
+  
+ `inputFilename`  
+ コンパイルするリソース ファイルの拡張子を含むファイル名。  Resgen.exe は、拡張子 .txt、.restext、または .resx を持つファイルだけをコンパイルします。  
+  
+ `outputFilename`  
+ 出力ファイルの名前。  `outputFilename` を省略した場合は、Resgen.exe が `inputFilename` と同じディレクトリに `inputFilename` のルート ファイル名の .resources ファイルを作成します。  `outputFilename` でディレクトリ パスが示されている場合、ディレクトリが存在する必要があります。  
+  
+ ファイル名を指定し、それをピリオドでルート ファイル名から区切ることで、.resources ファイルの完全修飾名前空間を指定します。  たとえば、`outputFilename` が `MyCompany.Libraries.Strings.resources` の場合、その名前空間は MyCompany.Libraries になります。  
+  
+ Resources.txt に含まれる名前と値のペアを読み取り、Resources.resources という名前のバイナリ .resources ファイルを書き込むコマンドを次に示します。  出力ファイル名は明示的に指定されていないため、入力ファイルと同じ名前を既定で受け取ります。  
+  
+```  
+resgen Resources.txt   
+```  
+  
+ Resources.restext に含まれる名前と値のペアを読み取り、StringResources.resources という名前のバイナリ リソース ファイルを書き込むコマンドを次に示します。  
+  
+```  
+resgen Resources.restext StringResources.resources  
+```  
+  
+ XML ベースの入力ファイル Resources.resx を読み取り、Resources.resources という名前のバイナリ .resources ファイルを書き込むコマンドを次に示します。  
+  
+```  
+resgen Resources.resx Resources.resources  
+```  
+  
+<a name="Convert"></a>   
+### リソース ファイルの種類間の変換  
+ テキストベースか XML ベースのリソース ファイルをバイナリ .resources ファイルにコンパイルすることに加えて、Resgen.exe は、任意のサポートされるファイルの種類を他のサポートされるファイルの種類に変換できます。  これによって、次の変換を実行できます。  
+  
+-   .txt および .restext ファイルから .resx ファイル。  
+  
+-   .resx ファイルから .txt および .restext ファイル。  
+  
+-   .resources ファイルから .txt および .restext ファイル。  
+  
+-   .resources ファイルから .resx ファイル。  
+  
+ 構文は、前のセクションの構文と同じです。  
+  
+ また、Resgen.exe を使用して、.NET Framework アセンブリへの埋め込みリソースを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーション対応 .resw ファイルに変換できます。  
+  
+ バイナリ リソース ファイル Resources.resources を読み取り、Resources.resx という名前の XML ベースの出力ファイルを書き込むコマンドを次に示します。  
+  
+```  
+resgen Resources.resources Resources.resx  
+```  
+  
+ 次のコマンドは、StringResources.txt という名前のテキスト ベースのリソース ファイルを読み取り、LibraryResources.resx という名前の XML ベースのリソース ファイルに書き込みます。  文字列リソースを含むことに加えて、.resx ファイルは、文字列以外のリソースを保存するのにも使用できます。  
+  
+```  
+resgen StringResources.txt LibraryResources.resx  
+```  
+  
+ 次の 2 つのコマンドは、Resources.resx という名前の XML ベースのリソース ファイルを読み取り、Resources.txt および Resources.restext という名前のテキスト ファイルに書き込みます。  .resx ファイルに埋め込みオブジェクトが含まれている場合は、テキスト ファイルに正しく変換されません。  
+  
+```  
+resgen Resources.resx Resources.txt  
+resgen Resources.resx Resources.restext  
+```  
+  
+<a name="Multiple"></a>   
+### 複数のファイルのコンパイルまたは変換  
+ `/compile` スイッチを使用すると、1 回の操作でリソース ファイルの一覧を別の形式に変換できます。  構文は次のとおりです。  
+  
+```  
+resgen /compile filename.extension [filename.extension...]  
+```  
+  
+ 次のコマンドは、3 つのファイル、StringResources.resources、TableResources.resources、ImageResources.resources を StringResources.txt、TableResources.resw、ImageResources.resw という名前の別の .resources ファイルにコンパイルします。  
+  
+```  
+resgen /compile StringResources.txt TableResources.resx ImageResources.resx  
+```  
+  
+<a name="Exporting"></a>   
+### .resw ファイルへのリソースのエクスポート  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションを開発する場合は、既存のデスクトップ アプリケーションのリソースを使用することもできます。  ただし、2 つの種類のアプリケーションは、異なるファイル形式をサポートします。  デスクトップ アプリケーションでは、テキストのリソース \(.txt または .restext\) または .resx ファイルはバイナリ .resources ファイルにコンパイルされます。  [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションでは、.resw ファイルはバイナリ パッケージ リソース インデックス \(PRI\) ファイルにコンパイルされます。  Resgen.exe を使用して、このギャップを埋めることができます。これを行うには、実行可能ファイルまたはサテライト アセンブリからリソースを抽出して、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションの開発時に使用できる 1 つ以上の .resw ファイルを記述します。  
+  
+> [!IMPORTANT]
+>  Visual Studio は、ポータブル ライブラリ内のリソースを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリに組み込むために必要なすべての変換を自動的に処理します。  アセンブリ内でリソースを .resw ファイル形式に変換するために Resgen.exe を直接使用する方法は、Visual Studio 外で [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを開発する開発者にのみ関連します。  
+  
+ アセンブリから .resw ファイルを生成する構文は次のとおりです。  
+  
+```  
+resgen filename.extension  [outputDirectory]  
+```  
+  
+ パラメーターは次のとおりです。  
+  
+ `filename.extension`  
+ .NET Framework アセンブリ \(実行可能ファイルまたは .DLL\) の名前。  ファイルにリソースが含まれていない場合、Resgen.exe でファイルは作成されません。  
+  
+ `outputDirectory`  
+ .resw ファイルを記述する既存のディレクトリ。  `outputDirectory` を省略すると、.resw ファイルは現在のディレクトリに書き込まれます。  Resgen.exe は、アセンブリ内の .resources ファイルごとに 1 つの .resw ファイルを作成します。  .resw ファイルのルート ファイル名は .resources ファイルのルート名と同じです。  
+  
+ 次のコマンドは、MyApp.exe に埋め込まれた各 .resources ファイルに対し、Win8Resources ディレクトリに .resw ファイルを作成します。  
+  
+```  
+resgen MyApp.exe Win8Resources  
+```  
+  
+<a name="Conditional"></a>   
+### リソースの条件付きコンパイル  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降、Resgen.exe は、テキスト \(.txt および .restext\) ファイル内の文字列リソースの条件付きコンパイルをサポートしています。  これによって、複数のビルド構成で 1 つのテキスト ベースのリソース ファイルを使用できます。  
+  
+ .txt または .restext ファイルで、シンボルが定義されている場合は、`#ifdef`…`#endif` 構成体を使用してバイナリ .resources ファイルにリソースを含めます。また、`#if !`…  シンボルが定義されていない場合にリソースを含める `#endif` の構造。  コンパイル時に、シンボルのコンマ区切りリストが続く `/define:` オプションを使用して、シンボルを定義します。  比較では、大文字と小文字が区別されます。つまり、`/define` によって定義されたシンボルとコンパイルされるテキスト ファイルのシンボルの大文字と小文字が一致する必要があります。  
+  
+ たとえば、UIResources.rext という名前の次のファイルには、`PRODUCTION`、`CONSULT`、または `RETAIL` のどの名前のシンボルが定義されているかに応じて 3 つの値からいずれか 1 つの値を取得できる `AppTitle` という名前の文字列リソースが含まれます。  
+  
+```  
+  
+#ifdef PRODUCTION  
+AppTitle=My Software Company Project Manager   
+#endif  
+#ifdef CONSULT  
+AppTitle=My Consulting Company Project Manager  
+#endif  
+#ifdef RETAIL  
+AppTitle=My Retail Store Project Manager  
+#endif  
+FileMenuName=File  
+  
+```  
+  
+ ファイルは、次のコマンドを使用してバイナリ .resources ファイルにコンパイルできます。  
+  
+```  
+resgen /define:CONSULT UIResources.restext  
+```  
+  
+ これによって、2 つの文字列リソースを含む .resources ファイルが生成されます。  `AppTitle` リソースの値は "My Consulting Company Project Manager" です。  
+  
+<a name="Strong"></a>   
+### 厳密に型指定されたリソース クラスを生成しています  
+ Resgen.exe は厳密に型指定されたリソースをサポートします。このサポートでは、静的な読み取り専用プロパティを持つクラスを作成して、リソースへのアクセスをカプセル化します。  これによって、リソースを取得するために <xref:System.Resources.ResourceManager> クラスのメソッドを直接呼び出す方法の代替手段が可能になります。  <xref:System.Resources.Tools.StronglyTypedResourceBuilder> クラスの機能をラップする、Resgen.exe の `/str` オプションを使用して、厳密に型指定されたリソース サポートを有効にすることができます。  `/str` オプションを指定した場合の Resgen.exe の出力は、入力パラメーターで参照されるリソースと一致する厳密に型指定されたプロパティを含むクラスです。  このクラスは、処理されたファイルで使用できるリソースに対する、厳密に型指定された読み取り専用アクセスを提供します。  
+  
+ 厳密に型指定されたリソースを作成する構文は次のとおりです。  
+  
+```  
+resgen inputFilename [outputFilename] /str:language[,namespace,[classname[,filename]]] [/publicClass]  
+```  
+  
+ パラメーターとスイッチ:  
+  
+ `inputFilename`  
+ 厳密に型指定されたリソース クラスを生成するためのリソース ファイルのファイル名 \(拡張子を含む\)。  ファイルは、テキスト ベース、XML ベース、または .resources バイナリ ファイルです。.txt、.restext、.resw、または .resources 拡張子を持つことができます。  
+  
+ `outputFilename`  
+ 出力ファイルの名前。  `outputFilename` でディレクトリ パスが示されている場合、ディレクトリが存在する必要があります。  `outputFilename` を省略した場合は、Resgen.exe が `inputFilename` と同じディレクトリに `inputFilename` のルート ファイル名の .resources ファイルを作成します。  
+  
+ `outputFilename` は、テキスト ベース、XML ベース、またはバイナリ .resources ファイルです。  `outputFilename` の拡張子が `inputFilename` のファイル拡張子と異なる場合は、Resgen.exe でファイル変換が実行されます。  
+  
+ `inputFilename` が .resources ファイルで、`outputFilename` も .resources ファイルである場合は、Resgen.exe で .resources ファイルがコピーされます。  `outputFilename` を省略すると、Resgen.exe で `inputFilename` が同一の .resources ファイルで上書きされます。  
+  
+ *language*  
+ 厳密な型のリソース クラスのソース コードの生成に使用する言語。  使用できる値は、C\# コードでは `cs`、`C#`、および `csharp`、Visual Basic コードでは `vb` および `visualbasic`、VBScript コードでは `vbs` および `vbscript`、C\+\+ コードでは `c++`、`mc`、および `cpp` です。  
+  
+ *namespace*  
+ 厳密に型指定したクラスを含む名前空間。  .resources ファイルおよびリソース クラスは、同じ名前空間を持つ必要があります。  `outputFilename` で名前空間を指定する場合については、「[リソースのバイナリ ファイルへのコンパイル](../../../docs/framework/tools/resgen-exe-resource-file-generator.md#Compiling)」を参照してください。  *namespace* を省略すると、リソース クラスは、名前空間に含まれなくなります。  
+  
+ *classname*  
+ 厳密な型のリソース クラスの名前。  これは、.resources ファイルのルート名に対応する必要があります。  たとえば、Resgen.exe で MyCompany.Libraries.Strings.resources という名前の .resources ファイルが生成される場合、厳密に型指定されたリソース クラスの名前は Strings になります。  If *classname* を省略すると、生成されるクラスは `outputFilename` のルート名から派生します。  If `outputFilename` を省略すると、生成されるクラスは `inputFilename` のルート名から派生します。  
+  
+ *classname* には、埋め込まれた空白などの無効な文字を含めることはできません。  *classname* に空白が埋め込まれている場合、または *classname* が *inputFilename* から既定で生成されて、*inputFilename* に空白が埋め込まれている場合、Resgen.exe によって無効な文字がすべてアンダースコア \(\_\) に置き換えられます。  
+  
+ *filename*  
+ クラス ファイルの名前。  
+  
+ `/publicclass`  
+ 厳密に型指定されたリソース クラスを `internal` \(C\# の場合\) または `Friend` \(Visual Basic\) ではなくパブリックにします。  これにより、リソースには、それ自体が埋め込まれているアセンブリの外部からアクセスできます。  
+  
+> [!IMPORTANT]
+>  厳密に型指定されたリソース クラスを作成するときは、生成されたコードの名前空間とクラス名に .resources ファイルの名前を合わせる必要があります。  ただし、Resgen.exe では、互換性のない名前の .resources ファイルを生成するオプションを指定することもできます。  この動作を回避するには、出力ファイルの生成後にその名前を変更します。  
+  
+ 厳密に型指定されたリソース クラスには、次のメンバーがあります。  
+  
+-   厳密に入力されたリソース クラスをインスタンス化するために使用できる、パラメーターなしのコンストラクター。  
+  
+-   `static` \(C\#\) または `Shared` \(Visual Basic\)、および厳密に入力されたリソースを管理する <xref:System.Resources.ResourceManager> のインスタンスを返す読み取り専用 `ResourceManager` プロパティ。  
+  
+-   リソース検索に使用するカルチャを設定する `Culture` 静的プロパティ。  既定値は `null` です。したがって、現在の UI カルチャが使用されることを意味します。  
+  
+-   1 つの `static` \(C\#\) または `Shared` \(Visual Basic\)、および .resources ファイルのリソースごとの読み取り専用プロパティ。  プロパティの名前はリソースの名前です。  
+  
+ たとえば、次のコマンドでは、StringResources.txt という名前のリソース ファイルを StringResources.resources にコンパイルし、リソース マネージャーへのアクセスに使用できる StringResources.vb という名前の Visual Basic ソース コード ファイルに `StringResources` という名前のクラスを生成します。  
+  
+```  
+resgen StringResources.txt /str:vb,,StringResources   
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/secannotate-exe-net-security-annotator-tool.md b/docs/framework/tools/secannotate-exe-net-security-annotator-tool.md
new file mode 100644
index 00000000000..ac669c76eac
--- /dev/null
+++ b/docs/framework/tools/secannotate-exe-net-security-annotator-tool.md
@@ -0,0 +1,67 @@
+---
+title: "SecAnnotate.exe (.NET セキュリティ アノテーター ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "SecAnnotate.exe"
+  - "セキュリティ アノテーター ツール"
+ms.assetid: 8104d208-7813-4a1d-8a75-58f9a7bcb8c9
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# SecAnnotate.exe (.NET セキュリティ アノテーター ツール)
+.NET セキュリティ アノテーター ツール \(SecAnnotate.exe\) は、1 つ以上のアセンブリの `SecurityCritical` 部分と `SecuritySafeCritical` 部分を識別するコマンド ライン アプリケーションです。  
+  
+ Visual Studio 拡張機能の [Security Annotator](http://go.microsoft.com/fwlink/?LinkId=198007) は、SecAnnotate.exe のグラフィカル ユーザー インターフェイスで、Visual Studio からこのツールを実行できます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトで次のコマンドを入力します。*parameters* は、次のセクションで説明するパラメーターで、*assemblies* は、空白で区切られた 1 つ以上のアセンブリ名で構成されます。  
+  
+## 構文  
+  
+```  
+SecAnnotate.exe [parameters] [assemblies]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/a`<br /><br /> または<br /><br /> `/showstatistics`|分析対象のアセンブリにおける透過性の使用に関する統計情報を表示します。|  
+|`/d:` *directory*<br /><br /> または<br /><br /> `/referencedir:` *directory*|注釈の処理時に依存アセンブリを検索するディレクトリを指定します。|  
+|`/i`<br /><br /> または<br /><br /> `/includesignatures`|署名に関する拡張情報を注釈レポート ファイルに含めます。|  
+|`/n`<br /><br /> または<br /><br /> `/nogac`|グローバル アセンブリ キャッシュ内の参照アセンブリを検索しないようにします。|  
+|`/o:` *output.xml*  ``<br /><br /> または<br /><br /> `/out:` *output.xml*|出力注釈ファイルを指定します。|  
+|`/p:` *maxpasses*  ``<br /><br /> または<br /><br /> `/maximumpasses:` *maxpasses*|新しい注釈の生成を停止するまでにアセンブリで実行する注釈パスの最大数を指定します。|  
+|`/q`<br /><br /> または<br /><br /> `/quiet`|クワイエット モードを指定します。このモードでは、ステータス メッセージは出力されず、エラー情報だけが出力されます。|  
+|`/r:` *assembly*<br /><br /> または<br /><br /> `/referenceassembly:` *assembly*|注釈の処理時、依存アセンブリを解決するときに、指定したアセンブリを含めます。  参照アセンブリは参照パスにあるアセンブリよりも優先されます。|  
+|`/s:` *rulename*  ``<br /><br /> または<br /><br /> `/suppressrule:` *rulename*|入力アセンブリについて、指定した透過性規則を実行しないようにします。|  
+|`/t`<br /><br /> または<br /><br /> `/forcetransparent`|強制的に、透過性注釈がないすべてのアセンブリを完全に透過的として扱います。|  
+|`/t`:*assembly*<br /><br /> または<br /><br /> `/forcetransparent`:*assembly*|現在のアセンブリ レベルの注釈に関係なく、指定されたアセンブリを強制的に透過的にします。|  
+|||  
+|`/v`<br /><br /> または<br /><br /> `/verify`|アセンブリの注釈が正しいことだけを検証します。アセンブリで検証されない場合に、必要な注釈をすべて見つけるために複数のパスを実行しようとはしません。|  
+|`/x`<br /><br /> または<br /><br /> `/verbose`|注釈の処理時に詳細を出力することを指定します。|  
+|`/y:` *directory*  ``<br /><br /> または<br /><br /> `/symbolpath:` *directory*|注釈の処理時、シンボル ファイルを検索するときに、指定したディレクトリを含めます。|  
+  
+## 解説  
+ パラメーターとアセンブリは、コマンド ラインでアット マーク \(@\) をプレフィックスとして付けて指定する応答ファイルで指定することもできます。  応答ファイルの各行には、1 つのパラメーターまたはアセンブリの名前を指定する必要があります。  
+  
+ .NET セキュリティ アノテーターの詳細については、.NET セキュリティ ブログの「[Using SecAnnotate to Analyze Your Assemblies for Transparency Violations \(SecAnnotate を使用したアセンブリでの透過性違反の分析\)](http://go.microsoft.com/fwlink/?LinkId=187648)」を参照してください。  
+  
+## 例
\ No newline at end of file
diff --git a/docs/framework/tools/signtool-exe.md b/docs/framework/tools/signtool-exe.md
new file mode 100644
index 00000000000..5fd2e6ad697
--- /dev/null
+++ b/docs/framework/tools/signtool-exe.md
@@ -0,0 +1,225 @@
+---
+title: "SignTool.exe (署名ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "署名ツール"
+  - "SignTool.exe"
+ms.assetid: 0c25ff6c-bff3-422e-b017-146a3ee86cb9
+caps.latest.revision: 33
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# SignTool.exe (署名ツール)
+署名ツールはコマンド ライン ツールで、ファイルにデジタル署名を添付し、ファイルの署名を検証し、ファイルにタイム スタンプを付けます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+signtool [command] [options] [file_name | ...]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|`command`|4 つのコマンド \(`catdb`、`sign`、`Timestamp`、または `Verify`\) の 1 つで、ファイルで実行する操作を指定します。  各コマンドの詳細については、次の表を参照してください。|  
+|`options`|コマンドを変更するオプションです。  グローバル オプション `/q` および `/v` のほかに、各コマンドは固有のオプション セットをサポートします。|  
+|`file_name`|署名するファイルへのパスです。|  
+  
+ 次のコマンドは、署名ツールでサポートされています。  各コマンドは、それぞれのセクションに示す個別のオプション セットと共に使用されます。  
+  
+|コマンド|説明|  
+|----------|--------|  
+|`catdb`|カタログ ファイルをカタログ データベースに追加したり、カタログ データベースから削除したりします。  カタログ データベースは、カタログ ファイルの自動検索で使用され、GUID によって識別されます。  `catdb` コマンドでサポートされているオプションの一覧については、「[catdb コマンド オプション](../../../docs/framework/tools/signtool-exe.md#catdb)」を参照してください。|  
+|`sign`|ファイルにデジタル署名します。  デジタル署名はファイルの改ざんを防止し、ユーザーが署名証明書に基づいて署名者を検証できるようにします。  `sign` コマンドでサポートされているオプションの一覧については、「[sign コマンド オプション](../../../docs/framework/tools/signtool-exe.md#sign)」を参照してください。|  
+|`Timestamp`|ファイルにタイム スタンプを付けます。  `TimeStamp` コマンドでサポートされているオプションの一覧については、「[TimeStamp コマンド オプション](../../../docs/framework/tools/signtool-exe.md#TimeStamp)」を参照してください。|  
+|`Verify`|ファイルのデジタル署名を検証します。そのために、署名証明書が信頼できる機関により発行されたかどうか、署名証明書が取り消されたかどうかを確認します。また、オプションで、署名証明書が特定のポリシーに対して有効になっているかどうかを確認します。  `Verify` コマンドでサポートされているオプションの一覧については、「[Verify コマンド オプション](../../../docs/framework/tools/signtool-exe.md#Verify)」を参照してください。|  
+  
+ 次のオプションは、すべての署名ツール コマンドに適用されます。  
+  
+|Global オプション|説明|  
+|------------------|--------|  
+|**\/q**|コマンドが正常に実行した場合には何も出力されず、コマンドが失敗した場合には最小限の出力が表示されます。|  
+|**\/v**|コマンドが正常に実行したか、失敗したかにかかわらず、詳細出力と警告メッセージが表示されます。|  
+|**\/debug**|デバッグ情報を表示します。|  
+  
+<a name="catdb"></a>   
+## catdb コマンド オプション  
+ 次の表に、`catdb` コマンドと共に使用できるオプションを示します。  
+  
+|Catdb オプション|説明|  
+|-----------------|--------|  
+|`/d`|既定のカタログ データベースを更新するように指定します。  `/d` と `/g` のいずれのオプションも使用しない場合、署名ツールはシステム コンポーネントおよびドライバー データベースを更新します。|  
+|`/g` *GUID*|グローバル一意識別子 *GUID* によって識別されるカタログ データベースを更新するように指定します。|  
+|`/r`|指定したカタログをカタログ データベースから削除します。  このオプションが指定されていない場合、署名ツールはカタログ データベースに指定されたカタログを追加します。|  
+|`/u`|追加されたカタログ ファイルに対して、一意な名前を自動的に生成するように指定します。  必要に応じて、既存のカタログ ファイルと名前が競合しないように、カタログ ファイルの名前が変更されます。  このオプションが指定されていない場合、署名ツールは追加されるカタログと同じ名前を持つ既存のカタログを上書きします。|  
+  
+<a name="sign"></a>   
+## sign コマンド オプション  
+ 次の表に、`sign` コマンドと共に使用できるオプションを示します。  
+  
+|Sign コマンド オプション|説明|  
+|---------------------|--------|  
+|`/a`|最適な署名証明書を自動的に選択します。  署名ツールは、指定されたすべての条件を満たす有効な証明書をすべて検出し、最も長い期間有効である証明書を選択します。  このオプションが指定されていない場合、署名ツールは有効な署名証明書を 1 つだけ検索することが前提とします。|  
+|`/ac`  *file*|*file* から署名ブロックに証明書を追加します。|  
+|`/as`|この署名を追加します。  プライマリ署名が存在しない場合、この署名がプライマリ署名になります。|  
+|`/c`  *CertTemplateName*|署名証明書に対して証明書テンプレート名 \(Microsoft 拡張機能\) を指定します。|  
+|`/csp`  *CSPName*|秘密キー コンテナーを含む暗号化サービス プロバイダー \(CSP: Cryptographic Service Provider\) を指定します。|  
+|`/d`  *Desc*|署名された内容の説明を指定します。|  
+|`/du`  *URL*|署名された内容の詳細な説明に対する URL \(Uniform Resource Locator\) を指定します。|  
+|`/f`  *SignCertFile*|ファイルの署名証明書を指定します。  ファイルが個人情報交換 \(PFX: Personal Information Exchange\) 形式でパスワードによって保護されている場合に、`/p` オプションを使用してパスワードを指定します。  ファイルに秘密キーが含まれていない場合、`/csp` および `/k` オプションを使用して、CSP と秘密キー コンテナー名を指定します。|  
+|`/fd`|ファイルの署名の作成に使用するファイル ダイジェスト アルゴリズムを指定します。  既定値は SHA1 です。|  
+|`/i`  *IssuerName*|署名証明書の発行者の名前を指定します。  この値には、発行者名全体の部分文字列を指定できます。|  
+|`/kc`  *PrivKeyContainerName*|秘密キー コンテナー名を指定します。|  
+|`/n`  *SubjectName*|署名証明書の件名を指定します。  この値には、件名全体の部分文字列を指定できます。|  
+|`/nph`|サポートされている場合に、実行可能ファイルのページ ハッシュを抑制します。  既定値は、SIGNTOOL\_PAGE\_HASHES 環境変数と wintrust.dll のバージョンによって決定されます。  PE ファイル以外では、このオプションは無視されます。|  
+|`/p`  *Password*|PFX ファイルを開くときに使用するパスワードを指定します。  PFX ファイルを指定するには、`/f` オプションを使用します。|  
+|`/p7` *Path*|指定する各コンテンツ ファイルについて公開キー暗号化規格 \(PKCS\) \#7 ファイルを作成することを指定します。  PKCS \#7 ファイルの名前は *path*\\*filename*.p7 です。|  
+|`/p7ce` *Value*|署名された PKCS\#7 コンテンツのオプションを指定します。  署名されたコンテンツを PKCS \#7 ファイルに埋め込む場合は *Value* を "Embedded" に設定し、デタッチされた PKCS \#7 ファイルの署名されたデータ部分を作成する場合には "DetachedSignedData" に設定します。  `/p7ce` オプションを使用しない場合は、既定で署名されたコンテンツが埋め込まれます。|  
+|`/p7co` *\<OID\>*|署名された PKCS\#7 コンテンツを識別するオブジェクト識別子 \(OID\) を指定します。|  
+|`/ph`|サポートされている場合に、実行可能ファイルのページ ハッシュを生成します。|  
+|`/r`  *RootSubjectName*|署名証明書のチェーン先とするルート証明書の件名を指定します。  この値には、ルート証明書の件名全体の部分文字列を指定できます。|  
+|`/s`  *StoreName*|証明書を検索するときに開くストアを指定します。  このオプションが指定されていない場合、`My` ストアが開きます。|  
+|`/sha1`  *Hash*|署名証明書の SHA1 ハッシュを指定します。  以降のスイッチによって指定された条件を複数の証明書が満たす場合、一般的に SHA1 ハッシュが指定されます。|  
+|`/sm`|ユーザー ストアの代わりに、コンピューター ストアを使用するように指定します。|  
+|`/t`  *URL*|タイム スタンプ サーバーの URL を指定します。  このオプション \(または `/tr`\) が指定されていない場合、署名されたファイルにはタイム スタンプが付きません。  タイム スタンプを付けるのに失敗すると、警告が生成されます。  このオプションは、`/tr` オプションと一緒に使用することはできません。|  
+|`/td`  *alg*|`/tr` オプションと共に使用して、RFC 3161 タイム スタンプ サーバーで使用されるダイジェスト アルゴリズムを要求します。|  
+|`/tr`  *URL*|RFC 3161 タイム スタンプ サーバーの URL を指定します。  このオプション \(または `/t`\) が指定されていない場合、署名されたファイルにはタイム スタンプが付きません。  タイム スタンプを付けるのに失敗すると、警告が生成されます。  このオプションは、`/t` オプションと一緒に使用することはできません。|  
+|`/u`  *Usage*|署名証明書に必要な拡張キー使用法 \(EKU: Enhanced Key Usage\) を指定します。  使用法の値は、OID または文字列によって指定できます。  既定の使用法は "Code Signing" \(1.3.6.1.5.5.7.3.3\) です。|  
+|`/uw`|使用法 "Windows System Component Verification" \(1.3.6.1.4.1.311.10.3.6\) を指定します。|  
+  
+ 使用例については、「[SignTool を使用してファイルに署名する](http://msdn.microsoft.com/library/windows/desktop/aa388170.aspx)」をご覧ください。  
+  
+<a name="TimeStamp"></a>   
+## TimeStamp コマンド オプション  
+ 次の表に、`TimeStamp` コマンドと共に使用できるオプションを示します。  
+  
+|TimeStamp オプション|説明|  
+|---------------------|--------|  
+|`/p7`|PKCS \#7 ファイルにタイム スタンプを付けます。|  
+|`/t`  *URL*|タイム スタンプ サーバーの URL を指定します。  タイム スタンプを付けるファイルは、事前に署名されている必要があります。  `/t` オプションまたは `/tr` オプションを指定する必要があります。|  
+|`/td`  *alg*|RFC 3161 タイム スタンプ サーバーで使用されるダイジェスト アルゴリズムを要求します。  `/td` は、`/tr` オプションと共に使用します。|  
+|`/tp` *index*|*index* で署名にタイム スタンプを付けます。|  
+|`/tr`  *URL*|RFC 3161 タイム スタンプ サーバーの URL を指定します。  タイム スタンプを付けるファイルは、事前に署名されている必要があります。  `/tr` オプションまたは `/t` オプションを指定する必要があります。|  
+  
+ 使用例については、「[以前に署名したファイルにタイムスタンプを追加する](http://msdn.microsoft.com/library/windows/desktop/aa375542.aspx)」をご覧ください。  
+  
+<a name="Verify"></a>   
+## Verify コマンド オプション  
+  
+|Verify オプション|説明|  
+|------------------|--------|  
+|`/a`|ファイルの検証にすべてのメソッドを使用できることを指定します。  まず、カタログ データベースを検索して、カタログでファイルが署名されているかどうかを確認します。  任意のカタログでファイルが署名されていない場合、署名ツールはファイルの埋め込み署名の検証を試みます。  カタログで署名されているファイルまたは署名されていないファイルを検証するときには、このオプションをお勧めします。  これらのファイルの例には、Windows ファイルまたはドライバーが含まれます。|  
+|`/ad`|既定のカタログ データベースを使用してカタログを検索します。|  
+|`/ag` *CatDBGUID*|*CatDBGUID* によって識別されるカタログ データベースのカタログを検索します。|  
+|`/all`|複数の署名を含むファイル内のすべての署名を確認します。|  
+|`/as`|システム コンポーネント \(ドライバー\) のカタログ データベースを使用してカタログを検索します。|  
+|`/c` *CatFile*|名前でカタログ ファイルを指定します。|  
+|`/d`|署名ツールで説明と説明の URL を出力するように指定します。|  
+|`/ds` *Index*|指定した位置の署名を検証します。|  
+|`/hash` \(`SHA1` &#124;`SHA256`\)|カタログ内のファイルを検索する場合に使用するオプションのハッシュ アルゴリズムを指定します。|  
+|`/kp`|カーネル モード ドライバーの署名ポリシーを使用して検証を実行するように指定します。|  
+|`/ms`|複数の検証セマンティクスを使用します。  これは、[!INCLUDE[win8](../../../includes/win8-md.md)] 以上での [WinVerifyTrust](http://msdn.microsoft.com/library/windows/desktop/aa388208.aspx) 呼び出しの既定の動作です。|  
+|`/o` *Version*|オペレーティング システムのバージョンでファイルを確認します。  *Version* の形式は、*PlatformID*:*VerMajor*.*VerMinor*.*BuildNumber* です。  *PlatformID* は、<xref:System.PlatformID> 列挙メンバーの基になる値を表します。 **Important:**  `/o` スイッチを使用することをお勧めします。  `/o` を指定しない場合、SignTool.exe から予期しない結果が返されることがあります。  たとえば、`/o` スイッチを含めない場合、古いオペレーティング システム上で正しく検証されるシステム カタログが新しいオペレーティング システムで正しく検証されないことがあります。|  
+|`/p7`|PKCS \#7 ファイルを確認します。  PKCS \#7 検証で既存のポリシーは使用されません。  署名がチェックされ、署名証明書のチェーンがビルドされます。|  
+|`/pa`|既定の Authenticode 検証ポリシーを使用するように指定します。  `/pa` オプションが指定されていない場合、署名ツールは Windows ドライバー検証ポリシーを使用します。  このオプションは、`catdb` オプションと一緒に使用することはできません。|  
+|`/pg` *PolicyGUID*|GUID により検証ポリシーを指定します。  *PolicyGUID* は検証ポリシーの ActionID に対応しています。  このオプションは、`catdb` オプションと一緒に使用することはできません。|  
+|`/ph`|署名ツールでページ ハッシュ値を出力および検証するように指定します。|  
+|`/r` *RootSubjectName*|署名証明書のチェーン先とするルート証明書の件名を指定します。  この値には、ルート証明書の件名全体の部分文字列を指定できます。|  
+|`/tw`|署名にタイム スタンプが付けられていない場合に、警告を生成することを指定します。|  
+  
+ 使用例については、「[SignTool を使用してファイルの署名を検証する](http://msdn.microsoft.com/library/windows/desktop/aa388171.aspx)」をご覧ください。  
+  
+## 戻り値  
+ 署名ツールは、終了時に次のいずれかの終了コードを返します。  
+  
+|終了コード|説明|  
+|-----------|--------|  
+|0|実行に成功しました。|  
+|1|実行に失敗しました。|  
+|2|実行は完了しましたが、警告があります。|  
+  
+## 例  
+ カタログ ファイル MyCatalogFileName.cat をシステム コンポーネントおよびドライバー データベースに追加するコマンドを次に示します。  `/v` オプションは、必要に応じて一意の名前を生成し、`MyCatalogFileName.cat` という名前の既存のカタログ ファイルが置き換えられないようにします。  
+  
+```  
+signtool catdb /v /u MyCatalogFileName.cat  
+```  
+  
+ 最適な証明書を使用してファイルに自動的に署名するコマンドを次に示します。  
+  
+```  
+signtool sign /a MyFile.exe  
+```  
+  
+ パスワードで保護された PFX ファイルに格納されている証明書を使用してファイルにデジタル署名するコマンドを次に示します。  
+  
+```  
+signtool sign /f MyCert.pfx /p MyPassword MyFile.exe  
+```  
+  
+ ファイルにデジタル署名してタイム スタンプを付けるコマンドを次に示します。  ファイルへの署名に使用する証明書は、PFX ファイルに格納されています。  
+  
+```  
+signtool sign /f MyCert.pfx /t http://timestamp.verisign.com/scripts/timstamp.dll MyFile.exe  
+```  
+  
+ `My` ストアにある件名が `My Company Certificate` の証明書を使用してファイルに署名するコマンドを次に示します。  
+  
+```  
+signtool sign /n "My Company Certificate" MyFile.exe  
+```  
+  
+ ActiveX コントロールに署名して、ユーザーがコントロールをインストールするように求められるときに Internet Explorer に表示される情報を指定するコマンドを次に示します。  
+  
+```  
+Signtool sign /f MyCert.pfx /d: "MyControl" /du http://www.example.com/MyControl/info.html MyControl.exe  
+```  
+  
+ デジタル署名済みのファイルにタイム スタンプを付けるコマンドを次に示します。  
+  
+```  
+signtool timestamp /t http://timestamp.verisign.com/scripts/timstamp.dll MyFile.exe  
+```  
+  
+ ファイルが署名済みであることを検証するコマンドを次に示します。  
+  
+```  
+signtool verify MyFile.exe  
+```  
+  
+ カタログで署名されている可能性があるシステム ファイルを検証するコマンドを次に示します。  
+  
+```  
+signtool verify /a SystemFile.dll  
+```  
+  
+ `MyCatalog.cat` という名前のカタログで署名されているシステム ファイルを検証するコマンドを次に示します。  
+  
+```  
+signtool verify /c MyCatalog.cat SystemFile.dll  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/sn-exe-strong-name-tool.md b/docs/framework/tools/sn-exe-strong-name-tool.md
new file mode 100644
index 00000000000..750ae04d0b2
--- /dev/null
+++ b/docs/framework/tools/sn-exe-strong-name-tool.md
@@ -0,0 +1,137 @@
+---
+title: "Sn.exe (厳密名ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 署名"
+  - "キー ペア (ファイルに署名するための)"
+  - "公開キー, 署名 (ファイルへの)"
+  - "署名 (ファイルへの)"
+  - "Sn.exe"
+  - "厳密名ツール"
+  - "厳密な名前を付けたアセンブリ, 署名 (ファイルへの)"
+ms.assetid: c1d2b532-1b8e-4c7a-8ac5-53b801135ec6
+caps.latest.revision: 44
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 44
+---
+# Sn.exe (厳密名ツール)
+厳密名ツール \(Sn.exe\) は、[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)を使用してアセンブリに署名する場合に役立ちます。  Sn.exe には、キーの管理、署名の生成、署名の検査に関する各オプションが用意されています。  
+  
+ 厳密な名前付けと厳密な名前付きアセンブリについて詳しくは、「[厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)」と「[方法 : 厳密な名前でアセンブリに署名する](../../../docs/framework/app-domains/how-to-sign-an-assembly-with-a-strong-name.md)」をご覧ください。  
+  
+ 厳密名ツールは Visual Studio と共に自動的にインストールされます。  このツールを開始するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+> [!NOTE]
+>  64 ビット コンピューターでは、Visual Studio コマンド プロンプトを使用して 32 ビット バージョンの Sn.exe を、Visual Studio x64 Win64 コマンド プロンプトを使用して 64 ビット バージョンを実行してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+sn [-quiet][option [parameter(s)]]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\-a** *identityKeyPairFile* *signaturePublicKeyFile*|<xref:System.Reflection.AssemblySignatureKeyAttribute> データを生成して、ID キーをファイルからの署名キーに移行します。|  
+|**\-ac** *identityPublicKeyFile* *identityKeyPairContainer* *signaturePublicKeyFile*|<xref:System.Reflection.AssemblySignatureKeyAttribute> データを生成して、ID キーをキー コンテナーからの署名キーに移行します。|  
+|**\-c** \[*csp*\]|厳密な名前による署名に使用する既定の暗号サービス プロバイダー \(CSP: Cryptographic Service Provider\) を設定します。  この設定は、コンピューター全体に適用されます。  CSP 名を指定しない場合は、現在の設定がクリアされます。|  
+|**\-d** *container*|指定したキー コンテナーを厳密な名前 CSP から削除します。|  
+|**\-D**  *assembly1 assembly2*|2 つのアセンブリの違いが、署名だけかどうかを検査します。  通常は、このオプションは、別のキー ペアを使用してアセンブリに再署名した後のチェック用として使用されます。|  
+|**\-e**  *assembly outfile*|*assembly* から公開キーを抽出し、*outfile*に格納します。|  
+|**\-h**|このツールのコマンド構文とオプションを表示します。|  
+|**\-i** *infile container*|指定したキー コンテナーに、*infile*に含まれるキー ペアをインストールします。  キー コンテナーは厳密な名前 CSP 内に常駐します。|  
+|**\-k** \[*keysize*\] *outfile*|指定したサイズの新しい <xref:System.Security.Cryptography.RSACryptoServiceProvider> キーを生成し、指定したファイルに書き込みます。  公開キーと秘密キーの両方がファイルに書き込みまれます。<br /><br /> キーのサイズを指定しない場合、Microsoft Enhanced Cryptographic Provider をインストールしている場合は既定で 1,024 ビットのキーが生成され、インストールしていない場合は既定で 512 ビットのキーが生成されます。<br /><br /> Microsoft Enhanced Cryptographic Provider をインストールしている場合、*keysize* パラメーターは、8 ビット間隔で 384 ビットから 16,384 ビットまでの長さのキーをサポートします。  Microsoft Enhanced Cryptographic Provider をインストールしていない場合は、8 ビット間隔で 384 ビットから 512 ビットまでの長さのキーをサポートします。|  
+|**\-m** \[**y** *&#124;* **n**\]|キー コンテナーがコンピューターに固有であるか、ユーザーに固有であるかを指定します。  *y* を指定した場合、キー コンテナーはコンピューターに固有です。  *n* を指定した場合、キー コンテナーはユーザーに固有です。<br /><br /> y も n も指定しない場合は、現在の設定が表示されます。|  
+|**\-o**  *infile* \[*outfile*\]|*infile* から公開キーを抽出し、.csv ファイルに格納します。  公開キーの各バイトはコンマで区切られます。  この形式は、ソース コード内で、キーへの参照を初期化済みの配列としてハードコーディングする場合に便利です。  *outfile* を指定しない場合、出力はクリップボードに保存されます。 **Note:**  このオプションでは、入力が公開キーのみであるかどうかの検証は行われません。  `infile` に秘密キーとのキー ペアが格納されていた場合、秘密キーも抽出されます。|  
+|**\-p** *infile outfile* \[*hashalg*\]|*infile* 内のキー ペアから公開キーを抽出し、その公開キーを *outfile* に格納します。オプションで *hashalg* で指定された RSA アルゴリズムを使用します。  この公開キーは、[アセンブリ リンカー \(Al.exe\)](../../../docs/framework/tools/al-exe-assembly-linker.md) の **\/delaysign\+**  オプションと **\/keyfile** オプションを使用して、アセンブリへの署名を遅らせるときに使用できます。  アセンブリの署名を遅らせた場合、コンパイル時には公開キーだけが設定され、後で秘密キーが判明したときに追加される署名用にファイル内の領域が予約されます。|  
+|**\-pc**  *container* *outfile* \[*hashalg*\]|*container* 内のキー ペアから公開キーを抽出し、*outfile* に格納します。  *hashalg* オプションを使用する場合、RSA アルゴリズムにより公開キーが抽出されます。|  
+|**\-Pb** \[**y** *&#124;* **n**\]|厳密な名前を省略するポリシーが強制されるかどうかを指定します。  *y* を指定すると、完全に信頼されている <xref:System.AppDomain> に完全信頼アセンブリが読み込まれるとき、アセンブリの厳密な名前の検証は行われません。  *n* を指定した場合は、厳密な名前が正しいかどうかのみ検証されますが、特定の厳密な名前については確認されません。  <xref:System.Security.Permissions.StrongNameIdentityPermission> は、完全に信頼されているアセンブリには効果がありません。  厳密な名前の一致については、独自のチェックを実行する必要があります。<br /><br /> `y` も `n` も指定しない場合は、現在の設定が表示されます。  既定値は、`y` です。 **Note:**  64 ビット コンピューターでは、Sn.exe の 32 ビットのインスタンスと 64 ビットのインスタンスの両方にこのパラメーターを設定する必要があります。|  
+|**\-q**\[**uiet**\]|クワイエット モードを指定します。このモードでは、成功メッセージは表示されません。|  
+|**\-R**\[**a**\] *assembly* *infile*|以前に署名したアセンブリ、または署名を遅らせたアセンブリに、*infile* 内のキー ペアを使用して再署名します。<br /><br /> **\-Ra** を使用すると、アセンブリ内のすべてのファイルについてハッシュが再計算されます。|  
+|**\-Rc**\[**a**\] *assembly container*|以前に署名したアセンブリ、または署名を遅らせたアセンブリに、*container* 内のキー ペアを使用して再署名します。<br /><br /> **\-Rca** を使用すると、アセンブリ内のすべてのファイルについてハッシュが再計算されます。|  
+|**\-Rh** *assembly*|アセンブリ内のすべてのファイルについてハッシュを再計算します。|  
+|**\-t**\[**p**\] *infile*|*infile* に格納されている公開キーに関するトークンを表示します。  *infile* には、以前に **\-p** を使用してキー ペア ファイルから生成された公開キーが含まれている必要があります。  **\-t\[p\]** オプションを使用して、トークンをキー ペア ファイルから直接抽出しないでください。<br /><br /> トークンは、ハッシュ関数によって公開キーから算出されます。  領域を節約するために、共通言語ランタイムは厳密な名前を持つアセンブリへの依存度を記録するときに、別のアセンブリへ参照の一部として公開キー トークンをマニフェスト内に格納します。  **\-tp** オプションを指定すると、トークンの他に公開キーも表示されます。  <xref:System.Reflection.AssemblySignatureKeyAttribute> 属性がアセンブリに適用されている場合、トークンは ID キー用であり、ハッシュ アルゴリズムの名前と ID キーが表示されます。<br /><br /> このオプションはアセンブリ署名を検証しないため、信頼の決定には使用しないでください。  このオプションは、生の公開キー トークン データのみを表示します。|  
+|**\-T**\[**p**\] *assembly*|assembly に関する公開キー トークンを表示します。*assembly* には、アセンブリ マニフェストを含むファイルの名前を指定する必要があります。<br /><br /> トークンは、ハッシュ関数によって公開キーから算出されます。  領域を節約するために、共通言語ランタイムは厳密な名前を持つアセンブリへの依存度を記録するときに、別のアセンブリへ参照の一部として公開キー トークンをマニフェスト内に格納します。  **\-Tp** オプションを指定すると、トークンの他に公開キーも表示されます。  <xref:System.Reflection.AssemblySignatureKeyAttribute> 属性がアセンブリに適用されている場合、トークンは ID キー用であり、ハッシュ アルゴリズムの名前と ID キーが表示されます。<br /><br /> このオプションはアセンブリ署名を検証しないため、信頼の決定には使用しないでください。  このオプションは、生の公開キー トークン データのみを表示します。|  
+|`-TS`  `assembly` `infile`|`assembly` のキー ペアを使用して、`infile` に署名または部分署名されている署名を検査します。|  
+|\-`TSc` `assembly` `container`|キー コンテナー `assembly` のキー ペアを使用して、`container` に署名または部分署名されている署名を検査します。|  
+|**\-v** *assembly*|*assembly* 内の厳密な名前を検査します。ここで、*assembly* はアセンブリ マニフェストを含むファイルの名前です。|  
+|**\-vf**  *assembly*|assembly 内の厳密な名前を検査します。**\-v** オプションとは異なり、**\-vf** では **\-Vr** オプションで無効化した場合であっても、検査を強制的に実行します。|  
+|**\-Vk**  *regfile.reg* *assembly* \[*userlist*\] \[*infile*\]|指定したアセンブリを登録して検証をスキップするために使用できる登録エントリ \(.reg\) ファイルを作成します。  **\-Vr** オプションに適用されるアセンブリ名前付け規則が **\-Vu** オプションにも適用されます。  *userlist* オプションと *infile* オプションについては、**\-Vr** オプションを参照してください。|  
+|**\-Vl**|コンピューター上の厳密な名前検査に関する、現在の設定を一覧表示します。|  
+|**\-Vr**  *assembly* \[*userlist*\] \[*infile*\]|検査をスキップする *assembly* を登録します。  必要に応じて、検証の省略を適用する必要があるコンマで区切られたユーザー名のリストを指定できます。  *infile* を指定した場合、検査は実行されますが、検査時には *infile* 内の公開キーが使用されます。  指定した厳密な名前を持つアセンブリをすべて登録するには、*\*, strongname* という形式で *assembly* を指定します。  *strongname* は、トークン化した形式の公開キーを表す 16 進形式の文字列として指定します。  公開キー トークンの表示については、**\-t** オプションと **\-T** オプションを参照してください。 **Caution:**  このオプションは開発時だけ使用します。  検証省略リストにアセンブリを追加すると、セキュリティ上の脆弱性が生じます。  悪意のあるアセンブリは、検証省略リストに追加されたアセンブリの完全限定アセンブリ名 \(アセンブリ名、バージョン、カルチャ、および公開キー トークン\) を使用することによって、その ID を偽装できます。  これによって、悪意のあるアセンブリの検証も省略できます。|  
+|||  
+|**\-Vu**  *assembly*|検査をスキップする *assembly* の登録を解除します。  **\-Vr** オプションに適用される規則と同じアセンブリ名前付け規則が **\-Vu** オプションにも適用されます。|  
+|**\-Vx**|検査をスキップするエントリをすべて削除します。|  
+|**\-?**|このツールのコマンド構文とオプションを表示します。|  
+  
+> [!NOTE]
+>  Sn.exe の全オプションでは大文字と小文字が区別されます。また、オプションが正しく認識されるためには、表記されたとおりに正確に入力する必要があります。  
+  
+## 解説  
+ **\-R** オプションと **–Rc** オプションは、署名を遅らせたアセンブリを処理する場合に便利です。  その場合、コンパイル時には公開キーだけが設定され、後で秘密キーが判明したときに署名が実行されます。  
+  
+> [!NOTE]
+>  レジストリなどの保護されたリソースに書き込むパラメーター \(例: –**Vr\)** の場合は、管理者として SN.exe を実行してください。  
+  
+## 例  
+ 新しいランダム キー ペアを作成し、`keyPair.snk` に格納するコマンドを次に示します。  
+  
+```  
+sn -k keyPair.snk  
+```  
+  
+ 厳密な名前 CSP 内のコンテナー `keyPair.snk` 内の `MyContainer` にキーを格納するコマンドを次に示します。  
+  
+```  
+sn -i keyPair.snk MyContainer  
+```  
+  
+ `keyPair.snk` から公開キーを抽出し、`publicKey.snk` に格納するコマンドを次に示します。  
+  
+```  
+sn -p keyPair.snk publicKey.snk  
+```  
+  
+ 公開キーおよび `publicKey.snk` に含まれている公開キーのトークンを表示するコマンドを次に示します。  
+  
+```  
+sn -tp publicKey.snk  
+```  
+  
+ アセンブリ `MyAsm.dll` を検査するコマンドを次に示します。  
+  
+```  
+sn -v MyAsm.dll  
+```  
+  
+ 既定の CSP から `MyContainer` を削除するコマンドを次に示します。  
+  
+```  
+sn -d MyContainer  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Al.exe \(アセンブリ リンカー\)](../../../docs/framework/tools/al-exe-assembly-linker.md)   
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/sos-dll-sos-debugging-extension.md b/docs/framework/tools/sos-dll-sos-debugging-extension.md
new file mode 100644
index 00000000000..2b9df6573d8
--- /dev/null
+++ b/docs/framework/tools/sos-dll-sos-debugging-extension.md
@@ -0,0 +1,219 @@
+---
+title: "SOS.dll (SOS デバッガー拡張) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "デバッグ (拡張機能を)"
+  - "SOS デバッガー拡張"
+  - "SOS.dll"
+ms.assetid: 9ac1b522-77ab-4cdc-852a-20fcdc9ae498
+caps.latest.revision: 55
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 55
+---
+# SOS.dll (SOS デバッガー拡張)
+SOS デバッガー拡張 (SOS.dll) を使用して内部の共通言語ランタイム (CLR: Common Language Runtime) 環境に関する情報を渡すことにより、Visual Studio および Windows デバッガー (WinDbg.exe) でマネージ プログラムをデバッグできます。 このツールを使用するには、プロジェクトでアンマネージ デバッグが有効になっている必要があります。 SOS.dll は、.NET Framework と共に自動的にインストールされます。 Visual Studio で SOS.dll を使用するインストール、 [Windows Driver Kit (WDK)](http://msdn.microsoft.com/windows/hardware/hh852362)します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] を使用している場合は、Visual Studio 内の Windows デバッガーで SOS.dll がサポートされますが、Visual Studio デバッガーのイミディエイト ウィンドウではサポートされません。  
+  
+## <a name="syntax"></a>構文  
+  
+```  
+![command] [options]   
+```  
+  
+## <a name="commands"></a>コマンド  
+  
+|コマンド|説明|  
+|-------------|-----------------|  
+|**AnalyzeOOM** (**ao**)|ガベージ コレクション ヒープへの割り当て要求で発生した最後の OOM に対する情報を表示します。 サーバーのガベージ コレクションでは、ガベージ コレクション ヒープごとに OOM を表示します (存在する場合)。|  
+|**BPMD** [**-nofuturemodule**] [*module name*> *method name*>] [**-md** <`MethodDesc`>] **-list** **-clear** \<*pending breakpoint number*> **-clearall**|指定したモジュールの指定したメソッドにブレークポイントを作成します。<br /><br /> 指定したモジュールとメソッドが読み込まれていない場合、このコマンドは、モジュールが読み込まれ、Just-In-Time (JIT) コンパイルが終了したことを示す通知を受け取るまで待機してから、ブレークポイントを作成します。<br /><br /> 使用して保留中のブレークポイントの一覧を管理することができます、 **-リスト**、 **-オフ**、および**- clearall**オプション。<br /><br /> **-リスト**オプションは、保留中のすべてのブレークポイントの一覧を生成します。 保留中のブレークポイントにゼロ以外のモジュール ID がある場合、そのブレークポイントはその特定の読み込まれたモジュール内の関数に対するブレークポイントです。 保留中のブレークポイントにゼロのモジュール ID がある場合、そのブレークポイントはまだ読み込まれていないモジュールに適用されます。<br /><br /> 使用して、 **-オフ**または**- clearall**保留中のブレークポイントをリストから削除するにはオプションです。|  
+|**CLRStack** [**-a**] [**-l**] [**-p**] [**-n**]|マネージ コードのみのスタック トレースを提供します。<br /><br /> **-P**オプションは、マネージ関数に引数を示しています。<br /><br /> **-L**オプションは、フレーム内のローカル変数に関する情報を表示します。 SOS デバッガー拡張がローカルの名前を取得できないのは、ローカル名の出力の形式がため*ローカル アドレス*> **=** \<*値*> します。<br /><br /> **-A**(すべて) オプションは、ショートカットを**-l**と**-p**結合します。<br /><br /> **-N**オプションは、ソース ファイル名と行番号の表示を無効になります。 デバッガーで SYMOPT_LOAD_LINES オプションが指定されている場合、SOS はすべてのマネージ フレームでシンボルを検索し、成功した場合は、対応するソース ファイル名と行番号を表示します。 **-N** (行番号なし) パラメーターは、この動作を無効に指定することができます。<br /><br /> x64 ベースおよび IA-64 ベースのプラットフォーム上では、SOS デバッガー拡張で遷移フレームは表示されません。|  
+|**COMState**|COM アパートメント モデルを使用可能な場合、各スレッドと `Context` ポインターについてモデルを一覧表示します。|  
+|**DumpArray** [**-start** \<*startIndex*>] [**-length** \<*length*>] [**-details**] [**-nofields**] *array object address*><br /><br /> または<br /><br /> **DA** [**-start** \<*startIndex*>] [**-length** \<*length*>] [**-detail**] [**-nofields**] *array object address*>|配列オブジェクトの要素を調べます。<br /><br /> **-開始**オプションは、要素を表示する位置を示す開始インデックスを指定します。<br /><br /> **-長さ**オプションを表示する要素の数を指定します。<br /><br /> **-詳細**オプションを使用して要素の詳細を表示する、 **DumpObj**と**DumpVC**形式です。<br /><br /> **- Nofields**オプションが配列表示されないようにします。 このオプションは利用可能な場合にのみ、 **-詳細**オプションを指定します。|  
+|**DumpAssembly** \<*とアセンブリ アドレス*>|アセンブリに関する情報を表示します。<br /><br /> **DumpAssembly**コマンドは、存在する場合に複数のモジュールを一覧表示します。<br /><br /> 使用するとアセンブリ アドレスを取得できます、**指定しないで呼び出すと**コマンドです。|  
+|**DumpClass** \<*EEClass アドレス*>|型に関連付けられている `EEClass` 構造体に関する情報を表示します。<br /><br /> **DumpClass**コマンドは、静的フィールドの値が表示されますが、静的でないフィールドの値は表示されません。<br /><br /> 使用して、 **DumpMT**、 **DumpObj**、 **Name2EE**、または**Token2EE**を取得するコマンド、`EEClass`アドレスを構成します。|  
+|**指定しないで呼び出すと**[*ドメイン アドレス*>]|各列挙<xref:System.Reflection.Assembly>オブジェクトを指定した内に読み込まれて<xref:System.AppDomain>オブジェクトのアドレス。  パラメーターなしで呼び出されたときに、**指定しないで呼び出すと**コマンドがすべて一覧表示<xref:System.AppDomain>プロセス内のオブジェクト。|  
+|**DumpHeap** [**-stat**] [**-strings**] [**-short**] [**-min** \<*size*>] [**-max** \<*size*>] [**-thinlock**] [**-startAtLowerBound**] [**-mt** \<*MethodTable address*>] [**-type** \<*partial type name*>][*start* [*end*]]|ガベージ コレクトされたヒープと、オブジェクトの収集統計に関する情報を表示します。<br /><br /> **DumpHeap**コマンドは、ガベージ コレクター ヒープの過剰な断片化が検出された場合に警告を表示します。<br /><br /> **-Stat**オプションは、統計的な型の概要に出力を制限します。<br /><br /> **-文字列**オプションは、統計的な文字列値の概要に出力を制限します。<br /><br /> **-短い**オプションは、各オブジェクトのアドレスだけに出力を制限します。 これにより、コマンドからの出力を別のデバッガー コマンドに簡単にパイプして、オートメーションを実現できます。<br /><br /> **最小**オプションであるオブジェクトを無視するよりも低い`size`、バイト単位で指定したパラメーターです。<br /><br /> **-最大**オプションよりも大きいオブジェクトを無視する、 `size` 、バイト単位で指定したパラメーターです。<br /><br /> **- Thinlock**オプションは、ThinLocks を報告します。  詳細については、次を参照してください。、 **SyncBlk**コマンドです。<br /><br /> `-startAtLowerBound` オプションは、指定したアドレス範囲の下限からヒープ ウォークを強制的に開始します。 計画フェーズの間は、オブジェクトが移動されているのでヒープをウォークできないことがよくあります。 このオプションは強制**DumpHeap**に指定した下限にウォークを開始します。 このオプションが機能するには、有効なオブジェクトのアドレスを下限として指定する必要があります。 無効なオブジェクトのアドレスのメモリを表示して、次のメソッド テーブルを手動で検索できます。 ガベージ コレクションが現在 `memcopy` を呼び出している場合は、パラメーターとして渡された開始アドレスにサイズを追加することで、次のオブジェクトのアドレスを特定することもできます。<br /><br /> **-Mt**オプションを指定された対応するオブジェクトのみを一覧表示`MethodTable`構造体。<br /><br /> **-型**オプションには、型名を持つ、指定した文字列の部分文字列一致するオブジェクトのみが一覧表示します。<br /><br /> `start` パラメーターは、指定したアドレスから一覧表示を開始します。<br /><br /> `end` パラメーターは、指定したアドレスで一覧表示を終了します。|  
+|**DumpIL** \<*DynamicMethod のマネージ オブジェクト*> |      *DynamicMethodDesc ポインター*> |       *MethodDesc ポインター*>|マネージ メソッドに関連付けられている Microsoft Intermediate Language (MSIL) を表示します。<br /><br /> 動的な MSIL は、アセンブリから読み込まれた MSIL とは異なる形式で出力されます。 動的な MSIL は、メタデータ トークンではなくマネージ オブジェクト配列内のオブジェクトを参照します。|  
+|**DumpLog** [**-addr** \<*addressOfStressLog*>] [*Filenam*`e`>]|メモリ内ストレス ログの内容を、指定したファイルに書き込みます。 名前を指定しないと、現在のディレクトリ内に StressLog.txt という名前のファイルが作成されます。<br /><br /> メモリ内ストレス ログを使用すると、ロックまたは I/O を使用せずにストレス エラーを診断できます。 ストレス ログを有効にするには、hkey_local_machine の下にある次のレジストリ キーを設定\\します。NETFramework:<br /><br /> (DWORD) StressLog = 1<br /><br /> (DWORD) LogFacility = 0xffffffff<br /><br /> (DWORD) StressLogSize = 65536<br /><br /> 省略可能な `-addr` オプションを使用すると、デフォルト ログ以外のストレス ログを指定できます。|  
+|**DumpMD** \<*MethodDesc アドレス*>|指定したアドレスにある `MethodDesc` 構造体に関する情報を表示します。<br /><br /> 使用することができます、 **IP2MD**を取得するコマンド、`MethodDesc`マネージ関数からのアドレスを構成します。|  
+|**DumpMT** [**-MD**] *MethodTable のアドレス*>|指定したアドレスにあるメソッド テーブルに関する情報を表示します。 指定する、 **-MD**オプションは、オブジェクトに定義されているすべてのメソッドの一覧を表示します。<br /><br /> 各マネージ オブジェクトにメソッド テーブルのポインターが含まれています。|  
+|**DumpMethodSig** \<*sigaddr*>*モジュール*`r`>|指定したアドレスにある `MethodSig` 構造体に関する情報を表示します。|  
+|**DumpModule** [**-mt**]*モジュールのアドレス*>|指定したアドレスにあるモジュールに関する情報を表示します。 **-Mt**オプションは、モジュールで定義された型とモジュールによって参照される型が表示されます。<br /><br /> 使用することができます、**指定しないで呼び出すと**または**DumpAssembly**モジュールのアドレスを取得するコマンドです。|  
+|**DumpObj** [**- nofields**]*オブジェクトのアドレス*><br /><br /> または<br /><br /> **** \<*オブジェクトのアドレス*>|指定したアドレスにあるオブジェクトに関する情報を表示します。 **DumpObj**コマンドは、フィールドを表示、`EEClass`構造体については、メソッド テーブル、およびオブジェクトのサイズ。<br /><br /> 使用することができます、 **DumpStackObjects**オブジェクトのアドレスを取得するコマンドです。<br /><br /> 実行することに注意してください、 **DumpObj**コマンド型のフィールドを`CLASS`はオブジェクトでもあるためです。<br /><br /> `-` **Nofields**オプションが表示されているオブジェクトのフィールドを使用する、文字列のようなオブジェクトと便利です。|  
+|**DumpRuntimeTypes**|ガベージ コレクター ヒープの中にあるランタイムの型オブジェクトを表示し、それらに関連付けられている型名とメソッド テーブルを一覧表示します。|  
+|**DumpStack** [**-EE**] [**-n**] [`top` *stack* [`bottom` *stac*`k`]]|スタック トレースを表示します。<br /><br /> **EE**オプションにより、 **DumpStack**マネージ関数のみを表示するコマンドです。 `top` パラメーターおよび `bottom` パラメーターを使用して、x86 プラットフォーム上で表示するスタック フレームを制限します。<br /><br /> **-N**オプションは、ソース ファイル名と行番号の表示を無効になります。 デバッガーで SYMOPT_LOAD_LINES オプションが指定されている場合、SOS はすべてのマネージ フレームでシンボルを検索し、成功した場合は、対応するソース ファイル名と行番号を表示します。 **-N** (行番号なし) パラメーターは、この動作を無効に指定することができます。<br /><br /> X86 および x64 プラットフォームで、 **DumpStack**コマンドは、詳細なスタック トレースを作成します。<br /><br /> IA&64; ベースのプラットフォームで、 **DumpStack**コマンドと、デバッガーの**K**コマンドです。 IA-64 ベースのプラットフォーム上では、`top` パラメーターと `bottom` パラメーターは無視されます。|  
+|**DumpSig** \<*sigaddr*> *moduleaddr*>|指定したアドレスにある `Sig` 構造体に関する情報を表示します。|  
+|**DumpSigElem** \<*sigaddr*> *moduleaddr*>|署名オブジェクトの&1; つの要素を表示します。 ほとんどの場合、使用することは**DumpSig**個別の署名オブジェクトを確認します。 ただし、何らかの方法で、署名が破損しています、して**DumpSigElem**の有効な部分を読み取るにします。|  
+|**DumpStackObjects** [**-verify**] [`top` *stack* [`bottom` *stack*]]<br /><br /> または<br /><br /> **DSO** [**-verify**] [`top` *stack* [`bottom` *stack*]]|現在のスタックの範囲内で見つかったすべてのマネージ オブジェクトを表示します。<br /><br /> **のことを確認**検証静的でない各`CLASS`オブジェクト フィールドのフィールドです。<br /><br /> 使用して、 **DumpStackObject**などコマンドはスタック トレース コマンドと共に、 **K**コマンドと**CLRStack**コマンドをローカル変数とパラメーターの値を決定します。|  
+|**DumpVC** \<*MethodTable のアドレス*>*アドレス*>|指定したアドレスにある値クラスのフィールドに関する情報を表示します。<br /><br /> **MethodTable**パラメーターを使用して、 **DumpVC**コマンド フィールドを正しく解釈されます。 値クラスでは、最初のフィールドがメソッド テーブルになることはありません。|  
+|**EEHeap** [**-gc**] [**-loader**]|内部の共通言語ランタイム データ構造体によって消費されるプロセス メモリに関する情報を表示します。<br /><br /> **-Gc**と**-ローダー**オプションは、ガベージ コレクターまたはローダーのデータ構造体には、このコマンドの出力を制限します。<br /><br /> ガベージ コレクターの場合、マネージ ヒープの各セグメントの範囲内にある情報が一覧表示されます。  によって指定されたセグメント内にポインターがあるかどうかは**-gc**、そのポインターはオブジェクト ポインター。|  
+|**EEStack** [**-short**] [**-EE**]|実行、 **DumpStack**プロセス内のすべてのスレッドにします。<br /><br /> **EE**オプションに直接渡される、 **DumpStack**コマンドです。 **-短い**パラメーターは、次の種類のスレッドへの出力を制限します。<br /><br /> ロックを取得しているスレッド。<br /><br /> ガベージ コレクションを実行できるように停止されているスレッド。<br /><br /> 現在マネージ コードにあるスレッド。|  
+|**EEVersion**|共通言語ランタイムのバージョンを表示します。|  
+|**EHInfo** [*MethodDesc アドレス*>] [*コード アドレス*>]|指定したメソッドの例外処理ブロックを表示します。  このコマンドを使用すると、句ブロック (`try` ブロック) およびハンドラー ブロック (`catch` ブロック) のコード アドレスとオフセットが表示されます。|  
+|**FAQ**|よく寄せられる質問を表示します。|  
+|**FinalizeQueue** [**-詳細**] |[**-allReady**] [**-short**]|完了の目的で登録されているすべてのオブジェクトを表示します。<br /><br /> **-詳細**オプションは、いずれかに関する追加情報を表示`SyncBlocks`をクリーンアップする必要があると`RuntimeCallableWrappers`(Rcw) のクリーンアップを待っています。 どちらのデータ構造体も、実行するとファイナライザー スレッドでキャッシュされクリーンアップされます。<br /><br /> `-allReady` オプションは、終了準備完了になっているすべてのオブジェクトを表示します。ガベージ コレクションによって既にそのようにマークされているオブジェクトも、次のガベージ コレクションによってマークされる予定のオブジェクトも同様に扱われます。 "終了準備完了" リストに含まれるオブジェクトは、既にルートがなくなっているファイナライズ可能なオブジェクトです。 このオプションは、ファイナライズ可能なキューに含まれるすべてのオブジェクトにまだルートがあるかどうかを検証するため、非常に負荷がかかる場合があります。<br /><br /> `-short` オプションは、各オブジェクトのアドレスに出力を制限します。 組み合わせて使用されている場合**- シンボル**、すべてのオブジェクトをファイナライザーを持つルートがなくなっているを列挙します。 単独で使用した場合は、ファイナライズ可能な状態で "終了準備完了" キューに含まれるすべてのオブジェクトが一覧表示されます。|  
+|**FindAppDomain** \<*オブジェクトのアドレス*>|指定したアドレスにあるオブジェクトのアプリケーション ドメインを確認します。|  
+|**FindRoots** **-gen** \<*N*> |**-gen any** |*オブジェクトのアドレス*>|指定したジェネレーションの次のコレクションでデバッガーがデバッグ対象を中断するようにします。 中断が発生すると、このオプションの効果はすぐにリセットされます。 次のコレクションで中断するには、コマンドを再度実行する必要があります。 * <object></object> \> *による中断後にこのコマンドの形式を使用、 **-gen**または**のいずれかの gen**が発生しました。 その時点で、デバッグ対象がの適切な状態では**FindRoots**から現在のオブジェクトのルートを識別するために、世代を無効です。|  
+|**GCHandles** [**- perdomain**]|プロセス内のガベージ コレクター ハンドルに関する統計を表示します。<br /><br /> **- Perdomain**オプションは、アプリケーション ドメインによる統計情報を配置します。<br /><br /> 使用して、 **GCHandles**ガベージ コレクター ハンドルのリークによって発生するメモリ リークを検索するコマンドです。 たとえば、厳密なガベージ コレクター ハンドルが大きな配列を指しているためコードがその配列を保持したままになっているときに、その配列を解放せずにハンドルを破棄すると、メモリ リークが発生します。|  
+|**GCHandleLeaks**|プロセスの強力なガベージ コレクター ハンドルおよび固定されたガベージ コレクター ハンドルへの参照についてメモリ内を検索し、結果を表示します。 ハンドルが見つかった場合、 **GCHandleLeaks**コマンドの参照のアドレスを表示します。 メモリ内にハンドルが見つからない場合、このコマンドは通知を表示します。|  
+|**GCInfo** \<*MethodDesc アドレス*>\<*コード アドレス*>|レジスタまたはスタックの場所にマネージ オブジェクトが格納された時期を示すデータを表示します。 ガベージ コレクションを実行する場合は、コレクターはオブジェクトに対する参照の場所を把握しておく必要があります。その結果、新しいオブジェクト ポインターの値を使用して参照を更新できます。|  
+|**GCRoot** [**- nostacks**]*オブジェクトのアドレス*>|指定したアドレスにあるオブジェクトへの参照 (またはルート) に関する情報を表示します。<br /><br /> **GCRoot**とハンドル テーブル内にあるその他のハンドルがオブジェクトおよびスタックの処理コマンドは、マネージ ヒープ全体を調べます。 次に、オブジェクトへのポインターについて各スタックを検索し、さらにファイナライザー キューも検索します。<br /><br /> このコマンドは、スタック ルートが有効かまたは破棄されているかどうかを確認しません。 使用して、 **CLRStack**と**U**スタック ルートが使用中でかどうかを判断するためにローカルまたは引数の値が属するフレームを逆アセンブルするコマンドです。<br /><br /> **- Nostacks**オプションのみをガベージ コレクター ハンドルおよび到達可能なオブジェクトを検索します。|  
+|**GCWhere**  *<object></object>\>*|渡された引数のガベージ コレクション ヒープ内での位置とサイズを表示します。 引数がマネージ ヒープ内にあっても、有効なオブジェクト アドレスではない場合は、サイズは 0 (ゼロ) と表示されます。|  
+|**help** [*command*>] [`faq`]|パラメーターを指定しない場合は、使用できるすべてのコマンドを表示します。パラメーターとしてコマンドを指定した場合は、そのコマンドに関する詳細なヘルプを表示します。<br /><br /> `faq` パラメーターを指定すると、よく寄せられる質問に対する回答が表示されます。|  
+|**HeapStat** [**- inclUnrooted** |**-iu**]|各ヒープのジェネレーション サイズ、および各ヒープの各ジェネレーションでの合計空き領域を表示します。 場合は、**inclUnrooted**オプションを指定すると、レポートには、既にルートがないガベージ コレクション ヒープからマネージ オブジェクトに関する情報が含まれます。|  
+|**HistClear**|`Hist` コマンドのファミリによって使用されているすべてのリソースを解放します。<br /><br /> 通常は、`HistClear` を明示的に呼び出す必要はありません。各 `HistInit` が前のリソースをクリーンアップします。|  
+|**HistInit**|デバッグ対象に保存されているストレス ログから SOS 構造体を初期化します。|  
+|**HistObj***<obj_address>*</obj_address>|すべてのストレス ログ再配置レコードを調べて、引数として渡されたアドレスになった可能性のあるガベージ コレクション再配置のチェーンを表示します。|  
+|**HistObjFind**  *<obj_address>*</obj_address>|指定したアドレスにあるオブジェクトを参照するすべてのログ エントリを表示します。|  
+|**HistRoot***<>\>*|指定したルートの上位変換と再配置の両方に関係する情報を表示します。<br /><br /> ルートの値を使用すると、ガベージ コレクション内でのオブジェクトの移動を追跡できます。|  
+|**IP2MD** \<*コード アドレス*>|JIT コンパイルされたコード内の指定したアドレスにある `MethodDesc` 構造体を表示します。|  
+|`ListNearObj`(`lno`)*<obj_address>*</obj_address>|指定したアドレスの前および後にあるオブジェクトを表示します。 このコマンドは、マネージ オブジェクトの開始時に (有効メソッド テーブルに基づいて) 有効であると考えられるガベージ コレクション ヒープ内のアドレス、および引数アドレスの後のオブジェクトを検索します。|  
+|**MinidumpMode** [**0**] [**1**]|ミニダンプを使用するときに安全でないコマンドが実行されるのを防止します。<br /><br /> 渡す**0**この機能を無効にするか、 **1**この機能を有効にします。 既定では、 **MinidumpMode**に値が設定されている**0**です。<br /><br /> ミニダンプが作成された、 **.dump/m**コマンドまたは**.dump**コマンドは、CLR に固有のデータに制限され、正しく SOS コマンドのサブセットのみを実行することです。 一部のコマンドはメモリの必要領域が割り当てられていないか一部分しか割り当てられていないため、予期しないエラーが発生して失敗することがあります。 このオプションは、ミニダンプに対して安全でないコマンドが実行されるのを防止します。|  
+|**Name2EE** \<*モジュール名*>*型またはジェネリック メソッドの名前*><br /><br /> または<br /><br /> **Name2EE** \<*module name*>**!**\<*型またはジェネリック メソッドの名前*>|指定したモジュール内の指定した型またはメソッドの `MethodTable` 構造体および `EEClass` 構造体を表示します。<br /><br /> 指定したモジュールをプロセスに読み込む必要があります。<br /><br /> 適切な型名を取得するを使用して、モジュールを参照、 [Ildasm.exe (IL 逆アセンブラー)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)します。 また、`*` を module name パラメーターとして渡すと、読み込まれているすべてのマネージ モジュールを検索できます。 *モジュール名*パラメーターもできるモジュールの場合、デバッガーの名前など`mscorlib`または`image00400000`です。<br /><br /> このコマンドは、Windows のデバッガー構文をサポートしている`module` > `!` < `type`> します。 型は、完全修飾する必要があります。|  
+|**ObjSize** [*オブジェクトのアドレス*>] |[**-aggregate**] [**-stat**]|指定したオブジェクトのサイズを表示します。 すべてのパラメーターが指定されていない場合、 **ObjSize**のコマンドは、マネージ スレッドで見つかったすべてのオブジェクトのサイズを表示、プロセスでは、すべてのガベージ コレクター ハンドルを表示し、それらのハンドルが指すオブジェクトのサイズの合計です。 **ObjSize**コマンドにはだけでなく、親のすべての子オブジェクトのサイズが含まれています。<br /><br /> **-集計**オプションを組み合わせて使用できる、 **-stat**まだルートがある種類の詳細なビューを取得する引数。 使用して**! dumpheap-stat**と**! objsize-集計 - stat**、どのオブジェクトがルートがなくなってとさまざまなメモリの問題の診断を指定できます。|  
+|**PrintException** [**-入れ子になった**] [**-行**] [*例外オブジェクトのアドレス*>]<br /><br /> または<br /><br /> **PE** [**-入れ子になった**] [*例外オブジェクトのアドレス*>]|表示およびから派生したオブジェクトのフィールドを書式設定、<xref:System.Exception>クラスは、指定したアドレスです。 アドレスが指定されていない場合、 **PrintException**コマンドには、現在のスレッド上でスローされた最後の例外が表示されます。<br /><br /> **-入れ子になった**オプションには、入れ子になった例外オブジェクトに関する詳細が表示されます。<br /><br /> **-行**オプションは、使用可能な場合に、ソース情報を表示します。<br /><br /> このコマンドを使用すると、バイナリ配列の `_stackTrace` フィールドを書式設定して表示できます。|  
+|**ProcInfo** [**-env**] [**-time**] [**-mem**]|プロセスの環境変数、カーネル CPU 時間、およびメモリ使用率統計を表示します。|  
+|**RCWCleanupList** \<*RCWCleanupList アドレス*>|指定したアドレスにあり、クリーンアップを待っているランタイム呼び出し可能ラッパーの一覧を表示します。|  
+|**SaveModule** \<*ベース アドレス*>*ファイル名*>|メモリ内の指定したアドレスに読み込まれているイメージを、指定したファイルに書き込みます。|  
+|**SOSFlush**|内部 SOS キャッシュをフラッシュします。|  
+|**StopOnException** [**-派生**] [**-作成**|**-create2**]*例外*>*擬似レジスタの数*>|指定した例外がスローされたときにデバッガーを停止しますが、それ以外の例外がスローされたときは実行を続行します。<br /><br /> **-派生**オプションは、指定した例外および指定された例外から派生したすべての例外をキャッチします。|  
+|**SyncBlk** [**-all** |*syncblk 数*>]|指定した `SyncBlock` 構造体またはすべての `SyncBlock` 構造体を表示します。  任意の引数を渡さない場合、 **SyncBlk**コマンドの表示、`SyncBlock`スレッドによって所有されているオブジェクトに対応する構造体。<br /><br /> `SyncBlock` 構造体は、オブジェクトによっては作成する必要のないこともある追加情報のコンテナーです。 この構造体は、COM 相互運用機能データ、ハッシュ コード、およびスレッド セーフ操作用のロック情報を保持できます。|  
+|**スレッド プール**|キュー内の作業要求の数、完了ポート スレッドの数、タイマーの数を含め、マネージ スレッド プールに関する情報を表示します。|  
+|**Token2EE** \<*モジュール名*>*トークン*>|指定したモジュール内の指定したメタデータ トークンを `MethodTable` 構造体または `MethodDesc` 構造体に変換します。<br /><br /> module name パラメーターに `*` を渡すと、読み込まれているすべてのマネージ モジュール内にあるそのトークンの割り当て先を検索できます。 また、デバッガーの `mscorlib`、`image00400000` などのモジュール名を渡すこともできます。|  
+|**Threads** [**-live**] [**-special**]|プロセス内のすべてのマネージ スレッドを表示します。<br /><br /> **スレッド**コマンドは、デバッガーの短縮 ID、共通言語ランタイムのスレッド ID、およびオペレーティング システム スレッド ID を表示します。  さらに、**スレッド**コマンドには、ドメイン列、スレッドを実行しているアプリケーション ドメインを示す、COM アパートメント モードが表示される APT 列およびスレッドで最後にスローされる例外を表示する例外列が表示されます。<br /><br /> **-Live**オプション、ライブ スレッドに関連付けられているスレッドを表示します。<br /><br /> **-特殊な**オプションは、CLR で作成されたすべての特殊なスレッドを表示します。 特殊なスレッドには、ガベージ コレクション スレッド (同時実行とサーバーのガベージ コレクション) では、デバッガー ヘルパー スレッド、ファイナライザー スレッド、 <xref:System.AppDomain>アンロード スレッド、およびスレッド プール タイマー スレッドです。|  
+|**ThreadState ** *状態値フィールド***>**|スレッドの状態を表示します。 `value`パラメーターは、の値、`State`フィールドに、**スレッド**レポート出力します。<br /><br /> 例:<br /><br /> `0:003> !Threads     ThreadCount:      2     UnstartedThread:  0     BackgroundThread: 1     PendingThread:    0     DeadThread:       0     Hosted Runtime:   no                                           PreEmptive   GC Alloc           Lock            ID OSID ThreadOBJ    State     GC       Context       Domain   Count APT Exception        0    1  250 0019b068      a020 Disabled 02349668:02349fe8 0015def0     0 MTA        2    2  944 001a6020      b220 Enabled  00000000:00000000 0015def0     0 MTA (Finalizer)     0:003> !ThreadState b220         Legal to Join         Background         CLR Owns         CoInitialized         In Multi Threaded Apartment`|  
+|**TraverseHeap** [**xml**]*ファイル名*>|ヒープ情報を、CLR プロファイラーが処理できる形式で指定したファイルに書き込みます。 **Xml**オプションにより、 **TraverseHeap**コマンド ファイルを XML としての書式を設定します。<br /><br /> CLR プロファイラーをダウンロードすることができます、 [Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkID=67325)します。|  
+|**U** [**-gcinfo**] [**-ehinfo**] [**-n**] *MethodDesc address*> |*コード アドレス*>|メソッドの `MethodDesc` 構造体ポインターまたはメソッド本体のコード アドレスで指定したマネージ メソッドの注釈付き逆アセンブリを表示します。 **U**コマンドは、最初から最後まで、メタデータ トークン名を変換する注釈付きメソッド全体を表示します。<br /><br /> **- Gcinfo**オプションにより、 **U**コマンドを表示する、`GCInfo`メソッドの構造体。<br /><br /> **- Ehinfo**オプションは、メソッドの例外情報を表示します。 この情報を取得することも、 **EHInfo**コマンドです。<br /><br /> **-N**オプションは、ソース ファイル名と行番号の表示を無効になります。 デバッガーで SYMOPT_LOAD_LINES オプションが指定されている場合、SOS はすべてのマネージ フレームでシンボルを検索し、成功した場合は、対応するソース ファイル名と行番号を表示します。 指定できます、 **-n**この動作を無効にすることです。|  
+|**VerifyHeap**|ガベージ コレクター ヒープの破損の兆候をチェックし、検出されたすべてのエラーを表示します。<br /><br /> ヒープが正しく構築されていない場合、プラットフォームが呼び出しを実行したことが原因で、ヒープが破損する可能性があります。|  
+|**VerifyObj** \<*オブジェクトのアドレス*>|引数として渡されたオブジェクトで破損の兆候を調べます。|  
+|**VMMap**|仮想アドレス空間を走査し、各領域に適用されている保護方法の種類を表示します。|  
+|**VMStat**|仮想アドレス空間の概要を、そのメモリに適用されている保護方法の種類 (保護なし、予約済み、コミット、プライベート、割り当て済み、イメージ) の順に表示します。 AVERAGE 列に BLK COUNT 列を掛けた結果が TOTAL 列に表示されます。|  
+  
+## <a name="remarks"></a>コメント  
+ SOS デバッガー拡張を使用すると、共通言語ランタイム内部で実行しているコードに関する情報を表示できます。 たとえば、SOS デバッガー拡張を使用して、マネージ ヒープに関する情報の表示、ヒープ破損の検索、ランタイムが使用している内部データ型の表示、およびランタイム内部で実行しているすべてのマネージ コードに関する情報の表示を行うことができます。  
+  
+ Visual Studio で SOS デバッガー拡張を使用するインストール、 [Windows Driver Kit (WDK)](http://msdn.microsoft.com/windows/hardware/hh852362)します。 Visual Studio の統合デバッグ環境については、次を参照してください。[デバッグ環境](http://msdn.microsoft.com/library/windows/hardware/hh406268.aspx)Windows デベロッパー センターにします。  
+  
+ 利用できる WinDbg.exe デバッガーに読み込むことによって、SOS デバッガー拡張を使用することも、 [WDK および開発者用ツールの Web サイト](http://go.microsoft.com/fwlink/?LinkId=103787)WinDbg.exe でコマンドを実行するとします。  
+  
+ WinDbg.exe デバッガーに SOS デバッガー拡張を読み込むには、ツールで次のコマンドを実行します。  
+  
+```  
+.loadby sos clr  
+```  
+  
+ WinDbg.exe と Visual Studio は、現在使用している Mscorwks.dll のバージョンに対応する SOS.dll のバージョンを使用します。 .NET Framework の Version 1.1 および 2.0 では、SOS.dll は Mscorwks.dll と同じディレクトリにインストールされます。 既定では、Mscorwks.dll の現在のバージョンに一致する SOS.dll のバージョンを使用することになります。  
+  
+ 別のコンピューターで作成されたダンプ ファイルを使用するには、そのインストールに付属していた Mscorwks.dll ファイルが現在のコンピューターのシンボル パスにあることを確認し、対応するバージョンの SOS.dll を読み込みます。  
+  
+ 特定のバージョンの SOS.dll を読み込むには、Windows デバッガーに次のコマンドを入力します。  
+  
+```  
+.load <full path to sos.dll>  
+```  
+  
+## <a name="examples"></a>例  
+ 次のコマンドは、アドレス `00ad28d0` にある配列の内容を表示します。  2 番目の要素およびそれ以降にある合計&5; つの要素が表示されます。  
+  
+```  
+!dumparray -start 2 -length 5 -detail 00ad28d0   
+```  
+  
+ 次のコマンドは、アドレス `1ca248` にあるアセンブリの内容を表示します。  
+  
+```  
+!dumpassembly 1ca248  
+```  
+  
+ 次のコマンドは、ガベージ コレクター ヒープに関する情報を表示します。  
+  
+```  
+!dumpheap  
+```  
+  
+ 次のコマンドは、メモリ内ストレス ログの内容を、現在のディレクトリ内にある StressLog.txt という名前の (既定の) ファイルに書き込みます。  
+  
+```  
+!DumpLog  
+```  
+  
+ 次のコマンドは、アドレス `MethodDesc` にある `902f40` 構造体を表示します。  
+  
+```  
+!dumpmd 902f40  
+```  
+  
+ 次のコマンドは、アドレス `1caa50` にあるモジュールに関する情報を表示します。  
+  
+```  
+!dumpmodule 1caa50  
+```  
+  
+ 次のコマンドは、アドレス `a79d40` にあるオブジェクトに関する情報を表示します。  
+  
+```  
+!DumpObj a79d40  
+```  
+  
+ 次のコマンドは、アドレス `00a79d9c` にあるメソッド テーブルを使用して、アドレス `0090320c` にある値クラスのフィールドを表示します。  
+  
+```  
+!DumpVC 0090320c 00a79d9c  
+```  
+  
+ 次のコマンドは、ガベージ コレクターによって使用されるプロセス メモリを表示します。  
+  
+```  
+!eeheap -gc  
+```  
+  
+ 次のコマンドは、完了の目的でスケジュールされているすべてのオブジェクトを表示します。  
+  
+```  
+!finalizequeue  
+```  
+  
+ 次のコマンドは、アドレス `00a79d98` にあるオブジェクトのアプリケーション ドメインを確認します。  
+  
+```  
+!findappdomain 00a79d98  
+```  
+  
+ 次のコマンドは、現在のプロセス内のすべてのガベージ コレクター ハンドルを表示します。  
+  
+```  
+!gcinfo 5b68dbb8   
+```  
+  
+ 次のコマンドは、`MethodTable` モジュールにある `EEClass` クラスの `Main` メソッドの `MainClass` 構造体および `unittest.exe` 構造体を表示します。  
+  
+```  
+!name2ee unittest.exe MainClass.Main  
+```  
+  
+ 次のコマンドは、`02000003` モジュールのアドレス `unittest.exe` にあるメタデータ トークンに関する情報を表示します。  
+  
+```  
+!token2ee unittest.exe 02000003  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/sqlmetal-exe-code-generation-tool.md b/docs/framework/tools/sqlmetal-exe-code-generation-tool.md
new file mode 100644
index 00000000000..f6a63067f04
--- /dev/null
+++ b/docs/framework/tools/sqlmetal-exe-code-generation-tool.md
@@ -0,0 +1,150 @@
+---
+title: "SqlMetal.exe (コード生成ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "SQLMetal [LINQ to SQL]"
+  - "コード生成ツール"
+  - "SQLMetal.exe"
+  - "LINQ to SQL, シリアル化"
+  - "LINQ to SQL, DBML ファイル"
+  - "LINQ to SQL, SQLMetal"
+ms.assetid: 819e5a96-7646-4fdb-b14b-fe31221b0614
+caps.latest.revision: 43
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 43
+---
+# SqlMetal.exe (コード生成ツール)
+SqlMetal コマンド ライン ツールは、[!INCLUDE[vbtecdlinq](../../../includes/vbtecdlinq-md.md)] の [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] コンポーネント用のコードとマッピングを生成します。 このトピックで後述するオプションを適用することにより、次のようなアクションを SqlMetal で実行できます。  
+  
+-   データベースから、ソース コードとマッピング属性またはマッピング ファイルを生成する。  
+  
+-   データベースから、カスタマイズ用の中間的なデータベース マークアップ言語 \(.dbml\) ファイルを生成する。  
+  
+-   .dbml ファイルから、コードとマッピング属性またはマッピング ファイルを生成する。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。 既定では、このファイルは `drive`:\\Program Files\\Microsoft SDKs\\Windows\\v`n.nn`\\bin にあります。 Visual Studio をインストールしない場合は、[Windows SDK](http://go.microsoft.com/fwlink/?LinkId=142225) をダウンロードすることによって SQLMetal ファイルを入手することもできます。  
+  
+> [!NOTE]
+>  Visual Studio を使用している開発者は、[!INCLUDE[vs_ordesigner_long](../../../includes/vs-ordesigner-long-md.md)] を使ってエンティティ クラスを生成することもできます。 コマンド ライン方式は、大きなデータベースにも適切に対応できます。 SqlMetal はコマンド ライン ツールであるため、ビルド プロセスでこれを使用できます。  
+  
+ このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。 詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。コマンド プロンプトで、次のように入力します。  
+  
+## 構文  
+  
+```  
+sqlmetal [options] [<input file>]  
+```  
+  
+## オプション  
+ 最新のオプションの一覧を確認するには、コマンド プロンプトでインストール場所に移動し、「`sqlmetal /?`」と入力します。  
+  
+ **接続オプション**  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/server:** *\<名前\>*|データベース サーバーの名前を指定します。|  
+|**\/database:** *\<名前\>*|サーバー上のデータベース カタログを指定します。|  
+|**\/user:** *\<名前\>*|ログオン ユーザー ID を指定します。 既定値は、Windows 認証を使用します。|  
+|**\/password:** *\<パスワード\>*|ログオン パスワードを指定します。 既定値は、Windows 認証を使用します。|  
+|**\/conn:** *\<connection string\>*|データベース接続文字列を指定します。**\/server**、**\/database**、**\/user**、または **\/password** オプションと共に使用することはできません。<br /><br /> 接続文字列にファイル名は含めないでください。 代わりに、コマンド ラインにファイル名を入力ファイルとして追加します。 たとえば、**sqlmetal \/code:"c:\\northwind.cs" \/language:csharp "c:\\northwnd.mdf"** というコマンド ラインは、入力ファイルとして "c:\\northwnd.mdf" を指定します。|  
+|**\/timeout:** *\<秒\>*|SqlMetal がデータベースにアクセスする際のタイムアウト値を指定します。 既定値は 0 \(時間制限なし\) です。|  
+  
+ **抽出オプション**  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/views**|データベース ビューを抽出します。|  
+|**\/functions**|データベース関数を抽出します。|  
+|**\/sprocs**|ストアド プロシージャを抽出します。|  
+  
+ **出力オプション**  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/dbml** *\[:file\]*|出力を .dbml として送ります。**\/map** オプションと共に使用することはできません。|  
+|**\/code** *\[:file\]*|出力をソース コードとして送ります。**\/dbml** オプションと共に使用することはできません。|  
+|**\/map** *\[:file\]*|属性ではなく XML マッピング ファイルを生成します。**\/dbml** オプションと共に使用することはできません。|  
+  
+ **その他**  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/language:** *\<language\>*|ソース コードの言語を指定します。<br /><br /> 有効な *\<language\>* は、vb と csharp です。<br /><br /> 既定値は、コード ファイル名の拡張子から派生します。|  
+|**\/namespace:** *\<名前\>*|生成されるコードの名前空間を指定します。 既定値は、名前空間なしです。|  
+|**\/context:** *\<type\>*|データ コンテキスト クラスの名前を指定します。 既定値は、データベース名から派生します。|  
+|**\/entitybase:** *\<type\>*|生成されるコード内のエンティティ クラスの基本クラスを指定します。 既定値は、エンティティの基本クラスなしです。|  
+|**\/pluralize**|クラスとメンバーの名前を自動的に複数化または単数化します。<br /><br /> このオプションは、米国英語バージョンでのみ使用できます。|  
+|**\/serialization:** *\<option\>*|シリアル化可能なクラスを生成します。<br /><br /> 有効な *\<option\>* は、None と Unidirectional です。 既定値は None です。<br /><br /> 詳細については、「[Serialization](../../../docs/framework/data/adonet/sql/linq/serialization.md)」を参照してください。|  
+  
+ **入力ファイル**  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\<入力ファイル\>**|SQL Server Express .mdf ファイル、[!INCLUDE[ssEW](../../../includes/ssew-md.md)] .sdf ファイル、または .dbml 中間ファイルを指定します。|  
+  
+## 解説  
+ SqlMetal の実際の機能には、次の 2 つの段階が含まれています。  
+  
+-   データベースのメタデータを .dbml ファイルに抽出する。  
+  
+-   コード出力ファイルを生成する。  
+  
+     適切なコマンド ライン オプションを使用することで、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または C\# ソース コードを生成するか、XML マッピング ファイルを生成できます。  
+  
+ メタデータを .mdf ファイルから抽出するには、他のすべてのオプションの後に .mdf ファイルの名前を指定する必要があります。  
+  
+ **\/server** を指定しない場合、**localhost\/sqlexpress** と見なされます。  
+  
+ 次の条件が少なくとも 1 つ満たされる場合、[!INCLUDE[sqprsqext](../../../includes/sqprsqext-md.md)] は例外をスローします。  
+  
+-   自身を呼び出すストアド プロシージャを SqlMetal が抽出しようとした。  
+  
+-   ストアド プロシージャ、関数、またはビューの入れ子レベルが 32 を超える。  
+  
+     SqlMetal はこの例外をキャッチして、それを警告として報告します。  
+  
+ 入力ファイル名を指定するには、その名前をコマンド ラインに入力ファイルとして追加します。 \(**\/conn** オプションを使用して\) 接続文字列にファイル名を含める操作は、サポートされていません。  
+  
+## 例  
+ 抽出された SQL メタデータを格納する .dbml ファイルを生成します。  
+  
+ **sqlmetal \/server:myserver \/database:northwind \/dbml:mymeta.dbml**  
+  
+ SQL Server Express を使用して .mdf ファイルから抽出された SQL メタデータを格納する .dbml ファイルを生成します。  
+  
+ **sqlmetal \/dbml:mymeta.dbml mydbfile.mdf**  
+  
+ SQL Server Express から抽出された SQL メタデータを格納する .dbml ファイルを生成します。  
+  
+ **sqlmetal \/server:.\\sqlexpress \/dbml:mymeta.dbml \/database:northwind**  
+  
+ .dbml メタデータ ファイルからソース コードを生成します。  
+  
+ **sqlmetal \/namespace:nwind \/code:nwind.cs \/language:csharp mymetal.dbml**  
+  
+ SQL メタデータからソース コードを直接生成します。  
+  
+ **sqlmetal \/server:myserver \/database:northwind \/namespace:nwind \/code:nwind.cs \/language:csharp**  
+  
+> [!NOTE]
+>  サンプル データベース Northwind で **\/pluralize** オプションを使用する場合には、注意を必要とする動作があります。 SqlMetal がテーブルのために行型の名前を生成するとき、テーブル名は単数形です。 テーブルに関する <xref:System.Data.Linq.DataContext> プロパティを生成するときには、テーブル名は複数形です。 偶然にも、サンプル データベース Northwind 内のテーブルには既に複数形が使われています。 このため、この部分はうまく機能しません。 データベース テーブルの名前は単数形にするのが一般的ですが、.NET では、コレクションの名前を複数形にすることも一般的です。  
+  
+## 参照  
+ [How to: Generate the Object Model in Visual Basic or C\#](../../../docs/framework/data/adonet/sql/linq/how-to-generate-the-object-model-in-visual-basic-or-csharp.md)   
+ [Code Generation in LINQ to SQL](../../../docs/framework/data/adonet/sql/linq/code-generation-in-linq-to-sql.md)   
+ [External Mapping](../../../docs/framework/data/adonet/sql/linq/external-mapping.md)
\ No newline at end of file
diff --git a/docs/framework/tools/storeadm-exe-isolated-storage-tool.md b/docs/framework/tools/storeadm-exe-isolated-storage-tool.md
new file mode 100644
index 00000000000..d2a49e3579c
--- /dev/null
+++ b/docs/framework/tools/storeadm-exe-isolated-storage-tool.md
@@ -0,0 +1,77 @@
+---
+title: "Storeadm.exe (分離ストレージ ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "分離ストレージ ツール"
+  - "一覧 (現在のユーザーのストアの)"
+  - "削除 (ストアを)"
+  - "Storeadm.exe"
+  - "ストア, 現在のユーザー"
+ms.assetid: b81202b8-d91d-4b23-9c53-4a112f74a44a
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Storeadm.exe (分離ストレージ ツール)
+分離ストレージ ツールは、現在のユーザーに関するすべての既存ストアの一覧表示または削除を行います。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+storeadm [/list][/machine][/remove][/roaming][/quiet]  
+```  
+  
+#### パラメーター  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/h**\[**elp**\]|このツールのコマンド構文とオプションを表示します。|  
+|**\/list**|現在のユーザーに関するすべての既存ストアを表示します。  このユーザーによって実行された、すべてのアプリケーションまたはアセンブリに関するストアなどが表示されます。|  
+|**\/machine**|コンピューター ストアを選択します。  アクションをコンピューター ストアに適用する場合は、このオプションを **\/list** オプションまたは **\/remove** オプションと共に使用します。<br /><br /> .NET Framework 2.0 で新たに追加されました。|  
+|**\/quiet**|クワイエット モードを指定します。このモードでは、情報の出力が中止され、エラー メッセージだけが表示されます。|  
+|**\/remove**|現在のユーザーに関するすべての既存ストアを削除します。|  
+|**\/roaming**|ローミング ストアを選択します。  このオプションを **\/list** または **\/remove** オプションと一緒に使用すると、それらのアクションをローミング ストアに適用する必要があることを指定できます。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ オプションを指定せずにコマンド ラインから Storeadm.exe を実行すると、Storeadm.exe に関する構文とオプションが表示されます。  
+  
+ 一般に、**\/list** オプションと **\/remove** オプションは同時に使用されますが、2 つ以上のオプションを指定した場合、それらのオプションはコマンド ラインに表示されている順序で実行されます。  
+  
+ アプリケーションは、ユーザー ストアまたはコンピューター ストアのいずれかを選択して保存できます。  
+  
+-   ローカル ストアは、該当するユーザーに関するデータのローミングが有効な場合でも、ローミングされないことが保証されている場所 \(Windows 2000 以降\) に存在します。  
+  
+-   ローミング ストアは、ローミングできる場所に存在しますが、ローミングできるのは、Windows NT の管理機能を通じて、該当するユーザーに対してローミングが有効化されている場合に限られます。  
+  
+-   コンピューター ストアは、コンピューターのすべてのユーザーに共通で、コンピューターの共通ディレクトリに格納されます。  
+  
+    > [!NOTE]
+    >  コンピューター ストアは .NET Framework Version 2.0 で新たに追加されました。  
+  
+ ユーザーに対してローミングが実際に有効になっているかどうかは、Storeadm.exe の管理に影響を与えません。  オプションを指定せずに Storeadm.exe を実行した場合、すべてのアクションがローカル ストアに適用されます。  **\/roaming** オプションを指定した場合は、すべてのアクションが、ローミングできるストアに適用されます。  **\/machine** オプションを指定してこのツールを実行すると、すべてのアクションがコンピューター ストアに適用されます。  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/tlbexp-exe-type-library-exporter.md b/docs/framework/tools/tlbexp-exe-type-library-exporter.md
new file mode 100644
index 00000000000..935974b27af
--- /dev/null
+++ b/docs/framework/tools/tlbexp-exe-type-library-exporter.md
@@ -0,0 +1,149 @@
+---
+title: "Tlbexp.exe (タイプ ライブラリ エクスポーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "エクスポーター ツール [.NET Framework]"
+  - "エクスポート (タイプ ライブラリを) [.NET Framework]"
+  - "Tlbexp.exe"
+  - "タイプ ライブラリ [.NET Framework], エクスポート"
+  - "タイプ ライブラリ エクスポーター"
+ms.assetid: a487d61b-d166-467b-a7ca-d8b52fbff42d
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# Tlbexp.exe (タイプ ライブラリ エクスポーター)
+タイプ ライブラリ エクスポーターは、共通言語ランタイム アセンブリで定義されている型を記述するタイプ ライブラリを生成します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+tlbexp assemblyName [options]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*assemblyName*|タイプ ライブラリをエクスポートする対象のアセンブリ。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/asmpath:** *directory*|アセンブリを検索する場所を指定します。  このオプションを使用する場合は、現在のディレクトリを含め、参照アセンブリの検索場所を明示的に指定する必要があります。<br /><br /> **asmpath** オプションを使用すると、タイプ ライブラリ エクスポーターは、グローバル アセンブリ キャッシュ \(GAC\) 内のアセンブリを検索しません。|  
+|**\/help**|このツールのコマンド構文とオプションを表示します。|  
+|**\/names:** *filename*|タイプ ライブラリにおける大文字の使用スタイルを指定します。  *filename* 引数はテキスト ファイルです。  このファイルには、タイプ ライブラリ内の名前に対する大文字の使用スタイルを 1 行に 1 つずつ指定します。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/oldnames**|型名が競合している場合は、Tlbexp.exe は装飾された型名をエクスポートします。  バージョン 2.0 より以前の .NET Framework では、これが既定の動作であることに注意してください。|  
+|**\/out:** *file*|生成するタイプ ライブラリ ファイルの名前を指定します。  このオプションを省略した場合、アセンブリ名に拡張子 .tlb を付加した名前のタイプ ライブラリが生成されます。このアセンブリ名は実際のアセンブリ名ですが、アセンブリを含むファイルの名前と必ずしも同じである必要はありません。|  
+|**\/silence:** `warningnumber`|指定された警告を表示しません。  このオプションは、**\/silent** オプションと共に使用することはできません。|  
+|**\/silent**|成功メッセージを表示しません。  このオプションは、**\/silence** オプションと共に使用することはできません。|  
+|**\/tlbreference:** *typelibraryname*|Tlbexp.exe はレジストリを参照せずに、タイプ ライブラリの参照を明示的に解決します。  たとえば、アセンブリ B がアセンブリ A を参照する場合は、レジストリで指定されているタイプ ライブラリを参照するのではなく、このオプションを使用してタイプ ライブラリの参照を明示的に指定できます。  Tlbexp.exe はバージョン チェックを実行して、タイプ ライブラリとアセンブリのバージョンが同じであることを確認します。バージョンが異なる場合は、エラーを生成します。<br /><br /> **tlbreference** オプションを指定しても、<xref:System.Runtime.InteropServices.ComImportAttribute> 属性の適用先のインターフェイスが別の型に実装される場合には、レジストリが参照されます。|  
+|**\/tlbrefpath:** *path*|参照タイプ ライブラリの絶対パス。|  
+|**\/win32**|このオプションを指定すると、64 ビットのコンピューターでコンパイルする場合、Tlbexp.exe は 32 ビットのタイプ ライブラリを生成します。|  
+|**\/win64**|このオプションを指定すると、32 ビットのコンピューターでコンパイルする場合、Tlbexp.exe は 64 ビットのタイプ ライブラリを生成します。|  
+|**\/verbose**|詳細出力モードを指定します。このモードでは、タイプ ライブラリを生成する必要のある参照先アセンブリがある場合は、その一覧を表示します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+> [!NOTE]
+>  Tlbexp.exe のコマンド ライン オプションでは、大文字と小文字が区別されません。また、これらのオプションは任意の順序で指定できます。  オプションを一意に識別するために十分である場合は、オプションの一部を指定するだけでもかまいません。  たとえば、**\/n** を指定した場合は **\/nologo**、**\/o:** *outfile.tlb*  と指定した場合は **\/out:** *outfile.tlb* であると見なされます。  
+  
+## 解説  
+ Tlbexp.exe は、アセンブリで定義されている型の定義を含む、タイプ ライブラリを生成します。  Visual Basic 6.0 などのアプリケーションは、このツールで生成されたタイプ ライブラリを使用して、アセンブリ内で定義されている .NET 型にバインドできます。  
+  
+> [!IMPORTANT]
+>  Tlbexp.exe を使用して Windows メタデータ \(.winmd\) ファイルをエクスポートすることはできません。  Windows ランタイム アセンブリのエクスポートはサポートされていません。  
+  
+ アセンブリ全体が一度に変換されます。  Tlbexp.exe を使用しても、アセンブリで定義されている型のサブセットに関する型情報は生成できません。  
+  
+ Tlbexp.exe を使用して、[タイプ ライブラリ インポーター \(Tlbimp.exe\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md) でインポートしたアセンブリからタイプ ライブラリを生成することもできません。  代わりに、Tlbimp.exe でインポートした元のタイプ ライブラリを参照する必要があります。  しかし、Tlbimp.exe でインポートしたアセンブリを参照するアセンブリから、タイプ ライブラリをエクスポートすることはできます。  後の例を参照してください。  
+  
+ Tlbexp.exe は、生成したタイプ ライブラリを現在のディレクトリ、または出力ファイルとして指定したディレクトリに格納します。  単一のアセンブリから複数のタイプ ライブラリが生成されることもあります。  
+  
+ Tlbexp.exe はタイプ ライブラリを生成しますが、生成したタイプ ライブラリの登録は行いません。  これは、タイプ ライブラリの生成と登録を両方とも行う[アセンブリ登録ツール \(Regasm.exe\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md) とは対照的です。  タイプ ライブラリを生成して COM に登録するには、Regasm.exe を使用します。  
+  
+ `/win32` オプションまたは `/win64` オプションを指定しないと、Tlbexp.exe はコンパイルを実行するコンピューターのタイプ \(32 ビット コンピューターまたは 64 ビット コンピューター\) に応じて、32 ビットまたは 64 ビットのタイプ ライブラリを生成します。  クロス コンパイルを行う場合は、32 ビット コンピューター上で `/win64` オプションを使用して 64 ビットのタイプ ライブラリを生成したり、64 ビット コンピューター上で `/win32` オプションを使用して 32 ビットのタイプ ライブラリを生成したりできます。  32 ビットのタイプ ライブラリでは、<xref:System.Runtime.InteropServices.ComTypes.SYSKIND> 値は <xref:System.Runtime.InteropServices.ComTypes.SYSKIND> に設定されます。  64 ビットのタイプ ライブラリでは、<xref:System.Runtime.InteropServices.ComTypes.SYSKIND> 値は <xref:System.Runtime.InteropServices.ComTypes.SYSKIND> に設定されます。  すべてのデータ型変換 \(たとえば、`IntPtr` や `UIntPtr` などのポインター\-サイズ データ型\) は、適切に変換されます。  
+  
+ <xref:System.Runtime.InteropServices.MarshalAsAttribute> 属性を使用して、`VT_UNKOWN` または `VT_DISPATCH` の <xref:System.Runtime.InteropServices.MarshalAsAttribute.SafeArraySubType> 値を指定すると、Tlbexp.exe は後続で使用される <xref:System.Runtime.InteropServices.MarshalAsAttribute.SafeArrayUserDefinedSubType> フィールドをすべて無視します。  たとえば、次のようなシグネチャがあるとします。  
+  
+```  
+[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_UNKNOWN, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructUnkSafe(){return null;}  
+[return:MarshalAs(UnmanagedType.SafeArray, SafeArraySubType=VarEnum.VT_DISPATCH, SafeArrayUserDefinedSubType=typeof(ConsoleKeyInfo))] public Array StructDispSafe(){return null;}  
+```  
+  
+ 次のタイプ ライブラリが生成されます。  
+  
+```  
+[id(0x60020004)]  
+HRESULT StructUnkSafe([out, retval] SAFEARRAY(IUnknown*)* pRetVal);  
+[id(0x60020005)]  
+HRESULT StructDispSafe([out, retval] SAFEARRAY(IDispatch*)* pRetVal);  
+```  
+  
+ Tlbexp.exe は <xref:System.Runtime.InteropServices.MarshalAsAttribute.SafeArrayUserDefinedSubType> フィールドを無視することに注意してください。  
+  
+ アセンブリ内にあるすべての情報をタイプ ライブラリに含めることはできないので、エクスポート プロセス中、Tlbexp.exe によって一部のデータが破棄される場合があります。  変換処理、およびタイプ ライブラリに出力される各情報のソースの識別については、「[アセンブリからタイプ ライブラリへの変換の要約](http://msdn.microsoft.com/ja-jp/3a37eefb-a76c-4000-9080-7dbbf66a4896)」を参照してください。  
+  
+ タイプ ライブラリ エクスポーターは、<xref:System.TypedReference> オブジェクトがアンマネージ コードで意味を持たない場合でも、<xref:System.TypedReference> パラメーターが `VARIANT` であるメソッドをエクスポートします。  <xref:System.TypedReference> パラメーターを持つメソッドをエクスポートしても、タイプ ライブラリ エクスポーターは警告やエラーを生成しません。作成されたタイプ ライブラリを使用するアンマネージ コードは、正しく動作しません。  
+  
+ タイプ ライブラリ エクスポーターは、Microsoft Windows 2000 以降でサポートされます。  
+  
+## 例  
+ `myTest.dll` 内で見つかったアセンブリと同じ名前を持つタイプ ライブラリを生成するコマンドを次に示します。  
+  
+```  
+tlbexp myTest.dll  
+```  
+  
+ `clipper.tlb` という名前を持つタイプ ライブラリを生成するコマンドを次に示します。  
+  
+```  
+tlbexp myTest.dll /out:clipper.tlb  
+```  
+  
+ Tlbexp.exe を使用してインポートしたアセンブリを参照するアセンブリから、Tlbimp.exe を使用してタイプ ライブラリをエクスポートする例を次に示します。  
+  
+ まず、Tlbimp.exe を使用してタイプ ライブラリ `myLib.tlb` をインポートし、`myLib.dll` として保存します。  
+  
+```  
+tlbimp myLib.tlb /out:myLib.dll  
+```  
+  
+ 上記の例で作成した `myLib.dll` を参照する `Sample.dll` を C\# コンパイラでコンパイルするコマンドを次に示します。  
+  
+```  
+CSC Sample.cs /reference:myLib.dll /out:Sample.dll  
+```  
+  
+ `myLib.dll` を参照する `Sample.dll` 用のタイプ ライブラリを生成するコマンドを次に示します。  
+  
+```  
+tlbexp Sample.dll  
+```  
+  
+## 参照  
+ <xref:System.Runtime.InteropServices.TypeLibExporterFlags>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Regasm.exe \(アセンブリ登録ツール\)](../../../docs/framework/tools/regasm-exe-assembly-registration-tool.md)   
+ [Assembly to Type Library Conversion Summary](http://msdn.microsoft.com/ja-jp/3a37eefb-a76c-4000-9080-7dbbf66a4896)   
+ [Tlbimp.exe \(タイプ ライブラリ インポーター\)](../../../docs/framework/tools/tlbimp-exe-type-library-importer.md)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/tlbimp-exe-type-library-importer.md b/docs/framework/tools/tlbimp-exe-type-library-importer.md
new file mode 100644
index 00000000000..2590051a19e
--- /dev/null
+++ b/docs/framework/tools/tlbimp-exe-type-library-importer.md
@@ -0,0 +1,148 @@
+---
+title: "Tlbimp.exe (タイプ ライブラリ インポーター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "変換 (型定義の)"
+  - "インポート (タイプ ライブラリの)"
+  - "Tlbimp.exe"
+  - "型定義変換"
+  - "タイプ ライブラリ"
+  - "タイプ ライブラリ [.NET Framework], インポート"
+  - "タイプ ライブラリ インポーター"
+ms.assetid: ec0a8d63-11b3-4acd-b398-da1e37e97382
+caps.latest.revision: 29
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# Tlbimp.exe (タイプ ライブラリ インポーター)
+タイプ ライブラリ インポーターは、COM タイプ ライブラリにある型定義を共通言語ランタイム アセンブリで等価な定義に変換します。  Tlbimp.exe の出力は、元のタイプ ライブラリで定義された型のランタイム メタデータを格納するバイナリ ファイル \(アセンブリ\) です。  このファイルは [ildasm.exe](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) などのツールでチェックできます。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+tlbimp tlbFile [options]  
+```  
+  
+#### パラメーター  
+  
+|引数|説明|  
+|--------|--------|  
+|*tlbFile*|COM タイプ ライブラリを格納する任意のファイルの名前。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/asmversion:** *versionnumber*|生成するアセンブリのバージョン番号を指定します。  *versionnumber* は *major.minor.build.revision* の形式で指定します。|  
+|**\/company:** `companyinformation`|出力アセンブリに会社情報を追加します。|  
+|**\/copyright:** `copyrightinformation`|出力アセンブリに著作権情報を追加します。  この情報は、アセンブリの **\[ファイルのプロパティ\]** ダイアログ ボックスで確認できます。|  
+|**\/delaysign**|Tlbimp.exe が遅延署名を使用して、生成されたアセンブリに厳密な名前で署名するように指定します。  このオプションは、**\/keycontainer:**、**\/keyfile:**、または **\/publickey:** のいずれかのオプションと共に指定する必要があります。  遅延署名プロセスの詳細については、「[アセンブリへの遅延署名](../../../docs/framework/app-domains/delay-sign-assembly.md)」を参照してください。|  
+|**\/help**|このツールのコマンド構文とオプションを表示します。|  
+|**\/keycontainer:** *containername*|*containername* で指定されたキー コンテナーの公開キーと秘密キーのペアを使用して、生成されたアセンブリに厳密な名前で署名します。|  
+|**\/keyfile:** *filename*|*filename* にある発行者の正式な公開キーと秘密キーのペアを使用して、生成されたアセンブリに厳密な名前で署名します。|  
+|**\/machine:** `machinetype`|指定したコンピューターの種類 \(マイクロプロセッサ\) を対象とするアセンブリを作成します。  サポートされているコンピューターの種類は、x86、x64、Itanium、および「不明」です。|  
+|**\/namespace:** *namespace*|アセンブリの生成先の名前空間を指定します。|  
+|**\/noclassmembers**|Tlbimp.exe がメンバーをクラスに追加できないようにします。  これにより、<xref:System.TypeLoadException> が発生する可能性がなくなります。|  
+|**\/nologo**|Microsoft 著作権情報を表示しません。|  
+|**\/out:** *filename*|メタデータ定義の書き込み先の出力ファイル、アセンブリ、および名前空間の名前を指定します。  アセンブリの名前空間を明示的に制御するインターフェイス定義言語 \(IDL: Interface Definition Language\) カスタム属性がタイプ ライブラリで指定されている場合、**\/out** オプションはアセンブリの名前空間を制御できません。  このオプションを指定しない場合、Tlbimp.exe は、入力ファイルで定義された実際のタイプ ライブラリと同じ名前のファイルにメタデータを書き込み、そのファイルに .dll 拡張子を割り当てます。  出力ファイルの名前が入力ファイルと同じ場合は、タイプ ライブラリが上書きされるのを防ぐためにエラーが発生します。|  
+|**\/primary**|指定したタイプ ライブラリのプライマリ相互運用機能アセンブリを生成します。  アセンブリに追加される情報は、アセンブリを生成したタイプ ライブラリの発行者を示します。  プライマリ相互運用機能アセンブリを指定すると、Tlbimp.exe を使用して、ある発行者のアセンブリとタイプ ライブラリから作成された他のアセンブリを区別します。  Tlbimp.exe を使用してインポートするタイプ ライブラリの発行者である場合は、**\/primary** オプションを使用してください。  プライマリ相互運用機能アセンブリには、[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)で署名する必要があります。  詳細については、「[プライマリ相互運用機能アセンブリ](http://msdn.microsoft.com/ja-jp/b977a8be-59a0-40a0-a806-b11ffba5c080)」を参照してください。|  
+|**\/product:** `productinformation`|出力アセンブリに製品情報を追加します。  この情報は、アセンブリの **\[ファイルのプロパティ\]** ダイアログ ボックスで確認できます。|  
+|**\/productversion:** `productversioninformation`|出力アセンブリにバージョン情報を追加します。  形式の制限はありません。  この情報は、アセンブリの **\[ファイルのプロパティ\]** ダイアログ ボックスで確認できます。|  
+|**\/publickey:** *filename*|生成されたアセンブリに署名するために使用する公開キーを格納するファイルを指定します。  **\/publickey:** オプションの代わりに **\/keyfile:** オプションまたは **\/keycontainer:** オプションを指定した場合、Tlbimp.exe は、**\/keyfile:** または **\/keycontainer:** で指定された公開キーと秘密キーのペアから公開キーを生成します。  **\/publickey:** オプションを指定すると、テスト キーと遅延署名を使用できます。  ファイルは Sn.exe で生成された形式になります。  詳細については、「[厳密名ツール \(Sn.exe\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)」にある Sn.exe の **\-p** オプションの説明を参照してください。|  
+|**\/reference:** *filename*|現在のタイプ ライブラリ以外で定義された型への参照を解決するために使用するアセンブリ ファイルを指定します。  **\/reference** オプションを指定しない場合、Tlbimp.exe は、インポートされるタイプ ライブラリが参照しているすべての外部タイプ ライブラリを再帰的に自動インポートします。  **\/reference** オプションを指定した場合、このツールは、他のタイプ ライブラリをインポートする前に、参照されたアセンブリ内の外部型を解決しようとします。|  
+|**\/silence:** `warningnumber`|指定された警告を表示しません。  このオプションは、**\/silent** オプションと共に使用することはできません。|  
+|**\/silent**|成功メッセージを表示しません。  このオプションは、**\/silence** オプションと共に使用することはできません。|  
+|**\/strictref**|ツールが現在のアセンブリ内、**\/reference** オプションで指定されたアセンブリ内、または登録されているプライマリ相互運用機能アセンブリ \(PIA\) 内のすべての参照を解決できない場合は、タイプ ライブラリをインポートしません。|  
+|**\/strictref:nopia**|**\/strictref** と同じですが、PIA を無視します。|  
+|**\/sysarray**|ツールが COM スタイル SafeArray をマネージ [System.Array クラス](frlrfSystemArrayClassTopic)型としてインポートするように指定します。|  
+|**\/tlbreference:** *filename*|レジストリを参照せずにタイプ ライブラリ参照を解決する場合に使用するタイプ ライブラリ ファイルを指定します。<br /><br /> このオプションでは、古いタイプ ライブラリの形式の一部が読み込まれないことに注意してください。ただし、古いタイプ ライブラリの形式は、レジストリまたは現在のディレクトリから暗黙的に読み込むことができます。|  
+|**\/trademark:** `trademarkinformation`|出力アセンブリに商標情報を追加します。  この情報は、アセンブリの **\[ファイルのプロパティ\]** ダイアログ ボックスで確認できます。|  
+|**\/transform:** *transformname*|*transformname* パラメーターで指定されたようにメタデータを変換します。<br /><br /> ディスパッチ専用インターフェイスに対するメソッドの \[out, retval\] パラメーターを戻り値に変換するには、*transformname* パラメーターに **dispret** を指定します。<br /><br /> このオプションの詳細については、このトピックの下記の例を参照してください。|  
+|**\/unsafe**|.NET Framework セキュリティ チェックなしでインターフェイスを生成します。  この方法で公開されているメソッドを呼び出す場合には、セキュリティ上のリスクが伴います。  このオプションは、上記に該当するコードを公開するリスクを理解した上で使用してください。|  
+|**\/verbose**|詳細モードを指定します。インポートされたタイプ ライブラリについての詳細情報を表示します。|  
+|**\/VariantBoolFieldToBool**|構造体の `VARIANT_BOOL` フィールドを <xref:System.Boolean> に変換します。|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+> [!NOTE]
+>  Tlbimp.exe のコマンド ライン オプションでは、大文字と小文字が区別されません。また、これらのオプションは任意の順序で指定できます。  オプションを一意に識別するために十分である場合は、オプションの一部を指定するだけでもかまいません。  したがって、**\/n** と指定した場合は **\/nologo**、**\/ou:** *outfile.dll* と指定した場合は **\/out:** *outfile.dll* であると見なされます。  
+  
+## 解説  
+ Tlbimp.exe は、タイプ ライブラリ全体の変換を一括して実行します。  このツールを使用しても、単一のタイプ ライブラリで定義されている型のサブセットに関する型情報は生成できません。  
+  
+ アセンブリへの[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)の割り当てを許可しておくと、さまざまな場合に役立ちます。この割り当てが必須であることもあります。  このため、Tlbimp.exe には、厳密な名前を持つアセンブリを生成するために必要な情報を提供するオプションが用意されています。  **\/keyfile:** オプションと **\/keycontainer:** オプションは、両方ともアセンブリに厳密な名前で署名します。  したがって、これらのオプションを両方同時に指定しないでください。  
+  
+ **\/reference** オプションを複数回使用すると、複数の参照アセンブリを指定できます。  
+  
+ 複数のタイプ ライブラリを格納するモジュールから 1 つのタイプ ライブラリをインポートするときに、タイプ ライブラリ ファイルにリソース ID を追加することもできます。  Tlbimp.exe は、このファイルが現在のディレクトリにあるか、ユーザーが完全パスを指定した場合にだけこのファイルを認識できます。  このトピックの下記の例を参照してください。  
+  
+## 例  
+ `myTest.tlb` 内で見つかったタイプ ライブラリと同じ名前で、.dll 拡張子を持つアセンブリを生成するコマンドを次に示します。  
+  
+```  
+tlbimp myTest.tlb   
+```  
+  
+ `myTest.dll` という名前を持つアセンブリを生成するコマンドを次に示します。  
+  
+```  
+tlbimp  myTest.tlb  /out:myTest.dll  
+```  
+  
+ `MyModule.dll\1` で指定されているタイプ ライブラリと同じ名前で、.dll 拡張子を持つアセンブリを生成するコマンドを次に示します。  `MyModule.dll\1` は現在のディレクトリ内に置かれている必要があります。  
+  
+```  
+tlbimp MyModule.dll\1  
+```  
+  
+ タイプ ライブラリ `TestLib.dll` に対して、`myTestLib.dll` という名前のアセンブリを生成するコマンドを次に示します。  **\/transform:dispret** オプションは、タイプ ライブラリのディスパッチ インターフェイスに対するメソッドの \[out, retval\] パラメーターをマネージ ライブラリの戻り値に変換します。  
+  
+```  
+tlbimp TestLib.dll /transform:dispret /out:myTestLib.dll  
+```  
+  
+ 上記の例のタイプ ライブラリ `TestLib.dll` には、void 型を返し、\[out, retval\] パラメーターを持つ、`SomeMethod` という名前のディスパッチ インターフェイス メソッドが含まれています。  `TestLib.dll` の `SomeMethod` に対する入力タイプ ライブラリ メソッド シグネチャのコードを次に示します。  
+  
+```  
+void SomeMethod([out, retval] VARIANT_BOOL*);  
+```  
+  
+ **\/transform:dispret** オプションを指定すると、Tlbimp.exe は、`SomeMethod` の `[out, retval]` パラメーターを `bool` 型の戻り値に変換します。  **\/transform:dispret** オプションを指定した場合に、Tlbimp.exe が、マネージ ライブラリ `myTestLib.dll` で `SomeMethod` に対して生成するメソッド シグネチャを次に示します。  
+  
+```csharp  
+bool SomeMethod();  
+```  
+  
+ Tlbimp.exe を使用して、**\/transform:dispret** を指定せずに `TestLib.dll` のマネージ ライブラリを生成すると、マネージ ライブラリ `myTestLib.dll` には `SomeMethod` の次のメソッド シグネチャが生成されます。  
+  
+```csharp  
+void SomeMethod(out bool x);  
+```  
+  
+## 参照  
+ [ツール](../../../docs/framework/tools/index.md)   
+ [Tlbexp.exe \(タイプ ライブラリ エクスポーター\)](../../../docs/framework/tools/tlbexp-exe-type-library-exporter.md)   
+ [タイプ ライブラリのアセンブリとしてのインポート](../../../docs/framework/interop/importing-a-type-library-as-an-assembly.md)   
+ [Type Library to Assembly Conversion Summary](http://msdn.microsoft.com/ja-jp/bf3f90c5-4770-4ab8-895c-3ba1055cc958)   
+ [Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md)   
+ [Sn.exe \(厳密名ツール\)](../../../docs/framework/tools/sn-exe-strong-name-tool.md)   
+ [厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)   
+ [Attributes for Importing Type Libraries into Interop Assemblies](http://msdn.microsoft.com/ja-jp/81e587b8-393f-43e1-9add-c4b05e65cbfd)   
+ [コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)
\ No newline at end of file
diff --git a/docs/framework/tools/winmdexp-exe-error-messages.md b/docs/framework/tools/winmdexp-exe-error-messages.md
new file mode 100644
index 00000000000..5a3669d57f3
--- /dev/null
+++ b/docs/framework/tools/winmdexp-exe-error-messages.md
@@ -0,0 +1,188 @@
+---
+title: "Winmdexp.exe のエラー メッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WME1095"
+  - "WME1110"
+  - "WME15"
+  - "WME1094"
+  - "WME1078"
+  - "WME1080"
+  - "WME1014"
+  - "WME1025"
+  - "WME1089"
+  - "WME1111"
+  - "WME1010"
+  - "WME1013"
+  - "WME1055"
+  - "WME1005"
+  - "WME1033"
+  - "WME1003"
+  - "WME1011"
+  - "WME1046"
+  - "WME0013"
+  - "WME1032"
+  - "WME1029"
+  - "WME1048"
+  - "WME1019"
+  - "WME1106"
+  - "WME0012"
+  - "WME1017"
+  - "WME1098"
+  - "WME1039"
+  - "WME20"
+  - "WME1006"
+  - "WME1088"
+  - "WME0004"
+  - "WME10"
+  - "WME12"
+  - "WME0015"
+  - "WME0017"
+  - "WME1026"
+  - "WME1045"
+  - "WME1002"
+  - "WME1051"
+  - "WME1107"
+  - "WME1100"
+  - "WME1072"
+  - "WME1090"
+  - "WME1105"
+  - "WME1022"
+  - "WME11"
+  - "WME17"
+  - "WME1063"
+  - "WME1041"
+  - "WME1057"
+  - "WME1037"
+  - "WME1007"
+  - "WME3"
+  - "WME1096"
+  - "WME0003"
+  - "WME0006"
+  - "WME1065"
+  - "WME1102"
+  - "WME1070"
+  - "WME1113"
+  - "WME1064"
+  - "WME1061"
+  - "WME1066"
+  - "WME1018"
+  - "WME1049"
+  - "WME1027"
+  - "WME1101"
+  - "WME1058"
+  - "WME0005"
+  - "WME1083"
+  - "WME1004"
+  - "WME1073"
+  - "WME1087"
+  - "WME1077"
+  - "WME19"
+  - "WME1086"
+  - "WME1085"
+  - "WME1040"
+  - "WME8"
+  - "WME1081"
+  - "WME1023"
+  - "WME4"
+  - "WME1050"
+  - "WME7"
+  - "WME1091"
+  - "WME14"
+  - "WME0007"
+  - "WME1024"
+  - "WME1012"
+  - "WME1036"
+  - "WME0010"
+  - "WME1104"
+  - "WME1035"
+  - "WME1021"
+  - "WME1075"
+  - "WME5"
+  - "WME13"
+  - "WME1074"
+  - "WME1028"
+  - "WME0014"
+  - "WME1030"
+  - "WME1008"
+  - "WME1052"
+  - "WME1079"
+  - "WME1054"
+  - "WME1093"
+  - "WME1042"
+  - "WME2"
+  - "WME1062"
+  - "WME6"
+  - "WME1001"
+  - "WME0011"
+  - "WME16"
+  - "WME0001"
+  - "WME1020"
+  - "WME1084"
+  - "WME1103"
+  - "WME1092"
+  - "WME1"
+  - "WME0002"
+  - "WME1112"
+  - "WME1016"
+  - "WME1060"
+  - "WME0008"
+  - "WME0016"
+  - "WME1097"
+  - "WME1034"
+  - "WME1108"
+  - "WME1082"
+  - "WME1099"
+  - "WME1069"
+  - "WME1031"
+  - "WME1009"
+  - "WME1068"
+  - "WME1067"
+  - "WME1059"
+  - "WME18"
+  - "WME1038"
+  - "WME0009"
+  - "WME1109"
+  - "WME1056"
+  - "WME1076"
+  - "WME1071"
+  - "WME1044"
+  - "WME1043"
+  - "WME1053"
+  - "WME1015"
+  - "WME1047"
+  - "WME9"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "エラー メッセージ, Winmdexp.exe"
+  - "Windows ランタイム メタデータのエクスポート ツール, エラー メッセージ"
+  - "Winmdexp.exe, エラー メッセージ"
+ms.assetid: 8271973c-deba-47a6-8e5e-04ce63f146ad
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# Winmdexp.exe のエラー メッセージ
+ビルド処理は [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)]で **\[[!INCLUDE[wrt](../../../includes/wrt-md.md)] Component\]** のテンプレートを使用するため、Winmdexp.exe のエラー メッセージが **\[エラー一覧\]** に表示されて [Winmdexp.exe \(Windows ランタイム メタデータのエクスポート ツール\)](../../../docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md) を呼び出します。  Winmdexp.exe は `/target:winmdobj` オプションを指定してコンパイルされたモジュールを操作します。  これが入力としてコンパイルしたモジュールが必要になるため、エラー メッセージは、コンパイルが成功した場合のみ表示されます。  
+  
+ エラー メッセージで報告されるエラー条件をアドレス指定するのに必要なすべての情報を保持するように設計されています。  ただし、一部の問題はメッセージに収まるよりも多くの情報を必要とします。  Windows デベロッパー センター [Windows ランタイム コンポーネントのエラー条件の診断](http://go.microsoft.com/fwlink/p/?LinkId=251127) の追加情報を確認できます。  
+  
+ 問題を解決するためにメッセージに十分な情報が含まれていない場合、エラーがこの記事で説明は、\/EHa フィードバック リンクをこの記事で使用し、エラー メッセージを指定します。  また、でバグを報告できます [Microsoft Connect Web サイト](http://go.microsoft.com/fwlink/p/?LinkId=251130)。  また、より多くの情報を検索できます [Microsoft のフォーラム](http://go.microsoft.com/fwlink/p/?LinkId=251129)。  
+  
+## 参照  
+ [Winmdexp.exe \(Windows ランタイム メタデータのエクスポート ツール\)](../../../docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md)   
+ [Windows ランタイム コンポーネントのエラー条件の診断](http://go.microsoft.com/fwlink/p/?LinkId=251127)
\ No newline at end of file
diff --git a/docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md b/docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md
new file mode 100644
index 00000000000..a9dc5ec81ee
--- /dev/null
+++ b/docs/framework/tools/winmdexp-exe-windows-runtime-metadata-export-tool.md
@@ -0,0 +1,68 @@
+---
+title: "Winmdexp.exe (Windows ランタイム メタデータのエクスポート ツール) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows ランタイム メタデータのエクスポート ツール"
+  - "Winmdexp.exe"
+ms.assetid: d2ce0683-343d-403e-bb8d-209186f7a19d
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Winmdexp.exe (Windows ランタイム メタデータのエクスポート ツール)
+[!INCLUDE[wrt](../../../includes/wrt-md.md)] メタデータ エクスポート ツール \(Winmdexp.exe\) は、.NET Framework モジュールを、[!INCLUDE[wrt](../../../includes/wrt-md.md)] メタデータを含むファイルに変換します。  .NET Framework アセンブリと [!INCLUDE[wrt](../../../includes/wrt-md.md)] メタデータ ファイルは同じ物理形式を使用しますが、メタデータ テーブルの内容に違いがあります。つまり、.NET Framework アセンブリは、自動的に [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントとして使用できるわけではありません。  .NET Framework モジュールを [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントにするプロセスは、*エクスポート*と呼ばれます。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] では、生成される Windows メタデータ \(.winmd\) ファイルにメタデータと実装の両方が含まれます。  
+  
+ [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] または [!INCLUDE[vs_dev11_ext](../../../includes/vs-dev11-ext-md.md)] で、C\# および Visual Basic の **\[Windows Store\]** の下にある **\[[!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネント\]** を使用する場合、コンパイラのターゲットは .winmdobj ファイルであり、後続のビルド ステップで Winmdexp.exe が呼び出され、.winmdobj ファイルが .winmd ファイルにエクスポートされます。  [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントをビルドする場合は、この方法をお勧めします。  Visual Studio による制御より細かくビルド プロセスを制御する場合は、Winmdexp.exe ファイルを直接使用します。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳細については、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」を参照してください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+  
+winmdexp [options] winmdmodule  
+```  
+  
+#### パラメーター  
+  
+|引数またはオプション|説明|  
+|----------------|--------|  
+|`winmdmodule`|エクスポートするモジュール \(.winmdobj\) を指定します。  指定できるのは 1 つのモジュールのみです。  このモジュールを作成するには、`winmdobj` ターゲットと共に `/target` コンパイラ オプションを使用します。  MSDN ライブラリの「[\/target:winmdobj \(Windows ランタイムの中間ファイルの作成\)](../Topic/-target:winmdobj%20\(C%23%20Compiler%20Options\).md)」または「[\/target](../Topic/-target%20\(Visual%20Basic\).md)」を参照してください。|  
+|`/docfile:` `docfile`<br /><br /> `/d:` `docfile`|Winmdexp.exe が生成する出力 XML ドキュメント ファイルを指定します。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、出力ファイルは基本的に入力 XML ドキュメント ファイルと同じです。|  
+|`/moduledoc:` `docfile`<br /><br /> `/md:` `docfile`|コンパイラが `winmdmodule` と共に生成した XML ドキュメント ファイルの名前を指定します。|  
+|`/modulepdb:` `symbolfile`<br /><br /> `/mp:` `symbolfile`|`winmdmodule` のシンボルを含むプログラム データベース \(PDB\) ファイルの名前を指定します。|  
+|`/nowarn:` `warning`|指定した警告番号が使用されなくなります。  *warning* の場合は、エラー コードの数字部分だけを先行ゼロなしで指定してください。|  
+|`/out:` `file`<br /><br /> `/o:` `file`|出力 Windows メタデータ \(.winmd\) ファイルの名前を指定します。|  
+|`/pdb:` `symbolfile`<br /><br /> `/p:` `symbolfile`|エクスポートされた Windows メタデータ \(.winmd\) ファイルのシンボルを含む出力プログラム データベース \(PDB\) ファイルの名前を指定します。|  
+|`/reference:` `winmd`<br /><br /> `/r:` `winmd`|エクスポート時に参照するメタデータ ファイル \(.winmd またはアセンブリ\) を指定します。  「\\Program Files \(x86\)\\Reference Assemblies\\Microsoft\\Framework\\.NETCore\\v4.5」\(32 ビット コンピューターでは「\\Program Files\\...」\) にある参照アセンブリを使用する場合は、System.Runtime.dll と mscorlib.dll の両方への参照を含めます。|  
+|`/utf8output`|UTF\-8 エンコードでメッセージが出力される必要があることを指定します。|  
+|`/warnaserror+`|すべての警告をエラーとして扱うよう指定しています。|  
+|**@** `responsefile`|オプション \(および、必要に応じて `winmdmodule`\) を含む応答 \(.rsp\) ファイルを指定します。  `responsefile` の各行に 1 つの引数またはオプションが含まれている必要があります。|  
+  
+## 解説  
+ Winmdexp.exe は、任意の .NET Framework アセンブリを .winmd ファイルに変換するようには設計されていません。  `/target:winmdobj` オプションでコンパイルされるモジュールが必要で、追加の制限が適用されます。  この中で最も重要な制限は、アセンブリの API サーフェイスで公開されるすべての型は必ず [!INCLUDE[wrt](../../../includes/wrt-md.md)] 型であるということです。  詳細については、Windows デベロッパー センターの記事「[C\# および Visual Basic での Windows ランタイム コンポーネントの作成](http://go.microsoft.com/fwlink/p/?LinkID=238313)」の「Windows ランタイム コンポーネントの宣言型」セクションを参照してください。  
+  
+ C\# または Visual Basic で [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリまたは [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントを作成する場合は、[!INCLUDE[wrt](../../../includes/wrt-md.md)] でのプログラミングをより自然にするためのサポートが .NET Framework で提供されています。  これは、記事「[Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)」で解説されています。  プロセスでは、一般的に使用される [!INCLUDE[wrt](../../../includes/wrt-md.md)] 型が .NET Framework 型にマップされます。  Winmdexp.exe は、このプロセスを反転し、対応する [!INCLUDE[wrt](../../../includes/wrt-md.md)] 型を使用する API サーフェイスを生成します。  たとえば、<xref:System.Collections.Generic.IList%601> インターフェイスから構築された型は、[!INCLUDE[wrt](../../../includes/wrt-md.md)] [IVector\<T\>](http://go.microsoft.com/fwlink/p/?LinkId=251132) インターフェイスから構築された型にマップされます。  
+  
+## 参照  
+ [Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)   
+ [Creating Windows Runtime Components in C\# and Visual Basic \(C\# および Visual Basic での Windows ランタイム コンポーネントの作成\)](http://go.microsoft.com/fwlink/p/?LinkID=238313)   
+ [Winmdexp.exe のエラー メッセージ](../../../docs/framework/tools/winmdexp-exe-error-messages.md)   
+ [Build, Deployment, and Configuration Tools \(.NET Framework\)](http://msdn.microsoft.com/ja-jp/b8c921be-6012-4181-b8d4-ab15813fc9a7)
\ No newline at end of file
diff --git a/docs/framework/tools/winres-exe-windows-forms-resource-editor.md b/docs/framework/tools/winres-exe-windows-forms-resource-editor.md
new file mode 100644
index 00000000000..b87ae31bf2a
--- /dev/null
+++ b/docs/framework/tools/winres-exe-windows-forms-resource-editor.md
@@ -0,0 +1,154 @@
+---
+title: "Winres.exe (Windows フォーム リソース エディター) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".resx ファイル"
+  - "フォーム, ローカライズ"
+  - "ローカリゼーション"
+  - "resx ファイル"
+  - "Windows フォーム リソース エディター"
+  - "Windows フォーム, ローカリゼーション"
+  - "Winres.exe"
+ms.assetid: cb8bc835-9221-4888-af53-1a4f5fad6c48
+caps.latest.revision: 23
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# Winres.exe (Windows フォーム リソース エディター)
+Windows フォーム リソース エディター \(Winres.exe\) は、ビジュアル レイアウト ツールです。ローカリゼーションの専門家は、このツールにより、Windows フォームのユーザー インターフェイス \(UI: User Interface\) で使用されるリソースをローカライズできます。  Winres.exe への入力として使用される .resx ファイルおよび .resources ファイルは、Microsoft Visual Studio などのビジュアル デザイン環境を使用して作成できます。  .NET Framework アプリケーションにおけるリソースの配置については、「[デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)」をご覧ください。  
+  
+ このツールは、Visual Studio と共に自動的にインストールされます。  このツールを実行するには、開発者コマンド プロンプト \(または、Windows 7 の Visual Studio コマンド プロンプト\) を使用します。  詳しくは、「[コマンド プロンプト](../../../docs/framework/tools/developer-command-prompt-for-vs.md)」をご覧ください。  
+  
+ コマンド プロンプトに次のように入力します。  
+  
+## 構文  
+  
+```  
+winres resourceFile   
+winres /?   
+```  
+  
+## 解説  
+  
+|引数|説明|  
+|--------|--------|  
+|`resourceFile`|ローカライズするリソース ファイル。  このファイルは Visual Studio デザイナーで作成した、Windows フォームの .resx ファイルまたは .resources ファイルである必要があります。  Winres.exe では、汎用的な .resx ファイルまたは .resources ファイルは開くことができません。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/?**|このツールのコマンド構文とオプションを表示します。|  
+  
+ Windows フォーム プロジェクトのフォームの UI 要素の状態は、通常、リソース ファイルに格納されます。リソース ファイルは、拡張子 .resx を持つ XML ベースのファイル、または、これに対応する、拡張子 .resources が設定された、コンパイル済みのバイナリ形式のファイルのいずれかです。  Winres.exe ツールでは、上記いずれかの形式のファイルを、Visual Studio のデザイン環境を使用しないで編集できますが、制限があります。  具体的には、以下の編集操作を行うことができます。  
+  
+-   ニュートラルまたは特定のカルチャ リソース ファイルを編集して、テキスト、サイズ、位置など、フォームやそのコントロールの UI プロパティを変更できます。  
+  
+-   ニュートラルまたは特定のカルチャのリソース ファイルを、既定のリソース ファイルから作成できます。  
+  
+-   カルチャ リソース ファイルを別のカルチャのリソース ファイルとして保存できます。  たとえば、英語 \(U.S.\) のリソース ファイルを、ポーランド語のリソース ファイルとして保存できます。  通常は、新しいファイルを引き続き編集して、新しいカルチャに対応させます。  
+  
+ さらに、「[ローカリゼーション用リソースの階層編成](http://msdn.microsoft.com/library/756hydy4\(v=vs.110\))」または「[ローカリゼーション用リソースの階層編成](http://msdn.microsoft.com/library/756hydy4\(v=vs.120\))」もご覧ください。  
+  
+ Winres.exe では、対応する .resources ファイルに .resx ファイルを変換できません。この場合は Resgen.exe ツールを使用してください。  Resgen.exe について詳しくは、「[Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)」をご覧ください。  
+  
+ Winres.exe はグラフィカル アプリケーションであり、ソース コードにアクセスすることなく、リソース ファイルだけを使用して、Windows フォームのデザイン時バージョンを再作成できます。  Winres.exe は、Visual Studio の Windows フォーム デザイナーおよび \[プロパティ\] ウィンドウを管理します。  この機能を使用すると、Windows フォームが含まれている .resources ファイルや .resx ファイルをビジュアル編集できます。  Winres.exe でのローカライズでは、通常、コントロールのラベルを編集し、ターゲット カルチャに合わせてローカライズしたラベルが納まるようにコントロールの位置とサイズを調整できます。  
+  
+ Winres.exe がコントロールの型を解決できない場合、ローカライズされた .resx ファイルまたは .resources ファイルには、プレースホルダー コントロールが作成されます。  このプレースホルダー コントロールは、Windows フォーム上にハッチ ウィンドウとして表示されます。  このハッチ ウィンドウのサイズおよび位置は、実際のコントロールのサイズおよび位置と一致します。  プレースホルダー コントロールのプロパティでローカライズできるプロパティは、すべて \[プロパティ\] ウィンドウに表示されます。  プレースホルダー コントロールに対して行ったすべての変更内容が、実際のコントロールに保存されます。  
+  
+## Winres.exe と Visual Studio の比較  
+ 通常、アプリケーションの Windows フォームのローカライズを開始する前に、ローカリゼーション ツールとして Visual Studio と Winres.exe のどちらを使用するのかを決定する必要があります。  この後で説明するバージョンの互換性の問題が原因で、途中でツールを切り替えることができない場合があるためです。  
+  
+ Visual Studio の利点は、アプリケーションの開発にもローカライズにも使用できる点です。  フォームをローカライズするには、開発を完了してから、プロパティ エディターの <xref:System.ComponentModel.LocalizableAttribute>Localizable プロパティでフォームの を `true` に設定し、**Language** プロパティを目的のカルチャに変更します。  次に、文字列を編集し、ターゲット カルチャに合わせて変更した文字列が納まるようにコントロールの位置およびサイズを調整します。  ローカライズ済み .resx file を保存するときに、Visual Studio は、ローカライズ可能なプロパティ \(ターゲット カルチャで変更したプロパティ\) だけをファイルに書き込みます。  Visual Studio は、ローカライズ済み .resx ファイル用のサテライト アセンブリを正しいディレクトリ位置に自動的に作成します。  さらに、「[チュートリアル : Windows フォームのローカリゼーション](http://msdn.microsoft.com/library/y99d1cd3\(v=vs.110\))」もご覧ください。  
+  
+ Visual Studio は、開発およびローカリゼーション用の統合環境を提供しますが、ローカリゼーションがサードパーティのローカライザーによって行われる場合には Winres.exe をツールとして使用することを推奨します。  Winres.exe はローカリゼーション専用のツールであるため、アプリケーションのコードとローカライズ対象のフォームを明確に分離でき、大規模なプロジェクトを管理するうえでより実用的です。  
+  
+## Winres.exe の使用  
+ Winres.exe でローカライズを行う場合は、まず、Visual Studio のフォーム デザイナーなどのビジュアル デザイナーを使用してアプリケーションを開発する必要があります。  開発が完了したら、プロパティ エディターの <xref:System.ComponentModel.LocalizableAttribute>Localizable プロパティでフォームの を `true` に設定し、既定のカルチャの .resx ファイルを、サードパーティのローカライザーに渡します。 この .resx ファイルには、Winres.exe が元のフォームのデザイン時バージョンを再作成するために使用する補足情報が含まれています。  
+  
+> [!CAUTION]
+>  Winres.exe で既定のリソース ファイルを編集することはできません。  Winres.exe では、変更されたすべてのプロパティがローカライズされたプロパティと解釈され、ターゲット カルチャ リソース ファイルに保存されます。  
+  
+ カルチャ リソース ファイルの最終バージョンが完成したら、これを使用して、アプリケーションのローカライズ バージョンを作成できます。  詳細については、「[デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)」を参照してください。  
+  
+ Winres.exe バージョン 2.0 には、以下の機能があります。  
+  
+-   Winres は、単一ファイル モード \(SFM: Single File Mode\) または Visual Studio ファイル モード \(VSFM: Visual Studio File Mode\) で使用できます。  SFM は、フォームとその内容についての情報すべてをリソース ファイルに格納する、レガシなモードです。  VSFM では、カルチャの変更点のみがリソース ファイルに格納されます。  
+  
+-   エラー レポート ウィンドウがインターフェイスに追加されました。メイン ウィンドウの左下に表示されます。  
+  
+-   ホット キーの重複をチェックできます。\[書式\] メニューの **\[ホット キーの確認\]** をクリックします。  
+  
+## バージョンの互換性  
+ Visual Studio .NET 2002 と Visual Studio 2005 では、リソース ファイルの形式が変更されたため、Winres.exe もこれに合わせて変更されました。  したがって、原則として、アプリケーションの作成に使用している .NET Framework と共にリリースされた Winres.exe のバージョンを使用する必要があります。  次の表は、互換性のあるバージョンの一覧です。  
+  
+|Visual Studio|.NET Framework|Winres.exe|  
+|-------------------|--------------------|----------------|  
+|Visual Studio .NET 2002|1.0|1.0|  
+|Visual Studio .NET 2003|1.1|1.1|  
+|Visual Studio 2005|2.0|2.0|  
+|Visual Studio 2008|3.0 と 3.5|3.0 と 3.5|  
+|Visual Studio 2010|4.0|4.0|  
+  
+ Winres.exe バージョン 2.0 で、古いバージョンのリソース ファイルを開こうとすると、.NET Framework バージョン 2.0 互換の形式にファイルをアップグレードするよう促すメッセージが表示されます。  
+  
+ バージョン 2.0 より前のバージョンの .NET Framework の場合、Winres.exe および Visual Studio のフォーム デザイナーは、互換性のないカルチャ ニュートラルなリソース ファイルおよびカルチャ固有のリソース ファイルを作成していました。‏  したがって、ローカリゼーション処理を開始した後は、一方のツールだけを使用する必要がありました。  一方、Winres.exe バージョン 2.0 では、Visual Studio ファイル モード \(VSFM\) が追加されました。  この名前からわかるようにこのモードには互換性があり、このモードで保存したリソース ファイルはどちらのツールでも編集できます。  
+  
+> [!NOTE]
+>  VSFM には、Visual Studio 互換であるという長所がありますが、変更点だけをリソース ファイルに格納するため、Winres.exe で VSFM を使用するには、現在のリソース ファイルの親ファイルが同じディレクトリに存在する必要があります。  たとえば、ドイツ語のリソース ファイル `TestApp.de-DE.resources` を編集している場合は、既定のリソース ファイル `TestApp.resx` が存在する必要があり、ときにはカルチャ ニュートラルなリソース ファイル `TestApp.de.resources` も必要となることがあります。  
+  
+## 例  
+  
+#### フォームに関連付けられた .resx ファイルまたは .resources ファイルをローカライズするには  
+  
+1.  開発者コマンド プロンプトで「`winres`」と入力して、Winres.exe を実行します。  
+  
+2.  ローカライズするフォームの既定のリソースを開くには、**\[ファイル\]** メニューの **\[開く\]** をクリックし、開くファイルを指定します。  
+  
+     または  
+  
+     Winres.exe を起動するときに、コマンド ラインで開くファイルを指定します。  
+  
+     次のコマンドは、Winres.exe を起動し、`TestApp.resx` に関連付けられたフォームをフォーム デザイナーに読み込みます。  
+  
+    ```  
+    winres TestApp.resx  
+    ```  
+  
+     次のコマンドは、Winres.exe を起動し、`TestApp.resources` に関連付けられたフォームをフォーム デザイナーに読み込みます。  
+  
+    ```  
+    winres TestApp.resources  
+    ```  
+  
+    > [!NOTE]
+    >  リソースが編集中であるフォームが他のフォームを継承したフォームである場合は、継承したフォームを含むアセンブリと、継承元 \(派生元\) のフォームを含むアセンブリの両方が、グローバル アセンブリ キャッシュ \(GAC: Global Assembly Cache\) に登録されているか、WinRes.exe と同じディレクトリに存在する必要があります。  .NET Framework のコンポーネントを GAC にインストールする方法の詳細については、「[グローバル アセンブリ キャッシュ](../../../docs/framework/app-domains/gac.md)」をご覧ください。  
+  
+3.  フォーム上のコントロールを選択し、このコントロールの <xref:System.Windows.Forms.Control.Text%2A> などのプロパティを変更して、ローカライズ後のカルチャおよび言語を反映します。  ローカライズされたテキストが納まるように、必要に応じてコントロールを移動したりそのサイズを変更したりします。  
+  
+4.  ローカライズしたバージョンの .resx ファイルや .resources ファイルを保存するには、**\[上書き保存\]** ボタンをクリックするか、**\[ファイル\]** メニューの \[上書き保存\] をクリックします。  **\[カルチャを選択する\]** ウィンドウが表示されます。  
+  
+5.  適切なカルチャおよびファイル モードを選択し、**\[OK\]** をクリックします。  ファイルは、ローカライズ後のリソース ファイルで予測される名前付け規則を使用して保存されます。  たとえば、`TestApp.resources` をドイツのドイツ語用にローカライズする場合、ファイルは `TestApp.de-DE.resources` という名前で保存されます。  `TestApp.resx` をドイツのドイツ語用にローカライズする場合、ファイルは `TestApp.de-DE.resx` という名前で保存されます。  リソースの名前付け規則について詳しくは、「[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)」をご覧ください。  ランタイムで使用される定義済みカルチャ名の一覧については、「[CultureInfo クラス](https://msdn.microsoft.com/en-us/library/system.globalization.cultureinfo.aspx)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.LocalizableAttribute>   
+ <xref:System.Globalization.CultureInfo>   
+ <xref:System.Resources.ResourceManager>   
+ <xref:System.Resources.ResourceReader>   
+ <xref:System.Resources.ResourceWriter>   
+ [ツール](../../../docs/framework/tools/index.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/TOC.md b/docs/framework/ui-automation/TOC.md
new file mode 100644
index 00000000000..806d92e8d37
--- /dev/null
+++ b/docs/framework/ui-automation/TOC.md
@@ -0,0 +1,117 @@
+# [Obtain Text Attributes Using UI Automation](obtain-text-attributes-using-ui-automation.md)
+# [UI Automation Support for the Tab Control Type](ui-automation-support-for-the-tab-control-type.md)
+# [Implement UI Automation Providers in a Client Application](implement-ui-automation-providers-in-a-client-application.md)
+# [Use Caching in UI Automation](use-caching-in-ui-automation.md)
+# [Implementing the UI Automation Dock Control Pattern](implementing-the-ui-automation-dock-control-pattern.md)
+# [UI Automation Support for the Calendar Control Type](ui-automation-support-for-the-calendar-control-type.md)
+# [Accessibility](accessibility.md)
+# [Accessibility Best Practices](accessibility-best-practices.md)
+# [Implementing the UI Automation Invoke Control Pattern](implementing-the-ui-automation-invoke-control-pattern.md)
+# [UI Automation Clients for Managed Code](ui-automation-clients-for-managed-code.md)
+# [Create a Client-Side UI Automation Provider](create-a-client-side-ui-automation-provider.md)
+# [UI Automation Support for the Header Control Type](ui-automation-support-for-the-header-control-type.md)
+# [UI Automation Fundamentals](index.md)
+# [Obtain Mixed Text Attribute Details Using UI Automation](obtain-mixed-text-attribute-details-using-ui-automation.md)
+# [UI Automation Control Patterns Overview](ui-automation-control-patterns-overview.md)
+# [How-to Topics](ui-automation-text-pattern-how-to-topics.md)
+# [UI Automation Support for the ToolTip Control Type](ui-automation-support-for-the-tooltip-control-type.md)
+# [Find a UI Automation Element for a List Item](find-a-ui-automation-element-for-a-list-item.md)
+# [Obtaining UI Automation Elements](obtaining-ui-automation-elements.md)
+# [UI Automation Support for the MenuBar Control Type](ui-automation-support-for-the-menubar-control-type.md)
+# [UI オートメーション GridItem コントロール パターンの実装](implementing-the-ui-automation-griditem-control-pattern.md)
+# [UI Automation Support for the ComboBox Control Type](ui-automation-support-for-the-combobox-control-type.md)
+# [クライアントの UI オートメーション イベント](ui-automation-events-for-clients.md)
+# [Find and Highlight Text Using UI Automation](find-and-highlight-text-using-ui-automation.md)
+# [UI オートメーション イベントのサブスクライブ](subscribe-to-ui-automation-events.md)
+# [UI Automation Text Pattern](ui-automation-text-pattern.md)
+# [UI Automation Specification and Community Promise](ui-automation-specification-and-community-promise.md)
+# [Implementing the UI Automation Value Control Pattern](implementing-the-ui-automation-value-control-pattern.md)
+# [Navigate Among UI Automation Elements with TreeWalker](navigate-among-ui-automation-elements-with-treewalker.md)
+# [Expose the Content of a Table Using UI Automation](expose-the-content-of-a-table-using-ui-automation.md)
+# [UI オートメーション TableItem コントロール パターンの実装](implementing-the-ui-automation-tableitem-control-pattern.md)
+# [UI Automation Support for the Text Control Type](ui-automation-support-for-the-text-control-type.md)
+# [UI Automation Support for the Document Control Type](ui-automation-support-for-the-document-control-type.md)
+# [UI Automation Properties Overview](ui-automation-properties-overview.md)
+# [Access Embedded Objects Using UI Automation](access-embedded-objects-using-ui-automation.md)
+# [UI Automation Support for the DataGrid Control Type](ui-automation-support-for-the-datagrid-control-type.md)
+# [Implementing the UI Automation Window Control Pattern](implementing-the-ui-automation-window-control-pattern.md)
+# [Use the AutomationID Property](use-the-automationid-property.md)
+# [Register a Client-Side Provider Assembly](register-a-client-side-provider-assembly.md)
+# [Raise Events from a UI Automation Provider](raise-events-from-a-ui-automation-provider.md)
+# [UI Automation Support for the CheckBox Control Type](ui-automation-support-for-the-checkbox-control-type.md)
+# [UI Automation Support for the TabItem Control Type](ui-automation-support-for-the-tabitem-control-type.md)
+# [Caching in UI Automation Clients](caching-in-ui-automation-clients.md)
+# [TextPattern and Embedded Objects Overview](textpattern-and-embedded-objects-overview.md)
+# [UI Automation Support for the Table Control Type](ui-automation-support-for-the-table-control-type.md)
+# [UI オートメーション ScrollItem コントロール パターンの実装](implementing-the-ui-automation-scrollitem-control-pattern.md)
+# [Add Content to a Text Box Using UI Automation](add-content-to-a-text-box-using-ui-automation.md)
+# [Control Pattern Mapping for UI Automation Clients](control-pattern-mapping-for-ui-automation-clients.md)
+# [UI Automation Support for the Separator Control Type](ui-automation-support-for-the-separator-control-type.md)
+# [How-to Topics](ui-automation-providers-for-managed-code-how-to-topics.md)
+# [UI オートメーション Table コントロール パターンの実装](implementing-the-ui-automation-table-control-pattern.md)
+# [UI Automation and Microsoft Active Accessibility](ui-automation-and-microsoft-active-accessibility.md)
+# [UI Automation Support for the RadioButton Control Type](ui-automation-support-for-the-radiobutton-control-type.md)
+# [UI Automation Providers Overview](ui-automation-providers-overview.md)
+# [UI Automation Support for the ToolBar Control Type](ui-automation-support-for-the-toolbar-control-type.md)
+# [Get the Toggle State of a Check Box Using UI Automation](get-the-toggle-state-of-a-check-box-using-ui-automation.md)
+# [UI Automation Support for the Pane Control Type](ui-automation-support-for-the-pane-control-type.md)
+# [Implementing the UI Automation SelectionItem Control Pattern](implementing-the-ui-automation-selectionitem-control-pattern.md)
+# [UI Automation Control Types Overview](ui-automation-control-types-overview.md)
+# [Implementing the UI Automation Scroll Control Pattern](implementing-the-ui-automation-scroll-control-pattern.md)
+# [How-to Topics](ui-automation-control-patterns-how-to-topics.md)
+# [UI Automation Support for the Edit Control Type](ui-automation-support-for-the-edit-control-type.md)
+# [Server-Side UI Automation Provider Implementation](server-side-ui-automation-provider-implementation.md)
+# [UI Automation Events Overview](ui-automation-events-overview.md)
+# [How-to Topics](ui-automation-clients-for-managed-code-how-to-topics.md)
+# [UI Automation Overview](ui-automation-overview.md)
+# [UI Automation Providers for Managed Code](ui-automation-providers-for-managed-code.md)
+# [Implementing the UI Automation Transform Control Pattern](implementing-the-ui-automation-transform-control-pattern.md)
+# [Invoke a Control Using UI Automation](invoke-a-control-using-ui-automation.md)
+# [Return Properties from a UI Automation Provider](return-properties-from-a-ui-automation-provider.md)
+# [Implementing the UI Automation MultipleView Control Pattern](implementing-the-ui-automation-multipleview-control-pattern.md)
+# [UI Automation Control Patterns for Clients](ui-automation-control-patterns-for-clients.md)
+# [Expose a Server-side UI Automation Provider](expose-a-server-side-ui-automation-provider.md)
+# [UI Automation Support for the MenuItem Control Type](ui-automation-support-for-the-menuitem-control-type.md)
+# [UI Automation Support for the Window Control Type](ui-automation-support-for-the-window-control-type.md)
+# [UI Automation Support for the Image Control Type](ui-automation-support-for-the-image-control-type.md)
+# [UI Automation Support for the StatusBar Control Type](ui-automation-support-for-the-statusbar-control-type.md)
+# [Implementing the UI Automation Selection Control Pattern](implementing-the-ui-automation-selection-control-pattern.md)
+# [UI Automation and Screen Scaling](ui-automation-and-screen-scaling.md)
+# [UI Automation TextPattern Overview](ui-automation-textpattern-overview.md)
+# [Move a UI Automation Element](move-a-ui-automation-element.md)
+# [Traverse Text Using UI Automation](traverse-text-using-ui-automation.md)
+# [Implementing the UI Automation Toggle Control Pattern](implementing-the-ui-automation-toggle-control-pattern.md)
+# [Enable Navigation in a UI Automation Fragment Provider](enable-navigation-in-a-ui-automation-fragment-provider.md)
+# [UI Automation Support for the TitleBar Control Type](ui-automation-support-for-the-titlebar-control-type.md)
+# [Find a UI Automation Element Based on a Property Condition](find-a-ui-automation-element-based-on-a-property-condition.md)
+# [UI Automation Support for the Spinner Control Type](ui-automation-support-for-the-spinner-control-type.md)
+# [Using UI Automation for Automated Testing](using-ui-automation-for-automated-testing.md)
+# [UI Automation Support for Standard Controls](ui-automation-support-for-standard-controls.md)
+# [Client-Side UI Automation Provider Implementation](client-side-ui-automation-provider-implementation.md)
+# [UI Automation Support for the ListItem Control Type](ui-automation-support-for-the-listitem-control-type.md)
+# [UI Automation Support for the ScrollBar Control Type](ui-automation-support-for-the-scrollbar-control-type.md)
+# [UI Automation Support for the Tree Control Type](ui-automation-support-for-the-tree-control-type.md)
+# [UI Automation Support for the ProgressBar Control Type](ui-automation-support-for-the-progressbar-control-type.md)
+# [UI Automation Control Types](ui-automation-control-types.md)
+# [UI Automation Properties for Clients](ui-automation-properties-for-clients.md)
+# [Implementing the UI Automation Grid Control Pattern](implementing-the-ui-automation-grid-control-pattern.md)
+# [UI Automation Support for the TreeItem Control Type](ui-automation-support-for-the-treeitem-control-type.md)
+# [Implementing the UI Automation RangeValue Control Pattern](implementing-the-ui-automation-rangevalue-control-pattern.md)
+# [UI Automation Control Patterns](ui-automation-control-patterns.md)
+# [Implementing the UI Automation ExpandCollapse Control Pattern](implementing-the-ui-automation-expandcollapse-control-pattern.md)
+# [UI Automation Security Overview](ui-automation-security-overview.md)
+# [UI Automation Support for the Group Control Type](ui-automation-support-for-the-group-control-type.md)
+# [UI Automation Support for the DataItem Control Type](ui-automation-support-for-the-dataitem-control-type.md)
+# [UI Automation Support for the SplitButton Control Type](ui-automation-support-for-the-splitbutton-control-type.md)
+# [UI Automation Support for the Thumb Control Type](ui-automation-support-for-the-thumb-control-type.md)
+# [UI Automation Support for the Hyperlink Control Type](ui-automation-support-for-the-hyperlink-control-type.md)
+# [UI Automation Support for the List Control Type](ui-automation-support-for-the-list-control-type.md)
+# [Support Control Patterns in a UI Automation Provider](support-control-patterns-in-a-ui-automation-provider.md)
+# [UI Automation Threading Issues](ui-automation-threading-issues.md)
+# [UI Automation Support for the HeaderItem Control Type](ui-automation-support-for-the-headeritem-control-type.md)
+# [Get UI Automation Element Properties](get-ui-automation-element-properties.md)
+# [UI Automation Support for the Button Control Type](ui-automation-support-for-the-button-control-type.md)
+# [UI Automation Support for the Slider Control Type](ui-automation-support-for-the-slider-control-type.md)
+# [UI オートメーション ツリーの概要](ui-automation-tree-overview.md)
+# [UI Automation Support for the Menu Control Type](ui-automation-support-for-the-menu-control-type.md)
+# [サポートされている UI オートメーション コントロール パターンの取得](get-supported-ui-automation-control-patterns.md)
diff --git a/docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md b/docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md
new file mode 100644
index 00000000000..f8a4e8eef62
--- /dev/null
+++ b/docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md
@@ -0,0 +1,64 @@
+---
+title: "Access Embedded Objects Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "embedded objects, accessing"
+  - "accessing embedded objects"
+  - "UI Automation, accessing embedded objects"
+ms.assetid: a5b513ec-7fa6-4460-869f-c18ff04f7cf2
+caps.latest.revision: 17
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 17
+---
+# Access Embedded Objects Using UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、どのように [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] を使用して、テキスト コントロールのコンテンツ内に埋め込みオブジェクトを公開できるのかを示しています。  
+  
+> [!NOTE]
+>  埋め込みオブジェクトには、イメージ、ハイパーリンク、ボタン、テーブル、ActiveX コントロールを含めることができます。  
+  
+ 埋め込みオブジェクトは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] テキスト プロバイダーの子と見なされます。 これにより、他のすべての [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素と同じ UI オートメーション ツリーの構造を介して公開することができます。 次に、機能は、埋め込みオブジェクトのコントロール型で通常必要とされるコントロール パターンを通じて公開されます \(たとえば、ハイパーリンクはテキスト ベースであるため、<xref:System.Windows.Automation.TextPattern> をサポートします\)。  
+  
+ ![テキスト コンテナー内の埋め込みオブジェクト。](../../../docs/framework/ui-automation/media/uia-textpattern-embeddedobjects.PNG "UIA\_TextPattern\_EmbeddedObjects")  
+テキスト コンテンツ \(「ご存知でしたか?」\) を含むドキュメントのサンプル および 2 つの埋め込みオブジェクト \(クジラの画像とテキストのハイパーリンク\)。コード例のターゲットとして使用されます。  
+  
+## 使用例  
+ 次のコード例は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] テキスト プロバイダー内から埋め込みオブジェクトのコレクションを取得する方法を示します。 概要で提供されたサンプルのドキュメントについては、2 つのオブジェクトが返されます \(イメージ要素と、テキスト要素\)。  
+  
+> [!NOTE]
+>  イメージ要素には、画像に関連付けられて説明する組み込みテキストが必要であり、通常は <xref:System.Windows.Automation.AutomationElement.NameProperty> 内にあります \(「青いクジラ」など\)。 ただし、イメージ オブジェクトにまたがるテキスト範囲を取得すると、イメージもこの説明のテキストもテキストのストリームで返されません。  
+  
+ [!code-csharp[FindText#StartApp](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#startapp)]
+ [!code-vb[FindText#StartApp](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#startapp)]  
+[!code-csharp[FindText#FindTextProvider](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#findtextprovider)]
+[!code-vb[FindText#FindTextProvider](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#findtextprovider)]  
+[!code-csharp[FindText#GetChildren](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#getchildren)]
+[!code-vb[FindText#GetChildren](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#getchildren)]  
+  
+## 使用例  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] テキスト プロバイダー内の埋め込みオブジェクトからテキストの範囲を取得する方法を、次のコード例で示します。 取得されるテキストの範囲は空の範囲です。ここで、開始エンドポイントは "… ocean.\(space\)" の後に続き、終了エンドポイントは、\(概要で提供した画像に示されているように\) 埋め込みハイパーリンクを表す終了の "." に先行します。 これは空の範囲ですが、スパンが 0 ではないため、低次元テキスト範囲とはみなされません。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.TextPattern> はハイパーリンクなどのテキスト ベースの埋め込みオブジェクトを取得することができます。ただし、セカンダリ <xref:System.Windows.Automation.TextPattern> は完全な機能を公開するために、埋め込みオブジェクトから取得する必要があります。  
+  
+ [!code-csharp[UIATextPattern_snip#GetRangeFromChild](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATextPattern_snip/CSharp/SearchWindow.cs#getrangefromchild)]
+ [!code-vb[UIATextPattern_snip#GetRangeFromChild](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATextPattern_snip/VisualBasic/SearchWindow.vb#getrangefromchild)]  
+  
+## 参照  
+ [UI Automation TextPattern Overview](../../../docs/framework/ui-automation/ui-automation-textpattern-overview.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Add Content to a Text Box Using UI Automation](../../../docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md)   
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/accessibility-best-practices.md b/docs/framework/ui-automation/accessibility-best-practices.md
new file mode 100644
index 00000000000..bba3d2131eb
--- /dev/null
+++ b/docs/framework/ui-automation/accessibility-best-practices.md
@@ -0,0 +1,143 @@
+---
+title: "Accessibility Best Practices | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "best practices for accessibility"
+  - "accessibility, best practices for"
+ms.assetid: e6d5cd98-21a3-4b01-999c-fb953556d0e6
+caps.latest.revision: 16
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 16
+---
+# Accessibility Best Practices
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ コントロールやアプリケーションで以下のベスト プラクティスを実行すると、[!INCLUDE[TLA#tla_at](../../../includes/tlasharptla-at-md.md)] デバイスを使用するユーザーのアクセシビリティ が向上します。 これらのベスト プラクティスの多くは [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] に適した設計を中心としています。 各ベスト プラクティスには、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] コントロールまたはアプリケーションの実装の情報が含まれています。 多くの場合、これらのベスト プラクティスに対応する作業は既に [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] コントロールに含まれています。  
+  
+<a name="Programmatic_Access"></a>   
+## プログラムによるアクセス  
+ プログラムによるアクセスにより、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素にラベルが付き、プロパティの値が公開され、適切なイベントが発生するようになります。 標準の [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] コントロールでは、この作業の大部分が <xref:System.Windows.Automation.Peers.AutomationPeer> を介して既に実行されています。 カスタム コントロールでは、プログラムによるアクセスが正しく実装されていることを確認する必要があります。  
+  
+<a name="Enable_Programmatic_Access_to_all_UI_Elements_and_Text"></a>   
+### すべての UI 要素とテキストでのプログラムによるアクセスの有効化  
+ [!INCLUDE[TLA#tla_ui#initcap](../../../includes/tlasharptla-uisharpinitcap-md.md)] 要素では、プログラムによるアクセスを有効にする必要があります。[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] が標準的な [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] コントロールである場合、プログラムによるアクセスのサポートがコントロールに含まれます。 コントロールがカスタム コントロール \(コモン コントロールのサブクラスに指定されているコントロール、またはコントロールからサブクラスに指定されたコントロール\) である場合、変更が必要な領域に対する <xref:System.Windows.Automation.Peers.AutomationPeer> の実装を確認する必要があります。  
+  
+ このベスト プラクティスに従うことで [!INCLUDE[TLA2#tla_at](../../../includes/tla2sharptla-at-md.md)] ベンダーは、製品の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の要素を特定および操作することができます。  
+  
+<a name="Place_Names__Titles_and_Descriptions_on_UI_Objects_"></a>   
+### UI オブジェクト、フレーム、およびページにおける、場所の名前、タイトル、説明  
+ スクリーン リーダーなどの支援のテクノロジでは、ナビゲーション スキーム内のフレーム、オブジェクト、またはページの場所を理解するためにタイトルを使用します。 そのため、タイトルは非常にわかりやすくする必要があります。 たとえば、「Microsoft Web ページ」といった Web ページのタイトルでは、ユーザーはいくつかの特定の領域に深く入っていった場合に役に立ちません。 わかりやすいタイトルは、スクリーン リーダーに依存する視覚障がい者にとって重要です。 同様に、 [!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] コントロールでも、<xref:System.Windows.Automation.AutomationProperties.NameProperty> と <xref:System.Windows.Automation.AutomationProperties.HelpTextProperty> は [!INCLUDE[TLA2#tla_at](../../../includes/tla2sharptla-at-md.md)] デバイスにとって重要です。  
+  
+ このベスト プラクティスに従うことにより、[!INCLUDE[TLA2#tla_at](../../../includes/tla2sharptla-at-md.md)] はサンプル コントロールとアプリケーションの [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を特定および操作できるようになります。  
+  
+<a name="Ensure_Programmatic_Events_are_Triggered_by_all_UI"></a>   
+### プログラムによるイベントが、すべての UI 操作によってトリガーされることを確認する  
+ このベスト プラクティスに従うことにより、[!INCLUDE[TLA2#tla_at](../../../includes/tla2sharptla-at-md.md)] は [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の変化をリッスンし、変化についてユーザーに通知できるようになります。  
+  
+<a name="User_Settings"></a>   
+## ユーザー設定  
+ このセクションのベスト プラクティスでは、コントロールやアプリケーションはユーザー設定をオーバーライドしないようにします。  
+  
+<a name="Respect_all_System_Wide_Settings_and_do_not_Interfere"></a>   
+### すべてのシステム全体の設定を尊重し、ユーザー補助機能に干渉しない  
+ ユーザーは、コントロール パネルを使用して、システム全体のフラグを設定できます。その他のフラグはプログラムで設定できます。 これらの設定は、コントロールやアプリケーションで変更しないでください。 また、アプリケーションは、ホスト オペレーティング システムのユーザー補助の設定をサポートする必要があります。  
+  
+ このベスト プラクティスに従うことにより、ユーザーはユーザー補助の設定を行えるとともに、これらの設定がアプリケーションによって変更されないことを認識できます。  
+  
+<a name="Visual_UI_Design"></a>   
+## UI のビジュアル デザイン  
+ このセクションのベスト プラクティスでは、コントロールまたはアプリケーションが色と画像を効果的に使用するとともに、[!INCLUDE[TLA2#tla_at#plural](../../../includes/tla2sharptla-atsharpplural-md.md)] によって使用できるようにします。  
+  
+<a name="Don_t_Hard_Code_Colors"></a>   
+### 色をハードコーディングしない  
+ 色覚に障がいがあるユーザー、弱視のユーザー、または白黒の画面を使用するユーザーは、ハード コーディングされた色を持つアプリケーションを使用できません。  
+  
+ このベスト プラクティスに従うことにより、ユーザーは、個人のニーズに基づいて色の組み合わせを調整できるようになります。  
+  
+<a name="Support_High_Contrast_and_all_System_Display_Attributes"></a>   
+### ハイ コントラストとすべてのシステム表示属性をサポートする  
+ アプリケーションは、ユーザーが選択したシステム全体のコントラスト設定、色の選択、またはその他のシステム全体のディスプレイの設定と属性を中断または無効にしてはなりません。 ユーザーが採用しているシステム全体の設定は、アプリケーションのユーザー補助機能を強化します。そのため、これをアプリケーションによって無効にしたり、無視したりしないでください。 色は、正しいコントラストを提供するため、正しい前景色と背景色の組み合わせで使用する必要があります。 関係のない色を混在させないでください。また、色を反転させないでください。  
+  
+ 黒の背景に白いテキストなど、特定のハイ コントラストの組み合わせが必要なユーザーは多数います。 それらを反転させて、白地に黒のテキストとして描画すると、前景色の上に背景色がにじみ、一部のユーザーには読みづらくなります。  
+  
+<a name="Ensure_all_UI_Correctly_Scales_by_any_DPI_Setting"></a>   
+### すべての DPI 設定によってすべての UI を正しく拡大\/縮小する  
+ すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 設定によってすべての [!INCLUDE[TLA#tla_dpi](../../../includes/tlasharptla-dpi-md.md)] が正しく拡大\/縮小されていることを確認します。 また、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素が  1024 x 768、120 [!INCLUDE[TLA#tla_dpi](../../../includes/tlasharptla-dpi-md.md)] の画面に合っていることを確認します。  
+  
+<a name="Navigation"></a>   
+## ナビゲーション  
+ このセクションのベスト プラクティスでは、ナビゲーションがコントロールとアプリケーションで対処されていることを確認します。  
+  
+<a name="Provide_Keyboard_Interface_for_all_UI_Elements"></a>   
+### すべての UI 要素にキーボード インターフェイスを指定する  
+ タブ ストップは、特に慎重に計画された場合は、ユーザーが [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] をナビゲートする別の方法を提供します。  
+  
+ アプリケーションは、次のキーボード インターフェイスを備えている必要があります。  
+  
+-   ボタン、リンク、またはリスト ボックスなど、ユーザーが操作できるすべてのコントロールのタブ ストップ  
+  
+-   論理的なタブの順序  
+  
+<a name="Show_the_Keyboard_Focus"></a>   
+### キーボード フォーカスの表示  
+ ユーザーがキーストロークの効果を予測できるように、ユーザーはどのオブジェクトにキーボード フォーカスがあるかを認識しておく必要があります。 キーボード フォーカスを強調表示するには、色、フォント、または四角形や拡大などのグラフィックスを使用します。 キーボード フォーカスを音声で強調表示するには、音量、音の高さ、または音質を変更します。  
+  
+ 混乱を回避するには、アプリケーションはビジュアル フォーカス インジケーターをすべて非表示にし、非アクティブなウィンドウ \(またはペイン\) にある選択項目を暗くする必要があります。  
+  
+ アプリケーションは、キーボード フォーカスで以下を行う必要があります。  
+  
+-   1 つの項目が常にキーボード フォーカスされている必要がある  
+  
+-   キーボード フォーカスは明確に表示されている必要がある  
+  
+-   選択項目またはフォーカスされた項目は視覚的に強調表示されている必要がある  
+  
+<a name="Support_Navigation_Standards_and_Powerful_Navigation"></a>   
+### ナビゲーションの標準と強力なナビゲーション スキームをサポートする  
+ さまざまなキーボード ナビゲーションの側面で、ユーザーが [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] をナビゲートするさまざまな方法が提供されています。  
+  
+ アプリケーションは、次のキーボード インターフェイスを備えている必要があります。  
+  
+-   すべてのコマンド、メニュー、およびコントロール用のショートカット キーと下線付きのアクセス キー  
+  
+-   重要なリンクへのキーボード ショートカット  
+  
+-   すべてのメニュー項目にアクセス キーがあり、すべてのボタンにアクセラレータ キーがあり、すべてのコマンドにアクセラレータ キーがある  
+  
+<a name="Do_not_let_Mouse_Location_Interfere_with_Keyboard"></a>   
+### マウスの位置がキーボード ナビゲーションと干渉しないようにする  
+ マウスの位置は、キーボードのナビゲーションと干渉しないようにしてください。 たとえば、マウスが別の場所に位置し、ユーザーがキーボードでナビゲートする場合、マウスのクリックは、ユーザーが開始するまで発生しないようにします。  
+  
+<a name="Multimodal_Interface"></a>   
+## マルチモーダル インターフェイス  
+ このセクションのベスト プラクティスでは、アプリケーション [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] にはビジュアル要素の代替案が含まれています。  
+  
+<a name="Provide_User_Selectable_Equivalents_for_Non_Text"></a>   
+### テキスト以外の要素に相当する、ユーザーが選択可能な項目を提供する  
+ テキスト以外の各要素について、テキスト、チャット内容、または音声による説明 \(代替テキスト、キャプション、視覚的なフィードバックなど\) に相当する、ユーザーが選択可能な項目を提供します。  
+  
+ テキスト以外の要素には、幅広い範囲の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素 \(画像、画像マップ領域、アニメーション、アプレット、フレーム、スクリプト、グラフィカルなボタン、サウンド、スタンドアロンのオーディオ ファイル、およびビデオなど\) があります。 テキスト以外の要素は、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] のコンテンツを理解するためにユーザーがアクセスを必要とする視覚的な情報、音声、または通常のオーディオ情報が含まれる場合は重要になります。  
+  
+<a name="Use_Color_but_also_Provide_Alternatives_to_Color"></a>   
+### 色を使用するだけでなく、色の代替手段を提供する  
+ 色を使用して、他の手段によって示される情報を強化、強調、または再反復処理します。ただし、色単独を使用して情報を伝達しないでください。 色覚に障がいがあるユーザーまたは白黒表示のディスプレイを持つユーザーには、色の代替手段が必要です。  
+  
+<a name="Use_Standard_Input_APIs_with_Devices_Independent"></a>   
+### デバイスに依存しない呼び出しで標準の入力 API を使用する  
+ デバイスに依存しない呼び出しは、キーボードとマウスの機能が同等であることを保証する一方、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] に関する必要な情報を [!INCLUDE[TLA2#tla_at](../../../includes/tla2sharptla-at-md.md)] に提供します。  
+  
+## 参照  
+ <xref:System.Windows.Automation.Peers>   
+ [NumericUpDown Custom Control with Theme and UI Automation Support Sample](http://msdn.microsoft.com/ja-jp/9aed3c10-68eb-419e-a57f-1d2af15a8253)   
+ [キーボード ユーザー インターフェイス設計のガイドライン](http://msdn2.microsoft.com/library/ms971323.aspx)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/accessibility.md b/docs/framework/ui-automation/accessibility.md
new file mode 100644
index 00000000000..ae7c4b54635
--- /dev/null
+++ b/docs/framework/ui-automation/accessibility.md
@@ -0,0 +1,41 @@
+---
+title: "Accessibility | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/17/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation"
+ms.assetid: e7ec856e-41ee-47b1-9d57-b75a3dad088c
+caps.latest.revision: 80
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+---
+# Accessibility
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]は、[!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] の新しいアクセシビリティ フレームワークです。  [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] に関する情報にプログラムからアクセスできるようにすることで、支援技術製品や自動テスト フレームワークのニーズに応えます。  さらに、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を利用することで、ユーザー補助を備えたコントロールやアプリケーション製品を開発できます。  
+  
+ ここでは、マネージ コード用の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] [!INCLUDE[TLA#tla_api](../../../includes/tlasharptla-api-md.md)] について説明します。  C\+\+ での [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]のプログラミングについては、「[Win32 アプリケーションの UI オートメーション](entry_uiauto_win32)」を参照してください。  
+  
+## このセクションの内容  
+ [Accessibility Best Practices](../../../docs/framework/ui-automation/accessibility-best-practices.md)  
+ [UI Automation Fundamentals](../../../docs/framework/ui-automation/index.md)  
+ [UI Automation Providers for Managed Code](../../../docs/framework/ui-automation/ui-automation-providers-for-managed-code.md)  
+ [UI Automation Clients for Managed Code](../../../docs/framework/ui-automation/ui-automation-clients-for-managed-code.md)  
+ [UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)  
+ [UI Automation Text Pattern](../../../docs/framework/ui-automation/ui-automation-text-pattern.md)  
+ [UI Automation Control Types](../../../docs/framework/ui-automation/ui-automation-control-types.md)  
+ [UI Automation Specification and Community Promise](../../../docs/framework/ui-automation/ui-automation-specification-and-community-promise.md)  
+  
+## 関連項目  
+ [Accessibility Samples](http://msdn.microsoft.com/ja-jp/17dd2b9f-9e36-4432-8b9b-6c5fc295b4a6)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md b/docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md
new file mode 100644
index 00000000000..aba77bb7c36
--- /dev/null
+++ b/docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md
@@ -0,0 +1,36 @@
+---
+title: "Add Content to a Text Box Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "adding content to text boxes"
+  - "text boxes, adding content"
+  - "UI Automation, adding content to text boxes"
+ms.assetid: 8bdd1a73-1ecb-4a05-a891-a7827ebb767f
+caps.latest.revision: 13
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 13
+---
+# Add Content to a Text Box Using UI Automation
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して 1 行のテキスト ボックスにテキストを挿入する方法を示します。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を適用できない複数行コントロールおよびリッチ テキスト コントロールのために、別の方法も提供されています。  また、比較のために、この例では Win32 メソッドを使用して同じことを実現する方法も示します。  
+  
+## 使用例  
+ 次の例では、ターゲット アプリケーションで一連のテキスト コントロールをステップ スルーします。  各テキスト コントロールについては、<xref:System.Windows.Automation.AutomationElement.TryGetCurrentPattern%2A> メソッドを使用して、各コントロールから <xref:System.Windows.Automation.ValuePattern> オブジェクトを取得できるかどうかがテストされます。  テキスト コントロールが <xref:System.Windows.Automation.ValuePattern> をサポートしていない場合は、<xref:System.Windows.Automation.ValuePattern.SetValue%2A> メソッドを使用して、ユーザー定義文字列をテキスト コントロールに挿入します。  それ以外の場合は、<xref:System.Windows.Forms.SendKeys.SendWait%2A?displayProperty=fullName> メソッドが使用されます。  
+  
+ [!code-csharp[InsertText#InsertText](../../../samples/snippets/csharp/VS_Snippets_Wpf/InsertText/CSharp/Window1.xaml.cs#inserttext)]
+ [!code-vb[InsertText#InsertText](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InsertText/VisualBasic/Window1.xaml.vb#inserttext)]  
+  
+## 参照  
+ [TextPattern Insert Text Sample](http://msdn.microsoft.com/ja-jp/67353f93-7ee2-42f2-ab76-5c078cf6ca16)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/caching-in-ui-automation-clients.md b/docs/framework/ui-automation/caching-in-ui-automation-clients.md
new file mode 100644
index 00000000000..117228e2ee6
--- /dev/null
+++ b/docs/framework/ui-automation/caching-in-ui-automation-clients.md
@@ -0,0 +1,114 @@
+---
+title: "Caching in UI Automation Clients | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation caching in clients"
+  - "caching, UI Automation clients"
+ms.assetid: 94c15031-4975-43cc-bcd5-c9439ed21c9c
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# Caching in UI Automation Clients
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティとコントロール パターンのキャッシュについて説明します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、キャッシュとはデータをプリフェッチすることを意味します。 そのデータには、さらにプロセス間通信を行わずにアクセスできます。 キャッシュは通常、UI オートメーション クライアント アプリケーションによって使用され、プロパティとコントロール パターンを一括で取得します。 それから、必要に応じて情報がキャッシュから取得されます。 アプリケーションはキャッシュを定期的に更新します。通常は、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] で何かが変更されたことを示すイベントへの応答として更新を行います。  
+  
+ キャッシュの効果は、サーバー側 UI オートメーション プロバイダーを持つ [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] コントロールとカスタム コントロールで最も顕著に表れます。[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コントロールの既定のプロバイダーなど、クライアント側プロバイダーにアクセスするときは、メリットは小さくなります。  
+  
+ キャッシュはアプリケーションが <xref:System.Windows.Automation.CacheRequest> をアクティブにしたときに発生し、<xref:System.Windows.Automation.AutomationElement.FindFirst%2A> や <xref:System.Windows.Automation.AutomationElement.FindAll%2A> など、<xref:System.Windows.Automation.AutomationElement> を返すメソッドやプロパティを使用します。<xref:System.Windows.Automation.TreeWalker> クラスのメソッドは例外で、<xref:System.Windows.Automation.CacheRequest> がパラメーターとして指定された場合 \(たとえば、<xref:System.Windows.Automation.TreeWalker.GetFirstChild%28System.Windows.Automation.AutomationElement%2CSystem.Windows.Automation.CacheRequest%29?displayProperty=fullName>\) にのみ、キャッシュが行われます。  
+  
+ また、キャッシュは、<xref:System.Windows.Automation.CacheRequest> がアクティブなときにイベントにサブスクライブする場合にも発生します。 イベントのソースとしてイベント ハンドラーに渡された <xref:System.Windows.Automation.AutomationElement> には、元の <xref:System.Windows.Automation.CacheRequest> によって指定されているキャッシュされたプロパティとパターンが含まれています。 イベントにサブスクライブした後で <xref:System.Windows.Automation.CacheRequest> に加えられた変更が、影響を与えることはありません。  
+  
+ 要素の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティとコントロール パターンはキャッシュすることができます。  
+  
+<a name="Options_for_Caching"></a>   
+## キャッシュのオプション  
+ <xref:System.Windows.Automation.CacheRequest> はキャッシュ用の次のオプションを指定します。  
+  
+<a name="Properties_to_Cache"></a>   
+### キャッシュするプロパティ  
+ 要求をアクティブ化する前に、各プロパティの <xref:System.Windows.Automation.CacheRequest.Add%28System.Windows.Automation.AutomationProperty%29> を呼び出して、キャッシュするプロパティを指定できます。  
+  
+<a name="Control_Patterns_to_Cache"></a>   
+### キャッシュするコントロール パターン  
+ 要求をアクティブ化する前に、各パターンの <xref:System.Windows.Automation.CacheRequest.Add%28System.Windows.Automation.AutomationPattern%29> を呼び出して、キャッシュするコントロール パターンを指定できます。 パターンがキャッシュされるとき、そのプロパティは自動的にはキャッシュされません。<xref:System.Windows.Automation.CacheRequest.Add%2A?displayProperty=fullName> を使用して、キャッシュするプロパティを指定する必要があります。  
+  
+<a name="Scope_of_the_Caching"></a>   
+### キャッシュのスコープとフィルター処理  
+ 要求をアクティブ化する前に <xref:System.Windows.Automation.CacheRequest.TreeScope%2A?displayProperty=fullName> プロパティを設定し、キャッシュするプロパティやパターンを持つ要素を指定できます。 スコープは、要求がアクティブな間に取得される要素を基準としています。 たとえば、<xref:System.Windows.Automation.TreeScope> のみを設定し、<xref:System.Windows.Automation.AutomationElement> を取得する場合に、要素の子のプロパティとパターンはキャッシュされますが、要素自体のプロパティとパターンはキャッシュされません。 取得される要素自体についてキャッシュが行われるようにするには、<xref:System.Windows.Automation.CacheRequest.TreeScope%2A> プロパティに <xref:System.Windows.Automation.TreeScope> を含める必要があります。 スコープを <xref:System.Windows.Automation.TreeScope> または <xref:System.Windows.Automation.TreeScope> に設定することはできません。 ただし、子要素がキャッシュされると親要素をキャッシュできます。このトピックの「キャッシュされた子と親の取得」を参照してください。  
+  
+ キャッシュの範囲は、<xref:System.Windows.Automation.CacheRequest.TreeFilter%2A?displayProperty=fullName> プロパティによっても影響を受けます。 既定では、キャッシュは [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに表示される要素にのみ実行されます。 ただし、キャッシュをすべての要素に適用したり、コンテンツ ビューに表示される要素にのみ適用したりするように、このプロパティを変更することができます。  
+  
+<a name="Strength_of_the_Element_References"></a>   
+### 要素の参照の強度  
+ <xref:System.Windows.Automation.AutomationElement> を取得するときは、既定では、キャッシュされていないものも含め、その要素のすべてのプロパティとパターンにアクセスできます。 ただし、作業効率を向上するために、<xref:System.Windows.Automation.CacheRequest> の <xref:System.Windows.Automation.CacheRequest.AutomationElementMode%2A> プロパティを <xref:System.Windows.Automation.AutomationElementMode> に設定して、要素への参照がキャッシュされたデータのみを参照するよう指定できます。 この場合、取得された要素のキャッシュされていないプロパティとパターンには、いずれもアクセスできません。 つまり、<xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A> を通してプロパティにアクセスしたり、<xref:System.Windows.Automation.AutomationElement> の `Current` プロパティやコントロール パターンにアクセスすることはできません。また、<xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A> や <xref:System.Windows.Automation.AutomationElement.TryGetCurrentPattern%2A> を使用してパターンを取得することもできません。 キャッシュされたパターンでは、<xref:System.Windows.Automation.SelectionPattern.SelectionPatternInformation.GetSelection%2A?displayProperty=fullName> などの配列のプロパティを取得するメソッドを呼び出すことができますが、<xref:System.Windows.Automation.InvokePattern.Invoke%2A?displayProperty=fullName> などのコントロール上でアクションを実行するものは呼び出すことができません。  
+  
+ オブジェクトへの完全参照を必要としない可能性があるアプリケーションの例として、スクリーン リーダーがあります。これは、ウィンドウ内の要素の <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Name%2A> プロパティと <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ControlType%2A> プロパティをプリフェッチしても、<xref:System.Windows.Automation.AutomationElement> オブジェクト自体は必要としません。  
+  
+<a name="Activating_the_CacheRequest"></a>   
+## CacheRequest のアクティブ化  
+ <xref:System.Windows.Automation.CacheRequest> が現在のスレッドに対してアクティブである間に <xref:System.Windows.Automation.AutomationElement> オブジェクトが取得された場合にのみ、キャッシュが実行されます。<xref:System.Windows.Automation.CacheRequest> をアクティブ化するには、2 つの方法があります。  
+  
+ 通常の方法では、<xref:System.Windows.Automation.CacheRequest.Activate%2A> を呼び出します。 このメソッドは、<xref:System.IDisposable> を実装するオブジェクトを返します。 要求は、<xref:System.IDisposable> オブジェクトが存在する限りアクティブなままです。 オブジェクトの有効期間を制御する最も簡単な方法は、`using` \([!INCLUDE[TLA#tla_cshrp](../../../includes/tlasharptla-cshrp-md.md)]\) または `Using` \([!INCLUDE[TLA2#tla_visualb](../../../includes/tla2sharptla-visualb-md.md)]\) のブロック内に呼び出しを埋め込むことです。 これにより、例外が発生した場合でも、スタックから要求がポップされます。  
+  
+ キャッシュ要求を入れ子にする場合に有用な別の方法は、<xref:System.Windows.Automation.CacheRequest.Push%2A> を呼び出すことです。 この方法では、スタック上に要求が配置され、アクティブ化されます。<xref:System.Windows.Automation.CacheRequest.Pop%2A> によってスタックから削除されるまで、要求はアクティブなままです。 別の要求がスタックにプッシュされた場合、要求は一時的に非アクティブになります。スタックの最上位の要求のみがアクティブになります。  
+  
+<a name="Retrieving_Cached_Properties"></a>   
+## キャッシュされたプロパティの取得  
+ 要素のキャッシュされたプロパティを取得するには、次のメソッドとプロパティを使用します。  
+  
+-   <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.Cached%2A>  
+  
+ 要求されたプロパティがキャッシュ内にない場合、例外が発生します。  
+  
+ <xref:System.Windows.Automation.AutomationElement.Current%2A> と同様、<xref:System.Windows.Automation.AutomationElement.Cached%2A> は構造体のメンバーとして、個々のプロパティを公開します。 ただし、この構造体を取得する必要はありません。個々のプロパティに直接アクセスすることができます。 たとえば、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Name%2A> プロパティは `element.Cached.Name` から取得できます。ここで、`element` は <xref:System.Windows.Automation.AutomationElement> です。  
+  
+<a name="Retrieving_Cached_Control_Patterns"></a>   
+## キャッシュされたコントロール パターンの取得  
+ 要素のキャッシュされたコントロール パターンを取得するには、次のメソッドを使用します。  
+  
+-   <xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.TryGetCachedPattern%2A>  
+  
+ パターンがキャッシュ内にない場合、<xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A> で例外が発生し、<xref:System.Windows.Automation.AutomationElement.TryGetCachedPattern%2A> が `false` を返します。  
+  
+ パターン オブジェクトの `Cached` プロパティを使用して、コントロール パターンのキャッシュされたプロパティを取得できます。`Current` プロパティを通じて現在の値を取得することもできますが、<xref:System.Windows.Automation.AutomationElement> が取得されたときに <xref:System.Windows.Automation.AutomationElementMode> が指定されていない場合に限ります。 \(<xref:System.Windows.Automation.AutomationElementMode> は既定値であり、これにより現在の値へのアクセスが許可されます。\)  
+  
+<a name="Retrieving_Cached_Children_and_Parents"></a>   
+## キャッシュされた子と親の取得  
+ <xref:System.Windows.Automation.AutomationElement> を取得し、要求の <xref:System.Windows.Automation.CacheRequest.TreeScope%2A> プロパティを通じてその要素の子のキャッシュを要求すると、その後は、取得した要素の <xref:System.Windows.Automation.AutomationElement.CachedChildren%2A> プロパティから子要素を取得することが可能になります。  
+  
+ <xref:System.Windows.Automation.TreeScope> がキャッシュ要求のスコープに含まれていた場合には、要求のルート要素は、その後、任意の子要素の <xref:System.Windows.Automation.AutomationElement.CachedParent%2A> プロパティから利用できます。  
+  
+> [!NOTE]
+>  要求のルート要素の親または先祖をキャッシュすることはできません。  
+  
+<a name="Updating_the_Cache"></a>   
+## キャッシュの更新  
+ [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] で何も変更されない限り、キャッシュは有効です。 キャッシュの更新は、通常はイベントへの応答として、アプリケーションが行います。  
+  
+ <xref:System.Windows.Automation.CacheRequest> がアクティブな間にイベントにサブスクライブすると、イベント ハンドラーのデリゲートが呼び出されるたびに、イベントのソースとしてキャッシュが更新された <xref:System.Windows.Automation.AutomationElement> を取得します。 また、<xref:System.Windows.Automation.AutomationElement.GetUpdatedCache%2A> を呼び出して、要素のキャッシュされた情報を更新することもできます。 元の <xref:System.Windows.Automation.CacheRequest> を渡して、以前にキャッシュされたすべての情報を更新できます。  
+  
+ キャッシュを更新しても、既存の <xref:System.Windows.Automation.AutomationElement> の参照のプロパティはいずれも変更されません。  
+  
+## 参照  
+ [UI Automation Events for Clients](../../../docs/framework/ui-automation/ui-automation-events-for-clients.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)   
+ [FetchTimer Sample](http://msdn.microsoft.com/ja-jp/5b7d3294-de22-4f24-b2d6-d4785a304b90)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/client-side-ui-automation-provider-implementation.md b/docs/framework/ui-automation/client-side-ui-automation-provider-implementation.md
new file mode 100644
index 00000000000..5494d95185f
--- /dev/null
+++ b/docs/framework/ui-automation/client-side-ui-automation-provider-implementation.md
@@ -0,0 +1,61 @@
+---
+title: "Client-Side UI Automation Provider Implementation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, client-side provider implementation"
+  - "client-side UI Automation provider, implementation"
+  - "provider implementation, UI Automation"
+ms.assetid: 3584c0a1-9cd0-4968-8b63-b06390890ef6
+caps.latest.revision: 14
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 13
+---
+# Client-Side UI Automation Provider Implementation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_ms](../../../includes/tlasharptla-ms-md.md)] のオペレーティング システムでは、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)]、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] など、いくつかの異なる [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] フレームワークが使用されています。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] は、UI 要素に関する情報をクライアントに公開します。 ただし、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 自体は、それらのフレームワークに存在する各種のコントロールや、それらから情報を抽出するために必要な手法を認識しているわけではありません。 その代わりに、このタスクをプロバイダーと呼ばれるオブジェクトに任せます。 プロバイダーは、特定のコントロールから情報を抽出し、その情報を [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] に渡します。次に UI オートメーションが、その情報を一貫性のある方法でクライアントに提示します。  
+  
+ プロバイダーは、サーバー側とクライアント側のどちらにも配置できます。 サーバー側プロバイダーは、コントロール自体によって実装されます。[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] 要素は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] で作成されたすべてのサードパーティ コントロールを考慮してプロバイダーを実装しています。  
+  
+ ただし、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] や [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] に含まれているコントロールなどの比較的古いコントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] を直接サポートしていません。 これらのコントロールは、代わりにクライアント プロセス内のプロバイダーによって処理され、プロセス間通信を使用して、たとえば、コントロール間でのウィンドウ メッセージを監視することで、コントロールに関する情報を取得します。 このようなクライアント側プロバイダーは、プロキシと呼ばれることがあります。  
+  
+ [!INCLUDE[TLA2#tla_winvista](../../../includes/tla2sharptla-winvista-md.md)] には、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)] の標準のコントロール用のプロバイダーが用意されています。 さらに、サーバー側プロバイダーやプロキシで処理されないコントロールでも、[!INCLUDE[TLA#tla_aa](../../../includes/tlasharptla-aa-md.md)] が実装されているコントロールに対しては、代替プロバイダーが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の部分的なサポートを提供します。 これらすべてのプロバイダーは、自動的に読み込まれ、クライアント アプリケーションから使用できるようになります。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コントロールと [!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)] コントロールのサポートの詳細については、「[UI Automation Support for Standard Controls](../../../docs/framework/ui-automation/ui-automation-support-for-standard-controls.md)」を参照してください。  
+  
+ アプリケーションが他のクライアント側プロバイダーを登録することもできます。  
+  
+<a name="Distributing_Client-Side_Providers"></a>   
+## クライアント側プロバイダーを配布する  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、クライアント側プロバイダーがマネージ コード アセンブリ内に見つかることを前提としています。 このアセンブリ内の名前空間は、アセンブリと同じ名前を持つ必要があります。 たとえば、ContosoProxies.dll というアセンブリには、ContosoProxies という名前空間が含まれます。 その名前空間内に、<xref:UIAutomationClientsideProviders.UIAutomationClientSideProviders> クラスを作成します。 静的 <xref:UIAutomationClientsideProviders.UIAutomationClientSideProviders.ClientSideProviderDescriptionTable> フィールドの実装内に、プロバイダーを記述した <xref:System.Windows.Automation.ClientSideProviderDescription> 構造体の配列を作成します。  
+  
+<a name="Registering_and_Configuring_Client-Side_Providers"></a>   
+## クライアント側プロバイダーを登録および構成する  
+ [!INCLUDE[TLA#tla_dll](../../../includes/tlasharptla-dll-md.md)] 内のクライアント側プロバイダーは、<xref:System.Windows.Automation.ClientSettings.RegisterClientSideProviderAssembly%2A> を呼び出すことで読み込まれます。 クライアント アプリケーションでは、プロバイダーを利用するために、それ以上のアクションは必要ありません。  
+  
+ クライアント独自のコードで実装されたプロバイダーは、<xref:System.Windows.Automation.ClientSettings.RegisterClientSideProviders%2A> を使用して登録されます。 このメソッドは引数として、<xref:System.Windows.Automation.ClientSideProviderDescription> 構造体の配列を受け取ります。各構造体では、次のプロパティが指定されます。  
+  
+-   プロバイダー オブジェクトを作成するコールバック関数。  
+  
+-   プロバイダーが使用されるコントロールのクラス名。  
+  
+-   プロバイダーが使用されるアプリケーションのイメージ名 \(通常は実行可能ファイルの完全名\)。  
+  
+-   クラス名と、ターゲット アプリケーションで検出されたウィンドウ クラスを照合する方法を制御するフラグ。  
+  
+ 最後の 2 つのパラメーターは省略できます。 クライアントでは、異なるアプリケーションに対して異なるプロバイダーを使用する必要がある場合、ターゲット アプリケーションのイメージ名を指定することができます。 たとえば、クライアントは、Multiple View パターンをサポートする既知のアプリケーションの [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] リスト ビュー コントロールに対して、あるプロバイダーを使用し、そのパターンをサポートしない別の既知のアプリケーションの同様のコントロールに対して別のプロバイダーを使用できます。  
+  
+## 参照  
+ [Create a Client\-Side UI Automation Provider](../../../docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md)   
+ [Implement UI Automation Providers in a Client Application](../../../docs/framework/ui-automation/implement-ui-automation-providers-in-a-client-application.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md b/docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md
new file mode 100644
index 00000000000..b52311f077e
--- /dev/null
+++ b/docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md
@@ -0,0 +1,87 @@
+---
+title: "Control Pattern Mapping for UI Automation Clients | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, for UI Automation clients"
+  - "UI Automation, clients, control patterns for"
+ms.assetid: 8b81645b-8be3-4e26-9c98-4fb0fceca06b
+caps.latest.revision: 18
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 18
+---
+# Control Pattern Mapping for UI Automation Clients
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、コントロール型とそれに関連するコントロール パターンを示します。  
+  
+ 次の表に、コントロール パターンを次のカテゴリに整理して示します。  
+  
+-   サポートされています。 コントロールはこのコントロール パターンをサポートする必要があります。  
+  
+-   条件付きサポート。 コントロールは、その状態に応じてこのコントロール パターンをサポートする場合があります。  
+  
+-   サポートされていません。 コントロールはこのコントロール パターンをサポートしません。カスタム コントロールは、このコントロール パターンをサポートする場合があります。  
+  
+> [!NOTE]
+>  一部のコントロールは、その機能に応じて複数のコントロール パターンを条件付きでサポートします。 たとえば、メニュー項目コントロールは、メニュー コントロール内での機能に応じて、<xref:System.Windows.Automation.InvokePattern>、<xref:System.Windows.Automation.ExpandCollapsePattern>、<xref:System.Windows.Automation.TogglePattern>、または <xref:System.Windows.Automation.SelectionItemPattern> コントロール パターンを条件付きでサポートします。  
+  
+<a name="control_mapping_clients"></a>   
+## クライアントの UI オートメーション コントロール パターン  
+  
+|コントロール型|サポート状況|条件付きサポート|サポート非対象|  
+|-------------|------------|--------------|-------------|  
+|ボタン|なし|呼び出し、トグル、展開\/折りたたみ|なし|  
+|予定表|グリッド、テーブル|選択、スクロール|値|  
+|チェック ボックス|切り替え|なし|なし|  
+|コンボ ボックス|展開\/折りたたみ|選択、値|スクロール|  
+|データ グリッド|グリッド|スクロール、選択、テーブル|なし|  
+|データ項目|選択項目|展開\/折りたたみ、グリッド項目、スクロール項目、テーブル、トグル、値|なし|  
+|ドキュメント|テキスト|スクロール、値|なし|  
+|編集|なし|テキスト、範囲の値、値|なし|  
+|グループ化|なし|展開\/折りたたみ|なし|  
+|ヘッダー|なし|変換|なし|  
+|ヘッダー項目|なし|変換、呼び出し|なし|  
+|ハイパーリンク|呼び出し|値|なし|  
+|イメージ|なし|グリッド項目、テーブル項目|呼び出し、選択項目|  
+|リスト|なし|グリッド、複数のビュー、スクロール、選択|テーブル|  
+|リスト項目|選択項目|展開\/折りたたみ、グリッド項目、呼び出し、スクロール項目、トグル、値|なし|  
+|メニュー|なし|なし|なし|  
+|メニュー バー|なし|展開\/折りたたみ、ドック、変換|なし|  
+|メニュー項目|なし|展開\/折りたたみ、呼び出し、選択項目、トグル|なし|  
+|ペイン|なし|ドック、 スクロール、変換|ウィンドウ|  
+|進行状況バー|なし|範囲の値、値|なし|  
+|オプション ボタン|選択項目|なし|切り替え|  
+|スクロール バー|なし|範囲値|スクロール|  
+|区切り記号|なし|なし|なし|  
+|スライダー|なし|範囲の値、選択、値|なし|  
+|Spinner|なし|範囲の値、選択、値|なし|  
+|分割ボタン|呼び出し、展開\/折りたたみ|なし|なし|  
+|ステータス バー|なし|グリッド|なし|  
+|タブ|選択ツール|スクロール|なし|  
+|タブ項目|選択項目|なし|呼び出し|  
+|テーブル|グリッド、グリッド項目、テーブル、テーブル項目|なし|なし|  
+|テキスト|なし|グリッド項目、テーブル項目、テキスト|値|  
+|つまみ|変換|なし|なし|  
+|タイトル バー|なし|なし|なし|  
+|ツール バー|なし|ドック、展開\/折りたたみ、変換|なし|  
+|ツール ヒント|なし|テキスト、ウィンドウ|なし|  
+|ツリー|なし|スクロール、選択|なし|  
+|ツリー項目|展開\/折りたたみ|呼び出し、スクロール項目、選択項目、トグル|なし|  
+|ウィンドウ|変換、ウィンドウ|ドッキング|なし|  
+  
+> [!NOTE]
+>  上記のサポート対象のコントロール パターンが存在せず、条件付きサポートのコントロール パターンが 1 つ以上存在するコントロール型では、それらの条件付きコントロール パターンのうちの 1 つが必ずサポートされます。  
+  
+## 参照  
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md b/docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md
new file mode 100644
index 00000000000..49a1d824358
--- /dev/null
+++ b/docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md
@@ -0,0 +1,36 @@
+---
+title: "Create a Client-Side UI Automation Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, creating client-side provider"
+  - "client-side UI Automation provider, creating"
+ms.assetid: d91edaf2-be28-41ec-a508-af421cb43c3d
+caps.latest.revision: 11
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 11
+---
+# Create a Client-Side UI Automation Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、クライアント側 UI オートメーション プロバイダーを実装する方法を示します。  
+  
+## 使用例  
+ コンソール ウィンドウの非常に単純なクライアント側プロバイダーを実装する [!INCLUDE[TLA#tla_dll](../../../includes/tlasharptla-dll-md.md)] に、次のコード例を組み込むことができます。 このコードは、有用な機能は備えていませんが、UI オートメーション クライアント アプリケーションによって登録できるプロバイダー アセンブリを設定する際の基本的な手順を示すために用意されています。  
+  
+ [!code-csharp[UIAClientSideProvider_snip#101](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClientSideProvider_snip/CSharp/CSProviderProgram.cs#101)]
+ [!code-vb[UIAClientSideProvider_snip#101](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClientSideProvider_snip/visualbasic/csproviderprogram.vb#101)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Register a Client\-Side Provider Assembly](../../../docs/framework/ui-automation/register-a-client-side-provider-assembly.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/enable-navigation-in-a-ui-automation-fragment-provider.md b/docs/framework/ui-automation/enable-navigation-in-a-ui-automation-fragment-provider.md
new file mode 100644
index 00000000000..fd8e7ca4f48
--- /dev/null
+++ b/docs/framework/ui-automation/enable-navigation-in-a-ui-automation-fragment-provider.md
@@ -0,0 +1,36 @@
+---
+title: "Enable Navigation in a UI Automation Fragment Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, enabling navigation in provider"
+  - "navigation, enabling in UI Automation provider"
+ms.assetid: 3cb6092a-58c9-4ca0-84a5-0e54d5d00a0d
+caps.latest.revision: 16
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 16
+---
+# Enable Navigation in a UI Automation Fragment Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、フラグメント内の要素に対して UI オートメーション プロバイダーでのナビゲーションを有効にする方法を示します。  
+  
+## 使用例  
+ 次のコード例では、リスト内のリスト項目に対して <xref:System.Windows.Automation.Provider.IRawElementProviderFragment.Navigate%2A> を実装しています。 親要素はリスト ボックス要素で、兄弟要素はそのリスト コレクション内の他の項目です。 このメソッドは正しくない方向の場合に `null` \(Visual Basic では `Nothing`\) を返します。このケースでは、<xref:System.Windows.Automation.Provider.NavigateDirection> と <xref:System.Windows.Automation.Provider.NavigateDirection> がこれに相当します \(要素に子がないため\)。  
+  
+ [!code-csharp[UIAFragmentProvider_snip#103](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFragmentProvider_snip/CSharp/ListItemFragment.cs#103)]
+ [!code-vb[UIAFragmentProvider_snip#103](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFragmentProvider_snip/VisualBasic/ListItemFragment.vb#103)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/expose-a-server-side-ui-automation-provider.md b/docs/framework/ui-automation/expose-a-server-side-ui-automation-provider.md
new file mode 100644
index 00000000000..c83a1fe3f1c
--- /dev/null
+++ b/docs/framework/ui-automation/expose-a-server-side-ui-automation-provider.md
@@ -0,0 +1,37 @@
+---
+title: "Expose a Server-side UI Automation Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "expose a server-side UI Automation provider"
+  - "UI Automation, server-side provider, exposing"
+  - "server-side UI Automation provider, exposing"
+ms.assetid: 55d419c0-2201-4101-90c9-2888df4dbb47
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# Expose a Server-side UI Automation Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックには、<xref:System.Windows.Forms.Control?displayProperty=fullName> ウィンドウにホストされているサーバー側 UI オートメーション プロバイダーを公開する方法を示すコード例が含まれています。  
+  
+ この例は、WM\_GETOBJECT \(クライアント アプリケーションがウィンドウに関する情報を要求したときに、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コア サービスによって送信されるメッセージ\) をトラップするためのウィンドウ プロシージャをオーバーライドします。  
+  
+## 使用例  
+ [!code-csharp[UIAFragmentProvider_snip#116](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFragmentProvider_snip/CSharp/ListFragment.cs#116)]
+ [!code-vb[UIAFragmentProvider_snip#116](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFragmentProvider_snip/VisualBasic/ListFragment.vb#116)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/expose-the-content-of-a-table-using-ui-automation.md b/docs/framework/ui-automation/expose-the-content-of-a-table-using-ui-automation.md
new file mode 100644
index 00000000000..e540b1a2358
--- /dev/null
+++ b/docs/framework/ui-automation/expose-the-content-of-a-table-using-ui-automation.md
@@ -0,0 +1,54 @@
+---
+title: "Expose the Content of a Table Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tables, exposing content of"
+  - "UI Automation, exposing content of tables"
+  - "exposing content of tables using UI Automation"
+ms.assetid: ac3c5eaa-49c7-4653-b83e-532e2a2604a2
+caps.latest.revision: 12
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 12
+---
+# Expose the Content of a Table Using UI Automation
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して、表コントロール内の各セルの内容と各セル固有のプロパティを公開する方法を示します。  
+  
+## 使用例  
+ テーブル セルの内容を表す <xref:System.Windows.Automation.AutomationElement> を取得する方法を次のコード例に示します。行と列のインデックス、行と列の範囲、行と列のヘッダー情報などのセル プロパティも取得します。  この例では、フォーカス変更イベント ハンドラーを使用して、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を実装する表コントロールのキーボード トラバーサルをシミュレートします。  各テーブル項目の情報は、フォーカス変更イベントで公開されます。  
+  
+> [!NOTE]
+>  フォーカス変更はグローバル デスクトップ イベントであるため、テーブルの外部のフォーカス変更イベントにはフィルター処理が必要です。  関連する実装については、「[TrackFocus Sample](http://msdn.microsoft.com/ja-jp/4a91c0af-6bb5-4d38-a743-cf136f268fc9)」を参照してください。  
+  
+ [!code-csharp[UIATableItemPattern_snip#StartTarget](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#starttarget)]
+ [!code-vb[UIATableItemPattern_snip#StartTarget](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#starttarget)]  
+[!code-csharp[UIATableItemPattern_snip#GetTableElement](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#gettableelement)]
+[!code-vb[UIATableItemPattern_snip#GetTableElement](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#gettableelement)]  
+[!code-csharp[UIATableItemPattern_snip#101](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#101)]
+[!code-vb[UIATableItemPattern_snip#101](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#101)]  
+[!code-csharp[UIATableItemPattern_snip#1015](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#1015)]
+[!code-vb[UIATableItemPattern_snip#1015](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#1015)]  
+[!code-csharp[UIATableItemPattern_snip#102](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#102)]
+[!code-vb[UIATableItemPattern_snip#102](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#102)]  
+[!code-csharp[UIATableItemPattern_snip#103](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATableItemPattern_snip/CSharp/UIATableItemPattern_snippets.cs#103)]
+[!code-vb[UIATableItemPattern_snip#103](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATableItemPattern_snip/VisualBasic/UIATableItemPattern_snippets.vb#103)]  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Implementing the UI Automation Table Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md)   
+ [Implementing the UI Automation TableItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md)   
+ [Implementing the UI Automation Grid Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md)   
+ [Implementing the UI Automation GridItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md b/docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md
new file mode 100644
index 00000000000..e122a299648
--- /dev/null
+++ b/docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md
@@ -0,0 +1,40 @@
+---
+title: "Find a UI Automation Element Based on a Property Condition | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "elements, finding by property conditions"
+  - "UI Automation, finding elements by property conditions"
+ms.assetid: 3acaee5a-6ce8-4c3e-81c8-67e59eb74477
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# Find a UI Automation Element Based on a Property Condition
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、特定のプロパティに基づいて [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内の要素を配置する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Automation.AutomationElement> ツリー内の対象の要素 \(1 つまたは複数\) を識別するプロパティ条件のセットを指定します。  一致するすべての要素の検索は、<xref:System.Windows.Automation.AutomationElement.FindAll%2A> メソッドで実行します。このメソッドでは、組み込まれている一連の <xref:System.Windows.Automation.AndCondition> ブール演算により、一致する要素の数を制限します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.AutomationElement.RootElement%2A> から検索するときは、直接の子だけを取得する必要があります。  子孫を検索すると、要素の処理が数百回または数千回も繰り返される場合があるため、スタック オーバーフローが発生する可能性があります。  低いレベルにある特定の要素を取得する場合は、アプリケーション ウィンドウまたは低いレベルのコンテナーから検索を開始する必要があります。  
+  
+ [!code-csharp[InvokePatternApp#1100](../../../samples/snippets/csharp/VS_Snippets_Wpf/InvokePatternApp/CSharp/InvokePatternApp.cs#1100)]
+ [!code-vb[InvokePatternApp#1100](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InvokePatternApp/VisualBasic/Client.vb#1100)]  
+  
+## 参照  
+ [InvokePattern and ExpandCollapsePattern Menu Item Sample](http://msdn.microsoft.com/ja-jp/b7fa141c-e2d1-4da2-a27f-81a7d1172210)   
+ [Obtaining UI Automation Elements](../../../docs/framework/ui-automation/obtaining-ui-automation-elements.md)   
+ [Use the AutomationID Property](../../../docs/framework/ui-automation/use-the-automationid-property.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/find-a-ui-automation-element-for-a-list-item.md b/docs/framework/ui-automation/find-a-ui-automation-element-for-a-list-item.md
new file mode 100644
index 00000000000..cda51c90066
--- /dev/null
+++ b/docs/framework/ui-automation/find-a-ui-automation-element-for-a-list-item.md
@@ -0,0 +1,38 @@
+---
+title: "Find a UI Automation Element for a List Item | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "list items, finding elements for"
+  - "elements, finding for list items"
+  - "UI Automation, finding elements for List items"
+ms.assetid: c326ad2b-2144-4f64-ae4c-d850c74f95c5
+caps.latest.revision: 5
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 5
+---
+# Find a UI Automation Element for a List Item
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、項目のインデックスがわかっている場合に、リスト内の項目の <xref:System.Windows.Automation.AutomationElement> を取得する方法を示します。  
+  
+## 使用例  
+ リストから指定した項目を取得する 2 つの方法を次の例に示します。1 つは、<xref:System.Windows.Automation.TreeWalker> を使用し、もう 1 つは、<xref:System.Windows.Automation.AutomationElement.FindAll%2A> を使用します。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コントロールでは最初の手法の方が速く、[!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] コントロールでは 2 番目の手法の方が速い傾向にあります。  
+  
+ [!code-csharp[UIAClient_snip#184](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#184)]
+ [!code-vb[UIAClient_snip#184](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#184)]  
+  
+## 参照  
+ [Obtaining UI Automation Elements](../../../docs/framework/ui-automation/obtaining-ui-automation-elements.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md b/docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md
new file mode 100644
index 00000000000..b02203e2fe6
--- /dev/null
+++ b/docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md
@@ -0,0 +1,43 @@
+---
+title: "Find and Highlight Text Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "text, highlighting"
+  - "finding text"
+  - "text, finding"
+  - "UI automation, highlighting text"
+  - "UI automation, finding text"
+  - "highlighting text"
+ms.assetid: b77693f5-87bb-4b29-a297-05ff882e2044
+caps.latest.revision: 15
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 15
+---
+# Find and Highlight Text Using UI Automation
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して、テキスト コントロールのコンテンツ内で順次検索し、見つかった文字列をそれぞれ強調表示する方法を示します。  
+  
+## 使用例  
+ テキスト コントロールから <xref:System.Windows.Automation.TextPattern> オブジェクトを取得する例を次に示します。  <xref:System.Windows.Automation.Text.TextPatternRange> オブジェクトは、ドキュメント全体のテキスト コンテンツを表し、この <xref:System.Windows.Automation.TextPattern> の <xref:System.Windows.Automation.TextPattern.DocumentRange%2A> プロパティを使用して作成されます。  次に、2 つの追加 <xref:System.Windows.Automation.Text.TextPatternRange> オブジェクトが、順次検索機能および強調表示機能用に作成されます。  
+  
+ [!code-csharp[FindText#StartApp](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#startapp)]
+ [!code-vb[FindText#StartApp](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#startapp)]  
+[!code-csharp[FindText#FindTextProvider](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#findtextprovider)]
+[!code-vb[FindText#FindTextProvider](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#findtextprovider)]  
+[!code-csharp[FindText#SearchTarget](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#searchtarget)]
+[!code-vb[FindText#SearchTarget](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#searchtarget)]  
+  
+## 参照  
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/get-supported-ui-automation-control-patterns.md b/docs/framework/ui-automation/get-supported-ui-automation-control-patterns.md
new file mode 100644
index 00000000000..4725ae57c66
--- /dev/null
+++ b/docs/framework/ui-automation/get-supported-ui-automation-control-patterns.md
@@ -0,0 +1,51 @@
+---
+title: "サポートされている UI オートメーション コントロール パターンの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "取得するコントロール パターン"
+  - "UI オートメーション、コントロール パターンの取得"
+  - "コントロール パターンを取得します。"
+ms.assetid: 006c54c9-50bf-48d9-a855-9d62eb95603a
+caps.latest.revision: 10
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 10
+---
+# サポートされている UI オートメーション コントロール パターンの取得
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックからのコントロール パターンのオブジェクトを取得する方法を示しています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]要素。  
+  
+### <a name="obtain-all-control-patterns"></a>すべてのコントロール パターンの取得  
+  
+1.  取得、 <xref:System.Windows.Automation.AutomationElement>関心のあるパターンを制御します。  
+  
+2.  呼び出す<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>要素からすべてのコントロール パターンを取得します。  
+  
+> [!CAUTION]
+>  クライアントが使用しないことを強くお勧め<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>します。 パフォーマンスにこのメソッドは、深刻な影響<xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A>の各既存のコントロール パターンを内部的にします。 可能であれば、クライアントが呼び出す必要があります<xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A>の関心のある主要なパターンです。  
+  
+### <a name="obtain-a-specific-control-pattern"></a>特定のコントロール パターンの取得  
+  
+1.  取得、 <xref:System.Windows.Automation.AutomationElement>関心のあるパターンを制御します。  
+  
+2.  呼び出す<xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A>または<xref:System.Windows.Automation.AutomationElement.TryGetCurrentPattern%2A>の特定のパターンを照会します。 これらのメソッドは、のようなパターンが見つからない場合は<xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A>で例外が発生し、 <xref:System.Windows.Automation.AutomationElement.TryGetCurrentPattern%2A>を返します`false`します。  
+  
+## <a name="example"></a>例  
+ 次の例では取得、 <xref:System.Windows.Automation.AutomationElement>リスト項目の取得と、 <xref:System.Windows.Automation.SelectionItemPattern>その要素から。  
+  
+ [!code-csharp[UIAClient_snip#103](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#103)]
+ [!code-vb[UIAClient_snip#103](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#103)]  
+  
+## <a name="see-also"></a>関連項目  
+ [クライアントの UI オートメーション コントロール パターン](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md b/docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md
new file mode 100644
index 00000000000..eabba354f90
--- /dev/null
+++ b/docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md
@@ -0,0 +1,33 @@
+---
+title: "Get the Toggle State of a Check Box Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, getting toggle states of check boxes"
+  - "check boxes, getting toggle states of"
+  - "getting, toggle states of check boxes"
+ms.assetid: 84fc31a3-175f-4e93-90a0-dd29d89b77ce
+caps.latest.revision: 10
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 10
+---
+# Get the Toggle State of a Check Box Using UI Automation
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用してコントロールのトグル状態を取得する方法を示します。  
+  
+## 使用例  
+ この例では、<xref:System.Windows.Automation.AutomationElement> クラスの <xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A> メソッドを使用して、コントロールから <xref:System.Windows.Automation.TogglePattern> オブジェクトを取得し、その <xref:System.Windows.Automation.ToggleState> プロパティを返します。  
+  
+ [!code-csharp[NavigatingWithTreeWalker#1200](../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigatingWithTreeWalker/CSharp/ClientClass.cs#1200)]
+ [!code-vb[NavigatingWithTreeWalker#1200](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigatingWithTreeWalker/visualbasic/clientclass.vb#1200)]
\ No newline at end of file
diff --git a/docs/framework/ui-automation/get-ui-automation-element-properties.md b/docs/framework/ui-automation/get-ui-automation-element-properties.md
new file mode 100644
index 00000000000..d0419a2b897
--- /dev/null
+++ b/docs/framework/ui-automation/get-ui-automation-element-properties.md
@@ -0,0 +1,49 @@
+---
+title: "Get UI Automation Element Properties | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "properties, retrieving"
+  - "UI Automation, retrieving properties of elements"
+ms.assetid: 09576b1a-291f-435c-980e-dee32d899ae1
+caps.latest.revision: 5
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 5
+---
+# Get UI Automation Element Properties
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]要素のプロパティを取得する方法について説明します。  
+  
+### 現在のプロパティ値の取得  
+  
+1.  取得するプロパティを持つ <xref:System.Windows.Automation.AutomationElement> を取得します。  
+  
+2.  <xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A> を呼び出すか、または <xref:System.Windows.Automation.AutomationElement.Current%2A> プロパティ構造体を取得し、そのメンバーの 1 つから値を取得します。  
+  
+### キャッシュされたプロパティ値の取得  
+  
+1.  取得するプロパティを持つ <xref:System.Windows.Automation.AutomationElement> を取得します。  プロパティは、<xref:System.Windows.Automation.CacheRequest> で指定されている必要があります。  
+  
+2.  <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A> を呼び出すか、または <xref:System.Windows.Automation.AutomationElement.Cached%2A> プロパティ構造体を取得し、そのメンバーの 1 つから値を取得します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Automation.AutomationElement> の現在のプロパティを取得するためのさまざまな方法を示します。  
+  
+ [!code-csharp[UIAClient_snip#170](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#170)]
+ [!code-vb[UIAClient_snip#170](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#170)]  
+  
+## 参照  
+ [UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)   
+ [Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implement-ui-automation-providers-in-a-client-application.md b/docs/framework/ui-automation/implement-ui-automation-providers-in-a-client-application.md
new file mode 100644
index 00000000000..152c0ede966
--- /dev/null
+++ b/docs/framework/ui-automation/implement-ui-automation-providers-in-a-client-application.md
@@ -0,0 +1,40 @@
+---
+title: "Implement UI Automation Providers in a Client Application | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "client-side UI Automation provider, implementation within applications"
+  - "UI Automation, implementing client-side provider within application"
+ms.assetid: f325f0d8-1715-41ea-85ca-45b82ffea8bc
+caps.latest.revision: 6
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 6
+---
+# Implement UI Automation Providers in a Client Application
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、アプリケーション内のクライアント側 UI オートメーション プロバイダーを実装する方法を示します。  
+  
+ これは、一般的ではないシナリオです。 通常は、UI オートメーション クライアント アプリケーションは、サーバー側プロバイダーを使用するか、または DLL 内に存在するクライアント側プロバイダーを使用します。  
+  
+## 使用例  
+ 次のコード例では、コンソール ウィンドウ用の簡単なプロバイダーを実装します。 このコードは、有用な機能は備えていませんが、クライアント コード内でプロバイダーを設定し、<xref:System.Windows.Automation.ClientSettings.RegisterClientSideProviders%2A> を使用して登録する際の基本的な手順を示すために用意されています。  
+  
+ [!code-csharp[UIAClientSideProvider_snip#201](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClientSideProvider_snip/CSharp/ClientImplementationProgram.cs#201)]
+ [!code-vb[UIAClientSideProvider_snip#201](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClientSideProvider_snip/visualbasic/clientimplementationprogram.vb#201)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Register a Client\-Side Provider Assembly](../../../docs/framework/ui-automation/register-a-client-side-provider-assembly.md)   
+ [Create a Client\-Side UI Automation Provider](../../../docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md)   
+ [Client\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/client-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-dock-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-dock-control-pattern.md
new file mode 100644
index 00000000000..827782e24f4
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-dock-control-pattern.md
@@ -0,0 +1,70 @@
+---
+title: "Implementing the UI Automation Dock Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, dock"
+  - "dock control pattern"
+  - "UI Automation, dock control pattern"
+ms.assetid: ea3d2212-7c8e-4dd7-bf08-73141ca2d4fb
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# Implementing the UI Automation Dock Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、プロパティに関する情報など、<xref:System.Windows.Automation.Provider.IDockProvider> を実装するガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.DockPattern> コントロール パターンは、ドッキング コンテナー内のコントロールのドッキング プロパティを公開するために使用します。 ドッキング コンテナーは、子要素を互いに水平方向または垂直方向に整列できるコントロールです。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+ ![ドッキングされた 2 つの子を持つドッキング コンテナー。](../../../docs/framework/ui-automation/media/uia-dockpattern-dockingexample.PNG "UIA\_DockPattern\_DockingExample")  
+"Class View" ウィンドウが DockPosition.Right に "Error List" ウィンドウが DockPosition.Bottom にそれぞれ配置された Visual Studio のドッキングの例  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Dock コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。  
+  
+-   <xref:System.Windows.Automation.Provider.IDockProvider> は、ドッキング コンテナーのプロパティや、ドッキング コンテナー内の現在のコントロールに隣接してドッキングされるコントロールのプロパティは公開しません。  
+  
+-   コントロールは、現在の重ね順に基づき、互いを基準としてドッキングされます。重ね順が上位であるほど、指定されたドッキング コンテナーの端から離れた位置に配置されます。  
+  
+-   ドッキング コンテナーのサイズを変更すると、コンテナー内にドッキングされているコントロールは、もともとドッキングされていたのと同じ端に合わせて再配置されます。 また、ドッキングされているコントロールは、<xref:System.Windows.Automation.DockPosition> のドッキング動作に従って、コンテナー内のスペースを埋めるようにサイズ変更されます。 たとえば、<xref:System.Windows.Automation.DockPosition> が指定されている場合は、コントロールの左側と右側が広がって、使用できるスペースを埋めます。<xref:System.Windows.Automation.DockPosition> が指定されている場合は、コントロールの 4 つの側面すべてが広がって、使用できるスペースを埋めます。  
+  
+-   マルチモニター システムでは、コントロールは現在のモニターの左側または右側にドッキングする必要があります。 それが不可能な場合は、左端のモニターの左側、または右端のモニターの右側にドッキングする必要があります。  
+  
+<a name="Required_Members_for_IDockProvider"></a>   
+## IDockProvider の必須メンバー  
+ 次のプロパティとメソッドは、IDockProvider インターフェイスの実装時に必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IDockProvider.DockPosition%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IDockProvider.SetDockPosition%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.IDockProvider.SetDockPosition%2A><br /><br /> -   要求されたドッキング スタイルをコントロールが実行することができない場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-expandcollapse-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-expandcollapse-control-pattern.md
new file mode 100644
index 00000000000..ff7862b6170
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-expandcollapse-control-pattern.md
@@ -0,0 +1,79 @@
+---
+title: "Implementing the UI Automation ExpandCollapse Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, ExpandCollapse control pattern"
+  - "ExpandCollapse control pattern"
+  - "control patterns, ExpandCollapse"
+ms.assetid: 1dbabb8c-0d68-47c1-a35e-1c01cb01af26
+caps.latest.revision: 25
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 25
+---
+# Implementing the UI Automation ExpandCollapse Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、プロパティ、メソッド、イベントに関する情報など、<xref:System.Windows.Automation.Provider.IExpandCollapseProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.ExpandCollapsePattern> コントロール パターンは、視覚的に展開してより多くのコンテンツを表示したり、折りたたんでコンテンツを非表示にしたりするコントロールをサポートするために使用します。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ ExpandCollapse コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。  
+  
+-   展開または折りたたみの機能を備えた UI を提供する子オブジェクトで構成された集約コントロールは、<xref:System.Windows.Automation.ExpandCollapsePattern> コントロール パターンをサポートする必要がありますが、その子要素がサポートする必要はありません。 たとえば、コンボ ボックス コントロールは、リスト ボックス、ボタン、およびエディット コントロールの組み合わせで構成されていますが、<xref:System.Windows.Automation.ExpandCollapsePattern> をサポートする必要があるのは親のコンボ ボックスのみです。  
+  
+    > [!NOTE]
+    >  メニュー コントロールは例外であり、これは個々の MenuItem オブジェクトの集合体です。 MenuItem オブジェクトは <xref:System.Windows.Automation.ExpandCollapsePattern> コントロール パターンをサポートできますが、親の Menu コントロールはできません。 同様の例外が、Tree および Tree Item コントロールにも適用されます。  
+  
+-   コントロールの <xref:System.Windows.Automation.ExpandCollapseState> が <xref:System.Windows.Automation.ExpandCollapseState> に設定されている場合、コントロールに対して現在アクティブな <xref:System.Windows.Automation.ExpandCollapsePattern> 機能は存在せず、このコントロール パターンを使用して取得できる情報は <xref:System.Windows.Automation.ExpandCollapseState> だけです。 その後、子オブジェクトが追加された場合は、<xref:System.Windows.Automation.ExpandCollapseState> が変更され、<xref:System.Windows.Automation.ExpandCollapsePattern> 機能がアクティブになります。  
+  
+-   <xref:System.Windows.Automation.ExpandCollapseState> は、すべての子孫オブジェクトの可視性を表すのではなく、直接の子オブジェクトの可視性のみを表します。  
+  
+-   展開および折りたたみ機能は、コントロールに固有の機能です。 この機能の動作例を次に示します。  
+  
+    -   Office Personal のメニューには、3 つの状態を示す MenuItem \(<xref:System.Windows.Automation.ExpandCollapseState>、<xref:System.Windows.Automation.ExpandCollapseState>、および <xref:System.Windows.Automation.ExpandCollapseState>\) を指定できます。この場合、<xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A> または <xref:System.Windows.Automation.ExpandCollapsePattern.Collapse%2A> を呼び出したときに選択される状態は、コントロールによって指定されます。  
+  
+    -   TreeItem で <xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A> を呼び出すと、すべての子孫または直接の子のみを表示できます。  
+  
+    -   コントロールでの <xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A> または <xref:System.Windows.Automation.ExpandCollapsePattern.Collapse%2A> の呼び出しによってその子孫の状態が維持されるとき、状態の変更イベントではなく、可視性の変更イベントが送信されます。折りたたみの実行時に親コントロールが子孫の状態を維持しないときは、コントロールが表示されなくなったすべての子孫を破棄し、破棄イベントを発生させる場合と、子孫ごとに <xref:System.Windows.Automation.Provider.IExpandCollapseProvider.ExpandCollapseState%2A> を変更して、可視性の変更イベントを発生させる場合があります。  
+  
+-   ナビゲーションを確実にするには、オブジェクトを親の <xref:System.Windows.Automation.ExpandCollapseState> に関係なく、\(可視性の状態が適切な\) [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内に配置することをお勧めします。 子孫が必要に応じて生成される場合、それらが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーに表示されるのは、初回の表示以降か、または可視状態になっている間に限られます。  
+  
+<a name="Required_Members_for_the_IValueProvider_Interface"></a>   
+## IExpandCollapseProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.IExpandCollapseProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider.ExpandCollapseState%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePattern.Collapse%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.AutomationPropertyChangedEventHandler>|Event|このコントロールには関連付けられているイベントがありません。この汎用デリゲートを使用します。|  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.ExpandCollapseState> \= <xref:System.Windows.Automation.ExpandCollapseState> の場合、<xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A> または <xref:System.Windows.Automation.ExpandCollapsePattern.Collapse%2A> のどちらかが呼び出されます。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Navigate Among UI Automation Elements with TreeWalker](../../../docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md
new file mode 100644
index 00000000000..9920df26ea5
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md
@@ -0,0 +1,79 @@
+---
+title: "Implementing the UI Automation Grid Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, grid"
+  - "grid control pattern"
+  - "UI Automation, grid control pattern"
+ms.assetid: 234d11a0-7ce7-4309-8989-2f4720e02f78
+caps.latest.revision: 27
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 27
+---
+# Implementing the UI Automation Grid Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、プロパティ、メソッド、イベントに関する情報など、<xref:System.Windows.Automation.Provider.IGridProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.GridPattern> コントロール パターンは、子要素のコレクションのコンテナーとして機能するコントロールをサポートするために使用します。 この要素の子には <xref:System.Windows.Automation.Provider.IGridItemProvider> を実装する必要があります。また、この要素の子は、行と列で表現できる 2 次元の論理座標システムで編成しなければなりません。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Grid コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。  
+  
+-   グリッド座標は 0 から始まり、左上 \(ロケールによっては右上\) のセルの座標が \(0,0\) になります。  
+  
+-   セルが空の場合でも、そのセルの <xref:System.Windows.Automation.Provider.IGridItemProvider.ContainingGrid%2A> プロパティをサポートするために、UI オートメーション要素を返す必要があります。 これが可能なのは、グリッド内の子要素のレイアウトが不調和配列に似ている場合です \(次の例を参照\)。  
+  
+ ![不規則なレイアウトを示す Windows エクスプローラー ビュー。](../../../docs/framework/ui-automation/media/uia-gridpattern-ragged-array.PNG "UIA\_GridPattern\_Ragged\_Array")  
+空の座標を持つグリッド コントロールの例  
+  
+-   項目が 1 つのグリッドでも、論理的にグリッドであると見なされる場合は、<xref:System.Windows.Automation.Provider.IGridProvider> を実装する必要があります。 グリッド内の子項目の数は問題ではありません。  
+  
+-   プロバイダーの実装によっては、非表示の行および列は [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーに読み込まれ、<xref:System.Windows.Automation.GridPattern.GridPatternInformation.RowCount%2A> プロパティおよび <xref:System.Windows.Automation.GridPattern.GridPatternInformation.ColumnCount%2A> プロパティに反映されます。 読み込まれていない場合は、非表示の行および列はカウントされません。  
+  
+-   <xref:System.Windows.Automation.Provider.IGridProvider> はグリッドのアクティブな操作を有効にしないため、<xref:System.Windows.Automation.Provider.ITransformProvider> を実装してこの機能を有効にする必要があります。  
+  
+-   <xref:System.Windows.Automation.StructureChangedEventHandler> を使用すると、追加、削除、マージされたセルなど、グリッドの構造またはレイアウトの変更をリッスンできます。  
+  
+-   <xref:System.Windows.Automation.AutomationFocusChangedEventHandler> を使用すると、グリッドの項目またはセルの反復処理を追跡できます。  
+  
+<a name="Required_Members_for_IGridProvider"></a>   
+## IGridProvider の必須メンバー  
+ IGridProvider インターフェイスの実装時には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|型|ノート|  
+|------------|-------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridProvider.RowCount%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridProvider.ColumnCount%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridProvider.GetItem%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.Windows.Automation.Provider.IGridProvider.GetItem%2A><br /><br /> -   要求された行座標が <xref:System.Windows.Automation.Provider.IGridProvider.RowCount%2A> より大きい、または列座標が <xref:System.Windows.Automation.Provider.IGridProvider.ColumnCount%2A> より大きい。|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.Windows.Automation.Provider.IGridProvider.GetItem%2A><br /><br /> -   要求された行座標または列座標が 0 未満である。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Implementing the UI Automation GridItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md
new file mode 100644
index 00000000000..578ca57fc9a
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md
@@ -0,0 +1,67 @@
+---
+title: "UI オートメーション GridItem コントロール パターンの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GridItem コントロール パターン"
+  - "UI オートメーション GridItem コントロール パターン"
+  - "GridItem コントロール パターン"
+ms.assetid: bffbae08-fe2a-42fd-ab84-f37187518916
+caps.latest.revision: 15
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 15
+---
+# UI オートメーション GridItem コントロール パターンの実装
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックでは、実装するため<xref:System.Windows.Automation.Provider.IGridItemProvider>、プロパティに関する情報などです。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.GridItemPattern>コントロール パターンが実装したコンテナーの個々 の子コントロールをサポートするために使用される<xref:System.Windows.Automation.Provider.IGridProvider>します。 このコントロール パターンを実装するコントロールの例については、次を参照してください。 [UI オートメーション クライアントのコントロール パターン マッピング](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)します。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## <a name="implementation-guidelines-and-conventions"></a>実装のガイドラインと規則  
+ 実装するときに<xref:System.Windows.Automation.Provider.IGridProvider>、次のガイドラインと規則に注意してください。  
+  
+-   グリッドの座標は 0 から始まり、左上のセルの座標が (0, 0) です。  
+  
+-   結合されたセルが報告されます、<xref:System.Windows.Automation.Provider.IGridItemProvider.Row%2A>と<xref:System.Windows.Automation.Provider.IGridItemProvider.Column%2A>プロパティは、UI オートメーション プロバイダーで定義されている、基になるアンカー セルに基づいています。 通常、これは、最上位の左端の行または列です。  
+  
+-   <xref:System.Windows.Automation.Provider.IGridItemProvider>は、グリッドの結合またはセルの分割などのアクティブな操作を提供しません。  
+  
+-   実装するコントロール<xref:System.Windows.Automation.Provider.IGridItemProvider>走査できる通常 (つまり、UI オートメーション クライアントが隣接するコントロールに移動できる)、キーボードを使用しています。  
+  
+<a name="Required_Members_for_IGridItemProvider"></a>   
+## <a name="required-members-for-igriditemprovider"></a>IGridItemProvider の必須メンバー  
+ 次のプロパティとメソッドを実装するために必要な<xref:System.Windows.Automation.Provider.IGridItemProvider>します。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|----------------------|-----------------|-----------|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider.Row%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider.Column%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider.RowSpan%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider.ColumnSpan%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider.ContainingGrid%2A>|プロパティ|なし|  
+  
+ このコントロール パターンに関連するメソッドまたはイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## <a name="exceptions"></a>例外  
+ このコントロール パターンに関連付けられる例外はありません。  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーション コントロール パターンの概要](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI オートメーション プロバイダーでコントロール パターンをサポートします。](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [クライアントの UI オートメーション コントロール パターン](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI オートメーション Grid コントロール パターンの実装](../../../docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md)   
+ [UI オートメーション ツリーの概要](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [UI オートメーションにおけるキャッシュを使用します。](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-invoke-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-invoke-control-pattern.md
new file mode 100644
index 00000000000..382443b51d7
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-invoke-control-pattern.md
@@ -0,0 +1,82 @@
+---
+title: "Implementing the UI Automation Invoke Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Invoke control pattern"
+  - "control patterns, Invoke"
+  - "Invoke control pattern"
+ms.assetid: e5b1e239-49f8-468e-bfec-1fba02ec9ac4
+caps.latest.revision: 31
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 30
+---
+# Implementing the UI Automation Invoke Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IInvokeProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.InvokePattern> コントロール パターンは、アクティブになったときに状態を保持せずに単一の明確なアクションを開始または実行するコントロールをサポートするために使用されます。 チェック ボックスやオプション ボタンなどの状態を保持するコントロールは、代わりに <xref:System.Windows.Automation.Provider.IToggleProvider> と <xref:System.Windows.Automation.Provider.ISelectionItemProvider> をそれぞれ実装する必要があります。 Invoke コントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Invoke コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。  
+  
+-   別のコントロール パターン プロバイダーを通じて同じ動作が公開されていない場合、コントロールは <xref:System.Windows.Automation.Provider.IInvokeProvider> を実装します。 たとえば、コントロールの <xref:System.Windows.Automation.InvokePattern.Invoke%2A> メソッドが <xref:System.Windows.Automation.ExpandCollapsePattern.Expand%2A> メソッドまたは <xref:System.Windows.Automation.ExpandCollapsePattern.Collapse%2A> メソッドと同じ処理を実行する場合、コントロールに <xref:System.Windows.Automation.Provider.IInvokeProvider> を実装しないようにします。  
+  
+-   通常、コントロールの呼び出しは、クリックまたはダブルクリックするか、Enter キー、定義済みのキーボード ショートカット、または何らかの代替的なキーの組み合わせを押すことによって実行されます。  
+  
+-   \(関連付けられたアクションを実行したコントロールへの応答として\) アクティブ化されたコントロールで <xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent> が生成されます。 可能な場合は、コントロールがアクションを完了し、ブロックせずに戻った後に、イベントを生成する必要があります。 次のシナリオでは、Invoke 要求を処理する前に Invoked イベントを生成する必要があります。  
+  
+    -   処理が完了するまで待機することが不可能または非現実的である。  
+  
+    -   処理にユーザー操作が必要になる。  
+  
+    -   アクションに時間がかかり、呼び出し側のクライアントを長時間ブロックする。  
+  
+-   コントロールの呼び出しに大きな副作用が伴う場合は、その副作用を、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.HelpText%2A> プロパティを介して公開する必要があります。 たとえば、<xref:System.Windows.Automation.Provider.IInvokeProvider.Invoke%2A> が選択に関連付けられていない場合でも、<xref:System.Windows.Automation.Provider.IInvokeProvider.Invoke%2A> によって別のコントロールが選択された状態になることがあります。  
+  
+-   ホバー \(マウス オーバー\) 効果は、一般に Invoked イベントを発生させません。 ただし、ホバー状態に基づいて \(視覚効果を発生させることなく\) アクションを実行するコントロールは、<xref:System.Windows.Automation.InvokePattern> コントロール パターンをサポートする必要があります。  
+  
+> [!NOTE]
+>  マウス関連の副作用の結果として呼び出す以外にコントロールを呼び出す方法がない場合、そのような実装はユーザー補助に問題があるものと見なされます。  
+  
+-   コントロールの呼び出しは、項目の選択とは異なります。 ただし、コントロールによっては、その呼び出しの副作用として、項目が選択された状態になることがあります。 たとえば、My Documents フォルダー内にある [!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] ドキュメントのリスト項目を呼び出すと、その項目が選択され、ドキュメントが開きます。  
+  
+-   要素は、呼び出されるとすぐに [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーから消える場合があります。 そのため、イベント コールバックで提供された要素に情報を要求すると失敗することがあります。 推奨される回避策は、キャッシュされた情報をプリフェッチすることです。  
+  
+-   コントロールは、複数のコントロール パターンを実装できます。 たとえば、[!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)] ツール バーの \[塗りつぶしの色\] コントロールは、<xref:System.Windows.Automation.InvokePattern> コントロール パターンと <xref:System.Windows.Automation.ExpandCollapsePattern> コントロール パターンを実装しています。<xref:System.Windows.Automation.ExpandCollapsePattern> はメニューを公開し、<xref:System.Windows.Automation.InvokePattern> は選択された色でアクティブな選択内容を塗りつぶします。  
+  
+<a name="Required_Members_for_the_IValueProvider_Interface"></a>   
+## IInvokeProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.IInvokeProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider.Invoke%2A>|メソッド|<xref:System.Windows.Automation.Provider.IInvokeProvider.Invoke%2A> は非同期呼び出しであるため、クライアントをブロックせずに即座に戻る必要があります。<br /><br /> 呼び出されたときにモーダル ダイアログを直接的または間接的に表示するコントロールでは、この動作は特に重要です。 イベントを発生させたすべての UI オートメーション クライアントは、モーダル ダイアログが閉じられるまで、ブロックされたままになります。|  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.Windows.Automation.ElementNotEnabledException>|コントロールが有効ではない。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Invoke a Control Using UI Automation](../../../docs/framework/ui-automation/invoke-a-control-using-ui-automation.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-multipleview-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-multipleview-control-pattern.md
new file mode 100644
index 00000000000..2f14d467574
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-multipleview-control-pattern.md
@@ -0,0 +1,71 @@
+---
+title: "Implementing the UI Automation MultipleView Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, MultipleView control pattern"
+  - "MultipleView control pattern"
+  - "control patterns, MultipleView"
+ms.assetid: 5bf1b248-ffee-48c8-9613-0b134bbe9f6a
+caps.latest.revision: 15
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 15
+---
+# Implementing the UI Automation MultipleView Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IMultipleViewProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.MultipleViewPattern> コントロール パターンは、同じ情報セットまたは子コントロールの複数の表現を提供し、それらの表現を切り替えることができるコントロールをサポートするために使用します。  
+  
+ 複数のビューを表示できるコントロールの例には、リスト ビュー \(サムネイル、タイル、アイコン、または詳細の形でコンテンツを表示できる\)、[!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)] チャート \(円、線、棒、式を含むセル値\)、[!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] 文書 \(標準、Web レイアウト、印刷レイアウト、閲覧レイアウト、アウトライン\)、[!INCLUDE[TLA#tla_outlook](../../../includes/tlasharptla-outlook-md.md)] カレンダー \(年、月、週、日\)、[!INCLUDE[TLA#tla_wmp](../../../includes/tlasharptla-wmp-md.md)] スキンなどがあります。 サポートされるビューはコントロールの開発者によって決定され、各コントロールに固有です。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Multiple View コントロール パターンを実装する場合は、次のガイドラインと規則にご注意ください。  
+  
+-   現在のビューを管理するコンテナーが現在のビューを提供するコントロールとは異なる場合は、現在のビューを管理するためのコンテナーにも <xref:System.Windows.Automation.Provider.IMultipleViewProvider> を実装する必要があります。 たとえば、Windows エクスプローラーには現在のフォルダーのコンテンツの List コントロールが含まれていますが、そのコントロールのビューは Windows エクスプローラーのアプリケーションから管理されています。  
+  
+-   自身のコンテンツを並べ替えることができるコントロールは、複数のビューをサポートしているとは見なされません。  
+  
+-   ビューのコレクションは、インスタンス間で同じである必要があります。  
+  
+-   ビューの名前は、読み上げ、ブライユ点字、その他の人間が判読できるアプリケーションでの使用に適した名前にする必要があります。  
+  
+<a name="Required_Members_for_IMultipleViewProvider"></a>   
+## IMultipleViewProvider の必須メンバー  
+ IMultipleViewProvider の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IMultipleViewProvider.CurrentView%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IMultipleViewProvider.GetSupportedViews%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.IMultipleViewProvider.GetViewName%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.IMultipleViewProvider.SetCurrentView%2A>|メソッド|なし|  
+  
+ このコントロールのパターンに関連付けられているイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.ArgumentException>|<xref:System.Windows.Automation.Provider.IMultipleViewProvider.SetCurrentView%2A> または <xref:System.Windows.Automation.Provider.IMultipleViewProvider.GetViewName%2A> が、サポートされているビュー コレクションのメンバーではないパラメーターで呼び出された場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-rangevalue-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-rangevalue-control-pattern.md
new file mode 100644
index 00000000000..d6c6a48806e
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-rangevalue-control-pattern.md
@@ -0,0 +1,70 @@
+---
+title: "Implementing the UI Automation RangeValue Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, Range Value"
+  - "Range Value control pattern"
+  - "UI Automation, Range Value control pattern"
+ms.assetid: 225feaa4-918e-418b-938e-7389338d0a69
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# Implementing the UI Automation RangeValue Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IRangeValueProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.RangeValuePattern> コントロール パターンは、一定の範囲内の値に設定できるコントロールをサポートするために使用します。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Range Value コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。  
+  
+-   コントロールでは、ロケールまたはユーザー設定に基づいてサポートされているプロパティを再調整できます。 たとえば、温度計コントロールを、華氏または摂氏で温度を表示するように設定できます。  
+  
+-   進行状況バーやスライダーなどのあいまいな範囲の値を持つコントロールでは、それらの値を正規化する必要があります。  
+  
+ ![進行状況バー。](../../../docs/framework/ui-automation/media/uia-rangevaluepattern-progress-bar.PNG "UIA\_RangeValuePattern\_Progress\_Bar")  
+値が整数型で、最小値と最大値のプロパティ値がそれぞれ 0 と 100 に正規化された進行状況バーの例  
+  
+<a name="Required_Members_for_the_IRangeValueProvider"></a>   
+## IRangeValueProvider の必須メンバー  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.RangeValuePattern.IsReadOnlyProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.ValueProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.LargeChangeProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.SmallChangeProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.MaximumProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.MinimumProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.RangeValuePattern.SetValue%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.Windows.Automation.RangeValuePattern.SetValue%2A> は、<xref:System.Windows.Automation.RangeValuePattern.MaximumProperty> より大きい値または <xref:System.Windows.Automation.RangeValuePattern.MinimumProperty> より小さい値で呼び出されます。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-scroll-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-scroll-control-pattern.md
new file mode 100644
index 00000000000..2c5ced882ac
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-scroll-control-pattern.md
@@ -0,0 +1,85 @@
+---
+title: "Implementing the UI Automation Scroll Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Scroll control pattern"
+  - "control patterns, Scroll"
+  - "Scroll control pattern"
+ms.assetid: 73d64242-6cbb-424c-92dd-dc69530b7899
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# Implementing the UI Automation Scroll Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IScrollProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、このトピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.ScrollPattern> コントロール パターンは、子オブジェクトのコレクションのスクロール可能なコンテナーとして機能するコントロールをサポートするために使用します。 通常は、スクロール バーを使用してスクロール機能をサポートするためにコントロールが必要ですが、ここでは必要ありません。  
+  
+ ![スクロール バーのないスクロール コントロール。](../../../docs/framework/ui-automation/media/uia-scrollpattern-without-scrollbars.PNG "UIA\_ScrollPattern\_Without\_Scrollbars")  
+スクロール バーを使用しないスクロール コントロールの例  
+  
+ このコントロールを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ スクロール コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。  
+  
+-   このコントロールの子は <xref:System.Windows.Automation.Provider.IScrollItemProvider> を実装する必要があります。  
+  
+-   コンテナー コントロールのスクロール バーは <xref:System.Windows.Automation.ScrollPattern> コントロール パターンをサポートしません。 代わりに、<xref:System.Windows.Automation.RangeValuePattern> コントロール パターンをサポートする必要があります。  
+  
+-   スクロールをパーセンテージで測定する場合は、スクロール目盛りに関連するすべての値または量を 0 ～ 100 の範囲に正規化する必要があります。  
+  
+-   <xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> と <xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> は <xref:System.Windows.Automation.AutomationElement.IsEnabledProperty> とは無関係です。  
+  
+-   <xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> \= `false` の場合は、<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> を 100% に設定し、<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> を <xref:System.Windows.Automation.ScrollPatternIdentifiers.NoScroll> に設定する必要があります。 同様に、<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> \= `false` の場合は、<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> を 100% に設定し、<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> を <xref:System.Windows.Automation.ScrollPatternIdentifiers.NoScroll> に設定する必要があります。 これにより、UI オートメーション クライアントは、スクロールしたくない方向がアクティブになっている場合の[競合状態](http://support.microsoft.com/default.aspx?scid=kb;en-us;317723)を回避しながら、<xref:System.Windows.Automation.ScrollPattern.SetScrollPercent%2A> メソッド内でこれらのプロパティ値を使用できます。  
+  
+-   <xref:System.Windows.Automation.Provider.IScrollProvider.HorizontalScrollPercent%2A> はロケール固有です。 HorizontalScrollPercent \= 100.0 の設定では、左から右に読む英語などの言語の場合、右端に相当する位置にコントロールのスクロール位置を設定する必要があります。 また、右から左に読むアラビア語などの言語の場合は、HorizontalScrollPercent \= 100.0 の設定でスクロール位置を左端の位置に設定する必要があります。  
+  
+<a name="Required_Members_for_IScrollProvider"></a>   
+## IScrollProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.IScrollProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.HorizontalScrollPercent%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.VerticalScrollPercent%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.HorizontalViewSize%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.VerticalViewSize%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.HorizontallyScrollable%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.VerticallyScrollable%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.Scroll%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider.SetScrollPercent%2A>|メソッド|なし|  
+  
+ このコントロール パターンには、関連するイベントがありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.ArgumentException>|コントロールが水平または垂直スクロールの場合にだけ <xref:System.Windows.Automation.ScrollAmount> の値をサポートするはずが、<xref:System.Windows.Automation.ScrollAmount> の値が渡された場合に、<xref:System.Windows.Automation.Provider.IScrollProvider.Scroll%2A> がこの例外をスローします。|  
+|<xref:System.ArgumentException>|<xref:System.Windows.Automation.Provider.IScrollProvider.SetScrollPercent%2A> は、倍精度浮動小数点型に変換できない値が渡された場合に、この例外をスローします。|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.Windows.Automation.Provider.IScrollProvider.SetScrollPercent%2A> は、100 を超える値または 0 未満の値が渡された場合に、この例外をスローします \(<xref:System.Windows.Automation.ScrollPatternIdentifiers.NoScroll> に相当する \-1 を除く\)。|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.IScrollProvider.Scroll%2A> と <xref:System.Windows.Automation.Provider.IScrollProvider.SetScrollPercent%2A> はどちらも、サポートされていない方向にスクロールされたときに、この例外をスローします。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-scrollitem-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-scrollitem-control-pattern.md
new file mode 100644
index 00000000000..456b9ca2040
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-scrollitem-control-pattern.md
@@ -0,0 +1,60 @@
+---
+title: "UI オートメーション ScrollItem コントロール パターンの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スクロール項目コントロール パターン"
+  - "UI オートメーション、スクロール項目コントロール パターン"
+  - "スクロール項目コントロール パターン"
+ms.assetid: 903bab5c-80c1-44d7-bdc2-0a418893b987
+caps.latest.revision: 16
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 16
+---
+# UI オートメーション ScrollItem コントロール パターンの実装
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックでは、実装するため、 <xref:System.Windows.Automation.Provider.IScrollItemProvider>プロパティ、メソッド、およびイベントに関する情報などです。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.ScrollItemPattern>コントロール パターンが実装したコンテナーの個々 の子コントロールをサポートするために使用される<xref:System.Windows.Automation.Provider.IScrollProvider>します。 このコントロール パターンは、子コントロールとそのコンテナーの間の通信チャネルとして機能することで、ビューポート内に現在表示されているコンテンツ (または領域) がコンテナーによって確実に変更され、子コントロールが表示されるようにします。 このコントロール パターンを実装するコントロールの例については、次を参照してください。 [UI オートメーション クライアントのコントロール パターン マッピング](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)します。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## <a name="implementation-guidelines-and-conventions"></a>実装のガイドラインと規則  
+ スクロール項目コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。  
+  
+-   ウィンドウ コントロールまたはキャンバス コントロール内の項目で、IScrollItemProvider インターフェイスを実装する必要はありません。 代わりに、ただし、必要があります公開の有効な場所、 <xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>します。 これにより、UI オートメーション クライアント アプリケーションを使用する、 <xref:System.Windows.Automation.ScrollPattern>子アイテムを表示するコンテナーでのパターンのメソッドを制御します。  
+  
+<a name="Required_Members_for_IScrollItemProvider"></a>   
+## <a name="required-members-for-iscrollitemprovider"></a>IScrollItemProvider の必須メンバー  
+ IScrollProvider インターフェイスを実装するには、次のメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|----------------------|-----------------|-----------|  
+|<xref:System.Windows.Automation.Provider.IScrollItemProvider.ScrollIntoView%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられるプロパティやイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## <a name="exceptions"></a>例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|--------------------|---------------|  
+|<xref:System.InvalidOperationException>|項目をビューにスクロールできない場合:<br /><br /> -   <xref:System.Windows.Automation.ScrollItemPattern.ScrollIntoView%2A>|  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーション コントロール パターンの概要](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI オートメーション プロバイダーでコントロール パターンをサポートします。](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [クライアントの UI オートメーション コントロール パターン](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI オートメーション ツリーの概要](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [UI オートメーションにおけるキャッシュを使用します。](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-selection-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-selection-control-pattern.md
new file mode 100644
index 00000000000..e06a47784a8
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-selection-control-pattern.md
@@ -0,0 +1,74 @@
+---
+title: "Implementing the UI Automation Selection Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Selection control pattern"
+  - "UI Automation, Selection control pattern"
+  - "control patterns, Selection"
+ms.assetid: 449c3068-a5d6-4f66-84c6-1bcc7dd4d209
+caps.latest.revision: 33
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 33
+---
+# Implementing the UI Automation Selection Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.ISelectionProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.SelectionPattern> コントロール パターンは、選択可能な子項目のコレクションのコンテナーとして機能するコントロールをサポートするために使用します。 この要素の子は <xref:System.Windows.Automation.Provider.ISelectionItemProvider> を実装する必要があります。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」をご覧ください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Selection コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。  
+  
+-   <xref:System.Windows.Automation.Provider.ISelectionProvider> を実装するコントロールでは、単一の子または複数の子項目を選択できます。 たとえば、リスト ボックス、リスト ビュー、ツリー ビューでは複数の項目を選択できる一方、コンボ ボックス、スライダー、ラジオ ボタン グループでは 1 つの項目だけを選択できます。  
+  
+-   **音量**スライダー コントロールなど、最小値、最大値、連続した値の範囲を持つコントロールは、<xref:System.Windows.Automation.Provider.ISelectionProvider> ではなく <xref:System.Windows.Automation.Provider.IRangeValueProvider> を実装する必要があります。  
+  
+-   **\[画面のプロパティ\]** ダイアログ ボックスの **\[画面解像度\]** スライダーや、[!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] の**カラー ピッカー**選択コントロールなど \(以下を参照\)、<xref:System.Windows.Automation.Provider.IRawElementProviderFragmentRoot> を実装する子コントロールを管理する単一選択コントロールは <xref:System.Windows.Automation.Provider.ISelectionProvider> を実装する必要があり、その子は <xref:System.Windows.Automation.Provider.IRawElementProviderFragment> と <xref:System.Windows.Automation.Provider.ISelectionItemProvider> の両方を実装する必要があります。  
+  
+ ![黄色が強調表示されたカラー ピッカー。](../../../docs/framework/ui-automation/media/uia-valuepattern-colorpicker.png "UIA\_ValuePattern\_ColorPicker")  
+色見本の文字列のマッピング例  
+  
+-   メニューは <xref:System.Windows.Automation.SelectionPattern> をサポートしていません。 グラフィックスとテキストの両方を含むメニュー項目 \([!INCLUDE[TLA#tla_outlook](../../../includes/tlasharptla-outlook-md.md)] の **\[表示\]** メニューにある **\[プレビュー ウィンドウ\]** 項目など\) を処理していて、状態を伝える必要がある場合は、<xref:System.Windows.Automation.Provider.IToggleProvider> を実装する必要があります。  
+  
+<a name="Required_Members_for_ISelectionProvider"></a>   
+## ISelectionProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.ISelectionProvider> インターフェイスには、次のプロパティ、メソッド、イベントが必要です。  
+  
+|必須メンバー|型|ノート|  
+|------------|-------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|プロパティ|<xref:System.Windows.Automation.Automation.AddAutomationPropertyChangedEventHandler%2A> と <xref:System.Windows.Automation.Automation.RemoveAutomationPropertyChangedEventHandler%2A> を使用してプロパティ変更イベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|プロパティ|<xref:System.Windows.Automation.Automation.AddAutomationPropertyChangedEventHandler%2A> と <xref:System.Windows.Automation.Automation.RemoveAutomationPropertyChangedEventHandler%2A> を使用してプロパティ変更イベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.GetSelection%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|Event|コンテナー内の選択が大幅に変更され、<xref:System.Windows.Automation.Provider.AutomationInteropProvider.InvalidateLimit> 定数で許可されるよりも多くの追加イベントと削除イベントを送信する必要がある場合に発生します。|  
+  
+ <xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A> プロパティと <xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A> プロパティは、動的に設定できます。 たとえば、既定で初期状態では何も項目が選択されていないコントロールがあるとします。これは、<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A> が `false` であるということです。 しかし、項目が 1 つ選択されると、このコントロールは、項目が常に 1 つ以上選択された状態を保持する必要があります。 同様に、まれなケースとして、初期設定では複数の項目の選択を許可し、以降は 1 項目の選択だけを許可するようにコントロールが設定される場合があります。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.Windows.Automation.ElementNotEnabledException>|コントロールが有効でない場合。|  
+|<xref:System.InvalidOperationException>|コントロールが非表示の場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Implementing the UI Automation SelectionItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md
new file mode 100644
index 00000000000..ce764c01335
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md
@@ -0,0 +1,65 @@
+---
+title: "Implementing the UI Automation SelectionItem Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Selection Item control pattern"
+  - "UI Automation, Selection Item control pattern"
+  - "control patterns, Selection Item"
+ms.assetid: 76b0949a-5b23-4cfc-84cc-154f713e2e12
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# Implementing the UI Automation SelectionItem Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、プロパティ、メソッド、イベントに関する情報など、<xref:System.Windows.Automation.Provider.ISelectionItemProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.SelectionItemPattern> コントロール パターンは、<xref:System.Windows.Automation.Provider.ISelectionProvider> を実装するコンテナー コントロールの個別の選択可能な子項目として機能するコントロールをサポートするために使用します。 SelectionItem コントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Selection Item コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。  
+  
+-   **\[画面のプロパティ\]** ダイアログ ボックスの **\[画面解像度\]** スライダーなどの <xref:System.Windows.Automation.Provider.IRawElementProviderFragmentRoot> を実装する子コントロールを管理する単一選択コントロールは <xref:System.Windows.Automation.Provider.ISelectionProvider> を実装する必要があり、その子は <xref:System.Windows.Automation.Provider.IRawElementProviderFragment> と <xref:System.Windows.Automation.Provider.ISelectionItemProvider> の両方を実装する必要があります。  
+  
+<a name="Required_Members_for_the_IValueProvider_Interface"></a>   
+## ISelectionItemProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.ISelectionItemProvider> の実装には、次のプロパティ、メソッド、およびイベントが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.GetSelection%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|イベント|コンテナー内の選択が大幅に変更され、<xref:System.Windows.Automation.Provider.AutomationInteropProvider.InvalidateLimit> 定数で許可されたよりも多くの <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> イベントと <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> イベントを送信する必要がある場合に発生します。|  
+  
+-   <xref:System.Windows.Automation.SelectionItemPattern.Select%2A>、<xref:System.Windows.Automation.SelectionItemPattern.AddToSelection%2A>、または <xref:System.Windows.Automation.SelectionItemPattern.RemoveFromSelection%2A> の結果が単一選択項目の場合は、<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent> が発生するはずです。それ以外の場合は、必要に応じて、<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>\/<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent> が送信されます。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|次のいずれが試行された場合:<br /><br /> -   <xref:System.Windows.Automation.SelectionPattern.IsSelectionRequiredProperty> \= `true` で、既に 1 つの要素が選択されている単一選択コンテナーで <xref:System.Windows.Automation.Provider.ISelectionItemProvider.RemoveFromSelection%2A> が呼び出された場合。<br />-   <xref:System.Windows.Automation.SelectionPattern.IsSelectionRequiredProperty> \= `true` で、1 つの要素だけが選択されている複数選択コンテナーで <xref:System.Windows.Automation.Provider.ISelectionItemProvider.RemoveFromSelection%2A> が呼び出された場合。<br />-   <xref:System.Windows.Automation.SelectionPattern.CanSelectMultipleProperty> \= `false` で、既に別の要素が選択されている単一選択コンテナーで <xref:System.Windows.Automation.Provider.ISelectionItemProvider.AddToSelection%2A> が呼び出された場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Implementing the UI Automation Selection Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-selection-control-pattern.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)   
+ [Fragment Provider Sample](http://msdn.microsoft.com/ja-jp/778ef1bc-8610-4bc9-886e-aeff94a8a13e)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md
new file mode 100644
index 00000000000..b47f98585ee
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md
@@ -0,0 +1,75 @@
+---
+title: "UI オートメーション Table コントロール パターンの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI オートメーション Table コントロール パターン"
+  - "テーブルのコントロール パターン"
+  - "TableControl パターン"
+ms.assetid: 880cd85c-aa8c-4fb5-9369-45491d34bb78
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 18
+---
+# UI オートメーション Table コントロール パターンの実装
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックでは、実装するため<xref:System.Windows.Automation.Provider.ITableProvider>プロパティ、メソッド、およびイベントに関する情報などです。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.TablePattern>子要素のコレクションのコンテナーとして機能するコントロールをサポートするコントロール パターンを使用します。 この要素の子を実装する必要があります<xref:System.Windows.Automation.Provider.ITableItemProvider>や、2 次元論理座標系行と列で走査できるで整理されます。 このコントロール パターンと似ています<xref:System.Windows.Automation.Provider.IgridProvider>、任意の制御を実装する区別を<xref:System.Windows.Automation.Provider.ITableProvider>も、各子要素の列や行ヘッダー リレーションシップを公開する必要があります。 このコントロール パターンを実装するコントロールの例については、次を参照してください。 [UI オートメーション クライアントのコントロール パターン マッピング](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)します。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## <a name="implementation-guidelines-and-conventions"></a>実装のガイドラインと規則  
+ Table コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。  
+  
+-   個別のセルのコンテンツへのアクセスは&2; 次元の論理座標系または配列の必要な同時実行の実装によって提供される、 <xref:System.Windows.Automation.Provider.IGridProvider>します。  
+  
+-   列ヘッダーまたは行ヘッダーは、テーブル オブジェクト内に含めることも、テーブル オブジェクトに関連付けられた別のヘッダー オブジェクトにすることもできます。  
+  
+-   列ヘッダーと行ヘッダーには、プライマリ ヘッダーだけでなく、任意の補助ヘッダーも含めることができます。  
+  
+> [!NOTE]
+>  この概念がで明らかになります、[!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)]スプレッドシート ユーザーが「姓」列が定義されています。 これで、この列のヘッダーは、ユーザーが定義した [ファースト ネーム] ヘッダーとアプリケーションによって割り当てられたその列の英数字指定の&2; つになります。  
+  
+-   参照してください[UI オートメーション Grid コントロール パターンを実装する](../../../docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md)の関連するグリッド機能します。  
+  
+ ![複雑なヘッダー項目を含むテーブルです。](../../../docs/framework/ui-automation/media/uia-tablepattern-complex-column-headers.PNG "UIA_TablePattern_Complex_Column_Headers")  
+列ヘッダーが複雑なテーブルの例  
+  
+ ![あいまいな RowOrColumnMajor プロパティを含むテーブル。](../../../docs/framework/ui-automation/media/uia-tablepattern-roworcolumnmajorproperty.PNG "UIA_TablePattern_RowOrColumnMajorProperty")  
+RowOrColumnMajor プロパティがあいまいなテーブルの例  
+  
+<a name="Required_Members_for_ITableProvider"></a>   
+## <a name="required-members-for-itableprovider"></a>ITableProvider の必須メンバー  
+ ITableProvider インターフェイスには、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|----------------------|-----------------|-----------|  
+|<xref:System.Windows.Automation.Provider.ITableProvider.RowOrColumnMajor%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ITableProvider.GetColumnHeaders%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.ITableProvider.GetRowHeaders%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## <a name="exceptions"></a>例外  
+ このコントロール パターンに関連付けられる例外はありません。  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーション コントロール パターンの概要](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI オートメーション プロバイダーでコントロール パターンをサポートします。](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [クライアントの UI オートメーション コントロール パターン](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI オートメーション TableItem コントロール パターンの実装](../../../docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md)   
+ [UI オートメーション Grid コントロール パターンの実装](../../../docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md)   
+ [UI オートメーション ツリーの概要](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [UI オートメーションにおけるキャッシュを使用します。](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md
new file mode 100644
index 00000000000..fca0eb2ddac
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md
@@ -0,0 +1,57 @@
+---
+title: "UI オートメーション TableItem コントロール パターンの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "テーブル項目コントロール パターン"
+  - "UI オートメーション、テーブル項目コントロール パターン"
+  - "TableItem コントロール パターン"
+ms.assetid: ac178408-1485-436f-8d3e-eee3bf80cb24
+caps.latest.revision: 14
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 14
+---
+# UI オートメーション TableItem コントロール パターンの実装
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックでは、実装するため<xref:System.Windows.Automation.Provider.ITableItemProvider>イベント、およびプロパティに関する情報などです。 その他のリファレンスへのリンクは、概要の最後に記載します。  
+  
+ <xref:System.Windows.Automation.TableItemPattern>コントロール パターンが実装したコンテナーの子コントロールをサポートするために使用される<xref:System.Windows.Automation.Provider.ITableProvider>します。 個々 のセル機能へのアクセスは、実装によって提供される、必要な同時実行の<xref:System.Windows.Automation.Provider.IGridItemProvider>します。 このコントロール パターンをに似て<xref:System.Windows.Automation.Provider.IGridItemProvider>区別のいずれかの制御を実装することを<xref:System.Windows.Automation.Provider.ITableItemProvider>個々 のセルとその行と列の情報間のリレーションシップをプログラムで公開する必要があります。 このコントロール パターンを実装するコントロールの例については、次を参照してください。 [UI オートメーション クライアントのコントロール パターン マッピング](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)します。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## <a name="implementation-guidelines-and-conventions"></a>実装のガイドラインと規則  
+  
+-   関連するグリッド項目の機能を参照してください。 [UI オートメーション GridItem コントロール パターンを実装する](../../../docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md)です。  
+  
+<a name="Required_Members_for_ITableItemProvider"></a>   
+## <a name="required-members-for-itableitemprovider"></a>ITableItemProvider の必須メンバー  
+  
+|必須メンバー|メンバーの型|ノート|  
+|---------------------|-----------------|-----------|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider.GetColumnHeaderItems%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider.GetRowHeaderItems%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられるプロパティやイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## <a name="exceptions"></a>例外  
+ このコントロール パターンに関連付けられる例外はありません。  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーション コントロール パターンの概要](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI オートメーション プロバイダーでコントロール パターンをサポートします。](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [クライアントの UI オートメーション コントロール パターン](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI オートメーション Table コントロール パターンの実装](../../../docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md)   
+ [UI オートメーション GridItem コントロール パターンの実装](../../../docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md)   
+ [UI オートメーション ツリーの概要](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [UI オートメーションにおけるキャッシュを使用します。](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-toggle-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-toggle-control-pattern.md
new file mode 100644
index 00000000000..d5da8cf5c80
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-toggle-control-pattern.md
@@ -0,0 +1,64 @@
+---
+title: "Implementing the UI Automation Toggle Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Toggle control pattern"
+  - "control patterns, Toggle"
+  - "UI Automation, Toggle control pattern"
+ms.assetid: 3cfe875f-b0c0-413d-9703-5f14e6a1a30e
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# Implementing the UI Automation Toggle Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、メソッドおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IToggleProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.TogglePattern> コントロール パターンは、一連の状態を順番に繰り返し、状態を一度設定したらそれを保持できるコントロールをサポートするために使用します。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」をご覧ください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Toggle コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。  
+  
+-   ボタン、ツール バー ボタン、ハイパーリンクなど、アクティブになったときに状態を保持しないコントロールは、代わりに <xref:System.Windows.Automation.Provider.IInvokeProvider> を実装する必要があります。  
+  
+-   コントロールは、<xref:System.Windows.Automation.ToggleState>、<xref:System.Windows.Automation.ToggleState>、<xref:System.Windows.Automation.ToggleState> \(サポートされている場合\) の順にその <xref:System.Windows.Automation.ToggleState> を繰り返す必要があります。  
+  
+-   <xref:System.Windows.Automation.TogglePattern> は、SetState\(newState\) メソッドを提供しません。これは、適切な <xref:System.Windows.Automation.ToggleState> の順番の繰り返しをせずに、3 つの状態を持つ CheckBox を直接設定することに関連する問題のためです。  
+  
+-   RadioButton コントロールは <xref:System.Windows.Automation.Provider.IToggleProvider> を実装しません。これは、その正しい状態を順番に繰り返す機能がないためです。  
+  
+<a name="Required_Members_for_IToggleProvider"></a>   
+## IToggleProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.IToggleProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.TogglePattern.Toggle%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty>|プロパティ|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ このコントロール パターンに関連付けられた例外はありません。  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Get the Toggle State of a Check Box Using UI Automation](../../../docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-transform-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-transform-control-pattern.md
new file mode 100644
index 00000000000..6c098bc8018
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-transform-control-pattern.md
@@ -0,0 +1,73 @@
+---
+title: "Implementing the UI Automation Transform Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, Transform"
+  - "Transform control pattern"
+  - "UI Automation, Transform control pattern"
+ms.assetid: 5f49d843-5845-4800-9d9c-56ce0d146844
+caps.latest.revision: 14
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 14
+---
+# Implementing the UI Automation Transform Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、プロパティ、メソッド、イベントに関する情報など、<xref:System.Windows.Automation.Provider.ITransformProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.TransformPattern> コントロール パターンは、2 次元空間で移動、サイズ変更、または回転できるコントロールをサポートするために使用されます。 このコントロール パターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」をご覧ください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Transform コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。  
+  
+-   このコントロール パターンのサポートは、デスクトップ上のオブジェクトに制限されません。 コンテナーの境界内で子が自由に移動、サイズ変更、または回転できるようにする場合は、そのコンテナー オブジェクトの子もこのコントロール パターンをサポートしている必要があります。  
+  
+-   操作後の画面位置が完全にそのコンテナーの座標外となり、キーボードやマウスからアクセスできなくなる場合 \(たとえば、トップレベルのウィンドウが画面外に移動したり、子オブジェクトがコンテナーのビューポートの境界外へ移動したりする場合\) は、オブジェクトの移動、サイズ変更、および回転はできません。 このような場合、上辺または左辺の座標をコンテナーの境界内にオーバーライドして、要求された画面座標のできるだけ近くにオブジェクトが配置されます。  
+  
+-   マルチモニター システムでは、結合したデスクトップ画面座標の完全に外へオブジェクトを移動、サイズ変更、または回転した場合、プライマリ モニター上の、要求された画面座標のできるだけ近くにオブジェクトが配置されます。  
+  
+-   すべてのパラメーターとプロパティの値は絶対値で、ロケールには依存しません。  
+  
+<a name="Required_Members_for_the_IValueProvider_Interface"></a>   
+## ITransformProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.ITransformProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.CanMove%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.CanResize%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.CanRotate%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.Move%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.Resize%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider.Rotate%2A>|メソッド|なし|  
+  
+ このコントロール パターンに関連付けられたイベントはありません。  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.ITransformProvider.Move%2A><br /><br /> -   <xref:System.Windows.Automation.TransformPatternIdentifiers.CanMoveProperty> が false の場合。|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.ITransformProvider.Resize%2A><br /><br /> -   <xref:System.Windows.Automation.TransformPatternIdentifiers.CanResizeProperty> が false の場合。|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.ITransformProvider.Rotate%2A><br /><br /> -   <xref:System.Windows.Automation.TransformPatternIdentifiers.CanRotateProperty> が false の場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-value-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-value-control-pattern.md
new file mode 100644
index 00000000000..9d8c4278c10
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-value-control-pattern.md
@@ -0,0 +1,79 @@
+---
+title: "Implementing the UI Automation Value Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, Value"
+  - "UI Automation, Value control pattern"
+  - "Value control pattern"
+ms.assetid: b0fcdd87-3add-4345-bca9-e891205e02ba
+caps.latest.revision: 25
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# Implementing the UI Automation Value Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、イベントおよびプロパティに関する情報など、<xref:System.Windows.Automation.Provider.IValueProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、このトピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.ValuePattern> コントロール パターンは、範囲にまたがることのない組み込み値を持つコントロールや、文字列として表すことができるコントロールをサポートするために使用されます。 この文字列は、コントロールとその設定によっては、編集できます。 このパターンを実装するコントロールの例については、「[Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Value コントロール パターンを実装する場合は、次のガイドラインと規則に留意してください。  
+  
+-   <xref:System.Windows.Automation.ControlType.ListItem> や <xref:System.Windows.Automation.ControlType.TreeItem> などのコントロールは、コントロールの現在の編集モードに関係なく、いずれかの項目の値が編集可能である場合は、<xref:System.Windows.Automation.ValuePattern> をサポートする必要があります。 子項目が編集可能である場合は、親コントロールも <xref:System.Windows.Automation.ValuePattern> をサポートする必要があります。  
+  
+ ![編集可能なリスト項目。](../../../docs/framework/ui-automation/media/uia-valuepattern-editable-listitem.PNG "UIA\_ValuePattern\_Editable\_ListItem")  
+編集可能なリスト項目の例  
+  
+-   単一行のエディット コントロールは、そのコンテンツへのプログラムによるアクセスをサポートするために、<xref:System.Windows.Automation.Provider.IValueProvider> を実装します。 一方、複数行のエディット コントロールは <xref:System.Windows.Automation.Provider.IValueProvider> を実装しません。代わりに <xref:System.Windows.Automation.Provider.ITextProvider> を実装して、そのコンテンツへのアクセスを提供します。  
+  
+-   複数行の編集コントロールのテキスト コンテンツを取得するには、コントロールが <xref:System.Windows.Automation.Provider.ITextProvider> を実装していなければなりません。 ただし、<xref:System.Windows.Automation.Provider.ITextProvider> はコントロールの値の設定はサポートしていません。  
+  
+-   <xref:System.Windows.Automation.Provider.IValueProvider> は、書式設定情報や部分文字列の値の取得をサポートしていません。 このようなシナリオでは <xref:System.Windows.Automation.Provider.ITextProvider> を実装します。  
+  
+-   <xref:System.Windows.Automation.Provider.IValueProvider> を実装する必要があるコントロールの一例は、[!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] の **カラー ピッカー**選択コントロールです \(以下を参照\)。このコントロールは、色の値 \(たとえば「黄」\) と同等の内部 [!INCLUDE[TLA#tla_rgb](../../../includes/tlasharptla-rgb-md.md)] 構造の間の文字列マッピングをサポートしています。  
+  
+ ![黄色が強調表示されたカラー ピッカー。](../../../docs/framework/ui-automation/media/uia-valuepattern-colorpicker.png "UIA\_ValuePattern\_ColorPicker")  
+色見本の文字列マッピング例  
+  
+-   <xref:System.Windows.Automation.Provider.IValueProvider.SetValue%2A> を呼び出せるようにするには、コントロールの <xref:System.Windows.Automation.AutomationElement.IsEnabledProperty> を `true` に設定し、<xref:System.Windows.Automation.ValuePattern.IsReadOnlyProperty> を `false` に設定する必要があります。  
+  
+<a name="Required_Members_for_the_IValueProvider_Interface"></a>   
+## IValueProvider の必須メンバー  
+ <xref:System.Windows.Automation.Provider.IValueProvider> の実装には、次のプロパティとメソッドが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.ValuePattern.IsReadOnlyProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.ValuePattern.ValueProperty>|プロパティ|なし|  
+|<xref:System.Windows.Automation.ValuePattern.SetValue%2A>|メソッド|なし|  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.ValuePattern.SetValue%2A><br /><br /> -   ロケールに固有の情報が、誤った形式でコントロールに渡された場合 \(誤った日付形式など\)。|  
+|<xref:System.ArgumentException>|<xref:System.Windows.Automation.ValuePattern.SetValue%2A><br /><br /> -   新しい値を、文字列からコントロールが認識する形式に変換できない場合。|  
+|<xref:System.Windows.Automation.ElementNotEnabledException>|<xref:System.Windows.Automation.ValuePattern.SetValue%2A><br /><br /> -   有効になっていないコントロールの操作が試行された場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [TextPattern Insert Text Sample](http://msdn.microsoft.com/ja-jp/67353f93-7ee2-42f2-ab76-5c078cf6ca16)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/implementing-the-ui-automation-window-control-pattern.md b/docs/framework/ui-automation/implementing-the-ui-automation-window-control-pattern.md
new file mode 100644
index 00000000000..d0ddbd0b853
--- /dev/null
+++ b/docs/framework/ui-automation/implementing-the-ui-automation-window-control-pattern.md
@@ -0,0 +1,78 @@
+---
+title: "Implementing the UI Automation Window Control Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, Window"
+  - "UI Automation, Window control pattern"
+  - "Window control pattern"
+ms.assetid: a28cb286-296e-4a62-b4cb-55ad636ebccc
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# Implementing the UI Automation Window Control Pattern
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、<xref:System.Windows.Automation.WindowPattern> のプロパティ、メソッド、イベントに関する情報など、<xref:System.Windows.Automation.Provider.IWindowProvider> の実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、このトピックの最後に記載します。  
+  
+ <xref:System.Windows.Automation.WindowPattern> コントロール パターンは、従来の [!INCLUDE[TLA#tla_gui](../../../includes/tlasharptla-gui-md.md)] 内で、ウィンドウ ベースの基本的な機能を提供するコントロールをサポートするために使用されます。 このコントロール パターンを実装する必要があるコントロールの例として、最上位のアプリケーション ウィンドウ、[!INCLUDE[TLA#tla_mdi](../../../includes/tlasharptla-mdi-md.md)] 子ウィンドウ、サイズ変更可能な分割ウィンドウ コントロール、モーダル ダイアログ ボックス、バルーン ヘルプ ウィンドウがあります。  
+  
+<a name="Implementation_Guidelines_and_Conventions"></a>   
+## 実装のガイドラインと規則  
+ Window コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。  
+  
+-   UI オートメーションを使用してウィンドウのサイズと位置の両方を変更する機能をサポートするには、コントロールが <xref:System.Windows.Automation.Provider.IWindowProvider> に加えて <xref:System.Windows.Automation.Provider.ITransformProvider> を実装する必要があります。  
+  
+-   コントロールを移動、サイズ変更、最大化、最小化、および閉じられるようにするタイトル バーの要素とタイトル バーを格納するコントロールは、通常 <xref:System.Windows.Automation.Provider.IWindowProvider> を実装することが求められます。  
+  
+-   ツールヒントのポップアップやコンボ ボックス、またはメニューのドロップダウンなどのコントロールは、通常 <xref:System.Windows.Automation.Provider.IWindowProvider> を実装しません。  
+  
+-   バルーン ヘルプ ウィンドウは、ウィンドウと同様の閉じるボタンを提供することで、基本的なツールヒント ポップアップから区別されます。  
+  
+-   全画面表示モードは、アプリケーション固有の機能であり、通常のウィンドウの動作ではないため、IWindowProvider によってサポートされません。  
+  
+<a name="Required_Members_for_IWindowProvider"></a>   
+## IWindowProvider の必須メンバー  
+ IWindowProvider インターフェイスには、次のプロパティ、メソッド、イベントが必要です。  
+  
+|必須メンバー|メンバーの型|ノート|  
+|------------|------------|---------|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.InteractionState%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.IsModal%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.IsTopmost%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.Maximizable%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.Minimizable%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.VisualState%2A>|プロパティ|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.Close%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.SetVisualState%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider.WaitForInputIdle%2A>|メソッド|なし|  
+|<xref:System.Windows.Automation.WindowPattern.WindowClosedEvent>|Event|なし|  
+|<xref:System.Windows.Automation.WindowPattern.WindowOpenedEvent>|Event|なし|  
+|<xref:System.Windows.Automation.WindowInteractionState>|イベント|<xref:System.Windows.Automation.WindowInteractionState> であると保証されない|  
+  
+<a name="Exceptions"></a>   
+## 例外  
+ プロバイダーは、次の例外をスローする必要があります。  
+  
+|例外の種類|状態|  
+|-----------|--------|  
+|<xref:System.InvalidOperationException>|<xref:System.Windows.Automation.Provider.IWindowProvider.SetVisualState%2A><br /><br /> -   コントロールが、要求された動作をサポートしない場合。|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.Windows.Automation.Provider.IWindowProvider.WaitForInputIdle%2A><br /><br /> -   パラメーターが、有効な値ではない場合。|  
+  
+## 参照  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/index.md b/docs/framework/ui-automation/index.md
new file mode 100644
index 00000000000..9b4ce65b3dd
--- /dev/null
+++ b/docs/framework/ui-automation/index.md
@@ -0,0 +1,46 @@
+---
+title: "UI Automation Fundamentals | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI automation fundamentals"
+ms.assetid: e7ec856e-41ee-47b1-9d57-b75a3dad088c
+caps.latest.revision: 80
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 54
+---
+# UI Automation Fundamentals
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] [!INCLUDE[TLA#tla_api](../../../includes/tlasharptla-api-md.md)] の全般的な概要を示します。  
+  
+## このセクションの内容  
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)  
+ [UI Automation and Microsoft Active Accessibility](../../../docs/framework/ui-automation/ui-automation-and-microsoft-active-accessibility.md)  
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)  
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)  
+ [UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)  
+ [UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)  
+ [UI Automation Security Overview](../../../docs/framework/ui-automation/ui-automation-security-overview.md)  
+ [Using UI Automation for Automated Testing](../../../docs/framework/ui-automation/using-ui-automation-for-automated-testing.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Automation>  
+  
+ <xref:System.Windows.Automation.Provider>  
+  
+ <xref:System.Windows.Automation.Text>  
+  
+ <xref:UIAutomationClientsideProviders>
\ No newline at end of file
diff --git a/docs/framework/ui-automation/invoke-a-control-using-ui-automation.md b/docs/framework/ui-automation/invoke-a-control-using-ui-automation.md
new file mode 100644
index 00000000000..896204ae798
--- /dev/null
+++ b/docs/framework/ui-automation/invoke-a-control-using-ui-automation.md
@@ -0,0 +1,46 @@
+---
+title: "Invoke a Control Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "invoking controls"
+  - "UI Automation, invoking controls"
+  - "controls, invoking"
+ms.assetid: 5ee2de3f-256c-43ec-b64c-62ace91f9983
+caps.latest.revision: 15
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 15
+---
+# Invoke a Control Using UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、次のタスクを実行する方法について示します。  
+  
+-   ターゲット アプリケーションの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューを調べて、特定のプロパティ条件に一致するコントロールを検索する。  
+  
+-   各コントロールに対して <xref:System.Windows.Automation.AutomationElement> を作成する。  
+  
+-   <xref:System.Windows.Automation.InvokePattern> コントロール パターンをサポートする [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素から <xref:System.Windows.Automation.InvokePattern> オブジェクトを取得する。  
+  
+-   <xref:System.Windows.Automation.InvokePattern.Invoke%2A> を使用して、クライアントのイベント ハンドラーからコントロールを呼び出す。  
+  
+## 使用例  
+ この例では、<xref:System.Windows.Automation.AutomationElement> クラスの <xref:System.Windows.Automation.AutomationElement.TryGetCurrentPattern%2A> メソッドを使用して <xref:System.Windows.Automation.InvokePattern> オブジェクトを生成し、<xref:System.Windows.Automation.InvokePattern.Invoke%2A> メソッドを使用してコントロールを呼び出します。  
+  
+ [!code-csharp[InvokePatternApp#1100](../../../samples/snippets/csharp/VS_Snippets_Wpf/InvokePatternApp/CSharp/InvokePatternApp.cs#1100)]
+ [!code-vb[InvokePatternApp#1100](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InvokePatternApp/VisualBasic/Client.vb#1100)]  
+[!code-csharp[InvokePatternApp#1102](../../../samples/snippets/csharp/VS_Snippets_Wpf/InvokePatternApp/CSharp/InvokePatternApp.cs#1102)]
+[!code-vb[InvokePatternApp#1102](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InvokePatternApp/VisualBasic/Client.vb#1102)]  
+  
+## 参照  
+ [InvokePattern and ExpandCollapsePattern Menu Item Sample](http://msdn.microsoft.com/ja-jp/b7fa141c-e2d1-4da2-a27f-81a7d1172210)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/media/uia-dockpattern-dockingexample.PNG b/docs/framework/ui-automation/media/uia-dockpattern-dockingexample.PNG
new file mode 100644
index 00000000000..5d15ef477cb
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-dockpattern-dockingexample.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-gridpattern-ragged-array.PNG b/docs/framework/ui-automation/media/uia-gridpattern-ragged-array.PNG
new file mode 100644
index 00000000000..4ac0a0ddf5b
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-gridpattern-ragged-array.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-rangevaluepattern-progress-bar.PNG b/docs/framework/ui-automation/media/uia-rangevaluepattern-progress-bar.PNG
new file mode 100644
index 00000000000..9171e197a2f
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-rangevaluepattern-progress-bar.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-scrollpattern-without-scrollbars.PNG b/docs/framework/ui-automation/media/uia-scrollpattern-without-scrollbars.PNG
new file mode 100644
index 00000000000..51dd79f0b79
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-scrollpattern-without-scrollbars.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-tablepattern-complex-column-headers.PNG b/docs/framework/ui-automation/media/uia-tablepattern-complex-column-headers.PNG
new file mode 100644
index 00000000000..c9e5f36b328
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-tablepattern-complex-column-headers.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-tablepattern-roworcolumnmajorproperty.PNG b/docs/framework/ui-automation/media/uia-tablepattern-roworcolumnmajorproperty.PNG
new file mode 100644
index 00000000000..e3da9701f58
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-tablepattern-roworcolumnmajorproperty.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-example1.png b/docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-example1.png
new file mode 100644
index 00000000000..b5e99de3e83
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-example1.png differ
diff --git a/docs/framework/ui-automation/media/uia-textpattern-embeddedobjects.PNG b/docs/framework/ui-automation/media/uia-textpattern-embeddedobjects.PNG
new file mode 100644
index 00000000000..3100532baba
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-textpattern-embeddedobjects.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-textpattern-embeddedobjecttextranges.png b/docs/framework/ui-automation/media/uia-textpattern-embeddedobjecttextranges.png
new file mode 100644
index 00000000000..653d32366d8
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-textpattern-embeddedobjecttextranges.png differ
diff --git a/docs/framework/ui-automation/media/uia-textpattern-endpoints.PNG b/docs/framework/ui-automation/media/uia-textpattern-endpoints.PNG
new file mode 100644
index 00000000000..f92072803f5
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-textpattern-endpoints.PNG differ
diff --git a/docs/framework/ui-automation/media/uia-textpattern-moveandexpand-examples.png b/docs/framework/ui-automation/media/uia-textpattern-moveandexpand-examples.png
new file mode 100644
index 00000000000..188a9e62bad
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-textpattern-moveandexpand-examples.png differ
diff --git a/docs/framework/ui-automation/media/uia-valuepattern-colorpicker.png b/docs/framework/ui-automation/media/uia-valuepattern-colorpicker.png
new file mode 100644
index 00000000000..a4091e65cb2
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-valuepattern-colorpicker.png differ
diff --git a/docs/framework/ui-automation/media/uia-valuepattern-editable-listitem.PNG b/docs/framework/ui-automation/media/uia-valuepattern-editable-listitem.PNG
new file mode 100644
index 00000000000..3b2419bb082
Binary files /dev/null and b/docs/framework/ui-automation/media/uia-valuepattern-editable-listitem.PNG differ
diff --git a/docs/framework/ui-automation/media/uiauto-data-grid-detailed.GIF b/docs/framework/ui-automation/media/uiauto-data-grid-detailed.GIF
new file mode 100644
index 00000000000..d7775fb6b8f
Binary files /dev/null and b/docs/framework/ui-automation/media/uiauto-data-grid-detailed.GIF differ
diff --git a/docs/framework/ui-automation/move-a-ui-automation-element.md b/docs/framework/ui-automation/move-a-ui-automation-element.md
new file mode 100644
index 00000000000..da308f56dd4
--- /dev/null
+++ b/docs/framework/ui-automation/move-a-ui-automation-element.md
@@ -0,0 +1,38 @@
+---
+title: "Move a UI Automation Element | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "moving elements"
+  - "elements, moving"
+  - "UI Automation, moving elements"
+ms.assetid: 4042cb44-e27e-4a03-ac36-9be1eed65b47
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# Move a UI Automation Element
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ この例では、指定した画面位置に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]要素を移動する方法を示しています。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Automation.WindowPattern> および <xref:System.Windows.Automation.TransformPattern> コントロール パターンを使用して、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] ターゲット アプリケーションを非連続の画面位置にプログラムで移動し、<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty><xref:System.Windows.Automation.AutomationElement.AutomationPropertyChangedEvent> を追跡します。  
+  
+ [!code-csharp[WindowMove#1301](../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowMove/CSharp/WindowMove.cs#1301)]
+ [!code-vb[WindowMove#1301](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowMove/VisualBasic/windowmove.vb#1301)]  
+[!code-csharp[WindowMove#1300](../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowMove/CSharp/WindowMove.cs#1300)]
+[!code-vb[WindowMove#1300](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowMove/VisualBasic/windowmove.vb#1300)]  
+  
+## 参照  
+ [WindowPattern Sample](http://msdn.microsoft.com/ja-jp/598b695c-8baf-406e-bbfb-2a1c7842a1de)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md b/docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md
new file mode 100644
index 00000000000..cd161525094
--- /dev/null
+++ b/docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md
@@ -0,0 +1,43 @@
+---
+title: "Navigate Among UI Automation Elements with TreeWalker | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "classes, TreeWalker"
+  - "TreeWalker class"
+  - "elements, navigating among"
+  - "UI Automation, navigating among elements"
+ms.assetid: afcd21dc-2ffa-48c9-9332-51269f44b7e9
+caps.latest.revision: 8
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 8
+---
+# Navigate Among UI Automation Elements with TreeWalker
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックのコード例では、<xref:System.Windows.Automation.TreeWalker> クラスを使用して [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]要素間を移動する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Automation.TreeWalker.GetParent%2A> を使用して、ルート要素であるデスクトップを見つけるまで [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] ツリーを上方向へ移動する例を次に示します。  そのすぐ下の要素は指定した要素の親ウィンドウです。  
+  
+ [!code-csharp[UIAFocusTracker_snip#102](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFocusTracker_snip/CSharp/FocusTracker.cs#102)]
+ [!code-vb[UIAFocusTracker_snip#102](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFocusTracker_snip/VisualBasic/FocusTracker.vb#102)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Automation.TreeWalker.GetFirstChild%2A> と <xref:System.Windows.Automation.TreeWalker.GetNextSibling%2A> を使用して、コントロール ビュー内にある有効な [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]要素のサブツリー全体を表示する <xref:System.Windows.Forms.TreeView> を作成します。  
+  
+ [!code-csharp[UIAClient_snip#174](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#174)]
+ [!code-vb[UIAClient_snip#174](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#174)]  
+  
+## 参照  
+ [Obtaining UI Automation Elements](../../../docs/framework/ui-automation/obtaining-ui-automation-elements.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/obtain-mixed-text-attribute-details-using-ui-automation.md b/docs/framework/ui-automation/obtain-mixed-text-attribute-details-using-ui-automation.md
new file mode 100644
index 00000000000..15113c045ba
--- /dev/null
+++ b/docs/framework/ui-automation/obtain-mixed-text-attribute-details-using-ui-automation.md
@@ -0,0 +1,39 @@
+---
+title: "Obtain Mixed Text Attribute Details Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0e4c005-abd1-42bb-92a4-5faf87097311
+caps.latest.revision: 11
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 11
+---
+# Obtain Mixed Text Attribute Details Using UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して、複数の属性値にまたがるテキスト範囲からテキスト属性の詳細を取得する方法を示します。 テキスト範囲は、ドキュメント内でのキャレット \(^\) の現在位置 \(つまり低次元の選択範囲\)、連続したテキストを選択したもの、個別に選択したテキストの集合、またはドキュメントに含まれるテキスト全体のいずれかに対応します。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Automation.Text.TextPatternRange.GetAttributeValue%2A> が <xref:System.Windows.Automation.TextPattern.MixedAttributeValue> オブジェクトを返すテキスト範囲から <xref:System.Windows.Automation.TextPattern.FontNameAttribute> を取得する方法を示しています。  
+  
+ [!code-csharp[FindText#RetrieveMixedAttributes](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#retrievemixedattributes)]
+ [!code-vb[FindText#RetrieveMixedAttributes](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#retrievemixedattributes)]  
+  
+ <xref:System.Windows.Automation.TextPattern> コントロール パターンは、<xref:System.Windows.Automation.Text.TextPatternRange> クラスと共に、基本的なテキスト属性、プロパティ、およびメソッドをサポートします。<xref:System.Windows.Automation.TextPattern> または <xref:System.Windows.Automation.Text.TextPatternRange> によってサポートされないコントロール固有の機能の場合、UI オートメーション クライアントが対応するネイティブ オブジェクト モデルにアクセスできるように、<xref:System.Windows.Automation.AutomationElement> クラスがメソッドを提供します。  
+  
+## 参照  
+ [UI Automation TextPattern Overview](../../../docs/framework/ui-automation/ui-automation-textpattern-overview.md)   
+ [Add Content to a Text Box Using UI Automation](../../../docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md)   
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Obtain Text Attributes Using UI Automation](../../../docs/framework/ui-automation/obtain-text-attributes-using-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/obtain-text-attributes-using-ui-automation.md b/docs/framework/ui-automation/obtain-text-attributes-using-ui-automation.md
new file mode 100644
index 00000000000..46416f6af30
--- /dev/null
+++ b/docs/framework/ui-automation/obtain-text-attributes-using-ui-automation.md
@@ -0,0 +1,47 @@
+---
+title: "Obtain Text Attributes Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "getting, text attributes"
+  - "UI Automation, getting text attributes"
+  - "text attributes, getting"
+ms.assetid: fdefc6c3-b836-4cfe-8dec-1484bfdc5551
+caps.latest.revision: 13
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 13
+---
+# Obtain Text Attributes Using UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して、テキスト範囲からテキスト属性を取得する方法について説明します。 テキスト範囲は、ドキュメント内のキャレットの現在の位置 \(または低次元選択\)、テキストの連続した選択、非連続のテキスト選択のコレクション、またはドキュメントのテキスト コンテンツ全体に対応します。  
+  
+## 使用例  
+ 次のコード例は、テキスト範囲から <xref:System.Windows.Automation.TextPattern.FontNameAttribute> を取得する方法を示しています。  
+  
+ [!code-csharp[UIATextPattern_snip#StartTarget](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATextPattern_snip/CSharp/SearchWindow.cs#starttarget)]
+ [!code-vb[UIATextPattern_snip#StartTarget](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATextPattern_snip/VisualBasic/SearchWindow.vb#starttarget)]  
+[!code-csharp[UIATextPattern_snip#GetTextElement](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATextPattern_snip/CSharp/SearchWindow.cs#gettextelement)]
+[!code-vb[UIATextPattern_snip#GetTextElement](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATextPattern_snip/VisualBasic/SearchWindow.vb#gettextelement)]  
+[!code-csharp[UIATextPattern_snip#FontName](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATextPattern_snip/CSharp/SearchWindow.cs#fontname)]
+[!code-vb[UIATextPattern_snip#FontName](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIATextPattern_snip/VisualBasic/SearchWindow.vb#fontname)]  
+  
+ <xref:System.Windows.Automation.TextPattern> コントロール パターンは <xref:System.Windows.Automation.Text.TextPatternRange> クラスと連携して、基本のテキスト属性、プロパティ、メソッドをサポートします。<xref:System.Windows.Automation.TextPattern> または <xref:System.Windows.Automation.Text.TextPatternRange> によってサポートされないコントロール固有の機能の場合、<xref:System.Windows.Automation.AutomationElement> クラスは対応するネイティブ オブジェクト モデルにアクセスするための UI オートメーション クライアントのメソッドを提供します。  
+  
+## 参照  
+ [UI Automation TextPattern Overview](../../../docs/framework/ui-automation/ui-automation-textpattern-overview.md)   
+ [Add Content to a Text Box Using UI Automation](../../../docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md)   
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Obtain Mixed Text Attribute Details Using UI Automation](../../../docs/framework/ui-automation/obtain-mixed-text-attribute-details-using-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/obtaining-ui-automation-elements.md b/docs/framework/ui-automation/obtaining-ui-automation-elements.md
new file mode 100644
index 00000000000..50da62c1753
--- /dev/null
+++ b/docs/framework/ui-automation/obtaining-ui-automation-elements.md
@@ -0,0 +1,109 @@
+---
+title: "Obtaining UI Automation Elements | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, obtaining elements"
+  - "elements, UI Automation, obtaining"
+ms.assetid: c2caaf45-e59c-42a1-bc9b-77a6de520171
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# Obtaining UI Automation Elements
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素の <xref:System.Windows.Automation.AutomationElement> オブジェクトを取得するさまざまな方法について説明します。  
+  
+> [!CAUTION]
+>  クライアント アプリケーションが独自のユーザー インターフェイスで要素の検索を試行する可能性がある場合は、すべての [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の呼び出しを個別のスレッドで実行する必要があります。 詳細については、「[UI Automation Threading Issues](../../../docs/framework/ui-automation/ui-automation-threading-issues.md)」を参照してください。  
+  
+<a name="The_Root_Element"></a>   
+## ルート要素  
+ <xref:System.Windows.Automation.AutomationElement> オブジェクトの検索には必ず、開始場所が必要です。 この開始場所には、デスクトップ、アプリケーション ウィンドウ、コントロールなど任意の要素を指定できます。  
+  
+ デスクトップのルート要素 \(すべての要素が派生する\) が静的 <xref:System.Windows.Automation.AutomationElement.RootElement%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+> [!CAUTION]
+>  通常、<xref:System.Windows.Automation.AutomationElement.RootElement%2A> の直接の子のみの取得を試行する必要があります。 子孫の検索は、数百または数千もの要素を反復処理する場合があり、スタック オーバーフローを引き起こす可能性があります。 下位レベルの特定の要素を取得しようとする場合、アプリケーション ウィンドウから、または下位レベルのコンテナーから検索を開始する必要があります。  
+  
+<a name="Using_Conditions"></a>   
+## 条件  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素を取得するために使用できるほとんどの手法では、<xref:System.Windows.Automation.Condition> を指定する必要があります。これは、取得する要素を定義する一連の条件になります。  
+  
+ 最も簡単な条件は <xref:System.Windows.Automation.Condition.TrueCondition> で、検索範囲内のすべての要素を指定する定義済みオブジェクトが返されます。 要素が検出されなくなるため、<xref:System.Windows.Automation.Condition.FalseCondition> \(<xref:System.Windows.Automation.Condition.TrueCondition> の逆\) はあまり有用ではありません。  
+  
+ その他の 3 つの定義済み条件 \(<xref:System.Windows.Automation.Automation.ContentViewCondition>、<xref:System.Windows.Automation.Automation.ControlViewCondition>、および <xref:System.Windows.Automation.Automation.RawViewCondition>\) は、単独で使用することも、その他の条件と組み合わせて使用することもできます。<xref:System.Windows.Automation.Automation.RawViewCondition> を単独で使用した場合、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsControlElement%2A> または <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsContentElement%2A> プロパティで要素をフィルター処理しないため <xref:System.Windows.Automation.Condition.TrueCondition> と同等になります。  
+  
+ その他の条件は 1 つ以上の <xref:System.Windows.Automation.PropertyCondition> オブジェクトで構築され、それぞれはプロパティ値を指定します。 たとえば、<xref:System.Windows.Automation.PropertyCondition> は要素が有効であることを指定したり、特定のコントロール パターンをサポートすることを指定したりします。  
+  
+ <xref:System.Windows.Automation.AndCondition>、<xref:System.Windows.Automation.OrCondition>、および <xref:System.Windows.Automation.NotCondition> の型のオブジェクトを構築することによって、ブール ロジックを使用して条件を組み合わせることができます。  
+  
+<a name="Search_Scope"></a>   
+## 検索範囲  
+ <xref:System.Windows.Automation.AutomationElement.FindFirst%2A> または <xref:System.Windows.Automation.AutomationElement.FindAll%2A> 使用した検索には、範囲と開始場所が必要です。  
+  
+ 範囲は、検索対象の開始場所の周囲の領域を定義します。 これには、要素自体、その兄弟、その親、その先祖、その直接の子、およびその子孫を含めることができます。  
+  
+ <xref:System.Windows.Automation.TreeScope> 列挙の値のビットごとの組み合わせによって、検索の範囲が定義されます。  
+  
+<a name="Finding_a_Known_Element"></a>   
+## 既知の要素の検索  
+ 既知の要素 \(その <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Name%2A>、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.AutomationId%2A>、または他のプロパティまたはプロパティの組み合わせによって識別される\) を検索する方法として、<xref:System.Windows.Automation.AutomationElement.FindFirst%2A> メソッドを使用する方法が最も簡単です。 検索する要素がアプリケーション ウィンドウである場合は、検索の開始点を <xref:System.Windows.Automation.AutomationElement.RootElement%2A> にすることができます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素を検索するこの方法は、自動化されたシナリオ テストの最も有用な方法になります。  
+  
+<a name="Finding_Elements_in_a_Subtree"></a>   
+## サブツリー内の要素の検索  
+ 既知の要素に関連する特定の条件を満たすすべての要素を検索するには、<xref:System.Windows.Automation.AutomationElement.FindAll%2A> を使用します。 たとえば、このメソッドを使用して、リストまたはメニューからリスト項目またはメニュー項目を取得したり、ダイアログ ボックスのすべてのコントロールを識別したりできます。  
+  
+<a name="Walking_a_Subtree"></a>   
+## サブツリーのウォーク  
+ クライアントで使用されるアプリケーションについて予備知識がない場合、<xref:System.Windows.Automation.TreeWalker> クラスを使用して、対象となるすべての要素のサブツリーを構築することができます。 アプリケーションは、フォーカス変更イベントへの応答でこれを実行することができます。つまり、アプリケーションやコントロールが入力フォーカスを受け取るときに、UI オートメーション クライアントはフォーカスされている要素の子およびすべての子孫を調べます。  
+  
+ <xref:System.Windows.Automation.TreeWalker> で使用できる別の方法は、要素の先祖を特定する方法です。 たとえば、ツリーをウォークすることによって、コントロールの親ウィンドウを特定できます。  
+  
+ クラスのオブジェクトを作成する \(<xref:System.Windows.Automation.Condition> を渡すことによって対象の要素を定義する\) か、<xref:System.Windows.Automation.TreeWalker> のフィールドとして定義されている次の定義済みオブジェクトのいずれかを使用することによって、<xref:System.Windows.Automation.TreeWalker> を使用できます。  
+  
+|||  
+|-|-|  
+|<xref:System.Windows.Automation.TreeWalker.ContentViewWalker>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsContentElement%2A> プロパティが `true` である要素のみを検索します。|  
+|<xref:System.Windows.Automation.TreeWalker.ControlViewWalker>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsControlElement%2A> プロパティが `true` である要素のみを検索します。|  
+|<xref:System.Windows.Automation.TreeWalker.RawViewWalker>|すべての要素を検索します。|  
+  
+ <xref:System.Windows.Automation.TreeWalker> を取得した後、それを使用することは簡単です。`Get` メソッドを呼び出し、サブツリーの要素間を移動するだけです。  
+  
+ <xref:System.Windows.Automation.TreeWalker.Normalize%2A> メソッドを使用すると、ビューの一部ではない要素からサブツリー内の他の要素に移動できます。 たとえば、<xref:System.Windows.Automation.TreeWalker.ContentViewWalker> を使用してサブツリーのビューを作成したとします。 スクロール バーが入力フォーカスを受信したことを示す通知を、アプリケーションが受け取ります。 スクロール バーはコンテンツ要素ではないため、サブツリーのビューには存在しません。 しかし、スクロール バーを表す <xref:System.Windows.Automation.AutomationElement> を <xref:System.Windows.Automation.TreeWalker.Normalize%2A> に渡し、コンテンツ ビュー内にある最も近い先祖を取得することができます。  
+  
+<a name="Other_Ways_to_Retrieve_an_Element"></a>   
+## 要素を取得する別の方法  
+ 検索とナビゲーションに加えて、次の方法で <xref:System.Windows.Automation.AutomationElement> を取得できます。  
+  
+### イベントから  
+ アプリケーションが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを受信するときに、イベント ハンドラーに渡されるソース オブジェクトは <xref:System.Windows.Automation.AutomationElement> です。 たとえば、フォーカス変更イベントをサブスクライブしている場合、<xref:System.Windows.Automation.AutomationFocusChangedEventHandler> に渡されるソースはフォーカスを受け取った要素になります。  
+  
+ 詳細については、「[Subscribe to UI Automation Events](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)」を参照してください。  
+  
+### ポイントから  
+ 画面座標 \(たとえば、カーソル位置\) がある場合、静的 <xref:System.Windows.Automation.AutomationElement.FromPoint%2A> メソッドを使用して <xref:System.Windows.Automation.AutomationElement> を取得できます。  
+  
+### ウィンドウ ハンドルから  
+ HWND から <xref:System.Windows.Automation.AutomationElement> を取得するには、静的 <xref:System.Windows.Automation.AutomationElement.FromHandle%2A> メソッドを使用します。  
+  
+### フォーカスされたコントロールから  
+ 静的 <xref:System.Windows.Automation.AutomationElement.FocusedElement%2A> プロパティから、フォーカスされたコントロールを表す <xref:System.Windows.Automation.AutomationElement> を取得できます。  
+  
+## 参照  
+ [Find a UI Automation Element Based on a Property Condition](../../../docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md)   
+ [Navigate Among UI Automation Elements with TreeWalker](../../../docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md b/docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md
new file mode 100644
index 00000000000..10613aba2b6
--- /dev/null
+++ b/docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md
@@ -0,0 +1,36 @@
+---
+title: "Raise Events from a UI Automation Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, raising events"
+  - "raising UI Automation events"
+ms.assetid: 9fe2f01b-f7d8-49a8-a185-d4472b9976c0
+caps.latest.revision: 13
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 13
+---
+# Raise Events from a UI Automation Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックには、UI オートメーション プロバイダーからイベントを発生させる方法を示すコード例が記載されています。  
+  
+## 使用例  
+ 次の例では、カスタム ボタン コントロールの実装で [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントが発生します。 実装により、UI オートメーション クライアント アプリケーションがボタンのクリックをシミュレートできるようになります。  
+  
+ 不要な処理を回避するために、例では <xref:System.Windows.Automation.Provider.AutomationInteropProvider.ClientsAreListening%2A> をチェックして、イベントが発生するかどうかを確認しています。  
+  
+ [!code-csharp[UIAProvider_snip#150](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAProvider_snip/CSharp/FragmentRoot.cs#150)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/register-a-client-side-provider-assembly.md b/docs/framework/ui-automation/register-a-client-side-provider-assembly.md
new file mode 100644
index 00000000000..f563ecb460f
--- /dev/null
+++ b/docs/framework/ui-automation/register-a-client-side-provider-assembly.md
@@ -0,0 +1,37 @@
+---
+title: "Register a Client-Side Provider Assembly | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "registering client-side provider assemblies"
+  - "client-side provider assemblies, registering"
+  - "UI Automation, registering provider assemblies"
+  - "provider assemblies, registering"
+ms.assetid: a03af4d9-2771-43cc-b07b-d468dca23190
+caps.latest.revision: 8
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 8
+---
+# Register a Client-Side Provider Assembly
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、クライアント側 UI オートメーション プロバイダーを格納する DLL を登録する方法を説明します。  
+  
+## 使用例  
+ 次の例では、コンソール ウィンドウのプロバイダーを格納するアセンブリを登録する方法を示します。  
+  
+ [!code-csharp[UIAClientSideProvider_snip#102](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClientSideProvider_snip/CSharp/CSClientProgram.cs#102)]
+ [!code-vb[UIAClientSideProvider_snip#102](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClientSideProvider_snip/visualbasic/csclientprogram.vb#102)]  
+  
+## 参照  
+ [Create a Client\-Side UI Automation Provider](../../../docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md b/docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md
new file mode 100644
index 00000000000..5e174ef1b36
--- /dev/null
+++ b/docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md
@@ -0,0 +1,37 @@
+---
+title: "Return Properties from a UI Automation Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "providers, UI Automation, returning properties"
+  - "properties, returned by UI Automation providers"
+  - "UI Automation, providers returning properties"
+ms.assetid: 5eba950e-b9e1-48eb-ab8e-b69db76bf589
+caps.latest.revision: 14
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 14
+---
+# Return Properties from a UI Automation Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックのサンプル コードでは、UI オートメーション プロバイダーが、要素のプロパティをクライアント アプリケーションへどのように返すかを示します。  
+  
+ 明示的にサポートしていないプロパティについては、プロバイダーは `null` \(Visual Basic では `Nothing`\) を返す必要があります。 これにより、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] はホスト ウィンドウ プロバイダーなど、別のソースからプロパティを取得しようとします。  
+  
+## 使用例  
+ [!code-csharp[UIAFragmentProvider_snip#117](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFragmentProvider_snip/CSharp/ListFragment.cs#117)]
+ [!code-vb[UIAFragmentProvider_snip#117](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFragmentProvider_snip/VisualBasic/ListFragment.vb#117)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md b/docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md
new file mode 100644
index 00000000000..f4cffb92546
--- /dev/null
+++ b/docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md
@@ -0,0 +1,188 @@
+---
+title: "Server-Side UI Automation Provider Implementation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "server-side UI Automation provider implementation"
+  - "UI Automation, server-side provider implementation"
+  - "provider implementation, UI Automation"
+ms.assetid: 6acc6d08-bd67-4e2e-915c-9c1d34eb86fe
+caps.latest.revision: 39
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 38
+---
+# Server-Side UI Automation Provider Implementation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このセクションでは、カスタム コントロールのサーバー側 UI オートメーション プロバイダーを実装する方法について説明します。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] 要素の実装と非 [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] 要素 \([!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] 向けに設計されたものなど\) の実装は、根本的に異なります。[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] 要素は、<xref:System.Windows.Automation.Peers.AutomationPeer> から派生したクラスを使用して [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] をサポートします。 非 [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] 要素は、プロバイダー インターフェイスの実装を通じてサポートを提供します。  
+  
+<a name="Security_Considerations"></a>   
+## セキュリティの考慮事項  
+ プロバイダーは、部分的に信頼された環境で動作できるように記述する必要があります。 UIAutomationClient.dll は部分的な信頼で動作するように構成されていないため、プロバイダーのコードではこのアセンブリを参照しないでください。 参照している場合、完全に信頼された環境ではコードを実行できますが、部分的に信頼された環境では失敗します。  
+  
+ 具体的には、<xref:System.Windows.Automation.AutomationElement> などの UIAutomationClient.dll のクラスのフィールドを使用しないでください。 代わりに、<xref:System.Windows.Automation.AutomationElementIdentifiers> などの UIAutomationTypes.dll のクラスの同等のフィールドを使用します。  
+  
+<a name="Provider_Implementation_by_WPF_Elements"></a>   
+## Windows Presentation Foundation 要素によるプロバイダーの実装  
+ このトピックの詳細については、「[WPF カスタム コントロールの UI オートメーション](../../../docs/framework/wpf/controls/ui-automation-of-a-wpf-custom-control.md)」を参照してください。  
+  
+<a name="Provider_Implementation_by_non_WPF_Elements"></a>   
+## 非 WPF 要素によるプロバイダーの実装  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] フレームワークの一部ではないが、マネージ コードで記述されたカスタム コントロール \(多くの場合、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] コントロール\) は、インターフェイスを実装することで [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] をサポートします。 すべての要素は、次のセクションの最初のテーブルに示されているインターフェイスを 1 つ以上実装する必要があります。 さらに、要素が 1 つ以上のコントロール パターンをサポートする場合、コントロール パターンごとに適切なインターフェイスを実装する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダー プロジェクトは、次のアセンブリを参照する必要があります。  
+  
+-   UIAutomationProviders.dll  
+  
+-   UIAutomationTypes.dll  
+  
+-   WindowsBase.dll  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Provider_Interfaces"></a>   
+### プロバイダーのインターフェイス  
+ すべての [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーは、次のインターフェイスのいずれかを実装する必要があります。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderSimple>|コントロール パターンやプロパティのサポートを含む、ウィンドウでホストされる単純なコントロールの機能を提供します。|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderFragment>|<xref:System.Windows.Automation.Provider.IRawElementProviderSimple> から継承します。 フラグメント内のナビゲーション、フォーカスの設定、要素の四角形領域の復帰などを含む、複雑なコントロールの要素の機能を追加します。|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderFragmentRoot>|<xref:System.Windows.Automation.Provider.IRawElementProviderFragment> から継承します。 指定した座標での子要素の検索やコントロール全体のフォーカス状態の設定などを含む、複雑なコントロールのルート要素の機能を追加します。|  
+  
+ 次のインターフェイスは追加機能を提供しますが、実装する必要はありません。  
+  
+|インターフェイス|説明|  
+|--------------|--------|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderAdviseEvents>|プロバイダーがイベントの要求を追跡できるようにします。|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderHwndOverride>|フラグメントの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内のウィンドウ ベースの要素の位置を変更できるようにします。|  
+  
+ <xref:System.Windows.Automation.Provider> 名前空間内の他のすべてのインターフェイスは、コントロール パターンをサポートします。  
+  
+<a name="Requirements_for_Non_WPF_Providers"></a>   
+### 非 WPF プロバイダーの要件  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] と通信するために、コントロールは次の主な領域の機能を実装する必要があります。  
+  
+|機能|実装|  
+|--------|--------|  
+|プロバイダーを [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に公開する|コントロール ウィンドウに送信された WM\_GETOBJECT メッセージの応答として、<xref:System.Windows.Automation.Provider.IRawElementProviderSimple> \(または派生インターフェイス\) を実装するオブジェクトを返します。 フラグメントの場合、これはフラグメント ルートのプロバイダーである必要があります。|  
+|プロパティ値を指定する|値を指定または上書きする <xref:System.Windows.Automation.Provider.IRawElementProviderSimple.GetPropertyValue%2A> を実装します。|  
+|クライアントがコントロールと対話できるようにする|<xref:System.Windows.Automation.Provider.IInvokeProvider> などのコントロール パターンをサポートするインターフェイスを実装します。<xref:System.Windows.Automation.Provider.IRawElementProviderSimple.GetPatternProvider%2A> の実装でこれらのパターンのプロバイダーを返します。|  
+|イベントを発生させる|<xref:System.Windows.Automation.Provider.AutomationInteropProvider> のメソッドの 1 つを呼び出して、クライアントがリッスンできるイベントを発生させます。|  
+|フラグメント内のナビゲーションとフォーカス設定を有効にする|フラグメント内の各要素に <xref:System.Windows.Automation.Provider.IRawElementProviderFragment> を実装します  \(フラグメントの一部でない要素に対しては必要ありません\)。|  
+|フラグメント内のフォーカス設定と子要素の配置を有効にする|<xref:System.Windows.Automation.Provider.IRawElementProviderFragmentRoot> を実装します。 \(フラグメント ルートでない要素に対しては必要ありません\)。|  
+  
+<a name="Property_Values_in_Non_WPF_Providers"></a>   
+### 非 WPF プロバイダー内のプロパティ値  
+ カスタム コントロールの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーは、オートメーション システムおよびクライアント アプリケーションで使用できる特定のプロパティをサポートする必要があります。 ウィンドウでホストされている \(HWND\) 要素の場合、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は一部のプロパティを既定のウィンドウ プロバイダーから取得できますが、他のプロパティはカスタム プロバイダーから取得する必要があります。  
+  
+ HWND ベースのコントロールのプロバイダーは通常、次のプロパティを指定する必要はありません \(フィールド値で識別されます\)。  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.ProcessIdProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.ClassNameProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.HasKeyboardFocusProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.IsPasswordProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.RuntimeIdProperty>  
+  
+> [!NOTE]
+>  単純な要素またはウィンドウでホストされているフラグメント ルートの <xref:System.Windows.Automation.AutomationElementIdentifiers.RuntimeIdProperty> は、ウィンドウから取得されます。ただし、ルートの下にあるフラグメント要素 \(リスト ボックス内のリスト項目など\) は独自の識別子を提供する必要があります。 詳細については、「<xref:System.Windows.Automation.Provider.IRawElementProviderFragment.GetRuntimeId%2A>」を参照してください。  
+>   
+>  <xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty> は、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] コントロールでホストされるプロバイダーに返される必要があります。 この場合、ウィンドウの既定のプロバイダーは適切な値を取得できないことがあります。  
+>   
+>  <xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> は通常、ホスト プロバイダーによって提供されます。 たとえば、カスタム コントロールが <xref:System.Windows.Forms.Control> から派生している場合、名前はこのコントロールの `Text` プロパティから派生します。  
+  
+ コード例については、「[Return Properties from a UI Automation Provider](../../../docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md)」を参照してください。  
+  
+<a name="Events_in_Non_WPF_Providers"></a>   
+### 非 WPF プロバイダー内のイベント  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーは、イベントを発生させて、UI の状態の変更をクライアント アプリケーションに通知する必要があります。 イベントを発生させるには、次のメソッドを使用します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Windows.Automation.Provider.AutomationInteropProvider.RaiseAutomationEvent%2A>|コントロール パターンによってトリガーされるイベントを含む、さまざまなイベントを発生させます。|  
+|<xref:System.Windows.Automation.Provider.AutomationInteropProvider.RaiseAutomationPropertyChangedEvent%2A>|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティが変更された場合にイベントを発生させます。|  
+|<xref:System.Windows.Automation.Provider.AutomationInteropProvider.RaiseStructureChangedEvent%2A>|要素の追加や削除などによって [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの構造が変更された場合にイベントを発生させます。|  
+  
+ イベントの目的は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] システム自体によってトリガーされたアクティビティかどうかにかかわらず、何かが [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 内で行われたことをクライアントに通知することです。 たとえば、<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent> によって識別されるイベントは、ユーザーの直接入力の場合でもクライアント アプリケーションの <xref:System.Windows.Automation.InvokePattern.Invoke%2A> 呼び出しの場合でも、コントロールが呼び出されるたびに発生させる必要があります。  
+  
+ パフォーマンスを最適化するため、プロバイダーは選択的にイベントを発生させたり、イベントを受け取るクライアント アプリケーションが登録されていないときにはイベントを発生させないようにすることができます。 最適化には、次のメソッドを使用します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Windows.Automation.Provider.AutomationInteropProvider.ClientsAreListening%2A>|この静的プロパティは、クライアント アプリケーションが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントにサブスクライブしているかどうかを指定します。|  
+|<xref:System.Windows.Automation.Provider.IRawElementProviderAdviseEvents>|プロバイダーがこのインターフェイスをフラグメント ルートに実装すると、クライアントがフラグメント上のイベント用のイベント ハンドラーを登録および登録解除したときに通知されるようにすることができます。|  
+  
+<a name="Non_WPF_Provider_Navigation"></a>   
+### 非 WPF プロバイダーのナビゲーション  
+ ウィンドウでホストされる \(HWND\) カスタム ボタンなどの単純なコントロールのプロバイダーは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内のナビゲーションをサポートする必要はありません。 要素間のナビゲーションは、ホスト ウィンドウの既定のプロバイダーによって処理されます。これは、<xref:System.Windows.Automation.Provider.IRawElementProviderSimple.HostRawElementProvider%2A> の実装で指定されます。 ただし、複雑なカスタム コントロール用のプロバイダーを実装する場合は、フラグメントのルート ノードと子孫ノード、および兄弟ノード間のナビゲーションをサポートする必要があります。  
+  
+> [!NOTE]
+>  ルート以外のフラグメントの要素は、<xref:System.Windows.Automation.Provider.IRawElementProviderSimple.HostRawElementProvider%2A> から `null` 参照を返す必要があります。これらが直接ウィンドウでホストされておらず、これらの間のナビゲーションをサポートできる既定のプロバイダーがないためです。  
+  
+ フラグメントの構造は、<xref:System.Windows.Automation.Provider.IRawElementProviderFragment.Navigate%2A> の実装によって決まります。 このメソッドは、各フラグメントから可能なそれぞれの方向に対して、その方向の要素に対するプロバイダー オブジェクトを返します。 その方向に要素がない場合、メソッドは `null` 参照を返します。  
+  
+ フラグメント ルートは、子要素へのナビゲーションのみをサポートします。 たとえば、リスト ボックスは、方向が <xref:System.Windows.Automation.Provider.NavigateDirection> の場合はリスト内の最初の項目を、方向が <xref:System.Windows.Automation.Provider.NavigateDirection> の場合は最後の項目を返します。 フラグメント ルートは、親または兄弟へのナビゲーションをサポートしません。これはホスト ウィンドウ プロバイダーによって処理されます。  
+  
+ ルート以外のフラグメントの要素は、親へのナビゲーションと、\(存在する場合は\) 兄弟や子へのナビゲーションをサポートする必要があります。  
+  
+<a name="Non_WPF_Provider_Reparenting"></a>   
+### 非 WPF プロバイダーの親の変更  
+ ポップアップ ウィンドウは、実際には最上位のウィンドウであり、既定ではデスクトップの子として [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーに表示されます。 ただし、多くの場合、ポップアップ ウィンドウは論理的には他のコントロールの子になります。 たとえば、コンボ ボックスのドロップダウン リストは、論理的にはコンボ ボックスの子です。 同様に、メニューのポップアップ ウィンドウは、論理的にはメニューの子になります。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] はポップアップ ウィンドウの親の変更をサポートしているため、ポップアップ ウィンドウを関連するコントロールの子として表示できます。  
+  
+ ポップアップ ウィンドウの親を変更するには:  
+  
+1.  ポップアップ ウィンドウ用のプロバイダーを作成します。 これには、ポップアップ ウィンドウのクラスを事前に知っておく必要があります。  
+  
+2.  そのポップアップ自体がコントロールであるかのように、ポップアップのすべてのプロパティとパターンを通常どおりに実装します。  
+  
+3.  <xref:System.Windows.Automation.Provider.IRawElementProviderSimple.HostRawElementProvider%2A> プロパティを実装し、<xref:System.Windows.Automation.Provider.AutomationInteropProvider.HostProviderFromHandle%2A> から取得した値を返せるようにします。パラメーターは、ポップアップ ウィンドウのウィンドウ ハンドルです。  
+  
+4.  ポップアップ ウィンドウとその親の <xref:System.Windows.Automation.Provider.IRawElementProviderFragment.Navigate%2A> を実装し、論理上の親から論理上の子へのナビゲーションおよび子の兄弟間のナビゲーションが適切に処理されるようにします。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、ポップアップ ウィンドウを検出すると、既定のナビゲーションがオーバーライドされていると認識し、デスクトップの子として検出されたポップアップ ウィンドウをスキップします。 代わりに、ノードはフラグメントによってのみ、到達可能になります。  
+  
+ コントロールが任意のクラスのウィンドウをホストできる場合には、親の変更は適切ではありません。 たとえば、Rebar はそのバンド内で任意の型の HWND をホストできます。 このような場合を処理するため、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は次のセクションで説明する、別の形の HWND 再配置をサポートしています。  
+  
+<a name="Non_WPF_Provider_Repositioning"></a>   
+### 非 WPF プロバイダーの再配置  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] フラグメントは、それぞれウィンドウ \(HWND\) に含まれる 2 つ以上の要素を含んでいる場合があります。 各 HWND には独自の既定のプロバイダーがあり、その HWND を含む HWND をその親と見なしているため、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーは既定で、HWND を親ウィンドウの子としてフラグメント内に表示します。 ほとんどの場合、これは適切な動作ですが、場合によっては [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の論理構造が一致しないために混乱を招く可能性があります。  
+  
+ 良い例が Rebar コントロールです。 Rebar はバンドを格納し、各バンドはツール バー、編集ボックス、コンボ ボックスなど HWND ベースのコントロールを格納します。 Rebar HWND の既定のウィンドウ プロバイダーは、バンド コントロール HWND を子と見なし、Rebar プロバイダーはバンドを子と見なします。 HWND プロバイダーと Rebar プロバイダーは連動し、互いの子を結合するため、バンドと HWND ベースのコントロールはどちらも Rebar の子として表示されます。 ただし、論理的には、バンドのみが Rebar の子として表示され、各バンド プロバイダーは、格納されるコントロールの既定の HWND プロバイダーと結合される必要があります。  
+  
+ これを実現するため、Rebar のフラグメント ルート プロバイダーは、バンドを表す子のセットを公開します。 各バンドには、プロパティとパターンを公開するプロバイダーが 1 つあります。 その <xref:System.Windows.Automation.Provider.IRawElementProviderSimple.HostRawElementProvider%2A> の実装で、バンド プロバイダーはコントロール HWND の既定のウィンドウ プロバイダーを返します。これを取得するには、コントロールのウィンドウ ハンドルを渡して <xref:System.Windows.Automation.Provider.AutomationInteropProvider.HostProviderFromHandle%2A> を呼び出します。 最後に、Rebar のフラグメント ルート プロバイダーは <xref:System.Windows.Automation.Provider.IRawElementProviderHwndOverride> インターフェイスを実装し、その <xref:System.Windows.Automation.Provider.IRawElementProviderHwndOverride.GetOverrideProviderForHwnd%2A> の実装で、指定した HWND に含まれるコントロールの適切なバンド プロバイダーを返します。  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Expose a Server\-side UI Automation Provider](../../../docs/framework/ui-automation/expose-a-server-side-ui-automation-provider.md)   
+ [Return Properties from a UI Automation Provider](../../../docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md)   
+ [Raise Events from a UI Automation Provider](../../../docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md)   
+ [Enable Navigation in a UI Automation Fragment Provider](../../../docs/framework/ui-automation/enable-navigation-in-a-ui-automation-fragment-provider.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [Simple Provider Sample](http://msdn.microsoft.com/ja-jp/c10a6255-e8dc-494b-a051-15111b47984a)   
+ [Fragment Provider Sample](http://msdn.microsoft.com/ja-jp/778ef1bc-8610-4bc9-886e-aeff94a8a13e)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/subscribe-to-ui-automation-events.md b/docs/framework/ui-automation/subscribe-to-ui-automation-events.md
new file mode 100644
index 00000000000..a83a9a8127b
--- /dev/null
+++ b/docs/framework/ui-automation/subscribe-to-ui-automation-events.md
@@ -0,0 +1,46 @@
+---
+title: "UI オートメーション イベントのサブスクライブ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI オートメーション、イベントにサブスクライブします。"
+  - "サブスクライブ (UI オートメーション イベントを)"
+  - "イベントをサブスクライブするには"
+  - "リッスン (イベントを)"
+ms.assetid: b688effa-b3e8-4b05-944d-05ed89a245aa
+caps.latest.revision: 16
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 16
+---
+# UI オートメーション イベントのサブスクライブ
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックでは、UI オートメーション プロバイダーによって生成されるイベントをサブスクライブする方法について説明します。  
+  
+## <a name="example"></a>例  
+ 次のコード例では、ボタンなどのコントロールが呼び出された場合に生成されるイベントに対してイベント ハンドラーを登録し、アプリケーション フォームが閉じられた時にそのイベント ハンドラーを削除します。 イベントがで識別される、 <xref:System.Windows.Automation.AutomationEvent>をパラメーターとして渡された<xref:System.Windows.Automation.Automation.AddAutomationEventHandler%2A>します。  
+  
+ [!code-csharp[UIAClient_snip#101](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#101)]
+ [!code-vb[UIAClient_snip#101](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#101)]  
+  
+## <a name="example"></a>例  
+ 次の例は、使用する方法を示しています。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]フォーカスが変更されたときに発生するイベントを定期受信します。 イベント ハンドラーの登録は、アプリケーションのシャットダウン時に呼び出されるメソッドで解除されるか、UI イベントの通知が必要なくなった時に解除されます。  
+  
+ [!code-csharp[UIAClient_snip#102](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#102)]
+ [!code-vb[UIAClient_snip#102](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#102)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Automation.Automation.AddAutomationEventHandler%2A>   
+ <xref:System.Windows.Automation.Automation.RemoveAllEventHandlers%2A>   
+ <xref:System.Windows.Automation.Automation.RemoveAutomationEventHandler%2A>   
+ [UI オートメーション イベントの概要](../../../docs/framework/ui-automation/ui-automation-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md b/docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md
new file mode 100644
index 00000000000..90f5f32edf5
--- /dev/null
+++ b/docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md
@@ -0,0 +1,48 @@
+---
+title: "Support Control Patterns in a UI Automation Provider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns, supporting in UI Automation provider"
+  - "UI Automation, supporting control patterns in provider"
+ms.assetid: 0d635c35-ffa8-4dc8-bbc9-12fcd5445776
+caps.latest.revision: 13
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 13
+---
+# Support Control Patterns in a UI Automation Provider
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、クライアント アプリケーションがコントロールを操作して、それらからデータを取得できるように、UI オートメーション プロバイダーに 1 つ以上のコントロール パターンを実装する方法を説明します。  
+  
+### コントロール パターンのサポート  
+  
+1.  <xref:System.Windows.Automation.InvokePattern> の <xref:System.Windows.Automation.Provider.IInvokeProvider> など、要素がサポートする必要のあるコントロール パターンの適切なインターフェイスを実装します。  
+  
+2.  <xref:System.Windows.Automation.Provider.IRawElementProviderSimple.GetPatternProvider%2A?displayProperty=fullName> の実装で各コントロール インターフェイスの実装を格納するオブジェクトを返します。  
+  
+## 使用例  
+ 単一選択のカスタム リスト ボックスの <xref:System.Windows.Automation.Provider.ISelectionProvider> の実装例を次に示します。 3 つのプロパティを返し、現在選択されている項目を取得します。  
+  
+ [!code-csharp[UIAFragmentProvider_snip#119](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFragmentProvider_snip/CSharp/ListPattern.cs#119)]
+ [!code-vb[UIAFragmentProvider_snip#119](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFragmentProvider_snip/VisualBasic/ListPattern.vb#119)]  
+  
+## 使用例  
+ <xref:System.Windows.Automation.Provider.ISelectionProvider> を実装するクラスを返す <xref:System.Windows.Automation.Provider.IRawElementProviderSimple.GetPatternProvider%2A> の実装例を次に示します。 ほとんどのリスト ボックス コントロールは、同様にその他のパターンをサポートしますが、次の例では、他のすべてのパターン識別子に対して null 参照 \([!INCLUDE[TLA#tla_visualbnet](../../../includes/tlasharptla-visualbnet-md.md)] の `Nothing`\) が返されます。  
+  
+ [!code-csharp[UIAFragmentProvider_snip#120](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAFragmentProvider_snip/CSharp/ListFragment.cs#120)]
+ [!code-vb[UIAFragmentProvider_snip#120](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAFragmentProvider_snip/VisualBasic/ListFragment.vb#120)]  
+  
+## 参照  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/textpattern-and-embedded-objects-overview.md b/docs/framework/ui-automation/textpattern-and-embedded-objects-overview.md
new file mode 100644
index 00000000000..c0531df2b37
--- /dev/null
+++ b/docs/framework/ui-automation/textpattern-and-embedded-objects-overview.md
@@ -0,0 +1,166 @@
+---
+title: "TextPattern and Embedded Objects Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, TextPattern class"
+  - "embedded objects, accessing"
+  - "accessing embedded objects"
+  - "embedded objects, UI Automation"
+ms.assetid: 93fdfbb9-0025-4b72-8ca0-0714adbb70d5
+caps.latest.revision: 17
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 17
+---
+# TextPattern and Embedded Objects Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ この概要では、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]がテキスト ドキュメントまたはコンテナー内で埋め込みオブジェクトや子要素を公開する方法について説明します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]では、埋め込みオブジェクトは、テキスト以外の境界を持つ任意の要素です。たとえば、イメージ、ハイパーリンク、テーブル、ドキュメントの種類 \([!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)] スプレッドシートや [!INCLUDE[TLA#tla_winmedia](../../../includes/tlasharptla-winmedia-md.md)] ファイルなど\) があります。 これは、あるアプリケーションで要素が作成され、別のアプリケーション内に埋め込まれる \(リンクされる\) 標準的な定義とは異なります。 オブジェクトを元のアプリケーション内で編集できるかどうかは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の状況とは無関係です。  
+  
+<a name="Embedded_Objects_and_the_UI_Automation_Tree"></a>   
+## 埋め込みオブジェクトと UI オートメーション ツリー  
+ 埋め込みオブジェクトは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビュー内では個々の要素として扱われます。 これらはテキスト コンテナーの子として公開され、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の他のコントロールと同じモデルを介してアクセスできます。  
+  
+ ![テキスト コンテナー内にイメージを含む埋め込みテーブル](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-example1.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_Example1")  
+テーブル、イメージ、ハイパーリンクの埋め込みオブジェクトを含むテキスト コンテナーの例  
+  
+ ![前の例の内容ビュー](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-example2.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_Example2")  
+前のテキスト コンテナーの一部のコンテンツ ビューの例  
+  
+<a name="Expose_Embedded_Objects_Using_TextPattern_and"></a>   
+## TextPattern と TextPatternRange を使用した埋め込みオブジェクトの公開  
+ <xref:System.Windows.Automation.TextPattern> コントロール パターン クラスと <xref:System.Windows.Automation.Text.TextPatternRange> クラスを組み合わせて使用すると、埋め込みオブジェクトのナビゲーションと照会を容易にするメソッドとプロパティが公開されます。  
+  
+ テキスト コンテナーのテキスト コンテンツ \(内部テキスト\) と埋め込みオブジェクト \(ハイパーリンクやテーブルのセルなど\) は、連続する単一のテキスト ストリームとして、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューの両方で公開されます。そのため、オブジェクトの境界は無視されます。 UI オートメーション クライアントがなんらかの方法で列挙、解釈、分析を目的としてテキストを取得している場合、テキスト コンテンツを含むテーブルやその他の埋め込みオブジェクトなど、特殊なケースについて、テキスト範囲を確認する必要があります。 これを行うには、<xref:System.Windows.Automation.Text.TextPatternRange.GetChildren%2A> を呼び出して各埋め込みオブジェクトの <xref:System.Windows.Automation.AutomationElement> を取得した後、<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> を呼び出して各要素のテキスト範囲を取得します。 この操作は、すべてのテキスト コンテンツが取得されるまで再帰的に行われます。  
+  
+ ![埋め込みオブジェクトにまたがるテキスト範囲。](../../../docs/framework/ui-automation/media/uia-textpattern-embeddedobjecttextranges.png "UIA\_TextPattern\_EmbeddedObjectTextRanges")  
+埋め込みオブジェクトとその範囲を含むテキスト ストリームの例  
+  
+ テキスト範囲の内容を走査する必要がある場合、<xref:System.Windows.Automation.Text.TextPatternRange.Move%2A> メソッドを正常に実行するために、一連の手順がその背後で関係しています。  
+  
+1.  テキスト範囲は正規化されます。つまり、テキスト範囲は <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントで低次元テキスト範囲に縮小されるため、<xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントは不要になります。 この手順は、テキスト範囲が複数の <xref:System.Windows.Automation.Text.TextUnit> 境界にまたがる状況であいまいさをなくすために必要です。たとえば、"{" と "}" がテキスト範囲エンドポイントである "{The U}RL [http:\/\/www.microsoft.com](http://www.microsoft.com) is embedded in text" のような場合です。  
+  
+2.  結果として得られる範囲は、<xref:System.Windows.Automation.TextPattern.DocumentRange%2A> 内で、要求された <xref:System.Windows.Automation.Text.TextUnit> 境界の先頭に向かって後方に移動されます。  
+  
+3.  この範囲は、<xref:System.Windows.Automation.TextPattern.DocumentRange%2A> 内で、<xref:System.Windows.Automation.Text.TextUnit> 境界の要求された数だけ、前方または後方に移動されます。  
+  
+4.  その後、この範囲は、要求された 1 つの <xref:System.Windows.Automation.Text.TextUnit> 境界の分、<xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントを移動することによって、低次元テキスト範囲の状態から展開されます。  
+  
+ ![Move & ExpandToEnclosingUnit による範囲調整](../../../docs/framework/ui-automation/media/uia-textpattern-moveandexpand-examples.png "UIA\_TextPattern\_MoveAndExpand\_Examples")  
+テキスト範囲を Move\(\) と ExpandToEnclosingUnit\(\) に対して調整する方法の例  
+  
+<a name="Common_Scenarios"></a>   
+## 一般的なシナリオ  
+ 以下のセクションでは、埋め込みオブジェクトが関連する最も一般的なシナリオの例を紹介します。  
+  
+ この例で使用される凡例は次のとおりです。  
+  
+ { \= <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint>  
+  
+ } \= <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint>  
+  
+<a name="Hyperlink"></a>   
+### ハイパーリンク  
+ **例 1: 埋め込みテキスト ハイパーリンクを含むテキスト範囲**  
+  
+ {The URL [http:\/\/www.microsoft.com](http://www.microsoft.com) is embedded in text}.  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A>|文字列 "The URL http:\/\/www.microsoft.com is embedded in text" を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト範囲を囲む最も内側の <xref:System.Windows.Automation.AutomationElement> を返します。この場合は、テキスト プロバイダー自体を表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetChildren%2A>|ハイパーリンク コントロールを表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> \(<xref:System.Windows.Automation.AutomationElement> は、前の `GetChildren` メソッドから返されるオブジェクト\)|"http:\/\/www.microsoft.com" を表す範囲を返します。|  
+  
+ **例 2: 埋め込みテキスト ハイパーリンクに部分的にかかるテキスト範囲**  
+  
+ The URL http:\/\/{[www](www)} is embedded in text.  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A>|文字列 "www" を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト範囲を囲む最も内側の <xref:System.Windows.Automation.AutomationElement> を返します。この場合は、ハイパーリンク コントロールです。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetChildren%2A>|テキスト範囲が URL 文字列全体をカバーしていないため、`null` を返します。|  
+  
+ **例 3: テキスト コンテナーのコンテンツに部分的にかかるテキスト範囲 テキスト コンテナーには、テキスト範囲に含まれない埋め込みテキスト ハイパーリンクが含まれます。**  
+  
+ {The URL} [http:\/\/www.microsoft.com](http://www.microsoft.com) is embedded in text.  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A>|文字列 "The URL" を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト範囲を囲む最も内側の <xref:System.Windows.Automation.AutomationElement> を返します。この場合は、テキスト プロバイダー自体を表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.Move%2A> \(パラメーターは \(TextUnit.Word, 1\)\)|ハイパーリンクのテキストは個々の単語で構成されているため、テキスト範囲は "http" に移動します。 この場合、ハイパーリンクは 1 つのオブジェクトとして扱われません。<br /><br /> The URL {[http](../../../ocs/framework/network-programming/http.md)} is embedded in text.|  
+  
+<a name="Image"></a>   
+### イメージ  
+ **例 1: 埋め込みイメージを含むテキスト範囲**  
+  
+ {The image ![埋め込みイメージの例](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample") is embedded in text}.  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A>|文字列 "The is embedded in text" を返します。 イメージに関連付けられた代替テキストがテキスト ストリームに含まれることはありません。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト範囲を囲む最も内側の <xref:System.Windows.Automation.AutomationElement> を返します。この場合は、テキスト プロバイダー自体を表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetChildren%2A>|イメージ コントロールを表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> \(<xref:System.Windows.Automation.AutomationElement> は、前の <xref:System.Windows.Automation.Text.TextPatternRange.GetChildren%2A> メソッドから返されるオブジェクト\)|"![埋め込みイメージの例](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample")" を表す低次元テキスト範囲を返します。|  
+  
+ **例 2: テキスト コンテナーのコンテンツに部分的にかかるテキスト範囲 テキスト コンテナーには、テキスト範囲に含まれない埋め込みイメージが含まれます。**  
+  
+ {The image} ![埋め込みイメージの例](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample") is embedded in text.  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A>|文字列 "The image" を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト範囲を囲む最も内側の <xref:System.Windows.Automation.AutomationElement> を返します。この場合は、テキスト プロバイダー自体を表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|<xref:System.Windows.Automation.Text.TextPatternRange.Move%2A> \(パラメーターは \(TextUnit.Word, 1\)\)|テキスト範囲は "is " に移動します。 テキスト ベースの埋め込みオブジェクトのみがテキスト ストリームの一部と見なされるため、この例のイメージは Move やその戻り値 \(この場合は 1\) に影響を与えません。|  
+  
+<a name="Table"></a>   
+### テーブル  
+  
+### 例で使用するテーブル  
+  
+|イメージを含むセル|テキストを含むセル|  
+|---------------|---------------|  
+|![埋め込みイメージの例](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample")|X|  
+|![埋め込みイメージの例 2](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample2.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample2")|Y|  
+|![埋め込みイメージの例 3](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample3.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample3")<br /><br /> Z のイメージ|Z|  
+  
+ **例 1: セルのコンテンツからテキスト コンテナーを取得する**  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.GridPattern.GetItem%2A> \(パラメーターは \(0, 0\)\)|セルのコンテンツを表す <xref:System.Windows.Automation.AutomationElement> を返します。この場合、要素はテキスト コントロールです。|  
+|<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> \(<xref:System.Windows.Automation.AutomationElement> は、前の `GetItem` メソッドから返されるオブジェクト\)|イメージ ![埋め込みイメージの例](../../../docs/framework/ui-automation/media/uia-textpattern-embedded-objects-overview-imageexample.png "UIA\_TextPattern\_Embedded\_Objects\_Overview\_ImageExample") をカバーする範囲を返します。|  
+|前の `RangeFromChild` メソッドから返されるオブジェクトの <xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|セルを表す <xref:System.Windows.Automation.AutomationElement> を返します。この場合、要素は TableItemPattern をサポートするテキスト コントロールです。|  
+|前の `GetEnclosingElement` メソッドから返されるオブジェクトの <xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テーブルを表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+|前の `GetEnclosingElement` メソッドから返されるオブジェクトの <xref:System.Windows.Automation.Text.TextPatternRange.GetEnclosingElement%2A>|テキスト プロバイダー自体を表す <xref:System.Windows.Automation.AutomationElement> を返します。|  
+  
+ **例 2: セルのテキスト コンテンツを取得する**  
+  
+|呼び出されるメソッド|結果|  
+|----------------|--------|  
+|<xref:System.Windows.Automation.GridPattern.GetItem%2A> \(パラメーターは \(1, 1\)\)|セルのコンテンツを表す <xref:System.Windows.Automation.AutomationElement> を返します。この場合、要素はテキスト コントロールです。|  
+|<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> \(<xref:System.Windows.Automation.AutomationElement> は、前の `GetItem` メソッドから返されるオブジェクト\)|"Y" を返します。|  
+  
+## 参照  
+ <xref:System.Windows.Automation.TextPattern>   
+ <xref:System.Windows.Automation.Text.TextPatternRange>   
+ <xref:System.Windows.Automation.Provider.ITextProvider>   
+ <xref:System.Windows.Automation.Provider.ITextRangeProvider>   
+ [Access Embedded Objects Using UI Automation](../../../docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md)   
+ [Expose the Content of a Table Using UI Automation](../../../docs/framework/ui-automation/expose-the-content-of-a-table-using-ui-automation.md)   
+ [Traverse Text Using UI Automation](../../../docs/framework/ui-automation/traverse-text-using-ui-automation.md)   
+ [TextPattern Search and Selection Sample](http://msdn.microsoft.com/ja-jp/0a3bca57-8b72-489d-a57c-da85b7a22c7f)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/traverse-text-using-ui-automation.md b/docs/framework/ui-automation/traverse-text-using-ui-automation.md
new file mode 100644
index 00000000000..0aea5b49f40
--- /dev/null
+++ b/docs/framework/ui-automation/traverse-text-using-ui-automation.md
@@ -0,0 +1,49 @@
+---
+title: "Traverse Text Using UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, traversing text"
+  - "text, traversing"
+  - "traversing text"
+ms.assetid: 3ddb3b7b-1d6b-4dba-8678-5a68e868aadb
+caps.latest.revision: 11
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 11
+---
+# Traverse Text Using UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]を使用して、<xref:System.Windows.Automation.Text.TextUnit> ずつインクリメントしながらドキュメントのテキスト コンテンツを走査する方法を示します。  
+  
+## 使用例  
+ 次のコード例では、UI オートメーション テキスト プロバイダーのコンテンツを走査する方法を示しています。<xref:System.Windows.Automation.Text.TextPatternRange.Move%2A> メソッドは、<xref:System.Windows.Automation.Text.TextPatternRange> の <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントと <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントを移動させます。 このテキスト範囲は、通常、テキスト挿入ポイントを表す低次元テキスト範囲です。  
+  
+> [!NOTE]
+>  テキスト ベースの埋め込みオブジェクトのみがテキスト ストリームの一部と見なされるため、イメージなどの埋め込みオブジェクトは、`Move` またはその戻り値に影響を与えません。  
+  
+ [!code-csharp[FindText#StartApp](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#startapp)]
+ [!code-vb[FindText#StartApp](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#startapp)]  
+[!code-csharp[FindText#FindTextProvider](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#findtextprovider)]
+[!code-vb[FindText#FindTextProvider](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#findtextprovider)]  
+[!code-csharp[FindText#Navigate](../../../samples/snippets/csharp/VS_Snippets_Wpf/FindText/CSharp/SearchWindow.cs#navigate)]
+[!code-vb[FindText#Navigate](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindText/VisualBasic/SearchWindow.vb#navigate)]  
+  
+ 指定した <xref:System.Windows.Automation.Text.TextUnit> をコントロールがサポートしない場合、<xref:System.Windows.Automation.Text.TextUnit> を使用するすべてのメソッドは、サポートされる次に大きい <xref:System.Windows.Automation.Text.TextUnit> を使用します。  
+  
+## 参照  
+ [UI Automation TextPattern Overview](../../../docs/framework/ui-automation/ui-automation-textpattern-overview.md)   
+ [Add Content to a Text Box Using UI Automation](../../../docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md)   
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-and-microsoft-active-accessibility.md b/docs/framework/ui-automation/ui-automation-and-microsoft-active-accessibility.md
new file mode 100644
index 00000000000..7e07ef5b7ea
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-and-microsoft-active-accessibility.md
@@ -0,0 +1,260 @@
+---
+title: "UI Automation and Microsoft Active Accessibility | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Active Accessibility"
+  - "UI Automation, Active Accessibility compared to"
+  - "UI Automation, Microsoft Active Accessibility"
+  - "Active Accessibility, UI Automation compared to"
+ms.assetid: 87bee662-0a3e-4232-a421-20e7a5968321
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# UI Automation and Microsoft Active Accessibility
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ アプリケーションをアクセス可能にするための以前のソリューションは [!INCLUDE[TLA#tla_aa](../../../includes/tlasharptla-aa-md.md)] です。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] は [!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] の新しいユーザー補助モデルであり、その目的は支援技術製品と自動テスト ツールのニーズを解決することです。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は多くの点で [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] よりも強化されています。  
+  
+ このトピックでは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の主な機能を紹介し、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] との違いについて説明します。  
+  
+<a name="Programming_Languages_compare"></a>   
+## プログラミング言語  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] は [!INCLUDE[TLA#tla_com](../../../includes/tlasharptla-com-md.md)] をベースにしてデュアル インターフェイスをサポートしているため、C\/C\+\+、[!INCLUDE[TLA#tla_vb6](../../../includes/tlasharptla-vb6-md.md)]、およびスクリプト言語でプログラムすることができます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] \(標準コントロールのクライアント側プロバイダー ライブラリを含む\) はマネージ コードで記述されており、[!INCLUDE[TLA#tla_vcshrp](../../../includes/tlasharptla-vcshrp-md.md)] または [!INCLUDE[TLA#tla_visualbnet](../../../includes/tlasharptla-visualbnet-md.md)] を使用して UI オートメーション クライアント アプリケーションを実に簡単にプログラムすることができます。 インターフェイスを実装する UI オートメーション プロバイダーは、マネージ コードまたは C\/C\+\+ で記述できます。  
+  
+<a name="Support_in_Windows_Presentation_Foundation_"></a>   
+## Windows Presentation Foundation におけるサポート  
+ [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] はユーザー インターフェイスを作成するための新しいモデルです。[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] の要素には [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] のネイティブ サポート機能はありませんが、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] をサポートしており、これに [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] クライアントのためのブリッジ サポートが含まれています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 専用に作成されたクライアントだけが [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] のユーザー補助機能 \(テキストに関する豊富なサポートなど\) を最大限に利用できます。  
+  
+<a name="Servers_and_Clients_compare"></a>   
+## サーバーとクライアント  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] では、サーバーとクライアントは、主にサーバーによる `IAccessible` の実装を介して直接通信します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、サーバー \(プロバイダー\) とクライアントの間にコア サービスが存在します。 このコア サービスは、プロバイダーによって実装されたインターフェイスを呼び出して、追加のサービス \(要素の一意のランタイム識別子の生成など\) を提供します。 クライアント アプリケーションはライブラリ関数を使用して [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サービスを呼び出します。  
+  
+ UI オートメーション プロバイダーは [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] クライアントに情報を提供でき、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーは UI オートメーション クライアント アプリケーションに情報を提供できます。 ただし、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] は [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ほど多くの情報を公開しないため、この 2 つのモデルには完全な互換性がありません。  
+  
+<a name="UI_Elements_compare"></a>   
+## UI 要素  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] では [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素を `IAccessible` インターフェイスまたは子識別子として表現します。 2 つの `IAccessible` ポインターを比較してそれらが同じ要素を参照しているかどうかを判断するのは困難です。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、すべての要素が <xref:System.Windows.Automation.AutomationElement> オブジェクトとして表現されます。 比較は等値演算子または <xref:System.Windows.Automation.AutomationElement.Equals%2A> メソッドを使用して行われますが、どちらの方法でも、要素の一意のランタイム識別子が比較されます。  
+  
+<a name="Tree_Views_and_Navigation_compare"></a>   
+## ツリー ビューとナビゲーション  
+ 画面上の [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素は、ツリー構造で表すことができます。デスクトップがルートで、その直接の子としてアプリケーション ウィンドウがあり、アプリケーション内の要素がその子孫となります。  
+  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] では、エンドユーザーには無関係なオートメーション要素も多数、ツリー内に公開されます。 クライアント アプリケーションは、すべての要素の中から意味のあるものを特定する必要があります。  
+  
+ UI オートメーション クライアント アプリケーションは、フィルタリングしたビューを使用して [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を確認します。 このビューには、必要な要素 \(ユーザーに情報を提供したり、対話を可能にしたりする要素\) のみが表示されます。 コントロール要素だけが含まれるビューや、コンテンツ要素だけが含まれるビューがあらかじめ定義されています。さらに、アプリケーションでカスタム ビューを定義することもできます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、ユーザーに対して [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を簡単に表せるようにして、ユーザーとアプリケーションの対話を支援します。  
+  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] における要素間ナビゲーションは、空間的 \(画面上で左にある要素に移動するなど\)、論理的 \(次のメニュー項目に移動する、ダイアログ ボックスのタブ オーダー内で次の項目に移動するなど\)、階層的 \(コンテナー内の最初の子に移動する、子からその親に移動するなど\) のいずれかです。 子要素が `IAccessible` を実装しているオブジェクトであるとは限らないため、階層的ナビゲーションは複雑です。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素は、同じ基本機能をサポートする <xref:System.Windows.Automation.AutomationElement> オブジェクトです  \(プロバイダーの観点では、<xref:System.Windows.Automation.Provider.IRawElementProviderSimple> から継承されたインターフェイスを実装するオブジェクトです\)。 ナビゲーションは主に階層的 \(親から子、兄弟から次の兄弟\) です  \(兄弟間のナビゲーションは、タブ オーダーに従う場合があるため、論理的要素も持っています\)。 フィルタリングされたツリー ビューで <xref:System.Windows.Automation.TreeWalker> クラスを使用して、任意の場所からナビゲーションを開始できます。<xref:System.Windows.Automation.AutomationElement.FindFirst%2A> と <xref:System.Windows.Automation.AutomationElement.FindAll%2A> を使用して、特定の子または子孫に移動することもできます。たとえば、指定したコントロール パターンがサポートされるダイアログ ボックス内のすべての要素を非常に簡単に取得できます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] におけるナビゲーションは [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] におけるナビゲーションより一貫性があります。 ドロップダウン リストやポップアップ ウィンドウなど、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] ツリーに 2 回表示される要素がありますが、このような要素からナビゲーションすると、予期しない結果が生じる可能性があります。 実際には、rebar コントロールに対して [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] を正しく実装することは不可能です。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では親の再指定や位置の変更が可能なため、ウィンドウの所有関係による階層にかかわらず、要素をツリー内の任意の場所に配置できます。  
+  
+<a name="Roles_and_Control_Types"></a>   
+## 役割とコントロール型  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] は、`accRole` プロパティ \(`IAccessible::get_actRole`\) を使用して、ROLE\_SYSTEM\_SLIDER や ROLE\_SYSTEM\_MENUITEM などの [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 内の要素のｙｗの記述を取得します。 要素の役割は、要素の機能を表す主要な鍵になります。 コントロールとの対話は、`IAccessible::accSelect` や `IAccessible::accDoDefaultAction` などの固定のメソッドを使用して実現されます。 クライアント アプリケーションと [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の間の対話は、`IAccessible` を通して実行できる範囲に限定されます。  
+  
+ これに対して、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、要素のコントロール型 \(<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ControlType%2A> プロパティで記述\) と、その要素に期待される機能とが大きく分離されています。 機能は、特殊なインターフェイスの実装を通じてプロバイダーによってサポートされる、コントロール パターンによって決定されます。 複数のコントロール パターンを組み合わせると、特定の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素がサポートする機能をすべて記述することができます。 プロバイダーによっては、ある 1 つの特定のコントロール パターンをサポートしなければならないものがあります。たとえば、チェック ボックスのプロバイダーは Toggle コントロール パターンをサポートする必要があります。 また、コントロール パターンのセットを 1 つ以上サポートしなければならないものもあります。たとえば、ボタンは、Toggle と Invoke のいずれかをサポートする必要があります。 さらに、コントロール パターンをまったくサポートしないものもあります。たとえば、移動もサイズ変更もドッキングもできないペインには、コントロール パターンはありません。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、<xref:System.Windows.Automation.ControlType.Custom> プロパティによって識別され、<xref:System.Windows.Automation.AutomationElement.LocalizedControlTypeProperty> プロパティによって記述可能なカスタム コントロールをサポートします。  
+  
+ 次の表に、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の役割と [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のコントロール型のマッピングを示します。  
+  
+|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の役割|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のコントロール型|  
+|---------------------------------------------------------------------|------------------------------------------------------------------------------------|  
+|ROLE\_SYSTEM\_PUSHBUTTON|ボタン|  
+|ROLE\_SYSTEM\_CLIENT|予定表|  
+|ROLE\_SYSTEM\_CHECKBUTTON|チェック ボックス|  
+|ROLE\_SYSTEM\_COMBOBOX|コンボ ボックス|  
+|ROLE\_SYSTEM\_CLIENT|カスタム|  
+|ROLE\_SYSTEM\_LIST|データ グリッド|  
+|ROLE\_SYSTEM\_LISTITEM|データ項目|  
+|ROLE\_SYSTEM\_DOCUMENT|ドキュメント|  
+|ROLE\_SYSTEM\_TEXT|編集|  
+|ROLE\_SYSTEM\_GROUPING|グループ化|  
+|ROLE\_SYSTEM\_LIST|ヘッダー|  
+|ROLE\_SYSTEM\_COLUMNHEADER|ヘッダー項目|  
+|ROLE\_SYSTEM\_LINK|ハイパーリンク|  
+|ROLE\_SYSTEM\_GRAPHIC|イメージ|  
+|ROLE\_SYSTEM\_LIST|リスト|  
+|ROLE\_SYSTEM\_LISTITEM|リスト項目|  
+|ROLE\_SYSTEM\_MENUPOPUP|メニュー|  
+|ROLE\_SYSTEM\_MENUBAR|メニュー バー|  
+|ROLE\_SYSTEM\_MENUITEM|メニュー項目|  
+|ROLE\_SYSTEM\_PANE|ペイン|  
+|ROLE\_SYSTEM\_PROGRESSBAR|進行状況バー|  
+|ROLE\_SYSTEM\_RADIOBUTTON|オプション ボタン|  
+|ROLE\_SYSTEM\_SCROLLBAR|スクロール バー|  
+|ROLE\_SYSTEM\_SEPARATOR|区切り記号|  
+|ROLE\_SYSTEM\_SLIDER|スライダー|  
+|ROLE\_SYSTEM\_SPINBUTTON|Spinner|  
+|ROLE\_SYSTEM\_SPLITBUTTON|分割ボタン|  
+|ROLE\_SYSTEM\_STATUSBAR|ステータス バー|  
+|ROLE\_SYSTEM\_PAGETABLIST|タブ|  
+|ROLE\_SYSTEM\_PAGETAB|タブ項目|  
+|ROLE\_SYSTEM\_TABLE|テーブル|  
+|ROLE\_SYSTEM\_STATICTEXT|テキスト|  
+|ROLE\_SYSTEM\_INDICATOR|つまみ|  
+|ROLE\_SYSTEM\_TITLEBAR|タイトル バー|  
+|ROLE\_SYSTEM\_TOOLBAR|ツール バー|  
+|ROLE\_SYSTEM\_TOOLTIP|ヒント|  
+|ROLE\_SYSTEM\_OUTLINE|ツリー|  
+|ROLE\_SYSTEM\_OUTLINEITEM|ツリー項目|  
+|ROLE\_SYSTEM\_WINDOW|\[Window\]|  
+  
+ さまざまなコントロール型の詳細については、「[UI Automation Control Types](../../../docs/framework/ui-automation/ui-automation-control-types.md)」を参照してください。  
+  
+<a name="States_and_Properties"></a>   
+## 状態とプロパティ  
+ [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] では、要素は一般的なプロパティのセットをサポートします。一部のプロパティ \(`accState` など\) は、要素の役割に応じてまったく異なる内容を記述する必要があります。 サーバーは、プロパティを返す `IAccessible` のメソッドをすべて \(要素に無関係なものも含む\) 実装する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、さらに多くのプロパティが定義されており、その一部は [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] での状態に対応します。 すべての要素に共通するものもあれば、コントロール型とコントロール パターンに固有のものもあります。 プロパティは一意の識別子によって識別され、ほとんどのプロパティは単一のメソッド \(<xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A> または <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A>\) を使用して取得できます。 多くのプロパティは、<xref:System.Windows.Automation.AutomationElement.Current%2A> プロパティ アクセサーおよび <xref:System.Windows.Automation.AutomationElement.Cached%2A> プロパティ アクセサーからも容易に取得できます。  
+  
+ UI オートメーション プロバイダーは、無関係なプロパティを実装する必要はなく、サポートしていないプロパティに対しては単に `null` 値を返すことができます。 また、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のコア サービスは、一部のプロパティを既定のウィンドウ プロバイダーから取得できます。これらのプロパティは、プロバイダーによって明示的に実装されたプロパティと 1 つにまとめられます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、多くのプロパティをサポートすることに加えて、単一のプロセス間呼び出しで複数のプロパティを取得できるので、パフォーマンスが向上します。  
+  
+ 次の表に、2 つのモデルのプロパティ間の対応を示します。  
+  
+|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] のプロパティ アクセサー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ ID|解説|  
+|------------------------------------------------------------------------------|-------------------------------------------------------------------------------------|--------|  
+|`get_accKeyboardShortcut`|<xref:System.Windows.Automation.AutomationElement.AccessKeyProperty> または <xref:System.Windows.Automation.AutomationElement.AcceleratorKeyProperty>|両方とも存在する場合は `AccessKeyProperty` が優先されます。|  
+|`get_accName`|<xref:System.Windows.Automation.AutomationElement.NameProperty>|``|  
+|`get_accRole`|<xref:System.Windows.Automation.AutomationElement.ControlTypeProperty>|役割とコントロール型のマッピングについては、前の表を参照してください。|  
+|`get_accValue`|<xref:System.Windows.Automation.ValuePattern.ValueProperty?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.RangeValuePattern.ValueProperty?displayProperty=fullName>|ValuePattern または RangeValuePattern をサポートするコントロール型でのみ有効です。 MSAA 動作との一貫性を保つために、RangeValue 値は 0 ～ 100 に正規化されます。 Value 項目は文字列を使用します。|  
+|`get_accHelp`|<xref:System.Windows.Automation.AutomationElement.HelpTextProperty>||  
+|`accLocation`|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty>||  
+|`get_accDescription`|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ではサポートされていません。|`accDescription` に関する明確な仕様が MSAA 内に存在しなかったので、このプロパティに格納される情報はプロバイダーによって異なります。|  
+|`get_accHelpTopic`|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ではサポートされていません。||  
+  
+ 次の表に、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティと [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の状態定数との対応を示します。  
+  
+|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の状態|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|状態の変更をトリガーする|  
+|---------------------------------------------------------------------|---------------------------------------------------------------------------------|------------------|  
+|STATE\_SYSTEM\_CHECKED|チェック ボックスの場合、<xref:System.Windows.Automation.TogglePattern.ToggleStateProperty><br /><br /> オプション ボタンの場合、<xref:System.Windows.Automation.SelectionItemPattern.IsSelectedProperty>|Y|  
+|STATE\_SYSTEM\_COLLAPSED|<xref:System.Windows.Automation.ExpandCollapsePattern.ExpandCollapsePatternInformation.ExpandCollapseState%2A> \= <xref:System.Windows.Automation.ExpandCollapseState>|Y|  
+|STATE\_SYSTEM\_EXPANDED|<xref:System.Windows.Automation.ExpandCollapsePattern.ExpandCollapsePatternInformation.ExpandCollapseState%2A> \= <xref:System.Windows.Automation.ExpandCollapseState> または <xref:System.Windows.Automation.ExpandCollapseState>|Y|  
+|STATE\_SYSTEM\_FOCUSABLE|<xref:System.Windows.Automation.AutomationElement.IsKeyboardFocusableProperty>|N|  
+|STATE\_SYSTEM\_FOCUSED|<xref:System.Windows.Automation.AutomationElement.HasKeyboardFocusProperty>|N|  
+|STATE\_SYSTEM\_HASPOPUP|<xref:System.Windows.Automation.ExpandCollapsePattern> \(メニュー項目の場合\)|N|  
+|STATE\_SYSTEM\_INVISIBLE|<xref:System.Windows.Automation.AutomationElement.IsOffscreenProperty> \= True かつ <xref:System.Windows.Automation.AutomationElement.GetClickablePoint%2A> の場合に <xref:System.Windows.Automation.NoClickablePointException> が発生|N|  
+|STATE\_SYSTEM\_LINKED|<xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> \=<br /><br /> <xref:System.Windows.Automation.ControlType.Hyperlink>|N|  
+|STATE\_SYSTEM\_MIXED|<xref:System.Windows.Automation.TogglePattern.TogglePatternInformation.ToggleState%2A> \= <xref:System.Windows.Automation.ToggleState>|N|  
+|STATE\_SYSTEM\_MOVEABLE|<xref:System.Windows.Automation.TransformPattern.CanMoveProperty>|N|  
+|STATE\_SYSTEM\_MUTLISELECTABLE|<xref:System.Windows.Automation.SelectionPattern.CanSelectMultipleProperty>|N|  
+|STATE\_SYSTEM\_OFFSCREEN|<xref:System.Windows.Automation.AutomationElement.IsOffscreenProperty> \= True|N|  
+|STATE\_SYSTEM\_PROTECTED|<xref:System.Windows.Automation.AutomationElement.IsPasswordProperty>|N|  
+|STATE\_SYSTEM\_READONLY|<xref:System.Windows.Automation.RangeValuePattern.IsReadOnlyProperty?displayProperty=fullName> および <xref:System.Windows.Automation.ValuePattern.IsReadOnlyProperty?displayProperty=fullName>|N|  
+|STATE\_SYSTEM\_SELECTABLE|<xref:System.Windows.Automation.SelectionItemPattern> がサポートされています|N|  
+|STATE\_SYSTEM\_SELECTED|<xref:System.Windows.Automation.SelectionItemPattern.IsSelectedProperty>|N|  
+|STATE\_SYSTEM\_SIZEABLE|<xref:System.Windows.Automation.TransformPattern.TransformPatternInformation.CanResize%2A>|N|  
+|STATE\_SYSTEM\_UNAVAILABLE|<xref:System.Windows.Automation.AutomationElement.IsEnabledProperty>|Y|  
+  
+ 次は、ほとんどの [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] コントロール サーバーで実装されていなかったか、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] に対応するものがない状態を示します。  
+  
+|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の状態|コメント|  
+|---------------------------------------------------------------------|----------|  
+|STATE\_SYSTEM\_BUSY|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+|STATE\_SYSTEM\_DEFAULT|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+|STATE\_SYSTEM\_ANIMATED|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+|STATE\_SYSTEM\_EXTSELECTABLE|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_MARQUEED|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_SELFVOICING|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_TRAVERSED|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+|STATE\_SYSTEM\_ALERT\_HIGH|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_ALERT\_MEDIUM|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_ALERT\_LOW|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_FLOATING|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] サーバーで広範に実装されていません|  
+|STATE\_SYSTEM\_HOTTRACKED|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+|STATE\_SYSTEM\_PRESSED|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では使用できません|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ識別子の完全な一覧については、「[UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)」を参照してください。  
+  
+<a name="uiautomation_events_compare"></a>   
+## イベント  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のイベント機構は、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] とは異なり、Windows のイベント ルーティング \(ウィンドウ ハンドルと密接に関連する\) に依存せず、クライアント アプリケーションでフックを設定する必要もありません。 イベントのサブスクリプションは、特定のイベントに対してだけでなく、ツリーの特定の部分を対象とするように細かく調整できます。 プロバイダーも、リッスンされているイベントを追跡して、イベントの生成を細かく調整できます。  
+  
+ イベントを生成した要素をクライアントで取得することも簡単です。このような要素は、イベント コールバックに直接渡されるからです。 クライアントがイベントをサブスクライブしているときにキャッシュ要求がアクティブであった場合は、自動的に要素のプロパティがプリフェッチされます。  
+  
+ 次の表に、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の WinEvent と [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のイベントとの対応を示します。  
+  
+|WinEvent|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のイベント識別子|  
+|--------------|------------------------------------------------------------------------------------|  
+|EVENT\_OBJECT\_ACCELERATORCHANGE|<xref:System.Windows.Automation.AutomationElement.AcceleratorKeyProperty> プロパティの変更|  
+|EVENT\_OBJECT\_CONTENTSCROLLED|関連付けられたスクロール バーにおける <xref:System.Windows.Automation.ScrollPattern.VerticalScrollPercentProperty> または <xref:System.Windows.Automation.ScrollPattern.HorizontalScrollPercentProperty> プロパティの変更|  
+|EVENT\_OBJECT\_CREATE|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|  
+|EVENT\_OBJECT\_DEFACTIONCHANGE|同等の機能がありません|  
+|EVENT\_OBJECT\_DESCRIPTIONCHANGE|まったく同等の項目はありません \(おそらく <xref:System.Windows.Automation.AutomationElement.HelpTextProperty> または <xref:System.Windows.Automation.AutomationElement.LocalizedControlTypeProperty> プロパティの変更\)|  
+|EVENT\_OBJECT\_DESTROY|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|  
+|EVENT\_OBJECT\_FOCUS|<xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent>|  
+|EVENT\_OBJECT\_HELPCHANGE|<xref:System.Windows.Automation.AutomationElement.HelpTextProperty> の変更|  
+|EVENT\_OBJECT\_HIDE|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|  
+|EVENT\_OBJECT\_LOCATIONCHANGE|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty> プロパティの変更|  
+|EVENT\_OBJECT\_NAMECHANGE|<xref:System.Windows.Automation.AutomationElement.NameProperty> プロパティの変更|  
+|EVENT\_OBJECT\_PARENTCHANGE|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|  
+|EVENT\_OBJECT\_REORDER|[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] での使用は一貫していません。 直接対応するイベントが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では定義されていません。|  
+|EVENT\_OBJECT\_SELECTION|<xref:System.Windows.Automation.SelectionItemPattern.ElementSelectedEvent>|  
+|EVENT\_OBJECT\_SELECTIONADD|<xref:System.Windows.Automation.SelectionItemPattern.ElementAddedToSelectionEvent>|  
+|EVENT\_OBJECT\_SELECTIONREMOVE|<xref:System.Windows.Automation.SelectionItemPattern.ElementRemovedFromSelectionEvent>|  
+|EVENT\_OBJECT\_SELECTIONWITHIN|同等の機能がありません|  
+|EVENT\_OBJECT\_SHOW|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|  
+|EVENT\_OBJECT\_STATECHANGE|さまざまなプロパティ変更イベント|  
+|EVENT\_OBJECT\_VALUECHANGE|<xref:System.Windows.Automation.RangeValuePattern.ValueProperty?displayProperty=fullName> および <xref:System.Windows.Automation.ValuePattern.ValueProperty?displayProperty=fullName> の変更|  
+|EVENT\_SYSTEM\_ALERT|同等の機能がありません|  
+|EVENT\_SYSTEM\_CAPTUREEND|同等の機能がありません|  
+|EVENT\_SYSTEM\_CAPTURESTART|同等の機能がありません|  
+|EVENT\_SYSTEM\_CONTEXTHELPEND|同等の機能がありません|  
+|EVENT\_SYSTEM\_CONTEXTHELPSTART|同等の機能がありません|  
+|EVENT\_SYSTEM\_DIALOGEND|<xref:System.Windows.Automation.WindowPattern.WindowClosedEvent>|  
+|EVENT\_SYSTEM\_DIALOGSTART|<xref:System.Windows.Automation.WindowPattern.WindowOpenedEvent>|  
+|EVENT\_SYSTEM\_DRAGDROPEND|同等の機能がありません|  
+|EVENT\_SYSTEM\_DRAGDROPSTART|同等の機能がありません|  
+|EVENT\_SYSTEM\_FOREGROUND|<xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent>|  
+|EVENT\_SYSTEM\_MENUEND|<xref:System.Windows.Automation.AutomationElement.MenuClosedEvent>|  
+|EVENT\_SYSTEM\_MENUPOPUPEND|<xref:System.Windows.Automation.AutomationElement.MenuClosedEvent>|  
+|EVENT\_SYSTEM\_MENUPOPUPSTART|<xref:System.Windows.Automation.AutomationElement.MenuOpenedEvent>|  
+|EVENT\_SYSTEM\_MENUSTART|<xref:System.Windows.Automation.AutomationElement.MenuOpenedEvent>|  
+|EVENT\_SYSTEM\_MINIMIZEEND|<xref:System.Windows.Automation.WindowPattern.WindowVisualStateProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_MINIMIZESTART|<xref:System.Windows.Automation.WindowPattern.WindowVisualStateProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_MOVESIZEEND|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_MOVESIZESTART|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_SCROLLINGEND|<xref:System.Windows.Automation.ScrollPattern.VerticalScrollPercentProperty> または <xref:System.Windows.Automation.ScrollPattern.HorizontalScrollPercentProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_SCROLLINGSTART|<xref:System.Windows.Automation.ScrollPattern.VerticalScrollPercentProperty> または <xref:System.Windows.Automation.ScrollPattern.HorizontalScrollPercentProperty> プロパティの変更|  
+|EVENT\_SYSTEM\_SOUND|同等の機能がありません|  
+|EVENT\_SYSTEM\_SWITCHEND|同等の項目はありませんが、新しいアプリケーションがフォーカスを受け取ったことは <xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent> イベントによって通知されます。|  
+|EVENT\_SYSTEM\_SWITCHSTART|同等の機能がありません|  
+|同等の機能がありません|<xref:System.Windows.Automation.MultipleViewPattern.CurrentViewProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.HorizontallyScrollableProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.VerticallyScrollableProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.HorizontalScrollPercentProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.VerticalScrollPercentProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.HorizontalViewSizeProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.ScrollPattern.VerticalViewSizeProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.TogglePattern.ToggleStateProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.WindowPattern.WindowVisualStateProperty> プロパティの変更|  
+|同等の機能がありません|<xref:System.Windows.Automation.AutomationElement.AsyncContentLoadedEvent> イベント|  
+|同等の機能がありません|<xref:System.Windows.Automation.AutomationElement.ToolTipOpenedEvent>|  
+  
+<a name="Security_compare"></a>   
+## セキュリティ  
+ `IAccessible` をカスタマイズするシナリオでは、基本 `IAccessible` をラップしてからこれに対する呼び出しを行うという要件が生じることがあります。 このことは、セキュリティに影響を及ぼします。部分信頼コンポーネントにコード パスを中継させてはならないからです。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] モデルでは、プロバイダーが他のプロバイダー コードを呼び出す必要がありません。 必要な集約はすべて [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コア サービスが行います。  
+  
+## 参照  
+ [UI Automation Fundamentals](../../../docs/framework/ui-automation/index.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-and-screen-scaling.md b/docs/framework/ui-automation/ui-automation-and-screen-scaling.md
new file mode 100644
index 00000000000..5f6bf3a448a
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-and-screen-scaling.md
@@ -0,0 +1,83 @@
+---
+title: "UI Automation and Screen Scaling | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "scaling, screens"
+  - "screens, scaling"
+  - "UI (user interface), automation"
+  - "UI Automation"
+ms.assetid: 4380cad7-e509-448f-b9a5-6de042605fd4
+caps.latest.revision: 16
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 16
+---
+# UI Automation and Screen Scaling
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ [!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] では、ユーザーが [!INCLUDE[TLA#tla_dpi](../../../includes/tlasharptla-dpi-md.md)] 設定を変更して、画面上のほとんどの [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素を拡大表示できます。 この機能は長い間、[!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] で有効でしたが、以前のバージョンでは、アプリケーションによって拡大縮小を実装しなければなりませんでした。[!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] では、独自の拡大縮小処理を行わないアプリケーションのすべてについて、デスクトップ ウィンドウ マネージャーが既定の拡大縮小を行います。 UI オートメーション クライアント アプリケーションでは、この機能を考慮に入れる必要があります。  
+  
+<a name="Scaling_in_Windows_Vista"></a>   
+## Windows Vista での拡大縮小  
+ 既定の [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 設定は 96 です。つまり、幅または高さの概念上の 1 インチが 96 ピクセルで占められます。 「インチ」の正確な寸法は、モニターのサイズと物理的な解像度によって異なります。 たとえば、幅 12 インチで水平方向の解像度 1280 ピクセルのモニターでは、96 ピクセルの水平線は 1 インチの約 9\/10 の長さになります。  
+  
+ [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 設定を変更することは、画面の解像度を変更することと同じではありません。[!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の拡大縮小では、画面上の物理的ピクセル数はそのまま変わりません。 拡大縮小が適用されるのは、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素のサイズと位置です。 拡大縮小しないよう明示的に指定されていないデスクトップとアプリケーションに対し、デスクトップ ウィンドウ マネージャー \(DWM\) はこの拡大縮小を自動的に実行できます。  
+  
+ 実際には、ユーザーがスケール ファクターを 120 [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] に設定すると、画面上の垂直または水平方向のインチが 25% 拡大されます。 すべての寸法は、それに応じて拡大されます。 画面の左上隅からのアプリケーション ウィンドウのオフセットは、25% 増加します。 アプリケーションの拡大縮小が有効であり、アプリケーションが [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 対応でない場合、ウィンドウのサイズが同じ比率で大きくなります。ウィンドウに含まれるすべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素のオフセットとサイズも同様です。  
+  
+> [!NOTE]
+>  既定では、ユーザーが [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] を 120 に設定した場合、DWM は [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 非対応のアプリケーションに対して拡大縮小を実行しませんが、[!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] が 144 以上のカスタム値に設定されている場合には拡大縮小を実行します。 ただし、この既定の動作は、ユーザーがオーバーライドできます。  
+  
+ 画面の拡大縮小は、画面座標に何らかの関わりを持つアプリケーションに新しい課題をもたらします。 現在、画面には物理座標と論理座標という 2 つの座標系が含まれています。 あるポイントの物理座標は、原点の左上からの実際のオフセット \(ピクセル数\) です。 論理座標は、ピクセル自体が拡大縮小された場合のオフセットです。  
+  
+ たとえば、ダイアログ ボックスを設計し、座標 \(100, 48\) にボタンを配置するとします。 このダイアログ ボックスが既定の 96 [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] で表示される場合、ボタンは物理座標 \(100, 48\) に位置します。 120 [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の場合は、物理座標 \(125, 60\) に位置します。 しかし、論理座標は [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の設定に関係なく、\(100, 48\) のままです。  
+  
+ 論理座標は、[!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の設定に関係なく、オペレーティング システムとアプリケーションの動作を一貫性のあるものとするので重要です。 たとえば、<xref:System.Windows.Forms.Cursor.Position%2A?displayProperty=fullName> は通常、論理座標を返します。 カーソルをダイアログ ボックス内の要素に移動すると、[!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の設定に関係なく、同じ座標が返されます。 \(100, 100\) にコントロールを描画する場合、そのコントロールはこの論理座標に描画され、[!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] の設定に関係なく、同じ相対位置を占めることになります。  
+  
+<a name="Scaling_in_UI_Automation_Clients"></a>   
+## UI オートメーション クライアントにおける拡大縮小  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] [!INCLUDE[TLA#tla_api](../../../includes/tlasharptla-api-md.md)] は論理座標を使用しません。 次のメソッドとプロパティが返す、あるいはパラメーターとして受け取るのは、物理座標です。  
+  
+-   <xref:System.Windows.Automation.AutomationElement.GetClickablePoint%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.TryGetClickablePoint%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.ClickablePointProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.FromPoint%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.BoundingRectangle%2A>  
+  
+ 96 [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] ではない環境で実行されている UI オートメーション クライアント アプリケーションは、既定では、これらのメソッドとプロパティから正しい結果を取得できません。 たとえば、カーソルの位置は論理座標で表されるため、クライアントはそのカーソルの位置にある要素を取得するために、これらの座標をそのまま <xref:System.Windows.Automation.AutomationElement.FromPoint%2A> に渡すことができません。 さらに、アプリケーションはクライアント領域外にウィンドウを正しく配置することもできません。  
+  
+ 解決方法は 2 つの部分で構成されます。  
+  
+1.  まず、クライアント アプリケーションを [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 対応にします。 それには、起動時に [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] 関数 `SetProcessDPIAware` を呼び出します。 マネージ コードで、次の宣言によりこの関数を使用できるようになります。  
+  
+     [!code-csharp[Highlighter#101](../../../samples/snippets/csharp/VS_Snippets_Wpf/Highlighter/CSharp/NativeMethods.cs#101)]
+     [!code-vb[Highlighter#101](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Highlighter/VisualBasic/NativeMethods.vb#101)]  
+  
+     この関数は、プロセス全体を [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 対応にします。つまり、プロセスに属するすべてのウィンドウは拡大縮小されません。[Highlighter Sample](http://msdn.microsoft.com/ja-jp/19ba4577-753e-4efd-92cc-c02ee67c1b69) では、たとえば強調表示の四角形を構成する 4 つのウィンドウは、論理座標ではなく、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] から取得した物理座標に位置します。 この例が [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 非対応だったなら、強調表示はデスクトップ上の論理座標で描画されるため、96 [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 以外の環境では誤った位置に配置されることになります。  
+  
+2.  カーソルの座標を取得するには、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] 関数 `GetPhysicalCursorPos` を呼び出します。 次の例に、この関数を宣言して使用する方法を示します。  
+  
+     [!code-csharp[UIAClient_snip#185](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#185)]
+     [!code-vb[UIAClient_snip#185](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#185)]  
+  
+> [!CAUTION]
+>  <xref:System.Windows.Forms.Cursor.Position%2A?displayProperty=fullName> は使用しないでください。 拡大縮小される環境において、クライアント ウィンドウ外でのこのプロパティの動作は定義されていません。  
+  
+ アプリケーションが [!INCLUDE[TLA2#tla_dpi](../../../includes/tla2sharptla-dpi-md.md)] 非対応のアプリケーションと直接プロセス間通信を行う場合は、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] 関数 `PhysicalToLogicalPoint` および `LogicalToPhysicalPoint` を使用して、論理座標と物理座標を互いに変換できます。  
+  
+## 参照  
+ [Highlighter Sample](http://msdn.microsoft.com/ja-jp/19ba4577-753e-4efd-92cc-c02ee67c1b69)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-clients-for-managed-code-how-to-topics.md b/docs/framework/ui-automation/ui-automation-clients-for-managed-code-how-to-topics.md
new file mode 100644
index 00000000000..bd4027a2e64
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-clients-for-managed-code-how-to-topics.md
@@ -0,0 +1,38 @@
+---
+title: "UI Automation Clients for Managed Code How-to Topics | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, clients for managed code"
+  - "managed code, UI Automation clients"
+ms.assetid: 665b01b5-25f5-47a1-ab11-cffe8ebbf2a7
+caps.latest.revision: 58
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 58
+---
+# UI Automation Clients for Managed Code How-to Topics
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、クライアント アプリケーションでの [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]の機能の実装について詳しく説明します。  
+  
+## このセクションの内容  
+ [Find a UI Automation Element Based on a Property Condition](../../../docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md)  
+ [Navigate Among UI Automation Elements with TreeWalker](../../../docs/framework/ui-automation/navigate-among-ui-automation-elements-with-treewalker.md)  
+ [Find a UI Automation Element for a List Item](../../../docs/framework/ui-automation/find-a-ui-automation-element-for-a-list-item.md)  
+ [Get UI Automation Element Properties](../../../docs/framework/ui-automation/get-ui-automation-element-properties.md)  
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)  
+ [Subscribe to UI Automation Events](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)  
+ [Register a Client\-Side Provider Assembly](../../../docs/framework/ui-automation/register-a-client-side-provider-assembly.md)  
+ [Use the AutomationID Property](../../../docs/framework/ui-automation/use-the-automationid-property.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-clients-for-managed-code.md b/docs/framework/ui-automation/ui-automation-clients-for-managed-code.md
new file mode 100644
index 00000000000..9cbb874efd3
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-clients-for-managed-code.md
@@ -0,0 +1,43 @@
+---
+title: "UI Automation Clients for Managed Code | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, clients for managed code"
+  - "managed code, UI Automation clients"
+ms.assetid: e1ed1197-3e9e-4e78-8845-92e82787faed
+caps.latest.revision: 58
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 58
+---
+# UI Automation Clients for Managed Code
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このセクションには、UI オートメーション クライアントの概要と、クライアントの開発に役立つハウツーに関するトピックが含まれています。  
+  
+## このセクションの内容  
+ [UI Automation and Screen Scaling](../../../docs/framework/ui-automation/ui-automation-and-screen-scaling.md)  
+ [UI Automation Support for Standard Controls](../../../docs/framework/ui-automation/ui-automation-support-for-standard-controls.md)  
+ [UI Automation Events for Clients](../../../docs/framework/ui-automation/ui-automation-events-for-clients.md)  
+ [Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)  
+ [UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)  
+ [Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)  
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)  
+ [Obtaining UI Automation Elements](../../../docs/framework/ui-automation/obtaining-ui-automation-elements.md)  
+ [UI Automation Threading Issues](../../../docs/framework/ui-automation/ui-automation-threading-issues.md)  
+ [How\-to Topics](../../../docs/framework/ui-automation/ui-automation-clients-for-managed-code-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Automation>
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md b/docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md
new file mode 100644
index 00000000000..d925ba41062
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md
@@ -0,0 +1,62 @@
+---
+title: "UI Automation Control Patterns for Clients | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, control patterns for clients"
+  - "control patterns, UI Automation clients"
+ms.assetid: 571561d8-5f49-43a9-a054-87735194e013
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# UI Automation Control Patterns for Clients
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ この概要では、UI オートメーション クライアントのコントロール パターンについて説明します。 また、UI オートメーション クライアントがコントロール パターンを使用して、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] の情報にアクセスするしくみについても説明します。  
+  
+ コントロール パターンは、コントロール型や外観に関係なく、コントロールの機能を分類したり公開したりするための手段です。 UI オートメーション クライアントは、<xref:System.Windows.Automation.AutomationElement> を調べてどのコントロール パターンがサポートされているかを特定し、そのコントロールの動作を確実に実行することができます。  
+  
+ コントロール パターンの完全なリストについては、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+<a name="uiautomation_getting_control_patterns"></a>   
+## コントロール パターンの取得  
+ クライアントは、<xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A?displayProperty=fullName> または <xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A?displayProperty=fullName> を呼び出して、<xref:System.Windows.Automation.AutomationElement> からコントロール パターンを取得します。  
+  
+ クライアントは、<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A> メソッドまたは個別の `IsPatternAvailable` プロパティ \(<xref:System.Windows.Automation.AutomationElement.IsTextPatternAvailableProperty> など\) を使用して、パターンまたはパターンのグループが <xref:System.Windows.Automation.AutomationElement> でサポートされているかどうかを特定できます。 ただし、サポートされているプロパティを確認してコントロール パターンを取得するよりも、コントロール パターンを取得して `null` 参照に対するテストを試行する方が、プロセス間呼び出しが少なくなるため効率的です。  
+  
+ <xref:System.Windows.Automation.AutomationElement> から <xref:System.Windows.Automation.TextPattern> コントロール パターンを取得する方法を次の例に示します。  
+  
+ [!code-csharp[UIATextPattern_snip#1037](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIATextPattern_snip/CSharp/SearchWindow.cs#1037)]  
+  
+<a name="uiautomation_properties_on_control_patterns"></a>   
+## コントロール パターンのプロパティの取得  
+ クライアントは、<xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A?displayProperty=fullName> または <xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A?displayProperty=fullName> を呼び出し、返されたオブジェクトを適切な型にキャストすることで、コントロール パターンのプロパティ値を取得できます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+ `GetPropertyValue` メソッドに加え、[!INCLUDE[TLA#tla_clr](../../../includes/tlasharptla-clr-md.md)] アクセサーを介してパターンの[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティにアクセスすることで、プロパティ値を取得することもできます。  
+  
+<a name="uiautomation_with_variable_patterns"></a>   
+## 変数パターンを持つコントロール  
+ 一部のコントロール型は、状態やコントロールの使用方法に応じた複数のパターンをサポートしています。 変数パターンを持つコントロールの例としては、リスト ビュー \(サムネイル、タイル、アイコン、リスト、詳細\)、[!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)] グラフ \(円、線、横棒、式を使用するセル値\)、[!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] のドキュメント領域 \(標準、Web レイアウト、アウトライン、印刷レイアウト、印刷プレビュー\)、[!INCLUDE[TLA#tla_wmp](../../../includes/tlasharptla-wmp-md.md)] スキンなどがあります。  
+  
+ カスタム コントロール型を実装するコントロールは、機能を表すために必要なコントロール パターンの任意のセットを持つことができます。  
+  
+## 参照  
+ [UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)   
+ [UI Automation Text Pattern](../../../docs/framework/ui-automation/ui-automation-text-pattern.md)   
+ [Invoke a Control Using UI Automation](../../../docs/framework/ui-automation/invoke-a-control-using-ui-automation.md)   
+ [Get the Toggle State of a Check Box Using UI Automation](../../../docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md)   
+ [Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)   
+ [TextPattern Insert Text Sample](http://msdn.microsoft.com/ja-jp/67353f93-7ee2-42f2-ab76-5c078cf6ca16)   
+ [TextPattern Search and Selection Sample](http://msdn.microsoft.com/ja-jp/0a3bca57-8b72-489d-a57c-da85b7a22c7f)   
+ [InvokePattern and ExpandCollapsePattern Menu Item Sample](http://msdn.microsoft.com/ja-jp/b7fa141c-e2d1-4da2-a27f-81a7d1172210)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-patterns-how-to-topics.md b/docs/framework/ui-automation/ui-automation-control-patterns-how-to-topics.md
new file mode 100644
index 00000000000..515d1f10946
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-patterns-how-to-topics.md
@@ -0,0 +1,35 @@
+---
+title: "UI Automation Control Patterns How-to Topics | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "control patterns, UI Automation"
+  - "UI Automation, control patterns"
+ms.assetid: 72c80262-8ca9-4624-9bd6-96984c5b7c5c
+caps.latest.revision: 62
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 62
+---
+# UI Automation Control Patterns How-to Topics
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ ここでは、コントロール パターンの実装について詳しく説明します。  
+  
+## このセクションの内容  
+ [Expose the Content of a Table Using UI Automation](../../../docs/framework/ui-automation/expose-the-content-of-a-table-using-ui-automation.md)  
+ [Get Supported UI Automation Control Patterns](../../../docs/framework/ui-automation/get-supported-ui-automation-control-patterns.md)  
+ [Get the Toggle State of a Check Box Using UI Automation](../../../docs/framework/ui-automation/get-the-toggle-state-of-a-check-box-using-ui-automation.md)  
+ [Invoke a Control Using UI Automation](../../../docs/framework/ui-automation/invoke-a-control-using-ui-automation.md)  
+ [Move a UI Automation Element](../../../docs/framework/ui-automation/move-a-ui-automation-element.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-patterns-overview.md b/docs/framework/ui-automation/ui-automation-control-patterns-overview.md
new file mode 100644
index 00000000000..9d0cc52c857
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-patterns-overview.md
@@ -0,0 +1,87 @@
+---
+title: "UI Automation Control Patterns Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control patterns"
+  - "UI Automation, control patterns"
+ms.assetid: cc229b33-234b-469b-ad60-f0254f32d45d
+caps.latest.revision: 34
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 33
+---
+# UI Automation Control Patterns Overview
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ この概要では、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール パターンについて説明します。 コントロール パターンは、コントロール型や外観に関係なく、コントロールの機能を分類したり公開したりするための手段です。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、コントロールの一般的な動作を表すコントロール パターンを使用します。 たとえば、呼び出し可能なコントロール \(ボタンなど\) には Invoke コントロール パターンを使用し、スクロール バーを持つコントロール \(リスト ボックス、リスト ビュー、コンボ ボックスなど\) には Scroll コントロール パターンを使用します。 コントロール パターンごとに別の機能を表すため、コントロール パターンを組み合わせて、特定のコントロールでサポートされる機能の完全なセットを表すことができます。  
+  
+> [!NOTE]
+>  集約コントロール \(親によって公開される機能のために [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] を提供する子コントロールで構築されるもの\) は、各子コントロールに通常関連付けられるすべてのコントロール パターンを実装する必要があります。 一方、これらの同じコントロール パターンを子コントロールで実装する必要はありません。  
+  
+<a name="uiautomation_control_pattern_includes"></a>   
+## UI オートメーションのコントロール パターン コンポーネント  
+ コントロール パターンは、コントロールで使用可能な機能の個々の部分を定義するために必要なメソッド、プロパティ、イベント、およびリレーションシップをサポートします。  
+  
+-   UI オートメーション要素とその親、子、兄弟との間の関係によって、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内の要素の構造を記述します。  
+  
+-   メソッドは、UI オートメーション クライアントがコントロールを操作できるようにします。  
+  
+-   プロパティとイベントは、コントロール パターンの機能に関する情報だけでなく、コントロールの状態に関する情報も提供します。  
+  
+ コントロール パターンと [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の関係は、インターフェイスと [!INCLUDE[TLA#tla_com](../../../includes/tlasharptla-com-md.md)] オブジェクトの関係に似ています。[!INCLUDE[TLA2#tla_com](../../../includes/tla2sharptla-com-md.md)] では、オブジェクトを照会してサポートされるインターフェイスを確認し、それらのインターフェイスを使用して機能にアクセスすることができます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] では、UI オートメーション クライアントは、サポートされるコントロール パターンをコントロールに対して確認し、サポートされているコントロール パターンによって公開されているプロパティ、メソッド、イベント、構造体を使用してコントロールとやり取りすることができます。 たとえば、複数行のエディット ボックスでは、UI オートメーション プロバイダーは <xref:System.Windows.Automation.Provider.IScrollProvider> を実装します。 クライアントは、<xref:System.Windows.Automation.AutomationElement> が <xref:System.Windows.Automation.ScrollPattern> コントロール パターンをサポートしていることを認識すると、そのコントロール パターンによって公開されているプロパティ、メソッド、イベントを使用して、コントロールを操作したり、コントロールに関する情報にアクセスしたりできます。  
+  
+<a name="uiautomation_control_pattern_client_provider"></a>   
+## UI オートメーションのプロバイダーおよびクライアント  
+ UI オートメーション プロバイダーは、コントロール パターンを実装して、コントロールによってサポートされる特定の機能の適切な動作を公開します。  
+  
+ UI オートメーション クライアントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターン クラスのメソッドとプロパティにアクセスし、それらを使用して [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] に関する情報を取得したり、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を操作したりします。 これらのコントロール パターン クラスは、<xref:System.Windows.Automation> 名前空間 \(たとえば、<xref:System.Windows.Automation.InvokePattern> や <xref:System.Windows.Automation.SelectionPattern>\) にあります。  
+  
+ クライアントは <xref:System.Windows.Automation.AutomationElement> メソッド \(<xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A?displayProperty=fullName> や <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A?displayProperty=fullName> など\) または [!INCLUDE[TLA#tla_clr](../../../includes/tlasharptla-clr-md.md)] アクセサーを使用して、パターン上の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティにアクセスします。 各コントロール パターン クラスには、そのコントロール パターンを識別するフィールド メンバー \(たとえば、<xref:System.Windows.Automation.InvokePattern.Pattern?displayProperty=fullName>`` または <xref:System.Windows.Automation.SelectionPattern.Pattern?displayProperty=fullName>\) があります。それらをパラメーターとして <xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A> または <xref:System.Windows.Automation.AutomationElement.GetCurrentPattern%2A> に渡して、<xref:System.Windows.Automation.AutomationElement> のそのパターンを取得することができます。  
+  
+<a name="uiautomation_control_patterns_dynamic"></a>   
+## 動的コントロール パターン  
+ 一部のコントロールでは、コントロール パターンの同じセットを必ずしもサポートしません。 コントロール パターンは、UI オートメーション クライアントから使用できる場合に、サポートされていると見なされます。 たとえば、複数行のエディット ボックスでは、表示可能領域に表示できる行以上のテキストが含まれている場合にのみ、垂直スクロールが有効にされます。 テキストが削除されスクロールする必要がなくなると、スクロールは無効になります。 この例では、ScrollPattern コントロール パターンは、コントロールの現在の状態 \(エディット ボックスのテキストの量\) に応じて動的にサポートされます。  
+  
+<a name="Control_Pattern_Classes_and_Interfaces"></a>   
+## コントロール パターン クラスとインターフェイス  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンについて次の表で説明します。 またこの表には、コントロール パターンにアクセスするために UI オートメーション クライアントで使用するクラスと、それらを実装するために UI オートメーション プロバイダーで使用するインターフェイスも示します。  
+  
+|コントロール パターン クラス|プロバイダーのインターフェイス|説明|  
+|---------------------|---------------------|--------|  
+|<xref:System.Windows.Automation.DockPattern>|<xref:System.Windows.Automation.Provider.IDockProvider>|ドッキング コンテナーにドッキングすることができるコントロールに使用されます。 たとえば、ツールバーやツール パレットです。|  
+|<xref:System.Windows.Automation.ExpandCollapsePattern>|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|展開したり折りたたんだりできるコントロールに使用されます。 たとえば、**\[ファイル\]** メニューなどアプリケーションのメニュー項目。|  
+|<xref:System.Windows.Automation.GridPattern>|<xref:System.Windows.Automation.Provider.IGridProvider>|サイズ変更や指定したセルへの移動などグリッド機能をサポートするコントロールに使用されます。 たとえば、Windows エクスプローラーの大きいアイコンの表示や [!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] のヘッダーのない簡単な表。|  
+|<xref:System.Windows.Automation.GridItemPattern>|<xref:System.Windows.Automation.Provider.IGridItemProvider>|グリッド内にセルを持つコントロールに使用されます。 個々のセルは GridItem パターンをサポートしている必要があります。 たとえば、[!INCLUDE[TLA#tla_winexpl](../../../includes/tlasharptla-winexpl-md.md)] 詳細ビューの各セル。|  
+|<xref:System.Windows.Automation.InvokePattern>|<xref:System.Windows.Automation.Provider.IInvokeProvider>|ボタンなど、呼び出すことができるコントロールに使用されます。|  
+|<xref:System.Windows.Automation.MultipleViewPattern>|<xref:System.Windows.Automation.Provider.IMultipleViewProvider>|情報、データ、子の同じセットの複数の表現の間で切り替えることができるコントロールに使用されます。 たとえば、サムネイル、タイル、アイコン、リスト、詳細ビューでデータを使用できるリスト ビュー コントロール。|  
+|<xref:System.Windows.Automation.RangeValuePattern>|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|コントロールに適用できる値の範囲を持つコントロールに使用されます。 たとえば、年を含むスピン ボックス コントロールは 1900 から 2010 の範囲を持ち、月を表すスピン ボックス コントロールは 1 から 12 の範囲を持ちます。|  
+|<xref:System.Windows.Automation.ScrollPattern>|<xref:System.Windows.Automation.Provider.IScrollProvider>|スクロールできるコントロールに使用されます。 たとえば、コントロールの表示可能領域に表示できる量より多くの情報があるとアクティブになるスクロール バーを持つコントロール。|  
+|<xref:System.Windows.Automation.ScrollItemPattern>|<xref:System.Windows.Automation.Provider.IScrollItemProvider>|スクロールされるリスト内に個々の項目を持つコントロールに使用されます。 たとえば、コンボ ボックス コントロールなどスクロール リストに個々の項目を持つリスト コントロール。|  
+|<xref:System.Windows.Automation.SelectionPattern>|<xref:System.Windows.Automation.Provider.ISelectionProvider>|選択コンテナー コントロールに使用されます。 たとえば、リスト ボックスやコンボ ボックス。|  
+|<xref:System.Windows.Automation.SelectionItemPattern>|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|リスト ボックスやコンボ ボックスなどの選択コンテナー コントロールの個々の項目に使用されます。|  
+|<xref:System.Windows.Automation.TablePattern>|<xref:System.Windows.Automation.Provider.ITableProvider>|グリッドとヘッダー情報を持つコントロールに使用されます。 たとえば、[!INCLUDE[TLA#tla_xl](../../../includes/tlasharptla-xl-md.md)] ワークシートです。|  
+|<xref:System.Windows.Automation.TableItemPattern>|<xref:System.Windows.Automation.Provider.ITableItemProvider>|テーブル内の項目に使用されます。|  
+|<xref:System.Windows.Automation.TextPattern>|<xref:System.Windows.Automation.Provider.ITextProvider>|テキストの情報を公開するエディット コントロールとドキュメントに使用されます。|  
+|<xref:System.Windows.Automation.TogglePattern>|<xref:System.Windows.Automation.Provider.IToggleProvider>|状態を切り替えることができるコントロールに使用されます。 たとえば、チェック ボックスやチェック可能なメニュー項目。|  
+|<xref:System.Windows.Automation.TransformPattern>|<xref:System.Windows.Automation.Provider.ITransformProvider>|サイズ変更、移動、または回転を行えるコントロールに使用されます。 Transform コントロール パターンの一般的な用途は、デザイナー、フォーム、グラフィカル エディター、および描画アプリケーションでの使用です。|  
+|<xref:System.Windows.Automation.ValuePattern>|<xref:System.Windows.Automation.Provider.IValueProvider>|クライアントで、値の範囲をサポートしないコントロールで値を取得したり、設定したりできます。 たとえば、日時指定のピッカーなどがあります。|  
+|<xref:System.Windows.Automation.WindowPattern>|<xref:System.Windows.Automation.Provider.IWindowProvider>|[!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] オペレーティング システムの基本概念であるウィンドウに固有の情報を公開します。 ウィンドウのコントロールの例として、最上位のアプリケーション ウィンドウ \([!INCLUDE[TLA#tla_word](../../../includes/tlasharptla-word-md.md)] や [!INCLUDE[TLA#tla_winexpl](../../../includes/tlasharptla-winexpl-md.md)] など\)、[!INCLUDE[TLA#tla_mdi](../../../includes/tlasharptla-mdi-md.md)] 子ウィンドウ、ダイアログがあります。|  
+  
+## 参照  
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)   
+ [UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)   
+ [UI Automation Events for Clients](../../../docs/framework/ui-automation/ui-automation-events-for-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-patterns.md b/docs/framework/ui-automation/ui-automation-control-patterns.md
new file mode 100644
index 00000000000..caa4e42e4d1
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-patterns.md
@@ -0,0 +1,48 @@
+---
+title: "UI Automation Control Patterns | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "control patterns, UI Automation"
+  - "UI Automation, control patterns"
+ms.assetid: 1f8b5ab3-c193-4d0f-9e67-a0076225a1a5
+caps.latest.revision: 60
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 60
+---
+# UI Automation Control Patterns
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール パターンを使用する方法について詳しく説明します。  
+  
+## このセクションの内容  
+ [Implementing the UI Automation Dock Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-dock-control-pattern.md)  
+ [Implementing the UI Automation ExpandCollapse Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-expandcollapse-control-pattern.md)  
+ [Implementing the UI Automation Grid Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-grid-control-pattern.md)  
+ [Implementing the UI Automation GridItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-griditem-control-pattern.md)  
+ [Implementing the UI Automation Invoke Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-invoke-control-pattern.md)  
+ [Implementing the UI Automation MultipleView Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-multipleview-control-pattern.md)  
+ [Implementing the UI Automation RangeValue Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-rangevalue-control-pattern.md)  
+ [Implementing the UI Automation Scroll Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-scroll-control-pattern.md)  
+ [Implementing the UI Automation ScrollItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-scrollitem-control-pattern.md)  
+ [Implementing the UI Automation Selection Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-selection-control-pattern.md)  
+ [Implementing the UI Automation SelectionItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-selectionitem-control-pattern.md)  
+ [Implementing the UI Automation Table Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-table-control-pattern.md)  
+ [Implementing the UI Automation TableItem Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-tableitem-control-pattern.md)  
+ [Implementing the UI Automation Toggle Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-toggle-control-pattern.md)  
+ [Implementing the UI Automation Transform Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-transform-control-pattern.md)  
+ [Implementing the UI Automation Value Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-value-control-pattern.md)  
+ [Implementing the UI Automation Window Control Pattern](../../../docs/framework/ui-automation/implementing-the-ui-automation-window-control-pattern.md)  
+ [How\-to Topics](../../../docs/framework/ui-automation/ui-automation-control-patterns-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-types-overview.md b/docs/framework/ui-automation/ui-automation-control-types-overview.md
new file mode 100644
index 00000000000..9b10f834cf1
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-types-overview.md
@@ -0,0 +1,123 @@
+---
+title: "UI Automation Control Types Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, control types"
+  - "control types, UI Automation"
+ms.assetid: 75159ef8-bd43-4d13-acb7-1f1fe9253160
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Control Types Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール型は、コンボ ボックスやボタンなど、特定の要素が表すコントロールの種類を示すのに使用できる既知の識別子です。  
+  
+ 既知の識別子を使用すると、支援テクノロジ デバイスで、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] で使用できるコントロール型およびコントロールとの対話方法を簡単に確認できるようになります。  
+  
+<a name="UI_Automation_Control_Type_Requisites"></a>   
+## UI オートメーション コントロール型の要件  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール型は、プロバイダーが満たす必要のある一連の条件を提供します。 これらの条件が満たされると、コントロールは特定のコントロール型名を使用できます。 コントロール型にはそれぞれ、次のような条件があります。  
+  
+-   [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターン \- サポートする必要があるコントロール パター、省略可能なコントロール パターン、およびコントロールでサポートする必要がないコントロール パターン。  
+  
+-   [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ値 \- サポートされるプロパティ値。  
+  
+-   [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造 \- コントロールに必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造。  
+  
+ コントロールが特定のコントロール型の条件を満たす場合、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ControlType%2A> プロパティの値がそのコントロール型を示します。  
+  
+<a name="Current_UI_Automation_Control_Types"></a>   
+## 現在の UI オートメーション コントロール型  
+ 現在の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール型の一覧を次に示します。  
+  
+-   [UI Automation Support for the Button Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-button-control-type.md)  
+  
+-   [UI Automation Support for the Calendar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-calendar-control-type.md)  
+  
+-   [UI Automation Support for the CheckBox Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-checkbox-control-type.md)  
+  
+-   [UI Automation Support for the ComboBox Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-combobox-control-type.md)  
+  
+-   [UI Automation Support for the DataGrid Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-datagrid-control-type.md)  
+  
+-   [UI Automation Support for the DataItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md)  
+  
+-   [UI Automation Support for the Document Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-document-control-type.md)  
+  
+-   [UI Automation Support for the Edit Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-edit-control-type.md)  
+  
+-   [UI Automation Support for the Group Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-group-control-type.md)  
+  
+-   [UI Automation Support for the Header Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-header-control-type.md)  
+  
+-   [UI Automation Support for the HeaderItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-headeritem-control-type.md)  
+  
+-   [UI Automation Support for the Hyperlink Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-hyperlink-control-type.md)  
+  
+-   [UI Automation Support for the Image Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-image-control-type.md)  
+  
+-   [UI Automation Support for the List Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-list-control-type.md)  
+  
+-   [UI Automation Support for the ListItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md)  
+  
+-   [UI Automation Support for the Menu Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menu-control-type.md)  
+  
+-   [UI Automation Support for the MenuBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menubar-control-type.md)  
+  
+-   [UI Automation Support for the MenuItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menuitem-control-type.md)  
+  
+-   [UI Automation Support for the Pane Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-pane-control-type.md)  
+  
+-   [UI Automation Support for the ProgressBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-progressbar-control-type.md)  
+  
+-   [UI Automation Support for the RadioButton Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-radiobutton-control-type.md)  
+  
+-   [UI Automation Support for the ScrollBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-scrollbar-control-type.md)  
+  
+-   [UI Automation Support for the Separator Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-separator-control-type.md)  
+  
+-   [UI Automation Support for the Slider Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-slider-control-type.md)  
+  
+-   [UI Automation Support for the Spinner Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-spinner-control-type.md)  
+  
+-   [UI Automation Support for the SplitButton Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-splitbutton-control-type.md)  
+  
+-   [UI Automation Support for the StatusBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-statusbar-control-type.md)  
+  
+-   [UI Automation Support for the Tab Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tab-control-type.md)  
+  
+-   [UI Automation Support for the TabItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tabitem-control-type.md)  
+  
+-   [UI Automation Support for the Table Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-table-control-type.md)  
+  
+-   [UI Automation Support for the Text Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-text-control-type.md)  
+  
+-   [UI Automation Support for the Thumb Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-thumb-control-type.md)  
+  
+-   [UI Automation Support for the TitleBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-titlebar-control-type.md)  
+  
+-   [UI Automation Support for the ToolBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-toolbar-control-type.md)  
+  
+-   [UI Automation Support for the ToolTip Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tooltip-control-type.md)  
+  
+-   [UI Automation Support for the Tree Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tree-control-type.md)  
+  
+-   [UI Automation Support for the TreeItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md)  
+  
+-   [UI Automation Support for the Window Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-window-control-type.md)  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType>
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-control-types.md b/docs/framework/ui-automation/ui-automation-control-types.md
new file mode 100644
index 00000000000..1d3b7935c65
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-control-types.md
@@ -0,0 +1,74 @@
+---
+title: "UI Automation Control Types | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, control types"
+  - "control types, UI Automation"
+ms.assetid: 261dcc59-3a62-4e40-91dd-63ff9d2241c0
+caps.latest.revision: 61
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 61
+---
+# UI Automation Control Types
+**メモ** このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]でのコントロール型のサポートについて説明します。  
+  
+## このセクションの内容  
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)  
+ [UI Automation Support for the Button Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-button-control-type.md)  
+ [UI Automation Support for the Calendar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-calendar-control-type.md)  
+ [UI Automation Support for the CheckBox Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-checkbox-control-type.md)  
+ [UI Automation Support for the ComboBox Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-combobox-control-type.md)  
+ [UI Automation Support for the DataGrid Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-datagrid-control-type.md)  
+ [UI Automation Support for the DataItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md)  
+ [UI Automation Support for the Document Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-document-control-type.md)  
+ [UI Automation Support for the Edit Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-edit-control-type.md)  
+ [UI Automation Support for the Group Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-group-control-type.md)  
+ [UI Automation Support for the Header Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-header-control-type.md)  
+ [UI Automation Support for the HeaderItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-headeritem-control-type.md)  
+ [UI Automation Support for the Hyperlink Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-hyperlink-control-type.md)  
+ [UI Automation Support for the Image Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-image-control-type.md)  
+ [UI Automation Support for the List Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-list-control-type.md)  
+ [UI Automation Support for the ListItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md)  
+ [UI Automation Support for the Menu Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menu-control-type.md)  
+ [UI Automation Support for the MenuBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menubar-control-type.md)  
+ [UI Automation Support for the MenuItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-menuitem-control-type.md)  
+ [UI Automation Support for the Pane Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-pane-control-type.md)  
+ [UI Automation Support for the ProgressBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-progressbar-control-type.md)  
+ [UI Automation Support for the RadioButton Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-radiobutton-control-type.md)  
+ [UI Automation Support for the ScrollBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-scrollbar-control-type.md)  
+ [UI Automation Support for the Separator Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-separator-control-type.md)  
+ [UI Automation Support for the Slider Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-slider-control-type.md)  
+ [UI Automation Support for the Spinner Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-spinner-control-type.md)  
+ [UI Automation Support for the SplitButton Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-splitbutton-control-type.md)  
+ [UI Automation Support for the StatusBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-statusbar-control-type.md)  
+ [UI Automation Support for the Tab Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tab-control-type.md)  
+ [UI Automation Support for the TabItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tabitem-control-type.md)  
+ [UI Automation Support for the Table Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-table-control-type.md)  
+ [UI Automation Support for the Text Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-text-control-type.md)  
+ [UI Automation Support for the Thumb Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-thumb-control-type.md)  
+ [UI Automation Support for the TitleBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-titlebar-control-type.md)  
+ [UI Automation Support for the ToolBar Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-toolbar-control-type.md)  
+ [UI Automation Support for the ToolTip Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tooltip-control-type.md)  
+ [UI Automation Support for the Tree Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-tree-control-type.md)  
+ [UI Automation Support for the TreeItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md)  
+ [UI Automation Support for the Window Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-window-control-type.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Automation.ControlType>  
+  
+## 参照  
+ [UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-events-for-clients.md b/docs/framework/ui-automation/ui-automation-events-for-clients.md
new file mode 100644
index 00000000000..c20a876ac4d
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-events-for-clients.md
@@ -0,0 +1,71 @@
+---
+title: "クライアントの UI オートメーション イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI オートメーション クライアントのイベント"
+  - "イベント、UI オートメーション クライアント"
+ms.assetid: b909e388-3f24-4997-b6d4-bd9c35c2dc27
+caps.latest.revision: 32
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 32
+---
+# クライアントの UI オートメーション イベント
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ このトピックについて説明する方法[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]イベントは、UI オートメーション クライアントによって使用されます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]クライアントは、関心のあるイベントを定期受信できます。 この機能は、すべてをポーリングし続ける必要がある、パフォーマンスを改善、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]すべてについては、構造体、または状態が変更されたかどうか、システム内の要素。  
+  
+ また、定義されたスコープ内のイベントだけをリッスンできるため、効率性も向上します。 たとえば、クライアントをリッスンできますフォーカス変更イベントをすべて[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーで、または&1; つだけの要素とその子孫の要素。  
+  
+> [!NOTE]
+>  使用できるすべてのイベントを発生すると想定しないで、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]プロバイダー。 たとえば、すべてのプロパティの変更が発生するの標準のプロキシ プロバイダーによって発生させるイベントを[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)]と[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]コントロールです。  
+  
+ 広い視野の[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]イベントを参照してください[UI オートメーション イベントの概要](../../../docs/framework/ui-automation/ui-automation-events-overview.md)します。  
+  
+<a name="Subscribing_to_Events"></a>   
+## <a name="subscribing-to-events"></a>イベントのサブスクライブ  
+ クライアント アプリケーションは特定の種類のイベントをサブスクライブするために、次のいずれかのメソッドを使用してイベント ハンドラーを登録します。  
+  
+|メソッド|イベントの種類|イベント引数の種類|デリゲート型|  
+|------------|----------------|--------------------------|-------------------|  
+|<xref:System.Windows.Automation.Automation.AddAutomationFocusChangedEventHandler%2A>|フォーカスの変更|<xref:System.Windows.Automation.AutomationFocusChangedEventArgs>|<xref:System.Windows.Automation.AutomationFocusChangedEventHandler>|  
+|<xref:System.Windows.Automation.Automation.AddAutomationPropertyChangedEventHandler%2A>|プロパティの変更|<xref:System.Windows.Automation.AutomationPropertyChangedEventArgs>|<xref:System.Windows.Automation.AutomationPropertyChangedEventHandler>|  
+|<xref:System.Windows.Automation.Automation.AddStructureChangedEventHandler%2A>|構造の変更|<xref:System.Windows.Automation.StructureChangedEventArgs>|<xref:System.Windows.Automation.StructureChangedEventHandler>|  
+|<xref:System.Windows.Automation.Automation.AddAutomationEventHandler%2A>|識別されるその他のすべてのイベント、 <xref:System.Windows.Automation.AutomationEvent>|<xref:System.Windows.Automation.AutomationEventArgs>または<xref:System.Windows.Automation.WindowClosedEventArgs>|<xref:System.Windows.Automation.AutomationEventHandler>|  
+  
+ メソッドを呼び出す前に、イベントを処理するデリゲート メソッドを作成する必要があります。 必要に応じて、単一のメソッドでさまざまな種類のイベントを処理し、そのメソッドを複数の呼び出しで表中のメソッドの&1; つに渡すことができます。 たとえば、1 つ<xref:System.Windows.Automation.AutomationEventHandler>異なるによると、さまざまなイベントを処理するを設定することができます、 <xref:System.Windows.Automation.AutomationEventArgs.EventId%2A>します。  
+  
+> [!NOTE]
+>  ウィンドウを閉じるイベントを処理する、イベント ハンドラーに渡される引数の型をキャスト<xref:System.Windows.Automation.WindowClosedEventArgs>します。 [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]ウィンドウの要素が無効になって、使用することはできません、`sender`情報を取得するパラメーターを使用して<xref:System.Windows.Automation.WindowClosedEventArgs.GetRuntimeId%2A>代わりにします。  
+  
+> [!CAUTION]
+>  アプリケーションが独自のイベントを受け取った場合[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]、アプリケーションを使用しないでください[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]スレッドまたは登録を解除する、イベントを定期受信します。 使用すると、予期しない動作を招く可能性があります。 詳細については、次を参照してください。 [UI オートメーション スレッド処理の問題](../../../docs/framework/ui-automation/ui-automation-threading-issues.md)します。  
+  
+ シャット ダウン、または[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]イベントは、アプリケーションにとって重要な不要になった、UI オートメーション クライアントは、次の方法のいずれかを呼び出す必要があります。  
+  
+|メソッド|説明|  
+|------------|-----------------|  
+|<xref:System.Windows.Automation.Automation.RemoveAutomationEventHandler%2A>|使用して登録されたイベント ハンドラーの登録を解除<xref:System.Windows.Automation.Automation.AddAutomationEventHandler%2A>します。|  
+|<xref:System.Windows.Automation.Automation.RemoveAutomationFocusChangedEventHandler%2A>|使用して登録されたイベント ハンドラーの登録を解除<xref:System.Windows.Automation.Automation.AddAutomationFocusChangedEventHandler%2A>します。|  
+|<xref:System.Windows.Automation.Automation.RemoveAutomationPropertyChangedEventHandler%2A>|使用して登録されたイベント ハンドラーの登録を解除<xref:System.Windows.Automation.Automation.AddAutomationPropertyChangedEventHandler%2A>します。|  
+|<xref:System.Windows.Automation.Automation.RemoveAllEventHandlers%2A>|登録済みのすべてのイベント ハンドラーの登録を解除します。|  
+  
+ コード例は、「 [UI オートメーション イベントをサブスクライブ](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーション イベントを購読します。](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)   
+ [UI オートメーション イベントの概要](../../../docs/framework/ui-automation/ui-automation-events-overview.md)   
+ [UI オートメーション プロパティの概要](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)   
+ [TrackFocus サンプル](http://msdn.microsoft.com/ja-jp/4a91c0af-6bb5-4d38-a743-cf136f268fc9)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-events-overview.md b/docs/framework/ui-automation/ui-automation-events-overview.md
new file mode 100644
index 00000000000..627ccff5e16
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-events-overview.md
@@ -0,0 +1,94 @@
+---
+title: "UI Automation Events Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, providers"
+  - "UI Automation, events"
+  - "clients, UI Automation"
+  - "events, UI Automation"
+  - "providers, UI Automation"
+  - "UI Automation, clients"
+ms.assetid: 69eebd8b-39ed-40e7-93cc-4457c4caf746
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Events Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の最新情報については、「[Windows Automation API: UI Automation \(Windows のオートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] イベント通知は、スクリーン リーダーやスクリーン拡大鏡などの支援技術にとっての重要な機能です。 これらの UI オートメーション クライアントは、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] で何かが発生したときに UI オートメーション プロバイダーが発生させるイベントを追跡し、その情報を使用してエンド ユーザーに通知します。  
+  
+ これらのイベントにサブスクライブしているクライアントがあるか、それともイベントをリッスンするクライアントがなく、サブスクライブしているクライアントがまったくないかに応じて、プロバイダー アプリケーションが選択的にイベントを発生させることで効率が向上します。  
+  
+<a name="Types_of_Events"></a>   
+## イベントの種類  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントは次のカテゴリに分けられます。  
+  
+|イベント|説明|  
+|----------|--------|  
+|プロパティの変更|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素のプロパティまたはコントロール パターンが変更された場合に発生します。 たとえば、クライアントがアプリケーションのチェック ボックス コントロールの監視を必要とする場合に、<xref:System.Windows.Automation.TogglePattern.TogglePatternInformation.ToggleState%2A> プロパティ上のプロパティの変更イベントをリッスンするよう登録できます。 チェック ボックス コントロールがオンまたはオフになったときに、プロバイダーがイベントを発生させ、クライアントが必要なアクションを実行できます。|  
+|要素のアクション|[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の変更がエンド ユーザーまたはプログラムによるアクティビティに起因する場合に発生します。たとえば、ボタンがクリックされたり、<xref:System.Windows.Automation.InvokePattern> を通じて呼び出される場合です。|  
+|構造の変更|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの構造が変更された場合に発生します。 構造が変更されるのは、デスクトップ上で新しい [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 項目が表示または非表示にされるか、削除された場合です。|  
+|グローバル デスクトップの変更|ある要素から別の要素にフォーカスが移った場合やウィンドウが閉じられた場合など、クライアントにグローバルに関連するアクションが起こった場合に発生します。|  
+  
+ イベントによっては、必ずしも UI の状態が変更されたことを意味しません。 たとえば、ユーザーが Tab キーを押して、テキスト入力フィールドに移動し、フィールドを更新するボタンをクリックした場合、ユーザーが実際にテキストを変更していない場合でも `TextChangedEvent` が発生します。 イベントを処理する際、クライアント アプリケーションがアクションを起こす前に、実際に変更が行われたかどうかのチェックが必要となる場合があります。  
+  
+ 次のイベントは、UI の状態が変更されていない場合でも発生する可能性があります。  
+  
+-   `AutomationPropertyChangedEvent` \(変更されたプロパティによって変わります\)  
+  
+-   `ElementSelectedEvent`  
+  
+-   `InvalidatedEvent`  
+  
+-   `TextChangedEvent`  
+  
+<a name="UI_Automation_Event_Identifiers"></a>   
+## UI オートメーション イベント識別子  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] イベントは、<xref:System.Windows.Automation.AutomationEvent> オブジェクトによって識別されます。<xref:System.Windows.Automation.AutomationIdentifier.Id%2A> プロパティには、イベントの種類を一意に識別する値が含まれます。  
+  
+ <xref:System.Windows.Automation.AutomationIdentifier.Id%2A> に指定できる値と、イベント引数に使用する種類を次の表に示します。 クライアントとプロバイダーが使用する識別子は、異なるクラスで同じ名前のフィールドです。  
+  
+|クライアント識別子|プロバイダー識別子|イベント引数の種類|  
+|---------------|---------------|---------------|  
+|<xref:System.Windows.Automation.AutomationElement.AsyncContentLoadedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationElementIdentifiers.AsyncContentLoadedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AsyncContentLoadedEventArgs>|  
+|<xref:System.Windows.Automation.SelectionItemPattern.ElementAddedToSelectionEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionItemPattern.ElementRemovedFromSelectionEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionItemPattern.ElementSelectedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionPattern.InvalidatedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.InvokePattern.InvokedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElement.LayoutInvalidatedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElement.MenuClosedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElement.MenuOpenedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.TextPattern.TextChangedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.TextPattern.TextSelectionChangedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElement.ToolTipClosedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElement.ToolTipOpenedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.WindowPattern.WindowOpenedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElementIdentifiers.LayoutInvalidatedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElementIdentifiers.MenuClosedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElementIdentifiers.MenuOpenedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.TextPatternIdentifiers.TextChangedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.TextPatternIdentifiers.TextSelectionChangedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElementIdentifiers.ToolTipClosedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.AutomationElementIdentifiers.ToolTipOpenedEvent?displayProperty=fullName><br /><br /> <xref:System.Windows.Automation.WindowPatternIdentifiers.WindowOpenedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationEventArgs>|  
+|<xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationFocusChangedEventArgs>|  
+|<xref:System.Windows.Automation.AutomationElement.AutomationPropertyChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationPropertyChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationPropertyChangedEventArgs>|  
+|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.StructureChangedEventArgs>|  
+|<xref:System.Windows.Automation.WindowPattern.WindowClosedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowClosedEvent?displayProperty=fullName>|<xref:System.Windows.Automation.WindowClosedEventArgs>|  
+  
+<a name="UI_Automation_Event_Arguments"></a>   
+## UI オートメーション イベント引数  
+ 次のクラスは、イベント引数をカプセル化します。  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.Windows.Automation.AsyncContentLoadedEventArgs>|読み込みが完了した割合など、コンテンツの非同期読み込みに関する情報を含んでいます。|  
+|<xref:System.Windows.Automation.AutomationEventArgs>|追加データを必要としない単純なイベントに関する情報を含んでいます。|  
+|<xref:System.Windows.Automation.AutomationFocusChangedEventArgs>|ある要素から別の要素への入力フォーカスの変化に関する情報を含んでいます。 この種類のイベントは、プロバイダーではなく、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] システムによって発生します。|  
+|<xref:System.Windows.Automation.AutomationPropertyChangedEventArgs>|要素のプロパティ値またはコントロール パターンの変更に関する情報を含んでいます。|  
+|<xref:System.Windows.Automation.StructureChangedEventArgs>|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの変更に関する情報を含んでいます。|  
+|<xref:System.Windows.Automation.WindowClosedEventArgs>|ウィンドウ クローズに関する情報を含んでいます。|  
+  
+ すべてのイベント引数クラスには、<xref:System.Windows.Automation.AutomationEventArgs.EventId%2A> メンバーが含まれます。 この識別子は <xref:System.Windows.Automation.AutomationEvent> にカプセル化されます。  
+  
+ イベントを識別するために使用する <xref:System.Windows.Automation.AutomationEvent> オブジェクトは、<xref:System.Windows.Automation.AutomationElementIdentifiers> およびコントロール パターン識別子クラス \(<xref:System.Windows.Automation.DockPatternIdentifiers> など\) のフィールドからプロバイダーによって取得されます。 等価のフィールドが、<xref:System.Windows.Automation.AutomationElement> およびコントロール パターン クラス \(<xref:System.Windows.Automation.DockPattern> など\) のフィールドからクライアント アプリケーションによって取得されます。  
+  
+ イベント識別子の一覧については、「[UI Automation Events for Clients](../../../docs/framework/ui-automation/ui-automation-events-for-clients.md)」を参照してください。  
+  
+## 参照  
+ [UI Automation Events for Clients](../../../docs/framework/ui-automation/ui-automation-events-for-clients.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)   
+ [Subscribe to UI Automation Events](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-overview.md b/docs/framework/ui-automation/ui-automation-overview.md
new file mode 100644
index 00000000000..b122db2c5c5
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-overview.md
@@ -0,0 +1,89 @@
+---
+title: "UI Automation Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, overview"
+  - "user interface, see UI"
+  - "accessibility, UI automation"
+ms.assetid: 65847654-9994-4a9e-b36d-2dd5d998770b
+caps.latest.revision: 35
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 35
+---
+# UI Automation Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]は、[!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] をサポートするすべてのオペレーティング システムで利用可能な、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] の新しいアクセシビリティ フレームワークです。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、デスクトップ上のほとんどの [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素へのプログラムによるアクセスを提供し、スクリーン リーダーなどの補助技術製品が [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] に関する情報をエンド ユーザーに提供したり、標準入力方式以外の方法で [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を操作したりできるようにします。 また、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、自動テスト スクリプトが [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] と対話できるようにします。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]では、**\[別のユーザーとして実行\]** コマンドを使用して別々のユーザーが開始したプロセス間の通信を行うことはできません。  
+  
+ UI オートメーション クライアント アプリケーションを作成すると、そのアプリケーションは、複数のフレームワーク上で動作することが保証されます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コアは、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] のさまざまな部分の基になるフレームワークのあらゆる差異をマスクします。 たとえば、`Content` のボタンの [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] プロパティ、`Caption` のボタンの [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] プロパティ、および HTML イメージの `ALT` プロパティは、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Name%2A> ビュー内では、すべて単一のプロパティ、つまり [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] にマップされます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の完全な機能は、[!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)]、[!INCLUDE[TLA#tla_winxp](../../../includes/tlasharptla-winxp-md.md)]、および [!INCLUDE[TLA2#tla_winnetsvrfam](../../../includes/tla2sharptla-winnetsvrfam-md.md)] で利用できます。  
+  
+ UI オートメーション プロバイダーは、組み込みのブリッジ サービスを通じて、[!INCLUDE[TLA#tla_aa](../../../includes/tlasharptla-aa-md.md)] クライアント アプリケーションを一部サポートします。  
+  
+<a name="Providers_and_Clients"></a>   
+## プロバイダーおよびクライアント  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]には、次の表に示す 4 つの主要なコンポーネントがあります。  
+  
+|コンポーネント|説明|  
+|-------------|--------|  
+|プロバイダー [!INCLUDE[TLA#tla_api](../../../includes/tlasharptla-api-md.md)] \(UIAutomationProvider.dll および UIAutomationTypes.dll\)|UI オートメーション プロバイダーによって実装されるインターフェイス定義のセット。[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素に関する情報を提供し、プログラムによる入力に応答するオブジェクトです。|  
+|クライアント API \(UIAutomationClient.dll および UIAutomationTypes.dll\)|UI オートメーション クライアント アプリケーションが、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] に関する情報を取得し、コントロールに入力を送信することを可能にする、各種マネージ コードのセット。|  
+|UiAutomationCore.dll|プロバイダーとクライアントの間の通信を処理する、基になるコード \([!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コアとも呼ばれます\)。|  
+|UIAutomationClientsideProviders.dll|従来の標準コントロールに使用する UI オートメーション プロバイダーのセット。 \([!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] コントロールは [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]をネイティブにサポートします\)。 このサポートは、クライアント アプリケーションに対して自動的に有効になります。|  
+  
+ ソフトウェア開発者の観点からは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を使用するには、カスタム コントロール用のサポートを作成する \(プロバイダー API を使用\) か、または [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コアを使用して [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素と通信するアプリケーションを作成する \(クライアント API を使用\)、という 2 つの方法があります。 主要な目的に応じて、ドキュメントの該当箇所を参照してください。 次の各セクションでは、概念の詳細と、実際的な方法について説明します。  
+  
+|セクション|主題|対象ユーザー|  
+|-----------|--------|------------|  
+|[UI Automation Fundamentals](../../../docs/framework/ui-automation/index.md) \(このセクション\)|概念についての広範な概要。|すべて。|  
+|[UI Automation Providers for Managed Code](../../../docs/framework/ui-automation/ui-automation-providers-for-managed-code.md)|プロバイダー API を使用する際に役立つ概要と「方法」トピック。|コントロールの開発者。|  
+|[UI Automation Clients for Managed Code](../../../docs/framework/ui-automation/ui-automation-clients-for-managed-code.md)|クライアント API を使用する際に役立つ概要と「方法」トピック。|クライアント アプリケーションの開発者。|  
+|[UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)|コントロール パターンをプロバイダーで実装する方法と、クライアントで使用可能な機能に関する情報。|すべて。|  
+|[UI Automation Text Pattern](../../../docs/framework/ui-automation/ui-automation-text-pattern.md)|Text コントロール パターンをプロバイダーで実装する方法と、クライアントで使用可能な機能に関する情報。|すべて。|  
+|[UI Automation Control Types](../../../docs/framework/ui-automation/ui-automation-control-types.md)|さまざまなコントロール型でサポートされるプロパティとコントロール パターンに関する情報。|すべて。|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の名前空間、それらの名前空間を含む DLL、およびそれらを使用する対象ユーザーを次の表に示します。  
+  
+|名前空間|参照される DLL|対象ユーザー|  
+|----------|---------------|------------|  
+|<xref:System.Windows.Automation>|UIAutomationClientUIAutomationTypes|UI オートメーション クライアントの開発者。<xref:System.Windows.Automation.AutomationElement> オブジェクトの検索、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントの登録、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のコントロール パターンの利用の際に使用します。|  
+|<xref:System.Windows.Automation.Provider>|UIAutomationProviderUIAutomationTypes|[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] 以外のフレームワークの UI オートメーション プロバイダーの開発者。|  
+|<xref:System.Windows.Automation.Text>|UIAutomationClientUIAutomationTypes|[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] 以外のフレームワークで使用する UI オートメーション プロバイダーの開発者が、TextPattern コントロール パターンを実装する際に使用します。|  
+|<xref:System.Windows.Automation.Peers>|PresentationFramework|[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] で使用する UI オートメーション プロバイダーの開発者。|  
+  
+<a name="UI_Automation_Model"></a>   
+## UI オートメーション モデル  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] のすべての部分を、クライアント アプリケーションに対して、<xref:System.Windows.Automation.AutomationElement> として公開します。 各要素は、デスクトップをルート要素とするツリー構造に格納されます。 クライアントでは、ツリーの未加工ビューを、コントロール ビューまたはコンテンツ ビューとしてフィルター処理できます。 アプリケーションでは、カスタム ビューを作成することもできます。  
+  
+ <xref:System.Windows.Automation.AutomationElement> オブジェクトは、それらが表す [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素の一般的なプロパティを公開します。 これらのプロパティの 1 つにコントロール型があります。これは、その基本的な外観と機能を認識可能な単一のエンティティとして定義するもので、ボタンやチェック ボックスなどがその例です。  
+  
+ また、各要素は、そのコントロール型に固有のプロパティを提供するコントロール パターンも公開します。 コントロール パターンは、クライアントが要素に関するより詳細な情報を取得し、入力を提供できるようにするメソッドも公開します。  
+  
+> [!NOTE]
+>  コントロール型とコントロール パターンの間には、1 対 1 の対応はありせん。 1 つのコントロール パターンが複数のコントロール型でサポートされる場合もありますし、1 つのコントロールが複数のコントロール パターンをサポートし、各パターンがそのコントロールの動作の異なる側面を公開する場合もあります。 たとえば、1 つのコンボ ボックスは、少なくとも 2 つのコントロール パターンを持ちます。1 つは、それを展開して折りたたむ機能を表し、もう 1 つは、選択機構を表します。 詳しくは、「[UI Automation Control Types](../../../docs/framework/ui-automation/ui-automation-control-types.md)」をご覧ください。  
+  
+ また、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、クライアント アプリケーションにイベントを通じて情報を提供します。[!INCLUDE[TLA2#tla_winevents](../../../includes/tla2sharptla-winevents-md.md)] とは異なり、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のイベントは、ブロードキャスト機構に基づいていません。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]のクライアントは、特定のイベント通知を登録し、特定の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティとコントロール パターン情報を自身のイベント ハンドラーに渡すように要求することができます。 また、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントには、原因となった要素への参照が含まれています。 プロバイダーはイベントを選択的に発生させることによってパフォーマンスを向上させることができますが、クライアントがリッスンしているかどうかによって異なります  
+  
+## 参照  
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)   
+ [UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)   
+ [UI Automation Security Overview](../../../docs/framework/ui-automation/ui-automation-security-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-properties-for-clients.md b/docs/framework/ui-automation/ui-automation-properties-for-clients.md
new file mode 100644
index 00000000000..6f089eb168a
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-properties-for-clients.md
@@ -0,0 +1,113 @@
+---
+title: "UI Automation Properties for Clients | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "properties, UI Automation clients"
+  - "UI Automation, client properties"
+ms.assetid: 255905af-0b17-485c-93d4-8a2db2a6524b
+caps.latest.revision: 17
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 17
+---
+# UI Automation Properties for Clients
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、UI オートメーション クライアント アプリケーションに公開される [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて説明します。  
+  
+ <xref:System.Windows.Automation.AutomationElement> オブジェクトのプロパティには、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素 \(通常はコントロール\) に関する情報が含まれます。<xref:System.Windows.Automation.AutomationElement> のプロパティは汎用的なもので、コントロール型に固有ではありません。 これらのプロパティの多くは、<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation> 構造体で公開されます。  
+  
+ また、コントロール パターンもプロパティを持ちます。 コントロール パターンのプロパティは、パターンに固有です。 たとえば、<xref:System.Windows.Automation.ScrollPattern> に含まれるプロパティを使用すると、ウィンドウを垂直方向または水平方向のどちらにスクロールできるのかや、現在のビュー サイズおよびスクロール位置をクライアント アプリケーションで検出できます。 コントロール パターンは、そのすべてのプロパティを構造体 \(<xref:System.Windows.Automation.ScrollPattern.ScrollPatternInformation> など\) を介して公開します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティは読み取り専用です。 コントロールのプロパティを設定するには、適切なコントロール パターンのメソッドを使用する必要があります。 たとえば、スクロール ウィンドウの位置の値を変更する場合は、<xref:System.Windows.Automation.ScrollPattern.Scroll%2A> を使用します。  
+  
+ パフォーマンスを向上させるために、<xref:System.Windows.Automation.AutomationElement> オブジェクトを取得したときに、コントロールおよびコントロール パターンのプロパティ値をキャッシュできます。 詳細については、「[Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)」を参照してください。  
+  
+<a name="Property_IDs"></a>   
+## プロパティ ID  
+ プロパティ [!INCLUDE[TLA#tla_id#plural](../../../includes/tlasharptla-idsharpplural-md.md)] は、<xref:System.Windows.Automation.AutomationProperty> オブジェクトにカプセル化される一意の定数値です。 UI オートメーション クライアント アプリケーションは、これらの [!INCLUDE[TLA2#tla_id#plural](../../../includes/tla2sharptla-idsharpplural-md.md)] を <xref:System.Windows.Automation.AutomationElement> クラスまたは適切なコントロール パターン クラス \(<xref:System.Windows.Automation.ScrollPattern> など\) から取得します。 UI オートメーション プロバイダーは、<xref:System.Windows.Automation.AutomationElementIdentifiers> またはコントロール パターン識別子クラスの 1 つ \(<xref:System.Windows.Automation.ScrollPatternIdentifiers> など\) からこれらを取得します。  
+  
+ <xref:System.Windows.Automation.AutomationProperty> の数値 <xref:System.Windows.Automation.AutomationIdentifier.Id%2A> は、<xref:System.Windows.Automation.Provider.IRawElementProviderSimple.GetPropertyValue%2A?displayProperty=fullName> メソッドで照会するプロパティを識別するために、プロバイダーによって使用されます。 通常、クライアント アプリケーションで <xref:System.Windows.Automation.AutomationIdentifier.Id%2A> を調べる必要はありません。<xref:System.Windows.Automation.AutomationIdentifier.ProgrammaticName%2A> は、デバッグと診断の目的のみに使用されます。  
+  
+<a name="Property_Conditions"></a>   
+## プロパティ条件  
+ プロパティ [!INCLUDE[TLA2#tla_id#plural](../../../includes/tla2sharptla-idsharpplural-md.md)] は、<xref:System.Windows.Automation.AutomationElement> オブジェクトの検出に使用する <xref:System.Windows.Automation.PropertyCondition> オブジェクトを構築する際に使用されます。 たとえば、特定の名前を持つ <xref:System.Windows.Automation.AutomationElement> を検出したい場合や、すべての有効なコントロールを検出したい場合があります。 各 <xref:System.Windows.Automation.PropertyCondition> では、<xref:System.Windows.Automation.AutomationProperty> 識別子と、そのプロパティが一致する必要がある値を指定します。  
+  
+ 詳細については、次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Automation.AutomationElement.FindFirst%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.FindAll%2A>  
+  
+-   <xref:System.Windows.Automation.TreeWalker.Condition%2A>  
+  
+<a name="Retrieving_Properties"></a>   
+## プロパティの取得  
+ <xref:System.Windows.Automation.AutomationElement> のいくつかのプロパティと、コントロール パターン クラスのすべてのプロパティは、<xref:System.Windows.Automation.AutomationElement> またはコントロール パターン オブジェクトの、`Current` プロパティまたは `Cached` プロパティの入れ子になったプロパティとして公開されます。  
+  
+ また、<xref:System.Windows.Automation.AutomationElement.Cached%2A> または <xref:System.Windows.Automation.AutomationElement.Current%2A> の構造体にはないプロパティを含む、任意の <xref:System.Windows.Automation.AutomationElement> またはコントロール パターン プロパティは、次のいずれかのメソッドを使用して取得できます。  
+  
+-   <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A>  
+  
+-   <xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A>  
+  
+ これらのメソッドを使用すると、パフォーマンスがわずかながら向上すると共に、すべてのプロパティにアクセスできます。  
+  
+ <xref:System.Windows.Automation.AutomationElement> のプロパティを取得する 2 とおりの方法を次のコード例で示します。  
+  
+ [!code-csharp[UIAClient_snip#121](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#121)]
+ [!code-vb[UIAClient_snip#121](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#121)]  
+  
+ <xref:System.Windows.Automation.AutomationElement> でサポートされるコントロール パターンのプロパティを取得する場合は、コントロール パターン オブジェクトを取得する必要はありません。 単にパターン プロパティ識別子の 1 つをメソッドに渡します。  
+  
+ コントロール パターンのプロパティを取得する 2 とおりの方法を次のコード例で示します。  
+  
+ [!code-csharp[UIAClient_snip#122](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#122)]
+ [!code-vb[UIAClient_snip#122](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#122)]  
+  
+ `Get` メソッドは <xref:System.Object> を返します。 アプリケーションは、この値を使用する前に、返されたオブジェクトを適切な型にキャストする必要があります。  
+  
+<a name="_Default_Property_Values"></a>   
+## 既定のプロパティ値  
+ UI オートメーション プロバイダーがプロパティを実装していない場合、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] システムは既定値を提供できます。 たとえば、コントロールのプロバイダーが <xref:System.Windows.Automation.AutomationElement.HelpTextProperty> によって識別されたプロパティをサポートしていない場合、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は空の文字列を返します。 同様に、プロバイダーが <xref:System.Windows.Automation.AutomationElement.IsDockPatternAvailableProperty> によって識別されたプロパティをサポートしていない場合、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は `false` を返します。  
+  
+ この動作は、<xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A?displayProperty=fullName> と <xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A?displayProperty=fullName> のメソッド オーバーロードを使用して変更できます。 2 番目のパラメーターとして `true` を指定した場合、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は既定値を返さず、代わりに特殊な値 <xref:System.Windows.Automation.AutomationElement.NotSupported> を返します。  
+  
+ 次のコード例は、要素からプロパティを取得することを試みています。プロパティがサポートされていない場合は、代わりにアプリケーション定義の値が使用されます。  
+  
+ [!code-csharp[UIAClient_snip#123](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#123)]
+ [!code-vb[UIAClient_snip#123](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#123)]  
+  
+ 要素によってサポートされているプロパティを調べるためには、<xref:System.Windows.Automation.AutomationElement.GetSupportedProperties%2A> を使用します。 これにより、<xref:System.Windows.Automation.AutomationProperty> 識別子の配列が返されます。  
+  
+<a name="Property_changed_Events"></a>   
+## プロパティ変更イベント  
+ <xref:System.Windows.Automation.AutomationElement> またはコントロール パターンのプロパティ値が変化すると、イベントが発生します。 アプリケーションは、<xref:System.Windows.Automation.Automation.AddAutomationPropertyChangedEventHandler%2A> を呼び出し、目的のプロパティを指定するために最後のパラメーターとして <xref:System.Windows.Automation.AutomationProperty> 識別子の配列を提供して、このようなイベントをサブスクライブできます。  
+  
+ <xref:System.Windows.Automation.AutomationPropertyChangedEventHandler> では、イベント引数の <xref:System.Windows.Automation.AutomationPropertyChangedEventArgs.Property%2A> メンバーを調べることによって、変更されたプロパティを識別できます。 また、引数には、変更された [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの古い値と新しい値も含まれています。 これらの値は <xref:System.Object> 型であり、使用する前に正しい型にキャストする必要があります。  
+  
+<a name="Additional_AutomationElement_Properties"></a>   
+## その他の AutomationElement プロパティ  
+ <xref:System.Windows.Automation.AutomationElement.Current%2A> プロパティおよび <xref:System.Windows.Automation.AutomationElement.Cached%2A> プロパティの構造体に加えて、<xref:System.Windows.Automation.AutomationElement> には、単純なプロパティ アクセサーを介して取得される次のプロパティがあります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Windows.Automation.AutomationElement.CachedChildren%2A>|キャッシュ内にある子 <xref:System.Windows.Automation.AutomationElement> オブジェクトのコレクション。|  
+|<xref:System.Windows.Automation.AutomationElement.CachedParent%2A>|キャッシュ内にある <xref:System.Windows.Automation.AutomationElement> 親オブジェクト。|  
+|<xref:System.Windows.Automation.AutomationElement.FocusedElement%2A>|\(静的なプロパティ\) 入力フォーカスがある <xref:System.Windows.Automation.AutomationElement>。|  
+|<xref:System.Windows.Automation.AutomationElement.RootElement%2A>|\(静的プロパティ\) ルート <xref:System.Windows.Automation.AutomationElement>。|  
+  
+## 参照  
+ [Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)   
+ [Subscribe to UI Automation Events](../../../docs/framework/ui-automation/subscribe-to-ui-automation-events.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-properties-overview.md b/docs/framework/ui-automation/ui-automation-properties-overview.md
new file mode 100644
index 00000000000..40e1859d9ae
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-properties-overview.md
@@ -0,0 +1,175 @@
+---
+title: "UI Automation Properties Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, properties"
+  - "properties, UI Automation"
+ms.assetid: a6c31d7b-b33e-49b3-b5c1-31a345f9b7c8
+caps.latest.revision: 17
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 17
+---
+# UI Automation Properties Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ UI オートメーション プロバイダーは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] 要素のプロパティを公開します。 これらのプロパティにより、UI オートメーション クライアント アプリケーションは、静的データと動的データを含め、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] の構成部分 \(特にコントロール\) に関する情報を探索できます。  
+  
+ このセクションでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] プロパティの概要を説明します。 詳細については、以下のトピックで説明しています。  
+  
+-   [UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)  
+  
+-   [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)  
+  
+<a name="Property_Identifiers"></a>   
+## プロパティ識別子  
+ すべてのプロパティは、番号と名前によって識別されます。 プロパティの名前を使用するのは、デバッグおよび診断を行う場合のみです。 プロバイダーは、数値の [!INCLUDE[TLA2#tla_id#plural](../../../includes/tla2sharptla-idsharpplural-md.md)] を使用して、着信プロパティ要求を識別します。 ただし、クライアント アプリケーションは、番号と名前をカプセル化した <xref:System.Windows.Automation.AutomationProperty> だけを使用して、取得したいプロパティを識別します。  
+  
+ 特定のプロパティを表す <xref:System.Windows.Automation.AutomationProperty> オブジェクトは、さまざまなクラスでフィールドとして使用できます。 セキュリティ上の理由から、UI オートメーション プロバイダーは、Uiautomationtypes.dll に含まれている別のクラスのセットから、これらのオブジェクトを取得します。  
+  
+ 次の表に、<xref:System.Windows.Automation.AutomationProperty> [!INCLUDE[TLA2#tla_id#plural](../../../includes/tla2sharptla-idsharpplural-md.md)] を格納するクラス別にプロパティを分類します。  
+  
+|プロパティの種類|クライアントが ID を取得する場所|プロバイダーが ID を取得する場所|  
+|--------------|------------------------|------------------------|  
+|すべての要素に共通のプロパティ \(下記の表を参照\)|<xref:System.Windows.Automation.AutomationElement>|<xref:System.Windows.Automation.AutomationElementIdentifiers>|  
+|ドッキング ウィンドウの位置|<xref:System.Windows.Automation.DockPattern>|<xref:System.Windows.Automation.DockPatternIdentifiers>|  
+|展開または折りたたみが可能な要素の状態|<xref:System.Windows.Automation.ExpandCollapsePattern>|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers>|  
+|グリッド内の項目のプロパティ|<xref:System.Windows.Automation.GridItemPattern>|<xref:System.Windows.Automation.GridItemPatternIdentifiers>|  
+|グリッドのプロパティ|<xref:System.Windows.Automation.GridPattern>|<xref:System.Windows.Automation.GridPatternIdentifiers>|  
+|複数のビューを持つ要素の現在のサポートされているビュー|<xref:System.Windows.Automation.MultipleViewPattern>|<xref:System.Windows.Automation.MultipleViewPatternIdentifiers>|  
+|一定の値の範囲を移動する要素 \(スライダーなど\) のプロパティ|<xref:System.Windows.Automation.RangeValuePattern>|<xref:System.Windows.Automation.RangeValuePatternIdentifiers>|  
+|スクロール ウィンドウのプロパティ|<xref:System.Windows.Automation.ScrollPattern>|<xref:System.Windows.Automation.ScrollPatternIdentifiers>|  
+|選択できる項目 \(リスト内の項目など\) の状態およびコンテナー|<xref:System.Windows.Automation.SelectionItemPattern>|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers>|  
+|選択項目を含むコントロールのプロパティ|<xref:System.Windows.Automation.SelectionPattern>|<xref:System.Windows.Automation.SelectionPatternIdentifiers>|  
+|テーブル内の項目の列と行のヘッダー|<xref:System.Windows.Automation.TableItemPattern>|<xref:System.Windows.Automation.TableItemPatternIdentifiers>|  
+|テーブルの列と行のヘッダーおよびテーブルの向き|<xref:System.Windows.Automation.TablePattern>|<xref:System.Windows.Automation.TablePatternIdentifiers>|  
+|切り替えコントロールの状態|<xref:System.Windows.Automation.TogglePattern>|<xref:System.Windows.Automation.TogglePatternIdentifiers>|  
+|移動、回転、またはサイズ変更できる要素の機能|<xref:System.Windows.Automation.TransformPattern>|<xref:System.Windows.Automation.TransformPatternIdentifiers>|  
+|値を持つ要素の値および読み取り\/書き込み機能|<xref:System.Windows.Automation.ValuePattern>|<xref:System.Windows.Automation.ValuePatternIdentifiers>|  
+|ウィンドウの機能および状態|<xref:System.Windows.Automation.WindowPattern>|<xref:System.Windows.Automation.WindowPatternIdentifiers>|  
+  
+<a name="Properties_by_Category"></a>   
+## カテゴリ別プロパティ  
+ 次の表に、<xref:System.Windows.Automation.AutomationElement> および <xref:System.Windows.Automation.AutomationElementIdentifiers> に [!INCLUDE[TLA2#tla_id#plural](../../../includes/tla2sharptla-idsharpplural-md.md)] があるプロパティを分類します。 これらのプロパティは、すべてのコントロールに共通です。 一部の例外を除き、ほとんどのプロパティがプロバイダー アプリケーションの有効期間にわたって静的です。動的プロパティのほとんどは、コントロール パターンに関連付けられています。  
+  
+ **「プロパティ アクセス」**列には、<xref:System.Windows.Automation.AutomationElement.GetCurrentPropertyValue%2A> と <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A> だけでなく、各プロパティのすべてのアクセサーを示しています。 クライアント アプリケーションでプロパティを取得する方法の詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+> [!NOTE]
+>  各プロパティの詳細については、**「プロパティ アクセス」**列のリンク先を参照してください。  
+  
+### 表示特性  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.BoundingRectangle%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.CultureProperty>|適用なし|  
+|<xref:System.Windows.Automation.AutomationElement.HelpTextProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.HelpText%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsOffscreenProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsOffscreen%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.OrientationProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Orientation%2A>|  
+  
+### 要素型  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.ControlTypeProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ControlType%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsContentElementProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsContentElement%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsControlElementProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsControlElement%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.ItemTypeProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ItemType%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.LocalizedControlTypeProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.LocalizedControlType%2A>|  
+  
+### 識別  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.AutomationIdProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.AutomationId%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.ClassNameProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ClassName%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.FrameworkIdProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.FrameworkId%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.LabeledByProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.LabeledBy%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.NameProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.Name%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.ProcessIdProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ProcessId%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.RuntimeIdProperty>|<xref:System.Windows.Automation.AutomationElement.GetRuntimeId%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.NativeWindowHandleProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.NativeWindowHandle%2A>|  
+  
+### 相互作用  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.AcceleratorKeyProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.AcceleratorKey%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.AccessKeyProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.AccessKey%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.ClickablePointProperty>|<xref:System.Windows.Automation.AutomationElement.GetClickablePoint%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.HasKeyboardFocusProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.HasKeyboardFocus%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsEnabledProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsEnabled%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsKeyboardFocusableProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsKeyboardFocusable%2A>|  
+  
+### パターンのサポート  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.IsDockPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsExpandCollapsePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsGridItemPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsGridPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsInvokePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsMultipleViewPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsRangeValuePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsScrollItemPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsScrollPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsSelectionItemPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsSelectionPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsTableItemPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsTablePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsTextPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsTogglePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsTransformPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsValuePatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsWindowPatternAvailableProperty>|<xref:System.Windows.Automation.AutomationElement.GetSupportedPatterns%2A>|  
+  
+### その他の指定  
+  
+|プロパティの識別子|プロパティ アクセス|  
+|---------------|----------------|  
+|<xref:System.Windows.Automation.AutomationElement.IsRequiredForFormProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsRequiredForForm%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.IsPasswordProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsPassword%2A>|  
+|<xref:System.Windows.Automation.AutomationElement.ItemStatusProperty>|<xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.ItemStatus%2A>|  
+  
+<a name="Localization"></a>   
+## ローカリゼーション  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーは、以下のプロパティをオペレーティング システムの言語で提示する必要があります。  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.AccessKeyProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>  
+  
+-   <xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>  
+  
+<a name="Properties_and_Events"></a>   
+## プロパティおよびイベント  
+ プロパティ変更イベントの概念は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティと密接に関連しています。 動的プロパティの場合は、プロパティの値が変更されたときにキャッシュの情報を更新したり新しい情報に何らかの形で対応したりできるように、クライアント アプリケーションは、プロパティの値が変更されたことを認識できなければなりません。  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] で何らかの変更が発生すると、プロバイダーはイベントを生成します。 たとえば、チェック ボックスのオン\/オフが切り替えられると、プロバイダーの Toggle パターンの実装によって、プロパティ変更イベントが生成されます。 プロバイダーは、クライアントがイベントをリッスンしているのか、特定のイベントをリッスンしているのかに応じて、イベントを選択的に生成できます。  
+  
+ すべてのプロパティ変更がイベントを生成するわけではありません。これは完全に、該当する要素の UI オートメーション プロバイダーの実装に依存します。 たとえば、リスト ボックスの標準プロキシ プロバイダーは、<xref:System.Windows.Automation.SelectionPattern.SelectionProperty> が変更されてもイベントを生成しません。 この場合、アプリケーションが <xref:System.Windows.Automation.SelectionItemPattern.ElementSelectedEvent> をリッスンする必要があります。  
+  
+ クライアントは、イベントをサブスクライブすることでイベントをリッスンします。 イベントをサブスクライブすることは、イベントを処理できるデリゲート メソッドを作成し、それらのメソッドで処理する特定のイベントと共に、それらのメソッドを [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] に渡すことを意味します。 特にプロパティ変更イベントについては、クライアントが <xref:System.Windows.Automation.AutomationPropertyChangedEventHandler> を実装する必要があります。  
+  
+## 参照  
+ [Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)   
+ [UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)   
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)   
+ [Find a UI Automation Element Based on a Property Condition](../../../docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md)   
+ [Return Properties from a UI Automation Provider](../../../docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md)   
+ [Raise Events from a UI Automation Provider](../../../docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-providers-for-managed-code-how-to-topics.md b/docs/framework/ui-automation/ui-automation-providers-for-managed-code-how-to-topics.md
new file mode 100644
index 00000000000..bc766fabd75
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-providers-for-managed-code-how-to-topics.md
@@ -0,0 +1,38 @@
+---
+title: "UI Automation Providers for Managed Code How-to Topics | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, providers"
+  - "UI Automation, custom user interface (UI) elements"
+  - "providers, UI Automation"
+ms.assetid: 88bc4212-3f4e-4bac-bae0-faef31944b71
+caps.latest.revision: 60
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 60
+---
+# UI Automation Providers for Managed Code How-to Topics
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このセクションには、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] プロバイダーを作成する場合のタスクを示すコード例が含まれています。  
+  
+## このセクションの内容  
+ [Expose a Server\-side UI Automation Provider](../../../docs/framework/ui-automation/expose-a-server-side-ui-automation-provider.md)  
+ [Return Properties from a UI Automation Provider](../../../docs/framework/ui-automation/return-properties-from-a-ui-automation-provider.md)  
+ [Raise Events from a UI Automation Provider](../../../docs/framework/ui-automation/raise-events-from-a-ui-automation-provider.md)  
+ [Enable Navigation in a UI Automation Fragment Provider](../../../docs/framework/ui-automation/enable-navigation-in-a-ui-automation-fragment-provider.md)  
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)  
+ [Create a Client\-Side UI Automation Provider](../../../docs/framework/ui-automation/create-a-client-side-ui-automation-provider.md)  
+ [Implement UI Automation Providers in a Client Application](../../../docs/framework/ui-automation/implement-ui-automation-providers-in-a-client-application.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-providers-for-managed-code.md b/docs/framework/ui-automation/ui-automation-providers-for-managed-code.md
new file mode 100644
index 00000000000..d7e54fbccf9
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-providers-for-managed-code.md
@@ -0,0 +1,35 @@
+---
+title: "UI Automation Providers for Managed Code | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, providers"
+  - "UI Automation, custom user interface (UI) elements"
+  - "providers, UI Automation"
+ms.assetid: 5f82f731-f1b5-4c8b-b47c-d11279a02574
+caps.latest.revision: 58
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 58
+---
+# UI Automation Providers for Managed Code
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このセクションには、カスタム [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 要素の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] プロバイダーの作成に関する概要と方法のトピックが含まれています。  
+  
+## このセクションの内容  
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)  
+ [UI Automation Providers Overview](../../../docs/framework/ui-automation/ui-automation-providers-overview.md)  
+ [Client\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/client-side-ui-automation-provider-implementation.md)  
+ [How\-to Topics](../../../docs/framework/ui-automation/ui-automation-providers-for-managed-code-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-providers-overview.md b/docs/framework/ui-automation/ui-automation-providers-overview.md
new file mode 100644
index 00000000000..1f8c6af7287
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-providers-overview.md
@@ -0,0 +1,87 @@
+---
+title: "UI Automation Providers Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, providers"
+  - "providers, UI Automation"
+ms.assetid: 859557b8-51e1-4d15-92e8-318d2dcdb2f7
+caps.latest.revision: 38
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 38
+---
+# UI Automation Providers Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ UI オートメーション プロバイダーを使用すれば、コントロールで UI オートメーション クライアント アプリケーションと通信することができます。 一般に、各コントロールまたは [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] 内のその他の要素はプロバイダーによって表現されます。 プロバイダーは、要素に関する情報を公開し、必要に応じて、クライアント アプリケーションがコントロールと対話できるようにするコントロール パターンを実装します。  
+  
+ 通常、クライアント アプリケーションはプロバイダーと直接連動する必要はありません。[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)]、または [!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] フレームワークを使用するアプリケーション内の標準コントロールのほとんどが自動的に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] システムに公開されます。 カスタム コントロールを実装するアプリケーションがそれらのコントロール用の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーを実装することもできます。クライアント アプリケーションがそれらにアクセスするために特別な手順を実行する必要はありません。  
+  
+ このトピックでは、コントロールの開発者が [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] と [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] のウィンドウのコントロール専用に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロバイダーを実装する方法について説明します。  
+  
+<a name="Types_of_Providers"></a>   
+## プロバイダーの種類  
+ UI オートメーション プロバイダーは、クライアント側プロバイダーとサーバー側プロバイダーの 2 つのカテゴリに分類されます。  
+  
+### クライアント側プロバイダー  
+ クライアント側プロバイダーは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] をサポートしていないか部分的にサポートしているアプリケーションと通信する UI オートメーション クライアントによって実装されます。 通常、クライアント側プロバイダーは [!INCLUDE[TLA2#tla_win](../../../includes/tla2sharptla-win-md.md)] メッセージを送受信することによって、プロセス境界を越えてサーバーと通信します。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]、[!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)]、または [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内のコントロール用の UI オートメーション プロバイダーはオペレーティング システムの一部として供給されるため、ほとんどのクライアント アプリケーションが独自のプロバイダーを実装する必要がなく、この概要ではそれについてこれ以上説明しません。  
+  
+### サーバー側プロバイダー  
+ サーバー側プロバイダーは、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]、[!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)]、または [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] 以外の UI フレームワークに基づくカスタム コントロールまたはアプリケーションによって実装されます。  
+  
+ また、サーバー側プロバイダーは、サーバーからクライアントに要求するインターフェイスを [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コア システムに公開することにより、プロセス境界を越えてクライアント アプリケーションと通信します。  
+  
+<a name="AutomationProviderConcepts"></a>   
+## UI オートメーション プロバイダーの概念  
+ ここでは、UI オートメーション プロバイダーを実装するために理解しておく必要があるいくつかの重要な概念について簡単に説明します。  
+  
+### Elements  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素は、UI オートメーション クライアントからアクセス可能な [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] の一部です。 例として、アプリケーション ウィンドウ、ペイン、ボタン、ツールヒント、リスト ボックス、およびリスト項目が含まれています。  
+  
+### ナビゲーション  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーとしてクライアントに公開されます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、要素間を移動することによって、ツリーを構成します。 ナビゲーションは、親、兄弟、または子を指す要素ごとに、プロバイダーによって有効にされます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのクライアント ビューの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+### ビュー  
+ 次の表に示すように、クライアントは 3 つのプリンシパル ビューで [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーを表示できます。  
+  
+|||  
+|-|-|  
+|列ビュー|すべての要素が含まれます。|  
+|コントロール ビュー|コントロールである要素が含まれます。|  
+|コンテンツ ビュー|コンテンツである要素が含まれます。|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのクライアント ビューの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+ コンテンツ要素またはコントロール要素としての要素の定義はプロバイダー実装で行う必要があります。 コントロール要素はコンテンツ要素であることもないこともありますが、コンテンツ要素はすべてコントロール要素です。  
+  
+### フレームワーク  
+ フレームワークは、画面のある領域で子コントロール、ヒット テスト、およびレンダリングを管理するコンポーネントです。 たとえば、HWND とも呼ばれる [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] ウィンドウは、メニュー バー、ステータス バー、ボタンなどの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素が複数含まれるフレームワークとして機能することができます。  
+  
+ リスト ボックスやツリー ビューなどの [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コンテナー コントロールは、子項目をレンダリングしたり、それらに対してヒット テストを実行したりするための独自のコードが含まれているため、フレームワークと見なされます。 これに対して、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] リスト ボックスは、包含する [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] ウィンドウによってレンダリングやヒット テストが処理されるため、フレームワークではありません。  
+  
+ アプリケーション内の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] はさまざまなフレームワークで構成することができます。 たとえば、HWND アプリケーション ウィンドウには、HWND 内のコンボ ボックスなどのコンポーネントを含む [!INCLUDE[TLA#tla_dhtml](../../../includes/tlasharptla-dhtml-md.md)] を含めることができます。  
+  
+### フラグメント  
+ フラグメントは、特定のフレームワーク内の要素のサブツリー全体です。 サブツリーのルート ノードにある要素はフラグメント ルートと呼ばれます。 フラグメント ルートは、親がありませんが、他の何らかのフレームワーク \(通常は [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] ウィンドウ \(HWND\)\) 内でホストされます。  
+  
+### ホスト  
+ すべてのフラグメントのルート ノードは、1 つの要素 \(通常は [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] ウィンドウ \(HWND\)\) 内でホストする必要があります。 例外は、他の要素でホストされないデスクトップです。 カスタム コントロールのホストは、アプリケーション ウィンドウやトップ レベル コントロールのグループを含めることができるその他のウィンドウではなく、コントロール自体の HWND です。  
+  
+ フラグメントのホストは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サービスを提供するうえで重要な役割を果たします。 このホストがフラグメント ルートへの移動を可能にし、いくつかの既定のプロパティを提供するため、カスタム プロバイダーはそれらを実装する必要がありません。  
+  
+## 参照  
+ [Server\-Side UI Automation Provider Implementation](../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-security-overview.md b/docs/framework/ui-automation/ui-automation-security-overview.md
new file mode 100644
index 00000000000..42c0a2eb6f9
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-security-overview.md
@@ -0,0 +1,68 @@
+---
+title: "UI Automation Security Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, security model"
+  - "security model, UI Automation"
+ms.assetid: 1d853695-973c-48ae-b382-4132ae702805
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# UI Automation Security Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ この概要では、[!INCLUDE[TLA#tla_winvista](../../../includes/tlasharptla-winvista-md.md)] における [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] のセキュリティ モデルについて説明します。  
+  
+<a name="User_Account_Control"></a>   
+## ユーザー アカウント制御  
+ セキュリティは [!INCLUDE[TLA#tla_winvista](../../../includes/tlasharptla-winvista-md.md)] の重要点であり、とりわけ顕著な革新として、より高い特権が必要なアプリケーションとサービスの実行を必ずしもブロックされずに、\(管理者以外の\) 標準ユーザーとして実行する能力が挙げられます。  
+  
+ [!INCLUDE[TLA2#tla_winvista](../../../includes/tla2sharptla-winvista-md.md)] では、ほとんどのアプリケーションに、標準トークンまたは管理トークンのいずれかが付属しています。 アプリケーションが管理アプリケーションとして識別できない場合は、既定で標準のアプリケーションとして起動されます。 管理アプリケーションとして識別されたアプリケーションが起動される前に、[!INCLUDE[TLA2#tla_winvista](../../../includes/tla2sharptla-winvista-md.md)] は、昇格された権限でアプリケーションを実行することへの同意をユーザーに求めるメッセージを表示します。 ユーザーがローカル管理者グループのメンバーである場合でも、同意を求めるメッセージは既定で表示されます。これは、管理者の資格情報を必要とするアプリケーションまたはシステム コンポーネントが実行の許可を要求するまで、管理者は標準ユーザーとして実行するためです。  
+  
+<a name="Tasks_Requiring_Higher_Privileges"></a>   
+## より高い特権が必要なタスク  
+ 管理者特権が必要なタスクをユーザーが実行しようとする場合、[!INCLUDE[TLA2#tla_winvista](../../../includes/tla2sharptla-winvista-md.md)] はユーザーに続行に同意するかを確認するダイアログ ボックスを表示します。 このダイアログ ボックスは、悪意のあるソフトウェアがユーザー入力をシミュレートできないように、プロセス間通信から保護されます。 同様に、デスクトップのログオン画面は、通常は他のプロセスからはアクセスできません。  
+  
+ UI オートメーション クライアントは、他のプロセスと通信する必要があります。プロセスによっては、より高い特権レベルで実行している可能性があります。 クライアントにも、通常は他のプロセスによって表示できないシステム ダイアログ ボックスへのアクセスが必要になる可能性があります。 そのため、 [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クライアントはシステムによって信頼されている必要があり、特別な特権で実行する必要があります。  
+  
+ より高い権限レベルで実行されているアプリケーションと通信する信頼を得るためには、アプリケーションに署名する必要があります。  
+  
+<a name="Manifest_Files"></a>   
+## マニフェスト ファイル  
+ 保護されたシステム [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] にアクセスするためには、マニフェスト ファイル内に特別な属性が含まれるマニフェスト ファイルを使ってアプリケーションをビルドする必要があります。 次のように、この `uiAccess` 属性は `requestedExecutionLevel` タグに含まれます。  
+  
+ `<trustInfo xmlns="urn:0073chemas-microsoft-com:asm.v3">`  
+  
+ `<security>`  
+  
+ `<requestedPrivileges>`  
+  
+ `<requestedExecutionLevel`  
+  
+ `level="highestAvailable"`  
+  
+ `UIAccess="true" />`  
+  
+ `</requestedPrivileges>`  
+  
+ `</security>`  
+  
+ `</trustInfo>`  
+  
+ このコードの `level` 属性の値は一例にすぎません。  
+  
+ 既定では `UIAccess` は "false" です。つまり、属性を省略した場合、またはアセンブリのマニフェストが存在しない場合、アプリケーションは保護された [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] にアクセスできなくなります。  
+  
+ [!INCLUDE[TLA#tla_longhorn2](../../../includes/tlasharptla-longhorn2-md.md)] セキュリティ、アプリケーションの署名、およびアセンブリ マニフェストの作成の詳細については、[MSDN](http://msdn.microsoft.com/library/default.asp?url=/library/dnlong/html/AccProtVista.asp) の「最小限の特権環境での開発者向けアプリケーションのベスト プラクティスとガイドライン」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-specification-and-community-promise.md b/docs/framework/ui-automation/ui-automation-specification-and-community-promise.md
new file mode 100644
index 00000000000..cac95c6a334
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-specification-and-community-promise.md
@@ -0,0 +1,24 @@
+---
+title: "UI Automation Specification and Community Promise | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b238fd69-2f62-499c-bea0-b91dfb9204f0
+caps.latest.revision: 5
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 5
+---
+# UI Automation Specification and Community Promise
+UI オートメーションは、デスクトップ上のほとんどのユーザー インターフェイス \(UI\) 要素へのプログラムによるアクセスを提供し、スクリーン リーダーなどの支援技術製品が UI に関する情報をエンド ユーザーに提供したり、標準の入力方式以外の方法で UI を操作したりできるようにします。  
+  
+## 参照  
+ [UI Automation Specification \(UI オートメーション仕様\)](http://go.microsoft.com/fwlink/?LinkId=108541)   
+ [UI Automation Community Promise \(UI Automation Community Promise\)](http://go.microsoft.com/fwlink/?LinkId=108542)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-standard-controls.md b/docs/framework/ui-automation/ui-automation-support-for-standard-controls.md
new file mode 100644
index 00000000000..e75d306b72d
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-standard-controls.md
@@ -0,0 +1,178 @@
+---
+title: "UI Automation Support for Standard Controls | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "controls, UI Automation support for"
+  - "UI Automation, support for standard controls"
+ms.assetid: 3770ea8a-2655-4add-9c59-fe0610ad5084
+caps.latest.revision: 11
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 10
+---
+# UI Automation Support for Standard Controls
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、および [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] フレームワーク向けに開発されたアプリケーションの標準コントロールに対する [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] サポートについて説明します。  
+  
+<a name="Windows_Presentation_Foundation_Controls"></a>   
+## Windows Presentation Foundation コントロール  
+ ユーザー操作に関する情報やサポートを提供するすべての [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] コントロール要素は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] を全面的にネイティブ サポートしています。 パネルなどのその他の要素は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] からは認識できません。  
+  
+<a name="Win32_Controls"></a>   
+## Win32 コントロール  
+ ほとんどの [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コントロールは、UIAutomationClientsideProviders.dll のクライアント側プロバイダーによって [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] に公開されています。 このアセンブリは、UI オートメーション クライアント アプリケーションで使用するために、自動的に登録されます。  
+  
+ 完全なサポートは、ComCtrl32.dll のバージョン 6 \([!INCLUDE[TLA#tla_winxp](../../../includes/tlasharptla-winxp-md.md)] 以降で使用可能\) のコントロールに対してのみ提供されています。  
+  
+ 次のコントロールがサポートされています。  
+  
+|クラス名|コントロール型|  
+|----------|-------------|  
+|ボタン|ボタン|  
+|ボタン|RadioButton|  
+|ボタン|グループ化|  
+|ボタン|CheckBox|  
+|ボタン|ハイパーリンク|  
+|ボタン|SplitButton|  
+|ボタン|CheckBox|  
+|ComboBoxEx32|ComboBox|  
+|ComboBox|ComboBox|  
+|編集|ドキュメント|  
+|編集|編集|  
+|SysLink|ハイパーリンク|  
+|スタティック|テキスト|  
+|スタティック|イメージ|  
+|SysIPAddress32|カスタム|  
+|SysHeader32|Header\/HeaderItem|  
+|SysListView32|DataGrid|  
+|SysListView32|リスト|  
+|ListBox|リスト|  
+|ListBox|ListItem|  
+|\#32768|メニュー|  
+|\#32768|MenuItem|  
+|msctls\_progress32|ProgressBar|  
+|RichEdit|ドキュメント。 注を参照。|  
+|RichEdit20A|ドキュメント|  
+|RichEdit20W|ドキュメント|  
+|RichEdit50W|ドキュメント|  
+|ScrollBar|スライダー|  
+|msctls\_trackbar32|スライダー|  
+|msctls\_updown32|Spinner|  
+|msctls\_statusbar32|StatusBar|  
+|SysTabControl32|タブ|  
+|SysTabControl32|TabItem|  
+|ToolbarWindow32|ToolBar|  
+|ToolbarWindow32|MenuItem|  
+|ToolbarWindow32|ボタン|  
+|ToolbarWindow32|CheckBox|  
+|ToolbarWindow32|RadioButton|  
+|ToolbarWindow32|区切り記号|  
+|tooltips\_class32|ヒント|  
+|\#32774|ヒント|  
+|ReBarWindow32|ツール バー|  
+|SysTreeView32|ツリー|  
+|SysTreeView32|TreeItem|  
+  
+ **注** RichEdit コントロールは、[!INCLUDE[TLA#tla_winvista](../../../includes/tlasharptla-winvista-md.md)] に付属するバージョン \(RichEd20.dll バージョン 3.1 以降、および MsftEdit.dll バージョン 4.1 以降\) に対してのみサポートされます。  
+  
+ 次のコントロールはサポートされていません。  
+  
+|クラス名|コントロールの種類|  
+|----------|---------------|  
+|SysAnimate32|イメージ|  
+|SysPager|Spinner|  
+|SysDateTimePick32|カスタム|  
+|SysMonthCal32|予定表|  
+|MS\_WINNOTE|Tooltip|  
+|VBBubble|Tooltip|  
+|ScrollBar \(スタンドアロン コントロールとして使用される場合\)|スライダー|  
+|SuperGrid|カスタム|  
+  
+<a name="Windows_Forms_Controls"></a>   
+## Windows フォーム コントロール  
+ [!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)] コントロールは、UIAutomationClientsideProviders.dll のクライアント側プロバイダーによって [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] に公開されています。 このアセンブリは、UI オートメーション クライアント アプリケーションで使用するために、自動的に登録されます。  
+  
+ 通常、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] の一般的なコントロールのマネージ ラッパーである [!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)] コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] によってサポートされます。 次のコントロールがサポートされています。  
+  
+|クラス名|  
+|----------|  
+|ボタン|  
+|CheckBox|  
+|CheckedListBox|  
+|ColorDialog|  
+|ComboBox|  
+|FolderBrowser|  
+|FontDialog|  
+|GroupBox|  
+|HscrollBar|  
+|ImageList|  
+|ラベル|  
+|ListBox|  
+|ListView|  
+|MainMenu\/ContextMenu|  
+|MonthCalendar|  
+|NotifyIcon|  
+|OpenFileDialog|  
+|PageSetupDialog|  
+|PrintDialog|  
+|ProgressBar|  
+|RadioButton|  
+|RichTextBox|  
+|SaveFileDialog|  
+|ScrollableControl|  
+|SoundPlayer|  
+|StatusBar|  
+|TabControl\/TabPage|  
+|TextBox|  
+|タイマー|  
+|ツール バー|  
+|ヒント|  
+|TrackBar|  
+|TreeView|  
+|VscrollBar|  
+|Web ブラウザー|  
+  
+ 次に示すコントロールは、[!INCLUDE[TLA#tla_aa](../../../includes/tlasharptla-aa-md.md)] のサポートによってのみ、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] に公開されています。 一部の機能が使用できないことがあります。  
+  
+|コントロール名|  
+|-------------|  
+|BindingSource|  
+|DataGrid|  
+|DataGridView|  
+|DataNavigator|  
+|DomainUpDown|  
+|ErrorProvider|  
+|FlowLayoutPanel|  
+|フォーム|  
+|LinkLabel|  
+|HelpProvider|  
+|MaskedTextBox|  
+|MenuStrip\/ContextMenuStrip|  
+|NumericUpDown|  
+|パネル|  
+|PictureBox|  
+|PrintDocument|  
+|PrintPreview\-Control|  
+|PrintPreview\-Dialog|  
+|PropertyGrid|  
+|UserControl|  
+|ToolStrip|  
+|TableLayoutPanel|  
+|SplitContainer\/SplitterPanel|  
+|スプリッター|  
+|RaftingContainer|  
+|StatusStrip|  
+  
+## 参照  
+ [UI Automation Control Types](../../../docs/framework/ui-automation/ui-automation-control-types.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-button-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-button-control-type.md
new file mode 100644
index 00000000000..5bb99d96e1b
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-button-control-type.md
@@ -0,0 +1,88 @@
+---
+title: "UI Automation Support for the Button Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Button"
+  - "UI Automation, Button control type"
+  - "Button control type"
+ms.assetid: 057c983a-da83-4c50-86c7-26fe381076a6
+caps.latest.revision: 34
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 34
+---
+# UI Automation Support for the Button Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Button コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターン、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントに関する特定のガイドラインが含まれます。  
+  
+ ボタンとは、ユーザーが操作を実行するために対話するオブジェクトのことです。その例には、ダイアログ ボックスにある **\[OK\]** ボタンや **\[キャンセル\]** ボタンなどがあります。 ボタン コントロールは、ユーザーがコマンドを完了できるよう、単一のコマンドにマップされて公開されることから、単純なコントロールです。  
+  
+ 以降のセクションで、Button コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかに関わらず、すべてのボタン コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、コントロール ビューと、ボタン コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ボタン<br /><br /> -   イメージ \(0 個以上\)<br />-   テキスト \(0 個以上\)|ボタン|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Button コントロール型を実装するコントロール \(ボタン コントロールなど\) に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty>|「ノート」を参照。|ボタン コントロールは、通常、そのコントロールが表す操作をエンド ユーザーがキーボードから素早く実行できるように、アクセラレータ キーをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ボタン|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」を参照。|ヘルプ テキストで、ボタンをアクティブにした場合の最終結果を説明できます。 これは一般に、ツールヒントに表示する情報と同じような情報です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|Button コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|Button コントロールは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|ボタン コントロールは、そのコンテンツで自己ラベル付けを行います。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「ボタン」|Button コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|ボタン コントロールの名前は、そのコントロールのラベル付けに使用されるテキストです。 ボタンのラベル付けにイメージを使用する場合は、必ずボタンの Name プロパティに代替テキストを指定する必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|「ノート」を参照。|すべてのボタンは、Invoke コントロール パターンまたは Toggle コントロール パターンをサポートする必要があります。 Invoke は、ボタンがユーザーの要求時にコマンドを実行する場合にサポートされます。 このコマンドは、切り取り、コピー、貼り付け、削除などの単一の操作にマップされます。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|「ノート」を参照。|すべてのボタンは、Invoke コントロール パターンまたは Toggle コントロール パターンをサポートする必要があります。 Toggle は、ボタンが最大 3 つの一連の状態を循環できる場合にサポートされます。 通常は、特定の機能のオン\/オフの切り替えと見なされます。|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|「ノート」を参照。|ボタンが分割ボタンの子としてホストされる場合、子ボタンは Invoke または Toggle パターンの代わりに ExpandCollapse パターンをサポートすることができます。 ExpandCollapse パターンは、ボタン要素に関連付けられたメニューやその他のサブ構造を開く、または閉じるために使用できます。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|コントロールが Invoke コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|コントロールが Toggle コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Button>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-calendar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-calendar-control-type.md
new file mode 100644
index 00000000000..7c1ed90d941
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-calendar-control-type.md
@@ -0,0 +1,96 @@
+---
+title: "UI Automation Support for the Calendar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Calendar control type"
+  - "Calendar control type"
+  - "control types, Calendar"
+ms.assetid: e91a7393-a7f9-4838-a1a6-857438b24bc9
+caps.latest.revision: 26
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 26
+---
+# UI Automation Support for the Calendar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Calendar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターン、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントに関する特定のガイドラインが含まれます。  
+  
+ Calendar コントロールでは、簡単に日付を指定したり、他の日付を選択したりできます。  
+  
+ 以下の各セクションで、Calendar コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の各要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのカレンダー コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、カレンダー コントロールに関連した [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|予定表<br /><br /> <ul><li>DataGrid<br /><br /> <ul><li>Header \(0 または 1\)</li><li>HeaderItem \(0 または 7、数量は列に表示される日数によって異なる\)</li><li>ListItem \(数量は表示される日数によって異なる\)</li><li>Button \(0 または 2、カレンダー ビューのページ移動用\)</li></ul></li></ul>|予定表<br /><br /> -   ListItem \(数量は表示される日数によって異なる\)|  
+  
+ Calendar コントロールは、ユーザー インターフェイスのさまざまな形式で表すことができます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれることが保証されるコントロールは、データ グリッド、ヘッダー、ヘッダー項目、およびリスト項目のコントロールだけです。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、カレンダー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|予定表|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|カレンダー コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに常に含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|カレンダー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|ドキュメント コントロールのラベル。 通常は、ドキュメントのタイトルが使用されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"カレンダー"|Calendar コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|通常、カレンダー コントロールの名前は、今日の日付から取得されます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのカレンダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|Support|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridProvider>|はい|1 か月の中に含まれる日付が空間的に移動できる項目になるため、カレンダー コントロールは必ず Grid パターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|ほとんどのカレンダー コントロールはページごとのビューのフリッピングをサポートしています。 ページ移動をサポートするために、Scroll パターンを使用することをお勧めします。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|状況に依存|ほとんどのカレンダー コントロールは、特定の日付、月、または年を、サブ要素の選択内容の形で保存します。 複数選択が可能なカレンダーもあれば、1 つしか選択できないカレンダーもあります。|  
+|<xref:System.Windows.Automation.Provider.ITableProvider>|はい|カレンダー コントロールには曜日のサブツリー内に常にヘッダーがあるため、Table パターンがサポートされる必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|いいえ|カレンダー コントロールでは値を直接設定できないため、このコントロールに Value コントロール パターンは必要ありません。 特定の日付がコントロールに関連付けられている場合は、Selection コントロール パターンによって情報を提供する必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのカレンダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LayoutInvalidatedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.MultipleViewPatternIdentifiers.CurrentViewProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Calendar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-checkbox-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-checkbox-control-type.md
new file mode 100644
index 00000000000..765e4e7c4cc
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-checkbox-control-type.md
@@ -0,0 +1,88 @@
+---
+title: "UI Automation Support for the CheckBox Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CheckBox control type"
+  - "control types, CheckBox"
+  - "UI Automation, CheckBox control type"
+ms.assetid: 9c2a0e70-3a39-4ba9-96ea-a7fe531fae9f
+caps.latest.revision: 31
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 31
+---
+# UI Automation Support for the CheckBox Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、CheckBox コントロール型の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ チェック ボックスは、ユーザーが対話的にその状態を循環させることが可能な状態を示すために使用されるオブジェクトです。 チェック ボックスでは、2 項 \(はい\/いいえ\)、\(オン\/オフ\) または 3 項 \(オン\/オフ、不定\) のいずれかのオプションをユーザーに提示できます。  
+  
+ 以降のセクションで、CheckBox コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかに関わらず、すべてのチェック ボックス コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、チェック ボックス コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|CheckBox|CheckBox|  
+  
+> [!NOTE]
+>  チェック ボックスは、コントロールやコンテンツ ビュー内に子要素を持つことはありません。 コントロールに子要素を入れる必要があるのであれば、それは別のコントロール型を使用する必要があるということです。  
+  
+### 必須の UI オートメーション プロパティ  
+ 次の表に、チェック ボックス コンロトールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|CheckBox|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|このプロパティの値は、常に True にする必要があります。 つまり、チェック ボックス コントロールが常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれている必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|このプロパティの値は、常に True にする必要があります。 つまり、チェック ボックス コントロールが常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれている必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|チェック ボックスはそれ自体がラベルであるコントロールです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"チェック ボックス"|CheckBox コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|チェック ボックス コントロールの `Name` プロパティの値は、切り替えの状態を保持するボックスの横に表示されるテキストです。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのチェック ボックス コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|必要|チェック ボックスで、プログラムを使用して内部の状態をいつでも循環できるようにします。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのチェック ボックス コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|必須|なし|  
+  
+<a name="Default_Action"></a>   
+## 既定の動作  
+ チェック ボックスの既定の動作では、ラジオ ボタンにフォーカスが設定されて、その現在の状態を切り替えます。 前述のように、チェック ボックスでは、2 項 \(はい\/いいえ\)、\(オン\/オフ\) または 3 項 \(オン\/オフ、不定\) のいずれかの決定項目をユーザーに提示します。 チェック ボックスが 2 項の場合、既定の動作では、「オン」の状態が「オフ」になり、「オフ」の状態が「オン」になります。 3 項のチェック ボックスで、既定の動作では、ユーザーがコントロールに連続するマウス クリックを送信した場合と同じ順序で、チェック ボックスの状態を切り替えます。  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.CheckBox>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-combobox-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-combobox-control-type.md
new file mode 100644
index 00000000000..27edf5175bb
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-combobox-control-type.md
@@ -0,0 +1,89 @@
+---
+title: "UI Automation Support for the ComboBox Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Combo Box"
+  - "UI Automation, Combo Box control type"
+  - "ComboBox controls"
+ms.assetid: bb321126-4770-41da-983a-67b7b89d45dd
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# UI Automation Support for the ComboBox Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、ComboBox コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターン、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントに関する特定のガイドラインが含まれます。  
+  
+ コンボ ボックスは、スタティック コントロールまたは編集コントロールが組み合わせられたリスト ボックスです。コンボ ボックスのリスト ボックスの部分には、現在選択されている項目が表示されます。 コントロールのリスト ボックスの部分は常に表示されるか、ユーザーがコントロールの横にあるドロップダウン矢印 \(プッシュ ボタン\) を選択したときにのみ表示されます。 選択フィールドが編集コントロールである場合、ユーザーは、リスト ボックスに含まれていない情報を入力できます。そうでない場合、ユーザーはリスト ボックスに含まれる項目を選択することしかできません。  
+  
+ 以降のセクションで、ComboBox コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかに関わらず、すべてのコンボ ボックス コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、コンボ ボックス コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ComboBox<br /><br /> -   エディット \(0 または 1 個\)<br />-   リスト \(1 個\)<br />-   リスト項目 \(リストの子。0 個以上\)<br />-   ボタン \(1 個\)|ComboBox<br /><br /> -   リスト項目 \(0 個以上\)|  
+  
+ コンボ ボックスのコントロール ビュー内の編集コントロールは、\[実行\] ダイアログ ボックスの場合と同じく、コンボ ボックスが編集可能で任意の入力値を受け取る場合にのみ必要です。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、コンボ ボックス コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ComboBox|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」を参照。|コンボ ボックス コントロールのヘルプ テキストで、コンボ ボックスからオプションを選択するようにユーザーに求める理由を説明する必要があります。 テキストは、ツールヒントに表示する情報に似ています。 たとえば、「項目を選択してモニターのディスプレイ解像度を設定してください」などです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|コンボ ボックス コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|コンボ ボックス コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|True|コンボ ボックス コントロールは、選択コンテナーの項目のセットを公開します。 コンボ ボックス コントロールは、キーボード フォーカスを受け取ることができますが、UI オートメーション クライアントがコンボ ボックスにフォーカスを設定すると、コンボ ボックス サブツリーの項目がフォーカスを受け取る場合があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照。|コンボ ボックス コントロールには、通常、このプロパティが参照する静的なテキスト ラベルがあります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「コンボ ボックス」|ComboBox コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|コンボ ボックス コントロールの名前は、通常、静的なテキスト コントロールから取得されます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのコンボ ボックス コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|はい|コンボ ボックス コントロールがコンボ ボックスであるためには、必ず、ドロップダウン ボタンがなければなりません。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|はい|コンボ ボックスで現在選択されている項目を表示します。 このサポートは、コンボ ボックスの下にあるリスト ボックスに委任されます。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|コンボ ボックスが任意のテキスト値を受け取ることができる場合、Value パターンをサポートする必要があります。 このパターンでは、コンボ ボックスの文字列の内容をプログラムで設定することができます。 Value パターンがサポートされていない場合、ユーザーはコンボ ボックスのサブツリー内のリスト項目から項目を選択する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|Never|スクロール パターンがコンボ ボックスで直接サポートされることはありません。 コンボ ボックスに含まれるリスト ボックスをスクロールできる場合は、このパターンがサポートされます。 リスト ボックスが画面に表示されている場合にのみサポートできます。|  
+  
+<a name="Required_Events"></a>   
+## 必須イベント  
+ 次の表に、すべてのコンボ ボックス コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|コントロールが Value パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ComboBox>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-datagrid-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-datagrid-control-type.md
new file mode 100644
index 00000000000..6ae838f4c1f
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-datagrid-control-type.md
@@ -0,0 +1,117 @@
+---
+title: "UI Automation Support for the DataGrid Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Data Grid control type"
+  - "control types, Data Grid"
+  - "UI Automation, Data Grid control type"
+ms.assetid: a3db4a3f-feb5-4e5f-9b42-aae7fa816e8a
+caps.latest.revision: 32
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 32
+---
+# UI Automation Support for the DataGrid Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、DataGrid コントロール型の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] サポートに関する情報を提供します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが `ControlType` プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ DataGrid コントロール型により、列で表されるメタデータを含む項目をユーザーが簡単に扱うことができます。 データ グリッド コントロールでは、項目の行と、それらの項目に関する情報の列があります。 Microsoft Vista Explorer のリスト ビュー コントロールは、DataGrid コントロール型をサポートする例です。  
+  
+ 以下の各セクションで、DataGrid コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのデータ グリッド コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、データ グリッド コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含まれる可能性のある内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|DataGrid<br /><br /> <ul><li>Header \(0、1、または 2\)<br /><br /> <ul><li>HeaderItem \(列または行の数\)</li></ul></li><li>DataItem \(0 以上。階層で構造化できます\)</li></ul>|DataGrid<br /><br /> -   DataItem \(0 以上。階層で構造化できます\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、データ グリッド コントロールに特に関連する値または定義を持つプロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|プロパティ|値|ノート|  
+|-----------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|DataGrid|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|このプロパティの値は、常に True にする必要があります。 つまり、データ グリッド コントロールが常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに存在している必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|このプロパティの値は、常に True にする必要があります。 つまり、データ グリッド コントロールが常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに存在している必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|ノートを参照してください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"データ グリッド"|DataGrid コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|データ グリッド コントロールは、通常、静的テキスト ラベルから `Name` プロパティの列を取得します。 静的なテキスト ラベルがない場合は、アプリケーション開発者が `Name` のプロパティ値を割り当てる必要があります。`Name` プロパティの値が、編集コントロールのテキストの内容になることは決してありません。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのデータ グリッド コントロールでサポートされなければならないコントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridProvider>|はい|データ グリッド コントロール自体は、メタデータを格納する項目がグリッドに配置されるため、常に、グリッド コントロール パターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|データ グリッドをスクロールする機能はコンテンツ、およびスクロール バーが存在するかどうかによって異なります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|状況に依存|データ グリッドを選択する機能は、コンテンツに依存します。|  
+|<xref:System.Windows.Automation.Provider.ITableProvider>|はい|データ グリッド コントロールはサブツリー内に常にヘッダーがあるため、Table コントロール パターンがサポートされる必要があります。|  
+  
+ データ グリッド コンテナー内のデータ項目は、少なくとも次をサポートします。  
+  
+-   選択項目コントロール パターン \(データ グリッドが選択可能な場合\)  
+  
+-   スクロール項目コントロール パターン \(データ グリッドがスクロール可能な場合\)  
+  
+-   グリッド項目コントロール パターン  
+  
+-   テーブル項目コントロール パターン  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのデータ グリッド コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LayoutInvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.MultipleViewPatternIdentifiers.CurrentViewProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|コントロールで Scroll パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|必要|なし|  
+  
+<a name="List_View_Control_Example"></a>   
+## データ グリッド コントロール型の例  
+ 次の図に、DataGrid コントロール型を実装するリスト ビュー コントロールを示します。  
+  
+ ![2 つのデータ項目を含むリスト ビュー コントロールのグラフィック](../../../docs/framework/ui-automation/media/uiauto-data-grid-detailed.GIF "uiauto\_data\_grid\_detailed")  
+  
+ 以下には、リスト ビュー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューが表示されています。 オートメーションの各要素のコントロール パターンが、かっこ内に示されています。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|<ul><li>DataGrid \(Table、Grid、Selection\)</li><li>ヘッダー<br /><br /> <ul><li>HeaderItem "Name" \(Invoke\)</li><li>HeaderItem "Date Modified" \(Invoke\)</li><li>HeaderItem "Size" \(Invoke\)</li></ul></li><li>Group "Contoso" \(TableItem、GridItem、SelectionItem、Table\*、Grid\*\)<br /><br /> <ul><li>DataItem "Accounts Receivable.doc" \(SelectionItem、Invoke、TableItem\*、GridItem\*\)</li><li>DataItem "Accounts Payable.doc" \(SelectionItem、Invoke、TableItem\*、GridItem\*\)</li></ul></li></ul>|<ul><li>DataGrid \(Table、Grid、Selection\)</li><li>Group "Contoso" \(TableItem、GridItem、SelectionItem、Table\*、Grid\*\)<br /><br /> <ul><li>DataItem "Accounts Receivable.doc" \(SelectionItem、Invoke、TableItem\*、GridItem\*\)</li><li>DataItem "Accounts Payable.doc" \(SelectionItem、Invoke、TableItem\*、GridItem\*\)</li></ul></li></ul>|  
+  
+ \* 上記の例では、コントロールの複数のレベルを含む DataGrid を示します。 グループ \("Contoso"\) のコントロールには、2 つのDataItem コントロール \("Accounts Receivable.doc" および "Accounts Payable.doc"\) が含まれています。 DataGrid と GridItem ペアは、他のレベルのペアから独立しています。 グループの下にある DataItem コントロールは、ListItem コントロール型として公開することもでき、単純なデータ要素としてではなく、選択可能オブジェクトとして、より明確に提示することができます。 この例では、グループ化されたデータ項目のサブ要素は含まれません。  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.DataGrid>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md
new file mode 100644
index 00000000000..8cb289d5344
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md
@@ -0,0 +1,119 @@
+---
+title: "UI Automation Support for the DataItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Data Item control type"
+  - "Data Item control type"
+  - "control types, Data Item"
+ms.assetid: 181708fd-2595-4c43-9abd-75811627d64c
+caps.latest.revision: 36
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 36
+---
+# UI Automation Support for the DataItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、DataItem コントロール型に対する [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ 連絡先リストのエントリは、データ項目コントロールの一例です。 データ項目コントロールには、エンド ユーザーに必要な情報が格納されます。 これは、より豊富な情報が格納されるため、単純なリスト項目よりも複雑になります。  
+  
+ 以下の各セクションで、DataItem コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのデータ項目コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、データ項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|DataItem<br /><br /> -   多種多様 \(0 以上。階層で構造化できます\)|DataItem<br /><br /> -   多種多様 \(0 以上。階層で構造化できます\)|  
+  
+ データ グリッド内のデータ項目要素は、さまざまなオブジェクトをホストできます。たとえば、別のレイヤーのデータ項目や、テキスト、イメージ、エディット コントロールなどの特定のグリッド要素をホストできます。 データ項目要素に特定のオブジェクトの役割がある場合は、その要素を特定のコントロール型 \(たとえば、グリッド内の選択可能なデータ項目の場合は ListItem コントロール型など\) として公開する必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、データ項目コントロールに特に関連する値または定義を持つプロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|プロパティ|値|ノート|  
+|-----------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|DataItem|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|データ項目コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|データ項目コントロールは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemStatusProperty>|「ノート」を参照。|コントロールに動的に更新される状態が含まれる場合、要素の状態が変化したときに支援技術が更新を受け取ることができるように、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemTypeProperty>|「ノート」を参照。|これは、項目が表す基になるオブジェクトをエンド ユーザーに伝達する文字列値です。 例として "メディア ファイル" や "連絡先" があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|データ項目コントロールに静的なテキスト ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"data item"|DataItem コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|データ項目コントロールには、主要なテキスト要素が常に含まれています。この要素は、その項目に対してユーザーが最も意味的な識別子として連想するものに関連しています。|  
+  
+<a name="_Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのデータ項目コントロールでサポートされなければならない [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|状況に依存|データ項目を展開したり折りたたんだりして、情報の表示\/非表示を切り替える場合、Expand Collapse パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider>|状況に依存|データ項目の集合が、空間的に項目間を移動できるコンテナー内にある場合、データ項目は Grid Item パターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.IScrollItemProvider>|状況に依存|画面に収まる項目数を超える項目がデータ コンテナーにある場合、すべてのデータ項目は Scroll Item パターンを使用して、スクロールして表示する機能をサポートします。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|はい|すべてのデータ項目は、項目が選択されたタイミングを示す Selection Item パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider>|状況に依存|データ項目が Data Grid コントロール型の中に含まれている場合、このパターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|状況に依存|データ項目に循環する状態が含まれる場合。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|データ項目の主要なテキストが編集可能な場合は、Value パターンをサポートする必要があります。|  
+  
+<a name="Working_with_Data_Items_in_Large_Lists"></a>   
+## 大きなリストでのデータ項目の操作  
+ 大きなリストでは、多くの場合、パフォーマンスを向上させるため、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワーク内でデータが仮想化されます。 そのため、UI オートメーション クライアントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クエリ機能を使用して、他の項目コンテナーと同じように完全なツリーからコンテンツを取得することができません。 クライアントは、データ項目の完全に揃った情報にアクセスする前に、項目をスクロールして表示する \(またはコントロールを展開して重要なすべてのオプションを表示する\) 必要があります。  
+  
+ データ項目の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素で `SetFocus` を呼び出すときに、[!INCLUDE[TLA#tla_winexpl](../../../includes/tlasharptla-winexpl-md.md)] の場合は正常に値を返し、データ項目サブツリー内でフォーカスを編集に設定します。  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのデータ項目コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+  
+<a name="Data_Item_Control_Type_Example"></a>   
+## DataItem コントロール型の例  
+ 次の図は、列の豊富な情報をサポートするリスト ビュー コントロール内の DataItem コントロール型を示しています。  
+  
+ ![2 つのデータ項目を含むリスト ビュー コントロールのグラフィック](../../../docs/framework/ui-automation/media/uiauto-data-grid-detailed.GIF "uiauto\_data\_grid\_detailed")  
+  
+ 以下には、データ項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューが表示されています。 オートメーションの各要素のコントロール パターンが、かっこ内に示されています。 グループ "Contoso" は、データ グリッド ホスト コントロールのグリッドの一部でもあります。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|-   Group "Contoso" \(Table, Grid\)<br />-   DataItem "Accounts Receivable.doc" \(TableItem, GridItem, SelectionItem, Invoke\)<br />-   Image "Accounts Receivable.doc"<br />-   Edit "Name" \(TableItem, GridItem, Value "Accounts Receivable.doc"\)<br />-   Edit "Date modified" \(TableItem, GridItem, Value "8\/25\/2006 3:29 PM"\)<br />-   Edit "Size" \(GridItem, TableItem, Value "11.0 KB\)<br />-   DataItem "Accounts Payable.doc" \(TableItem, GridItem, SelectionItem, Invoke\)<br />-   ...|-   Group "Contoso" \(Table, Grid\)<br />-   DataItem "Accounts Receivable.doc" \(TableItem, GridItem, SelectionItem, Invoke\)<br />-   Image "Accounts Receivable.doc"<br />-   Edit "Name" \(TableItem, GridItem, Value "Accounts Receivable.doc"\)<br />-   Edit "Date modified" \(TableItem, GridItem, Value "8\/25\/2006 3:29 PM"\)<br />-   Edit "Size" \(GridItem, TableItem, Value "11.0 KB\)<br />-   DataItem "Accounts Payable.doc" \(TableItem, GridItem, SelectionItem, Invoke\)<br />-   …|  
+  
+ グリッドが選択可能な項目のリストを表している場合、DataItem コントロール型の代わりに、ListItem コントロール型で対応する UI 要素を公開できます。 前の例では、グループ \("Contoso"\) の下の DataItem 要素 \("Accounts Receivable.doc" および "Accounts Payable.doc"\) を ListItem コントロール型として公開することで、その型が既に SelectionItem コントロール パターンをサポートしているため、それらの要素を向上させることができます。  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.DataItem>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-document-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-document-control-type.md
new file mode 100644
index 00000000000..b6cb593baef
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-document-control-type.md
@@ -0,0 +1,93 @@
+---
+title: "UI Automation Support for the Document Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Document"
+  - "Document control type"
+  - "UI Automation, Document control type"
+ms.assetid: a79d594b-1ca0-4543-8dac-afd2c645201d
+caps.latest.revision: 27
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 27
+---
+# UI Automation Support for the Document Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Document コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートに関する情報を提供します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ドキュメント コントロールを使用すると、ユーザーは複数ページのテキストを表示して操作できます。 書式設定されていない単純なテキスト行しかサポートしない編集コントロールとは異なり、ドキュメント コントロールは、さまざまなスタイルおよび書式を使用したテキストをホストできます。  
+  
+ 以降のセクションで、Document コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのドキュメント コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ドキュメント コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ドキュメント<br /><br /> -   可変|ドキュメント<br /><br /> -   可変|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ドキュメント コンロトールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|ドキュメントにはクリック可能なポイントがあり、そのポイントをクリックすると、ドキュメント コンテナー内のいずれかの要素のドキュメントがフォーカスを受け取ります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ドキュメント|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ドキュメント コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ドキュメント コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照。|このプロパティの値は、ドキュメント コントロールのラベルでなければなりません。 通常、ドキュメントのタイトルが使用されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「ドキュメント」|Document コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|通常、ドキュメント コントロールの名前は、読み込み元のファイル名から取得されます。 この名前は多くの場合、そのコントロールを格納するウィンドウまたはフレームのタイトルに表示されます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、ドキュメント コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|ドキュメント コントロールは、ビューポートのスパンを超えてスパンできます。 コントロールのコンテンツがスクロール可能な場合は、Scroll コントロール パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ITextProvider>|必要|ドキュメント コントロールは、ビューポートのスパンを超えてスパンできます。 コントロールのコンテンツがスクロール可能な場合は、Scroll コントロール パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|Never|通常、ドキュメント コントロールのコンテンツは複数のページにまたがるため、ドキュメント コントロールはこのコントロール パターンをサポートしません。 UI オートメーション クライアントは、<xref:System.Windows.Automation.TextPattern> を使用してドキュメントに関するテキスト情報を取得する必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのドキュメント コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|状況に依存|コントロールが Selection コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextSelectionChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|Never|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Document>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-edit-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-edit-control-type.md
new file mode 100644
index 00000000000..399ff7bc47f
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-edit-control-type.md
@@ -0,0 +1,105 @@
+---
+title: "UI Automation Support for the Edit Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Edit"
+  - "Edit control type"
+  - "UI Automation, Edit control type"
+ms.assetid: 6db9d231-c0a0-4e17-910e-ac80357f774f
+caps.latest.revision: 29
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 29
+---
+# UI Automation Support for the Edit Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Edit コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ 編集コントロールを使用すると、さまざまな書式設定の機能をサポートしなくてもユーザーは単純なテキスト行を表示、および編集することができます。  
+  
+ 以降のセクションで、Edit コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、イベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべての編集コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、編集コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|編集|編集|  
+  
+ Edit コントロール型を実装するコントロールは単一行のコントロールであるため、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューにスクロール バーは表示されません。 1 行のテキストは、一部のレイアウト シナリオでは折り返されることがあります。 Edit コントロール型は、編集可能または選択可能なテキストを少量保持するのに最適です。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、編集コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意にする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|編集コントロールには、ユーザーがその場所でマウスをクリックしたときに、コントロールの編集部分に入力フォーカスを設定する、クリック可能なポイントが必要です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|編集コントロールの名前は、通常、静的なテキスト ラベルから生成されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が `Name` のプロパティ値を割り当てる必要があります。`Name` プロパティには、編集コントロールのテキスト コンテンツを含めることができません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」をご覧ください。|コントロールに関連付けられた静的なテキスト ラベルが存在する場合、このプロパティはそのコントロールへの参照を公開する必要があります。 テキスト コントロールが別のコントロールのサブコンポーネントである場合、`LabeledBy` プロパティは設定されません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|編集|この値はすべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"エディット"|Edit コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|編集コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|編集コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsPasswordProperty>|「ノート」をご覧ください。|パスワードが含まれている編集コントロールの場合は true に設定する必要があります。 編集コントロールにパスワードのコンテンツが含まれる場合、スクリーン リーダーはこのプロパティを使用して、ユーザーが入力するキーストロークを読み上げる必要があるかどうかを判別できます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、すべての編集コントロールでサポートする必要があるコントロール パターンの一覧を示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン\/コントロール パターン プロパティ|サポート\/値|ノート|  
+|------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITextProvider>|状況に依存|編集コントロールは、テキスト コントロール パターンをサポートする必要があります。これは、クライアントが常に詳しいテキスト情報を利用できるようにする必要があるためです。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|文字列を受け取るすべての編集コントロールは、Value パターンを公開する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider.IsReadOnly%2A>|「ノート」をご覧ください。|コントロールがプログラムで値を設定できるか、それともユーザーが値を編集できるかを示すために、このプロパティを設定する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider.Value%2A>|「ノート」をご覧ください。|このプロパティは、編集コントロールのテキスト コンテンツを返します。`IsPasswordProperty` が `true` に設定されている場合、このプロパティは要求されたときに `InvalidOpertaionException` を発生させる必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|数値の範囲を受け取るすべての編集コントロールは、Range Value コントロール パターンを公開する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.Minimum%2A>|「ノート」をご覧ください。|このプロパティは、編集コントロールのコンテンツに対して設定できる最小値にする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.Maximum%2A>|「ノート」をご覧ください。|このプロパティは、編集コントロールのコンテンツに対して設定できる最大値にする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.SmallChange%2A>|「ノート」をご覧ください。|このプロパティは、値に対して設定できる小数点以下の桁数を示す必要があります。 エディットが整数のみを受け取る場合は、`SmallChangeProperty` を 1 にする必要があります。 エディットが 1.0 ～ 2.0 の範囲を受け取る場合は、`SmallChangeProperty` を 0.1 にする必要があります。 編集コントロールが 1.00 ～ 2.00 の範囲を受け取る場合は、`SmallChangeProperty` を 0.001 にする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.LargeChange%2A>|`Null`|このプロパティは、編集コントロールで公開する必要はありません。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.Value%2A>|「ノート」をご覧ください。|このプロパティは、編集コントロールの数値コンテンツを示します。`Minimum` および `Maximum` プロパティで指定された範囲内で [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クライアントによってより精度の高い値が設定された場合、Value プロパティは、受け入れ可能な値に最も近い値に自動的に丸められます。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべての編集コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントの一覧を示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextSelectionChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.RangeValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|コントロールが Range Value コントロール パターンをサポートする場合は、このイベントをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Edit>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-group-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-group-control-type.md
new file mode 100644
index 00000000000..75d69c9a945
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-group-control-type.md
@@ -0,0 +1,85 @@
+---
+title: "UI Automation Support for the Group Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Group control type"
+  - "Group control type"
+  - "control types, Group"
+ms.assetid: 18e01bab-01f8-4567-b867-88dce9c4a435
+caps.latest.revision: 27
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 27
+---
+# UI Automation Support for the Group Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Group コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ グループ コントロールは、階層内のノードを表します。 Group コントロール型は、グループとしてまとめられた項目が [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内で論理区画を持つように、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーに区画を作成します。  
+  
+ 以下の各セクションで、Group コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのグループ コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、グループ コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|グループ化<br /><br /> -   0 以上のコントロール|グループ化<br /><br /> -   0 以上のコントロール|  
+  
+ 通常、グループ コントロールのコントロール型は、[UI Automation Support for the ListItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md)、[UI Automation Support for the TreeItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md)、または [UI Automation Support for the DataItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-dataitem-control-type.md) であり、サブツリーではグループ コントロールの下にこれらが存在します。 'Group' は汎用的なコンテナーであるため、任意の型のコントロールを、ツリーのグループ コントロールの下に配置できます。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、グループ コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|通常、グループ コントロールの名前は、コントロールにラベル付けするテキストから取得されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照。|通常、グループ コントロールは、自動的にラベル付けされます。 ここでは、`null` が返されます。 グループに静的なテキスト ラベルが存在する場合は、そのラベルを LabeledBy プロパティの値として返す必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|グループ化|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"group"|Group コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|グループ コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|カレンダー グループは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、Group コントロール型でサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|状況に依存|情報の表示\/非表示を切り替えるために使用するグループ コントロールは、Expand Collapse パターンをサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのグループ コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Group>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-header-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-header-control-type.md
new file mode 100644
index 00000000000..5e56f63fc37
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-header-control-type.md
@@ -0,0 +1,86 @@
+---
+title: "UI Automation Support for the Header Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Header control type"
+  - "Header control type"
+  - "control types, Header"
+ms.assetid: d2e48891-2dbe-409e-8655-2f753908e29b
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the Header Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Header コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ヘッダー コントロールは、情報の行または列のラベルのためのビジュアル コンテナーを提供します。  
+  
+ 以下の各セクションで、Header コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのヘッダー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ヘッダー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ヘッダー<br /><br /> -   HeaderItem \(1 個以上\)|なし|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューには、必ず、ヘッダー コントロールの 1 つ以上の子が存在します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューには、ヘッダー コントロールの子は存在しません。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ヘッダー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|複数の行ヘッダーまたは複数の列ヘッダーがある場合、ヘッダー コントロールには名前が必要です。 これにより、ヘッダー内の情報を識別します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`。|ヘッダー コントロールに静的ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|Header|この値はすべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"header"|この値はすべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.OrientationProperty>|\[水平方向\]|このプロパティの値は、ヘッダー コントロールの位置 \(行ヘッダーまたは列ヘッダーが存在する位置\) を公開します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|ヘッダー コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ヘッダー コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに常に含まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのヘッダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|状況に依存|ヘッダー コントロールのサイズを変更できる場合は、このコントロール パターンを実装します。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのヘッダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElement.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElement.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElement.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Header>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-headeritem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-headeritem-control-type.md
new file mode 100644
index 00000000000..119b9af2818
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-headeritem-control-type.md
@@ -0,0 +1,84 @@
+---
+title: "UI Automation Support for the HeaderItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Header Item control type"
+  - "Header Item control type"
+  - "control types, Header Item"
+ms.assetid: 09ce1310-ee31-493c-a71e-010bafc42fcf
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the HeaderItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、HeaderItem コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ HeaderItem コントロール型は、情報の行または列のビジュアル ラベルを提供します。  
+  
+ HeaderItem コントロール型を実装するコントロールの例には、ヘッダー項目コントロールがあります。 以降のセクションに記載する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関わらず、すべてのヘッダー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、コントロール ビューと、ヘッダー項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューを示し、それぞれのビューに含められる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|HeaderItem|なし|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ヘッダー項目コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|ヘッダー項目コントロールは、常に自己ラベル付けを行います。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`。|ヘッダー項目コントロールに静的ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|HeaderItem|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「ヘッダー項目」|HeaderItem コントロール型のローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|ヘッダー項目コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ヘッダー項目コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemStatusProperty>|「ノート」を参照。|このプロパティは、ヘッダー項目による並べ替え順序の情報を提供します。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのヘッダー項目コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|状況に依存|ヘッダー項目コントロールのサイズを変更できる場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|状況に依存|ヘッダー項目コントロールをクリックしてデータを並べ替えることができる場合は、このコントロール パターンを実装します。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのヘッダー項目コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.HeaderItem>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-hyperlink-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-hyperlink-control-type.md
new file mode 100644
index 00000000000..02b8032b51a
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-hyperlink-control-type.md
@@ -0,0 +1,85 @@
+---
+title: "UI Automation Support for the Hyperlink Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Hyperlink control type"
+  - "UI Automation, Hyperlink control type"
+  - "control types, Hyperlink"
+ms.assetid: 110cceea-5932-4955-a1a6-13afc51422b2
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the Hyperlink Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Hyperlink コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ハイパーリンク コントロールによって、ユーザーはページ内の移動、ページ間の移動、およびウィンドウのオープンを実行できます。  
+  
+ 以下の各セクションで、Hyperlink コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのハイパーリンク コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ハイパーリンク コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ハイパーリンク|ハイパーリンク|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Hyperlink コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|ハイパーリンク コントロールの名前は、下線付きで画面に表示されるテキストです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|ハイパーリンク コントロールのクリック可能なポイントは、マウス ポインターを使用してクリックした場合にハイパーリンクを起動するポイントである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ハイパーリンク|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"ハイパーリンク"|Hyperlink コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ハイパーリンク コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ハイパーリンク コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、すべてのハイパーリンク コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|はい|すべてのハイパーリンク コントロールは、Invoke パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|ユーザーにとって有効で意味のある情報がリンクに含まれている場合、ハイパーリンク コントロールは Value コントロール パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider.Value>|例: "http:\/\/www..."|インターネット アドレスまたはイントラネット アドレスの URL は、ユーザーにとって意味のある情報が含まれるハイパーリンクの例です。 一方、プログラム リンクはアプリケーションにしか意味がないため、Value プロパティには使用しないことをお勧めします。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのハイパーリンク コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Hyperlink>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-image-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-image-control-type.md
new file mode 100644
index 00000000000..4115b6e1a86
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-image-control-type.md
@@ -0,0 +1,91 @@
+---
+title: "UI Automation Support for the Image Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Image control type"
+  - "control types, Image"
+  - "Image control type"
+ms.assetid: 4e0eeefb-e09b-46d2-b83b-0a7e35543ab8
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the Image Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Image コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ アイコン、情報のグラフィック、チャートとして使用されるイメージ コントロールは、Image コントロール型をサポートします。 背景、またはウォーターマークのイメージとして使用されるコントロールは、Image コントロール型をサポートしません。  
+  
+ 以降のセクションで、Image コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、イベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのイメージ コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、イメージ コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|イメージ|Image \(イメージに、\(`IsContentElement` プロパティの値に基づいた\) 情報が含まれるかどうかによって異なります\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Image コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|イメージ コントロールのクリック可能なポイントは、イメージ コントロールの四角形領域内のポイントである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|情報が含まれているイメージ コントロールはすべて、Name プロパティが公開される必要があります。 この情報にプログラムでアクセスするには、グラフィックと等価なテキストを指定する必要があります。 イメージ コントロールが純粋な装飾の場合は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに表示するだけにとどめ、名前を付ける必要はありません。 UI フレームワークは、イメージ上の ALT \(代替テキスト\) プロパティをサポートする必要があります。これはそのフレームワークの内部から設定できます。 次いで、このプロパティは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] Name プロパティにマップされます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」をご覧ください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|イメージ|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"image"|Image コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|「ノート」をご覧ください。|エンド ユーザーに対してまだ公開されていない有用な情報がイメージ コントロールに含まれている場合、イメージ コントロールを [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含める必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|イメージ コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」をご覧ください。|HelpText プロパティは、コントロールの実際の外見 \(白い 'X' が記された赤い四角形など\) を説明するローカライズされた文字列や、イメージに関連する他のヒント情報を公開します。<br /><br /> イメージ コントロールについてより詳しい情報を示すために長い説明が必要な場合は、このプロパティをサポートする必要があります。 たとえば、複雑なチャートや図などです。 このプロパティは、HTML の LongDesc タグとスケーラブル ベクター グラフィックス \(SVG\) の Desc タグにマップされます。 イメージ コントロールを使用する開発者は、コントロールに視覚的な説明を設定できるようにするために、プロパティをサポートする必要があります。 このプロパティは、UI Automation VisualDescription プロパティにマップされる必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemStatusProperty>|「ノート」をご覧ください。|イメージ コントロールが画面上の特定の項目に関する状態情報を表している場合は、そのコントロールを対象の項目に含める必要があります。 ある項目の中にイメージが含まれている場合、その項目は状態プロパティをサポートし、状態が変わったときに適切な通知を発生させる必要があります。<br /><br /> イメージがスタンドアロン コントロールであり、状態を示している場合は、このプロパティをサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのイメージ コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider>|状況に依存|イメージ コントロールは、コントロールがグリッドのコンテナー内にある場合、Grid Item パターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider>|状況に依存|イメージ コントロールは、コントロールがヘッダー コントロールを持つコンテナー内にある場合、Table Item パターンをサポートします。|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|Never|イメージ コントロールにクリック可能なイメージが含まれている場合、コントロールは、Invoke パターン \(ボタン コントロール型など\) をサポートしているコントロール型をサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|Never|イメージ コントロールは、Selection Item パターンをサポートしてはなりません。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのイメージ コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|Never|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>|Never|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|Never|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Image>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-list-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-list-control-type.md
new file mode 100644
index 00000000000..0612ebe692d
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-list-control-type.md
@@ -0,0 +1,119 @@
+---
+title: "UI Automation Support for the List Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, List"
+  - "List control type"
+  - "UI Automation, List control type"
+ms.assetid: 0e959fcb-50f2-413b-948d-7167d279bc11
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the List Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、List コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ List コントロール型を使用すると、項目のフラットなグループを編成して、ユーザーにそれらの項目から 1 つ以上選択させることができます。 List コントロール型には、含めることができる子要素の型に関する緩い制限があります。 これにより、UI オートメーション プロバイダーは選択コンテナーの既知の要素をサポートできます。  
+  
+ 以下のセクションの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、List コントロール型を実装するすべてのコントロールに適用されます。 List コントロール型を実装するコントロールの例として、リスト コンテナー コントロールなどがあります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、リスト コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの 2 つのビューを示し、それぞれのビューに含めることができる内容について説明します。 コントロール ビューでは、コントロールである要素のみが表示されます。また、コンテンツ ビューでは、冗長な情報がツリーから除外されます。 たとえば、コンボ ボックスのラベルに使用されるテキスト コントロールは、`ComboBox NameProperty` として公開されます。 このテキスト コントロールは、このようにコントロール ビューを介して既に公開されているため、2 回公開する必要はありません。したがって、コンテンツ ビューからは除外されます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|コントロールに対応する要素が含まれています。|支援技術がエンド ユーザーにとって意味のある最小限の情報を使用できるように、ツリーから冗長な情報を除外します。|  
+|リスト<br /><br /> -   DataItem \(0 以上\)<br />-   ListItem \(0 以上\)<br />-   Group \(0 以上\)<br />-   ScrollBar \(0、1、または 2\)|リスト<br /><br /> -   DataItem \(0 以上\)<br />-   ListItem \(0 以上\)<br />-   Group \(0 以上\)|  
+  
+ List コントロール型 \(リスト コントロールなど\) を実装するコントロールのコントロール ビューは以下で構成されます。  
+  
+-   リスト コントロール内の 0 個以上の項目 \(項目は List Item または Data Item のコントロール型に基づきます\)  
+  
+-   リスト コントロール内の 0 個以上のグループ コントロール  
+  
+-   0、1、または 2 個のスクロール バー コントロール。  
+  
+-  
+  
+ List コントロール型 \(リスト コントロールなど\) を実装するコントロールのコンテンツ ビューは以下で構成されます。  
+  
+-   リスト コントロール内の 0 個以上の項目 \(項目は List Item または Data Item のコントロール型に基づきます\)  
+  
+-   リスト コントロール内の 0 個以上のグループ  
+  
+ リスト コントロールには、一緒にグループ化されていない階層リレーションシップを持つ項目を含めることはできません。 項目が [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内に子を持つ場合、リスト コンテナーは Tree コントロール型に基づく必要があります。  
+  
+ リスト コントロール内の選択可能項目は、リスト コントロールの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの子孫から取得できます。 リスト コントロール内のすべての項目は、同じ選択グループに属している必要があります。 リスト内の選択可能項目は ListItem \(DataItem ではなく\) コントロール型として公開する必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、リスト コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|リスト コントロールにクリック可能なポイント \(クリックするとリストがフォーカスを受け取るポイント\) がある場合、このプロパティでそのポイントを公開する必要があります。<br /><br /> `IsOffScreen` プロパティの値が true の場合、<xref:System.Windows.Automation.NoClickablePointException> が生成されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|リスト コントロールの Name プロパティ値は、ユーザーに選択を求めるオプションのカテゴリを表すものでなければなりません。 このプロパティの名前は、通常、静的なテキスト ラベルから取得されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が Name プロパティの値を公開する必要があります。<br /><br /> リスト コントロールでこのプロパティが不要になるのは、別のコントロールのサブツリー内でコントロールが使用される場合のみです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|リスト|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"リスト"|List コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|True|コンテナーがキーボード入力を受け取ることができる場合、このプロパティ値は true である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」を参照してください。|リスト コントロールのヘルプ テキストは、オプションのリストから選択することをユーザーに求める理由を説明するものでなければなりません。 たとえば、「項目を選択してモニターのディスプレイ解像度を設定してください」などです。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、リスト コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|必要|List コントロール型をサポートするすべてのコントロールは、コントロールに含まれている項目の間で選択状態が維持される場合に、`ISelectionProvider` を実装する必要があります。 コンテナー内の項目が選択可能でない場合は、Group コントロール型を使用する必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|状況に依存|リスト コントロールでは、常に項目を選択する必要があるわけではありません。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|状況に依存|リスト コントロールでは、コンテナーを 1 つまたは複数選択できます。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|コンテナー内の項目がスクロール可能な場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IGridProvider>|状況に依存|グリッド ナビゲーションを項目ごとに使用可能にする必要がある場合は、このパターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IMultipleViewProvider>|状況に依存|コントロールがコンテナー内の項目の複数のビューをサポートできる場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.ITableProvider>|Never|`ITableProvider` は List コントロール型をサポートしません。 コントロールがこのコントロール パターンをサポートする必要がある場合、コントロールは Data Grid コントロール型に基づく必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのリスト コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LayoutInvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.MultipleViewPatternIdentifiers.CurrentViewProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.List>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md
new file mode 100644
index 00000000000..34904a1ad49
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-listitem-control-type.md
@@ -0,0 +1,101 @@
+---
+title: "UI Automation Support for the ListItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, List"
+  - "List Item control type"
+  - "UI Automation, List Item control type"
+ms.assetid: 34f533bf-fc14-4e78-8fee-fb7107345fab
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# UI Automation Support for the ListItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、<xref:System.Windows.Automation.ControlType.ListItem> コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ListItem コントロール型を実装するコントロールの例として、リスト項目コントロールなどがあります。  
+  
+ 以下の各セクションで、ListItem コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の各要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのリスト コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、リスト項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ListItem<br /><br /> -   イメージ \(0 個以上\)<br />-   テキスト \(0 個以上\)<br />-   Edit \(0 以上\)|ListItem|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビュー内のリスト項目コントロールの子は、常に "0" である必要があります。 リスト項目の下に他の項目が含まれるような構造を持つコントロールは、[UI Automation Support for the TreeItem Control Type](../../../docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md) コントロール型の要件に従う必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、リスト項目コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|このプロパティのこの値には、リスト項目のイメージおよびテキスト コンテンツの領域を含める必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|状況に依存|リスト コントロールにクリック可能なポイント \(クリックするとリストがフォーカスを受け取るポイント\) がある場合、このプロパティでそのポイントを公開する必要があります。 リスト コントロールが子孫のリスト項目に完全に覆われている場合は、クリック可能なポイントがないかリスト コントロール内の項目を調べる必要があることをクライアントに示すために、<xref:System.Windows.Automation.NoClickablePointException> を生成します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|リスト項目コントロールの名前プロパティの値は、その項目のテキスト コンテンツから取得されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ListItem|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"リスト項目"|ListItem コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|True|コンテナーがキーボード入力を受け取ることができる場合、このプロパティ値は true である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|""|リスト コントロールのヘルプ テキストは、オプションのリストから選択することをユーザーに求める理由を説明するものでなければなりません。一般には、ツールヒントに表示する情報と同様の内容になります。 たとえば、「項目を選択してモニターのディスプレイ解像度を設定してください」などです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemTypeProperty>|状況に依存|このプロパティは、基になるオブジェクトを表しているリスト項目コントロールに対して公開される必要があります。 そのようなリスト項目コントロールには、通常、ユーザーが基になるオブジェクトと関連付けたコントロールに関連付けられたアイコンがあります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty>|状況に依存|このプロパティは、そのリスト項目が現在、スクロール コントロール パターンを実装した親コンテナー内でスクロールして表示されているかどうかを示す値を返す必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、リスト項目コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|はい|リスト項目コントロールには、このコントロール パターンを実装する必要があります。 これにより、リスト項目コントロールは、選択されたことを伝達できます。|  
+|<xref:System.Windows.Automation.Provider.IScrollItemProvider>|状況に依存|このリスト項目がスクロール可能なコンテナーに格納されている場合には、このコントロール パターンを実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|状況に依存|このリスト項目がチェック可能で、アクションによって選択状態の変更が実行されない場合には、このコントロール パターンを実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|状況に依存|この項目を操作して情報を表示または非表示にできる場合は、このコントロール パターンを実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|この項目が編集可能である場合は、このコントロール パターンを実装する必要があります。 このリスト項目コントロールを変更すると、<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> および <xref:System.Windows.Automation.Provider.IValueProvider.Value%2A> の値が変更されます。|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider>|状況に依存|リスト コンテナー内で項目間の空間的移動がサポートされており、コンテナーが行と列に配置されている場合は、グリッド項目コントロール パターンを実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|状況に依存|この項目に、この項目自体に対して実行できる選択以外のコマンドがある場合には、このパターンを実装する必要があります。 これは通常、リスト項目コントロールのダブルクリックに関連付けられたアクションです。 この例としては、[!INCLUDE[TLA#tla_winexpl](../../../includes/tlasharptla-winexpl-md.md)] からのドキュメントの起動や、[!INCLUDE[TLA#tla_wmp](../../../includes/tlasharptla-wmp-md.md)] での音楽ファイルの再生などがあります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのリスト項目コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemStatusProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ListItem>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-menu-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-menu-control-type.md
new file mode 100644
index 00000000000..0b0dff1dde3
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-menu-control-type.md
@@ -0,0 +1,79 @@
+---
+title: "UI Automation Support for the Menu Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Menu"
+  - "UI Automation, Menu control type"
+  - "Menu control type"
+ms.assetid: 016323cb-f800-4938-b77b-2eb25d646090
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# UI Automation Support for the Menu Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Menu コントロール型の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] サポートについて説明します。 このコントロールの [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] ツリー構造を説明し、特定のコントロール シナリオでのプロパティとコントロール パターンを示します。  
+  
+ メニュー コントロールを使用すると、コマンドおよびイベント ハンドラーに関連付けられている要素を階層に編成できます。 一般的な [!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] アプリケーションでは、メニュー バーに複数のメニュー ボタン \(**\[ファイル\]**、**\[編集\]**、**\[ウィンドウ\]** など\) が含まれ、各メニュー ボタンがメニューを表示します。 メニューには、メニュー項目 \(**\[新規\]**、**\[開く\]**、**\[閉じる\]** など\) のコレクションが含まれていて、メニュー項目を展開して追加のメニュー項目を表示したり、クリックして特定の操作を実行したりできます。  
+  
+ 以降のセクションで、Menu コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、メニュー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|メニュー<br /><br /> -   MenuItem \(1 個以上\)|該当なし \(メニュー コントロールが、メニュー項目でないオブジェクトの親であるコンテキスト メニューに相当する場合を除く\)<br /><br /> -   MenuItem \(1 個以上\)|  
+  
+ メニュー コントロールは、コントロール ビューと [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに常に表示されます。 Menu コントロール型は、その情報が参照しているコントロールの下に表示されます。 UI オートメーション クライアントは、メニュー コントロールによって伝えられる情報を常に取得できるよう、`MenuOpenedEvent` をリッスンする必要があります。 コンテキスト メニュー コントロールは、特殊なケースです。 これらのコントロールは、デスクトップの子として表示されます。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Menu コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|サポート非対象|メニュー コントロールでは、Name プロパティを設定する必要はありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|一般的なメニュー コントロールには、ラベルは不要です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|メニュー|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|メニュー コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|メニュー コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに常に組み込まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ Menu コントロール型に必要なコントロール パターンはありません。  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ メニュー コントロールは、画面に表示された場合に `MenuOpenedEvent` を生成する必要があります。`MenuOpenedEvent` にはコントロールのテキストが含まれます。 メニューが画面から非表示になった場合には、`MenuClosedEvent` が生成されなければなりません。  
+  
+ 次の表に、すべてのメニュー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.MenuOpenedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.MenuClosedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty>プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Menu>   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-menubar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-menubar-control-type.md
new file mode 100644
index 00000000000..04d7f89038c
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-menubar-control-type.md
@@ -0,0 +1,89 @@
+---
+title: "UI Automation Support for the MenuBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Menu Bar control type"
+  - "control types, Menu Bar"
+  - "Menu Bar control type"
+ms.assetid: c1202b21-c1f0-4560-853c-7b99bd73ad97
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the MenuBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、<xref:System.Windows.Automation.ControlType.MenuBar> コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ MenuBar コントロール型を実装するコントロールの例には、メニュー バー コントロールがあります。 メニュー バーは、ユーザーがアプリケーションに含まれるコマンドおよびオプションをアクティブにするための手段を提供します。  
+  
+ 以降のセクションで、MenuBar コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、コントロール ビューと、メニュー バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|メニュー バー<br /><br /> -   MenuItem \(1 個以上\)<br />-   その他のコントロール \(0 個以上\)|メニュー バー<br /><br /> -   MenuItem \(1 個以上\)<br />-   その他のコントロール \(0 個以上\)|  
+  
+ メニュー バー コントロールの構造には、エディット コントロールやコンボ ボックスなどの他のコントロールを含めることができます。 これらの追加コントロールは、コントロール ビューおよびコンテンツ ビューに含まれる、上記に一覧した「その他のコントロール」に対応します。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、メニュー バー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|このプロパティで公開する値には、メニュー バー コントロールに含まれるすべてのコントロールを含める必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|アプリケーションに複数のメニュー バーがある場合を除き、メニュー バー コントロールに名前は必要ありません。 アプリケーションに複数のメニュー バーがある場合、このプロパティを使用して、「書式設定」や「アウトライン」といった識別名を公開する必要があります|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|メニュー バー コントロールには例外なく、ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|メニュー バー|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「メニュー バー」|MenuBar コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|メニュー バー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|メニュー バー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty>|「ノート」を参照。|このプロパティの値は、コントロールを画面に表示できるかどうかによって異なります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.OrientationProperty>|状況に依存|このプロパティは、メニュー バー コントロールが水平または垂直のいずれかであるかを公開します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|True|メニュー バー コントロールに含まれるコントロールはキーボード フォーカスを受け取ることができるため、メニュー バー コントロールはキーボード フォーカスを受け取ることができます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」を参照。|メニュー バー コントロールにヘルプ テキストが必要になるシナリオはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty>|`Null`|メニュー バーでアクセラレータ キーを使用することは決してありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AccessKeyProperty>|「ALT」|ALT キーを押すと常に、アプリケーション内のメニュー バーにフォーカスが移動します。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、メニュー バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|状況に依存|コントロールを展開または折りたたむことができる場合は、<xref:System.Windows.Automation.Provider.IExpandCollapseProvider> を実装します。|  
+|<xref:System.Windows.Automation.Provider.IDockProvider>|状況に依存|コントロールを画面のさまざまな部分にドッキングできる場合は、<xref:System.Windows.Automation.Provider.IDockProvider> を実装します。|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|状況に依存|コントロールのサイズ変更、回転、移動が可能な場合は、<xref:System.Windows.Automation.Provider.ITransformProvider> を実装する必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのメニュー バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.MenuBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-menuitem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-menuitem-control-type.md
new file mode 100644
index 00000000000..081be9252a2
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-menuitem-control-type.md
@@ -0,0 +1,110 @@
+---
+title: "UI Automation Support for the MenuItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Menu Item"
+  - "Menu Item control type"
+  - "UI Automation, Menu Item control type"
+ms.assetid: 54bce311-3d23-40b9-ba90-1bdbdaf8fbba
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# UI Automation Support for the MenuItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、MenuItem コントロール型の [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] サポートについて説明します。 ここではコントロールの [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] ツリー構造について説明し、MenuItem コントロール型に必要なプロパティとコントロール パターンを示します。  
+  
+ メニュー コントロールを使用すると、コマンドおよびイベント ハンドラーに関連付けられている要素を階層的に編成できます。 一般的な [!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] アプリケーションでは、メニュー バーに複数のメニュー項目 \(**\[ファイル\]**、**\[編集\]**、**\[ウィンドウ\]** など\) が含まれ、各メニュー項目にメニューが表示されます。 メニューには、メニュー項目 \(**\[新規\]**、**\[開く\]**、**\[閉じる\]** など\) のコレクションが含まれていて、クリックされると展開して追加のメニュー項目を表示したり、特定の操作を実行したりできます。 メニュー項目は、メニュー、メニュー バー、またはツール バーに配置できます。  
+  
+ 以下のセクションでは、MenuItem コントロール型で必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、イベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、メニュー項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|MenuItem "Help"<br /><br /> <ul><li>Menu \(Help メニュー項目のサブ メニュー\)<br /><br /> <ul><li>MenuItem "Help Topics"</li><li>MenuItem "About Notepad"</li></ul></li></ul>|MenuItem "Help"<br /><br /> -   MenuItem "Help Topics"<br />-   MenuItem "About Notepad"|  
+  
+ メニュー項目コントロールのコントロール ビューには、上記の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造があります。 メニューからサブメニューへの階層の典型的な構造をより良く表現するために、**\[ヘルプ\]** メニュー項目が含まれていることにご注意ください。  
+  
+ コンテンツ ビューでは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーにメニューがありません。これは、メニューでは有用な情報がエンド ユーザーに提供されないためです。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、メニュー項目コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|プロパティ|値|説明|  
+|-----------|-------|--------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|メニュー項目コントロールは [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれていて、名前が自動的にラベル付けされます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|ラベルなし。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|MenuItem|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"メニュー項目"|MenuItem コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|メニュー項目コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューには含まれません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|メニュー項目コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに常に含まれている必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、メニュー項目コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンの一覧を示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン プロパティ|Support|ノート|  
+|-----------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|状況に依存|コントロールを展開または折りたたむことができる場合は、<xref:System.Windows.Automation.Provider.IExpandCollapseProvider> を実装します。|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|状況に依存|コントロールが単一のアクションまたはコマンドを実行する場合は、<xref:System.Windows.Automation.Provider.IInvokeProvider> を実装します。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|状況に依存|コントロールがオンまたはオフを切り替えられるオプションを表す場合は、<xref:System.Windows.Automation.Provider.IToggleProvider> を実装します。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|状況に依存|コントロールを使用してメニュー項目のオプションのリストから選ぶ場合は、<xref:System.Windows.Automation.Provider.ISelectionItemProvider> を実装します。|  
+  
+<a name="UI_Automation_Events_for_Menu_Item"></a>   
+## メニュー項目の UI オートメーション イベント  
+ 次の表に、メニュー項目コントロールに関連付けられている [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] イベントの一覧を示します。  
+  
+|イベント|Support|説明|  
+|----------|-------------|--------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|コントロールが呼び出しコントロール パターンをサポートしている場合に、発生させる必要があります。|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|コントロールがトグル コントロール パターンをサポートしている場合に、発生させる必要があります。|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|コントロールが展開\/折りたたみコントロール パターンをサポートしている場合に、発生させる必要があります。|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|状況に依存|なし。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのメニュー項目コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントの一覧を示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+<a name="Legacy_Issues"></a>   
+## 既知の問題  
+ トグル パターンがサポートされるのは、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] メニュー項目がチェックされ、トグル パターンをサポートすることが必要であるとプログラムで判断できる場合のみです。[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] メニュー項目はチェックできるかどうかを公開しないため、メニュー項目がチェックされていない場合は呼び出しパターンがサポートされます。 トグル パターンのみをサポートするべきメニュー項目に対して常に呼び出しパターンをサポートするには、例外が作成されます。 このようにすると、\(メニュー項目がクリアされていたときに\) 呼び出しパターンをサポートしていた要素が、チェックされたときにそのパターンをサポートしなくなっても、クライアントは混乱しません。  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.MenuItem>   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-pane-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-pane-control-type.md
new file mode 100644
index 00000000000..62f10761afc
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-pane-control-type.md
@@ -0,0 +1,106 @@
+---
+title: "UI Automation Support for the Pane Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Pane control type"
+  - "Pane control type"
+  - "control types, Pane"
+ms.assetid: 79761191-4449-4630-899c-9cbdb8867d3f
+caps.latest.revision: 25
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 25
+---
+# UI Automation Support for the Pane Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Pane コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ Pane コントロール型は、フレームまたはドキュメント ウィンドウ内のオブジェクトを表すために使用します。 ユーザーはペイン コントロール間や現在のペインの内容の中を移動することができますが、異なるペインの項目間を移動することはできません。 そのため、ペイン コントロールは、ウィンドウやドキュメントより下で、個々のコントロールより上のグループ化のレベルを表します。 ユーザーは、状況に応じて、TAB、F6、または CTRL \+ TAB キーを押すことによって、ペイン間を移動します。 Pane コントロール型には、特定のキーボード ナビゲーションは必要ありません。  
+  
+ 以降のセクションでは、Pane コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ペイン コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ペイン|ペイン|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ペイン コントロールに特に関連する値や定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|このプロパティの値は、必ず明確で簡潔でわかりやすいタイトルにする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|このプロパティは、クリックされた場合にペインにフォーカスが移動する、ペイン コントロールのクリック可能なポイントを公開します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照。|通常、ペイン コントロールに静的ラベルはありません。 静的なテキスト ラベルが存在する場合は、このプロパティを介して公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|Pane|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"pane"|Pane コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ペイン コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ペイン コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|""|ペイン コントロールのヘルプ テキストで、各フレームの用途とフレーム間の関係を説明する必要があります。 フレームの目的や関係が `NameProperty` の値からわからない場合は、説明が必要です。 "|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AccessKeyProperty>|「ノート」を参照。|特定のキーの組み合わせによってペインにフォーカスが移動する場合は、このプロパティを介してその情報を公開する必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのペイン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|状況に依存|画面上でのペイン コントロールの移動、サイズ変更、または回転が可能な場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider>|Never|このコントロール パターンを実装する必要がある場合は、コントロールが <xref:System.Windows.Automation.ControlType.Window> コントロール型に基づいている必要があります。|  
+|<xref:System.Windows.Automation.Provider.IDockProvider>|状況に依存|ペイン コントロールがドッキング可能な場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|ペイン コントロールがスクロール可能な場合は、このコントロール パターンを実装します。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのペイン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowClosedEvent>|Never|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowOpenedEvent>|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AsyncContentLoadedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowVisualStateProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+<a name="Pane_Control_Type_Example"></a>   
+## Pane コントロール型の例  
+ 次の図に、Pane コントロール型を実装するコントロールを示します。  
+  
+ ![2 つのペインを含むアプレット ウィンドウのスクリーンショット](../../../docs/framework/ui-automation/media/uiauto-pane.png "uiauto\_pane")  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|<ul><li>ペイン</li><li>ツリー \(スクロール パターン\)<br /><br /> <ul><li>TreeItem</li><li>ペイン</li><li>編集 \(スクロール パターン\)</li></ul></li></ul>|-   ペイン<br />-   ツリー \(スクロール パターン\)<br />-   TreeItem<br />-   …Pane<br />-   編集<br />-   \(スクロール パターン\)|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Pane>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-progressbar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-progressbar-control-type.md
new file mode 100644
index 00000000000..4f0039e5051
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-progressbar-control-type.md
@@ -0,0 +1,92 @@
+---
+title: "UI Automation Support for the ProgressBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Progress Bar"
+  - "ProgressBar control type"
+  - "UI Automation, Progress Bar control type"
+ms.assetid: 302e778c-24b0-4789-814a-c8d37cf53a5f
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the ProgressBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、ProgressBar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターン、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントに関する特定のガイドラインが含まれます。  
+  
+ ProgressBar コントロール型を実装するコントロールの例として、進行状況バー コントロールなどがあります。 進行状況バー コントロールは、時間のかかる処理の進行状況を示すために使用します。 このコントロールは、処理の進行状況に合わせてシステムの強調表示色で塗りつぶされていく四角形で構成されます。  
+  
+ 以下の各セクションで、ProgressBar コントロール型の必須の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の各要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのリスト コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、進行状況バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ProgressBar|ProgressBar|  
+  
+ 進行状況バー コントロールは、コントロール ビューまたはコンテンツ ビューの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内に子を持つことはありません。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、進行状況バー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|進行状況バー コントロールの名前は、通常、静的なテキスト ラベルから取得されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が `Name` のプロパティ値を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ProgressBar|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"進行状況バー"|ProgressBar コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|進行状況バー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|進行状況バー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns_and_Properties"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、進行状況バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|進行状況をテキストで示す進行状況バー コントロールは、<xref:System.Windows.Automation.Provider.IValueProvider> を実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider.IsReadOnly%2A>|True|このプロパティの値は常に True です。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider.Value%2A>|「ノート」を参照してください。|このプロパティは、進行状況バー コントロールのテキストによる進行状況を公開します。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|数値の範囲を取る進行状況バー コントロールは、<xref:System.Windows.Automation.Provider.IRangeValueProvider> を実装する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.Minimum%2A>|0.0|このプロパティの値は、コントロールに対して設定できる最小の値です。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.Maximum%2A>|100.0|このプロパティの値は、コントロールに対して設定できる最大の値です。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.SmallChange%2A>|NaN|進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider.LargeChange%2A>|NaN|進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべての進行状況バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ProgressBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-radiobutton-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-radiobutton-control-type.md
new file mode 100644
index 00000000000..66f58d759cb
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-radiobutton-control-type.md
@@ -0,0 +1,88 @@
+---
+title: "UI Automation Support for the RadioButton Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Radio Button"
+  - "UI Automation, Radio Button control type"
+  - "RadioButton control type"
+ms.assetid: 87170464-7857-41f1-bcf7-bb41be31cb53
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the RadioButton Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、RadioButton コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ オプション ボタンは、丸形のボタンとアプリケーションで定義されたテキスト \(ラベル\)、アイコン、またはユーザーがボタンを選択することで選択できる選択肢を示すビットマップで構成されます。 多くのアプリケーションでは、関連しているものの相互に排他的なオプションのセットからユーザーが選択できるようにするグループ ボックス内でオプション ボタンが使用されます。 たとえば、ユーザーがクライアント領域で選択したテキストの書式設定を選択できるオプション ボタンのグループをアプリケーションで表示することができます。 ユーザーは、対応するオプション ボタンを選択することによって、左揃え、右揃え、または中央揃えの形式を選択できます。 通常、ユーザーは、オプション ボタンのセットから、一度に 1 つのオプションしか選択することができません。  
+  
+ 以降のセクションでは、RadioButton コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、オプション ボタン コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|RadioButton|RadioButton|  
+  
+ コントロール ビューまたはコンテンツ ビューに子は存在しません。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、RadioButton コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを列挙します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|オプション ボタン コントロールの名前は、選択状態を保持するボタンの横に表示されたテキストです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|オプション ボタン コントロールのクリック可能なポイントは、マウス ポインターでクリックされた場合にオプション ボタン上に選択が設定されるポイントにする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|オプション ボタンはそれ自体がラベルであるコントロールです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|RadioButton|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"オプション ボタン"|RadioButton コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|オプション ボタン コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|オプション ボタン コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに組み込まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのオプション ボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを列挙します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/コントロール パターン プロパティ|サポート\/値|ノート|  
+|------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|はい|すべてのオプション ボタン コントロールが、それ自体を選択可能にする選択項目パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider.SelectionContainer%2A>|ノートを参照してください。|UI オートメーション クライアントが特定のコンテキスト内で相互に関連する他のオプション ボタンを特定できるためには、`SelectionContainerProperty` が設定されている必要があります。  オプション ボタンの [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] バージョンでは、このプロパティがサポートされません。これは、従来のフレームワークからこの情報を取得できないためです。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|Never|オプション ボタンは、いったん設定されると、その状態を循環させることができません。  このパターンは、オプション ボタンではサポートしないでください。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのオプション ボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを列挙します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.RadioButton>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-scrollbar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-scrollbar-control-type.md
new file mode 100644
index 00000000000..3ada7aedb90
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-scrollbar-control-type.md
@@ -0,0 +1,94 @@
+---
+title: "UI Automation Support for the ScrollBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Scroll Bar control type"
+  - "control types, Scroll Bar"
+  - "Scroll Bar control type"
+ms.assetid: 329891d7-b609-49e6-920a-09ea8a627d07
+caps.latest.revision: 24
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 24
+---
+# UI Automation Support for the ScrollBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、ScrollBar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ スクロール バー コントロールを使用すると、ユーザーは、ウィンドウまたは項目のコンテナー内のコンテンツをスクロールできます。 このコントロールは、ボタンのセットと Thumb コントロールから構成されます。  
+  
+ 以下の各セクションで、ScrollBar コントロール型の必須の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の各要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのリスト コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、スクロール バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ScrollBar<br /><br /> -   Button \(2 または 4\)<br />-   Thumb \(0 または 1\)|該当なし。 スクロール バー コントロールは、コンテンツを含みません。|  
+  
+ スクロール バー コントロールは、常に 3 ～ 5 個の子を持っています。 サブツリーには複数のボタン コントロールが存在するため、各項目に特定の <xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty> 値を設定して、それらの項目が自動テスト ツールで検出されるようにする必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、スクロール バー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。 スクロール バー コントロールはコンテンツを持たないことに注意してください。このコントロールの機能は、スクロールされるコンテナーでサポートされる Scroll コントロール パターンによって公開されます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|`Null`|スクロール バー コントロールはコンテンツ要素を持たないため、`NameProperty` を設定する必要はありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|数値でない値。|スクロール バー コントロールには、クリック可能なポイントはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|スクロール バーには、ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ScrollBar|この値は、すべてのフレームワークで同じです。 スライダーとして機能するスクロール バーには、Slider コントロール型を使用する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"スクロール バー"|Button コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|スクロール バー コントロールは、コンテンツ要素ではありません。 スクロール バーがスタンドアロンのコントロールである場合、そのスクロール バーは、Slider コントロール型の機能を満たし、`ControlType` プロパティの `ControlType.Slider` を返す必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|スクロール バーは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.OrientationProperty>|True|スクロール バー コントロールは、水平方向または垂直方向の向きを常に公開する必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、スクロール バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。 スクロール バーをマウス操作専用のコントロールとして使用する場合、スクロール バーはコントロール パターンをサポートしないことに注意してください。 スクロール バーをアプリケーション内のスライダー コントロールとして使用する場合は、Slider コントロール型にする必要があります。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|Never|Scroll コントロール パターンは、スクロール バーで直接的にはサポートされていません。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|この機能は、スクロール バーのあるコンテナーで Scroll コントロール パターンがサポートされない場合に限ってサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのスクロール バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|サポート\/値|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.RangeValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ScrollBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-separator-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-separator-control-type.md
new file mode 100644
index 00000000000..c34df154659
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-separator-control-type.md
@@ -0,0 +1,77 @@
+---
+title: "UI Automation Support for the Separator Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Separator control type"
+  - "Separator control type"
+  - "control types, Separator"
+ms.assetid: 89f42247-c699-4afa-91e1-2baaf0d86c9d
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the Separator Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Separator コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ 区切り記号コントロールは、視覚的にスペースを 2 つの領域に分割するために使用します。 たとえば、区切り記号コントロールは、ウィンドウ内の 2 つのペインを定義するバーにすることができます。 区切り記号が移動可能な場合は、コントロールをコントロールの種類のサムネイルとして公開する必要があります。  
+  
+ 以降のセクションでは、Separator コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのリスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、区切り記号コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|区切り記号|-   区切り記号コントロールにはコンテンツがありません。|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、区切り記号コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを列挙します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|""|区切り記号コントロールには NameProperty が必要ありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`null`|区切り記号コントロールには静的ラベルがありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|区切り記号|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"区切り記号"|Separator コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|区切り記号コントロールはコンテンツではありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|区切り記号コントロールは常にコントロールにする必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ コントロール パターンをサポートするために、区切り記号コントロールは必要ありません。  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべての区切り記号コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを列挙します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Separator>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-slider-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-slider-control-type.md
new file mode 100644
index 00000000000..21a39fdf80c
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-slider-control-type.md
@@ -0,0 +1,87 @@
+---
+title: "UI Automation Support for the Slider Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Slider"
+  - "UI Automation, Slider control type"
+  - "Slider control type"
+ms.assetid: 045ea62f-7b50-46cf-a5a9-8eb97704355f
+caps.latest.revision: 18
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 18
+---
+# UI Automation Support for the Slider Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、スライダー コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロールの種類に関する特定のガイドラインが含まれます。  
+  
+ スライダー コントロールは、ボタンを使用した複合コントロールであり、ユーザーはこれらのボタンを使用して、マウスで数値の範囲を設定したり、項目のセットから選択したりできます。  
+  
+ 以降のセクションで、スライダー コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかに関わらず、すべてのスライダー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、コントロール ビューと、スライダー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|スライダー<br /><br /> -   ボタン \(2 個または 4 個\)<br />-   つまみ \(1 個のみ\)<br />-   リスト項目 \(0 個以上\)|スライダー<br /><br /> -   リスト項目 \(0 個以上\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、スライダー コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|スライダー コントロールの四角形領域全体が子コントロールで占有されるため、スライダー コントロールの大多数は、<xref:System.Windows.Automation.NoClickablePointException> を生成する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|編集コントロールの名前は、通常、静的なテキスト ラベルから生成されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が `Name` のプロパティ値を割り当てる必要があります。`Name` プロパティに、編集コントロールのテキストの内容が格納されることは決してありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照。|コントロールに静的なテキスト ラベルが関連付けられている場合、このプロパティがそのコントロールの参照を公開する必要があります。 テキスト コントロールが別のコントロールのサブコンポーネントの場合、`LabeledBy` プロパティは設定されません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|スライダー|この値は、すべての [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「スライダー」|編集コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|編集コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに常に組み込まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|編集コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに常に組み込まれます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、すべてのスライダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|状況に依存|コンテンツが個別のオプション セットのうちの 1 つの値を表す場合、スライダーは Selection コントロール パターンをサポートする必要があります。 Selection コントロール パターンがサポートされている場合、対応する選択を、スライダーの 1 つまたは複数の子リスト項目として公開する必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|コンテンツを数値の範囲内の値に設定できる場合、スライダーは RangeValue コントロール パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|コンテンツが個別のオプション セットのうちの 1 つの値を表す場合、スライダーは Value コントロール パターンをサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのスライダー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。  
+  
+ イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント|必須|なし|  
+|<xref:System.Windows.Automation.RangeValuePatternIdentifiers.ValueProperty> プロパティ変更イベント|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Slider>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-spinner-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-spinner-control-type.md
new file mode 100644
index 00000000000..c5d6ddb5e64
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-spinner-control-type.md
@@ -0,0 +1,97 @@
+---
+title: "UI Automation Support for the Spinner Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Spinner control type"
+  - "Spinner control type"
+  - "control types, Spinner"
+ms.assetid: 3a29d185-65d8-42e3-bcc3-7f43e96f40c5
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the Spinner Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Spinner コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ スピン ボタン コントロールは、ある範囲の項目や数字から選択するために使用します。  
+  
+ 以降のセクションでは、Spinner コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのスピン ボタン コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、Range Value、Value、および Selection の各コントロール パターンをサポートするスピン ボタン コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+ **Range Value コントロール パターンまたは Value コントロール パターン**  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|Spinner<br /><br /> -   Edit \(0 または 1\)<br />-   Button \(2\)|Spinner|  
+  
+ **Selection コントロール パターン**  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|Spinner<br /><br /> -   Edit \(0 または 1\)<br />-   Button \(2\)<br />-   List Item \(0 以上\)|Spinner<br /><br /> -   ListItem \(0 以上\)|  
+  
+ コントロール ビュー サブツリーの 2 つのボタンを自動テスト ツールが区別できるようにするには、必要に応じて `SmallIncrement` または `SmallDecrement` `AutomationId` を割り当てます。 実装によっては、関連付けられたエディット コントロールが Spinner コントロールのピアである場合があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、スピン ボタン コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意にする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|スピン ボタン コントロールのクリック可能なポイントは、コントロールの編集部分にフォーカスを設定します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|スピン ボタン コントロールは、通常、静的テキスト ラベルからその名前を取得します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|ノートを参照してください。|スピン ボタン コントロールには静的なテキスト ラベルがあります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|Spinner|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"スピン ボタン"|Spinner コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|スピン ボタン コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|Spinner コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns_and_Properties"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、スピン ボタン コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|状況に依存|選択する項目のリストを持つスピン ボタン コントロールは、このパターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|False|スピン ボタン コントロールは、常に単一選択コンテナーです。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|数値の範囲を対象にするスピン ボタン コントロールは、このパターンをサポートできます。|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|状況に依存|個別のオプション セットまたは数値のセットを対象にするスピン ボタン コントロールは、このパターンをサポートできます。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのスピン ボタン コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.RangeValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Spinner>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-splitbutton-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-splitbutton-control-type.md
new file mode 100644
index 00000000000..4f77f67aaad
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-splitbutton-control-type.md
@@ -0,0 +1,97 @@
+---
+title: "UI Automation Support for the SplitButton Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Split Button control type"
+  - "control types, Split Button"
+  - "UI Automation, Split Button control type"
+ms.assetid: 14b05ccf-bcd8-4045-9bae-f7679cd98711
+caps.latest.revision: 23
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 23
+---
+# UI Automation Support for the SplitButton Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、SplitButton コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ 分割ボタン コントロールは、コントロールの操作を実行する機能、コントロールを展開して実行可能なその他の操作を一覧表示する機能を有効にします。  
+  
+ 以下の各セクションで、SplitButton コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべての分割ボタン コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、分割ボタン コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|SplitButton<br /><br /> <ul><li>Image \(0 または 1\)</li><li>Text \(0 または 1\)</li><li>Button \(1 または 2\)<br /><br /> <ul><li>Menu \(0 または 1。ExpandCollapse パターンをサポートするボタンの子として表示されます\)</li><li>MenuItem \(1 個以上\)</li></ul></li></ul>|SplitButton<br /><br /> -   MenuItem \(1 個以上\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、分割ボタン コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|"Back"|分割ボタン コントロールの名前は、ボタンに表示されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|Null|分割ボタン コントロールに静的なテキスト ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|SplitButton|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"split button"|SplitButton コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」を参照。|ヘルプ テキストで、分割ボタンをアクティブ化した場合の結果を示すことができます。これは一般に、ツールヒントに表示する情報と同じような情報です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|分割ボタン コントロールには、エンド ユーザーに対する情報が含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|分割ボタン コントロールは、エンド ユーザーに表示されます。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、分割ボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|必要|分割ボタンには、必ず呼び出しに関連付けられている既定の操作があります。|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|必要|分割ボタンには、必ずオプションの一覧を展開できる機能があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべての分割ボタン コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+<a name="Split_Button_Control_Example"></a>   
+## SplitButton コントロールの例  
+ 次の図は、データ グリッド コントロールの SplitButton コントロール型を示しています。  
+  
+ ![分割ボタン](../../../docs/framework/ui-automation/media/uiauto-splitbutton-detailed.png "uiauto\_splitbutton\_detailed")  
+  
+ 以下に、データ グリッド コントロールと分割ボタン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示します。 オートメーションの各要素のコントロール パターンが、かっこ内に示されています。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コントロール ビュー|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー \- コンテンツ ビュー|  
+|---------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|  
+|<ul><li>SplitButton "Name" \(Invoke, ExpandCollapse\)</li><li>Button "More options" \(Invoke\)<br /><br /> <ul><li>メニュー</li><li>MenuItem</li><li>…</li></ul></li></ul>|<ul><li>SplitButton "Name" \(Invoke, ExpandCollapse\)</li><li>Button "More options" \(Invoke\)<br /><br /> <ul><li>メニュー</li><li>MenuItem</li><li>…</li></ul></li></ul>|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.SplitButton>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-statusbar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-statusbar-control-type.md
new file mode 100644
index 00000000000..bb06d602ec6
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-statusbar-control-type.md
@@ -0,0 +1,85 @@
+---
+title: "UI Automation Support for the StatusBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "StatusBar control type"
+  - "UI Automation, Status Bar control type"
+  - "control types, Status Bar"
+ms.assetid: 48dee94a-5119-4939-a4c7-ffeaf794c732
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the StatusBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、StatusBar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ステータス バー コントロールは、アプリケーションのウィンドウに表示されているオブジェクトの情報、そのオブジェクトのコンポーネント、またはそのオブジェクトのアプリケーション内での操作に関連するコンテキストについての情報を表示します。  
+  
+ 以降のセクションで、StatusBar コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、イベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのステータス バー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ステータス バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|StatusBar<br /><br /> -   Edit \(0 以上\)<br />-   ProgressBar \(0 以上\)<br />-   Image \(0 以上\)<br />-   Button \(0 以上\)|StatusBar<br /><br /> -   Edit \(0 以上\)<br />-   ProgressBar \(0 以上\)<br />-   Image \(0 以上\)<br />-   Button \(0 以上\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、進行状況バー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|ステータス バーの四角形領域は、ステータス バー コントロールに含まれるコントロールをすべて囲んでいる必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|アプリケーション内で複数のステータス バー コントロールが使用されている場合を除き、ステータス バー コントロールに名前は必要ありません。 複数のステータス バー コントロールが使用されている場合は、「インターネットの状態」や「アプリケーションの状態」などの名前で各バーを区別します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|通常、ステータス バー コントロールにラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|StatusBar|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「ステータス バー」|StatusBar コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ステータス バー コントロールには、常にコンテンツが含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ステータス バー コントロールは、常にコントロールです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty>|状況に依存|ステータス バー コントロールは、現在画面上に表示されていなければこのプロパティに True を返します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.OrientationProperty>|状況に依存|コントロールの向きを示す値 \(水平または垂直\)。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|False|利用不可|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty>|`Null`|ステータス バーにアクセラレータ キーはありません。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、ステータス バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridProvider>|省略可能|個々の項目を監視して簡単に情報を参照できるように、ステータス バー コントロールはグリッド コントロール パターンをサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのステータス バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.StatusBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-tab-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-tab-control-type.md
new file mode 100644
index 00000000000..5bcd900b812
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-tab-control-type.md
@@ -0,0 +1,98 @@
+---
+title: "UI Automation Support for the Tab Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TabControl type"
+  - "UI Automation, Tab control type"
+  - "control types, Tab"
+ms.assetid: f8be2732-836d-4e4d-85e2-73aa39479bf4
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the Tab Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Tab コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、および [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]. コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ タブ コントロールは、ノートの仕切ページまたはファイル キャビネットのラベルに似ています。 タブ コントロールを使用すると、アプリケーションでウィンドウまたはダイアログ ボックスの同じ領域に複数のページを定義できます。  
+  
+ 以降のセクションでは、Tab コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)]であるかどうかに関係なく、すべてのタブ コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、タブ コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|タブ<br /><br /> <ul><li>TabItem \(1 以上\)</li><li>ScrollBar \(0 または 1\)<br /><br /> <ul><li>Button \(0 または 2\)</li></ul></li></ul>|タブ<br /><br /> -   TabItem \(1 以上\)|  
+  
+ タブ コントロールには、Tab Item コントロール型に基づく子 [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]要素があります。 タブ項目がグループ化されている場合 \(たとえば、Microsoft Office 2007 アプリケーションでのように\)、Tab コントロール型では、次のツリー構造に示すように、グループ化されたタブ項目の Group コントロール型もホストできます。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|タブ<br /><br /> <ul><li>TabItem \(1 以上\)</li><li>Group \(0 以上\)<br /><br /> <ul><li>TabItem \(0 以上\)</li></ul></li><li>ScrollBar \(0 以上\)<br /><br /> <ul><li>Button \(0 または 2\)</li></ul></li></ul>|タブ<br /><br /> <ul><li>TabItem \(1 以上\)</li><li>Group \(0 以上\)<br /><br /> <ul><li>TabItem \(0 以上\)</li></ul></li></ul>|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Tab コントロール型に特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意にする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|タブ コントロールで、Name プロパティが必要になることはほとんどありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|いいえ|タブ コントロールには、クリックできるポイントはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|ノートを参照してください。|タブ コントロールには、通常、このプロパティで公開される静的なテキスト ラベルがあります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|タブ|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"タブ"|Tab コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|True|Tab コントロール型は、キーボード フォーカスを受け取ることができる必要があります。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クライアントは、通常タブ コントロールの SetFocus を呼び出し、その項目の 1 つが、キーボード フォーカスをタブ コントロールに送ります。 タブ コンテナーによっては、その項目の 1 つにフォーカスを設定することなく、フォーカスを受け取ることができます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|タブ コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|タブ コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.OrientationProperty>|ノートを参照してください。|タブ コントロールでは、そのタブが水平方向または垂直方向のどちらに配置されるのかを常に示す必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns_and_Properties"></a>   
+## 必須の UI オートメーション コントロール パターンおよびプロパティ  
+ 次の表に、すべてのタブ コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|はい|すべてのタブ コントロールが、Selection パターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|True|タブ コントロールで、常に選択が行われる必要があります。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|False|タブ コントロールは、常に単一選択コンテナーです。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|Scroll パターンは、一連のタブ項目全体をスクロールできるようにするウィジェットを持つタブ コントロールでサポートされる必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのタブ コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Tab>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-tabitem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-tabitem-control-type.md
new file mode 100644
index 00000000000..3e8a5e76b91
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-tabitem-control-type.md
@@ -0,0 +1,85 @@
+---
+title: "UI Automation Support for the TabItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Tab Item control type"
+  - "control types, Tab Item"
+  - "UI Automation, Tab Item control type"
+ms.assetid: 9b21160d-e1c2-468b-9275-26e4369ae40d
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the TabItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、TabItem コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートに関する情報を提供します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ タブ項目コントロールは、ウィンドウに表示される特定のページを選択するタブ コントロール内のコントロールとして使用されます。  
+  
+ 以降のセクションでは、TabItem コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのタブ項目コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表では、タブ項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|TabItem<br /><br /> <ul><li>イメージ \(0 または 1\)</li><li>テキスト</li><li>ペイン<br /><br /> <ul><li>各種コントロール \(0 以上\)</li></ul></li></ul>|TabItem<br /><br /> <ul><li>ペイン<br /><br /> <ul><li>各種コントロール \(0 以上\)</li></ul></li></ul>|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、タブ項目コンロトールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|タブ項目コントロールには、項目が選択された状態になるクリック可能なポイントが必要です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|ノートを参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|ノートを参照してください。|タブ項目コントロールは、それ自体がラベルです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|タブ項目コントロールには、静的テキスト ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|TabItem|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"タブ項目"|このコントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|タブ項目コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|タブ項目コントロールは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControllerForProperty>|ノートを参照してください。|このプロパティは、関連付けられたタブ ウィンドウへのポインターとして使用できます。 これは、タブ項目のオブジェクトの子として、ウィンドウをホストできない場合に便利です。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、タブ項目コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|はい|タブ項目コントロールは、SelectionItemPattern をサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|いいえ|タブ項目コントロールは、InvokePattern をサポートしません。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのタブ項目コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントの一覧を示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.TabItem>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-table-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-table-control-type.md
new file mode 100644
index 00000000000..6d2879e5594
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-table-control-type.md
@@ -0,0 +1,88 @@
+---
+title: "UI Automation Support for the Table Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TableControl type"
+  - "control types, Table"
+  - "UI Automation, Table control type"
+ms.assetid: 9050dde5-6469-4c83-abb7-f861c24ff985
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the Table Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Table コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートに関する情報を提供します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ テーブル コントロールは、テキストの行と列、およびオプションで行ヘッダーと列ヘッダーを格納します。  
+  
+ 以降のセクションでは、Table コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、イベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのテーブル コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、テーブル コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|テーブル<br /><br /> -   ヘッダー \(0 または 1\)<br />-   テキスト \(0 または 1\)<br />-   各種コントロール \(0 以上\)|テーブル<br /><br /> -   テキスト \(0 以上\)<br />-   各種コントロール \(0 以上\)|  
+  
+ テーブル コントロールに行ヘッダーまたは列ヘッダーが含まれている場合は、それらを UI オートメーション ツリーのコントロール ビューで公開する必要があります。 コンテンツ ビューは、TablePattern を使用してアクセスできるため、この情報を公開する必要がありません。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、テーブル コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|通常、テーブル コントロールは、静的テキスト ラベルからその名前を取得します。 静的テキスト ラベルが存在しない場合は、Name プロパティを割り当てる必要があります。このプロパティは、テーブルの目的を説明するために常に利用できる必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」をご覧ください。|静的テキスト ラベルが存在する場合、このプロパティは、そのコントロールのオートメーション要素への参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|テーブル|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"テーブル"|Table コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|「ノート」をご覧ください。|NameProperty にアクセスするだけではテーブルの目的が十分伝わらない場合は、このプロパティを介してさらに詳しく説明する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.DescribedByProperty>|「ノート」をご覧ください。|他の UI 要素 \(テーブルの説明を保持するテキスト要素など\) によってテーブルに注釈が指定されている場合、DescribedBy プロパティは、そのテキスト コントロールのオートメーション要素への参照を公開する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|テーブル コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|テーブル コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、テーブル コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IGridProvider>|はい|テーブルに格納される項目にはグリッドに表示されるデータが含まれるため、テーブル コントロールはこのコントロール パターンを常にサポートします。|  
+|<xref:System.Windows.Automation.Provider.IGridItemProvider>|はい \(子オブジェクトでは必須\)|テーブルの内部オブジェクトは、GridItem と TableItem の両方のコントロール パターンをサポートする必要があります。 テーブル自体では、それが別のテーブルの一部である場合を除いて、GridItem コントロール パターンも TableItem コントロール パターンもサポートする必要がありません。|  
+|<xref:System.Windows.Automation.Provider.ITableProvider>|はい|テーブル コントロールは、常に、ヘッダーとコンテンツを関連付けることができます。|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider>|はい \(子オブジェクトでは必須\)|テーブルの内部オブジェクトは、GridItem と TableItem の両方のコントロール パターンをサポートする必要があります。 テーブル自体では、それが別のテーブルの一部である場合を除いて、GridItem コントロール パターンも TableItem コントロール パターンもサポートする必要がありません。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのテーブル コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Table>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-text-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-text-control-type.md
new file mode 100644
index 00000000000..3cef463739c
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-text-control-type.md
@@ -0,0 +1,98 @@
+---
+title: "UI Automation Support for the Text Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Text control type"
+  - "UI Automation, Text control type"
+  - "control types, Text"
+ms.assetid: ab0d0ada-8a71-4547-9c03-aadf675938f2
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# UI Automation Support for the Text Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Text コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ テキスト コントロールは、画面上のテキストを表す、基本的なユーザー インターフェイス項目です。  
+  
+ 以降のセクションで、Text コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのテキスト コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、テキスト コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|テキスト|テキスト \(コンテンツの場合\)|  
+  
+ テキスト コントロールは、単独でラベルとして使用することも、フォーム上の静的テキストとして使用することもできます。 また、次の構造に含めることもできます。  
+  
+-   ListItem  
+  
+-   TreeItem  
+  
+-   DataItem  
+  
+ テキストは多くの場合、別のコントロールの `NameProperty` によって表示されるため、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューにテキスト コントロールは含まれないことがあります。 たとえば、コンボ ボックス コントロールのラベル付けに使用されるテキストは、そのコントロールの `NameProperty` 値を使用して公開されます。 コンボ ボックス コントロールが UI オートメーション ツリーのコンテンツ ビューに存在するので、テキスト コントロールがこのビューに存在する必要はありません。 コンテンツ ビューに、テキスト コントロールの子が存在することはありません。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、テキスト コンロトールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|常に、テキスト バー コントロールが表示するテキストが、そのコントロールの名前になります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|テキスト コントロールに静的なテキスト ラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|テキスト|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|「テキスト」|Text コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|状況に依存|テキスト コントロールに、別のコントロールの NameProperty で公開されていない情報が含まれている場合、テキスト コントロールはコンテンツになります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|テキスト コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、テキスト コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IValueProvider>|Never|テキストが ValuePattern をサポートすることはありません。 テキストが編集可能な場合、それは Edit コントロール型です。|  
+|<xref:System.Windows.Automation.Provider.ITextProvider>|状況に依存|テキストはアクセシビリティを向上させるために Text コントロール パターンをサポートする必要がありますが、必須ではありません。 テキストにさまざまなスタイルや属性 \(たとえば、色、太字、斜体など\) がある場合、Text コントロール パターンを使用すると便利です。これは、フレームワークに依存します。|  
+|<xref:System.Windows.Automation.Provider.ITableItemProvider>|状況に依存|テキスト要素がテーブル コントロール内に含まれている場合は、サポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.IRangeValueProvider>|状況に依存|テキスト要素がテーブル コントロール内に含まれている場合は、サポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのテキスト コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextSelectionChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Text>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-thumb-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-thumb-control-type.md
new file mode 100644
index 00000000000..659ccf9e872
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-thumb-control-type.md
@@ -0,0 +1,83 @@
+---
+title: "UI Automation Support for the Thumb Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Thumb"
+  - "UI Automation, Thumb control type"
+  - "Thumb control type"
+ms.assetid: 13636338-e320-4355-b071-ede20a3fb1de
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the Thumb Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Thumb コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ Thumb コントロールは、スクロール バー ボタンなどのようにコントロールを移動 \(またはドラッグ\) したり、ウィンドウ サイズ変更ウィジェットなどのようにサイズ変更したりできる機能を提供します。 Thumb コントロールは、ウィンドウの移動可能な枠線として実装することもできます。 ドラッグ アンド ドロップ機能は提供されないことに注意してください。 Thumb コントロールは、マウス フォーカスを受け取ることはできますが、通常キーボード フォーカスを受け取ることはできません。 コントロール開発者は、適切に動作するように \(ドラッグしたりサイズ変更したりできるように\)、コントロールを実装する必要があります。  
+  
+ 以下の各セクションで、Thumb コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべての Thumb コントロールに当てはまります。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、Thumb コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|つまみ|-   該当なし|  
+  
+ Thumb コントロールは、マウスを使用して操作するためだけに存在しているので、コンテンツ ビューには表示されません。 これらの機能は、Thumb コンテナーでサポートされる Scroll パターン、Transform パターン、RangeValue パターンなど別のコントロール パターンを使用して公開されます。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、Thumb コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|Thumb コントロールの表示されているクライアント領域内の任意のポイント。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|`Null`|Thumb コントロールは、UI オートメーション ツリーのコンテンツ ビューには表示されないため、名前は不要です。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|Thumb コントロールにラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|つまみ|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"Thumb"|Thumb コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|Thumb コントロールにコンテンツはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|Thumb コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、Thumb コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|必要|Thumb コントロールを画面で移動できるようにします。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべての Thumb コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Thumb>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-titlebar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-titlebar-control-type.md
new file mode 100644
index 00000000000..44aaaddfe17
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-titlebar-control-type.md
@@ -0,0 +1,80 @@
+---
+title: "UI Automation Support for the TitleBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Title Bar"
+  - "Title Bar control type"
+  - "UI Automation, Title Bar control type"
+ms.assetid: 3b7a4e13-0305-45d5-bc33-1f4133c50782
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the TitleBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、TitleBar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 これらの条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ タイトル バー コントロールは、ウィンドウ内のタイトルまたはキャプション バーを表します。  
+  
+ 以下の各セクションで、TitleBar コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのタイトル バー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、タイトル バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含まれる可能性のある内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|TitleBar<br /><br /> -   Menu \(0 または 1\)<br />-   Button \(0 以上\)|該当なし。 \(タイトル バー コントロールにはコンテンツはありません。\)|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、TitleBar コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|ノートを参照してください。|このプロパティの値は、アプリケーション内のすべてのコントロールで一意にする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|ノートを参照してください。|タイトル バーの四角形領域は、タイトル バー コントロールに含まれるコントロールをすべて囲んでいる必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|ノートを参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域の内側にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|False|タイトル バーで、キーボード フォーカスを持つことはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|""|タイトル バーはコンテンツではありません。タイトル バーのテキスト情報は、親ウィンドウで公開されます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|ノートを参照してください。|通常、タイトル バー コントロールにラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|TitleBar|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"タイトル バー"|TitleBar コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|False|タイトル バー コントロールはコンテンツではありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|タイトル バー コントロールは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty>|状況に依存|このコントロールは、タイトル バーが画面上に表示されているかどうかに応じた値を返します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.HelpTextProperty>|""|ヘルプ テキストを公開する必要はありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AcceleratorKeyProperty>|""|タイトル バーで、アクセラレータ キーを持つことはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AccessKeyProperty>|""|タイトル バー コントロールにアクセス キーはありません。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ TitleBar コントロール型は、どのコントロール パターンもサポートする必要はありません。 タイトル バーの機能は、Window コントロール上の Window コントロール パターンを通じて公開されます。  
+  
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのタイトル バー コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|Never|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.TitleBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-toolbar-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-toolbar-control-type.md
new file mode 100644
index 00000000000..819046ccc69
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-toolbar-control-type.md
@@ -0,0 +1,84 @@
+---
+title: "UI Automation Support for the ToolBar Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Toolbar"
+  - "UI Automation, Toolbar control type"
+  - "ToolBar control type"
+ms.assetid: 85152efd-f4c5-430c-8878-3371cc598616
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# UI Automation Support for the ToolBar Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、ToolBar コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。 ツール バー コントロールを使用すれば、エンドユーザーは、アプリケーション内に含まれるコマンドやツールをアクティブにすることができます。  
+  
+ 以下の各セクションで、ToolBar コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのツール バー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ツール バー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ToolBar<br /><br /> -   各種コントロール \(0 以上\)|ToolBar<br /><br /> -   各種コントロール \(0 以上\)|  
+  
+ ツール バー コントロールには、そのサブツリー内に任意の型のコントロールを含めることができます。 ほとんどの場合は、ボタン、コンボ ボックス、およびスプリット ボタンが含まれています。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ツール バー コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|状況に依存|アプリケーション内で複数のツール バー コントロールが使用されている場合を除き、ツール バー コントロールに名前は必要ありません。 複数のツール バー コントロールが存在する場合は、それぞれに特徴的な名前 \(Formatting や Outlining など\) を付ける必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|ツール バー コントロールにラベルはありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ToolBar|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"tool bar"|ToolBar コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ツール バー コントロールは常にコンテンツです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ツール バー コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、ツール バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.ExpandCollapsePattern>|状況に依存|ツール バーを展開または折りたたむことでさらに多くの項目を表示可能な場合は、このパターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.DockPattern>|状況に依存|ツール バーを画面のさまざまな部分にドッキング可能な場合は、このパターンをサポートする必要があります。|  
+|<xref:System.Windows.Automation.TransformPattern>|状況に依存|ツール バーをサイズ変更、回転、または移動可能な場合は、このパターンをサポートする必要があります。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのツール バー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ToolBar>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-tooltip-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-tooltip-control-type.md
new file mode 100644
index 00000000000..0340e039810
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-tooltip-control-type.md
@@ -0,0 +1,96 @@
+---
+title: "UI Automation Support for the ToolTip Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, ToolTip control type"
+  - "ToolTip control type"
+  - "control types, ToolTip"
+ms.assetid: c3779d78-3164-43ae-8dae-bfaeafffdd65
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the ToolTip Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、ToolTip コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ツール ヒント コントロールは、テキストを含むポップアップ ウィンドウです。  
+  
+ 以下の各セクションで、ToolTip コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、すべてのツール ヒント コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ツール ヒント コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ヒント<br /><br /> -   テキスト \(0 個以上\)<br />-   イメージ \(0 個以上\)|ヒント|  
+  
+ ツール ヒント コントロールは、キーボード フォーカスを受け取ることができる場合は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューにのみ表示されます。 それ以外の場合、ツール ヒントの情報はすべて、ツール ヒントが参照している [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素の `HelpTextProperty` から取得できます。  
+  
+ ツール ヒントは、その情報が参照しているコントロールの下に表示されます。 クライアントは、ツール ヒントに含まれる情報を常に取得できるよう、`ToolTipOpenedEvent` をリッスンする必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ツール ヒント コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|クリック可能なポイントは、コントロールを閉じるツール ヒントの部分である必要があります。 一部のツール ヒントには、この機能がありません。その場合、クリック可能なポイントを持ちません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|ツール ヒント内に表示されるテキストがツール ヒント コントロールの名前になります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|ツール ヒント コントロールは、常にそのコンテンツで自己ラベル付けを行います。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ヒント|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"ツール ヒント"|ToolTip コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|状況に依存|ツール ヒント コントロールがキーボード フォーカスを受け取ることができる場合、ツリーのコンテンツ ビューにのみ表示される必要があります。 テキストのみである場合は、生成元のコントロールの HelpTextProperty として取得できます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ツール ヒント コントロールは、常にコントロールである必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、ツール ヒント コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider>|状況に依存|UI 項目をクリックして閉じることができるツール ヒントは、自動的に閉じるように、WindowPattern をサポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ITextProvider>|状況に依存|アクセシビリティを向上させるために、ツール ヒント コントロールでは Text コントロール パターンをサポートできますが、必須ではありません。 テキストにさまざまなスタイルや属性 \(たとえば、色、太字、斜体など\) がある場合、Text コントロール パターンの使用をお勧めします。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ ツール ヒント コントロールは、画面に表示された場合に `ToolTipOpenedEvent` を生成する必要があります。 イベントにツール ヒント自体の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 要素への参照が組み込まれます。  
+  
+ 次の表に、すべてのツール ヒント コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextSelectionChangedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.TextPatternIdentifiers.TextChangedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowClosedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowOpenedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ToolTipOpenedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ToolTipClosedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowVisualStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.ToolTip>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-tree-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-tree-control-type.md
new file mode 100644
index 00000000000..d54ecd6b1f6
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-tree-control-type.md
@@ -0,0 +1,99 @@
+---
+title: "UI Automation Support for the Tree Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Tree"
+  - "Tree control type"
+  - "UI Automation, Tree control type"
+ms.assetid: 312dd04d-a86b-4072-8b12-2beeabdff5e3
+caps.latest.revision: 20
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 20
+---
+# UI Automation Support for the Tree Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、Tree コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ Tree コントロール型は、ファイルやフォルダーが [!INCLUDE[TLA#tla_winexpl](../../../includes/tlasharptla-winexpl-md.md)] の左ウィンドウに表示される場合のように、ノード階層の関係を持つコンテンツのコンテナーに使用されます。 各ノードに、子ノードと呼ばれる他のノードが含まれている可能性があります。 親ノード \(子ノードを含むノード\) は、展開した状態または折りたたんだ状態で表示できます。  
+  
+ 以下の各セクションで、Tree コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、または [!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] であるかどうかに関係なく、すべてのツリー コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ツリー コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ツリー<br /><br /> <ul><li>DataItem \(0 以上\)</li><li>TreeItem \(0 以上\)<br /><br /> <ul><li>TreeItem \(0 以上\)•    …</li></ul></li><li>ScrollBar \(0、1、2\)</li></ul>|ツリー<br /><br /> <ul><li>DataItem \(0 以上\)</li><li>TreeItem \(0 以上\)<br /><br /> <ul><li>TreeItem \(0 以上\)•    …</li></ul></li></ul>|  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューは、次のものから構成されます。  
+  
+-   コンテナー内の 0 個以上の項目 \(項目は、Tree Item コントロール型、Data Item コントロール型、またはその他のコントロール型に基づいて設定できます\)。  
+  
+-   0、1、または 2 個のスクロール バー。  
+  
+ コンテンツ ビューの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーは、コンテナー内の 0 個以上の項目から構成されます \(項目は、TreeItem コントロール型、DataItem コントロール型、またはその他のコントロール型に基づいている可能性があります\)。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、リスト コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照してください。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照してください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照してください。|ツリー コントロールには、クリックするとツリーまたはツリー コンテナー内の 1 つの項目にフォーカスが設定される、クリック可能なポイントがあります。 ツリーのクリック可能なポイントを取得するのは、項目を 1 つ選択したり項目にフォーカスを設定したりすることなくクリックできる場所がある場合に限られます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|ツリー|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ツリー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ツリー コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照してください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|「ノート」を参照してください。|ツリー コントロールにラベルが関連付けられている場合、このプロパティはそのラベルの <xref:System.Windows.Automation.AutomationElement> を返します。 それ以外の場合、このプロパティは null 参照 \([!INCLUDE[TLA#tla_visualbnet](../../../includes/tlasharptla-visualbnet-md.md)] の `Nothing`\) を返します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"ツリー"|List コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照してください。|ツリー コントロールの名前プロパティの値は、通常、コントロールにラベルを付けるテキストから取得されます。 テキスト ラベルが存在しない場合は、アプリケーションの開発者がこのプロパティの値を提供する必要があります。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、リスト コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider>|状況に依存|選択可能な一連の項目を含むツリー コントロールは、このコントロール パターンを実装する必要があります。 項目を選択してもユーザーに意味のある情報が伝達されない場合は、このコントロール パターンを実装する必要はありません。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.CanSelectMultiple%2A>|「ノート」を参照してください。|ツリー コントロールが複数選択をサポートする場合、このプロパティを実装します \(ほとんどのツリー コントロールは、複数選択をサポートしません\)。|  
+|<xref:System.Windows.Automation.Provider.ISelectionProvider.IsSelectionRequired%2A>|「ノート」を参照してください。|このプロパティの値は、コントロールで項目が選択される必要がある場合に公開されます。|  
+|<xref:System.Windows.Automation.Provider.IScrollProvider>|状況に依存|ツリー コンテナーのコンテンツがスクロールできる場合は、このコントロール パターンを実装します。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのツリー コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.SelectionPatternIdentifiers.InvalidatedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Tree>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md
new file mode 100644
index 00000000000..ed0bf0aae66
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-treeitem-control-type.md
@@ -0,0 +1,105 @@
+---
+title: "UI Automation Support for the TreeItem Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "control types, Tree Item"
+  - "Tree Item control type"
+  - "UI Automation, Tree Item control type"
+ms.assetid: 229f341a-477f-434e-b877-4db9973068eb
+caps.latest.revision: 22
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 22
+---
+# UI Automation Support for the TreeItem Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックでは、TreeItem コントロール型に対する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] のサポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、およびコントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ TreeItem コントロール型は、ツリー コンテナー内のノードを表します。 各ノードには、"子ノード" と呼ばれるその他のノードが含まれている可能性があります。 親ノード \(子ノードを含むノード\) は、展開した状態または折りたたんだ状態で表示できます。  
+  
+ 以下の各セクションで、TreeItem コントロール型に必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合も、すべてのツリー項目コントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ツリー項目コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|TreeItem<br /><br /> -   CheckBox \(0 または 1\)<br />-   Image \(0 または 1\)<br />-   Button \(0 または 1\)<br />-   TreeItem \(0 以上\)|TreeItem<br /><br /> -   TreeItem \(0 以上\)|  
+  
+ ツリー項目コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに 0 個以上のツリー項目の子を持つことができます。 ツリー項目コントロールに次に示すコントロール パターンで公開されている以外の機能がある場合は、コントロールは Data Item コントロール型に基づく必要があります。  
+  
+ 折りたたまれているツリー項目は、展開して表示される \(または、スクロールして表示される\) まで、コントロール ビューまたはコンテンツ ビューに表示されません。  
+  
+ コントロール ビューには、関連付けられているイメージやボタンなど、コントロールの追加の詳細を含めることができます。 たとえば、アウトライン表示の項目には、イメージの他にアウトラインを展開または折りたたむボタンが含まれる場合があります。 これらの詳細オブジェクトは、情報が親のツリー項目によって既に表されているため、コンテンツ ビューに表示されません。 画面の外にスクロールされたツリー項目が [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューの両方に表示されます。それらの <xref:System.Windows.Automation.AutomationElement.IsOffscreenProperty> は true に設定する必要があります。  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、リスト コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの詳細については、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」を参照。|このプロパティの値は、アプリケーションのすべてのコントロールにおいて一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」を参照。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」を参照。|このプロパティは、選択状態を変更またはフォーカスを設定する項目を原因となるアイテムの場所を返す必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|TreeItem|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|リスト コントロールは、常に [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューに含まれます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty>|「ノート」を参照。|このプロパティは、ツリー項目コントロールが画面の外にスクロールされたことを示すために設定します。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」を参照。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemTypeProperty>|「ノート」を参照。|ツリー項目コントロールで、特定の型のオブジェクトであることを示すために表示されるアイコンを使用する場合、このプロパティをサポートし、オブジェクトの種類を指定する必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`Null`|ツリー項目コントロールは、自動的にラベル付けされます。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"tree item"|TreeItem コントロール型に対応するローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」を参照。|このプロパティは、各ツリー項目コントロールに表示されるテキストを公開します。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、リスト コントロールでサポートされなければならない [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンを示します。 コントロール パターンの詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+|コントロール パターン\/パターン プロパティ|サポート\/値|ノート|  
+|-----------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IInvokeProvider>|状況に依存|ツリー項目に操作可能な別のコマンドがある場合は、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider>|はい|すべてのツリー項目を展開または折りたたむことができます。|  
+|<xref:System.Windows.Automation.Provider.IExpandCollapseProvider.ExpandCollapseState%2A>|展開されたノード、折りたたまれたノード、またはリーフ ノード|ツリー項目は、展開されたり、折りたたまれたりしない場合は、リーフ ノードになります。|  
+|<xref:System.Windows.Automation.Provider.IScrollItemProvider>|状況に依存|ツリー コンテナーが Scroll コントロール パターンをサポートする場合、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider>|状況に依存|ユーザーがツリー コンテナーに戻るときに、アクティブな選択を保持することができる場合、このコントロール パターンを実装します。|  
+|<xref:System.Windows.Automation.Provider.ISelectionItemProvider.SelectionContainer%2A>|はい|このプロパティは、コンテナー内のすべての項目に対して同じコンテナーを公開します。|  
+|<xref:System.Windows.Automation.Provider.IToggleProvider>|状況に依存|ツリー項目に関連付けられたチェック ボックスがある場合、このコントロール パターンを実装します。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのツリー項目コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントの詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ItemStatusProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.ExpandCollapsePatternIdentifiers.ExpandCollapseStateProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.InvokePatternIdentifiers.InvokedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.MultipleViewPatternIdentifiers.CurrentViewProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementAddedToSelectionEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementRemovedFromSelectionEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.SelectionItemPatternIdentifiers.ElementSelectedEvent>|状況に依存|なし|  
+|<xref:System.Windows.Automation.TogglePatternIdentifiers.ToggleStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ValuePatternIdentifiers.ValueProperty> プロパティ変更イベント。|状況に依存|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.TreeItem>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-support-for-the-window-control-type.md b/docs/framework/ui-automation/ui-automation-support-for-the-window-control-type.md
new file mode 100644
index 00000000000..d3908cdaef6
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-support-for-the-window-control-type.md
@@ -0,0 +1,95 @@
+---
+title: "UI Automation Support for the Window Control Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, Window control type"
+  - "Window control type"
+  - "control types, Window"
+ms.assetid: 53be78a6-cdcc-4af3-a464-5927d19c54e8
+caps.latest.revision: 19
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 19
+---
+# UI Automation Support for the Window Control Type
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ このトピックでは、Window コントロール型の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] サポートについて説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]でのコントロール型とは、コントロールが <xref:System.Windows.Automation.AutomationElement.ControlTypeProperty> プロパティを使用するために満たす必要がある一連の条件のことです。 条件には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー構造、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティの値、コントロール パターンに関する特定のガイドラインが含まれます。  
+  
+ ウィンドウ コントロールは、子オブジェクト \(タイトル バー、クライアント、その他のオブジェクトなど\) が含まれているウィンドウ フレームで構成されます。  
+  
+ 以下のセクションの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の要件は、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)] のいずれの場合でも、Window コントロール型を実装するすべてのコントロールに適用されます。  
+  
+<a name="Required_UI_Automation_Tree_Structure"></a>   
+## 必須の UI オートメーション ツリー構造  
+ 次の表に、ウィンドウ コントロールに関連する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーについて詳しくは、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください。  
+  
+|コントロール ビュー|コンテンツ ビュー|  
+|----------------|---------------|  
+|ウィンドウ|ウィンドウ|  
+  
+<a name="Required_UI_Automation_Properties"></a>   
+## 必須の UI オートメーション プロパティ  
+ 次の表に、ウィンドウ コントロールに特に関連する値または定義を持つ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを示します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティについて詳しくは、「[UI Automation Properties for Clients](../../../docs/framework/ui-automation/ui-automation-properties-for-clients.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティ|値|ノート|  
+|---------------------------------------------------------------------------------|-------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AutomationIdProperty>|「ノート」をご覧ください。|このプロパティの値は、アプリケーションのすべてのコントロールで一意である必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty>|「ノート」をご覧ください。|コントロール全体を格納する最も外側の四角形。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ClickablePointProperty>|「ノート」をご覧ください。|ウィンドウ コントロールにはクリック可能なポイントがなければならず、これをクリックすることによってウィンドウが選択、または選択解除された状態になります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.ControlTypeProperty>|\[Window\]|この値は、すべての UI フレームワークで同じです。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>|True|ウィンドウ コントロールは、常にコンテンツである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>|True|ウィンドウ コントロールは、常にコントロールである必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsKeyboardFocusableProperty>|「ノート」をご覧ください。|コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LabeledByProperty>|`null`|ウィンドウ コントロールには、静的な Window ラベルがありません。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LocalizedControlTypeProperty>|"window"|Window コントロール型に対応する、ローカライズされた文字列。|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty>|「ノート」をご覧ください。|ウィンドウ コントロールには、主要なウィンドウ要素が常に含まれています。この要素は、ユーザーがその項目の最もセマンティックな識別子として関連付けるであろうものに関連しています。|  
+  
+<a name="Required_UI_Automation_Control_Patterns"></a>   
+## 必須の UI オートメーション コントロール パターン  
+ 次の表に、ウィンドウ コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンの一覧を示します。 コントロール パターンについて詳しくは、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」をご覧ください。  
+  
+|コントロール パターン|Support|ノート|  
+|-----------------|-------------|---------|  
+|<xref:System.Windows.Automation.Provider.IDockProvider>|条件|ウィンドウがドッキングできる場合は、サポートする必要があります。|  
+|<xref:System.Windows.Automation.Provider.ITransformProvider>|必要|ウィンドウが画面上で移動、サイズ変更、または回転できるようにします。|  
+|<xref:System.Windows.Automation.Provider.IWindowProvider>|必要|ウィンドウで特定の操作ができるようにします。|  
+  
+<a name="Required_UI_Automation_Events"></a>   
+## 必須の UI オートメーション イベント  
+ 次の表に、すべてのウィンドウ コントロールでサポートする必要がある [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベントを示します。 イベントについて詳しくは、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」をご覧ください。  
+  
+|[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント|Support|ノート|  
+|--------------------------------------------------------------------------------|-------------|---------|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.AsyncContentLoadedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElement.AutomationFocusChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.BoundingRectangleProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsEnabledProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.IsOffscreenProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.LayoutInvalidatedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.AutomationElementIdentifiers.NameProperty> プロパティ変更イベント。|必須|なし|  
+|<xref:System.Windows.Automation.AutomationElement.StructureChangedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.HorizontalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalScrollPercentProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticallyScrollableProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.ScrollPatternIdentifiers.VerticalViewSizeProperty> プロパティ変更イベント。|状況に依存|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowClosedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowOpenedEvent>|必要|なし|  
+|<xref:System.Windows.Automation.WindowPatternIdentifiers.WindowVisualStateProperty> プロパティ変更イベント。|状況に依存|なし|  
+  
+## 参照  
+ <xref:System.Windows.Automation.ControlType.Window>   
+ [UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)   
+ [UI Automation Overview](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-text-pattern-how-to-topics.md b/docs/framework/ui-automation/ui-automation-text-pattern-how-to-topics.md
new file mode 100644
index 00000000000..917bc2f4006
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-text-pattern-how-to-topics.md
@@ -0,0 +1,37 @@
+---
+title: "UI Automation Text Pattern-How-to Topics | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, TextPattern class"
+  - "TextPattern class"
+  - "classes, TextPattern"
+ms.assetid: ca6ac045-7b21-4487-9379-59aa20909670
+caps.latest.revision: 62
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 62
+---
+# UI Automation Text Pattern-How-to Topics
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このセクションのトピックでは、UI オートメーション テキスト パターンの使用方法について説明します。  
+  
+## このセクションの内容  
+ [Add Content to a Text Box Using UI Automation](../../../docs/framework/ui-automation/add-content-to-a-text-box-using-ui-automation.md)  
+ [Find and Highlight Text Using UI Automation](../../../docs/framework/ui-automation/find-and-highlight-text-using-ui-automation.md)  
+ [Obtain Text Attributes Using UI Automation](../../../docs/framework/ui-automation/obtain-text-attributes-using-ui-automation.md)  
+ [Obtain Mixed Text Attribute Details Using UI Automation](../../../docs/framework/ui-automation/obtain-mixed-text-attribute-details-using-ui-automation.md)  
+ [Traverse Text Using UI Automation](../../../docs/framework/ui-automation/traverse-text-using-ui-automation.md)  
+ [Access Embedded Objects Using UI Automation](../../../docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-text-pattern.md b/docs/framework/ui-automation/ui-automation-text-pattern.md
new file mode 100644
index 00000000000..80d752fbfc5
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-text-pattern.md
@@ -0,0 +1,41 @@
+---
+title: "UI Automation Text Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "UI Automation, TextPattern class"
+  - "TextPattern class"
+  - "classes, TextPattern"
+ms.assetid: b51206f2-1281-4ad0-9820-ea39d88ae577
+caps.latest.revision: 61
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 61
+---
+# UI Automation Text Pattern
+> [!NOTE]
+>  このドキュメントは、<xref:System.Windows.Automation> 名前空間で定義されているマネージ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クラスを使用する .NET Framework 開発者を対象としています。  [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]に関する最新情報については、「[Windows Automation API: UI Automation \(Windows オートメーション API: UI オートメーション\)](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]のテキスト要素のプログラミングに役立つ概要と方法のトピックを示します。  
+  
+## このセクションの内容  
+ [UI Automation TextPattern Overview](../../../docs/framework/ui-automation/ui-automation-textpattern-overview.md)  
+ [TextPattern and Embedded Objects Overview](../../../docs/framework/ui-automation/textpattern-and-embedded-objects-overview.md)  
+ [How\-to Topics](../../../docs/framework/ui-automation/ui-automation-text-pattern-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Automation.Text>  
+  
+## 参照  
+ [UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)   
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-textpattern-overview.md b/docs/framework/ui-automation/ui-automation-textpattern-overview.md
new file mode 100644
index 00000000000..af7e40474c9
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-textpattern-overview.md
@@ -0,0 +1,144 @@
+---
+title: "UI Automation TextPattern Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, TextPattern class"
+  - "TextPattern class"
+  - "classes, TextPattern"
+ms.assetid: 41787927-df1f-4f4a-aba3-641662854fc4
+caps.latest.revision: 38
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 37
+---
+# UI Automation TextPattern Overview
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」をご覧ください。  
+  
+ この概要では、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] を使用して、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] でサポートされているプラットフォームのテキスト コントロールのテキストの内容 \(書式とスタイルの属性など\) を公開する方法について説明します。 これらのコントロールには、[!INCLUDE[TLA#tla_winfx](../../../includes/tlasharptla-winfx-md.md)] <xref:System.Windows.Controls.TextBox>、<xref:System.Windows.Controls.RichTextBox>、およびその [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] に相当するものが含まれますが、これに限定されません。  
+  
+ コントロールのテキストの内容は、<xref:System.Windows.Automation.TextPattern> コントロール パターンを使用することで公開できます。コントロール パターンは、テキスト コンテナーの内容をテキスト ストリームとして表したものです。 さらに、 <xref:System.Windows.Automation.TextPattern> は、書式とスタイルの属性を公開する <xref:System.Windows.Automation.Text.TextPatternRange> クラスをサポートする必要があります。<xref:System.Windows.Automation.Text.TextPatternRange> は、<xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> および <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> エンドポイントのコレクションがあるテキスト コンテナーに、連続する、または複数の非結合テキスト範囲を表すことで <xref:System.Windows.Automation.TextPattern> をサポートします。<xref:System.Windows.Automation.Text.TextPatternRange> は、選択、比較、取得、トラバースなどの機能をサポートしています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.TextPattern> クラスには、テキストを挿入または変更する手段がありません。 しかし、コントロールによっては、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] <xref:System.Windows.Automation.ValuePattern> によって、または直接キーボードから入力して、これを実現できます。 例については、「[TextPattern Insert Text Sample](http://msdn.microsoft.com/ja-jp/67353f93-7ee2-42f2-ab76-5c078cf6ca16)」をご覧ください。  
+  
+ この概要で説明されている機能は、支援技術ベンダーとそのエンドユーザーにとって重要です。 支援技術は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] を使用してユーザー向けに完全なテキストの書式設定情報を収集するとともに、プログラムによるナビゲーションと、<xref:System.Windows.Automation.Text.TextUnit> によるテキストの選択 \(文字、単語、行、または段落\) を行います。  
+  
+<a name="UI_Automation_TextPattern_vs__Cicero"></a>   
+## UI オートメーション TextPattern とText Services Framework \(TSF\)  
+ [!INCLUDE[TLA#tla_tsf](../../../includes/tlasharptla-tsf-md.md)] は、デスクトップ上およびアプリケーション内で、自然言語サービスと高度なテキスト入力を行えるようにする、拡張性のあるシステム フレームワークです。 アプリケーションのテキスト ストアを公開するインターフェイスをアプリケーションに提供するだけでなく、そのテキスト ストアのメタデータもサポートします。  
+  
+ ただし、[!INCLUDE[TLA2#tla_tsf](../../../includes/tla2sharptla-tsf-md.md)] は、コンテキストに対応したシナリオに入力を挿入する必要がある一方、<xref:System.Windows.Automation.TextPattern> は、スクリーン リーダーとブライユ点字デバイス用のテキスト ストアに最適にアクセスできるようにすることを意図した、\(前述の制限付きの回避策による\) 読み取り専用のソリューションです。  
+  
+ つまり、テキスト ストアへの読み取り専用のアクセスが必要なアクセス可能なテクノロジでは <xref:System.Windows.Automation.TextPattern> を使用できますが、コンテキストに対応する入力には [!INCLUDE[TLA2#tla_tsf](../../../includes/tla2sharptla-tsf-md.md)] のより複雑な機能が必要になります。  
+  
+<a name="Control_Types"></a>   
+## コントロールの種類  
+  
+#### テキスト  
+ テキスト コントロールは、画面上のテキストの一部を表す基本要素です。  
+  
+ スタンドアロンのテキスト コントロールは、フォーム上のラベルまたは静的テキストとして使用できます。 また、テキスト コントロールを、<xref:System.Windows.Automation.ControlType.ListItem>、<xref:System.Windows.Automation.ControlType.TreeItem>、または <xref:System.Windows.Automation.ControlType.DataItem> の構造に含めることもできます。  
+  
+> [!NOTE]
+>  テキスト コントロールは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに表示されないことがあります \(「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」をご覧ください\)。 これは、テキスト コントロールが別のコントロールの Name プロパティを通じて表示されることがよくあるためです。 たとえば、エディット コントロールのラベルに使用するテキストは、エディット コントロールの Name プロパティを通じて公開されます。 エディット コントロールが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーのコンテンツ ビューに存在するので、テキスト要素自体は [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーの対象のビューに存在する必要はありません。 コンテンツ ビューに表示されるテキストは、冗長な情報ではないテキストのみです。 これにより、支援テクノロジは、ユーザーが必要とする情報のみをすばやくフィルター処理できるようになります。  
+  
+#### 編集  
+ エディット コントロールを使用すると、ユーザーは 1 行のテキストを表示および編集できます。  
+  
+> [!NOTE]
+>  1 行のテキストは、特定のレイアウトのシナリオでは折り返すことができます。  
+  
+#### ドキュメント  
+ ドキュメント コントロールを使用すると、ユーザーは複数のページのテキストに移動して、そこから情報を取得できます。  
+  
+<a name="TextPattern_Client_API_s"></a>   
+## TextPattern クライアント API  
+  
+|||  
+|-|-|  
+|`System.Windows.Automation.TextPattern Class`|[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] テキスト モデルのエントリ ポイントです。<br /><br /> このクラスには、<xref:System.Windows.Automation.TextPattern.TextSelectionChangedEvent> と <xref:System.Windows.Automation.TextPattern.TextChangedEvent> という 2 つの <xref:System.Windows.Automation.TextPattern> イベント リスナーが含まれています。|  
+|`System.Windows.Automation.Text.TextPatternRange Class`|<xref:System.Windows.Automation.TextPattern> をサポートする、テキスト コンテナー内のテキストの範囲の表記です。<br /><br /> UI オートメーション クライアントは、<xref:System.Windows.Automation.Text.TextPatternRange> を使用して作成されるテキスト範囲の現在の有効性に関して注意する必要があります。 テキスト コントロールにある元のテキストが完全に新しいテキストに置き換えられた場合、現在のテキスト範囲は無効になります。 ただし、元のテキストの一部のみが変更され、基になるテキスト コントロールが、文字の絶対位置ではなくアンカー \(またはエンドポイント\) が付いたテキストの「ポインター」で管理している場合、テキスト範囲にはまだいくらかの有効性があります。<br /><br /> クライアントは、 <xref:System.Windows.Automation.TextPattern.TextChangedEvent> をリッスンして、操作するテキスト コンテンツに変更があった場合に通知を受けることができます。|  
+|`System.Windows.Automation.AutomationTextAttribute Class`|テキスト範囲の書式設定の属性を識別するために使用されます。|  
+  
+<a name="TextPattern_Provider_API_s"></a>   
+## TextPattern プロバイダー API  
+ ネイティブに、または [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] プロキシを介して <xref:System.Windows.Automation.Provider.ITextProvider> および <xref:System.Windows.Automation.Provider.ITextRangeProvider> の各インターフェイスを実装することで <xref:System.Windows.Automation.TextPattern> をサポートする UI 要素またはコントロールは、堅牢なナビゲーション機能を提供するだけでなく、含まれている任意のテキストの詳細な属性情報を公開することができます。  
+  
+ <xref:System.Windows.Automation.TextPattern> プロバイダーは、コントロールで特定の属性のサポートが不足している場合、すべてのテキスト属性をサポートする必要はありません。  
+  
+ <xref:System.Windows.Automation.TextPattern> プロバイダーは、コントロールがテキスト領域内でテキストの選択またはテキストのカーソル \(またはシステム キャレット\) の配置をサポートする場合に <xref:System.Windows.Automation.TextPattern.GetSelection%2A> 機能と <xref:System.Windows.Automation.Text.TextPatternRange.Select%2A> 機能をサポートする必要があります。 コントロールがこの機能をサポートしない場合、これらのメソッドのいずれもサポートする必要はありません。 ただし、<xref:System.Windows.Automation.Provider.ITextProvider.SupportedTextSelection%2A> プロパティを実装することで、コントロールはサポートするテキスト選択項目の種類を公開する必要があります。  
+  
+ <xref:System.Windows.Automation.TextPattern> プロバイダーは、<xref:System.Windows.Automation.Text.TextUnit> の定数 <xref:System.Windows.Automation.Text.TextUnit> と <xref:System.Windows.Automation.Text.TextUnit>、およびサポートが可能なその他すべての <xref:System.Windows.Automation.Text.TextUnit> 定数を常にサポートする必要があります。  
+  
+> [!NOTE]
+>  プロバイダーは、次に大きい <xref:System.Windows.Automation.Text.TextUnit> \(<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit>、<xref:System.Windows.Automation.Text.TextUnit> の順序でサポートされています\) を遅らせることで、特定の <xref:System.Windows.Automation.Text.TextUnit> のサポートを省略できます。  
+  
+|||  
+|-|-|  
+|`ITextProvider Interface`|クライアント アプリケーションで <xref:System.Windows.Automation.TextPattern> をサポートするメソッド、プロパティ、および属性を公開します \(<xref:System.Windows.Automation.Provider.ITextProvider> を参照してください\)。|  
+|`ITextRangeProvider Interface`|テキスト プロバイダー内のテキストの範囲を表します \(<xref:System.Windows.Automation.Provider.ITextRangeProvider> を参照してください\)。|  
+|`System.Windows.Automation.TextPatternIdentifiers Class`|テキスト プロバイダーの識別子として使用される値が含まれています \(<xref:System.Windows.Automation.TextPatternIdentifiers> を参照してください\)。|  
+  
+<a name="Security"></a>   
+## セキュリティ  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] アーキテクチャは、セキュリティを考慮して設計されました \(「[UI Automation Security Overview](../../../docs/framework/ui-automation/ui-automation-security-overview.md)」をご覧ください\)。 ただし、この概要で説明する TextPattern クラスにはいくつか特定のセキュリティの考慮事項が必要です。  
+  
+-   [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] テキスト プロバイダーは、読み取り専用のインターフェイスを提供しますが、コントロールにある既存のテキストを変更する機能はありません。  
+  
+-   UI オートメーション クライアントは、それらが完全に「信頼できる」場合にのみ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] を使用します。 この一例となるものが、信頼できる既知のアプリケーションのみが実行できる、保護されたログオン デスクトップです。  
+  
+-   UI オートメーション プロバイダーの開発者は、[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] を介してコントロールに公開することにしたすべての情報が、基本的にパブリックであり、他のコードで完全にアクセスできることを認識する必要があります。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] は、UI オートメーション クライアントの信頼性を判断しようとしません。そのため、保護されたコンテンツまたは機密性の高いテキストの情報 \(パスワード フィールドなど\) をUI オートメーション プロバイダーで公開しないことをお勧めします。  
+  
+-   [!INCLUDE[TLA#tla_winvista](../../../includes/tlasharptla-winvista-md.md)] のセキュリティにおける最も重要な変更の 1 つは、「セキュリティで保護された入力」と広く言われるものです。これは、最小特権 \(または制限付き\) ユーザー アカウント \(LUA\) と UI 特権レベルの分離 \(UIPI\) などのテクノロジを包含しています。  
+  
+    -   UIPI は、プログラムが他のより「特権が高い」プログラムを制御または監視できないようにすることで、ユーザー入力になりすましたプロセス間のウィンドウ メッセージ攻撃を防ぎます。  
+  
+    -   LUA は、管理者グループのユーザーが実行しているアプリケーションの特権に制限を設定します。 アプリケーションには必ずしも管理者特権は必要なく、代わりに必要最小限の特権で実行します。 その結果、LUA シナリオに制限が適用される可能性があります。 最も顕著な文字列の切り捨て \(TextPattern 文字列など\) では、管理者レベルのアプリケーションから取得される文字列のサイズを制限する必要があることがあります。そうすることで、これらのアプリケーションは、アプリケーションを無効にするポイントまで強制的にメモリを割り当てられずに済みます。  
+  
+<a name="Performance"></a>   
+## パフォーマンス  
+ TextPattern はその機能のほとんどでプロセス間の呼び出しに依存しているので、コンテンツを処理するときにパフォーマンスを向上させるキャッシュのメカニズムは提供しません。 これは、<xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A> メソッドまたは <xref:System.Windows.Automation.AutomationElement.TryGetCachedPattern%2A> メソッドを使用してアクセスできる [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] の他のコントロール パターンとは異なります。  
+  
+ パフォーマンスを向上させるための 1 つの方法は、<xref:System.Windows.Automation.Text.TextPatternRange.GetText%2A> を使用して、UI オートメーション クライアントに中型のテキスト ブロックの取得を試みさせることです。 たとえば、GetText\(1\) の呼び出しでは、文字ごとにプロセス間の影響を受けます。一方、GetText\(\-1\) の呼び出しでは、1 つのプロセス間の影響を受けますが、テキストのプロバイダーのサイズによっては待機時間が長くなることがあります。  
+  
+<a name="Glossary"></a>   
+## TextPattern 用語集  
+ **属性**  
+ テキスト範囲の書式設定特性 \(<xref:System.Windows.Automation.TextPattern.IsItalicAttribute> または <xref:System.Windows.Automation.TextPattern.FontNameAttribute> など\)。  
+  
+ **低次元テキスト範囲**  
+ 低次元テキスト範囲は、空または 0 文字のテキスト範囲です。 TextPattern コントロール パターンの目的から、テキスト挿入ポイント \(またはシステム キャレット\) は低次元テキスト範囲と見なされます。 テキストが選択されていない場合、 <xref:System.Windows.Automation.TextPattern.GetSelection%2A> は、テキスト挿入ポイントで低次元テキスト範囲を返し、<xref:System.Windows.Automation.TextPattern.RangeFromPoint%2A> は、開始エンドポイントとして低次元テキスト範囲を返します。 テキスト プロバイダーで指定された条件に一致するテキスト範囲が見つからない場合、<xref:System.Windows.Automation.TextPattern.RangeFromChild%2A> および <xref:System.Windows.Automation.TextPattern.GetVisibleRanges%2A> は低次元テキスト範囲を返す可能性があります。 この低次元テキスト範囲は、テキスト プロバイダー内の開始エンドポイントとして使用できます。 検出した範囲と低次元テキスト範囲を混同しないように、<xref:System.Windows.Automation.Text.TextPatternRange.FindText%2A> と <xref:System.Windows.Automation.Text.TextPatternRange.FindAttribute%2A> は null 参照を返します \([!INCLUDE[TLA2#tla_visualbnet](../../../includes/tla2sharptla-visualbnet-md.md)] の `Nothing`\)。  
+  
+ **埋め込みオブジェクト**  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] テキスト モデルには、2 種類の埋め込みオブジェクトがあります。 これらは、ハイパーリンクやテーブルなどのテキスト ベースのコンテンツ要素、およびイメージとボタンなどのコントロール要素で構成しています。 詳しくは、「[Access Embedded Objects Using UI Automation](../../../docs/framework/ui-automation/access-embedded-objects-using-ui-automation.md)」をご覧ください。  
+  
+ **エンドポイント**  
+ テキスト コンテナー内のテキスト範囲の <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> または <xref:System.Windows.Automation.Text.TextPatternRangeEndpoint> の絶対ポイント。  
+  
+ ![TextPatternRangeEndpoints &#40;開始および終了&#41;。](../../../docs/framework/ui-automation/media/uia-textpattern-endpoints.PNG "UIA\_TextPattern\_Endpoints")  
+始点と終点のセットを次に示します。  
+  
+ **TextRange**  
+ 関連するすべての属性と機能を含むテキスト コンテナーの始点と終点で、テキストの範囲を表したもの。  
+  
+ <xref:System.Windows.Automation.Text.TextUnit>  
+ テキストの範囲の論理セグメントを介して移動するために使用するテキストの定義済みの単位 \(文字、単語、行、または段落\) 。  
+  
+## 参照  
+ [UI Automation Control Patterns for Clients](../../../docs/framework/ui-automation/ui-automation-control-patterns-for-clients.md)   
+ [UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Use Caching in UI Automation](../../../docs/framework/ui-automation/use-caching-in-ui-automation.md)   
+ [Support Control Patterns in a UI Automation Provider](../../../docs/framework/ui-automation/support-control-patterns-in-a-ui-automation-provider.md)   
+ [Control Pattern Mapping for UI Automation Clients](../../../docs/framework/ui-automation/control-pattern-mapping-for-ui-automation-clients.md)   
+ [Text Services Framework \(TSF\)](http://msdn.microsoft.com/library/default.asp?url=/library/tsf/tsf/text_services_framework.asp)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-threading-issues.md b/docs/framework/ui-automation/ui-automation-threading-issues.md
new file mode 100644
index 00000000000..e2624e8bb7b
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-threading-issues.md
@@ -0,0 +1,30 @@
+---
+title: "UI Automation Threading Issues | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI Automation, threading issues"
+  - "threading issues with UI Automation"
+ms.assetid: 0ab8d42c-5b8b-481b-b788-2caecc2f0191
+caps.latest.revision: 9
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 9
+---
+# UI Automation Threading Issues
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] の Windows メッセージを使用する方法が原因で、クライアント アプリケーションが [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] スレッド上のそれ自体の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] と対話しようとするときに、競合が発生する可能性があります。 これらの競合が発生すると、パフォーマンスが著しく低下する恐れがあります。また、アプリケーションが応答を停止する可能性もあります。  
+  
+ クライアント アプリケーションがデスクトップ上のすべての要素 \(それ自体の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を含む\) と対話する場合、すべての [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の呼び出しを個別のスレッドで実行する必要があります。 これには、要素の検索 \(たとえば、<xref:System.Windows.Automation.TreeWalker> または <xref:System.Windows.Automation.AutomationElement.FindAll%2A> メソッドを使用\) とコントロール パターンの使用が含まれます。  
+  
+ イベント ハンドラーは常に [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 以外のスレッドで呼び出されるため、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の呼び出しを [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] イベント ハンドラー内で実行しても問題ありません。 ただし、クライアント アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] から発生するイベントをサブスクライブする場合、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 以外のスレッド上の <xref:System.Windows.Automation.Automation.AddAutomationEventHandler%2A> \(または関連するメソッド\) への呼び出しを実行する必要があります。 同じスレッドにあるイベント ハンドラーを削除します。
\ No newline at end of file
diff --git a/docs/framework/ui-automation/ui-automation-tree-overview.md b/docs/framework/ui-automation/ui-automation-tree-overview.md
new file mode 100644
index 00000000000..d5aed53fc11
--- /dev/null
+++ b/docs/framework/ui-automation/ui-automation-tree-overview.md
@@ -0,0 +1,66 @@
+---
+title: "UI オートメーション ツリーの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "オートメーション ツリー"
+  - "UI オートメーション、ツリー"
+ms.assetid: 03b98058-bdb3-47a0-8ff7-45e6cdf67166
+caps.latest.revision: 25
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 25
+---
+# UI オートメーション ツリーの概要
+> [!NOTE]
+>  このドキュメントが目的とする、管理を使用する .NET Framework 開発者[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義されたクラス、 <xref:System.Windows.Automation>名前空間。 最新情報について[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を参照してください[Windows Automation API: UI 自動化](http://go.microsoft.com/fwlink/?LinkID=156746)します。  
+  
+ 支援技術製品やテスト スクリプトは、移動、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーに関する情報を収集するために、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)]とその要素。  
+  
+ 内で、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーがありますが、ルート要素 (<xref:System.Windows.Automation.AutomationElement.RootElement%2A>) を表す現在のデスクトップと子要素は、アプリケーション ウィンドウを表します。 これらの各子要素を表すの要素を含めることができます[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]メニューのボタン、ツールバー、およびリスト ボックスなどです。 さらに、これらの要素には、リスト項目などの要素を含めることができます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーは、固定構造ではないと、何千もの要素を含めることがあるため、全体的なでほとんど見します。 その一部は必要に応じてビルドされ、要素の追加、移動、削除に伴って変更されます。  
+  
+ UI オートメーション プロバイダーのサポート、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]はルート (通常はウィンドウでホストされている) と、サブツリーのフラグメント内の項目間のナビゲーションを実装することによってツリーです。 ただし、プロバイダーは、コントロール間のナビゲーションには関与しません。 によって管理されて、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]コアの既定のウィンドウのプロバイダーから情報を使用します。  
+  
+<a name="uiautomation_tree_view"></a>   
+## <a name="views-of-the-automation-tree"></a>オートメーション ツリーのビュー  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]だけを含むビューを作成するツリーをフィルター処理できます<xref:System.Windows.Automation.AutomationElement>特定のクライアントに関連するオブジェクト。 このアプローチにより、クライアントで表示される構造をカスタマイズする[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ニーズに合わせて特定します。  
+  
+ クライアントがビューをカスタマイズする方法には、スコープ設定とフィルター処理の&2; つがあります。 スコープ設定では、基本要素を起点としてビューの範囲を定義します。たとえば、アプリケーションがデスクトップの直接の子だけを検索するか、アプリケーション ウィンドウのすべての子孫を検索するかを定義できます。 フィルター処理では、ビューに含める要素の種類を定義します。  
+  
+ UI オートメーション プロバイダーのサポートなどの要素のプロパティを定義することでフィルター処理、 <xref:System.Windows.Automation.AutomationElementIdentifiers.IsControlElementProperty>と<xref:System.Windows.Automation.AutomationElementIdentifiers.IsContentElementProperty>プロパティです。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]次の&3; つの既定のビューを提供します。 これらのビューは、実行されるフィルター処理の種類によって定義されます。すべてのビューのスコープは、アプリケーションによって定義されます。 さらに、アプリケーションではプロパティに他のフィルターを適用して、たとえば有効にされているコントロールだけをコントロール ビューに含めることもできます。  
+  
+<a name="uiautomation_raw_view"></a>   
+### <a name="raw-view"></a>列ビュー  
+ 未加工のビュー、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーの完全なツリーは、 <xref:System.Windows.Automation.AutomationElement>デスクトップをルート オブジェクトです。 未加工ビューは、アプリケーションのネイティブ プログラムによる構造に忠実に従っているため、使用できるビューの中では最も詳細なビューです。 また、ツリーの他のビューは、未加工ビューに基づいて構築されます。 このビューが、基になる依存[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]フレームワークの未加工のビュー、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)]さまざまな未加工のビューよりも作成したボタンも、 [!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]  ボタンをクリックします。  
+  
+ プロパティを指定せずに要素を検索して、またはを使用して、未加工のビューが取得した、 <xref:System.Windows.Automation.TreeWalker.RawViewWalker>ツリー内で移動します。  
+  
+<a name="uiautomation_control_view"></a>   
+### <a name="control-view"></a>コントロール ビュー  
+ コントロールのビューの[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリーを記述する支援技術製品のタスクを簡略化、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]エンドユーザーを支援することをエンドユーザーとやり取りするアプリケーションに密接にマッピングされるため、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]エンドユーザーによって認識される構造体。  
+  
+ コントロール ビューは、未加工ビューのサブセットです。 すべてが含まれています[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]対話型または内のコントロールの論理構造に関係するいると、エンドユーザーが理解できるように未加工のビューの項目を[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]です。 例として[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]の論理的な構造に影響するアイテム、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]は対話型自体では、ヘッダーを一覧表示する、ツールバー、メニューのおよびステータス バーなどの項目のコンテナーです。 レイアウトや装飾の目的のためだけに使用される非対話型項目は、コントロール ビューには表示されません。 その一例は、パネルです。パネルは、ダイアログでコントロールをレイアウトするためだけに使用され、情報はまったく含まれません。 コントロール ビューに表示される非対話型の項目は、情報を提供するグラフィックとダイアログ内の静的テキストです。 コントロール ビューに含まれる非対話型の項目がキーボード フォーカスを受け取ることはできません。  
+  
+ コントロールのビューを持つ要素を検索して取得した、 <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsControlElement%2A>プロパティに設定`true`、またはを使用して、 <xref:System.Windows.Automation.TreeWalker.ControlViewWalker>ツリー内で移動します。  
+  
+<a name="uiautomation_content_view"></a>   
+### <a name="content-view"></a>コンテンツ ビュー  
+ コンテンツ ビュー、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]ツリー コントロールのビューのサブセットであります。 含まれている[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]ユーザー インターフェイスで真の情報を伝達する項目を含む[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]が受信可能な項目はキーボード フォーカスとなんらかのテキストのラベルではありませんが、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]項目。 たとえば、ドロップダウン コンボ ボックス内の値は、エンドユーザーが使用する情報を表すため、コンテンツ ビューに表示されます。 コンテンツ ビューにコンボ ボックスやリスト ボックスが両方とものコレクションとして表さ[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)]項目の&1; つ以上、または&1; つの項目を選択できます。 コンテンツ ビューの目的は、ユーザーに提示するデータ (つまりコンテンツ) を表示することなので、このビューは、どの項目が常に開かれていて、どの項目が展開または折りたたむことができるかは重要ではありません。  
+  
+ コンテンツ ビューを持つ要素を検索して取得した、 <xref:System.Windows.Automation.AutomationElement.AutomationElementInformation.IsContentElement%2A>プロパティに設定`true`、またはを使用して、 <xref:System.Windows.Automation.TreeWalker.ContentViewWalker>ツリー内で移動します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Automation.AutomationElement>   
+ [UI オートメーションの概要](../../../docs/framework/ui-automation/ui-automation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/use-caching-in-ui-automation.md b/docs/framework/ui-automation/use-caching-in-ui-automation.md
new file mode 100644
index 00000000000..f0436638d3d
--- /dev/null
+++ b/docs/framework/ui-automation/use-caching-in-ui-automation.md
@@ -0,0 +1,71 @@
+---
+title: "Use Caching in UI Automation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "caching, UI Automation"
+  - "UI Automation, caching"
+ms.assetid: ec722dff-6009-4279-b86a-e18d3fa94ebf
+caps.latest.revision: 14
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 14
+---
+# Use Caching in UI Automation
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、<xref:System.Windows.Automation.AutomationElement> プロパティとコントロール パターンのキャッシュを実装する方法について説明します。  
+  
+### キャッシュ要求のアクティブ化  
+  
+1.  <xref:System.Windows.Automation.CacheRequest> を作成します。  
+  
+2.  <xref:System.Windows.Automation.CacheRequest.Add%2A> を使用して、キャッシュするプロパティとパターンを指定します。  
+  
+3.  <xref:System.Windows.Automation.CacheRequest.TreeScope%2A> プロパティを設定することにより、キャッシュのスコープを指定します。  
+  
+4.  <xref:System.Windows.Automation.CacheRequest.TreeFilter%2A> プロパティを設定することにより、サブツリーのビューを指定します。  
+  
+5.  オブジェクトへの完全な参照を取得しないようにして効率化を図りたい場合は、<xref:System.Windows.Automation.CacheRequest.AutomationElementMode%2A> プロパティを <xref:System.Windows.Automation.AutomationElementMode> に設定します。 \(このようにすると、これらのオブジェクトから現在の値を取得できなくなります。\)  
+  
+6.  `using` ブロック内 \([!INCLUDE[TLA#tla_visualbnet](../../../includes/tlasharptla-visualbnet-md.md)] 内の `Using`\) で <xref:System.Windows.Automation.CacheRequest.Activate%2A> を使用して、要求をアクティブ化します。  
+  
+ <xref:System.Windows.Automation.AutomationElement> オブジェクトの取得後、またはイベントのサブスクライブ後に、<xref:System.Windows.Automation.CacheRequest.Pop%2A> を使用するか \(<xref:System.Windows.Automation.CacheRequest.Push%2A> を使用した場合\)、または <xref:System.Windows.Automation.CacheRequest.Activate%2A> で作成したオブジェクトを破棄することにより、要求を非アクティブ化します。 \(<xref:System.Windows.Automation.CacheRequest.Activate%2A> は `using` ブロック内 \([!INCLUDE[TLA#tla_visualbnet](../../../includes/tlasharptla-visualbnet-md.md)] 内の `Using`\) で使用してください。\)  
+  
+### AutomationElement プロパティのキャッシュ  
+  
+1.  <xref:System.Windows.Automation.CacheRequest> がアクティブな間に、<xref:System.Windows.Automation.AutomationElement.FindFirst%2A> または <xref:System.Windows.Automation.AutomationElement.FindAll%2A> を使用して、<xref:System.Windows.Automation.AutomationElement> オブジェクトを取得します。あるいは、<xref:System.Windows.Automation.CacheRequest> がアクティブな間に登録したイベントのソースとして <xref:System.Windows.Automation.AutomationElement> を取得します  \(GetUpdatedCache またはいずれかの <xref:System.Windows.Automation.TreeWalker> メソッドに <xref:System.Windows.Automation.CacheRequest> を渡すことにより、キャッシュを作成することも可能です\)。  
+  
+2.  <xref:System.Windows.Automation.AutomationElement.GetCachedPropertyValue%2A> を使用するか、または <xref:System.Windows.Automation.AutomationElement> の <xref:System.Windows.Automation.AutomationElement.Cached%2A> プロパティからプロパティを取得します。  
+  
+### キャッシュされたパターンとプロパティの取得  
+  
+1.  <xref:System.Windows.Automation.CacheRequest> がアクティブな間に、<xref:System.Windows.Automation.AutomationElement.FindFirst%2A> または <xref:System.Windows.Automation.AutomationElement.FindAll%2A> を使用して、<xref:System.Windows.Automation.AutomationElement> オブジェクトを取得します。あるいは、<xref:System.Windows.Automation.CacheRequest> がアクティブな間に登録したイベントのソースとして <xref:System.Windows.Automation.AutomationElement> を取得します  \(GetUpdatedCache またはいずれかの <xref:System.Windows.Automation.TreeWalker> メソッドに <xref:System.Windows.Automation.CacheRequest> を渡すことにより、キャッシュを作成することも可能です\)。  
+  
+2.  キャッシュされたパターンを取得するために、<xref:System.Windows.Automation.AutomationElement.GetCachedPattern%2A> または <xref:System.Windows.Automation.AutomationElement.TryGetCachedPattern%2A> を使用します。  
+  
+3.  コントロール パターンの `Cached` プロパティからプロパティ値を取得します。  
+  
+## 使用例  
+ 次のコード例は、キャッシュのさまざまな側面を示し、<xref:System.Windows.Automation.CacheRequest.Activate%2A> を使用して <xref:System.Windows.Automation.CacheRequest> をアクティブ化しています。  
+  
+ [!code-csharp[UIAClient_snip#107](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#107)]
+ [!code-vb[UIAClient_snip#107](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#107)]  
+  
+## 使用例  
+ 次のコード例は、キャッシュのさまざまな側面を示し、<xref:System.Windows.Automation.CacheRequest.Push%2A> を使用して <xref:System.Windows.Automation.CacheRequest> をアクティブ化しています。 キャッシュ要求を入れ子にする場合を除き、<xref:System.Windows.Automation.CacheRequest.Activate%2A> を使用する方法をお勧めします。  
+  
+ [!code-csharp[UIAClient_snip#108](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAClient_snip/CSharp/ClientForm.cs#108)]
+ [!code-vb[UIAClient_snip#108](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAClient_snip/VisualBasic/ClientForm.vb#108)]  
+  
+## 参照  
+ [Caching in UI Automation Clients](../../../docs/framework/ui-automation/caching-in-ui-automation-clients.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/use-the-automationid-property.md b/docs/framework/ui-automation/use-the-automationid-property.md
new file mode 100644
index 00000000000..1bcad9ab2f6
--- /dev/null
+++ b/docs/framework/ui-automation/use-the-automationid-property.md
@@ -0,0 +1,66 @@
+---
+title: "Use the AutomationID Property | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AutomationId property"
+  - "UI Automation, AutomationId property"
+  - "properties, AutomationId"
+ms.assetid: a24e807b-d7c3-4e93-ac48-80094c4e1c90
+caps.latest.revision: 21
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 21
+---
+# Use the AutomationID Property
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ このトピックには、<xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> を使用して [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー内の要素を配置する方法とタイミングを示すシナリオおよびサンプル コードが記載されています。  
+  
+ <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> は、UI オートメーション要素をその兄弟から一意に識別します。 コントロール ID に関連するプロパティの識別子の詳細については、「[UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> では、ツリー全体で一意の ID は保証されません。これが役に立つには、通常、コンテナーとスコープ情報が必要です。 たとえば、アプリケーションには複数のトップレベルのメニュー項目を持つメニュー コントロールが含まれ、さらに、それらのメニュー項目に複数の子メニュー項目が含まれている場合があります。 これらの 2 次メニュー項目は、"Item1"、"Item 2" などの汎用スキームで識別され、トップレベルのメニュー項目間で子の識別子が重複することがあります。  
+  
+## シナリオ  
+ 要素を検索するときに、正確で一貫性のある結果を実現するために <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> の使用を必要とする 3 つの主な UI オートメーション クライアント アプリケーションのシナリオが識別されています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> をサポートしているのは、最上位のアプリケーション ウィンドウ以外のコントロール ビューにあるすべての UI オートメーション要素、ID または x:Uid を持たない [!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] コントロールから派生した UI オートメーション要素、およびコントロール ID を持たない [!INCLUDE[TLA#tla_win32](../../../includes/tlasharptla-win32-md.md)] コントロールから派生した UI オートメーション要素です。  
+  
+#### 一意で探索可能な AutomationID を使用して UI オートメーション ツリーで特定の要素を検索する  
+  
+-   [!INCLUDE[TLA#tla_uispy](../../../includes/tlasharptla-uispy-md.md)] などのツールを使用して関心のある [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素の <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> をレポートします。 この値をコピーし、その後の自動テストのテスト スクリプトなどのクライアント アプリケーションに貼り付けることができます。 この方法により、実行時に要素を特定して検索するために必要なコードを削減して簡略化します。  
+  
+> [!CAUTION]
+>  通常、<xref:System.Windows.Automation.AutomationElement.RootElement%2A> の直接の子のみの取得を試行する必要があります。 子孫の検索は、数百または数千もの要素を反復処理する場合があり、スタック オーバーフローを引き起こす可能性があります。 下位レベルの特定の要素を取得しようとする場合、アプリケーション ウィンドウから、または下位レベルのコンテナーから検索を開始する必要があります。  
+  
+ [!code-csharp[UIAAutomationID_snip#100](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAAutomationID_snip/CSharp/FindByAutomationID.xaml.cs#100)]
+ [!code-vb[UIAAutomationID_snip#100](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAAutomationID_snip/VisualBasic/FindByAutomationID.xaml.vb#100)]  
+  
+#### 永続的なパスを使用して、既に特定されている AutomationElement に戻る  
+  
+-   クライアント アプリケーションは \(単純なテスト スクリプトから、堅牢な記録と再生のためのユーティリティまで\)、ファイルを開くダイアログやメニュー項目など、現在インスタンス化されていないために UI オートメーション ツリーに存在しない要素にアクセスしなければならないことがあります。 これらの要素をインスタンス化するには、AutomationID、コントロール パターンとイベント リスナーなどの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを使用することで、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] アクションの特定のシーケンスを再現または「再生」する必要があります。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] を使用し、[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] とのユーザー対話に基づくテスト スクリプトを生成する例については、「[Test Script Generator Sample](http://msdn.microsoft.com/ja-jp/028467fd-2980-4691-9522-0131dcef23a0)」を参照してください。  
+  
+ [!code-csharp[UIAAutomationID_snip#UIAWorkerThread](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAAutomationID_snip/CSharp/FindByAutomationID.xaml.cs#uiaworkerthread)]
+ [!code-vb[UIAAutomationID_snip#UIAWorkerThread](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAAutomationID_snip/VisualBasic/FindByAutomationID.xaml.vb#uiaworkerthread)]  
+[!code-csharp[UIAAutomationID_snip#Playback](../../../samples/snippets/csharp/VS_Snippets_Wpf/UIAAutomationID_snip/CSharp/FindByAutomationID.xaml.cs#playback)]
+[!code-vb[UIAAutomationID_snip#Playback](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UIAAutomationID_snip/VisualBasic/FindByAutomationID.xaml.vb#playback)]  
+  
+#### 相対パスを使用して、既に特定されている AutomationElement に戻る  
+  
+-   特定の状況では、AutomationID が兄弟間でのみ一意であることが保証されているので、UI オートメーション ツリー内の複数の要素が同一の AutomationID プロパティの値を持っていることがあります。 このような場合、親 \(または必要に応じて親の親\) に基づいて、要素を一意に識別できます。 たとえば、開発者が複数のメニュー項目を持ち、それぞれに複数の子メニュー項目があるメニュー バーを提供するとします。ここで、子は "Item1"、"Item2" など、シーケンシャルの AutomationID で識別されます。 各メニュー項目は、それ自体の AutomationID と、その親の AutomationID \(必要に応じて親の親の AutomationID も\) によって一意に識別されます。  
+  
+## 参照  
+ <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty>   
+ [UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)   
+ [Find a UI Automation Element Based on a Property Condition](../../../docs/framework/ui-automation/find-a-ui-automation-element-based-on-a-property-condition.md)
\ No newline at end of file
diff --git a/docs/framework/ui-automation/using-ui-automation-for-automated-testing.md b/docs/framework/ui-automation/using-ui-automation-for-automated-testing.md
new file mode 100644
index 00000000000..a556df716ba
--- /dev/null
+++ b/docs/framework/ui-automation/using-ui-automation-for-automated-testing.md
@@ -0,0 +1,122 @@
+---
+title: "Using UI Automation for Automated Testing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "automated testing"
+  - "testing, UI Automation"
+  - "UI Automation, automated testing"
+ms.assetid: 3a0435c0-a791-4ad7-ba92-a4c1d1231fde
+caps.latest.revision: 26
+author: "Xansky"
+ms.author: "mhopkins"
+manager: "markl"
+caps.handback.revision: 25
+---
+# Using UI Automation for Automated Testing
+> [!NOTE]
+>  このドキュメントは、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] 名前空間で定義されているマネージ <xref:System.Windows.Automation> クラスを使用する .NET Framework 開発者を対象としています。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] の最新情報については、「[Windows Automation API: UI オートメーション](http://go.microsoft.com/fwlink/?LinkID=156746)」を参照してください。  
+  
+ ここでは、自動テストのシナリオで、プログラムによるアクセスのためのフレームワークとして [!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)]がどのように役立つかについて説明します。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の統一されたオブジェクト モデルを使用すると、すべての[!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] フレームワークにおいて、複雑で豊富な機能をアクセシビリティが高く自動化しやすい方法で公開できます。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] は、[!INCLUDE[TLA#tla_aa](../../../includes/tlasharptla-aa-md.md)] の後継として開発されました。[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] は、コントロールとアプリケーションにアクセスできるように設計された既存のフレームワークです。 ユーザー補助と自動化の要件がよく似ているため、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] はテストの自動化に使用されるようになりましたが、この役割を想定して設計されたものではありません。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、ユーザー補助のためのより洗練されたソリューションを提供するだけでなく、信頼性の高い自動テスト機能を提供するように設計されています。 たとえば、[!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] では、UI に関する情報の公開と、AT 製品に必要な情報の収集の両方に、同じインターフェイスを使用します。これに対して [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]では、2 つのモデルを分けています。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を自動テスト ツールとして利用するには、プロバイダーとクライアントの両方にこれを実装する必要があります。 UI オートメーション プロバイダーは、Microsoft Word、Excel やその他のサードパーティ アプリケーションなどのアプリケーション、または [!INCLUDE[TLA#tla_win](../../../includes/tlasharptla-win-md.md)] オペレーティング システムに基づくコントロールです。 UI オートメーション クライアントは、自動テスト スクリプトや支援 \(補助\) 技術アプリケーションなどです。  
+  
+> [!NOTE]
+>  この概要の目的は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の、自動テストに関する新機能と強化された機能について説明することです。 この概要はユーザー補助機能に関する情報の提供を目的とするものではなく、必要な場合以外、ユーザー補助については説明しません。  
+  
+<a name="Using_UI_Automation_During_Development"></a>   
+## プロバイダーにおける UI オートメーション  
+ [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を自動化するためにアプリケーションやコントロールの開発者が注意する必要があるのは、その [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] オブジェクトでキーボードとマウスの標準操作を使用して実行できるエンド ユーザーのアクションです。  
+  
+ これらの主要なアクションを特定したら、対応する [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターン \(つまり、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素の機能と動作をミラー化するコントロール パターン\) をコントロール上に実装します。 たとえば、コンボ ボックス コントロール \(実行用のダイアログなど\) でのユーザー操作には、通常、項目の一覧を非表示にしたり表示したりするためのコンボ ボックスの展開と折りたたみ、一覧からの項目の選択、またはキーボード入力による新しい値の追加が含まれます。  
+  
+> [!NOTE]
+>  他のユーザー補助モデルでは、開発者が直接、個々のボタン、メニューなどのコントロールから情報を収集する必要があります。 しかも、各コントロール型には、細部の異なるバリエーションが多数存在します。 つまり、あるプッシュボタンに 10 個のバリエーションが存在すると、それらすべての動作と機能が同じであっても、それぞれを別個のコントロールとして扱う必要があります。 これらのコントロールが機能的に同等であることを知る方法はありません。 コントロール パターンは、こうした共通のコントロール動作を表すために開発されました。 詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+<a name="Implementing_UI_Automation"></a>   
+### UI オートメーションの実装  
+ 既に述べたように、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の統一されたモデルを使用しない場合、フレームワーク内のコントロールのプロパティや動作を公開するためには、フレームワーク固有の情報をテスト ツールや開発者が知る必要があります。[!INCLUDE[TLA2#tla_win](../../../includes/tla2sharptla-win-md.md)] オペレーティング システム内には常に、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)]、[!INCLUDE[TLA#tla_winforms](../../../includes/tlasharptla-winforms-md.md)]、[!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] などの複数の UI フレームワークが存在する可能性があるため、似たようなコントロールを持つ複数のアプリケーションをテストすることは困難な場合があります。 次の表では、例として、あるボタン コントロールに関連付けられた名前 \(またはテキスト\) を取得するために必要なフレームワーク固有のプロパティ名と、それと同等の単一 [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]プロパティを示します。  
+  
+|UI オートメーション コントロール型|UI フレームワーク|フレームワーク固有のプロパティ|UI Automation のプロパティ|  
+|-------------------------|----------------|---------------------|--------------------------|  
+|ボタン|Windows Presentation Foundation|Content|NameProperty|  
+|ボタン|Win32|\[キャプション\]|NameProperty|  
+|イメージ|HTML|alt|NameProperty|  
+  
+ UI オートメーション プロバイダーは、そのコントロールのフレームワーク固有のプロパティから、同等の [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティへのマッピングを行います。  
+  
+ [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]をプロバイダーに実装する方法については、「[UI Automation Providers for Managed Code](../../../docs/framework/ui-automation/ui-automation-providers-for-managed-code.md)」を参照してください。 コントロール パターンを実装する方法については、「[UI Automation Control Patterns](../../../docs/framework/ui-automation/ui-automation-control-patterns.md)」および「[UI Automation Text Pattern](../../../docs/framework/ui-automation/ui-automation-text-pattern.md)」を参照してください。  
+  
+<a name="Testing_with_UI_Automation"></a>   
+## クライアントにおける UI オートメーション  
+ 多くの自動テスト ツールやシナリオの目的は、一貫性があって再現可能なユーザー インターフェイス操作です。 これには、特定のコントロールの単体テストから、コントロールのグループに対する一連の一般的なアクションを反復処理するテスト スクリプトの記録と再生までが含まれます。  
+  
+ 自動アプリケーションでの問題は、動的な対象にテストを合わせることが難しい点です。 たとえば、Windows タスク マネージャーに含まれているような、現在実行中のアプリケーションを一覧表示するリスト ボックス コントロールがあります。 リスト ボックス内の項目はテスト アプリケーションの制御範囲外で動的に更新されるため、リスト ボックスの特定の項目を一貫性を保って繰り返し選択することは不可能です。 テスト アプリケーションの制御範囲外の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] でフォーカスの単純な変更を繰り返そうとした場合も、同様の問題が起きることがあります。  
+  
+<a name="Programmatic_Access"></a>   
+### プログラムによるアクセス  
+ プログラムによるアクセスでは、従来のマウス入力やキーボード入力によって公開される対話やエクスペリエンスをコードによって模倣する機能が提供されます。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]は、5 つのコンポーネントにより、プログラムによるアクセスを有効にします。  
+  
+-   [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリーは、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の構造全体にわたってナビゲーションを容易にします。 ツリーは、hWnd のツリーのコレクションから構築されます。 詳細については、「[UI Automation Tree Overview](../../../docs/framework/ui-automation/ui-automation-tree-overview.md)」を参照してください。  
+  
+-   オートメーション要素は、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] の個々のコンポーネントです。 通常、これらは hWnd よりも細かい単位です。 詳細については、「[UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)」を参照してください。  
+  
+-   オートメーション プロパティは、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 要素に関する具体的な情報を提供します。 詳細については、「[UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)」を参照してください。  
+  
+-   コントロール パターンは、コントロールが持つ機能の特定の側面を定義します。プロパティ、メソッド、イベント、および構造体の情報で構成することができます。 詳細については、「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。  
+  
+-   オートメーション イベントは、イベント通知と情報を提供します。 詳細については、「[UI Automation Events Overview](../../../docs/framework/ui-automation/ui-automation-events-overview.md)」を参照してください。  
+  
+<a name="Key_properties_critical_to_test_automation"></a>   
+### 自動テストの主要なプロパティ  
+ [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] 内の任意のコントロールを一意に識別して検索する機能は、自動テスト アプリケーションがその [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を処理する基盤です。[!INCLUDE[TLA#tla_uiautomation](../../../includes/tlasharptla-uiautomation-md.md)] プロパティの中にはこれを支援するものがいくつかあり、クライアントとプロバイダーによって使用されます。  
+  
+#### AutomationID  
+ オートメーション要素をその兄弟から一意に識別します。 製品が複数言語で出荷される場合に通常ローカライズされる <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> などのプロパティとは異なり、<xref:System.Windows.Automation.AutomationElement.NameProperty> はローカライズされません。 「[Use the AutomationID Property](../../../docs/framework/ui-automation/use-the-automationid-property.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> では、オートメーション ツリー全体にわたって一意に識別できるとは限りません。 たとえば、アプリケーションには複数のトップレベルのメニュー項目を持つメニュー コントロールが含まれ、さらに、それらのメニュー項目に複数の子メニュー項目が含まれている場合があります。 これらの 2 次メニュー項目は、Item1、Item2、Item3 などの汎用スキームで識別され、トップレベルのメニュー項目間で子の識別子が重複することがあります。  
+  
+#### ControlType  
+ オートメーション要素によって表されるコントロール型を識別します。 コントロール型がわかると、そこから多くの情報を推測できます。 「[UI Automation Control Types Overview](../../../docs/framework/ui-automation/ui-automation-control-types-overview.md)」を参照してください。  
+  
+#### NameProperty  
+ これは、コントロールを識別または説明するテキスト文字列です。<xref:System.Windows.Automation.AutomationElement.NameProperty> はローカライズされる可能性があるため、注意して使用する必要があります。 「[UI Automation Properties Overview](../../../docs/framework/ui-automation/ui-automation-properties-overview.md)」を参照してください。  
+  
+<a name="Steps_Required_To_Automate_the_UI_in_a_Test_Application"></a>   
+### テスト アプリケーションへの UI オートメーションの実装  
+  
+|||  
+|-|-|  
+|UI オートメーション参照を追加します。|UI オートメーション クライアントに必要な [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の dll を次に示します。<br /><br /> -   UIAutomationClient.dll は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]のクライアント側 API へのアクセスを提供します。<br />-   UIAutomationClientSideProvider.dll は、[!INCLUDE[TLA2#tla_win32](../../../includes/tla2sharptla-win32-md.md)] コントロールを自動化する機能を提供します。 「[UI Automation Support for Standard Controls](../../../docs/framework/ui-automation/ui-automation-support-for-standard-controls.md)」を参照してください。<br />-   UIAutomationTypes.dll は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]で定義された特定の型へのアクセスを提供します。|  
+|<xref:System.Windows.Automation> 名前空間を追加します。|この名前空間には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]のテキスト処理以外の機能を使用するために UI オートメーション クライアントが必要とするすべてのものが含まれています。|  
+|<xref:System.Windows.Automation.Text> 名前空間を追加します。|この名前空間には、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]のテキスト処理機能を使用するために UI オートメーション クライアントが必要とするすべてのものが含まれています。|  
+|目的のコントロールを検索します。|自動テスト スクリプトは、目的のコントロールを表す UI オートメーション要素をオートメーション ツリー内で検索します。<br /><br /> コードで UI オートメーション要素を取得する方法は複数あります。<br /><br /> -   [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] ステートメントを使用して <xref:System.Windows.Automation.Condition> を照会します。 この場合は、通常、言語に依存しない <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> を使用します。 **Note:**  <xref:System.Windows.Automation.AutomationElement.AutomationIdProperty> は、コントロールの [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] プロパティを項目別に示すことができる Inspect.exe などのツールを使用して取得できます。 <br /><br /> -   [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] ツリー全体またはそのサブセットを検索するには、<xref:System.Windows.Automation.TreeWalker> クラスを使用します。<br />-   フォーカスを追跡します。<br />-   コントロールの hWnd を使用します。<br />-   マウス カーソルの位置など、画面位置を使用します。<br /><br /> 「[Obtaining UI Automation Elements](../../../docs/framework/ui-automation/obtaining-ui-automation-elements.md)」を参照してください。|  
+|コントロール パターンを取得します。|コントロール パターンは、機能的によく似た複数のコントロールにおける共通の動作を公開します。<br /><br /> 自動テスト スクリプトは、テストする必要があるコントロールを特定すると、それらの UI オートメーション要素から目的のコントロール パターンを取得します。 たとえば、一般的なボタン機能には <xref:System.Windows.Automation.InvokePattern> コントロール パターンを、ウィンドウ機能には <xref:System.Windows.Automation.WindowPattern> コントロール パターンを使用します。<br /><br /> 「[UI Automation Control Patterns Overview](../../../docs/framework/ui-automation/ui-automation-control-patterns-overview.md)」を参照してください。|  
+|UI を自動化します。|自動テスト スクリプトで、[!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] フレームワークの任意の [!INCLUDE[TLA2#tla_ui](../../../includes/tla2sharptla-ui-md.md)] を、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] コントロール パターンによって公開された情報や機能を使用して制御できるようになりました。|  
+  
+<a name="Supporting_tools"></a>   
+## 関連ツールと関連技術  
+ 複数の関連ツールや関連技術で、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を使用した自動テストがサポートされています。  
+  
+-   Inspect.exe は、プロバイダーとクライアントの開発およびデバッグのために [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]の情報を収集するために使用できる[!INCLUDE[TLA#tla_gui](../../../includes/tlasharptla-gui-md.md)] アプリケーションです。Inspect.exe は [!INCLUDE[TLA#tla_winfxsdk](../../../includes/tlasharptla-winfxsdk-md.md)] に含まれています。  
+  
+-   MSAABridge は、[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)] クライアントに対して [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)]情報を公開します。[!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]と [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] の間に継続性を持たせる主な目的は、既存の [!INCLUDE[TLA2#tla_aa](../../../includes/tla2sharptla-aa-md.md)] クライアントが [!INCLUDE[TLA2#tla_uiautomation](../../../includes/tla2sharptla-uiautomation-md.md)]を実装済みの任意のフレームワークと対話できるようにすることです。  
+  
+<a name="Security"></a>   
+## セキュリティ  
+ セキュリティについては、「[UI Automation Security Overview](../../../docs/framework/ui-automation/ui-automation-security-overview.md)」を参照してください。  
+  
+## 参照  
+ [UI Automation Fundamentals](../../../docs/framework/ui-automation/index.md)
\ No newline at end of file
diff --git a/docs/framework/unmanaged-api/TOC.md b/docs/framework/unmanaged-api/TOC.md
new file mode 100644
index 00000000000..0a152748b7a
--- /dev/null
+++ b/docs/framework/unmanaged-api/TOC.md
@@ -0,0 +1,5 @@
+# [共有のデータ型](common-data-types-unmanaged-api-reference.md)
+# [アンマネージ API リファレンス](index.md)
+# [COR_PRF_ALLOWABLE_AFTER_ATTACH ビットマスク](cor-prf-allowable-after-attach-bitmask.md)
+# [定数](constants-unmanaged-api-reference.md)
+# [GUID_ManagedName 属性](guid-managedname-attribute.md)
diff --git a/docs/framework/unmanaged-api/common-data-types-unmanaged-api-reference.md b/docs/framework/unmanaged-api/common-data-types-unmanaged-api-reference.md
new file mode 100644
index 00000000000..a168705bbf0
--- /dev/null
+++ b/docs/framework/unmanaged-api/common-data-types-unmanaged-api-reference.md
@@ -0,0 +1,47 @@
+---
+title: "共有のデータ型 (アンマネージ API リファレンス) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+dev_langs: 
+  - "C++"
+ms.assetid: e4ab2c4c-9433-4eba-9e9a-096de406cafb
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 共有のデータ型 (アンマネージ API リファレンス)
+このトピックでは、C\/C\+\+ `typedef` ステートメントで定義される .NET Framework のアンマネージ API で使用する、簡単なデータ型について示します。 これらのデータ型は通常、C\/C\+\+ のプリミティブ データ型のエイリアスです。 一般的にこれらのデータ型の値は不透明です。これらのデータ型の値は他の関数またはメソッドに対して変更なしで渡せるように、特定の関数またはメソッドによって返されるためです。  
+  
+|データ型|定義|定義されている場所|説明|  
+|----------|--------|---------------|--------|  
+|AppDomainID|`typedef UINT_PTR AppDomainID;`|corprof.h|アプリケーション ドメインの識別子。|  
+|AssemblyID|`typedef UINT_PTR AssemblyID;`|corprof.h|アセンブリの識別子。|  
+|ClassID|`typedef UINT_PTR ClassID;`|corprof.h|マネージ クラスの識別子。|  
+|CONNID|`typedef DWORD CONNID;`|cordebug.h、mscoree.h|Microsoft SQL Server のインスタンスへ接続されるスレッドの接続識別子。|  
+|ContextID|`typedef UINT_PTR ContextID;`|corprof.h|特定のマネージ スレッドに関連付けられているコンテキストの識別子。|  
+|COR\_PRF\_ELT\_INFO|`typedef UINT_PTR COR_PRF_ELT_INFO;`|corprof.h|特定のスタック フレームに関する情報を表す不透明なハンドル。|  
+|COR\_PRF\_FRAME\_INFO|`typedef UINT_PTR COR_PRF_FRAME_INFO;`|corprof.h|スタック フレームを指す不透明なハンドル。 これは、自身が渡されるコールバックの間のみ有効です。|  
+|CORDB\_ADDRESS|`typedef ULONG64 CORDB_ADDRESS;`|cordebug.h|メモリ内アドレス。|  
+|CORDB\_CONTINUE\_STATUS|`typedef DWORD CORDB_CONTINUE_STATUS;`|cordebug.h|継続状態。|  
+|CORDB\_REGISTER|`typedef ULONG64 CORDB_REGISTER;`|cordebug.h|CPU レジスタの値。|  
+|FunctionID|`typedef UINT_PTR FunctionID;`|corprof.h|関数またはメソッドの識別子。|  
+|GCHandleID|`typedef UINT_PTR GCHandleID;`|corprof.h|ガベージ コレクション ハンドル。|  
+|mdToken|`typedef UINT32 mdToken;`|corprof.h|メタデータ トークン \(メタデータ テーブル内の行\)。|  
+|ModuleID|`typedef UINT_PTR ModuleID;`|corprof.h|アセンブリ モジュールの識別子。|  
+|ObjectID|`typedef UINT_PTR ObjectID;`|corprof.h|オブジェクトの識別子。|  
+|ProcessID|`typedef UINT_PTR ProcessID;`|corprof.h|マネージ プロセスの識別子。|  
+|ReJITID|`typedef UINT_PTR ReJITID;`|corprof.h|JIT コンパイルされた関数の識別子。|  
+|TASKID|`typedef UINT64 TASKID;`|cordebug.h、mscoree.h|[ICLRTask](../../../ocs/framework/unmanaged-api/hosting/iclrtask-interface.md) インスタンスの識別子。|  
+|ThreadID|`typedef UINT_PTR ThreadID;`|corprof.h|マネージ スレッドの識別子。|  
+  
+## 参照  
+ [アンマネージ API リファレンス](../../../docs/framework/unmanaged-api/index.md)
\ No newline at end of file
diff --git a/docs/framework/unmanaged-api/constants-unmanaged-api-reference.md b/docs/framework/unmanaged-api/constants-unmanaged-api-reference.md
new file mode 100644
index 00000000000..61ff20c0a31
--- /dev/null
+++ b/docs/framework/unmanaged-api/constants-unmanaged-api-reference.md
@@ -0,0 +1,61 @@
+---
+title: "定数 (アンマネージ API リファレンス) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "アンマネージ API の定数 [.NET Framework]"
+  - "ネイティブの API 参照 [.NET Framework] 定数"
+  - "アンマネージの API 参照 [.NET Framework] 定数"
+ms.assetid: 77526f65-b71c-4483-9d19-3a3751fd8a45
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 定数 (アンマネージ API リファレンス)
+このトピックでは、言語の種類、言語の販売元 CorSym.idl で定義されているドキュメント型の定数を説明します。  
+  
+## 言語の型の定数  
+ 次の表は、言語のプログラミング言語を識別する Guid を表す型の定数を示します。  
+  
+|シンボル|説明|  
+|----------|--------|  
+|CorSym\_LanguageType\_C|C 言語を示します。|  
+|CorSym\_LanguageType\_CPlusPlus|C\+\+ 言語を示します。|  
+|CorSym\_LanguageType\_CSharp|C\# 言語を示します。|  
+|CorSym\_LanguageType\_Basic|基本的な言語を示します。|  
+|CorSym\_LanguageType\_Java|Java 言語を示します。|  
+|CorSym\_LanguageType\_Cobol|COBOL 言語を示します。|  
+|CorSym\_LanguageType\_Pascal|Pascal 形式の言語を示します。|  
+|CorSym\_LanguageType\_ILAssembly|Microsoft 中間言語 \(MSIL\) アセンブリのコードを示します。|  
+|CorSym\_LanguageType\_JScript|JScript 言語を示します。|  
+|CorSym\_LanguageType\_SMC|SMC 言語を示します。|  
+|CorSym\_LanguageType\_MCPlusPlus|.NET Framework の有効な C\+\+ 言語を示します。|  
+  
+## 言語ベンダー定数  
+ 次の表は、仕入先の定数は、プログラミング言語ベンダーを識別する Guid を表す言語を示します。  
+  
+|シンボル|説明|  
+|----------|--------|  
+|CorSym\_LanguageVendor\_Microsoft|Microsoft を示します。|  
+  
+## ドキュメント型定数  
+ 次の表は、ドキュメントの種類のドキュメントを識別する Guid を表す型の定数を示します。  
+  
+|シンボル|説明|  
+|----------|--------|  
+|CorSym\_DocumentType\_Text|テキスト ドキュメントを示します。|  
+|CorSym\_DocumentType\_MC|テキスト以外のドキュメントを示します。|  
+  
+## 参照  
+ [アンマネージ API リファレンス](../../../docs/framework/unmanaged-api/index.md)
\ No newline at end of file
diff --git a/docs/framework/unmanaged-api/cor-prf-allowable-after-attach-bitmask.md b/docs/framework/unmanaged-api/cor-prf-allowable-after-attach-bitmask.md
new file mode 100644
index 00000000000..20c7d81afe8
--- /dev/null
+++ b/docs/framework/unmanaged-api/cor-prf-allowable-after-attach-bitmask.md
@@ -0,0 +1,31 @@
+---
+title: "COR_PRF_ALLOWABLE_AFTER_ATTACH ビットマスク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+apiname: 
+  - "COR_PRF_ALLOWABLE_AFTER_ATTACH"
+apilocation: 
+  - "mscorwks.dll"
+apitype: "COM"
+f1_keywords: 
+  - "COR_PRF_ALLOWABLE_AFTER_ATTACH"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "COR_PRF_ALLOWABLE_AFTER_ATTACH ビットマスク [.NET Framework プロファイリング]"
+ms.assetid: 9326ced8-7609-4ffe-a644-b73cf77607d0
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# COR_PRF_ALLOWABLE_AFTER_ATTACH ビットマスク
+このトピックは使用できなくなりました。 COR\_PRF\_ALLOWABLE\_AFTER\_ATTACH の詳細については、「[COR\_PRF\_MONITOR 列挙型](../../../ocs/framework/unmanaged-api/profiling/cor-prf-monitor-enumeration.md)」のドキュメントを参照してください。
\ No newline at end of file
diff --git a/docs/framework/unmanaged-api/guid-managedname-attribute.md b/docs/framework/unmanaged-api/guid-managedname-attribute.md
new file mode 100644
index 00000000000..8faf2c7998a
--- /dev/null
+++ b/docs/framework/unmanaged-api/guid-managedname-attribute.md
@@ -0,0 +1,75 @@
+---
+title: "GUID_ManagedName 属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+apiname: 
+  - "GUID_ManagedName"
+apilocation: 
+  - "alink.dll"
+apitype: "COM"
+f1_keywords: 
+  - "GUID_ManagedName"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "GUID_ManagedName 属性"
+ms.assetid: 11e18095-e444-47bc-aff6-b887ac5dc01e
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# GUID_ManagedName 属性
+コンポーネント オブジェクト モデル \(COM\) ライブラリの管理対象名前空間名を指定するカスタム インターフェイス属性を定義します。  
+  
+## 構文  
+  
+```  
+[  
+   custom(GUID_ManagedName, value)  
+]  
+```  
+  
+#### パラメーター  
+ `value`  
+ ライブラリの管理対象名前空間の名前。  
+  
+## 定義  
+ `GUID_ManagedName` Cor.h のように定義されています。  
+  
+```  
+// {0F21F359-AB84-41e8-9A78-36D110E6D2F9}  
+EXTERN_GUID(GUID_ManagedName, 0xf21f359, 0xab84, 0x41e8, 0x9a, 0x78, 0x36, 0xd1, 0x10, 0xe6, 0xd2, 0xf9);  
+```  
+  
+## 解説  
+ カスタム インターフェイス属性は、タイプ ライブラリ内のオブジェクトのメタデータを定義します。  
+  
+ 使用 <xref:System.Runtime.InteropServices.ComTypes.ITypeInfo2.GetCustData%2A?displayProperty=fullName> または <xref:System.Runtime.InteropServices.ComTypes.ITypeLib2.GetCustData%2A?displayProperty=fullName> 属性から管理対象の名前を取得します。  
+  
+ 詳細については、次を参照してください。 [Interface Attributes](../Topic/Interface%20Attributes.md) Visual c での説明を参照します。  
+  
+## 使用例  
+ 次の例を使用してライブラリ定義、 `GUID_ManagedName` 属性です。  
+  
+```  
+[  
+   ...  
+   custom(GUID_ManagedName, Microsoft.VisualStudio.CommandBars.dll")  
+]  
+library Microsoft_VisualStudio_CommandBars  
+{  
+   ...  
+}  
+```  
+  
+## 必要条件  
+ **ヘッダー:** Cor.h
\ No newline at end of file
diff --git a/docs/framework/unmanaged-api/index.md b/docs/framework/unmanaged-api/index.md
new file mode 100644
index 00000000000..f51899fef47
--- /dev/null
+++ b/docs/framework/unmanaged-api/index.md
@@ -0,0 +1,72 @@
+---
+title: "アンマネージ API リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+dev_langs: 
+  - "C++"
+helpviewer_keywords: 
+  - "実行時、アンマネージ Api"
+  - "共通言語ランタイム、アンマネージ Api"
+  - "ネイティブ API 参照 [.NET Framework]"
+  - "アンマネージ API 参照 [.NET Framework]"
+ms.assetid: 9aa000ee-c04c-492c-ae4f-83ecdf4fdbbe
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# アンマネージ API リファレンス
+このセクションには、ランタイム ホスト、コンパイラ、逆アセンブラー、難読化ツール、デバッガー、プロファイラーなど、マネージ コード関連のアプリケーションが使用できるアンマネージ API に関する情報が含まれています。  
+  
+## このセクションの内容  
+ [一般的なデータ型](../../../docs/framework/unmanaged-api/common-data-types-unmanaged-api-reference.md)  
+ 特にアンマネージ プロファイリング API とデバッギング API で使用される一般的なデータ型を示します。  
+  
+ [ALink](../../../ml/index.xml)  
+ ALink API について説明します。この API は .NET Framework アセンブリおよび非バインド モジュールの作成をサポートします。  
+  
+ [Authenticode](../../../ml/index.xml)  
+ Authenticode XrML ライセンスの作成および検証モジュールをサポートします。  
+  
+ [定数](../../../docs/framework/unmanaged-api/constants-unmanaged-api-reference.md)  
+ CorSym.idl で定義される定数について説明します。  
+  
+ [カスタム インターフェイス属性](http://msdn.microsoft.com/ja-jp/940952f9-46ad-4a1a-920f-118dc0bdcd9f)  
+ コンポーネント オブジェクト モデル \(COM\) のカスタム インターフェイス属性について説明します。  
+  
+ [デバッグ](../../../ml/index.xml)  
+ デバッグ API について説明します。これによりデバッガーは、共通言語ランタイム \(CLR\) 環境で実行するコードをデバッグできます。  
+  
+ [シンボル ストア診断](../../../ml/index.xml)  
+ シンボル ストア診断 API について説明します。これによりコンパイラは、デバッガーが使用するためのシンボル情報を生成できます。  
+  
+ [Fusion](../../../ml/index.xml)  
+ Fusion API について説明します。これによりランタイム ホストは、アプリケーションに対するリソースの正しいバージョンを見つけるために、アプリケーションのリソースのプロパティにアクセスできます。  
+  
+ [ホスト](../../../ml/index.xml)  
+ ホスト API について説明します。これにより、アンマネージ ホストが CLR をホストのアプリケーションに統合できます。  
+  
+ [メタデータ](../../../ml/index.xml)  
+ メタデータ API について説明します。これによりコンパイラなどのクライアントは、CLR によって読み込まれる型を使用せずに、コンポーネントのメタデータを生成したり、メタデータにアクセスしたりできます。  
+  
+ [プロファイル](../../../ml/index.xml)  
+ プロファイル API について説明します。これによりプロファイラーは CLR によるプログラムの実行を監視できます。  
+  
+ [厳密な名前](../../../ml/index.xml)  
+ 厳密な名前付け API について説明します。これによりクライアントは、アセンブリに対する厳密な名前の署名を管理できます。  
+  
+ [Tlbexp ヘルパー関数](../../../ml/index.xml)  
+ タイプ ライブラリ エクスポーター \(Tlbexp.exe\) がアセンブリからタイプ ライブラリへの変換プロセス中に使用する、2 つのヘルパー関数とインターフェイスについて説明します。  
+  
+## 関連項目  
+ [開発ガイド](../../../docs/framework/development-guide.md)  
+  
+ [.NET Framework の高度な読み取り](http://msdn.microsoft.com/ja-jp/faae8083-fecb-4514-b133-b0a5a32a7c3c)
\ No newline at end of file
diff --git a/docs/framework/wcf/TOC.md b/docs/framework/wcf/TOC.md
new file mode 100644
index 00000000000..0119f70db2a
--- /dev/null
+++ b/docs/framework/wcf/TOC.md
@@ -0,0 +1,111 @@
+# [WCF クライアントの概要](wcf-client-overview.md)
+# [エンドポイントの作成の概要](endpoint-creation-overview.md)
+# [サービスのセキュリティ保護](securing-services.md)
+# [拡張機能の概要](introduction-to-extensibility.md)
+# [方法 : サービス コントラクトでのエラーを宣言する](how-to-declare-faults-in-service-contracts.md)
+# [XML からのデータ型クラスの生成](generating-data-type-classes-from-xml.md)
+# [チュートリアル入門](getting-started-tutorial.md)
+# [クライアントの動作の構成](configuring-client-behaviors.md)
+# [簡略化された構成](simplified-configuration.md)
+# [同期操作と非同期操作](synchronous-and-asynchronous-operations.md)
+# [WCF クライアントを使用したサービスへのアクセス](accessing-services-using-a-wcf-client.md)
+# [方法 : サービス コントラクトを実装する](how-to-implement-a-wcf-contract.md)
+# [WCF のテスト用クライアント (WcfTestClient.exe)](wcf-test-client-wcftestclient-exe.md)
+# [方法 : Windows 資格情報でサービスをセキュリティで保護する](how-to-secure-a-service-with-windows-credentials.md)
+# [クライアントのランタイム動作の指定](specifying-client-run-time-behavior.md)
+# [方法 : クライアントを構成する](how-to-configure-a-basic-wcf-client.md)
+# [WCF のバインディングの概要](bindings-overview.md)
+# [WCF に必要なオペレーティング システム リソース](operating-system-resources-required-by-wcf.md)
+# [構成ファイルを使用してサービスを構成する方法](configuring-services-using-configuration-files.md)
+# [プライバシー情報](privacy-information.md)
+# [WCF サービス発行](wcf-service-publishing.md)
+# [システム要件](wcf-system-requirements.md)
+# [サービスとクライアントを構成するためのバインディングの使用](using-bindings-to-configure-services-and-clients.md)
+# [エラーの定義と指定](defining-and-specifying-faults.md)
+# [ベスト プラクティス : データ コントラクトのバージョン管理](best-practices-data-contract-versioning.md)
+# [サービスの構成](configuring-services.md)
+# [エンドポイント](endpoints.md)
+# [フィードバックとコミュニティ](feedback-and-community.md)
+# [WCF および .NET Framework のクライアント プロファイル](wcf-and-net-framework-client-profile.md)
+# [秘密キー検索ツール (FindPrivateKey.exe)](find-private-key-tool-findprivatekey-exe.md)
+# [一般的なリファレンス](general-reference.md)
+# [サービス コントラクトの実装](implementing-service-contracts.md)
+# [エンドポイント アドレスの指定](specifying-an-endpoint-address.md)
+# [wsatConfig.exe によって返されたエラー コードの解釈](interpreting-error-codes-returned-by-wsatconfig-exe.md)
+# [WCF トラブルシューティング クイックスタート](wcf-troubleshooting-quickstart.md)
+# [コントラクトおよびサービスのエラーの指定と処理](specifying-and-handling-faults-in-contracts-and-services.md)
+# [方法 : クライアントを作成する](how-to-create-a-wcf-client.md)
+# [Windows Communication Foundation のアーキテクチャ](architecture.md)
+# [WCF ライブラリ プロジェクトの配置](deploying-a-wcf-library-project.md)
+# [ワークフロー サービス登録ツール (WFServicesReg.exe)](workflow-service-registration-tool-wfservicesreg-exe.md)
+# [.NET Framework 4 で実行されている IIS 内の .NET Framework 3.5 で作成された WCF サービスをホストする方法](host-a-wcf-service-net-framework-3-5-iis--net-framework-4.md)
+# [リソース消費の制御とパフォーマンスの向上](controlling-resource-consumption-and-improving-performance.md)
+# [サービスのバインディングの構成](configuring-bindings-for-wcf-services.md)
+# [WCF を使用したサービス指向アプリケーション](developing-service-oriented-applications-with-wcf.md)
+# [WS-I Basic Profile 1.1 の相互運用可能サービスの作成](creating-ws-i-basic-profile-1-1-interoperable-services.md)
+# [サービス トレース ビューアー ツール (SvcTraceViewer.exe)](service-trace-viewer-tool-svctraceviewer-exe.md)
+# [サービス コントラクトの設計](designing-service-contracts.md)
+# [方法 : 構成でサービス バインディングを指定する](how-to-specify-a-service-binding-in-configuration.md)
+# [セッションの使用](using-sessions.md)
+# [サービスとトランザクション](services-and-transactions.md)
+# [WCF サービス ホスト (WcfSvcHost.exe)](wcf-service-host-wcfsvchost-exe.md)
+# [バインディング](bindings.md)
+# [方法 : クライアントの資格情報の値を指定する](how-to-specify-client-credential-values.md)
+# [Windows Communication Foundation 4.5 の新機能](whats-new.md)
+# [基本的なプログラミング ライフサイクル](basic-programming-lifecycle.md)
+# [エラーの送受信](sending-and-receiving-faults.md)
+# [COM+ サービス モデル構成ツール (ComSvcConfig.exe)](com-service-model-configuration-tool-comsvcconfig-exe.md)
+# [方法 : セキュリティ モードを設定する](how-to-set-the-security-mode.md)
+# [方法 : コード内でクライアント バインディングを指定する](how-to-specify-a-client-binding-in-code.md)
+# [WCF サービス ホストの自動起動の制御](controlling-auto-launching-of-wcf-service-host.md)
+# [WCF Visual Studio テンプレート](wcf-vs-templates.md)
+# [チュートリアル入門のトラブルシューティング](troubleshooting-the-getting-started-tutorial.md)
+# [方法 : サービス コントラクトを定義する](how-to-define-a-wcf-service-contract.md)
+# [方法 : コード内でサービス バインディングを指定する](how-to-specify-a-service-binding-in-code.md)
+# [ポータブル サブセット プロジェクトでサービス参照を追加する](add-service-reference-in-a-portable-subset-project.md)
+# [方法 : マネージ アプリケーションで WCF サービスをホストする](how-to-host-a-wcf-service-in-a-managed-application.md)
+# [サービスのランタイム動作の指定](specifying-service-run-time-behavior.md)
+# [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](how-to-restrict-access-with-the-principalpermissionattribute-class.md)
+# [ガイドラインとベスト プラクティス](guidelines-and-best-practices.md)
+# [概念](conceptual-overview.md)
+# [方法 : 非同期サービス操作を実装する](how-to-implement-an-asynchronous-service-operation.md)
+# [方法 : 構成でクライアント バインディングを指定する](how-to-specify-a-client-binding-in-configuration.md)
+# [WCF の単純化機能](wcf-simplification-features.md)
+# [クライアントのセキュリティ保護](securing-clients.md)
+# [方法 : サービスでクライアントに偽装する](how-to-impersonate-a-client-on-a-service.md)
+# [Windows Communication Foundation とは](whats-wcf.md)
+# [Windows Communication Foundation の基本概念](fundamental-concepts.md)
+# [方法 : ProtectionLevel プロパティを設定する](how-to-set-the-protectionlevel-property.md)
+# [基本的な WCF プログラミング](basic-wcf-programming.md)
+# [Windows Communication Foundation 用語集](glossary.md)
+# [Windows Communication Foundation ツール](tools.md)
+# [ServiceModel 登録ツール (ServiceModelReg.exe)](servicemodelreg-exe.md)
+# [方法 : セキュリティ コンテキストを調べる](how-to-examine-the-security-context.md)
+# [サービスのバージョン管理](service-versioning.md)
+# [方法 : 基本的なサービスをホストおよび実行する](how-to-host-and-run-a-basic-wcf-service.md)
+# [構成エディター ツール (SvcConfigEditor.exe)](configuration-editor-tool-svcconfigeditor-exe.md)
+# [ベスト プラクティス: 中継局](best-practices-intermediaries.md)
+# [システム標準のバインディング](system-provided-bindings.md)
+# [ドキュメントのガイド](guide-to-the-documentation.md)
+# [メタデータ エンドポイントを公開する](publishing-metadata-endpoints.md)
+# [クライアントを構築する](building-clients.md)
+# [WS-AtomicTransaction 構成 MMC スナップイン](ws-atomictransaction-configuration-mmc-snap-in.md)
+# [WCF エラー処理](wcf-error-handling.md)
+# [WS-AtomicTransaction 構成ユーティリティ (wsatConfig.exe)](ws-atomictransaction-configuration-utility-wsatconfig-exe.md)
+# [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](servicemodel-metadata-utility-tool-svcutil-exe.md)
+# [ClickOnce を使用して WCF アプリケーションを展開する](deploying-wcf-applications-with-clickonce.md)
+# [コード内での WCF サービスの構成](configuring-wcf-services-in-code.md)
+# [ホスティング サービス](hosting-services.md)
+# [方法 : クライアントを使用する](how-to-use-a-wcf-client.md)
+# [.NET リモート処理から WCF への移行](migrating-from-net-remoting-to-wcf.md)
+# [セットアップ問題のトラブルシューティング](troubleshooting-setup-issues.md)
+# [Windows Communication Foundation](index.md)
+# [負荷分散](load-balancing.md)
+# [WCF サービス名の変更](renaming-a-wcf-service.md)
+# [方法 : クライアントの資格情報の種類を指定する](how-to-specify-the-client-credential-type.md)
+# [保護レベルの理解](understanding-protection-level.md)
+# [コントラクト優先ツール](contract-first-tool.md)
+# [WCF と ASP.NET Web API](wcf-and-aspnet-web-api.md)
+# [信頼できるサービス](reliable-services.md)
+# [WCF 開発ツールの使用](using-the-wcf-development-tools.md)
+# [サービスの設計と実装](designing-and-implementing-services.md)
diff --git a/docs/framework/wcf/accessing-services-using-a-wcf-client.md b/docs/framework/wcf/accessing-services-using-a-wcf-client.md
new file mode 100644
index 00000000000..19f2f4b584e
--- /dev/null
+++ b/docs/framework/wcf/accessing-services-using-a-wcf-client.md
@@ -0,0 +1,196 @@
+---
+title: "WCF クライアントを使用したサービスへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "クライアント [WCF], サービスの利用"
+ms.assetid: d780af9f-73c5-42db-9e52-077a5e4de7fe
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# WCF クライアントを使用したサービスへのアクセス
+サービスを作成したら、次に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを作成します。  クライアント アプリケーションは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを使用してサービスと通信します。  通常、クライアント アプリケーションはサービスのメタデータをインポートし、サービスを呼び出すことのできる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント コードを生成します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを作成するための基本手順は、次のとおりです。  
+  
+1.  サービス コードをコンパイルします。  
+  
+2.  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを生成します。  
+  
+3.  WCF クライアント プロキシをインスタンス化します。  
+  
+ WCF クライアント プロキシは、サービス モデル メタデータ ユーティリティ ツール \(SvcUtil.exe\) を使って手動で生成できます。詳細については、「[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)」を参照してください。  WCF クライアント プロキシは、Visual Studio の "サービス参照の追加" 機能を使って生成することもできます。  いずれかの方法で WCF クライアント プロキシを生成するには、サービスが実行中であることが必要です。  サービスが自己ホスト型の場合は、ホストを実行する必要があります。  サービスが IIS\/WAS でホストされている場合、特に必要な操作はありません。  
+  
+## ServiceModel メタデータ ユーティリティ ツール  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールは、メタデータからコードを生成するコマンド ライン ツールです。  基本的な Svcutil.exe コマンドの使用例を次に示します。  
+  
+```  
+Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+```  
+  
+ また、Svcutil.exe は、ファイル システム上の Web サービス記述言語 \(WSDL\) ファイルや XML スキーマ定義言語 \(XSD\) ファイルを指定して使用することもできます。  
+  
+```  
+Svcutil.exe <list of WSDL and XSD files on file system>  
+```  
+  
+ 結果として、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント コードが格納されたコード ファイルが作成されます。クライアント アプリケーションはこのコードを使用してサービスを呼び出すことができます。  
+  
+ このツールを使用して構成ファイルを生成することもできます。  
+  
+```  
+Svcutil.exe <file1 [,file2]>  
+```  
+  
+ ファイル名を 1 つだけ指定した場合、それは出力ファイルの名前になります。  ファイル名を 2 つ指定した場合は、1 番目のファイルが入力構成ファイルになり、そのファイルの内容と生成された構成がマージされ、2 番目のファイルに書き出されます。  構成[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービスのバインディングの構成](../../../docs/framework/wcf/configuring-bindings-for-wcf-services.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  セキュリティで保護されていないメタデータ要求には、セキュリティで保護されていないネットワーク要求と同様の一定の危険が伴います。通信先のエンドポイントが、本当に相手から通知されたとおりのエンドポイントかどうかわからない場合、取得した情報は悪質なサービスからのメタデータである可能性があります。  
+  
+## Visual Studio の "サービス参照の追加"  
+ サービスを実行した状態で、WCF クライアント プロキシを含むプロジェクトを右クリックし、**\[サービス参照の追加\]** を選択します。  **\[サービス参照の追加\]** ダイアログ ボックスで、呼び出すサービスの URL を入力し、**\[移動\]** をクリックします。  このダイアログ ボックスには、指定したアドレスで利用可能なサービスの一覧が表示されます。  サービスをダブルクリックすると、利用可能なコントラクトと操作が表示されるので、生成されたコードの名前空間を指定して、**\[OK\]** をクリックします。  
+  
+## 例  
+ サービス用に作成されたコントラクトのコード例を次に示します。  
+  
+```csharp  
+// Define a service contract.  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    // Other methods are not shown here.  
+}  
+```  
+  
+```vb  
+' Define a service contract.  
+<ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")> _  
+Public Interface ICalculator  
+    <OperationContract()>  _  
+    Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double   
+    ' Other methods are not shown here.  
+End Interface   
+```  
+  
+ ServiceModel メタデータ ユーティリティ ツールと、Visual Studio の "サービス参照の追加" により、次の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント クラスが生成されます。  このクラスは <xref:System.ServiceModel.ClientBase%601> ジェネリック クラスから継承されたもので、`ICalculator` インターフェイスを実装します。  このツールは、`ICalculator` インターフェイス \(この例には表示されていません\) も生成します。  
+  
+```csharp  
+public partial class CalculatorClient : System.ServiceModel.ClientBase<ICalculator>, ICalculator  
+{  
+    public CalculatorClient(){}  
+  
+    public CalculatorClient(string configurationName) :   
+            base(configurationName)  
+    {}  
+  
+    public CalculatorClient(System.ServiceModel.Binding binding) :   
+            base(binding)  
+    {}  
+  
+    public CalculatorClient(System.ServiceModel.EndpointAddress address,  
+    System.ServiceModel.Binding binding) :   
+            base(address, binding)  
+    {}  
+  
+    public double Add(double n1, double n2)  
+    {  
+        return base.InnerChannel.Add(n1, n2);  
+    }  
+}  
+  
+```  
+  
+```vb  
+Partial Public Class CalculatorClient  
+    Inherits System.ServiceModel.ClientBase(Of ICalculator)  
+    Implements ICalculator  
+  
+    Public Sub New()  
+        MyBase.New  
+    End Sub  
+  
+    Public Sub New(ByVal configurationName As String)  
+        MyBase.New(configurationName)  
+    End Sub  
+  
+    Public Sub New(ByVal binding As System.ServiceModel.Binding)  
+        MyBase.New(binding)  
+    End Sub  
+  
+    Public Sub New(ByVal address As _  
+    System.ServiceModel.EndpointAddress, _  
+    ByVal binding As System.ServiceModel.Binding)  
+        MyBase.New(address, binding)  
+    End Sub  
+  
+    Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As _  
+    Double Implements ICalculator.Add  
+        Return MyBase.InnerChannel.Add(n1, n2)  
+    End Function   
+End Class  
+  
+```  
+  
+## WCF クライアントの使用  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを使用するには、次のコードのように [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのインスタンスを作成し、次にそのメソッドを呼び出します。  
+  
+```csharp  
+// Create a client object with the given client endpoint configuration.  
+CalculatorClient calcClient = new CalculatorClient("CalculatorEndpoint"));  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = calcClient.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+```  
+  
+```vb  
+' Create a client object with the given client endpoint configuration.  
+Dim calcClient As CalculatorClient = _  
+New CalculatorClient("CalculatorEndpoint")  
+  
+' Call the Add service operation.  
+Dim value1 As Double = 100.00D  
+Dim value2 As Double = 15.99D  
+Dim result As Double = calcClient.Add(value1, value2)  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)  
+  
+```  
+  
+## クライアントによってスローされた例外のデバッグ  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントからスローされる例外の多くは、サービスで発生した例外が原因となって引き起こされます。  いくつかの例を次に示します。  
+  
+-   <xref:System.Net.Sockets.SocketException>: 既存の接続がリモート ホストによって強制終了されました。  
+  
+-   <xref:System.ServiceModel.CommunicationException>: 基になる接続が予期せずに閉じられました。  
+  
+-   <xref:System.ServiceModel.CommunicationObjectAbortedException>: ソケット接続が中止されました。  これは、メッセージ処理時のエラー、リモート ホストでの受信タイムアウトの超過、または基になるネットワーク リソースの問題が原因で発生する可能性があります。  
+  
+ このような種類の例外が発生した場合、問題を解決するには、サービス側でトレースをオンにし、そこで発生した例外を特定することをお勧めします。  トレース[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[トレース](../../../docs/framework/wcf/diagnostics/tracing/index.md)」および「[トレースを使用したアプリケーションのトラブルシューティング](../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)」を参照してください。  
+  
+## 参照  
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)   
+ [方法 : サービス操作を非同期に呼び出す](../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)   
+ [方法 : 一方向コントラクトと要求\/応答コントラクトを使用してサービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md)   
+ [方法 : WSE 3.0 サービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md)   
+ [生成されたクライアント コードの理解](../../../docs/framework/wcf/feature-details/understanding-generated-client-code.md)   
+ [方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)   
+ [クライアントのランタイム動作の指定](../../../docs/framework/wcf/specifying-client-run-time-behavior.md)   
+ [クライアントの動作の構成](../../../docs/framework/wcf/configuring-client-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/add-service-reference-in-a-portable-subset-project.md b/docs/framework/wcf/add-service-reference-in-a-portable-subset-project.md
new file mode 100644
index 00000000000..d6fb53ae333
--- /dev/null
+++ b/docs/framework/wcf/add-service-reference-in-a-portable-subset-project.md
@@ -0,0 +1,55 @@
+---
+title: "ポータブル サブセット プロジェクトでサービス参照を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61ccfe0f-a34b-40ca-8f5e-725fa1b8095e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ポータブル サブセット プロジェクトでサービス参照を追加する
+ポータブル サブセット プロジェクトにより、.NET アセンブリ プログラマは 1 つのソース ツリーを保持しつつ、システムを構築できるようになります。また、ポータブル サブセット プロジェクトは、複数の .NET プラットフォーム \(デスクトップ、Silverlight、Windows Phone、および XBOX\) をサポートしています。ポータブル サブセット プロジェクトは、コア .NET プラットフォームで使用できる .NET Framework アセンブリである .NET ポータブル ライブラリのみを参照します。  
+  
+## サービス参照の追加の詳細  
+ ポータブル サブセット プロジェクトでサービス参照を追加する場合は、次の制限が適用されます。  
+  
+1.  <xref:System.Xml.Serialization.XmlSerializer> では、文字エンコーディングのみを使用できます。SOAP エンコーディングを使用すると、インポート中にエラーが発生します。  
+  
+2.  <xref:System.Runtime.Serialization.DataContractSerializer> シナリオを使用するサービスの場合、再利用された型をポータブル サブセットからのみ受け取ることを確認するために、データ コントラクト サロゲートが提供されます。  
+  
+3.  ポータブル ライブラリでサポートされていないバインド \(<xref:System.ServiceModel.BasicHttpBinding>、トランザクション フロー、信頼できるセッション、または MTOM エンコーディングがない <xref:System.ServiceModel.WsHttpBinding>、および等価のカスタム バインドを除くすべてのバインド\) に依存するエンドポイントは無視されます。  
+  
+4.  メッセージ ヘッダーは、インポート前にすべての操作におけるすべてのメッセージの説明から削除されます。  
+  
+5.  非ポータブル属性 \(<xref:System.ComponentModel.DesignerCategoryAttribute>、<xref:System.Serializable>、および <xref:System.ServiceModel.TransactionFlow>\) は、生成されたクライアント プロキシ コードから削除されます。  
+  
+6.  非ポータブル プロパティ \(ProtectionLevel、SessionMode、IsInitiating、IsTerminating\) は、<xref:System.ServiceModel.ServiceContractAttribute>、<xref:System.ServiceModel.OperationContract>、および <xref:System.ServiceModel.FaultContract> から削除されます。  
+  
+7.  すべてのサービス操作は、クライアント プロキシ上で非同期操作として生成されます。  
+  
+8.  非ポータブル型を使用する生成済みのクライアント コンストラクターは削除されます。  
+  
+9. <xref:System.Net.CookieContainer> インスタンスは、生成されたクライアントで公開されます。  
+  
+10. コード ジェネレーターのアセンブリとバージョンを示すコメント "`// This code was auto-generated by Microsoft.VisualStudio.Portable.AddServiceReference, version 1.0.0.0`" がファイルの先頭に挿入されます。  
+  
+11. <xref:System.Runtime.Serialization.ISerializable> インターフェイスはサポートされません。  
+  
+12. Net.Tcp および PollingDuplex バインドはサポートされません。  
+  
+13. <xref:System.Runtime.Serialization.DataContractSerializer> は常にエラーに対して使用されます。  
+  
+14. ポータブル サブセット プロジェクトでは <xref:System.ServiceModel.MessageContractAttribute.IsWrapped%2A> はサポートされません。  
+  
+## 参照  
+ [WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)   
+ [汎用性のあるクラス ライブラリ](http://msdn.microsoft.com/library/gg597391\(v=vs.110\))
\ No newline at end of file
diff --git a/docs/framework/wcf/architecture.md b/docs/framework/wcf/architecture.md
new file mode 100644
index 00000000000..28e26f89866
--- /dev/null
+++ b/docs/framework/wcf/architecture.md
@@ -0,0 +1,57 @@
+---
+title: "Windows Communication Foundation のアーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アーキテクチャ [WCF]"
+  - "WCF [WCF], アーキテクチャ"
+  - "Windows Communication Foundation [WCF], アーキテクチャ"
+ms.assetid: a3bcb0a1-56ea-4ba6-9736-d260d90dade5
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Windows Communication Foundation のアーキテクチャ
+次の図は、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アーキテクチャの主要なレイヤーを示しています。  
+  
+## WCF アーキテクチャ  
+ ![WCF アーキテクチャ](../../../docs/framework/wcf/media/wcf-architecture.gif "WCF\_Architecture")  
+  
+### コントラクトと記述  
+ コントラクトは、メッセージ システムのさまざまな側面を定義します。データ コントラクトには、サービスが作成または処理できるすべてのメッセージを構成するすべてのパラメーターが記述されます。メッセージ パラメーターは、XML を理解できるすべてのシステムがドキュメントを処理できるように XML スキーマ定義言語 \(XSD\) ドキュメントによって定義されます。メッセージ コントラクトは、SOAP プロトコルを使用する特定のメッセージ部分を定義し、相互運用性機能によって正確さが要求される場合に、よりきめ細かな制御を許可します。サービス コントラクトは、サービスの実際のメソッド署名を指定し、サポートされているプログラミング言語のいずれか \(Visual Basic や Visual C\# など\) で記述されたインターフェイスとして配布されます。  
+  
+ ポリシーとバインディングは、サービスとの通信に必要な条件を規定します。たとえば、バインディングでは、使用するトランスポート \(HTTP や TCP など\) とエンコーディングを少なくとも指定する必要があります。ポリシーには、セキュリティ要件、およびサービスと通信するために満たす必要があるその他の条件が含まれます。  
+  
+### サービス ランタイム  
+ サービス ランタイム レイヤーには、サービスの実際の操作の実行中にのみ発生する動作 \(つまり、サービスのランタイム動作\) が含まれます。調整コントロールでは、処理されるメッセージの数を制御します。サービスの需要が事前設定した上限に達した場合は、この数を変更できます。エラー動作では、サービスで内部エラーが発生した場合の処理方法 \(たとえば、クライアントに伝達される情報を制御するなど\) を指定します \(情報の量が多すぎると、悪意のあるユーザーに攻撃のきっかけを与える可能性があります\)。メタデータの動作では、メタデータを外部に公開するかどうか、およびその方法を制御します。インスタンスの動作では、サービスのインスタンスをいくつ実行できるかを指定します \(たとえば、シングルトンは、1 つのインスタンスですべてのメッセージを処理するように指定します\)。トランザクションの動作では、エラーが発生した場合にトランザクション操作をロールバックできるようにします。ディスパッチの動作では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インフラストラクチャによるメッセージの処理方法を制御します。  
+  
+ 拡張機能を使用すると、ランタイム プロセスをカスタマイズできます。たとえば、メッセージの検査はメッセージの各部分を検査する機能です。また、パラメーターのフィルター処理を使用すると、メッセージ ヘッダーに作用するフィルターに基づいて、事前設定されたアクションを実行できます。  
+  
+### メッセージング  
+ メッセージング レイヤーは、*チャネル*で構成されます。チャネルは、何らかの方法 \(たとえば、メッセージを認証するなど\) によってメッセージを処理するコンポーネントです。チャネルのセットは、*チャネル スタック*とも呼ばれます。チャネルは、メッセージおよびメッセージ ヘッダーに対して作用します。これは、主にメッセージ本文の内容の処理に関係するサービス ランタイム レイヤーとは異なります。  
+  
+ チャネルの種類としては、トランスポート チャネルとプロトコル チャネルの 2 つがあります。  
+  
+ トランスポート チャネルは、ネットワーク \(または外部との通信ポイント\) からのメッセージの読み取りと書き込みを行います。一部のトランスポートはエンコーダーを使用して、\(XML Infoset として表現される\) メッセージを、ネットワークで使用されるバイト ストリーム表現に \(またはその逆に\) 変換します。トランスポートの例としては、HTTP、名前付きパイプ、TCP、MSMQ などがあります。エンコーディングの例としては、XML と最適化されたバイナリがあります。  
+  
+ プロトコル チャネルは、メッセージ処理プロトコルを実装します。多くの場合、これはメッセージから追加のヘッダーを読み取るまたは書き込むことによって行います。このようなプロトコルの例としては、WS\-Security と WS\-Reliability があります。  
+  
+ メッセージング レイヤーは、データに使用できる形式と交換パターンを示します。WS\-Security は、メッセージ レイヤーでのセキュリティを有効にする WS\-Security 仕様の実装です。WS\-ReliableMessaging チャネルは、メッセージ配信の保証を有効にします。エンコーダーは、メッセージのニーズに合わせて使用できるさまざまなエンコーディングを提供します。HTTP チャネルは、ハイパーテキスト転送プロトコルをメッセージ配信に使用することを指定します。同様に、TCP チャネルは TCP プロトコルを指定します。トランザクション フロー チャネルは、トランザクション メッセージ パターンを制御します。名前付きパイプ チャネルは、プロセス間通信を有効にします。MSMQ チャネルは、MSMQ アプリケーションとの相互運用を有効にします。  
+  
+### ホストとアクティブ化  
+ サービスの最終的な形はプログラムです。他のプログラムと同様、サービスは実行可能ファイルで実行される必要があります。これは、*自己ホスト*サービスと呼ばれます。  
+  
+ また、サービスは、IIS や Windows アクティブ化サービス \(WAS\) などの外部エージェントによって管理されている実行可能ファイルで*ホスト*、つまり実行することもできます。WAS を使用した場合、WAS を実行しているコンピューター上で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションを展開すると、自動的にそのアプリケーションをアクティブ化できます。サービスは、実行可能ファイル \(.exe ファイル\) として手動で実行することもできます。また、Windows サービスとして自動的に実行することもできます。COM\+ コンポーネントを、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとしてホストすることもできます。  
+  
+## 参照  
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)   
+ [Windows Communication Foundation の基本概念](../../../docs/framework/wcf/fundamental-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/basic-programming-lifecycle.md b/docs/framework/wcf/basic-programming-lifecycle.md
new file mode 100644
index 00000000000..7676c106197
--- /dev/null
+++ b/docs/framework/wcf/basic-programming-lifecycle.md
@@ -0,0 +1,45 @@
+---
+title: "基本的なプログラミング ライフサイクル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービスの作成 [WCF]"
+ms.assetid: 7cf21bfe-23bd-46aa-8033-609f851dbf76
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# 基本的なプログラミング ライフサイクル
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、アプリケーションは、同一のコンピューター上、インターネット上、異なるアプリケーション プラットフォーム上のいずれに存在しても、通信できます。ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションを構築するために必要な作業について説明します。実際に動作するサンプル アプリケーションについては、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+## 基本的な作業  
+ 基本的な作業は、次の順序で行います。  
+  
+1.  サービス コントラクトを定義します。サービス コントラクトでは、サービスの署名、交換するデータ、およびコントラクトに必要なその他のデータを指定します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md).  
+  
+2.  コントラクトを実装します。サービス コントラクトを実装するには、そのコントラクトを実装するクラスを作成し、ランタイムに必要なカスタム動作を指定します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md).  
+  
+3.  エンドポイントおよびその他の動作情報を指定して、サービスを構成します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービスの構成](../../../docs/framework/wcf/configuring-services.md).  
+  
+4.  サービスをホストします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ホスティング サービス](../../../docs/framework/wcf/hosting-services.md).  
+  
+5.  クライアント アプリケーションを構築します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][クライアントを構築する](../../../docs/framework/wcf/building-clients.md).  
+  
+ このセクションのトピックではこの順に従って説明しますが、手順を最初から実行しないシナリオもあります。たとえば、既存のサービスを使用するクライアントを構築する場合は、手順 5. から開始します。また、既存のクライアント アプリケーションが使用するサービスを構築する場合は、手順 5. を省略できます。  
+  
+ サービス コントラクトの開発について理解したら、「[拡張機能の概要](../../../docs/framework/wcf/introduction-to-extensibility.md)」にも目を通します。サービスで問題が発生した場合は、「[WCF トラブルシューティング クイックスタート](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md)」をチェックし、同様の問題が他のサービスで発生していないかどうかを確認してください。  
+  
+## 参照  
+ [サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/basic-wcf-programming.md b/docs/framework/wcf/basic-wcf-programming.md
new file mode 100644
index 00000000000..08eef9b8731
--- /dev/null
+++ b/docs/framework/wcf/basic-wcf-programming.md
@@ -0,0 +1,80 @@
+---
+title: "基本的な WCF プログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "基本的なプログラミング [WCF]"
+  - "WCF [WCF], 基本的なプログラミング"
+  - "WCF [WCF], プログラミング"
+  - "Windows Communication Foundation [WCF], 基本的なプログラミング"
+  - "Windows Communication Foundation [WCF], プログラミング"
+ms.assetid: 3ae3d498-f43c-4ecc-8cc0-6cbe36b62593
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# 基本的な WCF プログラミング
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションを作成するときの基本を示します。  
+  
+## このセクションの内容  
+ [基本的なプログラミング ライフサイクル](../../../docs/framework/wcf/basic-programming-lifecycle.md)  
+ 設計、ビルド、展開から成る [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスおよびクライアント アプリケーションのライフサイクルについて説明します。  
+  
+ [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)  
+ サービス コントラクトの設計および実装方法、メッセージ交換パターンの選択方法、エラー コントラクトの指定方法、およびその他のサービスの基本的な側面について説明します。  
+  
+ [サービスの構成](../../../docs/framework/wcf/configuring-services.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを構成して、コントラクト要件のサポート、ローカル ランタイム動作のカスタマイズ、およびサービスを公開するアドレスの指定を行う方法について説明します。  
+  
+ [ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)  
+ アプリケーションでサービスをホストするときの基本について説明します。  
+  
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)  
+ サービスからのメタデータの取得、取得したメタデータの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント コードへの変換、セキュリティ問題の処理、および [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのビルド、構成、ホスティングを行う方法について説明します。  
+  
+ [拡張機能の概要](../../../docs/framework/wcf/introduction-to-extensibility.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を拡張してカスタム ソリューションを作成する方法について説明します。  
+  
+ [WCF トラブルシューティング クイックスタート](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md)  
+ 最も起こりやすい問題の一部を挙げ、その問題の解決方法とその問題の詳細情報を掲載している場所について説明します。  
+  
+ [WCF と ASP.NET Web API](../../../docs/framework/wcf/wcf-and-aspnet-web-api.md)  
+ 2 つのテクノロジ、そのテクノロジの相互関係、およびそのテクノロジを使用するタイミングについて説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Description>  
+  
+## 関連項目  
+ [システム要件](../../../docs/framework/wcf/wcf-system-requirements.md)  
+  
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)  
+  
+ [チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)  
+  
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)  
+  
+ [Windows Communication Foundation ツール](../../../docs/framework/wcf/tools.md)  
+  
+ [Windows Communication Foundation Samples](http://msdn.microsoft.com/ja-jp/8ec9d192-5d81-4f64-bfd3-90c5e5858c91)  
+  
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)  
+  
+ [インライン コードを使用した IIS ホスティング](../../../docs/framework/wcf/samples/iis-hosting-using-inline-code.md)  
+  
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/best-practices-data-contract-versioning.md b/docs/framework/wcf/best-practices-data-contract-versioning.md
new file mode 100644
index 00000000000..ab25f21b7c2
--- /dev/null
+++ b/docs/framework/wcf/best-practices-data-contract-versioning.md
@@ -0,0 +1,117 @@
+---
+title: "ベスト プラクティス : データ コントラクトのバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "ベスト プラクティス [WCF], データ コントラクトのバージョン管理"
+  - "データ コントラクト"
+  - "サービス コントラクト"
+  - "Windows Communication Foundation, データ コントラクト"
+ms.assetid: bf0ab338-4d36-4e12-8002-8ebfdeb346cb
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# ベスト プラクティス : データ コントラクトのバージョン管理
+このトピックでは、長期的に容易に拡張させることのできるデータ コントラクトを作成するためのベスト プラクティスをいくつか紹介します。  データ コントラクト[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[データ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-data-contracts.md)」の各トピックを参照してください。  
+  
+## スキーマ検証に関する注意事項  
+ データ コントラクトのバージョン管理に関してまず注意を要することは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] がエクスポートしたデータ コントラクト スキーマには、省略可能を示すマークが既定で各要素に付けられることを除き、バージョン管理のサポートがないという点です。  
+  
+ したがって、新しいデータ メンバーを追加するなどの一般的なバージョン管理シナリオであっても、スキーマに関してはシームレスに実装することはできません。  新しいバージョンのデータ コントラクト \(この例ではデータ メンバーが追加されたもの\) を、古いスキーマに基づいて検証することはできません。  
+  
+ ただし、スキーマへの厳密な準拠が要求されない場合も数多くあります。  ASP.NET を使って実現される、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サービスや XML Web サービスなど多くの Web サービス プラットフォームでは、特に必要な場合を除いてスキーマ検証が実施されないので、スキーマに定義されていない要素も容認されます。  このようなプラットフォームであればバージョン管理は容易です。  
+  
+ これらのことから、データ コントラクトのバージョン管理に関するガイドラインには、厳密なスキーマ検証が必要な場合とそうでない場合の 2 種類があります。  
+  
+## スキーマ検証が必要な場合のバージョン管理  
+ 新から旧、旧から新の両方向で厳密なスキーマ検証が必要な場合、データ コントラクトは変更不可であると考えなければなりません。  バージョン管理が必要であれば、別の名前または名前空間で新しいデータ コントラクトを作成したうえで、そのデータ型が使用されているサービス コントラクトにバージョンを付ける必要があります。  
+  
+ たとえば、`PoProcessing` という発注書処理サービス コントラクトに対して、`PurchaseOrder` データ コントラクトに適合したパラメーターを受け取る `PostPurchaseOrder` という操作が定義されているとします。  `PurchaseOrder` コントラクトの内容を変更したい場合は、新しく `PurchaseOrder2` というデータ コントラクトを作成し、こちらに変更内容を含める必要があります。  そのうえで、サービス コントラクト レベルでバージョン管理を行う必要があります。  たとえば、`PurchaseOrder2` パラメーターを受け取る `PostPurchaseOrder2` 操作を別に作成するか、`PoProcessing2` サービス コントラクトを別途作成して `PostPurchaseOrder` 操作が `PurchaseOrder2` データ コントラクトを受け取るようにします。  
+  
+ なお、他のデータ コントラクトから参照されるデータ コントラクトに変更を施すと、サービス モデル レイヤーも拡張されます。  たとえば、先ほどの例で、`PurchaseOrder` データ コントラクトは変更の必要がないとします。  ただし、そのデータ メンバーである `Customer` データ コントラクトに、さらに `Address` データ コントラクトが含まれており、これを変更しなければならないとします。  この場合は、まず `Address2` というデータ コントラクトを別に作成して必要な変更を行います。次に `Customer2` というデータ コントラクトを作成し、`Address2` をそのデータ メンバーとして定義します。さらに、`PurchaseOrder2` というデータ コントラクトを作成して、`Customer2` をデータ メンバーとして定義します。  先ほどの例と同様、サービス コントラクトに対してもバージョン管理を行う必要があります。  
+  
+ ここまでの例では "2" を付けて名前を変えましたが、実際には、バージョン番号または日付を付加して、名前空間の方を変更するようお勧めします。  たとえば、`http://schemas.contoso.com/2005/05/21/PurchaseOrder` というデータ コントラクトを `http://schemas.contoso.com/2005/10/14/PurchaseOrder` に変更します。  
+  
+ ベスト プラクティスの[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[サービスのバージョン管理](../../../docs/framework/wcf/service-versioning.md)」を参照してください。  
+  
+ アプリケーションから送信するメッセージは厳密にスキーマに適合させる必要があるが、外部から受信したメッセージがこれに適合しているとは限らない、という場合もあります。  この場合、受信したメッセージには、異質なデータが含まれているおそれがあります。  異質な値も [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]に格納され、そのまま返されるので、スキーマに適合しないというメッセージが送信される結果になります。  これを回避するには、ラウンド トリップ機能を無効にする必要があります。  これには、2 つの方法があります。  
+  
+-   独自に定義した型に <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装しない。  
+  
+-   サービス コントラクトに <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性を適用し、<xref:System.ServiceModel.ServiceBehaviorAttribute.IgnoreExtensionDataObject%2A> プロパティ値を `true` に設定する。  
+  
+ ラウンドトリップ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[上位互換性のあるデータ コントラクト](../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」を参照してください。  
+  
+## スキーマ検証が不要な場合のバージョン管理  
+ スキーマへの厳密な適合が求められるケースはそれほど多くありません。  多くのプラットフォームでは、スキーマに記述されていない余分な要素が許容されています。  これが許容される場合は、「[データ コントラクトのバージョン管理](../../../docs/framework/wcf/feature-details/data-contract-versioning.md)」および「[上位互換性のあるデータ コントラクト](../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」に記載されている機能をすべて使用できます。  その場合は、以下のガイドラインに従うことをお勧めします。  
+  
+ 旧バージョンの型が想定されている場所へ新バージョンの型を送信したり、新バージョンが想定されている場所へ旧バージョンを送信したりするには、いくつかのガイドラインに厳密に従う必要があります。  それ以外の項目への準拠は、それほど厳密には要求されませんが、これらはスキーマの将来的なバージョン管理に影響する可能性があります。  
+  
+1.  型の継承でデータ コントラクトをバージョン化してはいけません。  新バージョンを作成する場合は、既存の型のデータ コントラクトを直接変更するか、新しく型を定義してください。  
+  
+2.  継承とデータ コントラクトを併用してもかまいませんが、バージョン管理の目的で継承を使用しないことなど、いくつかの規則に従う必要があります。  ある型が基本型から派生している場合、その型は将来のバージョンで別の基本型から派生させてはいけません \(データ コントラクトが同一である場合を除きます\)。  例外として、階層内で、基本型と派生したデータ コントラクト型との間に別の型を追加することは可能です。ただし追加する型に含まれるデータ メンバーの名前は、階層内の他の型のどのバージョンに含まれるメンバーとも、同じにならないようにする必要があります。  一般に、同じ継承階層の異なるレベルで同名のデータ メンバーを使用すると、バージョン管理の上で重大な問題が生じるおそれがあります。  
+  
+3.  ラウンド トリップが有効になるように、データ コントラクトの最初のバージョンから、必ず <xref:System.Runtime.Serialization.IExtensibleDataObject> を実装します。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [上位互換性のあるデータ コントラクト](../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md).  このインターフェイスが実装されていない型の 1 つ以上のバージョンがリリース済みである場合は、この型の次のバージョンで実装します。  
+  
+4.  新しいバージョンで、データ コントラクト名や名前空間を変更しないでください。  データ コントラクトの基になる型の名前や名前空間を変更する場合、<xref:System.Runtime.Serialization.DataContractAttribute> の <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> プロパティを使うなど、適切なメカニズムを使用して、データ コントラクト名と名前空間を残しておく必要があります。  名前付け[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[データ コントラクト名](../../../docs/framework/wcf/feature-details/data-contract-names.md)」を参照してください。  
+  
+5.  新しいバージョンで、データ メンバーの名前を変更しないでください。  データ メンバーの基になるフィールド、プロパティ、イベントの名前を変更する場合は、<xref:System.Runtime.Serialization.DataMemberAttribute> の `Name` プロパティを使用して、既存のデータ メンバー名を残しておく必要があります。  
+  
+6.  新しいバージョンで、データ メンバーの基になるフィールド、プロパティ、イベントの型を変更して、そのデータ メンバーに対応するデータ コントラクトが変わってしまうようなことは避けてください。  予測されるデータ コントラクトを判断するうえで、インターフェイス型は <xref:System.Object> に相当することを念頭に置きます。  
+  
+7.  新しいバージョンで、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性の <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> プロパティを調整して既存のデータ メンバーの順序を変えることは避けてください。  
+  
+8.  新しいバージョンで、新しいデータ メンバーを追加することは可能ですが、  以下の規則に従う必要があります。  
+  
+    1.  <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティ値は、既定値である `false` のまま変更しないでください。  
+  
+    2.  メンバーの既定値として `null` または 0 を許容できない場合は、<xref:System.Runtime.Serialization.OnDeserializingAttribute> を使用してコールバック メソッドを指定する必要があります。該当するメンバーが受信ストリーム内に含まれていない場合は、このコールバック メソッドで妥当な既定値を設定します。  コールバック[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[バージョン トレラントなシリアル化コールバック](../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)」を参照してください。  
+  
+    3.  `DataMemberAttribute` の `Order` プロパティを使用して、新しく追加されたデータ メンバーがすべて、既存のデータ メンバーの後に配置されるようにします。  これを実現するために、最初のバージョンのデータ コントラクトでは、どのデータ メンバーにも `Order` プロパティを設定しないことをお勧めします。  バージョン 2 のデータ コントラクトで追加されたすべてのデータ メンバーについては、`Order` プロパティを 2 に設定します。  バージョン 3 のデータ コントラクトで追加されたすべてのデータ メンバーについては、`Order` プロパティを 3 に設定します。以降のバージョンも同様にしていきます。  複数のデータ メンバーに同じ `Order` 番号を設定してかまいません。  
+  
+9. 新しいバージョンで、データ メンバーを削除しないでください。旧バージョンで、<xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティ値が `false` \(既定値\) であった場合も同様です。  
+  
+10. 既存のデータ メンバーの `IsRequired` プロパティ値をバージョンごとに変更しないでください。  
+  
+11. 必須データ メンバー \(`IsRequired` の値が `true`\) の場合、`EmitDefaultValue` プロパティ値をバージョンごとに変更しないでください。  
+  
+12. バージョン階層を分岐させないでください。  つまり、あるバージョンから別のバージョンへのパスは、このガイドラインで認められている変更のみを使用して、1 方向に 1 つのみになるようにします。  
+  
+     たとえば、Person データ コントラクトのバージョン 1 に、Name というデータ メンバーだけが定義されているとします。これに対し、Age というメンバーのみを追加したバージョン 2a と、Address というメンバーのみを追加したバージョン 2b を作成してはいけません。  2a から 2b に移行しようとすると、Age を削除して Address を追加することになります。この逆方向に移行する場合は、Address を削除して Age を追加しなければなりません。  このガイドラインでは、メンバーの削除が禁止されています。  
+  
+13. 一般に、アプリケーションの新しいバージョンで、既存のデータ コントラクト型のサブタイプを新たに作成することはできません。  同様に、Object 型またはインターフェイス型として宣言されたデータ メンバーの代わりに、新しいデータ コントラクトを作成して使うことはできません。  新規にクラスを定義できるのは、旧アプリケーションのすべてのインスタンスについて、既知の型リストにその新しい型を追加できることがわかっている場合に限ります。  たとえば、アプリケーションのバージョン 1 に LibraryItem というデータ コントラクト型があり、そのサブタイプとして Book および Newspaper が定義されているとします。  LibraryItem には、Book と Newspaper を含む既知の型のリストがあります。  この状況で、LibraryItem のサブタイプである Magazine をバージョン 2 に追加するとします。  バージョン 2 の Magazine のインスタンスをバージョン 1 に送信した場合、既知の型のリストに Magazine データ コントラクトが見つからないので、例外がスローされます。  
+  
+14. バージョン間で列挙型メンバーを追加または削除することはできません。  また、列挙型メンバーの名前を変更することもできません。ただし `EnumMemberAttribute` 属性の Name プロパティを使用して、データ コントラクト モデル内の名前を同じに保つ場合は例外です。  
+  
+15. コレクションは、「[データ コントラクトのコレクション型](../../../docs/framework/wcf/feature-details/collection-types-in-data-contracts.md)」で説明されているように、データ コントラクト モデル内で交換できます。  これにより、高い柔軟性を実現できます。  ただし、バージョン間で交換できないような形でコレクション型を不用意に変更しないように注意してください。  たとえば、カスタマイズされていない \(`CollectionDataContractAttribute` 属性がない\) コレクションをカスタマイズされたコレクションに変更したり、カスタマイズされたコレクションをカスタマイズされていないコレクションに変更したりしないでください。  また、`CollectionDataContractAttribute` のプロパティをバージョンごとに変更しないでください。  許可されている変更は、Name プロパティまたは Namespace プロパティの追加だけです。この変更は、基になるコレクション型の名前または名前空間が変更されたとき、データ コントラクト名および名前空間を旧バージョンと同じにしておきたい場合に行います。  
+  
+ 以上の中には、状況によっては従わなくてもよいガイドラインもあります。  その判断は、シリアル化、逆シリアル化、およびスキーマのメカニズムを完全に理解したうえで行ってください。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A>   
+ <xref:System.Runtime.Serialization.IExtensibleDataObject>   
+ <xref:System.ServiceModel.ServiceBehaviorAttribute>   
+ <xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A>   
+ <xref:System.Runtime.Serialization.ExtensionDataObject>   
+ <xref:System.Runtime.Serialization.OnDeserializingAttribute>   
+ [データ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [データ コントラクトのバージョン管理](../../../docs/framework/wcf/feature-details/data-contract-versioning.md)   
+ [データ コントラクト名](../../../docs/framework/wcf/feature-details/data-contract-names.md)   
+ [上位互換性のあるデータ コントラクト](../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)   
+ [バージョン トレラントなシリアル化コールバック](../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/best-practices-intermediaries.md b/docs/framework/wcf/best-practices-intermediaries.md
new file mode 100644
index 00000000000..a1c16eb24c9
--- /dev/null
+++ b/docs/framework/wcf/best-practices-intermediaries.md
@@ -0,0 +1,45 @@
+---
+title: "ベスト プラクティス: 中継局 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d41b337-8132-4ac2-bea2-6e9ae2f00f8d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# ベスト プラクティス: 中継局
+サービス側のチャネルが正常閉じられていることを確認するために中継局を呼び出すときには、例外処理が正しく行われることに注意が必要です。  
+  
+ 次のようなシナリオがあるとします。クライアントは、バックエンド サービスを呼び出す中継局を呼び出します。バックエンド サービスは、エラー コントラクトを定義しません。したがって、そのサービスからスローされたエラーは型指定されていないエラーとして扱われます。バックエンド サービスは <xref:System.ApplicationException> をスローし、WCF サービス側のチャネルを中止します。<xref:System.ApplicationException> は、中継局へスローされる <xref:System.ServiceModel.FaultException> として表示されます。中継局は <xref:System.ApplicationException> を再スローします。WCF はこれを中継局からの型指定されていないエラーとして解釈し、クライアントに転送します。エラーを受け取ると、中継局とクライアントは、クライアント側のチャネルをエラーにします。ただし、WCF はそのエラーが致命的であると認知しないため、中間サービス側のチャネルは開いたままとなります。  
+  
+ このシナリオのベスト プラクティスは、サービスからのエラーを致命的であるかどうかを検出し、エラーである場合は、次のコード スニペットに示すように、中継局がそのサービス側のチャネルをエラーとします。  
+  
+```csharp  
+catch (Exception e)  
+{  
+    bool faulted = service.State == CommunicationState.Faulted;  
+    service.Abort();  
+    if (faulted)  
+    {  
+        throw new ApplicationException(e.Message);  
+    }  
+    Else  
+    {  
+        throw;  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [WCF エラー処理](../../../docs/framework/wcf/wcf-error-handling.md)   
+ [コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/bindings-overview.md b/docs/framework/wcf/bindings-overview.md
new file mode 100644
index 00000000000..dd673d10b99
--- /dev/null
+++ b/docs/framework/wcf/bindings-overview.md
@@ -0,0 +1,66 @@
+---
+title: "Windows Communication Foundation のバインディングの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング [WCF], 概要"
+ms.assetid: cfb5842f-e0f9-4c56-a015-f2b33f258232
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# Windows Communication Foundation のバインディングの概要
+バインディングとは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスのエンドポイントへの接続に必要な通信の詳細設定を指定する際に使用するオブジェクトのことです。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの各エンドポイントでは、バインディングを適切に指定する必要があります。  ここでは、バインディングによって定義される通信の詳細設定、バインディングの要素、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に用意されているバインディング、およびエンドポイントにバインディングを指定する方法について説明します。  
+  
+## バインディングの定義内容  
+ バインディングの情報は非常に基本的にも複雑にもなりえます。  最も基本的なバインディングはトランスポート プロトコル \(HTTP など\) のみを指定したもので、これはエンドポイントへの接続に必ず使用します。  一般的に、バインディングに含まれるエンドポイントへの接続方法を示す情報は、次のカテゴリのいずれかに当てはまります。  
+  
+ プロトコル  
+ 使用されているセキュリティ機構 \(信頼性の高いメッセージング機能またはトランザクション コンテキストのフロー設定のいずれか\) を決定します。  
+  
+ エンコーディング  
+ メッセージ エンコーディング \(テキストまたはバイナリなど\) を決定します。  
+  
+ Transport  
+ 使用する基本のトランスポート プロトコル \(TCP や HTTP など\) を決定します。  
+  
+## バインディングの要素  
+ バインディングは、基本的に、バインド要素の順序付きスタックで構成されます。各バインド要素では、サービス エンドポイントに接続するために必要な通信情報の一部を指定します。  スタックの 2 つの最も低い層は両方とも必須です。  スタックの一番下にトランスポート バインド要素があり、そのすぐ上にメッセージ エンコーディング仕様を含んだ要素があります。  その他の通信プロトコルを指定するオプションのバインド要素は、この 2 つの必須要素の上に配置されます。  これらのバインド要素とその正確な順序[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## システム標準のバインディング  
+ バインディングの情報は複雑になる可能性があり、一部の設定は他の設定と互換性がない場合もあります。  このため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、システム指定のバインディングが用意されています。  このバインディングは、アプリケーション要件のほとんどに対応するように設計されています。  システム指定のバインディングの例のいくつかを次のクラスで示します。  
+  
+-   <xref:System.ServiceModel.BasicHttpBinding> : WS\-I Basic Profile 仕様に準拠する Web サービス \(ASP.NET Web サービス ベースのサービスなど\) への接続に適した HTTP プロトコル バインディング。  
+  
+-   <xref:System.ServiceModel.WSHttpBinding> : WS\-\* プロトコルに準拠するエンドポイントへの接続に適した相互運用可能なバインディング。  
+  
+-   <xref:System.ServiceModel.NetNamedPipeBinding> : 同じコンピューター上の他の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] エンドポイントへの接続に [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用するバインディング。  
+  
+-   <xref:System.ServiceModel.NetMsmqBinding> : キューに置かれたメッセージと他の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] エンドポイントとの接続を作成するために [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用するバインディング。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 指定のバインディングの完全な一覧と説明については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## 独自のバインディングの使用  
+ システム指定のバインディングに、サービス アプリケーションに必要な正しい組み合わせの機能がない場合、独自のバインディングを作成できます。  これには、2 つの方法があります。  <xref:System.ServiceModel.Channels.CustomBinding> オブジェクトを使用して既存のバインド要素から新しいバインディングを作成するか、<xref:System.ServiceModel.Channels.Binding> バインディングから派生することによって完全にユーザー定義のバインディングを作成することができます。  これら 2 つの方法で独自のバインディングを作成する手順[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)」および「[ユーザー定義バインディングの作成](../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」を参照してください。  
+  
+## バインディングの使用  
+ バインディングを使用する際には、次の 2 つの基本手順があります。  
+  
+1.  バインディングを選択、または定義します。  最も簡単な方法は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に用意されているシステム指定のバインディングを 1 つ選択し、それを既定の設定で使用することです。  また、システム指定のバインディングを選択し、そのプロパティを要件に適した値に再設定することもできます。  別の方法として、カスタム バインディングまたはユーザー定義バインディングを作成し、より高度な制御とカスタマイズを実現することができます。  
+  
+2.  選択または定義されたバインディングを使用するエンドポイントを作成します。  
+  
+## コードおよび構成  
+ バインディングを定義するには、コードによる方法と構成による方法の 2 とおりがあります。  この 2 つの方法は、システム指定またはカスタムのどちらのバインディングを使用している場合でも有効です。  一般的には、コードを使用すると、開発者がデザイン時にバインディングの定義を完全に制御することになります。  一方、構成を使用する場合は、システム管理者や、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスまたはクライアントのユーザーが、サービス アプリケーションをコンパイルし直すことなくバインディングのパラメーターを変更できます。  通常は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの展開先の具体的なコンピューター要件を予測する方法がないため、柔軟性のあるこの方法が望まれます。  バインディング情報とアドレス情報をコードに含めないでおくと、これらの情報を変更したときにアプリケーションを再度コンパイルしたり、展開したりする必要がなくなります。  コードで定義したバインディングは、構成で指定したバインディングの後に作成されます。そのため、構成で定義したバインディングはコードで定義したバインディングによって上書きされることに注意してください。  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/bindings.md b/docs/framework/wcf/bindings.md
new file mode 100644
index 00000000000..a80eac120a5
--- /dev/null
+++ b/docs/framework/wcf/bindings.md
@@ -0,0 +1,46 @@
+---
+title: "Windows Communication Foundation バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング [WCF]"
+ms.assetid: 845df323-be53-4848-92ef-ba67a406484d
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# Windows Communication Foundation バインディング
+バインディングは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス エンドポイントが他のエンドポイントと通信する方法を指定します。バインディングでは、まず、使用するトランスポート \(HTTP や TCP など\) を指定する必要があります。セキュリティやトランザクションのサポートなど、その他の特性もバインディングによって設定できます。  
+  
+## このセクションの内容  
+ [WCF のバインディングの概要](../../../docs/framework/wcf/bindings-overview.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のバインディングの機能、システム指定のバインディング、およびバインディングを定義または変更する方法の概要を説明します。  
+  
+ [システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に用意されているバインディングの一覧を示します。これらのバインディングは、ほとんどのセキュリティ要件およびメッセージ パターン要件を満たします。  
+  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] バインディングには、サービス エンドポイントに接続するためにクライアントが使用しなければならない重要な情報が含まれます。  
+  
+ [サービスのバインディングの構成](../../../docs/framework/wcf/configuring-bindings-for-wcf-services.md)  
+ 管理者やインストール担当者は、構成を使用してサービス エンドポイントのバインディングをカスタマイズできます。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Channels>  
+  
+## 関連項目  
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)  
+  
+ [バインディング](../../../docs/framework/wcf/feature-details/bindings.md)  
+  
+## 参照  
+ [カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/building-clients.md b/docs/framework/wcf/building-clients.md
new file mode 100644
index 00000000000..d8ce2d88741
--- /dev/null
+++ b/docs/framework/wcf/building-clients.md
@@ -0,0 +1,56 @@
+---
+title: "クライアントを構築する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "クライアント [WCF]"
+  - "クライアント [WCF], 構築"
+ms.assetid: 28dfff47-d95b-4cc2-9d5c-b3b9ba71fd50
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# クライアントを構築する
+このセクションのトピックでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] クライアントの作成方法と使用方法について説明します。  
+  
+## このセクションの内容  
+ [WCF クライアントの概要](../../../docs/framework/wcf/wcf-client-overview.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントとその動作の概要について説明します。  
+  
+ [WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)  
+ クライアント アプリケーションで使用する [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを作成するための基本的な方法の概要について説明します。  
+  
+ [クライアントのセキュリティ保護](../../../docs/framework/wcf/securing-clients.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのセキュリティを構成する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.ClientBase%601>  
+  
+ <xref:System.ServiceModel.DuplexClientBase%601>  
+  
+ <xref:System.ServiceModel.DuplexChannelFactory%601>  
+  
+ <xref:System.ServiceModel.ServiceContractAttribute>  
+  
+ <xref:System.ServiceModel.OperationContractAttribute>  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute>  
+  
+ <xref:System.Runtime.Serialization.DataMemberAttribute>  
+  
+## 関連項目  
+ [ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)  
+  
+ [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md b/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md
new file mode 100644
index 00000000000..589af017035
--- /dev/null
+++ b/docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md
@@ -0,0 +1,109 @@
+---
+title: "COM+ サービス モデル構成ツール (ComSvcConfig.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF, COM+ 統合"
+  - "Windows Communication Foundation, COM+ 統合"
+ms.assetid: 7717c6c2-85fc-418b-a8ed-bad8e61cec5c
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# COM+ サービス モデル構成ツール (ComSvcConfig.exe)
+COM\+ サービス モデル構成コマンド ライン ツール \(ComSvcConfig.exe\) を使用すると、COM\+ インターフェイスを Web サービスとして公開するように構成できます。  
+  
+## 構文  
+  
+```  
+  
+ComSvcConfig.exe /install | /uninstall | /list [/application:<ApplicationID | ApplicationName>] [/contract:<ClassID | ProgID | *,InterfaceID | InterfaceName | *>] [/hosting:<complus | was>] [/webSite:<WebsiteName>] [/webDirectory:<WebDirectoryName>] [/mex] [/id] [/nologo] [/verbose] [/help] [/partial]  
+```  
+  
+## 解説  
+  
+> [!NOTE]
+>  ComSvcConfig.exe を使用するには、ローカル コンピューターの管理者である必要があります。  
+  
+ ツールは次の場所にあります。  
+  
+ %SystemRoot%\\Microsoft.Net\\Framework\\v3.0\\Windows Communication Foundation\\  
+  
+ ComSvcConfig.exe の詳細については、「[方法 : COM\+ サービス モデル構成ツールを使用する](../../../docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md)」を参照してください。  
+  
+ 次の表は、ComSvcConfig.exe で使用できるモードを示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`install`|サービス モデル統合に COM\+ インターフェイスの構成をインストールします。<br /><br /> 短縮形 : `/i`。|  
+|`uninstall`|サービス モデル統合から COM\+ インターフェイスの構成をアンインストールします。<br /><br /> 短縮形 : `/u`。|  
+|`list`|サービス モデル統合に構成されるインターフェイスを持つ COM\+ アプリケーションとコンポーネントの情報を一覧表示します。<br /><br /> 短縮形 : `/l`。|  
+  
+ 次の表は、ComSvcConfig.exe で使用できるフラグを示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/application:<` *ApplicationID*  `&#124;`  *ApplicationName* `>`|構成する COM\+ アプリケーションを指定します。<br /><br /> 短縮形 : `/a`。|  
+|`/contract:<` *ClassID*  `&#124;`  *ProgID*  `&#124; *,` *InterfaceID*  `&#124;`  *InterfaceName*  `&#124; *` `>`|サービスのコントラクトとして構成される COM\+ コンポーネントとインターフェイスを指定します。<br /><br /> 短縮形 : `/c`。<br /><br /> コンポーネント名とインターフェイス名を指定する場合はワイルドカード文字 \(\*\) を使用できますが、望まないインターフェイスも公開されることがあるため、ワイルドカード文字を使用しないことをお勧めします。|  
+|`/hosting:<` *complus*  `&#124;`  *was* `>`|COM\+ ホスト モードと Web ホスト モードのどちらを使用するかを指定します。<br /><br /> 短縮形 : `/h`。<br /><br /> COM\+ ホスト モードを使用するには、COM \+ アプリケーションの明示的なアクティブ化が必要です。Web ホスト モードを使用すると、COM\+ アプリケーションを必要なときに自動的にアクティブ化できます。COM\+ アプリケーションがライブラリ アプリケーションの場合は、インターネット インフォメーション サービス \(IIS\) のプロセスで実行します。COM\+ アプリケーションがサーバー アプリケーションの場合は、Dllhost.exe のプロセスで実行します。|  
+|`/webSite:<` *WebsiteName* `>`|Web ホスト モードを使用する場合は、ホストする Web サイトを指定します \(`/hosting` フラグを参照\)。<br /><br /> 短縮形 : `/w`。<br /><br /> Web サイトを指定しない場合は、既定の Web サイトが使用されます。|  
+|`/webDirectory:<` *WebDirectoryName* `>`|Web ホストを使用する場合は、ホストする仮想ディレクトリを指定します \(`/hosting` フラグを参照\)。<br /><br /> 短縮形 : `/d`。|  
+|`/mex`|サービスからコントラクト定義を取得するクライアントをサポートするには、既定のサービス構成に Metadata Exchange \(MEX\) サービス エンドポイントを追加します。<br /><br /> 短縮形 : `/x`。|  
+|`/id`|アプリケーション、コンポーネント、およびインターフェイス情報を ID として表示します。<br /><br /> 短縮形 : `/k`。|  
+|`/nologo`|ComSvcConfig.exe がロゴを表示しないようにします。<br /><br /> 短縮形 : `/n`。|  
+|`/verbose`|発生するエラーに加えて、すべての警告または情報テキストを出力します。<br /><br /> 短縮形 : `/v`。|  
+|`/help`|使用方法を示すメッセージを表示します。<br /><br /> 短縮形 : `/?`。|  
+|`/partial`|指定されたインターフェイスが、公開できる 1 つ以上のメソッド署名を含む場合にサービス構成を生成します。サービスの初期化時に、互換性のあるメソッドはサービス コントラクトで操作として表示され、互換性のないメソッドはサービス コントラクトから除外されます。<br /><br /> このフラグが指定されていない場合は、指定されたインターフェイスが互換性のないメソッドを 1 つ以上含むとツールはサービス構成を生成しません。|  
+  
+## 例  
+  
+### 説明  
+ 次の例は、COM\+ ホスト モードを使用する Web サービスとして公開されるインターフェイスのセットに \(OnlineStore COM\+ アプリケーションの\) `ItemOrders.IFinancial` コンポーネントの `IFinances` インターフェイスを追加します。発生するエラーに加えて、すべての警告が出力されます。  
+  
+### コード  
+  
+```  
+ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose  
+```  
+  
+### 説明  
+ 次の例は、Web ホスト モードを使用する Web サービスとして公開されるインターフェイスのセットに \(OnlineWarehouse COM\+ アプリケーションの\) `ItemInventory.Warehouse` コンポーネントの `IStockLevels` インターフェイスを追加します。Web サービスは、IIS の OnlineWarehouse 仮想ディレクトリで Web ホストされます。  
+  
+### コード  
+  
+```  
+ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse  
+```  
+  
+### 説明  
+ 次の例は、Web サービスとして公開されるインターフェイスのセットから \(OnlineStore COM\+ アプリケーションの\) `ItemOrders.Financial` コンポーネントの `IFinances` インターフェイスを削除します。  
+  
+### コード  
+  
+```  
+ComSvcConfig.exe /uninstall /application:OnlineStore /interface:ItemOrders.Financial,IFinances /hosting:complus  
+```  
+  
+### 説明  
+ 次の例は、ローカル マシン上の OnlineStore COM\+ アプリケーションの現在公開されている COM\+ ホスト インターフェイスを、対応するアドレスやバインディングの詳細と共に一覧表示します。  
+  
+### コード  
+  
+```  
+ComSvcConfig.exe /list /application:OnlineStore /hosting:complus  
+```  
+  
+## 参照  
+ [方法 : COM\+ サービス モデル構成ツールを使用する](../../../docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/conceptual-overview.md b/docs/framework/wcf/conceptual-overview.md
new file mode 100644
index 00000000000..aeebb09848a
--- /dev/null
+++ b/docs/framework/wcf/conceptual-overview.md
@@ -0,0 +1,52 @@
+---
+title: "概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF [WCF], 概念"
+  - "Windows Communication Foundation [WCF], 概念"
+ms.assetid: 503fae4b-014c-44df-a9c7-c76ec4ed4229
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 概念
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] メッセージング システムおよびその使用をサポートしているクラスの概要について説明します。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の概要です。  
+  
+ [Windows Communication Foundation の基本概念](../../../docs/framework/wcf/fundamental-concepts.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] プログラミング モデルの主要概念についての概要です。  
+  
+ [Windows Communication Foundation のアーキテクチャ](../../../docs/framework/wcf/architecture.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アーキテクチャを図で説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 関連項目  
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)  
+  
+ [Windows Communication Foundation サンプル](../../../docs/framework/wcf/samples/index.md)  
+  
+ [ツール](../../../docs/framework/wcf/diagnostics/exceptions-reference/tools.md)  
+  
+ [システム要件](../../../docs/framework/wcf/wcf-system-requirements.md)  
+  
+ [一般的なリファレンス](../../../docs/framework/wcf/general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md b/docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md
new file mode 100644
index 00000000000..9ffb418c53a
--- /dev/null
+++ b/docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md
@@ -0,0 +1,406 @@
+---
+title: "構成エディター ツール (SvcConfigEditor.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "構成ファイル"
+  - "構成ファイル スキーマ"
+  - "構成ファイル"
+  - "構成ファイル, 作成"
+ms.assetid: 2db21a57-5f64-426f-89df-fb0dc2d2def5
+caps.latest.revision: 45
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 45
+---
+# 構成エディター ツール (SvcConfigEditor.exe)
+管理者と開発者は、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス構成エディター \(SvcConfigEditor.exe\) のグラフィカル ユーザー インターフェイスを使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの構成設定を作成および変更できます。このツールを使用すると、XML 構成ファイルを直接編集せずに、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のバインディング、動作、サービス、および診断の設定を管理できます。  
+  
+ サービス構成エディターは、C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\Bin フォルダーにあります。  
+  
+## WCF 構成エディター  
+ サービス構成エディターには、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のサービスやクライアントを構成する手順をすべてガイドするウィザードが付属しています。エディターで直接編集する代わりにウィザードを使用することを強くお勧めします。  
+  
+ 標準の System.Configuration スキーマに準拠する構成ファイルが既にいくつかある場合は、ユーザー インターフェイスを使用してバインディング、動作、サービス、および診断の固有の設定を管理できます。サービス構成エディターを使用すると、既存の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成ファイルの設定だけでなく、実行可能ファイル、COM\+ サービス、および Web ホスト サービスの設定を管理できます。サービス構成エディターで Web ホスト サービスを開くと、上位レベル ノードのサービス固有の構成セクションおよび継承された構成セクションの両方が表示されます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成設定は、構成ファイルの `<system.serviceModel>` セクションにあるため、エディターはこの要素の内容だけを操作し、同じファイル内の他の要素にはアクセスしません。既存の構成ファイルに直接移動したり、サービス、仮想ディレクトリ、または COM\+ サービスを含むアセンブリを選択することができます。エディターがその特定のサービスの構成ファイルを読み込むと、ユーザーは新しい要素を追加したり、構成ファイルの `<system.serviceModel>` セクションで入れ子になっている既存の要素を編集することができます。  
+  
+ エディターは、IntelliSense をサポートし、スキーマ準拠を強制します。結果として得られる出力は、構成ファイルのスキーマに準拠し、構文的に正しいデータ値を持つことが保証されます。ただし、エディターは構成ファイルのセマンティクスが有効であることは保証しません。つまり、エディターは構成ファイルが関連するサービスで有効に機能することは保証しません。  
+  
+> [!CAUTION]
+>  要素を変更すると、エディターは構成ファイルからその構成要素を削除できません。たとえば、エディターを使用してエンドポイント名を空でない文字列に設定して保存すると、構成ファイルは次の内容になります。  
+>   
+>  `<endpoint binding="basicHttpBinding" name="somename" />`  
+>   
+>  そのエンドポイント名を削除するために名前を空の文字列に設定して保存しようとしても、構成ファイルには、`name` 属性が残ります。  
+>   
+>  `<endpoint binding="basicHttpBinding" name="" />`  
+>   
+>  属性を削除するには、別のテキスト エディターを使用して要素を手動で編集する必要があります。  
+>   
+>  特に、`clientCredential` エンドポイント動作の `issueToken` 要素を使用する場合は、この問題に注意する必要があります。具体的には、`localIssuer` サブ要素の `address` 属性を空の文字列にしないようにします。構成エディターを使用して既に `address` 属性を変更している場合にその属性を完全に削除したい場合は、構成エディター以外のツールを使用して削除する必要があります。そうでない場合、属性は空の文字列を含むことになるため、アプリケーションは例外をスローします。  
+  
+## 構成エディターの使用  
+ サービス構成エディターは、次の Windows SDK のインストール場所にあります。  
+  
+ C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\Bin\\SvcConfigEditor.exe  
+  
+ サービス構成エディターを起動したら、**\[ファイル\]** メニューの **\[開く\]** を使用して、管理するサービスまたはアセンブリを参照できます。構成ファイルを直接開き、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] \/COM\+ サービスを参照し、Web ホスト サービスの構成設定を開くことができます。  
+  
+ サービス構成エディターのユーザー インターフェイスは、次の領域に分割されています。  
+  
+-   ツリー ビュー ペイン: 左側に構成要素をツリー構造で表示します。ノードを右クリックと、ツリーで操作を実行できます。  
+  
+-   タスク ペイン: ウィンドウの左下に現在の要素の一般的なタスクを表示します。  
+  
+-   詳細ペイン: ツリー ビューで選択された構成ノードの詳細設定を右側に表示します。  
+  
+### 構成ファイルを開く  
+  
+1.  サービス構成エディターを起動するには、コマンド ウィンドウで [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のインストール場所に移動し、「`SvcConfigEditor.exe`」と入力します。  
+  
+2.  **\[ファイル\]** メニューの **\[開く\]** を選択し、管理するファイルの種類をクリックします。  
+  
+3.  **\[開く\]** ダイアログ ボックスで、管理する特定のファイルに移動し、ダブルクリックします。  
+  
+ ビューアーは、構成のマージ パスを自動的にたどり、マージされた構成のビューを生成します。たとえば、ホストなしのサービスの実際の構成は、Machine.config と App.config の組み合わせです。変更があれば、SvcConfigEditor のアクティブ ファイルに適用されます。構成マージ パスの特定ファイルを編集する場合は、直接開く必要があります。  
+  
+> [!NOTE]
+>  構成ファイルが構成エディター以外で変更されている場合、構成エディターは、現在開いている構成ファイルを再読み込みします。再読み込みが発生すると、エディター内で永続的に保存されていないすべての変更が失われます。再読み込みが連続して発生する場合は、構成ファイルに定期的にアクセスするサービス \(バックグラウンドで実行するウイルス対策ソフトウェアなど\) が原因と考えられます。この問題を解決するには、ファイルが開いているときに、構成エディターがそのファイルにアクセスできる唯一のプロセスであることを保証する必要があります。  
+  
+### サービス  
+ **\[サービス\]** ノードは、構成ファイルで現在割り当てられているすべてのサービスを表示します。ツリー内の各サブノードは、構成ファイル内の \<`services`\> 要素のサブ要素に対応します。  
+  
+ **\[サービス\]** ノードをクリックして、**詳細**ペインのサービスの概要ページでタスクを表示または実行できます。  
+  
+#### 新しいサービス構成の作成  
+ 新しいサービス構成は次の方法で作成できます。  
+  
+-   ウィザードの使用: ウィザードを起動するには、タスク ペインまたは概要ページの **\[新しいサービスの作成\]** リンクをクリックします。**\[ファイル\]** メニューの **\[新しい項目の追加\]** を選択することでも起動できます。  
+  
+-   手動による作成 : **\[サービス\]** ノードを右クリックし、**\[新しいサービス\]** を選択します。  
+  
+#### 新しいサービス エンドポイント構成の作成  
+ 新しいサービス エンドポイント構成は次の方法で作成できます。  
+  
+-   ウィザードによる作成: ウィザードを起動するには、タスク ペインまたは概要ページの **\[新しいサービス エンドポイントの作成\]** リンクをクリックします。**\[ファイル\]** メニューの **\[新しい項目の追加\]** を選択することでも起動できます。  
+  
+-   手動による作成 : サービスを作成したら、**\[エンドポイント\]** ノードを右クリックし、**\[新しいサービス エンドポイント\]** を選択します。  
+  
+#### サービス構成の編集  
+  
+1.  **\[サービス\]** ノードをクリックします。  
+  
+2.  プロパティ グリッドで設定を編集します。  
+  
+#### サービス エンドポイント構成の編集  
+  
+1.  **\[サービス エンドポイント\]** ノードをクリックします。  
+  
+2.  プロパティ グリッドで設定を編集します。  
+  
+#### ベース アドレスの追加  
+  
+1.  **\[ホスト\]** ノードをクリックします。  
+  
+2.  **\[ベース アドレス\]** セクションの **\[新規作成\]** ボタンをクリックします。  
+  
+3.  ダイアログ ボックスにベース アドレスの URI を入力します。  
+  
+4.  **\[OK\]** をクリックします。  
+  
+> [!NOTE]
+>  このツール内では、[\<baseAddressPrefixFilters\>](../../../docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md) の値を編集できません。この要素を追加または変更するには、テキスト エディターまたは [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用する必要があります。  
+  
+### クライアント  
+ **\[クライアント\]** ノードは、構成ファイルのすべてのクライアント エンドポイントを表示します。ツリー内のすべてのサブノードは、構成ファイル内の \<`client`\> 要素のサブ要素に対応します。  
+  
+ **\[クライアント\]** ノードをクリックして、**\[詳細ペイン\]** のクライアントの**概要ページ**でタスクを表示または実行できます。  
+  
+#### 新しいクライアント エンドポイント構成の作成  
+ 新しいクライアント エンドポイント構成は次の方法で作成できます。  
+  
+-   ウィザードによる作成: ウィザードを起動するには、ウィンドウの左下のタスク ペインまたは概要ページの **\[新しいクライアントの作成\]** リンクをクリックします。**\[ファイル\]** メニューの **\[新しい項目の追加\]** をクリックして起動することもできます。クライアント構成を生成するサービス構成の場所の指定を求めるプロンプトが表示されます。接続するサービス エンドポイントを選択できるようになります。  
+  
+-   手動による作成: クライアントの下のエンドポイント ノードを右クリックし、**\[新しいクライアント エンドポイント\]** をクリックします。  
+  
+#### クライアント エンドポイント構成の編集  
+  
+1.  クライアント エンドポイント ノードをクリックします。  
+  
+2.  プロパティ グリッドで設定を編集します。  
+  
+### 標準エンドポイント  
+ 標準エンドポイントは、既定値に設定されたアドレス、コントラクト、およびバインディングの 1 つ以上の特性を持つ特殊なエンドポイントです。  
+  
+ これらの構成設定は、**\[標準エンドポイント\]** ノードに格納されます。**\[標準エンドポイント\]** ノードは、構成ファイルのすべての標準エンドポイント設定を表示します。ツリー内のすべてのサブノードは、構成ファイル内の `<standardEndpoints>` 要素のサブ要素に対応します。  
+  
+ **\[標準エンドポイント\]** ノードをクリックして、**詳細ペイン**の標準エンドポイントの概要ページで、タスクを表示または実行できます。  
+  
+#### 新しい標準エンドポイント構成の作成  
+ 新しい標準エンドポイント構成は、次の方法で作成できます。  
+  
+-   **\[標準エンドポイント\]** ノードを右クリックし、**\[新しい標準エンドポイント構成\]** を選択します。ダイアログ ボックスでバインディングの種類を選択し、**\[OK\]** をクリックします。  
+  
+-   **\[標準エンドポイント\]** ノードを選択し、ウィンドウの左下にあるタスク ペインの **\[新しい標準エンドポイント構成\]** をクリックします。  
+  
+ **\[新しい標準エンドポイントの作成\]** ダイアログ ボックスが表示され、登録されているすべての標準エンドポイントの種類が一覧表示されます。  
+  
+#### 標準エンドポイント構成の表示および編集  
+ 表示および編集する標準エンドポイント構成は、次の方法で開くことができます。  
+  
+-   **\[標準エンドポイント\]** ノードをクリックして展開し、それぞれのエンドポイント サブノードをクリックします。  
+  
+-   **\[標準エンドポイント\]** ノードをクリックし、詳細ペインでそれぞれのエンドポイントをクリックします。  
+  
+ エンドポイントの属性を右ペインに表示して、編集できます。  
+  
+#### 標準エンドポイント構成の削除  
+ 標準エンドポイント構成は次の方法で削除できます。  
+  
+-   **\[標準エンドポイント\]** ノードをクリックして展開し、それぞれのエンドポイント サブノードを右クリックします。コンテキスト コマンド **\[標準エンドポイント構成の削除\]** を使用して、エンドポイントを削除します。  
+  
+-   **\[標準エンドポイント\]** ノードをクリックします。**タスク** ペインで、**\[標準エンドポイント構成の削除\]** をクリックします。  
+  
+ 標準エンドポイントが使用中の場合は、削除しようとしたときに警告メッセージが表示されます。警告は**「標準エンドポイントは使用されています。削除する場合は、構成の他の部分 \(サービス エンドポイントやクライアント エンドポイントなど\) からもすべての参照を必ず削除してください。そうしないと、構成が無効になり、次回から開けなくなります。標準エンドポイントを削除しますか?」**です。  
+  
+### バインディング  
+ バインディング構成は、エンドポイントでバインディングを構成するために使用されます。これらの構成設定は、**\[バインド\]** ノードに格納されます。エンドポイントはバインディング構成を名前で参照し、複数のエンドポイントは単一のバインディング構成を参照できます。  
+  
+ **\[バインド\]** ノードは、構成ファイルのすべてのバインディング設定を表示します。ツリー内のすべてのサブノードは、構成ファイル内の \<`bindings`\> 要素のサブ要素に対応します。  
+  
+ **\[バインド\]** ノードをクリックして、**\[詳細ペイン\]** のバインディングの**概要ページ**でタスクを表示または実行できます。  
+  
+#### 新しいバインディング構成の作成  
+ 新しいバインディング構成は次の方法で作成できます。  
+  
+-   **\[バインド\]** ノードを右クリックし、**\[新しいバインド構成\]** を選択します。ダイアログ ボックスでバインディングの種類を選択し、**\[OK\]** をクリックします。  
+  
+-   **\[バインド\]** ノードを選択し、ウィンドウの左下のタスク ペインで **\[新しいバインド構成\]** をクリックします。  
+  
+-   サービスまたはクライアントの概要ページで、**\[バインドの構成\]** フィールドの **\[クリックして作成\]** をクリックすると、対応するエンドポイントのバインディング構成が作成されます。  
+  
+#### カスタム バインディングへのバインディング要素拡張の追加  
+  
+1.  拡張要素を追加するバインディングを選択します。  
+  
+2.  **\[追加\]** をクリックします。  
+  
+3.  使用できる拡張一覧から、追加するバインディング要素拡張を選択します。複数の項目を選択するには、Ctrl キーを同時に押します。  
+  
+4.  **\[追加\]** をクリックします。  
+  
+#### カスタム バインディングの拡張位置の調整  
+ カスタム バインディングは、スタックを形成するバインディング要素のコレクションです。スタックの各バインディング要素には、独自の構成設定があります。カスタム バインディング内のバインディング要素拡張の順序は、スタック内のそれらの位置を示します。スタックの最上位の要素が最初に適用されます。順序を変更するには  
+  
+1.  カスタム バインディング ノードを選択します。  
+  
+2.  **\[バインド要素の拡張の位置\]** セクションでバインディング拡張要素の 1 つを選択します。  
+  
+3.  一覧の左側にある **\[Up\]** ボタンまたは **\[Down\]** ボタンを使用して、選択した要素の位置を変更します。  
+  
+#### カスタム バインディングのバインディング要素拡張の構成の編集  
+  
+1.  ツリー内のバインディング ノードを選択します。  
+  
+2.  編集する要素を含むカスタム バインディングを選択します。  
+  
+3.  編集するバインディング要素拡張を選択します。要素の設定が、編集場所である右ペインに表示されます。  
+  
+### 診断  
+ **\[診断\]** ノードは、構成ファイルのすべての診断設定を表示します。診断を使用すると、パフォーマンス カウンターのオンまたはオフ、Windows Management Instrumentation \(WMI\) の有効または無効、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレースの構成、および [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージ ログの構成を行うことができます。**\[診断\]** ノードの設定は、\<`system.diagnostics`\> セクションと構成ファイルの `<diagnostics>``<system.serviceModel>` の セクションに対応します。  
+  
+ **\[診断\]** ノードをクリックして、**\[詳細ペイン\]** の診断の**概要ページ**でタスクを表示または実行できます。  
+  
+#### パフォーマンス カウンターと WMI の構成  
+  
+1.  診断ノードをクリックします。  
+  
+2.  **\[パフォーマンス カウンターの切り替え\]** をクリックします。パフォーマンス カウンターには、Off \(既定\)、ServiceOnly、All の 3 つの状態があります。リンクをクリックすると、これらの 3 つの状態の間で設定が切り替わります。  
+  
+#### WMI プロバイダーの構成  
+  
+1.  診断ノードをクリックします。  
+  
+2.  WMI プロバイダーを有効にするには、**\[WMI プロバイダーの有効化\]** リンクをクリックします。  
+  
+#### WCF トレースの有効化  
+ 標準プロパティを持つ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレース ファイルを作成したり、カスタム トレース ファイルを設定したりできます。  
+  
+1.  診断ノードをクリックします。  
+  
+2.  **\[トレースの有効化\]** をクリックします。  
+  
+3.  トレース レベルを調整するには、**\[トレース レベル\]** リンクをクリックします。トレース レベルは、Off、Critical、Error、Warning、Information、Verbose の 6 つあります。**\[アクティビティのトレース\]** と **\[アクティビティの伝達\]** オプションを使用すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アクティビティ トレース機能を使用できます。  
+  
+4.  トレース ファイルとオプションを指定するには、トレース リスナー名をクリックします。  
+  
+#### WCF ログの有効化  
+ 標準プロパティを持つ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレース ファイルの作成またはカスタム トレース ファイルを作成できます。  
+  
+1.  診断ノードをクリックします。  
+  
+2.  **\[メッセージ ログの有効化\]** をクリックします。  
+  
+3.  ログ レベルを調整するには、**\[ログ レベル\]** リンクをクリックします。ログ レベルには、無効な形式、サービス、トランスポートの 3 つがあります。  
+  
+4.  ログ ファイルとオプションを指定するには、リスナー名をクリックします。  
+  
+> [!NOTE]
+>  アプリケーションを閉じるときにトレース ログとメッセージ ログを自動的にフラッシュする場合は、**\[ログの自動フラッシュ\]** オプションを有効にします。  
+  
+ **\[診断\]** の**概要ページ**を使用すると、診断の構成で最も一般的なタスクを実行できます。ただし、リスナーとソースの設定を手動で編集する場合は、診断ノードを展開して、メッセージ ログ、リスナー、およびソースの各ノードの設定を編集する必要があります。  
+  
+#### WCF カスタム トレースまたはメッセージ ログの有効化  
+  
+1.  診断ノードをクリックして展開します。  
+  
+2.  リスナー ノードを右クリックし、**\[新しいリスナー\]** を選択します。  
+  
+3.  **\[InitData\]** フィールドにトレース ファイル名を入力します。\[...\] ボタンをクリックすると、パスを参照できます。  
+  
+4.  **\[TypeName\]** ラインをクリックすると、\[…\] ボタンが表示されます。このボタンをクリックすると、**\[トレース リスナー型ブラウザー\]** が開きます。これを使用すると、既にインストールされている事前構成のトレース リスナーを見つけることができます。  
+  
+5.  **\[ソース\]** セクションに注意してください。このセクションで **\[追加\]** をクリックすると、ダイアログ ボックスが開き、使用できるトレース ソースの一覧がドロップダウン メニューに表示されます。トレース ソースを選択して、**\[OK\]** をクリックします。  
+  
+6.  メッセージ ログ設定を編集するには、メッセージ ログ ノードをクリックします。プロパティ グリッドで設定を編集できます。  
+  
+### 詳細設定  
+  
+#### 動作  
+ **\[動作\]** ノードは、現在構成ファイルに定義されている動作を表示します。  
+  
+ 動作構成は、エンドポイントとサービスの動作を構成するために使用されます。これらの構成設定は、**\[サービス動作\]** と **\[エンドポイント動作\]** の下にある **\[詳細設定\]** ノードに格納されます。サービス動作はサービスによって使用され、エンドポイント動作はエンドポイントによって使用されます。  
+  
+ 動作は、スタックを形成する拡張要素のコレクションです。スタック最上位の要素が最初に適用されます。各拡張要素は独自の構成を持つことができます。  
+  
+##### 新しい動作構成の作成  
+ 新しい動作構成は次の 2 つの方法で作成できます。  
+  
+-   動作ノードの 1 つを右クリックし、**\[新しいエンドポイント動作の構成\]** または **\[新しいサービス動作の構成\]** を選択します。  
+  
+-   動作ノードの 1 つを選択し、ウィンドウの左下のタスク ペインの **\[新しいサービス動作の構成\]** または \[新しいエンドポイント動作の構成\] をクリックします。  
+  
+##### 動作への動作要素拡張の追加  
+  
+1.  動作ノードのいずれかを選択します。  
+  
+2.  編集する動作を選択します。  
+  
+3.  **\[追加\]** をクリックします。  
+  
+4.  使用できる拡張一覧から、追加する動作要素拡張を選択します。  
+  
+5.  **\[追加\]** をクリックします。  
+  
+##### 動作の拡張位置の調整  
+ 動作は、スタックを形成する要素のコレクションです。スタックの各要素には、独自の構成があります。動作内の動作要素拡張の順序は、スタック内のそれらの位置を示します。スタックの最上位の要素が最初に適用されます。順序を変更するには  
+  
+1.  動作ノードのいずれかを選択します。  
+  
+2.  編集する動作を選択します。  
+  
+3.  **\[動的要素の拡張の位置\]** セクションで動作拡張要素を選択します。  
+  
+4.  一覧の左側にある **\[Up\]** ボタンまたは **\[Down\]** ボタンを使用して、選択した要素の位置を変更します。  
+  
+##### 動作要素拡張の構成の編集  
+  
+1.  ツリー内の動作ノードの 1 つを選択します。  
+  
+2.  編集する要素を含む動作を選択します。  
+  
+3.  編集する動作要素拡張を選択します。要素の設定が右ペインに表示されるので、ここで編集できます。  
+  
+#### ProtocolMapping  
+ このセクションでは、プロトコル アドレス スキームと可能なバインドの間に定義されているマッピングを介して、http、tcp、MSMQ、net.pipe などのさまざまなプロトコルに対する既定のバインドの種類を設定できます。他のプロトコルへの新しいマッピングを追加することもできます。  
+  
+#### 拡張  
+ 新しいバインディング拡張、バインディング要素拡張、標準エンドポイント拡張、および動作拡張を登録して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成に使用できます。拡張は、名前と種類のペアです。名前は構成の拡張の名前を定義し、種類は拡張を実装します。拡張には次の 4 種類があります。  
+  
+-   バインディング拡張は、バインディングの種類全体を定義します。例 : `basicHttpBinding`。  
+  
+-   バインディング要素拡張は、バインディングの要素を定義します。例: `textMessageEncoding`。  
+  
+-   標準エンドポイント拡張は、標準エンドポイント全体を定義します。例: `discoveryEndpoint`。  
+  
+-   動作要素拡張は、動作の要素を定義します。例 : `clientVia`。  
+  
+ 構成に登録されている拡張は、同じ種類の他のすべての [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コンポーネントと同じように使用できます。  
+  
+##### 新しい機能の追加  
+ 詳細設定ノード内の拡張ノードの 1 つを選択します。  
+  
+1.  **\[新規作成\]** をクリックします。  
+  
+2.  名前と種類を入力します。  
+  
+3.  **\[OK\]** をクリックします。  
+  
+4.  拡張は、エディターの適切な場所に表示されるようになります。たとえば、動作要素拡張を追加すると、使用できる拡張一覧に表示されます。  
+  
+#### ホスト環境  
+ ここでは、環境をホストするサービスのインスタンス化設定を定義できます。  
+  
+### ウィザードによる構成ファイルの作成  
+ 新しい構成ファイルを作成する 1 つの方法として、新しいサービス要素ウィザードを使用します。ウィザードは、インストールされたサービスの種類および [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] と互換性のある、COM\+、Web ホストの仮想ディレクトリなどの他の要素をコンピューター上で見つけると、それらを読み込んで、構成の作成を効率よく行います。  
+  
+#### 構成ファイルの作成  
+  
+1.  サービス構成エディターを起動するには、コマンド ウィンドウで [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のインストール場所に移動し、「`SvcConfigEditor.exe`」と入力します。  
+  
+2.  **\[ファイル\]** メニューの **\[開く\]** を選択し、作成する構成ファイルの種類に応じて **\[実行可能\]**、**\[COM\+ サービス\]**、または **\[Web ホスト サービス\]** をクリックします。  
+  
+3.  **\[開く\]** ダイアログ ボックスで、構成ファイルを作成する特定のファイルに移動し、ダブルクリックします。  
+  
+4.  **\[ファイル\]** メニューの **\[新しい項目の追加\]** をポイントし、**\[サービス\]** をクリックします。新しいサービス要素ウィザードが開きます。  
+  
+5.  ウィザードの手順に従って新しいサービスを作成します。  
+  
+> [!NOTE]
+>  ウィザードによって生成される構成ファイルから NetPeerTcpBinding を使用する場合は、手動でバインディング構成要素を追加し、その `security` 要素の `mode` 属性を "None" に変更する必要があります。  
+  
+## COM\+ の構成  
+ サービス構成エディターによって、既存の COM\+ アプリケーションに新しい構成ファイルを作成したり、既存の COM\+ 構成を編集することができます。構成ファイルに \<`comContract`\> セクションが存在する場合は、**\[COM コントラクト\]** ノードだけが表示されます。  
+  
+### 新しい COM\+ 構成の作成  
+ 新しい COM\+ 構成を作成する前に、COM\+ アプリケーションがコンポーネント サービスにインストールされて、グローバル アセンブリ キャッシュ \(GAC\) に登録されていることを確認します。  
+  
+1.  **\[ファイル\]** メニューの **\[統合\]** をポイントし、**\[COM\+ アプリケーション\]** を選択します。この操作は、現在開いているファイルを閉じます。現在のファイルに保存されていないデータがあれば、\[保存\] ダイアログ ボックスが表示されます。**COM\+ 統合ウィザード**が起動されます。  
+  
+2.  最初のページで、ツリーから COM\+ アプリケーションを選択します。ツリーで COM\+ アプリケーションが見つからない場合は、COM\+ アプリケーションがコンポーネント サービスにインストールされて、グローバル アセンブリ キャッシュ \(GAC\) に登録されていることを確認します。  
+  
+3.  次のページで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとして公開するメソッドを選択します。既定では、COM\+ アプリケーションでサポートされるすべてのメソッドが表示され、選択されます。  
+  
+4.  ホスト メソッドを選択します。  
+  
+5.  ウィザードの手順に従って他の設定を構成します。  
+  
+6.  サービス構成エディターは、バックグラウンドで ComSvcConfig.exe を利用して、構成ファイルを生成します。これが完了すると、概要を表示してウィザードを終了できます。構成を直接編集できるように、生成された構成ファイルが開きます。  
+  
+### 既存の COM\+ 構成の編集  
+  
+1.  **\[ファイル\]** メニューの **\[開く\]** をポイントし、**\[COM\+ サービス\]** を選択します。  
+  
+2.  編集する COM\+ サービスを一覧から選択します。  
+  
+3.  **\[COM コントラクト\]** ノードで構成設定を編集します。  
+  
+    > [!NOTE]
+    >  COM コントラクトを含む構成ファイルを直接開いて編集することもできます。  
+  
+## セキュリティ  
+ 構成エディターによって生成されるサービス構成ファイルは、セキュリティによる保護が保証されていません。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをセキュリティで保護する方法については、「[セキュリティ](../../../docs/framework/wcf/feature-details/security.md)」を参照してください。  
+  
+ また、構成エディターを使用して読み書きできるのは、有効な [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成要素だけです。ツールは、スキーマに準拠するユーザー定義の要素を無視します。また、これらの要素を構成ファイルから削除したり、既知の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 要素に対する影響を究明することはありません。これらの要素がアプリケーションやシステムに脅威を与えるかどうかを究明するのはユーザーの責任です。
\ No newline at end of file
diff --git a/docs/framework/wcf/configuring-bindings-for-wcf-services.md b/docs/framework/wcf/configuring-bindings-for-wcf-services.md
new file mode 100644
index 00000000000..5509f2c1afb
--- /dev/null
+++ b/docs/framework/wcf/configuring-bindings-for-wcf-services.md
@@ -0,0 +1,182 @@
+---
+title: "Windows Communication Foundation サービスのバインディングの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "バインディング構成 [WCF]"
+ms.assetid: 99a85fd8-f7eb-4a84-a93e-7721b37d415c
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# Windows Communication Foundation サービスのバインディングの構成
+アプリケーションの作成では、アプリケーションの配置後は各種決定事項を管理者に任せる場合がよくあります。たとえば、どのサービス アドレス \(URI \(Uniform Resource Identifier\)\) を使用するかなどの情報は、多くの場合、前もって知る方法がありません。アドレスをハードコーディングする代わりに、サービスの作成後に管理者が指定する方が便利です。構成を活用することで、この柔軟性が得られます。  
+  
+> [!NOTE]
+>  構成ファイルをすばやく作成するには、`/config` スイッチを指定して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用します。  
+  
+## 主要なセクション  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] 構成スキームは、3 つの主要なセクション \(`serviceModel`、`bindings`、および `services`\) で構成されます。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+        </bindings>  
+        <services>  
+        </services>  
+        <behaviors>  
+        </behaviors>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+### ServiceModel 要素  
+ `system.ServiceModel` 要素によって囲まれたこのセクションを使用して、1 つ以上のエンドポイントを持つサービス型、およびサービスの設定を構成できます。各エンドポイントでは、アドレス、コントラクト、およびバインディングをそれぞれ 1 つずつ構成できます。エンドポイント[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)」を参照してください。エンドポイントを指定しない場合、ランタイムは、既定のエンドポイントを追加します。既定のエンドポイント、バインディング、および動作[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+ バインディングはトランスポート \(HTTP、TCP、パイプ、およびメッセージ キュー\) とプロトコル \(セキュリティ、信頼性、およびトランザクション フロー\) を指定し、バインディング要素で構成されます。各バインディング要素は、エンドポイントの通信方法のさまざまな側面を指定します。  
+  
+ たとえば、[\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素を指定すると、エンドポイントのトランスポートとして HTTP が使用されます。このエンドポイントを使用するサービスが開かれる実行時に、エンドポイントとの接続に HTTP が使用されます。  
+  
+ バインディングには、定義済みバインディングとカスタム バインディングの 2 種類があります。定義済みバインディングには、一般的なシナリオで使用される要素の組み合わせが含まれています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で提供される定義済みバインディングの種類の一覧については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。定義済みバインディング コレクションに、サービス アプリケーションに必要な正しい機能の組み合わせがないときは、カスタム バインディングを作成して、そのアプリケーションの要件を満たすことができます。カスタム バインディング[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[\<customBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)」を参照してください。  
+  
+ 次の 4 つの例は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの設定に使用される最も一般的なバインディング構成を示しています。  
+  
+#### バインディングの種類を使用するエンドポイントの指定  
+ 最初の例は、アドレス、コントラクト、およびバインディングをそれぞれ 1 つずつ使用して構成されたエンドポイントを指定する方法を示しています。  
+  
+```  
+<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
+  <!—- This section is optional with the default configuration introduced  
+       in .NET Framework 4. -->  
+  <endpoint   
+      address="/HelloWorld2/"  
+      contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+      binding="basicHttpBinding" />  
+  </endpoint>  
+</service>  
+```  
+  
+ この例では、`name` 属性は、構成がどのサービス型に対するものであるかを示します。`HelloWorld` コントラクトを使用してコードでサービスを作成すると、そのサービスは、この例の構成に定義されているすべてのエンドポイントと共に初期化されます。アセンブリにサービス コントラクトが 1 つしか実装されない場合、サービスは使用可能なタイプだけを使用するため、`name` 属性を省略できます。この属性が受け取る文字列は、`Namespace.Class, AssemblyName, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null` の形式で指定される必要があります。  
+  
+ `address` 属性では、他のエンドポイントがこのサービスと通信するために使用する URI を指定します。この URI は、絶対パスでも相対パスでもかまいません。相対アドレスを指定すると、ホストは、そのバインディングで使用されるトランスポート スキームに適したベース アドレスを提供します。アドレスが構成されていない場合、ベース アドレスはそのエンドポイントのアドレスと見なされます。  
+  
+ `contract` 属性では、このエンドポイントが公開するコントラクトを指定します。サービス実装の型は、コントラクト型を実装する必要があります。サービス実装が単一のコントラクト型を実装する場合は、このプロパティを省略できます。  
+  
+ `binding` 属性では、この特定のエンドポイントに使用される定義済みバインディングまたはカスタム バインディングを選択します。バインディングが明示的に選択されていないエンドポイントでは、既定のバインディング選択 \(`BasicHttpBinding`\) を使用します。  
+  
+#### 定義済みバインディングの変更  
+ 次の例では、定義済みバインディングを変更します。これにより、サービスの任意のエンドポイントを構成するために使用できるようになります。バインディングの変更では、<xref:System.ServiceModel.Configuration.IBindingConfigurationElement.ReceiveTimeout%2A> 値を 1 秒に設定します。このプロパティは、<xref:System.TimeSpan> オブジェクトを返します。  
+  
+ 変更されたバインディングは、バインディング セクションにあります。この変更したバインディングは、`endpoint` 要素の `binding` 属性を設定することにより、任意のエンドポイントを作成するときに使用できます。  
+  
+> [!NOTE]
+>  バインディングに特定の名前を付ける場合、サービス エンドポイントで指定した `bindingConfiguration` と同じ名前にする必要があります。  
+  
+```  
+<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
+  <endpoint   
+      address="/HelloWorld2/"  
+      contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+      binding="basicHttpBinding" />  
+  </endpoint>  
+</service>  
+<bindings>  
+    <basicHttpBinding   
+        receiveTimeout="00:00:01"  
+    />  
+</bindings>  
+```  
+  
+## サービスに適用する動作の構成  
+ 次の例では、サービス型に対して、特定の動作を構成します。サービスに照会し、メタデータから Web サービス記述言語 \(WSDL: Web Services Description Language\) のドキュメントを生成するには、`ServiceMetadataBehavior` 要素を使用して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を有効にします。  
+  
+> [!NOTE]
+>  動作に特定の名前を付ける場合、サービスまたはエンドポイント セクションで指定した `behaviorConfiguration` と同じ名前にする必要があります。  
+  
+```  
+<behaviors>  
+    <behavior>  
+        <ServiceMetadata httpGetEnabled="true" />   
+    </behavior>  
+</behaviors>  
+<services>  
+    <service   
+       name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+       <endpoint   
+          address="http://computer:8080/Hello"  
+          contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+          binding="basicHttpBinding" />  
+       </endpoint>  
+    </service>  
+</services>  
+```  
+  
+ 前の構成では、クライアントが "HelloWorld" の型指定されたサービスを呼び出してメタデータを取得できます。  
+  
+ `svcutil /config:Client.exe.config http://computer:8080/Hello?wsdl`  
+  
+## 異なるバインディング値を使用する 2 つのエンドポイントを持つサービスの指定  
+ この最後の例では、`HelloWorld` サービス型に 2 つのエンドポイントを構成します。各エンドポイントでは、同じバインディングの種類を使用しますが、カスタマイズした異なる  `bindingConfiguration` 属性を使用します \(それぞれで `basicHttpBinding` を変更\)。  
+  
+```  
+<service name="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null">  
+    <endpoint  
+        address="http://computer:8080/Hello1"  
+        contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+        binding="basicHttpBinding"  
+        bindingConfiguration="shortTimeout"  
+    </endpoint>  
+    <endpoint  
+        address="http://computer:8080/Hello2"  
+        contract="HelloWorld, IndigoConfig, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"  
+        binding="basicHttpBinding"  
+        bindingConfiguration="Secure"  
+     </endpoint>  
+</service>  
+<bindings>  
+    <basicHttpBinding   
+        name="shortTimeout"  
+        timeout="00:00:00:01"   
+     />  
+     <basicHttpBinding   
+        name="Secure" />  
+        <Security mode="Transport" />  
+</bindings>  
+```  
+  
+ 次の例に示すように、`protocolMapping` セクションを追加してバインディングを構成することによって、既定の構成を使用する同じ動作を取得できます。  
+  
+```xml  
+<protocolMapping>  
+    <add scheme=”http” binding=”basicHttpBinding” bindingConfiguration=”shortTimeout” />  
+    <add scheme=”https” binding=”basicHttpBinding” bindingConfiguration=”Secure” />  
+</protocolMapping>  
+<bindings>  
+    <basicHttpBinding   
+        name="shortTimeout"  
+        timeout="00:00:00:01"   
+     />  
+     <basicHttpBinding   
+        name="Secure" />  
+        <Security mode="Transport" />  
+</bindings>  
+```  
+  
+## 参照  
+ [簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)   
+ [システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)   
+ [エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/configuring-client-behaviors.md b/docs/framework/wcf/configuring-client-behaviors.md
new file mode 100644
index 00000000000..82b97970cbf
--- /dev/null
+++ b/docs/framework/wcf/configuring-client-behaviors.md
@@ -0,0 +1,59 @@
+---
+title: "クライアントの動作の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: df5b32fa-e73b-4e8e-b66f-357c748e0173
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# クライアントの動作の構成
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は 2 とおりの方法で動作を構成します。1 つは動作の構成を参照する方法で、これはクライアント アプリケーションの構成ファイルの `<behavior>` セクションで定義されます。もう 1 つは、呼び出し元アプリケーションでプログラムによって動作を構成する方法です。  このトピックでは、両方の方法について説明します。  
+  
+ 構成ファイルを使用する場合、動作の構成には、構成設定の名前付きコレクションがあります。  各動作の構成には、一意の名前を指定する必要があります。  この文字列をエンドポイントの構成の `behaviorConfiguration` 属性で使用し、エンドポイントと動作を関連付けます。  
+  
+## 例  
+ `myBehavior` という動作を定義する構成コードを次に示します。  クライアント エンドポイントは、この動作を `behaviorConfiguration` 属性で参照します。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+        <behaviors>  
+            <endpointBehaviors>  
+                <behavior name="myBehavior">  
+                    <clientVia />  
+                </behavior>  
+            </endpointBehaviors>  
+        </behaviors>  
+        <bindings>  
+            <basicHttpBinding>  
+                <binding name="myBinding" maxReceivedMessageSize="10000" />  
+            </basicHttpBinding>  
+        </bindings>  
+        <client>  
+            <endpoint address="myAddress" binding="basicHttpBinding" bindingConfiguration="myBinding" behaviorConfiguration="myBehavior" contract="myContract" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+## プログラムによる動作の使用  
+ クライアントを開く前に、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] クライアント オブジェクトまたはクライアント チャネル ファクトリ オブジェクト上の適切な `Behaviors` プロパティを見つけることで、動作をプログラムによって構成または挿入することもできます。  
+  
+## 例  
+ 次のコード例は、チャネル オブジェクトの作成前に、<xref:System.ServiceModel.ChannelFactory.Endpoint%2A> プロパティから返される <xref:System.ServiceModel.Description.ServiceEndpoint> 上の <xref:System.ServiceModel.Description.ServiceEndpoint.Behaviors%2A> プロパティにアクセスすることで、プログラムでクライアント動作が挿入される方法を示します。  
+  
+ [!code-csharp[ChannelFactoryBehaviors#10](../../../samples/snippets/csharp/VS_Snippets_CFX/channelfactorybehaviors/cs/client.cs#10)]
+ [!code-vb[ChannelFactoryBehaviors#10](../../../samples/snippets/visualbasic/VS_Snippets_CFX/channelfactorybehaviors/vb/client.vb#10)]  
+  
+## 参照  
+ [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/configuring-services-using-configuration-files.md b/docs/framework/wcf/configuring-services-using-configuration-files.md
new file mode 100644
index 00000000000..6fa68d6e03a
--- /dev/null
+++ b/docs/framework/wcf/configuring-services-using-configuration-files.md
@@ -0,0 +1,283 @@
+---
+title: "構成ファイルを使用してサービスを構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービスの構成 [WCF]"
+ms.assetid: c9c8cd32-2c9d-4541-ad0d-16dff6bd2a00
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 構成ファイルを使用してサービスを構成する方法
+構成ファイルを使用して [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスを構成すると、デザイン時ではなく配置時にエンドポイントとサービス動作のデータを指定できるという柔軟性が生まれます。 ここでは使用可能な主要な技術について説明します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の構成技術を使用して構成できます。 通常、XML 要素は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストするインターネット インフォメーション サービス \(IIS\) サイトの Web.config ファイルに追加されます。 この要素によって、コンピューターごとにエンドポイント アドレス \(サービスと通信するために使用する実際のアドレス\) などの詳細情報を変更できます。 また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、システム指定の要素がいくつか用意されており、これらの要素によって、サービスの最も基本的な機能を簡単に選択できます。[!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] 以降では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成要件を簡略化する新しい既定の構成モデルが付属しています。 特定のサービスに対し [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成を指定しないと、ランタイムは自動的にいくつかの標準エンドポイントおよびバインディング\/動作でサービスを構成します。 実際、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションのプログラミングにおいては、構成ファイルの記述が作業の大きな部分を占めます。  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [サービスのバインディングの構成](../../../docs/framework/wcf/configuring-bindings-for-wcf-services.md)。 最もよく使用される要素の[!INCLUDE[crlist](../../../includes/crlist-md.md)]については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。 既定のエンドポイント、バインディング、および動作の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  2 つの異なるバージョンのサービスが配置される side\-by\-side のシナリオを配置する場合、構成ファイルで参照されるアセンブリの部分名を指定する必要があります。 これは構成ファイルがすべてのバージョンのサービスで共有されて、異なるバージョンの .NET Framework で実行される可能性があるためです。  
+  
+## System.Configuration: Web.config と App.config  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の System.Configuration 構成システムを使用します。  
+  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でサービスを構成するとき、Web.config ファイルまたは App.config ファイルのいずれかを使用して、設定を指定します。 選択する構成ファイル名は、サービスに選択したホスト環境によって異なります。 サービスのホストに IIS を使用している場合は、Web.config ファイルを使用します。 他のホスト環境を使用している場合、App.config ファイルを使用します。  
+  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] では、App.config という名前のファイルを使用して、最終の構成ファイルを作成します。 構成で実際に使用される最終的な名前は、アセンブリ名によって異なります。 たとえば、アセンブリ名が "Cohowinery.exe" の場合、最終の構成ファイルの名前は "Cohowinery.exe.config" になります。 ただし、変更する必要があるのは App.config ファイルだけです。 このファイルで行った変更は、コンパイル時に自動的に最終のアプリケーション構成ファイルに反映されます。  
+  
+ App.config ファイルを使用しているとき、アプリケーションが開始され、構成が適用されると、構成システムは App.config ファイルを Machine.config ファイルの内容とマージします。 このしくみによって、Machine.config ファイルにはコンピューター全体の設定を定義できます。 App.config ファイルは、Machine.config ファイルの設定をオーバーライドするために使用できます。また、Machine.config ファイルにある設定をロックしてこの設定が使用されるようにすることもできます。 Web.config の場合、構成システムは、アプリケーション ディレクトリまでのすべてのディレクトリにある Web.config ファイルを、適用される構成にマージします。 構成と設定の優先順位[!INCLUDE[crabout](../../../includes/crabout-md.md)]、<xref:System.Configuration> 名前空間のトピックを参照してください。  
+  
+## 構成ファイルの主要セクション  
+ 構成ファイルの主要セクションには、次の要素があります。  
+  
+```  
+<system.ServiceModel>  
+  
+   <services>  
+   <!—- Define the service endpoints. This section is optional in the new  
+    default configuration model in .NET Framework 4. -->  
+      <service>  
+         <endpoint/>  
+      </service>  
+   </services>  
+  
+   <bindings>  
+   <!-- Specify one or more of the system-provided binding elements,  
+    for example, <basicHttpBinding> -->   
+   <!-- Alternatively, <customBinding> elements. -->  
+      <binding>  
+      <!-- For example, a <BasicHttpBinding> element. -->  
+      </binding>  
+   </bindings>  
+  
+   <behaviors>  
+   <!-- One or more of the system-provided or custom behavior elements. -->  
+      <behavior>  
+      <!-- For example, a <throttling> element. -->  
+      </behavior>  
+   </behaviors>  
+  
+</system.ServiceModel>  
+```  
+  
+> [!NOTE]
+>  バインディングと動作のセクションは省略可能であり、必要な場合のみ追加されます。  
+  
+### \<services\> 要素  
+ `services` 要素には、アプリケーションによってホストされるすべてのサービスの仕様が入ります。[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] の簡略化された構成モデル以降の場合、このセクションは省略可能です。  
+  
+ [\<services\>](../../../docs/framework/configure-apps/file-schema/wcf/services.md)  
+  
+### \<service\> 要素  
+ 各サービスには次の属性があります。  
+  
+-   `name`。 \- サービス コントラクトの実装を提供する型を指定します。 これは、名前空間、期間、および型名を構成する完全修飾名です。 たとえば、`"MyNameSpace.myServiceType"` などです。  
+  
+-   `behaviorConfiguration`。 \- `behavior` 要素に存在するいずれかの `behaviors` 要素の名前を指定します。 指定された動作は、サービスが偽装を許可するかどうかなどのアクションを制御します。 その値が空の名前であるか、または `behaviorConfiguration` が指定されていない場合、サービスの動作の既定のセットがサービスに追加されます。  
+  
+-   [\<service\>](../../../docs/framework/configure-apps/file-schema/wcf/service.md)  
+  
+### \<endpoint\> 要素  
+ 各エンドポイントには、次の属性で表されるアドレス、バインディング、およびコントラクトが必要です。  
+  
+-   `address`。 サービスの URI \(Uniform Resource Identifier\) を指定します。絶対アドレスまたはサービスのベース アドレスからの相対アドレスを指定できます。 空の文字列を設定した場合、サービスの <xref:System.ServiceModel.ServiceHost> を作成するときに指定したベース アドレスでエンドポイントを使用できることを示します。  
+  
+-   `binding`。 \- 通常、<xref:System.ServiceModel.WsHttpBinding> などのシステム指定のバインディングを指定しますが、ユーザー定義バインディングを指定することも可能です。 指定するバインディングによって、トランスポートの種類、使用するセキュリティとエンコーディング、および信頼できるセッション、トランザクション、またはストリーミングがサポートされるかどうか、または有効かどうかが決まります。  
+  
+-   `bindingConfiguration`。 バインディングの既定値を変更する必要がある場合、`binding` 要素の該当する `bindings` 要素を構成することによって変更できます。 この属性には、既定値の変更に使用される `name` 要素の`binding` 属性と同じ値を指定する必要があります。 名前を指定しない場合、またはバインディングに `bindingConfiguration` を指定しない場合、バインディングの種類の既定のバインディングは、エンドポイントで使用されます。  
+  
+-   `contract`。 コントラクトを定義するインターフェイスを指定します。 これは `name` 要素の `service` 属性で指定された共通言語ランタイム \(CLR\) 型で実装されたインターフェイスです。  
+  
+-   [\<endpoint\> element reference](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017)  
+  
+### \<bindings\> 要素  
+ `bindings` 要素には、任意のサービスで定義される任意のエンドポイントによって使用できるすべてのバインディングに関する仕様が入ります。  
+  
+ [\<bindings\>](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)  
+  
+### \<binding\> 要素  
+ `bindings` 要素に含まれる `binding` 要素には、システム指定のバインディング \(「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照\) またはカスタム バインディング \(「[カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)」を参照\) のどちらかを指定できます。`binding` 要素には、バインディングを `name` 要素の `bindingConfiguration` 属性で指定されたエンドポイントと関連付ける `endpoint` 属性があります。 名前を指定しない場合、バインディングは、バインディングの既定の種類に対応します。  
+  
+ サービスとクライアントの構成の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[Configuring Windows Communication Foundation Applications](http://msdn.microsoft.com/ja-jp/13cb368e-88d4-4c61-8eed-2af0361c6d7a)」を参照してください。  
+  
+ [\<binding\>](../../../docs/framework/misc/binding.md)  
+  
+### \<behaviors\> 要素  
+ これは、サービスの動作を定義する `behavior` 要素のコンテナー要素です。  
+  
+ [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)  
+  
+### \<behavior\> 要素  
+ 各 `behavior` 要素は、`name` 属性によって識別され、\<`throttling`\> などのシステム指定の動作またはカスタム動作のいずれかを定義します。 名前を指定しない場合、動作要素は、既定のサービスまたはエンドポイント動作に対応します。  
+  
+ [\<behavior\>](../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md)  
+  
+## バインディングと動作の構成を使用する方法  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、構成で参照システムを使用することによって、エンドポイント間で構成を簡単に共有できます。 構成値を直接エンドポイントに割り当てるのではなく、バインディング関連の構成値を `bindingConfiguration` セクションの `<binding>` 要素にグループ化します。 バインディング構成とは、バインディングの設定の名前付きグループです。 エンドポイントは、名前によって `bindingConfiguration` を参照できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+ <system.serviceModel>  
+  <bindings>  
+    <basicHttpBinding>  
+     <binding name="myBindingConfiguration1" closeTimeout="00:01:00" />  
+     <binding name="myBindingConfiguration2" closeTimeout="00:02:00" />  
+     <binding closeTimeout="00:03:00" />  <!—- Default binding for basicHttpBinding -->  
+    </basicHttpBinding>  
+     </bindings>  
+     <services>  
+      <service name="MyNamespace.myServiceType">  
+       <endpoint   
+          address="myAddress" binding="basicHttpBinding"   
+          bindingConfiguration="myBindingConfiguration1"  
+          contract="MyContract"  />  
+       <endpoint   
+          address="myAddress2" binding="basicHttpBinding"   
+          bindingConfiguration="myBindingConfiguration2"  
+          contract="MyContract" />  
+       <endpoint   
+          address="myAddress3" binding="basicHttpBinding"   
+          contract="MyContract" />  
+       </service>  
+      </services>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+ `name` の `bindingConfiguration` は、`<binding>` 要素で設定します。`name` には、バインディングの種類 \(この場合は [\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)\) のスコープ内で一意の文字列、または既定のバインディングを参照する空の値を指定する必要があります。 エンドポイントは、`bindingConfiguration` 属性をこの文字列に設定することによって構成にリンクします。  
+  
+ `behaviorConfiguration` は、次のサンプルに示すように、同じ方法で実装されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="myBehavior">  
+           <callbackDebug includeExceptionDetailInFaults="true" />  
+         </behavior>  
+      </endpointBehaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="true" />  
+        </behavior>  
+      </serviceBehaviors>  
+  
+    </behaviors>  
+    <services>  
+     <service name="NewServiceType">  
+       <endpoint   
+          address="myAddress3" behaviorConfiguration="myBehavior"  
+          binding="basicHttpBinding"  
+          contract=”MyContract” />  
+      </service>  
+    </services>  
+   </system.serviceModel>  
+</configuration>  
+```  
+  
+ サービスの動作の既定のセットは、サービスに追加されることに注意してください。 このシステムでは、設定を再定義することなく、エンドポイント間で共通の構成を共有できます。 コンピューター全体のスコープが必要な場合は、バインディングまたは動作の構成を Machine.config に作成します。 構成設定は、すべての App.config ファイルで操作できます。[構成エディター ツール \(SvcConfigEditor.exe\)](../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) を使用すると、構成を簡単に作成できます。  
+  
+## 動作のマージ  
+ 動作のマージ機能を使用すると、共通動作のセットを常に使用する場合に動作の管理が容易になります。 この機能では、さまざまなレベルの構成階層で動作を指定し、サービスが複数レベルの構成階層から動作を継承することができます。 このしくみを説明するため、IIS に次の仮想ディレクトリ レイアウトが存在するとします。  
+  
+ ~\\Web.config~\\Service.svc~\\Child\\Web.config~\\Child\\Service.svc  
+  
+ また ~\\Web.config ファイルに次の内容が含まれているとします。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceDebug includeExceptionDetailInFaults="True" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ さらに ~\\Child\\Web.config にある子 Web.config に次の内容が含まれているとします。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ ~\\Child\\Service.svc にあるサービスは、serviceDebug 動作と serviceMetadata 動作の両方を持つ場合と同様に動作します。 ~\\Service.svc にあるサービスは、serviceDebug 動作のみを持ちます。 これによって、同じ名前の 2 つの動作コレクション \(この例では空の文字列\) がマージされます。  
+  
+ また、\<clear\> タグを使用して動作コレクションを消去したり、\<remove\> タグを使用してコレクションから個々の動作を削除することができます。 たとえば、次の 2 つの構成は serviceMetadata 動作のみを持つ子サービスになります。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <remove name="serviceDebug"/>  
+          <serviceMetadata httpGetEnabled="True" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <clear/>  
+          <serviceMetadata httpGetEnabled="True" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ 動作のマージは、上に示した名前なし動作コレクションだけでなく、名前付き動作コレクションにも適用できます。  
+  
+ 動作のマージは、IIS ホスト環境で機能し、Web.config ファイルがルートの Web.config ファイルおよび machine.config と階層的にマージされます。 ただし、動作のマージはアプリケーション環境でも機能し、machine.config を App.config ファイルとマージできます。  
+  
+ 動作のマージは、構成内のエンドポイント動作とサービス動作の両方に適用されます。  
+  
+ 親動作コレクションに既に存在する動作が子動作コレクションにも含まれている場合、子動作が親をオーバーライドします。 たとえば、親動作コレクションに `<serviceMetadata httpGetEnabled="False" />` があり、子動作コレクションに `<serviceMetadata httpGetEnabled="True" />` がある場合、動作コレクションで子動作が親動作をオーバーライドし、httpGetEnabled が "true" になります。  
+  
+## 参照  
+ [簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)   
+ [Configuring Windows Communication Foundation Applications](http://msdn.microsoft.com/ja-jp/13cb368e-88d4-4c61-8eed-2af0361c6d7a)   
+ [\<service\>](../../../docs/framework/configure-apps/file-schema/wcf/service.md)   
+ [\<binding\>](../../../docs/framework/misc/binding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/configuring-services.md b/docs/framework/wcf/configuring-services.md
new file mode 100644
index 00000000000..48df1b9a58f
--- /dev/null
+++ b/docs/framework/wcf/configuring-services.md
@@ -0,0 +1,68 @@
+---
+title: "サービスの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "構成 [WCF]"
+ms.assetid: beac771e-f28e-4f84-9ff1-ad9251c726d3
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# サービスの構成
+サービス コントラクトの設計、実装が終われば、サービスを構成できる状態になります。  クライアント側から見たサービスの動作は、ここで定義、カスタマイズします。サービスと通信するためのアドレス、メッセージの送受信に使うトランスポートやエンコーディング、必要なセキュリティ型などを指定できます。  
+  
+ 定義やカスタマイズは、コード内で強制的に \(簡単には変更できないような形で\) 行う方法と、構成ファイルに記述して行う方法があります。エンドポイントのアドレス、実際に使うトランスポート、セキュリティ スキーマなど、サービスに関するさまざまな事項を定義、カスタマイズできます。  実際、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションのプログラミングにおいては、構成ファイルの記述が作業の大きな部分を占めます。  
+  
+## このセクションの内容  
+ [簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)  
+ [!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] 以降では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成要件を簡略化する新しい既定の構成モデルが付属しています。  特定のサービスに対し [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成を指定しないと、ランタイムは自動的に既定のエンドポイント、バインディング、および動作でサービスを構成します。  
+  
+ [構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の構成技術を使用して構成できます。  通常、XML 要素は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストするインターネット インフォメーション サービス \(IIS\) サイトの Web.config ファイルに追加されます。  この要素によって、コンピューターごとにエンドポイント アドレス \(サービスと通信するために使用する実際のアドレス\) などの詳細情報を変更できます。  
+  
+ [バインディング](../../../docs/framework/wcf/bindings.md)  
+ さらに [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、一般的な構成がシステム提供のバインディングとして用意されています。これを使用すると、クライアントとサービスの通信方法に関する基本事項 \(トランスポート、セキュリティ、メッセージのエンコーディングなど\) を容易に選択できます。  
+  
+ [エンドポイント](../../../docs/framework/wcf/endpoints.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを使用して行われるすべての通信では、サービスの*エンドポイント*が使用されます。  エンドポイントには、コントラクト、バインディングで指定されている構成情報、およびサービスの検索場所やサービスに関する情報の取得場所を示すアドレスが設定されています。  
+  
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] および既存のセキュリティ機構を使用することにより、機密性、整合性、認証、および承認をサービスに実装できます。  また、セキュリティに関する成功および失敗を監査することも可能です。  
+  
+ [WS\-I Basic Profile 1.1 の相互運用可能サービスの作成](../../../docs/framework/wcf/creating-ws-i-basic-profile-1-1-interoperable-services.md)  
+ 他のプラットフォームやオペレーティング システム上で動作するサービスやクライアントと、相互に運用できるような形でサービスを配置するために必要な事項は、WS\-I Basic Profile 1.1 の仕様に記載されています。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Description>  
+  
+## 関連項目  
+ [基本的なプログラミング ライフサイクル](../../../docs/framework/wcf/basic-programming-lifecycle.md)  
+  
+ [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)  
+  
+ [ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)  
+  
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)  
+  
+ [拡張機能の概要](../../../docs/framework/wcf/introduction-to-extensibility.md)  
+  
+ [管理と診断](../../../docs/framework/wcf/diagnostics/index.md)  
+  
+## 参照  
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)   
+ [WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/configuring-wcf-services-in-code.md b/docs/framework/wcf/configuring-wcf-services-in-code.md
new file mode 100644
index 00000000000..18b4ebce3c0
--- /dev/null
+++ b/docs/framework/wcf/configuring-wcf-services-in-code.md
@@ -0,0 +1,116 @@
+---
+title: "コード内での WCF サービスの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 193c725d-134f-4d31-a8f8-4e575233bff6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コード内での WCF サービスの構成
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、開発者が構成ファイルまたはコードを使用してサービスを構成できます。構成ファイルは、配置した後にサービスを構成する必要がある場合に役立ちます。構成ファイルを使用する場合、IT 専門家は構成ファイルを更新するだけでよく、再コンパイルは必要ありません。ただし、構成ファイルが複雑化し、保守が難しくなる場合があります。構成ファイルのデバッグはサポートしていません。また、構成要素は名前で参照されるため、構成ファイルの作成時にエラーが発生しやすくなるほか、構成ファイルの作成が困難になります。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、コードでサービスを構成することもできます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の以前のバージョン \(4.0 およびそれ以前\) では、自己ホストのシナリオであればコード内でのサービスの構成が簡単で、<xref:System.ServiceModel.ServiceHost> クラスにより、ServiceHost.Open を呼び出す前にエンドポイントと動作を構成できました。ただし、Web ホストのシナリオでは、<xref:System.ServiceModel.ServiceHost> クラスへの直接のアクセス権がありません。Web ホスト サービスを構成するには、<xref:System.ServiceModel.ServiceHost> を作成し、必要な構成を実行する <xref:System.ServiceModel.ServiceHostFactory> を作成する必要がありました。.NET 4.5 以降では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によって、自己ホスト サービスと Web ホスト サービスのどちらもコードで簡単に構成できます。  
+  
+## Configure メソッド  
+ サービス実装クラスで、次のシグネチャを持つ `Configure` という名前のパブリックな静的メソッドを定義します。  
+  
+```csharp  
+public static void Configure(ServiceConfiguration config)  
+```  
+  
+ Configure メソッドは、開発者がエンドポイントおよび動作を追加できるようにする <xref:System.ServiceModel.ServiceConfiguration> インスタンスを受け取ります。このメソッドは、サービス ホストが開かれる前に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によって呼び出されます。app.config ファイルまたは web.config ファイルで指定されたすべてのサービスの構成設定は、定義されている場合、無視されます。  
+  
+ 次のコード スニペットは、`Configure` メソッドを定義し、サービス エンドポイント、エンドポイントの動作、およびサービスの動作を追加する方法を示しています。  
+  
+```csharp  
+public class Service1 : IService1  
+    {  
+        public static void Configure(ServiceConfiguration config)  
+        {  
+            ServiceEndpoint se = new ServiceEndpoint(new ContractDescription("IService1"), new BasicHttpBinding(), new EndpointAddress("basic"));  
+            se.Behaviors.Add(new MyEndpointBehavior());  
+            config.AddServiceEndpoint(se);  
+  
+            config.Description.Behaviors.Add(new ServiceMetadataBehavior { HttpGetEnabled = true });  
+            config.Description.Behaviors.Add(new ServiceDebugBehavior { IncludeExceptionDetailInFaults = true });  
+        }  
+  
+        public string GetData(int value)  
+        {  
+            return string.Format("You entered: {0}", value);  
+        }  
+  
+        public CompositeType GetDataUsingDataContract(CompositeType composite)  
+        {  
+            if (composite == null)  
+            {  
+                throw new ArgumentNullException("composite");  
+            }  
+            if (composite.BoolValue)  
+            {  
+                composite.StringValue += "Suffix";  
+            }  
+            return composite;  
+        }  
+    }  
+```  
+  
+ サービスで https などのプロトコルを有効にするには、プロトコルを使用するエンドポイントを明示的に追加するか、ServiceConfiguration.EnableProtocol\(Binding\) を呼び出すことによって自動的にエンドポイントを追加させることができます。このメソッドは、プロトコルおよび定義された各サービス コントラクトと互換性がある各ベース アドレスのエンドポイントを追加します。次のコードは、ServiceConfiguration.EnableProtocol メソッドを使用する方法を示しています。  
+  
+```csharp  
+public class Service1 : IService1   
+{   
+    public string GetData(int value);   
+    public static void Configure(ServiceConfiguration config)   
+    {   
+        // Enable “Add Service Reference” support   
+       config.Description.Behaviors.Add( new ServiceMetadataBehavior { HttpGetEnabled = true });   
+       // set up support for http, https, net.tcp, net.pipe   
+       config.EnableProtocol(new BasicHttpBinding());   
+       config.EnableProtocol(new BasicHttpBinding());   
+       config.EnableProtocol(new NetTcpBinding());   
+       config.EnableProtocol(new NetNamedPipeBinding());   
+       // add an extra BasicHttpBinding endpoint at http:///basic   
+       config.AddServiceEndpoint(typeof(IService1), new BasicHttpBinding(),"basic");   
+    }   
+}   
+```  
+  
+ \<`protocolMappings`\> セクションの設定は、アプリケーション エンドポイントがプログラムによって <xref:System.ServiceModel.ServiceConfiguration> に追加されなかった場合にだけ使用されます。また、<xref:System.ServiceModel.ServiceConfiguration.LoadFromConfiguration%2A> を呼び出すことによって既定のアプリケーション構成ファイルからサービス構成を読み込み、設定を変更することもできます。<xref:System.ServiceModel.ServiceConfiguration> クラスを使って、集中化された構成から構成を読み込むこともできます。次のコードは、その実装方法を示しています。  
+  
+```  
+public class Service1 : IService1   
+{   
+    public void DoWork();   
+    public static void Configure(ServiceConfiguration config)   
+    {   
+          config.LoadFromConfiguration(ConfigurationManager.OpenMappedExeConfiguration(new ExeConfigurationFileMap { ExeConfigFilename = @"c:\sharedConfig\MyConfig.config" }, ConfigurationUserLevel.None));   
+    }   
+}  
+  
+```  
+  
+> [!IMPORTANT]
+>  <xref:System.ServiceModel.LoadFromConfiguration%2A> は、\<`system.serviceModel`\> の \<`service`\> タグ内の \<`host`\> 設定を無視することに注意してください。概念的には、\<`host`\> はサービス構成でなくホスト構成についてのものであり、Configure メソッドを実行する前に読み込まれます。  
+  
+## 参照  
+ [構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)   
+ [クライアントの動作の構成](../../../docs/framework/wcf/configuring-client-behaviors.md)   
+ [簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)   
+ [構成ベースのアクティブ化](../../../docs/framework/wcf/samples/configuration-based-activation.md)   
+ [構成](../../../docs/framework/wcf/samples/configuration-sample.md)   
+ [IIS と WAS における構成ベースのアクティブ化](../../../docs/framework/wcf/feature-details/configuration-based-activation-in-iis-and-was.md)   
+ [構成とメタデータのサポート](../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)   
+ [構成](../../../docs/framework/wcf/diagnostics/exceptions-reference/configuration.md)   
+ [方法 : 構成でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)   
+ [方法 : 構成にサービス エンドポイントを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [方法 : 構成でクライアント バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/contract-first-tool.md b/docs/framework/wcf/contract-first-tool.md
new file mode 100644
index 00000000000..2b2fb3b87d1
--- /dev/null
+++ b/docs/framework/wcf/contract-first-tool.md
@@ -0,0 +1,357 @@
+---
+title: "コントラクト優先ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a880690-f460-4475-a5f4-9f91ce08fcc6
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# コントラクト優先ツール
+サービス コントラクトは、多くの場合、既存のサービスから作成する必要があります。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、コントラクト優先ツールを使用して、データ コントラクト クラスを既存のサービスから自動的に作成できます。コントラクト優先ツールを使用するには、XML スキーマ定義ファイル \(XSD\) をローカルにダウンロードする必要があります。ツールは、HTTP 経由でリモート データ コントラクトをインポートすることはできません。  
+  
+ コントラクト優先ツールは、ビルド タスクとして、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] に統合されています。ビルド タスクによって生成されるコード ファイルは、基になるサービス コントラクトの変更をプロジェクトが簡単に取り込めるように、プロジェクトがビルドされるたびに作成されます。  
+  
+ コントラクト優先ツールがインポートできるスキーマ型には、次のようなものがあります。  
+  
+```  
+<xsd:complexType>  
+<xsd:simpleType>  
+```  
+  
+ 単純型は、`Int16` または `String` のようなプリミティブである場合は生成されません。複合型は、`Collection` 型である場合は生成されません。他の `xsd:complexType` の一部である型も、生成されません。これらのすべての場合に、型はプロジェクト内の既存の型を参照するようになります。  
+  
+## プロジェクトへのデータ コントラクトの追加  
+ コントラクト優先ツールを使用する前に、サービス コントラクト \(XSD\) をプロジェクトに追加する必要があります。この概要説明では、コントラクト優先機能を示すために、次のコントラクトを使用します。このサービス定義は、Bing の検索 API で使用されているサービス コントラクトのごく一部です。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema id="ServiceSchema"  
+    targetNamespace="http://tempuri.org/ServiceSchema.xsd"  
+    elementFormDefault="qualified"  
+    xmlns="http://tempuri.org/ServiceSchema.xsd"  
+    xmlns:mstns="http://tempuri.org/ServiceSchema.xsd"  
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"  
+>  
+  <xs:complexType name="SearchRequest">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="1" name="Version" type="xs:string" default="2.2" />  
+      <xs:element minOccurs="0" maxOccurs="1" name="Market" type="xs:string" />  
+      <xs:element minOccurs="0" maxOccurs="1" name="UILanguage" type="xs:string" />  
+      <xs:element minOccurs="1" maxOccurs="1" name="Query" type="xs:string" />  
+      <xs:element minOccurs="1" maxOccurs="1" name="AppId" type="xs:string" />  
+      <xs:element minOccurs="0" maxOccurs="1" name="Latitude" type="xs:double" />  
+      <xs:element minOccurs="0" maxOccurs="1" name="Longitude" type="xs:double" />  
+      <xs:element minOccurs="0" maxOccurs="1" name="Radius" type="xs:double" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:simpleType name="WebSearchOption">  
+    <xs:restriction base="xs:string">  
+      <xs:enumeration value="DisableHostCollapsing" />  
+      <xs:enumeration value="DisableQueryAlterations" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+  
+```  
+  
+ 上のサービス コントラクトをプロジェクトに追加するには、プロジェクトを右クリックし、**\[新規追加\]** をクリックします。\[テンプレート\] ダイアログ ボックスの \[WCF\] ペインで \[スキーマ定義\] を選択し、新しいファイルの名前を SampleContract.xsd にします。上のコードをコピーし、新しいファイルのコード ビューに貼り付けます。  
+  
+## コントラクト優先のオプションの構成  
+ コントラクト優先のオプションは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] プロジェクトの \[プロパティ\] メニューで構成できます。コントラクト優先を開発できるようにするには、プロジェクト プロパティ ウィンドウの WCF ページで **\[XSD を型定義言語として有効にする\]** チェック ボックスをオンにします。  
+  
+ ![コントラクト優先を示す WCF プロジェクト オプション](../../../docs/framework/wcf/media/contractfirstoptions.png "ContractFirstOptions")  
+  
+ 高度なプロパティを構成するには、\[詳細設定\] ボタンをクリックします。  
+  
+ ![詳細なコントラクト優先プロパティ](../../../docs/framework/wcf/media/contractfirstadvanced.png "ContractFirstAdvanced")  
+  
+ 次の詳細設定は、コントラクトからコードを生成するために構成できます。設定は、プロジェクト内のすべてのファイルに対してのみ構成できます。現時点では、ファイルごとの構成はできません。  
+  
+-   **\[シリアライザー モード\]**: この設定は、サービス コントラクト ファイルの読み取りにどのシリアライザーを使用するかを決定します。**\[XML シリアライザー\]** を選択すると、**\[コレクションの型\]** と **\[再利用の型\]** オプションは無効になります。これらのオプションは、**\[データ コントラクト シリアライザー\]** だけに適用されます。  
+  
+-   **\[再利用の型\]**: この設定は、型の再利用にどのライブラリを使用するかを指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[コレクションの型\]**: この設定は、コレクション データ型に使用する完全修飾型またはアセンブリ修飾型を指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[ディクショナリの型\]**: この設定は、ディクショナリ データ型に使用する完全修飾型またはアセンブリ修飾型を指定します。  
+  
+-   **\[EnableDataBinding\]**: この設定は、データ バインドを実装するために、すべてのデータ型に <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装するかどうかを指定します。  
+  
+-   **\[ExcludedTypes\]**: この設定は、参照アセンブリから除外する完全修飾型またはアセンブリ修飾型のリストを指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[GenerateInternalTypes\]**: この設定は、internal としてマークされるクラスを生成するかどうかを指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[GenerateSerializableTypes\]**: この設定は、<xref:System.SerializableAttribute> 属性を持つクラスを生成するかどうかを指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[ImportXMLTypes\]**: この設定は、<xref:System.Runtime.Serialization.DataContractAttribute> 属性がないクラスに <xref:System.SerializableAttribute> 属性を適用するようにデータ コントラクト シリアライザーを構成するかどうかを指定します。この設定は、**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合にだけ適用されます。  
+  
+-   **\[SupportFx35TypedDataSets\]**: この設定は、.NET Framework 3.5 用に作成された、型指定されたデータ セットのために、追加機能を提供するかどうかを指定します。**\[シリアライザー モード\]** が **\[XML シリアライザー\]** に設定されている場合、この値が True に設定されていると、<xref:System.Data.Design.TypedDataSetSchemaImporterExtensionFx35> 拡張機能が XML スキーマ インポーターに追加されます。**\[シリアライザー モード\]** が **\[データ コントラクト シリアライザー\]** に設定されている場合、この値が False に設定されていると、型 <xref:System.DateTimeOffset> が \[参照\] から除外され、より古いフレームワーク バージョンのために [DateTimeOffset](assetId:///DateTimeOffset?qualifyHint=False&amp;autoUpgrade=True) が常に生成されるようになります。  
+  
+-   **\[InputXsdFiles\]**: この設定は、入力ファイルのリストを指定します。各ファイルは、有効な XML スキーマを含んでいる必要があります。  
+  
+-   **\[言語\]**: この設定は、生成されるコントラクト コードの言語を指定します。設定は、<xref:System.CodeDom.Compiler.CodeDomProvider> が認識できるものである必要があります。  
+  
+-   **\[NamespaceMappings\]**: この設定は、XSD ターゲット名前空間から CLR 名前空間へのマッピングを指定します。各マッピングは、次の形式を使用する必要があります。  
+  
+    ```xml  
+    “<Schema Namespace>, <CLR Namespace>”  
+    ```  
+  
+     XML シリアライザーは、次の形式の 1 つのマッピングだけを受け取ります。  
+  
+    ```xml  
+    “*, <CLR Namespace>”  
+    ```  
+  
+-   **\[OutputDirectory\]**: この設定は、コード ファイルが生成されるディレクトリを指定します。  
+  
+ 設定は、プロジェクトのビルド時に、サービス コントラクト ファイルからサービス コントラクト型を生成するために使用されます。  
+  
+## コントラクト優先開発の使用  
+ サービス コントラクトをプロジェクトに追加し、ビルド設定を確認した後、**F6** キーを押してプロジェクトをビルドします。これで、サービス コントラクトで定義された型が、プロジェクト内で利用できるようになります。  
+  
+ サービス コントラクトで定義した型を使用するには、現在の名前空間に `ContractTypes` への参照を追加します。  
+  
+```csharp  
+using MyProjectNamespace.ContractTypes;  
+```  
+  
+ これで、サービス コントラクトで定義された型が、以下に示すように、プロジェクト内で解決可能になります。  
+  
+ ![サービス コントラクトから派生した型の使用](../../../docs/framework/wcf/media/contractfirsttypes.png "ContractFirstTypes")  
+  
+ ツールによって生成された型は、GeneratedXSDTypes.cs ファイル内に作成されます。このファイルは、既定では、\<プロジェクト ディレクトリ\>\/obj\/\<ビルド構成\>\/XSDGeneratedCode\/ ディレクトリ下に作成されます。このトピックの冒頭のサンプル スキーマは、次のように変換されています。  
+  
+```scr  
+//------------------------------------------------------------------------------  
+// <auto-generated>  
+//     This code was generated by a tool.  
+//     Runtime Version:4.0.30319.17330  
+//  
+//     Changes to this file may cause incorrect behavior and will be lost if  
+//     the code is regenerated.  
+// </auto-generated>  
+//------------------------------------------------------------------------------  
+  
+namespace TestXSD3.ContractTypes  
+{  
+    using System.Xml.Serialization;  
+  
+    /// <remarks/>  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Xml", "4.0.30319.17330")]  
+    [System.SerializableAttribute()]  
+    [System.Diagnostics.DebuggerStepThroughAttribute()]  
+    [System.ComponentModel.DesignerCategoryAttribute("code")]  
+    [System.Xml.Serialization.XmlTypeAttribute(Namespace="http://tempuri.org/ServiceSchema.xsd")]  
+    [System.Xml.Serialization.XmlRootAttribute(Namespace="http://tempuri.org/ServiceSchema.xsd", IsNullable=true)]  
+    public partial class SearchRequest  
+    {  
+  
+        private string versionField;  
+  
+        private string marketField;  
+  
+        private string uILanguageField;  
+  
+        private string queryField;  
+  
+        private string appIdField;  
+  
+        private double latitudeField;  
+  
+        private bool latitudeFieldSpecified;  
+  
+        private double longitudeField;  
+  
+        private bool longitudeFieldSpecified;  
+  
+        private double radiusField;  
+  
+        private bool radiusFieldSpecified;  
+  
+        public SearchRequest()  
+        {  
+            this.versionField = "2.2";  
+        }  
+  
+        /// <remarks/>  
+        [System.ComponentModel.DefaultValueAttribute("2.2")]  
+        public string Version  
+        {  
+            get  
+            {  
+                return this.versionField;  
+            }  
+            set  
+            {  
+                this.versionField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public string Market  
+        {  
+            get  
+            {  
+                return this.marketField;  
+            }  
+            set  
+            {  
+                this.marketField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public string UILanguage  
+        {  
+            get  
+            {  
+                return this.uILanguageField;  
+            }  
+            set  
+            {  
+                this.uILanguageField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public string Query  
+        {  
+            get  
+            {  
+                return this.queryField;  
+            }  
+            set  
+            {  
+                this.queryField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public string AppId  
+        {  
+            get  
+            {  
+                return this.appIdField;  
+            }  
+            set  
+            {  
+                this.appIdField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public double Latitude  
+        {  
+            get  
+            {  
+                return this.latitudeField;  
+            }  
+            set  
+            {  
+                this.latitudeField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        [System.Xml.Serialization.XmlIgnoreAttribute()]  
+        public bool LatitudeSpecified  
+        {  
+            get  
+            {  
+                return this.latitudeFieldSpecified;  
+            }  
+            set  
+            {  
+                this.latitudeFieldSpecified = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public double Longitude  
+        {  
+            get  
+            {  
+                return this.longitudeField;  
+            }  
+            set  
+            {  
+                this.longitudeField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        [System.Xml.Serialization.XmlIgnoreAttribute()]  
+        public bool LongitudeSpecified  
+        {  
+            get  
+            {  
+                return this.longitudeFieldSpecified;  
+            }  
+            set  
+            {  
+                this.longitudeFieldSpecified = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        public double Radius  
+        {  
+            get  
+            {  
+                return this.radiusField;  
+            }  
+            set  
+            {  
+                this.radiusField = value;  
+            }  
+        }  
+  
+        /// <remarks/>  
+        [System.Xml.Serialization.XmlIgnoreAttribute()]  
+        public bool RadiusSpecified  
+        {  
+            get  
+            {  
+                return this.radiusFieldSpecified;  
+            }  
+            set  
+            {  
+                this.radiusFieldSpecified = value;  
+            }  
+        }  
+    }  
+  
+    /// <remarks/>  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Xml", "4.0.30319.17330")]  
+    [System.SerializableAttribute()]  
+    [System.Xml.Serialization.XmlTypeAttribute(Namespace="http://tempuri.org/ServiceSchema.xsd")]  
+    [System.Xml.Serialization.XmlRootAttribute(Namespace="http://tempuri.org/ServiceSchema.xsd", IsNullable=false)]  
+    public enum WebSearchOption  
+    {  
+  
+        /// <remarks/>  
+        DisableHostCollapsing,  
+  
+        /// <remarks/>  
+        DisableQueryAlterations,  
+    }  
+}  
+  
+```  
+  
+## エラーと警告  
+ XSD スキーマの解析中に発生したエラーと警告は、ビルドのエラーと警告として表示されます。  
+  
+## インターフェイスの継承  
+ コントラクト優先開発と共にインターフェイス継承を使用することはできません。これは、インターフェイスが他の操作で動作する方法と一致しています。基本インターフェイスを継承するインターフェイスを使用するには、2 つの別個のエンドポイントを使用します。最初のエンドポイントは継承されるコントラクトを使用し、2 番目のエンドポイントは基本インターフェイスを実装します。
\ No newline at end of file
diff --git a/docs/framework/wcf/controlling-auto-launching-of-wcf-service-host.md b/docs/framework/wcf/controlling-auto-launching-of-wcf-service-host.md
new file mode 100644
index 00000000000..99fe94bb1b2
--- /dev/null
+++ b/docs/framework/wcf/controlling-auto-launching-of-wcf-service-host.md
@@ -0,0 +1,39 @@
+---
+title: "WCF サービス ホストの自動起動の制御 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WcfOptions"
+ms.assetid: 6abe5d34-519b-4cef-8f02-3c0a7f125585
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WCF サービス ホストの自動起動の制御
+[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] ソリューションに複数のプロジェクトが含まれている場合、既定では、同じソリューション内の別のプロジェクトをデバッグするときでも、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクトの [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス ホスト \(WcfSvcHost.exe\) が自動的に起動します。この自動起動機能は制御できます。  
+  
+ これを行うには、**ソリューション エクスプローラー**で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス プロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[WCF オプション\]** タブをクリックします。既定では、**\[同じソリューション内での別のプロジェクトのデバッグ時に WCF サービス ホストを開始する\]** チェック ボックスがオンになっています。チェック ボックスをオフにすると、同じソリューションで別のプロジェクトがデバッグされるときに、この特定のプロジェクトの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストを起動しないように指定できます。  
+  
+ この動作は、F5 キーによるデバッグや、このプロジェクトへのサービス参照の追加の機能には影響を与えません。  
+  
+ このオプションは、次のプロジェクトで使用できます。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクト  
+  
+-   シーケンシャル ワークフロー サービス ライブラリ プロジェクト  
+  
+-   ステート マシン ワークフロー サービス ライブラリ プロジェクト  
+  
+-   配信サービス ライブラリ プロジェクト  
+  
+## 参照  
+ [WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/controlling-resource-consumption-and-improving-performance.md b/docs/framework/wcf/controlling-resource-consumption-and-improving-performance.md
new file mode 100644
index 00000000000..fde0a9d07c2
--- /dev/null
+++ b/docs/framework/wcf/controlling-resource-consumption-and-improving-performance.md
@@ -0,0 +1,58 @@
+---
+title: "リソース消費の制御とパフォーマンスの向上 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a829669-5f76-4c88-80ec-92d0c62c0660
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# リソース消費の制御とパフォーマンスの向上
+ここでは、リソース消費を制御し、パフォーマンス メトリックに影響を与える [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アーキテクチャのさまざまな領域の各種プロパティについて説明します。  
+  
+## WCF でのリソース消費を制約するプロパティ  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、セキュリティまたはパフォーマンスを向上する目的で、特定の種類のプロセスに制約が適用されます。これらの制約には、クォータとスロットルという 2 つの主要な形式があります。*"クォータ"* は、この値に達するか、または超えたときに、システムの特定の場所で即座に例外を発生させる制限です。*"スロットル"* は、即座に例外がスローされない制限です。スロットル制限に達すると、例外がスローされる代わりに、そのスロットル値によって設定された制限の範囲内で処理が続行されます。この制限された処理によって他の場所で例外が発生する可能性がありますが、これはアプリケーションに依存します。  
+  
+ クォータとスロットルの違いに加え、シリアル化レベル、トランスポート レベル、およびアプリケーション レベルにも制約を加えるプロパティがあります。たとえば、システム提供のすべてのトランスポート バインディング要素によって実装されるクォータである <xref:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize%2A?displayProperty=fullName> は、既定で 65,536 バイトに設定されます。これは、悪意のあるクライアントがサービスに対して、大量のメモリを消費させるサービス拒否攻撃を実行することを防ぐための措置です \(通常は、この値を下げることによってパフォーマンスを向上できます\)。  
+  
+ シリアル化のクォータの例としては、<xref:System.Runtime.Serialization.DataContractSerializer.MaxItemsInObjectGraph%2A?displayProperty=fullName> プロパティがあります。このプロパティは、シリアライザーが <xref:System.Runtime.Serialization.DataContractSerializer.ReadObject%2A> メソッドの 1 回の呼び出しでシリアル化または逆シリアル化するオブジェクトの最大数を指定します。アプリケーション レベルのスロットルの例としては、<xref:System.ServiceModel.Dispatcher.ServiceThrottle.MaxConcurrentSessions%2A?displayProperty=fullName> プロパティがあります。このプロパティは、既定で、セッションフル チャネルの同時接続の最大数を 10 に制限します \(クォータとは異なり、このスロットル値に達しても、アプリケーションは処理を続行しますが、新しいセッションフル チャネルは受け入れません。つまり、他のセッションフル チャネルのいずれかが終了するまで、新しいクライアントは接続できません\)。  
+  
+ これらの制御は、特定の種類の攻撃に対してすぐに使用できる軽減策を提供し、メモリの占有領域や起動時間などのパフォーマンス メトリックを向上するように設計されています。ただし、アプリケーションによっては、これらの制御によってサービス アプリケーションのパフォーマンスが低下したり、アプリケーションがまったく動作しなくなったりする可能性があります。たとえば、ビデオ ストリーミング用に設計されたアプリケーションは、既定の <xref:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize%2A?displayProperty=fullName> プロパティをすぐに超える可能性があります。ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のすべてのレベルでアプリケーションに適用されるさまざまな制御の概要を示し、特定の設定がアプリケーションの実行を妨げているかどうかに関する詳細情報を取得するためのさまざまな方法について説明し、さまざまな問題を修正する方法について説明します。ほとんどのスロットルおよび一部のクォータは、基本プロパティがシリアル化またはトランスポートの制約である場合でも、アプリケーション レベルで利用できます。たとえば、サービス クラスの <xref:System.ServiceModel.ServiceBehaviorAttribute.MaxItemsInObjectGraph%2A?displayProperty=fullName> を使用して、<xref:System.Runtime.Serialization.DataContractSerializer.MaxItemsInObjectGraph%2A?displayProperty=fullName> プロパティを設定できます。  
+  
+> [!NOTE]
+>  特定の問題がある場合は、まず「[WCF トラブルシューティング クイックスタート](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md)」に目を通し、発生している問題 \(および解決方法\) が記載されているかどうかを確認してください。  
+  
+ シリアル化プロセスを制限するプロパティの一覧は、「[セキュリティに関するデータの考慮事項](../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」にあります。トランスポートに関連するリソースの消費を制限するプロパティの一覧は、「[トランスポート クォータ](../../../docs/framework/wcf/feature-details/transport-quotas.md)」にあります。アプリケーション層でリソースの消費を制限するプロパティは、<xref:System.ServiceModel.Dispatcher.ServiceThrottle> クラスのメンバーです。  
+  
+## クォータ設定に関連するアプリケーションとパフォーマンスの問題の検出  
+ 上記の値の既定値は、一般的なセキュリティの問題に対する基本的な保護を提供しながら、さまざまなアプリケーションで基本的なアプリケーション機能を使用できるように選択されたものです。ただし、アプリケーション デザインによっては、1 つ以上のスロットル設定を超えてしまったためにアプリケーションがセキュリティで保護されなかったり、設計どおりに動作しなかったりする場合があります。その場合は、超過したスロットル値とそのレベルを特定し、アプリケーションのスループットを向上するための適切な手順を決定する必要があります。  
+  
+ 通常、アプリケーションを作成してデバッグする際には、構成ファイルまたはプログラムで <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティを `true` に設定します。これによって、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] にサービス例外のスタック トレースをクライアント アプリケーションに返して表示するように指示できます。この機能により、ほとんどのアプリケーション レベルの例外が報告され、問題が発生している場合に、どのクォータ設定が関係しているかを表示できます。  
+  
+ 実行時に発生する一部の例外はアプリケーション層から見えないため、このメカニズムでは返されません。このため、カスタムの <xref:System.ServiceModel.Dispatcher.IErrorHandler?displayProperty=fullName> 実装で処理できないことがあります。Microsoft Visual Studio などの開発環境で作業している場合は、これらの例外のほとんどは自動的に表示されます。ただし、Visual Studio 2005 の \[[マイ コードのみ](http://go.microsoft.com/fwlink/?LinkId=82174)\] の設定など、開発環境設定によって一部の例外がマスクされる可能性があります。  
+  
+ 開発環境の機能に関係なく、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のトレース機能とメッセージ ログ機能を使用すると、すべての例外のデバッグとアプリケーションのパフォーマンス調整を実行できます。詳細については、「[トレースを使用したアプリケーションのトラブルシューティング](../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)」を参照してください。  
+  
+## パフォーマンスの問題と XmlSerializer  
+ <xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるデータ型を使用するサービスおよびクライアント アプリケーションは、実行時にこのようなデータ型のシリアル化コードを生成およびコンパイルします。このため、起動時のパフォーマンスが低下することがあります。  
+  
+> [!NOTE]
+>  生成済みシリアル化コードはクライアント アプリケーションでのみ使用できます。サービスでは使用できません。  
+  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すると、必要なシリアル化コードをアプリケーションのコンパイル済みアセンブリから生成することで、このようなアプリケーションの起動時のパフォーマンスを改善できます。詳細については、「[方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)」を参照してください。  
+  
+## ASP.NET で WCF サービスをホストする場合のパフォーマンスの問題  
+ WCF サービスを IIS および ASP.NET でホストする場合、IIS と ASP.NET の構成設定が WCF サービスのスループットやメモリの占有領域に影響する場合があります。ASP.NET のパフォーマンス[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ASP.NET パフォーマンスの向上](http://go.microsoft.com/fwlink/?LinkId=186462)」を参照してください。予想外の結果を引き起こす可能性のある設定の 1 つに、<xref:System.Web.Configuration.ProcessModelSection.MinWorkerThreads%2A> があります。これは、<xref:System.Web.Configuration.ProcessModelSection> のプロパティです。アプリケーションのクライアントが固定数または少数である場合、<xref:System.Web.Configuration.ProcessModelSection.MinWorkerThreads%2A> を 2 に設定すると、CPU の使用率が 100% に近いマルチプロセッサ コンピューターのスループットが向上する場合があります。このパフォーマンスの向上にはコストが伴います。つまり、メモリの使用率も増加するため、スケーラビリティが低下する場合があります。  
+  
+## 参照  
+ [管理と診断](../../../docs/framework/wcf/diagnostics/index.md)   
+ [大規模データとストリーミング](../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/creating-ws-i-basic-profile-1-1-interoperable-services.md b/docs/framework/wcf/creating-ws-i-basic-profile-1-1-interoperable-services.md
new file mode 100644
index 00000000000..3bc2963c037
--- /dev/null
+++ b/docs/framework/wcf/creating-ws-i-basic-profile-1-1-interoperable-services.md
@@ -0,0 +1,50 @@
+---
+title: "WS-I Basic Profile 1.1 の相互運用可能サービスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "構成 [WCF], 相互運用可能サービス"
+ms.assetid: 91b70a21-8f5c-4679-808c-2ed5fa6b2013
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WS-I Basic Profile 1.1 の相互運用可能サービスの作成
+[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サービス クライアントと相互運用できるように [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] サービス エンドポイントを構成するには、以下に従います。  
+  
+-   使用して、 <xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName>サービス エンドポイントのバインディングの種類として。  
+  
+-   コールバック コントラクト機能とセッション コントラクト機能の使用、およびトランザクション動作のサービス エンドポイントでの使用をいずれも行わない。  
+  
+ 必要に応じて、HTTPS およびトランスポート レベルのクライアント認証のサポートをバインディングで有効にできます。  
+  
+ 次の機能、 <xref:System.ServiceModel.BasicHttpBinding>クラスは、WS 以外の機能を必要と-基本プロファイル 1.1。  
+  
+-   によって制御される message Transmission Optimization Mechanism (MTOM) メッセージ エンコーディング、 <xref:System.ServiceModel.BasicHttpBinding.MessageEncoding%2A?displayProperty=fullName>プロパティです。 このプロパティは、既定値のままに<xref:System.ServiceModel.WSMessageEncoding?displayProperty=fullName> MTOM を使用しないようにします。  
+  
+-   によって制御されるメッセージ セキュリティ、 <xref:System.ServiceModel.BasicHttpBinding.Security%2A?displayProperty=fullName>値に準拠した Ws-security サポートを提供するには Basic Security Profile 1.0 です。 このプロパティは、既定値のままに<xref:System.ServiceModel.SecurityMode?displayProperty=fullName> Ws-security を使用しないようにします。  
+  
+ メタデータを有効にする、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]に利用できるサービス[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)]、Web サービス クライアント生成ツールを使用して: [Web サービス記述言語ツール (Wsdl.exe)](http://msdn.microsoft.com/ja-jp/b9210348-8bc2-4367-8c91-d1a04b403e88)、 [Web サービス検出ツール (Disco.exe)](http://msdn.microsoft.com/ja-jp/acd88078-c581-42bc-94ca-6633e2851979)、および`Add Web Reference`機能[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)]; メタデータの公開を有効にする必要があります。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][メタデータ エンドポイントを公開](../../../docs/framework/wcf/publishing-metadata-endpoints.md)します。  
+  
+## <a name="example"></a>例  
+  
+### <a name="description"></a>説明  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サービス クライアントと互換性のある [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] エンドポイントをコードおよび構成ファイルで追加する方法を次のコード例に示します。  
+  
+### <a name="code"></a>コード  
+ [!code-csharp[C_HowTo-WCFServiceAndASMXClient#0](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/cs/program.cs#0)]
+ [!code-vb[C_HowTo-WCFServiceAndASMXClient#0](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/vb/program.vb#0)]  
+  
+ [!code[C_HowTo-WCFServiceAndASMXClient#1](../../../samples/snippets/common/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/common/app.config#1)]  
+  
+## <a name="see-also"></a>関連項目  
+ [ASP.NET Web サービスとの相互運用性](../../../docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/defining-and-specifying-faults.md b/docs/framework/wcf/defining-and-specifying-faults.md
new file mode 100644
index 00000000000..eeb8cba7b9a
--- /dev/null
+++ b/docs/framework/wcf/defining-and-specifying-faults.md
@@ -0,0 +1,103 @@
+---
+title: "エラーの定義と指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エラーの処理 [WCF], 定義"
+  - "エラーの処理 [WCF], 指定"
+ms.assetid: c00c84f1-962d-46a7-b07f-ebc4f80fbfc1
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# エラーの定義と指定
+SOAP エラーを使用する目的は、エラー状態情報をサービスからクライアントに伝達し、双方向のシナリオでは、相互利用が可能な手段でクライアントからサービスにも伝達することです。  ここでは、カスタムのエラー コンテンツをいつどのように定義し、そのエラーを返す操作をどのように指定するかについて説明します。  サービスまたは双方向クライアントがエラーを送信する方法、およびクライアントまたはサービス アプリケーションがエラーを処理する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[エラーの送受信](../../../docs/framework/wcf/sending-and-receiving-faults.md)」を参照してください。  [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでのエラー処理の概要については、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  
+  
+## 概要  
+ 宣言された SOAP エラーは、カスタム SOAP エラーの種類を指定する <xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName> を含む操作で発生します。  宣言されていない SOAP エラーとは、操作のコントラクトに指定されていないエラーです。  ここでは、各種のエラー状態を特定したうえで、サービスに関するエラー コントラクトを作成する方法について説明します。クライアントは、カスタムの SOAP エラーから通知を受けたときに、これらを使用することでエラーを適切に処理できます。  基本的な作業は、次の順序で行います。  
+  
+1.  サービスのクライアントに通知する必要があるエラー状態を定義します。  
+  
+2.  そのエラー状態に対して SOAP エラーのカスタム コンテンツを定義します。  
+  
+3.  操作でスローされた特定の SOAP エラーがクライアントに公開されるように、WSDL でその操作にマークします。  
+  
+### クライアントに通知する必要があるエラー状態の定義  
+ SOAP エラーは、特定の操作に関するフォールト情報を伝達するためにパブリックに記述されたメッセージです。  これらのメッセージは、WSDL で他の操作メッセージと共に記述されているので、クライアントは、操作を呼び出した時点でこのようなエラー処理を予測できます。  ただし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスはマネージ コードで記述されています。マネージ コードで記述されたどのエラー状態をフォールトに変換し、クライアントに返す必要があるかを決定することによって、サービスのエラー状態やバグは、クライアントとの間でエラーに関して行われる正規のメッセージ交換から分離することができます。  
+  
+ たとえば、次のコード例には、2 つの整数を受け取り、別の整数を返す操作があります。  ここではいくつかの例外がスローされる可能性があります。そのため、エラー コントラクトを設計するときに、クライアントにとって重要なエラー状態を判別する必要があります。  この場合、サービスでは <xref:System.DivideByZeroException?displayProperty=fullName> 例外を検出する必要があります。  
+  
+```csharp  
+[ServiceContract]  
+public class CalculatorService  
+{  
+    [OperationContract]   
+    int Divide(int a, int b)  
+    {  
+      if (b==0) throw new Exception("Division by zero!");  
+      return a/b;  
+    }  
+}  
+```  
+  
+```vb  
+<ServiceContract> _  
+Public Class CalculatorService  
+    <OperationContract]> _  
+    Public Function Divide(ByVal a As Integer, ByVal b As Integer) _  
+       As Integer  
+      If (b==0) Then   
+            Throw New Exception("Division by zero!")  
+      Return a/b  
+    End Function  
+End Class  
+```  
+  
+ この例で操作から返せるエラーには、ゼロによる除算に特化したカスタム SOAP エラー、ゼロ除算に特化した情報が算術演算に特化したエラーに含まれているもの、複数の異なるエラー状態に対する複数のエラーなどがあります。SOAP エラーを返さないことも選択できます。  
+  
+### エラー状態のコンテンツの定義  
+ 意義のあるカスタム SOAP エラーを返すエラー状態を特定したら、次の手順では、そのエラーのコンテンツを定義し、コンテンツ構造をシリアル化できるようにします。  前のセクションのコード例では、`Divide` 演算に特化したエラーを示していました。しかし、`Calculator` サービスに他の演算がある場合、1 つのカスタム SOAP エラーで、`Divide` を含むすべての電卓エラー状態をクライアントに通知することも可能です。  次のコード例では、`Divide` を含むすべての算術演算で生成されたエラーを報告するためのカスタム SOAP エラー `MathFault` を作成しています。  このクラスでは、操作 \(`Operation` プロパティ\) と問題を説明する値 \(`ProblemType` プロパティ\) を指定できますが、カスタム SOAP エラーでクライアントに転送するには、クラスとこれらのプロパティがシリアル化可能である必要があります。  このため、<xref:System.Runtime.Serialization.DataContractAttribute?displayProperty=fullName> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute?displayProperty=fullName> 属性を使用して、型とそのプロパティをシリアル化可能にし、できる限り相互運用可能にします。  
+  
+ [!code-csharp[Faults#2](../../../samples/snippets/csharp/VS_Snippets_CFX/faults/cs/service.cs#2)]
+ [!code-vb[Faults#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faults/vb/service.vb#2)]  
+  
+ データをシリアル化可能にする方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービス コントラクトでのデータ転送の指定](../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。  <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName> で提供されるシリアル化サポートの一覧については、「[データ コントラクト シリアライザーでサポートされる型](../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)」を参照してください。  
+  
+### エラー コントラクトを確立するための操作のマーク  
+ カスタム SOAP エラーの一部として返されるシリアル化可能なデータ構造を定義したら、最後に、その型の SOAP エラーをスローできることを操作コントラクトにマークします。  これには、<xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName> 属性を使用して、作成したカスタム データ型の型を渡します。  <xref:System.ServiceModel.FaultContractAttribute> 属性を使用して、`Divide` 操作で `MathFault` 型の SOAP エラーを返すように指定する方法を次のコード例に示します。  他の算術に関する操作でも、`MathFault` を返せるように指定できます。  
+  
+ [!code-csharp[Faults#1](../../../samples/snippets/csharp/VS_Snippets_CFX/faults/cs/service.cs#1)]
+ [!code-vb[Faults#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faults/vb/service.vb#1)]  
+  
+ 操作に複数の <xref:System.ServiceModel.FaultContractAttribute> 属性をマークすることによって、その操作で複数のカスタム エラーを返すことを指定できます。  
+  
+ 操作実装にエラー コントラクトを実装する方法については、「[エラーの送受信](../../../docs/framework/wcf/sending-and-receiving-faults.md)」を参照してください。  
+  
+#### SOAP、WSDL、相互運用性に関する考慮事項  
+ 特に他のプラットフォームと相互運用するときなど、状況によっては、SOAP メッセージでエラーを表す方法または WSDL メタデータでエラーを記述する方法を制御することが重要な場合があります。  
+  
+ <xref:System.ServiceModel.FaultContractAttribute> 属性の <xref:System.ServiceModel.FaultContractAttribute.Name%2A> プロパティを使用すると、エラーに対してメタデータで生成される WSDL エラー要素名を制御できます。  
+  
+ SOAP 標準に従って、エラーには、`Action`、`Code`、および `Reason` を指定することができます。  `Action` は、<xref:System.ServiceModel.FaultContractAttribute.Action%2A> プロパティによって制御されます。  <xref:System.ServiceModel.FaultException.Code%2A> プロパティと <xref:System.ServiceModel.FaultException.Reason%2A> プロパティは、ジェネリック <xref:System.ServiceModel.FaultException%601?displayProperty=fullName> の親クラスである <xref:System.ServiceModel.FaultException?displayProperty=fullName> クラスのプロパティです。  `Code` プロパティには、<xref:System.ServiceModel.FaultCode.SubCode%2A> メンバーが含まれています。  
+  
+ エラーを生成する非サービスを利用する場合には、特定の制限事項があります。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、スキーマによって記述され、データ コントラクトと互換性のある、詳細な型を持つエラーしかサポートされません。  たとえば、上記のように [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、詳細な型で XML 属性を使用するエラーや、詳細セクションに複数のトップレベル要素を持つエラーがサポートされていません。  
+  
+## 参照  
+ <xref:System.ServiceModel.FaultContractAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ [コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)   
+ [エラーの送受信](../../../docs/framework/wcf/sending-and-receiving-faults.md)   
+ [方法 : サービス コントラクトでのエラーを宣言する](../../../docs/framework/wcf/how-to-declare-faults-in-service-contracts.md)   
+ [保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)   
+ [方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)   
+ [サービス コントラクトでのデータ転送の指定](../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/deploying-a-wcf-library-project.md b/docs/framework/wcf/deploying-a-wcf-library-project.md
new file mode 100644
index 00000000000..89994265cb0
--- /dev/null
+++ b/docs/framework/wcf/deploying-a-wcf-library-project.md
@@ -0,0 +1,27 @@
+---
+title: "WCF ライブラリ プロジェクトの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f9222fe-d358-443c-9a49-12c5498e35e7
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF ライブラリ プロジェクトの配置
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス ライブラリ プロジェクトの配置方法について説明します。  
+  
+## WCF サービス ライブラリの配置  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリは、ダイナミックリンク ライブラリ \(DLL\) です。それ自体を単独で実行することはできません。ホスティング環境に配置する必要があります。このプロセスの詳細については、「[WCF サービスのホスティングと利用](http://go.microsoft.com/fwlink/?LinkId=99932)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリは、他の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと同様に配置できます。ただし、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、DLL に対する構成はサポートされていません<xref:System.Configuration> では、アプリケーション ドメイン 1 つにつき、1 つの構成ファイルがサポートされています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクトにより、配置中、ライブラリに App.config ファイルが提供され、この制限が緩和されます。ただし、配置後、この App.config ファイルは認識されません。  
+  
+ 構成コードは、ホスティング環境で認識されている構成ファイルに移動する必要があります。自己ホストを行うには、App.config ファイルの内容をホスティング実行可能形式の App.config ファイルにコピーしてください。サービスのホスティングに IIS を使用する場合は、App.config ファイルの内容を仮想ディレクトリの Web.config ファイルにコピーする必要があります。
\ No newline at end of file
diff --git a/docs/framework/wcf/deploying-wcf-applications-with-clickonce.md b/docs/framework/wcf/deploying-wcf-applications-with-clickonce.md
new file mode 100644
index 00000000000..4b2ec95e337
--- /dev/null
+++ b/docs/framework/wcf/deploying-wcf-applications-with-clickonce.md
@@ -0,0 +1,26 @@
+---
+title: "ClickOnce を使用して WCF アプリケーションを展開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1a11feee-2a47-4d3e-a28a-ad69d5ff93e0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ClickOnce を使用して WCF アプリケーションを展開する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] を使用しているクライアント アプリケーションは、ClickOnce テクノロジを使用して展開できます。このテクノロジを使用すると、クライアント アプリケーションが、信頼できる証明書でデジタル署名されている場合、コード アクセス セキュリティによって提供されるランタイム セキュリティ保護を受けられます。ClickOnce アプリケーションの署名に使用される証明書は、信頼された発行者のストアに存在する必要があり、またそのクライアント コンピューターのローカル セキュリティ ポリシーでは、発行者の証明書で署名されたアプリケーションに対して、完全信頼のアクセス許可が構成される必要があります。  
+  
+ ClickOnce アプリケーションの構成と信頼された発行者の詳細については、「[Configuring ClickOnce Trusted Publishers](http://go.microsoft.com/fwlink/?LinkId=94774)」を参照してください。  
+  
+## 参照  
+ [信頼されたアプリケーションの配置の概要](http://go.microsoft.com/fwlink/?LinkId=94775)   
+ [Windows フォーム アプリケーションの ClickOnce 配置](http://go.microsoft.com/fwlink/?LinkId=94776)
\ No newline at end of file
diff --git a/docs/framework/wcf/designing-and-implementing-services.md b/docs/framework/wcf/designing-and-implementing-services.md
new file mode 100644
index 00000000000..7ebbbce2360
--- /dev/null
+++ b/docs/framework/wcf/designing-and-implementing-services.md
@@ -0,0 +1,81 @@
+---
+title: "サービスの設計と実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービス コントラクトの定義 [WCF]"
+ms.assetid: 036fae20-7c55-4002-b71d-ac4466e167a3
+caps.latest.revision: 37
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 37
+---
+# サービスの設計と実装
+ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コントラクトを定義および実装する方法について説明します。サービス コントラクトでは、エンドポイントが外部と何をやりとりするかが指定されます。具体的には、要求\/応答、一方向、双方向など、基本的なメッセージ交換パターン \(MEP\) に編成された一連のメッセージに関する記述です。サービス コントラクトがメッセージ交換の論理的に関連したセットであるとすると、サービス操作は単一のメッセージ交換です。たとえば、`Hello` 操作は、呼び出し元があいさつを通知できるように、1 つのメッセージを受け入れる必要があることは明らかであり、メッセージを返す場合もあれば、返さない場合もあります \(この操作のマナーによって異なります\)。  
+  
+ コントラクトおよびその他の [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] の中核的な概念の詳細については、「[Windows Communication Foundation の基本概念](../../../docs/framework/wcf/fundamental-concepts.md)」を参照してください。ここでは、サービス コントラクトを理解することに重点を置きます。サービス コントラクトを使用してサービスに接続するクライアントを構築する方法の詳細については、「[WCF クライアントの概要](../../../docs/framework/wcf/wcf-client-overview.md)」を参照してください。  
+  
+## 概要  
+ ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの設計および実装に関する大まかな概念的方向付けを行います。サブトピックでは、設計と実装の仕様についてさらに詳しく説明します。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションを設計および実装する前に、次の準備をしておくことをお勧めします。  
+  
+-   サービス コントラクトの概要、しくみ、および作成方法について理解する。  
+  
+-   コントラクトとは、実行時の構成またはホスト環境でサポートされていない可能性のある最小限の要件を記述するものであることを理解する。  
+  
+## サービス コントラクト  
+ サービス コントラクトは、次の内容を指定します。  
+  
+-   コントラクトが公開する操作  
+  
+-   交換するメッセージに関する操作のシグネチャ  
+  
+-   交換するメッセージのデータ型  
+  
+-   操作の場所  
+  
+-   サービスとの正常な通信をサポートするために使用するプロトコルとシリアル化形式  
+  
+ たとえば、注文情報の種類に関する入力を受け入れ、発注 ID を含めた成功または失敗の情報を返す `CreateOrder` 操作が含まれた発注書コントラクトがあるとします。このコントラクトには、発注 ID を受け入れ、注文ステータス情報を返す `GetOrderStatus` 操作も含まれている場合があります。この種のサービス コントラクトでは、次のような指定が必要になります。  
+  
+1.  発注書コントラクトが `CreateOrder` 操作と `GetOrderStatus` 操作で構成されていること。  
+  
+2.  これらの操作によって、入力メッセージと出力メッセージが指定されていること。  
+  
+3.  これらのメッセージが伝達できるデータ。  
+  
+4.  メッセージを正常に処理するために必要な通信インフラストラクチャに関する明確な記述。たとえば、正常な通信を確立するためにセキュリティが必要かどうか、また、どのような形式のセキュリティが必要かなどの詳細を記述します。  
+  
+ この種の情報を多くのプラットフォーム上 \(マイクロソフト以外のプラットフォームも含みます\) の他のアプリケーションに伝達するために、XML サービス コントラクトは、[Web Services Description Language](http://go.microsoft.com/fwlink/?LinkId=94952) \(WSDL\) や [XML Schema](http://go.microsoft.com/fwlink/?LinkId=94953) \(XSD\) などの標準 XML 形式で公開されます。多くのプラットフォームの開発者は、このパブリック コントラクト情報を使用して、サービスと通信できるアプリケーションを作成できます。これは、開発者が仕様の言語を理解しているだけでなく、これらの言語はサービスがサポートするパブリックな形式、書式、およびプロトコルを記述することで相互運用できるように設計されているためです。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] がこの種の情報を処理する方法の詳細については、「[メタデータ](../../../docs/framework/wcf/feature-details/metadata.md)」を参照してください。  
+  
+ コントラクトはさまざまな方法で表現できます。WSDL と XSD は、利用しやすい方法でサービスを記述する優れた言語である一方、直接使用することが難しい言語です。また、サービスを記述するに過ぎず、サービス コントラクトの実装ではありません。そのため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションでは、マネージ属性、マネージ インターフェイス、およびマネージ クラスを使用して、サービスの構造の定義と実装の両方を行います。  
+  
+ マネージ型で定義されたコントラクトは、クライアントやその他のサービス実装側が必要とする場合に、メタデータ \(WSDL および XSD\) として*エクスポート*することができます。これにより、どのクライアント アプリケーションに対しても \(パブリック メタデータを使用して\) 記述できる、簡単なプログラミング モデルが実現します。基になる SOAP メッセージの詳細や、トランスポートとセキュリティ関連の情報などは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に残しておくことができます。WCF は、サービス コントラクト型システムと XML 型システム間で必要な変換を自動的に実行します。  
+  
+ コントラクトの設計の詳細については、「[サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。コントラクトの実装の詳細については、「[サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)」を参照してください。  
+  
+### 重要なメッセージ  
+ リモート プロシージャ コール \(RPC\) スタイルのメソッド シグネチャを使用する場合、マネージ インターフェイス、マネージ クラス、およびマネージ メソッドを使用してサービス操作をモデル化することは簡単です。メソッドにパラメーターを渡し、戻り値を受け取る方法は、オブジェクトや他の種類のコードから機能を要求する通常の形式です。たとえば、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] や C\+\+ COM のようなマネージ言語を使用するプログラマは、\(オブジェクトとインターフェイスのどちらを使用するかに関係なく\) RPC スタイルの手法に関する知識を、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス コントラクトの作成に応用できます。この場合、RPC スタイルの分散オブジェクト システムに固有の問題は発生しません。サービス指向では、RPC プログラミングの容易さと知識を保持しながら、疎結合のメッセージ指向プログラミングの利点を得ることができます。  
+  
+ プログラマの多くは、メッセージ キュー \(Microsoft MSMQ、.NET Framework の <xref:System.Messaging> 名前空間、HTTP 要求における構造化されていない XML の送信など\) のようなメッセージ指向のアプリケーション プログラミング インターフェイスの方が使いやすいと考えています。メッセージ レベルのプログラミングの詳細については、「[メッセージ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-message-contracts.md)」、「[サービス チャネル レベルのプログラミング](../../../docs/framework/wcf/extending/service-channel-level-programming.md)」、および「[POX アプリケーションとの相互運用性](../../../docs/framework/wcf/feature-details/interoperability-with-pox-applications.md)」を参照してください。  
+  
+### 要件の階層の理解  
+ サービス コントラクトは、操作をグループ化し、メッセージ交換パターン、メッセージの種類、およびメッセージに格納されているデータ型を指定します。さらに、実装でコントラクトをサポートするために必要な実行時の動作のカテゴリ \(メッセージの暗号化と署名を要求するなど\) を示します。サービス コントラクト自体は、これらの要件を満たす方法を正確に指定するわけではなく、これらの要件が必要であることを示すだけです。暗号化の種類やメッセージに署名する方法は、準拠サービスの実装と構成によって決まります。  
+  
+ コントラクトに必要なのは、サービス コントラクトの実装と、動作を追加するための実行時の構成に関するものであるという点に注意してください。使用するサービスを公開するために満たす必要のある要件のセットは、上記の要件のセットを基に作成されます。コントラクトが実装の要件を作成しても、実装ではサービスの実行を可能にするために、さらに多くの構成とバインディングを必要とする場合があります。また、ホスト アプリケーションも、サービス構成とバインディングによって追加されるすべての要件をサポートする必要があります。  
+  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス アプリケーションを設計、実装、構成、およびホストする際には、この追加要件の処理に注意することが重要です。たとえば、コントラクトでセッションをサポートする必要があることが指定されている場合があります。その場合、コントラクトの要件をサポートするようにバインディングを構成する必要があります。そうしないと、サービス実装は機能しなくなります。また、サービスで統合 Windows 認証が必要であり、インターネット インフォメーション サービス \(IIS\) でホストされる場合、サービスが存在する Web アプリケーションでは、統合 Windows 認証を有効にし、匿名サポートを無効にする必要があります。さまざまなサービス ホスト アプリケーションの機能と影響の詳細については、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+## 参照  
+ [サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)   
+ [サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/designing-service-contracts.md b/docs/framework/wcf/designing-service-contracts.md
new file mode 100644
index 00000000000..8f02a6f9ad8
--- /dev/null
+++ b/docs/framework/wcf/designing-service-contracts.md
@@ -0,0 +1,291 @@
+---
+title: "サービス コントラクトの設計 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF]"
+ms.assetid: 8e89cbb9-ac84-4f0d-85ef-0eb6be0022fd
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# サービス コントラクトの設計
+ここでは、サービス コントラクトの概要、定義方法、使用できる操作 \(および基になるメッセージ交換に対する影響\)、使用するデータ型、およびシナリオの要件を満たす操作を設計する際に役立つその他の問題について説明します。  
+  
+## サービス コントラクトの作成  
+ サービスは複数の操作を公開します。[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでは、メソッドを作成し、<xref:System.ServiceModel.OperationContractAttribute> 属性でマークすることによって操作を定義します。次に、サービス コントラクトを作成するために、<xref:System.ServiceModel.ServiceContractAttribute> 属性でマークされたインターフェイス内で操作を宣言するか、この属性でマークされたクラス内で操作を定義することにより、操作をグループ化します \(基本的な例については、「[方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)」を参照してください\)。  
+  
+ <xref:System.ServiceModel.OperationContractAttribute> 属性を持たないメソッドはサービス操作ではないため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスによって公開されることはありません。  
+  
+ ここでは、サービス コントラクトの設計時に決定すべき以下のポイントについて説明します。  
+  
+-   クラスとインターフェイスのどちらを使用するか  
+  
+-   交換するデータ型の指定方法  
+  
+-   使用できる交換パターンの種類  
+  
+-   コントラクトのセキュリティ要件の部分を明示的に作成できるかどうか  
+  
+-   操作の入力と出力の制限  
+  
+## クラスとインターフェイス  
+ クラスとインターフェイスは、いずれも機能のグループ化を表します。したがって、どちらを使用しても [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス コントラクトを定義できます。ただし、インターフェイスはサービス コントラクトを直接モデル化するため、インターフェイスを使用することをお勧めします。実装のないインターフェイスは、特定のシグネチャを持つメソッドのグループ化を定義しているにすぎません。サービス コントラクト インターフェイスを実装してはじめて、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを実装したことになります。  
+  
+ サービス コントラクト インターフェイスには、次のようにマネージ インターフェイスのあらゆる利点がもたらされます。  
+  
+-   サービス コントラクト インターフェイスでは、他のサービス コントラクト インターフェイスをいくつでも拡張できます。  
+  
+-   これらのサービス コントラクト インターフェイスを実装することにより、1 つのクラスでサービス コントラクトをいくつでも実装できます。  
+  
+-   インターフェイスの実装を変更することにより、同じサービス コントラクトを引き続き使用したまま、そのコントラクトの実装を変更できます。  
+  
+-   以前のインターフェイスと新しいインターフェイスを実装することで、サービスをバージョン管理できます。以前のクライアントは元のバージョンに接続し、新しいクライアントは新しいバージョンに接続できます。  
+  
+> [!NOTE]
+>  他のサービス コントラクト インターフェイスから継承した場合、操作のプロパティ \(名前や名前空間など\) をオーバーライドすることはできません。これを行う場合は、現在のサービス コントラクトに新しい操作を作成します。  
+  
+ インターフェイスを使用したサービス コントラクトの作成[!INCLUDE[crexample](../../../includes/crexample-md.md)]、「[方法 : コントラクト インターフェイスを使用してサービスを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-with-a-contract-interface.md)」を参照してください。  
+  
+ クラスを使用すると、サービス コントラクトの定義と実装を一度に行うことができます。<xref:System.ServiceModel.ServiceContractAttribute> と <xref:System.ServiceModel.OperationContractAttribute> をそれぞれクラスとクラスのメソッドに直接適用してサービスを作成する方法には、サービスを迅速かつ簡単に作成できるという利点があります。欠点は、マネージ クラスでは複数の継承をサポートしていないため、サービス コントラクトを一度に 1 つしか実装できないことです。また、クラスまたはメソッド シグネチャに変更を加えると、そのサービスのパブリック コントラクトが変更されるため、変更されていないクライアントがサービスを使用できなくなることがあります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md).  
+  
+ クラスを使用してサービス コントラクトの作成と実装を一度に行う例については、「[方法 : コントラクト クラスを使用してサービスを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-wcf-contract-with-a-class.md)」を参照してください。  
+  
+ これで、サービス コントラクトを定義する際に、インターフェイスを使用した場合とクラスを使用した場合の違いがわかりました。次に、サービスとクライアント間で受け渡しできるデータを決定します。  
+  
+## パラメーターと戻り値  
+ 各操作は戻り値とパラメーターを持ちます \(戻り値とパラメーターが `void` の場合も含まれます\)。ただし、オブジェクトへの参照をオブジェクト間で渡すことができるローカル メソッドとは異なり、サービス操作ではオブジェクトへの参照を渡しません。代わりに、オブジェクトのコピーを渡します。  
+  
+ これが重要なのは、パラメーターまたは戻り値で使用される各型がシリアル化可能でなければならないためです。つまり、その型のオブジェクトをバイト ストリームに変換でき、バイト ストリームからオブジェクトに変換できる必要があります。  
+  
+ プリミティブ型は既定でシリアル化可能であり、.NET Framework の多くの型も同様です。  
+  
+> [!NOTE]
+>  操作シグネチャのパラメーター名の値はコントラクトに含まれ、大文字と小文字が区別されます。ローカルでは同じパラメーター名を使用するが、公開されるメタデータでは名前を変更する場合は、<xref:System.ServiceModel.MessageParameterAttribute?displayProperty=fullName> を参照してください。  
+  
+#### データ コントラクト  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションのようなサービス指向アプリケーションは、マイクロソフトとマイクロソフト以外の両方のプラットフォームで、できる限り多くのクライアント アプリケーションと相互運用できるように設計されています。最大限の相互運用性を実現するために、使用する型を <xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性でマークして、データ コントラクトを作成することをお勧めします。データ コントラクトは、サービス コントラクトの一部であり、サービス操作で交換するデータを記述したものです。  
+  
+ データ コントラクトは opt\-in 方式のコントラクトです。つまり、データ コントラクト属性を明示的に適用しない限り、型またはデータ メンバーはシリアル化されません。データ コントラクトはマネージ コードのアクセス スコープとして関連付けられていません。プライベートのデータ メンバーはシリアル化され、パブリックにアクセスされる他の場所に送信されます \(データ コントラクトの基本的な例については、「[方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md)」を参照してください\)。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、基になる SOAP メッセージの定義を処理します。このメッセージにより、操作の機能が有効になるだけでなく、データ型とメッセージ本文との間での双方向のシリアル化が可能になります。使用するデータ型がシリアル化可能であれば、操作の設計時に、基盤となるメッセージ交換インフラストラクチャについて考える必要はありません。  
+  
+ 通常の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションは <xref:System.Runtime.Serialization.DataContractAttribute> 属性および <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を使用して操作のデータ コントラクトを作成しますが、他のシリアル化機構を使用することもできます。<xref:System.Runtime.Serialization.ISerializable>、<xref:System.SerializableAttribute>、および <xref:System.Xml.Serialization.IXmlSerializable> の各標準機構はすべて、基になる SOAP メッセージへのデータ型のシリアル化を処理します。このメッセージはアプリケーション間でデータ型を伝達します。使用するデータ型で特別なサポートが必要な場合は、さらに多くのシリアル化方法を使用できます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションのデータ型をシリアル化するためのオプション[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービス コントラクトでのデータ転送の指定](../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。  
+  
+#### メッセージ交換へのパラメーターと戻り値のマッピング  
+ サービス操作は、特定の標準セキュリティ、トランザクション、およびセッション関連の機能をサポートするためにアプリケーションが必要とするデータに加え、アプリケーション データをやり取りする SOAP メッセージの基になる交換によってサポートされます。このため、サービス操作のシグネチャでは、データ転送と操作に必要な機能をサポートできる、基になる*メッセージ交換パターン* \(MEP: Message Exchange Pattern\) を指定します。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] プログラミング モデルでは、要求\/応答、一方向、および双方向の 3 つのメッセージ パターンを指定できます。  
+  
+##### 要求\/応答  
+ 要求\/応答パターンでは、要求の送信側 \(クライアント アプリケーション\) は、その要求に関連付けられた応答を受信します。このパターンでは、1 つの操作において、1 つ以上のパラメーターを操作に渡し、戻り値を呼び出し元に返すことができるため、このパターンが既定の MEP となります。たとえば、次の C\# コード例は、文字列を 1 つ受け取り、文字列を返す基本的なサービス操作を示しています。  
+  
+```csharp  
+[OperationContractAttribute]  
+string Hello(string greeting);  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+```vb  
+<OperationContractAttribute()>  
+Function Hello (ByVal greeting As String) As String  
+```  
+  
+ この操作シグネチャは、基になるメッセージ交換の形式を指定しています。相関関係がない場合、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は戻り値の対象となる操作を特定できません。  
+  
+ 別の基になるメッセージ パターンを指定しない限り、`void` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `Nothing`\) を返すサービス操作も要求\/応答メッセージ交換です。クライアントが操作を非同期で呼び出していない場合、通常、メッセージが空の場合でも、戻りメッセージを受信するまでクライアントは処理を中止します。クライアントが応答で空のメッセージを受信するまで制御が戻らない操作の C\# コード例を次に示します。  
+  
+```csharp  
+[OperationContractAttribute]  
+void Hello(string greeting);  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+```vb  
+<OperationContractAttribute()>  
+Sub Hello (ByVal greeting As String)  
+```  
+  
+ 上記の例では、実行に時間のかかる操作の場合に、クライアントのパフォーマンスと応答性が低下するおそれがありますが、要求\/応答操作で `void` を返す場合でも、この操作には利点があります。最も明らかな利点は、応答メッセージで SOAP エラーを返すことが可能であるということです。これにより、通信と処理のどちらで発生したかに関係なく、サービス関連の何らかのエラー状態が発生したことがわかります。サービス コントラクトに指定された SOAP エラーは、<xref:System.ServiceModel.FaultException%601> オブジェクトとしてクライアント アプリケーションに渡されます。このオブジェクトの型パラメーターは、サービス コントラクトで指定された型です。これにより、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスのエラー状態をクライアントに通知しやすくなります。例外、SOAP エラー、およびエラー処理[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。要求\/応答サービスおよびクライアントの例については、「[方法 : 要求\/応答コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md)」を参照してください。要求\/応答パターンに関する問題[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[要求\/応答サービス](../../../docs/framework/wcf/feature-details/request-reply-services.md)」を参照してください。  
+  
+##### 一方向  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス アプリケーションのクライアントが操作の完了まで待機する必要がなく、SOAP エラーも処理しない場合は、操作で一方向メッセージ パターンを指定できます。一方向操作では、クライアントが操作を呼び出し、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] がメッセージをネットワークに書き込んだら、クライアントは処理を続行できます。通常、これは、送信メッセージで送信するデータが膨大な量でない限り、\(データ送信時にエラーが発生しなければ\) クライアントはほぼすぐに実行を続けることを意味します。この種のメッセージ交換パターンでは、クライアントからサービス アプリケーションへのイベントのような動作をサポートします。  
+  
+ 1 つのメッセージを送信し、何も受信しないメッセージ交換では、`void` 以外の戻り値を指定したサービス操作をサポートすることはできません。この場合、<xref:System.InvalidOperationException> 例外がスローされます。  
+  
+ 戻りメッセージがないということは、処理または通信時のエラーを示すために SOAP エラーを返すこともできないということです \(操作が一方向操作の場合にエラー情報を伝達するには、双方向メッセージ交換パターンが必要です\)。  
+  
+ `void` を返す操作で一方向メッセージ交換を指定するには、次の C\# コード例に示すように、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティを `true` に設定します。  
+  
+```csharp  
+[OperationContractAttribute(IsOneWay=true)]  
+void Hello(string greeting);  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+```vb  
+<OperationContractAttribute(IsOneWay := True)>  
+Sub Hello (ByVal greeting As String)  
+```  
+  
+ このメソッドは、前述の要求\/応答の例と同じです。ただし、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティを `true` に設定するということは、メソッドは同じでも、サービス操作は戻りメッセージを送信せず、送信メッセージがチャネル レイヤーに渡されると、すぐにクライアントに制御が戻ることを意味します。例については、「[方法 : 一方向コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md)」を参照してください。一方向デザイン パターン[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[一方向サービス](../../../docs/framework/wcf/feature-details/one-way-services.md)」を参照してください。  
+  
+##### 双方向  
+ 双方向パターンの特徴は、一方向メッセージングと要求\/応答メッセージングのどちらを使用しているかに関係なく、サービスとクライアントが共に独立して、相互にメッセージを送信できるという点です。二方向通信のこの形式は、サービスがクライアントと直接通信する必要がある場合や、イベントのような動作など、メッセージを交換するどちらの側も非同期で動作できるようにする場合に役立ちます。  
+  
+ 双方向パターンでは、クライアントと通信するための機構が別途必要になるため、要求\/応答パターンや一方向パターンに比べると若干複雑になります。  
+  
+ 双方向コントラクトを設計する場合、コールバック コントラクトも設計し、そのコールバック コントラクトの型を、サービス コントラクトをマークする <xref:System.ServiceModel.ServiceContractAttribute> 属性の <xref:System.ServiceModel.ServiceContractAttribute.CallbackContract%2A> プロパティに割り当てる必要があります。  
+  
+ 双方向パターンを実装するには、クライアントで呼び出されるメソッド宣言を含む 2 つ目のインターフェイスを作成する必要があります。  
+  
+ サービス、およびそのサービスにアクセスするクライアントの作成方法[!INCLUDE[crexample](../../../includes/crexample-md.md)]、「[方法 : 双方向コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」および「[方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)」を参照してください。実際に動作するサンプルについては、「[二重](../../../docs/framework/wcf/samples/duplex.md)」を参照してください。双方向コントラクトの使用に関する問題[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)」を参照してください。  
+  
+> [!CAUTION]
+>  サービスは、双方向メッセージを受信すると、その受信メッセージの `ReplyTo` 要素を参照して応答の送信先を決定します。メッセージの受信に使用するチャネルがセキュリティで保護されていない場合、信頼関係のないクライアントが対象コンピューターの `ReplyTo` を使用して悪意のあるメッセージを送信し、その対象コンピューターのサービス拒否 \(DOS: Denial Of Service\) を引き起こすおそれがあります。  
+  
+##### Out パラメーターと Ref パラメーター  
+ ほとんどの場合、`in` パラメーター \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `ByVal`\) および `out` パラメーターと `ref` パラメーター \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] では `ByRef`\) を使用できます。`out` パラメーターと `ref` パラメーターは、操作からデータが返されることを示すため、操作シグネチャが `void` を返す場合でも、次のような操作シグネチャによって要求\/応答操作が必要であることを指定します。  
+  
+```csharp  
+[ServiceContractAttribute]  
+public interface IMyContract  
+{  
+  [OperationContractAttribute]  
+  public void PopulateData(ref CustomDataType data);  
+}  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+ \[Visual Basic\]  
+  
+```vb  
+<ServiceContractAttribute()> _  
+Public Interface IMyContract  
+  <OperationContractAttribute()> _  
+  Public Sub PopulateData(ByRef data As CustomDataType)  
+End Interface  
+```  
+  
+ 唯一の例外は、シグネチャに特定の構造体が含まれている場合です。たとえば、<xref:System.ServiceModel.NetMsmqBinding> バインディングを使用してクライアントと通信できるのは、操作の宣言に使用されたメソッドが `void` を返す場合だけです。戻り値、`ref` パラメーター、または `out` パラメーターのいずれであるかに関係なく、出力値を指定することはできません。  
+  
+ また、`out` パラメーターまたは `ref` パラメーターを使用する場合、操作には基になる応答メッセージが必要です。このメッセージが変更されたオブジェクトを返します。操作が一方向操作の場合、実行時に <xref:System.InvalidOperationException> 例外がスローされます。  
+  
+### コントラクトでのメッセージ保護レベルの指定  
+ コントラクトの設計時に、コントラクトを実装するサービスのメッセージ保護レベルも決定する必要があります。これは、メッセージ セキュリティをコントラクトのエンドポイントのバインディングに適用する場合にのみ必要です。バインディングのセキュリティが無効になっている場合 \(つまり、システム指定のバインディングで <xref:System.ServiceModel.SecurityMode?displayProperty=fullName> の値が <xref:System.ServiceModel.SecurityMode?displayProperty=fullName> に設定されている場合\)、コントラクトのメッセージ保護レベルを決定する必要はありません。ほとんどの場合、メッセージ レベルのセキュリティが適用されたシステム指定のバインディングは、十分な保護レベルを備えているため、操作ごとまたはメッセージごとに保護レベルを検討する必要はありません。  
+  
+ 保護レベルは、サービスをサポートするメッセージ \(またはメッセージ部分\) が署名されるのか、署名および暗号化されるのか、または署名と暗号化なしで送信されるのかを指定する値です。保護レベルは、さまざまなスコープ \(サービス レベル、特定の操作、その操作内のメッセージ、またはメッセージ部分\) で設定できます。あるスコープで設定された値は、明示的にオーバーライドしない限り、そのスコープよりも小さなスコープの既定値になります。コントラクトに必要とされる最小限の保護レベルをバインディング構成で提供できない場合は、例外がスローされます。保護レベルの値がコントラクトで明示的に設定されていない場合、バインディングのメッセージ セキュリティが有効であれば、バインディング構成によってすべてのメッセージの保護レベルが制御されます。これが既定の動作です。  
+  
+> [!IMPORTANT]
+>  一般に、コントラクトのさまざまなスコープを完全な保護レベルである <xref:System.Net.Security.ProtectionLevel?displayProperty=fullName> よりも下のレベルに明示的に設定するかどうかは、パフォーマンスの向上と引き換えに、ある程度のセキュリティで妥協できるかどうかという判断によって決まります。このような場合、操作および操作で交換するデータの価値に焦点を絞って判断を下す必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md).  
+  
+ たとえば、次のコード例では、<xref:System.ServiceModel.ServiceContractAttribute.ProtectionLevel%2A> も、コントラクトの <xref:System.ServiceModel.OperationContractAttribute.ProtectionLevel%2A> プロパティも設定していません。  
+  
+```csharp  
+[ServiceContract]  
+public interface ISampleService  
+{  
+  [OperationContractAttribute]  
+  public string GetString();  
+  
+  [OperationContractAttribute]  
+  public int GetInt();    
+}  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+ \[Visual Basic\]  
+  
+```vb  
+<ServiceContractAttribute()> _  
+Public Interface ISampleService  
+  
+  <OperationContractAttribute()> _  
+  Public Function GetString()As String  
+  
+  <OperationContractAttribute()> _  
+  Public Function GetData() As Integer  
+  
+End Interface  
+  
+```  
+  
+ 既定の <xref:System.ServiceModel.WSHttpBinding> \(既定の <xref:System.ServiceModel.SecurityMode?displayProperty=fullName> は <xref:System.ServiceModel.SecurityMode>\) を使用するエンドポイントの `ISampleService` 実装とやり取りする場合は、暗号化と署名が既定の保護レベルであるため、すべてのメッセージが暗号化および署名されます。ただし、既定の <xref:System.ServiceModel.BasicHttpBinding> \(既定の <xref:System.ServiceModel.SecurityMode> は <xref:System.ServiceModel.SecurityMode>\) を使用して `ISampleService` サービスを使用すると、すべてのメッセージがテキストとして送信されます。これは、このバインディングにはセキュリティがないため、保護レベルが無視されるためです \(つまり、メッセージの暗号化も署名も行われません\)。<xref:System.ServiceModel.SecurityMode> を <xref:System.ServiceModel.SecurityMode> に変更すると、これがこのバインディングの既定の保護レベルになるため、これらのメッセージは暗号化および署名されるようになります。  
+  
+ コントラクトの保護要件を明示的に指定または調整する場合は、<xref:System.ServiceModel.ServiceContractAttribute.ProtectionLevel%2A> プロパティ \(またはより小さなスコープの `ProtectionLevel` プロパティのいずれか\) をサービス コントラクトに必要なレベルに設定します。この場合、明示的な設定を使用するには、使用するスコープに少なくともその設定をサポートするバインディングが必要です。たとえば、次のコード例では、`GetGuid` 操作の <xref:System.ServiceModel.OperationContractAttribute.ProtectionLevel%2A> の値を明示的に指定しています。  
+  
+```csharp  
+[ServiceContract]  
+public interface IExplicitProtectionLevelSampleService  
+{  
+  [OperationContractAttribute]  
+  public string GetString();  
+  
+  [OperationContractAttribute(ProtectionLevel=ProtectionLevel.None)]  
+  public int GetInt();    
+  [OperationContractAttribute(ProtectionLevel=ProtectionLevel.EncryptAndSign)]  
+  public int GetGuid();    
+}  
+```  
+  
+ 次のコードは同等の Visual Basic コードです。  
+  
+```vb  
+<ServiceContract()> _   
+Public Interface IExplicitProtectionLevelSampleService   
+    <OperationContract()> _   
+    Public Function GetString() As String   
+    End Function   
+  
+    <OperationContract(ProtectionLevel := ProtectionLevel.None)> _   
+    Public Function GetInt() As Integer   
+    End Function   
+  
+    <OperationContractAttribute(ProtectionLevel := ProtectionLevel.EncryptAndSign)> _   
+    Public Function GetGuid() As Integer   
+    End Function   
+  
+End Interface  
+  
+```  
+  
+ この `IExplicitProtectionLevelSampleService` コントラクトを実装し、既定の <xref:System.ServiceModel.WSHttpBinding> \(既定の <xref:System.ServiceModel.SecurityMode?displayProperty=fullName> は <xref:System.ServiceModel.SecurityMode>\) を使用するエンドポイントを持つサービスの動作は次のようになります。  
+  
+-   `GetString` 操作のメッセージは、暗号化および署名されます。  
+  
+-   `GetInt` 操作のメッセージは、暗号化も署名もされない \(プレーン\) テキストとして送信されます。  
+  
+-   `GetGuid` 操作の <xref:System.Guid?displayProperty=fullName> は、暗号化および署名されたメッセージで返されます。  
+  
+ 保護レベルとその使用方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。セキュリティ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)」を参照してください。  
+  
+##### 操作シグネチャのその他の要件  
+ アプリケーションの一部の機能では、特定の種類の操作シグネチャを必要とします。たとえば、<xref:System.ServiceModel.NetMsmqBinding> バインディングは、永続的なサービスとクライアントをサポートします。永続的なサービスとクライアントでは、通信の途中でアプリケーションを再起動し、メッセージを失うことなく、アプリケーションが中止された場所を検出できます \([!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF のキュー](../../../docs/framework/wcf/feature-details/queues-in-wcf.md).\)ただし、永続的操作では、`in` パラメーターを 1 つしか受け取ることができず、戻り値を持つこともできません。  
+  
+ もう 1 つの例として、操作における <xref:System.IO.Stream> 型の使用が挙げられます。<xref:System.IO.Stream> パラメーターにはメッセージの本文全体が含まれるため、入力または出力 \(つまり、`ref` パラメーター、`out` パラメーター、または戻り値\) が <xref:System.IO.Stream> 型である場合、操作で指定された入力または出力に限定する必要があります。また、パラメーターまたは戻り値の型は <xref:System.IO.Stream>、<xref:System.ServiceModel.Channels.Message?displayProperty=fullName>、<xref:System.Xml.Serialization.IXmlSerializable?displayProperty=fullName> のいずれかである必要があります。ストリーム[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[大規模データとストリーミング](../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)」を参照してください。  
+  
+##### 名前、名前空間、および隠ぺい  
+ コントラクトおよび操作の定義内の .NET 型の名前や名前空間は、コントラクトが WSDL に変換されるとき、およびコントラクト メッセージが作成および送信されるときに重要になります。したがって、サービス コントラクトの名前と名前空間は、<xref:System.ServiceModel.ServiceContractAttribute>、<xref:System.ServiceModel.OperationContractAttribute>、<xref:System.Runtime.Serialization.DataContractAttribute>、<xref:System.Runtime.Serialization.DataMemberAttribute> などの、すべてのサポート対象コントラクト属性や、他のコントラクト属性の `Name` プロパティと `Namespace` プロパティを使用して明示的に設定することを強くお勧めします。  
+  
+ この 1 つの結果として、名前と名前空間が明示的に設定されていない場合、アセンブリで IL 隠ぺいを使用すると、コントラクトの型名と名前空間が変更され、その結果、WSDL が変更され、通常はネットワークでのメッセージ交換に失敗します。コントラクトの名前と名前空間を明示的に設定せずに隠ぺいを使用する場合は、<xref:System.Reflection.ObfuscationAttribute> 属性と <xref:System.Reflection.ObfuscateAssemblyAttribute> 属性を使用して、コントラクトの型名と名前空間が変更されないようにします。  
+  
+## 参照  
+ [方法 : 要求\/応答コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md)   
+ [方法 : 一方向コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md)   
+ [方法 : 双方向コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)   
+ [サービス コントラクトでのデータ転送の指定](../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)   
+ [コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)   
+ [セッションの使用](../../../docs/framework/wcf/using-sessions.md)   
+ [同期操作と非同期操作](../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)   
+ [信頼できるサービス](../../../docs/framework/wcf/reliable-services.md)   
+ [サービスとトランザクション](../../../docs/framework/wcf/services-and-transactions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/developing-service-oriented-applications-with-wcf.md b/docs/framework/wcf/developing-service-oriented-applications-with-wcf.md
new file mode 100644
index 00000000000..27f3e8313d0
--- /dev/null
+++ b/docs/framework/wcf/developing-service-oriented-applications-with-wcf.md
@@ -0,0 +1,29 @@
+---
+title: "WCF でのサービス指向アプリケーションの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/14/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス指向のアプリ [.NET Framework]"
+  - "WCF"
+  - "Windows Communication Foundation"
+ms.assetid: 96aad289-58bc-4389-89d0-b09dfc4d5c58
+caps.latest.revision: 2
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+---
+# WCF でのサービス指向アプリケーションの開発
+このセクションでは、サービス指向アプリケーションを構築するための統一プログラミング モデルを提供する Windows Communication Foundation \(WCF\) について説明します。  これを使用して開発者は、プラットフォーム間を統合し、既存のコンポーネントと相互運用する、セキュリティで保護された信頼性の高いトランザクション型のソリューションを構築できます。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation \(WCF\)](http://go.microsoft.com/fwlink/?LinkId=228205)  
+  
+## 参照  
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/TOC.md b/docs/framework/wcf/diagnostics/TOC.md
new file mode 100644
index 00000000000..9f658561afb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/TOC.md
@@ -0,0 +1,9 @@
+# [メッセージ フローの概要](message-flow-overview.md)
+# [サービスの配置](deploying-services.md)
+# [アプリケーションの構成](configuring-your-application.md)
+# [メッセージ ログ](message-logging.md)
+# [ServiceModel 登録ツール](servicemodel-registration-tool.md)
+# [管理と診断](index.md)
+# [メッセージ ログを参照する](viewing-message-logs.md)
+# [メッセージ ログ記録のセキュリティの考慮事項](security-concerns-for-message-logging.md)
+# [メッセージ ログの構成](configuring-message-logging.md)
diff --git a/docs/framework/wcf/diagnostics/configuring-message-logging.md b/docs/framework/wcf/diagnostics/configuring-message-logging.md
new file mode 100644
index 00000000000..6134a861504
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/configuring-message-logging.md
@@ -0,0 +1,176 @@
+---
+title: "メッセージ ログの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メッセージ ログ [WCF]"
+ms.assetid: 0ff4c857-8f09-4b85-9dc0-89084706e4c9
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# メッセージ ログの構成
+ここでは、さまざまなシナリオでのメッセージ ログの構成方法を示します。  
+  
+## メッセージ ログの有効化  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、既定で、メッセージを記録しません。メッセージ ログをアクティブにするには、トレース リスナーを `System.ServiceModel.MessageLogging` トレース ソースに追加し、構成ファイルで `<messagelogging>` 要素の属性を設定する必要があります。  
+  
+ 次の例は、ログを有効にして追加オプションを指定する方法を示しています。  
+  
+```  
+<system.diagnostics>  
+  <sources>  
+      <source name="System.ServiceModel.MessageLogging">  
+        <listeners>  
+                 <add name="messages"  
+                 type="System.Diagnostics.XmlWriterTraceListener"  
+                 initializeData="c:\logs\messages.svclog" />  
+          </listeners>  
+      </source>  
+    </sources>  
+</system.diagnostics>  
+  
+<system.serviceModel>  
+  <diagnostics>  
+    <messageLogging   
+         logEntireMessage="true"   
+         logMalformedMessages="false"  
+         logMessagesAtServiceLevel="true"   
+         logMessagesAtTransportLevel="false"  
+         maxMessagesToLog="3000"  
+         maxSizeOfMessageToLog="2000"/>  
+  </diagnostics>  
+</system.serviceModel>  
+```  
+  
+ メッセージ ログ設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トレースとメッセージ ログの推奨設定](../../../../docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md)」を参照してください。  
+  
+ `add` を使用して、使用するリスナーの名前と型を指定することができます。この例の構成では、リスナーに "messages" という名前を付け、使用する型として標準の .NET Framework トレース リスナー \(`System.Diagnostics.XmlWriterTraceListener`\) を追加しています。`System.Diagnostics.XmlWriterTraceListener` を使用する場合は、構成ファイルで出力ファイルの場所と名前を指定する必要があります。指定するには、`initializeData` をログ ファイルの名前に設定します。それ以外の場合、例外がスローされます。また、既定のファイルにログを出力するカスタム リスナーを実装することもできます。  
+  
+> [!NOTE]
+>  メッセージ ログはディスク領域にアクセスするため、ディスクに書き込む特定のサービスのメッセージ数を制限する必要があります。メッセージ数が上限に達すると、情報レベルでのトレースが生成され、すべてのメッセージ ログ処理が停止します。  
+  
+ ログ レベルと追加オプションについては、「ログ レベルとオプション」のセクションで説明します。  
+  
+ `source` の `switchValue` 属性は、トレースに対してのみ有効です。`switchValue` 属性を `System.ServiceModel.MessageLogging` トレース ソースに対して次のように指定しても無効です。  
+  
+```  
+<source name="System.ServiceModel.MessageLogging" switchValue="Verbose">  
+```  
+  
+ トレース ソースを無効にする場合は、代わりに `messageLogging` 要素の `logMessagesAtServiceLevel` 属性、`logMalformedMessages` 属性、および `logMessagesAtTransportLevel` 属性を使用する必要があります。これらすべての属性を `false` に設定します。この設定を行うには、構成エディター UI インターフェイスで前のコード例の構成ファイルを使用するか、または WMI を使用します。構成エディター ツール[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)」を参照してください。WMI [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../docs/framework/wcf/diagnostics/wmi/index.md)」を参照してください。  
+  
+## ログ レベルとオプション  
+ 受信メッセージの場合は、メッセージが形成された直後、サービス レベルでメッセージがユーザー コードで処理される直前、および正しくないメッセージが検出されたときに、ログが記録されます。  
+  
+ 送信メッセージの場合は、メッセージがユーザー コードから出力された直後およびメッセージがネットワークに出力される直前に、ログが記録されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、サービスとトランスポートの 2 種類のレベルでメッセージを記録します。不正なメッセージも記録されます。3 つのカテゴリは互いに独立しており、構成で個別に有効にすることができます。  
+  
+ `messageLogging` 要素の `logMessagesAtServiceLevel`、`logMalformedMessages`、および `logMessagesAtTransportLevel` の各属性を設定することによって、ログ レベルを制御することができます。  
+  
+### サービス レベル  
+ このレイヤーでは、ユーザー コードに入力 \(受信時\) される直前、またはユーザー コードから出力 \(送信時\) される直前のメッセージが記録されます。フィルターを定義した場合は、そのフィルターと一致するメッセージだけが記録されます。それ以外の場合は、サービス レベルのすべてのメッセージが記録されます。このレベルでは、インフラストラクチャ メッセージ \(トランザクション、ピア チャネル、およびセキュリティ\) も記録されます。ただし、信頼できるメッセージング メッセージは記録されません。ストリーム メッセージの場合は、ヘッダーだけが記録されます。また、セキュリティで保護されたメッセージもこのレベルで復号化されて記録されます。  
+  
+### トランスポート レベル  
+ このレイヤーで記録されるメッセージは、ネットワーク上での転送に向けてエンコードできる状態になっているもの、および転送後にデコードできる状態になっているものです。フィルターを定義した場合は、そのフィルターと一致するメッセージだけが記録されます。それ以外の場合は、トランスポート レイヤーのすべてのメッセージが記録されます。このレイヤーでは、信頼できるメッセージング メッセージを含むすべてのインフラストラクチャ メッセージが記録されます。ストリーム メッセージの場合は、ヘッダーだけが記録されます。また、セキュリティで保護されたメッセージも、HTTPS などのセキュリティで保護されたトランスポートを使用している場合を除き、暗号化された状態でこのレベルで記録されます。  
+  
+### 不正レベル  
+ 不正なメッセージとは、処理の任意の段階で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] スタックによって拒否されたメッセージのことです。正しくないメッセージは、そのままの状態で記録されます。暗号化されていれば、暗号化されたままで、適切でない XML も、そのままになります。`maxSizeOfMessageToLog` は、CDATA として記録されるメッセージのサイズを定義します。`maxSizeOfMessageToLog` の既定値は 256 K です。この属性[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「他のオプション」のセクションを参照してください。  
+  
+### その他のオプション  
+ ログ レベルに加えて、次のオプションを指定することができます。  
+  
+-   全体メッセージの記録 \(`logEntireMessage` 属性\) : この値は、全体メッセージ \(メッセージ ヘッダーと本文\) を記録するかどうかを指定します。既定値は、`false` で、ヘッダーだけ記録することを意味します。この設定は、サービス メッセージ ログ レベルおよびトランスポート メッセージ ログ レベルに影響を与えます。  
+  
+-   記録するメッセージの最大数 \(`maxMessagesToLog` 属性\) : この値は、記録するメッセージの最大数を指定します。すべてのメッセージ \(サービス メッセージ、トランスポート メッセージ、および不正メッセージ\) が、このクォータに対してカウントされます。クォータに達すると、トレースが出力され、それ以上メッセージは記録されません。既定値は 10000 です。  
+  
+-   記録するメッセージの最大サイズ \(`maxSizeOfMessageToLog` 属性\) : この値は、記録するメッセージの最大サイズをバイト単位で指定します。サイズ制限を超えたメッセージは記録されず、そのメッセージに対して何の処理も実行されません。この設定は、すべてのトレース レベルに影響を与えます。ServiceModel トレースがオンの場合は、最初の記録ポイントで警告レベル トレース \(ServiceModelSend\* または TransportReceive\) が出力され、ユーザーに通知します。サービス レベルとトランスポート レベルのメッセージの既定値は 256 K ですが、正しくないメッセージの既定値は 4 K です。  
+  
+    > [!CAUTION]
+    >  `maxSizeOfMessageToLog` と照合するために計算されるメッセージ サイズは、シリアル化される前のメモリ上でのメッセージ サイズです。このサイズは、記録されるメッセージ文字列の実際の長さとは異なります。実際のサイズよりも大きい場合がほとんどです。その結果、メッセージが記録されない場合があります。`maxSizeOfMessageToLog` 属性をメッセージの見積もりサイズよりも 10% 大きく設定することによって、この現象を回避することができます。また、不正メッセージを記録する場合は、メッセージ ログに使用する実際のディスク領域を、`maxSizeOfMessageToLog` で指定した値の最大 5 倍にすることができます。  
+  
+ 構成ファイルでトレース リスナーを定義していない場合は、ログ レベルの指定に関係なくログ出力は生成されません。  
+  
+ このセクションで説明されている属性などのメッセージ ログ オプションは、実行時に WMI \(Windows Management Instrumentation\) を使用して変更できます。変更するには、`LogMessagesAtServiceLevel`、`LogMessagesAtTransportLevel`、および `LogMalformedMessages` のブール型プロパティを公開する [AppDomainInfo](../../../../docs/framework/wcf/diagnostics/wmi/appdomaininfo.md) インスタンスにアクセスします。そのため、メッセージ ログ用のトレース リスナーを構成していても、これらのオプションを構成で `false` に設定している場合は、後でアプリケーションを実行しているときに `true` に変更できます。これで、メッセージ ログが実行時に有効になります。同様に、構成ファイルでメッセージ ログを有効にしている場合は、実行時に WMI を使用して無効にできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../docs/framework/wcf/diagnostics/wmi/index.md).  
+  
+ メッセージ ログの `source` フィールドは、要求メッセージを送信または受信する際に要求\/応答または一方向の要求については、サービス モデル レイヤーまたはトランスポート レイヤーで、または正しくないメッセージの場合に、メッセージを記録するコンテキストを指定します。  
+  
+ 正しくないメッセージの場合、`source` は、`Malformed` になります。それ以外の場合、source には、コンテキストに基づいて、以下の値が設定されます。  
+  
+ 要求\/応答の場合  
+  
+||Send Request|Receive Request|Send Reply|Receive Reply|  
+|-|------------------|---------------------|----------------|-------------------|  
+|Service Model layer|サービス<br /><br /> レベル<br /><br /> Send<br /><br /> 要求|サービス<br /><br /> レベル<br /><br /> Receive<br /><br /> 要求|サービス<br /><br /> レベル<br /><br /> Send<br /><br /> Reply|サービス<br /><br /> レベル<br /><br /> Receive<br /><br /> Reply|  
+|Transport layer|トランスポート<br /><br /> Send|トランスポート<br /><br /> Receive|トランスポート<br /><br /> Send|トランスポート<br /><br /> Receive|  
+  
+ 一方向の要求の場合  
+  
+||Send Request|Receive Request|  
+|-|------------------|---------------------|  
+|Service Model layer|サービス<br /><br /> レベル<br /><br /> Send<br /><br /> データグラム|サービス<br /><br /> レベル<br /><br /> Receive<br /><br /> データグラム|  
+|Transport layer|トランスポート<br /><br /> Send|トランスポート<br /><br /> Receive|  
+  
+## メッセージ フィルター  
+ メッセージ フィルターは、`diagnostics` 構成セクションの `messageLogging` 構成要素で定義されます。これらは、サービス レベルとトランスポート レベルで適用されます。1 つ以上のフィルターを定義した場合は、少なくとも 1 つのフィルターと一致するメッセージだけが記録されます。フィルターを定義しなかった場合は、すべてのメッセージが通過します。  
+  
+ フィルターは、完全な XPath 構文をサポートし、構成ファイルでの出現順に適用されます。構文的に不正なフィルターによって、構成例外が発生します。  
+  
+ フィルターは、フィルターに一致するかどうかを確認できる、XPath DOM 内のノードの最大数を制限する `nodeQuota` 属性を使用することで、安全機能も提供します。  
+  
+ 次の例は、SOAP ヘッダー セクションがあるメッセージだけを記録するフィルターの設定方法を示します。  
+  
+```  
+<messageLogging logEntireMessage="true"  
+    logMalformedMessages="true"   
+    logMessagesAtServiceLevel="true"  
+    logMessagesAtTransportLevel="true"  
+    maxMessagesToLog="420">  
+    <filters>  
+        <add nodeQuota="10" xmlns:soap="http://www.w3.org/2003/05/soap-envelope">  
+                 /soap:Envelope/soap:Header  
+        </add>  
+     </filters>  
+</messageLogging>  
+```  
+  
+ フィルターは、メッセージの本文には適用できません。メッセージの本文を操作しようとするフィルターは、フィルターの一覧から削除されます。その場合には、このことを示すイベントも出力されます。たとえば、次のフィルターは、フィルター テーブルから削除されます。  
+  
+```  
+<add xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">/s:Envelope/s:Body[contains(text(), "Hello")]</add>  
+```  
+  
+## カスタム リスナーの構成  
+ 追加オプションでカスタム リスナーを構成することもできます。カスタム リスナーは、記録を行う前に、アプリケーション固有の PII 要素をメッセージからフィルター処理するのに役立ちます。次の例は、カスタム リスナーの構成を示しています。  
+  
+```  
+<system.diagnostics>  
+   <sources>  
+     <source name="System.ServiceModel.MessageLogging">  
+           <listeners>  
+             <add name="MyListener"   
+                    type="YourCustomListener"  
+                    initializeData="c:\logs\messages.svclog"  
+                    maxDiskSpace="1000"/>  
+           </listeners>  
+     </source>  
+   </sources>  
+</system.diagnostics>  
+```  
+  
+ `type` 属性は、型のアセンブリ修飾名に設定する必要があることに注意してください。  
+  
+## 参照  
+ [\<messageLogging\>](../../../../docs/framework/configure-apps/file-schema/wcf/messagelogging.md)   
+ [メッセージ ログ](../../../../docs/framework/wcf/diagnostics/message-logging.md)   
+ [トレースとメッセージ ログの推奨設定](../../../../docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/configuring-your-application.md b/docs/framework/wcf/diagnostics/configuring-your-application.md
new file mode 100644
index 00000000000..55ad1e349d2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/configuring-your-application.md
@@ -0,0 +1,42 @@
+---
+title: "アプリケーションの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2f995b0-669d-4721-b00f-4561ec7eb6a4
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# アプリケーションの構成
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、.NET 構成システムを使用して、コンピューターとアプリケーションのスコープでサービスを構成できるようにします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって定義された構成設定は、`<system.serviceModel>` セクション グループにあります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの構成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、次のトピックを参照してください。  
+  
+-   [サービスの構成](../../../../docs/framework/wcf/configuring-services.md)  
+  
+-   [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)  
+  
+ アプリケーション定義の構成設定は、`<appSettings>` セクション グループで定義されます。.NET 構成ファイルのアプリケーション設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[\<appSettings\>](http://go.microsoft.com/fwlink/?LinkId=95159)」を参照してください。  
+  
+## 構成エディターの使用  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] [構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) のグラフィカル ユーザー インターフェイスを使用して、管理者と開発者は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの構成設定を作成および変更できます。このツールを使用すると、XML 構成ファイルを直接編集せずに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のバインディング、動作、サービス、および診断の設定を管理できます。  
+  
+## Visual Studio の構成ファイルの編集  
+ [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス プロジェクトの構成ファイルを編集するには、**ソリューション エクスプローラー**で構成ファイルを右クリックし、**\[WCF 構成の編集\]** コンテキスト メニュー項目を選択します。これにより[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) が起動されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービス プロジェクトの構成ファイルを**ソリューション エクスプローラー**で右クリックして編集する場合は、**\[Edit WCF Config\]** コンテキスト メニュー項目が表示されません。この問題を回避するには、**\[ツール\]** メニューをクリックし、**\[WCF Service Config Editor\]** を選択します。この操作を行った後は、構成ファイルを右クリックして **\[Edit WCF Config\]** コンテキスト メニュー項目を表示できます。  
+  
+## 参照  
+ [構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)   
+ [サービスの構成](../../../../docs/framework/wcf/configuring-services.md)   
+ [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/deploying-services.md b/docs/framework/wcf/diagnostics/deploying-services.md
new file mode 100644
index 00000000000..0b854978a86
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/deploying-services.md
@@ -0,0 +1,27 @@
+---
+title: "サービスの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac361bfb-017d-4da9-a2d7-fc0fb72d65bb
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービスの配置
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションをランタイム環境に配置する方法を説明します。  
+  
+## アプリケーションのホスト環境の選択  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、マネージ コードをサポートする任意の Windows プロセスで実行されるように設計されています。アクティブにするには、サービスを作成してそのコンテキストと有効期間を制御するランタイム環境内で、サービスをホストする必要があります。ホスティング環境の範囲は、最も単純なコンソール アプリケーション内、Windows サービスやインターネット インフォメーション サービス \(IIS\) のようなサーバー環境、あるいは Windows アクティブ化サービス \(WAS\) で管理されるワーカー プロセス内での実行にまで及びます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに対する各種のホスティング環境については、「[ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+## 参照  
+ [ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)   
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/131-bufferpoolallocation.md b/docs/framework/wcf/diagnostics/etw/131-bufferpoolallocation.md
new file mode 100644
index 00000000000..a47e1c422a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/131-bufferpoolallocation.md
@@ -0,0 +1,37 @@
+---
+title: "131 - BufferPoolAllocation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ddaf86a-a453-4862-9269-8fa38a47c8b9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 131 - BufferPoolAllocation
+BufferPoolAllocation  
+  
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|131|  
+|キーワード|Infrastructure|  
+|レベル|Verbose|  
+|チャネル|DEBUG|  
+  
+## 説明  
+ このイベントは、BufferPool がバッファーにメモリを割り当てるときに生成されます  
+  
+## Message  
+ プールが %1 バイトを割り当てています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/132-bufferpoolchangequota.md b/docs/framework/wcf/diagnostics/etw/132-bufferpoolchangequota.md
new file mode 100644
index 00000000000..917d87b484d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/132-bufferpoolchangequota.md
@@ -0,0 +1,37 @@
+---
+title: "132 - BufferPoolChangeQuota | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe18d326-4220-46fc-9109-cec3d1530281
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 132 - BufferPoolChangeQuota
+BufferPoolChangeQuota  
+  
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|132|  
+|キーワード|インフラストラクチャ|  
+|レベル|詳細|  
+|チャネル|デバッグ|  
+  
+## 説明  
+ このイベントは、バッファー プールに対するクォータが変更された後に生成されます。  
+  
+## メッセージ  
+ BufferPool のサイズ: %1、クォータの変更: %2。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/133-actionitemscheduled.md b/docs/framework/wcf/diagnostics/etw/133-actionitemscheduled.md
new file mode 100644
index 00000000000..86af28b073a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/133-actionitemscheduled.md
@@ -0,0 +1,35 @@
+---
+title: "133 - ActionItemScheduled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a226aeea-69f4-438c-909b-05bd68b99220
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 133 - ActionItemScheduled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|133|  
+|キーワード|スレッド|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、IO スレッド スケジューラのコールバック呼び出しが開始されると生成されます。  
+  
+## メッセージ  
+ IO スレッド スケジューラのコールバックが呼び出されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/134-actionitemcallbackinvoked.md b/docs/framework/wcf/diagnostics/etw/134-actionitemcallbackinvoked.md
new file mode 100644
index 00000000000..973ff3ce58b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/134-actionitemcallbackinvoked.md
@@ -0,0 +1,35 @@
+---
+title: "134 - ActionItemCallbackInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9547f8a6-8f75-4c64-9d6d-391385557d8c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 134 - ActionItemCallbackInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|134|  
+|キーワード|スレッド|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、IO スレッド スケジューラのコールバック呼び出しが終了すると生成されます。  
+  
+## メッセージ  
+ IO スレッド スケジューラのコールバックが呼び出されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1400-channelinitializationtimeout.md b/docs/framework/wcf/diagnostics/etw/1400-channelinitializationtimeout.md
new file mode 100644
index 00000000000..f5f9cee0873
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1400-channelinitializationtimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1400 - ChannelInitializationTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95de02d3-7986-4bbc-934f-c9dc4a809682
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1400 - ChannelInitializationTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1400|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、チャネルの初期化がタイムアウトしたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1401-closetimeout.md b/docs/framework/wcf/diagnostics/etw/1401-closetimeout.md
new file mode 100644
index 00000000000..a1ee7298121
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1401-closetimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1401 - CloseTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 612c7292-999e-4c3e-97f3-87b0ef0c2739
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1401 - CloseTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1401|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントはタイムアウト時に生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1402-idletimeout.md b/docs/framework/wcf/diagnostics/etw/1402-idletimeout.md
new file mode 100644
index 00000000000..97713f1b7a1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1402-idletimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1402 - IdleTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 581233aa-ce1a-49b6-9497-8bff88664036
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1402 - IdleTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1402|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントはアイドル タイムアウト時に生成されます。  
+  
+## メッセージ  
+ %1 接続プール キー: %2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1403-leasetimeout.md b/docs/framework/wcf/diagnostics/etw/1403-leasetimeout.md
new file mode 100644
index 00000000000..79e0a6c751d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1403-leasetimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1403 - LeaseTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3908748b-f060-46a2-8043-49e09218d2e5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1403 - LeaseTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1403|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントはリース タイムアウト時に生成されます。  
+  
+## メッセージ  
+ %1 接続プール キー: %2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1405-opentimeout.md b/docs/framework/wcf/diagnostics/etw/1405-opentimeout.md
new file mode 100644
index 00000000000..ba991883157
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1405-opentimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1405 - OpenTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 45470cf9-b84c-4e5e-86e2-2eb7722cbc1a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1405 - OpenTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1405|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントはオープン タイムアウト時に生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1406-receivetimeout.md b/docs/framework/wcf/diagnostics/etw/1406-receivetimeout.md
new file mode 100644
index 00000000000..ef276b67ca6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1406-receivetimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1406 - ReceiveTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2543f9b-94fb-406e-8e96-1110b0f338f3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1406 - ReceiveTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1406|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは受信タイムアウト時に生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1407-sendtimeout.md b/docs/framework/wcf/diagnostics/etw/1407-sendtimeout.md
new file mode 100644
index 00000000000..c58052985c7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1407-sendtimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1407 - SendTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1df1c98e-89ac-441a-b943-6dd2d41a37ed
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1407 - SendTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1407|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは送信タイムアウト時に生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1409-inactivitytimeout.md b/docs/framework/wcf/diagnostics/etw/1409-inactivitytimeout.md
new file mode 100644
index 00000000000..a9096a0186c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1409-inactivitytimeout.md
@@ -0,0 +1,35 @@
+---
+title: "1409 - InactivityTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 38fb99b7-b00d-4b55-b9d0-48bd17c441aa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1409 - InactivityTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1409|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは無通信タイムアウト時に生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1416-maxreceivedmessagesizeexceeded.md b/docs/framework/wcf/diagnostics/etw/1416-maxreceivedmessagesizeexceeded.md
new file mode 100644
index 00000000000..94d503ad6b4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1416-maxreceivedmessagesizeexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1416 - MaxReceivedMessageSizeExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee5562dd-29e1-432d-9c78-0bdc3ae365c4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1416 - MaxReceivedMessageSizeExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1416|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージの最大受信サイズを超えたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1417-maxsentmessagesizeexceeded.md b/docs/framework/wcf/diagnostics/etw/1417-maxsentmessagesizeexceeded.md
new file mode 100644
index 00000000000..28dbfdc5822
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1417-maxsentmessagesizeexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1417 - MaxSentMessageSizeExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3cb7c2f0-97bf-4ee9-a037-ed64a25a18fd
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1417 - MaxSentMessageSizeExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1417|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージの最大送信サイズを超えたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1418-maxoutboundconnectionsperendpointexceeded.md b/docs/framework/wcf/diagnostics/etw/1418-maxoutboundconnectionsperendpointexceeded.md
new file mode 100644
index 00000000000..4e1db8c1359
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1418-maxoutboundconnectionsperendpointexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1418 - MaxOutboundConnectionsPerEndpointExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0739a83-376a-43a5-946c-1b6641f28e51
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1418 - MaxOutboundConnectionsPerEndpointExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1418|  
+|キーワード|クォータ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ポイントごとの最大送信接続数を超えたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1419-maxpendingconnectionsexceeded.md b/docs/framework/wcf/diagnostics/etw/1419-maxpendingconnectionsexceeded.md
new file mode 100644
index 00000000000..456d55ce69f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1419-maxpendingconnectionsexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1419 - MaxPendingConnectionsExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e48e438e-f4c1-4f4f-85d6-c6c820a81df9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1419 - MaxPendingConnectionsExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1419|  
+|キーワード|クォータ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、保留接続の最大数に達したときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1420-readerquotaexceeded.md b/docs/framework/wcf/diagnostics/etw/1420-readerquotaexceeded.md
new file mode 100644
index 00000000000..5b081057f21
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1420-readerquotaexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1420 - ReaderQuotaExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d2e8cd7e-f7aa-476c-9857-1e04c4b52dc0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1420 - ReaderQuotaExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1420|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、リーダーのクォータを超えたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1422-negotiatetokenauthenticatorstatecacheexceeded.md b/docs/framework/wcf/diagnostics/etw/1422-negotiatetokenauthenticatorstatecacheexceeded.md
new file mode 100644
index 00000000000..4e677eecae1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1422-negotiatetokenauthenticatorstatecacheexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1422 - NegotiateTokenAuthenticatorStateCacheExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bfabfb52-ebfb-489f-bdb4-408536c24e52
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1422 - NegotiateTokenAuthenticatorStateCacheExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1422|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、トークン認証システムのネゴシエートの状態のキャッシュを超えたときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1423-negotiatetokenauthenticatorstatecacheratio.md b/docs/framework/wcf/diagnostics/etw/1423-negotiatetokenauthenticatorstatecacheratio.md
new file mode 100644
index 00000000000..fd2c300e453
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1423-negotiatetokenauthenticatorstatecacheratio.md
@@ -0,0 +1,35 @@
+---
+title: "1423 - NegotiateTokenAuthenticatorStateCacheRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6301db99-bb23-40d1-b8df-f0ae1793ce68
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1423 - NegotiateTokenAuthenticatorStateCacheRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1423|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、トークン認証システムのネゴシエートの状態のキャッシュの比率に関する情報が提供されるときに生成されます。  
+  
+## メッセージ  
+ トークン認証システムのネゴシエートの状態のキャッシュ比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1424-securitysessionratio.md b/docs/framework/wcf/diagnostics/etw/1424-securitysessionratio.md
new file mode 100644
index 00000000000..6970684568d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1424-securitysessionratio.md
@@ -0,0 +1,35 @@
+---
+title: "1424 - SecuritySessionRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd960f10-dd43-42d4-a415-75eae0cb7cac
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1424 - SecuritySessionRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1424|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セキュリティ セッションの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ セキュリティ セッションの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1430-pendingconnectionsratio.md b/docs/framework/wcf/diagnostics/etw/1430-pendingconnectionsratio.md
new file mode 100644
index 00000000000..3a8b55f34db
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1430-pendingconnectionsratio.md
@@ -0,0 +1,35 @@
+---
+title: "1430 - PendingConnectionsRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c9df7da9-26e7-444f-9e36-86de1676442d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1430 - PendingConnectionsRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1430|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、保留中の接続の比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ 保留中の接続の比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1431-concurrentcallsratio.md b/docs/framework/wcf/diagnostics/etw/1431-concurrentcallsratio.md
new file mode 100644
index 00000000000..83be985bfa2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1431-concurrentcallsratio.md
@@ -0,0 +1,35 @@
+---
+title: "1431 - ConcurrentCallsRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 571dc259-78a7-4e91-9a7e-b83644d20229
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1431 - ConcurrentCallsRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1431|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、同時呼び出しの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ 同時セッションの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1432-concurrentsessionsratio.md b/docs/framework/wcf/diagnostics/etw/1432-concurrentsessionsratio.md
new file mode 100644
index 00000000000..aeb8b78cab6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1432-concurrentsessionsratio.md
@@ -0,0 +1,35 @@
+---
+title: "1432 - ConcurrentSessionsRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8b6efce-cf46-485f-9cd6-58126b627032
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1432 - ConcurrentSessionsRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1432|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、同時実行セッションの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ 同時セッションの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1433-outboundconnectionsperendpointratio.md b/docs/framework/wcf/diagnostics/etw/1433-outboundconnectionsperendpointratio.md
new file mode 100644
index 00000000000..ea7597babe4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1433-outboundconnectionsperendpointratio.md
@@ -0,0 +1,35 @@
+---
+title: "1433 - OutboundConnectionsPerEndpointRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f17f20d-7035-45f7-85a6-a6743f77fe70
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1433 - OutboundConnectionsPerEndpointRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1433|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、エンドポイントごとの送信接続の比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ エンドポイントごとの送信接続の比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1436-pendingmessagesperchannelratio.md b/docs/framework/wcf/diagnostics/etw/1436-pendingmessagesperchannelratio.md
new file mode 100644
index 00000000000..309db0d8c29
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1436-pendingmessagesperchannelratio.md
@@ -0,0 +1,35 @@
+---
+title: "1436 - PendingMessagesPerChannelRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f5b779b-1ca1-4653-b79b-db31df8fbb8b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1436 - PendingMessagesPerChannelRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1436|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、チャネルごとの保留メッセージの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ チャネルごとの保留メッセージの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1438-concurrentinstancesratio.md b/docs/framework/wcf/diagnostics/etw/1438-concurrentinstancesratio.md
new file mode 100644
index 00000000000..3e455c0964a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1438-concurrentinstancesratio.md
@@ -0,0 +1,35 @@
+---
+title: "1438 - ConcurrentInstancesRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3234f307-22c9-4961-97a8-88d7c77e9945
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1438 - ConcurrentInstancesRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1438|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、同時インスタンスの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ 同時インスタンスの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1439-pendingacceptsatzero.md b/docs/framework/wcf/diagnostics/etw/1439-pendingacceptsatzero.md
new file mode 100644
index 00000000000..91b413c02e0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1439-pendingacceptsatzero.md
@@ -0,0 +1,35 @@
+---
+title: "1439 - PendingAcceptsAtZero | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a57d550d-70f5-4f63-9ba7-e0f666b8f0ac
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1439 - PendingAcceptsAtZero
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1439|  
+|キーワード|クォータ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、保留中の受け入れがない場合に生成されます。  
+  
+## メッセージ  
+ 保留中の受け入れはありません  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1441-maxsessionsizereached.md b/docs/framework/wcf/diagnostics/etw/1441-maxsessionsizereached.md
new file mode 100644
index 00000000000..3e5fe36e887
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1441-maxsessionsizereached.md
@@ -0,0 +1,35 @@
+---
+title: "1441 - MaxSessionSizeReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ccf51232-cdbc-4004-a4b9-aed0c256dfe4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1441 - MaxSessionSizeReached
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1441|  
+|キーワード|クォータ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セッションの最大サイズに達したときに生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1442-receiveretrycountreached.md b/docs/framework/wcf/diagnostics/etw/1442-receiveretrycountreached.md
new file mode 100644
index 00000000000..d88df3393fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1442-receiveretrycountreached.md
@@ -0,0 +1,35 @@
+---
+title: "1442 - ReceiveRetryCountReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f66cd1c-950b-4073-a1c9-62eba33dbc22
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1442 - ReceiveRetryCountReached
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1442|  
+|キーワード|クォータ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、MSMQ メッセージが受信再試行回数に達したときに生成されます。  
+  
+## メッセージ  
+ ID '%1' の MSMQ メッセージが受信再試行回数に達しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1443-maxretrycyclesexceededmsmq.md b/docs/framework/wcf/diagnostics/etw/1443-maxretrycyclesexceededmsmq.md
new file mode 100644
index 00000000000..855b60727b9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1443-maxretrycyclesexceededmsmq.md
@@ -0,0 +1,35 @@
+---
+title: "1443 - MaxRetryCyclesExceededMsmq | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5fb5b119-7ae0-4c88-b3ab-3679063707d9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1443 - MaxRetryCyclesExceededMsmq
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1443|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、MSMQ メッセージで再試行サイクルの最大数を超過すると生成されます。  
+  
+## メッセージ  
+ ID '%1' の MSMQ メッセージが最大再試行サイクルを超えました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1445-readpoolmiss.md b/docs/framework/wcf/diagnostics/etw/1445-readpoolmiss.md
new file mode 100644
index 00000000000..c6f478bd5f7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1445-readpoolmiss.md
@@ -0,0 +1,35 @@
+---
+title: "1445 - ReadPoolMiss | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a8fa431-42a2-4a77-9a04-a269236e83ad
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1445 - ReadPoolMiss
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1445|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、読み取りプールの不足時に生成されます。  
+  
+## メッセージ  
+ 新しい '%1' を作成しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1446-writepoolmiss.md b/docs/framework/wcf/diagnostics/etw/1446-writepoolmiss.md
new file mode 100644
index 00000000000..9e90e7286f1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1446-writepoolmiss.md
@@ -0,0 +1,35 @@
+---
+title: "1446 - WritePoolMiss | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48dd3aa2-46d5-4bbf-8ce7-68e1b684b7b7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1446 - WritePoolMiss
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1446|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、書き込みプールの不足時に生成されます。  
+  
+## メッセージ  
+ 新しい '%1' を作成しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/1451-maxretrycyclesexceeded.md b/docs/framework/wcf/diagnostics/etw/1451-maxretrycyclesexceeded.md
new file mode 100644
index 00000000000..dcb8e8d02fd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/1451-maxretrycyclesexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "1451 - MaxRetryCyclesExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b2466f5-a6cb-43b7-aff1-70327ffbdbc1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1451 - MaxRetryCyclesExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1451|  
+|キーワード|クォータ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、再試行サイクルの最大数を超過すると生成されます。  
+  
+## メッセージ  
+ 1%  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/201-clientmessageinspectorafterreceiveinvoked.md b/docs/framework/wcf/diagnostics/etw/201-clientmessageinspectorafterreceiveinvoked.md
new file mode 100644
index 00000000000..072a6cbec3d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/201-clientmessageinspectorafterreceiveinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "201 - ClientMessageInspectorAfterReceiveInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ff637f1-cc26-4400-ab9b-546f70e5057d
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 201 - ClientMessageInspectorAfterReceiveInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|201|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、クライアント メッセージ インスペクターで Service Model が `AfterReceiveReply` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ClientMessageInspector で 'AfterReceiveReply' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出されたインスペクターの型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/202-clientmessageinspectorbeforesendinvoked.md b/docs/framework/wcf/diagnostics/etw/202-clientmessageinspectorbeforesendinvoked.md
new file mode 100644
index 00000000000..9aa07cdc7a7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/202-clientmessageinspectorbeforesendinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "202 - ClientMessageInspectorBeforeSendInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b02ca82-8a55-45e3-b2e2-ddfe28a7269c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 202 - ClientMessageInspectorBeforeSendInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|202|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、クライアント メッセージ インスペクターで Service Model が `BeforeSendRequest` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ClientMessageInspector で 'BeforeSendRequest' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出されたインスペクターの型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/203-clientparameterinspectoraftercallinvoked.md b/docs/framework/wcf/diagnostics/etw/203-clientparameterinspectoraftercallinvoked.md
new file mode 100644
index 00000000000..6ad7cb1d42d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/203-clientparameterinspectoraftercallinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "203 - ClientParameterInspectorAfterCallInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9592212-07e2-43e0-8b00-affd195cf55a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 203 - ClientParameterInspectorAfterCallInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|203|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、クライアント パラメーター インスペクターで Service Model が `AfterCall` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ClientParameterInspector で 'AfterCall' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出されたインスペクターの型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。  その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。  例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/204-clientparameterinspectorbeforecallinvoked.md b/docs/framework/wcf/diagnostics/etw/204-clientparameterinspectorbeforecallinvoked.md
new file mode 100644
index 00000000000..861198b90dd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/204-clientparameterinspectorbeforecallinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "204 - ClientParameterInspectorBeforeCallInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8253555a-9002-4565-8ede-33d7a33a895f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 204 - ClientParameterInspectorBeforeCallInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|204|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、クライアント パラメーター インスペクターで Service Model が `BeforeCall` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ClientParameterInspector で 'BeforeCall' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出されたインスペクターの型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/205-operationinvoked.md b/docs/framework/wcf/diagnostics/etw/205-operationinvoked.md
new file mode 100644
index 00000000000..5fab608c6da
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/205-operationinvoked.md
@@ -0,0 +1,42 @@
+---
+title: "205 - OperationInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9c8d6c90-dfa5-4ae0-a589-96679a8fb3ba
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 205 - OperationInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|205|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルの既定の `OperationInvoker` がメソッドの呼び出しを開始する直前に生成されます。  
+  
+## メッセージ  
+ OperationInvoker が '%1' メソッドを呼び出しました。呼び出し元の情報: '%2'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Method Name|`xs:string`|`OperationInvoker` によって呼び出されたメソッドの CLR 名。|  
+|Caller Information|`xs:string`|クライアントの IP アドレスとポート番号。'\<IP アドレス\>:\<ポート番号\>' の形式で指定します。この 2 つの値は、操作コンテキスト内の 'System.ServiceModel.Channels.RemoteEndpointMessageProperty' メッセージ プロパティから取得します。TCP 以外のバインドの場合、この値は `null` になることに注意してください。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/206-errorhandlerinvoked.md b/docs/framework/wcf/diagnostics/etw/206-errorhandlerinvoked.md
new file mode 100644
index 00000000000..659acf96865
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/206-errorhandlerinvoked.md
@@ -0,0 +1,43 @@
+---
+title: "206 - ErrorHandlerInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97340f4d-4e09-4e42-a17a-982b3868dbcf
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 206 - ErrorHandlerInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|206|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス操作中に発生した例外を処理する機会が `ErrorHandler` に与えられた後に、生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ErrorHandler を呼び出し、種類 '%3' の例外がスローされました。ErrorHandled \=\= '%2'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出された `ErrorHandler` の型の CLR FullName。|  
+|Handled|`xs:unsignedByte`|エラー ハンドラーがエラーを処理した場合は `true`。それ以外の場合は `false`。|  
+|ExceptionTypeName|`xs:string`|処理対象である例外の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/207-faultproviderinvoked.md b/docs/framework/wcf/diagnostics/etw/207-faultproviderinvoked.md
new file mode 100644
index 00000000000..0d1256e75f0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/207-faultproviderinvoked.md
@@ -0,0 +1,42 @@
+---
+title: "207 - FaultProviderInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b730d903-01c2-4deb-85a4-da12f8a21fe4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 207 - FaultProviderInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|207|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、`FaultProvider` が呼び出された後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の FaultProvider を呼び出し、種類 '%2' の例外がスローされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出された `FaultProvider` の型の CLR FullName。|  
+|ExceptionTypeName|`xs:string`|`FaultProvider` の操作対象である例外の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。  その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。  例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/208-messageinspectorafterreceiveinvoked.md b/docs/framework/wcf/diagnostics/etw/208-messageinspectorafterreceiveinvoked.md
new file mode 100644
index 00000000000..f0cfda6a924
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/208-messageinspectorafterreceiveinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "208 - MessageInspectorAfterReceiveInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfb5f7b0-4346-4949-8104-351726b1f502
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 208 - MessageInspectorAfterReceiveInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|208|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ インスペクターで Service Model が `AfterReceive` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の MessageInspector で 'AfterReceiveReply' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出された `MessageInspector` の型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。  その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。  例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/209-messageinspectorbeforesendinvoked.md b/docs/framework/wcf/diagnostics/etw/209-messageinspectorbeforesendinvoked.md
new file mode 100644
index 00000000000..18dbb45c322
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/209-messageinspectorbeforesendinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "209 - MessageInspectorBeforeSendInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d710875-fb77-4463-978b-bc86d59d84cd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 209 - MessageInspectorBeforeSendInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|209|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ インスペクターで Service Model が `BeforeSend` メソッドを呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の MessageInspector で 'BeforeSendRequest' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出された `MessageInspector` の型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/210-messagethrottleexceeded.md b/docs/framework/wcf/diagnostics/etw/210-messagethrottleexceeded.md
new file mode 100644
index 00000000000..f5dd52a2a6b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/210-messagethrottleexceeded.md
@@ -0,0 +1,42 @@
+---
+title: "210 - MessageThrottleExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24ca08ea-c11c-4753-946e-98aa820f8711
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 210 - MessageThrottleExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|210|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、3 つの主要なサービス スロットルの 1 つを超過したときに生成されます。このイベントが生成されるのは、最初にスロットル制限を超過したときのみです。たとえば、同時呼び出しのスロットル制限が 10 の場合は、11 番目の同時呼び出しが `MessageThrottleExceeded` イベントになります。12 番目の呼び出しが別のイベントになることはありません。また、イベント ストリームが煩雑になるのを避けるため、制限値の前後のアクティビティの結果が別のイベントになることはありません。この例では、2 つの呼び出しが完了した場合、9 つの同時呼び出しが行われます。続いて 2 つの呼び出しが行われた場合は、現在の値が再び 11 になります。これは、別のイベントにはなりません。現在の値がスロットル制限の 70% になると、アクティビティの遅れを示す別のイベントが生成されます。以降のアクティビティが制限を超えた場合は、別の `MessageThrottleExceeded` イベントが生成されます。この例では、同時呼び出しの数が 7 になり、再び 11 に達すると、別の `MessageThrottleExceeded` イベントが生成されます。  
+  
+## メッセージ  
+ スロットル '%1' の '%2' の制限に達しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Throttle Name|`xs:string`|超過したスロットルの名前。`MaxConcurrentCalls`、`MaxConcurrentInstances`、または `MaxConcurrentSessions`。|  
+|Limit|`xs:long`|現在構成されている、スロットルの制限。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/211-parameterinspectoraftercallinvoked.md b/docs/framework/wcf/diagnostics/etw/211-parameterinspectoraftercallinvoked.md
new file mode 100644
index 00000000000..bf22d1eb17f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/211-parameterinspectoraftercallinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "211 - ParameterInspectorAfterCallInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0e21297-10b8-4456-a0e1-e019145cd5ac
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 211 - ParameterInspectorAfterCallInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|211|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Service Model が `AfterCall` メソッドを `ParameterInspector` で呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ParameterInspector で 'AfterCall' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|型の名前|`xs:string`|呼び出された `ParameterInspector` の型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。  その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。  例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/212-parameterinspectorbeforecallinvoked.md b/docs/framework/wcf/diagnostics/etw/212-parameterinspectorbeforecallinvoked.md
new file mode 100644
index 00000000000..70ccac5afd4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/212-parameterinspectorbeforecallinvoked.md
@@ -0,0 +1,41 @@
+---
+title: "212 - ParameterInspectorBeforeCallInvoked | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 063fc8d2-ceac-4c18-8368-de84f2c78035
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 212 - ParameterInspectorBeforeCallInvoked
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|212|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Service Model が `BeforeCall` メソッドを `ParameterInspector` で呼び出した後に生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが型 '%1' の ParameterInspector で 'BeforeCall' を呼び出しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TypeName|`xs:string`|呼び出されたインスペクターの型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/213-servicehoststarted.md b/docs/framework/wcf/diagnostics/etw/213-servicehoststarted.md
new file mode 100644
index 00000000000..a6c0489e8de
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/213-servicehoststarted.md
@@ -0,0 +1,41 @@
+---
+title: "213 - ServiceHostStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6f7facc-342f-46bb-9d52-a470178ba6bb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 213 - ServiceHostStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|213|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceHost|  
+|レベル|LogAlways \(常にログ\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Web でホストされているサービス ホストが起動されるときに生成されます。通常、サービスがメッセージによってアクティブにされた時点で発生します。また、サービスが自動的に開始するように構成されている場合も発生します。  
+  
+## メッセージ  
+ ServiceHost は '%1' で開始されています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Service Type Name|`xs:string`|サービス実装の型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/214-operationcompleted.md b/docs/framework/wcf/diagnostics/etw/214-operationcompleted.md
new file mode 100644
index 00000000000..e8de147fcb8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/214-operationcompleted.md
@@ -0,0 +1,42 @@
+---
+title: "214 - OperationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6287eef-023f-4816-813c-1802c82366df
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 214 - OperationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|214|  
+|キーワード|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルの既定の `OperationInvoker` が、メソッドから例外がスローされることなく、メソッドへの呼び出しを完了したときに生成されます。  
+  
+## メッセージ  
+ OperationInvoker がメソッド '%1' への呼び出しを完了しました。メソッド呼び出し時間は '%2' ミリ秒でした。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Method Name|`xs:string`|`OperationInvoker` によって呼び出されたメソッドの CLR 名。|  
+|Duration|`xs:long`|`OperationInvoker` でメソッドを呼び出すのにかかった時間 \(ミリ秒単位\)。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/215-messagereceivedbytransport.md b/docs/framework/wcf/diagnostics/etw/215-messagereceivedbytransport.md
new file mode 100644
index 00000000000..7a01bc90439
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/215-messagereceivedbytransport.md
@@ -0,0 +1,44 @@
+---
+title: "215 - MessageReceivedByTransport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb32aa60-5207-4711-9f08-110e8ac327e5
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 215 - MessageReceivedByTransport
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|215|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP ベースのトランスポートがメッセージを受信するときに発生します。  トランスポート レベルでは、1 つの操作に対して複数のメッセージが、クライアントとサービス間で交換されることがあります。  これはインフラストラクチャの動作によるもので、セキュリティがその一例です。  そのため、生成される `MessageReceivedByTransport` イベントの数が、サービスのバインディングとその構成に応じて異なります。  
+  
+> [!NOTE]
+>  一方向トランスポートでは、このイベントは発生しません。  
+  
+## メッセージ  
+ トランスポートが '%1' からメッセージを受信しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Listen Address|`xs:string`|メッセージを受信したアドレス。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。  その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。  例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md b/docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md
new file mode 100644
index 00000000000..c712ed2b3ad
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md
@@ -0,0 +1,41 @@
+---
+title: "216 - MessageSentByTransport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 150c3167-4154-4225-8d94-57cc94341233
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 216 - MessageSentByTransport
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|216|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP ベースのトランスポートがメッセージを送信するときに発生します。トランスポート レベルでは、1 つの操作に対して複数のメッセージが、クライアントとサービス間で交換されることがあります。これはインフラストラクチャの動作によるもので、セキュリティがその一例です。そのため、生成される **MessageSentByTransport** イベントの数が、サービスのバインディングとその構成に応じて異なります。  
+  
+## メッセージ  
+ トランスポートが '%1' にメッセージを送信しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DestinationAddress|`xs:string`|要求メッセージが送信されたアドレス。|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/217-clientoperationprepared.md b/docs/framework/wcf/diagnostics/etw/217-clientoperationprepared.md
new file mode 100644
index 00000000000..8df49d8bf6a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/217-clientoperationprepared.md
@@ -0,0 +1,43 @@
+---
+title: "217 - ClientOperationPrepared | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad207f04-b038-4f33-95e9-27a361df8ecd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 217 - ClientOperationPrepared
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|217|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、操作がサービスに送信される直前に、クライアントによって生成されます。  
+  
+## メッセージ  
+ クライアントは '%2' コントラクトと関連付けられている Action '%1' を実行しています。メッセージは '%3' に送信されます。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Action|`xs:string`|送信メッセージの SOAP アクション ヘッダー。|  
+|Contract Name|`xs:string`|コントラクトの名前。例: ICalculator。|  
+|Destination|`xs:string`|メッセージの送信先となるサービス エンドポイントのアドレス。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/218-clientoperationcompleted.md b/docs/framework/wcf/diagnostics/etw/218-clientoperationcompleted.md
new file mode 100644
index 00000000000..834306a506b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/218-clientoperationcompleted.md
@@ -0,0 +1,43 @@
+---
+title: "218 - ClientOperationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b069bced-7bb2-4e01-8227-e5dbda17af09
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 218 - ClientOperationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|218|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ある操作が完了した直後にクライアントによって生成されます。一方向の操作の場合は、メッセージが正常に送信された直後に生成されます。要求 \- 応答の操作の場合は、応答の受信後に生成されます。  
+  
+## メッセージ  
+ クライアントは '%2' コントラクトと関連付けられている Action '%1' の実行を完了しました。メッセージは '%3' に送信されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Action|xs:string|送信メッセージの SOAP アクション ヘッダー。|  
+|Contract Name|`xs:string`|コントラクトの名前。例: ICalculator。|  
+|Destination|`xs:string`|メッセージの送信先のサービス エンドポイントのアドレス。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/219-serviceexception.md b/docs/framework/wcf/diagnostics/etw/219-serviceexception.md
new file mode 100644
index 00000000000..43e4731b53d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/219-serviceexception.md
@@ -0,0 +1,42 @@
+---
+title: "219 - ServiceException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81e2efac-39aa-4ed2-85a9-97eb8793b844
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 219 - ServiceException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|219|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Error \(エラー\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WCF サービスがハンドルされない例外を検出した場合に生成されます。これには、アクティベーション中のハンドルされない例外、メッセージ処理中のハンドルされない例外、およびユーザー コード内でのハンドルされない例外が含まれます。  
+  
+## メッセージ  
+ メッセージの処理中に種類 '%2' のハンドルされない例外がスローされました。完全な例外 ToString: %1。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ExceptionToString|`xs:string`|CLR 例外に対して `ToString`\(\) を呼び出した結果。|  
+|ExceptionTypeName|`xs:string`|例外の型の CLR FullName。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/220-messagesenttotransport.md b/docs/framework/wcf/diagnostics/etw/220-messagesenttotransport.md
new file mode 100644
index 00000000000..142152da8cf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/220-messagesenttotransport.md
@@ -0,0 +1,44 @@
+---
+title: "220 - MessageSentToTransport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aef4e781-240b-45bc-bff8-400053037e71
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 220 - MessageSentToTransport
+## プロパティ  
+  
+|||  
+|-|-|  
+|\[ID\]|220|  
+|キーワード|EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルがトランスポートにメッセージを送信すると生成されます。  
+  
+> [!NOTE]
+>  一方向トランスポートでは、このイベントは発生しません。  
+  
+## メッセージ  
+ ディスパッチャーがトランスポートにメッセージを送信しました。関連付け ID \=\= '%1'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Correlation ID|`xs:GUID`|サービスまたはクライアントからの `MessageSentToTransport` イベントを、反対側の対応する `MessageReceivedFromTransport` と関連付けるのに使用する、アクティビティ ID。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/221-messagereceivedfromtransport.md b/docs/framework/wcf/diagnostics/etw/221-messagereceivedfromtransport.md
new file mode 100644
index 00000000000..b6671c081fd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/221-messagereceivedfromtransport.md
@@ -0,0 +1,41 @@
+---
+title: "221 - MessageReceivedFromTransport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4995f0d5-c182-4d97-981f-6951da6df1fb
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 221 - MessageReceivedFromTransport
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|221|  
+|キーワード|EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルがトランスポートからメッセージを受信すると生成されます。  
+  
+## メッセージ  
+ ディスパッチャーがトランスポートからメッセージを受信しました。関連付け ID \=\= '%1'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Correlation ID|`xs:GUID`|サービスまたはクライアントからの `MessageSentToTransport` イベントを、反対側の対応する `MessageReceivedFromTransport` と関連付けるのに使用する、アクティビティ ID。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/222-operationfailed.md b/docs/framework/wcf/diagnostics/etw/222-operationfailed.md
new file mode 100644
index 00000000000..d8ddd98e397
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/222-operationfailed.md
@@ -0,0 +1,42 @@
+---
+title: "222 - OperationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b530ded-8f20-4d78-8bfe-1875276df6ba
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 222 - OperationFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|222|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルの既定の `OperationInvoker` が、そのメソッドを呼び出している間に例外に遭遇すると生成されます。`FaultException` から派生する例外では、このイベントは生成されません。  
+  
+## メッセージ  
+ OperationInvoker によって呼び出されたメソッド '%1' で、ハンドルされない例外がスローされました。メソッド呼び出し時間は '%2' ミリ秒でした。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Method Name|`xs:string`|`OperationInvoker` によって呼び出されたメソッドの CLR 名。|  
+|Duration|`xs:long`|`OperationInvoker` でメソッドを呼び出すのにかかった時間 \(ミリ秒単位\)。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/223-operationfaulted.md b/docs/framework/wcf/diagnostics/etw/223-operationfaulted.md
new file mode 100644
index 00000000000..47d598a820d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/223-operationfaulted.md
@@ -0,0 +1,42 @@
+---
+title: "223 - OperationFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2f7d89d7-3a6a-40fe-9610-5424eb6bbf61
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 223 - OperationFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|223|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス モデルの既定の `OperationInvoker` が、そのメソッドを呼び出している間に `FaultException` から派生する例外に遭遇すると生成されます。  
+  
+## メッセージ  
+ OperationInvoker によって呼び出されたメソッド '%1' で FaultException がスローされました。メソッド呼び出し時間は '%2' ミリ秒でした。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|MethodName|`xs:string`|`OperationInvoker` によって呼び出されたメソッドの CLR 名。|  
+|Duration|`xs:long`|`OperationInvoker` でメソッドを呼び出すのにかかった時間 \(ミリ秒単位\)。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/224-messagethrottleatseventypercent.md b/docs/framework/wcf/diagnostics/etw/224-messagethrottleatseventypercent.md
new file mode 100644
index 00000000000..71d19114d9a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/224-messagethrottleatseventypercent.md
@@ -0,0 +1,42 @@
+---
+title: "224 - MessageThrottleAtSeventyPercent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82bbbfd7-10d2-41fd-805d-2443b0c1b96b
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 224 - MessageThrottleAtSeventyPercent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|224|  
+|キーワード|EndToEndMonitoring、HealthMonitoring、Troubleshooting、ServiceModel|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ `MessageThrottleExceeded` イベントは、主要なサービス スロットルの 1 つを超過したときに生成されます。アクティビティの急増が緩やかになり、スロットルの現在の値が現在の制限の 70% である場合は、このイベントが生成されます。このイベントは、アクティビティが緩やかになったときに一度だけ生成されます。現在の値が 70% の基準付近を上下している \(70、69、70、71、70、69 など\) 場合は、最初に 70% に達したときにイベントが生成されます。このイベントが生成された後にスロットル制限を超えた場合は、`MessageThrottleExceeded` イベントが生成されます。  
+  
+## メッセージ  
+ スロットル '%1' の '%2' の制限は 70%% です。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Throttle Name|`xs:string`|超過したスロットルの名前。`MaxConcurrentCalls`、`MaxConcurrentInstances`、または `MaxConcurrentSessions`。|  
+|Limit|`xs:long`|現在構成されている、スロットルの制限。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/226-idleservicesclosed.md b/docs/framework/wcf/diagnostics/etw/226-idleservicesclosed.md
new file mode 100644
index 00000000000..4a670b55b5c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/226-idleservicesclosed.md
@@ -0,0 +1,35 @@
+---
+title: "226 - IdleServicesClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b5e72de3-33c6-46a2-998a-3809b520bb30
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 226 - IdleServicesClosed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|226|  
+|キーワード|HealthMonitoring、WebHost|  
+|レベル|LogAlways \(常にログ\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、アイドル状態のサービスが閉じられたときに生成されます。  
+  
+## メッセージ  
+ アクティブ化された合計 %2 個のサービスのうち、アイドル状態の %1 個のサービスが閉じられました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/301-userdefinederroroccurred.md b/docs/framework/wcf/diagnostics/etw/301-userdefinederroroccurred.md
new file mode 100644
index 00000000000..4f3ce0dcbf0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/301-userdefinederroroccurred.md
@@ -0,0 +1,41 @@
+---
+title: "301 - UserDefinedErrorOccurred | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a0285d1c-550f-4c14-9c36-a96e97f1c4e4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 301 - UserDefinedErrorOccurred
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|301|  
+|キーワード|Troubleshooting、HealthMonitoring、UserEvents、ServiceModel、EndToEndMonitoring|  
+|レベル|Error \(エラー\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ユーザー コードから生成されます。開発者は、カスタム定義のエラー イベントがサービスで発生したときに、このイベントを生成できます。これは、<xref:System.Diagnostics.Eventing> API を使用して実行できます。また、その API をラップし、このイベントを適切に生成する方法を示す、WCF サンプルもあります。  
+  
+## メッセージ  
+ 名前:'%1'、参照:'%2'、ペイロード:%3  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Name|`xs:string`|イベントのユーザー定義名。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|Payload|`xs:string`|イベントのユーザー定義ペイロード。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/302-userdefinedwarningoccurred.md b/docs/framework/wcf/diagnostics/etw/302-userdefinedwarningoccurred.md
new file mode 100644
index 00000000000..f44e6e0e0f0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/302-userdefinedwarningoccurred.md
@@ -0,0 +1,41 @@
+---
+title: "302 - UserDefinedWarningOccurred | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d1f0bf1-0151-45e6-be92-573d397b54de
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 302 - UserDefinedWarningOccurred
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|302|  
+|キーワード|Troubleshooting、HealthMonitoring、UserEvents、ServiceModel、EndToEndMonitoring|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ユーザー コードから生成されます。開発者は、カスタム定義の警告イベントがサービスで発生したときに、このイベントを生成できます。これは、<xref:System.Diagnostics.Eventing> API を使用して実行できます。また、その API をラップし、このイベントを適切に生成する方法を示す、WCF サンプルもあります。  
+  
+## メッセージ  
+ 名前:'%1'、参照:'%2'、ペイロード:%3  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Name|`xs:string`|イベントのユーザー定義名。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|Payload|`xs:string`|イベントのユーザー定義ペイロード。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/303-userdefinedinformationeventoccured.md b/docs/framework/wcf/diagnostics/etw/303-userdefinedinformationeventoccured.md
new file mode 100644
index 00000000000..8c50af4d75a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/303-userdefinedinformationeventoccured.md
@@ -0,0 +1,41 @@
+---
+title: "303 - UserDefinedInformationEventOccured | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ed5acaf-3755-4417-92c4-4ebc8e854ca1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 303 - UserDefinedInformationEventOccured
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|303|  
+|キーワード|Troubleshooting、HealthMonitoring、UserEvents、ServiceModel、EndToEndMonitoring|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ユーザー コードから生成されます。開発者は、カスタム定義の情報イベントがサービスで発生したときに、このイベントを生成できます。これは、<xref:System.Diagnostics.Eventing> API を使用して実行できます。また、その API をラップし、このイベントを適切に生成する方法を示す、WCF サンプルもあります。  
+  
+## メッセージ  
+ 名前:'%1'、参照:'%2'、ペイロード:%3  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Name|`xs:string`|イベントのユーザー定義名。|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|Payload|`xs:string`|イベントのユーザー定義ペイロード。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3300-receivecontextcompletefailed.md b/docs/framework/wcf/diagnostics/etw/3300-receivecontextcompletefailed.md
new file mode 100644
index 00000000000..da1377a3927
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3300-receivecontextcompletefailed.md
@@ -0,0 +1,35 @@
+---
+title: "3300 - ReceiveContextCompleteFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d6b3a31-5c12-4886-b682-2d0d86407d82
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3300 - ReceiveContextCompleteFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3300|  
+|キーワード|チャネル|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、受信コンテキストを完了できないときに生成されます。  
+  
+## メッセージ  
+ %1 を完了できませんでした。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3301-receivecontextabandonfailed.md b/docs/framework/wcf/diagnostics/etw/3301-receivecontextabandonfailed.md
new file mode 100644
index 00000000000..6c431e52e60
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3301-receivecontextabandonfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3301 - ReceiveContextAbandonFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4495e0c4-3518-4a40-a203-760782e2b1f0
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 3301 - ReceiveContextAbandonFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3301|  
+|キーワード|チャネル|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、受信コンテキストを破棄できないときに生成されます。  
+  
+## メッセージ  
+ %1 を破棄できませんでした。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3302-receivecontextfaulted.md b/docs/framework/wcf/diagnostics/etw/3302-receivecontextfaulted.md
new file mode 100644
index 00000000000..376f5e94114
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3302-receivecontextfaulted.md
@@ -0,0 +1,35 @@
+---
+title: "3302 - ReceiveContextFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: af3d1fc2-40e9-4466-b756-51a582505f3d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3302 - ReceiveContextFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3302|  
+|キーワード|ServiceModel|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、受信コンテキストでエラーが発生したときに生成されます。  
+  
+## メッセージ  
+ 受信コンテキストでエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3303-receivecontextabandonwithexception.md b/docs/framework/wcf/diagnostics/etw/3303-receivecontextabandonwithexception.md
new file mode 100644
index 00000000000..1d9eed8dd96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3303-receivecontextabandonwithexception.md
@@ -0,0 +1,35 @@
+---
+title: "3303 - ReceiveContextAbandonWithException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eae255f8-13fd-4d8e-9f9e-56aea0d588c3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3303 - ReceiveContextAbandonWithException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3303|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、例外によって受信コンテキストの破棄に失敗したときに生成されます。  
+  
+## メッセージ  
+ 例外 %2 が発生したため、%1 が破棄されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3305-clientbasecachedchannelfactorycount.md b/docs/framework/wcf/diagnostics/etw/3305-clientbasecachedchannelfactorycount.md
new file mode 100644
index 00000000000..fa50485d5ea
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3305-clientbasecachedchannelfactorycount.md
@@ -0,0 +1,35 @@
+---
+title: "3305 - ClientBaseCachedChannelFactoryCount | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ae6f58f-cee3-4bb1-8402-4445401f3436
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3305 - ClientBaseCachedChannelFactoryCount
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3305|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアント ベースでキャッシュされているチャネル ファクトリの数を報告するために生成されます。  
+  
+## メッセージ  
+ キャッシュされたチャネル ファクトリの数は '%1' です。 最大で '%2' 個のチャネル ファクトリをキャッシュできます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3306-clientbasechannelfactoryagedoutofcache.md b/docs/framework/wcf/diagnostics/etw/3306-clientbasechannelfactoryagedoutofcache.md
new file mode 100644
index 00000000000..79bae69616e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3306-clientbasechannelfactoryagedoutofcache.md
@@ -0,0 +1,35 @@
+---
+title: "3306 - ClientBaseChannelFactoryAgedOutofCache | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8af1dbf-ea3b-4931-94eb-6d21e30a886e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3306 - ClientBaseChannelFactoryAgedOutofCache
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3306|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、キャッシュがその上限に達したため、チャネル ファクトリがキャッシュから削除されたときに生成されます。  
+  
+## メッセージ  
+ キャッシュが上限の '%1' に達したため、チャネル ファクトリがキャッシュから削除されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3307-clientbasechannelfactorycachehit.md b/docs/framework/wcf/diagnostics/etw/3307-clientbasechannelfactorycachehit.md
new file mode 100644
index 00000000000..ce8d6d75f88
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3307-clientbasechannelfactorycachehit.md
@@ -0,0 +1,35 @@
+---
+title: "3307 - ClientBaseChannelFactoryCacheHit | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93d332af-a666-4fa4-81a3-2db6b1eaf190
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3307 - ClientBaseChannelFactoryCacheHit
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3307|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、キャッシュで見つかった一致するチャネル ファクトリが使用されたときに生成されます。  
+  
+## メッセージ  
+ キャッシュで見つかった一致するチャネル ファクトリが使用されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3308-clientbaseusinglocalchannelfactory.md b/docs/framework/wcf/diagnostics/etw/3308-clientbaseusinglocalchannelfactory.md
new file mode 100644
index 00000000000..3c541a42c20
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3308-clientbaseusinglocalchannelfactory.md
@@ -0,0 +1,35 @@
+---
+title: "3308 - ClientBaseUsingLocalChannelFactory | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1488c75-38ab-47a0-9951-852488683f2a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3308 - ClientBaseUsingLocalChannelFactory
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3308|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、キャッシュのチャネル ファクトリを使用しないときに生成されます。  
+  
+## メッセージ  
+ キャッシュ内のチャネル ファクトリは使用されません   \(つまり、インスタンスのキャッシュは無効になっています\)。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3309-querycompositionexecuted.md b/docs/framework/wcf/diagnostics/etw/3309-querycompositionexecuted.md
new file mode 100644
index 00000000000..4707f2def05
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3309-querycompositionexecuted.md
@@ -0,0 +1,35 @@
+---
+title: "3309 - QueryCompositionExecuted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7ae2267-b478-4115-8317-a89ce4ced65d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3309 - QueryCompositionExecuted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3309|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クエリの構成が実行されるときに生成されます。  
+  
+## メッセージ  
+ '%1' を使用したクエリの構成が要求 URI: '%2' で実行されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3310-dispatchfailed.md b/docs/framework/wcf/diagnostics/etw/3310-dispatchfailed.md
new file mode 100644
index 00000000000..85445f009b0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3310-dispatchfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3310 - DispatchFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b8d7d9f-c6d9-4275-9121-a47519094124
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3310 - DispatchFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3310|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ディスパッチに失敗したときに生成されます。  
+  
+## メッセージ  
+ '%1' 操作のディスパッチでエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3311-dispatchsuccessful.md b/docs/framework/wcf/diagnostics/etw/3311-dispatchsuccessful.md
new file mode 100644
index 00000000000..78486276bb7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3311-dispatchsuccessful.md
@@ -0,0 +1,35 @@
+---
+title: "3311 - DispatchSuccessful | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6995fdd4-520e-46b9-a825-a3001dcdb0ef
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3311 - DispatchSuccessful
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3311|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ディスパッチが成功したときに生成されます。  
+  
+## メッセージ  
+ '%1' 操作が正常にディスパッチされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3312-messagereadbyencoder.md b/docs/framework/wcf/diagnostics/etw/3312-messagereadbyencoder.md
new file mode 100644
index 00000000000..c5d102d7d2d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3312-messagereadbyencoder.md
@@ -0,0 +1,35 @@
+---
+title: "3312 - MessageReadByEncoder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cdcc8e3d-e2aa-4c5e-a580-bdf581a66709
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3312 - MessageReadByEncoder
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3312|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、メッセージがエンコーダーによって読み取られたときに生成されます。  
+  
+## メッセージ  
+ サイズ '%1' バイトのメッセージがエンコーダーによって読み取られました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3313-messagewrittenbyencoder.md b/docs/framework/wcf/diagnostics/etw/3313-messagewrittenbyencoder.md
new file mode 100644
index 00000000000..542b2b387b6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3313-messagewrittenbyencoder.md
@@ -0,0 +1,35 @@
+---
+title: "3313 - MessageWrittenByEncoder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: abdb7db5-373e-4862-b53d-befbb0949e32
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3313 - MessageWrittenByEncoder
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3313|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、メッセージがエンコーダーによって書き込まれたときに生成されます。  
+  
+## メッセージ  
+ サイズ '%1' バイトのメッセージがエンコーダーによって書き込まれました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3314-sessionidletimeout.md b/docs/framework/wcf/diagnostics/etw/3314-sessionidletimeout.md
new file mode 100644
index 00000000000..6c65ef2a779
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3314-sessionidletimeout.md
@@ -0,0 +1,35 @@
+---
+title: "3314 - SessionIdleTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a00f104e-3bea-4185-b7b0-ec1ed8212a74
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3314 - SessionIdleTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3314|  
+|キーワード|ServiceModel|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、アイドル チャネルのセッションが中止されたときに生成されます。  
+  
+## メッセージ  
+ URI: '%1' へのアイドル チャネルのセッションを中止しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3319-socketacceptenqueued.md b/docs/framework/wcf/diagnostics/etw/3319-socketacceptenqueued.md
new file mode 100644
index 00000000000..8ac991ae7fd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3319-socketacceptenqueued.md
@@ -0,0 +1,35 @@
+---
+title: "3319 - SocketAcceptEnqueued | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 87afe601-5e25-4964-b9c5-aed6d3d35e1c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3319 - SocketAcceptEnqueued
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3319|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、接続の受け入れを開始したときに生成されます。  
+  
+## メッセージ  
+ 接続の受け入れを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3320-socketaccepted.md b/docs/framework/wcf/diagnostics/etw/3320-socketaccepted.md
new file mode 100644
index 00000000000..b0b3e863024
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3320-socketaccepted.md
@@ -0,0 +1,35 @@
+---
+title: "3320 - SocketAccepted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b98b0066-b78c-4c11-9567-43dbbbd254ce
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3320 - SocketAccepted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3320|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ソケットが受け入れられたときに生成されます。  
+  
+## メッセージ  
+ ListenerId:%1 が SocketId:%2 を受け入れました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3321-connectionpoolmiss.md b/docs/framework/wcf/diagnostics/etw/3321-connectionpoolmiss.md
new file mode 100644
index 00000000000..843ff925c4d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3321-connectionpoolmiss.md
@@ -0,0 +1,35 @@
+---
+title: "3321 - ConnectionPoolMiss | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d889fe16-2224-4770-9917-09f1805397ed
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3321 - ConnectionPoolMiss
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3321|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、プールに使用可能な接続がないときに生成されます。  
+  
+## メッセージ  
+ %1 のプールに使用可能な接続がありません。%2 個の接続がビジー状態です。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3322-dispatchformatterdeserializerequeststart.md b/docs/framework/wcf/diagnostics/etw/3322-dispatchformatterdeserializerequeststart.md
new file mode 100644
index 00000000000..6d4ab4a7f3d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3322-dispatchformatterdeserializerequeststart.md
@@ -0,0 +1,35 @@
+---
+title: "3322 - DispatchFormatterDeserializeRequestStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94ea9c4d-6344-431b-9965-c7094259044d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3322 - DispatchFormatterDeserializeRequestStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3322|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ディスパッチャーが要求メッセージのシリアル化解除を開始したときに生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが要求メッセージのシリアル化解除を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3323-dispatchformatterdeserializerequeststop.md b/docs/framework/wcf/diagnostics/etw/3323-dispatchformatterdeserializerequeststop.md
new file mode 100644
index 00000000000..09e9e432552
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3323-dispatchformatterdeserializerequeststop.md
@@ -0,0 +1,35 @@
+---
+title: "3323 - DispatchFormatterDeserializeRequestStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 867fc93e-ae8f-41b4-9264-210042c4bb75
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3323 - DispatchFormatterDeserializeRequestStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3323|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ディスパッチャーが要求メッセージのシリアル化解除を完了したときに生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが要求メッセージのシリアル化解除を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3324-dispatchformatterserializereplystart.md b/docs/framework/wcf/diagnostics/etw/3324-dispatchformatterserializereplystart.md
new file mode 100644
index 00000000000..5d6a46be3e4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3324-dispatchformatterserializereplystart.md
@@ -0,0 +1,35 @@
+---
+title: "3324 - DispatchFormatterSerializeReplyStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a76cb3c1-e6e7-4b36-9e84-f74f638c867e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3324 - DispatchFormatterSerializeReplyStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3324|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ディスパッチャーが応答メッセージのシリアル化を開始したときに生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが応答メッセージのシリアル化を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3325-dispatchformatterserializereplystop.md b/docs/framework/wcf/diagnostics/etw/3325-dispatchformatterserializereplystop.md
new file mode 100644
index 00000000000..5bd5e093d91
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3325-dispatchformatterserializereplystop.md
@@ -0,0 +1,35 @@
+---
+title: "3325 - DispatchFormatterSerializeReplyStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c96ffb5f-24e2-4c54-92ba-66277b1cea91
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3325 - DispatchFormatterSerializeReplyStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3325|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ディスパッチャーが応答メッセージのシリアル化を完了したときに生成されます。  
+  
+## メッセージ  
+ ディスパッチャーが応答メッセージのシリアル化を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3326-clientformatterserializerequeststart.md b/docs/framework/wcf/diagnostics/etw/3326-clientformatterserializerequeststart.md
new file mode 100644
index 00000000000..b944f23e466
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3326-clientformatterserializerequeststart.md
@@ -0,0 +1,35 @@
+---
+title: "3326 - ClientFormatterSerializeRequestStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d212383-5a34-43f5-8522-9b15ed8ebd87
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3326 - ClientFormatterSerializeRequestStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3326|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアント要求のシリアル化を開始したときに生成されます。  
+  
+## メッセージ  
+ クライアント要求のシリアル化を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3327-clientformatterserializerequeststop.md b/docs/framework/wcf/diagnostics/etw/3327-clientformatterserializerequeststop.md
new file mode 100644
index 00000000000..09ef08acdae
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3327-clientformatterserializerequeststop.md
@@ -0,0 +1,35 @@
+---
+title: "3327 - ClientFormatterSerializeRequestStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 823b34b0-b386-4df4-bb93-4625515761ef
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3327 - ClientFormatterSerializeRequestStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3327|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアントが要求メッセージのシリアル化を完了したときに生成されます。  
+  
+## メッセージ  
+ クライアントが要求メッセージのシリアル化を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3328-clientformatterdeserializereplystart.md b/docs/framework/wcf/diagnostics/etw/3328-clientformatterdeserializereplystart.md
new file mode 100644
index 00000000000..0932c92ada8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3328-clientformatterdeserializereplystart.md
@@ -0,0 +1,35 @@
+---
+title: "3328 - ClientFormatterDeserializeReplyStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3e8cb064-3052-481e-8a81-3e311d9ce138
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3328 - ClientFormatterDeserializeReplyStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3328|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアントが応答メッセージのシリアル化解除を開始したときに生成されます。  
+  
+## メッセージ  
+ クライアントが応答メッセージのシリアル化解除を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3329-clientformatterdeserializereplystop.md b/docs/framework/wcf/diagnostics/etw/3329-clientformatterdeserializereplystop.md
new file mode 100644
index 00000000000..6a30fb9eb43
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3329-clientformatterdeserializereplystop.md
@@ -0,0 +1,35 @@
+---
+title: "3329 - ClientFormatterDeserializeReplyStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c65657a4-80c1-448a-81d9-02d734e66075
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3329 - ClientFormatterDeserializeReplyStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3329|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアントが応答メッセージのシリアル化解除を完了したときに生成されます。  
+  
+## メッセージ  
+ クライアントが応答メッセージのシリアル化解除を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3330-securitynegotiationstart.md b/docs/framework/wcf/diagnostics/etw/3330-securitynegotiationstart.md
new file mode 100644
index 00000000000..d07e0c3c6c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3330-securitynegotiationstart.md
@@ -0,0 +1,35 @@
+---
+title: "3330 - SecurityNegotiationStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83bdebcd-9e84-4be3-81f8-1ec458fe2d5a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3330 - SecurityNegotiationStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3330|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セキュリティ ネゴシエーションが開始されたときに生成されます。  
+  
+## メッセージ  
+ セキュリティ ネゴシエーションを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3331-securitynegotiationstop.md b/docs/framework/wcf/diagnostics/etw/3331-securitynegotiationstop.md
new file mode 100644
index 00000000000..d48d988e48d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3331-securitynegotiationstop.md
@@ -0,0 +1,35 @@
+---
+title: "3331 - SecurityNegotiationStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66ae93c8-00d3-4d6e-88ae-6da694285220
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3331 - SecurityNegotiationStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3331|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セキュリティ ネゴシエーションが完了したときに生成されます。  
+  
+## メッセージ  
+ セキュリティ ネゴシエーションが完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3332-securitytokenprovideropened.md b/docs/framework/wcf/diagnostics/etw/3332-securitytokenprovideropened.md
new file mode 100644
index 00000000000..782691a34d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3332-securitytokenprovideropened.md
@@ -0,0 +1,35 @@
+---
+title: "3332 - SecurityTokenProviderOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 777f58af-0f4a-49b7-a0da-17d54f73dad1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3332 - SecurityTokenProviderOpened
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3332|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SecurityTokenProvider のオープンが完了したときに生成されます。  
+  
+## メッセージ  
+ SecurityTokenProvider のオープンが完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3333-outgoingmessagesecured.md b/docs/framework/wcf/diagnostics/etw/3333-outgoingmessagesecured.md
new file mode 100644
index 00000000000..7554f8fa610
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3333-outgoingmessagesecured.md
@@ -0,0 +1,35 @@
+---
+title: "3333 - OutgoingMessageSecured | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21fe9445-4fa4-4d67-b865-78cecf9b5b82
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3333 - OutgoingMessageSecured
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3333|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、送信メッセージがセキュリティで保護されたときに生成されます。  
+  
+## メッセージ  
+ 送信メッセージがセキュリティで保護されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3334-incomingmessageverified.md b/docs/framework/wcf/diagnostics/etw/3334-incomingmessageverified.md
new file mode 100644
index 00000000000..d18b95359cb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3334-incomingmessageverified.md
@@ -0,0 +1,35 @@
+---
+title: "3334 - IncomingMessageVerified | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9fed3d02-72d7-4581-9abb-aede74331e22
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3334 - IncomingMessageVerified
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3334|  
+|キーワード|セキュリティ ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、受信メッセージが確認されたときに生成されます。  
+  
+## メッセージ  
+ 受信メッセージが確認されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3335-getserviceinstancestart.md b/docs/framework/wcf/diagnostics/etw/3335-getserviceinstancestart.md
new file mode 100644
index 00000000000..02ecedd5b2d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3335-getserviceinstancestart.md
@@ -0,0 +1,35 @@
+---
+title: "3335 - GetServiceInstanceStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c35025d1-b2a1-454d-a6a1-784fc03e2670
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3335 - GetServiceInstanceStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3335|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、サービス インスタンスの取得を開始したときに生成されます。  
+  
+## メッセージ  
+ サービス インスタンスの取得を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3336-getserviceinstancestop.md b/docs/framework/wcf/diagnostics/etw/3336-getserviceinstancestop.md
new file mode 100644
index 00000000000..bc5bb6f99b1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3336-getserviceinstancestop.md
@@ -0,0 +1,35 @@
+---
+title: "3336 - GetServiceInstanceStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4648026e-670d-4743-85f8-3ccfaaf18d6f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3336 - GetServiceInstanceStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3336|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、サービス インスタンスが取得されたときに生成されます。  
+  
+## メッセージ  
+ サービス インスタンスが取得されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3337-channelreceivestart.md b/docs/framework/wcf/diagnostics/etw/3337-channelreceivestart.md
new file mode 100644
index 00000000000..33d806e6e1e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3337-channelreceivestart.md
@@ -0,0 +1,35 @@
+---
+title: "3337 - ChannelReceiveStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa0d226a-3862-4a16-87e6-3bb601084203
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3337 - ChannelReceiveStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3337|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、チャネルの受信が開始されると生成されます。  
+  
+## メッセージ  
+ ChannelHandlerId:%1 \- メッセージ受信ループを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3338-channelreceivestop.md b/docs/framework/wcf/diagnostics/etw/3338-channelreceivestop.md
new file mode 100644
index 00000000000..691f2ffb117
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3338-channelreceivestop.md
@@ -0,0 +1,35 @@
+---
+title: "3338 - ChannelReceiveStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8f0c71e-69e5-4390-aef3-e51c67d0bf0d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3338 - ChannelReceiveStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3338|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、チャネルの受信が停止されると生成されます。  
+  
+## メッセージ  
+ ChannelHandlerId:%1 \- メッセージ受信ループを停止しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3339-channelfactorycreated.md b/docs/framework/wcf/diagnostics/etw/3339-channelfactorycreated.md
new file mode 100644
index 00000000000..169d6766ca0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3339-channelfactorycreated.md
@@ -0,0 +1,35 @@
+---
+title: "3339 - ChannelFactoryCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97a395dd-d0d4-471b-b42f-eb4368cd15e4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3339 - ChannelFactoryCreated
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3339|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、チャネル ファクトリの作成時に生成されます。  
+  
+## メッセージ  
+ ChannelFactory が作成されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3340-pipeconnectionacceptstart.md b/docs/framework/wcf/diagnostics/etw/3340-pipeconnectionacceptstart.md
new file mode 100644
index 00000000000..9a85493b53a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3340-pipeconnectionacceptstart.md
@@ -0,0 +1,35 @@
+---
+title: "3340 - PipeConnectionAcceptStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c18d0db8-6f44-42ab-b297-5e0209789e5c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3340 - PipeConnectionAcceptStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3340|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、パイプ接続の受け入れが開始されるときに生成されます。  
+  
+## メッセージ  
+ %1 でパイプ接続の受け入れを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3341-pipeconnectionacceptstop.md b/docs/framework/wcf/diagnostics/etw/3341-pipeconnectionacceptstop.md
new file mode 100644
index 00000000000..940a40bbafa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3341-pipeconnectionacceptstop.md
@@ -0,0 +1,35 @@
+---
+title: "3341 - PipeConnectionAcceptStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85d20b28-53c2-4206-90bc-8564a03dcb49
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3341 - PipeConnectionAcceptStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3341|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、パイプ接続の受け入れを停止したときに生成されます。  
+  
+## メッセージ  
+ パイプ接続を受け入れました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3342-establishconnectionstart.md b/docs/framework/wcf/diagnostics/etw/3342-establishconnectionstart.md
new file mode 100644
index 00000000000..83626cd1990
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3342-establishconnectionstart.md
@@ -0,0 +1,35 @@
+---
+title: "3342 - EstablishConnectionStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2f2e3446-1f0c-4e8a-b14c-0e500de0f075
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3342 - EstablishConnectionStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3342|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、接続の確立を開始したときに生成されます。  
+  
+## メッセージ  
+ %1 の接続の確立を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3343-establishconnectionstop.md b/docs/framework/wcf/diagnostics/etw/3343-establishconnectionstop.md
new file mode 100644
index 00000000000..e0cae02af06
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3343-establishconnectionstop.md
@@ -0,0 +1,35 @@
+---
+title: "3343 - EstablishConnectionStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ddbaae5-2de0-45d0-90d2-0ab135fea31f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3343 - EstablishConnectionStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3343|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、接続の確立を停止したときに生成されます。  
+  
+## メッセージ  
+ 接続が確立されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3345-sessionpreambleunderstood.md b/docs/framework/wcf/diagnostics/etw/3345-sessionpreambleunderstood.md
new file mode 100644
index 00000000000..ac29bd9e624
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3345-sessionpreambleunderstood.md
@@ -0,0 +1,35 @@
+---
+title: "3345 - SessionPreambleUnderstood | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8e9fcda-7dbc-4670-bb47-b365219f3046
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3345 - SessionPreambleUnderstood
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3345|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、NetTcp のセッション プリアンブルが認識されると生成されます。  
+  
+## メッセージ  
+ '%1' のセッション プリアンブルが認識されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3346-connectionreadersendfault.md b/docs/framework/wcf/diagnostics/etw/3346-connectionreadersendfault.md
new file mode 100644
index 00000000000..cde780c1276
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3346-connectionreadersendfault.md
@@ -0,0 +1,35 @@
+---
+title: "3346 - ConnectionReaderSendFault | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 137c665f-0ea1-4405-bf48-65aabfad97e5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3346 - ConnectionReaderSendFault
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3346|  
+|キーワード|チャネル|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、接続リーダーがエラーを送信するときに生成されます。  
+  
+## メッセージ  
+ 接続リーダーがエラー '%1' を送信しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3347-socketacceptclosed.md b/docs/framework/wcf/diagnostics/etw/3347-socketacceptclosed.md
new file mode 100644
index 00000000000..a9e30b15c8b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3347-socketacceptclosed.md
@@ -0,0 +1,35 @@
+---
+title: "3347 - SocketAcceptClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a84ea364-b0e1-4bee-a497-dc2b988cc4c3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3347 - SocketAcceptClosed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3347|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ソケットの受け入れが終了したときに生成されます。  
+  
+## メッセージ  
+ ソケットの受け入れを終了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3348-servicehostfaulted.md b/docs/framework/wcf/diagnostics/etw/3348-servicehostfaulted.md
new file mode 100644
index 00000000000..e7a365b188c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3348-servicehostfaulted.md
@@ -0,0 +1,35 @@
+---
+title: "3348 - ServiceHostFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b58ab2e-4b11-4967-ad16-724d509814a1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3348 - ServiceHostFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3348|  
+|キーワード|TCP|  
+|レベル|重大|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス ホストが途中終了したときに生成されます。  
+  
+## メッセージ  
+ サービス ホストが途中終了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3349-listeneropenstart.md b/docs/framework/wcf/diagnostics/etw/3349-listeneropenstart.md
new file mode 100644
index 00000000000..d69e87906e4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3349-listeneropenstart.md
@@ -0,0 +1,35 @@
+---
+title: "3349 - ListenerOpenStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9625f9bc-45c0-4a0d-8f97-34d1672f556c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3349 - ListenerOpenStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3349|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ListenerOpen が開始されると生成されます。  
+  
+## メッセージ  
+ '%1' のリスナーを開いています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3350-listeneropenstop.md b/docs/framework/wcf/diagnostics/etw/3350-listeneropenstop.md
new file mode 100644
index 00000000000..a47c218faf8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3350-listeneropenstop.md
@@ -0,0 +1,35 @@
+---
+title: "3350 - ListenerOpenStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67211588-3c52-465a-92dd-20185e7edcf0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3350 - ListenerOpenStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3350|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ListenerOpen が停止すると生成されます。  
+  
+## メッセージ  
+ リスナーのオープンが完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3351-servermaxpooledconnectionsquotareached.md b/docs/framework/wcf/diagnostics/etw/3351-servermaxpooledconnectionsquotareached.md
new file mode 100644
index 00000000000..44c1470b2c0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3351-servermaxpooledconnectionsquotareached.md
@@ -0,0 +1,35 @@
+---
+title: "3351 - ServerMaxPooledConnectionsQuotaReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2ca1131-0017-4a5f-ab7b-2b0f73589e84
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3351 - ServerMaxPooledConnectionsQuotaReached
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3351|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サーバーのプールされた接続の最大クォータに達したときに生成されます。  
+  
+## メッセージ  
+ サーバーのプールされた接続の最大クォータに達しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3352-tcpconnectiontimedout.md b/docs/framework/wcf/diagnostics/etw/3352-tcpconnectiontimedout.md
new file mode 100644
index 00000000000..fcdd7da663b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3352-tcpconnectiontimedout.md
@@ -0,0 +1,35 @@
+---
+title: "3352 - TcpConnectionTimedOut | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8340caa6-1ccb-48b7-8340-5052d3c811f6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3352 - TcpConnectionTimedOut
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3352|  
+|キーワード|TCP|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP 接続がタイムアウトしたときに生成されます。  
+  
+## メッセージ  
+ リモート アドレス %2 への SocketId:%1 がタイムアウトしました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3353-tcpconnectionreseterror.md b/docs/framework/wcf/diagnostics/etw/3353-tcpconnectionreseterror.md
new file mode 100644
index 00000000000..4c38bce3aab
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3353-tcpconnectionreseterror.md
@@ -0,0 +1,35 @@
+---
+title: "3353 - TcpConnectionResetError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19df26fe-1088-4969-b137-b6f25740b468
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3353 - TcpConnectionResetError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3353|  
+|キーワード|TCP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP 接続リセット エラーが発生すると生成されます。  
+  
+## メッセージ  
+ リモート アドレス %2 への SocketId:%1 で接続リセット エラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3354-servicesecuritynegotiationcompleted.md b/docs/framework/wcf/diagnostics/etw/3354-servicesecuritynegotiationcompleted.md
new file mode 100644
index 00000000000..5ea021b2d3c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3354-servicesecuritynegotiationcompleted.md
@@ -0,0 +1,35 @@
+---
+title: "3354 - ServiceSecurityNegotiationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 093aeefe-1609-4409-b6d2-00f71772bcf7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3354 - ServiceSecurityNegotiationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3354|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、サービス セキュリティ ネゴシエーションが完了したときに生成されます。  
+  
+## メッセージ  
+ サービス セキュリティ ネゴシエーションが完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3355-securitynegotiationprocessingfailure.md b/docs/framework/wcf/diagnostics/etw/3355-securitynegotiationprocessingfailure.md
new file mode 100644
index 00000000000..f6ee7ab95bb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3355-securitynegotiationprocessingfailure.md
@@ -0,0 +1,35 @@
+---
+title: "3355 - SecurityNegotiationProcessingFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 504f85f0-d11d-4de0-a0ab-ea580a476d18
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3355 - SecurityNegotiationProcessingFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3355|  
+|キーワード|セキュリティ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セキュリティ ネゴシエーション処理に失敗したときに生成されます。  
+  
+## メッセージ  
+ セキュリティ ネゴシエーション処理が失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3356-securityidentityverificationsuccess.md b/docs/framework/wcf/diagnostics/etw/3356-securityidentityverificationsuccess.md
new file mode 100644
index 00000000000..3ec7f35fe78
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3356-securityidentityverificationsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "3356 - SecurityIdentityVerificationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4fb4899c-bfcc-437e-b4d5-313b83b1ae29
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3356 - SecurityIdentityVerificationSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3356|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セキュリティの検証に成功したときに生成されます。  
+  
+## メッセージ  
+ セキュリティ検証が成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3357-securityidentityverificationfailure.md b/docs/framework/wcf/diagnostics/etw/3357-securityidentityverificationfailure.md
new file mode 100644
index 00000000000..1417841eb14
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3357-securityidentityverificationfailure.md
@@ -0,0 +1,35 @@
+---
+title: "3357 - SecurityIdentityVerificationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5629542-9067-42ba-b1cc-e8af61484643
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3357 - SecurityIdentityVerificationFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3357|  
+|キーワード|セキュリティ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セキュリティ検証に失敗したときに生成されます。  
+  
+## メッセージ  
+ セキュリティ検証に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3358-portsharingduplicatedsocket.md b/docs/framework/wcf/diagnostics/etw/3358-portsharingduplicatedsocket.md
new file mode 100644
index 00000000000..c655cee7d1f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3358-portsharingduplicatedsocket.md
@@ -0,0 +1,35 @@
+---
+title: "3358 - PortSharingDuplicatedSocket | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6e5c051-5597-49d1-a5ea-0a26ec04443d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3358 - PortSharingDuplicatedSocket
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3358|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ポート共有ソケットが複製されるときに生成されます。  
+  
+## メッセージ  
+ %1 のソケットが複製されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3359-securityimpersonationsuccess.md b/docs/framework/wcf/diagnostics/etw/3359-securityimpersonationsuccess.md
new file mode 100644
index 00000000000..e0223303a80
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3359-securityimpersonationsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "3359 - SecurityImpersonationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 80bcea7c-ae57-4b89-8032-5f9787545b07
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3359 - SecurityImpersonationSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3359|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セキュリティの偽装に成功すると生成されます。  
+  
+## メッセージ  
+ セキュリティの偽装に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3360-securityimpersonationfailure.md b/docs/framework/wcf/diagnostics/etw/3360-securityimpersonationfailure.md
new file mode 100644
index 00000000000..c090f7ecdc2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3360-securityimpersonationfailure.md
@@ -0,0 +1,35 @@
+---
+title: "3360 - SecurityImpersonationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ef28970-7822-4eb3-b266-f6554deb1b5b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3360 - SecurityImpersonationFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3360|  
+|キーワード|セキュリティ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セキュリティの偽装に失敗すると生成されます。  
+  
+## メッセージ  
+ セキュリティの偽装に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3361-httpchannelrequestaborted.md b/docs/framework/wcf/diagnostics/etw/3361-httpchannelrequestaborted.md
new file mode 100644
index 00000000000..80d6e1579de
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3361-httpchannelrequestaborted.md
@@ -0,0 +1,35 @@
+---
+title: "3361 - HttpChannelRequestAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0150156e-9ff9-4f44-b941-2441d40fc265
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3361 - HttpChannelRequestAborted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3361|  
+|キーワード|HTTP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP チャネルの要求が中止されたときに生成されます。  
+  
+## メッセージ  
+ HTTP チャネルの要求が中止されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3362-httpchannelresponseaborted.md b/docs/framework/wcf/diagnostics/etw/3362-httpchannelresponseaborted.md
new file mode 100644
index 00000000000..f3ff07f31fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3362-httpchannelresponseaborted.md
@@ -0,0 +1,35 @@
+---
+title: "3362 - HttpChannelResponseAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94bb6f7c-fa87-400c-9f11-75a139f51de4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3362 - HttpChannelResponseAborted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3362|  
+|キーワード|HTTP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP チャネルの応答が中止されたときに生成されます。  
+  
+## メッセージ  
+ HTTP チャネルの応答が中止されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3363-httpauthfailed.md b/docs/framework/wcf/diagnostics/etw/3363-httpauthfailed.md
new file mode 100644
index 00000000000..bd0e6e3f06f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3363-httpauthfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3363 - HttpAuthFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ddfc1f0-ab6f-4fd4-a138-05ded7f6680a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3363 - HttpAuthFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3363|  
+|キーワード|HTTP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP 認証が失敗したときに生成されます。  
+  
+## メッセージ  
+ HTTP 認証に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3364-sharedlistenerproxyregisterstart.md b/docs/framework/wcf/diagnostics/etw/3364-sharedlistenerproxyregisterstart.md
new file mode 100644
index 00000000000..cc79395c378
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3364-sharedlistenerproxyregisterstart.md
@@ -0,0 +1,35 @@
+---
+title: "3364 - SharedListenerProxyRegisterStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfbbf889-46ef-484c-8811-1f51ae4790d8
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 3364 - SharedListenerProxyRegisterStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3364|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、SharedListenerProxy の登録が開始されたときに生成されます。  
+  
+## メッセージ  
+ URI '%1' の SharedListenerProxy の登録を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3365-sharedlistenerproxyregisterstop.md b/docs/framework/wcf/diagnostics/etw/3365-sharedlistenerproxyregisterstop.md
new file mode 100644
index 00000000000..41c39166f2f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3365-sharedlistenerproxyregisterstop.md
@@ -0,0 +1,35 @@
+---
+title: "3365 - SharedListenerProxyRegisterStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a74173b3-13e8-41b0-9753-8eaef9b71b90
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3365 - SharedListenerProxyRegisterStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3365|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、SharedListenerProxy の登録が停止されたときに生成されます。  
+  
+## メッセージ  
+ SharedListenerProxy の登録を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3366-sharedlistenerproxyregisterfailed.md b/docs/framework/wcf/diagnostics/etw/3366-sharedlistenerproxyregisterfailed.md
new file mode 100644
index 00000000000..924d7e898bf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3366-sharedlistenerproxyregisterfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3366 - SharedListenerProxyRegisterFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28f6151c-650f-473d-a807-cb06b56f67f1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3366 - SharedListenerProxyRegisterFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3366|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、SharedListenerProxy の登録が失敗すると生成されます。  
+  
+## メッセージ  
+ SharedListenerProxy の登録は状態 '%1' で失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3367-connectionpoolpreamblefailed.md b/docs/framework/wcf/diagnostics/etw/3367-connectionpoolpreamblefailed.md
new file mode 100644
index 00000000000..de2c89332b2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3367-connectionpoolpreamblefailed.md
@@ -0,0 +1,35 @@
+---
+title: "3367 - ConnectionPoolPreambleFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8ce3088-b621-4c84-a4d7-826afc33537f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3367 - ConnectionPoolPreambleFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3367|  
+|キーワード|チャネル|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ConnectionPoolPreamble が失敗したときに生成されます。  
+  
+## メッセージ  
+ ConnectionPoolPreambleFailed。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3368-ssloninitiateupgrade.md b/docs/framework/wcf/diagnostics/etw/3368-ssloninitiateupgrade.md
new file mode 100644
index 00000000000..442dd7b0c82
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3368-ssloninitiateupgrade.md
@@ -0,0 +1,35 @@
+---
+title: "3368 - SslOnInitiateUpgrade | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: daba19f6-f4b3-4dd6-9ba2-93c9666ba71e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3368 - SslOnInitiateUpgrade
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3368|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、SslOnAcceptUpgrade が開始すると生成されます。  
+  
+## メッセージ  
+ SslOnAcceptUpgradeStart  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3369-sslonacceptupgrade.md b/docs/framework/wcf/diagnostics/etw/3369-sslonacceptupgrade.md
new file mode 100644
index 00000000000..0483219bb8a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3369-sslonacceptupgrade.md
@@ -0,0 +1,35 @@
+---
+title: "3369 - SslOnAcceptUpgrade | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dec93b38-d97c-4c9e-8891-7cefa0a8aa5b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3369 - SslOnAcceptUpgrade
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3369|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、SslOnAcceptUpgrade が停止すると生成されます。  
+  
+## メッセージ  
+ SslOnAcceptUpgradeStop  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3370-binarymessageencodingstart.md b/docs/framework/wcf/diagnostics/etw/3370-binarymessageencodingstart.md
new file mode 100644
index 00000000000..e9d0b9c446e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3370-binarymessageencodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3370 - BinaryMessageEncodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 624f8dab-a150-468e-9709-613621a8627f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3370 - BinaryMessageEncodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3370|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、BinaryMessageEncoder がメッセージのエンコードを開始したときに生成されます。  
+  
+## メッセージ  
+ BinaryMessageEncoder がメッセージのエンコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3371-mtommessageencodingstart.md b/docs/framework/wcf/diagnostics/etw/3371-mtommessageencodingstart.md
new file mode 100644
index 00000000000..1a9677f1d36
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3371-mtommessageencodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3371 - MtomMessageEncodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b1ba417f-f765-4567-82e3-ea2080e0ac73
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3371 - MtomMessageEncodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3371|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、MtomMessageEncoder がメッセージのエンコードを開始したときに生成されます。  
+  
+## メッセージ  
+ MtomMessageEncoder がメッセージのエンコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3372-textmessageencodingstart.md b/docs/framework/wcf/diagnostics/etw/3372-textmessageencodingstart.md
new file mode 100644
index 00000000000..425333e2ad2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3372-textmessageencodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3372 - TextMessageEncodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c57e3fe3-b12d-415e-925e-b09590722d0c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3372 - TextMessageEncodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3372|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、TextMessageEncoder がメッセージのエンコードを開始したときに生成されます。  
+  
+## メッセージ  
+ TextMessageEncoder がメッセージのエンコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3373-binarymessagedecodingstart.md b/docs/framework/wcf/diagnostics/etw/3373-binarymessagedecodingstart.md
new file mode 100644
index 00000000000..0f6a0e40e07
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3373-binarymessagedecodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3373 - BinaryMessageDecodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 20b13b33-d67d-47fd-aeec-a7fa3fc87c26
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3373 - BinaryMessageDecodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3373|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、BinaryMessageEncoder がメッセージのデコードを開始したときに生成されます。  
+  
+## メッセージ  
+ BinaryMessageEncoder がメッセージのデコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3374-mtommessagedecodingstart.md b/docs/framework/wcf/diagnostics/etw/3374-mtommessagedecodingstart.md
new file mode 100644
index 00000000000..0c20c1c9914
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3374-mtommessagedecodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3374 - MtomMessageDecodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72afd61d-da6b-418e-b26a-efc7bdb0a218
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3374 - MtomMessageDecodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3374|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、MtomMessageEncoder がメッセージのデコードを開始したときに生成されます。  
+  
+## メッセージ  
+ MtomMessageEncoder がメッセージのデコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3375-textmessagedecodingstart.md b/docs/framework/wcf/diagnostics/etw/3375-textmessagedecodingstart.md
new file mode 100644
index 00000000000..1c0f96e50dc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3375-textmessagedecodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3375 - TextMessageDecodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7152c0e-10e5-4446-b52d-60838fb99748
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3375 - TextMessageDecodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3375|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、TextMessageEncoder がメッセージのデコードを開始したときに生成されます。  
+  
+## メッセージ  
+ TextMessageEncoder がメッセージのデコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3376-httpresponsereceivestart.md b/docs/framework/wcf/diagnostics/etw/3376-httpresponsereceivestart.md
new file mode 100644
index 00000000000..41c3e501a05
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3376-httpresponsereceivestart.md
@@ -0,0 +1,35 @@
+---
+title: "3376 - HttpResponseReceiveStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37cdd555-b28d-42d8-ab35-085417309503
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3376 - HttpResponseReceiveStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3376|  
+|キーワード|HTTP|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、HTTP トランスポートがメッセージの受信を開始したときに生成されます。  
+  
+## メッセージ  
+ HTTP トランスポートがメッセージの受信を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3377-socketreadstop.md b/docs/framework/wcf/diagnostics/etw/3377-socketreadstop.md
new file mode 100644
index 00000000000..63063c1cfb0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3377-socketreadstop.md
@@ -0,0 +1,35 @@
+---
+title: "3377 - SocketReadStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 980c24e8-47d5-4f1e-86cc-1cb1c0736d19
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3377 - SocketReadStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3377|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SocketRead が停止すると生成されます。  
+  
+## メッセージ  
+ SocketId:%1 が '%3' から '%2' バイトを読み取りました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3378-socketasyncreadstop.md b/docs/framework/wcf/diagnostics/etw/3378-socketasyncreadstop.md
new file mode 100644
index 00000000000..7bc84b3b0f2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3378-socketasyncreadstop.md
@@ -0,0 +1,35 @@
+---
+title: "3378 - SocketAsyncReadStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7b5b73e-c1cd-41a5-9a0b-ab86af437f60
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3378 - SocketAsyncReadStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3378|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SocketAsyncRead が停止している場合に生成されます。  
+  
+## メッセージ  
+ SocketId:%1 が '%3' から '%2' バイトを読み取りました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3379-socketwritestart.md b/docs/framework/wcf/diagnostics/etw/3379-socketwritestart.md
new file mode 100644
index 00000000000..6d04cc756cb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3379-socketwritestart.md
@@ -0,0 +1,35 @@
+---
+title: "3379 - SocketWriteStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 26523526-258b-4721-b681-ef1a19f33fa1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3379 - SocketWriteStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3379|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SocketWrite が開始するときに生成されます。  
+  
+## メッセージ  
+ SocketId:%1 が '%3' に '%2' バイトを書き込んでいます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3380-socketasyncwritestart.md b/docs/framework/wcf/diagnostics/etw/3380-socketasyncwritestart.md
new file mode 100644
index 00000000000..2e25bef27c4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3380-socketasyncwritestart.md
@@ -0,0 +1,35 @@
+---
+title: "3380 - SocketAsyncWriteStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1de37c02-e14b-42ad-a23a-9ee8edc354b5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3380 - SocketAsyncWriteStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3380|  
+|キーワード|TCP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SocketAsyncWrite が開始すると生成されます。  
+  
+## メッセージ  
+ SocketId:%1 が '%3' に '%2' バイトを書き込んでいます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3381-sequenceacknowledgementsent.md b/docs/framework/wcf/diagnostics/etw/3381-sequenceacknowledgementsent.md
new file mode 100644
index 00000000000..072e64529f0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3381-sequenceacknowledgementsent.md
@@ -0,0 +1,35 @@
+---
+title: "3381 - SequenceAcknowledgementSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42630d32-c24d-41b9-9106-9ca1a3e2f7d8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3381 - SequenceAcknowledgementSent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3381|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SequenceAcknowledgement が送信されるときに生成されます。  
+  
+## メッセージ  
+ SessionId:%1 の受信確認が送信されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3382-clientreliablesessionreconnect.md b/docs/framework/wcf/diagnostics/etw/3382-clientreliablesessionreconnect.md
new file mode 100644
index 00000000000..ac4a4875fc9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3382-clientreliablesessionreconnect.md
@@ -0,0 +1,36 @@
+---
+title: "3382 - ClientReliableSessionReconnect | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 029c0e75-8cf0-4860-8539-c2baa18eb7a7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3382 - ClientReliableSessionReconnect
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3382|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは ClientReliableSession を再接続するときに生成されます。  
+  
+## メッセージ  
+ SessionId:%1 を再接続します。  
+  
+## 詳細  
+ このイベントは ClientReliableSession を再接続するときに生成されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3383-reliablesessionchannelfaulted.md b/docs/framework/wcf/diagnostics/etw/3383-reliablesessionchannelfaulted.md
new file mode 100644
index 00000000000..55cc6f3276c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3383-reliablesessionchannelfaulted.md
@@ -0,0 +1,35 @@
+---
+title: "3383 - ReliableSessionChannelFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f5948284-8536-4ab8-9c81-e22da5b56d62
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3383 - ReliableSessionChannelFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3383|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ReliableSessionChannel が失敗したときに生成されます。  
+  
+## メッセージ  
+ SessionId:%1 でエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3384-windowsstreamsecurityoninitiateupgrade.md b/docs/framework/wcf/diagnostics/etw/3384-windowsstreamsecurityoninitiateupgrade.md
new file mode 100644
index 00000000000..af5abe70841
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3384-windowsstreamsecurityoninitiateupgrade.md
@@ -0,0 +1,35 @@
+---
+title: "3384 - WindowsStreamSecurityOnInitiateUpgrade | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a9f6b38-5ee7-45f3-9d87-556045d15e09
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3384 - WindowsStreamSecurityOnInitiateUpgrade
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3384|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WindowsStreamSecurity がセキュリティ アップグレードを開始したときに生成されます。  
+  
+## メッセージ  
+ WindowsStreamSecurity がセキュリティ アップグレードを開始しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3385-windowsstreamsecurityonacceptupgrade.md b/docs/framework/wcf/diagnostics/etw/3385-windowsstreamsecurityonacceptupgrade.md
new file mode 100644
index 00000000000..2323b114adf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3385-windowsstreamsecurityonacceptupgrade.md
@@ -0,0 +1,35 @@
+---
+title: "3385 - WindowsStreamSecurityOnAcceptUpgrade | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d17dc6a-befb-49f0-a150-c4875405ce7a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3385 - WindowsStreamSecurityOnAcceptUpgrade
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3385|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Windows ストリーム セキュリティがセキュリティ アップグレードを受け入れるときに生成されます。  
+  
+## メッセージ  
+ Windows ストリーミング セキュリティがアップグレードを受け入れています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3386-socketconnectionabort.md b/docs/framework/wcf/diagnostics/etw/3386-socketconnectionabort.md
new file mode 100644
index 00000000000..aae21118125
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3386-socketconnectionabort.md
@@ -0,0 +1,35 @@
+---
+title: "3386 - SocketConnectionAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37a184f2-af60-4339-820a-857e2375cb1c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3386 - SocketConnectionAbort
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3386|  
+|キーワード|TCP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ソケット接続を中止するときに生成されます。  
+  
+## メッセージ  
+ SocketId:%1 を中止しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3388-httpgetcontextstart.md b/docs/framework/wcf/diagnostics/etw/3388-httpgetcontextstart.md
new file mode 100644
index 00000000000..b1b43b14990
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3388-httpgetcontextstart.md
@@ -0,0 +1,35 @@
+---
+title: "3388 - HttpGetContextStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: def9b441-9bb2-4bc0-a4b3-4db07b80b557
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3388 - HttpGetContextStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3388|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HttpGetContext の開始時に生成されます。  
+  
+## メッセージ  
+ HttpGetContext を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3389-clientsendpreamblestart.md b/docs/framework/wcf/diagnostics/etw/3389-clientsendpreamblestart.md
new file mode 100644
index 00000000000..cf510273754
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3389-clientsendpreamblestart.md
@@ -0,0 +1,35 @@
+---
+title: "3389 - ClientSendPreambleStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c31e8b2d-14ba-41c4-ab9b-205d591b078d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3389 - ClientSendPreambleStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3389|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアントがプリアンブルの送信を開始したときに生成されます。  
+  
+## メッセージ  
+ クライアントがプリアンブルの送信を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3390-clientsendpreamblestop.md b/docs/framework/wcf/diagnostics/etw/3390-clientsendpreamblestop.md
new file mode 100644
index 00000000000..b582c08a769
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3390-clientsendpreamblestop.md
@@ -0,0 +1,35 @@
+---
+title: "3390 - ClientSendPreambleStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fbf6e4ed-8538-417e-b4d1-a30b45ee6b5d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3390 - ClientSendPreambleStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3390|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアントがプリアンブルの送信を停止したときに生成されます。  
+  
+## メッセージ  
+ クライアントがプリアンブルの送信を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3391-httpmessagereceivefailed.md b/docs/framework/wcf/diagnostics/etw/3391-httpmessagereceivefailed.md
new file mode 100644
index 00000000000..d6d1d341301
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3391-httpmessagereceivefailed.md
@@ -0,0 +1,35 @@
+---
+title: "3391 - HttpMessageReceiveFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9fc527ed-57ad-46fe-8b81-940f4b992368
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3391 - HttpMessageReceiveFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3391|  
+|キーワード|HTTP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP メッセージの受信に失敗したときに生成されます。  
+  
+## メッセージ  
+ HTTP メッセージの受信に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3392-transactionscopecreate.md b/docs/framework/wcf/diagnostics/etw/3392-transactionscopecreate.md
new file mode 100644
index 00000000000..01fd77adb24
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3392-transactionscopecreate.md
@@ -0,0 +1,35 @@
+---
+title: "3392 - TransactionScopeCreate | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b6257a6-683b-4adc-aca5-6d095e4c03a0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3392 - TransactionScopeCreate
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3392|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、TransactionScope の作成時に生成されます。  
+  
+## メッセージ  
+ LocalIdentifier:'%1' および DistributedIdentifier:'%2' の TransactionScope を作成しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3393-streamedmessagereadbyencoder.md b/docs/framework/wcf/diagnostics/etw/3393-streamedmessagereadbyencoder.md
new file mode 100644
index 00000000000..ac851037d49
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3393-streamedmessagereadbyencoder.md
@@ -0,0 +1,35 @@
+---
+title: "3393 - StreamedMessageReadByEncoder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70ebde45-9e46-4adb-9020-c17e9c6786e4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3393 - StreamedMessageReadByEncoder
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3393|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンコーダーによってストリーム メッセージが読み取られたときに生成されます。  
+  
+## メッセージ  
+ エンコーダーによってストリーム メッセージが読み取られました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3394-streamedmessagewrittenbyencoder.md b/docs/framework/wcf/diagnostics/etw/3394-streamedmessagewrittenbyencoder.md
new file mode 100644
index 00000000000..fedc71e5b4d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3394-streamedmessagewrittenbyencoder.md
@@ -0,0 +1,35 @@
+---
+title: "3394 - StreamedMessageWrittenByEncoder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b3a1a76-e5f7-4421-86cf-d201d724671e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3394 - StreamedMessageWrittenByEncoder
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3394|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンコーダーによってストリーム メッセージが書き込まれたときに生成されます。  
+  
+## メッセージ  
+ エンコーダーによってストリーム メッセージが書き込まれました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3395-messagewrittenasynchronouslybyencoder.md b/docs/framework/wcf/diagnostics/etw/3395-messagewrittenasynchronouslybyencoder.md
new file mode 100644
index 00000000000..140ac9d70fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3395-messagewrittenasynchronouslybyencoder.md
@@ -0,0 +1,35 @@
+---
+title: "3395 - MessageWrittenAsynchronouslyByEncoder | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2b015b3-dafe-4468-a3ac-5b547ff413e6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3395 - MessageWrittenAsynchronouslyByEncoder
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3395|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンコーダーによってストリーム メッセージが非同期で書き込まれたときに生成されます。  
+  
+## メッセージ  
+ エンコーダーによってメッセージが非同期で書き込まれました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3396-bufferedasyncwritestart.md b/docs/framework/wcf/diagnostics/etw/3396-bufferedasyncwritestart.md
new file mode 100644
index 00000000000..a9e4954e962
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3396-bufferedasyncwritestart.md
@@ -0,0 +1,35 @@
+---
+title: "3396 - BufferedAsyncWriteStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8baff8c-0a47-47a6-9997-d3b178176bb9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3396 - BufferedAsyncWriteStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3396|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、バッファリングされた非同期書き込みが完了したときに生成されます。  
+  
+## メッセージ  
+ BufferId:%1 から基になるストリームへの '%2' バイトの書き込みが完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3397-bufferedasyncwritestop.md b/docs/framework/wcf/diagnostics/etw/3397-bufferedasyncwritestop.md
new file mode 100644
index 00000000000..8cd75e386ee
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3397-bufferedasyncwritestop.md
@@ -0,0 +1,35 @@
+---
+title: "3397 - BufferedAsyncWriteStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bbf56fc-04fe-443b-ae97-769814c7be57
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3397 - BufferedAsyncWriteStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3397|  
+|キーワード|チャネル|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンコーダーによってメッセージが非同期に書き込まれたときに生成されます。  
+  
+## メッセージ  
+ エンコーダーによってメッセージが非同期で書き込まれました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3398-pipesharedmemorycreated.md b/docs/framework/wcf/diagnostics/etw/3398-pipesharedmemorycreated.md
new file mode 100644
index 00000000000..c292251e7bc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3398-pipesharedmemorycreated.md
@@ -0,0 +1,35 @@
+---
+title: "3398 - PipeSharedMemoryCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d68ec947-a174-4425-9c12-de56dd3a7f7a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3398 - PipeSharedMemoryCreated
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3398|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、パイプ共有メモリが作成されたときに生成されます。  
+  
+## メッセージ  
+ パイプ共有メモリが '%1' に作成されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3399-namedpipecreated.md b/docs/framework/wcf/diagnostics/etw/3399-namedpipecreated.md
new file mode 100644
index 00000000000..d7d069196fc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3399-namedpipecreated.md
@@ -0,0 +1,35 @@
+---
+title: "3399 - NamedPipeCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1619c06b-4d27-4e23-8967-bb1d19a27792
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3399 - NamedPipeCreated
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3399|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、名前付きパイプが作成されたときに生成されます。  
+  
+## メッセージ  
+ NamedPipe '%1' が作成されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3401-signatureverificationstart.md b/docs/framework/wcf/diagnostics/etw/3401-signatureverificationstart.md
new file mode 100644
index 00000000000..3d6cbe7fc07
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3401-signatureverificationstart.md
@@ -0,0 +1,35 @@
+---
+title: "3401 - SignatureVerificationStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb2c81be-3dae-45a8-8558-c5d0cbb8958a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3401 - SignatureVerificationStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3401|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、署名の検証が開始されたときに生成されます。  
+  
+## メッセージ  
+ 署名の検証を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3402-signatureverificationsuccess.md b/docs/framework/wcf/diagnostics/etw/3402-signatureverificationsuccess.md
new file mode 100644
index 00000000000..470f48f96bd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3402-signatureverificationsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "3402 - SignatureVerificationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d3a3026-25a8-4f13-a76f-8d3afdeb3bf3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3402 - SignatureVerificationSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3402|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、署名の検証に成功すると生成されます。  
+  
+## メッセージ  
+ 署名の検証に成功しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3403-wrappedkeydecryptionstart.md b/docs/framework/wcf/diagnostics/etw/3403-wrappedkeydecryptionstart.md
new file mode 100644
index 00000000000..e0d6bcd6009
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3403-wrappedkeydecryptionstart.md
@@ -0,0 +1,35 @@
+---
+title: "3403 - WrappedKeyDecryptionStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 267e2b54-6c42-42c0-bb2e-7e6af013bc6b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3403 - WrappedKeyDecryptionStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3403|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ラップされたキーの解読が開始されたときに生成されます。  
+  
+## メッセージ  
+ ラップされたキーの解読を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3404-wrappedkeydecryptionsuccess.md b/docs/framework/wcf/diagnostics/etw/3404-wrappedkeydecryptionsuccess.md
new file mode 100644
index 00000000000..ac51a99a390
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3404-wrappedkeydecryptionsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "3404 - WrappedKeyDecryptionSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35ae79a1-ec00-4db7-9073-4a5dbd62dc82
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3404 - WrappedKeyDecryptionSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3404|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ラップされたキーの解読に成功すると生成されます。  
+  
+## メッセージ  
+ ラップされたキーの解読に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3405-encrypteddataprocessingstart.md b/docs/framework/wcf/diagnostics/etw/3405-encrypteddataprocessingstart.md
new file mode 100644
index 00000000000..120cb7375fd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3405-encrypteddataprocessingstart.md
@@ -0,0 +1,35 @@
+---
+title: "3405 - EncryptedDataProcessingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bdb6e4e8-ec85-4629-a43a-7836d445ecab
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3405 - EncryptedDataProcessingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3405|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、暗号化されたデータの処理が開始されたときに生成されます。  
+  
+## メッセージ  
+ 暗号化されたデータの処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3406-encrypteddataprocessingsuccess.md b/docs/framework/wcf/diagnostics/etw/3406-encrypteddataprocessingsuccess.md
new file mode 100644
index 00000000000..ca76e2acc75
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3406-encrypteddataprocessingsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "3406 - EncryptedDataProcessingSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7065c508-46c4-49ea-a7cf-e038e9246e29
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3406 - EncryptedDataProcessingSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3406|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、暗号化されたデータの処理が成功したときに生成されます。  
+  
+## メッセージ  
+ 暗号化されたデータの処理に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3407-httppipelineprocessinboundrequeststart.md b/docs/framework/wcf/diagnostics/etw/3407-httppipelineprocessinboundrequeststart.md
new file mode 100644
index 00000000000..563c88b4d87
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3407-httppipelineprocessinboundrequeststart.md
@@ -0,0 +1,35 @@
+---
+title: "3407 - HttpPipelineProcessInboundRequestStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f9cc34e8-f4e1-43c8-823f-6186ee5e676f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3407 - HttpPipelineProcessInboundRequestStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3407|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが受信要求の処理を開始したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、受信要求の処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3408-httppipelinebeginprocessinboundrequeststart.md b/docs/framework/wcf/diagnostics/etw/3408-httppipelinebeginprocessinboundrequeststart.md
new file mode 100644
index 00000000000..04a40fe0f57
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3408-httppipelinebeginprocessinboundrequeststart.md
@@ -0,0 +1,35 @@
+---
+title: "3408 - HttpPipelineBeginProcessInboundRequestStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7ca229e2-93bb-4993-807c-9ad5d4ab5092
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3408 - HttpPipelineBeginProcessInboundRequestStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3408|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが受信要求の非同期処理を開始したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、受信要求の非同期処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3409-httppipelineprocessinboundrequeststop.md b/docs/framework/wcf/diagnostics/etw/3409-httppipelineprocessinboundrequeststop.md
new file mode 100644
index 00000000000..9ee5381d58b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3409-httppipelineprocessinboundrequeststop.md
@@ -0,0 +1,35 @@
+---
+title: "3409 - HttpPipelineProcessInboundRequestStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f20271f-a30b-456c-a416-73329921c6d3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3409 - HttpPipelineProcessInboundRequestStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3409|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが受信要求の処理を完了したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、受信要求の処理を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3410-httppipelinefaulted.md b/docs/framework/wcf/diagnostics/etw/3410-httppipelinefaulted.md
new file mode 100644
index 00000000000..5e782b5eb13
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3410-httppipelinefaulted.md
@@ -0,0 +1,35 @@
+---
+title: "3410 - HttpPipelineFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8586c3c1-3da5-4f5b-b637-4671b14fb65e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3410 - HttpPipelineFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3410|  
+|キーワード|HTTP|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP メッセージ ハンドラーに障害が発生したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーに障害があります。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3411-httppipelinetimeoutexception.md b/docs/framework/wcf/diagnostics/etw/3411-httppipelinetimeoutexception.md
new file mode 100644
index 00000000000..be810ce787c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3411-httppipelinetimeoutexception.md
@@ -0,0 +1,35 @@
+---
+title: "3411 - HttpPipelineTimeoutException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f10a482-9e8f-4726-bdc8-b18a32e4dfdc
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3411 - HttpPipelineTimeoutException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3411|  
+|キーワード|HTTP|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WebSocket 接続がタイムアウトしたときに生成されます。  
+  
+## メッセージ  
+ WebSocket の接続がタイムアウトしました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3412-httppipelineprocessresponsestart.md b/docs/framework/wcf/diagnostics/etw/3412-httppipelineprocessresponsestart.md
new file mode 100644
index 00000000000..e3e8667f751
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3412-httppipelineprocessresponsestart.md
@@ -0,0 +1,35 @@
+---
+title: "3412 - HttpPipelineProcessResponseStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4704eef-609f-45a1-8e15-ec94e9549789
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3412 - HttpPipelineProcessResponseStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3412|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが応答の処理を開始したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、応答の処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3413-httppipelinebeginprocessresponsestart.md b/docs/framework/wcf/diagnostics/etw/3413-httppipelinebeginprocessresponsestart.md
new file mode 100644
index 00000000000..2a5190e952d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3413-httppipelinebeginprocessresponsestart.md
@@ -0,0 +1,35 @@
+---
+title: "3413 - HttpPipelineBeginProcessResponseStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85c4d51b-f5b0-4bf4-86ce-6296115dc120
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3413 - HttpPipelineBeginProcessResponseStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3413|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが応答の非同期処理を開始したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、応答の非同期処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3414-httppipelineprocessresponsestop.md b/docs/framework/wcf/diagnostics/etw/3414-httppipelineprocessresponsestop.md
new file mode 100644
index 00000000000..731b56b781e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3414-httppipelineprocessresponsestop.md
@@ -0,0 +1,35 @@
+---
+title: "3414 - HttpPipelineProcessResponseStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 71ebd2ee-aedd-47ef-9a2b-00f778f7e225
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3414 - HttpPipelineProcessResponseStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3414|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、http メッセージ ハンドラーが応答の処理を完了したときに生成されます。  
+  
+## メッセージ  
+ http メッセージ ハンドラーは、応答の処理を完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3415-websocketconnectionrequestsendstart.md b/docs/framework/wcf/diagnostics/etw/3415-websocketconnectionrequestsendstart.md
new file mode 100644
index 00000000000..9f05174e1d1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3415-websocketconnectionrequestsendstart.md
@@ -0,0 +1,35 @@
+---
+title: "3415 - WebSocketConnectionRequestSendStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2fdf39ec-3aad-45bf-ba80-759e6e10fe37
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3415 - WebSocketConnectionRequestSendStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3415|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 接続要求の送信が開始したときに生成されます。  
+  
+## メッセージ  
+ '%1' への WebSocket 接続要求の送信を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3416-websocketconnectionrequestsendstop.md b/docs/framework/wcf/diagnostics/etw/3416-websocketconnectionrequestsendstop.md
new file mode 100644
index 00000000000..a4700685916
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3416-websocketconnectionrequestsendstop.md
@@ -0,0 +1,35 @@
+---
+title: "3416 - WebSocketConnectionRequestSendStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2288f390-9263-4acf-b0ef-b0cab82bbec1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3416 - WebSocketConnectionRequestSendStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3416|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 接続要求の送信が停止したときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 の接続要求を送信しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3417-websocketconnectionacceptstart.md b/docs/framework/wcf/diagnostics/etw/3417-websocketconnectionacceptstart.md
new file mode 100644
index 00000000000..66f4a2e8f75
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3417-websocketconnectionacceptstart.md
@@ -0,0 +1,35 @@
+---
+title: "3417 - WebSocketConnectionAcceptStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d595fe3-2276-4d77-85c8-b6a966199c5b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3417 - WebSocketConnectionAcceptStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3417|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 接続の受け入れが開始されたときに生成されます。  
+  
+## メッセージ  
+ WebSocket 接続の受け入れを開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3418-websocketconnectionaccepted.md b/docs/framework/wcf/diagnostics/etw/3418-websocketconnectionaccepted.md
new file mode 100644
index 00000000000..c0a50bd0771
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3418-websocketconnectionaccepted.md
@@ -0,0 +1,35 @@
+---
+title: "3418 - WebSocketConnectionAccepted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 684a1806-27a4-4ac8-87d4-9089d55def13
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3418 - WebSocketConnectionAccepted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3418|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 接続が受け入れられたときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 の接続を受け入れました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3419-websocketconnectiondeclined.md b/docs/framework/wcf/diagnostics/etw/3419-websocketconnectiondeclined.md
new file mode 100644
index 00000000000..0a1ea76f8ef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3419-websocketconnectiondeclined.md
@@ -0,0 +1,35 @@
+---
+title: "3419 - WebSocketConnectionDeclined | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d1d27f33-7d59-40c7-b464-6cd1f13b7c72
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3419 - WebSocketConnectionDeclined
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3419|  
+|キーワード|HTTP|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WebSocket 接続が拒否されたときに生成されます。  
+  
+## メッセージ  
+ WebSocket 接続が状態コード '%1' で拒否されました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3420-websocketconnectionfailed.md b/docs/framework/wcf/diagnostics/etw/3420-websocketconnectionfailed.md
new file mode 100644
index 00000000000..c497cc704f0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3420-websocketconnectionfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3420 - WebSocketConnectionFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b5ed1ce-ba57-473c-bc64-fd52646ed3a6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3420 - WebSocketConnectionFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3420|  
+|キーワード|HTTP|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WebSocket 接続要求に失敗したときに生成されます。  
+  
+## メッセージ  
+ WebSocket 接続要求が失敗しました: '%1'  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3421-websocketconnectionaborted.md b/docs/framework/wcf/diagnostics/etw/3421-websocketconnectionaborted.md
new file mode 100644
index 00000000000..6e8a25edd5a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3421-websocketconnectionaborted.md
@@ -0,0 +1,35 @@
+---
+title: "3421 - WebSocketConnectionAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ca325f5-7a06-4719-a236-72767a8e0530
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3421 - WebSocketConnectionAborted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3421|  
+|キーワード|HTTP|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WebSocket 接続が中止されときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 の接続が中止されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3422-websocketasyncwritestart.md b/docs/framework/wcf/diagnostics/etw/3422-websocketasyncwritestart.md
new file mode 100644
index 00000000000..98b24b9d0b2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3422-websocketasyncwritestart.md
@@ -0,0 +1,35 @@
+---
+title: "3422 - WebSocketAsyncWriteStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d0c7ab4-9044-464b-b2dc-0b5e59a773aa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3422 - WebSocketAsyncWriteStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3422|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 非同期書き込みが開始されたときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が '%3' に '%2' バイトを書き込んでいます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3423-websocketasyncwritestop.md b/docs/framework/wcf/diagnostics/etw/3423-websocketasyncwritestop.md
new file mode 100644
index 00000000000..efb63dbc597
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3423-websocketasyncwritestop.md
@@ -0,0 +1,35 @@
+---
+title: "3423 - WebSocketAsyncWriteStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2074414-abad-4643-ba38-f94b331def93
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3423 - WebSocketAsyncWriteStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3423|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket の非同期書き込みが停止されたときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が非同期書き込みを停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3424-websocketasyncreadstart.md b/docs/framework/wcf/diagnostics/etw/3424-websocketasyncreadstart.md
new file mode 100644
index 00000000000..8d7f71d4c9e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3424-websocketasyncreadstart.md
@@ -0,0 +1,35 @@
+---
+title: "3424 - WebSocketAsyncReadStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fdcbca02-163d-4dd3-aa40-9fd9a149eb10
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3424 - WebSocketAsyncReadStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3424|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 非同期読み取りが開始されたときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が読み取りを開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3425-websocketasyncreadstop.md b/docs/framework/wcf/diagnostics/etw/3425-websocketasyncreadstop.md
new file mode 100644
index 00000000000..769bd1784d2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3425-websocketasyncreadstop.md
@@ -0,0 +1,35 @@
+---
+title: "3425 - WebSocketAsyncReadStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d86fd8f-d430-45c0-94ee-827f4fa5881a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3425 - WebSocketAsyncReadStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3425|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket 非同期読み取りが停止したときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が '%3' から '%2' バイトを読み取りました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3426-websocketclosesent.md b/docs/framework/wcf/diagnostics/etw/3426-websocketclosesent.md
new file mode 100644
index 00000000000..546e9ebb794
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3426-websocketclosesent.md
@@ -0,0 +1,35 @@
+---
+title: "3426 - WebSocketCloseSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2eedb6bb-c114-40bb-9b24-e5f00723a24a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3426 - WebSocketCloseSent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3426|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket の終了が送信されると生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が、終了ステータス '%3' の終了メッセージを '%2' に送信しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3427-websocketcloseoutputsent.md b/docs/framework/wcf/diagnostics/etw/3427-websocketcloseoutputsent.md
new file mode 100644
index 00000000000..325b0bed97b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3427-websocketcloseoutputsent.md
@@ -0,0 +1,35 @@
+---
+title: "3427 - WebSocketCloseOutputSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c9de20d8-9f53-432d-8100-c05387441f65
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3427 - WebSocketCloseOutputSent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3427|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket の終了出力が送信されたときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が、終了ステータス '%3' の終了出力メッセージを '%2' に送信しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3428-websocketconnectionclosed.md b/docs/framework/wcf/diagnostics/etw/3428-websocketconnectionclosed.md
new file mode 100644
index 00000000000..b42bd398d96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3428-websocketconnectionclosed.md
@@ -0,0 +1,35 @@
+---
+title: "3428 - WebSocketConnectionClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb16c9da-37b3-4cbd-800e-0d1691eb0bb2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3428 - WebSocketConnectionClosed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3428|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket の接続が終了したときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 の接続を終了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3429-websocketclosestatusreceived.md b/docs/framework/wcf/diagnostics/etw/3429-websocketclosestatusreceived.md
new file mode 100644
index 00000000000..b4336ea709c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3429-websocketclosestatusreceived.md
@@ -0,0 +1,35 @@
+---
+title: "3429 - WebSocketCloseStatusReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b4f16083-cb55-4215-af12-478d5e70301e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3429 - WebSocketCloseStatusReceived
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3429|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebSocket の終了ステータスを受信したときに生成されます。  
+  
+## メッセージ  
+ WebSocketId:%1 が、状態 '%2' の接続終了メッセージを受信しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3430-websocketuseversionfromclientwebsocketfactory.md b/docs/framework/wcf/diagnostics/etw/3430-websocketuseversionfromclientwebsocketfactory.md
new file mode 100644
index 00000000000..30367a3857e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3430-websocketuseversionfromclientwebsocketfactory.md
@@ -0,0 +1,35 @@
+---
+title: "3430 - WebSocketUseVersionFromClientWebSocketFactory | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb04adb2-e629-4ae7-b3a6-5512f3927cb2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3430 - WebSocketUseVersionFromClientWebSocketFactory
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3430|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアント WebSocket ファクトリから WebSocketVersion を使用しているときに生成されます。  
+  
+## メッセージ  
+ 型 '%1' のクライアント WebSocket ファクトリから WebSocketVersion を使用しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3431-websocketcreateclientwebsocketwithfactory.md b/docs/framework/wcf/diagnostics/etw/3431-websocketcreateclientwebsocketwithfactory.md
new file mode 100644
index 00000000000..30c3631ca5b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3431-websocketcreateclientwebsocketwithfactory.md
@@ -0,0 +1,35 @@
+---
+title: "3431 - WebSocketCreateClientWebSocketWithFactory | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8311f19c-970f-436a-b985-0dc8bcac85c0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3431 - WebSocketCreateClientWebSocketWithFactory
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3431|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、クライアント WebSocket が作成されるときに生成されます。  
+  
+## メッセージ  
+ 型 '%1' のファクトリでクライアント WebSocket を作成しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3553-xamlservicesloadstart.md b/docs/framework/wcf/diagnostics/etw/3553-xamlservicesloadstart.md
new file mode 100644
index 00000000000..ba87b034e23
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3553-xamlservicesloadstart.md
@@ -0,0 +1,35 @@
+---
+title: "3553 - XamlServicesLoadStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23b6e14a-019f-48fc-b2d5-aaa3dc88d79a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3553 - XamlServicesLoadStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3553|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは XamlServicesLoad が開始されると生成されます。  
+  
+## メッセージ  
+ XamlServicesLoad が開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3554-xamlservicesloadstop.md b/docs/framework/wcf/diagnostics/etw/3554-xamlservicesloadstop.md
new file mode 100644
index 00000000000..bc29707fa0d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3554-xamlservicesloadstop.md
@@ -0,0 +1,35 @@
+---
+title: "3554 - XamlServicesLoadStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d3a3bd9-fdaf-4c57-bede-e8392b077c99
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3554 - XamlServicesLoadStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3554|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは XamlServicesLoad が停止されると生成されます。  
+  
+## メッセージ  
+ XamlServicesLoad が停止します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3555-createworkflowservicehoststart.md b/docs/framework/wcf/diagnostics/etw/3555-createworkflowservicehoststart.md
new file mode 100644
index 00000000000..1a9e094cb0d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3555-createworkflowservicehoststart.md
@@ -0,0 +1,35 @@
+---
+title: "3555 - CreateWorkflowServiceHostStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14038438-774f-4651-b83e-c149da688a1b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3555 - CreateWorkflowServiceHostStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3555|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CreateWorkflowServiceHost が開始すると生成されます。  
+  
+## メッセージ  
+ CreateWorkflowServiceHost が開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3556-createworkflowservicehoststop.md b/docs/framework/wcf/diagnostics/etw/3556-createworkflowservicehoststop.md
new file mode 100644
index 00000000000..d127d597384
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3556-createworkflowservicehoststop.md
@@ -0,0 +1,35 @@
+---
+title: "3556 - CreateWorkflowServiceHostStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bac6387b-1096-4e17-9907-8e464ee780db
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3556 - CreateWorkflowServiceHostStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3556|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CreateWorkflowServiceHost が停止すると生成されます。  
+  
+## メッセージ  
+ CreateWorkflowServiceHost が停止します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3558-serviceactivationstart.md b/docs/framework/wcf/diagnostics/etw/3558-serviceactivationstart.md
new file mode 100644
index 00000000000..d8a1fb00917
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3558-serviceactivationstart.md
@@ -0,0 +1,35 @@
+---
+title: "3558 - ServiceActivationStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9062c6f4-2252-460c-ad29-f8effa72fcd1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3558 - ServiceActivationStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3558|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービスのアクティブ化を開始すると生成されます。  
+  
+## メッセージ  
+ サービスのアクティブ化を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3559-serviceactivationstop.md b/docs/framework/wcf/diagnostics/etw/3559-serviceactivationstop.md
new file mode 100644
index 00000000000..d975c613aff
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3559-serviceactivationstop.md
@@ -0,0 +1,35 @@
+---
+title: "3559 - ServiceActivationStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57aa18b4-6512-4f1a-a4e3-71f58a867ed2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3559 - ServiceActivationStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3559|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービスのアクティブ化を停止すると生成されます。  
+  
+## メッセージ  
+ サービスのアクティブ化を停止します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3560-serviceactivationavailablememory.md b/docs/framework/wcf/diagnostics/etw/3560-serviceactivationavailablememory.md
new file mode 100644
index 00000000000..303141fd2c5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3560-serviceactivationavailablememory.md
@@ -0,0 +1,35 @@
+---
+title: "3560 - ServiceActivationAvailableMemory | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9360acf-53e6-422f-bacf-12918088c824
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3560 - ServiceActivationAvailableMemory
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3560|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービスのアクティブ化に使用できるメモリ サイズを取得するために生成されます。  
+  
+## メッセージ  
+ 使用可能なメモリ \(バイト\): %1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3800-routingserviceclosingclient.md b/docs/framework/wcf/diagnostics/etw/3800-routingserviceclosingclient.md
new file mode 100644
index 00000000000..cf7623284a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3800-routingserviceclosingclient.md
@@ -0,0 +1,35 @@
+---
+title: "3800 - RoutingServiceClosingClient | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0baf214b-fa19-4871-a314-735c5939f92c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3800 - RoutingServiceClosingClient
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3800|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがクライアントを終了しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスがクライアント '%1' を終了しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3801-routingservicechannelfaulted.md b/docs/framework/wcf/diagnostics/etw/3801-routingservicechannelfaulted.md
new file mode 100644
index 00000000000..1fdbe02e95a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3801-routingservicechannelfaulted.md
@@ -0,0 +1,35 @@
+---
+title: "3801 - RoutingServiceChannelFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 06cd2a1a-ee5f-4f44-900c-15b5bb6e302b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3801 - RoutingServiceChannelFaulted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3801|  
+|キーワード|RoutingServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービス クライアントが失敗したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスのクライアント '%1' が途中終了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3802-routingservicecompletingoneway.md b/docs/framework/wcf/diagnostics/etw/3802-routingservicecompletingoneway.md
new file mode 100644
index 00000000000..cae343673de
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3802-routingservicecompletingoneway.md
@@ -0,0 +1,35 @@
+---
+title: "3802 - RoutingServiceCompletingOneWay | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 34bfe6c6-b6d0-4b38-854f-4ad245e90e15
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3802 - RoutingServiceCompletingOneWay
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3802|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスの一方向メッセージを完了するときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスの一方向メッセージを完了しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3803-routingserviceprocessingfailure.md b/docs/framework/wcf/diagnostics/etw/3803-routingserviceprocessingfailure.md
new file mode 100644
index 00000000000..f4e7a4bd238
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3803-routingserviceprocessingfailure.md
@@ -0,0 +1,35 @@
+---
+title: "3803 - RoutingServiceProcessingFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d01aa0d-b456-49c0-8255-1040e2e66a57
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3803 - RoutingServiceProcessingFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3803|  
+|キーワード|RoutingServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンドポイントでのメッセージの処理中にルーティング サービスでエラーが発生したときに生成されます。  
+  
+## メッセージ  
+ アドレス '%1' のエンドポイントでメッセージを処理しているときにルーティング サービスでエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3804-routingservicecreatingclientforendpoint.md b/docs/framework/wcf/diagnostics/etw/3804-routingservicecreatingclientforendpoint.md
new file mode 100644
index 00000000000..42c6100fbf4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3804-routingservicecreatingclientforendpoint.md
@@ -0,0 +1,35 @@
+---
+title: "3804 - RoutingServiceCreatingClientForEndpoint | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f53304b0-1201-4fff-94ed-d054774871c7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3804 - RoutingServiceCreatingClientForEndpoint
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3804|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがエンドポイントのクライアントを作成しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、エンドポイント: '%1' のクライアントを作成しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3805-routingservicedisplayconfig.md b/docs/framework/wcf/diagnostics/etw/3805-routingservicedisplayconfig.md
new file mode 100644
index 00000000000..4694c6ecb9a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3805-routingservicedisplayconfig.md
@@ -0,0 +1,35 @@
+---
+title: "3805 - RoutingServiceDisplayConfig | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae58c16e-25e1-4a64-8e8c-3d0006cff0f8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3805 - RoutingServiceDisplayConfig
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3805|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスが RouteOnHeadersOnly に構成されると生成されます。  
+  
+## メッセージ  
+ ルーティング サービスは、RouteOnHeadersOnly: %1、SoapProcessingEnabled: %2、EnsureOrderedDispatch: %3 に構成されています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3807-routingservicecompletingtwoway.md b/docs/framework/wcf/diagnostics/etw/3807-routingservicecompletingtwoway.md
new file mode 100644
index 00000000000..6bf5cf01d59
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3807-routingservicecompletingtwoway.md
@@ -0,0 +1,35 @@
+---
+title: "3807 - RoutingServiceCompletingTwoWay | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9bcc3b48-1b84-4fb0-89b2-c54e45304007
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3807 - RoutingServiceCompletingTwoWay
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3807|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスの要求応答メッセージを完了しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスの要求応答メッセージを完了しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3809-routingservicemessageroutedtoendpoints.md b/docs/framework/wcf/diagnostics/etw/3809-routingservicemessageroutedtoendpoints.md
new file mode 100644
index 00000000000..16842b4292b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3809-routingservicemessageroutedtoendpoints.md
@@ -0,0 +1,35 @@
+---
+title: "3809 - RoutingServiceMessageRoutedToEndpoints | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22479cc6-72d1-48df-912c-fc37bddeb043
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3809 - RoutingServiceMessageRoutedToEndpoints
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3809|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがエンドポイントにルーティングされたときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスにより、ID: '%1' のメッセージが %2 エンドポイント リストにルーティングされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3810-routingserviceconfigurationapplied.md b/docs/framework/wcf/diagnostics/etw/3810-routingserviceconfigurationapplied.md
new file mode 100644
index 00000000000..5ea95a1f6e7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3810-routingserviceconfigurationapplied.md
@@ -0,0 +1,35 @@
+---
+title: "3810 - RoutingServiceConfigurationApplied | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bef4b66-6a63-4f42-8396-6e21510fa4fb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3810 - RoutingServiceConfigurationApplied
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3810|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング構成がルーティング サービスに適用されると生成されます。  
+  
+## メッセージ  
+ 新しい RoutingConfiguration がルーティング サービスに適用されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3815-routingserviceprocessingmessage.md b/docs/framework/wcf/diagnostics/etw/3815-routingserviceprocessingmessage.md
new file mode 100644
index 00000000000..cf1070c79fa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3815-routingserviceprocessingmessage.md
@@ -0,0 +1,35 @@
+---
+title: "3815 - RoutingServiceProcessingMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c632b4a6-31f2-4f81-a484-02eb340ae951
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3815 - RoutingServiceProcessingMessage
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3815|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがメッセージを処理しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、トランザクション: %4 で受信された ID: '%1'、アクション: '%2'、着信 URL: '%3' のメッセージを処理しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3816-routingservicetransmittingmessage.md b/docs/framework/wcf/diagnostics/etw/3816-routingservicetransmittingmessage.md
new file mode 100644
index 00000000000..864e72cd6ce
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3816-routingservicetransmittingmessage.md
@@ -0,0 +1,35 @@
+---
+title: "3816 - RoutingServiceTransmittingMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7ee6e3b-4a02-47bd-b004-46abb6dd820e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3816 - RoutingServiceTransmittingMessage
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3816|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがメッセージを転送しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、ID: '%1' \[operation %2\] のメッセージを '%3' に転送しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3817-routingservicecommittingtransaction.md b/docs/framework/wcf/diagnostics/etw/3817-routingservicecommittingtransaction.md
new file mode 100644
index 00000000000..b838c397061
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3817-routingservicecommittingtransaction.md
@@ -0,0 +1,35 @@
+---
+title: "3817 - RoutingServiceCommittingTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85d71995-3a19-4955-81ba-3e72fe4c5b32
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3817 - RoutingServiceCommittingTransaction
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3817|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがメッセージをコミットしているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、ID: '%1' のトランザクションをコミットしています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3818-routingserviceduplexcallbackexception.md b/docs/framework/wcf/diagnostics/etw/3818-routingserviceduplexcallbackexception.md
new file mode 100644
index 00000000000..8ef034c68d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3818-routingserviceduplexcallbackexception.md
@@ -0,0 +1,35 @@
+---
+title: "3818 - RoutingServiceDuplexCallbackException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aafc3932-5a52-4b99-89ca-09341ac4d39b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3818 - RoutingServiceDuplexCallbackException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3818|  
+|キーワード|RoutingServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスで二重コールバックの例外が発生したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスのコンポーネント %1 で二重コールバックの例外が発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3819-routingservicemovedtobackup.md b/docs/framework/wcf/diagnostics/etw/3819-routingservicemovedtobackup.md
new file mode 100644
index 00000000000..d66eb4012e7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3819-routingservicemovedtobackup.md
@@ -0,0 +1,35 @@
+---
+title: "3819 - RoutingServiceMovedToBackup | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf4086de-efd4-413c-9bc3-32a85b6b6722
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3819 - RoutingServiceMovedToBackup
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3819|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがバックアップ エンドポイントに移動されたときに生成されます。  
+  
+## メッセージ  
+ ID: '%1' \[operation %2\] のルーティング サービス メッセージがバックアップ エンドポイント '%3' に移動されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3820-routingservicecreatingtransaction.md b/docs/framework/wcf/diagnostics/etw/3820-routingservicecreatingtransaction.md
new file mode 100644
index 00000000000..237cd2f348a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3820-routingservicecreatingtransaction.md
@@ -0,0 +1,35 @@
+---
+title: "3820 - RoutingServiceCreatingTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11b15ba8-7d62-4235-8efd-bc6b60218247
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3820 - RoutingServiceCreatingTransaction
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3820|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがメッセージを処理するために新しいトランザクションを作成したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、メッセージを処理するために ID '%1' の新しいトランザクションを作成しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3821-routingserviceclosefailed.md b/docs/framework/wcf/diagnostics/etw/3821-routingserviceclosefailed.md
new file mode 100644
index 00000000000..bd74b047322
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3821-routingserviceclosefailed.md
@@ -0,0 +1,35 @@
+---
+title: "3821 - RoutingServiceCloseFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 584cc4d0-6c9e-4dce-b1d1-5bcc9a41011b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3821 - RoutingServiceCloseFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3821|  
+|キーワード|RoutingServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、発信クライアントを終了しているときにルーティング サービスでエラーが発生すると生成されます。  
+  
+## メッセージ  
+ 発信クライアント '%1' を終了しているときにルーティング サービスでエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3822-routingservicesendingresponse.md b/docs/framework/wcf/diagnostics/etw/3822-routingservicesendingresponse.md
new file mode 100644
index 00000000000..9f14e64fb31
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3822-routingservicesendingresponse.md
@@ -0,0 +1,35 @@
+---
+title: "3822 - RoutingServiceSendingResponse | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 46965a31-eab0-4141-843d-800ccc0a6a7e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3822 - RoutingServiceSendingResponse
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3822|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスが応答メッセージを返送しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、Action '%1' を含む応答メッセージを返送しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3823-routingservicesendingfaultresponse.md b/docs/framework/wcf/diagnostics/etw/3823-routingservicesendingfaultresponse.md
new file mode 100644
index 00000000000..b21c7d1d58b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3823-routingservicesendingfaultresponse.md
@@ -0,0 +1,35 @@
+---
+title: "3823 - RoutingServiceSendingFaultResponse | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 843cbce6-f2df-4067-aaf2-394b65034282
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3823 - RoutingServiceSendingFaultResponse
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3823|  
+|キーワード|RoutingServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスがエラー応答メッセージを返送しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、Action '%1' を含むエラー応答メッセージを返送しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3824-routingservicecompletingreceivecontext.md b/docs/framework/wcf/diagnostics/etw/3824-routingservicecompletingreceivecontext.md
new file mode 100644
index 00000000000..5f169ca7aec
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3824-routingservicecompletingreceivecontext.md
@@ -0,0 +1,35 @@
+---
+title: "3824 - RoutingServiceCompletingReceiveContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b716f0a1-c2ce-4e7c-b2d6-405a488c6591
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3824 - RoutingServiceCompletingReceiveContext
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3824|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、指定した ID のメッセージに対してルーティング サービスが ReceiveContext.Complete を呼び出しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、ID: '%1' のメッセージに対して ReceiveContext.Complete を呼び出しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3825-routingserviceabandoningreceivecontext.md b/docs/framework/wcf/diagnostics/etw/3825-routingserviceabandoningreceivecontext.md
new file mode 100644
index 00000000000..bf6300a9e70
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3825-routingserviceabandoningreceivecontext.md
@@ -0,0 +1,35 @@
+---
+title: "3825 - RoutingServiceAbandoningReceiveContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3e16528e-d340-4245-89b2-f8ac16621e94
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3825 - RoutingServiceAbandoningReceiveContext
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3825|  
+|キーワード|RoutingServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、指定した ID を持つメッセージに対してルーティング サービスが ReceiveContext.Abandon を呼び出しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、ID: '%1' のメッセージに対して ReceiveContext.Abandon を呼び出しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3826-routingserviceusingexistingtransaction.md b/docs/framework/wcf/diagnostics/etw/3826-routingserviceusingexistingtransaction.md
new file mode 100644
index 00000000000..c42b889f497
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3826-routingserviceusingexistingtransaction.md
@@ -0,0 +1,35 @@
+---
+title: "3826 - RoutingServiceUsingExistingTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e73b2492-10e9-418e-bdf3-a2605d046acb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3826 - RoutingServiceUsingExistingTransaction
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3826|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスが既存のトランザクションを使用してメッセージを送信するときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスは、既存のトランザクション '%1' を使用してメッセージを送信します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3827-routingservicetransmitfailed.md b/docs/framework/wcf/diagnostics/etw/3827-routingservicetransmitfailed.md
new file mode 100644
index 00000000000..e0adb626a86
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3827-routingservicetransmitfailed.md
@@ -0,0 +1,35 @@
+---
+title: "3827 - RoutingServiceTransmitFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 92e94472-e91e-4c9c-81b1-b5bb11655c04
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3827 - RoutingServiceTransmitFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3827|  
+|キーワード|RoutingServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスの送信が失敗したときに生成されます。  
+  
+## メッセージ  
+ '%1' への送信中にルーティング サービスでエラーが発生しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3828-routingservicefiltertablematchstart.md b/docs/framework/wcf/diagnostics/etw/3828-routingservicefiltertablematchstart.md
new file mode 100644
index 00000000000..73797d9cfaf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3828-routingservicefiltertablematchstart.md
@@ -0,0 +1,35 @@
+---
+title: "3828 - RoutingServiceFilterTableMatchStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 883b1215-6e24-49c6-9816-22e2e57a1264
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3828 - RoutingServiceFilterTableMatchStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3828|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ルーティング サービス MessageFilterTable の照合が開始されたときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービス MessageFilterTable の照合が開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3829-routingservicefiltertablematchstop.md b/docs/framework/wcf/diagnostics/etw/3829-routingservicefiltertablematchstop.md
new file mode 100644
index 00000000000..a855aeab101
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3829-routingservicefiltertablematchstop.md
@@ -0,0 +1,35 @@
+---
+title: "3829 - RoutingServiceFilterTableMatchStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3355b8c2-2d5b-4c1b-8981-0cda08dee519
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3829 - RoutingServiceFilterTableMatchStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3829|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ルーティング サービス MessageFilterTable の照合が停止したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービス MessageFilterTable の照合が停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3830-routingserviceabortingchannel.md b/docs/framework/wcf/diagnostics/etw/3830-routingserviceabortingchannel.md
new file mode 100644
index 00000000000..b1438a8af6e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3830-routingserviceabortingchannel.md
@@ -0,0 +1,35 @@
+---
+title: "3830 - RoutingServiceAbortingChannel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fba86ec8-4360-43e5-be54-cce43270af21
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3830 - RoutingServiceAbortingChannel
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3830|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、指定されたチャネルでルーティング サービスが中止を呼び出しているときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスがチャネル '%1' で中止を呼び出しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3831-routingservicehandledexception.md b/docs/framework/wcf/diagnostics/etw/3831-routingservicehandledexception.md
new file mode 100644
index 00000000000..f24d5ca9213
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3831-routingservicehandledexception.md
@@ -0,0 +1,35 @@
+---
+title: "3831 - RoutingServiceHandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dd7351e4-3adb-4d53-9329-c88e968633af
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3831 - RoutingServiceHandledException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3831|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスが例外を処理したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが例外を処理しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/3832-routingservicetransmitsucceeded.md b/docs/framework/wcf/diagnostics/etw/3832-routingservicetransmitsucceeded.md
new file mode 100644
index 00000000000..209c4c8c400
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/3832-routingservicetransmitsucceeded.md
@@ -0,0 +1,35 @@
+---
+title: "3832 - RoutingServiceTransmitSucceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72e0c6b0-7ed2-4a48-aaa0-d5a761a9a469
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3832 - RoutingServiceTransmitSucceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3832|  
+|キーワード|RoutingServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング サービスが指定された ID を持つメッセージを正常に送信したときに生成されます。  
+  
+## メッセージ  
+ ルーティング サービスが、ID: '%1 \[operation %2\] のメッセージを '%3' に正常に送信しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4001-transportlistenersessionsreceived.md b/docs/framework/wcf/diagnostics/etw/4001-transportlistenersessionsreceived.md
new file mode 100644
index 00000000000..7c1e67a84a8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4001-transportlistenersessionsreceived.md
@@ -0,0 +1,35 @@
+---
+title: "4001 - TransportListenerSessionsReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2c7bb92-f02d-4947-98fd-247b0a55d814
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4001 - TransportListenerSessionsReceived
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4001|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、トランスポート リスナー セッションの受信時に生成されます。  
+  
+## メッセージ  
+ '%1' でトランスポート リスナー セッションを受信しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4002-failfastexception.md b/docs/framework/wcf/diagnostics/etw/4002-failfastexception.md
new file mode 100644
index 00000000000..7c7466f92ef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4002-failfastexception.md
@@ -0,0 +1,35 @@
+---
+title: "4002 - FailFastException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b84fe87-916c-4923-bf49-9b6bf391fa34
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4002 - FailFastException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4002|  
+|キーワード|ActivationServices|  
+|レベル|重大|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは FailFastException 時に生成されます。  
+  
+## メッセージ  
+ FailFastException。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4003-servicestartpipeerror.md b/docs/framework/wcf/diagnostics/etw/4003-servicestartpipeerror.md
new file mode 100644
index 00000000000..63d5fdd6dd3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4003-servicestartpipeerror.md
@@ -0,0 +1,35 @@
+---
+title: "4003 - ServiceStartPipeError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6001510b-49b1-40b3-9173-de1f0031a8e7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4003 - ServiceStartPipeError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4003|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、サービス開始パイプ エラーが発生すると生成されます。  
+  
+## メッセージ  
+ サービス開始パイプ エラー。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4008-dispatchsessionstart.md b/docs/framework/wcf/diagnostics/etw/4008-dispatchsessionstart.md
new file mode 100644
index 00000000000..165d53b54b2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4008-dispatchsessionstart.md
@@ -0,0 +1,35 @@
+---
+title: "4008 - DispatchSessionStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 488c78a7-aee0-4754-98d5-44afa838fed7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4008 - DispatchSessionStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4008|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セッション ディスパッチが開始されたときに生成されます。  
+  
+## メッセージ  
+ セッション ディスパッチを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/401-stopsignpostevent.md b/docs/framework/wcf/diagnostics/etw/401-stopsignpostevent.md
new file mode 100644
index 00000000000..69912ff6a59
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/401-stopsignpostevent.md
@@ -0,0 +1,40 @@
+---
+title: "401- StopSignPostEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e033d03a-510d-4300-aa65-ef02cb4807f2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 401- StopSignPostEvent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|401|  
+|キーワード|トラブルシューティング|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、エンド ツー エンド アクティビティの終了を示します。  ここにはアクティビティの名前が指定されています。  
+  
+## メッセージ  
+ アクティビティの境界  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Extended Data|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4010-pendingsessionqueuefull.md b/docs/framework/wcf/diagnostics/etw/4010-pendingsessionqueuefull.md
new file mode 100644
index 00000000000..160640ba78a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4010-pendingsessionqueuefull.md
@@ -0,0 +1,35 @@
+---
+title: "4010 - PendingSessionQueueFull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14696793-16eb-4847-a530-fa2f90f682c9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4010 - PendingSessionQueueFull
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4010|  
+|キーワード|ActivationServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、保留中のセッションのキューがいっぱいであるためにセッション ディスパッチが失敗すると生成されます。  
+  
+## メッセージ  
+ '%1' のセッション ディスパッチに失敗しました。保留セッション キューがいっぱいです。保留中の項目が '%2' 個あります。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4011-messagequeueregisterstart.md b/docs/framework/wcf/diagnostics/etw/4011-messagequeueregisterstart.md
new file mode 100644
index 00000000000..048e4abd633
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4011-messagequeueregisterstart.md
@@ -0,0 +1,35 @@
+---
+title: "4011 - MessageQueueRegisterStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab806605-810a-406e-981e-38e25c66ac6f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4011 - MessageQueueRegisterStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4011|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューの登録の開始時に生成されます。  
+  
+## メッセージ  
+ メッセージ キューの登録を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4012-messagequeueregisterabort.md b/docs/framework/wcf/diagnostics/etw/4012-messagequeueregisterabort.md
new file mode 100644
index 00000000000..012ea961934
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4012-messagequeueregisterabort.md
@@ -0,0 +1,35 @@
+---
+title: "4012 - MessageQueueRegisterAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b992f9ee-bae5-4bad-99ad-e141e2f0b036
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4012 - MessageQueueRegisterAbort
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4012|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューの登録が中止されたときに生成されます。  
+  
+## メッセージ  
+ URI:'%2' のメッセージ キューの登録が状態:'%1' で中止されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4013-messagequeueunregistersucceeded.md b/docs/framework/wcf/diagnostics/etw/4013-messagequeueunregistersucceeded.md
new file mode 100644
index 00000000000..0f164f78fd9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4013-messagequeueunregistersucceeded.md
@@ -0,0 +1,35 @@
+---
+title: "4013 - MessageQueueUnregisterSucceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16ed96c1-9f8d-4f08-b57c-5cba3b88b475
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4013 - MessageQueueUnregisterSucceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4013|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューの登録解除が成功すると生成されます。  
+  
+## メッセージ  
+ URI:'%1' のメッセージ キューの登録解除に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4014-messagequeueregisterfailed.md b/docs/framework/wcf/diagnostics/etw/4014-messagequeueregisterfailed.md
new file mode 100644
index 00000000000..bce9cf99655
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4014-messagequeueregisterfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4014 - MessageQueueRegisterFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8aa80ea-e251-4b54-ade7-bfbd6670a6ef
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4014 - MessageQueueRegisterFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4014|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューの登録が失敗したときに生成されます。  
+  
+## メッセージ  
+ URI:'%1' のメッセージ キューの登録が状態:'%2' で失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4015-messagequeueregistercompleted.md b/docs/framework/wcf/diagnostics/etw/4015-messagequeueregistercompleted.md
new file mode 100644
index 00000000000..01645a6af9b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4015-messagequeueregistercompleted.md
@@ -0,0 +1,35 @@
+---
+title: "4015 - MessageQueueRegisterCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8d65570-9dcc-436c-b446-a33404e31652
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4015 - MessageQueueRegisterCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4015|  
+|キーワード|ActivationServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューの登録が完了したときに生成されます。  
+  
+## メッセージ  
+ URI '%1' のメッセージ キューの登録が完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4016-messagequeueduplicatedsocketerror.md b/docs/framework/wcf/diagnostics/etw/4016-messagequeueduplicatedsocketerror.md
new file mode 100644
index 00000000000..f80a2211455
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4016-messagequeueduplicatedsocketerror.md
@@ -0,0 +1,35 @@
+---
+title: "4016 - MessageQueueDuplicatedSocketError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c35cf2c-e6fc-48e2-bc40-3af01cb5d31e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4016 - MessageQueueDuplicatedSocketError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4016|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューがソケットの複製に失敗すると生成されます。  
+  
+## メッセージ  
+ メッセージ キューがソケットの複製に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4019-messagequeueduplicatedsocketcomplete.md b/docs/framework/wcf/diagnostics/etw/4019-messagequeueduplicatedsocketcomplete.md
new file mode 100644
index 00000000000..502652da583
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4019-messagequeueduplicatedsocketcomplete.md
@@ -0,0 +1,35 @@
+---
+title: "4019 - MessageQueueDuplicatedSocketComplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2dc5bde8-4f98-45ac-a768-50d417e8b65e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4019 - MessageQueueDuplicatedSocketComplete
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4019|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ キューがソケットの複製を完了すると生成されます。  
+  
+## メッセージ  
+ MessageQueueDuplicatedSocketComplete  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/402-startsignpostevent.md b/docs/framework/wcf/diagnostics/etw/402-startsignpostevent.md
new file mode 100644
index 00000000000..02b7f773af2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/402-startsignpostevent.md
@@ -0,0 +1,40 @@
+---
+title: "402 - StartSignpostEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e5be126-765d-4ac9-88e7-008e9ef4f0e5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 402 - StartSignpostEvent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|402|  
+|キーワード|Troubleshooting|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、エンド ツー エンド アクティビティの開始を示します。ここにはアクティビティの名前が指定されています。  
+  
+## メッセージ  
+ アクティビティの境界。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Extended Data|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4020-tcptransportlistenerlisteningstart.md b/docs/framework/wcf/diagnostics/etw/4020-tcptransportlistenerlisteningstart.md
new file mode 100644
index 00000000000..5797f1aab38
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4020-tcptransportlistenerlisteningstart.md
@@ -0,0 +1,35 @@
+---
+title: "4020 - TcpTransportListenerListeningStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c10fef2-2f12-462f-b266-3127a6e60379
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4020 - TcpTransportListenerListeningStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4020|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP トランスポート リスナーがリッスンを開始したときに生成されます。  
+  
+## メッセージ  
+ TCP トランスポート リスナーが URI: '%1' でリッスンを開始しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4021-tcptransportlistenerlisteningstop.md b/docs/framework/wcf/diagnostics/etw/4021-tcptransportlistenerlisteningstop.md
new file mode 100644
index 00000000000..1ace392ceda
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4021-tcptransportlistenerlisteningstop.md
@@ -0,0 +1,35 @@
+---
+title: "4021 - TcpTransportListenerListeningStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00108ffa-fe02-477e-b9aa-6f08f6849cd2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4021 - TcpTransportListenerListeningStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4021|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、TCP トランスポート リスナーがリッスンしているときに生成されます。  
+  
+## メッセージ  
+ TCP トランスポート リスナーがリッスンしています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4022-webhostunregisterprotocolfailed.md b/docs/framework/wcf/diagnostics/etw/4022-webhostunregisterprotocolfailed.md
new file mode 100644
index 00000000000..a46386784c0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4022-webhostunregisterprotocolfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4022 - WebhostUnregisterProtocolFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cdebf42c-d880-4509-82be-8fdc9f88d203
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4022 - WebhostUnregisterProtocolFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4022|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Web ホストのプロトコルの登録解除が失敗したときに生成されます。  
+  
+## メッセージ  
+ エラー コード:%1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4023-wasclosealllistenerchannelinstancescompleted.md b/docs/framework/wcf/diagnostics/etw/4023-wasclosealllistenerchannelinstancescompleted.md
new file mode 100644
index 00000000000..526b144ffc3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4023-wasclosealllistenerchannelinstancescompleted.md
@@ -0,0 +1,35 @@
+---
+title: "4023 - WasCloseAllListenerChannelInstancesCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95dd5810-78a5-4183-98ef-77267dd64aac
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4023 - WasCloseAllListenerChannelInstancesCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4023|  
+|キーワード|ActivationServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、すべてのリスナー チャネルのインスタンスの終了が完了すると生成されます。  
+  
+## メッセージ  
+ WAS がすべてのリスナー チャネル インスタンスのクローズを完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4024-wasclosealllistenerchannelinstancesfailed.md b/docs/framework/wcf/diagnostics/etw/4024-wasclosealllistenerchannelinstancesfailed.md
new file mode 100644
index 00000000000..b35a720ae47
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4024-wasclosealllistenerchannelinstancesfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4024 - WasCloseAllListenerChannelInstancesFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 73f0dc73-f0b7-4c13-8328-9fdc262009ec
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4024 - WasCloseAllListenerChannelInstancesFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4024|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、すべてのリスナー チャネルのインスタンスの終了が失敗すると生成されます。  
+  
+## メッセージ  
+ エラー コード:%1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4025-openlistenerchannelinstancefailed.md b/docs/framework/wcf/diagnostics/etw/4025-openlistenerchannelinstancefailed.md
new file mode 100644
index 00000000000..91b2cd4fa83
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4025-openlistenerchannelinstancefailed.md
@@ -0,0 +1,35 @@
+---
+title: "4025 - OpenListenerChannelInstanceFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 451192e0-e21a-44c9-b528-8cb984454b34
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4025 - OpenListenerChannelInstanceFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4025|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、リスナー チャネルのインスタンスが開けなかったときに生成されます。  
+  
+## メッセージ  
+ エラー コード:%1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4026-wasconnected.md b/docs/framework/wcf/diagnostics/etw/4026-wasconnected.md
new file mode 100644
index 00000000000..08efe165c7f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4026-wasconnected.md
@@ -0,0 +1,35 @@
+---
+title: "4026 - WasConnected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0ba2cbf-28cf-4b8b-b40b-bfdb8a77afa0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4026 - WasConnected
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4026|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Windows プロセス アクティブ化サービスが接続されたときに生成されます。  
+  
+## メッセージ  
+ WAS が接続されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4027-wasdisconnected.md b/docs/framework/wcf/diagnostics/etw/4027-wasdisconnected.md
new file mode 100644
index 00000000000..fdba909a04c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4027-wasdisconnected.md
@@ -0,0 +1,35 @@
+---
+title: "4027 - WasDisconnected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 940337a3-3094-488a-a1b5-0fb4ab16da73
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4027 - WasDisconnected
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4027|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、Windows アクティブ化サービスの接続が切断されたときに生成されます。  
+  
+## メッセージ  
+ WAS の接続が解除されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4028-pipetransportlistenerlisteningstart.md b/docs/framework/wcf/diagnostics/etw/4028-pipetransportlistenerlisteningstart.md
new file mode 100644
index 00000000000..7cf659b6995
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4028-pipetransportlistenerlisteningstart.md
@@ -0,0 +1,35 @@
+---
+title: "4028 - PipeTransportListenerListeningStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75f83342-09bc-4ab5-b363-01b3cebcc821
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4028 - PipeTransportListenerListeningStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4028|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、パイプ トランスポート リスナーがリッスンを開始したときに生成されます。  
+  
+## メッセージ  
+ パイプ トランスポート リスナーが URI:%1 でリッスンを開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4029-pipetransportlistenerlisteningstop.md b/docs/framework/wcf/diagnostics/etw/4029-pipetransportlistenerlisteningstop.md
new file mode 100644
index 00000000000..2f0432a67b9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4029-pipetransportlistenerlisteningstop.md
@@ -0,0 +1,35 @@
+---
+title: "4029 - PipeTransportListenerListeningStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 870d196d-b5c6-462e-be74-d6ab0d452bd0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4029 - PipeTransportListenerListeningStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4029|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、パイプ トランスポート リスナーがリッスンを停止したときに生成されます。  
+  
+## メッセージ  
+ パイプ トランスポート リスナーがリッスンを停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/403-suspendsignpostevent.md b/docs/framework/wcf/diagnostics/etw/403-suspendsignpostevent.md
new file mode 100644
index 00000000000..362dd61f55f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/403-suspendsignpostevent.md
@@ -0,0 +1,40 @@
+---
+title: "403 - SuspendSignpostEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb2e6f29-e556-47b4-b4c1-acd6b8879702
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 403 - SuspendSignpostEvent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|403|  
+|キーワード|トラブルシューティング|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、エンド ツー エンド アクティビティの中断を示します。  ここにはアクティビティの名前が指定されています。  
+  
+## メッセージ  
+ アクティビティの境界  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Extended Data|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4030-dispatchsessionsuccess.md b/docs/framework/wcf/diagnostics/etw/4030-dispatchsessionsuccess.md
new file mode 100644
index 00000000000..7b4a026763a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4030-dispatchsessionsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "4030 - DispatchSessionSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6530a13d-27d3-4a51-ab3c-7dd962f57b2f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4030 - DispatchSessionSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4030|  
+|キーワード|ActivationServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セッション ディスパッチが成功したときに生成されます。  
+  
+## メッセージ  
+ セッション ディスパッチに成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4031-dispatchsessionfailed.md b/docs/framework/wcf/diagnostics/etw/4031-dispatchsessionfailed.md
new file mode 100644
index 00000000000..38542c777d5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4031-dispatchsessionfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4031 - DispatchSessionFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c9fe9959-aeac-4446-a488-7c7c94c92cef
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 4031 - DispatchSessionFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4031|  
+|キーワード|ActivationServices|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、セッション ディスパッチに失敗したときに生成されます。  
+  
+## メッセージ  
+ セッション ディスパッチに失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4032-wasconnectiontimedout.md b/docs/framework/wcf/diagnostics/etw/4032-wasconnectiontimedout.md
new file mode 100644
index 00000000000..6ace9a5cf3b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4032-wasconnectiontimedout.md
@@ -0,0 +1,35 @@
+---
+title: "4032 - WasConnectionTimedout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 91acad10-f3cc-4075-804f-22c49131b7bf
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4032 - WasConnectionTimedout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4032|  
+|キーワード|ActivationServices|  
+|レベル|重大|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、WAS の接続がタイムアウトしたときに生成されます。  
+  
+## メッセージ  
+ WAS の接続がタイムアウトしました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4033-routingtablelookupstart.md b/docs/framework/wcf/diagnostics/etw/4033-routingtablelookupstart.md
new file mode 100644
index 00000000000..d22f682154b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4033-routingtablelookupstart.md
@@ -0,0 +1,35 @@
+---
+title: "4033 - RoutingTableLookupStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d621ecfe-3335-44cb-97cd-a6648eecd9e2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4033 - RoutingTableLookupStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4033|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ルーティング テーブルの参照が開始されたときに生成されます。  
+  
+## メッセージ  
+ ルーティング テーブルの参照を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4034-routingtablelookupstop.md b/docs/framework/wcf/diagnostics/etw/4034-routingtablelookupstop.md
new file mode 100644
index 00000000000..c5f0e5f812c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4034-routingtablelookupstop.md
@@ -0,0 +1,35 @@
+---
+title: "4034 - RoutingTableLookupStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a7ae705-77fd-42ce-a181-814765873d73
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4034 - RoutingTableLookupStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4034|  
+|キーワード|ActivationServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントはルーティング テーブルの参照が停止したときに生成されます。  
+  
+## メッセージ  
+ ルーティング テーブルの参照が完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4035-pendingsessionqueueratio.md b/docs/framework/wcf/diagnostics/etw/4035-pendingsessionqueueratio.md
new file mode 100644
index 00000000000..6196e3d7954
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4035-pendingsessionqueueratio.md
@@ -0,0 +1,35 @@
+---
+title: "4035 - PendingSessionQueueRatio | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe40094f-6f2c-4dd8-b872-191c7812118e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4035 - PendingSessionQueueRatio
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4035|  
+|キーワード|クォータ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、保留セッション キューの比率に関する情報を提供するために生成されます。  
+  
+## メッセージ  
+ 保留セッション キューの比率: %1\/%2  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/404-resumesignpostevent.md b/docs/framework/wcf/diagnostics/etw/404-resumesignpostevent.md
new file mode 100644
index 00000000000..3dd179e742f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/404-resumesignpostevent.md
@@ -0,0 +1,40 @@
+---
+title: "404 - ResumeSignpostEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 395cc7ca-f35f-4295-be97-39a077f99c97
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 404 - ResumeSignpostEvent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|404|  
+|キーワード|Troubleshooting|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、エンド ツー エンド アクティビティの再開を示します。ここにはアクティビティの名前が指定されています。  
+  
+## メッセージ  
+ アクティビティの境界。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Extended Data|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/451-messageloginfo.md b/docs/framework/wcf/diagnostics/etw/451-messageloginfo.md
new file mode 100644
index 00000000000..930b283f75b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/451-messageloginfo.md
@@ -0,0 +1,40 @@
+---
+title: "451 - MessageLogInfo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 485b4b29-dc21-4a35-93f8-5f4726d6aa5a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 451 - MessageLogInfo
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|451|  
+|キーワード|Troubleshooting、WCFMessageLogging|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ ログ情報が送信されるときに出力されます。  
+  
+## Message  
+ %1  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|data1|`xs:string`||  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/452-messagelogwarning.md b/docs/framework/wcf/diagnostics/etw/452-messagelogwarning.md
new file mode 100644
index 00000000000..92c8c54923d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/452-messagelogwarning.md
@@ -0,0 +1,40 @@
+---
+title: "452 - MessageLogWarning | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22a9f6ea-5b5f-4110-8a4e-9be9c983fbbb
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 452 - MessageLogWarning
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|452|  
+|キーワード|Troubleshooting、WCFMessageLogging|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージ ログ警告が送信されるときに出力されます。  
+  
+## Message  
+ %1  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|data1|`xs:string`||  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4600-messagelogeventsizeexceeded.md b/docs/framework/wcf/diagnostics/etw/4600-messagelogeventsizeexceeded.md
new file mode 100644
index 00000000000..20bf3c5d8ae
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4600-messagelogeventsizeexceeded.md
@@ -0,0 +1,35 @@
+---
+title: "4600 - MessageLogEventSizeExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 469c4fbb-847c-4d3e-b8d7-934e952eb535
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4600 - MessageLogEventSizeExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4600|  
+|キーワード|WCFMessageLogging|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ETW イベントのサイズを上回っているためにメッセージをログに記録できなかったときに生成されます。  
+  
+## メッセージ  
+ メッセージが ETW イベントのサイズを上回っているため、メッセージをログに記録できませんでした  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4801-discoveryclientinclientchannelfailedtoclose.md b/docs/framework/wcf/diagnostics/etw/4801-discoveryclientinclientchannelfailedtoclose.md
new file mode 100644
index 00000000000..de3e506bc21
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4801-discoveryclientinclientchannelfailedtoclose.md
@@ -0,0 +1,35 @@
+---
+title: "4801 - DiscoveryClientInClientChannelFailedToClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d85113b-73b9-4599-b776-30b40aaf1e7a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4801 - DiscoveryClientInClientChannelFailedToClose
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4801|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryClientChannel 内で作成された DiscoveryClient を閉じることができず、異常終了したときに生成されます。  
+  
+## メッセージ  
+ DiscoveryClientChannel 内で作成された DiscoveryClient を閉じることができず、異常終了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4802-discoveryclientprotocolexceptionsuppressed.md b/docs/framework/wcf/diagnostics/etw/4802-discoveryclientprotocolexceptionsuppressed.md
new file mode 100644
index 00000000000..b53113ef9eb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4802-discoveryclientprotocolexceptionsuppressed.md
@@ -0,0 +1,35 @@
+---
+title: "4802 - DiscoveryClientProtocolExceptionSuppressed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 568212f7-1060-4f5c-a7a0-1352c7cc743b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4802 - DiscoveryClientProtocolExceptionSuppressed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4802|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは DiscoveryClient の終了中に ProtocolException が抑制されたときに生成されます。  
+  
+## メッセージ  
+ DiscoveryClient を閉じているときに ProtocolException が抑制されました。  その理由として、DiscoveryService がまだ DiscoveryClient に応答を送信しようとしていることが考えられます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4803-discoveryclientreceivedmulticastsuppression.md b/docs/framework/wcf/diagnostics/etw/4803-discoveryclientreceivedmulticastsuppression.md
new file mode 100644
index 00000000000..df00f1cd4c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4803-discoveryclientreceivedmulticastsuppression.md
@@ -0,0 +1,35 @@
+---
+title: "4803 - DiscoveryClientReceivedMulticastSuppression | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a0aa0f5-e20e-4004-bdeb-15c19a5477d9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4803 - DiscoveryClientReceivedMulticastSuppression
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4803|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryClient が DiscoveryProxy からマルチキャスト抑制メッセージを受け取ったときに生成されます。  
+  
+## メッセージ  
+ DiscoveryClient は DiscoveryProxy からマルチキャスト抑制メッセージを受け取りました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4804-discoverymessagereceivedafteroperationcompleted.md b/docs/framework/wcf/diagnostics/etw/4804-discoverymessagereceivedafteroperationcompleted.md
new file mode 100644
index 00000000000..4d521d845d8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4804-discoverymessagereceivedafteroperationcompleted.md
@@ -0,0 +1,35 @@
+---
+title: "4804 - DiscoveryMessageReceivedAfterOperationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61d2791c-e1a2-400a-a57e-66818ac5962e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4804 - DiscoveryMessageReceivedAfterOperationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4804|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、操作の完了後、探索メッセージを受信したときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' の %1 メッセージは、対応する %3 操作が完了したため、DiscoveryClient によってドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4805-discoverymessagewithinvalidcontent.md b/docs/framework/wcf/diagnostics/etw/4805-discoverymessagewithinvalidcontent.md
new file mode 100644
index 00000000000..3114fd6b244
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4805-discoverymessagewithinvalidcontent.md
@@ -0,0 +1,35 @@
+---
+title: "4805 - DiscoveryMessageWithInvalidContent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c69a7ef-2f5a-438d-bcaf-b3e4c79f0ab7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4805 - DiscoveryMessageWithInvalidContent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4805|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、探索メッセージに無効なコンテンツが含まれているときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' の %1 メッセージは、無効なコンテンツがあったため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4806-discoverymessagewithinvalidrelatestooroperationcompleted.md b/docs/framework/wcf/diagnostics/etw/4806-discoverymessagewithinvalidrelatestooroperationcompleted.md
new file mode 100644
index 00000000000..ac17a167649
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4806-discoverymessagewithinvalidrelatestooroperationcompleted.md
@@ -0,0 +1,35 @@
+---
+title: "4806 - DiscoveryMessageWithInvalidRelatesToOrOperationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19e9a660-25f3-4332-b716-a12a59f2cbbb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4806 - DiscoveryMessageWithInvalidRelatesToOrOperationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4806|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、対応する操作が完了したか、relatesTo 値が無効であるため、探索メッセージが DiscoveryClient によってドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' および relatesTo\='%3' の %1 メッセージは、対応する %4 操作が完了したか、relatesTo 値が無効であるため、DiscoveryClient によってドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4807-discoverymessagewithinvalidreplyto.md b/docs/framework/wcf/diagnostics/etw/4807-discoverymessagewithinvalidreplyto.md
new file mode 100644
index 00000000000..202b054173f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4807-discoverymessagewithinvalidreplyto.md
@@ -0,0 +1,35 @@
+---
+title: "4807 - DiscoveryMessageWithInvalidReplyTo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f104c23-cee3-4e22-89ad-4934b8a587bb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4807 - DiscoveryMessageWithInvalidReplyTo
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4807|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、無効な ReplyTo のアドレスがあったため、探索メッセージがドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%1' の探索要求メッセージは、無効な ReplyTo アドレスがあったため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4808-discoverymessagewithnocontent.md b/docs/framework/wcf/diagnostics/etw/4808-discoverymessagewithnocontent.md
new file mode 100644
index 00000000000..688e687827c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4808-discoverymessagewithnocontent.md
@@ -0,0 +1,35 @@
+---
+title: "4808 - DiscoveryMessageWithNoContent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 489b17f3-c475-40e4-adde-d8b8515b4912
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4808 - DiscoveryMessageWithNoContent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4808|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、無効な ReplyTo のアドレスがあったため、探索メッセージがドロップされたときに生成されます。  
+  
+## メッセージ  
+ %1 メッセージは、コンテンツがなかったため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4809-discoverymessagewithnullmessageid.md b/docs/framework/wcf/diagnostics/etw/4809-discoverymessagewithnullmessageid.md
new file mode 100644
index 00000000000..0d5f582e8fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4809-discoverymessagewithnullmessageid.md
@@ -0,0 +1,35 @@
+---
+title: "4809 - DiscoveryMessageWithNullMessageId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8947028-ae7e-45a2-a438-43162894519e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4809 - DiscoveryMessageWithNullMessageId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4809|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、メッセージ ヘッダーに必要な MessageId プロパティが含まれていなかったため、探索メッセージがドロップされたときに生成されます。  
+  
+## メッセージ  
+ %1 メッセージは、メッセージ ヘッダーに必要な MessageId プロパティが含まれていなかったため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4810-discoverymessagewithnullmessagesequence.md b/docs/framework/wcf/diagnostics/etw/4810-discoverymessagewithnullmessagesequence.md
new file mode 100644
index 00000000000..f79c6917a5f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4810-discoverymessagewithnullmessagesequence.md
@@ -0,0 +1,35 @@
+---
+title: "4810 - DiscoveryMessageWithNullMessageSequence | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa70573e-8a76-486a-9616-ccca8c7008b6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4810 - DiscoveryMessageWithNullMessageSequence
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4810|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryMessageSequence プロパティがなかったことが原因で探索要求メッセージが DiscoveryClient によってドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' の %1 メッセージは、DiscoveryMessageSequence プロパティがなかったため、DiscoveryClient によってドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4811-discoverymessagewithnullrelatesto.md b/docs/framework/wcf/diagnostics/etw/4811-discoverymessagewithnullrelatesto.md
new file mode 100644
index 00000000000..39d0f89868b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4811-discoverymessagewithnullrelatesto.md
@@ -0,0 +1,35 @@
+---
+title: "4811 - DiscoveryMessageWithNullRelatesTo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dab901e8-a2b3-41c1-a76b-bcd8b3c7c29a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4811 - DiscoveryMessageWithNullRelatesTo
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4811|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、メッセージ ヘッダーに必要な RelatesTo プロパティが含まれていなかったため、探索メッセージが DiscoveryClient によってドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' の %1 メッセージは、メッセージ ヘッダーに必要な RelatesTo プロパティが含まれていなかったため、DiscoveryClient によってドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4812-discoverymessagewithnullreplyto.md b/docs/framework/wcf/diagnostics/etw/4812-discoverymessagewithnullreplyto.md
new file mode 100644
index 00000000000..9ca4ebf5d1f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4812-discoverymessagewithnullreplyto.md
@@ -0,0 +1,35 @@
+---
+title: "4812 - DiscoveryMessageWithNullReplyTo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a40e6b7e-c2a6-4186-b1d6-c9560f24a959
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4812 - DiscoveryMessageWithNullReplyTo
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4812|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ReplyTo アドレスがなかったことが原因で探索要求メッセージが DiscoveryClient によってドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%1' の探索要求メッセージは、ReplyTo アドレスがなかったため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4813-duplicatediscoverymessage.md b/docs/framework/wcf/diagnostics/etw/4813-duplicatediscoverymessage.md
new file mode 100644
index 00000000000..b2584c078a8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4813-duplicatediscoverymessage.md
@@ -0,0 +1,35 @@
+---
+title: "4813 - DuplicateDiscoveryMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c49417d1-1f21-4a85-88a5-cbfe108ac8a1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4813 - DuplicateDiscoveryMessage
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4813|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、メッセージが重複していたため、ドロップされたときに生成されます。  
+  
+## メッセージ  
+ messageId\='%2' の %1 メッセージは、重複していたため、ドロップされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4814-endpointdiscoverabilitydisabled.md b/docs/framework/wcf/diagnostics/etw/4814-endpointdiscoverabilitydisabled.md
new file mode 100644
index 00000000000..dffbf707369
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4814-endpointdiscoverabilitydisabled.md
@@ -0,0 +1,35 @@
+---
+title: "4814 - EndpointDiscoverabilityDisabled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b3805218-4865-42d8-976a-cbbd4ff6fcc8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4814 - EndpointDiscoverabilityDisabled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4814|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンドポイントの探索が無効になっているときに生成されます。  
+  
+## メッセージ  
+ EndpointAddress\='%1' および ListenUri\='%2' のエンドポイントの探索が無効になりました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4815-endpointdiscoverabilityenabled.md b/docs/framework/wcf/diagnostics/etw/4815-endpointdiscoverabilityenabled.md
new file mode 100644
index 00000000000..4ed157bdff8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4815-endpointdiscoverabilityenabled.md
@@ -0,0 +1,35 @@
+---
+title: "4815 - EndpointDiscoverabilityEnabled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd027b98-da63-4046-8243-c09e30870b5f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4815 - EndpointDiscoverabilityEnabled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4815|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンドポイントの探索が有効になっているときに生成されます。  
+  
+## メッセージ  
+ EndpointAddress\='%1' および ListenUri\='%2' のエンドポイントの探索が有効になりました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4816-findinitiatedindiscoveryclientchannel.md b/docs/framework/wcf/diagnostics/etw/4816-findinitiatedindiscoveryclientchannel.md
new file mode 100644
index 00000000000..3401b0b4dc2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4816-findinitiatedindiscoveryclientchannel.md
@@ -0,0 +1,35 @@
+---
+title: "4816 - FindInitiatedInDiscoveryClientChannel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e64ad429-3a9a-4df6-893a-36a116d393ee
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4816 - FindInitiatedInDiscoveryClientChannel
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4816|  
+|キーワード|探索|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、エンドポイントを探索するために、Find 操作が DiscoveryClientChannel で開始されたときに生成されます。  
+  
+## メッセージ  
+ エンドポイントを探索するために、Find 操作が DiscoveryClientChannel で開始されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4817-innerchannelcreationfailed.md b/docs/framework/wcf/diagnostics/etw/4817-innerchannelcreationfailed.md
new file mode 100644
index 00000000000..4fa247a15a3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4817-innerchannelcreationfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4817 - InnerChannelCreationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1a20619-beda-49b9-bb64-76b6a009c32b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4817 - InnerChannelCreationFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4817|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryClientChannel が、探索されたエンドポイントを使用してチャネルを作成できなかったときに生成されます。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。  
+  
+## メッセージ  
+ DiscoveryClientChannel は、EndpointAddress\='%1' および Via\='%2' の探索されたエンドポイントを使用して、チャネルを作成できませんでした。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4818-innerchannelopenfailed.md b/docs/framework/wcf/diagnostics/etw/4818-innerchannelopenfailed.md
new file mode 100644
index 00000000000..d88a5330ca7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4818-innerchannelopenfailed.md
@@ -0,0 +1,35 @@
+---
+title: "4818 - InnerChannelOpenFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8ac6447-4fbb-4e08-ab26-91acae48dd11
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4818 - InnerChannelOpenFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4818|  
+|キーワード|探索|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryClientChannel が、探索されたエンドポイントを使用してチャネルを開くことができなかったときに生成されます。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。  
+  
+## メッセージ  
+ DiscoveryClientChannel は、EndpointAddress\='%1' および Via\='%2' の探索されたエンドポイントを使用して、チャネルを開くことができませんでした。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4819-innerchannelopensucceeded.md b/docs/framework/wcf/diagnostics/etw/4819-innerchannelopensucceeded.md
new file mode 100644
index 00000000000..b59e99e5050
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4819-innerchannelopensucceeded.md
@@ -0,0 +1,35 @@
+---
+title: "4819 - InnerChannelOpenSucceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ea7f6ac-a7d8-4ae6-89c7-4fdf99665b4b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4819 - InnerChannelOpenSucceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4819|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DiscoveryClientChannel がエンドポイントを探索し、そのエンドポイントを使用してチャネルを開くことができたときに生成されます。  
+  
+## メッセージ  
+ DiscoveryClientChannel は正常にエンドポイントを探索し、それを使用してチャネルを開きました。  クライアントは EndpointAddress\='%1' および Via\='%2' を使用して、サービスに接続されています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4820-synchronizationcontextreset.md b/docs/framework/wcf/diagnostics/etw/4820-synchronizationcontextreset.md
new file mode 100644
index 00000000000..8a921b3603c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4820-synchronizationcontextreset.md
@@ -0,0 +1,35 @@
+---
+title: "4820 - SynchronizationContextReset | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a5c1597-5270-4b0a-9c8c-bf5f07f7e816
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4820 - SynchronizationContextReset
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4820|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは SynchronizationContext が DiscoveryClientChannel によって元の値にリセットされると生成されます。  
+  
+## メッセージ  
+ SynchronizationContext は DiscoveryClientChannel によって、元の値 %1 にリセットされました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/4821-synchronizationcontextsettonull.md b/docs/framework/wcf/diagnostics/etw/4821-synchronizationcontextsettonull.md
new file mode 100644
index 00000000000..b5b243e8c2b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/4821-synchronizationcontextsettonull.md
@@ -0,0 +1,35 @@
+---
+title: "4821 - SynchronizationContextSetToNull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0fbff6f6-752a-4a4a-b5a3-3adb5e688527
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4821 - SynchronizationContextSetToNull
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4821|  
+|キーワード|探索|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SynchronizationContext が Find 操作を始める前に DiscoveryClientChannel によって NULL に設定されたときに生成されます。  
+  
+## メッセージ  
+ SynchronizationContext は、Find 操作を開始する前に、DiscoveryClientChannel によって NULL に設定されました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/499-transferemitted.md b/docs/framework/wcf/diagnostics/etw/499-transferemitted.md
new file mode 100644
index 00000000000..48bbef5d650
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/499-transferemitted.md
@@ -0,0 +1,40 @@
+---
+title: "499 - TransferEmitted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 07a26434-a7a0-40fc-b5d0-3520a04328ae
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 499 - TransferEmitted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|499|  
+|キーワード|Troubleshooting、UserEvents、EndToEndMonitoring、ServiceModel、WFTracking、ServiceHost、WCFMessageLogging|  
+|レベル|LogAlways|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、転送イベントが発生したときに作成されます。  
+  
+## Message  
+ 転送イベントが作成されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5001-dcserializewithsurrogatestart.md b/docs/framework/wcf/diagnostics/etw/5001-dcserializewithsurrogatestart.md
new file mode 100644
index 00000000000..b34871a7b8f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5001-dcserializewithsurrogatestart.md
@@ -0,0 +1,35 @@
+---
+title: "5001 - DCSerializeWithSurrogateStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42cb442e-ff16-4809-bbee-6d31f012b9b2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5001 - DCSerializeWithSurrogateStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5001|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のサロゲートによるシリアル化を開始すると生成されます。  
+  
+## メッセージ  
+ DataContract のサロゲートによる %1 のシリアル化を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5002-dcserializewithsurrogatestop.md b/docs/framework/wcf/diagnostics/etw/5002-dcserializewithsurrogatestop.md
new file mode 100644
index 00000000000..da4b21d5c98
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5002-dcserializewithsurrogatestop.md
@@ -0,0 +1,35 @@
+---
+title: "5002 - DCSerializeWithSurrogateStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66fd4496-8b94-46d4-b987-19040b4ea4bc
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5002 - DCSerializeWithSurrogateStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5002|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のサロゲートによるシリアル化を停止すると生成されます。  
+  
+## メッセージ  
+ DataContract のサロゲートによるシリアル化を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5003-dcdeserializewithsurrogatestart.md b/docs/framework/wcf/diagnostics/etw/5003-dcdeserializewithsurrogatestart.md
new file mode 100644
index 00000000000..d2af8aa44a7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5003-dcdeserializewithsurrogatestart.md
@@ -0,0 +1,35 @@
+---
+title: "5003 - DCDeserializeWithSurrogateStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 497a78ca-d4d6-4b9d-9b35-bc2db33d6e9c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5003 - DCDeserializeWithSurrogateStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5003|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のサロゲートによる逆シリアル化を開始すると生成されます。  
+  
+## メッセージ  
+ DataContract のサロゲートによる %1 のシリアル化解除を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5004-dcdeserializewithsurrogatestop.md b/docs/framework/wcf/diagnostics/etw/5004-dcdeserializewithsurrogatestop.md
new file mode 100644
index 00000000000..adec927904d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5004-dcdeserializewithsurrogatestop.md
@@ -0,0 +1,35 @@
+---
+title: "5004 - DCDeserializeWithSurrogateStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d2f0c9f-9b28-40b1-91ff-c1e16afca484
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5004 - DCDeserializeWithSurrogateStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5004|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のサロゲートによるシリアル化解除を停止すると生成されます。  
+  
+## メッセージ  
+ DataContract のサロゲートによるシリアル化解除を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5005-importknowntypesstart.md b/docs/framework/wcf/diagnostics/etw/5005-importknowntypesstart.md
new file mode 100644
index 00000000000..5fc535e889a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5005-importknowntypesstart.md
@@ -0,0 +1,35 @@
+---
+title: "5005 - ImportKnownTypesStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e70c9c92-833d-4e88-b129-1decf7a0491d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5005 - ImportKnownTypesStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5005|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ImportKnownTypes が開始されると生成されます。  
+  
+## メッセージ  
+ ImportKnownTypes を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5006-importknowntypesstop.md b/docs/framework/wcf/diagnostics/etw/5006-importknowntypesstop.md
new file mode 100644
index 00000000000..151ee449ce5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5006-importknowntypesstop.md
@@ -0,0 +1,35 @@
+---
+title: "5006 - ImportKnownTypesStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e1786c1-cbdd-4427-b8fc-cbf86b8debae
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5006 - ImportKnownTypesStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5006|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ImportKnownTypes が停止すると生成されます。  
+  
+## メッセージ  
+ ImportKnownTypes を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5007-dcresolverresolve.md b/docs/framework/wcf/diagnostics/etw/5007-dcresolverresolve.md
new file mode 100644
index 00000000000..ccbc36e24f4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5007-dcresolverresolve.md
@@ -0,0 +1,35 @@
+---
+title: "5007 - DCResolverResolve | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 156d92a9-1de5-4ba8-a7a3-e8bf487c5523
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5007 - DCResolverResolve
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5007|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract リゾルバーが解決を開始すると生成されます。  
+  
+## メッセージ  
+ DataContract リゾルバーが %1 の解決を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5008-dcgenwriterstart.md b/docs/framework/wcf/diagnostics/etw/5008-dcgenwriterstart.md
new file mode 100644
index 00000000000..3e51744f6c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5008-dcgenwriterstart.md
@@ -0,0 +1,35 @@
+---
+title: "5008 - DCGenWriterStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a132bd14-15e9-4a14-8a64-41ac85adf620
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5008 - DCGenWriterStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5008|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のライターの生成を開始すると生成されます。  
+  
+## メッセージ  
+ DataContract の %2 の %1 ライターの生成を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5009-dcgenwriterstop.md b/docs/framework/wcf/diagnostics/etw/5009-dcgenwriterstop.md
new file mode 100644
index 00000000000..bab24f2ec5e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5009-dcgenwriterstop.md
@@ -0,0 +1,35 @@
+---
+title: "5009 - DCGenWriterStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8489e542-b2ab-4c31-9150-08d4f6704150
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5009 - DCGenWriterStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5009|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のライターの生成が停止すると生成されます。  
+  
+## メッセージ  
+ DataContract のライターの生成を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/501-compilationstart.md b/docs/framework/wcf/diagnostics/etw/501-compilationstart.md
new file mode 100644
index 00000000000..589d682a17f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/501-compilationstart.md
@@ -0,0 +1,35 @@
+---
+title: "501 - CompilationStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d4a214f-e242-4475-8bc9-02409190dc2c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 501 - CompilationStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|501|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、servicehost のコンパイルが開始されるときに生成されます。  
+  
+## メッセージ  
+ コンパイルを開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5010-dcgenreaderstart.md b/docs/framework/wcf/diagnostics/etw/5010-dcgenreaderstart.md
new file mode 100644
index 00000000000..cb4db3ad4e6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5010-dcgenreaderstart.md
@@ -0,0 +1,35 @@
+---
+title: "5010 - DCGenReaderStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 199ff3ce-b811-4151-a9c2-e726c109e87b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5010 - DCGenReaderStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5010|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract のリーダーの生成を開始すると生成されます。  
+  
+## メッセージ  
+ DataContract の %2 の %1 リーダーの生成を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5011-dcgenreaderstop.md b/docs/framework/wcf/diagnostics/etw/5011-dcgenreaderstop.md
new file mode 100644
index 00000000000..6e94a97bcf6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5011-dcgenreaderstop.md
@@ -0,0 +1,35 @@
+---
+title: "5011 - DCGenReaderStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d59368a-5ef0-4d3c-8bfe-8bb509b90afa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5011 - DCGenReaderStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5011|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DataContract の生成を停止すると生成されます。  
+  
+## メッセージ  
+ DataContract の生成を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5012-dcjsongenreaderstart.md b/docs/framework/wcf/diagnostics/etw/5012-dcjsongenreaderstart.md
new file mode 100644
index 00000000000..51dfa3db74d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5012-dcjsongenreaderstart.md
@@ -0,0 +1,35 @@
+---
+title: "5012 - DCJsonGenReaderStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d2ad3c9-47ee-4e77-b1c6-259ab15b0cfb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5012 - DCJsonGenReaderStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5012|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、Json の生成リーダーを開始すると生成されます。  
+  
+## メッセージ  
+ Json の %2 の %1 リーダーの生成を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5013-dcjsongenreaderstop.md b/docs/framework/wcf/diagnostics/etw/5013-dcjsongenreaderstop.md
new file mode 100644
index 00000000000..93914ac4484
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5013-dcjsongenreaderstop.md
@@ -0,0 +1,35 @@
+---
+title: "5013 - DCJsonGenReaderStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7021eca6-6fdf-4f23-96aa-02d7df0c7dfe
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5013 - DCJsonGenReaderStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5013|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、Json リーダーの生成を停止すると生成されます。  
+  
+## メッセージ  
+ Json のリーダーの生成を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5014-dcjsongenwriterstart.md b/docs/framework/wcf/diagnostics/etw/5014-dcjsongenwriterstart.md
new file mode 100644
index 00000000000..88fa446248a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5014-dcjsongenwriterstart.md
@@ -0,0 +1,35 @@
+---
+title: "5014 - DCJsonGenWriterStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 038ccc90-63f8-42c2-aa17-94a16fde6566
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5014 - DCJsonGenWriterStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5014|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、Json リーダーの生成を開始すると生成されます。  
+  
+## メッセージ  
+ Json の %2 の %1 ライターの生成を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5015-dcjsongenwriterstop.md b/docs/framework/wcf/diagnostics/etw/5015-dcjsongenwriterstop.md
new file mode 100644
index 00000000000..4c051288519
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5015-dcjsongenwriterstop.md
@@ -0,0 +1,35 @@
+---
+title: "5015 - DCJsonGenWriterStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7d70416-88e3-409a-90d7-0f412fa37f2e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5015 - DCJsonGenWriterStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5015|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、Json で生成されたライターが停止すると生成されます。  
+  
+## メッセージ  
+ Json のライターの生成を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5016-genxmlserializablestart.md b/docs/framework/wcf/diagnostics/etw/5016-genxmlserializablestart.md
new file mode 100644
index 00000000000..b991d127a62
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5016-genxmlserializablestart.md
@@ -0,0 +1,35 @@
+---
+title: "5016 - GenXmlSerializableStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1284ef0-2ec9-4acf-8901-c61521561cce
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5016 - GenXmlSerializableStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5016|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、XML シリアル化が可能な要素の生成を開始したときに生成されます。  
+  
+## メッセージ  
+ '%1' の XML シリアル化が可能な要素の生成を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5017-genxmlserializablestop.md b/docs/framework/wcf/diagnostics/etw/5017-genxmlserializablestop.md
new file mode 100644
index 00000000000..868868ba6dc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5017-genxmlserializablestop.md
@@ -0,0 +1,35 @@
+---
+title: "5017 - GenXmlSerializableStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41f0d433-487a-4e48-b397-d8d7b6b64b50
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5017 - GenXmlSerializableStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5017|  
+|キーワード|シリアル化|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、XML シリアル化が可能な要素の生成を停止したときに生成されます。  
+  
+## メッセージ  
+ XML シリアル化が可能な要素の生成を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/502-compilationstop.md b/docs/framework/wcf/diagnostics/etw/502-compilationstop.md
new file mode 100644
index 00000000000..d0f7979532b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/502-compilationstop.md
@@ -0,0 +1,35 @@
+---
+title: "502 - CompilationStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d7d3ab29-0dfa-4cf4-9bca-cd8191c51db5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 502 - CompilationStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|502|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、servicehost のコンパイルが終了するときに生成されます。  
+  
+## メッセージ  
+ コンパイルを終了します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/503-servicehostfactorycreationstart.md b/docs/framework/wcf/diagnostics/etw/503-servicehostfactorycreationstart.md
new file mode 100644
index 00000000000..fd4ec60f22c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/503-servicehostfactorycreationstart.md
@@ -0,0 +1,35 @@
+---
+title: "503 - ServiceHostFactoryCreationStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ae63a4e-a4dd-44de-881f-95b50f983ef5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 503 - ServiceHostFactoryCreationStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|503|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ServiceHostFactory の作成が開始されるときに生成されます。  
+  
+## メッセージ  
+ ServiceHostFactory が作成を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/504-servicehostfactorycreationstop.md b/docs/framework/wcf/diagnostics/etw/504-servicehostfactorycreationstop.md
new file mode 100644
index 00000000000..9de8bbc90ad
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/504-servicehostfactorycreationstop.md
@@ -0,0 +1,35 @@
+---
+title: "504 - ServiceHostFactoryCreationStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 284d240a-ef0c-4572-b3cd-8fbc579db05f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 504 - ServiceHostFactoryCreationStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|504|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、ServiceHostFactory の作成が終了するときに生成されます。  
+  
+## メッセージ  
+ ServiceHostFactory が作成を終了します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/505-createservicehoststart.md b/docs/framework/wcf/diagnostics/etw/505-createservicehoststart.md
new file mode 100644
index 00000000000..4fc8eb82e22
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/505-createservicehoststart.md
@@ -0,0 +1,35 @@
+---
+title: "505 - CreateServiceHostStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f2c670b-c212-458e-bcd0-cdc2f17a6cf6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 505 - CreateServiceHostStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|505|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CreateServiceHost が開始したときに生成されます。  
+  
+## メッセージ  
+ CreateServiceHost を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/506-createservicehoststop.md b/docs/framework/wcf/diagnostics/etw/506-createservicehoststop.md
new file mode 100644
index 00000000000..1536dcddd03
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/506-createservicehoststop.md
@@ -0,0 +1,35 @@
+---
+title: "506 - CreateServiceHostStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f51e4903-1162-47bd-bf8a-f4177c48768a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 506 - CreateServiceHostStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|506|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CreateServiceHost が終了したときに生成されます。  
+  
+## メッセージ  
+ CreateServiceHost を終了します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/507-hostedtransportconfigurationmanagerconfiginitstart.md b/docs/framework/wcf/diagnostics/etw/507-hostedtransportconfigurationmanagerconfiginitstart.md
new file mode 100644
index 00000000000..56571a2852f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/507-hostedtransportconfigurationmanagerconfiginitstart.md
@@ -0,0 +1,35 @@
+---
+title: "507 - HostedTransportConfigurationManagerConfigInitStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf8956cd-2f97-4536-af17-1f42618b4f11
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 507 - HostedTransportConfigurationManagerConfigInitStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|507|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、HostedTransportConfigurationManager の初期化が開始されると生成されます。  
+  
+## メッセージ  
+ HostedTransportConfigurationManager が構成の初期化を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/508-hostedtransportconfigurationmanagerconfiginitstop.md b/docs/framework/wcf/diagnostics/etw/508-hostedtransportconfigurationmanagerconfiginitstop.md
new file mode 100644
index 00000000000..221625b546f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/508-hostedtransportconfigurationmanagerconfiginitstop.md
@@ -0,0 +1,35 @@
+---
+title: "508 - HostedTransportConfigurationManagerConfigInitStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24838d74-05e4-4860-876e-428f947dc7ca
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 508 - HostedTransportConfigurationManagerConfigInitStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|508|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、HostedTransportConfigurationManager の初期化の終了時に生成されます。  
+  
+## メッセージ  
+ HostedTransportConfigurationManager が構成の初期化を終了します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/509-servicehostopenstart.md b/docs/framework/wcf/diagnostics/etw/509-servicehostopenstart.md
new file mode 100644
index 00000000000..abb6bfb1a43
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/509-servicehostopenstart.md
@@ -0,0 +1,35 @@
+---
+title: "509 - ServiceHostOpenStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e53683f9-b2c4-4a61-bd66-3956b1914d8f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 509 - ServiceHostOpenStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|509|  
+|キーワード|ServiceHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceHost Open が開始されたときに生成されます。  
+  
+## メッセージ  
+ ServiceHost Open を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/510-servicehostopenstop.md b/docs/framework/wcf/diagnostics/etw/510-servicehostopenstop.md
new file mode 100644
index 00000000000..d25253f00d9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/510-servicehostopenstop.md
@@ -0,0 +1,35 @@
+---
+title: "510 - ServiceHostOpenStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3377246a-e74c-4d4c-9dda-36d21bd5a48f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 510 - ServiceHostOpenStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|510|  
+|キーワード|ServiceHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceHost Open の完了時に生成されます。  
+  
+## メッセージ  
+ ServiceHost Open が完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/513-webhostrequeststart.md b/docs/framework/wcf/diagnostics/etw/513-webhostrequeststart.md
new file mode 100644
index 00000000000..722362c25ed
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/513-webhostrequeststart.md
@@ -0,0 +1,35 @@
+---
+title: "513 - WebHostRequestStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d664cf1e-f114-4441-8c59-65b98ea498e9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 513 - WebHostRequestStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|513|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebHostRequest が開始されたときに生成されます。  
+  
+## メッセージ  
+ AppDomain '%1' からの仮想パス '%2' で要求を受信しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/514-webhostrequeststop.md b/docs/framework/wcf/diagnostics/etw/514-webhostrequeststop.md
new file mode 100644
index 00000000000..ef6bd78b4d3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/514-webhostrequeststop.md
@@ -0,0 +1,35 @@
+---
+title: "514 - WebHostRequestStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c5858bf6-3330-4f2a-9907-a99692fa8817
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 514 - WebHostRequestStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|514|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、WebHostRequest が終了したときに生成されます。  
+  
+## メッセージ  
+ WebHostRequest を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5203-jsonmessagedecodingstart.md b/docs/framework/wcf/diagnostics/etw/5203-jsonmessagedecodingstart.md
new file mode 100644
index 00000000000..9a7a68095d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5203-jsonmessagedecodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "5203 - JsonMessageDecodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83836ebf-8cc9-4f4c-92ff-4fd28304a299
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5203 - JsonMessageDecodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5203|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、JsonMessageEncoder がメッセージのデコードを開始したときに生成されます。  
+  
+## メッセージ  
+ JsonMessageEncoder がメッセージのデコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5204-jsonmessageencodingstart.md b/docs/framework/wcf/diagnostics/etw/5204-jsonmessageencodingstart.md
new file mode 100644
index 00000000000..ea5355844c1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5204-jsonmessageencodingstart.md
@@ -0,0 +1,35 @@
+---
+title: "5204 - JsonMessageEncodingStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eda84660-7bf9-4633-81ce-e294f258d8e4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5204 - JsonMessageEncodingStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5204|  
+|キーワード|チャネル|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、JsonMessageEncoder がメッセージのエンコードを開始したときに生成されます。  
+  
+## メッセージ  
+ JsonMessageEncoder がメッセージのエンコードを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5402-tokenvalidationstarted.md b/docs/framework/wcf/diagnostics/etw/5402-tokenvalidationstarted.md
new file mode 100644
index 00000000000..6d4269ec645
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5402-tokenvalidationstarted.md
@@ -0,0 +1,35 @@
+---
+title: "5402 - TokenValidationStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d3e9a727-92dd-4d5b-bca9-2ec98c1fde5c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5402 - TokenValidationStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5402|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SecurityToken の検証が開始されたときに生成されます。  
+  
+## メッセージ  
+ SecurityToken \(型 '%1'、ID '%2'\) の検証を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5403-tokenvalidationsuccess.md b/docs/framework/wcf/diagnostics/etw/5403-tokenvalidationsuccess.md
new file mode 100644
index 00000000000..ad745a22c6a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5403-tokenvalidationsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5403 - TokenValidationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 322efeb2-8081-4d3c-ab92-31d5b236f4d3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5403 - TokenValidationSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5403|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SecurityToken の検証に成功したときに生成されます。  
+  
+## メッセージ  
+ SecurityToken \(型 '%1'、ID '%2'\) の検証に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5404-tokenvalidationfailure.md b/docs/framework/wcf/diagnostics/etw/5404-tokenvalidationfailure.md
new file mode 100644
index 00000000000..bea998c3496
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5404-tokenvalidationfailure.md
@@ -0,0 +1,35 @@
+---
+title: "5404 - TokenValidationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19783336-5560-4334-be13-2efd15da3e2a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5404 - TokenValidationFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5404|  
+|キーワード|セキュリティ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、SecurityToken の検証が失敗したときに生成されます。  
+  
+## メッセージ  
+ SecurityToken \(型 '%1'、ID '%2'\) の検証に失敗しました。  %3  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5405-getissuernamesuccess.md b/docs/framework/wcf/diagnostics/etw/5405-getissuernamesuccess.md
new file mode 100644
index 00000000000..a8194fe395b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5405-getissuernamesuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5405 - GetIssuerNameSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b7904796-0eb2-4d45-a1bb-d13af9ab740d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5405 - GetIssuerNameSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5405|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、発行者名の取得に成功したときに生成されます。  
+  
+## メッセージ  
+ トークン ID: %2 からの発行者名: %1 の取得に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5406-getissuernamefailure.md b/docs/framework/wcf/diagnostics/etw/5406-getissuernamefailure.md
new file mode 100644
index 00000000000..59915205b4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5406-getissuernamefailure.md
@@ -0,0 +1,35 @@
+---
+title: "5406 - GetIssuerNameFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ea38c75b-f594-49c1-8800-ccbf1b8306f1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5406 - GetIssuerNameFailure
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5406|  
+|キーワード|セキュリティ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、発行者名の取得に失敗したときに生成されます。  
+  
+## メッセージ  
+ トークン ID: %1 からの発行者名の取得に失敗しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5600-federationmessageprocessingstarted.md b/docs/framework/wcf/diagnostics/etw/5600-federationmessageprocessingstarted.md
new file mode 100644
index 00000000000..7eb441fad3b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5600-federationmessageprocessingstarted.md
@@ -0,0 +1,35 @@
+---
+title: "5600 - FederationMessageProcessingStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52f36a6f-cc3f-441f-a4c2-e8df2e747d52
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5600 - FederationMessageProcessingStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5600|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、フェデレーション メッセージの処理を開始すると生成されます。  
+  
+## メッセージ  
+ フェデレーション メッセージの処理を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5601-federationmessageprocessingsuccess.md b/docs/framework/wcf/diagnostics/etw/5601-federationmessageprocessingsuccess.md
new file mode 100644
index 00000000000..6d862334931
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5601-federationmessageprocessingsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5601 - FederationMessageProcessingSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 767591c3-2674-4d7e-a61b-e76da3b159ae
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5601 - FederationMessageProcessingSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5601|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、フェデレーション メッセージの処理に成功すると生成されます。  
+  
+## メッセージ  
+ フェデレーション メッセージの処理に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5602-federationmessagecreationstarted.md b/docs/framework/wcf/diagnostics/etw/5602-federationmessagecreationstarted.md
new file mode 100644
index 00000000000..6b39a2de69a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5602-federationmessagecreationstarted.md
@@ -0,0 +1,35 @@
+---
+title: "5602 - FederationMessageCreationStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a93a5057-86d8-4be9-a5a4-09ba935fef01
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5602 - FederationMessageCreationStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5602|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、フォーム ポストからのフェデレーション メッセージの作成を開始したときに生成されます。  
+  
+## メッセージ  
+ フォーム ポストからのフェデレーション メッセージの作成を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5603-federationmessagecreationsuccess.md b/docs/framework/wcf/diagnostics/etw/5603-federationmessagecreationsuccess.md
new file mode 100644
index 00000000000..53cf264a44d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5603-federationmessagecreationsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5603 - FederationMessageCreationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b55abdf4-cbe1-401e-b23e-f2bf1bcca719
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5603 - FederationMessageCreationSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5603|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、フォーム ポストからのフェデレーション メッセージの作成に成功したときに生成されます。  
+  
+## メッセージ  
+ フォーム ポストからのフェデレーション メッセージの作成に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5604-sessioncookiereadingstarted.md b/docs/framework/wcf/diagnostics/etw/5604-sessioncookiereadingstarted.md
new file mode 100644
index 00000000000..a46b4afce83
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5604-sessioncookiereadingstarted.md
@@ -0,0 +1,35 @@
+---
+title: "5604 - SessionCookieReadingStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7348caaa-add0-473d-8af3-b2dadb68abdb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5604 - SessionCookieReadingStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5604|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セッション クッキーからのセッション トークンの読み取りが開始されたときに生成されます。  
+  
+## メッセージ  
+ セッション クッキーからのセッション トークンの読み取りを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5605-sessioncookiereadingsuccess.md b/docs/framework/wcf/diagnostics/etw/5605-sessioncookiereadingsuccess.md
new file mode 100644
index 00000000000..fca26572255
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5605-sessioncookiereadingsuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5605 - SessionCookieReadingSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2cc1693d-7834-45ce-9a6d-dbe31dc2d517
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5605 - SessionCookieReadingSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5605|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セッション クッキーからのセッション トークンの読み取りが成功したときに生成されます。  
+  
+## メッセージ  
+ セッション クッキーからのセッション トークンの読み取りに成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5606-principalsettingfromsessiontokenstarted.md b/docs/framework/wcf/diagnostics/etw/5606-principalsettingfromsessiontokenstarted.md
new file mode 100644
index 00000000000..792f79e1a93
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5606-principalsettingfromsessiontokenstarted.md
@@ -0,0 +1,35 @@
+---
+title: "5606 - PrincipalSettingFromSessionTokenStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f307ffda-8a89-4527-a7e5-915b820508ee
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5606 - PrincipalSettingFromSessionTokenStarted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5606|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セッション クッキーからのプリンシパルの設定が開始されたときに生成されます。  
+  
+## メッセージ  
+ セッション トークンからのプリンシパルの設定を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/5607-principalsettingfromsessiontokensuccess.md b/docs/framework/wcf/diagnostics/etw/5607-principalsettingfromsessiontokensuccess.md
new file mode 100644
index 00000000000..262a5a2cb1c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/5607-principalsettingfromsessiontokensuccess.md
@@ -0,0 +1,35 @@
+---
+title: "5607 - PrincipalSettingFromSessionTokenSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f36cf68c-58e2-4bdd-bed9-eb7727650010
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 5607 - PrincipalSettingFromSessionTokenSuccess
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|5607|  
+|キーワード|セキュリティ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、セッション クッキーからのプリンシパルの設定に成功したときに生成されます。  
+  
+## メッセージ  
+ セッション トークンからのプリンシパルの設定に成功しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57393-appdomainunload.md b/docs/framework/wcf/diagnostics/etw/57393-appdomainunload.md
new file mode 100644
index 00000000000..46231d27ba4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57393-appdomainunload.md
@@ -0,0 +1,35 @@
+---
+title: "57393 - AppDomainUnload | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8f45002-025e-4c93-b7b1-a09d631dbb1d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57393 - AppDomainUnload
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57393|  
+|キーワード|インフラストラクチャ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは AppDomain のアンロード時に生成されます。  
+  
+## メッセージ  
+ AppDomain をアンロードしています。  AppDomain.FriendlyName %1、ProcessName %2、ProcessId %3。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57394-handledexception.md b/docs/framework/wcf/diagnostics/etw/57394-handledexception.md
new file mode 100644
index 00000000000..57216210a4c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57394-handledexception.md
@@ -0,0 +1,35 @@
+---
+title: "57394 - HandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c9e63436-6550-4891-9673-cbc72dda20e3
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57394 - HandledException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57394|  
+|キーワード|インフラストラクチャ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、例外の処理時に生成されます。  
+  
+## メッセージ  
+ 例外を処理しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57395-shipassertexceptionmessage.md b/docs/framework/wcf/diagnostics/etw/57395-shipassertexceptionmessage.md
new file mode 100644
index 00000000000..5a47e059d6b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57395-shipassertexceptionmessage.md
@@ -0,0 +1,35 @@
+---
+title: "57395 - ShipAssertExceptionMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37f0c15b-e34e-42fe-8f86-b122e592add5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57395 - ShipAssertExceptionMessage
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57395|  
+|キーワード|インフラストラクチャ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、予期しないエラーが発生した場合に生成されます。  
+  
+## メッセージ  
+ 予期しないエラーが発生しました。  アプリケーションではこのエラーを処理することはできません。  診断上の目的から、次の英語のメッセージがエラーに関連付けられています: %1。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57396-throwingexception.md b/docs/framework/wcf/diagnostics/etw/57396-throwingexception.md
new file mode 100644
index 00000000000..e7fafd959fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57396-throwingexception.md
@@ -0,0 +1,35 @@
+---
+title: "57396 - ThrowingException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f865de5-62c1-443c-9dcd-1675ca127334
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57396 - ThrowingException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57396|  
+|キーワード|インフラストラクチャ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、例外のスロー時に生成されます。  
+  
+## メッセージ  
+ 例外をスローしています。  発生元 %1。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57397-unhandledexception.md b/docs/framework/wcf/diagnostics/etw/57397-unhandledexception.md
new file mode 100644
index 00000000000..558125b4b22
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57397-unhandledexception.md
@@ -0,0 +1,35 @@
+---
+title: "57397 - UnhandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0576aa4a-544c-45c1-8319-1b214824e83e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57397 - UnhandledException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57397|  
+|キーワード|インフラストラクチャ|  
+|レベル|重大|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントはハンドルされない例外の発生時に生成されます。  
+  
+## メッセージ  
+ ハンドルされていない例外です。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57399-tracecodeeventlogcritical.md b/docs/framework/wcf/diagnostics/etw/57399-tracecodeeventlogcritical.md
new file mode 100644
index 00000000000..00dcd9d383f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57399-tracecodeeventlogcritical.md
@@ -0,0 +1,35 @@
+---
+title: "57399 - TraceCodeEventLogCritical | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f41451c-1e90-4bc1-8538-2876df819c7f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57399 - TraceCodeEventLogCritical
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57399|  
+|キーワード|インフラストラクチャ|  
+|レベル|重大|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは TraceCodeEventLogCritical で生成されます。  
+  
+## メッセージ  
+ イベント ログに書き込みました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57400-tracecodeeventlogerror.md b/docs/framework/wcf/diagnostics/etw/57400-tracecodeeventlogerror.md
new file mode 100644
index 00000000000..b0110823734
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57400-tracecodeeventlogerror.md
@@ -0,0 +1,35 @@
+---
+title: "57400 - TraceCodeEventLogError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89864cd9-24fd-4568-920f-d0ba434b6f15
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57400 - TraceCodeEventLogError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57400|  
+|キーワード|インフラストラクチャ|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは TraceCodeEventLogError で生成されます。  
+  
+## メッセージ  
+ イベント ログに書き込みました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57401-tracecodeeventloginfo.md b/docs/framework/wcf/diagnostics/etw/57401-tracecodeeventloginfo.md
new file mode 100644
index 00000000000..23ae0df35c7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57401-tracecodeeventloginfo.md
@@ -0,0 +1,35 @@
+---
+title: "57401 - TraceCodeEventLogInfo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 64f01506-0c11-4cdb-b9a2-552938da487b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57401 - TraceCodeEventLogInfo
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57401|  
+|キーワード|インフラストラクチャ|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは TraceCodeEventLogInfo 時に生成されます。  
+  
+## メッセージ  
+ イベント ログに書き込みました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57402-tracecodeeventlogverbose.md b/docs/framework/wcf/diagnostics/etw/57402-tracecodeeventlogverbose.md
new file mode 100644
index 00000000000..8e53b101bae
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57402-tracecodeeventlogverbose.md
@@ -0,0 +1,35 @@
+---
+title: "57402 - TraceCodeEventLogVerbose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6b1d6a7-a067-40d9-842a-ef451cebe03b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57402 - TraceCodeEventLogVerbose
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57402|  
+|キーワード|インフラストラクチャ|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは TraceCodeEventLogVerbose で生成されます。  
+  
+## メッセージ  
+ イベント ログに書き込みました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57403-tracecodeeventlogwarning.md b/docs/framework/wcf/diagnostics/etw/57403-tracecodeeventlogwarning.md
new file mode 100644
index 00000000000..e6728e55c29
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57403-tracecodeeventlogwarning.md
@@ -0,0 +1,35 @@
+---
+title: "57403 - TraceCodeEventLogWarning | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f5e7b068-a335-4c4b-9cae-44d0ffeaa595
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57403 - TraceCodeEventLogWarning
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57403|  
+|キーワード|インフラストラクチャ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは TraceCodeEventLogWarning で生成されます。  
+  
+## メッセージ  
+ イベント ログに書き込みました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/57404-handledexceptionwarning.md b/docs/framework/wcf/diagnostics/etw/57404-handledexceptionwarning.md
new file mode 100644
index 00000000000..6d26aded297
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/57404-handledexceptionwarning.md
@@ -0,0 +1,35 @@
+---
+title: "57404 - HandledExceptionWarning | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81fc404c-6341-4fa0-a58e-c32875471c12
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 57404 - HandledExceptionWarning
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57404|  
+|キーワード|インフラストラクチャ|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは例外の処理時に生成されます。  
+  
+## メッセージ  
+ 例外を処理しています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/601-cbaentryread.md b/docs/framework/wcf/diagnostics/etw/601-cbaentryread.md
new file mode 100644
index 00000000000..062e60edaca
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/601-cbaentryread.md
@@ -0,0 +1,35 @@
+---
+title: "601 - CBAEntryRead | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d8b757f-e8d8-4c12-927e-ba3776c17983
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 601 - CBAEntryRead
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|601|  
+|キーワード||  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CBAEntry 読み取り時に生成されます。  
+  
+## メッセージ  
+ ServiceActivation 要素の相対アドレス: '%1'、標準化相対アドレス '%2' を処理しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/602-cbamatchfound.md b/docs/framework/wcf/diagnostics/etw/602-cbamatchfound.md
new file mode 100644
index 00000000000..203eba309a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/602-cbamatchfound.md
@@ -0,0 +1,35 @@
+---
+title: "602 - CBAMatchFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b1ccbb8-5a43-4b36-9949-702877cef90a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 602 - CBAMatchFound
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|602|  
+|キーワード||  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、CBAMatch の検出時に生成されます。  
+  
+## メッセージ  
+ 受信要求が、アドレス '%1' の ServiceActivation 要素と一致します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/603-aspnetroutingservice.md b/docs/framework/wcf/diagnostics/etw/603-aspnetroutingservice.md
new file mode 100644
index 00000000000..cdc9ec0d472
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/603-aspnetroutingservice.md
@@ -0,0 +1,35 @@
+---
+title: "603 - AspNetRoutingService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a63dddc-72a2-4b43-b1f1-bfce434dcee9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 603 - AspNetRoutingService
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|603|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、受信要求が、アドレス %1 の Asp.Net ルートで定義された WCF サービスと一致すると生成されます。  
+  
+## メッセージ  
+ 受信要求が、アドレス %1 の Asp.Net ルートで定義された WCF サービスと一致します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/604-aspnetroute.md b/docs/framework/wcf/diagnostics/etw/604-aspnetroute.md
new file mode 100644
index 00000000000..8da8e8d5526
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/604-aspnetroute.md
@@ -0,0 +1,35 @@
+---
+title: "604 - AspNetRoute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 761748b5-1b7c-4b17-98ba-0579876632f1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 604 - AspNetRoute
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|604|  
+|キーワード|RoutingServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、serviceType '%2' および serviceHostFactoryType '%3' の新しい Asp.Net ルート ''%1'' が追加されたときに生成されます。  
+  
+## メッセージ  
+ serviceType '%2' および serviceHostFactoryType '%3' の新しい Asp.Net ルート '%1' が追加されます。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/605-incrementbusycount.md b/docs/framework/wcf/diagnostics/etw/605-incrementbusycount.md
new file mode 100644
index 00000000000..b1716341a70
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/605-incrementbusycount.md
@@ -0,0 +1,35 @@
+---
+title: "605 - IncrementBusyCount | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33ea5f9e-cd58-4833-8082-b99bab5cb254
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 605 - IncrementBusyCount
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|605|  
+|キーワード|WebHost|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、IncrementBusyCount が呼び出されたときに生成されます。  
+  
+## メッセージ  
+ IncrementBusyCount が呼び出されました。  ソース: %1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/606-decrementbusycount.md b/docs/framework/wcf/diagnostics/etw/606-decrementbusycount.md
new file mode 100644
index 00000000000..c1eeaa8dfca
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/606-decrementbusycount.md
@@ -0,0 +1,35 @@
+---
+title: "606 - DecrementBusyCount | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3dd6c6ae-1010-415c-82e4-51eaa897f1fa
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 606 - DecrementBusyCount
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|606|  
+|キーワード|WebHost|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、DecrementBusyCount が呼び出されたときに生成されます。  
+  
+## メッセージ  
+ DecrementBusyCount が呼び出されました。  ソース: %1  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/62326-httphandlerpickedforurl.md b/docs/framework/wcf/diagnostics/etw/62326-httphandlerpickedforurl.md
new file mode 100644
index 00000000000..6594b99d671
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/62326-httphandlerpickedforurl.md
@@ -0,0 +1,35 @@
+---
+title: "62326 - HttpHandlerPickedForUrl | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: edb9fb88-dfb0-486c-971d-26735d80dc0d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 62326 - HttpHandlerPickedForUrl
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|62326|  
+|キーワード|WebHost|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、この URL に対して行われるすべての要求を処理するために HTTP ハンドラーが選択されるときに生成されます。  
+  
+## メッセージ  
+ URL '%1' は、ルート要素型 '%2' の XAML ドキュメントをホストします。  この URL に対して行われるすべての要求を処理するために、HTTP ハンドラー型 '%3' が選択されています。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/701-servicechannelopenstart.md b/docs/framework/wcf/diagnostics/etw/701-servicechannelopenstart.md
new file mode 100644
index 00000000000..ee0a0aeb723
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/701-servicechannelopenstart.md
@@ -0,0 +1,35 @@
+---
+title: "701 - ServiceChannelOpenStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aaf1896e-b55a-4a91-854f-b59672bab3c7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 701 - ServiceChannelOpenStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|701|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceChannelOpen が開始されると生成されます。  
+  
+## メッセージ  
+ ServiceChannelOpen を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/702-servicechannelopenstop.md b/docs/framework/wcf/diagnostics/etw/702-servicechannelopenstop.md
new file mode 100644
index 00000000000..2c06a767b89
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/702-servicechannelopenstop.md
@@ -0,0 +1,35 @@
+---
+title: "702 - ServiceChannelOpenStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 190298c4-8216-4eb5-b8b0-8072400838c5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 702 - ServiceChannelOpenStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|702|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceChannelOpen の完了時に生成されます。  
+  
+## メッセージ  
+ ServiceChannelOpen が完了しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/703-servicechannelcallstart.md b/docs/framework/wcf/diagnostics/etw/703-servicechannelcallstart.md
new file mode 100644
index 00000000000..e5ea3742ffb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/703-servicechannelcallstart.md
@@ -0,0 +1,35 @@
+---
+title: "703 - ServiceChannelCallStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2595b36-a894-45c3-b722-e945107c0542
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 703 - ServiceChannelCallStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|703|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceChannelCall が開始されると生成されます。  
+  
+## メッセージ  
+ ServiceChannelCall を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/704-servicechannelbegincallstart.md b/docs/framework/wcf/diagnostics/etw/704-servicechannelbegincallstart.md
new file mode 100644
index 00000000000..20fac42124d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/704-servicechannelbegincallstart.md
@@ -0,0 +1,35 @@
+---
+title: "704 - ServiceChannelBeginCallStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 708819d3-45cc-46c3-938c-80f38b1fa9e2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 704 - ServiceChannelBeginCallStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|704|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ServiceChannel 非同期呼び出しが開始されたときに生成されます。  
+  
+## メッセージ  
+ ServiceChannel の非同期呼び出しを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/706-httpsendmessagestart.md b/docs/framework/wcf/diagnostics/etw/706-httpsendmessagestart.md
new file mode 100644
index 00000000000..1e64a8a07a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/706-httpsendmessagestart.md
@@ -0,0 +1,35 @@
+---
+title: "706 - HttpSendMessageStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 825d3697-4b6c-4156-8f3a-ce24c4e39c48
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 706 - HttpSendMessageStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|706|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、HTTP 送信要求が開始されると生成されます。  
+  
+## メッセージ  
+ HTTP 送信要求を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/707-httpsendstop.md b/docs/framework/wcf/diagnostics/etw/707-httpsendstop.md
new file mode 100644
index 00000000000..cb4f012a182
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/707-httpsendstop.md
@@ -0,0 +1,35 @@
+---
+title: "707 - HttpSendStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c8a607a-be7a-4e36-a885-67746f03cae6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 707 - HttpSendStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|707|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ このイベントは、HTTP 送信要求が停止されると生成されます。  
+  
+## メッセージ  
+ HTTP 送信要求を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/708-httpmessagereceivestart.md b/docs/framework/wcf/diagnostics/etw/708-httpmessagereceivestart.md
new file mode 100644
index 00000000000..26345d53917
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/708-httpmessagereceivestart.md
@@ -0,0 +1,35 @@
+---
+title: "708 - HttpMessageReceiveStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fde15725-fca8-4e8c-963c-6d9ae9552a8a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 708 - HttpMessageReceiveStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|708|  
+|キーワード|HTTP|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、HTTP トランスポートからのメッセージを受信したときに生成されます。  
+  
+## メッセージ  
+ HTTP トランスポートからメッセージを受信しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/709-dispatchmessagestart.md b/docs/framework/wcf/diagnostics/etw/709-dispatchmessagestart.md
new file mode 100644
index 00000000000..ccd4cc19097
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/709-dispatchmessagestart.md
@@ -0,0 +1,35 @@
+---
+title: "709 - DispatchMessageStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aef78385-681a-40fb-9809-0862c655fd06
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 709 - DispatchMessageStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|709|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージのディスパッチが開始されると生成されます。  
+  
+## メッセージ  
+ メッセージのディスパッチを開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/710-httpcontextbeforeprocessauthentication.md b/docs/framework/wcf/diagnostics/etw/710-httpcontextbeforeprocessauthentication.md
new file mode 100644
index 00000000000..d85856efa9a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/710-httpcontextbeforeprocessauthentication.md
@@ -0,0 +1,35 @@
+---
+title: "710 - HttpContextBeforeProcessAuthentication | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2e20c23-e54c-4774-8809-dfdc92f7eff9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 710 - HttpContextBeforeProcessAuthentication
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|710|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージのディスパッチの認証が開始されると生成されます。  
+  
+## メッセージ  
+ メッセージのディスパッチの認証を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/711-dispatchmessagebeforeauthorization.md b/docs/framework/wcf/diagnostics/etw/711-dispatchmessagebeforeauthorization.md
new file mode 100644
index 00000000000..0a73354811e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/711-dispatchmessagebeforeauthorization.md
@@ -0,0 +1,35 @@
+---
+title: "711 - DispatchMessageBeforeAuthorization | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ea7f7228-e642-441d-9470-6609a9fe08f0
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 711 - DispatchMessageBeforeAuthorization
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|711|  
+|キーワード|ServiceModel|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージのディスパッチの認証が開始されると生成されます。  
+  
+## メッセージ  
+ メッセージのディスパッチの承認を開始します  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/712-dispatchmessagestop.md b/docs/framework/wcf/diagnostics/etw/712-dispatchmessagestop.md
new file mode 100644
index 00000000000..86f165e4525
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/712-dispatchmessagestop.md
@@ -0,0 +1,35 @@
+---
+title: "712 - DispatchMessageStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e1894a6-9c44-4533-aaec-64063a2cbb06
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 712 - DispatchMessageStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|712|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、メッセージのディスパッチが完了するときに生成されます。  
+  
+## メッセージ  
+ メッセージのディスパッチが完了しました  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/715-clientchannelopenstart.md b/docs/framework/wcf/diagnostics/etw/715-clientchannelopenstart.md
new file mode 100644
index 00000000000..b0df6fd0960
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/715-clientchannelopenstart.md
@@ -0,0 +1,35 @@
+---
+title: "715 - ClientChannelOpenStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62be7826-9c4e-4fec-b958-185ddfaed976
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 715 - ClientChannelOpenStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|715|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは ServiceChannel Open を開始すると生成されます。  
+  
+## メッセージ  
+ ServiceChannel Open を開始します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/716-clientchannelopenstop.md b/docs/framework/wcf/diagnostics/etw/716-clientchannelopenstop.md
new file mode 100644
index 00000000000..e01340bad96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/716-clientchannelopenstop.md
@@ -0,0 +1,35 @@
+---
+title: "716 - ClientChannelOpenStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 55dc74a8-348f-47f3-aaca-4aef6cd75651
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 716 - ClientChannelOpenStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|716|  
+|キーワード|ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは ServiceChannel Open を停止すると生成されます。  
+  
+## メッセージ  
+ ServiceChannel Open を停止します。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/717-httpsendstreamedmessagestart.md b/docs/framework/wcf/diagnostics/etw/717-httpsendstreamedmessagestart.md
new file mode 100644
index 00000000000..8a62a6bf7d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/717-httpsendstreamedmessagestart.md
@@ -0,0 +1,35 @@
+---
+title: "717 - HttpSendStreamedMessageStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a157fdd5-b1b7-4498-9b0c-8a68c6f1f020
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 717 - HttpSendStreamedMessageStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|717|  
+|キーワード|HTTP|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ストリーム メッセージの HTTP 送信が開始されると生成されます。  
+  
+## メッセージ  
+ ストリーム メッセージの HTTP 送信を開始しました。  
+  
+## 詳細
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/TOC.md b/docs/framework/wcf/diagnostics/etw/TOC.md
new file mode 100644
index 00000000000..c9275f2b027
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/TOC.md
@@ -0,0 +1,359 @@
+# [4035 - PendingSessionQueueRatio](4035-pendingsessionqueueratio.md)
+# [132 - BufferPoolChangeQuota](132-bufferpoolchangequota.md)
+# [708 - HttpMessageReceiveStart](708-httpmessagereceivestart.md)
+# [3424 - WebSocketAsyncReadStart](3424-websocketasyncreadstart.md)
+# [1424 - SecuritySessionRatio](1424-securitysessionratio.md)
+# [3390 - ClientSendPreambleStop](3390-clientsendpreamblestop.md)
+# [3830 - RoutingServiceAbortingChannel](3830-routingserviceabortingchannel.md)
+# [403 - SuspendSignpostEvent](403-suspendsignpostevent.md)
+# [3401 - SignatureVerificationStart](3401-signatureverificationstart.md)
+# [3430 - WebSocketUseVersionFromClientWebSocketFactory](3430-websocketuseversionfromclientwebsocketfactory.md)
+# [3407 - HttpPipelineProcessInboundRequestStart](3407-httppipelineprocessinboundrequeststart.md)
+# [3396 - BufferedAsyncWriteStart](3396-bufferedasyncwritestart.md)
+# [57403 - TraceCodeEventLogWarning](57403-tracecodeeventlogwarning.md)
+# [3383 - ReliableSessionChannelFaulted](3383-reliablesessionchannelfaulted.md)
+# [3804 - RoutingServiceCreatingClientForEndpoint](3804-routingservicecreatingclientforendpoint.md)
+# [506 - CreateServiceHostStop](506-createservicehoststop.md)
+# [5607 - PrincipalSettingFromSessionTokenSuccess](5607-principalsettingfromsessiontokensuccess.md)
+# [5606 - PrincipalSettingFromSessionTokenStarted](5606-principalsettingfromsessiontokenstarted.md)
+# [3395 - MessageWrittenAsynchronouslyByEncoder](3395-messagewrittenasynchronouslybyencoder.md)
+# [3308 - ClientBaseUsingLocalChannelFactory](3308-clientbaseusinglocalchannelfactory.md)
+# [1416 - MaxReceivedMessageSizeExceeded](1416-maxreceivedmessagesizeexceeded.md)
+# [62326 - HttpHandlerPickedForUrl](62326-httphandlerpickedforurl.md)
+# [5204 - JsonMessageEncodingStart](5204-jsonmessageencodingstart.md)
+# [3303 - ReceiveContextAbandonWithException](3303-receivecontextabandonwithexception.md)
+# [711 - DispatchMessageBeforeAuthorization](711-dispatchmessagebeforeauthorization.md)
+# [5406 - GetIssuerNameFailure](5406-getissuernamefailure.md)
+# [57393 - AppDomainUnload](57393-appdomainunload.md)
+# [3338 - ChannelReceiveStop](3338-channelreceivestop.md)
+# [3345 - SessionPreambleUnderstood](3345-sessionpreambleunderstood.md)
+# [サービス操作の実行時間の確認](determining-service-operation-duration.md)
+# [3826 - RoutingServiceUsingExistingTransaction](3826-routingserviceusingexistingtransaction.md)
+# [5005 - ImportKnownTypesStart](5005-importknowntypesstart.md)
+# [4816 - FindInitiatedInDiscoveryClientChannel](4816-findinitiatedindiscoveryclientchannel.md)
+# [3357 - SecurityIdentityVerificationFailure](3357-securityidentityverificationfailure.md)
+# [509 - ServiceHostOpenStart](509-servicehostopenstart.md)
+# [1419 - MaxPendingConnectionsExceeded](1419-maxpendingconnectionsexceeded.md)
+# [分析トレース イベント リファレンス](analytic-trace-event-reference.md)
+# [5016 - GenXmlSerializableStart](5016-genxmlserializablestart.md)
+# [4026 - WasConnected](4026-wasconnected.md)
+# [401- StopSignPostEvent](401-stopsignpostevent.md)
+# [3364 - SharedListenerProxyRegisterStart](3364-sharedlistenerproxyregisterstart.md)
+# [208 - MessageInspectorAfterReceiveInvoked](208-messageinspectorafterreceiveinvoked.md)
+# [3388 - HttpGetContextStart](3388-httpgetcontextstart.md)
+# [3369 - SslOnAcceptUpgrade](3369-sslonacceptupgrade.md)
+# [3831 - RoutingServiceHandledException](3831-routingservicehandledexception.md)
+# [3368 - SslOnInitiateUpgrade](3368-ssloninitiateupgrade.md)
+# [4811 - DiscoveryMessageWithNullRelatesTo](4811-discoverymessagewithnullrelatesto.md)
+# [4015 - MessageQueueRegisterCompleted](4015-messagequeueregistercompleted.md)
+# [3306 - ClientBaseChannelFactoryAgedOutofCache](3306-clientbasechannelfactoryagedoutofcache.md)
+# [4014 - MessageQueueRegisterFailed](4014-messagequeueregisterfailed.md)
+# [4809 - DiscoveryMessageWithNullMessageId](4809-discoverymessagewithnullmessageid.md)
+# [3321 - ConnectionPoolMiss](3321-connectionpoolmiss.md)
+# [502 - CompilationStop](502-compilationstop.md)
+# [57402 - TraceCodeEventLogVerbose](57402-tracecodeeventlogverbose.md)
+# [3398 - PipeSharedMemoryCreated](3398-pipesharedmemorycreated.md)
+# [513 - WebHostRequestStart](513-webhostrequeststart.md)
+# [4033 - RoutingTableLookupStart](4033-routingtablelookupstart.md)
+# [5402 - TokenValidationStarted](5402-tokenvalidationstarted.md)
+# [1420 - ReaderQuotaExceeded](1420-readerquotaexceeded.md)
+# [3419 - WebSocketConnectionDeclined](3419-websocketconnectiondeclined.md)
+# [1418 - MaxOutboundConnectionsPerEndpointExceeded](1418-maxoutboundconnectionsperendpointexceeded.md)
+# [507 - HostedTransportConfigurationManagerConfigInitStart](507-hostedtransportconfigurationmanagerconfiginitstart.md)
+# [4022 - WebhostUnregisterProtocolFailed](4022-webhostunregisterprotocolfailed.md)
+# [3312 - MessageReadByEncoder](3312-messagereadbyencoder.md)
+# [4815 - EndpointDiscoverabilityEnabled](4815-endpointdiscoverabilityenabled.md)
+# [1441 - MaxSessionSizeReached](1441-maxsessionsizereached.md)
+# [3428 - WebSocketConnectionClosed](3428-websocketconnectionclosed.md)
+# [4031 - DispatchSessionFailed](4031-dispatchsessionfailed.md)
+# [57394 - HandledException](57394-handledexception.md)
+# [1430 - PendingConnectionsRatio](1430-pendingconnectionsratio.md)
+# [3427 - WebSocketCloseOutputSent](3427-websocketcloseoutputsent.md)
+# [3325 - DispatchFormatterSerializeReplyStop](3325-dispatchformatterserializereplystop.md)
+# [4818 - InnerChannelOpenFailed](4818-innerchannelopenfailed.md)
+# [5015 - DCJsonGenWriterStop](5015-dcjsongenwriterstop.md)
+# [3378 - SocketAsyncReadStop](3378-socketasyncreadstop.md)
+# [3358 - PortSharingDuplicatedSocket](3358-portsharingduplicatedsocket.md)
+# [3329 - ClientFormatterDeserializeReplyStop](3329-clientformatterdeserializereplystop.md)
+# [3815 - RoutingServiceProcessingMessage](3815-routingserviceprocessingmessage.md)
+# [514 - WebHostRequestStop](514-webhostrequeststop.md)
+# [3372 - TextMessageEncodingStart](3372-textmessageencodingstart.md)
+# [4813 - DuplicateDiscoveryMessage](4813-duplicatediscoverymessage.md)
+# [3412 - HttpPipelineProcessResponseStart](3412-httppipelineprocessresponsestart.md)
+# [3335 - GetServiceInstanceStart](3335-getserviceinstancestart.md)
+# [3389 - ClientSendPreambleStart](3389-clientsendpreamblestart.md)
+# [1406 - ReceiveTimeout](1406-receivetimeout.md)
+# [4817 - InnerChannelCreationFailed](4817-innerchannelcreationfailed.md)
+# [3340 - PipeConnectionAcceptStart](3340-pipeconnectionacceptstart.md)
+# [211 - ParameterInspectorAfterCallInvoked](211-parameterinspectoraftercallinvoked.md)
+# [1422 - NegotiateTokenAuthenticatorStateCacheExceeded](1422-negotiatetokenauthenticatorstatecacheexceeded.md)
+# [3819 - RoutingServiceMovedToBackup](3819-routingservicemovedtobackup.md)
+# [3405 - EncryptedDataProcessingStart](3405-encrypteddataprocessingstart.md)
+# [215 - MessageReceivedByTransport](215-messagereceivedbytransport.md)
+# [3556 - CreateWorkflowServiceHostStop](3556-createworkflowservicehoststop.md)
+# [4012 - MessageQueueRegisterAbort](4012-messagequeueregisterabort.md)
+# [3320 - SocketAccepted](3320-socketaccepted.md)
+# [203 - ClientParameterInspectorAfterCallInvoked](203-clientparameterinspectoraftercallinvoked.md)
+# [3560 - ServiceActivationAvailableMemory](3560-serviceactivationavailablememory.md)
+# [5405 - GetIssuerNameSuccess](5405-getissuernamesuccess.md)
+# [207 - FaultProviderInvoked](207-faultproviderinvoked.md)
+# [3824 - RoutingServiceCompletingReceiveContext](3824-routingservicecompletingreceivecontext.md)
+# [226 - IdleServicesClosed](226-idleservicesclosed.md)
+# [5603 - FederationMessageCreationSuccess](5603-federationmessagecreationsuccess.md)
+# [3429 - WebSocketCloseStatusReceived](3429-websocketclosestatusreceived.md)
+# [4814 - EndpointDiscoverabilityDisabled](4814-endpointdiscoverabilitydisabled.md)
+# [3351 - ServerMaxPooledConnectionsQuotaReached](3351-servermaxpooledconnectionsquotareached.md)
+# [3423 - WebSocketAsyncWriteStop](3423-websocketasyncwritestop.md)
+# [3371 - MtomMessageEncodingStart](3371-mtommessageencodingstart.md)
+# [218 - ClientOperationCompleted](218-clientoperationcompleted.md)
+# [3302 - ReceiveContextFaulted](3302-receivecontextfaulted.md)
+# [709 - DispatchMessageStart](709-dispatchmessagestart.md)
+# [220 - MessageSentToTransport](220-messagesenttotransport.md)
+# [3805 - RoutingServiceDisplayConfig](3805-routingservicedisplayconfig.md)
+# [分析トレースの概要](analytic-tracing-overview.md)
+# [217 - ClientOperationPrepared](217-clientoperationprepared.md)
+# [3313 - MessageWrittenByEncoder](3313-messagewrittenbyencoder.md)
+# [4011 - MessageQueueRegisterStart](4011-messagequeueregisterstart.md)
+# [3818 - RoutingServiceDuplexCallbackException](3818-routingserviceduplexcallbackexception.md)
+# [701 - ServiceChannelOpenStart](701-servicechannelopenstart.md)
+# [4810 - DiscoveryMessageWithNullMessageSequence](4810-discoverymessagewithnullmessagesequence.md)
+# [3337 - ChannelReceiveStart](3337-channelreceivestart.md)
+# [5602 - FederationMessageCreationStarted](5602-federationmessagecreationstarted.md)
+# [3367 - ConnectionPoolPreambleFailed](3367-connectionpoolpreamblefailed.md)
+# [1432 - ConcurrentSessionsRatio](1432-concurrentsessionsratio.md)
+# [3347 - SocketAcceptClosed](3347-socketacceptclosed.md)
+# [3816 - RoutingServiceTransmittingMessage](3816-routingservicetransmittingmessage.md)
+# [3309 - QueryCompositionExecuted](3309-querycompositionexecuted.md)
+# [3324 - DispatchFormatterSerializeReplyStart](3324-dispatchformatterserializereplystart.md)
+# [3365 - SharedListenerProxyRegisterStop](3365-sharedlistenerproxyregisterstop.md)
+# [3375 - TextMessageDecodingStart](3375-textmessagedecodingstart.md)
+# [213 - ServiceHostStarted](213-servicehoststarted.md)
+# [214 - OperationCompleted](214-operationcompleted.md)
+# [1439 - PendingAcceptsAtZero](1439-pendingacceptsatzero.md)
+# [4812 - DiscoveryMessageWithNullReplyTo](4812-discoverymessagewithnullreplyto.md)
+# [710 - HttpContextBeforeProcessAuthentication](710-httpcontextbeforeprocessauthentication.md)
+# [4001 - TransportListenerSessionsReceived](4001-transportlistenersessionsreceived.md)
+# [703 - ServiceChannelCallStart](703-servicechannelcallstart.md)
+# [133 - ActionItemScheduled](133-actionitemscheduled.md)
+# [717 - HttpSendStreamedMessageStart](717-httpsendstreamedmessagestart.md)
+# [5008 - DCGenWriterStart](5008-dcgenwriterstart.md)
+# [301 - UserDefinedErrorOccurred](301-userdefinederroroccurred.md)
+# [3314 - SessionIdleTimeout](3314-sessionidletimeout.md)
+# [201 - ClientMessageInspectorAfterReceiveInvoked](201-clientmessageinspectorafterreceiveinvoked.md)
+# [3334 - IncomingMessageVerified](3334-incomingmessageverified.md)
+# [3391 - HttpMessageReceiveFailed](3391-httpmessagereceivefailed.md)
+# [1442 - ReceiveRetryCountReached](1442-receiveretrycountreached.md)
+# [4801 - DiscoveryClientInClientChannelFailedToClose](4801-discoveryclientinclientchannelfailedtoclose.md)
+# [3417 - WebSocketConnectionAcceptStart](3417-websocketconnectionacceptstart.md)
+# [205 - OperationInvoked](205-operationinvoked.md)
+# [3807 - RoutingServiceCompletingTwoWay](3807-routingservicecompletingtwoway.md)
+# [3384 - WindowsStreamSecurityOnInitiateUpgrade](3384-windowsstreamsecurityoninitiateupgrade.md)
+# [3377 - SocketReadStop](3377-socketreadstop.md)
+# [3339 - ChannelFactoryCreated](3339-channelfactorycreated.md)
+# [206 - ErrorHandlerInvoked](206-errorhandlerinvoked.md)
+# [3349 - ListenerOpenStart](3349-listeneropenstart.md)
+# [1400 - ChannelInitializationTimeout](1400-channelinitializationtimeout.md)
+# [4023 - WasCloseAllListenerChannelInstancesCompleted](4023-wasclosealllistenerchannelinstancescompleted.md)
+# [134 - ActionItemCallbackInvoked](134-actionitemcallbackinvoked.md)
+# [3322 - DispatchFormatterDeserializeRequestStart](3322-dispatchformatterdeserializerequeststart.md)
+# [3362 - HttpChannelResponseAborted](3362-httpchannelresponseaborted.md)
+# [4027 - WasDisconnected](4027-wasdisconnected.md)
+# [3307 - ClientBaseChannelFactoryCacheHit](3307-clientbasechannelfactorycachehit.md)
+# [3827 - RoutingServiceTransmitFailed](3827-routingservicetransmitfailed.md)
+# [4032 - WasConnectionTimedout](4032-wasconnectiontimedout.md)
+# [3558 - ServiceActivationStart](3558-serviceactivationstart.md)
+# [3409 - HttpPipelineProcessInboundRequestStop](3409-httppipelineprocessinboundrequeststop.md)
+# [3363 - HttpAuthFailed](3363-httpauthfailed.md)
+# [302 - UserDefinedWarningOccurred](302-userdefinedwarningoccurred.md)
+# [3803 - RoutingServiceProcessingFailure](3803-routingserviceprocessingfailure.md)
+# [4002 - FailFastException](4002-failfastexception.md)
+# [3394 - StreamedMessageWrittenByEncoder](3394-streamedmessagewrittenbyencoder.md)
+# [4034 - RoutingTableLookupStop](4034-routingtablelookupstop.md)
+# [4820 - SynchronizationContextReset](4820-synchronizationcontextreset.md)
+# [57400 - TraceCodeEventLogError](57400-tracecodeeventlogerror.md)
+# [3828 - RoutingServiceFilterTableMatchStart](3828-routingservicefiltertablematchstart.md)
+# [3319 - SocketAcceptEnqueued](3319-socketacceptenqueued.md)
+# [4029 - PipeTransportListenerListeningStop](4029-pipetransportlistenerlisteningstop.md)
+# [3323 - DispatchFormatterDeserializeRequestStop](3323-dispatchformatterdeserializerequeststop.md)
+# [3817 - RoutingServiceCommittingTransaction](3817-routingservicecommittingtransaction.md)
+# [3341 - PipeConnectionAcceptStop](3341-pipeconnectionacceptstop.md)
+# [3413 - HttpPipelineBeginProcessResponseStart](3413-httppipelinebeginprocessresponsestart.md)
+# [3410 - HttpPipelineFaulted](3410-httppipelinefaulted.md)
+# [5009 - DCGenWriterStop](5009-dcgenwriterstop.md)
+# [3823 - RoutingServiceSendingFaultResponse](3823-routingservicesendingfaultresponse.md)
+# [3330 - SecurityNegotiationStart](3330-securitynegotiationstart.md)
+# [5203 - JsonMessageDecodingStart](5203-jsonmessagedecodingstart.md)
+# [3352 - TcpConnectionTimedOut](3352-tcpconnectiontimedout.md)
+# [3431 - WebSocketCreateClientWebSocketWithFactory](3431-websocketcreateclientwebsocketwithfactory.md)
+# [224 - MessageThrottleAtSeventyPercent](224-messagethrottleatseventypercent.md)
+# [706 - HttpSendMessageStart](706-httpsendmessagestart.md)
+# [204 - ClientParameterInspectorBeforeCallInvoked](204-clientparameterinspectorbeforecallinvoked.md)
+# [3327 - ClientFormatterSerializeRequestStop](3327-clientformatterserializerequeststop.md)
+# [57404 - HandledExceptionWarning](57404-handledexceptionwarning.md)
+# [219 - ServiceException](219-serviceexception.md)
+# [3359 - SecurityImpersonationSuccess](3359-securityimpersonationsuccess.md)
+# [4807 - DiscoveryMessageWithInvalidReplyTo](4807-discoverymessagewithinvalidreplyto.md)
+# [601 - CBAEntryRead](601-cbaentryread.md)
+# [209 - MessageInspectorBeforeSendInvoked](209-messageinspectorbeforesendinvoked.md)
+# [5011 - DCGenReaderStop](5011-dcgenreaderstop.md)
+# [3408 - HttpPipelineBeginProcessInboundRequestStart](3408-httppipelinebeginprocessinboundrequeststart.md)
+# [3332 - SecurityTokenProviderOpened](3332-securitytokenprovideropened.md)
+# [5601 - FederationMessageProcessingSuccess](5601-federationmessageprocessingsuccess.md)
+# [604 - AspNetRoute](604-aspnetroute.md)
+# [4028 - PipeTransportListenerListeningStart](4028-pipetransportlistenerlisteningstart.md)
+# [4024 - WasCloseAllListenerChannelInstancesFailed](4024-wasclosealllistenerchannelinstancesfailed.md)
+# [5604 - SessionCookieReadingStarted](5604-sessioncookiereadingstarted.md)
+# [3832 - RoutingServiceTransmitSucceeded](3832-routingservicetransmitsucceeded.md)
+# [3374 - MtomMessageDecodingStart](3374-mtommessagedecodingstart.md)
+# [3414 - HttpPipelineProcessResponseStop](3414-httppipelineprocessresponsestop.md)
+# [3393 - StreamedMessageReadByEncoder](3393-streamedmessagereadbyencoder.md)
+# [704 - ServiceChannelBeginCallStart](704-servicechannelbegincallstart.md)
+# [3406 - EncryptedDataProcessingSuccess](3406-encrypteddataprocessingsuccess.md)
+# [5013 - DCJsonGenReaderStop](5013-dcjsongenreaderstop.md)
+# [3425 - WebSocketAsyncReadStop](3425-websocketasyncreadstop.md)
+# [3300 - ReceiveContextCompleteFailed](3300-receivecontextcompletefailed.md)
+# [5012 - DCJsonGenReaderStart](5012-dcjsongenreaderstart.md)
+# [3421 - WebSocketConnectionAborted](3421-websocketconnectionaborted.md)
+# [4020 - TcpTransportListenerListeningStart](4020-tcptransportlistenerlisteningstart.md)
+# [3310 - DispatchFailed](3310-dispatchfailed.md)
+# [222 - OperationFailed](222-operationfailed.md)
+# [602 - CBAMatchFound](602-cbamatchfound.md)
+# [3305 - ClientBaseCachedChannelFactoryCount](3305-clientbasecachedchannelfactorycount.md)
+# [503 - ServiceHostFactoryCreationStart](503-servicehostfactorycreationstart.md)
+# [1445 - ReadPoolMiss](1445-readpoolmiss.md)
+# [3311 - DispatchSuccessful](3311-dispatchsuccessful.md)
+# [3418 - WebSocketConnectionAccepted](3418-websocketconnectionaccepted.md)
+# [3350 - ListenerOpenStop](3350-listeneropenstop.md)
+# [5002 - DCSerializeWithSurrogateStop](5002-dcserializewithsurrogatestop.md)
+# [3331 - SecurityNegotiationStop](3331-securitynegotiationstop.md)
+# [4030 - DispatchSessionSuccess](4030-dispatchsessionsuccess.md)
+# [57401 - TraceCodeEventLogInfo](57401-tracecodeeventloginfo.md)
+# [1423 - NegotiateTokenAuthenticatorStateCacheRatio](1423-negotiatetokenauthenticatorstatecacheratio.md)
+# [715 - ClientChannelOpenStart](715-clientchannelopenstart.md)
+# [3370 - BinaryMessageEncodingStart](3370-binarymessageencodingstart.md)
+# [4804 - DiscoveryMessageReceivedAfterOperationCompleted](4804-discoverymessagereceivedafteroperationcompleted.md)
+# [1401 - CloseTimeout](1401-closetimeout.md)
+# [4003 - ServiceStartPipeError](4003-servicestartpipeerror.md)
+# [1443 - MaxRetryCyclesExceededMsmq](1443-maxretrycyclesexceededmsmq.md)
+# [505 - CreateServiceHostStart](505-createservicehoststart.md)
+# [1433 - OutboundConnectionsPerEndpointRatio](1433-outboundconnectionsperendpointratio.md)
+# [3360 - SecurityImpersonationFailure](3360-securityimpersonationfailure.md)
+# [303 - UserDefinedInformationEventOccured](303-userdefinedinformationeventoccured.md)
+# [402 - StartSignpostEvent](402-startsignpostevent.md)
+# [712 - DispatchMessageStop](712-dispatchmessagestop.md)
+# [501 - CompilationStart](501-compilationstart.md)
+# [707 - HttpSendStop](707-httpsendstop.md)
+# [サービス操作エラーの監視](monitoring-service-operation-failures.md)
+# [分析トレースの動的な有効化](dynamically-enabling-analytic-tracing.md)
+# [3821 - RoutingServiceCloseFailed](3821-routingserviceclosefailed.md)
+# [1402 - IdleTimeout](1402-idletimeout.md)
+# [3559 - ServiceActivationStop](3559-serviceactivationstop.md)
+# [1431 - ConcurrentCallsRatio](1431-concurrentcallsratio.md)
+# [4802 - DiscoveryClientProtocolExceptionSuppressed](4802-discoveryclientprotocolexceptionsuppressed.md)
+# [716 - ClientChannelOpenStop](716-clientchannelopenstop.md)
+# [5600 - FederationMessageProcessingStarted](5600-federationmessageprocessingstarted.md)
+# [3355 - SecurityNegotiationProcessingFailure](3355-securitynegotiationprocessingfailure.md)
+# [3356 - SecurityIdentityVerificationSuccess](3356-securityidentityverificationsuccess.md)
+# [57396 - ThrowingException](57396-throwingexception.md)
+# [3343 - EstablishConnectionStop](3343-establishconnectionstop.md)
+# [3422 - WebSocketAsyncWriteStart](3422-websocketasyncwritestart.md)
+# [4016 - MessageQueueDuplicatedSocketError](4016-messagequeueduplicatedsocketerror.md)
+# [603 - AspNetRoutingService](603-aspnetroutingservice.md)
+# [4803 - DiscoveryClientReceivedMulticastSuppression](4803-discoveryclientreceivedmulticastsuppression.md)
+# [221 - MessageReceivedFromTransport](221-messagereceivedfromtransport.md)
+# [5003 - DCDeserializeWithSurrogateStart](5003-dcdeserializewithsurrogatestart.md)
+# [1446 - WritePoolMiss](1446-writepoolmiss.md)
+# [4808 - DiscoveryMessageWithNoContent](4808-discoverymessagewithnocontent.md)
+# [4008 - DispatchSessionStart](4008-dispatchsessionstart.md)
+# [451 - MessageLogInfo](451-messageloginfo.md)
+# [4600 - MessageLogEventSizeExceeded](4600-messagelogeventsizeexceeded.md)
+# [3822 - RoutingServiceSendingResponse](3822-routingservicesendingresponse.md)
+# [3336 - GetServiceInstanceStop](3336-getserviceinstancestop.md)
+# [1405 - OpenTimeout](1405-opentimeout.md)
+# [4025 - OpenListenerChannelInstanceFailed](4025-openlistenerchannelinstancefailed.md)
+# [3301 - ReceiveContextAbandonFailed](3301-receivecontextabandonfailed.md)
+# [5001 - DCSerializeWithSurrogateStart](5001-dcserializewithsurrogatestart.md)
+# [3381 - SequenceAcknowledgementSent](3381-sequenceacknowledgementsent.md)
+# [5017 - GenXmlSerializableStop](5017-genxmlserializablestop.md)
+# [3328 - ClientFormatterDeserializeReplyStart](3328-clientformatterdeserializereplystart.md)
+# [3825 - RoutingServiceAbandoningReceiveContext](3825-routingserviceabandoningreceivecontext.md)
+# [606 - DecrementBusyCount](606-decrementbusycount.md)
+# [5004 - DCDeserializeWithSurrogateStop](5004-dcdeserializewithsurrogatestop.md)
+# [3385 - WindowsStreamSecurityOnAcceptUpgrade](3385-windowsstreamsecurityonacceptupgrade.md)
+# [1417 - MaxSentMessageSizeExceeded](1417-maxsentmessagesizeexceeded.md)
+# [404 - ResumeSignpostEvent](404-resumesignpostevent.md)
+# [1403 - LeaseTimeout](1403-leasetimeout.md)
+# [1409 - InactivityTimeout](1409-inactivitytimeout.md)
+# [57395 - ShipAssertExceptionMessage](57395-shipassertexceptionmessage.md)
+# [3376 - HttpResponseReceiveStart](3376-httpresponsereceivestart.md)
+# [3386 - SocketConnectionAbort](3386-socketconnectionabort.md)
+# [3404 - WrappedKeyDecryptionSuccess](3404-wrappedkeydecryptionsuccess.md)
+# [3802 - RoutingServiceCompletingOneWay](3802-routingservicecompletingoneway.md)
+# [605 - IncrementBusyCount](605-incrementbusycount.md)
+# [510 - ServiceHostOpenStop](510-servicehostopenstop.md)
+# [3829 - RoutingServiceFilterTableMatchStop](3829-routingservicefiltertablematchstop.md)
+# [1438 - ConcurrentInstancesRatio](1438-concurrentinstancesratio.md)
+# [5403 - TokenValidationSuccess](5403-tokenvalidationsuccess.md)
+# [3415 - WebSocketConnectionRequestSendStart](3415-websocketconnectionrequestsendstart.md)
+# [223 - OperationFaulted](223-operationfaulted.md)
+# [3342 - EstablishConnectionStart](3342-establishconnectionstart.md)
+# [3426 - WebSocketCloseSent](3426-websocketclosesent.md)
+# [5006 - ImportKnownTypesStop](5006-importknowntypesstop.md)
+# [4019 - MessageQueueDuplicatedSocketComplete](4019-messagequeueduplicatedsocketcomplete.md)
+# [3402 - SignatureVerificationSuccess](3402-signatureverificationsuccess.md)
+# [5605 - SessionCookieReadingSuccess](5605-sessioncookiereadingsuccess.md)
+# [4805 - DiscoveryMessageWithInvalidContent](4805-discoverymessagewithinvalidcontent.md)
+# [3392 - TransactionScopeCreate](3392-transactionscopecreate.md)
+# [3366 - SharedListenerProxyRegisterFailed](3366-sharedlistenerproxyregisterfailed.md)
+# [504 - ServiceHostFactoryCreationStop](504-servicehostfactorycreationstop.md)
+# [3403 - WrappedKeyDecryptionStart](3403-wrappedkeydecryptionstart.md)
+# [3379 - SocketWriteStart](3379-socketwritestart.md)
+# [210 - MessageThrottleExceeded](210-messagethrottleexceeded.md)
+# [508 - HostedTransportConfigurationManagerConfigInitStop](508-hostedtransportconfigurationmanagerconfiginitstop.md)
+# [3553 - XamlServicesLoadStart](3553-xamlservicesloadstart.md)
+# [452 - MessageLogWarning](452-messagelogwarning.md)
+# [3416 - WebSocketConnectionRequestSendStop](3416-websocketconnectionrequestsendstop.md)
+# [3809 - RoutingServiceMessageRoutedToEndpoints](3809-routingservicemessageroutedtoendpoints.md)
+# [3333 - OutgoingMessageSecured](3333-outgoingmessagesecured.md)
+# [3373 - BinaryMessageDecodingStart](3373-binarymessagedecodingstart.md)
+# [1436 - PendingMessagesPerChannelRatio](1436-pendingmessagesperchannelratio.md)
+# [3411 - HttpPipelineTimeoutException](3411-httppipelinetimeoutexception.md)
+# [4819 - InnerChannelOpenSucceeded](4819-innerchannelopensucceeded.md)
+# [1407 - SendTimeout](1407-sendtimeout.md)
+# [3380 - SocketAsyncWriteStart](3380-socketasyncwritestart.md)
+# [131 - BufferPoolAllocation](131-bufferpoolallocation.md)
+# [Analytic Tracing with ETW](index.md)
+# [3554 - XamlServicesLoadStop](3554-xamlservicesloadstop.md)
+# [3326 - ClientFormatterSerializeRequestStart](3326-clientformatterserializerequeststart.md)
+# [3810 - RoutingServiceConfigurationApplied](3810-routingserviceconfigurationapplied.md)
+# [3397 - BufferedAsyncWriteStop](3397-bufferedasyncwritestop.md)
+# [3420 - WebSocketConnectionFailed](3420-websocketconnectionfailed.md)
+# [3348 - ServiceHostFaulted](3348-servicehostfaulted.md)
+# [4806 - DiscoveryMessageWithInvalidRelatesToOrOperationCompleted](4806-discoverymessagewithinvalidrelatestooroperationcompleted.md)
+# [3353 - TcpConnectionResetError](3353-tcpconnectionreseterror.md)
+# [5010 - DCGenReaderStart](5010-dcgenreaderstart.md)
+# [5404 - TokenValidationFailure](5404-tokenvalidationfailure.md)
+# [702 - ServiceChannelOpenStop](702-servicechannelopenstop.md)
+# [4013 - MessageQueueUnregisterSucceeded](4013-messagequeueunregistersucceeded.md)
+# [3399 - NamedPipeCreated](3399-namedpipecreated.md)
+# [5007 - DCResolverResolve](5007-dcresolverresolve.md)
+# [メッセージ フローのトレースの構成](configuring-message-flow-tracing.md)
+# [216 - MessageSentByTransport](216-messagesentbytransport.md)
+# [4010 - PendingSessionQueueFull](4010-pendingsessionqueuefull.md)
+# [3555 - CreateWorkflowServiceHostStart](3555-createworkflowservicehoststart.md)
+# [3346 - ConnectionReaderSendFault](3346-connectionreadersendfault.md)
+# [3820 - RoutingServiceCreatingTransaction](3820-routingservicecreatingtransaction.md)
+# [4821 - SynchronizationContextSetToNull](4821-synchronizationcontextsettonull.md)
+# [57399 - TraceCodeEventLogCritical](57399-tracecodeeventlogcritical.md)
+# [3800 - RoutingServiceClosingClient](3800-routingserviceclosingclient.md)
+# [1451 - MaxRetryCyclesExceeded](1451-maxretrycyclesexceeded.md)
+# [202 - ClientMessageInspectorBeforeSendInvoked](202-clientmessageinspectorbeforesendinvoked.md)
+# [3354 - ServiceSecurityNegotiationCompleted](3354-servicesecuritynegotiationcompleted.md)
+# [499 - TransferEmitted](499-transferemitted.md)
+# [3801 - RoutingServiceChannelFaulted](3801-routingservicechannelfaulted.md)
+# [212 - ParameterInspectorBeforeCallInvoked](212-parameterinspectorbeforecallinvoked.md)
+# [57397 - UnhandledException](57397-unhandledexception.md)
+# [5014 - DCJsonGenWriterStart](5014-dcjsongenwriterstart.md)
+# [3382 - ClientReliableSessionReconnect](3382-clientreliablesessionreconnect.md)
+# [3361 - HttpChannelRequestAborted](3361-httpchannelrequestaborted.md)
+# [4021 - TcpTransportListenerListeningStop](4021-tcptransportlistenerlisteningstop.md)
diff --git a/docs/framework/wcf/diagnostics/etw/analytic-trace-event-reference.md b/docs/framework/wcf/diagnostics/etw/analytic-trace-event-reference.md
new file mode 100644
index 00000000000..8e5c995e43d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/analytic-trace-event-reference.md
@@ -0,0 +1,380 @@
+---
+title: "分析トレース イベント リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "分析トレース [WCF] リファレンス"
+ms.assetid: e44540cf-44a1-4efc-b965-7fbfd2131d73
+caps.latest.revision: 50
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 50
+---
+# 分析トレース イベント リファレンス
+次の表に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の分析トレースに関連するイベント レベル、識別子、およびメッセージの定義を示します。  
+  
+## イベント リファレンス  
+  
+|イベント ID|イベント レベル|イベント メッセージ|キーワード|  
+|-------------|--------------|----------------|-----------|  
+|[131 \- BufferPoolAllocation](../../../../../docs/framework/wcf/diagnostics/etw/131-bufferpoolallocation.md)|詳細|プールが %1 バイトを割り当てています。|インフラストラクチャ|  
+|[132 \- BufferPoolChangeQuota](../../../../../docs/framework/wcf/diagnostics/etw/132-bufferpoolchangequota.md)|詳細|BufferPool のサイズ: %1、クォータの変更: %2。|インフラストラクチャ|  
+|[133 \- ActionItemScheduled](../../../../../docs/framework/wcf/diagnostics/etw/133-actionitemscheduled.md)|詳細|IO スレッド スケジューラのコールバックが呼び出されました。|インフラストラクチャ|  
+|[134 \- ActionItemCallbackInvoked](../../../../../docs/framework/wcf/diagnostics/etw/134-actionitemcallbackinvoked.md)|詳細|IO スレッド スケジューラのコールバックが呼び出されました。|インフラストラクチャ|  
+|[201 \- ClientMessageInspectorAfterReceiveInvoked](../../../../../docs/framework/wcf/diagnostics/etw/201-clientmessageinspectorafterreceiveinvoked.md)|情報|ディスパッチャーが型 '%1' の ClientMessageInspector で 'AfterReceiveReply' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[202 \- ClientMessageInspectorBeforeSendInvoked](../../../../../docs/framework/wcf/diagnostics/etw/202-clientmessageinspectorbeforesendinvoked.md)|情報|ディスパッチャーが型 '%1' の ClientMessageInspector で 'BeforeSendRequest' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[203 \- ClientParameterInspectorAfterCallInvoked](../../../../../docs/framework/wcf/diagnostics/etw/203-clientparameterinspectoraftercallinvoked.md)|情報|ディスパッチャーが  型 '%1' の ClientParameterInspector で 'AfterCall' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[204 \- ClientParameterInspectorBeforeCallInvoked](../../../../../docs/framework/wcf/diagnostics/etw/204-clientparameterinspectorbeforecallinvoked.md)|情報|ディスパッチャーが型 '%1' の ClientParameterInspector で 'BeforeCall' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[205 \- OperationInvoked](../../../../../docs/framework/wcf/diagnostics/etw/205-operationinvoked.md)|情報|OperationInvoker が '%1' メソッドを呼び出しました。|EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[206 \- ErrorHandlerInvoked](../../../../../docs/framework/wcf/diagnostics/etw/206-errorhandlerinvoked.md)|情報|ディスパッチャーが型 '%1' の ErrorHandler を呼び出し、種類 '%3' の例外がスローされました。  ErrorHandled \=\= '%2'。|Troubleshooting、ServiceModel|  
+|[207 \- FaultProviderInvoked](../../../../../docs/framework/wcf/diagnostics/etw/207-faultproviderinvoked.md)|情報|ディスパッチャーが型 '%1' の FaultProvider を呼び出し、種類 '%2' の例外がスローされました。|Troubleshooting、ServiceModel|  
+|[208 \- MessageInspectorAfterReceiveInvoked](../../../../../docs/framework/wcf/diagnostics/etw/208-messageinspectorafterreceiveinvoked.md)|情報|ディスパッチャーが型 '%1' の MessageInspector で 'AfterReceiveReply' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[209 \- MessageInspectorBeforeSendInvoked](../../../../../docs/framework/wcf/diagnostics/etw/209-messageinspectorbeforesendinvoked.md)|情報|ディスパッチャーが型 '%1' の MessageInspector で 'BeforeSendRequest' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[210 \- MessageThrottleExceeded](../../../../../docs/framework/wcf/diagnostics/etw/210-messagethrottleexceeded.md)|警告|スロットル '%1' の '%2' の制限に達しました。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[211 \- ParameterInspectorAfterCallInvoked](../../../../../docs/framework/wcf/diagnostics/etw/211-parameterinspectoraftercallinvoked.md)|情報|ディスパッチャーが型 '%1' の ParameterInspector で 'AfterCall' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[212 \- ParameterInspectorBeforeCallInvoked](../../../../../docs/framework/wcf/diagnostics/etw/212-parameterinspectorbeforecallinvoked.md)|情報|ディスパッチャーが型 '%1' の ParameterInspector で 'BeforeCall' を呼び出しました。|Troubleshooting、ServiceModel|  
+|[213 \- ServiceHostStarted](../../../../../docs/framework/wcf/diagnostics/etw/213-servicehoststarted.md)|LogAlways \(常にログ\)|ServiceHost は '%1' で開始されています。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[214 \- OperationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/214-operationcompleted.md)|情報|OperationInvoker がメソッド '%1' への呼び出しを完了しました。  メソッド呼び出し時間は '%2' ミリ秒でした。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[215 \- MessageReceivedByTransport](../../../../../docs/framework/wcf/diagnostics/etw/215-messagereceivedbytransport.md)|情報|トランスポートが '%1' からメッセージを受信しました。|Troubleshooting、ServiceModel|  
+|[216 \- MessageSentByTransport](../../../../../docs/framework/wcf/diagnostics/etw/216-messagesentbytransport.md)|情報|トランスポートが '%1' にメッセージを送信しました。|Troubleshooting、ServiceModel|  
+|[217 \- ClientOperationPrepared](../../../../../docs/framework/wcf/diagnostics/etw/217-clientoperationprepared.md)|情報|クライアントは '%2' コントラクトと関連付けられている Action '%1' を実行しています。  メッセージは '%3' に送信されます。|Troubleshooting、ServiceModel|  
+|[218 \- ClientOperationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/218-clientoperationcompleted.md)|情報|クライアントは '%1' コントラクトと関連付けられている Action '%1' の実行を完了しました。  メッセージは '%3' に送信されました。|Troubleshooting、ServiceModel|  
+|[219 \- ServiceException](../../../../../docs/framework/wcf/diagnostics/etw/219-serviceexception.md)|Error|メッセージの処理中に種類 '%2' のハンドルされない例外がスローされました。  完全な例外 ToString: %1。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[220 \- MessageSentToTransport](../../../../../docs/framework/wcf/diagnostics/etw/220-messagesenttotransport.md)|情報|ディスパッチャーがトランスポートにメッセージを送信しました。  関連付け ID \=\= '%1'。|EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[221 \- MessageReceivedFromTransport](../../../../../docs/framework/wcf/diagnostics/etw/221-messagereceivedfromtransport.md)|情報|ディスパッチャーがトランスポートからメッセージを受信しました。  関連付け ID \=\= '%1'。|EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[222 \- OperationFailed](../../../../../docs/framework/wcf/diagnostics/etw/222-operationfailed.md)|警告|OperationInvoker によって呼び出されたメソッド '%1' で、ハンドルされない例外がスローされました。  メソッド呼び出し時間は '%2' ミリ秒でした。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[223 \- OperationFaulted](../../../../../docs/framework/wcf/diagnostics/etw/223-operationfaulted.md)|警告|OperationInvoker によって呼び出されたメソッド '%1' で FaultException がスローされました。  メソッド呼び出し時間は '%2' ミリ秒でした。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[224 \- MessageThrottleAtSeventyPercent](../../../../../docs/framework/wcf/diagnostics/etw/224-messagethrottleatseventypercent.md)|警告|スロットル '%1' の '%2' の制限は 70% です。|HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[226 \- IdleServicesClosed](../../../../../docs/framework/wcf/diagnostics/etw/226-idleservicesclosed.md)|LogAlways \(常にログ\)|アクティブ化された合計 %2 個のサービスのうち、アイドル状態の %1 個のサービスが閉じられました。|HealthMonitoring WebHost|  
+|[301 \- UserDefinedErrorOccurred](../../../../../docs/framework/wcf/diagnostics/etw/301-userdefinederroroccurred.md)|Error|名前: '%1'、参照: '%2'、ペイロード: %3|UserEvents、HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[302 \- UserDefinedWarningOccurred](../../../../../docs/framework/wcf/diagnostics/etw/302-userdefinedwarningoccurred.md)|警告|名前: '%1'、参照: '%2'、ペイロード: %3|UserEvents、HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[303 \- UserDefinedInformationEventOccured](../../../../../docs/framework/wcf/diagnostics/etw/303-userdefinedinformationeventoccured.md)|情報|名前: '%1'、参照: '%2'、ペイロード: %3|UserEvents、HealthMonitoring、EndToEndMonitoring、Troubleshooting、ServiceModel|  
+|[401\- StopSignPostEvent](../../../../../docs/framework/wcf/diagnostics/etw/401-stopsignpostevent.md)|情報|アクティビティの境界|トラブルシューティング|  
+|[402 \- StartSignpostEvent](../../../../../docs/framework/wcf/diagnostics/etw/402-startsignpostevent.md)|情報|アクティビティの境界|トラブルシューティング|  
+|[403 \- SuspendSignpostEvent](../../../../../docs/framework/wcf/diagnostics/etw/403-suspendsignpostevent.md)|情報|アクティビティの境界|トラブルシューティング|  
+|[404 \- ResumeSignpostEvent](../../../../../docs/framework/wcf/diagnostics/etw/404-resumesignpostevent.md)|情報|アクティビティの境界|トラブルシューティング|  
+|[451 \- MessageLogInfo](../../../../../docs/framework/wcf/diagnostics/etw/451-messageloginfo.md)|情報|%1|Troubleshooting、WCFMessageLogging|  
+|[452 \- MessageLogWarning](../../../../../docs/framework/wcf/diagnostics/etw/452-messagelogwarning.md)|警告|%1|Troubleshooting、WCFMessageLogging|  
+|[499 \- TransferEmitted](../../../../../docs/framework/wcf/diagnostics/etw/499-transferemitted.md)|LogAlways \(常にログ\)|転送イベントが作成されました。|Troubleshooting、UserEvents、EndToEndMonitoring、ServiceModel、WFTracking、ServiceHost、WCFMessageLogging|  
+|[501 \- CompilationStart](../../../../../docs/framework/wcf/diagnostics/etw/501-compilationstart.md)|情報|コンパイルを開始します|WebHost|  
+|[502 \- CompilationStop](../../../../../docs/framework/wcf/diagnostics/etw/502-compilationstop.md)|情報|コンパイルを終了します|WebHost|  
+|[503 \- ServiceHostFactoryCreationStart](../../../../../docs/framework/wcf/diagnostics/etw/503-servicehostfactorycreationstart.md)|情報|ServiceHostFactory が作成を開始します|WebHost|  
+|[504 \- ServiceHostFactoryCreationStop](../../../../../docs/framework/wcf/diagnostics/etw/504-servicehostfactorycreationstop.md)|情報|ServiceHostFactory が作成を終了します|WebHost|  
+|[505 \- CreateServiceHostStart](../../../../../docs/framework/wcf/diagnostics/etw/505-createservicehoststart.md)|情報|CreateServiceHost を開始します|WebHost|  
+|[506 \- CreateServiceHostStop](../../../../../docs/framework/wcf/diagnostics/etw/506-createservicehoststop.md)|情報|CreateServiceHost を終了します|WebHost|  
+|[507 \- HostedTransportConfigurationManagerConfigInitStart](../../../../../docs/framework/wcf/diagnostics/etw/507-hostedtransportconfigurationmanagerconfiginitstart.md)|情報|HostedTransportConfigurationManager が構成の初期化を開始します|WebHost|  
+|[508 \- HostedTransportConfigurationManagerConfigInitStop](../../../../../docs/framework/wcf/diagnostics/etw/508-hostedtransportconfigurationmanagerconfiginitstop.md)|情報|HostedTransportConfigurationManager が構成の初期化を終了します|WebHost|  
+|[509 \- ServiceHostOpenStart](../../../../../docs/framework/wcf/diagnostics/etw/509-servicehostopenstart.md)|情報|HostedTransportConfigurationManager が構成の初期化を終了します|ServiceHost|  
+|[510 \- ServiceHostOpenStop](../../../../../docs/framework/wcf/diagnostics/etw/510-servicehostopenstop.md)|情報|ServiceHost Open が完了しました。|ServiceHost|  
+|[513 \- WebHostRequestStart](../../../../../docs/framework/wcf/diagnostics/etw/513-webhostrequeststart.md)|情報|AppDomain '%1' からの仮想パス '%2' で要求を受信しました。|WebHost|  
+|[514 \- WebHostRequestStop](../../../../../docs/framework/wcf/diagnostics/etw/514-webhostrequeststop.md)|情報|WebHostRequest を停止します。|WebHost|  
+|[601 \- CBAEntryRead](../../../../../docs/framework/wcf/diagnostics/etw/601-cbaentryread.md)|詳細|ServiceActivation 要素の相対アドレス: '%1'、標準化相対アドレス '%2' を処理しました。||  
+|[602 \- CBAMatchFound](../../../../../docs/framework/wcf/diagnostics/etw/602-cbamatchfound.md)|詳細|受信要求が、アドレス '%1' の ServiceActivation 要素と一致します。||  
+|[603 \- AspNetRoutingService](../../../../../docs/framework/wcf/diagnostics/etw/603-aspnetroutingservice.md)|詳細|受信要求が、アドレス %1 の Asp.Net ルートで定義された WCF サービスと一致します。|RoutingServices|  
+|[604 \- AspNetRoute](../../../../../docs/framework/wcf/diagnostics/etw/604-aspnetroute.md)|詳細|serviceType '%2' および serviceHostFactoryType '%3' の新しい Asp.Net ルート '%1' が追加されます。|RoutingServices|  
+|[605 \- IncrementBusyCount](../../../../../docs/framework/wcf/diagnostics/etw/605-incrementbusycount.md)|詳細|IncrementBusyCount が呼び出されました。  ソース: %1|WebHost|  
+|[606 \- DecrementBusyCount](../../../../../docs/framework/wcf/diagnostics/etw/606-decrementbusycount.md)|詳細|DecrementBusyCount が呼び出されました。  ソース: %1|WebHost|  
+|[701 \- ServiceChannelOpenStart](../../../../../docs/framework/wcf/diagnostics/etw/701-servicechannelopenstart.md)|詳細|ServiceChannelOpen を開始しました。|WebHost|  
+|[702 \- ServiceChannelOpenStop](../../../../../docs/framework/wcf/diagnostics/etw/702-servicechannelopenstop.md)|情報|ServiceChannelOpen が完了しました。|ServiceModel|  
+|[703 \- ServiceChannelCallStart](../../../../../docs/framework/wcf/diagnostics/etw/703-servicechannelcallstart.md)|情報|ServiceChannelCall を開始しました。|ServiceModel|  
+|[704 \- ServiceChannelBeginCallStart](../../../../../docs/framework/wcf/diagnostics/etw/704-servicechannelbegincallstart.md)|情報|ServiceChannel の非同期呼び出しを開始しました。|ServiceModel|  
+|[706 \- HttpSendMessageStart](../../../../../docs/framework/wcf/diagnostics/etw/706-httpsendmessagestart.md)|詳細|HTTP 送信要求を開始します。|HTTP|  
+|[707 \- HttpSendStop](../../../../../docs/framework/wcf/diagnostics/etw/707-httpsendstop.md)|詳細|HTTP 送信要求を停止します。|HTTP|  
+|[708 \- HttpMessageReceiveStart](../../../../../docs/framework/wcf/diagnostics/etw/708-httpmessagereceivestart.md)|詳細|HTTP トランスポートからメッセージを受信しました。|HTTP|  
+|[709 \- DispatchMessageStart](../../../../../docs/framework/wcf/diagnostics/etw/709-dispatchmessagestart.md)|情報|メッセージのディスパッチを開始しました。|ServiceModel|  
+|[710 \- HttpContextBeforeProcessAuthentication](../../../../../docs/framework/wcf/diagnostics/etw/710-httpcontextbeforeprocessauthentication.md)|詳細|メッセージのディスパッチの認証を開始します|ServiceModel|  
+|[711 \- DispatchMessageBeforeAuthorization](../../../../../docs/framework/wcf/diagnostics/etw/711-dispatchmessagebeforeauthorization.md)|詳細|メッセージのディスパッチの承認を開始します|ServiceModel|  
+|[712 \- DispatchMessageStop](../../../../../docs/framework/wcf/diagnostics/etw/712-dispatchmessagestop.md)|情報|メッセージのディスパッチが完了しました|ServiceModel|  
+|[715 \- ClientChannelOpenStart](../../../../../docs/framework/wcf/diagnostics/etw/715-clientchannelopenstart.md)|情報|ServiceChannel Open を開始します。|ServiceModel|  
+|[716 \- ClientChannelOpenStop](../../../../../docs/framework/wcf/diagnostics/etw/716-clientchannelopenstop.md)|情報|ServiceChannel Open を停止します。|ServiceModel|  
+|[717 \- HttpSendStreamedMessageStart](../../../../../docs/framework/wcf/diagnostics/etw/717-httpsendstreamedmessagestart.md)|情報|ストリーム メッセージの HTTP 送信を開始しました。|HTTP|  
+|[1400 \- ChannelInitializationTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1400-channelinitializationtimeout.md)|Error|1%|ServiceModel|  
+|[1401 \- CloseTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1401-closetimeout.md)|Error|1%|ServiceModel|  
+|[1402 \- IdleTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1402-idletimeout.md)|Error|%1 接続プール キー: %2|ServiceModel|  
+|[1403 \- LeaseTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1403-leasetimeout.md)|情報|%1 接続プール キー: %2|ServiceModel|  
+|[1405 \- OpenTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1405-opentimeout.md)|Error|%1|ServiceModel|  
+|[1406 \- ReceiveTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1406-receivetimeout.md)|Error|%1|ServiceModel|  
+|[1407 \- SendTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1407-sendtimeout.md)|Error|%1|ServiceModel|  
+|[1409 \- InactivityTimeout](../../../../../docs/framework/wcf/diagnostics/etw/1409-inactivitytimeout.md)|情報|%1|ServiceModel|  
+|[1416 \- MaxReceivedMessageSizeExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1416-maxreceivedmessagesizeexceeded.md)|Error|%1|クォータ|  
+|[1417 \- MaxSentMessageSizeExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1417-maxsentmessagesizeexceeded.md)|Error|%1|クォータ|  
+|[1418 \- MaxOutboundConnectionsPerEndpointExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1418-maxoutboundconnectionsperendpointexceeded.md)|情報|%1|クォータ|  
+|[1419 \- MaxPendingConnectionsExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1419-maxpendingconnectionsexceeded.md)|情報|%1|クォータ|  
+|[1420 \- ReaderQuotaExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1420-readerquotaexceeded.md)|Error|%1|クォータ|  
+|[1422 \- NegotiateTokenAuthenticatorStateCacheExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1422-negotiatetokenauthenticatorstatecacheexceeded.md)|Error|%1|クォータ|  
+|[1423 \- NegotiateTokenAuthenticatorStateCacheRatio](../../../../../docs/framework/wcf/diagnostics/etw/1423-negotiatetokenauthenticatorstatecacheratio.md)|詳細|トークン認証システムのネゴシエートの状態のキャッシュ比率: %1\/%2|クォータ|  
+|[1424 \- SecuritySessionRatio](../../../../../docs/framework/wcf/diagnostics/etw/1424-securitysessionratio.md)|詳細|セキュリティ セッションの比率: %1\/%2|クォータ|  
+|[1430 \- PendingConnectionsRatio](../../../../../docs/framework/wcf/diagnostics/etw/1430-pendingconnectionsratio.md)|詳細|保留中の接続の比率: %1\/%2|クォータ|  
+|[1431 \- ConcurrentCallsRatio](../../../../../docs/framework/wcf/diagnostics/etw/1431-concurrentcallsratio.md)|詳細|同時セッションの比率: %1\/%2|クォータ|  
+|[1432 \- ConcurrentSessionsRatio](../../../../../docs/framework/wcf/diagnostics/etw/1432-concurrentsessionsratio.md)|詳細|同時セッションの比率: %1\/%2|クォータ|  
+|[1433 \- OutboundConnectionsPerEndpointRatio](../../../../../docs/framework/wcf/diagnostics/etw/1433-outboundconnectionsperendpointratio.md)|詳細|エンドポイントごとの送信接続の比率: %1\/%2|クォータ|  
+|[1433 \- OutboundConnectionsPerEndpointRatio](../../../../../docs/framework/wcf/diagnostics/etw/1433-outboundconnectionsperendpointratio.md)|詳細|エンドポイントごとの送信接続の比率: %1\/%2|クォータ|  
+|[1436 \- PendingMessagesPerChannelRatio](../../../../../docs/framework/wcf/diagnostics/etw/1436-pendingmessagesperchannelratio.md)|詳細|チャネルごとの保留メッセージの比率: %1\/%2|クォータ|  
+|[1438 \- ConcurrentInstancesRatio](../../../../../docs/framework/wcf/diagnostics/etw/1438-concurrentinstancesratio.md)|詳細|同時インスタンスの比率: %1\/%2|クォータ|  
+|[1439 \- PendingAcceptsAtZero](../../../../../docs/framework/wcf/diagnostics/etw/1439-pendingacceptsatzero.md)|情報|保留中の受け入れはありません|クォータ|  
+|[1441 \- MaxSessionSizeReached](../../../../../docs/framework/wcf/diagnostics/etw/1441-maxsessionsizereached.md)|警告|1%|クォータ|  
+|[1442 \- ReceiveRetryCountReached](../../../../../docs/framework/wcf/diagnostics/etw/1442-receiveretrycountreached.md)|警告|ID '%1' の MSMQ メッセージが受信再試行回数に達しました|クォータ|  
+|[1443 \- MaxRetryCyclesExceededMsmq](../../../../../docs/framework/wcf/diagnostics/etw/1443-maxretrycyclesexceededmsmq.md)|Error|ID '%1' の MSMQ メッセージが最大再試行サイクルを超えました|クォータ|  
+|[1445 \- ReadPoolMiss](../../../../../docs/framework/wcf/diagnostics/etw/1445-readpoolmiss.md)|詳細|新しい '%1' を作成しました|クォータ|  
+|[1446 \- WritePoolMiss](../../../../../docs/framework/wcf/diagnostics/etw/1446-writepoolmiss.md)|詳細|新しい '%1' を作成しました|クォータ|  
+|[1451 \- MaxRetryCyclesExceeded](../../../../../docs/framework/wcf/diagnostics/etw/1451-maxretrycyclesexceeded.md)|Error|1%|クォータ|  
+|[3300 \- ReceiveContextCompleteFailed](../../../../../docs/framework/wcf/diagnostics/etw/3300-receivecontextcompletefailed.md)|警告|%1 を完了できませんでした。|チャネル|  
+|[3301 \- ReceiveContextAbandonFailed](../../../../../docs/framework/wcf/diagnostics/etw/3301-receivecontextabandonfailed.md)|警告|%1 を破棄できませんでした。|チャネル|  
+|[3303 \- ReceiveContextAbandonWithException](../../../../../docs/framework/wcf/diagnostics/etw/3303-receivecontextabandonwithexception.md)|警告|受信コンテキストでエラーが発生しました。|ServiceModel|  
+|[3303 \- ReceiveContextAbandonWithException](../../../../../docs/framework/wcf/diagnostics/etw/3303-receivecontextabandonwithexception.md)|情報|例外 %2 が発生したため、%1 が破棄されました。|チャネル|  
+|[3305 \- ClientBaseCachedChannelFactoryCount](../../../../../docs/framework/wcf/diagnostics/etw/3305-clientbasecachedchannelfactorycount.md)|情報|キャッシュされているチャネル ファクトリの数は '%1' です。キャッシュできるチャネル ファクトリの最大数は '%2' です。|ServiceModel|  
+|[3306 \- ClientBaseChannelFactoryAgedOutofCache](../../../../../docs/framework/wcf/diagnostics/etw/3306-clientbasechannelfactoryagedoutofcache.md)|情報|キャッシュが上限の '%1' に達したため、チャネル ファクトリがキャッシュから削除されました。|ServiceModel|  
+|[3307 \- ClientBaseChannelFactoryCacheHit](../../../../../docs/framework/wcf/diagnostics/etw/3307-clientbasechannelfactorycachehit.md)|情報|キャッシュで見つかった一致するチャネル ファクトリが使用されました。|ServiceModel|  
+|[3308 \- ClientBaseUsingLocalChannelFactory](../../../../../docs/framework/wcf/diagnostics/etw/3308-clientbaseusinglocalchannelfactory.md)|情報|キャッシュ内のチャネル ファクトリは使用されません   \(つまり、インスタンスのキャッシュは無効になっています\)。|ServiceModel|  
+|[3309 \- QueryCompositionExecuted](../../../../../docs/framework/wcf/diagnostics/etw/3309-querycompositionexecuted.md)|情報|'%1' を使用したクエリの構成が要求 URI: '%2' で実行されました。|ServiceModel|  
+|[3310 \- DispatchFailed](../../../../../docs/framework/wcf/diagnostics/etw/3310-dispatchfailed.md)|Error|'%1' 操作のディスパッチでエラーが発生しました。|ServiceModel|  
+|[3311 \- DispatchSuccessful](../../../../../docs/framework/wcf/diagnostics/etw/3311-dispatchsuccessful.md)|情報|'%1' 操作が正常にディスパッチされました。|ServiceModel|  
+|[3312 \- MessageReadByEncoder](../../../../../docs/framework/wcf/diagnostics/etw/3312-messagereadbyencoder.md)|情報|サイズ '%1' バイトのメッセージがエンコーダーによって読み取られました。|チャネル|  
+|[3312 \- MessageReadByEncoder](../../../../../docs/framework/wcf/diagnostics/etw/3312-messagereadbyencoder.md)|情報|サイズ '%1' バイトのメッセージがエンコーダーによって書き込まれました。|チャネル|  
+|[3314 \- SessionIdleTimeout](../../../../../docs/framework/wcf/diagnostics/etw/3314-sessionidletimeout.md)|Error|URI: '%1' へのアイドル チャネルのセッションを中止しています。|ServiceModel|  
+|[3319 \- SocketAcceptEnqueued](../../../../../docs/framework/wcf/diagnostics/etw/3319-socketacceptenqueued.md)|詳細|接続の受け入れを開始しました。|TCP|  
+|[3320 \- SocketAccepted](../../../../../docs/framework/wcf/diagnostics/etw/3320-socketaccepted.md)|詳細|ListenerId:%1 が SocketId:%2 を受け入れました。|TCP|  
+|[3321 \- ConnectionPoolMiss](../../../../../docs/framework/wcf/diagnostics/etw/3321-connectionpoolmiss.md)|詳細|%1 のプールに使用可能な接続がありません。%2 個の接続がビジー状態です。|チャネル|  
+|[3322 \- DispatchFormatterDeserializeRequestStart](../../../../../docs/framework/wcf/diagnostics/etw/3322-dispatchformatterdeserializerequeststart.md)|詳細|ディスパッチャーが要求メッセージのシリアル化解除を開始しました。|ServiceModel|  
+|[3323 \- DispatchFormatterDeserializeRequestStop](../../../../../docs/framework/wcf/diagnostics/etw/3323-dispatchformatterdeserializerequeststop.md)|詳細|ディスパッチャーが要求メッセージのシリアル化解除を完了しました。|ServiceModel|  
+|[3324 \- DispatchFormatterSerializeReplyStart](../../../../../docs/framework/wcf/diagnostics/etw/3324-dispatchformatterserializereplystart.md)|詳細|ディスパッチャーが応答メッセージのシリアル化を開始しました。|ServiceModel|  
+|[3325 \- DispatchFormatterSerializeReplyStop](../../../../../docs/framework/wcf/diagnostics/etw/3325-dispatchformatterserializereplystop.md)|詳細|ディスパッチャーが応答メッセージのシリアル化を完了しました。|ServiceModel|  
+|[3326 \- ClientFormatterSerializeRequestStart](../../../../../docs/framework/wcf/diagnostics/etw/3326-clientformatterserializerequeststart.md)|詳細|クライアント要求のシリアル化を開始しました。|ServiceModel|  
+|[3327 \- ClientFormatterSerializeRequestStop](../../../../../docs/framework/wcf/diagnostics/etw/3327-clientformatterserializerequeststop.md)|詳細|クライアントが要求メッセージのシリアル化を完了しました。|ServiceModel|  
+|[3328 \- ClientFormatterDeserializeReplyStart](../../../../../docs/framework/wcf/diagnostics/etw/3328-clientformatterdeserializereplystart.md)|詳細|クライアントが応答メッセージのシリアル化解除を開始しました。|ServiceModel|  
+|[3329 \- ClientFormatterDeserializeReplyStop](../../../../../docs/framework/wcf/diagnostics/etw/3329-clientformatterdeserializereplystop.md)|詳細|クライアントが応答メッセージのシリアル化解除を完了しました。|ServiceModel|  
+|[3330 \- SecurityNegotiationStart](../../../../../docs/framework/wcf/diagnostics/etw/3330-securitynegotiationstart.md)|詳細|セキュリティ ネゴシエーションを開始しました。|セキュリティ|  
+|[3331 \- SecurityNegotiationStop](../../../../../docs/framework/wcf/diagnostics/etw/3331-securitynegotiationstop.md)|詳細|セキュリティ ネゴシエーションが完了しました。|セキュリティ|  
+|[3332 \- SecurityTokenProviderOpened](../../../../../docs/framework/wcf/diagnostics/etw/3332-securitytokenprovideropened.md)|詳細|SecurityTokenProvider のオープンが完了しました。|セキュリティ|  
+|[3333 \- OutgoingMessageSecured](../../../../../docs/framework/wcf/diagnostics/etw/3333-outgoingmessagesecured.md)|詳細|送信メッセージがセキュリティで保護されました。|セキュリティ|  
+|[3334 \- IncomingMessageVerified](../../../../../docs/framework/wcf/diagnostics/etw/3334-incomingmessageverified.md)|詳細|受信メッセージが確認されました。|セキュリティ ServiceModel|  
+|[3335 \- GetServiceInstanceStart](../../../../../docs/framework/wcf/diagnostics/etw/3335-getserviceinstancestart.md)|詳細|サービス インスタンスの取得を開始しました。|ServiceModel|  
+|[3336 \- GetServiceInstanceStop](../../../../../docs/framework/wcf/diagnostics/etw/3336-getserviceinstancestop.md)|詳細|サービス インスタンスが取得されました。|ServiceModel|  
+|[3337 \- ChannelReceiveStart](../../../../../docs/framework/wcf/diagnostics/etw/3337-channelreceivestart.md)|詳細|ChannelHandlerId:%1 \- メッセージ受信ループを開始しました。|チャネル|  
+|[3338 \- ChannelReceiveStop](../../../../../docs/framework/wcf/diagnostics/etw/3338-channelreceivestop.md)|詳細|ChannelHandlerId:%1 \- メッセージ受信ループを停止しました。|チャネル|  
+|[3339 \- ChannelFactoryCreated](../../../../../docs/framework/wcf/diagnostics/etw/3339-channelfactorycreated.md)|詳細|ChannelFactory が作成されました。|ServiceModel|  
+|[3340 \- PipeConnectionAcceptStart](../../../../../docs/framework/wcf/diagnostics/etw/3340-pipeconnectionacceptstart.md)|詳細|%1 でパイプ接続の受け入れを開始しました。|チャネル|  
+|[3341 \- PipeConnectionAcceptStop](../../../../../docs/framework/wcf/diagnostics/etw/3341-pipeconnectionacceptstop.md)|詳細|パイプ接続を受け入れました。|チャネル|  
+|[3342 \- EstablishConnectionStart](../../../../../docs/framework/wcf/diagnostics/etw/3342-establishconnectionstart.md)|詳細|%1 の接続の確立を開始しました。|チャネル|  
+|[3343 \- EstablishConnectionStop](../../../../../docs/framework/wcf/diagnostics/etw/3343-establishconnectionstop.md)|詳細|接続が確立されました。|チャネル|  
+|[3345 \- SessionPreambleUnderstood](../../../../../docs/framework/wcf/diagnostics/etw/3345-sessionpreambleunderstood.md)|詳細|'%1' のセッション プリアンブルが認識されました。|チャネル|  
+|[3346 \- ConnectionReaderSendFault](../../../../../docs/framework/wcf/diagnostics/etw/3346-connectionreadersendfault.md)|Error|接続リーダーがエラー '%1' を送信しています。|チャネル|  
+|[3347 \- SocketAcceptClosed](../../../../../docs/framework/wcf/diagnostics/etw/3347-socketacceptclosed.md)|詳細|ソケットの受け入れを終了しました。|TCP|  
+|[3348 \- ServiceHostFaulted](../../../../../docs/framework/wcf/diagnostics/etw/3348-servicehostfaulted.md)|Critical|サービス ホストが途中終了しました。|TCP|  
+|[3349 \- ListenerOpenStart](../../../../../docs/framework/wcf/diagnostics/etw/3349-listeneropenstart.md)|詳細|'%1' のリスナーを開いています。|チャネル|  
+|[3350 \- ListenerOpenStop](../../../../../docs/framework/wcf/diagnostics/etw/3350-listeneropenstop.md)|詳細|リスナーのオープンが完了しました。|チャネル|  
+|[3351 \- ServerMaxPooledConnectionsQuotaReached](../../../../../docs/framework/wcf/diagnostics/etw/3351-servermaxpooledconnectionsquotareached.md)|詳細|サーバーのプールされた接続の最大クォータに達しました。|クォータ|  
+|[3352 \- TcpConnectionTimedOut](../../../../../docs/framework/wcf/diagnostics/etw/3352-tcpconnectiontimedout.md)|Error|リモート アドレス %2 への SocketId:%1 がタイムアウトしました。|TCP|  
+|[3353 \- TcpConnectionResetError](../../../../../docs/framework/wcf/diagnostics/etw/3353-tcpconnectionreseterror.md)|警告|リモート アドレス %2 への SocketId:%1 で接続リセット エラーが発生しました。|TCP|  
+|[3354 \- ServiceSecurityNegotiationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/3354-servicesecuritynegotiationcompleted.md)|詳細|サービス セキュリティ ネゴシエーションが完了しました。|セキュリティ|  
+|[3355 \- SecurityNegotiationProcessingFailure](../../../../../docs/framework/wcf/diagnostics/etw/3355-securitynegotiationprocessingfailure.md)|Error|セキュリティ ネゴシエーション処理が失敗しました。|セキュリティ|  
+|[3356 \- SecurityIdentityVerificationSuccess](../../../../../docs/framework/wcf/diagnostics/etw/3356-securityidentityverificationsuccess.md)|詳細|セキュリティ検証が成功しました。|セキュリティ|  
+|[3357 \- SecurityIdentityVerificationFailure](../../../../../docs/framework/wcf/diagnostics/etw/3357-securityidentityverificationfailure.md)|Error|セキュリティ検証に失敗しました。|セキュリティ|  
+|[3358 \- PortSharingDuplicatedSocket](../../../../../docs/framework/wcf/diagnostics/etw/3358-portsharingduplicatedsocket.md)|詳細|%1 のソケットが複製されました。|ActivationServices|  
+|[3359 \- SecurityImpersonationSuccess](../../../../../docs/framework/wcf/diagnostics/etw/3359-securityimpersonationsuccess.md)|詳細|セキュリティの偽装に成功しました。|セキュリティ|  
+|[3360 \- SecurityImpersonationFailure](../../../../../docs/framework/wcf/diagnostics/etw/3360-securityimpersonationfailure.md)|警告|セキュリティの偽装に失敗しました。|セキュリティ|  
+|[3361 \- HttpChannelRequestAborted](../../../../../docs/framework/wcf/diagnostics/etw/3361-httpchannelrequestaborted.md)|警告|HTTP チャネルの要求が中止されました。|HTTP|  
+|[3362 \- HttpChannelResponseAborted](../../../../../docs/framework/wcf/diagnostics/etw/3362-httpchannelresponseaborted.md)|警告|HTTP チャネルの応答が中止されました。|HTTP|  
+|[3363 \- HttpAuthFailed](../../../../../docs/framework/wcf/diagnostics/etw/3363-httpauthfailed.md)|警告|HTTP 認証に失敗しました。|HTTP|  
+|[3364 \- SharedListenerProxyRegisterStart](../../../../../docs/framework/wcf/diagnostics/etw/3364-sharedlistenerproxyregisterstart.md)|詳細|URI '%1' の SharedListenerProxy の登録を開始しました。|ActivationServices|  
+|[3365 \- SharedListenerProxyRegisterStop](../../../../../docs/framework/wcf/diagnostics/etw/3365-sharedlistenerproxyregisterstop.md)|詳細|SharedListenerProxy の登録を停止します。|ActivationServices|  
+|[3366 \- SharedListenerProxyRegisterFailed](../../../../../docs/framework/wcf/diagnostics/etw/3366-sharedlistenerproxyregisterfailed.md)|Error|SharedListenerProxy の登録は状態 '%1' で失敗しました。|ActivationServices|  
+|[3367 \- ConnectionPoolPreambleFailed](../../../../../docs/framework/wcf/diagnostics/etw/3367-connectionpoolpreamblefailed.md)|Error|ConnectionPoolPreambleFailed。|チャネル|  
+|[3368 \- SslOnInitiateUpgrade](../../../../../docs/framework/wcf/diagnostics/etw/3368-ssloninitiateupgrade.md)|詳細|SslOnAcceptUpgradeStart|セキュリティ|  
+|[3369 \- SslOnAcceptUpgrade](../../../../../docs/framework/wcf/diagnostics/etw/3369-sslonacceptupgrade.md)|詳細|SslOnAcceptUpgradeStop|セキュリティ|  
+|[3370 \- BinaryMessageEncodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3370-binarymessageencodingstart.md)|詳細|BinaryMessageEncoder がメッセージのエンコードを開始しました。|チャネル|  
+|[3371 \- MtomMessageEncodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3371-mtommessageencodingstart.md)|詳細|MtomMessageEncoder がメッセージのエンコードを開始しました。|チャネル|  
+|[3372 \- TextMessageEncodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3372-textmessageencodingstart.md)|詳細|TextMessageEncoder がメッセージのエンコードを開始しました。|チャネル|  
+|[3373 \- BinaryMessageDecodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3373-binarymessagedecodingstart.md)|詳細|BinaryMessageEncoder がメッセージのデコードを開始しました。|チャネル|  
+|[3374 \- MtomMessageDecodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3374-mtommessagedecodingstart.md)|詳細|MtomMessageEncoder がメッセージのデコードを開始しました。|チャネル|  
+|[3375 \- TextMessageDecodingStart](../../../../../docs/framework/wcf/diagnostics/etw/3375-textmessagedecodingstart.md)|詳細|TextMessageEncoder がメッセージのデコードを開始しました。|チャネル|  
+|[3376 \- HttpResponseReceiveStart](../../../../../docs/framework/wcf/diagnostics/etw/3376-httpresponsereceivestart.md)|情報|HTTP トランスポートがメッセージの受信を開始しました。|HTTP|  
+|[3377 \- SocketReadStop](../../../../../docs/framework/wcf/diagnostics/etw/3377-socketreadstop.md)|詳細|SocketId:%1 が '%3' から '%2' バイトを読み取りました。|TCP|  
+|[3378 \- SocketAsyncReadStop](../../../../../docs/framework/wcf/diagnostics/etw/3378-socketasyncreadstop.md)|詳細|SocketId:%1 が '%3' から '%2' バイトを読み取りました。|TCP|  
+|[3379 \- SocketWriteStart](../../../../../docs/framework/wcf/diagnostics/etw/3379-socketwritestart.md)|詳細|SocketId:%1 が '%3' に '%2' バイトを書き込んでいます。|TCP|  
+|[3380 \- SocketAsyncWriteStart](../../../../../docs/framework/wcf/diagnostics/etw/3380-socketasyncwritestart.md)|詳細|SocketId:%1 が '%3' に '%2' バイトを書き込んでいます。|TCP|  
+|[3381 \- SequenceAcknowledgementSent](../../../../../docs/framework/wcf/diagnostics/etw/3381-sequenceacknowledgementsent.md)|詳細|SessionId:%1 の受信確認が送信されました。|チャネル|  
+|[3382 \- ClientReliableSessionReconnect](../../../../../docs/framework/wcf/diagnostics/etw/3382-clientreliablesessionreconnect.md)|情報|SessionId:%1 を再接続します。|チャネル|  
+|[3383 \- ReliableSessionChannelFaulted](../../../../../docs/framework/wcf/diagnostics/etw/3383-reliablesessionchannelfaulted.md)|情報|SessionId:%1 でエラーが発生しました。|チャネル|  
+|[3384 \- WindowsStreamSecurityOnInitiateUpgrade](../../../../../docs/framework/wcf/diagnostics/etw/3384-windowsstreamsecurityoninitiateupgrade.md)|詳細|WindowsStreamSecurity がセキュリティ アップグレードを開始しています。|セキュリティ|  
+|[3385 \- WindowsStreamSecurityOnAcceptUpgrade](../../../../../docs/framework/wcf/diagnostics/etw/3385-windowsstreamsecurityonacceptupgrade.md)|詳細|Windows ストリーミング セキュリティがアップグレードを受け入れています。|セキュリティ|  
+|[3386 \- SocketConnectionAbort](../../../../../docs/framework/wcf/diagnostics/etw/3386-socketconnectionabort.md)|警告|SocketId:%1 を中止しています。|TCP|  
+|[3388 \- HttpGetContextStart](../../../../../docs/framework/wcf/diagnostics/etw/3388-httpgetcontextstart.md)|詳細|HttpGetContext を開始します。|HTTP|  
+|[3389 \- ClientSendPreambleStart](../../../../../docs/framework/wcf/diagnostics/etw/3389-clientsendpreamblestart.md)|詳細|クライアントがプリアンブルの送信を開始します。|チャネル|  
+|[3390 \- ClientSendPreambleStop](../../../../../docs/framework/wcf/diagnostics/etw/3390-clientsendpreamblestop.md)|詳細|クライアントがプリアンブルの送信を停止します。|チャネル|  
+|[3391 \- HttpMessageReceiveFailed](../../../../../docs/framework/wcf/diagnostics/etw/3391-httpmessagereceivefailed.md)|警告|HTTP メッセージの受信に失敗しました。|HTTP|  
+|[3392 \- TransactionScopeCreate](../../../../../docs/framework/wcf/diagnostics/etw/3392-transactionscopecreate.md)|情報|LocalIdentifier:'%1' および DistributedIdentifier:'%2' の TransactionScope を作成しています。|ServiceModel|  
+|[3393 \- StreamedMessageReadByEncoder](../../../../../docs/framework/wcf/diagnostics/etw/3393-streamedmessagereadbyencoder.md)|情報|エンコーダーによってストリーム メッセージが読み取られました。|チャネル|  
+|[3394 \- StreamedMessageWrittenByEncoder](../../../../../docs/framework/wcf/diagnostics/etw/3394-streamedmessagewrittenbyencoder.md)|情報|エンコーダーによってストリーム メッセージが書き込まれました。|チャネル|  
+|[3395 \- MessageWrittenAsynchronouslyByEncoder](../../../../../docs/framework/wcf/diagnostics/etw/3395-messagewrittenasynchronouslybyencoder.md)|情報|エンコーダーによってメッセージが非同期で書き込まれました。|チャネル|  
+|[3396 \- BufferedAsyncWriteStart](../../../../../docs/framework/wcf/diagnostics/etw/3396-bufferedasyncwritestart.md)|情報|BufferId:%1 から基になるストリームへの '%2' バイトの書き込みが完了しました。|チャネル|  
+|[3397 \- BufferedAsyncWriteStop](../../../../../docs/framework/wcf/diagnostics/etw/3397-bufferedasyncwritestop.md)|情報|エンコーダーによってメッセージが非同期で書き込まれました。|チャネル|  
+|[3398 \- PipeSharedMemoryCreated](../../../../../docs/framework/wcf/diagnostics/etw/3398-pipesharedmemorycreated.md)|詳細|パイプ共有メモリが '%1' に作成されました。|チャネル|  
+|[3399 \- NamedPipeCreated](../../../../../docs/framework/wcf/diagnostics/etw/3399-namedpipecreated.md)|詳細|NamedPipe '%1' が作成されました。|チャネル|  
+|[3401 \- SignatureVerificationStart](../../../../../docs/framework/wcf/diagnostics/etw/3401-signatureverificationstart.md)|詳細|署名の検証を開始しました。|セキュリティ|  
+|[3402 \- SignatureVerificationSuccess](../../../../../docs/framework/wcf/diagnostics/etw/3402-signatureverificationsuccess.md)|詳細|署名の検証に成功しました|セキュリティ|  
+|[3403 \- WrappedKeyDecryptionStart](../../../../../docs/framework/wcf/diagnostics/etw/3403-wrappedkeydecryptionstart.md)|詳細|ラップされたキーの解読を開始しました。|セキュリティ|  
+|[3404 \- WrappedKeyDecryptionSuccess](../../../../../docs/framework/wcf/diagnostics/etw/3404-wrappedkeydecryptionsuccess.md)|詳細|ラップされたキーの解読に成功しました。|セキュリティ|  
+|[3405 \- EncryptedDataProcessingStart](../../../../../docs/framework/wcf/diagnostics/etw/3405-encrypteddataprocessingstart.md)|詳細|暗号化されたデータの処理を開始しました。|セキュリティ|  
+|[3406 \- EncryptedDataProcessingSuccess](../../../../../docs/framework/wcf/diagnostics/etw/3406-encrypteddataprocessingsuccess.md)|詳細|暗号化されたデータの処理に成功しました。|セキュリティ|  
+|[3407 \- HttpPipelineProcessInboundRequestStart](../../../../../docs/framework/wcf/diagnostics/etw/3407-httppipelineprocessinboundrequeststart.md)|詳細|http メッセージ ハンドラーは、受信要求の処理を開始しました。|HTTP|  
+|[3408 \- HttpPipelineBeginProcessInboundRequestStart](../../../../../docs/framework/wcf/diagnostics/etw/3408-httppipelinebeginprocessinboundrequeststart.md)|詳細|http メッセージ ハンドラーは、受信要求の非同期処理を開始しました。|HTTP|  
+|[3409 \- HttpPipelineProcessInboundRequestStop](../../../../../docs/framework/wcf/diagnostics/etw/3409-httppipelineprocessinboundrequeststop.md)|詳細|http メッセージ ハンドラーは、受信要求の処理を完了しました。|HTTP|  
+|[3410 \- HttpPipelineFaulted](../../../../../docs/framework/wcf/diagnostics/etw/3410-httppipelinefaulted.md)|警告|http メッセージ ハンドラーに障害があります。|HTTP|  
+|[3411 \- HttpPipelineTimeoutException](../../../../../docs/framework/wcf/diagnostics/etw/3411-httppipelinetimeoutexception.md)|Error|WebSocket の接続がタイムアウトしました。|HTTP|  
+|[3412 \- HttpPipelineProcessResponseStart](../../../../../docs/framework/wcf/diagnostics/etw/3412-httppipelineprocessresponsestart.md)|詳細|http メッセージ ハンドラーは、応答の処理を開始しました。|HTTP|  
+|[3413 \- HttpPipelineBeginProcessResponseStart](../../../../../docs/framework/wcf/diagnostics/etw/3413-httppipelinebeginprocessresponsestart.md)|詳細|http メッセージ ハンドラーは、応答の非同期処理を開始しました。|HTTP|  
+|[3414 \- HttpPipelineProcessResponseStop](../../../../../docs/framework/wcf/diagnostics/etw/3414-httppipelineprocessresponsestop.md)|詳細|http メッセージ ハンドラーは、応答の処理を完了しました。|HTTP|  
+|[3415 \- WebSocketConnectionRequestSendStart](../../../../../docs/framework/wcf/diagnostics/etw/3415-websocketconnectionrequestsendstart.md)|詳細|'%1' への WebSocket 接続要求の送信を開始します。|HTTP|  
+|[3416 \- WebSocketConnectionRequestSendStop](../../../../../docs/framework/wcf/diagnostics/etw/3416-websocketconnectionrequestsendstop.md)|詳細|WebSocketId:%1 の接続要求を送信しました。|HTTP|  
+|[3417 \- WebSocketConnectionAcceptStart](../../../../../docs/framework/wcf/diagnostics/etw/3417-websocketconnectionacceptstart.md)|詳細|WebSocket 接続の受け入れを開始します。|HTTP|  
+|[3418 \- WebSocketConnectionAccepted](../../../../../docs/framework/wcf/diagnostics/etw/3418-websocketconnectionaccepted.md)|詳細|WebSocketId:%1 の接続を受け入れました。|HTTP|  
+|[3419 \- WebSocketConnectionDeclined](../../../../../docs/framework/wcf/diagnostics/etw/3419-websocketconnectiondeclined.md)|Error|WebSocket 接続が状態コード '%1' で拒否されました|HTTP|  
+|[3420 \- WebSocketConnectionFailed](../../../../../docs/framework/wcf/diagnostics/etw/3420-websocketconnectionfailed.md)|Error|WebSocket 接続要求が失敗しました: '%1'|HTTP|  
+|[3421 \- WebSocketConnectionAborted](../../../../../docs/framework/wcf/diagnostics/etw/3421-websocketconnectionaborted.md)|Error|WebSocketId:%1 の接続が中止されました。|HTTP|  
+|[3422 \- WebSocketAsyncWriteStart](../../../../../docs/framework/wcf/diagnostics/etw/3422-websocketasyncwritestart.md)|詳細|WebSocketId:%1 が '%3' に '%2' バイトを書き込んでいます。|HTTP|  
+|[3423 \- WebSocketAsyncWriteStop](../../../../../docs/framework/wcf/diagnostics/etw/3423-websocketasyncwritestop.md)|詳細|WebSocketId:%1 が非同期書き込みを停止します。|HTTP|  
+|[3424 \- WebSocketAsyncReadStart](../../../../../docs/framework/wcf/diagnostics/etw/3424-websocketasyncreadstart.md)|詳細|WebSocketId:%1 が読み取りを開始します。|HTTP|  
+|[3425 \- WebSocketAsyncReadStop](../../../../../docs/framework/wcf/diagnostics/etw/3425-websocketasyncreadstop.md)|詳細|WebSocketId:%1 が '%3' から '%2' バイトを読み取りました。|HTTP|  
+|[3426 \- WebSocketCloseSent](../../../../../docs/framework/wcf/diagnostics/etw/3426-websocketclosesent.md)|詳細|WebSocketId:%1 が、終了ステータス '%3' の終了メッセージを '%2' に送信しています。|HTTP|  
+|[3427 \- WebSocketCloseOutputSent](../../../../../docs/framework/wcf/diagnostics/etw/3427-websocketcloseoutputsent.md)|詳細|WebSocketId:%1 が、終了ステータス '%3' の終了出力メッセージを '%2' に送信しています。|HTTP|  
+|[3428 \- WebSocketConnectionClosed](../../../../../docs/framework/wcf/diagnostics/etw/3428-websocketconnectionclosed.md)|詳細|WebSocketId:%1 の接続を終了しました。|HTTP|  
+|[3429 \- WebSocketCloseStatusReceived](../../../../../docs/framework/wcf/diagnostics/etw/3429-websocketclosestatusreceived.md)|詳細|WebSocketId:%1 が、状態 '%2' の接続終了メッセージを受信しました。|HTTP|  
+|[3430 \- WebSocketUseVersionFromClientWebSocketFactory](../../../../../docs/framework/wcf/diagnostics/etw/3430-websocketuseversionfromclientwebsocketfactory.md)|詳細|型 '%1' のクライアント WebSocket ファクトリから WebSocketVersion を使用しています。|HTTP|  
+|[3431 \- WebSocketCreateClientWebSocketWithFactory](../../../../../docs/framework/wcf/diagnostics/etw/3431-websocketcreateclientwebsocketwithfactory.md)|詳細|型 '%1' のファクトリでクライアント WebSocket を作成しています。|HTTP|  
+|[3553 \- XamlServicesLoadStart](../../../../../docs/framework/wcf/diagnostics/etw/3553-xamlservicesloadstart.md)|情報|XamlServicesLoad が開始します|WebHost|  
+|[3554 \- XamlServicesLoadStop](../../../../../docs/framework/wcf/diagnostics/etw/3554-xamlservicesloadstop.md)|情報|XamlServicesLoad が停止します|WebHost|  
+|[3555 \- CreateWorkflowServiceHostStart](../../../../../docs/framework/wcf/diagnostics/etw/3555-createworkflowservicehoststart.md)|情報|CreateWorkflowServiceHost が開始します|WebHost|  
+|[3556 \- CreateWorkflowServiceHostStop](../../../../../docs/framework/wcf/diagnostics/etw/3556-createworkflowservicehoststop.md)|情報|CreateWorkflowServiceHost が停止します|WebHost|  
+|[3558 \- ServiceActivationStart](../../../../../docs/framework/wcf/diagnostics/etw/3558-serviceactivationstart.md)|情報|サービスのアクティブ化を開始します|WebHost|  
+|[3559 \- ServiceActivationStop](../../../../../docs/framework/wcf/diagnostics/etw/3559-serviceactivationstop.md)|情報|サービスのアクティブ化を停止します|WebHost|  
+|[3560 \- ServiceActivationAvailableMemory](../../../../../docs/framework/wcf/diagnostics/etw/3560-serviceactivationavailablememory.md)|詳細|使用可能なメモリ \(バイト\): %1|クォータ|  
+|[3800 \- RoutingServiceClosingClient](../../../../../docs/framework/wcf/diagnostics/etw/3800-routingserviceclosingclient.md)|情報|ルーティング サービスがクライアント '%1' を終了しています。|RoutingServices|  
+|[3800 \- RoutingServiceClosingClient](../../../../../docs/framework/wcf/diagnostics/etw/3800-routingserviceclosingclient.md)|警告|ルーティング サービスのクライアント '%1' が途中終了しました。|RoutingServices|  
+|[3802 \- RoutingServiceCompletingOneWay](../../../../../docs/framework/wcf/diagnostics/etw/3802-routingservicecompletingoneway.md)|情報|ルーティング サービスの一方向メッセージを完了しています。|RoutingServices|  
+|[3803 \- RoutingServiceProcessingFailure](../../../../../docs/framework/wcf/diagnostics/etw/3803-routingserviceprocessingfailure.md)|Error|アドレス '%1' のエンドポイントでメッセージを処理しているときにルーティング サービスでエラーが発生しました。|RoutingServices|  
+|[3804 \- RoutingServiceCreatingClientForEndpoint](../../../../../docs/framework/wcf/diagnostics/etw/3804-routingservicecreatingclientforendpoint.md)|情報|ルーティング サービスが、エンドポイント: '%1' のクライアントを作成しています。|RoutingServices|  
+|[3805 \- RoutingServiceDisplayConfig](../../../../../docs/framework/wcf/diagnostics/etw/3805-routingservicedisplayconfig.md)|詳細|ルーティング サービスは、RouteOnHeadersOnly: %1、SoapProcessingEnabled: %2、EnsureOrderedDispatch: %3 に構成されています。|RoutingServices|  
+|[3807 \- RoutingServiceCompletingTwoWay](../../../../../docs/framework/wcf/diagnostics/etw/3807-routingservicecompletingtwoway.md)|情報|ルーティング サービスの要求応答メッセージを完了しています。|RoutingServices|  
+|[3809 \- RoutingServiceMessageRoutedToEndpoints](../../../../../docs/framework/wcf/diagnostics/etw/3809-routingservicemessageroutedtoendpoints.md)|詳細|ルーティング サービスにより、ID: '%1' のメッセージが %2 エンドポイント リストにルーティングされました。|RoutingServices|  
+|[3810 \- RoutingServiceConfigurationApplied](../../../../../docs/framework/wcf/diagnostics/etw/3810-routingserviceconfigurationapplied.md)|情報|新しい RoutingConfiguration がルーティング サービスに適用されました。|RoutingServices|  
+|[3815 \- RoutingServiceProcessingMessage](../../../../../docs/framework/wcf/diagnostics/etw/3815-routingserviceprocessingmessage.md)|情報|ルーティング サービスが、トランザクション: %4 で受信された ID: '%1'、アクション: '%2'、着信 URL: '%3' のメッセージを処理しています。|RoutingServices|  
+|[3816 \- RoutingServiceTransmittingMessage](../../../../../docs/framework/wcf/diagnostics/etw/3816-routingservicetransmittingmessage.md)|情報|ルーティング サービスが、ID: '%1' \[operation %2\] のメッセージを '%3' に転送しています。|RoutingServices|  
+|[3817 \- RoutingServiceCommittingTransaction](../../../../../docs/framework/wcf/diagnostics/etw/3817-routingservicecommittingtransaction.md)|情報|ルーティング サービスが、ID: '%1' のトランザクションをコミットしています。|RoutingServices|  
+|[3818 \- RoutingServiceDuplexCallbackException](../../../../../docs/framework/wcf/diagnostics/etw/3818-routingserviceduplexcallbackexception.md)|Error|ルーティング サービスのコンポーネント %1 で二重コールバックの例外が発生しました。|RoutingServices|  
+|[3819 \- RoutingServiceMovedToBackup](../../../../../docs/framework/wcf/diagnostics/etw/3819-routingservicemovedtobackup.md)|情報|ID: '%1' \[operation %2\] のルーティング サービス メッセージがバックアップ エンドポイント '%3' に移動されました。|RoutingServices|  
+|[3820 \- RoutingServiceCreatingTransaction](../../../../../docs/framework/wcf/diagnostics/etw/3820-routingservicecreatingtransaction.md)|情報|ルーティング サービスが、メッセージを処理するために ID '%1' の新しいトランザクションを作成しました。|RoutingServices|  
+|[3821 \- RoutingServiceCloseFailed](../../../../../docs/framework/wcf/diagnostics/etw/3821-routingserviceclosefailed.md)|警告|発信クライアント '%1' を終了しているときにルーティング サービスでエラーが発生しました。|RoutingServices|  
+|[3822 \- RoutingServiceSendingResponse](../../../../../docs/framework/wcf/diagnostics/etw/3822-routingservicesendingresponse.md)|情報|ルーティング サービスが、Action '%1' を含む応答メッセージを返送しています。|RoutingServices|  
+|[3823 \- RoutingServiceSendingFaultResponse](../../../../../docs/framework/wcf/diagnostics/etw/3823-routingservicesendingfaultresponse.md)|警告|ルーティング サービスが、Action '%1' を含むエラー応答メッセージを返送しています。|RoutingServices|  
+|[3824 \- RoutingServiceCompletingReceiveContext](../../../../../docs/framework/wcf/diagnostics/etw/3824-routingservicecompletingreceivecontext.md)|詳細|ルーティング サービスが、ID: '%1' のメッセージに対して ReceiveContext.Complete を呼び出しています。|RoutingServices|  
+|[3825 \- RoutingServiceAbandoningReceiveContext](../../../../../docs/framework/wcf/diagnostics/etw/3825-routingserviceabandoningreceivecontext.md)|警告|ルーティング サービスが、ID: '%1' のメッセージに対して ReceiveContext.Abandon を呼び出しています。|RoutingServices|  
+|[3826 \- RoutingServiceUsingExistingTransaction](../../../../../docs/framework/wcf/diagnostics/etw/3826-routingserviceusingexistingtransaction.md)|詳細|ルーティング サービスは、既存のトランザクション '%1' を使用してメッセージを送信します。|RoutingServices|  
+|[3827 \- RoutingServiceTransmitFailed](../../../../../docs/framework/wcf/diagnostics/etw/3827-routingservicetransmitfailed.md)|警告|'%1' への送信中にルーティング サービスでエラーが発生しました。|RoutingServices|  
+|[3828 \- RoutingServiceFilterTableMatchStart](../../../../../docs/framework/wcf/diagnostics/etw/3828-routingservicefiltertablematchstart.md)|情報|ルーティング サービス MessageFilterTable の照合が開始します。|RoutingServices|  
+|[3829 \- RoutingServiceFilterTableMatchStop](../../../../../docs/framework/wcf/diagnostics/etw/3829-routingservicefiltertablematchstop.md)|情報|ルーティング サービス MessageFilterTable の照合が停止します。|RoutingServices|  
+|[3830 \- RoutingServiceAbortingChannel](../../../../../docs/framework/wcf/diagnostics/etw/3830-routingserviceabortingchannel.md)|詳細|ルーティング サービスがチャネル '%1' で中止を呼び出しています。|RoutingServices|  
+|[3831 \- RoutingServiceHandledException](../../../../../docs/framework/wcf/diagnostics/etw/3831-routingservicehandledexception.md)|詳細|ルーティング サービスが例外を処理しました。|RoutingServices|  
+|[3832 \- RoutingServiceTransmitSucceeded](../../../../../docs/framework/wcf/diagnostics/etw/3832-routingservicetransmitsucceeded.md)|情報|ルーティング サービスが、ID: '%1 \[operation %2\] のメッセージを '%3' に正常に送信しました。|RoutingServices|  
+|[4001 \- TransportListenerSessionsReceived](../../../../../docs/framework/wcf/diagnostics/etw/4001-transportlistenersessionsreceived.md)|詳細|'%1' でトランスポート リスナー セッションを受信しました|ActivationServices|  
+|[4002 \- FailFastException](../../../../../docs/framework/wcf/diagnostics/etw/4002-failfastexception.md)|Critical|FailFastException。|ActivationServices|  
+|[4003 \- ServiceStartPipeError](../../../../../docs/framework/wcf/diagnostics/etw/4003-servicestartpipeerror.md)|Error|サービス開始パイプ エラー。|ActivationServices|  
+|[4008 \- DispatchSessionStart](../../../../../docs/framework/wcf/diagnostics/etw/4008-dispatchsessionstart.md)|詳細|セッション ディスパッチを開始しました。|ActivationServices|  
+|[4008 \- DispatchSessionStart](../../../../../docs/framework/wcf/diagnostics/etw/4008-dispatchsessionstart.md)|警告|'%1' のセッション ディスパッチに失敗しました。保留セッション キューがいっぱいです。保留中の項目が '%2' 個あります。|ActivationServices|  
+|[4011 \- MessageQueueRegisterStart](../../../../../docs/framework/wcf/diagnostics/etw/4011-messagequeueregisterstart.md)|詳細|メッセージ キューの登録を開始します。|ActivationServices|  
+|[4012 \- MessageQueueRegisterAbort](../../../../../docs/framework/wcf/diagnostics/etw/4012-messagequeueregisterabort.md)|Error|URI:'%2' のメッセージ キューの登録が状態:'%1' で中止されました。|ActivationServices|  
+|[4013 \- MessageQueueUnregisterSucceeded](../../../../../docs/framework/wcf/diagnostics/etw/4013-messagequeueunregistersucceeded.md)|詳細|URI:'%1' のメッセージ キューの登録解除に成功しました。|ActivationServices|  
+|[4014 \- MessageQueueRegisterFailed](../../../../../docs/framework/wcf/diagnostics/etw/4014-messagequeueregisterfailed.md)|Error|URI:'%1' のメッセージ キューの登録が状態:'%2' で失敗しました。|ActivationServices|  
+|[4015 \- MessageQueueRegisterCompleted](../../../../../docs/framework/wcf/diagnostics/etw/4015-messagequeueregistercompleted.md)|情報|URI '%1' のメッセージ キューの登録が完了しました。|ActivationServices|  
+|[4016 \- MessageQueueDuplicatedSocketError](../../../../../docs/framework/wcf/diagnostics/etw/4016-messagequeueduplicatedsocketerror.md)|Error|メッセージ キューがソケットの複製に失敗しました。|ActivationServices|  
+|[4019 \- MessageQueueDuplicatedSocketComplete](../../../../../docs/framework/wcf/diagnostics/etw/4019-messagequeueduplicatedsocketcomplete.md)|詳細|MessageQueueDuplicatedSocketComplete|ActivationServices|  
+|[4020 \- TcpTransportListenerListeningStart](../../../../../docs/framework/wcf/diagnostics/etw/4020-tcptransportlistenerlisteningstart.md)|詳細|TCP トランスポート リスナーが URI: '%1' でリッスンを開始しています。|ActivationServices|  
+|[4021 \- TcpTransportListenerListeningStop](../../../../../docs/framework/wcf/diagnostics/etw/4021-tcptransportlistenerlisteningstop.md)|詳細|TCP トランスポート リスナーがリッスンしています。|ActivationServices|  
+|[4022 \- WebhostUnregisterProtocolFailed](../../../../../docs/framework/wcf/diagnostics/etw/4022-webhostunregisterprotocolfailed.md)|Error|エラー コード:%1|ActivationServices|  
+|[4023 \- WasCloseAllListenerChannelInstancesCompleted](../../../../../docs/framework/wcf/diagnostics/etw/4023-wasclosealllistenerchannelinstancescompleted.md)|情報|WAS がすべてのリスナー チャネル インスタンスのクローズを完了しました。|ActivationServices|  
+|[4024 \- WasCloseAllListenerChannelInstancesFailed](../../../../../docs/framework/wcf/diagnostics/etw/4024-wasclosealllistenerchannelinstancesfailed.md)|Error|エラー コード:%1|ActivationServices|  
+|[4025 \- OpenListenerChannelInstanceFailed](../../../../../docs/framework/wcf/diagnostics/etw/4025-openlistenerchannelinstancefailed.md)|Error|エラー コード:%1|ActivationServices|  
+|[4026 \- WasConnected](../../../../../docs/framework/wcf/diagnostics/etw/4026-wasconnected.md)|詳細|WAS が接続されました。|ActivationServices|  
+|[4027 \- WasDisconnected](../../../../../docs/framework/wcf/diagnostics/etw/4027-wasdisconnected.md)|詳細|WAS の接続が解除されました。|ActivationServices|  
+|[4028 \- PipeTransportListenerListeningStart](../../../../../docs/framework/wcf/diagnostics/etw/4028-pipetransportlistenerlisteningstart.md)|詳細|パイプ トランスポート リスナーが URI:%1 でリッスンを開始します。|ActivationServices|  
+|[4029 \- PipeTransportListenerListeningStop](../../../../../docs/framework/wcf/diagnostics/etw/4029-pipetransportlistenerlisteningstop.md)|詳細|パイプ トランスポート リスナーがリッスンを停止します。|ActivationServices|  
+|[4030 \- DispatchSessionSuccess](../../../../../docs/framework/wcf/diagnostics/etw/4030-dispatchsessionsuccess.md)|情報|セッション ディスパッチに成功しました。|ActivationServices|  
+|[4031 \- DispatchSessionFailed](../../../../../docs/framework/wcf/diagnostics/etw/4031-dispatchsessionfailed.md)|Error|セッション ディスパッチに失敗しました。|ActivationServices|  
+|[4032 \- WasConnectionTimedout](../../../../../docs/framework/wcf/diagnostics/etw/4032-wasconnectiontimedout.md)|Critical|WAS の接続がタイムアウトしました。|ActivationServices|  
+|[4033 \- RoutingTableLookupStart](../../../../../docs/framework/wcf/diagnostics/etw/4033-routingtablelookupstart.md)|詳細|ルーティング テーブルの参照を開始しました。|ActivationServices|  
+|[4034 \- RoutingTableLookupStop](../../../../../docs/framework/wcf/diagnostics/etw/4034-routingtablelookupstop.md)|詳細|ルーティング テーブルの参照が完了しました。|ActivationServices|  
+|[4035 \- PendingSessionQueueRatio](../../../../../docs/framework/wcf/diagnostics/etw/4035-pendingsessionqueueratio.md)|詳細|保留セッション キューの比率: %1\/%2|クォータ|  
+|[4600 \- MessageLogEventSizeExceeded](../../../../../docs/framework/wcf/diagnostics/etw/4600-messagelogeventsizeexceeded.md)|警告|メッセージが ETW イベントのサイズを上回っているため、メッセージをログに記録できませんでした|WCFMessageLogging|  
+|[4801 \- DiscoveryClientInClientChannelFailedToClose](../../../../../docs/framework/wcf/diagnostics/etw/4801-discoveryclientinclientchannelfailedtoclose.md)|警告|DiscoveryClientChannel 内で作成された DiscoveryClient を閉じることができず、異常終了しました。|探索|  
+|[4802 \- DiscoveryClientProtocolExceptionSuppressed](../../../../../docs/framework/wcf/diagnostics/etw/4802-discoveryclientprotocolexceptionsuppressed.md)|情報|DiscoveryClient を閉じているときに ProtocolException が抑制されました。  その理由として、DiscoveryService がまだ DiscoveryClient に応答を送信しようとしていることが考えられます。|探索|  
+|[4803 \- DiscoveryClientReceivedMulticastSuppression](../../../../../docs/framework/wcf/diagnostics/etw/4803-discoveryclientreceivedmulticastsuppression.md)|情報|DiscoveryClient は DiscoveryProxy からマルチキャスト抑制メッセージを受け取りました。|探索|  
+|[4804 \- DiscoveryMessageReceivedAfterOperationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/4804-discoverymessagereceivedafteroperationcompleted.md)|情報|messageId\='%2' の %1 メッセージは、対応する %3 操作が完了したため、DiscoveryClient によってドロップされました。|探索|  
+|[4805 \- DiscoveryMessageWithInvalidContent](../../../../../docs/framework/wcf/diagnostics/etw/4805-discoverymessagewithinvalidcontent.md)|警告|messageId\='%2' の %1 メッセージは、無効なコンテンツがあったため、ドロップされました。|探索|  
+|[4806 \- DiscoveryMessageWithInvalidRelatesToOrOperationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/4806-discoverymessagewithinvalidrelatestooroperationcompleted.md)|警告|messageId\='%2' および relatesTo\='%3' の %1 メッセージは、対応する %4 操作が完了したか、relatesTo 値が無効であるため、DiscoveryClient によってドロップされました。|探索|  
+|[4807 \- DiscoveryMessageWithInvalidReplyTo](../../../../../docs/framework/wcf/diagnostics/etw/4807-discoverymessagewithinvalidreplyto.md)|警告|messageId\='%1' の探索要求メッセージは、無効な ReplyTo アドレスがあったため、ドロップされました。|探索|  
+|[4808 \- DiscoveryMessageWithNoContent](../../../../../docs/framework/wcf/diagnostics/etw/4808-discoverymessagewithnocontent.md)|警告|%1 メッセージは、コンテンツがなかったため、ドロップされました。|探索|  
+|[4809 \- DiscoveryMessageWithNullMessageId](../../../../../docs/framework/wcf/diagnostics/etw/4809-discoverymessagewithnullmessageid.md)|警告|%1 メッセージは、メッセージ ヘッダーに必要な MessageId プロパティが含まれていなかったため、ドロップされました。|探索|  
+|[4810 \- DiscoveryMessageWithNullMessageSequence](../../../../../docs/framework/wcf/diagnostics/etw/4810-discoverymessagewithnullmessagesequence.md)|警告|messageId\='%2' の %1 メッセージは、DiscoveryMessageSequence プロパティがなかったため、DiscoveryClient によってドロップされました。|探索|  
+|[4811 \- DiscoveryMessageWithNullRelatesTo](../../../../../docs/framework/wcf/diagnostics/etw/4811-discoverymessagewithnullrelatesto.md)|警告|messageId\='%2' の %1 メッセージは、メッセージ ヘッダーに必要な RelatesTo プロパティが含まれていなかったため、DiscoveryClient によってドロップされました。|探索|  
+|[4812 \- DiscoveryMessageWithNullReplyTo](../../../../../docs/framework/wcf/diagnostics/etw/4812-discoverymessagewithnullreplyto.md)|警告|messageId\='%1' の探索要求メッセージは、ReplyTo アドレスがなかったため、ドロップされました。|探索|  
+|[4813 \- DuplicateDiscoveryMessage](../../../../../docs/framework/wcf/diagnostics/etw/4813-duplicatediscoverymessage.md)|警告|messageId\='%2' の %1 メッセージは、重複していたため、ドロップされました。|探索|  
+|[4814 \- EndpointDiscoverabilityDisabled](../../../../../docs/framework/wcf/diagnostics/etw/4814-endpointdiscoverabilitydisabled.md)|情報|EndpointAddress\='%1' および ListenUri\='%2' のエンドポイントの探索が無効になりました。|探索|  
+|[4814 \- EndpointDiscoverabilityDisabled](../../../../../docs/framework/wcf/diagnostics/etw/4814-endpointdiscoverabilitydisabled.md)|情報|EndpointAddress\='%1' および ListenUri\='%2' のエンドポイントの探索が有効になりました。|探索|  
+|[4816 \- FindInitiatedInDiscoveryClientChannel](../../../../../docs/framework/wcf/diagnostics/etw/4816-findinitiatedindiscoveryclientchannel.md)|詳細|エンドポイントを探索するために、Find 操作が DiscoveryClientChannel で開始されました。|探索|  
+|[4817 \- InnerChannelCreationFailed](../../../../../docs/framework/wcf/diagnostics/etw/4817-innerchannelcreationfailed.md)|警告|DiscoveryClientChannel は、EndpointAddress\='%1' および Via\='%2' の探索されたエンドポイントを使用して、チャネルを作成できませんでした。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。|探索|  
+|[4818 \- InnerChannelOpenFailed](../../../../../docs/framework/wcf/diagnostics/etw/4818-innerchannelopenfailed.md)|警告|DiscoveryClientChannel は、EndpointAddress\='%1' および Via\='%2' の探索されたエンドポイントを使用して、チャネルを開くことができませんでした。  DiscoveryClientChannel は、次に使用可能な探索されたエンドポイントを使用します。|探索|  
+|[4819 \- InnerChannelOpenSucceeded](../../../../../docs/framework/wcf/diagnostics/etw/4819-innerchannelopensucceeded.md)|情報|DiscoveryClientChannel は正常にエンドポイントを探索し、それを使用してチャネルを開きました。  クライアントは EndpointAddress\='%1' および Via\='%2' を使用して、サービスに接続されています。|探索|  
+|[4820 \- SynchronizationContextReset](../../../../../docs/framework/wcf/diagnostics/etw/4820-synchronizationcontextreset.md)|情報|SynchronizationContext は DiscoveryClientChannel によって、元の値 %1 にリセットされました。|探索|  
+|[4821 \- SynchronizationContextSetToNull](../../../../../docs/framework/wcf/diagnostics/etw/4821-synchronizationcontextsettonull.md)|情報|SynchronizationContext は、Find 操作を開始する前に、DiscoveryClientChannel によって NULL に設定されました。|探索|  
+|[5001 \- DCSerializeWithSurrogateStart](../../../../../docs/framework/wcf/diagnostics/etw/5001-dcserializewithsurrogatestart.md)|詳細|DataContract のサロゲートによる %1 のシリアル化を開始します。|シリアル化|  
+|[5002 \- DCSerializeWithSurrogateStop](../../../../../docs/framework/wcf/diagnostics/etw/5002-dcserializewithsurrogatestop.md)|詳細|DataContract のサロゲートによるシリアル化を停止します。|シリアル化|  
+|[5003 \- DCDeserializeWithSurrogateStart](../../../../../docs/framework/wcf/diagnostics/etw/5003-dcdeserializewithsurrogatestart.md)|詳細|DataContract のサロゲートによる %1 のシリアル化解除を開始します。|シリアル化|  
+|[5004 \- DCDeserializeWithSurrogateStop](../../../../../docs/framework/wcf/diagnostics/etw/5004-dcdeserializewithsurrogatestop.md)|詳細|DataContract のサロゲートによるシリアル化解除を停止します。|シリアル化|  
+|[5005 \- ImportKnownTypesStart](../../../../../docs/framework/wcf/diagnostics/etw/5005-importknowntypesstart.md)|詳細|ImportKnownTypes を開始します。|シリアル化|  
+|[5006 \- ImportKnownTypesStop](../../../../../docs/framework/wcf/diagnostics/etw/5006-importknowntypesstop.md)|詳細|ImportKnownTypes を停止します。|シリアル化|  
+|[5007 \- DCResolverResolve](../../../../../docs/framework/wcf/diagnostics/etw/5007-dcresolverresolve.md)|詳細|DataContract リゾルバーが %1 の解決を開始します。|シリアル化|  
+|[5008 \- DCGenWriterStart](../../../../../docs/framework/wcf/diagnostics/etw/5008-dcgenwriterstart.md)|詳細|DataContract の %2 の %1 ライターの生成を開始します。|シリアル化|  
+|[5009 \- DCGenWriterStop](../../../../../docs/framework/wcf/diagnostics/etw/5009-dcgenwriterstop.md)|詳細|DataContract のライターの生成を停止します。|シリアル化|  
+|[5010 \- DCGenReaderStart](../../../../../docs/framework/wcf/diagnostics/etw/5010-dcgenreaderstart.md)|詳細|DataContract の %2 の %1 リーダーの生成を開始します。|シリアル化|  
+|[5011 \- DCGenReaderStop](../../../../../docs/framework/wcf/diagnostics/etw/5011-dcgenreaderstop.md)|詳細|DataContract の生成を停止します。|シリアル化|  
+|[5012 \- DCJsonGenReaderStart](../../../../../docs/framework/wcf/diagnostics/etw/5012-dcjsongenreaderstart.md)|詳細|Json の %2 の %1 リーダーの生成を開始します。|シリアル化|  
+|[5013 \- DCJsonGenReaderStop](../../../../../docs/framework/wcf/diagnostics/etw/5013-dcjsongenreaderstop.md)|詳細|Json のリーダーの生成を停止します。|シリアル化|  
+|[5014 \- DCJsonGenWriterStart](../../../../../docs/framework/wcf/diagnostics/etw/5014-dcjsongenwriterstart.md)|詳細|Json の %2 の %1 ライターの生成を開始します。|シリアル化|  
+|[5015 \- DCJsonGenWriterStop](../../../../../docs/framework/wcf/diagnostics/etw/5015-dcjsongenwriterstop.md)|詳細|Json のライターの生成を停止します。|シリアル化|  
+|[5016 \- GenXmlSerializableStart](../../../../../docs/framework/wcf/diagnostics/etw/5016-genxmlserializablestart.md)|詳細|'%1' の XML シリアル化が可能な要素の生成を開始します。|シリアル化|  
+|[5017 \- GenXmlSerializableStop](../../../../../docs/framework/wcf/diagnostics/etw/5017-genxmlserializablestop.md)|詳細|XML シリアル化が可能な要素の生成を停止します。|シリアル化|  
+|[5203 \- JsonMessageDecodingStart](../../../../../docs/framework/wcf/diagnostics/etw/5203-jsonmessagedecodingstart.md)|詳細|JsonMessageEncoder がメッセージのデコードを開始しました。|チャネル|  
+|[5204 \- JsonMessageEncodingStart](../../../../../docs/framework/wcf/diagnostics/etw/5204-jsonmessageencodingstart.md)|詳細|JsonMessageEncoder がメッセージのエンコードを開始しました。|チャネル|  
+|[5402 \- TokenValidationStarted](../../../../../docs/framework/wcf/diagnostics/etw/5402-tokenvalidationstarted.md)|詳細|SecurityToken \(型 '%1'、ID '%2'\) の検証を開始しました。|セキュリティ|  
+|[5403 \- TokenValidationSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5403-tokenvalidationsuccess.md)|詳細|SecurityToken \(型 '%1'、ID '%2'\) の検証に成功しました。|セキュリティ|  
+|[5404 \- TokenValidationFailure](../../../../../docs/framework/wcf/diagnostics/etw/5404-tokenvalidationfailure.md)|Error|SecurityToken \(型 '%1'、ID '%2'\) の検証に失敗しました。  %3|セキュリティ|  
+|[5405 \- GetIssuerNameSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5405-getissuernamesuccess.md)|詳細|トークン ID: %2 からの発行者名: %1 の取得に成功しました。|セキュリティ|  
+|[5406 \- GetIssuerNameFailure](../../../../../docs/framework/wcf/diagnostics/etw/5406-getissuernamefailure.md)|Error|トークン ID: %1 からの発行者名の取得に失敗しました。|セキュリティ|  
+|[5600 \- FederationMessageProcessingStarted](../../../../../docs/framework/wcf/diagnostics/etw/5600-federationmessageprocessingstarted.md)|詳細|フェデレーション メッセージの処理を開始しました。|セキュリティ|  
+|[5601 \- FederationMessageProcessingSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5601-federationmessageprocessingsuccess.md)|詳細|フェデレーション メッセージの処理に成功しました。|セキュリティ|  
+|[5602 \- FederationMessageCreationStarted](../../../../../docs/framework/wcf/diagnostics/etw/5602-federationmessagecreationstarted.md)|詳細|フォーム ポストからのフェデレーション メッセージの作成を開始しました。|セキュリティ|  
+|[5603 \- FederationMessageCreationSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5603-federationmessagecreationsuccess.md)|詳細|フォーム ポストからのフェデレーション メッセージの作成に成功しました。|セキュリティ|  
+|[5604 \- SessionCookieReadingStarted](../../../../../docs/framework/wcf/diagnostics/etw/5604-sessioncookiereadingstarted.md)|詳細|セッション クッキーからのセッション トークンの読み取りを開始しました。|セキュリティ|  
+|[5605 \- SessionCookieReadingSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5605-sessioncookiereadingsuccess.md)|詳細|セッション クッキーからのセッション トークンの読み取りに成功しました。|セキュリティ|  
+|[5606 \- PrincipalSettingFromSessionTokenStarted](../../../../../docs/framework/wcf/diagnostics/etw/5606-principalsettingfromsessiontokenstarted.md)|詳細|セッション トークンからのプリンシパルの設定を開始しました。|セキュリティ|  
+|[5607 \- PrincipalSettingFromSessionTokenSuccess](../../../../../docs/framework/wcf/diagnostics/etw/5607-principalsettingfromsessiontokensuccess.md)|詳細|セッション トークンからのプリンシパルの設定に成功しました。|セキュリティ|  
+|[57393 \- AppDomainUnload](../../../../../docs/framework/wcf/diagnostics/etw/57393-appdomainunload.md)|情報|AppDomain をアンロードしています。  AppDomain.FriendlyName %1、ProcessName %2、ProcessId %3。|インフラストラクチャ|  
+|[57394 \- HandledException](../../../../../docs/framework/wcf/diagnostics/etw/57394-handledexception.md)|情報|例外を処理しています。|インフラストラクチャ|  
+|[57395 \- ShipAssertExceptionMessage](../../../../../docs/framework/wcf/diagnostics/etw/57395-shipassertexceptionmessage.md)|Error|予期しないエラーが発生しました。  アプリケーションではこのエラーを処理することはできません。  診断上の目的から、次の英語のメッセージがエラーに関連付けられています: %1。|インフラストラクチャ|  
+|[57396 \- ThrowingException](../../../../../docs/framework/wcf/diagnostics/etw/57396-throwingexception.md)|警告|例外をスローしています。  発生元 %1。|インフラストラクチャ|  
+|[57397 \- UnhandledException](../../../../../docs/framework/wcf/diagnostics/etw/57397-unhandledexception.md)|Critical|ハンドルされていない例外です。|インフラストラクチャ|  
+|[57399 \- TraceCodeEventLogCritical](../../../../../docs/framework/wcf/diagnostics/etw/57399-tracecodeeventlogcritical.md)|Critical|イベント ログに書き込みました。|インフラストラクチャ|  
+|[57400 \- TraceCodeEventLogError](../../../../../docs/framework/wcf/diagnostics/etw/57400-tracecodeeventlogerror.md)|Error|イベント ログに書き込みました。|インフラストラクチャ|  
+|[57401 \- TraceCodeEventLogInfo](../../../../../docs/framework/wcf/diagnostics/etw/57401-tracecodeeventloginfo.md)|情報|イベント ログに書き込みました。|インフラストラクチャ|  
+|[57402 \- TraceCodeEventLogVerbose](../../../../../docs/framework/wcf/diagnostics/etw/57402-tracecodeeventlogverbose.md)|詳細|イベント ログに書き込みました。|インフラストラクチャ|  
+|[57403 \- TraceCodeEventLogWarning](../../../../../docs/framework/wcf/diagnostics/etw/57403-tracecodeeventlogwarning.md)|警告|イベント ログに書き込みました。|インフラストラクチャ|  
+|[57404 \- HandledExceptionWarning](../../../../../docs/framework/wcf/diagnostics/etw/57404-handledexceptionwarning.md)|警告|例外を処理しています。|インフラストラクチャ|  
+|[62326 \- HttpHandlerPickedForUrl](../../../../../docs/framework/wcf/diagnostics/etw/62326-httphandlerpickedforurl.md)|情報|URL '%1' は、ルート要素型 '%2' の XAML ドキュメントをホストします。  この URL に対して行われるすべての要求を処理するために、HTTP ハンドラー型 '%3' が選択されています。|WebHost|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/analytic-tracing-overview.md b/docs/framework/wcf/diagnostics/etw/analytic-tracing-overview.md
new file mode 100644
index 00000000000..2f0cbb1beef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/analytic-tracing-overview.md
@@ -0,0 +1,59 @@
+---
+title: "分析トレースの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "分析トレース [WCF], 概要"
+ms.assetid: ae55e9cc-0809-442f-921f-d644290ebf15
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# 分析トレースの概要
+[!INCLUDE[netfx_current_long](../../../../../includes/netfx-current-long-md.md)] の分析トレースは、Event Tracing for Windows \(ETW\) を基盤とするトレース機能のセットです。詳細度は低いのですが、パフォーマンスに優れています。 ETW は、カーネル レベルで実行され、トレース操作のオーバーヘッドを大幅に削減します。 ユーザー モードおよびカーネル モードのイベントを効率よくバッファーし、サービスの再起動を必要とすることなく、動的にログを有効化できます。 トレース データは、生成および受信されると、イベント ログから確認できます。  
+  
+ ETW の[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]については、「[ETW によりデバッグおよびパフォーマンス調整を改善する](http://go.microsoft.com/fwlink/?LinkId=164781)」を参照してください。  
+  
+ Windows のシステム、セキュリティ、およびアプリケーション イベント ログによるアプリケーションの分析のほかに、[!INCLUDE[wv](../../../../../includes/wv-md.md)] および [!INCLUDE[lserver](../../../../../includes/lserver-md.md)] では、最上位ノードの \[アプリケーションとサービス ログ\] の下にログが追加されています。 これらの新しいログは、システム全体に影響するグローバルなイベント \(セキュリティ イベント ログで記録されるようなイベントなど\) ではなく、特定のアプリケーションやコンポーネントのイベントを格納することを目的としています。[!INCLUDE[netfx_current_short](../../../../../includes/netfx-current-short-md.md)] では、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] トレース イベント、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージ ログ、および [!INCLUDE[wf1](../../../../../includes/wf1-md.md)] 追跡レコードのログを \[アプリケーションとサービス ログ\] にまとめ、相互に関連付けています。  
+  
+## 概念と機能  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 分析トレースには、次の概念と機能があります。  
+  
+### WCF 診断設定の有効化  
+ WCF の診断は、\<system.serviceModel\>\<\>diagnostics 構成セクション内で有効にします。  
+  
+```  
+  
+<system.serviceModel>  
+  <diagnostics>  
+  
+```  
+  
+ Web でホストされる IIS 仮想アプリケーションの WCF 診断の設定は、アプリケーションの Web.config ファイルで有効にします。 または、アプリケーション内のサブディレクトリに Web.config を作成することもできます。  この方法では、設定がサブディレクトリ内のすべてのサービスに適用されます。  診断設定が、アプリケーション内のすべてのサービスに対して一貫して初期化されるようにするには、これらの設定を、アプリケーション内の個別のサブディレクトリの 1 つではなく、アプリケーション ディレクトリ内の Web.config に含める必要があります。  
+  
+### チャネル  
+ ETW の場合、ソフトウェア コンポーネントは、チャネルを使用することで、トレース イベントをユーザーの種類に応じて振り分けることができます。 たとえば、システム管理者向けのイベントを 1 つのチャネルに送信し、アプリケーション開発者にとって重要なイベントを別のチャネルに送信できます。 チャネルには名前が付けられ、Windows に登録されるので、ユーザーは、特定のチャネルのイベントをイベント ビューアーを使用して確認できます。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の [!INCLUDE[netfx_current_short](../../../../../includes/netfx-current-short-md.md)] の分析トレース機能は、Microsoft\-Windows\-Application\-Server\-Applications チャネルに書き込みます。 このチャネルは、特に、運用中の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの状態を監視する必要があるユーザー向けに設計されています。 このチャネルでは、さまざまな状態監視およびトラブルシューティング シナリオで使用できるイベントがいくつか定義されています。  
+  
+ メッセージがイベント ログで正常にデコードされるように Event Tracing for Windows マニファストを有効にするために、次のようにコマンド ラインで ServiceModelReg ツールを使用します。  
+  
+ `ServiceModelReg.exe -i -c:etw`  
+  
+### 動的構成  
+ ETW のインフラストラクチャでは、標準の Windows ツールを使用して動的にトレースを有効化および構成できます。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)][分析トレースの動的な有効化](../../../../../docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md).  
+  
+### メッセージ フローのトレース  
+ メッセージ フローのトレースを有効にする方法の[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]については、「[メッセージ フローのトレースの構成](../../../../../docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md)」を参照してください。  
+  
+### キーワード  
+ キーワードは、トレース メッセージをフィルター処理するため、およびイベントを生成した [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] コンポーネントを定義するために使用されます。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)] [分析トレースの動的な有効化](../../../../../docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md)。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md b/docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md
new file mode 100644
index 00000000000..664dadf747a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md
@@ -0,0 +1,64 @@
+---
+title: "メッセージ フローのトレースの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15571ca2-bee2-47fb-ba10-fcbc09152ad0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# メッセージ フローのトレースの構成
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] のアクティビティ トレースが有効な場合は、エンド ツー エンド アクティビティ ID が、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] スタック全体で論理アクティビティに割り当てられます。  [!INCLUDE[netfx_current_short](../../../../../includes/netfx-current-short-md.md)] では、この機能の高パフォーマンス バージョンが導入されており、"メッセージ フローのトレース" と呼ばれる Event Tracing for Windows \(ETW\) と連携します。  この機能が有効な場合は、エンド ツー エンド アクティビティ ID が受信メッセージから取得され \(空の場合は割り当てられ\)、チャネルによってメッセージがデコードされた後に生成されたすべてのトレース イベントに伝達されます。  ユーザーはこの機能を使用して、デコード後に、異なるサービスから取得したトレース ログでメッセージ フローを再構築できます。  
+  
+ トレースは、アプリケーションで問題が検出された後に有効にし、その問題が解決された後は無効にすることができます。  
+  
+## トレースの有効化  
+ メッセージ フローのトレースを有効にするには、次の例に示すように、.NET Framework 4 の `messageFlowTracing` 構成要素を `true` に設定します。  
+  
+```  
+<system.servicemodel>  
+  <diagnostics>  
+    <endToEndTracing propagateActivity="true" messageFlowTracing="true" />  
+  </diagnostics>  
+</system.servicemodel>  
+  
+```  
+  
+> [!NOTE]
+>  `endToEndTracing` 構成要素は Web.config ファイル内にあるため、ETW と同じ方法で動的に構成することはできません。  `endToEndTracing` 構成要素を有効にするには、アプリケーションをリサイクルする必要があります。  
+  
+ アクティビティはアクティビティ ID と呼ばれる識別子の交換によって関連付けられます。  この識別子は GUID で、System.Diagnostics.CorrelationManager クラスによって生成されます。  System.Diagnostics.Trace.CorrelationManager.ActivityID を操作する場合は、実行の制御が WCF コードに転送を返すときに値を元の値に設定するようにしてください。  また、非同期 WCF プログラミング モデルを使用する場合は、System.Diagnostics.Trace.CorrelationManager.ActivityID がスレッド間で転送されるようにしてください。  
+  
+## メッセージ フローのトレース REST サービス  
+ メッセージ フローのトレースでは、要求をエンドツーエンドでトレースできます。  SOAP ベースのサービスでは、アクティビティ ID は、SOAP メッセージのヘッダー内で送信されます。  REST 要求にはこのヘッダーは含まれないため、代わりに、特殊な HTTP イベント ヘッダーが使用されます。  次のコード スニペットには、アクティビティ ID をプログラムで取得する方法が示されています。  
+  
+```vb  
+  
+Object output = null;                    
+if (OperationContext.Current.IncomingMessageProperties.TryGetValue(HttpRequestMessageProperty.Name, out output))  
+{  
+   HttpRequestMessageProperty httpHeaders = output as HttpRequestMessageProperty;       
+   // Retrieve the Activity Id from the HTTP header    string e2eId = httpHeaders.Headers["E2EActivity"];  
+   // ...  
+}  
+  
+```  
+  
+ 次のコードを使用するとプログラムでヘッダーを追加できます。  
+  
+```csharp  
+  
+HttpContent content = new StreamContent(contentStream);  
+Guid correlation = Guid.NewGuid();  
+content.Headers.Add("E2EActivity", Convert.ToBase64String(correlation.ToByteArray()));  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/determining-service-operation-duration.md b/docs/framework/wcf/diagnostics/etw/determining-service-operation-duration.md
new file mode 100644
index 00000000000..a6ba10b9d12
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/determining-service-operation-duration.md
@@ -0,0 +1,37 @@
+---
+title: "サービス操作の実行時間の確認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8a93a2c-2c20-48b3-8986-57e90e9aa908
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービス操作の実行時間の確認
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションで分析トレースを有効にしている場合、イベント ログを調べるだけでサービス操作の実行時間を簡単に確認できます。  ここでは、サービス操作の実行にかかる時間を確認する方法を示します。  
+  
+### サービス操作の実行時間の確認  
+  
+1.  **\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックし、「`eventvwr.exe`」と入力してイベント ビューアーを開きます。  
+  
+2.  分析トレースを有効にしていない場合は、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に展開します。  **\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。  **\[分析\]** を右クリックし、**\[ログを有効にする\]** をクリックします。  サービス操作が実行された後にトレースを表示できるように、イベント ビューアーを開いたままにしておきます。  
+  
+3.  次に、サービス プロジェクトおよびそのサービスと対話するクライアント プロジェクトが含まれている [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アプリケーションを開きます。  このようなアプリケーションの作成方法については、「[チュートリアル入門](../../../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サンプルがインストールされている場合、このチュートリアルで作成する完成済みのプロジェクトが含まれている[概要](../../../../../docs/framework/wcf/samples/getting-started-sample.md)を開くことができます。  
+  
+4.  **F5** キーを押してサーバー アプリケーションを実行します。  **Client** プロジェクトを右クリックし、**\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックして、クライアント アプリケーションを実行します。  
+  
+5.  イベント ビューアーで、分析ログを更新し、イベント ID でイベントを並べ替えます。  イベント ID が [214 \- OperationCompleted](../../../../../docs/framework/wcf/diagnostics/etw/214-operationcompleted.md) のイベントを探します。  これらのイベントは、完了した操作、およびその操作にかかった時間を示します。  次のイベントは、追加操作の時間を示しています。  
+  
+    ```Output  
+  
+    OperationInvoker がメソッド 'Add' への呼び出しを完了しました。  メソッド呼び出し時間は '3' ミリ秒でした。    
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md b/docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md
new file mode 100644
index 00000000000..ca42b46b295
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md
@@ -0,0 +1,51 @@
+---
+title: "分析トレースの動的な有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58b63cfc-307a-427d-b69d-9917ff9f44ac
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 分析トレースの動的な有効化
+Windows オペレーティング システムに付属のツールでは、ETW \(Event Tracing for Windows\) を使用して、トレースを動的に有効化または無効化できます。 すべての [!INCLUDE[netfx_current_long](../../../../../includes/netfx-current-long-md.md)] [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] サービスについては、アプリケーションの Web.config ファイルを変更したり、サービスを再起動したりせずに、分析トレースを動的に有効化および無効化できます。 このため、トレース イベントを生成するアプリケーションに影響が生じません。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のトレース オプションも同様に構成できます。 たとえば、アプリケーションに影響を与えずに、重大度レベルを **Error** から **Information** に変更できます。 これは、次のツールで実行できます。  
+  
+-   **Logman**: トレース データを構成、制御、および照会するためのコマンド ライン ツールです。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)][logman create trace](http://go.microsoft.com/fwlink/?LinkId=165426)」と「[logman update trace](http://go.microsoft.com/fwlink/?LinkId=165427)」を参照してください。  
+  
+-   **EventViewer**: トレース結果を表示するための、Windows のグラフィカル管理ツールです。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)][WCF サービスと Event Tracing for Windows](../../../../../docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md)」および「[イベント ビューアー](http://go.microsoft.com/fwlink/?LinkId=165428)」を参照してください。  
+  
+-   **Perfmon**: カウンターを使用して、トレース カウンターおよびパフォーマンス トレースの効果を監視する、Windows のグラフィカル管理ツールです。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)][データ コレクター セットを手動で作成する](http://go.microsoft.com/fwlink/?LinkId=165429)」を参照してください。  
+  
+### キーワード  
+ <xref:System.ServiceModel.Activation.Configuration.ServiceModelActivationSectionGroup.Diagnostics%2A> クラスを使用するときには、通常、.NET Framework トレース メッセージが重大度レベル \(エラー、警告、情報など\) でフィルターされます。 ETW は、重大度レベルの概念をサポートしますが、キーワードを使用して、新しい柔軟なフィルター機構も追加されています。 キーワードは任意のテキスト値で、これによって、トレース イベントでそのイベントの意味に関する追加のコンテキストが提供されます。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の分析トレースでは、各トレース イベントに 2 種類のキーワードがあります。 まず、各イベントには 1 つ以上のシナリオ キーワードがあります。 これらのキーワードは、そのイベントがサポートするシナリオを示します。 次の表に示すように、特定の目的に対応する 3 つのシナリオ キーワードがあります。 キーワードを使用したフィルター処理は、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスに影響を与えずに動的に変更できます。 このため、現在のトレース シナリオおよび収集するトレース情報の量を動的に変更できます。 たとえば、`HealthMonitoring` を `Troubleshooting` に変更し、トレース イベントの詳細度を上げることができます。  
+  
+|キーワード|説明|  
+|-----------|--------|  
+|`HealthMonitoring`|サービスのアクティビティを監視できる、軽量の、最小限のトレース。|  
+|`EndToEndMonitoring`|メッセージ フロー トレースのサポートに使用するイベント。|  
+|`Troubleshooting`|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の拡張ポイントに関連するより詳細なイベント。|  
+  
+ キーワードの 2 番目のグループは、[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] のどのコンポーネントがイベントを生成するかを定義します。  
+  
+|キーワード|説明|  
+|-----------|--------|  
+|`UserEvents`|[!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] ではなく、ユーザー コードが生成するイベント。|  
+|`ServiceModel`|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] ランタイムが生成するイベント。|  
+|`ServiceHost`|サービス ホストが生成するイベント。|  
+|`WCFMessageLogging`|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージ ログ イベント。|  
+  
+## 参照  
+ [WCF サービスと Event Tracing for Windows](../../../../../docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/index.md b/docs/framework/wcf/diagnostics/etw/index.md
new file mode 100644
index 00000000000..a1258766b8a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/index.md
@@ -0,0 +1,41 @@
+---
+title: "Analytic Tracing with ETW | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "diagnostics [WCF], analytic tracing"
+  - "administration [WCF], analytic tracing"
+  - "analytic tracing [WCF]"
+ms.assetid: 1d518e47-a38d-41e8-93d7-8c3b361f6a56
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Analytic Tracing with ETW
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] の分析トレースでは、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの実行中に診断情報をキャプチャする手段が提供されます。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] スタック内のキー ポイントで [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の分析トレース イベントが生成され、運用環境での [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスのトラブルシューティングが可能になります。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの分析トレースは、[!INCLUDE[netfx_current_long](../../../../../includes/netfx-current-long-md.md)] [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスをホストする運用サーバーのパフォーマンスに最小限の影響しか与えません。これは、これらのイベントが効率的に ETW \(Event Tracing for Windows\) セッションに送出されるためです。  
+  
+## このセクションの内容  
+ [分析トレースの概要](../../../../../docs/framework/wcf/diagnostics/etw/analytic-tracing-overview.md)  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の分析トレースが [!INCLUDE[netfx_current_long](../../../../../includes/netfx-current-long-md.md)] でどのように機能するかについて説明します。  
+  
+ [分析トレースの動的な有効化](../../../../../docs/framework/wcf/diagnostics/etw/dynamically-enabling-analytic-tracing.md)  
+ ETW を使用してトレースを動的に有効化または無効化する方法について説明します。  
+  
+ [メッセージ フローのトレースの構成](../../../../../docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md)  
+ メッセージ フローのトレースを構成する方法について説明します。  
+  
+ [分析トレース イベント リファレンス](../../../../../docs/framework/wcf/diagnostics/etw/analytic-trace-event-reference.md)  
+ イベント ID とそれらのイベント レベル、イベント メッセージ、およびキーワードを表で示します。  
+  
+## 参照  
+ [WCF サービスと Event Tracing for Windows](../../../../../docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md)   
+ [Windows のイベント トレースへの追跡イベント](../../../../../docs/framework/windows-workflow-foundation/samples/tracking-events-into-event-tracing-in-windows.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/etw/monitoring-service-operation-failures.md b/docs/framework/wcf/diagnostics/etw/monitoring-service-operation-failures.md
new file mode 100644
index 00000000000..33127a79b94
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/etw/monitoring-service-operation-failures.md
@@ -0,0 +1,59 @@
+---
+title: "サービス操作エラーの監視 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 59472ba3-8ebf-4479-bd7b-f440d5e636cb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# サービス操作エラーの監視
+アプリケーションに対して分析トレースが有効になっている場合、サービス エラーはイベント ビューアーで簡単に監視できます。ここでは、サービス操作が失敗したことを確認する方法、およびエラーの原因を特定する方法を示します。  
+  
+### サービス操作エラーに関する情報の確認  
+  
+1.  **\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックし、「`eventvwr.exe`」と入力してイベント ビューアーを開きます。  
+  
+2.  分析トレースを有効にしていない場合は、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に展開します。**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。**\[分析\]** を右クリックし、**\[ログを有効にする\]** を選択します。サービス操作が失敗した後にトレースを表示できるように、イベント ビューアーを開いたままにしておきます。  
+  
+3.  次に、[!INCLUDE[vs_current_long](../../../../../includes/vs-current-long-md.md)] の「[チュートリアル入門](../../../../../docs/framework/wcf/getting-started-tutorial.md)」で作成したサンプルを開きます。サービスを作成できるように、管理者として [!INCLUDE[vs_current_long](../../../../../includes/vs-current-long-md.md)] を実行する必要があることに注意してください。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サンプルがインストールされている場合、このチュートリアルで作成する完成済みのプロジェクトが含まれている[概要](../../../../../docs/framework/wcf/samples/getting-started-sample.md)を開くことができます。  
+  
+4.  Server プロジェクトの Program.cs ファイルで、`CalculatorService` クラスの `Divide` メソッドの先頭に次のコード行を追加します。  
+  
+    ```  
+    if (n2 == 0) throw new DivideByZeroException();  
+  
+    ```  
+  
+5.  クライアント プロジェクトの Program.cs ファイルで、value2 に割り当てる値をゼロに変更します。  
+  
+    ```  
+    //Call the Divide service operation  
+    value1 = 22.00D;  
+    value2 = 0.00D;  
+    result = client.Divide(value1, value2);  
+    Console.WriteLine("Divide({0}, {1}) = {2}", value1, value2, result);  
+  
+    ```  
+  
+6.  **Ctrl** キーを押しながら F5 キーを押して、サーバー アプリケーションをデバッグなしで実行します。  
+  
+7.  Visual Studio コマンド プロンプトを開きます。クライアント ディレクトリに移動し、コマンド ラインからクライアントを実行します。  
+  
+8.  イベント ビューアーで、分析ログを無効化および更新し、イベント ID でイベントを並べ替えます。サービス エラーを示すイベント ID [219 \- ServiceException](../../../../../docs/framework/wcf/diagnostics/etw/219-serviceexception.md) のイベントを検索します。  
+  
+    ```Output  
+    メッセージの処理中に種類 'System.DivideByZeroException' のハンドルされない例外がスローされました。完全な例外の ToString: System.DivideByZeroException: 0 で除算しようとしました。  
+    ```  
+  
+    > [!NOTE]
+    >  イベントは、イベント ビューアーへの送信時にバッファーされます。そのため、エラー イベントはすぐに表示されない場合があります。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/TOC.md b/docs/framework/wcf/diagnostics/event-logging/TOC.md
new file mode 100644
index 00000000000..666b0743e5a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/TOC.md
@@ -0,0 +1,79 @@
+# [ComPlusTLBImportError](complustlbimporterror.md)
+# [PiiLoggingNotAllowed](piiloggingnotallowed.md)
+# [ComPlusInstanceCreationError](complusinstancecreationerror.md)
+# [UnhandledStateMachineExceptionRecordDescription](unhandledstatemachineexceptionrecorddescription.md)
+# [UnknownListenerAdapterError](unknownlisteneradaptererror.md)
+# [FailFastException](failfastexception.md)
+# [ThumbPrintNotValidated](thumbprintnotvalidated.md)
+# [WmiAdminTypeMismatch](wmiadmintypemismatch.md)
+# [WebHostHttpError](webhosthttperror.md)
+# [FailedToSetupTracing](failedtosetuptracing.md)
+# [StartErrorPublish](starterrorpublish.md)
+# [ComPlusInvokingMethodFailedMismatchedTransactions](complusinvokingmethodfailedmismatchedtransactions.md)
+# [FailedToInitializeTraceSource](failedtoinitializetracesource.md)
+# [MessageAuthenticationFailure](messageauthenticationfailure.md)
+# [イベント一覧](events-general-reference.md)
+# [FailedToRemovePerformanceCounter](failedtoremoveperformancecounter.md)
+# [WmiCreateInstanceFailed](wmicreateinstancefailed.md)
+# [NonFatalUnexpectedStateMachineEvent](nonfatalunexpectedstatemachineevent.md)
+# [WasConnectionTimedout](wasconnectiontimedout.md)
+# [ProtocolStopped](protocolstopped.md)
+# [FailedToLoadPerformanceCounter](failedtoloadperformancecounter.md)
+# [ProtocolStartFailure](protocolstartfailure.md)
+# [MessageLoggingOn](messageloggingon.md)
+# [FailedToTraceEventWithException](failedtotraceeventwithexception.md)
+# [TransportAuthenticationFailure](transportauthenticationfailure.md)
+# [ComPlusDllHostInitializerStartingError](complusdllhostinitializerstartingerror.md)
+# [MissingNecessaryKeyUsage](missingnecessarykeyusage.md)
+# [ParticipantRecoveryLogEntryCorrupt](participantrecoverylogentrycorrupt.md)
+# [イベント ログ](index.md)
+# [ComPlusInvokingMethodFailed](complusinvokingmethodfailed.md)
+# [ServiceAuthorizationFailure](serviceauthorizationfailure.md)
+# [TransactionBridgeRecoveryFailure](transactionbridgerecoveryfailure.md)
+# [FailedToTraceEvent](failedtotraceevent.md)
+# [CoordinatorRecoveryLogEntryCreationFailure](coordinatorrecoverylogentrycreationfailure.md)
+# [WebHostUnhandledException](webhostunhandledexception.md)
+# [MissingNecessaryEnhancedKeyUsage](missingnecessaryenhancedkeyusage.md)
+# [MessageLoggingOff](messageloggingoff.md)
+# [MessageQueueDuplicatedSocketLeak](messagequeueduplicatedsocketleak.md)
+# [InvariantAssertionFailed](invariantassertionfailed.md)
+# [SslNoAccessiblePrivateKey](sslnoaccessibleprivatekey.md)
+# [LAFailedToListenForApp](lafailedtolistenforapp.md)
+# [ProtocolInitializationFailure](protocolinitializationfailure.md)
+# [WmiExecMethodFailed](wmiexecmethodfailed.md)
+# [ProtocolStopFailure](protocolstopfailure.md)
+# [SecurityNegotiationSuccess](securitynegotiationsuccess.md)
+# [PerformanceCounterInitializationFailure](performancecounterinitializationfailure.md)
+# [WasDisconnected](wasdisconnected.md)
+# [WmiUnregistrationFailed](wmiunregistrationfailed.md)
+# [TransportAuthenticationSuccess](transportauthenticationsuccess.md)
+# [FailedToCreateMessageLoggingTraceSource](failedtocreatemessageloggingtracesource.md)
+# [MessageAuthenticationSuccess](messageauthenticationsuccess.md)
+# [MessageQueueDuplicatedPipeLeak](messagequeueduplicatedpipeleak.md)
+# [ProtocolRecoveryComplete](protocolrecoverycomplete.md)
+# [WmiRegistrationFailed](wmiregistrationfailed.md)
+# [SslNoPrivateKey](sslnoprivatekey.md)
+# [WmiGetObjectFailed](wmigetobjectfailed.md)
+# [FailedToLogMessage](failedtologmessage.md)
+# [FatalUnexpectedStateMachineEvent](fatalunexpectedstatemachineevent.md)
+# [FailFast](failfast.md)
+# [ServiceAuthorizationSuccess](serviceauthorizationsuccess.md)
+# [WmiDeleteInstanceFailed](wmideleteinstancefailed.md)
+# [ProtocolRecoveryBeginningFailure](protocolrecoverybeginningfailure.md)
+# [WmiExecQueryFailed](wmiexecqueryfailed.md)
+# [CoordinatorRecoveryLogEntryCorrupt](coordinatorrecoverylogentrycorrupt.md)
+# [ProtocolRecoveryCompleteFailure](protocolrecoverycompletefailure.md)
+# [ServiceStartFailed](servicestartfailed.md)
+# [WebHostFailedToListen](webhostfailedtolisten.md)
+# [ImpersonationFailure](impersonationfailure.md)
+# [TraceCodeRemovedBadFilter](tracecoderemovedbadfilter.md)
+# [ImpersonationSuccess](impersonationsuccess.md)
+# [SecurityNegotiationFailure](securitynegotiationfailure.md)
+# [WmiPutInstanceFailed](wmiputinstancefailed.md)
+# [BindingError](bindingerror.md)
+# [WebHostFailedToProcessRequest](webhostfailedtoprocessrequest.md)
+# [WmiPropertyMissing](wmipropertymissing.md)
+# [ComPlusServiceHostStartingServiceError](complusservicehoststartingserviceerror.md)
+# [ThumbPrintNotFound](thumbprintnotfound.md)
+# [ParticipantRecoveryLogEntryCreationFailure](participantrecoverylogentrycreationfailure.md)
+# [PiiLoggingOn](piiloggingon.md)
diff --git a/docs/framework/wcf/diagnostics/event-logging/bindingerror.md b/docs/framework/wcf/diagnostics/event-logging/bindingerror.md
new file mode 100644
index 00000000000..4d2d286c95d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/bindingerror.md
@@ -0,0 +1,31 @@
+---
+title: "BindingError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19d90e9d-c92a-4ca7-ba31-aa07882bb81e
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# BindingError
+ID : 159  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SMSvcHost  
+  
+## 説明  
+ このイベントは、特定のサイトの特定のバインディングの解析中にエラーが発生したため、このサイトのプロトコルが一時的に無効になっていることを示します。イベントには、バインディング、ソース、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complusdllhostinitializerstartingerror.md b/docs/framework/wcf/diagnostics/event-logging/complusdllhostinitializerstartingerror.md
new file mode 100644
index 00000000000..99e3a6f9707
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complusdllhostinitializerstartingerror.md
@@ -0,0 +1,31 @@
+---
+title: "ComPlusDllHostInitializerStartingError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad7d176a-cf40-412a-9335-eef64a25454a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusDllHostInitializerStartingError
+ID : 131  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、DllHost 初期化子の開始時にエラーが発生したことを示します。イベントには、AppID、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complusinstancecreationerror.md b/docs/framework/wcf/diagnostics/event-logging/complusinstancecreationerror.md
new file mode 100644
index 00000000000..f692c1bd65d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complusinstancecreationerror.md
@@ -0,0 +1,31 @@
+---
+title: "ComPlusInstanceCreationError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f54078e6-7de0-4d0e-bda7-a420da110311
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusInstanceCreationError
+ID : 134  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ COM\+ : COM インスタンスの作成中にエラーが発生しました。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailed.md b/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailed.md
new file mode 100644
index 00000000000..afaee54a6c5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailed.md
@@ -0,0 +1,28 @@
+---
+title: "ComPlusInvokingMethodFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa435a6d-87a1-468e-a73a-f287fcf697c3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusInvokingMethodFailed
+ID : 133  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailedmismatchedtransactions.md b/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailedmismatchedtransactions.md
new file mode 100644
index 00000000000..dbc1e4249aa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complusinvokingmethodfailedmismatchedtransactions.md
@@ -0,0 +1,31 @@
+---
+title: "ComPlusInvokingMethodFailedMismatchedTransactions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d13f1978-ff42-443a-939f-75c8c8d50286
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusInvokingMethodFailedMismatchedTransactions
+ID : 135  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ ComPlus: メソッド呼び出しのトランザクションが一致しません。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complusservicehoststartingserviceerror.md b/docs/framework/wcf/diagnostics/event-logging/complusservicehoststartingserviceerror.md
new file mode 100644
index 00000000000..933e62f7638
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complusservicehoststartingserviceerror.md
@@ -0,0 +1,31 @@
+---
+title: "ComPlusServiceHostStartingServiceError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 10994991-3717-4352-ad58-c22c3eff60d5
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusServiceHostStartingServiceError
+ID : 130  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、COM\+ サービスの開始時にエラーが発生したことを示します。イベントには、AppID、CLSID、サロゲート、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/complustlbimporterror.md b/docs/framework/wcf/diagnostics/event-logging/complustlbimporterror.md
new file mode 100644
index 00000000000..4b2238e3ba1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/complustlbimporterror.md
@@ -0,0 +1,31 @@
+---
+title: "ComPlusTLBImportError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe087e97-efbb-4006-8465-ec2ff7860c7b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ComPlusTLBImportError
+ID : 132  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、タイプ ライブラリのインポート中にエラーが発生したことを示します。  イベントには、IID、タイプ ライブラリ ID、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycorrupt.md b/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycorrupt.md
new file mode 100644
index 00000000000..8d7030d65f8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycorrupt.md
@@ -0,0 +1,31 @@
+---
+title: "CoordinatorRecoveryLogEntryCorrupt | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3cd0c3e3-84c8-4d43-a561-a8851c78e565
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# CoordinatorRecoveryLogEntryCorrupt
+ID: 139  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、コーディネーターの回復ログ エントリが破損し、逆シリアル化できなかったことを示します。このエラーが原因で、データの損失が発生することがあります。イベントには、トランザクション ID、回復データ \(Base64 エンコード\)、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycreationfailure.md b/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycreationfailure.md
new file mode 100644
index 00000000000..982a4a10065
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/coordinatorrecoverylogentrycreationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "CoordinatorRecoveryLogEntryCreationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f2b1a5c-f5a6-4203-87ff-601635b9ae40
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# CoordinatorRecoveryLogEntryCreationFailure
+ID : 140  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ 回復ログのエントリを、コーディネーターの登録用に生成できませんでした。トランザクションは中止されます。イベントには、トランザクション ID、理由、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/events-general-reference.md b/docs/framework/wcf/diagnostics/event-logging/events-general-reference.md
new file mode 100644
index 00000000000..89c20ae77c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/events-general-reference.md
@@ -0,0 +1,20 @@
+---
+title: "イベント一覧 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c77b8029-64f4-48c6-a67a-2999f417495d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# イベント一覧
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] によって送出されるすべてのイベントを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtocreatemessageloggingtracesource.md b/docs/framework/wcf/diagnostics/event-logging/failedtocreatemessageloggingtracesource.md
new file mode 100644
index 00000000000..6c6685782a7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtocreatemessageloggingtracesource.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToCreateMessageLoggingTraceSource | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75e91aad-6d83-4e5e-8c70-fed1625e522f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# FailedToCreateMessageLoggingTraceSource
+ID : 115  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、メッセージ ログでトレース ソースを作成できなかったことを示します。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtoinitializetracesource.md b/docs/framework/wcf/diagnostics/event-logging/failedtoinitializetracesource.md
new file mode 100644
index 00000000000..647b047d8cb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtoinitializetracesource.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToInitializeTraceSource | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ce6fea55-292c-4fb9-908e-3713fcd4cf8f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailedToInitializeTraceSource
+ID : 101  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ トレース ソースは初期化されませんでした。  トレースは無効になります。  イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtoloadperformancecounter.md b/docs/framework/wcf/diagnostics/event-logging/failedtoloadperformancecounter.md
new file mode 100644
index 00000000000..3922f8d588c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtoloadperformancecounter.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToLoadPerformanceCounter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb333946-738e-4937-808e-5b6c0ac44e1b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# FailedToLoadPerformanceCounter
+ID : 118  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、パフォーマンス カウンターが読み込まれなかったことを示します。  イベントには、カテゴリ名、カウンター名、インスタンス名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtologmessage.md b/docs/framework/wcf/diagnostics/event-logging/failedtologmessage.md
new file mode 100644
index 00000000000..75f2fbaa49b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtologmessage.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToLogMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 589d5af7-685f-4456-bebf-d6d6fa1f8475
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# FailedToLogMessage
+ID : 113  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、メッセージがログに記録されなかったことを示します。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtoremoveperformancecounter.md b/docs/framework/wcf/diagnostics/event-logging/failedtoremoveperformancecounter.md
new file mode 100644
index 00000000000..da8ea79b38f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtoremoveperformancecounter.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToRemovePerformanceCounter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c5991c11-f8a9-46ab-94e8-b30ea8e3c12f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# FailedToRemovePerformanceCounter
+ID : 119  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、パフォーマンス カウンターが削除されなかったことを示します。  イベントには、カテゴリ名、カウンター名、インスタンス名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtosetuptracing.md b/docs/framework/wcf/diagnostics/event-logging/failedtosetuptracing.md
new file mode 100644
index 00000000000..725745dd8fc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtosetuptracing.md
@@ -0,0 +1,33 @@
+---
+title: "FailedToSetupTracing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dd61db93-4687-4832-8dc9-99e38fa83671
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailedToSetupTracing
+ID : 100  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ トレースを設定できませんでした。  トレースは無効になります。  
+  
+ イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtotraceevent.md b/docs/framework/wcf/diagnostics/event-logging/failedtotraceevent.md
new file mode 100644
index 00000000000..9ab128a2a0c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtotraceevent.md
@@ -0,0 +1,31 @@
+---
+title: "FailedToTraceEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a13f19e3-a6e0-4e58-bb45-73bed6cf4421
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailedToTraceEvent
+ID : 104  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ イベント \(1 つまたは複数\) はトレースされませんでした。イベントには、元のイベント文字列、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failedtotraceeventwithexception.md b/docs/framework/wcf/diagnostics/event-logging/failedtotraceeventwithexception.md
new file mode 100644
index 00000000000..2e8f54b8c4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failedtotraceeventwithexception.md
@@ -0,0 +1,33 @@
+---
+title: "FailedToTraceEventWithException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b605b2b8-acd6-4762-8269-b025758a2404
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailedToTraceEventWithException
+ID : 105  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ イベント \(1 つまたは複数\) はトレースされませんでした。  
+  
+ イベントには、元のイベント文字列、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failfast.md b/docs/framework/wcf/diagnostics/event-logging/failfast.md
new file mode 100644
index 00000000000..13145caa38d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failfast.md
@@ -0,0 +1,31 @@
+---
+title: "FailFast | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4fc4e476-997b-4166-90af-8d164f775924
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailFast
+ID : 102  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ FailFast が呼び出されました。イベントには、メッセージ、スタック トレース、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/failfastexception.md b/docs/framework/wcf/diagnostics/event-logging/failfastexception.md
new file mode 100644
index 00000000000..568afa46b35
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/failfastexception.md
@@ -0,0 +1,31 @@
+---
+title: "FailFastException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f30de0d9-3a91-4800-9d09-3504d7e5a10f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# FailFastException
+ID : 103  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ FailFast 中に例外がスローされました。  イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/fatalunexpectedstatemachineevent.md b/docs/framework/wcf/diagnostics/event-logging/fatalunexpectedstatemachineevent.md
new file mode 100644
index 00000000000..31fbf1244b2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/fatalunexpectedstatemachineevent.md
@@ -0,0 +1,31 @@
+---
+title: "FatalUnexpectedStateMachineEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57714066-921f-4ced-90a7-5fdd3dd79552
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# FatalUnexpectedStateMachineEvent
+ID : 137  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、ステート マシンが予期しないイベントを処理しようとしたことを示します。このイベントは致命的なものと見なされました。イベントには、トランザクション ID、ステート マシン、現在の状態、履歴、イベント名、イベントの詳細、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/impersonationfailure.md b/docs/framework/wcf/diagnostics/event-logging/impersonationfailure.md
new file mode 100644
index 00000000000..9f61de2989a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/impersonationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ImpersonationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3005d73d-2164-4ed0-9da1-9f83bd5b9d06
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ImpersonationFailure
+ID : 176  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは偽装が失敗したことを示し、メソッド名、クライアント ID、およびアクティビティ ID を表示します。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/impersonationsuccess.md b/docs/framework/wcf/diagnostics/event-logging/impersonationsuccess.md
new file mode 100644
index 00000000000..a099e0b823c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/impersonationsuccess.md
@@ -0,0 +1,31 @@
+---
+title: "ImpersonationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 20b2ab9c-7ced-45d6-8bb0-d480e186102e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ImpersonationSuccess
+ID : 175  
+  
+ 重大度 : 情報  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは偽装が成功したことを示し、メソッド名、クライアント ID、およびアクティビティ ID を表示します。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/index.md b/docs/framework/wcf/diagnostics/event-logging/index.md
new file mode 100644
index 00000000000..736a16095d7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/index.md
@@ -0,0 +1,59 @@
+---
+title: "WCF のイベント ログ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ログ [WCF]"
+ms.assetid: aac0530d-f44c-45a1-bada-e30e0677b41f
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# WCF のイベント ログ
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は、Windows イベント ログで内部イベントをトレースします。  
+  
+## イベント ログの表示  
+ イベント ログは、既定で自動的に有効になります。無効にする方法はありません。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によってログに記録されるイベントは、イベント ビューアーを使用して表示できます。このツールを起動するには、**\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]** をクリックします。次に、**\[管理ツール\]** をダブルクリックし、**\[イベント ビューアー\]** をダブルクリックします。  
+  
+### アプリケーション イベント ログ  
+ **アプリケーション イベント ログ**には、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によって生成されるイベントの大半が含まれています。このエントリの多くは、アプリケーションに関して特定の機能を起動できなかったことを示しています。ログの内容には次のような種類があります。  
+  
+-   メッセージのログ記録とトレース : [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では、トレースとメッセージのログ記録に失敗すると、イベント ログにイベントが記録されます。ただし、トレース エラーが発生するたびにイベントがトリガーされるわけではありません。イベント ログがトレース エラーでいっぱいになってしまう状況を回避するために、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では、このようなイベントに 10 分のブラックアウト期間を設けています。つまり、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] がトレース エラーをイベント ログに書き込んだ後、少なくとも 10 分間はトレース エラーのログ記録が行われません。  
+  
+-   共有リスナー : WCF TCP ポート共有サービスが開始に失敗すると、イベントがログに記録されます。  
+  
+-   [!INCLUDE[infocard](../../../../../includes/infocard-md.md)]: サービスが開始に失敗すると、イベントがログに記録されます。  
+  
+-   起動エラーやクラッシュなど、重大なエラー イベント。  
+  
+-   メッセージ ログの有効化 : メッセージ ログが有効化された場合に、イベントがログに記録されます。これには機密情報やアプリケーション固有の情報がメッセージのヘッダーや本文に記録されている可能性があることを管理者に知らせる目的があります。  
+  
+-   `machine.config` ファイルの `machineSettings` 要素で、`enableLoggingKnownPII` 属性が設定されている場合、イベントはログに記録されます。この属性は、コンピューター上で実行しているアプリケーションが、既知の個人を特定できる情報 \(PII\) をログに記録できるかどうかを指定します。  
+  
+-   特定のアプリケーションで PII ログを有効にするために、`app.config` ファイルまたは `web.config` ファイルの `logKnownPii` 属性が `true` に設定され、`machine.config` ファイルの `machineSettings` 要素で、`enableLoggingKnownPII` 属性が `false` に設定されている場合、イベントはログに記録されます。また、`logKnownPii` と `enableLoggingKnownPII` の両方が `true` に設定されている場合、イベントはログに記録されます。このような構成設定の詳細については、「[メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)」のセキュリティに関するセクションを参照してください。  
+  
+### セキュリティ イベント ログ  
+ **セキュリティ イベント ログ**には、WCF によってログ記録されたセキュリティ監査イベントが書き込まれます。  
+  
+### システム イベント ログ  
+ WCF では、**システム イベント ログ**に対する記録は行われません。  
+  
+### イベント ログ エントリ  
+ イベントの**ソース**は、ログ エントリを生成するアセンブリの名前です。  
+  
+ イベント ログ エントリの型によって、イベントの重大度がわかります。各イベントは単一の型でなければなりません。アプリケーションがイベントをレポートする際には、そのイベントの型が示されます。イベント ビューアーは、この型を使用して、ログのリスト ビューに表示するアイコンを決定します。イベント ログ エントリで使用されるイベントの型については、「<xref:System.Diagnostics.EventLogEntryType>」を参照してください。  
+  
+ イベント ビューアーでイベントを表示しているときに "詳細な情報" をクリックすると、インターネット上に情報が送信される場合があります。詳細については、イベント ビューアーのヘルプを参照してください。  
+  
+## 参照  
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/invariantassertionfailed.md b/docs/framework/wcf/diagnostics/event-logging/invariantassertionfailed.md
new file mode 100644
index 00000000000..410a7c44a56
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/invariantassertionfailed.md
@@ -0,0 +1,31 @@
+---
+title: "InvariantAssertionFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96c8a97a-3c04-4c35-9302-a6648ccfe5b6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# InvariantAssertionFailed
+ID : 106  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ このイベントは、インバリアント アサーションが false であることを示します。イベントには、メッセージ、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/lafailedtolistenforapp.md b/docs/framework/wcf/diagnostics/event-logging/lafailedtolistenforapp.md
new file mode 100644
index 00000000000..864d237d485
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/lafailedtolistenforapp.md
@@ -0,0 +1,31 @@
+---
+title: "LAFailedToListenForApp | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ef16d4e-fab7-4ffc-829b-1e3163e72337
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# LAFailedToListenForApp
+ID : 160  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SMSvcHost  
+  
+## 説明  
+ このイベントは、指定されたサイトをリッスンしようとしたときに、指定されたプロトコルの指定されたアクティブ化サービスでエラーが発生したため、このサイトのプロトコルが一時的に無効になっていることを示します。このイベントには、URL、状態、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messageauthenticationfailure.md b/docs/framework/wcf/diagnostics/event-logging/messageauthenticationfailure.md
new file mode 100644
index 00000000000..1b7fe4c46ef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messageauthenticationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "MessageAuthenticationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cde6beae-2d57-447e-8885-a1cfc66bbcbb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MessageAuthenticationFailure
+ID : 170  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、メッセージの承認に失敗したことを示します。  イベントには、サービス、アクション、クライアント ID、およびアクティビティ ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messageauthenticationsuccess.md b/docs/framework/wcf/diagnostics/event-logging/messageauthenticationsuccess.md
new file mode 100644
index 00000000000..1554cb1bea2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messageauthenticationsuccess.md
@@ -0,0 +1,31 @@
+---
+title: "MessageAuthenticationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75974896-9d26-4586-92fb-578f6c71f0e1
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# MessageAuthenticationSuccess
+ID : 169  
+  
+ 重大度 : 情報  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、メッセージ認証が成功したことを示します。イベントには、サービス、アクション、クライアント ID、およびアクティビティ ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messageloggingoff.md b/docs/framework/wcf/diagnostics/event-logging/messageloggingoff.md
new file mode 100644
index 00000000000..2a8598cc242
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messageloggingoff.md
@@ -0,0 +1,31 @@
+---
+title: "MessageLoggingOff | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98cb139d-cb10-4d8c-9087-3dc3c6f23521
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MessageLoggingOff
+ID : 117  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、メッセージ ログが無効になっていることを示します。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messageloggingon.md b/docs/framework/wcf/diagnostics/event-logging/messageloggingon.md
new file mode 100644
index 00000000000..0866469c87a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messageloggingon.md
@@ -0,0 +1,31 @@
+---
+title: "MessageLoggingOn | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6252ce4-395f-4b9a-a58c-7de8c81c7c5a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MessageLoggingOn
+ID : 116  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ メッセージ ログが有効になりました。  ネットワーク上で暗号化されていても、重要な情報をログに記録できます。  たとえば、メッセージ本文などです。  イベントには、AppID、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedpipeleak.md b/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedpipeleak.md
new file mode 100644
index 00000000000..816ba869407
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedpipeleak.md
@@ -0,0 +1,31 @@
+---
+title: "MessageQueueDuplicatedPipeLeak | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 743db7f1-32cc-4a3b-8d1a-5d1cf25e439c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MessageQueueDuplicatedPipeLeak
+ID : 166  
+  
+ 重大度 : エラー  
+  
+ カテゴリ: SMSvcHost  
+  
+## 説明  
+ このイベントは、複製された名前付きパイプのディスパッチ中にエラーが発生したことを示します。このハンドルは現在プロセスでリークされています。イベントには、ソース、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedsocketleak.md b/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedsocketleak.md
new file mode 100644
index 00000000000..ac7fc3c0555
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/messagequeueduplicatedsocketleak.md
@@ -0,0 +1,31 @@
+---
+title: "MessageQueueDuplicatedSocketLeak | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9721a463-15d1-43dc-8e3a-cae44448de91
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MessageQueueDuplicatedSocketLeak
+ID : 165  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SMSvcHost  
+  
+## 説明  
+ このイベントは、複製されたソケットのディスパッチ中にエラーが発生したことを示します。このハンドルは現在プロセスでリークされています。イベントには、ソース、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/missingnecessaryenhancedkeyusage.md b/docs/framework/wcf/diagnostics/event-logging/missingnecessaryenhancedkeyusage.md
new file mode 100644
index 00000000000..13a4fc776ae
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/missingnecessaryenhancedkeyusage.md
@@ -0,0 +1,31 @@
+---
+title: "MissingNecessaryEnhancedKeyUsage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9dffd071-0b79-4e10-9027-06760b4cc3ca
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MissingNecessaryEnhancedKeyUsage
+ID : 157  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、特定のサブジェクト名と拇印を持つ ID 証明書が、対応する EnhancedKeyUsages に特定のデータを提供していないことを示します。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/missingnecessarykeyusage.md b/docs/framework/wcf/diagnostics/event-logging/missingnecessarykeyusage.md
new file mode 100644
index 00000000000..7ee4452df8a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/missingnecessarykeyusage.md
@@ -0,0 +1,31 @@
+---
+title: "MissingNecessaryKeyUsage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: abce3542-29d8-4b51-ab5f-f3845242c3c1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MissingNecessaryKeyUsage
+ID : 156  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、指定したサブジェクト名と拇印を持つ ID 証明書が、対応する KeyUsages に特定のデータを提供していないことを示します。プロセス名とプロセス ID も表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/nonfatalunexpectedstatemachineevent.md b/docs/framework/wcf/diagnostics/event-logging/nonfatalunexpectedstatemachineevent.md
new file mode 100644
index 00000000000..de156adcc39
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/nonfatalunexpectedstatemachineevent.md
@@ -0,0 +1,31 @@
+---
+title: "NonFatalUnexpectedStateMachineEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bfa37c10-cf1b-4325-b756-6ef200606510
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# NonFatalUnexpectedStateMachineEvent
+ID : 148  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、ステート マシンが予期しないイベントを処理しようとしたことを示します。  このイベントは致命的なものとは見なされません。  イベントには、トランザクション ID、ステート マシン、現在の状態、履歴、イベント名、イベントの詳細、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycorrupt.md b/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycorrupt.md
new file mode 100644
index 00000000000..382b9bfe84c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycorrupt.md
@@ -0,0 +1,31 @@
+---
+title: "ParticipantRecoveryLogEntryCorrupt | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab34785f-f953-4428-93ca-3c50d3f50a4a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ParticipantRecoveryLogEntryCorrupt
+ID : 138  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、参加要素の回復ログ エントリが破損し、逆シリアル化できなかったことを示します。このエラーが原因で、データの損失が発生することがあります。イベントには、トランザクション ID、回復データ \(Base64 エンコード\)、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycreationfailure.md b/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycreationfailure.md
new file mode 100644
index 00000000000..36a8cb09b1e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/participantrecoverylogentrycreationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ParticipantRecoveryLogEntryCreationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0bda0f08-7614-40f8-912a-06f5a99393e6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ParticipantRecoveryLogEntryCreationFailure
+ID : 141  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、回復ログのエントリを参加要素の参加リスト用に生成できなかったことを示します。トランザクションは中止されます。イベントには、トランザクション ID、参加リスト ID、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/performancecounterinitializationfailure.md b/docs/framework/wcf/diagnostics/event-logging/performancecounterinitializationfailure.md
new file mode 100644
index 00000000000..45b7a77642c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/performancecounterinitializationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "PerformanceCounterInitializationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 85050ac6-7f7b-4dd3-8e5e-f5116d7c9906
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# PerformanceCounterInitializationFailure
+ID : 149  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、パフォーマンス カウンターを初期化できなかったことを示します。イベントには、カウンター名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/piiloggingnotallowed.md b/docs/framework/wcf/diagnostics/event-logging/piiloggingnotallowed.md
new file mode 100644
index 00000000000..0fac0f64c01
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/piiloggingnotallowed.md
@@ -0,0 +1,31 @@
+---
+title: "PiiLoggingNotAllowed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc34a0b6-fee7-4da4-b146-b0c1c8b7519a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# PiiLoggingNotAllowed
+ID : 108  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ このイベントは、既知の PII がログ記録されていないことを示します。  既知の PII はログ記録できません。  既知の PII をログ記録できるようにするには、Machine.config の "enableLoggingKnownPii" を `true` に設定します。  イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/piiloggingon.md b/docs/framework/wcf/diagnostics/event-logging/piiloggingon.md
new file mode 100644
index 00000000000..21a0fab8ed3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/piiloggingon.md
@@ -0,0 +1,31 @@
+---
+title: "PiiLoggingOn | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 08940d0f-dc4c-49e0-b6f6-b70856b5060d
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# PiiLoggingOn
+ID : 107  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : トレース  
+  
+## 説明  
+ このイベントは、PII ログ記録が有効になっていることを示します。重要な情報がログに記録されます。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolinitializationfailure.md b/docs/framework/wcf/diagnostics/event-logging/protocolinitializationfailure.md
new file mode 100644
index 00000000000..123fdd92844
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolinitializationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolInitializationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ee26f94-c85e-4e92-b56b-16f486c8b00e
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolInitializationFailure
+ID : 142  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスを初期化できなかったことを示します。この結果、WS\-AtomicTransaction 機能は無効になります。イベントには、プロトコル ID、プロトコル名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolrecoverybeginningfailure.md b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverybeginningfailure.md
new file mode 100644
index 00000000000..cbe50204fbc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverybeginningfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolRecoveryBeginningFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4b6ddabf-3861-4c40-b9a2-b153cf1e4d35
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolRecoveryBeginningFailure
+ID : 144  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、回復の開始時に MSDTC WS\-AtomicTransaction プロトコルでエラーが発生したことを示しています。この結果、WS\-AtomicTransaction 機能は無効になります。イベントには、プロトコル ID、プロトコル名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycomplete.md b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycomplete.md
new file mode 100644
index 00000000000..cefbf3d8047
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycomplete.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolRecoveryComplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 71b2a222-f3a5-4e71-8ecd-ca53c8f8ef00
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolRecoveryComplete
+ID : 150  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスが起動と回復を正常に完了したことを示します。イベントには、プロトコル ID、プロトコル名、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycompletefailure.md b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycompletefailure.md
new file mode 100644
index 00000000000..c1610960d06
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolrecoverycompletefailure.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolRecoveryCompleteFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 369aac88-e66d-48cc-a432-c5f2073b7a1b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolRecoveryCompleteFailure
+ID: 145  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスが起動と回復を完了できなかったことを示します。この結果、WS\-AtomicTransaction 機能は無効になりました。イベントには、プロトコル ID、プロトコル名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolstartfailure.md b/docs/framework/wcf/diagnostics/event-logging/protocolstartfailure.md
new file mode 100644
index 00000000000..979416b4f83
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolstartfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolStartFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b722d1d5-bfef-4dc9-bfa3-85178b6d2ae3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolStartFailure
+ID : 143  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスを開始できなかったことを示します。  その結果、WS\-AtomicTransaction 機能が無効化されました。  イベントには、プロトコル ID、プロトコル名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolstopfailure.md b/docs/framework/wcf/diagnostics/event-logging/protocolstopfailure.md
new file mode 100644
index 00000000000..cb5512870b8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolstopfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolStopFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b246f8f-eb0f-430b-a82b-3d55aad287a1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolStopFailure
+ID : 147  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスを停止できなかったことを示します。イベントには、プロトコル ID、プロトコル名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/protocolstopped.md b/docs/framework/wcf/diagnostics/event-logging/protocolstopped.md
new file mode 100644
index 00000000000..a81c2856c4f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/protocolstopped.md
@@ -0,0 +1,31 @@
+---
+title: "ProtocolStopped | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bc4c892f-b5ed-40cd-979c-382f4bed41b6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ProtocolStopped
+ID : 151  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、WS\-AtomicTransaction プロトコル サービスが停止したことを示します。  イベントには、プロトコル ID、プロトコル名、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/securitynegotiationfailure.md b/docs/framework/wcf/diagnostics/event-logging/securitynegotiationfailure.md
new file mode 100644
index 00000000000..969e4dee026
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/securitynegotiationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "SecurityNegotiationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2060a678-f97b-4491-acd9-6c57c732afd7
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# SecurityNegotiationFailure
+ID : 172  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、セキュリティ ネゴシエーションに失敗したことを示します。イベントには、サービス、アクション、クライアント ID、アクティビティ ID、およびネゴシエーションが表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/securitynegotiationsuccess.md b/docs/framework/wcf/diagnostics/event-logging/securitynegotiationsuccess.md
new file mode 100644
index 00000000000..e2e9ad4f406
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/securitynegotiationsuccess.md
@@ -0,0 +1,31 @@
+---
+title: "SecurityNegotiationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 884dc3ae-c2ff-4793-b60c-d01d44712687
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# SecurityNegotiationSuccess
+ID : 171  
+  
+ 重大度 : 情報  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、セキュリティ ネゴシエーションが成功したことを示し、サービスの名前、アクション、クライアント ID、アクティビティ ID、およびネゴシエーションを表示します。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationfailure.md b/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationfailure.md
new file mode 100644
index 00000000000..bed732f5301
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "ServiceAuthorizationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6a57896-41d5-4c05-a2fb-184d828e20c1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ServiceAuthorizationFailure
+ID : 168  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、サービスの承認に失敗したことを示します。イベントには、サービス、アクション、クライアント ID、承認コンテキスト、アクティビティ ID、および ServiceAuthorizationManager が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationsuccess.md b/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationsuccess.md
new file mode 100644
index 00000000000..f55984a8186
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/serviceauthorizationsuccess.md
@@ -0,0 +1,31 @@
+---
+title: "ServiceAuthorizationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e379f38-23f3-498b-b3fd-28cedefbf878
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ServiceAuthorizationSuccess
+ID : 176  
+  
+ 重大度 : 情報  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、サービスの承認に成功したことを示します。イベントには、サービス、アクション、クライアント ID、承認コンテキスト、アクティビティ ID、および ServiceAuthorizationManager が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/servicestartfailed.md b/docs/framework/wcf/diagnostics/event-logging/servicestartfailed.md
new file mode 100644
index 00000000000..319fd1304f8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/servicestartfailed.md
@@ -0,0 +1,31 @@
+---
+title: "ServiceStartFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33a42eae-d57a-48b3-955c-a8e10b0bb66d
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ServiceStartFailed
+ID : 164  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SMSvcHost  
+  
+## 説明  
+ このイベントは、サービス開始の要求が失敗したことを示します。イベントには、エラー コード、プロセス名、およびプロセス ID が一覧表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/sslnoaccessibleprivatekey.md b/docs/framework/wcf/diagnostics/event-logging/sslnoaccessibleprivatekey.md
new file mode 100644
index 00000000000..61f9959fc13
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/sslnoaccessibleprivatekey.md
@@ -0,0 +1,31 @@
+---
+title: "SslNoAccessiblePrivateKey | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 90cc793e-7ac8-45b2-81b8-2976e2485734
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# SslNoAccessiblePrivateKey
+ID : 155  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、特定のサブジェクト名と拇印を持つ ID 証明書にアクセス可能な秘密キーがないことを示します。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/sslnoprivatekey.md b/docs/framework/wcf/diagnostics/event-logging/sslnoprivatekey.md
new file mode 100644
index 00000000000..4b2f8da8ca7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/sslnoprivatekey.md
@@ -0,0 +1,31 @@
+---
+title: "SslNoPrivateKey | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67eef8f6-360d-42f2-a3ac-2bb17329f247
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# SslNoPrivateKey
+ID : 154  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、特定のサブジェクト名と拇印を持つ ID 証明書に秘密キーがないことを示します。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/starterrorpublish.md b/docs/framework/wcf/diagnostics/event-logging/starterrorpublish.md
new file mode 100644
index 00000000000..ba8db893492
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/starterrorpublish.md
@@ -0,0 +1,31 @@
+---
+title: "StartErrorPublish | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d261929a-bd41-4611-8951-d1fb16bda0bc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# StartErrorPublish
+ID : 158  
+  
+ 重大度 : エラー  
+  
+ カテゴリ: SMSvcHost  
+  
+## 説明  
+ このイベントは、NT サービスの開始に失敗したことを示します。  待機エンドポイントを公開できませんでした。  イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/thumbprintnotfound.md b/docs/framework/wcf/diagnostics/event-logging/thumbprintnotfound.md
new file mode 100644
index 00000000000..aadb62869da
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/thumbprintnotfound.md
@@ -0,0 +1,31 @@
+---
+title: "ThumbPrintNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e901d43-5359-4f06-a564-6e5821253ece
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ThumbPrintNotFound
+ID : 152  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、特定の拇印を持つ ID 証明書が見つからなかったことを示します。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/thumbprintnotvalidated.md b/docs/framework/wcf/diagnostics/event-logging/thumbprintnotvalidated.md
new file mode 100644
index 00000000000..ed17a3a9b74
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/thumbprintnotvalidated.md
@@ -0,0 +1,31 @@
+---
+title: "ThumbPrintNotValidated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3e110f5-2853-4150-99c9-18236df320e2
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ThumbPrintNotValidated
+ID : 153  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、指定した拇印を持つ ID 証明書を検証できなかったことを示します。  イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/tracecoderemovedbadfilter.md b/docs/framework/wcf/diagnostics/event-logging/tracecoderemovedbadfilter.md
new file mode 100644
index 00000000000..5c47deff99f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/tracecoderemovedbadfilter.md
@@ -0,0 +1,31 @@
+---
+title: "TraceCodeRemovedBadFilter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22f169ae-ea2c-444c-b211-50d3b7bece34
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# TraceCodeRemovedBadFilter
+ID : 114  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、メッセージ本文にアクセスしていた不適切なメッセージ ログ記録フィルターが削除されたことを示します。イベントには、XPath、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/transactionbridgerecoveryfailure.md b/docs/framework/wcf/diagnostics/event-logging/transactionbridgerecoveryfailure.md
new file mode 100644
index 00000000000..89bee9e3514
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/transactionbridgerecoveryfailure.md
@@ -0,0 +1,31 @@
+---
+title: "TransactionBridgeRecoveryFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a53891d9-67ea-4ead-8d38-3193cb57cd37
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# TransactionBridgeRecoveryFailure
+ID : 146  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、回復時に MSDTC TransactionBridge でエラーが発生したことを示しています。これは致命的な状況であるため、MSDTC サービスは終了されました。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/transportauthenticationfailure.md b/docs/framework/wcf/diagnostics/event-logging/transportauthenticationfailure.md
new file mode 100644
index 00000000000..e7c9ad64744
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/transportauthenticationfailure.md
@@ -0,0 +1,31 @@
+---
+title: "TransportAuthenticationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: adbdbda0-de52-448c-a938-cc9f5db2980e
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# TransportAuthenticationFailure
+ID : 174  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントはトランスポート認証が失敗したことを示し、クライアント ID、およびアクティビティ ID を表示します。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/transportauthenticationsuccess.md b/docs/framework/wcf/diagnostics/event-logging/transportauthenticationsuccess.md
new file mode 100644
index 00000000000..8ce9ea2fa09
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/transportauthenticationsuccess.md
@@ -0,0 +1,31 @@
+---
+title: "TransportAuthenticationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a7c3013-3d05-4d32-857b-759e98d91259
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# TransportAuthenticationSuccess
+ID : 173  
+  
+ 重大度 : 情報  
+  
+ カテゴリ : SecurityAudit  
+  
+## 説明  
+ このイベントは、トランスポート認証が成功したことを示します。イベントには、サービス、クライアント ID、およびアクティビティ ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/unhandledstatemachineexceptionrecorddescription.md b/docs/framework/wcf/diagnostics/event-logging/unhandledstatemachineexceptionrecorddescription.md
new file mode 100644
index 00000000000..3e64e6b4f31
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/unhandledstatemachineexceptionrecorddescription.md
@@ -0,0 +1,31 @@
+---
+title: "UnhandledStateMachineExceptionRecordDescription | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4a0e8af-7d6c-4091-8d6c-b99e8ff3a07b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# UnhandledStateMachineExceptionRecordDescription
+ID : 136  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : TransactionBridge  
+  
+## 説明  
+ このイベントは、ステート マシンがイベントを処理中に、処理不能の例外がスローされたことを示します。  イベントには、トランザクション ID、ステート マシン名、現在の状態、履歴、参加リスト ID、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/unknownlisteneradaptererror.md b/docs/framework/wcf/diagnostics/event-logging/unknownlisteneradaptererror.md
new file mode 100644
index 00000000000..5508392895c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/unknownlisteneradaptererror.md
@@ -0,0 +1,31 @@
+---
+title: "UnknownListenerAdapterError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f454773d-a208-4ce0-8675-b6dd7ebd5a5a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# UnknownListenerAdapterError
+ID : 161  
+  
+ 重大度 : エラー  
+  
+ カテゴリ: SMSvcHost  
+  
+## 説明  
+ このイベントは、Windows プロセス アクティブ化サービス \(WAS\) の通知を処理中に、リスナー アダプターで予期しないエラーが発生したことを示します。  プロセスは終了しました。  イベントには、プロトコル、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wasconnectiontimedout.md b/docs/framework/wcf/diagnostics/event-logging/wasconnectiontimedout.md
new file mode 100644
index 00000000000..707706fa8ea
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wasconnectiontimedout.md
@@ -0,0 +1,31 @@
+---
+title: "WasConnectionTimedout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: be762c57-5641-4761-bd74-ce42603d40bc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WasConnectionTimedout
+ID : 163  
+  
+ 重大度 : エラー  
+  
+ カテゴリ: SMSvcHost  
+  
+## 説明  
+ このイベントは、Windows プロセス アクティブ化サービス \(WAS\) で必要な接続がタイムアウトになったことを示し、プロセス名とプロセス ID を表示します。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wasdisconnected.md b/docs/framework/wcf/diagnostics/event-logging/wasdisconnected.md
new file mode 100644
index 00000000000..5c22e50f497
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wasdisconnected.md
@@ -0,0 +1,31 @@
+---
+title: "WasDisconnected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d86f1a7-a9f9-41f5-9ba2-3ffa70972a9c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WasDisconnected
+ID : 162  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : SMSvcHost  
+  
+## 説明  
+ このイベントは、WAS \(Windows Process Activation\) が切断されたことを示します。イベントには、HRESULT、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/webhostfailedtolisten.md b/docs/framework/wcf/diagnostics/event-logging/webhostfailedtolisten.md
new file mode 100644
index 00000000000..60739a5cf24
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/webhostfailedtolisten.md
@@ -0,0 +1,31 @@
+---
+title: "WebHostFailedToListen | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 328468a6-6388-425a-a122-49306e303d19
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WebHostFailedToListen
+ID : 112  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、特定の URL をリッスンしようとしたときにエラーが発生したことを示します。このワーカー プロセスは終了します。イベントには、例外、プロセス名、およびプロセス ID が一覧表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/webhostfailedtoprocessrequest.md b/docs/framework/wcf/diagnostics/event-logging/webhostfailedtoprocessrequest.md
new file mode 100644
index 00000000000..a7e4dd15cf0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/webhostfailedtoprocessrequest.md
@@ -0,0 +1,31 @@
+---
+title: "WebHostFailedToProcessRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1637e7ab-ed00-4ee5-b7e9-d3e8d8376147
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WebHostFailedToProcessRequest
+ID : 111  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WebHost が要求の処理に失敗したことを示します。イベントには、送信者の情報、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/webhosthttperror.md b/docs/framework/wcf/diagnostics/event-logging/webhosthttperror.md
new file mode 100644
index 00000000000..918844a0cef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/webhosthttperror.md
@@ -0,0 +1,31 @@
+---
+title: "WebHostHttpError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dff35e7e-5571-463d-abcf-7e048381f91f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WebHostHttpError
+ID : 110  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WebHost HTTP 例外が発生したことを示します。  イベントには、送信者の情報、HtmlErrorMessage、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/webhostunhandledexception.md b/docs/framework/wcf/diagnostics/event-logging/webhostunhandledexception.md
new file mode 100644
index 00000000000..86b4cc17027
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/webhostunhandledexception.md
@@ -0,0 +1,31 @@
+---
+title: "WebHostUnhandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e8564c6-8fd2-4bc9-85b5-68e0b55438ee
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WebHostUnhandledException
+ID : 109  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WebHost で処理されない例外が発生したことを示します。イベントには、送信者の情報、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiadmintypemismatch.md b/docs/framework/wcf/diagnostics/event-logging/wmiadmintypemismatch.md
new file mode 100644
index 00000000000..1fd2886c852
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiadmintypemismatch.md
@@ -0,0 +1,31 @@
+---
+title: "WmiAdminTypeMismatch | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1b5d70e-6e95-48b3-a3dd-4687484babf7
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiAdminTypeMismatch
+ID : 128  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、型の不一致が発生したことを示します。  指定した CIM クラスのプロパティには、指定の型の値を使用できません。  イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmicreateinstancefailed.md b/docs/framework/wcf/diagnostics/event-logging/wmicreateinstancefailed.md
new file mode 100644
index 00000000000..62ed98f0c45
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmicreateinstancefailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiCreateInstanceFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c419e62e-6545-4aec-be6b-dda5276855e5
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WmiCreateInstanceFailed
+ID : 123  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI CreateInstance 要求が処理されなかったことを示します。  イベントには、クラス名、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmideleteinstancefailed.md b/docs/framework/wcf/diagnostics/event-logging/wmideleteinstancefailed.md
new file mode 100644
index 00000000000..1bbb3380ef8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmideleteinstancefailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiDeleteInstanceFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d61107a-1428-4281-8d1b-372240f4a723
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiDeleteInstanceFailed
+ID : 122  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI DeleteInstance 要求が処理されなかったことを示します。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiexecmethodfailed.md b/docs/framework/wcf/diagnostics/event-logging/wmiexecmethodfailed.md
new file mode 100644
index 00000000000..241117dff54
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiexecmethodfailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiExecMethodFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8cb52fa8-0c36-4761-bf8e-2d7e1b73372e
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiExecMethodFailed
+ID : 125  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI ExecMethod 要求が処理されなかったことを示します。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiexecqueryfailed.md b/docs/framework/wcf/diagnostics/event-logging/wmiexecqueryfailed.md
new file mode 100644
index 00000000000..144fc229c2e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiexecqueryfailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiExecQueryFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 464ffd94-1bb2-4eda-ad87-24ca567bf7f3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiExecQueryFailed
+ID : 124  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI ExecQuery 要求が処理されなかったことを示します。イベントには、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmigetobjectfailed.md b/docs/framework/wcf/diagnostics/event-logging/wmigetobjectfailed.md
new file mode 100644
index 00000000000..221daf2e268
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmigetobjectfailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiGetObjectFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 676691b5-705e-4422-8dca-c6f517964116
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiGetObjectFailed
+ID : 120  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI GetObject 要求が処理されなかったことを示します。イベントには、WMI オブジェクト、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmipropertymissing.md b/docs/framework/wcf/diagnostics/event-logging/wmipropertymissing.md
new file mode 100644
index 00000000000..7df8518b688
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmipropertymissing.md
@@ -0,0 +1,31 @@
+---
+title: "WmiPropertyMissing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 109fa6b4-93dc-4785-bec4-5aa02c434a65
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiPropertyMissing
+ID : 129  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、型の不一致が発生したことを示します。指定した CIM クラスには、指定した特定の型のプロパティがありません。イベントには、プロセス名とプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiputinstancefailed.md b/docs/framework/wcf/diagnostics/event-logging/wmiputinstancefailed.md
new file mode 100644
index 00000000000..13258fb8cfd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiputinstancefailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiPutInstanceFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e56f6db-c6f6-4e57-9668-3ca79c3750af
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiPutInstanceFailed
+ID : 121  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI PutInstance 要求が処理されなかったことを示します。イベントには、WMI オブジェクト、例外、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiregistrationfailed.md b/docs/framework/wcf/diagnostics/event-logging/wmiregistrationfailed.md
new file mode 100644
index 00000000000..a8b64b01044
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiregistrationfailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiRegistrationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 69ac6b2b-770c-49e1-9865-34773767971c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiRegistrationFailed
+ID : 126  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI プロバイダーが登録されなかったことを示します。イベントには、WMI オブジェクト、エラー、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/event-logging/wmiunregistrationfailed.md b/docs/framework/wcf/diagnostics/event-logging/wmiunregistrationfailed.md
new file mode 100644
index 00000000000..7d5dfba96ec
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/event-logging/wmiunregistrationfailed.md
@@ -0,0 +1,31 @@
+---
+title: "WmiUnregistrationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d1d31a7-efab-492d-b0ff-3233d5dc7a2a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WmiUnregistrationFailed
+ID : 127  
+  
+ 重大度 : エラー  
+  
+ カテゴリ : ServiceModel  
+  
+## 説明  
+ このイベントは、WMI プロバイダーが登録解除されなかったことを示します。イベントには、WMI オブジェクト、エラー、プロセス名、およびプロセス ID が表示されます。  
+  
+## 参照  
+ [イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [イベント一覧](../../../../../docs/framework/wcf/diagnostics/event-logging/events-general-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/TOC.md b/docs/framework/wcf/diagnostics/exceptions-reference/TOC.md
new file mode 100644
index 00000000000..d4247ce0838
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/TOC.md
@@ -0,0 +1,25 @@
+# [コア通信 : InternalDuplex トランスポート チャネル](core-communications-internal-duplex-transport-channels.md)
+# [ピア チャネル](peer-channel.md)
+# [コア通信 : TCP トランスポート チャネル](core-communications-tcp-transport-channels.md)
+# [コア通信 : ユーティリティ](core-communications-utilities.md)
+# [例外リファレンス](index.md)
+# [ホスティング](hosting-exceptions.md)
+# [コア通信 : トランスポート フレームワーク](core-communications-transport-framework.md)
+# [コア通信 : チャネル フレームワーク](core-communications-channel-framework.md)
+# [ツール](tools.md)
+# [構成](configuration.md)
+# [セキュリティ例外](security-exceptions.md)
+# [サービス フレームワークのメタデータ](service-framework-metadata.md)
+# [サービス フレームワーク](service-framework.md)
+# [トランザクション フォーマッタ](transaction-formatter.md)
+# [コア通信 : HTTP/HTTPS トランスポート チャネル](core-communications-http-https-transport-channels.md)
+# [COM+ 統合](com-integration.md)
+# [コア通信 : 接続フレームワーク](core-communications-connection-framework.md)
+# [IdentityModel](identitymodel-exceptions.md)
+# [信頼できるメッセージ機能](reliable-messaging.md)
+# [MSMQ トランスポート](msmq-transport.md)
+# [MSMQ 統合のトランスポート](msmq-integration-transport.md)
+# [サービス フレームワーク データ](service-framework-data.md)
+# [トランザクション](transaction-exceptions.md)
+# [コア通信 : 名前付きパイプ トランスポート チャネル](core-communications-named-pipe-transport-channels.md)
+# [コア通信 : Webhost サポート](core-communications-webhost-support.md)
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/com-integration.md b/docs/framework/wcf/diagnostics/exceptions-reference/com-integration.md
new file mode 100644
index 00000000000..5844b9fa55a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/com-integration.md
@@ -0,0 +1,28 @@
+---
+title: "COM+ 統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a687c1b-d0be-42fb-8f9b-20fea1317411
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# COM+ 統合
+ここでは、COM\+ 統合によって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|CannotResolveTypeForParamInMessageDescription|指定された名前空間内の指定されたパラメーターの型を解決できません。|  
+|NoEqualSignFound|指定されたキーワードの後に等号がありません。各キーワードの後に等号と値が続くことを確認してください。|  
+|UdtNotFoundInAssembly|指定されたユーザー定義型が見つかりませんでした。正しい型およびタイプ ライブラリが登録および指定されていることを確認してください。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/configuration.md b/docs/framework/wcf/diagnostics/exceptions-reference/configuration.md
new file mode 100644
index 00000000000..b5f5dc13c81
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/configuration.md
@@ -0,0 +1,40 @@
+---
+title: "構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 86a6e12f-73b5-450e-8725-f4ca5fe0702c
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 構成
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] 構成によって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|ConfigBindingCannotBeConfigured|サービス エンドポイントのバインディングを構成できません。|  
+|ConfigElementKeyNull|指定された構成要素キーを NULL にすることはできません。|  
+|ConfigExtensionTypeNotRegisteredInCollection|指定された拡張の型は、指定された拡張のコレクションに登録されていません。|  
+|ConfigIndexOutOfRange|指定された属性の値が範囲外です。|  
+|ConfigInvalidBindingConfigurationName|指定された構成に指定された名前のバインディングが含まれていません。|  
+|ConfigInvalidBindingName|指定された構成に指定された名前のバインディングが含まれていません。これはこのバインディングに対して無効な値です。|  
+|ConfigInvalidCommonEndpointBehaviorType|指定された動作拡張は指定された型を実装していないため、共通エンドポイント動作に追加できません。|  
+|ConfigInvalidCommonServiceBehaviorType|指定された動作拡張は指定された型を実装していないため、共通サービス動作に追加できません。|  
+|ConfigInvalidEndpointBehaviorType|基になる動作型が IServiceBehavior インターフェイスを実装していないため、指定された動作拡張を指定されたエンドポイント動作に追加できません。|  
+|ConfigInvalidExtensionType|指定された型をコレクションで使用するには、指定された拡張から派生する必要があります。|  
+|ConfigInvalidServiceBehaviorType|基になる動作型が IServiceBehavior インターフェイスを実装していないため、動作拡張を指定された名前のサービス動作に追加できません。|  
+|ConfigMessageEncodingAlreadyInBinding|指定されたメッセージ エンコーディング要素を追加できません。指定されたバインディングには、別のメッセージ エンコーディング要素が既に存在しています。バインディングのメッセージ エンコーディング要素は各バインディングに 1 つしか指定できません。|  
+|ConfigNoExtensionCollectionAssociatedWithType|指定された型の拡張に関連付けられた拡張のコレクションが見つかりません。|  
+|ConfigSectionNotFound|指定された構成セクションを作成できません。Machine.config ファイルに情報がありません。構成セクションが適切に登録されていること、およびセクション名を正しく入力していることを確認してください。Windows Communication Foundation セクションの場合は、ServiceModelReg.exe \-i を実行してこのエラーを修正してください。|  
+|ConfigTransportAlreadyInBinding|指定されたトランスポート要素を追加できません。指定されたバインディングには、別のトランスポート要素が既に存在しています。バインディングのメッセージ エンコーディング要素は各バインディングに 1 つしか指定できません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-channel-framework.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-channel-framework.md
new file mode 100644
index 00000000000..0711b740259
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-channel-framework.md
@@ -0,0 +1,28 @@
+---
+title: "コア通信 : チャネル フレームワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8caeb496-8d4c-477e-a476-994ece685a68
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# コア通信 : チャネル フレームワーク
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] チャネル フレームワークによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|ReceiveRequestTimedOut|指定されたローカル アドレスで受信された要求は、指定された時間の経過後にタイムアウトしました。この操作に割り当てられた時間は、より長く設定されたタイムアウトの一部になる可能性があります。|  
+|ReceiveTimedOutNoLocalAddress|受信操作は指定された時間の経過後にタイムアウトになります。この操作に割り当てられた時間は、より長く設定されたタイムアウトの一部になる可能性があります。|  
+|UnableToDemuxChannel|指定されたアクションでメッセージを受け入れるチャネルがありません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-connection-framework.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-connection-framework.md
new file mode 100644
index 00000000000..bb3866022cc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-connection-framework.md
@@ -0,0 +1,32 @@
+---
+title: "コア通信 : 接続フレームワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61ee00e1-896d-47c8-942f-1db28ac89cdc
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# コア通信 : 接続フレームワーク
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] 接続フレームワークによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|CloseTimedOut|Close メソッドは、指定された時間の経過後にタイムアウトしました。Close の呼び出しに渡されるタイムアウト値を増やすか、バインディングの CloseTimeout 値を増やします。この操作に割り当てられた時間は、より長く設定されたタイムアウトの一部になる可能性があります。|  
+|ContentTypeMismatch|指定されたものを予期していたサービスに対して、指定されたコンテンツ タイプが送信されました。クライアントとサービスのバインディングは一致しない場合もあります。|  
+|DuplexChannelAbortedDuringOpen|指定対象への二重チャネルは、開始処理中に中止されました。|  
+|FramingValueNotAvailable|完全にデコードされていないため、値にアクセスできません。|  
+|OperationAbortedDuringConnectionEstablishment|指定対象への接続の確立中に操作が中止されました。|  
+|ReceiveTimedOut2|受信操作は指定された時間の経過後にタイムアウトになります。この操作に割り当てられた時間は、より長く設定されたタイムアウトの一部になる可能性があります。|  
+|SendCannotBeCalledAfterCloseOutputSession|CloseOutputSession の呼び出し後にチャネルでメッセージを送信することはできません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-http-https-transport-channels.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-http-https-transport-channels.md
new file mode 100644
index 00000000000..ddb4fee7d66
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-http-https-transport-channels.md
@@ -0,0 +1,41 @@
+---
+title: "コア通信 : HTTP/HTTPS トランスポート チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c0a23c9-a663-461c-bdab-58b4d3e23642
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# コア通信 : HTTP/HTTPS トランスポート チャネル
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] の HTTP\/HTTPS トランスポート チャネルによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|DigestExplicitCredsImpersonationLevel|指定された偽装レベルが指定されました。  明示的な資格情報を使用する場合に 'Impersonation' レベルをサポートできるのは、HTTP ダイジェスト認証のみです。|  
+|FramingContentTypeMismatch|指定されたコンテンツの種類は、指定されたサービスでサポートされていませんでした。  クライアントとサービスのバインディングは一致しない場合もあります。|  
+|Hosting\_SslSettingsMisconfigured|指定されたサービスの SSL \(Secure Sockets Layer\) 設定が、インターネット インフォメーション サービスの SSL 設定と一致しません。|  
+|HttpAuthSchemeAndClientCert|HTTPS リスナー ファクトリが、クライアント証明書と指定された認証方式を要求するように構成されています。  ただし、クライアント認証の方式は、一度に 1 種類しか要求できません。|  
+|HttpReceiveFailure|指定された対象への HTTP 応答の受信中にエラーが発生しました。  サービス エンドポイント バインディングが HTTP プロトコルを使用していない可能性があります。  サービスがシャットダウンしたため、HTTP 要求コンテキストがサーバーによって中止された可能性もあります。  詳細については、サーバー ログを参照してください。|  
+|HttpRegistrationAccessDenied|HTTP は指定された URL を登録できません。  プロセスにこの名前空間へのアクセス権がありません \(詳細については、http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/http\/http\/namespace\_reservations\_registrations\_and\_routing.asp を参照してください\)。|  
+|HttpRegistrationAlreadyExists|HTTP は指定された URL を登録できません。  別のアプリケーションが既にこの URL を HTTP.SYS に登録しています。|  
+|HttpRegistrationPortInUse|HTTP が指定された URL を登録できませんでした。指定された TCP ポートは別のアプリケーションが使用しています。|  
+|HttpSendFailure|指定された対象への HTTP 要求の発行中にエラーが発生しました。  この原因がセキュリティ バインディングの不一致ではないことを確認してください。  また、サービスが SSL \(Secure Sockets Layer\) 用に構成されていないことも確認してください。|  
+|MessageXmlProtocolError|ネットワークから受信した XML に問題があります。  詳細については、内部例外を参照してください。|  
+|MissingContentType|受信側は、指定された対象への要求でコンテンツの種類が指定されていないことを示すエラーを返しました。  詳細については、内部例外を参照してください。|  
+|ProxyAuthenticationLevelMismatch|HTTP プロキシ認証の資格情報で、対象サーバーの認証要件より厳しい要件である相互認証が指定されています。|  
+|ProxyImpersonationLevelMismatch|HTTP プロキシ認証の資格情報で、対象サーバーの認証制限より厳しい制限である偽装レベルの制限が指定されています。|  
+|SecureChannelFailure|指定された証明機関との間で、SSL\/TLS のセキュリティで保護されたチャネルを確立できませんでした。|  
+|TrustFailure|指定された証明機関との間の SSL\/TLS のセキュリティで保護されたチャネルで、信頼関係を確立できません。|  
+|UseDefaultWebProxyCantBeUsedWithExplicitProxyAddress|HttpTransportBinding 要素では、明示的なプロキシ アドレスだけでなく、UseDefaultWebProxy\=true も指定できません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-internal-duplex-transport-channels.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-internal-duplex-transport-channels.md
new file mode 100644
index 00000000000..7c1f81a8e84
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-internal-duplex-transport-channels.md
@@ -0,0 +1,26 @@
+---
+title: "コア通信 : InternalDuplex トランスポート チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1004536-afe0-4e06-b3ed-b4ee08bb0189
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コア通信 : InternalDuplex トランスポート チャネル
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] 内部二重トランスポート チャネルによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|MessageMustHaveViaOrToSetForSendingOnServerSideCompositeDuplexChannels|サーバー側の複合二重チャネルでメッセージを送信するには、メッセージの 'Via' プロパティまたは 'To' ヘッダーが設定されている必要があります。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-named-pipe-transport-channels.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-named-pipe-transport-channels.md
new file mode 100644
index 00000000000..1f97648fc28
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-named-pipe-transport-channels.md
@@ -0,0 +1,30 @@
+---
+title: "コア通信 : 名前付きパイプ トランスポート チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14ab8f84-ab3e-47cd-8ac5-dd68af940175
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コア通信 : 名前付きパイプ トランスポート チャネル
+ここでは、名前付きパイプ トランスポート チャネルによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|PipeCantCloseWithPendingWrite|パイプへの書き込み処理中はパイプを閉じることはできません。|  
+|PipeReadPending|このパイプでは読み込み操作を実行中です。|  
+|PipeShutdownReadError|パイプ 'シャットダウン' インジケーターの読み取り操作に失敗しました。|  
+|PipeShutdownWriteError|パイプ 'シャットダウン' インジケーターの書き込み操作に失敗しました。|  
+|PipeWritePending|このパイプでは書き込み操作を実行中です。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-tcp-transport-channels.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-tcp-transport-channels.md
new file mode 100644
index 00000000000..6f71640b043
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-tcp-transport-channels.md
@@ -0,0 +1,26 @@
+---
+title: "コア通信 : TCP トランスポート チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d5cd057f-faec-4e21-ae0e-18bbc22bcfb1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# コア通信 : TCP トランスポート チャネル
+ここでは、TCP トランスポート チャネル によって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|SocketCloseReadTimeout|指定したソケットのリモート エンドポイントは、割り当てられたタイムアウト時間内に終了要求に応答しませんでした。  この原因としては、リモート エンドポイントが Receive 操作から EOF 信号 \(NULL\) を受信した後に Close を呼び出していない可能性があります。  この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-transport-framework.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-transport-framework.md
new file mode 100644
index 00000000000..ae9771a1cc7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-transport-framework.md
@@ -0,0 +1,26 @@
+---
+title: "コア通信 : トランスポート フレームワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9fae1728-1377-4cc1-8fc3-d5d9a23546bd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# コア通信 : トランスポート フレームワーク
+ここでは、トランスポート フレームワークによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|Hosting\_TransportBindingNotFound|指定したアドレスに一致するプロトコル バインディングがありません。プロトコル バインディングは、インターネット インフォメーション サービスまたは Windows プロセス アクティブ化サービスの構成でサイト レベルで構成されます。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-utilities.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-utilities.md
new file mode 100644
index 00000000000..57241bc47a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-utilities.md
@@ -0,0 +1,26 @@
+---
+title: "コア通信 : ユーティリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9e4f873-e26a-4ed1-9766-3541082dc999
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コア通信 : ユーティリティ
+ここでは、コア通信ユーティリティによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|AsyncObjectAlreadyEnded|End メソッドはこの非同期の結果、オブジェクトで既に呼び出されています。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-webhost-support.md b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-webhost-support.md
new file mode 100644
index 00000000000..859d6f4295c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/core-communications-webhost-support.md
@@ -0,0 +1,30 @@
+---
+title: "コア通信 : Webhost サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 034c501f-96f9-4ef7-9602-3ac21788fd3e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# コア通信 : Webhost サポート
+ここでは、Webhost サポートによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|Hosting\_CompatibilityServiceNotHosted|このサービスでは、ASP.NET 互換性が必要です。また、IIS でホストする必要もあります。Web.config で ASP.NET 互換性を有効にして IIS でサービスをホストするか、または AspNetCompatibilityRequirementsAttribute.AspNetCompatibilityRequirementsMode プロパティを Required 以外の値に設定します。|  
+|Hosting\_ListenerNotFoundForActivationInRecycling|指定されたアドレスをアクティブにリッスンしているチャネルはありません。アプリケーションがリサイクルされる場合、サービスは閉じられます。|  
+|Hosting\_NonHTTPInCompatibilityMode|ASP.NET 互換性でサポートされるプロトコルは HTTP と HTTPS のみです。指定されたエンドポイントを削除するか、アプリケーションに対して ASP.NET 互換性を無効にします。|  
+|Hosting\_ProcessNotExecutingUnderHostedContext|指定されたホスト プロセスは、現在のホスト環境内で呼び出すことができません。この API では、アプリケーションの呼び出しがインターネット インフォメーション サービスまたは Windows プロセス アクティブ化サービス内で干すとされている必要があります。|  
+|Hosting\_ServiceCompatibilityRequire|このサービスは ASP.NET 互換性を必要とするため、アクティブにできません。このアプリケーションに対して、ASP.NET 互換性が有効になっていません。Web.config ファイルで ASP.NET 互換性を有効にするか、AspNetCompatibilityRequirementsAttribute.AspNetCompatibilit を設定します。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/hosting-exceptions.md b/docs/framework/wcf/diagnostics/exceptions-reference/hosting-exceptions.md
new file mode 100644
index 00000000000..d1f0be4f38e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/hosting-exceptions.md
@@ -0,0 +1,27 @@
+---
+title: "ホスティング例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad9e14f8-fa17-4d59-b365-fe0e7ec17c98
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ホスティング例外
+ここでは、ホスティングによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|Hosting\_AddressIsAbsoluteUri|完全 URI は許可されていません。完全 URI は、ServiceHostingEnvironment.EnsureServiceAvailable API に対しては許可されていません。対応するサービスの仮想パスを使用してください。|  
+|Hosting\_BuildProviderCouldNotCreateType|指定した CLR 型をサービスのコンパイル中に読み込むことができません。この型が、アプリケーションの \\\\App\_Code ディレクトリに配置されているソース ファイルで定義されているか、アプリケーションの \\\\bin ディレクトリに配置されているコンパイル済みアセンブリ内、もしくはグローバル アセンブリ キャッシュにインストールされているアセンブリ内にあるか確認してください。型名では、大文字と小文字が区別されます。\\\\App\_Code、\\\\bin などのディレクトリは、アプリケーションのルート ディレクトリに配置する必要があります。\\\\App\_Code ディレクトリと \\\\bin ディレクトリは、サブディレクトリで入れ子にはできません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/identitymodel-exceptions.md b/docs/framework/wcf/diagnostics/exceptions-reference/identitymodel-exceptions.md
new file mode 100644
index 00000000000..77010f57375
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/identitymodel-exceptions.md
@@ -0,0 +1,305 @@
+---
+title: "IdentityModel 例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ef34497-8ff5-4621-b773-7731cc721231
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# IdentityModel 例外
+ここでは、IdentityModel によって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|現在の文字列|  
+|--------------|------------|  
+|ValueMustBeOf2Types|この引数の値は、この 2 つの型のいずれかである必要があります。|  
+|SAMLSubjectNameIdentifierRequiresNameValue|SamlNameIdentifier に対して指定された 'Name' は、NULL や長さ 0 であってはいけません。|  
+|TraceCodeIssuanceTokenProviderEndSecurityNegotiation|IssuanceTokenProvider はセキュリティ ネゴシエーションを完了しました。|  
+|TraceCodeSecurityNewServerSessionKeyIssued|新しいセキュリティのセッション キーがサーバーによって発行されました。|  
+|SAMLAttributeMissingNameAttributeOnRead|読み取り中の SamlAttribute の 'Name' が指定されていないか、長さが 0 です。|  
+|UnknownICryptoType|ICrypto 実装はサポートされていません。|  
+|TraceCodeSecurityTokenProviderClosed|セキュリティ トークン プロバイダーは閉じられました。|  
+|SAMLUnableToLoadAdvice|\<saml:advice\> 要素を読み込むことができませんでした。|  
+|SAMLAuthenticationStatementMissingAuthenticationMethodOnRead|SamlAuthenticationStatement の読み取り中の 'AuthenticationMethod' 属性は指定されていないか、長さが 0 です。|  
+|UnsupportedTransformAlgorithm|サポートされない変換または標準化アルゴリズムです。|  
+|SAMLAudienceRestrictionShouldHaveOneAudience|SamlAudienceRestrictionCondition には、少なくとも 1 つの Audience \(URI\) が含まれている必要があります。|  
+|SAMLEvidenceShouldHaveOneAssertion|SamlEvidence は、ID または参照によって少なくとも 1 つの SamlAssertion を参照している必要があります。|  
+|SAMLAudienceRestrictionInvalidAudienceValueOnRead|読み取り中の SamlAudienceRestrictionCondition に 'Audience' 要素の値がありません。|  
+|X509ChainBuildFail|指定された X.509 証明書のチェーンを構築できませんでした。使用された証明書には、検証できない信頼チェーンが含まれています。証明書を交換するか、certificateValidationMode を変更してください。|  
+|XDCannotFindValueInDictionaryString|指定された値 ID が辞書の文字列で見つかりません。|  
+|TraceCodeImportSecurityChannelBindingEntry|セキュリティの ImportChannelBinding を開始しています。|  
+|PrivateKeyExchangeNotSupported|秘密キーは、交換 KeySpec をサポートしていません。|  
+|TokenProviderUnableToGetToken|指定されたトークン プロバイダーはセキュリティ トークンを提供できませんでした。|  
+|SAMLEntityCannotBeNullOrEmpty|指定された SamlAssertion エンティティは NULL や空にはできません。|  
+|SAMLAssertionRequireOneStatement|SamlAssertion には少なくとも 1 つのステートメントが必要です。作成する SamlAssertion に少なくとも 1 つの SamlStatement を追加済みであることを確認してください。|  
+|AESInvalidInputBlockSize|入力サイズは指定されたバイトの倍数である必要があります。|  
+|AESCryptAcquireContextFailed|CSP コンテキストを取得できませんでした。|  
+|SAMLAssertionRequireOneStatementOnRead|読み取り中の SamlAssertion に SamlStatement がありませんでした。SamlAssertion には 1 つ以上の SamlStatement が含まれている必要があります。|  
+|TraceCodeSecuritySessionClosedFaultReceived|クライアントのセキュリティ セッションでサーバーからセッション終了済みのフォールトを受信しました。|  
+|TraceCodeIssuanceTokenProviderRedirectApplied|IssuanceTokenProvider によってリダイレクト ヘッダーが適用されました。|  
+|TraceCodeSecuritySessionClosedFaultSendFailure|セキュリティ セッション終了済みのフォールトをクライアントに送信中にエラーが発生しました。|  
+|ValueMustBeZero|この引数の値は 0 でなければなりません。|  
+|SAMLUnableToResolveSignatureKey|SamlAssertion 署名で見つかった SecurityKeyIdentifier を解決できません。指定された発行者の SamlAssertion 署名を検証できません。|  
+|X509IsNotInTrustedStore|指定された X.509 証明書は信頼されたユーザーのストアにありません。|  
+|SAMLElementNotRecognized|指定された要素はサポートされていません。|  
+|SAMLAuthorizationDecisionStatementMissingResourceAttributeOnRead|読み取り中の SamlAuthorizationDecisionStatement の 'Resource' 属性は指定されていないか、長さが 0 です。|  
+|SamlTokenMissingSignature|SamlAssertion は署名されていません。SamlAssertions に署名するには、SigningCredentials を設定します。|  
+|ExpectedElementMissing|指定された名前空間を持つ予期された要素がありません。|  
+|NoKeyIdentifierClauseFound|指定された型の句が SecurityKeyIdentifier で見つかりませんでした。|  
+|MissingPrivateKey|X.509 証明書に秘密キーがありません。|  
+|UnexpectedEOFFromReader|XML リーダーからの予期しない EOF です。|  
+|UnsupportedKeyDerivationAlgorithm|指定されたキー派生アルゴリズムはサポートされていません。|  
+|TokenDoesNotSupportKeyIdentifierClauseCreation|指定されたトークンは、指定されたキー識別句の作成をサポートしていません。|  
+|LastMessageNumberExceeded|シーケンス番号プロトコル違反が検出されました。|  
+|SymmetricKeyLengthTooShort|指定された対称キーの長さが短すぎます。|  
+|SAMLAuthorityBindingMissingAuthorityKindOnRead|読み取り中の SamlAuthorityBinding に、指定されていないか長さが 0 の 'AuthorityKind' がありました。これは許可されていません。|  
+|XmlTokenBufferIsEmpty|XmlTokenBuffer が空です。|  
+|InvalidXmlQualifiedName|Xml 修飾名が必要ですが、無効な名前が見つかりました。|  
+|SAMLAuthorityKindMissingName|SamlAuthorityBinding の 'AuthorityKind' を表す XmlQualifiedName は、NULL や長さ 0 であってはいけません。|  
+|AESCryptEncryptFailed|指定されたデータを暗号化できませんでした。|  
+|AuthorizationContextCreated|指定された ID を持つ承認コンテキストが作成されます。|  
+|SamlSerializerUnableToReadSecurityKeyIdentifier|SamlSerializer には、SecurityKeyIdentifier を読み取ることができる SecurityTokenSerializer が含まれていません。カスタム SecurityKeyIdentifier を使用している場合は、カスタムの SecurityTokenSerializer を指定する必要があります。|  
+|TraceCodeIssuanceTokenProviderServiceTokenCacheFull|IssuanceTokenProvider によってサービス トークン キャッシュが削減されました。|  
+|TraceCodeSecurityTokenProviderOpened|セキュリティ トークン プロバイダーを開きました。|  
+|PublicKeyNotRSA|公開キーは RSA キーではありません。|  
+|InvalidReaderState|指定された状態は、指定された入力リーダーに対して無効です。|  
+|UnableToResolveReferenceUriForSignature|署名の指定された URI を解決してダイジェストを計算できません。|  
+|EmptyBase64Attribute|必須の Base64 属性名と名前空間に対して空の値が見つかりました。|  
+|SAMLSubjectRequiresConfirmationMethodWhenConfirmationDataOrKeyInfoIsSpecified|SAML SubjectConfirmation では、Confirmation Data または KeyInfo が指定されている場合、Confirmation メソッドを指定する必要があります。|  
+|SAMLAudienceRestrictionShouldHaveOneAudienceOnRead|読み取り中の SamlAudienceRestrictionCondition には 1 つ以上の 'Audience' 値が含まれている必要があります。この値は見つかりませんでした。|  
+|TokenProviderUnableToRenewToken|指定されたトークン プロバイダーは、セキュリティ トークンを更新できませんでした。|  
+|AESIVLengthNotSupported|指定されたビットの IV はサポートされていません。128 ビットの IV のみサポートされます。|  
+|SAMLAuthorityBindingMissingAuthorityKind|SamlAuthorityBinding には、NULL でない 'AuthorityKind' が含まれている必要があります。|  
+|TraceCodeSecuritySessionDemuxFailure|受信メッセージは既存のセキュリティ セッションの一部ではありません。|  
+|TokenRenewalNotSupported|指定されたトークン プロバイダーは、トークンの更新をサポートしていません。|  
+|AtLeastOneReferenceRequired|署名には参照が少なくとも 1 つ必要です。|  
+|SAMLSignatureAlreadyRead|この署名は既に SAML アサーションに読み込まれています。|  
+|AlgorithmAndPrivateKeyMisMatch|指定されたアルゴリズムと秘密キーが適合しません。|  
+|EmptyTransformChainNotSupported|空の変換チェーンはサポートされていません。|  
+|SspiWrapperEncryptDecryptAssert1|SSPIWrapper::EncryptDecryptHelper&#124;'offset' は範囲外です。|  
+|SspiWrapperEncryptDecryptAssert2|SSPIWrapper::EncryptDecryptHelper&#124;'size' は範囲外です。SecurityTokenManagerCannotCreateAuthenticatorForRequirement\=セキュリティ トークン マネージャーは、指定された要件に対応するトークン認証システムを作成できません。|  
+|UnableToCreateKeyedHashAlgorithm|指定された署名アルゴリズムの指定された値から KeyedHashAlgorithm を作成できません。|  
+|SAMLUnableToLoadAssertion|\<saml:assertion\> 要素を読み込むことができませんでした。|  
+|X509FindValueMismatchMulti|指定された X509FindType では、引数 findValue の型が 2 つの値のいずれかである必要があります。引数 findValue は別の型です。|  
+|TraceCodeSecurityIdentityDeterminationSuccess|EndpointAddress の ID が特定されました。|  
+|UndefinedUseOfPrefixAtElement|この要素で使用される指定されたプレフィックスに定義済みの名前空間がありません。|  
+|TraceCodeSecuritySessionResponderOperationFailure|サーバーでセキュリティ セッションの操作に失敗しました。|  
+|CannotFindCert|StoreName、StoreLocation、FindType、FindValue という検索条件で検索しましたが、X.509 証明書が見つかりませんでした。|  
+|X509InvalidUsageTime|指定された X.509 証明書の使用時間が無効です。使用時間が、必要な NotBefore の時刻から NotAfter の時刻までの範囲内にありません。|  
+|TraceCodeSecurityIdentityDeterminationFailure|EndpointAddress の ID を特定できません。|  
+|AsyncObjectAlreadyEnded|End メソッドはこの非同期の結果、オブジェクトで既に呼び出されています。|  
+|ExternalDictionaryDoesNotContainAllRequiredStrings|この外部辞書には、必要な文字列の一部の定義しか含まれていません。指定された文字列はリモート辞書で使用できません。|  
+|TraceCodeSecuritySessionKeyRenewalFaultReceived|クライアントのセキュリティ セッションはサーバーからキーの更新エラーを受信しました。|  
+|SAMLActionNameRequired|SamlAction を表す文字列は、NULL や長さ 0 にはできません。|  
+|SignatureVerificationFailed|署名の確認に失敗しました。|  
+|TraceCodeSecurityContextTokenCacheFull|SecurityContextSecurityToken のキャッシュがいっぱいです。|  
+|SAMLAssertionMissingMajorVersionAttributeOnRead|読み取り中の SamlAssertion の MajorVersion が指定されていないか、長さが 0 です。|  
+|SamlAttributeClaimRightShouldBePossessProperty|この SamlAttribute コンストラクターでは、クレームの権限に System.IdentityModel.Claims.Rights.PossessProperty という値が割り当てられていることが要求されます。|  
+|AuthorizationPolicyEvaluated|指定された ID を持つポリシーが評価されます。|  
+|SAMLUnableToLoadCondtions|\<saml:conditions\> 要素を読み込めませんでした。|  
+|AESKeyLengthNotSupported|指定されたビット キーはサポートされていません。128、192、および 256 ビット キーのみサポートされます。|  
+|UserNameCannotBeEmpty|ユーザー名を空にすることはできません。|  
+|AlgorithmAndPublicKeyMisMatch|指定されたアルゴリズムと公開キーが適合しません。|  
+|SAMLUnableToLoadCondtion|\<saml:conditions\> 要素を読み込めませんでした。|  
+|SamlAssertionMissingSigningCredentials|SigningCredentials が SamlAssertion に設定されていません。SamlAssertions には署名が必要です。続行するには、有効な SigningCredentials を SamlAssertion に設定してください。|  
+|SspiPayloadNotEncrypted|バイナリ データは SSPI セキュリティ コンテキストを使用して暗号化されていませんでした。|  
+|SAMLAuthorizationDecisionShouldHaveOneActionOnRead|読み取り中の SamlAuthorizationDecisionStatement には SamlAction がありません。|  
+|TraceCodeSecurityBindingSecureOutgoingMessageFailure|セキュリティ プロトコルでは送信メッセージをセキュリティで保護することはできません。|  
+|UndefinedUseOfPrefixAtAttribute|指定された属性で使用される指定されたプレフィックスに定義済みの名前空間がありません。|  
+|NoInputIsSetForCanonicalization|正規化された出力の書き込みを行うための入力が設定されていません。|  
+|TraceCodeSecurityPendingServerSessionAdded|保留中のセキュリティ セッションがサーバーに追加されました。|  
+|AsyncCallbackException|AsyncCallback が例外を返しました。|  
+|PrivateKeyNotRSA|秘密キーは RSA キーではありません。|  
+|TraceCodeSecurityClientSessionKeyRenewed|クライアントのセキュリティ セッションはセッション キーを更新しました。|  
+|SAMLAuthorizationDecisionStatementMissingDecisionAttributeOnRead|読み取り中の SamlAuthorizationDecisionStatement の 'Decision' は指定されていないか、長さが 0 です。|  
+|SAMLAttributeNameAttributeRequired|SamlAttribute に対して指定された 'Name' は、NULL や長さ 0 であってはいけません。|  
+|SamlSerializerRequiresExternalSerializers|SamlSerializer は、トークン内に存在する SecurityKeyIdentifier をシリアル化するために SecurityTokenSerializer を必要とします。|  
+|UnableToResolveKeyReference|トークン リゾルバーは、指定されたセキュリティ キーの参照を解決できません。|  
+|UnsupportedKeyWrapAlgorithm|指定されたキー ラップ アルゴリズムはサポートされていません。|  
+|SAMLAssertionMissingIssuerAttributeOnRead|読み取り中の SamlAssertion の 'Issuer' が指定されていないか、長さが 0 です。|  
+|TraceCodeIssuanceTokenProviderUsingCachedToken|IssuanceTokenProvider はキャッシュされたサービス トークンを使用しました。|  
+|AESCryptGetKeyParamFailed|指定されたキー パラメーターを取得できませんでした。|  
+|InvalidNamespaceForEmptyPrefix|この名前空間は空のプレフィックスに対して無効です。|  
+|AESCipherModeNotSupported|指定された暗号モードはサポートされていません。CBC のみがサポートされます。|  
+|ArgumentCannotBeEmptyString|引数には空でない文字列を指定する必要があります。|  
+|SAMLAssertionMissingMinorVersionAttributeOnRead|読み取り中の SamlAssertion の MinorVersion が指定されていないか、長さが 0 です。|  
+|SpecifiedStringNotAvailableInDictionary|指定された文字列は現在の辞書のエントリではありません。|  
+|KerberosApReqInvalidOrOutOfMemory|AP\-REQ が無効であるか、またはシステムに十分なメモリがありません。|  
+|FailLogonUser|指定されたユーザーの LogonUser エラーです。このユーザーが有効な Windows アカウントを持っていることを確認してください。|  
+|ValueMustBeNonNegative|この引数の値は、負ではない値である必要があります。|  
+|X509ValidationFail|指定された X.509 証明書の検証に失敗しました。|  
+|TraceCodeSecuritySessionRequestorOperationSuccess|セキュリティ セッションの操作がクライアントで正常に完了しました。|  
+|SAMLActionNameRequiredOnRead|SamlAction について読み取られる文字列が指定されていないか、長さが 0 です。|  
+|KerberosMultilegsNotSupported|ID が UPN として指定されています。ユーザー アカウントで実行されているサービスを認証するには Kerberos マルチレッグ認証が必要ですが、これはサポートされていません。|  
+|SAMLAssertionIdRequired|SamlAssertion の 'assertionId' は、NULL や空であってはいけません。|  
+|InvalidOperationForWriterState|指定された操作は、XmlWriter の指定された状態では無効です。|  
+|CannotValidateSecurityTokenType|指定されたセキュリティ トークン認証システムは、指定された型のトークンを検証できません。|  
+|X509FindValueMismatch|指定された X509FindType では、引数 findValue の型が指定された値である必要があります。引数 findValue は別の型です。|  
+|TraceCodeSecurityClientSessionCloseSent|クライアントのセキュリティ セッションが Close メッセージを送信しました。|  
+|SuiteDoesNotAcceptAlgorithm|指定されたアルゴリズムは、指定されたアルゴリズム スイートによる指定された操作には使用できません。|  
+|TraceCodeSecuritySessionRequestorOperationFailure|クライアントのセキュリティ セッションの操作が失敗しました。|  
+|SAMLUnableToLoadStatement|SamlStatement を読み込むことができませんでした。|  
+|InnerReaderMustBeAtElement|内部リーダーは要素に配置されている必要があります。|  
+|UnableToCreateTokenReference|セキュリティ トークン参照を作成できません。|  
+|TraceCodeSecurityBindingIncomingMessageVerified|セキュリティ プロトコルは受信メッセージを確認しました。|  
+|ObjectIsReadOnly|このオブジェクトは読み取り専用です。|  
+|TraceCodeSecurityClientSessionPreviousKeyDiscarded|クライアントのセキュリティ セッションは直前のセッション キーを破棄しました。|  
+|SAMLTokenTimeInvalid|SamlToken の有効期限が切れました。現在の時刻は、トークンの Effective および Expiration 時刻の範囲外です。|  
+|TraceCodeSecurityIdentityVerificationSuccess|ID の検査が成功しました。|  
+|SigningTokenHasNoKeys|指定された署名トークンにはキーがありません。|  
+|TraceCodeSecurityIdentityVerificationFailure|ID の検査が失敗しました。|  
+|AESCryptImportKeyFailed|キー マテリアルをインポートできませんでした。|  
+|FailInitializeSecurityContext|InitializeSecurityContent エラーです。サービス プリンシパル名が正しいことを確認してください。|  
+|TraceCodeStreamSecurityUpgradeAccepted|ストリームのセキュリティ更新を正常に受信しました。|  
+|SAMLAuthorityBindingRequiresLocation|SamlAuthorityBinding で指定された 'Location' 属性は、NULL や長さ 0 であってはいけません。|  
+|PublicKeyNotDSA|公開キーは DSA キーではありません。|  
+|ImpersonationLevelNotSupported|Kerberos を使用した認証モードは、指定された偽装レベルをサポートしていません。有効な ID または偽装レベルを指定してください。|  
+|RequiredTargetNotSigned|指定された ID を持つ要素には署名が必要ですが、署名されていませんでした。|  
+|SAMLAuthenticationStatementMissingAuthenticationInstanceOnRead|SamlAuthenticationStatement の読み取り中の 'AuthenticationInstant' 属性は指定されていないか、長さが 0 です。|  
+|SAMLEvidenceShouldHaveOneAssertionOnRead|読み取り中の SamlEvidence には、SamlAssertion への参照または組み込みの SamlAssertion のどちらもありませんでした。|  
+|LengthOfArrayToConvertMustGreaterThanZero|整数に変換する配列の長さは、0 を超える値である必要があります。|  
+|InvalidAsyncResult|AsyncResult が無効です。|  
+|TraceCodeIssuanceTokenProviderRemovedCachedToken|IssuanceTokenProvider は期限切れのサービス トークンを削除しました。|  
+|IncorrectUserNameFormat|ユーザー名の形式が無効です。ユーザー名の形式は、'ユーザー名' または 'ドメイン\\\\ユーザー名' である必要があります。|  
+|TraceCodeExportSecurityChannelBindingEntry|セキュリティの ExportChannelBinding を開始しています。|  
+|UnsupportedInputTypeForTransform|指定された入力型は変換用にサポートされていません。|  
+|CannotFindDocumentRoot|ドキュメントのルートが見つかりません。|  
+|XmlBufferQuotaExceeded|XML コンテンツのバッファリングに必要なサイズがバッファー クォータを超過しました。|  
+|TraceCodeSecuritySessionClosedResponseSendFailure|セキュリティ セッションの Close 応答をクライアントに送信中、エラーが発生しました。|  
+|UnableToResolveReferenceInSamlSignature|AssertionID を持つ SAML 署名の指定された参照を解決できません。|  
+|SAMLSubjectRequiresNameIdentifierOrConfirmationMethod|SamlSubject では、'NameIdentifier' または 'ConfirmationMethod' を指定する必要があります。どちらも指定されていません。|  
+|SAMLAttributeMissingNamespaceAttributeOnRead|読み取り中の SamlAttribute の 'Namespace' が指定されていないか長さが 0 です。|  
+|SAMLSubjectConfirmationClauseMissingConfirmationMethodOnRead|読み取り中の SamlSubjectConfirmation で 'ConfirmationMethod' が見つかりません。|  
+|SecurityTokenRequirementHasInvalidTypeForProperty|トークンの要件に、指定されたプロパティの予期されていない型が含まれています。予期されたプロパティの型は別の値です。|  
+|TraceCodeNegotiationTokenProviderAttached|NegotiationTokenProvider が割り当てられました。|  
+|TraceCodeSpnegoClientNegotiationCompleted|SpnegoTokenProvider は SSPI ネゴシエーションを完了しました。|  
+|SAMLUnableToLoadUnknownElement|選択された SamlSerializer は、この要素を逆シリアル化できません。カスタム要素のシリアル化を解除するためのカスタム SamlSerializer を登録してください。|  
+|CreateSequenceRefused|作成シーケンス要求が RM 宛先により拒否されました。|  
+|TraceCodeSecuritySessionRedirectApplied|クライアントのセキュリティ セッションがリダイレクトされました。|  
+|SecurityTokenRequirementDoesNotContainProperty|トークンの要件に、指定されたプロパティが含まれていません。|  
+|SAMLAttributeValueCannotBeNull|SamlAttribute で見つかった attributeValues の 1 つが NULL 値でした。SamlAttribute 作成時にリストが NULL でないことを確認してください。|  
+|ValueMustBeGreaterThanZero|この引数の値は、正の値である必要があります。|  
+|TraceCodeNegotiationAuthenticatorAttached|NegotiationTokenAuthenticator が割り当てられました。|  
+|ValueMustBePositive||  
+|SAMLAuthorizationDecisionShouldHaveOneAction|SamlAuthorizationDecisionStatement には、少なくとも 1 つの SamlAction が含まれている必要があります。|  
+|TraceCodeSecurityTokenAuthenticatorClosed|セキュリティ トークンの認証システムは閉じられました。|  
+|TraceCodeSecurityAuditWrittenSuccess|セキュリティ監査ログが正常に書き込まれました。|  
+|PrivateKeyNotDSA|秘密キーは DSA キーではありません。|  
+|MessageNumberRollover|このシーケンスの最大シーケンス番号を超えました。|  
+|AESPaddingModeNotSupported|指定された埋め込みモードはサポートされていません。PKCS7 および ISO10126 のみサポートされます。|  
+|SAMLSubjectRequiresNameIdentifierOrConfirmationMethodOnRead|読み取り中の SamlSubject について必須の 'NameIdentifier' 要素および 'ConfirmationMethod' 要素が見つかりません。|  
+|TraceCodeSecurityAuditWrittenFailure|セキュリティの監査ログへの書き込み時にエラーが発生しました。|  
+|UnsupportedCryptoAlgorithm|指定された暗号アルゴリズムは、このコンテキストではサポートされていません。|  
+|SigningTokenHasNoKeysSupportingTheAlgorithmSuite|署名トークンに、指定されたアルゴリズム スイートをサポートするキーがありません。|  
+|SAMLNameIdentifierMissingIdentifierValueOnRead|読み取り中の SamlNameIdentifier の 'Identifier' 文字列がありません。|  
+|SAMLSubjectStatementRequiresSubject|SAML Subject Statement では、SAML サブジェクトを指定する必要があります。|  
+|TraceCodeSslClientCertMissing|リモートの SSL クライアントは必要な資格情報を提供できませんでした。|  
+|SAMLTokenVersionNotSupported|指定されたメジャー バージョンとマイナー バージョンはサポートされていません。|  
+|TraceCodeConfigurationIsReadOnly|構成は読み取り専用です。|  
+|TraceCodeSecuritySessionRenewFaultSendFailure|セキュリティ セッション キーの更新エラーをクライアントに送信中にエラーが発生しました。|  
+|TraceCodeSecurityInactiveSessionFaulted|アクティブでないセキュリティ セッションはサーバー側でエラーとなりました。|  
+|SAMLUnableToLoadAttribute|SamlAttribute を読み込むことができませんでした。|  
+|Psha1KeyLengthInvalid|指定された PSHA1 キーの長さが無効です。|  
+|KeyIdentifierCannotCreateKey|この SecurityKeyIdentifier には、キーを作成できる句がありません。|  
+|X509IsInUntrustedStore|指定された X.509 証明書は、信頼されていない証明書ストアにあります。|  
+|UnexpectedXmlChildNode|指定された型の指定された XML 子ノードは、指定された要素に対して予期されていません。|  
+|TokenDoesNotMeetKeySizeRequirements|指定されたアルゴリズム スイートのキー サイズ要件が、指定されたトークンによって満たされていません。|  
+|TraceCodeSecuritySessionRequestorStartOperation|クライアントでセキュリティ セッションの操作が開始されました。|  
+|InvalidHexString|16 進数文字列の形式が無効です。|  
+|SamlAttributeClaimResourceShouldBeAString|この SamlAttribute コンストラクターでは、クレームのリソースが 'string' 型であることが要求されます。|  
+|SamlSigningTokenNotFound|SamlAssertion は署名されていますが、SamlAssertion に署名したトークンが見つかりません。SecurityTokenResolver に、SamlAssertion に署名したトークンが含まれていることを確認してください。|  
+|TraceCodeSecuritySpnToSidMappingFailure|ServicePrincipalName を SecurityIdentifier にマップできませんでした。|  
+|UnableToCreateSignatureFormatterFromAsymmetricCrypto|指定された非対称暗号から、指定されたアルゴリズムの署名フォーマッタを作成できません。|  
+|TraceCodeSecurityServerSessionClosedFaultSent|サーバーのセキュリティ セッションによりセッション終了済みのフォールトがクライアントに送信されました。|  
+|UnableToFindPrefix|指定された要素で明示的に使用される指定されたプレフィックスのプレフィックスが見つかりません。|  
+|TraceCodeSecurityTokenAuthenticatorOpened|セキュリティ トークンの認証システムを開きました。|  
+|RequiredAttributeMissing|指定された属性は指定された要素で必要です。|  
+|LocalIdCannotBeEmpty|localId を空にすることはできません。有効な 'localId' を指定してください。|  
+|ValueMustBeInRange|この引数の値は、指定された範囲内である必要があります。|  
+|TraceCodeIssuanceTokenProviderBeginSecurityNegotiation|IssuanceTokenProvider が新しいセキュリティ ネゴシエーションを開始しました。|  
+|InvalidNtMapping|指定された X.509 証明書を Windows アカウントにマップできません。UPN サブジェクト代替名が必要です。|  
+|AESCryptSetKeyParamFailed|指定されたキー パラメーターを設定できませんでした。|  
+|TraceCodeSecuritySessionClosedResponseReceived|クライアントのセキュリティ セッションはサーバーから終了応答を受信しました。|  
+|UnableToCreateSignatureDeformatterFromAsymmetricCrypto|指定された非対称暗号から、指定されたアルゴリズムの署名デフォーマッタを作成できません。|  
+|TraceCodeIdentityModelAsyncCallbackThrewException|非同期コールバックで例外がスローされました。|  
+|LengthMustBeGreaterThanZero|この引数の長さは、0 を超える値である必要があります。|  
+|FoundMultipleCerts|StoreName、StoreLocation、FindType、FindValue という検索条件で検索しましたが、複数の X.509 証明書が見つかりました。より具体的な検索条件を指定してください。|  
+|AtLeastOneTransformRequired|Transforms 要素には変換が少なくとも 1 つ必要です。|  
+|SAMLTokenNotSerialized|SamlAssertion を XML にシリアル化できませんでした。詳細については、内部例外を参照してください。|  
+|TraceCodeSecurityBindingOutgoingMessageSecured|セキュリティ プロトコルは送信メッセージをセキュリティで保護しました。|  
+|KeyIdentifierClauseDoesNotSupportKeyCreation|この SecurityKeyIdentifierClause は、キーの作成をサポートしていません。|  
+|UnableToResolveTokenReference|トークン リゾルバーは、指定されたトークン参照を解決できません。|  
+|UnsupportedEncryptionAlgorithm|指定された暗号化アルゴリズムはサポートされていません。|  
+|SamlSerializerUnableToWriteSecurityKeyIdentifier|SamlSerializer には、指定された SecurityKeyIdentifier をシリアル化できる SecurityTokenSerializer が含まれていません。カスタム SecurityKeyIdentifier を使用している場合は、カスタムの SecurityTokenSerializer を指定する必要があります。|  
+|SAMLAttributeShouldHaveOneValue|属性値が見つかりませんでした。SamlAttribute 属性には、少なくとも 1 つの属性値が必要です。|  
+|TraceCodeSecurityBindingVerifyIncomingMessageFailure|セキュリティ プロトコルにより受信メッセージを検証できません。|  
+|SamlSigningTokenMissing|SamlSecurityTokenAuthenticator に渡された SamlAssertion に署名トークンがありません。|  
+|NoPrivateKeyAvailable|秘密キーがありません。|  
+|ValueMustBeOne|この引数の値は 1 でなければなりません。|  
+|TraceCodeSecurityPendingServerSessionRemoved|保留中のセキュリティ セッションがサーバーによって有効化されました。|  
+|TraceCodeImportSecurityChannelBindingExit|セキュリティの ImportChannelBinding を終了しました。|  
+|X509CertStoreLocationNotValid|StoreLocation は、LocalMachine または CurrentUser である必要があります。|  
+|SettingdMayBeModifiedOnlyWhenTheWriterIsInStartState|ライターの設定は、ライターが Start 状態にある場合のみ変更できます。|  
+|ArgumentInvalidCertificate|証明書が無効です。|  
+|DigestVerificationFailedForReference|指定された参照のダイジェスト認証が失敗しました。|  
+|SAMLAuthorityBindingRequiresBinding|SamlAuthorityBinding で指定された 'Binding' 属性は、NULL や長さ 0 であってはいけません。|  
+|AESInsufficientOutputBuffer|出力バッファーは指定されたバイトを超える値である必要があります。|  
+|SAMLAuthorityBindingMissingBindingOnRead|読み取り中の SamlAuthorityBinding の 'Binding' 属性は指定されていないか、長さが 0 です。|  
+|SAMLAuthorityBindingInvalidAuthorityKind|読み取られる SamlAuthorityBinding に無効な AuthorityKind が指定されています。AuthorityKind の形式は QName である必要があります。|  
+|ProvidedNetworkCredentialsForKerberosHasInvalidUserName|Kerberos トークンに指定された NetworkCredentials に有効な UserName がありません。|  
+|SSPIPackageNotSupported|指定された SSPI パッケージはサポートされていません。|  
+|TokenCancellationNotSupported|指定されたトークン プロバイダーは、トークンのキャンセルをサポートしていません。|  
+|UnboundPrefixInQName|バインドされていないプレフィックスが、指定された修飾名で使用されています。|  
+|SAMLAuthorizationDecisionResourceRequired|SamlAuthorizationDecisionStatement に指定された 'resource' は、NULL や長さ 0 であってはいけません。|  
+|TraceCodeSecurityNegotiationProcessingFailure|サービス セキュリティ ネゴシエーション処理が失敗しました。|  
+|SAMLAssertionIssuerRequired|SamlAssertion に対して指定された 'Issuer' は、NULL や空であってはいけません。|  
+|UnableToCreateHashAlgorithmFromAsymmetricCrypto|指定された非対称暗号から、指定されたアルゴリズムの HashAlgorithm を作成できません。|  
+|SamlUnableToExtractSubjectKey|SamlSubject で見つかった SecurityKeyIdentifier を SecurityToken に解決できません。SecurityTokenResolver には、SecurityKeyIdentifier の解決対象となる SecurityToken が含まれている必要があります。|  
+|ChildNodeTypeMissing|指定された XML 要素には、指定された型の子がありません。|  
+|TraceCodeSecurityPendingServerSessionClosed|保留中のセキュリティ セッションはサーバーによって閉じられました。|  
+|TraceCodeSecuritySessionCloseResponseSent|サーバーのセキュリティ セッションはクライアントに Close 応答を送信しました。|  
+|TraceCodeSecurityIdentityHostNameNormalizationFailure|エンドポイント アドレスの HostName 部分は標準化できません。|  
+|FailAcceptSecurityContext|AcceptSecurityContext エラーです。|  
+|EmptyXmlElementError|指定された要素を空にすることはできません。|  
+|PrefixNotDefinedForNamespace|指定された名前空間のプレフィックスはこのコンテキストで定義されていないため、宣言できません。|  
+|SAMLAuthorizationDecisionHasMoreThanOneEvidence|読み取られる SamlAuthorizationDecisionStatement には複数の Evidence が含まれています。これは許可されていません。|  
+|SamlTokenAuthenticatorCanOnlyProcessSamlTokens|SamlSecurityTokenAuthenticator は SamlSecurityToken のみを処理できます。指定された SecurityTokenType が受信されました。|  
+|SAMLAttributeStatementMissingAttributeOnRead|読み取り中の SamlAttributeStatement に 'SamlAttribute' 要素が含まれていません。これは許可されていません。|  
+|CouldNotFindNamespaceForPrefix|指定されたプレフィックスの名前空間が見つかりません。|  
+|TraceCodeExportSecurityChannelBindingExit|セキュリティの ExportChannelBinding を終了しました。|  
+|AESCryptDecryptFailed|指定されたデータを復号化できませんでした。|  
+|SAMLAttributeNamespaceAttributeRequired|SamlAttribute に対して指定された 'Namespace' は、NULL や長さ 0 であってはいけません。|  
+|TraceCodeSpnegoServiceNegotiationCompleted|SpnegoTokenAuthenticator は SSPI ネゴシエーションを完了しました。|  
+|TraceCodeSecurityServerSessionRenewalFaultSent|サーバーのセキュリティ セッションはクライアントにキーの更新エラーを送信しました。|  
+|AlgorithmMismatchForTransform|変換用のアルゴリズムで不整合が発生しました。|  
+|UserNameAuthenticationFailed|指定された機構を使用したユーザー名\/パスワードの認証に失敗しました。ユーザーは認証されていません。|  
+|SamlInvalidSigningToken|SamlAssertion は、プロトコルに従って検証されていないトークンを使用して署名されています。X.509 証明書を使用している場合は、検証セマンティクスを調べてください。|  
+|TraceCodeSecurityServerSessionKeyUpdated|セキュリティ セッション キーはサーバーによって更新されました。|  
+|TraceCodeSecurityServerSessionCloseReceived|サーバーのセキュリティ セッションはクライアントから Close メッセージを受信しました。|  
+|SAMLAuthenticationStatementMissingSubject|SamlAuthenticationStatement に、必要な SamlSubjectStatement がありません。|  
+|UnexpectedEndOfFile|予期しない EOF エラーです。|  
+|UnsupportedAlgorithmForCryptoOperation|指定されたアルゴリズムは、指定された操作でサポートされていません。|  
+|XmlLangAttributeMissing|必要な xml:lang 属性がありません。|  
+|TraceCodeSecurityImpersonationSuccess|サーバー側でセキュリティの偽装が成功しました。|  
+|SAMLAuthorityBindingMissingLocationOnRead|読み取り中の SamlAuthorityBinding の 'Location' 属性は指定されていないか、長さが 0 です。|  
+|SAMLAttributeStatementMissingSubjectOnRead|SamlAttributeStatement の 'SamlSubject' 要素が指定されていません。|  
+|SAMLAuthorizationDecisionStatementMissingSubjectOnRead|読み取り中の SamlAuthorizationDecisionStatement の 'SamlSubject' 要素が指定されていません。|  
+|SAMLBadSchema|SamlAssertion の読み取り中に、この指定された要素がスキーマに準拠していないことがわかりました。|  
+|SAMLAssertionIDIsInvalid|SamlAssertion の指定された 'assertionId' は、文字または '\_' で始まる必要があります。|  
+|TraceCodeSecurityActiveServerSessionRemoved|アクティブなセキュリティ セッションはサーバー側で削除されました。|  
+|UnableToCreateKeyedHashAlgorithmFromSymmetricCrypto|指定された対称暗号から、指定されたアルゴリズムの keyedHashAlgorithm を作成できません。|  
+|SAMLAuthenticationStatementMissingAuthenticationMethod|SamlAuthenticationStatement に対して指定された 'AuthenticationMethod' は、NULL や長さ 0 であってはいけません。|  
+|TraceCodeSecurityImpersonationFailure|サーバー側でセキュリティの偽装が失敗しました。|  
+|Default|\(既定値\)|  
+|UnsupportedNodeTypeInReader|指定された名前の指定されたノード型はサポートされていません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/index.md b/docs/framework/wcf/diagnostics/exceptions-reference/index.md
new file mode 100644
index 00000000000..9b33bf70b6e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/index.md
@@ -0,0 +1,66 @@
+---
+title: "例外リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: adc19950-5f79-4045-8403-bf6310118ee3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 例外リファレンス
+ここでは、次のエリアで [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] によって生成されるすべての例外を示します。  
+  
+ [IdentityModel](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/identitymodel-exceptions.md)  
+  
+ [COM\+ 統合](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/com-integration.md)  
+  
+ [構成](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/configuration.md)  
+  
+ [コア通信 : チャネル フレームワーク](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-channel-framework.md)  
+  
+ [コア通信 : 接続フレームワーク](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-connection-framework.md)  
+  
+ [コア通信 : HTTP\/HTTPS トランスポート チャネル](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-http-https-transport-channels.md)  
+  
+ [コア通信 : InternalDuplex トランスポート チャネル](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-internal-duplex-transport-channels.md)  
+  
+ [コア通信 : 名前付きパイプ トランスポート チャネル](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-named-pipe-transport-channels.md)  
+  
+ [コア通信 : TCP トランスポート チャネル](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-tcp-transport-channels.md)  
+  
+ [コア通信 : トランスポート フレームワーク](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-transport-framework.md)  
+  
+ [コア通信 : ユーティリティ](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-utilities.md)  
+  
+ [コア通信 : Webhost サポート](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/core-communications-webhost-support.md)  
+  
+ [トランザクション](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/transaction-exceptions.md)  
+  
+ [ホスティング](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/hosting-exceptions.md)  
+  
+ [ピア チャネル](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/peer-channel.md)  
+  
+ [MSMQ 統合のトランスポート](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/msmq-integration-transport.md)  
+  
+ [MSMQ トランスポート](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/msmq-transport.md)  
+  
+ [信頼できるメッセージ機能](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/reliable-messaging.md)  
+  
+ [セキュリティ例外](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/security-exceptions.md)  
+  
+ [サービス フレームワーク](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/service-framework.md)  
+  
+ [サービス フレームワーク データ](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/service-framework-data.md)  
+  
+ [トランザクション フォーマッタ](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/transaction-formatter.md)  
+  
+ [ツール](../../../../../docs/framework/wcf/diagnostics/exceptions-reference/tools.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/msmq-integration-transport.md b/docs/framework/wcf/diagnostics/exceptions-reference/msmq-integration-transport.md
new file mode 100644
index 00000000000..1c186456ca2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/msmq-integration-transport.md
@@ -0,0 +1,33 @@
+---
+title: "MSMQ 統合のトランスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2bf9893a-fbd1-41fc-b6de-a41a44279936
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# MSMQ 統合のトランスポート
+ここでは、MSMQ 統合トランスポートによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|MessageSizeMustBeInIntegerRange|このファクトリはメッセージをバッファーするため、メッセージ サイズは整数値の範囲内である必要があります。|  
+|MsmqByteArrayBodyExpected|指定されたシリアル化形式と MSMQ メッセージの間で不整合が検出されました。メッセージを送受信できません。シリアル化形式 ByteArray では、MSMQ メッセージの本文が byte\[\] の種類でなければなりません。|  
+|MsmqCannotDeserializeActiveXMessage|ActiveX のシリアル化中に、エラーが発生しました。メッセージを送受信できません。本文に指定されたバリアント型は、実際の MSMQ メッセージ本文と一致しません。|  
+|MsmqCannotUseBodyTypeWithActiveXSerialization|メッセージのプロパティが整合していません。メッセージを送受信できません。シリアル化の形式として ActiveX が使用されている場合は、BodyType メッセージ プロパティを指定できません。|  
+|MsmqInvalidServiceOperationForMsmqIntegrationBinding|MsmqIntegrationBinding の検証が失敗しました。サービス エンドポイントを開始できません。指定したバインディングは、指定したコントラクトの指定したサービス操作に対してメソッド署名をサポートしていません。MsmqIntegrationBinding を使用するよう、サービス操作を修正してください。|  
+|MsmqInvalidTypeDeserialization|シリアル化の形式を認識できないため、ActiveX のシリアル化が失敗しました。メッセージを送受信できません。|  
+|MsmqInvalidTypeSerialization|バリアント型を認識できません。ActiveX のシリアル化が失敗しました。メッセージを送受信できません。指定されたバリアント型はサポートされていません。|  
+|MsmqStreamBodyExpected|シリアル化形式と本文のコンテンツの間で不整合があります。メッセージを送受信できません。ストリーム シリアル化モードを使用して送受信できるのは、ストリーム型の本文に限られます。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/msmq-transport.md b/docs/framework/wcf/diagnostics/exceptions-reference/msmq-transport.md
new file mode 100644
index 00000000000..478bd740903
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/msmq-transport.md
@@ -0,0 +1,49 @@
+---
+title: "MSMQ トランスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f29a2fe-24df-4614-b64c-b0c084fb7003
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MSMQ トランスポート
+ここでは、MSMQ トランスポートによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|MsmqActiveDirectoryRequiresNativeTransfer|メッセージのバインディングを検証できませんでした。クライアントはメッセージを送信できません。バインディングのプロパティの競合が原因でこのエラーが発生しました。UseActiveDirectory は true に設定されており、QueueTransferProtocol は Native に設定されています。競合を解決するには、どちらかのプロパティを適切な値に変更してください。|  
+|MsmqAuthNoneRequiresProtectionNone|サービスのバインディングを検証できませんでした。サービスのエンドポイントまたはクライアントを開始できません。バインディングのプロパティの競合が原因でこのエラーが発生しました。MsmqAuthenticationMode が None に設定されている場合、MsmqProtectionLevel を None に設定する必要があります。競合を解決するには、どちらかのプロパティを適切な値に変更してください。|  
+|MsmqCustomRequiresPerAddDLQ|メッセージのバインディングを検証できませんでした。クライアントはメッセージを送信できません。DeadLetterQueue は Custom に設定されていますが、CustomDeadLetterQueue が指定されていません。CustomDeadLetterQueue プロパティで、各アプリケーションの配信不能メッセージ キューの URI を指定してください。|  
+|MsmqDeserializationError|XML メッセージの逆シリアル化時にエラーが発生しました。メッセージを受信できないため、破棄しました。|  
+|MsmqDLQNotWriteable|クライアントのバインディングを検証できませんでした。クライアントはメッセージを送信できません。指定された配信不能メッセージ キューが存在していないか書き込み不能です。このキューが存在しており、このキューに書き込むための適切な権限が割り当てられいることを確認してください。|  
+|MsmqGetPrivateComputerInformationError|バージョン チェックが、指定されたエラーで失敗しました。MSMQ のバージョンを検出できません。キューにあるチャネルでのすべての操作は失敗します。MSMQ がインストールされており、使用可能であることを確認してください。|  
+|MsmqNoAssurancesForVolatile|サービスのバインディングを検証できませんでした。サービスのエンドポイントまたはクライアントを開始できません。ExactlyOnce プロパティは true に設定されており、Durable プロパティは false に設定されていますが、これはサポートされていません。競合を解決するには、どちらかのプロパティを適切な値に変更してください。|  
+|MsmqNonTransactionalQueueNeeded|バインドと MSMQ キューの構成間で不整合が検出されました。サービス エンドポイントを開始できません。ExactlyOnce プロパティは false に設定されており、メッセージが読み取られるキューはトランザクション キューです。このエラーを修正するには、ExactlyOnce プロパティを true に設定するか、非トランザクション バインドを作成してください。|  
+|MsmqOpenError|指定されたキュー を開く際にエラーが発生しました。キューからメッセージを送受信できません。MSMQ がインストールされ、実行されていることを確認します。また、要求されたアクセス モードおよび認証を使用してキューを開いて利用できることも確認してください。|  
+|MsmqPathLookupError|指定されたキュー パス名を指定の形式名に変換中にエラーが発生しました。キュー内のチャネルに対するすべての操作が失敗しました。キュー アドレスが有効であることを確認してください。Active Directory 統合が有効になった状態で MSMQ がインストールされている必要があり、MSMQ にアクセスできる必要があります。|  
+|MsmqPerAppDLQRequiresCustom|クライアントのバインドの検証が失敗しました。クライアントはメッセージを送信できません。CustomDeadLetterQueue プロパティが設定されていますが、DeadLetterQueue プロパティが Custom に設定されていません。DeadLetterQueue プロパティを Custom に設定してください。|  
+|MsmqPerAppDLQRequiresExactlyOnce|クライアントのバインディングを検証できませんでした。クライアントはメッセージを送信できません。バインド プロパティ内の競合が原因です。カスタムの配信不能メッセージ キューを使用するには、ExactlyOnce を true に設定して競合を解決する必要があります。|  
+|MsmqPerAppDLQRequiresMsmq4|バインドと MSMQ の構成間で不整合が検出されました。クライアントはメッセージを送信できません。カスタムの配信不能メッセージ キューを使用するには、MSMQ Version 4.0 以降が必要です。MSMQ Version 4.0 以降がない場合は、DeadLetterQueue プロパティを System または None に設定してください。|  
+|MsmqReceiveError|キューからのメッセージを受信中にエラーが発生しました。MSMQ がインストールされ、実行されていることを確認します。また、このキューからの受信が可能であることを確認してください。|  
+|MsmqSameTransactionExpected|このセッションでトランザクション エラーが発生しました。セッション チャネルは途中終了されました。このセッション内のメッセージは送信も受信もできません。キュー内の 1 つのセッションを複数のトランザクションに関連付けることはできません。セッション内のすべてのメッセージが単一のトランザクションを使用して送信または受信されていることを確認してください。|  
+|MsmqSendError|指定されたキューへの送信中にエラーが発生しました。MSMQ がインストールされて実行されていることを確認してください。ローカル キューに送信している場合は、このキューが存在しており、必要なアクセス モードと権限が設定されていることを確認してください。|  
+|MsmqTimeSpanTooLarge|メッセージの Time to Live \(TTL\) が長すぎます。メッセージを送信できません。メッセージの Time To Live は Int32 の最大値を超えることはできません。|  
+|MsmqTokenProviderNeededForCertificates|X509SecurityTokenProvider が見つかりません。メッセージを送信できません。証明書認証モードには、X.509 トークン プロバイダーが必要です。インストールされた証明書でセキュリティ トークン プロバイダーが使用できることを確認します。|  
+|MsmqTransactedDLQExpected|バインドと MSMQ の構成間で不整合が発生しました。メッセージを送信できません。バインドで指定されたカスタムの配信不能メッセージ キューは、トランザクション キューである必要があります。カスタムの配信不能メッセージ キューのアドレスが正しいこと、およびこのキューがトランザクション キューであることを確認してください。|  
+|MsmqTransactionalQueueNeeded|バインドと MSMQ キューの構成間で不整合が発生しました。サービス エンドポイントを開始できません。ExactlyOnce プロパティは true に設定されており、メッセージが読み取られるキューはトランザクション キューではありません。このエラーを修正するには、ExactlyOnce プロパティを false に設定するか、このバインディング用のトランザクション キューを作成してください。|  
+|MsmqTransactionCurrentRequired|セッションでメッセージを送信するためにトランザクションを使用できません。キュー内のセッションにあるメッセージを送信するにはトランザクションが必要です。セッションでメッセージを送信するためにトランザクション範囲が指定されていることを確認してください。|  
+|MsmqTransactionRequired|トランザクションが必要ですが、使用できません。メッセージが送信または受信できません。メッセージを送信または受信するためのトランザクション範囲が指定されていることを確認してください。|  
+|MsmqUnsupportedSerializationFormat|逆シリアル化エラーが発生しました。メッセージを受信できないため、破棄しました。指定されたシリアル化形式はサポートされていません。|  
+|MsmqWrongPrivateQueueSyntax|URL が無効です。キューの URL に '$' 文字を使用することはできません。net.msmq:\/\/machine\/private\/queueName の構文を使用して、プライベート キューをアドレス指定してください。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/peer-channel.md b/docs/framework/wcf/diagnostics/exceptions-reference/peer-channel.md
new file mode 100644
index 00000000000..8a7f09bce7d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/peer-channel.md
@@ -0,0 +1,30 @@
+---
+title: "ピア チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e06a2efb-8e70-4299-8b0f-bfb37efb074b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ピア チャネル
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ピア チャネルによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|InsufficientCredentials|この資格情報では、要求された操作を行うことはできません。  指定した操作に有効な値を設定してください。|  
+|InvalidResolverMode|指定した PeerResolverMode の値は無効です。  PeerResolveMode.Auto、Default、PNRP のいずれかを指定してください。|  
+|PeerNodeAborted|PeerNode は既に終了しているので開けませんでした。|  
+|PeerNullRegistrationInfo|登録情報として null を指定することはできません。  有効な RegistrationInfo オブジェクトを使用して Register 操作を呼び出してください。|  
+|PeerNullResolveInfo|参照の解決に使用する情報として `null` を指定することはできません。  有効な ResolveInfo オブジェクトを使用して Resolve 操作を呼び出してください。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/reliable-messaging.md b/docs/framework/wcf/diagnostics/exceptions-reference/reliable-messaging.md
new file mode 100644
index 00000000000..6c933b147f1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/reliable-messaging.md
@@ -0,0 +1,26 @@
+---
+title: "信頼できるメッセージ機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 46d41fdf-b1f8-4968-8e54-c896848885fa
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 信頼できるメッセージ機能
+ここでは、信頼できるメッセージ機能によって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|InvalidBufferRemaining|バッファーの残りサイズが指定値に達したというメッセージが受信されました。残りのバッファーをゼロ未満にすることはできません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/security-exceptions.md b/docs/framework/wcf/diagnostics/exceptions-reference/security-exceptions.md
new file mode 100644
index 00000000000..efe45a74a22
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/security-exceptions.md
@@ -0,0 +1,165 @@
+---
+title: "セキュリティ例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76d5e5cd-e4f4-404f-9a5a-ec3522494ad8
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# セキュリティ例外
+ここでは、すべてのセキュリティ例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|AnonymousLogonsAreNotAllowed|このサービスでは匿名ログオンは許可されていません。|  
+|AtLeastOneContractOperationRequestRequiresProtectionLevelNotSupportedByBinding|要求メッセージは保護される必要があります。これは指定されたコントラクトの操作で必要です。指定されたバインディングで保護される必要があります。|  
+|AtLeastOneContractOperationResponseRequiresProtectionLevelNotSupportedByBinding|応答メッセージは保護される必要があります。これは指定されたコントラクトの操作で必要です。指定されたバインディングで保護される必要があります。|  
+|AtMostOnePrimarySignatureInReceiveSecurityHeader|セキュリティ ヘッダーに指定できるプライマリ署名は 1 つだけです。|  
+|BadContextTokenFaultReason|セキュリティ コンテキスト トークンが期限切れであるか無効です。メッセージは処理されませんでした。|  
+|BadEncryptionState|EncryptedData または EncryptedKey は、この操作に対して無効な状態です。|  
+|BasicHttpMessageSecurityRequiresCertificate|BasicHttp のバインディングでは、メッセージをセキュリティで保護するために BasicHttpBinding.Security.Message.ClientCredentialType が BasicHttpMessageCredentialType.Certificate 資格情報型と等しいことが要求されています。UserName 資格情報には、Transport または TransportWithMessageCredential セキュリティを選択してください。|  
+|BasicTokenCannotBeWrittenWithoutEncryption|基本トークンを暗号化せずに書き込むことはできません。|  
+|BindingDoesNotSupportProtectionForRst|指定されたコントラクトの指定されたバインディングには SecureConversation が構成されていますが、この認証モードでは、ネゴシエーションに必要な要求\/応答ベースの整合性と機密性を実現できません。|  
+|BindingDoesNotSupportWindowsIdenityForImpersonation|自動的に偽装を行うには指定されたコントラクト操作に Windows ID が必要です。呼び出し元を表す Windows ID が、指定されたコントラクトの指定されたバインディングによって提供されていません。|  
+|CachedNegotiationStateQuotaReached|容量が指定された制限に達したため、サービスがネゴシエーションの状態をキャッシュできません。要求を再試行してください。|  
+|CacheQuotaReached|項目を追加できません。キャッシュの最大サイズが指定されています。|  
+|CannotDetermineSPNBasedOnAddress|クライアントは、SspiNegotiation\/Kerberos に使用される指定された対象アドレスの ID から、サービス プリンシパル名を特定できません。対象アドレス ID は、UPN ID \(例: acmedomain\\\\alice\) または SPN ID \(例: host\/bobs\-machine\) である必要があります。|  
+|CannotFindCert|StoreName、StoreLocation、FindType、FindValue という検索条件で検索しましたが、X.509 証明書が見つかりません。|  
+|CannotFindCertForTarget|指定された対象の StoreName、StoreLocation、FindType、FindValue という、指定された検索条件で検索しましたが、X.509 証明書が見つかりません。|  
+|CannotFindCorrelationStateForApplyingSecurity|応答側の応答にセキュリティを適用するために必要な相関状態が見つかりません。|  
+|CannotFindNegotiationState|指定されたコンテキストのネゴシエーションの状態が見つかりません。|  
+|CannotFindSecuritySession|指定された ID を持つセキュリティ セッションが見つかりません。|  
+|CannotImportProtectionLevelForContract|プロセスをインポートするポリシーが指定されたコントラクトのバインディングをインポートできません。このバインディングの保護要件は、このコントラクトについて既にインポートされたバインディングに適合していません。このバインディングを構成し直す必要があります。|  
+|CannotImportSupportingTokensForOperationWithoutRequestAction|セキュリティ ポリシーのインポートに失敗しました。このセキュリティ ポリシーには、操作範囲にサポート トークン要件が含まれています。コントラクトの説明では、この操作に関連付けられている要求メッセージに対するアクションが指定されていません。|  
+|CannotIssueRstTokenType|トークンまたは指定された型を発行できません。|  
+|CannotObtainIssuedTokenKeySize|発行されたトークンのキー サイズを特定できません。|  
+|CannotPerformImpersonationOnUsernameToken|クライアント トークンを使用した偽装はできません。指定されたコントラクトの指定されたバインディングでは、登録済みのメンバーシップ プロバイダーによるクライアント認証にユーザー名セキュリティ トークンを使用します。クライアント用に別の種類のセキュリティ トークンを使用してください。|  
+|CannotPerformS4UImpersonationOnPlatform|指定されたコントラクトの指定されたバインディングは、[!INCLUDE[ws2003](../../../../../includes/ws2003-md.md)] 以降のバージョンの Windows でのみ偽装をサポートします。SspiNegotiated 認証とキャンセルを有効にした SecureConversation を使用したバインディングを使用してください。|  
+|CannotReadKeyIdentifier|指定された名前空間を持つ指定された要素から KeyIdentifier を読み取ることができません。|  
+|CannotReadToken|指定された ValueType が設定された BinarySecretSecurityToken の、指定された名前空間を持つ指定された要素からトークンを読み取ることができません。この要素が有効であることが要求される場合は、指定された名前、名前空間、および値の型のトークンを使用するようにセキュリティが構成されていることを確認してください。|  
+|CertificateUnsupportedForHttpTransportCredentialOnly|証明書ベースのクライアント認証は TransportCredentialOnly セキュリティ モードではサポートされません。Transport セキュリティ モードを選択してください。|  
+|ClaimTypeCannotBeEmpty|claimType を空の文字列にすることはできません。|  
+|ClientCertificateNotProvided|クライアントの証明書が提供されていません。証明書は、ClientCredentials または ServiceCredentials で設定できます。|  
+|ClientCredentialTypeMustBeSpecifiedForMixedMode|ClientCredentialType.None は、TransportWithMessageCredential セキュリティ モードでは無効です。資格情報の種類を指定するか、別のセキュリティ モードを使用してください。|  
+|ConfigurationSchemaInsuffientForSecurityBindingElementInstance|この構成スキーマは、次のセキュリティ バインド要素の非標準構成を記述するには不十分です:|  
+|DerivedKeyTokenGenerationAndLengthTooHigh|派生キーの指定された世代と長さに問題があるため、キー派生オフセットが許可されている最大オフセットを超えています。|  
+|DnsIdentityCheckFailedForIncomingMessage|受信メッセージの ID 検査が失敗しました。リモート エンドポイントの予測されたドメイン ネーム システム \(DNS\) ID は既に指定されています。リモート エンドポイントから提供されたのは、指定されたドメイン ネーム システム \(DNS\) クレームでした。これが適正なリモート エンドポイントである場合は、チャネルのプロキシを作成する際に、ドメイン ネーム システム ID を EndpointAddress の ID プロパティとして指定することで問題を修正できます。|  
+|DnsIdentityCheckFailedForOutgoingMessage|送信メッセージの ID の確認に失敗しました。リモート エンドポイントには、指定されたドメイン ネーム システム ID が必要でした。リモート エンドポイントから提供されたのは、ドメイン ネーム システム \(DNS\) クレームでした。これが適正なリモート エンドポイントである場合は、チャネルのプロキシを作成する際に、DNS ID を EndpointAddress の ID プロパティとして明示的に指定することで問題を修正できます。|  
+|DuplicateIdInMessageToBeVerified|検証対象のメッセージに、指定された ID が 2 つあります。|  
+|EmptyBase64Attribute|必須の Base64 属性名と名前空間に対して空の値が見つかりました。|  
+|ExportOfBindingWithAsymmetricAndTransportSecurityNotSupported|セキュリティ ポリシーをエクスポートできませんでした。このバインディングには、AsymmetricSecurityBindingElement とセキュリティで保護されたトランスポート バインド要素の両方が指定されています。そのようなバインディングへのポリシーのエクスポートはサポートされていません。|  
+|ExportOfBindingWithSymmetricAndTransportSecurityNotSupported|セキュリティ ポリシーをエクスポートできませんでした。このバインディングには、SymmetricSecurityBindingElement とセキュリティで保護されたトランスポート バインド要素の両方が指定されています。そのようなバインディングへのポリシーのエクスポートはサポートされていません。|  
+|ExportOfBindingWithTransportSecurityBindingElementAndNoTransportSecurityNotSupported|セキュリティ ポリシーをエクスポートできませんでした。このバインディングには、TransportSecurityBindingElement が指定されていますが、ITransportTokenAssertionProvider を実装するトランスポート バインド要素がありません。そのようなバインディングへのポリシーのエクスポートはサポートされていません。バインディングに ITransportTokenAssertionProvider インターフェイスを実装するトランスポート バインド要素を設定してください。|  
+|FoundMultipleCerts|StoreName、StoreLocation、FindType、FindValue という検索条件で検索しましたが、複数の X.509 証明書が見つかりました。より具体的な検索条件を指定してください。|  
+|FoundMultipleCertsForTarget|指定された対象の StoreName、StoreLocation、FindType、FindValue という、指定された検索条件で検索したところ、複数の X.509 証明書が見つかりました。より具体的な検索条件を指定してください。|  
+|HeaderDecryptionNotSupportedInWsSecurityJan2004|SecurityVersion.WSSecurityJan2004 は、ヘッダーの解読をサポートしていません。SecurityVersion.WsSecurityXXX2005 以降を使用するか、トランスポート セキュリティを使用してメッセージ全体を暗号化してください。|  
+|IdentityCheckFailedForIncomingMessage|受信メッセージの ID 検査が失敗しました。予測される ID が対象エンドポイントに指定されています。|  
+|IdentityCheckFailedForOutgoingMessage|送信メッセージの ID の確認が失敗しました。予測される ID が対象エンドポイントに指定されています。|  
+|IncorrectSpnOrUpnSpecified|SSPI \(Security Support Provider Interface\) 認証が失敗しました。サーバーが、指定された ID を持つアカウントで実行されていない可能性があります。サーバーがサービス アカウント \(ネットワーク サービスなど\) で実行されている場合は、そのアカウントの ServicePrincipalName をサーバーの EndpointAddress で ID として指定してください。サーバーがユーザー アカウントで実行されている場合は、そのアカウントの UserPrincipalName をサーバーの EndpointAddress で ID として指定してください。|  
+|InvalidAttributeInSignedHeader|指定された署名済みヘッダーには指定された属性が含まれています。必要な属性が指定されています。|  
+|InvalidCloseResponseAction|指定された無効なアクションによってセキュリティ セッションの終了応答を受信しました。|  
+|InvalidQName|この QName は無効です。|  
+|InvalidRenewResponseAction|指定された無効なアクションによってセキュリティ セッションの更新応答を受信しました。|  
+|InvalidSspiNegotiation|セキュリティ サポート プロバイダー インターフェイス ネゴシエーションが失敗しました。|  
+|IssuerBindingNotPresentInTokenRequirement|セキュリティ トークン マネージャーでは、セキュリティで保護されたメッセージ交換を記述するトークン要件に、ブートストラップ セキュリティ バインド要素を指定する必要があります。このトークン要件は、次のように指定されています。|  
+|KeyLengthMustBeMultipleOfEight|対称キーについては、指定されたキーの長さが 8 の倍数ではありません。|  
+|LsaAuthorityNotContacted|内部 SSL エラーです \(詳細については Win32 状態コードを参照してください\)。サーバー証明書がキーの交換に対応しているかどうかを確認してください。|  
+|MaximumPolicyRedirectionsExceeded|再帰ポリシー フェッチ制限に達しました。フェデレーション サービス チェーン内にループがないか確認してください。|  
+|MessagePartSpecificationMustBeImmutable|メッセージ部分の指定は、設定する前に固定値にしておく必要があります。|  
+|MissingCustomCertificateValidator|X509CertificateValidationMode.Custom では、CustomCertificateValidator が必要です。CustomCertificateValidator プロパティを指定してください。|  
+|MissingCustomUserNamePasswordValidator|UserNamePasswordValidationMode.Custom では、CustomUserNamePasswordValidator が必要です。CustomUserNamePasswordValidator プロパティを指定してください。|  
+|MissingMembershipProvider|UserNamePasswordValidationMode.MembershipProvider では、MembershipProvider が必要です。MembershipProvider プロパティを指定してください。|  
+|NoBinaryNegoToSend|相手に送信したバイナリ ネゴシエーションはありません。|  
+|NoEncryptionPartsSpecified|指定されたアクションを含むメッセージに、暗号化メッセージ部分が指定されていませんでした。|  
+|NoKeyInfoInEncryptedItemToFindDecryptingToken|解読トークンの検出に必要な KeyInfo 値が暗号化項目で見つかりませんでした。|  
+|NonceLengthTooShort|指定された nonce が短すぎます。nonce の長さは少なくとも 4 バイト必要です。|  
+|NoOutgoingEndpointAddressAvailableForDoingIdentityCheck|送信メッセージに対する ID の確認を行うための送信 EndpointAddress がありません。|  
+|NoOutgoingEndpointAddressAvailableForDoingIdentityCheckOnReply|受信応答に対する ID の確認を行うための送信 EndpointAddress がありません。|  
+|NoPartsOfMessageMatchedPartsToSign|メッセージの中に、指定されたメッセージ部分仕様に合うものがなかったため、署名は作成されませんでした。|  
+|NoPrincipalSpecifiedInAuthorizationContext|承認コンテキストにカスタム プリンシパルが指定されていません。|  
+|NoSignatureAvailableInSecurityHeaderToDoReplayDetection|リプレイ検出に必要な nonce を提供するための署名がセキュリティ ヘッダーにありません。|  
+|NoSignaturePartsSpecified|指定されたアクションを含むメッセージに、署名メッセージ部分が指定されていませんでした。|  
+|NoSigningTokenAvailableToDoIncomingIdentityCheck|受信 ID の確認に必要な署名トークンがありません。|  
+|NoTimestampAvailableInSecurityHeaderToDoReplayDetection|リプレイ検出の実行に必要なタイムスタンプがセキュリティ ヘッダーにありません。|  
+|NoTransportTokenAssertionProvided|セキュリティ ポリシーのエクスポートが失敗しました。提供された、指定された型のトランスポート トークン アサーションは、sp:TransportBinding セキュリティ ポリシー アサーションを含むトランスポート トークン アサーションを作成していません。|  
+|OnlyOneOfEncryptedKeyOrSymmetricBindingCanBeSelected|共通鍵セキュリティ プロトコルには、共通鍵トークン プロバイダーと共通鍵トークン認証システム、または公開鍵トークン プロバイダーを構成できますが、両方を構成することはできません。|  
+|OperationCannotBeDoneOnReceiverSideSecurityHeaders|この操作は、受信側のセキュリティ ヘッダーに対しては実行できません。|  
+|OperationDoesNotAllowImpersonation|指定された名前と名前空間を持つコントラクトに属する指定されたサービス操作は、偽装を許可していません。|  
+|PolicyRequiresConfidentialityWithoutIntegrity|指定されたアクションのメッセージ セキュリティ ポリシーには、整合性が確保されない機密性が必要です。整合性を確保しない機密性はサポートされていません。|  
+|PrimarySignatureIsRequiredToBeEncrypted|プライマリ署名は暗号化されている必要があります。|  
+|PropertySettingErrorOnProtocolFactory|指定されたセキュリティ プロトコル ファクトリの必須のプロパティが設定されていないか、このプロパティに無効な値が含まれています。|  
+|ProtocolFactoryCouldNotCreateProtocol|このプロトコル ファクトリでプロトコルを作成できません。|  
+|PublicKeyNotRSA|公開キーは RSA キーではありません。|  
+|RequiredMessagePartNotEncrypted|指定された必須のメッセージ部分が暗号化されていませんでした。|  
+|RequiredMessagePartNotEncryptedNs|指定された必須のメッセージ部分が暗号化されていませんでした。|  
+|RequiredMessagePartNotSigned|指定された必須のメッセージ部分が署名されていませんでした。|  
+|RequiredMessagePartNotSignedNs|指定された必須のメッセージ部分が署名されていませんでした。|  
+|RequiredSecurityHeaderElementNotSigned|指定された ID を持つ指定されたセキュリティ ヘッダー要素は署名されている必要があります。|  
+|RequiredSecurityTokenNotEncrypted|指定された添付モードの指定されたセキュリティ トークンは暗号化されている必要があります。|  
+|RequiredSecurityTokenNotSigned|指定された添付モードの指定されたセキュリティ トークンは署名されている必要があります。|  
+|RequiredSignatureMissing|署名はセキュリティ ヘッダーに含まれている必要があります。|  
+|RequireNonCookieMode|指定された名前空間を持つ指定されたバインディングは、クッキー セキュリティ コンテキスト トークンを発行するように構成されていますが、COM\+ Integration サービスはクッキー セキュリティ コンテキスト トークンをサポートしていません。|  
+|RevertingPrivilegeFailed|指定された例外が発生したため、元に戻す処理に失敗しました。|  
+|RSTRAuthenticatorIncorrect|RequestSecurityTokenResponse の CombinedHash が正しくありません。|  
+|SecureConversationCancelNotAllowedFaultReason|セキュリティで保護されたメッセージ交換の取り消しは、バインディングによって許可されていません。|  
+|SecureConversationDriverVersionDoesNotSupportSession|構成された SecureConversation バージョンはセッションをサポートしていません。WSSecureConversationFeb2005 以上を使用してください。|  
+|SecureConversationRequiredByReliableSession|セキュリティで保護された通信を使用せずに、信頼できるセッションを確立することはできません。セキュリティで保護されたメッセージ交換を有効にしてください。|  
+|SecurityAuditFailToLoadDll|指定されたダイナミック リンク ライブラリ \(dll\) を読み込むことができませんでした。|  
+|SecurityAuditNotSupportedOnChannelFactory|SecurityAuditBehavior は、チャネル ファクトリではサポートされていません。|  
+|SecurityAuditPlatformNotSupported|現在のプラットフォームでは、セキュリティ ログへの監査メッセージの書き込みはサポートされていません。監査メッセージはアプリケーション ログに書き込む必要があります。|  
+|SecurityBindingElementCannotBeExpressedInConfig|エンドポイントのセキュリティ ポリシーがインポートされました。このセキュリティ ポリシーには、Windows Communication Foundation の構成では表現できない要件が含まれています。生成された構成ファイルで、必須の SecurityBindingElement パラメーターに関するコメントを参照してください。コードを使用して正しいバインド要素を作成してください。構成ファイル内のバインディング構成はセキュリティで保護されていません。|  
+|SecurityBindingSupportsOneWayOnly|指定されたコントラクトに対する指定されたバインディングの SecurityBinding は、OneWay 操作のみをサポートしています。|  
+|SecurityContextDoesNotAllowImpersonation|指定されたアクションを含む要求メッセージの UltimateReceiver ロールの SecurityContext が Windows ID に割り当てられていないため、偽装を開始できません。|  
+|SecurityListenerClosing|リスナーは、閉じている途中のため、セキュリティで保護された新しいメッセージ交換を受け入れていません。|  
+|SecurityListenerClosingFaultReason|サーバーは、閉じている途中のため、現在はセキュリティで保護された新しいメッセージ交換を受け入れていません。後で再試行してください。|  
+|SecurityProtocolFactoryShouldBeSetBeforeThisOperation|この操作が実行される前に、セキュリティ プロトコル ファクトリが設定されている必要があります。|  
+|SecuritySessionAbortedFaultReason|セキュリティ セッションが中止されました。これは、セッションでメッセージが長時間受信されなかったことが原因である可能性があります。|  
+|SecuritySessionKeyIsStale|セッション キーを使用してアプリケーション メッセージをセキュリティで保護するには、セッション キーを更新する必要があります。|  
+|SecuritySessionLimitReached|セキュリティ セッションを作成できません。後でやり直してください。|  
+|SecuritySessionNotPending|指定された ID を持つ保留中のセキュリティ セッションはありません。|  
+|SecurityTokenParametersHasIncompatibleInclusionMode|指定されたバインディングは、互換性のないセキュリティ トークンの指定されたインクルード モードが設定されたセキュリティ トークン パラメーターを使用して構成されています。別のセキュリティ トークンのインクルード モードを指定してください。|  
+|SecurityVersionDoesNotSupportEncryptedKeyBinding|指定されたコントラクトの指定されたバインディングは、EncryptedKeys への添付されない参照をサポートしていない、互換性のないセキュリティ バージョンで構成されています。バインディングのセキュリティ バージョンとして、指定された値以降の値を使用してください。|  
+|SecurityVersionDoesNotSupportSignatureConfirmation|指定された SecurityVersion は署名確認をサポートしていません。これより後の SecurityVersion を使用してください。|  
+|SecurityVersionDoesNotSupportThumbprintX509KeyIdentifierClause|指定されたコントラクトの指定されたバインディングは、証明書の拇印値を使用した X.509 トークンへの外部参照をサポートしていないセキュリティ バージョンで構成されています。バインディングのセキュリティ バージョンとして、指定された値以降を使用してください。|  
+|SenderSideSupportingTokensMustSpecifySecurityTokenParameters|セキュリティ トークン パラメーターは、各メッセージのサポート トークンを使用して指定する必要があります。|  
+|ServerCertificateNotProvided|受信側が証明書を提供しませんでした。この証明書は TLS プロトコルによって要求されています。送信側と受信側の両方とも、各自の証明書にアクセスする必要があります。|  
+|SignatureConfirmationNotSupported|構成されている SecurityVersion は署名確認をサポートしていません。WSSecurityXXX2005 以上を使用してください。|  
+|SignatureConfirmationRequiresRequestReply|署名確認を行えるようにするには、プロトコル ファクトリで Request\/Reply セキュリティをサポートする必要があります。|  
+|SignatureNotExpected|このメッセージに署名は必要ありません。|  
+|SigningTokenHasNoKeys|指定された署名トークンにはキーがありません。このセキュリティ トークンは、暗号化操作を実行するためにセキュリティ トークンを必要とするコンテキストで使用されます。ただし、このトークンには暗号化キーが含まれていません。このトークンの型が暗号化操作をサポートしていないか、特定のトークン インスタンスに暗号化キーが含まれていません。構成を確認し、暗号化を無効とするトークンの型 \(UserNameSecurityToken など\) が、暗号化操作を必要とするコンテキスト \(保証サポート トークンなど\) で指定されていないことを確認してください。|  
+|SpnegoImpersonationLevelCannotBeSetToNone|SSPI は、'None' という偽装レベルをサポートしていません。Identification、Impersonation または Delegation のいずれかのレベルを指定してください。|  
+|SslClientCertMustHavePrivateKey|指定された証明書には秘密キーが必要です。プロセスには秘密キーへのアクセス権が必要です。|  
+|SslServerCertMustDoKeyExchange|指定された証明書には、キー交換に対応した秘密キーが必要です。プロセスには秘密キーへのアクセス権が必要です。|  
+|StandardsManagerCannotWriteObject|このトークン シリアライザーは、指定されたオブジェクトをシリアル化できません。これがカスタム型である場合は、カスタム シリアライザーを提供する必要があります。|  
+|TimeStampHasCreationAheadOfExpiry|このセキュリティ タイムスタンプは、作成時刻が有効期限以降であるため、無効です。|  
+|TimeStampHasCreationTimeInFuture|このセキュリティ タイムスタンプは、作成時刻が未来の日付であるため、無効です。現在の時刻と許可される時刻のずれが指定されています。|  
+|TimeStampHasExpiryTimeInPast|このセキュリティ タイムスタンプは、有効期限が過去の日付であるため、古くなっています。現在の時刻と許可される時刻のずれが指定されています。|  
+|TimeStampWasCreatedTooLongAgo|このセキュリティ タイムスタンプは、作成時刻がかなり以前であるため、古くなっています。現在の時刻、タイムスタンプの最大有効期限、および許可される時刻のずれが指定されています。|  
+|TokenProviderCannotGetTokensForTarget|トークン プロバイダーは指定された対象のトークンを取得できません。|  
+|TooManyIssuedSecurityTokenParameters|統合されたセキュリティ チェーンの各要素には複数の IssuedSecurityTokenParameters があります。InfoCard システムは、要素ごとに 1 つの IssuedSecurityTokenParameters しかサポートしていません。|  
+|TransportDoesNotProtectMessage|指定されたコントラクトの指定されたバインディングは、トランスポート レベルの整合性と機密性を必要とする認証モードで構成されています。ただし、トランスポートによって整合性と機密性を実現することはできません。|  
+|TrustApr2004DoesNotSupportCertainIssuedTokens|WSTrustApr2004 では、X.509 証明書や EncryptedKeys の発行がサポートされません。WsTrustFeb2005 以上を使用してください。|  
+|TrustDriverVersionDoesNotSupportSession|構成されたバージョンの Trust では、セッションがサポートされません。WSTrustFeb2005 またはそれ以降を使用してください。|  
+|UnableToCreateICryptoFromTokenForSignatureVerification|署名確認用の指定されたトークンから ICrypto インターフェイスを作成できません。|  
+|UnableToCreateSymmetricAlgorithmFromToken|トークンから指定された対称アルゴリズムを作成できません。|  
+|UnableToDeriveKeyFromKeyInfoClause|指定された KeyInfo 句は指定されたトークンに解決されましたが、このトークンには派生に使用できる対称キーが含まれていません。|  
+|UnableToFindTokenAuthenticator|指定されたトークンの型に対応するトークン認証システムが見つかりません。現在のセキュリティ設定により、この型のトークンは承認できません。|  
+|UnableToLoadCertificateIdentity|構成で指定された X.509 証明書の ID を読み込めません。|  
+|UnexpectedEmptyElementExpectingClaim|指定された名前空間の指定された要素が空であり、有効な ID クレームが指定されていません。|  
+|UnknownEncodingInBinarySecurityToken|バイナリ セキュリティ トークンの読み取り中に不明なエンコードが検出されました。|  
+|UnsecuredMessageFaultReceived|セキュリティで保護されていないか正しくセキュリティで保護されていないフォールトを相手側から受信しました。フォールト コードおよび詳細については、内部の FaultException を参照してください。|  
+|UnsupportedPasswordType|指定されたユーザー名トークンには、サポートされていないパスワードの種類が含まれています。|  
+|UnsupportedSecureConversationBootstrapProtectionRequirements|セキュリティ ポリシーをインポートできません。セキュリティで保護されたメッセージ交換のブートストラップ バインディングの保護要件はサポートされていません。セキュリティで保護されたメッセージ交換のブートストラップの保護要件は、要求および応答ともに署名され暗号化されている必要があります。|  
+|UnsupportedSecurityPolicyAssertion|指定されたセキュリティ ポリシーのインポート中に、サポートされていないセキュリティ ポリシー アサーションが検出されました。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-data.md b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-data.md
new file mode 100644
index 00000000000..8458d42fca9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-data.md
@@ -0,0 +1,51 @@
+---
+title: "サービス フレームワーク データ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2a2c8ddc-4e82-4e7f-a79f-97085c469517
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# サービス フレームワーク データ
+ここでは、サービス フレームワーク データによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|AddressingExtensionInBadNS|指定した名前空間の指定した要素が無効です。これは、指定した要素が重複する要素であること、または、拡張要素はアドレス名前空間内に存在できないため、この要素が有効な拡張ではないことを意味します。|  
+|BinaryEncoderSessionInvalid|前のメッセージのデコード中にエラーが発生したために、バイナリ エンコーダーのセッションが無効です。|  
+|CannotDetectAddressingVersion|WS\-Addressing のバージョンを検出できません。EndpointAddress が要素で開始していません。|  
+|CouldNotFindNamespaceForPrefix|指定したプレフィックスは、スコープ内に名前空間バインディングがありません。|  
+|EncoderBadContentType|contentType を処理できません。|  
+|EncoderEnvelopeVersionMismatch|指定した受信メッセージのエンベロープのバージョンが、指定したエンコーダーのバージョンと一致しません。バインドに構成されているバージョンが、予期されるメッセージと同じであることを確認してください。|  
+|EncoderMessageVersionMismatch|指定した送信メッセージのメッセージ バージョンが、指定したエンコーダーのバージョンと一致しません。バインドに構成されているバージョンが、メッセージと同じであることを確認してください。|  
+|ExtraContentIsPresentInFaultDetail|fault detail 要素に追加の XML \(Extensible Markup Language\) コンテンツがあります。1 つの要素のみが許可されています。|  
+|FilterBadTableType|フィルター用に作成された IMessageFilterTable を、MessageFilterTable または MessageFilterTable のサブクラスにすることはできません。|  
+|FilterTableInvalidForLookup|MessageFilterTable の状態が破損しています。要求された検索を実行できません。|  
+|MandatoryHeaderNotUnderstood|要求された 1 つ以上の SOAP \(Simple Object Access Protocol\) ヘッダー ブロックが認識されませんでした。|  
+|MessageBodyIsStream|メッセージ本文がストリームです。|  
+|MessageBodyIsUnknown|メッセージ本文の形式が不明です。|  
+|MessageBodyReaderInvalidReadState|メッセージ本文のリーダーの指定した ReadState を利用できません。|  
+|MessageTextEncodingNotSupported|テキスト メッセージ形式に使用されている、指定したテキスト エンコードはサポートされていません。|  
+|MissingMessageID|要求メッセージに MessageID ヘッダーがありません。このヘッダーは応答を相関付けるために必要です。|  
+|MultipleMessageHeaders|指定した名前と名前空間を持つヘッダーが複数あります。|  
+|MultipleMessageHeadersWithActor|指定した名前、名前空間、およびロールを持つヘッダーが複数あります。|  
+|MultipleRelatesToHeaders|指定したリレーションシップを持つ RelatesTo ヘッダーが複数あります。このヘッダーは、1 つのリレーションシップにつき 1 つしか許可されていません。|  
+|QueryFunctionTypeNotSupported|IXsltContextFunction の指定した戻り値の型はサポートされていません。|  
+|QueryIteratorOutOfScope|XPathNodeIterator は無効にされました。IXsltContextFunctions の引数として渡された XPathNodeIterators は、関数内でのみ有効です。これらは、後で使用するためにキャッシュされることも、関数の結果として返されることもありません。|  
+|QueryVariableNull|IXsltContextVariable メソッドは、Null を返すことができません。|  
+|QueryVariableTypeNotSupported|指定した IXsltContextVariable の派生型はサポートされていません。|  
+|ReceiveShutdownReturnedMessage|チャネルを閉じているときに、指定したアクションを持つ予期しない入力メッセージを受信しました。チャネルは、追加の入力メッセージを受信する可能性がない場合にのみ閉じる必要があります。|  
+|XmlBufferInInvalidState|内部エラーが発生しました。XML バッファーの状態が原因で、操作を実行できません。|  
+|XmlBufferQuotaExceeded|XML \(Extensible Markup Language\) コンテンツのバッファリングに必要なサイズがバッファー クォータを超過しました。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-metadata.md b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-metadata.md
new file mode 100644
index 00000000000..d55e46c5467
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework-metadata.md
@@ -0,0 +1,41 @@
+---
+title: "サービス フレームワークのメタデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76afc73a-0770-4084-93f3-6701a757911e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービス フレームワークのメタデータ
+ここでは、サービス フレームワーク メタデータによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|AsyncEndCalledOnWrongChannel|非同期 End が間違ったチャネルで呼び出されました。|  
+|AsyncEndCalledWithAnIAsyncResult|非同期 End が別の Begin メソッドから IAsyncResult を指定して呼び出されました。|  
+|AttemptedToGetContractTypeForButThatTypeIs1|指定された対象のコントラクトの型の取得を試みましたが、この型は ServiceContract ではありません。また、ServiceContract を継承しているわけでもありません。|  
+|CannotHaveTwoOperationsWithTheSameName3|同じ名前の 2 つの操作を同一のコントラクトに含めることはできません。指定された型の指定されたメソッドは、このルールに違反しています。いずれかの操作の名前を変更するには、メソッド名を変更するか、OperationContractAttribute の Name プロパティを使用します。|  
+|CannotInheritTwoOperationsWithTheSameName3|同じ名前を持つ 2 つの異なる操作を継承することはできません。指定されたコントラクトの指定された操作は、このルールに違反しています。いずれかの操作の名前を変更するには、メソッド名を変更するか、OperationContractAttribute の Name プロパティを使用します。|  
+|CantCreateChannelWithManualAddressing|要求\/応答が必要なコントラクト、および双方向の通信のみをサポートする手動によるアドレス指定が必要なバインドのチャネルを作成することができません。|  
+|DuplicateBehavior1|値をコレクションに追加できません。コレクションには、指定された同じ型の項目が既に含まれています。このコレクションは、各型のインスタンスを 1 つだけサポートします。|  
+|InAContractInheritanceHierarchyIfParentHasCallbackChildMustToo|指定された基本サービス コントラクトは指定されたコールバック コントラクトを持つため、指定された派生サービス コントラクトも、指定された型または派生型をコールバック コントラクトとして指定する必要があります。|  
+|InvalidAsyncBeginMethodSignatureForMethod2|指定された ServiceContract 型の指定されたメソッドの非同期 Begin メソッドの署名が無効です。Begin メソッドは、AsyncCallback およびオブジェクトを最後の 2 つの引数として受け取って、IAsyncResult を返す必要があります。|  
+|InvalidAsyncEndMethodSignatureForMethod2|指定された ServiceContract 型の指定されたメソッドの非同期 End メソッドの署名が無効です。End メソッドは、IAsyncResult を最後の引数として受け取る必要があります。|  
+|MessagePropertiesArraySize0|渡された配列には、このコレクションに含まれるすべてのプロパティを保持するだけの容量がありません。|  
+|OneWayAndFaultsIncompatible2|指定された型の指定されたメソッドでは、IsOneWay\=true が設定されており、1 つ以上の FaultContractAttributes が宣言されています。一方向のメソッドでは FaultContractAttributes を宣言できません。IsOneWay を false に変更するか、FaultContractAttribute を削除してください。|  
+|UnsupportedWSDLOnlyOneMessage|サポートされていない Web サービス記述言語。エラー メッセージには、1 つのメッセージ部のみがサポートされています。このエラー メッセージは、複数のメッセージ部を参照しています。WSDL ファイルへの編集アクセス権がある場合は、余分なメッセージ部を削除してエラー メッセージが 1 つのメッセージ部のみを参照するようにすることで問題を修正できます。|  
+|UnsupportedWSDLTheFault|サポートされていない Web サービス記述言語。エラー メッセージ部は 1 つの要素だけを参照する必要があります。このエラー メッセージは要素を参照していません。この WSDL ドキュメントへの編集アクセス権がある場合は、'element' 属性を使用してスキーマ要素を参照することでこの問題を修正できます。|  
+|WsdlImportErrorDependencyDetail|指定された他の値が依存する指定された対象のインポート中にエラーが発生しました。Xpath も指定されています。|  
+|XsdMissingRequiredAttribute1|指定された必須の属性がありません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/service-framework.md b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework.md
new file mode 100644
index 00000000000..58c3ab35ab6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/service-framework.md
@@ -0,0 +1,171 @@
+---
+title: "サービス フレームワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75f60b87-f80e-4377-ba7c-8e6becaa2b28
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# サービス フレームワーク
+ここでは、サービス フレームワーク データによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|ABindingInstanceHasAlreadyBeenAssociatedTo1|バインディング インスタンスは、指定されたリッスン URI に既に関連付けられています。2 つのエンドポイントが同じ ListenUniform Resource Indicator を共有する場合、同じバインディング中のオブジェクト インスタンスを共有する必要があります。2 つの競合するエンドポイントが AddServiceEndpoint\(\) 呼び出しで指定されているか、AddServiceEndpoint\(\) および構成ファイルの両方に指定されています。|  
+|AChannelServiceEndpointIsNull0|チャネルまたはサービスのエンドポイントが NULL です。|  
+|AChannelServiceEndpointSContractSNameIsNull0|チャネルまたはサービスのエンドポイントのコントラクト名が NULL または空です。|  
+|AChannelServiceEndpointSContractSNamespace0|チャネルまたはサービスのエンドポイントの名前空間が NULL です。|  
+|BaseAddressCannotHaveFragment|ベース アドレスに URI フラグメントを含めることはできません。|  
+|BaseAddressCannotHaveQuery|ベース アドレスに URI クエリ文字列を含めることはできません。|  
+|BaseAddressCannotHaveUserInfo|ベース アドレスに URI ユーザー情報セクションを含めることはできません。|  
+|BaseAddressDuplicateScheme|このコレクションには、指定されたスキームを使用するアドレスが既に含まれています。このコレクションでは、スキームごとに 1 つのアドレスしか許可されていません。|  
+|BaseAddressMustBeAbsolute|ベース アドレスとして使用できる絶対 URI は 1 つのみです。|  
+|BindingDoesnTSupportAnyChannelTypes1|指定されたバインディングは、どのチャネルの種類の作成もサポートしていません。カスタム バインディング内のバインド要素が適切にスタックされていないか、スタックの順序が間違っています。スタックの一番下にはトランスポートが必要です。推奨されるバインド要素の順序は、TransactionFlow、ReliableSession、Security、CompositeDuplex、OneWay、StreamSecurity、MessageEncoding、Transport です。|  
+|BindingDoesnTSupportDuplexButContractRequires1|コントラクトには Duplex が必要です。指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|BindingDoesnTSupportOneWayButContractRequires1|コントラクトには OneWay が必要です。指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|BindingDoesnTSupportRequestReplyButContract1|コントラクトには Request\/Reply が必要です。指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|BindingDoesnTSupportSessionButContractRequires1|コントラクトには Session が必要です。指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|BindingDoesnTSupportTwoWayButContractRequires1|コントラクトは、TwoWay \(要求\-応答、または双方向\) を必要とします。指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|BindingRequirementsAttributeDisallowsQueuedDelivery1|DeliveryRequirementsAttribute は QueuedDelivery を許可していません。指定されたコントラクトを持つエンドポイントのバインディングはこれをサポートしています。|  
+|BindingRequirementsAttributeRequiresQueuedDelivery1|DeliveryRequirementsAttribute には QueuedDelivery が必要です。指定されたコントラクトを持つエンドポイントのバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|channelDoesNotHaveADuplexSession0|現在のチャネルは、出力セッションの終了をサポートしていません。このチャネルは、ISessionChannel\<IDuplexSession\> を実装していません。|  
+|ClientRuntimeRequiresFormatter0|SerializeRequest と DeserializeReply の両方が false ではないため、指定された ClientOperation にはフォーマッタが必要です。|  
+|CommunicationObjectAborted1|指定された通信オブジェクトは停止しているため、通信に使用できません。|  
+|CommunicationObjectAbortedStack2|指定された通信オブジェクトは停止しているため、通信に使用できません: {1}|  
+|CommunicationObjectBaseClassMethodNotCalled|指定された通信オブジェクトは、仮想関数 {1} をオーバーライドしましたが、基本クラスで定義されたバージョンを呼び出しません。|  
+|ContractIsNotSelfConsistentItHasOneOrMore2|指定されたコントラクトには、IsTerminating 操作または IsInitiating 以外の操作が 1 つ以上あります。SessionMode.Required に設定された SessionMode プロパティがありません。IsInitiating 属性と IsTerminating 属性は、セッションのコンテキストでのみ使用できます。|  
+|CouldnTCreateChannelForChannelType2|指定されたチャネルの種類が要求されましたが、指定されたバインディングはこれをサポートしていないか、サポートするように正しく構成されていません。|  
+|DispatchRuntimeRequiresFormatter0|DeserializeRequest と SerializeReply の両方が false ではないため、指定された DispatchOperation にはフォーマッタが必要です。|  
+|EndMethodsCannotBeDecoratedWithOperationContractAttribute|IAsyncResult デザイン パターンを使用する場合、OperationContractAttribute と共に End メソッドを使用することはできません。OperationContractAttribute と共に使用できるのは、対応する Begin メソッドのみです。この属性は、メソッドの Begin と End のペアに適用されます。|  
+|EndpointListenerRequirementsCannotBeMetBy3|指定されたバインディングの IChannelListener が ChannelDispatcher の要件を満たすことができません。コントラクトには、指定されたこれらのチャネルの種類のいずれか 1 つのサポートが必要ですが、バインディングがサポートしているのは、指定されたこれらのチャネルの種類のみです。|  
+|EndpointsMustHaveAValidBinding0|エンドポイントには有効なバインディングが必要です。|  
+|InvalidOrUnrecognizedAction|指定されたアクションが無効であるか、または認識できないため、メッセージを処理できません。|  
+|MultipleMebesInParameters|BindingContext の BindingParameter に複数の MessageEncodingBindingElement が見つかりました。CustomBinding に複数の MessageEncodingBindingElement を含めることはできません。これらの要素の 1 つ以外はすべて削除します。|  
+|MultipleStreamUpgradeProvidersInParameters|BindingContext の BindingParameter に複数の IStreamUpgradeProviderElement が見つかりました。CustomBinding に複数の IStreamUpgradeProviderElement を含めることはできません。これらの要素の 1 つ以外はすべて削除します。|  
+|NoChannelBuilderAvailable|バインディングに TransportBindingElement が含まれていないため、このバインディングを使用してチャネル ファクトリやチャネル リスナーを作成することはできません。いずれのバインディングにも TransportBindingElement から派生するバインド要素を少なくとも 1 つ含んでいる必要があります。|  
+|NotAllBindingElementsBuilt|このバインディング内の一部のバインド要素は、チャネル ファクトリ\/チャネル リスナーの構築時に使用されませんでした。バインド要素の順序が正しくありません。推奨されるバインド要素の順序は、TransactionFlow、ReliableSession、Security、CompositeDuplex、OneWay、StreamSecurity、MessageEncoding、Transport です。TransportBindingElement は最後である必要があります。指定されたバインド要素は構築されませんでした。|  
+|RuntimeRequiresInvoker0|ディスパッチ操作は呼び出しの起動者が必要です。|  
+|ServiceHasZeroAppEndpoints|指定されたサービスには、アプリケーション \(インフラストラクチャ以外\) エンドポイントがありません。これは、アプリケーション用の構成ファイルが見つからなかったこと、サービス名と一致するサービス要素が構成ファイル内から見つからなかったこと、またはサービス要素内でエンドポイントが定義されていないことが原因である可能性があります。|  
+|SFxActionMismatch|動作が一致しないため、入力されたメッセージを作成できません。指定されたアクションを予期していましたが、別のアクションが発生しました|  
+|SFxAnonymousTypeNotSupported|指定されたメッセージの指定された部分は種類が不明であるため、RPC でのエクスポートやエンコードを実行できません。|  
+|SFxBadMetadataLocationNoAppropriateBaseAddress|構成ファイルの serviceMetadata セクションにある ExternalMetadataLocation プロパティまたは externalMetadataLocation 属性を介して ServiceMetadataBehavior に渡された URL は、相対 URL であったため、この URL を解決するためのベース アドレスがありません。|  
+|SFxBadMetadataMustBePolicy|ポリシーでは、指定された名前空間と名前を持つ XmlElement を指定する必要があります。この XmlElement は、指定された名前空間と名前を持ちます。|  
+|SFxBodyObjectTypeCannotBeInherited|RPC スタイルの body オブジェクトとして使用されるオブジェクト以外のクラスから、指定された型を継承することはできません。|  
+|SFxBodyObjectTypeCannotBeInterface|指定された型が実装している指定されたインターフェイスは、RPC スタイルの body オブジェクトでサポートされていません。|  
+|SFxCallbackBehaviorAttributeOnlyOnDuplex|CallbackBehaviorAttribute は、双方向コントラクトを使用したエンドポイント上の操作としてのみ実行できます。指定されたコントラクトは、コールバック操作を含んでいないため、双方向ではありません。|  
+|SFxCallbackRequestReplyInOrder1|現在のメッセージが処理を完了するまで、この操作から応答を受信することはできません。順番を無視したメッセージ処理を許可するには、指定された対象で Reentrant または Multiple の ConcurrencyMode を指定してください。|  
+|SfxCallbackTypeCannotBeNull|指定されたコントラクトを DuplexChannelFactory と共に使用するには、このコントラクトで有効なコールバック コントラクトを指定する必要があります。使用しているコントラクトにコールバック コントラクトがある場合は、DuplexChannelFactory の代わりに ChannelFactory を使用してください。|  
+|SFxCannotGetMetadataFromLocation|MetadataExchangeClient は HTTP および HTTPS の MetadataLocations からのみメタデータを取得できます。指定された対象からメタデータを取得できません。|  
+|SFxCannotHttpGetMetadataFromAddress|MetadataExchangeClient は、MetadataExchangeClientMode HttpGet を使用した場合に HTTP アドレスまたは HTTPS アドレスからのみメタデータを取得できます。指定された対象からメタデータを取得できません。|  
+|SFxCannotImportAsParameters\_Bare|指定された操作は RPC でもラップされたドキュメントでもないため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_DifferentWrapperName|指定されたメッセージのラッパーの名前が既定値と一致しないため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_DifferentWrapperNs|指定されたメッセージのラッパーの名前空間が既定値と一致しないため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_ElementIsNotNillable|指定された名前空間の指定された要素名が nillable に設定されていないため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_HeadersAreUnsupported|指定されたメッセージにヘッダーが含まれるため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_Message|指定された操作には、引数または戻り値の型として型指定されていない Message が含まれるため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_MessageHasProtectionLevel|指定されたメッセージには保護が必要なため、メッセージ コントラクトを生成しています。|  
+|SFxCannotImportAsParameters\_NamespaceMismatch|指定されたメッセージ部分の名前空間が既定値と一致しないため、メッセージ コントラクトを生成しています。|  
+|SFxCannotRequireBothSessionAndDatagram3|指定されたコントラクトは SessionMode.NotAllowed を指定し、かつ SessionMode.Required を指定しています。どちらかの SessionMode の値を変更するか、エンドポイントごとに異なるアドレス \(または ListenURI\) を指定してください。|  
+|SFxCannotSetExtensionsByIndex|このコレクションは、インデックスによる拡張の設定をサポートしていません。InsertItem または RemoveItem メソッドを使用してください。|  
+|SFxChannelDispatcherDifferentHost0|この ChannelDispatcher は、指定された ServiceHost に現在アタッチされていません。|  
+|SFxChannelDispatcherMultipleHost0|複数の ServiceHost に ChannelDispatcher を追加することはできません。|  
+|SFxChannelDispatcherNoHost0|ChannelDispatcher は、ServiceHost にアタッチされていないため、開くことができません。|  
+|SfxChannelFactoryDisposed|この ChannelFactory は既に破棄されているため開けません。この ChannelFactory を使用する前に再作成してください。|  
+|SFxChannelFactoryNoBinding|ChannelFactory のエンドポイントにバインディングが関連付けられていないため、ChannelFactory を開くことができません。コンストラクターまたはエンドポイント プロパティでバインディングを指定してください。|  
+|SFxChannelTerminated0|IsTerminating が設定された操作はこのチャネルで既に呼び出されており、その結果このチャネルの接続は終了しました。このチャネルでは追加の操作を呼び出すことはできません。通信を続行するには、このチャネルを再作成してください。|  
+|SFxCloseTimedOut1|ServiceHost の閉じる操作が、指定された時間後に中止されました。クライアントがセッションフル チャネルを要求された時間内に閉じることができなかったことが原因である可能性があります。この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。|  
+|SfxCloseTimedOutWaitingForDispatchToComplete|サービスのディスパッチが完了するのを待機しているときに Close プロセスがタイムアウトしました。|  
+|SFxCodeGenIsNotAssignableFrom|指定された対象を割り当てることはできません。|  
+|SFxConfigChannelConfigurationNotFound|ServiceModel クライアント構成セクションで、指定された名前とコントラクトを持つエンドポイント要素が見つかりません。|  
+|SFxConflictingGlobalElement|指定された名前空間に含まれる指定された名前を持つトップ レベルの XML 要素が、指定された型を参照できません。この要素は別の型を既に参照しています。異なる操作名を使用するか、MessageBodyAttribute を使用して、メッセージまたはメッセージ部分に別の名前を指定してください。|  
+|SFxContractHasZeroInitiatingOperations|コントラクトには、少なくとも 1 つの IsInitiating\=true 操作が必要です。|  
+|SFxContractHasZeroOperations|コントラクトには、少なくとも 1 つの操作が必要です。|  
+|SFxContractInheritanceRequiresInterfaces|指定された型のサービス クラスでは、ServiceContract が定義されていると共に、指定された型から ServiceContract を継承しています。コントラクトの継承はインターフェイス型の中でのみ使用できます。クラスに ServiceContractAttribute が設定されている場合、そのクラスは、ServiceContractAttribute が設定された階層内の唯一の型である必要があります。指定された型の ServiceContractAttribute を、指定された型で実装されている別のインターフェイスに移動してください。|  
+|SFxCreateDuplexChannel1|指定されたコントラクトのコールバック コントラクトは存在していないか、またはどの操作も定義していません。これが双方向コントラクトでない場合は、DuplexChannelFactory の代わりに ChannelFactory を使用してください。|  
+|SFxCreateDuplexChannelNoCallback|この CreateChannel オーバーロードは DuplexChannelFactory のこのインスタンスでは呼び出せません。DuplexChannelFactory が InstanceContext を使用して初期化されませんでした。InstanceContext を受け取る CreateChannel オーバーロードを呼び出します。|  
+|SFxCreateDuplexChannelNoCallback1|この CreateChannel オーバーロードは DuplexChannelFactory のこのインスタンスでは呼び出せません。Type を使用して DuplexChannelFactory が初期化されて、有効な InstanceContext が指定されませんでした。InstanceContext を受け取る CreateChannel オーバーロードを呼び出します。|  
+|SFxCreateDuplexChannelNoCallbackUserObject|この CreateChannel オーバーロードは DuplexChannelFactory のこのインスタンスでは呼び出せません。DuplexChannelFactory に渡された InstanceContext に有効な UserObject が含まれていません。|  
+|SFxCreateNonDuplexChannel1|ChannelFactory は指定されたコントラクトをサポートしていません。ChannelFactory は 1 つ以上の操作が含まれたコールバック コントラクトを定義しています。ChannelFactory の代わりに DuplexChannelFactory を使用してください。|  
+|SFxCustomBindingNeedsTransport1|指定されたコントラクトを持つ ServiceEndpoint の CustomBinding には、TransportBindingElement がありません。いずれのバインディングにも TransportBindingElement から派生するバインド要素を少なくとも 1 つ含んでいる必要があります。|  
+|SFxCustomBindingWithoutTransport|このカスタム バインディングには TransportBindingElement がないため、このバインディング用のスキームを計算できません。いずれのバインディングにも TransportBindingElement から派生するバインド要素を少なくとも 1 つ含んでいる必要があります。|  
+|SFxDataContractSerializerDoesNotSupportBareArray|DataContractSerializer は、指定された要素で指定されたコレクションをサポートしていません。|  
+|SFxDictionaryIsEmpty|辞書が空なので、この操作を行えません。|  
+|SFxDocEncodedNotSupported|指定された対象の反映中にエラーが発生しました。エンコードされたドキュメントはサポートされていません。'Use' をリテラルに変更するか、'Style' を RPC に変更してください。|  
+|SFxDuplicateInitiatingActionAtSameVia|このサービスには、指定された対象でリッスンしているエンドポイントが複数あります。これらのエンドポイントでは、指定された開始アクションが同じです。ディスパッチャーがメッセージ処理用の正しいエンドポイントを判断できなくなるため、このアクションが指定されたメッセージは削除されます。|  
+|SFXEndpointBehaviorUsedOnWrongSide|指定された IEndpointBehavior をサーバーで使用することはできません。この動作はクライアントにのみ適用できます。|  
+|SFxEndpointNoMatchingScheme|指定されたバインディングを使用するエンドポイントの、指定されたスキームに適合するベース アドレスが見つかりません。登録されているベース アドレス スキームが指定されています。|  
+|SFxErrorCreatingMtomReader|MTOM メッセージ用のリーダーを作成しているときにエラーが発生しました。|  
+|SFxErrorDeserializingFault|サーバーから無効な SOAP フォールトが返されました。詳細については、InnerException を参照してください。|  
+|SFxErrorDeserializingHeader|指定されたメッセージに含まれるヘッダーの 1 つの逆シリアル化中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxErrorReflectingOnMethod3|指定された型で、指定されたメソッドの指定された属性の読み込み中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxErrorReflectingOnParameter4|指定された型の指定されたメソッドの指定されたパラメーターの指定された属性を読み込み中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxErrorReflectingOnType2|指定された型の指定された属性を読み込み中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxErrorSerializingBody|指定されたメッセージの本文のシリアル化中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxErrorSerializingHeader|指定されたメッセージに含まれるヘッダーの 1 つのシリアル化中にエラーが発生しました。詳細については、InnerException を参照してください。|  
+|SFxExpectedIMethodCallMessage|内部エラーです。メッセージは有効な IMethodCallMessage である必要があります。|  
+|SFxExportMustHaveType|指定された操作の指定された部分には有効な CLR 型が含まれていないため、エクスポートできません。|  
+|SFxHeaderNotUnderstood|メッセージは処理されませんでした。指定された名前空間の指定されたヘッダーをこのメッセージの受信側で認識できませんでした。このエラーは一般に、受信側で処理できない通信プロトコルがこのメッセージの送信側で有効になっていることを示します。クライアントのバインディングの構成がサービスのバインディングと一致していることを確認してください。|  
+|SFxHeadersAreNotSupportedInEncoded|指定されたメッセージに、リモート プロシージャ コールでエンコードされたスタイルで使用するヘッダーを含めることはできません。|  
+|SFxInconsistentWsdlOperationStyleInMessageParts|指定された操作内のメッセージを構成するすべての部分は、型または要素のいずれかを格納している必要があります。|  
+|SFxInconsistentWsdlOperationStyleInOperationMessages|指定された操作内のメッセージから生成された指定されたスタイルが、バインディングによって指定された予期された指定のスタイルと一致しません。|  
+|SFxInvalidCallbackIAsyncResult|IAsyncResult が指定されていないか、型が正しくありません。|  
+|SFxInvalidMessageBody|OperationFormatter で、無効なメッセージ本文が検出されました。指定された名前と名前空間を持つ 'Element' ノード型が予期されていましたが、指定された名前と名前空間を持つ指定されたノード型が見つかりました。|  
+|SFxInvalidMessageBodyEmptyMessage|OperationFormatter は、メッセージが空のため、メッセージから情報を逆シリアル化できません。|  
+|SFxInvalidMessageBodyErrorDeserializingParameter|指定されたパラメーターを逆シリアル化しようとしているときにエラーが発生しました。詳細については InnerException を参照してください。|  
+|SFxInvalidMessageBodyErrorSerializingParameter|指定されたパラメーターをシリアル化しようとしているときにエラーが発生しました。InnerException メッセージが指定されています。詳細については、InnerException を参照してください。|  
+|SFxInvalidMessageBodyUnexpectedNode|パラメーターを逆シリアル化中に、指定された名前空間から指定された予期しないノードが検出されました。|  
+|SFxInvalidMessageContractSignature|指定された操作に、MessageContractAttribute が設定されたパラメーターまたは戻り値の型が含まれています。メッセージ コントラクトを使用して要求メッセージを表現するには、この操作には MessageContractAttribute を持つ単一のパラメーターが含まれている必要があります。メッセージ コントラクトを使用して応答メッセージを表現するには、この操作の戻り値は MessageContractAttribute を持つ型である必要があります。この操作には 'out' パラメーターや 'ref' パラメーターを含めることはできません。|  
+|SFxInvalidReplyAction|操作の送信応答メッセージには指定された Action が含まれていますが、この操作のコントラクトは別の ReplyAction を指定しています。メッセージで指定された Action がコントラクト内の ReplyAction と一致しているか、この操作のコントラクトが ReplyAction\='\*' を指定している必要があります。|  
+|SFxInvalidRequestAction|操作の送信要求メッセージには指定された Action が含まれていますが、この操作のコントラクトは別の RequestAction を指定しています。メッセージで指定された Action がコントラクト内の RequestAction と一致しているか、操作コントラクトが RequestAction\='\*' を指定している必要があります。|  
+|SFxInvalidStaticOverloadCalledForDuplexChannelFactory1|指定されたコントラクトはコールバック コントラクトを定義しているため、このコントラクトでは静的な CreateChannel メソッドを使用できません。DuplexChannelFactory\<TChannel\> で静的な CreateChannel オーバーロードのいずれか 1 つを使用してください。|  
+|SFxInvalidStreamInRequest|指定された操作における要求をストリームにするには、この操作は Stream 型の単一のパラメーターを持つ必要があります。|  
+|SFxInvalidStreamInResponse|指定された操作における応答をストリームにするには、この操作が Stream 型の単一の out パラメーターまたは戻り値を持つ必要があります。|  
+|SFxInvalidStreamInTypedMessage|メッセージ コントラクト プログラミング モデルでストリームを使用するには、指定された型が Stream 型の単一の MessageBody メンバーを持つ必要があります。|  
+|SFxInvalidUseOfPrimitiveOperationFormatter|PrimitiveOperationFormatter に、サポートされていないパラメーターまたは戻り値の型が指定されました。|  
+|SFxMessageContractBaseTypeNotValid|指定された型は MessageContract を定義していますが、その派生元である指定された型は MessageContract を定義していません。指定された継承階層内のすべてのオブジェクトが MessageContract を定義している必要があります。|  
+|SFxMethodNotSupported1|指定されたメソッドは、このオブジェクトでサポートされていません。これは、メソッドが OperationContractAttribute でマークされていない場合、またはインターフェイスの種類が ServiceContractAttribute でマークされていない場合に発生することがあります。|  
+|SFxMethodNotSupportedByType2|ServiceHost の指定された実装型は、指定されたサービス コントラクトを実装していません。|  
+|SFxMethodNotSupportedOnCallback1|指定されたコールバック メソッドはサポートされていません。この原因としては、このメソッドに OperationContractAttribute が設定されていないこと、またはそのインターフェイスの型が ServiceContractAttribute の CallbackContract のターゲットでないことが考えられます。|  
+|SFxMismatchedOperationParent|DispatchOperation または ClientOperation を追加できるのは、親の DispatchRuntime または ClientRuntime だけです。|  
+|SFxNameCannotBeEmpty|Name プロパティを空の文字列にすることはできません。|  
+|SfxNoTypeSpecifiedForParameter|パラメーターに CLR 型が指定されていなかったため、操作を生成できませんでした。|  
+|SFxOperationBehaviorAttributeOnlyOnServiceClass|OperationBehaviorAttribute を指定できるのはサービス クラスのみです。ServiceContract インターフェイスで指定することはできません。指定された型の指定されたメソッドは、これに違反しています。|  
+|SFxOperationContractOnNonServiceContract|指定されたメソッドには OperationContractAttribute が設定されていますが、それを囲む指定された型に ServiceContractAttribute が設定されていません。OperationContractAttribute は、ServiceContractAttribute 型のメソッド、または CallbackContract 型でのみ使用できます。|  
+|SFxParameterCountMismatch|指定された引数の数と必要な引数の数が一致しませんでした。具体的には、指定された引数には指定された個数の要素があり、必要な引数には指定された個数の要素があります。|  
+|SFxPartNameMustBeUniqueInRpc|リモート プロシージャ コール メッセージ内で、指定されたメッセージ部分名が一意ではありません。|  
+|SFxReplyActionMismatch3|指定されたアクションが含まれる指定された操作に対する応答メッセージを受信しましたが、クライアント コードには指定されたアクションが必要です。|  
+|SFxRequestReplyNone|"None" アドレスを対象にした WS\-Addressing の ReplyTo または FaultTo ヘッダーが含まれたメッセージを受信しました。これらの値は、要求\-応答の操作に対しては無効です。ReplyTo または FaultTo の値として "None" をサポートする必要がある場合は、一方向の操作を使用するか、ManualAddressing を有効にしてください。|  
+|SFxRequestTimedOut1|この要求操作は、指定された構成済みの時間内に応答を受信しませんでした。許可された時間はより長く設定されたタイムアウトの一部になる可能性があります。この原因としては、サービスがまだこの操作を処理していること、またはサービスが応答メッセージを送信できなかったことが考えられます。|  
+|SFxRequestTimedOut2|指定された場所に送信されたこの要求操作は、指定された構成済みの時間内に応答を受信しませんでした。許可された時間はより長く設定されたタイムアウトの一部になる可能性があります。この原因としては、サービスがまだこの操作を処理していること、またはサービスが応答メッセージを送信できなかったことが考えられます。|  
+|SFxSchemaDoesNotContainType|指定されたターゲット名前空間を持つスキーマに、指定された名前を持つ型が含まれていません。|  
+|SfxServiceContractAttributeNotFound|指定されたコントラクト型には ServiceContractAttribute 属性が設定されていません。有効なコントラクトを定義するには、指定された型に ServiceContractAttribute が設定されている必要があります。コントラクト インターフェイスまたはサービス クラスを型として指定できます。|  
+|SFxServiceContractGeneratorConfigRequired|GenerateServiceEndpoint メソッドを使用して構成情報を生成するためには、有効な構成オブジェクトを使用して ServiceContractGenerator インスタンスが初期化されている必要があります。|  
+|SFxServiceHostBaseCannotAddEndpointAfterOpen|ServiceHost が次のいずれかの状態になった後に、エンドポイントを追加することはできません。<br /><br /> -   オープン<br />-   途中終了<br />-   終了<br />-   Closed|  
+|SFxServiceHostBaseCannotAddEndpointWithoutDescription|Description プロパティが初期化される前に、エンドポイントを追加することはできません。|  
+|SFxServiceMetadataBehaviorNoHttpBaseAddress|ServiceMetadataBehavior の HttpGetEnabled プロパティが True に設定され、HttpGetUrl プロパティが相対アドレスですが、HTTP ベース アドレスがありません。HTTP ベース アドレスを指定するか、HttpGetUrl を絶対アドレスに設定してください。|  
+|SFxServiceMetadataBehaviorNoHttpsBaseAddress|ServiceMetadataBehavior の HttpsGetEnabled プロパティが True に設定され、HttpsGetUrl プロパティが相対アドレスですが、HTTPS ベース アドレスがありません。HTTPS ベース アドレスを指定するか、HttpsGetUrl を絶対アドレスに設定してください。|  
+|SFxServiceMetadataBehaviorUrlMustBeHttpOrRelative|動作 URI は、指定されたスキームの相対 URI または絶対 URI である必要があります。指定された URI は、指定されたスキームの絶対 URI です。|  
+|SFxStreamRequestMessageClosed|このストリームを含むメッセージは閉じられています。サービス操作が返った後に要求ストリームにアクセスすることはできません。|  
+|SFxStreamResponseMessageClosed|このストリームを含むメッセージは閉じられています。|  
+|SFxTerminateRequestProcessingException|操作パイプラインを拡張する場合、このメッセージの処理を中止する必要があります。|  
+|SFxTerminatingOperationAlreadyCalled1|IsTerminating 操作が既に呼び出されているため、このチャネルでこれ以上、メッセージを送信することはできません。|  
+|SFxThrottleLimitMustBeGreaterThanZero0|スロットル制限は、0 より大きい必要があります。スロットル制限を無効にするには、値を Int32.MaxValue に設定してください。|  
+|SFxTypedOrUntypedMessageCannotBeMixedWithVoidInRpc|RPC エンコード スタイルを使用しているときに、操作にパラメーターがない場合や void の戻り値がある場合は、メッセージ コントラクト型や System.ServiceModel.Channels.Message 型を使用できません。ブランク メッセージ コントラクト型を指定された操作に、パラメーターまたは戻り値の型として追加してください。|  
+|SFxUserCodeThrewException|指定されたユーザー操作によって、ユーザー コードで未処理の例外がスローされました。この問題が繰り返し発生する場合は、指定されたメソッドの実装にエラーが含まれている可能性があります。|  
+|SfxUseTypedMessageForCustomAttributes|指定されたパラメーターには追加属性が必要であるため、このパラメーターを操作パラメーターにマップすることはできません。|  
+|SFxVersionMismatchInOperationContextAndMessage2|OperationContext.Current の MessageVersion が、処理中のメッセージのヘッダー バージョンと一致しないため、送信ヘッダーをメッセージに追加できません。|  
+|SFxWellKnownNonSingleton0|サービス インスタンスを受け取る ServiceHost コンストラクターのいずれか 1 つを使用するには、サービスの InstanceContextMode が InstanceContextMode.Single に設定されている必要があります。これは ServiceBehaviorAttribute を使用して構成できます。または、Type 引数を受け取る ServiceHost コンストラクターを使用してください。|  
+|SFxWrapperTypeHasMultipleNamespaces|指定されたメッセージのラッパー型は複数の名前空間を持つため、データ コントラクト型として投影できません。XmlSerializer を使用してください。|  
+|UriMustBeAbsolute|URI は絶対 URI である必要があります。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/tools.md b/docs/framework/wcf/diagnostics/exceptions-reference/tools.md
new file mode 100644
index 00000000000..95b9ac2d2fe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/tools.md
@@ -0,0 +1,155 @@
+---
+title: "ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89c907f9-313f-408c-992a-631f1eadf1da
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ツール
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ツールによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|ParametersTarget|\<enum\>|  
+|ParametersToolConfig|\<configFile\>|  
+|ErrInvalidPath|指定されたパスが無効です。指定された引数を確認してください。|  
+|ParametersReference|\<ファイル パス\>|  
+|WrnCannotLoadConfigFileForValidation|指定された場所から読み込んだ構成ファイルの処理中にエラーが発生しました。この構成ファイルで定義されているサービスを検証できません。|  
+|MoreHelp|詳細なヘルプを表示するには、指定された引数と共に "svcutil" を入力してください。|  
+|HelpMergeConfig|既存ファイルを上書きする代わりに、生成された構成が既存ファイルにマージされます。|  
+|ErrCannotWriteFile|出力ファイルに書き込めません。|  
+|ErrInvalidNamespaceArgument|指定された無効な値が、指定されたオプションに渡されました。コンマ区切りのターゲット名前空間と CLR 名前空間の組み合わせを指定してください。|  
+|HelpImportXmlType|非 DataContract 型を IXmlSerializable 型としてインポートするように DataContract シリアライザーを構成します。|  
+|ErrExclusiveOptionsSpecified|もう一方の指定されたオプションが指定されているときは、指定されたオプションを使用できません。|  
+|WrnHttpGetFailed|指定された URI で HTTP GET Error が発生しました。|  
+|ErrInputFileNotAssemblyOrMetadata|指定された入力引数を介して読み取った指定された場所にあるファイルは、XML メタデータ ファイルまたは有効なアセンブリではないように思われます。|  
+|WrnUnknownMetadataFound|指定された種類の認識できないメタデータ ドキュメントを保存できません。|  
+|ErrDirectoryContainsInvalidCharacters|指定された無効な値が指定されたオプションに渡されました。指定された文字はパスで使用できません。|  
+|WrnCannotResolveServiceForValidation|指定された configName のサービスを読み込めません。サービスを検証するには、サービス型を含むアセンブリと実行可能ファイルの両方に、該当するサービスの構成を提供してください。|  
+|ErrUnexpectedValue|指定されたオプションは値をサポートしていません。|  
+|\#InvalidArg|指定された対象に無効な引数が含まれています。|  
+|ParametersExcludeType|\<type\>|  
+|HelpXmlSerializer|シリアル化と逆シリアル化に XmlSerializer を使用するデータ型を生成します。|  
+|\#|\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\=|  
+|ErrUnexpectedError|ツールでエラーが発生しました。|  
+|HelpNologo|著作権とバナー メッセージは表示されません。|  
+|ErrInputConflictsWithTarget|指定の値に設定された指定のオプションでは、指定された対象から読み取った入力の種類はサポートされません。|  
+|WrnCannotLoadServiceForExport|エクスポートするサービス型の読み込み中にエラーが発生しました。|  
+|HelpMetadataDownloadCategory|\-\= メタデータのダウンロード \=\-|  
+|WrnNoServiceContractTypes|指定されたアセンブリの XmlSerializer 型を生成できません。サービス コントラクト型が見つかりませんでした。|  
+|WrnCouldNotLoadTypesFromReferenceAssemblyAt|指定された対象から読み込んだアセンブリで、型の読み込み中にエラーが発生しました。アセンブリ内の一部の型は読み込めないため、ツールで使用できません。|  
+|ErrDirectoryPointsToAFile|指定された無効な値が指定されたオプションに渡されました。指定された値はファイルへのパスです。|  
+|Error|エラー :|  
+|ErrDuplicateReferenceValues|指定されたオプションを使用して、指定されたアセンブリが 2 回読み込まれました。アセンブリは、1 回しか参照できません。|  
+|WrnNoXmlSerializerOperationBehavior|指定されたアセンブリの XmlSerializer を生成できません。このアセンブリには、XmlSerializerOperationBehavior を使用する操作を含むサービス コントラクトがありません。|  
+|ErrCannotCreateDirectory|指定されたディレクトリを作成できません。|  
+|ErrCouldNotLoadTypesFromAssemblyAt|指定されたアセンブリ内の型を読み込めません。|  
+|ErrUnknownSwitch|指定されたスイッチは認識できないオプションです。|  
+|Logo|このツールのロゴは、バージョンが付加された "Microsoft ® Service Model Metadata Tool" です。|  
+|NoCodeWasGenerated|コードが生成されませんでした。<br /><br /> クライアントを生成しようとした場合は、この原因として、有効なコントラクトやサービスがメタデータ ドキュメントに含まれていないか、<br /><br /> 検索されたすべてのコントラクト\/サービスが参照アセンブリに存在する可能性があります。すべてのメタデータ ドキュメントをツールに渡したことを確認してください。|  
+|WrnUnableToLoadContractForSGen|コントラクトの種類を読み込み中にエラーが発生しました。このコントラクト用の XmlSerializer 型を生成できません。型と詳細が指定されています。|  
+|WrnOptionConflictsWithInput|複数入力アセンブリでは、指定されたオプションを使用できません。指定されたオプションは無視されます。|  
+|ErrUnableToImportMetadata|メタデータをインポートしようとしたときに重大なエラーが発生しました。|  
+|ErrInvalidSerializer|シリアライザーの無効な値が指定されたオプションに渡されました。サポートされているシリアライザーが指定されています。|  
+|SavingDownloadedMetadata|ダウンロードしたメタデータ ファイルを保存しています。|  
+|WrnNoConfigForServices|渡されたアセンブリが、構成ファイルを含む実行可能ファイルでないか、または、指定された構成名を持つサービスを含む構成ファイルがありません。|  
+|ErrInputConflictsWithOption|指定された対象から読み取った入力は、ツール操作の別のモードを意味するため、指定されたオプションと共に使用することはできません。|  
+|ErrUnableToExportEndpoints|指定されたサービス型のエクスポート中にエラーが発生しました。|  
+|ErrInputSchemaParseError|指定された対象の読み取り中に XML スキーマ解析エラーが発生しました。XML の形式が正しく、有効であることを確認してください。|  
+|ErrInputPolicyParseError|指定された対象の読み取り中に WS\-Policy 解析エラーが発生しました。XML の形式が正しく、有効であることを確認してください。|  
+|ErrUnableToLoadReferenceType|参照されたコントラクト型の読み込み中にエラーが発生しました。この指定された型は無視されます。|  
+|WrnCannotLoadServiceForValidation|検証するサービスの読み込み中にエラーが発生しました。型と詳細が指定されています。|  
+|HelpCodeGenerationCategory|\-\= コードの生成 \=\-|  
+|RetreivingMetadataWithMexAndDisco|WS\-Metadata Exchange または DISCO を使用して、指定された対象からメタデータをダウンロードしようとしています。|  
+|ErrGeneralSchemaValidation|エクスポート時に生成された XML スキーマの検証中にエラーが発生しました。|  
+|ParametersDirectory|\<directory\>|  
+|ErrCannotLoadSpecifiedType|指定されたオプションに渡された指定された値のための型を読み込めません。この型が属するアセンブリが、指定されたオプションを使用して指定されていることを確認してください。|  
+|ErrOptionModeConflict|指定されたオプションは、別の出力の種類を意味するため、指定されたオプションと共に使用することはできません。|  
+|ErrIsNotAnAssembly|指定された対象をアセンブリとして読み込めません。このファイルが .NET アセンブリであることを確認してください。|  
+|ErrInputConflictsWithMode|指定された対象から読み取った入力が、他のオプションと矛盾しています。|  
+|ErrDuplicateValuePassedToTypeArg|指定された値が指定されたオプションに繰り返し、渡されました。各型は 1 回しか指定できません。|  
+|ErrInputEPRFileParseError|指定された対象からエンドポイント参照を読み取ることができません。XML の形式が正しく、有効であることを確認してください。|  
+|ErrCouldNotCreateCodeProvider|\/{1} 引数に渡された指定された値に対してコード プロバイダーを作成できません。コード プロバイダーが適切にインストールおよび構成されていることを確認してください。|  
+|ErrPathTooLongDirOnly|結果の指定されたパスが長すぎます。指定された引数を確認してください。|  
+|HelpDataContractSerializer|シリアル化と逆シリアル化に DataContract シリアライザーを使用するデータ型を生成します。|  
+|ErrUnableToExportEndpoint|指定された名前空間の指定されたエンドポイント名を、アセンブリに対して読み込んだ構成ファイル内の指定されたサービス型にエクスポートしているときにエラーが発生しました。|  
+|HelpUsage1|ヘルプの使用方法を表示します。|  
+|HelpUsage2|ヘルプの使用方法を表示します。|  
+|HelpUsage3|ヘルプの使用方法を表示します。|  
+|HelpUsage4|ヘルプの使用方法を表示します。|  
+|HelpUsage5|ヘルプの使用方法を表示します。|  
+|ErrDirectoryNotFound|指定されたディレクトリが見つかりません。このディレクトリが存在することと、このディレクトリを読み取るための適切な権限を持っていることを確認してください。|  
+|ErrUnableToLoadFile|指定されたファイルを読み取ることができません。|  
+|ErrNoFilesFound|指定された入力パスは、既存のファイルを参照していないように思われます。|  
+|ParametersConfig|\<configFile\>|  
+|ErrDirectoryInsteadOfFile|指定された入力パスは、ディレクトリのように思われます。URL またはファイル パスを入力する必要があります。|  
+|HelpConfig|指定した名前を持つ構成ファイルを生成するようにツールに指示します。既定 : output.config。|  
+|ErrSingleUseSwitch|指定されたオプションを繰り返し指定することはできません。|  
+|Warning|警告 :|  
+|WrnAmbiguousServiceConfig|指定された構成名を持つ複数のサービス構成が見つかりました。次のアセンブリが指定されています。|  
+|ErrInvalidInputPath|指定された入力パスは、既存のファイルを参照していないように思われます。また、有効な URI ではないように思われます。|  
+|ErrUnableToLoadInputs|読み込まれたメタデータの読み取り中にエラーが発生しました。|  
+|GeneratingSerializer|XML シリアライザーを生成しています。|  
+|HelpToolConfig|アプリケーション構成ファイルの代わりに使用するカスタム構成ファイル。これを使用すると、ツールの構成ファイルを変更せずに、メタデータ構成を変更したり、構成の拡張を登録したりできます。|  
+|ErrValidateInvalidUse|指定されたオプションを指定されたオプションと共に使用することはできません。|  
+|WrnWSMExFailed|指定された URI で WS\-Metadata Exchange Error が発生しました。|  
+|HelpNoconfig|構成を生成しません。|  
+|HelpCodeGenerationDescription|指定された対象は、サービス コントラクト、クライアント、およびデータ型をメタデータ ドキュメントから生成できます。|  
+|HelpTargetMetadata|メタデータを出力します。入力が URL の場合、Svcutil.exe はメタデータをディスクに保存し、コードを生成しません。入力が 1 つ以上のアセンブリの場合、Svcutil.exe は、アセンブリ内の型からメタデータを生成します。|  
+|ErrAmbiguousOptionModeConflict|指定されたオプションは、他のオプションと競合しています。ツールの使用法を確認してください。|  
+|ErrNotLanguageOrCodeDomType|指定された引数に渡された指定された値は、定義された言語を表していないため、完全修飾された CLR 型として読み込めません。|  
+|ErrUnableToUniquifyFilename|出力ファイル名を作成できません。指定されたプレフィックスを使用して作成されているファイルが多すぎます。|  
+|ErrCannotCreateFile|指定された出力ファイルを作成できません。|  
+|ErrExpectedValue|指定されたオプションには値を指定する必要があります。|  
+|ErrCannotDisambiguateSpecifiedTypes|同じ名前を持つ複数の型が参照アセンブリのセットに存在します。指定されたオプションで、アセンブリ修飾名を使用して指定された型を区別してください。|  
+|RetreivingMetadataWithMexOnly|WS\-Metadata Exchange を使用して、指定された場所からメタデータをダウンロードしようとしています。この URL は DISCO をサポートしていません。|  
+|ErrInvalidTarget|指定されたターゲットは、指定されたオプションを使用して指定した場合は無効です。サポートされているターゲットが指定されています。|  
+|ErrPathTooLong|結果のパスが長すぎます。指定された引数を確認してください。|  
+|HelpCommonOptionsCategory|\-\= 共通のオプション \=\-|  
+|ParametersServiceName|\<serviceConfigName\>|  
+|ErrNoValidInputFilesSpecified|有効な入力ファイルが指定されていません。メタデータ ドキュメントまたはアセンブリ ファイルを指定してください。|  
+|ParametersLanguage|\<language\>|  
+|ErrUnableToLoadMetadataDocument|読み込んだドキュメントの 1 つからメタデータを読み取っているときにエラーが発生しました。ドキュメント識別子が指定されています。|  
+|ErrConflictingInputs|指定された入力引数は、ツール操作の別のモードを意味するため、指定された対象と競合しています。|  
+|WrnUnableToLoadContractForValidation|コントラクトの型の読み込み中にエラーが発生しました。型と詳細が指定されています。|  
+|WrnAttributeReflectionErrors|指定された対象から読み込んだアセンブリ内の一部の型で、属性のリフレクションに失敗しました。このアセンブリが、適切なセキュリティ特権を使用してこの場所から読み込むことができることを確認してください。|  
+|HelpMetadataExportCategory|\-\= メタデータのエクスポート \=\-|  
+|HelpValidationCategory|\-\= サービスの検証 \=\-|  
+|ValidationError|検証エラー :|  
+|GeneratingFiles|ファイルを生成しています...|  
+|ErrCannotSpecifyMultipleMappingsForNamespace|無効な値が、指定されたオプションに渡されました。指定されたターゲット名前空間は、指定された複数の CLR 名前空間にマップできません。|  
+|ErrCouldNotLoadReferenceAssemblyAt|指定された参照アセンブリを読み込めません。|  
+|ParametersOut|\<file\>|  
+|NoCodeWasGeneratedSuggestDCOnly|スキーマからコントラクトを生成するには、指定されたオプションを使用してください。|  
+|ErrUnableToLoadInputConfig|指定された構成ファイルを読み込むことができません。|  
+|ErrUnexpectedDelimiter|オプションの先頭には、無効な引数区切り記号 \(':' または '\='\) を使用できません。|  
+|ErrMergeConfigUsedWithoutConfig|もう一方の指定されたオプションを指定せずに、指定されたオプションを使用することはできません。|  
+|ErrUnableToExportContract|指定された型から読み込んだコントラクトのエクスポート中にエラーが発生しました。|  
+|GeneratingMetadata|メタデータ ファイルを生成しています。|  
+|ErrNotCodeDomType|指定された引数に渡された指定された型は、指定された派生クラスの型ではありません。|  
+|WrnNoTypeForServices|渡されたアセンブリには、指定された構成名を持つサービス型を含むものがありません。|  
+|ErrAssemblyLoadFailed|指定されたファイルをアセンブリとして読み込めません。詳細については、「FusionLogs」を参照してください。|  
+|NoMetadataWasGenerated|メタデータ ファイルが生成されませんでした。エクスポートされたサービス コントラクトはありません。<br /><br /> サービスをエクスポートするには、指定されたオプションを使用してください。データ コントラクトをエクスポートするには、オプションを指定してください。|  
+|WrnCannotResolveServiceForExport|指定された configName のサービスを読み込めません。サービスをエクスポートするには、サービス型を含むアセンブリと実行可能ファイルに、該当するサービスの構成を提供してください。|  
+|ParametersCollectionType|\<type\>|  
+|ErrOptionConflictsWithTarget|指定の値に設定された指定のオプションでは、指定されたオプションの使用がサポートされません。|  
+|ErrCodegenError|指定された言語でコードを生成しているときにエラーが発生しました。<br /><br /> この言語は、生成されているすべてのコード要素をサポートしているわけではありません。別の言語を使用してください。|  
+|ErrInputWsdlParseError|指定された対象の読み取り中に WSDL 解析エラーが発生しました。XML の形式が正しく、有効であることを確認してください。|  
+|ErrCouldNotCreateInstance|指定された引数に渡された指定された型のインスタンスを作成できません。|  
+|ParametersNamespace|\<string,string\>|  
+|HelpNostdlib|標準ライブラリを参照しません \(既定では、mscorlib.dll と system.servicemodel.dll が参照されます\)。|  
+|WrnCannotLoadConfigFileForExport|指定された対象から読み込んだ構成ファイルの処理中にエラーが発生しました。この構成ファイルで定義されているサービスを読み込むことができません。|  
+|WrnUnableToLoadContractForExport|コントラクトの型の読み込み中にエラーが発生しました。この指定された型はエクスポートできません。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/transaction-exceptions.md b/docs/framework/wcf/diagnostics/exceptions-reference/transaction-exceptions.md
new file mode 100644
index 00000000000..ba0afb90cdd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/transaction-exceptions.md
@@ -0,0 +1,30 @@
+---
+title: "トランザクションの例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d27ed51-7eda-477f-9eca-94fa129f3e07
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# トランザクションの例外
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トランザクションによって生成されるすべての例外を示します。  
+  
+## 例外の一覧  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|SFxCannotHaveDifferentTransactionProtocolsInOneBinding|メタデータからインポートされたポリシー情報により、TransactionProtocol に操作間で異なる値が指定されました。各エンドポイントでサポートされる TransactionProtocol は 1 つに限られます。|  
+|SFxTransactionAutoCompleteFalseAndInstanceContextMode|TransactionAutoComplete は、サービスの InstanceContextMode が PerSession にならない限り、false にはなりません。指定したコントラクトと操作の実装でエラーが発生しました。|  
+|SFxTransactionInvalidSetTransactionComplete|OperationContext.SetTransactionComplete は、TransactionAutoComplete が false に設定され、TransactionScopeRequired が true に設定されている場合にのみ、操作から呼び出すことができます。これは無効なシナリオであり、現在のトランザクションは終了しました。|  
+|TransactionFlowRequiredIssuedTokens|トランザクションをフローさせるには、発行済みトークンのフローもサポートされる必要があります。|  
+|TrustDriverVersionDoesNotSupportIssuedTokens|構成されたバージョンの Trust では、発行済みトークンがサポートされません。WSTrustFeb2005 またはそれ以降を使用してください。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/exceptions-reference/transaction-formatter.md b/docs/framework/wcf/diagnostics/exceptions-reference/transaction-formatter.md
new file mode 100644
index 00000000000..db1827dbef0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/exceptions-reference/transaction-formatter.md
@@ -0,0 +1,30 @@
+---
+title: "トランザクション フォーマッタ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 727b3f1c-fffa-4753-bc76-713e331c631a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# トランザクション フォーマッタ
+ここでは、トランザクション フォーマッタによって生成されるすべての例外を示します。  
+  
+## 例外  
+  
+|リソース コード|リソースの文字列|  
+|--------------|--------------|  
+|TMCommunicationError|分散トランザクション マネージャーとの通信中にエラーが発生しました。|  
+|WhereaboutsNoHostName|MSDTC 所在情報にホスト名が含まれていません。|  
+|WhereaboutsReadFailed|MSDTC 所在情報を逆シリアル化できませんでした。|  
+|WhereaboutsSignatureMissing|MSDTC 所在情報に標準の所在署名がありません。|  
+|WsatUriCreationFailed|登録サービス アドレスを MSDTC 所在情報から作成できませんでした。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/index.md b/docs/framework/wcf/diagnostics/index.md
new file mode 100644
index 00000000000..3e7ad71d2f2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/index.md
@@ -0,0 +1,61 @@
+---
+title: "管理と診断 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "管理 [WCF]"
+  - "診断 [WCF]"
+  - "WCF, 管理"
+  - "WCF, 診断"
+  - "Windows Communication Foundation, 管理"
+  - "Windows Communication Foundation, 診断"
+ms.assetid: 34c81c08-0e0f-4fbc-9ae8-91948640ee43
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 管理と診断
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、アプリケーションのライフサイクルのさまざまな段階を監視できるようにする豊富な機能が用意されています。たとえば、展開時に構成を使用してサービスとクライアントを設定できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、アプリケーションのパフォーマンス測定に役立つ多数のパフォーマンス カウンターが備わっています。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WMI \(Windows Management Instrumentation\) プロバイダーを介して実行時のサービスの検査データを公開します。アプリケーションにエラーが発生したり、適切に動作しなくなったりした場合は、イベント ログを使用して、何か重大なことが発生していないかを確認できます。メッセージ ログとトレースを使用して、アプリケーションでどのようなイベントが発生しているのかをエンドツーエンドで確認することもできます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションが正常に動作しなくなった場合、開発者や IT 専門家は、これらの機能を使用してトラブルシューティングを行うことができます。  
+  
+> [!NOTE]
+>  エラーが発生した際にエラーに関する具体的な詳細情報が得られなかった場合は、[\<serviceDebug\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicedebug.md) 構成要素の `includeExceptionDetailInFaults` 属性を有効にする必要があります。これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は例外に関する詳細をクライアントに送信するようになり、より詳しい診断を行わなくても多くの一般的な問題を検出できるようになります。詳細については、「[エラーの送受信](../../../../docs/framework/wcf/sending-and-receiving-faults.md)」を参照してください。  
+  
+## WCF に用意された診断機能  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、次の診断機能が用意されています。  
+  
+-   エンド ツー エンドのトレースは、デバッガーを使用せずにアプリケーションのトラブルシューティングを行うためのインストルメンテーション データを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、処理マイルストーンのトレースとエラー メッセージを出力します。これには、チャネル ファクトリのオープンやサービス ホストによるメッセージの送受信が含まれます。実行中のアプリケーションに対してトレースを有効にすると、その進行状況を監視できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[トレース](../../../../docs/framework/wcf/diagnostics/tracing/index.md)」のトピックを参照してください。トレースを使用してアプリケーションをデバッグする方法については、「[トレースを使用したアプリケーションのトラブルシューティング](../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)」を参照してください。  
+  
+-   メッセージ ログを使用すると、送信前と送信後の両方のメッセージを確認できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[メッセージ ログ](../../../../docs/framework/wcf/diagnostics/message-logging.md)」のトピックを参照してください。  
+  
+-   イベント トレースは、すべての重大な問題に関連するイベントをイベント ログに書き込みます。後でイベント ビューアーを使用して異常を調査できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[イベント ログ](../../../../docs/framework/wcf/diagnostics/event-logging/index.md)」のトピックを参照してください。  
+  
+-   パフォーマンス モニターを介して公開されるパフォーマンス カウンターを使用すると、アプリケーションとシステムの状態を監視できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[WCF パフォーマンス カウンター](../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)」のトピックを参照してください。  
+  
+-   <xref:System.ServiceModel.Configuration> 名前空間を使用すると、構成ファイルを読み込んでサービスまたはクライアント エンドポイントを設定できます。多数のコンピューターに更新を展開する必要がある場合は、オブジェクト モデルを使用して、さまざまなアプリケーションに対する変更をスクリプトで処理できます。また、[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)の GUI ウィザードを使用して、構成設定を編集することもできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[アプリケーションの構成](../../../../docs/framework/wcf/diagnostics/configuring-your-application.md)」のトピックを参照してください。  
+  
+-   WMI を使用すると、コンピューター上でリッスン中のサービスと使用しているバインディングを確認できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../docs/framework/wcf/diagnostics/wmi/index.md)」のトピックを参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの作成、展開、および管理を容易にする GUI ツールとコマンド ライン ツールも用意されています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][Windows Communication Foundation ツール](../../../../docs/framework/wcf/tools.md).たとえば、[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)を使用すると、XML を直接編集するのではなく、ウィザードを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の構成設定を作成および編集できます。また、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) を使用してトレース メッセージを表示、グループ化、およびフィルター処理することにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに関する問題を診断、修復、および検証できます。  
+  
+## 参照  
+ [アプリケーションの構成](../../../../docs/framework/wcf/diagnostics/configuring-your-application.md)   
+ [サービスの配置](../../../../docs/framework/wcf/diagnostics/deploying-services.md)   
+ [例外リファレンス](../../../../docs/framework/wcf/diagnostics/exceptions-reference/index.md)   
+ [イベント ログ](../../../../docs/framework/wcf/diagnostics/event-logging/index.md)   
+ [メッセージ ログ](../../../../docs/framework/wcf/diagnostics/message-logging.md)   
+ [構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)   
+ [ServiceModel 登録ツール](../../../../docs/framework/wcf/diagnostics/servicemodel-registration-tool.md)   
+ [トレース](../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../docs/framework/wcf/diagnostics/wmi/index.md)   
+ [WCF パフォーマンス カウンター](../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)   
+ [Windows Communication Foundation ツール](../../../../docs/framework/wcf/tools.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/message-flow-overview.md b/docs/framework/wcf/diagnostics/message-flow-overview.md
new file mode 100644
index 00000000000..050acf4166e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/message-flow-overview.md
@@ -0,0 +1,101 @@
+---
+title: "メッセージ フローの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb0899e1-84cc-4d90-b45b-dc5a50063943
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# メッセージ フローの概要
+相互接続されたサービスを持つ分散システムでは、サービス間の因果関係を調べる必要があります。  状態監視、トラブルシューティング、原因分析などの重要なシナリオをサポートするには、要求フローに含まれるさまざまなコンポーネントを理解することが重要です。  .NET Framework 4 では、多様なサービス間でトレースを関連付けることができるように、次の機能のサポートが追加されています。  
+  
+-   分析トレース: Event Tracing for Windows \(ETW\) を使用したトレース機能です。詳細度が低く、パフォーマンスに優れています。  
+  
+-   WCF\/WF サービス用のエンドツーエンドのアクティビティ モデル: <xref:System.ServiceModel> 名前空間および <xref:System.WorkflowModel> 名前空間が生成するトレースの相関関係をサポートする機能です。  
+  
+-   WF の ETW 追跡: この機能では、WF サービスによって生成された追跡レコードを使用して、ワークフローの現在の状態と進行状況を把握します。  
+  
+ 追跡レコードまたはトレース レコードに記録されたエラーを使用して、コード障害や誤った形式のメッセージを検出できます。  エラー状態のアクティビティの特定には、イベントのメッセージ ヘッダーにある Correlation ノードの ActivityId プロパティを使用することができます。  アクティビティ ID ごとにメッセージ フローのトレースを有効にする方法については、「[メッセージ フローのトレースの構成](../../../../docs/framework/wcf/diagnostics/etw/configuring-message-flow-tracing.md)」を参照してください。  このトピックでは、チュートリアル入門で作成されたプロジェクトでメッセージ フローのトレースを有効にする方法を示します。  
+  
+### チュートリアル入門で作成されたプロジェクトでメッセージ フローのトレースを有効にするには  
+  
+1.  **\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックし、「`eventvwr.exe`」と入力してイベント ビューアーを開きます。  
+  
+2.  分析トレースを有効にしていない場合は、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に展開します。  **\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。  **\[分析\]** を右クリックし、**\[ログを有効にする\]** をクリックします。  トレースが表示されるように、イベント ビューアーを開いたままにします。  
+  
+3.  [チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)で作成されたサンプルを [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で開きます。  サービスを作成できるように、管理者として [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を実行する必要があることに注意してください。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルがインストールされている場合、このチュートリアルで作成する完成済みのプロジェクトが含まれている[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)を開くことができます。  
+  
+4.  **Service** プロジェクトを右クリックして、**\[追加\]**、**\[新しい項目\]** の順にクリックします。  **\[アプリケーション構成ファイル\]** をクリックし、**\[OK\]** をクリックします。  
+  
+5.  上の手順で作成した App.Config ファイルに次のコードを追加します。  
+  
+    ```  
+    <system.serviceModel>  
+      <diagnostics>  
+        <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>  
+      </diagnostics>  
+    </system.serviceModel>  
+  
+    ```  
+  
+6.  Ctrl キーを押しながら F5 キーを押して、サーバー アプリケーションをデバッグなしで実行します。  **Client** プロジェクトを右クリックし、**\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックして、Client プロジェクトを実行します。  
+  
+7.  クライアントからサーバーへのイベントをトレースするには、Client プロジェクトのアプリケーション構成ファイルに次の内容を追加します。  
+  
+    ```  
+    <diagnostics>  
+      <endToEndTracing propagateActivity="true" messageFlowTracing="true"/>  
+    </diagnostics>  
+  
+    ```  
+  
+8.  クライアントの Program.cs に、次の Using ステートメントを追加します。  
+  
+    ```  
+    using System.Diagnostics;  
+  
+    ```  
+  
+9. Client プロジェクトの program.cs ファイルにある Main メソッドで、トレース GUID をイベント ログに伝達するように設定します。  
+  
+    ```  
+    Guid guid = Guid.NewGuid();  
+    Trace.CorrelationManager.ActivityId = guid;  
+  
+    ```  
+  
+10. 最新の情報に更新し、**\[分析\]** ログを調べます。  イベント ID が 220 のイベントを探します。  イベントを選択し、プレビュー ペインで **\[詳細\]** タブをクリックします。  このイベントには、呼び出し元アクティビティの相関 ID が含まれています。  
+  
+    ```  
+    <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" />  
+    ```  
+  
+    > [!NOTE]
+    >  ActivityID に同じ GUID を持つすべてのイベントは、1 つの要求に関連しています。  これは、特定のクライアントから特定のサービスへメッセージを関連付けるために使用できます。  このクライアントが別のサービスを呼び出した場合、同じクライアントが ActivityID によって識別されます。  
+  
+11. 場合によっては、ActivityID が元の GUID から新しい ActivityID に変更されます。  その場合、転送イベントが生成されます。  このイベント ID は 499 で、イベントのヘッダーに次のデータが格納されます。  
+  
+    ```  
+    <Event xmlns="http://schemas.microsoft.com/win/2004/08/events/event">  
+        <System>  
+            <Provider Name="Microsoft-Windows-Application Server-Applications" Guid="{c651f5f6-1c0d-492e-8ae1-b4efd7c9d503}" />   
+            <EventID>499</EventID>   
+            ...  
+            <Correlation ActivityID="{A066CCF1-8AB3-459B-B62F-F79F957A5036}" RelatedActivityID="{85FC0930-9C49-42DA-804B-A7368104BD1B}" />   
+            ...  
+       </System>  
+    </Event>  
+    ```  
+  
+    > [!NOTE]
+    >  転送イベントは、アクティブな ActivityID が、ActivityID として指定された GUID から RelatedActivityID として指定された GUID に変更されたことを記録します。  転送イベントの生成後は、すべてのイベントに新しい GUID が ActivityID として格納されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/message-logging.md b/docs/framework/wcf/diagnostics/message-logging.md
new file mode 100644
index 00000000000..a71594404e6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/message-logging.md
@@ -0,0 +1,40 @@
+---
+title: "メッセージ ログ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6bce0682-75ef-4d65-a659-b328fba4a8b5
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# メッセージ ログ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、オフラインで使用できるように送受信メッセージをログに記録できます。メッセージ ログを使用すると、メッセージとメッセージ本文を確認できます。この種のログは、どの引数が渡され、XML で表現された引数が受信エンドポイントでどのように表示されるかを知る上で特に役立ちます。また、受信時にメッセージをログに記録すると、無効なメッセージを診断できるだけでなく、メッセージがどのような経路で到着したかを確認できます。また、使用されたセキュリティ トークン、暗号化および署名された部分、および元のままの部分を調べることもできます。  
+  
+## このセクションの内容  
+ [メッセージ フローの概要](../../../../docs/framework/wcf/diagnostics/message-flow-overview.md)  
+  
+ ここでは、イベント ログ メッセージがクライアント イベントとサービス イベントにどのように対応するかについて説明します。  
+  
+ [メッセージ ログの構成](../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)  
+  
+ ここでは、さまざまなシナリオでのメッセージ ログの構成方法を示します。  
+  
+ [メッセージ ログを参照する](../../../../docs/framework/wcf/diagnostics/viewing-message-logs.md)  
+  
+ ここでは、メッセージ ログの表示方法について説明します。  
+  
+ [メッセージ ログ記録のセキュリティの考慮事項](../../../../docs/framework/wcf/diagnostics/security-concerns-for-message-logging.md)  
+  
+ ここでは、メッセージ ログに表示される機密データだけでなく、メッセージ ログによって生成されるイベントを保護する方法についても説明します。  
+  
+## 参照  
+ [管理と診断](../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/TOC.md b/docs/framework/wcf/diagnostics/performance-counters/TOC.md
new file mode 100644
index 00000000000..c9978a30f4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/TOC.md
@@ -0,0 +1,71 @@
+# [WCF パフォーマンス カウンター](index.md)
+# [トランザクション フロー](transactions-flowed.md)
+# [呼び出し](calls.md)
+# [1 秒あたりのトランザクション フロー](service-transactions-flowed-per-second.md)
+# [信頼できるメッセージの 1 秒あたりの破棄されたメッセージ](endpoint-reliable-messaging-messages-dropped-per-second.md)
+# [1 秒あたりのエラーとなった信頼できるメッセージ セッション](endpoint-reliable-messaging-sessions-faulted-per-second.md)
+# [1 秒あたりの失敗した呼び出し](calls-failed-per-second.md)
+# [呼び出す期間](call-duration.md)
+# [呼び出す期間](service-call-duration.md)
+# [保留状態の呼び出し](calls-outstanding.md)
+# [承認されていないセキュリティ呼び出し](endpoint-security-calls-not-authorized.md)
+# [1 秒あたりのキューに置かれた有害メッセージ](queued-poison-messages-per-second.md)
+# [中止されたトランザクション操作](transacted-operations-aborted.md)
+# [信頼できるメッセージの破棄されたメッセージ](endpoint-reliable-messaging-messages-dropped.md)
+# [保留状態の呼び出し](endpoint-calls-outstanding.md)
+# [承認されていないセキュリティ呼び出し](security-calls-not-authorized.md)
+# [1 秒あたりの呼び出し回数](endpoint-calls-per-second.md)
+# [インスタンス](instances.md)
+# [1 秒あたりの承認されていないセキュリティ呼び出し](endpoint-security-calls-not-authorized-per-second.md)
+# [1 秒あたりの失敗した呼び出し](endpoint-calls-failed-per-second.md)
+# [失敗した呼び出し](calls-faulted.md)
+# [1 秒あたりのトランザクション フロー](transactions-flowed-per-second.md)
+# [信頼できるメッセージの 1 秒あたりの破棄されたメッセージ](reliable-messaging-messages-dropped-per-second.md)
+# [信頼できるメッセージの破棄されたメッセージ](reliable-messaging-messages-dropped.md)
+# [1 秒あたりの失敗した呼び出し](endpoint-calls-faulted-per-second.md)
+# [1 秒あたりの失敗した呼び出し](service-calls-faulted-per-second.md)
+# [1 秒あたりのエラーとなった信頼できるメッセージ セッション](reliable-messaging-sessions-faulted-per-second.md)
+# [キューに置かれた拒否メッセージ](queued-rejected-messages.md)
+# [1 秒あたりのセキュリティ検証と認証エラー](endpoint-security-validation-and-authentication-failures-per-second.md)
+# [未完了の呼び出し数](service-calls-outstanding.md)
+# [不明なトランザクション操作](transacted-operations-in-doubt.md)
+# [キューに置かれた有害メッセージ](queued-poison-messages.md)
+# [同時セッションの最大数に対する割合](percent-of-max-concurrent-sessions.md)
+# [同時インスタンスの最大数に対する割合](percent-of-max-concurrent-instances.md)
+# [1 秒あたりの失敗した呼び出し](calls-faulted-per-second.md)
+# [1 秒あたりの不明なトランザクション操作](transacted-operations-in-doubt-per-second.md)
+# [エンドポイントのパフォーマンス カウンター](endpoint-performance-counters.md)
+# [トランザクション フロー](service-transactions-flowed.md)
+# [1 秒あたりのキューに置かれた拒否メッセージ](queued-rejected-messages-per-second.md)
+# [1 秒あたりのインスタンス](instances-per-second.md)
+# [1 秒あたりの破棄されたメッセージのキュー](queue-dropped-messages-per-second.md)
+# [1 秒あたりのコミットされたトランザクション操作](transacted-operations-committed-per-second.md)
+# [失敗した呼び出し](service-calls-failed.md)
+# [失敗した呼び出し](service-calls-faulted.md)
+# [コミットされたトランザクション操作](transacted-operations-committed.md)
+# [トランザクション フロー](endpoint-transactions-flowed.md)
+# [エラーとなった信頼できるメッセージ セッション](endpoint-reliable-messaging-sessions-faulted.md)
+# [1 秒あたりの呼び出し回数](service-calls-per-second.md)
+# [セキュリティ検証と認証エラー](endpoint-security-validation-and-authentication-failures.md)
+# [1 秒あたりの失敗した呼び出し](service-calls-failed-per-second.md)
+# [セキュリティ検証と認証エラー](service-security-validation-and-authentication-failures.md)
+# [失敗した呼び出し](calls-failed.md)
+# [1 秒あたりのセキュリティ検証と認証エラー](service-security-validation-and-authentication-failures-per-second.md)
+# [サービス パフォーマンス カウンター](service-performance-counters.md)
+# [失敗した呼び出し](endpoint-calls-failed.md)
+# [操作パフォーマンス カウンター](operation-performance-counters.md)
+# [承認されていないセキュリティ呼び出し](service-security-calls-not-authorized.md)
+# [失敗した呼び出し](endpoint-calls-faulted.md)
+# [1 秒あたりのセキュリティ検証と認証エラー](security-validation-and-authentication-failures-per-second.md)
+# [同時呼び出しの最大数に対する割合](percent-of-max-concurrent-calls.md)
+# [呼び出し](endpoint-calls.md)
+# [破棄されたメッセージのキュー](queue-dropped-messages.md)
+# [1 秒あたりの承認されていないセキュリティ呼び出し](service-security-calls-not-authorized-per-second.md)
+# [呼び出し](service-calls.md)
+# [呼び出す期間](endpoint-call-duration.md)
+# [1 秒あたりの中止されたトランザクション操作](transacted-operations-aborted-per-second.md)
+# [1 秒あたりのトランザクション フロー](endpoint-transactions-flowed-per-second.md)
+# [1 秒あたりの承認されていないセキュリティ呼び出し](security-calls-not-authorized-per-second.md)
+# [1 秒あたりの呼び出し回数](calls-per-second.md)
+# [セキュリティ検証と認証エラー](security-validation-and-authentication-failures.md)
+# [信頼できるメッセージ セッション違反](reliable-messaging-sessions-faulted.md)
diff --git a/docs/framework/wcf/diagnostics/performance-counters/call-duration.md b/docs/framework/wcf/diagnostics/performance-counters/call-duration.md
new file mode 100644
index 00000000000..12870252ecd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/call-duration.md
@@ -0,0 +1,29 @@
+---
+title: "呼び出す期間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4973ec3-3c66-4c0b-b5d0-294b62c83f7d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 呼び出す期間
+カウンター名 : 呼び出す期間  
+  
+## 説明  
+ この操作の呼び出しの平均期間です。  平均期間は、\(N1\-N0\)\/\(D1\-D0\) という数式に基づいて計算されます。  
+  
+> [!WARNING]
+>  非同期の WCF サービス上で使用される場合、呼び出す期間カウンターは常に \-1 を返します。  
+  
+## 参照  
+ [PERF\_AVERAGE\_TIMER](http://go.microsoft.com/fwlink/?LinkId=95015)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-failed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/calls-failed-per-second.md
new file mode 100644
index 00000000000..c8ce30136ce
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-failed-per-second.md
@@ -0,0 +1,32 @@
+---
+title: "1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4ef3773-f650-4876-99cf-4d0c02aa03d4
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し  
+  
+## 説明  
+ 1 秒間にこの操作で未処理の例外が発生した呼び出しの回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ このカウンターは、この操作で未処理の例外が発生するたびにインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-failed.md b/docs/framework/wcf/diagnostics/performance-counters/calls-failed.md
new file mode 100644
index 00000000000..920cf4bc17f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-failed.md
@@ -0,0 +1,26 @@
+---
+title: "失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52afeff8-333c-44a5-96ce-1f3c418523fc
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 失敗した呼び出し
+カウンター名 : 失敗した呼び出し  
+  
+## 説明  
+ この操作で未処理の例外が発生した呼び出しの回数です。このカウンターは、この操作で未処理の例外が発生するたびにインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-faulted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/calls-faulted-per-second.md
new file mode 100644
index 00000000000..dc814e37ca9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-faulted-per-second.md
@@ -0,0 +1,32 @@
+---
+title: "1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81c88073-8e32-4520-a71a-2c56b71ee515
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し  
+  
+## 説明  
+ この操作への呼び出しに失敗した回数です \(1 秒あたり\)。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-faulted.md b/docs/framework/wcf/diagnostics/performance-counters/calls-faulted.md
new file mode 100644
index 00000000000..bc03a536250
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-faulted.md
@@ -0,0 +1,26 @@
+---
+title: "失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb9e8045-6aeb-4b7f-a825-8283c44252a1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 失敗した呼び出し
+カウンター名 : 失敗した呼び出し  
+  
+## 説明  
+ この操作への呼び出しに失敗した回数です。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。  SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。  SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-outstanding.md b/docs/framework/wcf/diagnostics/performance-counters/calls-outstanding.md
new file mode 100644
index 00000000000..84851c493e1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-outstanding.md
@@ -0,0 +1,23 @@
+---
+title: "保留状態の呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dd36ef27-81a6-4c39-8d76-d01022d52d6f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 保留状態の呼び出し
+カウンター名 : 保留状態の呼び出し  
+  
+## 説明  
+ 実行中のこの操作を呼び出す回数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/calls-per-second.md
new file mode 100644
index 00000000000..cebb0bcad94
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりの呼び出し回数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0efb5a94-d83b-4793-b529-6fcbedb65c43
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 1 秒あたりの呼び出し回数
+カウンター名 : 1 秒あたりの呼び出し回数  
+  
+## 説明  
+ この操作が 1 秒あたりに呼び出される回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/calls.md b/docs/framework/wcf/diagnostics/performance-counters/calls.md
new file mode 100644
index 00000000000..d0e6364ed06
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/calls.md
@@ -0,0 +1,23 @@
+---
+title: "呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efbaa8f8-624d-4c68-a5b4-1f14da679b58
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 呼び出し
+カウンター名 : 呼び出し  
+  
+## 説明  
+ この操作への呼び出しの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-call-duration.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-call-duration.md
new file mode 100644
index 00000000000..1b7c8c54300
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-call-duration.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : 呼び出す期間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1aebe748-ad05-4ade-819c-d480379ccfb9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# エンドポイント : 呼び出す期間
+このエンドポイントの呼び出しの平均期間です。平均期間は、\(N1\-N0\)\/\(D1\-D0\) という数式に基づいて計算されます。  
+  
+## 参照  
+ [PERF\_COUNTER\_TYPE](http://go.microsoft.com/fwlink/?LinkID=94649)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed-per-second.md
new file mode 100644
index 00000000000..df2e2f991f3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed-per-second.md
@@ -0,0 +1,32 @@
+---
+title: "エンドポイント: 1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bcbe9da4-c8dd-4e27-b630-11611adc7580
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# エンドポイント: 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し。  
+  
+## 説明  
+ 未処理の例外を伴ってこのエンドポイントに到達した、1 秒あたりの呼び出しの回数。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ このカウンターは、このエンドポイントで未処理の例外が発生すると常にインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed.md
new file mode 100644
index 00000000000..cb07d47de1e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-failed.md
@@ -0,0 +1,26 @@
+---
+title: "エンドポイント : 失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bdca983-7199-4596-b7e1-de15c0766250
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# エンドポイント : 失敗した呼び出し
+カウンター名 : 失敗した呼び出し。  
+  
+## 説明  
+ このエンドポイントで処理できない例外が発生した呼び出しの数です。このカウンターは、このエンドポイントで未処理の例外が発生するたびにインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted-per-second.md
new file mode 100644
index 00000000000..6b9a0fd8739
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted-per-second.md
@@ -0,0 +1,32 @@
+---
+title: "エンドポイント : 1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9840fc0a-0e4d-4638-96fd-40e3ab9e4667
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# エンドポイント : 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し。  
+  
+## 説明  
+ このエンドポイントの呼び出しのうち、エラーを返したものの 1 秒あたりの回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted.md
new file mode 100644
index 00000000000..31b02e76795
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-faulted.md
@@ -0,0 +1,26 @@
+---
+title: "エンドポイント : 失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 271e6284-9c4b-465f-b619-069e1555a5e4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# エンドポイント : 失敗した呼び出し
+カウンター名 : 失敗した呼び出し。  
+  
+## 説明  
+ このエンドポイントの呼び出しのうち、エラーとなったものの回数です。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-outstanding.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-outstanding.md
new file mode 100644
index 00000000000..e28ad3f7112
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-outstanding.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : 実行中の呼び出し数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf1e854a-92bc-4850-81a2-a8134c9fd7d2
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# エンドポイント : 実行中の呼び出し数
+カウンター名 : 保留状態の呼び出し  
+  
+## 説明  
+ このエンドポイントに対する進行中の呼び出しの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-per-second.md
new file mode 100644
index 00000000000..3976871726d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "エンドポイント : 1 秒あたりの呼び出し回数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca0fc06d-d68f-4236-bd5f-c7ff6214acdd
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# エンドポイント : 1 秒あたりの呼び出し回数
+カウンター名 : 1 秒あたりの呼び出し  
+  
+## 説明  
+ このエンドポイントが 1 秒あたりに呼び出される回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls.md
new file mode 100644
index 00000000000..68b515da02d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-calls.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : 呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 223aefec-3011-4f35-afa7-a34c76708d52
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# エンドポイント : 呼び出し
+カウンター名 : 呼び出し。  
+  
+## 説明  
+ このエンドポイントへの呼び出しの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-performance-counters.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-performance-counters.md
new file mode 100644
index 00000000000..db4a68034fb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-performance-counters.md
@@ -0,0 +1,32 @@
+---
+title: "エンドポイントのパフォーマンス カウンター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d44d576-bd4e-453b-8b76-a818ce90b806
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# エンドポイントのパフォーマンス カウンター
+エンドポイントのパフォーマンス カウンターは、エンドポイントがどのようにメッセージを受信しているかを示すデータをキャプチャします。パフォーマンス モニターを使用して表示する場合、これらのカウンターは、`ServiceModelEndpoint 4.0.0.0` パフォーマンス オブジェクトの下にあります。インスタンスの名前には次のパターンが使用されます。  
+  
+```  
+(ServiceName).(ContractName)@(endpoint listener address)  
+```  
+  
+ このデータは、個々の操作で収集されるデータに似ていますが、そのエンドポイントだけで集約されたデータです。  
+  
+> [!CAUTION]
+>  パフォーマンス カウンターのインスタンス名の長さには制限があります。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] カウンターのインスタンス名の長さが最大長を超えると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によってインスタンス名の一部はハッシュ値に置き換えられます。  
+  
+## 参照  
+ [WCF パフォーマンス カウンター](../../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped-per-second.md
new file mode 100644
index 00000000000..73eda6d5e5a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "エンドポイント : 信頼できるメッセージの 1 秒あたりの破棄されたメッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ea3c4fc0-1e0f-4863-8879-57bc6c113018
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# エンドポイント : 信頼できるメッセージの 1 秒あたりの破棄されたメッセージ
+カウンター名 : 1 秒あたりに破棄された信頼できるメッセージ セッション  
+  
+## 説明  
+ このエンドポイントで 1 秒間に破棄された信頼できるメッセージング メッセージの合計数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped.md
new file mode 100644
index 00000000000..3e22fe99add
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-messages-dropped.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : 信頼できるメッセージの破棄されたメッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0c5b842-3b75-4cd1-91c4-a702ae17bdcd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# エンドポイント : 信頼できるメッセージの破棄されたメッセージ
+カウンター名 : 破棄された信頼できるメッセージ。  
+  
+## 説明  
+ このエンドポイントで破棄された信頼できるメッセージング メッセージの合計数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted-per-second.md
new file mode 100644
index 00000000000..5bc15c922df
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "エンドポイント : 1 秒あたりのエラーとなった信頼できるメッセージ セッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e9ae808a-7e1f-46b0-9560-d5a866be6d6e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# エンドポイント : 1 秒あたりのエラーとなった信頼できるメッセージ セッション
+カウンター名 : 1 秒あたりのエラーとなった信頼できるメッセージ セッション  
+  
+## 説明  
+ 1 秒以内にこのエンドポイントでエラーになった信頼できるメッセージ セッション数。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted.md
new file mode 100644
index 00000000000..c1b72473f2c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-reliable-messaging-sessions-faulted.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : エラーとなった信頼できるメッセージ セッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63eb536f-cb9d-4c9a-b620-947d1828b1ce
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# エンドポイント : エラーとなった信頼できるメッセージ セッション
+カウンター名 : 1 秒あたりのエラーとなった信頼できるメッセージ セッション  
+  
+## 説明  
+ 1 秒以内にこのエンドポイントでエラーになった信頼できるメッセージ セッション数。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized-per-second.md
new file mode 100644
index 00000000000..e713a7e4192
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized-per-second.md
@@ -0,0 +1,29 @@
+---
+title: "エンドポイント : 1 秒あたりの承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8a1547b-986b-45c1-b302-dea0cd4b516d
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# エンドポイント : 1 秒あたりの承認されていないセキュリティ呼び出し
+カウンター名 : 1 秒あたりの承認されていないセキュリティ呼び出し。  
+  
+## 説明  
+ 有効なユーザーから適切な保護を適用して送信されたが、特定のタスクの実行がユーザーに許可されていない、受信メッセージの 1 秒あたりの数です。  
+  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized.md
new file mode 100644
index 00000000000..7219cca2a4c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-calls-not-authorized.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : 承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d25095ff-9ff0-4c69-a674-4e6a9fe3f4dc
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# エンドポイント : 承認されていないセキュリティ呼び出し
+カウンター名 : 承認されていないセキュリティ呼び出し。  
+  
+## 説明  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。  受信メッセージが有効なユーザーから適切な保護を適用して送信されたものであり、その一方でそのユーザーが特定のタスクの実行を許可されていないことを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures-per-second.md
new file mode 100644
index 00000000000..2d6d9bf20d2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures-per-second.md
@@ -0,0 +1,41 @@
+---
+title: "エンドポイント : 1 秒あたりのセキュリティ検証と認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89a70b90-d7e4-4b03-9b84-4dc88ce3d605
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# エンドポイント : 1 秒あたりのセキュリティ検証と認証エラー
+カウンター名 : 1 秒あたりのセキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびにインクリメントされます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(例 : 無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(例 : メッセージが改ざんされた\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロックなど\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N1\-N0\)\/\(\(D1\-D0\)\/F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures.md
new file mode 100644
index 00000000000..92b7ca025bf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-security-validation-and-authentication-failures.md
@@ -0,0 +1,37 @@
+---
+title: "エンドポイント : セキュリティ検証エラーと認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5bad60aa-6084-4c7b-aefd-9b581f04382e
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# エンドポイント : セキュリティ検証エラーと認証エラー
+カウンター名 : セキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびに増分されます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(メッセージが改変された\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロック\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed-per-second.md
new file mode 100644
index 00000000000..7cddb28dc5b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "エンドポイント : 1 秒あたりのトランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f370ff1-a913-450b-bccb-c279ad165b3d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# エンドポイント : 1 秒あたりのトランザクション フロー
+カウンター名 : 1 秒あたりのトランザクション フロー。  
+  
+## 説明  
+ このエンドポイントでの操作に対して実行された 1 秒あたりのトランザクションの数です。このカウンターは、エンドポイントに送信されたメッセージにトランザクション ID が付与されている場合は常にインクリメントされます。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed.md b/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed.md
new file mode 100644
index 00000000000..7c043595434
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/endpoint-transactions-flowed.md
@@ -0,0 +1,23 @@
+---
+title: "エンドポイント : トランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66e83f05-349b-4e4f-ac4a-58345e503a30
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# エンドポイント : トランザクション フロー
+カウンター名 : トランザクション フロー。  
+  
+## 説明  
+ このエンドポイントでの操作に対して実行されたトランザクションの数です。このカウンターは、エンドポイントに送信されたメッセージにトランザクション ID が付与されている場合は常にインクリメントされます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/index.md b/docs/framework/wcf/diagnostics/performance-counters/index.md
new file mode 100644
index 00000000000..11cab7b5751
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/index.md
@@ -0,0 +1,149 @@
+---
+title: "WCF パフォーマンス カウンター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "パフォーマンス カウンター [WCF]"
+ms.assetid: f559b2bd-ed83-4988-97a1-e88f06646609
+caps.latest.revision: 37
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 37
+---
+# WCF パフォーマンス カウンター
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] には、アプリケーションのパフォーマンス測定に役立つ多数のパフォーマンス カウンターが備わっています。  
+  
+## パフォーマンス カウンターの有効化  
+ 次のように、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの app.config 構成ファイルを使用して [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスのパフォーマンス カウンターを有効にできます。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+        <diagnostics performanceCounters="All" />  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+ 特定の種類のパフォーマンス カウンターを有効にするよう `performanceCounters` 属性を設定できます。  有効な値は、次のとおりです。  
+  
+-   All : すべてのカテゴリ カウンター \(ServiceModelService、ServiceModelEndpoint、ServiceModelOperation\) を有効にします。  
+  
+-   ServiceOnly : ServiceModelService カテゴリ カウンターのみを有効にします。  これが既定値です。  
+  
+-   Off : ServiceModel\* パフォーマンス カウンターを無効にします。  
+  
+ すべての [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アプリケーションのパフォーマンス カウンターを有効にする場合は、構成設定を Machine.config ファイルに配置します。  コンピューターのパフォーマンス カウンター用に十分なメモリを構成する方法については、後の「**パフォーマンス カウンターのメモリ サイズの増加**」セクションを参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 機能拡張ポイント \(カスタム操作の呼び出し元など\) を使用する場合、独自のパフォーマンス カウンターを出力する必要もあります。  これは、機能拡張ポイントを実装すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] が既定のパスに標準のパフォーマンス カウンター データを出力できなくなるためです。  手動パフォーマンス カウンターのサポートを実装しない場合、予測したパフォーマンス カウンター データが得られない場合があります。  
+  
+ また次のように、コード内でパフォーマンス カウンターを有効にすることもできます。  
+  
+```  
+using System.Configuration;  
+using System.ServiceModel.Configuration;  
+using System.ServiceModel.Diagnostics;  
+Configuration config = ConfigurationManager.OpenExeConfiguration(  
+    ConfigurationUserLevel.None);  
+ServiceModelSectionGroup sg = ServiceModelSectionGroup.GetSectionGroup(config);  
+sg.Diagnostic.PerformanceCounters = PerformanceCounterScope.All;  
+config.Save();  
+```  
+  
+## パフォーマンス データの表示  
+ Windows に付属のパフォーマンス モニター \(Perfmon.exe\) を使用して、パフォーマンス カウンターによりキャプチャされたデータを表示できます。  このツールを起動するには、**\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして、ダイアログ ボックスに`「perfmon.exe」`と入力します。  
+  
+> [!NOTE]
+>  エンドポイント ディスパッチャーによって最後のメッセージが処理される前に、パフォーマンス カウンター インスタンスが解放される場合があります。  その結果、パフォーマンス データに一部のメッセージがキャプチャされない可能性があります。  
+  
+## パフォーマンス カウンターのメモリ サイズの増加  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、パフォーマンス カウンター カテゴリごとに別々の共有メモリを使用します。  
+  
+ 既定では、個々の共有メモリは、グローバル パフォーマンス カウンターのメモリ サイズの 4 分の 1 に設定されます。  グローバル パフォーマンス カウンターのメモリの既定値は 524,288 バイトです。  したがって、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の 3 つのパフォーマンス カウンター カテゴリの既定サイズは、それぞれ約 128 KB になります。  コンピューター上での [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アプリケーションの実行時特性によっては、パフォーマンス カウンター メモリが足りなくなる場合があります。  メモリ不足が発生すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] により、そのアプリケーションのイベント ログにエラーが書き込まれます。  エラーの内容にはパフォーマンス カウンターが読み込まれなかったことが示され、エントリには、"System.InvalidOperationException: カスタム カウンター ファイル ビューのメモリが足りません" という例外が含まれます。このエラー レベルでトレースが有効になっている場合は、さらにこの障害がトレースされます。  パフォーマンス カウンターのメモリがなくなった場合、パフォーマンス カウンターを有効にして [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アプリケーションを続行するとパフォーマンスが低下する可能性があります。  コンピューターの管理者は、使用可能なすべてのパフォーマンス カウンターをいつでも読み込めるだけの十分なメモリを割り当てておく必要があります。  
+  
+ レジストリで [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] カテゴリごとにパフォーマンス カウンター メモリの量を変更できます。  これを行うには、次の 3 つの場所に `FileMappingSize` という名前の新しい DWORD 値を追加し、目的の値をバイト単位で設定します。  コンピューターを再起動すると、設定した値が有効になります。  
+  
+-   HKLM\\System\\CurrentControlSet\\Services\\ServiceModelEndpoint 4.0.0.0\\Performance  
+  
+-   HKLM\\System\\CurrentControlSet\\Services\\ServiceModelOperation 4.0.0.0\\Performance  
+  
+-   HKLM\\System\\CurrentControlSet\\Services\\ServiceModelService 4.0.0.0\\Performance  
+  
+ 膨大な数のオブジェクト \(ServiceHost など\) が破棄され、ガベージ コレクトされるまで待機している場合、`PrivateBytes` パフォーマンス カウンターには非常に高い数値が登録されます。  この問題を解決するには、アプリケーション固有の独自のカウンターを追加するか、`performanceCounters` 属性を使用してサービス レベルのカウンターだけを有効にします。  
+  
+## パフォーマンス カウンターの種類  
+ パフォーマンス カウンターには、サービス、エンドポイント、操作の 3 つのレベルがあります。  
+  
+ WMI を使用してパフォーマンス カウンターのインスタンス名を取得できます。  次に例を示します。  
+  
+-   サービス カウンターのインスタンス名は、WMI [サービス](../../../../../docs/framework/wcf/diagnostics/wmi/service.md) インスタンスの "CounterInstanceName" プロパティを使用して取得できます。  
+  
+-   エンドポイント カウンターのインスタンス名は、WMI [エンドポイント](../../../../../docs/framework/wcf/diagnostics/wmi/endpoint.md) インスタンスの "CounterInstanceName" プロパティを使用して取得できます。  
+  
+-   操作カウンターのインスタンス名は、WMI [エンドポイント](../../../../../docs/framework/wcf/diagnostics/wmi/endpoint.md)インスタンスの "GetOperationCounterInstanceName" メソッドを使用して取得できます。  
+  
+ WMI の詳細については、「[診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../../docs/framework/wcf/diagnostics/wmi/index.md)」を参照してください。  
+  
+### サービスのパフォーマンス カウンター  
+ サービスのパフォーマンス カウンターはサービス動作全体を測定し、サービス全体のパフォーマンスを診断するために使用できます。  パフォーマンス モニターを使用して表示する場合、これらのカウンターは、`ServiceModelService 4.0.0.0` パフォーマンス オブジェクトの下にあります。  インスタンスには次のパターンの名前が付けられています。  
+  
+```  
+ServiceName@ServiceBaseAddress  
+```  
+  
+ サービス スコープ内のカウンターは、エンドポイントのコレクションのカウンターが集計されています。  
+  
+ サービス インスタンス作成のパフォーマンス カウンターは、新しい InstanceContext が作成されるとインクリメントされます。  新しい InstanceContext は、非アクティブ化メッセージを \(既存のサービスで\) 受信した場合でも、あるセッションからインスタンスに接続し、セッションを終了後に別のセッションから再接続した場合でも作成されることに注意してください。  
+  
+### エンドポイントのパフォーマンス カウンター  
+ エンドポイントのパフォーマンス カウンターにより、エンドポイントでのメッセージの受信状況を表すデータを参照できます。  パフォーマンス モニターを使用して表示する場合、これらのカウンターは、`ServiceModelEndpoint 4.0.0.0` パフォーマンス オブジェクトの下にあります。  インスタンスには次のパターンの名前が付けられています。  
+  
+```  
+(ServiceName).(ContractName)@(endpoint listener address)  
+```  
+  
+ このデータは、個々の操作で収集されるデータに似ていますが、エンドポイントから集計されただけのデータです。  
+  
+ エンドポイント スコープ内のカウンターは、操作のコレクションのカウンターから集計されます。  
+  
+> [!NOTE]
+>  コントラクト名とアドレスが同一の 2 つのエンドポイントは、同じカウンター インスタンスにマップされます。  
+  
+### 操作のパフォーマンス カウンター  
+ パフォーマンス モニターを使用して表示する場合、操作パフォーマンス カウンターは、`ServiceModelOperation 4.0.0.0` パフォーマンス オブジェクトの下にあります。  それぞれの操作に個別のインスタンスがあります。  つまり、指定したコントラクトに 10 の操作がある場合、10 の操作カウンター インスタンスがそのコントラクトに関連付けられます。  オブジェクトのインスタンスには次のパターンの名前が付いています。  
+  
+```  
+(ServiceName).(ContractName).(OperationName)@(first endpoint listener address)  
+```  
+  
+ このカウンターにより呼び出しがどのように使用されている、操作がどれほど効率的に実行されているかを調べることができます。  
+  
+ カウンターが複数のスコープで表示される場合、上位のスコープで収集されたデータは、下位のスコープからのデータが集計されています。  たとえば、エンドポイントの `Calls` は、エンドポイント内のすべての操作呼び出しの合計を表します。サービスの `Calls` は、サービス内のすべての操作呼び出しの合計を表します。  
+  
+> [!NOTE]
+>  1 つのコントラクトに重複した操作名がある場合は、その両方の操作に対してカウンター インスタンスは 1 つだけ取得されます。  
+  
+## WCF パフォーマンス カウンターのプログラミング  
+ プログラムで [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] パフォーマンス カウンターにアクセスできるよう SDK インストール フォルダーにはいくつかのファイルがインストールされています。  そのファイルを次に示します。  
+  
+-   \_ServiceModelEndpointPerfCounters.vrg  
+  
+-   \_ServiceModelOperationPerfCounters.vrg  
+  
+-   \_ServiceModelServicePerfCounters.vrg  
+  
+-   \_SMSvcHostPerfCounters.vrg  
+  
+-   \_TransactionBridgePerfCounters.vrg  
+  
+ プログラムでカウンターにアクセスする方法の詳細については、「[パフォーマンス カウンターのプログラミング アーキテクチャ](http://go.microsoft.com/fwlink/?LinkId=95179)」を参照してください。  
+  
+## 参照  
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/instances-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/instances-per-second.md
new file mode 100644
index 00000000000..55bc0d83200
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/instances-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのインスタンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74579397-1058-4278-80cf-2d00854a480f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 1 秒あたりのインスタンス
+カウンター名 : 1 秒あたりに作成されたインスタンス。  
+  
+## 説明  
+ 1 秒あたりに作成されたサービス インスタンスの合計数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/instances.md b/docs/framework/wcf/diagnostics/performance-counters/instances.md
new file mode 100644
index 00000000000..4f59b5060af
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/instances.md
@@ -0,0 +1,32 @@
+---
+title: "インスタンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8cf3460-0ca1-4411-8262-e9ecaf7f0a31
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# インスタンス
+カウンター名 : インスタンス  
+  
+## 説明  
+ 現在サービスに含まれているインスタンス コンテキストの数。  
+  
+ 多くの場合、インスタンス コンテキストの数とインスタンスの数は同じです。  ただし、次のシナリオではこの規則は当てはまりません。  
+  
+-   サービス メソッドが <xref:System.ServiceModel.Dispatcher.IInstanceProvider.ReleaseInstance%2A> メソッドを明示的に呼び出している場合。  
+  
+-   <xref:System.ServiceModel.ReleaseInstanceMode> が <xref:System.ServiceModel.OperationBehaviorAttribute> インスタンスに適用されている場合。  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationBehaviorAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/operation-performance-counters.md b/docs/framework/wcf/diagnostics/performance-counters/operation-performance-counters.md
new file mode 100644
index 00000000000..01f92f4dde8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/operation-performance-counters.md
@@ -0,0 +1,32 @@
+---
+title: "操作パフォーマンス カウンター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 333a51e0-f56e-4e1a-b359-5c91ff390568
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 操作パフォーマンス カウンター
+操作パフォーマンス カウンターは、パフォーマンス モニター \(Perfmon.exe\) を使用して表示した場合、`ServiceModelOperation 4.0.0.0` パフォーマンス オブジェクトの下にあります。それぞれの操作に個別のインスタンスがあります。つまり、指定したコントラクトに 10 の操作がある場合、10 の操作カウンター インスタンスがそのコントラクトに関連付けられます。オブジェクトのインスタンスには次のパターンの名前が付いています。  
+  
+```  
+(ServiceName).(ContractName).(OperationName)@(first endpoint listener address)  
+```  
+  
+ このカウンターにより呼び出しがどのように使用されている、操作がどれほど効率的に実行されているかを調べることができます。  
+  
+> [!CAUTION]
+>  パフォーマンス カウンターのインスタンス名の長さには制限があります。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] カウンターのインスタンス名の長さが最大長を超えると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によってインスタンス名の一部はハッシュ値に置き換えられます。  
+  
+## 参照  
+ [WCF パフォーマンス カウンター](../../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-calls.md b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-calls.md
new file mode 100644
index 00000000000..8fe6a4e7826
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-calls.md
@@ -0,0 +1,23 @@
+---
+title: "同時呼び出しの最大数に対する割合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22f18a91-1188-4c4e-9ad1-93f0dc180858
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 同時呼び出しの最大数に対する割合
+カウンター名: 同時呼び出しの最大数に対する割合  
+  
+## 説明  
+ 同時呼び出しの最大数に対する割合としての同時呼び出し数。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-instances.md b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-instances.md
new file mode 100644
index 00000000000..659305d5a13
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-instances.md
@@ -0,0 +1,23 @@
+---
+title: "同時インスタンスの最大数に対する割合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8228c15c-51ee-483d-b28b-e1f5c0ac643b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 同時インスタンスの最大数に対する割合
+カウンター名: 同時インスタンスの最大数に対する割合  
+  
+## 説明  
+ 同時インスタンスの最大数に対する割合としての現在のインスタンス数。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-sessions.md b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-sessions.md
new file mode 100644
index 00000000000..60415b80c82
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/percent-of-max-concurrent-sessions.md
@@ -0,0 +1,23 @@
+---
+title: "同時セッションの最大数に対する割合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 823b1287-002b-4a3a-81fd-183f15a482ca
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 同時セッションの最大数に対する割合
+カウンター名: 同時セッションの最大数に対する割合  
+  
+## 説明  
+ 同時セッションの最大数に対する割合としての同時セッション数。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages-per-second.md
new file mode 100644
index 00000000000..86950d0c88a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりの破棄されたメッセージのキュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74540f52-8762-4147-b5ba-e171180515a3
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 1 秒あたりの破棄されたメッセージのキュー
+カウンター名 : 1 秒あたりの破棄されたメッセージのキュー。  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって 1 秒あたりに破棄されたメッセージの数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages.md b/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages.md
new file mode 100644
index 00000000000..628f354bd1a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queue-dropped-messages.md
@@ -0,0 +1,25 @@
+---
+title: "破棄されたメッセージのキュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2125e32b-837c-4de9-ac02-750ad8f7472f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 破棄されたメッセージのキュー
+カウンター名 : キューに置かれ破棄されたメッセージ。  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって破棄されたメッセージの数です。  
+  
+ メッセージがいつ破棄されるかの詳細については、「[有害メッセージの処理](http://go.microsoft.com/fwlink/?LinkId=96233)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages-per-second.md
new file mode 100644
index 00000000000..05bdd12de8f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのキューに置かれた有害メッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d193fdd1-02f1-44a0-906e-f632a8f574c3
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 1 秒あたりのキューに置かれた有害メッセージ
+カウンター名 : 1 秒あたりのキューに置かれた有害メッセージ  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって 1 秒あたりに有害とマークされたメッセージの数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages.md b/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages.md
new file mode 100644
index 00000000000..d3eb7267fbe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queued-poison-messages.md
@@ -0,0 +1,25 @@
+---
+title: "キューに置かれた有害メッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8257ba45-08ac-4301-93c3-c93b4b78737a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# キューに置かれた有害メッセージ
+カウンター名 : キューに置かれた有害メッセージ。  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって有害とマークされたメッセージの数です。  
+  
+ メッセージが有害とマークされる状況の詳細については、「[Poison\-Message Handling](http://go.microsoft.com/fwlink/?LinkID=96233)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages-per-second.md
new file mode 100644
index 00000000000..a1bf0da9474
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのキューに置かれた拒否メッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 77ea9aa3-b9e2-4a1d-a65e-5ca115ba0567
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 1 秒あたりのキューに置かれた拒否メッセージ
+カウンター名 : 1 秒あたりに拒否されたキューに置かれたメッセージ。  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって 1 秒あたりに拒否されたメッセージの数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages.md b/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages.md
new file mode 100644
index 00000000000..340cd4391e7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/queued-rejected-messages.md
@@ -0,0 +1,25 @@
+---
+title: "キューに置かれた拒否メッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8eb75a76-4fb3-4d33-bd9f-6d91e09c5843
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# キューに置かれた拒否メッセージ
+カウンター名 : キューに置かれた拒否されたメッセージ。  
+  
+## 説明  
+ このサービスでキューに置かれたトランスポートによって拒否されたメッセージの数です。  
+  
+ メッセージが拒否される状況の詳細については、「[Poison\-Message Handling](http://go.microsoft.com/fwlink/?LinkID=96233)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped-per-second.md
new file mode 100644
index 00000000000..876882ddfc0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "信頼できるメッセージの 1 秒あたりの破棄されたメッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a11b0b80-b242-48e1-b0bb-7f756db5486b
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 信頼できるメッセージの 1 秒あたりの破棄されたメッセージ
+カウンター名 : 1 秒あたりに破棄された信頼できるメッセージ セッション  
+  
+## 説明  
+ このサービスで 1 秒間に破棄された信頼できるメッセージング メッセージの合計数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped.md b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped.md
new file mode 100644
index 00000000000..80088d7b036
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-messages-dropped.md
@@ -0,0 +1,23 @@
+---
+title: "信頼できるメッセージの破棄されたメッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9933abaa-33ec-4245-b083-bf94415929b5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 信頼できるメッセージの破棄されたメッセージ
+カウンター名 : 破棄された信頼できるメッセージ。  
+  
+## 説明  
+ このサービスで破棄された信頼できるメッセージング メッセージの合計数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted-per-second.md
new file mode 100644
index 00000000000..f594c15c11e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのエラーとなった信頼できるメッセージ セッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f8ca2eb-1be4-4b6a-aa78-fcd3ee145fe8
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 1 秒あたりのエラーとなった信頼できるメッセージ セッション
+カウンター名 : 1 秒あたりのエラーとなった信頼できるメッセージ セッション  
+  
+## 説明  
+ 1 秒以内にこのサービスでエラーになった信頼できるメッセージ セッションの数。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted.md b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted.md
new file mode 100644
index 00000000000..a7c6c3b2941
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/reliable-messaging-sessions-faulted.md
@@ -0,0 +1,23 @@
+---
+title: "信頼できるメッセージ セッション違反 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b8a694a-92fa-498b-b5d6-fcf75e4d329d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 信頼できるメッセージ セッション違反
+カウンター名 : エラーとなった信頼できるメッセージ。  
+  
+## 説明  
+ このサービスでエラーが発生した信頼できるメッセージ セッションの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized-per-second.md
new file mode 100644
index 00000000000..082e6c513ec
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized-per-second.md
@@ -0,0 +1,29 @@
+---
+title: "1 秒あたりの承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f189767-8c05-478a-8f0b-9228e5d351e5
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# 1 秒あたりの承認されていないセキュリティ呼び出し
+カウンター名 : 1 秒あたりの承認されていないセキュリティ呼び出し。  
+  
+## 説明  
+ この操作で 1 秒あたりに承認に失敗した呼び出しの数です。  
+  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。受信メッセージが有効なユーザーから適切な保護を適用して送信されたものであり、その一方でそのユーザーが特定のタスクの実行を許可されていないことを示します。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized.md b/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized.md
new file mode 100644
index 00000000000..64a5b5d2a43
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/security-calls-not-authorized.md
@@ -0,0 +1,23 @@
+---
+title: "承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb6acdcd-7336-42e1-9ae8-ac891336cd58
+caps.latest.revision: 6
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 6
+---
+# 承認されていないセキュリティ呼び出し
+カウンター名 : 承認されていないセキュリティ呼び出し。  
+  
+## 説明  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。  受信メッセージが有効なユーザーから適切な保護を適用して送信されたものであり、その一方でそのユーザーが特定のタスクの実行を許可されていないことを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures-per-second.md
new file mode 100644
index 00000000000..2043913bfe7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures-per-second.md
@@ -0,0 +1,41 @@
+---
+title: "1 秒あたりのセキュリティ検証と認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 266c3bd3-2ffc-4471-94b7-3675443be1ac
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# 1 秒あたりのセキュリティ検証と認証エラー
+カウンター名 : 1 秒あたりのセキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびに増分されます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(例 : 無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(例 : メッセージが改ざんされた\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロックなど\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N1\-N0\)\/\(\(D1\-D0\)\/F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures.md b/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures.md
new file mode 100644
index 00000000000..731c9cfd72d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/security-validation-and-authentication-failures.md
@@ -0,0 +1,37 @@
+---
+title: "セキュリティ検証と認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d4e3666-dfc6-421c-baf8-9479c22f7050
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# セキュリティ検証と認証エラー
+カウンター名 : セキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびに増分されます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(例 : 無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(例 : メッセージが改ざんされた\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロックなど\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-call-duration.md b/docs/framework/wcf/diagnostics/performance-counters/service-call-duration.md
new file mode 100644
index 00000000000..d37f1bb12fe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-call-duration.md
@@ -0,0 +1,26 @@
+---
+title: "サービス : 呼び出し時間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfe42a97-daf8-42c3-ba34-4bb8230cdebb
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス : 呼び出し時間
+カウンター名 : 呼び出す期間  
+  
+## 説明  
+ このサービスの呼び出しの平均期間です。  平均期間は、\(N1\-N0\)\/\(D1\-D0\) という数式に基づいて計算されます。  
+  
+## 参照  
+ [PERF\_AVERAGE\_TIMER](http://go.microsoft.com/fwlink/?LinkID=95015)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed-per-second.md
new file mode 100644
index 00000000000..3936538d520
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed-per-second.md
@@ -0,0 +1,36 @@
+---
+title: "サービス : 1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a2c7939-107d-4f0c-b43c-e02e079e8a9d
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# サービス : 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し。  
+  
+## 説明  
+ このサービスが 1 秒間に受信した未処理の例外を含む呼び出しの回数。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ マネージ コードでは、エラー状態が発生すると例外がスローされます。  
+  
+ マネージ コードでは、エラー状態が発生すると例外がスローされます。  
+  
+ このカウンターは、このサービスで未処理の例外が発生するたびにインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed.md
new file mode 100644
index 00000000000..9ec90b3cb27
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-failed.md
@@ -0,0 +1,26 @@
+---
+title: "サービス : 失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6f688ff4-05ab-4528-98c9-99a6ace28ec6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# サービス : 失敗した呼び出し
+カウンター名 : 失敗した呼び出し。  
+  
+## 説明  
+ このサービスで未処理の例外が発生した呼び出しの回数です。このカウンターは、このサービスで未処理の例外が発生するたびにインクリメントされます。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted-per-second.md
new file mode 100644
index 00000000000..5bfd2ac74a7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted-per-second.md
@@ -0,0 +1,32 @@
+---
+title: "サービス : 1 秒あたりの失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94247356-2b29-4b50-b639-91ca8c1cf3a9
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# サービス : 1 秒あたりの失敗した呼び出し
+カウンター名 : 1 秒あたりの失敗した呼び出し。  
+  
+## 説明  
+ このサービスの呼び出しのうち、エラーを返したものの 1 秒あたりの回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)  
+  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted.md
new file mode 100644
index 00000000000..8cfdcb3ffbc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-faulted.md
@@ -0,0 +1,26 @@
+---
+title: "サービス : 失敗した呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6da7f100-3f61-4b3c-9409-fe1360829b8a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービス : 失敗した呼び出し
+カウンター名 : 失敗した呼び出し。  
+  
+## 説明  
+ このサービスの呼び出しのうち、エラーとなったものの回数です。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] アプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型であり、堅牢かつインタラクティブに実行できるようにクライアントが使用するエラー コントラクトを作成するために使用されます。SOAP エラーは XML 形式でクライアントに渡されるので、相互運用性の面でも優れています。  
+  
+## 参照  
+ [コントラクトおよびサービスのエラーの指定と処理](../../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-outstanding.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-outstanding.md
new file mode 100644
index 00000000000..67fc64c56af
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-outstanding.md
@@ -0,0 +1,23 @@
+---
+title: "サービス : 未完了の呼び出し数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88eb4019-b99b-491d-bfd6-15129bb32821
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# サービス : 未完了の呼び出し数
+カウンター名 : 保留状態の呼び出し  
+  
+## 説明  
+ このサービスへの呼び出しのうち、処理中のものの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls-per-second.md
new file mode 100644
index 00000000000..824aa0051cf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "サービス : 1 秒あたりの呼び出し数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6261d28d-d449-425a-b9fc-a4ee14079134
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス : 1 秒あたりの呼び出し数
+カウンター名 : 1 秒あたりの呼び出し。  
+  
+## 説明  
+ このサービスが 1 秒あたりに呼び出される回数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)。ここで、分子 \(N\) は最後のサンプル間隔中に実行された操作の数を表し、分母 \(D\) は最後のサンプル間隔中に経過したタイマー刻み数を表し、F はタイマー刻みの頻度を表します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-calls.md b/docs/framework/wcf/diagnostics/performance-counters/service-calls.md
new file mode 100644
index 00000000000..b7fe4c9c745
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-calls.md
@@ -0,0 +1,23 @@
+---
+title: "サービス : 呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e6b161a-3a12-4106-a092-3eeb219fc9bb
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# サービス : 呼び出し
+カウンター名 : 呼び出し。  
+  
+## 説明  
+ このサービスへの呼び出しの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-performance-counters.md b/docs/framework/wcf/diagnostics/performance-counters/service-performance-counters.md
new file mode 100644
index 00000000000..7085e05447e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-performance-counters.md
@@ -0,0 +1,30 @@
+---
+title: "サービス パフォーマンス カウンター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4210f549-31f2-4ea7-99bd-69eaffb98ddf
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# サービス パフォーマンス カウンター
+サービスのパフォーマンス カウンターはサービス動作全体を測定し、サービス全体のパフォーマンスを診断するために使用できます。パフォーマンス モニター \(Perfmon.exe\) を使用して表示する場合、これらのカウンターは、`ServiceModelService 4.0.0.0` パフォーマンス オブジェクトの下にあります。インスタンスには次のパターンの名前が付けられています。  
+  
+```  
+ServiceName@ServiceBaseAddress  
+```  
+  
+> [!CAUTION]
+>  パフォーマンス カウンターのインスタンス名の長さには制限があります。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] カウンターのインスタンス名の長さが最大長を超えると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によってインスタンス名の一部はハッシュ値に置き換えられます。  
+  
+## 参照  
+ [WCF パフォーマンス カウンター](../../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized-per-second.md
new file mode 100644
index 00000000000..f2d4aefa94c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized-per-second.md
@@ -0,0 +1,29 @@
+---
+title: "サービス : 1 秒あたりの承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1eeade5a-ea62-4757-b1f9-1b1b1746abd1
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# サービス : 1 秒あたりの承認されていないセキュリティ呼び出し
+カウンター名 : 1 秒あたりの承認されていないセキュリティ呼び出し  
+  
+## 説明  
+ 有効なユーザーから適切な保護を適用して送信されたが、特定のタスクの実行がユーザーに許可されていない受信メッセージの 1 秒あたりの数です。  
+  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkId=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized.md b/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized.md
new file mode 100644
index 00000000000..a913443a8f4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-security-calls-not-authorized.md
@@ -0,0 +1,23 @@
+---
+title: "サービス : 承認されていないセキュリティ呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3024b20a-5250-4bd1-a38c-c6d79f89610b
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# サービス : 承認されていないセキュリティ呼び出し
+カウンター名 : 承認されていないセキュリティ呼び出し。  
+  
+## 説明  
+ このカウンターは <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドで `false` が返された場合にインクリメントされます。受信メッセージが有効なユーザーから適切な保護を適用して送信されたものであり、その一方でそのユーザーが特定のタスクの実行を許可されていないことを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures-per-second.md
new file mode 100644
index 00000000000..943ae39f0c6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures-per-second.md
@@ -0,0 +1,41 @@
+---
+title: "サービス : 1 秒あたりのセキュリティ検証と認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4af18009-e778-490b-9ba6-e76485285830
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# サービス : 1 秒あたりのセキュリティ検証と認証エラー
+カウンター名 : 1 秒あたりのセキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびに増分されます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(例 : 無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(例 : メッセージが改ざんされた\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロックなど\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures.md b/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures.md
new file mode 100644
index 00000000000..657d876512e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-security-validation-and-authentication-failures.md
@@ -0,0 +1,37 @@
+---
+title: "サービス : セキュリティ検証と認証エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 55c98268-b1ad-459d-851b-25ef52248187
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# サービス : セキュリティ検証と認証エラー
+カウンター名 : セキュリティ検証と認証エラー  
+  
+## 説明  
+ このカウンターは、"承認されていないセキュリティ呼び出し" カウンターでカウントの対象とならないセキュリティ上の問題が原因でメッセージが拒否されるたびに増分されます。この問題には、次のようなものがあります。  
+  
+-   メッセージからクライアント トークンを読み取ることができない。  
+  
+-   クライアント トークンが認証に失敗した \(例 : 無効なパスワード\)。  
+  
+-   署名の検証に失敗した \(例 : メッセージが改ざんされた\)。  
+  
+-   メッセージが以前のメッセージと重複する。この現象はリプレイ攻撃中に発生することがあります。  
+  
+-   復号化に失敗した。  
+  
+-   一部の必須要素 \(タイムスタンプ、暗号化データ ブロックなど\) がメッセージにない。  
+  
+-   TLSNEGO\/SPNEGO ハンドシェイク中にエラーが発生した。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed-per-second.md
new file mode 100644
index 00000000000..d654b97d94a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "サービス : 1 秒あたりのトランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec72eb49-2942-4811-91df-d6e5dad81fd8
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# サービス : 1 秒あたりのトランザクション フロー
+カウンター名 : 1 秒あたりのトランザクション フロー。  
+  
+## 説明  
+ このサービスでの操作に対して実行された 1 秒あたりのトランザクションの数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed.md b/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed.md
new file mode 100644
index 00000000000..2ecc51371b6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/service-transactions-flowed.md
@@ -0,0 +1,23 @@
+---
+title: "サービス : トランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7c564d7d-60d3-45a4-a9a1-c78f62ace57f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# サービス : トランザクション フロー
+カウンター名 : トランザクション フロー。  
+  
+## 説明  
+ このサービスにおける操作に送信されたトランザクションの数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted-per-second.md
new file mode 100644
index 00000000000..bdf571a3ac9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりの中止されたトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19fc993f-2b3d-4898-852e-3b98ec2153a5
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 1 秒あたりの中止されたトランザクション操作
+カウンター名 : 1 秒あたりの中止されたトランザクション処理数。  
+  
+## 説明  
+ 1 秒あたりに、このサービスで中止されたトランザクション処理の数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted.md
new file mode 100644
index 00000000000..8ff7a81cb64
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-aborted.md
@@ -0,0 +1,23 @@
+---
+title: "中止されたトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0ff844c-a33c-4ecf-8be5-b5b33635914a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 中止されたトランザクション操作
+カウンター名 : 中止されたトランザクション操作  
+  
+## 説明  
+ このサービスで中止されたトランザクション操作の数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed-per-second.md
new file mode 100644
index 00000000000..fd340cd3b18
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのコミットされたトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7318921b-47c4-4c8c-9fdd-41a92061c53f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 1 秒あたりのコミットされたトランザクション操作
+カウンター名 : 1 秒あたりのコミットされたトランザクション操作。  
+  
+## 説明  
+ 1 秒あたりに、このサービスでコミットされたトランザクション操作の数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed.md
new file mode 100644
index 00000000000..3c1871d3182
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-committed.md
@@ -0,0 +1,23 @@
+---
+title: "コミットされたトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a1768cd-d103-4cd3-a26c-b014465f9236
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コミットされたトランザクション操作
+カウンター名 : コミットされたトランザクション操作。  
+  
+## 説明  
+ このサービスでコミットされたトランザクション操作の数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt-per-second.md
new file mode 100644
index 00000000000..fc061005a9d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりの不明なトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e6b0716-c107-42e5-a21d-31d988e7a691
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 1 秒あたりの不明なトランザクション操作
+カウンター名 : 1 秒あたりの不明なトランザクション操作。  
+  
+## 説明  
+ このサービスでの 1 秒あたりの結果が不明なランザクション操作の数です。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt.md b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt.md
new file mode 100644
index 00000000000..24c98ff1dbf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transacted-operations-in-doubt.md
@@ -0,0 +1,23 @@
+---
+title: "不明なトランザクション操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83c7a86d-37de-4c6a-aa09-5d53fc4476b6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 不明なトランザクション操作
+カウンター名 : 不明なトランザクション操作。  
+  
+## 説明  
+ このサービスでの結果が不明なトランザクション操作の数です。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed-per-second.md b/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed-per-second.md
new file mode 100644
index 00000000000..f43b1c3e73e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed-per-second.md
@@ -0,0 +1,27 @@
+---
+title: "1 秒あたりのトランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9f661e1-576c-48fc-9fdf-91853e0749e8
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 1 秒あたりのトランザクション フロー
+カウンター名 : 1 秒あたりのトランザクション フロー  
+  
+## 説明  
+ この操作に対して実行された 1 秒あたりのトランザクションの数です。  このカウンターは、操作に送信されたメッセージにトランザクション ID が存在する場合にインクリメントされます。  
+  
+ このカウンターは、パフォーマンス カウンター型 [PERF\_COUNTER\_COUNTER](http://go.microsoft.com/fwlink/?LinkID=94649) であり、その値は次の式を使用して計算されます。  
+  
+ \(N 1 \- N 0 \) \/ \( \(D 1 \-D 0 \) \/ F\)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed.md b/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed.md
new file mode 100644
index 00000000000..4e589dcdfe3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/performance-counters/transactions-flowed.md
@@ -0,0 +1,23 @@
+---
+title: "トランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efeb0167-2014-4c08-b07a-44885bf80a66
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# トランザクション フロー
+カウンター名 : トランザクション フロー  
+  
+## 説明  
+ この操作に対して実行されたトランザクションの数です。  このカウンターは、操作に送信され、トランザクション ID を含んでいるメッセージに対してインクリメントされます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/security-concerns-for-message-logging.md b/docs/framework/wcf/diagnostics/security-concerns-for-message-logging.md
new file mode 100644
index 00000000000..c72da94f6bc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/security-concerns-for-message-logging.md
@@ -0,0 +1,121 @@
+---
+title: "メッセージ ログ記録のセキュリティの考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21f513f2-815b-47f3-85a6-03c008510038
+caps.latest.revision: 17
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 17
+---
+# メッセージ ログ記録のセキュリティの考慮事項
+ここでは、メッセージ ログに表示される機密データだけでなく、メッセージ ログによって生成されるイベントを保護する方法についても説明します。  
+  
+## セキュリティに関する注意事項  
+  
+### 機密情報のログ記録  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、アプリケーション固有のヘッダーおよび本文内のデータを変更することはありません。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、アプリケーション固有のヘッダーまたは本文データにある個人情報も追跡しません。  
+  
+ メッセージのログ記録が有効になっていると、アプリケーション固有ヘッダー内にある個人情報 \(クエリ文字列など\)、および本文情報 \(クレジット カード番号\) がログ内で確認できるようになります。アプリケーションを配置するユーザーは、構成ファイルとログ ファイルに対するアクセス制御を実施する必要があります。この種の情報を表示しないようにするには、ログ記録を無効にするか、ログを共有する場合にこの種のデータにフィルターをかけて除外します。  
+  
+ ログ ファイルの内容が意図せず公開されることを防ぐためには、次のヒントに従います。  
+  
+-   Web ホストおよび自己ホストの両方のシナリオにおいて、ログ ファイルがアクセス制御リスト \(ACL\) によって保護されていることを確認します。  
+  
+-   Web 要求を使用して簡単に処理できないファイル拡張子を選択します。たとえば、.xml ファイルの拡張子を選ぶのは安全ではありません。インターネット インフォメーション サービス \(IIS\) の管理ガイドを参照して、処理できる拡張子のリストを確認します。  
+  
+-   ログ ファイルのある場所への絶対パスを指定します。この場所は、部外者が Web ブラウザーを使用してアクセスできないように、Web ホストの vroot パブリック ディレクトリの外にします。  
+  
+ 既定では、キーおよびユーザー名やパスワードなどの個人を特定できる情報 \(PII\) は、トレースおよびログに記録するメッセージではありません。しかし、コンピューターの管理者は、Machine.config ファイルの `machineSettings` 要素にある `enableLoggingKnownPII` 属性を使用して、コンピューター上で実行されているアプリケーションに対し、既知の PII \(個人を特定できる情報\) のログ記録を許可できます。次の構成では、この設定方法について示します。  
+  
+```  
+<configuration>  
+   <system.serviceModel>  
+      <machineSettings enableLoggingKnownPii="true"/>  
+   </system.serviceModel>  
+</configuration>   
+```  
+  
+ アプリケーションを配置するユーザーが App.config ファイルか Web.config ファイルのいずれかで `logKnownPii` 属性を使用することで、PII ログを可能にする方法を次に示します。  
+  
+```  
+<system.diagnostics>  
+  <sources>  
+      <source name="System.ServiceModel.MessageLogging"  
+        logKnownPii="true">  
+        <listeners>  
+                 <add name="messages"  
+                 type="System.Diagnostics.XmlWriterTraceListener"  
+                 initializeData="c:\logs\messages.svclog" />  
+          </listeners>  
+      </source>  
+    </sources>  
+</system.diagnostics>  
+```  
+  
+ 両方の設定が `true` の場合にのみ、PII はログに記録されます。2 種類のスイッチを組み合わせることで、各アプリケーションで既知の PII のログを柔軟に記録できるようになります。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] では、PII ログ記録を有効にするには、Web.config ファイルまたは App.config ファイルで `logEntireMessage` フラグと `logKnownPii` フラグを `true` に設定する必要があります。`<system.serviceModel><messageLogging logEntireMessage="true" logKnownPii="true" …` のように設定します。  
+  
+ 構成ファイルで 2 種類以上のカスタム ソースを指定しても、最初のソースの属性のみが読み込まれることに注意してください。他の属性は無視されます。つまり、2 番目以降の App.config ファイルでは、PII はいずれのソースでもログに記録されなくなります。これは 2 番目のソースで PII のログ記録を明示的に有効にした場合でも同様です。  
+  
+```  
+<system.diagnostics>  
+   <sources>  
+      <source name="System.ServiceModel.MessageLogging"  
+              logKnownPii="false">  
+              <listeners>  
+                 <add name="messages"  
+                      type="System.Diagnostics.XmlWriterTraceListener"  
+                      initializeData="c:\logs\messages.svclog" />  
+              </listeners>  
+            </source>  
+      <source name="System.ServiceModel"   
+              logKnownPii="true">  
+              <listeners>  
+                 <add name="traces"  
+                      type="System.Diagnostics.XmlWriterTraceListener"  
+                      initializeData="c:\logs\traces.svclog" />  
+              </listeners>  
+      </source>  
+   </sources>  
+</system.diagnostics>  
+```  
+  
+ `<machineSettings enableLoggingKnownPii="Boolean"/>` の要素が Machine.config ファイルに含まれていない場合、システムは <xref:System.Configuration.ConfigurationErrorsException> をスローします。  
+  
+ 変更点はアプリケーションが開始されるか、再起動されるまで、反映されません。両方の属性も `true` に設定されている場合は、イベントは開始時にログに記録されます。また、`logKnownPii` が `true` に設定され、`enableLoggingKnownPii` が `false` に設定されている場合にも、イベントはログに記録されます。  
+  
+ コンピューターの管理者およびアプリケーションを配置するユーザーは、これらの 2 種類のスイッチを使用する場合に注意する必要があります。PII のログ記録が有効になっている場合は、セキュリティ キーと PII がログに記録されます。ログ記録を無効にしても、機密情報およびアプリケーション固有のデータは、依然としてメッセージのヘッダーと本体に記録されています。プライバシーと PII の公開を防止するための詳細な説明については、「[ユーザー プライバシー](http://go.microsoft.com/fwlink/?LinkID=94647)」を参照してください。  
+  
+> [!CAUTION]
+>  PII は無効なメッセージでは非表示になりません。このようなメッセージは、変更されずにそのままログに記録されます。上に示した属性は、このことに影響を与えません。  
+  
+### カスタム トレース リスナー  
+ カスタム トレース リスナーをメッセージ ログのトレース ソースに追加する権限は、管理者だけに付与する必要があります。これは、機密情報の漏洩につながるメッセージをリモートで送信するように、悪意のあるカスタム リスナーを構成することが可能なためです。また、ネットワークを介してリモート データベースなどにメッセージを送信するようにカスタム リスナーを構成している場合は、リモート コンピューター上のメッセージ ログに対する適切なアクセス制御を実施する必要があります。  
+  
+## メッセージ ログ記録でトリガーされるイベント  
+ メッセージ ログ記録で発生するすべてのイベントを以下に示します。  
+  
+-   Message logging on : このイベントは、メッセージ ログ記録が構成内で、または WMI を介して有効になっている場合に発生します。イベントの内容は "メッセージのログ記録が有効になりました。機密情報は、通信回線上で暗号化されていた場合でも平文で記録される可能性があります \(メッセージ本文など\)" となります。  
+  
+-   Message logging off : このイベントは、メッセージ ログ記録が WMI を介して無効になっている場合に発生します。イベントの内容は "メッセージのログ記録が無効になりました" となります。  
+  
+-   Log Known PII On : このイベントは、既知の PII のログ記録が有効になっている場合に発生します。これは、Machine.config ファイルの `machineSettings` 要素の `enableLoggingKnownPii` 属性が `true` に設定され、App.config または Web.config ファイルの `source` 要素の `logKnownPii` 属性が `true` に設定されている場合に発生します。  
+  
+-   Log Known PII Not Allowed : このイベントは既知の PII のログ記録が許可されていない場合に発生します。これは、App.config または Web.config ファイルの `source` 要素の `logKnownPii` 属性が `true` に設定されているのに、Machine.config ファイルの `machineSettings` 要素の `enableLoggingKnownPii` 属性が `false` に設定されている場合に発生します。例外はスローされません。  
+  
+ これらのイベントは、Windows に付属するイベント ビューアー ツールを使用して表示できます。詳細については、「[イベント ログ](../../../../docs/framework/wcf/diagnostics/event-logging/index.md)」を参照してください。  
+  
+## 参照  
+ [メッセージ ログ](../../../../docs/framework/wcf/diagnostics/message-logging.md)   
+ [トレースに関するセキュリティの考慮事項と役立つヒント](../../../../docs/framework/wcf/diagnostics/tracing/security-concerns-and-useful-tips-for-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/servicemodel-registration-tool.md b/docs/framework/wcf/diagnostics/servicemodel-registration-tool.md
new file mode 100644
index 00000000000..1c2488d3a9e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/servicemodel-registration-tool.md
@@ -0,0 +1,20 @@
+---
+title: "ServiceModel 登録ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 55204da3-fb36-4ab0-9d23-73e533ba8969
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ServiceModel 登録ツール
+ServiceModel 登録ツールは、単一のコンピューターで ServiceModel の登録を管理できるコマンド ライン ツールです。このツールの詳細については、「[ServiceModel 登録ツール \(ServiceModelReg.exe\)](../../../../docs/framework/wcf/servicemodelreg-exe.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/TOC.md b/docs/framework/wcf/diagnostics/tracing/TOC.md
new file mode 100644
index 00000000000..b2e65ce4ed3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/TOC.md
@@ -0,0 +1,421 @@
+# [System.ServiceModel.Security.SecurityIdentityHostNameNormalizationFailure](system-servicemodel-security-securityidentityhostnamenormalizationfailure.md)
+# [System.ServiceModel.EvaluationContextNotFound](system-servicemodel-evaluationcontextnotfound.md)
+# [System.ServiceModel.Channels.MsmqDetected](system-servicemodel-channels-msmqdetected.md)
+# [System.ServiceModel.Channels.EndpointListenerClose](system-servicemodel-channels-endpointlistenerclose.md)
+# [System.ServiceModel.Diagnostics.TraceHandledException](system-servicemodel-diagnostics-tracehandledexception.md)
+# [System.ServiceModel.Channels.PeerNodeOpenFailed](system-servicemodel-channels-peernodeopenfailed.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderBeginSecurityNegotiation](system-servicemodel-security-issuancetokenproviderbeginsecuritynegotiation.md)
+# [System.ServiceModel.Activation.WebHostServiceActivated](system-servicemodel-activation-webhostserviceactivated.md)
+# [System.ServiceModel.Activation.ServiceShutdown](system-servicemodel-activation-serviceshutdown.md)
+# [System.ServiceModel.Security.SecurityIdentityVerificationFailure](system-servicemodel-security-securityidentityverificationfailure.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationSuccess](system-servicemodel-comintegration-comintegrationinstancecreationsuccess.md)
+# [ユーザー コード トレースの出力](emitting-user-code-traces.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxCommitted](system-servicemodel-comintegration-comintegrationtxproxytxcommitted.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTLBImportStarting](system-servicemodel-comintegration-comintegrationtlbimportstarting.md)
+# [System.ServiceModel.Security.SecurityAuditWrittenFailure](system-servicemodel-security-securityauditwrittenfailure.md)
+# [System.IdentityModel.Selectors.StoreFailedToOpenStore](system-identitymodel-selectors-storefailedtoopenstore.md)
+# [エンドツーエンドのトレースのシナリオ](end-to-end-tracing-scenarios.md)
+# [伝達](propagation.md)
+# [System.ServiceModel.Security.SecurityActiveServerSessionRemoved](system-servicemodel-security-securityactiveserversessionremoved.md)
+# [エンドツーエンドのトレース](end-to-end-tracing.md)
+# [System.ServiceModel.Security.NegotiationTokenProviderAttached](system-servicemodel-security-negotiationtokenproviderattached.md)
+# [System.ServiceModel.ServiceThrottleLimitReached](system-servicemodel-servicethrottlelimitreached.md)
+# [System.Runtime.Serialization.XsdImportEnd](system-runtime-serialization-xsdimportend.md)
+# [System.Runtime.Serialization.XsdImportAnnotationFailed](system-runtime-serialization-xsdimportannotationfailed.md)
+# [System.ServiceModel.CommunicationObjectAbortFailed](system-servicemodel-communicationobjectabortfailed.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedService](system-servicemodel-comintegration-comintegrationservicehoststartedservice.md)
+# [System.ServiceModel.Channels.PeerNodeAuthenticationTimeout](system-servicemodel-channels-peernodeauthenticationtimeout.md)
+# [System.ServiceModel.Activation.ServiceStop](system-servicemodel-activation-servicestop.md)
+# [System.ServiceModel.Channels.MsmqPoolFull](system-servicemodel-channels-msmqpoolfull.md)
+# [System.ServiceModel.Channels.MsmqCannotReadQueues](system-servicemodel-channels-msmqcannotreadqueues.md)
+# [System.ServiceModel.PerformanceCountersFailedForService](system-servicemodel-performancecountersfailedforservice.md)
+# [System.ServiceModel.ExtensionCollectionIsEmpty](system-servicemodel-extensioncollectionisempty.md)
+# [System.ServiceModel.Channels.PeerMaintainerActivity](system-servicemodel-channels-peermaintaineractivity.md)
+# [System.ServiceModel.ConfiguredExtensionTypeNotFound](system-servicemodel-configuredextensiontypenotfound.md)
+# [System.ServiceModel.GetChannelEndpointElement](system-servicemodel-getchannelendpointelement.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderUsingCachedToken](system-servicemodel-security-issuancetokenproviderusingcachedtoken.md)
+# [System.ServiceModel.Activation.ServiceShutdownError](system-servicemodel-activation-serviceshutdownerror.md)
+# [System.ServiceModel.PerformanceCountersFailedOnRelease](system-servicemodel-performancecountersfailedonrelease.md)
+# [System.ServiceModel.Channels.PrematureDatagramEof](system-servicemodel-channels-prematuredatagrameof.md)
+# [System.ServiceModel.Activation.MessageQueueDuplicatedPipeError](system-servicemodel-activation-messagequeueduplicatedpipeerror.md)
+# [Microsoft.Transactions.TransactionBridge.RegisterCoordinator](microsoft-transactions-transactionbridge-registercoordinator.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTypedChannelBuilderLoaded](system-servicemodel-comintegration-comintegrationtypedchannelbuilderloaded.md)
+# [System.ServiceModel.Channels.TcpChannelMessageReceived](system-servicemodel-channels-tcpchannelmessagereceived.md)
+# [System.ServiceModel.Channels.HttpChannelUnexpectedResponse](system-servicemodel-channels-httpchannelunexpectedresponse.md)
+# [System.ServiceModel.Channels.MsmqDatagramSent](system-servicemodel-channels-msmqdatagramsent.md)
+# [System.ServiceModel.Channels.SystemTimeResolution](system-servicemodel-channels-systemtimeresolution.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationRequest](system-servicemodel-comintegration-comintegrationinstancecreationrequest.md)
+# [System.IdentityModel.Selectors.StoreCommitTransaction](system-identitymodel-selectors-storecommittransaction.md)
+# [System.ServiceModel.Security.SpnegoClientNegotiationCompleted](system-servicemodel-security-spnegoclientnegotiationcompleted.md)
+# [System.ServiceModel.PortSharing.TransportListenerSessionsReceived](system-servicemodel-portsharing-transportlistenersessionsreceived.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByContext](system-servicemodel-comintegration-comintegrationtxproxytxabortedbycontext.md)
+# [System.ServiceModel.Channels.PnrpUnregisteredAddresses](system-servicemodel-channels-pnrpunregisteredaddresses.md)
+# [System.ServiceModel.ExtensionElementAlreadyExistsInCollection](system-servicemodel-extensionelementalreadyexistsincollection.md)
+# [トレースの種類の概要](trace-type-summary.md)
+# [Microsoft.Transactions.TransactionBridge.ReplayMessageRetry](microsoft-transactions-transactionbridge-replaymessageretry.md)
+# [System.Runtime.Serialization.WriteObjectContentEnd](system-runtime-serialization-writeobjectcontentend.md)
+# [System.ServiceModel.Channels.ConnectToIPEndpoint](system-servicemodel-channels-connecttoipendpoint.md)
+# [System.IdentityModel.IdentityModelAsyncCallbackThrewException](system-identitymodel-identitymodelasynccallbackthrewexception.md)
+# [System.ServiceModel.GetConfiguredBinding](system-servicemodel-getconfiguredbinding.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromTypelib](system-servicemodel-comintegration-comintegrationtlbimportfromtypelib.md)
+# [System.ServiceModel.Security.SecurityImpersonationSuccess](system-servicemodel-security-securityimpersonationsuccess.md)
+# [System.ServiceModel.Security.SecuritySessionRenewFaultSendFailure](system-servicemodel-security-securitysessionrenewfaultsendfailure.md)
+# [System.ServiceModel.CommunicationObjectOpening](system-servicemodel-communicationobjectopening.md)
+# [System.ServiceModel.TxReleaseServiceInstanceOnCompletion](system-servicemodel-txreleaseserviceinstanceoncompletion.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFinished](system-servicemodel-comintegration-comintegrationtlbimportfinished.md)
+# [System.ServiceModel.Security.SecurityImpersonationFailure](system-servicemodel-security-securityimpersonationfailure.md)
+# [System.Runtime.Serialization.FactoryTypeNotFound](system-runtime-serialization-factorytypenotfound.md)
+# [転送](transfer.md)
+# [System.ServiceModel.AsyncCallbackThrewException](system-servicemodel-asynccallbackthrewexception.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethod](system-servicemodel-comintegration-comintegrationinvokingmethod.md)
+# [System.ServiceModel.PortSharing.PortSharingDupHandleGranted](system-servicemodel-portsharing-portsharingduphandlegranted.md)
+# [System.ServiceModel.SkipBehavior](system-servicemodel-skipbehavior.md)
+# [System.ServiceModel.Security.SecurityServerSessionRenewalFaultSent](system-servicemodel-security-securityserversessionrenewalfaultsent.md)
+# [System.ServiceModel.Diagnostics.FailedToReadAnActivityIdHeader](system-servicemodel-diagnostics-failedtoreadanactivityidheader.md)
+# [System.ServiceModel.Channels.HttpChannelConcurrentReceiveQuotaReached](system-servicemodel-channels-httpchannelconcurrentreceivequotareached.md)
+# [System.ServiceModel.GetDefaultConfiguredBinding](system-servicemodel-getdefaultconfiguredbinding.md)
+# [System.ServiceModel.Channels.StreamSecurityUpgradeAccepted](system-servicemodel-channels-streamsecurityupgradeaccepted.md)
+# [MSMQ](msmq.md)
+# [System.ServiceModel.Activation.MessageQueueRegisterFailed](system-servicemodel-activation-messagequeueregisterfailed.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedServiceDetails](ssc-comintegration.md)
+# [System.ServiceModel.Diagnostics.MessageCountLimitExceeded](microsoft-transactions-transactionbridge-registrationcoordinatorresponseinvalidmetadata.md)
+# [System.ServiceModel.Channels.MsmqMoveOrDeleteAttemptFailed](system-servicemodel-comintegration-comintegrationservicehostcreatedserviceendpoint.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartingService](system-servicemodel-comintegration-comintegrationservicehoststartingservice.md)
+# [System.Runtime.Serialization.XsdExportBegin](system-runtime-serialization-xsdexportbegin.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderRedirectApplied](system-servicemodel-security-issuancetokenproviderredirectapplied.md)
+# [System.ServiceModel.WsmexNonCriticalWsdlImportError](system-servicemodel-wsmexnoncriticalwsdlimporterror.md)
+# [System.ServiceModel.Channels.MsmqPoisonMessageMovedPoison](system-servicemodel-channels-msmqpoisonmessagemovedpoison.md)
+# [System.ServiceModel.Channels.FailedAcceptFromPool](system-servicemodel-channels-failedacceptfrompool.md)
+# [System.ServiceModel.Channels.ListenerCreated](system-servicemodel-channels-listenercreated.md)
+# [System.ServiceModel.Channels.HttpChannelRequestAborted](system-servicemodel-channels-httpchannelrequestaborted.md)
+# [System.ServiceModel.Diagnostics.AppDomainUnload](system-servicemodel-diagnostics-appdomainunload.md)
+# [System.ServiceModel.CommunicationObjectFaultReason](system-servicemodel-communicationobjectfaultreason.md)
+# [System.ServiceModel.Channels.InitiatingTcpConnection](system-servicemodel-channels-initiatingtcpconnection.md)
+# [System.ServiceModel.Channels.SslClientCertMissing](system-servicemodel-channels-sslclientcertmissing.md)
+# [System.IdentityModel.Selectors.StoreClosing](system-identitymodel-selectors-storeclosing.md)
+# [System.ServiceModel.Security.SecurityIdentityDeterminationSuccess](system-servicemodel-security-securityidentitydeterminationsuccess.md)
+# [アクティビティ ID の伝達](activity-id-propagation.md)
+# [System.ServiceModel.PortSharing.PortSharingDuplicatedPipe](system-servicemodel-portsharing-portsharingduplicatedpipe.md)
+# [System.ServiceModel.Channels.MsmqCannotPeekOnQueue](system-servicemodel-channels-msmqcannotpeekonqueue.md)
+# [System.ServiceModel.Activation.WebHostProtocolMisconfigured](system-servicemodel-activation-webhostprotocolmisconfigured.md)
+# [System.ServiceModel.Channels.NoExistingTransportManager](system-servicemodel-channels-noexistingtransportmanager.md)
+# [System.ServiceModel.Security.SecurityClientSessionKeyRenewed](system-servicemodel-security-securityclientsessionkeyrenewed.md)
+# [System.ServiceModel.Channels.MsmqDatagramReceived](system-servicemodel-channels-msmqdatagramreceived.md)
+# [System.ServiceModel.Channels.EndpointListenerOpen](system-servicemodel-channels-endpointlisteneropen.md)
+# [System.IdentityModel.Selectors.StoreDeleting](system-identitymodel-selectors-storedeleting.md)
+# [System.ServiceModel.Channels.PeerNeighborMessageReceived](system-servicemodel-channels-peerneighbormessagereceived.md)
+# [System.ServiceModel.GetBehaviorElement](system-servicemodel-getbehaviorelement.md)
+# [System.ServiceModel.Security.SecurityTokenAuthenticatorOpened](system-servicemodel-security-securitytokenauthenticatoropened.md)
+# [トレースとメッセージ ログの推奨設定](recommended-settings-for-tracing-and-message-logging.md)
+# [System.Runtime.Serialization.XsdImportBegin](system-runtime-serialization-xsdimportbegin.md)
+# [System.ServiceModel.Security.ServiceSecurityNegotiationCompleted](system-servicemodel-security-servicesecuritynegotiationcompleted.md)
+# [System.ServiceModel.Security.SecuritySessionRequestorOperationFailure](system-servicemodel-security-securitysessionrequestoroperationfailure.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppedService](system-servicemodel-comintegration-comintegrationservicehoststoppedservice.md)
+# [Microsoft.Transactions.TransactionBridge.CreateTransactionFailure](microsoft-transactions-transactionbridge-createtransactionfailure.md)
+# [System.ServiceModel.Activation.MessageQueueUnregisterSucceeded](system-servicemodel-activation-messagequeueunregistersucceeded.md)
+# [System.ServiceModel.Security.SecurityClientSessionCloseResponseSent](system-servicemodel-security-securityclientsessioncloseresponsesent.md)
+# [System.ServiceModel.Channels.PeerNodeClosed](system-servicemodel-channels-peernodeclosed.md)
+# [System.ServiceModel.PortSharing.ReadNetTcpConfig](system-servicemodel-portsharing-readnettcpconfig.md)
+# [System.ServiceModel.MessageClosed](system-servicemodel-messageclosed.md)
+# [System.ServiceModel.Channels.MsmqUnexpectedAcknowledgment](system-servicemodel-channels-msmqunexpectedacknowledgment.md)
+# [Microsoft.Transactions.TransactionBridge.ParticipantRecovered](microsoft-transactions-transactionbridge-participantrecovered.md)
+# [トレースの参照](traces-reference.md)
+# [System.ServiceModel.TxAsyncAbort](system-servicemodel-txasyncabort.md)
+# [System.ServiceModel.PortSharing.RoutingTableUnsupportedProtocol](system-servicemodel-portsharing-routingtableunsupportedprotocol.md)
+# [System.ServiceModel.Security.SecurityIdentityDeterminationFailure](system-servicemodel-security-securityidentitydeterminationfailure.md)
+# [System.ServiceModel.Channels.ConnectionPoolLeaseTimeoutReached](system-servicemodel-channels-connectionpoolleasetimeoutreached.md)
+# [System.ServiceModel.RemoveBehavior](system-servicemodel-removebehavior.md)
+# [System.ServiceModel.Security.SecurityBindingSecureOutgoingMessageFailure](system-servicemodel-security-securitybindingsecureoutgoingmessagefailure.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromAssembly](system-servicemodel-comintegration-comintegrationtlbimportfromassembly.md)
+# [System.ServiceModel.WsmexNonCriticalWsdlExportError](system-servicemodel-wsmexnoncriticalwsdlexporterror.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationEnteringActivity](system-servicemodel-comintegration-comintegrationenteringactivity.md)
+# [Microsoft.Transactions.TransactionBridge.EnlistTransaction](microsoft-transactions-transactionbridge-enlisttransaction.md)
+# [System.ServiceModel.MetadataExchangeClientSendRequest](system-servicemodel-metadataexchangeclientsendrequest.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTLBImportConverterEvent](system-servicemodel-comintegration-comintegrationtlbimportconverterevent.md)
+# [System.Runtime.Serialization.WriteObjectContentBegin](system-runtime-serialization-writeobjectcontentbegin.md)
+# [System.ServiceModel.Security.SecuritySessionServerCloseSendFailure](system-servicemodel-security-securitysessionserverclosesendfailure.md)
+# [System.ServiceModel.Channels.PeerFlooderReceiveMessageQuotaExceeded](system-servicemodel-channels-peerflooderreceivemessagequotaexceeded.md)
+# [System.ServiceModel.Security.SecurityTokenProviderOpened](system-servicemodel-security-securitytokenprovideropened.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationWsdlChannelBuilderLoaded](system-servicemodel-comintegration-comintegrationwsdlchannelbuilderloaded.md)
+# [System.ServiceModel.Channels.PnrpRegisteredAddresses](system-servicemodel-channels-pnrpregisteredaddresses.md)
+# [System.ServiceModel.Channels.PeerNeighborManagerOnline](system-servicemodel-channels-peerneighbormanageronline.md)
+# [System.ServiceModel.CommunicationObjectDisposing](system-servicemodel-communicationobjectdisposing.md)
+# [System.ServiceModel.Channels.PeerChannelMessageReceived](system-servicemodel-channels-peerchannelmessagereceived.md)
+# [System.ServiceModel.ServiceOperationExceptionOnReply](system-servicemodel-serviceoperationexceptiononreply.md)
+# [System.ServiceModel.Channels.MsmqSessiongramSent](system-servicemodel-channels-msmqsessiongramsent.md)
+# [System.ServiceModel.Channels.RequestContextAbort](system-servicemodel-channels-requestcontextabort.md)
+# [System.ServiceModel.Security.SecuritySessionRedirectApplied](system-servicemodel-security-securitysessionredirectapplied.md)
+# [System.ServiceModel.Channels.HttpsClientCertificateNotPresent](system-servicemodel-channels-httpsclientcertificatenotpresent.md)
+# [System.ServiceModel.Channels.PeerServiceOpened](system-servicemodel-channels-peerserviceopened.md)
+# [System.ServiceModel.UnhandledExceptionInUserOperation](system-servicemodel-unhandledexceptioninuseroperation.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting](system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderRemovedCachedToken](system-servicemodel-security-issuancetokenproviderremovedcachedtoken.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopping](system-servicemodel-comintegration-comintegrationdllhostinitializerstopping.md)
+# [Microsoft.Transactions.TransactionBridge.PrepareMessageRetry](microsoft-transactions-transactionbridge-preparemessageretry.md)
+# [Microsoft.Transactions.TransactionBridge.ProtocolStarted](microsoft-transactions-transactionbridge-protocolstarted.md)
+# [System.ServiceModel.Security.SecuritySessionClosedResponseReceived](system-servicemodel-security-securitysessionclosedresponsereceived.md)
+# [System.ServiceModel.Channels.PeerFloodedMessageNotPropagated](system-servicemodel-channels-peerfloodedmessagenotpropagated.md)
+# [System.IdentityModel.Selectors.StoreLoading](system-identitymodel-selectors-storeloading.md)
+# [System.ServiceModel.PerformanceCountersFailedDuringUpdate](system-servicemodel-performancecountersfailedduringupdate.md)
+# [System.ServiceModel.PortSharing.ReadNetPipeConfig](system-servicemodel-portsharing-readnetpipeconfig.md)
+# [System.ServiceModel.Activation.MessageQueueRegisterSucceeded](system-servicemodel-activation-messagequeueregistersucceeded.md)
+# [Microsoft.Transactions.TransactionBridge.CoordinatorRecovered](microsoft-transactions-transactionbridge-coordinatorrecovered.md)
+# [System.ServiceModel.UnhandledAction](system-servicemodel-unhandledaction.md)
+# [System.ServiceModel.Security.SecuritySessionAbortedFaultReceived](system-servicemodel-security-securitysessionabortedfaultreceived.md)
+# [System.ServiceModel.ConfigurationIsReadOnly](system-servicemodel-configurationisreadonly.md)
+# [System.ServiceModel.TransportListen](system-servicemodel-transportlisten.md)
+# [System.ServiceModel.Channels.MsmqPotentiallyPoisonMessageDetected](system-servicemodel-channels-msmqpotentiallypoisonmessagedetected.md)
+# [System.ServiceModel.DidNotUnderstandMessageHeader](system-servicemodel-didnotunderstandmessageheader.md)
+# [HTTP、TCP、または名前付きパイプを使用した非同期シナリオ](asynchronous-scenarios-using-http-tcp-or-named-pipe.md)
+# [System.ServiceModel.Security.SecurityBindingVerifyIncomingMessageFailure](system-servicemodel-security-securitybindingverifyincomingmessagefailure.md)
+# [System.ServiceModel.ServiceHostBaseAddresses](system-servicemodel-servicehostbaseaddresses.md)
+# [System.ServiceModel.Channels.HttpAuthFailed](system-servicemodel-channels-httpauthfailed.md)
+# [System.ServiceModel.DroppedAMessage](system-servicemodel-droppedamessage.md)
+# [System.ServiceModel.Security.SecurityServerSessionAbortedFaultSent](system-servicemodel-security-securityserversessionabortedfaultsent.md)
+# [System.ServiceModel.Diagnostics.ActivityBoundary](system-servicemodel-diagnostics-activityboundary.md)
+# [System.ServiceModel.Security.ImportSecurityChannelBindingExit](system-servicemodel-security-importsecuritychannelbindingexit.md)
+# [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorResponseInvalidMetadata](mts-registrationcoordinatorresponseinvalidmetadata.md)
+# [System.ServiceModel.Security.SecurityTokenAuthenticatorClosed](system-servicemodel-security-securitytokenauthenticatorclosed.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByTM](system-servicemodel-comintegration-comintegrationtxproxytxabortedbytm.md)
+# [System.ServiceModel.Channels.HttpChannelMessageReceiveFailed](system-servicemodel-channels-httpchannelmessagereceivefailed.md)
+# [System.ServiceModel.Channels.MessageReceived](system-servicemodel-channels-messagereceived.md)
+# [System.ServiceModel.Channels.MsmqMessageRejected](system-servicemodel-channels-msmqmessagerejected.md)
+# [System.ServiceModel.ManualFlowThrottleLimitReached](system-servicemodel-manualflowthrottlelimitreached.md)
+# [System.ServiceModel.Security.SecuritySessionResponderOperationFailure](system-servicemodel-security-securitysessionresponderoperationfailure.md)
+# [System.ServiceModel.Channels.FailedPipeConnect](system-servicemodel-channels-failedpipeconnect.md)
+# [Microsoft.Transactions.TransactionBridge.RecoveredCoordinatorInvalidMetadata](microsoft-transactions-transactionbridge-recoveredcoordinatorinvalidmetadata.md)
+# [System.IdentityModel.AuthorizationPolicyEvaluated](system-identitymodel-authorizationpolicyevaluated.md)
+# [System.ServiceModel.Activation.MessageQueueDuplicatedPipe](system-servicemodel-activation-messagequeueduplicatedpipe.md)
+# [System.ServiceModel.Security.SecurityTokenProviderClosed](system-servicemodel-security-securitytokenproviderclosed.md)
+# [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFailed](microsoft-transactions-transactionbridge-registrationcoordinatorfailed.md)
+# [System.Runtime.Serialization.XsdExportDupItems](system-runtime-serialization-xsdexportdupitems.md)
+# [System.ServiceModel.Channels.PeerNeighborStateChangeFailed](system-servicemodel-channels-peerneighborstatechangefailed.md)
+# [System.ServiceModel.Channels.PeerNeighborStateChanged](system-servicemodel-channels-peerneighborstatechanged.md)
+# [System.ServiceModel.CommunicationObjectClosed](system-servicemodel-communicationobjectclosed.md)
+# [System.Runtime.Serialization.XsdExportAnnotationFailed](system-runtime-serialization-xsdexportannotationfailed.md)
+# [System.ServiceModel.Activation.MessageQueueClosed](system-servicemodel-activation-messagequeueclosed.md)
+# [System.IdentityModel.Selectors.StoreSignatureNotValid](system-identitymodel-selectors-storesignaturenotvalid.md)
+# [System.ServiceModel.PortSharing.PortSharingClosed](system-servicemodel-portsharing-portsharingclosed.md)
+# [System.ServiceModel.CommunicationObjectOpenFailed](system-servicemodel-communicationobjectopenfailed.md)
+# [System.ServiceModel.Diagnostics.DiagnosticsFailedMessageTrace](system-servicemodel-diagnostics-diagnosticsfailedmessagetrace.md)
+# [System.ServiceModel.Security.SecurityPendingServerSessionActivated](system-servicemodel-security-securitypendingserversessionactivated.md)
+# [System.ServiceModel.Channels.MsmqMessageDropped](system-servicemodel-channels-msmqmessagedropped.md)
+# [System.ServiceModel.Diagnostics.MessageNotLoggedQuotaExceeded](system-servicemodel-diagnostics-messagenotloggedquotaexceeded.md)
+# [System.ServiceModel.PortSharing.WasConnected](system-servicemodel-portsharing-wasconnected.md)
+# [System.ServiceModel.TxCompletionStatusCompletedForError](system-servicemodel-txcompletionstatuscompletedforerror.md)
+# [System.ServiceModel.UnderstoodMessageHeader](system-servicemodel-understoodmessageheader.md)
+# [System.ServiceModel.CommunicationObjectAborted](system-servicemodel-communicationobjectaborted.md)
+# [System.ServiceModel.ServiceHostTimeoutOnClose](system-servicemodel-servicehosttimeoutonclose.md)
+# [System.ServiceModel.Activation.MessageQueueRegisterCalled](system-servicemodel-activation-messagequeueregistercalled.md)
+# [System.ServiceModel.PortSharing.TransportListenerListening](system-servicemodel-portsharing-transportlistenerlistening.md)
+# [System.ServiceModel.Security.SecurityServerSessionCloseResponseReceived](system-servicemodel-security-securityserversessioncloseresponsereceived.md)
+# [トレースに関するセキュリティの考慮事項と役立つヒント](security-concerns-and-useful-tips-for-tracing.md)
+# [Microsoft.Transactions.TransactionBridge.RegisterParticipant](microsoft-transactions-transactionbridge-registerparticipant.md)
+# [System.ServiceModel.Channels.HttpsClientCertificateInvalid](system-servicemodel-channels-httpsclientcertificateinvalid.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInvokedMethod](system-servicemodel-comintegration-comintegrationinvokedmethod.md)
+# [System.ServiceModel.Security.SecuritySessionKeyRenewalFaultReceived](system-servicemodel-security-securitysessionkeyrenewalfaultreceived.md)
+# [System.ServiceModel.Security.SpnegoServiceNegotiationCompleted](system-servicemodel-security-spnegoservicenegotiationcompleted.md)
+# [System.ServiceModel.Channels.ConnectionPoolCloseException](system-servicemodel-channels-connectionpoolcloseexception.md)
+# [トレースの構成](configuring-tracing.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceMonikerParsed](system-servicemodel-comintegration-comintegrationservicemonikerparsed.md)
+# [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFaulted](microsoft-transactions-transactionbridge-registrationcoordinatorfaulted.md)
+# [System.ServiceModel.GetServiceElement](system-servicemodel-getserviceelement.md)
+# [System.ServiceModel.PortSharing.PortSharingDuplicatedSocket](system-servicemodel-portsharing-portsharingduplicatedsocket.md)
+# [System.ServiceModel.PortSharing.RoutingTableRegisterSuccess](system-servicemodel-portsharing-routingtableregistersuccess.md)
+# [HTTP、TCP、または名前付きパイプを使用した同期シナリオ](synchronous-scenarios-using-http-tcp-or-named-pipe.md)
+# [System.ServiceModel.TxCompletionStatusAbortedOnSessionClose](system-servicemodel-txcompletionstatusabortedonsessionclose.md)
+# [System.ServiceModel.Security.SecuritySessionAbortedFaultSendFailure](system-servicemodel-security-securitysessionabortedfaultsendfailure.md)
+# [System.ServiceModel.OverridingDuplicateConfigurationKey](system-servicemodel-overridingduplicateconfigurationkey.md)
+# [System.ServiceModel.FailedToOpenIncomingChannel](system-servicemodel-failedtoopenincomingchannel.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationChannelCreated](system-servicemodel-comintegration-comintegrationchannelcreated.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDispatchMethod](system-servicemodel-comintegration-comintegrationdispatchmethod.md)
+# [System.ServiceModel.Channels.PeerChannelMessageSent](system-servicemodel-channels-peerchannelmessagesent.md)
+# [System.ServiceModel.TxCompletionStatusCompletedForAutocomplete](system-servicemodel-txcompletionstatuscompletedforautocomplete.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceEndpoint](ssc--comintegrationservicehostcreatedserviceendpoint.md)
+# [System.Runtime.Serialization.ElementIgnored](system-runtime-serialization-elementignored.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppingService](system-servicemodel-comintegration-comintegrationservicehoststoppingservice.md)
+# [System.ServiceModel.CannotBeImportedInCurrentFormat](system-servicemodel-cannotbeimportedincurrentformat.md)
+# [System.ServiceModel.Channels.PeerFloodedMessageReceived](system-servicemodel-channels-peerfloodedmessagereceived.md)
+# [System.ServiceModel.PerformanceCounterFailedToLoad](system-servicemodel-performancecounterfailedtoload.md)
+# [System.ServiceModel.Channels.PeerNeighborNotAccepted](system-servicemodel-channels-peerneighbornotaccepted.md)
+# [System.ServiceModel.Channels.MsmqStartingApplication](system-servicemodel-channels-msmqstartingapplication.md)
+# [トレースを使用したアプリケーションのトラブルシューティング](using-tracing-to-troubleshoot-your-application.md)
+# [System.ServiceModel.Channels.ListenerDisposed](system-servicemodel-channels-listenerdisposed.md)
+# [System.ServiceModel.Security.SecuritySessionDemuxFailure](system-servicemodel-security-securitysessiondemuxfailure.md)
+# [Microsoft.Transactions.TransactionBridge.EnlistmentIdentityCheckFailed](microsoft-transactions-transactionbridge-enlistmentidentitycheckfailed.md)
+# [System.ServiceModel.PortSharing.TransportListenerStop](system-servicemodel-portsharing-transportlistenerstop.md)
+# [System.ServiceModel.ServiceOperationMissingReply](system-servicemodel-serviceoperationmissingreply.md)
+# [System.ServiceModel.Channels.MsmqStartingService](system-servicemodel-channels-msmqstartingservice.md)
+# [System.ServiceModel.Security.ExportSecurityChannelBindingExit](system-servicemodel-security-exportsecuritychannelbindingexit.md)
+# [System.ServiceModel.Security.SecuritySessionServerCloseSent](system-servicemodel-security-securitysessionserverclosesent.md)
+# [System.ServiceModel.Channels.SocketConnectionCreate](system-servicemodel-channels-socketconnectioncreate.md)
+# [アクティビティ](activity.md)
+# [System.ServiceModel.PortSharing.RoutingTablePathTooLong](system-servicemodel-portsharing-routingtablepathtoolong.md)
+# [System.ServiceModel.TxSourceTxScopeRequiredIsTransactedTransport](system-servicemodel-txsourcetxscoperequiredistransactedtransport.md)
+# [System.ServiceModel.PortSharing.TransportListenerListenRequest](system-servicemodel-portsharing-transportlistenerlistenrequest.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopped](system-servicemodel-comintegration-comintegrationdllhostinitializerstopped.md)
+# [System.ServiceModel.Security.SecurityClientSessionCloseSent](system-servicemodel-security-securityclientsessionclosesent.md)
+# [メッセージ セキュリティにおけるアクティビティ トレース](activity-tracing-in-message-security.md)
+# [System.ServiceModel.Diagnostics.UnhandledException](system-servicemodel-diagnostics-unhandledexception.md)
+# [System.ServiceModel.ExtensionCollectionNameNotFound](system-servicemodel-extensioncollectionnamenotfound.md)
+# [System.ServiceModel.Security.SecurityIdentityVerificationSuccess](system-servicemodel-security-securityidentityverificationsuccess.md)
+# [System.ServiceModel.Channels.MsmqSessiongramReceived](system-servicemodel-channels-msmqsessiongramreceived.md)
+# [COM+](com.md)
+# [System.ServiceModel.Security.SecurityInactiveSessionFaulted](system-servicemodel-security-securityinactivesessionfaulted.md)
+# [System.ServiceModel.Channels.ChannelCreated](system-servicemodel-channels-channelcreated.md)
+# [System.ServiceModel.Activation.WebHostDebugRequest](system-servicemodel-activation-webhostdebugrequest.md)
+# [System.ServiceModel.Diagnostics.TraceTruncatedQuotaExceeded](system-servicemodel-diagnostics-tracetruncatedquotaexceeded.md)
+# [System.ServiceModel.Channels.RequestChannelReplyReceived](system-servicemodel-channels-requestchannelreplyreceived.md)
+# [System.ServiceModel.ExtensionCollectionDoesNotExist](system-servicemodel-extensioncollectiondoesnotexist.md)
+# [System.ServiceModel.Channels.MaxPendingConnectionsReached](system-servicemodel-channels-maxpendingconnectionsreached.md)
+# [System.IdentityModel.Selectors.GeneralInformation](system-identitymodel-selectors-generalinformation.md)
+# [System.ServiceModel.TxCompletionStatusRemainsAttached](system-servicemodel-txcompletionstatusremainsattached.md)
+# [System.ServiceModel.CommunicationObjectCloseFailed](system-servicemodel-communicationobjectclosefailed.md)
+# [System.ServiceModel.Diagnostics.EventLog](system-servicemodel-diagnostics-eventlog.md)
+# [System.ServiceModel.Channels.SocketConnectionAbort](system-servicemodel-channels-socketconnectionabort.md)
+# [System.ServiceModel.MessageWritten](system-servicemodel-messagewritten.md)
+# [System.ServiceModel.Diagnostics.ThrowingException](system-servicemodel-diagnostics-throwingexception.md)
+# [Microsoft.Transactions.TransactionBridge.RecoveredParticipantInvalidMetadata](microsoft-transactions-transactionbridge-recoveredparticipantinvalidmetadata.md)
+# [System.ServiceModel.Activation.MessageQueueDuplicatedSocketError](system-servicemodel-activation-messagequeueduplicatedsocketerror.md)
+# [System.ServiceModel.Channels.MsmqPoisonMessageMovedRetry](system-servicemodel-channels-msmqpoisonmessagemovedretry.md)
+# [System.ServiceModel.Channels.MsmqEnteredBatch](system-servicemodel-channels-msmqenteredbatch.md)
+# [System.ServiceModel.Security.SecurityBindingOutgoingMessageSecured](system-servicemodel-security-securitybindingoutgoingmessagesecured.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceContract](ssc-comintegrationservicehostcreatedservicecontract.md)
+# [System.ServiceModel.Channels.MsmqMessageLockedUnderTheTransaction](system-servicemodel-channels-msmqmessagelockedunderthetransaction.md)
+# [System.ServiceModel.ServiceHostErrorOnReleasePerformanceCounter](system-servicemodel-servicehosterroronreleaseperformancecounter.md)
+# [System.ServiceModel.ServiceHostFaulted](system-servicemodel-servicehostfaulted.md)
+# [System.Runtime.Serialization.WriteObjectEnd](system-runtime-serialization-writeobjectend.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderServiceTokenCacheFull](system-servicemodel-security-issuancetokenproviderservicetokencachefull.md)
+# [System.Runtime.Serialization.ObjectWithLargeDepth](system-runtime-serialization-objectwithlargedepth.md)
+# [System.ServiceModel.MessageRead](system-servicemodel-messageread.md)
+# [System.ServiceModel.Channels.PnrpResolvedAddresses](system-servicemodel-channels-pnrpresolvedaddresses.md)
+# [クライアントでのデバッグ](debugging-on-the-client.md)
+# [System.ServiceModel.PortSharing.RoutingTableNamespaceConflict](system-servicemodel-portsharing-routingtablenamespaceconflict.md)
+# [System.ServiceModel.Channels.MsmqScanStarted](system-servicemodel-channels-msmqscanstarted.md)
+# [アクティビティ リスト](activity-list.md)
+# [Microsoft.Transactions.TransactionBridge.ParticipantStateMachineFinished](microsoft-transactions-transactionbridge-participantstatemachinefinished.md)
+# [System.ServiceModel.Channels.MsmqFoundBaseAddress](system-servicemodel-channels-msmqfoundbaseaddress.md)
+# [System.ServiceModel.Channels.IncompatibleExistingTransportManager](system-servicemodel-channels-incompatibleexistingtransportmanager.md)
+# [System.ServiceModel.Channels.SocketConnectionClose](system-servicemodel-channels-socketconnectionclose.md)
+# [System.ServiceModel.Channels.MsmqQueueClosed](system-servicemodel-channels-msmqqueueclosed.md)
+# [System.ServiceModel.PortSharing.RoutingTableLookup](system-servicemodel-portsharing-routingtablelookup.md)
+# [System.ServiceModel.Channels.PeerNodeOpened](system-servicemodel-channels-peernodeopened.md)
+# [System.ServiceModel.Security.SecuritySessionCloseResponseSent](system-servicemodel-security-securitysessioncloseresponsesent.md)
+# [System.ServiceModel.Activation.MessageQueueDuplicatedSocket](system-servicemodel-activation-messagequeueduplicatedsocket.md)
+# [System.ServiceModel.CommunicationObjectCreated](system-servicemodel-communicationobjectcreated.md)
+# [System.ServiceModel.Channels.SocketConnectionAbortClose](system-servicemodel-channels-socketconnectionabortclose.md)
+# [System.ServiceModel.PortSharing.RoutingTableCannotListen](system-servicemodel-portsharing-routingtablecannotlisten.md)
+# [Microsoft.Transactions.TransactionBridge.CommitMessageRetry](microsoft-transactions-transactionbridge-commitmessageretry.md)
+# [System.ServiceModel.ErrorInvokingUserCode](system-servicemodel-errorinvokingusercode.md)
+# [System.ServiceModel.GetConfigurationSection](system-servicemodel-getconfigurationsection.md)
+# [System.ServiceModel.Channels.PeerNodeClosing](system-servicemodel-channels-peernodeclosing.md)
+# [System.ServiceModel.Channels.OpenedListener](system-servicemodel-channels-openedlistener.md)
+# [System.ServiceModel.Security.SecurityContextTokenCacheFull](system-servicemodel-security-securitycontexttokencachefull.md)
+# [System.ServiceModel.Security.SecuritySpnToSidMappingFailure](system-servicemodel-security-securityspntosidmappingfailure.md)
+# [System.ServiceModel.Channels.MessageSent](system-servicemodel-channels-messagesent.md)
+# [System.ServiceModel.Security.IssuanceTokenProviderEndSecurityNegotiation](system-servicemodel-security-issuancetokenproviderendsecuritynegotiation.md)
+# [System.ServiceModel.Channels.PeerFloodedMessageNotMatched](system-servicemodel-channels-peerfloodedmessagenotmatched.md)
+# [System.ServiceModel.CommunicationObjectOpened](system-servicemodel-communicationobjectopened.md)
+# [System.ServiceModel.Channels.PeerReceiveMessageAuthenticationFailure](system-servicemodel-channels-peerreceivemessageauthenticationfailure.md)
+# [System.ServiceModel.TxSourceTxScopeRequiredIsTransactionFlow](system-servicemodel-txsourcetxscoperequiredistransactionflow.md)
+# [System.ServiceModel.Channels.MsmqMatchedApplicationFound](system-servicemodel-channels-msmqmatchedapplicationfound.md)
+# [System.ServiceModel.Security.SecurityBindingIncomingMessageVerified](system-servicemodel-security-securitybindingincomingmessageverified.md)
+# [System.ServiceModel.TxSourceTxScopeRequiredIsAttachedTransaction](system-servicemodel-txsourcetxscoperequiredisattachedtransaction.md)
+# [重要なトレース](significant-traces.md)
+# [System.Runtime.Serialization.XsdExportEnd](system-runtime-serialization-xsdexportend.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerAddingHost](system-servicemodel-comintegration-comintegrationdllhostinitializeraddinghost.md)
+# [System.ServiceModel.MessageCopied](system-servicemodel-messagecopied.md)
+# [System.ServiceModel.TxFailedToNegotiateOleTx](system-servicemodel-txfailedtonegotiateoletx.md)
+# [Microsoft.Transactions.TransactionBridge.VolatileParticipantInDoubt](microsoft-transactions-transactionbridge-volatileparticipantindoubt.md)
+# [System.ServiceModel.Activation.WebHostServiceCloseFailed](system-servicemodel-activation-webhostserviceclosefailed.md)
+# [System.ServiceModel.PerformanceCountersFailed](system-servicemodel-performancecountersfailed.md)
+# [System.ServiceModel.Activation.ServicePause](system-servicemodel-activation-servicepause.md)
+# [Microsoft.Transactions.TransactionBridge.RegisterParticipantFailure](microsoft-transactions-transactionbridge-registerparticipantfailure.md)
+# [System.ServiceModel.Channels.PnrpResolveException](system-servicemodel-channels-pnrpresolveexception.md)
+# [System.Runtime.Serialization.XsdExportError](system-runtime-serialization-xsdexporterror.md)
+# [System.IdentityModel.AuthorizationContextCreated](system-identitymodel-authorizationcontextcreated.md)
+# [System.ServiceModel.Activation.ServiceContinue](system-servicemodel-activation-servicecontinue.md)
+# [System.ServiceModel.MessageProcessingPaused](system-servicemodel-messageprocessingpaused.md)
+# [System.ServiceModel.Channels.ConnectionAbandoned](system-servicemodel-channels-connectionabandoned.md)
+# [System.ServiceModel.Activation.WebHostCompilation](system-servicemodel-activation-webhostcompilation.md)
+# [System.ServiceModel.Security.SecurityClientSessionPreviousKeyDiscarded](system-servicemodel-security-securityclientsessionpreviouskeydiscarded.md)
+# [System.ServiceModel.Security.SecuritySessionRequestorOperationSuccess](system-servicemodel-security-securitysessionrequestoroperationsuccess.md)
+# [System.ServiceModel.Administration.WmiPut](system-servicemodel-administration-wmiput.md)
+# [System.ServiceModel.PortSharing.WasWebHostAPIFailed](system-servicemodel-portsharing-waswebhostapifailed.md)
+# [System.ServiceModel.Channels.HttpChannelResponseAborted](system-servicemodel-channels-httpchannelresponseaborted.md)
+# [System.ServiceModel.Security.SecurityNewServerSessionKeyIssued](system-servicemodel-security-securitynewserversessionkeyissued.md)
+# [System.ServiceModel.PortSharing.SharedManagerServiceEndpointNotExist](system-servicemodel-portsharing-sharedmanagerserviceendpointnotexist.md)
+# [System.ServiceModel.BeginExecuteMethod](system-servicemodel-beginexecutemethod.md)
+# [Microsoft.Transactions.TransactionBridge.VolatileOutcomeTimeout](microsoft-transactions-transactionbridge-volatileoutcometimeout.md)
+# [System.ServiceModel.Security.SecurityClientSessionCloseMessageReceived](system-servicemodel-security-securityclientsessionclosemessagereceived.md)
+# [System.ServiceModel.CommunicationObjectClosing](system-servicemodel-communicationobjectclosing.md)
+# [System.ServiceModel.Diagnostics.FailedToAddAnActivityIdHeader](system-servicemodel-diagnostics-failedtoaddanactivityidheader.md)
+# [System.ServiceModel.Activation.ServiceStart](system-servicemodel-activation-servicestart.md)
+# [System.ServiceModel.Channels.MsmqLeftBatch](system-servicemodel-channels-msmqleftbatch.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationExecutingCall](system-servicemodel-comintegration-comintegrationexecutingcall.md)
+# [System.ServiceModel.Channels.MsmqQueueOpened](system-servicemodel-channels-msmqqueueopened.md)
+# [System.ServiceModel.Security.SecurityServerSessionKeyUpdated](system-servicemodel-security-securityserversessionkeyupdated.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationLeftActivity](system-servicemodel-comintegration-comintegrationleftactivity.md)
+# [トレース](index.md)
+# [System.Runtime.Serialization.XsdImportError](system-runtime-serialization-xsdimporterror.md)
+# [System.ServiceModel.PortSharing.WasCloseAllListenerChannelInstances](system-servicemodel-portsharing-wasclosealllistenerchannelinstances.md)
+# [System.ServiceModel.MetadataExchangeClientReceiveReply](system-servicemodel-metadataexchangeclientreceivereply.md)
+# [System.ServiceModel.MessageClosedAgain](system-servicemodel-messageclosedagain.md)
+# [System.ServiceModel.Channels.InitiatingNamedPipeConnection](system-servicemodel-channels-initiatingnamedpipeconnection.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarted](system-servicemodel-comintegration-comintegrationdllhostinitializerstarted.md)
+# [System.ServiceModel.Channels.HttpResponseReceived](system-servicemodel-channels-httpresponsereceived.md)
+# [System.ServiceModel.Channels.TcpConnectError](system-servicemodel-channels-tcpconnecterror.md)
+# [System.ServiceModel.Channels.PipeConnectionAbort](system-servicemodel-channels-pipeconnectionabort.md)
+# [System.IdentityModel.Selectors.StoreBeginTransaction](system-identitymodel-selectors-storebegintransaction.md)
+# [Microsoft.Transactions.TransactionBridge.PreparedMessageRetry](microsoft-transactions-transactionbridge-preparedmessageretry.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInstanceReleased](system-servicemodel-comintegration-comintegrationinstancereleased.md)
+# [System.ServiceModel.Security.SecuritySessionClosedResponseSendFailure](system-servicemodel-security-securitysessionclosedresponsesendfailure.md)
+# [System.ServiceModel.GetCommonBehaviors](system-servicemodel-getcommonbehaviors.md)
+# [System.ServiceModel.Channels.NamedPipeChannelMessageReceiveFailed](system-servicemodel-channels-namedpipechannelmessagereceivefailed.md)
+# [System.ServiceModel.Security.NegotiationAuthenticatorAttached](system-servicemodel-security-negotiationauthenticatorattached.md)
+# [System.ServiceModel.TxCompletionStatusCompletedForSetComplete](system-servicemodel-txcompletionstatuscompletedforsetcomplete.md)
+# [System.ServiceModel.Security.SecurityPendingServerSessionClosed](system-servicemodel-security-securitypendingserversessionclosed.md)
+# [System.Runtime.Serialization.WriteObjectBegin](system-runtime-serialization-writeobjectbegin.md)
+# [System.ServiceModel.ServiceChannelLifetime](system-servicemodel-servicechannellifetime.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodContextTransaction](ssc-comintegrationinvokingmethodcontexttransaction.md)
+# [System.Runtime.Serialization.ReadObjectEnd](system-servicemodel-comintegration-comintegrationmexmonikermetadataexchangecomplete.md)
+# [Microsoft.Transactions.TransactionBridge.EnlistTransactionFailure](system-servicemodel-channels-connectionpoolmaxoutboundconnectionsperendpointquotareached.md)
+# [System.Runtime.Serialization.ReadObjectBegin](system-runtime-serialization-readobjectbegin.md)
+# [System.ServiceModel.Security.SecurityAuditWrittenSuccess](system-servicemodel-security-securityauditwrittensuccess.md)
+# [System.ServiceModel.WarnHelpPageEnabledNoBaseAddress](system-servicemodel-warnhelppageenablednobaseaddress.md)
+# [System.ServiceModel.Channels.MsmqQueueTransactionalStatusUnknown](system-servicemodel-channels-msmqqueuetransactionalstatusunknown.md)
+# [System.ServiceModel.Channels.ChannelDisposed](system-servicemodel-channels-channeldisposed.md)
+# [Microsoft.Transactions.TransactionBridge.CoordinatorStateMachineFinished](microsoft-transactions-transactionbridge-coordinatorstatemachinefinished.md)
+# [System.ServiceModel.Security.ImportSecurityChannelBindingEntry](system-servicemodel-security-importsecuritychannelbindingentry.md)
+# [Microsoft.Transactions.TransactionBridge.ProtocolInitialized](microsoft-transactions-transactionbridge-protocolinitialized.md)
+# [System.ServiceModel.Security.SecurityPendingServerSessionAdded](system-servicemodel-security-securitypendingserversessionadded.md)
+# [System.ServiceModel.Channels.PeerNeighborManagerOffline](system-servicemodel-channels-peerneighbormanageroffline.md)
+# [System.ServiceModel.TxCompletionStatusCompletedForAsyncAbort](system-servicemodel-txcompletionstatuscompletedforasyncabort.md)
+# [System.ServiceModel.Channels.PeerNodeAddressChanged](system-servicemodel-channels-peernodeaddresschanged.md)
+# [System.ServiceModel.CommunicationObjectFaulted](system-servicemodel-communicationobjectfaulted.md)
+# [System.ServiceModel.Channels.MaxAcceptedChannelsReached](system-servicemodel-channels-maxacceptedchannelsreached.md)
+# [System.ServiceModel.ServiceOperationMissingReplyContext](system-servicemodel-serviceoperationmissingreplycontext.md)
+# [System.ServiceModel.Channels.PeerNodeOpening](system-servicemodel-channels-peernodeopening.md)
+# [System.ServiceModel.Security.SecurityServerSessionCloseReceived](system-servicemodel-security-securityserversessionclosereceived.md)
+# [System.ServiceModel.Security.SecurityNegotiationProcessingFailure](system-servicemodel-security-securitynegotiationprocessingfailure.md)
+# [Microsoft.Transactions.TransactionBridge.DurableParticipantReplayWhilePreparing](mtt-durableparticipantreplaywhilepreparing.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationMexChannelBuilderLoaded](system-servicemodel-comintegration-comintegrationmexchannelbuilderloaded.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationMexMonikerMetadataExchangeComplete](ssc--comintegrationmexmonikermetadataexchangecomplete.md)
+# [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodNewTransaction](system-servicemodel-comintegration-comintegrationinvokingmethodnewtransaction.md)
+# [System.ServiceModel.EndExecuteMethod](system-servicemodel-endexecutemethod.md)
+# [System.ServiceModel.Channels.MsmqPoisonMessageRejected](system-servicemodel-channels-msmqpoisonmessagerejected.md)
+# [System.ServiceModel.Activation.ServiceStartPipeError](system-servicemodel-activation-servicestartpipeerror.md)
+# [System.ServiceModel.Channels.ConnectionPoolIdleTimeoutReached](system-servicemodel-channels-connectionpoolidletimeoutreached.md)
+# [System.ServiceModel.Channels.ServerMaxPooledConnectionsQuotaReached](system-servicemodel-channels-servermaxpooledconnectionsquotareached.md)
+# [System.ServiceModel.ElementTypeDoesntMatchConfiguredType](system-servicemodel-elementtypedoesntmatchconfiguredtype.md)
+# [System.ServiceModel.ServiceHostCreation](system-servicemodel-servicehostcreation.md)
+# [System.ServiceModel.Channels.PeerNodeAuthenticationFailure](system-servicemodel-channels-peernodeauthenticationfailure.md)
+# [System.ServiceModel.Channels.PeerNeighborNotFound](system-servicemodel-channels-peerneighbornotfound.md)
+# [System.IdentityModel.Selectors.StoreRollbackTransaction](system-identitymodel-selectors-storerollbacktransaction.md)
+# [System.ServiceModel.TxCompletionStatusCompletedForTACOSC](system-servicemodel-txcompletionstatuscompletedfortacosc.md)
+# [System.ServiceModel.Diagnostics.FilterNotMatchedNodeQuotaExceeded](system-servicemodel-diagnostics-filternotmatchednodequotaexceeded.md)
+# [System.ServiceModel.Channels.NamedPipeChannelMessageReceived](system-servicemodel-channels-namedpipechannelmessagereceived.md)
+# [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)
+# [System.ServiceModel.PortSharing.PortSharingListening](system-servicemodel-portsharing-portsharinglistening.md)
+# [System.ServiceModel.Security.ExportSecurityChannelBindingEntry](system-servicemodel-security-exportsecuritychannelbindingentry.md)
+# [System.ServiceModel.Channels.ConnectionPoolMaxOutboundConnectionsPerEndpointQuotaReached](connectionpoolmaxoutboundconnectionsperendpointquotareached.md)
diff --git a/docs/framework/wcf/diagnostics/tracing/activity-id-propagation.md b/docs/framework/wcf/diagnostics/tracing/activity-id-propagation.md
new file mode 100644
index 00000000000..006b83f1d65
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/activity-id-propagation.md
@@ -0,0 +1,55 @@
+---
+title: "アクティビティ ID の伝達 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd1c1ae5-cc8a-4f51-90c9-f7b476bcfe70
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# アクティビティ ID の伝達
+伝達は、ServiceModel アクティビティ トレースが有効な場合 \(ServiceModel 伝達\) または無効な場合 \(ユーザーからユーザーへのアクティビティ伝達\) に実行されます。  
+  
+## ServiceModel アクティビティ トレースが有効な場合  
+ ServiceModel アクティビティ トレースが有効な場合、伝達は ProcessAction アクティビティ間で実行されます。  
+  
+### サーバー  
+ クライアントとサーバーの両方で `propagateActivity` 属性が `true` に設定されている場合、サーバーの `ProcessAction` アクティビティの ID は、伝達された `ActivityId` メッセージ ヘッダーの ID と同じです。  
+  
+ メッセージに `ActivityId` ヘッダーが存在しない場合 \(つまり、クライアントで `propagateActivity` が `false` に設定されている場合\)、またはサーバーで `propagateActivity` が `false` に設定されている場合、サーバーは新しいアクティビティ ID を生成します。  
+  
+### Client  
+ クライアントが同期的にシングル スレッドで動作する場合、クライアントは、クライアントまたはサーバー側で `propagateActivity` の設定を無視します。  代わりに、応答は要求アクティビティで処理されます。  クライアントが非同期的または同期的にマルチスレッドで動作し、クライアントの `propagateActivity` が `true` に設定され、サーバーから送信されたメッセージにアクティビティ ID ヘッダーがある場合、クライアントは、そのメッセージからアクティビティ ID を取得し、伝達されたアクティビティ ID を含んでいる "プロセス アクション" アクティビティに転送します。  それ以外の場合、クライアントは、"プロセス メッセージ" アクティビティから新しい "プロセス アクション" アクティビティに転送します。  この新しい "プロセス アクション" アクティビティへの転送は、整合性を維持するために行われます。  このアクティビティの内部で、クライアントは、スレッドが応答メッセージ処理用に割り当てられている場合、ローカル スレッド コンテキストから BeginCall アクティビティのアクティビティ ID を取得します。  その後、最初の "プロセス アクション" アクティビティに転送します。  
+  
+ クライアントが双方向の場合、クライアントは、メッセージを受信するときにサーバーとして機能します。  
+  
+### エラー メッセージの伝達  
+ 有効なメッセージの処理とエラー メッセージの処理に違いはありません。  `propagateActivity` が `true` に設定されている場合、SOAP エラー メッセージのヘッダーに追加されるアクティビティ ID は、アンビエント アクティビティと同じです。  
+  
+## ServiceModel アクティビティ トレースが無効な場合  
+ ServiceModel アクティビティ トレースが無効な場合、伝達は、ServiceModel アクティビティを通過せずに直接ユーザー コード アクティビティ間で実行されます。  ユーザー定義のアクティビティ ID もメッセージ アクティビティ ID ヘッダーによって伝達されます。  
+  
+ `propagateActivity` が `true` に設定され、ServiceModel トレース リスナーで `ActivityTracing` が `off` に設定されている場合 \(トレースが ServiceModel で有効かどうかに関係なく\)、クライアントとサーバーのいずれかで次の動作が発生します。  
+  
+-   要求の処理時または応答の送信時に、TLS のアクティビティ ID は、メッセージが作成されるまでユーザー コードの外部で伝達されます。  また、アクティビティ ID ヘッダーは、メッセージが送信される前にメッセージに挿入されます。  
+  
+-   要求の受信時または応答の受信時に、アクティビティ ID は、受信したメッセージのオブジェクトが作成されしだい、メッセージ ヘッダーから取得されます。  TLS のアクティビティ ID は、メッセージがスコープから消えるとすぐに、ユーザー コードに到達するまで伝達されます。  
+  
+ このアクションによって、伝達が有効な場合にユーザー トレースが同じアクティビティに表示されることが保証されます。  ただし、ServiceModel トレースに対する保証はありません。  ServiceModel トレースは、このトレースの処理がユーザー コード アクティビティが設定されたのと同じスレッドで実行される場合のみ、ユーザー コード アクティビティで実行されます。  
+  
+ 通常、ServiceModel トレースは、次の場所で確認できます。  
+  
+-   ServiceModel トレースが無効な場合、出力されたすべてのトレースは、ユーザー アクティビティに表示されます。  サーバーとクライアントの両方で伝達が有効な場合、このトレースは同じアクティビティに表示されます。  
+  
+-   ServiceModel トレースが有効で、ActivityTracing が無効の場合、ユーザー トレースは、サーバーとクライアントの両方で伝達が有効な場合は同じアクティビティに表示されます。  ServiceModel トレースは、既定の 0000 アクティビティに表示されます。ただし、このトレースが、アクティビティが最初に設定されたユーザー コード処理と同じスレッドで実行される場合を除きます。  
+  
+-   ServiceModel トレースと ActivityTracing が両方とも有効な場合、ユーザー トレースは、ユーザー定義のアクティビティに表示され、ServiceModel トレースは、ServiceModel 定義のアクティビティに表示されます。  伝達は、ServiceModel レベルで実行されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/activity-list.md b/docs/framework/wcf/diagnostics/tracing/activity-list.md
new file mode 100644
index 00000000000..768c9583dcb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/activity-list.md
@@ -0,0 +1,64 @@
+---
+title: "アクティビティ リスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5540e185-ce8e-4db3-83b0-2b9f5bf71829
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# アクティビティ リスト
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] で定義されたすべてのアクティビティを示します。  
+  
+> [!NOTE]
+>  また、ユーザー トレースをグループ化するために、アクティビティをプログラムによって定義することもできます。詳細については、「[ユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md)」を参照してください。  
+  
+## ServiceModel アクティビティ  
+ 主要な使用シナリオに対応するすべてのアクティビティを次の表に示します。  
+  
+|ラベル|アクティビティ名|アクティビティの種類|説明|  
+|---------|--------------|----------------|--------|  
+|A、M|アンビエント アクティビティ|N\/A \(ServiceModel によって制御されません\)|ServiceModel コード \(クライアント側またはサーバー側\) を呼び出す前に、ID が TLS に設定されるアクティビティ。<br /><br /> 例 : [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] クライアントで open が呼び出されるか、serviceHost.open が呼び出されるアクティビティ。|  
+|B|Construct<br /><br /> 構築する。ContractType: '\[種類\]'。|ChannelFactory を||  
+|C|Open<br /><br /> 開く。ContractType: '\[種類\]'。|Open||  
+|I|\[ClientBase&#124;ChannelFactory\] を閉じる。ContractType: '\[種類\]'。|Close||  
+|M|ServiceHost を構築する。ServiceType: '\[種類\]'。|構成体||  
+|N|ServiceHost を開く。ServiceType: '\[種類\]'。|Open||  
+|Z|ServiceHost を閉じる。ServiceType: '\[種類\]'。|Close||  
+|O|'\[アドレス\]' でリッスンする。|ListenAt|このアクティビティと次のアクティビティはトランスポート固有です。ListenAt アクティビティは、チャネル リスナーがリッスンするアドレスにマップされるコンテンツを表します。MSMQ の場合は、キューが 1 つのアドレスにマップされるため、これはキューそのものです。このアクティビティは、接続指向のトランスポートの場合は受信接続をリッスンし、MSMQ の場合は MSMQ メッセージをリッスンします。このアクティビティは ServiceHost.Open\(\) の間に作成され、リスナーの作成と破棄、およびすべての ReceiveBytes アクティビティへの転送に関連するトレースを格納します。|  
+|P|接続 '\[アドレス\]' でのバイトを受信する。MSMQ メッセージを受信する。|ReceiveBytes|このアクティビティでは、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージを最終的に取得するデータが処理されます。接続指向のトランスポートまたは http の場合は、受信バイトを待ちます。TCP\/名前付きパイプの場合は、接続が作成されるときにアクティビティが作成されるため、このアクティビティの有効期間は接続の有効期間と等しくなります。http の場合、これはメッセージ要求の有効期間と等しく、メッセージが送信されるときにアクティビティが作成されます。このアクティビティは、接続の作成と破棄 \(該当する場合\)、およびすべてのメッセージ \(オブジェクト\) 処理アクティビティへの転送に関連するトレースを格納します。<br /><br /> MSMQ の場合、これは MSMQ メッセージが取得されるアクティビティです。|  
+|Q|メッセージ \[番号\] を処理する \(\[番号\] は、1 で始まる、単調に増加する値です\)。|ProcessMessage|受信メッセージを処理します。このアクティビティは、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージ オブジェクトを形成するためのすべてのデータ \(バイト、MSMQ メッセージ\) が受信されると開始されます。このアクティビティに格納されたトレースは、ヘッダー処理を扱います。<br /><br /> ディスパッチ可能なメッセージが形成されると、対応するアクティビティ ID を検索した後で ServiceHost ProcessAction アクティビティとの間で切り替わります。|  
+|D、S|アクション '\[アクション\]' を処理する。|ProcessAction|受信時にはユーザー コードにメッセージをディスパッチし、送信時には逆の順序でメッセージをディスパッチするために、トランスポート\/セキュリティ\/RM スタックを通じてメッセージを処理します。<br /><br /> サーバーでは、"アクティビティ伝達" を介してメッセージ ヘッダーで送信された場合、このアクティビティは伝達されたアクティビティ ID を使用します。それ以外の場合は、新しい GUID が作成されます。<br /><br /> 要求\/応答コントラクトに対する応答メッセージも、そのアクティビティで処理されます。|  
+|T|'\[IContract.Operation\]' を実行する。|ExecuteUserCode|サービス側でディスパッチ後にユーザー コードを実行します。このアクティビティは、ユーザー指定のコードと ServiceHost コードを区別するための境界を提供します。|  
+  
+## セキュリティ アクティビティ  
+ セキュリティに関連するすべてのアクティビティを次の表に示します。  
+  
+|アクティビティ名|アクティビティの種類|説明|  
+|--------------|----------------|--------|  
+|セキュリティで保護されたセッションをセットアップする|SetupSecurity|クライアント側だけに存在します。認証およびセキュリティ コンテキストの設定のためのすべての "RST\*\/SCT 交換" を格納します。`propagateActivity` が `true` の場合、このアクティビティは、サービスの対応する プロセス アクション RST\*\/SCT アクティビティとマージされます。|  
+|セキュリティで保護されたセッションを閉じる|SetupSecurity|クライアント側に存在します。セキュリティで保護されたセッションを閉じるための "メッセージ交換のキャンセル" を格納します。`propagateActivity` が `true` の場合、このアクティビティは、サービスのプロセス アクションである "キャンセル" とマージされます。|  
+  
+ COM\+ に関連するすべてのアクティビティを次の表に示します。  
+  
+|アクティビティ名|アクティビティの種類|説明|  
+|--------------|----------------|--------|  
+|COM\+ インスタンスを作成する|TransferToCOMPlus|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] コードからの COM\+ 呼び出しごとに 1 つのアクティビティ インスタンス|  
+|COM\+ \<操作\> を実行する|TransferToCOMPlus|[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] コードからの COM\+ 呼び出しごとに 1 つのアクティビティ インスタンス|  
+  
+## WMI アクティビティ  
+ WMI に関連するすべてのアクティビティを次の表に示します。  
+  
+|アクティビティ名|アクティビティの種類|説明|  
+|--------------|----------------|--------|  
+|WMI Get|WMIGetObject|ユーザーは、WMI からデータを取得しています。|  
+|WMI Put|WmiPutInstance|ユーザーは、WMI でデータを更新しています。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/activity-tracing-in-message-security.md b/docs/framework/wcf/diagnostics/tracing/activity-tracing-in-message-security.md
new file mode 100644
index 00000000000..b39bcd7950e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/activity-tracing-in-message-security.md
@@ -0,0 +1,63 @@
+---
+title: "メッセージ セキュリティにおけるアクティビティ トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 68862534-3b2e-4270-b097-8121b12a2c97
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# メッセージ セキュリティにおけるアクティビティ トレース
+ここでは、次の 3 つの段階で発生するセキュリティ処理のアクティビティ トレースについて説明します。  
+  
+-   ネゴシエーション\/SCT 交換。トランスポート層 \(バイナリデータ交換を使用した場合\) またはメッセージ層 \(SOAP メッセージ交換を使用した場合\) で発生する可能性があります。  
+  
+-   メッセージの暗号化と復号化、および署名の検証と認証。トレースは、アンビエント アクティビティ \(通常、"プロセス アクション"\) に表示されます。  
+  
+-   承認と検証。ローカルで、またはエンドポイント間の通信中に発生する可能性があります。  
+  
+## ネゴシエーション\/SCT 交換  
+ ネゴシエーション\/SCT 交換段階では、"セキュリティで保護されたセッションの設定" および "セキュリティで保護されたセッションを閉じる" という 2 種類のアクティビティがクライアント側で作成されます。"セキュリティで保護されたセッションの設定" は RST\/RSTR\/SCT メッセージ交換のトレースを含み、"セキュリティで保護されたセッションを閉じる" は "キャンセル" メッセージのトレースを含みます。  
+  
+ サーバーでは、RST\/RSTR\/SCT の各要求\/応答がそのアクティビティに表示されます。サーバーとクライアントの両方に `propagateActivity`\=`true` が設定されている場合、サーバーの各アクティビティは同じ ID を持ち、サービス トレース ビューアーでは "セキュリティで保護されたセッションの設定" にまとめて表示されます。  
+  
+ このアクティビティ トレース モデルは、ユーザー名\/パスワード認証、証明書認証、および NTLM 認証に対して有効です。  
+  
+ ネゴシエーションと SCT 交換のアクティビティとトレースを次の表に示します。  
+  
+||ネゴシエーション\/SCT 交換の発生タイミング|アクティビティ|トレース|  
+|-|------------------------------|-------------|----------|  
+|セキュリティで保護されたトランスポート<br /><br /> \(HTTPS、SSL\)|最初のメッセージを受信したとき。|トレースは、アンビエント アクティビティで出力されます。|-   交換トレース<br />-   セキュリティ保護されたチャネルの確立。<br />-   共有シークレットの取得。|  
+|セキュリティで保護されたメッセージ層<br /><br /> \(WSHTTP\)|最初のメッセージを受信したとき。|クライアント側 :<br /><br /> -   RST\/RSTR\/SCT の各要求\/応答に対する最初のメッセージの "プロセス アクション" で発生した "セキュリティで保護されたセッションの設定"。<br />-   "プロキシ アクティビティを閉じる" で発生した "交換のキャンセル" に対する "セキュリティで保護されたセッションを閉じる"。このアクティビティは、セキュリティで保護されたセッションが閉じられるタイミングにより、他のアンビエント アクティビティで発生する可能性があります。<br /><br /> サーバー側 :<br /><br /> -   サーバーでの RST\/SCT\/キャンセルの各要求\/応答に対して 1 つの "プロセス アクション" アクティビティ。`propagateActivity`\=`true` の場合、RST\/RSTR\/SCT アクティビティは "セキュリティで保護されたセッションの設定" とマージされ、"キャンセル" はクライアントからの "閉じる" アクティビティとマージされます。<br /><br /> "セキュリティで保護されたセッションの設定" には 2 つの段階があります。<br /><br /> 1.  認証ネゴシエーション。クライアントが既に適切な資格情報を持つ場合は、省略可能です。この段階は、セキュリティで保護されたトランスポート、またはメッセージ交換を通じて行われます。後者の場合、1 つまたは 2 つの RST\/RSTR 交換が発生する可能性があります。これらの交換では、トレースは、従来の設計どおり、新しい要求\/応答アクティビティで出力されます。<br />2.  セキュリティで保護されたセッションの確立 \(SCT\)。この段階では、1 つの RST\/RSTR 交換が発生します。前述のように、これには同じアンビエント アクティビティが含まれます。|-   交換トレース<br />-   セキュリティ保護されたチャネルの確立。<br />-   共有シークレットの取得。|  
+  
+> [!NOTE]
+>  混在セキュリティ モードでは、ネゴシエーション認証はバイナリ交換で発生しますが、SCT はメッセージ交換で発生します。純粋なトランスポート モードでは、ネゴシエーションは追加のアクティビティを持たないトランスポートでのみ発生します。  
+  
+## メッセージの暗号化と復号化  
+ メッセージの暗号化と復号化および署名認証のアクティビティとトレースを次の表に示します。  
+  
+||セキュリティで保護されたトランスポート<br /><br /> \(HTTPS、SSL\) およびセキュリティで保護されたメッセージ層<br /><br /> \(WSHTTP\)|  
+|-|--------------------------------------------------------------------------------|  
+|メッセージの暗号化\/復号化、および署名認証の発生タイミング|メッセージを受信したとき。|  
+|アクティビティ|トレースは、クライアントとサーバーの ProcessAction アクティビティで出力されます。|  
+|トレース|-   sendSecurityHeader \(送信側\):<br />-   メッセージの署名<br />-   要求データの暗号化<br />-   receiveSecurityHeader \(受信側\):<br />-   署名の検証<br />-   応答データの復号化<br />-   認証|  
+  
+> [!NOTE]
+>  純粋なトランスポート モードでは、メッセージの暗号化\/復号化は追加のアクティビティを持たないトランスポートでのみ発生します。  
+  
+## 承認と検証  
+ 承認のアクティビティとトレースを次の表に示します。  
+  
+||承認の発生タイミング|アクティビティ|トレース|  
+|-|----------------|-------------|----------|  
+|ローカル \(既定\)|サーバーでメッセージが複号化された後|トレースは、サーバーの ProcessAction アクティビティで出力されます。|ユーザーの承認。|  
+|Remote|サーバーでメッセージが複号化された後|トレースは、ProcessAction アクティビティによって呼び出された新しいアクティビティで出力されます。|ユーザーの承認。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/activity.md b/docs/framework/wcf/diagnostics/tracing/activity.md
new file mode 100644
index 00000000000..a86c015cb7a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/activity.md
@@ -0,0 +1,112 @@
+---
+title: "アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70471705-f55f-4da1-919f-4b580f172665
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# アクティビティ
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トレース モデルのアクティビティ トレースについて説明します。アクティビティは、ユーザーがエラーの範囲を絞り込む上で役立つ処理単位です。同じアクティビティで発生したエラーは直接関連します。たとえば、メッセージを復号化できなかったために、ある操作が失敗したとします。この操作とメッセージ復号化失敗のトレースは同じアクティビティ内に表示され、復号化エラーと要求エラー間の直接相関関係が示されます。  
+  
+## アクティビティ トレースの構成  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] には、アプリケーションを処理するための定義済みアクティビティが用意されています \(「[アクティビティ リスト](../../../../../docs/framework/wcf/diagnostics/tracing/activity-list.md)」を参照してください\)。また、ユーザー トレースをグループ化するために、アクティビティをプログラムによって定義することもできます。詳細については、「[ユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md)」を参照してください。  
+  
+ 実行時にアクティビティ トレースを出力するには、次の構成コードに示すように、`System.ServiceModel` トレース ソースや、他の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] トレース ソースまたはカスタム トレース ソースの `ActivityTracing` 設定を使用します。  
+  
+```  
+<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing">  
+```  
+  
+ 使用する構成要素と属性の詳細については、「[トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」を参照してください。  
+  
+## アクティビティの表示  
+ アクティビティとそのユーティリティは、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)で表示できます。ActivityTracing が有効な場合、このツールはトレースを取得し、アクティビティに基づいて並べ替えます。トレース転送を表示することもできます。トレース転送は、さまざまなアクティビティが相互にどのように関連しているかを示します。これにより、特定のアクティビティによって別のアクティビティが開始されたことを確認できます。たとえば、Secure Conversation トークンを取得するために、あるメッセージ要求によってセキュリティ ハンドシェイクが開始されたことを確認できます。  
+  
+### サービス トレース ビューアーでのアクティビティの関連付け  
+ 次のように、サービス トレース ビューアー ツールには、アクティビティの 2 つのビューが用意されています。  
+  
+-   **リスト** ビュー : アクティビティ ID を使用して、プロセス全体にわたり、トレースを直接関連付けます。異なるプロセス \(クライアントとサービスなど\) のトレースであっても、同じアクティビティ ID を持つトレースは、同じアクティビティにグループ化されます。したがって、サービスで発生したエラーによってクライアントでエラーが発生した場合、ツールの同じアクティビティ ビューに両方のエラーが表示されることになります。  
+  
+-   **グラフ** ビュー : アクティビティは、プロセスごとにグループ化されます。このビューでは、クライアントとサービスのトレースは、アクティビティ ID が同じであっても、異なるアクティビティに表示されます。アクティビティ ID は同じであるが、異なるプロセスに含まれるアクティビティを相互に関連付けるために、このツールでは、関連するアクティビティ間のメッセージ フローが示されます。  
+  
+ 詳細およびサービス トレース ビューアー ツールのグラフィック表示については、「[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)」および「[サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)」を参照してください。  
+  
+## アクティビティ スコープの定義  
+ アクティビティはデザイン時に定義され、作業の論理単位を表します。同じアクティビティ識別子を使用して出力されたトレースは直接関連し、同じアクティビティに含まれます。アクティビティはエンドポイントの境界 \(要求\) を越えることができるため、アクティビティ 1 つにつき 2 つのスコープが定義されています。  
+  
+-   `Global` スコープ \(アプリケーションごと\)。このスコープでは、アクティビティは 128 ビットの、グローバルに一意なアクティビティ識別子 \(gAId\) によって識別されます。gAId は、エンドポイント全体にわたって伝達されます。  
+  
+-   `Local` スコープ \(エンドポイントごと\)。このスコープでは、アクティビティは、gAId、アクティビティ トレースを出力するトレース ソース名、およびプロセス ID によって識別されます。この 3 つの組み合わせによって、ローカル アクティビティ ID \(lAId\) が構成されます。lAId は、アクティビティの \(ローカル\) 境界の定義に使用されます。  
+  
+## トレース スキーマ  
+ トレースはスキーマを使用して Microsoft プラットフォーム間で出力できます。"e2e" \("エンド ツー エンド" の略\) は、一般に使用されるスキーマです。このスキーマには、128 ビット識別子 \(gAId\)、トレース ソース名、およびプロセス ID が含まれます。マネージ コードでは、<xref:System.Diagnostics.XmlWriterTraceListener> が e2e スキーマでトレースを出力します。  
+  
+ 開発者は、スレッド ローカル ストレージ \(TLS\) の GUID を使用して <xref:System.Diagnostics.CorrelationManager.ActivityId%2A> プロパティを設定することにより、トレースで出力する AID を設定できます。次に例を示します。  
+  
+```  
+// set the current Activity ID to a new GUID.  
+CorrelationManager.ActivityId = Guid.NewGuid();  
+```  
+  
+ 次の例に示すように、トレース ソースを使用してトレースを出力すると、TLS での gAId の設定が明確に示されます。  
+  
+```  
+TraceSource traceSource = new TraceSource("myTraceSource");  
+traceSource.TraceEvent(TraceEventType.Warning, eventId, "Information");  
+```  
+  
+ 出力されるトレースには、TLS の現在の gAId、トレース ソースのコンストラクターにパラメーターとして渡されるトレース ソース名、および現在のプロセスの ID が含まれます。  
+  
+## アクティビティの有効期間  
+ 最も厳密な意味では、アクティビティの形跡は、出力されたトレースでアクティビティ ID が初めて使用されたときに始まり、出力されたトレースでアクティビティ ID が最後に使用されたときに終わります。<xref:System.Diagnostics> には、定義済みのトレースの種類のセットが用意されています。これは、アクティビティの有効期間の境界を明示的にマークするための Start トレースと Stop トレースを含みます。  
+  
+-   Start : アクティビティの開始を示します。"Start" トレースは、新しい処理マイルストーンの開始を記録します。このトレースには、特定のプロセスの特定のトレース ソースに使用される新しいアクティビティ ID が含まれます。ただし、エンドポイント間でアクティビティ ID が伝達される場合を除きます \(この場合は、エンドポイントごとに 1 つの "Start" トレースが表示されます\)。新しいアクティビティの開始の例として、新しい処理スレッドの作成や、新しいパブリック メソッドの入力などがあります。  
+  
+-   Stop: アクティビティの終了を示します。"Stop" トレースは、既存の処理マイルストーンの終了を記録します。このトレースには、特定のプロセスの特定のトレース ソースに使用される既存のアクティビティ ID が含まれます。ただし、エンドポイント間でアクティビティ ID が伝達される場合を除きます \(この場合は、エンドポイントごとに 1 つの "Stop" トレースが表示されます\)。アクティビティの停止の例として、処理スレッドの終了や、"Start" トレースによって開始が示されたメソッドの終了などがあります。  
+  
+-   Suspend : アクティビティの処理の中断を示します。"Suspend" トレースには、後で処理を再開することが予想される既存のアクティビティ ID が含まれます。中断イベントと再開イベントの間に、現在のトレース ソースからこの ID を使用してトレースが出力されることはありません。中断の例として、外部ライブラリ関数の呼び出し時、または I\/O 完了ポートなどのリソースで待機する際のアクティビティの一時停止などがあります。  
+  
+-   Resume : アクティビティの処理の再開を示します。"Resume" トレースには、現在のトレース ソースから最後に出力されたトレースが "Suspend" トレースであった既存のアクティビティ ID が含まれます。再開の例として、外部ライブラリ関数の呼び出しからの復帰や、I\/O 完了ポートなどのリソースによって処理の再開が通知された場合などがあります。  
+  
+-   Transfer: アクティビティの中には、他のアクティビティによって発生するものや、他のアクティビティに関連するものがあるため、"Transfer" トレースを使用してアクティビティを他のアクティビティに関連付けることができます。転送により、アクティビティ間の直接の関係が記録されます。  
+  
+ Start トレースと Stop トレースは、関連付けにとっては重要ではありません。ただし、これらのトレースは、パフォーマンスの向上、プロファイリング、およびアクティビティ スコープの検証に役立ちます。  
+  
+ 同じアクティビティの直接関連するイベントを検出するときや、転送トレースを追跡する場合に関連アクティビティのイベントを検出するときに、ツールはこれらのトレースを使用して、トレース ログのナビゲーションを最適化することができます。たとえば、ツールが Start\/Stop トレースを確認したときに、特定のアクティビティのログの解析を中止できます。  
+  
+ Start\/Stop トレースは、プロファイリングに使用することもできます。開始マーカーと終了マーカーの間で使用されるリソースは、論理アクティビティを含むアクティビティの包括的時間を表します。Suspend トレースから Resume トレースまでの時間間隔を減算することで、アクティビティの実際の時間がわかります。  
+  
+ また、Stop トレースは、実装済みのアクティビティのスコープを検証する際に特に役立ちます。特定のアクティビティ内ではなく Stop トレースの後に出現する処理トレースがある場合、これはコードの欠陥を示している可能性があります。  
+  
+## アクティビティ トレースを使用するためのガイドライン  
+ ActivityTracing トレース \(Start、Stop、Suspend、Resume、および Transfer\) を使用する際のガイドラインを以下に示します。  
+  
+-   トレースは、ツリーではなく循環有向グラフです。あるアクティビティを発生させたアクティビティに制御を戻すことができます。  
+  
+-   アクティビティは処理の境界を示します。処理の境界は、システム管理者にとって重要であり、サポートを容易にする上でも役立ちます。  
+  
+-   [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の各メソッド \(クライアントとサーバーの両方\) は、新しいアクティビティを開始し、\(処理の終了後に\) その新しいアクティビティを終了した後、アンビエント アクティビティに戻ることによって境界が設定されます。  
+  
+-   接続のリッスンやメッセージの待機など、長時間にわたって実行される \(継続中の\) アクティビティは、対応する開始マーカーと終了マーカーによって表されます。  
+  
+-   メッセージの受信または処理によって起動されるアクティビティは、トレースの境界によって表されます。  
+  
+-   アクティビティはアクティビティを表します。オブジェクトとは限りません。アクティビティは、"～のときに.. \(有効なトレース出力が発生したときに\) これが発生していた" と解釈する必要があります。  
+  
+## 参照  
+ [トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)   
+ [ユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/asynchronous-scenarios-using-http-tcp-or-named-pipe.md b/docs/framework/wcf/diagnostics/tracing/asynchronous-scenarios-using-http-tcp-or-named-pipe.md
new file mode 100644
index 00000000000..b4c67bdfee3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/asynchronous-scenarios-using-http-tcp-or-named-pipe.md
@@ -0,0 +1,95 @@
+---
+title: "HTTP、TCP、または名前付きパイプを使用した非同期シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4d62402-43a4-48a4-9ced-220633ebc4ce
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# HTTP、TCP、または名前付きパイプを使用した非同期シナリオ
+ここでは、マルチスレッド要求で HTTP、TCP、または名前付きパイプを使用したときの、さまざまな非同期要求\/応答シナリオでのアクティビティおよび転送について説明します。  
+  
+## エラーを伴わない非同期要求\/応答  
+ ここでは、マルチスレッド クライアントを使用したときの、非同期要求\/応答シナリオでのアクティビティおよび転送について説明します。  
+  
+ 呼び出し元アクティビティは、`beginCall` が返され、`endCall` が返されると終了します。コールバックが呼び出されたときは、そのコールバックが返されます。  
+  
+ 呼び出されたアクティビティは、`beginCall` が返され、`endCall` が返されると終了します。または、そのアクティビティからコールバックが呼び出された場合は、コールバックが返されると終了します。  
+  
+### コールバックを伴わない非同期クライアント  
+  
+#### HTTP を使用して、両方の側で伝達が有効になっている場合  
+ ![非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/asyn1.gif "Asyn1")  
+  
+ 図 1. 非同期クライアント、コールバックなし、両方の側で `propagateActivity`\=`true`、HTTP  
+  
+ `propagateActivity`\=`true` の場合、"メッセージを処理" は転送先の "アクションを処理" アクティビティを示します。  
+  
+ HTTP ベースのシナリオでは、最初に送信するメッセージで "バイトを受信" が呼び出され、要求の有効期間だけ存在します。  
+  
+#### HTTP を使用して、両方の側で伝達が無効になっている場合  
+ どちらかの側で `propagateActivity`\=`false` の場合、"メッセージを処理" は転送先の "アクションを処理" アクティビティを示しません。したがって、新しい ID を使用して、新しい一時的な "アクションを処理" アクティビティが呼び出されます。非同期応答と ServiceModel コード内の要求が一致する場合は、アクティビティ ID をローカル コンテキストから取得できます。その ID を使用して、実際の "アクションを処理" アクティビティに転送できます。  
+  
+ ![HTTP、TCP、および名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/async2.gif "Async2")  
+  
+ 図 2. 非同期クライアント、コールバックなし、どちらかの側で `propagateActivity`\=`false`、HTTP  
+  
+ HTTP ベースのシナリオでは、最初に送信するメッセージで "バイトを受信" が呼び出され、要求の有効期間だけ存在します。  
+  
+ "アクションを処理" アクティビティは、呼び出し元または呼び出し先で `propagateActivity`\=`false` の場合、および応答メッセージに Action ヘッダーが含まれない場合に、非同期クライアントで作成されます。  
+  
+#### TCP または名前付きパイプを使用して、両方の側で伝達が有効になっている場合  
+ ![HTTP、TCP、および名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/async3.gif "Async3")  
+  
+ 図 3. 非同期クライアント、コールバックなし、両方の側で `propagateActivity`\=`true`、名前付きパイプ\/TCP  
+  
+ 名前付きパイプまたは TCP ベースのシナリオでは、クライアントが開かれるときに "バイトを受信" が呼び出され、接続の有効期間だけ存在します。  
+  
+ 図 1. と同様、`propagateActivity`\=`true` の場合、"メッセージを処理" は転送先の "アクションを処理" アクティビティを示します。  
+  
+#### TCP または名前付きパイプを使用して、両方の側で伝達が無効になっている場合  
+ 名前付きパイプまたは TCP ベースのシナリオでは、クライアントが開かれるときに "バイトを受信" が呼び出され、接続の有効期間だけ存在します。  
+  
+ 図2. と同様、どちらかの側で `propagateActivity`\=`false` の場合、"メッセージを処理" は転送先の "アクションを処理" アクティビティを示しません。したがって、新しい ID を使用して、新しい一時的な "アクションを処理" アクティビティが呼び出されます。非同期応答と ServiceModel コード内の要求が一致する場合は、アクティビティ ID をローカル コンテキストから取得できます。その ID を使用して、実際の "アクションを処理" アクティビティに転送できます。  
+  
+ ![HTTP、TCP、および名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/async4.gif "Async4")  
+  
+ 図 4. 非同期クライアント、コールバックなし、どちらかの側で `propagateActivity`\=`false`、名前付きパイプ\/TCP  
+  
+### コールバックを伴う非同期クライアント  
+ このシナリオでは、コールバックと `endCall` に対するアクティビティ G と A’、およびその転送 \(送受信\) が追加されています。  
+  
+ ここでは、`propragateActivity`\=`true` で HTTP を使用する例だけを示します。ただし、追加のアクティビティや転送は、その他の場合 \(つまり、`propagateActivity`\=`false` で TCP または名前付きパイプを使用\) にも適用されます。  
+  
+ クライアントがユーザー コードを呼び出して結果の準備が完了したことを通知すると、コールバックは新しいアクティビティ \(G\) を作成します。ユーザー コードは、次に、コールバック内 \(図 5 を参照\) またはコールバック外 \(図 6 を参照\) で `endCall` を呼び出します。`endCall` がどのユーザー アクティビティから呼び出されているかわからないため、このアクティビティには "`A’`" というラベルが付けられています。A’ と A が同じである場合もありますし、異なる場合もあります。  
+  
+ ![非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/asynccallback1.gif "AsyncCallback1")  
+  
+ 図 5. 非同期クライアント、コールバックあり、コールバック内での `endCall`  
+  
+ ![非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/asynccallback2.gif "AsyncCallback2")  
+  
+ 図 6. 非同期クライアント、コールバックあり、コールバック外での `endCall`  
+  
+### コールバックを伴う非同期サーバー  
+ ![HTTP、TCP、および名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/aynchserver.gif "AynchServer")  
+  
+ 図 7. 非同期サーバー、コールバックあり  
+  
+ チャネル スタックは、"メッセージを受信" でクライアントをコールバックします。この処理のトレースは、"要求を処理" アクティビティ自体で出力されます。  
+  
+## エラーを伴う非同期要求\/応答  
+ エラー メッセージは、`endCall` 中に受信されます。この点を除き、アクティビティおよび転送は前のシナリオと同様です。  
+  
+## エラーを伴う\/伴わない非同期一方向要求\/応答  
+ クライアントに返される応答やエラーはありません。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/com.md b/docs/framework/wcf/diagnostics/tracing/com.md
new file mode 100644
index 00000000000..cd33847e9ce
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/com.md
@@ -0,0 +1,22 @@
+---
+title: "COM+ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6665a2d3-7e11-4cce-8968-3fcf3426d362
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# COM+
+次の図は、COM\+ アプリケーションでのアクティビティ トレースの使用方法を示しています。サーバーでユーザー コードを実行する代わりに、COM\+ オブジェクト モデルへのメソッド呼び出しごとに COM\+ アクティビティを定義できます。  
+  
+ ![COM&#43; アプリケーションによる同期呼び出し](../../../../../docs/framework/wcf/diagnostics/tracing/media/com-tracing.gif "Com\+Tracing")
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/configuring-tracing.md b/docs/framework/wcf/diagnostics/tracing/configuring-tracing.md
new file mode 100644
index 00000000000..1d542699831
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/configuring-tracing.md
@@ -0,0 +1,194 @@
+---
+title: "トレースの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トレース [WCF]"
+ms.assetid: 82922010-e8b3-40eb-98c4-10fc05c6d65d
+caps.latest.revision: 53
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 53
+---
+# トレースの構成
+ここでは、トレースを有効にする方法、トレースを出力し、トレース レベルを設定するようにトレース ソースを構成する方法、エンドツーエンドのトレース相関をサポートするようにアクティビティ トレースと伝達を設定する方法、およびトレースにアクセスするようにトレース リスナーを設定する方法について説明します。  
+  
+ 運用環境またはデバッグ環境でのトレースの推奨設定については、「[トレースとメッセージ ログの推奨設定](../../../../../docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  Windows 8 でトレース ログが生成されるように、レベルの高い権限で \(管理者として\) アプリケーションを実行する必要があります。  
+  
+## トレースの有効化  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] では次の診断トレース データが出力されます。  
+  
+-   操作呼び出し、コード例外、警告、その他の重要な処理イベントなど、アプリケーションのすべてのコンポーネントにおける処理マイルストーンのトレース。  
+  
+-   トレース機能が正しく動作しないときの Windows エラー イベント。「[イベント ログ](../../../../../docs/framework/wcf/diagnostics/event-logging/index.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] トレースは、<xref:System.Diagnostics> に基づいています。トレースを使用するには、構成ファイルまたはコードでトレース ソースを定義する必要があります。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アセンブリごとにトレース ソースを定義します。`System.ServiceModel` トレース ソースは最も一般的な [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] トレース ソースで、トランスポートへの出入りからユーザー コードへの出入りまで、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 通信スタック全体の処理マイルストーンを記録します。`System.ServiceModel.MessageLogging` トレース ソースは、システムを通過するすべてのメッセージを記録します。  
+  
+ 既定では、トレースは無効です。トレースを有効にするには、トレース リスナーを作成し、構成で選択したトレース ソースのトレース レベルを "Off" 以外に設定する必要があります。それ以外の場合、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] はトレースを生成しません。リスナーを指定しないと、トレースは自動的に無効になります。リスナーを定義してもトレース レベルを指定しないと、トレース レベルは既定で "Off" に設定され、トレースが出力されなくなります。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 機能拡張ポイント \(カスタム操作の呼び出し元など\) を使用する場合、独自のトレースを出力する必要があります。これは、機能拡張ポイントを実装すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] が既定のパスに標準のトレースを出力できなくなるためです。トレースを出力することで手動トレースのサポートを実装しない場合、予測したトレースが得られない場合があります。  
+  
+ トレースは、アプリケーションの構成ファイル \(Web ホスト型アプリケーションの場合は Web.config、自己ホスト型アプリケーションの場合は Appname.exe.config\) を編集することで構成できます。以下は、このような編集の例です。これらの設定の詳細については、「トレースを使用するためのトレース リスナーの構成」のセクションを参照してください。  
+  
+```  
+<configuration>  
+   <system.diagnostics>  
+      <sources>  
+            <source name="System.ServiceModel"   
+                    switchValue="Information, ActivityTracing"  
+                    propagateActivity="true">  
+            <listeners>  
+               <add name="traceListener"   
+                   type="System.Diagnostics.XmlWriterTraceListener"   
+                   initializeData= "c:\log\Traces.svclog" />  
+            </listeners>  
+         </source>  
+      </sources>  
+   </system.diagnostics>  
+</configuration>  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[vs_current_short](../../../../../includes/vs-current-short-md.md)] で [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービス プロジェクトの構成ファイルを編集するには、**ソリューション エクスプローラー**でアプリケーションの構成ファイル \(Web ホスト型アプリケーションの場合は Web.config、自己ホスト型アプリケーションの場合は Appname.exe.config\) を右クリックします。次に、**\[WCF 構成の編集\]** コンテキスト メニュー項目を選択します。これによって[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) が開き、グラフィカル ユーザー インターフェイスを使用して [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの構成設定を変更できます。  
+  
+## トレースを出力するためのトレース ソースの構成  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、アセンブリごとにトレース ソースを定義します。アセンブリ内で生成されたトレースは、該当するソースで定義されているリスナーによってアクセスされます。次のトレース ソースが定義されます。  
+  
+-   System.ServiceModel: 構成の読み取り、トランスポートでのメッセージの処理、セキュリティ処理、ユーザー コードでのメッセージのディスパッチなど、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] 処理のすべての段階を記録します。  
+  
+-   System.ServiceModel.MessageLogging: システムを通過するすべてのメッセージを記録します。  
+  
+-   System.IdentityModel  
+  
+-   System.ServiceModel.Activation  
+  
+-   System.IO.Log: Common Log File System \(CLFS\) への .NET Framework インターフェイスを記録します。  
+  
+-   System.Runtime.Serialization: オブジェクトの読み取りまたは書き込みを記録します。  
+  
+-   CardSpace  
+  
+ 各トレース ソースは、次の構成例に示すように同じ \(共有\) リスナーを使用するように構成できます。  
+  
+```  
+<configuration>  
+    <system.diagnostics>  
+        <sources>  
+            <source name="System.ServiceModel"   
+                    switchValue="Information, ActivityTracing"  
+                    propagateActivity="true">  
+                <listeners>  
+                    <add name="xml" />  
+                </listeners>  
+            </source>  
+            <source name="CardSpace">  
+                <listeners>  
+                    <add name="xml" />  
+                </listeners>  
+            </source>  
+            <source name="System.IO.Log">  
+                <listeners>  
+                    <add name="xml" />  
+                </listeners>  
+            </source>  
+            <source name="System.Runtime.Serialization">  
+                <listeners>  
+                    <add name="xml" />  
+                </listeners>  
+            </source>  
+            <source name="System.IdentityModel">  
+                <listeners>  
+                    <add name="xml" />  
+                </listeners>  
+            </source>  
+        </sources>  
+  
+        <sharedListeners>  
+            <add name="xml"  
+                 type="System.Diagnostics.XmlWriterTraceListener"  
+                 initializeData="c:\log\Traces.svclog" />  
+        </sharedListeners>  
+    </system.diagnostics>  
+</configuration>  
+```  
+  
+ さらに、次の例に示すように、ユーザー定義のトレース ソースを追加してユーザー コード トレースを出力することもできます。  
+  
+```  
+<system.diagnostics>  
+   <sources>  
+       <source name="UserTraceSource" switchValue="Warning, ActivityTracing" >  
+          <listeners>  
+              <add name="xml"  
+                 type="System.Diagnostics.XmlWriterTraceListener"  
+                 initializeData="C:\logs\UserTraces.svclog" />  
+          </listeners>  
+       </source>  
+   </sources>  
+   <trace autoflush="true" />   
+</system.diagnostics>  
+```  
+  
+ ユーザー定義のトレース ソースの作成[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[トレースの拡張](../../../../../docs/framework/wcf/samples/extending-tracing.md)」を参照してください。  
+  
+## トレースを使用するためのトレース リスナーの構成  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は実行時にトレース データを処理するリスナーにデータを送信します。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は <xref:System.Diagnostics> に出力の形式が異なる複数の定義済みリスナーを提供します。カスタム リスナーの種類を追加することもできます。  
+  
+ `add` を使用して、使用するトレース リスナーの名前と種類を指定できます。この例の構成では、リスナーに `traceListener` という名前を付け、使用する種類として標準の .NET Framework トレース リスナー \(`System.Diagnostics.XmlWriterTraceListener`\) を追加しています。ソースごとに任意の数のトレース リスナーを追加できます。トレース リスナーがトレースをファイルに出力する場合は、構成ファイルで出力ファイルの場所と名前を指定する必要があります。指定するには、`initializeData` をそのリスナーのファイルの名前に設定します。ファイル名を指定しないと、使用するリスナーの種類に基づいて任意のファイル名が生成されます。<xref:System.Diagnostics.XmlWriterTraceListener> を使用した場合は、拡張子のないファイル名が生成されます。カスタム リスナーを実装した場合は、この属性を使用して、ファイル名以外の初期化データを受け取ることもできます。たとえば、この属性にデータベース識別子を指定できます。  
+  
+ カスタム トレース リスナーは、ネットワーク上のリモート データベースなどにトレースを送信するように構成できます。アプリケーションを展開するユーザーは、リモート コンピューターのトレース ログに適切なアクセス制御を適用する必要があります。  
+  
+ また、トレース リスナーはプログラムによって構成することもできます。[!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)]「[方法 : トレース リスナーを作成し初期化する](http://go.microsoft.com/fwlink/?LinkId=94648)」および「[カスタム TraceListener の作成](http://go.microsoft.com/fwlink/?LinkId=96239)」を参照してください。  
+  
+> [!CAUTION]
+>  `System.Diagnostics.XmlWriterTraceListener` はスレッド セーフではないため、トレース ソースは、トレースを出力するときにリソースを排他的にロックする可能性があります。このリスナーを使用するように構成されたトレース ソースに多くのスレッドがトレースを出力すると、リソースの競合が発生し、パフォーマンスに重大な問題が生じる場合があります。この問題を解決するには、スレッド セーフなカスタム リスナーを実装する必要があります。  
+  
+## トレース レベル  
+ トレース レベルは、トレース ソースの `switchValue` 設定で制御します。使用できるトレース レベルを次の表に示します。  
+  
+|トレース レベル|追跡イベントの性質|追跡イベントの内容|追跡イベント|対象ユーザー|  
+|--------------|---------------|---------------|------------|------------|  
+|Off|N\/A|N\/A|トレースは出力されません。|N\/A|  
+|Critical|"否定的" イベント : 予期しない処理またはエラー状態を示すイベント。||次の例を含む未処理の例外が記録されます。<br /><br /> -   OutOfMemoryException<br />-   ThreadAbortException \(CLR が任意の ThreadAbortExceptionHandler を呼び出します\)<br />-   StackOverflowException \(キャッチできません\)<br />-   ConfigurationErrorsException<br />-   SEHException<br />-   アプリケーションの起動エラー<br />-   フェイルファースト イベント<br />-   システム ハング<br />-   有害メッセージ : アプリケーションを失敗させるメッセージ トレース。|管理者<br /><br /> アプリケーション開発者|  
+|Error|"否定的" イベント : 予期しない処理またはエラー状態を示すイベント。|予期しない処理が発生した。アプリケーションが、タスクを正常に実行できなかった。ただし、アプリケーションは依然として動作している。|すべての例外がログに記録されます。|管理者<br /><br /> アプリケーション開発者|  
+|Warning|"否定的" イベント : 予期しない処理またはエラー状態を示すイベント。|問題が発生したか、発生する可能性があるが、アプリケーションは正常に動作している。ただし、正常な動作を継続できなくなる可能性がある。|-   アプリケーションが、調整設定の範囲を超えた数の要求を受信している。<br />-   受信側キューが構成された最大の容量に近づいている。<br />-   タイムアウトを超えた。<br />-   資格情報が拒否される。|管理者<br /><br /> アプリケーション開発者|  
+|Information|"肯定的" イベント : 正常なマイルストーンを示すイベント。|アプリケーションが正常に動作しているかどうかとは無関係の、アプリケーションの実行に関する重要で正常なマイルストーン。|一般に、システム ステータスの監視と診断、パフォーマンスの計測、またはプロファイリングに有用なメッセージが生成されます。この情報は、キャパシティ プランニングやパフォーマンス管理のために利用できます。<br /><br /> -   チャネルが作成される。<br />-   エンドポイントのリスナーが作成される。<br />-   メッセージがトランスポートに入る、またはトランスポートから離れる。<br />-   セキュリティ トークンが取得される。<br />-   構成設定が読み取られる。|管理者<br /><br /> アプリケーション開発者<br /><br /> 製品開発者。|  
+|Verbose|"肯定的" イベント : 正常なマイルストーンを示すイベント。|ユーザー コードとサービスの両方に対する低レベルのイベントが出力されます。|一般に、このレベルはデバッグやアプリケーションの最適化に利用できます。<br /><br /> -   認識されたメッセージ ヘッダー。|管理者<br /><br /> アプリケーション開発者<br /><br /> 製品開発者|  
+|ActivityTracing||処理アクティビティとコンポーネント間のフロー イベント。|このレベルを使用すると、管理者と開発者は同じアプリケーション ドメイン内のアプリケーションの相関関係を示すことができます。<br /><br /> -   start\/stop など、アクティビティ境界のトレース。<br />-   転送のトレース。|すべて|  
+|All||アプリケーションが正常に動作している可能性があります。すべてのイベントが出力されます。|前のすべてのイベント。|All|  
+  
+ Verbose から Critical までのレベルは相互にスタックされます。つまり、各トレース レベルには、そのレベルよりも上位のすべてのレベルが含まれます \(Off レベルを除く\)。たとえば、Warning レベルでリッスンしているリスナーは、Critical、Error、Warning の各トレースを受け取ります。All レベルには、Verbose から Critical までのイベントとアクティビティ トレース イベントが含まれます。  
+  
+> [!CAUTION]
+>  Information、Verbose、および ActivityTracing の各レベルは、多くのトレースを生成するため、コンピューターで利用可能なすべてのリソースを使い果たした場合は、メッセージ スループットに悪影響を及ぼす可能性があります。  
+  
+## アクティビティ トレースと伝達の関連付けの構成  
+ `switchValue` 属性に指定する `activityTracing` 値を使用してアクティビティ トレースを有効にし、エンドポイント内のアクティビティの境界と転送のトレースを出力できます。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の特定の拡張機能を使用する場合に、アクティビティ トレースが有効になっていると、<xref:System.NullReferenceException> が発生することがあります。この問題を解決するには、アプリケーションの構成ファイルを調べて、トレース ソースの `switchValue` 属性が `activityTracing` に設定されていないことを確認します。  
+  
+ `propagateActivity` 属性は、メッセージ交換に参加している他のエンドポイントにアクティビティを伝達する必要があるかどうかを示します。この値を `true` に設定すると、任意の 2 つのエンドポイントで生成されたトレース ファイルを取得し、一方のエンドポイントのトレース セットがもう一方のエンドポイントのトレース セットにどのように転送されるかを監視できます。  
+  
+ アクティビティのトレースと伝達[!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、「[伝達](../../../../../docs/framework/wcf/diagnostics/tracing/propagation.md)」を参照してください。  
+  
+ `propagateActivity` ブール値と `ActivityTracing` ブール値は共に System.ServiceModel TraceSource に適用されます。また、`ActivityTracing` 値は、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] またはユーザー定義トレース ソースを含む任意のトレース ソースに適用されます。  
+  
+ ユーザー定義のトレース ソースでは、`propagateActivity` 属性を使用できません。ユーザー コード アクティビティ ID の伝達では、ServiceModel `propagateActivity` 属性を `true` に設定しているときは、ServiceModel `ActivityTracing` を設定しないでください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)   
+ [方法 : トレース リスナーを作成し初期化する](http://go.microsoft.com/fwlink/?LinkId=94648)   
+ [カスタム TraceListener の作成](http://go.microsoft.com/fwlink/?LinkId=96239)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/connectionpoolmaxoutboundconnectionsperendpointquotareached.md b/docs/framework/wcf/diagnostics/tracing/connectionpoolmaxoutboundconnectionsperendpointquotareached.md
new file mode 100644
index 00000000000..4295beedc0e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/connectionpoolmaxoutboundconnectionsperendpointquotareached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectionPoolMaxOutboundConnectionsPerEndpointQuotaReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 01c1fd61-84ef-43b8-a2e8-ae64ebbd0d18
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.ConnectionPoolMaxOutboundConnectionsPerEndpointQuotaReached
+System.ServiceModel.Channels.ConnectionPoolMaxOutboundConnectionsPerEndpointQuotaReached  
+  
+## 説明  
+ MaxOutboundConnectionsPerEndpoint のクォータに達したため、接続は閉じられ、この接続プールには保存されませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/debugging-on-the-client.md b/docs/framework/wcf/diagnostics/tracing/debugging-on-the-client.md
new file mode 100644
index 00000000000..915dd704841
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/debugging-on-the-client.md
@@ -0,0 +1,20 @@
+---
+title: "クライアントでのデバッグ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56f9ad05-ea1b-4ef6-85f2-890f7ed71567
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# クライアントでのデバッグ
+[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスのクライアント アプリケーションをユーザーが簡単に記述できるようにするには、サービスの構成ファイルに [\<serviceDebug\>](../../../../../docs/framework/configure-apps/file-schema/wcf/servicedebug.md) サービス動作を追加します。この動作は、ヘルプ ページを公開し、クライアントに返される SOAP エラーの詳細にマネージ例外情報を表示するために使用できます。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md b/docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md
new file mode 100644
index 00000000000..8e5ac252696
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md
@@ -0,0 +1,151 @@
+---
+title: "ユーザー コード トレースの出力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa54186a-8ffa-4332-b0e7-63867126fd49
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ユーザー コード トレースの出力
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] により生成されるインストルメンテーション データを収集するには、構成内でトレースを有効にする方法に加えて、ユーザー コードのプログラムによりトレースを出力することもできます。  この方法では、インストルメンテーション データを能動的に作成でき、後でそのデータを診断目的で詳細に調べることができます。  ここでは、この方法について説明します。  
+  
+ また、[トレースの拡張](../../../../../docs/framework/wcf/samples/extending-tracing.md)サンプルには、次の各セクションで取り上げるすべてのコードが含まれています。  
+  
+## トレース ソースの作成  
+ ユーザー トレース ソースを作成するには、次のコードを使用できます。  
+  
+```  
+TraceSource ts = new TraceSource("myUserTraceSource");  
+```  
+  
+## アクティビティの作成  
+ アクティビティは論理的な処理単位です。  トレースをグループ化する主要な処理単位ごとに 1 つのアクティビティを作成できます。  たとえば、サービスの要求ごとに 1 つのアクティビティを作成できます。  これを行うには、次の手順を実行します。  
+  
+1.  スコープでアクティブ ID を保存します。  
+  
+2.  新しいアクティビティ ID を作成します。  
+  
+3.  スコープ内のアクティビティから新しいアクティビティに移り、スコープ内に新しいアクティビティを設定し、そのアクティビティの Start トレースを出力します。  
+  
+ 次のコードでは、この設定方法について説明します。  
+  
+```  
+Guid oldID = Trace.CorrelationManager.ActivityId;  
+Guid traceID = Guid.NewGuid();  
+ts.TraceTransfer(0, "transfer", traceID);  
+Trace.CorrelationManager.ActivityId = traceID; // Trace is static  
+ts.TraceEvent(TraceEventType.Start, 0, "Add request");  
+```  
+  
+## ユーザー アクティビティ内でのトレースの出力  
+ ユーザー アクティビティ内でトレースを出力するコードを次に示します。  
+  
+```  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+ts.TraceInformation("Client sends message to Add " + value1 + ", " + value2);  
+double result = client.Add(value1, value2);  
+ts.TraceInformation("Client receives Add response '" + result + "'");  
+```  
+  
+## アクティビティの停止  
+ アクティビティを停止するには、旧アクティビティに戻り、現在のアクティビティ ID を停止して、スコープで旧アクティビティをリセットします。  
+  
+ 次のコードでは、この設定方法について説明します。  
+  
+```  
+ts.TraceTransfer(0, "transfer", oldID);  
+ts.TraceEvent(TraceEventType.Stop, 0, "Add request");  
+Trace.CorrelationManager.ActivityId = oldID;  
+```  
+  
+## サービスへのアクティビティ ID の伝達  
+ クライアントとサービスの両方の構成ファイルで、`System.ServiceModel` トレース ソースの `propagateActivity` 属性を `true` に設定した場合、Add 要求に対するサービス処理は、クライアントに定義されたものと同じアクティビティで発生します。  サービスに独自のアクティビティと転送が定義されている場合、そのサービス トレースは、クライアントにより伝達されたアクティビティには表示されません。  その代わり、クライアントから ID が伝達されたアクティビティに、転送トレースにより、関連付けられたアクティビティにサービス トレースが表示されます。  
+  
+> [!NOTE]
+>  `propagateActivity` 属性がクライアントとサービスの両方で `true` に設定されている場合、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によりサービスの操作スコープ内のアンビエント アクティビティが設定されます。  
+  
+ 次のコードを使用して、アクティビティが [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によってスコープ内に設定されたかどうかをチェックできます。  
+  
+```  
+// Check if an activity was set in scope by WCF, if it was   
+// propagated from the client. If not, ( ambient activity is   
+// equal to Guid.Empty), create a new one.  
+if(Trace.CorrelationManager.ActivityId == Guid.Empty)  
+{  
+    Guid newGuid = Guid.NewGuid();  
+    Trace.CorrelationManager.ActivityId = newGuid;  
+}  
+// Emit your Start trace.  
+ts.TraceEvent(TraceEventType.Start, 0, "Add Activity");  
+  
+// Emit the processing traces for that request.  
+serviceTs.TraceInformation("Service receives Add "   
+                            + n1 + ", " + n2);  
+// double result = n1 + n2;  
+serviceTs.TraceInformation("Service sends Add result" + result);  
+  
+// Emit the Stop trace and exit the method scope.  
+ts.TraceEvent(TraceEventType.Stop, 0, "Add Activity");  
+// return result;  
+```  
+  
+## コード内でスローされる例外のトレース  
+ コード内で例外をスローする場合、次のコードを使用して警告以上のレベルでその例外をトレースすることもできます。  
+  
+```  
+ts.TraceEvent(TraceEventType.Warning, 0, “Throwing exception “ + “exceptionMessage”);  
+```  
+  
+## サービス トレース ビューアー ツールでのユーザー トレースの表示  
+ このセクションには、「[トレースの拡張](../../../../../docs/framework/wcf/samples/extending-tracing.md)」のサンプルを実行することによって生成されたトレースを、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)を使用して表示したときのスクリーンショットが含まれています。  
+  
+ 次の図の左ペインでは、以前に作成した “Add 要求” アクティビティが選択されています。  アプリケーション クライアント プログラムを構成する他の 3 つの算術演算アクティビティ \(Divide、Subtract、Multiply\) も表示されています。  どの要求でどのようなエラーが発生したかを明確にするため、ユーザー コードでは、操作ごとに新しいアクティビティが 1 つ定義されています。  
+  
+ 「[トレースの拡張](../../../../../docs/framework/wcf/samples/extending-tracing.md)」のサンプルでは、転送の使用方法を示すために 4 つの操作要求をカプセル化した Calculator アクティビティも作成されています。  要求があるたびに、Calculator アクティビティから該当する要求のアクティビティへ、または該当する要求のアクティビティから Calculator アクティビティへ移転します \(図の右上のパネルにトレースが表示されています\)。  
+  
+ 左のパネルでアクティビティを選択すると、そのアクティビティによって追加されたトレースが右上のパネルに表示されます。  要求パス内の各エンドポイントで `propagateActivity` に `true` が設定されている場合、要求アクティビティのトレースは、その要求に関連するすべてのプロセスから取り込まれます。  このサンプルでは、クライアントおよびサービスからのトレースをパネルの 4 番目の列で参照できます。  
+  
+ このアクティビティは次の順序で処理を行います。  
+  
+1.  クライアントはメッセージを Add に送信します。  
+  
+2.  サービスは Add 要求メッセージを受信します。  
+  
+3.  サービスは Add 応答を送信します。  
+  
+4.  クライアントは Add 応答を受信します。  
+  
+ これらすべてのトレースは、Information レベルで出力されています。  右上のパネルでトレースをクリックすると、トレースの詳細が右下のパネルに表示されます。  
+  
+ 次の図には、Calculator アクティビティと要求アクティビティ間の転送トレースに加え、1 つの要求アクティビティについて Start トレースと Stop トレースが 2 組表示されています。1 組はクライアントのトレースで、もう 1 組はサーバーのトレースです \(各トレース ソースにつき 1 組\)。  
+  
+ ![トレース ビューアー: ユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/media/242c9358-475a-4baf-83f3-4227aa942fcd.gif "242c9358\-475a\-4baf\-83f3\-4227aa942fcd")  
+作成時刻によるアクティビティのリスト \(左のパネル\)、および入れ子にされたアクティビティ \(右上のパネル\)  
+  
+ クライアントがスローする原因となる例外を、サービス コードがスローする場合 \(たとえば、クライアントが要求に対する応答を取得できなかった場合など\)、直接的な相関関係を示すために、サービスとクライアントの両方の警告メッセージまたはエラー メッセージは、同じアクティビティ内に発生します。  次の図の場合、サーバーは、"この要求をユーザー コードで処理することをサービスが拒否した" という状態を知らせる例外をスローしています。また、クライアントも、"内部エラーによりサーバーが要求を処理できない" という状態を知らせる例外をスローしています。  
+  
+ ![トレース ビューアーを使用したユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace2.gif "e2eTrace2")  
+要求アクティビティ ID が伝達された場合、どのエンドポイントで発生したかにかかわらず、その要求に関するすべてのエラーが同じアクティビティに表示されます。  
+  
+ 左パネルの Multiply アクティビティをダブルクリックすると、次のグラフが表示されます。関連するプロセスごとの Multiply アクティビティに対するトレースが示されます。  まずサービスで発生した警告 \(スローされた例外\) が表示され、それに続いて、要求を処理できなかったために発生したクライアントの警告とエラーが表示されます。  したがって、エンドポイント間のエラーの因果関係が示され、エラーの根本的な原因を導き出すことができます。  
+  
+ ![トレース ビューアーを使用したユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace3.gif "e2eTrace3")  
+エラーの相関関係のグラフ表示  
+  
+ 以前のトレースを取得するには、ユーザー トレース ソースに対して `ActivityTracing` を設定し、`System.ServiceModel` トレース ソースに対して `propagateActivity=true` を設定します。  ユーザー コード間のアクティビティの伝達を有効にするため、`System.ServiceModel` トレース ソースの `ActivityTracing` は設定されていません   \(ServiceModel アクティビティがオンになっている場合、クライアントに定義されているアクティビティ ID がサービス ユーザー コードにまで伝達されることはありません。ただし、転送は、クライアントおよびサービスのユーザー コード アクティビティと、中間の [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アクティビティを相互に関連付けます\)。  
+  
+ アクティビティを定義してアクティビティ ID を伝達することにより、エンドポイント間でエラーの直接相関関係を実行できます。  このようにして、エラーの根本原因をよりすばやく見つけることができるようになります。  
+  
+## 参照  
+ [トレースの拡張](../../../../../docs/framework/wcf/samples/extending-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md b/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md
new file mode 100644
index 00000000000..62e4f476edf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md
@@ -0,0 +1,50 @@
+---
+title: "エンドツーエンドのトレースのシナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f83b7d53-6061-4362-a9a3-ee1daf6542be
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# エンドツーエンドのトレースのシナリオ
+このセクションの各トピックで、トレースの使用に関するさまざまなシナリオを説明します。  
+  
+ 要求\/応答、一方向、双方向の各シナリオで、アクティビティ トレースを次の方法で実装します。  
+  
+-   同期または非同期  
+  
+-   BasicHttpBinding、netNamedPipeBinding、netTcpBinding、wsHttpBinding、または netMsmqBinding  
+  
+-   COM サービス  
+  
+-   ユーザー アクティビティ ID の伝達  
+  
+## このセクションの内容  
+  
+-   [アクティビティ リスト](../../../../../docs/framework/wcf/diagnostics/tracing/activity-list.md)  
+  
+-   [アクティビティ ID の伝達](../../../../../docs/framework/wcf/diagnostics/tracing/activity-id-propagation.md)  
+  
+-   [HTTP、TCP、または名前付きパイプを使用した同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/synchronous-scenarios-using-http-tcp-or-named-pipe.md)  
+  
+-   [HTTP、TCP、または名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/asynchronous-scenarios-using-http-tcp-or-named-pipe.md)  
+  
+-   [メッセージ セキュリティにおけるアクティビティ トレース](../../../../../docs/framework/wcf/diagnostics/tracing/activity-tracing-in-message-security.md)  
+  
+-   [MSMQ](../../../../../docs/framework/wcf/diagnostics/tracing/msmq.md)  
+  
+-   [COM\+](../../../../../docs/framework/wcf/diagnostics/tracing/com.md)  
+  
+## 参照  
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [エンドツーエンドのトレース](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md b/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md
new file mode 100644
index 00000000000..63f56546075
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md
@@ -0,0 +1,39 @@
+---
+title: "エンドツーエンドのトレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f5ac7fc7-f97c-4313-b068-54e0c471b2aa
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# エンドツーエンドのトレース
+エンド ツー エンド \(E2E\) のトレースを使用すると、開発者は [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] インフラストラクチャ内のコードの実行状況を追跡し、コード パスが失敗した原因を調査したり、キャパシティ プランニングやパフォーマンス分析に使用できる詳細なトレース情報を出力したりできます。  [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] には、エラーの原因の診断に役立つアクティビティ、伝達、および転送の 3 つの相関機構が用意されています。  
+  
+ エンド ツー エンドのトレースのシナリオの一覧、および各シナリオの個々のアクティビティとトレース デザインについては、「[エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)」を参照してください。  
+  
+## このセクションの内容  
+ [アクティビティ](../../../../../docs/framework/wcf/diagnostics/tracing/activity.md): [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トレース モデルのアクティビティ トレースについて説明します。  
+  
+ [転送](../../../../../docs/framework/wcf/diagnostics/tracing/transfer.md): [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トレース モデルで使用される転送と、転送を使用したエンドポイント内でのアクティビティの関連付けについて説明します。  
+  
+ [伝達](../../../../../docs/framework/wcf/diagnostics/tracing/propagation.md): [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トレース モデルで使用されるアクティビティ伝達と、伝達を使用したエンドポイント間でのアクティビティの関連付けについて説明します。  
+  
+ [トレースの種類の概要](../../../../../docs/framework/wcf/diagnostics/tracing/trace-type-summary.md)  
+  
+ すべてのアクティビティ トレースの概要を説明します。  
+  
+## 参照  
+ [トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/index.md b/docs/framework/wcf/diagnostics/tracing/index.md
new file mode 100644
index 00000000000..a67bcbcfa55
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/index.md
@@ -0,0 +1,50 @@
+---
+title: "トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2649eae2-dbf8-421c-9cfb-cfa9e01de87f
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# トレース
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] には、エラーの監視と分析のための、アプリケーションの実装と診断データが用意されています。アプリケーションの動作やエラー原因を調べるために、デバッガーの代わりにトレースを使用できます。コンポーネント間でエラーと処理を関連付けて、エンドツーエンドの調査を行うこともできます。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では次の診断トレース データが出力されます。  
+  
+-   操作呼び出し、コード例外、警告、その他の重要な処理イベントなど、アプリケーションのすべてのコンポーネントにおける処理マイルストーンのトレース。  
+  
+-   トレース機能が正しく動作しないときの Windows エラー イベント。  
+  
+## このセクションの内容  
+ [トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)  
+  
+ ここでは、特定のニーズに合うよう、さまざまなレベルでトレースを構成する方法を説明します。  
+  
+ [エンドツーエンドのトレース](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md)  
+  
+ ここでは、エンドツーエンドのトレースの相関のためのアクティビティ トレースと伝達を使用して、デバッグを支援する方法について説明します。  
+  
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)  
+  
+ ここでは、トレースを使用してアプリケーションをデバッグする方法について説明します。  
+  
+ [トレースに関するセキュリティの考慮事項と役立つヒント](../../../../../docs/framework/wcf/diagnostics/tracing/security-concerns-and-useful-tips-for-tracing.md)  
+  
+ ここでは、機密情報を漏洩の危険から守る方法と共に、WebHost を使用する場合の便利なヒントについて説明します。  
+  
+ [トレースの参照](../../../../../docs/framework/wcf/diagnostics/tracing/traces-reference.md)  
+  
+ ここでは [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] が生成するトレースをすべて列挙します。  
+  
+## 参照  
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/media/242c9358-475a-4baf-83f3-4227aa942fcd.gif b/docs/framework/wcf/diagnostics/tracing/media/242c9358-475a-4baf-83f3-4227aa942fcd.gif
new file mode 100644
index 00000000000..e8d4ddd2fdf
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/242c9358-475a-4baf-83f3-4227aa942fcd.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/asyn1.gif b/docs/framework/wcf/diagnostics/tracing/media/asyn1.gif
new file mode 100644
index 00000000000..aff081e5246
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/asyn1.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/async2.gif b/docs/framework/wcf/diagnostics/tracing/media/async2.gif
new file mode 100644
index 00000000000..07df66025fc
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/async2.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/async3.gif b/docs/framework/wcf/diagnostics/tracing/media/async3.gif
new file mode 100644
index 00000000000..912e06f270c
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/async3.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/async4.gif b/docs/framework/wcf/diagnostics/tracing/media/async4.gif
new file mode 100644
index 00000000000..c299ae206fb
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/async4.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/asynccallback1.gif b/docs/framework/wcf/diagnostics/tracing/media/asynccallback1.gif
new file mode 100644
index 00000000000..288299ecf07
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/asynccallback1.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/asynccallback2.gif b/docs/framework/wcf/diagnostics/tracing/media/asynccallback2.gif
new file mode 100644
index 00000000000..30300954bc4
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/asynccallback2.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/aynchserver.gif b/docs/framework/wcf/diagnostics/tracing/media/aynchserver.gif
new file mode 100644
index 00000000000..916a5cca9a9
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/aynchserver.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/com-tracing.gif b/docs/framework/wcf/diagnostics/tracing/media/com-tracing.gif
new file mode 100644
index 00000000000..2265544bead
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/com-tracing.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace10.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace10.gif
new file mode 100644
index 00000000000..5b05f1d69fd
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace10.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace11.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace11.gif
new file mode 100644
index 00000000000..b9508de6001
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace11.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace2.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace2.gif
new file mode 100644
index 00000000000..fec472425bf
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace2.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace3.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace3.gif
new file mode 100644
index 00000000000..434a7656eee
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace3.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace4.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace4.gif
new file mode 100644
index 00000000000..6c462e843da
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace4.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace5.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace5.gif
new file mode 100644
index 00000000000..4cebe8bd027
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace5.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace6.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace6.gif
new file mode 100644
index 00000000000..fab4bedb4ae
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace6.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace7.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace7.gif
new file mode 100644
index 00000000000..dd35e73e686
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace7.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/e2etrace8.gif b/docs/framework/wcf/diagnostics/tracing/media/e2etrace8.gif
new file mode 100644
index 00000000000..46c55dfa6e3
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/e2etrace8.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/sync.gif b/docs/framework/wcf/diagnostics/tracing/media/sync.gif
new file mode 100644
index 00000000000..7da20d16249
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/sync.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/media/wcfc-e2etrace9s.gif b/docs/framework/wcf/diagnostics/tracing/media/wcfc-e2etrace9s.gif
new file mode 100644
index 00000000000..29a1073036f
Binary files /dev/null and b/docs/framework/wcf/diagnostics/tracing/media/wcfc-e2etrace9s.gif differ
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-commitmessageretry.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-commitmessageretry.md
new file mode 100644
index 00000000000..0b739dd7674
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-commitmessageretry.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.CommitMessageRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4abe01f0-6398-4fba-b2f3-c054b7f7e971
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.CommitMessageRetry
+コミット メッセージの再試行は、応答しない参加要素に送信されました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが一定時間内に応答を受信せず、下位の参加要素にコミット メッセージを再送信する必要があった場合にトレースされます。  
+  
+## トラブルシューティング  
+ 応答が時間どおりに配信されない原因となっている可能性のあるネットワークや製品の問題について調査します。このメッセージが多数表示される場合は、インフラストラクチャに問題があるか、または応答時間が異常に長くなっている可能性があります。いずれの問題によっても、システム内のトランザクションのスループットが大幅に低下します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorrecovered.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorrecovered.md
new file mode 100644
index 00000000000..6251d3a513e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorrecovered.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.CoordinatorRecovered | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a70f7b3c-e3fc-44e7-aace-32fb0086a566
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.CoordinatorRecovered
+コーディネーターの登録リストが、トランザクション マネージャー ログから回復されました。  
+  
+## 説明  
+ 指定した上位のコーディネーターの登録リストがローカル トランザクション マネージャーによって正常に回復されたときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorstatemachinefinished.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorstatemachinefinished.md
new file mode 100644
index 00000000000..e89aacfab8b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorstatemachinefinished.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.CoordinatorStateMachineFinished | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16cb428d-d886-4789-a961-6fded4b0dbba
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.CoordinatorStateMachineFinished
+コーディネーターの登録リストのステート マシンが完了状態になりました。  
+  
+## 説明  
+ 上位のコーディネーターの登録リストが 2PC 処理を完了したとローカル トランザクション マネージャーが判断したときに、トレースされます。登録リストの結果は、Committed、Aborted、または Forgotten のいずれかです。ローカル トランザクション マネージャーが準備中に読み取り専用にする場合にもトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-createtransactionfailure.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-createtransactionfailure.md
new file mode 100644
index 00000000000..4f6c0d8c193
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-createtransactionfailure.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.CreateTransactionFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c3468e23-49a9-4a84-972d-a79a658851b3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.CreateTransactionFailure
+トランザクションを作成できませんでした。  
+  
+## 説明  
+ このトレースは、MSDTC がトランザクションを作成できないときに生成されます。  原因として、リソース不足、ログ領域の不足、またはその他のエラーが考えられます。  
+  
+## トラブルシューティング  
+ トレース メッセージ内のステータス文字列を調べて、アクション可能な項目が存在するかどうかを確認します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlistmentidentitycheckfailed.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlistmentidentitycheckfailed.md
new file mode 100644
index 00000000000..5ff9f3ffc7b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlistmentidentitycheckfailed.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.EnlistmentIdentityCheckFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74aeb3e7-f9eb-4491-9e78-5f8c9cbcb434
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.EnlistmentIdentityCheckFailed
+受信メッセージの送信者の ID が登録リストのエンドポイント参照から派生した ID と一致しませんでした。  
+  
+## 説明  
+ メッセージ セキュリティの検証に失敗した場合にトレースされます。  
+  
+## トラブルシューティング  
+ トランザクションに参加するすべてのコンピューターに対して、トランザクション セキュリティが正しく構成されていることを確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlisttransaction.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlisttransaction.md
new file mode 100644
index 00000000000..f8ee510f551
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlisttransaction.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.EnlistTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba793c1d-6b2f-43da-b14d-a825c6c31b01
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.EnlistTransaction
+WS\-AtomicTransaction プロトコル サービスが、指定された調整コンテキストを使うトランザクションに正常に登録されました。  
+  
+## 説明  
+ 受信トランザクションが正常に処理されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantrecovered.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantrecovered.md
new file mode 100644
index 00000000000..9f5ad12de71
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantrecovered.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.ParticipantRecovered | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: be6f1ede-2b05-437d-8f86-165dc9968a35
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.ParticipantRecovered
+参加要素の登録リストが、トランザクション マネージャー ログから回復されました。  
+  
+## 説明  
+ 指定した下位参加要素の登録リストがローカル トランザクション マネージャーによって正常に回復されたときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantstatemachinefinished.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantstatemachinefinished.md
new file mode 100644
index 00000000000..af299240dd2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantstatemachinefinished.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.ParticipantStateMachineFinished | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54b677f7-03ad-40f2-9c5d-297a8ad9bf90
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.ParticipantStateMachineFinished
+参加要素の登録リストのステート マシンは完了状態になりました。  
+  
+## 説明  
+ 下位参加要素登録リストの 2PC 処理が完了したときにトレースされます。登録リストの結果は、Committed または Aborted のいずれかです。準備中、すべての参加要素を読み取り専用にする場合にもトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparedmessageretry.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparedmessageretry.md
new file mode 100644
index 00000000000..de78f226964
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparedmessageretry.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.PreparedMessageRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2194292d-bf5f-4aef-9336-cd3c4795cb71
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.PreparedMessageRetry
+準備メッセージの再試行は、応答しないコーディネーターに送信されました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが一定時間内に応答を受信せず、上位のコーディネーターに準備メッセージを再送信する必要があった場合にトレースされます。  
+  
+## トラブルシューティング  
+ 応答が時間どおりに配信されない原因となっている可能性のあるネットワークや製品の問題について調査します。このメッセージが多数表示される場合は、インフラストラクチャに問題があるか、または応答時間が異常に長くなっている可能性があります。いずれの問題によっても、システム内のトランザクションのスループットが大幅に低下します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparemessageretry.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparemessageretry.md
new file mode 100644
index 00000000000..6d14bebfa0a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparemessageretry.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.PrepareMessageRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ada4baa5-b60d-46b8-ad46-4d69f8d8a9fa
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.PrepareMessageRetry
+応答しない参加要素に、準備メッセージの再試行が送信されました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが一定時間内に応答を受信せず、下位の参加要素に準備メッセージを再送信する必要があった場合にトレースされます。  
+  
+## トラブルシューティング  
+ 応答が時間どおりに配信されない原因となっている可能性のあるネットワークや製品の問題について調査します。このメッセージが多数表示される場合、インフラストラクチャに問題があるか、または応答時間が異常にかかっていることを示します。いずれの問題によっても、システム内のトランザクションのスループットが大幅に低下する場合があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolinitialized.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolinitialized.md
new file mode 100644
index 00000000000..ae50df599c2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolinitialized.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.ProtocolInitialized | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 166dfa2d-10de-447a-b76f-3b64752a2967
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.ProtocolInitialized
+WS\-AtomicTransaction プロトコル サービスが初期化されました。  
+  
+## 説明  
+ 正常に初期化されたプロトコルを示すために、トランザクション マネージャーの起動時にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolstarted.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolstarted.md
new file mode 100644
index 00000000000..8b7ba22c304
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolstarted.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.ProtocolStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac770da2-218e-4708-aeb5-465369c94a8d
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.ProtocolStarted
+WS\-AtomicTransaction プロトコル サービスが開始されました。  
+  
+## 説明  
+ 正常に開始されたプロトコルを示すために、トランザクション マネージャーの起動時にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredcoordinatorinvalidmetadata.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredcoordinatorinvalidmetadata.md
new file mode 100644
index 00000000000..2ece96ace17
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredcoordinatorinvalidmetadata.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RecoveredCoordinatorInvalidMetadata | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99ebe70b-8980-447f-b785-ecfcbdbaea72
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RecoveredCoordinatorInvalidMetadata
+コーディネーターの回復ログ エントリで見つかったエンドポイント参照は、無効または互換性のないメタデータを含んでいます。  
+  
+## 説明  
+ システムは、復元されたコーディネーター登録リスト用のプロキシを作成できません。  
+  
+## トラブルシューティング  
+ 問題が再発する場合は、マイクロソフトに連絡してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredparticipantinvalidmetadata.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredparticipantinvalidmetadata.md
new file mode 100644
index 00000000000..ab6e15fe184
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredparticipantinvalidmetadata.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RecoveredParticipantInvalidMetadata | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d38eb27-bb00-4d7e-a234-50de8d90a0f9
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RecoveredParticipantInvalidMetadata
+参加要素の回復ログ エントリで見つかったエンドポイント参照は、無効であるか、互換性のないメタデータを含んでいます。  
+  
+## 説明  
+ システムは回復された参加要素登録リストのプロキシを作成できません。  
+  
+## トラブルシューティング  
+ 問題が再発する場合は、マイクロソフトに連絡してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registercoordinator.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registercoordinator.md
new file mode 100644
index 00000000000..74cdc886258
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registercoordinator.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegisterCoordinator | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ebd69e9a-7a89-4a42-8f68-e756f8807a1a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RegisterCoordinator
+WS\-AtomicTransaction プロトコル サービスは、制御プロトコルのコーディネーターと共に正常に登録されました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーがその上位のトランザクション マネージャーに正常に登録されたときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipant.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipant.md
new file mode 100644
index 00000000000..1ce888d1f28
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipant.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegisterParticipant | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8888fd0a-d454-4123-88de-fa3290102306
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RegisterParticipant
+WS\-AtomicTransaction プロトコル サービスは、制御プロトコルの参加要素の登録に成功しました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが、2pc プロトコルの参加要素からの Register 要求を正常に受信確認したときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipantfailure.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipantfailure.md
new file mode 100644
index 00000000000..6666cb42ee0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipantfailure.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegisterParticipantFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3a4ead79-8550-4037-84e3-fd70ff56e001
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RegisterParticipantFailure
+WS\-AT プロトコル サービスは、制御プロトコルの参加要素の登録に失敗しました。  
+  
+## 説明  
+ MSDTC により無効な登録要求が検出された場合にトレースされます。これは、複数の完了登録要求や内部エラーによって発生することがあります。  
+  
+## トラブルシューティング  
+ 完了を複数回登録しないでください。また、トレース メッセージ内のステータス文字列を調べて、アクション可能な項目が存在するかどうかを確認します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfailed.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfailed.md
new file mode 100644
index 00000000000..56d0ff112a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfailed.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96474056-0418-41e4-8c75-bbc0a853eaba
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFailed
+WS\-AT プロトコル サービスは、Register メッセージをコーディネーターに送信できませんでした。  
+  
+## 説明  
+ メッセージを送信できないために、ローカルの TransactionManager がその上位の TransactionManager に登録できない場合にトレースされます。  
+  
+## トラブルシューティング  
+ トレース メッセージを調べて、メッセージの送信エラーの原因となった例外を確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfaulted.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfaulted.md
new file mode 100644
index 00000000000..68039fa85a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfaulted.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8193027e-9db2-4af9-a072-27300cd24330
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFaulted
+WS\-AT プロトコル サービスは、Register メッセージへの応答として、コーディネーターからエラーを受信しました。  
+  
+## 説明  
+ エラーが返されたためにローカルの TransactionManager がその上位の TransactionManager に登録できない場合に、トレースされます。  
+  
+## トラブルシューティング  
+ トレース メッセージを調べて、返されたエラーを確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorresponseinvalidmetadata.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorresponseinvalidmetadata.md
new file mode 100644
index 00000000000..765d561c896
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorresponseinvalidmetadata.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.MessageCountLimitExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d80e2009-d421-40bb-8e68-eb5ca4a0e91a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.MessageCountLimitExceeded
+System.ServiceModel.Diagnostics.MessageCountLimitExceeded  
+  
+## 説明  
+ ログに記録するメッセージの制限に達しました。  メッセージ ログは停止します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-replaymessageretry.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-replaymessageretry.md
new file mode 100644
index 00000000000..177722e6287
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-replaymessageretry.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.ReplayMessageRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5b820ae-504d-405a-926a-9effa41d2369
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.ReplayMessageRetry
+リプレイ メッセージの再試行は、応答しないコーディネーターに送信されました。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが一定時間内に応答を受信せず、上位のコーディネーターにリプレイ メッセージを再送信する必要があった場合にトレースされます。  
+  
+## トラブルシューティング  
+ 応答が時間どおりに配信されない原因となっている可能性のあるネットワークや製品の問題について調査します。  このメッセージが多数表示される場合、インフラストラクチャに問題があるか、または応答時間が異常にかかっていることを示します。  いずれの問題によっても、システム内のトランザクションのスループットが大幅に低下します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileoutcometimeout.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileoutcometimeout.md
new file mode 100644
index 00000000000..3884f235525
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileoutcometimeout.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.VolatileOutcomeTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2dbe34c5-57c7-4b64-9257-63021911d03c
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.VolatileOutcomeTimeout
+不安定な参加要素からの結果メッセージに対する応答を受信するのを待機しているときに WS\-AT プロトコル サービスがタイムアウトしました。受信者が応答した場合、トランザクションの結果が不明である場合があります。  
+  
+## 説明  
+ 不安定な参加要素がコミットまたは中止を決定したが、一定時間内にコミット要求またはロールバック要求に応答していない場合にトレースされます。  
+  
+## トラブルシューティング  
+ 不安定な参加要素がすべて一定時間内に応答できることを確認します。既定の時間は 180 秒です。この時間が不十分な場合は、WS\-AT の `VolatileOutcomeDelay` タイマー ポリシーを増やします。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileparticipantindoubt.md b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileparticipantindoubt.md
new file mode 100644
index 00000000000..d6375c979b4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileparticipantindoubt.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.VolatileParticipantInDoubt | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3e8fc825-9f22-47e7-9c16-d64ef291c932
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.VolatileParticipantInDoubt
+WS\-AT プロトコル サービスは、認識されない不安定な参加要素からの準備メッセージまたはリプレイ メッセージを受信しました。参加要素にエラーが返されました。この結果、トランザクションの結果が不明であると宣言します。  
+  
+## 説明  
+ ローカル トランザクション マネージャーが、既に認識していない揮発性参加リストからの準備メッセージまたはリプレイ メッセージを受信するとトレースされます。  
+  
+## トラブルシューティング  
+ 不安定な参加要素からメッセージが遅れて届く原因を調査してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/msmq.md b/docs/framework/wcf/diagnostics/tracing/msmq.md
new file mode 100644
index 00000000000..036a8f7be0c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/msmq.md
@@ -0,0 +1,26 @@
+---
+title: "MSMQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9fca29f-fa44-4ec4-bb48-b10800694500
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# MSMQ
+MSMQ アプリケーションでは、キューに置かれたチャネルから MSMQに、および MSMQ からキューに置かれたチャネルに追加アクティビティは転送されません。  
+  
+ さらに、MSMQ メッセージ ID と SOAP メッセージ ID \(および、存在する場合はアクティビティ ID\) は、キューに置かれたチャネルのトレースの一部として送信操作を追跡されます。  
+  
+ MSMQ メッセージ ID と SOAP メッセージ ID \(および、存在する場合はアクティビティ ID\) は、キューに置かれたチャネルのトレースの一部として受信操作を追跡されます。  
+  
+ 受信操作で必要な転送については、他のトランスポートと同様に実行されます \(受信バイト\-\>プロセス メッセージ\-\> 操作\)。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/mts-registrationcoordinatorresponseinvalidmetadata.md b/docs/framework/wcf/diagnostics/tracing/mts-registrationcoordinatorresponseinvalidmetadata.md
new file mode 100644
index 00000000000..2032b5346bf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/mts-registrationcoordinatorresponseinvalidmetadata.md
@@ -0,0 +1,28 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorResponseInvalidMetadata | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a174bbf5-0ffe-4fda-969d-e7fbd1996123
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorResponseInvalidMetadata
+WS\-AtomicTransaction プロトコル サービスは、無効または互換性のないメタデータのあるエンドポイント参照を含むそのコーディネーターから、RegisterResponse メッセージを受信しました。  
+  
+## 説明  
+ ローカルのトランザクション マネージャーが、その上位のトランザクション マネージャーに登録を試み、上位のトランザクション マネージャーが、RegisterResponse メッセージ内の無効なアドレスを返すときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/mtt-durableparticipantreplaywhilepreparing.md b/docs/framework/wcf/diagnostics/tracing/mtt-durableparticipantreplaywhilepreparing.md
new file mode 100644
index 00000000000..f8e8c9bb366
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/mtt-durableparticipantreplaywhilepreparing.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.DurableParticipantReplayWhilePreparing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 10ef3876-6f8e-4d4e-8444-f47847b64795
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.DurableParticipantReplayWhilePreparing
+WS\-AT プロトコル サービスは、準備メッセージに応答していない永続的な参加要素から、リプレイ メッセージを受信しました。そのため、トランザクションが中止されました。  
+  
+## 説明  
+ 永続的な参加要素がまだ準備している間にリプレイ メッセージが受信された場合は、トレースされます。これは、この状態に対して無効なメッセージであり、トランザクションは中止されます。  
+  
+## トラブルシューティング  
+ このエラー メッセージは、永続的な参加要素 \(下位トランザクション マネージャーを含む\) がエラーから回復したが、トランザクション結果が不明であるため、状態を要求していることを示している場合があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/propagation.md b/docs/framework/wcf/diagnostics/tracing/propagation.md
new file mode 100644
index 00000000000..d81880083bf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/propagation.md
@@ -0,0 +1,92 @@
+---
+title: "伝達 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8181e75-d693-48d1-b333-a776ad3b382a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 伝達
+このトピックでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] トレース モデルのアクティビティ伝達について説明します。  
+  
+## 伝達を使用したエンドポイント間でのアクティビティの関連付け  
+ 伝達を使用することで、複数のアプリケーション エンドポイントについて、同じ処理単位 \(要求など\) のエラー トレースを直接関連付けることができます。  さまざまなエンドポイントで発生した同じ処理単位のエラーは、アプリケーション ドメインが異なる場合でも同じアクティビティとしてグループ化されます。  これは、メッセージ ヘッダーで特定のアクティビティ ID を伝達することによって実現されます。  したがって、サーバーの内部エラーによってクライアントがタイムアウトした場合、これらのエラーは直接関係しているので、どちらも同じアクティビティに表示されます。  
+  
+ これを行うには、前述の例に示すように `ActivityTracing` 設定を使用します。  さらに、すべてのエンドポイントで `System.ServiceModel` トレース ソースの `propagateActivity` 属性を設定します。  
+  
+```  
+<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing" propagateActivity=”true” >  
+```  
+  
+ アクティビティの伝達は構成可能な機能です。この機能を構成すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は TLS のアクティビティ ID が含まれたヘッダーを送信メッセージに追加します。  サーバー側の以降のトレースでこの ID を含めることにより、クライアントとサーバーのアクティビティを相互に関連付けることができます。  
+  
+## 伝達の定義  
+ 次のすべての条件に該当する場合に、アクティビティ M の gAId がアクティビティ N に伝達されます。  
+  
+-   M に起因して N が作成された。  
+  
+-   M の gAId を N が認識している。  
+  
+-   N の gAId と M の gAId が同じである。  
+  
+ 次の XML スキーマに示すように、gAId は ActivityId メッセージ ヘッダーによって伝達されます。  
+  
+```  
+<xsd:element name=”ActivityId” type=”integer” minOccurs=”0”>  
+  <xsd:attribute name=”CorrelationId” type=”integer” minOccurs=”0”/>  
+</xsd:element>  
+```  
+  
+ メッセージ ヘッダーの例を次に示します。  
+  
+```  
+<MessageLogTraceRecord>  
+  <s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"     
+                      xmlns:a="http://www.w3.org/2005/08/addressing">  
+    <s:Header>  
+      <a:Action s:mustUnderstand="1">http://Microsoft.ServiceModel.Samples/ICalculator/Subtract  
+      </a:Action>  
+      <a:MessageID>urn:uuid:f0091eae-d339-4c7e-9408-ece34602f1ce  
+      </a:MessageID>  
+      <ActivityId CorrelationId="f94c6af1-7d5d-4295-b693-4670a8a0ce34"   
+  
+               xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">  
+        17f59a29-b435-4a15-bf7b-642ffc40eac8  
+      </ActivityId>  
+      <a:ReplyTo>  
+          <a:Address>http://www.w3.org/2005/08/addressing/anonymous  
+          </a:Address>  
+      </a:ReplyTo>  
+      <a:To s:mustUnderstand="1">net.tcp://localhost/servicemodelsamples/service</a:To>  
+   </s:Header>  
+   <s:Body>  
+     <Subtract xmlns="http://Microsoft.ServiceModel.Samples">  
+       <n1>145</n1>  
+       <n2>76.54</n2>  
+     </Subtract>  
+   </s:Body>  
+  </s:Envelope>  
+</MessageLogTraceRecord>  
+```  
+  
+## 伝達とアクティビティ境界  
+ エンドポイント間でアクティビティ ID が伝達されると、メッセージの受信側は、その \(伝達された\) アクティビティ ID を使用して Start トレースと Stop トレースを出力します。  したがって、各トレース ソースごとに、該当の gAId を持つ Start\/Stop トレースが存在することになります。  複数のエンドポイントが同じプロセス内に存在し、同じトレース ソース名を使用している場合、同じ lAId \(同じ gAId、同じトレース ソース、同じプロセス\) を持つ複数の Start と Stop が作成されます。  
+  
+## 同期  
+ 異なるコンピューター上で実行されるエンドポイント間でイベントを同期するには、メッセージ内で伝達される ActivityId ヘッダーに CorrelationId を追加します。  ツールはこの ID を使用することにより、クロックにずれのあるコンピューター間でもイベントを同期できます。  具体的に言うと、サービス トレース ビューアー ツールは、エンドポイント間のメッセージ フローを示す際に、この ID を使用します。  
+  
+## 参照  
+ [トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md b/docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md
new file mode 100644
index 00000000000..f2432f9cebf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md
@@ -0,0 +1,123 @@
+---
+title: "トレースとメッセージ ログの推奨設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6aca6e8-704e-4779-a9ef-50c46850249e
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# トレースとメッセージ ログの推奨設定
+このトピックでは、さまざまな動作環境における、推奨されるトレースとメッセージ ログの設定について説明します。  
+  
+## 本運用環境での推奨される設定  
+ 本運用環境で WCF トレース ソースを使用する場合は、`switchValue` を Warning に設定します。  WCF `System.ServiceModel` トレース ソースを使用する場合は、`switchValue` 属性を `Warning` に設定し、`propagateActivity` 属性を `true` に設定します。  ユーザー定義のトレース ソースを使用する場合は、`switchValue` 属性を `Warning, ActivityTracing` に設定します。  これは、[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) を使用して手動で実行できます。  前述のすべての場合において、パフォーマンスに影響しないと思われる場合は、`switchValue` 属性を `Information` に設定できます。これにより、相当な量のトレース データが生成されます。  次の例に、これらの推奨設定を示します。  
+  
+```  
+<configuration>  
+ <system.diagnostics>  
+  <sources>  
+    <source name="System.ServiceModel"  
+            switchValue="Warning"  
+            propagateActivity="true" >  
+      <listeners>  
+        <add name="xml"/>  
+      </listeners>  
+    </source>  
+    <source name="myUserTraceSource"  
+            switchValue="Warning, ActivityTracing">  
+      <listeners>  
+        <add name="xml"/>  
+      </listeners>  
+    </source>  
+  </sources>  
+  <sharedListeners>  
+    <add name="xml"  
+         type="System.Diagnostics.XmlWriterTraceListener"  
+               initializeData="C:\logs\Traces.svclog" />  
+  </sharedListeners>  
+ </system.diagnostics>  
+  
+<system.serviceModel>  
+  <diagnostics wmiProviderEnabled="true">  
+  </diagnostics>  
+ </system.serviceModel>  
+</configuration>  
+```  
+  
+## 展開またはデバッグでの推奨される設定  
+ 展開またはデバッグ環境では、`Information` または `Verbose` を選択すると共に、ユーザー定義のトレース ソースまたは `System.ServiceModel` トレース ソースの場合は `ActivityTracing` を選択します。  また、デバッグ機能を向上させるには、トレース ソース \(`System.ServiceModel.MessageLogging`\) を構成に追加してメッセージ ログを有効にする必要があります。  `switchValue` 属性はこのトレース ソースに影響しません。  
+  
+ 次の例に、`XmlWriterTraceListener` を利用した共有リスナーを使用する推奨設定を示します。  
+  
+```  
+<configuration>  
+ <system.diagnostics>  
+  <sources>  
+    <source name="System.ServiceModel"  
+            switchValue="Information, ActivityTracing"  
+            propagateActivity="true" >  
+      <listeners>  
+        <add name="xml"/>  
+      </listeners>  
+    </source>  
+    <source name="System.ServiceModel.MessageLogging">  
+      <listeners>  
+        <add name="xml"/>  
+      </listeners>  
+    </source>  
+    <source name="myUserTraceSource"  
+            switchValue="Information, ActivityTracing">  
+      <listeners>  
+        <add name="xml"/>  
+      </listeners>  
+    </source>  
+  </sources>  
+  <sharedListeners>  
+    <add name="xml"  
+         type="System.Diagnostics.XmlWriterTraceListener"  
+               initializeData="C:\logs\Traces.svclog" />  
+  </sharedListeners>  
+ </system.diagnostics>  
+  
+ <system.serviceModel>  
+  <diagnostics wmiProviderEnabled="true">  
+      <messageLogging   
+           logEntireMessage="true"   
+           logMalformedMessages="true"  
+           logMessagesAtServiceLevel="true"   
+           logMessagesAtTransportLevel="true"  
+           maxMessagesToLog="3000"   
+       />  
+  </diagnostics>  
+ </system.serviceModel>  
+</configuration>  
+```  
+  
+## WMI を使用した設定変更  
+ WMI を使用して実行時に構成設定を変更できます \(前述の構成例のように構成の `wmiProviderEnabled` 属性を有効にします\)。  たとえば、CIM Studio 内で WMI を使用し、実行時にトレース ソース レベルを Warning から Information に変更できます。  この方法でライブ デバッグを実行した場合のパフォーマンスへの負荷は非常に高くなる可能性があるので注意が必要です。  WMI の使用方法の詳細については、「[診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../../docs/framework/wcf/diagnostics/wmi/index.md)」を参照してください。  
+  
+## ASP.NET トレースでの相関イベントの有効化  
+ ASP.NET イベントでは、ASP.NET イベントのトレースが有効になっていないと、相関 ID \(ActivityID\) が設定されません。  相関イベントを適切に表示するには、**\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして「**cmd**」と入力することで、起動するコマンド コンソールで次のコマンドを使用して、ASP.NET イベントのトレースを有効にします。  
+  
+```  
+logman start mytrace -pf logman.providers -o test.etl –ets  
+```  
+  
+ ASP.NET イベントのトレースを無効にするには、次のコマンドを使用します。  
+  
+```  
+logman stop mytrace -ets  
+```  
+  
+## 参照  
+ [診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../../docs/framework/wcf/diagnostics/wmi/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/security-concerns-and-useful-tips-for-tracing.md b/docs/framework/wcf/diagnostics/tracing/security-concerns-and-useful-tips-for-tracing.md
new file mode 100644
index 00000000000..77d1647ef0e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/security-concerns-and-useful-tips-for-tracing.md
@@ -0,0 +1,101 @@
+---
+title: "トレースに関するセキュリティの考慮事項と役立つヒント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88bc2880-ecb9-47cd-9816-39016a07076f
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# トレースに関するセキュリティの考慮事項と役立つヒント
+ここでは、機密情報を漏洩の危険から守る方法と共に、WebHost を使用する場合の便利なヒントについて説明します。  
+  
+## WebHost でのカスタム トレース リスナーの使用  
+ 独自のリスナーを作成している場合、WebHost サービスではトレースが失われる可能性があることを認識する必要があります。WebHost をリサイクルすると、実行中のプロセスがシャットダウンされ、複製されたプロセスに引き継がれます。この 2 つのプロセスは、しばらくの間、引き続き同じリソースにアクセスできる必要がありますが、これはリスナーの種類に依存します。この場合、`XmlWriterTraceListener` は、2 番目のプロセスに対して新しいトレース ファイルを作成します。一方、Windows のイベント トレースは、同じセッションの複数のプロセスを管理して、同じファイルへのアクセス権を付与します。したがって、独自に作成したリスナーが同様の機能を提供しない場合、この 2 つのプロセスによってファイルがロックされたときにトレースが失われる可能性があります。  
+  
+ カスタム トレース リスナーがネットワーク上で \(たとえば、リモート データベースに\) トレースとメッセージを送信する場合があることを認識する必要もあります。アプリケーションを展開するユーザーは、適切なアクセス制御を提供するカスタム リスナーを構成する必要があります。また、遠隔地で公開される可能性があるすべての個人情報にセキュリティ制御を適用する必要もあります。  
+  
+## 機密情報のログ記録  
+ スコープ内のメッセージに含まれるメッセージ ヘッダーをトレースします。トレースが有効になっていると、アプリケーション固有のヘッダー内にある個人情報 \(クエリ文字列など\)、および本文情報 \(クレジット カード番号など\) をログで確認できるようになります。アプリケーションを展開するユーザーは、構成ファイルとトレース ファイルに対するアクセス制御を実施する必要があります。この種の情報を表示しないようにするには、トレースを無効にします。トレース ログを共有する場合は、表示しないデータをフィルターで除外します。  
+  
+ トレース ファイルの内容が意図せず公開されることを防ぐために、次のヒントに従ってください。  
+  
+-   WebHost および自己ホストの両方のシナリオにおいて、ログ ファイルがアクセス制御リスト \(ACL\) によって保護されていることを確認します。  
+  
+-   Web 要求を使用して簡単に処理できないファイル拡張子を選択します。たとえば、.xml ファイルの拡張子を選ぶのは安全ではありません。IIS の管理ガイドを参照して、処理できる拡張子のリストを確認します。  
+  
+-   ログ ファイルのある場所への絶対パスを指定します。この場所は、部外者が Web ブラウザーを使用してアクセスできないように、WebHost の vroot パブリック ディレクトリの外にします。  
+  
+ 既定では、キーおよびユーザー名やパスワードなどの個人を特定できる情報 \(PII\) は、トレースおよびログに記録するメッセージではありません。しかし、コンピューターの管理者は、Machine.config ファイルの `machineSettings` 要素にある `enableLoggingKnownPII` 属性を使用して、コンピューター上で実行されているアプリケーションに対し、既知の PII \(個人を特定できる情報\) のログ記録を許可できます。次のコード例を参照してください。  
+  
+```  
+<configuration>  
+   <system.ServiceModel>  
+      <machineSettings enableLoggingKnownPii="Boolean"/>  
+   </system.ServiceModel>  
+</configuration>   
+```  
+  
+ アプリケーションを配置するユーザーが App.config ファイルか Web.config ファイルのいずれかで `logKnownPii` 属性を使用することで 、PII ログを可能にする方法を次に示します。  
+  
+```  
+<system.diagnostics>  
+  <sources>  
+      <source name="System.ServiceModel.MessageLogging"  
+        logKnownPii="true">  
+        <listeners>  
+                 <add name="messages"  
+                 type="System.Diagnostics.XmlWriterTraceListener"  
+                 initializeData="c:\logs\messages.svclog" />  
+          </listeners>  
+      </source>  
+  </sources>  
+</system.diagnostics>  
+```  
+  
+ 両方の設定が `true` の場合にのみ、PII はログに記録されます。2 種類のスイッチを組み合わせることで、各アプリケーションで既知の PII のログを柔軟に記録できるようになります。  
+  
+ 構成ファイルで 2 種類以上のカスタム ソースを指定しても、最初のソースの属性のみが読み込まれることに注意してください。他の属性は無視されます。つまり、2 番目以降の App.config ファイルでは、PII はいずれのソースでもログに記録されなくなります。これは 2 番目のソースで PII のログ記録を明示的に有効にした場合でも同様です。  
+  
+```  
+<system.diagnostics>  
+  <sources>  
+      <source name="System.ServiceModel.MessageLogging"  
+        logKnownPii="false">  
+        <listeners>  
+           <add name="messages"  
+                type="System.Diagnostics.XmlWriterTraceListener"  
+                initializeData="c:\logs\messages.svclog" />  
+          </listeners>  
+      </source>  
+      <source name="System.ServiceModel"   
+         logKnownPii="true">  
+         <listeners>  
+            <add name="xml" />  
+         </listeners>  
+      </source>  
+  </sources>  
+</system.diagnostics>  
+```  
+  
+ `<machineSettings enableLoggingKnownPii="Boolean"/>` の要素が Machine.config ファイルに含まれていない場合、システムは <xref:System.Configuration.ConfigurationErrorsException> をスローします。  
+  
+ 変更点はアプリケーションが開始されるか、再起動されるまで、反映されません。両方の属性も `true` に設定されている場合は、イベントは開始時にログに記録されます。また、`logKnownPii` が `true` に設定され、`enableLoggingKnownPii` が `false` に設定されている場合にも、イベントはログに記録されます。  
+  
+ PII ログ記録の詳細については、「[PII セキュリティ ロックダウン](../../../../../docs/framework/wcf/samples/pii-security-lockdown.md)」のサンプルを参照してください。  
+  
+ コンピューターの管理者およびアプリケーションを配置するユーザーは、これらの 2 種類のスイッチを使用する場合に注意する必要があります。PII のログ記録が有効になっている場合は、セキュリティ キーと PII がログに記録されます。ログ記録を無効にしても、機密情報およびアプリケーション固有のデータは、依然としてメッセージのヘッダーと本体に記録されています。プライバシーと PII の公開を防止するための詳細な説明については、「[User Privacy](http://go.microsoft.com/fwlink/?LinkID=94647)」を参照してください。  
+  
+ また、接続が確立されるたび \(接続指向トランスポートの場合\)、またはメッセージが送信されるたび \(それ以外の場合\) に、メッセージ送信者の IP アドレスが記録されます。これは、送信者の同意を得ずに行われます。ただし、このログ記録は Information レベルまたは Verbose レベルだけで実行されます。これらのトレース レベルは既定ではありません。また、ライブ デバッグを行う場合を除き、運用環境ではお勧めしません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/significant-traces.md b/docs/framework/wcf/diagnostics/tracing/significant-traces.md
new file mode 100644
index 00000000000..d40902f7f59
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/significant-traces.md
@@ -0,0 +1,31 @@
+---
+title: "重要なトレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40a1770e-3b09-4142-b0dd-f9ef73642074
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 重要なトレース
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] によって出力される主要なトレースの一部を示します。  
+  
+## 重要なトレース  
+  
+|トレース|説明|  
+|----------|--------|  
+|Message Log トレース|このトレースは、`System.ServiceModel.MessageLogging` トレース ソースが有効な場合に、メッセージ ログ機能によって [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージがログに記録されるときに出力されます。このトレースをクリックすると、メッセージが表示されます。メッセージには、構成可能なログ ポイントが 4 つ \(`ServiceLevelSendRequest`、`TransportSend`、`TransportReceive`、`ServiceLevelReceiveRequest`\) あり、これらは、メッセージ ログ トレースの Message Source 属性にも示されます。|  
+|Message Received トレース|このトレースは、`System.ServiceModel` トレース ソースが Information レベルか Verbose レベルで有効な場合に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージが受信されるときに出力されます。このトレースはアクティビティのグラフ ビューでメッセージの相関矢印を表示するために必要です。|  
+|Message Sent トレース|このトレースは、`System.ServiceModel` トレース ソースが Information レベルか Verbose レベルで有効な場合に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージが送信されるときに出力されます。このトレースはアクティビティのグラフ ビューでメッセージの相関矢印を表示するために必要です。|  
+|Get ChannelEndpointElement|このトレースは、情報レベルで Construct チャネル ファクトリに出力されます。このトレースには、クライアントが対話しているエンドポイントの説明 \(リモート アドレス、バインディング、コントラクト名など\) が表示されます。|  
+|Get ServiceElement|このトレースは、情報レベルで Construct サービス ホストに出力されます。サービス コントラクトとバインディングの説明が提供されます。|  
+|SocketConnection Create|このトレースは、クライアントによって実行される最初の "プロセス" アクションおよびサービスの "バイトを受信" アクティビティで出力されます。ローカルとリモートの IP アドレスを提供します。情報レベルで出力されます。|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationmexmonikermetadataexchangecomplete.md b/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationmexmonikermetadataexchangecomplete.md
new file mode 100644
index 00000000000..36fe9c6b01c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationmexmonikermetadataexchangecomplete.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationMexMonikerMetadataExchangeComplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0fd35dff-e1ff-4902-a89b-093f0e34466f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationMexMonikerMetadataExchangeComplete
+System.ServiceModel.ComIntegration.ComIntegrationMexMonikerMetadataExchangeComplete  
+  
+## 説明  
+ サービス モニカーは、メタデータの取得を完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationservicehostcreatedserviceendpoint.md b/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationservicehostcreatedserviceendpoint.md
new file mode 100644
index 00000000000..4f6a1310844
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/ssc--comintegrationservicehostcreatedserviceendpoint.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceEndpoint | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79aa2eee-b65d-4ae3-971a-acb5db4547b9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceEndpoint
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceEndpoint  
+  
+## 説明  
+ ComPlus : 作成されたサービス エンドポイント。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/ssc-comintegration.md b/docs/framework/wcf/diagnostics/tracing/ssc-comintegration.md
new file mode 100644
index 00000000000..eb40ca39100
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/ssc-comintegration.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedServiceDetails | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d88b4823-08a4-4126-8304-d2c4c9d35b3e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedServiceDetails
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedServiceDetails  
+  
+## 説明  
+ ComPlus : サービスが開始しました : 詳細  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationinvokingmethodcontexttransaction.md b/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationinvokingmethodcontexttransaction.md
new file mode 100644
index 00000000000..826c3157b37
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationinvokingmethodcontexttransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodContextTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d2690ae-0afb-4cb1-ab62-a1a0ceba8521
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodContextTransaction
+System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodContextTransaction  
+  
+## 説明  
+ Complus : COM\+ コンテキストのトランザクションでメソッドを呼び出します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationservicehostcreatedservicecontract.md b/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationservicehostcreatedservicecontract.md
new file mode 100644
index 00000000000..0c23fd67983
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/ssc-comintegrationservicehostcreatedservicecontract.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceContract | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b670c80-a119-4114-8b1d-2b2034e5cb19
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceContract
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceContract  
+  
+## 説明  
+ ComPlus : 作成されたサービス コントラクト。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/synchronous-scenarios-using-http-tcp-or-named-pipe.md b/docs/framework/wcf/diagnostics/tracing/synchronous-scenarios-using-http-tcp-or-named-pipe.md
new file mode 100644
index 00000000000..d90db1f7d54
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/synchronous-scenarios-using-http-tcp-or-named-pipe.md
@@ -0,0 +1,71 @@
+---
+title: "HTTP、TCP、または名前付きパイプを使用した同期シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e90af1b-f8f6-41b9-a63a-8490ada502b1
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# HTTP、TCP、または名前付きパイプを使用した同期シナリオ
+ここでは、シングル スレッド クライアントで HTTP、TCP、または名前付きパイプを使用したときの、さまざまな同期要求\/応答シナリオでのアクティビティと転送について説明します。マルチスレッド要求の詳細については、「[HTTP、TCP、または名前付きパイプを使用した非同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/asynchronous-scenarios-using-http-tcp-or-named-pipe.md)」を参照してしてください。  
+  
+## エラーを伴わない同期要求\/応答  
+ ここでは、シングル スレッド クライアントを使用したときの、有効な同期要求\/応答シナリオでのアクティビティおよび転送について説明します。  
+  
+### クライアント  
+  
+#### サービス エンドポイントとの通信の確立  
+ クライアントを構築して開きます。各手順では、アンビエント アクティビティ \(A\) が “クライアントの構築” アクティビティ \(B\) と “クライアントを開く” アクティビティ \(C\) にそれぞれ転送されます。転送されるアクティビティごとに、転送が返されるまで \(つまり、ServiceModel コードが実行されるまで\) アンビエント アクティビティは中断されます。  
+  
+#### サービス エンドポイントへの要求  
+ アンビエント アクティビティが "アクションを処理" アクティビティ \(D\) に転送されます。このアクティビティでは、要求メッセージが送信され、応答メッセージが受信されます。このアクティビティは、ユーザー コードに制御が戻ると終了します。これは同期要求であるため、制御が戻るまでアンビエント アクティビティは中断されます。  
+  
+#### サービス エンドポイントとの通信の終了  
+ クライアントの "閉じる" アクティビティ \(I\) が、アンビエント アクティビティから作成されます。これは、"新規" や "開く" と同じです。  
+  
+### サーバー  
+  
+#### サービス ホストの設定  
+ ServiceHost の "新規" アクティビティ \(N\) および "開く" アクティビティ \(O\) は、アンビエント アクティビティ \(M\) から作成されます。  
+  
+ リスナー アクティビティ \(P\) は、各リスナーの ServiceHost を開くと作成されます。リスナー アクティビティは、待機してデータを受信および処理します。  
+  
+#### ネットワーク上のデータの受信  
+ データがネットワークに到着すると、受信したデータを処理するために "バイトを受信" アクティビティ \(Q\) が作成されます \(まだ存在しない場合\)。このアクティビティは、接続またはキュー内の複数のメッセージに再使用できます。  
+  
+ SOAP アクション メッセージを作成するための十分なデータがある場合、"バイトを受信" アクティビティは "メッセージを処理" アクティビティ \(R\) を起動します。  
+  
+ アクティビティ R では、メッセージ ヘッダーが処理され、アクティビティ ID ヘッダーが確認されます。このヘッダーが存在する場合、アクティビティ ID は "アクションを処理" アクティビティに設定されます。それ以外の場合は、新しい ID が作成されます。  
+  
+ 呼び出しが処理されると、"アクションを処理" アクティビティ \(S\) が作成されて転送されます。このアクティビティは、受信メッセージに関連するすべての処理 \("ユーザー コードを実行" \(T\) と "応答メッセージを送信" \(該当する場合\) を含む\) が完了すると終了します。  
+  
+#### サービス ホストの終了  
+ ServiceHost の "閉じる" アクティビティ \(Z\) は、アンビエント アクティビティから作成されます。  
+  
+ ![HTTP、TCP、および名前付きパイプを使用した同期シナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/media/sync.gif "Sync")  
+  
+ \<A: name\> の `A` は、前の説明および表 3 に含まれるアクティビティを表すショートカット シンボルです。`Name` は、アクティビティの短縮名です。  
+  
+ `propagateActivity`\=`true` の場合、クライアントとサービスの "アクションを処理" アクティビティはどちらも同じアクティビティ ID を持ちます。  
+  
+## エラーを伴う同期要求\/応答  
+ 前述のシナリオとの違いは、応答メッセージとして SOAP エラー メッセージが返されることだけです。`propagateActivity`\=`true` の場合は、要求メッセージのアクティビティ ID が SOAP エラー メッセージに追加されます。  
+  
+## エラーを伴わない同期一方向  
+ 最初のシナリオとの違いは、メッセージがサーバーに返されないことだけです。HTTP ベースのプロトコルの場合は、ステータス \(有効またはエラー\) がクライアントに返されます。それは、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] プロトコル スタックのなかで HTTP プロトコルだけが、要求\/応答セマンティクスを使用するからです。TCP 処理は [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] からは見えないため、受信確認はクライアントに送信されません。  
+  
+## エラーを伴う同期一方向  
+ メッセージの処理中 \(Q 以降\) にエラーが発生しても、クライアントには通知が返されません。これは、「エラーを伴わない同期一方向要求\/応答」のシナリオと同じです。エラー メッセージを受信する必要がある場合は、一方向のシナリオを使用しないでください。  
+  
+## 双方向  
+ 上述のシナリオとの違いは、クライアントがサービスとして動作することです。この場合、非同期のシナリオと同様、クライアントは "バイトを受信" アクティビティと "メッセージを処理" アクティビティを作成します。
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationcontextcreated.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationcontextcreated.md
new file mode 100644
index 00000000000..f439445e480
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationcontextcreated.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.AuthorizationContextCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 392b5964-fb51-4e7c-883a-62c929623706
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.AuthorizationContextCreated
+System.IdentityModel.AuthorizationContextCreated  
+  
+## 説明  
+ 指定した ID の承認コンテキストが作成されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationpolicyevaluated.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationpolicyevaluated.md
new file mode 100644
index 00000000000..171881ee291
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationpolicyevaluated.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.AuthorizationPolicyEvaluated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99a3b127-0513-48f0-9af4-83b1b40716b1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.AuthorizationPolicyEvaluated
+System.IdentityModel.AuthorizationPolicyEvaluated  
+  
+## 説明  
+ 指定された ID を持つポリシーが評価されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-identitymodelasynccallbackthrewexception.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-identitymodelasynccallbackthrewexception.md
new file mode 100644
index 00000000000..e10139c9402
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-identitymodelasynccallbackthrewexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.IdentityModelAsyncCallbackThrewException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4fc924f-3b9e-44f5-97e4-b3a4bb855d89
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.IdentityModel.IdentityModelAsyncCallbackThrewException
+System.IdentityModel.IdentityModelAsyncCallbackThrewException  
+  
+## 説明  
+ 非同期コールバックで例外がスローされました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-generalinformation.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-generalinformation.md
new file mode 100644
index 00000000000..390a5955385
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-generalinformation.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.GeneralInformation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 60eff0ce-cf24-49d0-bc62-66bc8f684322
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.GeneralInformation
+System.IdentityModel.Selectors.GeneralInformation  
+  
+## 説明  
+ これは一般情報です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storebegintransaction.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storebegintransaction.md
new file mode 100644
index 00000000000..fe9571a5804
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storebegintransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreBeginTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 221df2e7-0931-4cbc-93b9-dfffd0fdf4c8
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreBeginTransaction
+System.IdentityModel.Selectors.StoreBeginTransaction  
+  
+## 説明  
+ 指定したストア トランザクションを開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeclosing.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeclosing.md
new file mode 100644
index 00000000000..53f901d65c7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeclosing.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreClosing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf3b99a2-df29-4737-bc1f-a1e9f7983bfa
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreClosing
+System.IdentityModel.Selectors.StoreClosing  
+  
+## 説明  
+ 指定したストアを終了しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storecommittransaction.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storecommittransaction.md
new file mode 100644
index 00000000000..bf275d73eb3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storecommittransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreCommitTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e9f2db66-5b7d-49e1-b198-0846551c6e8e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreCommitTransaction
+System.IdentityModel.Selectors.StoreCommitTransaction  
+  
+## 説明  
+ 指定したストアのトランザクションをコミットしています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storedeleting.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storedeleting.md
new file mode 100644
index 00000000000..9b811442cea
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storedeleting.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreDeleting | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c894b84d-aac9-46ca-b578-ff8e43a461de
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreDeleting
+System.IdentityModel.Selectors.StoreDeleting  
+  
+## 説明  
+ 指定したストアを削除しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storefailedtoopenstore.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storefailedtoopenstore.md
new file mode 100644
index 00000000000..ab6662e7338
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storefailedtoopenstore.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreFailedToOpenStore | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f850b3e2-022b-4c75-aca3-1a8b14f9dc30
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreFailedToOpenStore
+System.IdentityModel.Selectors.StoreFailedToOpenStore  
+  
+## 説明  
+ ストアを開くことができません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeloading.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeloading.md
new file mode 100644
index 00000000000..297118f44cc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeloading.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreLoading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a9287a5a-a36b-4659-8c87-13962b1c225c
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreLoading
+System.IdentityModel.Selectors.StoreLoading  
+  
+## 説明  
+ 指定したストアを初期化します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storerollbacktransaction.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storerollbacktransaction.md
new file mode 100644
index 00000000000..741b48b1a79
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storerollbacktransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreRollbackTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09240dce-9e62-4f00-9f37-9dbe90a09af2
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.IdentityModel.Selectors.StoreRollbackTransaction
+System.IdentityModel.Selectors.StoreRollbackTransaction  
+  
+## 説明  
+ トランザクションをロールバックしています。前のエラーを参照してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storesignaturenotvalid.md b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storesignaturenotvalid.md
new file mode 100644
index 00000000000..4903e4c8761
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storesignaturenotvalid.md
@@ -0,0 +1,28 @@
+---
+title: "System.IdentityModel.Selectors.StoreSignatureNotValid | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9087bf09-cb15-41ec-bd7a-6338789953d0
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.IdentityModel.Selectors.StoreSignatureNotValid
+System.IdentityModel.Selectors.StoreSignatureNotValid  
+  
+## 説明  
+ ファイルの署名が無効です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-elementignored.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-elementignored.md
new file mode 100644
index 00000000000..1af18432b3a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-elementignored.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.ElementIgnored | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 795fc64f-07af-4b88-9256-1b154d2b209d
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.ElementIgnored
+System.Runtime.Serialization.ElementIgnored  
+  
+## 説明  
+ シリアル化解除中に、XML 内で認識できない要素が検出されましたが、この要素は無視されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-factorytypenotfound.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-factorytypenotfound.md
new file mode 100644
index 00000000000..ad9e82c6425
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-factorytypenotfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.FactoryTypeNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0ab341a-4000-4076-87cc-ffe332266658
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.Runtime.Serialization.FactoryTypeNotFound
+System.Runtime.Serialization.FactoryTypeNotFound  
+  
+## 説明  
+ デシリアライザーが、逆シリアル化に使う型を判断できません。  XML のファクトリ型として指定された型を、たとえば KnownTypeAttribute 属性を使って既知の型のリストに追加することを検討してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-objectwithlargedepth.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-objectwithlargedepth.md
new file mode 100644
index 00000000000..d74ff2ea35a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-objectwithlargedepth.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.ObjectWithLargeDepth | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5837891d-104b-4e9b-bfba-5434a9524b33
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.Runtime.Serialization.ObjectWithLargeDepth
+System.Runtime.Serialization.ObjectWithLargeDepth  
+  
+## 説明  
+ 再帰構造でオブジェクトを記述する場合、階層が深いと制限が生じます。オブジェクトの深さを減らすことを検討してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-readobjectbegin.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-readobjectbegin.md
new file mode 100644
index 00000000000..52352aa804a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-readobjectbegin.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.ReadObjectBegin | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b08ba6d-f201-4ace-9dce-aaf539e323b3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.ReadObjectBegin
+System.Runtime.Serialization.ReadObjectBegin  
+  
+## 説明  
+ ReadObject の開始。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectbegin.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectbegin.md
new file mode 100644
index 00000000000..3a18deb900e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectbegin.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.WriteObjectBegin | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f4cb7f1-8bf2-4b6d-b693-43a83c74260a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.WriteObjectBegin
+System.Runtime.Serialization.WriteObjectBegin  
+  
+## 説明  
+ WriteObject を開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentbegin.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentbegin.md
new file mode 100644
index 00000000000..7018805e68a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentbegin.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.WriteObjectContentBegin | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b89d8e09-f41b-44f5-8589-3aef97d6c437
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.WriteObjectContentBegin
+System.Runtime.Serialization.WriteObjectContentBegin  
+  
+## 説明  
+ WriteObjectContent を開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentend.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentend.md
new file mode 100644
index 00000000000..505a058a122
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentend.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.WriteObjectContentEnd | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e57195fb-dd09-467c-93f9-4945f3086b0a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.WriteObjectContentEnd
+System.Runtime.Serialization.WriteObjectContentEnd  
+  
+## 説明  
+ WriteObjectContent を終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectend.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectend.md
new file mode 100644
index 00000000000..d660b92b91f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectend.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.WriteObjectEnd | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 586d2b65-d8eb-4186-9400-40ae4e163161
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.WriteObjectEnd
+System.Runtime.Serialization.WriteObjectEnd  
+  
+## 説明  
+ WriteObject を終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportannotationfailed.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportannotationfailed.md
new file mode 100644
index 00000000000..bc03d7b12b0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportannotationfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdExportAnnotationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93407f44-8c09-4c23-97a4-b3e5f409d3d5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdExportAnnotationFailed
+System.Runtime.Serialization.XsdExportAnnotationFailed  
+  
+## 説明  
+ XSD のエクスポート時に注釈をエクスポートできませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportbegin.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportbegin.md
new file mode 100644
index 00000000000..443c90565d7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportbegin.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdExportBegin | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d7457aa5-c147-4643-bdb9-eaafa6674013
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdExportBegin
+System.Runtime.Serialization.XsdExportBegin  
+  
+## 説明  
+ スキーマのエクスポートを開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportdupitems.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportdupitems.md
new file mode 100644
index 00000000000..94a2e18f958
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportdupitems.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdExportDupItems | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 959861be-4f2d-4666-a2b9-200a9125fad7
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.Runtime.Serialization.XsdExportDupItems
+System.Runtime.Serialization.XsdExportDupItems  
+  
+## 説明  
+ XSD のエクスポート時にスキーマを生成中、重複する項目が見つかりました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportend.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportend.md
new file mode 100644
index 00000000000..0b875d0378c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportend.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdExportEnd | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 406169f7-dc69-4e02-8a22-b38049dab995
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdExportEnd
+System.Runtime.Serialization.XsdExportEnd  
+  
+## 説明  
+ スキーマのエクスポートを終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexporterror.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexporterror.md
new file mode 100644
index 00000000000..c23bd0697c8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexporterror.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdExportError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 393fa3d0-a4bb-4c00-947d-84c5e860c681
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdExportError
+System.Runtime.Serialization.XsdExportError  
+  
+## 説明  
+ スキーマのエクスポートでエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportannotationfailed.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportannotationfailed.md
new file mode 100644
index 00000000000..ad237038f96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportannotationfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdImportAnnotationFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f52ff1d8-7b0d-421c-bf08-a9fbd0e76968
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdImportAnnotationFailed
+System.Runtime.Serialization.XsdImportAnnotationFailed  
+  
+## 説明  
+ XSD のインポート中に、注釈のインポートに失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportbegin.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportbegin.md
new file mode 100644
index 00000000000..506ac0c508f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportbegin.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdImportBegin | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4b0c97d-2aab-42c3-a921-724a11e40fce
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdImportBegin
+System.Runtime.Serialization.XsdImportBegin  
+  
+## 説明  
+ スキーマのインポートを開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportend.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportend.md
new file mode 100644
index 00000000000..6d2143dffe9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportend.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdImportEnd | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f53f75ec-886c-4c87-845e-64339c779be6
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdImportEnd
+System.Runtime.Serialization.XsdImportEnd  
+  
+## 説明  
+ スキーマのインポートが終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimporterror.md b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimporterror.md
new file mode 100644
index 00000000000..464a0d8c251
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimporterror.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.XsdImportError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2639d138-74f5-4ef0-90dd-75feeed35363
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.XsdImportError
+System.Runtime.Serialization.XsdImportError  
+  
+## 説明  
+ スキーマのインポートでエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueclosed.md
new file mode 100644
index 00000000000..df8f3c06321
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 92c40c72-4f0d-4d8a-bde0-1731aaaeaf89
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueClosed
+System.ServiceModel.Activation.MessageQueueClosed  
+  
+## 説明  
+ メッセージ キューを閉じました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipe.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipe.md
new file mode 100644
index 00000000000..1a47d56c88f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipe.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueDuplicatedPipe | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97c4e6a3-6673-4eb7-a8b2-fc8c6d782ddf
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueDuplicatedPipe
+System.ServiceModel.Activation.MessageQueueDuplicatedPipe  
+  
+## 説明  
+ 名前付きパイプのハンドルを複製しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipeerror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipeerror.md
new file mode 100644
index 00000000000..dfdcdff8626
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipeerror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueDuplicatedPipeError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ebfe9af1-76f7-4416-abf9-1d777708e0f1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueDuplicatedPipeError
+System.ServiceModel.Activation.MessageQueueDuplicatedPipeError  
+  
+## 説明  
+ 名前付きパイプの複製中にエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocket.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocket.md
new file mode 100644
index 00000000000..8a6a7f544d2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocket.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueDuplicatedSocket | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d54c015-226e-40c6-8c54-1773b342a9b6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueDuplicatedSocket
+System.ServiceModel.Activation.MessageQueueDuplicatedSocket  
+  
+## 説明  
+ ソケットのハンドルを複製しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocketerror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocketerror.md
new file mode 100644
index 00000000000..b107c23debe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocketerror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueDuplicatedSocketError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d039e48-8188-4f43-a9bd-d6c58c075173
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueDuplicatedSocketError
+System.ServiceModel.Activation.MessageQueueDuplicatedSocketError  
+  
+## 説明  
+ ソケットを複製しているときにエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistercalled.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistercalled.md
new file mode 100644
index 00000000000..23522761bbb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistercalled.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueRegisterCalled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89e57e8e-39ae-4850-880c-f15629945584
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueRegisterCalled
+System.ServiceModel.Activation.MessageQueueRegisterCalled  
+  
+## 説明  
+ 名前空間を登録する呼び出しが行われました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregisterfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregisterfailed.md
new file mode 100644
index 00000000000..150ef39ab23
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregisterfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueRegisterFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d985edf0-e648-439f-8f03-910eb386dad7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Activation.MessageQueueRegisterFailed
+System.ServiceModel.Activation.MessageQueueRegisterFailed  
+  
+## 説明  
+ 共有サービスへの登録に失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistersucceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistersucceeded.md
new file mode 100644
index 00000000000..9d21434783a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistersucceeded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueRegisterSucceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a75ea3ab-b0b8-4458-be9a-5e068a74af0f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueRegisterSucceeded
+System.ServiceModel.Activation.MessageQueueRegisterSucceeded  
+  
+## 説明  
+ 名前空間を登録する呼び出しが成功しました。メッセージ キューを開きました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueunregistersucceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueunregistersucceeded.md
new file mode 100644
index 00000000000..b9e04e094cd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueunregistersucceeded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.MessageQueueUnregisterSucceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2e344a4-3b10-430b-bdf3-b065777861bb
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.MessageQueueUnregisterSucceeded
+System.ServiceModel.Activation.MessageQueueUnregisterSucceeded  
+  
+## 説明  
+ メッセージ キューの登録解除が成功しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicecontinue.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicecontinue.md
new file mode 100644
index 00000000000..80f224ef168
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicecontinue.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceContinue | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37a43c8e-493d-4e35-a24f-ab0d4c6d5ce7
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceContinue
+System.ServiceModel.Activation.ServiceContinue  
+  
+## 説明  
+ サービスを継続する要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicepause.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicepause.md
new file mode 100644
index 00000000000..0990b5de6cc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicepause.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServicePause | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3aeef78f-835e-4a72-b759-bf3e25dd8412
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServicePause
+System.ServiceModel.Activation.ServicePause  
+  
+## 説明  
+ サービスを一時停止する要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdown.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdown.md
new file mode 100644
index 00000000000..e14ab77cf25
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdown.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceShutdown | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc356855-f996-4c0d-9ff9-503103803d91
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceShutdown
+System.ServiceModel.Activation.ServiceShutdown  
+  
+## 説明  
+ サービスをシャットダウンする要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdownerror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdownerror.md
new file mode 100644
index 00000000000..eeeb972c6e6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdownerror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceShutdownError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eca40443-7ab2-41f8-8421-0a5a92bc5076
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceShutdownError
+System.ServiceModel.Activation.ServiceShutdownError  
+  
+## 説明  
+ NT サービスのシャットダウン中に予期しないエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestart.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestart.md
new file mode 100644
index 00000000000..c3d984315df
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestart.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 29203bbc-db8d-4bb9-a614-351579902ca6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceStart
+System.ServiceModel.Activation.ServiceStart  
+  
+## 説明  
+ サービスを開始する要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestartpipeerror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestartpipeerror.md
new file mode 100644
index 00000000000..c4d9d89db26
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestartpipeerror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceStartPipeError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d9e883d-181d-407f-ad79-c90035dcfc25
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceStartPipeError
+System.ServiceModel.Activation.ServiceStartPipeError  
+  
+## 説明  
+ NT サービスを開始しているときにハンドル エラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestop.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestop.md
new file mode 100644
index 00000000000..2f270878f58
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestop.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.ServiceStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f22be67e-0def-4f8e-ab31-6178cbdf98d4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.ServiceStop
+System.ServiceModel.Activation.ServiceStop  
+  
+## 説明  
+ サービスを停止する要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostcompilation.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostcompilation.md
new file mode 100644
index 00000000000..e51180fe37a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostcompilation.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.WebHostCompilation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33ee56f8-30bb-445a-964d-050294c85ac6
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Activation.WebHostCompilation
+System.ServiceModel.Activation.WebHostCompilation  
+  
+## 説明  
+ インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) によってホストされるサービスが、.svc ファイル内にあるインライン コードからコンパイルされた場合に発生します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostdebugrequest.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostdebugrequest.md
new file mode 100644
index 00000000000..87d2db6dc6c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostdebugrequest.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.WebHostDebugRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 632d8084-f492-47bd-a40d-f9281c130149
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Activation.WebHostDebugRequest
+System.ServiceModel.Activation.WebHostDebugRequest  
+  
+## 説明  
+ 要求は DEBUG 動詞用です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostprotocolmisconfigured.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostprotocolmisconfigured.md
new file mode 100644
index 00000000000..41066f52f21
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostprotocolmisconfigured.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Activation.WebHostProtocolMisconfigured | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb5bdc6b-4281-452d-bc42-1181f2966e2a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Activation.WebHostProtocolMisconfigured
+プロトコルが Windows プロセス アクティブ化サービス \(WAS\) で正しく構成されていません。  
+  
+## 説明  
+ このエラーは、トランスポート プロトコルが正しく構成されていない場合に発生します。  
+  
+## トラブルシューティング  
+ web.config ファイルでトランスポート構成パラメーターを確認し、修正します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceactivated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceactivated.md
new file mode 100644
index 00000000000..c907fc041cd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceactivated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Activation.WebHostServiceActivated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc3e76d8-4057-474d-815f-1f73f9574588
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Activation.WebHostServiceActivated
+System.ServiceModel.Activation.WebHostServiceActivated  
+  
+## 説明  
+ インターネット インフォメーション サービス \(IIS\) によりホストされるサービスまたは Windows プロセス アクティブ化サービス \(WAS\) が完全にアクティブになり、メッセージのリッスンを開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceclosefailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceclosefailed.md
new file mode 100644
index 00000000000..fe2464edfaa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceclosefailed.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Activation.WebHostServiceCloseFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3cab9856-a5cf-4f0e-a0cb-89425e368f8e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Activation.WebHostServiceCloseFailed
+サービスが正常に閉じられず、中止された場合に発生します。  
+  
+## 説明  
+ このエラー コードはログ ファイルにのみ記録されます。通常は、Abort を既に呼び出した後でサービスを閉じようとした場合などの、プログラミング エラーを示します。  
+  
+## トラブルシューティング  
+ アプリケーションのソース コードをチェックしてください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-administration-wmiput.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-administration-wmiput.md
new file mode 100644
index 00000000000..54661a06e6c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-administration-wmiput.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Administration.WmiPut | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 32c063c0-1bf2-4a40-9ea2-d9610d391bf9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Administration.WmiPut
+System.ServiceModel.Administration.WmiPut  
+  
+## 説明  
+ WMI を使用して値を設定します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-asynccallbackthrewexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-asynccallbackthrewexception.md
new file mode 100644
index 00000000000..b5283e5a1e0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-asynccallbackthrewexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.AsyncCallbackThrewException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfc27ca7-b904-4f29-a5b6-dc702fa54a20
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.AsyncCallbackThrewException
+System.ServiceModel.AsyncCallbackThrewException  
+  
+## 説明  
+ 非同期コールバックで例外がスローされました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-beginexecutemethod.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-beginexecutemethod.md
new file mode 100644
index 00000000000..0d1a1fd5e93
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-beginexecutemethod.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.BeginExecuteMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2dd7d9ec-745e-4463-8494-7f534a598b74
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.BeginExecuteMethod
+System.ServiceModel.BeginExecuteMethod  
+  
+## 説明  
+ 開始メソッドの実行。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-cannotbeimportedincurrentformat.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-cannotbeimportedincurrentformat.md
new file mode 100644
index 00000000000..2148e7b246b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-cannotbeimportedincurrentformat.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CannotBeImportedInCurrentFormat | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78b0a86a-42ff-4f01-81fe-1132f7bf90ad
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.CannotBeImportedInCurrentFormat
+System.ServiceModel.CannotBeImportedInCurrentFormat  
+  
+## 説明  
+ 指定されたスキーマはこの形式ではインポートできません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channelcreated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channelcreated.md
new file mode 100644
index 00000000000..feb9326a637
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channelcreated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ChannelCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6406f162-a53d-487e-b281-3f232fce15f1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.ChannelCreated
+System.ServiceModel.Channels.ChannelCreated  
+  
+## 説明  
+ チャネルが作成されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channeldisposed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channeldisposed.md
new file mode 100644
index 00000000000..25787e3782a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channeldisposed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ChannelDisposed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 172198d5-d6c3-48d6-b8ed-8cc9b7ba0204
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.ChannelDisposed
+System.ServiceModel.Channels.ChannelDisposed  
+  
+## 説明  
+ チャネルが破棄されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionabandoned.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionabandoned.md
new file mode 100644
index 00000000000..86c29566c96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionabandoned.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectionAbandoned | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35ef2322-4a83-473b-8bc0-0df78b9f8cc1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ConnectionAbandoned
+System.ServiceModel.Channels.ConnectionAbandoned  
+  
+## 説明  
+ 接続は放棄されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolcloseexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolcloseexception.md
new file mode 100644
index 00000000000..09e07a4f484
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolcloseexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectionPoolCloseException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8358898e-129e-4fac-a6bf-bf3aa4293ae2
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.ConnectionPoolCloseException
+この接続プールの接続を閉じている間に例外が発生しました。  
+  
+## 説明  
+ このエラー レベルのトレースは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] が使用している接続プールのエラーにより、接続プールを閉じている間にエラーが発生したことを示しています。このエラーの原因としては、プールされた接続を閉じることに失敗した、またはプールされた接続で CloseTimeout が設定されていることが考えられます。この例外がスローされると、このプール内でまだ閉じられていない接続はすべて中断され、他のプールにある閉じられていない接続は破棄されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolidletimeoutreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolidletimeoutreached.md
new file mode 100644
index 00000000000..48c2b49f8c7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolidletimeoutreached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectionPoolIdleTimeoutReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d86e212-c904-4bac-a686-256c66b278b7
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ConnectionPoolIdleTimeoutReached
+System.ServiceModel.Channels.ConnectionPoolIdleTimeoutReached  
+  
+## 説明  
+ 接続がこの接続プールのアイドル タイムアウトを超えたため、閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolleasetimeoutreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolleasetimeoutreached.md
new file mode 100644
index 00000000000..b74cba50960
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolleasetimeoutreached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectionPoolLeaseTimeoutReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bba612da-25ab-4051-916a-c0fba1ae6189
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ConnectionPoolLeaseTimeoutReached
+System.ServiceModel.Channels.ConnectionPoolLeaseTimeoutReached  
+  
+## 説明  
+ 接続がこの接続プールの接続リース タイムアウトを超えたため、閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolmaxoutboundconnectionsperendpointquotareached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolmaxoutboundconnectionsperendpointquotareached.md
new file mode 100644
index 00000000000..71ba0e6e4d9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolmaxoutboundconnectionsperendpointquotareached.md
@@ -0,0 +1,31 @@
+---
+title: "Microsoft.Transactions.TransactionBridge.EnlistTransactionFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b9f5139-e122-4716-9ef7-2f38e1813993
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Microsoft.Transactions.TransactionBridge.EnlistTransactionFailure
+WS\-AT プロトコル サービスは、指定されたコーディネーション コンテキストを使用してトランザクションに参加することができませんでした。  
+  
+## 説明  
+ 指定された 2PC プロトコルのトランザクションに MSDTC が参加できない場合にトレースされます。これは、トランザクションが存在しなくなった場合、参加が許可されなくなった場合、または既に参加が多すぎる場合に発生する可能性があります。  
+  
+## トラブルシューティング  
+ トレース メッセージ内のステータス文字列を調べて、アクション可能な項目が存在するかどうかを確認します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connecttoipendpoint.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connecttoipendpoint.md
new file mode 100644
index 00000000000..449960ac58d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connecttoipendpoint.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ConnectToIPEndpoint | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e55f12ac-882e-4b46-9401-91e1263f68e4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ConnectToIPEndpoint
+System.ServiceModel.Channels.ConnectToIPEndpoint  
+  
+## 説明  
+ 接続情報  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlistenerclose.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlistenerclose.md
new file mode 100644
index 00000000000..d4650e98fb0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlistenerclose.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.EndpointListenerClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe554dc7-8260-404a-935a-ab2131979b46
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.EndpointListenerClose
+System.ServiceModel.Channels.EndpointListenerClose  
+  
+## 説明  
+ エンドポイントのリスナーが閉じました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlisteneropen.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlisteneropen.md
new file mode 100644
index 00000000000..c8f3c4db44c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlisteneropen.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.EndpointListenerOpen | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c911fa53-e0ad-4313-aab5-e596f3567a50
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.EndpointListenerOpen
+System.ServiceModel.Channels.EndpointListenerOpen  
+  
+## 説明  
+ エンドポイントのリスナーが開きました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedacceptfrompool.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedacceptfrompool.md
new file mode 100644
index 00000000000..849cc26793e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedacceptfrompool.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.FailedAcceptFromPool | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d535b1b5-ee58-45e8-b400-7d9570f4eb9a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.FailedAcceptFromPool
+プールされた接続を再使用できませんでした。  指定されたタイムアウト期間内に再試行します。  
+  
+## 説明  
+ この情報トレースは、プールされた接続の再使用を試みている間にエラーが発生したことを示しています。  これは、プールされた接続に互換性がない、接続の準備ができていない、または接続がアクティブなままであるために発生します。  所定のタイムアウト期間内に、他のプールされた接続を再使用する試みがさらに行われ、使用可能な接続が見つからない場合には、新しい接続が作成されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedpipeconnect.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedpipeconnect.md
new file mode 100644
index 00000000000..01a73ede795
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedpipeconnect.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.FailedPipeConnect | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a827e0f-fb91-46bb-bd54-926d4b74d8a6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.FailedPipeConnect
+名前付きパイプ エンドポイントに接続しようとして失敗しました。指定されたタイムアウト期間内に再試行します。  
+  
+## 説明  
+ この情報トレースは、名前付きパイプ エンドポイントへの接続に失敗したことを示します。これは、名前付きパイプ エンドポイントが見つからなかったか、ビジーであった場合に発生します。接続に成功するか、OpenTimeout の有効期間が切れるまで、短い間隔を置いて再試行が繰り返されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpauthfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpauthfailed.md
new file mode 100644
index 00000000000..c9ee3bfb012
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpauthfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpAuthFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a3254ef2-cd3d-4a8a-ae3d-a51fc389af53
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.HttpAuthFailed
+System.ServiceModel.Channels.HttpAuthFailed  
+  
+## 説明  
+ HTTP\(S\) 接続の認証に失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelconcurrentreceivequotareached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelconcurrentreceivequotareached.md
new file mode 100644
index 00000000000..073c616db7d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelconcurrentreceivequotareached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpChannelConcurrentReceiveQuotaReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: db6d8cdb-0d25-4bfb-8963-eff465733d70
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.HttpChannelConcurrentReceiveQuotaReached
+System.ServiceModel.Channels.HttpChannelConcurrentReceiveQuotaReached  
+  
+## 説明  
+ HTTP の同時受信クォータに達しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelmessagereceivefailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelmessagereceivefailed.md
new file mode 100644
index 00000000000..d7d8a30d2d0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelmessagereceivefailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpChannelMessageReceiveFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9eb311da-fdcc-4dd3-9d85-05b3280dfdda
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.HttpChannelMessageReceiveFailed
+HTTP チャネルを介したメッセージの受信に失敗しました。  
+  
+## 説明  
+ このトレースは、警告またはエラーとして出力されます。どちらの場合であっても、このトレースは、受信 HTTP 要求に対して互換性のあるリスナーが見つからない場合に出力され、HTTP 要求は破棄されます。これは、要求の HTTP 動詞が HTTP リスナーによって認識されない、または要求が対象としているアドレスでリッスンしているリスナーがないために発生します。このトレースは、自己ホスト型の場合は警告を出力し、サービスが IIS でホストされている場合はエラーを出力します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelrequestaborted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelrequestaborted.md
new file mode 100644
index 00000000000..009cc5a4a55
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelrequestaborted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpChannelRequestAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d47a2e78-f0ce-4125-893a-5f438016216c
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.HttpChannelRequestAborted
+HTTP での要求メッセージの送信に失敗しました。  
+  
+## 説明  
+ この警告レベルのトレースは、HTTP チャネルの要求が中止されたことを示しています。  このトレースの追加情報により、理由または Abort メソッドに渡されたメッセージがわかります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelresponseaborted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelresponseaborted.md
new file mode 100644
index 00000000000..c7cc10d2389
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelresponseaborted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpChannelResponseAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2fd1836e-4b62-400d-aa76-b3ab9f479015
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.HttpChannelResponseAborted
+HTTP 経由で応答メッセージを送信できませんでした。  
+  
+## 説明  
+ この警告レベルのトレースは、HTTP チャネルの応答が中止されたことを示しています。このトレースの追加情報により、理由、または Abort メソッドに渡されたメッセージがわかります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelunexpectedresponse.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelunexpectedresponse.md
new file mode 100644
index 00000000000..ebd6aca7c46
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelunexpectedresponse.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpChannelUnexpectedResponse | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eafa9450-4077-4c3a-94c4-52862d66eb6f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.HttpChannelUnexpectedResponse
+System.ServiceModel.Channels.HttpChannelUnexpectedResponse  
+  
+## 説明  
+ 正しくない HTTP 応答を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpresponsereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpresponsereceived.md
new file mode 100644
index 00000000000..8bedea17424
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpresponsereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpResponseReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23101c3b-c1c2-4544-bb2f-aceec3e4e724
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.HttpResponseReceived
+System.ServiceModel.Channels.HttpResponseReceived  
+  
+## 説明  
+ HTTP 応答が受信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificateinvalid.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificateinvalid.md
new file mode 100644
index 00000000000..3319e6dcd66
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificateinvalid.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpsClientCertificateInvalid | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8884dda1-fa0e-4d2a-8079-7042c51b64ef
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.HttpsClientCertificateInvalid
+クライアント証明書が無効です。  
+  
+## 説明  
+ このトレースは、HTTPS リスナーが、クライアントによって提供された証明書が無効であることを検出したことを示します。HTTPS リスナーは、この証明書を使用してクライアントの信頼性を検証しようとしていました。サービスをホストしているサーバーによって証明書の証明機関が認識されないと、証明書は無効になります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificatenotpresent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificatenotpresent.md
new file mode 100644
index 00000000000..b26f4aeb878
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificatenotpresent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.HttpsClientCertificateNotPresent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b13ef1b6-e340-401d-93ca-2710c3842205
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.HttpsClientCertificateNotPresent
+クライアント証明書が必要です。要求内で証明書が見つかりませんでした。  
+  
+## 説明  
+ このトレースは、HTTPS リスナーがクライアント証明書に関連付けられていない HTTPS 要求を受信したことを示します。リスナーはすべての HTTPS 要求においてクライアント証明書を必要とするように構成されているため、リスナーによるクライアントの信頼性の検証は失敗します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-incompatibleexistingtransportmanager.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-incompatibleexistingtransportmanager.md
new file mode 100644
index 00000000000..6db64ef9d17
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-incompatibleexistingtransportmanager.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.IncompatibleExistingTransportManager | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5366ec64-e8ef-4a34-a2f6-7251d89f1be9
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.IncompatibleExistingTransportManager
+指定された URI に既存の互換性のないトランスポート マネージャーが見つかりました。  
+  
+## 説明  
+ この情報トレースは、開いているリスナーと一致する登録があるのに、既存のトランスポート マネージャーに互換性がないことを示しています。リスナーは別のトランスポート マネージャーの使用を試み、これに失敗した場合には例外がスローされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingnamedpipeconnection.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingnamedpipeconnection.md
new file mode 100644
index 00000000000..ad2afe782c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingnamedpipeconnection.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.InitiatingNamedPipeConnection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23bd5f35-4a9c-4ccb-a153-f3f6f6594199
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.InitiatingNamedPipeConnection
+System.ServiceModel.Channels.InitiatingNamedPipeConnection  
+  
+## 説明  
+ 名前付きパイプの接続を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingtcpconnection.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingtcpconnection.md
new file mode 100644
index 00000000000..30456624a45
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingtcpconnection.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.InitiatingTcpConnection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0a2749d-3f97-41b8-ac08-37b5069fe41e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.InitiatingTcpConnection
+System.ServiceModel.Channels.InitiatingTcpConnection  
+  
+## 説明  
+ TCP 接続を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenercreated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenercreated.md
new file mode 100644
index 00000000000..33882fe19d8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenercreated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ListenerCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4a3401c-f7f8-4761-95c2-ca92b70a503d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ListenerCreated
+System.ServiceModel.Channels.ListenerCreated  
+  
+## 説明  
+ リスナーが作成されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenerdisposed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenerdisposed.md
new file mode 100644
index 00000000000..cd346eb1dbe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenerdisposed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ListenerDisposed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75ff3e7e-ad6a-4ac2-a094-4247f523c5f5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ListenerDisposed
+System.ServiceModel.Channels.ListenerDisposed  
+  
+## 説明  
+ リスナーが破棄されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxacceptedchannelsreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxacceptedchannelsreached.md
new file mode 100644
index 00000000000..ee1a3453615
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxacceptedchannelsreached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MaxAcceptedChannelsReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 13d15194-a04f-4a5a-9d85-23ad350fdc7e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MaxAcceptedChannelsReached
+System.ServiceModel.Channels.MaxAcceptedChannelsReached  
+  
+## 説明  
+ 受信セッション チャネルの最大数に達しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxpendingconnectionsreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxpendingconnectionsreached.md
new file mode 100644
index 00000000000..76ab5ed7b87
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxpendingconnectionsreached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MaxPendingConnectionsReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6138b01d-199b-45db-b875-c1cca68e6894
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MaxPendingConnectionsReached
+System.ServiceModel.Channels.MaxPendingConnectionsReached  
+  
+## 説明  
+ 保留状態の接続の最大数に達しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagereceived.md
new file mode 100644
index 00000000000..82b9ca62ca4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagereceived.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.Channels.MessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e6942a4-051f-416c-9674-7e729b9edd33
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.MessageReceived
+System.ServiceModel.Channels.MessageReceived  
+  
+## 説明  
+ チャネルを介してメッセージを受信しました。  
+  
+ このトレースは、`System.ServiceModel` トレース ソースが情報レベルまたは詳細レベルで有効な場合に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージが受信されるときに出力されます。このトレースはアクティビティのグラフ ビューでメッセージの相関矢印を表示するために必要です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagesent.md
new file mode 100644
index 00000000000..29e2b38cc1a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagesent.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.Channels.MessageSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 454cd09c-992f-4faf-9751-2de56e6401da
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.MessageSent
+System.ServiceModel.Channels.MessageSent  
+  
+## 説明  
+ チャネルを介してメッセージを送信しました。  
+  
+ このトレースは `System.ServiceModel` トレース ソースが Information レベルか Verbose レベルで有効な場合に、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージが送信されるときに出力されます。このトレースはアクティビティのグラフ ビューでメッセージの相関矢印を表示するために必要です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotpeekonqueue.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotpeekonqueue.md
new file mode 100644
index 00000000000..b71c8b5ab96
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotpeekonqueue.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqCannotPeekOnQueue | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb95e569-cc5e-4d70-81b5-7374d3a2f8be
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.MsmqCannotPeekOnQueue
+System.ServiceModel.Channels.MsmqCannotPeekOnQueue  
+  
+## 説明  
+ MSMQ アクティべーション サービスはキューをピークできません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotreadqueues.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotreadqueues.md
new file mode 100644
index 00000000000..1e553d49001
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotreadqueues.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqCannotReadQueues | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1cfee05-dce7-440b-b03e-96f81c00a222
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.MsmqCannotReadQueues
+System.ServiceModel.Channels.MsmqCannotReadQueues  
+  
+## 説明  
+ MSMQ アクティベーション サービスはキューを検出できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramreceived.md
new file mode 100644
index 00000000000..c7aad53fab8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqDatagramReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c924ab16-573a-4fd6-8059-071fc12f4b1b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqDatagramReceived
+System.ServiceModel.Channels.MsmqDatagramReceived  
+  
+## 説明  
+ MSMQ データグラム メッセージが受信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramsent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramsent.md
new file mode 100644
index 00000000000..fc9e6e9b4c2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramsent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqDatagramSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eab449e8-e01b-4af8-bd8e-0f3a24689c82
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqDatagramSent
+System.ServiceModel.Channels.MsmqDatagramSent  
+  
+## 説明  
+ MSMQ データグラム メッセージが送信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdetected.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdetected.md
new file mode 100644
index 00000000000..3b1226e4c3b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdetected.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqDetected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff20cef5-89d2-408e-a431-8c31a9d878d5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqDetected
+System.ServiceModel.Channels.MsmqDetected  
+  
+## 説明  
+ MSMQ が正常に検出されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqenteredbatch.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqenteredbatch.md
new file mode 100644
index 00000000000..4329687a256
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqenteredbatch.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqEnteredBatch | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b787c18-1962-4083-93d1-adb680295189
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqEnteredBatch
+System.ServiceModel.Channels.MsmqEnteredBatch  
+  
+## 説明  
+ MSMQ がバッチ モードを開始しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqfoundbaseaddress.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqfoundbaseaddress.md
new file mode 100644
index 00000000000..e1992554d8f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqfoundbaseaddress.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqFoundBaseAddress | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5431889d-c296-44f3-a54d-a356e9f1eb5e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqFoundBaseAddress
+System.ServiceModel.Channels.MsmqFoundBaseAddress  
+  
+## 説明  
+ ホスト環境によって、サービスのベース アドレスが検出されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqleftbatch.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqleftbatch.md
new file mode 100644
index 00000000000..229330b9c66
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqleftbatch.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqLeftBatch | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28b5a2f0-fbfc-477e-97d9-bea2c1bfbbbe
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqLeftBatch
+System.ServiceModel.Channels.MsmqLeftBatch  
+  
+## 説明  
+ MSMQ はバッチ モードを終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmatchedapplicationfound.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmatchedapplicationfound.md
new file mode 100644
index 00000000000..32b2b003494
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmatchedapplicationfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqMatchedApplicationFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41557327-504e-4394-a3e6-1f076a7c35e6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqMatchedApplicationFound
+System.ServiceModel.Channels.MsmqMatchedApplicationFound  
+  
+## 説明  
+ MSMQ アクティベーション サービスによって、キューに一致するアプリケーションが検出されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagedropped.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagedropped.md
new file mode 100644
index 00000000000..ccb179ea831
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagedropped.md
@@ -0,0 +1,33 @@
+---
+title: "System.ServiceModel.Channels.MsmqMessageDropped | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b6e644d-fa68-4be7-abe9-3659671a37c1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.MsmqMessageDropped
+MSMQ はメッセージを破棄しました。  
+  
+## 説明  
+ このトレースは、MSMQ メッセージが破棄されたことを示します。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] を NetMsmqBinding または MsmqIntegrationBinding と共に使用したときに、MSMQ メッセージを処理できない場合は、これらのメッセージが破棄されることがあります。このようなメッセージは、有害メッセージと呼ばれます。  
+  
+ 有害メッセージは、NetMsmqBinding または MsmqIntegrationBinding の `ReceiveErrorHandling` プロパティが `Drop` に設定されていると破棄されます。破棄されたメッセージはキューから削除され、元に戻すことはできません。  
+  
+ メッセージが有害となる場合の詳細、および有害メッセージをサービスで適切に処理する方法については、「[有害メッセージの処理](http://go.microsoft.com/fwlink/?LinkID=99546)」を参照してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)   
+ [有害メッセージ処理](http://go.microsoft.com/fwlink/?LinkID=99546)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagelockedunderthetransaction.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagelockedunderthetransaction.md
new file mode 100644
index 00000000000..a215eb2d811
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagelockedunderthetransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqMessageLockedUnderTheTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b236bdd-38e8-4c42-9ea5-ac7e5575ebf8
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqMessageLockedUnderTheTransaction
+System.ServiceModel.Channels.MsmqMessageLockedUnderTheTransaction  
+  
+## 説明  
+ トランザクションでロックされているため、メッセージを移動することも削除することもできません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagerejected.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagerejected.md
new file mode 100644
index 00000000000..95c2e8e031a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagerejected.md
@@ -0,0 +1,36 @@
+---
+title: "System.ServiceModel.Channels.MsmqMessageRejected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b7c10a7-2af6-44a2-8b1a-90bba0c7cf26
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.MsmqMessageRejected
+MSMQ はメッセージを拒否しました。  
+  
+## 説明  
+ このトレースは、MSMQ メッセージが拒否されたことを示します。  
+  
+ MSMQ メッセージは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] が \(NetMsmqBinding または MsmqIntegrationBinding のいずれかを使用して\) メッセージを処理できない場合に拒否されることがあります。このようなメッセージは、有害メッセージと呼ばれます。有害メッセージは、NetMsmqBinding または MsmqIntegrationBinding の `ReceiveErrorHandling` プロパティが `Reject` に設定されると拒否されます。拒否されたメッセージは、送信側の「[配信不能キューを使用したメッセージ転送エラー処理](http://go.microsoft.com/fwlink/?LinkID=99544)」に戻されます。  
+  
+ メッセージが有害となる場合の詳細、および有害メッセージをサービスで適切に処理する方法については、「[有害メッセージの処理](http://go.microsoft.com/fwlink/?LinkID=99546)」を参照してください。  
+  
+ MSMQ でメッセージが拒否されることの意味の詳細については、「[MQMarkMessageRejected](http://go.microsoft.com/fwlink/?LinkID=99548)」を参照してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)   
+ [有害メッセージ処理](http://go.microsoft.com/fwlink/?LinkID=99546)   
+ [MQMarkMessageRejected](http://go.microsoft.com/fwlink/?LinkID=99548)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedpoison.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedpoison.md
new file mode 100644
index 00000000000..323b892becc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedpoison.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqPoisonMessageMovedPoison | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d5587606-f2f3-46f8-9e76-cb8ad83088bd
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqPoisonMessageMovedPoison
+System.ServiceModel.Channels.MsmqPoisonMessageMovedPoison  
+  
+## 説明  
+ 有害メッセージが有害サブキューに移動しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedretry.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedretry.md
new file mode 100644
index 00000000000..1f76992807a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedretry.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqPoisonMessageMovedRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c6c0a55-f92d-442c-a61e-7841341a79df
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqPoisonMessageMovedRetry
+System.ServiceModel.Channels.MsmqPoisonMessageMovedRetry  
+  
+## 説明  
+ 有害なメッセージは、再試行用のサブキューに移動されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagerejected.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagerejected.md
new file mode 100644
index 00000000000..d57653ffad8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagerejected.md
@@ -0,0 +1,32 @@
+---
+title: "System.ServiceModel.Channels.MsmqPoisonMessageRejected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e64b9bd-1f12-43df-a189-d7be3c2bace1
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.MsmqPoisonMessageRejected
+有害メッセージは拒否されました。  
+  
+## 説明  
+ このトレースは、有害メッセージが検出され、続いて拒否されたことを示します。これは、NetMsmqBinding または MsmqIntegrationBinding の `ReceiveErrorHandling` プロパティが `Reject` に設定されると発生します。拒否されたメッセージは、送信側の [配信不能キューを使用したメッセージ転送エラー処理](http://go.microsoft.com/fwlink/?LinkId=99544) に戻されます。  
+  
+ メッセージが有害となる場合の詳細、および有害メッセージをサービスで適切に処理する方法については、「[有害メッセージの処理](http://go.microsoft.com/fwlink/?LinkId=99546)」を参照してください。MSMQ でメッセージが拒否されることの意味の詳細については、「[MQMarkMessageRejected](http://go.microsoft.com/fwlink/?LinkId=99548)」を参照してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)   
+ [有害メッセージ処理](http://go.microsoft.com/fwlink/?LinkId=99546)   
+ [MQMarkMessageRejected](http://go.microsoft.com/fwlink/?LinkId=99548)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoolfull.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoolfull.md
new file mode 100644
index 00000000000..3b3f9e0b318
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoolfull.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqPoolFull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1fb0cfe-cddd-4bed-aea5-c9fa60ccce76
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqPoolFull
+System.ServiceModel.Channels.MsmqPoolFull  
+  
+## 説明  
+ ネイティブ MSMQ メッセージのプールがいっぱいです。  これはパフォーマンスに影響する可能性があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpotentiallypoisonmessagedetected.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpotentiallypoisonmessagedetected.md
new file mode 100644
index 00000000000..78f823d4e91
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpotentiallypoisonmessagedetected.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqPotentiallyPoisonMessageDetected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a530df15-ebcd-45d6-bcdf-fc4483bcebec
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.MsmqPotentiallyPoisonMessageDetected
+System.ServiceModel.Channels.MsmqPotentiallyPoisonMessageDetected  
+  
+## 説明  
+ 有害である可能性のあるメッセージが検出されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueclosed.md
new file mode 100644
index 00000000000..549ff2daf4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqQueueClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52fc5e66-a86a-4bc3-8d88-40ec9f408082
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqQueueClosed
+System.ServiceModel.Channels.MsmqQueueClosed  
+  
+## 説明  
+ MSMQ キューが閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueopened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueopened.md
new file mode 100644
index 00000000000..d8cbd865ee7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueopened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqQueueOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 282e108a-73b0-499d-8b9e-e37d1198dda6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqQueueOpened
+System.ServiceModel.Channels.MsmqQueueOpened  
+  
+## 説明  
+ MSMQ キューが開かれました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueuetransactionalstatusunknown.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueuetransactionalstatusunknown.md
new file mode 100644
index 00000000000..2ca5bc4b99f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueuetransactionalstatusunknown.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqQueueTransactionalStatusUnknown | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 193a1a73-42b8-4a98-9a72-ec06ad6b3073
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqQueueTransactionalStatusUnknown
+System.ServiceModel.Channels.MsmqQueueTransactionalStatusUnknown  
+  
+## 説明  
+ キューがトランザクション キューであるかどうかを検出できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqscanstarted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqscanstarted.md
new file mode 100644
index 00000000000..765c45f69ce
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqscanstarted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqScanStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56046431-94fc-4b04-a0fb-4b3f3e31a26f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqScanStarted
+System.ServiceModel.Channels.MsmqScanStarted  
+  
+## 説明  
+ MSMQ アクティベーション サービスによって、キューのスキャンが開始されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramreceived.md
new file mode 100644
index 00000000000..61978ba573a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqSessiongramReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66cfc20b-3bf0-48f6-a715-d82d88f5e71e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqSessiongramReceived
+System.ServiceModel.Channels.MsmqSessiongramReceived  
+  
+## 説明  
+ MSMQ トランスポート セッションが受信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramsent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramsent.md
new file mode 100644
index 00000000000..5e1c95122bb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramsent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqSessiongramSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6638cd0-2e72-4634-863d-2621e46ede50
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqSessiongramSent
+System.ServiceModel.Channels.MsmqSessiongramSent  
+  
+## 説明  
+ MSMQ トランスポート セッションが送信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingapplication.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingapplication.md
new file mode 100644
index 00000000000..8da7a0493dc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingapplication.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqStartingApplication | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76e1af87-f5f2-4974-acfa-868b56cfa450
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqStartingApplication
+System.ServiceModel.Channels.MsmqStartingApplication  
+  
+## 説明  
+ MSMQ アクティベーション サービスによってアプリケーションが起動されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingservice.md
new file mode 100644
index 00000000000..21040d8d38d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqStartingService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7248afaf-5ad9-4d7a-ba07-781a60a0ef9b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqStartingService
+System.ServiceModel.Channels.MsmqStartingService  
+  
+## 説明  
+ ホスト環境はサービスを開始しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqunexpectedacknowledgment.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqunexpectedacknowledgment.md
new file mode 100644
index 00000000000..f5ace5b97bc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqunexpectedacknowledgment.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.MsmqUnexpectedAcknowledgment | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bfe18481-c3ae-4305-a666-2ee63eac3dff
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.MsmqUnexpectedAcknowledgment
+System.ServiceModel.Channels.MsmqUnexpectedAcknowledgment  
+  
+## 説明  
+ 予期しない受信確認値。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceived.md
new file mode 100644
index 00000000000..b5e653952f6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.NamedPipeChannelMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 060b0623-3c0f-4e08-a0d1-2369c35d2c5c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.NamedPipeChannelMessageReceived
+System.ServiceModel.Channels.NamedPipeChannelMessageReceived  
+  
+## 説明  
+ 名前付きパイプ チャネルを介して、メッセージを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceivefailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceivefailed.md
new file mode 100644
index 00000000000..439ed0b23e1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceivefailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.NamedPipeChannelMessageReceiveFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 20e65df6-4539-428d-bf61-92e05c405bef
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.NamedPipeChannelMessageReceiveFailed
+System.ServiceModel.Channels.NamedPipeChannelMessageReceiveFailed  
+  
+## 説明  
+ 受信メッセージを受け取るためのチャネルが見つかりませんでした。エンドポイントまたは SOAP アクションが見つかりませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-noexistingtransportmanager.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-noexistingtransportmanager.md
new file mode 100644
index 00000000000..af11aae4020
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-noexistingtransportmanager.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.NoExistingTransportManager | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb4173c5-476b-40d9-aa5c-19d95e98a51d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.NoExistingTransportManager
+System.ServiceModel.Channels.NoExistingTransportManager  
+  
+## 説明  
+ 指定された URI の既存のトランスポート マネージャーは見つかりませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-openedlistener.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-openedlistener.md
new file mode 100644
index 00000000000..d75ea3b2fb5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-openedlistener.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.OpenedListener | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 474830b3-b76c-4f3c-a363-20d9124fece5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.OpenedListener
+System.ServiceModel.Channels.OpenedListener  
+  
+## 説明  
+ トランスポートは、ベース URI でリッスンしています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagereceived.md
new file mode 100644
index 00000000000..6d89142543a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerChannelMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b68cfbbf-27fa-49d4-a2a1-c9f6af4876f2
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerChannelMessageReceived
+新しい PeerChannel メッセージが受信されました。  
+  
+## 説明  
+ このトレースは、新しいメッセージの受信後に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagesent.md
new file mode 100644
index 00000000000..91ef657824a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagesent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerChannelMessageSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7aa50d9d-37ee-454c-8746-e3c3857edd07
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerChannelMessageSent
+新しい PeerChannel メッセージを送信中です。  
+  
+## 説明  
+ このトレースは、PeerChannel メッセージの送信中に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotmatched.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotmatched.md
new file mode 100644
index 00000000000..1cfb404480d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotmatched.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerFloodedMessageNotMatched | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 43f4eab6-0176-4ac3-9a47-f35419dea539
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PeerFloodedMessageNotMatched
+PeerNode は、どのローカル チャネルとも一致しないメッセージを受信しました。  
+  
+## 説明  
+ このトレースは、大量の受信メッセージの処理中に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotpropagated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotpropagated.md
new file mode 100644
index 00000000000..64782057d57
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotpropagated.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Channels.PeerFloodedMessageNotPropagated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a99275b9-4975-4899-8e21-594ba552f981
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerFloodedMessageNotPropagated
+メッセージは PeerNode によって受信されましたが、近隣ノードには伝達されませんでした。  
+  
+## 説明  
+ このトレースは、受信した大量のメッセージの処理中に行われます。  
+  
+## トラブルシューティング  
+ メッセージ伝達フィルターが存在するかどうかを確認します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagereceived.md
new file mode 100644
index 00000000000..96350ae3f77
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerFloodedMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 778e4e15-2855-4a94-a703-8fa31acc935a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerFloodedMessageReceived
+PeerNode は大量に送られたメッセージを受信しました。  
+  
+## 説明  
+ このトレースは、大量の受信メッセージの処理中に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerflooderreceivemessagequotaexceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerflooderreceivemessagequotaexceeded.md
new file mode 100644
index 00000000000..2d0e15a3ebf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerflooderreceivemessagequotaexceeded.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Channels.PeerFlooderReceiveMessageQuotaExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8371d0a-843e-440b-b86a-6996db131cb0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerFlooderReceiveMessageQuotaExceeded
+メッセージの受信速度が速すぎます。  
+  
+## 説明  
+ このトレースは、受信メッセージの処理を試みたときに行われます。  特定の近隣ノードでクォータ セットが超過しているため、メッセージをその近隣ノードに転送できません。  応答しない近隣ノードが、メッセージ保留のバックログをクリアできなかった場合にこの状態が発生します。  
+  
+## トラブルシューティング  
+ メッシュ内でメッセージが送信される速度を遅くしてください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peermaintaineractivity.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peermaintaineractivity.md
new file mode 100644
index 00000000000..6ecd1479a92
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peermaintaineractivity.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.Channels.PeerMaintainerActivity | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef28d086-d7fb-4e81-82e9-45a54647783b
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# System.ServiceModel.Channels.PeerMaintainerActivity
+PeerMaintainer モジュールは、特定の操作を実行しています \(詳細はトレース メッセージの本文に含まれています\)。  
+  
+## 説明  
+ このトレースは、各種の PeerMaintainer 操作中に行われます。  
+  
+ PeerMaintainer は PeerNode の内部コンポーネントです。  このコンポーネントは、毎分または 32 通のメッセージを受信するたびに近隣ノードに LinkUtility メッセージを送信します。このとき、交換されたメッセージ数と、有効な \(重複および改ざんされていない\) メッセージの数に関する統計が一緒に送信されます。  これは、特定の近隣ノードのリンク ユーティリティの特定に役立ちます。  約 5 分ごとに、保守管理者は近隣ノードの接続が正常かどうかを確認します。  近隣ノードへの接続数が適切な数を超えている場合、保守管理者は使用頻度が最も少ない接続を削除します。  接続数が十分でなければ、保守管理者は新しい接続を取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageroffline.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageroffline.md
new file mode 100644
index 00000000000..b31583e8dac
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageroffline.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborManagerOffline | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15b19e0f-cee5-49ff-8498-f404c39b712f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PeerNeighborManagerOffline
+PeerNode は現在オフラインです。隣接ノードは接続されていません。  
+  
+## 説明  
+ このトレースは、ローカル ノードの近隣ノード一覧から近隣ノードを削除すると実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageronline.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageronline.md
new file mode 100644
index 00000000000..f044966f129
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageronline.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborManagerOnline | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b758d4e8-f54f-43a4-ae4f-4b98996d4c40
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNeighborManagerOnline
+PeerNode が現在オンラインであり、1 つ以上の近隣ノードが接続されていることを示します。  
+  
+## 説明  
+ このトレースは近隣ノードとの正常な接続の最後に実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormessagereceived.md
new file mode 100644
index 00000000000..0c1efdcf87a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c787b86c-08c9-4d44-80ce-a6d189deb732
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PeerNeighborMessageReceived
+ピアの近隣ノードからメッセージを受信しました。  
+  
+## 説明  
+ このトレースは、近隣ノード一覧のノードからの受信メッセージが処理されるときに出力されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotaccepted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotaccepted.md
new file mode 100644
index 00000000000..bee4b11c51c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotaccepted.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborNotAccepted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 77309bf5-37ba-4b90-b31f-c00ef044db0d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# System.ServiceModel.Channels.PeerNeighborNotAccepted
+ピアの近隣ノードは受け入れられませんでした。  
+  
+## 説明  
+ このトレースは近隣ノードへの接続の処理で発生します。エラーの原因としては、セキュリティ設定が一致しない、タイムアウト時間が経過している、近隣ノードが接続を受け入れることができない、一時的なネットワーク問題が発生しているなどが考えられます。  
+  
+## トラブルシューティング  
+ セキュリティ設定が一致しない、タイムアウト時間が経過している、近隣ノードが接続を受け入れることができない、一時ネットワークなどの問題が発生していないか確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotfound.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotfound.md
new file mode 100644
index 00000000000..ac442950ba8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0aeb51a1-b82f-4008-920c-8604c5cbf600
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNeighborNotFound
+近隣ノードに対する操作は、その近隣ノードが近隣ノード一覧になかったので実行できませんでした。  
+  
+## 説明  
+ このエラーは、近隣ノードに接続するか、近隣ノードを閉じるときに発生します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechanged.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechanged.md
new file mode 100644
index 00000000000..a119cfac166
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechanged.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborStateChanged | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94a30661-7177-4a63-ad07-54457137e9f2
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNeighborStateChanged
+ピアの近隣ノードの状態が変わりました。  
+  
+## 説明  
+ このトレースは、近隣ノードの状態を変更しようとすると実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechangefailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechangefailed.md
new file mode 100644
index 00000000000..f2a192c5d3d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechangefailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNeighborStateChangeFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95153aa1-0e04-4857-83d9-9963f5e40b4e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNeighborStateChangeFailed
+近隣ノードの状態が壊れています。  
+  
+## 説明  
+ このトレースは、近隣ノードの状態の変更に失敗すると実行されます。これは予期しない内部エラー、またはメモリの破損が発生したことを示しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeaddresschanged.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeaddresschanged.md
new file mode 100644
index 00000000000..3d6314f7f20
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeaddresschanged.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeAddressChanged | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14bd4be6-1ff1-4df5-b89f-af7950f62ef4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeAddressChanged
+1つまたは複数の PeerNode のアドレスが変更されました。  
+  
+## 説明  
+ このトレースは、アドレス変更の通知コールバックの終了時に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationfailure.md
new file mode 100644
index 00000000000..f5161ef2269
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationfailure.md
@@ -0,0 +1,34 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeAuthenticationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b50f782-ca06-4a82-aa7f-71f78ddc5177
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# System.ServiceModel.Channels.PeerNodeAuthenticationFailure
+潜在的な近隣ノードとのセキュリティ ハンドシェイクに失敗しました。  
+  
+## 説明  
+ このトレースは、セキュリティで保護された近隣ノードとの接続を確立するときに行われます。これは、資格情報が十分でないか間違っている場合に発生します。  
+  
+ PeerChannel では、トークンの種類として、強力な識別手段である X.509 証明書だけを認識します。X.509 証明書は、実装可能な認証および承認の種類に基づいて強力な ID モデルを提供します。PeerChannel では、パスワードを使用した簡単なアプリケーションもサポートしています。パスワードは、セッションへのエントリを許可する目的でのみ使用できます。パスワードを使用して、メッセージの認証を行うことはできません。これは、ピア グループで共有する共通鍵トークンをソース認証に使用することは困難かつ不適切であるためです。  
+  
+## トラブルシューティング  
+ すべての近隣ノードに適切なセキュリティ資格情報があることを確認します。  
+  
+## 参照  
+ [ピア チャネルのセキュリティ](../../../../../docs/framework/wcf/feature-details/peer-channel-security.md)   
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationtimeout.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationtimeout.md
new file mode 100644
index 00000000000..6e62c378ca9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationtimeout.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeAuthenticationTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f294ee94-be83-426c-b40d-6e8a4e5e987c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeAuthenticationTimeout
+セキュリティ ハンドシェイクが、指定した時間内に正常に終了しませんでした。  
+  
+## 説明  
+ このトレースは、セキュリティで保護された近隣との接続を確立するときに行われます。  
+  
+## トラブルシューティング  
+ すべての近隣に適切なセキュリティ資格情報があり、すべてのメッセージに対して 1 分以内に応答していることを確認します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosed.md
new file mode 100644
index 00000000000..7ea189f2ccb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1cf92c3-3d31-4978-b0df-750fcd21909f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeClosed
+PeerNode が終了しました。  
+  
+## 説明  
+ このトレースは、PeerNode の終了処理の終了時に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosing.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosing.md
new file mode 100644
index 00000000000..98de37bfea7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosing.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeClosing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 47a008f0-04d7-4cf3-9099-c056f78c9bfa
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeClosing
+PeerNode の終了処理が開始されました。  
+  
+## 説明  
+ このトレースは、PeerNode の終了処理の開始時に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopened.md
new file mode 100644
index 00000000000..7a3d57c2161
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 516d95c6-ed9d-4673-95ec-3661daba4959
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeOpened
+新しい近隣ノードとの接続が正しく開かれました。  
+  
+## 説明  
+ このトレースは、近隣ノードとの接続に成功すると実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopenfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopenfailed.md
new file mode 100644
index 00000000000..75a8830c021
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopenfailed.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeOpenFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd908a42-30d1-4301-bc33-35b503896634
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeOpenFailed
+近隣ノードへの接続を開けませんでした。  
+  
+## 説明  
+ このトレースは、近隣ノードとの接続の確立を試みた後に行われます。  原因として、応答しないリゾルバー、不正なバインディング設定、一時的なネットワーク エラーなどが考えられます。  
+  
+## トラブルシューティング  
+ 両方のノードが有効なアドレスを持ち、適切に構成されていることを確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopening.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopening.md
new file mode 100644
index 00000000000..6fcd6ee7765
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopening.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerNodeOpening | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 132d4928-ea20-4952-b115-d050499bc728
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerNodeOpening
+PeerNode の初期化が開始されました。  
+  
+## 説明  
+ このトレースは、PeerNode の初期化 \(開始\) コード実行の開始時に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerreceivemessageauthenticationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerreceivemessageauthenticationfailure.md
new file mode 100644
index 00000000000..ba42ea01451
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerreceivemessageauthenticationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerReceiveMessageAuthenticationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 420e50fd-017c-4e06-bc13-320d4e0dc534
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PeerReceiveMessageAuthenticationFailure
+メッセージ ソースを認証できませんでした。  
+  
+## 説明  
+ このトレースは受信メッセージを認証しようとしたときに、そのバインディングでメッセージの認証がオンになっていると発生します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerserviceopened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerserviceopened.md
new file mode 100644
index 00000000000..e143bc2bb87
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerserviceopened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PeerServiceOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b06345f4-cde9-484d-b7fb-d67dc356aed6
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Channels.PeerServiceOpened
+ピア サービス モジュールが開かれ、指定したアドレスでリッスンを開始しました。  
+  
+## 説明  
+ このトレースは、PeerNode のピア サービス モジュールを開くときに行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pipeconnectionabort.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pipeconnectionabort.md
new file mode 100644
index 00000000000..f50aaa60bef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pipeconnectionabort.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PipeConnectionAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2243ef42-7705-4518-91f4-d8e3c40bab34
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.PipeConnectionAbort
+System.ServiceModel.Channels.PipeConnectionAbort  
+  
+## 説明  
+ PipeConnection が中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpregisteredaddresses.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpregisteredaddresses.md
new file mode 100644
index 00000000000..a4cb425c325
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpregisteredaddresses.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PnrpRegisteredAddresses | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b770e042-0555-4668-9b41-e20da092c16a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PnrpRegisteredAddresses
+PNRP リゾルバーがローカル ノードのアドレスを登録しました。  
+  
+## 説明  
+ このトレースは、PNRP サービスがローカル ノードのアドレスを正常に登録すると実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolvedaddresses.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolvedaddresses.md
new file mode 100644
index 00000000000..0d4addb581a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolvedaddresses.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PnrpResolvedAddresses | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57618b91-d2bd-4915-adb9-972868abba3b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PnrpResolvedAddresses
+PNRP リゾルバーは解決操作を完了しました。  
+  
+## 説明  
+ この警告トレースは、PNRP リゾルバーがアドレスを見つけられなかったことを示します。このトレースは、PNRP リゾルバーによる解決操作中に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolveexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolveexception.md
new file mode 100644
index 00000000000..6b5ceb3bc97
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolveexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PnrpResolveException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 398db8db-7394-439a-b599-3ad3f5cfcdb9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PnrpResolveException
+PnrpResolverService が解決中に例外が発生しました。  
+  
+## 説明  
+ このトレースは、PNRP リゾルバーによる解決操作中に行われます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpunregisteredaddresses.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpunregisteredaddresses.md
new file mode 100644
index 00000000000..177ebba56a9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpunregisteredaddresses.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PnrpUnregisteredAddresses | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e726ab32-6923-4fdb-b0ce-bdf2a299ed6a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.PnrpUnregisteredAddresses
+PNRP リゾルバーがローカル ノードのアドレスを登録解除しました。  
+  
+## 説明  
+ このトレースは、PNRP サービスがローカル ノードのアドレスを正常に登録解除すると実行されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-prematuredatagrameof.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-prematuredatagrameof.md
new file mode 100644
index 00000000000..674d56d0430
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-prematuredatagrameof.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.PrematureDatagramEof | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec07be8b-b537-4090-be7e-086679dba78d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.PrematureDatagramEof
+System.ServiceModel.Channels.PrematureDatagramEof  
+  
+## 説明  
+ NULL メッセージ \(チャネルの信号終了\) が、データグラム チャネルから受信されましたが、チャネルはまだ Opened 状態のままです。  これは、データグラム チャネルにエラーがあり、デマルチプレクサー受信ループが途中で止まったことを示しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestchannelreplyreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestchannelreplyreceived.md
new file mode 100644
index 00000000000..d20ca41ed73
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestchannelreplyreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.RequestChannelReplyReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61d428d1-903e-4c34-9c4f-22704043d9d6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.RequestChannelReplyReceived
+System.ServiceModel.Channels.RequestChannelReplyReceived  
+  
+## 説明  
+ 要求チャネルを介して応答を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestcontextabort.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestcontextabort.md
new file mode 100644
index 00000000000..b59bf909396
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestcontextabort.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.RequestContextAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b41c78a2-c885-418d-831f-2db86fa3a52d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.RequestContextAbort
+System.ServiceModel.Channels.RequestContextAbort  
+  
+## 説明  
+ RequestContext が中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-servermaxpooledconnectionsquotareached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-servermaxpooledconnectionsquotareached.md
new file mode 100644
index 00000000000..89657040f12
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-servermaxpooledconnectionsquotareached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.ServerMaxPooledConnectionsQuotaReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0c189f09-887d-459e-b7ab-529110437254
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.ServerMaxPooledConnectionsQuotaReached
+System.ServiceModel.Channels.ServerMaxPooledConnectionsQuotaReached  
+  
+## 説明  
+ MaxOutboundConnectionsPerEndpoint のクォータに達したため、接続は閉じられ、リスナーによって再使用されませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabort.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabort.md
new file mode 100644
index 00000000000..348210ac30b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabort.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SocketConnectionAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e1a7716-b23a-46c5-952a-19c53b447a71
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.SocketConnectionAbort
+System.ServiceModel.Channels.SocketConnectionAbort  
+  
+## 説明  
+ SocketConnection が中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabortclose.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabortclose.md
new file mode 100644
index 00000000000..619c8d39f8b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabortclose.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SocketConnectionAbortClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c33b160-fed5-438b-964d-a0a034dcaee2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.SocketConnectionAbortClose
+System.ServiceModel.Channels.SocketConnectionAbortClose  
+  
+## 説明  
+ SocketConnection が Close 中に中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionclose.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionclose.md
new file mode 100644
index 00000000000..6b14ca74aef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionclose.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SocketConnectionClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5302af2a-8c00-4651-837f-3348df44e98c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.SocketConnectionClose
+System.ServiceModel.Channels.SocketConnectionClose  
+  
+## 説明  
+ SocketConnection のクローズ。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectioncreate.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectioncreate.md
new file mode 100644
index 00000000000..fdff2f42c5b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectioncreate.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SocketConnectionCreate | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 707015f1-a41f-4a42-b74e-a19677e2517b
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.SocketConnectionCreate
+System.ServiceModel.Channels.SocketConnectionCreate  
+  
+## 説明  
+ このトレースは、クライアントによって実行される最初の "プロセス アクション" アクティビティおよびサービスの "バイトを受信" アクティビティで出力されます。ローカルとリモートの IP アドレスを提供します。情報レベルで出力されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-sslclientcertmissing.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-sslclientcertmissing.md
new file mode 100644
index 00000000000..a61e64f5366
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-sslclientcertmissing.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SslClientCertMissing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d09f5336-c1e6-4b92-a04d-af556546bc69
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.SslClientCertMissing
+System.ServiceModel.Channels.SslClientCertMissing  
+  
+## 説明  
+ リモートの SSL クライアントは必要な資格情報を提供できませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-streamsecurityupgradeaccepted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-streamsecurityupgradeaccepted.md
new file mode 100644
index 00000000000..4c74c1a29cb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-streamsecurityupgradeaccepted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.StreamSecurityUpgradeAccepted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: da6c1a6a-1862-4d82-8b44-4b99463a95b8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.StreamSecurityUpgradeAccepted
+System.ServiceModel.Channels.StreamSecurityUpgradeAccepted  
+  
+## 説明  
+ ストリームのセキュリティ更新を正常に受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-systemtimeresolution.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-systemtimeresolution.md
new file mode 100644
index 00000000000..c230437e3eb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-systemtimeresolution.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.SystemTimeResolution | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eaab4ce9-b16a-4fe8-9271-3a1ab1dfa93a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.SystemTimeResolution
+System.ServiceModel.Channels.SystemTimeResolution  
+  
+## 説明  
+ オペレーティング システムのタイマー刻みは *n* チックであることが検出されました。これは約 *m* ミリ秒に相当します。  *n* と *m* には数値が入ります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpchannelmessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpchannelmessagereceived.md
new file mode 100644
index 00000000000..3bcb6f3903a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpchannelmessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.TcpChannelMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eb896d04-e4a5-404f-9df6-5fcaa93e5b60
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Channels.TcpChannelMessageReceived
+System.ServiceModel.Channels.TcpChannelMessageReceived  
+  
+## 説明  
+ TCP チャネルを介してメッセージを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpconnecterror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpconnecterror.md
new file mode 100644
index 00000000000..c757e20b2e6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpconnecterror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Channels.TcpConnectError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22d93797-072e-405d-a3e0-5c519ddf290b
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Channels.TcpConnectError
+TCP 接続の操作に失敗しました。  
+  
+## 説明  
+ この警告レベルのトレースは、TCP エンドポイントへの接続に失敗したことを示しています。これは、リモート エンドポイントが指定された IP アドレスとポートで応答していない場合に発生することがあります。別の有効な IP アドレス \(IPv4 アドレスや IPv6 アドレス、または指定のホスト名を表す別の IP アドレスなど\) への後続する接続試行が成功した場合、このトレースは無視できます。このトレースに含まれる例外により、エラーに関する追加情報が公開されることがあります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationchannelcreated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationchannelcreated.md
new file mode 100644
index 00000000000..867f9634c68
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationchannelcreated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationChannelCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7c0d4c95-6ab4-49c2-ad1d-f52035ea4827
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationChannelCreated
+System.ServiceModel.ComIntegration.ComIntegrationChannelCreated  
+  
+## 説明  
+ ComPlus : チャネルが作成されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdispatchmethod.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdispatchmethod.md
new file mode 100644
index 00000000000..0ff4430a1ba
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdispatchmethod.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDispatchMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7b4930be-57e6-4fe8-b63d-81900bba11c1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDispatchMethod
+System.ServiceModel.ComIntegration.ComIntegrationDispatchMethod  
+  
+## 説明  
+ ComPlus : メソッドの詳細をディスパッチします。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializeraddinghost.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializeraddinghost.md
new file mode 100644
index 00000000000..ccbb202ac1c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializeraddinghost.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerAddingHost | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 404bed8d-44d9-419f-972b-2809fec2a0f1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerAddingHost
+System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerAddingHost  
+  
+## 説明  
+ ComPlus : DllHost 初期化子 : ホストを追加しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarted.md
new file mode 100644
index 00000000000..19b68845c02
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 232522dc-d6a1-4ac8-b632-5bbdf2d4f5a1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarted
+System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarted  
+  
+## 説明  
+ ServiceModelInitializer は、構成されたサービスを起動しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md
new file mode 100644
index 00000000000..7aa24760819
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: affa55c6-03b5-4664-bb9c-2b9d15620df3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting
+System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting  
+  
+## 説明  
+ ServiceModelInitializer を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopped.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopped.md
new file mode 100644
index 00000000000..71b0bee62e7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopped.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopped | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b2912d4-21a4-4a9c-bb68-8626fca5cc39
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopped
+System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopped  
+  
+## 説明  
+ ServiceModelInitializer は、構成されたサービスを停止しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopping.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopping.md
new file mode 100644
index 00000000000..d6d8ec8fc13
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopping.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopping | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: adb9c902-f932-4d88-8eb1-06fd93f7afb2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopping
+System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopping  
+  
+## 説明  
+ ComPlus: DllHost 初期化子を停止しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationenteringactivity.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationenteringactivity.md
new file mode 100644
index 00000000000..f3a4440eca3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationenteringactivity.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationEnteringActivity | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bacbae18-322b-41e9-881a-75017f97ffd7
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationEnteringActivity
+System.ServiceModel.ComIntegration.ComIntegrationEnteringActivity  
+  
+## 説明  
+ ComPlus : COM\+ アクティビティの入力  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationexecutingcall.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationexecutingcall.md
new file mode 100644
index 00000000000..9df8205efcf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationexecutingcall.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationExecutingCall | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 288e0e8a-225b-4676-9512-6ab5e8daa37c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationExecutingCall
+System.ServiceModel.ComIntegration.ComIntegrationExecutingCall  
+  
+## 説明  
+ ComPlus : COM 呼び出しの実行。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationrequest.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationrequest.md
new file mode 100644
index 00000000000..f0bc005b5b1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationrequest.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e9f3f224-cb6b-4c72-a808-d4905ca0c2b8
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationRequest
+System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationRequest  
+  
+## 説明  
+ ComPlus : インスタンス作成要求を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationsuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationsuccess.md
new file mode 100644
index 00000000000..aa04c6001c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationsuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fac5288a-139b-4cb1-8931-d2a153a19971
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationSuccess
+System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationSuccess  
+  
+## 説明  
+ ComPlus : インスタンスを作成しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancereleased.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancereleased.md
new file mode 100644
index 00000000000..605da7e018c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancereleased.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInstanceReleased | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21922b4d-9a83-45cb-a6fc-5b1c2f9a2c17
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInstanceReleased
+System.ServiceModel.ComIntegration.ComIntegrationInstanceReleased  
+  
+## 説明  
+ ComPlus : インスタンスを解放しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokedmethod.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokedmethod.md
new file mode 100644
index 00000000000..d1f3dc50620
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokedmethod.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInvokedMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 87e91962-93a8-4e06-8ee7-8470c26dfa7f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInvokedMethod
+System.ServiceModel.ComIntegration.ComIntegrationInvokedMethod  
+  
+## 説明  
+ ComPlus : 呼び出されたメソッド。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethod.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethod.md
new file mode 100644
index 00000000000..3375e5ced4f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethod.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInvokingMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dea076f0-1c05-40af-a329-c3e3f7a805c1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInvokingMethod
+System.ServiceModel.ComIntegration.ComIntegrationInvokingMethod  
+  
+## 説明  
+ ComPlus : メソッドを呼び出します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethodnewtransaction.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethodnewtransaction.md
new file mode 100644
index 00000000000..63a0b1cc05e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethodnewtransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodNewTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0ece8905-f151-4b92-ba45-0437db314297
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodNewTransaction
+System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodNewTransaction  
+  
+## 説明  
+ Complus : 新しい受信トランザクションでのメソッドの呼び出し。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationleftactivity.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationleftactivity.md
new file mode 100644
index 00000000000..998b5239b4b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationleftactivity.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationLeftActivity | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 266e21b6-2809-4561-b7d9-eec40f1e1e10
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationLeftActivity
+System.ServiceModel.ComIntegration.ComIntegrationLeftActivity  
+  
+## 説明  
+ ComPlus : 残りの COM\+ 動作状況。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexchannelbuilderloaded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexchannelbuilderloaded.md
new file mode 100644
index 00000000000..134dc020f85
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexchannelbuilderloaded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationMexChannelBuilderLoaded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 107160a1-1f19-4c5d-9a74-fe1f398aa8c4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationMexChannelBuilderLoaded
+System.ServiceModel.ComIntegration.ComIntegrationMexChannelBuilderLoaded  
+  
+## 説明  
+ Complus : Mex チャネル ローダーが読み込まれます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexmonikermetadataexchangecomplete.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexmonikermetadataexchangecomplete.md
new file mode 100644
index 00000000000..ca6281991b6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexmonikermetadataexchangecomplete.md
@@ -0,0 +1,28 @@
+---
+title: "System.Runtime.Serialization.ReadObjectEnd | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c997554-a08e-4d14-8628-c92e2cf84fcb
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.Runtime.Serialization.ReadObjectEnd
+System.Runtime.Serialization.ReadObjectEnd  
+  
+## 説明  
+ 終了した ReadObject。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehostcreatedserviceendpoint.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehostcreatedserviceendpoint.md
new file mode 100644
index 00000000000..9a834d2b430
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehostcreatedserviceendpoint.md
@@ -0,0 +1,32 @@
+---
+title: "System.ServiceModel.Channels.MsmqMoveOrDeleteAttemptFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d75d39da-7502-4a6a-91b9-eaa05b8e24d5
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Channels.MsmqMoveOrDeleteAttemptFailed
+メッセージを移動または削除できません。  
+  
+## 説明  
+ このトレースは、MSMQ メッセージの移動、削除、または拒否の試行中にエラーが発生したことを示しています。  
+  
+ MSMQ メッセージは \(NetMsmqBinding または MsmqIntegrationBinding のどちらかを使用する場合に\) [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] で使用されます。このトレースは NetMsmqBinding または MsmqIntegrationBinding の `ReceiveErrorHandling` プロパティで選択された値と関係しています。  
+  
+ このトレースはシステム全体についてのエラーを示すものではありません。  ただし、選択した有害メッセージの処置に失敗したことを示しています。  メッセージが有害となる場合の詳細、および有害メッセージをサービスで適切に処理するための構成方法については、「[有害メッセージの処理](http://go.microsoft.com/fwlink/?LinkID=99546)」を参照してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartedservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartedservice.md
new file mode 100644
index 00000000000..f2023ce5e36
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartedservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f395f028-8c9c-4b5d-857b-8d18f94d3375
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedService
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedService  
+  
+## 説明  
+ ComPlus : サービスが開始しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartingservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartingservice.md
new file mode 100644
index 00000000000..43b0cfa0911
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartingservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartingService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d748b1bc-5f8f-457c-918f-aadbc1c580f6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartingService
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartingService  
+  
+## 説明  
+ ComPlus : サービスを開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppedservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppedservice.md
new file mode 100644
index 00000000000..b762d2de30c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppedservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppedService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c388f68d-2c6d-4d68-bc2b-0d63b99fccf1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppedService
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppedService  
+  
+## 説明  
+ ComPlus : サービスが停止しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppingservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppingservice.md
new file mode 100644
index 00000000000..9bd1a7567bc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppingservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppingService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78e4e780-c784-4511-8cf5-dd5293579cec
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppingService
+System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppingService  
+  
+## 説明  
+ ComPlus : サービスを停止しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicemonikerparsed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicemonikerparsed.md
new file mode 100644
index 00000000000..8236e5e4ebc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicemonikerparsed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationServiceMonikerParsed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 827bf29b-bb7d-4f45-86ea-92752f656f5a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationServiceMonikerParsed
+System.ServiceModel.ComIntegration.ComIntegrationServiceMonikerParsed  
+  
+## 説明  
+ ComPlus : サービス モニカーが解析されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportconverterevent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportconverterevent.md
new file mode 100644
index 00000000000..d9139cfe419
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportconverterevent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTLBImportConverterEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9d06575-521c-4b88-ae45-0aec098b5bd7
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTLBImportConverterEvent
+System.ServiceModel.ComIntegration.ComIntegrationTLBImportConverterEvent  
+  
+## 説明  
+ ComPlus : タイプ ライブラリのコンバーター イベント  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfinished.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfinished.md
new file mode 100644
index 00000000000..a2707cc2555
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfinished.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTLBImportFinished | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0f1d5dc-92eb-42f9-8786-89cb8d4f22e6
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTLBImportFinished
+System.ServiceModel.ComIntegration.ComIntegrationTLBImportFinished  
+  
+## 説明  
+ コンポーネント タイプ ライブラリの分析が終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromassembly.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromassembly.md
new file mode 100644
index 00000000000..e5833e6a238
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromassembly.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromAssembly | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb2b6e33-00cb-403f-b616-1a70294d7aa8
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromAssembly
+System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromAssembly  
+  
+## 説明  
+ ComPlus : アセンブリを使用したタイプ ライブラリのインポート  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromtypelib.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromtypelib.md
new file mode 100644
index 00000000000..d07eba44d29
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromtypelib.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromTypelib | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e404950c-531a-48a1-b2dd-caba25217134
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromTypelib
+System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromTypelib  
+  
+## 説明  
+ ComPlus : タイプ ライブラリを使用したタイプ ライブラリのインポート  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportstarting.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportstarting.md
new file mode 100644
index 00000000000..bc91ac4f26b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportstarting.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTLBImportStarting | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f94b1d9e-25d5-41a9-864b-5e0be7daaf56
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTLBImportStarting
+System.ServiceModel.ComIntegration.ComIntegrationTLBImportStarting  
+  
+## 説明  
+ コンポーネント タイプ ライブラリの分析を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbycontext.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbycontext.md
new file mode 100644
index 00000000000..82cb0aafc9f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbycontext.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e783e3cb-b011-4a3b-890b-8c710978cbc8
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByContext
+System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByContext  
+  
+## 説明  
+ ComPlus : トランザクションが COM\+ のコンテキストで中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbytm.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbytm.md
new file mode 100644
index 00000000000..010bf42e311
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbytm.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByTM | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f09ea91-8399-4ea0-af70-640ce72a2018
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByTM
+System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByTM  
+  
+## 説明  
+ ComPlus : トランザクション マネージャーによってトランザクションが中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxcommitted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxcommitted.md
new file mode 100644
index 00000000000..d62a1ecfc18
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxcommitted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxCommitted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f9f5d2aa-04db-4d4d-b802-3bf5d4626e59
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxCommitted
+System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxCommitted  
+  
+## 説明  
+ ComPlus : トランザクションがコミットされました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtypedchannelbuilderloaded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtypedchannelbuilderloaded.md
new file mode 100644
index 00000000000..9152407eb20
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtypedchannelbuilderloaded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationTypedChannelBuilderLoaded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ebb0fd0e-3f3b-4e35-b0a1-05e281ca9207
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationTypedChannelBuilderLoaded
+System.ServiceModel.ComIntegration.ComIntegrationTypedChannelBuilderLoaded  
+  
+## 説明  
+ ComPlus : 読み込まれた型指定されたチャネル ビルダー  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationwsdlchannelbuilderloaded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationwsdlchannelbuilderloaded.md
new file mode 100644
index 00000000000..3982c59845d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationwsdlchannelbuilderloaded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ComIntegration.ComIntegrationWsdlChannelBuilderLoaded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b816e27e-e902-4009-bd61-325d68195f28
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ComIntegration.ComIntegrationWsdlChannelBuilderLoaded
+System.ServiceModel.ComIntegration.ComIntegrationWsdlChannelBuilderLoaded  
+  
+## 説明  
+ ComPlus : WSDL チャネル ビルダーが読み込まれました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectaborted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectaborted.md
new file mode 100644
index 00000000000..07e894b5053
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectaborted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a76eaf3-41a2-4ec2-adeb-c6bbce6ed8bf
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectAborted
+System.ServiceModel.CommunicationObjectAborted  
+  
+## 説明  
+ 通信オブジェクトが中止されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectabortfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectabortfailed.md
new file mode 100644
index 00000000000..9c1b6d41dcc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectabortfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectAbortFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f3cab70b-ec5d-412c-a7c2-e09377bc6d46
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.CommunicationObjectAbortFailed
+通信オブジェクトを中止できませんでした。  
+  
+## 説明  
+ Abort メソッドの実行中に例外がスローされたため、通信オブジェクトを中止できませんでした。  この付近のトレースに例外に関する詳細が含まれている可能性があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosed.md
new file mode 100644
index 00000000000..e0975b2bf05
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 94936c4c-8e83-4c59-a82e-a470e2728e80
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectClosed
+System.ServiceModel.CommunicationObjectClosed  
+  
+## 説明  
+ 通信オブジェクトが閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosefailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosefailed.md
new file mode 100644
index 00000000000..4c537406092
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosefailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectCloseFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 60270eab-6f57-4136-bec5-62d3edd23880
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.CommunicationObjectCloseFailed
+通信オブジェクトを閉じることができませんでした。  
+  
+## 説明  
+ Close メソッドの実行中に例外がスローされたため、通信オブジェクトを閉じることができませんでした。別の最近のトレースに、例外に関する詳細が含まれている可能性があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosing.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosing.md
new file mode 100644
index 00000000000..b3b5c602a86
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosing.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectClosing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b395653-7615-4dbe-8ee6-2dc11b659221
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectClosing
+System.ServiceModel.CommunicationObjectClosing  
+  
+## 説明  
+ 通信オブジェクトを閉じています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectcreated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectcreated.md
new file mode 100644
index 00000000000..7a2ec32b8bc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectcreated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectCreated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d0d4ab3-270c-408d-b48a-b53b02cb9263
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectCreated
+System.ServiceModel.CommunicationObjectCreated  
+  
+## 説明  
+ 通信オブジェクトが作成されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectdisposing.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectdisposing.md
new file mode 100644
index 00000000000..9eae063d6ac
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectdisposing.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectDisposing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b7199c74-c218-426b-b77d-a20c562d7910
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectDisposing
+System.ServiceModel.CommunicationObjectDisposing  
+  
+## 説明  
+ 通信オブジェクトが破棄されていました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaulted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaulted.md
new file mode 100644
index 00000000000..8d51fa8935a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaulted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14a9e56d-6f75-49be-95c6-44510533af91
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectFaulted
+System.ServiceModel.CommunicationObjectFaulted  
+  
+## 説明  
+ 通信オブジェクトでエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaultreason.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaultreason.md
new file mode 100644
index 00000000000..432c2c8735d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaultreason.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectFaultReason | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d2530933-bfba-4b20-aba6-b1f99e97699d
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectFaultReason
+System.ServiceModel.CommunicationObjectFaultReason  
+  
+## 説明  
+ 例外により通信オブジェクトでエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopened.md
new file mode 100644
index 00000000000..5697a46aaaa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 431ccb35-b593-4157-8e4d-f20e579630fd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectOpened
+System.ServiceModel.CommunicationObjectOpened  
+  
+## 説明  
+ 通信オブジェクトが開かれました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopenfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopenfailed.md
new file mode 100644
index 00000000000..a2898771e77
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopenfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectOpenFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8e188528-c4f4-499e-9ac2-a2fac4742f29
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.CommunicationObjectOpenFailed
+通信オブジェクトを開けませんでした。  
+  
+## 説明  
+ Open メソッドの実行中に例外がスローされたため、通信オブジェクトを開けませんでした。この付近のトレースに例外に関する詳細が含まれている可能性があります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopening.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopening.md
new file mode 100644
index 00000000000..8be5530b7a3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopening.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.CommunicationObjectOpening | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e19954e9-dd48-4560-b891-96d0ff8ecf98
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.CommunicationObjectOpening
+System.ServiceModel.CommunicationObjectOpening  
+  
+## 説明  
+ 通信オブジェクトを開いています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configurationisreadonly.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configurationisreadonly.md
new file mode 100644
index 00000000000..fab984997a6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configurationisreadonly.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ConfigurationIsReadOnly | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6734380-8ecf-454a-ab45-8832d6a27871
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ConfigurationIsReadOnly
+System.ServiceModel.ConfigurationIsReadOnly  
+  
+## 説明  
+ 構成は読み取り専用です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configuredextensiontypenotfound.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configuredextensiontypenotfound.md
new file mode 100644
index 00000000000..d785e6e0c52
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-configuredextensiontypenotfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ConfiguredExtensionTypeNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef1c72d7-35c4-4886-80bb-b0a368da77e2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ConfiguredExtensionTypeNotFound
+System.ServiceModel.ConfiguredExtensionTypeNotFound  
+  
+## 説明  
+ 拡張の型が構成されていません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-activityboundary.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-activityboundary.md
new file mode 100644
index 00000000000..5a104075057
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-activityboundary.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.ActivityBoundary | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a24e3076-0c14-4271-9990-090c0dfed07f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.ActivityBoundary
+System.ServiceModel.Diagnostics.ActivityBoundary  
+  
+## 説明  
+ 動作の境界。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-appdomainunload.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-appdomainunload.md
new file mode 100644
index 00000000000..701c2d6c7aa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-appdomainunload.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.AppDomainUnload | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d3901f94-db06-4309-8e24-afdec5eeb102
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Diagnostics.AppDomainUnload
+System.ServiceModel.Diagnostics.AppDomainUnload  
+  
+## 説明  
+ AppDomain をアンロード中です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-diagnosticsfailedmessagetrace.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-diagnosticsfailedmessagetrace.md
new file mode 100644
index 00000000000..29c72733a3b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-diagnosticsfailedmessagetrace.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.DiagnosticsFailedMessageTrace | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8c1de25c-7e1e-4986-9c32-fc47a604f373
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.DiagnosticsFailedMessageTrace
+System.ServiceModel.Diagnostics.DiagnosticsFailedMessageTrace  
+  
+## 説明  
+ メッセージをトレースできませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-eventlog.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-eventlog.md
new file mode 100644
index 00000000000..5b9bc520ef9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-eventlog.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.EventLog | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e8b517b-4f89-4067-8070-e86915b608c4
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.EventLog
+System.ServiceModel.Diagnostics.EventLog  
+  
+## 説明  
+ EventLog に書き込みました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoaddanactivityidheader.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoaddanactivityidheader.md
new file mode 100644
index 00000000000..a689e59ef3c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoaddanactivityidheader.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.FailedToAddAnActivityIdHeader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2a1a5612-82c6-4cf6-aa96-ca6f5df12b69
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.FailedToAddAnActivityIdHeader
+System.ServiceModel.Diagnostics.FailedToAddAnActivityIdHeader  
+  
+## 説明  
+ 送信メッセージのアクティビティ ID ヘッダーを設定できませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoreadanactivityidheader.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoreadanactivityidheader.md
new file mode 100644
index 00000000000..c028ecc5bf6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoreadanactivityidheader.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.FailedToReadAnActivityIdHeader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dba7f15e-b8f5-4c96-9c02-a3a49723ebb2
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.Diagnostics.FailedToReadAnActivityIdHeader
+System.ServiceModel.Diagnostics.FailedToReadAnActivityIdHeader  
+  
+## 説明  
+ メッセージのアクティビティ ID ヘッダーを読み取ることができませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-filternotmatchednodequotaexceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-filternotmatchednodequotaexceeded.md
new file mode 100644
index 00000000000..ca2fb6baf7c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-filternotmatchednodequotaexceeded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.FilterNotMatchedNodeQuotaExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 067f27ba-4d9e-4efb-8fa7-c23d2654d967
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.FilterNotMatchedNodeQuotaExceeded
+System.ServiceModel.Diagnostics.FilterNotMatchedNodeQuotaExceeded  
+  
+## 説明  
+ メッセージに対するメッセージ ログ記録フィルターの評価が、フィルターに設定されたノード クォータを超えました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-messagenotloggedquotaexceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-messagenotloggedquotaexceeded.md
new file mode 100644
index 00000000000..5943895ac2b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-messagenotloggedquotaexceeded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.MessageNotLoggedQuotaExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b4fa4c5-83b7-41c3-9d5e-baa1fc2c98ae
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.MessageNotLoggedQuotaExceeded
+System.ServiceModel.Diagnostics.MessageNotLoggedQuotaExceeded  
+  
+## 説明  
+ サイズが構成されたクォータを超えているため、ログに記録されなかったメッセージ。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-throwingexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-throwingexception.md
new file mode 100644
index 00000000000..a92214be675
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-throwingexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.ThrowingException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d543c68-1fd2-4512-a219-baf698136ef0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.Diagnostics.ThrowingException
+System.ServiceModel.Diagnostics.ThrowingException  
+  
+## 説明  
+ 例外をスローします。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracehandledexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracehandledexception.md
new file mode 100644
index 00000000000..61f7574e832
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracehandledexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.TraceHandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd9a62db-258c-4a39-ae8f-cc948912638f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.TraceHandledException
+System.ServiceModel.Diagnostics.TraceHandledException  
+  
+## 説明  
+ 例外を処理しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracetruncatedquotaexceeded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracetruncatedquotaexceeded.md
new file mode 100644
index 00000000000..6f5a87418dc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracetruncatedquotaexceeded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.TraceTruncatedQuotaExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 623d66f1-389f-43c7-a6ea-afe7f80651a5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.TraceTruncatedQuotaExceeded
+System.ServiceModel.Diagnostics.TraceTruncatedQuotaExceeded  
+  
+## 説明  
+ トレース サイズのクォータを超えました。トレースは途中終了されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-unhandledexception.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-unhandledexception.md
new file mode 100644
index 00000000000..884112eddc5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-unhandledexception.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Diagnostics.UnhandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6807fdfc-1e7e-42ca-8efe-a05b51de2f8f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Diagnostics.UnhandledException
+System.ServiceModel.Diagnostics.UnhandledException  
+  
+## 説明  
+ 未処理の例外。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-didnotunderstandmessageheader.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-didnotunderstandmessageheader.md
new file mode 100644
index 00000000000..1007eb66353
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-didnotunderstandmessageheader.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.DidNotUnderstandMessageHeader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4dfc51c-7148-4181-81c3-7b424b4c43db
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.DidNotUnderstandMessageHeader
+System.ServiceModel.DidNotUnderstandMessageHeader  
+  
+## 説明  
+ メッセージ ヘッダーを認識できませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-droppedamessage.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-droppedamessage.md
new file mode 100644
index 00000000000..183ba9676ef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-droppedamessage.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.DroppedAMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a299401f-2983-45ea-b4f3-963bece3602e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.DroppedAMessage
+System.ServiceModel.DroppedAMessage  
+  
+## 説明  
+ 応答メッセージを受信しましたが、このメッセージを待っている未処理の要求がありません。[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] ランタイムは、このメッセージを削除しています。  
+  
+ このトレースは、失われたメッセージのデバッグに使用できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-elementtypedoesntmatchconfiguredtype.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-elementtypedoesntmatchconfiguredtype.md
new file mode 100644
index 00000000000..98d6da93a10
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-elementtypedoesntmatchconfiguredtype.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ElementTypeDoesntMatchConfiguredType | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0bc74839-6e28-449b-80c9-b62ad7e58207
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ElementTypeDoesntMatchConfiguredType
+System.ServiceModel.ElementTypeDoesntMatchConfiguredType  
+  
+## 説明  
+ 要素の型が構成の型に一致しません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-endexecutemethod.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-endexecutemethod.md
new file mode 100644
index 00000000000..680f40e15c9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-endexecutemethod.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.EndExecuteMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e68207f-1756-49e2-ac3a-04a881241f8a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.EndExecuteMethod
+System.ServiceModel.EndExecuteMethod  
+  
+## 説明  
+ 終了メソッドの実行。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-errorinvokingusercode.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-errorinvokingusercode.md
new file mode 100644
index 00000000000..9a517701a85
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-errorinvokingusercode.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ErrorInvokingUserCode | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48849ef4-d0af-45f1-b320-1a1280404e45
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ErrorInvokingUserCode
+System.ServiceModel.ErrorInvokingUserCode  
+  
+## 説明  
+ ユーザー コードの呼び出し中にエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-evaluationcontextnotfound.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-evaluationcontextnotfound.md
new file mode 100644
index 00000000000..8e4648c265b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-evaluationcontextnotfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.EvaluationContextNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff801204-1fc9-4bb2-9de1-be751073eb34
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.EvaluationContextNotFound
+System.ServiceModel.EvaluationContextNotFound  
+  
+## 説明  
+ 構成の評価コンテキストが見つかりませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectiondoesnotexist.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectiondoesnotexist.md
new file mode 100644
index 00000000000..c042f050932
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectiondoesnotexist.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ExtensionCollectionDoesNotExist | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 61a5231b-4385-4a49-b676-a8e60cda96c3
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ExtensionCollectionDoesNotExist
+System.ServiceModel.ExtensionCollectionDoesNotExist  
+  
+## 説明  
+ 拡張コレクションが存在しません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionisempty.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionisempty.md
new file mode 100644
index 00000000000..7c05bb58637
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionisempty.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ExtensionCollectionIsEmpty | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efac8d8a-4c91-45f4-8e33-9e370be55eae
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ExtensionCollectionIsEmpty
+System.ServiceModel.ExtensionCollectionIsEmpty  
+  
+## 説明  
+ 拡張コレクションは空です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionnamenotfound.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionnamenotfound.md
new file mode 100644
index 00000000000..404eac81b1f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionnamenotfound.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ExtensionCollectionNameNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67b26f93-2e85-4a56-b103-6e8db149191c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ExtensionCollectionNameNotFound
+System.ServiceModel.ExtensionCollectionNameNotFound  
+  
+## 説明  
+ 拡張要素が拡張のコレクションに関連付けられていません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensionelementalreadyexistsincollection.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensionelementalreadyexistsincollection.md
new file mode 100644
index 00000000000..f4cb0d3ad7e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensionelementalreadyexistsincollection.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ExtensionElementAlreadyExistsInCollection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e6c0c5d4-889c-45fb-b90f-3720bb183aa4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ExtensionElementAlreadyExistsInCollection
+System.ServiceModel.ExtensionElementAlreadyExistsInCollection  
+  
+## 説明  
+ 拡張要素は既にコレクションに存在します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-failedtoopenincomingchannel.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-failedtoopenincomingchannel.md
new file mode 100644
index 00000000000..2d01d2215e1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-failedtoopenincomingchannel.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.FailedToOpenIncomingChannel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7c6c6b1b-51b8-4f45-bf76-62d816a1fc0a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.FailedToOpenIncomingChannel
+System.ServiceModel.FailedToOpenIncomingChannel  
+  
+## 説明  
+ 受信チャネルを開こうとしたときにエラーが発生したため、受信チャネルは破棄されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getbehaviorelement.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getbehaviorelement.md
new file mode 100644
index 00000000000..896fb24305f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getbehaviorelement.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetBehaviorElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7332d23-e226-470c-b063-0fb9d919437f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.GetBehaviorElement
+System.ServiceModel.GetBehaviorElement  
+  
+## 説明  
+ BehaviorElement を取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getchannelendpointelement.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getchannelendpointelement.md
new file mode 100644
index 00000000000..8050350d006
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getchannelendpointelement.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetChannelEndpointElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee75c333-2e63-4f26-ae73-14324f4d088a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.GetChannelEndpointElement
+System.ServiceModel.GetChannelEndpointElement  
+  
+## 説明  
+ このトレースは、チャネル ファクトリを作成するときに情報レベルで出力されます。  このトレースには、クライアントが対話しているエンドポイントの説明 \(リモート アドレス、バインディング、コントラクト名など\) が表示されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getcommonbehaviors.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getcommonbehaviors.md
new file mode 100644
index 00000000000..f336a7ab50a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getcommonbehaviors.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetCommonBehaviors | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 20f4013b-15fa-4fe7-b129-4ec4d231e479
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.GetCommonBehaviors
+System.ServiceModel.GetCommonBehaviors  
+  
+## 説明  
+ Machine.config の共通の動作を取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfigurationsection.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfigurationsection.md
new file mode 100644
index 00000000000..184b61f83b0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfigurationsection.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetConfigurationSection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4872884d-4de9-4968-b703-380677830f0b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.GetConfigurationSection
+System.ServiceModel.GetConfigurationSection  
+  
+## 説明  
+ 構成セクションを取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfiguredbinding.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfiguredbinding.md
new file mode 100644
index 00000000000..bc1d2fb469d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfiguredbinding.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetConfiguredBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4268f49-c0c9-410f-b175-173218a785bf
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.GetConfiguredBinding
+System.ServiceModel.GetConfiguredBinding  
+  
+## 説明  
+ 構成済みバインディングを取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getdefaultconfiguredbinding.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getdefaultconfiguredbinding.md
new file mode 100644
index 00000000000..13c2b26c4da
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getdefaultconfiguredbinding.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetDefaultConfiguredBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: da8e6c84-38b1-4c3b-b619-baca34f31691
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.GetDefaultConfiguredBinding
+System.ServiceModel.GetDefaultConfiguredBinding  
+  
+## 説明  
+ 既定で構成されたバインディングを取得します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getserviceelement.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getserviceelement.md
new file mode 100644
index 00000000000..322e4dc11d3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-getserviceelement.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.GetServiceElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 80535b67-f196-467b-93aa-ea9de902a2e5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.GetServiceElement
+System.ServiceModel.GetServiceElement  
+  
+## 説明  
+ このトレースは、情報レベルでサービス ホストを作成するときに出力されます。サービス コントラクトとバインディングの説明が提供されます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-manualflowthrottlelimitreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-manualflowthrottlelimitreached.md
new file mode 100644
index 00000000000..16c08756869
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-manualflowthrottlelimitreached.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.ManualFlowThrottleLimitReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9aba851f-1830-493b-8e3e-60f454eb923e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ManualFlowThrottleLimitReached
+System.ServiceModel.ManualFlowThrottleLimitReached  
+  
+## 説明  
+ システムは ManualFlowControlLimit スロットルに設定された制限値に達しました。スロットル値を変更するには、ServiceHost または InstanceContext の ManualFlowControlLimit プロパティを適宜変更します。  
+  
+ このトレースは、マニュアル フロー制御制限が初めて 0 に減少したときに出力されます。それ以降は、0 に変更されてもトレースされません。インスタンス コンテキストに対するフロー制御制限は、コンテキストごとに 1 回トレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosed.md
new file mode 100644
index 00000000000..3b08e2e0ec7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MessageClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c05964fe-d43e-4387-b92e-03a7e5f934d6
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MessageClosed
+System.ServiceModel.MessageClosed  
+  
+## 説明  
+ メッセージが閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosedagain.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosedagain.md
new file mode 100644
index 00000000000..cdaa13e2a25
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosedagain.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.MessageClosedAgain | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24c274d4-65cd-4c91-9869-bc6eb34ef979
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.MessageClosedAgain
+System.ServiceModel.MessageClosedAgain  
+  
+## 説明  
+ メッセージがもう一度閉じられました。  
+  
+ メッセージを閉じることができるのは一度だけです。このトレースがユーザー拡張コード内で出力されている場合は、ユーザー拡張コードは既に閉じられているメッセージをさらに閉じようとしていることが示されています。このトレースが製品のコード内で出力されている場合は、ユーザー拡張コードがメッセージを閉じるのが早すぎる可能性があることが示されています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagecopied.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagecopied.md
new file mode 100644
index 00000000000..36bcdf442d1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagecopied.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MessageCopied | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fb1cfc2-de26-42a7-9fe9-c2a852e0e9c2
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MessageCopied
+System.ServiceModel.MessageCopied  
+  
+## 説明  
+ メッセージがコピーされました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageprocessingpaused.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageprocessingpaused.md
new file mode 100644
index 00000000000..5ae6cab6651
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageprocessingpaused.md
@@ -0,0 +1,36 @@
+---
+title: "System.ServiceModel.MessageProcessingPaused | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 36b5302a-93cc-478a-9bb2-8a1601fba1df
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.MessageProcessingPaused
+System.ServiceModel.MessageProcessingPaused  
+  
+## 説明  
+ メッセージの処理中にスレッドが切り替わりました。  
+  
+ メッセージ処理は、次の理由によって一時停止することがあります。  
+  
+-   ConcurrencyMode が単一または再入可能で、サービスが別のメッセージを処理している。  
+  
+-   トランザクションが有効で、サービスが別のトランザクションを処理している。  
+  
+-   同期コンテキストが最新ではない。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageread.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageread.md
new file mode 100644
index 00000000000..27135096dc2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageread.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MessageRead | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57cd54c3-577e-4e2b-a852-0dae6f7eb52a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MessageRead
+System.ServiceModel.MessageRead  
+  
+## 説明  
+ メッセージが読み取られました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagewritten.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagewritten.md
new file mode 100644
index 00000000000..4de5f803c7d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagewritten.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MessageWritten | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5d8ce118-acdc-429c-ac89-34e943267c99
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MessageWritten
+System.ServiceModel.MessageWritten  
+  
+## 説明  
+ メッセージが書き込まれました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientreceivereply.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientreceivereply.md
new file mode 100644
index 00000000000..7727a0f005c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientreceivereply.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MetadataExchangeClientReceiveReply | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24edae24-8ced-43c4-948b-f400ba42b2a5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MetadataExchangeClientReceiveReply
+System.ServiceModel.MetadataExchangeClientReceiveReply  
+  
+## 説明  
+ MetadataExchangeClient は応答を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientsendrequest.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientsendrequest.md
new file mode 100644
index 00000000000..6df415fb55d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientsendrequest.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.MetadataExchangeClientSendRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba02fed9-331a-4aea-b5e1-fe16c7dd4ddd
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.MetadataExchangeClientSendRequest
+System.ServiceModel.MetadataExchangeClientSendRequest  
+  
+## 説明  
+ MetadataExchangeClient はメタデータの要求を送信しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-overridingduplicateconfigurationkey.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-overridingduplicateconfigurationkey.md
new file mode 100644
index 00000000000..2d2d25de26c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-overridingduplicateconfigurationkey.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.OverridingDuplicateConfigurationKey | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d11700b-c035-467e-af02-686bca3b207a
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.OverridingDuplicateConfigurationKey
+System.ServiceModel.OverridingDuplicateConfigurationKey  
+  
+## 説明  
+ 構成システムは別の構成範囲内で重複するキーを検出したため、新しい値でオーバーライドしています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecounterfailedtoload.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecounterfailedtoload.md
new file mode 100644
index 00000000000..002001fcca8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecounterfailedtoload.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PerformanceCounterFailedToLoad | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 776ceeae-b0b7-4710-b9ce-592be610025b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PerformanceCounterFailedToLoad
+System.ServiceModel.PerformanceCounterFailedToLoad  
+  
+## 説明  
+ パフォーマンス カウンターを読み込むことができませんでした。一部のパフォーマンス カウンターは利用できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailed.md
new file mode 100644
index 00000000000..0c51533795b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PerformanceCountersFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bf030f3-e218-4300-943f-03aaa7dfe2d3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PerformanceCountersFailed
+System.ServiceModel.PerformanceCountersFailed  
+  
+## 説明  
+ 指定されたパフォーマンス カウンターを読み込むことができませんでした。一部のパフォーマンス カウンターは利用できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedduringupdate.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedduringupdate.md
new file mode 100644
index 00000000000..149d001efd5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedduringupdate.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PerformanceCountersFailedDuringUpdate | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a89ab9b8-4429-4df0-ab62-7db4c58684cc
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PerformanceCountersFailedDuringUpdate
+System.ServiceModel.PerformanceCountersFailedDuringUpdate  
+  
+## 説明  
+ 指定したパフォーマンス カウンターの更新中にエラーが発生しました。このパフォーマンス カウンターを無効にします。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedforservice.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedforservice.md
new file mode 100644
index 00000000000..9064c8d28b5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedforservice.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PerformanceCountersFailedForService | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f194b0a5-96ff-4ec5-b8f8-1a25d059dc99
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PerformanceCountersFailedForService
+System.ServiceModel.PerformanceCountersFailedForService  
+  
+## 説明  
+ サービス用のパフォーマンス カウンターの読み込みが失敗しました。  このサービスではパフォーマンス カウンターを使用できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedonrelease.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedonrelease.md
new file mode 100644
index 00000000000..9566a320a48
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedonrelease.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PerformanceCountersFailedOnRelease | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec1a7bb1-c787-45ec-8292-73d104f3d7bb
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PerformanceCountersFailedOnRelease
+System.ServiceModel.PerformanceCountersFailedOnRelease  
+  
+## 説明  
+ パフォーマンス カウンターのアンロードに失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingclosed.md
new file mode 100644
index 00000000000..f07d9e848fa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.PortSharingClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f93c5b3-d56c-412f-9c26-68da85f4bd92
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.PortSharingClosed
+System.ServiceModel.PortSharing.PortSharingClosed  
+  
+## 説明  
+ TransportManager は正常に終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduphandlegranted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduphandlegranted.md
new file mode 100644
index 00000000000..60f5da2a26e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduphandlegranted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.PortSharingDupHandleGranted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dde8a393-f31a-4e6d-b483-001b389e2df9
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PortSharing.PortSharingDupHandleGranted
+System.ServiceModel.PortSharing.PortSharingDupHandleGranted  
+  
+## 説明  
+ 指定した SID を持つ特定のサービスのアカウントに、PROCESS\_DUP\_HANDLE アクセス権が与えられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedpipe.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedpipe.md
new file mode 100644
index 00000000000..420ea6303db
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedpipe.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.PortSharingDuplicatedPipe | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc53c0a0-62e0-4295-be0b-a1df6966ecea
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.PortSharingDuplicatedPipe
+System.ServiceModel.PortSharing.PortSharingDuplicatedPipe  
+  
+## 説明  
+ 名前付きパイプが正常に複製されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedsocket.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedsocket.md
new file mode 100644
index 00000000000..341bb5b4729
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedsocket.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.PortSharingDuplicatedSocket | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7fd7a35d-3ade-44c2-b40e-2236c3ff18c5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.PortSharingDuplicatedSocket
+System.ServiceModel.PortSharing.PortSharingDuplicatedSocket  
+  
+## 説明  
+ ソケットが正常に複製されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharinglistening.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharinglistening.md
new file mode 100644
index 00000000000..081e647eb01
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharinglistening.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.PortSharingListening | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05528126-de72-4801-93ab-397f3c32b809
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.PortSharingListening
+System.ServiceModel.PortSharing.PortSharingListening  
+  
+## 説明  
+ TransportManager は現在、正常に待機しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnetpipeconfig.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnetpipeconfig.md
new file mode 100644
index 00000000000..df11a1f2a65
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnetpipeconfig.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.ReadNetPipeConfig | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a782f971-0195-4bad-a151-55d35656ae86
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PortSharing.ReadNetPipeConfig
+System.ServiceModel.PortSharing.ReadNetPipeConfig  
+  
+## 説明  
+ 指定したデータ \(maxConnectionsPendingDispatch、maxPendingAccepts、および receiveTimeout\) を使用して、NetPipeSection の構成データを読み取りました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnettcpconfig.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnettcpconfig.md
new file mode 100644
index 00000000000..5408cbbe940
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnettcpconfig.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.ReadNetTcpConfig | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0d3350f-9d70-4529-a958-eb56a277e401
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PortSharing.ReadNetTcpConfig
+System.ServiceModel.PortSharing.ReadNetTcpConfig  
+  
+## 説明  
+ 指定したデータ \(listenBacklog、maxConnectionsPendingDispatch、maxPendingAccepts、receiveTimeout、および teredoEnabled\) を使用して、NetTcpSection の構成データを読み取りました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablecannotlisten.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablecannotlisten.md
new file mode 100644
index 00000000000..aaecd824ad2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablecannotlisten.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTableCannotListen | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c2632b1-ea67-4feb-88f9-d00874842eb9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTableCannotListen
+System.ServiceModel.PortSharing.RoutingTableCannotListen  
+  
+## 説明  
+ ルーティング テーブルをリッスンできません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablelookup.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablelookup.md
new file mode 100644
index 00000000000..bc961e29fcc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablelookup.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTableLookup | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51788083-310c-4c36-a9a1-f1089a1e2687
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTableLookup
+System.ServiceModel.PortSharing.RoutingTableLookup  
+  
+## 説明  
+ 検索操作が要求されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablenamespaceconflict.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablenamespaceconflict.md
new file mode 100644
index 00000000000..0eb51c46e1f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablenamespaceconflict.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTableNamespaceConflict | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5698b658-211b-4c92-b052-2dba57315551
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTableNamespaceConflict
+System.ServiceModel.PortSharing.RoutingTableNamespaceConflict  
+  
+## 説明  
+ 名前空間は既に登録されています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablepathtoolong.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablepathtoolong.md
new file mode 100644
index 00000000000..272727a0dbd
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablepathtoolong.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTablePathTooLong | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6e4a9c78-c753-469c-93c4-c3a391dc2a11
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTablePathTooLong
+System.ServiceModel.PortSharing.RoutingTablePathTooLong  
+  
+## 説明  
+ 名前空間が長すぎます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableregistersuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableregistersuccess.md
new file mode 100644
index 00000000000..c7abacd8132
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableregistersuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTableRegisterSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f9441ce-5f4a-4080-9be5-c3c08a87bb21
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTableRegisterSuccess
+System.ServiceModel.PortSharing.RoutingTableRegisterSuccess  
+  
+## 説明  
+ 名前空間は正常に登録されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableunsupportedprotocol.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableunsupportedprotocol.md
new file mode 100644
index 00000000000..f00a0d8c900
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableunsupportedprotocol.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.RoutingTableUnsupportedProtocol | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bcdb34f1-e9b1-4f04-8403-325c3385d86d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.RoutingTableUnsupportedProtocol
+System.ServiceModel.PortSharing.RoutingTableUnsupportedProtocol  
+  
+## 説明  
+ プロトコルがサポートされていません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-sharedmanagerserviceendpointnotexist.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-sharedmanagerserviceendpointnotexist.md
new file mode 100644
index 00000000000..baf8c98ffe7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-sharedmanagerserviceendpointnotexist.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.SharedManagerServiceEndpointNotExist | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2f9638ec-620c-477b-a6fc-2228aea1f875
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PortSharing.SharedManagerServiceEndpointNotExist
+System.ServiceModel.PortSharing.SharedManagerServiceEndpointNotExist  
+  
+## 説明  
+ 指定されたサービスのエンドポイントの共有メモリが存在しません。このサービスを開始できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistening.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistening.md
new file mode 100644
index 00000000000..fb47d7026b4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistening.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.TransportListenerListening | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89c9a692-4a42-4704-b0dd-c4c5f78498b1
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.TransportListenerListening
+System.ServiceModel.PortSharing.TransportListenerListening  
+  
+## 説明  
+ TransportListener はリッスン中です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistenrequest.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistenrequest.md
new file mode 100644
index 00000000000..26be4e8aa3a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistenrequest.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.TransportListenerListenRequest | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6b72086d-a047-4316-854e-2c210d3d52fe
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.TransportListenerListenRequest
+System.ServiceModel.PortSharing.TransportListenerListenRequest  
+  
+## 説明  
+ TransportListener はリッスンを開始します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenersessionsreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenersessionsreceived.md
new file mode 100644
index 00000000000..bf8b3d99aa0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenersessionsreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.TransportListenerSessionsReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7a1aca3-7585-4e83-be9e-c2010424647e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.TransportListenerSessionsReceived
+System.ServiceModel.PortSharing.TransportListenerSessionsReceived  
+  
+## 説明  
+ TransportListener がセッションを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerstop.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerstop.md
new file mode 100644
index 00000000000..c98c20545bb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerstop.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.TransportListenerStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7404a8e8-55c2-4b48-943d-a5df22ae79f9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.TransportListenerStop
+System.ServiceModel.PortSharing.TransportListenerStop  
+  
+## 説明  
+ TransportListener はリッスンを停止します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasclosealllistenerchannelinstances.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasclosealllistenerchannelinstances.md
new file mode 100644
index 00000000000..ed241db34c1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasclosealllistenerchannelinstances.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.WasCloseAllListenerChannelInstances | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 25c502de-e7d9-4838-bc7e-3ac4fa64dfad
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.WasCloseAllListenerChannelInstances
+System.ServiceModel.PortSharing.WasCloseAllListenerChannelInstances  
+  
+## 説明  
+ Windows プロセス アクティブ化サービス \(WAS\) を使用するリスナー チャネルのインスタンスをすべて閉じます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasconnected.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasconnected.md
new file mode 100644
index 00000000000..05f06b71c29
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasconnected.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.WasConnected | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8af0f73f-3718-4dc8-93f4-638e2465da21
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.PortSharing.WasConnected
+System.ServiceModel.PortSharing.WasConnected  
+  
+## 説明  
+ Windows プロセス アクティブ化サービス \(WAS\) の接続が確立されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-waswebhostapifailed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-waswebhostapifailed.md
new file mode 100644
index 00000000000..80cac86e712
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-waswebhostapifailed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.PortSharing.WasWebHostAPIFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31a3ed07-16dc-4aa2-8cd7-6974ef75432b
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.PortSharing.WasWebHostAPIFailed
+System.ServiceModel.PortSharing.WasWebHostAPIFailed  
+  
+## 説明  
+ 指定された Windows プロセス アクティブ化サービス \(WAS\) API の呼び出しが、指定されたエラー コードで失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-removebehavior.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-removebehavior.md
new file mode 100644
index 00000000000..5fb0790f5ae
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-removebehavior.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.RemoveBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb64042c-0b07-47b9-a8b7-bd0c06c057e3
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.RemoveBehavior
+System.ServiceModel.RemoveBehavior  
+  
+## 説明  
+ この動作型は既にコレクション内にあります。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingentry.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingentry.md
new file mode 100644
index 00000000000..c8b1cfdaad9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingentry.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.ExportSecurityChannelBindingEntry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 043bad66-0a09-47c2-ae90-d1f225f52a24
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.ExportSecurityChannelBindingEntry
+System.ServiceModel.Security.ExportSecurityChannelBindingEntry  
+  
+## 説明  
+ セキュリティの ExportChannelBinding を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingexit.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingexit.md
new file mode 100644
index 00000000000..6ece1465643
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingexit.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.ExportSecurityChannelBindingExit | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 714a8f4d-a297-4f1c-b9df-d97115a1d82a
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.ExportSecurityChannelBindingExit
+System.ServiceModel.Security.ExportSecurityChannelBindingExit  
+  
+## 説明  
+ セキュリティの ExportChannelBinding を終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingentry.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingentry.md
new file mode 100644
index 00000000000..8da34acd198
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingentry.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.ImportSecurityChannelBindingEntry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 167e4485-3595-43a9-a342-674cd6a35daa
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.ImportSecurityChannelBindingEntry
+System.ServiceModel.Security.ImportSecurityChannelBindingEntry  
+  
+## 説明  
+ セキュリティの ImportChannelBinding を開始しています。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingexit.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingexit.md
new file mode 100644
index 00000000000..977afb4effb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingexit.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.ImportSecurityChannelBindingExit | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a174db12-23e4-49ec-b8b3-40ca7b2c1ba1
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.ImportSecurityChannelBindingExit
+System.ServiceModel.Security.ImportSecurityChannelBindingExit  
+  
+## 説明  
+ セキュリティの ImportChannelBinding を終了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderbeginsecuritynegotiation.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderbeginsecuritynegotiation.md
new file mode 100644
index 00000000000..657a3c85f85
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderbeginsecuritynegotiation.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderBeginSecurityNegotiation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc7a8357-4993-4488-9e4a-e544fbd45e3d
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderBeginSecurityNegotiation
+System.ServiceModel.Security.IssuanceTokenProviderBeginSecurityNegotiation  
+  
+## 説明  
+ IssuanceTokenProvider が新しいセキュリティ ネゴシエーションを開始しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderendsecuritynegotiation.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderendsecuritynegotiation.md
new file mode 100644
index 00000000000..f0d5546f8d8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderendsecuritynegotiation.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderEndSecurityNegotiation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 44a0b49e-fbd7-4649-a29a-1d1a6cd36a90
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderEndSecurityNegotiation
+System.ServiceModel.Security.IssuanceTokenProviderEndSecurityNegotiation  
+  
+## 説明  
+ IssuanceTokenProvider はセキュリティ ネゴシエーションを完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderredirectapplied.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderredirectapplied.md
new file mode 100644
index 00000000000..c5c7d4d0512
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderredirectapplied.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderRedirectApplied | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d69e50dc-f7d5-423d-9a1c-a23d558e78af
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderRedirectApplied
+System.ServiceModel.Security.IssuanceTokenProviderRedirectApplied  
+  
+## 説明  
+ リダイレクト ヘッダーを適用された IssuanceTokenProvider。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderremovedcachedtoken.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderremovedcachedtoken.md
new file mode 100644
index 00000000000..57fe8b4f725
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderremovedcachedtoken.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderRemovedCachedToken | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aeb403d4-a473-4ffc-b978-17f89d8d2592
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderRemovedCachedToken
+System.ServiceModel.Security.IssuanceTokenProviderRemovedCachedToken  
+  
+## 説明  
+ IssuanceTokenProvider は期限切れのサービス トークンを削除しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderservicetokencachefull.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderservicetokencachefull.md
new file mode 100644
index 00000000000..afd13d465d4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderservicetokencachefull.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderServiceTokenCacheFull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58658b3f-c0f1-47e2-bf61-2c786e7b62b1
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderServiceTokenCacheFull
+System.ServiceModel.Security.IssuanceTokenProviderServiceTokenCacheFull  
+  
+## 説明  
+ IssuanceTokenProviderServiceToken キャッシュがいっぱいです。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderusingcachedtoken.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderusingcachedtoken.md
new file mode 100644
index 00000000000..259e2519716
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderusingcachedtoken.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.IssuanceTokenProviderUsingCachedToken | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee51ed4e-821c-4010-8d64-eabde522169f
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.IssuanceTokenProviderUsingCachedToken
+System.ServiceModel.Security.IssuanceTokenProviderUsingCachedToken  
+  
+## 説明  
+ IssuanceTokenProvider はキャッシュされたサービス トークンを使用しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationauthenticatorattached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationauthenticatorattached.md
new file mode 100644
index 00000000000..8527c9dfee7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationauthenticatorattached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.NegotiationAuthenticatorAttached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 20a289a5-6450-46dd-bb83-c394379b857b
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.NegotiationAuthenticatorAttached
+System.ServiceModel.Security.NegotiationAuthenticatorAttached  
+  
+## 説明  
+ NegotiationTokenAuthenticator が割り当てられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationtokenproviderattached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationtokenproviderattached.md
new file mode 100644
index 00000000000..fd9a11ef413
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationtokenproviderattached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.NegotiationTokenProviderAttached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f5602e5e-aaaf-42ca-9afc-d2c699447db7
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.NegotiationTokenProviderAttached
+System.ServiceModel.Security.NegotiationTokenProviderAttached  
+  
+## 説明  
+ NegotiationTokenProvider が割り当てられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityactiveserversessionremoved.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityactiveserversessionremoved.md
new file mode 100644
index 00000000000..90841aeec01
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityactiveserversessionremoved.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityActiveServerSessionRemoved | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f62789ea-d455-43f5-ab6c-21588184b528
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityActiveServerSessionRemoved
+System.ServiceModel.Security.SecurityActiveServerSessionRemoved  
+  
+## 説明  
+ アクティブなセキュリティ セッションはサーバー側で削除されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittenfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittenfailure.md
new file mode 100644
index 00000000000..089ecc07b62
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittenfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityAuditWrittenFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8740d0d-753a-490e-b1b8-dfa352ec25b5
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityAuditWrittenFailure
+System.ServiceModel.Security.SecurityAuditWrittenFailure  
+  
+## 説明  
+ セキュリティの監査ログへの書き込み時にエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittensuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittensuccess.md
new file mode 100644
index 00000000000..0c4ac61d2ee
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittensuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityAuditWrittenSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1a8bcf46-54ee-460c-ae7f-64bead28ff64
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityAuditWrittenSuccess
+System.ServiceModel.Security.SecurityAuditWrittenSuccess  
+  
+## 説明  
+ セキュリティ監査ログが正常に書き込まれました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingincomingmessageverified.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingincomingmessageverified.md
new file mode 100644
index 00000000000..d438b6a951b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingincomingmessageverified.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityBindingIncomingMessageVerified | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40fc744e-8d6f-49e0-a5fd-4f9a31cc0ed7
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityBindingIncomingMessageVerified
+System.ServiceModel.Security.SecurityBindingIncomingMessageVerified  
+  
+## 説明  
+ セキュリティ プロトコルは受信メッセージを確認しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingoutgoingmessagesecured.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingoutgoingmessagesecured.md
new file mode 100644
index 00000000000..061f6a68650
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingoutgoingmessagesecured.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityBindingOutgoingMessageSecured | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b6cd812-63ba-4614-89f1-3c31d7540c5d
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityBindingOutgoingMessageSecured
+System.ServiceModel.Security.SecurityBindingOutgoingMessageSecured  
+  
+## 説明  
+ セキュリティ プロトコルは送信メッセージをセキュリティで保護しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingsecureoutgoingmessagefailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingsecureoutgoingmessagefailure.md
new file mode 100644
index 00000000000..4b1a65d4632
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingsecureoutgoingmessagefailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityBindingSecureOutgoingMessageFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb46c07b-f824-43fd-892c-bca4f68a8866
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityBindingSecureOutgoingMessageFailure
+System.ServiceModel.Security.SecurityBindingSecureOutgoingMessageFailure  
+  
+## 説明  
+ セキュリティ プロトコルでは送信メッセージをセキュリティで保護することはできません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingverifyincomingmessagefailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingverifyincomingmessagefailure.md
new file mode 100644
index 00000000000..3b9763880a4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingverifyincomingmessagefailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityBindingVerifyIncomingMessageFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4447ad6-7f41-47ef-bdd1-8b4a908e156f
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityBindingVerifyIncomingMessageFailure
+System.ServiceModel.Security.SecurityBindingVerifyIncomingMessageFailure  
+  
+## 説明  
+ セキュリティ プロトコルにより受信メッセージを検証できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosemessagereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosemessagereceived.md
new file mode 100644
index 00000000000..fd2680afe3d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosemessagereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityClientSessionCloseMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2be97eac-798a-48bc-bba8-a8753a28aeb7
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityClientSessionCloseMessageReceived
+System.ServiceModel.Security.SecurityClientSessionCloseMessageReceived  
+  
+## 説明  
+ クライアントのセキュリティ セッションによって終了メッセージが受信されました。TraceCodeSecurityClientSessionKeyRenewed\=Clientセキュリティ セッションはセッション キーを更新しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessioncloseresponsesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessioncloseresponsesent.md
new file mode 100644
index 00000000000..49b968ac184
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessioncloseresponsesent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityClientSessionCloseResponseSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2912479-0012-4eba-b677-561f0a5e13cd
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityClientSessionCloseResponseSent
+System.ServiceModel.Security.SecurityClientSessionCloseResponseSent  
+  
+## 説明  
+ クライアントのセキュリティ セッションが終了応答メッセージを送信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosesent.md
new file mode 100644
index 00000000000..2e19cbd891d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosesent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityClientSessionCloseSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6933e77d-ac9b-47cc-bc07-95f957d2299f
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityClientSessionCloseSent
+System.ServiceModel.Security.SecurityClientSessionCloseSent  
+  
+## 説明  
+ クライアントのセキュリティ セッションが Close メッセージを送信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionkeyrenewed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionkeyrenewed.md
new file mode 100644
index 00000000000..d2e44c580c8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionkeyrenewed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityClientSessionKeyRenewed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c99048ee-062b-4b21-bb9b-77c465a318c6
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityClientSessionKeyRenewed
+System.ServiceModel.Security.SecurityClientSessionKeyRenewed  
+  
+## 説明  
+ クライアントのセキュリティ セッションはセッション キーを更新しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionpreviouskeydiscarded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionpreviouskeydiscarded.md
new file mode 100644
index 00000000000..3829bf137c8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionpreviouskeydiscarded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityClientSessionPreviousKeyDiscarded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 339f0e2a-452b-43eb-9f6d-f48ceb1414f3
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityClientSessionPreviousKeyDiscarded
+System.ServiceModel.Security.SecurityClientSessionPreviousKeyDiscarded  
+  
+## 説明  
+ クライアントのセキュリティ セッションは直前のセッション キーを破棄しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitycontexttokencachefull.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitycontexttokencachefull.md
new file mode 100644
index 00000000000..67a80b44e4c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitycontexttokencachefull.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityContextTokenCacheFull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 45e53edb-29ff-4729-a6c1-57ede0da1d00
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.SecurityContextTokenCacheFull
+System.ServiceModel.Security.SecurityContextTokenCacheFull  
+  
+## 説明  
+ セキュリティ コンテキスト トークン キャッシュがいっぱいです。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationfailure.md
new file mode 100644
index 00000000000..11b50dc1b33
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityIdentityDeterminationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bc5446e2-86f4-4d17-8ecc-4304b0fde7ec
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.SecurityIdentityDeterminationFailure
+System.ServiceModel.Security.SecurityIdentityDeterminationFailure  
+  
+## 説明  
+ EndpointAddress に対して ID を判別できませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationsuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationsuccess.md
new file mode 100644
index 00000000000..caabed686f2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationsuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityIdentityDeterminationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cee8df47-b568-44e3-aeff-e74618326093
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.SecurityIdentityDeterminationSuccess
+System.ServiceModel.Security.SecurityIdentityDeterminationSuccess  
+  
+## 説明  
+ ID は EndpointAddress で決定されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityhostnamenormalizationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityhostnamenormalizationfailure.md
new file mode 100644
index 00000000000..f1964842508
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityhostnamenormalizationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityIdentityHostNameNormalizationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ffe115e1-39de-4fc7-88f9-6cf55de29597
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityIdentityHostNameNormalizationFailure
+System.ServiceModel.Security.SecurityIdentityHostNameNormalizationFailure  
+  
+## 説明  
+ エンドポイント アドレスの HostName 部分は標準化できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationfailure.md
new file mode 100644
index 00000000000..4478faa7d9f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityIdentityVerificationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb5d6341-6ae3-45db-a4ab-f87cf3219db4
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityIdentityVerificationFailure
+System.ServiceModel.Security.SecurityIdentityVerificationFailure  
+  
+## 説明  
+ ID の検査が失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationsuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationsuccess.md
new file mode 100644
index 00000000000..2b458f990d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationsuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityIdentityVerificationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6744ac2f-4944-421d-9a17-bcc64f0f3d2f
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityIdentityVerificationSuccess
+System.ServiceModel.Security.SecurityIdentityVerificationSuccess  
+  
+## 説明  
+ ID の検査が成功しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationfailure.md
new file mode 100644
index 00000000000..99cd79cbd67
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityImpersonationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0e61834-72ac-4a58-af32-94e3206a9369
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityImpersonationFailure
+System.ServiceModel.Security.SecurityImpersonationFailure  
+  
+## 説明  
+ サーバー側でセキュリティの偽装が失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationsuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationsuccess.md
new file mode 100644
index 00000000000..a82e8feb997
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationsuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityImpersonationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e344c7a9-baae-4ffc-a851-85d2e8571d83
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityImpersonationSuccess
+System.ServiceModel.Security.SecurityImpersonationSuccess  
+  
+## 説明  
+ サーバー側でセキュリティの偽装が成功しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityinactivesessionfaulted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityinactivesessionfaulted.md
new file mode 100644
index 00000000000..1db1ac09175
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityinactivesessionfaulted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityInactiveSessionFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66016fd0-bdaf-48c9-9922-629c30b5fc54
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityInactiveSessionFaulted
+System.ServiceModel.Security.SecurityInactiveSessionFaulted  
+  
+## 説明  
+ アクティブでないセキュリティ セッションはサーバー側でエラーとなりました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynegotiationprocessingfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynegotiationprocessingfailure.md
new file mode 100644
index 00000000000..ee9c89e4763
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynegotiationprocessingfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityNegotiationProcessingFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 12185f75-c86b-4006-afd7-5be308647dcc
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.SecurityNegotiationProcessingFailure
+System.ServiceModel.Security.SecurityNegotiationProcessingFailure  
+  
+## 説明  
+ サービス セキュリティ ネゴシエーション処理が失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynewserversessionkeyissued.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynewserversessionkeyissued.md
new file mode 100644
index 00000000000..ebf90fc9bb9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynewserversessionkeyissued.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityNewServerSessionKeyIssued | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2fccc492-61ea-45a8-8f1b-be65dedc5e46
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityNewServerSessionKeyIssued
+System.ServiceModel.Security.SecurityNewServerSessionKeyIssued  
+  
+## 説明  
+ 新しいセキュリティのセッション キーがサーバーによって発行されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionactivated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionactivated.md
new file mode 100644
index 00000000000..a15dce92852
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionactivated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityPendingServerSessionActivated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8bdbb502-2c3b-457a-8240-5787b0f83322
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityPendingServerSessionActivated
+System.ServiceModel.Security.SecurityPendingServerSessionActivated  
+  
+## 説明  
+ 保留中のセキュリティ セッションがサーバーによりアクティブになりました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionadded.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionadded.md
new file mode 100644
index 00000000000..f3fd654a199
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionadded.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityPendingServerSessionAdded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15d15f57-1482-419b-b841-fff7318b69d8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityPendingServerSessionAdded
+System.ServiceModel.Security.SecurityPendingServerSessionAdded  
+  
+## 説明  
+ 保留中のセキュリティ セッションがサーバーに追加されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionclosed.md
new file mode 100644
index 00000000000..0534ad06a2b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityPendingServerSessionClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1fa7098b-1724-4524-ad91-be7592951f69
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityPendingServerSessionClosed
+System.ServiceModel.Security.SecurityPendingServerSessionClosed  
+  
+## 説明  
+ 保留中のセキュリティ セッションはサーバーによって閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionabortedfaultsent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionabortedfaultsent.md
new file mode 100644
index 00000000000..e94322df076
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionabortedfaultsent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityServerSessionAbortedFaultSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a27f4243-2b80-44da-bb79-674912395d93
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityServerSessionAbortedFaultSent
+System.ServiceModel.Security.SecurityServerSessionAbortedFaultSent  
+  
+## 説明  
+ サーバーのセキュリティ セッションは、セッション中止エラーをクライアントに送信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionclosereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionclosereceived.md
new file mode 100644
index 00000000000..44fe2ac47f1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionclosereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityServerSessionCloseReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1260f9e8-78d9-4ccf-9912-3189ff5951e0
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityServerSessionCloseReceived
+System.ServiceModel.Security.SecurityServerSessionCloseResponseReceived  
+  
+## 説明  
+ サーバーのセキュリティ セッションはクライアントから終了応答メッセージを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessioncloseresponsereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessioncloseresponsereceived.md
new file mode 100644
index 00000000000..2f96b02e500
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessioncloseresponsereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityServerSessionCloseResponseReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 899d663e-6a6d-49e9-9480-182b6860ae17
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityServerSessionCloseResponseReceived
+System.ServiceModel.Security.SecurityServerSessionCloseReceived  
+  
+## 説明  
+ サーバーのセキュリティ セッションでクライアントからの終了メッセージを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionkeyupdated.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionkeyupdated.md
new file mode 100644
index 00000000000..22c92678d5a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionkeyupdated.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityServerSessionKeyUpdated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2740a8e1-b775-464f-8ef4-6c44640285a0
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityServerSessionKeyUpdated
+System.ServiceModel.Security.SecurityServerSessionKeyUpdated  
+  
+## 説明  
+ セキュリティ セッション キーはサーバーによって更新されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionrenewalfaultsent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionrenewalfaultsent.md
new file mode 100644
index 00000000000..4d949f561cc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionrenewalfaultsent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityServerSessionRenewalFaultSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dc6379dd-a15d-4063-9939-a2edd08cfdcb
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityServerSessionRenewalFaultSent
+System.ServiceModel.Security.SecurityServerSessionRenewalFaultSent  
+  
+## 説明  
+ サーバーのセキュリティ セッションはクライアントにキーの更新エラーを送信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultreceived.md
new file mode 100644
index 00000000000..fe79df2148c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionAbortedFaultReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6c27cbf-30c0-4f8b-ad21-0e4e25e5fc7a
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionAbortedFaultReceived
+System.ServiceModel.Security.SecuritySessionAbortedFaultReceived  
+  
+## 説明  
+ クライアント セキュリティ セッションによって、サーバーからのセッション中止エラーが受信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultsendfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultsendfailure.md
new file mode 100644
index 00000000000..a6657c60af2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultsendfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionAbortedFaultSendFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7dc1a319-0978-46ed-b2ef-1de2317e7e2d
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# System.ServiceModel.Security.SecuritySessionAbortedFaultSendFailure
+System.ServiceModel.Security.SecuritySessionAbortedFaultSendFailure  
+  
+## 説明  
+ セキュリティ セッション中止エラーをクライアントに送信しているときにエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsereceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsereceived.md
new file mode 100644
index 00000000000..993c3d63134
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsereceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionClosedResponseReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aab624cb-30c6-4ac4-9dea-5ea03b5a4917
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionClosedResponseReceived
+System.ServiceModel.Security.SecuritySessionClosedResponseReceived  
+  
+## 説明  
+ クライアントのセキュリティ セッションはサーバーから "closed" 応答を受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsesendfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsesendfailure.md
new file mode 100644
index 00000000000..c5c13b60c92
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsesendfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionClosedResponseSendFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 214e88fe-0476-4604-bca6-1b2f25fe1194
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionClosedResponseSendFailure
+System.ServiceModel.Security.SecuritySessionClosedResponseSendFailure  
+  
+## 説明  
+ セキュリティ セッションの Close 応答をクライアントに送信中、エラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessioncloseresponsesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessioncloseresponsesent.md
new file mode 100644
index 00000000000..4addf481c4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessioncloseresponsesent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionCloseResponseSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 501defc3-d110-46ea-86d7-3563c35830f0
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionCloseResponseSent
+System.ServiceModel.Security.SecuritySessionCloseResponseSent  
+  
+## 説明  
+ サーバーのセキュリティ セッションでクライアントに終了応答が送信されました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessiondemuxfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessiondemuxfailure.md
new file mode 100644
index 00000000000..81067eb1276
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessiondemuxfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionDemuxFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74b89d9a-22be-4799-b9fb-e3dfa5426dec
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionDemuxFailure
+System.ServiceModel.Security.SecuritySessionDemuxFailure  
+  
+## 説明  
+ 受信メッセージは既存のセキュリティ セッションの一部ではありません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionkeyrenewalfaultreceived.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionkeyrenewalfaultreceived.md
new file mode 100644
index 00000000000..7e1a895881e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionkeyrenewalfaultreceived.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionKeyRenewalFaultReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 857542f7-adcb-4769-bf4e-a85b87e58dc8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionKeyRenewalFaultReceived
+System.ServiceModel.Security.SecuritySessionKeyRenewalFaultReceived  
+  
+## 説明  
+ クライアントのセキュリティ セッションはサーバーからキーの更新エラーを受信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionredirectapplied.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionredirectapplied.md
new file mode 100644
index 00000000000..8ebac7da927
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionredirectapplied.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionRedirectApplied | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b22736bc-61a3-47c7-8c13-e02e9f6848ef
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionRedirectApplied
+System.ServiceModel.Security.SecuritySessionRedirectApplied  
+  
+## 説明  
+ クライアントのセキュリティ セッションがリダイレクトされました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrenewfaultsendfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrenewfaultsendfailure.md
new file mode 100644
index 00000000000..faf1143f82e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrenewfaultsendfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionRenewFaultSendFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e29894f8-d514-45eb-9104-b813a5cab98c
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionRenewFaultSendFailure
+System.ServiceModel.Security.SecuritySessionRenewFaultSendFailure  
+  
+## 説明  
+ セキュリティ セッション キーの更新エラーをクライアントに送信中にエラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationfailure.md
new file mode 100644
index 00000000000..78466eca6bf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionRequestorOperationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c3ebb7b2-ed30-4e8c-99dc-b79d37a7e3fb
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionRequestorOperationFailure
+System.ServiceModel.Security.SecuritySessionRequestorOperationFailure  
+  
+## 説明  
+ クライアントのセキュリティ セッションの操作が失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationsuccess.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationsuccess.md
new file mode 100644
index 00000000000..bf369b27eee
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationsuccess.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionRequestorOperationSuccess | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33093589-731c-4ca0-8d79-cc4628794e62
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionRequestorOperationSuccess
+System.ServiceModel.Security.SecuritySessionRequestorOperationSuccess  
+  
+## 説明  
+ セキュリティ セッションの操作がクライアントで正常に完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionresponderoperationfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionresponderoperationfailure.md
new file mode 100644
index 00000000000..116fdb67cdc
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionresponderoperationfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionResponderOperationFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ab20767-dac5-49fc-8bff-108bb7b84c87
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionResponderOperationFailure
+System.ServiceModel.Security.SecuritySessionResponderOperationFailure  
+  
+## 説明  
+ セキュリティ セッションの操作がサーバーで失敗しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesendfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesendfailure.md
new file mode 100644
index 00000000000..b658a02e1d0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesendfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionServerCloseSendFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b848eeeb-07d6-4f2d-a14a-e62ee1968dfa
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionServerCloseSendFailure
+System.ServiceModel.Security.SecuritySessionServerCloseSendFailure  
+  
+## 説明  
+ セキュリティ セッションの Close をクライアントに送信中、エラーが発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesent.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesent.md
new file mode 100644
index 00000000000..902ab53888a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesent.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySessionServerCloseSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 712716fd-6c89-4dea-9398-d2c5b30f6563
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySessionServerCloseSent
+System.ServiceModel.Security.SecuritySessionServerCloseSent  
+  
+## 説明  
+ サーバーのセキュリティ セッションは、クライアントに Close を送信しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityspntosidmappingfailure.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityspntosidmappingfailure.md
new file mode 100644
index 00000000000..0c0dac5d328
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityspntosidmappingfailure.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecuritySpnToSidMappingFailure | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 45c658a9-7dcb-42a9-9bd0-e2a06a2a00b6
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecuritySpnToSidMappingFailure
+System.ServiceModel.Security.SecuritySpnToSidMappingFailure  
+  
+## 説明  
+ ServicePrincipalName を SecurityIdentifier にマップできませんでした。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatorclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatorclosed.md
new file mode 100644
index 00000000000..9def1b13568
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatorclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityTokenAuthenticatorClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a05b9c68-b83b-4526-b0ef-226f5991569e
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityTokenAuthenticatorClosed
+System.ServiceModel.Security.SecurityTokenAuthenticatorClosed  
+  
+## 説明  
+ セキュリティ トークン認証システムが閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatoropened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatoropened.md
new file mode 100644
index 00000000000..6480d5f90fe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatoropened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityTokenAuthenticatorOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6cb0065-b4f6-40eb-89ac-5e8f0e05e0de
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityTokenAuthenticatorOpened
+System.ServiceModel.Security.SecurityTokenAuthenticatorOpened  
+  
+## 説明  
+ セキュリティ トークンの認証システムを開きました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenproviderclosed.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenproviderclosed.md
new file mode 100644
index 00000000000..b52e5ebef7a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenproviderclosed.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityTokenProviderClosed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 978c76b9-a9c8-435f-847d-0503e78dde50
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityTokenProviderClosed
+System.ServiceModel.Security.SecurityTokenProviderClosed  
+  
+## 説明  
+ セキュリティ トークン プロバイダーが閉じられました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenprovideropened.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenprovideropened.md
new file mode 100644
index 00000000000..b59d4895425
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenprovideropened.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SecurityTokenProviderOpened | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8222922-35d9-4361-8bc0-d360164a9266
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SecurityTokenProviderOpened
+System.ServiceModel.Security.SecurityTokenProviderOpened  
+  
+## 説明  
+ セキュリティ トークン プロバイダーを開きました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-servicesecuritynegotiationcompleted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-servicesecuritynegotiationcompleted.md
new file mode 100644
index 00000000000..750b582b311
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-servicesecuritynegotiationcompleted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.ServiceSecurityNegotiationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c43d2d67-8b9b-4a2b-b0cd-ceab8ad38141
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.ServiceSecurityNegotiationCompleted
+System.ServiceModel.Security.ServiceSecurityNegotiationCompleted  
+  
+## 説明  
+ サービス セキュリティ ネゴシエーションが完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoclientnegotiationcompleted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoclientnegotiationcompleted.md
new file mode 100644
index 00000000000..17c3e3c4db9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoclientnegotiationcompleted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SpnegoClientNegotiationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e80b1390-bb37-46aa-ab91-4ed187b2e09d
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SpnegoClientNegotiationCompleted
+System.ServiceModel.Security.SpnegoClientNegotiationCompleted  
+  
+## 説明  
+ SpnegoTokenProvider は SSPI ネゴシエーションを完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoservicenegotiationcompleted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoservicenegotiationcompleted.md
new file mode 100644
index 00000000000..c5659466251
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoservicenegotiationcompleted.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.Security.SpnegoServiceNegotiationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 840c7537-81df-4bb6-affb-c6c9036453d0
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# System.ServiceModel.Security.SpnegoServiceNegotiationCompleted
+System.ServiceModel.Security.SpnegoServiceNegotiationCompleted  
+  
+## 説明  
+ SpnegoTokenAuthenticator が SSPI のネゴシエーションを完了しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicechannellifetime.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicechannellifetime.md
new file mode 100644
index 00000000000..daded97867c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicechannellifetime.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceChannelLifetime | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1da8b8d0-7c5b-40bb-b177-29bbd67245e0
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ServiceChannelLifetime
+System.ServiceModel.ServiceChannelLifetime  
+  
+## 説明  
+ サービス チャネルについての情報です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostbaseaddresses.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostbaseaddresses.md
new file mode 100644
index 00000000000..32ff64af1e1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostbaseaddresses.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceHostBaseAddresses | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a36b8d38-8719-4d51-923a-420ec6c009e7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ServiceHostBaseAddresses
+System.ServiceModel.ServiceHostBaseAddresses  
+  
+## 説明  
+ サービスによって登録されたすべてのベース アドレスを表示できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostcreation.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostcreation.md
new file mode 100644
index 00000000000..be401f6eefe
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostcreation.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceHostCreation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b9cb4f7-48bb-4e89-b5c2-d2d22e0e8088
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.ServiceHostCreation
+System.ServiceModel.ServiceHostCreation  
+  
+## 説明  
+ ServiceHost を作成します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosterroronreleaseperformancecounter.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosterroronreleaseperformancecounter.md
new file mode 100644
index 00000000000..98c207756ef
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosterroronreleaseperformancecounter.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceHostErrorOnReleasePerformanceCounter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a83a2c6-f86b-4dbe-8882-2984a3c38fc3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ServiceHostErrorOnReleasePerformanceCounter
+System.ServiceModel.ServiceHostErrorOnReleasePerformanceCounter  
+  
+## 説明  
+ ReleasePerformanceCounter の呼び出し時に ServiceHost エラーが発生しました。パフォーマンス カウンターを解放するときに、このトレースを使用してエラーを確認できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostfaulted.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostfaulted.md
new file mode 100644
index 00000000000..c18c2e023a6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostfaulted.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.ServiceHostFaulted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58cf2adc-a6ef-46d8-8e73-e127287b42a2
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ServiceHostFaulted
+System.ServiceModel.ServiceHostFaulted  
+  
+## 説明  
+ ServiceHost は途中終了しました。  
+  
+ このトレースは、リスナーのいずれかでエラーが発生したことを示します。このトレースは、デバッグで役立ちます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosttimeoutonclose.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosttimeoutonclose.md
new file mode 100644
index 00000000000..ef5f02c10fa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosttimeoutonclose.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceHostTimeoutOnClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89f360d2-5bed-4677-ab55-26d9bd12695a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ServiceHostTimeoutOnClose
+System.ServiceModel.ServiceHostTimeoutOnClose  
+  
+## 説明  
+ ServiceHost を閉じる操作はタイムアウトしました。これは、クライアントによっていくつかのセッション チャネルが適切にシャットダウンされず、中止された可能性があることを示します。既定の時間を変更してタイムアウトの終了を調整してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationexceptiononreply.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationexceptiononreply.md
new file mode 100644
index 00000000000..e627f969013
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationexceptiononreply.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.ServiceOperationExceptionOnReply | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b68bba58-495a-4b13-bc4f-b663136f3c44
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.ServiceOperationExceptionOnReply
+System.ServiceModel.ServiceOperationExceptionOnReply  
+  
+## 説明  
+ 要求\/応答操作への応答が生じると例外をスローします。  このトレースは開発中のデバッグに役立ちます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreply.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreply.md
new file mode 100644
index 00000000000..678d8414bec
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreply.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.ServiceOperationMissingReply | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 734d1cac-9f9c-472c-bcf7-bed23454c82c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.ServiceOperationMissingReply
+System.ServiceModel.ServiceOperationMissingReply  
+  
+## 説明  
+ この要求\/応答操作には応答メッセージがありません。  
+  
+ これは双方向の操作ですが、クライアントに送信する応答がありません。このトレースは開発時のデバッグに使用できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreplycontext.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreplycontext.md
new file mode 100644
index 00000000000..51c2cd97959
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreplycontext.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.ServiceOperationMissingReplyContext | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1373c661-e63a-4e11-a635-689451450274
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.ServiceOperationMissingReplyContext
+System.ServiceModel.ServiceOperationMissingReplyContext  
+  
+## 説明  
+ ReplyContext は、双方向の操作に対して NULL です。トレース データによって「応答操作には、応答に使用する IReplyContext が含まれていません。」というメッセージが表示されます。  
+  
+ このトレースは開発中のデバッグに役立ちます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicethrottlelimitreached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicethrottlelimitreached.md
new file mode 100644
index 00000000000..41f037cef6c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicethrottlelimitreached.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.ServiceThrottleLimitReached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f554a370-c3f8-4131-8639-7c36f926fbf9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.ServiceThrottleLimitReached
+System.ServiceModel.ServiceThrottleLimitReached  
+  
+## 説明  
+ MaxConcurrentCalls\/MaxConcurrentInstances\/MaxConcurrentSessions スロットルのいずれかに達したため、メッセージはキューに格納されます。  
+  
+ このトレースを使用し、運用負荷の予想値と実績値に基づいてスロットル値を調整できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-skipbehavior.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-skipbehavior.md
new file mode 100644
index 00000000000..3f1f7027593
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-skipbehavior.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.SkipBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dd18b390-0624-4a38-aad3-802e8a07f6ce
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.SkipBehavior
+System.ServiceModel.SkipBehavior  
+  
+## 説明  
+ 動作の型が予期される型ではありません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-transportlisten.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-transportlisten.md
new file mode 100644
index 00000000000..2396539f3c5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-transportlisten.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TransportListen | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5e6438c-6562-42f2-8a3b-2bdecf9dc4af
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.TransportListen
+System.ServiceModel.TransportListen  
+  
+## 説明  
+ 指定したアドレスでリッスンします。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txasyncabort.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txasyncabort.md
new file mode 100644
index 00000000000..ac5762c69d8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txasyncabort.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.TxAsyncAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bce47ff2-abd0-4b58-8667-ebf1ef3580b8
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.TxAsyncAbort
+指定したトランザクションが非同期に中止されました。  
+  
+## 説明  
+ 別の参加要素による中止、タイムアウト、またはトランザクションの参加要素内での別のエラーが発生したため、現在のトランザクションが中止されました。  
+  
+## トラブルシューティング  
+ これが予期された中止であるかどうかをすべてのシステム ログで確認し、中止の原因を特定してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusabortedonsessionclose.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusabortedonsessionclose.md
new file mode 100644
index 00000000000..154ddde6603
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusabortedonsessionclose.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.TxCompletionStatusAbortedOnSessionClose | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e142e9d-e81b-4309-974a-02e9cc064ea0
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusAbortedOnSessionClose
+指定されたトランザクションは、セッションが終了したときにまだ完了しておらず、TransactionAutoCompleteOnSessionClose OperationBehaviorAttribute が false に設定されているため、中止されました。  
+  
+## 説明  
+ 現在のアクティブなセッションが終了した時点でトランザクションが完了しておらず、TransactionAutoCompleteOnSessionClose が `false` に設定されている場合にトレースされます。  
+  
+## トラブルシューティング  
+ このトレースは、アプリケーションに調査が必要なバグが含まれている可能性があることを示します。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforasyncabort.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforasyncabort.md
new file mode 100644
index 00000000000..855459002a6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforasyncabort.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.TxCompletionStatusCompletedForAsyncAbort | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 155c3203-2e17-4709-b896-2254e22da45e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.TxCompletionStatusCompletedForAsyncAbort
+非同期中止が実行されたため、指定された操作の指定のトランザクションは完了されました。  
+  
+## 説明  
+ 別の参加要素による中止、タイムアウト、またはトランザクションの参加要素内部の別のエラーが発生したため、現在のトランザクションが中止されました。  
+  
+## トラブルシューティング  
+ 予期された中止ではない場合は、すべてのシステム ログを調べて中止の原因を確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforautocomplete.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforautocomplete.md
new file mode 100644
index 00000000000..e66ea6bb9eb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforautocomplete.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxCompletionStatusCompletedForAutocomplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79ec2a3f-8407-4c4c-a1bc-2b0e6e21c543
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusCompletedForAutocomplete
+`OperationBehaviorAttribute.TransactionAutoComplete` メンバーが `true` に設定されたため、指定された操作の指定されたトランザクションが完了しました。  
+  
+## 説明  
+ ユーザーに代わって、インフラストラクチャによってトランザクションが自動的に完了したときにトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforerror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforerror.md
new file mode 100644
index 00000000000..c7da14d61f3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforerror.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.TxCompletionStatusCompletedForError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ade4722-a6d5-471c-b960-1cfea4ea2aa9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusCompletedForError
+処理されない実行例外が発生したため、指定された操作の指定されたトランザクションが完了しました。  
+  
+## 説明  
+ 現在のトランザクションを完了しようとしているときにエラーが発生した場合にトレースされます。これは、応答またはエラーが呼び出し元に送信される前に発生します。  
+  
+## トラブルシューティング  
+ トレース メッセージを調べて、例外メッセージとアクション可能な項目を確認してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforsetcomplete.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforsetcomplete.md
new file mode 100644
index 00000000000..87b0ad32367
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforsetcomplete.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxCompletionStatusCompletedForSetComplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 201ffd59-df9e-40d9-9697-7de442ab8b35
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusCompletedForSetComplete
+SetTransactionComplete が呼び出されたため、指定された操作の指定のトランザクションは完了されました。  
+  
+## 説明  
+ OperationContext によって現在のトランザクションを完了することをユーザーが明示的に指定した場合にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedfortacosc.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedfortacosc.md
new file mode 100644
index 00000000000..48ee46596e0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedfortacosc.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxCompletionStatusCompletedForTACOSC | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 089b982d-63a1-4ef2-8ef2-ad83758c9ec4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusCompletedForTACOSC
+そのトランザクションは、セッションが終了した際に完了になりました。  
+  
+## 説明  
+ 現在のアクティブなセッションが終了して、`TransactionAutoCompleteOnSessionClose` が `true` に設定されると、トレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusremainsattached.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusremainsattached.md
new file mode 100644
index 00000000000..7ddb394b818
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusremainsattached.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxCompletionStatusRemainsAttached | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 60a745f5-85f7-4006-9786-fbbcca678ac9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxCompletionStatusRemainsAttached
+指定された操作の指定されたトランザクションは、InstanceContext に添付されたままになっています。  
+  
+## 説明  
+ ServiceOperation が完了したのにトランザクションが完了しない場合にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txfailedtonegotiateoletx.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txfailedtonegotiateoletx.md
new file mode 100644
index 00000000000..e7812825473
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txfailedtonegotiateoletx.md
@@ -0,0 +1,31 @@
+---
+title: "System.ServiceModel.TxFailedToNegotiateOleTx | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f0f0b4b-a1ad-4704-8329-455daf54892d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.ServiceModel.TxFailedToNegotiateOleTx
+指定されたコーディネーション コンテキストのための OleTransactions プロトコル ネゴシエーションに失敗しました。  
+  
+## 説明  
+ OleTx 情報が添付された受信トランザクションがその OleTx 情報を使用できず、代わりに WS\-AT 使用した場合にトレースされます。  
+  
+## トラブルシューティング  
+ コンピューター間の MSDTC RPC 通信に潜在的な問題があることを示しています。これらのトレースが多数ログに記録されている場合は、大幅なパフォーマンス低下が発生している可能性があります。OleTx が必要ない場合は、WS\-AT のレジストリ構成で `OleTxUpgradeEnabled` を 0 に設定してください。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txreleaseserviceinstanceoncompletion.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txreleaseserviceinstanceoncompletion.md
new file mode 100644
index 00000000000..f17b610ff46
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txreleaseserviceinstanceoncompletion.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxReleaseServiceInstanceOnCompletion | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e167bad3-861f-43e4-9e78-9c275cf64a29
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.TxReleaseServiceInstanceOnCompletion
+ReleaseServiceInstanceOnTransactionComplete の ServiceBehaviorAttribute が true に設定されていたので、トランザクション '{0}' の完了時にサービス インスタンスが解放されました。  
+  
+## 説明  
+ 現在のアクティブなトランザクションが完了して現在のサービス インスタンスが解放されるか破棄され、ReleaseServiceInstanceOnTransactionComplete が `true` に設定されると、トレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredisattachedtransaction.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredisattachedtransaction.md
new file mode 100644
index 00000000000..6289354b965
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredisattachedtransaction.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxSourceTxScopeRequiredIsAttachedTransaction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40d7b227-ee00-4b2c-a04c-1cd28b103f94
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxSourceTxScopeRequiredIsAttachedTransaction
+指定したトランザクションは、指定した操作のために InstanceContext トランザクションから受信されました。  
+  
+## 説明  
+ ユーザー コードから利用できるトランザクションが、この呼び出しの前に呼び出された AutoComplete\=false メソッドによって残っていた場合にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactedtransport.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactedtransport.md
new file mode 100644
index 00000000000..3b37fbd6c4e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactedtransport.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxSourceTxScopeRequiredIsTransactedTransport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6cf60298-dccf-4587-b92c-ae3edb75c331
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxSourceTxScopeRequiredIsTransactedTransport
+指定されたトランザクションは、MSMQ などのトランザクション処理されたトランスポートから、指定された操作のために受信されました。  
+  
+## 説明  
+ ユーザー コードから利用できるトランザクションがトランスポート自体よって作成された場合にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactionflow.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactionflow.md
new file mode 100644
index 00000000000..88dd9d66ea4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactionflow.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.TxSourceTxScopeRequiredIsTransactionFlow | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41a3a5d7-bb16-4d16-bb51-db7ac0cfb748
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# System.ServiceModel.TxSourceTxScopeRequiredIsTransactionFlow
+指定したトランザクションが指定した操作にフローされました。  
+  
+## 説明  
+ ユーザー コードから利用できるトランザクションが外部ソースからフローされた場合にトレースされます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-understoodmessageheader.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-understoodmessageheader.md
new file mode 100644
index 00000000000..02daff64304
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-understoodmessageheader.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.UnderstoodMessageHeader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a8560bf-d13b-452d-bfb5-a5221cb191bd
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.UnderstoodMessageHeader
+System.ServiceModel.UnderstoodMessageHeader  
+  
+## 説明  
+ 認識されたメッセージ ヘッダー。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledaction.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledaction.md
new file mode 100644
index 00000000000..2daa604d727
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledaction.md
@@ -0,0 +1,30 @@
+---
+title: "System.ServiceModel.UnhandledAction | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a704fb1d-6cf8-4fd1-9aee-e70d7055c812
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.UnhandledAction
+System.ServiceModel.UnhandledAction  
+  
+## 説明  
+ この動作の処理に利用できるサービスがありません。  
+  
+ パフォーマンス カウンターのすべてのトレースは、パフォーマンス カウンター関連の問題のデバッグに使用できます。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledexceptioninuseroperation.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledexceptioninuseroperation.md
new file mode 100644
index 00000000000..6359b8afd93
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledexceptioninuseroperation.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.UnhandledExceptionInUserOperation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b00612e4-84c7-4a53-849a-e693cdce7fca
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# System.ServiceModel.UnhandledExceptionInUserOperation
+System.ServiceModel.UnhandledExceptionInUserOperation  
+  
+## 説明  
+ ユーザー操作の未処理の例外です。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-warnhelppageenablednobaseaddress.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-warnhelppageenablednobaseaddress.md
new file mode 100644
index 00000000000..5ae5128770c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-warnhelppageenablednobaseaddress.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.WarnHelpPageEnabledNoBaseAddress | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1a0f22f1-1b08-4b10-ac08-b109209eda8b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.WarnHelpPageEnabledNoBaseAddress
+System.ServiceModel.WarnHelpPageEnabledNoBaseAddress  
+  
+## 説明  
+ ServiceDebugBehavior ヘルプ ページは相対アドレスで有効になっていますが、ベース アドレスがないため作成できません。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlexporterror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlexporterror.md
new file mode 100644
index 00000000000..957083bb48e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlexporterror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.WsmexNonCriticalWsdlExportError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb0e7ab9-2918-49d8-8aee-bb186f457658
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.WsmexNonCriticalWsdlExportError
+System.ServiceModel.WsmexNonCriticalWsdlExportError  
+  
+## 説明  
+ WSDL のエクスポート中に、致命的でないエラーまたは警告が発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlimporterror.md b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlimporterror.md
new file mode 100644
index 00000000000..67a7354d616
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlimporterror.md
@@ -0,0 +1,28 @@
+---
+title: "System.ServiceModel.WsmexNonCriticalWsdlImportError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d6535153-b160-4584-8d5d-1186423a0bc3
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# System.ServiceModel.WsmexNonCriticalWsdlImportError
+System.ServiceModel.WsmexNonCriticalWsdlImportError  
+  
+## 説明  
+ WSDL のインポート中に、致命的でないエラーまたは警告が発生しました。  
+  
+## 参照  
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [トレースを使用したアプリケーションのトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)   
+ [管理と診断](../../../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/trace-type-summary.md b/docs/framework/wcf/diagnostics/tracing/trace-type-summary.md
new file mode 100644
index 00000000000..f9551a78b26
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/trace-type-summary.md
@@ -0,0 +1,65 @@
+---
+title: "トレースの種類の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e639410b-d1d1-479c-b78e-a4701d4e4085
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# トレースの種類の概要
+「[SourceLevels](http://go.microsoft.com/fwlink/?LinkID=94943)」には、Critical、Error、Warning、Information、および Verbose の各トレース レベルの定義に加えて、`ActivityTracing` フラグの説明が記載されています。これは、トレースの境界とアクティビティ転送イベントの出力を切り替えるためのフラグです。  
+  
+ また、「[TraceEventType](http://go.microsoft.com/fwlink/?LinkId=95169)」には、<xref:System.Diagnostics> から出力できるトレースの種類が記載されています。  
+  
+ 最も重要な種類を次の表に示します。  
+  
+|トレースの種類|説明|  
+|-------------|--------|  
+|Critical|致命的なエラーまたはアプリケーションのクラッシュ。|  
+|Error|回復可能なエラー。|  
+|警告|情報メッセージ。|  
+|情報|重大ではない問題。|  
+|詳細|トレースのデバッグ。|  
+|\[開始\]|処理の論理単位の開始。|  
+|Suspend|処理の論理単位の中断。|  
+|Resume|処理の論理単位の再開。|  
+|Stop|処理の論理単位の停止。|  
+|転送|相関 ID の変更。|  
+  
+ アクティビティは、上記のトレースの種類の組み合わせとして定義されます。  
+  
+ ローカル \(トレース ソース\) スコープでの典型的なアクティビティを定義する正規表現は次のとおりです。  
+  
+ `R = Start (Critical | Error | Warning | Information | Verbose | Transfer | (Transfer Suspend Transfer Resume) )* Stop`  
+  
+ これは、アクティビティが次の条件を満たす必要があることを意味します。  
+  
+-   アクティビティは、Start トレースによって開始し、Stop トレースによって停止する必要があります。  
+  
+-   Suspend トレースまたは Resume トレースの直前に Transfer トレースが必要です。  
+  
+-   Suspend トレースと Resume トレースが存在する場合、これらのトレースの間にトレースが存在することはできません。  
+  
+-   上記の条件を満たしている限り、Critical\/Error\/Warning\/Information\/Verbose\/Transfer の各トレースはいくつでも含めることができます。  
+  
+ グローバル スコープでの典型的なアクティビティを定義する正規表現は次のとおりです。  
+  
+```  
+R+   
+```  
+  
+ R はローカル スコープのアクティビティを表す正規表現です。  これは、次のようになります。  
+  
+```  
+[R+ = Start ( Critical | Error | Warning | Information | Verbose | Transfer | (Transfer Suspend Transfer Resume) )* Stop]+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/traces-reference.md b/docs/framework/wcf/diagnostics/tracing/traces-reference.md
new file mode 100644
index 00000000000..47b629b1523
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/traces-reference.md
@@ -0,0 +1,843 @@
+---
+title: "トレースの参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd960851-162d-4dcc-8c0c-0ec8f455d56d
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# トレースの参照
+ここでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] で生成されるトレースをすべて示します。  
+  
+## このセクションの内容  
+ `Administration`  
+  
+ [System.ServiceModel.Administration.WmiPut](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-administration-wmiput.md)  
+  
+ `Diagnostics`  
+  
+ [System.ServiceModel.Diagnostics.AppDomainUnload](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-appdomainunload.md)  
+  
+ [System.ServiceModel.Diagnostics.EventLog](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-eventlog.md)  
+  
+ [System.ServiceModel.Diagnostics.ThrowingException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-throwingexception.md)  
+  
+ [System.ServiceModel.Diagnostics.TraceHandledException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracehandledexception.md)  
+  
+ [System.ServiceModel.Diagnostics.UnhandledException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-unhandledexception.md)  
+  
+ [System.ServiceModel.Diagnostics.FailedToAddAnActivityIdHeader](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoaddanactivityidheader.md)  
+  
+ [System.ServiceModel.Diagnostics.FailedToReadAnActivityIdHeader](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-failedtoreadanactivityidheader.md)  
+  
+ [System.ServiceModel.Diagnostics.FilterNotMatchedNodeQuotaExceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-filternotmatchednodequotaexceeded.md)  
+  
+ [System.ServiceModel.Diagnostics.MessageCountLimitExceeded](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorresponseinvalidmetadata.md)  
+  
+ [System.ServiceModel.Diagnostics.DiagnosticsFailedMessageTrace](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-diagnosticsfailedmessagetrace.md)  
+  
+ [System.ServiceModel.Diagnostics.MessageNotLoggedQuotaExceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-messagenotloggedquotaexceeded.md)  
+  
+ [System.ServiceModel.Diagnostics.TraceTruncatedQuotaExceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-tracetruncatedquotaexceeded.md)  
+  
+ [System.ServiceModel.Diagnostics.ActivityBoundary](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-diagnostics-activityboundary.md)  
+  
+ `Serialization`  
+  
+ [System.Runtime.Serialization.WriteObjectBegin](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectbegin.md)  
+  
+ [System.Runtime.Serialization.WriteObjectEnd](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectend.md)  
+  
+ [System.Runtime.Serialization.WriteObjectContentBegin](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentbegin.md)  
+  
+ [System.Runtime.Serialization.WriteObjectContentEnd](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-writeobjectcontentend.md)  
+  
+ [System.Runtime.Serialization.ReadObjectBegin](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-readobjectbegin.md)  
+  
+ [System.Runtime.Serialization.ReadObjectEnd](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexmonikermetadataexchangecomplete.md)  
+  
+ [System.Runtime.Serialization.ElementIgnored](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-elementignored.md)  
+  
+ [System.Runtime.Serialization.XsdExportBegin](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportbegin.md)  
+  
+ [System.Runtime.Serialization.XsdExportEnd](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportend.md)  
+  
+ [System.Runtime.Serialization.XsdImportBegin](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportbegin.md)  
+  
+ [System.Runtime.Serialization.XsdImportEnd](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportend.md)  
+  
+ [System.Runtime.Serialization.XsdExportError](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexporterror.md)  
+  
+ [System.Runtime.Serialization.XsdImportError](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimporterror.md)  
+  
+ [System.Runtime.Serialization.XsdExportAnnotationFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportannotationfailed.md)  
+  
+ [System.Runtime.Serialization.XsdImportAnnotationFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdimportannotationfailed.md)  
+  
+ [System.Runtime.Serialization.XsdExportDupItems](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-xsdexportdupitems.md)  
+  
+ [System.Runtime.Serialization.FactoryTypeNotFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-factorytypenotfound.md)  
+  
+ [System.Runtime.Serialization.ObjectWithLargeDepth](../../../../../docs/framework/wcf/diagnostics/tracing/system-runtime-serialization-objectwithlargedepth.md)  
+  
+ `Channels`  
+  
+ [System.ServiceModel.Channels.ConnectionAbandoned](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionabandoned.md)  
+  
+ [System.ServiceModel.Channels.ConnectionPoolCloseException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolcloseexception.md)  
+  
+ [System.ServiceModel.Channels.ConnectionPoolIdleTimeoutReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolidletimeoutreached.md)  
+  
+ [System.ServiceModel.Channels.ConnectionPoolLeaseTimeoutReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolleasetimeoutreached.md)  
+  
+ [System.ServiceModel.Channels.ConnectionPoolMaxOutboundConnectionsPerEndpointQuotaReached](../../../../../docs/framework/wcf/diagnostics/tracing/connectionpoolmaxoutboundconnectionsperendpointquotareached.md)  
+  
+ [System.ServiceModel.Channels.ServerMaxPooledConnectionsQuotaReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-servermaxpooledconnectionsquotareached.md)  
+  
+ [System.ServiceModel.Channels.EndpointListenerClose](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlistenerclose.md)  
+  
+ [System.ServiceModel.Channels.EndpointListenerOpen](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-endpointlisteneropen.md)  
+  
+ [System.ServiceModel.Channels.HttpResponseReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpresponsereceived.md)  
+  
+ [System.ServiceModel.Channels.HttpChannelConcurrentReceiveQuotaReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelconcurrentreceivequotareached.md)  
+  
+ [System.ServiceModel.Channels.HttpChannelMessageReceiveFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelmessagereceivefailed.md)  
+  
+ [System.ServiceModel.Channels.HttpChannelUnexpectedResponse](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelunexpectedresponse.md)  
+  
+ [System.ServiceModel.Channels.HttpChannelRequestAborted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelrequestaborted.md)  
+  
+ [System.ServiceModel.Channels.HttpChannelResponseAborted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpchannelresponseaborted.md)  
+  
+ [System.ServiceModel.Channels.HttpsClientCertificateInvalid](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificateinvalid.md)  
+  
+ [System.ServiceModel.Channels.HttpsClientCertificateNotPresent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpsclientcertificatenotpresent.md)  
+  
+ [System.ServiceModel.Channels.NamedPipeChannelMessageReceiveFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceivefailed.md)  
+  
+ [System.ServiceModel.Channels.NamedPipeChannelMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-namedpipechannelmessagereceived.md)  
+  
+ [System.ServiceModel.Channels.MessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagereceived.md)  
+  
+ [System.ServiceModel.Channels.MessageSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-messagesent.md)  
+  
+ [System.ServiceModel.Channels.RequestChannelReplyReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestchannelreplyreceived.md)  
+  
+ [System.ServiceModel.Channels.TcpChannelMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpchannelmessagereceived.md)  
+  
+ [System.ServiceModel.Channels.ConnectToIPEndpoint](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connecttoipendpoint.md)  
+  
+ [System.ServiceModel.Channels.SocketConnectionCreate](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectioncreate.md)  
+  
+ [System.ServiceModel.Channels.SocketConnectionClose](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionclose.md)  
+  
+ [System.ServiceModel.Channels.SocketConnectionAbort](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabort.md)  
+  
+ [System.ServiceModel.Channels.SocketConnectionAbortClose](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-socketconnectionabortclose.md)  
+  
+ [System.ServiceModel.Channels.PipeConnectionAbort](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pipeconnectionabort.md)  
+  
+ [System.ServiceModel.Channels.RequestContextAbort](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-requestcontextabort.md)  
+  
+ [System.ServiceModel.Channels.ChannelCreated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channelcreated.md)  
+  
+ [System.ServiceModel.Channels.ChannelDisposed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-channeldisposed.md)  
+  
+ [System.ServiceModel.Channels.ListenerCreated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenercreated.md)  
+  
+ [System.ServiceModel.Channels.ListenerDisposed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-listenerdisposed.md)  
+  
+ [System.ServiceModel.Channels.PrematureDatagramEof](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-prematuredatagrameof.md)  
+  
+ [System.ServiceModel.Channels.MaxPendingConnectionsReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxpendingconnectionsreached.md)  
+  
+ [System.ServiceModel.Channels.MaxAcceptedChannelsReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-maxacceptedchannelsreached.md)  
+  
+ [System.ServiceModel.Channels.HttpAuthFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-httpauthfailed.md)  
+  
+ [System.ServiceModel.Channels.NoExistingTransportManager](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-noexistingtransportmanager.md)  
+  
+ [System.ServiceModel.Channels.IncompatibleExistingTransportManager](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-incompatibleexistingtransportmanager.md)  
+  
+ [System.ServiceModel.Channels.InitiatingNamedPipeConnection](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingnamedpipeconnection.md)  
+  
+ [System.ServiceModel.Channels.InitiatingTcpConnection](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-initiatingtcpconnection.md)  
+  
+ [System.ServiceModel.Channels.OpenedListener](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-openedlistener.md)  
+  
+ [System.ServiceModel.Channels.SslClientCertMissing](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-sslclientcertmissing.md)  
+  
+ [System.ServiceModel.Channels.StreamSecurityUpgradeAccepted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-streamsecurityupgradeaccepted.md)  
+  
+ [System.ServiceModel.Channels.TcpConnectError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-tcpconnecterror.md)  
+  
+ [System.ServiceModel.Channels.FailedAcceptFromPool](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedacceptfrompool.md)  
+  
+ [System.ServiceModel.Channels.FailedPipeConnect](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-failedpipeconnect.md)  
+  
+ [System.ServiceModel.Channels.SystemTimeResolution](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-systemtimeresolution.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborNotAccepted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotaccepted.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborNotFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbornotfound.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborStateChanged](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechanged.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborStateChangeFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighborstatechangefailed.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormessagereceived.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborManagerOffline](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageroffline.md)  
+  
+ [System.ServiceModel.Channels.PeerNeighborManagerOnline](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerneighbormanageronline.md)  
+  
+ [System.ServiceModel.Channels.PeerChannelMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagereceived.md)  
+  
+ [System.ServiceModel.Channels.PeerChannelMessageSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerchannelmessagesent.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeAddressChanged](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeaddresschanged.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeOpening](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopening.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopened.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeOpenFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeopenfailed.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeClosing](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosing.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeclosed.md)  
+  
+ [System.ServiceModel.Channels.PeerFloodedMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagereceived.md)  
+  
+ [System.ServiceModel.Channels.PeerFloodedMessageNotPropagated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotpropagated.md)  
+  
+ [System.ServiceModel.Channels.PeerFloodedMessageNotMatched](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerfloodedmessagenotmatched.md)  
+  
+ [System.ServiceModel.Channels.PnrpRegisteredAddresses](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpregisteredaddresses.md)  
+  
+ [System.ServiceModel.Channels.PnrpUnregisteredAddresses](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpunregisteredaddresses.md)  
+  
+ [System.ServiceModel.Channels.PnrpResolvedAddresses](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolvedaddresses.md)  
+  
+ [System.ServiceModel.Channels.PnrpResolveException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-pnrpresolveexception.md)  
+  
+ [System.ServiceModel.Channels.PeerReceiveMessageAuthenticationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerreceivemessageauthenticationfailure.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeAuthenticationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationfailure.md)  
+  
+ [System.ServiceModel.Channels.PeerNodeAuthenticationTimeout](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peernodeauthenticationtimeout.md)  
+  
+ [System.ServiceModel.Channels.PeerFlooderReceiveMessageQuotaExceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerflooderreceivemessagequotaexceeded.md)  
+  
+ [System.ServiceModel.Channels.PeerServiceOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peerserviceopened.md)  
+  
+ [System.ServiceModel.Channels.PeerMaintainerActivity](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-peermaintaineractivity.md)  
+  
+ [System.ServiceModel.Channels.MsmqCannotPeekOnQueue](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotpeekonqueue.md)  
+  
+ [System.ServiceModel.Channels.MsmqCannotReadQueues](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqcannotreadqueues.md)  
+  
+ [System.ServiceModel.Channels.MsmqDatagramSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramsent.md)  
+  
+ [System.ServiceModel.Channels.MsmqDatagramReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdatagramreceived.md)  
+  
+ [System.ServiceModel.Channels.MsmqDetected](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqdetected.md)  
+  
+ [System.ServiceModel.Channels.MsmqEnteredBatch](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqenteredbatch.md)  
+  
+ [System.ServiceModel.Channels.MsmqFoundBaseAddress](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqfoundbaseaddress.md)  
+  
+ [System.ServiceModel.Channels.MsmqLeftBatch](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqleftbatch.md)  
+  
+ [System.ServiceModel.Channels.MsmqMatchedApplicationFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmatchedapplicationfound.md)  
+  
+ [System.ServiceModel.Channels.MsmqMessageDropped](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagedropped.md)  
+  
+ [System.ServiceModel.Channels.MsmqMessageLockedUnderTheTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagelockedunderthetransaction.md)  
+  
+ [System.ServiceModel.Channels.MsmqMessageRejected](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqmessagerejected.md)  
+  
+ [System.ServiceModel.Channels.MsmqMoveOrDeleteAttemptFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehostcreatedserviceendpoint.md)  
+  
+ [System.ServiceModel.Channels.MsmqPoisonMessageMovedPoison](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedpoison.md)  
+  
+ [System.ServiceModel.Channels.MsmqPoisonMessageMovedRetry](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagemovedretry.md)  
+  
+ [System.ServiceModel.Channels.MsmqPoisonMessageRejected](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoisonmessagerejected.md)  
+  
+ [System.ServiceModel.Channels.MsmqPoolFull](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpoolfull.md)  
+  
+ [System.ServiceModel.Channels.MsmqPotentiallyPoisonMessageDetected](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqpotentiallypoisonmessagedetected.md)  
+  
+ [System.ServiceModel.Channels.MsmqQueueClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueclosed.md)  
+  
+ [System.ServiceModel.Channels.MsmqQueueOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueueopened.md)  
+  
+ [System.ServiceModel.Channels.MsmqQueueTransactionalStatusUnknown](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqqueuetransactionalstatusunknown.md)  
+  
+ [System.ServiceModel.Channels.MsmqScanStarted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqscanstarted.md)  
+  
+ [System.ServiceModel.Channels.MsmqSessiongramSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramsent.md)  
+  
+ [System.ServiceModel.Channels.MsmqSessiongramReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqsessiongramreceived.md)  
+  
+ [System.ServiceModel.Channels.MsmqStartingApplication](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingapplication.md)  
+  
+ [System.ServiceModel.Channels.MsmqStartingService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqstartingservice.md)  
+  
+ [System.ServiceModel.Channels.MsmqUnexpectedAcknowledgment](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-msmqunexpectedacknowledgment.md)  
+  
+ `ComIntegration`  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartingService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartingservice.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststartedservice.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceContract](../../../../../docs/framework/wcf/diagnostics/tracing/ssc-comintegrationservicehostcreatedservicecontract.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStartedServiceDetails](../../../../../docs/framework/wcf/diagnostics/tracing/ssc-comintegration.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostCreatedServiceEndpoint](../../../../../docs/framework/wcf/diagnostics/tracing/ssc--comintegrationservicehostcreatedserviceendpoint.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppingService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppingservice.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceHostStoppedService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicehoststoppedservice.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarting](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarting.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStarted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstarted.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopping](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopping.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDllHostInitializerStopped](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdllhostinitializerstopped.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTLBImportStarting](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportstarting.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromAssembly](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromassembly.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFromTypelib](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfromtypelib.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTLBImportConverterEvent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportconverterevent.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTLBImportFinished](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtlbimportfinished.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationRequest](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationrequest.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInstanceCreationSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancecreationsuccess.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInstanceReleased](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinstancereleased.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationEnteringActivity](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationenteringactivity.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationExecutingCall](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationexecutingcall.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationLeftActivity](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationleftactivity.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethod](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethod.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInvokedMethod](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokedmethod.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodNewTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationinvokingmethodnewtransaction.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationInvokingMethodContextTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/ssc-comintegrationinvokingmethodcontexttransaction.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationServiceMonikerParsed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationservicemonikerparsed.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationWsdlChannelBuilderLoaded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationwsdlchannelbuilderloaded.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTypedChannelBuilderLoaded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtypedchannelbuilderloaded.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationChannelCreated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationchannelcreated.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationDispatchMethod](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationdispatchmethod.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxCommitted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxcommitted.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByContext](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbycontext.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationTxProxyTxAbortedByTM](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationtxproxytxabortedbytm.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationMexMonikerMetadataExchangeComplete](../../../../../docs/framework/wcf/diagnostics/tracing/ssc--comintegrationmexmonikermetadataexchangecomplete.md)  
+  
+ [System.ServiceModel.ComIntegration.ComIntegrationMexChannelBuilderLoaded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-comintegration-comintegrationmexchannelbuilderloaded.md)  
+  
+ `Security`  
+  
+ [System.ServiceModel.Security.SecurityIdentityVerificationSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationsuccess.md)  
+  
+ [System.ServiceModel.Security.SecurityIdentityVerificationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityverificationfailure.md)  
+  
+ [System.ServiceModel.Security.SecurityIdentityDeterminationSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationsuccess.md)  
+  
+ [System.ServiceModel.Security.SecurityIdentityDeterminationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentitydeterminationfailure.md)  
+  
+ [System.ServiceModel.Security.SecurityIdentityHostNameNormalizationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityidentityhostnamenormalizationfailure.md)  
+  
+ [System.ServiceModel.Security.SecurityImpersonationSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationsuccess.md)  
+  
+ [System.ServiceModel.Security.SecurityImpersonationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityimpersonationfailure.md)  
+  
+ [System.ServiceModel.Security.SecurityNegotiationProcessingFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynegotiationprocessingfailure.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderRemovedCachedToken](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderremovedcachedtoken.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderUsingCachedToken](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderusingcachedtoken.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderBeginSecurityNegotiation](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderbeginsecuritynegotiation.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderEndSecurityNegotiation](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderendsecuritynegotiation.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderRedirectApplied](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderredirectapplied.md)  
+  
+ [System.ServiceModel.Security.IssuanceTokenProviderServiceTokenCacheFull](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-issuancetokenproviderservicetokencachefull.md)  
+  
+ [System.ServiceModel.Security.NegotiationTokenProviderAttached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationtokenproviderattached.md)  
+  
+ [System.ServiceModel.Security.SpnegoClientNegotiationCompleted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoclientnegotiationcompleted.md)  
+  
+ [System.ServiceModel.Security.SpnegoServiceNegotiationCompleted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-spnegoservicenegotiationcompleted.md)  
+  
+ [System.ServiceModel.Security.NegotiationAuthenticatorAttached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-negotiationauthenticatorattached.md)  
+  
+ [System.ServiceModel.Security.ServiceSecurityNegotiationCompleted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-servicesecuritynegotiationcompleted.md)  
+  
+ [System.ServiceModel.Security.SecurityContextTokenCacheFull](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitycontexttokencachefull.md)  
+  
+ [System.ServiceModel.Security.ExportSecurityChannelBindingEntry](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingentry.md)  
+  
+ [System.ServiceModel.Security.ExportSecurityChannelBindingExit](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingexit.md)  
+  
+ [System.ServiceModel.Security.ExportSecurityChannelBindingExit](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-exportsecuritychannelbindingexit.md)  
+  
+ [System.ServiceModel.Security.ImportSecurityChannelBindingExit](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-importsecuritychannelbindingexit.md)  
+  
+ [System.ServiceModel.Security.SecurityTokenProviderOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenprovideropened.md)  
+  
+ [System.ServiceModel.Security.SecurityTokenProviderClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenproviderclosed.md)  
+  
+ [System.ServiceModel.Security.SecurityTokenAuthenticatorOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatoropened.md)  
+  
+ [System.ServiceModel.Security.SecurityTokenAuthenticatorClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitytokenauthenticatorclosed.md)  
+  
+ [System.ServiceModel.Security.SecurityBindingOutgoingMessageSecured](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingoutgoingmessagesecured.md)  
+  
+ [System.ServiceModel.Security.SecurityBindingIncomingMessageVerified](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingincomingmessageverified.md)  
+  
+ [System.ServiceModel.Security.SecurityBindingSecureOutgoingMessageFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingsecureoutgoingmessagefailure.md)  
+  
+ [System.ServiceModel.Security.SecurityBindingVerifyIncomingMessageFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitybindingverifyincomingmessagefailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySpnToSidMappingFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityspntosidmappingfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionRedirectApplied](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionredirectapplied.md)  
+  
+ [System.ServiceModel.Security.SecurityClientSessionCloseSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosesent.md)  
+  
+ [System.ServiceModel.Security.SecurityClientSessionCloseResponseSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessioncloseresponsesent.md)  
+  
+ [System.ServiceModel.Security.SecurityClientSessionCloseMessageReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionclosemessagereceived.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionKeyRenewalFaultReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionkeyrenewalfaultreceived.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionAbortedFaultReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultreceived.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionClosedResponseReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsereceived.md)  
+  
+ [System.ServiceModel.Security.SecurityClientSessionPreviousKeyDiscarded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionpreviouskeydiscarded.md)  
+  
+ [System.ServiceModel.Security.SecurityClientSessionKeyRenewed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityclientsessionkeyrenewed.md)  
+  
+ [System.ServiceModel.Security.SecurityPendingServerSessionAdded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionadded.md)  
+  
+ [System.ServiceModel.Security.SecurityPendingServerSessionClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionclosed.md)  
+  
+ [System.ServiceModel.Security.SecurityPendingServerSessionActivated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitypendingserversessionactivated.md)  
+  
+ [System.ServiceModel.Security.SecurityActiveServerSessionRemoved](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityactiveserversessionremoved.md)  
+  
+ [System.ServiceModel.Security.SecurityNewServerSessionKeyIssued](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitynewserversessionkeyissued.md)  
+  
+ [System.ServiceModel.Security.SecurityInactiveSessionFaulted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityinactivesessionfaulted.md)  
+  
+ [System.ServiceModel.Security.SecurityServerSessionKeyUpdated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionkeyupdated.md)  
+  
+ [System.ServiceModel.Security.SecurityServerSessionCloseReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionclosereceived.md)  
+  
+ [System.ServiceModel.Security.SecurityServerSessionRenewalFaultSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionrenewalfaultsent.md)  
+  
+ [System.ServiceModel.Security.SecurityServerSessionAbortedFaultSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessionabortedfaultsent.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionCloseResponseSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessioncloseresponsesent.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionServerCloseSent](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesent.md)  
+  
+ [System.ServiceModel.Security.SecurityServerSessionCloseResponseReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityserversessioncloseresponsereceived.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionRenewFaultSendFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrenewfaultsendfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionAbortedFaultSendFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionabortedfaultsendfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionClosedResponseSendFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionclosedresponsesendfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionServerCloseSendFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionserverclosesendfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionRequestorOperationSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationsuccess.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionRequestorOperationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionrequestoroperationfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionResponderOperationFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessionresponderoperationfailure.md)  
+  
+ [System.ServiceModel.Security.SecuritySessionDemuxFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securitysessiondemuxfailure.md)  
+  
+ [System.ServiceModel.Security.SecurityAuditWrittenSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittensuccess.md)  
+  
+ [System.ServiceModel.Security.SecurityAuditWrittenFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-security-securityauditwrittenfailure.md)  
+  
+ `ServiceModel`  
+  
+ [System.ServiceModel.AsyncCallbackThrewException](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-asynccallbackthrewexception.md)  
+  
+ [System.ServiceModel.CommunicationObjectAborted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectaborted.md)  
+  
+ [System.ServiceModel.CommunicationObjectAbortFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectabortfailed.md)  
+  
+ [System.ServiceModel.CommunicationObjectCloseFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosefailed.md)  
+  
+ [System.ServiceModel.CommunicationObjectOpenFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopenfailed.md)  
+  
+ [System.ServiceModel.CommunicationObjectClosing](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosing.md)  
+  
+ [System.ServiceModel.CommunicationObjectClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectclosed.md)  
+  
+ [System.ServiceModel.CommunicationObjectCreated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectcreated.md)  
+  
+ [System.ServiceModel.CommunicationObjectDisposing](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectdisposing.md)  
+  
+ [System.ServiceModel.CommunicationObjectFaultReason](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaultreason.md)  
+  
+ [System.ServiceModel.CommunicationObjectFaulted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectfaulted.md)  
+  
+ [System.ServiceModel.CommunicationObjectOpening](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopening.md)  
+  
+ [System.ServiceModel.CommunicationObjectOpened](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-communicationobjectopened.md)  
+  
+ [System.ServiceModel.DidNotUnderstandMessageHeader](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-didnotunderstandmessageheader.md)  
+  
+ [System.ServiceModel.UnderstoodMessageHeader](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-understoodmessageheader.md)  
+  
+ [System.ServiceModel.MessageClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosed.md)  
+  
+ [System.ServiceModel.MessageClosedAgain](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageclosedagain.md)  
+  
+ [System.ServiceModel.MessageCopied](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagecopied.md)  
+  
+ [System.ServiceModel.MessageRead](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageread.md)  
+  
+ [System.ServiceModel.MessageWritten](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messagewritten.md)  
+  
+ [System.ServiceModel.BeginExecuteMethod](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-beginexecutemethod.md)  
+  
+ [System.ServiceModel.ConfigurationIsReadOnly](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-configurationisreadonly.md)  
+  
+ [System.ServiceModel.ConfiguredExtensionTypeNotFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-configuredextensiontypenotfound.md)  
+  
+ [System.ServiceModel.EvaluationContextNotFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-evaluationcontextnotfound.md)  
+  
+ [System.ServiceModel.EndExecuteMethod](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-endexecutemethod.md)  
+  
+ [System.ServiceModel.ExtensionCollectionDoesNotExist](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectiondoesnotexist.md)  
+  
+ [System.ServiceModel.ExtensionCollectionNameNotFound](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionnamenotfound.md)  
+  
+ [System.ServiceModel.ExtensionCollectionIsEmpty](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensioncollectionisempty.md)  
+  
+ [System.ServiceModel.ExtensionElementAlreadyExistsInCollection](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-extensionelementalreadyexistsincollection.md)  
+  
+ [System.ServiceModel.ElementTypeDoesntMatchConfiguredType](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-elementtypedoesntmatchconfiguredtype.md)  
+  
+ [System.ServiceModel.ErrorInvokingUserCode](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-errorinvokingusercode.md)  
+  
+ [System.ServiceModel.GetBehaviorElement](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getbehaviorelement.md)  
+  
+ [System.ServiceModel.GetCommonBehaviors](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getcommonbehaviors.md)  
+  
+ [System.ServiceModel.GetConfiguredBinding](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfiguredbinding.md)  
+  
+ [System.ServiceModel.GetChannelEndpointElement](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getchannelendpointelement.md)  
+  
+ [System.ServiceModel.GetConfigurationSection](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getconfigurationsection.md)  
+  
+ [System.ServiceModel.GetDefaultConfiguredBinding](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getdefaultconfiguredbinding.md)  
+  
+ [System.ServiceModel.GetServiceElement](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-getserviceelement.md)  
+  
+ [System.ServiceModel.MessageProcessingPaused](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-messageprocessingpaused.md)  
+  
+ [System.ServiceModel.ManualFlowThrottleLimitReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-manualflowthrottlelimitreached.md)  
+  
+ [System.ServiceModel.OverridingDuplicateConfigurationKey](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-overridingduplicateconfigurationkey.md)  
+  
+ [System.ServiceModel.RemoveBehavior](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-removebehavior.md)  
+  
+ [System.ServiceModel.ServiceChannelLifetime](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicechannellifetime.md)  
+  
+ [System.ServiceModel.ServiceHostCreation](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostcreation.md)  
+  
+ [System.ServiceModel.ServiceHostBaseAddresses](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostbaseaddresses.md)  
+  
+ [System.ServiceModel.ServiceHostTimeoutOnClose](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosttimeoutonclose.md)  
+  
+ [System.ServiceModel.ServiceHostFaulted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehostfaulted.md)  
+  
+ [System.ServiceModel.ServiceHostErrorOnReleasePerformanceCounter](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicehosterroronreleaseperformancecounter.md)  
+  
+ [System.ServiceModel.ServiceThrottleLimitReached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-servicethrottlelimitreached.md)  
+  
+ [System.ServiceModel.ServiceOperationMissingReply](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreply.md)  
+  
+ [System.ServiceModel.ServiceOperationMissingReplyContext](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationmissingreplycontext.md)  
+  
+ [System.ServiceModel.ServiceOperationExceptionOnReply](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-serviceoperationexceptiononreply.md)  
+  
+ [System.ServiceModel.SkipBehavior](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-skipbehavior.md)  
+  
+ [System.ServiceModel.TransportListen](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-transportlisten.md)  
+  
+ [System.ServiceModel.UnhandledAction](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledaction.md)  
+  
+ [System.ServiceModel.PerformanceCounterFailedToLoad](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecounterfailedtoload.md)  
+  
+ [System.ServiceModel.PerformanceCountersFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailed.md)  
+  
+ [System.ServiceModel.PerformanceCountersFailedDuringUpdate](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedduringupdate.md)  
+  
+ [System.ServiceModel.PerformanceCountersFailedForService](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedforservice.md)  
+  
+ [System.ServiceModel.PerformanceCountersFailedOnRelease](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-performancecountersfailedonrelease.md)  
+  
+ [System.ServiceModel.WsmexNonCriticalWsdlExportError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlexporterror.md)  
+  
+ [System.ServiceModel.WsmexNonCriticalWsdlImportError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-wsmexnoncriticalwsdlimporterror.md)  
+  
+ [System.ServiceModel.FailedToOpenIncomingChannel](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-failedtoopenincomingchannel.md)  
+  
+ [System.ServiceModel.UnhandledExceptionInUserOperation](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-unhandledexceptioninuseroperation.md)  
+  
+ [System.ServiceModel.DroppedAMessage](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-droppedamessage.md)  
+  
+ [System.ServiceModel.CannotBeImportedInCurrentFormat](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-cannotbeimportedincurrentformat.md)  
+  
+ [System.ServiceModel.MetadataExchangeClientSendRequest](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientsendrequest.md)  
+  
+ [System.ServiceModel.MetadataExchangeClientReceiveReply](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-metadataexchangeclientreceivereply.md)  
+  
+ [System.ServiceModel.WarnHelpPageEnabledNoBaseAddress](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-warnhelppageenablednobaseaddress.md)  
+  
+ `Activation`  
+  
+ [System.ServiceModel.Activation.WebHostServiceActivated](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceactivated.md)  
+  
+ [System.ServiceModel.Activation.WebHostCompilation](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostcompilation.md)  
+  
+ [System.ServiceModel.Activation.WebHostDebugRequest](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostdebugrequest.md)  
+  
+ [System.ServiceModel.Activation.WebHostProtocolMisconfigured](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostprotocolmisconfigured.md)  
+  
+ [System.ServiceModel.Activation.WebHostServiceCloseFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-webhostserviceclosefailed.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueclosed.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueDuplicatedPipe](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipe.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueDuplicatedPipeError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedpipeerror.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueDuplicatedSocket](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocket.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueDuplicatedSocketError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueduplicatedsocketerror.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueUnregisterSucceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueunregistersucceeded.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueRegisterCalled](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistercalled.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueRegisterSucceeded](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregistersucceeded.md)  
+  
+ [System.ServiceModel.Activation.MessageQueueRegisterFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-messagequeueregisterfailed.md)  
+  
+ [System.ServiceModel.Activation.ServiceContinue](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicecontinue.md)  
+  
+ [System.ServiceModel.Activation.ServicePause](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicepause.md)  
+  
+ [System.ServiceModel.Activation.ServiceShutdown](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdown.md)  
+  
+ [System.ServiceModel.Activation.ServiceShutdownError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-serviceshutdownerror.md)  
+  
+ [System.ServiceModel.Activation.ServiceStart](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestart.md)  
+  
+ [System.ServiceModel.Activation.ServiceStartPipeError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestartpipeerror.md)  
+  
+ [System.ServiceModel.Activation.ServiceStop](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-activation-servicestop.md)  
+  
+ `PortSharing`  
+  
+ [System.ServiceModel.PortSharing.PortSharingClosed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingclosed.md)  
+  
+ [System.ServiceModel.PortSharing.PortSharingDuplicatedPipe](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedpipe.md)  
+  
+ [System.ServiceModel.PortSharing.PortSharingDupHandleGranted](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduphandlegranted.md)  
+  
+ [System.ServiceModel.PortSharing.PortSharingDuplicatedSocket](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharingduplicatedsocket.md)  
+  
+ [System.ServiceModel.PortSharing.PortSharingListening](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-portsharinglistening.md)  
+  
+ [System.ServiceModel.PortSharing.ReadNetTcpConfig](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnettcpconfig.md)  
+  
+ [System.ServiceModel.PortSharing.ReadNetPipeConfig](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-readnetpipeconfig.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTableCannotListen](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablecannotlisten.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTableLookup](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablelookup.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTableNamespaceConflict](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablenamespaceconflict.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTablePathTooLong](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtablepathtoolong.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTableRegisterSuccess](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableregistersuccess.md)  
+  
+ [System.ServiceModel.PortSharing.RoutingTableUnsupportedProtocol](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-routingtableunsupportedprotocol.md)  
+  
+ [System.ServiceModel.PortSharing.SharedManagerServiceEndpointNotExist](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-sharedmanagerserviceendpointnotexist.md)  
+  
+ [System.ServiceModel.PortSharing.TransportListenerListening](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistening.md)  
+  
+ [System.ServiceModel.PortSharing.TransportListenerListenRequest](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerlistenrequest.md)  
+  
+ [System.ServiceModel.PortSharing.TransportListenerSessionsReceived](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenersessionsreceived.md)  
+  
+ [System.ServiceModel.PortSharing.TransportListenerStop](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-transportlistenerstop.md)  
+  
+ [System.ServiceModel.PortSharing.WasCloseAllListenerChannelInstances](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasclosealllistenerchannelinstances.md)  
+  
+ [System.ServiceModel.PortSharing.WasWebHostAPIFailed](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-waswebhostapifailed.md)  
+  
+ [System.ServiceModel.PortSharing.WasConnected](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-portsharing-wasconnected.md)  
+  
+ `TransactionBridge`  
+  
+ [Microsoft.Transactions.TransactionBridge.CreateTransactionFailure](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-createtransactionfailure.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.EnlistTransactionFailure](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-channels-connectionpoolmaxoutboundconnectionsperendpointquotareached.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegisterParticipantFailure](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipantfailure.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.VolatileOutcomeTimeout](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileoutcometimeout.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.DurableParticipantReplayWhilePreparing](../../../../../docs/framework/wcf/diagnostics/tracing/mtt-durableparticipantreplaywhilepreparing.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFaulted](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfaulted.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorFailed](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registrationcoordinatorfailed.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegistrationCoordinatorResponseInvalidMetadata](../../../../../docs/framework/wcf/diagnostics/tracing/mts-registrationcoordinatorresponseinvalidmetadata.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RecoveredCoordinatorInvalidMetadata](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredcoordinatorinvalidmetadata.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RecoveredParticipantInvalidMetadata](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-recoveredparticipantinvalidmetadata.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.EnlistTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlisttransaction.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegisterCoordinator](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registercoordinator.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.RegisterParticipant](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-registerparticipant.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.ProtocolInitialized](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolinitialized.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.ProtocolStarted](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-protocolstarted.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.PrepareMessageRetry](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparemessageretry.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.CommitMessageRetry](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-commitmessageretry.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.PreparedMessageRetry](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-preparedmessageretry.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.ReplayMessageRetry](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-replaymessageretry.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.ParticipantRecovered](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantrecovered.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.CoordinatorRecovered](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorrecovered.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.EnlistmentIdentityCheckFailed](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-enlistmentidentitycheckfailed.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.ParticipantStateMachineFinished](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-participantstatemachinefinished.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.CoordinatorStateMachineFinished](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-coordinatorstatemachinefinished.md)  
+  
+ [Microsoft.Transactions.TransactionBridge.VolatileParticipantInDoubt](../../../../../docs/framework/wcf/diagnostics/tracing/microsoft-transactions-transactionbridge-volatileparticipantindoubt.md)  
+  
+ `IdentityModel`  
+  
+ [System.IdentityModel.IdentityModelAsyncCallbackThrewException](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-identitymodelasynccallbackthrewexception.md)  
+  
+ [System.IdentityModel.AuthorizationContextCreated](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationcontextcreated.md)  
+  
+ [System.IdentityModel.AuthorizationPolicyEvaluated](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-authorizationpolicyevaluated.md)  
+  
+ [System.IdentityModel.Selectors.GeneralInformation](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-generalinformation.md)  
+  
+ [System.IdentityModel.Selectors.StoreLoading](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeloading.md)  
+  
+ [System.IdentityModel.Selectors.StoreBeginTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storebegintransaction.md)  
+  
+ [System.IdentityModel.Selectors.StoreCommitTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storecommittransaction.md)  
+  
+ [System.IdentityModel.Selectors.StoreRollbackTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storerollbacktransaction.md)  
+  
+ [System.IdentityModel.Selectors.StoreClosing](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storeclosing.md)  
+  
+ [System.IdentityModel.Selectors.StoreFailedToOpenStore](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storefailedtoopenstore.md)  
+  
+ [System.IdentityModel.Selectors.StoreSignatureNotValid](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storesignaturenotvalid.md)  
+  
+ [System.IdentityModel.Selectors.StoreDeleting](../../../../../docs/framework/wcf/diagnostics/tracing/system-identitymodel-selectors-storedeleting.md)  
+  
+ `Transactions`  
+  
+ [System.ServiceModel.TxSourceTxScopeRequiredIsTransactedTransport](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactedtransport.md)  
+  
+ [System.ServiceModel.TxSourceTxScopeRequiredIsTransactionFlow](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredistransactionflow.md)  
+  
+ [System.ServiceModel.TxSourceTxScopeRequiredIsAttachedTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequiredisattachedtransaction.md)  
+  
+ [System.ServiceModel.TxSourceTxScopeRequiredIsCreateNewTransaction](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txsourcetxscoperequirediscreatenewtransaction.md)  
+  
+ [System.ServiceModel.TxCompletionStatusCompletedForAutocomplete](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforautocomplete.md)  
+  
+ [System.ServiceModel.TxCompletionStatusCompletedForError](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforerror.md)  
+  
+ [System.ServiceModel.TxCompletionStatusCompletedForSetComplete](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforsetcomplete.md)  
+  
+ [System.ServiceModel.TxCompletionStatusCompletedForTACOSC](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedfortacosc.md)  
+  
+ [System.ServiceModel.TxCompletionStatusCompletedForAsyncAbort](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatuscompletedforasyncabort.md)  
+  
+ [System.ServiceModel.TxCompletionStatusRemainsAttached](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusremainsattached.md)  
+  
+ [System.ServiceModel.TxCompletionStatusAbortedOnSessionClose](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txcompletionstatusabortedonsessionclose.md)  
+  
+ [System.ServiceModel.TxReleaseServiceInstanceOnCompletion](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txreleaseserviceinstanceoncompletion.md)  
+  
+ [System.ServiceModel.TxAsyncAbort](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txasyncabort.md)  
+  
+ [System.ServiceModel.TxFailedToNegotiateOleTx](../../../../../docs/framework/wcf/diagnostics/tracing/system-servicemodel-txfailedtonegotiateoletx.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/transfer.md b/docs/framework/wcf/diagnostics/tracing/transfer.md
new file mode 100644
index 00000000000..af85cf1b9aa
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/transfer.md
@@ -0,0 +1,105 @@
+---
+title: "転送 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfcfa36c-d3bb-44b4-aa15-1c922c6f73e6
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 転送
+このトピックでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] のアクティビティ トレース モデルで使用される転送という概念について説明します。  
+  
+## 転送の定義  
+ アクティビティ間の転送は、エンドポイント内の関連アクティビティで発生したイベント間の因果関係を表します。  制御が 2 つのアクティビティ間を流れる場合 \(アクティビティの境界を越えたメソッド呼び出しなど\)、転送によってこれらのアクティビティが関連付けられます。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では、サービスでバイトを受信すると、"リッスン" アクティビティが "バイトを受信" アクティビティに転送され、このアクティビティでメッセージ オブジェクトが作成されます。  エンドツーエンドのトレースのシナリオの一覧、および各シナリオの個々のアクティビティとトレース デザインについては、「[エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)」を参照してください。  
+  
+ 転送トレースを出力するには、次の構成コードのように、トレース ソースに `ActivityTracing` を設定します。  
+  
+```  
+<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing">  
+```  
+  
+## 転送を使用したエンドポイント内でのアクティビティの関連付け  
+ アクティビティと転送により、ユーザーはエラーの根本原因をほぼ突き止めることができます。  たとえば、コンポーネント M と N のアクティビティ M と N の間で、M から N および N から M への転送を行い、M への転送の直後に N でクラッシュが発生した場合、N から M にデータを返したことが原因でクラッシュが発生した可能性があるという結論を下すことができます。  
+  
+ アクティビティ M とアクティビティ N の間に制御のフローが存在する場合、転送トレースは M から N に出力されます。  たとえば、メソッド呼び出しがアクティビティの境界を越えるため、N が M に代わって何らかの処理を実行するとします。  N は既に存在する場合もあれば、作成されている場合もあります。  N が、M に代わって何らかの処理を実行する新しいアクティビティである場合、N は M によって発生します。  
+  
+ M から N への転送の後に、N から M に転送することはできません。  これは、M は N で処理を発生させることはできますが、N がその処理をいつ完了するかまでは追跡しないからです。  実際、N がタスクを完了する前に M が終了する場合があります。  このような状況は、リスナーのアクティビティ \(N\) を発生させた後に終了する "ServiceHost を開く" アクティビティ \(M\) で発生します。  N から M への転送は、N が M に関連する処理を完了したことを意味します。  
+  
+ N は、M に関連しない他の処理を引き続き実行できます。たとえば、既存の認証システム アクティビティ \(N\) は、さまざまなログイン アクティビティからのログイン要求 \(M\) を受信し続けることができます。  
+  
+ アクティビティ M と N の間に、入れ子のリレーションシップが必ずしも存在するわけではありません。  入れ子のリレーションシップが存在しない状況が発生する原因として、2 つのケースが考えられます。  1 つは、アクティビティ M がアクティビティ N を開始したが、N で実行される実際の処理を M が監視しない場合です。  もう 1 つは、N が既に存在する場合です。  
+  
+## 転送の例  
+ 転送の 2 つの例を次に示します。  
+  
+-   サービス ホストの作成時に、コンストラクターは呼び出し元のコードから制御を取得します。つまり、呼び出し元のコードがコンストラクターに転送されます。  コンストラクターは、必要な処理を終えると、呼び出し元に制御を返します。つまり、コンストラクターから呼び出し元への逆転送が起こります。  これは、入れ子になったリレーションシップの例です。  
+  
+-   リスナーはトランスポート データの処理を開始するときに、新しいスレッドを作成し、"バイトを受信" アクティビティに、処理の適切なコンテキストとして制御とデータを渡します。  このスレッドが要求の処理を完了しても、"バイトを受信" アクティビティからリスナーには何も渡されません。  この場合、新しいスレッドのアクティビティへの転送はありますが、このアクティビティからの転送はありません。  2 つのアクティビティは関連していますが、入れ子にはなっていません。  
+  
+## アクティビティ転送シーケンス  
+ 適切なアクティビティ転送シーケンスには、次の手順が含まれます。  
+  
+1.  新しい gAId を選択して、新しいアクティビティを開始します。  
+  
+2.  現在のアクティビティ ID から新しい gAId への転送トレースを出力します。  
+  
+3.  TLS に新しい ID を設定します。  
+  
+4.  Start トレースを出力して、新しいアクティビティの開始を示します。  
+  
+5.  次の手順を実行して、元のアクティビティに戻ります。  
+  
+6.  元の gAId への転送トレースを出力します。  
+  
+7.  Stop トレースを出力して、新しいアクティビティの終了を示します。  
+  
+8.  TLS を以前の gAId に設定します。  
+  
+ これを実行する方法を次のコード例に示します。  この例は、新しいアクティビティへの転送時にブロック呼び出しが行われることを想定しており、Suspend トレースと Resume トレースが含まれています。  
+  
+```  
+// 0. Create a trace source  
+TraceSource ts = new TraceSource(“myTS”);  
+// 1. remember existing (“ambient”) activity for clean up  
+Guid oldGuid = Trace.CorrelationManager.ActivityId;  
+// this will be our new activity  
+Guid newGuid = Guid.NewGuid();   
+// 2. call transfer, indicating that we are switching to the new AID  
+ts.TraceTransfer(667, "Transferring.", newGuid);  
+// 3. Suspend the current activity.  
+ts.TraceEvent(TraceEventType.Suspend, 667, "Suspend: Activity " + i-1);  
+// 4. set the new AID in TLS  
+Trace.CorrelationManager.ActivityId = newGuid;  
+// 5. Emit the start trace  
+ts.TraceEvent(TraceEventType.Start, 667, "Boundary: Activity " + i);  
+// trace something  
+ts.TraceEvent(TraceEventType.Information, 667, "Hello from activity " + i);  
+// Perform Work  
+// some work.  
+// Return  
+ts.TraceEvent(TraceEventType.Information, 667, "Work complete on activity " + i);   
+// 6. Emit the transfer returning to the original activity  
+ts.TraceTransfer(667, "Transferring Back.", oldGuid);  
+// 7. Emit the End trace  
+ts.TraceEvent(TraceEventType.Stop, 667, "Boundary: Activity " + i);  
+// 8. Change the tls variable to the original AID  
+Trace.CorrelationManager.ActivityId = oldGuid;    
+// 9. Resume the old activity  
+ts.TraceEvent(TraceEventType.Resume, 667, "Resume: Activity " + i-1);  
+```  
+  
+## 参照  
+ [トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md b/docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md
new file mode 100644
index 00000000000..85edf880743
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md
@@ -0,0 +1,211 @@
+---
+title: "サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05d2321c-8acb-49d7-a6cd-8ef2220c6775
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング
+ここでは、トレース データの形式、表示方法、およびサービス トレース ビューアーを使用したアプリケーションのトラブルシューティングの方法について説明します。  
+  
+## サービス トレース ビューアー ツールの使用  
+ [!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] のサービス トレース ビューアー ツールでは、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] リスナーによって生成された診断トレースを相互に関連付けて、エラーの根本原因を突き止めることができます。  このツールを使用すると、トレースを容易に表示、グループ化、およびフィルター処理できるため、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] サービスの問題を診断、修復、および検証できます。  このツールの使用の詳細については、「[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)」を参照してください。  
+  
+ このトピックには、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)を使って表示した場合の、[トレースとメッセージ ログ](../../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)のサンプルを実行して生成されたトレースのスクリーンショットが含まれています。  ここでは、トレースの内容、アクティビティ、およびアクティビティの相関関係を理解する方法と、トラブルシューティングを行うときに多数のトレースを分析する方法について説明します。  
+  
+## トレースの内容の表示  
+ トレース イベントには、次のような最も重要な情報が含まれています。  
+  
+-   設定時のアクティビティ名。  
+  
+-   出力時間。  
+  
+-   トレース レベル。  
+  
+-   トレース ソース名。  
+  
+-   プロセス名。  
+  
+-   スレッド ID。  
+  
+-   一意のトレース識別子。これは、MSDN オンライン ライブラリ内の参照先の URL です。このライブラリからそのトレースに関連する詳細情報を入手できます。  
+  
+ これらの情報はすべて、サービス トレース ビューアーの右上のパネルに表示されます。トレースを選択した場合は、右下のパネルの \[書式付き\] ビューにある **\[基本情報\]** セクションに表示されます。  
+  
+> [!NOTE]
+>  クライアントとサービスが同じコンピューター上にある場合、両方のアプリケーションのトレースが存在します。  これらのトレースは、**\[プロセス名\]** 列を使用してフィルター処理できます。  
+  
+ また、\[書式付き\] ビューには、トレースの説明と追加詳細情報も表示されます \(利用できる場合\)。  追加詳細情報には、例外の種類とメッセージ、呼び出しスタック、メッセージ アクション、転送元\/転送先フィールド、およびその他の例外情報が含まれる場合があります。  
+  
+ \[XML\] ビューには、以下の有用な XML タグが含まれます。  
+  
+-   \<SubType\> \(トレース レベル\)  
+  
+-   \<TimeCreated\>  
+  
+-   \<Source\> \(トレース ソース名\)  
+  
+-   \<Correlation\> \(トレースの出力時に設定するアクティビティ ID\)  
+  
+-   \<Execution\> \(プロセスとスレッド ID\)  
+  
+-   \<Computer\>  
+  
+-   \<ExtendedData\> \(メッセージの送信時にメッセージ ヘッダーに設定する \<Action\>、\<MessageID\>、および \<ActivityId\> を含む\)  
+  
+ "チャネル経由でメッセージを送信しました" トレースを調べると、次のような内容を確認できます。  
+  
+```  
+<E2ETraceEvent xmlns="http://schemas.microsoft.com/2004/06/E2ETraceEvent">  
+   <System xmlns="http://schemas.microsoft.com/2004/06/windows/eventlog/system">  
+      <EventID>262163</EventID>  
+      <Type>3</Type>  
+      <SubType Name="Information">0</SubType>  
+      <Level>8</Level>  
+      <TimeCreated SystemTime="2006-08-04T18:45:30.8491051Z" />  
+      <Source Name="System.ServiceModel" />  
+       <Correlation ActivityID="{27c6331d-8998-43aa-a382-03239013a6bd}"/>  
+       <Execution ProcessName="client" ProcessID="1808" ThreadID="1" />  
+       <Channel />  
+       <Computer>TEST1</Computer>  
+   </System>  
+   <ApplicationData>  
+       <TraceData>  
+          <DataItem>  
+             <TraceRecord xmlns="http://schemas.microsoft.com/2004/10/E2ETraceEvent/TraceRecord" Severity="Information">  
+                 <TraceIdentifier>http://msdn.microsoft.com/library/System.ServiceModel.Channels.MessageSent.aspx</TraceIdentifier>  
+                 <Description>Sent a message over a channel.</Description>  
+                 <AppDomain>client.exe</AppDomain>  
+                 <Source>System.ServiceModel.Channels.ClientFramingDuplexSessionChannel/35191196</Source>  
+                <ExtendedData xmlns="http://schemas.microsoft.com/2006/08/ServiceModel/MessageTransmitTraceRecord">  
+  
+                  <MessageProperties>  
+                     <AllowOutputBatching>False</AllowOutputBatching>  
+                  </MessageProperties>  
+                  <MessageHeaders>  
+                     <Action d4p1:mustUnderstand="1" xmlns:d4p1="http://www.w3.org/2003/05/soap-envelope" xmlns="http://www.w3.org/2005/08/addressing">http://Microsoft.ServiceModel.Samples/ICalculator/Multiply</Action>  
+                     <MessageID xmlns="http://www.w3.org/2005/08/addressing">urn:uuid:7c6670d8-4c9c-496e-b6a0-2ceb6db35338</MessageID>  
+                     <ActivityId CorrelationId="b02e2189-0816-4387-980c-dd8e306440f5" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">27c6331d-8998-43aa-a382-03239013a6bd</ActivityId>  
+                     <ReplyTo xmlns="http://www.w3.org/2005/08/addressing">  
+                        <Address>http://www.w3.org/2005/08/addressing/anonymous</Address>  
+                    </ReplyTo>  
+                    <To d4p1:mustUnderstand="1" xmlns:d4p1="http://www.w3.org/2003/05/soap-envelope" xmlns="http://www.w3.org/2005/08/addressing">net.tcp://localhost/servicemodelsamples/service</To>  
+                  </MessageHeaders>  
+                  <RemoteAddress>net.tcp://localhost/servicemodelsamples/service</RemoteAddress>  
+                </ExtendedData>  
+            </TraceRecord>  
+          </DataItem>  
+       </TraceData>  
+   </ApplicationData>  
+</E2ETraceEvent>  
+```  
+  
+## ServiceModel のエンドツーエンドのトレース  
+ Off 以外の `System.ServiceModel` と `switchValue` を使用して `ActivityTracing` トレース ソースを設定すると、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、アクティビティを作成し、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] での処理のために転送します。  
+  
+ アクティビティとは、その処理単位に関連するすべてのトレースをグループ化する処理の論理単位です。  たとえば、要求ごとに 1 つのアクティビティを定義できます。  転送により、エンドポイント内のアクティビティ間の因果関係が作成されます。  アクティビティ ID を伝達することにより、エンドポイント間でアクティビティを関連付けることができます。  これを行うには、各エンドポイントの構成で `propagateActivity`\=`true` に設定します。  アクティビティ、転送、および伝達により、エラーの関連付けを行うことができます。  このようにして、エラーの根本原因をよりすばやく見つけることができるようになります。  
+  
+ クライアントでは、オブジェクト モデル呼び出しごとに 1 つの [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] アクティビティが作成されます \(Open ChannelFactory、Add、Divide など\)。 各操作呼び出しは、"プロセス アクション" アクティビティで処理されます。  
+  
+ 次のスクリーンショットは、[トレースとメッセージ ログ](../../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)のサンプルから引用したものです。左のパネルには、クライアント プロセスで作成されたアクティビティの一覧が、作成時刻順に並べ替えられて表示されています。  以下に、各アクティビティを時系列で示します。  
+  
+-   チャネル ファクトリ \(ClientBase\) を作成しました。  
+  
+-   チャネル ファクトリを開きました。  
+  
+-   Add アクションを処理しました。  
+  
+-   セキュリティで保護されたセッションを設定し \(これは最初の要求で発生します\)、RST、RSTR、SCT \(プロセス メッセージ 1、2、3\) の 3 つのセキュリティ インフラストラクチャ応答メッセージを処理しました。  
+  
+-   Subtract、Multiply、および Divide の各要求を処理しました。  
+  
+-   チャネル ファクトリを閉じ、これにより、セキュリティで保護されたセッションを閉じました。また、セキュリティ メッセージ応答の Cancel を処理しました。  
+  
+ セキュリティ インフラストラクチャ メッセージがあるのは、wsHttpBinding を使用しているためです。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] では、転送によって、応答メッセージを要求メッセージが含まれた対応する "プロセス アクション" アクティビティに関連付ける前に、別のアクティビティで最初に処理する応答メッセージ \(プロセス メッセージ\) を示します。  これは、インフラストラクチャ メッセージと非同期要求に対して行います。非同期要求の場合、インフラストラクチャ メッセージを調べて activityId ヘッダーを確認し、該当の ID を持つ既存の "プロセス アクション" アクティビティを特定してこれに関連付ける必要があるためです。  同期要求の場合は、応答のためにブロックするため、応答を関連付けるプロセス アクションがわかります。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace4.gif "e2eTrace4")  
+作成時刻に従って一覧表示された WCF クライアント アクティビティ \(左のパネル\)、および入れ子にされたアクティビティとトレース \(右上のパネル\)  
+  
+ 左のパネルでアクティビティを選択すると、右上のパネルに入れ子にされたアクティビティとトレースが表示されます。  したがって、これは、選択した親アクティビティに基づいて、左側のアクティビティのリストの階層表示を減らしたものです。  選択した "プロセス アクション Add" は最初に作成された要求であるため、このアクティビティには、"セキュリティで保護されたセッションの設定" アクティビティ \(転送先と返送元\) と、Add アクションの実際の処理のトレースが含まれます。  
+  
+ 左のパネルで "プロセス アクション Add" アクティビティをダブルクリックすると、Add に関連する [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] クライアント アクティビティがグラフィック表示されます。  左の最初のアクティビティがルート アクティビティ \(0000\) であり、既定のアクティビティです。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、アンビエント アクティビティから転送します。  アンビエント アクティビティが定義されていない場合、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は 0000 から転送します。  ここでは、2 番目のアクティビティである "プロセス アクション Add" が 0 から転送します。  次に、"セキュリティで保護されたセッションの設定" が示されています。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace5.gif "e2eTrace5")  
+WCF クライアント アクティビティのグラフ ビュー : アンビエント アクティビティ \(ここでは 0\)、プロセス アクション、およびセキュリティで保護されたセッションの設定  
+  
+ 右上のパネルでは、"プロセス アクション Add" アクティビティに関連するすべてのトレースを確認できます。  具体的には、同じアクティビティで、要求メッセージ \("チャネル経由でメッセージを送信しました"\) を送信し、応答 \("チャネル経由でメッセージを受信しました"\) を受け取っています。  これを次のグラフに示します。  わかりやすくするために、このグラフでは、"セキュリティで保護されたセッションの設定" アクティビティを折りたたんでいます。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace6.gif "e2eTrace6")  
+"プロセス アクション" アクティビティのトレースのリスト : 同じアクティビティで要求を送信し、応答を受信します。  
+  
+ ここでは、わかりやすくするために、クライアント トレースだけを読み込んでいますが、サービス トレースもツールに読み込み、`propagateActivity` が `true.`  に設定されている場合は、サービス トレース \(受信した要求メッセージと送信した応答メッセージ\) が同じアクティビティに表示されます。これについては、後ほど図に示します。  
+  
+ サービスでは、アクティビティ モデルは [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] の概念に次のように対応付けられます。  
+  
+1.  ServiceHost を作成して開きます \(たとえば、セキュリティの場合、複数のホスト関連アクティビティを作成できます\)。  
+  
+2.  ServiceHost のリスナーごとに "リッスン" アクティビティを作成します \(Open ServiceHost との間の転送を使用\)。  
+  
+3.  リスナーは、クライアントが開始した通信要求を検出すると、"バイトを受信" アクティビティに転送します。このアクティビティで、クライアントから送信されたすべてのバイトが処理されます。  このアクティビティでは、クライアントとサーバーの対話中に発生したすべての接続エラーを確認できます。  
+  
+4.  メッセージに対応する、受信した各バイト セットについては、"メッセージを処理" アクティビティでこれらのバイトを処理します。このアクティビティで [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] メッセージ オブジェクトを作成します。  このアクティビティでは、不正なエンベロープや誤った形式のメッセージに関連するエラーを確認できます。  
+  
+5.  メッセージが作成されたら、"プロセス アクション" アクティビティに転送します。  クライアントとサービスの両方で、`propagateActivity` が `true` に設定されている場合、既に説明したように、このアクティビティはクライアントに定義されている ID と同じ ID を持ちます。  エンドポイント間を直接関連付けることによる利点を得ることができるのは、この段階からです。[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] で出力された、要求に関連するすべてのトレースは、応答メッセージ処理も含め、同じアクティビティに存在するからです。  
+  
+6.  プロセス外のアクションについて、"ユーザー コードの実行" アクティビティを作成して、ユーザー コードで出力されるトレースを [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] で出力されるトレースから分離します。  前の例では、"サービスが Add 応答を送信します" トレースは、クライアントによって伝達されたアクティビティではなく、"ユーザー コードを実行" アクティビティで出力されます \(該当する場合\)。  
+  
+ 次の図では、左の最初のアクティビティがルート アクティビティ \(0000\) であり、既定のアクティビティです。  次の 3 つのアクティビティは、ServiceHost を開くためのアクティビティです。  5 列目のアクティビティはリスナーです。残りのアクティビティ \(6 ～ 8 列目\) は、バイト処理からユーザー コードのアクティブ化までの、WCF でのメッセージ処理を示しています。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace7.gif "e2eTrace7")  
+WCF サービス アクティビティのリスト  
+  
+ 次のスクリーンショットは、クライアントとサービスの両方のアクティビティを示しています。プロセス全体にわたり、"プロセス アクション Add" アクティビティはオレンジで強調表示されています。  矢印は、クライアントとサービスによって送受信された要求メッセージと応答メッセージを関連付けています。  このグラフでは、"プロセス アクション" のトレースはプロセス間で分かれていますが、右上のパネルには同じアクティビティの一部として示されています。  このパネルには、送信されたメッセージのクライアント トレースの後に、受信および処理されたメッセージのサービス トレースが表示されています。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace8.gif "e2eTrace8")  
+WCF クライアント アクティビティとサービス アクティビティのグラフ ビュー  
+  
+ 次のエラー シナリオでは、サービスとクライアントのエラー トレースおよび警告トレースが関連付けられます。  サービスのユーザー コードで最初に例外がスローされています \("サービスはユーザー コードでこの要求を処理できません" という例外の警告トレースを含む右端の緑のアクティビティ\)。  クライアントに応答が送信されると、警告トレースが再度出力されて、エラー メッセージが表示されます \(左のピンクのアクティビティ\)。  その後、クライアントは WCF クライアントを閉じます \(左下の黄色のアクティビティ\)。これにより、サービスへの接続が中止されます。  サービスはエラーをスローします \(右側の最も長いピンクのアクティビティ\)。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/wcfc-e2etrace9s.gif "wcfc\_e2etrace9s")  
+サービスとクライアント間のエラーの相関関係  
+  
+ これらのトレースの生成に使用したサンプルは、wsHttpBinding を使用する一連の同期要求です。  セキュリティを使用しないシナリオ、または非同期要求を使用するシナリオの場合は、このグラフとは違う部分があります。非同期要求の場合、"プロセス アクション" アクティビティは、非同期呼び出しを構成する開始操作と終了操作の間に配置され、コールバック アクティビティへの転送が示されます。  その他のシナリオの詳細については、「[エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)」を参照してください。  
+  
+## サービス トレース ビューアーを使用したトラブルシューティング  
+ サービス トレース ビューアー ツールにトレース ファイルを読み込むと、左のパネルの赤または黄色のアクティビティを選択することによって、アプリケーションの問題の原因を突き止めることができます。  通常、000 アクティビティには、ユーザーにバブリングする未処理の例外が含まれます。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace10.gif "e2eTrace10")  
+赤または黄色のアクティビティを選択して問題の原因を特定します。  
+  
+ 右上のパネルでは、左側で選択したアクティビティのトレースを調べることができます。  このパネルで赤または黄色のトレースを調べ、それらがどのように関連しているかを確認できます。  前のグラフで、同じ "プロセス アクション" アクティビティのクライアントとサービスの警告トレースを確認します。  
+  
+ これらのトレースからエラーの根本原因がわからない場合は、左のパネルで選択したアクティビティ \(ここでは "プロセス アクション"\) をダブルクリックすることでグラフを利用できます。  関連アクティビティが含まれたグラフが表示されます。  \("\+" 記号をクリックして\) 関連アクティビティを展開すると、関連アクティビティで最初に出力された赤または黄色のトレースが見つかります。  調べる対象の赤または黄色のトレースの直前に発生したアクティビティを展開し、エンドポイント間の関連アクティビティまたはメッセージ フローをたどって問題の根本原因を突き止めます。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/wcfc-e2etrace9s.gif "wcfc\_e2etrace9s")  
+アクティビティを展開して問題の根本原因を追跡します。  
+  
+ ServiceModel の `ActivityTracing` が無効になっていても、ServiceModel トレースが有効であれば、0000 アクティビティで出力された ServiceModel のトレースを確認できます。  ただし、この場合、これらのトレースの相関関係を理解するには多くの労力を必要とします。  
+  
+ メッセージ ログを有効にすると、\[メッセージ\] タブを使用してエラーの影響を受けるメッセージを確認できます。  赤または黄色のメッセージをダブルクリックすると、関連アクティビティのグラフ ビューを表示できます。  これらのアクティビティは、エラーが発生した要求に最も密接に関連するアクティビティです。  
+  
+ ![トレース ビューアーの使用](../../../../../docs/framework/wcf/diagnostics/tracing/media/e2etrace11.gif "e2eTrace11")  
+トラブルシューティングを開始するには、赤または黄色のメッセージ トレースを選択し、これをダブルクリックして根本原因を追跡します。  
+  
+## 参照  
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)   
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)   
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md b/docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md
new file mode 100644
index 00000000000..2101c33c71a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md
@@ -0,0 +1,44 @@
+---
+title: "トレースを使用したアプリケーションのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7676b9bb-cbd1-41fd-9a93-cc615af6e2d0
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# トレースを使用したアプリケーションのトラブルシューティング
+このセクションには、トレースを使用してアプリケーションをトラブルシューティングする方法について説明したさまざまなトピックが含まれています。  
+  
+## このセクションの内容  
+ [トレースとメッセージ ログの推奨設定](../../../../../docs/framework/wcf/diagnostics/tracing/recommended-settings-for-tracing-and-message-logging.md)  
+ 運用環境とデバッグ環境の推奨設定について説明します。  
+  
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)  
+ ここでは、サービス トレース ビューアー ツールを使用して、トレース データの表示、関連付け、および分析を行う方法について説明します。  
+  
+ [重要なトレース](../../../../../docs/framework/wcf/diagnostics/tracing/significant-traces.md)  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] によって出力される主要なトレースの一覧です。  
+  
+ [クライアントでのデバッグ](../../../../../docs/framework/wcf/diagnostics/tracing/debugging-on-the-client.md)  
+ クライアントでアプリケーションをデバッグできるようにします。  
+  
+ [エンドツーエンドのトレースのシナリオ](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing-scenarios.md)  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] のエンドツーエンドのシナリオ \(たとえば、wsHttp による同期要求\/応答や TCP による非同期の一方向要求\) で使用されるトレースについて説明します。  
+  
+ [ユーザー コード トレースの出力](../../../../../docs/framework/wcf/diagnostics/tracing/emitting-user-code-traces.md)  
+ プログラムを使用してユーザー コードでトレースを出力する方法について説明します。これによってインストルメンテーション データを事前に作成し、後の診断 \(および WCF トレースとの関連付け\) で使用できます。  
+  
+## 参照  
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)   
+ [トレース](../../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [エンドツーエンドのトレース](../../../../../docs/framework/wcf/diagnostics/tracing/end-to-end-tracing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/viewing-message-logs.md b/docs/framework/wcf/diagnostics/viewing-message-logs.md
new file mode 100644
index 00000000000..499f90de3c4
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/viewing-message-logs.md
@@ -0,0 +1,73 @@
+---
+title: "メッセージ ログを参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3012fa13-f650-45fb-aaea-c5cca8c7d372
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# メッセージ ログを参照する
+ここでは、メッセージ ログの表示方法について説明します。  
+  
+## サービス トレース ビューアーでのメッセージ ログの表示  
+ メッセージは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で処理されるときに変換されます。そのため、ログ記録されたメッセージは、ログ記録された時点でのメッセージの内容を反映しているにすぎず、ネットワーク上での内容ではありません。  
+  
+ メッセージ ログの出力はメッセージの転送形式とは関係がないため、メッセージ ログは常にデコードされたメッセージを出力します。メッセージ ログが適切に設定されていれば、すべてのログ メッセージはプレーンテキストになります。たとえば、ログ メッセージの形式 \(プレーンテキスト\) は、バイナリ メッセージ エンコーダーの使用には影響されません。  
+  
+ XmlWriterTraceListener の出力は、一連の XML フラグメントを含んだファイルです。このファイルは有効な XML ファイルではないことに注意してください。[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) を使用してメッセージ ログ ファイルを表示することをお勧めします。このツールの使用方法の詳細については、「[サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)」を参照してください。  
+  
+ サービス トレース ビューアーでは、メッセージは **\[Message\]** タブに表示されます。操作エラーの原因となった、または操作エラーに関連するメッセージは、エラーの重大度に応じて、黄色 \(警告レベル\) または赤色 \(エラー レベル\) で強調表示されます。メッセージをダブルクリックすると、要求の処理のコンテキストに従ってメッセージ トレースが表示されます。  
+  
+> [!NOTE]
+>  メッセージにヘッダーがない場合は、`<header/>` タグがログに記録されません。  
+  
+## クライアント、中継、およびサービスによって記録されたメッセージの表示  
+ 環境には、クライアント、クライアントからメッセージが送信される中継、中継からさらにメッセージが転送されるサービスが含まれることがあります。これら 3 つの場所すべてでメッセージのログ記録が有効になっており、3 つのメッセージ ログをすべて同時に[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) に表示した場合、メッセージ ログ交換は正しく表示されません。これは、メッセージ ヘッダーの `CorrelationId` と `ActivityId` が、すべての送受信ペアで一意にならなくなるためです。  
+  
+ この問題を解決するには、次のいずれかの方法に従います。  
+  
+-   [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) では、常に 3 つのメッセージ ログのうち 2 つだけを表示します。  
+  
+-   3 つのログすべてを[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) で同時に表示する必要がある場合は、新規の <xref:System.ServiceModel.Channels.Message> インスタンスを作成して中継サービスを変更できます。このインスタンスは、受信メッセージの本文のコピーであり、また、`ActivityId` ヘッダーおよび `Action` ヘッダーを除くすべてのヘッダーのコピーであることが必要です。これを実行する方法を次のコード例に示します。  
+  
+```  
+Message outgoingMessage = Message.CreateMessage(incomingMessage.Version, incomingMessage.Headers.Action, incomingMessage.GetReaderAtBodyContents());  
+  
+for (int i = 0; i < incomingMessage.Headers.Count; i++)  
+{  
+   if (incomingMessage.Headers[i].Name.Equals("ActivityId", StringComparison.InvariantCultureIgnoreCase) ||  
+incomingMessage.Headers[i].Name.Equals("Action", StringComparison.InvariantCultureIgnoreCase))  
+   {  
+      continue;  
+    }  
+    outgoingMessage.Headers.CopyHeaderFrom(incomingMessage, i);  
+}  
+```  
+  
+## メッセージ ログ内容が不正確になる例外的なケース  
+ 次の条件では、ログ記録されたメッセージがネットワーク上にあるオクテット ストリームの正確な表現とはならない場合があります。  
+  
+-   BasicHttpBinding の場合、エンベロープ ヘッダーは \/addressing\/none 名前空間の受信メッセージについてログ記録されます。  
+  
+-   空白に不一致が生じる場合があります。  
+  
+-   受信メッセージの場合、空の要素が異なる表現になる場合があります。たとえば、\<tag\/\> ではなく \<tag\>\<\/tag\> となることがあります。  
+  
+-   既知の PII ログ記録が、既定または enableLoggingKnownPii\="true" という明示的な設定で、無効になっている場合。  
+  
+-   UTF\-8 へ変換するためのエンコードが有効な場合。  
+  
+## 参照  
+ [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)   
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [メッセージ ログ](../../../../docs/framework/wcf/diagnostics/message-logging.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/TOC.md b/docs/framework/wcf/diagnostics/wmi/TOC.md
new file mode 100644
index 00000000000..929716da0a2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/TOC.md
@@ -0,0 +1,77 @@
+# [エンドポイント](endpoint.md)
+# [診断用の WMI (Windows Management Instrumentation) の使用](index.md)
+# [BindingElement](bindingelement.md)
+# [ActivityTransfer](activitytransfer.md)
+# [ServiceAppDomain](serviceappdomain.md)
+# [ReliableSessionBindingElement](reliablesessionbindingelement.md)
+# [SecurityBindingElement](securitybindingelement.md)
+# [MsmqIntegrationBindingElement](msmqintegrationbindingelement.md)
+# [HttpsTransportBindingElement](httpstransportbindingelement.md)
+# [BinaryMessageEncodingBindingElement](binarymessageencodingbindingelement.md)
+# [CustomBindingElement](custombindingelement.md)
+# [チャネル クラス](channel-class.md)
+# [ChannelPoolSettings](channelpoolsettings.md)
+# [TraceListener](tracelistener.md)
+# [NamedPipeTransportBindingElement](namedpipetransportbindingelement.md)
+# [ConnectionOrientedTransportBindingElement](connectionorientedtransportbindingelement.md)
+# [WMI クラスの参照](wmi-class-reference.md)
+# [TraceListenerArgument](tracelistenerargument.md)
+# [SynchronousReceiveBehavior](synchronousreceivebehavior.md)
+# [SymmetricSecurityBindingElement](symmetricsecuritybindingelement.md)
+# [操作クラス](operation-class.md)
+# [GetOperationCounterInstanceName](getoperationcounterinstancename.md)
+# [コントラクト](contract.md)
+# [ServiceDebugBehavior](servicedebugbehavior.md)
+# [PeerCustomResolverBindingElement](peercustomresolverbindingelement.md)
+# [ServiceCredentials](servicecredentials.md)
+# [XmlDictionaryReaderQuotas](xmldictionaryreaderquotas.md)
+# [WSAT_TraceRecord](wsat-tracerecord.md)
+# [サービス](service.md)
+# [MustUnderstandBehavior](mustunderstandbehavior.md)
+# [WSAT_TraceProvider](wsat-traceprovider.md)
+# [OperationBehaviorAttribute](operationbehaviorattribute.md)
+# [XmlSerializerOperationBehavior](xmlserializeroperationbehavior.md)
+# [TextMessageEncodingBindingElement](textmessageencodingbindingelement.md)
+# [MessageEncodingBindingElement](messageencodingbindingelement.md)
+# [AsymmetricSecurityBindingElement](asymmetricsecuritybindingelement.md)
+# [ServiceAuthorizationBehavior](serviceauthorizationbehavior.md)
+# [動作クラス](behavior-class.md)
+# [AppDomainInfo](appdomaininfo.md)
+# [ServiceBehaviorAttribute](servicebehaviorattribute.md)
+# [OneWayBindingElement](onewaybindingelement.md)
+# [ClientViaBehavior](clientviabehavior.md)
+# [TransportBindingElement](transportbindingelement.md)
+# [MatchAllEndpointBehavior](matchallendpointbehavior.md)
+# [WindowsStreamSecurityBindingElement](windowsstreamsecuritybindingelement.md)
+# [MtomMessageEncodingBindingElement](mtommessageencodingbindingelement.md)
+# [LocalServiceSecuritySettings](localservicesecuritysettings.md)
+# [ServiceTimeoutsBehavior](servicetimeoutsbehavior.md)
+# [CallbackBehavior](callbackbehavior.md)
+# [ClientCredentials](clientcredentials.md)
+# [DeliveryRequirementsAttribute](deliveryrequirementsattribute.md)
+# [PeerTransportBindingElement](peertransportbindingelement.md)
+# [ServiceThrottlingBehavior](servicethrottlingbehavior.md)
+# [PeerResolverBindingElement](peerresolverbindingelement.md)
+# [TcpTransportBindingElement](tcptransportbindingelement.md)
+# [TransportSecurityBindingElement](transportsecuritybindingelement.md)
+# [TransactedBatchingBehavior](transactedbatchingbehavior.md)
+# [ServiceSecurityAuditBehavior](servicesecurityauditbehavior.md)
+# [PeerSecuritySettings](peersecuritysettings.md)
+# [MsmqBindingElementBase](msmqbindingelementbase.md)
+# [PeerTransportSecuritySettings](peertransportsecuritysettings.md)
+# [MsmqTransportBindingElement](msmqtransportbindingelement.md)
+# [TcpConnectionPoolSettings](tcpconnectionpoolsettings.md)
+# [SslStreamSecurityBindingElement](sslstreamsecuritybindingelement.md)
+# [WSAT_TraceEvent](wsat-traceevent.md)
+# [ServiceMetadataBehavior](servicemetadatabehavior.md)
+# [PrivacyNoticeBindingElement](privacynoticebindingelement.md)
+# [TransactionFlowAttribute](transactionflowattribute.md)
+# [TransactionFlowBindingElement](transactionflowbindingelement.md)
+# [バインド](binding.md)
+# [HttpTransportBindingElement](httptransportbindingelement.md)
+# [NamedPipeConnectionPoolSettings](namedpipeconnectionpoolsettings.md)
+# [CompositeDuplexBindingElement](compositeduplexbindingelement.md)
+# [PnrpPeerResolverBindingElement](pnrppeerresolverbindingelement.md)
+# [ServiceToEndpointAssociation](servicetoendpointassociation.md)
+# [UseManagedPresentationBindingElement](usemanagedpresentationbindingelement.md)
+# [AspNetCompatibilityRequirementsAttribute](aspnetcompatibilityrequirementsattribute.md)
diff --git a/docs/framework/wcf/diagnostics/wmi/activitytransfer.md b/docs/framework/wcf/diagnostics/wmi/activitytransfer.md
new file mode 100644
index 00000000000..058d873456f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/activitytransfer.md
@@ -0,0 +1,56 @@
+---
+title: "ActivityTransfer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc40ef17-2a92-4ce2-853c-6ba8e5d571f3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ActivityTransfer
+アクティビティ転送イベント  
+  
+## 構文  
+  
+```  
+class ActivityTransfer : WSAT_TraceEvent  
+{  
+  object ActivityID;  
+  object RelatedActivityID;  
+};  
+```  
+  
+## メソッド  
+ ActivityTransfer クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ActivityTransfer クラスには次のプロパティがあります。  
+  
+### ActivityID  
+  
+-   データ型: object                   
+     アクセスの種類 : 読み取り専用  
+  
+-   アクティビティ ID  
+  
+### RelatedActivityID  
+  
+-   データ型: object                   
+     アクセスの種類 : 読み取り専用  
+  
+-   関連アクティビティ ID  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/appdomaininfo.md b/docs/framework/wcf/diagnostics/wmi/appdomaininfo.md
new file mode 100644
index 00000000000..f3ecfd6f390
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/appdomaininfo.md
@@ -0,0 +1,136 @@
+---
+title: "AppDomainInfo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6610b7d8-81eb-4bec-a543-9b72ad7b6f73
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# AppDomainInfo
+アプリケーション ドメイン情報  
+  
+## 構文  
+  
+```  
+class AppDomainInfo  
+{  
+  sint32 AppDomainId;  
+  boolean IsDefault;  
+  boolean LogMalformedMessages;  
+  boolean LogMessagesAtServiceLevel;  
+  boolean LogMessagesAtTransportLevel;  
+  TraceListener MessageLoggingTraceListeners[];  
+  string Name;  
+  string PerformanceCounters;  
+  sint32 ProcessId;  
+  string ServiceConfigPath;  
+  string TraceLevel;  
+  TraceListener wmiTraceListeners[];  
+};  
+```  
+  
+## メソッド  
+ AppDomainInfo クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ AppDomainInfo クラスには、次のプロパティがあります。  
+  
+### AppDomainId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ AppDomain の ID です。  
+  
+### IsDefault  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ AppDomain が既定の AppDomain かどうかを示します。  
+  
+### LogMalformedMessages  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り\/書き込み  
+  
+ 非整形式メッセージをログに記録するかどうかを指定する値です。  
+  
+### LogMessagesAtServiceLevel  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り\/書き込み  
+  
+ メッセージをサービス レベルでトレースするかどうかを指定する値です \(暗号化およびトランスポート関連の変換前\)。  
+  
+### LogMessagesAtTransportLevel  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り\/書き込み  
+  
+ メッセージをトランスポート レベルでトレースするかどうかを指定する値です。  
+  
+### MessageLoggingTraceListeners  
+ データ型 : TraceListener 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ System.Wmi.MessageLogging トレース ソースをリッスンするコレクション トレース リスナーです。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ AppDomain の名前です。  
+  
+### PerformanceCounters  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ AppDomain におけるアクティブなパフォーマンス カウンターのスコープです。  
+  
+### ProcessId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ プロセス ID です。  
+  
+### ServiceConfigPath  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスの構成へのパスです。  
+  
+### TraceLevel  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り\/書き込み  
+  
+ System.Wmi トレース ソースのトレース レベル。  
+  
+### ServiceModelTraceListeners  
+ データ型 : TraceListener 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ System.ServiceModel トレース ソースのリスナーのコレクション。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/aspnetcompatibilityrequirementsattribute.md b/docs/framework/wcf/diagnostics/wmi/aspnetcompatibilityrequirementsattribute.md
new file mode 100644
index 00000000000..e15a0afffe2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/aspnetcompatibilityrequirementsattribute.md
@@ -0,0 +1,51 @@
+---
+title: "AspNetCompatibilityRequirementsAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00908a39-a21b-4029-bbb9-33e5a6ed25a7
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# AspNetCompatibilityRequirementsAttribute
+AspNetCompatibilityRequirementsAttribute  
+  
+## 構文  
+  
+```  
+class AspNetCompatibilityRequirementsAttribute : Behavior  
+{  
+  string RequirementsMode;  
+};  
+```  
+  
+## メソッド  
+ AspNetCompatibilityRequirementsAttribute クラスは、メソッドをすべて定義しません。  
+  
+## プロパティ  
+ AspNetCompatibilityRequirementsAttribute クラスには、次のプロパティがあります。  
+  
+### RequirementsMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ Asp.Net 互換モードがアクティブであるかどうかを示します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceHostingEnvironment.AspNetCompatibilityEnabled%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/asymmetricsecuritybindingelement.md b/docs/framework/wcf/diagnostics/wmi/asymmetricsecuritybindingelement.md
new file mode 100644
index 00000000000..2d97ae04fac
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/asymmetricsecuritybindingelement.md
@@ -0,0 +1,59 @@
+---
+title: "AsymmetricSecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7bd3b6be-8f77-4927-93ae-6fa371893cca
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# AsymmetricSecurityBindingElement
+AsymmetricSecurityBindingElement  
+  
+## 構文  
+  
+```  
+class AsymmetricSecurityBindingElement : SecurityBindingElement  
+{  
+  string MessageProtectionOrder;  
+  boolean RequireSignatureConfirmation;  
+};  
+```  
+  
+## メソッド  
+ AsymmetricSecurityBindingElement クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ AsymmetricSecurityBindingElement クラスには、次のプロパティがあります。  
+  
+### MessageProtectionOrder  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングのメッセージの暗号化と署名の命令。  
+  
+### RequireSignatureConfirmation  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングで署名の確認が必要かどうか。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/behavior-class.md b/docs/framework/wcf/diagnostics/wmi/behavior-class.md
new file mode 100644
index 00000000000..63189fbcd2b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/behavior-class.md
@@ -0,0 +1,49 @@
+---
+title: "動作クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75d117f5-87f9-40fb-84c6-9e2fef6da6af
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 動作クラス
+## 構文  
+  
+```  
+class Behavior  
+{  
+  string Type;  
+};  
+```  
+  
+## メソッド  
+ Behavior クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ Behavior クラスには、次のプロパティがあります。  
+  
+### Type  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 動作の種類です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/binarymessageencodingbindingelement.md b/docs/framework/wcf/diagnostics/wmi/binarymessageencodingbindingelement.md
new file mode 100644
index 00000000000..11356d27be6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/binarymessageencodingbindingelement.md
@@ -0,0 +1,75 @@
+---
+title: "BinaryMessageEncodingBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2bb3cdd-3bbd-4bb5-85fe-570457500a66
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# BinaryMessageEncodingBindingElement
+BinaryMessageEncodingBindingElement  
+  
+## 構文  
+  
+```  
+class BinaryMessageEncodingBindingElement : MessageEncodingBindingElement  
+{  
+  sint32 MaxReadPoolSize;  
+  sint32 MaxSessionSize;  
+  sint32 MaxWritePoolSize;  
+  XmlDictionaryReaderQuotas ReaderQuotas;  
+};  
+```  
+  
+## メソッド  
+ BinaryMessageEncodingBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ BinaryMessageEncodingBindingElement クラスには、次のプロパティがあります。  
+  
+## MaxReadPoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を定義する整数です。  
+  
+## MaxSessionSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンコーディングに使用するバッファーのサイズ \(バイト単位\) を指定する値です。  
+  
+## MaxWritePoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいライターを割り当てずに同時に送信可能なメッセージの数を定義する整数です。  
+  
+## ReaderQuotas  
+ データ型 : XmlDictionaryReaderQuotas  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リーダのクォータ。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/binding.md b/docs/framework/wcf/diagnostics/wmi/binding.md
new file mode 100644
index 00000000000..ad8be1b6020
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/binding.md
@@ -0,0 +1,107 @@
+---
+title: "バインド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09511c6c-5749-4bb0-874e-0f0be36bfe04
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# バインド
+wmi バインディング  
+  
+## 構文  
+  
+```  
+class Binding  
+{  
+  BindingElement BindingElements[];  
+  datetime CloseTimeout;  
+  string Name;  
+  string Namespace;  
+  datetime OpenTimeout;  
+  datetime ReceiveTimeout;  
+  string Scheme;  
+  datetime SendTimeout;  
+};  
+```  
+  
+## メソッド  
+ Binding クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ Binding クラスには、次のプロパティがあります。  
+  
+### BindingElements  
+ データ型 : BindingElement 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングによって実装されるバインド要素のコレクションです。  
+  
+### CloseTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クローズ操作が完了するまで待機する時間です。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングの名前。  
+  
+### 名前空間  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングの XML 名前空間。  
+  
+### OpenTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ オープン操作が完了するまで待機する時間です。  
+  
+### ReceiveTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 受信操作が完了するまで待機する時間です。  
+  
+### Scheme  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングに組み込まれているチャネルおよびリスナー ファクトリによって使用される URI トランスポート スキームです。  
+  
+### SendTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 送信操作が完了するまで待機する時間です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/bindingelement.md b/docs/framework/wcf/diagnostics/wmi/bindingelement.md
new file mode 100644
index 00000000000..d5fffc1b2f8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/bindingelement.md
@@ -0,0 +1,40 @@
+---
+title: "BindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fdbfde0c-2e52-4fc5-9eb8-14b42e647263
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# BindingElement
+BindingElement  
+  
+## 構文  
+  
+```  
+class BindingElement  
+{  
+};  
+```  
+  
+## メソッド  
+ BindingElement クラスはメソッドを継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/callbackbehavior.md b/docs/framework/wcf/diagnostics/wmi/callbackbehavior.md
new file mode 100644
index 00000000000..06d635a7747
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/callbackbehavior.md
@@ -0,0 +1,98 @@
+---
+title: "CallbackBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42acd302-2b62-4849-a2d1-a03084343ecd
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# CallbackBehavior
+CallbackBehavior  
+  
+## 構文  
+  
+```  
+class CallbackBehavior : Behavior  
+{  
+  boolean AutomaticSessionShutdown;  
+  string ConcurrencyMode;  
+  boolean IgnoreExtensionDataObject;  
+  boolean IncludeExceptionDetailInFaults;  
+  boolean MaxItemsInObjectGraph;  
+  boolean UseSynchronizationContext;  
+  boolean ValidateMustUnderstand;  
+};  
+```  
+  
+## メソッド  
+ CallbackBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ CallbackBehavior クラスには、次のプロパティがあります。  
+  
+### AutomaticSessionShutdown  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ true の場合、サービスが双方向セッションを閉じると、セッションが自動的に閉じられます。  
+  
+### ConcurrencyMode  
+ データ型: string  
+アクセスの種類 : 読み取り専用  
+  
+ サービスが単一のスレッド、複数のスレッド、再入可能呼び出しのいずれをサポートするかを指定します。  
+  
+### IgnoreExtensionDataObject  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 不明なシリアル化データをネットワークで送信するかどうかを指定する値です。  
+  
+### IncludeExceptionDetailInFaults  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 有効にした場合は、コールバックの例外に関する詳細情報が、サービスに戻されるエラーに添付されます。  
+  
+### MaxItemsInObjectGraph  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 1 つのシリアル化されたオブジェクトで許可される項目の最大数。  
+  
+### UseSynchronizationContext  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在の同期コンテキストを使用して実行のスレッドを選択するかどうかを指定します。  
+  
+### ValidateMustUnderstand  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ システムまたはアプリケーションで SOAP MustUnderstand ヘッダー処理を強制的に行うかどうかを指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.CallbackBehaviorAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/channel-class.md b/docs/framework/wcf/diagnostics/wmi/channel-class.md
new file mode 100644
index 00000000000..fca645a805a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/channel-class.md
@@ -0,0 +1,83 @@
+---
+title: "チャネル クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9fae2ca-209c-4341-a0f5-6b79d1a67776
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# チャネル クラス
+チャネル  
+  
+## 構文  
+  
+```  
+class Channel  
+{  
+  string LocalAddress;  
+  Endpoint ref;  
+  string RemoteAddress;  
+  string SessionId;  
+  string Type;  
+};  
+```  
+  
+## メソッド  
+ チャネル クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ チャネル クラスには、次のプロパティがあります。  
+  
+### LocalAddress  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルのローカル エンドポイント。  
+  
+### ref  
+ データ型 : Endpoint  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルが接続するエンドポイントへの参照。  
+  
+### RemoteAddress  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルに関連するリモート アドレス。  
+  
+### SessionId  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在のセッション ID \(存在する場合\)。  
+  
+### 種類  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルの型。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.ChannelBase>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/channelpoolsettings.md b/docs/framework/wcf/diagnostics/wmi/channelpoolsettings.md
new file mode 100644
index 00000000000..406fb2074a2
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/channelpoolsettings.md
@@ -0,0 +1,67 @@
+---
+title: "ChannelPoolSettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d3f475bd-f780-4bbe-b291-339387322964
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ChannelPoolSettings
+ChannelPoolSettings  
+  
+## 構文  
+  
+```  
+class ChannelPoolSettings  
+{  
+  datetime IdleTimeout;  
+  datetime LeaseTimeout;  
+  sint32 MaxOutboundChannelsPerEndpoint;  
+};  
+```  
+  
+## メソッド  
+ ChannelPoolSettings クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ChannelPoolSettings クラスには、次のプロパティがあります。  
+  
+### IdleTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続が切断されるまでの最大アイドル時間。  
+  
+### LeaseTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リース操作の完了がタイムアウトするまでの最大時間。  
+  
+### MaxOutboundChannelsPerEndpoint  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 各エンドポイントでの送信チャネルの最大数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.ChannelPoolSettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/clientcredentials.md b/docs/framework/wcf/diagnostics/wmi/clientcredentials.md
new file mode 100644
index 00000000000..ab7bcd62a9c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/clientcredentials.md
@@ -0,0 +1,107 @@
+---
+title: "ClientCredentials | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 41dffd6b-8f14-4fed-aefb-2a1bb168efb3
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ClientCredentials
+ClientCredentials  
+  
+## 構文  
+  
+```  
+class ClientCredentials : Behavior  
+{  
+  string ClientCertificate;  
+  string HttpDigest;  
+  string IssuedToken;  
+  string Peer;  
+  string ServiceCertificate;  
+  boolean SupportInteractive;  
+  string UserName;  
+  string Windows;  
+};  
+```  
+  
+## メソッド  
+ ClientCredentials クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ClientCredentials クラスには、次のプロパティがあります。  
+  
+### ClientCertificate  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントがサービスに対して自身を認証するために使用する X.509 証明書です。  
+  
+### HttpDigest  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在の Http ダイジェスト資格情報です。  
+  
+### IssuedToken  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ローカル セキュリティ トークン サービスにアクセスするために使用されるエンドポイント アドレスおよびバインディングです。  
+  
+### Peer  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア ノードがメッシュ内の他のノードに対して自身を認証するために使用する資格情報です。  
+  
+### ServiceCertificate  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスの X.509 証明書です。  
+  
+### SupportInteractive  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 資格情報が対話的なネゴシエーションをサポートしているかどうかを指定するブール値です。  
+  
+### UserName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントがサービスに対して自身を認証するために使用するユーザー名とパスワードです。  
+  
+### Windows  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントがサービスに対して自身を認証するために使用する Windows 資格情報です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ClientCredentials>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/clientviabehavior.md b/docs/framework/wcf/diagnostics/wmi/clientviabehavior.md
new file mode 100644
index 00000000000..91b33d64644
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/clientviabehavior.md
@@ -0,0 +1,51 @@
+---
+title: "ClientViaBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 594f6046-4752-4a54-9374-b256f8dd1431
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ClientViaBehavior
+ClientViaBehavior  
+  
+## 構文  
+  
+```  
+class ClientViaBehavior : Behavior  
+{  
+  string Uri;  
+};  
+```  
+  
+## メソッド  
+ ClientViaBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ClientViaBehavior クラスには、次のプロパティがあります。  
+  
+### Uri  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ViaUri。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ClientViaBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/compositeduplexbindingelement.md b/docs/framework/wcf/diagnostics/wmi/compositeduplexbindingelement.md
new file mode 100644
index 00000000000..f3264f33a3c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/compositeduplexbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "CompositeDuplexBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05e985aa-6462-431d-a831-0d601f3a3835
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# CompositeDuplexBindingElement
+CompositeDuplexBindingElement  
+  
+## 構文  
+  
+```  
+class CompositeDuplexBindingElement : BindingElement  
+{  
+  string ClientBaseAddress;  
+};  
+```  
+  
+## メソッド  
+ CompositeDuplexBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ CompositeDuplexBindingElement クラスには、次のプロパティがあります。  
+  
+### ClientBaseAddress  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントのベース アドレスです。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/connectionorientedtransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/connectionorientedtransportbindingelement.md
new file mode 100644
index 00000000000..def71f4613f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/connectionorientedtransportbindingelement.md
@@ -0,0 +1,107 @@
+---
+title: "ConnectionOrientedTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1308313-f0e2-49e6-977d-6b4ce9ad35d1
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ConnectionOrientedTransportBindingElement
+ConnectionOrientedTransportBindingElement  
+  
+## 構文  
+  
+```  
+class ConnectionOrientedTransportBindingElement : TransportBindingElement  
+{  
+  datetime ChannelInitializationTimeout;  
+  sint32 ConnectionBufferSize;  
+  string HostNameComparisonMode;  
+  sint32 MaxBufferSize;  
+  datetime MaxOutputDelay;  
+  sint32 MaxPendingAccepts;  
+  sint32 MaxPendingConnections;  
+  string TransferMode;  
+};  
+```  
+  
+## メソッド  
+ ConnectionOrientedTransportBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ ConnectionOrientedTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### ChannelInitializationTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルの初期化が開始されてからタイムアウトになるまでの時間の長さを示す期間。  
+  
+### ConnectionBufferSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントまたサービスからネットワークでシリアル化されたメッセージのチャンクを転送するために使用されるバッファーのサイズ。  
+  
+### HostNameComparisonMode  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ URI の照合時にサービスに到達するため、ホスト名が使用されたかどうかを示す値。  
+  
+### MaxBufferSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 使用するバッファーの最大サイズ。  
+  
+### MaxOutputDelay  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージのチャンクまたは完全なメッセージを、送信前にメモリ内のバッファーに残したままにできる最長期間。  
+  
+### MaxPendingAccepts  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスでの着信接続処理に使用できる保留中の非同期受け入れスレッドの最大数。  
+  
+### MaxPendingConnections  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 保留状態の接続の最大数。  
+  
+### TransferMode  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続指向トランスポートを使用して、メッセージをバッファーするかまたはストリームするかを指定する値。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/contract.md b/docs/framework/wcf/diagnostics/wmi/contract.md
new file mode 100644
index 00000000000..e1f693d9b78
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/contract.md
@@ -0,0 +1,115 @@
+---
+title: "コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa00f6b3-7e1f-4213-841a-206463fca20b
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# コントラクト
+Contract  
+  
+## 構文  
+  
+```  
+class Contract  
+{  
+  sint32 AppDomainId;  
+  Behavior Behaviors[];  
+  string Name;  
+  string Namespace;  
+  Operation Operations[];  
+  sint32 ProcessId;  
+  Contract ref;  
+  string SessionMode;  
+  string Type;  
+};  
+```  
+  
+## メソッド  
+ Contract クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ Contract クラスには、次のプロパティがあります。  
+  
+### AppDomainId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ コントラクトをホストする appdomain の appdomain ID。  
+  
+### Behaviors  
+ データ型 : Behavior 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このコントラクトに関連付けられている動作。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ WSDL でのコントラクトの名前。  
+  
+### Namespace  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ WSDL での `portType` 要素の名前空間。  
+  
+### Operations  
+ データ型 : Operation 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このコントラクトの操作。  
+  
+### ProcessId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ コントラクトをホストするプロセスのプロセス ID。  
+  
+### ref  
+ データ型 : Contract  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ コントラクトが双方向コントラクトのときのコールバックの型。  
+  
+### SessionMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ コントラクトでチャネル セッションを使用するために、このコントラクトに関連付けられたバインディングが必要かどうかを示します。  
+  
+### Type  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ コントラクトの型。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ContractDescription>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/custombindingelement.md b/docs/framework/wcf/diagnostics/wmi/custombindingelement.md
new file mode 100644
index 00000000000..b3c18ac8bd5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/custombindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "CustomBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: df959dc5-1aef-4338-a123-6ff3e7bc37af
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# CustomBindingElement
+CustomBindingElement  
+  
+## 構文  
+  
+```  
+class CustomBindingElement : BindingElement  
+{  
+  string Name;  
+};  
+```  
+  
+## メソッド  
+ CustomBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ CustomBindingElement クラスには、次のプロパティがあります。  
+  
+### 名前  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングの構成名を格納する文字列です。  この値は、カスタム バインディングの識別文字列として機能するユーザー定義文字列です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.CustomBinding>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/deliveryrequirementsattribute.md b/docs/framework/wcf/diagnostics/wmi/deliveryrequirementsattribute.md
new file mode 100644
index 00000000000..5d9579ce5b5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/deliveryrequirementsattribute.md
@@ -0,0 +1,67 @@
+---
+title: "DeliveryRequirementsAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40c5435c-a325-4cf8-9dd0-d6e24b4a56a3
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# DeliveryRequirementsAttribute
+DeliveryRequirementsAttribute  
+  
+## 構文  
+  
+```  
+class DeliveryRequirementsAttribute : Behavior  
+{  
+  string QueuedDeliveryRequirements;  
+  boolean RequireOrderedDelivery;  
+  string TargetContract;  
+};  
+```  
+  
+## メソッド  
+ DeliveryRequirementsAttribute クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ DeliveryRequirementsAttribute クラスには、次のプロパティがあります。  
+  
+### QueuedDeliveryRequirements  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスのバインドがコントラクトをサポートするかどうかを指定します。  
+  
+### RequireOrderedDelivery  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングが順序付きメッセージをサポートするかどうかを指定します。  
+  
+### TargetContract  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 適用先となるコントラクトです。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.DeliveryRequirementsAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/endpoint.md b/docs/framework/wcf/diagnostics/wmi/endpoint.md
new file mode 100644
index 00000000000..882eb90d648
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/endpoint.md
@@ -0,0 +1,140 @@
+---
+title: "エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe63370d-81a1-40f3-97c2-59cb357c78d2
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# エンドポイント
+エンドポイント  
+  
+## 構文  
+  
+```  
+class Endpoint  
+{  
+  string Address;  
+  string AddressHeaders[];  
+  string AddressIdentity;  
+  sint32 AppDomainId;  
+  Behavior Behaviors[];  
+  Binding Binding;  
+  string ContractName;  
+  string CounterInstanceName;  
+  string ListenUri;  
+  string Name;  
+  sint32 ProcessId;  
+  Contract ref;  
+};  
+```  
+  
+## メソッド  
+ Endpoint クラスは次のメソッドを定義します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|[GetOperationCounterInstanceName](../../../../../docs/framework/wcf/diagnostics/wmi/getoperationcounterinstancename.md)|操作パフォーマンス カウンターのインスタンスの名前を取得します。|  
+  
+## プロパティ  
+ Endpoint クラスには次のプロパティがあります。  
+  
+### Address  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントのアドレスを格納している URI。  
+  
+### AddressHeaders  
+ データ型 : string array  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントに接続しているアドレス ヘッダーのコレクション  
+  
+### AddressIdentity  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントの ID  
+  
+### AppDomainId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントをホストする appdomain の appdomain ID  
+  
+### ビヘイビアー  
+ データ型 : Behavior array  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントが実装する動作のコレクション  
+  
+### バインディング  
+ データ型 : Binding  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントが使用するバインディング  
+  
+### ContractName  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントが公開するコントラクトを指定する文字列  
+  
+### CounterInstanceName  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントのパフォーマンス カウンターのインスタンス名  
+  
+### ListenUri  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントがリッスンする URI  
+  
+### 名前  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントの一意の名前  
+  
+### ProcessId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ エンドポイントをホストするプロセスのプロセス ID  
+  
+### ref  
+ データ型 : Contract  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このエンドポイントが公開しているコントラクト。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/getoperationcounterinstancename.md b/docs/framework/wcf/diagnostics/wmi/getoperationcounterinstancename.md
new file mode 100644
index 00000000000..1ee6170991b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/getoperationcounterinstancename.md
@@ -0,0 +1,39 @@
+---
+title: "GetOperationCounterInstanceName | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac42e20f-63c1-4bdb-8660-736980936811
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# GetOperationCounterInstanceName
+操作パフォーマンス カウンターのインスタンスの名前を取得します。  
+  
+## 構文  
+  
+```  
+string GetOperationCounterInstanceName(  
+  string Operation  
+);  
+```  
+  
+## パラメーター  
+  
+### Operation  
+ \[in\] string  
+  
+## 必要条件  
+  
+|MOF|Servicemodel.mof で宣言|  
+|---------|--------------------------|  
+|名前空間|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/httpstransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/httpstransportbindingelement.md
new file mode 100644
index 00000000000..57ead962006
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/httpstransportbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "HttpsTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e78aa8c6-b53b-4105-a900-d3e7a39670f2
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# HttpsTransportBindingElement
+HttpsTransportBindingElement  
+  
+## 構文  
+  
+```  
+class HttpsTransportBindingElement : HttpTransportBindingElement  
+{  
+  boolean RequireClientCertificate;  
+};  
+```  
+  
+## メソッド  
+ HttpsTransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ HttpsTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### RequireClientCertificate  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ SSL クライアント認証が必要かどうかを示す値。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/httptransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/httptransportbindingelement.md
new file mode 100644
index 00000000000..26a5aa56f2f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/httptransportbindingelement.md
@@ -0,0 +1,139 @@
+---
+title: "HttpTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 088a7bce-6bb2-4839-ad74-f68d4b1aa0f9
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# HttpTransportBindingElement
+HttpTransportBindingElement  
+  
+## 構文  
+  
+```  
+class HttpTransportBindingElement : TransportBindingElement  
+{  
+  boolean AllowCookies;  
+  string AuthenticationScheme;  
+  boolean BypassProxyOnLocal;  
+  string HostNameComparisonMode;  
+  boolean KeepAliveEnabled;  
+  sint32 MaxBufferSize;  
+  string ProxyAddress;  
+  string ProxyAuthenticationScheme;  
+  string Realm;  
+  string TransferMode;  
+  boolean UnsafeConnectionNtlmAuthentication;  
+  boolean UseDefaultWebProxy;  
+};  
+```  
+  
+## メソッド  
+ HttpTransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ HttpTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### AllowCookies  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントがクッキーを受け入れて、それらを今後の要求に反映させるかどうかを指定する値です。  
+  
+### AuthenticationScheme  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTP リスナーにより処理されているクライアント要求の認証に使用する認証方式です。  
+  
+### BypassProxyOnLocal  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ プロキシをローカル アドレスで無視するかどうかを示す値です。  
+  
+### HostNameComparisonMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ URI の照合時にサービスに到達するため、ホスト名が使用されたかどうかを示す値。  
+  
+### KeepAliveEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 有効な場合は、HTTP 接続がアクティビティ レベルとは無関係に維持されます。  
+  
+### MaxBufferSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バッファー プールの最大サイズ。  
+  
+### ProxyAddress  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTP 要求に使用するプロキシのアドレスを格納する URI です。  
+  
+### ProxyAuthenticationScheme  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTP プロキシにより処理されているクライアント要求の認証に使用する認証方式です。  
+  
+### Realm  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 認証レルム。  
+  
+### TransferMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージが要求や応答をバッファーするか、ストリーミングするかを指定する値です。  
+  
+### UnsafeConnectionNtlmAuthentication  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サーバー上で安全ではない接続共有を有効にするかどうかを示す値です。  
+  
+### UseDefaultWebProxy  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ユーザー固有の設定ではなく、コンピューター全体のプロキシ設定を使用するかどうかを示す値です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/index.md b/docs/framework/wcf/diagnostics/wmi/index.md
new file mode 100644
index 00000000000..417e14405b7
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/index.md
@@ -0,0 +1,191 @@
+---
+title: "診断用の WMI (Windows Management Instrumentation) の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe48738d-e31b-454d-b5ec-24c85c6bf79a
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 診断用の WMI (Windows Management Instrumentation) の使用
+[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] は [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] WMI \(Windows Management Instrumentation\) プロバイダーを介して実行時のサービスの検査データを公開します。  
+  
+## WMI の有効化  
+ WMI は、Web ベースのエンタープライズ管理 \(WBEM\) 標準をマイクロソフトが実装したものです。  WMI SDK [!INCLUDE[crabout](../../../../../includes/crabout-md.md)]、MSDN ライブラリを参照してください。  \(http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/wmisdk\/wmi\/wmi\_start\_page.asp\).  WBEM は、アプリケーションが Management Instrumentation を外部管理ツールに開示する業界標準の方法です。  
+  
+ WMI プロバイダーは、WBEM と互換性のあるインターフェイスを通して実行時にインストルメンテーションを公開するコンポーネントです。  これは、属性と値のペアを持つ WMI オブジェクトのセットで構成されます。  ペアには多くの単純型を指定できます。  管理ツールは、実行時にインターフェイスを介してサービスに接続できます。  [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、アドレス、バインディング、動作、リスナーなどのサービスの属性を公開します。  
+  
+ 組み込みの WMI プロバイダーは、アプリケーションの構成ファイルでアクティブにできます。  次のサンプル構成に示すように、これは [\<system.serviceModel\>](../../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)セクションにある [\<diagnostics\>](../../../../../docs/framework/configure-apps/file-schema/wcf/diagnostics.md)の `wmiProviderEnabled` 属性を介して実行されます。  
+  
+```  
+<system.serviceModel>  
+    …  
+    <diagnostics wmiProviderEnabled="true" />  
+    …  
+</system.serviceModel>  
+  
+```  
+  
+ この構成エントリには、WMI インターフェイスが開示されます。  管理アプリケーションはこのインターフェイスを通して接続し、アプリケーションの Management Instrumentation にアクセスできるようになります。  
+  
+## WMI データへのアクセス  
+ WMI データには、複数の異なる方法でアクセスできます。  マイクロソフトは、スクリプト用、[!INCLUDE[vbprvb](../../../../../includes/vbprvb-md.md)] アプリケーション用、C\+\+ アプリケーション用、および [!INCLUDE[dnprdnshort](../../../../../includes/dnprdnshort-md.md)] 用の WMI API を提供しています。  詳細については、「[WMI の使用](http://go.microsoft.com/fwlink/?LinkId=95183)」を参照してください。  
+  
+> [!CAUTION]
+>  .NET Framework 提供のメソッドを使用し、プログラムで WMI データにアクセスする場合、そのようなメソッドは接続確立時に例外をスローする場合があることを認識しておく必要があります。  接続は、<xref:System.Management.ManagementObject> インスタンスの構築中に確立されませんが、実際のデータ交換が含まれた最初の要求時に確立されます。  したがって、`try..catch` ブロックを使用して例外をキャッチする必要があります。  
+  
+ トレース レベルやメッセージ ログ レベルだけでなく、WMI の `System.ServiceModel` トレース ソースのメッセージ ログ オプションも変更できます。  変更するには、`LogMessagesAtServiceLevel`、`LogMessagesAtTransportLevel`、`LogMalformedMessages`、および `TraceLevel` のブール型プロパティを公開する [AppDomainInfo](../../../../../docs/framework/wcf/diagnostics/wmi/appdomaininfo.md) インスタンスにアクセスします。  そのため、メッセージ ログ用のトレース リスナーを構成していても、これらのオプションを構成で `false` に設定している場合は、後でアプリケーションを実行しているときに `true` に変更できます。  これで、メッセージ ログが実行時に有効になります。  同様に、構成ファイルでメッセージ ログを有効にしている場合は、実行時に WMI を使用して無効にできます。  
+  
+ 構成ファイルで、メッセージ ログのメッセージ ログ トレース リスナーまたはトレースの `System.ServiceModel` トレース リスナーが指定されていない場合、WMI が変更を受け入れても変更は有効になりません。  各リスナーの正しい設定の詳細については、「[メッセージ ログの構成](../../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)」および「[トレースの構成](../../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」を参照してください。  構成で設定された他のすべてのトレース ソースのトレース レベルは、アプリケーションが開始されると有効になり変更できません。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] は、スクリプト用に `GetOperationCounterInstanceName` メソッドを公開します。  このメソッドに操作名を指定した場合、このメソッドはパフォーマンス カウンターのインスタンス名を返します。  ただし、このメソッドは入力を検証しません。  したがって、正しくない操作名を指定した場合、正しくないカウンター名が返されます。  
+  
+ 接続先サービスの `OutgoingChannel` クライアントが `Service` メソッド内に作成されていない場合、[!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] インスタンスの `Service` プロパティは、別のサービスに接続するのに、そのサービスにより開かれたチャネルをカウントしません。  
+  
+ **注意 :** WMI は <xref:System.TimeSpan> 値を小数点以下 3 桁までしかサポートしません。  たとえば、サービスでプロパティの 1 つを <xref:System.TimeSpan.MaxValue> に設定した場合、WMI ではその値を小数点以下 3 桁より下を切り捨て表示します。  
+  
+## セキュリティ  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] WMI プロバイダーは環境内のサービスの検索を許しているため、環境へのアクセスの許可については十分に注意する必要があります。  既定の "管理者のみ" のアクセスを緩めた場合、信頼性の低いパーティに環境内の機密性のあるデータへのアクセスを許可する場合があります。  特にリモート WMI アクセスに対するアクセス許可を緩めた場合、大量の攻撃を受ける可能性があります。  過剰の WMI 要求により大量の処理が発生した場合、パフォーマンスが低下する可能性があります。  
+  
+ さらに、MOF ファイルに対するアクセス許可を緩めた場合、信頼性の低いパーティが WMI の動作を操作して WMI スキーマに読み込まれるオブジェクトを変更することができます。  たとえば、フィールドを削除して、重要データを管理者から隠したり、例外を設定しないかまたは例外の原因とならないフィールドを追加したりすることができます。  
+  
+ [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] WMI プロバイダーの既定では、"メソッドの実行"、"プロバイダーによる書き込み"、"アカウントの有効化" 権限が管理者に付与され、"アカウントの有効化" 権限が ASP.NET、ローカル サービス、ネットワーク サービスに付与されます。  特に、[!INCLUDE[wv](../../../../../includes/wv-md.md)] 以外のプラットフォームでは、ASP.NET アカウントは WMI ServiceModel 名前空間に対して読み取りアクセスが可能です。  特定のユーザー グループに対してこれらの権限を付与したくない場合は、WMI プロバイダーを非アクティブにするか \(既定では無効に設定されています\)、特定のユーザー グループのアクセスを無効にする必要があります。  
+  
+ また、構成を使用して WMI を有効にする場合、ユーザー権限が不十分のため WMI が有効にならない場合があります。  ただし、このエラーを記録するイベントはイベント ログに書き込まれません。  
+  
+ ユーザー権限のレベルを変更するには、次の手順に従います。  
+  
+1.  \[スタート\] ボタンをクリックし、\[ファイル名を指定して実行\] をクリックして**「compmgmt.msc」**と入力します。  
+  
+2.  **\[サービスとアプリケーション\] の \[WMI コントロール\]** を右クリックして、**\[プロパティ\]** をクリックします。  
+  
+3.  **\[セキュリティ\]** タブを選択し、**\[Root\/ServiceModel\]** 名前空間に移動します。  **\[セキュリティ\]** ボタンをクリックします。  
+  
+4.  アクセスを制御するグループまたはユーザーを選択し、**\[許可\]** または **\[拒否\]** チェックボックスを使用してアクセス許可を構成します。  
+  
+## 追加ユーザーへの WCF WMI 登録権限の付与  
+ WCF は管理データを WMI に公開します。  これはインプロセス WMI プロバイダーをホストすることによって行い、"分離プロバイダー" と呼ばれることもあります。  管理データを公開するには、このプロバイダーを登録するアカウントに適切な権限が必要です。  Windows では、権限を持つアカウントの少数のセットのみが、既定で分離プロバイダーを登録できます。ユーザーは通常、既定のセットではないアカウントで実行している WCF サービスから WMI データを公開するので、これは問題です。  
+  
+ このアクセスを提供するために、管理者は、次の権限を追加のアカウントに次の順序で付与する必要があります。  
+  
+1.  WCF WMI 名前空間へのアクセス権限  
+  
+2.  WCF 分離 WMI プロバイダーの登録権限  
+  
+#### WMI 名前空間へのアクセス権限を付与するには  
+  
+1.  次の PowerShell スクリプトを実行します。  
+  
+    ```powershell  
+    write-host “”  
+    write-host “Granting Access to root/servicemodel WMI namespace to built in users group”  
+    write-host “”  
+  
+    # Create the binary representation of the permissions to grant in SDDL  
+    $newPermissions = "O:BAG:BAD:P(A;CI;CCDCLCSWRPWPRCWD;;;BA)(A;CI;CC;;;NS)(A;CI;CC;;;LS)(A;CI;CC;;;BU)"  
+    $converter = new-object system.management.ManagementClass Win32_SecurityDescriptorHelper  
+    $binarySD = $converter.SDDLToBinarySD($newPermissions)  
+    $convertedPermissions = ,$binarySD.BinarySD  
+  
+    # Get the object used to set the permissions  
+    $security = gwmi -namespace root/servicemodel -class __SystemSecurity  
+  
+    # Get and output the current settings  
+    $binarySD = @($null)  
+    $result = $security.PsBase.InvokeMethod("GetSD",$binarySD)  
+  
+    $outsddl = $converter.BinarySDToSDDL($binarySD[0])  
+    write-host "Previous ACL: "$outsddl.SDDL  
+  
+    # Change the Access Control List (ACL) using SDDL  
+    $result = $security.PsBase.InvokeMethod("SetSD",$convertedPermissions)   
+  
+    # Get and output the current settings  
+    $binarySD = @($null)  
+    $result = $security.PsBase.InvokeMethod("GetSD",$binarySD)  
+  
+    $outsddl = $converter.BinarySDToSDDL($binarySD[0])  
+    write-host "New ACL:      "$outsddl.SDDL  
+    write-host “”  
+  
+    ```  
+  
+     この PowerShell スクリプトでは、SDDL \(Security Descriptor Definition Language\) を使用して、組み込みのユーザー グループのアクセス権を、“root\/servicemodel” WMI 名前空間に付与します。  次の ACL が指定されます。  
+  
+    -   組み込みの管理者 \(BA\) – 既にアクセス権を持っています。  
+  
+    -   ネットワーク サービス \(NS\) \- 既にアクセス権を持っています。  
+  
+    -   ローカル システム \(LS\) \- 既にアクセス権を持っています。  
+  
+    -   組み込みのユーザー – アクセス権を付与するグループ。  
+  
+#### プロバイダーに登録アクセス権を付与するには  
+  
+1.  次の PowerShell スクリプトを実行します。  
+  
+    ```powershell  
+    write-host “”  
+    write-host “Granting WCF provider registration access to built in users group”  
+    write-host “”  
+    # Set security on ServiceModel provider  
+    $provider = get-WmiObject -namespace "root\servicemodel" __Win32Provider  
+  
+    write-host "Previous ACL: "$provider.SecurityDescriptor  
+    $result = $provider.SecurityDescriptor = "O:BUG:BUD:(A;;0x1;;;BA)(A;;0x1;;;NS)(A;;0x1;;;LS)(A;;0x1;;;BU)"  
+  
+    # Commit the changes and display it to the console  
+    $result = $provider.Put()  
+    write-host "New ACL:      "$provider.SecurityDescriptor  
+    write-host “”  
+  
+    ```  
+  
+### 任意のユーザーまたはグループへのアクセス権の付与  
+ このセクションの例では、すべてのローカル ユーザーに WMI プロバイダー登録権限を付与します。  組み込まれていないユーザーまたはグループにアクセス権を付与する場合は、そのユーザーまたはグループのセキュリティ識別子 \(SID\) を取得する必要があります。  任意のユーザーの SID を取得する簡単な方法はありません。  1 つの方法としては、目的のユーザーとしてログオンし、次のシェル コマンドを発行します。  
+  
+```  
+Whoami /user  
+```  
+  
+ これにより、現在のユーザーの SID が提供されますが、この方法を使用して任意のユーザーで SID を取得することはできません。  SID を取得するもう 1 つの方法は、「[Windows 2000 リソース キット ツールの管理タスク](http://go.microsoft.com/fwlink/?LinkId=178660)」の [getsid.exe](http://go.microsoft.com/fwlink/?LinkId=186467) ツールを使用する方法です。  このツールは、2 人のユーザー \(ローカルまたはドメイン\) の SID を比較し、副作用として、2 つの SID をコマンド ラインに出力します。  [!INCLUDE[crdefault](../../../../../includes/crdefault-md.md)][既知の SID](http://go.microsoft.com/fwlink/?LinkId=186468).  
+  
+## リモート WMI オブジェクトのインスタンスへのアクセス  
+ リモート コンピューターの [!INCLUDE[indigo2](../../../../../includes/indigo2-md.md)] WMI インスタンスにアクセスする必要がある場合、アクセスに使用するツールのパケットのプライバシーを有効にする必要があります。  次のセクションでは、WMI CIM Studio、Windows Management Instrumentation テスト、および .NET SDK 2.0 を使用してこれらを実現する方法を説明します。  
+  
+### WMI CIM Studio  
+ [WMI 管理ツール](http://go.microsoft.com/fwlink/?LinkId=95185) をインストールしている場合は、WMI CIM Studio を使用して WMI インスタンスにアクセスできます。  このツールは次のフォルダーにあります。  
+  
+ **%windir%\\Program Files\\WMI Tools\\**  
+  
+1.  **\[Connect to namespace:\]** ウィンドウに「root\\ServiceModel」と入力し、**\[OK\]** をクリックします。  
+  
+2.  **\[WMI CIM Studio Login\]** ウィンドウで、**\[オプション\>\>\]** ボタンをクリックしてウィンドウを展開します。  **\[認証レベル\]** で **\[パケットのプライバシー\]** を選択し、**\[OK\]** をクリックします。  
+  
+### Windows Management Instrumentation テスト  
+ このツールは Windows によりインストールされます。  このツールを実行するには、**\[スタート\] ボタン、\[ファイル名を指定して実行\]** の順にクリックし、ダイアログ ボックスに「cmd.exe」と入力して **\[OK\]**をクリックし、コマンド コンソールを起動します。  次に、コマンド ウィンドウに「wbemtest.exe」と入力します。  Windows Management Instrumentation テスト ツールが起動します。  
+  
+1.  ウィンドウの右上隅にある **\[接続\]** ボタンをクリックします。  
+  
+2.  新しいウィンドウの **\[名前空間\]** フィールドに「root\\ServiceModel」と入力し、**\[認証レベル\]** として **\[パケットのプライバシー\]** を選択します。  **\[接続\]** をクリックします。  
+  
+### マネージ コードの使用  
+ <xref:System.Management> 名前空間が提供するクラスを使用して、リモートの WMI インスタンスにプログラムでアクセスすることもできます。  これを実行する方法を次のコード例に示します。  
+  
+```  
+String wcfNamespace = String.Format(@"\\{0}\Root\ServiceModel",      
+   this.serviceMachineName);  
+  
+ConnectionOptions connection = new ConnectionOptions();  
+connection.Authentication = AuthenticationLevel.PacketPrivacy;  
+ManagementScope scope = new ManagementScope(this.wcfNamespace, connection);  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/localservicesecuritysettings.md b/docs/framework/wcf/diagnostics/wmi/localservicesecuritysettings.md
new file mode 100644
index 00000000000..713c84de58e
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/localservicesecuritysettings.md
@@ -0,0 +1,155 @@
+---
+title: "LocalServiceSecuritySettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 490aa0e5-5242-4f8d-b505-5ec6287633b4
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# LocalServiceSecuritySettings
+LocalServiceSecuritySettings  
+  
+## 構文  
+  
+```  
+class LocalServiceSecuritySettings  
+{  
+  boolean DetectReplays;  
+  datetime InactivityTimeout;  
+  datetime IssuedCookieLifetime;  
+  sint32 MaxCachedCookies;  
+  datetime MaxClockSkew;  
+  sint32 MaxPendingSessions;  
+  sint32 MaxStatefulNegotiations;  
+  datetime NegotiationTimeout;  
+  boolean ReconnectTransportOnFailure;  
+  sint32 ReplayCacheSize;  
+  datetime ReplayWindow;  
+  datetime SessionKeyRenewalInterval;  
+  datetime SessionKeyRolloverInterval;  
+  datetime TimestampValidityDuration;  
+};  
+```  
+  
+## メソッド  
+ LocalServiceSecuritySettings クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ LocalServiceSecuritySettings クラスには、次のプロパティがあります。  
+  
+### DetectReplays  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネルに対するリプレイ攻撃を検出し、自動的に処理するかどうかを指定するブール値です。  
+  
+### InactivityTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスがサポートする保留状態のセキュリティ セッションの最大数。  
+  
+### IssuedCookieLifetime  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ すべての新しいセキュリティ クッキーに対して発行する有効期間を指定する TimeSpan です。  
+  
+### MaxCachedCookies  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ キャッシュできるクッキーの最大数。  
+  
+### MaxClockSkew  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 通信している双方の 2 つのシステム クロックのずれの最長時間を指定する TimeSpan です。  
+  
+### MaxPendingSessions  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスにおける保留状態の接続の最大数です。  
+  
+### MaxStatefulNegotiations  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 同時にアクティブにできるセキュリティ ネゴシエーションの数。  
+  
+### NegotiationTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サーバーとクライアント間のセキュリティ ネゴシエーション フェーズの最大継続時間を指定する TimeSpan です。  
+  
+### ReconnectTransportOnFailure  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ WS\-ReliableMessaging を使用した接続が、トランスポート エラーの後再接続を試みるかどうかを指定するブール値です。  
+  
+### ReplayCacheSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リプレイ検証で使用されるキャッシュ済みの nonce の数。  
+  
+### ReplayWindow  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 個別のメッセージの nonce の有効期間を指定する TimeSpan です。  
+  
+### SessionKeyRenewalInterval  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ イニシエーターがセキュリティ セッションのキーを更新するまでの期間を指定する TimeSpan です。  
+  
+### SessionKeyRolloverInterval  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ キーの更新中に、前のセッション キーが受信メッセージで有効な時間間隔を指定する TimeSpan です。  
+  
+### TimestampValidityDuration  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ タイムスタンプの有効期間を指定する TimeSpan です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/matchallendpointbehavior.md b/docs/framework/wcf/diagnostics/wmi/matchallendpointbehavior.md
new file mode 100644
index 00000000000..530d0d611f6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/matchallendpointbehavior.md
@@ -0,0 +1,37 @@
+---
+title: "MatchAllEndpointBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 510977a7-ec38-40be-8cd8-4774dc4f75ec
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# MatchAllEndpointBehavior
+MatchAllEndpointBehavior  
+  
+## 構文  
+  
+```  
+class MatchAllEndpointBehavior : Behavior  
+{  
+};  
+```  
+  
+## メソッド  
+ MatchAllEndpointBehavior クラスは Behavior を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/messageencodingbindingelement.md b/docs/framework/wcf/diagnostics/wmi/messageencodingbindingelement.md
new file mode 100644
index 00000000000..786d846ffc9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/messageencodingbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "MessageEncodingBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f750742-b96b-498f-bf5e-05933a1a5961
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# MessageEncodingBindingElement
+MessageEncodingBindingElement  
+  
+## 構文  
+ `class MessageEncodingBindingElement : BindingElement`  
+  
+ `{`  
+  
+ `string MessageVersion;`  
+  
+ `};`  
+  
+## メソッド  
+ MessageEncodingBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ MessageEncodingBindingElement クラスには、次のプロパティがあります。  
+  
+### MessageVersion  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングを使用して送信されたメッセージの SOAP バージョン。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/msmqbindingelementbase.md b/docs/framework/wcf/diagnostics/wmi/msmqbindingelementbase.md
new file mode 100644
index 00000000000..0084b502a6b
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/msmqbindingelementbase.md
@@ -0,0 +1,132 @@
+---
+title: "MsmqBindingElementBase | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 210d41ab-a2a4-4d7a-afd2-0916c08a4015
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# MsmqBindingElementBase
+MsmqBindingElementBase  
+  
+## 構文  
+  
+```  
+class MsmqBindingElementBase : TransportBindingElement  
+{  
+  string CustomDeadLetterQueue;  
+  string DeadLetterQueue;  
+  boolean Durable;  
+  boolean ExactlyOnce;  
+  sint32 MaxRetryCycles;  
+  string ReceiveErrorHandling;  
+  sint32 ReceiveRetryCount;  
+  datetime RetryCycleDelay;  
+  datetime TimeToLive;  
+  boolean UseMsmqTracing;  
+  boolean UseSourceJournal;  
+};  
+```  
+  
+## メソッド  
+ MsmqBindingElementBase クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ MsmqBindingElementBase クラスには、次のプロパティがあります。  
+  
+### CustomDeadLetterQueue  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ アプリケーションごとの配信不能キューの場所が含まれている URI です。ここには、期限切れのメッセージや、転送または配信に失敗したメッセージが配置されます。  
+  
+### DeadLetterQueue  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 使用する配信不能キューの型を示す列挙型の値です。  
+  
+### Durable  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングによって処理されるメッセージが永続的なものか不安定なものかを示す値です。  
+  
+### ExactlyOnce  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングで処理されるメッセージが正確に 1 回だけ受信されるかどうかを示すブール値です。  
+  
+### MaxRetryCycles  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 受信アプリケーションにメッセージを配信する再試行サイクルの最大数です。  
+  
+### ReceiveErrorHandling  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 有害メッセージの処理の設定です。  
+  
+### ReceiveRetryCount  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ アプリケーション キューから読み取られるメッセージの即時再試行の最大回数です。  
+  
+### RetryCycleDelay  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ すぐに配信できなかったメッセージを配信しようとするときの、再試行サイクルの時間遅延を示す値です。  
+  
+### TimeToLive  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングで処理されるメッセージの期限が切れるまで、メッセージをキュー内で保持する時間です。  
+  
+### UseMsmqTracing  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングにより処理されるメッセージをトレースするかどうかを示すブール値です。  
+  
+### UseSourceJournal  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングにより処理されるメッセージのコピーをソース ジャーナル キューに保存するかどうかを示すブール値です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.NetMsmqBinding>   
+ <xref:System.ServiceModel.MsmqBindingBase>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/msmqintegrationbindingelement.md b/docs/framework/wcf/diagnostics/wmi/msmqintegrationbindingelement.md
new file mode 100644
index 00000000000..0264c49f9a1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/msmqintegrationbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "MsmqIntegrationBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eaaa7651-e6e5-4fae-9dad-c1867d38b586
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# MsmqIntegrationBindingElement
+MsmqIntegrationBindingElement  
+  
+## 構文  
+  
+```  
+class MsmqIntegrationBindingElement : MsmqBindingElementBase  
+{  
+  string SerializationFormat;  
+};  
+```  
+  
+## メソッド  
+ MsmqIntegrationBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ MsmqIntegrationBindingElement クラスには、次のプロパティがあります。  
+  
+### SerializationFormat  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージをシリアル化するためにバインディングが使用する形式  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/msmqtransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/msmqtransportbindingelement.md
new file mode 100644
index 00000000000..57098950be5
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/msmqtransportbindingelement.md
@@ -0,0 +1,67 @@
+---
+title: "MsmqTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c89f073-9ed3-4025-a8c5-13535a0f526b
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# MsmqTransportBindingElement
+MsmqTransportBindingElement  
+  
+## 構文  
+  
+```  
+class MsmqTransportBindingElement : MsmqBindingElementBase  
+{  
+  sint32 MaxPoolSize;  
+  string QueueTransferProtocol;  
+  boolean UseActiveDirectory;  
+};  
+```  
+  
+## メソッド  
+ MsmqTransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ MsmqTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### MaxPoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 内部 MSMQ メッセージ オブジェクトを含むプールの最大サイズです。  
+  
+### QueueTransferProtocol  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングが使用するキューに置かれた通信チャネルのトランスポートを示す列挙値です。  
+  
+### UseActiveDirectory  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ キューのアドレスを Active Directory を使用して変換する必要があるかどうかを示すブール値を返します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.MsmqTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/mtommessageencodingbindingelement.md b/docs/framework/wcf/diagnostics/wmi/mtommessageencodingbindingelement.md
new file mode 100644
index 00000000000..2f7eb553460
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/mtommessageencodingbindingelement.md
@@ -0,0 +1,75 @@
+---
+title: "MtomMessageEncodingBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a9c6c3d-e561-4b2d-a693-7e84bdd3534a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# MtomMessageEncodingBindingElement
+MtomMessageEncodingBindingElement  
+  
+## 構文  
+  
+```  
+class MtomMessageEncodingBindingElement : MessageEncodingBindingElement  
+{  
+  string Encoding;  
+  sint32 MaxReadPoolSize;  
+  sint32 MaxWritePoolSize;  
+  XmlDictionaryReaderQuotas ReaderQuotas;  
+};  
+```  
+  
+## メソッド  
+ MtomMessageEncodingBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ MtomMessageEncodingBindingElement クラスには、次のプロパティがあります。  
+  
+### Encoding  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングでメッセージの送信に使用される文字セット エンコーディング。  
+  
+### MaxReadPoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を定義する整数です。  
+  
+### MaxWritePoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいライターを割り当てずに同時に送信可能なメッセージの数を定義する整数です。  
+  
+### ReaderQuotas  
+ データ型 : XmlDictionaryReaderQuotas  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リーダのクォータ。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/mustunderstandbehavior.md b/docs/framework/wcf/diagnostics/wmi/mustunderstandbehavior.md
new file mode 100644
index 00000000000..8531d1aac1f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/mustunderstandbehavior.md
@@ -0,0 +1,51 @@
+---
+title: "MustUnderstandBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 911ed04a-c4b8-4c72-a5c3-fc7b4e3b4348
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# MustUnderstandBehavior
+MustUnderstandBehavior  
+  
+## 構文  
+  
+```  
+class MustUnderstandBehavior : Behavior  
+{  
+  boolean ValidateMustUnderstand;  
+};  
+```  
+  
+## メソッド  
+ MustUnderstandBehavior クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ MustUnderstandBehavior クラスには、次のプロパティがあります。  
+  
+### ValidateMustUnderstand  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ `true` の場合、未処理の `MustUnderstand` 属性を持つすべての SOAP ヘッダーは、動作が例外をスローする原因となります。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MustUnderstandBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/namedpipeconnectionpoolsettings.md b/docs/framework/wcf/diagnostics/wmi/namedpipeconnectionpoolsettings.md
new file mode 100644
index 00000000000..79baf16b80c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/namedpipeconnectionpoolsettings.md
@@ -0,0 +1,67 @@
+---
+title: "NamedPipeConnectionPoolSettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 079bccb8-54b5-4436-a43d-5567763f72ce
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# NamedPipeConnectionPoolSettings
+NamedPipeConnectionPoolSettings  
+  
+## 構文  
+  
+```  
+class NamedPipeConnectionPoolSettings  
+{  
+  string GroupName;  
+  datetime IdleTimeout;  
+  sint32 MaxOutboundConnectionsPerEndpoint;  
+};  
+```  
+  
+## メソッド  
+ NamedPipeConnectionPoolSettings クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ NamedPipeConnectionPoolSettings クラスには、次のプロパティがあります。  
+  
+### GroupName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインド要素により使用される接続プールのグループ名。  
+  
+### IdleTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続が切断されるまでの最大アイドル時間。  
+  
+### MaxOutboundConnectionsPerEndpoint  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアント上の各エンドポイントでの発信接続の最大数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.NamedPipeConnectionPoolSettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/namedpipetransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/namedpipetransportbindingelement.md
new file mode 100644
index 00000000000..19315400447
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/namedpipetransportbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "NamedPipeTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c201309c-c528-4b92-a53c-4d48151c5749
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# NamedPipeTransportBindingElement
+NamedPipeTransportBindingElement  
+  
+## 構文  
+  
+```  
+class NamedPipeTransportBindingElement : ConnectionOrientedTransportBindingElement  
+{  
+  NamedPipeConnectionPoolSettings ConnectionPoolSettings;  
+};  
+```  
+  
+## メソッド  
+ NamedPipeTransportBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ NamedPipeTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### ConnectionPoolSettings  
+ データ型 : NamedPipeConnectionPoolSettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続プールの設定。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/onewaybindingelement.md b/docs/framework/wcf/diagnostics/wmi/onewaybindingelement.md
new file mode 100644
index 00000000000..1dcdee476e0
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/onewaybindingelement.md
@@ -0,0 +1,67 @@
+---
+title: "OneWayBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c7e17c3-39b9-4214-ae08-9e6141734305
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# OneWayBindingElement
+OneWayBindingElement  
+  
+## 構文  
+  
+```  
+class OneWayBindingElement : BindingElement  
+{  
+  ChannelPoolSettings ChannelPoolSettings;  
+  sint32 MaxAcceptedChannels;  
+  boolean PacketRoutable;  
+};  
+```  
+  
+## メソッド  
+ OneWayBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ OneWayBindingElement クラスには、次のプロパティがあります。  
+  
+### ChannelPoolSettings  
+ データ型 : ChannelPoolSettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ チャネル プールの設定。  
+  
+### MaxAcceptedChannels  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 許可されるチャネルの最大数。  
+  
+### PacketRoutable  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ パケットがルーティング可能かどうかを示す値。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.OneWayBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/operation-class.md b/docs/framework/wcf/diagnostics/wmi/operation-class.md
new file mode 100644
index 00000000000..45003d7f979
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/operation-class.md
@@ -0,0 +1,139 @@
+---
+title: "操作クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b19d1496-ef06-4d0c-b2ae-e728ec00cca0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 操作クラス
+Operation  
+  
+## 構文  
+  
+```  
+class Operation  
+{  
+  string Action;  
+  boolean AsyncPattern;  
+  Behavior Behaviors[];  
+  boolean IsCallback;  
+  boolean IsInitiating;  
+  boolean IsOneWay;  
+  boolean IsTerminating;  
+  string MethodSignature;  
+  string Name;  
+  string ParameterTypes[];  
+  string ReplyAction;  
+  string ReturnType;  
+};  
+```  
+  
+## メソッド  
+ Operation クラスで定義されているメソッドはありせん。  
+  
+## プロパティ  
+ Operation クラスには、次のプロパティがあります。  
+  
+### Action  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 要求メッセージの WS\-Addressing 操作。  
+  
+### AsyncPattern  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービス コントラクトで `Begin` メソッドと `End` メソッドの組み合わせを使用して、操作が非同期的に実装されることを示します。  
+  
+### Behaviors  
+ データ型 : Behavior 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ この操作に関連付けられている動作。  
+  
+### IsCallback  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ この操作がコールバック操作の場合、True。  
+  
+### IsInitiating  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メソッドが、サーバーでセッションを開始できる操作を実装するかどうかを指定します。  
+  
+### IsOneWay  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作が応答メッセージを返すかどうかを指定します。  
+  
+### IsTerminating  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作が応答メッセージを返すかどうかを指定します。  
+  
+### MethodSignature  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作のメソッド署名。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作の名前。  
+  
+### ParameterTypes  
+ データ型 : string 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作のパラメーターの型。  
+  
+### ReplyAction  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作の応答メッセージの SOAP アクションの値。  
+  
+### ReturnType  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作の戻り値の型。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.OperationDescription>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/operationbehaviorattribute.md b/docs/framework/wcf/diagnostics/wmi/operationbehaviorattribute.md
new file mode 100644
index 00000000000..0862869e694
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/operationbehaviorattribute.md
@@ -0,0 +1,83 @@
+---
+title: "OperationBehaviorAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8c9b0755-9e83-411f-bdcb-61a586022797
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# OperationBehaviorAttribute
+OperationBehaviorAttribute  
+  
+## 構文  
+  
+```  
+class OperationBehaviorAttribute : Behavior  
+{  
+  boolean AutoDisposeParameters;  
+  string Impersonation;  
+  string ReleaseInstanceMode;  
+  boolean TransactionAutoComplete;  
+  boolean TransactionScopeRequired;  
+};  
+```  
+  
+## メソッド  
+ OperationBehaviorAttribute クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ OperationBehaviorAttribute クラスには、次のプロパティがあります。  
+  
+### AutoDisposeParameters  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ パラメーターの自動破棄機能の状態です。  
+  
+### Impersonation  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作がサポートする、呼び出し元の偽装レベルを示します。  
+  
+### ReleaseInstanceMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作の呼び出し過程のどの時点でオブジェクトをリサイクルするかを示します。  
+  
+### TransactionAutoComplete  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 未処理の例外が発生しなかった場合に、現在のトランザクションを自動的にコミットするかどうかを示します。  
+  
+### TransactionScopeRequired  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 操作がトランザクションを必要とするかどうかを示します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationBehaviorAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/peercustomresolverbindingelement.md b/docs/framework/wcf/diagnostics/wmi/peercustomresolverbindingelement.md
new file mode 100644
index 00000000000..f019a988196
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/peercustomresolverbindingelement.md
@@ -0,0 +1,60 @@
+---
+title: "PeerCustomResolverBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ccc2770-a20e-4dff-9970-f56ad8aec2b5
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# PeerCustomResolverBindingElement
+PeerCustomResolverBindingElement  
+  
+## 構文  
+ `class PeerCustomResolverBindingElement : PeerResolverBindingElement`  
+  
+ `{`  
+  
+ `string Address;`  
+  
+ `string Binding;`  
+  
+ `};`  
+  
+## メソッド  
+ PeerCustomResolverBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ PeerCustomResolverBindingElement クラスには、次のプロパティがあります。  
+  
+### Address  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア カスタム リゾルバーのアドレスです。  
+  
+### Binding  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングの構成名。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.PeerCustomResolverBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/peerresolverbindingelement.md b/docs/framework/wcf/diagnostics/wmi/peerresolverbindingelement.md
new file mode 100644
index 00000000000..fa4883e479a
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/peerresolverbindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "PeerResolverBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 36882183-13a3-443f-8aae-62a7825d5633
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# PeerResolverBindingElement
+PeerResolverBindingElement  
+  
+## 構文  
+  
+```  
+class PeerResolverBindingElement : BindingElement  
+{  
+  string ReferralPolicy;  
+};  
+```  
+  
+## メソッド  
+ PeerResolverBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ PeerResolverBindingElement クラスには、次のプロパティがあります。  
+  
+### ReferralPolicy  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア間で参照を共有する方法を指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.PnrpPeerResolverBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/peersecuritysettings.md b/docs/framework/wcf/diagnostics/wmi/peersecuritysettings.md
new file mode 100644
index 00000000000..846d66acb34
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/peersecuritysettings.md
@@ -0,0 +1,59 @@
+---
+title: "PeerSecuritySettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24ae0d35-f3a3-419b-afd6-686e22aae27b
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# PeerSecuritySettings
+PeerSecuritySettings  
+  
+## 構文  
+  
+```  
+class PeerSecuritySettings  
+{  
+  string Mode;  
+  PeerTransportSecuritySettings Transport;  
+};  
+```  
+  
+## メソッド  
+ PeerSecuritySettings クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ PeerSecuritySettings クラスには、次のプロパティがあります。  
+  
+### Mode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングで構成されたエンドポイントによって、メッセージ レベルおよびトランスポート レベルのセキュリティが使用されているかどうかを示します。  
+  
+### トランスポート  
+ データ型 : PeerTransportSecuritySettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランスポートのセキュリティ設定です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.PeerSecuritySettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/peertransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/peertransportbindingelement.md
new file mode 100644
index 00000000000..f39cd74f4ce
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/peertransportbindingelement.md
@@ -0,0 +1,67 @@
+---
+title: "PeerTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40bf6be2-8087-4cb3-a66c-408d53eb9269
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# PeerTransportBindingElement
+PeerTransportBindingElement  
+  
+## 構文  
+  
+```  
+class PeerTransportBindingElement : TransportBindingElement  
+{  
+  string ListenIPAddress;  
+  sint32 Port;  
+  PeerSecuritySettings Security;  
+};  
+```  
+  
+## メソッド  
+ PeerTransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ PeerTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### ListenIPAddress  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア ノードがメッセージをリッスンする IP アドレスです。  
+  
+### Port  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングがピア チャネル メッセージを処理するネットワーク インターフェイス ポートです。  
+  
+### Security  
+ データ型 : PeerSecuritySettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア トランスポートのセキュリティ設定です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.PeerTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/peertransportsecuritysettings.md b/docs/framework/wcf/diagnostics/wmi/peertransportsecuritysettings.md
new file mode 100644
index 00000000000..c998c154fa6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/peertransportsecuritysettings.md
@@ -0,0 +1,51 @@
+---
+title: "PeerTransportSecuritySettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1df08cbb-68c5-4d36-9f88-a776a8117de8
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# PeerTransportSecuritySettings
+PeerTransportSecuritySettings  
+  
+## 構文  
+  
+```  
+class PeerTransportSecuritySettings  
+{  
+  string CredentialType;  
+};  
+```  
+  
+## メソッド  
+ PeerTransportSecuritySettings クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ PeerTransportSecuritySettings クラスには、次のプロパティがあります。  
+  
+### CredentialType  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピア セキュリティ要素のトランスポート資格情報の種類。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.PeerTransportSecuritySettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/pnrppeerresolverbindingelement.md b/docs/framework/wcf/diagnostics/wmi/pnrppeerresolverbindingelement.md
new file mode 100644
index 00000000000..19b7aae1a23
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/pnrppeerresolverbindingelement.md
@@ -0,0 +1,39 @@
+---
+title: "PnrpPeerResolverBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 050f24bf-dc23-4181-ad1e-a4cce1dc89fb
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# PnrpPeerResolverBindingElement
+PnrpPeerResolverBindingElement  
+  
+## 構文  
+ `class PnrpPeerResolverBindingElement : PeerResolverBindingElement`  
+  
+ `{`  
+  
+ `};`  
+  
+## メソッド  
+ PnrpPeerResolverBindingElement クラスは、PeerResolverBindingElement を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.PnrpPeerResolverBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/privacynoticebindingelement.md b/docs/framework/wcf/diagnostics/wmi/privacynoticebindingelement.md
new file mode 100644
index 00000000000..06936ea0541
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/privacynoticebindingelement.md
@@ -0,0 +1,59 @@
+---
+title: "PrivacyNoticeBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0cf110b1-e25b-4d67-986b-10cb04dc4826
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# PrivacyNoticeBindingElement
+PrivacyNoticeBindingElement  
+  
+## 構文  
+  
+```  
+class PrivacyNoticeBindingElement : BindingElement  
+{  
+  sint32 PrivacyNoticeVersion;  
+  string Url;  
+};  
+```  
+  
+## メソッド  
+ PrivacyNoticeBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ PrivacyNoticeBindingElement クラスには、次のプロパティがあります。  
+  
+### PrivacyNoticeVersion  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ プライバシーに関する声明のバージョンです。  
+  
+### Url  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ プライバシーに関する声明がある URL です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.PrivacyNoticeBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/reliablesessionbindingelement.md b/docs/framework/wcf/diagnostics/wmi/reliablesessionbindingelement.md
new file mode 100644
index 00000000000..d347418b9cb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/reliablesessionbindingelement.md
@@ -0,0 +1,107 @@
+---
+title: "ReliableSessionBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: effda125-b8d3-4de6-8c0e-f59f5ea8f6eb
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ReliableSessionBindingElement
+ReliableSessionBindingElement  
+  
+## 構文  
+  
+```  
+class ReliableSessionBindingElement : BindingElement  
+{  
+  datetime AcknowledgementInterval;  
+  boolean FlowControlEnabled;  
+  datetime InactivityTimeout;  
+  sint32 MaxPendingChannels;  
+  sint32 MaxRetryCount;  
+  sint32 MaxTransferWindowSize;  
+  boolean Ordered;  
+  integer ReliableMessagingVersion;  
+};  
+```  
+  
+## メソッド  
+ ReliableSessionBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ReliableSessionBindingElement クラスには、次のプロパティがあります。  
+  
+### AcknowledgementInterval  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ファクトリによって作成された信頼できるチャネルで、メッセージの送信元に受信確認を送信するまで送信先が待機する時間  
+  
+### FlowControlEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ フロー制御を有効にするかどうかを示すブール値  
+  
+### InactivityTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 他の通信相手がチャネルにメッセージを送信せずにいられる最長期間を指定します。他の通信相手がメッセージを送信しない期間がこの値を超えると、チャネルでエラーが発生します。  
+  
+### MaxPendingChannels  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リスナーで受け入れを待機できるチャネルの最大数。  
+  
+### MaxRetryCount  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 基になるチャネルで `Send` を呼び出すことで、信頼できるチャネルが受信確認を受信していないメッセージの再転送を試みる最大回数  
+  
+### MaxTransferWindowSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 信頼できるセッションの転送ウィンドウの最大サイズ  
+  
+### 順序あり  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージが送信された順序で到着されることを保証するかどうかを指定するブール値です。  
+  
+### ReliableMessagingVersion  
+ データ型 : integer  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 信頼できるセッションで使用される WS\-ReliableMessaging プロトコルのバージョンを指定する整数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.ReliableSessionBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/securitybindingelement.md b/docs/framework/wcf/diagnostics/wmi/securitybindingelement.md
new file mode 100644
index 00000000000..f11120cfceb
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/securitybindingelement.md
@@ -0,0 +1,91 @@
+---
+title: "SecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef93b6e6-3524-48a8-94d3-c8837f1872f9
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# SecurityBindingElement
+SecurityBindingElement  
+  
+## 構文  
+  
+```  
+class SecurityBindingElement : BindingElement  
+{  
+  string DefaultAlgorithmSuite;  
+  boolean IncludeTimestamp;  
+  string KeyEntropyMode;  
+  LocalServiceSecuritySettings LocalServiceSecuritySettings;  
+  string MessageSecurityVersion;  
+  string SecurityHeaderLayout;  
+};  
+```  
+  
+## メソッド  
+ SecurityBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ SecurityBindingElement クラスには、次のプロパティがあります。  
+  
+### DefaultAlgorithmSuite  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングで使用するアルゴリズムを指定します。  
+  
+### IncludeTimestamp  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 各メッセージにタイムスタンプが含まれるかどうかを指定するブール値です。  
+  
+### KeyEntropyMode  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ キーの作成に使用されるエントロピのソースです。  
+  
+### LocalServiceSecuritySettings  
+ データ型 : LocalServiceSecuritySettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ローカル サービスに対するバインディング固有のセキュリティ プロパティです。  
+  
+### MessageSecurityVersion  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージ セキュリティで使用されるバージョンです。  
+  
+### SecurityHeaderLayout  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングのセキュリティ ヘッダー内の要素の順序です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/service.md b/docs/framework/wcf/diagnostics/wmi/service.md
new file mode 100644
index 00000000000..a7b01f997f8
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/service.md
@@ -0,0 +1,136 @@
+---
+title: "サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 999806e1-6376-409e-b998-b0af391adfe7
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# サービス
+サービス  
+  
+## 構文  
+  
+```  
+class Service  
+{  
+  string BaseAddresses[];  
+  Behavior Behaviors[];  
+  string ConfigurationName;  
+  string CounterInstanceName;  
+  string DistinguishedName;  
+  string Extensions[];  
+  string Metadata[];  
+  string Name;  
+  string Namespace;  
+  datetime Opened;  
+  Channel OutgoingChannels[];  
+  sint32 ProcessId;  
+};  
+```  
+  
+## メソッド  
+ Service クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ Service クラスには次のプロパティがあります。  
+  
+### BaseAddresses  
+ データ型 : string 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスによって使用されるベース アドレスです。  
+  
+### 動作  
+ データ型 : Behavior 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスに関連付けられている動作です。  
+  
+### ConfigurationName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ServiceElement\_BehaviorConfiguration  
+  
+### CounterInstanceName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスのパフォーマンス カウンターのインスタンスのインスタンス名です。  
+  
+### DistinguishedName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ アドレスでのサービス名です。  
+  
+### Extensions  
+ データ型 : string 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービス インスタンスの拡張に対するインスタンス コンテキストです。  
+  
+### メタデータ  
+ データ型 : string 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービス メタデータの設定です。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスの一意の名前。  
+  
+### 名前空間  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスの名前空間です。  
+  
+### Opened  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスが開かれた時刻です。  
+  
+### OutgoingChannels  
+ データ型 : Channel 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービス インスタンスから送信しているチャネルです。  
+  
+### ProcessId  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスをホストするプロセスのプロセス ID です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/serviceappdomain.md b/docs/framework/wcf/diagnostics/wmi/serviceappdomain.md
new file mode 100644
index 00000000000..6378345ce89
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/serviceappdomain.md
@@ -0,0 +1,58 @@
+---
+title: "ServiceAppDomain | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f28e5186-a66d-46c1-abe9-b50e07f8cb4f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceAppDomain
+アプリケーション ドメインにサービスを割り当てます。  
+  
+## 構文  
+  
+```  
+class ServiceAppDomain  
+{  
+  Service ref;  
+  AppDomainInfo ref;  
+};  
+```  
+  
+## メソッド  
+ ServiceAppDomain クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceAppDomain クラスには、次のプロパティがあります。  
+  
+### ref  
+ データ型 : Service               
+ 修飾子: キー  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このアプリケーション ドメインのサービスです。  
+  
+### ref  
+ データ型: AppDomainInfo               
+ 修飾子: キー  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ アプリケーション ドメインのプロパティが格納されています。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/serviceauthorizationbehavior.md b/docs/framework/wcf/diagnostics/wmi/serviceauthorizationbehavior.md
new file mode 100644
index 00000000000..765f184e0e9
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/serviceauthorizationbehavior.md
@@ -0,0 +1,75 @@
+---
+title: "ServiceAuthorizationBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 77dad8e8-fea4-4d1c-b366-2f01a2a87f78
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceAuthorizationBehavior
+ServiceAuthorizationBehavior  
+  
+## 構文  
+  
+```  
+class ServiceAuthorizationBehavior : Behavior  
+{  
+  boolean ImpersonateCallerForAllOperations;  
+  string PrincipalPermissionMode;  
+  string RoleProvider;  
+  string ServiceAuthorizationManager;  
+};  
+```  
+  
+## メソッド  
+ ServiceAuthorizationBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceAuthorizationBehavior クラスには、次のプロパティがあります。  
+  
+### impersonateCallerForAllOperations  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 受信メッセージによって提供される資格情報を使用してサービスが偽装を試みるかどうかを制御する値。  
+  
+### PrincipalPermissionMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サーバーでの操作を実行するために使用されるプリンシパル。  
+  
+### RoleProvider  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ASP.NET ロール プロバイダーの名前。  
+  
+### ServiceAuthorizationManager  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ カスタム承認で使用される承認マネージャー。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicebehaviorattribute.md b/docs/framework/wcf/diagnostics/wmi/servicebehaviorattribute.md
new file mode 100644
index 00000000000..beab4d55028
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicebehaviorattribute.md
@@ -0,0 +1,162 @@
+---
+title: "ServiceBehaviorAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5faa266f-587f-4e03-828d-1c7dd5acfe65
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ServiceBehaviorAttribute
+ServiceBehaviorAttribute  
+  
+## 構文  
+  
+```  
+class ServiceBehaviorAttribute : Behavior  
+{  
+  boolean AutomaticSessionShutdown;  
+  string ConcurrencyMode;  
+  string ConfigurationName;  
+  boolean IgnoreExtensionDataObject;  
+  boolean IncludeExceptionDetailInFaults;  
+  string InstanceContextMode;  
+  sint32 MaxItemsInObjectGraph;  
+  string Name;  
+  string Namespace;  
+  boolean ReleaseServiceInstanceOnTransactionComplete;  
+  boolean TransactionAutoCompleteOnSessionClose;  
+  string TransactionIsolationLevel;  
+  datetime TransactionTimeout;  
+  boolean UseSynchronizationContext;  
+  boolean ValidateMustUnderstand;  
+};  
+```  
+  
+## メソッド  
+ ServiceBehaviorAttribute クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceBehaviorAttribute クラスには、次のプロパティがあります。  
+  
+### AutomaticSessionShutdown  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ クライアントが出力セッションを閉じるときにセッションを自動的に閉じるかどうかを示します。  
+  
+### ConcurrencyMode  
+ データ型: string  
+アクセスの種類 : 読み取り専用  
+  
+ サービスで、1 つのスレッド、複数のスレッド、または再入呼び出しをサポートするかどうかを示します。  
+  
+### ConfigurationName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービス構成の名前。  
+  
+### IgnoreExtensionDataObject  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 不明なシリアル化データをネットワークで送信するかどうかを指定します。  
+  
+### IncludeExceptionDetailInFaults  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ デバッグの目的でクライアントに返される SOAP エラーの詳細に、マネージ例外情報を含めるかどうかを指定します。  
+  
+### InstanceContextMode  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいサービス オブジェクトを作成するタイミングを指定します。  
+  
+### MaxItemsInObjectGraph  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 1 つのシリアル化されたオブジェクトで許可される項目の最大数。  
+  
+### Name  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ WSDL でのサービスの名前属性。  
+  
+### 名前空間  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ WSDL でのサービスのターゲット名前空間。  
+  
+### ReleaseServiceInstanceOnTransactionComplete  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在のトランザクションの完了時に、サービス オブジェクトをリサイクルするかどうかを指定します。  
+  
+### TransactionAutoCompleteOnSessionClose  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在のセッションの終了時に、保留中のトランザクションを完了するかどうかを指定します。  
+  
+### TransactionIsolationLevel  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクションの分離レベルを指定します。  
+  
+### TransactionTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクションを完了しなければならない期間。  
+  
+### UseSynchronizationContext  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在の同期コンテキストを使用してスレッドの実行を選択するかどうかを指定します。  
+  
+### ValidateMustUnderstand  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ システムまたはアプリケーションで SOAP MustUnderstand ヘッダー処理を強制的に行うかどうかを指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicecredentials.md b/docs/framework/wcf/diagnostics/wmi/servicecredentials.md
new file mode 100644
index 00000000000..026316d30f6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicecredentials.md
@@ -0,0 +1,99 @@
+---
+title: "ServiceCredentials | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9c780793-4785-46f7-add9-ac1ebeadb614
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceCredentials
+ServiceCredentials  
+  
+## 構文  
+  
+```  
+class ServiceCredentials : Behavior  
+{  
+  string ClientCertificate;  
+  string IssuedTokenAuthentication;  
+  string Peer;  
+  string SecureConversationAuthentication;  
+  string ServiceCertificate;  
+  string UserNameAuthentication;  
+  string WindowsAuthentication;  
+};  
+```  
+  
+## メソッド  
+ ServiceCredentials クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ ServiceCredentials クラスには、次のプロパティがあります。  
+  
+### ClientCertificate  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスのための、クライアント証明認証および提供設定です。  
+  
+### IssuedTokenAuthentication  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスのための、現在発行されているトークンの認証設定です。  
+  
+### Peer  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ピアのトランスポート エンドポイントによって使用される、現在の証明書の認証および提供の設定です。  
+  
+### SecureConversationAuthentication  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 現在のセキュリティで保護された通信の設定を指定します。  
+  
+### ServiceCertificate  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスに関連付けられている証明書です。  
+  
+### UserNameAuthentication  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスのユーザー名\/パスワードの設定です。  
+  
+### WindowsAuthentication  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このサービスの Windows 認証の設定です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceCredentials>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicedebugbehavior.md b/docs/framework/wcf/diagnostics/wmi/servicedebugbehavior.md
new file mode 100644
index 00000000000..9cd445a2322
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicedebugbehavior.md
@@ -0,0 +1,83 @@
+---
+title: "ServiceDebugBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5ec9061-1e95-43fb-b0d9-dbd0a7bc3c44
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ServiceDebugBehavior
+ServiceDebugBehavior  
+  
+## 構文  
+  
+```  
+class ServiceDebugBehavior : Behavior  
+{  
+  boolean HttpHelpPageEnabled;  
+  string HttpHelpPageUrl;  
+  boolean HttpsHelpPageEnabled;  
+  string HttpsHelpPageUrl;  
+  boolean IncludeExceptionDetailInFaults;  
+};  
+```  
+  
+## メソッド  
+ ServiceDebugBehavior クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ ServiceDebugBehavior クラスには、次のプロパティがあります。  
+  
+### HttpHelpPageEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ `HttpGetUrl` 属性によって制御されるアドレスで、サービスが WSDL を公開するかどうかを制御します。  
+  
+### HttpHelpPageUrl  
+ データ型 : 文字列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTP を使用した取得のために、サービス WSDL が公開される場所を設定します。  
+  
+### HttpsHelpPageEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ `HttpsGetUrl` 属性によって制御されるアドレスで、サービスが HTTPS を介して WSDL を公開するかどうかを制御します。  
+  
+### HttpsHelpPageUrl  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTPS を使用した取得のために、サービス WSDL が公開される場所を設定します。  
+  
+### IncludeExceptionDetailInFaults  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ デバッグの目的でクライアントに返される SOAP エラーの詳細に、マネージ例外情報を含めるかどうかを指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceDebugBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicemetadatabehavior.md b/docs/framework/wcf/diagnostics/wmi/servicemetadatabehavior.md
new file mode 100644
index 00000000000..1e483bfeddf
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicemetadatabehavior.md
@@ -0,0 +1,83 @@
+---
+title: "ServiceMetadataBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f194476-72f1-467e-bdce-674306316e64
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceMetadataBehavior
+ServiceMetadataBehavior  
+  
+## 構文  
+  
+```  
+class ServiceMetadataBehavior : Behavior  
+{  
+  string ExternalMetadataLocation;  
+  boolean HttpGetEnabled;  
+  string HttpGetUrl;  
+  boolean HttpsGetEnabled;  
+  string HttpsGetUrl;  
+};  
+```  
+  
+## メソッド  
+ ServiceMetadataBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceMetadataBehavior クラスには、次のプロパティがあります。  
+  
+### ExternalMetadataLocation  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ サービスがメタデータ要求をリダイレクトする場所を設定します。  
+  
+### HttpGetEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ `HttpGetUrl` 属性によって制御されるアドレスで、サービスが WSDL を公開するかどうかを制御します。  
+  
+### HttpGetUrl  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTP を使用した取得のために、サービス WSDL が公開される場所を設定します。  
+  
+### HttpsGetEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ `HttpsGetUrl` 属性によって制御されるアドレスで、サービスが HTTPS を介して WSDL を公開するかどうかを制御します。  
+  
+### HttpsGetUrl  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ HTTPS を使用した取得のために、サービス WSDL が公開される場所を設定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicesecurityauditbehavior.md b/docs/framework/wcf/diagnostics/wmi/servicesecurityauditbehavior.md
new file mode 100644
index 00000000000..74c0adc6195
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicesecurityauditbehavior.md
@@ -0,0 +1,75 @@
+---
+title: "ServiceSecurityAuditBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c5809e7-5364-44ce-bc71-848be4672e2a
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# ServiceSecurityAuditBehavior
+ServiceSecurityAuditBehavior  
+  
+## 構文  
+  
+```  
+class ServiceSecurityAuditBehavior : Behavior  
+{  
+  string AuditLogLocation;  
+  string MessageAuthenticationAuditLevel;  
+  string ServiceAuthorizationAuditLevel;  
+  boolean SuppressAuditFailure;  
+};  
+```  
+  
+## メソッド  
+ ServiceSecurityAuditBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceSecurityAuditBehavior クラスには、次のプロパティがあります。  
+  
+### AuditLogLocation  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 監査ログの場所。  
+  
+### MessageAuthenticationAuditLevel  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 監査イベントをログに記録するために使用されるメッセージ認証レベルの種類。  
+  
+### ServiceAuthorizationAuditLevel  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 監査ログに記録される承認イベントの種類。  
+  
+### SuppressAuditFailure  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 監査ログへの書き込みエラーを非表示にする動作を指定するブール型の値。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicethrottlingbehavior.md b/docs/framework/wcf/diagnostics/wmi/servicethrottlingbehavior.md
new file mode 100644
index 00000000000..3524b2840a6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicethrottlingbehavior.md
@@ -0,0 +1,67 @@
+---
+title: "ServiceThrottlingBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37b9e517-1f1f-4ec4-9fcb-2b8016794f5b
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ServiceThrottlingBehavior
+ServiceThrottlingBehavior  
+  
+## 構文  
+  
+```  
+class ServiceThrottlingBehavior : Behavior  
+{  
+  sint32 MaxConcurrentCalls;  
+  sint32 MaxConcurrentInstances;  
+  sint32 MaxConcurrentSessions;  
+};  
+```  
+  
+## メソッド  
+ ServiceThrottlingBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceThrottlingBehavior クラスには、次のプロパティがあります。  
+  
+### MaxConcurrentCalls  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ServiceHost 内のすべてのディスパッチャー オブジェクトでアクティブに処理中のメッセージの最大数。  
+  
+### MaxConcurrentInstances  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 一度に実行可能なサービス オブジェクトの最大数。  
+  
+### MaxConcurrentSessions  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ ホストが一度に受け入れ可能なセッションの最大数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicetimeoutsbehavior.md b/docs/framework/wcf/diagnostics/wmi/servicetimeoutsbehavior.md
new file mode 100644
index 00000000000..485c8542009
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicetimeoutsbehavior.md
@@ -0,0 +1,51 @@
+---
+title: "ServiceTimeoutsBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4412525d-a3cc-4eae-b3e8-a50ce766d09d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ServiceTimeoutsBehavior
+ServiceTimeoutsBehavior  
+  
+## 構文  
+  
+```  
+class ServiceTimeoutsBehavior : Behavior  
+{  
+  datetime TransactionTimeout;  
+};  
+```  
+  
+## メソッド  
+ ServiceTimeoutsBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceTimeoutsBehavior クラスには、次のプロパティがあります。  
+  
+### TransactionTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクションを完了しなければならない期間。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceTimeoutsElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/servicetoendpointassociation.md b/docs/framework/wcf/diagnostics/wmi/servicetoendpointassociation.md
new file mode 100644
index 00000000000..c861687f1d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/servicetoendpointassociation.md
@@ -0,0 +1,58 @@
+---
+title: "ServiceToEndpointAssociation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03c3cd15-e1b2-4dc2-bdc2-59fdccdae110
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceToEndpointAssociation
+エンドポイントにサービスを割り当てます。  
+  
+## 構文  
+  
+```  
+class ServiceToEndpointAssociation  
+{  
+  Service ref;  
+  Endpoint ref;  
+};  
+```  
+  
+## メソッド  
+ ServiceToEndpointAssociation クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ ServiceToEndpointAssociation クラスには、次のプロパティがあります。  
+  
+### ref  
+ データ型 : Service  
+  
+ アクセスの種類 : 読み取り専用  
+修飾子: キー  
+  
+ エンドポイントに関連付けられるサービス。  
+  
+### ref  
+ データ型 : Endpoint  
+  
+ アクセスの種類 : 読み取り専用  
+修飾子: キー  
+  
+ サービスに関連付けられるエンドポイント。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/sslstreamsecuritybindingelement.md b/docs/framework/wcf/diagnostics/wmi/sslstreamsecuritybindingelement.md
new file mode 100644
index 00000000000..1ad6932c95d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/sslstreamsecuritybindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "SslStreamSecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 18130d50-8996-4257-9c60-bc457f8654d8
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# SslStreamSecurityBindingElement
+SslStreamSecurityBindingElement  
+  
+## 構文  
+  
+```  
+class SslStreamSecurityBindingElement : BindingElement  
+{  
+  boolean RequireClientCertificate;  
+};  
+```  
+  
+## メソッド  
+ SslStreamSecurityBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ SslStreamSecurityBindingElement クラスには、次のプロパティがあります。  
+  
+### RequireClientCertificate  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングにクライアント証明書が必要かどうかを指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/symmetricsecuritybindingelement.md b/docs/framework/wcf/diagnostics/wmi/symmetricsecuritybindingelement.md
new file mode 100644
index 00000000000..adbd4cd444f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/symmetricsecuritybindingelement.md
@@ -0,0 +1,59 @@
+---
+title: "SymmetricSecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2e182b6-c041-4d80-a926-6058068d9f79
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# SymmetricSecurityBindingElement
+SymmetricSecurityBindingElement  
+  
+## 構文  
+  
+```  
+class SymmetricSecurityBindingElement : SecurityBindingElement  
+{  
+  string MessageProtectionOrder;  
+  boolean RequireSignatureConfirmation;  
+};  
+```  
+  
+## メソッド  
+ SymmetricSecurityBindingElement クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ SymmetricSecurityBindingElement クラスには、次のプロパティがあります。  
+  
+### MessageProtectionOrder  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングのメッセージの暗号化と署名の命令。  
+  
+### RequireSignatureConfirmation  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングで署名の確認が必要かどうか。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/synchronousreceivebehavior.md b/docs/framework/wcf/diagnostics/wmi/synchronousreceivebehavior.md
new file mode 100644
index 00000000000..df18f6582e1
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/synchronousreceivebehavior.md
@@ -0,0 +1,40 @@
+---
+title: "SynchronousReceiveBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b31a26a9-ae96-4df0-8406-e07d6f59087c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# SynchronousReceiveBehavior
+SynchronousReceiveBehavior  
+  
+## 構文  
+  
+```  
+class SynchronousReceiveBehavior : Behavior  
+{  
+};  
+```  
+  
+## メソッド  
+ SynchronousReceiveBehavior クラスは Behavior の継承ですが、追加のメソッドやプロパティは定義されていません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.SynchronousReceiveBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/tcpconnectionpoolsettings.md b/docs/framework/wcf/diagnostics/wmi/tcpconnectionpoolsettings.md
new file mode 100644
index 00000000000..aa1e92e546c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/tcpconnectionpoolsettings.md
@@ -0,0 +1,75 @@
+---
+title: "TcpConnectionPoolSettings | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19acfba3-c057-4dbc-bac7-8674d7844d83
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# TcpConnectionPoolSettings
+TcpConnectionPoolSettings  
+  
+## 構文  
+  
+```  
+class TcpConnectionPoolSettings  
+{  
+  string GroupName;  
+  datetime IdleTimeout;  
+  datetime LeaseTimeout;  
+  sint32 MaxOutboundConnectionsPerEndpoint;  
+};  
+```  
+  
+## メソッド  
+ TcpConnectionPoolSettings クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TcpConnectionPoolSettings クラスには、次のプロパティがあります。  
+  
+### GroupName  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインド要素により使用される接続プールのグループ名。  
+  
+### IdleTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続が切断されるまでの最大アイドル時間。  
+  
+### LeaseTimeout  
+ データ型 : datetime  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リース操作を完了する必要がある、タイムアウトまでの最大時間。  
+  
+### MaxOutboundConnectionsPerEndpoint  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 各エンドポイントの発信接続の最大数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TcpConnectionPoolSettings>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/tcptransportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/tcptransportbindingelement.md
new file mode 100644
index 00000000000..8cd38faa2d3
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/tcptransportbindingelement.md
@@ -0,0 +1,75 @@
+---
+title: "TcpTransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33bbc1e5-44e4-4ee3-b7b5-801dc78956e4
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# TcpTransportBindingElement
+TcpTransportBindingElement  
+  
+## 構文  
+  
+```  
+class TcpTransportBindingElement : ConnectionOrientedTransportBindingElement  
+{  
+  TcpConnectionPoolSettings ConnectionPoolSettings;  
+  sint32 ListenBacklog;  
+  boolean PortSharingEnabled;  
+  boolean TeredoEnabled;  
+};  
+```  
+  
+## メソッド  
+ TcpTransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TcpTransportBindingElement クラスには、次のプロパティがあります。  
+  
+### ConnectionPoolSettings  
+ データ型 : TcpConnectionPoolSettings  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 接続プールの設定。  
+  
+### ListenBacklog  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 保留可能なキュー内の接続要求の最大数です。  
+  
+### PortSharingEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ TCP ポート共有をこの接続で有効にするかどうかを指定するブール値です。  
+  
+### TeredoEnabled  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ Teredo \(ファイアウォールの内側にあるクライアントをアドレス指定するためのテクノロジ\) を有効にするかどうかを指定するブール値です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/textmessageencodingbindingelement.md b/docs/framework/wcf/diagnostics/wmi/textmessageencodingbindingelement.md
new file mode 100644
index 00000000000..a170a2396f6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/textmessageencodingbindingelement.md
@@ -0,0 +1,75 @@
+---
+title: "TextMessageEncodingBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 885e2d7a-3436-4093-bc5f-0a404c62acdc
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# TextMessageEncodingBindingElement
+TextMessageEncodingBindingElement  
+  
+## 構文  
+  
+```  
+class TextMessageEncodingBindingElement : MessageEncodingBindingElement  
+{  
+  string Encoding;  
+  sint32 MaxReadPoolSize;  
+  sint32 MaxWritePoolSize;  
+  XmlDictionaryReaderQuotas ReaderQuotas;  
+};  
+```  
+  
+## メソッド  
+ TextMessageEncodingBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ TextMessageEncodingBindingElement クラスには、次のプロパティがあります。  
+  
+### Encoding  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングでメッセージの送信に使用される文字セット エンコーディング。  
+  
+### MaxReadPoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいリーダーを割り当てずに同時に読み取り可能なメッセージの数を定義する整数です。  
+  
+### MaxWritePoolSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 新しいライターを割り当てずに同時に送信可能なメッセージの数を定義する整数です。  
+  
+### ReaderQuotas  
+ データ型 : XmlDictionaryReaderQuotas  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ リーダのクォータ。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/tracelistener.md b/docs/framework/wcf/diagnostics/wmi/tracelistener.md
new file mode 100644
index 00000000000..36c676d49ed
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/tracelistener.md
@@ -0,0 +1,56 @@
+---
+title: "TraceListener | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2c0b595-a384-4eb3-b94d-1b3be7cc7a5c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# TraceListener
+TraceListener  
+  
+## 構文  
+  
+```  
+class TraceListener  
+{  
+  string Name;  
+  TraceListenerArgument TraceListenerArguments[];  
+};  
+```  
+  
+## メソッド  
+ TraceListener クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ TraceListener クラスには、次のプロパティがあります。  
+  
+### 名前  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トレース リスナーの名前。  
+  
+### TraceListenerArguments  
+ データ型 : TraceListenerArgument 配列  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トレース リスナーの引数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/tracelistenerargument.md b/docs/framework/wcf/diagnostics/wmi/tracelistenerargument.md
new file mode 100644
index 00000000000..3cf9c2d0d52
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/tracelistenerargument.md
@@ -0,0 +1,56 @@
+---
+title: "TraceListenerArgument | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6c84090-bf96-43f4-9fb0-1ce8fd9c8efe
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# TraceListenerArgument
+TraceListenerArgument  
+  
+## 構文  
+  
+```  
+class TraceListenerArgument  
+{  
+  string Name;  
+  string Value;  
+};  
+```  
+  
+## メソッド  
+ TraceListenerArgument クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ TraceListenerArgument クラスには、次のプロパティがあります。  
+  
+### 名前  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 引数の名前。  
+  
+### 値  
+ データ型: string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 引数の値です。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/transactedbatchingbehavior.md b/docs/framework/wcf/diagnostics/wmi/transactedbatchingbehavior.md
new file mode 100644
index 00000000000..ee0a89ccc3c
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/transactedbatchingbehavior.md
@@ -0,0 +1,51 @@
+---
+title: "TransactedBatchingBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d03e6ae-f06c-4ada-b279-e01838b2ecdc
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# TransactedBatchingBehavior
+TransactedBatchingBehavior  
+  
+## 構文  
+  
+```  
+class TransactedBatchingBehavior : Behavior  
+{  
+  sint32 MaxBatchSize;  
+};  
+```  
+  
+## メソッド  
+ TransactedBatchingBehavior クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TransactedBatchingBehavior クラスには、次のプロパティがあります。  
+  
+### MaxBatchSize  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクション バッチの最大バッチ サイズ。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.TransactedBatchingBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/transactionflowattribute.md b/docs/framework/wcf/diagnostics/wmi/transactionflowattribute.md
new file mode 100644
index 00000000000..3987be25f7f
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/transactionflowattribute.md
@@ -0,0 +1,51 @@
+---
+title: "TransactionFlowAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a9c8674-29f7-4f14-aa1f-dc2644ca57e4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# TransactionFlowAttribute
+TransactionFlowAttribute  
+  
+## 構文  
+  
+```  
+class TransactionFlowAttribute : Behavior  
+{  
+  string TransactionFlowOption;  
+};  
+```  
+  
+## メソッド  
+ TransactionFlowAttribute クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TransactionFlowAttribute クラスには、次のプロパティがあります。  
+  
+### TransactionFlowOption  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクションがフローするかどうかを示します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.TransactionFlowAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/transactionflowbindingelement.md b/docs/framework/wcf/diagnostics/wmi/transactionflowbindingelement.md
new file mode 100644
index 00000000000..d9bce9101d6
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/transactionflowbindingelement.md
@@ -0,0 +1,67 @@
+---
+title: "TransactionFlowBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a9656fe-2400-45ca-ad79-92715c8cf190
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# TransactionFlowBindingElement
+TransactionFlowBindingElement  
+  
+## 構文  
+  
+```  
+class TransactionFlowBindingElement : BindingElement  
+{  
+  string IssuedTokens;  
+  string TransactionProtocol;  
+  boolean Transactions;  
+};  
+```  
+  
+## メソッド  
+ TransactionFlowBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TransactionFlowBindingElement クラスには、次のプロパティがあります。  
+  
+### IssuedTokens  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 発行されるセキュリティ トークン ヘッダー \(WS\-Trust からの IssuedTokens\) の要件を指定します。  
+  
+### TransactionProtocol  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランザクションをフローさせるためにサービスによって使用されるトランザクション プロトコルです。  
+  
+### Transactions  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 受信トランザクションをサポートするかどうかを示します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TransactionFlowBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/transportbindingelement.md b/docs/framework/wcf/diagnostics/wmi/transportbindingelement.md
new file mode 100644
index 00000000000..b6605f2c808
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/transportbindingelement.md
@@ -0,0 +1,75 @@
+---
+title: "TransportBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54ecfbee-53c0-410c-a7fa-a98f2e40c545
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# TransportBindingElement
+TransportBindingElement  
+  
+## 構文  
+  
+```  
+class TransportBindingElement : BindingElement  
+{  
+  boolean ManualAddressing;  
+  sint64 MaxBufferPoolSize;  
+  sint64 MaxReceivedMessageSize;  
+  string Scheme;  
+};  
+```  
+  
+## メソッド  
+ TransportBindingElement クラスは、メソッドを一切定義しません。  
+  
+## プロパティ  
+ TransportBindingElement クラスには、次のプロパティがあります。  
+  
+### ManualAddressing  
+ データ型 : boolean  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ メッセージのアドレス指定をユーザーが制御するかどうかを指定するブール値。  
+  
+### MaxBufferPoolSize  
+ データ型 : sint64  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ バインディングに使用するバッファー プールの最大サイズ。  
+  
+### MaxReceivedMessageSize  
+ データ型 : sint64  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ このバインディングで処理されるメッセージの最大サイズ。  
+  
+### Scheme  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ トランスポートの URI スキーム。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/transportsecuritybindingelement.md b/docs/framework/wcf/diagnostics/wmi/transportsecuritybindingelement.md
new file mode 100644
index 00000000000..819ecc00ade
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/transportsecuritybindingelement.md
@@ -0,0 +1,40 @@
+---
+title: "TransportSecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31b8cd3b-3be5-4b6c-93f0-69d7aaf791d0
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# TransportSecurityBindingElement
+TransportSecurityBindingElement  
+  
+## 構文  
+  
+```  
+class TransportSecurityBindingElement : SecurityBindingElement  
+{  
+};  
+```  
+  
+## メソッド  
+ TransportSecurityBindingElement クラスは、SecurityBindingElement を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/usemanagedpresentationbindingelement.md b/docs/framework/wcf/diagnostics/wmi/usemanagedpresentationbindingelement.md
new file mode 100644
index 00000000000..7610a62e123
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/usemanagedpresentationbindingelement.md
@@ -0,0 +1,40 @@
+---
+title: "UseManagedPresentationBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 013f3628-a08f-4db9-b07f-77f889e41db7
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# UseManagedPresentationBindingElement
+UseManagedPresentationBindingElement  
+  
+## 構文  
+  
+```  
+class UseManagedPresentationBindingElement : BindingElement  
+{  
+};  
+```  
+  
+## メソッド  
+ UseManagedPresentationBindingElement クラスは、BindingElement を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.UseManagedPresentationBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/windowsstreamsecuritybindingelement.md b/docs/framework/wcf/diagnostics/wmi/windowsstreamsecuritybindingelement.md
new file mode 100644
index 00000000000..afb571f04af
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/windowsstreamsecuritybindingelement.md
@@ -0,0 +1,51 @@
+---
+title: "WindowsStreamSecurityBindingElement | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4b0508c5-669c-4fe3-9225-8a10f8ee3be4
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# WindowsStreamSecurityBindingElement
+WindowsStreamSecurityBindingElement  
+  
+## 構文  
+  
+```  
+class WindowsStreamSecurityBindingElement : BindingElement  
+{  
+  string ProtectionLevel;  
+};  
+```  
+  
+## メソッド  
+ WindowsStreamSecurityBindingElement クラスで定義されているメソッドはありません。  
+  
+## プロパティ  
+ WindowsStreamSecurityBindingElement クラスには、次のプロパティがあります。  
+  
+### ProtectionLevel  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ TCP ストリームの保護レベル。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み|  
+|---------|-----------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/wmi-class-reference.md b/docs/framework/wcf/diagnostics/wmi/wmi-class-reference.md
new file mode 100644
index 00000000000..52ef752acea
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/wmi-class-reference.md
@@ -0,0 +1,172 @@
+---
+title: "WMI クラスの参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b95a51f5-8251-4619-ae05-7de88cb90f9a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WMI クラスの参照
+このセクションでは、[!INCLUDE[indigo1](../../../../../includes/indigo1-md.md)] WMI プロバイダーが公開しているすべての WMI クラスを示します。  
+  
+## <a name="accessing-wmi-instances"></a>WMI インスタンスへのアクセス  
+ WMI オブジェクト リファレンスに記載されているクラスはすべて、インスタンスを直接生成することはできません。ただし Service、AppDomain、Contract、ServiceAppDomain、ServiceToEndpointAssociation、Endpoint の各クラスを除きます。 他のインスタンスには、これらのトップ レベル クラスのプロパティからアクセスできます。 たとえば TransportBindingElement のインスタンスには、Endpoint のインスタンスから、Binding、BindingElements の順にたどってアクセスできます。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [ActivityTransfer](../../../../../docs/framework/wcf/diagnostics/wmi/activitytransfer.md)  
+  
+ [AppDomainInfo](../../../../../docs/framework/wcf/diagnostics/wmi/appdomaininfo.md)  
+  
+ [AspNetCompatibilityRequirementsAttribute](../../../../../docs/framework/wcf/diagnostics/wmi/aspnetcompatibilityrequirementsattribute.md)  
+  
+ [AsymmetricSecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/asymmetricsecuritybindingelement.md)  
+  
+ 「動作クラス」  
+  
+ [BinaryMessageEncodingBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/binarymessageencodingbindingelement.md)  
+  
+ [バインド](../../../../../docs/framework/wcf/diagnostics/wmi/binding.md)  
+  
+ [BindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/bindingelement.md)  
+  
+ [CallbackBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/callbackbehavior.md)  
+  
+ [チャネル クラス](../../../../../docs/framework/wcf/diagnostics/wmi/channel-class.md)  
+  
+ [ChannelPoolSettings](../../../../../docs/framework/wcf/diagnostics/wmi/channelpoolsettings.md)  
+  
+ [ClientCredentials](../../../../../docs/framework/wcf/diagnostics/wmi/clientcredentials.md)  
+  
+ [ClientViaBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/clientviabehavior.md)  
+  
+ [CompositeDuplexBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/compositeduplexbindingelement.md)  
+  
+ [ConnectionOrientedTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/connectionorientedtransportbindingelement.md)  
+  
+ [コントラクト](../../../../../docs/framework/wcf/diagnostics/wmi/contract.md)  
+  
+ [CustomBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/custombindingelement.md)  
+  
+ [DeliveryRequirementsAttribute](../../../../../docs/framework/wcf/diagnostics/wmi/deliveryrequirementsattribute.md)  
+  
+ [エンドポイント](../../../../../docs/framework/wcf/diagnostics/wmi/endpoint.md)  
+  
+ [HttpsTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/httpstransportbindingelement.md)  
+  
+ [HttpTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/httptransportbindingelement.md)  
+  
+ [LocalServiceSecuritySettings](../../../../../docs/framework/wcf/diagnostics/wmi/localservicesecuritysettings.md)  
+  
+ [MatchAllEndpointBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/matchallendpointbehavior.md)  
+  
+ [MessageEncodingBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/messageencodingbindingelement.md)  
+  
+ [MsmqBindingElementBase](../../../../../docs/framework/wcf/diagnostics/wmi/msmqbindingelementbase.md)  
+  
+ [MsmqIntegrationBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/msmqintegrationbindingelement.md)  
+  
+ [MsmqTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/msmqtransportbindingelement.md)  
+  
+ [MtomMessageEncodingBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/mtommessageencodingbindingelement.md)  
+  
+ [MustUnderstandBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/mustunderstandbehavior.md)  
+  
+ [NamedPipeConnectionPoolSettings](../../../../../docs/framework/wcf/diagnostics/wmi/namedpipeconnectionpoolsettings.md)  
+  
+ [NamedPipeTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/namedpipetransportbindingelement.md)  
+  
+ [OneWayBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/onewaybindingelement.md)  
+  
+ 「操作クラス」  
+  
+ [OperationBehaviorAttribute](../../../../../docs/framework/wcf/diagnostics/wmi/operationbehaviorattribute.md)  
+  
+ [PeerCustomResolverBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/peercustomresolverbindingelement.md)  
+  
+ [PeerResolverBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/peerresolverbindingelement.md)  
+  
+ [PeerSecuritySettings](../../../../../docs/framework/wcf/diagnostics/wmi/peersecuritysettings.md)  
+  
+ [PeerTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/peertransportbindingelement.md)  
+  
+ [PeerTransportSecuritySettings](../../../../../docs/framework/wcf/diagnostics/wmi/peertransportsecuritysettings.md)  
+  
+ [PnrpPeerResolverBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/pnrppeerresolverbindingelement.md)  
+  
+ [PrivacyNoticeBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/privacynoticebindingelement.md)  
+  
+ [ReliableSessionBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/reliablesessionbindingelement.md)  
+  
+ [SecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/securitybindingelement.md)  
+  
+ [サービス](../../../../../docs/framework/wcf/diagnostics/wmi/service.md)  
+  
+ [ServiceAppDomain](../../../../../docs/framework/wcf/diagnostics/wmi/serviceappdomain.md)  
+  
+ [ServiceAuthorizationBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/serviceauthorizationbehavior.md)  
+  
+ [ServiceBehaviorAttribute](../../../../../docs/framework/wcf/diagnostics/wmi/servicebehaviorattribute.md)  
+  
+ [ServiceCredentials](../../../../../docs/framework/wcf/diagnostics/wmi/servicecredentials.md)  
+  
+ [ServiceDebugBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/servicedebugbehavior.md)  
+  
+ [ServiceMetadataBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/servicemetadatabehavior.md)  
+  
+ [ServiceSecurityAuditBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/servicesecurityauditbehavior.md)  
+  
+ [ServiceThrottlingBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/servicethrottlingbehavior.md)  
+  
+ [ServiceTimeoutsBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/servicetimeoutsbehavior.md)  
+  
+ [ServiceToEndpointAssociation](../../../../../docs/framework/wcf/diagnostics/wmi/servicetoendpointassociation.md)  
+  
+ [SslStreamSecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/sslstreamsecuritybindingelement.md)  
+  
+ [SymmetricSecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/symmetricsecuritybindingelement.md)  
+  
+ [SynchronousReceiveBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/synchronousreceivebehavior.md)  
+  
+ [TcpConnectionPoolSettings](../../../../../docs/framework/wcf/diagnostics/wmi/tcpconnectionpoolsettings.md)  
+  
+ [TcpTransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/tcptransportbindingelement.md)  
+  
+ [TextMessageEncodingBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/textmessageencodingbindingelement.md)  
+  
+ [TraceListener](../../../../../docs/framework/wcf/diagnostics/wmi/tracelistener.md)  
+  
+ [TraceListenerArgument](../../../../../docs/framework/wcf/diagnostics/wmi/tracelistenerargument.md)  
+  
+ [TransactedBatchingBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/transactedbatchingbehavior.md)  
+  
+ [TransactionFlowAttribute](../../../../../docs/framework/wcf/diagnostics/wmi/transactionflowattribute.md)  
+  
+ [TransactionFlowBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/transactionflowbindingelement.md)  
+  
+ [TransportBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/transportbindingelement.md)  
+  
+ [TransportSecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/transportsecuritybindingelement.md)  
+  
+ [UseManagedPresentationBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/usemanagedpresentationbindingelement.md)  
+  
+ [WindowsStreamSecurityBindingElement](../../../../../docs/framework/wcf/diagnostics/wmi/windowsstreamsecuritybindingelement.md)  
+  
+ [WSAT_TraceEvent](../../../../../docs/framework/wcf/diagnostics/wmi/wsat-traceevent.md)  
+  
+ [WSAT_TraceProvider](../../../../../docs/framework/wcf/diagnostics/wmi/wsat-traceprovider.md)  
+  
+ [WSAT_TraceRecord](../../../../../docs/framework/wcf/diagnostics/wmi/wsat-tracerecord.md)  
+  
+ [XmlDictionaryReaderQuotas](../../../../../docs/framework/wcf/diagnostics/wmi/xmldictionaryreaderquotas.md)  
+  
+ [XmlSerializerOperationBehavior](../../../../../docs/framework/wcf/diagnostics/wmi/xmlserializeroperationbehavior.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/wsat-traceevent.md b/docs/framework/wcf/diagnostics/wmi/wsat-traceevent.md
new file mode 100644
index 00000000000..881205a3399
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/wsat-traceevent.md
@@ -0,0 +1,37 @@
+---
+title: "WSAT_TraceEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 142aa03f-781c-4ca4-bc21-0e64b1ff9b6a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WSAT_TraceEvent
+WSAT\_TraceEvent  
+  
+## 構文  
+  
+```  
+class WSAT_TraceEvent : WSAT_TraceProvider  
+{  
+};  
+```  
+  
+## メソッド  
+ WSAT\_TraceEvent クラスは WSAT\_TraceProvider を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/wsat-traceprovider.md b/docs/framework/wcf/diagnostics/wmi/wsat-traceprovider.md
new file mode 100644
index 00000000000..2efd5eea791
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/wsat-traceprovider.md
@@ -0,0 +1,37 @@
+---
+title: "WSAT_TraceProvider | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8eb89b45-78b8-407d-8858-f8a9d43d55cb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WSAT_TraceProvider
+WSAT\_TraceProvider  
+  
+## 構文  
+  
+```  
+class WSAT_TraceProvider : EventTrace  
+{  
+};  
+```  
+  
+## メソッド  
+ WSAT\_TraceProvider クラスは EventTrace を継承しますが、追加のメソッドやプロパティを定義しません。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof で定義|  
+|---------|--------------------------|  
+|Namespace|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/wsat-tracerecord.md b/docs/framework/wcf/diagnostics/wmi/wsat-tracerecord.md
new file mode 100644
index 00000000000..f034c374846
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/wsat-tracerecord.md
@@ -0,0 +1,61 @@
+---
+title: "WSAT_TraceRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99bc7f66-1335-40d8-aa68-e754d569dc0d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WSAT_TraceRecord
+WSAT\_TraceRecord  
+  
+## 構文  
+  
+```  
+class WSAT_TraceRecord : WSAT_TraceEvent  
+{  
+  object ActivityID;  
+  sint32 EventID;  
+  string TraceRecord;  
+};  
+```  
+  
+## メソッド  
+ WSAT\_TraceRecord クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ WSAT\_TraceRecord クラスには、次のプロパティがあります。  
+  
+### ActivityID  
+ データ型: object  
+アクセスの種類 : 読み取り専用  
+  
+ トレース レコードのアクティビティ ID です。  
+  
+### EventID  
+ データ型 : sint32  
+アクセスの種類 : 読み取り専用  
+  
+ トレース レコードのイベント ID です。  
+  
+### TraceRecord  
+ データ型: string  
+アクセスの種類 : 読み取り専用  
+  
+ トレース レコード  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/xmldictionaryreaderquotas.md b/docs/framework/wcf/diagnostics/wmi/xmldictionaryreaderquotas.md
new file mode 100644
index 00000000000..2536fce932d
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/xmldictionaryreaderquotas.md
@@ -0,0 +1,84 @@
+---
+title: "XmlDictionaryReaderQuotas | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b4ca8b4-0a89-4758-97ab-528a8ce18f07
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# XmlDictionaryReaderQuotas
+XmlDictionaryReaderQuotas  
+  
+## 構文  
+  
+```  
+class XmlDictionaryReaderQuotas  
+{  
+  sint32 MaxArrayLength;  
+  sint32 MaxBytesPerRead;  
+  sint32 MaxDepth;  
+  sint32 MaxNameTableCharCount;  
+  sint32 MaxStringContentLength;  
+};  
+```  
+  
+## メソッド  
+ XmlDictionaryReaderQuotas クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ XmlDictionaryReaderQuotas クラスには、次のプロパティがあります。  
+  
+### MaxArrayLength  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 許される最大配列長。  
+  
+### MaxBytesPerRead  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 1 回の読み取りで返すことができる最大バイト数。  
+  
+### MaxDepth  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ 1 回の読み取りでの最大ネスト ノード深度。  
+  
+### MaxNameTableCharCount  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ テーブル名の最大文字数。  
+  
+### MaxStringContentLength  
+ データ型 : sint32  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ XML 要素のコンテンツで許可される最大文字数。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.Xml.XmlDictionaryReaderQuotas>   
+ <xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/diagnostics/wmi/xmlserializeroperationbehavior.md b/docs/framework/wcf/diagnostics/wmi/xmlserializeroperationbehavior.md
new file mode 100644
index 00000000000..048e0932529
--- /dev/null
+++ b/docs/framework/wcf/diagnostics/wmi/xmlserializeroperationbehavior.md
@@ -0,0 +1,59 @@
+---
+title: "XmlSerializerOperationBehavior | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8911aa1b-e34b-4161-a3ae-7468d89a6861
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# XmlSerializerOperationBehavior
+XmlSerializerOperationBehavior  
+  
+## 構文  
+  
+```  
+class XmlSerializerOperationBehavior : Behavior  
+{  
+  string Style;  
+  string Use;  
+};  
+```  
+  
+## メソッド  
+ XmlSerializerOperationBehavior クラスで定義されるメソッドはありません。  
+  
+## プロパティ  
+ XmlSerializerOperationBehavior クラスには、次のプロパティがあります。  
+  
+### Style  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ SOAP メッセージのスタイルを定義します。  
+  
+### Use  
+ データ型 : string  
+  
+ アクセスの種類 : 読み取り専用  
+  
+ SOAP エンコード スタイルを指定します。  
+  
+## 要件  
+  
+|MOF|Servicemodel.mof にて宣言済み。|  
+|---------|------------------------------|  
+|名前空間|root\\ServiceModel で定義|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior>
\ No newline at end of file
diff --git a/docs/framework/wcf/endpoint-creation-overview.md b/docs/framework/wcf/endpoint-creation-overview.md
new file mode 100644
index 00000000000..6702b92b509
--- /dev/null
+++ b/docs/framework/wcf/endpoint-creation-overview.md
@@ -0,0 +1,209 @@
+---
+title: "エンドポイントの作成の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "エンドポイント [WCF], 概要"
+ms.assetid: f4dce0fb-6f54-47e6-8054-86d7f574b91c
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# エンドポイントの作成の概要
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスを使用して行われるすべての通信では、サービスの*エンドポイント*が使用されます。  エンドポイントは、クライアントが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスによって提供される機能にアクセスできるようにします。  ここでは、エンドポイントの構造を説明し、構成やコード内にエンドポイントを定義する方法を概説します。  
+  
+## エンドポイントの構造  
+ 各エンドポイントは、そのエンドポイントが存在する場所を示すアドレス、クライアントがエンドポイントと通信するための方法を指定するバインディング、および利用可能なメソッドを特定するコントラクトで構成されます。  
+  
+-   **アドレス**。  アドレスは、エンドポイントを一意に識別し、潜在的ユーザーにそのサービスの場所を示します。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] オブジェクト モデルでは、<xref:System.ServiceModel.EndpointAddress> アドレスで表されます。このアドレスは、URI \(Uniform Resource Identifier\) とアドレス プロパティ \(ID、Web サービス記述言語 \(WSDL\) 要素、およびオプション ヘッダーのコレクションを含む\) を格納します。  オプション ヘッダーは、エンドポイントの識別または対話のために、より詳細なアドレス指定情報を提供します。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md).  
+  
+-   **バインディング**。  バインディングはエンドポイントとの通信方法を指定します。  バインディングでは、使用するトランスポート プロトコル \(TCP や HTTP\)、メッセージのエンコーディング方法 \(テキストやバイナリ\)、必要なセキュリティ要件 \(SSL \(Secure Sockets Layer\) や SOAP メッセージ セキュリティ\) など、そのエンドポイントがどのように通信を行うかを指定します。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md).  
+  
+-   **サービス コントラクト**。  サービス コントラクトは、エンドポイントがクライアントに公開する機能を示します。  コントラクトは、クライアントが呼び出すことのできる操作、メッセージの形式、操作の呼び出しに必要な入力パラメーターやデータの型、クライアントに提供する処理または応答メッセージの種類を指定します。  基本的なメッセージ交換パターン \(MEP\) に対応する基本的なコントラクトの種類には、データグラム \(一方向\)、要求\/応答、二重 \(双方向\) の 3 つがあります。  サービス コントラクトは、データ コントラクトとメッセージ コントラクトを使用して、クライアントが特定のデータ型とメッセージ形式でアクセスするように要求することもできます。  サービス コントラクトの定義方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  クライアントでは、二重 MEP でサービスからメッセージを受信するために、コールバック コントラクトというサービス定義のコントラクトを実装することが必要な場合があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md).  
+  
+ サービスのエンドポイントはコードを使用して強制的に指定するか、構成を介して宣言として指定できます。  エンドポイントが指定されていない場合、ランタイムは、サービスで実装されたサービス コントラクトごとに、1 つの既定のエンドポイントを各ベース アドレスに追加することで、既定のエンドポイントを提供します。  設置済みサービスのバインドおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。  一般に、サービス エンドポイントの定義にはコードではなく、構成を使用する方がより実用的です。  バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+> [!NOTE]
+>  偽装を行うサービス エンドポイントを追加する場合は、<xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドまたは <xref:System.ServiceModel.Description.ContractDescription.GetContract%28System.Type%2CSystem.Type%29> メソッドのいずれかを使用して、コントラクトを新しい <xref:System.ServiceModel.Description.ServiceDescription> オブジェクトに適切に読み込む必要があります。  
+  
+## コードでのエンドポイントの定義  
+ 次の例は、コードにエンドポイントを指定する方法を示しています。  
+  
+-   誰かの名前を受け取り、"Hello \<名前\>\!" というエコーで応答する `IEcho` タイプのサービス コントラクトを定義します。  
+  
+-   `IEcho` コントラクトで定義された型の `Echo` サービスを実装します。  
+  
+-   サービスのエンドポイント アドレスとして http:\/\/localhost:8000\/Echo を指定します。  
+  
+-   <xref:System.ServiceModel.WSHttpBinding> バインディングを使用して `Echo` サービスを構成します。  
+  
+```csharp  
+Namespace Echo  
+{  
+   // Define the contract for the IEcho service   
+   [ServiceContract]  
+   public interface IEcho  
+   {  
+       [OperationContract]  
+       String Hello(string name)  
+   }  
+  
+   // Create an Echo service that implements IEcho contract  
+   class Echo : IEcho  
+   {  
+      public string Hello(string name)  
+      {  
+         return "Hello" + name + "!";  
+      }  
+      public static void Main ()  
+      {  
+          //Specify the base address for Echo service.  
+          Uri echoUri = new Uri("http://localhost:8000/");  
+  
+          //Create a ServiceHost for the Echo service.  
+          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);  
+  
+          // Use a predefined WSHttpBinding to configure the service.  
+          WSHttpBinding binding = new WSHttpBinding();  
+  
+          // Add the endpoint for this service to the service host.  
+          serviceHost.AddServiceEndpoint(  
+             typeof(IEcho),   
+             binding,   
+             echoUri  
+           );  
+  
+          // Open the service host to run it.  
+          serviceHost.Open();  
+     }  
+  }  
+}  
+```  
+  
+```vb  
+' Define the contract for the IEcho service  
+    <ServiceContract()> _  
+    Public Interface IEcho  
+        <OperationContract()> _  
+        Function Hello(ByVal name As String) As String  
+    End Interface  
+  
+' Create an Echo service that implements IEcho contract  
+    Public Class Echo   
+        Implements IEcho  
+        Public Function Hello(ByVal name As String) As String _  
+ Implements ICalculator.Hello  
+            Dim result As String = "Hello" + name + "!"  
+            Return result  
+        End Function  
+  
+' Specify the base address for Echo service.  
+Dim echoUri As Uri = New Uri("http://localhost:8000/")  
+  
+' Create a ServiceHost for the Echo service.  
+Dim svcHost As ServiceHost = New ServiceHost(GetType(HelloWorld), echoUri)  
+  
+' Use a predefined WSHttpBinding to configure the service.  
+Dim binding As New WSHttpBinding()  
+  
+' Add the endpoint for this service to the service host.  
+serviceHost.AddServiceEndpoint(GetType(IEcho), binding, echoUri)  
+  
+' Open the service host to run it.  
+serviceHost.Open()  
+```  
+  
+> [!NOTE]
+>  サービス ホストはベース アドレスを使用して作成されます。また、残りのアドレス \(ベース アドレスの相対アドレス\) はエンドポイントの一部として指定されます。  このようにアドレスを分割することで、ホストのサービスで複数のエンドポイントを簡単に定義できるようになります。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.ServiceHostBase> の <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A> メソッドの後で、サービス アプリケーションの <xref:System.ServiceModel.Description.ServiceDescription> の各プロパティを変更しないでください。  このメソッドの後で変更すると、<xref:System.ServiceModel.ServiceHostBase> および <xref:System.ServiceModel.ServiceHost> の <xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティや `AddServiceEndpoint` メソッドなどの一部のメンバーは例外をスローします。  変更を許可するメンバーもありますが、結果は未定義の状態になります。  
+>   
+>  同様に、クライアントで、<xref:System.ServiceModel.ChannelFactory> の <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A> 呼び出しの後で、<xref:System.ServiceModel.Description.ServiceEndpoint> 値を変更しないでください。  この呼び出しの後で変更すると、<xref:System.ServiceModel.ChannelFactory.Credentials%2A> プロパティは例外をスローします。  その他のクライアント記述値は、エラーを発生させずに変更できますが、結果は未定義の状態になります。  
+>   
+>  サービスとクライアントのどちらの場合も、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> の呼び出しの前に記述を変更することをお勧めします。  
+  
+## 構成でのエンドポイントの定義  
+ アプリケーションの作成では、各種決定事項をアプリケーションを展開する管理者に任せる場合がよくあります。  たとえば、どのサービス アドレス \(URI\) を使用するかなどの情報は、前もって知るすべがありません。  アドレスをハードコーディングする代わりに、サービスの作成後に管理者が指定する方が便利です。  構成を活用することで、この柔軟性が得られます。  詳細については、「[サービスの構成](../../../docs/framework/wcf/configuring-services.md)」を参照してください。  
+  
+> [!NOTE]
+>  構成ファイルをすばやく作成するには、`/config:`*filename*`[,`*filename*`]` スイッチを指定して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用します。  
+  
+## 既定のエンドポイントの使用  
+ エンドポイントがコードまたは構成で指定されていない場合、ランタイムは、サービスで実装されたサービス コントラクトごとに、1 つの既定のエンドポイントを各ベース アドレスに追加することで、既定のエンドポイントを提供します。  ベース アドレスはコードまたは構成で指定することができ、既定のエンドポイントは、<xref:System.ServiceModel.ServiceHost.Open%2A> が <xref:System.ServiceModel.ServiceHost> で呼び出されるときに追加されます。  次の例は上記のセクションの例と同じです。ただし、エンドポイントを指定せず、既定のエンドポイントを追加する点が異なります。  
+  
+```csharp  
+Namespace Echo  
+{  
+   // Define the contract for the IEcho service   
+   [ServiceContract]  
+   Interface IEcho  
+   {  
+       [OperationContract]  
+       String Hello(string name)  
+   }  
+  
+   // Create an Echo service that implements IEcho contract  
+   Class Echo : IEcho  
+   {  
+      Public string Hello(string name)  
+      {  
+         return "Hello" + name + "!";  
+      }  
+      static void Main ()  
+      {  
+          //Specify the base address for Echo service.  
+          Uri echoUri = new Uri("http://localhost:8000/");  
+  
+          //Create a ServiceHost for the Echo service.  
+          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);  
+  
+          // Open the service host to run it. Default endpoints  
+          // are added when the service is opened.  
+          serviceHost.Open();  
+     }  
+  }  
+}  
+```  
+  
+```vb  
+' Define the contract for the IEcho service  
+    <ServiceContract()> _  
+    Public Interface IEcho  
+        <OperationContract()> _  
+        Function Hello(ByVal name As String) As String  
+    End Interface  
+  
+' Create an Echo service that implements IEcho contract  
+    Public Class Echo   
+        Implements IEcho  
+        Public Function Hello(ByVal name As String) As String _  
+ Implements ICalculator.Hello  
+            Dim result As String = "Hello" + name + "!"  
+            Return result  
+        End Function  
+  
+' Specify the base address for Echo service.  
+Dim echoUri As Uri = New Uri("http://localhost:8000/")  
+  
+' Open the service host to run it. Default endpoints  
+' are added when the service is opened.  
+serviceHost.Open()  
+```  
+  
+ エンドポイントを明示的に指定しない場合、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> を呼び出す前に、<xref:System.ServiceModel.ServiceHost> で <xref:System.ServiceModel.ServiceHostBase.AddDefaultEndpoints%2A> を呼び出すことによって、既定のエンドポイントを引き続き追加できます。  既定のエンドポイント[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 参照  
+ [サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/endpoints.md b/docs/framework/wcf/endpoints.md
new file mode 100644
index 00000000000..c2f4f9bff46
--- /dev/null
+++ b/docs/framework/wcf/endpoints.md
@@ -0,0 +1,60 @@
+---
+title: "Windows Communication Foundation エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エンドポイント [WCF]"
+ms.assetid: bd0c310f-dd9f-4081-9be2-3db5909850b6
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# Windows Communication Foundation エンドポイント
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスを使用して行われるすべての通信では、サービスの*エンドポイント*が使用されます。  エンドポイントは、クライアントが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスによって提供される機能にアクセスできるようにします。  
+  
+ エンドポイントの作成方法の概要については、「[エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)」を参照してください。  エンドポイントは次の要素から成ります。  
+  
+-   そのエンドポイントの場所を示すアドレス。  
+  
+-   クライアントがエンドポイントと通信する方法を指定するバインディング。  
+  
+-   利用可能なメソッドを指定するためのコントラクト。  
+  
+ エンドポイントを構成する個々の要素を指定する方法については、以下を参照してください。  
+  
+-   [エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md)  
+  
+-   [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)  
+  
+-   [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)  
+  
+## このセクションの内容  
+ [エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)  
+ エンドポイントの構造を説明し、構成やコード内にエンドポイントを定義する方法と、ランタイムによって提供される既定のエンドポイント、バインディング、および動作の使用方法を解説します。  
+  
+ [エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md)  
+ エンドポイントを通して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと通信する方法を解説します。  
+  
+ [方法 : 構成にサービス エンドポイントを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)  
+ 構成でサービス エンドポイントを作成する方法を解説します。  
+  
+ [方法 : コード内にサービス エンドポイントを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md)  
+ コードでサービス エンドポイントを作成する方法を解説します。  
+  
+ [メタデータ エンドポイントを公開する](../../../docs/framework/wcf/publishing-metadata-endpoints.md)  
+ 構成およびコードでメタデータ エンドポイントを公開することによりってメタデータを公開する方法を解説します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.EndpointAddress>  
+  
+## 関連項目  
+ [基本的なプログラミング ライフサイクル](../../../docs/framework/wcf/basic-programming-lifecycle.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/TOC.md b/docs/framework/wcf/extending/TOC.md
new file mode 100644
index 00000000000..5b28699d21e
--- /dev/null
+++ b/docs/framework/wcf/extending/TOC.md
@@ -0,0 +1,64 @@
+# [カスタム エンコーダー](custom-encoders.md)
+# [方法 : システム指定のバインディングをカスタマイズする](how-to-customize-a-system-provided-binding.md)
+# [方法 : カスタム クライアント ID 検証機能を作成する](how-to-create-a-custom-client-identity-verifier.md)
+# [クライアント : チャネル ファクトリとチャネル](client-channel-factories-and-channels.md)
+# [カスタム ストリームのアップグレード](custom-stream-upgrades.md)
+# [方法 : カスタム WSDL をインポートする](how-to-import-custom-wsdl.md)
+# [方法 : カスタム セキュリティ トークン プロバイダーを作成する](how-to-create-a-custom-security-token-provider.md)
+# [カスタム資格情報と資格情報の検証](custom-credential-and-credential-validation.md)
+# [カスタム暗号アルゴリズムの指定](specifying-a-custom-crypto-algorithm.md)
+# [方法 : カスタム クレームを作成する](how-to-create-a-custom-claim.md)
+# [認証のためのサービスの ID のオーバーライド](overriding-the-identity-of-a-service-for-authentication.md)
+# [ディスパッチャーの拡張](extending-dispatchers.md)
+# [方法 : カスタム WS-Metadata Exchange バインディングを構成する](how-to-configure-a-custom-ws-metadata-exchange-binding.md)
+# [ユーザー定義バインディングの作成](creating-user-defined-bindings.md)
+# [方法 : カスタム プリンシパル ID を作成する](how-to-create-a-custom-principal-identity.md)
+# [WCF の拡張](extending-wcf.md)
+# [カスタム メッセージ フォーマッタ](custom-message-formatters.md)
+# [ServiceHostFactory を使用したホストの拡張](extending-hosting-using-servicehostfactory.md)
+# [拡張可能オブジェクト](extensible-objects.md)
+# [方法 : カスタム証明書検証を使用するサービスを作成する](how-to-create-a-service-that-employs-a-custom-certificate-validator.md)
+# [方法 : クライアントのメッセージを検査または変更する](how-to-inspect-or-modify-messages-on-the-client.md)
+# [方法 : X.509 証明書の秘密キーの暗号化プロバイダーを変更する](change-cryptographic-provider-x509-certificate-private-key.md)
+# [方法 : パラメーターを検査または変更する](how-to-inspect-or-modify-parameters.md)
+# [状態変更の理解](understanding-state-changes.md)
+# [例外とエラーの処理](handling-exceptions-and-faults.md)
+# [セキュリティの拡張](extending-security.md)
+# [方法 : サービスのメッセージを検査および変更する](how-to-inspect-and-modify-messages-on-the-service.md)
+# [方法 : カスタム ポリシー アサーションをエクスポートする](how-to-export-custom-policy-assertions.md)
+# [エンコーダーとシリアライザーの拡張](extending-encoders-and-serializers.md)
+# [ServiceHost とサービス モデル レイヤーの拡張](extending-servicehost-and-the-service-model-layer.md)
+# [カスタム バインディングを介したメタデータの公開と取得](publishing-and-retrieving-metadata-over-a-custom-binding.md)
+# [サービス チャネル レベルのプログラミング](service-channel-level-programming.md)
+# [サービス : チャネル リスナーとチャネル](service-channel-listeners-and-channels.md)
+# [メタデータ システムの拡張](extending-the-metadata-system.md)
+# [データ コントラクト サロゲート](data-contract-surrogates.md)
+# [カスタム トークン](custom-tokens.md)
+# [方法 : ServiceContractGenerator の拡張を記述する](how-to-write-an-extension-for-the-servicecontractgenerator.md)
+# [WCF 拡張に対するカスタム メタデータのインポート](importing-custom-metadata-for-a-wcf-extension.md)
+# [バインディングとバインディング要素](bindings-and-binding-elements.md)
+# [方法 : カスタム トークンを作成する](how-to-create-a-custom-token.md)
+# [方法 : サービスで使用するカスタム承認マネージャーを作成する](how-to-create-a-custom-authorization-manager-for-a-service.md)
+# [バインディングの拡張](extending-bindings.md)
+# [方法 : カスタム WSDL をエクスポートする](how-to-export-custom-wsdl.md)
+# [カスタム バインディング](custom-bindings.md)
+# [WCF 拡張に対するカスタム メタデータのエクスポート](exporting-custom-metadata-for-a-wcf-extension.md)
+# [カスタム承認](custom-authorization.md)
+# [チャネル レイヤーの拡張](extending-the-channel-layer.md)
+# [クライアントのチャネル レベルのプログラミング](client-channel-level-programming.md)
+# [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](walkthrough-creating-custom-client-and-service-credentials.md)
+# [構成とメタデータのサポート](configuration-and-metadata-support.md)
+# [方法: MEX 以外のバインディングを介してメタデータを取得する](how-to-retrieve-metadata-over-a-non-mex-binding.md)
+# [方法 : カスタム ポリシー アサーションをインポートする](how-to-import-custom-policy-assertions.md)
+# [方法 : 企業内のエンドポイントをロックダウンする](how-to-lock-down-endpoints-in-the-enterprise.md)
+# [動作を使用したランタイムの構成と拡張](configuring-and-extending-the-runtime-with-behaviors.md)
+# [クライアントの拡張](extending-clients.md)
+# [WS-MetadataExchange のバインディング](ws-metadataexchange-bindings.md)
+# [方法 : カスタム セキュリティ トークン認証システムを作成する](how-to-create-a-custom-security-token-authenticator.md)
+# [メッセージ交換パターンの選択](choosing-a-message-exchange-pattern.md)
+# [方法 : クレームを比較する](how-to-compare-claims.md)
+# [方法 : 署名および暗号化に個別の X.509 証明書を使用する](how-to-use-separate-x-509-certificates-for-signing-and-encryption.md)
+# [チャネル モデルの概要](channel-model-overview.md)
+# [方法 : カスタム承認ポリシーを作成する](how-to-create-a-custom-authorization-policy.md)
+# [チャネルの開発](developing-channels.md)
+# [BindingElement の作成](creating-a-bindingelement.md)
diff --git a/docs/framework/wcf/extending/bindings-and-binding-elements.md b/docs/framework/wcf/extending/bindings-and-binding-elements.md
new file mode 100644
index 00000000000..fb1cb2f2351
--- /dev/null
+++ b/docs/framework/wcf/extending/bindings-and-binding-elements.md
@@ -0,0 +1,52 @@
+---
+title: "バインディングとバインディング要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング要素 [WCF]"
+ms.assetid: 765ff77b-7682-4ea3-90eb-e4d751e37379
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# バインディングとバインディング要素
+バインディングは、*バインド要素*と呼ばれる特殊な構成要素のコレクションであり、クライアント エンドポイントまたはサービス エンドポイントが構築されるたびにサービス ランタイムによって評価されます。バインディング内のバインド要素の型と順序に基づいて、エンドポイントのチャネル スタック内のプロトコル チャネルとトランスポート チャネルが選択され、スタック順が決定されます。  
+  
+ また、バインディング \(特に、システム指定のバインディング\) は、通常、多数の構成プロパティを持ちますが、これらはカプセル化されたバインド要素の最も頻繁に変更されたプロパティを反映します。  
+  
+ バインディングには、トランスポート バインド要素が 1 つだけ含まれている必要があります。各トランスポート バインド要素は、1 つのメッセージ エンコード バインド要素をバインディングに追加することによってオーバーライドできる既定のメッセージ エンコード バインド要素です。トランスポート バインド要素とエンコーダー バインド要素に加えて、バインディングには任意の数のプロトコル バインド要素を含めることもできます。この要素により、サービスに必要な機能を実装し、エンドポイント間で SOAP メッセージを送信することができます。詳細については、「[サービスとクライアントを構成するためのバインディングの使用](../../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)」を参照してください。  
+  
+## バインディングとバインド要素の拡張  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、広範なシナリオをカバーするシステム指定のバインディングが用意されています \(詳細については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください\)。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されていないバインディングを作成し、使用することが必要になる場合もあります。次のシナリオでは、新しいバインディングを作成する必要があります。  
+  
+-   新しいバインド要素 \(新しいトランスポート バインド要素、エンコード バインド要素、またはプロトコル バインド要素\) を使用する場合。そのバインド要素を含む新しいバインディングを作成する必要があります。たとえば、UDP トランスポートのためのカスタム `UdpTransportBindingElement` を追加した場合は、そのカスタム バインド要素を使用する新しいバインディングを作成する必要があります。<xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> 型を使用してこの動作を実行する方法については、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+-   パブリック プロパティでシステム指定のバインディングが公開されないように既存のバインド要素を構成する場合。たとえば、署名操作と暗号化操作の実行順序を変更するには、新しいバインディングを作成する必要があります。この動作を実行する方法については、「[方法 : システム指定のバインディングをカスタマイズする](../../../../docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md)」を参照してください。  
+  
+-   特定の構成オプションだけを公開する、企業の標準バインディングを確立する場合。たとえば、社内用にセキュリティを無効にできない <xref:System.ServiceModel.WSHttpBinding> のバリエーションを作成するには、<xref:System.ServiceModel.WSHttpBinding> のように動作し、セキュリティが常に有効になる新しいバインディングを作成します。詳細については、「[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」を参照してください。  
+  
+-   特定のカスタム バインド要素を状況に応じて構成または使用するようにメタデータをカスタマイズする場合。バインディングとバインド要素に対するメタデータのサポートの詳細については、「[構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)」を参照してください。  
+  
+-  
+  
+## チャネル、バインディング、およびバインド要素  
+ バインディングとバインド要素は、属性と動作を含むアプリケーション プログラミング モデルと、ファクトリとリスナー、メッセージ エンコーダー、およびトランスポートとプロトコルの実装を含むチャネル モデルを結び付けます。通常、バインド要素とバインディングは、アプリケーション層で使用されるチャネルを有効にするために実装されます。  
+  
+ チャネル層は、サービス層との間でメッセージを送受信し、そのメッセージをエンドポイント間で転送します。クライアントでは、チャネル層はネットワーク エンドポイントへのチャネルを作成するチャネル ファクトリのスタックです。サービスでは、チャネル層はネットワーク エンドポイントで受信されたチャネルを受け入れるチャネル リスナーのスタックです。  
+  
+ 一般的なチャネルの種類としては、プロトコル チャネルとトランスポート チャネルの 2 つがあります。トランスポート チャネルの役割は、ネットワーク エンドポイント間でメッセージを実際に転送することです。トランスポート チャネルは、既定のメッセージ エンコーダーを持ち、メッセージ エンコーダー バインド要素を通じて供給される代替のメッセージ エンコーダーを使用できる必要があります。メッセージ エンコーダーには、<xref:System.ServiceModel.Channels.Message?displayProperty=fullName> をネットワーク上の表現に \(またはその逆方向に\) 変換する役割があります。プロトコル チャネルの役割は、SOAP レベルのプロトコル \(たとえば、WS\-Security や WS\-ReliableMessaging\) を実装することです。  
+  
+ トランスポート チャネルとプロトコル チャネルの主要要件は、必要なチャネル インターフェイスを実装することです。正常に機能するチャネル層を作成するには、ファクトリとリスナーを関連付ける必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でチャネルの実装を使用するには、チャネルごとに <xref:System.ServiceModel.Channels.BindingElement> から派生したバインド要素が関連付けられている必要があります。また、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement> から派生する関連バインディング拡張要素を構成ファイルに含める必要もあります。  
+  
+ 前述のように、メッセージ エンコーダー チャネル、プロトコル チャネル、およびトランスポート チャネルの実装に使用されるバインド要素をスタックすることによりチャネル スタックを形成できます。バインディングは、これらを順序付きセットに並べ替えるための機構です。バインディングとバインド要素は、アプリケーション プログラミング モデルをチャネル モデルに結び付けます。チャネルの実装をコードから直接使用することもできますが、エンコーダー、トランスポート、およびプロトコルがバインド要素として実装されていない限り、サービス層プログラミング モデルから使用できません。  
+  
+ チャネルとそのバインド要素の開発の詳細については、「[チャネル レイヤーの拡張](../../../../docs/framework/wcf/extending/extending-the-channel-layer.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/change-cryptographic-provider-x509-certificate-private-key.md b/docs/framework/wcf/extending/change-cryptographic-provider-x509-certificate-private-key.md
new file mode 100644
index 00000000000..ad9faf45436
--- /dev/null
+++ b/docs/framework/wcf/extending/change-cryptographic-provider-x509-certificate-private-key.md
@@ -0,0 +1,94 @@
+---
+title: "方法 : X.509 証明書の秘密キーの暗号化プロバイダーを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "暗号化プロバイダー [WCF]"
+  - "暗号化プロバイダー [WCF], 変更"
+ms.assetid: b4254406-272e-4774-bd61-27e39bbb6c12
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : X.509 証明書の秘密キーの暗号化プロバイダーを変更する
+ここでは、X.509 証明書の秘密キーを提供するために使用する暗号化プロバイダーを変更する方法、およびそのプロバイダーを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティ フレームワークに統合する方法を説明します。  証明書の使用に関する詳細については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークには、「[方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)」で説明されているように、新しい種類のセキュリティ トークンを導入する方法が用意されています。  また、カスタム トークンを使用して既存のシステム指定のトークンを置き換えることも可能です。  
+  
+ このトピックでは、システム指定の X.509 セキュリティ トークンが、証明書の秘密キーに別の実装を提供するカスタムの X.509 トークンによって置き換えられます。  これは、実際の秘密キーが、既定の Windows 暗号化プロバイダーとは異なる暗号化プロバイダーから提供されるシナリオで役立ちます。  別の暗号化プロバイダーの例として、ハードウェア セキュリティ モジュールがあります。このモジュールでは、すべての秘密キー関連の暗号操作を実行し、メモリに秘密キーを格納しないので、システムのセキュリティが向上します。  
+  
+ 次の例は、デモンストレーションのためだけに作成されています。  この例では、既定の Windows 暗号化プロバイダーを置き換えていませんが、Windows 暗号化プロバイダーをどこで統合できるかを示します。  
+  
+## 手順  
+ セキュリティ キーが関連付けられているセキュリティ トークンごとに、セキュリティ トークンのインスタンスからキーのコレクションを返す <xref:System.IdentityModel.Tokens.SecurityToken.SecurityKeys%2A> プロパティを実装する必要があります。  トークンが X.509 セキュリティ トークンの場合、コレクションには、証明書に関連付けられた公開キーと秘密キーの両方を表す <xref:System.IdentityModel.Tokens.X509AsymmetricSecurityKey> クラスのインスタンスが 1 つ追加されます。  証明書のキーの提供に使用する既定の暗号化プロバイダーを置き換えるには、このクラスの新しい実装を作成します。  
+  
+#### カスタムの X.509 非対称キーを作成するには  
+  
+1.  <xref:System.IdentityModel.Tokens.X509AsymmetricSecurityKey> クラスから派生する新しいクラスを定義します。  
+  
+2.  <xref:System.IdentityModel.Tokens.SecurityKey.KeySize%2A> 読み取り専用プロパティをオーバーライドします。  このプロパティは、証明書の公開キーと秘密キーのペアの実際のキー サイズを返します。  
+  
+3.  <xref:System.IdentityModel.Tokens.SecurityKey.DecryptKey%2A> メソッドをオーバーライドします。  このメソッドは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークによって呼び出され、対称キーを証明書の秘密キーで復号化します  \(このキーは、以前に証明書の公開キーで暗号化されています\)。  
+  
+4.  <xref:System.IdentityModel.Tokens.AsymmetricSecurityKey.GetAsymmetricAlgorithm%2A> メソッドをオーバーライドします。  このメソッドは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークによって呼び出され、このメソッドに渡されるパラメーターに応じて、証明書の秘密キーまたは公開キーの暗号化プロバイダーを表す <xref:System.Security.Cryptography.AsymmetricAlgorithm> クラスのインスタンスを取得します。  
+  
+5.  省略可能です。  <xref:System.IdentityModel.Tokens.AsymmetricSecurityKey.GetHashAlgorithmForSignature%2A> メソッドをオーバーライドします。  <xref:System.Security.Cryptography.HashAlgorithm> クラスの別の実装が必要な場合は、このメソッドをオーバーライドします。  
+  
+6.  <xref:System.IdentityModel.Tokens.AsymmetricSecurityKey.GetSignatureFormatter%2A> メソッドをオーバーライドします。  このメソッドは、証明書の秘密キーに関連付けられた <xref:System.Security.Cryptography.AsymmetricSignatureFormatter> クラスのインスタンスを返します。  
+  
+7.  <xref:System.IdentityModel.Tokens.SecurityKey.IsSupportedAlgorithm%2A> メソッドをオーバーライドします。  このメソッドを使用して、特定の暗号アルゴリズムがセキュリティ キー実装によってサポートされているかどうかを示します。  
+  
+     [!code-csharp[c_CustomX509Token#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#1)]
+     [!code-vb[c_CustomX509Token#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#1)]  
+  
+ 次の手順は、システム指定の X.509 セキュリティ トークンを置き換えるために、前の手順で作成したカスタムの X.509 非対称セキュリティ キーの実装を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークに統合する方法を示しています。  
+  
+#### システム指定の X.509 セキュリティ トークンをカスタムの X.509 非対称セキュリティ キー トークンで置き換えるには  
+  
+1.  次の例に示すように、システム指定のセキュリティ キーではなく、カスタムの X.509 非対称セキュリティ キーを返すカスタムの X.509 非対称セキュリティ トークンを作成します。  カスタム セキュリティ トークンの詳細については、「[方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomX509Token#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#2)]
+     [!code-vb[c_CustomX509Token#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#2)]  
+  
+2.  次の例に示すように、カスタムの X.509 セキュリティ トークンを返すカスタムのセキュリティ トークン プロバイダーを作成します。  カスタム セキュリティ トークン プロバイダーの詳細については、「[方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomX509Token#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#3)]
+     [!code-vb[c_CustomX509Token#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#3)]  
+  
+3.  イニシエーター側でカスタム セキュリティ キーを使用する必要がある場合、次の例に示すように、カスタムのクライアント セキュリティ トークン マネージャーとカスタムのクライアント資格情報クラスを作成します。  カスタムのクライアント資格情報とクライアント セキュリティ トークン マネージャーの詳細については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomX509Token#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#4)]
+     [!code-vb[c_CustomX509Token#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#4)]  
+  
+     [!code-csharp[c_CustomX509Token#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#6)]
+     [!code-vb[c_CustomX509Token#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#6)]  
+  
+4.  受信側でカスタム セキュリティ キーを使用する必要がある場合、次の例に示すように、カスタムのサービス セキュリティ トークン マネージャーとカスタムのサービス資格情報クラスを作成します。  カスタムのサービス資格情報とサービス セキュリティ トークン マネージャーの詳細については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomX509Token#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#5)]
+     [!code-vb[c_CustomX509Token#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#5)]  
+  
+     [!code-csharp[c_CustomX509Token#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customx509token/cs/source.cs#7)]
+     [!code-vb[c_CustomX509Token#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customx509token/vb/source.vb#7)]  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.X509AsymmetricSecurityKey>   
+ <xref:System.IdentityModel.Tokens.AsymmetricSecurityKey>   
+ <xref:System.IdentityModel.Tokens.SecurityKey>   
+ <xref:System.Security.Cryptography.AsymmetricAlgorithm>   
+ <xref:System.Security.Cryptography.HashAlgorithm>   
+ <xref:System.Security.Cryptography.AsymmetricSignatureFormatter>   
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)   
+ [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)   
+ [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)   
+ [方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)   
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/channel-model-overview.md b/docs/framework/wcf/extending/channel-model-overview.md
new file mode 100644
index 00000000000..35e3d0a570f
--- /dev/null
+++ b/docs/framework/wcf/extending/channel-model-overview.md
@@ -0,0 +1,87 @@
+---
+title: "チャネル モデルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "チャネル モデル [WCF]"
+ms.assetid: 07a81e11-3911-4632-90d2-cca99825b5bd
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# チャネル モデルの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] チャネル スタックは、メッセージを処理する 1 つ以上のチャネルから成る階層構造の通信スタックです。スタックの一番下には、基になるトランスポート \(TCP、HTTP、SMTP、およびその他の種類のトランスポート\) にチャネル スタックを適応させるためのトランスポート チャネルがあります。チャネルによって、メッセージを送受信するための低レベルのプログラミング モデルが提供されます。このプログラミング モデルは、複数のインターフェイスと、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル モデルとして総称されるその他のモデルを利用します。このトピックでは、チャネル形状、基本的なチャネル リスナーの構築 \(サービス側\)、およびチャネル ファクトリ \(クライアント側\) について説明します。  
+  
+## チャネル スタック  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントでは、チャネル スタックと呼ばれる通信スタックを使用して通信が行われます。次の図では、チャネル スタックと、TCP\/IP などの他の通信スタックを比較します。  
+  
+ ![チャネル モデル](../../../../docs/framework/wcf/extending/media/wcfc-channelstackhighlevelc.gif "wcfc\_ChannelStackHighLevelc")  
+  
+ まず次のような類似点があります。いずれのスタックでも、スタックの各レイヤーにおいて、そのレイヤーより下の部分のアブストラクションと、直上のレイヤーだけに公開されるアブストラクションが提供されます。各レイヤーでは、直下のレイヤーのアブストラクションだけが使用されます。また、いずれのスタックでも、2 つのスタックが通信するときは、各レイヤーがもう一方のスタック内の対応するレイヤーと通信します。たとえば、IP レイヤーは IP レイヤーと、TCP レイヤーは TCP レイヤーと通信します。  
+  
+ 次に相違点です。TCP スタックは、物理ネットワークのアブストクラションを提供するように設計されていますが、チャネル スタックは、メッセージの配信方法、すなわちトランスポートのアブストラクションだけでなく、メッセージの内容や通信用のプロトコルなど、トランスポートとそれ以上の機能を含む他の機能のアブストラクションも提供するように設計されています。たとえば、信頼できるセッションのバインド要素は、チャネル スタックの一部ですが、トランスポートの下位でもトランスポート自体でもありません。このアブストラクションは、スタック内の最下位チャネルに、基になるトランスポート プロトコルをチャネル スタック アーキテクチャに適応させるように要求し、スタック内の上位チャネルを利用して、信頼性の保証やセキュリティなどの通信機能を提供することによって、実現されます。  
+  
+ メッセージは、通信スタックを通して、<xref:System.ServiceModel.Channels.Message> オブジェクトとして転送されます。上の図に示されているように、最下位チャネルはトランスポート チャネルと呼ばれます。このチャネルは、他のパーティとメッセージの送受信を行うチャンネルです。これには、他のパーティとの通信で使用されるフォーマットへの <xref:System.ServiceModel.Channels.Message> オブジェクトの変換が含まれます。トランスポート チャネルには、それぞれが信頼できる配信保証などの通信機能を提供する任意の数のプロトコル チャネルを設定することができます。プロトコル チャネルは、<xref:System.ServiceModel.Channels.Message> オブジェクトの形式で転送されるメッセージに対して機能します。通常プロトコル チャネルでは、メッセージの変換 \(ヘッダーの付加、本文の暗号化など\) や独自のプロトコル制御メッセージの送受信 \(確認応答の受信など\) が行われます。  
+  
+## チャネル形状  
+ 各チャネルには、チャネル形状インターフェイスまたはチャネル形状と呼ばれる 1 つ以上のインターフェイスが実装されています。このようなチャネル形状によって、チャネルが実装し、チャネルのユーザーが呼び出す送受信や要求、応答などの通信指向のメソッドが提供されます。チャネル形状のベースには、<xref:System.ServiceModel.Channels.IChannel> インターフェイスがあります。このインターフェイスでは、スタック内のチャネルで公開される機能にアクセスするための階層構造のメカニズムとして考案された `GetProperty`\<T\> メソッドが提供されます。<xref:System.ServiceModel.Channels.IChannel> を拡張する 5 つのチャネル形状は、次のとおりです。  
+  
+-   <xref:System.ServiceModel.Channels.IInputChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IOutputChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IRequestChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IReplyChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IDuplexChannel>  
+  
+ さらに、これらの形状には、それぞれ <xref:System.ServiceModel.Channels.ISessionChannel%601?displayProperty=fullName> を拡張してセッションをサポートする同等の形状があります。これらは次のとおりです。  
+  
+-   <xref:System.ServiceModel.Channels.IInputSessionChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IOutputSessionChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IRequestSessionChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IReplySessionChannel>  
+  
+-   <xref:System.ServiceModel.Channels.IDuplexSessionChannel>  
+  
+ チャネル形状は、既存のトランスポート プロトコルでサポートされている基本的なメッセージ交換パターンにならってパターン化されます。たとえば、一方向メッセージングは <xref:System.ServiceModel.Channels.IInputChannel>\/<xref:System.ServiceModel.Channels.IOutputChannel> の組み合わせに、要求\/応答は <xref:System.ServiceModel.Channels.IRequestChannel>\/<xref:System.ServiceModel.Channels.IReplyChannel> の組み合わせに、双方向多重通信は \(<xref:System.ServiceModel.Channels.IInputChannel> と <xref:System.ServiceModel.Channels.IOutputChannel> の両方を拡張する\) <xref:System.ServiceModel.Channels.IDuplexChannel> に、それぞれ対応します。  
+  
+## チャネル スタックを使用したプログラミング  
+ 通常、チャネル スタックは、バインドによってチャネル スタックが作成されるファクトリ パターンを使用して作成されます。送信側では、バインドを使用して <xref:System.ServiceModel.ChannelFactory> が作成されます。これにより、次々にチャネル スタックが作成され、スタック内の最上位チャネルへの参照が返されます。アプリケーションは、このチャネルを使用して、メッセージを送信できます。詳細については、「[クライアントのチャネル レベルのプログラミング](../../../../docs/framework/wcf/extending/client-channel-level-programming.md)」を参照してください。  
+  
+ 受信側では、バインドを使用して、入力メッセージを待ち受ける <xref:System.ServiceModel.Channels.IChannelListener> が作成されます。<xref:System.ServiceModel.Channels.IChannelListener> では、チャネル スタックを作成し、最上位チャネルへのアプリケーション参照を渡すことによって、待ち受けているアプリケーションにメッセージが提供されます。アプリケーションは、このチャネルを使用して、入力メッセージを受信します。詳細については、「[サービス チャネル レベルのプログラミング](../../../../docs/framework/wcf/extending/service-channel-level-programming.md)」を参照してください。  
+  
+## チャネル オブジェクト モデル  
+ チャネル オブジェクト モデルは、チャネル、チャネル リスナー、およびチャネル ファクトリの実装に必要なインターフェイスのコア セットです。また、カスタム実装を支援するために基本クラスもいくつか提供されます。  
+  
+ チャネル リスナーは、受信メッセージを待ち受け、チャネル リスナーによって作成されたチャネル経由で上位レイヤーに受信メッセージを配信します。  
+  
+ チャネル ファクトリは、メッセージの送信用のチャネルを作成し、チャネル ファクトリが閉じられたときに、作成したすべてのチャネルを閉じます。  
+  
+ <xref:System.ServiceModel.ICommunicationObject> は、すべての通信オブジェクトが実装する基本ステート マシンを定義するコア インターフェイスです。<xref:System.ServiceModel.Channels.CommunicationObject> は、このコア インターフェイスの実装を提供し、他のチャネル クラスはインターフェイスを再実装せずに、これを派生させて利用できます。ただし、これは必須でありません。カスタム チャネルは、<xref:System.ServiceModel.ICommunicationObject> を直接実装できますが、<xref:System.ServiceModel.Channels.CommunicationObject> を継承できません。図 3 のクラスは、いずれもチャネル モデルの一部と見なされません。これらは、チャネルを作成するカスタム チャネル実装側が利用できるヘルパーです。  
+  
+ ![チャネル モデル](../../../../docs/framework/wcf/extending/media/wcfc-wcfcchannelsigure3omumtreec.gif "wcfc\_WCFCChannelsigure3OMUMTreec")  
+  
+ 以下のトピックでは、チャネル オブジェクト モデルと共に、カスタム チャネルの作成に役立つさまざまな開発分野について説明します。  
+  
+|トピック|説明|  
+|----------|--------|  
+|[サービス : チャネル リスナーとチャネル](../../../../docs/framework/wcf/extending/service-channel-listeners-and-channels.md)|サービス アプリケーションで受信チャネルを待ち受けるチャネル リスナーについて説明します。|  
+|[クライアント : チャネル ファクトリとチャネル](../../../../docs/framework/wcf/extending/client-channel-factories-and-channels.md)|サービス アプリケーションに接続するチャネルを作成するチャネル ファクトリについて説明します。|  
+|[状態変更の理解](../../../../docs/framework/wcf/extending/understanding-state-changes.md)|<xref:System.ServiceModel.ICommunicationObject?displayProperty=fullName> インターフェイス モデルの状態がチャネルでどのように変化するかについて説明します。|  
+|[メッセージ交換パターンの選択](../../../../docs/framework/wcf/extending/choosing-a-message-exchange-pattern.md)|チャネルがサポートできる 6 つの基本メッセージ交換パターンについて説明します。|  
+|[例外とエラーの処理](../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md)|カスタム チャネルでエラーと例外を処理する方法について説明します。|  
+|[構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)|アプリケーション モデルからカスタム チャネルを使用できるようにする方法と、バインディングとバインド要素を使用してメタデータをエクスポートおよびインポートする方法について説明します。|
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/choosing-a-message-exchange-pattern.md b/docs/framework/wcf/extending/choosing-a-message-exchange-pattern.md
new file mode 100644
index 00000000000..a6c2a7ddecf
--- /dev/null
+++ b/docs/framework/wcf/extending/choosing-a-message-exchange-pattern.md
@@ -0,0 +1,103 @@
+---
+title: "メッセージ交換パターンの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f502ca1-6a8e-4607-ba15-59198c0e6146
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# メッセージ交換パターンの選択
+カスタム トランスポートを記述する最初の手順として、どの*メッセージ交換パターン \(MEP\)* が、開発するチャネルに必要かを判断します。ここでは、使用できるオプションとさまざまな要件について説明します。これは、「[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)」に記載されたチャネル開発タスクの一覧にある最初のタスクです。  
+  
+## 6 つのメッセージ交換パターン  
+ 次の 3 つの MEP から選択できます。  
+  
+-   データグラム \(<xref:System.ServiceModel.Channels.IInputChannel> と <xref:System.ServiceModel.Channels.IOutputChannel>\)  
+  
+     データグラム MEP を使用している場合、クライアントは*ファイア アンド フォーゲット \(撃ち放し\)* の交換を使用してメッセージを送信します。このような交換では、配信の成否について帯域外での確認が必要になります。メッセージが移動中に失われて、サービスに到達しない可能性があります。クライアントで送信操作が正常に完了したとしても、リモート エンドポイントでメッセージが受信されたとは限りません。データグラムはメッセージングの基礎となるビルド ブロックであり、その上に信頼できるプロトコルや安全なプロトコルなどの独自のプロトコルを構築できます。クライアント データグラム チャネルには、<xref:System.ServiceModel.Channels.IOutputChannel> インターフェイスが実装され、サービス データグラム チャネルには <xref:System.ServiceModel.Channels.IInputChannel> インターフェイスが実装されます。  
+  
+-   要求 \- 応答 \(<xref:System.ServiceModel.Channels.IRequestChannel> と <xref:System.ServiceModel.Channels.IReplyChannel>\)  
+  
+     この MEP では、メッセージが送信されて、応答が受信されます。パターンは、要求 \- 応答のペアで構成されます。要求 \- 応答呼び出しの例として、リモート プロシージャ コール \(RPC\) やブラウザー GET 要求などがあります。このパターンは、半二重とも呼ばれます。この MEP では、クライアントには <xref:System.ServiceModel.Channels.IRequestChannel> が実装され、サービス チャネルには <xref:System.ServiceModel.Channels.IReplyChannel> が実装されます。  
+  
+-   二重 \(<xref:System.ServiceModel.Channels.IDuplexChannel>\)  
+  
+     二重 MEP では、クライアントにより任意の数のメッセージを送信して、任意の順序で受信できます。二重 MEP は、話される語の 1 つずつがメッセージである電話の会話に似ています。この MEP ではどちらの側も送信および受信できるので、クライアントおよびサービス チャネルによって実装されるインターフェイスは <xref:System.ServiceModel.Channels.IDuplexChannel> になります。  
+  
+ ![メッセージ交換パターンの選択](../../../../docs/framework/wcf/extending/media/wcfc-basicthreemepsc.gif "wcfc\_BasicThreeMEPsc")  
+3 つの基本的なメッセージ交換パターンです。上から順に、データグラム、要求 \- 応答、二重。  
+  
+ これらの MEP では、それぞれ*セッション*をサポートすることもできます。セッション \(および <xref:System.ServiceModel.Channels.ISession?displayProperty=fullName> 型の <xref:System.ServiceModel.Channels.ISessionChannel%601?displayProperty=fullName> の実装\) は、チャネルで送受信されるすべてのメッセージを相互に関連付けます。要求 \- 応答パターンはスタンドアロンの 2 メッセージ セッションで、要求と応答が相互に関連付けられています。一方、セッションをサポートする要求 \- 応答パターンは、そのチャネルのすべての要求 \- 応答ペアが互いに関連付けられることを意味しています。したがって、次のように合計 6 つの MEP から選択できます。  
+  
+-   データグラム  
+  
+-   要求 – 応答  
+  
+-   双方向  
+  
+-   セッション対応データグラム  
+  
+-   セッション対応要求 – 応答  
+  
+-   セッション対応二重  
+  
+> [!NOTE]
+>  UDP トランスポートでは、サポートされている MEP はデータグラムだけです。これは、UDP がファイア アンド フォーゲット \(撃ち放し\) のプロトコルだからです。  
+  
+## セッションとセッションの多いチャネル  
+ ネットワークの世界には、接続指向プロトコル \(TCP など\) とコネクションレス プロトコル \(UDP など\) があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、接続に似た論理アブストラクションを意味する "セッション" という用語を使用します。セッションの多い WCF プロトコルは、接続指向ネットワーク プロトコルに似ており、セッションの少ない WCF プロトコルは、コネクションレス ネットワーク プロトコルに似ています。  
+  
+ チャネル オブジェクト モデルでは、各論理セッションは、セッションの多いチャネルの 1 つのインスタンスとしてマニフェストされます。したがって、クライアントによって作成され、サービスで受け入れられるすべての新しいセッションは、それぞれの側のセッションの多い新しいチャネルに対応します。セッションの少ないチャネルの構造 \(上\) と、セッションの多いチャネルの構造 \(下\) を次の図に示します。  
+  
+ ![メッセージ交換パターンの選択](../../../../docs/framework/wcf/extending/media/wcfc-sessionandsessionlesschannelsc.gif "wcfc\_SessionAndSessionlessChannelsc")  
+  
+ クライアントがセッションの多い新しいチャネルを作成し、メッセージを送信します。サービス側では、チャネル リスナーがこのメッセージを受信し、メッセージが新しいセッションに属することを検出します。チャネル リスナーはセッションの多い新しいチャネルを作成し、\(チャネル リスナーで AcceptChannel を呼び出しているアプリケーションへの応答として\) アプリケーションに渡します。アプリケーションは、同じセッションの多いチャネルを介して、このメッセージと同じセッションで送信される後続のすべてのメッセージを受信します。  
+  
+ 別のクライアント \(または同じクライアント\) がセッションの多い新しいチャネルを作成し、メッセージを送信します。チャネル リスナーは、このメッセージが新しいセッションに属することを検出し、セッションの多い新しいチャネルを作成してプロセスが繰り返されます。  
+  
+ セッションを使用しない場合、チャネルとセッション間に相関関係はありません。したがって、チャネル リスナーが作成するチャネルは 1 つしかなく、このチャネルを介して、受信したすべてのメッセージをアプリケーションに配信します。メッセージの順序を維持するためのセッションが存在しないため、メッセージの順序もありません。前の図の上部は、セッションの少ないメッセージ交換を示しています。  
+  
+## セッションの開始と終了  
+ セッションの多い新しいチャネルを作成することにより、クライアントでセッションが開始されます。新しいセッションで送信されたメッセージをサービスが受信すると、サービスでセッションが開始されます。同様に、セッションの多いチャネルを閉じるか中止すると、セッションが終了します。  
+  
+ セッションの多い双方向通信パターンで、メッセージの送信と受信の両方に使用する <xref:System.ServiceModel.Channels.IDuplexSessionChannel> はこの例外です。一方の側がメッセージの送信を停止しても、メッセージの受信は続行する必要がある可能性があります。そのため、<xref:System.ServiceModel.Channels.IDuplexSessionChannel> を使用する場合には、これ以上メッセージを送信しないことを示すために出力セッションを閉じ、メッセージの受信は続行できるように、入力セッションは開いたまましておくことができる機構があります。  
+  
+ 通常、セッションは受信側ではなく送信側で閉じます。つまり、セッションの多い出力チャネルを閉じることで、セッションを完全に終了できます。セッションの多い出力チャネルを閉じると、対応するセッションの多い入力チャネルは、<xref:System.ServiceModel.Channels.IDuplexSessionChannel> の <xref:System.ServiceModel.Channels.IInputChannel.Receive%2A?displayProperty=fullName> を呼び出しているアプリケーションに対して null を返します。  
+  
+ ただし、<xref:System.ServiceModel.Channels.IDuplexSessionChannel> の <xref:System.ServiceModel.Channels.IInputChannel.Receive%2A?displayProperty=fullName> が null を返して、セッションが既に閉じていることを示していない場合は、セッションの多い入力チャネルを閉じないようにする必要があります。<xref:System.ServiceModel.Channels.IDuplexSessionChannel> の <xref:System.ServiceModel.Channels.IInputChannel.Receive%2A?displayProperty=fullName> が null を返していない場合に、セッションの多い入力チャネルを閉じると、例外がスローされることがあります。これは、チャネルを閉じている間に、予期しないメッセージを受信することがあるためです。送信側がセッションを終了する前に、受信側でセッションを終了する必要がある場合は、入力チャネルで <xref:System.ServiceModel.ICommunicationObject.Abort%2A> を呼び出します。この呼び出しにより、セッションはその場で終了します。  
+  
+## セッションの多いチャネルの作成  
+ セッションの多いチャネルを作成した場合、セッションを提供するためにチャネルで実行しなければならないことがいくつかあります。送信側では、チャネルで以下を行う必要があります。  
+  
+-   新しいチャネルごとに、新しいセッションを作成し、新しいセッション ID \(一意の文字列\) に関連付けます。または、スタック内で、作成したチャネルの下にあるセッションの多いチャネルから新しいセッションを取得します。  
+  
+-   \(下のレイヤーからセッションを取得したのではなく\) チャネルでセッションを作成した場合は、このチャネルを使用して送信される各メッセージについて、メッセージをセッションに関連付ける必要があります。プロトコル チャネルの場合、通常は SOAP ヘッダーを追加することによってこの関連付けを行います。トランスポート チャネルの場合は、新しいトランスポート接続を作成するか、フレーミング プロトコルにセッション情報を追加します。  
+  
+-   このチャネルを使用して送信される各メッセージについて、前述の配信保証を提供する必要があります。下のレイヤーのチャネルを使用してセッションを提供している場合、そのチャネルでも配信保証を提供します。セッションを独自に提供する場合は、これらの保証をプロトコルの一部として実装する必要があります。通常、両方の側で WCF を想定したプロトコル チャネルを作成する場合、TCP トランスポート チャネルまたは信頼できるメッセージング チャネルが必要となり、セッションを提供するためにこれらのいずれかに依存します。  
+  
+-   チャネルで <xref:System.ServiceModel.ICommunicationObject.Close%2A?displayProperty=fullName> が呼び出されたときに、指定したタイムアウトまたは既定のタイムアウトを使用して、セッションを閉じるために必要な作業を実行します。これは、下のレイヤーのチャネルで <xref:System.ServiceModel.ICommunicationObject.Close%2A> を呼び出すか \(そのチャネルからセッションを取得しただけの場合\)、特殊な SOAP メッセージを送信するか、またはトランスポート接続を閉じるだけです。  
+  
+-   チャネルで <xref:System.ServiceModel.ICommunicationObject.Abort%2A> が呼び出されたときに、I\/O を実行せずにセッションをその場で終了します。これは、何も実行しないことを意味する場合もあれば、ネットワーク接続または他の何らかのリソースの中止を伴う場合もあります。  
+  
+ 受信側では、チャネルで以下を行う必要があります。  
+  
+-   各受信メッセージについて、チャネル リスナーは、そのメッセージが属しているセッションを検出する必要があります。メッセージがセッションの最初のメッセージである場合、チャネル リスナーは新しいチャネルを作成し、<xref:System.ServiceModel.Channels.IChannelListener%601.AcceptChannel%2A?displayProperty=fullName> の呼び出しからそのチャネルを返す必要があります。それ以外の場合は、チャネル リスナーはセッションに対応する既存のチャネルを検出し、そのチャネルを介してメッセージを配信する必要があります。  
+  
+-   独自のチャネルで \(必要な配信保証と共に\) セッションを提供する場合、受信側はメッセージの順序付けや受信確認の送信など、いくつかのアクションを実行することが必要になる場合があります。  
+  
+-   チャネルで <xref:System.ServiceModel.ICommunicationObject.Close%2A> が呼び出されたときに、指定したタイムアウトまたは既定のタイムアウトを使用して、セッションを閉じるために必要な作業を実行します。この作業を実行すると、チャネルがタイムアウトになるのを待機している間にメッセージを受信した場合に、例外が発生することがあります。これは、メッセージを受信したときに、チャネルが終了状態になっているためです。この場合、例外がスローされることになります。  
+  
+-   チャネルで <xref:System.ServiceModel.ICommunicationObject.Abort%2A> が呼び出されたときに、I\/O を実行せずにセッションをその場で終了します。このときも、何も実行しないことを意味する場合もあれば、ネットワーク接続または他のリソースの中止を伴う場合もあります。  
+  
+## 参照  
+ [チャネル モデルの概要](../../../../docs/framework/wcf/extending/channel-model-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/client-channel-factories-and-channels.md b/docs/framework/wcf/extending/client-channel-factories-and-channels.md
new file mode 100644
index 00000000000..397915c8c39
--- /dev/null
+++ b/docs/framework/wcf/extending/client-channel-factories-and-channels.md
@@ -0,0 +1,88 @@
+---
+title: "クライアント : チャネル ファクトリとチャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef245191-fdab-4468-a0da-7c6f25d2110f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# クライアント : チャネル ファクトリとチャネル
+ここでは、チャネル ファクトリとチャネルの作成について説明します。  
+  
+## チャネル ファクトリとチャネル  
+ チャネル ファクトリには、チャネルを作成する役割があります。  チャネル ファクトリによって作成されるチャネルは、メッセージの送信に使用されます。  このチャネルは、上の層からメッセージを取得し、必要な処理を実行し、そのメッセージを下の層に送信する必要があります。  このプロセスを説明する図を次に示します。  
+  
+ ![クライアント ファクトリおよびチャネル](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsigure2highlevelfactgoriesc.gif "wcfc\_WCFChannelsigure2HIghLevelFactgoriesc")  
+チャネル ファクトリがチャネルを作成します。  
+  
+ 終了時に、チャネル ファクトリは、作成したチャネルのうちまだ閉じていないチャネルを閉じる必要があります。  チャネル リスナーを閉じたとき、新しいチャネルの受け入れだけが停止され、既存のチャネルは開いたままで、メッセージの受信を続行できるので、ここに示すモデルは非対称です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このプロセスに対する基本クラス ヘルパーが用意されています  \(このトピックで説明するチャネル ヘルパー クラスの図については、「[チャネル モデルの概要](../../../../docs/framework/wcf/extending/channel-model-overview.md)」を参照してください\)。  
+  
+-   <xref:System.ServiceModel.Channels.CommunicationObject> クラスには <xref:System.ServiceModel.ICommunicationObject> が実装され、[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md) の手順 2. で説明されているステート マシンが強制実行されます。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelManagerBase> クラスには <xref:System.ServiceModel.Channels.CommunicationObject> が実装され、<xref:System.ServiceModel.Channels.ChannelFactoryBase?displayProperty=fullName> と <xref:System.ServiceModel.Channels.ChannelListenerBase?displayProperty=fullName> の統合基本クラスが提供されます。  <xref:System.ServiceModel.Channels.ChannelManagerBase> クラスは、<xref:System.ServiceModel.Channels.IChannel> を実装する基本クラスである <xref:System.ServiceModel.Channels.ChannelBase> との組み合わせによって動作します。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelFactoryBase> クラスでは、<xref:System.ServiceModel.Channels.ChannelManagerBase> および <xref:System.ServiceModel.Channels.IChannelFactory> が実装され、`CreateChannel` オーバーロードが `OnCreateChannel` 抽象メソッドに統合されます。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelListenerBase> クラスは、<xref:System.ServiceModel.Channels.IChannelListener> を実装しています。  基本状態管理を行います。  
+  
+ 次の説明は、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルに基づいています。  
+  
+### チャネル ファクトリの作成  
+ `UdpChannelFactory` は <xref:System.ServiceModel.Channels.ChannelFactoryBase> から派生します。  サンプルでは、<xref:System.ServiceModel.Channels.ChannelFactoryBase.GetProperty%2A> をオーバーライドして、メッセージ エンコーダーのメッセージ バージョンにアクセスできるようにします。  さらに、<xref:System.ServiceModel.Channels.ChannelFactoryBase.OnClose%2A> をオーバーライドして、ステート マシンの移行時に <xref:System.ServiceModel.Channels.BufferManager> のインスタンスを破棄します。  
+  
+#### UDP 出力チャネル  
+ `UdpOutputChannel` では、<xref:System.ServiceModel.Channels.IOutputChannel> が実装されます。  このコンストラクターは、引数を検証し、渡される <xref:System.ServiceModel.EndpointAddress> に基づいて出力先の <xref:System.Net.EndPoint> オブジェクトを構築します。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.OnOpen%2A> のオーバーライドによって、この <xref:System.Net.EndPoint> にメッセージを送信するために使用されるソケットが作成されます。  
+  
+ `this.socket = new Socket(`  
+  
+ `this.remoteEndPoint.AddressFamily,`  
+  
+ `SocketType.Dgram,`  
+  
+ `ProtocolType.Udp`  
+  
+ `);`  
+  
+ チャネルが閉じる際には、正常終了することも異常終了することもあります。  チャネルが正常に閉じた場合はソケットも終了し、基本クラスの `OnClose` メソッドが呼び出されます。  このときに例外がスローされると、インフラストラクチャによって `Abort` が呼び出され、チャネルがクリーンアップされます。  
+  
+```  
+this.socket.Close();  
+base.OnClose(timeout);  
+  
+```  
+  
+ `Send()` と `BeginSend()`\/`EndSend()` を実装します。  この実装は、2 つの主要セクションに分かれます。  最初に、メッセージを次のようにシリアル化してバイト配列で表します。  
+  
+```  
+ArraySegment<byte> messageBuffer = EncodeMessage(message);  
+  
+```  
+  
+ 次に、結果として生成されたデータを次のようにネットワークに送信します。  
+  
+```  
+this.socket.SendTo(  
+  messageBuffer.Array,   
+  messageBuffer.Offset,   
+  messageBuffer.Count,   
+  SocketFlags.None,   
+  this.remoteEndPoint  
+);  
+```  
+  
+## 参照  
+ [チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/client-channel-level-programming.md b/docs/framework/wcf/extending/client-channel-level-programming.md
new file mode 100644
index 00000000000..2682018647f
--- /dev/null
+++ b/docs/framework/wcf/extending/client-channel-level-programming.md
@@ -0,0 +1,53 @@
+---
+title: "クライアントのチャネル レベルのプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b787719-4e77-4e77-96a6-5b15a11b995a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# クライアントのチャネル レベルのプログラミング
+ここでは、<xref:System.ServiceModel.ClientBase%601?displayProperty=fullName> クラスとこれに関連するオブジェクト モデルを使用せずに、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションを作成する方法を説明します。  
+  
+## メッセージの送信  
+ メッセージを送信し、応答を受信して処理できるようにするには、次の手順に従う必要があります。  
+  
+1.  バインディングを作成します。  
+  
+2.  チャネル ファクトリをビルドします。  
+  
+3.  チャネルを作成します。  
+  
+4.  要求を送信し、応答を読み取ります。  
+  
+5.  すべてのチャネル オブジェクトを閉じます。  
+  
+#### バインディングの作成  
+ 受信の場合 \(「[サービス チャネル レベルのプログラミング](../../../../docs/framework/wcf/extending/service-channel-level-programming.md)」を参照\) と同様に、メッセージの送信はバインディングを作成することから始まります。この例では、新しい <xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> を作成し、その要素コレクションに <xref:System.ServiceModel.Channels.HttpTransportBindingElement?displayProperty=fullName> を追加します。  
+  
+#### ChannelFactory のビルド  
+ <xref:System.ServiceModel.Channels.IChannelListener?displayProperty=fullName> を作成する代わりに、今回はバインディングで型パラメーターを <xref:System.ServiceModel.Channels.IRequestChannel?displayProperty=fullName> にして <xref:System.ServiceModel.ChannelFactory.CreateFactory%2A?displayProperty=fullName> を呼び出すことで、<xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName> を作成します。チャネル リスナーは受信メッセージを待機する側で使用されますが、チャネル ファクトリはチャネルを作成するために通信を開始する側で使用されます。チャネル リスナーと同様に、チャネル ファクトリも使用する前に開く必要があります。  
+  
+#### チャネルの作成  
+ 次に <xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A?displayProperty=fullName> を呼び出して、<xref:System.ServiceModel.Channels.IRequestChannel> を作成します。この呼び出しには、新しく作成するチャネルを使用して通信を行う対象となるエンドポイントのアドレスを使用します。チャネルを作成したら、このチャネルで Open を呼び出して通信できる状態にします。この Open の呼び出しにより、トランスポートの性質に応じて、目的のエンドポイントとの接続が開始されることもあれば、ネットワーク上では何も起こらないこともあります。  
+  
+#### 要求の送信と応答の読み取り  
+ チャネルが開かれると、メッセージを作成して、チャネルの Request メソッドを使用して要求を送信し、応答が返ってくるのを待機できます。Request メソッドが終了すると、応答メッセージを取得して読み取り、エンドポイントの応答内容を確認できます。  
+  
+#### オブジェクトの終了  
+ リソースのリークを避けるには、通信に使用したオブジェクトが不要になったら、これを終了します。  
+  
+ 次のコード例に、メッセージを送信して応答を読み取るためにチャネル ファクトリを使用する基本的なクライアントを示します。  
+  
+ [!code-csharp[ChannelProgrammingBasic#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/channelprogrammingbasic/cs/clientprogram.cs#2)]
+ [!code-vb[ChannelProgrammingBasic#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/channelprogrammingbasic/vb/clientprogram.vb#2)]
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/configuration-and-metadata-support.md b/docs/framework/wcf/extending/configuration-and-metadata-support.md
new file mode 100644
index 00000000000..041e744ec0f
--- /dev/null
+++ b/docs/framework/wcf/extending/configuration-and-metadata-support.md
@@ -0,0 +1,264 @@
+---
+title: "構成とメタデータのサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27c240cb-8cab-472c-87f8-c864f4978758
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 構成とメタデータのサポート
+ここでは、バインディングおよびバインド要素用に構成とメタデータのサポートを有効にする方法を説明します。  
+  
+## 構成とメタデータの概要  
+ ここでは、次の作業について説明します。これは、[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)タスク リストのオプション項目 1.、2. および 4. に当たります。  
+  
+-   バインド要素の構成ファイル サポートを有効にします。  
+  
+-   バインディングの構成ファイル サポートを有効にします。  
+  
+-   バインド要素の WSDL とポリシー アサーションをエクスポートします。  
+  
+-   バインディングまたはバインド要素に挿入して構成する WSDL とポリシー アサーションを特定します。  
+  
+ ユーザー定義バインディングおよびバインド要素の作成の詳細については、それぞれ「[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」および「[BindingElement の作成](../../../../docs/framework/wcf/extending/creating-a-bindingelement.md)」を参照してください。  
+  
+## 構成サポートの追加  
+ チャネルに対する構成ファイルのサポートを有効にするには、2 つの構成セクションを実装する必要があります。1 つはバインド要素に対する構成のサポートを有効にする <xref:System.ServiceModel.Configuration.BindingElementExtensionElement?displayProperty=fullName> で、もう 1 つはバインディングに対する構成のサポートを有効にする <xref:System.ServiceModel.Configuration.StandardBindingElement?displayProperty=fullName> と <xref:System.ServiceModel.Configuration.StandardBindingCollectionElement%602?displayProperty=fullName> です。  
+  
+ これを行う簡単な方法は、[ConfigurationCodeGenerator](../../../../docs/framework/wcf/samples/configurationcodegenerator.md) サンプル ツールを使用して、バインディングおよびバインド要素の構成コードを生成することです。  
+  
+### BindingElementExtensionElement の拡張  
+ 次のコード例は、[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md) のサンプルから取られています。`UdpTransportElement` は `UdpTransportBindingElement` を構成システムに公開する <xref:System.ServiceModel.Configuration.BindingElementExtensionElement> です。いくつかの基本的なオーバーライドを行うことで、サンプルでは構成セクション名、バインド要素の種類とバインド要素の作成方法が定義されます。その後、次のようにして拡張セクションを構成ファイルに登録できます。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <extensions>  
+      <bindingElementExtensions>  
+      <add name="udpTransport" type="Microsoft.ServiceModel.Samples.UdpTransportElement, UdpTransport />  
+      </bindingElementExtensions>  
+    </extensions>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ この拡張は、UDP をトランスポートとして使用するためにカスタム バインディングから参照されます。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <customBinding>  
+       <binding configurationName="UdpCustomBinding">  
+         <udpTransport/>  
+       </binding>  
+      </customBinding>  
+    </bindings>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### バインディングの構成の追加  
+ セクション `SampleProfileUdpBindingCollectionElement` は <xref:System.ServiceModel.Configuration.StandardBindingCollectionElement%602> で、`SampleProfileUdpBinding` を構成システムに公開します。実装の大部分は `SampleProfileUdpBindingConfigurationElement` で代行されます。これは <xref:System.ServiceModel.Configuration.StandardBindingElement> の派生です。`SampleProfileUdpBindingConfigurationElement` には `SampleProfileUdpBinding` にあるプロパティに対応するプロパティがあり、`ConfigurationElement` バインディングからマップする関数があります。次のサンプル コードで示すように、最後に、`OnApplyConfiguration` メソッドが `SampleProfileUdpBinding` 内でオーバーライドされます。  
+  
+```  
+protected override void OnApplyConfiguration(string configurationName)  
+{  
+            if (binding == null)  
+                throw new ArgumentNullException("binding");  
+  
+            if (binding.GetType() != typeof(SampleProfileUdpBinding))  
+            {  
+                throw new ArgumentException(string.Format(CultureInfo.CurrentCulture,  
+                    "Invalid type for binding. Expected type: {0}. Type passed in: {1}.",  
+                    typeof(SampleProfileUdpBinding).AssemblyQualifiedName,  
+                    binding.GetType().AssemblyQualifiedName));  
+            }  
+            SampleProfileUdpBinding udpBinding = (SampleProfileUdpBinding)binding;  
+  
+            udpBinding.OrderedSession = this.OrderedSession;  
+            udpBinding.ReliableSessionEnabled = this.ReliableSessionEnabled;  
+            udpBinding.SessionInactivityTimeout = this.SessionInactivityTimeout;  
+            if (this.ClientBaseAddress != null)  
+                   udpBinding.ClientBaseAddress = ClientBaseAddress;  
+}  
+  
+```  
+  
+ このハンドラーを構成システムに登録するには、次のセクションを関連する構成ファイルに追加します。  
+  
+```  
+<configuration>  
+  <configSections>  
+     <sectionGroup name="system.serviceModel">  
+         <sectionGroup name="bindings">  
+                 <section name="sampleProfileUdpBinding" type="Microsoft.ServiceModel.Samples.SampleProfileUdpBindingCollectionElement, UdpTransport />  
+         </sectionGroup>  
+     </sectionGroup>  
+  </configSections>  
+</configuration>  
+```  
+  
+ これは [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 構成セクションから参照できます。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <endpoint configurationName="calculator"  
+                address="soap.udp://localhost:8001/"   
+                bindingConfiguration="CalculatorServer"  
+                binding="sampleProfileUdpBinding"   
+                contract= "Microsoft.ServiceModel.Samples.ICalculatorContract">  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## バインド要素のメタデータ サポートの追加  
+ チャネルをメタデータ システムに統合するには、ポリシーのインポートとエクスポートの両方がサポートされている必要があります。これにより、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) などのツールでバインド要素のクライアントを生成できます。  
+  
+### WSDL サポートの追加  
+ バインディングのトランスポート バインド要素は、メタデータのアドレス指定情報のインポートとエクスポートを行います。SOAP バインディングを使用する場合は、トランスポート バインド要素によっても、メタデータの正しいトランスポート URI がエクスポートされます。次のコード例は、[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md) のサンプルから取られています。  
+  
+#### WSDL エクスポート  
+ アドレス指定情報をエクスポートするために、`UdpTransportBindingElement` は <xref:System.ServiceModel.Description.IWsdlExportExtension?displayProperty=fullName> インターフェイスを実装しています。<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportEndpoint%2A?displayProperty=fullName> メソッドにより、正しいアドレス指定情報が WSDL ポートに追加されます。  
+  
+```  
+if (context.WsdlPort != null)  
+{  
+    AddAddressToWsdlPort(context.WsdlPort, context.Endpoint.Address, encodingBindingElement.MessageVersion.Addressing);  
+}  
+```  
+  
+ エンドポイントが SOAP バインディングを使用する場合、<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportEndpoint%2A> メソッドの `UdpTransportBindingElement` の実装でも、次のようにトランスポート URI がエクスポートされます。  
+  
+```  
+WsdlNS.SoapBinding soapBinding = GetSoapBinding(context, exporter);  
+if (soapBinding != null)  
+{  
+    soapBinding.Transport = UdpPolicyStrings.UdpNamespace;  
+}  
+```  
+  
+#### WSDL インポート  
+ WSDL インポート システムを拡張してアドレスのインポートを処理するには、次の構成を Svcutil.exe の構成ファイルに追加する必要があります。Svcutil.exe.config ファイルの次の例を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <metadata>  
+        <wsdlImporters>  
+          <extension type=" Microsoft.ServiceModel.Samples.UdpBindingElementImporter, UdpTransport" />  
+        </policyImporters>  
+      </metadata>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ Svcutil.exe を実行する場合、Svcutil.exe に WSDL インポートの拡張を読み込ませるために次の 2 つのオプションがあります。  
+  
+1.  \/SvcutilConfig:\<ファイル名\> を使用して、Svcutil.exe に構成ファイルを指定します。  
+  
+2.  Svcutil.exe と同じディレクトリにある Svcutil.exe.config に構成セクションを追加します。  
+  
+ `UdpBindingElementImporter` 型は <xref:System.ServiceModel.Description.IWsdlImportExtension?displayProperty=fullName> インターフェイスを実装します。`ImportEndpoint` メソッドは、次のようにして WSDL ポートからアドレスをインポートします。  
+  
+```  
+BindingElementCollection bindingElements = context.Endpoint.Binding.CreateBindingElements();  
+TransportBindingElement transportBindingElement = bindingElements.Find<TransportBindingElement>();  
+if (transportBindingElement is UdpTransportBindingElement)  
+{  
+    ImportAddress(context);  
+}  
+```  
+  
+### ポリシー サポートの追加  
+ カスタム バインド要素では、WSDL バインディング内のポリシー アサーションをエクスポートして、サービス エンドポイントでそのバインド要素の機能を表現します。次のコード例は、[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md) のサンプルから取られています。  
+  
+#### ポリシーのエクスポート  
+ `UdpTransportBindingElement` 型はポリシーのエクスポートをサポートするために ``<xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> を実装します。その結果、<xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> には、これを含む任意のバインディングでのポリシーの生成時に `UdpTransportBindingElement` が含まれます。  
+  
+ <xref:System.ServiceModel.Description.IPolicyExportExtension.ExportPolicy%2A?displayProperty=fullName> では、UDP のアサーションを追加します。チャネルがマルチキャスト モードである場合は、別のアサーションを追加します。これは、マルチキャスト モードは通信スタックの構築方法に影響を与えるため、両方の側において調整される必要があるためです。  
+  
+```  
+ICollection<XmlElement> bindingAssertions = context.GetBindingAssertions();  
+XmlDocument xmlDocument = new XmlDocument();  
+bindingAssertions.Add(xmlDocument.CreateElement(  
+UdpPolicyStrings.Prefix, UdpPolicyStrings.TransportAssertion, UdpPolicyStrings.UdpNamespace));  
+if (Multicast)  
+{  
+    bindingAssertions.Add(xmlDocument.CreateElement(  
+UdpPolicyStrings.Prefix, UdpPolicyStrings.MulticastAssertion,     UdpPolicyStrings.UdpNamespace));  
+}  
+```  
+  
+ カスタム トランスポート バインド要素はアドレス指定の処理を実行するため、`UdpTransportBindingElement` への <xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> の実装でも、WS\-Addressing ポリシー アサーションのエクスポートが処理されて、使用されている WS\-Addressing のバージョンが示されます。  
+  
+```  
+AddWSAddressingAssertion(context, encodingBindingElement.MessageVersion.Addressing);  
+```  
+  
+#### ポリシーのインポート  
+ ポリシー インポート システムを拡張するには、次の構成を Svcutil.exe の構成ファイルに追加する必要があります。Svcutil.exe.config ファイルの次の例を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <metadata>  
+        <policyImporters>  
+          <extension type=" Microsoft.ServiceModel.Samples.UdpBindingElementImporter, UdpTransport" />  
+        </policyImporters>  
+      </metadata>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ 次に、登録されたクラス \(`UdpBindingElementImporter`\) から <xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName> を実装します。<xref:System.ServiceModel.Description.IPolicyImportExtension.ImportPolicy%2A?displayProperty=fullName> で、適切な名前空間にあるアサーションを調べ、トランスポートを生成するためにそのアサーションを処理して、マルチキャストであるかどうかをチェックします。さらに、インポーターが処理するアサーションをバインディング アサーションの一覧から削除します。Svcutil.exe を実行する場合、ここでも、統合用に次の 2 つのオプションがあります。  
+  
+1.  \/SvcutilConfig:\<ファイル名\> を使用して、Svcutil.exe に構成ファイルを指定します。  
+  
+2.  Svcutil.exe と同じディレクトリにある Svcutil.exe.config に構成セクションを追加します。  
+  
+### カスタムの標準バインディング インポーターの追加  
+ Svcutil.exe と <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> 型は、既定でシステム指定のバインディングを識別してインポートします。これ以外の場合、バインディングは、<xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> インスタンスとしてインポートされます。Svcutil.exe と <xref:System.ServiceModel.Description.WsdlImporter> を有効にして `SampleProfileUdpBinding` をインポートする場合、`UdpBindingElementImporter` もカスタムの標準バインディング インポーターとして機能します。  
+  
+ カスタムの標準バインディング インポーターは、<xref:System.ServiceModel.Description.IWsdlImportExtension?displayProperty=fullName> インターフェイスに `ImportEndpoint` メソッドを実装しており、メタデータからインポートされた <xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> インスタンスを調べて、これが特定の標準バインディングによって生成されたものであるかどうかを判別できます。  
+  
+```  
+if (context.Endpoint.Binding is CustomBinding)  
+{  
+    Binding binding;  
+    if (transportBindingElement is UdpTransportBindingElement)  
+    {  
+        //if TryCreate is true, the CustomBinding will be replace by a SampleProfileUdpBinding in the  
+        //generated config file for better typed generation.  
+        if (SampleProfileUdpBinding.TryCreate(bindingElements, out binding))  
+        {  
+            binding.Name = context.Endpoint.Binding.Name;  
+            binding.Namespace = context.Endpoint.Binding.Namespace;  
+            context.Endpoint.Binding = binding;  
+        }  
+    }  
+}  
+```  
+  
+ 一般に、カスタムの標準バインディング インポーターを実装すると、インポートしたバインド要素のプロパティを調べて、標準バインディングによって設定されたプロパティのみが変更され、その他のすべてのプロパティは既定のままであることが検証されます。標準バインディング インポーターを実装する場合の基本的な方法は、標準バインディングのインスタンスを作成し、標準バインディングがサポートするバインド要素のプロパティを標準バインディング インスタンスに反映し、標準バインディングのバインド要素とインポートしたバインド要素とを比較します。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md b/docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md
new file mode 100644
index 00000000000..455e0ab1e98
--- /dev/null
+++ b/docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md
@@ -0,0 +1,252 @@
+---
+title: "動作を使用したランタイムの構成と拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "動作を使用した拡張機能の関連付け [WCF]"
+ms.assetid: 149b99b6-6eb6-4f45-be22-c967279677d9
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# 動作を使用したランタイムの構成と拡張
+動作を使用すると、既定の動作を変更したり、カスタム拡張機能を追加したりできます。カスタム拡張機能では、サービス構成の検査および検証や、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションとサービス アプリケーションのランタイム動作の変更を行います。ここでは、動作インターフェイスとその実装方法について説明します。また、動作インターフェイスをサービスの説明 \(サービス アプリケーションの場合\) またはエンドポイント \(クライアント アプリケーションの場合\) にプログラムによって追加する方法と、構成ファイル内で追加する方法についても説明します。システムが提供する動作の使用方法の詳細については、「[サービスのランタイム動作の指定](../../../../docs/framework/wcf/specifying-service-run-time-behavior.md)」および「[クライアントのランタイム動作の指定](../../../../docs/framework/wcf/specifying-client-run-time-behavior.md)」を参照してください。  
+  
+## 動作  
+ 動作の型は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] がサービス説明オブジェクト \(サービスの場合\) またはサービス エンド ポイント説明オブジェクト \(クライアントの場合\) を使用してランタイムを作成する前に、これらのオブジェクトに追加されます。このランタイムは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを実行します。ランタイムの構築プロセスでこれらの動作を呼び出すと、コントラクト、バインディング、およびアドレスによって構築されたランタイムを変更するランタイム プロパティやランタイム メソッドにアクセスできます。  
+  
+### 動作メソッド  
+ すべての動作で、`AddBindingParameters` メソッド、`ApplyDispatchBehavior` メソッド、`Validate` メソッド、および `ApplyClientBehavior` メソッドを使用できます。ただし、`ApplyClientBehavior` には、例外が 1 つあります。<xref:System.ServiceModel.Description.IServiceBehavior> はクライアントで実行できないため、このメソッドを実装していません。  
+  
+-   カスタム オブジェクトを変更したり、ランタイム構築時に使用するためにカスタム バインディングがアクセスできるコレクションにカスタム オブジェクトを追加したりするには、`AddBindingParameters` メソッドを使用します。たとえば、これによって、チャネルを構築する方法に影響するが、チャネル開発者には知られていない保護要件を指定します。  
+  
+-   説明ツリーと対応するランタイム オブジェクトを検査し、特定の基準セットに従っていることを確認するには、`Validate` メソッドを使用します。  
+  
+-   説明ツリーを検査し、サービスまたはクライアントの特定のスコープのランタイムを変更するには、`ApplyDispatchBehavior` メソッドと `ApplyClientBehavior` メソッドを使用します。また、拡張オブジェクトを挿入することもできます。  
+  
+    > [!NOTE]
+    >  これらのメソッドでは説明ツリーが提供されますが、説明ツリーは検査にのみ使用します。説明ツリーを変更すると、動作は未定義の状態になります。  
+  
+ 変更できるプロパティと実装できるカスタマイズ インターフェイスには、サービスおよびクライアントのランタイム クラスからアクセスできます。サービス型は、<xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスと <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスです。クライアント型は、<xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスと <xref:System.ServiceModel.Dispatcher.ClientOperation> クラスです。<xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスと <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスは、それぞれクライアント全体またはサービス全体のランタイム プロパティと拡張コレクションにアクセスするための拡張エントリ ポイントです。同様に、<xref:System.ServiceModel.Dispatcher.ClientOperation> クラスと <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスは、それぞれクライアント操作またはサービス操作のランタイム プロパティと拡張コレクションを公開します。ただし、必要に応じて、操作ランタイム オブジェクトからより広いスコープのランタイム オブジェクトにアクセスできます。また、逆の場合も同様です。  
+  
+> [!NOTE]
+>  クライアントの実行動作を変更する際に使用できるランタイム プロパティと拡張型の詳細については、「[クライアントの拡張](../../../../docs/framework/wcf/extending/extending-clients.md)」を参照してください。サービス ディスパッチャーの実行動作を変更する際に使用できるランタイム プロパティと拡張型の詳細については、「[ディスパッチャーの拡張](../../../../docs/framework/wcf/extending/extending-dispatchers.md)」を参照してください。  
+  
+ ほとんどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ユーザーは、ランタイムと直接やり取りすることはありません。代わりに、構成ファイル内のクラスや動作で、コア プログラミング モデルの構成要素 \(エンドポイント、コントラクト、バインディング、アドレス、動作属性など\) を使用します。これらの要素によって*説明ツリー*が構成されます。説明ツリーは、このツリーで示されるサービスまたはクライアントをサポートするランタイムを構築するための完全な仕様を表します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、次の 4 種類の動作があります。  
+  
+-   サービスの動作 \(<xref:System.ServiceModel.Description.IServiceBehavior> 型\) : <xref:System.ServiceModel.ServiceHostBase> を含むサービス ランタイム全体のカスタマイズを実現します。  
+  
+-   エンドポイントの動作 \(<xref:System.ServiceModel.Description.IEndpointBehavior> 型\) : サービス エンドポイントと、関連する <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> オブジェクトのカスタマイズを実現します。  
+  
+-   コントラクトの動作 \(<xref:System.ServiceModel.Description.IContractBehavior> 型\) : <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラス \(クライアント アプリケーションの場合\) と、<xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラス \(サービス アプリケーションの場合\) のカスタマイズを実現します。  
+  
+-   操作の動作 \(<xref:System.ServiceModel.Description.IOperationBehavior> 型\) : <xref:System.ServiceModel.Dispatcher.ClientOperation> クラス \(クライアントの場合\) と、<xref:System.ServiceModel.Dispatcher.DispatchOperation> クラス \(サービスの場合\) のカスタマイズを実現します。  
+  
+ カスタム属性を実装するか、アプリケーション構成ファイルを使用することにより、これらの動作をさまざまな説明オブジェクトに追加できます。また、適切な説明オブジェクトの動作コレクションに直接追加することもできます。ただし、<xref:System.ServiceModel.ServiceHost> または <xref:System.ServiceModel.ChannelFactory%601> で <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName> を呼び出す前に、サービス説明オブジェクトまたはサービス エンドポイント説明オブジェクトに追加する必要があります。  
+  
+### 動作のスコープ  
+ 4 種類の動作があり、それぞれランタイム アクセスの特定のスコープに対応しています。  
+  
+#### サービスの動作  
+ <xref:System.ServiceModel.Description.IServiceBehavior> を実装するサービスの動作は、サービス ランタイム全体を変更する主要機構です。サービスの動作をサービスに追加する場合、3 つの方法があります。  
+  
+1.  サービス クラスの属性を使用する方法。<xref:System.ServiceModel.ServiceHost> を構築すると、<xref:System.ServiceModel.ServiceHost> 実装は、リフレクションを使用してそのサービス型の属性セットを検出します。これらの属性のいずれかが <xref:System.ServiceModel.Description.IServiceBehavior> の実装である場合、<xref:System.ServiceModel.Description.ServiceDescription> の動作コレクションに追加されます。これにより、これらの動作はサービス ランタイムの構築に参加できます。  
+  
+2.  プログラムによって、<xref:System.ServiceModel.Description.ServiceDescription> の動作コレクションに動作を追加する方法。これを行うには、次のコード行を使用します。  
+  
+    ```  
+    ServiceHost host = new ServiceHost(/* Parameters */);  
+    host.Description.Behaviors.Add(/* Service Behavior */);  
+    ```  
+  
+3.  構成を拡張するカスタムの <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を実装する方法。これにより、アプリケーション構成ファイルからサービスの動作を使用できるようになります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスの動作の例として、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性、<xref:System.ServiceModel.Description.ServiceThrottlingBehavior>、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> 動作などがあります。  
+  
+#### コントラクトの動作  
+ <xref:System.ServiceModel.Description.IContractBehavior> インターフェイスを実装するコントラクトの動作は、コントラクト全体にわたり、クライアント ランタイムとサービス ランタイムを拡張する際に使用します。  
+  
+ コントラクトの動作をコントラクトに追加する場合、2 つの方法があります。1 つは、コントラクト インターフェイスで使用するカスタム属性を作成する方法です。コントラクト インターフェイスを <xref:System.ServiceModel.ServiceHost> または <xref:System.ServiceModel.ChannelFactory%601> に渡すと、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はインターフェイスの属性を検査します。属性のいずれかが <xref:System.ServiceModel.Description.IContractBehavior> の実装である場合、そのインターフェイス用に作成された <xref:System.ServiceModel.Description.ContractDescription?displayProperty=fullName> の動作コレクションに追加されます。  
+  
+ カスタム コントラクトの動作属性に <xref:System.ServiceModel.Description.IContractBehaviorAttribute?displayProperty=fullName> を実装することもできます。この場合、適用先に応じて動作は次のようになります。  
+  
+ •コントラクト インターフェイスに適用した場合。この場合、動作は任意のエンドポイント内の該当の型のすべてのコントラクトに適用されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.IContractBehaviorAttribute.TargetContract%2A?displayProperty=fullName> プロパティの値を無視します。  
+  
+ •サービス クラスに適用した場合。この場合、動作はコントラクトが <xref:System.ServiceModel.Description.IContractBehaviorAttribute.TargetContract%2A> プロパティの値であるエンドポイントにのみ適用されます。  
+  
+ •コールバック クラスに適用した場合。この場合、動作は双方向クライアントのエンドポイントに適用されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.IContractBehaviorAttribute.TargetContract%2A> プロパティの値を無視します。  
+  
+ 2 番目の方法として、<xref:System.ServiceModel.Description.ContractDescription> の動作コレクションに動作を追加する方法があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のコントラクトの動作の例として、<xref:System.ServiceModel.DeliveryRequirementsAttribute?displayProperty=fullName> 属性などがあります。詳細および例については、リファレンス トピックを参照してください。  
+  
+#### エンドポイントの動作  
+ <xref:System.ServiceModel.Description.IEndpointBehavior> を実装するエンドポイントの動作は、特定のエンドポイントのサービス ランタイムまたはクライアント ランタイム全体を変更する主要機構です。  
+  
+ エンドポイントの動作をサービスに追加する場合、2 つの方法があります。  
+  
+1.  <xref:System.ServiceModel.Description.ServiceEndpoint.Behaviors%2A> プロパティに動作を追加する方法。  
+  
+2.  構成を拡張するカスタムの <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を実装する方法。  
+  
+ 詳細および例については、リファレンス トピックを参照してください。  
+  
+#### 操作の動作  
+ <xref:System.ServiceModel.Description.IOperationBehavior> インターフェイスを実装する操作の動作は、各操作のクライアント ランタイムとサービス ランタイムを拡張する際に使用します。  
+  
+ 操作の動作を操作に追加する場合、2 つの方法があります。1 つは、操作をモデル化するメソッドで使用するカスタム属性を作成する方法です。<xref:System.ServiceModel.ServiceHost> または <xref:System.ServiceModel.ChannelFactory> に操作を追加すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、その操作用に作成された <xref:System.ServiceModel.Description.OperationDescription> の動作コレクションに任意の <xref:System.ServiceModel.Description.IOperationBehavior> 属性を追加します。  
+  
+ 2 番目の機構は、構成された <xref:System.ServiceModel.Description.OperationDescription> の動作コレクションに動作を直接追加します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の操作の動作の例として、<xref:System.ServiceModel.OperationBehaviorAttribute> や <xref:System.ServiceModel.TransactionFlowAttribute> などがあります。  
+  
+ 詳細および例については、リファレンス トピックを参照してください。  
+  
+### 構成を使用した動作の作成  
+ サービス、エンドポイント、およびコントラクトの動作は、コードまたは属性を使用して指定するように設計できます。アプリケーション構成ファイルまたは Web 構成ファイルを使用して構成できるのは、サービスの動作とエンドポイントの動作だけです。属性を使用して動作を公開した場合、開発者は、実行時に追加、削除、または変更できない動作をコンパイル時に指定できます。多くの場合、これはサービスの適切な操作のために常に必要となる動作に適しています \(<xref:System.ServiceModel.ServiceBehaviorAttribute?displayProperty=fullName> 属性に対するトランザクション関連のパラメーターなど\)。構成を使用して動作を公開すると、開発者はサービス展開者に動作の仕様と構成を委ねることができます。これは、動作がオプション コンポーネント、または他の展開固有の構成 \(サービスまたはサービスの特定の承認構成についてメタデータを公開するかどうかなど\) である場合に適しています。  
+  
+> [!NOTE]
+>  企業のアプリケーション ポリシーを machine.config 構成ファイルに挿入し、これらの項目をロックダウンすることで、ポリシーを適用する構成をサポートする動作を使用することもできます。説明および例については、「[方法 : 企業内のエンドポイントをロックダウンする](../../../../docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md)」を参照してください。  
+  
+ 構成を使用して動作を公開するには、開発者は <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> の派生クラスを作成し、その拡張を構成に登録する必要があります。  
+  
+ <xref:System.ServiceModel.Description.IEndpointBehavior> で <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を実装する方法を次のコード例に示します。  
+  
+```  
+// BehaviorExtensionElement members  
+    public override Type BehaviorType  
+    {  
+      get { return typeof(EndpointBehaviorMessageInspector); }  
+    }  
+  
+    protected override object CreateBehavior()  
+    {  
+      return new EndpointBehaviorMessageInspector();  
+    }  
+```  
+  
+ 構成システムでカスタムの <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を読み込むには、拡張として登録する必要があります。上記のエンドポイントの動作の構成ファイルを次のコード例に示します。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+        name="Microsoft.WCF.Documentation.SampleService"  
+        behaviorConfiguration="metadataSupport"  
+      >  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8080/ServiceMetadata" />  
+          </baseAddresses>  
+        </host>  
+        <endpoint  
+          address="/SampleService"  
+          binding="wsHttpBinding"  
+          behaviorConfiguration="withMessageInspector"   
+          contract="Microsoft.WCF.Documentation.ISampleService"  
+        />  
+        <endpoint  
+           address="mex"  
+           binding="mexHttpBinding"  
+           contract="IMetadataExchange"  
+        />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+      <behavior name="metadataSupport">  
+        <serviceMetadata httpGetEnabled="true" httpGetUrl=""/>  
+      </behavior>  
+      </serviceBehaviors>  
+      <endpointBehaviors>  
+        <behavior name="withMessageInspector">  
+          <endpointMessageInspector />  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <extensions>  
+      <behaviorExtensions>  
+        <add   
+          name="endpointMessageInspector"  
+          type="Microsoft.WCF.Documentation.EndpointBehaviorMessageInspector, HostApplication, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"  
+        />  
+      </behaviorExtensions>  
+    </extensions>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ ここで、`Microsoft.WCF.Documentation.EndpointBehaviorMessageInspector` は動作拡張型です。また、`HostApplication` は、該当のクラスがコンパイルされているアセンブリの名前です。  
+  
+### 評価順序  
+ <xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName> と <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> は、プログラミング モデルと記述からランタイムを構築します。前述のように、動作は、サービス、エンドポイント、コントラクト、および操作でランタイムの構築プロセスを支援します。  
+  
+ <xref:System.ServiceModel.ServiceHost> は次の順序で動作を適用します。  
+  
+1.  サービス  
+  
+2.  コントラクト  
+  
+3.  エンドポイント  
+  
+4.  操作  
+  
+ 動作のどのコレクション内でも、順序が保証されるというわけではありません。  
+  
+ <xref:System.ServiceModel.ChannelFactory%601> は次の順序で動作を適用します。  
+  
+1.  コントラクト  
+  
+2.  エンドポイント  
+  
+3.  操作  
+  
+ この場合も、動作のどのコレクション内でも、順序が保証されるというわけではありません。  
+  
+### プログラムによる動作の追加  
+ <xref:System.ServiceModel.ServiceHostBase?displayProperty=fullName> の <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A?displayProperty=fullName> メソッドの後で、サービス アプリケーションの <xref:System.ServiceModel.Description.ServiceDescription?displayProperty=fullName> の各プロパティを変更しないでください。このメソッドの後で変更すると、<xref:System.ServiceModel.ServiceHostBase> および <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> の <xref:System.ServiceModel.ServiceHostBase.Credentials%2A?displayProperty=fullName> プロパティや `AddServiceEndpoint` メソッドなどの一部のメンバーは例外をスローします。変更を許可するメンバーもありますが、結果は未定義の状態になります。  
+  
+ 同様に、クライアントで、<xref:System.ServiceModel.ChannelFactory?displayProperty=fullName> の <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A> 呼び出しの後で、<xref:System.ServiceModel.Description.ServiceEndpoint?displayProperty=fullName> 値を変更しないでください。この呼び出しの後で変更すると、<xref:System.ServiceModel.ChannelFactory.Credentials%2A?displayProperty=fullName> プロパティは例外をスローします。その他のクライアント記述値は、エラーを発生させずに変更できます。ただし、結果は未定義の状態になります。  
+  
+ サービスとクライアントのどちらの場合も、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A?displayProperty=fullName> の呼び出しの前に記述を変更することをお勧めします。  
+  
+### 動作属性の継承ルール  
+ 4 種類の動作はすべて、属性 \(サービスの動作とコントラクトの動作\) を使用して設定できます。属性はマネージ オブジェクトとメンバーで定義され、マネージ オブジェクトとメンバーは継承をサポートしているため、継承のコンテキストでの動作属性の機能を定義する必要があります。  
+  
+ 大まかに言えば、特定のスコープ \(サービス、コントラクト、操作など\) については、そのスコープの継承階層内のすべての動作属性が適用されるという継承ルールになります。同じ種類の 2 つの動作属性がある場合、最も多く派生された種類だけが使用されます。  
+  
+#### サービスの動作  
+ サービス クラスの場合、指定のクラスとその親のすべてのサービス動作属性が適用されます。継承階層の複数の場所に同じ種類の属性が適用されている場合は、最も多く派生された種類が使用されます。  
+  
+```  
+[ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple)]  
+[AspNetCompatibilityRequirementsAttribute(  
+    AspNetCompatibilityRequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]  
+public class A { /* … */ }  
+  
+[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]  
+public class B : A { /* … */}  
+```  
+  
+ たとえば、上記の例では、最終的にサービス B は、<xref:System.ServiceModel.InstanceContextMode> が <xref:System.ServiceModel.InstanceContextMode>、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> が <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>、<xref:System.ServiceModel.ConcurrencyMode> が <xref:System.ServiceModel.ConcurrencyMode> になります。<xref:System.ServiceModel.ConcurrencyMode> が <xref:System.ServiceModel.ConcurrencyMode> になるのは、サービス B の <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性の方がサービス A よりも多く派生されているためです。  
+  
+#### コントラクトの動作  
+ コントラクトの場合、指定のインターフェイスとその親のすべてのコントラクト動作属性が適用されます。継承階層の複数の場所に同じ種類の属性が適用されている場合は、最も多く派生された種類が使用されます。  
+  
+#### 操作の動作  
+ 指定の操作が既存の抽象操作または仮想操作をオーバーライドしない場合、継承ルールは適用されません。  
+  
+ 操作が既存の操作をオーバーライドする場合は、その操作とその親のすべての操作動作属性が適用されます。継承階層の複数の場所に同じ種類の属性が適用されている場合は、最も多く派生された種類が使用されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/creating-a-bindingelement.md b/docs/framework/wcf/extending/creating-a-bindingelement.md
new file mode 100644
index 00000000000..d8bc564be56
--- /dev/null
+++ b/docs/framework/wcf/extending/creating-a-bindingelement.md
@@ -0,0 +1,84 @@
+---
+title: "BindingElement の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 01a35307-a41f-4ef6-a3db-322af40afc99
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# BindingElement の作成
+バインディングとバインド要素 \(それぞれ、<xref:System.ServiceModel.Channels.Binding?displayProperty=fullName> と <xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName> を拡張するオブジェクト\) は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーション モデルがチャネル ファクトリおよびチャネル リスナーと関連付けられる場所です。バインディングを使用せずにカスタム チャネルを使用する場合は、「[サービス チャネル レベルのプログラミング](../../../../docs/framework/wcf/extending/service-channel-level-programming.md)」および「[クライアントのチャネル レベルのプログラミング](../../../../docs/framework/wcf/extending/client-channel-level-programming.md)」に示すように、チャネル レベルでのプログラミングが必要になります。このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でチャネルを使用するための最小要件、チャネルの <xref:System.ServiceModel.Channels.BindingElement> の開発、および「[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)」の手順 4. に示す "アプリケーションからのチャネル使用" を有効にする方法について説明します。  
+  
+## 概要  
+ チャネルの <xref:System.ServiceModel.Channels.BindingElement> を作成しておくと、開発者は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション内でチャネルを使用できるようになります。<xref:System.ServiceModel.Channels.BindingElement> オブジェクトを <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> クラスから使用することにより、チャネルの正確な型情報を指定しなくても [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションをチャネルに接続できます。  
+  
+ 一度 <xref:System.ServiceModel.Channels.BindingElement> を作成しておくと、「[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)」に示す残りのチャネル開発手順に従って、さらに多くの機能を、要件に応じて有効にできます。  
+  
+## バインド要素の追加  
+ カスタムの <xref:System.ServiceModel.Channels.BindingElement> を実装するには、<xref:System.ServiceModel.Channels.BindingElement> を継承するクラスを記述します。たとえば、サイズの大きいメッセージをチャンクに分割し、接続先で元のメッセージを再構築できる `ChunkingChannel` を開発している場合、<xref:System.ServiceModel.Channels.BindingElement> を実装してこれを使用するようにバインディングを構成することによって、任意のバインディングでこのチャネルを使用できるようになります。このトピックの残りの部分では、`ChunkingChannel` を例にして、バインド要素を実装する際の要件を示します。  
+  
+ `ChunkingBindingElement` は、`ChunkingChannelFactory` および `ChunkingChannelListener` を作成します。このバインド要素は、<xref:System.ServiceModel.Channels.BindingElement.CanBuildChannelFactory%2A> 実装および <xref:System.ServiceModel.Channels.BindingElement.CanBuildChannelListener%2A> 実装をオーバーライドし、型パラメーターが <xref:System.ServiceModel.Channels.IDuplexSessionChannel> \(この例では、これが `ChunkingChannel` でサポートされる唯一のチャネル形状です\) であることと、バインディングの他のバインド要素がこのチャネル形状をサポートすることを確認します。  
+  
+ <xref:System.ServiceModel.Channels.BindingElement.BuildChannelFactory%2A> は、要求されたチャネル形状を構築できることをまず確認し、次にチャンク対象のメッセージ アクションのリストを取得します。さらに、新しい `ChunkingChannelFactory` を作成してこれに内部チャネル ファクトリを渡します \(トランスポート バインド要素を作成する場合、これはバインディング スタック内の最後の要素となるため、チャネル リスナーとチャネル ファクトリを作成する必要があります\)。  
+  
+ <xref:System.ServiceModel.Channels.BindingElement.BuildChannelListener%2A> には、`ChunkingChannelListener` を作成してこれに内部チャネル リスナーを渡す同様の実装があります。  
+  
+ トランスポート チャネルを使用する別の例として、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルでは次のオーバーライドが示されています。  
+  
+ このサンプルでは、バインド要素は `UdpTransportBindingElement` で、<xref:System.ServiceModel.Channels.TransportBindingElement> から派生しています。このバインド要素は、チャネルに関連付けられているファクトリを作成する、次のメソッドをオーバーライドします。  
+  
+```  
+public IChannelFactory<TChannel> BuildChannelFactory<TChannel>(BindingContext context)  
+{  
+            return (IChannelFactory<TChannel>)(object)new UdpChannelFactory(this, context);  
+}  
+  
+public IChannelListener<TChannel> BuildChannelListener<TChannel>(BindingContext context)  
+{  
+            return (IChannelListener<TChannel>)(object)new UdpChannelListener(this, context);  
+}  
+```  
+  
+ また、この要素には、`BindingElement` を複製したり、スキーム \(soap.udp\) を返したりするためのメンバーも含まれます。  
+  
+#### プロトコル バインド要素  
+ 含まれているバインド要素を新しいバインド要素で置き換えたり補足したりすることにより、新しいトランスポート、エンコーディング、または高レベルのプロトコルを追加できます。新しいプロトコル バインド要素を作成するには、まず <xref:System.ServiceModel.Channels.BindingElement> クラスを拡張します。次に、<xref:System.ServiceModel.Channels.IChannel.GetProperty%2A?displayProperty=fullName> を使用して、少なくとも <xref:System.ServiceModel.Channels.BindingElement.Clone%2A?displayProperty=fullName> と  `ChannelProtectionRequirements` を実装する必要があります。これにより、このバインド要素の <xref:System.ServiceModel.Security.ChannelProtectionRequirements> が返されます。詳細については、<xref:System.ServiceModel.Security.ChannelProtectionRequirements> を参照してください。  
+  
+ <xref:System.ServiceModel.Channels.BindingElement.Clone%2A> は、このバインド要素の新しいコピーを返します。最善の方法としては、バインド要素の作成者は基本の copy コンストラクターを呼び出す copy コンストラクターを使用して、<xref:System.ServiceModel.Channels.BindingElement.Clone%2A> を実装し、このクラスに含まれるすべての追加フィールドを複製することをお勧めします。  
+  
+#### トランスポート バインド要素  
+ 新しいトランスポート バインド要素を作成するには、<xref:System.ServiceModel.Channels.TransportBindingElement> インターフェイスを拡張します。次に、少なくとも <xref:System.ServiceModel.Channels.BindingElement.Clone%2A> メソッドと <xref:System.ServiceModel.Channels.TransportBindingElement.Scheme%2A?displayProperty=fullName> プロパティを実装する必要があります。  
+  
+ <xref:System.ServiceModel.Channels.BindingElement.Clone%2A> \- このバインド要素の新しいコピーを返します。最善の方法としては、バインディング要素の作成者は基本の copy コンストラクターを呼び出す copy コンストラクターを使用して、複製を実装し、このクラスに含まれるすべての追加フィールドを複製することをお勧めします。  
+  
+ <xref:System.ServiceModel.Channels.TransportBindingElement.Scheme%2A> – <xref:System.ServiceModel.Channels.TransportBindingElement.Scheme%2A> get プロパティは、バインディング要素によって表されるトランスポート プロトコルの URI スキームを返します。たとえば、<xref:System.ServiceModel.Channels.HttpTransportBindingElement?displayProperty=fullName> および <xref:System.ServiceModel.Channels.TcpTransportBindingElement?displayProperty=fullName> は、それぞれの <xref:System.ServiceModel.Channels.TransportBindingElement.Scheme%2A> プロパティから "http" および "net.tcp" を返します。  
+  
+#### エンコーディング バインディング要素  
+ 新しいエンコーディング バインド要素を作成するには、まず <xref:System.ServiceModel.Channels.BindingElement> クラスを拡張し、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement?displayProperty=fullName> クラスを実装します。次に、少なくとも、<xref:System.ServiceModel.Channels.BindingElement.Clone%2A> メソッド、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement.CreateMessageEncoderFactory%2A?displayProperty=fullName> メソッド、および <xref:System.ServiceModel.Channels.MessageEncodingBindingElement.MessageVersion%2A?displayProperty=fullName> プロパティを実装する必要があります。  
+  
+-   <xref:System.ServiceModel.Channels.BindingElement.Clone%2A>.このバインド要素の新しいコピーを返します。最善の方法としては、バインド要素の作成者は基本の copy コンストラクターを呼び出す copy コンストラクターを使用して、<xref:System.ServiceModel.Channels.BindingElement.Clone%2A> を実装し、このクラスに含まれるすべての追加フィールドを複製することをお勧めします。  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncodingBindingElement.CreateMessageEncoderFactory%2A>.<xref:System.ServiceModel.Channels.MessageEncoderFactory> を返します。これは、新しいエンコーダーを実装する実際のクラスを識別するハンドルを提供し、<xref:System.ServiceModel.Channels.MessageEncoder> を拡張します。詳細については、<xref:System.ServiceModel.Channels.MessageEncoderFactory>、<xref:System.ServiceModel.Channels.MessageEncoder> の各トピックを参照してください。  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncodingBindingElement.MessageVersion%2A>.このエンコーディングで使用する <xref:System.ServiceModel.Channels.MessageVersion> を返します。これは、使用する SOAP および WS\-Addressing のバージョンを表します。  
+  
+ ユーザー定義エンコーディング バインド要素のオプション メソッドとプロパティの完全な一覧については、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> を参照してください。  
+  
+ 新しいバインド要素の作成の詳細については、「[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」を参照してください。  
+  
+ チャネルのバインド要素を作成したら、「[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)」のトピックに戻り、作成したバインド要素で構成ファイルをサポートする必要性の有無、メタデータの公開をサポートする必要性の有無とその方法、およびバインド要素を使用するユーザー定義のバインディングを作成する必要性の有無とその方法について確認します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.BindingElement>   
+ [チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)   
+ [トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/creating-user-defined-bindings.md b/docs/framework/wcf/extending/creating-user-defined-bindings.md
new file mode 100644
index 00000000000..1a966140c2c
--- /dev/null
+++ b/docs/framework/wcf/extending/creating-user-defined-bindings.md
@@ -0,0 +1,130 @@
+---
+title: "ユーザー定義バインディングの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ユーザー定義バインディング [WCF]"
+ms.assetid: c4960675-d701-4bc9-b400-36a752fdd08b
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# ユーザー定義バインディングの作成
+システムから提供されないバインディングを作成する方法はいくつかあります。  
+  
+-   バインド要素を格納するコンテナーである <xref:System.ServiceModel.Channels.CustomBinding> クラスに基づいてカスタム バインディングを作成します。  次に、カスタム バインディングをサービス エンドポイントに追加します。  カスタム バインディングは、プログラムで作成することも、アプリケーションの構成ファイルに作成することもできます。  アプリケーション構成ファイルのバインド要素を使用するには、バインド要素で <xref:System.ServiceModel.Configuration.BindingElementExtensionElement> を拡張する必要があります。  カスタム バインディング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」および「<xref:System.ServiceModel.Channels.CustomBinding>」を参照してください。  
+  
+-   標準バインディングの派生クラスを作成できます。  たとえば、<xref:System.ServiceModel.WSHttpBinding> の派生クラスを作成して <xref:System.ServiceModel.Channels.CustomBinding.CreateBindingElements%2A> メソッドを上書きし、バインド要素を取得してカスタム バインディングを挿入したり、セキュリティ用の特定の値を確立したりできます。  
+  
+-   新しい <xref:System.ServiceModel.Channels.Binding> 型を作成して、バインディング実装全体を完全に制御することができます。  
+  
+## バインド要素の順序  
+ 各バインド要素は、メッセージの送信または受信時の処理手順を表します。  実行時に、バインド要素により、送受信チャネル スタックの作成に必要なチャネルとリスナーが作成されます。  
+  
+ バインディング要素には主に、プロトコル バインディング要素、エンコーディング バインディング要素、トランスポート バインディング要素という 3 つの種類があります。  
+  
+ プロトコル バインド要素 : この要素はメッセージで動作する上位処理ステップを表します。  このバインド要素で作成したチャネルとリスナーを使って、メッセージ内容の追加、削除、変更が可能です。  特定のバインディングには、それぞれが <xref:System.ServiceModel.Channels.BindingElement> を継承する任意の数のプロトコル バインド要素を含めることができます。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement> や <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> などのプロトコル バインド要素がいくつか含まれます。  
+  
+ エンコーディング バインド要素 : この要素は、メッセージとネットワーク転送が可能なエンコーディングとの間の変換を表します。  一般的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングには、エンコーディング バインド要素が 1 つだけ含まれます。  エンコーディング バインド要素の例として、<xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>、<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>、<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> などがあります。  エンコーディング バインド要素がバインディングに指定されていない場合、既定のエンコーディングが使用されます。  既定値は、トランスポートが HTTP の場合はテキスト、それ以外の場合はバイナリです。  
+  
+ トランスポート バインド要素 : この要素は、トランスポート プロトコルでのエンコーディング メッセージの送信を表します。  一般的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングには、<xref:System.ServiceModel.Channels.TransportBindingElement> から派生したトランスポート バインド要素が 1 つだけ含まれます。  トランスポート バインド要素の例として、<xref:System.ServiceModel.Channels.TcpTransportBindingElement>、<xref:System.ServiceModel.Channels.HttpTransportBindingElement>、<xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement> などがあります。  
+  
+ 新しいバインディングを作成する場合、バインド要素の追加順序が重要になります。  バインド要素は必ず次の順序で追加します。  
+  
+|レイヤー|オプション|必須|  
+|----------|-----------|--------|  
+|トランザクション フロー|<xref:System.ServiceModel.Channels.TransactionFlowBindingElement?displayProperty=fullName>|Ｘ|  
+|信頼性|<xref:System.ServiceModel.Channels.ReliableSessionBindingElement?displayProperty=fullName>|Ｘ|  
+|セキュリティ|<xref:System.ServiceModel.Channels.SecurityBindingElement?displayProperty=fullName>|Ｘ|  
+|複合二重|<xref:System.ServiceModel.Channels.CompositeDuplexBindingElement?displayProperty=fullName>|Ｘ|  
+|エンコーディング|テキスト、バイナリ、MTOM、カスタム|○\*|  
+|Transport|TCP、名前付きパイプ、HTTP、HTTPS、MSMQ、およびカスタム|はい|  
+  
+ \*エンコーディングは各バインディングに必要であるため、エンコーディングが指定されていない場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は既定のエンコーディングを自動的に追加します。  既定値は、HTTP および HTTPS トランスポートの場合はテキスト\/XML、それ以外の場合はバイナリです。  
+  
+## 新しいバインド要素の作成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供する <xref:System.ServiceModel.Channels.BindingElement> から派生した型のほかに、独自のバインド要素を作成できます。  これにより、他のシステムが提供する型を使ってスタックに組み込むことのできる独自の <xref:System.ServiceModel.Channels.BindingElement> を作成して、バインディングのスタックを作成する方法や、バインディングのスタックに追加するコンポーネントをカスタマイズできます。  
+  
+ たとえば、メッセージをデータベースに記録する機能を持つ `LoggingBindingElement` を実装する場合、それをチャネル スタックのトランスポート チャネルの上に配置する必要があります。  この場合、アプリケーションでは、次の例に示すように、`TcpTransportBindingElement` と共に `LoggingBindingElement` が組み込まれたカスタム バインディングが作成されます。  
+  
+```csharp  
+Binding customBinding = new CustomBinding(  
+  new LoggingBindingElement(),   
+  new TcpTransportBindingElement()  
+);  
+```  
+  
+ 新しいバインド要素を記述する方法は、機能性の詳細によって異なります。  サンプルの 1 つ \([トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)\) を使用して、1 つの種類のバインド要素の実装方法を詳細に説明します。  
+  
+## 新しいバインディングの作成  
+ ユーザーが作成するバインド要素は、2 つの方法で使用できます。  前のセクションでは、カスタム バインディングを使用する 1 番目の方法が説明されています。  カスタム バインディングを使用すれば、バインド要素の任意のセットに基づいて独自のバインディングを作成できます。ユーザーが作成するバインディング エレメントもこれに含まれます。  
+  
+ 2 つ以上のアプリケーションでバインディングを使用する場合、独自のバインディングを作成し、<xref:System.ServiceModel.Channels.Binding> を拡張します。  これにより、カスタム バインディングを使う必要があるたびに、手動でカスタム バインディングを作成する必要性を回避できます。  ユーザー定義のバインディングを使用して、バインディングの動作を定義したり、ユーザー定義のバインド要素を格納することができます。  また、*事前パッケージング*であるため、使用するたびにバインディングを再作成する必要はありません。  
+  
+ ユーザー定義のバインディングは、少なくとも <xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A> メソッドと <xref:System.ServiceModel.Channels.Binding.Scheme%2A> プロパティを実装する必要があります。  
+  
+ <xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A> メソッドは、バインディングのバインド要素を格納している新しい <xref:System.ServiceModel.Channels.BindingElementCollection> を返します。  このコレクションは順序付けられており、始めにプロトコル バインド要素を格納し、次にエンコーディング バインド要素、その次にトランスポート バインド要素を格納する必要があります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] システム指定のバインド要素を使用する場合、[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)に指定されているバインド要素の順序ルールに従う必要があります。  このコレクションから、ユーザー定義のバインディング クラス内で参照されるオブジェクトを参照すべきではありません。このため、バインディングの作成者は、<xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A> を呼び出すたびに <xref:System.ServiceModel.Channels.BindingElementCollection> の `Clone()` を返す必要があります。  
+  
+ <xref:System.ServiceModel.Channels.Binding.Scheme%2A> プロパティは、バインディングで使用するトランスポート プロトコルの URI スキームを表します。  たとえば、*WSHttpBinding* および *NetTcpBinding* は、それぞれの <xref:System.ServiceModel.Channels.Binding.Scheme%2A> プロパティから "http" および "net.tcp" を返します。  
+  
+ ユーザー定義バインディングのオプション メソッドとプロパティの完全な一覧については、<xref:System.ServiceModel.Channels.Binding> を参照してください。  
+  
+### 例  
+ このサンプルでは、プロファイル バインディングを、<xref:System.ServiceModel.Channels.Binding> から派生した `SampleProfileUdpBinding` に実装します。  `SampleProfileUdpBinding` は最大で 4 つのバインド要素を格納します。1 つはユーザー作成の `UdpTransportBindingElement` で、後の 3 つはシステム指定の `TextMessageEncodingBindingElement`、 `CompositeDuplexBindingElement`、`ReliableSessionBindingElement` です。  
+  
+```  
+public override BindingElementCollection CreateBindingElements()  
+{     
+    BindingElementCollection bindingElements = new BindingElementCollection();  
+    if (ReliableSessionEnabled)  
+    {  
+        bindingElements.Add(session);  
+        bindingElements.Add(compositeDuplex);  
+    }  
+    bindingElements.Add(encoding);  
+    bindingElements.Add(transport);  
+    return bindingElements.Clone();  
+}  
+```  
+  
+## 双方向コントラクトのセキュリティ制限  
+ すべてのバインド要素どうしに互換性があるわけではありません。  特に双方向コントラクトで使用する場合、セキュリティ バインド要素にはいくつかの制限があります。  
+  
+### ワンショット セキュリティ  
+ \<message\> 構成要素の `negotiateServiceCredential` 属性を `false` に設定すると、必要なすべてのセキュリティ資格情報を 1 つのメッセージで送信する、"ワンショット" セキュリティを実装できます。  
+  
+ ワンショット認証は双方向コントラクトでは動作しません。  
+  
+ 要求\/応答コントラクトでは、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IRequestChannel> インスタンスまたは <xref:System.ServiceModel.Channels.IRequestSessionChannel> インスタンスの作成がサポートされている場合にのみ、ワンショット認証は動作します。  
+  
+ 一方向コントラクトでは、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IRequestChannel>、<xref:System.ServiceModel.Channels.IRequestSessionChannel>、<xref:System.ServiceModel.Channels.IOutputChannel>、または <xref:System.ServiceModel.Channels.IOutputSessionChannel> の各インスタンスの作成がサポートされている場合にのみ、ワンショット認証は動作します。  
+  
+### クッキー モードのセキュリティ コンテキスト トークン  
+ クッキー モードのセキュリティ コンテキスト トークンは、双方向コントラクトでは使用できません。  
+  
+ 要求\/応答コントラクトでは、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IRequestChannel> インスタンスまたは <xref:System.ServiceModel.Channels.IRequestSessionChannel> インスタンスの作成がサポートされている場合にのみ、クッキー モードのセキュリティ コンテキスト トークンは動作します。  
+  
+ 一方向コントラクトでは、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IRequestChannel> インスタンスまたは <xref:System.ServiceModel.Channels.IRequestSessionChannel> インスタンスの作成がサポートされている場合にのみ、クッキー モードのセキュリティ コンテキスト トークンは動作します。  
+  
+### セッション モードのセキュリティ コンテキスト トークン  
+ 双方向コントラクトでは、セッション モードの SCT \(セキュリティ コンテキスト トークン\) は、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IDuplexChannel> インスタンスまたは <xref:System.ServiceModel.Channels.IDuplexSessionChannel> インスタンスの作成がサポートされている場合に動作します。  
+  
+ 要求\/応答コントラクトでは、セッション モードの SCT は、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IDuplexChannel>、<xref:System.ServiceModel.Channels.IDuplexSessionChannel>、<xref:System.ServiceModel.Channels.IRequestChannel>、または <xref:System.ServiceModel.Channels.IRequestSessionChannel> の各インスタンスの作成がサポートされている場合に動作します。  
+  
+ 一方向コントラクトでは、セッション モードの SCT は、セキュリティ バインド要素の下にあるバインディング スタックで <xref:System.ServiceModel.Channels.IDuplexChannel>、<xref:System.ServiceModel.Channels.IDuplexSessionChannel>、<xref:System.ServiceModel.Channels.IRequestChannel>、または <xref:System.ServiceModel.Channels.IRequestSessionChannel> の各インスタンスの作成がサポートされている場合に動作します。  
+  
+## 標準バインディングからの派生  
+ まったく新しいバインディング クラスを作成する代わりに、システムから提供される既存のバインディングの 1 つを拡張することができます。  前述の場合と同様、<xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A> メソッドと <xref:System.ServiceModel.Channels.Binding.Scheme%2A> プロパティを上書きする必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.Binding>   
+ [カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-authorization.md b/docs/framework/wcf/extending/custom-authorization.md
new file mode 100644
index 00000000000..6e136edd3a7
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-authorization.md
@@ -0,0 +1,44 @@
+---
+title: "カスタム承認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f90311a-2593-462e-9174-2f7ac78217b9
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# カスタム承認
+承認は、リソースとタスクへのアクセスを制御するプロセスです。このセクションのトピックでは、さまざまなクレームの種類や、ポリシーを作成して実装する方法について説明します。  
+  
+## このセクションの内容  
+ [方法 : カスタム承認ポリシーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-policy.md)  
+ カスタム ポリシーの作成方法について説明します。  
+  
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)  
+ カスタム マネージャーの作成方法について説明します。  
+  
+ [方法 : カスタム クレームを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-claim.md)  
+ カスタム クレームの作成方法について説明します。  
+  
+ [方法 : クレームを比較する](../../../../docs/framework/wcf/extending/how-to-compare-claims.md)  
+ クレームを比較する方法について説明します。  
+  
+ [方法 : カスタム プリンシパル ID を作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-principal-identity.md)  
+ <xref:System.ServiceModel.Description.PrincipalPermissionMode> を、カスタム承認ポリシーおよびカスタム プリンシパルと組み合わせて使用する場合のシナリオを説明します。  
+  
+## 関連項目  
+ <xref:System.IdentityModel.Claims>  
+  
+## 関連項目  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+  
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-bindings.md b/docs/framework/wcf/extending/custom-bindings.md
new file mode 100644
index 00000000000..ca5788d9916
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-bindings.md
@@ -0,0 +1,91 @@
+---
+title: "カスタム バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "Windows Communication Foundation, 構成"
+  - "Windows Communication Foundation, エンドポイント"
+ms.assetid: 58532b6d-4eea-4a4f-854f-a1c8c842564d
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# カスタム バインディング
+システムが提供するバインディングの中にサービスの要件を満たすものがない場合は、<xref:System.ServiceModel.Channels.CustomBinding> クラスを使用できます。すべてのバインディングは、バインド要素の順序付き集合から作成されます。カスタム バインディングは、一連のシステム指定のバインド要素から作成したり、ユーザー定義のカスタム バインド要素を含めたりできます。カスタム バインド要素を使用すると、たとえば、新しいトランスポートまたはエンコーダーをサービス エンドポイントで使用できるようになります。実施例については、「[Custom Binding Samples](http://msdn.microsoft.com/ja-jp/657e8143-beb0-472d-9cfe-ed1a19c2ab08)」を参照してください。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md).  
+  
+## カスタム バインディングの構築  
+ カスタム バインディングは、特定の順序で "積み重ねられている" バインド要素のコレクションから <xref:System.ServiceModel.Channels.CustomBinding.%23ctor%2A> コンストラクターを使用して作成します。  
+  
+-   最上位にあるのは、トランザクションのフローを可能にするオプションの <xref:System.ServiceModel.Channels.TransactionFlowBindingElement> クラスです。  
+  
+-   その次にあるのは、WS\-ReliableMessaging 仕様で定義されているセッションおよび順序指定のメカニズムを提供する、オプションの <xref:System.ServiceModel.Channels.ReliableSessionBindingElement> クラスです。セッションは、SOAP 中継局およびトランスポート中継局を通過できます。  
+  
+-   その次には、承認、認証、保護、機密性などのセキュリティ機能を提供する、オプションの <xref:System.ServiceModel.Channels.SecurityBindingElement> クラスがあります。  
+  
+-   その次には、二重通信をネイティブでサポートしないトランスポート プロトコル \(HTTP など\) を使用して双方向の二重通信を可能にする、オプションの <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement> クラスがあります。  
+  
+-   その次には、一方向通信を提供する、オプションの <xref:System.ServiceModel.Channels.OneWayBindingElement> クラスがあります。  
+  
+-   その次にあるのは、オプションのストリーム セキュリティ バインド要素で、次のいずれかになります。  
+  
+    -   <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>  
+  
+-   その次にあるのは、必須のメッセージ エンコード バインド要素です。独自のメッセージ エンコーダーを使用するか、次の 3 つのメッセージ エンコーディング バインディングのいずれかを使用できます。  
+  
+    -   <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>  
+  
+    -   <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>  
+  
+ 最下位には、必須のトランスポート要素があります。独自のトランスポートを使用することも、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が提供する次のトランスポート バインド要素のいずれかを使用することもできます。  
+  
+-   <xref:System.ServiceModel.Channels.TcpTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.HttpTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.PeerTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.MsmqTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement>  
+  
+ 各層のオプションの概要を次の表に示します。  
+  
+|層|オプション|必須|  
+|-------|-----------|--------|  
+|トランザクション|<xref:System.ServiceModel.Channels.TransactionFlowBindingElement>|×|  
+|信頼性|<xref:System.ServiceModel.Channels.ReliableSessionBindingElement>|×|  
+|セキュリティ|<xref:System.ServiceModel.Channels.SecurityBindingElement>|×|  
+|エンコーディング|テキスト、バイナリ、MTOM \(Message Transmission Optimization Mechanism\)、カスタム|○|  
+|トランスポート|TCP、HTTP、HTTPS、名前付きパイプ \(IPC\)、ピアツーピア \(P2P\)、メッセージ キュー \(MSMQ\)、カスタム|○|  
+  
+ さらに、独自のバインド要素を定義し、それを定義済みの層のいずれかの間に挿入できます。  
+  
+## 参照  
+ [エンドポイントの作成の概要](../../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [サービスとクライアントを構成するためのバインディングの使用](../../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [方法 : システム指定のバインディングをカスタマイズする](../../../../docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md)   
+ [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)   
+ [カスタム バインディング](../../../../docs/framework/wcf/samples/custom-binding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-credential-and-credential-validation.md b/docs/framework/wcf/extending/custom-credential-and-credential-validation.md
new file mode 100644
index 00000000000..b433ad692aa
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-credential-and-credential-validation.md
@@ -0,0 +1,66 @@
+---
+title: "カスタム資格情報と資格情報の検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "資格情報の検証 [WCF]"
+  - "資格情報 [WCF]"
+  - "資格情報 [WCF], カスタム"
+  - "資格情報 [WCF], 検証"
+  - "カスタム資格情報 [WCF]"
+ms.assetid: da831bec-e281-4d44-b343-437b5eef688e
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# カスタム資格情報と資格情報の検証
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティは、サービスとクライアント間の資格情報の交換に基づきます。  セキュリティ シナリオの多くは、Windows \(Kerberos\)、ユーザー名とパスワード、証明書などの共通の資格情報の種類を使用して満たされます。  ただし、新しい種類の資格情報が必要な場合があります。このセクションのこのトピックでは、その新しい種類の処理方法と検証方法について説明します。  
+  
+## このセクションの内容  
+ [方法 : カスタム証明書検証を使用するサービスを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md)  
+ <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスを継承することで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の検証をカスタマイズする方法について説明します。  
+  
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)  
+ <xref:System.ServiceModel.Description.ClientCredentials> クラスと <xref:System.ServiceModel.Description.ServiceCredentials> クラスを拡張して新しい資格情報の種類に対応する方法を示します。  これは、カスタム資格情報の種類の作成を実現するトピック シリーズの 1 番目です。  
+  
+ [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)  
+ セキュリティ トークン プロバイダーを作成して新しい資格情報の種類を処理し、その資格情報の新しいトークンを返す方法を説明します。  これは、シリーズの 2 番目のトピックです。  
+  
+ [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)  
+ カスタム認証システムを作成して新しい資格情報の種類を認証する方法を説明します。  これは、シリーズの 3 番目のトピックです。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Security>  
+  
+ <xref:System.IdentityModel.Claims>  
+  
+ <xref:System.IdentityModel.Policy>  
+  
+ <xref:System.IdentityModel.Tokens>  
+  
+ <xref:System.IdentityModel.Selectors>  
+  
+ <xref:System.IdentityModel.Selectors.X509CertificateValidator>  
+  
+ <xref:System.ServiceModel.Description.ClientCredentials>  
+  
+ <xref:System.ServiceModel.Description.ServiceCredentials>  
+  
+## 関連項目  
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)  
+  
+ [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)  
+  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-encoders.md b/docs/framework/wcf/extending/custom-encoders.md
new file mode 100644
index 00000000000..84f228bed5f
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-encoders.md
@@ -0,0 +1,107 @@
+---
+title: "カスタム エンコーダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa0e1d7f-af36-4bf4-aac9-cd4eab95bc4f
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# カスタム エンコーダー
+このトピックでは、カスタム エンコーダーを作成する方法について説明します。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では *"バインディング"* を使用して、エンドポイントどうしがネットワーク経由でデータを転送する方法を指定します。  バインディングは、一連の *"バインド要素"* で構成されます。  バインディングには、セキュリティなどのオプションのプロトコル バインド要素、必須の*メッセージ エンコーダー*のバインド要素、および必須のトランスポートのバインド要素が含まれます。  メッセージ エンコーダーは、メッセージ エンコーディング バインド要素で表されます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれるメッセージ エンコーダーは、バイナリ、MTOM \(Message Transmission Optimization Mechanism\)、およびテキストの 3 つです。  
+  
+ メッセージ エンコーディング バインド要素は、送信する <xref:System.ServiceModel.Channels.Message> をシリアル化してそれをトランスポートに渡すか、シリアル化された形式のメッセージをトランスポートから受信して、それをプロトコル層 \(ある場合\) またはアプリケーション \(プロトコル層がない場合\) に渡します。  
+  
+ メッセージ エンコーダーは、<xref:System.ServiceModel.Channels.Message> インスタンスと物理メッセージ形式を相互に変換します。  エンコーダーは、チャネル スタックのトランスポート層の上に位置すると説明されていますが、トランスポート層の内部に存在します。  トランスポート \(HTTP など\) は、トランスポート標準の要件に従ってメッセージの書式設定を行います。  エンコーダー \(テキスト XML など\) は、単にメッセージのエンコードを行います。  
+  
+ 既存のクライアントまたはサーバーに接続する場合、特定のメッセージ エンコーディングを使用する選択ができない場合があります。  ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、それぞれが異なるメッセージ エンコーダーを使用する複数のエンドポイントからアクセスできるようにすることができます。  1 つのエンコーダーでサービスの対象ユーザー全体を網羅しない場合、複数のエンドポイントにサービスを公開することを検討します。  これによりクライアント アプリケーションはそのアプリケーションに最も適したエンドポイントを選択できます。  複数のエンドポイントを使用することにより、さまざまなメッセージ エンコーダーの利点を他のバインド要素と組み合わせることが可能になります。  
+  
+## システム指定のエンコーダー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、最も一般的なアプリケーション シナリオに合わせて設計されたシステム既定のバインディングがいくつか用意されています。  これらのバインディングは、それぞれトランスポート、メッセージ エンコーダー、その他のオプション \(セキュリティなど\) を組み合わせます。  このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる `Text`、`Binary`、`MTOM` メッセージ エンコーダーの拡張方法、つまり独自のカスタム エンコーダーの作成方法について説明します。  テキスト メッセージ エンコーダーは、通常の XML のエンコーディングに加えて、SOAP のエンコーディングもサポートします。  テキスト メッセージ エンコーダーの通常の XML エンコーディング モードは、テキスト ベースの SOAP エンコーディングと区別するために、POX \("Plain Old XML"\) エンコーダーと呼ばれます。  
+  
+ システム定義のバインディングにより提供されるバインド要素の組み合わせ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)」の対応するセクションを参照してください。  
+  
+## システム標準のエンコーダーの操作方法  
+ エンコーディングは、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> からの派生クラスを使用してバインディングに追加します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、テキスト、バイナリ、および MTOM \(Message Transmission Optimization Mechanism\) のエンコーディングに対応した <xref:System.ServiceModel.Channels.MessageEncodingBindingElement> クラスから派生した次の種類のバインド要素が提供されます。  
+  
+-   <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> : 相互運用性は最も高く、効率は最も低い、XML メッセージ用のエンコーダー。  Web サービスまたは Web サービス クライアントは、一般に、テキスト形式の XML を認識できます。  ただし、大きいブロックのバイナリ データをテキストとして転送するのは効率的ではありません。  
+  
+-   <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> : バイナリベースの XML メッセージで使用される、文字エンコーディングおよびメッセージのバージョン管理を指定するバインド要素を表します。  これは最も効率的なエンコーディング オプションですが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントでしかサポートされないため、相互運用性は最も低くなります。  
+  
+-   <xref:System.ServiceModel.Channels.MTOMMessageEncodingBindingElement> : Message Transmission Optimization Mechanism \(MTOM\) エンコードを使用するメッセージの文字エンコードおよびメッセージ バージョン管理を指定するバインド要素を表します。  MTOM は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージでのバイナリ データの転送に有効なテクノロジです。  MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。  MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックはテキストに変換せずにそのまま転送することによって最適化します。  
+  
+ バインド要素は、バイナリ、MTOM、またはテキストの <xref:System.ServiceModel.Channels.MessageEncoderFactory> を作成します。  ファクトリは、バイナリ、MTOM、またはテキストの <xref:System.ServiceModel.Channels.MessageEncoder> を作成します。  通常、インスタンスは 1 つだけあります。  ただし、セッションを使用すると、異なるエンコーダーを各セッションに提供できます。  バイナリ エンコーダーでは、これを利用して動的ディクショナリ \(XML インフラストラクチャを参照\) を調整します。  
+  
+ <xref:System.ServiceModel.Channels.MessageEncoder.ReadMessage%2A> メソッドと <xref:System.ServiceModel.Channels.MessageEncoder.WriteMessage%2A> メソッドは、エンコーダーのコアです。  このメソッドは、ストリームまたは <xref:System.Byte> 配列からのメッセージの読み取りに対応します。  バイト配列は、トランスポートをバッファー モードで操作している場合に使用されます。  メッセージはストリームに常に書き込まれます。  トランスポートでメッセージをバッファーする必要がある場合は、バッファリングを行うストリームが提供されます。  
+  
+ 残りのメンバーは、サポート コンテンツ、メディア タイプ、および <xref:System.ServiceModel.Channels.MessageEncoder.MessageVersion%2A> を処理します。  トランスポートは、このエンコーダー メソッドを呼び出して、受信メッセージがデコード可能かどうかをテストするか、または送信メッセージがこのエンコーダーに対して有効かどうかを決定します。  
+  
+ 3 つのそれぞれのエンコーダー実装は、特定のエンコーディングに関連するプロパティを追加し、完全に構成可能です。  また、エンコーダーは、安全な既定値を持つリーダーのクォータも公開しています。  クォータの詳細については、XML インフラストラクチャを参照してください。  
+  
+## システム標準のエンコーダーの機能  
+ システム標準のエンコーダーは多くの機能を提供します。  
+  
+### Pooling  
+ 各エンコーダー実装は、可能な限りプールを試みます。  マネージ コードのパフォーマンスを向上するには、割り当てを減らすことが重要です。  このプールを実現するには、実装で `SynchronizedPool` クラスを使用します。  C\# ファイルには、このクラスで使用する追加の最適化に関する記述を含めます。  
+  
+ メッセージごとに新しい `XmlDictionaryReader` および `XmlDictionaryWriter` インスタンスを割り当てるのを避けるため、これらのインスタンスをプールして再初期化します。  リーダーについては、`Close()` の呼び出し時に `OnClose` コールバックでリーダーが再利用されます。  また、エンコーダーでは、メッセージを作成するときに使用するいくつかのメッセージ状態オブジェクトが再利用されます。  このプールのサイズは、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> から派生した 3 つの各クラスの `MaxReadPoolSize` プロパティと `MaxWritePoolSize` プロパティによって構成可能です。  
+  
+### バイナリ エンコーディング  
+ バイナリ エンコーディングでセッションを使用する場合、動的ディクショナリの文字列をメッセージの受信者と通信する必要があります。  これを行うには、メッセージのプレフィックスに動的ディクショナリの文字列を指定します。  受信側では、その文字列を取り除いて、セッションに追加し、メッセージ処理を行います。  ディクショナリの文字列を正しく渡すには、トランスポートをバッファーする必要があります。  
+  
+ 文字列は、内部 `AddSessionInformationToMessage` メソッドによってメッセージに追加されます。  文字列は、メッセージの先頭に UTF\-8 として追加され、その長さがプレフィックスに指定されます。  次にディクショナリ ヘッダー全体のプレフィックスにそのデータ長が指定されます。  内部 `ExtractSessionInformationFromMessage` メソッドにより逆操作が実行されます。  
+  
+ 動的ディクショナリ キーの処理に加え、バッファーされセッションの多いメッセージが独自の方法で受信されます。  ドキュメントでリーダーを作成して処理する代わりに、バイナリ エンコーダーは、内部 `MessagePatterns` クラスを使用してバイナリ ストリームを分解します。  つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で作成されたほとんどのメッセージには、特定の順序で表された特定セットのヘッダーがあります。  想定を基にしたパターン システムによりメッセージは分割されます。  成功した場合は、XML の解析を行わずに <xref:System.ServiceModel.Channels.MessageHeaders> オブジェクトを初期化します。  成功しなかった場合は、標準の方法に戻ります。  
+  
+### MTOM エンコーディング  
+ <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> クラスには、<xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement.MaxBufferSize%2A> という追加の構成プロパティがあります。  これには、メッセージ読み取り中にバッファーできるデータ量の上限が設けられています。  すべての MIME パートを 1 つのメッセージに再アセンブルするために、XML 情報セット \(Infoset\) または他の MIME パートをバッファーすることが必要な場合もあります。  
+  
+ HTTP を正しく操作するために、内部 MTOM メッセージ エンコーダーのクラスでは、`GetContentType` \(内部\) や `WriteMessage` \(パブリックで、オーバーライド可能\) の内部 API がいくつか用意されています。  HTTP ヘッダーの値を MIME ヘッダーの値と一致させるには、多くの通信を行う必要があります。  
+  
+ 内部的に、MTOM メッセージ エンコーダーは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のテキスト リーダーを使用するので、テキスト エンコーダーに似ています。  主な違いは、Base\-64 エンコーディングに変換せずにメッセージ バイトに埋め込むことで、大きいサイズのバイナリ \(バイナリ ラージ オブジェクト \(BLOB\) と呼びます\) を最適化する点です。  代わりに、この BLOB は抽出され、MIME 添付として参照されます。  
+  
+## 独自のエンコーダーの作成  
+ 独自のカスタム メッセージ エンコーダーを実装するには、次の抽象基本クラスのカスタム実装を提供する必要があります。  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncoder>  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncoderFactory>  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>  
+  
+ メッセージのメモリ内表現からストリームに書き込むことのできる表現への変換は、 <xref:System.ServiceModel.Channels.MessageEncoder> クラスにカプセル化されており、このクラスは、特定の種類の XML エンコーディングをサポートする XML リーダーおよび XML ライターに対するファクトリとして機能します。  
+  
+-   オーバーライドを必要とする、このクラスの主要なメソッドを次に示します。  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncoder.WriteMessage%2A>。<xref:System.ServiceModel.Channels.Message> オブジェクトを受け取り、それを <xref:System.IO.Stream> オブジェクトに書き込みます。  
+  
+-   <xref:System.ServiceModel.Channels.MessageEncoder.ReadMessage%2A>。<xref:System.IO.Stream> オブジェクトと最大ヘッダー サイズを受け取り、<xref:System.ServiceModel.Channels.Message> オブジェクトを返します。  
+  
+ これらのメソッドに記述するコードは、標準トランスポート プロトコルとカスタマイズしたエンコーディングの間の変換処理です。  
+  
+ 次に、カスタム エンコーダーを作成するファクトリ クラスをコーディングする必要があります。  <xref:System.ServiceModel.Channels.MessageEncoderFactory.Encoder%2A> をオーバーライドして、独自のカスタム <xref:System.ServiceModel.Channels.MessageEncoder> のインスタンスを返します。  
+  
+ 次に、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement.CreateMessageEncoderFactory%2A> メソッドをオーバーライドしてこのファクトリのインスタンスを返すようにすることで、サービスまたはクライアントの構成に使用されるバインド要素スタックにカスタム <xref:System.ServiceModel.Channels.MessageEncoderFactory> を接続します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、この処理を説明する 2 つの例がサンプル コードと共に用意されています。「[カスタム メッセージ エンコーダー : カスタム テキスト エンコーダー](../../../../docs/framework/wcf/samples/custom-message-encoder-custom-text-encoder.md)」および「[カスタム メッセージ エンコーダー : 圧縮エンコーダー](../../../../docs/framework/wcf/samples/custom-message-encoder-compression-encoder.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.MessageEncoderFactory>   
+ <xref:System.ServiceModel.Channels.MessageEncoder>   
+ [データ転送のアーキテクチャの概要](../../../../docs/framework/wcf/feature-details/data-transfer-architectural-overview.md)   
+ [メッセージ エンコーダーを選択する](../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)   
+ [トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-message-formatters.md b/docs/framework/wcf/extending/custom-message-formatters.md
new file mode 100644
index 00000000000..49784d692f0
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-message-formatters.md
@@ -0,0 +1,45 @@
+---
+title: "カスタム メッセージ フォーマッタ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c07435f3-5214-4791-8961-2c2b61306d71
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# カスタム メッセージ フォーマッタ
+メッセージの内容は、XML 形式で表されることが多く、この形式は通常、アプリケーションにとって処理しやすい形式ではありません。  アプリケーションでは、オブジェクトのプロパティを取得および設定することによってオブジェクトを操作します。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、*データ コントラクト*を使用して、<xref:System.ServiceModel.Channels.Message> オブジェクトをアプリケーションで処理しやすいオブジェクトに変換します。  このプロセスは、シリアル化および逆シリアル化と呼ばれます。  これと同じ用語が、トランスポート層によって行われるメッセージ ワイヤ形式へのシリアル化とその形式からの逆シリアル化を説明するときに使用されますが、これは関連のないプロセスです。  
+  
+ データ コントラクトによって実現できないメッセージとオブジェクト間の特殊な変換を実装する必要がある場合、カスタム メッセージ フォーマッタを使用できます。  これを使用するには、クライアントまたはサービス上で特定のコントラクト操作の実行動作を変更または拡張します。  
+  
+## クライアントのカスタム メッセージ フォーマッタ  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> インターフェイスは、メッセージからオブジェクトへの変換およびオブジェクトからクライアント アプリケーション用のメッセージへの変換を制御するためのメソッドを定義します。  
+  
+ このインターフェイスを実装する必要があります。  まず、メッセージを逆シリアル化するための <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.DeserializeReply%2A> メソッドをオーバーライドします。  このメソッドは、受信メッセージを受信した後でそのメッセージがクライアント操作にディスパッチされる前に呼び出されます。  
+  
+ 次に、オブジェクトをシリアル化するための <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.SerializeRequest%2A> メソッドをオーバーライドします。  このメソッドは、送信メッセージを送信する前に呼び出されます。  
+  
+ カスタム フォーマッタをサービス アプリケーションに挿入するには、操作の動作を使用して、<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> オブジェクトを <xref:System.ServiceModel.Dispatcher.ClientOperation.Formatter%2A> プロパティに割り当てます。  動作の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+## サービスのカスタム メッセージ フォーマッタ  
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> インターフェイスは、<xref:System.ServiceModel.Channels.Message> オブジェクトを操作用のパラメーターに変換し、これらのパラメーターをサービス アプリケーション用の <xref:System.ServiceModel.Channels.Message> オブジェクトに変換するためのメソッドを定義します。  
+  
+ このインターフェイスを実装する必要があります。  まず、メッセージを逆シリアル化するための <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.DeserializeReply%2A> メソッドをオーバーライドします。  このメソッドは、受信メッセージを受信した後でそのメッセージがクライアント操作にディスパッチされる前に呼び出されます。  
+  
+ 次に、オブジェクトをシリアル化するための <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.SerializeRequest%2A> メソッドをオーバーライドします。  このメソッドは、送信メッセージを送信する前に呼び出されます。  
+  
+ カスタム フォーマッタをサービス アプリケーションに挿入するには、操作の動作を使用して、<xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> オブジェクトを <xref:System.ServiceModel.Dispatcher.DispatchOperation.Formatter%2A> プロパティに割り当てます。  動作の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter>   
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter>   
+ [動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-stream-upgrades.md b/docs/framework/wcf/extending/custom-stream-upgrades.md
new file mode 100644
index 00000000000..0eba26fd921
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-stream-upgrades.md
@@ -0,0 +1,111 @@
+---
+title: "カスタム ストリームのアップグレード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3da85c8-57f3-4e32-a4cb-50123f30fea6
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# カスタム ストリームのアップグレード
+TCP、名前付きパイプなど、ストリーム指向のデータ伝送機構 \(トランスポート\) が扱うのは、クライアントとサーバーの間を流れる、連続的なバイト ストリームです。  このストリームを実際に作り出すのは <xref:System.IO.Stream> オブジェクトです。  ストリーム アップグレードでは、クライアントは、オプションのプロトコル階層をチャネル スタックに追加する場合に、相手側の通信チャネルにも同じことをするよう要求します。  ストリーム アップグレードは、<xref:System.IO.Stream> オブジェクトをアップグレードされたものに置き換える形で実施します。  
+  
+ たとえば、トランスポート ストリームのすぐ上に圧縮ストリームを作成することができます。  この場合、元のトランスポート <xref:System.IO.Stream> を、それを圧縮 <xref:System.IO.Stream> でラップしたものに置き換えます。  
+  
+ オブジェクトを順にラップしていくことにより、ストリーム アップグレードを多重に適用できます。  
+  
+## ストリーム アップグレードの動作  
+ ストリーム アップグレード処理には 4 つのコンポーネントが関与します。  
+  
+1.  *イニシエーター*は、必要な処理を起動するコンポーネントです。実行時に、接続先に対して、同じようにチャネル トランスポート層をアップグレードするよう要求する役割があります。  
+  
+2.  *アクセプタ*は実際にアップグレードを行うコンポーネントです。接続先からのアップグレード要求を受け取り、可能であれば実際にアップグレードする役割があります。  
+  
+3.  *プロバイダー*は、クライアント上に*イニシエーター*、サーバー上に*アクセプタ*を生成するコンポーネントです。  
+  
+4.  *バインド要素*は、サービスやクライアントのバインディングに追加され、実行時にプロバイダーを生成するコンポーネントです。  
+  
+ なお、多重にアップグレードを適用する場合、イニシエーターとアクセプタはステート マシンをカプセル化して、適切な適用順序になるようにします。  
+  
+## ストリーム アップグレードの実装方法  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、次のコンポーネントを実装するために、4 つの `abstract` クラスがあります。  
+  
+-   <xref:System.ServiceModel.Channels.StreamUpgradeInitiator?displayProperty=fullName>  
+  
+-   <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor?displayProperty=fullName>  
+  
+-   <xref:System.ServiceModel.Channels.StreamUpgradeProvider?displayProperty=fullName>  
+  
+-   <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement?displayProperty=fullName>  
+  
+ カスタム ストリーム アップグレードを実装する手順を以下に示します。  これは、クライアント側、サーバー側双方に、ごく単純なストリーム アップグレード処理を組み込む場合の手順です。  
+  
+1.  <xref:System.ServiceModel.Channels.StreamUpgradeInitiator> を実装するクラスを作成します。  
+  
+    1.  <xref:System.ServiceModel.Channels.StreamUpgradeInitiator.InitiateUpgrade%2A> メソッドをオーバーライドして、ストリームを入力すると、それをアップグレードしたストリームが返されるようにします。  これは同期型のメソッドですが、これに似た非同期型のメソッドもあります。  
+  
+    2.  <xref:System.ServiceModel.Channels.StreamUpgradeInitiator.GetNextUpgrade%2A> メソッドをオーバーライドして、追加のアップグレードがないか確認するようにします。  
+  
+2.  <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor> を実装するクラスを作成します。  
+  
+    1.  <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor.AcceptUpgrade%2A> メソッドをオーバーライドして、ストリームを入力すると、それをアップグレードしたストリームが返されるようにします。  これは同期型のメソッドですが、これに似た非同期型のメソッドもあります。  
+  
+    2.  <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor.CanUpgrade%2A> メソッドをオーバーライドして、アップグレード処理中のこの時点で、このアップグレード アクセプタがアップグレード要求に応じることができるかどうかを判断するようにします。  
+  
+3.  <xref:System.ServiceModel.Channels.StreamUpgradeProvider> を実装するクラスを作成します。  <xref:System.ServiceModel.Channels.StreamUpgradeProvider.CreateUpgradeAcceptor%2A> メソッドおよび <xref:System.ServiceModel.Channels.StreamUpgradeProvider.CreateUpgradeInitiator%2A> メソッドをオーバーライドして、手順 1. および 2. で定義したアクセプタとイニシエーターのインスタンスをそれぞれ返すようにします。  
+  
+4.  <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement> を実装するクラスを作成します。  
+  
+    1.  クライアント側の <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement.BuildClientStreamUpgradeProvider%2A> メソッドとサービス側の <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement.BuildServerStreamUpgradeProvider%2A> メソッドをオーバーライドします。  
+  
+    2.  クライアント側の <xref:System.ServiceModel.Channels.BindingElement.BuildChannelFactory%2A> メソッドとサービス側の <xref:System.ServiceModel.Channels.BindingElement.BuildChannelListener%2A> メソッドをオーバーライドして、アップグレード バインド要素を <xref:System.ServiceModel.Channels.BindingContext.BindingParameters%2A> に追加するようにします。  
+  
+5.  サーバー側とクライアント側のバインディングに、新しいストリーム アップグレード バインド要素を追加します。  
+  
+## セキュリティ アップグレード  
+ ストリーム アップグレードの特別な場合として、セキュリティ アップグレードがあります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には最初から、セキュリティに関連するストリーム アップグレードを実装するためのバインド要素が 2 つ組み込まれています。  トランスポート レベルのセキュリティ構成は、<xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement> および <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement> にカプセル化されており、これらの要素を構成して、カスタム バインディングに追加することができます。  この 2 つのバインド要素は、クライアント側およびサーバー側のストリーム アップグレード プロバイダーを構築する <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement> クラスを拡張したものです。  これらのバインド要素には、セキュリティ ストリーム アップグレード専用のプロバイダー クラスを作成するメソッドが定義されています。これらのメソッドは `public` ではないので、いずれの場合もバインド要素をバインディングに追加するだけでセキュリティ アップグレードが可能です。  
+  
+ 上記の 2 つのバインド要素では対応できないセキュリティ上の要求に備え、既述のイニシエーター、アクセプタ、プロバイダーの各基底クラスから派生した `abstract` クラスが 3 つ定義されています。  
+  
+1.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeInitiator?displayProperty=fullName>  
+  
+2.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeAcceptor?displayProperty=fullName>  
+  
+3.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeProvider?displayProperty=fullName>  
+  
+ セキュリティ ストリーム アップグレードを実装する手順も、以上 3 つのクラスから派生することを除き、一般のストリーム アップグレードと同様です。  これらのクラスには実行時にセキュリティ情報をやり取りするためのプロパティが追加されているので、これをオーバーライドしてください。  
+  
+## 多重アップグレード  
+ 追加のアップグレード要求を作成するには、前述の手順を繰り返して、追加の <xref:System.ServiceModel.Channels.StreamUpgradeProvider> およびバインド要素の拡張を作成し、  これをバインディングに追加します。  各バインド要素は、バインディングに追加した順に処理されます。  各アップグレード プロバイダーは、<xref:System.ServiceModel.Channels.BindingElement.BuildChannelFactory%2A> および <xref:System.ServiceModel.Channels.BindingElement.BuildChannelListener%2A> で、既存のアップグレード バインディング パラメーターに、どのように自分自身を積み重ねるかを指定できます。  次に、既存のアップグレード バインディング パラメーターを、新しい複合アップグレード バインディング パラメーターに置き換えます。  
+  
+ あるいは、単一のアップグレード プロバイダーで、多重のアップグレードに対応することも可能です。  たとえば、セキュリティと圧縮の両方に対応するカスタム ストリーム アップグレード プロバイダーを実装できます。  次の手順を実行します。  
+  
+1.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeProvider> のサブクラスとして、イニシエーターおよびアクセプタを生成するプロバイダー クラスを作成します。  
+  
+2.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeInitiator> のサブクラスを作成し、<xref:System.ServiceModel.Channels.StreamUpgradeInitiator.GetNextUpgrade%2A> メソッドをオーバーライドして、圧縮ストリーム、セキュリティ ストリームの順にコンテンツ タイプを返すようにします。  
+  
+3.  <xref:System.ServiceModel.Channels.StreamSecurityUpgradeAcceptor> のサブクラスを作成し、<xref:System.ServiceModel.Channels.StreamUpgradeAcceptor.CanUpgrade%2A> メソッドをオーバーライドして、独自のコンテンツ タイプに応じた処理をするようにします。  
+  
+4.  ストリームは、<xref:System.ServiceModel.Channels.StreamUpgradeInitiator.GetNextUpgrade%2A> および <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor.CanUpgrade%2A> をそれぞれ呼び出した後にアップグレードされます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.StreamUpgradeInitiator>   
+ <xref:System.ServiceModel.Channels.StreamSecurityUpgradeInitiator>   
+ <xref:System.ServiceModel.Channels.StreamUpgradeAcceptor>   
+ <xref:System.ServiceModel.Channels.StreamSecurityUpgradeAcceptor>   
+ <xref:System.ServiceModel.Channels.StreamUpgradeProvider>   
+ <xref:System.ServiceModel.Channels.StreamSecurityUpgradeProvider>   
+ <xref:System.ServiceModel.Channels.StreamUpgradeBindingElement>   
+ <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/custom-tokens.md b/docs/framework/wcf/extending/custom-tokens.md
new file mode 100644
index 00000000000..2815f2b5584
--- /dev/null
+++ b/docs/framework/wcf/extending/custom-tokens.md
@@ -0,0 +1,26 @@
+---
+title: "カスタム トークン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], カスタム トークン"
+ms.assetid: 8b2dbe29-dec2-4652-8e34-fb21bc1437b5
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# カスタム トークン
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、資格情報として、X.509 証明書、セキュリティ コンテキスト トークン、Kerberos チケット、およびユーザー名トークンをネイティブでサポートしますが、独自のカスタム資格情報を使用することもできます。  
+  
+## このセクションの内容  
+ [方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)  
+ <xref:System.IdentityModel.Tokens.SecurityToken> クラスを使用してカスタム セキュリティ トークンを作成する方法と、作成したトークンをカスタム セキュリティ トークン プロバイダーおよび認証システムと統合する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/data-contract-surrogates.md b/docs/framework/wcf/extending/data-contract-surrogates.md
new file mode 100644
index 00000000000..73149ecf4a3
--- /dev/null
+++ b/docs/framework/wcf/extending/data-contract-surrogates.md
@@ -0,0 +1,207 @@
+---
+title: "データ コントラクト サロゲート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], サロゲート"
+ms.assetid: 8c31134c-46c5-4ed7-94af-bab0ac0dfce5
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# データ コントラクト サロゲート
+データ コントラクト *サロゲート*は、データ コントラクト モデルを基盤に構築された高度な機能です。この機能は、型をシリアル化または逆シリアル化する方法や、型をメタデータに投影する方法をユーザーが変更する場合に、型のカスタマイズと置換に使用することを目的としています。サロゲートを使用できるのは、型のデータ コントラクトが指定されていない場合、フィールドやプロパティが <xref:System.Runtime.Serialization.DataMemberAttribute> 属性でマークされていない場合、またはユーザーがスキーマのバリエーションを動的に作成することを希望している場合などです。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> を使用して .NET Framework から XML などの適切な形式に変換するときに、データ コントラクト サロゲートを使用してシリアル化と逆シリアル化を行います。また、XML スキーマ ドキュメント \(XSD\) などのメタデータ表現を生成するときに、データ コントラクト サロゲートを使用して、型のエクスポートするメタデータを変更できます。インポート時には、メタデータからコードが作成されますが、この場合にサロゲートを使用すると、生成されるコードもカスタマイズできます。  
+  
+## サロゲートのしくみ  
+ サロゲートは、ある型 \("元の" 型\) を別の型 \("サロゲートされた" 型\) に割り当てることによって機能します。元の型 `Inventory` と新しいサロゲート型 `InventorySurrogated` の例を以下に示します。`Inventory` 型はシリアル化できませんが、`InventorySurrogated` 型は以下のようになります。  
+  
+ [!code-csharp[C_IDataContractSurrogate#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#1)]  
+  
+ このクラスにはデータ コントラクトが定義されていないため、このクラスをデータ コントラクトを持つサロゲート クラスに変換します。サロゲートされたクラスの例を次に示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#2)]  
+  
+## IDataContractSurrogate の実装  
+ データ コントラクト サロゲートを使用するには、<xref:System.Runtime.Serialization.IDataContractSurrogate> インターフェイスを実装します。  
+  
+ 考えられる実装での <xref:System.Runtime.Serialization.IDataContractSurrogate> の各メソッドの概要を以下に示します。  
+  
+### GetDataContractType  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetDataContractType%2A> メソッドは、ある型を別の型に割り当てます。これは、シリアル化、逆シリアル化、インポート、およびエクスポートに必須のメソッドです。  
+  
+ 最初の作業として、他の型に割り当てる型を定義します。次に例を示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#3)]  
+  
+-   シリアル化では、後で <xref:System.Runtime.Serialization.IDataContractSurrogate.GetObjectToSerialize%2A> メソッドを呼び出して、元のインスタンスをサロゲートされたインスタンスに変換する際に、このメソッドによって返されたマッピングが使用されます。  
+  
+-   逆シリアル化では、サロゲート型のインスタンスに逆シリアル化する際に、シリアライザーはこのメソッドによって返されたマッピングを使用します。その後、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetDeserializedObject%2A> が呼び出されて、サロゲートされたインスタンスが元の型のインスタンスに変換されます。  
+  
+-   エクスポートでは、メタデータの生成に使用するデータ コントラクトを取得する際に、このメソッドによって返されたサロゲート型が反映されます。  
+  
+-   インポートでは、最初の型がサロゲート型に変更されます。このサロゲート型は、参照のサポートなどの目的で使用するデータ コントラクトを取得する際に反映されます。  
+  
+ <xref:System.Type> パラメーターは、シリアル化、逆シリアル化、インポート、またはエクスポートするオブジェクトの型です。サロゲートが型を処理しない場合、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetDataContractType%2A> メソッドは入力の型を返す必要があります。それ以外の場合は、サロゲートされた適切な型を返します。複数のサロゲート型が存在する場合は、このメソッドで多数のマッピングを定義できます。  
+  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetDataContractType%2A> メソッドは、組み込みのデータ コントラクト プリミティブ \(<xref:System.Int32> や <xref:System.String> など\) に対しては呼び出されません。その他の型 \(配列、ユーザー定義型、その他のデータ構造体など\) については、このメソッドは各型に対して呼び出されます。  
+  
+ 前の例では、このメソッドは `type` パラメーターと `Inventory` が比較可能かどうかをチェックします。比較可能な場合は、`InventorySurrogated` に割り当てます。シリアル化、逆シリアル化、インポート スキーマ、またはエクスポート スキーマを呼び出すときは、常にこの関数が最初に呼び出されて、型間のマッピングが確認されます。  
+  
+### GetObjectToSerialize Method  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetObjectToSerialize%2A> メソッドは、元の型のインスタンスをサロゲートされた型のインスタンスに変換します。これは、シリアル化に必須のメソッドです。  
+  
+ 次の手順では、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetObjectToSerialize%2A> メソッドを実装して、物理データを元のインスタンスからサロゲートに割り当てる方法を定義します。次に例を示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#4)]  
+  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetObjectToSerialize%2A> メソッドは、オブジェクトをシリアル化するときに呼び出されます。このメソッドでは、元の型からサロゲートされた型のフィールドにデータを転送します。フィールドは、サロゲート フィールドに直接割り当てることができます。また、元のデータの操作をサロゲートに格納することもできます。このメソッドは、フィールドを直接割り当てる場合、サロゲートされたフィールドに格納されたデータに対して操作を実行する場合、サロゲートされたフィールドに元の型の XML を格納する場合などに使用できます。  
+  
+ `targetType` パラメーターは、メンバーの宣言された型を指します。このパラメーターは、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetDataContractType%2A> メソッドによって返されたサロゲートされた型です。シリアライザーは、返されるオブジェクトがこの型に割り当て可能であることを強制するわけではありません。`obj` パラメーターはシリアル化するオブジェクトであり、必要に応じてサロゲートに変換されます。サロゲートがオブジェクトを処理しない場合、このメソッドは入力オブジェクトを返す必要があります。それ以外の場合は、新しいサロゲート オブジェクトが返されます。オブジェクトが null の場合、サロゲートは呼び出されません。さまざまなインスタンスの多数のサロゲートのマッピングをこのメソッドで定義できます。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> の作成時に、オブジェクト参照を保持するように指定できます \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md).\)これを行うには、コンストラクターの `preserveObjectReferences` パラメーターを `true` に設定します。この場合、サロゲートはオブジェクトに対して 1 回だけ呼び出されます。これは、以降のシリアル化では参照をストリームに書き込むだけだからです。`preserveObjectReferences` を `false` に設定すると、インスタンスが発生するたびにサロゲートが呼び出されます。  
+  
+ シリアル化されたインスタンスの型が宣言された型と異なる場合、インスタンスをもう一方の側で逆シリアル化できるように、型情報 \(`xsi:type` など\) がストリームに書き込まれます。このプロセスは、オブジェクトがサロゲートされているかどうかに関係なく発生します。  
+  
+ 前述の例では、`Inventory` インスタンスのデータが `InventorySurrogated` のデータに変換されます。オブジェクトの型がチェックされ、サロゲートされた型に変換するために必要な処理が実行されます。この場合、`Inventory` クラスの各フィールドは、`InventorySurrogated` クラスのフィールドに直接コピーされます。  
+  
+### GetDeserializedObject Method  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetDeserializedObject%2A> メソッドは、サロゲートされた型のインスタンスを元の型のインスタンスに変換します。これは、逆シリアル化に必須のメソッドです。  
+  
+ 次の作業として、サロゲート インスタンスから元のインスタンスに物理データを割り当てる方法を定義します。次に例を示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#5)]  
+  
+ このメソッドが呼び出されるのは、オブジェクトの逆シリアル化中だけです。このメソッドは、サロゲート型から元の型に戻す逆シリアル化に必要な逆方向のデータ マッピングを行います。`GetObjectToSerialize` メソッドと同様に、フィールド データを直接交換する場合、データに対して操作を実行する場合、XML データを格納する場合などに使用できます。逆シリアル化するときには、データ変換時の操作の結果として、元のデータから正確なデータ値を必ずしも取得できるとは限りません。  
+  
+ `targetType` パラメーターは、メンバーの宣言された型を指します。このパラメーターは、`GetDataContractType` メソッドによって返されたサロゲートされた型です。`obj` パラメーターは、逆シリアル化されたオブジェクトを参照します。オブジェクトがサロゲートされている場合、オブジェクトを変換して元の型に戻すことができます。サロゲートがオブジェクトを処理しない場合、このメソッドは入力オブジェクトを返します。それ以外の場合は、変換が完了すると、逆シリアル化されたオブジェクトが返されます。複数のサロゲート型が存在する場合、各型とその変換を示すことにより、サロゲートからそれぞれのプライマリ型へのデータ変換を提供できます。  
+  
+ オブジェクトを返す場合、このサロゲートによって返されたオブジェクトで内部オブジェクト テーブルが更新されます。インスタンスへの以降の参照では、このオブジェクト テーブルからサロゲートされたインスタンスが取得されます。  
+  
+ 前の例では、`InventorySurrogated` 型のオブジェクトが最初の `Inventory` 型に変換されます。この場合、データは `InventorySurrogated` から `Inventory` の対応するフィールドに直接転送されます。データ操作は発生しないため、各メンバー フィールドにはシリアル化前と同じ値が格納されます。  
+  
+### GetCustomDataToExport Method  
+ スキーマをエクスポートする場合、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetCustomDataToExport%2A> メソッドは省略可能です。このメソッドは、エクスポートするスキーマに追加データやヒントを挿入するために使用します。追加データは、メンバー レベルまたは型レベルで挿入できます。次に例を示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#6)]  
+  
+ このメソッド \(2 つのオーバーロードを持ちます\) を使用すると、メンバー レベルまたは型レベルで、追加情報をメタデータに含めることができます。メンバーが public と private のどちらであるかに関するヒントや、スキーマのエクスポートとインポート全体を通じて保持されるコメントを含めることができます。このメソッドを使用しない場合、このような情報は失われます。このメソッドは、メンバーまたは型の挿入や削除を行うのではなく、メンバー レベルまたは型レベルでスキーマに付加的なデータを追加します。  
+  
+ このメソッドのオーバーロードでは、`Type` \(`clrtype` パラメーター\) または <xref:System.Reflection.MemberInfo> \(`memberInfo` パラメーター\) を取得できます。2 番目のパラメーターは、常に `Type` \(`dataContractType` パラメーター\) です。このメソッドは、サロゲートされた `dataContractType` 型のすべてのメンバーと型に対して呼び出されます。  
+  
+ どちらのオーバーロードでも、`null` またはシリアル化可能なオブジェクトを返す必要があります。null 以外のオブジェクトは、エクスポートするスキーマに注釈としてシリアル化されます。`Type` オーバーロードでは、スキーマにエクスポートされる各型は、`dataContractType` パラメーターのサロゲートされた型と共に、最初のパラメーターでこのメソッドに送信されます。`MemberInfo` オーバーロードでは、スキーマにエクスポートされる各メンバーが、2 番目のパラメーターのサロゲートされた型と共に `memberInfo` パラメーターとして情報を送信します。  
+  
+#### GetCustomDataToExport Method \(Type, Type\)  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetCustomDataToExport%28System.Type%2CSystem.Type%29?displayProperty=fullName> メソッドは、すべての型定義のスキーマのエクスポート中に呼び出されます。このメソッドは、エクスポート時にスキーマ内の型に情報を追加します。スキーマに含める必要のある追加データがあるかどうかを確認するために、定義済みの各型がこのメソッドに送信されます。  
+  
+#### GetCustomDataToExport Method \(MemberInfo, Type\)  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetCustomDataToExport%28System.Reflection.MemberInfo%2CSystem.Type%29?displayProperty=fullName> は、エクスポートする型のすべてのメンバーのエクスポート中に呼び出されます。この関数を使用すると、エクスポート時にスキーマに含めるメンバーに関するコメントをカスタマイズできます。スキーマに付加的なデータを追加する必要があるかどうかをチェックするために、クラスの各メンバーの情報がこのメソッドに送信されます。  
+  
+ 前述の例では、サロゲートの各メンバーの `dataContractType` が検索されます。検索後、各フィールドの適切なアクセス修飾子が返されます。このカスタマイズを行わない場合、アクセス修飾子の既定値は public です。したがって、実際のアクセス制限には関係なく、エクスポートされたスキーマを使用して生成されるコードでは、すべてのメンバーが public として定義されます。この実装を使用しない場合、`numpens` メンバーは、サロゲートで private として定義されている場合でも、エクスポートされたスキーマでは public になります。このメソッドを使用することにより、エクスポートされるスキーマで、アクセス修飾子を private として生成できます。  
+  
+### GetReferencedTypeOnImport Method  
+ このメソッドは、サロゲートの <xref:System.Type> を元の型に割り当てます。スキーマのインポートでは、このメソッドは省略可能です。  
+  
+ スキーマをインポートし、そのコードを生成するサロゲートを作成したら、次の作業として、元の型に対してサロゲート インスタンスの型を定義します。  
+  
+ 生成されるコードで既存のユーザー型を参照する必要がある場合は、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetReferencedTypeOnImport%2A> メソッドを実装してこれを行います。  
+  
+ スキーマをインポートするときに、サロゲートされたデータ コントラクトを型に割り当てるために、すべての型宣言に対してこのメソッドが呼び出されます。`typeName` および `typeNamespace` の各文字列パラメーターでは、サロゲートされた型の名前と名前空間が定義されます。<xref:System.Runtime.Serialization.IDataContractSurrogate.GetReferencedTypeOnImport%2A> の戻り値は、新しい型を生成する必要があるかどうかを判断するために使用されます。このメソッドは、有効な型または null のいずれかを返す必要があります。有効な型を返す場合、返される型は生成されるコード内で参照される型として使用されます。null を返す場合は、型が参照されることはないため、新しい型を作成する必要があります。複数のサロゲートが存在する場合は、各サロゲート型から最初の型へのマッピングを実行できます。  
+  
+ `customData` パラメーターは、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetCustomDataToExport%2A> から最初に返されたオブジェクトです。この `customData` は、サロゲート作成者が、コードを生成するためにインポート時に使用するメタデータに追加情報やヒントを挿入する場合に使用します。  
+  
+### ProcessImportedType メソッド  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.ProcessImportedType%2A> メソッドは、スキーマのインポートから作成された型をカスタマイズします。このメソッドは省略可能です。  
+  
+ スキーマをインポートするときに、このメソッドを使用すると、インポートする型とコンパイルの情報をカスタマイズできます。次に例を示します。  
+  
+ [!code-csharp[C_IDataContractSurrogate#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#7)]  
+  
+ インポート中に、このメソッドは生成されるすべての型に対して呼び出されます。指定した <xref:System.CodeDom.CodeTypeDeclaration> を変更するか、<xref:System.CodeDom.CodeCompileUnit> を変更します。これには、`CodeTypeDeclaration` の名前、メンバー、属性、および他のさまざまなプロパティの変更が含まれます。`CodeCompileUnit` を処理することにより、ディレクティブ、名前空間、参照アセンブリ、および他のいくつかの側面を変更できます。  
+  
+ `CodeTypeDeclaration` パラメーターには、DOM コードの型宣言が含まれます。`CodeCompileUnit` パラメーターでは、コードの処理に関する変更を行うことができます。`null` を返すと、型宣言が破棄されます。`CodeTypeDeclaration` を返すと、変更が保持されます。  
+  
+ メタデータのエクスポート時にカスタム データを挿入した場合は、インポート時にこのデータをユーザーに提供して、データを使用できるようにする必要があります。このカスタム データは、プログラミング モデルのヒントやその他のコメントに使用できます。各 `CodeTypeDeclaration` と <xref:System.CodeDom.CodeTypeMember> インスタンスには、`IDataContractSurrogate` 型にキャストされる <xref:System.CodeDom.CodeObject.UserData%2A> プロパティとしてカスタム データが含まれます。  
+  
+ 前述の例では、インポートするスキーマに対して変更が行われています。コードでは、サロゲートを使用して元の型の private メンバーを保持しています。スキーマをインポートするときの既定のアクセス修飾子は `public` です。したがって、この例のように変更しない限り、サロゲート スキーマのすべてのメンバーは public になります。エクスポート中に、どのメンバーが private であるかに関するカスタム データがメタデータに挿入されます。この例では、カスタム データを調べ、アクセス修飾子が private かどうかをチェックした後、属性を設定することで適切なメンバーを private に変更しています。このカスタマイズを行わない場合、`numpens` メンバーは、private ではなく public として定義されます。  
+  
+### GetKnownCustomDataTypes メソッド  
+ このメソッドは、スキーマから定義済みのカスタム データ型を取得します。スキーマのインポートでは、このメソッドは省略可能です。  
+  
+ このメソッドは、スキーマのエクスポートとインポートの開始時に呼び出されます。このメソッドは、エクスポートまたはインポートするスキーマで使用されるカスタム データ型を返します。メソッドには、型のコレクションである <xref:System.Collections.ObjectModel.Collection%601> \(`customDataTypes` パラメーター\) が渡されます。このメソッドでは、既知の型をこのコレクションに追加する必要があります。既知のカスタム データ型は、<xref:System.Runtime.Serialization.DataContractSerializer> を使用したカスタム データのシリアル化と逆シリアル化を可能にするために必要となります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md).  
+  
+## サロゲートの実装  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でデータ コントラクト サロゲートを使用するには、いくつかの特別な手順に従う必要があります。  
+  
+### シリアル化と逆シリアル化にサロゲートを使用するには  
+ サロゲートを使用してデータのシリアル化と逆シリアル化を実行するには、<xref:System.Runtime.Serialization.DataContractSerializer> を使用します。<xref:System.Runtime.Serialization.DataContractSerializer> は、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> によって作成されます。サロゲートも指定する必要があります。  
+  
+##### シリアル化と逆シリアル化を実装するには  
+  
+1.  サービスの <xref:System.ServiceModel.ServiceHost> のインスタンスを作成します。この手順の詳細については、「[基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+2.  指定したサービス ホストの各 <xref:System.ServiceModel.Description.ServiceEndpoint> について、<xref:System.ServiceModel.Description.OperationDescription> を検索します。  
+  
+3.  操作の動作を検索して、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> のインスタンスが見つかるかどうかを確認します。  
+  
+4.  <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> が見つかった場合、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.DataContractSurrogate%2A> プロパティをサロゲートの新しいインスタンスに設定します。<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> が見つからなかった場合は、新しいインスタンスを作成し、新しい動作の <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.DataContractSurrogate%2A> メンバーをサロゲートの新しいインスタンスに設定します。  
+  
+5.  最後に、次の例に示すように、この新しい動作を現在の操作の動作に追加します。  
+  
+     [!code-csharp[C_IDataContractSurrogate#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#8)]  
+  
+### メタデータのインポートにサロゲートを使用するには  
+ WSDL や XSD などのメタデータをインポートしてクライアント側のコードを生成する場合、XSD スキーマからコードを生成するコンポーネント \(<xref:System.Runtime.Serialization.XsdDataContractImporter>\) にサロゲートを追加する必要があります。これを行うには、メタデータをインポートする際に使用する <xref:System.ServiceModel.Description.WsdlImporter> を直接変更します。  
+  
+##### メタデータのインポートに使用するサロゲートを実装するには  
+  
+1.  <xref:System.ServiceModel.Description.WsdlImporter> クラスを使用して、メタデータをインポートします。  
+  
+2.  <xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> メソッドを使用して、<xref:System.Runtime.Serialization.XsdDataContractImporter> が定義されているかどうかをチェックします。  
+  
+3.  <xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> メソッドが `false` を返した場合、新しい <xref:System.Runtime.Serialization.XsdDataContractImporter> を作成し、<xref:System.Runtime.Serialization.XsdDataContractImporter.Options%2A> プロパティを <xref:System.Runtime.Serialization.ImportOptions> クラスの新しいインスタンスに設定します。それ以外の場合は、<xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> メソッドの `out` パラメーターによって返されたインポーターを使用します。  
+  
+4.  <xref:System.Runtime.Serialization.XsdDataContractImporter> に <xref:System.Runtime.Serialization.ImportOptions> が定義されていない場合は、このプロパティを <xref:System.Runtime.Serialization.ImportOptions> クラスの新しいインスタンスとして設定します。  
+  
+5.  <xref:System.Runtime.Serialization.XsdDataContractImporter> の <xref:System.Runtime.Serialization.ImportOptions> の <xref:System.Runtime.Serialization.ImportOptions.DataContractSurrogate%2A> プロパティを、サロゲートの新しいインスタンスに設定します。  
+  
+6.  <xref:System.ServiceModel.Description.MetadataExporter> クラスから継承した <xref:System.ServiceModel.Description.WsdlImporter> の <xref:System.ServiceModel.Description.MetadataExporter.State%2A> プロパティによって返されたコレクションに、<xref:System.Runtime.Serialization.XsdDataContractImporter> を追加します。  
+  
+7.  <xref:System.ServiceModel.Description.WsdlImporter> の <xref:System.ServiceModel.Description.WsdlImporter.ImportAllContracts%2A> メソッドを使用して、スキーマ内のすべてのデータ コントラクトをインポートします。この最後の手順で、サロゲートを呼び出すことによって読み込まれたスキーマからコードが生成されます。  
+  
+     [!code-csharp[C_IDataContractSurrogate#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#9)]  
+  
+### メタデータのエクスポートにサロゲートを使用するには  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] からサービスのメタデータをエクスポートする場合、既定では WSDL と XSD スキーマを生成する必要があります。データ コントラクト型の XSD スキーマを生成するコンポーネント \(<xref:System.Runtime.Serialization.XsdDataContractExporter>\) に、サロゲートを追加する必要があります。これを行うには、<xref:System.ServiceModel.Description.IWsdlExportExtension> を実装する動作を使用して <xref:System.ServiceModel.Description.WsdlExporter> を変更するか、メタデータをエクスポートする際に使用する <xref:System.ServiceModel.Description.WsdlExporter> を直接変更します。  
+  
+##### メタデータのエクスポートにサロゲートを使用するには  
+  
+1.  新しい <xref:System.ServiceModel.Description.WsdlExporter> を作成するか、<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%2A> メソッドに渡された `wsdlExporter` パラメーターを使用します。  
+  
+2.  <xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> 関数を使用して、<xref:System.Runtime.Serialization.XsdDataContractExporter> が定義されているかどうかをチェックします。  
+  
+3.  <xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> が `false` を返した場合、<xref:System.ServiceModel.Description.WsdlExporter> から生成された XML スキーマを使用して新しい <xref:System.Runtime.Serialization.XsdDataContractExporter> を作成し、<xref:System.ServiceModel.Description.WsdlExporter> の <xref:System.ServiceModel.Description.MetadataExporter.State%2A> プロパティによって返されたコレクションに追加します。それ以外の場合は、<xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A> メソッドの `out` パラメーターによって返されたエクスポーターを使用します。  
+  
+4.  <xref:System.Runtime.Serialization.XsdDataContractExporter> に <xref:System.Runtime.Serialization.ExportOptions> が定義されていない場合は、<xref:System.Runtime.Serialization.XsdDataContractExporter.Options%2A> プロパティを <xref:System.Runtime.Serialization.ExportOptions> クラスの新しいインスタンスに設定します。  
+  
+5.  <xref:System.Runtime.Serialization.XsdDataContractExporter> の <xref:System.Runtime.Serialization.ExportOptions> の <xref:System.Runtime.Serialization.ExportOptions.DataContractSurrogate%2A> プロパティを、サロゲートの新しいインスタンスに設定します。メタデータをエクスポートするための以降の手順を変更する必要はありません。  
+  
+     [!code-csharp[C_IDataContractSurrogate#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_idatacontractsurrogate/cs/source.cs#10)]  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.IDataContractSurrogate>   
+ <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior>   
+ <xref:System.Runtime.Serialization.ImportOptions>   
+ <xref:System.Runtime.Serialization.ExportOptions>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/developing-channels.md b/docs/framework/wcf/extending/developing-channels.md
new file mode 100644
index 00000000000..af4cb0ec670
--- /dev/null
+++ b/docs/framework/wcf/extending/developing-channels.md
@@ -0,0 +1,44 @@
+---
+title: "チャネルの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0513af9f-a0c2-457b-9a50-5b6bfee48513
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# チャネルの開発
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーション レイヤーで使用できるプロトコル チャネルやトランスポート チャネルを開発するには、いくつかの手順が必要です。このトピックでは、これらの手順について説明し、詳細情報の参照先となる特定のトピックを示します。チャネル モデルと、このトピックで説明するそのさまざまな種類について理解するには、「[チャネル モデルの概要](../../../../docs/framework/wcf/extending/channel-model-overview.md)」を参照してください。トランスポート チャネルの完全なサンプルについては、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」を参照してください。  
+  
+## チャネル開発タスクの一覧  
+ ユーザー定義チャネルを作成する手順は、次のとおりです。すべてのチャネルで、次の手順が必要です。  
+  
+1.  <xref:System.ServiceModel.Channels.IChannelFactory> と <xref:System.ServiceModel.Channels.IChannelListener> で、チャネルのメッセージ交換パターン \(<xref:System.ServiceModel.Channels.IOutputChannel>、<xref:System.ServiceModel.Channels.IInputChannel>、<xref:System.ServiceModel.Channels.IDuplexChannel>、<xref:System.ServiceModel.Channels.IRequestChannel>、または <xref:System.ServiceModel.Channels.IReplyChannel>\) のうちのどれをサポートするか、また、選択したパターンでこれらのインターフェイスのセッションの多いバリエーションをサポートするかどうかを決定します。詳細については、「[メッセージ交換パターンの選択](../../../../docs/framework/wcf/extending/choosing-a-message-exchange-pattern.md)」を参照してください。  
+  
+2.  選択したメッセージ交換パターンをサポートするチャネル ファクトリおよびリスナー \(<xref:System.ServiceModel.Channels.IChannelFactory> および <xref:System.ServiceModel.Channels.IChannelListener>\) を作成します。ファクトリの開発の詳細については、「[クライアント : チャネル ファクトリとチャネル](../../../../docs/framework/wcf/extending/client-channel-factories-and-channels.md)」を参照してください。リスナーの開発の詳細については、「[サービス : チャネル リスナーとチャネル](../../../../docs/framework/wcf/extending/service-channel-listeners-and-channels.md)」を参照してください。  
+  
+3.  ネットワーク固有の例外が、<xref:System.ServiceModel.CommunicationException> の適切な派生クラスまたは <xref:System.TimeoutException?displayProperty=fullName> に標準化されていることを確認します。詳細については、「[例外とエラーの処理](../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md)」を参照してください。  
+  
+4.  アプリケーション レイヤーから使用できるようにするには、カスタム チャネルを追加する <xref:System.ServiceModel.Channels.BindingElement> をチャネル スタックに追加します。詳細については、「[BindingElement の作成](../../../../docs/framework/wcf/extending/creating-a-bindingelement.md)」を参照してください。  
+  
+ アプリケーション レイヤーでより完全なサポートを実現するには、次の追加手順が必要です。  
+  
+1.  バインド要素拡張セクションを追加して、新しいバインド要素を構成システムに公開します。詳細については、「[構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)」を参照してください。  
+  
+2.  他のエンドポイントに機能を伝達するメタデータ拡張を追加します。詳細については、「[構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)」を参照してください。  
+  
+3.  適切に定義されたプロファイルに従って、バインド要素のスタックを事前構成するバインディングを追加します。詳細については、「[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」を参照してください。  
+  
+4.  構成システムにバインディングを開示する、バインディング セクションおよびバインディング構成要素を追加します。詳細については、「[構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)」を参照してください。  
+  
+## 参照  
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md b/docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md
new file mode 100644
index 00000000000..7ad92b3e767
--- /dev/null
+++ b/docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md
@@ -0,0 +1,54 @@
+---
+title: "WCF 拡張に対するカスタム メタデータのエクスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 53c93882-f8ba-4192-965b-787b5e3f09c0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WCF 拡張に対するカスタム メタデータのエクスポート
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、メタデータのエクスポートは、サービス エンドポイントを説明したり、それらを並行して計画したりするプロセスで、クライアントがサービスの使用方法を理解する標準化表現です。カスタム メタデータは、システム指定のメタデータ エクスポーターでエクスポートできない XML 要素で構成されます。通常、これは、ユーザー定義動作のカスタム WSDL 要素とバインド要素、およびバインディングとコントラクトの機能と要件に関するポリシー アサーションを含みます。  
+  
+ ここでは、カスタム WSDL またはポリシー アサーションのエクスポートについて説明し、エクスポート プロセス自体には重点を置きません。メタデータがカスタムであるか、システムによって作成されたかに関係なく、メタデータをエクスポートおよびインポートする型の使用方法の詳細については、「[メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)」を参照してください。  
+  
+## 概要  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> を使用してメタデータを公開すると、システム指定の属性とバインディングを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がサポートできるすべてのコントラクトとバインディングについて、<xref:System.ServiceModel.Description.ServiceDescription?displayProperty=fullName> が検査され、XSD と WSDL \(ポリシー アサーションを含む\) が生成されます。ただし、カスタム動作属性やバインド要素を適切にエクスポートするには、あらかじめサポートしておく必要があります。  
+  
+ ここでは、次の内容について説明します。  
+  
+1.  WSDL を発行する前に WSDL の生成データを公開する <xref:System.ServiceModel.Description.IWsdlExportExtension?displayProperty=fullName> インターフェイスを実装して使用する方法。  
+  
+2.  WSDL データに含まれるポリシー アサーションをエクスポートする前にポリシー データを公開する <xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> インターフェイスを実装して使用する方法。  
+  
+ カスタム WSDL とポリシー アサーションのインポートの詳細については、「[WCF 拡張に対するカスタム メタデータのインポート](../../../../docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md)」を参照してください。  
+  
+## カスタム WSDL 要素のエクスポート  
+ 操作の動作、コントラクトの動作、エンドポイントの動作、またはバインド要素 <xref:System.ServiceModel.Description.IWsdlExportExtension> \(それぞれ <xref:System.ServiceModel.Description.IOperationBehavior>、<xref:System.ServiceModel.Description.IContractBehavior>、<xref:System.ServiceModel.Description.IEndpointBehavior>、<xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName>\) を実装し、エクスポートしようとしているサービスの説明に動作またはバインド要素を挿入します \(動作の挿入の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください\)。<xref:System.ServiceModel.Description.IWsdlExportExtension> はエンドポイントごとに呼び出され、コントラクトがエクスポートされていない場合は、各エンドポイントによって最初にコントラクトがエクスポートされます。必要に応じて、次のいずれかのエクスポート プロセスに参加できます。  
+  
+-   <xref:System.ServiceModel.Description.WsdlContractConversionContext> を使用して、エクスポートされたメタデータを <xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%2A> メソッドで変更する。  
+  
+-   <xref:System.ServiceModel.Description.WsdlEndpointConversionContext> を使用して、エンドポイントに対してエクスポートされたメタデータを <xref:System.ServiceModel.Description.IWsdlExportExtension.ExportEndpoint%2A> メソッドで変更する。  
+  
+ <xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%2A> メソッドは、エクスポートされる <xref:System.ServiceModel.Description.ContractDescription?displayProperty=fullName> インスタンスに含まれるすべての <xref:System.ServiceModel.Description.IWsdlExportExtension> 実装で呼び出されます。<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportEndpoint%2A> メソッドは、エクスポートされる <xref:System.ServiceModel.Description.ServiceEndpoint?displayProperty=fullName> インスタンスを持つすべての <xref:System.ServiceModel.Description.IWsdlExportExtension> 実装で呼び出されます。  
+  
+ 詳細については、「[方法 : カスタム WSDL をエクスポートする](../../../../docs/framework/wcf/extending/how-to-export-custom-wsdl.md)」および「[カスタム WSDL パブリケーション](../../../../docs/framework/wcf/samples/custom-wsdl-publication.md)」のサンプルを参照してください。  
+  
+## カスタム ポリシー アサーションのエクスポート  
+ <xref:System.ServiceModel.Channels.BindingElement> に <xref:System.ServiceModel.Description.IPolicyExportExtension> を実装し、バインド要素をバインディングに追加して、バインディングのサポートとコントラクトの機能に関するカスタム ポリシー アサーションを WSDL に書き込みます。バインディングに実装されたバインド要素をエクスポートすると、<xref:System.ServiceModel.Description.IPolicyExportExtension> が 1 回呼び出され、<xref:System.ServiceModel.Description.PolicyConversionContext> を <xref:System.ServiceModel.Description.IPolicyExportExtension.ExportPolicy%2A> メソッドに渡します。<xref:System.ServiceModel.Description.PolicyConversionContext> インスタンスに対してこのメソッドを使用すると、メッセージ、操作、またはエンドポイント サブジェクトで WSDL バインディングに結び付けられているポリシー アサーションを追加できます。  
+  
+ 詳細については、「[方法 : カスタム ポリシー アサーションをエクスポートする](../../../../docs/framework/wcf/extending/how-to-export-custom-policy-assertions.md)」を参照してください。  
+  
+## 参照  
+ [方法 : カスタム WSDL をエクスポートする](../../../../docs/framework/wcf/extending/how-to-export-custom-wsdl.md)   
+ [方法 : カスタム ポリシー アサーションをエクスポートする](../../../../docs/framework/wcf/extending/how-to-export-custom-policy-assertions.md)   
+ [WCF 拡張に対するカスタム メタデータのインポート](../../../../docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-bindings.md b/docs/framework/wcf/extending/extending-bindings.md
new file mode 100644
index 00000000000..b74a96b199e
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-bindings.md
@@ -0,0 +1,37 @@
+---
+title: "バインディングの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディングの拡張 [WCF]"
+ms.assetid: 5e40d306-b3c1-4429-80c4-fbb1d956856c
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# バインディングの拡張
+バインディングは、エンドポイントに接続するために必要なトランスポート、エンコード、およびプロトコルを指定します。バインディングの拡張およびカスタム バインディングは、アプリケーションの各種機能をサポートするために必要なカスタム通信機能を実装します。  
+  
+## このセクションの内容  
+  
+|トピック|説明|  
+|----------|--------|  
+|[バインディングとバインディング要素](../../../../docs/framework/wcf/extending/bindings-and-binding-elements.md)|バインディングとバインド要素について説明し、その使用方法と拡張方法を示します。|  
+|[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)|<xref:System.ServiceModel.Channels.CustomBinding> クラスを使用して、システム定義およびサードパーティのバインド要素を使用するカスタム バインディングを作成する方法について説明します。|  
+|[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)|他のユーザーが使用できるバインディングとバインド要素を作成する方法について説明します。|  
+  
+## 関連項目  
+  
+## 関連項目  
+ [BindingElement の作成](../../../../docs/framework/wcf/extending/creating-a-bindingelement.md)  
+  
+ [構成とメタデータのサポート](../../../../docs/framework/wcf/extending/configuration-and-metadata-support.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-clients.md b/docs/framework/wcf/extending/extending-clients.md
new file mode 100644
index 00000000000..7efba4f7bcb
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-clients.md
@@ -0,0 +1,128 @@
+---
+title: "クライアントの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プロキシ拡張 [WCF]"
+ms.assetid: 1328c61c-06e5-455f-9ebd-ceefb59d3867
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# クライアントの拡張
+呼び出し側のアプリケーションでは、サービス モデル レイヤーが、アプリケーション コードでのメソッド呼び出しを送信メッセージに変換し、それらを基になるチャネルにプッシュし、結果をアプリケーション コードで戻り値と出力パラメーターに変換して、変換結果を呼び出し側に返します。サービス モデル拡張は、クライアントやディスパッチャーの機能、カスタム動作、メッセージとパラメーターの途中受信、およびその他の拡張機能に関連する実行や通信の動作と機能を変更または実装します。  
+  
+ ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションで <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスと <xref:System.ServiceModel.Dispatcher.ClientOperation> クラスを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの既定の実行動作を変更したり、メッセージ、パラメーター、または戻り値を、チャネル レイヤーから送信または取得する前後に途中受信したり、変更したりする方法について説明します。サービス ランタイムの拡張の詳細については、「[ディスパッチャーの拡張](../../../../docs/framework/wcf/extending/extending-dispatchers.md)」を参照してください。カスタム オブジェクトを変更する動作、およびそれらをクライアント ランタイムに挿入する動作の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+## クライアント  
+ クライアントでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトまたはクライアント チャネルが、メソッド呼び出しを送信メッセージに、受信メッセージを操作結果に変換し、この操作結果を呼び出し側のアプリケーションに返します \(クライアントの種類の詳細については、「[WCF クライアント アーキテクチャ](../../../../docs/framework/wcf/feature-details/client-architecture.md)」を参照してください\)。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの種類には、このようなエンドポイント レベルと操作レベルの機能を処理するランタイム型があります。アプリケーションが操作を呼び出すと、<xref:System.ServiceModel.Dispatcher.ClientOperation> が送信オブジェクトをメッセージに変換し、インターセプターを処理し、送信呼び出しがターゲット コントラクトに適合することを確認してから、送信メッセージを <xref:System.ServiceModel.Dispatcher.ClientRuntime> に渡します。このクラスは、送信チャネル \(双方向サービスの場合には、さらに受信チャネル\) の作成と管理、追加の送信メッセージ処理 \(ヘッダーの変更など\)、メッセージ インターセプターの両方向での処理、および適切なクライアント側 <xref:System.ServiceModel.Dispatcher.DispatchRuntime> オブジェクトへの受信双方向呼び出しのルーティングを実行します。<xref:System.ServiceModel.Dispatcher.ClientOperation> と <xref:System.ServiceModel.Dispatcher.ClientRuntime> は、共にメッセージ \(エラーを含む\) がクライアントに返されるときに同様のサービスを提供します。  
+  
+ これら 2 つのランタイム クラスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアント オブジェクトとチャネルの処理をカスタマイズするための主要な拡張機能です。<xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスは、ユーザーが、コントラクト内のすべてのメッセージについてクライアント実行を途中受信して拡張できるようにします。<xref:System.ServiceModel.Dispatcher.ClientOperation> クラスは、ユーザーが、特定の操作内のすべてのメッセージについてクライアント実行を途中受信して拡張できるようにします。  
+  
+ プロパティの変更やカスタマイズの挿入は、コントラクト、エンドポイント、および操作の各動作を使用して行います。これらの各種動作を使用して、クライアント ランタイムのカスタマイズを実行する方法の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+## シナリオ  
+ クライアント システムを拡張する理由としては、次のようなさまざまなものがあります。  
+  
+-   カスタム メッセージの検証。特定のスキーマに対してメッセージが有効になるようにする必要が生じる場合があります。これは、<xref:System.ServiceModel.Dispatcher.IClientMessageInspector> インターフェイスを実装し、この実装を <xref:System.ServiceModel.Dispatcher.DispatchRuntime.MessageInspectors%2A> プロパティに割り当てることで可能になります。例については、「[方法 : クライアントのメッセージを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md)」および「[方法 : クライアントのメッセージを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md)」を参照してください。  
+  
+-   カスタム メッセージのログ記録。エンドポイントを通過するアプリケーション メッセージの一部を検査して記録する必要が生じる場合があります。これはメッセージ インターセプター インターフェイスで実行可能です。  
+  
+-   カスタム メッセージの変換。アプリケーション コードを変更するのではなく、ランタイムのメッセージに特定の変換を適用する必要が生じる場合があります \(バージョン管理の場合など\)。これもまた、メッセージ インターセプター インターフェイスで実行可能です。  
+  
+-   カスタム データ モデル。既定で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされているオブジェクト \(つまり、<xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName> オブジェクト、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName> オブジェクト、および <xref:System.ServiceModel.Channels.Message?displayProperty=fullName> オブジェクト\) 以外のデータ モデルやシリアル化モデルをユーザーが必要とする場合があります。これは、メッセージ フォーマッタ インターフェイスを実装することで対応できます。詳細については、<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter?displayProperty=fullName> および <xref:System.ServiceModel.Dispatcher.ClientOperation.Formatter%2A?displayProperty=fullName> プロパティのトピックを参照してください。  
+  
+-   カスタム パラメーターの検証。XML ではなく、型指定されたパラメーターが有効になるようにする必要が生じる場合があります。これは、パラメーター インスペクター インターフェイスを使用して実行できます。例については、「[方法 : パラメーターを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md)」または「[クライアント検証](../../../../docs/framework/wcf/samples/client-validation.md)」を参照してください。  
+  
+### ClientRuntime クラスの使用  
+ <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスは、メッセージを途中受信してクライアントの動作を拡張する拡張オブジェクトを追加できる拡張ポイントです。途中受信オブジェクトには、特定のコントラクト内のすべてのメッセージを処理する、特定の操作用のメッセージだけを処理する、カスタムのチャネル初期化を実行する、その他のカスタム クライアント アプリケーションの動作を実行する、などの機能があります。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.CallbackDispatchRuntime%2A> プロパティは、サービス側開始のコールバック クライアント用のディスパッチ ランタイム オブジェクトを返します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.OperationSelector%2A> プロパティは、カスタムの操作セレクター オブジェクトを受け取ります。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.ChannelInitializers%2A> プロパティを使用すると、クライアント チャネルを検査または変更できるチャネル初期化子を追加できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.Operations%2A> プロパティは、<xref:System.ServiceModel.Dispatcher.ClientOperation> オブジェクトのコレクションを取得します。このコレクションにカスタムのメッセージ インターセプターを追加すれば、その操作のメッセージに固有の機能を提供できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.ManualAddressing%2A> プロパティをアプリケーションで使用すると、自動アドレス指定ヘッダーをオフにしてアドレス指定を直接制御できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.Via%2A> プロパティは、トランスポート レベルでメッセージの送信先の値を設定して、メッセージの中継者やその他のシナリオをサポートします。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.MessageInspectors%2A> プロパティは、<xref:System.ServiceModel.Dispatcher.IClientMessageInspector> オブジェクトのコレクションを取得します。このコレクションには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 経由のすべてのメッセージに対応するカスタム メッセージ インターセプターを追加できます。  
+  
+ また、コントラクト情報を取得するその他のプロパティも多数用意されています。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.ContractName%2A>  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.ContractNamespace%2A>  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.ContractClientType%2A>  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが双方向 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの場合は、次のプロパティもコールバック [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント情報を取得します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.CallbackClientType%2A>  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientRuntime.CallbackDispatchRuntime%2A>  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアント実行を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント全体で拡張するには、<xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスに用意されているプロパティを調べ、目的の機能を作成するために、プロパティを変更するか、またはインターフェイスを実装してプロパティに追加するかを確認します。作成する特定の拡張を選択した後は、適切な <xref:System.ServiceModel.Dispatcher.ClientRuntime> プロパティにその拡張を挿入します。挿入するには、実行時に <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスにアクセスを提供するクライアント動作を実装します。  
+  
+ カスタム拡張オブジェクトは、操作動作 \(<xref:System.ServiceModel.Description.IOperationBehavior> を実装するオブジェクト\)、コントラクト動作 \(<xref:System.ServiceModel.Description.IContractBehavior> を実装するオブジェクト\)、またはエンドポイント動作 \(<xref:System.ServiceModel.Description.IEndpointBehavior> を実装するオブジェクト\) を使用して、コレクションに挿入できます。インストール動作オブジェクトは、プログラムで直接に、または宣言を介して \(カスタム属性を実装して\)、さらにアプリケーション構成ファイルを使用して動作を挿入できるようにするカスタム <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> オブジェクトを実装することにより、適切な動作コレクションに追加されます。詳細については、[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md) を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントでの途中受信の例については、「[方法 : クライアントのメッセージを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md)」を参照してください。  
+  
+### ClientOperation クラスの使用  
+ <xref:System.ServiceModel.Dispatcher.ClientOperation> クラスは、1 つのサービス操作のスコープ内だけに適用されるカスタムの拡張を実現するために、クライアント ランタイムに対して変更または挿入を行う場所です。\(コントラクト中のすべてのメッセージに対するクライアントのランタイム動作を変更するには、<xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスを使用します。\)  
+  
+ <xref:System.ServiceModel.Dispatcher.ClientRuntime.Operations%2A> プロパティを使用して、特定のサービス操作を表す <xref:System.ServiceModel.Dispatcher.ClientOperation> オブジェクトを検索します。次の各プロパティを使用すると、カスタム オブジェクトを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント システムに挿入できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.Formatter%2A> プロパティは、特定の操作用に <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> のカスタムの実装を挿入したり、現在のフォーマッタを変更するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.ParameterInspectors%2A> プロパティは、<xref:System.ServiceModel.Dispatcher.IParameterInspector> のカスタムの実装を挿入したり、現在の実装を変更するために使用します。  
+  
+ 次の各プロパティを使用すると、フォーマッタおよびカスタムのパラメーター インスペクターとやり取りしてシステムを変更できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.SerializeRequest%2A> プロパティは、送信メッセージのシリアル化を制御するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.DeserializeReply%2A> プロパティは、受信メッセージの逆シリアル化を制御するために使用します。  
+  
+-   要求メッセージの WS\-Addressing 操作を制御する場合に <xref:System.ServiceModel.Dispatcher.ClientOperation.Action%2A> プロパティを使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.BeginMethod%2A> プロパティと <xref:System.ServiceModel.Dispatcher.ClientOperation.EndMethod%2A> プロパティは、非同期操作に関連付けられる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント メソッドを指定するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.FaultContractInfos%2A> プロパティは、SOAP エラーの際に詳細な型として表示できる型を含むコレクションを取得するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.IsInitiating%2A> プロパティおよび <xref:System.ServiceModel.Dispatcher.ClientOperation.IsTerminating%2A> プロパティは、操作が呼び出されたとき、それぞれセッションを起動するか終了するかを制御するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.IsOneWay%2A> プロパティは、操作が一方向の操作であるかどうかを制御するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.Parent%2A> プロパティは、<xref:System.ServiceModel.Dispatcher.ClientRuntime> の親オブジェクトを取得するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.Name%2A> プロパティは、操作の名前を取得するために使用します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.ClientOperation.SyncMethod%2A> プロパティは、操作にマップされるメソッドを制御するために使用します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアント実行を 1 つのサービス操作でのみ拡張するには、<xref:System.ServiceModel.Dispatcher.ClientOperation> クラスに用意されているプロパティを調べ、目的の機能を作成するために、プロパティを変更するか、またはインターフェイスを実装してプロパティに追加するかを確認します。作成する特定の拡張を選択した後は、適切な <xref:System.ServiceModel.Dispatcher.ClientOperation> プロパティにその拡張を挿入します。挿入するには、実行時に <xref:System.ServiceModel.Dispatcher.ClientOperation> クラスにアクセスを提供するクライアント動作を実装します。これで、その動作の内部で、<xref:System.ServiceModel.Dispatcher.ClientRuntime> プロパティを要件に合わせて変更できるようになります。  
+  
+ 通常は、操作動作 \(<xref:System.ServiceModel.Description.IOperationBehavior> を実装するオブジェクト\) の実装で十分ですが、エンドポイント動作とコントラクト動作を使用して、特定の操作の <xref:System.ServiceModel.Description.OperationDescription> を検索し、これに動作を関連付けても同じことを実現できます。詳細については、[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md) を参照してください。  
+  
+ 構成からカスタム動作を使用するには、カスタム動作構成セクション ハンドラーを使用して動作をインストールします。また、カスタム属性を作成することによって動作をインストールすることもできます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントでの途中受信の例については、「[方法 : パラメーターを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Dispatcher.ClientRuntime>   
+ <xref:System.ServiceModel.Dispatcher.ClientOperation>   
+ [方法 : クライアントのメッセージを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md)   
+ [方法 : パラメーターを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-dispatchers.md b/docs/framework/wcf/extending/extending-dispatchers.md
new file mode 100644
index 00000000000..220bf1b9e6e
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-dispatchers.md
@@ -0,0 +1,142 @@
+---
+title: "ディスパッチャーの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ディスパッチャーの拡張 [WCF]"
+ms.assetid: d0ad15ac-fa12-4f27-80e8-7ac2271e5985
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# ディスパッチャーの拡張
+ディスパッチャーには、基になるチャネルから受信メッセージをプルし、そのメッセージをアプリケーション コードでのメソッド呼び出しに変換し、結果を呼び出し元に送信する役割があります。  ディスパッチャーの拡張を使用することで、この処理を変更できます。  メッセージやパラメーターの内容を検査または変更するメッセージ インスペクターまたはパラメーター インスペクターを実装できます。  また、メッセージが操作にルーティングされる方法を変更することも、他の機能を提供することもできます。  
+  
+ ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス アプリケーションで <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスと <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスを使用して、ディスパッチャーの既定の実行動作を変更したり、メッセージ、パラメーター、または戻り値を、チャネル レイヤーから送信または取得する前後に途中受信したり、変更したりする方法について説明します。  同等のクライアント ランタイム メッセージ処理の詳細については、「[クライアントの拡張](../../../../docs/framework/wcf/extending/extending-clients.md)」を参照してください。  さまざまなランタイム カスタマイズ オブジェクト間で共有される状態にアクセスするときに <xref:System.ServiceModel.IExtensibleObject%601> 型が果たす役割について理解するには、「[拡張可能オブジェクト](../../../../docs/framework/wcf/extending/extensible-objects.md)」を参照してください。  
+  
+## ディスパッチャー  
+ サービス モデル レイヤーは、開発者のプログラミング モデルと基になるメッセージ交換 \(一般的に、チャネル レイヤーと呼ばれます\) の間の変換を実行します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、チャネル ディスパッチャーとエンドポイント ディスパッチャー \(それぞれ <xref:System.ServiceModel.Dispatcher.ChannelDispatcher> と <xref:System.ServiceModel.Dispatcher.EndpointDispatcher>\) は、新しいチャネルを受け入れて、メッセージ、操作ディスパッチ、操作呼び出し、および応答処理を受信するためのサービス コンポーネントです。  ディスパッチャー オブジェクトは、受信者のオブジェクトですが、双方向サービスでのコールバック コントラクトの実装も、検査、変更、または拡張のためにディスパッチャー オブジェクトを公開します。  
+  
+ チャネル ディスパッチャー \(およびコンパニオン <xref:System.ServiceModel.Channels.IChannelListener>\) は、基になるチャネルからメッセージをプルし、そのメッセージをそれぞれのエンドポイント ディスパッチャーに渡します。  各エンドポイント ディスパッチャーには、メッセージを適切な <xref:System.ServiceModel.Dispatcher.DispatchOperation> にルーティングする <xref:System.ServiceModel.Dispatcher.DispatchRuntime> があります。これには、操作を実装するメソッドを呼び出す役割があります。  さまざまなオプションの拡張クラスおよび必須の拡張クラスが呼び出されます。  ここでは、この要素を組み合わせる方法、基本機能を拡張するためにプロパティを変更し、ユーザーのコードをプラグインする方法について説明します。  
+  
+ ディスパッチャーのプロパティと変更されたカスタマイズ オブジェクトは、サービス、エンドポイント、コントラクト、または操作の動作オブジェクトを使用して挿入します。  ここでは、動作を使用する方法については説明しません。  ディスパッチャーの変更を挿入するために使用する型の詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+ 次の図は、サービスを構成する項目の概念図を示しています。  
+  
+ ![ディスパッチ ランタイム アーキテクチャ](../../../../docs/framework/wcf/extending/media/wcfc-dispatchruntimearchc.gif "wcfc\_DispatchRuntimeArchc")  
+  
+### チャネル ディスパッチャー  
+ 特定の URI \(リッスン URI と呼ばれます\) にある <xref:System.ServiceModel.Channels.IChannelListener> をサービスのインスタンスと関連付けるために、<xref:System.ServiceModel.Dispatcher.ChannelDispatcher> オブジェクトが作成されます。  各 <xref:System.ServiceModel.ServiceHost> オブジェクトには、それぞれ 1 つのリスナーとリッスン URI にのみ関連付けられている <xref:System.ServiceModel.Dispatcher.ChannelDispatcher> オブジェクトを多数格納できます。  メッセージが到着すると、<xref:System.ServiceModel.Dispatcher.ChannelDispatcher> が、関連する各 <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> オブジェクトにエンドポイントがメッセージを受け入れ可能かどうかを問い合わせ、受け入れ可能ならメッセージを渡します。  
+  
+ <xref:System.ServiceModel.Dispatcher.ChannelDispatcher> オブジェクトに定義されているチャネル セッションの有効期間および動作を制御するすべてのプロパティは、検査および変更可能です。  これには、カスタムのチャネル初期化子、チャネル リスナー、ホスト、関連する <xref:System.ServiceModel.InstanceContext> などがあります。  
+  
+### エンドポイント ディスパッチャー  
+ メッセージの送信先アドレスが <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter%2A> プロパティに一致しており、メッセージ アクションが <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter%2A> プロパティに一致しているときは、<xref:System.ServiceModel.Dispatcher.EndpointDispatcher> オブジェクトが <xref:System.ServiceModel.Dispatcher.ChannelDispatcher> から送信されたメッセージの処理を担当します。  2 つの <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> オブジェクトが 1 つのメッセージを受信する可能性があるときは、<xref:System.ServiceModel.Dispatcher.EndpointDispatcher.FilterPriority%2A> プロパティの値によって、優先度の高いエンドポイントが決まります。  
+  
+ <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> を使用して、2 つの主要サービス モデル拡張ポイントである <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスと <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスを取得します。このクラスは、ディスパッチャーの処理をカスタマイズするときに使用できます。  <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスを使用すると、コントラクトのスコープで \(つまり、コントラクトにあるすべてのメッセージに対して\) ディスパッチャーを途中受信および拡張できます。  <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスを使用すると、操作のスコープで \(つまり、操作にあるすべてのメッセージに対して\) ディスパッチャーを途中受信および拡張できます。  
+  
+## シナリオ  
+ ディスパッチャーを拡張する理由としては、次のようなさまざまなものがあります。  
+  
+-   カスタム メッセージの検証。  特定のスキーマに対してメッセージが有効になるようにすることができます。  これは、メッセージ インターセプター インターフェイスを実装することで対応できます。  例については、「[メッセージ インスペクター](../../../../docs/framework/wcf/samples/message-inspectors.md)」を参照してください。  
+  
+-   カスタム メッセージのログ記録。  エンドポイントを通過するアプリケーション メッセージの一部を検査して記録することができます。  これはメッセージ インターセプター インターフェイスで実行可能です。  
+  
+-   カスタム メッセージの変換。  ランタイムのメッセージに特定の変換を適用できます \(バージョン管理の場合など\)。  これもまた、メッセージ インターセプター インターフェイスで実行可能です。  
+  
+-   カスタム データ モデル。  既定で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされているモデル \(つまり、<xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName>、<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>、および未加工メッセージ\) 以外のデータ シリアル化モデルを持つことができます。  これは、メッセージ フォーマッタ インターフェイスを実装することで対応できます。  例については、「[操作フォーマッタと操作セレクター](../../../../docs/framework/wcf/samples/operation-formatter-and-operation-selector.md)」を参照してください。  
+  
+-   カスタム パラメーターの検証。  XML ではなく、型指定されたパラメーターが有効になるようにすることができます。  これは、パラメーター インスペクター インターフェイスを使用して実行できます。  
+  
+-   カスタム操作ディスパッチ。  アクション以外の場所、たとえば、本文要素やカスタム メッセージ プロパティでディスパッチを実装できます。  これは、<xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> インターフェイスを使用して実行できます。  例については、「[操作フォーマッタと操作セレクター](../../../../docs/framework/wcf/samples/operation-formatter-and-operation-selector.md)」を参照してください。  
+  
+-   オブジェクト プール。  呼び出しごとに新しいインスタンスを割り当てるのではなく、インスタンスをプールできます。  これは、インスタンス プロバイダー インターフェイスを使用して実装できます。  例については、「[プール](../../../../docs/framework/wcf/samples/pooling.md)」を参照してください。  
+  
+-   インスタンス リース。  インスタンスの有効期間にリース パターンを実装できます。これは、.NET Framework リモートのパターンに似ています。  これは、インスタンス コンテキスト有効期間インターフェイスを使用して実行できます。  
+  
+-   カスタム エラー処理。  ローカル エラーの処理方法とエラーをクライアントに戻す方法を制御できます。  これは、<xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを使用して実装できます。  
+  
+-   カスタム承認動作。  コントラクトまたは操作のランタイム要素を拡張し、メッセージに存在するトークンに基づくセキュリティ チェックを追加することによって、カスタムのアクセス制御を実装できます。  これは、メッセージ インターセプター インターフェイスまたはパラメーター インターセプター インターフェイスを使用して実行できます。  例については、「[セキュリティ拡張](../../../../docs/framework/wcf/samples/security-extensibility.md)」を参照してください。  
+  
+    > [!CAUTION]
+    >  セキュリティ プロパティを変更すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションのセキュリティを損なう可能性があるので、注意してセキュリティ関連の変更を行い、配置する前に十分テストすることをお勧めします。  
+  
+-   カスタム WCF ランタイム バリデーター。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに対して企業レベルのポリシーを実施するために、サービス、コントラクト、およびバインディングを調査するカスタム バリデーターをインストールできます。  たとえば、「[方法 : 企業内のエンドポイントをロックダウンする](../../../../docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md)」を参照してください。  
+  
+### DispatchRuntime クラスの使用  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスを使用して、サービスまたは個別のエンドポイントの既定動作を変更するか、またはカスタム変更を実装したオブジェクトを次のサービス プロセス \(または双方向クライアントの場合、クライアント プロセス\) の一方または両方に挿入します。  
+  
+-   受信メッセージをオブジェクトに変換し、メソッド呼び出しとしてサービス オブジェクト上でそれらのオブジェクトを解放します。  
+  
+-   サービス操作呼び出しに対する応答から受信したオブジェクトを送信メッセージに変換します。  
+  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime> を使用すると、メッセージが認識されない場合でも、特定のコントラクト全体のすべてのメッセージについて、特定のチャネルまたはエンドポイント ディスパッチャーを途中受信および拡張できます。  コントラクト内のどの宣言にも一致しないメッセージが到着した場合、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.UnhandledDispatchOperation%2A> プロパティにより返された操作にディスパッチされます。  特定の操作についてすべてのメッセージを途中受信または拡張する方法については、<xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスを参照してください。  
+  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスによって公開されているディスパッチャー拡張性は次の 4 つの領域に大別できます。  
+  
+1.  <xref:System.ServiceModel.Dispatcher.DispatchRuntime> のプロパティおよび <xref:System.ServiceModel.Dispatcher.DispatchRuntime.ChannelDispatcher%2A> によって返される関連チャネル ディスパッチャーのプロパティを使用して、チャネル コンポーネントが、チャネル ディスパッチャーによるチャネルのアクセプトおよびクローズ方法をカスタマイズします。  この分類に属するプロパティとして、<xref:System.ServiceModel.Dispatcher.ChannelDispatcher.ChannelInitializers%2A> プロパティおよび <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InputSessionShutdownHandlers%2A> があります。  
+  
+2.  メッセージ コンポーネントを、処理されるメッセージごとにカスタマイズします。  この分類に属するプロパティとして、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.MessageInspectors%2A>、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.OperationSelector%2A>、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.Operations%2A>、<xref:System.ServiceModel.Dispatcher.ChannelDispatcher.ErrorHandlers%2A> があります。  
+  
+3.  インスタンス コンポーネントが、特定のサービス型のインスタンスの作成、有効期間、破棄をカスタマイズします。  サービス オブジェクトの有効期間の詳細については、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティを参照してください。  このカテゴリには、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceContextInitializers%2A> プロパティおよび <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> プロパティが含まれます。  
+  
+4.  セキュリティ関連コンポーネントは、次のプロパティを使用できます。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.SecurityAuditLogLocation%2A> は、監査イベントが出力される場所を示します。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.ImpersonateCallerForAllOperations%2A> は、サービスが受信メッセージによって提供される資格情報を使用して偽装を試みるかどうかを制御します。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.MessageAuthenticationAuditLevel%2A> は、<xref:System.ServiceModel.Dispatcher.DispatchRuntime.SecurityAuditLogLocation%2A> によって指定されたイベント ログに、メッセージ認証成功イベントを出力するかどうかを制御します。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.PrincipalPermissionMode%2A> は、<xref:System.Threading.Thread.CurrentPrincipal%2A> プロパティの設定方法を制御します。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.ServiceAuthorizationAuditLevel%2A> は、承認イベントの監査の実行方法を指定します。  
+  
+    -   <xref:System.ServiceModel.Dispatcher.DispatchRuntime.SuppressAuditFailure%2A> は、ログ記録処理中に発生した致命的でない例外を抑制するかどうかを指定します。  
+  
+ カスタムの拡張オブジェクトは通常、<xref:System.ServiceModel.Dispatcher.DispatchRuntime> プロパティに割り当てるか、サービス動作 \(<xref:System.ServiceModel.Description.IServiceBehavior> を実装するオブジェクト\)、コントラクト動作 \(<xref:System.ServiceModel.Description.IContractBehavior> を実装するオブジェクト\)、またはエンドポイント動作 \(<xref:System.ServiceModel.Description.IEndpointBehavior> を実装するオブジェクト\) によってコレクションに挿入します。  次に、インストール動作オブジェクトを、プログラムで直接、またはカスタムの <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> オブジェクトを実装して適切な動作コレクションに追加し、アプリケーション構成ファイルを使用して動作を挿入できるようにします。  
+  
+ 双方向クライアント \(双方向サービスによって指定されたコールバック コントラクトを実装したクライアント\) にも、<xref:System.ServiceModel.Dispatcher.ClientRuntime.CallbackDispatchRuntime%2A> プロパティを使用してアクセスできる <xref:System.ServiceModel.Dispatcher.DispatchRuntime> オブジェクトがあります。  
+  
+### DispatchOperation クラスの使用  
+ <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスは、1 つのサービス操作のスコープ内だけに適用されるカスタムの拡張を実現するために、ランタイムに対して変更または挿入を行う場所です   \(コントラクト中のすべてのメッセージに対するサービスのランタイム動作を変更するには、<xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスを使用します\)。  
+  
+ カスタムのサービス動作オブジェクトを使用して、<xref:System.ServiceModel.Dispatcher.DispatchOperation> の変更をインストールします。  
+  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime.Operations%2A> プロパティを使用して、特定のサービス操作を表す <xref:System.ServiceModel.Dispatcher.DispatchOperation> オブジェクトを検索します。  
+  
+ 次のプロパティは、操作レベルでランタイム実行を制御します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.Action%2A>、<xref:System.ServiceModel.Dispatcher.DispatchOperation.ReplyAction%2A>、<xref:System.ServiceModel.Dispatcher.DispatchOperation.FaultContractInfos%2A>、<xref:System.ServiceModel.Dispatcher.DispatchOperation.IsOneWay%2A>、<xref:System.ServiceModel.Dispatcher.DispatchOperation.IsTerminating%2A>、および <xref:System.ServiceModel.Dispatcher.DispatchOperation.Name%2A> の各プロパティは、操作の値をそれぞれ取得します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.TransactionAutoComplete%2A> と <xref:System.ServiceModel.Dispatcher.DispatchOperation.TransactionRequired%2A> は、トランザクション動作を指定します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.ReleaseInstanceBeforeCall%2A> プロパティと <xref:System.ServiceModel.Dispatcher.DispatchOperation.ReleaseInstanceAfterCall%2A> プロパティは、<xref:System.ServiceModel.InstanceContext> に応じてユーザー定義サービス オブジェクトの有効期間を制御します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.DeserializeRequest%2A>、<xref:System.ServiceModel.Dispatcher.DispatchOperation.SerializeReply%2A>、および <xref:System.ServiceModel.Dispatcher.DispatchOperation.Formatter%2A> の各プロパティでは、メッセージからオブジェクトへの変換およびオブジェクトからメッセージへの変換を明示的に制御できます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.Impersonation%2A> プロパティは、操作の偽装レベルを指定します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.CallContextInitializers%2A> プロパティは、操作のカスタム呼び出しコンテキスト拡張を挿入します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.AutoDisposeParameters%2A> プロパティは、パラメーター オブジェクトが破棄されるタイミングを制御します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.Invoker%2A> プロパティは、カスタムの呼び出しオブジェクトを挿入します。  
+  
+-   <xref:System.ServiceModel.Dispatcher.DispatchOperation.ParameterInspectors%2A> プロパティでは、パラメーターと戻り値の検査または変更に使用できるカスタム パラメーター インスペクターを挿入できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime>   
+ <xref:System.ServiceModel.Dispatcher.DispatchOperation>   
+ [方法 : サービスのメッセージを検査および変更する](../../../../docs/framework/wcf/extending/how-to-inspect-and-modify-messages-on-the-service.md)   
+ [方法 : パラメーターを検査または変更する](../../../../docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md)   
+ [方法 : 企業内のエンドポイントをロックダウンする](../../../../docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-encoders-and-serializers.md b/docs/framework/wcf/extending/extending-encoders-and-serializers.md
new file mode 100644
index 00000000000..365f7ee1109
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-encoders-and-serializers.md
@@ -0,0 +1,27 @@
+---
+title: "エンコーダーとシリアライザーの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97aec970-d73c-469c-9b93-8b86be701c44
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# エンコーダーとシリアライザーの拡張
+このセクションの各トピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] シリアル化システムの拡張方法について説明します。  
+  
+## このセクションの内容  
+ [データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md)  
+ データ コントラクト サロゲート クラスを使用して、シリアル化、逆シリアル化、スキーマのエクスポート、およびスキーマのインポートをカスタマイズする方法について説明します。  
+  
+ [カスタム メッセージ フォーマッタ](../../../../docs/framework/wcf/extending/custom-message-formatters.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージと CLR 型間のシリアル化および逆シリアル化を制御するために使用できるカスタム メッセージ フォーマッタについて説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md b/docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md
new file mode 100644
index 00000000000..798d1486529
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md
@@ -0,0 +1,92 @@
+---
+title: "ServiceHostFactory を使用したホストの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bcc5ae1b-21ce-4e0e-a184-17fad74a441e
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ServiceHostFactory を使用したホストの拡張
+[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アーキテクチャを拡張するためのインターフェイスとして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、ホスティング サービスを実装するための標準 API である <xref:System.ServiceModel.ServiceHost> があります。  ユーザーは、この <xref:System.ServiceModel.ServiceHost> の派生型として独自のホスト クラスを定義できます。通常は、<xref:System.ServiceModel.Description.ServiceDescription> を使用するために <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening> をオーバーライドして、これにより、サービスを開く前に、強制的に既定のエンドポイントを追加したり、動作を変更することができます。  
+  
+ 自己ホスト環境では、カスタムの <xref:System.ServiceModel.ServiceHost> を作成する必要はありません。ホストをインスタンス化し、インスタンス化の後で <xref:System.ServiceModel.ICommunicationObject.Open> を呼び出すコードを記述するので、  この 2 つのステップの間に任意の処理を記述できます。  たとえば、新しい <xref:System.ServiceModel.Description.IServiceBehavior> を次のように追加できます。  
+  
+```  
+public static void Main()  
+{  
+   ServiceHost host = new ServiceHost( typeof( MyService ) );  
+   host.Description.Add( new MyServiceBehavior() );  
+   host.Open();  
+  
+   ...  
+}  
+  
+```  
+  
+ この方法は再利用できません。  説明を操作するコードはホスト プログラム \(この場合は Main\(\) 関数\) に記述されているので、このロジックを別のコンテキストで使用するのは困難です。  このような強制コードを記述することなく、<xref:System.ServiceModel.Description.IServiceBehavior> を追加する方法もあります。  <xref:System.ServiceModel.ServiceBehaviorAttribute> から派生した属性をサービス実装型に組み込む方法や、カスタム動作の詳細を構成できるようにしておき、構成を使用して動的に組み込む方法が考えられます。  
+  
+ ただし、サンプル コードを少し修正して問題を解決することもできます。  1 つの方法として、ServiceBehavior を追加するコードを `Main()` 内に記述する代わりに、<xref:System.ServiceModel.ServiceHost> から派生した <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A> メソッドに記述することができます。  
+  
+```  
+public class DerivedHost : ServiceHost  
+{  
+   public DerivedHost( Type t, params Uri baseAddresses ) :  
+      base( t, baseAddresses ) {}  
+  
+   public override void OnOpening()  
+   {  
+  this.Description.Add( new MyServiceBehavior() );  
+   }  
+}  
+```  
+  
+ `Main()` 内には、次のように記述できます。  
+  
+```  
+public static void Main()  
+{  
+   ServiceHost host = new DerivedHost( typeof( MyService ) );  
+   host.Open();  
+  
+   ...  
+}  
+```  
+  
+ このようにカスタム ロジックをカプセル化、抽象化すると、さまざまなホスト アプリケーションで再利用できます。  
+  
+ カスタムの <xref:System.ServiceModel.ServiceHost> を Internet Information Services \(IIS\) や Windows Process Activation Service \(WAS\) で使用する方法は、それほど単純ではありません。  アプリケーションの代わりにホスティング環境が <xref:System.ServiceModel.ServiceHost> をインスタンス化するという点で、これらの環境は、自己ホスト環境と異なっています。  IIS および WAS ホスティング インフラストラクチャは、<xref:System.ServiceModel.ServiceHost> のカスタム派生物については何も認識しません。  
+  
+ <xref:System.ServiceModel.Activation.ServiceHostFactory> は、独自に定義した <xref:System.ServiceModel.ServiceHost> の派生クラスに、IIS または WAS からアクセスする手段として設計されました。  <xref:System.ServiceModel.ServiceHost> から派生したカスタム ホストは、動的に構成され、種類もさまざまであるため、ホスト環境でこれを直接インスタンス化することはありません。  代わりに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は "ファクトリ パターン" を使用して、ホスティング環境と、サービスの具体的な型との間に、間接レイヤーを提供します。  特に指定しなければ、<xref:System.ServiceModel.ServiceHost> のインスタンスを返す、<xref:System.ServiceModel.Activation.ServiceHostFactory> の既定の実装が使用されます。  ただし、派生ホストを返す独自のファクトリを用意し、そのファクトリの CLR 型名を @ServiceHost ディレクティブで指定することもできます。  
+  
+ 基本的なケースでは、独自のファクトリは容易に実装できます。  派生 <xref:System.ServiceModel.ServiceHost> を返す、カスタムの <xref:System.ServiceModel.Activation.ServiceHostFactory> の例を次に示します。  
+  
+```  
+public class DerivedFactory : ServiceHostFactory  
+{  
+   public override ServiceHost CreateServiceHost( Type t, Uri[] baseAddresses )  
+   {  
+      return new DerivedHost( t, baseAddresses )  
+   }  
+}  
+  
+```  
+  
+ 既定のファクトリの代わりにこのファクトリを使用するには、@ServiceHost ディレクティブに、次のように型名を記述します。  
+  
+```  
+<% @ServiceHost Factory=”DerivedFactory” Service=”MyService” %>  
+```  
+  
+ <xref:System.ServiceModel.Activation.ServiceHostFactory.CreateServiceHost%2A> から返す <xref:System.ServiceModel.ServiceHost> で行う処理について、技術的には制限はありませんが、ファクトリ実装はできるだけ単純にしておくことをお勧めします。  カスタム ロジックが多い場合は、ファクトリ内ではなくホスト側に記述するようにして、ファクトリは再利用できるようにしておきます。  
+  
+ ここで、ホスティング API にはもう 1 つのレイヤーがあることを知っておく必要があります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、<xref:System.ServiceModel.ServiceHostBase> および <xref:System.ServiceModel.Activation.ServiceHostFactoryBase> というクラスもあり、<xref:System.ServiceModel.ServiceHost> と <xref:System.ServiceModel.Activation.ServiceHostFactory> のそれぞれは、これらのクラスから派生しています。  これらは、メタデータ システムの大部分がカスタム コードに置き換わるような、高度なシナリオを想定して用意されています。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-security.md b/docs/framework/wcf/extending/extending-security.md
new file mode 100644
index 00000000000..72e9c3a53c8
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-security.md
@@ -0,0 +1,68 @@
+---
+title: "セキュリティの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], 拡張"
+ms.assetid: a015a040-9fdf-4147-9ea9-f83b570be1d4
+caps.latest.revision: 23
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 23
+---
+# セキュリティの拡張
+新しいクレームの種類やカスタム トークンに対応するために、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティ インフラストラクチャを拡張できます。このセクションの各トピックでは、この方法について説明します。  
+  
+## このセクションの内容  
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ システムのアーキテクチャについて解説します。  
+  
+ [カスタム資格情報と資格情報の検証](../../../../docs/framework/wcf/extending/custom-credential-and-credential-validation.md)  
+ カスタム資格情報の検証中に ID モデルを使用する方法について説明します。  
+  
+ [カスタム トークン](../../../../docs/framework/wcf/extending/custom-tokens.md)  
+ 通常、セキュリティ トークン サービス \(STS\) から発行されるトークンは SAML トークンです。ここでは、カスタムのトークンの種類を作成する方法について説明します。  
+  
+ [カスタム承認](../../../../docs/framework/wcf/extending/custom-authorization.md)  
+ カスタム承認を実装する方法について説明します。  
+  
+ [認証のためのサービスの ID のオーバーライド](../../../../docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md)  
+ 認証のためにサービスの ID をオーバーライドする方法について説明します。  
+  
+ [方法 : カスタム クライアント ID 検証機能を作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md)  
+ カスタム エンドポイント ID を検証する方法について説明します。  
+  
+ [方法 : 署名および暗号化に個別の X.509 証明書を使用する](../../../../docs/framework/wcf/extending/how-to-use-separate-x-509-certificates-for-signing-and-encryption.md)  
+ 通常、メッセージの署名および暗号化は 1 つの証明書を使用して行われます。ここでは、必要に応じて 2 つの証明書を使用する方法について説明します。  
+  
+ [方法 : X.509 証明書の秘密キーの暗号化プロバイダーを変更する](../../../../docs/framework/wcf/extending/change-cryptographic-provider-x509-certificate-private-key.md)  
+ X.509 証明書の秘密キーを提供するために使用する暗号化プロバイダーを変更する方法、およびそのプロバイダーを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] フレームワークに統合する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+ <xref:System.IdentityModel.Claims>  
+  
+ <xref:System.IdentityModel.Policy>  
+  
+ <xref:System.IdentityModel.Tokens>  
+  
+ <xref:System.IdentityModel.Selectors>  
+  
+## 関連項目  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)  
+  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md b/docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md
new file mode 100644
index 00000000000..e6b91e1be25
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md
@@ -0,0 +1,42 @@
+---
+title: "ServiceHost とサービス モデル レイヤーの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス モデルの拡張 [WCF]"
+ms.assetid: 954c138a-1cd0-45a0-8abe-e4d2b8ff5400
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ServiceHost とサービス モデル レイヤーの拡張
+サービス モデル レイヤーは、基になるチャネルから受信メッセージをプルし、そのメッセージをアプリケーション コードでのメソッド呼び出しに変換し、結果を呼び出し元に送信する役割があります。サービス モデル拡張は、クライアントやディスパッチャーの機能、カスタム動作、メッセージとパラメーターの途中受信、およびその他の拡張機能に関連する実行や通信の動作と機能を変更または実装します。  
+  
+## このセクションの内容  
+ [クライアントの拡張](../../../../docs/framework/wcf/extending/extending-clients.md)  
+ クライアント ランタイムを途中受信して変更できるインターフェイス、およびクライアント アプリケーションのカスタム拡張を挿入できるクラスについて説明します。たとえば、カスタム クライアント メッセージ ログやカスタム メッセージ シリアル化などを実行できます。  
+  
+ [ディスパッチャーの拡張](../../../../docs/framework/wcf/extending/extending-dispatchers.md)  
+ サービス ランタイムを途中受信して変更できるインターフェイス、およびサービス アプリケーションのカスタム拡張を挿入できるクラスについて説明します。たとえば、カスタム サービス ログ、サービス側でのメッセージ検証、カスタム ディスパッチなどを実行できます。  
+  
+ [拡張可能オブジェクト](../../../../docs/framework/wcf/extending/extensible-objects.md)  
+ 5 つの拡張可能オブジェクトと、<xref:System.ServiceModel.IExtensibleObject%601> パターンについて説明します。拡張可能オブジェクト パターンは、既存のランタイム クラスに新しい機能を付加して拡張したり、オブジェクトに新しい状態を追加するために使用します。このようなオブジェクトを実際に拡張することにより、処理の段階に応じて、共通の拡張可能オブジェクトに定義された共有の状態や機能にアクセスすることができます。  
+  
+ [動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムで設定を変更したり、拡張機能を挿入したりするには、動作を使用します。WCF には、調整機能、インスタンス化、およびサービスと操作に関するその他のさまざまな側面を制御するための、システムに実装済みの動作が用意されています。ここでは、独自のカスタム動作を作成し、プログラムおよび構成ファイルにより、作成したカスタム動作を使用できるようにする方法について説明します。  
+  
+ [ServiceHostFactory を使用したホストの拡張](../../../../docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md)  
+ <xref:System.ServiceModel.ServiceHostBase?displayProperty=fullName> および <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> を拡張し、<xref:System.ServiceModel.Activation.ServiceHostFactory?displayProperty=fullName> クラスを使用してホスト環境をカスタマイズする方法について説明します。  
+  
+## 関連項目  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-the-channel-layer.md b/docs/framework/wcf/extending/extending-the-channel-layer.md
new file mode 100644
index 00000000000..25cafa806d5
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-the-channel-layer.md
@@ -0,0 +1,35 @@
+---
+title: "チャネル レイヤーの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "チャネルの拡張 [WCF]"
+ms.assetid: 4238db74-2fb6-4dc8-a326-f58527230810
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# チャネル レイヤーの拡張
+チャネル レイヤーはクライアントとサービス間のメッセージの交換を担います。チャネル拡張では、新しいプロトコル機能 \(セキュリティなど\)、またはトランスポート機能 \(SOAP メッセージを送信する新しいネットワーク トランスポートの実装など\) を実装できます。  
+  
+## このセクションの内容  
+ [チャネル モデルの概要](../../../../docs/framework/wcf/extending/channel-model-overview.md)  
+ チャネルとその機能、サービス アプリケーションおよびクライアント アプリケーションとの連携について概要を示します。  
+  
+ [チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md)  
+ 各種のチャネル インフラストラクチャが果たす役割、ステート エンジンとステート ライフサイクルのしくみ、例外とエラーの処理方法、メタデータ サポートの実装方法、チャネルとメッセージ エンコーダーの連携について詳しく説明します。  
+  
+ [カスタム エンコーダー](../../../../docs/framework/wcf/extending/custom-encoders.md)  
+ メッセージ エンコーダーがチャネルで果たす役割、およびメッセージ エンコーダーの作成方法について説明します。  
+  
+ [カスタム ストリームのアップグレード](../../../../docs/framework/wcf/extending/custom-stream-upgrades.md)  
+ ストリーム指向のトランスポートによって提供されるストリームのアップグレード プロセスについて説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-the-metadata-system.md b/docs/framework/wcf/extending/extending-the-metadata-system.md
new file mode 100644
index 00000000000..79c45247b64
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-the-metadata-system.md
@@ -0,0 +1,32 @@
+---
+title: "メタデータ システムの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータの拡張 [WCF]"
+ms.assetid: 8c6b3b00-61b8-4589-8fa5-546cc33719bf
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# メタデータ システムの拡張
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のメタデータ システムは複数のクラスのグループおよびインターフェイスで、サービス ベースのアプリケーションを実装するために必要なメタデータを表します。クラスを変更または拡張するか、WSDL \(Web サービス記述言語\) の拡張子やカスタム WS\-PolicyAttachments アサーションなどのカスタム メタデータをエクスポート\/インポートするインターフェイスを実装して構成します。  
+  
+## このセクションの内容  
+ [WCF 拡張に対するカスタム メタデータのエクスポート](../../../../docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md)  
+ <xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> インターフェイスを実装および使用して、カスタム ポリシー アサーションを WSDL ドキュメントに埋め込む方法を説明します。  
+  
+ [WCF 拡張に対するカスタム メタデータのインポート](../../../../docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md)  
+ <xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName> インターフェイスを実装および使用して、WSDL ドキュメント内のカスタム ポリシー アサーションの読み取りや応答を行う方法を説明します。  
+  
+ [カスタム バインディングを介したメタデータの公開と取得](../../../../docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md)  
+ カスタム バインディングを介してメタデータを交換する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extending-wcf.md b/docs/framework/wcf/extending/extending-wcf.md
new file mode 100644
index 00000000000..6b595c66040
--- /dev/null
+++ b/docs/framework/wcf/extending/extending-wcf.md
@@ -0,0 +1,65 @@
+---
+title: "WCF の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "機能拡張 [WCF]"
+  - "WCF, 機能拡張"
+  - "Windows Communication Foundation, 機能拡張"
+ms.assetid: c145e2f6-f402-41f5-8b5a-eee03978737b
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# WCF の拡張
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、実行時コンポーネントを変更し、拡張することによって、サービス ベースのアプリケーションを正確に制御および拡張できます。  このセクションのトピックでは、その拡張アーキテクチャについて詳しく説明します。  基本的なプログラミングの詳細については、「[基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+## このセクションの内容  
+ [ServiceHost とサービス モデル レイヤーの拡張](../../../../docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md)  
+ サービス モデル レイヤーには、基になるチャネルから受信メッセージを取得し、そのメッセージをアプリケーション コードでのメソッド呼び出しに変換し、結果を呼び出し元に送信するという役割があります。  サービス モデル拡張は、ディスパッチャーの機能、カスタム動作、メッセージとパラメーターの途中受信、およびその他の拡張機能に関連する実行や通信の動作と機能を変更または実装します。  
+  
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)  
+ バインディングはエンドポイントに接続するために必要な通信の詳細設定を記述するオブジェクトです。  バインディングの拡張やカスタム バインディングは、アプリケーションの各種機能をサポートするために必要なカスタム通信機能を実装します。  
+  
+ [チャネル レイヤーの拡張](../../../../docs/framework/wcf/extending/extending-the-channel-layer.md)  
+ チャネル レイヤーは、サービス モデル レイヤーより下に位置し、クライアントとサービス間のメッセージの交換を担います。  チャネル拡張は、セキュリティなどの新しいプロトコル機能を実装できます。  また、SOAP メッセージを伝達する新しいネットワーク トランスポートの実装など、トランスポート機能も実装できます。  
+  
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティは、転送セキュリティ \(整合性、機密性、および認証\)、アクセス制御 \(承認\)、および監査で構成されます。  `IdentityModel` 名前空間にある各クラスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でアクセス制御のために使用されます。  セキュリティ アーキテクチャを理解することによって、カスタムのアクセス制御システムに対応したカスタムのクレーム タイプを作成できます。  
+  
+ [メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメタデータ システムは複数のクラスのグループおよびインターフェイスで、サービス ベースのアプリケーションを実装するために必要なメタデータを表します。  クラスを変更または拡張するか、WSDL \(Web サービス記述言語\) の拡張子やカスタム WS\-PolicyAttachments アサーションなどのカスタム メタデータをエクスポート\/インポートするインターフェイスを実装して構成します。  
+  
+ [エンコーダーとシリアライザーの拡張](../../../../docs/framework/wcf/extending/extending-encoders-and-serializers.md)  
+ エンコーダーとシリアライザーは、データをある形式から別の形式に変換します。  このセクションのトピックでは、提供されたクラスを特別な要件に合わせて拡張する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Description>  
+  
+ <xref:System.IdentityModel.Claims>  
+  
+ <xref:System.IdentityModel.Policy>  
+  
+ <xref:System.IdentityModel.Selectors>  
+  
+ <xref:System.IdentityModel.Tokens>  
+  
+## 関連項目  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+ [WCF 機能の詳細](../../../../docs/framework/wcf/feature-details/index.md)  
+  
+ [ガイドラインとベスト プラクティス](../../../../docs/framework/wcf/guidelines-and-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/extensible-objects.md b/docs/framework/wcf/extending/extensible-objects.md
new file mode 100644
index 00000000000..32c22c0d938
--- /dev/null
+++ b/docs/framework/wcf/extending/extensible-objects.md
@@ -0,0 +1,76 @@
+---
+title: "拡張可能オブジェクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "拡張可能オブジェクト [WCF]"
+ms.assetid: bc88cefc-31fb-428e-9447-6d20a7d452af
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 拡張可能オブジェクト
+拡張可能オブジェクト パターンは、既存のランタイム クラスに新しい機能を付加して拡張したり、オブジェクトに新しい状態を追加するために使用します。  このようなオブジェクトを実際に拡張することにより、処理の段階に応じて、共通の拡張可能オブジェクトに定義された共有の状態や機能にアクセスすることができます。  
+  
+## IExtensibleObject\<T\> パターン  
+ 拡張可能オブジェクト パターンには、<xref:System.ServiceModel.IExtensibleObject%601>、<xref:System.ServiceModel.IExtension%601>、および <xref:System.ServiceModel.IExtensionCollection%601> の 3 つのインターフェイスがあります。  
+  
+ <xref:System.ServiceModel.IExtensibleObject%601> インターフェイスを実装することにより、<xref:System.ServiceModel.IExtension%601> オブジェクトの機能をカスタマイズできます。  
+  
+ 拡張可能オブジェクトを使用すると、<xref:System.ServiceModel.IExtension%601> オブジェクトの動的な集約が可能になります。  <xref:System.ServiceModel.IExtension%601> オブジェクトには、次のインターフェイスが実装されています。  
+  
+```  
+public interface IExtension<T>  
+where T : IExtensibleObject<T>  
+{  
+    void Attach(T owner);  
+    void Detach(T owner);  
+}  
+```  
+  
+ この型制約は、<xref:System.ServiceModel.IExtensibleObject%601> であるクラスに対してしか拡張を定義できないことを保証します。  <xref:System.ServiceModel.IExtension%601.Attach%2A> と <xref:System.ServiceModel.IExtension%601.Detach%2A> は、集約や集約解除に関する通知を提供します。  
+  
+ 所有者が追加や削除を行う際の制限を組み込むことも可能です。  たとえば、削除は全面的に禁止する、所有者や拡張がある状態であれば拡張の追加や削除を禁止する、同時に複数の所有者に追加することを禁止する、1 つ削除したら 1 つだけ追加を許可する、などの制約を指定することができます。  
+  
+ <xref:System.ServiceModel.IExtension%601> を実装しても、他の標準のマネージ インターフェイスとやりとりできるとは限りません。  特に、所有者オブジェクトの <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> メソッドは、自分自身の拡張を解除しないのが普通です。  
+  
+ 拡張がコレクションに追加される場合には、直前に <xref:System.ServiceModel.IExtension%601.Attach%2A> が呼び出されます。また、コレクションから拡張を削除すると、その直後に <xref:System.ServiceModel.IExtension%601.Detach%2A> が呼び出されます。したがって、同期が適切であれば、拡張が有効なのは <xref:System.ServiceModel.IExtension%601.Attach%2A> から <xref:System.ServiceModel.IExtension%601.Detach%2A> の間ということになります。  
+  
+ <xref:System.ServiceModel.IExtensionCollection%601.FindAll%2A> や <xref:System.ServiceModel.IExtensionCollection%601.Find%2A> に渡すオブジェクトは、<xref:System.ServiceModel.IExtension%601> である必要はなく、任意のオブジェクトを渡すことができますが、返される拡張は <xref:System.ServiceModel.IExtension%601> です。  
+  
+ コレクション内のどの拡張も <xref:System.ServiceModel.IExtension%601> でなければ、<xref:System.ServiceModel.IExtensionCollection%601.Find%2A> は null を返し、<xref:System.ServiceModel.IExtensionCollection%601.FindAll%2A> は空のコレクションを返します。<xref:System.ServiceModel.IExtension%601> を実装した拡張が複数あれば、<xref:System.ServiceModel.IExtensionCollection%601.Find%2A> はそのうちのいずれか 1 つを返します。  <xref:System.ServiceModel.IExtensionCollection%601.FindAll%2A> から返される値はスナップショットです。  
+  
+ 主な使い方として、次の 2 つのシナリオが考えられます。  1 つ目のシナリオでは、型ベースのディクショナリとして <xref:System.ServiceModel.IExtensibleObject%601.Extensions%2A> プロパティを使用し、オブジェクトに状態を追加します。これは、別のコンポーネントが型に基づいて検索できます。  
+  
+ 2 つ目のシナリオでは、<xref:System.ServiceModel.IExtension%601.Attach%2A> プロパティおよび <xref:System.ServiceModel.IExtension%601.Detach%2A> プロパティを使用し、イベントへの登録や、状態の遷移の監視など、カスタムの動作にオブジェクトを参加させます。  
+  
+ <xref:System.ServiceModel.IExtensionCollection%601> インターフェイスは、型を基準にした <xref:System.ServiceModel.IExtension%601> の取得を可能にする <xref:System.ServiceModel.IExtension%601> オブジェクトのコレクションです。  <xref:System.ServiceModel.IExtensionCollection%601.Find%2A?displayProperty=fullName> は、指定された型の <xref:System.ServiceModel.IExtension%601> オブジェクトのうち、最も新しく追加されたものを返します。  
+  
+### Windows Communication Foundation の拡張可能オブジェクト  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には次の 4 つの拡張可能オブジェクトが組み込まれています。  
+  
+-   <xref:System.ServiceModel.ServiceHostBase> : サービス ホストの基本クラスです。  <xref:System.ServiceModel.ServiceHostBase> 自身の動作を拡張するほか、各サービスの状態を保存しておくための拡張が可能です。  
+  
+-   <xref:System.ServiceModel.InstanceContext> : サービスのランタイムを使用して、サービスの型のインスタンスと接続するためのクラスです。  このクラスは、インスタンスに関する情報のほか、<xref:System.ServiceModel.InstanceContext> に含まれる <xref:System.ServiceModel.ServiceHostBase> への参照を保持します。  <xref:System.ServiceModel.InstanceContext> 自身の動作を拡張するほか、各サービスの状態を保存しておくための拡張が可能です。  
+  
+-   <xref:System.ServiceModel.OperationContext> : 操作ごとにランタイムが収集した操作情報を表すクラスです。  具体的には、受け取ったメッセージのヘッダーやプロパティ、受け取ったセキュリティ ID などの情報があります。  <xref:System.ServiceModel.OperationContext> 自身の動作を拡張するほか、各操作の状態を保存しておくための拡張が可能です。  
+  
+-   <xref:System.ServiceModel.IContextChannel> : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムで構築されたチャネルやプロキシの状態を個々に検査できるようにするためのインターフェイスです。  <xref:System.ServiceModel.IClientChannel> 自身の動作を拡張するほか、各チャネルの状態を保存しておくための拡張が可能です。  
+  
+ <xref:System.ServiceModel.InstanceContext> オブジェクトの状態を追跡するという、簡単な拡張の使い方を例示したコードを次に示します。  
+  
+ [!code-csharp[IInstanceContextInitializer#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/iinstancecontextinitializer/cs/initializer.cs#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.IExtensibleObject%601>   
+ <xref:System.ServiceModel.IExtension%601>   
+ <xref:System.ServiceModel.IExtensionCollection%601>
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/handling-exceptions-and-faults.md b/docs/framework/wcf/extending/handling-exceptions-and-faults.md
new file mode 100644
index 00000000000..cb6af4c8e16
--- /dev/null
+++ b/docs/framework/wcf/extending/handling-exceptions-and-faults.md
@@ -0,0 +1,413 @@
+---
+title: "例外とエラーの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a64d01c6-f221-4f58-93e5-da4e87a5682e
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 例外とエラーの処理
+例外は、サービスまたはクライアント実装内でエラーをローカルに伝達するために使用されます。一方、エラーは、サーバーからクライアントまたはクライアントからサーバーのように、サービス境界を越えてエラーを伝達するために使用されます。このようなエラーに加え、多くの場合、トランスポート チャネルはトランスポート固有の機構を使用して、トランスポート レベルのエラーを伝達します。たとえば、HTTP トランスポートは、404 などのステータス コードを使用して、存在しないエンドポイントの URL \(エラーを返信するエンドポイントが存在しないこと\) を伝達します。このドキュメントは、カスタム チャネル作成者にガイダンスを示す 3 つのセクションで構成されています。最初のセクションでは、例外を定義しスローする状況と方法に関するガイダンスを示します。2 番目のセクションでは、エラーの生成と使用に関するガイダンスを示します。3 番目のセクションでは、実行中のアプリケーションのトラブルシューティングを行う際に、カスタム チャネルのユーザーにとって役立つトレース情報を提供する方法について説明します。  
+  
+## 例外  
+ 例外をスローする場合、2 つの点に留意します。まず、例外は、ユーザーがその例外に適切に対処できる正しいコードを作成できるような種類であることが必要です。もう 1 つは、例外では、問題点、エラーの影響、およびエラーの修正方法をユーザーが理解できるだけの情報を提供する必要があります。以下のセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] チャネルの例外の種類とメッセージに関するガイダンスを示します。また、「Design Guidelines for Exceptions」に記載された .NET の例外に関する一般的なガイダンスも示します。  
+  
+### 例外の種類  
+ チャネルがスローするすべての例外は、<xref:System.TimeoutException?displayProperty=fullName>、<xref:System.ServiceModel.CommunicationException?displayProperty=fullName>、または <xref:System.ServiceModel.CommunicationException> から派生した種類のいずれかである必要があります \(<xref:System.ObjectDisposedException> のような例外をスローすることもできますが、これは呼び出し元のコードがチャネルを誤用したことを示す場合だけです。チャネルが正しく使用されている場合は、指定の例外だけをスローする必要があります\)。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、<xref:System.ServiceModel.CommunicationException> から派生し、チャネルで使用するように設計された 7 種類の例外が用意されています。<xref:System.ServiceModel.CommunicationException> から派生した例外には、システムのその他の部分で使用するように設計されているものもあります。これらの例外の種類を以下に示します。  
+  
+|例外の種類|説明|内部例外の内容|回復方法|  
+|-----------|--------|-------------|----------|  
+|<xref:System.ServiceModel.AddressAlreadyInUseException>|リッスン用に指定されたエンドポイント アドレスは既に使用されています。|エラーの詳細情報が得られるようであれば、この例外の原因となったトランスポート エラーについての情報を提供します。例 : <xref:System.IO.PipeException>、<xref:System.Net.HttpListenerException> または <xref:System.Net.Sockets.SocketException>|別のアドレスで実行してください。|  
+|<xref:System.ServiceModel.AddressAccessDeniedException>|このプロセスは、リッスン用に指定されたエンドポイント アドレスへのアクセスを許可されていません。|エラーの詳細情報が得られるようであれば、この例外の原因となったトランスポート エラーについての情報を提供します。例 : <xref:System.IO.PipeException> または <xref:System.Net.HttpListenerException>|別の資格情報を使用して試行します。|  
+|<xref:System.ServiceModel.CommunicationObjectFaultedException>|使用している <xref:System.ServiceModel.ICommunicationObject> が Faulted 状態になっています \(詳細については、「[状態変更の理解](../../../../docs/framework/wcf/extending/understanding-state-changes.md)」を参照してください\)。複数の呼び出しが保留になっているオブジェクトが Faulted 状態に遷移した場合、エラーに関連する例外をスローする呼び出しは 1 つだけであり、それ以外の呼び出しは <xref:System.ServiceModel.CommunicationObjectFaultedException> をスローします。通常、この例外がスローされるのは、アプリケーションが何らかの例外を認識しておらず、おそらく最初の例外をキャッチしたスレッド以外のスレッドで、既に Faulted 状態のオブジェクトを使用しようとしたためです。|詳細情報を使用できる場合は、内部例外についての詳細を示します。|新規オブジェクトを作成します。<xref:System.ServiceModel.ICommunicationObject> にエラーが発生した第一の原因によっては、回復するために他の作業が必要になることがあります。|  
+|<xref:System.ServiceModel.CommunicationObjectAbortedException>|使用している <xref:System.ServiceModel.ICommunicationObject> が Aborted 状態になっています \(詳細については、「[状態変更の理解](../../../../docs/framework/wcf/extending/understanding-state-changes.md)」を参照してください\)。<xref:System.ServiceModel.CommunicationObjectFaultedException> と同様に、この例外は、アプリケーションがおそらく別のスレッドからオブジェクトに対して <xref:System.ServiceModel.ICommunicationObject.Abort%2A> を呼び出したときに、オブジェクトが既に Aborted 状態であるため、使用できなくなっていることを示しています。|詳細情報を使用できる場合は、内部例外についての詳細を示します。|新規オブジェクトを作成します。<xref:System.ServiceModel.ICommunicationObject> が中止された第一の原因によっては、回復するために他の作業が必要になることがあります。|  
+|<xref:System.ServiceModel.EndpointNotFoundException>|対象のリモート エンドポイントがリッスンしていません。これは、エンドポイント アドレスの一部に誤りがある、エンドポイント アドレスの一部を解決できない、またはエンドポイントがダウンしていることが原因として考えられます \(DNS エラー、キュー マネージャーを使用できない、サービスが実行されていないなど\)。|この内部例外では、一般に、基になるトランスポートの詳細が示されます。|別のアドレスで実行してください。また、サービスがダウンしている場合は、送信元がしばらく待機し、再試行することもできます。|  
+|<xref:System.ServiceModel.ProtocolException>|エンドポイントのポリシーで示されている通信プロトコルがエンドポイント間で一致していません \(フレーム コンテンツの種類の不一致や、最大メッセージ サイズの超過など\)。|詳細情報を使用できる場合は、特定のプロトコル エラーの詳細を示します。たとえば、MaxReceivedMessageSize を超えていることがエラーの原因である場合、<xref:System.ServiceModel.QuotaExceededException> が内部例外です。|回復 : 受信したプロトコル設定が送信側と一致していることを確認します。この方法の 1 つとして、サービス エンドポイントのメタデータ \(ポリシー\) を再度インポートし、生成されたバインディングを使用してチャネルを再作成します。|  
+|<xref:System.ServiceModel.ServerTooBusyException>|リモート エンドポイントはリッスンしていますが、メッセージを処理する準備ができていません。|詳細情報を使用できる場合は、内部例外で SOAP エラーまたはトランスポート レベルのエラーの詳細を示します。|回復 : しばらく待機し、後で操作を再試行します。|  
+|<xref:System.TimeoutException>|タイムアウト期間内に操作を完了できませんでした。|タイムアウトの詳細を示します。|しばらく待機し、後で操作を再試行します。|  
+  
+ 新しい例外の種類を定義するのは、その種類が既存の例外の種類のいずれとも異なる回復方法に対応する場合だけです。新しい例外の種類を定義する場合は、<xref:System.ServiceModel.CommunicationException> または派生クラスのいずれかから派生する必要があります。  
+  
+### 例外メッセージ  
+ 例外メッセージは、プログラムではなくユーザーを対象としています。したがって、ユーザーが問題を理解し、解決する上で役立つ十分な情報を提供する必要があります。優れた例外メッセージに不可欠な 3 つの構成要素を以下に示します。  
+  
+ 問題の内容。ユーザーの経験に関連する用語を使用して、問題を明確に説明します。たとえば、"無効な構成セクション" という例外メッセージは適切とはいえません。このようなメッセージでは、ユーザーは、どの構成セクションに誤りがあり、それがなぜ誤りなのか疑問を抱いたままになります。より適切なメッセージとしては、"無効な構成セクション \<customBinding\>" が考えられます。これをさらに改善し、"myBinding というバインディングには myTransport というトランスポートが既に含まれているため、このバインディングに myTransport というトランスポートを追加することはできません" というメッセージにします。これは、アプリケーションの構成ファイル内でユーザーが容易に特定できる用語と名前を使用した、非常に明確なメッセージです。ただし、まだ重要な要素がいくつか欠けています。  
+  
+ エラーの重大度。メッセージがエラーの意味を明確に示していない場合、ユーザーはそれが致命的なエラーかどうか、または無視できるのかどうか疑問を抱くと考えられます。一般に、メッセージではエラーの意味や重大度を示す必要があります。前述の例のメッセージは、"構成エラーが原因で ServiceHost を開くことができませんでした: myBinding というバインディングには myTransport というトランスポートが既に含まれているため、このバインディングに myTransport というトランスポートを追加することはできません" というメッセージに改善できます。  
+  
+ ユーザーが問題を修正する方法。メッセージの最も重要な要素は、ユーザーによる問題の修正を支援することにあります。メッセージには、問題を改善するためのチェックや修正の内容に関する何らかのガイダンスやヒントを含める必要があります。たとえば、"構成エラーが原因で ServiceHost を開くことができませんでした: myBinding というバインディングには myTransport というトランスポートが既に含まれているため、このバインディングに myTransport というトランスポートを追加することはできません。バインディングに含まれているトランスポートが 1 つだけであることを確認してください" というメッセージにします。  
+  
+## エラーの伝達  
+ SOAP 1.1 および SOAP 1.2 では、エラーの具体的な構造が定義されています。この 2 つの仕様にはいくつかの違いがありますが、通常、Message 型と MessageFault 型を使用して、エラーを作成および使用します。  
+  
+ ![例外とエラーの処理](../../../../docs/framework/wcf/extending/media/wcfc-soap1-1andsoap1-2faultcomparisonc.gif "wcfc\_SOAP1\-1AndSOAP1\-2FaultComparisonc")  
+SOAP 1.2 エラー \(左\) と SOAP 1.1 エラー \(右\)。Fault 要素が名前空間で修飾されているのは SOAP 1.1 のみ。  
+  
+ SOAP では、エラー メッセージとは、`<env:Body>` の子要素としてエラー要素 \(`<env:Fault>` という名前の要素\) だけを含むメッセージと定義されています。図 1 に示すように、エラー要素の内容は SOAP 1.1 と SOAP 1.2 で若干異なります。ただし、次のように、<xref:System.ServiceModel.Channels.MessageFault?displayProperty=fullName> クラスでは、これらの違いを 1 つのオブジェクト モデルに正規化します。  
+  
+```  
+public abstract class MessageFault  
+{  
+    protected MessageFault();  
+  
+    public virtual string Actor { get; }  
+    public virtual string Node { get; }  
+    public static string DefaultAction { get; }  
+    public abstract FaultCode Code { get; }  
+    public abstract bool HasDetail { get; }  
+    public abstract FaultReason Reason { get; }  
+  
+    public T GetDetail<T>();  
+    public T GetDetail<T>( XmlObjectSerializer serializer);  
+    public System.Xml.XmlDictionaryReader GetReaderAtDetailContents();  
+  
+    // other methods omitted  
+}  
+```  
+  
+ `Code` プロパティは、`env:Code` \(または SOAP 1.1 の `faultCode`\) に対応し、エラーの種類を識別します。SOAP 1.2 では、`faultCode` の 5 つの許容値 \(Sender や Receiver など\) が定義されており、サブコード値を格納できる `Subcode` 要素も定義されています \(使用できるエラー コードとその意味の一覧については、[SOAP 1.2 の仕様](http://go.microsoft.com/fwlink/?LinkId=95176)を参照してください\)。SOAP 1.1 の機構は若干異なります。SOAP 1.1 では、`faultCode` の 4 つの値 \(Client や Server など\) が定義されています。これらの値は、まったく新しい値を定義するか、ドット表記を使用して Client.Authentication のようなより具体的な `faultCodes` を作成することによって拡張できます。  
+  
+ MessageFault を使用してエラーをプログラミングする場合、FaultCode.Name と FaultCode.Namespace は、SOAP 1.2 の `env:Code` または SOAP 1.1 の `faultCode` の名前と名前空間に割り当てられます。FaultCode.SubCode は、SOAP 1.2 では `env:Subcode` に割り当てられ、SOAP 1.1 では null になります。  
+  
+ エラーをプログラムによって区別する場合は、新しいエラー サブコード \(SOAP 1.1 を使用する場合は新しいエラー コード\) を作成します。これは、新しい例外の種類を作成することに似ています。SOAP 1.1 エラー コードではドット表記を使用しないようにすることをお勧めします \([WS\-I Basic Profile](http://go.microsoft.com/fwlink/?LinkId=95177) でも、エラー コードのドット表記の使用は推奨されていません\)。  
+  
+```  
+public class FaultCode  
+{  
+    public FaultCode(string name);  
+    public FaultCode(string name, FaultCode subCode);  
+    public FaultCode(string name, string ns);  
+    public FaultCode(string name, string ns, FaultCode subCode);  
+  
+    public bool IsPredefinedFault { get; }  
+    public bool IsReceiverFault { get; }  
+    public bool IsSenderFault { get; }  
+    public string Name { get; }  
+    public string Namespace { get; }  
+    public FaultCode SubCode { get; }  
+  
+//  methods omitted  
+  
+}  
+```  
+  
+ `Reason` プロパティは、`env:Reason` \(または SOAP 1.1 の `faultString`\) に対応しています。これは、例外のメッセージと同様に、ユーザーが判読できるエラー状態の記述です。`FaultReason` クラス \(および SOAP の `env:Reason/faultString`\) には、グローバリゼーションのために、複数の変換を使用するためのサポートが組み込まれています。  
+  
+```  
+public class FaultReason  
+{  
+    public FaultReason(FaultReasonText translation);  
+    public FaultReason(IEnumerable<FaultReasonText> translations);  
+    public FaultReason(string text);  
+  
+    public SynchronizedReadOnlyCollection<FaultReasonText> Translations   
+    {   
+       get;   
+    }  
+  
+ }  
+```  
+  
+ エラーの詳しい内容は、`GetDetail`\<T\> や `GetReaderAtDetailContents`\(\) などのさまざまなメソッドを使用して、MessageFault で公開されます。エラーの詳細は、エラーに関する追加情報を伝達するための不透明な要素です。これは、エラーと共に伝達する任意の構造化された詳細がある場合に役立ちます。  
+  
+### エラーの生成  
+ このセクションでは、チャネルまたはチャネルによって作成されたメッセージ プロパティで検出されるエラー状態に応じてエラーを生成するプロセスについて説明します。一般的な例として、無効なデータが含まれた要求メッセージに対するエラーの送信が挙げられます。  
+  
+ エラーの生成時には、カスタム チャネルからエラーを直接送信するのではなく、例外をスローするようにし、その例外をエラーに変換するかどうかの判断とエラーの送信方法の決定は上位のレイヤーで行います。この変換を支援するために、チャネルは `FaultConverter` を実装し、カスタム チャネルがスローした例外を適切なエラーに変換できるようにします。`FaultConverter` は次のように定義します。  
+  
+```  
+public class FaultConverter  
+{  
+    public static FaultConverter GetDefaultFaultConverter(  
+                                   MessageVersion version);  
+    protected abstract bool OnTryCreateFaultMessage(  
+                                   Exception exception,   
+                                   out Message message);  
+    public bool TryCreateFaultMessage(  
+                                   Exception exception,   
+                                   out Message message);  
+}  
+```  
+  
+ カスタム エラーを生成する各チャネルは `FaultConverter` を実装し、`GetProperty<FaultConverter>` の呼び出しからこれを返す必要があります。カスタム `OnTryCreateFaultMessage` 実装では、例外をエラーに変換するか、内部チャネルの `FaultConverter` に委任する必要があります。チャネルがトランスポートの場合は、例外を変換するか、エンコーダーの `FaultConverter` または [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された既定の `FaultConverter` に委任する必要があります。既定の `FaultConverter` は、WS\-Addressing および SOAP で指定されたエラー メッセージに対応するエラーを変換します。`OnTryCreateFaultMessage` 実装の例を次に示します。  
+  
+```  
+public override bool OnTryCreateFaultMessage(Exception exception,   
+                                             out Message message)  
+{  
+    if (exception is ...)  
+    {  
+        message = ...;  
+        return true;  
+    }  
+  
+#if IMPLEMENTING_TRANSPORT_CHANNEL  
+    FaultConverter encoderConverter =   
+                    this.encoder.GetProperty<FaultConverter>();  
+    if ((encoderConverter != null) &&               
+        (encoderConverter.TryCreateFaultMessage(  
+         exception, out message)))  
+    {  
+        return true;  
+    }  
+  
+    FaultConverter defaultConverter =   
+                   FaultConverter.GetDefaultFaultConverter(  
+                   this.channel.messageVersion);  
+    return defaultConverter.TryCreateFaultMessage(  
+                   exception,   
+                   out message);  
+#else  
+    FaultConverter inner =   
+                   this.innerChannel.GetProperty<FaultConverter>();  
+    if (inner != null)  
+    {  
+        return inner.TryCreateFaultMessage(exception, out message);  
+    }  
+    else  
+    {  
+        message = null;  
+        return false;  
+    }  
+#endif  
+}  
+```  
+  
+ このパターンでは、エラーを必要とするエラー状態についてレイヤー間でスローされる例外に、対応するエラー ジェネレーターが適切なエラーを作成できるだけの情報が含まれている必要があります。カスタム チャネル作成者は、さまざまなエラー状態に対応する例外の種類を定義できます \(特定のエラー状態に対応する既存の例外がない場合\)。チャネル レイヤーを越えて伝播する例外では、不明瞭なエラー データではなく、エラー状態を伝える必要があります。  
+  
+### エラーのカテゴリ  
+ 一般に、エラーは次の 3 つのカテゴリに分類されます。  
+  
+1.  スタック全体にわたるエラー。このようなエラーは、チャネル スタックのどのレイヤーでも発生する可能性があります \(例 : InvalidCardinalityAddressingException\)。  
+  
+2.  スタックの特定のレイヤーより上位の任意の場所で発生する可能性があるエラー \(例 : フローされたトランザクションやセキュリティ ロールに関するエラー\)。  
+  
+3.  スタックの単一のレイヤーを対象とするエラー \(例 : WS\-RM シーケンス番号エラー\)。  
+  
+ カテゴリ 1: 一般に、WS\-Addressing エラーおよび SOAP エラーです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された `FaultConverter` 基本クラスでは、WS\-Addressing および SOAP で指定されたエラー メッセージに対応するエラーを変換するため、カスタム チャネル作成者がこれらの例外の変換を処理する必要はありません。  
+  
+ カテゴリ 2: レイヤーに関するメッセージ情報を完全に使用しているわけではないメッセージに対して、そのレイヤーがプロパティを追加したときに発生します。後で上位のレイヤーがメッセージ情報をさらに処理するために、メッセージ プロパティを要求したときに、エラーが検出されることがあります。このようなチャネルでは、前述の `GetProperty` を実装して、上位のレイヤーが適切なエラーを返すことができるようにする必要があります。プロパティの例として、TransactionMessageProperty があります。このプロパティは、ヘッダー内のすべてのデータが完全には検証されずにメッセージに追加されます \(この検証には、分散トランザクション コーディネーター \(DTC\) への接続が必要になることがあります\)。  
+  
+ カテゴリ 3: エラーは、プロセッサ内の単一のレイヤーによって生成され、送信されるだけです。したがって、すべての例外はそのレイヤー内に含まれます。チャネル間の整合性を向上させ、保守を容易にするために、カスタム チャネルでは、前述のパターンを使用して、内部エラーについてもエラー メッセージを生成することをお勧めします。  
+  
+### 受信したエラーの解釈  
+ このセクションでは、エラー メッセージを受信したときに、適切な例外を生成するためのガイダンスを示します。スタックのすべてのレイヤーにおけるメッセージ処理に関するデシジョン ツリーを以下に示します。  
+  
+1.  レイヤーがメッセージを無効と見なした場合、レイヤーは "無効なメッセージ" の処理を実行する必要があります。このような処理はレイヤーに固有のものですが、メッセージの破棄、トレース、エラーに変換される例外のスローなどの処理が可能です。たとえば、適切に保護されていないメッセージをセキュリティが受信した場合や、RM が不正なシーケンス番号を持つメッセージを受信した場合などです。  
+  
+2.  メッセージが特定のレイヤーに適用されるエラー メッセージであり、そのレイヤーの対話以外では意味がないものである場合、該当のレイヤーがエラー状態を処理する必要があります。この一例として、RM シーケンス拒否エラーが挙げられます。これは、RM チャネルにエラーが発生し、保留中の操作からスローされていることを示しており、RM チャネルより上位のレイヤーにとっては意味のないエラーです。  
+  
+3.  それ以外の場合は、Request\(\) または Receive\(\) からメッセージを返すようにします。たとえば、レイヤーはエラーを認識しているが、そのエラーは要求が失敗したことを示しているにすぎず、チャネルにエラーが発生し、保留中の操作からスローされていることを意味しているわけではない場合などです。このような場合にユーザビリティを向上させるには、レイヤーで `GetProperty<FaultConverter>` を実装し、`FaultConverter` 派生クラスを返すようにします。この派生クラスは、`OnTryCreateException` をオーバーライドすることで、エラーを例外に変換できます。  
+  
+ 次のオブジェクト モデルは、メッセージから例外への変換をサポートします。  
+  
+```  
+public class FaultConverter  
+{  
+    public static FaultConverter GetDefaultFaultConverter(  
+                                  MessageVersion version);  
+    protected abstract bool OnTryCreateException(  
+                                 Message message,   
+                                 MessageFault fault,   
+                                 out Exception exception);  
+    public bool TryCreateException(  
+                                 Message message,   
+                                 MessageFault fault,   
+                                 out Exception exception);  
+}  
+```  
+  
+ チャネル レイヤーは、`GetProperty<FaultConverter>` を実装することで、エラー メッセージから例外への変換をサポートできます。これを行うには、`OnTryCreateException` をオーバーライドし、エラー メッセージを検査します。エラー メッセージを認識した場合は、変換を実行します。それ以外の場合は、エラー メッセージの変換を内部チャネルに要求します。トランスポート チャネルでは、`FaultConverter.GetDefaultFaultConverter` に既定の SOAP\/WS\-Addressing FaultConverter の取得を委任する必要があります。  
+  
+ 一般的な実装は、次のようになります。  
+  
+```  
+public override bool OnTryCreateException(  
+                            Message message,   
+                            MessageFault fault,   
+                            out Exception exception)  
+{  
+    if (message.Action == "...")  
+    {  
+        exception = ...;  
+        return true;  
+    }  
+    // OR  
+    if ((fault.Code.Name == "...") && (fault.Code.Namespace == "..."))  
+    {  
+        exception = ...;  
+        return true;  
+    }  
+  
+    if (fault.IsMustUnderstand)  
+    {  
+        if (fault.WasHeaderNotUnderstood(  
+                   message.Headers, "...", "..."))  
+        {  
+            exception = new ProtocolException(...);  
+            return true;  
+        }  
+    }  
+  
+#if IMPLEMENTING_TRANSPORT_CHANNEL  
+    FaultConverter encoderConverter =   
+              this.encoder.GetProperty<FaultConverter>();  
+    if ((encoderConverter != null) &&   
+        (encoderConverter.TryCreateException(  
+                              message, fault, out exception)))  
+    {  
+        return true;  
+    }  
+  
+    FaultConverter defaultConverter =  
+             FaultConverter.GetDefaultFaultConverter(  
+                             this.channel.messageVersion);  
+    return defaultConverter.TryCreateException(  
+                             message, fault, out exception);  
+#else  
+    FaultConverter inner =   
+                    this.innerChannel.GetProperty<FaultConverter>();  
+    if (inner != null)  
+    {  
+        return inner.TryCreateException(message, fault, out exception);  
+    }  
+    else  
+    {  
+        exception = null;  
+        return false;  
+    }  
+#endif  
+}  
+```  
+  
+ 明確な回復シナリオが用意されたエラー状態については、`ProtocolException` の派生クラスを定義することを検討してください。  
+  
+### MustUnderstand の処理  
+ SOAP には、必須のヘッダーが受信側で認識されなかったことを通知するための一般的なエラーが定義されています。このエラーは、`mustUnderstand` エラーと呼ばれます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、カスタム チャネルで `mustUnderstand` エラーを生成することはありません。代わりに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 通信スタックの最上位にある [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ディスパッチャーが、MustUndestand\=true としてマークされたすべてのヘッダーが基になるスタックで認識されているかどうかをチェックします。認識されていないヘッダーが見つかった場合、その時点で `mustUnderstand` エラーが生成されます \(ユーザーは、この `mustUnderstand` の処理を無効にし、すべてのメッセージ ヘッダーをアプリケーションで受信するようにすることができます。その場合、`mustUnderstand` の処理はアプリケーションが実行します\)。生成されたエラーには、NotUnderstood ヘッダーが含まれます。このヘッダーには、MustUnderstand\=true でマークされたヘッダーの中で、認識されなかったすべてのヘッダーの名前が含まれています。  
+  
+ プロトコル チャネルから MustUnderstand\=true でマークされたカスタム ヘッダーを送信し、`mustUnderstand` エラーを受信した場合、そのエラーが送信したヘッダーに起因するものかどうかを確認する必要があります。`MessageFault` クラスには、このために役立つ 2 つのメンバーが存在します。  
+  
+```  
+public class MessageFault  
+{  
+    ...  
+    public bool IsMustUnderstandFault { get; }  
+    public static bool WasHeaderNotUnderstood(MessageHeaders headers,   
+        string name, string ns) { }  
+    ...  
+  
+}  
+```  
+  
+ エラーが `mustUnderstand` エラーの場合、`IsMustUnderstandFault` は `true` を返します。指定した名前と名前空間を持つヘッダーが NotUnderstood ヘッダーとしてエラーに含まれている場合、`WasHeaderNotUnderstood` は `true` を返します。それ以外の場合は、`false` を返します。  
+  
+ MustUnderstand \= true でマークされたヘッダーをチャネルで出力する場合は、該当のレイヤーも例外生成 API パターンを実装し、出力したヘッダーが原因で発生した `mustUnderstand` エラーを前述のより有用な例外に変換する必要があります。  
+  
+## トレース  
+ デバッガーをアタッチしてコードを段階的に実行できない場合に、運用アプリケーションや断続的な問題の診断を支援する 1 つの方法として、.NET Framework にはプログラムの実行をトレースする機構が用意されています。この機構のコア コンポーネントは <xref:System.Diagnostics?displayProperty=fullName> 名前空間にあり、以下で構成されます。  
+  
+-   <xref:System.Diagnostics.TraceSource?displayProperty=fullName> は、書き込むトレース情報のソースです。<xref:System.Diagnostics.TraceListener?displayProperty=fullName> は、<xref:System.Diagnostics.TraceSource> からトレースする情報を受け取り、リスナー固有の送信先に出力する具象リスナーの抽象基本クラスです。たとえば、<xref:System.Diagnostics.XmlWriterTraceListener> は、トレース情報を XML ファイルに出力します。最後に、<xref:System.Diagnostics.TraceSwitch?displayProperty=fullName> を使用すると、アプリケーション ユーザーがトレースの詳細出力レベルを制御できます。通常、このクラスは構成で指定します。  
+  
+-   コア コンポーネントに加え、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) を使用すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトレースを表示および検索できます。このツールは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって生成され、<xref:System.Diagnostics.XmlWriterTraceListener> を使用して書き込まれるトレース ファイル用に特別に設計されています。トレースに関与するさまざまなコンポーネントを次の図に示します。  
+  
+ ![例外とエラーの処理](../../../../docs/framework/wcf/extending/media/wcfc-tracinginchannelsc.gif "wcfc\_TracingInChannelsc")  
+  
+### カスタム チャネルからのトレース  
+ 実行中のアプリケーションにデバッガーをアタッチできないときに問題の診断を支援するために、カスタム チャネルはトレース メッセージを書き込む必要あります。この場合、<xref:System.Diagnostics.TraceSource> のインスタンス化と、トレースを書き込むためのメソッドの呼び出しの 2 つの高度なタスクが必要となります。  
+  
+ <xref:System.Diagnostics.TraceSource> をインスタンス化する場合、指定した文字列が対象のソースの名前になります。この名前を使用して、トレース ソースを構成 \(有効化\/無効化\/トレース レベルの設定\) します。また、トレース出力にもこの名前が表示されます。カスタム チャネルは、一意のソース名を使用して、トレース出力の利用者にトレース情報のソースがわかるようにする必要があります。トレース ソースの名前として、情報を書き込むアセンブリの名前を使用するのが一般的です。たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、System.ServiceModel アセンブリから書き込まれる情報のトレース ソースとして、System.ServiceModel を使用します。  
+  
+ トレース ソースを用意したら、<xref:System.Diagnostics.TraceSource.TraceData%2A>、<xref:System.Diagnostics.TraceSource.TraceEvent%2A>、または <xref:System.Diagnostics.TraceSource.TraceInformation%2A> の各メソッドを呼び出して、トレース エントリをトレース リスナーに書き込みます。書き込む各トレース エントリのイベントの種類は、<xref:System.Diagnostics.TraceEventType> に定義されたイベントの種類のいずれかとして分類する必要があります。この分類と構成でのトレース レベルの設定によって、トレース エントリをリスナーに出力するかどうかが決まります。たとえば、構成でトレース レベルを `Warning` に設定すると、`Warning`、`Error`、および `Critical` の各トレース エントリを書き込むことができますが、Information エントリと Verbose エントリはブロックされます。トレース ソースをインスタンス化し、Information レベルでエントリを書き込む例を次に示します。  
+  
+```  
+using System.Diagnostics;  
+//...  
+TraceSource udpSource=new TraceSource("Microsoft.Samples.Udp");  
+//...  
+udpsource.TraceInformation("UdpInputChannel received a message");  
+```  
+  
+> [!IMPORTANT]
+>  カスタム チャネル固有のトレース ソース名を指定して、トレース出力の利用者に出力のソースがわかるようにすることを強くお勧めします。  
+  
+#### トレース ビューアーとの統合  
+ トレース リスナーとして <xref:System.Diagnostics.XmlWriterTraceListener?displayProperty=fullName> を使用すると、チャネルによって生成されたトレースを [サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) で読み取り可能な形式で出力できます。これは、チャネル開発者が行う必要はありません。アプリケーション ユーザー \(またはアプリケーションのトラブルシューティング担当者\) が、アプリケーションの構成ファイルでこのトレース リスナーを構成する必要があります。たとえば、次の構成では、<xref:System.ServiceModel?displayProperty=fullName> と `Microsoft.Samples.Udp` の両方から `TraceEventsFile.e2e` というファイルにトレース情報が出力されます。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <!-- configure System.ServiceModel trace source -->  
+      <source name="System.ServiceModel" switchValue="Verbose"   
+              propagateActivity="true">  
+        <listeners>  
+          <add name="e2e" />  
+        </listeners>  
+      </source>  
+      <!-- configure Microsoft.Samples.Udp trace source -->  
+      <source name="Microsoft.Samples.Udp" switchValue="Verbose" >  
+        <listeners>  
+          <add name="e2e" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <!--   
+    Define a shared trace listener that outputs to TraceFile.e2e  
+    The listener name is e2e   
+    -->  
+    <sharedListeners>  
+      <add name="e2e" type="System.Diagnostics.XmlWriterTraceListener"  
+        initializeData=".\TraceFile.e2e"/>  
+    </sharedListeners>  
+    <trace autoflush="true" />  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+#### 構造化されたデータのトレース  
+ <xref:System.Diagnostics.TraceSource?displayProperty=fullName> には、トレース エントリに含まれる 1 つ以上のオブジェクトを取得する <xref:System.Diagnostics.TraceSource.TraceData%2A> メソッドがあります。通常、<xref:System.Object.ToString%2A?displayProperty=fullName> メソッドは各オブジェクトに対して呼び出され、生成された文字列はトレース エントリの一部として書き込まれます。<xref:System.Diagnostics.XmlWriterTraceListener?displayProperty=fullName> を使用してトレースを出力する場合、データ オブジェクトとして <xref:System.Xml.Xpath.IXPathNavigable?displayProperty=fullName> を <xref:System.Diagnostics.TraceSource.TraceData%2A> に渡すことができます。生成されるトレース エントリには、<xref:System.Xml.Xpath.XPathNavigator?displayProperty=fullName> によって提供された XML が含まれます。XML アプリケーション データが含まれたエントリの例を次に示します。  
+  
+```  
+<E2ETraceEvent xmlns="http://schemas.microsoft.com/2004/06/E2ETraceEvent">  
+  <System xmlns="...">  
+    <EventID>12</EventID>  
+    <Type>3</Type>  
+    <SubType Name="Information">0</SubType>  
+    <Level>8</Level>  
+    <TimeCreated SystemTime="2006-01-13T22:58:03.0654832Z" />  
+    <Source Name="Microsoft.ServiceModel.Samples.Udp" />  
+    <Correlation ActivityID="{00000000-0000-0000-0000-000000000000}" />  
+    <Execution  ProcessName="UdpTestConsole"   
+                ProcessID="3348" ThreadID="4" />  
+    <Channel />  
+    <Computer>COMPUTER-LT01</Computer>  
+  </System>  
+<!-- XML application data -->  
+  <ApplicationData>  
+  <TraceData>  
+   <DataItem>  
+   <TraceRecord   
+     Severity="Information"  
+     xmlns="…">  
+        <TraceIdentifier>some trace id</TraceIdentifier>  
+        <Description>EndReceive called</Description>  
+        <AppDomain>UdpTestConsole.exe</AppDomain>  
+        <Source>UdpInputChannel</Source>  
+      </TraceRecord>  
+    </DataItem>  
+  </TraceData>  
+  </ApplicationData>  
+</E2ETraceEvent>  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トレース ビューアーは、上記の `TraceRecord` 要素のスキーマを認識し、その子要素からデータを抽出して表形式で表示します。チャネルで構造化されたアプリケーション データをトレースするときには、このスキーマを使用して Svctraceviewer.exe のユーザーがデータを判読しやすいようにします。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-compare-claims.md b/docs/framework/wcf/extending/how-to-compare-claims.md
new file mode 100644
index 00000000000..a1fba258a6d
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-compare-claims.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : クレームを比較する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クレーム [WCF]"
+  - "クレーム [WCF], 比較"
+ms.assetid: 0c4ec84d-53df-408f-8953-9bc437f56c28
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : クレームを比較する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 内の識別モデル インフラストラクチャを使用して、承認確認を実行します。この場合、一般的なタスクとして、承認コンテキスト内のクレームが、要求されたアクションの実行や要求されたリソースへのアクセスに必要なクレームと比較されます。このトピックでは、組み込みとカスタム クレームの型を含め、クレームの比較方法について説明します。ID モデル インフラストラクチャ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)」を参照してください。  
+  
+ クレームの比較では、クレーム間で 3 つの部分 \(型、権限、およびリソース\) の比較が行われ、等しいかどうかが判断されます。次の例を参照してください。  
+  
+ [!code-csharp[c_CustomClaimComparison#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#9)]
+ [!code-vb[c_CustomClaimComparison#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#9)]  
+  
+ いずれのクレームにも、クレームの型として <xref:System.IdentityModel.Claims.ClaimTypes.Name%2A>、権限として <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A>、および文字列リソースとして "someone" が設定されています。クレームの 3 つの部分のすべてが等しいため、この 2 つのクレームは等しくなります。  
+  
+ 組み込みのクレームの型の比較には、<xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッドを使用します。必要に応じて、クレーム固有の比較コードが使用されます。たとえば、次の 2 つのユーザー プリンシパル名 \(UPN\) クレームがあるとします。  
+  
+ [!code-csharp[c_CustomClaimComparison#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#4)]
+ [!code-vb[c_CustomClaimComparison#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#4)]  
+  
+ `example\someone` が "someone@example.com" と同じドメイン ユーザーを示すと見なし、<xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッド内の比較コードは `true` を返します。  
+  
+ カスタム クレームの型の比較にも、<xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッドを使用できます。ただし、クレームの <xref:System.IdentityModel.Claims.Claim.Resource%2A> プロパティから返された型がプリミティブ型ではない場合、<xref:System.IdentityModel.Claims.Claim.Equals%2A> が `true` を返すのは、`Resource` プロパティから返された値どうしが等しいと <xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッドが見なした場合のみです。この動作が適切でない場合は、`Resource` プロパティから返されたカスタム型で <xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッドと <xref:System.Object.GetHashCode%2A> メソッドを上書きし、必要なカスタム処理を実行する必要があります。  
+  
+### 組み込みのクレームの比較  
+  
+1.  <xref:System.IdentityModel.Claims.Claim> クラスの 2 つのインスタンスがある場合、次に示すコードのように、<xref:System.IdentityModel.Claims.Claim.Equals%2A> を使用して比較します。  
+  
+     [!code-csharp[c_CustomClaimComparison#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#5)]
+     [!code-vb[c_CustomClaimComparison#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#5)]  
+  
+### カスタム クレームとプリミティブ リソース型の比較  
+  
+1.  プリミティブ リソース型を含むカスタム クレームでは、次のコードのように、組み込みのクレームとして比較を実行できます。  
+  
+     [!code-csharp[c_CustomClaimComparison#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#6)]
+     [!code-vb[c_CustomClaimComparison#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#6)]  
+  
+2.  構造体またはクラスをベースとしたリソース型を含むカスタム クレームでは、そのリソース型で <xref:System.IdentityModel.Claims.Claim.Equals%2A> メソッドを上書きする必要があります。  
+  
+3.  まず、`obj` パラメーターが `null` であるかどうかを確認し、null である場合は `false` を返します。  
+  
+     [!code-csharp[c_CustomClaimComparison#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#7)]
+     [!code-vb[c_CustomClaimComparison#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#7)]  
+  
+4.  次に、<xref:System.Object.ReferenceEquals%2A> を呼び出し、パラメーターとして `this` と `obj` を渡します。`true` が返されたら、`true` を返します。  
+  
+     [!code-csharp[c_CustomClaimComparison#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#8)]
+     [!code-vb[c_CustomClaimComparison#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#8)]  
+  
+5.  さらに、`obj` をクラスの型のローカル変数に割り当てます。この処理が失敗すると、参照が `null` になります。この場合、`false` が返されます。  
+  
+6.  現在のクレームと提供されたクレームを正しく比較するために必要なカスタム比較を実行します。  
+  
+## 使用例  
+ 次の例では、クレームの型がプリミティブ型以外のカスタム クレームを比較します。  
+  
+ [!code-csharp[c_CustomClaimComparison#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaimcomparison/cs/c_customclaimcomparison.cs#0)]
+ [!code-vb[c_CustomClaimComparison#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaimcomparison/vb/source.vb#0)]  
+  
+## 参照  
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)   
+ [方法 : カスタム クレームを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-claim.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md b/docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md
new file mode 100644
index 00000000000..c44b17f89ee
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md
@@ -0,0 +1,129 @@
+---
+title: "方法 : カスタム WS-Metadata Exchange バインディングを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WS-Metadata Exchange [WCF]"
+  - "WS-Metadata Exchange [WCF], カスタム バインディングの構成"
+ms.assetid: cdba4d73-da64-4805-bc56-9822becfd1e4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : カスタム WS-Metadata Exchange バインディングを構成する
+ここでは、カスタム WS\-Metadata Exchange バインディングを構成する方法について説明します。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、4 つのシステム定義のメタデータ バインディングがありますが、どのバインディングでもメタデータを公開できます。  ここでは、`wsHttpBinding` を使用してメタデータを公開する方法を示します。  このバインディングでは、メタデータをセキュリティで保護して公開することができます。  ここに示すコードは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+### 構成ファイルの使用  
+  
+1.  サービスの構成ファイルで、`serviceMetadata` タグを含んだサービス動作を追加します。  
+  
+    ```  
+    <behaviors>  
+       <serviceBehaviors>  
+         <behavior name="CalculatorServiceBehavior">  
+           <serviceMetadata httpGetEnabled="True"/>  
+         </behavior>  
+       </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+2.  この新しい動作を参照する `behaviorConfiguration` 属性をサービス タグに追加します。  
+  
+    ```  
+    <service        name="Microsoft.ServiceModel.Samples.CalculatorService"  
+    behaviorConfiguration="CalculatorServiceBehavior">   
+    ```  
+  
+3.  メタデータ エンドポイントを追加し、アドレスに mex、バインディングに `wsHttpBinding`、コントラクトに <xref:System.ServiceModel.Description.IMetadataExchange> をそれぞれ指定します。  
+  
+    ```  
+    <endpoint address="mex"  
+              binding="wsHttpBinding"  
+              contract="IMetadataExchange" />  
+    ```  
+  
+4.  Metadata Exchange エンドポイントが適切に動作することを確認するには、クライアントの構成ファイルにエンドポイント タグを追加します。  
+  
+    ```  
+    <endpoint name="MyMexEndpoint"               address="http://localhost:8000/servicemodelsamples/service/mex"  
+              binding="wsHttpBinding"  
+              contract="IMetadataExchange"/>  
+    ```  
+  
+5.  クライアントの Main\(\) メソッドで、新しい <xref:System.ServiceModel.Description.MetadataExchangeClient> インスタンスを作成し、その <xref:System.ServiceModel.Description.MetadataExchangeClient.ResolveMetadataReferences%2A> プロパティを `true` に設定し、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> を呼び出して返されるメタデータのコレクションを反復処理します。  
+  
+    ```  
+    string mexAddress = "http://localhost:8000/servicemodelsamples/service/mex";  
+  
+    MetadataExchangeClient mexClient = new MetadataExchangeClient("MyMexEndpoint");  
+    mexClient.ResolveMetadataReferences = true;  
+    MetadataSet mdSet = mexClient.GetMetadata(new EndpointAddress(mexAddress));  
+    foreach (MetadataSection section in mdSet.MetadataSections)  
+    Console.WriteLine("Metadata section: " + section.Dialect.ToString());  
+    ```  
+  
+### コードによる構成  
+  
+1.  <xref:System.ServiceModel.WsHttpBinding> バインディングのインスタンスを作成します。  
+  
+    ```  
+    WSHttpBinding binding = new WSHttpBinding();  
+    ```  
+  
+2.  <xref:System.ServiceModel.ServiceHost> インスタンスを作成します。  
+  
+    ```  
+    ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);  
+    ```  
+  
+3.  サービス エンドポイントと <xref:System.ServiceModel.Description.ServiceMetadataBehavior> インスタンスを追加します。  
+  
+    ```  
+    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, baseAddress);  
+    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();  
+    smb.HttpGetEnabled = true;  
+    serviceHost.Description.Behaviors.Add(smb);  
+    ```  
+  
+4.  前に作成した <xref:System.ServiceModel.WSHttpBinding> を指定する Metadata Exchange エンドポイントを追加します。  
+  
+    ```  
+    serviceHost.AddServiceEndpoint(typeof(IMetadataExchange), binding, mexAddress);  
+    ```  
+  
+5.  Metadata Exchange エンドポイントが適切に動作することを確認するには、クライアントの構成ファイルにエンドポイント タグを追加します。  
+  
+    ```  
+    <endpoint name="MyMexEndpoint"               address="http://localhost:8000/servicemodelsamples/service/mex"  
+              binding="wsHttpBinding"  
+              contract="IMetadataExchange"/>  
+    ```  
+  
+6.  クライアントの Main\(\) メソッドで、新しい <xref:System.ServiceModel.Description.MetadataExchangeClient> インスタンスを作成し、その <xref:System.ServiceModel.Description.MetadataExchangeClient.ResolveMetadataReferences%2A> プロパティを `true` に設定し、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> を呼び出して返されるメタデータのコレクションを反復処理します。  
+  
+    ```  
+    string mexAddress = "http://localhost:8000/servicemodelsamples/service/mex";  
+  
+    MetadataExchangeClient mexClient = new MetadataExchangeClient("MyMexEndpoint");  
+    mexClient.ResolveMetadataReferences = true;  
+    MetadataSet mdSet = mexClient.GetMetadata(new EndpointAddress(mexAddress));  
+    foreach (MetadataSection section in mdSet.MetadataSections)  
+    Console.WriteLine("Metadata section: " + section.Dialect.ToString());  
+  
+    ```  
+  
+## 参照  
+ [メタデータ公開動作](../../../../docs/framework/wcf/samples/metadata-publishing-behavior.md)   
+ [メタデータの抽出](../../../../docs/framework/wcf/samples/retrieve-metadata.md)   
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)   
+ [メタデータ エンドポイントを公開する](../../../../docs/framework/wcf/publishing-metadata-endpoints.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md b/docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md
new file mode 100644
index 00000000000..f8bb311f604
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md
@@ -0,0 +1,127 @@
+---
+title: "方法 : サービスで使用するカスタム承認マネージャーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "OperationRequirement クラス"
+  - "Windows Communication Foundation, 拡張"
+ms.assetid: 6214afde-44c1-4bf5-ba07-5ad6493620ea
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法 : サービスで使用するカスタム承認マネージャーを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 内の識別モデル インフラストラクチャでは、拡張性のあるクレーム ベースの承認モデルがサポートされます。クレームはトークンから抽出され、状況に応じてカスタム承認ポリシーによって処理されてから、<xref:System.IdentityModel.Policy.AuthorizationContext> に格納されます。承認マネージャーは、<xref:System.IdentityModel.Policy.AuthorizationContext> 内のクレームを検査して承認に関する決定を行います。  
+  
+ 既定では、承認に関する決定は、<xref:System.ServiceModel.ServiceAuthorizationManager> クラスによって行われますが、カスタム承認マネージャーを作成することによってオーバーライドできます。カスタム承認マネージャーを作成するには、<xref:System.ServiceModel.ServiceAuthorizationManager> から派生するクラスを作成し、<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッドを実装します。承認に関する決定は、<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッド内で行われます。このメソッドは、アクセスが許可されている場合は `true` を返し、拒否されている場合は `false` を返します。  
+  
+ 承認決定がメッセージ本文の内容に依存する場合は、<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccess%2A> メソッドを使用します。  
+  
+ パフォーマンスの問題があるので、可能であればアプリケーションを再デザインして、承認決定でメッセージ本文にアクセスする必要がないようにしてください。  
+  
+ サービスのカスタム承認マネージャーは、コードまたは構成に登録できます。  
+  
+### カスタム承認マネージャーを作成するには  
+  
+1.  <xref:System.ServiceModel.ServiceAuthorizationManager> クラスからクラスを派生させます。  
+  
+     [!code-csharp[c_CustomAuthMgr#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthmgr/cs/c_customauthmgr.cs#5)]
+     [!code-vb[c_CustomAuthMgr#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthmgr/vb/c_customauthmgr.vb#5)]  
+  
+2.  <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%28System.ServiceModel.OperationContext%29> メソッドをオーバーライドします。  
+  
+     <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%28System.ServiceModel.OperationContext%29> メソッドに渡される <xref:System.ServiceModel.OperationContext> を使用して、承認に関する決定を行います。  
+  
+     承認に関する決定を行うために、<xref:System.IdentityModel.Claims.ClaimSet.FindClaims%28System.String%2CSystem.String%29> メソッドを使用してカスタム クレーム `http://www.contoso.com/claims/allowedoperation` を検索する方法を次のコード例に示します。  
+  
+     [!code-csharp[c_CustomAuthMgr#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthmgr/cs/c_customauthmgr.cs#6)]
+     [!code-vb[c_CustomAuthMgr#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthmgr/vb/c_customauthmgr.vb#6)]  
+  
+### コードを使用してカスタム承認マネージャーを登録するには  
+  
+1.  カスタム承認マネージャーのインスタンスを作成し、これを <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ServiceAuthorizationManager%2A> プロパティに割り当てます。  
+  
+     <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> には、<xref:System.ServiceModel.ServiceHostBase.Authorization%2A> プロパティを使用してアクセスできます。  
+  
+     `MyServiceAuthorizationManager` カスタム承認マネージャーを登録するコード例を次に示します。  
+  
+     [!code-csharp[c_CustomAuthMgr#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthmgr/cs/c_customauthmgr.cs#4)]
+     [!code-vb[c_CustomAuthMgr#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthmgr/vb/c_customauthmgr.vb#4)]  
+  
+### 構成を使用してカスタム承認マネージャーを登録するには  
+  
+1.  サービスの構成ファイルを開きます。  
+  
+2.  [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)に [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)を追加します。  
+  
+     [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)に `serviceAuthorizationManagerType` 属性を追加し、この属性の値をカスタム承認マネージャーを表す型に設定します。  
+  
+3.  クライアントとサービスの間の通信をセキュリティで保護するバインディングを追加します。  
+  
+     この通信用に選択されたバインディングによって、<xref:System.IdentityModel.Policy.AuthorizationContext> に追加されるクレームが決まります。これは、カスタム承認マネージャーが承認に関する決定を行うために使用します。システム指定のバインディングの詳細については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+4.  [\<service\>](../../../../docs/framework/configure-apps/file-schema/wcf/service.md) 要素を追加し、`behaviorConfiguration` 属性の値を [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md) 要素の名前属性の値に設定して、サービス エンドポイントに動作を関連付けます。  
+  
+     サービス エンドポイントの構成の詳細については、「[方法 : 構成にサービス エンドポイントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)」を参照してください。  
+  
+     カスタム承認マネージャー `Samples.MyServiceAuthorizationManager` を登録するコード例を次に示します。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <services>  
+          <service   
+              name="Microsoft.ServiceModel.Samples.CalculatorService"  
+              behaviorConfiguration="CalculatorServiceBehavior">  
+            <host>  
+              <baseAddresses>  
+                <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+              </baseAddresses>  
+            </host>  
+            <endpoint address=""  
+                      binding="wsHttpBinding_Calculator"  
+                      contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+          </service>  
+        </services>  
+        <bindings>  
+          <WSHttpBinding>  
+           <binding name = "wsHttpBinding_Calculator">  
+             <security mode="Message">  
+               <message clientCredentialType="Windows"/>  
+             </security>  
+            </binding>  
+          </WSHttpBinding>  
+    </bindings>  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="CalculatorServiceBehavior">  
+              <serviceAuthorization serviceAuthorizationManagerType="Samples.MyServiceAuthorizationManager,MyAssembly" />  
+             </behavior>  
+         </serviceBehaviors>  
+       </behaviors>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+    > [!WARNING]
+    >  serviceAuthorizationManagerType を指定する場合、文字列には、完全修飾型名、コンマ、型が定義されているアセンブリの名前が含まれている必要があります。アセンブリ名を省略した場合、WCF は、System.ServiceModel.dll から型を読み込もうとします。  
+  
+## 使用例  
+ <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッドのオーバーライドを含む <xref:System.ServiceModel.ServiceAuthorizationManager> クラスの基本実装を次のコード例に示します。このコード例は、<xref:System.IdentityModel.Policy.AuthorizationContext> のカスタム クレームを調べ、そのカスタム クレームのリソースが <xref:System.ServiceModel.OperationContext> のアクション値と一致した場合に `true` を返します。<xref:System.ServiceModel.ServiceAuthorizationManager> クラスのより完全な実装については、「[承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)」を参照してください。  
+  
+ [!code-csharp[c_CustomAuthMgr#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthmgr/cs/c_customauthmgr.cs#2)]
+ [!code-vb[c_CustomAuthMgr#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthmgr/vb/c_customauthmgr.vb#2)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>   
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)   
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-authorization-policy.md b/docs/framework/wcf/extending/how-to-create-a-custom-authorization-policy.md
new file mode 100644
index 00000000000..6fdeea16c53
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-authorization-policy.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : カスタム承認ポリシーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05b0549b-882d-4660-b6f0-5678543e5475
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : カスタム承認ポリシーを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 内の識別モデル インフラストラクチャでは、クレーム ベースの承認モデルがサポートされます。クレームは、トークンから抽出され、状況に応じてカスタム承認ポリシーによって処理されてから、承認決定を行う際に確認できる <xref:System.IdentityModel.Policy.AuthorizationContext> に格納されます。カスタム ポリシーを使用して、入力トークンからのクレームを、アプリケーションが要求するクレームに変換することができます。この方法では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がサポートするトークンの種類から抽出される個々のクレームの詳細から、アプリケーション レイヤーを分離できます。このトピックでは、カスタム承認ポリシーの実装方法と、サービスで使用するポリシーのコレクションにカスタム承認ポリシーを追加する方法について説明します。  
+  
+### カスタム承認ポリシーを実装するには  
+  
+1.  <xref:System.IdentityModel.Policy.IAuthorizationPolicy> から派生する新しいクラスを定義します。  
+  
+2.  クラスのコンストラクター内で一意の文字列を生成し、プロパティがアクセスされたときにその文字列を返すことによって、読み取り専用の <xref:System.IdentityModel.Policy.IAuthorizationComponent.Id%2A> プロパティを実装します。  
+  
+3.  ポリシーの発行者を表す <xref:System.IdentityModel.Claims.ClaimSet> を返すことによって、読み取り専用の <xref:System.IdentityModel.Policy.IAuthorizationPolicy.Issuer%2A> プロパティを実装します。これは、アプリケーションを表す `ClaimSet`、または組み込み `ClaimSet` \(静的な <xref:System.IdentityModel.Claims.ClaimSet.System%2A> プロパティから返される `ClaimSet` など\) にすることができます。  
+  
+4.  次の手順に従って、<xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%28System.IdentityModel.Policy.EvaluationContext%2CSystem.Object%40%29> メソッドを実装します。  
+  
+### Evaluate メソッドを実装するには  
+  
+1.  このメソッドには、<xref:System.IdentityModel.Policy.EvaluationContext> クラスのインスタンスとオブジェクト参照の 2 つのパラメーターが渡されます。  
+  
+2.  カスタム承認ポリシーで、<xref:System.IdentityModel.Policy.EvaluationContext> の現在の内容とは無関係に <xref:System.IdentityModel.Claims.ClaimSet> インスタンスを追加する場合は、<xref:System.IdentityModel.Policy.EvaluationContext.AddClaimSet%28System.IdentityModel.Policy.IAuthorizationPolicy%2CSystem.IdentityModel.Claims.ClaimSet%29> メソッドを呼び出して各 `ClaimSet` を追加し、<xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%2A> メソッドから `true` を返します。`true` を返すことは、承認インフラストラクチャに対して、承認ポリシーがその処理を完了したため、もう一度呼び出す必要がないことを知らせることになります。  
+  
+3.  カスタム承認ポリシーで `EvaluationContext` 内に特定のクレームが既に存在するときにのみクレーム セットを追加する場合は、<xref:System.IdentityModel.Policy.EvaluationContext.ClaimSets%2A> プロパティから返された `ClaimSet` インスタンスを調べて、該当するクレームを見つけます。クレームが見つかった場合は、<xref:System.IdentityModel.Policy.EvaluationContext.AddClaimSet%28System.IdentityModel.Policy.IAuthorizationPolicy%2CSystem.IdentityModel.Claims.ClaimSet%29> メソッドを呼び出して新しいクレーム セットを追加します。追加するクレーム セットがない場合は、`true` を返し、承認インフラストラクチャに承認ポリシーがその処理を完了したことを知らせます。クレームが存在しない場合は `false` を返し、他の承認ポリシーで `EvaluationContext` にさらにクレーム セットを追加する場合は、もう一度承認ポリシーを呼び出す必要があることを知らせます。  
+  
+4.  より複雑な処理シナリオでは、<xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%28System.IdentityModel.Policy.EvaluationContext%2CSystem.Object%40%29> メソッドの 2 番目のパラメーターを使用して、特定の評価のために <xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%28System.IdentityModel.Policy.EvaluationContext%2CSystem.Object%40%29> メソッドに対するその後の呼び出し時に承認インフラストラクチャから返される状態変数を格納します。  
+  
+### 構成を使用してカスタム承認ポリシーを指定するには  
+  
+1.  `serviceAuthorization` 要素の `authorizationPolicies` 要素にある `add` 要素の `policyType` 属性でカスタム承認ポリシーの種類を指定します。  
+  
+    ```  
+    <configuration>  
+     <system.serviceModel>  
+      <behaviors>  
+        <serviceAuthorization serviceAuthorizationManagerType=  
+                  "Samples.MyServiceAuthorizationManager" >  
+          <authorizationPolicies>         
+            <add policyType="Samples.MyAuthorizationPolicy"  
+          </authorizationPolicies>  
+        </serviceAuthorization>  
+      </behaviors>  
+     </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+### コードを使用してカスタム承認ポリシーを指定するには  
+  
+1.  <xref:System.IdentityModel.Policy.IAuthorizationPolicy> の <xref:System.Collections.Generic.List%601> を作成します。  
+  
+2.  カスタム承認ポリシーのインスタンスを作成します。  
+  
+3.  リストに承認ポリシー インスタンスを追加します。  
+  
+4.  カスタム承認ポリシーごとに手順 2. と 3. を繰り返します。  
+  
+5.  <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ExternalAuthorizationPolicies%2A> プロパティにリストの読み取り専用バージョンを割り当てます。  
+  
+     [!code-csharp[c_CustomAuthPol#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthpol/cs/c_customauthpol.cs#8)]
+     [!code-vb[c_CustomAuthPol#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthpol/vb/source.vb#8)]  
+  
+## 使用例  
+ 完成した <xref:System.IdentityModel.Policy.IAuthorizationPolicy> の実装例を次に示します。  
+  
+ [!code-csharp[c_CustomAuthPol#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customauthpol/cs/c_customauthpol.cs#5)]
+ [!code-vb[c_CustomAuthPol#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customauthpol/vb/source.vb#5)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>   
+ [方法 : クレームを比較する](../../../../docs/framework/wcf/extending/how-to-compare-claims.md)   
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)   
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-claim.md b/docs/framework/wcf/extending/how-to-create-a-custom-claim.md
new file mode 100644
index 00000000000..db936047d41
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-claim.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : カスタム クレームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d619976b-eda3-475e-ac23-c7988a2dceb0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : カスタム クレームを作成する
+Id モデル インフラストラクチャで[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]ヘルパー関数を作成するための組み込みクレームの種類と権限のセットを提供<xref:System.IdentityModel.Claims.Claim>その種類と権限を持つインスタンス。 この組み込みクレームは、既定で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をサポートするクライアント資格情報の型内にある情報をモデル化するように作成されています。 多くの場合はこの組み込みクレームで十分ですが、一部のアプリケーションでカスタム クレームが必要になる場合があります。 クレームは、クレームが適用されるリソースを示すクレームの種類と、リソースにアサートされる権限で構成されます。 このトピックでは、カスタム クレームを作成する方法について説明します。  
+  
+### <a name="to-create-a-custom-claim-that-is-based-on-a-primitive-data-type"></a>プリミティブ データ型に基づくカスタム クレームを作成するには  
+  
+1.  クレームの種類、リソースの値とする権利を渡すことによって、カスタム クレームを作成、 <xref:System.IdentityModel.Claims.Claim.%23ctor%28System.String%2CSystem.Object%2CSystem.String%29>コンス トラクターです。  
+  
+    1.  クレームの種類の一意の値を指定します。  
+  
+         クレームの種類は一意の文字列識別子です。 カスタム クレームを作成する場合、クレームの種類に使用されている文字列識別子が一意になるようにしてください。 定義されているクレームの種類の一覧については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください、 <xref:System.IdentityModel.Claims.ClaimTypes>クラスです。  
+  
+    2.  プリミティブ データ型とリソースの値を選択します。  
+  
+         リソースはオブジェクトです。 リソースの CLR 型では、プリミティブをなど、<xref:System.String>または<xref:System.Int32>、または任意のシリアル化可能な型です。 クレームは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によりさまざまな点でシリアル化されるため、CLR 型のリソースはシリアル化可能なものにする必要があります。 プリミティブ型はシリアル化できます。  
+  
+    3.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で定義されている権限か、カスタム権限の一意の値を選択します。  
+  
+         権限は一意の文字列識別子です。 定義されている権利[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]で定義された、<xref:System.IdentityModel.Claims.Rights>クラスです。  
+  
+         カスタム クレームを作成する場合、権限に使用されている文字列識別子が一意になるようにしてください。  
+  
+         次のコード例では、カスタム クレームを作成の要求の種類で`http://example.org/claims/simplecustomclaim`、という名前のリソースの`Driver's License`を使用して、 <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A>適切です。  
+  
+     [!code-csharp[c_CustomClaim#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaim/cs/c_customclaim.cs#4)]
+     [!code-vb[c_CustomClaim#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaim/vb/c_customclaim.vb#4)]  
+  
+### <a name="to-create-a-custom-claim-that-is-based-on-a-non-primitive-data-type"></a>プリミティブ以外のデータ型に基づくカスタム クレームを作成するには  
+  
+1.  クレームの種類、リソースの値とする権利を渡すことによって、カスタム クレームを作成、 <xref:System.IdentityModel.Claims.Claim.%23ctor%28System.String%2CSystem.Object%2CSystem.String%29>コンス トラクターです。  
+  
+    1.  クレームの種類の一意の値を指定します。  
+  
+         クレームの種類は一意の文字列識別子です。 カスタム クレームを作成する場合、クレームの種類に使用されている文字列識別子が一意になるようにしてください。 定義されているクレームの種類の一覧については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください、 <xref:System.IdentityModel.Claims.ClaimTypes>クラスです。  
+  
+    2.  リソース用のシリアル化可能な、プリミティブ型以外の型を選択または定義します。  
+  
+         リソースはオブジェクトです。 クレームは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によりさまざまな点でシリアル化されるため、CLR 型のリソースはシリアル化可能なものにする必要があります。 プリミティブ型は既にシリアル化できます。  
+  
+         新しい型が定義されている場合は、適用、 <xref:System.Runtime.Serialization.DataContractAttribute>クラスにします。 適用も、 <xref:System.Runtime.Serialization.DataMemberAttribute>属性をクレームの一部としてシリアル化する必要のある新しい型のすべてのメンバーにします。  
+  
+         `MyResourceType` というカスタム リソース型を定義するコード例を次に示します。  
+  
+         [!code-csharp[c_CustomClaim#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaim/cs/c_customclaim.cs#2)]
+         [!code-vb[c_CustomClaim#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaim/vb/c_customclaim.vb#2)]  
+  
+    3.  
+          [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で定義されている権限か、カスタム権限の一意の値を選択します。  
+  
+         権限は一意の文字列識別子です。 定義されている権利[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]で定義された、<xref:System.IdentityModel.Claims.Rights>クラスです。  
+  
+         カスタム クレームを作成する場合、権限に使用されている文字列識別子が一意になるようにしてください。  
+  
+         次のコード例では、カスタム クレームを作成の要求の種類で`http://example.org/claims/complexcustomclaim`、カスタム リソース型`MyResourceType`を使用して、 <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A>右です。  
+  
+     [!code-csharp[c_CustomClaim#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaim/cs/c_customclaim.cs#5)]
+     [!code-vb[c_CustomClaim#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaim/vb/c_customclaim.vb#5)]  
+  
+## <a name="example"></a>例  
+ 次のコード例で、プリミティブ リソース型を持つカスタム クレームと、プリミティブ以外のリソース型を持つカスタム クレームの作成方法を示します。  
+  
+ [!code-csharp[c_CustomClaim#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customclaim/cs/c_customclaim.cs#0)]
+ [!code-vb[c_CustomClaim#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customclaim/vb/c_customclaim.vb#0)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.IdentityModel.Claims.Claim>   
+ <xref:System.IdentityModel.Claims.Rights>   
+ <xref:System.IdentityModel.Claims.ClaimTypes>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ [クレームと Id モデルの承認を管理します。](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)   
+ [クレームと Id モデルの承認を管理します。](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md b/docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md
new file mode 100644
index 00000000000..4c58dde5169
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md
@@ -0,0 +1,94 @@
+---
+title: "方法 : カスタム クライアント ID 検証機能を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2d34e43-fa8b-46d2-91cf-d2960e13e16b
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法 : カスタム クライアント ID 検証機能を作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の *ID* 機能を使用すると、クライアントで、予想されるサービスの ID を事前に指定できます。  サーバーがクライアントに対して自身を認証するたびに、ID がこの予想 ID と照合されます  \(ID とその機能の詳細については、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください\)。  
+  
+ 必要に応じて、カスタム ID 検証機能を使用して検証をカスタマイズできます。  たとえば、追加のサービス ID 検証チェックを実行できます。  この例では、カスタム ID 検証機能で、サーバーから戻された X.509 証明書の追加のクレームをチェックします。  サンプル アプリケーションについては、「[サービス ID サンプル](../../../../docs/framework/wcf/samples/service-identity-sample.md)」を参照してください。  
+  
+### EndpointIdentity クラスを拡張するには  
+  
+1.  <xref:System.ServiceModel.EndpointIdentity> クラスから派生する新しいクラスを定義します。  拡張子 `OrgEndpointIdentity` に名前を付ける例を次に示します。  
+  
+2.  拡張 <xref:System.ServiceModel.Security.IdentityVerifier> クラスで使用するプライベート メンバーとプロパティを追加し、サービスによって返されたセキュリティ トークンのクレームに対して ID チェックを実行します。  この例では、`OrganizationClaim` プロパティを定義します。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#6)]
+     [!code-vb[c_HowToSetCustomClientIdentity#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#6)]  
+  
+### IdentityVerifier クラスを拡張するには  
+  
+1.  <xref:System.ServiceModel.Security.IdentityVerifier> から派生する新しいクラスを定義します。  拡張子 `CustomIdentityVerifier` に名前を付ける例を次に示します。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#7)]
+     [!code-vb[c_HowToSetCustomClientIdentity#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#7)]  
+  
+2.  <xref:System.ServiceModel.Security.IdentityVerifier.CheckAccess%2A> メソッドをオーバーライドします。  このメソッドは、ID チェックが成功したか失敗したかを判定します。  
+  
+3.  `CheckAccess` メソッドには 2 つのパラメーターがあります。  1 つ目は <xref:System.ServiceModel.EndpointIdentity> クラスのインスタンスです。  2 つ目は <xref:System.IdentityModel.Policy.AuthorizationContext> クラスのインスタンスです。  
+  
+     メソッド実装では、<xref:System.IdentityModel.Policy.AuthorizationContext> クラスの <xref:System.IdentityModel.Policy.AuthorizationContext.ClaimSets%2A> プロパティから返されたクレームのコレクションを検査し、必要に応じて認証チェックを実行します。  この例では、まず種類が "識別名" のクレームをすべて検索し、次にその名前と <xref:System.ServiceModel.EndpointIdentity> の拡張 \(`OrgEndpointIdentity`\) とを比較します。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#1)]
+     [!code-vb[c_HowToSetCustomClientIdentity#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#1)]  
+  
+### TryGetIdentity メソッドを実装するには  
+  
+1.  <xref:System.ServiceModel.Security.IdentityVerifier.TryGetIdentity%2A> メソッドを実装します。このメソッドは、クライアントが <xref:System.ServiceModel.EndpointIdentity> クラスのインスタンスを返すことができるかどうかを判定します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、まず `TryGetIdentity` メソッドの実装を呼び出して、メッセージからサービスの ID を取得します。  次に、インフラストラクチャは、返された `EndpointIdentity` と <xref:System.IdentityModel.Policy.AuthorizationContext> を使用して `CheckAccess` 実装を呼び出します。  
+  
+2.  `TryGetIdentity` メソッドに次のコードを追加します。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#2)]
+     [!code-vb[c_HowToSetCustomClientIdentity#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#2)]  
+  
+### カスタム バインディングを実装してカスタム ID 検証機能を設定するには  
+  
+1.  <xref:System.ServiceModel.Channels.Binding> オブジェクトを返すメソッドを作成します。  この例は、まず <xref:System.ServiceModel.WSHttpBinding> クラスのインスタンスを作成し、そのセキュリティ モードを <xref:System.ServiceModel.SecurityMode>、<xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType%2A> を <xref:System.ServiceModel.MessageCredentialType> に設定します。  
+  
+2.  <xref:System.ServiceModel.WSHttpBinding.CreateBindingElements%2A> メソッドを使用して <xref:System.ServiceModel.Channels.BindingElementCollection> を作成します。  
+  
+3.  コレクションから <xref:System.ServiceModel.Channels.SecurityBindingElement> を返し、それを <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> 変数にキャストします。  
+  
+4.  <xref:System.ServiceModel.Channels.LocalClientSecuritySettings> クラスの <xref:System.ServiceModel.Channels.LocalClientSecuritySettings.IdentityVerifier%2A> プロパティを、以前作成した `CustomIdentityVerifier` クラスの新しいインスタンスに設定します。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#3)]
+     [!code-vb[c_HowToSetCustomClientIdentity#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#3)]  
+  
+5.  返されたカスタム バインディングを使用してクライアントのインスタンスとクラスを作成します。  これにより、クライアントは、次のコードに示すようにサービスのカスタム ID 検証チェックを実行できるようになります。  
+  
+     [!code-csharp[c_HowToSetCustomClientIdentity#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#4)]
+     [!code-vb[c_HowToSetCustomClientIdentity#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#4)]  
+  
+## 使用例  
+ <xref:System.ServiceModel.Security.IdentityVerifier> クラスの完全な実装方法の例を次に示します。  
+  
+ [!code-csharp[c_HowToSetCustomClientIdentity#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#5)]
+ [!code-vb[c_HowToSetCustomClientIdentity#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#5)]  
+  
+## 使用例  
+ <xref:System.ServiceModel.EndpointIdentity> クラスの完全な実装方法の例を次に示します。  
+  
+ [!code-csharp[c_HowToSetCustomClientIdentity#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosetcustomclientidentity/cs/source.cs#6)]
+ [!code-vb[c_HowToSetCustomClientIdentity#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosetcustomclientidentity/vb/source.vb#6)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>   
+ <xref:System.ServiceModel.EndpointIdentity>   
+ <xref:System.ServiceModel.Security.IdentityVerifier>   
+ [サービス ID サンプル](../../../../docs/framework/wcf/samples/service-identity-sample.md)   
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)   
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-principal-identity.md b/docs/framework/wcf/extending/how-to-create-a-custom-principal-identity.md
new file mode 100644
index 00000000000..9ac9b01f2ff
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-principal-identity.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : カスタム プリンシパル ID を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IAuthorizationPolicy"
+  - "IPrincipal"
+  - "PrincipalPermissionAttribute"
+  - "PrincipalPermissionMode"
+ms.assetid: c4845fca-0ed9-4adf-bbdc-10812be69b61
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : カスタム プリンシパル ID を作成する
+<xref:System.Security.Permissions.PrincipalPermissionAttribute> は、サービス メソッドへのアクセスを宣言によって制御する手段として使用できます。  この属性を使用する場合、承認チェックを実行するためのモードが <xref:System.ServiceModel.Description.PrincipalPermissionMode> 列挙体で指定されます。  このモードが <xref:System.ServiceModel.Description.PrincipalPermissionMode> に設定されている場合、ユーザーは、<xref:System.Threading.Thread.CurrentPrincipal%2A> プロパティから返されるカスタムの <xref:System.Security.Principal.IPrincipal> クラスを指定できます。  ここでは、<xref:System.ServiceModel.Description.PrincipalPermissionMode> を、カスタム承認ポリシーおよびカスタム プリンシパルと組み合わせて使用する場合のシナリオを説明します。  
+  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute> の使用方法の詳細については、「[方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[PrincipalPermissionMode#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/principalpermissionmode/cs/source.cs#8)]
+ [!code-vb[PrincipalPermissionMode#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/principalpermissionmode/vb/source.vb#8)]  
+  
+## コードのコンパイル  
+ このコードをコンパイルするには、次の名前空間へ参照が必要です。  
+  
+-   <xref:System>  
+  
+-   <xref:System.Collections.Generic>  
+  
+-   <xref:System.Security.Permissions>  
+  
+-   <xref:System.Security.Principal>  
+  
+-   <xref:System.Threading>  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.ServiceModel.Channels>  
+  
+-   <xref:System.ServiceModel.Description>  
+  
+-   <xref:System.IdentityModel.Claims>  
+  
+-   <xref:System.IdentityModel.Policy>  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.PrincipalPermissionMode>   
+ <xref:System.ServiceModel.Description.PrincipalPermissionMode>   
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>   
+ [方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)   
+ [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md b/docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md
new file mode 100644
index 00000000000..06ed09b9a05
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : カスタム セキュリティ トークン認証システムを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, 認証"
+ms.assetid: 10e245f7-d31e-42e7-82a2-d5780325d372
+caps.latest.revision: 12
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 12
+---
+# 方法 : カスタム セキュリティ トークン認証システムを作成する
+ここでは、カスタム セキュリティ トークン認証システムの作成方法と、これをカスタム セキュリティ トークン マネージャーに統合する方法を示します。セキュリティ トークン認証システムは受信メッセージと共に提出されるセキュリティ トークンの内容を検証します。検証に成功すると、認証システムは <xref:System.IdentityModel.Policy.IAuthorizationPolicy> インスタンスのコレクションを返します。これが評価されるとクレーム セットが返されます。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でカスタム セキュリティ トークン認証システムを使用するには、カスタム資格情報とセキュリティ トークンマネージャーの実装をあらかじめ作成しておく必要があります。カスタム資格情報とセキュリティ トークン マネージャーの作成の詳細については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。資格情報、セキュリティ トークン マネージャー、およびプロバイダー クラスと認証システム クラスの詳細については、「[Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)」を参照してください。  
+  
+## 手順  
+  
+#### カスタム セキュリティ トークン認証システムを作成するには  
+  
+1.  <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator> クラスから派生する新しいクラスを定義します。  
+  
+2.  <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator.CanValidateTokenCore%2A> メソッドをオーバーライドします。カスタム認証システムが受信トークンの種類を検証できるかどうかによって、メソッドから `true` または `false` が返されます。  
+  
+3.  <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator.ValidateTokenCore%2A> メソッドをオーバーライドします。このメソッドでは、トークンの内容を適切に検証する必要があります。トークンが検証手順をパスすると、<xref:System.IdentityModel.Policy.IAuthorizationPolicy> インスタンスのコレクションが返されます。下記の例では、次の手順で作成するカスタム承認ポリシーの実装を使用します。  
+  
+     [!code-csharp[C_CustomTokenAuthenticator#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenauthenticator/cs/source.cs#1)]
+     [!code-vb[C_CustomTokenAuthenticator#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenauthenticator/vb/source.vb#1)]  
+  
+ 上記のコードでは、<xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator.CanValidateToken%28System.IdentityModel.Tokens.SecurityToken%29> メソッドに承認ポリシーのコレクションが返されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このインターフェイスのパブリックな実装は用意されていません。以下の手順では、これを独自の要件について実行する方法を示します。  
+  
+#### カスタム承認ポリシーを作成するには  
+  
+1.  <xref:System.IdentityModel.Policy.IAuthorizationPolicy> インターフェイスを実装する新しいクラスを定義します。  
+  
+2.  <xref:System.IdentityModel.Policy.IAuthorizationComponent.Id%2A> の読み取り専用プロパティを実装します。このプロパティを実装する方法の 1 つは、クラスのコンストラクターでグローバル一意識別子 \(GUID\) を生成し、この値をプロパティの値が求められるたびに返すことです。  
+  
+3.  <xref:System.IdentityModel.Policy.IAuthorizationPolicy.Issuer%2A> の読み取り専用プロパティを実装します。このプロパティは、トークンから取得されるクレーム セットの発行者を返す必要があります。この発行者は、トークンの発行者、またはトークンの内容を検証する証明機関に対応している必要があります。次の例では、前の手順で作成したカスタム セキュリティ トークン認証システムから、このクラスに渡された発行者クレームを使用します。カスタム セキュリティ トークン認証システムでは、\(<xref:System.IdentityModel.Claims.ClaimSet.System%2A> プロパティから返される\) システム提供のクレーム セットを使用して、ユーザー名トークンの発行者を表します。  
+  
+4.  <xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%2A> メソッドを実装します。このメソッドは \(引数として渡される\) <xref:System.IdentityModel.Policy.EvaluationContext> クラスのインスタンスに、受信セキュリティ トークンの内容に基づいたクレームを設定します。評価が完了したら、メソッドは `true` を返します。実装が、評価コンテキストに追加情報を提供する他の承認ポリシーの存在に依存している場合、必要な情報が評価コンテキスト内に存在していないと、このメソッドは `false` を返します。この場合、承認ポリシーによって評価コンテキストが 1 つでも変更されていると、この受信メッセージのために生成された他のすべての承認ポリシー評価の終了後に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、このメソッドを再び呼び出します。  
+  
+     [!code-csharp[c_CustomTokenAuthenticator#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenauthenticator/cs/source.cs#2)]
+     [!code-vb[c_CustomTokenAuthenticator#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenauthenticator/vb/source.vb#2)]  
+  
+ カスタム資格情報とカスタム セキュリティ トークン マネージャーの作成方法については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。ここで作成したカスタム セキュリティ トークン認証システムを使用するには、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenAuthenticator%2A> メソッドからカスタム認証システムを返すようにセキュリティ トークン マネージャーの実装を変更します。適切なセキュリティ トークン要件が渡されると、このメソッドは認証システムを返します。  
+  
+#### カスタム セキュリティ トークン マネージャーにカスタム セキュリティ トークン認証システムを統合するには  
+  
+1.  カスタム セキュリティ トークン マネージャーの実装の <xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenAuthenticator%2A> メソッドをオーバーライドします。  
+  
+2.  <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> パラメーターに基づいてカスタム セキュリティ トークン認証システムを返すロジックをメソッドに追加します。次の例では、トークン要件のトークンの種類が \(<xref:System.IdentityModel.Tokens.SecurityTokenTypes.UserName%2A> プロパティで表される\) ユーザー名で、セキュリティ トークン認証システムで要求されているメッセージの方向 \(<xref:System.ServiceModel.Description.MessageDirection> フィールドで表される\) が入力である場合、カスタム セキュリティ トークン認証システムが返されます。  
+  
+     [!code-csharp[c_CustomTokenAuthenticator#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenauthenticator/cs/source.cs#3)]
+     [!code-vb[c_CustomTokenAuthenticator#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenauthenticator/vb/source.vb#3)]  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenRequirement>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenManager>   
+ <xref:System.IdentityModel.Tokens.UserNameSecurityToken>   
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)   
+ [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)   
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md b/docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md
new file mode 100644
index 00000000000..f30b17fecaa
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : カスタム セキュリティ トークン プロバイダーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], 資格情報の提供"
+ms.assetid: db8cb478-aa43-478b-bf97-c6489ad7c7fd
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# 方法 : カスタム セキュリティ トークン プロバイダーを作成する
+ここでは、カスタム セキュリティ トークン プロバイダーを持つ新しいトークンの種類を作成する方法と、そのプロバイダーをカスタム セキュリティ トークン マネージャーと統合する方法について説明します。  
+  
+> [!NOTE]
+>  <xref:System.IdentityModel.Tokens> 名前空間にあるシステム指定のトークンがユーザーの要件に一致しない場合、カスタム トークン プロバイダーを作成します。  
+  
+ セキュリティ トークン プロバイダーは、クライアントまたはサービスの資格情報に基づいてセキュリティ トークンの表現を作成します。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティでカスタム セキュリティ トークン プロバイダーを使用するには、カスタム資格情報とセキュリティ トークン マネージャーの実装を作成する必要があります。  
+  
+ カスタム資格情報とセキュリティ トークン マネージャーの詳細については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+ 資格情報、セキュリティ トークン マネージャー、およびプロバイダー クラスと認証システム クラスの詳細については、「[Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)」を参照してください。  
+  
+### カスタム セキュリティ トークン プロバイダーを作成するには  
+  
+1.  <xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスから派生する新しいクラスを定義します。  
+  
+2.  <xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%28System.TimeSpan%29> メソッドを実装します。  このメソッドは、セキュリティ トークンのインスタンスを作成して返す役割を担います。  `MySecurityTokenProvider` という名前のクラスを作成し、<xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%28System.TimeSpan%29> メソッドをオーバーライドして <xref:System.IdentityModel.Tokens.X509SecurityToken> クラスのインスタンスを返す例を次に示します。  クラス コンストラクターには <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> クラスのインスタンスが必要です。  
+  
+     [!code-csharp[c_CustomTokenProvider#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenprovider/cs/source.cs#1)]
+     [!code-vb[c_CustomTokenProvider#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenprovider/vb/source.vb#1)]  
+  
+### カスタム セキュリティ トークン マネージャーにカスタム セキュリティ トークン プロバイダーを統合するには  
+  
+1.  <xref:System.IdentityModel.Selectors.SecurityTokenManager> クラスから派生する新しいクラスを定義します。  以下の例は、<xref:System.IdentityModel.Selectors.SecurityTokenManager> クラスから派生した <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスから派生したクラスです。  
+  
+2.  まだオーバーライドされていない場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenProvider%28System.IdentityModel.Selectors.SecurityTokenRequirement%29> メソッドをオーバーライドします。  
+  
+     <xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenProvider%28System.IdentityModel.Selectors.SecurityTokenRequirement%29> メソッドは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ フレームワークによりメソッドに渡される <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> パラメーターに適した <xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスのインスタンスを返す役割を担います。  メソッドが適切なセキュリティ トークン パラメーターで呼び出された場合に、カスタム セキュリティ トークン プロバイダーの実装 \(以前の手順で作成済み\) を返すようにメソッドを変更します。  セキュリティ トークン マネージャーの詳細については、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+3.  <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> パラメーターに基づいてカスタム セキュリティ トークン プロバイダーを返すカスタム ロジックをメソッドに追加します。  トークンの要件が満たされた場合に、カスタム セキュリティ トークン プロバイダーを返す例を次に示します。  要件には、X.509 セキュリティ トークンとメッセージの方向 \(メッセージ出力にトークンが使用される\) が含まれます。  他のすべての場合で、コードは基本クラスを呼び出し、他のセキュリティ トークンの要件に合わせてシステム指定の動作を維持します。  
+  
+ [!code-csharp[c_CustomTokenProvider#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenprovider/cs/source.cs#2)]
+ [!code-vb[c_CustomTokenProvider#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenprovider/vb/source.vb#2)]  
+  
+## 使用例  
+ 完全な <xref:System.IdentityModel.Selectors.SecurityTokenProvider> 実装と対応する <xref:System.IdentityModel.Selectors.SecurityTokenManager> 実装を次に示します。  
+  
+ [!code-csharp[c_CustomTokenProvider#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtokenprovider/cs/source.cs#0)]
+ [!code-vb[c_CustomTokenProvider#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtokenprovider/vb/source.vb#0)]  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.SecurityTokenProvider>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenRequirement>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenManager>   
+ <xref:System.IdentityModel.Tokens.X509SecurityToken>   
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)   
+ [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)   
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-custom-token.md b/docs/framework/wcf/extending/how-to-create-a-custom-token.md
new file mode 100644
index 00000000000..c1df1ce5bb0
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-custom-token.md
@@ -0,0 +1,172 @@
+---
+title: "方法 : カスタム トークンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], カスタム トークンの作成"
+  - "SecurityToken クラス"
+  - "SecurityTokenParameters クラス"
+  - "WSSecurityTokenSerializer クラス"
+ms.assetid: 6d892973-1558-4115-a9e1-696777776125
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : カスタム トークンを作成する
+ここでは、<xref:System.IdentityModel.Tokens.SecurityToken> を使用してカスタムのセキュリティ トークンを作成する方法と、作成したトークンを、カスタム セキュリティ トークン プロバイダーおよび認証システムと統合する方法について説明します。コード例全体については、「[カスタム トークン](../../../../docs/framework/wcf/samples/custom-token.md)」のサンプルを参照してください。  
+  
+ *"セキュリティ トークン"* とは、基本的に、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティ フレームワークが SOAP メッセージ内の送信者に関するクレームを表すために使用する XML 要素です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティは、システム指定の認証モードで使用するさまざまなトークンを提供します。たとえば、<xref:System.IdentityModel.Tokens.X509SecurityToken> クラスによって表される X.509 証明書セキュリティ トークンや、<xref:System.IdentityModel.Tokens.UserNameSecurityToken> クラスによって表されるユーザー名セキュリティ トークンなどがあります。  
+  
+ 認証モードや資格情報は、指定した種類のトークンではサポートされないことがあります。そのような場合は、SOAP メッセージ内部のカスタム資格情報の XML 表現を提供するカスタム セキュリティ トークンを作成する必要があります。  
+  
+ 以下の手順は、カスタム セキュリティ トークンの作成方法と、これを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャに統合する方法を示しています。ここでは、クライアントのクレジット カードに関する情報をサーバーに渡す際に使用するクレジット カード トークンを作成します。  
+  
+ カスタム資格情報とセキュリティ トークン マネージャー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+ セキュリティ トークンを表すさまざまなクラスについては、「<xref:System.IdentityModel.Tokens> 名前空間」を参照してください。  
+  
+ 資格情報、セキュリティ トークン マネージャー、およびプロバイダー クラスと認証システム クラス[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)」を参照してください。  
+  
+## 手順  
+ クライアント アプリケーションには、セキュリティ インフラストラクチャにクレジット カード情報を指定する方法を設ける必要があります。この情報は、カスタムのクライアント資格情報クラスによりアプリケーションに提供されます。最初に、カスタム クライアント資格情報のクレジット カード情報を表すクラスを作成します。  
+  
+#### クライアント資格情報内のクレジット カード情報を表すクラスを作成するには  
+  
+1.  クレジット カード情報を表す新しいクラスをアプリケーションに定義します。次の例は、`CreditCardInfo` クラスを示しています。  
+  
+2.  適切なプロパティをクラスに追加し、カスタム トークンに必要な情報をアプリケーションで設定できるようにします。次の例では、`CardNumber`、`CardIssuer`、および `ExpirationDate` の 3 つのプロパティをクラスに割り当てます。  
+  
+     [!code-csharp[c_CustomToken#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#4)]
+     [!code-vb[c_CustomToken#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#4)]  
+  
+ 次に、カスタム セキュリティ トークンを表すクラスを作成する必要があります。このクラスは、セキュリティ トークン プロバイダー、認証システム、およびシリアライザーの各クラスが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャとの間で、セキュリティ トークンに関する情報を受け渡しする際に使用します。  
+  
+#### カスタム セキュリティ トークン クラスを作成するには  
+  
+1.  <xref:System.IdentityModel.Tokens.SecurityToken> クラスから派生する新しいクラスを定義します。`CreditCardToken` という名前のクラスを作成する例を次に示します。  
+  
+2.  <xref:System.IdentityModel.Tokens.SecurityToken.Id%2A> プロパティをオーバーライドします。このプロパティを使用して、SOAP メッセージ内の他の要素からセキュリティ トークンの XML 表現をポイントするためのセキュリティ トークンのローカル識別子を取得します。次の例では、トークン識別子をコンストラクター パラメーターとしてこのプロパティに渡すことも、セキュリティ トークン インスタンスを作成するたびに新しいランダムな識別子を生成することもできます。  
+  
+3.  <xref:System.IdentityModel.Tokens.SecurityToken.SecurityKeys%2A> プロパティを実装します。このプロパティは、セキュリティ トークン インスタンスが表すセキュリティ キーのコレクションを返します。これらのキーを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAP メッセージの一部に署名したり、暗号化したりできます。次の例では、クレジット カード セキュリティ トークンにはセキュリティ キーを含めることができません。そのため、実装は、常に空のコレクションを返します。  
+  
+4.  <xref:System.IdentityModel.Tokens.SecurityToken.ValidFrom%2A> プロパティと <xref:System.IdentityModel.Tokens.SecurityToken.ValidTo%2A> プロパティをオーバーライドします。これらのプロパティを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティ トークン インスタンスの有効性を判別します。次の例では、クレジット カード セキュリティ トークンに有効期限のみが含まれているため、`ValidFrom` プロパティは、インスタンスの作成日時を表す <xref:System.DateTime> を返します。  
+  
+     [!code-csharp[c_CustomToken#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#1)]
+     [!code-vb[c_CustomToken#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#1)]  
+  
+ セキュリティ トークンの新しい種類を作成したときは、<xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters> クラスの実装が必要です。この実装をセキュリティ バインド要素構成で使用して、新しいトークンの種類を表します。セキュリティ トークンのパラメーター クラスは、メッセージを処理するときに実際のセキュリティ トークン インスタンスを一致させるためのテンプレートとして使用できます。このテンプレートは、セキュリティ トークンを使用したり、認証したりする際に適合する必要がある条件を指定するためにアプリケーションで使用できる追加のプロパティを提供します。次の例では、追加のプロパティを指定しないため、使用または検証するセキュリティ トークン インスタンスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャが検索するときに、該当するセキュリティ トークンの種類だけが一致項目になります。  
+  
+#### カスタム セキュリティ トークン パラメーター クラスを作成するには  
+  
+1.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters> クラスから派生する新しいクラスを定義します。  
+  
+2.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CloneCore%2A> メソッドを実装します。クラスで内部フィールドが定義されている場合は、それらをすべてコピーします。次の例では、追加のフィールドを定義しません。  
+  
+3.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.SupportsClientAuthentication%2A> の読み取り専用プロパティを実装します。このクラスで表されているセキュリティ トークンの種類を使用して、サービスに対するクライアントの認証が可能な場合、このプロパティは `true` を返します。次の例では、クレジット カード セキュリティ トークンを使用して、サービスに対するクライアントの認証を行うことができます。  
+  
+4.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.SupportsServerAuthentication%2A> の読み取り専用プロパティを実装します。このクラスで表されているセキュリティ トークンの種類を使用して、クライアントに対するサービスの認証が可能な場合、このプロパティは `true` を返します。次の例では、クレジット カード セキュリティ トークンを使用して、クライアントに対するサービスの認証を行うことができません。  
+  
+5.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.SupportsClientWindowsIdentity%2A> の読み取り専用プロパティを実装します。このクラスで表されているセキュリティ トークンの種類を Windows アカウントにマップできる場合、このプロパティは `true` を返します。その場合、認証結果が <xref:System.Security.Principal.WindowsIdentity> クラス インスタンスによって表されます。次の例では、Windows アカウントにトークンをマップすることができません。  
+  
+6.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.CreateKeyIdentifierClause%28System.IdentityModel.Tokens.SecurityToken%2CSystem.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle%29> メソッドを実装します。このメソッドは、セキュリティ トークン パラメーター クラスによって表されるセキュリティ トークン インスタンスへの参照が必要なときに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ フレームワークによって呼び出されます。このメソッドには、実際のセキュリティ トークン インスタンスと、要求されている参照の型を指定する <xref:System.ServiceModel.Security.Tokens.SecurityTokenReferenceStyle> の両方が引数として渡されます。次の例では、内部参照だけがクレジット カード セキュリティ トークンでサポートされます。<xref:System.IdentityModel.Tokens.SecurityToken> クラスは、内部参照を作成する機能を備えているため、実装には追加のコードが必要ありません。  
+  
+7.  <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.InitializeSecurityTokenRequirement%28System.IdentityModel.Selectors.SecurityTokenRequirement%29> メソッドを実装します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、このメソッドを呼び出して、セキュリティ トークン パラメーター クラス インスタンスを <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> クラスのインスタンスに変換します。変換結果は、適切なセキュリティ トークン インスタンスを作成するためにセキュリティ トークン プロバイダーによって使用されます。  
+  
+     [!code-csharp[c_CustomToken#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#2)]
+     [!code-vb[c_CustomToken#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#2)]  
+  
+ セキュリティ トークンは、SOAP メッセージ内で送信されますが、そのためには、セキュリティ トークンのインメモリ表現とネットワーク上表現の間での変換機構が必要です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、セキュリティ トークン シリアライザーを使用してこのタスクを実行します。すべてのカスタム トークンには、カスタム セキュリティ トークンを SOAP メッセージからシリアル化および逆シリアル化できるカスタム セキュリティ トークン シリアライザーを関連付ける必要があります。  
+  
+> [!NOTE]
+>  派生キーは、既定で有効になっています。カスタム セキュリティ トークンを作成し、プライマリ トークンとして使用する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、そのトークンからキーが派生します。キーを派生する一方、カスタム セキュリティ トークン シリアライザーが呼び出され、`DerivedKeyToken` をシリアル化しながら、そのカスタム セキュリティ トークンの <xref:System.IdentityModel.Tokens.SecurityKeyIdentifierClause> をネットワークに送出します。受信側では、ネットワーク外でのトークンの逆シリアル化時に、`DerivedKeyToken` シリアライザーは、トークンのすぐ下のトップレベルの子として `SecurityTokenReference` 要素を必要とします。カスタム セキュリティ トークン シリアライザーによる句型のシリアル化時に `SecurityTokenReference` 要素が追加されていなかった場合、例外がスローされます。  
+  
+#### カスタム セキュリティ トークン シリアライザーを作成するには  
+  
+1.  <xref:System.ServiceModel.Security.WSSecurityTokenSerializer> クラスから派生する新しいクラスを定義します。  
+  
+2.  <xref:System.Xml.XmlReader> に基づいて XML ストリームを読み取る <xref:System.ServiceModel.Security.WSSecurityTokenSerializer.CanReadTokenCore%28System.Xml.XmlReader%29> メソッドをオーバーライドします。シリアライザー実装が現在の要素に基づいてセキュリティ トークンを逆シリアル化できる場合、このメソッドは `true` を返します。次の例では、このメソッドが、XML リーダーの現在の XML 要素が正しい要素名と名前空間を持っているかどうかをチェックします。持っていない場合は、このメソッドの基本クラスの実装を呼び出して、XML 要素を処理します。  
+  
+3.  <xref:System.ServiceModel.Security.WSSecurityTokenSerializer.ReadTokenCore%28System.Xml.XmlReader%2CSystem.IdentityModel.Selectors.SecurityTokenResolver%29> メソッドをオーバーライドします。このメソッドは、セキュリティ トークンの XML コンテンツを読み取り、その適切なメモリ内表現を構築します。渡された XML リーダーの基盤となる XML 要素を認識できない場合は、基本クラスの実装を呼び出して、システム指定のトークンの種類を処理します。  
+  
+4.  <xref:System.ServiceModel.Security.WSSecurityTokenSerializer.CanWriteTokenCore%28System.IdentityModel.Tokens.SecurityToken%29> メソッドをオーバーライドします。引数として渡されるトークンのメモリ内表現を XML 表現に変換できる場合、このメソッドは `true` を返します。変換できない場合は、基本クラスの実装を呼び出します。  
+  
+5.  <xref:System.ServiceModel.Security.WSSecurityTokenSerializer.WriteTokenCore%28System.Xml.XmlWriter%2CSystem.IdentityModel.Tokens.SecurityToken%29> メソッドをオーバーライドします。このメソッドは、セキュリティ トークンのメモリ内表現を XML 表現に変換します。変換できない場合は、基本クラスの実装を呼び出します。  
+  
+     [!code-csharp[c_CustomToken#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#3)]
+     [!code-vb[c_CustomToken#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#3)]  
+  
+ 上記の 4 つの手順を完了したら、カスタム セキュリティ トークンをセキュリティ トークン プロバイダー、セキュリティ トークン認証システム、セキュリティ トークン マネージャー、クライアント資格情報、およびサービス資格情報と統合します。  
+  
+#### カスタム セキュリティ トークンをセキュリティ トークン プロバイダーと統合するには  
+  
+1.  セキュリティ トークン プロバイダーは、必要に応じて、トークンのインスタンスを作成、変更、および返却します。カスタム セキュリティ トークンのカスタム プロバイダーを作成するには、<xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスを継承するクラスを作成します。<xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%2A> メソッドをオーバーライドして、`CreditCardToken` のインスタンスを返す例を次に示します。カスタム セキュリティ トークン プロバイダー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomToken#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#6)]
+     [!code-vb[c_CustomToken#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#6)]  
+  
+#### カスタム セキュリティ トークンをセキュリティ トークン認証システムと統合するには  
+  
+1.  セキュリティ トークン認証システムは、セキュリティ トークンがメッセージから抽出されたときにトークンの内容を検証します。カスタム セキュリティ トークンのカスタム認証システムを作成するには、<xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator> クラスを継承するクラスを作成します。<xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator.ValidateTokenCore%2A> メソッドをオーバーライドする例を次に示します。カスタム セキュリティ トークン認証システム[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomToken#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#7)]
+     [!code-vb[c_CustomToken#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#7)]  
+  
+     [!code-csharp[c_CustomToken#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#12)]
+     [!code-vb[c_CustomToken#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#12)]  
+  
+#### カスタム セキュリティ トークンをセキュリティ トークン マネージャーと統合するには  
+  
+1.  セキュリティ トークン マネージャーは、トークン プロバイダー、セキュリティ認証システム、およびトークン シリアライザーの適切なインスタンスを作成します。カスタム トークン マネージャーを作成するには、<xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスを継承するクラスを作成します。このクラスの主要なメソッドは <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> を使用して、適切なプロバイダーとクライアント資格情報またはサービス資格情報を作成します。カスタム セキュリティ トークン マネージャー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomToken#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#8)]
+     [!code-vb[c_CustomToken#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#8)]  
+  
+     [!code-csharp[c_CustomToken#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#9)]
+     [!code-vb[c_CustomToken#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#9)]  
+  
+#### カスタム セキュリティ トークンをカスタムのクライアント資格情報およびサービス資格情報と統合するには  
+  
+1.  アプリケーションに API を提供し、事前に作成したカスタム セキュリティ トークン インフラストラクチャで、カスタム セキュリティ トークンの内容を提供および認証する際に使用するカスタム トークン情報を指定できるようにするには、カスタムのクライアント資格情報とサービス資格情報を追加する必要があります。この方法を次の例に示します。カスタムのクライアント資格情報とサービス資格情報[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomToken#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#10)]
+     [!code-vb[c_CustomToken#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#10)]  
+  
+     [!code-csharp[c_customToken#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#11)]
+     [!code-vb[c_customToken#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#11)]  
+  
+ 事前に作成したカスタム セキュリティ トークン パラメーター クラスを使用して、サービスとの通信時にカスタム セキュリティ トークンを使用する必要があることを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ フレームワークに伝えます。この方法を次の手順に示します。  
+  
+#### カスタム セキュリティ トークンをバインディングと統合するには  
+  
+1.  <xref:System.ServiceModel.Channels.SecurityBindingElement> クラスで公開されるトークン パラメーター コレクションの 1 つで、カスタム セキュリティ トークン パラメーター クラスを指定する必要があります。次の例では、`SignedEncrypted` によって返されるコレクションを使用します。このコードでは、クライアントからサービスに送信されるすべてのメッセージにクレジット カードのカスタム トークンを追加し、メッセージの内容に自動的に署名して暗号化します。  
+  
+     [!code-csharp[c_CustomToken#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customtoken/cs/source.cs#13)]
+     [!code-vb[c_CustomToken#13](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customtoken/vb/source.vb#13)]  
+  
+ このトピックでは、カスタム トークンを実装および使用するために必要なさまざまなコードを示します。これらのコードを組み合わせた完全な例については、「[カスタム トークン](../../../../docs/framework/wcf/samples/custom-token.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SecurityToken>   
+ <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters>   
+ <xref:System.ServiceModel.Security.WSSecurityTokenSerializer>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenProvider>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator>   
+ <xref:System.IdentityModel.Policy.IAuthorizationPolicy>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenRequirement>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenManager>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ServiceCredentials>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>   
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)   
+ [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)   
+ [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)   
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md b/docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md
new file mode 100644
index 00000000000..d5a6ae5db30
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md
@@ -0,0 +1,137 @@
+---
+title: "方法 : カスタム証明書検証を使用するサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, 認証"
+ms.assetid: bb0190ff-0738-4e54-8d22-c97d343708bf
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : カスタム証明書検証を使用するサービスを作成する
+このトピックでは、カスタム証明書検証を実装する方法、クライアントまたはサービスの資格情報の設定により、既定の証明書検証機能を、カスタム証明書検証で置き換える方法について解説します。  
+  
+ X.509 証明書を使ってクライアントやサービスを認証する場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の既定では、Windows 証明書ストアと Crypto API を使用して証明書が検証され、信頼できるかどうかが確認されます。  ただし、組み込みの検証機能では不十分で、処理内容を変更する必要がある場合もあります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザーがカスタムの証明書検証機能を追加して、検証ロジックを簡単に変更できます。  カスタムの証明書検証機能が指定されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、組み込みの検証機能ではなく、カスタムの検証処理のみが使用されます。  
+  
+## 手順  
+  
+#### カスタムの証明書検証機能を作成するには  
+  
+1.  <xref:System.IdentityModel.Selectors.X509CertificateValidator> から派生する新しいクラスを定義します。  
+  
+2.  抽象メソッドである <xref:System.IdentityModel.Selectors.X509CertificateValidator.Validate%2A> を実装します。  検証対象の証明書が、引数としてこのメソッドに渡されます。  検証処理の結果、証明書が無効であると判断されると、このメソッドは、<xref:System.IdentityModel.Tokens.SecurityTokenValidationException> という例外をスローします。  有効であればそのまま呼び出し元に制御を返します。  
+  
+    > [!NOTE]
+    >  クライアントに認証エラーを返すには、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator.Validate%2A> メソッドで <xref:System.ServiceModel.FaultException> をスローします。  
+  
+ [!code-csharp[c_CustomCertificateValidator#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcertificatevalidator/cs/source.cs#2)]
+ [!code-vb[c_CustomCertificateValidator#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcertificatevalidator/vb/source.vb#2)]  
+  
+#### サービス構成でカスタム検証処理を指定するには  
+  
+1.  [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素に [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素と [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) を追加します。  
+  
+2.  [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)を追加し、`name` 属性に適切な値を設定します。  
+  
+3.  [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)を `<behavior>` 要素に追加します。  
+  
+4.  `<clientCertificate>` 要素を `<serviceCredentials>` 要素に追加します。  
+  
+5.  `<clientCertificate>` 要素に [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md) を追加します。  
+  
+6.  `customCertificateValidatorType` 属性に検証処理の型を設定します。  この属性に型の名前空間と名前を設定する例を以下に示します。  
+  
+7.  `certificateValidationMode` 属性を `Custom` に設定します。  
+  
+    ```  
+    <configuration>  
+     <system.serviceModel>  
+      <behaviors>  
+       <serviceBehaviors>  
+        <behavior name="ServiceBehavior">  
+         <serviceCredentials>  
+          <clientCertificate>  
+          <authentication certificateValidationMode="Custom" customCertificateValidatorType="Samples.MyValidator, service" />  
+          </clientCertificate>  
+         </serviceCredentials>  
+        </behavior>  
+       </serviceBehaviors>  
+      </behaviors>  
+    </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+#### クライアント側の設定でカスタム証明書検証を指定するには  
+  
+1.  [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素に [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素と [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) を追加します。  
+  
+2.  [\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md) 要素を追加します。  
+  
+3.  `<behavior>` 要素を追加し、`name` 属性に適切な値を設定します。  
+  
+4.  [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素を追加します。  
+  
+5.  [\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md) を追加します。  
+  
+6.  次の例に示すように、[\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md) を追加します。  
+  
+7.  `customCertificateValidatorType` 属性に検証処理の型を設定します。  
+  
+8.  `certificateValidationMode` 属性を `Custom` に設定します。  この属性に型の名前空間と名前を設定する例を以下に示します。  
+  
+    ```  
+    <configuration>  
+     <system.serviceModel>  
+      <behaviors>  
+       <endpointBehaviors>  
+        <behavior name="clientBehavior">  
+         <clientCredentials>  
+          <serviceCertificate>  
+           <authentication certificateValidationMode="Custom"   
+                  customCertificateValidatorType=  
+             "Samples.CustomX509CertificateValidator, client"/>  
+          </serviceCertificate>  
+         </clientCredentials>  
+        </behavior>  
+       </endpointBehaviors>  
+      </behaviors>  
+     </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+#### サービス側のコードでカスタム証明書検証を指定するには  
+  
+1.  <xref:System.ServiceModel.Description.ServiceCredentials.ClientCertificate%2A> プロパティの値としてカスタム証明書検証を指定します。  サービスの資格情報には、<xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティを使用してアクセスできます。  
+  
+2.  <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication.CertificateValidationMode%2A> プロパティを <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定します。  
+  
+ [!code-csharp[c_CustomCertificateValidator#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcertificatevalidator/cs/source.cs#1)]
+ [!code-vb[c_CustomCertificateValidator#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcertificatevalidator/vb/source.vb#1)]  
+  
+#### クライアント側のコードでカスタム証明書検証を指定するには  
+  
+1.  カスタム証明書検証を、<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CustomCertificateValidator%2A> プロパティを使って指定します。  クライアントの資格情報には、<xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティを使用してアクセスできます。  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成されるクライアント クラスは、常に <xref:System.ServiceModel.ClientBase%601> クラスから派生したものです。  
+  
+2.  <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CertificateValidationMode%2A> プロパティを <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定します。  
+  
+## 例  
+  
+### 説明  
+ カスタム証明書検証を実装し、サービス側で使用する例を以下に示します。  
+  
+### コード  
+ [!code-csharp[c_CustomCertificateValidator#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcertificatevalidator/cs/source.cs#3)]
+ [!code-vb[c_CustomCertificateValidator#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcertificatevalidator/vb/source.vb#3)]  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.X509CertificateValidator>
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md b/docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md
new file mode 100644
index 00000000000..ce9e02eae78
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : システム指定のバインディングをカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8b97862-e8bb-470d-8b96-07733c21fe26
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 方法 : システム指定のバインディングをカスタマイズする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、システム指定のバインディングがいくつか含まれています。これらのバインディングを使用して、基になるバインド要素の一部のプロパティを構成できますが、すべてのプロパティを構成できるとは限りません。  ここでは、バインド要素のプロパティを設定してカスタム バインディングを作成する方法を示します。  
+  
+ システム指定のバインディングを使用せずに、バインド要素を直接作成し構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+ カスタム バインディングの作成および拡張[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、すべてのバインディングが複数の *"バインド要素"* で構成されています。  各バインド要素は <xref:System.ServiceModel.Channels.BindingElement> クラスから派生します。  <xref:System.ServiceModel.BasicHttpBinding> などのシステム指定のバインディングでは、独自のバインド要素が作成され構成されます。  ここでは、バインディングに直接公開されないこのバインド要素 \(具体的には <xref:System.ServiceModel.BasicHttpBinding> クラス\) のプロパティにアクセスして変更する方法を示します。  
+  
+ 個別のバインド要素は <xref:System.ServiceModel.Channels.BindingElementCollection> クラスで表されるコレクションに格納し、トランザクション フロー、信頼できるセッション、セキュリティ、複合二重、一方向、ストリーム セキュリティ、メッセージ エンコーディング、トランスポートの順に追加します。  どのバインディングでも、これらすべてのバインド要素が必要になるとは限りません。  ユーザー定義のバインド要素も、このバインド要素のコレクションに表示されますが、前述の順序で表示される必要があります。  たとえば、ユーザー定義のトランスポートは、バインド要素コレクションの最後の要素となる必要があります。  
+  
+ <xref:System.ServiceModel.BasicHttpBinding> クラスには、次の 3 つのバインド要素が含まれています。  
+  
+1.  オプションのセキュリティ バインド要素。HTTP トランスポートで使用される <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> クラス \(メッセージ レベル セキュリティ\)、またはトランスポート層がセキュリティを提供する場合 \(HTTPS トランスポート\) に使用される <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>。  
+  
+2.  必須のメッセージ エンコーダー バインド要素。<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> または <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>。  
+  
+3.  必須のトランスポート バインド要素。<xref:System.ServiceModel.Channels.HttpTransportBindingElement> または <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>。  
+  
+ この例では、バインディングのインスタンスを作成し、そのインスタンスから *"カスタム バインディング"* を生成します。次にカスタム バインディング内のバインド要素を調べて HTTP バインド要素が見つかった場合は、その `KeepAliveEnabled` プロパティを `false` に設定します。  `KeepAliveEnabled` プロパティは、`BasicHttpBinding` に直接公開されていないので、カスタム バインディングを作成し、バインド要素まで移動して、このプロパティを設定する必要があります。  
+  
+### システム標準のバインディングを変更するには  
+  
+1.  <xref:System.ServiceModel.BasicHttpBinding> クラスのインスタンスを作成し、そのセキュリティ モードをメッセージ レベルに設定します。  
+  
+     [!code-csharp[C_HowTo_ChangeStandardBinding#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_changestandardbinding/cs/program.cs#1)]
+     [!code-vb[C_HowTo_ChangeStandardBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_changestandardbinding/vb/program.vb#1)]  
+  
+2.  バインディングからカスタム バインディングを作成し、そのカスタム バインディングのプロパティの 1 つから <xref:System.ServiceModel.Channels.BindingElementCollection> クラスを作成します。  
+  
+     [!code-csharp[C_HowTo_ChangeStandardBinding#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_changestandardbinding/cs/program.cs#2)]
+     [!code-vb[C_HowTo_ChangeStandardBinding#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_changestandardbinding/vb/program.vb#2)]  
+  
+3.  <xref:System.ServiceModel.Channels.BindingElementCollection> クラスをループして <xref:System.ServiceModel.Channels.HttpTransportBindingElement> クラスが見つかったら、その <xref:System.ServiceModel.Channels.HttpTransportBindingElement.KeepAliveEnabled%2A> プロパティを `false` に設定します。  
+  
+     [!code-csharp[C_HowTo_ChangeStandardBinding#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_changestandardbinding/cs/program.cs#3)]
+     [!code-vb[C_HowTo_ChangeStandardBinding#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_changestandardbinding/vb/program.vb#3)]  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>   
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-export-custom-policy-assertions.md b/docs/framework/wcf/extending/how-to-export-custom-policy-assertions.md
new file mode 100644
index 00000000000..e179b232e15
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-export-custom-policy-assertions.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : カスタム ポリシー アサーションをエクスポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99030386-43b0-4f7b-866d-17ea307f5cbd
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : カスタム ポリシー アサーションをエクスポートする
+ポリシー アサーションはサービス エンドポイントの機能と要件を説明します。サービス アプリケーションは、サービス メタデータに含まれるカスタム ポリシー アサーションを使用して、エンドポイントのバインディングまたはコントラクトのカスタマイズ情報をクライアント アプリケーションに伝達します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用すると、伝達している機能または要件に応じて、エンドポイント、操作、またはメッセージ サブジェクトで WSDL バインディングに結び付けられているポリシー表現のアサーションをエクスポートできます。  
+  
+ カスタム ポリシー アサーションは、<xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> インターフェイスを <xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName> に実装して、サービス エンドポイントのバインディングにバインド要素を直接挿入するか、またはアプリケーション構成ファイルにバインド要素を登録することによってエクスポートされます。ポリシーのエクスポートの実装では、<xref:System.ServiceModel.Description.IPolicyExportExtension.ExportPolicy%2A> メソッドに渡された <xref:System.ServiceModel.Description.PolicyConversionContext?displayProperty=fullName> の適切な <xref:System.ServiceModel.Description.PolicyAssertionCollection?displayProperty=fullName> に、<xref:System.Xml.XmlElement?displayProperty=fullName> インスタンスとしてカスタム ポリシー アサーションを追加する必要があります。  
+  
+ また、<xref:System.ServiceModel.Description.WsdlExporter> クラスの <xref:System.ServiceModel.Description.MetadataExporter.PolicyVersion%2A> プロパティをチェックし、入れ子になったポリシー表現およびポリシー フレームワーク属性を、指定されたポリシー バージョンに基づいた正しい名前空間にエクスポートする必要もあります。  
+  
+ カスタム ポリシー アサーションをインポートする方法については、「<xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName>」および「[方法 : カスタム ポリシー アサーションをインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md)」を参照してください。  
+  
+### カスタム ポリシー アサーションをエクスポートするには  
+  
+1.  <xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName> に <xref:System.ServiceModel.Description.IPolicyExportExtension?displayProperty=fullName> インターフェイスを実装します。バインディング レベルでのカスタム ポリシー アサーションの実装を次のコード例に示します。  
+  
+     [!code-csharp[CustomPolicySample#14](../../../../samples/snippets/csharp/VS_Snippets_CFX/custompolicysample/cs/policyexporter.cs#14)]
+     [!code-vb[CustomPolicySample#14](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/custompolicysample/vb/policyexporter.vb#14)]  
+  
+2.  プログラムまたはアプリケーション構成ファイルを使用して、エンドポイントのバインディングにバインド要素を挿入します。次の手順を参照してください。  
+  
+### アプリケーション構成ファイルを使用してバインディングを挿入するには  
+  
+1.  カスタム ポリシー アサーション バインド要素の <xref:System.ServiceModel.Configuration.BindingElementExtensionElement?displayProperty=fullName> を実装します。  
+  
+2.  [\<bindingElementExtensions\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindingelementextensions.md) 要素を使用して、そのバインド要素拡張を構成ファイルに追加します。  
+  
+3.  <xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> を使用してカスタム バインディングを作成します。  
+  
+### プログラムでバインド要素を挿入するには  
+  
+1.  新しい <xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName> を作成して <xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> に追加します。  
+  
+2.  手順 1. のカスタム バインディングを新しいエンドポイントに追加し、<xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを呼び出してその新しいサービス エンドポイントを <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> に追加します。  
+  
+3.  <xref:System.ServiceModel.ServiceHost> を開きます。カスタム バインディングの作成と、プログラムによるバインド要素の挿入を次のコード例に示します。  
+  
+     [!code-csharp[s_imperative#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_imperative/cs/service.cs#1)]
+     [!code-vb[s_imperative#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_imperative/vb/service.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.IPolicyImportExtension>   
+ <xref:System.ServiceModel.Description.IPolicyExportExtension>   
+ [方法 : カスタム ポリシー アサーションをインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-export-custom-wsdl.md b/docs/framework/wcf/extending/how-to-export-custom-wsdl.md
new file mode 100644
index 00000000000..29db3b618de
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-export-custom-wsdl.md
@@ -0,0 +1,207 @@
+---
+title: "方法 : カスタム WSDL をエクスポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c1e4b58-b76b-472b-9635-2f80d42a0734
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : カスタム WSDL をエクスポートする
+ここでは、カスタム WSDL 情報をエクスポートする方法について説明します。そのために、サービスによって生成された WSDL にカスタム情報を追加する `WsdlDocumentationAttribute` という名前の新しいコード属性を定義します。  
+  
+### カスタム WSDL 情報をエクスポートするには  
+  
+1.  <xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイスを実装します。このインターフェイスは、<xref:System.ServiceModel.Description.IOperationBehavior>、<xref:System.ServiceModel.Description.IContractBehavior>、または <xref:System.ServiceModel.Description.IEndpointBehavior> インターフェイスを実装するクラスに実装できます。また、<xref:System.ServiceModel.Channels.BindingElement> から派生したクラスに実装することもできます。このサンプルでは、<xref:System.ServiceModel.Description.IContractBehavior> を実装する属性クラスに <xref:System.ServiceModel.Description.IWsdlExportExtension> を実装します。  
+  
+2.  <xref:System.ServiceModel.Description.IWsdlExportExtension> は、<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportEndpoint%28System.ServiceModel.Description.WsdlExporter%2CSystem.ServiceModel.Description.WsdlEndpointConversionContext%29> メソッドと <xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%28System.ServiceModel.Description.WsdlExporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> メソッドを定義します。これらのメソッドを使用すると、<xref:System.ServiceModel.Description.WsdlContractConversionContext> を変更したり、情報を追加したりできます \(変更と追加の両方を行うこともできます\)。このサンプルは、<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%28System.ServiceModel.Description.WsdlExporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> メソッドで <xref:System.ServiceModel.Description.OperationDescription> オブジェクトのコレクションを取得し、そのコレクションを反復処理して `WsdlDocumentationAttribute` が存在するかどうかをチェックします。見つかった場合は、属性に関連付けられたテキストが抽出され、summary 要素が生成され、その summary 要素が操作の `DocumentationElement` に追加されます。  
+  
+    ```  
+            public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)  
+    {  
+                Console.WriteLine("Inside ExportContract");  
+    if (context.Contract != null)  
+    {  
+                    // Set the document element; if this is not done first, there is no XmlElement in the   
+                    // DocumentElement property.  
+                    context.WsdlPortType.Documentation = string.Empty;   
+                    // Contract comments.  
+                    XmlDocument owner = context.WsdlPortType.DocumentationElement.OwnerDocument;  
+                    XmlElement summaryElement = Formatter.CreateSummaryElement(owner, this.Text);   
+                    context.WsdlPortType.DocumentationElement.AppendChild(summaryElement);  
+  
+                    foreach (OperationDescription op in context.Contract.Operations)  
+                    {  
+                        Operation operation = context.GetOperation(op);  
+                        object[] opAttrs = op.SyncMethod.GetCustomAttributes(typeof(WsdlDocumentationAttribute), false);  
+                        if (opAttrs.Length == 1)  
+                        {  
+                            string opComment = ((WsdlDocumentationAttribute)opAttrs[0]).Text;  
+  
+                            // This.Text returns the string for the operation-level attributes.  
+                            // Set the doc element; if this is not done first, there is no XmlElement in the   
+                            // DocumentElement property.  
+                            operation.Documentation = String.Empty;  
+  
+                            XmlDocument opOwner = operation.DocumentationElement.OwnerDocument;  
+                            XmlElement newSummaryElement = Formatter.CreateSummaryElement(opOwner, opComment);  
+                            operation.DocumentationElement.AppendChild(newSummaryElement);  
+                        }  
+                    }  
+                }  
+    ```  
+  
+## 使用例  
+ `WsdlDocumentationAttribute` クラスの完全な実装を次のコード例に示します。  
+  
+```  
+public class WsdlDocumentationAttribute : Attribute, IContractBehavior, IWsdlExportExtension  
+{  
+string text;  
+       XmlElement customWsdlDocElement = null;  
+public WsdlDocumentationAttribute(string text)  
+{ this.text = text;}  
+  
+       public WsdlDocumentationAttribute(XmlElement wsdlDocElement)  
+        { this.customWsdlDocElement = wsdlDocElement; }  
+  
+        public XmlElement WsdlDocElement  
+        {  
+            get { return this.customWsdlDocElement; }  
+            set { this.customWsdlDocElement = value; }  
+        }  
+       public string Text  
+{  
+get { return this.text; }  
+set { this.text = value; }  
+}  
+  
+     public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)  
+{  
+          Console.WriteLine("Inside ExportContract");  
+if (context.Contract != null)  
+{  
+                // Set the document element; if this is not done first, there is no XmlElement in the   
+                // DocumentElement property.  
+                context.WsdlPortType.Documentation = string.Empty;   
+                // Contract comments.  
+                XmlDocument owner = context.WsdlPortType.DocumentationElement.OwnerDocument;  
+                XmlElement summaryElement = Formatter.CreateSummaryElement(owner, this.Text);   
+                context.WsdlPortType.DocumentationElement.AppendChild(summaryElement);  
+  
+                foreach (OperationDescription op in context.Contract.Operations)  
+                {  
+                    Operation operation = context.GetOperation(op);  
+                    object[] opAttrs = op.SyncMethod.GetCustomAttributes(typeof(WsdlDocumentationAttribute), false);  
+                    if (opAttrs.Length == 1)  
+                    {  
+                        string opComment = ((WsdlDocumentationAttribute)opAttrs[0]).Text;  
+  
+                        // This.Text returns the string for the operation-level attributes.  
+                        // Set the document element; if this is not done first, there is no XmlElement in the   
+                        // DocumentElement property.  
+                        operation.Documentation = String.Empty;  
+  
+                        XmlDocument opOwner = operation.DocumentationElement.OwnerDocument;  
+                        XmlElement newSummaryElement = Formatter.CreateSummaryElement(opOwner, opComment);  
+                        operation.DocumentationElement.AppendChild(newSummaryElement);  
+                    }  
+                }  
+            }  
+        }  
+  
+public void ExportEndpoint(WsdlExporter exporter, WsdlEndpointConversionContext context)   
+        {  
+            Console.WriteLine("ExportEndpoint called.");  
+        }  
+  
+        public void AddBindingParameters(ContractDescription description, ServiceEndpoint endpoint, BindingParameterCollection parameters)  
+        { return; }  
+  
+        public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, ClientRuntime client)  
+        { return; }  
+  
+        public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, DispatchRuntime dispatch)  
+        { return; }  
+  
+        public void Validate(ContractDescription description, ServiceEndpoint endpoint) { return; }  
+    }  
+  
+  public class Formatter  
+  {  
+  
+#region Utility Functions  
+  
+    public static XmlElement CreateSummaryElement(XmlDocument owningDoc, string text)  
+    {  
+      XmlElement summaryElement = owningDoc.CreateElement("summary");  
+      summaryElement.InnerText = text;  
+      return summaryElement;  
+    }  
+  
+public static CodeCommentStatementCollection FormatComments(string text)  
+{  
+      /*  
+       * Note that in Visual C# the XML comment format absorbs a   
+       * documentation element with a line break in the middle. This sample  
+       * could take an XmlElement and create code comments in which   
+       * the element never had a line break in it.  
+      */  
+  
+      CodeCommentStatementCollection collection = new CodeCommentStatementCollection();  
+collection.Add(new CodeCommentStatement("From WsdlDocumentation:", true));  
+collection.Add(new CodeCommentStatement(String.Empty, true));  
+  
+foreach (string line in WordWrap(text, 80))  
+{  
+collection.Add(new CodeCommentStatement(line, true));  
+}  
+  
+collection.Add(new CodeCommentStatement(String.Empty, true));  
+return collection;  
+}  
+  
+public static Collection<string> WordWrap(string text, int columnWidth)  
+{  
+Collection<string> lines = new Collection<string>();  
+System.Text.StringBuilder builder = new System.Text.StringBuilder();  
+  
+string[] words = text.Split(' ');  
+foreach (string word in words)  
+{  
+if ((builder.Length > 0) && ((builder.Length + word.Length + 1) > columnWidth))  
+{  
+lines.Add(builder.ToString());  
+builder = new System.Text.StringBuilder();  
+}  
+builder.Append(word);  
+builder.Append(' ');  
+}  
+lines.Add(builder.ToString());  
+  
+return lines;  
+}  
+  
+#endregion    
+  
+    public static XmlElement CreateReturnsElement(XmlDocument owner, string p)  
+    {  
+      XmlElement returnsElement = owner.CreateElement("returns");  
+      returnsElement.InnerText = p;  
+      return returnsElement;  
+    }  
+  }  
+  
+```  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md b/docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md
new file mode 100644
index 00000000000..06c8a79a479
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : カスタム ポリシー アサーションをインポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f41d787-accb-4a10-bfc6-a807671d1581
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : カスタム ポリシー アサーションをインポートする
+ポリシー アサーションはサービス エンドポイントの機能と要件を説明します。  クライアント アプリケーションはサービス メタデータにあるポリシー アサーションを使用して、クライアント バインディングを構成したり、サービス エンドポイントのサービス コントラクトをカスタマイズしたりできます。  
+  
+ 実装することによってカスタム ポリシー アサーションのインポート、 <xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName>インターフェイスとをメタデータ システム、または実装を登録することによって、そのオブジェクトを渡すことが、アプリケーション構成ファイルに入力します。  実装、 <xref:System.ServiceModel.Description.IPolicyImportExtension>インターフェイスは、既定のコンス トラクターを提供する必要があります。  
+  
+### <a name="to-import-custom-policy-assertions"></a>カスタム ポリシー アサーションをインポートするには  
+  
+1.  実装、 <xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName>クラスのインターフェイスです。 次の手順を参照してください。  
+  
+2.  次のいずれかの方法でカスタム ポリシー インポーターを挿入します。  
+  
+3.  構成ファイルを使用します。 次の手順を参照してください。  
+  
+4.  構成ファイルを使用して[ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)します。 次の手順を参照してください。  
+  
+5.  プログラムでポリシー インポーターを挿入します。 次の手順を参照してください。  
+  
+### <a name="to-implement-the-systemservicemodeldescriptionipolicyimportextension-interface-on-any-class"></a>任意のクラスに System.ServiceModel.Description.IPolicyImportExtension インターフェイスを実装するには  
+  
+1.  <xref:System.ServiceModel.Description.IPolicyImportExtension.ImportPolicy%2A?displayProperty=fullName>メソッドで、関心のある対象各ポリシーについてポリシー アサーションを見つけます (するアサーションのスコープに応じて) 適切なメソッドを呼び出して、インポートするには<xref:System.ServiceModel.Description.PolicyConversionContext?displayProperty=fullName>メソッドに渡されるオブジェクト。 次のコード例を使用する方法を示しています、 <xref:System.ServiceModel.Description.PolicyAssertionCollection.Remove%2A?displayProperty=fullName>メソッドは、カスタム ポリシー アサーションの検索を&1; つの手順でコレクションから削除します。 remove メソッドを使用してアサーションの検索と削除を行う場合は、手順 4. を実行する必要はありません。  
+  
+     [!code-csharp[CustomPolicySample#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/custompolicysample/cs/policyimporter.cs#9)]
+     [!code-vb[CustomPolicySample#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/custompolicysample/vb/policyimporter.vb#9)]  
+  
+2.  ポリシー アサーションを処理します。 ポリシー システムでは、入れ子になったポリシーと `wsp:optional` を正規化しないので注意してください。 これらの構造体については、ポリシー インポート拡張機能の実装で処理する必要があります。  
+  
+3.  ポリシー アサーションで指定されている機能または要件をサポートするバインディングまたはコントラクトのカスタマイズを実行します。 アサーションでは、通常、バインディングに特定の構成、または特定のバインド要素が必要です。 アクセスすることによってこの変更を行う、 <xref:System.ServiceModel.Description.PolicyConversionContext.BindingElements%2A?displayProperty=fullName>プロパティです。 これとは別に、コントラクトの変更が必要なアサーションがあります。  アクセスしを使用してコントラクトを変更することができます、 <xref:System.ServiceModel.Description.PolicyConversionContext.Contract%2A?displayProperty=fullName>プロパティです。  ポリシー代替手段のインポートに失敗した場合、バインディングとコントラクトは同じなのに、ポリシー代替手段が異なるために、ポリシー インポーターが複数回呼び出されることがあるので注意してください。 作成するコードでは、この動作に対応する必要があります。  
+  
+4.  アサーション コレクションからカスタム ポリシー アサーションを削除します。 アサーションを削除しない場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、ポリシーのインポートが失敗して、関連付けられているバインディングがインポートされていないと見なします。 使用した場合、 <xref:System.ServiceModel.Description.PolicyAssertionCollection.Remove%2A?displayProperty=fullName>メソッドをカスタム ポリシー アサーションを見つけて、この手順を実行しなくても&1; つの手順でコレクションから削除します。  
+  
+### <a name="to-insert-the-custom-policy-importer-into-the-metadata-system-using-a-configuration-file"></a>構成ファイルを使用してメタデータ システムにカスタム ポリシー インポーターを挿入するには  
+  
+1.  インポーター型を追加、`<extensions>`内の要素、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/policyimporters.md)クライアント構成ファイル内の要素。  
+  
+     [!code[CustomPolicySample#7](../../../../samples/snippets/common/VS_Snippets_CFX/custompolicysample/common/client.exe.config#7)]
+     [!code-csharp[CustomPolicySample#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/custompolicysample/cs/client.exe.config#7)]
+     [!code-vb[CustomPolicySample#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/custompolicysample/vb/client.exe.config#7)]  
+  
+2.  クライアント アプリケーションで使用して、 <xref:System.ServiceModel.Description.MetadataResolver?displayProperty=fullName>または<xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName>を解決するには、メタデータと、インポーターが自動的に呼び出されます。  
+  
+     [!code-csharp[CustomPolicySample#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/custompolicysample/cs/client.cs#10)]
+     [!code-vb[CustomPolicySample#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/custompolicysample/vb/client.vb#10)]  
+  
+### <a name="to-insert-the-custom-policy-importer-into-the-metadata-system-using-svcutilexe"></a>Svcutil.exe を使用してメタデータ システムにカスタム ポリシー インポーターを挿入するには  
+  
+1.  インポーター型を追加、`<extensions>`内の要素、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/policyimporters.md) Svcutil.exe.config 構成ファイル内の要素。 また、`/svcutilConfig` オプションを使用して、異なる構成ファイルに登録されているポリシー インポーター型を読み込むように Svcutil.exe を指定することもできます。  
+  
+2.  使用[ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)メタデータと、インポーターをインポートするのには、自動的に呼び出されます。  
+  
+### <a name="to-insert-the-custom-policy-importer-into-the-metadata-system-programmatically"></a>プログラム使用してメタデータ システムにカスタム ポリシー インポーターを挿入するには  
+  
+1.  インポーターを追加、 <xref:System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions%2A?displayProperty=fullName>プロパティ (を使用している場合など、 <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName>) メタデータをインポートする前にします。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Description.MetadataResolver?displayProperty=fullName>   
+ <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName>   
+ <xref:System.ServiceModel.Description.MetadataResolver?displayProperty=fullName>   
+ [メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-import-custom-wsdl.md b/docs/framework/wcf/extending/how-to-import-custom-wsdl.md
new file mode 100644
index 00000000000..13929ce7a3e
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-import-custom-wsdl.md
@@ -0,0 +1,92 @@
+---
+title: "方法 : カスタム WSDL をインポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ddc3718d-ce60-44f6-92af-a5c67477dd99
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : カスタム WSDL をインポートする
+このトピックでは、カスタム WSDL をインポートする方法について説明します。  カスタム WSDL を処理するには、<xref:System.ServiceModel.Description.IWsdlImportExtension> インターフェイスを実装する必要があります。  
+  
+### カスタム WSDL をインポートするには  
+  
+1.  <xref:System.ServiceModel.Description.IWsdlImportExtension> を実装します。  <xref:System.ServiceModel.Description.IWsdlImportExtension.BeforeImport%28System.Web.Services.Description.ServiceDescriptionCollection%2CSystem.Xml.Schema.XmlSchemaSet%2CSystem.Collections.Generic.ICollection%7BSystem.Xml.XmlElement%7D%29> メソッドを実装してメタデータをインポートする前に変更します。  <xref:System.ServiceModel.Description.IWsdlImportExtension.ImportEndpoint%28System.ServiceModel.Description.WsdlImporter%2CSystem.ServiceModel.Description.WsdlEndpointConversionContext%29> メソッドと <xref:System.ServiceModel.Description.IWsdlImportExtension.ImportContract%28System.ServiceModel.Description.WsdlImporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> メソッドを実装してメタデータからインポートされたコントラクトとエンドポイントを変更します。  インポートしたコントラクトまたはエンドポイントにアクセスするには、対応するコンテキスト オブジェクト \(<xref:System.ServiceModel.Description.WsdlContractConversionContext> または <xref:System.ServiceModel.Description.WsdlEndpointConversionContext>\) を使用します。  
+  
+    ```  
+    public class WsdlDocumentationImporter : IWsdlImportExtension  
+       {  
+          public void ImportContract(WsdlImporter importer, WsdlContractConversionContext context)  
+    {  
+            // Contract documentation  
+         if (context.WsdlPortType.Documentation != null)  
+         {  
+               context.Contract.Behaviors.Add(new WsdlDocumentationImporter(context.WsdlPortType.Documentation));  
+    }  
+    // Operation documentation  
+    foreach (Operation operation in context.WsdlPortType.Operations)  
+    {  
+    if (operation.Documentation != null)  
+    {  
+    OperationDescription operationDescription = context.Contract.Operations.Find(operation.Name);  
+    if (operationDescription != null)  
+    {  
+                            operationDescription.Behaviors.Add(new WsdlDocumentationImporter(operation.Documentation));  
+    }  
+    }  
+    }  
+    }  
+  
+    public void BeforeImport(ServiceDescriptionCollection wsdlDocuments, XmlSchemaSet xmlSchemas, ICollection<XmlElement> policy)   
+            {  
+                Console.WriteLine("BeforeImport called.");  
+            }  
+  
+    public void ImportEndpoint(WsdlImporter importer, WsdlEndpointConversionContext context)   
+            {  
+                Console.WriteLine("ImportEndpoint called.");  
+            }  
+       }  
+    ```  
+  
+2.  カスタム WSDL インポーターを使用するようクライアント アプリケーションを構成します。  Svcutil.exe を使用する場合は、Svcutil.exe の構成ファイル \(Svcutil.exe.config\) にこの構成を追加する必要があります。  
+  
+    ```  
+    <system.serviceModel>  
+          <client>  
+            <endpoint   
+              address="http://localhost:8000/Fibonacci"   
+              binding="wsHttpBinding"  
+              contract="IFibonacci"  
+            />  
+            <metadata>  
+              <wsdlImporters>  
+                <extension type="Microsoft.WCF.Documentation.WsdlDocumentationImporter, WsdlDocumentation" />  
+              </wsdlImporters>  
+            </metadata>  
+          </client>  
+        </system.serviceModel>  
+  
+    ```  
+  
+3.  新しい <xref:System.ServiceModel.Description.WsdlImporter> インスタンス \(インポートする WSDL ドキュメントが含まれる <xref:System.ServiceModel.Description.MetadataSet> インスタンスを渡す\) を作成し、<xref:System.ServiceModel.Description.WsdlImporter.ImportAllContracts%2A> を呼び出します。  
+  
+    ```  
+    WsdlImporter importer = new WsdlImporter(metaDocs);          System.Collections.ObjectModel.Collection<ContractDescription> contracts  = importer.ImportAllContracts();  
+  
+    ```  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)   
+ [カスタム WSDL パブリケーション](../../../../docs/framework/wcf/samples/custom-wsdl-publication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-inspect-and-modify-messages-on-the-service.md b/docs/framework/wcf/extending/how-to-inspect-and-modify-messages-on-the-service.md
new file mode 100644
index 00000000000..a0d5e952ff4
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-inspect-and-modify-messages-on-the-service.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : サービスのメッセージを検査および変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9c5b1cc7-84f3-45f8-9226-d59c278e8c42
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : サービスのメッセージを検査および変更する
+検査またはを介して受信または送信メッセージを変更できる、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]クライアントを実装することによって、 <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector?displayProperty=fullName>をサービス ランタイムに挿入します。 詳細については、次を参照してください。[ディスパッチャーの拡張](../../../../docs/framework/wcf/extending/extending-dispatchers.md)します。 サービスの同等の機能は、 <xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName>します。  
+  
+### <a name="to-inspect-or-modify-messages"></a>メッセージを検査または変更するには  
+  
+1.  実装、 <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector?displayProperty=fullName>インターフェイスです。  
+  
+2.  実装、 <xref:System.ServiceModel.Description.IServiceBehavior?displayProperty=fullName>、 <xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName>、または<xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName>インターフェイス サービス メッセージ インスペクターを容易に挿入するスコープによって異なります。  
+  
+3.  呼び出しの前に、動作を挿入、 <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName>メソッドを<xref:System.ServiceModel.ServiceHost?displayProperty=fullName>します。 詳細については、「[の構成と動作を使用したランタイムの拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)します。  
+  
+## <a name="example"></a>例  
+ 下のコード例では、次の項目を順番に示しています。  
+  
+-   サービス インスペクターの実装  
+  
+-   インスペクターを挿入するサービス動作  
+  
+-   サービス アプリケーションに動作を読み込んで実行する構成ファイル  
+  
+ [!code-csharp[Interceptors#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/interceptors.cs#7)]
+ [!code-vb[Interceptors#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/interceptors.vb#7)]  
+  
+ [!code-csharp[Interceptors#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/insertingbehaviors.cs#8)]
+ [!code-vb[Interceptors#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/insertingbehaviors.vb#8)]  
+  
+ [!code[Interceptors#9](../../../../samples/snippets/common/VS_Snippets_CFX/interceptors/common/hostapplication.exe.config#9)]
+ [!code-csharp[Interceptors#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/hostapplication.exe.config#9)]
+ [!code-vb[Interceptors#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/hostapplication.exe.config#9)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName>   
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector?displayProperty=fullName>   
+ [構成と動作を使用したランタイムの拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md b/docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md
new file mode 100644
index 00000000000..92cdbd10eba
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-inspect-or-modify-messages-on-the-client.md
@@ -0,0 +1,141 @@
+---
+title: "方法 : クライアントのメッセージを検査または変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8256335-f1c2-419f-b862-9f220ccad84c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : クライアントのメッセージを検査または変更する
+<xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName> を実装し、それをクライアントのランタイムに追加することで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの送受信メッセージを検査または変更できます。  詳細については、「[クライアントの拡張](../../../../docs/framework/wcf/extending/extending-clients.md)」を参照してください。  サービスの同等の機能は、<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector?displayProperty=fullName> です。  コード例全体については、「[メッセージ インスペクター](../../../../docs/framework/wcf/samples/message-inspectors.md)」のサンプルを参照してください。  
+  
+### メッセージを検査または変更するには  
+  
+1.  <xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName> インターフェイスを実装します。  
+  
+2.  クライアント メッセージ インスペクターを挿入するスコープに応じて、<xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName> または <xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName> を実装します。  <xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName> を使用すると、エンドポイント レベルで動作を変更できます。  <xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName> を使用すると、コントラクト レベルで動作を変更できます。  
+  
+3.  <xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName> で <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName> メソッドまたは <xref:System.ServiceModel.ClientBase%601.Open%2A?displayProperty=fullName> メソッドを呼び出す前に、動作を追加します。  詳細については、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  
+  
+## 使用例  
+ 下のコード例では、次の項目を順番に示しています。  
+  
+-   クライアント インスペクター実装  
+  
+-   インスペクターを挿入するエンドポイント動作  
+  
+-   構成ファイルで動作を追加できるようにする <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> 派生クラス。  
+  
+-   クライアント メッセージ インスペクターをクライアント ランタイムに挿入するエンドポイント動作を追加する構成ファイル。  
+  
+```csharp  
+// Client message inspector  
+public class SimpleMessageInspector : IClientMessageInspector  
+{  
+    public void AfterReceiveReply(ref System.ServiceModel.Channels.Message reply, object correlationState)  
+    {  
+        // Implement this method to inspect/modify messages after a message  
+        // is received but prior to passing it back to the client   
+        Console.WriteLine("AfterReceiveReply called");  
+    }  
+  
+    public object BeforeSendRequest(ref System.ServiceModel.Channels.Message request, IClientChannel channel)  
+    {  
+        // Implement this method to inspect/modify messages before they   
+        // are sent to the service  
+        Console.WriteLine("BeforeSendRequest called");  
+        return null;  
+    }  
+}  
+  
+```  
+  
+```csharp  
+// Endpoint behavior  
+public class SimpleEndpointBehavior : IEndpointBehavior  
+{  
+    public void AddBindingParameters(ServiceEndpoint endpoint, System.ServiceModel.Channels.BindingParameterCollection bindingParameters)  
+    {  
+         // No implementation necessary  
+    }  
+  
+    public void ApplyClientBehavior(ServiceEndpoint endpoint, ClientRuntime clientRuntime)  
+    {  
+        clientRuntime.MessageInspectors.Add(new SimpleMessageInspector());  
+    }  
+  
+    public void ApplyDispatchBehavior(ServiceEndpoint endpoint, EndpointDispatcher endpointDispatcher)  
+    {  
+         // No implementation necessary  
+    }  
+  
+    public void Validate(ServiceEndpoint endpoint)  
+    {  
+         // No implementation necessary  
+    }  
+}  
+```  
+  
+```csharp  
+// Configuration element   
+public class SimpleBehaviorExtensionElement : BehaviorExtensionElement  
+{  
+    public override Type BehaviorType  
+    {  
+        get { return typeof(SimpleEndpointBehavior); }  
+    }  
+  
+    protected override object CreateBehavior()  
+    {  
+         // Create the  endpoint behavior that will insert the message  
+         // inspector into the client runtime  
+        return new SimpleEndpointBehavior();  
+    }  
+}  
+  
+```  
+  
+```vb  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+    <system.serviceModel>  
+        <client>  
+            <endpoint address="http://localhost:8080/SimpleService/"   
+                      binding="wsHttpBinding"  
+                      contract="ServiceReference1.IService1"  
+                      name="WSHttpBinding_IService1"/>  
+        </client>  
+  
+      <behaviors>  
+        <endpointBehaviors>  
+          <behavior name="clientInspectorsAdded">  
+            <simpleBehaviorExtension />  
+          </behavior>  
+        </endpointBehaviors>  
+      </behaviors>  
+      <extensions>  
+        <behaviorExtensions>  
+          <add  
+            name="simpleBehaviorExtension"  
+            type="SimpleServiceLib.SimpleBehaviorExtensionElement, Host, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null"/>  
+        </behaviorExtensions>  
+      </extensions>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageInspector?displayProperty=fullName>   
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector?displayProperty=fullName>   
+ [動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md b/docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md
new file mode 100644
index 00000000000..8070f84e854
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-inspect-or-modify-parameters.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : パラメーターを検査または変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab6c0ac7-aac4-45ba-93d6-a0e9afd1756f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : パラメーターを検査または変更する
+検査またはに&1; 回の操作の受信または送信メッセージを変更することができます、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]クライアント オブジェクトまたは[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]実装することによってサービス、 <xref:System.ServiceModel.Dispatcher.IParameterInspector?displayProperty=fullName>インターフェイスとそれをクライアントまたはサービス ランタイムに挿入します。 通常、操作の動作は、1 回の操作に対してパラメーター インスペクターを追加するために使用します。他の動作は、広い範囲でランタイムへの簡単なアクセスを提供するために使用できます。 詳細については、次を参照してください。[を拡張するクライアント](../../../../docs/framework/wcf/extending/extending-clients.md)と[ディスパッチャーの拡張](../../../../docs/framework/wcf/extending/extending-dispatchers.md)します。  
+  
+### <a name="inspecting-or-modifying-parameters"></a>パラメーターの検査と変更  
+  
+1.  実装、 <xref:System.ServiceModel.Dispatcher.IParameterInspector?displayProperty=fullName>インターフェイスです。  
+  
+2.  実装、 <xref:System.ServiceModel.Description.IOperationBehavior?displayProperty=fullName>、 <xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName>、 <xref:System.ServiceModel.Description.IServiceBehavior?displayProperty=fullName>または<xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName>(要求されるスコープに応じて) するか、パラメーター インスペクターを追加する、 <xref:System.ServiceModel.Dispatcher.ClientOperation.ParameterInspectors%2A?displayProperty=fullName>または<xref:System.ServiceModel.Dispatcher.DispatchOperation.ParameterInspectors%2A?displayProperty=fullName>プロパティです。  
+  
+3.  呼び出しの前に、動作を挿入<xref:System.ServiceModel.ClientBase%601.Open%2A?displayProperty=fullName>または<xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName>メソッドを<xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName>します。 詳細については、「[の構成と動作を使用したランタイムの拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)します。  
+  
+## <a name="example"></a>例  
+ 下のコード例では、次の項目を順番に示しています。  
+  
+-   パラメーター インスペクターの実装  
+  
+-   使用してパラメーター インスペクターを挿入する動作実装、 <xref:System.ServiceModel.Description.IOperationBehavior?displayProperty=fullName>、 <xref:System.ServiceModel.Description.IEndpointBehavior?displayProperty=fullName>、および<xref:System.ServiceModel.Description.IServiceBehavior?displayProperty=fullName>します。  
+  
+-   クライアント上にパラメーター インスペクターを挿入するために、クライアント アプリケーションでエンドポイント動作を読み込み、実行する構成ファイル  
+  
+ [!code-csharp[Interceptors#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/interceptors.cs#4)]
+ [!code-vb[Interceptors#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/interceptors.vb#4)]  
+  
+ [!code-csharp[Interceptors#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/insertingbehaviors.cs#5)]
+ [!code-vb[Interceptors#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/insertingbehaviors.vb#5)]  
+  
+ [!code[Interceptors#3](../../../../samples/snippets/common/VS_Snippets_CFX/interceptors/common/client.exe.config#3)]
+ [!code-csharp[Interceptors#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/interceptors/cs/client.exe.config#3)]
+ [!code-vb[Interceptors#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/interceptors/vb/client.exe.config#3)]  
+  
+## <a name="see-also"></a>関連項目  
+ [構成と動作を使用したランタイムの拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md b/docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md
new file mode 100644
index 00000000000..0dea788a535
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : 企業内のエンドポイントをロックダウンする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b7eaab7-da60-4cf7-9d6a-ec02709cf75d
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 方法 : 企業内のエンドポイントをロックダウンする
+大規模な企業では、多くの場合、企業のセキュリティ ポリシーに準拠してアプリケーションを開発する必要があります。  ここでは、コンピューターにインストールされているすべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションを検証できるクライアント エンドポイント検証を開発してインストールする方法を説明します。  
+  
+ この場合、このエンドポイント動作は machine.config ファイルのクライアントの [\<commonBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md) セクションに追加されるため、検証コントロールはクライアント検証コントロールです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、クライアント アプリケーションだけを対象に共通のエンドポイント動作を読み込み、サービス アプリケーションだけを対象に共通のサービス動作を読み込みます。  サービス アプリケーション用のこの同じ検証コントロールをインストールするには、検証コントロールがサービス動作であることが必要です。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [\<commonBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md) セクション。  
+  
+> [!IMPORTANT]
+>  アプリケーションが部分信頼環境で実行されている場合、構成ファイルの [\<commonBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md) セクションに追加された <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性 \(APTCA\) でマークされていないサービス動作またはエンドポイント動作は実行されません。また、そのようになっても例外はスローされません。  検証コントロールなどの共通動作を強制的に実行するには、次のいずれかを行う必要があります。  
+>   
+>  \-\- 共通動作を <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性でマークし、部分信頼アプリケーションとして展開したときに実行できるようにします。  APTCA でマークされたアセンブリを実行できないように、コンピューターでレジストリ エントリを設定できます。  
+>   
+>  \-\- アプリケーションが完全信頼アプリケーションとして配置されている場合に、ユーザーが部分信頼環境でアプリケーションを実行するようにコード アクセス セキュリティ設定を変更できないことを確認します。  ユーザーがこのような変更を行うことができる場合、カスタム検証コントロールは実行されず、例外もスローされません。  これを確認する方法については、「[コード アクセス セキュリティ ポリシー ツール \(Caspol.exe\)](http://go.microsoft.com/fwlink/?LinkId=248222)」の `levelfinal` オプションを参照してください。  
+>   
+>  詳細については、「[部分信頼のベスト プラクティス](../../../../docs/framework/wcf/feature-details/partial-trust-best-practices.md)」および「[サポートされている配置シナリオ](../../../../docs/framework/wcf/feature-details/supported-deployment-scenarios.md)」を参照してください。  
+  
+### エンドポイント検証コントロールを作成するには  
+  
+1.  <xref:System.ServiceModel.Description.IEndpointBehavior> メソッドに、必要な検証手順を備えた <xref:System.ServiceModel.Description.IEndpointBehavior.Validate%2A> を作成します。  次にコード例を示します。  \(`InternetClientValidatorBehavior` は[セキュリティ検証](../../../../docs/framework/wcf/samples/security-validation.md)のサンプルから取得したものです。\)  
+  
+     [!code-csharp[LockdownValidation#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/internetclientvalidatorbehavior.cs#2)]  
+  
+2.  手順 1. で作成したエンドポイント検証コントロールを登録する新しい <xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を作成します。  このコード例を次に示します。  \(この例の元のコードは、「[セキュリティ検証](../../../../docs/framework/wcf/samples/security-validation.md)」のサンプルにあります。\)  
+  
+     [!code-csharp[LockdownValidation#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/internetclientvalidatorelement.cs#3)]  
+  
+3.  コンパイル済みのアセンブリが厳密な名前で署名されていることを確認します。  詳細については、「[Sn.exe \(厳密名ツール\)](http://go.microsoft.com/fwlink/?LinkId=248217)」およびご使用の言語のコンパイラ コマンドを参照してください。  
+  
+### 検証コントロールをターゲット コンピューターにインストールには  
+  
+1.  適切な機構を使用してエンドポイント検証をインストールします。  企業では、グループ ポリシーと Systems Management Server \(SMS\) を使用してインストールします。  
+  
+2.  [Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](http://msdn.microsoft.com/library/ex0ss12c\(v=vs.110\).aspx)を使用して、厳密な名前のアセンブリをグローバル アセンブリ キャッシュにインストールします。  
+  
+3.  <xref:System.Configuration?displayProperty=fullName> 名前空間の型を使用して、次の処理を行います。  
+  
+    1.  完全修飾型名を使用して [\<behaviorExtensions\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviorextensions.md) セクションに拡張を追加し、要素をロックします。  
+  
+         [!code-csharp[LockdownValidation#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/hostapplication.cs#5)]  
+  
+    2.  動作要素を [\<commonBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md) セクションの `EndpointBehaviors` プロパティに追加して要素をロックします。  \(サービスの検証コントロールをインストールするには、検証コントロールが <xref:System.ServiceModel.Description.IServiceBehavior> であることが必要です。また、検証コントロールを `ServiceBehaviors` プロパティに追加する必要があります\)。 次のコード例は、手順 a.  と b. の後の適切な構成を示しています。厳密な名前が存在しない点だけが異なります。  
+  
+         [!code-csharp[LockdownValidation#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/hostapplication.cs#6)]  
+  
+    3.  machine.config ファイルを保存します。  次のコード例では、手順 3. にあるすべてのタスクを実行しますが、変更された machine.config ファイルのコピーはローカルに保存されます。  
+  
+         [!code-csharp[LockdownValidation#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/hostapplication.cs#7)]  
+  
+## 使用例  
+ 次のコード例では、machine.config ファイルに共通の動作を追加し、そのコピーをディスクに保存する方法を示します。  `InternetClientValidatorBehavior` は[セキュリティ検証](../../../../docs/framework/wcf/samples/security-validation.md)のサンプルから取得したものです。  
+  
+ [!code-csharp[LockdownValidation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/lockdownvalidation/cs/hostapplication.cs#1)]  
+  
+## .NET Framework セキュリティ  
+ また、構成ファイルの要素を暗号化する必要がある場合もあります。  詳細については、「参照」を参照してください。  
+  
+## 参照  
+ [How To: DPAPI を使用して ASP.NET 2.0 内の構成セクションを暗号化する方法](http://go.microsoft.com/fwlink/?LinkId=94954)   
+ [How To: RSA を使用して ASP.NET 2.0 内の構成セクションを暗号化する方法](http://go.microsoft.com/fwlink/?LinkId=94955)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md b/docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md
new file mode 100644
index 00000000000..4e0087a4fa0
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md
@@ -0,0 +1,134 @@
+---
+title: "方法: MEX 以外のバインディングを介してメタデータを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2292e124-81b2-4317-b881-ce9c1ec66ecb
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 方法: MEX 以外のバインディングを介してメタデータを取得する
+ここでは、MEX 以外のバインディングを介して MEX エンドポイントからメタデータを取得する方法を説明します。このサンプル コードは、[カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md) のサンプルに基づいています。  
+  
+### MEX 以外のバインディングを介してメタデータを取得するには  
+  
+1.  MEX エンドポイントで使用されているバインディングを特定します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの場合、サービスの構成ファイルにアクセスすることで MEX バインディングを特定できます。この場合、MEX バインディングは、次のサービス構成で定義されています。  
+  
+    ```  
+    <services>  
+        <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+                behaviorConfiguration="CalculatorServiceBehavior">  
+         <!-- Use the base address provided by the host. -->  
+         <endpoint address=""  
+           binding="wsHttpBinding"  
+           bindingConfiguration="Binding2"  
+           contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+         <endpoint address="mex"  
+           binding="wsHttpBinding"  
+           bindingConfiguration="Binding1"  
+           contract="IMetadataExchange" />  
+         </service>  
+     </services>  
+     <bindings>  
+       <wsHttpBinding>  
+         <binding name="Binding1">  
+           <security mode="Message">  
+             <message clientCredentialType="Certificate" />  
+           </security>  
+         </binding>  
+         <binding name="Binding2">  
+           <reliableSession inactivityTimeout="00:01:00" enabled="true" />  
+           <security mode="Message">  
+             <message clientCredentialType="Certificate" />  
+           </security>  
+         </binding>  
+       </wsHttpBinding>  
+     </bindings>  
+    ```  
+  
+2.  クライアント構成ファイルで、同じカスタム バインディングを構成します。ここでクライアントは `clientCredentials` 動作も定義して、MEX エンドポイントからメタデータを要求するときに、サービスに対する認証で使用する証明書を指定します。カスタム バインディングを介してメタデータを要求するときに Svcutil.exe を使用する場合は、Svcutil.exe の構成ファイル \(Svcutil.exe.config\) に MEX エンドポイント構成を追加する必要があります。また、エンドポイント構成の名前が、次のコードに示すように、MEX エンドポイントのアドレスの URI スキームと一致する必要があります。  
+  
+    ```  
+    <system.serviceModel>  
+      <client>  
+        <endpoint name="http"  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="Binding1"  
+                  behaviorConfiguration="ClientCertificateBehavior"  
+                  contract="IMetadataExchange" />  
+      </client>  
+      <bindings>  
+        <wsHttpBinding>  
+          <binding name="Binding1">  
+            <security mode="Message">  
+              <message clientCredentialType="Certificate"/>  
+            </security>  
+          </binding>  
+        </wsHttpBinding>  
+      </bindings>  
+      <behaviors>  
+        <endpointBehaviors>  
+          <behavior name="ClientCertificateBehavior">  
+            <clientCredentials>  
+              <clientCertificate findValue="client.com" storeLocation="CurrentUser" storeName="My" x509FindType="FindBySubjectName" />  
+              <serviceCertificate>  
+                <authentication certificateValidationMode="PeerOrChainTrust" />  
+              </serviceCertificate>  
+            </clientCredentials>  
+          </behavior>  
+        </endpointBehaviors>  
+      </behaviors>    
+    </system.serviceModel>  
+    ```  
+  
+3.  `MetadataExchangeClient` を作成して `GetMetadata` を呼び出します。これを行うには、次の例に示すように、構成でカスタム バインディングを指定する方法と、コードでカスタム バインディングを指定する方法の 2 つの方法があります。  
+  
+    ```  
+    // The custom binding is specified in configuration.  
+    EndpointAddress mexAddress = new EndpointAddress("http://localhost:8000/ServiceModelSamples/Service/mex");  
+  
+    MetadataExchangeClient mexClient = new MetadataExchangeClient("http");  
+    mexClient.ResolveMetadataReferences = true;  
+    MetadataSet mexSet = mexClient.GetMetadata(mexAddress);  
+  
+    // The custom binding is specified in code.  
+    // Specify the Metadata Exchange binding and its security mode.  
+    WSHttpBinding mexBinding = new WSHttpBinding(SecurityMode.Message);  
+    mexBinding.Security.Message.ClientCredentialType = MessageCredentialType.Certificate;  
+  
+    // Create a MetadataExchangeClient and set the certificate details.  
+    MetadataExchangeClient mexClient = new MetadataExchangeClient(mexBinding);  
+    mexClient.SoapCredentials.ClientCertificate.SetCertificate(  
+        StoreLocation.CurrentUser, StoreName.My,  
+        X509FindType.FindBySubjectName, "client.com");  
+    mexClient.SoapCredentials.ServiceCertificate.Authentication.  
+        CertificateValidationMode =  
+        X509CertificateValidationMode.PeerOrChainTrust;  
+    mexClient.SoapCredentials.ServiceCertificate.SetDefaultCertificate(  
+        StoreLocation.CurrentUser, StoreName.TrustedPeople,  
+        X509FindType.FindBySubjectName, "localhost");  
+    MetadataExchangeClient mexClient2 = new MetadataExchangeClient(customBinding);  
+    mexClient2.ResolveMetadataReferences = true;  
+    MetadataSet mexSet2 = mexClient2.GetMetadata(mexAddress);  
+    ```  
+  
+4.  次のコードに示すように、`WsdlImporter` を作成して `ImportAllEndpoints` を呼び出します。  
+  
+    ```  
+    WsdlImporter importer = new WsdlImporter(mexSet);  
+    ServiceEndpointCollection endpoints = importer.ImportAllEndpoints();  
+    ```  
+  
+5.  この時点で、サービス エンドポイントのコレクションが取得されます。メタデータのインポート[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : メタデータをサービス エンドポイントにインポートする](../../../../docs/framework/wcf/feature-details/how-to-import-metadata-into-service-endpoints.md)」を参照してください。  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-use-separate-x-509-certificates-for-signing-and-encryption.md b/docs/framework/wcf/extending/how-to-use-separate-x-509-certificates-for-signing-and-encryption.md
new file mode 100644
index 00000000000..ed51929c146
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-use-separate-x-509-certificates-for-signing-and-encryption.md
@@ -0,0 +1,102 @@
+---
+title: "方法 : 署名および暗号化に個別の X.509 証明書を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ClientCredentials クラス"
+  - "ClientCredentialsSecurityTokenManager クラス"
+  - "WCF, 拡張機能"
+ms.assetid: 0b06ce4e-7835-4d82-8baf-d525c71a0e49
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : 署名および暗号化に個別の X.509 証明書を使用する
+ここでは、クライアントとサービスの両方においてメッセージの署名と暗号化とで別の証明書を使用するように [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を構成する方法を示します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では複数のクライアント証明書またはサービス証明書を設定する API が提供されていないため、署名と暗号化で別の証明書を使用できるようにするには、カスタム クライアント資格情報またはカスタム サービス資格情報 \(あるいはその両方\) を作成する必要があります。さらに、複数の証明書の情報を利用し、指定されたキーの使用方法やメッセージの方向について適切なセキュリティ トークン プロバイダーを作成するために、セキュリティ トークン マネージャーを用意する必要があります。  
+  
+ 使用される主要なクラス、そのクラスの継承元のクラス \(上向きの矢印で表示\)、および特定のメソッドおよびプロパティの戻り値の型を次の図に示します。  
+  
+-   `MyClientCredentials` は、<xref:System.ServiceModel.Description.ClientCredentials> のカスタム実装です。  
+  
+    -   図に示されたすべてのプロパティは、すべて <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> のインスタンスを返します。  
+  
+    -   メソッド <xref:System.ServiceModel.Description.ClientCredentials.CreateSecurityTokenManager%2A> は、`MyClientCredentialsSecurityTokenManager` のインスタンスを返します。  
+  
+-   `MyClientCredentialsSecurityTokenManager` は、<xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> のカスタム実装です。  
+  
+    -   メソッド <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager.CreateSecurityTokenProvider%2A> は、<xref:System.IdentityModel.Selectors.X509SecurityTokenProvider> のインスタンスを返します。  
+  
+ ![クライアント資格情報がどのように使用されるのかを示す図](../../../../docs/framework/wcf/extending/media/e4971edd-a59f-4571-b36f-7e6b2f0d610f.gif "e4971edd\-a59f\-4571\-b36f\-7e6b2f0d610f")  
+  
+ カスタム資格情報[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)」を参照してください。  
+  
+ また、カスタム ID 検証機能を作成し、カスタム バインディングのセキュリティ バインド要素にリンクする必要があります。さらに、既定の資格情報の代わりにカスタム資格情報を使用する必要があります。  
+  
+ カスタム バインディングに関連したクラス、およびカスタム ID 検証機能のリンク方法を次の図に示します。関連するバインド要素はいくつかありますが、そのすべてが <xref:System.ServiceModel.Channels.BindingElement> から継承されています。<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> には、<xref:System.ServiceModel.Channels.LocalClientSecuritySettings> プロパティがあります。このプロパティは、`MyIdentityVerifier` のカスタマイズの元となる <xref:System.ServiceModel.Security.IdentityVerifier> のインスタンスを返します。  
+  
+ ![カスタム バインディング要素を示す図](../../../../docs/framework/wcf/extending/media/dddea4a2-0bb4-4921-9bf4-20d4d82c3da5.gif "dddea4a2\-0bb4\-4921\-9bf4\-20d4d82c3da5")  
+  
+ カスタム ID 検証機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム クライアント ID 検証機能を作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md)」を参照してください。  
+  
+### 署名と暗号化に別個の証明書を使用するには  
+  
+1.  <xref:System.ServiceModel.Description.ClientCredentials> クラスを継承する新しいクライアント資格情報クラスを定義します。複数の証明書を指定できるようにする、`ClientSigningCertificate`、`ClientEncryptingCertificate`、`ServiceSigningCertificate`、および `ServiceEncryptingCertificate` の 4 つの新しいプロパティを実装します。また、<xref:System.ServiceModel.Description.ClientCredentials.CreateSecurityTokenManager%2A> メソッドをオーバーライドして、次のステップで定義するカスタマイズ済みの <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスのインスタンスを返すように設定します。  
+  
+     [!code-csharp[c_FourCerts#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#1)]
+     [!code-vb[c_FourCerts#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#1)]  
+  
+2.  <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスを継承する新しいクライアント セキュリティ トークン マネージャーを定義します。適切なセキュリティ トークン プロバイダーを作成するために、<xref:System.ServiceModel.ClientCredentialsSecurityTokenManager.CreateSecurityTokenProvider%2A> メソッドをオーバーライドします。メッセージの方向とキーの使用方法は、`requirement` パラメーター \(<xref:System.IdentityModel.Selectors.SecurityTokenRequirement>\) で提供されます。  
+  
+     [!code-csharp[c_FourCerts#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#2)]
+     [!code-vb[c_FourCerts#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#2)]  
+  
+3.  <xref:System.ServiceModel.Description.ServiceCredentials> クラスを継承する新しいサービス資格情報クラスを定義します。複数の証明書を指定できるようにする、`ClientSigningCertificate`、`ClientEncryptingCertificate`、`ServiceSigningCertificate`、および `ServiceEncryptingCertificate` の 4 つの新しいプロパティを実装します。また、<xref:System.ServiceModel.Description.ServiceCredentials.CreateSecurityTokenManager%2A> メソッドをオーバーライドして、次のステップで定義するカスタマイズ済みの <xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager> クラスのインスタンスを返すように設定します。  
+  
+     [!code-csharp[c_FourCerts#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#3)]
+     [!code-vb[c_FourCerts#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#3)]  
+  
+4.  <xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager> クラスを継承する新しいサービス セキュリティ トークン マネージャーを定義します。渡されたメッセージの方向とキーの使用方法について適切なセキュリティ トークン プロバイダーを作成するために、<xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager.CreateSecurityTokenProvider%2A> メソッドをオーバーライドします。  
+  
+     [!code-csharp[c_FourCerts#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#4)]
+     [!code-vb[c_FourCerts#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#4)]  
+  
+### クライアントで複数の証明書を使用するには  
+  
+1.  カスタム バインディングの作成セキュリティ バインド要素は、要求と応答について異なるセキュリティ トークン プロバイダーが存在することを可能にする二重モードで動作する必要があります。これを行うには、二重モード対応のトランスポートを使用するか、次のコードで示すように <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement> を使用します。次のステップで定義するカスタマイズ済みの <xref:System.ServiceModel.Security.IdentityVerifier> をセキュリティ バインド要素にリンクします。既定のクライアント資格情報を、事前に作成したカスタマイズ済みのクライアント資格情報に置き換えます。  
+  
+     [!code-csharp[c_FourCerts#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#5)]
+     [!code-vb[c_FourCerts#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#5)]  
+  
+2.  カスタム <xref:System.ServiceModel.Security.IdentityVerifier> を定義します。要求の暗号化と応答への署名で異なる証明書が使用されるため、サービスには複数の ID があります。  
+  
+    > [!NOTE]
+    >  次のサンプルで用意されたカスタム ID 検証方法では、デモンストレーション用であるため、エンドポイント ID 検査がまったく行われません。これは製品版のコードでは、お勧めしません。  
+  
+     [!code-csharp[c_FourCerts#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#6)]
+     [!code-vb[c_FourCerts#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#6)]  
+  
+### サービスで複数の証明書を使用するには  
+  
+1.  カスタム バインディングの作成セキュリティ バインド要素は、要求と応答について異なるセキュリティ トークン プロバイダーが存在することを可能にする二重モードで動作する必要があります。クライアントの場合と同様に、二重モード対応のトランスポートを使用するか、次のコードで示すように <xref:System.ServiceModel.Channels.CompositeDuplexBindingElement> を使用します。既定のサービス資格情報を、事前に作成したカスタマイズ済みのサービス資格情報に置き換えます。  
+  
+     [!code-csharp[c_FourCerts#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_fourcerts/cs/source.cs#7)]
+     [!code-vb[c_FourCerts#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_fourcerts/vb/source.vb#7)]  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ServiceCredentials>   
+ <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager>   
+ <xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager>   
+ <xref:System.ServiceModel.Security.IdentityVerifier>   
+ [チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する](../../../../docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/how-to-write-an-extension-for-the-servicecontractgenerator.md b/docs/framework/wcf/extending/how-to-write-an-extension-for-the-servicecontractgenerator.md
new file mode 100644
index 00000000000..bce3c19820a
--- /dev/null
+++ b/docs/framework/wcf/extending/how-to-write-an-extension-for-the-servicecontractgenerator.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : ServiceContractGenerator の拡張を記述する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 876ca823-bd16-4bdf-9e0f-02092df90e51
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : ServiceContractGenerator の拡張を記述する
+このトピックでは、<xref:System.ServiceModel.Description.ServiceContractGenerator> の拡張を記述する方法について説明します。これは、操作の動作に <xref:System.ServiceModel.Description.IOperationContractGenerationExtension> インターフェイスを実装するか、コントラクトの動作に <xref:System.ServiceModel.Description.IServiceContractGenerationExtension> インターフェイスを実装することで可能になります。このトピックでは、<xref:System.ServiceModel.Description.IServiceContractGenerationExtension> インターフェイスをコントラクト動作に実装する方法を説明します。  
+  
+ <xref:System.ServiceModel.Description.ServiceContractGenerator> は、サービス コントラクト、クライアント型、およびクライアント構成を <xref:System.ServiceModel.Description.ServiceEndpoint>、<xref:System.ServiceModel.Description.ContractDescription>、<xref:System.ServiceModel.Channels.Binding> の各インターフェイスから生成します。通常は、サービス メタデータから <xref:System.ServiceModel.Description.ServiceEndpoint>、<xref:System.ServiceModel.Description.ContractDescription>、および <xref:System.ServiceModel.Channels.Binding> インスタンスをインポートし、これらのインスタンスを使用してサービスを呼び出すコードを生成します。この例では、<xref:System.ServiceModel.Description.IWsdlImportExtension> の実装を使用して WSDL 注釈を処理し、生成されたコードに関するコメントを生成するために、インポートしたコントラクトにコード生成拡張を追加します。  
+  
+### ServiceContractGenerator の拡張を記述するには  
+  
+1.  <xref:System.ServiceModel.Description.IServiceContractGenerationExtension> を実装します。生成されたサービス コントラクトを変更するには、<xref:System.ServiceModel.Description.IServiceContractGenerationExtension.GenerateContract%28System.ServiceModel.Description.ServiceContractGenerationContext%29> メソッドに渡された <xref:System.ServiceModel.Description.ServiceContractGenerationContext> インスタンスを使用します。  
+  
+    ```  
+    public void GenerateContract(ServiceContractGenerationContext context)  
+    {  
+        Console.WriteLine("In generate contract.");  
+    context.ContractType.Comments.AddRange(Formatter.FormatComments(commentText));  
+    }  
+    ```  
+  
+2.  同じクラスに <xref:System.ServiceModel.Description.IWsdlImportExtension> を実装します。<xref:System.ServiceModel.Description.IWsdlImportExtension.ImportContract%28System.ServiceModel.Description.WsdlImporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> メソッドは、インポートされた <xref:System.ServiceModel.Description.ContractDescription> インスタンスにコード生成拡張を追加することによって、特定の WSDL 拡張 \(この場合は WSDL 注釈\) を処理できます。  
+  
+    ```  
+    public void ImportContract(WsdlImporter importer, WsdlContractConversionContext context)  
+       {  
+                // Contract documentation  
+             if (context.WsdlPortType.Documentation != null)  
+             {  
+                    context.Contract.Behaviors.Add(new WsdlDocumentationImporter(context.WsdlPortType.Documentation));  
+             }  
+             // Operation documentation  
+             foreach (Operation operation in context.WsdlPortType.Operations)  
+             {  
+                if (operation.Documentation != null)  
+                {  
+                   OperationDescription operationDescription = context.Contract.Operations.Find(operation.Name);  
+                   if (operationDescription != null)  
+                   {  
+                            operationDescription.Behaviors.Add(new WsdlDocumentationImporter(operation.Documentation));  
+                   }  
+                }  
+             }  
+          }  
+          public void BeforeImport(ServiceDescriptionCollection wsdlDocuments, XmlSchemaSet xmlSchemas, ICollection<XmlElement> policy)   
+            {  
+                Console.WriteLine("BeforeImport called.");  
+            }  
+  
+          public void ImportEndpoint(WsdlImporter importer, WsdlEndpointConversionContext context)   
+            {  
+                Console.WriteLine("ImportEndpoint called.");  
+            }  
+    ```  
+  
+3.  クライアント構成に WSDL インポーターを追加します。  
+  
+    ```  
+    <metadata>  
+      <wsdlImporters>  
+        <extension type="Microsoft.WCF.Documentation.WsdlDocumentationImporter, WsdlDocumentation" />  
+      </wsdlImporters>  
+    </metadata>  
+    ```  
+  
+4.  クライアント コードで、`MetadataExchangeClient` を作成して `GetMetadata` を呼び出します。  
+  
+    ```  
+    MetadataExchangeClient mexClient = new MetadataExchangeClient(metadataAddress);  
+    mexClient.ResolveMetadataReferences = true;  
+    MetadataSet metaDocs = mexClient.GetMetadata();  
+    ```  
+  
+5.  `WsdlImporter` を作成して `ImportAllContracts` を呼び出します。  
+  
+    ```  
+    WsdlImporter importer = new WsdlImporter(metaDocs);            System.Collections.ObjectModel.Collection<ContractDescription> contracts = importer.ImportAllContracts();  
+    ```  
+  
+6.  `ServiceContractGenerator` を作成して、コントラクトごとに `GenerateServiceContractType` を呼び出します。  
+  
+    ```  
+    ServiceContractGenerator generator = new ServiceContractGenerator();  
+    foreach (ContractDescription contract in contracts)  
+    {  
+       generator.GenerateServiceContractType(contract);  
+    }  
+    if (generator.Errors.Count != 0)  
+       throw new Exception("There were errors during code compilation.");  
+    ```  
+  
+7.  <xref:System.ServiceModel.Description.IServiceContractGenerationExtension> を実装する特定のコントラクトのコントラクト動作ごとに、<xref:System.ServiceModel.Description.IServiceContractGenerationExtension.GenerateContract%28System.ServiceModel.Description.ServiceContractGenerationContext%29> が自動的に呼び出されます。その後、渡された <xref:System.ServiceModel.Description.ServiceContractGenerationContext> をこのメソッドで変更できます。この例では、コメントが追加されています。  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [方法 : カスタム WSDL をインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-wsdl.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md b/docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md
new file mode 100644
index 00000000000..284616ca482
--- /dev/null
+++ b/docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md
@@ -0,0 +1,61 @@
+---
+title: "WCF 拡張に対するカスタム メタデータのインポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78beb28f-408a-4c75-9c3c-caefe9595b1a
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WCF 拡張に対するカスタム メタデータのインポート
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、メタデータのインポートとは、サービス、またはサービスのコンポーネントの抽象表現をサービスのメタデータから生成するプロセスです。たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.ServiceEndpoint> インスタンス、<xref:System.ServiceModel.Channels.Binding> インスタンス、または <xref:System.ServiceModel.Description.ContractDescription> インスタンスをサービスの WSDL ドキュメントからインポートできます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス メタデータをインポートするには、<xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> 抽象クラスの実装を使用します。<xref:System.ServiceModel.Description.MetadataImporter> クラスから派生した型では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-Policy インポート ロジックを利用したメタデータ形式のインポートをサポートします。  
+  
+ カスタム メタデータは、システム指定のメタデータ インポーターでインポートできない XML 要素で構成されます。通常、これにはカスタム WSDL 拡張とカスタム ポリシー アサーションが含まれます。  
+  
+ ここでは、カスタム WSDL 拡張とカスタム ポリシー アサーションをインポートする方法について説明します。インポート プロセス自体には重点を置きません。カスタム メタデータであるか、システムがサポートするメタデータであるかに関係なく、メタデータをエクスポートおよびインポートする型の使用方法の詳細については、「[メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)」を参照してください。  
+  
+## 概要  
+ <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> 型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる <xref:System.ServiceModel.Description.MetadataImporter> 抽象クラスの実装です。<xref:System.ServiceModel.Description.WsdlImporter> 型は、<xref:System.ServiceModel.Description.MetadataSet?displayProperty=fullName> オブジェクトにまとめられた、結び付けられているポリシーを使用して WSDL メタデータをインポートします。既定のインポーターが認識しないポリシー アサーションおよび WSDL 拡張は、インポートに使用される登録済みのカスタム ポリシーおよびカスタム WDSL インポーターに渡されます。通常、インポーターは、ユーザー定義のバインド要素をサポートしたりインポートされたコントラクトを変更したりする目的で実装されます。  
+  
+ ここでは、次の内容について説明します。  
+  
+1.  説明の生成とコードの生成を行う前に、カスタム インポーターに WSDL データを公開する <xref:System.ServiceModel.Description.IWsdlImportExtension?displayProperty=fullName> インターフェイスを実装して使用する方法。このインターフェイスは、特定のメタデータ セットを使用して実行される説明の種類とコードのコンパイルを確認または変更するために使用できます。  
+  
+2.  説明オブジェクトを生成する前に、インポーターにポリシー アサーションを公開する <xref:System.ServiceModel.Description.IPolicyImportExtension?displayProperty=fullName> インターフェイスを実装して使用する方法。このインターフェイスは、ダウンロードしたポリシーに基づいてバインディングまたはコントラクトを確認または変更するために使用できます。  
+  
+ カスタム WSDL とカスタム ポリシー アサーションのエクスポートの詳細については、「[WCF 拡張に対するカスタム メタデータのエクスポート](../../../../docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md)」を参照してください。  
+  
+## カスタム WSDL 拡張のインポート  
+ WSDL 拡張のインポートをサポートするには、<xref:System.ServiceModel.Description.IWsdlImportExtension> インターフェイスを実装し、その実装を <xref:System.ServiceModel.Description.WsdlImporter.WsdlImportExtensions%2A> プロパティに追加します。<xref:System.ServiceModel.Description.WsdlImporter> は、アプリケーション構成ファイルに登録された <xref:System.ServiceModel.Description.IWsdlImportExtension> インターフェイスの実装を読み込むこともできます。いくつかの WSDL インポーターが既定で登録されること、および登録された WSDL インポーターの順序に意味があることに注意してください。  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter> は、カスタム WSDL インポーターを読み込んで使用する場合、インポート プロセスの前にメタデータを変更できるように、まず <xref:System.ServiceModel.Description.IWsdlImportExtension.BeforeImport%2A> メソッドを呼び出します。次に、コントラクトがインポートされたら、メタデータからインポートされたコントラクトを変更できるように <xref:System.ServiceModel.Description.IWsdlImportExtension.ImportContract%2A> メソッドを呼び出します。最後に、インポートされたエンドポイントを変更できるように <xref:System.ServiceModel.Description.IWsdlImportExtension.ImportEndpoint%2A> メソッドを呼び出します。  
+  
+ 詳細については、「[方法 : カスタム WSDL をインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-wsdl.md)」を参照してください。  
+  
+### カスタム ポリシー アサーションのインポート  
+ <xref:System.ServiceModel.Description.WsdlImporter> 型と [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) は、WSDL ドキュメントに結び付けられたポリシー表現に含まれるさまざまなポリシー アサーション型を自動的に処理します。これらのツールは、WSDL バインディングや WSDL ポートに結び付けられたポリシー表現の収集、正規化、およびマージを行います。  
+  
+ カスタム ポリシー アサーションのインポートをサポートするには、<xref:System.ServiceModel.Description.IPolicyImportExtension> インターフェイスを実装し、その実装を <xref:System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions%2A> プロパティに追加します。<xref:System.ServiceModel.Description.MetadataImporter> は、アプリケーション構成ファイルに登録された <xref:System.ServiceModel.Description.IPolicyImportExtension> インターフェイスの実装を読み込むこともできます。いくつかのポリシー インポーターが既定で登録されること、および登録されたポリシー インポーターの順序に意味があることに注意してください。  
+  
+ メタデータ システムは、登録されたすべてのポリシー インポート拡張で <xref:System.ServiceModel.Description.IPolicyImportExtension.ImportPolicy%2A?displayProperty=fullName> メソッドを呼び出します。これは、メッセージ、操作、およびエンドポイント ポリシーのサブジェクトに結び付けられたポリシー代替手段の各組み合わせに対して行われます。WSDL ポートをインポートする場合、ポリシー インポート拡張を呼び出す前に、ポートおよび対応する WSDL バインディングに結び付けられているポリシーがマージされます。このポリシー代替手段は、<xref:System.ServiceModel.Description.PolicyConversionContext> を通じて、<xref:System.ServiceModel.Description.PolicyAssertionCollection> オブジェクトとして使用可能になります。各 <xref:System.ServiceModel.Description.PolicyAssertionCollection> は、<xref:System.Xml.XmlElement> オブジェクトによって表されるポリシー アサーションのコレクションです。  
+  
+ <xref:System.ServiceModel.Description.PolicyConversionContext> オブジェクトの <xref:System.ServiceModel.Description.PolicyConversionContext.Contract%2A> プロパティと <xref:System.ServiceModel.Description.PolicyConversionContext.BindingElements%2A> プロパティは、WSDL からインポートされた <xref:System.ServiceModel.Description.ContractDescription> オブジェクトと <xref:System.ServiceModel.Channels.BindingElement> オブジェクトを公開します。ポリシー アサーションを処理する場合、ポリシー インポート拡張は、特定のポリシー アサーション型のインスタンスを見つけ、対応する変更を <xref:System.ServiceModel.Description.ContractDescription> オブジェクトまたは <xref:System.ServiceModel.Channels.BindingElement> オブジェクトに加えてから、対応する <xref:System.ServiceModel.Description.PolicyAssertionCollection> からそのポリシー アサーションを削除します。  
+  
+ `wsp:Optional` 属性および入れ子になったポリシー表現は正規化されないため、ポリシー インポート拡張はこれらのポリシー構文を処理する必要があります。また、ポリシー インポート拡張は、同じ <xref:System.ServiceModel.Description.ContractDescription> オブジェクトと <xref:System.ServiceModel.Channels.BindingElement> オブジェクトで何度でも呼び出される可能性があるため、この動作に対して強固である必要があります。  
+  
+> [!IMPORTANT]
+>  無効なメタデータまたは不適切なメタデータがインポーターに渡される可能性があります。カスタム インポーターがすべての形式の XML に対して強固であることを確認してください。  
+  
+## 参照  
+ [方法 : カスタム WSDL をインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-wsdl.md)   
+ [方法 : カスタム ポリシー アサーションをインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-policy-assertions.md)   
+ [方法 : ServiceContractGenerator の拡張を記述する](../../../../docs/framework/wcf/extending/how-to-write-an-extension-for-the-servicecontractgenerator.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/media/channelstatetranitionshighleveldiagram.gif b/docs/framework/wcf/extending/media/channelstatetranitionshighleveldiagram.gif
new file mode 100644
index 00000000000..38721fbfea8
Binary files /dev/null and b/docs/framework/wcf/extending/media/channelstatetranitionshighleveldiagram.gif differ
diff --git a/docs/framework/wcf/extending/media/dddea4a2-0bb4-4921-9bf4-20d4d82c3da5.gif b/docs/framework/wcf/extending/media/dddea4a2-0bb4-4921-9bf4-20d4d82c3da5.gif
new file mode 100644
index 00000000000..1f0503f26c9
Binary files /dev/null and b/docs/framework/wcf/extending/media/dddea4a2-0bb4-4921-9bf4-20d4d82c3da5.gif differ
diff --git a/docs/framework/wcf/extending/media/e4971edd-a59f-4571-b36f-7e6b2f0d610f.gif b/docs/framework/wcf/extending/media/e4971edd-a59f-4571-b36f-7e6b2f0d610f.gif
new file mode 100644
index 00000000000..6f4d5ae0039
Binary files /dev/null and b/docs/framework/wcf/extending/media/e4971edd-a59f-4571-b36f-7e6b2f0d610f.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-basicthreemepsc.gif b/docs/framework/wcf/extending/media/wcfc-basicthreemepsc.gif
new file mode 100644
index 00000000000..e3587888ca1
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-basicthreemepsc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-channelstackhighlevelc.gif b/docs/framework/wcf/extending/media/wcfc-channelstackhighlevelc.gif
new file mode 100644
index 00000000000..996ec6a3bde
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-channelstackhighlevelc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-dispatchruntimearchc.gif b/docs/framework/wcf/extending/media/wcfc-dispatchruntimearchc.gif
new file mode 100644
index 00000000000..2e38a9daab8
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-dispatchruntimearchc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-sessionandsessionlesschannelsc.gif b/docs/framework/wcf/extending/media/wcfc-sessionandsessionlesschannelsc.gif
new file mode 100644
index 00000000000..b5ee627b674
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-sessionandsessionlesschannelsc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-soap1-1andsoap1-2faultcomparisonc.gif b/docs/framework/wcf/extending/media/wcfc-soap1-1andsoap1-2faultcomparisonc.gif
new file mode 100644
index 00000000000..5271e97627e
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-soap1-1andsoap1-2faultcomparisonc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-tracinginchannelsc.gif b/docs/framework/wcf/extending/media/wcfc-tracinginchannelsc.gif
new file mode 100644
index 00000000000..b717c4a6dca
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-tracinginchannelsc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfcchannelsigure3omumtreec.gif b/docs/framework/wcf/extending/media/wcfc-wcfcchannelsigure3omumtreec.gif
new file mode 100644
index 00000000000..0854f28c61c
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfcchannelsigure3omumtreec.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsguire7ico-closeflowchartc.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsguire7ico-closeflowchartc.gif
new file mode 100644
index 00000000000..36107b9d293
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsguire7ico-closeflowchartc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure1highlevelc.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure1highlevelc.gif
new file mode 100644
index 00000000000..b3f06502b89
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure1highlevelc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure2highlevelfactgoriesc.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure2highlevelfactgoriesc.gif
new file mode 100644
index 00000000000..753723aa38f
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure2highlevelfactgoriesc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure5statetransitionsdetailsc.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure5statetransitionsdetailsc.gif
new file mode 100644
index 00000000000..7ea6c3e07b9
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure5statetransitionsdetailsc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure8ico-abortflowchartc.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure8ico-abortflowchartc.gif
new file mode 100644
index 00000000000..e6755a0835d
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigure8ico-abortflowchartc.gif differ
diff --git a/docs/framework/wcf/extending/media/wcfc-wcfchannelsigurecoopenflowchartf.gif b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigurecoopenflowchartf.gif
new file mode 100644
index 00000000000..fae115bb175
Binary files /dev/null and b/docs/framework/wcf/extending/media/wcfc-wcfchannelsigurecoopenflowchartf.gif differ
diff --git a/docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md b/docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md
new file mode 100644
index 00000000000..ac06e6224df
--- /dev/null
+++ b/docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md
@@ -0,0 +1,74 @@
+---
+title: "認証のためのサービスの ID のオーバーライド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d613a22b-07d7-41a4-bada-1adc653b9b5d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 認証のためのサービスの ID のオーバーライド
+クライアント資格情報の種類を選択すると、サービス メタデータで公開される ID の種類が指定されるため、通常、サービスで ID を設定する必要はありません。 たとえば、次の構成コードを使用して、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)要素とセット、`clientCredentialType`属性を Windows です。  
+  
+  
+  
+ 次の Web サービス記述言語 (WSDL) コードは、定義済みのエンドポイントの ID を示しています。 この例では、サービスが特定のユーザー アカウントで自己ホスト型サービスとして実行されて(username@contoso.com)でユーザー プリンシパル名 (UPN) id を含んでいる、アカウント名。 UPN は、Windows ドメインではユーザー ログオン名とも呼ばれます。  
+  
+  
+  
+ Id の設定を示すサンプル アプリケーションを参照してください。[サービス Id サンプル](../../../../docs/framework/wcf/samples/service-identity-sample.md)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]サービス id を参照してください[サービス Id と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)します。  
+  
+## <a name="kerberos-authentication-and-identity"></a>Kerberos 認証と ID  
+ 既定では、Windows の資格情報を使用するサービスが構成されている場合、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)を含む要素、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/userprincipalname.md)または[ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md)要素は、WSDL で生成します。 サービスが実行されている場合、 `LocalSystem`、 `LocalService`、または`NetworkService`アカウント、サービス プリンシパル名 (SPN) が既定の形式で生成`host/` \<*ホスト名*> それらのアカウントのコンピューターの SPN のデータにアクセスできるためです。 サービスが別のアカウントで実行されている場合[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]形式の UPN を生成*username*>@<*domainName*`>`します。 これらが生成されるのは、Kerberos 認証では、サービスを認証するために UPN または SPN をクライアントに提供する必要があるからです。  
+  
+ Setspn.exe ツールを使用して、他の SPN をドメイン内のサービスのアカウントに登録することもできます。 登録した SPN は、そのサービスの ID として使用できます。 このツールをダウンロードするを参照してください。 [Windows 2000 リソース キット ツール: Setspn.exe](http://go.microsoft.com/fwlink/?LinkId=91752)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]このツールを参照してください[Setspn の概要](http://go.microsoft.com/fwlink/?LinkId=61374)します。  
+  
+> [!NOTE]
+>  ネゴシエーションを行わずに Windows 資格情報を使用するには、サービスのユーザー アカウントが Active Directory ドメインに登録された SPN にアクセスできる必要があります。 これは、次の方法で行うことができます。  
+  
+-   サービスを実行するには、NetworkService アカウントまたは LocalSystem アカウントを使用します。 これらのアカウントは、コンピューターが Active Directory ドメインに参加したときに確立されたコンピューターの SPN にアクセスできるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、適切な SPN 要素を、サービスのメタデータ (WSDL) にあるサービスのエンドポイント内部に自動的に生成します。  
+  
+-   任意の Active Directory ドメイン アカウントを使用してサービスを実行します。 この場合、そのドメイン アカウント用の SPN を確立します。これには、Setspn.exe ユーティリティ ツールを使用できます。 サービスのアカウント用の SPN を作成したら、SPN をそのメタデータ (WSDL) を通じてサービスのクライアントに公開するように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を構成します。 これを行うには、アプリケーション構成ファイルまたはコードを使用して、公開されるエンドポイントのエンドポイント ID を設定します。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]Spn、Kerberos プロトコル、および Active Directory を参照してください。 [Kerberos Technical Supplement for Windows](http://go.microsoft.com/fwlink/?LinkId=88330)します。  
+  
+### <a name="when-spn-or-upn-equals-the-empty-string"></a>SPN または UPN が空の文字列の場合  
+ 空の文字列の SPN または UPN を設定した場合は、使用しているセキュリティ レベルと認証モードに応じて、次のようになります。  
+  
+-   トランスポート レベルのセキュリティを使用している場合は、NTLM (NT LanMan) 認証が選択されます。  
+  
+-   メッセージ レベルのセキュリティを使用している場合は、認証モードによっては認証に失敗する可能性があります。  
+  
+-   `spnego` モードを使用し、`AllowNtlm` 属性を `false` に設定している場合は、認証に失敗します。  
+  
+-   `spnego` モードを使用し、`AllowNtlm` 属性を `true` に設定している場合、UPN が空の場合は認証に失敗しますが、SPN が空の場合は認証に成功します。  
+  
+-   Kerberos ダイレクト ("ワンショット" とも呼ばれます) を使用している場合は、認証に失敗します。  
+  
+### <a name="using-the-identity-element-in-configuration"></a>使用して、 <> \>構成内の要素  
+ 前の例で示したバインディングのクライアント資格情報の種類を Certificate に変更すると、生成される WSDL には、Base64 でシリアル化された ID 値用の X.509 証明書が含まれます。コードを次に示します`,`。 これは、Windows 以外のすべてのクライアント資格情報の種類の既定値です。  
+  
+  
+  
+ 構成で <`identity`> 要素を使用したり、コードで ID を設定したりすることにより、既定のサービス ID の値を変更したり、ID の種類を変更したりすることが可能です。 値 `contoso.com` を使用してドメイン ネーム システム (DNS) ID を設定する構成コードを次に示します。  
+  
+  
+  
+### <a name="setting-identity-programmatically"></a>プログラムによる ID の設定  
+ ID は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって自動的に決定されるため、サービスで ID を明示的に指定する必要はありません。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、必要に応じてエンドポイントの ID を指定できます。 特定の DNS ID を持つ新しいサービス エンドポイントを追加するコードを次に示します。  
+  
+ [!code-csharp[C_Identity#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_identity/cs/source.cs#5)]
+ [!code-vb[C_Identity#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_identity/vb/source.vb#5)]  
+  
+## <a name="see-also"></a>関連項目  
+ [方法: カスタム クライアント Id 検証機能を作成します。](../../../../docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md)   
+ [サービス Id と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md b/docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md
new file mode 100644
index 00000000000..a5d80ec2484
--- /dev/null
+++ b/docs/framework/wcf/extending/publishing-and-retrieving-metadata-over-a-custom-binding.md
@@ -0,0 +1,41 @@
+---
+title: "カスタム バインディングを介したメタデータの公開と取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 904e11b4-d90e-45c6-9ee5-c3472c90008c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# カスタム バインディングを介したメタデータの公開と取得
+<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> は、サービスにメタデータ エンドポイントを追加するためのサポートを提供します。これらのメタデータ エンドポイントは、`?wsdl` クエリ文字列を持つ URL での HTTP GET 要求、および WS\-MetadataExchange \(MEX\) 仕様で定義された WS\-Transfer GET 要求に応答できます。MEX エンドポイントは、<xref:System.ServiceModel.Description.IMetadataExchange?displayProperty=fullName> コントラクトを実装します。  
+  
+## カスタム バインディングを介したメタデータの公開  
+ HTTP GET メタデータ エンドポイントと HTTPS GET メタデータ エンドポイントを有効にするには、<xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A?displayProperty=fullName> プロパティまたは <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A?displayProperty=fullName> プロパティを `true` に設定します。これらのエンドポイントのバインディングは構成できません。  
+  
+ ただし、<xref:System.ServiceModel.Description.IMetadataExchange> コントラクトは、カスタム バインディングを使用するエンドポイントを含むすべてのエンドポイントで使用できます。これは、<xref:System.ServiceModel.Description.IMetadataExchange> エンドポイントは他のすべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス エンドポイントと同じであるためです。システム指定のバインディングの構成を変更する方法または <xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> の構成方法を理解している場合は、<xref:System.ServiceModel.Description.IMetadataExchange> エンドポイントで使用されるバインディングを構成できます。  
+  
+## カスタム バインディングを介したメタデータの取得  
+ メタデータは、標準の HTTP 要求または HTTPS GET 要求を使用して HTTP Get および HTTPS Get メタデータ エンドポイントから取得できます。  
+  
+ MEX メタデータ エンドポイントからメタデータを取得するには、通常、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされている標準の MEX バインディングのいずれかを使用できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Description.MetadataExchangeBindings?displayProperty=fullName>.<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> 型および Svcutil.exe ツールでは、指定したメタデータ エンドポイントのアドレスに基づいて、標準の MEX バインディングの 1 つが自動的に選択されます。  
+  
+ MEX メタデータ エンドポイントで標準の MEX バインディングとは異なるバインディングを使用する場合は、コードを使用するか、<xref:System.ServiceModel.Description.IMetadataExchange> クライアント エンドポイント構成を提供することにより、<xref:System.ServiceModel.Description.MetadataExchangeClient> で使用されるバインディングを構成できます。Svcutil.exe ツールは、構成ファイルから、メタデータ エンドポイント アドレスの URI スキームと同じ名前を持つ <xref:System.ServiceModel.Description.IMetadataExchange> クライアント エンドポイント構成を自動的に読み込みます。  
+  
+## セキュリティ  
+ カスタム バインディングを介してメタデータを公開する場合、メタデータに必要なセキュリティ サポートをそのカスタム バインディングが提供することを確認してください。たとえば、情報の漏えいを防止し、メタデータを取得するための権限がクライアントにあることを確認するには、認証および暗号化を要求するように <xref:System.ServiceModel.Description.IMetadataExchange> エンドポイントを構成することによってメタデータとアプリケーションのセキュリティを強化します。サンプルの[カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)は、このシナリオを示しています。  
+  
+## 参照  
+ [サービスのセキュリティ保護](../../../../docs/framework/wcf/securing-services.md)   
+ [WS\-MetadataExchange のバインディング](../../../../docs/framework/wcf/extending/ws-metadataexchange-bindings.md)   
+ [方法 : カスタム WS\-Metadata Exchange バインディングを構成する](../../../../docs/framework/wcf/extending/how-to-configure-a-custom-ws-metadata-exchange-binding.md)   
+ [方法: MEX 以外のバインディングを介してメタデータを取得する](../../../../docs/framework/wcf/extending/how-to-retrieve-metadata-over-a-non-mex-binding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/service-channel-level-programming.md b/docs/framework/wcf/extending/service-channel-level-programming.md
new file mode 100644
index 00000000000..8ff3c1e2cb3
--- /dev/null
+++ b/docs/framework/wcf/extending/service-channel-level-programming.md
@@ -0,0 +1,65 @@
+---
+title: "サービス チャネル レベルのプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d8dcd85-0a05-4c44-8861-4a0b3b90cca9
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス チャネル レベルのプログラミング
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス アプリケーションを <xref:System.ServiceModel.ServiceHost?displayProperty=fullName> とこれに関係するオブジェクト モデルを使用しないで作成する方法を説明します。  
+  
+## メッセージの受信  
+ メッセージの受信と処理の準備を整えるには、次の手順に従う必要があります。  
+  
+1.  バインディングを作成します。  
+  
+2.  チャネル リスナーをビルドします。  
+  
+3.  チャネル リスナーを開きます。  
+  
+4.  要求を読み取り、応答を送信します。  
+  
+5.  すべてのチャネル オブジェクトを閉じます。  
+  
+#### バインディングの作成  
+ メッセージのリッスンと受信の最初の手順として、バインディングを作成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、組み込みバインディングまたはシステム標準のバインディングが複数付属しており、そのうちの 1 個をインスタンス化することによって直接使用できます。また、CustomBinding クラスをインスタンス化することにより、独自のバインディングを作成することもできます。手順 1. のコードは、この処理を実行します。  
+  
+ 後のコード例は、<xref:System.ServiceModel.Channels.CustomBinding?displayProperty=fullName> のインスタンスを作成し、その Elements コレクションに <xref:System.ServiceModel.Channels.HttpTransportBindingElement?displayProperty=fullName> を追加します。Elements コレクションは、チャネル スタックを作成するために使用されるバインド要素のコレクションです。この例では、Elements コレクションには <xref:System.ServiceModel.Channels.HttpTransportBindingElement> しか含まれないため、チャネル スタックは HTTP トランスポート チャネルだけを持ちます。  
+  
+#### ChannelListener のビルド  
+ バインディングを作成したら、<xref:System.ServiceModel.Channels.Binding.BuildChannelListener%601%2A?displayProperty=fullName> を呼び出してチャネル リスナーをビルドします。型パラメーターは、作成するチャネル形状です。この例では、要求\/応答メッセージ交換パターンで受信メッセージをリッスンする必要があるため、<xref:System.ServiceModel.Channels.IReplyChannel?displayProperty=fullName> を使用します。  
+  
+ <xref:System.ServiceModel.Channels.IReplyChannel> は、要求メッセージを受信し、応答メッセージを返信するために使用されます。<xref:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest%2A?displayProperty=fullName> を呼び出すと、要求メッセージの受信と応答メッセージの返信に使用できる <xref:System.ServiceModel.Channels.IRequestChannel?displayProperty=fullName> が返されます。  
+  
+ リスナーを作成する際には、リッスンするネットワーク アドレス \(この場合は `http://localhost:8080/channelapp`\) を渡します。一般に、各トランスポート チャネルは 1 つまたは複数のアドレス スキームをサポートします。たとえば、HTTP トランスポートは、http スキームと https スキームの両方をサポートします。  
+  
+ また、リスナーを作成する際には、空の <xref:System.ServiceModel.Channels.BindingParameterCollection?displayProperty=fullName> を渡します。バインディング パラメーターは、リスナーのビルド方法を制御するパラメーターを渡すしくみです。この例では、このようなパラメーターは使用しないため、空のコレクションを渡します。  
+  
+#### 受信メッセージのリッスン  
+ 次に、ビルドしたリスナーで <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName> を呼び出し、チャネルの受け入れを開始します。<xref:System.ServiceModel.Channels.IChannelListener%601.AcceptChannel%2A?displayProperty=fullName> の動作は、トランスポートが接続指向であるか、コネクションレスであるかによって異なります。接続指向トランスポートの場合、<xref:System.ServiceModel.Channels.IChannelListener%601.AcceptChannel%2A> は新しい接続要求が届くまでブロックし、接続要求が届いた時点で、その新しい接続を表す新しいチャネルを返します。HTTP などのコネクションレス トランスポートの場合、<xref:System.ServiceModel.Channels.IChannelListener%601.AcceptChannel%2A> は、トランスポート リスナーが作成する唯一のチャネルを直ちに返します。  
+  
+ この例では、リスナーは、<xref:System.ServiceModel.Channels.IReplyChannel> を実装するチャネルを返します。このチャネルでメッセージを受信するには、まず、チャネルで <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName> を呼び出して通信できる状態にします。次に、メッセージが到着するまでブロックする <xref:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest%2A> を呼び出します。  
+  
+#### 要求の読み取りと応答の送信  
+ <xref:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest%2A> が <xref:System.ServiceModel.Channels.RequestContext> を返すときに、その <xref:System.ServiceModel.Channels.RequestContext.RequestMessage%2A> プロパティを使用して受信メッセージを取得します。メッセージのアクションと本文のコンテンツ \(文字列であることを前提とします\) を書き込みます。  
+  
+ 応答を送信するには、新しい応答メッセージを作成します。この場合は、要求で受信した文字列データを渡します。次に、<xref:System.ServiceModel.Channels.RequestContext.Reply%2A> を呼び出して、その応答メッセージを送信します。  
+  
+#### オブジェクトを閉じる  
+ リソースのリークを避けるには、通信に使用したオブジェクトが不要になったら閉じることが重要です。この例では、要求メッセージ、要求コンテキスト、チャネル、およびリスナーを閉じます。  
+  
+ 次のコード例は、チャネル リスナーがメッセージを 1 つだけ受け取る基本的なサービスです。実際のサービスでは、サービスが終了するまでチャネルの受け入れとメッセージの受信を続けます。  
+  
+ [!code-csharp[ChannelProgrammingBasic#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/channelprogrammingbasic/cs/serviceprogram.cs#1)]
+ [!code-vb[ChannelProgrammingBasic#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/channelprogrammingbasic/vb/serviceprogram.vb#1)]
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/service-channel-listeners-and-channels.md b/docs/framework/wcf/extending/service-channel-listeners-and-channels.md
new file mode 100644
index 00000000000..63765600642
--- /dev/null
+++ b/docs/framework/wcf/extending/service-channel-listeners-and-channels.md
@@ -0,0 +1,57 @@
+---
+title: "サービス : チャネル リスナーとチャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ccbe0e8-7e55-441d-80de-5765f67542fa
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# サービス : チャネル リスナーとチャネル
+チャネル オブジェクトには、チャネル、チャネル リスナー、およびチャネル ファクトリという 3 つのカテゴリがあります。チャネルはアプリケーションおよびチャネル スタックとのインターフェイスです。チャネル リスナーは受信 \(またはリッスン\) する側のチャネルを作成する役割を果たします。通常は、新しい受信メッセージまたは接続への応答を行います。チャネル ファクトリは送信側のチャネルを作成し、エンドポイントとの通信を開始する役割を果たします。  
+  
+## チャネル リスナーとチャネル  
+ チャネル リスナーには、チャネルを作成し、下の層またはネットワークからメッセージを受信する役割があります。受信されたメッセージは、チャネル リスナーによって作成されるチャネルを使用して、上の層に配信されます。  
+  
+ メッセージを受信して上の層に配信するプロセスを次の図に示します。  
+  
+ ![チャネル リスナーとチャネル](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsigure1highlevelc.gif "wcfc\_WCFChannelsigure1HighLevelc")  
+メッセージを受信してチャネル経由で上の層に配信するチャネル リスナー。  
+  
+ このプロセスは、概念上、各チャネル内のキューとしてモデル化できますが、実際には実装がキューを使用しない場合もあります。チャネル リスナーには、下の層またはネットワークからメッセージを受信し、キューに配置する役割があります。また、チャネルには、キューからメッセージを取得し、上の層から \(たとえば、チャネル上で `Receive` を呼び出すことによって\) メッセージが要求されたときにそのメッセージを渡す役割があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このプロセスに対する基本クラス ヘルパーが用意されています \(ここで説明するチャネル ヘルパー クラスのダイアグラムについては、「[チャネル モデルの概要](../../../../docs/framework/wcf/extending/channel-model-overview.md)」を参照してください\)。  
+  
+-   <xref:System.ServiceModel.Channels.CommunicationObject> クラスには <xref:System.ServiceModel.ICommunicationObject> が実装され、[チャネルの開発](../../../../docs/framework/wcf/extending/developing-channels.md) の手順 2. で説明されているステート マシンが強制実行されます。  
+  
+-   <xref:System.ServiceModel.Channels.ChannelManagerBase> クラスには <xref:System.ServiceModel.Channels.CommunicationObject> が実装され、<xref:System.ServiceModel.Channels.ChannelFactoryBase> と <xref:System.ServiceModel.Channels.ChannelListenerBase> の統合基本クラスが提供されます。<xref:System.ServiceModel.Channels.ChannelManagerBase> クラスは、<xref:System.ServiceModel.Channels.IChannel> を実装する基本クラスである <xref:System.ServiceModel.Channels.ChannelBase> との組み合わせによって動作します。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelFactoryBase> クラスでは、<xref:System.ServiceModel.Channels.ChannelManagerBase> および <xref:System.ServiceModel.Channels.IChannelFactory> が実装され、`CreateChannel` オーバーロードが `OnCreateChannel` 抽象メソッドに統合されます。  
+  
+-   <xref:System.ServiceModel.Channels.ChannelListenerBase> クラスは、<xref:System.ServiceModel.Channels.IChannelListener> を実装しています。基本状態管理を行います。  
+  
+ 次の説明は、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルに基づいています。  
+  
+## チャネル リスナーの作成  
+ サンプルに実装されている ``UdpChannelListener は、<xref:System.ServiceModel.Channels.ChannelListenerBase> クラスから派生します。単一の UDP ソケットを使用して、データグラムを受信します。`OnOpen` メソッドは、非同期ループ内で UDP ソケットを使用してデータを受信します。その後、メッセージ エンコーディング システムを使用して、データを次のようにメッセージに変換します。  
+  
+```  
+message = UdpConstants.MessageEncoder.ReadMessage(  
+  new ArraySegment<byte>(buffer, 0, count),   
+  bufferManager  
+);  
+```  
+  
+ 複数のソースから到着するメッセージが同じデータグラム チャネルで表されるので、`UdpChannelListener` はシングルトン リスナーです。このリスナーに同時に関連付けられるアクティブな <xref:System.ServiceModel.Channels.IChannel>`` は、最大 1 つです。このサンプルでは、<xref:System.ServiceModel.Channels.ChannelListenerBase%601.AcceptChannel%2A> メソッドによって返されるチャネルがその後破棄される場合のみ、もう 1 つ生成されます。メッセージが受信されると、このシングルトン チャネルのキューに置かれます。  
+  
+### UdpInputChannel  
+ `UdpInputChannel` クラスは、<xref:System.ServiceModel.Channels.IInputChannel> を実装しています。このクラスは `UdpChannelListener` のソケットによって設定される受信メッセージのキューで構成されています。これらのメッセージは、<xref:System.ServiceModel.Channels.IInputChannel.Receive%2A> メソッドによってキューから削除されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/specifying-a-custom-crypto-algorithm.md b/docs/framework/wcf/extending/specifying-a-custom-crypto-algorithm.md
new file mode 100644
index 00000000000..a2ca3534bca
--- /dev/null
+++ b/docs/framework/wcf/extending/specifying-a-custom-crypto-algorithm.md
@@ -0,0 +1,143 @@
+---
+title: "カスタム暗号アルゴリズムの指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d662a305-8e09-451d-9a59-b0f12b012f1d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# カスタム暗号アルゴリズムの指定
+WCF では、データの暗号化やデジタル署名の計算を行う際に使用するカスタム暗号アルゴリズムを指定できます。  そのためには、次の手順に従います。  
+  
+1.  <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> の派生クラスを作成します。  
+  
+2.  アルゴリズムを登録します。  
+  
+3.  <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> の派生クラスを使用してバインディングを構成します。  
+  
+## SecurityAlgorithmSuite の派生クラスの作成  
+ <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> は、セキュリティ関連のさまざまな操作を実行する際に使用するアルゴリズムを指定できるようにする抽象基本クラスです。  たとえば、デジタル署名のハッシュ計算やメッセージの暗号化などの操作です。  次のコードは、<xref:System.ServiceModel.Security.SecurityAlgorithm> から派生クラスを作成する方法を示しています。  
+  
+```csharp  
+public class MyCustomAlgorithmSuite : SecurityAlgorithmSuite  
+    {  
+        public override string DefaultAsymmetricKeyWrapAlgorithm  
+        {  
+            get { return SecurityAlgorithms.RsaOaepKeyWrap; }  
+        }  
+  
+        public override string DefaultAsymmetricSignatureAlgorithm  
+        {  
+            get { return SecurityAlgorithms.RsaSha1Signature; }  
+        }  
+  
+        public override string DefaultCanonicalizationAlgorithm  
+        {  
+            get { return SecurityAlgorithms.ExclusiveC14n; ; }  
+        }  
+  
+        public override string DefaultDigestAlgorithm  
+        {  
+            get { return SecurityAlgorithms.MyCustomHashAlgorithm; }  
+        }  
+  
+        public override string DefaultEncryptionAlgorithm  
+        {  
+            get { return SecurityAlgorithms.Aes128Encryption; }  
+        }  
+  
+        public override int DefaultEncryptionKeyDerivationLength  
+        {  
+            get { return 128; }  
+        }  
+  
+        public override int DefaultSignatureKeyDerivationLength  
+        {  
+            get { return 128; }  
+        }  
+  
+        public override int DefaultSymmetricKeyLength  
+        {  
+            get { return 128; }  
+        }  
+  
+        public override string DefaultSymmetricKeyWrapAlgorithm  
+        {  
+            get { return SecurityAlgorithms.Aes128Encryption; }  
+        }  
+  
+        public override string DefaultSymmetricSignatureAlgorithm  
+        {  
+            get { return SecurityAlgorithms.HmacSha1Signature; }  
+        }  
+  
+        public override bool IsAsymmetricKeyLengthSupported(int length)  
+        {  
+            return length >= 1024 && length <= 4096;  
+        }  
+  
+        public override bool IsSymmetricKeyLengthSupported(int length)  
+        {  
+            return length >= 128 && length <= 256;  
+        }  
+    }  
+  
+```  
+  
+## カスタム アルゴリズムの登録  
+ 登録は、構成ファイルまたは命令型コードで行うことができます。  カスタム アルゴリズムを登録するには、暗号サービス プロバイダーを実装するクラスとエイリアスの間のマッピングを作成します。  その後、WCF サービスのバインディングでアルゴリズムを指定する際に使用する URI にエイリアスをマップします。  次の構成スニペットは、config でカスタム アルゴリズムを登録する方法を示しています。  
+  
+```xml  
+<configuration>  
+   <mscorlib>  
+      <cryptographySettings>  
+         <cryptoNameMapping>  
+           <cryptoClasses>  
+              <cryptoClass SHA256CSP="System.Security.Cryptography.SHA256CryptoServiceProvider, System.Core, Version=3.5.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+           </cryptoClasses>  
+           <nameEntry name="http://constoso.com/CustomAlgorithms/CustomHashAlgorithm"  
+              class="SHA256CSP" />  
+           </cryptoNameMapping>  
+        </cryptographySettings>  
+    </mscorlib>  
+</configuration>  
+  
+```  
+  
+ \<`cryptoClasses`\> 要素の下のセクションで、SHA256CryptoServiceProvider とエイリアス "SHA256CSP" の間のマッピングを作成します。  \<[nameEntry](assetId:///nameEntry?qualifyHint=False&amp;autoUpgrade=True)\> 要素によって、"SHA256CSP" エイリアスと指定した URL \(http:\/\/constoso.com\/CustomAlgorithms\/CustomHashAlgorithm\) の間のマッピングを作成します。  
+  
+ コードでカスタム アルゴリズムを登録するには、[M:System.Security.Cryptography.CryptoConfig.AddAlgorithm\(System.Type, System.String\<xref:System.Security.Cryptography.CryptoConfig.AddAlgorithm%2A> System.String[])?qualifyHint=False&autoUpgrade=True メソッドを使用します。  このメソッドによって、両方のマッピングを作成します。  次の例は、このメソッドを呼び出す方法を示しています。  
+  
+```  
+// Register the custom URI string defined for the hashAlgorithm in MyCustomAlgorithmSuite class to create the   
+// SHA256CryptoServiceProvider hash algorithm object.  
+CryptoConfig.AddAlgorithm(typeof(SHA256CryptoServiceProvider), "http://constoso.com/CustomAlgorithms/CustomHashAlgorithm");  
+  
+```  
+  
+## バインディングの構成  
+ バインディングを構成するには、次のコード スニペットに示すように、<xref:System.ServiceModel.Security.SecurityAlgorithmSuite> のカスタム派生クラスをバインディング設定で指定します。  
+  
+```csharp  
+WSHttpBinding binding = new WSHttpBinding();  
+            binding.Security.Message.AlgorithmSuite = new MyCustomAlgorithmSuite();  
+  
+```  
+  
+ コード例全体については、「[WCF セキュリティの暗号化方式の指定](../../../../docs/framework/wcf/samples/cryptographic-agility-in-wcf-security.md)」のサンプルを参照してください。  
+  
+## 参照  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [サービスのセキュリティ保護](../../../../docs/framework/wcf/securing-services.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/understanding-state-changes.md b/docs/framework/wcf/extending/understanding-state-changes.md
new file mode 100644
index 00000000000..3dbe5e95e7b
--- /dev/null
+++ b/docs/framework/wcf/extending/understanding-state-changes.md
@@ -0,0 +1,176 @@
+---
+title: "状態変更の理解 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a79ed2aa-e49a-47a8-845a-c9f436ec9987
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 状態変更の理解
+ここでは、チャネルの状態と遷移、チャネル状態の構成に使用する型、およびそれらの型の実装方法について説明します。  
+  
+## ステート マシンとチャネル  
+ 通信を処理する、ソケットなどのオブジェクトは、通常、ネットワーク リソースの割り当て、接続の確立や受け入れ、接続の閉鎖、および通信の終了に関連して状態が遷移するステート マシンを提供します。チャネル ステート マシンは、通信オブジェクトの状態の統一モデルを提供します。モデルでは、そのオブジェクトの基になる実装が抽出されます。<xref:System.ServiceModel.ICommunicationObject> インターフェイスは、状態、状態遷移メソッド、および状態遷移イベントのセットを提供します。すべてのチャネル、チャネル ファクトリ、およびチャネル リスナーは、チャネル ステート マシンを実装します。  
+  
+ Closed、Closing、Faulted、Opened、および Opening の各イベントは、状態遷移の発生後に外部のオブザーバーに通知を行います。  
+  
+ Abort、Close、Open の各メソッド \(およびそれぞれと同等の非同期メソッド\) は、状態遷移を発生させます。  
+  
+ 状態プロパティは、<xref:System.ServiceModel.CommunicationState> によって定義された現在の状態を返します。  
+  
+## ICommunicationObject、CommunicationObject、および各状態と状態遷移  
+ <xref:System.ServiceModel.ICommunicationObject> は、そのさまざまなプロパティを構成できる Created 状態で開始します。Opened 状態になると、このオブジェクトは、メッセージを送受信するために利用できるようになりますが、プロパティは不変と見なされます。Closing 状態になると、このオブジェクトは新しい送受信要求を処理できなくなりますが、既存の要求は、Close タイムアウトに到達するまでに完了する可能性があります。回復不可能なエラーが発生した場合は、オブジェクトは Faulted 状態に遷移し、そこでエラーに関する情報を点検し、最終的に閉じることができます。Closed 状態になると、このオブジェクトは、実質的にステート マシンの最後に到達します。オブジェクトが、ある状態から次の状態に遷移すると、前の状態には戻りません。  
+  
+ <xref:System.ServiceModel.ICommunicationObject> の各状態と状態遷移を次の図に示します。状態遷移は、Abort、Open、Close の 3 つのメソッドのいずれかを呼び出すことによって発生させることができます。また、実装固有の他のメソッドを呼び出すことによって発生させることもできます。Faulted 状態への遷移は、通信オブジェクトを開いている途中または開いた後に発生することがあります。  
+  
+ すべての <xref:System.ServiceModel.ICommunicationObject> は Created 状態から開始します。この状態では、アプリケーションがプロパティを設定してオブジェクトを構成できます。オブジェクトが Created 以外の状態になると、オブジェクトは不変と見なされます。  
+  
+ ![チャネル状態遷移](../../../../docs/framework/wcf/extending/media/channelstatetranitionshighleveldiagram.gif "ChannelStateTranitionsHighLevelDiagram")  
+図 1. ICommunicationObject ステート マシン  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、<xref:System.ServiceModel.ICommunicationObject> とチャネル ステート マシンを実装する <xref:System.ServiceModel.Channels.CommunicationObject> という名前の抽象基本クラスを提供します。次の図は、<xref:System.ServiceModel.Channels.CommunicationObject> に固有の、変更済みの状態図です。<xref:System.ServiceModel.ICommunicationObject> ステート マシンのほかに、追加の <xref:System.ServiceModel.Channels.CommunicationObject> メソッドが呼び出されるタイミングも示しています。  
+  
+ ![状態変更](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsigure5statetransitionsdetailsc.gif "wcfc\_WCFChannelsigure5StateTransitionsDetailsc")  
+図 2. イベントと保護メソッドの呼び出しを含む、ICommunicationObject ステート マシンの CommunicationObject 実装  
+  
+### ICommunicationObject イベント  
+ <xref:System.ServiceModel.Channels.CommunicationObject> は、<xref:System.ServiceModel.ICommunicationObject> によって定義された 5 つのイベントを公開します。これらのイベントは、通信オブジェクトを使用するコードに状態遷移を通知するために設計されています。上の図 2 に示されているように、オブジェクトの状態が、各イベントの名前が付けられた状態に遷移すると、該当するイベントが 1 回発生します。イベントはすべて `EventHandler` 型であり、この型は次のように定義されています。  
+  
+ `public delegate void EventHandler(object sender, EventArgs e);`  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject> 実装では、送信側は <xref:System.ServiceModel.Channels.CommunicationObject> 自体、または送信側として <xref:System.ServiceModel.Channels.CommunicationObject> コンストラクターに渡されたオブジェクト \(そのコンストラクター オーバーロードを使用した場合\) になります。EventArgs パラメーター `e` は、常に `EventArgs.Empty` です。  
+  
+### 派生オブジェクト コールバック  
+ <xref:System.ServiceModel.Channels.CommunicationObject> は、5 つのイベントのほかに、状態遷移が発生する前後に派生オブジェクトのコールバックを可能にする 8 つの保護された仮想メソッドを宣言します。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.Open%2A?displayProperty=fullName> メソッドと <xref:System.ServiceModel.Channels.CommunicationObject.Close%2A?displayProperty=fullName> メソッドには、このような 3 つのコールバックがそれぞれに関連付けられています。たとえば、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A?displayProperty=fullName> に対応するのは、<xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A?displayProperty=fullName>、<xref:System.ServiceModel.Channels.CommunicationObject.OnOpen%2A?displayProperty=fullName>、および <xref:System.ServiceModel.Channels.CommunicationObject.OnOpened%2A?displayProperty=fullName> です。<xref:System.ServiceModel.Channels.CommunicationObject.Close%2A?displayProperty=fullName> には、<xref:System.ServiceModel.Channels.CommunicationObject.OnClose%2A?displayProperty=fullName>、<xref:System.ServiceModel.Channels.CommunicationObject.OnClosing%2A?displayProperty=fullName>、および <xref:System.ServiceModel.Channels.CommunicationObject.OnClosed%2A?displayProperty=fullName> の各メソッドが関連付けられています。  
+  
+ 同様に、<xref:System.ServiceModel.Channels.CommunicationObject.Abort%2A?displayProperty=fullName> メソッドには、対応する <xref:System.ServiceModel.Channels.CommunicationObject.OnAbort%2A?displayProperty=fullName> があります。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.OnOpen%2A?displayProperty=fullName>、<xref:System.ServiceModel.Channels.CommunicationObject.OnClose%2A?displayProperty=fullName>、および <xref:System.ServiceModel.Channels.CommunicationObject.OnAbort%2A?displayProperty=fullName> には既定の実装がありませんが、他のコールバックには、ステート マシンの正確さを保つために必要な既定の実装があります。これらのメソッドをオーバーライドする場合は、必ず基本実装を呼び出すか、正確に置き換えてください。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A?displayProperty=fullName>、<xref:System.ServiceModel.Channels.CommunicationObject.OnClosing%2A?displayProperty=fullName>、および <xref:System.ServiceModel.Channels.CommunicationObject.OnFaulted%2A?displayProperty=fullName> は、それぞれ対応する <xref:System.ServiceModel.Channels.CommunicationObject.Opening?displayProperty=fullName>、<xref:System.ServiceModel.Channels.CommunicationObject.Closing?displayProperty=fullName>、および <xref:System.ServiceModel.Channels.CommunicationObject.Faulted?displayProperty=fullName> の各イベントを発生させます。<xref:System.ServiceModel.Channels.CommunicationObject.OnOpened%2A?displayProperty=fullName> と <xref:System.ServiceModel.Channels.CommunicationObject.OnClosed%2A?displayProperty=fullName> は、オブジェクトの状態をそれぞれ Opened と Closed に設定してから、対応する <xref:System.ServiceModel.Channels.CommunicationObject.Opened?displayProperty=fullName> イベントと <xref:System.ServiceModel.Channels.CommunicationObject.Closed?displayProperty=fullName> イベントを発生させます。  
+  
+### 状態遷移メソッド  
+ <xref:System.ServiceModel.Channels.CommunicationObject> は、Abort、Close、および Open の実装を提供します。また、Faulted 状態への状態遷移を引き起こす Fault メソッドも提供します。図 2 では、遷移の原因となったメソッドを各遷移に付記して <xref:System.ServiceModel.ICommunicationObject> ステート マシンを示しています \(メソッドが付記されていない遷移は、メソッドが付記されている直前の遷移を発生させたメソッドの実装内部で発生します\)。  
+  
+> [!NOTE]
+>  通信状態の取得\/設定の <xref:System.ServiceModel.Channels.CommunicationObject> 実装はすべて、スレッド同期されます。  
+  
+ コンストラクター  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject> は 3 つのコンストラクターを提供します。これらはすべて、オブジェクトを Created 状態にとどめます。これらのコンストラクターは、次のように定義されています。  
+  
+ 最初のコンストラクターは既定のコンストラクターで、オブジェクトを取得するコンストラクター オーバーロードで代行されます。  
+  
+ `protected CommunicationObject() : this(new object()) { … }`  
+  
+ オブジェクトを取得するコンストラクターは、通信オブジェクトの状態へのアクセスを同期するときにロックされるオブジェクトとしてパラメーターを使用します。  
+  
+ `protected CommunicationObject(object mutex) { … }`  
+  
+ 最後に、3 番目のコンストラクターが、<xref:System.ServiceModel.ICommunicationObject> イベントが発生したときに送信側の引数として使用する追加のパラメーターを取得します。  
+  
+ `protected CommunicationObject(object mutex, object eventSender) { … }`  
+  
+ 前の 2 つのコンストラクターは、送信側をこれに設定します。  
+  
+ Open メソッド  
+  
+ 事前条件 : 状態は Created です。  
+  
+ 事後条件 : 状態は Opened または Faulted です。例外がスローされる場合があります。  
+  
+ Open\(\) メソッドは通信オブジェクトを開き、状態を Opened に設定しようとします。エラーが発生した場合は、状態を Faulted に設定します。  
+  
+ このメソッドは、まず現在の状態が Created であるかを確認します。現在の状態が Opening または Opened の場合、<xref:System.InvalidOperationException> をスローします。現在の状態が Closing または Closed の場合、オブジェクトが終了しているときは <xref:System.ServiceModel.CommunicationObjectAbortedException>、それ以外では <xref:System.ObjectDisposedException> をスローします。現在の状態が Faulted の場合、<xref:System.ServiceModel.CommunicationObjectFaultedException> をスローします。  
+  
+ 次に、状態を Opening に設定し、OnOpening\(\) \(Opening イベントを発生させます\)、OnOpen\(\)、および OnOpened\(\) をこの順に呼び出します。OnOpened\(\) は、状態を Opened に設定し、Opened イベントを発生させます。これらのいずれかが例外をスローした場合、Open\(\) は Fault\(\) を呼び出して例外をバブリングさせます。Open プロセスの詳細を次の図に示します。  
+  
+ ![状態変更](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsigurecoopenflowchartf.gif "wcfc\_WCFChannelsigureCOOpenFlowChartf")  
+カスタム オープン ロジック \(内部通信オブジェクトを開くなど\) を実装するように OnOpen メソッドをオーバーライドします。  
+  
+ Close メソッド  
+  
+ 事前条件 : なし。  
+  
+ 事後条件 : 状態は Closed です。例外がスローされる場合があります。  
+  
+ Close\(\) メソッドはどの状態でも呼び出すことができます。このメソッドは、オブジェクトを正常に閉じようとします。エラーが発生した場合は、オブジェクトを終了します。現在の状態が Closing または Closed の場合、このメソッドは何もしません。それ以外の場合は、状態を Closing に設定します。元の状態が Created、Opening、または Faulted の場合は、Abort\(\) を呼び出します \(次の図を参照してください\)。元の状態が Opened の場合は、OnClosing\(\) \(Closing イベントを発生させます\)、OnClose\(\)、および OnClosed\(\) をこの順に呼び出します。これらのいずれかが例外をスローした場合、Close\(\) は Abort\(\) を呼び出して例外をバブリングさせます。OnClosed\(\) は状態をクローズに設定し、クローズ イベントを発生させます。Close プロセスの詳細を次の図に示します。  
+  
+ ![状態変更](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsguire7ico-closeflowchartc.gif "wcfc\_WCFChannelsguire7ICO\-CloseFlowChartc")  
+OnClose メソッドをオーバーライドして、カスタム クローズ ロジック \(内部通信オブジェクトを閉じるなど\) を実装します。OnClose\(\) はタイムアウト パラメーターを取り、Abort\(\) の一部として呼び出されないため、長時間にわたってブロックできる正常なクロージング ロジック \(たとえば、もう一方の側が応答するまで待機するなど\) はすべて OnClose\(\) で実装してください。  
+  
+ Abort  
+  
+ 事前条件 : なし。  
+事後条件 : 状態は Closed です。例外がスローされる場合があります。  
+  
+ 現在の状態が Closed の場合、またはオブジェクトが既に終了している場合 \(Abort\(\) を別のスレッドで実行するなどにより\)、Abort\(\) メソッドは何もしません。それ以外の場合は、状態を Closing に設定し、OnClosing\(\) \(Closing イベントを発生させます\)、OnAbort\(\)、および OnClosed をこの順に呼び出します \(オブジェクトを閉じるのではなく、終了させるので OnClose を呼び出しません\)。OnClosed\(\) は状態をクローズに設定し、クローズ イベントを発生させます。これらのいずれかが例外をスローした場合は、Abort の呼び出し元に例外が再スローされます。OnClosing\(\)、OnClosed\(\)、および OnAbort\(\) の実装は、入出力などでブロックしないでください。Abort プロセスの詳細を次の図に示します。  
+  
+ ![状態変更](../../../../docs/framework/wcf/extending/media/wcfc-wcfchannelsigure8ico-abortflowchartc.gif "wcfc\_WCFChannelsigure8ICO\-AbortFlowChartc")  
+カスタム終了ロジック \(内部通信オブジェクトを終了するなど\) を実装するように OnAbort メソッドをオーバーライドします。  
+  
+ Fault  
+  
+ Fault は、<xref:System.ServiceModel.Channels.CommunicationObject> に固有のメソッドであり、<xref:System.ServiceModel.ICommunicationObject> インターフェイスの一部ではありません。ここで説明するのは、完全性を期してのことです。  
+  
+ 事前条件 : なし。  
+  
+ 事後条件 : 状態は Faulted です。例外がスローされる場合があります。  
+  
+ 現在の状態が Faulted または Closed の場合、Fault\(\) は何もしません。それ以外の場合は、状態を Faulted に設定し、Faulted イベントを発生させる OnFaulted\(\) を呼び出します。OnFaulted がスローした例外は再スローされます。  
+  
+### ThrowIfXxx メソッド  
+ CommunicationObject には、オブジェクトが特定の状態にある場合に例外をスローするために使用できる 3 つの保護メソッドがあります。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.ThrowIfDisposed%2A> は、状態が Closing、Closed、または Faulted の場合に例外をスローします。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.ThrowIfDisposedOrImmutable%2A> は、状態が Created でない場合に例外をスローします。  
+  
+ <xref:System.ServiceModel.Channels.CommunicationObject.ThrowIfDisposedOrNotOpen%2A> は、状態が Opened でない場合に例外をスローします。  
+  
+ スローされる例外は状態によって決まります。それぞれ異なる状態で ThrowIfXxx を呼び出すことによってスローされる例外の種類を次の表に示します。  
+  
+|State|Abort を呼び出したか|例外|  
+|-----------|-------------------|--------|  
+|Created|N\/A|<xref:System.InvalidOperationException?displayProperty=fullName>|  
+|Opening|N\/A|<xref:System.InvalidOperationException?displayProperty=fullName>|  
+|Opened|N\/A|<xref:System.InvalidOperationException?displayProperty=fullName>|  
+|Closing|○|<xref:System.ServiceModel.CommunicationObjectAbortedException?displayProperty=fullName>|  
+|Closing|×|<xref:System.ObjectDisposedException?displayProperty=fullName>|  
+|Closed|○|事前に Abort を明示的に呼び出してオブジェクトを閉じた場合、<xref:System.ServiceModel.CommunicationObjectAbortedException?displayProperty=fullName>。オブジェクトで Close を呼び出した場合は、<xref:System.ObjectDisposedException?displayProperty=fullName> がスローされます。|  
+|Closed|×|<xref:System.ObjectDisposedException?displayProperty=fullName>|  
+|Faulted|N\/A|<xref:System.ServiceModel.CommunicationObjectFaultedException?displayProperty=fullName>|  
+  
+### タイムアウト  
+ 既に説明したメソッドには、タイムアウト パラメーターを取るものがあります。それらは、Close、Open \(特定のオーバーロードと非同期バージョン\)、OnClose、および OnOpen です。これらのメソッドは、時間のかかる操作 \(たとえば、入出力でブロックしながら、接続を正常に閉じる操作など\) を可能にするように設計されているため、そのような操作が中断されるまでに利用できる時間をタイムアウト パラメーターが示します。これらのどのメソッドの実装も、指定されたタイムアウト値を使用して、そのタイムアウトの範囲内に呼び出し元に確実に復帰する必要があります。タイムアウトを取らない他のメソッドの実装は、時間のかかる操作を目的として設計されていないため、入出力でブロックしないでください。  
+  
+ ただし、タイムアウトを取らない Open\(\) オーバーロードと Close\(\) オーバーロードは例外です。これらは、派生クラスによって提供される既定のタイムアウト値を使用します。<xref:System.ServiceModel.Channels.CommunicationObject> は、<xref:System.ServiceModel.Channels.CommunicationObject.DefaultCloseTimeout%2A> および <xref:System.ServiceModel.Channels.CommunicationObject.DefaultOpenTimeout%2A> という名前の 2 つの保護された抽象プロパティを公開します。これらは、次のように定義されています。  
+  
+ `protected abstract TimeSpan DefaultCloseTimeout { get; }`  
+  
+ `protected abstract TimeSpan DefaultOpenTimeout { get; }`  
+  
+ 派生クラスは、タイムアウト値をとらない Open\(\) オーバーロードと Close\(\) オーバーロードに既定のタイムアウトを提供するために、これらのプロパティを実装します。その後、Open\(\) 実装と Close\(\) 実装は、タイムアウトを取らないオーバーロードに代行させ、既定のタイムアウト値を渡します。この例を次に示します。  
+  
+ `public void Open()`  
+  
+ `{`  
+  
+ `this.Open(this.DefaultOpenTimeout);`  
+  
+ `}`  
+  
+#### IDefaultCommunicationTimeouts  
+ このインターフェイスには、オープン、送信、受信、およびクローズに適用する既定のタイムアウト値を提供する 4 つの読み取り専用プロパティがあります。各実装は、適切な方法で既定値を取得します。便宜上、<xref:System.ServiceModel.Channels.ChannelFactoryBase> と <xref:System.ServiceModel.Channels.ChannelListenerBase> の既定値はそれぞれ 1 分です。
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md b/docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md
new file mode 100644
index 00000000000..8ce09bd24b3
--- /dev/null
+++ b/docs/framework/wcf/extending/walkthrough-creating-custom-client-and-service-credentials.md
@@ -0,0 +1,196 @@
+---
+title: "チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b5ba5c3-0c6c-48e9-9e46-54acaec443ba
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# チュートリアル: カスタム クライアントおよびサービスの資格情報を作成する
+このトピックでは、クライアントおよびサービスにカスタム資格情報を実装する方法と、これをアプリケーション コードから使用する方法について説明します。  
+  
+## 資格情報拡張クラス  
+ <xref:System.ServiceModel.Description.ClientCredentials> クラスおよび <xref:System.ServiceModel.Description.ServiceCredentials> クラスは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティ拡張のメイン エントリ ポイントです。これらの資格情報クラスでは、アプリケーション コードから資格情報を設定し、資格情報の種類をセキュリティ トークンに変換する API を提供します \(*"セキュリティ トークン"* とは、SOAP メッセージ内の資格情報を送信するために使用される形式です\)。これらの資格情報クラスの役割は、次の 2 つの領域に分けることができます。  
+  
+-   アプリケーションで資格情報を設定するための API を提供します。  
+  
+-   <xref:System.IdentityModel.Selectors.SecurityTokenManager> 実装のファクトリとして動作します。  
+  
+ <xref:System.ServiceModel.Description.ClientCredentials> クラスと <xref:System.ServiceModel.Description.ServiceCredentials> クラスは、どちらも <xref:System.IdentityModel.Selectors.SecurityTokenManager> を返すためのコントラクトを定義する <xref:System.ServiceModel.Security.SecurityCredentialsManager> 抽象クラスから継承されます。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)] 資格情報クラス、およびこれらのクラスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ アーキテクチャに組み込まれるしくみの詳細については、「[Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供される既定の実装では、システム指定の資格情報の種類をサポートし、これらの資格情報の種類を処理できるセキュリティ トークン マネージャーを作成します。  
+  
+## カスタマイズする理由  
+ クライアントまたはサービスの資格情報クラスをカスタマイズする場合、いくつかの理由があります。最大の理由として、システム指定の資格情報の種類の処理について、特に以下の必要性が生じたために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の既定のセキュリティ動作を変更する必要があることが挙げられます。  
+  
+-   他の拡張ポイントを使用した場合には不可能な変更  
+  
+-   新しい資格情報の種類の追加  
+  
+-   新しいカスタム セキュリティ トークンの種類の追加  
+  
+ このトピックでは、カスタムのクライアント資格情報およびサービス資格情報を実装する方法と、これをアプリケーション コードから使用する方法について説明します。  
+  
+## 最初の手順  
+ 資格情報をカスタマイズする理由は、資格情報の準備、セキュリティ トークンのシリアル化、または認証に関する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作を変更することにあるため、カスタム資格情報クラスの作成は最初の手順にすぎません。このセクションの他のトピックでは、カスタムのシリアライザーと認証システムを作成する方法について説明します。カスタム資格情報クラスの作成は、このような観点からすると、一連のトピックの最初の手順になります。これに続く処理 \(カスタムのシリアライザーおよび認証システムの作成\) は、カスタム資格情報の作成後にのみ可能になります。このトピックに基づく他のトピックには、次のものがあります。  
+  
+-   [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)  
+  
+-   [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)  
+  
+-   [方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md).  
+  
+## 手順  
+  
+#### カスタム クライアント資格情報を実装するには  
+  
+1.  <xref:System.ServiceModel.Description.ClientCredentials> クラスから派生する新しいクラスを定義します。  
+  
+2.  省略可能。新しい資格情報の種類に新しいメソッドまたはプロパティを追加します。新しい資格情報の種類を追加しない場合は、この手順を省略します。次の例では、`CreditCardNumber` プロパティを追加します。  
+  
+3.  <xref:System.ServiceModel.Security.SecurityCredentialsManager.CreateSecurityTokenManager%2A> メソッドをオーバーライドします。カスタム クライアント資格情報が使用されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャによってこのメソッドが自動的に呼び出されます。このメソッドは、<xref:System.IdentityModel.Selectors.SecurityTokenManager> クラスの実装のインスタンスを作成して返す役割を担います。  
+  
+    > [!IMPORTANT]
+    >  カスタム セキュリティ トークン マネージャーを作成するために、<xref:System.ServiceModel.Security.SecurityCredentialsManager.CreateSecurityTokenManager%2A> メソッドがオーバーライドされることに注意する必要があります。<xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> から派生したセキュリティ トークン マネージャーは、実際のセキュリティ トークンを作成するために、<xref:System.IdentityModel.Selectors.SecurityTokenProvider> から派生したカスタム セキュリティ トークン プロバイダーを返す必要があります。このパターンに従ってセキュリティ トークンを作成しないと、<xref:System.ServiceModel.ChannelFactory> オブジェクトがキャッシュされたとき \(これは、WCF クライアント プロキシの既定の動作です\)、権限の昇格攻撃を受ける可能性があり、アプリケーションが正常に機能しない場合があります。カスタム資格情報オブジェクトは、<xref:System.ServiceModel.ChannelFactory> の一部としてキャッシュされます。ただし、カスタム <xref:System.IdentityModel.Selectors.SecurityTokenManager> がすべての呼び出し時に作成され、これにより、トークン作成ロジックが <xref:System.IdentityModel.Selectors.SecurityTokenManager> にある限り、セキュリティの脅威が軽減されます。  
+  
+4.  <xref:System.ServiceModel.Description.ClientCredentials.CloneCore%2A> メソッドをオーバーライドします。  
+  
+     [!code-csharp[c_CustomCredentials#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#1)]
+     [!code-vb[c_CustomCredentials#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/client/client.vb#1)]  
+  
+#### カスタム クライアント セキュリティ トークン マネージャーを実装するには  
+  
+1.  <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> から派生する新しいクラスを定義します。  
+  
+2.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenProvider> 実装を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenProvider%28System.IdentityModel.Selectors.SecurityTokenRequirement%29> メソッドをオーバーライドします。カスタム セキュリティ トークン プロバイダー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)」を参照してください。  
+  
+3.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator> 実装を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenAuthenticator%28System.IdentityModel.Selectors.SecurityTokenRequirement%2CSystem.IdentityModel.Selectors.SecurityTokenResolver%40%29> メソッドをオーバーライドします。カスタム セキュリティ トークン認証システム[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)」を参照してください。  
+  
+4.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenSerializer> を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenSerializer%2A> メソッドをオーバーライドします。カスタム セキュリティ トークンおよびカスタム セキュリティ トークン シリアライザー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomCredentials#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#2)]
+     [!code-vb[c_CustomCredentials#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/client/client.vb#2)]  
+  
+#### アプリケーション コードによるカスタム クライアント資格情報を使用するには  
+  
+1.  サービス インターフェイスを表す、生成されたクライアントのインスタンスを作成するか、または通信の対象となるサービスを指す <xref:System.ServiceModel.ChannelFactory> のインスタンスを作成します。  
+  
+2.  <xref:System.ServiceModel.Description.ServiceEndpoint.Behaviors%2A> コレクションから、システム指定のクライアント資格情報の動作を削除します。このコレクションには、<xref:System.ServiceModel.ChannelFactory.Endpoint%2A> プロパティからアクセスできます。  
+  
+3.  カスタム資格情報クラスの新しいインスタンスを作成し、<xref:System.ServiceModel.Description.ServiceEndpoint.Behaviors%2A> コレクションに追加します。このコレクションには、<xref:System.ServiceModel.ChannelFactory.Endpoint%2A> プロパティからアクセスできます。  
+  
+     [!code-csharp[c_CustomCredentials#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#3)]
+     [!code-vb[c_CustomCredentials#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/client/client.vb#3)]  
+  
+ 上記の手順は、アプリケーション コードからクライアント資格情報を使用する方法を示しています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の資格情報は、アプリケーション構成ファイルを使用して構成することもできます。ソースの変更、再コンパイル、再展開を行うことなくアプリケーションのパラメーターを変更できるため、ハードコーディングを行うよりもアプリケーション構成ファイルの使用を一般にお勧めします。  
+  
+ 次の手順では、カスタム資格情報の構成をサポートする方法について説明します。  
+  
+#### カスタム クライアント資格情報の構成ハンドラーの作成  
+  
+1.  <xref:System.ServiceModel.Configuration.ClientCredentialsElement> から派生する新しいクラスを定義します。  
+  
+2.  省略可能。アプリケーション構成を通じて公開する必要があるすべての追加構成パラメーターのプロパティを追加します。次の例では、`CreditCardNumber` という名前のプロパティを追加します。  
+  
+3.  <xref:System.ServiceModel.Configuration.BehaviorExtensionElement.BehaviorType%2A> プロパティをオーバーライドして、構成要素によって作成されたカスタム クライアント資格情報クラスの型を返します。  
+  
+4.  <xref:System.ServiceModel.Configuration.BehaviorExtensionElement.CreateBehavior%2A> メソッドをオーバーライドします。このメソッドは、構成ファイルから読み込まれた設定に基づいてカスタム資格情報クラスのインスタンスを作成して返す役割を担います。このメソッドから <xref:System.ServiceModel.Configuration.ClientCredentialsElement.ApplyConfiguration%28System.ServiceModel.Description.ClientCredentials%29> 基本メソッドを呼び出し、カスタム クライアント資格情報インスタンスに読み込まれたシステム指定の資格情報の設定を取得します。  
+  
+5.  省略可能。手順 2. で追加のプロパティを追加している場合は、<xref:System.Configuration.ConfigurationElement.Properties%2A> プロパティをオーバーライドして、追加した構成設定が構成フレームワークから認識されるよう登録します。追加したプロパティを基本クラスのプロパティと結合して、このカスタム クライアント資格情報の構成要素を通じてシステム指定の設定が構成されるようにします。  
+  
+     [!code-csharp[c_CustomCredentials#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#7)]
+     [!code-vb[c_CustomCredentials#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/service/service.vb#7)]  
+  
+ 構成ハンドラー クラスを作成したら、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の構成フレームワークに統合できます。これにより、次の手順で示すように、カスタム クライアント資格情報をクライアント エンドポイント動作要素で使用できるようになります。  
+  
+#### カスタム クライアント資格情報構成ハンドラーをアプリケーション構成に登録して使用するには  
+  
+1.  \<`extensions`\> 要素、および \<`behaviorExtensions`\> 要素を構成ファイルに追加します。  
+  
+2.  \<`add`\> 要素を \<`behaviorExtensions`\> 要素に追加し、`name` 属性を適切な値に設定します。  
+  
+3.  `type` 属性を完全修飾型名に設定します。また、アセンブリ名と他のアセンブリ属性を含めます。  
+  
+    ```  
+    <system.serviceModel>  
+      <extensions>  
+        <behaviorExtensions>  
+          <add name="myClientCredentials" type="Microsoft.ServiceModel.Samples.MyClientCredentialsConfigHandler, CustomCredentials, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+        </behaviorExtensions>  
+      </extensions>  
+    <system.serviceModel>  
+    ```  
+  
+4.  構成ハンドラーの登録後は、システム指定の \<`clientCredentials`\> 要素の代わりに、同じ構成ファイル内でカスタム資格情報要素を使用できます。システム指定のプロパティと、構成ハンドラーの実装に追加した任意の新規プロパティのどちらも使用できます。次の例では、`creditCardNumber` 属性を使用して、カスタム プロパティの値を設定します。  
+  
+    ```  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="myClientCredentialsBehavior">  
+          <myClientCredentials creditCardNumber="123-123-123"/>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    ```  
+  
+#### カスタム サービス資格情報を実装するには  
+  
+1.  <xref:System.ServiceModel.Description.ServiceCredentials> から派生する新しいクラスを定義します。  
+  
+2.  省略可能。追加している新しい資格情報の値に API を提供するために新しいプロパティを追加します。新しい資格情報の値を追加しない場合は、この手順を省略します。次の例では、`AdditionalCertificate` プロパティを追加します。  
+  
+3.  <xref:System.ServiceModel.Security.SecurityCredentialsManager.CreateSecurityTokenManager%2A> メソッドをオーバーライドします。カスタム クライアント資格情報が使用されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャによって、このメソッドが自動的に呼び出されます。このメソッドは、<xref:System.IdentityModel.Selectors.SecurityTokenManager> クラスの実装のインスタンスを作成して返す役割を担います \(次の手順で説明\)。  
+  
+4.  省略可能。<xref:System.ServiceModel.Description.ServiceCredentials.CloneCore%2A> メソッドをオーバーライドします。この手順は、カスタム クライアント資格情報の実装に新しいプロパティまたは内部フィールドを追加する場合にのみ必要になります。  
+  
+     [!code-csharp[c_CustomCredentials#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#4)]
+     [!code-vb[c_CustomCredentials#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/service/service.vb#4)]  
+  
+#### カスタム サービス セキュリティ トークン マネージャーを実装するには  
+  
+1.  <xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager> クラスから派生する新しいクラスを定義します。  
+  
+2.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenProvider> 実装を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenProvider%2A> メソッドをオーバーライドします。カスタム セキュリティ トークン プロバイダー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)」を参照してください。  
+  
+3.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator> 実装を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenAuthenticator%2A> メソッドをオーバーライドします。カスタム セキュリティ トークン認証システム[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)」を参照してください。  
+  
+4.  省略可能。カスタム <xref:System.IdentityModel.Selectors.SecurityTokenSerializer> を作成する必要がある場合は、<xref:System.IdentityModel.Selectors.SecurityTokenManager.CreateSecurityTokenSerializer%2A> メソッドをオーバーライドします。カスタム セキュリティ トークンおよびカスタム セキュリティ トークン シリアライザー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)」を参照してください。  
+  
+     [!code-csharp[c_CustomCredentials#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#5)]
+     [!code-vb[c_CustomCredentials#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/service/service.vb#5)]  
+  
+#### アプリケーション コードによるカスタム サービス資格情報を使用するには  
+  
+1.  <xref:System.ServiceModel.ServiceHost> のインスタンスを作成します。  
+  
+2.  <xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A> コレクションから、システム指定のサービス資格情報の動作を削除します。  
+  
+3.  カスタム サービス資格情報クラスの新しいインスタンスを作成し、これを <xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A> コレクションに追加します。  
+  
+     [!code-csharp[c_CustomCredentials#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customcredentials/cs/source.cs#6)]
+     [!code-vb[c_CustomCredentials#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customcredentials/vb/service/service.vb#6)]  
+  
+ 前の「`To create a configuration handler for custom client credentials`」および「`To register and use a custom client credentials configuration handler in the application configuration`」で説明した手順を使用して構成にサポートを追加します。構成ハンドラーの基本クラスとして、<xref:System.ServiceModel.Configuration.ClientCredentialsElement> クラスではなく <xref:System.ServiceModel.Configuration.ServiceCredentialsElement> クラスを使用する点のみが異なります。カスタム サービス資格情報要素は、システム指定の `<serviceCredentials>` 要素を使用する場合にいつでも使用できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ServiceCredentials>   
+ <xref:System.ServiceModel.Security.SecurityCredentialsManager>   
+ <xref:System.IdentityModel.Selectors.SecurityTokenManager>   
+ <xref:System.ServiceModel.Configuration.ClientCredentialsElement>   
+ <xref:System.ServiceModel.Configuration.ServiceCredentialsElement>   
+ [方法 : カスタム セキュリティ トークン プロバイダーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-provider.md)   
+ [方法 : カスタム セキュリティ トークン認証システムを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-security-token-authenticator.md)   
+ [方法 : カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/extending/ws-metadataexchange-bindings.md b/docs/framework/wcf/extending/ws-metadataexchange-bindings.md
new file mode 100644
index 00000000000..85cac6ec2e3
--- /dev/null
+++ b/docs/framework/wcf/extending/ws-metadataexchange-bindings.md
@@ -0,0 +1,29 @@
+---
+title: "WS-MetadataExchange のバインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 10f8de5d-b81d-4ea7-b37e-7f2c00c39714
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WS-MetadataExchange のバインディング
+ここでは、既定のメタデータ交換バインディングを各種のトランスポート用に構築する方法を説明します。  
+  
+## 既定のバインディング  
+  
+|既定のバインディング名|バインディングを構築する方法|  
+|-----------------|--------------------|  
+|MexHttpBinding|トランスポート レベルのセキュリティが無効な <xref:System.ServiceModel.WSHttpBinding>。|  
+|MexHttpsBinding|トランスポート レベルのセキュリティをサポートする <xref:System.ServiceModel.WSHttpBinding>。|  
+|MexNamedPipeBinding|<xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement> で既定値を使用する <xref:System.ServiceModel.Channels.CustomBinding>。|  
+|MexTcpBinding|<xref:System.ServiceModel.Channels.TcpTransportBindingElement> で既定値を使用する <xref:System.ServiceModel.Channels.CustomBinding>。|
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/TOC.md b/docs/framework/wcf/feature-details/TOC.md
new file mode 100644
index 00000000000..cc18fd77f0b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/TOC.md
@@ -0,0 +1,434 @@
+# [方法 : Atom および RSS の両方としてフィードを公開する](how-to-expose-a-feed-as-both-atom-and-rss.md)
+# [NetHttpBinding の使用](using-the-nethttpbinding.md)
+# [方法 : デジタル署名の暗号化を無効にする](how-to-disable-encryption-of-digital-signatures.md)
+# [資格情報ネゴシエーションを使用しない Windows クライアントを使用するメッセージ セキュリティ](message-security-with-a-windows-client-without-credential-negotiation.md)
+# [方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する](how-to-create-a-custom-reliable-session-binding-with-https.md)
+# [WCF サービス パフォーマンスを制御するための ServiceThrottlingBehavior の使用](using-servicethrottlingbehavior-to-control-wcf-service-performance.md)
+# [中間層クライアント アプリケーション](middle-tier-client-applications.md)
+# [探索機能のバージョン指定](discovery-versioning.md)
+# [方法 : チャネルのセキュリティ資格情報を指定する](how-to-specify-channel-security-credentials.md)
+# [方法 : メタデータの取得および準拠サービスの実装をする](how-to-retrieve-metadata-and-implement-a-compliant-service.md)
+# [Windows Communication Foundation の採用 : 将来の移行の簡略化](anticipating-adopting-wcf-migration.md)
+# [セキュリティの概要](security-overview.md)
+# [方法 : 構成にサービス エンドポイントを作成する](how-to-create-a-service-endpoint-in-configuration.md)
+# [コンテンツ ベース](content-based-correlation.md)
+# [セキュリティで保護されていないイントラネットのクライアントとサービス](intranet-unsecured-client-and-service.md)
+# [方法 : COM+ サービス設定を構成する](how-to-configure-com-service-settings.md)
+# [Windows サービス アプリケーションのホスト](hosting-in-a-windows-service-application.md)
+# [JSONP の使用](using-jsonp.md)
+# [開発者の視点から見た ASP.NET Web サービスと WCF との比較](comparing-aspnet-web-services-to-wcf-based-on-development.md)
+# [方法 : IIS でサービス以外のワークフローをホストする](how-to-host-a-non-service-workflow-in-iis.md)
+# [WCF での複数の認証方式の使用](using-multiple-authentication-schemes-with-wcf.md)
+# [フィルターを使用する方法](how-to-use-filters.md)
+# [Web サービス プロトコルの相互運用性ガイド](web-services-protocols-interoperability-guide.md)
+# [方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する](how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md)
+# [シリアル化可能な型](serializable-types.md)
+# [Net.TCP ポート共有](net-tcp-port-sharing.md)
+# [データ コントラクトの等価性](data-contract-equivalence.md)
+# [方法: 構成ファイルを使用してサービスのメタデータを公開する](how-to-publish-metadata-for-a-service-using-a-configuration-file.md)
+# [クレームとトークン](claims-and-tokens.md)
+# [ServiceDescription と WSDL 参照](servicedescription-and-wsdl-reference.md)
+# [方法 : 未登録で Windows Communication Foundation のサービス モニカーを使用する](use-the-wcf-service-moniker-without-registration.md)
+# [セキュリティ プロトコル バージョン 1.0](security-protocols-version-1-0.md)
+# [相関関係の概要](correlation-overview.md)
+# [WCF Web HTTP プログラミング オブジェクト モデル](wcf-web-http-programming-object-model.md)
+# [配信のアーキテクチャ](architecture-of-syndication.md)
+# [方法: WorkflowServiceHost を使用して追跡を構成する](how-to-configure-tracking-with-workflowservicehost.md)
+# [ルーティング シナリオ](routing-scenarios.md)
+# [WCF 配信](wcf-syndication.md)
+# [探索プロキシで登録される探索可能なサービスの実装方法](discoverable-service-that-registers-with-the-discovery-proxy.md)
+# [WCF でのキュー](queuing-in-wcf.md)
+# [Web サービス拡張 3.0 との相互運用](interoperability-with-web-services-enhancements-3-0.md)
+# [署名または暗号化、あるいはその両方が行われたカスタム ヘッダーの作成](creating-a-custom-header-that-is-signed-and-or-encrypted.md)
+# [System.ServiceModel でのトランザクション サポート](transactional-support-in-system-servicemodel.md)
+# [メタデータを使用する場合のセキュリティ上の考慮事項](security-considerations-with-metadata.md)
+# [方法 : セキュリティ イベントを監査する](how-to-audit-wcf-security-events.md)
+# [サービスおよびクライアントのセキュリティ保護](securing-services-and-clients.md)
+# [方法 : サービス モニカーを登録および構成する](how-to-register-and-configure-a-service-moniker.md)
+# [方法 : WCF REST プログラミング モデルを使用して任意のデータを受け入れるサービスを作成する](create-a-service-arbitrary-data-using-wcf.md)
+# [方法 : WSFederationHttpBinding を作成する](how-to-create-a-wsfederationhttpbinding.md)
+# [ワークフロー サービスの概要](workflow-services-overview.md)
+# [方法 : ASP.NET Web サービス コードを Windows Communication Foundation に移行する](migrate-asp-net-web-service-to-wcf.md)
+# [COM+ と ServiceModel でのトランザクションの比較](comparing-transactions-in-com-and-servicemodel.md)
+# [COM+ アプリケーションとの統合の概要](integrating-with-com-plus-applications-overview.md)
+# [WorkflowServiceHost を使用して永続性を構成する方法](how-to-configure-persistence-with-workflowservicehost.md)
+# [WCF Web HTTP 形式](wcf-web-http-formatting.md)
+# [Windows ストア クライアント アプリを使用した WCF サービスへのアクセス](accessing-wcf-services-with-a-windows-store-client-app.md)
+# [方法 : サービスのインスタンス化を制御する](how-to-control-service-instancing.md)
+# [サービス拒否](denial-of-service.md)
+# [IIS でホストされる WCF サービスに SSL を構成する方法](how-to-configure-an-iis-hosted-wcf-service-with-ssl.md)
+# [エラーを処理する方法](how-to-error-handling.md)
+# [インターネット インフォメーション サービスでのホスティング](hosting-in-internet-information-services.md)
+# [探索プロキシの実装](implementing-a-discovery-proxy.md)
+# [ピア チャネルのシナリオ](peer-channel-scenarios.md)
+# [方法 : 証明書のサムプリントを取得する](how-to-retrieve-the-thumbprint-of-a-certificate.md)
+# [探索プロキシをテストする方法](how-to-test-the-discovery-proxy.md)
+# [ピア メッシュ](peer-meshes.md)
+# [WorkflowServiceHost の構成](configuring-workflowservicehost.md)
+# [ピア リゾルバー](peer-resolvers.md)
+# [Trust プロトコルが混在するフェデレーション シナリオ](mixing-trust-protocols-in-federated-scenarios.md)
+# [方法 : 証明書を取得する](how-to-obtain-a-certificate-wcf.md)
+# [セキュリティによるピア チャネル アプリケーションの保護](securing-peer-channel-applications.md)
+# [方法 : ChannelFactory を使用する](how-to-use-the-channelfactory.md)
+# [NetTcpBinding アプリケーションからピア チャネル アプリケーションへの変換](converting-a-nettcpbinding-application-to-a-peer-channel-application.md)
+# [使用目的と使用標準に基づく ASP.NET Web サービスと WCF との比較](comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md)
+# [HTTP トランスポート セキュリティ](http-transport-security.md)
+# [Windows プロセス アクティブ化サービスでのホスティング](hosting-in-windows-process-activation-service.md)
+# [メッセージ クラスの使用](using-the-message-class.md)
+# [方法 : Svcutil.exe を使用してコンパイル済みサービス コードを検証する](how-to-use-svcutil-exe-to-validate-compiled-service-code.md)
+# [方法 : サポート資格情報を作成する](how-to-create-a-supporting-credential.md)
+# [要求/応答](request-reply-correlation.md)
+# [方法 : 同じ型の複数のセキュリティ トークンを使用する](how-to-use-multiple-security-tokens-of-the-same-type.md)
+# [WSDL とポリシー](wsdl-and-policy.md)
+# [クライアント](clients.md)
+# [方法 : チャネル ファクトリを使用して、非同期的に操作を呼び出す](how-to-call-operations-asynchronously-using-a-channel-factory.md)
+# [WS-AtomicTransaction サポートの構成](configuring-ws-atomic-transaction-support.md)
+# [相互運用可能なオブジェクト参照](interoperable-object-references.md)
+# [メッセージ フィルター](message-filters.md)
+# [メッセージ セキュリティと匿名クライアント](message-security-with-an-anonymous-client.md)
+# [ルーティング サービス](routing-service.md)
+# [COM アプリケーションとの統合](integrating-with-com-applications.md)
+# [Error handling](error-handling.md)
+# [方法 : Net.TCP ポート共有サービスを有効にする](how-to-enable-the-net-tcp-port-sharing-service.md)
+# [WCF と国際化ドメイン名](wcf-and-internationalized-domain-names.md)
+# [コントラクト](contracts.md)
+# [WCF クライアントを使用したサービスへのアクセス](accessing-services-using-a-client.md)
+# [キューに置かれたアプリケーションの Web ホスト](web-hosting-a-queued-application.md)
+# [Windows Communication Foundation のトランザクションの概要](transactions-overview.md)
+# [XmlSerializer クラスの使用](using-the-xmlserializer-class.md)
+# [方法 : Metadata Exchange コントラクトと共にサービス モニカーを使用する](how-to-use-a-service-moniker-with-metadata-exchange-contracts.md)
+# [生成されたクライアント コードの理解](understanding-generated-client-code.md)
+# [データ コントラクトの XML および ADO.NET の種類](xml-and-ado-net-types-in-data-contracts.md)
+# [ワークフロー サービス ホストの拡張機能](workflow-service-host-extensibility.md)
+# [資格情報の種類の選択](selecting-a-credential-type.md)
+# [ルーティングの概要](routing-introduction.md)
+# [ルーティング](routing.md)
+# [方法 : 開発中に使用する一時的な証明書を作成する](how-to-create-temporary-certificates-for-use-during-development.md)
+# [方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する](how-to-create-a-basic-data-contract-for-a-class-or-structure.md)
+# [方法 : コントラクトを SOAP クライアントおよび Web クライアントに公開する](how-to-expose-a-contract-to-soap-and-web-clients.md)
+# [クラスからのスキーマのエクスポート](exporting-schemas-from-classes.md)
+# [WebSockets 上で通信する WCF サービスを作成する用法](how-to-create-a-wcf-service-that-communicates-over-websockets.md)
+# [メタデータ形式](metadata-formats.md)
+# [SerializationBinder を使用したシリアル化および逆シリアル化の制御](controlling-serialization-and-deserialization-with-serializationbinder.md)
+# [ASP.NET を使用せずに WCF AJAX サービスを作成する方法](creating-wcf-ajax-services-without-aspnet.md)
+# [構成ファイルにおける探索の構成](configuring-discovery-in-a-configuration-file.md)
+# [WCF サービスと ASP.NET](wcf-services-and-aspnet.md)
+# [信頼できるセッションのベスト プラクティス](best-practices-for-reliable-sessions.md)
+# [クラスを作成するためのスキーマのインポート](importing-schema-to-generate-classes.md)
+# [方法 : SSL 証明書を使用してポートを構成する](how-to-configure-a-port-with-an-ssl-certificate.md)
+# [キューの概要](queues-overview.md)
+# [方法 : セキュリティで保護されたセッションを作成する](how-to-create-a-secure-session.md)
+# [Net.TCP ポート共有サービスを構成する](configuring-the-net-tcp-port-sharing-service.md)
+# [方法 : メタデータをサービス エンドポイントからエクスポートする](how-to-export-metadata-from-service-endpoints.md)
+# [方法 : メタデータをサービス エンドポイントにインポートする](how-to-import-metadata-into-service-endpoints.md)
+# [データ コントラクトの列挙型](enumeration-types-in-data-contracts.md)
+# [バインディングでのタイムアウト値の構成](configuring-timeout-values-on-a-binding.md)
+# [基本認証でのトランスポート セキュリティ](transport-security-with-basic-authentication.md)
+# [方法 : ASP.NET AJAX エンドポイントのために HTTP POST または HTTP GET を選択する](http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md)
+# [方法: Probe 要求の探索バージョンを特定する](how-to-determine-the-discovery-version-of-a-probe-request.md)
+# [ワークフロー サービスから OperationContext へのアクセス](accessing-operationcontext-from-a-workflow-service.md)
+# [トランスポートの選択](choosing-a-transport.md)
+# [HTTP および HTTPS の構成](configuring-http-and-https.md)
+# [方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する](how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md)
+# [方法 : IIS で WCF サービスをホストする](how-to-host-a-wcf-service-in-iis.md)
+# [マネージ アプリケーションのホスト](hosting-in-a-managed-application.md)
+# [WCF 配信の概要](wcf-syndication-overview.md)
+# [ワークフロー サービス ホストの内部](workflow-service-host-internals.md)
+# [方法 : 信頼できるセッション内でメッセージをセキュリティで保護する](how-to-secure-messages-within-reliable-sessions.md)
+# [ピアツーピア ネットワーク](peer-to-peer-networking.md)
+# [大規模データとストリーミング](large-data-and-streaming.md)
+# [Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](diff-in-queue-in-vista-server-2003-windows-xp.md)
+# [ワークフロー サービス内でのシリアル化の構成](configuring-serialization-in-a-workflow-service.md)
+# [バージョン トレラントなシリアル化コールバック](version-tolerant-serialization-callbacks.md)
+# [Single 同時実行モードでメッセージを順番に処理する](ordered-processing-of-messages-in-single-concurrency-mode.md)
+# [方法 : WSDL コントラクトと共にサービス モニカーを使用する](how-to-use-a-service-moniker-with-wsdl-contracts.md)
+# [メッセージのセキュリティ](message-security-in-wcf.md)
+# [信頼できるセッションの概要](reliable-sessions-overview.md)
+# [セキュリティに関するデータの考慮事項](security-considerations-for-data.md)
+# [方法 : 指定した認証モード用の SecurityBindingElement を作成する](how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)
+# [ClaimSet でのクレームの検索](finding-claims-in-a-claimset.md)
+# [方法 : 一貫性を保って X.509 証明書を参照する](how-to-consistently-reference-x-509-certificates.md)
+# [ピア チャネル アプリケーションの構築](building-a-peer-channel-application.md)
+# [キューに置かれたメッセージングのトラブルシューティング](troubleshooting-queued-messaging.md)
+# [信頼できるメッセージング プロトコル バージョン 1.0](reliable-messaging-protocol-version-1-0.md)
+# [方法 : X.509 証明書を WCF からアクセス可能にする](how-to-make-x-509-certificates-accessible-to-wcf.md)
+# [方法 : ユーザー名とパスワードで認証する](how-to-authenticate-with-a-user-name-and-password.md)
+# [JSON などのデータ転送形式のサポート](support-for-json-and-other-data-transfer-formats.md)
+# [サービス ID と認証](service-identity-and-authentication.md)
+# [データ コントラクトの使用](using-data-contracts.md)
+# [部分信頼機能の互換性](partial-trust-feature-compatibility.md)
+# [カスタム バインディングを使用したセキュリティ機能](security-capabilities-with-custom-bindings.md)
+# [メッセージ セキュリティを使用したメッセージのセキュリティ保護](securing-messages-using-message-security.md)
+# [トランザクション フローの有効化](enabling-transaction-flow.md)
+# [方法 : セキュリティで保護されたメタデータ エンドポイント](how-to-secure-metadata-endpoints.md)
+# [データ コントラクト スキーマの参照](data-contract-schema-reference.md)
+# [配信不能キューを使用したメッセージ転送エラー処理](using-dead-letter-queues-to-handle-message-transfer-failures.md)
+# [方法 : WAS で WCF サービスをホストする](how-to-host-a-wcf-service-in-was.md)
+# [Internet Explorer と WCF で実行されるサービス証明書の検証の相違点](diff-service-certificate-validation-ie-and-wcf.md)
+# [エンドポイント : アドレス、バインディング、およびコントラクト](endpoints-addresses-bindings-and-contracts.md)
+# [アクセス制御機構](access-control-mechanisms.md)
+# [ルーティング コントラクト](routing-contracts.md)
+# [動的な更新を行う方法](how-to-dynamic-update.md)
+# [データ コントラクトのコレクション型](collection-types-in-data-contracts.md)
+# [WCF 機能の詳細](index.md)
+# [メッセージ セキュリティと相互の証明書](message-security-with-mutual-certificates.md)
+# [方法: 別のワークフロー サービスを呼び出すワークフロー サービスを作成する](how-to-create-a-workflow-service-that-calls-another-workflow-service.md)
+# [メッセージ セキュリティと証明書クライアント](message-security-with-a-certificate-client.md)
+# [探索検索と FindCriteria](discovery-find-and-findcriteria.md)
+# [方法 : セキュリティ トークン サービスを作成する](how-to-create-a-security-token-service.md)
+# [COM+ アプリケーションとの統合](integrating-with-com-plus-applications.md)
+# [相関関係のトラブルシューティング](troubleshooting-correlation.md)
+# [カスタム フィルター](custom-filters.md)
+# [セキュリティで保護されていないインターネット環境のクライアントとサービス](internet-unsecured-client-and-service.md)
+# [トランスポート セキュリティと Windows 認証](transport-security-with-windows-authentication.md)
+# [方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする](how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md)
+# [チャネル ファクトリとキャッシュ](channel-factory-and-caching.md)
+# [HTTPS、SSL Over TCP、SOAP セキュリティ間における証明書検証方法の相違点](cert-val-diff-https-ssl-over-tcp-and-soap.md)
+# [方法 : AJAX 対応 WCF サービスを作成し、アクセスする](create-an-ajax-wcf-asp-net-client.md)
+# [セキュリティの概念](security-concepts.md)
+# [ワークフロー内でのコントラクトの使用](using-contracts-in-workflow.md)
+# [方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する](how-to-exchange-queued-messages-with-wcf-endpoints.md)
+# [HTTP 認証の理解](understanding-http-authentication.md)
+# [SAML (Security Assertions Markup Language) トークンとクレーム](saml-tokens-and-claims.md)
+# [方法: ワークフロー アプリケーションからサービスにアクセスする](how-to-access-a-service-from-a-workflow-application.md)
+# [認証](authentication-in-wcf.md)
+# [方法 : 承認中にメタデータ要求を許可する](how-to-allow-metadata-requests-while-authorizing.md)
+# [トランスポート セキュリティを使用したメッセージのセキュリティ保護](securing-messages-using-transport-security.md)
+# [永続的な二重](durable-duplex-correlation.md)
+# [承認](authorization-in-wcf.md)
+# [方法 : マネージ Windows サービスで WCF サービスをホストする](how-to-host-a-wcf-service-in-a-managed-windows-service.md)
+# [方法 : カスタム ユーザー名およびパスワード検証を使用する](how-to-use-a-custom-user-name-and-password-validator.md)
+# [有害メッセージ処理](poison-message-handling.md)
+# [方法 : メッセージ リプレイ検出を有効にする](how-to-enable-message-replay-detection.md)
+# [メッセージ配布の制限](limiting-message-distribution.md)
+# [方法 : セッションを必要とするサービスを作成する](how-to-create-a-service-that-requires-sessions.md)
+# [方法 : ASP.NET のロール プロバイダーとサービスを使用する](how-to-use-the-aspnet-role-provider-with-a-service.md)
+# [方法 : JSON データをシリアル化および逆シリアル化する](how-to-serialize-and-deserialize-json-data.md)
+# [方法 : 信頼されたセッション内のメッセージを変換する](how-to-exchange-messages-within-a-reliable-session.md)
+# [方法 : 基本的な WCF Web HTTP サービスを作成する](how-to-create-a-basic-wcf-web-http-service.md)
+# [トランスポート セキュリティ](transport-security.md)
+# [方法 : 一方向コントラクトを作成する](how-to-create-a-one-way-contract.md)
+# [WCF Discovery の概要](wcf-discovery-overview.md)
+# [メッセージング アクティビティ](messaging-activities.md)
+# [方法 : Windows Server AppFabric を使用してワークフロー サービスをホストする](how-to-host-a-workflow-service-with-windows-server-app-fabric.md)
+# [WCF Discovery オブジェクト モデル](wcf-discovery-object-model.md)
+# [バインディング](bindings.md)
+# [ワークフロー ソリューションでのサービス参照の追加](adding-a-service-reference-in-a-workflow-solution.md)
+# [パフォーマンスに関する考慮事項](performance-considerations.md)
+# [拡張保護認証のサンプルの ReadMe](readme-for-extended-protection-authentication-sample.md)
+# [方法 : 要求/応答コントラクトを作成する](how-to-create-a-request-reply-contract.md)
+# [WCF WEB HTTP サービスのキャッシュ サポート](caching-support-for-wcf-web-http-services.md)
+# [セキュリティ](security.md)
+# [キューと信頼できるセッション](queues-and-reliable-sessions.md)
+# [方法 : COM+ サービス モデル構成ツールを使用する](how-to-use-the-com-service-model-configuration-tool.md)
+# [方法 : 一方向コントラクトと要求/応答コントラクトを使用してサービスにアクセスする](how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md)
+# [サービス エンドポイントとキューのアドレス指定](service-endpoints-and-queue-addressing.md)
+# [DiscoveryClient と DynamicEndpoint](discoveryclient-and-dynamicendpoint.md)
+# [方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)
+# [方法 : 署名の検証に使用する証明機関の証明書チェーンを指定する](specify-the-certificate-authority-chain-verify-signatures-wcf.md)
+# [サービス コントラクトでのデータ転送の指定](specifying-data-transfer-in-service-contracts.md)
+# [WSE 3.0 Web サービスの WCF への移行](migrating-wse-3-0-web-services-to-wcf.md)
+# [方法 : コントラクト インターフェイスを使用してサービスを作成する](how-to-create-a-service-with-a-contract-interface.md)
+# [セキュリティで保護されたセッション](secure-sessions.md)
+# [ワークフロー サービス](workflow-services.md)
+# [リプレイ攻撃](replay-attacks.md)
+# [セキュリティ ガイドラインとベスト プラクティス](security-guidance-and-best-practices.md)
+# [探索プロキシを実装する方法](how-to-implement-a-discovery-proxy.md)
+# [WCF サービスからの REST スタイル サービスの呼び出し](calling-a-rest-style-service-from-a-wcf-service.md)
+# [NAT とファイアウォールの使用](working-with-nats-and-firewalls.md)
+# [UDP トランスポートを使用するマルチキャスト アプリケーションの作成](creating-multicasting-applications-using-the-udp-transport.md)
+# [方法 : 双方向コントラクトを使用してサービスにアクセスする](how-to-access-services-with-a-duplex-contract.md)
+# [WCF セキュリティのプログラミング](programming-wcf-security.md)
+# [データ コントラクト シリアライザーでサポートされる型](types-supported-by-the-data-contract-serializer.md)
+# [発行済みトークンを使用したメッセージ セキュリティ](message-security-with-issued-tokens.md)
+# [メッセージ転送ストリーミング](streaming-message-transfer.md)
+# [サポートされていないシナリオ](unsupported-scenarios.md)
+# [証明書の使用](working-with-certificates.md)
+# [方法 : 基本的な ATOM フィードを作成する](how-to-create-a-basic-atom-feed.md)
+# [方法 : トランスポート セキュリティとメッセージ資格情報を使用する](how-to-use-transport-security-and-message-credentials.md)
+# [方法 : ストリーミングを有効にする](how-to-enable-streaming.md)
+# [IIS と WAS における構成ベースのアクティブ化](configuration-based-activation-in-iis-and-was.md)
+# [セキュリティ用語](wcf-security-terminology.md)
+# [フィルターの選択](choosing-a-filter.md)
+# [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)
+# [メタデータ](metadata.md)
+# [方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](how-to-create-a-security-context-token-for-a-secure-session.md)
+# [方法 : ポート共有を使用するように WCF サービスを構成する](how-to-configure-a-wcf-service-to-use-port-sharing.md)
+# [WCF Web HTTP サービスのヘルプ ページ](wcf-web-http-service-help-page.md)
+# [セッションでキューに置かれたメッセージのグループ化](grouping-queued-messages-in-a-session.md)
+# [探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法](client-app-discovery-proxy-to-find-a-service.md)
+# [ASP.NET Web サービスとの相互運用](interop-with-aspnet-web-services.md)
+# [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)
+# [メタデータのエクスポートとインポート](exporting-and-importing-metadata.md)
+# [WorkflowServiceHost による side-by-side でのバージョン管理](side-by-side-versioning-in-workflowservicehost.md)
+# [関連付け](correlation.md)
+# [メッセージ レベルのプログラミングによる JSON 形式でのシリアル化](serializing-in-json-with-message-level-programming.md)
+# [WCF クライアントの構成](client-configuration.md)
+# [UriTemplate と UriTemplateTable](uritemplate-and-uritemplatetable.md)
+# [メッセージング プロトコル](messaging-protocols.md)
+# [WAS アクティベーション アーキテクチャ](was-activation-architecture.md)
+# [セキュリティ プロトコル](security-protocols.md)
+# [方法 : MetadataResolver を使用してバインディング メタデータを動的に取得する](how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md)
+# [方法 : フェデレーション クライアントを作成する](how-to-create-a-federated-client.md)
+# [ServiceModel トランザクションの構成](servicemodel-transaction-configuration.md)
+# [監査](auditing-security-events.md)
+# [方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](how-to-create-a-workflow-service-with-messaging-activities.md)
+# [データ メンバーの既定値](data-member-default-values.md)
+# [分散アプリケーションのセキュリティ](distributed-application-security.md)
+# [トランザクションに含まれるメッセージのバッチ処理](batching-messages-in-a-transaction.md)
+# [ワークフロー サービスの未処理の例外動作を構成する方法](config-workflow-unhandled-exception-workflowservicehost.md)
+# [方法 : コードを使用してサービスのメタデータを公開する](how-to-publish-metadata-for-a-service-using-code.md)
+# [セキュリティ動作](security-behaviors-in-wcf.md)
+# [セッション、インスタンス化、および同時実行](sessions-instancing-and-concurrency.md)
+# [方法 : 双方向コントラクトを作成する](how-to-create-a-duplex-contract.md)
+# [プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法](how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md)
+# [バインディングとセキュリティ](bindings-and-security.md)
+# [配信の拡張](syndication-extensibility.md)
+# [長時間のワークフロー サービスの作成](creating-a-long-running-workflow-service.md)
+# [フェデレーションと発行済みトークン](federation-and-issued-tokens.md)
+# [フェデレーションと信頼](federation-and-trust.md)
+# [ServiceModel 属性および ServiceDescription 参照](servicemodel-attributes-and-servicedescription-reference.md)
+# [トランザクション アプリケーションの診断](diagnosing-transactional-applications.md)
+# [データ コントラクトのバージョン管理](data-contract-versioning.md)
+# [Windows Communication Foundation の採用](adopting-wcf.md)
+# [方法 : 時刻のずれの最大値を設定する](how-to-set-a-max-clock-skew.md)
+# [方法 : WCF サービスおよび ASP.NET Web サービス クライアントを相互運用するために構成する](config-wcf-service-with-aspnet-web-service.md)
+# [セキュリティ保護されたメッセージ交換とセッション](secure-conversations-and-secure-sessions.md)
+# [トランザクション モデル](transaction-models.md)
+# [部分信頼](partial-trust.md)
+# [WCF Discovery](wcf-discovery.md)
+# [POX アプリケーションとの相互運用性](interoperability-with-pox-applications.md)
+# [キューに置かれた通信のベスト プラクティス](best-practices-for-queued-communication.md)
+# [システムが提供するバインディングの構成](configuring-system-provided-bindings.md)
+# [方法 : 双方向フェデレーション バインディングを作成する](how-to-create-a-duplex-federated-binding.md)
+# [方法 : 基本的な RSS フィードを作成する](how-to-create-a-basic-rss-feed.md)
+# [WCF のキュー](queues-in-wcf.md)
+# [サービスのバージョンを管理する方法](how-to-service-versioning.md)
+# [トランスポート セキュリティでの偽装の使用](using-impersonation-with-transport-security.md)
+# [探索アナウンスとアナウンス クライアント](discovery-announcements-and-announcement-client.md)
+# [セキュリティの考慮事項](security-considerations-in-wcf.md)
+# [上位互換性のあるデータ コントラクト](forward-compatible-data-contracts.md)
+# [情報の漏えい](information-disclosure.md)
+# [複数の IIS サイト バインディングのサポート](supporting-multiple-iis-site-bindings.md)
+# [CustomPeerResolverService 内部 : クライアント登録](inside-the-custompeerresolverservice-client-registrations.md)
+# [フィルター処理](filtering.md)
+# [標準エンドポイント](standard-endpoints.md)
+# [方法 : コード内にサービス エンドポイントを作成する](how-to-create-a-service-endpoint-in-code.md)
+# [トランスポート クォータ](transport-quotas.md)
+# [コンテキスト交換プロトコル](context-exchange-protocol.md)
+# [方法 : WCF クライアントと WSE3.0 サービスを相互運用するために構成する](how-to-configure-a-wcf-client-to-interoperate-with-wse3-0-services.md)
+# [トランスポート セキュリティと証明書認証](transport-security-with-certificate-authentication.md)
+# [シリアル化と逆シリアル化](serialization-and-deserialization.md)
+# [データ コントラクト シリアライザー](data-contract-serializer.md)
+# [認証の拡張保護の概要](extended-protection-for-authentication-overview.md)
+# [改変](tampering.md)
+# [WCF で使用されるセキュリティの概要](security-concepts-used-in-wcf.md)
+# [メタデータの公開](publishing-metadata.md)
+# [双方向サービス](duplex-services.md)
+# [AJAX の統合と JSON のサポート](ajax-integration-and-json-support.md)
+# [WCF Web HTTP プログラミング モデルの概要](wcf-web-http-programming-model-overview.md)
+# [ピア チャネルの概要](peer-channel-concepts.md)
+# [カスタム バインディングを探索クライアント チャネルと共に使用する](using-a-custom-binding-with-the-discovery-client-channel.md)
+# [セキュリティのベスト プラクティス](best-practices-for-security-in-wcf.md)
+# [ユーザー名クライアントを使用したメッセージ セキュリティ](message-security-with-a-user-name-client.md)
+# [データ転送のアーキテクチャの概要](data-transfer-architectural-overview.md)
+# [順番を無視したメッセージの処理](out-of-order-message-processing.md)
+# [方法 : WCF アクティブ化コンポーネントをインストールして設定する](how-to-install-and-configure-wcf-activation-components.md)
+# [サポートされている配置シナリオ](supported-deployment-scenarios.md)
+# [方法 : ASP.NET メンバーシップ プロバイダーを使用する](how-to-use-the-aspnet-membership-provider.md)
+# [System.Web.Routing 統合](system-web-routing-integration.md)
+# [データ コントラクト名](data-contract-names.md)
+# [スタンドアロン JSON のシリアル化](stand-alone-json-serialization.md)
+# [クレームの作成とリソース値](claim-creation-and-resource-values.md)
+# [Windows Communication Foundation 導入の準備 : 将来的な統合の容易化](anticipating-adopting-the-wcf-easing-future-integration.md)
+# [要求/応答サービス](request-reply-services.md)
+# [フェデレーション](federation.md)
+# [データ コントラクト リゾルバーの使用](using-a-data-contract-resolver.md)
+# [方法 : COM+ 統合アプリケーションを展開する](how-to-deploy-a-com-integration-application.md)
+# [方法 : ASP.NET Web サービス クライアント コードを Windows Communication Foundation に移行する](migrate-asp-net-web-service-client-to-wcf.md)
+# [ワークフロー サービスのホスティング](hosting-workflow-services.md)
+# [方法 : X.509 証明書を使用してサービスをセキュリティで保護する](how-to-secure-a-service-with-an-x-509-certificate.md)
+# [ピア チャネルのセキュリティ](peer-channel-security.md)
+# [方法 : MMC スナップインを使用して証明書を参照する](how-to-view-certificates-with-the-mmc-snap-in.md)
+# [トランザクション プロトコル](transaction-protocols.md)
+# [サービス メタデータからの WCF クライアントの生成](generating-a-wcf-client-from-service-metadata.md)
+# [方法: WCF URL 予約を制限付きの予約に置き換える](how-to-replace-the-wcf-url-reservation-with-a-restricted-reservation.md)
+# [.NET リモート処理アプリケーションの WCF への移行](migrating-net-remoting-applications-to-wcf.md)
+# [方法 : 署名確認を設定する](how-to-set-up-a-signature-confirmation.md)
+# [WCF Web HTTP プログラミング モデル](wcf-web-http-programming-model.md)
+# [JSON と XML 間のマッピング](mapping-between-json-and-xml.md)
+# [メッセージ エンコーダーを選択する](choosing-a-message-encoder.md)
+# [方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](startup-time-of-wcf-client-applications-using-the-xmlserializer.md)
+# [方法 : SecurityBindingElement を使用してカスタム バインドを作成する](how-to-create-a-custom-binding-using-the-securitybindingelement.md)
+# [一般的なセキュリティ シナリオ](common-security-scenarios.md)
+# [方法 : WSE 3.0 サービスにアクセスする](how-to-access-a-wse-3-0-service-with-a-wcf-client.md)
+# [システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](web-services-protocols-supported-by-system-provided-interoperability-bindings.md)
+# [信頼できるサブシステム](trusted-subsystem.md)
+# [トランザクション](transactions-in-wcf.md)
+# [WCF と WebSocket](wcf-and-websockets.md)
+# [コンテキスト交換](context-exchange-correlation.md)
+# [メッセージ コントラクトの使用](using-message-contracts.md)
+# [ServiceModel トランザクションの属性](servicemodel-transaction-attributes.md)
+# [WCF で使用するための WAS を設定する](configuring-the-wpa--service-for-use-with-wcf.md)
+# [メタデータ アーキテクチャの概要](metadata-architecture-overview.md)
+# [サービス データのパーティションを分割する方法](how-to-service-data-partitioning.md)
+# [WCF サービスが Web ファームでホストされている場合のリプレイ攻撃の回避](preventing-replay-attacks-when-a-wcf-service-is-hosted-in-a-web-farm.md)
+# [方法 : トランザクション サービスを作成する](how-to-create-a-transactional-service.md)
+# [WorkflowServiceHost を使用してアイドル動作を構成する方法](how-to-configure-idle-behavior-with-workflowservicehost.md)
+# [ワークフロー コントロール エンドポイント](workflow-control-endpoint.md)
+# [ASP.NET Web サービスを WCF に移行する](migrating-aspnet-web-services-to-wcf.md)
+# [方法 : コントラクト クラスを使用してサービスを作成する](how-to-create-a-wcf-contract-with-a-class.md)
+# [既知のデータ コントラクト型](data-contract-known-types.md)
+# [ワークフロー サービスのホストの概要](hosting-workflow-services-overview.md)
+# [一方向サービス](one-way-services.md)
+# [メタデータを取得する](retrieving-metadata.md)
+# [Windows 認証エラーのデバッグ](debugging-windows-authentication-errors.md)
+# [方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする](how-to-use-svcutil-exe-to-download-metadata-documents.md)
+# [方法 : ローカル発行者を設定する](how-to-configure-a-local-issuer.md)
+# [方法 : フェデレーション サービスで資格情報を設定する](how-to-configure-credentials-on-a-federation-service.md)
+# [探索クライアント チャネルの使用](using-the-discovery-client-channel.md)
+# [権限の昇格](elevation-of-privilege.md)
+# [リソースへのアクセスのクレームと拒否](claims-and-denying-access-to-resources.md)
+# [信頼できるセッション](reliable-sessions.md)
+# [方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する](how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md)
+# [アドレス](endpoint-addresses.md)
+# [SecurityBindingElement 認証モード](securitybindingelement-authentication-modes.md)
+# [委任と偽装](delegation-and-impersonation-with-wcf.md)
+# [Windows Communication Foundation での Internet Information Services 7.0 の構成](configuring-iis-for-wcf.md)
+# [方法 : サービス操作を非同期に呼び出す](how-to-call-wcf-service-operations-asynchronously.md)
+# [方法 : WCF サービスと WSE 3.0 クライアントを相互運用するために構成する](how-to-configure-wcf-services-to-interoperate-with-wse-3-0-clients.md)
+# [データ転送とシリアル化](data-transfer-and-serialization.md)
+# [リライアブル メッセージング プロトコル バージョン 1.1](reliable-messaging-protocol-version-1-1.md)
+# [スキーマのインポートとエクスポート](schema-import-and-export.md)
+# [相互運用性と統合](interoperability-and-integration.md)
+# [セキュリティで保護されたセッションに関するセキュリティの検討](security-considerations-for-secure-sessions.md)
+# [部分信頼のベスト プラクティス](partial-trust-best-practices.md)
+# [ワークフロー サービス内部の ID 情報へのアクセス](accessing-identity-information-inside-a-workflow-service.md)
+# [ID モデルを使用したクレームと承認の管理](managing-claims-and-authorization-with-the-identity-model.md)
+# [電子署名の暗号化](encryption-of-digital-signatures.md)
+# [インターネット インフォメーション サービス ホスティングのベスト プラクティス](internet-information-services-hosting-best-practices.md)
+# [ホスト](hosting.md)
+# [方法 : MetadataExchangeClient を使用してメタデータを取得する](how-to-use-metadataexchangeclient-to-retrieve-metadata.md)
+# [ピア ノード](peer-nodes.md)
+# [データ メンバーの順序](data-member-order.md)
+# [オンライン ステータスとオフライン ステータスの追加](adding-online-and-offline-status.md)
+# [エンタープライズ サービスのトランザクション コンポーネントの統合](integrating-enterprise-services-transactional-components.md)
+# [メタデータを使用する](using-metadata.md)
+# [トランスポート セキュリティと匿名クライアント](transport-security-with-an-anonymous-client.md)
+# [インターネット インフォメーション サービスでホストされる WCF サービスの配置](deploying-an-internet-information-services-hosted-wcf-service.md)
+# [ASP.NET AJAX 用の WCF サービスの作成](creating-wcf-services-for-aspnet-ajax.md)
+# [WS-AtomicTransaction の使用](using-ws-atomictransaction.md)
+# [ワークフロー サービスへのトランザクションのフロー](flowing-transactions-into-and-out-of-workflow-services.md)
+# [Send アクティビティのキャッシュ共有レベルの変更](changing-the-cache-sharing-levels-for-send-activities.md)
+# [WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法](how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md)
+# [トランザクション プロトコル バージョン 1.0](transaction-protocols-version-1-0.md)
+# [COM アプリケーションとの統合の概要](integrating-with-com-applications-overview.md)
+# [セキュリティ ネゴシエーションとタイムアウト](security-negotiation-and-timeouts.md)
+# [WCF Web HTTP エラー処理](wcf-web-http-error-handling.md)
+# [方法 : WCF Web HTTP プログラミング モデルを使用して任意のデータを返すサービスを作成する](service-returns-arbitrary-data-using-the-wcf-web.md)
+# [WCF クライアント アーキテクチャ](client-architecture.md)
+# [バイトストリーム エンコーダーを使用したバイナリ オブジェクトのエンコーディング](encoding-binary-objects-with-bytestream-encoder.md)
+# [Windows クライアントとのメッセージ セキュリティ](message-security-with-a-windows-client.md)
+# [方法 : チャネル ファクトリを作成および使用して、チャネルを作成および管理する](how-to-create-a-channel-factory-and-use-it-to-create-and-manage-channels.md)
+# [トランスポート セキュリティの概要](transport-security-overview.md)
+# [トランスポート](transports.md)
diff --git a/docs/framework/wcf/feature-details/access-control-mechanisms.md b/docs/framework/wcf/feature-details/access-control-mechanisms.md
new file mode 100644
index 00000000000..e946818fa7e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/access-control-mechanisms.md
@@ -0,0 +1,73 @@
+---
+title: "アクセス制御機構 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アクセス制御 [WCF]"
+  - "WCF セキュリティ"
+ms.assetid: 9d576122-3f55-4425-9acf-b23d0781e966
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# アクセス制御機構
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、複数の方法でアクセスを制御できます。ここでは、正しい機構を選択して使用できるように、さまざまな機構について簡単に説明し、各機構を使用するタイミングに関するヒントを提供します。ここでは、アクセス テクノロジを単純なものから順に示します。最も単純なのは <xref:System.Security.Permissions.PrincipalPermissionAttribute> で、最も複雑なのは ID モデルです。  
+  
+ これらの機構とは別に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での委任と偽装については、「[委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+## PrincipalPermissionAttribute  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute> は、サービス メソッドへのアクセスを制限するために使用します。この属性をメソッドに適用して使用すると、特定の呼び出し元の ID や Windows グループまたは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロールでのメンバーシップを要求できます。クライアントが、X.509 証明書を使用して認証された場合は、サブジェクト名と証明書の拇印で構成されるプライマリ ID がクライアントに割り当てられています。  
+  
+ サービスのユーザーが常に、サービスが実行されているものと同じ Windows ドメインのメンバーである場合、サービスが実行されているコンピューター上のリソースへのアクセスを制御するには、<xref:System.Security.Permissions.PrincipalPermissionAttribute> を使用します。指定したアクセス レベル \(なし、読み取り専用、または読み取りと書き込みなど\) を持つ Windows グループを簡単に作成できます。  
+  
+ 属性の使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)」を参照してください。ID [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## ASP.NET メンバーシップ プロバイダー  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の機能の 1 つに、メンバーシップ プロバイダーがあります。メンバーシップ プロバイダーは、厳密にはアクセス制御機構ではありませんが、これを使用すると、サービスのエンドポイントにアクセスできる ID のセットを制限することで、サービスへのアクセスを制御できます。メンバーシップ機能には、ユーザー名\/パスワードの組み合わせを設定できるデータベースが含まれています。この組み合わせによって、Web サイトのユーザーはサイトのアカウントを確立できます。ユーザーがメンバーシップ プロバイダーを使用するサービスにアクセスするには、自分の名前とパスワードを使用してログオンする必要があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが認証のために使用できるように、最初にこの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 機能を使用してデータベースを設定しておく必要があります。  
+  
+ また、このメンバーシップ機能を使用すると、既存の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サイトにメンバーシップ データベースが既にある場合に、同じユーザー名とパスワードで承認された同じユーザーがサービスを使用できるようになります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでのメンバーシップ プロバイダーの使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : ASP.NET メンバーシップ プロバイダーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md)」を参照してください。  
+  
+## ASP.NET ロール プロバイダー  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] には、ロールを使用して承認を管理する機能もあります。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーを使用すると、開発者は、ユーザーのロールを作成し、各ユーザーを 1 つまたは複数のロールに割り当てることができます。メンバーシップ プロバイダーと同様に、ロールと割り当てはデータベースに格納され、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーの特定の実装によって提供されるツールを使用して設定できます。また、メンバーシップ機能と同様に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 開発者は、データベースの情報を使用してサービス ユーザーをロール別に承認できます。たとえば、上記の `PrincipalPermissionAttribute` アクセス制御機構と組み合わせてロール プロバイダーを使用できます。  
+  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダー データベースが既に存在し、同じルールとユーザー割り当てのセットを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで利用する場合にも使用できます。  
+  
+ ロール プロバイダー機能の使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)」を参照してください。  
+  
+## 承認マネージャー  
+ さらに、承認マネージャー \(AzMan\) と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーを組み合わせてクライアントを承認する機能もあります。Web サービスを [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] によってホストする場合は、サービスの承認が AzMan 経由で行われるように AzMan をアプリケーションに統合できます。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール マネージャーは、アプリケーション ロールの管理、ロールへのユーザーの追加と削除、およびロール メンバーシップのチェックを実行できるようにする API を提供しますが、指定されたタスクまたは操作の実行がユーザーに許可されているかどうかを照会する機能は提供しません。AzMan を使用すると、個々の操作を定義してタスクに結合できます。AZMan では、ロールのチェックだけでなく、ユーザーがタスクを実行できるかどうかをチェックすることもできます。ロールの割り当てとタスクの承認は、アプリケーションの外部で構成することも、アプリケーション内でプログラムによって実行することもできます。AzMan 管理 Microsoft 管理コンソール \(MMC: Microsoft Management Console\) スナップインにより、管理者は、ロールが実行時に実行できるタスクを変更したり、ユーザーのロール メンバーシップを管理したりできます。  
+  
+ また、AzMan と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーは、既存の AzMan インストールに既にアクセスでき、AzMan とロール プロバイダーの組み合わせの機能を使用してサービス ユーザーを承認する場合にも使用できます。  
+  
+ AzMan と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[How To: ASP.NET 2.0 で Authorization Manager \(AzMan\) を使用する方法](http://go.microsoft.com/fwlink/?LinkId=88951)」を参照してください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでの AzMan とロール プロバイダーの使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md)」を参照してください。  
+  
+## ID モデル  
+ ID モデルは、クライアントを承認するためのクレームとポリシーを管理できるようにする API のセットです。ID モデルを使用すると、呼び出し元がサービスに対するそれ自体の認証に使用した資格情報に含まれるすべてのクレームを調べ、それらをサービスのポリシー セットと比較し、この比較に基づいてアクセスを許可または拒否できます。  
+  
+ アクセスを許可する前に、微調整と、特定の条件を設定する機能が必要な場合は、ID モデルを使用します。たとえば、<xref:System.Security.Permissions.PrincipalPermissionAttribute> を使用した場合、条件は、ユーザー ID が認証され、それが特定のロールに属するということだけになります。これに対し、ID モデルを使用すると、ドキュメントの参照を許可されるにはユーザーが 18 才以上であり、有効な運転免許証を所有している必要があることを明確に示すポリシーを作成できます。  
+  
+ ID モデルのクレームに基づくアクセス制御の恩恵を受けることができる例として、発行済みトークンのシナリオでフェデレーション資格情報を使用する場合が挙げられます。フェデレーションと発行済みトークン[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+ ID モデル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>   
+ [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)   
+ [方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)   
+ [方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md)   
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)   
+ [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/accessing-identity-information-inside-a-workflow-service.md b/docs/framework/wcf/feature-details/accessing-identity-information-inside-a-workflow-service.md
new file mode 100644
index 00000000000..7edae9144db
--- /dev/null
+++ b/docs/framework/wcf/feature-details/accessing-identity-information-inside-a-workflow-service.md
@@ -0,0 +1,605 @@
+---
+title: "ワークフロー サービス内部の ID 情報へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b832127-b35b-468e-a45f-321381170cbc
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ワークフロー サービス内部の ID 情報へのアクセス
+ワークフロー サービス内の ID 情報にアクセスするには、カスタム実行プロパティに <xref:System.ServiceModel.Activities.IReceiveMessageCallback> インターフェイスを実装する必要があります。<xref:System.ServiceModel.Activities.IReceiveMessageCallback.OnReceiveMessage%2A> System.Activities.ExecutionProperties)?qualifyHint=False&autoUpgrade=True メソッドで、<xref:System.ServiceModel.OperationContext.ServiceSecurityContext> にアクセスして ID 情報にアクセスできます。このトピックでは、この実行プロパティを実装する方法に加え、実行時にこのプロパティを <xref:System.ServiceModel.Activities.Receive> アクティビティに提示するカスタム アクティビティの実装方法を順に説明します。このカスタム アクティビティが行う動作は、<xref:System.ServiceModel.Activities.Sequence> アクティビティと同じですが、<xref:System.ServiceModel.Activities.Receive> がその内部に配置される場合は、<xref:System.ServiceModel.Activities.IReceiveMessageCallback> が呼び出されて ID 情報を取得します。  
+  
+### IReceiveMessageCallback の実装  
+  
+1.  空の [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ソリューションを作成します。  
+  
+2.  `Service` という新しいコンソール アプリケーションをソリューションに追加します。  
+  
+3.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.Runtime.Serialization  
+  
+    2.  System.ServiceModel  
+  
+    3.  System.ServiceModel.Activities  
+  
+4.  次の例に示すように、`AccessIdentityCallback` という新しいクラスを追加し、<xref:System.ServiceModel.Activities.IReceiveMessageCallback> を実装します。  
+  
+    ```csharp  
+    class AccessIdentityCallback : IReceiveMessageCallback  
+    {  
+       public void OnReceiveMessage(System.ServiceModel.OperationContext operationContext, System.Activities.ExecutionProperties activityExecutionProperties)  
+       {  
+          try  
+          {  
+             Console.WriteLine("Received a message from a workflow with the following identity");  
+             Console.WriteLine("Windows Identity Name: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.Name);  
+             Console.WriteLine("Windows Identity User: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.User);  
+             Console.WriteLine("Windows Identity IsAuthenticated: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.IsAuthenticated);  
+          }            
+          catch (Exception ex)  
+          {  
+             Console.WriteLine("An exception occurred: " + ex.Message);  
+          }  
+        }  
+    }  
+  
+    ```  
+  
+     このコードでは、メソッドに渡される <xref:System.ServiceModel.OperationContext> を使用して ID 情報にアクセスします。  
+  
+### IReceiveMessageCallback 実装を NativeActivityContext に追加するためのネイティブ アクティビティの実装  
+  
+1.  <xref:System.Activities.NativeActivity> から派生した `AccessIdentityScope` という新しいクラスを追加します。  
+  
+2.  子アクティビティ、変数、現在のアクティビティ インデックス、および <xref:System.Activities.CompletionCallback> コールバックを追跡するためのローカル変数を追加します。  
+  
+    ```  
+    public sealed class AccessIdentityScope : NativeActivity  
+    {  
+        Collection<Activity> children;  
+        Collection<Variable> variables;  
+        Variable<int> currentIndex;  
+        CompletionCallback onChildComplete;  
+    }  
+  
+    ```  
+  
+3.  コンストラクターを実装します。  
+  
+    ```  
+    public AccessIdentityScope() : base()  
+    {  
+        this.children = new Collection<Activity>();  
+        this.variables = new Collection<Variable>();  
+        this.currentIndex = new Variable<int>();  
+    }  
+  
+    ```  
+  
+4.  `Activities` プロパティと `Variables` プロパティを実装します。  
+  
+    ```  
+    public Collection<Activity> Activities  
+    {  
+         get { return this.children; }  
+    }  
+  
+    public Collection<Variable> Variables  
+    {  
+        get { return this.variables; }  
+    }  
+  
+    ```  
+  
+5.  <xref:System.Activities.NativeActivity.CacheMetadata%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void CacheMetadata(NativeActivityMetadata metadata)  
+    {  
+        //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+        base.CacheMetadata(metadata);  
+        //add the private implementation variable: currentIndex   
+        metadata.AddImplementationVariable(this.currentIndex);  
+    }  
+  
+    ```  
+  
+6.  <xref:System.Activities.NativeActivity.Execute%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void Execute(NativeActivityContext context)  
+    {  
+       // Add the IReceiveMessageCallback implementation as an Execution property   
+       context.Properties.Add("AccessIdentityCallback", new AccessIdentityCallback());  
+       InternalExecute(context, null);  
+    }  
+  
+    void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+    {  
+       //grab the index of the current Activity  
+       int currentActivityIndex = this.currentIndex.Get(context);  
+       if (currentActivityIndex == Activities.Count)  
+       {  
+          //if the currentActivityIndex is equal to the count of MySequence's Activities  
+          //MySequence is complete  
+          return;  
+       }  
+  
+       if (this.onChildComplete == null)  
+       {  
+          //on completion of the current child, have the runtime call back on this method  
+          this.onChildComplete = new CompletionCallback(InternalExecute);  
+       }  
+  
+       //grab the next Activity in MySequence.Activities and schedule it  
+       Activity nextChild = Activities[currentActivityIndex];  
+       context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+       //increment the currentIndex  
+       this.currentIndex.Set(context, ++currentActivityIndex);  
+    }  
+  
+    ```  
+  
+### ワークフロー サービスの実装  
+  
+1.  既存の `Program` クラスを開きます。  
+  
+2.  次の定数を定義します。  
+  
+    ```  
+    class Program  
+    {  
+       const string addr = "http://localhost:8080/Service";  
+       static XName contract = XName.Get("IService", "http://tempuri.org");  
+    }  
+  
+    ```  
+  
+3.  ワークフロー サービスを作成する `GetWorkflowService` という静的メソッドを追加します。  
+  
+    ```  
+    static Activity GetServiceWorkflow()  
+    {  
+       Variable<string> echoString = new Variable<string>();  
+  
+       // Create the Receive activity  
+       Receive echoRequest = new Receive  
+       {  
+          CanCreateInstance = true,  
+          ServiceContractName = contract,  
+          OperationName = "Echo",  
+          Content = new ReceiveParametersContent()  
+          {  
+             Parameters = { { "echoString", new OutArgument<string>(echoString) } }  
+          }  
+       };  
+  
+       return new AccessIdentityScope  
+       {  
+          Variables = { echoString },  
+          Activities =  
+          {  
+             echoRequest,  
+             new WriteLine { Text = new InArgument<string>( (e) => "Received: " + echoString.Get(e) ) },  
+             new SendReply  
+             {  
+                Request = echoRequest,  
+                Content = new SendParametersContent()  
+                {  
+                   Parameters = { { "result", new InArgument<string>(echoString) } }   
+                }  
+             }  
+          }  
+       };  
+     }  
+  
+    ```  
+  
+4.  既存の `Main` メソッドで、ワークフロー サービスをホストします。  
+  
+    ```  
+    static void Main(string[] args)  
+    {  
+       string addr = "http://localhost:8080/Service";  
+  
+       using (WorkflowServiceHost host = new WorkflowServiceHost(GetServiceWorkflow()))  
+       {  
+          WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);  
+          host.AddServiceEndpoint(contract, binding, addr);  
+  
+          host.Open();  
+          Console.WriteLine("Service waiting at: " + addr);  
+          Console.WriteLine("Press [ENTER] to exit");  
+          Console.ReadLine();  
+          host.Close();  
+       }  
+    }  
+  
+    ```  
+  
+### ワークフロー クライアントの実装  
+  
+1.  `Client` という新しいコンソール アプリケーション プロジェクトを作成します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.Activities  
+  
+    2.  System.ServiceModel  
+  
+    3.  System.ServiceModel.Activities  
+  
+3.  生成された Program.cs ファイルを開き、`GetClientWorkflow` という静的メソッドを追加してクライアント ワークフローを作成します。  
+  
+    ```  
+    static Activity GetClientWorkflow()  
+    {  
+       Variable<string> echoString = new Variable<string>();  
+  
+       Endpoint clientEndpoint = new Endpoint  
+       {  
+          Binding = new WSHttpBinding(SecurityMode.Message),  
+          AddressUri = new Uri("http://localhost:8080/Service")  
+       };  
+  
+       Send echoRequest = new Send  
+       {  
+          Endpoint = clientEndpoint,  
+          ServiceContractName = XName.Get("IService", "http://tempuri.org"),  
+          OperationName = "Echo",  
+          Content = new SendParametersContent()  
+          {  
+             Parameters = { { "echoString", new InArgument<string>("Hello, World") } }   
+          }  
+       };  
+  
+       return new Sequence  
+       {  
+          Variables = { echoString },  
+          Activities =  
+          {                      
+             new CorrelationScope  
+             {  
+                Body = new Sequence  
+                {  
+                   Activities =   
+                   {  
+                      echoRequest,  
+                      new ReceiveReply  
+                      {  
+                         Request = echoRequest,  
+                         Content = new ReceiveParametersContent  
+                         {  
+                            Parameters = { { "result", new OutArgument<string>(echoString) } }  
+                         }  
+                      }  
+                   }  
+                }  
+             },                      
+             new WriteLine { Text = new InArgument<string>( (e) => "Received Text: " + echoString.Get(e) ) },                      
+             }  
+          };  
+       }  
+    }  
+  
+    ```  
+  
+4.  次のホスティング コードを `Main()` メソッドに追加します。  
+  
+    ```  
+    static void Main(string[] args)  
+    {  
+       Activity workflow = GetClientWorkflow();  
+       WorkflowInvoker.Invoke(workflow);  
+       WorkflowInvoker.Invoke(workflow);  
+       Console.WriteLine("Press [ENTER] to exit");  
+       Console.ReadLine();  
+    }  
+  
+    ```  
+  
+## 使用例  
+ このトピックで使用されているソース コードの完全な一覧を次に示します。  
+  
+```  
+  
+// AccessIdentityCallback.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{  
+    class AccessIdentityCallback : IReceiveMessageCallback  
+    {  
+        public const string HeaderName = "InstanceIdHeader";  
+        public const string HeaderNS = "http://Microsoft.Samples.AccessingOperationContext";  
+  
+        public void OnReceiveMessage(System.ServiceModel.OperationContext operationContext, System.Activities.ExecutionProperties activityExecutionProperties)  
+        {  
+            try  
+            {  
+                // Guid instanceId = operationContext.IncomingMessageHeaders.GetHeader<Guid>(HeaderName, HeaderNS);  
+                Console.WriteLine("Received a message from a workflow with the following identity" ); // with instanceId = {0}", instanceId);  
+                Console.WriteLine("Windows Identity Name: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.Name);  
+                Console.WriteLine("Windows Identity User: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.User);  
+                Console.WriteLine("Windows Identity IsAuthenticated: {0}", operationContext.ServiceSecurityContext.WindowsIdentity.IsAuthenticated);  
+            }  
+            catch (MessageHeaderException)  
+            {  
+                Console.WriteLine("This message must not be from a workflow.");  
+            }  
+            catch (Exception ex)  
+            {  
+                Console.WriteLine("An exception occurred: " + ex.Message);  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+  
+// AccessIdentityScope.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System.Activities;  
+using System.Collections.ObjectModel;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{  
+    public sealed class AccessIdentityScope : NativeActivity  
+    {  
+        Collection<Activity> children;  
+        Collection<Variable> variables;  
+        Variable<int> currentIndex;  
+        CompletionCallback onChildComplete;  
+  
+        public AccessIdentityScope()  
+            : base()  
+        {  
+            this.children = new Collection<Activity>();  
+            this.variables = new Collection<Variable>();  
+            this.currentIndex = new Variable<int>();  
+        }  
+  
+        public Collection<Activity> Activities  
+        {  
+            get  
+            {  
+                return this.children;  
+            }  
+        }  
+  
+        public Collection<Variable> Variables  
+        {  
+            get  
+            {  
+                return this.variables;  
+            }  
+        }  
+  
+        protected override void CacheMetadata(NativeActivityMetadata metadata)  
+        {  
+            //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+            base.CacheMetadata(metadata);  
+            //add the private implementation variable: currentIndex   
+            metadata.AddImplementationVariable(this.currentIndex);  
+        }                     
+  
+        protected override void Execute(  
+            NativeActivityContext context)  
+        {  
+            context.Properties.Add("AccessIdentityCallback", new AccessIdentityCallback());  
+            InternalExecute(context, null);  
+        }  
+  
+        void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+        {  
+            //grab the index of the current Activity  
+            int currentActivityIndex = this.currentIndex.Get(context);  
+            if (currentActivityIndex == Activities.Count)  
+            {  
+                //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                //MySequence is complete  
+                return;  
+            }  
+  
+            if (this.onChildComplete == null)  
+            {  
+                //on completion of the current child, have the runtime call back on this method  
+                this.onChildComplete = new CompletionCallback(InternalExecute);  
+            }  
+  
+            //grab the next Activity in MySequence.Activities and schedule it  
+            Activity nextChild = Activities[currentActivityIndex];  
+            context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+            //increment the currentIndex  
+            this.currentIndex.Set(context, ++currentActivityIndex);  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+  
+// Service.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Activities;  
+using System.Activities.Statements;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+using System.Xml.Linq;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{      
+    class Program  
+    {  
+        const string addr = "http://localhost:8080/Service";  
+        static XName contract = XName.Get("IService", "http://tempuri.org");  
+  
+        static void Main(string[] args)  
+        {  
+            string addr = "http://localhost:8080/Service";  
+  
+            using (WorkflowServiceHost host = new WorkflowServiceHost(GetServiceWorkflow()))  
+            {  
+                WSHttpBinding binding = new WSHttpBinding(SecurityMode.Message);  
+                host.AddServiceEndpoint(contract, binding, addr);  
+  
+                host.Open();  
+                Console.WriteLine("Service waiting at: " + addr);  
+                Console.WriteLine("Press [ENTER] to exit");  
+                Console.ReadLine();  
+                host.Close();  
+            }  
+  
+        }  
+  
+        static Activity GetServiceWorkflow()  
+        {  
+            Variable<string> echoString = new Variable<string>();  
+  
+            Receive echoRequest = new Receive  
+            {  
+                CanCreateInstance = true,  
+                ServiceContractName = contract,  
+                OperationName = "Echo",  
+                Content = new ReceiveParametersContent()  
+                {  
+                    Parameters = { { "echoString", new OutArgument<string>(echoString) } }  
+                }  
+            };  
+  
+            return new AccessIdentityScope  
+            {  
+                Variables = { echoString },  
+                Activities =  
+                {  
+                    echoRequest,  
+                    new WriteLine { Text = new InArgument<string>( (e) => "Received: " + echoString.Get(e) ) },  
+                    new SendReply  
+                    {  
+                        Request = echoRequest,  
+                        Content = new SendParametersContent()  
+                        {  
+                            Parameters = { { "result", new InArgument<string>(echoString) } }   
+                        }  
+                    }  
+                }  
+            };  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+  
+// client.cs   
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Activities;  
+using System.Activities.Statements;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+using System.Xml.Linq;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Client  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            Activity workflow = GetClientWorkflow();  
+            WorkflowInvoker.Invoke(workflow);  
+            WorkflowInvoker.Invoke(workflow);  
+            Console.WriteLine("Press [ENTER] to exit");  
+            Console.ReadLine();  
+        }  
+  
+        static Activity GetClientWorkflow()  
+        {  
+            Variable<string> echoString = new Variable<string>();  
+  
+            Endpoint clientEndpoint = new Endpoint  
+            {  
+                Binding = new WSHttpBinding(SecurityMode.Message),  
+                AddressUri = new Uri("http://localhost:8080/Service")  
+            };  
+  
+            Send echoRequest = new Send  
+            {  
+                Endpoint = clientEndpoint,  
+                ServiceContractName = XName.Get("IService", "http://tempuri.org"),  
+                OperationName = "Echo",  
+                Content = new SendParametersContent()  
+                {  
+                    Parameters = { { "echoString", new InArgument<string>("Hello, World") } }   
+                }  
+            };  
+  
+            return new Sequence  
+            {  
+                Variables = { echoString },  
+                Activities =  
+                {                      
+                    new CorrelationScope  
+                    {  
+                        Body = new Sequence  
+                        {  
+                            Activities =   
+                            {  
+                                echoRequest,  
+                                new ReceiveReply  
+                                {  
+                                    Request = echoRequest,  
+                                    Content = new ReceiveParametersContent  
+                                    {  
+                                        Parameters = { { "result", new OutArgument<string>(echoString) } }  
+                                    }  
+                                }  
+                            }  
+                        }  
+                    },                      
+                    new WriteLine { Text = new InArgument<string>( (e) => "Received Text: " + echoString.Get(e) ) },                      
+                }  
+            };  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [OperationContext へのアクセス](../../../../docs/framework/windows-workflow-foundation/samples/accessing-operationcontext.md)   
+ [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/accessing-operationcontext-from-a-workflow-service.md b/docs/framework/wcf/feature-details/accessing-operationcontext-from-a-workflow-service.md
new file mode 100644
index 00000000000..f37f926a5dd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/accessing-operationcontext-from-a-workflow-service.md
@@ -0,0 +1,875 @@
+---
+title: "ワークフロー サービスから OperationContext へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b1dafe55-a20e-4db0-9ac8-90c315883cdd
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ワークフロー サービスから OperationContext へのアクセス
+ワークフロー サービス内の <xref:System.ServiceModel.OperationContext> にアクセスするには、カスタム実行プロパティに <xref:System.ServiceModel.Activities.IReceiveMessageCallback> インターフェイスを実装する必要があります。これには、<xref:System.ServiceModel.OperationContext> への参照が渡される <xref:System.ServiceModel.Activities.IReceiveMessageCallback.OnReceiveMessage%2A> System.Activities.ExecutionProperties)?qualifyHint=False&autoUpgrade=True メソッドをオーバーライドします。このトピックでは、カスタム ヘッダーを取得するためにこの実行プロパティを実装する方法に加え、実行時にこのプロパティを <xref:System.ServiceModel.Activities.Receive> に提示するカスタム アクティビティの実装方法を順に説明します。このカスタム アクティビティが行う動作は、<xref:System.ServiceModel.Activities.Sequence> アクティビティと同じですが、<xref:System.ServiceModel.Activities.Receive> がその内部に配置されるのに対し、<xref:System.ServiceModel.Activities.IReceiveMessageCallback> は呼び出されて <xref:System.ServiceModel.OperationContext> 情報を取得します。このトピックでは、クライアント側 <xref:System.ServiceModel.OperationContext> にアクセスして、<xref:System.ServiceModel.Activities.ISendMessageCallback> インターフェイス経由で送信ヘッダーを追加する方法も説明します。  
+  
+### サービス側の IReceiveMessageCallback の実装  
+  
+1.  空の [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ソリューションを作成します。  
+  
+2.  `Service` という新しいコンソール アプリケーションをソリューションに追加します。  
+  
+3.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.Runtime.Serialization  
+  
+    2.  System.ServiceModel  
+  
+    3.  System.ServiceModel.Activities  
+  
+4.  次の例に示すように、`ReceiveInstanceIdCallback` という新しいクラスを追加し、<xref:System.ServiceModel.Activities.IReceiveMessageCallback> を実装します。  
+  
+    ```csharp  
+    class ReceiveInstanceIdCallback : IReceiveMessageCallback  
+    {  
+          public const string HeaderName = "InstanceIdHeader";  
+          public const string HeaderNS = "http://Microsoft.Samples.AccessingOperationContext";  
+  
+         public void OnReceiveMessage(System.ServiceModel.OperationContext operationContext, System.Activities.ExecutionProperties activityExecutionProperties)  
+          {              
+                try  
+                {  
+                    Guid instanceId = operationContext.IncomingMessageHeaders.GetHeader<Guid>(HeaderName, HeaderNS);  
+                    Console.WriteLine("Received a message from a workflow with instanceId = {0}", instanceId);  
+                }  
+                catch (MessageHeaderException)  
+                {  
+                    Console.WriteLine("This message must not be from a workflow.");  
+                }  
+            }  
+    }  
+  
+    ```  
+  
+     このコードでは、メソッドに渡される <xref:System.ServiceModel.OperationContext> を使用して、着信メッセージのヘッダーにアクセスします。  
+  
+### IReceiveMessageCallback 実装を NativeActivityContext に追加するためのサービス側のネイティブ アクティビティの実装  
+  
+1.  <xref:System.Activities.NativeActivity> から派生した `ReceiveInstanceIdScope` という新しいクラスを追加します。  
+  
+2.  子アクティビティ、変数、現在のアクティビティ インデックス、および <xref:System.Activities.CompletionCallback> コールバックを追跡するためのローカル変数を追加します。  
+  
+    ```  
+    public sealed class ReceiveInstanceIdScope : NativeActivity  
+        {  
+            Collection<Activity> children;  
+            Collection<Variable> variables;  
+            Variable<int> currentIndex;  
+            CompletionCallback onChildComplete;  
+    }  
+  
+    ```  
+  
+3.  コンストラクターを実装します。  
+  
+    ```  
+    public ReceiveInstanceIdScope()  
+                : base()  
+            {  
+                this.children = new Collection<Activity>();  
+                this.variables = new Collection<Variable>();  
+                this.currentIndex = new Variable<int>();  
+            }  
+    }  
+  
+    ```  
+  
+4.  `Activities` プロパティと `Variables` プロパティを実装します。  
+  
+    ```  
+    public Collection<Activity> Activities  
+    {  
+         get { return this.children; }  
+    }  
+  
+    public Collection<Variable> Variables  
+    {  
+        get { return this.variables; }  
+    }  
+  
+    ```  
+  
+5.  <xref:System.Activities.NativeActivity.CacheMetadata%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void CacheMetadata(NativeActivityMetadata metadata)  
+    {  
+        //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+        base.CacheMetadata(metadata);  
+        //add the private implementation variable: currentIndex   
+        metadata.AddImplementationVariable(this.currentIndex);  
+    }  
+  
+    ```  
+  
+6.  <xref:System.Activities.NativeActivity.Execute%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void Execute(  
+                NativeActivityContext context)  
+            {  
+                context.Properties.Add("ReceiveInstanceIdCallback", new ReceiveInstanceIdCallback());  
+                InternalExecute(context, null);  
+            }  
+  
+            void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+            {  
+                //grab the index of the current Activity  
+                int currentActivityIndex = this.currentIndex.Get(context);  
+                if (currentActivityIndex == Activities.Count)  
+                {  
+                    //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                    //MySequence is complete  
+                    return;  
+                }  
+  
+                if (this.onChildComplete == null)  
+                {  
+                    //on completion of the current child, have the runtime call back on this method  
+                    this.onChildComplete = new CompletionCallback(InternalExecute);  
+                }  
+  
+                //grab the next Activity in MySequence.Activities and schedule it  
+                Activity nextChild = Activities[currentActivityIndex];  
+                context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+                //increment the currentIndex  
+                this.currentIndex.Set(context, ++currentActivityIndex);  
+            }  
+  
+    ```  
+  
+### ワークフロー サービスの実装  
+  
+1.  既存の `Program` クラスを開きます。  
+  
+2.  次の定数を定義します。  
+  
+    ```  
+    class Program  
+    {  
+       const string addr = "http://localhost:8080/Service";  
+       static XName contract = XName.Get("IService", "http://tempuri.org");  
+    }  
+  
+    ```  
+  
+3.  ワークフロー サービスを作成する `GetWorkflowService` という静的メソッドを追加します。  
+  
+    ```  
+    static Activity GetServiceWorkflow()  
+            {  
+                Variable<string> echoString = new Variable<string>();  
+  
+                Receive echoRequest = new Receive  
+                {  
+                    CanCreateInstance = true,  
+                    ServiceContractName = contract,  
+                    OperationName = "Echo",  
+                    Content = new ReceiveParametersContent()  
+                    {  
+                        Parameters = { { "echoString", new OutArgument<string>(echoString) } }  
+                    }  
+                };  
+  
+                return new ReceiveInstanceIdScope  
+                {  
+                    Variables = { echoString },  
+                    Activities =  
+                    {  
+                        echoRequest,  
+                        new WriteLine { Text = new InArgument<string>( (e) => "Received: " + echoString.Get(e) ) },  
+                        new SendReply  
+                        {  
+                            Request = echoRequest,  
+                            Content = new SendParametersContent()  
+                            {  
+                                Parameters = { { "result", new InArgument<string>(echoString) } }   
+                            }  
+                        }  
+                    }  
+                };  
+            }  
+  
+    ```  
+  
+4.  既存の `Main` メソッドで、ワークフロー サービスをホストします。  
+  
+    ```  
+    static void Main(string[] args)  
+            {  
+                string addr = "http://localhost:8080/Service";  
+  
+                using (WorkflowServiceHost host = new WorkflowServiceHost(GetServiceWorkflow()))  
+                {  
+                    host.AddServiceEndpoint(contract, new BasicHttpBinding(), addr);  
+  
+                    host.Open();  
+                    Console.WriteLine("Service waiting at: " + addr);  
+                    Console.WriteLine("Press [ENTER] to exit");  
+                    Console.ReadLine();  
+                    host.Close();  
+                }  
+            }  
+  
+    ```  
+  
+### クライアント側の ISendMessageCallback の実装  
+  
+1.  `Service` という新しいコンソール アプリケーションをソリューションに追加します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.Runtime.Serialization  
+  
+    2.  System.ServiceModel  
+  
+    3.  System.ServiceModel.Activities  
+  
+3.  次の例に示すように、`SendInstanceIdCallback` という新しいクラスを追加し、<xref:System.ServiceModel.Activities.ISendMessageCallback> を実装します。  
+  
+    ```csharp  
+    class SendInstanceIdCallback : ISendMessageCallback  
+        {  
+            public const string HeaderName = "InstanceIdHeader";  
+            public const string HeaderNS = "http://Microsoft.Samples.AccessingOperationContext";  
+  
+            public Guid InstanceId { get; set; }  
+  
+            public void OnSendMessage(System.ServiceModel.OperationContext operationContext)  
+            {  
+                operationContext.OutgoingMessageHeaders.Add(MessageHeader.CreateHeader(HeaderName, HeaderNS, this.InstanceId));  
+            }  
+        }  
+  
+    ```  
+  
+     このコードでは、メソッドに渡される <xref:System.ServiceModel.OperationContext> を使用して、着信メッセージにカスタム ヘッダーを追加します。  
+  
+### クライアント側の ISendMessageCallback 実装を NativeActivityContext に追加するためのクライアント側のネイティブ アクティビティの実装  
+  
+1.  <xref:System.Activities.NativeActivity> から派生した `SendInstanceIdScope` という新しいクラスを追加します。  
+  
+2.  子アクティビティ、変数、現在のアクティビティ インデックス、および <xref:System.Activities.CompletionCallback> コールバックを追跡するためのローカル変数を追加します。  
+  
+    ```  
+    public sealed class SendInstanceIdScope : NativeActivity  
+        {  
+            Collection<Activity> children;  
+            Collection<Variable> variables;  
+            Variable<int> currentIndex;  
+            CompletionCallback onChildComplete;  
+    }  
+  
+    ```  
+  
+3.  コンストラクターを実装します。  
+  
+    ```  
+    public SendInstanceIdScope()  
+                : base()  
+            {  
+                this.children = new Collection<Activity>();  
+                this.variables = new Collection<Variable>();  
+                this.currentIndex = new Variable<int>();  
+            }  
+  
+    ```  
+  
+4.  `Activities` プロパティと `Variables` プロパティを実装します。  
+  
+    ```  
+    public Collection<Activity> Activities  
+    {  
+         get { return this.children; }  
+    }  
+  
+    public Collection<Variable> Variables  
+    {  
+        get { return this.variables; }  
+    }  
+  
+    ```  
+  
+5.  <xref:System.Activities.NativeActivity.CacheMetadata%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void CacheMetadata(NativeActivityMetadata metadata)  
+    {  
+        //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+        base.CacheMetadata(metadata);  
+        //add the private implementation variable: currentIndex   
+        metadata.AddImplementationVariable(this.currentIndex);  
+    }  
+  
+    ```  
+  
+6.  <xref:System.Activities.NativeActivity.Execute%2A> をオーバーライドします。  
+  
+    ```  
+    protected override void Execute(  
+                NativeActivityContext context)  
+            {  
+                context.Properties.Add("SendInstanceIdCallback", new SendInstanceIdCallback() { InstanceId = context.WorkflowInstanceId });  
+                InternalExecute(context, null);  
+            }  
+  
+            void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+            {  
+                //grab the index of the current Activity  
+                int currentActivityIndex = this.currentIndex.Get(context);  
+                if (currentActivityIndex == Activities.Count)  
+                {  
+                    //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                    //MySequence is complete  
+                    return;  
+                }  
+  
+                if (this.onChildComplete == null)  
+                {  
+                    //on completion of the current child, have the runtime call back on this method  
+                    this.onChildComplete = new CompletionCallback(InternalExecute);  
+                }  
+  
+                //grab the next Activity in MySequence.Activities and schedule it  
+                Activity nextChild = Activities[currentActivityIndex];  
+                context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+                //increment the currentIndex  
+                this.currentIndex.Set(context, ++currentActivityIndex);  
+            }  
+    protected override void Execute(  
+                NativeActivityContext context)  
+            {  
+                context.Properties.Add("ReceiveInstanceIdCallback", new ReceiveInstanceIdCallback());  
+                InternalExecute(context, null);  
+            }  
+  
+            void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+            {  
+                //grab the index of the current Activity  
+                int currentActivityIndex = this.currentIndex.Get(context);  
+                if (currentActivityIndex == Activities.Count)  
+                {  
+                    //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                    //MySequence is complete  
+                    return;  
+                }  
+  
+                if (this.onChildComplete == null)  
+                {  
+                    //on completion of the current child, have the runtime call back on this method  
+                    this.onChildComplete = new CompletionCallback(InternalExecute);  
+                }  
+  
+                //grab the next Activity in MySequence.Activities and schedule it  
+                Activity nextChild = Activities[currentActivityIndex];  
+                context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+                //increment the currentIndex  
+                this.currentIndex.Set(context, ++currentActivityIndex);  
+            }  
+  
+    ```  
+  
+### ワークフロー クライアントの実装  
+  
+1.  `Client` という新しいコンソール アプリケーション プロジェクトを作成します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.Activities  
+  
+    2.  System.ServiceModel  
+  
+    3.  System.ServiceModel.Activities  
+  
+3.  生成された Program.cs ファイルを開き、`GetClientWorkflow` という静的メソッドを追加してクライアント ワークフローを作成します。  
+  
+    ```  
+    static Activity GetClientWorkflow()  
+            {  
+                Variable<string> echoString = new Variable<string>();  
+  
+                // Define the endpoint  
+                Endpoint clientEndpoint = new Endpoint  
+                {  
+                    Binding = new BasicHttpBinding(),  
+                    AddressUri = new Uri("http://localhost:8080/Service")  
+                };  
+  
+                // Configure the Send activity used to send a message  
+                Send echoRequest = new Send  
+                {  
+                    Endpoint = clientEndpoint,  
+                    ServiceContractName = XName.Get("IService", "http://tempuri.org"),  
+                    OperationName = "Echo",  
+                    Content = new SendParametersContent()  
+                    {  
+                        Parameters = { { "echoString", new InArgument<string>("Hello, World") } }   
+                    }  
+                };  
+  
+                // Place the Send activity in a SendInstanceIdScope. This hooks up the ISendMessageCallback   
+                // implementation to the client workflow.  
+                return new SendInstanceIdScope  
+                {  
+                    Variables = { echoString },  
+                    Activities =  
+                    {                      
+                        new CorrelationScope  
+                        {  
+                            Body = new Sequence  
+                            {  
+                                Activities =   
+                                {  
+                                    // Send the request message  
+                                    echoRequest,  
+  
+                                   // Receive the reply from the service  
+                                    new ReceiveReply  
+                                    {  
+                                        Request = echoRequest,  
+                                        Content = new ReceiveParametersContent  
+                                        {  
+                                            Parameters = { { "result", new OutArgument<string>(echoString) } }  
+                                        }  
+                                    }  
+                                }  
+                            }  
+                        },                      
+                        new WriteLine { Text = new InArgument<string>( (e) => "Received Text: " + echoString.Get(e) ) },                      
+                    }  
+                };  
+            }  
+  
+    ```  
+  
+4.  次のホスティング コードを `Main()` メソッドに追加します。  
+  
+    ```  
+    static void Main(string[] args)  
+    {  
+       Activity workflow = GetClientWorkflow();  
+       WorkflowInvoker.Invoke(workflow);  
+       WorkflowInvoker.Invoke(workflow);  
+       Console.WriteLine("Press [ENTER] to exit");  
+       Console.ReadLine();  
+    }  
+  
+    ```  
+  
+## 使用例  
+ このトピックで使用されているソース コードの完全な一覧を次に示します。  
+  
+```  
+// ReceiveInstanceIdScope.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System.Activities;  
+using System.Collections.ObjectModel;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{  
+    public sealed class ReceiveInstanceIdScope : NativeActivity  
+    {  
+        Collection<Activity> children;  
+        Collection<Variable> variables;  
+        Variable<int> currentIndex;  
+        CompletionCallback onChildComplete;  
+  
+        public ReceiveInstanceIdScope()  
+            : base()  
+        {  
+            this.children = new Collection<Activity>();  
+            this.variables = new Collection<Variable>();  
+            this.currentIndex = new Variable<int>();  
+        }  
+  
+        public Collection<Activity> Activities  
+        {  
+            get  
+            {  
+                return this.children;  
+            }  
+        }  
+  
+        public Collection<Variable> Variables  
+        {  
+            get  
+            {  
+                return this.variables;  
+            }  
+        }  
+  
+        protected override void CacheMetadata(NativeActivityMetadata metadata)  
+        {  
+            //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+            base.CacheMetadata(metadata);  
+            //add the private implementation variable: currentIndex   
+            metadata.AddImplementationVariable(this.currentIndex);  
+        }                     
+  
+        protected override void Execute(  
+            NativeActivityContext context)  
+        {  
+            context.Properties.Add("ReceiveInstanceIdCallback", new ReceiveInstanceIdCallback());  
+            InternalExecute(context, null);  
+        }  
+  
+        void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+        {  
+            //grab the index of the current Activity  
+            int currentActivityIndex = this.currentIndex.Get(context);  
+            if (currentActivityIndex == Activities.Count)  
+            {  
+                //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                //MySequence is complete  
+                return;  
+            }  
+  
+            if (this.onChildComplete == null)  
+            {  
+                //on completion of the current child, have the runtime call back on this method  
+                this.onChildComplete = new CompletionCallback(InternalExecute);  
+            }  
+  
+            //grab the next Activity in MySequence.Activities and schedule it  
+            Activity nextChild = Activities[currentActivityIndex];  
+            context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+            //increment the currentIndex  
+            this.currentIndex.Set(context, ++currentActivityIndex);  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// ReceiveInstanceIdScope.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{  
+    class ReceiveInstanceIdCallback : IReceiveMessageCallback  
+    {  
+        public const string HeaderName = "InstanceIdHeader";  
+        public const string HeaderNS = "http://Microsoft.Samples.AccessingOperationContext";  
+  
+        public void OnReceiveMessage(System.ServiceModel.OperationContext operationContext, System.Activities.ExecutionProperties activityExecutionProperties)  
+        {              
+            try  
+            {  
+                Guid instanceId = operationContext.IncomingMessageHeaders.GetHeader<Guid>(HeaderName, HeaderNS);  
+                Console.WriteLine("Received a message from a workflow with instanceId = {0}", instanceId);  
+            }  
+            catch (MessageHeaderException)  
+            {  
+                Console.WriteLine("This message must not be from a workflow.");  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// Service.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Activities;  
+using System.Activities.Statements;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+using System.Xml.Linq;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Service  
+{      
+    class Program  
+    {  
+        const string addr = "http://localhost:8080/Service";  
+        static XName contract = XName.Get("IService", "http://tempuri.org");  
+  
+        static void Main(string[] args)  
+        {  
+            string addr = "http://localhost:8080/Service";  
+  
+            using (WorkflowServiceHost host = new WorkflowServiceHost(GetServiceWorkflow()))  
+            {  
+                host.AddServiceEndpoint(contract, new BasicHttpBinding(), addr);  
+  
+                host.Open();  
+                Console.WriteLine("Service waiting at: " + addr);  
+                Console.WriteLine("Press [ENTER] to exit");  
+                Console.ReadLine();  
+                host.Close();  
+            }  
+  
+        }  
+  
+        static Activity GetServiceWorkflow()  
+        {  
+            Variable<string> echoString = new Variable<string>();  
+  
+            Receive echoRequest = new Receive  
+            {  
+                CanCreateInstance = true,  
+                ServiceContractName = contract,  
+                OperationName = "Echo",  
+                Content = new ReceiveParametersContent()  
+                {  
+                    Parameters = { { "echoString", new OutArgument<string>(echoString) } }  
+                }  
+            };  
+  
+            return new ReceiveInstanceIdScope  
+            {  
+                Variables = { echoString },  
+                Activities =  
+                {  
+                    echoRequest,  
+                    new WriteLine { Text = new InArgument<string>( (e) => "Received: " + echoString.Get(e) ) },  
+                    new SendReply  
+                    {  
+                        Request = echoRequest,  
+                        Content = new SendParametersContent()  
+                        {  
+                            Parameters = { { "result", new InArgument<string>(echoString) } }   
+                        }  
+                    }  
+                }  
+            };  
+        }  
+    }  
+  
+}  
+  
+```  
+  
+```  
+// SendInstanceIdCallback.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel.Activities;  
+using System.ServiceModel.Channels;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Client  
+{  
+    class SendInstanceIdCallback : ISendMessageCallback  
+    {  
+        public const string HeaderName = "InstanceIdHeader";  
+        public const string HeaderNS = "http://Microsoft.Samples.AccessingOperationContext";  
+  
+        public Guid InstanceId { get; set; }  
+  
+        public void OnSendMessage(System.ServiceModel.OperationContext operationContext)  
+        {  
+            operationContext.OutgoingMessageHeaders.Add(MessageHeader.CreateHeader(HeaderName, HeaderNS, this.InstanceId));  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// SendInstanceIdScope.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System.Activities;  
+using System.Collections.ObjectModel;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Client  
+{  
+    public sealed class SendInstanceIdScope : NativeActivity  
+    {  
+        Collection<Activity> children;  
+        Collection<Variable> variables;  
+        Variable<int> currentIndex;  
+        CompletionCallback onChildComplete;  
+  
+        public SendInstanceIdScope()  
+            : base()  
+        {  
+            this.children = new Collection<Activity>();  
+            this.variables = new Collection<Variable>();  
+            this.currentIndex = new Variable<int>();  
+        }  
+  
+        public Collection<Activity> Activities  
+        {  
+            get  
+            {  
+                return this.children;  
+            }  
+        }  
+  
+        public Collection<Variable> Variables  
+        {  
+            get  
+            {  
+                return this.variables;  
+            }  
+        }  
+  
+        protected override void CacheMetadata(NativeActivityMetadata metadata)  
+        {  
+            //call base.CacheMetadata to add the Activities and Variables to this activity's metadata  
+            base.CacheMetadata(metadata);  
+            //add the private implementation variable: currentIndex   
+            metadata.AddImplementationVariable(this.currentIndex);  
+        }  
+  
+        protected override void Execute(  
+            NativeActivityContext context)  
+        {  
+            context.Properties.Add("SendInstanceIdCallback", new SendInstanceIdCallback() { InstanceId = context.WorkflowInstanceId });  
+            InternalExecute(context, null);  
+        }  
+  
+        void InternalExecute(NativeActivityContext context, ActivityInstance instance)  
+        {  
+            //grab the index of the current Activity  
+            int currentActivityIndex = this.currentIndex.Get(context);  
+            if (currentActivityIndex == Activities.Count)  
+            {  
+                //if the currentActivityIndex is equal to the count of MySequence's Activities  
+                //MySequence is complete  
+                return;  
+            }  
+  
+            if (this.onChildComplete == null)  
+            {  
+                //on completion of the current child, have the runtime call back on this method  
+                this.onChildComplete = new CompletionCallback(InternalExecute);  
+            }  
+  
+            //grab the next Activity in MySequence.Activities and schedule it  
+            Activity nextChild = Activities[currentActivityIndex];  
+            context.ScheduleActivity(nextChild, this.onChildComplete);  
+  
+            //increment the currentIndex  
+            this.currentIndex.Set(context, ++currentActivityIndex);  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// Client.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Activities;  
+using System.Activities.Statements;  
+using System.ServiceModel;  
+using System.ServiceModel.Activities;  
+using System.Xml.Linq;  
+  
+namespace Microsoft.Samples.AccessingOperationContext.Client  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            Activity workflow = GetClientWorkflow();  
+            WorkflowInvoker.Invoke(workflow);  
+            WorkflowInvoker.Invoke(workflow);  
+            Console.WriteLine("Press [ENTER] to exit");  
+            Console.ReadLine();  
+        }  
+  
+        static Activity GetClientWorkflow()  
+        {  
+            Variable<string> echoString = new Variable<string>();  
+  
+            Endpoint clientEndpoint = new Endpoint  
+            {  
+                Binding = new BasicHttpBinding(),  
+                AddressUri = new Uri("http://localhost:8080/Service")  
+            };  
+  
+            Send echoRequest = new Send  
+            {  
+                Endpoint = clientEndpoint,  
+                ServiceContractName = XName.Get("IService", "http://tempuri.org"),  
+                OperationName = "Echo",  
+                Content = new SendParametersContent()  
+                {  
+                    Parameters = { { "echoString", new InArgument<string>("Hello, World") } }   
+                }  
+            };  
+  
+            return new SendInstanceIdScope  
+            {  
+                Variables = { echoString },  
+                Activities =  
+                {                      
+                    new CorrelationScope  
+                    {  
+                        Body = new Sequence  
+                        {  
+                            Activities =   
+                            {  
+                                echoRequest,  
+                                new ReceiveReply  
+                                {  
+                                    Request = echoRequest,  
+                                    Content = new ReceiveParametersContent  
+                                    {  
+                                        Parameters = { { "result", new OutArgument<string>(echoString) } }  
+                                    }  
+                                }  
+                            }  
+                        }  
+                    },                      
+                    new WriteLine { Text = new InArgument<string>( (e) => "Received Text: " + echoString.Get(e) ) },                      
+                }  
+            };  
+        }  
+    }  
+}  
+  
+```  
+  
+ コメント。省略できます。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [OperationContext へのアクセス](../../../../docs/framework/windows-workflow-foundation/samples/accessing-operationcontext.md)   
+ [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/accessing-services-using-a-client.md b/docs/framework/wcf/feature-details/accessing-services-using-a-client.md
new file mode 100644
index 00000000000..986b626c3e5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/accessing-services-using-a-client.md
@@ -0,0 +1,107 @@
+---
+title: "クライアントを使用したサービスへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8329832-bf66-4064-9034-bf39f153fc2d
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# クライアントを使用したサービスへのアクセス
+クライアント アプリケーションがサービスと通信するには、クライアント アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントまたはチャネルを作成および構成し、使用する必要があります。  「[WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)」では、オブジェクトの概要および基本的なクライアントやチャネル オブジェクトの作成と使用に関する手順を説明しています。  
+  
+ このトピックでは、ユーザーのシナリオに応じて役立つ、クライアント アプリケーション、クライアント オブジェクト、およびチャネル オブジェクトに関するいくつかの問題について詳しく説明します。  
+  
+## 概要  
+ ここでは、以下の項目に関連する動作と問題について説明します。  
+  
+-   チャネルとセッションの有効期間  
+  
+-   例外処理  
+  
+-   ブロックの問題について  
+  
+-   対話方式によるチャネルの初期化  
+  
+### チャネルとセッションの有効期間  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションのチャネルは、データグラム チャネルとセッションフル チャネルの 2 つに分類されます。  
+  
+ *データグラム* チャネルは、含まれているすべてのメッセージとの相関関係のないチャネルです。  データグラム チャネルでは、入出力操作が失敗しても、通常、次の操作は影響を受けないので、同じチャネルの再利用が可能です。  したがって、通常、データグラム チャネルは失敗になりません。  
+  
+ 一方、*セッションフル* チャネルは、他のエンドポイントと関連付けられたチャネルです。  一方のセッション内のメッセージは、他方の同じセッションと常に関連付けられています。  さらに、セッションが成功したとみなされるためには、セッションの両参加要素が、メッセージ交換要件が満たされたということに同意する必要があります。  両参加要素が同意できない場合、セッション チャネルは失敗になる場合があります。  
+  
+ クライアントを明示的に開く場合も暗黙的に開く場合も、最初の操作を呼び出します。  
+  
+> [!NOTE]
+>  一般的に、障害が生じたセッションフル チャネルを明示的に検出することは有用ではありません。通知されるタイミングがセッションの実装により異なるためです。  たとえば、<xref:System.ServiceModel.NetTcpBinding?displayProperty=fullName> \(信頼できるセッションは無効\) では TCP 接続のセッションが表面に出るため、サービスまたはクライアントで <xref:System.ServiceModel.ICommunicationObject.Faulted?displayProperty=fullName> イベントをリッスンしていれば、ネットワーク エラーが発生すると直ちに通知される可能性があります。  一方、信頼できるセッション \(<xref:System.ServiceModel.Channels.ReliableSessionBindingElement?displayProperty=fullName> を有効化したバインディングにより確立される\) は、サービスが小さなネットワーク エラーから分離されるように設計されています。  妥当な期間内にセッションの再確立が可能な場合、信頼できるセッション用に構成された、この同じバインディングは、中断が長期間発生し続けるまでエラーにならない場合があります。  
+  
+ アプリケーション層にチャネルを公開するほとんどのシステム提供のバインディングでは、既定でセッションが使用されますが、<xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName> では使用されません。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [セッションの使用](../../../../docs/framework/wcf/using-sessions.md).  
+  
+### セッションの適切な使用  
+ セッションを使用すると、メッセージ交換全体が完了したかどうか、そしてメッセージ交換が成功したと両側が見なしたかどうかを認識できます。  呼び出し側のアプリケーションでは、チャネルを開き、使用して、閉じるまでを 1 つの try ブロック内で処理することをお勧めします。  セッション チャネルが開いているときに、<xref:System.ServiceModel.ICommunicationObject.Close%2A?displayProperty=fullName> メソッドを 1 回呼び出して、その呼び出しが正常に返された場合、セッションは成功しています。  この場合の成功とは、バインディングにより指定されているすべての配信保証が満たされ、もう一方の側では <xref:System.ServiceModel.ICommunicationObject.Close%2A> を呼び出す前にチャネルに対して <xref:System.ServiceModel.ICommunicationObject.Abort%2A?displayProperty=fullName> を呼び出さなかったことを意味します。  
+  
+ 次のセクションで、このクライアントによる方法の例を示します。  
+  
+### 例外処理  
+ クライアント アプリケーションで例外を処理することは簡単です。  try ブロック内部でチャネルを開き、使用して、閉じた場合、例外がスローされない限り、メッセージ交換は正常に行われています。  通常、例外がスローされた場合は、メッセージ交換が中止されます。  
+  
+> [!NOTE]
+>  `using` ステートメント \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では `Using`\) を使用することはお勧めできません。  その理由は、`using` ステートメントの最後で例外が発生し、認識する必要のある他の例外がマスクされる可能性があるためです。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [Using ステートメントに関する問題の回避](../../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md).  
+  
+ 次のコード例は、`using` 文ではなく try\/catch ブロックを使用する、推奨されるクライアント パターンを示しています。  
+  
+ [!code-csharp[FaultContractAttribute#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/client.cs#3)]
+ [!code-vb[FaultContractAttribute#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/client.vb#3)]  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.ICommunicationObject.State%2A?displayProperty=fullName> プロパティの値を確認すると競合状態になるので、チャネルを再利用するかどうか、またはチャネルを閉じるかどうかを決定するのにこの値を確認することは推奨されません。  
+  
+ データグラム チャネルを閉じるときに例外が発生しても、データグラム チャネルはエラーになりません。  さらに、非双方向クライアントがセキュリティで保護されたメッセージ交換を使用して認証に失敗した場合、通常、<xref:System.ServiceModel.Security.MessageSecurityException?displayProperty=fullName> がスローされます。  しかし、双方向クライアントがセキュリティで保護されたメッセージ交換を使用して認証に失敗した場合、クライアントは代わりに <xref:System.TimeoutException?displayProperty=fullName> を受信します。  
+  
+ アプリケーション レベルでのエラー情報の処理の詳細については、「[コントラクトおよびサービスのエラーの指定と処理](../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  予期される例外とその処理方法については、「[予期される例外](../../../../docs/framework/wcf/samples/expected-exceptions.md)」を参照してください。  チャネル開発時のエラーの処理方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[例外とエラーの処理](../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md)」を参照してください。  
+  
+### クライアントのブロックとパフォーマンス  
+ アプリケーションが要求\/応答操作を同期的に呼び出す場合、戻り値が受信されるか例外 \(<xref:System.TimeoutException?displayProperty=fullName> など\) がスローされるまで、クライアントはブロックされます。  この動作はローカルの動作と似ています。  アプリケーションが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトまたはチャネルに対する操作を同期的に呼び出す場合、チャネル レイヤーがデータをネットワークに書き込むことができるまで、または例外がスローされるまで、クライアントに制御は戻りません。  また、一方向メッセージ交換パターン \(<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A?displayProperty=fullName> が `true` に設定された操作をマークすることで指定される\) では、クライアントの応答性が向上する可能性がありますが、バインディングや送信済みのメッセージによっては、一方向操作でもブロックが生じる場合があります。  一方向操作とはメッセージ交換のみを指しています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [一方向サービス](../../../../docs/framework/wcf/feature-details/one-way-services.md).  
+  
+ メッセージ交換パターンに関係なく、大規模データのチャンクによりクライアント処理が遅延する場合があります。  この問題の処理方法を理解するには、「[大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)」を参照してください。  
+  
+ 操作が完了してもアプリケーションでさらに処理を行う必要がある場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが実装するサービス コントラクト インターフェイスに非同期のメソッドのペアを作成する必要があります。  これを行うには、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で `/async` スイッチを使用するのが最も簡単な方法です。  例については、「[方法 : サービス操作を非同期に呼び出す](../../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)」を参照してください。  
+  
+ クライアントのパフォーマンス向上[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[中間層クライアント アプリケーション](../../../../docs/framework/wcf/feature-details/middle-tier-client-applications.md)」を参照してください。  
+  
+### ユーザーによる資格情報の動的選択の有効化  
+ <xref:System.ServiceModel.Dispatcher.IInteractiveChannelInitializer> インターフェイスを使用すると、アプリケーションによりユーザー インターフェイスが表示され、ユーザーが資格情報を選択できるようになります。この資格情報は、タイムアウト タイマーが開始される前に、チャネルの作成に使用されます。  
+  
+ アプリケーション開発者は、挿入された <xref:System.ServiceModel.Dispatcher.IInteractiveChannelInitializer> を 2 つの方法で利用できます。  チャネルを開く前 \(*明示的*方法\)、または最初の操作を呼び出す前 \(*暗黙的*方法\) に、クライアント アプリケーションで <xref:System.ServiceModel.ClientBase%601.DisplayInitializationUI%2A?displayProperty=fullName> または <xref:System.ServiceModel.IClientChannel.DisplayInitializationUI%2A?displayProperty=fullName> \(または非同期バージョン\) を呼び出すことができます。  
+  
+ 暗黙的方法を使用する場合、アプリケーションは最初の操作を <xref:System.ServiceModel.ClientBase%601> または <xref:System.ServiceModel.IClientChannel> 拡張に対して呼び出す必要があります。  アプリケーションが最初の操作以外の何かを呼び出した場合、例外がスローされます。  
+  
+ 明示的方法を使用する場合、アプリケーションで次の手順を順番に実行する必要があります。  
+  
+1.  <xref:System.ServiceModel.ClientBase%601.DisplayInitializationUI%2A?displayProperty=fullName> または <xref:System.ServiceModel.IClientChannel.DisplayInitializationUI%2A?displayProperty=fullName> \(または非同期バージョン\) を呼び出します。  
+  
+2.  初期化子が返された場合は、<xref:System.ServiceModel.IClientChannel> オブジェクトまたは <xref:System.ServiceModel.ClientBase%601.InnerChannel%2A?displayProperty=fullName> プロパティで返された <xref:System.ServiceModel.IClientChannel> オブジェクトの <xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出します。  
+  
+3.  操作を呼び出します。  
+  
+ 製品品質のアプリケーションでは、明示的な方法を採用することによってユーザー インターフェイスのプロセスを制御することをお勧めします。  
+  
+ 暗黙的な方法を使用するアプリケーションでは、ユーザー インターフェイス初期化子が呼び出されますが、このアプリケーションのユーザーがバインディングの送信タイムアウト期間内に応答できない場合、ユーザー インターフェイスが復帰すると例外がスローされます。  
+  
+## 参照  
+ [双方向サービス](../../../../docs/framework/wcf/feature-details/duplex-services.md)   
+ [方法 : 一方向コントラクトと要求\/応答コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md)   
+ [方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)   
+ [方法 : WSE 3.0 サービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md)   
+ [方法 : ChannelFactory を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md)   
+ [方法 : サービス操作を非同期に呼び出す](../../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)   
+ [中間層クライアント アプリケーション](../../../../docs/framework/wcf/feature-details/middle-tier-client-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/accessing-wcf-services-with-a-windows-store-client-app.md b/docs/framework/wcf/feature-details/accessing-wcf-services-with-a-windows-store-client-app.md
new file mode 100644
index 00000000000..b7b70b7d643
--- /dev/null
+++ b/docs/framework/wcf/feature-details/accessing-wcf-services-with-a-windows-store-client-app.md
@@ -0,0 +1,158 @@
+---
+title: "Windows ストア クライアント アプリを使用した WCF サービスへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2002ef4-5dee-4a54-9d87-03b33d35fc52
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# Windows ストア クライアント アプリを使用した WCF サービスへのアクセス
+Windows 8 では、Windows ストア アプリケーションと呼ばれる新しい種類のアプリケーションが導入されています。 これらのアプリケーションはタッチ スクリーンのインターフェイスを念頭にデザインされています。 .NET Framework 4.5 により、Windows ストア アプリケーションから WCF サービスを呼び出すことができます。  
+  
+## Windows ストア アプリケーションでの WCF のサポート  
+ WCF 機能の一部は、Windows ストア アプリケーション内から利用できます。詳細については、以降のセクションを参照してください。  
+  
+> [!IMPORTANT]
+>  WCF で公開される API ではなく、WinRT 配信 API を使用してください。 詳細については、「[Windows.Web.Syndication 名前空間](http://go.microsoft.com/fwlink/?LinkId=236265)」を参照してください。  
+  
+> [!WARNING]
+>  サービス参照の追加を使用して Windows ランタイム コンポーネントへの Web サービス参照を追加することはサポートされていません。  
+  
+### サポートされているバインド  
+ Windows ストア アプリケーションでは、以下の WCF バインドがサポートされています。  
+  
+1.  <xref:System.ServiceModel.BasicHttpBinding>  
+  
+2.  <xref:System.ServiceModel.NetTcpBinding>  
+  
+3.  <xref:System.ServiceModel.NetHttpBinding>  
+  
+4.  <xref:System.ServiceModel.CustomBinding>  
+  
+ Windows ストア アプリケーションでは、以下のバインド要素がサポートされています。  
+  
+1.  <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>  
+  
+2.  <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>  
+  
+3.  <xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement>  
+  
+4.  <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>  
+  
+5.  <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>  
+  
+6.  <xref:System.ServiceModel.Channels.TcpTransportBindingElement>  
+  
+7.  <xref:System.ServiceModel.Channels.HttpTransportBindingElement>  
+  
+8.  <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>  
+  
+9. <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>  
+  
+ テキスト エンコードとバイナリ エンコードの両方がサポートされています。 すべての WCF 転送モードがサポートされています。 詳細については、「[メッセージ転送ストリーミング](../../../../docs/framework/wcf/feature-details/streaming-message-transfer.md)」を参照してください。  
+  
+### サービス参照の追加  
+ WCF サービスを Windows ストア アプリケーションから呼び出すには、Visual Studio 2012 の "サービス参照の追加" 機能を使用します。 Windows ストア アプリケーションでは、"サービス参照の追加" 機能にいくつかの変更が行われていることがわかります。 まず、構成ファイルが生成されません。 Windows ストア アプリケーションでは構成ファイルが使用されないため、コードで構成する必要があります。 この構成コードは、"サービス参照の追加" によって生成される References.cs ファイルにあります。 このファイルを表示するには、ソリューション エクスプローラーで \[すべてのファイルを表示\] を選択します。 このファイルは、\[サービス参照\] の下のプロジェクト内の Reference.svcmap ノードにあります。 Windows ストア アプリケーション内で WCF サービスに対して生成されるすべての操作は非同期で、タスク ベースの非同期パターンが使用されます。 詳細については、「[タスク ベースの非同期パターン](http://msdn.microsoft.com/magazine/ff959203.aspx)」を参照してください。  
+  
+ 構成がコードで生成されるようになったため、サービス参照を更新するたびに、Reference.cs ファイルで行ったすべての変更が上書きされます。 この状況に対処するために、構成コードは部分メソッド内に生成され、これをクライアント プロキシ クラスで実装できます。 部分メソッドは次のように宣言されています。  
+  
+```csharp  
+static partial void Configure(System.ServiceModel.Description.ServiceEndpoint serviceEndpoint, System.ServiceModel.Description.ClientCredentials clientCredentials);  
+  
+```  
+  
+ その後、この部分メソッドを実装し、次のように、クライアント プロキシ クラスのバインドまたはエンドポイントを変更できます。  
+  
+```csharp  
+public partial class Service1Client : System.ServiceModel.ClientBase<MetroWcfClient.ServiceRefMultiEndpt.IService1>, MetroWcfClient.ServiceRefMultiEndpt.IService1 { static partial void Configure(System.ServiceModel.Description.ServiceEndpoint serviceEndpoint, System.ServiceModel.Description.ClientCredentials clientCredentials) { if (serviceEndpoint.Name == ServiceRefMultiEndpt.Service1Client.EndpointConfiguration.BasicHttpBinding_IService1.ToString()) { serviceEndpoint.Binding.SendTimeout = new System.TimeSpan(0, 1, 0); } else if (serviceEndpoint.Name == ServiceRefMultiEndpt.Service1Client.EndpointConfiguration.BasicHttpBinding_IService11.ToString()) { serviceEndpoint.Binding.SendTimeout = new System.TimeSpan(0, 1, 0); clientCredentials.UserName.UserName = "username1"; clientCredentials.UserName.Password = "password"; } else if (serviceEndpoint.Name == ServiceRefMultiEndpt.Service1Client.EndpointConfiguration.NetTcpBinding_IService1.ToString()) { serviceEndpoint.Binding.Name = "MyTcpBinding"; serviceEndpoint.Address = new System.ServiceModel.EndpointAddress("net.tcp://localhost/tcp"); } } }  
+  
+```  
+  
+### シリアル化  
+ Windows ストア アプリケーションでは、次のシリアライザーがサポートされています。  
+  
+1.  DataContractSerializer  
+  
+2.  DataContractJsonSerializer  
+  
+3.  XmlSerializer  
+  
+> [!WARNING]
+>  XmlDictionaryWriter.Write\(DateTime\) は、DateTime オブジェクトを文字列として出力するようになりました。  
+  
+### セキュリティ  
+ Windows ストア アプリケーションでは、次のセキュリティ モードがサポートされています。  
+  
+1.  <xref:System.ServiceModel.SecurityMode>  
+  
+2.  <xref:System.ServiceModel.SecurityMode>  
+  
+3.  <xref:System.ServiceModel.SecurityMode.TransportWithMessageCredentials>  
+  
+4.  <xref:System.ServiceModel.SecurityMode.TransportCredentialOnly>  
+  
+ Windows ストア アプリケーションでは、次の種類のクライアント資格情報がサポートされています。  
+  
+1.  なし  
+  
+2.  Basic  
+  
+3.  Digest  
+  
+4.  Negotiate  
+  
+5.  NTLM  
+  
+6.  Windows  
+  
+7.  ユーザー名 \(メッセージ セキュリティ\)  
+  
+8.  Windows \(トランスポート セキュリティ\)  
+  
+ Windows ストア アプリケーションから既定の Windows 資格情報にアクセスして送信するためには、Package.appmanifest ファイル内でこの機能を有効にする必要があります。 このファイルを開いて \[機能\] タブをクリックし、\[既定の Windows 資格情報\] を選択します。 これにより、ドメイン資格情報を必要とするイントラネット リソースにアプリケーションが接続できるようになります。  
+  
+> [!IMPORTANT]
+>  Windows ストア アプリケーションでコンピューター間での呼び出しを実行するには、"ホーム\/社内ネットワーク" という別の機能を有効にする必要があります。 この設定は、Package.appmanifest ファイル内の \[機能\] タブにもあります。 \[ホーム\/社内ネットワーク\] チェック ボックスをオンにします。 これで、アプリケーションは、自宅や職場など、ユーザーが信頼できる場所のネットワークに着信および発信アクセスできるようになります。 着信方向の重要なポートは常にブロックされます。 また、インターネット上のサービスにアクセスするには、インターネット \(クライアント\) の機能も有効にする必要があります。  
+  
+### \[その他\]  
+ Windows ストア アプリケーションでは、次のクラスの使用がサポートされています。  
+  
+1.  <xref:System.ServiceModel.ChannelFactory>  
+  
+2.  <xref:System.ServiceModel.DuplexChannelFactory>  
+  
+3.  <xref:System.ServiceModel.CallbackBehaviorAttribute>  
+  
+### サービス コントラクトの定義  
+ 非同期サービス操作の定義には、タスク ベースの非同期パターンのみを使用することをお勧めします。 これにより、サービス操作の呼び出し中も、Windows ストア アプリケーションの応答が維持されます。  
+  
+> [!WARNING]
+>  同期操作を定義した場合でも例外はスローされませんが、非同期操作のみを定義することを強くお勧めします。  
+  
+### Windows ストア アプリケーションからの WCF サービスの呼び出し  
+ 既に説明したように、すべての構成は、生成されたプロキシ クラスの GetBindingForEndpoint メソッドのコード内で行う必要があります。 次のコードに示すように、サービス操作の呼び出しは、タスク ベースの非同期メソッドの呼び出しと同じように実行されます。  
+  
+```csharp  
+void async SomeMethod() { ServiceClient proxy = new ServiceClient(); Task<T> results = await proxy.CallAsync(param1, param2); T result = results.Result; if (result.Success) { // Do something with result } }  
+  
+```  
+  
+ 非同期呼び出しを行うメソッドでは async キーワード、非同期メソッドの呼び出し時には await キーワードが使用されていることに注意してください。  
+  
+## 参照  
+ [Windows ストア アプリ ブログの WCF](http://blogs.msdn.com/b/piyushjo/archive/2011/09/22/wcf-in-win8-metro-styled-apps-absolutely-supported.aspx)   
+ [WCF Windows ストア クライアントおよびセキュリティ](http://blogs.msdn.com/b/piyushjo/archive/2011/10/11/calling-a-wcf-service-from-a-metro-application-adding-security.aspx)   
+ [Windows ストア アプリとコンピューター間の呼び出し](http://blogs.msdn.com/b/piyushjo/archive/2011/10/22/calling-a-wcf-service-from-a-metro-application-cross-machine-scenario.aspx)   
+ [Azure にデプロイされた WCF サービスの Windows ストア アプリからの呼び出し](http://blogs.msdn.com/b/piyushjo/archive/2011/10/22/calling-a-wcf-service-from-a-metro-application-cross-machine-scenario.aspx)   
+ [WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)   
+ [バインディング](../../../../docs/framework/wcf/bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/adding-a-service-reference-in-a-workflow-solution.md b/docs/framework/wcf/feature-details/adding-a-service-reference-in-a-workflow-solution.md
new file mode 100644
index 00000000000..6f6ebbd8836
--- /dev/null
+++ b/docs/framework/wcf/feature-details/adding-a-service-reference-in-a-workflow-solution.md
@@ -0,0 +1,27 @@
+---
+title: "ワークフロー ソリューションでのサービス参照の追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83574cf3-9803-49bc-837f-432936dc9c76
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ワークフロー ソリューションでのサービス参照の追加
+ワークフロー アプリケーションでのサービス参照の追加は、通常の WCF アプリケーションとは動作が少し異なります。\[サービス参照の追加\] を選択し、サービスの URL を指定すると、メタデータがダウンロードされ、カスタム アクティビティが生成されて、参照を追加した WCF サービスまたは WCF ワークフロー サービスを呼び出すことができるようになります。サービス参照を追加した後、生成されたアクティビティがビルドされるように、ソリューションを再ビルドします。これにより、アクティビティがワークフロー デザイナー ツールボックスに表示されます。ただし、この方法が機能するのはワークフロー ソリューション内でサービス参照を追加する場合だけであることに注意してください。他の種類のプロジェクトでサービス参照を追加する方法については、Web キャストの「[Web プロジェクトでのワークフローからの WCF サービスの呼び出し](http://go.microsoft.com/fwlink/?LinkId=207725)」を参照してください。  
+  
+ 同じ操作名が含まれるサービスへのサービス参照を複数追加すると、問題が発生します。生成されたアクティビティは最初のサービス操作しか呼び出しません。この問題を回避するには、サービス操作を別々の名前に変更するか、生成された各アクティビティ内でエンドポイント構成名を変更します。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [方法: 別のワークフロー サービスを呼び出すワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-that-calls-another-workflow-service.md)   
+ [Web プロジェクトでのワークフローからの WCF サービスの呼び出し](http://go.microsoft.com/fwlink/?LinkId=207725)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/adding-online-and-offline-status.md b/docs/framework/wcf/feature-details/adding-online-and-offline-status.md
new file mode 100644
index 00000000000..60a1de73ffc
--- /dev/null
+++ b/docs/framework/wcf/feature-details/adding-online-and-offline-status.md
@@ -0,0 +1,28 @@
+---
+title: "オンライン ステータスとオフライン ステータスの追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05e5f51d-81b6-4c17-b364-9dda447a5fce
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# オンライン ステータスとオフライン ステータスの追加
+多くの場合、アプリケーションではピア チャネル接続のステータスについて明確な詳細情報を監視することが重要です。この情報は、<xref:System.ServiceModel.IOnlineStatus> インターフェイスの実装で `GetProperty` メソッドを呼び出すことで取得できます。このインターフェイスを実装するオブジェクトは、接続ステータスを監視したり、`OnOnline` や `OnOffline` などのイベント ハンドラーを登録したりできるため、オンライン ステータスに変化があると即座に反応できます。  
+  
+ ピア チャネル インフラストラクチャでは、クライアントが少なくとも 1 つのピアに接続されているとオンラインと見なされ、そうでない場合はオフラインと見なされます。このことは、開発中のアプリケーションをデバッグする際や、エンド ユーザーに詳細情報を表示する際に特に役立ちます。  
+  
+> [!NOTE]
+>  オンライン イベント ハンドラーでは、メッセージを送信する前に、まず、ノードが開いていることを確認する必要があります。  
+  
+## 参照  
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/adopting-wcf.md b/docs/framework/wcf/feature-details/adopting-wcf.md
new file mode 100644
index 00000000000..fe649b38d5b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/adopting-wcf.md
@@ -0,0 +1,37 @@
+---
+title: "Windows Communication Foundation の採用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49ba71e2-9468-4082-84c5-cf8daf95e34a
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Windows Communication Foundation の採用
+ASP.NET を使用して開発した既存のアプリケーションのメンテナンスを続行しながら、新規開発については [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を選択できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、どのようなシナリオにおいても .NET Framework を使用してビルドされたアプリケーションとの通信を容易に行うための最適な選択となるように設計されているため、これまで ASP.NET では実現できなかったような方法でソフトウェア通信における多様な問題を解決するための標準ツールとして使用できます。  
+  
+ 新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、既存の ASP.NET Web サービスがある同じコンピューター上に展開できます。既存の ASP.NET Web サービスが、バージョン 2.0 より前の .NET Framework を使用している場合は、ASP.NET IIS 登録ツールを使用して、新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションをホストできる IIS アプリケーションに .NET Framework 2.0 を選択的に展開できます。このツールについてのドキュメントは [ASP.NET IIS Registration Tool \(Aspnet\_regiis.exe\)](http://go.microsoft.com/fwlink/?LinkId=94687) にあり、ユーザー インターフェイスは IIS 6.0 管理コンソールに組み込まれています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、ASP.NET 互換モードで実行するように構成された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを IIS の既存の ASP.NET Web サービス アプリケーションに追加することで、既存の ASP.NET Web サービスに新しい機能を追加できます。ASP.NET 互換モードにより、新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのコードは、<xref:System.Web.HttpContext> クラスを使用することで、既存の ASP.NET コードと同じアプリケーション状態情報にアクセスして更新を行うことができます。また、アプリケーションは同じクラス ライブラリを共有することもできます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは、ASP.NET Web サービスを使用できます。ASP.NET Web サービス クライアントは、<xref:System.ServiceModel.BasicHttpBinding> で構成された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを使用できます。ASP.NET Web サービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションとの共存が可能であり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して既存の ASP.NET Web サービスに機能を追加することもできます。このように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と ASP.NET Web サービスは同時に使用できるため、ASP.NET Web サービスから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行が必要になるのは、ASP.NET Web サービスでは提供されず、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのみ提供される機能が必要な場合に限られるかもしれません。  
+  
+ このような移行が必要となるまれな場合においても、あるテクノロジから別のテクノロジへコードを移行するのは、ほとんどの場合、正しいアプローチではないということを考慮する必要があります。以前のテクノロジでは満たされない新しい要件を満たすために新しいテクノロジを採用する場合、新たに拡張された要件を満たす新しいソリューションを設計することが正しい方法です。新しい設計では、既存のシステムでの経験とそのシステムを設計して以来、獲得した知識を活用できます。また、新しい設計は、新しいプラットフォーム上で古い設計を再制作するのではなく、新しいテクノロジの機能を十分に活用することができます。新しい設計の主要な要素のプロトタイプが完成すると、既存のシステムのコードを新しいシステム内で再使用することが容易になります。  
+  
+ ASP.NET Web サービスから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行が正しいソリューションであると考えられるまれな場合のために、以下にこれを実行に移すためのガイダンスを示します。これには、サービスを移行する方法、およびクライアントを移行する方法についてのアドバイスが含まれています。  
+  
+ 既存の ASP.NET Web サービスを WCF へ移行する方法の詳細な分析については、「[ASP.NET Web サービスと Windows Communication Foundation](http://go.microsoft.com/fwlink/?LinkID=71761)」を参照してください。ここでは、ASP.NET Web サービスのメタデータから WCF 準拠サービスを実装する方法、および ASP.NET Web サービスおよびクライアントのコードを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行する方法について説明しています。  
+  
+## 参照  
+ [方法 : メタデータの取得および準拠サービスの実装をする](../../../../docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md)   
+ [方法 : ASP.NET Web サービス コードを Windows Communication Foundation に移行する](../../../../docs/framework/wcf/feature-details/migrate-asp-net-web-service-to-wcf.md)   
+ [方法 : ASP.NET Web サービス クライアント コードを Windows Communication Foundation に移行する](../../../../docs/framework/wcf/feature-details/migrate-asp-net-web-service-client-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/ajax-integration-and-json-support.md b/docs/framework/wcf/feature-details/ajax-integration-and-json-support.md
new file mode 100644
index 00000000000..021650976fa
--- /dev/null
+++ b/docs/framework/wcf/feature-details/ajax-integration-and-json-support.md
@@ -0,0 +1,41 @@
+---
+title: "AJAX の統合と JSON のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AJAX の統合と JSON のサポート [WCF]"
+ms.assetid: 3851a8fc-d861-4ac1-873c-96af0343d3a7
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# AJAX の統合と JSON のサポート
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が ASP.NET AJAX \(Asynchronous JavaScript and XML\) と JSON \(JavaScript Object Notation\) データ形式をサポートするため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは AJAX クライアントに操作を公開できます。AJAX クライアントは、JavaScript コードを実行し、HTTP 要求を使用してこのような [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにアクセスする Web ページです。このセクションのトピックでは、このサポートと実装方法について説明します。  
+  
+ ASP.NET AJAX とその ASP.NET 2.0 との統合[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ASP.NET AJAX の概要](http://go.microsoft.com/fwlink/?LinkId=96725)」を参照してください。  
+  
+## このセクションの内容  
+ [ASP.NET AJAX 用の WCF サービスの作成](../../../../docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md)  
+ 構成によって、または、自動的に AJAX エンドポイントを構成するサービス ホストを生成するようにカスタマイズされたサービス ホスト ファクトリを使用することによって適切な AJAX エンドポイントを追加することで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを AJAX クライアントに公開する方法について説明します。  
+  
+ [ASP.NET を使用せずに WCF AJAX サービスを作成する方法](../../../../docs/framework/wcf/feature-details/creating-wcf-ajax-services-without-aspnet.md)  
+ ASP.NET を使用しないで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成する方法について説明します。  
+  
+ [JSON などのデータ転送形式のサポート](../../../../docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md)  
+ ASP.NET AJAX サービスとのメッセージングで、XML の代わりに一般に使用される JSON 形式のサポートについて説明します。  
+  
+ [方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md)  
+ AJAX 対応の ASP.NET Web サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービスに移行する方法について説明します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/anticipating-adopting-the-wcf-easing-future-integration.md b/docs/framework/wcf/feature-details/anticipating-adopting-the-wcf-easing-future-integration.md
new file mode 100644
index 00000000000..1effd46e328
--- /dev/null
+++ b/docs/framework/wcf/feature-details/anticipating-adopting-the-wcf-easing-future-integration.md
@@ -0,0 +1,55 @@
+---
+title: "Windows Communication Foundation 導入の準備 : 将来的な統合の容易化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3028bba8-6355-4ee0-9ecd-c56e614cb474
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Windows Communication Foundation 導入の準備 : 将来的な統合の容易化
+現在 ASP.NET を使用しており、将来 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用する予定である場合、このトピックは、新規の ASP.NET Web サービスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションと共に問題なく動作するためのガイダンスになります。  
+  
+## 一般的な推奨事項  
+ ASP.NET 2.0 を使用して、すべての新規サービスを作成します。こうすることで、拡張および強化された新バージョンの機能にアクセスできます。またこれにより、ASP.NET 2.0 コンポーネントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントとを同じアプリケーション内で使用する可能性にも対応できます。  
+  
+## プロトコル  
+ WS\-I Basic Profile 1.1 への準拠を検証するには、次のように ASP.NET 2.0 の新機能を使用します。  
+  
+```  
+[WebService(Namespace = "http://tempuri.org/")]  
+[WebServiceBinding(  
+     ConformsTo = WsiProfiles.BasicProfile1_1,  
+     EmitConformanceClaims=true)]  
+public interface IEcho  
+  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の定義済みバインディングである <xref:System.ServiceModel.BasicHttpBinding> を使用することによって、WS\-I Basic Profile 1.1 準拠の ASP.NET Web サービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと相互運用できます。  
+  
+## サービスの配置  
+ <xref:System.Web.Services.Protocols.SoapDocumentServiceAttribute> 属性を使用する場合、SOAPAction HTTP ヘッダーではなく、SOAP メッセージの本文要素の完全修飾名に基づいてメッセージをメソッドへルーティングすることは避けます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAPAction HTTP ヘッダーを使用してメッセージをルーティングします。  
+  
+## データ表現  
+ <xref:System.Xml.Serialization.XmlSerializer> によって既定で型のシリアル化が行われる XML は、XML の名前空間が明示的に定義されている場合、<xref:System.Runtime.Serialization.DataContractSerializer> によって型のシリアル化が行われる XML と意味的に同一です。将来 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用する予定の場合、ASP.NET Web サービスで使用するデータ型を定義するには、次の操作を実行します。  
+  
+1.  XML スキーマではなく、.NET Framework クラスを使用して型を定義します。  
+  
+2.  <xref:System.SerializableAttribute> と <xref:System.Xml.Serialization.XmlRootAttribute> だけをそのクラスに追加します。後者を使用して型の名前空間を明示的に定義してください。.NET Framework クラスを XML に変換する方法を制御する目的で、<xref:System.Xml.Serialization> 名前空間の属性を追加しないでください。  
+  
+ この手法を採用すると、後から <xref:System.Runtime.Serialization.DataContractAttribute> および <xref:System.Runtime.Serialization.DataMemberAttribute> を追加することで、転送のためにクラスをシリアル化する XML に大きな変更を加えることなく .NET クラスをデータ コントラクトにすることができます。ASP.NET Web サービスがメッセージ内で使用する型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションによってデータ コントラクトとして処理することが可能です。これにはさまざまな利点がありますが、特に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションではより高いパフォーマンスを引き出すことができます。  
+  
+## セキュリティ  
+ インターネット インフォメーション サービス \(IIS\) に用意されている認証オプションは使用しないでください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントではこれらの認証オプションはサポートされません。サービスをセキュリティで保護する必要がある場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供されるオプションを使用します。こちらのオプションの方が選択の幅が広く、標準プロトコルに基づいているためです。  
+  
+## 参照  
+ [Windows Communication Foundation の採用 : 将来の移行の簡略化](../../../../docs/framework/wcf/feature-details/anticipating-adopting-wcf-migration.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/anticipating-adopting-wcf-migration.md b/docs/framework/wcf/feature-details/anticipating-adopting-wcf-migration.md
new file mode 100644
index 00000000000..0509eff0322
--- /dev/null
+++ b/docs/framework/wcf/feature-details/anticipating-adopting-wcf-migration.md
@@ -0,0 +1,137 @@
+---
+title: "Windows Communication Foundation の採用 : 将来の移行の簡略化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f49664d9-e9e0-425c-a259-93f0a569d01b
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Windows Communication Foundation の採用 : 将来の移行の簡略化
+将来、新しい ASP.NET アプリケーションを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] へ簡単に移行できるようにするには、前述の推奨事項および次の推奨事項に従います。  
+  
+## プロトコル  
+ ASP.NET 2.0 の SOAP 1.2 サポートを無効にします。  
+  
+```  
+<configuration>  
+     <system.web>  
+      <webServices >  
+          <protocols>  
+           <remove name="HttpSoap12"/>  
+          </protocols>    
+      </webServices>  
+     </system.web>   
+</configuration>  
+  
+```  
+  
+ このような処理を行うのは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではさまざまなエンドポイントを介してメッセージを交換するため、SOAP 1.1 や SOAP 1.2 など各種プロトコルに対応する必要があるためです。  ASP.NET 2.0 Web サービスが SOAP 1.1 と SOAP 1.2 を両方ともサポートするように構成されている場合 \(既定の構成\)、その ASP.NET Web サービスの既存の全クライアントと確実に互換性のある、元のアドレスの単一の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントに移行することはできません。  また、SOAP 1.1 ではなく 1.2 を選択すると、サービスの利用者がさらに厳しく制限されます。  
+  
+## サービスの開発  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.ServiceContractAttribute> をインターフェイスまたはクラスのいずれかに適用することでサービス コントラクトを定義できます。  この属性は、クラスではなくインターフェイスに適用することをお勧めします。これにより、任意の数のクラスでさまざまに実装できるコントラクト定義が作成されます。  ASP.NET 2.0 では、<xref:System.Web.Services.WebService> 属性をクラスだけでなくインターフェイスに適用することもできます。  ただし、既に説明したように ASP.NET 2.0 には不具合があり、<xref:System.Web.Services.WebService> 属性をクラスではなくインターフェイスに適用した場合、この属性の名前空間パラメーターが有効化されません。  一般に、<xref:System.Web.Services.WebService> 属性の名前空間パラメーターを使用して、サービスの名前空間を既定値の http:\/\/tempuri.org から変更することが望ましので、引き続き <xref:System.ServiceModel.ServiceContractAttribute> 属性をインターフェイスまたはクラスに適用して ASP.NET Web サービスを定義する必要があります。  
+  
+-   これらのインターフェイスを定義するメソッドに含めるコードは、できるだけ少なくします。  これらのメソッドの作業を他のクラスに委任します。  その際、新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの型も、実質的な作業をそのクラスに委任できます。  
+  
+-   <xref:System.Web.Services.WebMethodAttribute> の `MessageName` パラメーターを使用して、サービスの動作の明示的な名前を指定します。  
+  
+    ```  
+    [WebMethod(MessageName="ExplicitName")]  
+    string Echo(string input);  
+    ```  
+  
+     ASP.NET と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では既定の動作名が異なるので、この処理は重要です。  明示的な名前を指定することで、既定の名前への依存を避けることができます。  
+  
+-   ASP.NET Web サービスの動作を多様メソッドで実装しないでください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、多様メソッドを使用した動作の実装がサポートされていません。  
+  
+-   <xref:System.Web.Services.Protocols.SoapDocumentMethodAttribute> を使用して、HTTP 要求をメソッドにルーティングする SOAPAction HTTP ヘッダーの明示的な値を指定します。  
+  
+    ```  
+    [WebMethod]  
+    [SoapDocumentMethod(RequestElementName="ExplicitAction")]  
+    string Echo(string input);  
+    ```  
+  
+     この方法により、ASP.NET と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で SOAPAction の同じ既定値を使用する必要がなくなります。  
+  
+-   SOAP 拡張機能は使用しないでください。  SOAP 拡張機能が必要な場合は、それを検討する目的の機能が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で既に提供されていないかどうかを確認します。  目的の機能が備わっている場合は、"すぐには [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を導入しない" という方針を考え直してください。  
+  
+## 状態管理  
+ サービスで状態を維持する必要がないようにします。  状態を維持すると、アプリケーションのスケーラビリティが損なわれるだけではありません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ASP.NET 互換モードを使用すれば ASP.NET のメカニズムに対応できるとはいえ、ASP.NET と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] とでは状態管理メカニズムが大きく異なります。  
+  
+## 例外処理  
+ サービスで送受信するデータ型の構造を設計するときは、クライアントに伝達する必要があり、サービス内で発生する可能性のあるさまざまな種類の例外を表現する構造も設計します。  
+  
+```  
+[Serializable]  
+[XmlRoot(  
+     Namespace="ExplicitNamespace", IsNullable=true)]  
+    public partial class AnticipatedException {  
+  
+     private string anticipatedExceptionInformationField;  
+  
+     public string AnticipatedExceptionInformation {  
+      get {  
+          return this.anticipatedExceptionInformationField;  
+          }  
+      set {  
+          this.anticipatedExceptionInformationField = value;  
+          }  
+     }  
+}  
+```  
+  
+ これらのクラスには、自分自身を XML にシリアル化する機能を与えます。  
+  
+```  
+public XmlNode ToXML()  
+{  
+     XmlSerializer serializer = new XmlSerializer(  
+      typeof(AnticipatedException));  
+     MemoryStream memoryStream = new MemoryStream();  
+     XmlTextWriter writer = new XmlTextWriter(  
+     memoryStream, UnicodeEncoding.UTF8);  
+     serializer.Serialize(writer, this);  
+     XmlDocument document = new XmlDocument();  
+     document.LoadXml(new string(  
+     UnicodeEncoding.UTF8.GetChars(  
+     memoryStream.GetBuffer())).Trim());  
+    return document.DocumentElement;  
+}  
+```  
+  
+ これでこのクラスを使用して、明示的にスローされた <xref:System.Web.Services.Protocols.SoapException> インスタンスの詳細を指定できます。  
+  
+```  
+AnctipatedException exception = new AnticipatedException();  
+exception.AnticipatedExceptionInformation = "…";  
+throw new SoapException(  
+     "Fault occurred",  
+     SoapException.ClientFaultCode,  
+     Context.Request.Url.AbsoluteUri,  
+     exception.ToXML());  
+  
+```  
+  
+ この例外クラスは、新しい `FaultException<AnticipatedException>(anticipatedException);` をスローするのに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] <xref:System.ServiceModel.FaultException%601> クラスと共に簡単に再利用できます。  
+  
+## セキュリティ  
+ セキュリティに関する推奨事項を次にいくつか示します。  
+  
+-   ASP.NET 2.0 のプロファイルは使用しないでください。サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] へ移行した場合、ASP.NET 統合モードの使用が制限されます。  
+  
+-   サービスへのアクセスを制御する目的で ACL を使用しないでください。ASP.NET Web サービスはインターネット インフォメーション サービス \(IIS\) を使用して ACL を サポートしますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はサポートしません。これは、ASP.NET Web サービスはホスティングを IIS に依存しますが、WCF は IIS でホストされる必要がないためです。  
+  
+-   サービスのリソースへのアクセスを承認するには、ASP.NET 2.0 ロール プロバイダーの使用を検討してください。  
+  
+## 参照  
+ [Windows Communication Foundation 導入の準備 : 将来的な統合の容易化](../../../../docs/framework/wcf/feature-details/anticipating-adopting-the-wcf-easing-future-integration.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/architecture-of-syndication.md b/docs/framework/wcf/feature-details/architecture-of-syndication.md
new file mode 100644
index 00000000000..797601f17e7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/architecture-of-syndication.md
@@ -0,0 +1,90 @@
+---
+title: "配信のアーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed4ca86e-e3d8-4acb-87aa-1921fbc353be
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# 配信のアーキテクチャ
+配信 API は、形式に依存せず、さまざま形式で概要コンテンツをネットワークに書き込むことができるプログラミング モデルを提供することを目的としています。  抽象データ モデルは、次のクラスで構成されています。  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationCategory>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationFeed>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationItem>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationLink>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationPerson>  
+  
+ これらのクラスは、一部の名前が異なっていますが、Atom 1.0 仕様に規定されるコンストラクトに厳密にマップされています。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、配信フィードはその戻り値の型が <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> の派生クラスの 1 つである別の種類のサービス操作としてモデル化されています。  フィードの取得は要求\/応答のメッセージ交換としてモデル化されています。  クライアントはサービスに要求を送信し、サービスがこれに応答します。  要求メッセージはインフラストラクチャ プロトコル \(生の HTTP など\) 上に設定され、応答メッセージは広く認識されている配信形式 \(RSS 2.0 または Atom 1.0\) から構成されるペイロードを含んでいます。  このようなメッセージ交換を実装するサービスは、配信サービスと呼ばれます。  
+  
+ 配信サービスのコントラクトは、<xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> クラスのインスタンスを返す一連の操作から構成されます。  配信サービスのインターフェイス宣言の例を次に示します。  
+  
+ [!code-csharp[S_UE_SyndicationBoth#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ue_syndicationboth/cs/service.cs#0)]  
+  
+ 配信のサポートは、<xref:System.ServiceModel.WebHttpBinding> バインディングを定義する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST プログラミング モデル上に組み込まれています。このバインディングを <xref:System.ServiceModel.Description.WebHttpBehavior> と共に使用すると、フィードをサービスとして利用できるようになります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST プログラミング モデルの[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  Atom 1.0 仕様では、date コンストラクトで小数秒を指定できます。  シリアル化および逆シリアル化する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の実装では小数秒は無視されます。  
+  
+## オブジェクト モデル  
+ 配信のオブジェクト モデルは、次の各表に示すクラスのグループから構成されています。  
+  
+ 形式設定クラス  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.ServiceModel.Syndication.Atom10FeedFormatter>|<xref:System.ServiceModel.Syndication.SyndicationFeed> インスタンスを Atom 1.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Atom10FeedFormatter%601>|<xref:System.ServiceModel.Syndication.SyndicationFeed> 派生クラスを Atom 1.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Atom10ItemFormatter>|<xref:System.ServiceModel.Syndication.SyndicationItem> インスタンスを Atom 1.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Atom10ItemFormatter%601>|<xref:System.ServiceModel.Syndication.SyndicationItem> 派生クラスを Atom 1.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Rss20FeedFormatter>|<xref:System.ServiceModel.Syndication.SyndicationFeed> インスタンスを RSS 2.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Rss20FeedFormatter%601>|<xref:System.ServiceModel.Syndication.SyndicationFeed> 派生クラスを RSS 2.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Rss20ItemFormatter>|<xref:System.ServiceModel.Syndication.SyndicationItem> インスタンスを RSS 2.0 形式にシリアル化するクラス。|  
+|<xref:System.ServiceModel.Syndication.Rss20ItemFormatter%601>|<xref:System.ServiceModel.Syndication.SyndicationItem> 派生クラスを RSS 2.0 形式にシリアル化するクラス。|  
+  
+ オブジェクト モデル クラス  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.ServiceModel.Syndication.SyndicationCategory>|配信フィードのカテゴリを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationContent>|配信コンテンツを表す基本クラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationElementExtension>|配信要素拡張を表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationElementExtensionCollection>|<xref:System.ServiceModel.Syndication.SyndicationElementExtension> オブジェクトのコレクション。|  
+|<xref:System.ServiceModel.Syndication.SyndicationFeed>|トップレベルのフィード オブジェクトを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationItem>|フィード項目を表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationLink>|配信フィードまたは項目内のリンクを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationPerson>|Atom Person コンストラクトを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.SyndicationVersions>|サポートされる配信プロトコルのバージョンを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.TextSyndicationContent>|エンド ユーザーに表示される任意の <xref:System.ServiceModel.Syndication.SyndicationItem> コンテンツを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.TextSyndicationContentKind>|テキスト配信コンテンツでサポートされる各種の型を表す列挙型。|  
+|<xref:System.ServiceModel.Syndication.UrlSyndicationContent>|別のリソースへの URL から構成される配信コンテンツを表すクラス。|  
+|<xref:System.ServiceModel.Syndication.XmlSyndicationContent>|ブラウザーに表示されない配信コンテンツを表すクラス。|  
+  
+ オブジェクト モデル内における抽象化コア データは Feed と Item であり、<xref:System.ServiceModel.Syndication.SyndicationFeed> クラスと <xref:System.ServiceModel.Syndication.SyndicationItem> クラスに対応します。  Feed は、フィード レベルのメタデータの一部 \(Title、Description、Author など\)、未知の拡張を格納する場所、およびフィードの情報コンテンツの残りの部分を作成する一連の項目を公開します。  Item では、項目レベルのメタデータの一部 \(Title、Summary、PublicationDate など\)、未知の拡張を格納する場所、および項目の情報コンテンツの残りの部分を含むコンテンツ要素を利用できます。  Feed と Item のコア抽象化は、Atom 1.0 および RSS の仕様で参照されている共通データ コンストラクトを表す追加のクラスによってサポートされています。  
+  
+ Feed インスタンスに含まれる情報は、各種の XML 形式に変換できます。  XML との間の双方向の変換処理は、<xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> クラスによって管理されます。  このクラスは抽象クラスであり、具体的な実装は Atom 1.0 および RSS 2.0 \(<xref:System.ServiceModel.Syndication.Atom10FeedFormatter> および <xref:System.ServiceModel.Syndication.Rss20FeedFormatter>\) で提供されます。  Feed の派生クラスを使用するには、派生した Feed クラスを特定できるように <xref:System.ServiceModel.Syndication.Atom10FeedFormatter%601> または <xref:System.ServiceModel.Syndication.Rss20FeedFormatter%601> のいずれかを使用します。  Item の派生クラスを使用するには、派生した Item クラスを特定できるように <xref:System.ServiceModel.Syndication.Atom10ItemFormatter%601> または <xref:System.ServiceModel.Syndication.Rss20ItemFormatter%601> のいずれかを使用します。各種の配信形式をサポートするために、サード パーティでは <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> の独自の実装を派生することができます。  
+  
+## 機能拡張  
+  
+-   配信プロトコルの主な機能は拡張性です。  Atom 1.0 と RSS 2.0 では、仕様で定義されていない属性および要素を配信フィードに追加できます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の配信プログラミング モデルには、カスタム属性と拡張機能を扱う方法として、新しいクラスの派生と弱い型指定のアクセスの 2 つの方法が用意されています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [配信の拡張](../../../../docs/framework/wcf/feature-details/syndication-extensibility.md).  
+  
+## 参照  
+ [WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)   
+ [WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法](../../../../docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md)   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/auditing-security-events.md b/docs/framework/wcf/feature-details/auditing-security-events.md
new file mode 100644
index 00000000000..c66863154f8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/auditing-security-events.md
@@ -0,0 +1,116 @@
+---
+title: "セキュリティ イベントの監査 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ イベントの監査 [WCF]"
+ms.assetid: 5633f61c-a3c9-40dd-8070-1c373b66a716
+caps.latest.revision: 27
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 27
+---
+# セキュリティ イベントの監査
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で作成されたアプリケーションでは、監査機能を使用してセキュリティ イベント \(成功、失敗、またはその両方\) をログに記録できます。これらのイベントは Windows システム イベント ログに書き込まれ、イベント ビューアーを使用して確認できます。  
+  
+ 監査を使用すると、管理者は既に発生した攻撃や現在進行中の攻撃を検出できます。また、開発者がセキュリティ関連の問題をデバッグする際にも役立ちます。たとえば、認証またはポリシー チェックの構成エラーによって承認済みユーザーへのアクセスが拒否された場合、開発者は、イベント ログを検査することによって、このエラーの原因をすばやく発見し、取り出すことができます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)」を参照してください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のプログラミング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+## 監査レベルと動作  
+ セキュリティ監査には次の 2 つのレベルがあります。  
+  
+-   呼び出し元を承認するサービス承認レベル。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がメッセージの有効性をチェックして呼び出し元を認証するメッセージ レベル。  
+  
+ どちらの監査レベルにおいても、監査の成功または失敗をチェックできます。これは *"監査動作"* と呼ばれます。  
+  
+## 監査ログの場所  
+ 監査のレベルと動作を決定したら、ユーザー \(または管理者\) は監査ログの場所を指定できます。監査ログの場所は、Default、Application、および Security の 3 つから選択できます。Default を指定した場合、ログの実際の場所は、ユーザーが使用しているシステムと、セキュリティ ログへの書き込みがサポートされているかどうかによって決まります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]このトピックの「オペレーティング システム」を参照してください。  
+  
+ セキュリティ ログへの書き込みを行うには、`SeAuditPrivilege` が必要です。既定では、この権限は Local System アカウントと Network Service アカウントだけに与えられています。セキュリティ ログの `read` および `delete` 機能を管理するには、`SeSecurityPrivilege` が必要です。既定では、この権限は管理者だけに与えられています。  
+  
+ これに対し、アプリケーション ログは認証済みユーザーが読み書きできます。既定では、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] は、監査イベントをアプリケーション ログに書き込みます。すべての認証済みユーザーに表示される個人情報をログに格納することもできます。  
+  
+## 監査エラーの抑制  
+ 監査中に監査エラーを表示しないように指定するオプションも用意されています。既定では、監査エラーはアプリケーションに影響を与えません。ただし、必要に応じて、このオプションを `false` に設定し、例外をスローすることもできます。  
+  
+## プログラミング監査  
+ 監査動作は、プログラムまたは構成を使用して指定できます。  
+  
+### 監査クラス  
+ 監査動作をプログラムで指定するときに使用するクラスとプロパティを次の表で説明します。  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>|サービス動作として監査を行うための設定オプションを有効にします。|  
+|<xref:System.ServiceModel.AuditLogLocation>|書き込み先のログを指定するための列挙体。指定できる値は、Default、Application、および Security です。Default を選択した場合、実際のログの場所はオペレーティング システムによって決定されます。このトピックの「アプリケーションまたはセキュリティ イベント ログの選択」のセクションを参照してください。|  
+|<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.MessageAuthenticationAuditLevel%2A>|メッセージ レベルで監査されるメッセージ認証イベントの種類を指定します。`None`、`Failure`、`Success` および `SuccessOrFailure` から選択できます。|  
+|<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.ServiceAuthorizationAuditLevel%2A>|サービス レベルで監査されるサービス承認イベントの種類を指定します。`None`、`Failure`、`Success` および `SuccessOrFailure` から選択できます。|  
+|<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure%2A>|監査が失敗した場合に、クライアント要求をどのように処理するかを指定します。たとえば、`SeAuditPrivilege` を持たないサービスがセキュリティ ログへの書き込みを試行したとします。この場合、既定値の `true` が設定されていると、エラーは無視され、クライアント要求は正常に処理されます。|  
+  
+ 監査イベントをログに記録するようにアプリケーションを設定する例については、「[方法 : セキュリティ イベントを監査する](../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)」を参照してください。  
+  
+### 構成  
+ [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)の下に [\<serviceSecurityAudit\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md)を追加すると、構成を使用して監査動作を指定できます。この要素は、次のコードに示すように、[\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)の下に指定する必要があります。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <behavior>  
+        <!— auditLogLocation="Application" or "Security" -—>  
+        <serviceSecurityAudit  
+                  auditLogLocation="Application"  
+                  suppressAuditFailure="true"  
+                  serviceAuthorizationAuditLevel="Failure"  
+                  messageAuthenticationAuditLevel="SuccessOrFailure" />   
+      </behavior>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ 監査が有効になっているが、`auditLogLocation` が指定されていない場合、セキュリティ ログへの書き込みをサポートしているプラットフォームでの既定のログ名は "セキュリティ" ログになります。それ以外の場合は、"アプリケーション" ログになります。 セキュリティ ログへの書き込みをサポートしているオペレーティング システムは [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wv](../../../../includes/wv-md.md)] だけです。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]このトピックの「オペレーティング システム」を参照してください。  
+  
+## セキュリティについての考慮事項  
+ 監査が有効になっていることが悪意のあるユーザーに知られた場合、そのユーザーは監査エントリの書き込みにつながる無効なメッセージを送信する可能性があります。このような方法で監査ログに書き込みが行われると、監査システムに障害が発生します。これを防ぐには、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure%2A> プロパティを `true` に設定し、イベント ビューアーのプロパティを使用して監査動作を制御します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]Windows XP のイベント ビューアーでイベント ログの表示と管理を行う方法については、マイクロソフト サポート オンラインの「[Windows XP のイベント ビューアーでイベント ログの表示と管理を行う方法](http://go.microsoft.com/fwlink/?LinkId=89150)」を参照してください。  
+  
+ [!INCLUDE[wxp](../../../../includes/wxp-md.md)] のアプリケーション ログに書き込まれた監査イベントは、すべての認証済みユーザーに表示されます。  
+  
+## アプリケーションまたはセキュリティ イベント ログの選択  
+ アプリケーション イベント ログとセキュリティ イベント ログのどちらにログを記録するかを選択するには、次の表の情報を参考にしてください。  
+  
+#### オペレーティング システム  
+  
+|システム|アプリケーション ログ|セキュリティ ログ|  
+|----------|-----------------|---------------|  
+|[!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] 以降|サポート状況|サポートなし|  
+|[!INCLUDE[ws2003sp1](../../../../includes/ws2003sp1-md.md)] および[!INCLUDE[wv](../../../../includes/wv-md.md)]|サポート状況|スレッド コンテキストが `SeAuditPrivilege` を持つ必要があります。|  
+  
+#### その他の要素  
+ オペレーティング システム以外に、ログ記録の使用可能性を制御する設定を次の表に示します。  
+  
+|要因|アプリケーション ログ|セキュリティ ログ|  
+|--------|-----------------|---------------|  
+|監査ポリシーの監査|該当しません。|セキュリティ ログは、構成だけでなく、ローカル セキュリティ機関 \(LSA: Local Security Authority\) ポリシーによっても制御されます。\[オブジェクト アクセスの監査\] カテゴリも有効にする必要があります。|  
+|既定のユーザー エクスペリエンス|すべての認証済みユーザーがアプリケーション ログに書き込むことができるため、アプリケーション プロセスでは追加のアクセス許可手順は必要ありません。|アプリケーション プロセス \(コンテキスト\) が `SeAuditPrivilege` を持つ必要があります。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>   
+ <xref:System.ServiceModel.AuditLogLocation>   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [方法 : セキュリティ イベントを監査する](../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)   
+ [\<serviceSecurityAudit\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md)   
+ [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/authentication-in-wcf.md b/docs/framework/wcf/feature-details/authentication-in-wcf.md
new file mode 100644
index 00000000000..0d41a1ee902
--- /dev/null
+++ b/docs/framework/wcf/feature-details/authentication-in-wcf.md
@@ -0,0 +1,49 @@
+---
+title: "WCF での認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "認証 [WCF]"
+  - "セキュリティ [WCF], 認証"
+ms.assetid: 9254d873-843d-4c6e-bea4-8184ac3e44f4
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# WCF での認証
+以下のトピックでは、Windows 認証、X.509 証明書、ユーザー名とパスワードなど、認証を提供する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のさまざまな機構を示します。  
+  
+## このセクションの内容  
+ [方法 : ASP.NET メンバーシップ プロバイダーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md)  
+ ASP.NET の機能には、メンバーシップとロール プロバイダー、認証のためのユーザー名とパスワードの組み合わせを格納するデータベース、および承認のためのユーザー ロールがあります。ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが同じデータベースを使用してユーザーの認証と承認を行うしくみについて説明します。  
+  
+ [方法 : カスタム ユーザー名およびパスワード検証を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-a-custom-user-name-and-password-validator.md)  
+ カスタム ユーザー名およびパスワード検証を統合する方法を示します。  
+  
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)  
+ 追加の保護手段として、クライアントは、サービスの予想される *ID* を指定することによってサービスを認証できます。予想される ID とサービスから返される ID が一致しない場合、認証は失敗します。  
+  
+ [セキュリティ ネゴシエーションとタイムアウト](../../../../docs/framework/wcf/feature-details/security-negotiation-and-timeouts.md)  
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings> クラスの <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.NegotiationTimeout%2A> プロパティの使用方法について説明します。  
+  
+ [Windows 認証エラーのデバッグ](../../../../docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md)  
+ Windows 認証の使用時に発生する一般的な問題について重点的に説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 関連項目  
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/authorization-in-wcf.md b/docs/framework/wcf/feature-details/authorization-in-wcf.md
new file mode 100644
index 00000000000..422d933cb9f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/authorization-in-wcf.md
@@ -0,0 +1,58 @@
+---
+title: "WCF での承認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "承認 [WCF]"
+  - "セキュリティ [WCF], 承認"
+ms.assetid: 8ea0b552-af65-45b0-a157-c6c111b8ce5e
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# WCF での承認
+承認は、サービスやファイルなどのリソースへのアクセスと権限を制御するプロセスです。このセクションの各トピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でこの基本タスクを実行するさまざまな方法について説明します。  
+  
+## このセクションの内容  
+ [アクセス制御機構](../../../../docs/framework/wcf/feature-details/access-control-mechanisms.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の承認機構の概要と推奨される使用方法について説明します。  
+  
+ [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute> を使用してサービスへのアクセスを制限するプロセスを示します。  
+  
+ [方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] のロール プロバイダー機能を使用できるようにサービスを構成する手順について説明します。  
+  
+ [方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] は、承認マネージャーを使って Web サイトの承認を管理できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、これとほぼ同じ方法でクライアントの承認に [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] と承認マネージャーの組み合わせを利用できます。  
+  
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)  
+ ID モデル インフラストラクチャをクレーム ベースの承認に使用する際の基本について説明します。  
+  
+ [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)  
+ 委任と偽装の違いについて説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Security>  
+  
+ <xref:System.ServiceModel.Description.PrincipalPermissionMode>  
+  
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>  
+  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>  
+  
+## 関連項目  
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md b/docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md
new file mode 100644
index 00000000000..f312d448cdf
--- /dev/null
+++ b/docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md
@@ -0,0 +1,94 @@
+---
+title: "トランザクションに含まれるメッセージのバッチ処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メッセージのバッチ処理 [WCF]"
+ms.assetid: 53305392-e82e-4e89-aedc-3efb6ebcd28c
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# トランザクションに含まれるメッセージのバッチ処理
+キューに置かれたアプリケーションは、トランザクションを使用してメッセージの正確性および信頼性のある配信を確保します。ただし、トランザクション操作には負荷がかかるため、メッセージのスループットが大幅に低下する可能性があります。メッセージ スループットを向上する方法の 1 つは、アプリケーションにより、単一のトランザクション内で複数のメッセージを読み取って処理することです。ただし、その場合、バッチ内のメッセージ数が増えるにつれて、トランザクションをロールバックしたときに必要な回復の作業量も増えるため、パフォーマンスと回復の間のトレードオフを考慮する必要があります。したがって、トランザクションでのメッセージのバッチ処理とセッションの違いに注目することが重要です。*セッション*は、単一のアプリケーションによって処理され、1 つの単位としてコミットされる関連メッセージのグループです。セッションは、一般に、関連メッセージのグループをまとめて処理する必要がある場合に使用されます。この例として、オンライン ショッピング Web サイトがあります。*"バッチ"* は、関連性のない複数のメッセージを、メッセージ スループットを向上できる方法で処理するために使用されます。セッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セッションでキューに置かれたメッセージのグループ化](../../../../docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md)」を参照してください。バッチ内のメッセージもまた、単一のアプリケーションによって処理され、1 つの単位としてコミットされますが、バッチ内のメッセージが関連している必要はありません。トランザクションでのメッセージのバッチ処理は、アプリケーションの実行方法を変更しない最適化です。  
+  
+## バッチ処理モードの開始  
+ バッチ処理は、<xref:System.ServiceModel.Description.TransactedBatchingBehavior> エンドポイント動作によって制御されます。このエンドポイント動作をサービス エンドポイントに追加すると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はメッセージをトランザクション内でバッチ処理するように指示されます。すべてのメッセージがトランザクションを必要とするわけではないので、バッチにはトランザクションを必要とするメッセージのみ、特に `TransactionScopeRequired` \= `true` および `TransactionAutoComplete` \= `true` とマークされている操作から送信されてきたメッセージのみを配置します。サービス コントラクトのすべての操作が `TransactionScopeRequired` \= `false` および `TransactionAutoComplete` \= `false` とマークされている場合、バッチ処理モードには入りません。  
+  
+## トランザクションのコミット  
+ バッチ トランザクションは、次の基準に基づいてコミットされます。  
+  
+-   `MaxBatchSize`.<xref:System.ServiceModel.Description.TransactedBatchingBehavior> 動作のプロパティ。このプロパティは、バッチに含められるメッセージの最大数を決定します。この数に達すると、バッチがコミットされます。この値は厳密に定められたものではないため、この数のメッセージを受信する前にバッチをコミットすることもできます。  
+  
+-   `Transaction Timeout`.トランザクションのタイムアウトの 80% が経過すると、バッチがコミットされ、新しいバッチが作成されます。つまり、トランザクションが完了するために指定された時間の残りが 20% 以下になると、バッチがコミットされます。  
+  
+-   `TransactionScopeRequired`.メッセージのバッチを処理しているときに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では `TransactionScopeRequired` \=`false` を持つメッセージが見つかると、バッチがコミットされ、`TransactionScopeRequired`\=`true` および `TransactionAutoComplete`\=`true` とマークされた最初のメッセージを受信したときに新しいバッチが再度開かれます。  
+  
+-   キューのメッセージがなくなると、`MaxBatchSize` に達していない場合やトランザクションのタイムアウトの 80% が経過していない場合でも、現在のバッチがコミットされます。  
+  
+## バッチ処理モードの終了  
+ バッチ内のメッセージによってトランザクションが中止されたときの動作は、次のとおりです。  
+  
+1.  メッセージのバッチ全体がロールバックされます。  
+  
+2.  読み取られたメッセージの数がバッチの最大サイズの 2 倍を超えるまで、一度に 1 つのメッセージが読み取られます。  
+  
+3.  再度、バッチ モードに入ります。  
+  
+## バッチ サイズの選択  
+ バッチのサイズは、アプリケーションに依存します。アプリケーションに最適なバッチ サイズは、経験に基づいて決定するのが最良の方法です。バッチ サイズを選択する際には、アプリケーションの実際の展開モデルに応じたサイズを選択することが重要です。たとえば、アプリケーションの展開で、リモート コンピューターに SQL サーバーを配置し、キューとその SQL サーバーにまたがるトランザクションを実行する必要がある場合は、そのとおりの構成を実行してバッチ サイズを決定するのが最良の方法です。  
+  
+## 同時実行とバッチ処理  
+ スループットを向上させるために、多数のバッチを同時に実行することもできます。同時バッチ処理を有効にするには、`ServiceBehaviorAttribute` の `ConcurrencyMode.Multiple` を設定します。  
+  
+ *サービス調整*は、サービスで実行できる同時呼び出しの最大数を示すために使用されるサービス動作です。この動作をバッチ処理で使用すると、実行できる同時バッチの数と解釈されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービス調整が設定されていない場合、同時呼び出しの最大数は既定で 16 になります。したがって、バッチ動作が既定で追加されると、最大で 16 個のバッチが同時にアクティブになります。容量に基づいてサービス調整とバッチ処理を調整することをお勧めします。たとえば、キューに 100 個のメッセージがあり、20 個のメッセージを含むバッチを実行する必要がある場合、同時呼び出しの最大数を 16 に設定しても実用的ではありません。それは、スループットによっては、バッチ処理をオンにしていない場合と同様に、16 個のトランザクションがアクティブになる可能性があるからです。したがって、パフォーマンスを微調整するためには、同時バッチ処理を設定しないか、正しいサービス調整のサイズで同時バッチ処理を設定します。  
+  
+## バッチ処理と複数のエンドポイント  
+ エンドポイントは、アドレスとコントラクトで構成されます。同じバインディングを共有するエンドポイントが複数ある場合があります。2 つのエンドポイントが同じバインディングと、リッスン URI \(Uniform Resource Identifier\) つまりキュー アドレスを共有することもできます。2 つのエンドポイントが同じキューから読み取りを行っている場合、トランザクション バッチ動作を両方のエンドポイントに追加すると、指定したバッチ サイズ間で競合が発生する可能性があります。この問題を解決するには、2 つのトランザクション バッチ動作の間に指定される最小バッチ サイズを使用してバッチを実装します。このシナリオでは、どちらかのエンドポイントがトランザクション バッチを指定していない場合、両方のエンドポイントがバッチ処理を使用しません。  
+  
+## 例  
+ 構成ファイルで `TransactedBatchingBehavior` を指定する方法を次の例に示します。  
+  
+```  
+<behaviors>  
+      <endpointBehaviors>  
+        <behavior name="TransactedBatchingBehavior"  
+                  maxBatchSize="100"/>  
+      </endpointBehaviors>  
+    </behaviors>  
+```  
+  
+ コードで <xref:System.ServiceModel.Description.TransactedBatchingBehavior> を指定する方法を次の例に示します。  
+  
+```  
+using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))  
+{  
+     ServiceEndpoint sep = ServiceHost.AddServiceEndpoint(typeof(IOrderProcessor), new NetMsmqBinding(), "net.msmq://localhost/private/ServiceModelSamplesTransacted");  
+                sep.Behaviors.Add(new TransactedBatchingBehavior(100));  
+  
+     // Open the ServiceHost to create listeners and start listening for messages.  
+    serviceHost.Open();  
+  
+    // The service can now be accessed.  
+    Console.WriteLine("The service is ready.");  
+    Console.WriteLine("Press <ENTER> to terminate service.");  
+    Console.WriteLine();  
+    Console.ReadLine();  
+  
+   // Close the ServiceHostB to shut down the service.  
+    serviceHost.Close();  
+}  
+```  
+  
+## 参照  
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)   
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/best-practices-for-queued-communication.md b/docs/framework/wcf/feature-details/best-practices-for-queued-communication.md
new file mode 100644
index 00000000000..c9f58b4703b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/best-practices-for-queued-communication.md
@@ -0,0 +1,102 @@
+---
+title: "キューに置かれた通信のベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ベスト プラクティス [WCF], キューに置かれた通信"
+  - "キュー [WCF], ベスト プラクティス"
+ms.assetid: 446a6383-cae3-4338-b193-a33c14a49948
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# キューに置かれた通信のベスト プラクティス
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のキューに置かれた通信で推奨されるベスト プラクティスについて説明します。以下の各セクションでは、シナリオの観点から推奨されるベスト プラクティスについて説明します。  
+  
+## キューに置かれたベストエフォート方式の高速メッセージング  
+ キューに置かれたメッセージングによってもたらされる分離と、ベストエフォート保証による高パフォーマンスの高速メッセージングを必要とするシナリオでは、非トランザクション キューを使用し、<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> プロパティを `false` に設定します。  
+  
+ また、<xref:System.ServiceModel.MsmqBindingBase.Durable%2A> プロパティを `false` に設定して、ディスク書き込みの負荷がかからないようにすることもできます。  
+  
+ セキュリティは、パフォーマンスに影響を及ぼします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][パフォーマンスに関する考慮事項](../../../../docs/framework/wcf/feature-details/performance-considerations.md).  
+  
+## キューに置かれた信頼性のあるエンド ツー エンドのメッセージング  
+ 以下のセクションでは、エンド ツー エンドで信頼できるメッセージングが必要なシナリオで推奨されるベスト プラクティスについて説明します。  
+  
+### 基本的で信頼できる転送  
+ エンド ツー エンドの信頼性を実現するには、<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> プロパティを `true` に設定して、確実に転送できるようにします。<xref:System.ServiceModel.MsmqBindingBase.Durable%2A> プロパティは、要件に応じて `true` に設定することも、`false` に設定することもできます \(既定値は `true` です\)。通常、エンド ツー エンドの信頼性の一環として、<xref:System.ServiceModel.MsmqBindingBase.Durable%2A> プロパティは `true` に設定されています。これはパフォーマンス コストに影響しますが、これによりメッセージが永続的になるため、キュー マネージャーがクラッシュした場合でもメッセージが失われなくなります。  
+  
+### トランザクションの使用  
+ エンド ツー エンドの信頼性を確保するには、トランザクションを使用する必要があります。`ExactlyOnce` の保証によって保証されるのは、メッセージがターゲット キューに配信されることだけです。メッセージを確実に受信するには、トランザクションを使用します。トランザクションを使用しないと、サービスがクラッシュした場合に、配信中であるが、実際にはアプリケーションに配信されるメッセージは失われます。  
+  
+### 配信不能キューの使用  
+ 配信不能キューを使用すると、メッセージがターゲット キューに配信されなかった場合に、必ず通知されます。システム指定の配信不能キューまたはカスタムの配信不能キューを使用できます。アプリケーションごとに専用の配信不能キューに配信不能メッセージを送信できるため、一般にカスタムの配信不能キューを使用することをお勧めします。カスタムの配信不能キューを使用しない場合は、システムで実行されているすべてのアプリケーションで発生するすべての配信不能メッセージが 1 つのキューに配信されます。この場合、各アプリケーションは配信不能キュー全体を検索して、それぞれのアプリケーションに関連する配信不能メッセージを見つける必要があります。MSMQ 3.0 を使用する場合など、カスタムの配信不能キューを使用できないこともあります。  
+  
+ エンド ツー エンドの信頼性が必要な通信では、配信不能キューを無効にすることはお勧めしません。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [配信不能キューを使用したメッセージ転送エラー処理](../../../../docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md).  
+  
+### 有害メッセージ処理の使用  
+ 有害メッセージ処理は、メッセージ処理のエラーから回復する機能を提供します。  
+  
+ 有害メッセージ処理機能を使用する場合は、<xref:System.ServiceModel.MsmqBindingBase.ReceiveErrorHandling%2A> プロパティが適切な値に設定されていることを確認します。このプロパティを <xref:System.ServiceModel.ReceiveErrorHandling> に設定すると、データが失われることになります。一方、<xref:System.ServiceModel.ReceiveErrorHandling> に設定すると、有害メッセージが検出されたときにサービス ホストでエラーが発生します。MSMQ 3.0 を使用する場合、データの損失を防ぎ、有害メッセージを取り除くための最適なオプションは <xref:System.ServiceModel.ReceiveErrorHandling> です。MSMQ 4.0 を使用する場合は、<xref:System.ServiceModel.ReceiveErrorHandling> が推奨されます。<xref:System.ServiceModel.ReceiveErrorHandling> に設定すると有害メッセージがキューから取り除かれるため、サービスは新しいメッセージの処理を続行できます。有害メッセージ サービスは、取り除かれた有害メッセージを別個に処理できます。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md).  
+  
+## 高スループットの実現  
+ 単一のエンドポイントで高スループットを実現するには、以下を使用します。  
+  
+-   トランザクション バッチ。トランザクション バッチでは、1 回のトランザクションで多くのメッセージを読み取ることができます。これにより、トランザクションのコミットが最適化され、全体的なパフォーマンスが向上します。バッチ処理の難点は、バッチ内の 1 つのメッセージでエラーが発生した場合に、バッチ全体をロールバックし、再び安全にバッチ処理できるようになるまで、メッセージを 1 つずつ処理する必要があることです。ほとんどの場合、有害メッセージはまれであるため、特にトランザクションに他のリソース マネージャーが参加している場合は、バッチ処理がシステム パフォーマンスを向上させる方法として推奨されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][トランザクションに含まれるメッセージのバッチ処理](../../../../docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md).  
+  
+-   同時実行。同時実行によりスループットが向上します。ただし、同時実行は共有リソースの競合に影響します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][同時実行](../../../../docs/framework/wcf/samples/concurrency.md).  
+  
+-   調整。最適なパフォーマンスを実現するために、ディスパッチャー パイプラインのメッセージの数を調整します。この調整を行う方法の例については、「[調整](../../../../docs/framework/wcf/samples/throttling.md)」を参照してください。  
+  
+ バッチ処理を使用する場合は、同時実行と調整は同時バッチに変換されることに気をつけてください。  
+  
+ スループットと可用性を高めるには、キューから読み取る [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのファームを使用します。この場合、ファームのすべてのサービスが同じエンドポイントで同じコントラクトを公開している必要があります。ファームを使用すると、多数のサービスがすべて同じキューから読み取ることができるため、この方法はメッセージの生成率が高いアプリケーションで最も効果を発揮します。  
+  
+ ファームを使用する場合、MSMQ 3.0 ではリモート トランザクション読み取りがサポートされていないので注意してください。MSMQ 4.0 は、リモート トランザクション読み取りをサポートしています。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[トランザクションに含まれるメッセージのバッチ処理](../../../../docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md)」および「[Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](../../../../docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md)」を参照してください。  
+  
+## 作業単位のセマンティクスによるキュー処理  
+ キューにある一連のメッセージが関連している可能性があるため、これらのメッセージの順序付けが重要となるシナリオがあります。このようなシナリオでは、関連するメッセージのグループを 1 つの単位としてまとめて処理します。つまり、すべてのメッセージが正常に処理されるか、どのメッセージも処理されないかのいずれかになります。このような動作を実装するには、キューでセッションを使用します。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [セッションでキューに置かれたメッセージのグループ化](../../../../docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md).  
+  
+## 要求\/応答メッセージの関連付け  
+ 通常、キューは一方向ですが、シナリオによっては、受信した応答を以前に送信した要求に関連付けることが必要になる場合があります。このような関連付けが必要な場合、関連付け情報を含む独自の SOAP メッセージ ヘッダーをメッセージに追加することをお勧めします。通常、送信側がこのヘッダーをメッセージに添付すると、受信側は、このメッセージを処理して応答キューにある新しいメッセージで応答するときに、関連付け情報を含む送信側のメッセージ ヘッダーを添付します。これにより、送信側は要求メッセージを使用して応答メッセージを識別できます。  
+  
+## 非 WCF アプリケーションとの統合  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたはクライアントを非 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたはクライアントと統合するときには、`MsmqIntegrationBinding` を使用します。非 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションには、System.Messaging、COM\+、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]、または C\+\+ を使用して作成された MSMQ アプリケーションなどがあります。  
+  
+ `MsmqIntegrationBinding` を使用するときは、以下の点に注意してください。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージの本文は、MSMQ メッセージの本文と同じではありません。キューに置かれたバインディングを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージを送信する場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージの本文が MSMQ メッセージの内部に配置されます。MSMQ インフラストラクチャは、この追加情報を認識しません。認識するのは、MSMQ メッセージだけです。  
+  
+-   `MsmqIntegrationBinding` では、よく使用されるシリアル化型をサポートしています。ジェネリック メッセージである <xref:System.ServiceModel.MsmqIntegration.MsmqMessage%601> の本文の型は、シリアル化型に基づいてさまざまな型パラメーターを受け取ります。たとえば、<xref:System.ServiceModel.MsmqIntegration.MsmqMessageSerializationFormat> には `MsmqMessage\<byte[]>` が必要であり、<xref:System.ServiceModel.MsmqIntegration.MsmqMessageSerializationFormat> には `MsmqMessage<Stream>` が必要です。  
+  
+-   XML シリアル化では、[\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md) 要素の `KnownTypes` 属性を使用して既知の型を指定できます。この型は、後で XML メッセージを逆シリアル化する方法を確認する際に使用されます。  
+  
+## 参照  
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)   
+ [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)   
+ [セッションでキューに置かれたメッセージのグループ化](../../../../docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md)   
+ [トランザクションに含まれるメッセージのバッチ処理](../../../../docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md)   
+ [配信不能キューを使用したメッセージ転送エラー処理](../../../../docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md)   
+ [有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)   
+ [Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](../../../../docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md)   
+ [トランスポート セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-transport-security.md)   
+ [メッセージ セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-message-security.md)   
+ [キューに置かれたメッセージングのトラブルシューティング](../../../../docs/framework/wcf/feature-details/troubleshooting-queued-messaging.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/best-practices-for-reliable-sessions.md b/docs/framework/wcf/feature-details/best-practices-for-reliable-sessions.md
new file mode 100644
index 00000000000..81bdc774c6a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/best-practices-for-reliable-sessions.md
@@ -0,0 +1,82 @@
+---
+title: "信頼できるセッションのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b94f6e01-8070-40b6-aac7-a2cb7b4cb4f2
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 信頼できるセッションのベスト プラクティス
+ここでは、信頼できるセッションに関するベスト プラクティスをいくつか紹介します。  
+  
+## MaxTransferWindowSize の設定  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の信頼できるセッションでは、転送ウィンドウを使用して、クライアント側およびサービス側のメッセージを保持しています。  <xref:System.ServiceModel.Channels.ReliableSessionBindingElement.MaxTransferWindowSize%2A> プロパティは、この転送ウィンドウに保持できるメッセージの最大数を表します。  
+  
+ 送信側については、送信後に受信確認の到着を待機しているメッセージ、受信側についてはサービスの処理待ちメッセージを、それぞれいくつまで保持しておけるかを表します。  
+  
+ この値がネットワークやサービスの処理効率にも影響します。  以下では、このプロパティの値を決める上で検討する事項と、その値が与える影響について解説します。  
+  
+ 転送ウィンドウ サイズの既定メッセージ数は 8 です。  
+  
+### ネットワークの利用効率  
+ ここでいう*ネットワーク*は、クライアント \(送信側\) とサービス \(受信側\) が通信基盤として使用するものすべてを指します。  したがって、伝送路だけでなく、その間に介在する SOAP ルーターや HTTP プロキシ\/ファイアウォールなども含まれます。  
+  
+ ネットワーク効率が高いとは、その伝送容量を最大限に活用できるということです。  1 秒間に伝送できるデータ量 *\(データ レート\)*、送信側から受信側にデータが届くまでにかかる時間 *\(遅延\)* のどちらもが、ネットワーク効率に関係します。  
+  
+ 送信側については、転送ウィンドウに保持できる受信確認の到着を待機しているメッセージの数が <xref:System.ServiceModel.Channels.ReliableSessionBindingElement.MaxTransferWindowSize%2A> プロパティによって表されます。  つまり、遅延が大きいネットワークほど、応答性を高めてネットワーク利用効率を上げるために、転送ウィンドウ サイズを増やす必要があります。  
+  
+ 送信側で高いデータ レートを維持していても、受信側に到達するまでにいくつもの中継装置 \(ルーターなど\) が介在していたり、データ消失が発生したりすると、遅延は大きくなります。  したがって、送出したメッセージは、受信確認が届くまで長い時間転送ウィンドウに保持しておかなければならず、これが上限に達すると次のメッセージを送出できません。  このように、遅延が大きいのに転送ウィンドウ サイズが小さいと、ネットワーク効率が損なわれてしまいます。  一方、これが大き過ぎると、受信側には次々にメッセージが届くため、サービスの処理効率に悪影響を与える可能性があります。  
+  
+### サービスの可用性向上  
+ ネットワーク効率が最適であれば、サービスも処理能力を最大限に活用して稼働させるのが理想的です。  受信側の転送ウィンドウ サイズは、処理待ちのメッセージをいくつまで保持しておけるかを表します。  メッセージをこのようにバッファーに保持することは、ネットワークのフロー制御だけでなく、処理能力を最大限に活用したサービス稼働にも役立ちます。  たとえば、バッファーに保持できるメッセージ数が 1 だとすると、サービスが処理できる以上の頻度でメッセージが届く場合、メッセージがネットワークによって廃棄されるほか、ネットワークの処理能力が無駄に消費され、十分に活用されないおそれがあります。  
+  
+ バッファーを使用すると、同時に複数のメッセージを受信し、前のメッセージが処理中であればそのまま保持しておくことができるので、サービスの可用性が向上します。  
+  
+ `MaxTransferWindowSize` の値は、送信側と受信側で同じにしておくことをお勧めします。  
+  
+### フロー制御の有効化  
+ フロー制御とは、送信側と受信側とが歩調を揃えるための機構です。このしくみにより、メッセージが生成される速度で、メッセージの受け入れと処理が行われます。  クライアントとサービスの転送ウィンドウ サイズは、送信側と受信側が妥当な許容範囲内で同期できるように設定しなければなりません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの間で信頼できるセッションを使用する場合、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement.FlowControlEnabled%2A> プロパティを true に設定することを強くお勧めします。  
+  
+## MaxPendingChannels の設定  
+ 通信セッションを開く相手 \(クライアント\) が可変であるように設計されたサービスは、同時にいくつものクライアントと信頼できるセッションを確立することができます。  このとき、サービスの応答性は、`MaxPendingChannels` プロパティによって決まります。  
+  
+ 信頼できるセッション チャネルが送信側によって作成されると、両者のハンドシェイクによって信頼できるセッションが確立します。  これが終わるとチャネルは保留チャネル キューに入り、サービス側からの応答を待機する状態になります。  `MaxPendingChannels` プロパティは、この状態にできるチャネルの数を表します。  
+  
+ 次々にセッションを確立していくと、サービス側は、これ以上新しいチャネルを使用してセッションを確立することができない状態になります。  キューがいっぱいになると、信頼できるセッションを確立しようとしても拒否されるので、クライアント側はしばらく待って再試行するしかありません。  
+  
+ また、いったんキューに入った保留チャネルは、そのまま長期間留まる可能性があります。  そうしているうちに、信頼できるセッションが稼働していないとしてタイムアウトとなり、チャネルは "失敗" という状態に遷移します。  
+  
+ したがって、複数のクライアントに対して同時にサービスを提供するサービスの設計においては、この値を適切に決めることが重要です。  `MaxPendingChannels` プロパティの値が大き過ぎるとワーキング セットにも悪影響が現れます。  
+  
+ <xref:System.ServiceModel.Channels.ReliableSessionBindingElement.MaxPendingChannels%2A> の既定値は 4 です。  
+  
+## 信頼できるセッションとホスティング  
+ 信頼できるセッションを使用するサービスを Web ホスティングする場合は、次のことを念頭に置く必要があります。  
+  
+-   信頼できるセッションはステートフルであり、状態は AppDomain で管理されます。  したがって、信頼できるセッションでやりとりするメッセージはすべて、同じ AppDomain で処理する必要があります。  Web ファームや Web ガーデンで、ファームやガーデンのサイズが 1 より大きいと、この制約への準拠が保証されません。  
+  
+-   信頼できるセッションで双方向 HTTP チャネル \(`WsDualHttpBinding` など\) が使用される場合、クライアントあたりの HTTP 接続数が、既定値である 2 では足りなくなる可能性があります。  双方向の信頼できるセッションでは、アプリケーション メッセージとプロトコル メッセージが同時に双方向で伝送されることがあり、その場合、一方向につき最大 2 つの接続が必要になるからです。  したがって、特定の条件下で、サービスのメッセージ交換パターンによっては、双方向 HTTP と信頼できるセッションを使用した Web ホスト サービスが、デッドロックを起こす可能性があります。  クライアントあたりの利用可能な HTTP 接続数を増やすには、適切な設定ファイル \(当該サービスの web.config など\) に、次のような記述を追加してください。  
+  
+```  
+<configuration>  
+   <system.net>  
+      <connectionManagement>  
+         <add name = "*" maxconnection = "XX" />  
+      </connectionManagement>  
+   </system.net>  
+</configuration>  
+```  
+  
+ "XX" は必要な接続数を表します。  この場合、最小値は 4 になります。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md b/docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md
new file mode 100644
index 00000000000..be9d58268ac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md
@@ -0,0 +1,68 @@
+---
+title: "WCF のセキュリティのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ベスト プラクティス [WCF], セキュリティ"
+ms.assetid: 3639de41-1fa7-4875-a1d7-f393e4c8bd69
+caps.latest.revision: 19
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 19
+---
+# WCF のセキュリティのベスト プラクティス
+以下のセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用してセキュリティで保護されたアプリケーションを作成する場合に考慮する必要のあるベスト プラクティスを示します。セキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)」、「[セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」、および「[メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)」を参照してください。  
+  
+## Windows 認証での SPN を使用したサービスの識別  
+ サービスはユーザー プリンシパル名 \(UPN\) またはサービス プリンシパル名 \(SPN\) によって識別できます。ネットワーク サービスのようにコンピューター アカウントを使用して実行するサービスには、サービスが実行されるコンピューターに対応する SPN ID があります。ユーザー アカウントを使用して実行するサービスには、そのユーザーに対応する UPN ID があります。ただし、`setspn` ツールを使用するとユーザー アカウントに SPN 割り当てることができます。サービスが SPN によって識別されるように構成し、サービスに接続するクライアントが SPN を使用してサービスに接続するように構成すると、攻撃の種類によっては攻撃が困難になります。このガイダンスは Kerberos または SSPI ネゴシエーションを使用するバインディングに適用されます。その場合でも、SSPI が使用できなくて NTLM が使用される場合に備えて、クライアントは SPN を指定する必要があります。  
+  
+## WSDL でのサービス ID の検証  
+ WS\-SecurityPolicy ではサービスが自己の ID に関する情報をメタデータの中で公開できるようになっています。この ID 情報は `svcutil` で取得した場合や <xref:System.ServiceModel.Description.WsdlImporter> などその他の方法で取得した場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス エンドポイント アドレスの ID プロパティに変換されます。サービス ID が正しく有効であることを検証しないクライアントは、実質上サービス認証をバイパスすることになります。悪意を持ったサービスは、資格情報の転送やその他の "man in the middle" 攻撃を実行するために、その WSDL での ID 宣言を変更することによって、このようなクライアントを利用できます。  
+  
+## NTLM の代わりに X509 証明書を使用する  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ピアツーピア認証用に X509 証明書 \(ピア チャネルで使用\) と SSPI ネゴシエーションが Kerberos から NTLM にダウングレードされたときに使用される Windows 認証の 2 つのメカニズムが提供されています。1024 ビット以上のキー サイズを使用する証明書ベースの認証が NTLM より好ましい理由はいくつかあります。  
+  
+-   相互認証が可能  
+  
+-   暗号化アルゴリズムの強化  
+  
+-   転送された X509 資格情報の利用が難しくなる  
+  
+ NTLM 転送攻撃の概要については、[http:\/\/msdn.microsoft.com\/msdnmag\/issues\/06\/09\/SecureByDesign\/default.aspx](http://go.microsoft.com/fwlink/?LinkId=109571) を参照してください。  
+  
+## 偽装後は必ず元に戻す  
+ クライアントの偽装を有効にする API を使用した後は、必ず元の ID に戻してください。たとえば、<xref:System.Security.Principal.WindowsIdentity> および <xref:System.Security.Principal.WindowsImpersonationContext> を使用する場合は、次のコードに示すように、C\# の `using` ステートメントまたは [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の `Using` ステートメントを使用します。<xref:System.Security.Principal.WindowsImpersonationContext> クラスは <xref:System.IDisposable> インターフェイスを実装しているため、コードが `using` ブロックを抜けると共通言語ランタイム \(CLR: Common Language Runtime\) は自動的に元の ID に戻ります。  
+  
+ [!code-csharp[c_SecurityBestPractices#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securitybestpractices/cs/source.cs#1)]
+ [!code-vb[c_SecurityBestPractices#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securitybestpractices/vb/source.vb#1)]  
+  
+## 必要な場合のみ偽装を行う  
+ <xref:System.Security.Principal.WindowsIdentity> クラスの <xref:System.Security.Principal.WindowsIdentity.Impersonate%2A> メソッドを使用すると、非常に限られたスコープでしか偽装を使用できなくなります。これは、操作全体のスコープで偽装が許可される <xref:System.ServiceModel.OperationBehaviorAttribute> の <xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> プロパティとは対照的です。可能な限り、<xref:System.Security.Principal.WindowsIdentity.Impersonate%2A> メソッドを使用して偽装のスコープをより厳密に制御します。  
+  
+## 信頼されたソースからメタデータを取得する  
+ メタデータのソースが信頼できることと、メタデータが改ざんされていないことを確認します。HTTP プロトコルを使用して取得したメタデータはクリア テキストで送信されるため、改ざんされる可能性があります。サービスが <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A> および <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetUrl%2A> プロパティを使用している場合は、サービス作成者によって提供された URL を使用して HTTPS プロトコルを介してデータをダウンロードします。  
+  
+## セキュリティを使用してメタデータを公開する  
+ サービスが公開したメタデータの改ざんを防ぐには、トランスポート レベルまたはメッセージ レベルのセキュリティを使用して、メタデータ交換エンドポイントをセキュリティで保護します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[メタデータ エンドポイントを公開する](../../../../docs/framework/wcf/publishing-metadata-endpoints.md)」および「[方法 : コードを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)」を参照してください。  
+  
+## ローカル発行者の使用を確認する  
+ 特定のバインディングに対して発行者アドレスとバインディングが指定されている場合、ローカル発行者はこのバインディングを使用するエンドポイントには使用されません。ローカル発行者を常に使用する必要があるクライアントには、このようなバインディングが使用されることがないか、または発行者アドレスが null となるようにクライアントによってバインディングが変更されることが保証されている必要があります。  
+  
+## SAML トークン サイズのクォータ  
+ セキュリティ トークン サービス \(STS: Security Token Service\) によって SAML \(Security Assertions Markup Language\) トークンが発行されたとき、またはクライアントが認証の一部としてこれをサービスに提示したときに、SAML トークンがメッセージ内にシリアル化される場合は、メッセージの最大クォータ サイズが、SAML トークンおよびメッセージの他の部分を格納できるだけの大きさである必要があります。通常は、既定のメッセージ クォータ サイズで十分です。ただし、数百のクレームを含んでいるために SAML トークンのサイズが大きい場合には、シリアル化されたトークンを格納できるように、クォータを増やす必要があります。クォータ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」を参照してください。  
+  
+## カスタム バインディングで SecurityBindingElement.IncludeTimestamp を true に設定する  
+ カスタム バインディングを作成するときは、<xref:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp%2A> を `true` に設定する必要があります。<xref:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp%2A> が `false` に設定されている場合に、クライアントが、X509 証明書などの非対称キーに基づくトークンを使用すると、メッセージは署名されません。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)   
+ [メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/bindings-and-security.md b/docs/framework/wcf/feature-details/bindings-and-security.md
new file mode 100644
index 00000000000..69c5c0d55d9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/bindings-and-security.md
@@ -0,0 +1,239 @@
+---
+title: "バインディングとセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング [WCF]"
+  - "バインディング [WCF], セキュリティ"
+  - "WCF セキュリティ"
+  - "Windows Communication Foundation, セキュリティ"
+ms.assetid: 4de03dd3-968a-4e65-af43-516e903d7f95
+caps.latest.revision: 42
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 42
+---
+# バインディングとセキュリティ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に用意されたシステム指定のバインディングを使用すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションをすばやくプログラミングできます。1 つの例外を除き、すべてのバインディングにはセキュリティ スキームが含まれており、既定で有効になっています。ここでは、セキュリティ ニーズに適した正しいバインディングの選択方法について説明します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティの概要については、「[セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)」を参照してください。バインディングを使用した [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のプログラミング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)」を参照してください。  
+  
+ バインディングを既に選択している場合、セキュリティに関連する実行時の動作の詳細については、「[セキュリティ動作](../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)」を参照してください。  
+  
+ セキュリティ機能のなかには、システム指定のバインディングを使用してプログラミングできないものがあります。カスタム バインディングを使用したより細かな制御については、「[カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)」を参照してください。  
+  
+## バインディングのセキュリティ機能  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、ほとんどのニーズを満たすシステム指定のバインディングが多数用意されています。特定のバインディングでは不十分な場合は、カスタム バインディングを作成することもできます。システム指定のバインディングの一覧については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。カスタム バインディング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のすべてのバインディングには、API としての形式と、構成ファイルで使用する XML 要素としての形式という 2 つの形式があります。たとえば、`WSHttpBinding` \(API\) に対応する要素は [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)です。  
+  
+ 以下のセクションでは、各バインディングについて両方の形式を示し、セキュリティ機能の概要を説明します。  
+  
+### BasicHttp  
+ コードでは <xref:System.ServiceModel.BasicHttpBinding> クラスを使用し、構成では [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)を使用します。  
+  
+ このバインディングは、次のような既存のさまざまなテクノロジと共に使用できるようにデザインされています。  
+  
+-   ASP.NET Web サービス \(ASMX\) Version 1  
+  
+-   Web サービス拡張 \(WSE\) アプリケーション  
+  
+-   WS\-I \(Web Services Interoperability\) 仕様 \([http:\/\/go.microsoft.com\/fwlink\/?LinkId\=38955](http://go.microsoft.com/fwlink/?LinkId=38955)\) で定義されている基本プロファイル  
+  
+-   WS\-I で定義されている基本セキュリティ プロファイル  
+  
+ 既定では、このバインディングはセキュリティで保護されません。ASMX サービスと相互運用するように設計されています。セキュリティを有効にした場合、このバインディングは、インターネット インフォメーション サービス \(IIS: Internet Information Services\) のセキュリティ機構 \(基本認証、ダイジェスト、Windows 統合セキュリティなど\) とシームレスに相互運用できるように設計されています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md).このバインディングでは、以下をサポートしています。  
+  
+-   HTTPS トランスポート セキュリティ  
+  
+-   HTTP 基本認証  
+  
+-   WS\-Security。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.BasicHttpSecurity>、<xref:System.ServiceModel.BasicHttpMessageSecurity>、<xref:System.ServiceModel.BasicHttpMessageCredentialType>、および <xref:System.ServiceModel.BasicHttpSecurityMode>。  
+  
+### WSHttpBinding  
+ コードでは <xref:System.ServiceModel.WSHttpBinding> クラスを使用し、構成では [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を使用します。  
+  
+ 既定では、このバインディングは WS\-Security 仕様を実装しており、WS\-\* 仕様を実装するサービスとの相互運用性があります。次のセキュリティをサポートします。  
+  
+-   HTTPS トランスポート セキュリティ。  
+  
+-   WS\-Security。  
+  
+-   SOAP メッセージ資格情報セキュリティを使用した、HTTPS トランスポート保護による呼び出し元の認証。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.WSHttpSecurity>、<xref:System.ServiceModel.MessageSecurityOverHttp>、<xref:System.ServiceModel.MessageCredentialType>、<xref:System.ServiceModel.SecurityMode>、<xref:System.ServiceModel.HttpTransportSecurity>、<xref:System.ServiceModel.HttpClientCredentialType>、および <xref:System.ServiceModel.HttpProxyCredentialType>。  
+  
+### WSDualHttpBinding  
+ コードでは <xref:System.ServiceModel.WSDualHttpBinding> クラスを使用し、構成では [\<wsDualHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)を使用します。  
+  
+ このバインディングは、双方向サービス アプリケーションを有効にするために設計されています。このバインディングは、メッセージ ベースの転送セキュリティ用に WS\-Security 仕様を実装しています。トランスポート セキュリティは使用できません。既定では、次の機能を提供します。  
+  
+-   WS\-ReliableMessaging を実装して信頼性を確保します。  
+  
+-   WS\-Security を実装して転送セキュリティおよび認証を実現します。  
+  
+-   HTTP を使用してメッセージを配信します。  
+  
+-   テキスト\/XML メッセージ エンコーディングを使用します。  
+  
+ バインディングで WS\-Security \(メッセージ層セキュリティ\) を使用すると、次のパラメーターを構成できるようになります。  
+  
+-   暗号アルゴリズムを決定するためのセキュリティ アルゴリズム スイート  
+  
+-   以下を行うためのバインディング オプション  
+  
+    -   クライアントで帯域外で使用可能なサービス資格情報の提供  
+  
+    -   チャネル セットアップの一部としてサービスからネゴシエートされるサービス資格情報の提供  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「<xref:System.ServiceModel.WSDualHttpSecurity>」および「<xref:System.ServiceModel.WSDualHttpSecurityMode>」を参照してください。  
+  
+### NetTcpBinding  
+ コードでは <xref:System.ServiceModel.NetTcpBinding> クラスを使用し、構成では [\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)を使用します。  
+  
+ このバインディングは複数のコンピューター間での通信に最適化されています。既定では、次の特性があります。  
+  
+-   トランスポート層セキュリティを実装します。  
+  
+-   Windows セキュリティを利用して、転送セキュリティと認証を確保します。  
+  
+-   トランスポートに TCP を使用します。  
+  
+-   バイナリ メッセージのエンコードを実装します。  
+  
+-   WS\-ReliableMessaging を実装します。  
+  
+ 選択できる方法は次のとおりです。  
+  
+-   メッセージ層セキュリティ \(WS\-Security を使用\)  
+  
+-   メッセージ資格情報を使用するトランスポート セキュリティ \(TLS \(Transport Layer Security\) over TCP によって実現される機密性と整合性、および WS\-Security によって提供される承認に使用する資格情報\)  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.NetTcpSecurity>、<xref:System.ServiceModel.TcpTransportSecurity>、<xref:System.ServiceModel.TcpClientCredentialType>、<xref:System.ServiceModel.MessageSecurityOverTcp>、および <xref:System.ServiceModel.MessageCredentialType>。  
+  
+### NetNamedPipeBinding  
+ コードでは <xref:System.ServiceModel.NetNamedPipeBinding> クラスを使用し、構成では [\<netNamedPipeBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md)を使用します。  
+  
+ このバインディングは、\(通常では同じコンピューター上の\) 複数プロセス間の通信に最適化されています。既定では、このバインディングには次の特性があります。  
+  
+-   トランスポート セキュリティを使用して、メッセージ転送と認証を実現します。  
+  
+-   名前付きパイプを使用してメッセージを配信します。  
+  
+-   バイナリ メッセージのエンコードを実装します。  
+  
+-   暗号化とメッセージの署名を使用します。  
+  
+ 選択できる方法は次のとおりです。  
+  
+-   Windows セキュリティを使用した認証  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「<xref:System.ServiceModel.NetNamedPipeSecurity>」、「<xref:System.ServiceModel.NetNamedPipeSecurityMode>」、および「<xref:System.ServiceModel.NamedPipeTransportSecurity>」を参照してください。  
+  
+### MsmqIntegrationBinding  
+ コードでは <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> クラスを使用し、構成では [\<msmqIntegrationBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md)を使用します。  
+  
+ このバインディングは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] MSMQ \(Microsoft Message Queuing\) 以外のエンドポイントと相互運用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスの作成用に最適化されています。  
+  
+ 既定では、このバインディングはトランスポート セキュリティを使用し、次のセキュリティ特性を提供します。  
+  
+-   セキュリティは無効 \(なし\) にできます。  
+  
+-   MSMQ トランスポート セキュリティ \(トランスポート\)。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「<xref:System.ServiceModel.NetMsmqSecurity>」および「<xref:System.ServiceModel.NetMsmqSecurityMode>」を参照してください。  
+  
+### NetMsmqBinding  
+ コードでは <xref:System.ServiceModel.NetMsmqBinding> クラスを使用し、構成では [\<netMsmqBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md)を使用します。  
+  
+ このバインディングは、MSMQ のキューに置かれたメッセージのサポートを必要とする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの作成時に使用します。  
+  
+ 既定では、このバインディングはトランスポート セキュリティを使用し、次のセキュリティ特性があります。  
+  
+-   セキュリティは無効 \(なし\) にできます。  
+  
+-   MSMQ トランスポート セキュリティ \(トランスポート\)。  
+  
+-   SOAP に基づくメッセージ セキュリティ \(メッセージ\)。  
+  
+-   トランスポート セキュリティとメッセージ セキュリティ \(両方\)。  
+  
+-   サポートされるクライアント資格情報の種類 : なし、Windows、UserName、証明書、IssuedToken。  
+  
+ <xref:System.ServiceModel.MessageCredentialType> 資格情報は、セキュリティ モードが <xref:System.ServiceModel.NetMsmqSecurityMode> または <xref:System.ServiceModel.NetMsmqSecurityMode> に設定されている場合にのみサポートされます。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「<xref:System.ServiceModel.MessageSecurityOverMsmq>」および「<xref:System.ServiceModel.MsmqTransportSecurity>」を参照してください。  
+  
+### WSFederationHttpBinding  
+ コードでは <xref:System.ServiceModel.WSFederationHttpBinding> クラスを使用し、構成では [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)を使用します。  
+  
+ 既定では、このバインディングは WS\-Security \(メッセージ層セキュリティ\) を使用します。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)」、「<xref:System.ServiceModel.WSFederationHttpSecurity>」、および「<xref:System.ServiceModel.WSFederationHttpSecurityMode>」を参照してください。  
+  
+## カスタム バインディング  
+ システム指定のバインディングがいずれも要件を満たさない場合は、カスタム セキュリティ バインド要素を使用してカスタム バインディングを作成できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md).  
+  
+## バインディングの選択肢  
+ 次の表は、セキュリティ モード設定で提供される機能をまとめたものです。つまり、セキュリティ モードを `Transport`、`Message`、または `TransportWithMessageCredential` に設定したときに使用できる機能の一覧です。アプリケーションで必要なセキュリティ機能を決定するときに、この表を参考にしてください。  
+  
+|設定|機能|  
+|--------|--------|  
+|トランスポート|サーバー認証<br /><br /> クライアント認証<br /><br /> Point\-to\-Point のセキュリティ<br /><br /> 相互運用性<br /><br /> ハードウェア アクセラレータ<br /><br /> 高いスループット<br /><br /> セキュリティで保護されたファイアウォール<br /><br /> 待機時間の長いアプリケーション<br /><br /> 複数のホップでの再暗号化|  
+|メッセージ|サーバー認証<br /><br /> クライアント認証<br /><br /> エンド ツー エンドのセキュリティ<br /><br /> 相互運用性<br /><br /> 多様なクレーム<br /><br /> フェデレーション<br /><br /> 複数要因の認証<br /><br /> カスタム トークン<br /><br /> Notary\/Timestamp サービス<br /><br /> 待ち時間の長いアプリケーション<br /><br /> メッセージ署名の永続化|  
+|TransportWithMessageCredential|サーバー認証<br /><br /> クライアント認証<br /><br /> Point\-to\-Point のセキュリティ<br /><br /> 相互運用性<br /><br /> ハードウェアの高速化<br /><br /> 高いスループット<br /><br /> 多様なクライアント クレーム<br /><br /> フェデレーション<br /><br /> 複数要因の認証<br /><br /> カスタム トークン<br /><br /> セキュリティで保護されたファイアウォール<br /><br /> 待ち時間の長いアプリケーション<br /><br /> 複数のホップでの再暗号化|  
+  
+ さまざまなモード設定をサポートするバインディングを次の表に示します。サービス エンドポイントを作成するときは、使用するバインディングをこの表から選択してください。  
+  
+|バインディング|トランスポート モードのサポート|メッセージ モードのサポート|TransportWithMessageCredential のサポート|  
+|-------------|----------------------|--------------------|------------------------------------------|  
+|`BasicHttpBinding`|○|○|○|  
+|`WSHttpBinding`|○|○|○|  
+|`WSDualHttpBinding`|×|○|×|  
+|`NetTcpBinding`|○|○|○|  
+|`NetNamedPipeBinding`|○|×|×|  
+|`NetMsmqBinding`|○|○|×|  
+|`MsmqIntegrationBinding`|○|×|×|  
+|`wsFederationHttpBinding`|×|○|○|  
+  
+## バインディングにおけるトランスポート資格情報  
+ トランスポート セキュリティ モードで `BasicHttpBinding` または `WSHttpBinding` を使用するときに使用できるクライアント資格情報の種類を、次の表に示します。  
+  
+|種類|説明|  
+|--------|--------|  
+|なし|クライアントは資格情報を提示する必要がないことを指定します。匿名クライアントであると解釈されます。|  
+|基本|基本認証です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「RFC 2617 – HTTP Authentication: Basic and Digest Authentication」を参照してください。このドキュメントは、[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=84023](http://go.microsoft.com/fwlink/?LinkId=84023) で参照できます。|  
+|ダイジェスト|ダイジェスト認証です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「RFC 2617 – HTTP Authentication: Basic and Digest Authentication」を参照してください。このドキュメントは、[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=84023](http://go.microsoft.com/fwlink/?LinkId=84023) で参照できます。|  
+|NTLM|NTLM \(NT LAN Manager\) 認証です。|  
+|Windows|Windows 認証です。|  
+|証明書|証明書を使用して実行される認証です。|  
+|IssuedToken|セキュリティ トークン サービスまたは [!INCLUDE[infocard](../../../../includes/infocard-md.md)] によって発行されたトークンを使用したクライアントの認証を、サービスが要求できるようにします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md).|  
+  
+### バインディングにおけるメッセージ クライアント資格情報  
+ メッセージ セキュリティ モードでバインディングを使用するときに使用できる、クライアント資格情報の種類を次の表に示します。  
+  
+|型|説明|  
+|-------|--------|  
+|なし|サービスが匿名クライアントとやり取りを行うことが可能になります。|  
+|Windows|Windows 資格情報の認証済みコンテキストの制御下で SOAP メッセージ交換を行うことができます。|  
+|UserName|サービスが、ユーザー名資格情報を使用したクライアントの認証を要求できるようにします。セキュリティ モードが `TransportWithMessageCredential` に設定されている場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、パスワード ダイジェストの送信、またはパスワードを使用したキーの派生、およびメッセージ モード セキュリティでのこのようなキーの使用がサポートされません。そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザー名資格情報を使用する場合に、トランスポートが強制的にセキュリティで保護されます。|  
+|Certificate|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。|  
+|IssuedToken|サービスは、セキュリティ トークン サービスを使用してカスタム トークンを提供できます。|  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [資格情報の種類の選択](../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [セキュリティ動作](../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/bindings.md b/docs/framework/wcf/feature-details/bindings.md
new file mode 100644
index 00000000000..16e40156091
--- /dev/null
+++ b/docs/framework/wcf/feature-details/bindings.md
@@ -0,0 +1,50 @@
+---
+title: "Windows Communication Foundation バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング [WCF]"
+  - "WCF [WCF], バインディング"
+  - "Windows Communication Foundation [WCF], バインディング"
+ms.assetid: 83639133-89f7-43f0-b4ef-8d9e57c08d25
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# Windows Communication Foundation バインディング
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、アプリケーション ソフトウェアを作成する方法と、アプリケーション ソフトウェアが他のソフトウェアと通信する方法は分離されています。バインディングを使用して、クライアントとサービスが相互に通信するために必要なトランスポート、エンコーディング、およびプロトコルの詳細を指定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、バインディングを使用してエンドポイントの基になるネットワーク上の表現を生成します。このため、バインディングの詳細の大半について通信している双方が合意する必要があります。これを実現する最も簡単な方法は、サービスのクライアントがサービスのエンドポイントと同じバインディングを使用することです。その方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)」を参照してください。  
+  
+ バインディングは、バインド要素のコレクションで構成されます。各要素は、エンドポイントがクライアントと通信する方法の一部分を記述します。バインディングには、1 つ以上のトランスポート バインド要素、1 つ以上のメッセージ エンコーディング バインド要素 \(既定では、トランスポート バインド要素によって提供されます\)、および任意の数の他のプロトコル バインド要素が含まれている必要があります。このように、ランタイムをビルドするプロセスでは、各バインド要素からランタイムにコードを提供できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、一般的なバインド要素を含むさまざまなバインディングが用意されています。これらのバインディングは、既定の設定で使用することも、ユーザーの要件に応じて既定値を変更することもできます。これらのシステム指定のバインディングには、バインド要素およびその設定を直接制御できるプロパティが含まれます。また、バインディングの各バージョンに独自の名前を付けることで、複数のバージョンを同時に使用することもできます。詳細については、「[システムが提供するバインディングの構成](../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)」を参照してください。  
+  
+ システム指定のバインディングに用意されていないバインド要素のコレクションが必要になった場合には、その必要なバインド要素のコレクションで構成されるカスタム バインディングを作成できます。このようなカスタム バインディングは簡単に作成でき、新しいクラスも必要ありませんが、バインド要素およびその設定を制御するためのプロパティは提供されません。バインド要素へのアクセスと設定の変更は、バインド要素を含むコレクションを通じて行います。詳細については、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## このセクションの内容  
+ [システムが提供するバインディングの構成](../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)  
+ 一般的なシナリオをサポートするために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されたバインディングを使用および変更する方法について説明します。  
+  
+ [Using Bindings to Configure Windows Communication Foundation Services and Clients](http://msdn.microsoft.com/ja-jp/bd8b277b-932f-472f-a42a-b02bb5257dfb)  
+ サービスおよびクライアントで使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] バインディングをコードで強制的に定義する方法と、構成を使用して宣言によって定義する方法について説明します。  
+  
+ [カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)  
+ <xref:System.ServiceModel.Channels.CustomBinding> の概要と使用する状況について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Channels.Binding>  
+  
+ <xref:System.ServiceModel.Channels.BindingElement>  
+  
+ <xref:System.ServiceModel.Channels.CustomBinding>  
+  
+## 関連項目  
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/building-a-peer-channel-application.md b/docs/framework/wcf/feature-details/building-a-peer-channel-application.md
new file mode 100644
index 00000000000..b1b523adf75
--- /dev/null
+++ b/docs/framework/wcf/feature-details/building-a-peer-channel-application.md
@@ -0,0 +1,36 @@
+---
+title: "ピア チャネル アプリケーションの構築 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a69a1b8f-8e15-45c5-87b8-bdb71e1c7ab8
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ピア チャネル アプリケーションの構築
+次のセクションでは、ピア チャネル アプリケーションの開発に関するガイダンスを示します。  
+  
+## このセクションの内容  
+ [NetTcpBinding アプリケーションからピア チャネル アプリケーションへの変換](../../../../docs/framework/wcf/feature-details/converting-a-nettcpbinding-application-to-a-peer-channel-application.md)  
+ NetTcpBinding アプリケーションをピア チャネル アプリケーションに変換する方法について説明します。  
+  
+ [メッセージ配布の制限](../../../../docs/framework/wcf/feature-details/limiting-message-distribution.md)  
+ ホップ数、メッセージ伝達フィルター、ローカル フィルター、または直接接続を使用し、メッシュを経由してメッセージを転送する方法について説明し、1 つの方法を選択するための一般的なガイドラインを示します。  
+  
+ [オンライン ステータスとオフライン ステータスの追加](../../../../docs/framework/wcf/feature-details/adding-online-and-offline-status.md)  
+ <xref:System.ServiceModel.IOnlineStatus> インターフェイスを使用して、ピア チャネル接続のオンラインおよびオフライン ステータスに関する明確な詳細情報を監視する方法について説明します。  
+  
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)  
+ トランスポート ベースとメッセージ ベースのセキュリティ、およびピア チャネル アプリケーションのベスト プラクティスについて説明します。  
+  
+## 参照  
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md b/docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md
new file mode 100644
index 00000000000..0553309ab95
--- /dev/null
+++ b/docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md
@@ -0,0 +1,172 @@
+---
+title: "WCF WEB HTTP サービスのキャッシュ サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f8078e0-00d9-415c-b8ba-c1b6d5c31799
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# WCF WEB HTTP サービスのキャッシュ サポート
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] を使用すると、WCF Web HTTP サービスの ASP.NET で既に提供されている、宣言によるキャッシュ機構を使用できます。これにより、WCF Web HTTP サービス操作からの応答をキャッシュできます。キャッシュ用に構成されているサービスに対してユーザーが HTTP GET を送信すると、ASP.NET は、キャッシュされた応答を送り返し、サービス メソッドは呼び出されません。キャッシュの有効期限が切れると、ユーザーが次回に HTTP GET を送信したときに、サービス メソッドが呼び出され、応答が再度キャッシュされます。ASP.NET キャッシュ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ASP.NET のキャッシュの概要](http://go.microsoft.com/fwlink/?LinkId=152534)」を参照してください。  
+  
+## 基本的な Web HTTP サービスのキャッシュ  
+ WEB HTTP サービスのキャッシュを有効にするには、まず、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> の <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute.RequirementsMode%2A> を <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Allowed> または <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required> に設定してサービスに適用し、ASP.NET との互換性を有効にする必要があります。  
+  
+ [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] では、キャッシュ プロファイル名を指定できる <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> という新しい属性が導入されています。この属性は、サービス操作に適用されます。次の例では、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> をサービスに適用して ASP.NET との互換性を有効にし、`GetCustomer` 操作をキャッシュできるように構成しています。<xref:System.ServiceModel.Activation.AspNetCacheProfileAttribute> 属性には、使用されるキャッシュ設定が含まれるキャッシュ プロファイルを指定します。  
+  
+```  
+[ServiceContract] AspNetCompatibilityRequirements(RequirementsMode=AspNetCompatibilityRequirementsMode.Allowed)]  
+    public class Service  
+    {   
+        [WebGet(UriTemplate = "{id}")]  
+        [AspNetCacheProfile("CacheFor60Seconds")]  
+        public Customer GetCustomer(string id)  
+        {  
+             // ...  
+        }  
+}  
+```  
+  
+ また、ASP.NET 互換性モードを Web.config ファイルで有効にすることも必要です。次にその例を示します。  
+  
+```  
+<system.serviceModel>  
+        <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />      
+</system.serviceModel>  
+  
+```  
+  
+> [!WARNING]
+>  ASP.NET 互換性モードが有効にされていない場合は、<xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> が使用されて、例外がスローされます。  
+  
+ <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> によって指定されたキャッシュ プロファイル名によって、Web.config 構成ファイルに追加されるキャッシュ プロファイルが特定されます。キャッシュ プロファイルは、\<`outputCacheSetting`\> 要素内に定義します。次にその構成例を示します。  
+  
+```  
+<!-- ...  -->  
+<system.web>  
+   <caching>  
+      <outputCacheSettings>  
+         <outputCacheProfiles>  
+            <add name="CacheFor60Seconds" duration="60" varyByParam="none" sqlDependency="MyTestDatabase:MyTable"/>  
+         </outputCacheProfiles>  
+      </outputCacheSettings>  
+   </caching>  
+   <!-- ... -->  
+</system.web>  
+```  
+  
+ これは、ASP.NET アプリケーションで使用できる構成要素と同じです。ASP.NET キャッシュ プロファイル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、<xref:System.Web.Configuration.OutputCacheProfile> を参照してください。Web HTTP サービスの場合、キャッシュ プロファイルで最も重要な属性は `cacheDuration` と `varyByParam` です。この 2 つの属性はどちらも必要です。`cacheDuration` は、応答がキャッシュに保持される時間 \(秒数\) を設定します。`varyByParam` では、応答のキャッシュに使用されるクエリ文字列パラメーターを指定できます。異なるクエリ文字列パラメーターの値を使用する要求は、すべて個別にキャッシュされます。たとえば、http:\/\/MyServer\/MyHttpService\/MyOperation?param\=10 に最初の要求を送ると、同じ URI を使用して送られるすべての後続の要求には、キャッシュされている応答が返されます \(キャッシュ期間が経過していない場合\)。クエリ文字列パラメーターの値が異なることを除いて同じである同様の要求に対する応答は、個別にキャッシュされます。このような個別のキャッシングを行わない場合は、`varyByParam` を "none" に設定します。  
+  
+## SQL キャッシュ依存関係  
+ Web HTTP サービスの応答も、SQL キャッシュ依存関係と併せてキャッシュできます。SQL データベースに格納されているデータに応じて WCF Web HTTP サービスが異なる場合は、サービスの応答をキャッシュして、キャッシュした応答を、SQL データベース テーブル内のデータの変更時に無効にすることもできます。この動作は、すべて Web.config ファイル内で構成します。まず、\<`connectionStrings`\> 要素に接続文字列を定義します。  
+  
+```  
+<connectionStrings>  
+    <add name="connectString"  
+        connectionString="Data Source=MyService;Initial Catalog=MyTestDatabase;Integrated Security=True"  
+        providerName="System.Data.SqlClient" />  
+  </connectionStrings>  
+```  
+  
+ 次に、\<`system.web`\> 要素内の \<`caching`\> 要素内で SQL キャッシュ依存関係を有効にします。次にその構成例を示します。  
+  
+```  
+<system.web>  
+   <caching>  
+      <sqlCacheDependency enabled="true" pollTime="1000" >  
+         <databases>  
+            <add name="MyTestDatabase" connectionStringName="connectString" />  
+         </databases>  
+      </sqlCacheDependency>  
+      <!-- ... -->  
+   </caching>  
+   <!-- ... -->  
+</system.web>  
+```  
+  
+ ここでは、SQL キャッシュ依存関係を有効にし、ポーリング タイムを 1000 ミリ秒に設定しています。ポーリング タイムが経過するたびに、データベース テーブルで更新の有無が確認されます。変更が検出されると、キャッシュの内容が削除され、次にサービス操作が呼び出されたときに、新しい応答がキャッシュされます。\<`sqlCacheDependency`\> 要素内にデータベースを追加し、\<`databases`\> 要素内の接続文字列を参照します。次にその例を示します。  
+  
+```  
+<system.web>  
+   <caching>  
+      <sqlCacheDependency enabled="true" pollTime="1000" >  
+         <databases>  
+            <add name="MyTestDatabase" connectionStringName="connectString" />  
+         </databases>  
+      </sqlCacheDependency>  
+      <!-- ... -->  
+   </caching>  
+   <!-- ... -->  
+</system.web>  
+```  
+  
+ 次に、\<`caching`\> 要素内に出力キャッシュの設定を構成します。次にその構成例を示します。  
+  
+```  
+<system.web>  
+<caching>  
+      <!-- ...  -->  
+<outputCacheSettings>  
+<outputCacheProfiles>  
+<add name="CacheFor60Seconds" duration="60" varyByParam="none" sqlDependency="MyTestDatabase:MyTable"/>  
+</outputCacheProfiles>  
+</outputCacheSettings>  
+</caching>  
+<!-- ... -->  
+</system.web>  
+```  
+  
+ ここでは、キャッシュ期間が 60 秒に、`varyByParam` が none に設定されており、`sqlDependency` が、コロン区切りのデータベース名とテーブルのペアをセミコロンで区切ったリストに設定されています。`MyTable` のデータが変更されると、キャッシュされているサービス操作への応答が削除されます。この操作が呼び出されると、新しい応答が \(サービス操作の呼び出しによって\) 生成され、キャッシュされて、クライアントに返されます。  
+  
+> [!IMPORTANT]
+>  ASP.NET から SQL データベースにアクセスするには、[ASP.NET SQL Server 登録ツール](http://go.microsoft.com/fwlink/?LinkId=152536)を使用する必要があります。また、適切なユーザー アカウントに、データベースおよびテーブルへのアクセスを許可する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[Web アプリケーションから SQL Server へのアクセス](http://go.microsoft.com/fwlink/?LinkId=178988)」を参照してください。  
+  
+## 条件付きの HTTP GET ベースのキャッシュ  
+ Web HTTP シナリオでは、条件付き HTTP GET がサービスで使用されて、「[HTTP の仕様](http://go.microsoft.com/fwlink/?LinkId=165800)」で説明されているように、インテリジェントな HTTP キャッシュが実装されることがよくあります。そのためには、サービスが ETag ヘッダーの値を HTTP 応答に設定する必要があります。また、HTTP 要求の If\-None\-Match ヘッダーの値を確認して、指定されている ETag が現在の ETag と一致するかどうかを調べる必要もあります。  
+  
+ GET および HEAD 要求の場合、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> は ETag 値を取得し、この値と要求内の If\-None\-Match ヘッダーとを比較します。ヘッダーが存在し、一致が見つかった場合は、HTTP ステータス コード 304 \(変更なし\) が設定された <xref:System.ServiceModel.Web.WebFaultException> がスローされ、一致する ETag が設定されている応答に ETag ヘッダーが追加されます。  
+  
+ <xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドのオーバーロードの 1 つは、最終更新日を取得し、これを、要求の If\-Modified\-Since ヘッダーと比較します。ヘッダーが存在し、リソースが変更されていない場合は、HTTP ステータス コード 304 \(変更なし\) が設定された <xref:System.ServiceModel.Web.WebFaultException> がスローされます。  
+  
+ PUT、POST、および DELETE の各要求の場合、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> は、リソースの現在の ETag 値を取得します。現在の ETag 値が null の場合、メソッドは、If\-None\- Match ヘッダーの値が "\*" であるかどうかを確認します。現在の ETag 値が既定値ではない場合、メソッドは、現在の ETag 値と要求の If\-None\- Match ヘッダーを比較します。どちらの場合も、求められるヘッダーが要求内に存在しない、またはヘッダーの値がチェック条件を満たしていないと、メソッドは、HTTP ステータス コード 412 \(必須条件に失敗しました\) が設定された <xref:System.ServiceModel.Web.WebFaultException> をスローし、応答の ETag ヘッダーを現在の ETag 値に設定します。  
+  
+ `CheckConditional` メソッドも <xref:System.ServiceModel.Web.OutgoingWebResponseContext.SetETag%2A> メソッドも、応答ヘッダーに設定される ETag 値が、確実に HTTP 仕様に沿った有効な ETag になるようにします。これには、ETag 値を囲む二重引用符がない場合に二重引用符を付ける処理や、二重引用符内の文字を適切にエスケープする処理が含まれます。ETag の弱い比較はサポートされていません。  
+  
+ これらのメソッドを使用する方法の例を次に示します。  
+  
+```  
+[WebGet(UriTemplate = "{id}"), Description("Returns the specified customer from customers collection. Returns NotFound if there is no such customer. Supports conditional GET.")]  
+public Customer GetCustomer(string id)  
+{  
+    lock (writeLock)  
+    {  
+        // return NotFound if there is no item with the specified id.  
+        object itemEtag = customerEtags[id];  
+        if (itemEtag == null)  
+        {  
+            throw new WebFaultException(HttpStatusCode.NotFound);  
+        }  
+  
+        // return NotModified if the client did a conditional GET and the customer item has not changed  
+        // since when the client last retrieved it  
+                 WebOperationContext.Current.IncomingRequest.CheckConditionalRetrieve((long)itemEtag);  
+       Customer result = this.customers[id] as Customer;  
+       // set the customer etag before returning the result  
+                WebOperationContext.Current.OutgoingResponse.SetETag((long)itemEtag);  
+                return result;  
+    }  
+}  
+```  
+  
+## セキュリティに関する注意事項  
+ 承認が必要な要求の応答はキャッシュしないでください。応答がキャッシュから提供された場合は、承認が実行されません。このような応答をキャッシュすると、重大なセキュリティの脆弱性が生じます。通常、承認が必要な要求ではユーザー固有のデータが提供されるため、サーバー側でキャッシュしても利点はありません。このような場合は、クライアント側でキャッシュするか、単にキャッシュをまったく行わない方が適切です。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/calling-a-rest-style-service-from-a-wcf-service.md b/docs/framework/wcf/feature-details/calling-a-rest-style-service-from-a-wcf-service.md
new file mode 100644
index 00000000000..8e63b1c7b46
--- /dev/null
+++ b/docs/framework/wcf/feature-details/calling-a-rest-style-service-from-a-wcf-service.md
@@ -0,0 +1,243 @@
+---
+title: "WCF サービスからの REST スタイル サービスの呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 77df81d8-7f53-4daf-8d2d-bf7996e94d5a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF サービスからの REST スタイル サービスの呼び出し
+標準の \(SOAP ベース\) WCF サービスから REST スタイルのサービスを呼び出すとき、受信要求に関する情報を含んでいるサービス メソッドの操作コンテキストは、送信要求が使用するコンテキストをオーバーライドします。  これにより、HTTP GET 要求は HTTP POST 要求に変更されます。  WCF サービスが正しいコンテキストを使用して REST スタイルのサービスを呼び出すには、新しい <xref:System.ServiceModel.OperationContextScope> を作成し、操作コンテキスト スコープ内から REST スタイルのサービスを呼び出します。  このトピックでは、この手法を説明する簡単なサンプルを作成する方法について説明します。  
+  
+## REST スタイルのサービス コントラクトを定義する  
+ 簡単な REST スタイルのサービス コントラクトを定義する:  
+  
+```  
+[ServiceContract]  
+        public interface IRestInterface  
+        {  
+            [OperationContract, WebGet]  
+            int Add(int x, int y);  
+            [OperationContract, WebGet]  
+            string Echo(string input);  
+        }  
+```  
+  
+## REST スタイルのサービス コントラクトを実装する  
+ REST スタイルのサービス コントラクトを実装する:  
+  
+```  
+public class RestService : IRestInterface  
+        {  
+            public int Add(int x, int y)  
+            {  
+                return x + y;  
+            }  
+  
+            public string Echo(string input)  
+            {  
+                return input;  
+            }  
+        }  
+  
+```  
+  
+## WCF サービス コントラクトを定義する  
+ REST スタイルのサービスの呼び出しに使用する WCF サービス コントラクトを定義する:  
+  
+```  
+[ServiceContract]  
+ public interface INormalInterface  
+ {  
+     [OperationContract]  
+     int CallAdd(int x, int y);  
+     [OperationContract]  
+     string CallEcho(string input);  
+ }  
+```  
+  
+## WCF サービス コントラクトを実装する  
+ WCF サービス コントラクトを実装する:  
+  
+```  
+public class NormalService : INormalInterface  
+        {  
+            static MyRestClient client = new MyRestClient(RestServiceBaseAddress);  
+            public int CallAdd(int x, int y)  
+            {  
+                return client.Add(x, y);  
+            }  
+  
+            public string CallEcho(string input)  
+            {  
+                return client.Echo(input);  
+            }  
+        }  
+```  
+  
+## REST スタイルのサービスのクライアント プロキシを作成する  
+ <xref:System.ServiceModel.ClientBase%60> を使用してクライアント プロキシを実装します。  呼び出される各メソッドで、新しい <xref:System.ServiceModel.OperationContextScope> が作成され、操作の呼び出しに使用されます。  
+  
+```  
+public class MyRestClient : ClientBase<IRestInterface>, IRestInterface  
+        {  
+            public MyRestClient(string address)  
+                : base(new WebHttpBinding(), new EndpointAddress(address))  
+            {  
+                this.Endpoint.Behaviors.Add(new WebHttpBehavior());  
+            }  
+  
+            public int Add(int x, int y)  
+            {  
+                using (new OperationContextScope(this.InnerChannel))  
+                {  
+                    return base.Channel.Add(x, y);  
+                }  
+            }  
+  
+            public string Echo(string input)  
+            {  
+                using (new OperationContextScope(this.InnerChannel))  
+                {  
+                    return base.Channel.Echo(input);  
+                }  
+            }  
+        }  
+```  
+  
+## サービスをホストし、呼び出す  
+ コンソール アプリケーションの両方のサービスをホストし、必要なエンドポイントと動作を追加します。  次に、通常の WCF サービスを呼び出します。  
+  
+```  
+public static void Main()  
+        {  
+            ServiceHost restHost = new ServiceHost(typeof(RestService), new Uri(RestServiceBaseAddress));  
+            restHost.AddServiceEndpoint(typeof(IRestInterface), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+            restHost.Open();  
+  
+            ServiceHost normalHost = new ServiceHost(typeof(NormalService), new Uri(NormalServiceBaseAddress));  
+            normalHost.AddServiceEndpoint(typeof(INormalInterface), new BasicHttpBinding(), "");  
+            normalHost.Open();  
+  
+            Console.WriteLine("Hosts opened");  
+  
+            ChannelFactory<INormalInterface> factory = new ChannelFactory<INormalInterface>(new BasicHttpBinding(), new EndpointAddress(NormalServiceBaseAddress));  
+            INormalInterface proxy = factory.CreateChannel();  
+  
+            Console.WriteLine(proxy.CallAdd(123, 456));  
+            Console.WriteLine(proxy.CallEcho("Hello world"));  
+        }  
+```  
+  
+## 完全なコード リスト  
+ このトピックで実装されるサンプルの完全なコード リストを次に示します。  
+  
+```  
+public class CallingRESTSample  
+    {  
+        static readonly string RestServiceBaseAddress = "http://" + Environment.MachineName + ":8008/Service";  
+        static readonly string NormalServiceBaseAddress = "http://" + Environment.MachineName + ":8000/Service";  
+  
+        [ServiceContract]  
+        public interface IRestInterface  
+        {  
+            [OperationContract, WebGet]  
+            int Add(int x, int y);  
+            [OperationContract, WebGet]  
+            string Echo(string input);  
+        }  
+  
+        [ServiceContract]  
+        public interface INormalInterface  
+        {  
+            [OperationContract]  
+            int CallAdd(int x, int y);  
+            [OperationContract]  
+            string CallEcho(string input);  
+        }  
+  
+        public class RestService : IRestInterface  
+        {  
+            public int Add(int x, int y)  
+            {  
+                return x + y;  
+            }  
+  
+            public string Echo(string input)  
+            {  
+                return input;  
+            }  
+        }  
+  
+        public class MyRestClient : ClientBase<IRestInterface>, IRestInterface  
+        {  
+            public MyRestClient(string address)  
+                : base(new WebHttpBinding(), new EndpointAddress(address))  
+            {  
+                this.Endpoint.Behaviors.Add(new WebHttpBehavior());  
+            }  
+  
+            public int Add(int x, int y)  
+            {  
+                using (new OperationContextScope(this.InnerChannel))  
+                {  
+                    return base.Channel.Add(x, y);  
+                }  
+            }  
+  
+            public string Echo(string input)  
+            {  
+                using (new OperationContextScope(this.InnerChannel))  
+                {  
+                    return base.Channel.Echo(input);  
+                }  
+            }  
+        }  
+  
+        public class NormalService : INormalInterface  
+        {  
+            static MyRestClient client = new MyRestClient(RestServiceBaseAddress);  
+            public int CallAdd(int x, int y)  
+            {  
+                return client.Add(x, y);  
+            }  
+  
+            public string CallEcho(string input)  
+            {  
+                return client.Echo(input);  
+            }  
+        }  
+        public static void Main()  
+        {  
+            ServiceHost restHost = new ServiceHost(typeof(RestService), new Uri(RestServiceBaseAddress));  
+            restHost.AddServiceEndpoint(typeof(IRestInterface), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+            restHost.Open();  
+  
+            ServiceHost normalHost = new ServiceHost(typeof(NormalService), new Uri(NormalServiceBaseAddress));  
+            normalHost.AddServiceEndpoint(typeof(INormalInterface), new BasicHttpBinding(), "");  
+            normalHost.Open();  
+  
+            Console.WriteLine("Hosts opened");  
+  
+            ChannelFactory<INormalInterface> factory = new ChannelFactory<INormalInterface>(new BasicHttpBinding(), new EndpointAddress(NormalServiceBaseAddress));  
+            INormalInterface proxy = factory.CreateChannel();  
+  
+            Console.WriteLine(proxy.CallAdd(123, 456));  
+            Console.WriteLine(proxy.CallEcho("Hello world"));  
+        }  
+    }  
+```  
+  
+## 参照  
+ [方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md)   
+ [WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/cert-val-diff-https-ssl-over-tcp-and-soap.md b/docs/framework/wcf/feature-details/cert-val-diff-https-ssl-over-tcp-and-soap.md
new file mode 100644
index 00000000000..4f239b0801b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/cert-val-diff-https-ssl-over-tcp-and-soap.md
@@ -0,0 +1,56 @@
+---
+title: "HTTPS、SSL Over TCP、SOAP セキュリティ間における証明書検証方法の相違点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], 検証方法の相違点"
+ms.assetid: 953a219f-4745-4019-9894-c70704f352e6
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# HTTPS、SSL Over TCP、SOAP セキュリティ間における証明書検証方法の相違点
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、HTTP \(HTTPS\) または TCP を介したトランスポート層セキュリティ \(TLS\) だけでなく、メッセージ層 \(SOAP\) セキュリティでも証明書を使用できます。ここでは、このような証明書の検証方法の違いについて説明します。  
+  
+## HTTPS クライアント証明書の検証  
+ HTTPS を使用してクライアントとサービス間で通信を行う場合、サービスに対して認証を行うためにクライアントが使用する証明書はチェーン信頼をサポートしている必要があります。つまり、信頼されたルート証明機関にチェーンされている必要があります。チェーンされていない場合は、HTTP レイヤーで <xref:System.Net.WebException> が発生し、メッセージ "リモート サーバーがエラーを返しました: \(403\) 使用不可能" が表示されます。この例外は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって <xref:System.ServiceModel.Security.MessageSecurityException> として示されます。  
+  
+## HTTP サービス証明書の検証  
+ HTTPS を使用してクライアントとサービス間で通信を行う場合、サーバーが認証に使用する証明書は既定でチェーン信頼をサポートしている必要があります。つまり、信頼されたルート証明機関にチェーンされている必要があります。証明書が失効しているかどうかを確認するためのオンライン チェックは行われません。この動作は、<xref:System.Net.Security.RemoteCertificateValidationCallback> コールバックを登録することによってオーバーライドできます。コードは次のようになります。  
+  
+ [!code-csharp[c_CertificateValidationDifferences#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_certificatevalidationdifferences/cs/source.cs#1)]
+ [!code-vb[c_CertificateValidationDifferences#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_certificatevalidationdifferences/vb/source.vb#1)]  
+  
+ `ValidateServerCertificate` の署名は次のようになります。  
+  
+ [!code-csharp[c_CertificateValidationDifferences#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_certificatevalidationdifferences/cs/source.cs#2)]
+ [!code-vb[c_CertificateValidationDifferences#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_certificatevalidationdifferences/vb/source.vb#2)]  
+  
+ `ValidateServerCertificate` を実装すると、サービス証明書を検証するために必要であるとクライアント アプリケーションの開発者が考える、すべてのチェックを実行できます。  
+  
+## SSL over TCP または SOAP セキュリティにおけるクライアント証明書の検証  
+ SSL \(Secure Sockets Layer\) over TCP またはメッセージ \(SOAP\) セキュリティを使用する場合、クライアント証明書は <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication> クラスの <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication.CertificateValidationMode%2A> プロパティ値に従って検証されます。プロパティは <xref:System.ServiceModel.Security.X509CertificateValidationMode> の値のいずれかに設定されます。失効チェックは <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication> クラスの <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication.RevocationMode%2A> プロパティの値に応じて実行されます。プロパティは <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> の値のいずれかに設定されます。  
+  
+ [!code-csharp[c_CertificateValidationDifferences#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_certificatevalidationdifferences/cs/source.cs#3)]
+ [!code-vb[c_CertificateValidationDifferences#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_certificatevalidationdifferences/vb/source.vb#3)]  
+  
+## SSL over TCP および SOAP セキュリティにおけるサービス証明書の検証  
+ SSL over TCP またはメッセージ \(SOAP\) セキュリティを使用する場合、サービス証明書は <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication> クラスの <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CertificateValidationMode%2A> プロパティ値に従って検証されます。プロパティは <xref:System.ServiceModel.Security.X509CertificateValidationMode> の値のいずれかに設定されます。  
+  
+ 失効チェックは <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication> クラスの <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.RevocationMode%2A> プロパティの値に応じて実行されます。プロパティは <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> の値のいずれかに設定されます。  
+  
+ [!code-csharp[c_CertificateValidationDifferences#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_certificatevalidationdifferences/cs/source.cs#4)]
+ [!code-vb[c_CertificateValidationDifferences#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_certificatevalidationdifferences/vb/source.vb#4)]  
+  
+## 参照  
+ <xref:System.Net.Security.RemoteCertificateValidationCallback>   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md b/docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md
new file mode 100644
index 00000000000..5b155306d43
--- /dev/null
+++ b/docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md
@@ -0,0 +1,202 @@
+---
+title: "Send アクティビティのキャッシュ共有レベルの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03926a64-753d-460e-ac06-2a4ff8e1bbf5
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Send アクティビティのキャッシュ共有レベルの変更
+<xref:System.ServiceModel.Activities.SendMessageChannelCache> 拡張機能により、キャッシュ共有レベルのカスタマイズやチャネル ファクトリ キャッシュの設定のカスタマイズを行えるほか、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティを使用してサービス エンドポイントにメッセージを送信するワークフローのチャネル キャッシュの設定のカスタマイズも可能になります。これらのワークフローは、通常はクライアント ワークフローですが、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスである場合もあります。チャネル ファクトリ キャッシュには、<xref:System.ServiceModel.ChannelFactory%601> オブジェクトがキャッシュされます。チャネル キャッシュには、チャネルがキャッシュされます。  
+  
+> [!NOTE]
+>  ワークフローは <xref:System.ServiceModel.Activities.Send> メッセージング アクティビティを使用してメッセージまたはパラメーターを送信できます。このワークフローのランタイムはチャネル ファクトリをキャッシュに追加しますが、チャネル ファクトリで作成されるチャネルは、<xref:System.ServiceModel.Activities.ReceiveReply> アクティビティを <xref:System.ServiceModel.Activities.Send> アクティビティと共に使用したときは <xref:System.ServiceModel.Channels.IRequestChannel> 型で、<xref:System.ServiceModel.Activities.Send> アクティビティだけを \(<xref:System.ServiceModel.Activities.ReceiveReply> なしで\) 使用したときは <xref:System.ServiceModel.Channels.IOutputChannel> 型です。  
+  
+## キャッシュ共有レベル  
+ 既定では、<xref:System.ServiceModel.WorkflowServiceHost> によってホストされるワークフローにおいて、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティが使用するキャッシュは <xref:System.ServiceModel.WorkflowServiceHost> のすべてのワークフロー インスタンス間で共有されます \(ホストレベルのキャッシュ\)。<xref:System.ServiceModel.WorkflowServiceHost> によってホストされないクライアント ワークフローの場合、キャッシュを使用できるのはワークフロー インスタンスだけです \(インスタンスレベルのキャッシュ\)。このキャッシュは、アンセーフ キャッシュが有効になっている場合を除き、構成で定義されているエンドポイントを使用しない <xref:System.ServiceModel.Activities.Send> アクティビティに対してのみ使用可能です。  
+  
+ ワークフローの <xref:System.ServiceModel.Activities.Send> アクティビティに使用可能なさまざまなキャッシュ共有レベルと、推奨される使用方法を次に示します。  
+  
+-   **ホスト レベル**: ホスト共有レベルでは、キャッシュを使用できるのはワークフロー サービス ホストでホストされるワークフロー インスタンスだけです。キャッシュはプロセス全体のキャッシュのワークフロー サービス ホスト間で共有できます。  
+  
+-   **インスタンス レベル**: インスタンス共有レベルでは、キャッシュを使用できるのは有効期間中の特定のワークフロー インスタンスで、他のワークフロー インスタンスはキャッシュを使用できません。  
+  
+-   **キャッシュなし**: 構成で定義されているエンドポイントを使用するワークフローがある場合、キャッシュは既定でオフになります。この場合、キャッシュをオンにすると安全性が損なわれることがあるため、オフにしておくことをお勧めします。たとえば、送信ごとに異なる ID \(異なる資格情報、または偽装の使用\) が必要な場合があります。  
+  
+## クライアント ワークフローのキャッシュ共有レベルの変更  
+ クライアント ワークフローでのキャッシュの共有を設定するには、<xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスのインスタンスを目的のワークフロー インスタンスのセットに拡張として追加します。この結果、すべてのワークフロー インスタンス間でキャッシュが共有されます。次のコード例は、この手順を実行する方法を示しています。  
+  
+ まず、<xref:System.ServiceModel.Activities.SendMessageChannelCache> 型のインスタンスを宣言します。  
+  
+```  
+  
+// Create an instance of SendMessageChannelCache with default cache settings.  
+static SendMessageChannelCache sharedChannelCacheExtension =  
+    new SendMessageChannelCache();  
+  
+```  
+  
+ 次に、各クライアント ワークフローのインスタンスにキャッシュ拡張を追加します。  
+  
+```  
+  
+WorkflowApplication clientInstance1 = new WorkflowApplication(new clientWorkflow1());  
+WorkflowApplication clientInstance2 = new WorkflowApplication(new clientWorkflow2());  
+  
+// Share the cache extension object   
+  
+clientInstance1.Extensions.Add(sharedChannelCacheExtension);  
+clientInstance2.Extensions.Add(sharedChannelCacheExtension);  
+  
+```  
+  
+## ホストされるワークフロー サービスのキャッシュ共有レベルの変更  
+ ホストされるワークフロー サービスでのキャッシュの共有を設定するには、<xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスのインスタンスをすべてのワークフロー サービス ホストに拡張として追加します。この結果、すべてのワークフロー サービス ホスト間でキャッシュが共有されます。次のコード例は、この手順を実行する方法を示しています。  
+  
+ まず、<xref:System.ServiceModel.Activities.SendMessageChannelCache> 型のインスタンスをクラス レベルで宣言します。  
+  
+```  
+  
+// Create static instance of SendMessageChannelCache with default cache settings.  
+static SendMessageChannelCache sharedChannelCacheExtension = new  
+    SendMessageChannelCache();  
+```  
+  
+ 次に、各ワークフロー サービス ホストに静的キャッシュ拡張を追加します。  
+  
+```  
+  
+WorkflowServiceHost host1 = new WorkflowServiceHost(new serviceWorkflow1(), new Uri(baseAddress1));  
+WorkflowServiceHost host2 = new WorkflowServiceHost(new serviceWorkflow2(), new Uri(baseAddress2));  
+  
+// Share the static cache to get an AppDomain level cache.  
+host1.WorkflowExtensions.Add(sharedChannelCacheExtension);  
+host2.WorkflowExtensions.Add(sharedChannelCacheExtension);  
+  
+```  
+  
+ ホストされるワークフロー サービスでのキャッシュ共有をインスタンス レベルに設定するには、`Func<SendMessageChannelCache>` デリゲートをワークフロー サービス ホストに拡張として追加し、<xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスの新しいインスタンスをインスタンス化するコードにこのデリゲートを割り当てます。この結果、ワークフロー サービス ホストのすべてのワークフロー インスタンスで 1 つのキャッシュが共有されるのではなく、ワークフロー インスタンスごとに異なるキャッシュが使用されます。次のコード例は、このデリゲートがポイントする <xref:System.ServiceModel.Activities.SendMessageChannelCache> 拡張を直接定義するラムダ式を使用して上記の処理を実行する方法を示しています。  
+  
+```  
+  
+serviceHost.WorkflowExtensions.Add(() => new SendMessageChannelCache  
+{  
+    // Use FactorySettings property to add custom factory cache settings.  
+    FactorySettings = new ChannelCacheSettings   
+    { MaxItemsInCache = 5, },  
+    // Use ChannelSettings property to add custom channel cache settings.  
+    ChannelSettings = new ChannelCacheSettings   
+    { MaxItemsInCache = 10 },  
+});  
+  
+```  
+  
+## キャッシュ設定のカスタマイズ  
+ チャネル ファクトリ キャッシュおよびチャネル キャッシュのキャッシュ設定をカスタマイズできます。キャッシュ設定は <xref:System.ServiceModel.Activities.ChannelCacheSettings> クラスで定義されています。<xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスは、チャネル ファクトリ キャッシュおよびチャネル キャッシュの既定のキャッシュ設定を、その既定のコンストラクターで定義します。次の表は、これらのキャッシュ設定の既定値をキャッシュのタイプごとに示しています。  
+  
+|||||  
+|-|-|-|-|  
+|設定|LeaseTimeout \(分\)|IdleTimeout \(分\)|MaxItemsInCache|  
+|ファクトリ キャッシュの既定値|TimeSpan.MaxValue|2|16|  
+|チャネル キャッシュの既定値|5|2|16|  
+  
+ ファクトリ キャッシュおよびチャネル キャッシュの設定をカスタマイズするには、パラメーター化されたコンストラクター <xref:System.ServiceModel.Activities.SendMessageChannelCache.%23ctor%2A> を使用して <xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスをインスタンス化し、<xref:System.ServiceModel.Activities.ChannelCacheSettings> の新しいインスタンスをカスタム値と共に `factorySettings` パラメーターおよび `channelSettings` パラメーターにそれぞれ渡します。次に、このクラスの新しいインスタンスをワークフロー サービス ホストまたはワークフロー インスタンスに拡張として追加します。次のコード例は、ワークフロー インスタンスに対してこの手順を実行する方法を示しています。  
+  
+```  
+  
+ChannelCacheSettings factorySettings = new ChannelCacheSettings{  
+                        MaxItemsInCache = 5,   
+                        IdleTimeout = TimeSpan.FromMinutes(5),   
+                        LeaseTimeout = TimeSpan.FromMinutes(20)};  
+  
+ChannelCacheSettings channelSettings = new ChannelCacheSettings{  
+                        MaxItemsInCache = 5,   
+                        IdleTimeout = TimeSpan.FromMinutes(2),  
+                        LeaseTimeout = TimeSpan.FromMinutes(10) };  
+  
+SendMessageChannelCache customChannelCacheExtension =   
+    new SendMessageChannelCache(factorySettings, channelSettings);  
+  
+clientInstance.Extensions.Add(customChannelCacheExtension);  
+  
+```  
+  
+ 構成で定義されているエンドポイントがワークフロー サービスにある場合にキャッシュを有効にするには、`allowUnsafeCaching` パラメーターが `true` に設定された、パラメーター化されたコンストラクター <xref:System.ServiceModel.Activities.SendMessageChannelCache.%23ctor%2A> を使用して <xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスをインスタンス化します。次に、このクラスの新しいインスタンスをワークフロー サービス ホストまたはワークフロー インスタンスに拡張として追加します。次のコード例は、ワークフロー インスタンスのキャッシュを有効にする方法を示しています。  
+  
+```  
+  
+SendMessageChannelCache customChannelCacheExtension =   
+    new SendMessageChannelCache{ AllowUnsafeCaching = true };  
+  
+clientInstance.Extensions.Add(customChannelCacheExtension);  
+  
+```  
+  
+ チャネル ファクトリおよびチャネルのキャッシュを完全に無効にするには、チャネル ファクトリ キャッシュを無効にします。こうすると、対応するチャネル ファクトリにチャネルが所有されるので、チャネル キャッシュもオフになります。チャネル ファクトリ キャッシュを無効にするには、<xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache%2A> 値が 0 の <xref:System.ServiceModel.Activities.ChannelCacheSettings> インスタンスに初期化された <xref:System.ServiceModel.Activities.SendMessageChannelCache.%23ctor%2A> コンストラクターに `factorySettings` パラメーターを渡します。このコード例を次に示します。  
+  
+```  
+  
+// Disable the factory cache. This results in the channel cache to be turned off as well.  
+ChannelCacheSettings factorySettings = new ChannelCacheSettings  
+    { MaxItemsInCache = 0 };  
+  
+ChannelCacheSettings channelSettings = new ChannelCacheSettings();  
+  
+SendMessageChannelCache customChannelCacheExtension =   
+    new SendMessageChannelCache(factorySettings, channelSettings);   
+  
+clientInstance.Extensions.Add(customChannelCacheExtension);  
+  
+```  
+  
+ チャネル ファクトリ キャッシュのみを使用し、チャネル キャッシュを無効にするには、<xref:System.ServiceModel.Activities.ChannelCacheSettings.MaxItemsInCache%2A> 値が 0 の <xref:System.ServiceModel.Activities.ChannelCacheSettings> インスタンスに初期化された <xref:System.ServiceModel.Activities.SendMessageChannelCache.%23ctor%2A> コンストラクターに `channelSettings` パラメーターを渡します。このコード例を次に示します。  
+  
+```  
+  
+ChannelCacheSettings factorySettings = new ChannelCacheSettings();  
+// Disable only the channel cache.  
+ChannelCacheSettings channelSettings = new ChannelCacheSettings  
+    { MaxItemsInCache = 0};  
+  
+SendMessageChannelCache customChannelCacheExtension =   
+    new SendMessageChannelCache(factorySettings, channelSettings);   
+  
+clientInstance.Extensions.Add(customChannelCacheExtension);  
+  
+```  
+  
+ ホストされたワークフロー サービスでは、ファクトリ キャッシュとチャネル キャッシュの設定をアプリケーション構成ファイルで指定できます。これを行うには、ファクトリ キャッシュおよびチャネル キャッシュのキャッシュ設定を含むサービス動作を追加し、そのサービス動作をサービスに追加します。次の例は、カスタムのファクトリ キャッシュ設定およびチャネル キャッシュ設定が指定された `MyChannelCacheBehavior` サービス動作を含む構成ファイルの内容を示しています。このサービス動作は、`behaviorConfiguarion` 属性を通じてサービスに追加されます。  
+  
+```  
+  
+<configuration>    
+  <system.serviceModel>  
+    <!-- List of other config sections here -->   
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="MyChannelCacheBehavior">  
+          <sendMessageChannelCache allowUnsafeCaching ="false" >  
+            <!-- Control only the host level settings -->   
+            <factorySettings maxItemsInCache = "8" idleTimeout = "00:05:00" leaseTimeout="10:00:00" />  
+            <channelSettings maxItemsInCache = "32" idleTimeout = "00:05:00" leaseTimeout="00:06:00" />  
+          </sendMessageChannelCache>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="MyService" behaviorConfiguration="MyChannelCacheBehavior" />  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/channel-factory-and-caching.md b/docs/framework/wcf/feature-details/channel-factory-and-caching.md
new file mode 100644
index 00000000000..bfc3699df00
--- /dev/null
+++ b/docs/framework/wcf/feature-details/channel-factory-and-caching.md
@@ -0,0 +1,127 @@
+---
+title: "チャネル ファクトリとキャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 954f030e-091c-4c0e-a7a2-10f9a6b1f529
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# チャネル ファクトリとキャッシュ
+WCF クライアント アプリケーションでは、<xref:System.ServiceModel.ChannelFactory%601> クラスを使用して WCF サービスとの通信チャネルを作成します。<xref:System.ServiceModel.ChannelFactory%601> インスタンスを作成するには、次の操作が必要なため、オーバーヘッドが生じます。  
+  
+-   <xref:System.ServiceModel.Description.ContractDescription> ツリーの構築  
+  
+-   必要なすべての CLR 型の反映  
+  
+-   チャネル スタックの構築  
+  
+-   リソースの破棄  
+  
+ このオーバーヘッドを最小限に抑えるために、WCF では、WCF クライアント プロキシの使用中にチャネル ファクトリをキャッシュできます。  
+  
+> [!TIP]
+>  <xref:System.ServiceModel.ChannelFactory%601> クラスを直接使用する場合は、チャネル ファクトリの作成を直接制御できます。  
+  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で生成される WCF クライアント プロキシは <xref:System.ServiceModel.ClientBase%601> から派生します。<xref:System.ServiceModel.ClientBase%601> では、チャネル ファクトリのキャッシュ動作を定義する静的な <xref:System.ServiceModel.ClientBase%601.CacheSetting%2A> プロパティを定義します。キャッシュ設定は特定の型に対して行われます。たとえば、`ClientBase<ITest>.CacheSettings` を以下に定義されているいずれかの値に設定すると、`ITest` 型のプロキシ\/ClientBase にのみ影響します。最初のプロキシ\/ClientBase インスタンスが作成された時点で、特定の <xref:System.ServiceModel.ClientBase%601> のキャッシュ設定は不変になります。  
+  
+## キャッシュ動作の指定  
+ キャッシュ動作は、<xref:System.ServiceModel.ClientBase%601.CacheSetting> プロパティを次のいずれかの値に設定することで指定します。  
+  
+|キャッシュの設定値|説明|  
+|---------------|--------|  
+|<xref:System.ServiceModel.CacheSetting.AlwaysOn>|アプリケーション ドメイン内の <xref:System.ServiceModel.ClientBase%601> のすべてのインスタンスはキャッシュに参加できます。開発者は、セキュリティがキャッシュに悪影響を与えないことを確認しています。<xref:System.ServiceModel.ClientBase%601> の "セキュリティに影響する" プロパティにアクセスされた場合でも、キャッシュは無効になりません。<xref:System.ServiceModel.ClientBase%601> の "セキュリティに影響する" プロパティは、<xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A>、<xref:System.ServiceModel.ClientBase%601.Endpoint%2A>、および <xref:System.ServiceModel.ClientBase%601.ChannelFactory%2A> です。|  
+|<xref:System.ServiceModel.CacheSetting.Default>|構成ファイルで定義されているエンドポイントから作成された <xref:System.ServiceModel.ClientBase%601> のインスタンスのみがアプリケーション ドメイン内のキャッシュに参加します。そのアプリケーション ドメイン内にプログラムで作成された <xref:System.ServiceModel.ClientBase%601> のインスタンスはキャッシュに参加しません。また、<xref:System.ServiceModel.ClientBase%601> の "セキュリティに影響する" プロパティにアクセスされると、そのインスタンスのキャッシュが無効になります。|  
+|<xref:System.ServiceModel.CacheSetting.AlwaysOff>|対象となるアプリケーション ドメイン内にある特定の型の <xref:System.ServiceModel.ClientBase%601> のすべてのインスタンスのキャッシュが無効になります。|  
+  
+ <xref:System.ServiceModel.ClientBase%601.CacheSetting%2A> プロパティを使用する方法を次のコード スニペットに示します。  
+  
+```  
+class Program   
+{   
+   static void Main(string[] args)   
+   {   
+      ClientBase<ITest>.CacheSettings = CacheSettings.AlwaysOn;   
+      foreach (string msg in messages)   
+      {   
+         using (TestClient proxy = new TestClient (new BasicHttpBinding(), new EndpointAddress(address)))   
+         {   
+            // ...  
+            proxy.Test(msg);   
+            // ...  
+         }   
+      }   
+   }   
+}  
+// Generated by SvcUtil.exe     
+public partial class TestClient : System.ServiceModel.ClientBase, ITest { }  
+  
+```  
+  
+ 上のコードでは、`TestClient` のすべてのインスタンスで同じチャネル ファクトリを使用します。  
+  
+```  
+class Program   
+{   
+   static void Main(string[] args)   
+   {   
+      ClientBase.CacheSettings = CacheSettings.Default;   
+      int i = 1;   
+      foreach (string msg in messages)   
+      {   
+         using (TestClient proxy = new TestClient (“MyEndpoint”, new EndpointAddress(address)))   
+         {   
+            if (i == 4)   
+            {   
+               ServiceEndpoint endpoint = proxy.Endpoint;   
+               ... // use endpoint in some way   
+            }   
+            proxy.Test(msg);   
+         }   
+         i++;   
+   }   
+}   
+  
+// Generated by SvcUtil.exe     
+public partial class TestClient : System.ServiceModel.ClientBase, ITest {}  
+```  
+  
+ 上の例では、`TestClient` のすべてのインスタンスで同じチャネル ファクトリを使用します \(インスタンス \#4 を除く\)。インスタンス \#4 では、そのインスタンス専用に作成されたチャネル ファクトリを使用します。この設定は、特定のエンドポイントで同じチャネル ファクトリ型 \(この場合は `ITest`\) の他のエンドポイントと異なるセキュリティ設定が必要なシナリオに有効です。  
+  
+```  
+class Program   
+{   
+   static void Main(string[] args)   
+   {   
+      ClientBase.CacheSettings = CacheSettings.AlwaysOff;   
+      foreach (string msg in messages)   
+      {   
+         using (TestClient proxy = new TestClient (“MyEndpoint”, new EndpointAddress(address)))   
+         {   
+            proxy.Test(msg);   
+         }           
+      }   
+   }  
+}  
+  
+// Generated by SvcUtil.exe   
+public partial class TestClient : System.ServiceModel.ClientBase, ITest {}  
+```  
+  
+ 上の例では、`TestClient` のすべてのインスタンスで異なるチャネル ファクトリを使用します。これは、エンドポイントごとにセキュリティ要件が異なり、キャッシュする意味がない場合に便利です。  
+  
+## 参照  
+ <xref:System.ServiceModel.ClientBase%601>   
+ [クライアントを構築する](../../../../docs/framework/wcf/building-clients.md)   
+ [クライアント](../../../../docs/framework/wcf/feature-details/clients.md)   
+ [WCF クライアントを使用したサービスへのアクセス](../../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)   
+ [方法 : ChannelFactory を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/choosing-a-filter.md b/docs/framework/wcf/feature-details/choosing-a-filter.md
new file mode 100644
index 00000000000..7ac7eab2549
--- /dev/null
+++ b/docs/framework/wcf/feature-details/choosing-a-filter.md
@@ -0,0 +1,161 @@
+---
+title: "フィルターの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67ab5af9-b9d9-4300-b3b1-41abb5a1fd10
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# フィルターの選択
+ルーティング サービスを構成する際には、適切なメッセージ フィルターを選択し、受信するメッセージと正確に一致できるように、それらのフィルターを構成することが重要です。選択したフィルターの適合基準が幅広すぎる場合や、適切に構成されていない場合は、メッセージが正しくルーティングされません。フィルターの適合基準が厳格すぎると、一部のメッセージの有効なルーティング先が見つからないことがあります。  
+  
+## フィルターの種類  
+ ルーティング サービスで使用するフィルターを選択する際には、各フィルターのしくみと、受信メッセージの一部として使用できる情報について理解しておくことが重要です。たとえば、すべてのメッセージが同じエンドポイントを介して受信される場合は、すべてのメッセージが Address フィルターと EndpointName フィルターに一致するため、これらのフィルターは役に立ちません。  
+  
+### 動作  
+ Action フィルターは <xref:System.ServiceModel.Channels.MessageHeaders.Action%2A> プロパティを確認します。メッセージの Action ヘッダーの内容が、フィルター構成で指定されているフィルター データ値と一致する場合、このフィルターは `true` を返します。次の例で定義されている `FilterElement` では、Action フィルターを使用して、値 http:\/\/namespace\/contract\/operation\/ が含まれているアクション ヘッダーを持つメッセージを一致させます。  
+  
+```xml  
+<filter name="action1" filterType="Action" filterData="http://namespace/contract/operation/" />  
+```  
+  
+```csharp  
+ActionMessageFilter action1 = new ActionMessageFilter(new string[] { "http://namespace/contract/operation" });  
+  
+```  
+  
+ 一意のアクション ヘッダーを含むメッセージをルーティングするときは、このフィルターを使用する必要があります。  
+  
+### EndpointAddress  
+ EndpointAddress フィルターは、メッセージを受信した EndpointAddress を確認します。メッセージが着信したアドレスが、フィルター構成で指定されたフィルター アドレスと正確に一致した場合、このフィルターは `true` を返します。次の例で定義されている `FilterElement` では、Address フィルターを使用して、http:\/\/\<hostname\>\/vdir\/s.svc\/b に宛てられたすべてのメッセージを一致させます。  
+  
+```xml  
+<filter name="address1" filterType="EndpointAddress" filterData="http://host/vdir/s.svc/b" />  
+  
+```  
+  
+```csharp  
+EndpointAddressMessageFilter address1 = new EndpointAddressMessageFilter(new EndpointAddress("http://host/vdir/s.svc/b"), false);  
+  
+```  
+  
+> [!NOTE]
+>  アドレスのホスト名部分は、クライアントで完全修飾ドメイン名、NetBIOS 名、IP アドレス、それ以外の名前のどれが使用されるかによって異なることがあります。異なる値が同じホストを参照している場合があるため、この比較の既定の動作では、照合の際にアドレスのホスト名部分は使用されません。  
+>   
+>  ルーティング サービスをプログラムで構成する際に、比較の際にホスト名を評価できるように、この動作を変更できます。  
+  
+ 受信メッセージが一意のアドレス宛てである場合は、このフィルターを使用する必要があります。  
+  
+### EndpointAddressPrefix  
+ EndpointAddressPrefix フィルターは、EndpointAddress フィルターに似ています。EndpointAddressPrefix フィルターは、メッセージを受信した EndpointAddress を確認します。ただし、EndpointAddressPrefix フィルターは、フィルター構成で指定された値で始まるアドレスを一致させることによって、ワイルドカードとして機能します。次の例で定義されている `FilterElement` では、EndpointAddressPrefix フィルターを使用して、http:\/\/\<hostname\>\/vdir\* 宛てのすべてのメッセージを一致させます。  
+  
+```xml  
+<filter name="prefix1" filterType="EndpointAddressPrefix" filterData="http://host/vdir" />  
+  
+```  
+  
+```csharp  
+PrefixEndpointAddressMessageFilter prefix1 = new PrefixEndpointAddressMessageFilter(new EndpointAddress("http://host/vdir/s.svc/b"), false);  
+  
+```  
+  
+> [!NOTE]
+>  アドレスのホスト名部分は、クライアントで完全修飾ドメイン名、NetBIOS 名、IP アドレス、それ以外の名前のどれが使用されるかによって異なることがあります。異なる値が同じホストを参照している場合があるため、この比較の既定の動作では、照合の際にアドレスのホスト名部分は使用されません。  
+  
+ 共通のアドレス プレフィックスを共有する受信メッセージをルーティングするときは、このフィルターを使用する必要があります。  
+  
+### AND  
+ AND フィルターが、メッセージ内の値を直接フィルターすることはありません。しかし、AND フィルターを使用すると、他の 2 つのフィルターを組み合わせて `AND` 条件を作成し、それらのフィルターの両方がメッセージと一致した場合に、AND フィルターが `true` に評価されるようにすることができます。これにより、すべてのサブフィルターが一致した場合にだけ一致する、複雑なフィルターを作成できます。次の例では、Address フィルターと Action フィルターを定義した後で、それらのフィルターの両方に照合してメッセージを評価する AND フィルターを定義します。Address フィルターと Action フィルターの両方と一致した場合、AND フィルターは `true` を返します。  
+  
+```xml  
+<filter name=”address1” filterType=”AddressPrefix” filterData=”http://host/vdir”/>  
+<filter name=”action1” filterType=”Action” filterData=”http://namespace/contract/operation/”/>  
+<filter name="and1" filterType="And" filter1="address1" filter2="action1" />  
+  
+```  
+  
+```csharp  
+EndpointAddressMessageFilter address1 = new EndpointAddressMessageFilter(new EndpointAddress("http://host/vdir/s.svc/b"), false);  
+ActionMessageFilter action1 = new ActionMessageFilter(new string[] { "http://namespace/contract/operation" });  
+StrictAndMessageFilter and1=new StrictAndMessageFilter(address1, action1);  
+  
+```  
+  
+ 複数のフィルターのロジックを組み合わせて一致を判断する必要がある場合は、このフィルターを使用します。たとえば、アクションとメッセージの特定の組み合わせだけを特定のアドレスに受け取る必要がある複数の送信先がある場合は、AND フィルターを使用して、必要な Action フィルターと Address フィルターを組み合わせることができます。  
+  
+### Custom  
+ Custom フィルターを選択する際には、このフィルターに使用する **MessageFilter** 実装を含むアセンブリの型を格納している、customType 値を指定する必要があります。また、filterData には、Custom フィルターがメッセージの評価に必要とするすべての値が格納されている必要があります。次の例では、`CustomAssembly.MyCustomMsgFilter` MessageFilter 実装を使用する `FilterElement` を定義します。  
+  
+```xml  
+<filter name="custom1" filterType="Custom" customType="CustomAssembly.MyCustomMsgFilter, CustomAssembly" filterData="Custom Data" />  
+  
+```  
+  
+```csharp  
+MyCustomMsgFilter custom1=new MyCustomMsgFilter(“Custom Data”);  
+```  
+  
+ [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] で提供されるフィルターでは対象とならない、メッセージに対するカスタムの一致ロジックを実行する必要がある場合は、**MessageFilter** クラスの実装であるカスタム フィルターを作成する必要があります。たとえば、受信メッセージ内の 1 つのフィールドを、構成としてフィルターに指定された既知の値のリストと比較するカスタム フィルターや、特定のメッセージ要素をハッシュしてから、その値を調査してフィルターが `true` と `false` のどちらを返すかを判断するカスタム フィルターを作成することができます。  
+  
+### EndpointName  
+ EndpointName フィルターは、メッセージを受信したエンドポイントの名前を確認します。次の例で定義する `FilterElement` は、EndpointName フィルターを使用して、SvcEndpoint で受信したメッセージをルーティングします。  
+  
+```xml  
+<filter name="name1" filterType="Endpoint" filterData="SvcEndpoint" />  
+  
+```  
+  
+```csharp  
+EndpointNameMessageFilter name1 = new EndpointNameMessageFilter("SvcEndpoint");  
+  
+```  
+  
+ このフィルターは、ルーティング サービスが複数の名前付きサービス エンドポイントを公開する場合に役立ちます。たとえば、ルーティング サービスがメッセージの受信に使用する 2 つのエンドポイントを公開し、その 1 つを、メッセージのリアルタイム処理を必要とする優先顧客が使用し、残りの 1 つを使用して、受信のタイミングが重要でないメッセージを受信する場合があります。  
+  
+ メッセージを受信したエンドポイントを特定する際に完全なアドレスの一致を使用することはよくありますが、定義されたエンドポイント名を使用すると、エラーの可能性が少なく、すばやく処理できるので便利です。特に、エンドポイント名が必須の属性となる、構成ファイルを使用したルーティング サービスの構成では、この方法が便利です。  
+  
+### MatchAll  
+ MatchAll フィルターは、受信したすべてのメッセージと一致します。受信したすべてのメッセージのコピーを格納するログ サービスの場合など、受信したすべてのメッセージを常に特定のエンドポイントにルーティングする必要がある場合は、このフィルターが便利です。次の例で定義する `FilterElement` では、MatchAll フィルターを使用します。  
+  
+```xml  
+<filter name="matchAll1" filterType="MatchAll" />  
+  
+```  
+  
+```csharp  
+MatchAllMessageFilter matchAll1 = new MatchAllMessageFilter();  
+  
+```  
+  
+### XPath  
+ XPath フィルターを使用すると、XPath クエリを指定して、メッセージ内の特定の要素を確認できます。XPath フィルターは、メッセージ内の XML アドレス指定可能なエントリを直接確認できる、強力なフィルター オプションです。ただし、このフィルターを使用するには、受信するメッセージの構造に関する特定の知識が必要です。次の例で定義する `FilterElement` は、XPath フィルターを使用して、名前空間プレフィックス ns で参照される名前空間内の element という名前の要素のメッセージを確認します。  
+  
+```xml  
+<filter name="xpath1" filterType="XPath" filterData="//ns:element" />  
+  
+```  
+  
+```csharp  
+XPathMessageFilter xpath1=new XPathMessageFilter(“//ns:element”);  
+  
+```  
+  
+ 受信するメッセージに特定の値が含まれていることがわかっている場合は、このフィルターが便利です。たとえば、同じサービスの 2 つのバージョンをホストしており、そのサービスの新しい方のバージョン宛てのメッセージのカスタム ヘッダーに一意の値が含まれていることがわかっている場合は、XPath を使用するフィルターを作成してそのヘッダーに移動し、そのヘッダー内にある値を、フィルター構成で指定されている別の値と比較して、そのフィルターが一致するかどうかを判断できます。  
+  
+ XPath クエリには、長い文字列値または複雑な文字列値である一意の名前空間が含まれていることが多いため、XPath フィルターでは、名前空間用の一意のプレフィックスを定義する名前空間テーブルを使用できます。名前空間テーブル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)」を参照してください。  
+  
+ XPath クエリの設計[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[XPath 構文](http://go.microsoft.com/fwlink/?LinkId=164592)」\(http:\/\/go.microsoft.com\/fwlink\/?LinkId\=164592\) を参照してください。  
+  
+## 参照  
+ [メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)   
+ [フィルターを使用する方法](../../../../docs/framework/wcf/feature-details/how-to-use-filters.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/choosing-a-message-encoder.md b/docs/framework/wcf/feature-details/choosing-a-message-encoder.md
new file mode 100644
index 00000000000..dc1b51e729a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/choosing-a-message-encoder.md
@@ -0,0 +1,84 @@
+---
+title: "メッセージ エンコーダーを選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2204d82d-d962-4922-a79e-c9a231604f19
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# メッセージ エンコーダーを選択する
+このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に用意されているメッセージ エンコーダー \(バイナリ、テキスト、および MTOM \(Message Transmission Optimization Mechanism\)\) を選択する際の基準について説明します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、エンドポイント間でネットワークを介して行うデータの転送方法を、*バインディング* \(*バインド要素*のシーケンスで構成\) により指定します。メッセージ エンコーダーは、バインディング スタックにあるメッセージ エンコーディング バインド要素によって表されます。バインディングには、オプションのプロトコル バインド要素 \(セキュリティ バインド要素や信頼できるメッセージング バインド要素など\)、必須のメッセージ エンコーディング バインド要素、および必須のトランスポート バインド要素が含まれます。  
+  
+ メッセージ エンコーディング バインド要素は、オプションのプロトコル バインド要素の下、必須のトランスポート バインド要素の上に位置します。送信側では、メッセージ エンコーダーにより出力 <xref:System.ServiceModel.Channels.Message> がシリアル化されてトランスポートに渡されます。受信側では、メッセージ エンコーダーがトランスポートからシリアル化形式の <xref:System.ServiceModel.Channels.Message> を受信し、上位のプロトコル層が存在する場合はその層に、存在しない場合はアプリケーションに渡します。  
+  
+ 既存のクライアントまたはサーバーに接続するときには、相手側が予測している方法でメッセージをエンコードする必要があるため、特定のメッセージ エンコーディングを選択できない場合があります。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成している場合は、サービスを複数のエンドポイントで公開し、それぞれで異なるメッセージ エンコーディングを使用できます。これにより、クライアントは最適なエンドポイントでのサービスとの対話に最も適したエンコーディングを選択でき、最適なエンコーディングを選択する際の柔軟性が得られます。複数のエンドポイントを使用することにより、異なるメッセージ エンコーディングの利点を他のバインド要素と組み合わせることも可能になります。  
+  
+## システム指定のエンコーダー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された 3 種類のメッセージ エンコーダーは、次の 3 つのクラスによって表されます。  
+  
+-   <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> は、書式なし XML エンコーディングと SOAP エンコーディングの両方をサポートするテキスト メッセージ エンコーダーです。テキスト メッセージ エンコーダーの書式なし XML エンコーディング モードは、テキスト ベースの SOAP エンコーディングと区別するために、"POX" \(Plain Old XML\) と呼ばれます。POX を有効にするには、<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement.MessageVersion%2A> プロパティを <xref:System.ServiceModel.Channels.MessageVersion.None%2A> に設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイント以外のエンドポイントと相互運用する場合は、テキスト メッセージ エンコーダーを使用します。  
+  
+-   <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> は、バイナリ メッセージ エンコーダーです。コンパクトなバイナリ形式を使用し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] との間の通信用に最適化されているため、相互運用できません。このエンコーダーは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された 3 種類のエンコーダーの中で、パフォーマンスが最も優れたエンコーダーでもあります。  
+  
+-   <xref:System.ServiceModel.Channels.MTOMMessageEncodingBindingElement> は、MTOM エンコーディングを使用して、メッセージの文字エンコーディングとバージョン管理を指定するバインド要素です。MTOM は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージでのバイナリ データの転送に有効なテクノロジです。MTOM エンコーダーは、効率と相互運用性のバランスをとろうとします。MTOM エンコーディングは、ほとんどの XML をテキスト形式で転送しますが、大きいサイズのバイナリ データ ブロックはテキストに変換せずにそのまま転送することによって最適化します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されたエンコーダーの中で、MTOM は効率面でテキスト エンコーダー \(最も遅い\) とバイナリ エンコーダー \(最も速い\) の中間に位置します。  
+  
+## メッセージ エンコーダーを選択する方法  
+ メッセージ エンコーダーを選択するために使用される一般的な要因を、次の表に示します。アプリケーションにとって重要な要因に優先順位を与えて、それらの要因に対して最適なメッセージ エンコーダーを選択します。この表には示されていないその他の要因と、アプリケーションで必要になることがあるカスタム メッセージ エンコーダーも考慮するようにしてください。  
+  
+|要因|説明|この要因をサポートするエンコーダー|  
+|--------|--------|-----------------------|  
+|サポートされている文字セット|<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> と <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> は Unicode の UTF8 と UTF16 \(*ビッグ エンディアン*と*リトル エンディアン*\) エンコーディングのみをサポートしています。UTF7 や ASCII など、別のエンコーディングが要求される場合はカスタム エンコーディングを使用する必要があります。カスタム エンコーディングの例については、「[カスタム メッセージ エンコーダー](http://go.microsoft.com/fwlink/?LinkId=119857)」を参照してください。|テキスト|  
+|検査|検査は、転送中にメッセージを調べる機能です。SOAP の使用に関係なく、テキスト エンコーディングでは、多くのアプリケーションで特別なツールを使用することなくメッセージの検査と分析が可能です。メッセージまたはトランスポートのいずれかのレベルで転送セキュリティを使用すると、メッセージの検査機能に影響がある点に注意してください。機密性はメッセージが検査されないように保護し、整合性はメッセージが変更されないように保護します。|テキスト|  
+|信頼性|信頼性は、転送エラーに対するエンコーダーの復元能力です。信頼性はメッセージ層、トランスポート層、またはアプリケーション層でも提供できます。すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 標準エンコーダーは、信頼性が別の層で提供されることを前提としています。エンコーダーは、転送エラーから回復する機能をほとんど備えていません。|なし|  
+|単純さ|単純さは、エンコード仕様に対応するエンコーダーとデコーダーの作成の容易さを表します。テキスト エンコーディングは、単純さの面で特に優れており、POX テキスト エンコーディングは SOAP 処理のサポートが不要なため、さらに優れています。|テキスト \(POX\)|  
+|サイズ|エンコーディングによって、コンテンツに課せられるオーバーヘッドの量が決まります。エンコードされたメッセージのサイズは、サービス操作の最大スループットに直接影響します。バイナリ エンコーディングは、一般にテキスト エンコーディングよりサイズが小さくなります。メッセージのサイズが優先事項である場合は、エンコーディング中にメッセージ コンテンツを圧縮することも検討してください。ただし、圧縮を行うとメッセージの送信者と受信者の両方で処理コストが大きくなります。|バイナリ|  
+|ストリーム|ストリーミングでは、アプリケーションはメッセージ全体が到着する前にメッセージの処理を開始できます。ストリーミングを効果的に使用するには、受信するアプリケーションが重要なデータの到着を待つ必要をなくすために、メッセージの冒頭で重要なデータが利用可能になっている必要があります。さらに、ストリーミングされた転送を使用するアプリケーションでは、メッセージ コンテンツに前方依存性がないように、メッセージ内のデータを順次編成していく必要があります。多くの場合、コンテンツのストリーミングと必要最小限のサイズで転送を行うこととの間で妥協を図る必要があります。|なし|  
+|サードパーティ製ツールのサポート|エンコーディングのサポート領域には、開発と診断があります。サードパーティの開発者は、POX 形式でエンコードされたメッセージを処理するためのライブラリとツールキットに多大な投資をしています。|テキスト \(POX\)|  
+|相互運用性|この要因は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のエンコーダーの、非 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとの相互運用性を表しています。|テキスト<br /><br /> MTOM \(部分的\)|  
+  
+ メモ: バイナリ エンコーダーを使用している場合、XMLReader を作成するときに IgnoreWhitespace の設定を使用しても効果はありません。たとえば、サービス操作内で次の操作を実行するとします。  
+  
+```csharp  
+public void OperationContract(XElement input)  
+        {  
+            Console.WriteLine("{0}", input.Value);  
+            int counter = 0;  
+            var xreader = input.CreateReader();  
+            var reader = XmlReader.Create(xreader, new XmlReaderSettings() { IgnoreWhitespace = true });  
+            while (reader.Read())  
+            {  
+                counter++;  
+            }  
+  
+            Console.WriteLine("Read {0} lines with reader", counter);  
+        }  
+  
+```  
+  
+ IgnoreWhitespace の設定は無視されます。  
+  
+## 圧縮およびバイナリ エンコーダー  
+ WCF 4.5 以降の WCF バイナリ エンコーダーでは、圧縮がサポートされます。これにより、WCF クライアントから圧縮メッセージを送信するための gzip\/deflate アルゴリズムを使用でき、さらに自己ホスト型 WCF サービスからの圧縮メッセージに応答することができます。この機能は、HTTP トランスポートおよび TCP トランスポートの両方で圧縮を有効にします。IIS のホスト サーバーを構成することによって、いつでも IIS でホストされる WCF サービスを有効にして圧縮された応答を送信できます。圧縮の種類は <xref:System.ServiceModel.Channels.BinaryMessageEncodingElement.CompressionFormat%2A> プロパティで構成されます。このプロパティは、<xref:System.ServiceModel.Channels.CompressionFormat> 列挙値のいずれかに設定されます。  
+  
+|CompressionFormat の値|説明|  
+|--------------------------|--------|  
+|F:System.ServiceModel.Channels.CompressionFormat.Deflate|Deflate 圧縮を使用します。|  
+|F:System.ServiceModel.Channels.CompressionFormat.GZip|GZip 圧縮を使用します。|  
+|F:System.ServiceModel.Channels.CompressionFormat.None|圧縮を使用しません。|  
+  
+ このプロパティは binaryMessageEncodingBindingElement でのみ公開されるため、この機能を使用するには、\<customBinding\>        \<binding name\="BinaryCompressionBinding"\>          \<binaryMessageEncoding compressionFormat \="GZip"\/\>          \<httpTransport \/\>        \<\/binding\>      \<\/customBinding\> のようなカスタム バインディングを作成する必要があります。クライアントとサービスの両方で圧縮メッセージの送受信に同意する必要があるため、compressionFormat プロパティは、クライアントとサービスの両方の binaryMessageEncoding 要素で構成する必要があります。サービスまたはクライアントの一方で圧縮が構成され、他方で圧縮が構成されていない場合は ProtocolException がスローされます。圧縮の有効化は慎重に考慮する必要があります。圧縮は、ネットワーク帯域幅がボトルネックになっている場合に最も効果的できます。CPU がボトルネックである場合、圧縮によりスループットが低下します。これがアプリケーションにとってメリットがあるかどうかを確認するために、適切なテストをシミュレートされた環境で行う必要があります。  
+  
+## 参照  
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/choosing-a-transport.md b/docs/framework/wcf/feature-details/choosing-a-transport.md
new file mode 100644
index 00000000000..51b7e2cff87
--- /dev/null
+++ b/docs/framework/wcf/feature-details/choosing-a-transport.md
@@ -0,0 +1,83 @@
+---
+title: "トランスポートの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランスポートの選択 [WCF]"
+ms.assetid: b169462b-f7b6-4cf4-9fca-d306909ee8bf
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# トランスポートの選択
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に用意されている HTTP、TCP、名前付きパイプという 3 つの主なトランスポートの中から、1 つのトランスポートを選択する基準について説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、メッセージ キュー \(MSMQ とも呼ばれます\) トランスポートも用意されていますが、メッセージ キューは、ここでは取り扱いません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルでは、エンドポイントの操作 \(サービス コントラクトで表現されたとおりの\) を 2 つのエンドポイントを接続するトランスポート機構から分離します。これによって、ネットワークへのサービスの公開方法を柔軟に決定できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、エンドポイント間でネットワークを介して行うデータの転送方法を、*バインディング* \(*バインド要素*のシーケンスで構成\) を使用して指定します。トランスポートは、バインディングの一部であるトランスポート バインド要素で表されます。バインディングにはセキュリティなどのオプションのプロトコル バインド要素、必須のメッセージ エンコーダーのバインド要素、および必須のトランスポートのバインド要素が含まれます。トランスポートは、シリアル化されたメッセージを別のアプリケーションとの間で送受信します。  
+  
+ 既存のクライアントまたはサーバーに接続する必要がある場合、特定のトランスポートを使用するという選択ができない可能性があります。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、それぞれが異なるトランスポートを使用する複数のエンドポイントからアクセスできるようにすることができます。単一のトランスポートでサービスの提供対象に対応できない場合、複数のエンドポイントにサービスを公開することを検討してください。複数のエンドポイントに公開すると、クライアント アプリケーションはそのアプリケーションに最も適したエンドポイントを使用できます。  
+  
+ トランスポートを選択した後、そのトランスポートを使用するバインディングを選択する必要があります。システム指定のバインディング \(「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照\) を選択するか、カスタム バインディング \(「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照\) を作成できます。独自のバインディングを作成することもできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md).  
+  
+## 各トランスポートの利点  
+ ここでは、3 つの主なトランスポートの中から 1 つを選択する主な理由について説明します。また、トランスポートの選択に使用できる詳細な表も記載しています。  
+  
+### HTTP トランスポートを使用する状況  
+ HTTP は、クライアントとサーバー間の要求\/応答プロトコルです。最も一般的なアプリケーションは、Web サーバーと通信する Web ブラウザー クライアントで構成されます。クライアントは、クライアントの要求メッセージをリッスンしているサーバーに要求を送信します。サーバーは要求を受信すると、要求のステータスを含んだ応答を返します。成功した場合は、Web ページ、エラー メッセージ、その他の情報など、任意のデータが返されます。HTTP プロトコル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[HTTP \- Hypertext Transfer Protocol](http://go.microsoft.com/fwlink/?LinkId=94858)」を参照してください。  
+  
+ HTTP プロトコルは、接続ベースではありません。応答の送信後、状態は維持されません。複数ページ トランザクションを処理するには、アプリケーションが、必要な状態を維持する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、HTTP トランスポート バインディングは、従来の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のシステムとの相互運用性を実現するために最適化されています。すべての通信相手が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用している場合は、TCP ベースまたは名前付きパイプベースのバインディングの方が高速です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「<xref:System.ServiceModel.NetTcpBinding>」および「<xref:System.ServiceModel.NetNamedPipeBinding>」を参照してください。  
+  
+### TCP トランスポートを使用する状況  
+ TCP は、エンドツーエンドのエラー検出とエラー訂正を備えた接続ベースのストリーム指向配信サービスです。*接続ベース*とは、ホスト間の通信セッションがデータを交換する前に確立されるという意味です。ホストは、TCP\/IP ネットワーク上で論理 IP アドレスによって識別される任意のデバイスです。  
+  
+ TCP は使いやすく、TCP によって信頼できるデータ配信を実現できます。特に、TCP は、送信者にパケット配信を通知し、送信者が送信した順序と同じ順序でパケットが配信されることを保証し、紛失したパケットを再転送し、データ パケットが重複していないことを確認します。この信頼できる配信は、*WS\-ReliableMessaging* の場合と異なり、2 つの TCP\/IP ノード間に適用されます。WS\-ReliableMessaging は、エンドポイントに伴う中継局ノードの数に関係なく、エンドポイント間に適用されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] TCP トランスポートは、通信の両側が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用するシナリオのために最適化されています。このバインディングは、異なるコンピューター間での通信が発生するシナリオに対して最も速い [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングです。メッセージ交換では、<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> を使用して、メッセージ転送の最適化を実現します。TCP では双方向通信が提供されるので、クライアントがネットワーク アドレス交換 \(NAT\) の内側にある場合でも、TCP を使用して双方向コントラクトを実装できます。  
+  
+### 名前付きパイプ トランスポートを使用する状況  
+ 名前付きパイプとは、プロセスが通信に使用できる共有メモリのセクションなど、Windows オペレーティング システム カーネルのオブジェクトです。名前付きパイプには名前があり、1 台のコンピューター上でのプロセス間の一方向通信または双方向通信に使用できます。  
+  
+ 1 台のコンピューター上で異なる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション間に通信が必要で、他のコンピューターからの通信を防止する場合に、名前付きパイプ トランスポートを使用します。追加の制限として、Windows リモート デスクトップから実行しているプロセスを同じ Windows リモート デスクトップのセッションに制限することができます。ただし、そのプロセスにシステム特権がある場合を除きます。  
+  
+> [!WARNING]
+>  名前付きパイプ トランスポートを使用する際、IIS でホストされている複数サイト上で弱いワイルドカードの URL 予約を指定すると、"サイト '2' をリッスンしようとしているときに、プロトコル 'net.pipe' のアクティブ化サービス 'NetPipeActivator' でエラーが発生したため、このサイトのプロトコルが一時的に無効になっています。詳細については、例外メッセージを参照してください。URL: WeakWildcard:net.pipe:\/\<machine name\>\/ 状態: ConflictingRegistration 例外: プロセス名: SMSvcHost プロセス ID: 1076\\" というエラーが発生することがあります。  
+  
+## トランスポート選択の判断材料  
+ トランスポートの選択に使用する一般的な判断材料を次の表に示します。アプリケーションに適用される追加の属性とトランスポートについて考慮する必要があります。アプリケーションに重要な属性を特定し、各属性と相性の良いトランスポートを特定し、最後にその属性セットで最も適切に機能するトランスポートを選択します。  
+  
+|属性|説明|望ましいトランスポート|  
+|--------|--------|-----------------|  
+|診断|診断によって、トランスポートの接続問題を自動的に検出できます。すべてのトランスポートは、接続に関するエラー情報を返信する機能をサポートしています。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、ネットワークに関する問題を調査するための診断ツールは用意されていません。|なし|  
+|ホスト|すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、アプリケーション内部でホストされる必要があります。[!INCLUDE[iis601](../../../../includes/iis601-md.md)] 以前では、HTTP トランスポートを使用するアプリケーションのホストだけがサポートされます。[!INCLUDE[wv](../../../../includes/wv-md.md)] では、TCP と名前付きパイプを含むすべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランスポートのホストがサポートされます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[インターネット インフォメーション サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)」および「[Windows プロセス アクティブ化サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)」を参照してください。|HTTP|  
+|検査|検査は、転送中に、メッセージからの情報を抽出し、処理する機能です。HTTP プロトコルでは、ルーティングと制御情報がデータから分離されるので、メッセージを調査して分析するツールの作成が容易になります。検査しやすいトランスポートでは、ネットワーク機器に求められる処理能力も低い場合があります。使用するセキュリティのレベルは、メッセージを調査できるかどうかに影響を与えます。|HTTP|  
+|待ち時間|待ち時間は、メッセージの交換を完了するために必要な最小限の時間です。すべてのネットワーク操作には、選択したトランスポートに応じて、多少の待ち時間が発生します。HTTP など、ネイティブ メッセージ交換パターンが要求\/応答であるトランスポートで双方向または一方向通信を使用すると、メッセージの強制的な関連付けが原因で追加の待ち時間が発生する可能性があります。このような場合、TCP など、ネイティブ メッセージ交換パターンが双方向であるトランスポートを使用することを検討してください。|TCP、名前付き<br /><br /> パイプ|  
+|範囲|トランスポートの範囲は、トランスポートが他のシステムと接続できる能力を反映しています。名前付きパイプ トランスポートの範囲は非常に狭く、同じコンピューター上で実行しているサービスにしか接続できません。TCP トランスポートと HTTP トランスポートの範囲は広く、一部の NAT とファイアウォール構成を通ることができます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][NAT とファイアウォールの使用](../../../../docs/framework/wcf/feature-details/working-with-nats-and-firewalls.md).|HTTP、TCP|  
+|セキュリティ|セキュリティは、機密性、整合性、または認証を提供することによって、転送中にメッセージを保護する機能です。機密性では、メッセージが調査されないように保護し、整合性では、メッセージが変更されないように保護します。認証では、メッセージの送信者または受信者が本物であることを保証します。<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、メッセージ レベルとトランスポート レベルの両方で転送セキュリティをサポートします。トランスポートがバッファー転送モードをサポートする場合、メッセージ セキュリティはそのトランスポートで構成されます。トランスポート セキュリティのサポートは、選択したトランスポートによって異なります。HTTP、TCP、および名前付きパイプの各トランスポートは、トランスポート セキュリティに対して同等の適切なサポートを提供します。|すべて|  
+|スループット|スループットは、指定の期間内に送信し、処理できるデータの量を示します。待ち時間のように、選択したトランスポートが、サービス操作のスループットに影響する場合があります。トランスポートのスループットを最大にするには、コンテンツを送信するときのオーバーヘッドおよびメッセージ交換が完了するまでの待ち時間を最小限に抑えることが必要です。TCP トランスポートと名前付きパイプ トランスポートは、メッセージ本文に対するオーバーヘッドが小さく、メッセージ応答の待ち時間を短縮するネイティブ双方向パターンをサポートします。|TCP、名前付きパイプ|  
+|ツール|ツールは、開発、診断、ホスティング、およびその他のアクティビティに関する、サードパーティ アプリケーションによるプロトコルへのサポートを表します。HTTP プロトコルで動作するツールとソフトウェアの開発には、大規模な投資が行われています。|HTTP|  
+  
+## 参照  
+ <xref:System.ServiceModel.BasicHttpBinding>   
+ <xref:System.ServiceModel.WsHttpBinding>   
+ <xref:System.ServiceModel.WsDualHttpBinding>   
+ <xref:System.ServiceModel.WsFederationHttpBinding>   
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>   
+ <xref:System.ServiceModel.NetTcpBinding>   
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement>   
+ <xref:System.ServiceModel.NetNamedPipeBinding>   
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>   
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/claim-creation-and-resource-values.md b/docs/framework/wcf/feature-details/claim-creation-and-resource-values.md
new file mode 100644
index 00000000000..90a3f316b67
--- /dev/null
+++ b/docs/framework/wcf/feature-details/claim-creation-and-resource-values.md
@@ -0,0 +1,55 @@
+---
+title: "クレームの作成とリソース値 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クレーム [WCF], 作成とリソース値"
+ms.assetid: 30431f76-cbe7-4bad-bad7-8e43e23a82d4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# クレームの作成とリソース値
+<xref:System.IdentityModel.Claims.Claim> クラスには、組み込みのクレームの種類のインスタンスを作成するためのメソッドが複数用意されています。これらのメソッドの中でも、次のものは指定されたリソースに対してセマンティックまたは形式のチェックを行いません。  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateDnsClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateHashClaim%2A> \(長さまたはバイト配列のコンテンツは検査されません\)  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateNameClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateSpnClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateThumbprintClaim%2A> \(長さまたはバイト配列のコンテンツは検査されません\)  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateUpnClaim%2A>  
+  
+ 上記のメソッドを使用する場合は、渡されるリソース値が正しい形式である、または正しい情報を含んでいること \(あるいは両方\) を確認するように注意してください。  
+  
+ 次のメソッドは、特定の型を受け取ります。  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateDenyOnlyWindowsSidClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateMailAddressClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateRsaClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateUriClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateWindowsSidClaim%2A>  
+  
+-   <xref:System.IdentityModel.Claims.Claim.CreateX500DistinguishedNameClaim%2A>  
+  
+## 参照  
+ <xref:System.IdentityModel.Claims.Claim>   
+ <xref:System.IdentityModel.Claims.ClaimSet>   
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/claims-and-denying-access-to-resources.md b/docs/framework/wcf/feature-details/claims-and-denying-access-to-resources.md
new file mode 100644
index 00000000000..277e1635f8c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/claims-and-denying-access-to-resources.md
@@ -0,0 +1,28 @@
+---
+title: "リソースへのアクセスのクレームと拒否 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クレーム [WCF], リソースへのアクセスの拒否"
+ms.assetid: 145ebb41-680e-4256-b14c-1efb4af1e982
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# リソースへのアクセスのクレームと拒否
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はクレーム ベースの承認機構をサポートします。クレームの有無に応じてリソースへのアクセスが許可されるばかりでなく、クレームの有無に応じてリソースへのアクセスがシステムによって拒否される場合もよくあります。このようなシステムでは、アクセスが許可された要求を探す前に、アクセスが拒否されたクレームの <xref:System.IdentityModel.Policy.AuthorizationContext> を調べる必要があります。  
+  
+ たとえば、`Age` 型、<xref:System.IdentityModel.Claims.Rights.PossessProperty%2A> 権限、`Under 21` リソース値というクレームを持つ任意のユーザーに対してリソースへのアクセスを拒否し、ID が `Name` 型、<xref:System.IdentityModel.Claims.Rights.Identity%2A> 権限、`Mallory` リソース値というクレームを持っている場合にのみ、リソースへのアクセスを許可するとします。言い換えると、年齢が 21 歳以下の任意のユーザーはシステムによってアクセスが拒否され、名前が Mallory である任意のユーザーにはアクセスが許可されるようにします。この意味を正しく実装するには、`Age` クレームを最初に探して、ユーザーが 21 歳以下であるかどうかを判断することが重要です。そうしないと、Mallory が 21 歳以下である場合、このリソースには、`Name` クレームのみに基づいてアクセスが許可されてしまいます。  
+  
+## 参照  
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)   
+ [クレームとトークン](../../../../docs/framework/wcf/feature-details/claims-and-tokens.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/claims-and-tokens.md b/docs/framework/wcf/feature-details/claims-and-tokens.md
new file mode 100644
index 00000000000..e524a99c304
--- /dev/null
+++ b/docs/framework/wcf/feature-details/claims-and-tokens.md
@@ -0,0 +1,79 @@
+---
+title: "クレームとトークン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クレーム [WCF], トークン"
+ms.assetid: eff167f3-33f8-483d-a950-aa3e9f97a189
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# クレームとトークン
+ここでは、サポートされている既定のトークンから [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] によって作成されるさまざまなクレームの種類について説明します。  
+  
+ クライアント資格情報のクレームは、<xref:System.IdentityModel.Claims.ClaimSet> クラスと <xref:System.IdentityModel.Claims.Claim> クラスを使用して確認できます。  `ClaimSet` には、`Claim` オブジェクトのコレクションが格納されます。  各 `Claim` には、次の重要なメンバーがあります。  
+  
+-   <xref:System.IdentityModel.Claims.Claim.ClaimType%2A> プロパティは、作成されるクレームの種類を指定する URI \(Uniform Resource Identifier\) を返します。  たとえば、クレームの種類が証明書の拇印の場合、その URI は http:schemas.microsoft.com\/ws\/20005\/05\/identity\/claims\/thumprint です。  
+  
+-   <xref:System.IdentityModel.Claims.Claim.Right%2A> プロパティは、クレームの権限を指定する URI を返します。  定義済みの権限は、<xref:System.IdentityModel.Claims.Rights> クラスにあります \(<xref:System.IdentityModel.Claims.Rights.Identity%2A>、<xref:System.IdentityModel.Claims.Rights.PossessProperty%2A>\)。  
+  
+-   <xref:System.IdentityModel.Claims.Claim.Resource%2A> プロパティは、クレームに関連付けられているリソースを返します。  
+  
+ 各 <xref:System.IdentityModel.Claims.ClaimSet> には、<xref:System.IdentityModel.Claims.ClaimSet.Issuer%2A> プロパティがあり、それぞれ `Issuer` の <xref:System.IdentityModel.Claims.ClaimSet> を表します。  
+  
+## Windows アカウント  
+ クライアント資格情報が Windows ユーザー アカウントにマップされる場合、<xref:System.IdentityModel.Claims.ClaimSet> は次の値を格納します。  
+  
+-   `Issuer` は、<xref:System.IdentityModel.Claims.ClaimSet> クラスの静的 Windows プロパティによって返される値です。  
+  
+-   コレクションには次のクレームがあります。  
+  
+    -   <xref:System.IdentityModel.Claims.Claim.ClaimType%2A> 値がセキュリティ識別子 \(SID\)、<xref:System.IdentityModel.Claims.Claim.Right%2A> プロパティ値が `Identity` で、<xref:System.IdentityModel.Claims.Claim.Resource%2A> が実際の SID 値を返す <xref:System.IdentityModel.Claims.Claim>。  SID は、ドメイン コントローラーによって各ユーザーに発行される一意の値です。  SID は、Windows セキュリティとの対話でユーザーを識別するために使用されます。  
+  
+    -   <xref:System.IdentityModel.Claims.Claim.ClaimType%2A> 値 が SID、<xref:System.IdentityModel.Claims.Claim.Right%2A> が `PossessProperty` で、<xref:System.IdentityModel.Claims.Claim.Resource%2A> が SID 値の <xref:System.IdentityModel.Claims.Claim>。  
+  
+    -   <xref:System.IdentityModel.Claims.Claim.ClaimType%2A> が <xref:System.IdentityModel.Claims.ClaimTypes.Name%2A>、<xref:System.IdentityModel.Claims.Claim.Right%2A> が `PossessProperty` で、<xref:System.IdentityModel.Claims.Claim.Resource%2A> がユーザー名 \(たとえば、"MYMACHINE\\Bob"\) を含んだ文字列である <xref:System.IdentityModel.Claims.Claim>。  
+  
+    -   ユーザーが属するさまざまなグループの <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A> が指定された追加の SID クレーム。  
+  
+## 証明書  
+ クライアント資格情報が証明書の場合、<xref:System.IdentityModel.Claims.ClaimSet> は次の値を格納します。  
+  
+-   自己発行証明書の場合、`Issuer` は <xref:System.IdentityModel.Claims.ClaimSet> です。  <xref:System.IdentityModel.Claims.ClaimSet> は、<xref:System.IdentityModel.Claims.ClaimTypes.Thumbprint%2A> に設定された <xref:System.IdentityModel.Claims.Claim.ClaimType%2A>、`Identity` に設定された <xref:System.IdentityModel.Claims.Claim.Right%2A>、および証明書の拇印を含んだ <xref:System.Byte> 配列である <xref:System.IdentityModel.Claims.Claim.Resource%2A> 値を返します。  
+  
+-   証明機関によって発行された証明書の場合、発行者は、証明機関の証明書を表す `ClaimSet` です。  
+  
+-   コレクションの `Claims` には次のものが含まれます。  
+  
+    -   `ClaimType` が Thumbprint、`Right` が PossessProperty で、`Resource` が証明書の拇印を含んだバイト配列である `Claim`。  
+  
+    -   証明書のさまざまなプロパティを表す X500DistinguishedName、Dns、Name、Upn、Rsa などの複数の種類の追加の PossessProperty クレーム。  Rsa クレームのリソースは、証明書に関連付けられた公開キーです。**メモ** クライアント資格情報の種類が、サービスによって Windows アカウントにマップされる証明書の場合、2 つの `ClaimSet` オブジェクトが生成されます。  最初のオブジェクトには、Windows アカウントに関するすべてのクレームが入り、2 番目のオブジェクトには、証明書に関するすべてのクレームが入ります。  
+  
+## ユーザー名\/パスワード  
+ クライアント資格情報が、Windows アカウントにマップされないユーザー名とパスワード \(または同等のもの\) の場合、`ClaimSet` は、`ClaimSet` クラスの静的 <xref:System.IdentityModel.Claims.ClaimSet.System%2A> プロパティによって発行されます。  `ClaimSet` は、リソースがクライアントによって提供されるユーザー名である <xref:System.IdentityModel.Claims.ClaimTypes.Name%2A> 型の `Identity` クレームを格納します。  対応するクレームには、`PossessProperty` の`Right` があります。  
+  
+## RSA キー  
+ 証明書に関連付けられていない RSA キーが使用される場合、`ClaimSet` は、自己発行され、リソースが RSA キーである <xref:System.IdentityModel.Claims.ClaimTypes.Rsa%2A> 型の `Identity` クレームを格納します。  対応するクレームには、`PossessProperty` の `Right` があります。  
+  
+## SAML  
+ クライアントが SAML \(Security Assertions Markup Language\) トークンを使用して認証する場合、`ClaimSet` は、SAML トークンを署名したエンティティ \(通常は、SAML トークンを発行したセキュリティ トークン サービス \(STS\) の証明書\) によって発行されます。  `ClaimSet` は、SAML トークンに含まれているとおりのさまざまなクレームを格納します。  SAML トークンが、名前が `null` 以外の `SamlSubject` を含んでいる場合、型が <xref:System.IdentityModel.Claims.ClaimTypes.NameIdentifier%2A> で、リソース型が <xref:System.IdentityModel.Tokens.SamlNameIdentifierClaimResource> の `Identity` クレームが作成されます。  
+  
+## Identity クレームと ServiceSecurityContext.IsAnonymous  
+ クライアント資格情報から生成された `ClaimSet` オブジェクトが、`Right` が `Identity` のクレームを格納していない場合、<xref:System.ServiceModel.ServiceSecurityContext.IsAnonymous%2A> プロパティは `true` を返します。  このようなクレームが 1 つ以上ある場合、`IsAnonymous` プロパティは `false` を返します。  
+  
+## 参照  
+ <xref:System.IdentityModel.Claims.ClaimSet>   
+ <xref:System.IdentityModel.Claims.Claim>   
+ <xref:System.IdentityModel.Claims.Rights>   
+ <xref:System.IdentityModel.Claims.ClaimTypes>   
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md b/docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md
new file mode 100644
index 00000000000..ecfb4d13e58
--- /dev/null
+++ b/docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md
@@ -0,0 +1,297 @@
+---
+title: "探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62b41a75-cf40-4c52-a842-a5f1c70e247f
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法
+これは、探索プロキシの実装方法に関する 3 つのトピックのうちの、3 番目のトピックです。前のトピック「[探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)」では、探索プロキシに自らを登録する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実装しました。このトピックでは、探索プロキシを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを検索する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成します。  
+  
+### クライアントの実装  
+  
+1.  新しいコンソール アプリケーション プロジェクトを、`Client` という `DiscoveryProxyExample` ソリューションに追加します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.ServiceModel  
+  
+    2.  System.ServiceModel.Discovery  
+  
+3.  このトピックの最後にある GeneratedClient.cs をプロジェクトに追加します。  
+  
+    > [!NOTE]
+    >  このファイルは、通常、Svcutil.exe などのツールを使用して生成されます。このトピックでは、作業を単純化するためにこのファイルを提供しています。  
+  
+4.  Program.cs ファイルを開き、次のメソッドを追加します。このメソッドは、引数で指定されたエンドポイント アドレスを使用して、サービス クライアント \(プロキシ\) を初期化します。  
+  
+    ```  
+    static void InvokeCalculatorService(EndpointAddress endpointAddress)  
+            {  
+                // Create a client  
+                CalculatorServiceClient client = new CalculatorServiceClient(new NetTcpBinding(), endpointAddress);  
+                Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress.Uri);  
+                Console.WriteLine();  
+  
+                double value1 = 100.00D;  
+                double value2 = 15.99D;  
+  
+                // Call the Add service operation.  
+                double result = client.Add(value1, value2);  
+                Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Subtract service operation.  
+                result = client.Subtract(value1, value2);  
+                Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Multiply service operation.  
+                result = client.Multiply(value1, value2);  
+                Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Divide service operation.  
+                result = client.Divide(value1, value2);  
+                Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+                Console.WriteLine();  
+  
+                // Closing the client gracefully closes the connection and cleans up resources  
+                client.Close();  
+            }  
+  
+    ```  
+  
+5.  `Main` メソッドに次のコードを追加します。  
+  
+    ```  
+    public static void Main()  
+            {  
+                // Create a DiscoveryEndpoint that points to the DiscoveryProxy  
+                Uri probeEndpointAddress = new Uri("net.tcp://localhost:8001/Probe");  
+                DiscoveryEndpoint discoveryEndpoint = new DiscoveryEndpoint(new NetTcpBinding(), new EndpointAddress(probeEndpointAddress));  
+  
+                // Create a DiscoveryClient passing in the discovery endpoint  
+                DiscoveryClient discoveryClient = new DiscoveryClient(discoveryEndpoint);  
+  
+                Console.WriteLine("Finding ICalculatorService endpoints using the proxy at {0}", probeEndpointAddress);  
+                Console.WriteLine();  
+  
+                try  
+                {  
+                    // Search for services that implement ICalculatorService              
+                    FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculatorService)));  
+  
+                    Console.WriteLine("Found {0} ICalculatorService endpoint(s).", findResponse.Endpoints.Count);  
+                    Console.WriteLine();  
+  
+                    // Check to see if endpoints were found, if so then invoke the service.  
+                    if (findResponse.Endpoints.Count > 0)  
+                    {  
+                        InvokeCalculatorService(findResponse.Endpoints[0].Address);  
+                    }  
+                }  
+                catch (TargetInvocationException)  
+                {  
+                    Console.WriteLine("This client was unable to connect to and query the proxy. Ensure that the proxy is up and running.");  
+                }  
+  
+                Console.WriteLine("Press <ENTER> to exit.");  
+                Console.ReadLine();  
+            }  
+  
+    ```  
+  
+ これで、クライアント アプリケーションの実装が完了しました。次に、「[探索プロキシをテストする方法](../../../../docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md)」に進みます。  
+  
+## 使用例  
+ このトピックのコード全体の一覧を以下に示します。  
+  
+```  
+// GeneratedClient.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+//------------------------------------------------------------------------------  
+// <auto-generated>  
+//     This code was generated by a tool.  
+//     Runtime Version:2.0.50727.1434  
+//  
+//     Changes to this file may cause incorrect behavior and will be lost if  
+//     the code is regenerated.  
+// </auto-generated>  
+//------------------------------------------------------------------------------  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]  
+    [System.ServiceModel.ServiceContractAttribute(Namespace = "http://Microsoft.Samples.Discovery", ConfigurationName = "ICalculatorService")]  
+    public interface ICalculatorService  
+    {  
+  
+        [System.ServiceModel.OperationContractAttribute(ProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign, Action = "http://Microsoft.Samples.Discovery/ICalculatorService/Add", ReplyAction = "http://Microsoft.Samples.Discovery/ICalculatorService/AddResponse")]  
+        double Add(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(ProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign, Action = "http://Microsoft.Samples.Discovery/ICalculatorService/Subtract", ReplyAction = "http://Microsoft.Samples.Discovery/ICalculatorService/SubtractResponse")]  
+        double Subtract(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(ProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign, Action = "http://Microsoft.Samples.Discovery/ICalculatorService/Multiply", ReplyAction = "http://Microsoft.Samples.Discovery/ICalculatorService/MultiplyResponse")]  
+        double Multiply(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(ProtectionLevel = System.Net.Security.ProtectionLevel.EncryptAndSign, Action = "http://Microsoft.Samples.Discovery/ICalculatorService/Divide", ReplyAction = "http://Microsoft.Samples.Discovery/ICalculatorService/DivideResponse")]  
+        double Divide(double n1, double n2);  
+    }  
+  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]  
+    public interface ICalculatorServiceChannel : ICalculatorService, System.ServiceModel.IClientChannel  
+    {  
+    }  
+  
+    [System.Diagnostics.DebuggerStepThroughAttribute()]  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]  
+    public partial class CalculatorServiceClient : System.ServiceModel.ClientBase<ICalculatorService>, ICalculatorService  
+    {  
+  
+        public CalculatorServiceClient()  
+        {  
+        }  
+  
+        public CalculatorServiceClient(string endpointConfigurationName) :  
+            base(endpointConfigurationName)  
+        {  
+        }  
+  
+        public CalculatorServiceClient(string endpointConfigurationName, string remoteAddress) :  
+            base(endpointConfigurationName, remoteAddress)  
+        {  
+        }  
+  
+        public CalculatorServiceClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :  
+            base(endpointConfigurationName, remoteAddress)  
+        {  
+        }  
+  
+        public CalculatorServiceClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :  
+            base(binding, remoteAddress)  
+        {  
+        }  
+  
+        public double Add(double n1, double n2)  
+        {  
+            return base.Channel.Add(n1, n2);  
+        }  
+  
+        public double Subtract(double n1, double n2)  
+        {  
+            return base.Channel.Subtract(n1, n2);  
+        }  
+  
+        public double Multiply(double n1, double n2)  
+        {  
+            return base.Channel.Multiply(n1, n2);  
+        }  
+  
+        public double Divide(double n1, double n2)  
+        {  
+            return base.Channel.Divide(n1, n2);  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// Program.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Reflection;  
+using System.ServiceModel;  
+using System.ServiceModel.Discovery;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    class Client  
+    {  
+        public static void Main()  
+        {  
+            // Create a DiscoveryEndpoint that points to the DiscoveryProxy  
+            Uri probeEndpointAddress = new Uri("net.tcp://localhost:8001/Probe");  
+            DiscoveryEndpoint discoveryEndpoint = new DiscoveryEndpoint(new NetTcpBinding(), new EndpointAddress(probeEndpointAddress));  
+  
+            DiscoveryClient discoveryClient = new DiscoveryClient(discoveryEndpoint);  
+  
+            Console.WriteLine("Finding ICalculatorService endpoints using the proxy at {0}", probeEndpointAddress);  
+            Console.WriteLine();  
+  
+            try  
+            {  
+                // Find ICalculatorService endpoints              
+                FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculatorService)));  
+  
+                Console.WriteLine("Found {0} ICalculatorService endpoint(s).", findResponse.Endpoints.Count);  
+                Console.WriteLine();  
+  
+                // Check to see if endpoints were found, if so then invoke the service.  
+                if (findResponse.Endpoints.Count > 0)  
+                {  
+                    InvokeCalculatorService(findResponse.Endpoints[0].Address);  
+                }  
+            }  
+            catch (TargetInvocationException)  
+            {  
+                Console.WriteLine("This client was unable to connect to and query the proxy. Ensure that the proxy is up and running.");  
+            }  
+  
+            Console.WriteLine("Press <ENTER> to exit.");  
+            Console.ReadLine();  
+        }  
+  
+        static void InvokeCalculatorService(EndpointAddress endpointAddress)  
+        {  
+            // Create a client  
+            CalculatorServiceClient client = new CalculatorServiceClient(new NetTcpBinding(), endpointAddress);  
+            Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress.Uri);  
+            Console.WriteLine();  
+  
+            double value1 = 100.00D;  
+            double value2 = 15.99D;  
+  
+            // Call the Add service operation.  
+            double result = client.Add(value1, value2);  
+            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Subtract service operation.  
+            result = client.Subtract(value1, value2);  
+            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Multiply service operation.  
+            result = client.Multiply(value1, value2);  
+            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Divide service operation.  
+            result = client.Divide(value1, value2);  
+            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+            Console.WriteLine();  
+  
+            // Closing the client gracefully closes the connection and cleans up resources  
+            client.Close();  
+        }  
+    }  
+}  
+```  
+  
+## 参照  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [探索プロキシを実装する方法](../../../../docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md)   
+ [探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/client-architecture.md b/docs/framework/wcf/feature-details/client-architecture.md
new file mode 100644
index 00000000000..82c46de538f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/client-architecture.md
@@ -0,0 +1,69 @@
+---
+title: "クライアント アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02624403-0d77-41cb-9a86-ab55e98c7966
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# クライアント アーキテクチャ
+アプリケーションは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント オブジェクトを使用してサービス操作を呼び出します。このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクト、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネル、およびこれらとその基になるチャネル アーキテクチャのリレーションシップについて説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトの概要については、「[WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)」を参照してください。チャネル レイヤー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[チャネル レイヤーの拡張](../../../../docs/framework/wcf/extending/extending-the-channel-layer.md)」を参照してください。  
+  
+## 概要  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントはサービス モデル ランタイムによって作成されます。クライアントは次の要素から構成されます。  
+  
+-   自動的に生成される、サービス コントラクトのクライアント実装。これは、アプリケーション コードからの呼び出しを送信メッセージに変換すると共に、応答メッセージを出力パラメーターに変換して、アプリケーションが取得できる値を返します。  
+  
+-   コントロール インターフェイス \(<xref:System.ServiceModel.IClientChannel?displayProperty=fullName>\) の実装。これは、さまざまなインターフェイスをグループ化し、コントロールの機能 \(特に、クライアント セッションの終了機能とチャネルの破棄機能\) へのアクセスを提供します。  
+  
+-   クライアント チャネル。これは、使用するバインディングによって指定される構成設定に基づいて構築されます。  
+  
+ アプリケーションでは、<xref:System.ServiceModel.ChannelFactory?displayProperty=fullName> を使用するか、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で生成された <xref:System.ServiceModel.ClientBase%601> 派生クラスのインスタンスを作成することによって、必要に応じて、このようなクライアントを作成できます。これらの作成済みのクライアント クラスは、<xref:System.ServiceModel.ChannelFactory> によって動的に構築されるクライアント チャネル実装にカプセル化され、処理が代行されます。したがって、クライアント チャネルと、クライアント チャネルを生成するチャネル ファクトリが、このトピックの説明の中心となります。  
+  
+## クライアント オブジェクトとクライアント チャネル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの基本インターフェイスは、<xref:System.ServiceModel.IClientChannel?displayProperty=fullName> インターフェイスです。これは、中核となるクライアント機能だけでなく、<xref:System.ServiceModel.ICommunicationObject?displayProperty=fullName> の基本的な通信オブジェクト機能、<xref:System.ServiceModel.IContextChannel?displayProperty=fullName> のコンテキスト機能、および <xref:System.ServiceModel.IExtensibleObject%601?displayProperty=fullName> の拡張可能な動作を公開します。  
+  
+ ただし、<xref:System.ServiceModel.IClientChannel> インターフェイスではサービス コントラクトそのものは定義しません。サービス コントラクトは \(通常、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) などのツールを使用してサービス メタデータから生成される\) サービス コントラクト インターフェイスによって宣言されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント型は、<xref:System.ServiceModel.IClientChannel> とターゲットのサービス コントラクト インターフェイスの両方を拡張したもので、アプリケーションから直接操作を呼び出したり、クライアント側のランタイム機能にアクセスしたりできるようにします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成することにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]<xref:System.ServiceModel.ChannelFactory?displayProperty=fullName> オブジェクトには、構成済みサービス エンドポイントに接続して対話できるランタイムの作成に必要な情報が提供されます。  
+  
+ 上述のとおり、この 2 つの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント型は、使用する前に構成する必要があります。最も単純な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント型は、<xref:System.ServiceModel.ClientBase%601> \(または、サービス コントラクトが双方向コントラクトである場合は、<xref:System.ServiceModel.DuplexClientBase%601>\) から派生するオブジェクトです。これらのクライアント型はコンストラクターを使用して作成し、プログラムで構成するか、または構成ファイルを使用して構成します。また、サービス操作を呼び出すために直接呼び出されます。<xref:System.ServiceModel.ClientBase%601> オブジェクトの概要については、「[WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)」を参照してください。  
+  
+ 2 番目のクライアント型は、実行時に <xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A> メソッドへの呼び出しから生成されます。通常、通信の詳細を厳密に制御する必要があるアプリケーションでは、*クライアント チャネル オブジェクト*と呼ばれる、このクライアント型を使用します。このクライアント型を使用することにより、基になるクライアント ランタイムやチャネル システムに比べ、より直接的な対話が可能になるためです。  
+  
+## チャネル ファクトリ  
+ クライアント呼び出しをサポートする、基になるランタイムを作成するクラスは、<xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName> クラスです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトも [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネル オブジェクトも、<xref:System.ServiceModel.ChannelFactory%601> オブジェクトを使用してインスタンスを作成します。<xref:System.ServiceModel.ClientBase%601> 派生クライアント オブジェクトはチャネル ファクトリの処理をカプセル化しますが、さまざまなシナリオを想定した場合、チャネル ファクトリを直接使用することをお勧めします。よくあるシナリオとしては、既存のファクトリから新しいクライアント チャネルを繰り返し作成する必要がある場合です。クライアント オブジェクトを使用している場合は、<xref:System.ServiceModel.ClientBase%601.ChannelFactory%2A?displayProperty=fullName> プロパティを呼び出して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトから、基になるチャネル ファクトリを取得できます。  
+  
+ チャネル ファクトリに関して覚えておく必要のある重要なことは、これらのファクトリが、<xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A?displayProperty=fullName> を呼び出す前に、指定されている構成のクライアント チャネルの新しいインスタンスを作成するという点です。いったん <xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A> \(または <xref:System.ServiceModel.ClientBase%601.Open%2A?displayProperty=fullName> や <xref:System.ServiceModel.ClientBase%601.CreateChannel%2A?displayProperty=fullName>、または [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトに対する任意の操作\) を呼び出した場合、ターゲットのエンドポイント アドレスを変更するだけでは、チャネル ファクトリを変更したり、別のサービス インスタンスへのチャネルを取得したりすることはできません。異なる構成でクライアント オブジェクトやクライアント チャネルを作成するには、まず新しいチャネル ファクトリを作成する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネルを使用する際のさまざまな問題[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF クライアントを使用したサービスへのアクセス](../../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)」を参照してください。  
+  
+ 次の 2 つのセクションでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネル オブジェクトの作成と使用について説明します。  
+  
+#### 新しい WCF クライアント チャネル オブジェクトの作成  
+ 次のサービス コントラクトが生成されていることを前提に、クライアント チャネルの使用方法を説明します。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#12)]  
+  
+ `ISampleService` サービスに接続するには、チャネル ファクトリ \(<xref:System.ServiceModel.ChannelFactory%601>\) を直接使用して生成したコントラクト インターフェイスを使用します。特定のコントラクトのチャネル ファクトリを作成して構成した後は、<xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A> メソッドを呼び出して、`ISampleService` サービスとの通信に使用できるクライアント チャネル オブジェクトを返すことができます。  
+  
+ サービス コントラクト インターフェイスで <xref:System.ServiceModel.ChannelFactory%601> クラスを使用する場合は、<xref:System.ServiceModel.IClientChannel> インターフェイスにキャストして、明示的にチャネルを開いたり、閉じたり、中止したりする必要があります。処理を容易にするために、Svcutil.exe ツールでは、サービス コントラクト インターフェイスと <xref:System.ServiceModel.IClientChannel> の両方を実装するヘルパー インターフェイスも生成されます。これにより、キャストを行わずにクライアント チャネル インフラストラクチャとのやりとりを実現できます。上記のサービス コントラクトを実装するヘルパー クライアント チャネルの定義を、次のコード例に示します。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#13)]  
+  
+#### 新しい WCF クライアント チャネル オブジェクトの作成  
+ クライアント チャネルを使用して `ISampleService` サービスに接続するには、チャネル ファクトリを直接使用して生成したコントラクト インターフェイス \(またはヘルパー バージョン\) を使用して、コントラクト インターフェイスの型を型パラメーターとして渡します。特定のコントラクトのチャネル ファクトリを作成して構成したら、<xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A?displayProperty=fullName> メソッドを呼び出して、`ISampleService` サービスとの通信に使用できるクライアント チャネル オブジェクトを返すことができます。  
+  
+ 作成したクライアント チャネル オブジェクトで <xref:System.ServiceModel.IClientChannel> とコントラクト インターフェイスを実装します。その結果、これらを使用して、このコントラクトをサポートするサービスと対話する操作を直接呼び出すことができます。  
+  
+ クライアント オブジェクトを使用するかクライアント チャネル オブジェクトを使用するかは、開発者がきめ細かな制御を優先するか容易さを優先するかの違いだけです。クラスやオブジェクトの処理に慣れている多くの開発者の場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネルではなく [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトを選択することも考えられます。  
+  
+ 例については、「[方法 : ChannelFactory を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/client-configuration.md b/docs/framework/wcf/feature-details/client-configuration.md
new file mode 100644
index 00000000000..d94477c6231
--- /dev/null
+++ b/docs/framework/wcf/feature-details/client-configuration.md
@@ -0,0 +1,105 @@
+---
+title: "クライアント構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5da5bd3b-65d9-43b7-91b9-cc9e989b1350
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# クライアント構成
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント構成は、クライアント エンドポイントのアドレス \(Address\)、バインディング \(Binding\)、動作 \(Behavior\)、およびコントラクト \(Contract\) の各プロパティ \(頭文字を取って "ABC" プロパティと呼ばれます\) を指定するために使用されます。また、これらのプロパティは、クライアントがサービス エンドポイントに接続するために使用されます。  [\<client\>](../../../../docs/framework/configure-apps/file-schema/wcf/client.md) 要素には [\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素があり、その属性はエンドポイントの ABC プロパティを構成するために使用されます。  これらの属性については、このトピックの「エンドポイントの構成」で説明します。  
+  
+ また、[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) には、メタデータのインポートおよびエクスポート設定を指定するために使用される [\<metadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/metadata.md) 要素、カスタムのアドレス ヘッダーのコレクションを格納する [\<headers\>](../../../../docs/framework/configure-apps/file-schema/wcf/headers.md) 要素、およびメッセージを交換する他のエンドポイントによるエンドポイントの認証を可能にする [\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md) 要素も含まれます。  [\<headers\>](../../../../docs/framework/configure-apps/file-schema/wcf/headers.md) および [\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md) 要素は <xref:System.ServiceModel.EndpointAddress> の一部であり、「[アドレス](../../../../docs/framework/wcf/feature-details/endpoint-addresses.md)」で説明します。  メタデータ拡張の使用法に関するトピックへのリンクは、このトピックの「メタデータの構成」にあります。  
+  
+## エンドポイントの構成  
+ クライアント構成では、クライアントがエンドポイントを 1 つ以上指定できるように設計します。各エンドポイントは、独自の名前、アドレス、およびコントラクトを持ち、そのエンドポイントを構成するために使用されるクライアント構成の [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素と [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素を参照します。  クライアント構成ファイルには、"App.config" という名前を付ける必要があります。これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムが想定している名前です。  クライアント構成ファイルの例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+        <client>  
+          <endpoint  
+            name="endpoint1"  
+            address="http://localhost/ServiceModelSamples/service.svc"  
+            binding="wsHttpBinding"  
+            bindingConfiguration="WSHttpBinding_IHello"  
+            behaviorConfiguration="IHello_Behavior"  
+            contract="IHello" >  
+  
+            <metadata>  
+              <wsdlImporters>  
+                <extension  
+                  type="Microsoft.ServiceModel.Samples.WsdlDocumentationImporter, WsdlDocumentation"/>  
+              </wsdlImporters>  
+            </metadata>  
+  
+            <identity>  
+              <servicePrincipalName value="host/localhost" />  
+            </identity>  
+          </endpoint>  
+// Add another endpoint by adding another <endpoint> element.  
+          <endpoint  
+            name="endpoint2">  
+           //Configure another endpoint here.  
+          </endpoint>  
+        </client>  
+  
+//The bindings section references by the bindingConfiguration endpoint attribute.  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_IHello"   
+                 bypassProxyOnLocal="false"   
+                 hostNameComparisonMode="StrongWildcard">  
+          <readerQuotas maxDepth="32"/>  
+          <reliableSession ordered="true"   
+                           enabled="false" />  
+          <security mode="Message">  
+           //Security settings go here.  
+          </security>  
+        </binding>  
+        <binding name="Another Binding"  
+        //Configure this binding here.  
+        </binding>  
+          </wsHttpBinding>  
+        </bindings>  
+  
+//The behavior section references by the behaviorConfiguration endpoint attribute.  
+        <behaviors>  
+            <endpointBehaviors>  
+                <behavior name=" IHello_Behavior ">  
+                    <clientVia />  
+                </behavior>  
+            </endpointBehaviors>  
+        </behaviors>  
+  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+ 省略可能な `name` 属性は、特定のコントラクトのエンドポイントを一意に識別します。  この属性は、サービスへのチャネルの作成時に、クライアント構成のどのエンドポイントをターゲットとし、読み込む必要があるかを指定するために、<xref:System.ServiceModel.ChannelFactory%601.%23ctor%2A> または <xref:System.ServiceModel.ClientBase%601.%23ctor%2A> が使用します。  エンドポイント構成名としてワイルドカード "\*" を使用できます。これは、使用できるエンドポイント構成が 1 つだけ存在する場合はファイル内のエンドポイント構成を読み込み、それ以外の場合は例外をスローするように <xref:System.ServiceModel.ChannelFactory.ApplyConfiguration%2A> メソッドに指示します。  この属性が省略されている場合、指定されたコントラクトの種類に関連する既定のエンドポイントとして、対応するエンドポイントが使用されます。  `name` 属性の既定値は、他の名前と同様に一致する空の文字列です。  
+  
+ すべてのエンドポイントには、エンドポイントを検索および識別するために、アドレスが関連付けられている必要があります。  `address` 属性は、エンドポイントの場所を示す URL を指定するために使用できます。  ただし、サービス エンドポイントのアドレスは、コードで指定することもできます。その場合は、URI \(Uniform Resource Identifier\) を作成し、<xref:System.ServiceModel.ServiceHost> メソッドのいずれかを使用して、この URI を <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> に追加します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[アドレス](../../../../docs/framework/wcf/feature-details/endpoint-addresses.md)」を参照してください。  最初に説明したように、[\<headers\>](../../../../docs/framework/configure-apps/file-schema/wcf/headers.md) 要素と [\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md) 要素は <xref:System.ServiceModel.EndpointAddress> の一部であるため、これらについては「[アドレス](../../../../docs/framework/wcf/feature-details/endpoint-addresses.md)」でも説明します。  
+  
+ `binding` 属性は、エンドポイントがサービスに接続する際に使用するバインディングの種類を示します。  参照できるようにするには、種類は登録された構成セクションを持っている必要があります。  上の例では、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) セクションがこれであり、エンドポイントが <xref:System.ServiceModel.WSHttpBinding> を使用することを示しています。  ただし、エンドポイントが使用できる、指定された種類のバインディングが複数存在することもあります。  これらは、それぞれ \(バインディングの\) 種類を表す要素内に独自の [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を持ちます。  `bindingconfiguration` 属性は、同じ種類のバインディングを識別するために使用されます。  この値は、[\<binding\>](../../../../docs/framework/misc/binding.md) 要素の `name` 属性と一致します。  構成を使用してクライアント バインディングを構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成でクライアント バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md)」を参照してください。  
+  
+ `behaviorConfiguration` 属性は、エンドポイントが使用する [\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md) の [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md) を指定するために使用されます。  この値は、[\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md) 要素の `name` 属性と一致します。  構成を使用してクライアントの動作を指定する例については、「[クライアントの動作の構成](../../../../docs/framework/wcf/configuring-client-behaviors.md)」を参照してください。  
+  
+ `contract` 属性は、エンドポイントが公開するコントラクトを指定します。  この値は、<xref:System.ServiceModel.ServiceContractAttribute.ConfigurationName%2A> の <xref:System.ServiceModel.ServiceContractAttribute> にマップされます。  既定値は、サービスを実装するクラスの完全な型名です。  
+  
+### メタデータの構成  
+ [\<metadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/metadata.md) 要素は、メタデータのインポート拡張を登録するための設定を指定するために使用されます。  メタデータ システムの拡張[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)」を参照してください。  
+  
+## 参照  
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)   
+ [クライアントの動作の構成](../../../../docs/framework/wcf/configuring-client-behaviors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/clients.md b/docs/framework/wcf/feature-details/clients.md
new file mode 100644
index 00000000000..e7d0fd28d5c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/clients.md
@@ -0,0 +1,36 @@
+---
+title: "クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cce50025-0318-4a5e-9ce8-c67feab83b06
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# クライアント
+このセクションのトピックでは、クライアント アーキテクチャ、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスへのアクセス方法、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの構成方法、および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのセキュリティに関する考慮事項について説明します。  
+  
+## このセクションの内容  
+ [WCF クライアント アーキテクチャ](../../../../docs/framework/wcf/feature-details/client-architecture.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのアーキテクチャについて説明します。  
+  
+ [WCF クライアントを使用したサービスへのアクセス](../../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにアクセスする方法について説明します。  
+  
+ [WCF クライアントの構成](../../../../docs/framework/wcf/feature-details/client-configuration.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの設定方法について説明します。  
+  
+ [クライアントのセキュリティ保護](../../../../docs/framework/wcf/securing-clients.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのセキュリティに関する考慮事項について説明します。  
+  
+## 参照  
+ [Client Samples](http://msdn.microsoft.com/ja-jp/849fc452-8718-4d4e-ba57-905eed943f63)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/collection-types-in-data-contracts.md b/docs/framework/wcf/feature-details/collection-types-in-data-contracts.md
new file mode 100644
index 00000000000..5d1798aec31
--- /dev/null
+++ b/docs/framework/wcf/feature-details/collection-types-in-data-contracts.md
@@ -0,0 +1,404 @@
+---
+title: "データ コントラクトのコレクション型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション型 [WCF], データ コントラクト"
+  - "データ コントラクト [WCF], コレクション型"
+  - "コレクション型 [WCF]"
+ms.assetid: 9b45b28e-0a82-4ea3-8c33-ec0094aff9d5
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# データ コントラクトのコレクション型
+*"コレクション"* は、特定の型の項目のリストです。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、このようなリストは、配列や他のさまざまな型を使用して表すことができます \(ジェネリック List、ジェネリック <xref:System.ComponentModel.BindingList%601>、<xref:System.Collections.Specialized.StringCollection>、または <xref:System.Collections.ArrayList>\)。 たとえば、コレクションでは指定された顧客のアドレスのリストを保持できます。 これらのコレクションは、実際の型に関係なく、*リスト コレクション*と呼びます。  
+  
+ コレクションには、ある項目 \("キー"\) と別の項目 \("値"\) の関連付けを表す特殊な形式のものがあります。 これらのコレクションは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では <xref:System.Collections.Hashtable> やジェネリック ディクショナリなどの型によって表されます。 たとえば、関連付けコレクションでは、都市 \("キー"\) をその人口 \("値"\) に関連付けることができます。 これらのコレクションは、実際の型に関係なく、*ディクショナリ コレクション*と呼びます。  
+  
+ データ コントラクト モデルでは、コレクションは特別な扱いを受けます。  
+  
+ 配列やジェネリック コレクションを含め、<xref:System.Collections.IEnumerable> インターフェイスを実装する型はコレクションとして認識されます。 これらの中で、<xref:System.Collections.IDictionary> インターフェイスまたはジェネリック <xref:System.Collections.Generic.IDictionary%602> インターフェイスを実装する型がディクショナリ コレクションであり、他はすべてリスト コレクションです。  
+  
+ `Add` というメソッドと既定のコンストラクターを持つなど、コレクション型のその他の要件については、以降のセクションで詳しく説明します。 これにより、コレクション型を確実にシリアル化および逆シリアル化できます。 これは、直接サポートされないコレクションもあることを意味します。たとえば、ジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> \(既定のコンストラクターを持たないため\) などは直接サポートされません。 これらの制限を回避する方法については、このトピックで後述する「コレクション インターフェイス型と読み取り専用コレクションの使用」を参照してください。  
+  
+ コレクションに含まれる型は、データ コントラクト型である必要があります。それ以外の場合は、シリアル化可能な型であることが必要です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)。  
+  
+ 有効なコレクションと見なされるものと見なされないもの、およびコレクションをシリアル化する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、このトピックの「コレクションの高度な規則」でコレクションのシリアル化に関する情報を参照してください。  
+  
+## 交換可能なコレクション  
+ 同じ型のすべてのリスト コレクションは、同じデータ コントラクトを持つと見なされます \(このトピックで後述するように、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を使用してカスタマイズされている場合を除きます\)。 たとえば、次のデータ コントラクトは等価です。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#0)]
+ [!code-vb[c_collection_types_in_data_contracts#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#0)]  
+  
+ この 2 つのデータ コントラクトでは、いずれも次のコードに似た XML が生成されます。  
+  
+```  
+<PurchaseOrder>  
+    <customerName>...</customerName>  
+    <items>  
+        <Item>...</Item>  
+        <Item>...</Item>  
+        <Item>...</Item>  
+        ...  
+    </items>  
+    <comments>  
+        <string>...</string>  
+        <string>...</string>  
+        <string>...</string>  
+        ...  
+    </comments>  
+</PurchaseOrder>  
+```  
+  
+ コレクションの可換性により、たとえば、サーバーではパフォーマンスを確保するように最適化されたコレクション型を使用し、クライアントではユーザー インターフェイス コンポーネントにバインドするよう設計されたコレクション型を使用することが可能です。  
+  
+ リスト コレクションと同様に、\(<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性によってカスタマイズされている場合を除き\) キーおよび値の型が同じであるすべてのディクショナリ コレクションは、同じデータ コントラクトを持つと見なされます。  
+  
+ コレクションの等価性に関する限り、重要となるのはデータ コントラクト型のみであり、.NET 型は影響しません。 つまり、Type1 と Type2 のデータ コントラクトが等価であれば、Type1 のコレクションは Type2 のコレクションと等価と見なされます。  
+  
+ 非ジェネリック コレクションは、`Object` 型のジェネリック コレクションと同じデータ コントラクトを持つと見なされます  \(たとえば、<xref:System.Collections.ArrayList> と <xref:System.Collections.Generic.List%601> のジェネリック `Object` のデータ コントラクトは同じです\)。  
+  
+## コレクション インターフェイス型と読み取り専用コレクションの使用  
+ コレクション インターフェイス型 \(<xref:System.Collections.IEnumerable>、<xref:System.Collections.IDictionary>、ジェネリック <xref:System.Collections.Generic.IDictionary%602>、またはこれらのインターフェイスから派生したインターフェイス\) も、実際のコレクション型のコレクション データ コントラクトと等価のコレクション データ コントラクトを持つと見なされます。 したがって、シリアル化する型をコレクション インターフェイス型として宣言できます。この結果は、実際のコレクション型を使用した場合と同じになります。 たとえば、次のデータ コントラクトは等価です。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#1)]
+ [!code-vb[c_collection_types_in_data_contracts#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#1)]  
+  
+ シリアル化の実行時には、宣言された型がインターフェイスの場合、使用される実際のインスタンスの型はそのインターフェイスを実装する任意の型になります。 前述の制限 \(既定のコンストラクターと `Add` メソッドを持つ\) は適用されません。 たとえば、ジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> 型のデータ メンバーを直接宣言できない場合でも、Customer2 のアドレスを Address のジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> のインスタンスに設定できます。  
+  
+ 逆シリアル化の実行時には、宣言された型がインターフェイスの場合、宣言されたインターフェイスを実装する型がシリアル化エンジンによって選択され、インスタンス化されます。 この場合、既知の型機構 \(「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照\) は無効になります。型の選択は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に組み込まれています。  
+  
+## コレクション型のカスタマイズ  
+ コレクション型は、複数の用途を持つ <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を使用することによってカスタマイズできます。  
+  
+ コレクション型をカスタマイズすると、コレクションの可換性が損なわれるため、一般に、できるだけこの属性を適用しないようにすることをお勧めします。 この問題[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、このトピックで後述する「コレクションの高度な規則」を参照してください。  
+  
+### コレクション データ コントラクトの名前付け  
+ コレクション型の名前付け規則は、「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」で説明する通常のデータ コントラクト型の名前付けの規則に似ていますが、重要な違いがいくつかあります。  
+  
+-   名前をカスタマイズする際に、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性ではなく、<xref:System.Runtime.Serialization.DataContractAttribute> 属性を使用します。<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性にも、`Name` プロパティと `Namespace` プロパティがあります。  
+  
+-   <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用しない場合、コレクション型の既定の名前と名前空間は、コレクションに含まれる型の名前と名前空間によって決まります。 これらは、コレクション型自体の名前と名前空間の影響を受けません。 型の一例を次に示します。  
+  
+    ```  
+    public CustomerList1 : Collection<string> {}  
+    public StringList1 : Collection<string> {}  
+    ```  
+  
+ これらの型のデータ コントラクト名は、"CustomerList1" や "StringList1" ではなく、どちらも "ArrayOfstring" になります。 つまり、ルート レベルでこれらの型のどちらをシリアル化しても、次のコードのような XML が生成されます。  
+  
+```  
+<ArrayOfstring>  
+    <string>...</string>  
+    <string>...</string>  
+    <string>...</string>  
+    ...  
+</ArrayOfstring>  
+```  
+  
+ この名前付け規則が選択されたのは、文字列のリストを表すカスタマイズされていないすべての型が同じデータ コントラクトと XML 表現を持つことができるようにするためです。 これにより、コレクションの可換性が実現されています。 この例では、CustomerList1 と StringList1 は完全に交換可能です。  
+  
+ ただし、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用すると、この属性でプロパティが設定されていない場合でも、コレクションはカスタマイズされたコレクション データ コントラクトになります。 この場合、コレクション データ コントラクトの名前と名前空間は、コレクション型自体によって決まります。 型の一例を次に示します。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#2)]
+ [!code-vb[c_collection_types_in_data_contracts#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#2)]  
+  
+ シリアル化すると、生成される XML は次のようになります。  
+  
+```  
+<CustomerList2>  
+    <string>...</string>  
+    <string>...</string>  
+    <string>...</string>  
+    ...  
+</CustomerList2>  
+```  
+  
+ これは、カスタマイズされていない型の XML 表現と等価ではなくなっていることに注意してください。  
+  
+-   `Name` プロパティと `Namespace` プロパティを使用して、名前付けをさらにカスタマイズできます。 次のクラスを参照してください。  
+  
+     [!code-csharp[c_collection_types_in_data_contracts#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#3)]
+     [!code-vb[c_collection_types_in_data_contracts#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#3)]  
+  
+ 生成される XML は次のようになります。  
+  
+```  
+<cust_list>  
+    <string>...</string>  
+    <string>...</string>  
+    <string>...</string>  
+    ...  
+</cust_list>  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]このトピックで後述される「コレクションの高度な規則」を参照してください。  
+  
+### リスト コレクション内の反復される要素名のカスタマイズ  
+ リスト コレクションには、反復されるエントリが含まれています。 通常、反復される各エントリは、コレクションに含まれる型のデータ コントラクト名に従って名前が付けられた要素として表されます。  
+  
+ `CustomerList` の各例では、コレクションに文字列が含まれていました。 文字列プリミティブ型のデータ コントラクト名は "string" であるため、反復される要素は "\<string\>" でした。  
+  
+ ただし、<xref:System.Runtime.Serialization.CollectionDataContractAttribute.ItemName%2A> 属性の <xref:System.Runtime.Serialization.CollectionDataContractAttribute> プロパティを使用すると、この反復される要素名をカスタマイズできます。 型の一例を次に示します。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#4)]
+ [!code-vb[c_collection_types_in_data_contracts#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#4)]  
+  
+ 生成される XML は次のようになります。  
+  
+```  
+<CustomerList4>  
+    <customer>...</ customer>  
+    <customer>...</customer>  
+    <customer>...</customer>  
+    ...  
+</CustomerList4>  
+```  
+  
+ 反復される要素の名前空間は、コレクション データ コントラクトの名前空間と常に同じです。前述のように、コレクション データ コントラクトの名前空間は、`Namespace` プロパティを使用してカスタマイズできます。  
+  
+### ディクショナリ コレクションのカスタマイズ  
+ ディクショナリ コレクションは、基本的にエントリのリストです。各エントリにはキーが含まれ、その後に値が続きます。 通常のリストと同様に、反復される要素に対応する要素名は、<xref:System.Runtime.Serialization.CollectionDataContractAttribute.ItemName%2A> プロパティを使用して変更できます。  
+  
+ また、キーと値を表す要素名は、<xref:System.Runtime.Serialization.CollectionDataContractAttribute.KeyName%2A> プロパティと <xref:System.Runtime.Serialization.CollectionDataContractAttribute.ValueName%2A> プロパティを使用して変更できます。 これらの要素の名前空間は、コレクション データ コントラクトの名前空間と同じです。  
+  
+ 型の一例を次に示します。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#5)]
+ [!code-vb[c_collection_types_in_data_contracts#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#5)]  
+  
+ シリアル化すると、生成される XML は次のようになります。  
+  
+```  
+<CountriesOrRegionsWithCapitals>  
+    <entry>  
+        <countryorregion>USA</countryorregion>  
+        <capital>Washington</capital>  
+    </entry>  
+    <entry>  
+        <countryorregion>France</countryorregion>  
+        <capital>Paris</capital>  
+    </entry>  
+    ...  
+</CountriesOrRegionsWithCapitals>  
+```  
+  
+ ディクショナリ コレクション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、このトピックで後述される「コレクションの高度な規則」を参照してください。  
+  
+## コレクションと既知の型  
+ コレクション型を、他のコレクションまたはコレクション インターフェイスの代わりにポリモーフィックに使用する場合は、既知の型に追加する必要はありません。 たとえば、<xref:System.Collections.IEnumerable> 型のデータ メンバーを宣言し、このデータ メンバーを使用して <xref:System.Collections.ArrayList> のインスタンスを送信する場合、<xref:System.Collections.ArrayList> を既知の型に追加する必要はありません。  
+  
+ コレクションを、コレクション型以外の型の代わりにポリモーフィックに使用する場合は、コレクションを既知の型に追加する必要があります。 たとえば、`Object` 型のデータ メンバーを宣言し、このデータ メンバーを使用して <xref:System.Collections.ArrayList> のインスタンスを送信する場合は、<xref:System.Collections.ArrayList> を既知の型に追加する必要があります。  
+  
+ この場合、等価のコレクションをポリモーフィックにシリアル化することはできません。 たとえば、前述の例で、<xref:System.Collections.ArrayList> を既知の型のリストに追加すると、`Array of Object` クラスが等価のデータ コントラクトを持っていても、これを割り当てることはできなくなります。 これは、コレクション型以外の型のシリアル化における、通常の既知の型の動作と変わりません。しかし、コレクションが等価であることはごく一般的なことであるため、コレクションに関しては、この動作を理解しておくことが特に重要となります。  
+  
+ シリアル化では、指定されたデータ コントラクトの特定のスコープで許可される既知の型は 1 つだけであり、等価のコレクションはすべて同じデータ コントラクトを持ちます。 つまり、前述の例では、同じスコープで <xref:System.Collections.ArrayList> と `Array of Object` の両方を既知の型に追加することはできません。 先ほども説明したように、これはコレクション型以外の型での既知の型の動作と同じですが、コレクションではこの動作を理解しておくことが特に重要です。  
+  
+ コレクションの内容に既知の型が必要になることもあります。 たとえば、<xref:System.Collections.ArrayList> に `Type1` と `Type2` のインスタンスを実際に含める場合、この両方の型を既知の型に追加する必要があります。  
+  
+ コレクションと既知の型を使用して、適切に構築されたオブジェクト グラフの例を次に示します  \(この例には、多少不自然な部分があります。実際のアプリケーションでは、通常、次のデータ メンバーを `Object` として定義することはないため、既知の型やポリモーフィズムの問題が発生することはありません\)。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#6)]
+ [!code-vb[c_collection_types_in_data_contracts#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#6)]  
+  
+ 逆シリアル化では、宣言された型がコレクション型の場合、実際に送信された型に関係なく、宣言された型がインスタンス化されます。 宣言された型がコレクション インターフェイスの場合は、既知の型に関係なく、インスタンス化される型がデシリアライザーによって選択されます。  
+  
+ また、逆シリアル化では、宣言された型がコレクション型ではないときにコレクション型を送信する場合、既知の型リストから一致するコレクション型が選択されます。 逆シリアル化では、コレクション インターフェイス型を既知の型のリストに追加できます。 この場合、逆シリアル化エンジンによって、インスタンス化する型が再度選択されます。  
+  
+## コレクションと NetDataContractSerializer クラス  
+ <xref:System.Runtime.Serialization.NetDataContractSerializer> クラスの使用時には、配列ではないカスタマイズされていないコレクション型 \(<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を使用していないコレクション型\) は、その特殊な意味を失います。  
+  
+ <xref:System.SerializableAttribute> 属性でマークされたカスタマイズされていないコレクション型でも、<xref:System.Runtime.Serialization.NetDataContractSerializer> 属性または <xref:System.SerializableAttribute> インターフェイスの規則に従って、<xref:System.Runtime.Serialization.ISerializable> クラスによってシリアル化できます。  
+  
+ <xref:System.Runtime.Serialization.NetDataContractSerializer> クラスを使用している場合でも、カスタマイズされたコレクション型、コレクション インターフェイス、および配列は、コレクションとして扱われます。  
+  
+## コレクションとスキーマ  
+ すべての等価のコレクションは、XML スキーマ定義言語 \(XSD: XML Schema Definition Language\) スキーマで同様に表現されます。 このため、生成されたクライアント コードでもサーバーと同じコレクション型になることは通常ありません。 たとえば、サーバーで Integer データ メンバーのジェネリック <xref:System.Collections.Generic.List%601> を含むデータ コントラクトを使用していても、生成されたクライアント コードでは、この同じデータ メンバーが整数の配列になることがあります。  
+  
+ ディクショナリ コレクションは、それがディクショナリであることを示す [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 固有のスキーマ注釈でマークされます。そうしないと、キーと値を持つエントリが含まれた単純なリストと区別できなくなります。 データ コントラクト スキーマでのコレクションの表現方法の正確な記述については、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。  
+  
+ 既定では、コードをインポートする際に、カスタマイズされていないコレクションの型は生成されません。 リスト コレクション型のデータ メンバーは配列としてインポートされ、ディクショナリ コレクション型のデータ メンバーはジェネリック ディクショナリとしてインポートされます。  
+  
+ ただし、カスタマイズされたコレクションの場合、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性でマークされた個別の型が生成されます  \(スキーマにおけるカスタマイズされたコレクション型とは、既定の名前空間、名前、反復される要素名、またはキー\/値要素名を使用しない型のことです\)。 これらの型は、リスト型のジェネリック <xref:System.Collections.Generic.List%601> およびディクショナリ型のジェネリック ディクショナリから派生した空の型です。  
+  
+ たとえば、サーバーで次のような型を使用するとします。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#7)]
+ [!code-vb[c_collection_types_in_data_contracts#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#7)]  
+  
+ スキーマをエクスポートし、再度インポートすると、生成されるクライアント コードは次のようになります \(わかりやすくするために、プロパティの代わりにフィールドを示しています\)。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#8)]
+ [!code-vb[c_collection_types_in_data_contracts#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#8)]  
+  
+ 生成されるコードで、既定の型と異なる型を使用することが必要になる場合があります。 たとえば、データ メンバーをユーザー インターフェイス コンポーネントにバインドしやすくするために、データ メンバーの通常の配列ではなく、ジェネリック <xref:System.ComponentModel.BindingList%601> を使用することがあります。  
+  
+ 生成するコレクション型を選択するには、スキーマをインポートするときに、使用するコレクション型のリストを <xref:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes%2A> オブジェクトの <xref:System.Runtime.Serialization.ImportOptions> プロパティに渡します。 これらの型は、*"参照されるコレクション型"* と呼ばれます。  
+  
+ ジェネリック型を参照する場合は、完全なオープン ジェネリックまたは完全なクローズ ジェネリックであることが必要です。  
+  
+> [!NOTE]
+>  Svcutil.exe ツールを使用すると、**\/collectionType** コマンド ライン スイッチ \(短縮形: **\/ct**\) を使用して、この参照を実現できます。**\/reference** スイッチ \(短縮形: **\/r**\) を使用して、参照されるコレクション型のアセンブリも指定する必要があることに注意してください。 型がジェネリックの場合は、型の後に逆引用符とジェネリック パラメーターの数を指定する必要があります。 逆引用符 \(\`\) は、単一引用符 \(‘\) と混同しないでください。 参照されるコレクション型を複数指定するには、**\/collectionType** スイッチを複数回使用します。  
+  
+ たとえば、すべてのリストをジェネリック <xref:System.Collections.Generic.List%601> としてインポートするには、次のように指定します。  
+  
+```  
+svcutil.exe MyService.wsdl MyServiceSchema.xsd /r:C:\full_path_to_system_dll\System.dll /ct:System.Collections.Generic.List`1  
+  
+```  
+  
+ コレクションをインポートするときに、参照されるコレクション型のこのリストがスキャンされ、最も一致するコレクションが見つかると、そのコレクションがデータ メンバー型 \(カスタマイズされていないコレクションの場合\)、または派生元となる基本型 \(カスタマイズされたコレクションの場合\) として使用されます。 ディクショナリはディクショナリと照合され、リストはリストと照合されます。  
+  
+ たとえば、参照される型のリストにジェネリック <xref:System.ComponentModel.BindingList%601> と <xref:System.Collections.Hashtable> を追加した場合、前述の例で生成されるクライアント コードは次のようになります。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#9)]
+ [!code-vb[c_collection_types_in_data_contracts#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#9)]  
+  
+ 参照されるコレクション型の一部として、コレクション インターフェイス型を指定できますが、無効なコレクション型 \(`Add` メソッドまたはパブリック コンストラクターを持たないコレクション型など\) を指定することはできません。  
+  
+ クローズ ジェネリック型は、合致度が最も高いと見なされます  \(非ジェネリック型は、`Object` のクローズ ジェネリックと同等に扱われます\)。 たとえば、<xref:System.Collections.Generic.List%601> のジェネリック <xref:System.DateTime>、ジェネリック <xref:System.ComponentModel.BindingList%601> \(オープン ジェネリック\)、および <xref:System.Collections.ArrayList> が参照されるコレクション型である場合、次のようなコードが生成されます。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#10)]
+ [!code-vb[c_collection_types_in_data_contracts#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#10)]  
+  
+ リスト コレクションの場合、以下の表内のケースだけがサポートされます。  
+  
+|参照される型|参照される型で実装されるインターフェイス|例|型の処理|  
+|------------|--------------------------|-------|----------|  
+|非ジェネリックまたはクローズ ジェネリック \(任意の数のパラメーター\)|非ジェネリック|`MyType : IList`<br /><br /> または<br /><br /> `MyType<T> : IList`<br /><br /> ここでは、T\= `int`|`Object` のクローズ ジェネリック \(例 : `IList<object>`\)|  
+|非ジェネリックまたはクローズ ジェネリック \(コレクション型と必ずしも一致するわけではない任意の数のパラメーター\)|クローズ ジェネリック|`MyType : IList<string>`<br /><br /> または<br /><br /> `MyType<T> : IList<string>` ここでは、T\=`int`|クローズ ジェネリック \(例 : `IList<string>`\)|  
+|任意の数のパラメーターを持つクローズ ジェネリック|型のパラメーターのいずれかを使用するオープン ジェネリック|`MyType<T,U,V> : IList<U>`<br /><br /> ここでは、T\=`int`、U\=`string`、V\=`bool`|クローズ ジェネリック \(例 : `IList<string>`\)|  
+|パラメーターを 1 つ持つオープン ジェネリック|型のパラメーターを使用するオープン ジェネリック|`MyType<T> : IList<T>`、T はオープン|オープン ジェネリック \(例 : `IList<T>`\)|  
+  
+ 型が複数のリスト コレクション インターフェイスを実装している場合、以下の制限が適用されます。  
+  
+-   型が、異なる型のジェネリック <xref:System.Collections.Generic.IEnumerable%601> \(またはその派生インターフェイス\) を複数回実装している場合、その型は有効な参照されるコレクション型とは見なされず、無視されます。 これは、一部の実装が無効であったり、オープン ジェネリックを使用していたりする場合も該当します。 たとえば、型が <xref:System.Collections.Generic.IEnumerable%601> のジェネリック `int` と、T のジェネリック <xref:System.Collections.Generic.IEnumerable%601> を実装している場合、`int` の参照されるコレクションとしても、その他の型の参照されるコレクションとしても使用されることはありません。この場合、型が `Add` を受け入れる `int` メソッドと T 型のパラメーターを受け入れる `Add` メソッドのいずれか、または両方を持っているかどうかは関係ありません。  
+  
+-   型がジェネリック コレクション インターフェイスと <xref:System.Collections.IList> を実装している場合、ジェネリック コレクション インターフェイスが <xref:System.Object> 型のクローズ ジェネリックでない限り、参照されるコレクション型として使用されることはありません。  
+  
+ ディクショナリ コレクションの場合、以下の表内のケースだけがサポートされます。  
+  
+|参照される型|参照される型で実装されるインターフェイス|例|型の処理|  
+|------------|--------------------------|-------|----------|  
+|非ジェネリックまたはクローズ ジェネリック \(任意の数のパラメーター\)|<xref:System.Collections.IDictionary>|`MyType : IDictionary`<br /><br /> または<br /><br /> `MyType<T> : IDictionary` ここでは、T\=`int`|クローズ ジェネリック `IDictionary<object,object>`|  
+|クローズ ジェネリック \(任意の数のパラメーター\)|<xref:System.Collections.Generic.IDictionary%602>、クローズ|`MyType<T> : IDictionary\<string, bool>` ここでは、T\=`int`|クローズ ジェネリック \(例 : `IDIctionary\<string,bool>`\)|  
+|クローズ ジェネリック \(任意の数のパラメーター\)|ジェネリック <xref:System.Collections.Generic.IDictionary%602>、キーまたは値の一方がクローズ。もう一方はオープンで、型のパラメーターのいずれかを使用|`MyType\<T,U,V> : IDictionary\<string,V>` ここでは、T\=`int`、U\=`float`、V\=`bool`<br /><br /> または<br /><br /> `MyType<Z> : IDictionary\<Z,bool>` ここでは、Z\=`string`|クローズ ジェネリック \(例 : `IDictionary\<string,bool>`\)|  
+|クローズ ジェネリック \(任意の数のパラメーター\)|ジェネリック <xref:System.Collections.Generic.IDictionary%602>、キーと値の両方がオープンであり、それぞれ型のパラメーターのいずれかを使用|`MyType\<T,U,V> : IDictionary\<V,U>` ここでは、T\=`int`、U\=`bool`、V\=`string`|クローズ ジェネリック \(例 : `IDictionary\<string,bool>`\)|  
+|オープン ジェネリック \(2 つのパラメーター\)|ジェネリック <xref:System.Collections.Generic.IDictionary%602>、オープン、型のジェネリック パラメーターの両方をその出現順に使用|`MyType\<K,V> : IDictionary\<K,V>`、K と V は共にオープン|オープン ジェネリック \(例 : `IDictionary\<K,V>`\)|  
+  
+ 型が <xref:System.Collections.IDictionary> とジェネリック <xref:System.Collections.Generic.IDictionary%602> の両方を実装している場合、ジェネリック <xref:System.Collections.Generic.IDictionary%602> だけが考慮されます。  
+  
+ 部分的なジェネリック型の参照はサポートされていません。  
+  
+ 重複は許可されていません。たとえば、<xref:System.Collections.Generic.List%601> のジェネリック `Integer` と、`Integer` のジェネリック コレクションの両方を <xref:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes%2A> に追加することはできません。これは、スキーマで整数のリストが見つかったときに、どちらを使用するかを判断できなくなるためです。 もっとも、このような重複が検出されるのは、それが問題になるような型がスキーマ中にある場合だけです。 たとえば、インポートしているスキーマ中に整数のリストがない場合に、<xref:System.Collections.Generic.List%601> のジェネリック `Integer` と `Integer` のジェネリック コレクションの両方が <xref:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes%2A> にあっても問題はありませんが、いずれも使用されません。  
+  
+## コレクションの高度な規則  
+  
+### コレクションのシリアル化  
+ コレクションのシリアル化規則を以下に示します。  
+  
+-   コレクション型は、組み合わせる \(コレクションのコレクションを持つ\) ことができます。 ジャグ配列は、コレクションのコレクションとして扱われます。 多次元配列はサポートされていません。  
+  
+-   バイト配列と <xref:System.Xml.XmlNode> の配列は、コレクションではなく、プリミティブとして扱われる特殊な配列の型です。 バイト配列をシリアル化すると、バイトごとの個別の要素ではなく、Base64 でエンコードされたデータのチャンクを含む単一の XML 要素が生成されます。<xref:System.Xml.XmlNode> の配列の処理方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[データ コントラクトの XML および ADO.NET の種類](../../../../docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md)」を参照してください。 これらの特殊な型もコレクションに参加できます。バイト配列の配列の場合、複数の XML 要素が生成され、各要素に Base64 でエンコードされたデータのチャンクが含まれます。  
+  
+-   <xref:System.Runtime.Serialization.DataContractAttribute> 属性をコレクション型に適用した場合、型はコレクションとしてではなく、通常のデータ コントラクト型として扱われるようになります。  
+  
+-   コレクション型が <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装している場合、次の規則が適用されます。`myType:IList<string>, IXmlSerializable` 型と仮定します。  
+  
+    -   宣言型が `IList<string>` の場合、この型はリストとしてシリアル化されます。  
+  
+    -   宣言型が `myType` の場合、この型は `IXmlSerializable` としてシリアル化されます。  
+  
+    -   宣言型が `IXmlSerializable` の場合は、既知の型のリストに `IXmlSerializable` を追加しているときにのみ、この型が `myType` としてシリアル化されます。  
+  
+-   コレクションは、以下の表に示すメソッドを使用してシリアル化および逆シリアル化されます。  
+  
+|コレクション型の実装|シリアル化で呼び出されるメソッド|逆シリアル化で呼び出されるメソッド|  
+|----------------|----------------------|-----------------------|  
+|ジェネリック <xref:System.Collections.Generic.IDictionary%602>|`get_Keys`, `get_Values`|ジェネリック Add|  
+|<xref:System.Collections.IDictionary>|`get_Keys`, `get_Values`|`Add`|  
+|ジェネリック <xref:System.Collections.Generic.IList%601>|ジェネリック <xref:System.Collections.Generic.IList%601> インデクサー|ジェネリック Add|  
+|ジェネリック <xref:System.Collections.Generic.ICollection%601>|列挙子|ジェネリック Add|  
+|<xref:System.Collections.IList>|<xref:System.Collections.IList> インデクサー|`Add`|  
+|ジェネリック <xref:System.Collections.Generic.IEnumerable%601>|`GetEnumerator`|適切な型 \(ジェネリック パラメーターの型、またはその基本型のいずれか\) のパラメーターを 1 つ受け取る `Add` という非静的メソッド。 このようなメソッドは、シリアル化と逆シリアル化の両方で、シリアライザーがコレクション型をコレクションとして処理するために必要になります。|  
+|<xref:System.Collections.IEnumerable> \(およびこのインターフェイスから派生した <xref:System.Collections.ICollection>\)|`GetEnumerator`|`Add` 型のパラメーターを 1 つ受け取る `Object` という非静的メソッド。 このようなメソッドは、シリアル化と逆シリアル化の両方で、シリアライザーがコレクション型をコレクションとして処理するために必要になります。|  
+  
+ 前の表に示すコレクション インターフェイスは、優先度の高いものから順に並べられています。 たとえば、型が <xref:System.Collections.IList> とジェネリック <xref:System.Collections.Generic.IEnumerable%601> の両方を実装している場合、<xref:System.Collections.IList> の規則に従って、コレクションがシリアル化および逆シリアル化されます。  
+  
+-   逆シリアル化では、すべてのコレクションが、まず、既定のコンストラクターを呼び出して型のインスタンスを作成することによって逆シリアル化されます。既定のコンストラクターは、シリアル化と逆シリアル化の両方で、シリアライザーがコレクション型をコレクションとして処理するために必要となります。  
+  
+-   同じジェネリック コレクション インターフェイスが複数回実装されており \(型が <xref:System.Collections.Generic.ICollection%601> のジェネリック `Integer` と、<xref:System.Collections.Generic.ICollection%601> のジェネリック <xref:System.String> の両方を実装している場合など\)、優先度がより高いインターフェイスが見つからない場合は、コレクションが有効なコレクションとして扱われません。  
+  
+-   コレクション型には <xref:System.SerializableAttribute> 属性を適用でき、<xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装できます。 これらはいずれも無視されます。 ただし、型がコレクション型の要件を完全に満たしていない場合 \(`Add` メソッドがないなど\)、その型はコレクション型と見なされないため、<xref:System.SerializableAttribute> 属性と <xref:System.Runtime.Serialization.ISerializable> インターフェイスを使用して、型をシリアル化できるかどうかが判断されます。  
+  
+-   コレクションをカスタマイズするために、コレクションに <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用した場合、上記の <xref:System.SerializableAttribute> 代替機構は除去されます。 カスタマイズされたコレクションがコレクション型の要件を満たしていない場合には、代わりに <xref:System.Runtime.Serialization.InvalidDataContractException> 例外がスローされます。 多くの場合、この例外文字列には、指定された型が有効なコレクションと見なされない理由を説明する情報 \(`Add` メソッドがない、既定のコンストラクターがないなど\) が含まれるため、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用することは、しばしばデバッグに役立ちます。  
+  
+### コレクションの名前付け  
+ コレクションの名前付け規則を以下に示します。  
+  
+-   Namespace を使用してオーバーライドしていない場合、すべてのディクショナリ コレクション データ コントラクト、およびプリミティブ型を含むリスト コレクション データ コントラクトの既定の名前空間は、http:\/\/schemas.microsoft.com\/2003\/10\/Serialization\/Arrays です。 このために、組み込みの XSD 型に割り当てられた型と、`char`、`Timespan`、および `Guid` の各型がプリミティブと見なされます。  
+  
+-   Namespace を使用してオーバーライドしていない場合、プリミティブ型以外の型を含むコレクション型の既定の名前空間は、コレクションに含まれる型のデータ コントラクト名前空間と同じです。  
+  
+-   Name を使用してオーバーライドしていない場合、リスト コレクション データ コントラクトの既定の名前は、文字列 "ArrayOf" とコレクションに含まれる型のデータ コントラクト名を組み合わせたものです。 たとえば、Integers のジェネリック List のデータ コントラクト名は "ArrayOfint" です。`Object` のデータ コントラクト名は "anyType" であることに留意してください。したがって、<xref:System.Collections.ArrayList> のような非ジェネリック リストのデータ コントラクト名は、"ArrayOfanyType" になります。  
+  
+ `Name` を使用してオーバーライドしていない場合、ディクショナリ コレクション データ コントラクトの既定の名前は、文字列 "ArrayOfKeyValueOf"、キーの型のデータ コントラクト名、および値の型のデータ コントラクト名をこの順番で組み合わせたものです。 たとえば、String と Integer のジェネリック ディクショナリのデータ コントラクト名は、"ArrayOfKeyValueOfstringint" になります。 また、キーの型と値の型がいずれもプリミティブ型ではない場合は、キーおよび値の型のデータ コントラクト名前空間の名前空間ハッシュが名前に付加されます。 名前空間ハッシュの[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」を参照してください。  
+  
+ 各ディクショナリ コレクション データ コントラクトには、ディクショナリの 1 エントリを表すコンパニオン データ コントラクトが存在します。 コンパニオン データ コントラクトの名前は、"ArrayOf" プレフィックスを除いたディクショナリ データ コントラクトの名前と同じです。また、名前空間は、ディクショナリ データ コントラクトの名前空間と同じです。 たとえば、"ArrayOfKeyValueOfstringint" ディクショナリ データ コントラクトの場合、"KeyValueofstringint" データ コントラクトがディクショナリの 1 エントリを表します。 次のセクションで説明するように、このデータ コントラクトの名前は、`ItemName` プロパティを使用してカスタマイズできます。  
+  
+ 「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」に記載されたジェネリック型の名前付け規則は、コレクション型にすべて適用されます。つまり、Name 内の中かっこを使用してジェネリック型パラメーターを示すことができます。 ただし、かっこ内の数値は、コレクションに含まれる型ではなく、ジェネリック パラメーターを指すことに注意してください。  
+  
+## コレクションのカスタマイズ  
+ <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を次のように使用することは禁止されています。次のように使用すると、<xref:System.Runtime.Serialization.InvalidDataContractException> 例外が発生します。  
+  
+-   <xref:System.Runtime.Serialization.DataContractAttribute> 属性が既に適用されている型、またはその派生型のいずれかに <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用する。  
+  
+-   <xref:System.Runtime.Serialization.CollectionDataContractAttribute> インターフェイスを実装する型に <xref:System.Xml.Serialization.IXmlSerializable> 属性を適用する。  
+  
+-   コレクション型以外の型に <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を適用する。  
+  
+-   ディクショナリ型以外の型に適用された <xref:System.Runtime.Serialization.CollectionDataContractAttribute.KeyName%2A> 属性で、<xref:System.Runtime.Serialization.CollectionDataContractAttribute.ValueName%2A> または <xref:System.Runtime.Serialization.CollectionDataContractAttribute> の設定を試みる。  
+  
+### ポリモーフィズム規則  
+ 既に説明したように、<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を使用してコレクションをカスタマイズすると、コレクションの可換性を妨げることがあります。 カスタマイズされた 2 つのコレクション型を等価と見なすことができるのは、それらの名前、名前空間、項目名、およびキーと値の名前 \(ディクショナリ コレクションの場合\) が一致する場合だけです。  
+  
+ カスタマイズが原因で、あるコレクション データ コントラクトを使用する必要があるところに、誤って別のコレクション データ コントラクトが使用される可能性があります。 このような状況は回避する必要があります。 次の型を参照してください。  
+  
+ [!code-csharp[c_collection_types_in_data_contracts#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_collection_types_in_data_contracts/cs/program.cs#11)]
+ [!code-vb[c_collection_types_in_data_contracts#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_collection_types_in_data_contracts/vb/program.vb#11)]  
+  
+ この場合、`Marks1` のインスタンスは `testMarks` に割り当てることができます。 ただし、`Marks2` は使用しないようにする必要があります。そのデータ コントラクトは、`IList<int>` データ コントラクトと等価とは見なされないからです。 このデータ コントラクト名は、"ArrayOfint" ではなく "Marks2" であり、反復される要素名は、"\<int\>" ではなく "\<mark\>" になります。  
+  
+ 以下の表に、コレクションのポリモーフィックな割り当てに適用される規則を示します。  
+  
+|宣言された型|カスタマイズされていないコレクションの割り当て|カスタマイズされたコレクションの割り当て|  
+|------------|-----------------------------|--------------------------|  
+|オブジェクト|コントラクト名はシリアル化されます。|コントラクト名はシリアル化されます。<br /><br /> カスタマイズが使用されます。|  
+|コレクション インターフェイス|コントラクト名はシリアル化されません。|コントラクト名はシリアル化されません。<br /><br /> カスタマイズは使用されません\*。|  
+|カスタマイズされていないコレクション|コントラクト名はシリアル化されません。|コントラクト名はシリアル化されます。<br /><br /> カスタマイズが使用されます\*\*。|  
+|カスタマイズされたコレクション|コントラクト名はシリアル化されます。 カスタマイズは使用されません\*\*。|コントラクト名はシリアル化されます。<br /><br /> 割り当てられた型のカスタマイズが使用されます\*\*。|  
+  
+ \* <xref:System.Runtime.Serialization.NetDataContractSerializer> クラスでは、このケースでカスタマイズが使用されます。 また、<xref:System.Runtime.Serialization.NetDataContractSerializer> クラスは、このケースで実際の型名もシリアル化するため、逆シリアル化も予期されたとおりに機能します。  
+  
+ \*\* これらのケースでは、スキーマが無効なインスタンスが生成されます。したがって、これらのケースは避けるようにしてください。  
+  
+ コントラクト名をシリアル化する場合、割り当てるコレクション型が既知の型リストに含まれている必要があります。 逆に言うと、名前をシリアル化しない場合は、既知の型リストに型を追加する必要はありません。  
+  
+ 派生型の配列は、基本型の配列に代入できます。 この場合、反復される各要素について、派生型のコントラクト名がシリアル化されます。 たとえば、`Book` 型が `LibraryItem` 型から派生している場合、`Book` の配列を `LibraryItem` の配列に代入できます。 これは、他のコレクション型には適用されません。 たとえば、`Generic List of Book` を `Generic List of LibraryItem` に代入することはできません。 ただし、`Generic List of LibraryItem` インスタンスを含む `Book` を代入することはできます。 配列の場合も、配列ではない場合も、`Book` は既知の型リストに含まれている必要があります。  
+  
+## コレクションとオブジェクト参照の保存  
+ シリアライザーがオブジェクト参照を保存するモードで機能している場合、オブジェクト参照の保存はコレクションにも適用されます。 具体的には、コレクション全体と、コレクションに含まれる個々の項目の両方のオブジェクト ID が保存されます。 ディクショナリの場合、キーと値のペア オブジェクトと、個々のキー オブジェクトおよび値オブジェクトのオブジェクト ID が保存されます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.CollectionDataContractAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/common-security-scenarios.md b/docs/framework/wcf/feature-details/common-security-scenarios.md
new file mode 100644
index 00000000000..4eab1771919
--- /dev/null
+++ b/docs/framework/wcf/feature-details/common-security-scenarios.md
@@ -0,0 +1,91 @@
+---
+title: "一般的なセキュリティ シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], シナリオ"
+ms.assetid: 201923b5-5162-4a8a-8d4c-e7bd242748d5
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# 一般的なセキュリティ シナリオ
+ここでは、考えられるさまざまなクライアントおよびサービスのセキュリティ構成の一覧を示します。構成はさまざまな要因により異なります。たとえば、サービスやクライアントがイントラネット上にあるかどうか、また、セキュリティが Windows とトランスポート \(HTTPS など\) のどちらで提供されるかなどが考えられます。  
+  
+## このセクションの内容  
+ [セキュリティで保護されていないインターネット環境のクライアントとサービス](../../../../docs/framework/wcf/feature-details/internet-unsecured-client-and-service.md)  
+ セキュリティで保護されていないパブリックなクライアントとサービスの例です。  
+  
+ [セキュリティで保護されていないイントラネットのクライアントとサービス](../../../../docs/framework/wcf/feature-details/intranet-unsecured-client-and-service.md)  
+ セキュリティで保護されたプライベートなネットワーク上で [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションに情報を提供するために開発された基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。  
+  
+ [基本認証でのトランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security-with-basic-authentication.md)  
+ アプリケーションは、カスタム認証を使用して、クライアントにログオンを許可します。  
+  
+ [トランスポート セキュリティと Windows 認証](../../../../docs/framework/wcf/feature-details/transport-security-with-windows-authentication.md)  
+ Windows セキュリティによってセキュリティ保護されたクライアントとサービスを示します。  
+  
+ [トランスポート セキュリティと匿名クライアント](../../../../docs/framework/wcf/feature-details/transport-security-with-an-anonymous-client.md)  
+ このシナリオでは HTTPS などのようなトランスポート セキュリティを使用して、機密性と整合性を強化します。  
+  
+ [トランスポート セキュリティと証明書認証](../../../../docs/framework/wcf/feature-details/transport-security-with-certificate-authentication.md)  
+ 証明書によってセキュリティ保護されたクライアントとサービスを示します。  
+  
+ [メッセージ セキュリティと匿名クライアント](../../../../docs/framework/wcf/feature-details/message-security-with-an-anonymous-client.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ セキュリティによってセキュリティ保護されたクライアントとサービスを示します。  
+  
+ [ユーザー名クライアントを使用したメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-with-a-user-name-client.md)  
+ クライアントは、ドメイン ユーザー名とパスワードを使用してクライアントのログオンを許可する Windows フォーム アプリケーションです。  
+  
+ [メッセージ セキュリティと証明書クライアント](../../../../docs/framework/wcf/feature-details/message-security-with-a-certificate-client.md)  
+ サーバー側の証明書は複数あり、クライアント側の証明書はそれぞれ 1 つです。セキュリティのコンテキストは、トランスポート層セキュリティ \(TLS: Transport Layer Security\) ネゴシエーションを介して確立されます。  
+  
+ [Windows クライアントとのメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-with-a-windows-client.md)  
+ 証明書クライアントのバリエーションの 1 つです。サーバー側の証明書は複数あり、クライアント側の証明書はそれぞれ 1 つです。セキュリティのコンテキストは TLS ネゴシエーションを介して確立されます。  
+  
+ [資格情報ネゴシエーションを使用しない Windows クライアントを使用するメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-with-a-windows-client-without-credential-negotiation.md)  
+ Kerberos ドメインによってセキュリティ保護されたクライアントとサービスを示します。  
+  
+ [メッセージ セキュリティと相互の証明書](../../../../docs/framework/wcf/feature-details/message-security-with-mutual-certificates.md)  
+ サーバー側の証明書は複数あり、クライアント側の証明書はそれぞれ 1 つです。サーバーの証明書はアプリケーションと共に配布され、帯域外でも使用可能です。  
+  
+ [発行済みトークンを使用したメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-with-issued-tokens.md)  
+ フェデレーション セキュリティにより独立したドメイン間で信頼を確立できます。  
+  
+ [信頼できるサブシステム](../../../../docs/framework/wcf/feature-details/trusted-subsystem.md)  
+ クライアントは、ネットワーク全体に分散している 1 つ以上の Web サービスにアクセスします。Web サービスは、セキュリティで保護する必要がある追加のリソース \(データベースや他の Web サービスなど\) にアクセスします。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 関連項目  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)  
+  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)  
+  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)  
+  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)  
+  
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)  
+  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+  
+ [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)  
+  
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)  
+  
+## 参照  
+ [セキュリティ ガイドラインとベスト プラクティス](../../../../docs/framework/wcf/feature-details/security-guidance-and-best-practices.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-development.md b/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-development.md
new file mode 100644
index 00000000000..ed11ae8c802
--- /dev/null
+++ b/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-development.md
@@ -0,0 +1,767 @@
+---
+title: "開発者の視点から見た ASP.NET Web サービスと WCF との比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f362d00e-ce82-484f-9d4f-27e579d5c320
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 開発者の視点から見た ASP.NET Web サービスと WCF との比較
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には ASP.NET 互換モードがあります。このモードにすると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを ASP.NET Web サービスと同じようにプログラミングおよび構成し、動作を真似ることができます。  以下のセクションでは、ASP.NET Web サービスと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を、それぞれの技術を使ってアプリケーションを開発する視点から比較してみます。  
+  
+## データ表現  
+ ASP.NET で Web サービスを開発する場合、通常はまず、このサービスが使う複合データ型の定義から始めます。  ASP.NET は <xref:System.Xml.Serialization.XmlSerializer> を利用して、.NET Framework 型で表されたデータを XML 形式に変換してサービスとの間でやり取りしたり、XML 形式で受け取ったデータを .NET Framework オブジェクトに変換したりします。  ASP.NET サービスで使用する複合データ型を定義するには、<xref:System.Xml.Serialization.XmlSerializer> で XML 形式にシリアル化したり、XML 形式から逆シリアル化したりできる .NET Framework クラスの定義が必要です。  クラス定義は手で記述するほか、XML スキーマの型定義から生成することも可能です。それにはコマンド ライン上で実行する XML スキーマ\/データ型サポート ユーティリティである xsd.exe を使います。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> で XML 形式にシリアル化したり、XML 形式から逆シリアル化したりできる .NET Framework クラスを定義する場合に知っておくべき主な事項を次に示します。  
+  
+-   XML に変換されるのは、.NET Framework オブジェクトのパブリック フィールドおよびパブリック プロパティに限ります。  
+  
+-   コレクション クラスのインスタンスを XML 形式にシリアル化できるのは、そのクラスが <xref:System.Collections.IEnumerable> または <xref:System.Collections.ICollection> インターフェイスを実装している場合に限ります。  
+  
+-   <xref:System.Collections.IDictionary> インターフェイスを実装した、<xref:System.Collections.Hashtable> などのクラスを、XML 形式にシリアル化することはできません。  
+  
+-   <xref:System.Xml.Serialization> 名前空間の属性型は、大部分が .NET Framework クラスやそのメンバーに追加可能であり、これにより、XML での当該クラスのインスタンスの表現方法を制御できます。  
+  
+ 通常、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの開発も、複合型の定義から始めます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でも ASP.NET Web サービスと同じ .NET Framework 型を使用できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] <xref:System.Runtime.Serialization.DataContractAttribute> や <xref:System.Runtime.Serialization.DataMemberAttribute> を .NET Framework 型に追加して、ある型のインスタンスを XML にシリアル化できる旨や、当該型のどのフィールドやプロパティを実際にシリアル化できるのかを指定することができます。その例を以下に示します。  
+  
+```  
+//Example One:   
+[DataContract]  
+public class LineItem  
+{  
+    [DataMember]  
+    public string ItemNumber;  
+    [DataMember]  
+    public decimal Quantity;  
+    [DataMember]  
+    public decimal UnitPrice;  
+}  
+  
+//Example Two:   
+public class LineItem  
+{  
+    [DataMember]  
+    private string itemNumber;  
+    [DataMember]  
+    private decimal quantity;  
+    [DataMember]  
+    private decimal unitPrice;  
+  
+    public string ItemNumber  
+    {  
+      get  
+      {  
+          return this.itemNumber;  
+      }  
+  
+      set  
+      {  
+          this.itemNumber = value;  
+      }  
+    }  
+  
+    public decimal Quantity  
+    {  
+        get  
+        {  
+            return this.quantity;  
+        }  
+  
+        set  
+        {  
+            this.quantity = value;  
+        }  
+    }  
+  
+    public decimal UnitPrice  
+    {  
+      get  
+      {  
+          return this.unitPrice;  
+      }  
+  
+      set  
+      {  
+          this.unitPrice = value;  
+      }  
+    }  
+}  
+  
+//Example Three:   
+public class LineItem  
+{  
+     private string itemNumber;  
+     private decimal quantity;  
+     private decimal unitPrice;  
+  
+     [DataMember]  
+     public string ItemNumber  
+     {  
+       get  
+       {  
+          return this.itemNumber;  
+       }  
+  
+       set  
+       {  
+           this.itemNumber = value;  
+       }  
+     }  
+  
+     [DataMember]  
+     public decimal Quantity  
+     {  
+          get  
+          {  
+              return this.quantity;  
+          }  
+  
+          set  
+          {  
+             this.quantity = value;  
+          }  
+     }  
+  
+     [DataMember]  
+     public decimal UnitPrice  
+     {  
+          get  
+          {  
+              return this.unitPrice;  
+          }  
+  
+          set  
+          {  
+              this.unitPrice = value;  
+          }  
+     }  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute> は、当該型の中にシリアル化可能なフィールドやプロパティがあることを示し、具体的にどのフィールドやプロパティをシリアル化できるかを <xref:System.Runtime.Serialization.DataMemberAttribute> で示します。  <xref:System.Runtime.Serialization.DataContractAttribute> はクラスにも構造体にも適用できます。  <xref:System.Runtime.Serialization.DataMemberAttribute> はフィールドやプロパティに適用します。これはパブリックでもプライベートでもかまいません。  <xref:System.Runtime.Serialization.DataContractAttribute> が適用された型のインスタンスのことを、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではデータ コントラクトと呼びます。  これを XML 形式にシリアル化するには <xref:System.Runtime.Serialization.DataContractSerializer> を使います。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> を使う場合と、<xref:System.Xml.Serialization.XmlSerializer> および <xref:System.Xml.Serialization> 名前空間に定義された属性を使う場合の、主な違いを以下に示します。  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> や <xref:System.Xml.Serialization> 名前空間の属性は、XML スキーマで定義された有効な型であればどれにでも .NET Framework 型をマップできるようにするためのものです。これらを使うと、XML での型の表現方法を細かく制御できます。  これに対し、<xref:System.Runtime.Serialization.DataContractSerializer>、<xref:System.Runtime.Serialization.DataContractAttribute>、および <xref:System.Runtime.Serialization.DataMemberAttribute> の場合、XML での型の表現方法にはほとんど自由度がありません。  指定できるのは、名前空間と、型やフィールド、プロパティを XML で表す名前、フィールドやプロパティの XML における並び順だけです。  
+  
+    ```  
+    [DataContract(  
+    Namespace="urn:Contoso:2006:January:29",  
+    Name="LineItem")]  
+    public class LineItem  
+    {  
+         [DataMember(Name="ItemNumber",IsRequired=true,Order=0)]  
+         public string itemNumber;  
+         [DataMember(Name="Quantity",IsRequired=false,Order = 1)]  
+         public decimal quantity;  
+         [DataMember(Name="Price",IsRequired=false,Order = 2)]  
+         public decimal unitPrice;  
+    }  
+    ```  
+  
+     上記以外の事項は、<xref:System.Runtime.Serialization.DataContractSerializer> に固定で組み込まれています。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> の場合、型の XML での表現方法に自由度が小さく、したがってシリアル化のプロセスがあらかじめ大部分予測できるので、最適化が容易です。  <xref:System.Runtime.Serialization.DataContractSerializer> を使えば、性能が約 10% 向上するという現実的な利点があります。  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> を使用する方法では、どのフィールドやプロパティを XML にシリアル化するかを属性で指定することはできませんが、<xref:System.Runtime.Serialization.DataContractSerializer> の場合は <xref:System.Runtime.Serialization.DataMemberAttribute> 属性で明示的に指定できます。  このように、データ コントラクトとは、アプリケーションとの間でやり取りするデータ構造を明示した契約であると言うことができます。  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> で XML 形式に変換できるのは、.NET オブジェクトのパブリック メンバーに限ります。一方 <xref:System.Runtime.Serialization.DataContractSerializer> は、アクセス修飾子にかかわらず、どのメンバーでも変換可能です。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> の場合、パブリックでないメンバーも XML に変換できるため、シリアル化できる .NET 型についての制約が少なくなります。  特に、<xref:System.Collections.Hashtable> など、<xref:System.Collections.IDictionary> インターフェイスを実装した型が変換可能です。  <xref:System.Runtime.Serialization.DataContractSerializer> はさらに、既存の .NET 型のインスタンスを XML にシリアル化する場合でも、型定義を変更したり、ラッパーを定義したりする必要がありません。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> はパブリックでないメンバーも変換できるため、完全に信頼できるコードからしか実行できないようになっています。<xref:System.Xml.Serialization.XmlSerializer> にはそのような制約がありません。  コードの完全信頼アクセス権限とは、当該マシン上のすべてのリソースにアクセスできる権限で、その確認には資格情報を使います。  他のリソースにも制限なくアクセスできるので、このようなコードの取り扱いには十分に注意しなければなりません。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> にはバージョン管理の機能がいくつか組み込まれています。  
+  
+    -   <xref:System.Runtime.Serialization.DataMemberAttribute> には <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティがあります。旧バージョンにはなかったメンバーを追加した場合に、そのプロパティを false とすれば、当該データ コントラクトの新バージョンを扱うアプリケーションが、旧バージョンのデータも扱えるようになります。  
+  
+    -   データ コントラクトに <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装すると、<xref:System.Runtime.Serialization.DataContractSerializer> は、新バージョンのデータ コントラクトで定義されたメンバーを、旧バージョンのコントラクトを扱うアプリケーション経由で受け渡しできるようになります。  
+  
+ 以上のようにさまざまな違いがありますが、<xref:System.Xml.Serialization.XmlSerializer> で既定の設定を使用して型をシリアル化したものは、XML の名前空間を明示的に定義してあれば、<xref:System.Runtime.Serialization.DataContractSerializer> で型をシリアル化したものと意味的に同等です。  次のクラスは、属性が <xref:System.Xml.Serialization.XmlSerializer>、<xref:System.Runtime.Serialization.DataContractAttribute> のどちらのシリアライザーでも変換の対象となり、最終的に得られる XML も意味的に同等です。  
+  
+```  
+[Serializable]  
+[XmlRoot(Namespace="urn:Contoso:2006:January:29")]  
+[DataContract(Namespace="urn:Contoso:2006:January:29")]  
+public class LineItem  
+{  
+     [DataMember]  
+     public string ItemNumber;  
+     [DataMember]  
+     public decimal Quantity;  
+     [DataMember]  
+     public decimal UnitPrice;  
+}  
+  
+```  
+  
+ Windows ソフトウェア開発キット \(SDK\) には [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) というコマンド ライン ツールが収録されています。ASP.NET Web サービスで使用する xsd.exe と同様、Svcutil.exe も XML スキーマから .NET データ型の定義を生成できます。  <xref:System.Runtime.Serialization.DataContractSerializer> が XML スキーマで定義された形式の XML を出力できる場合、型はデータ コントラクトの形に変換されます。そうでなければ、<xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化します。  Svcutil.exe に `/dataContractOnly` スイッチを指定して起動すると、データ コントラクトから XML スキーマを生成できます。  
+  
+> [!NOTE]
+>  ASP.NET Web サービスは <xref:System.Xml.Serialization.XmlSerializer> を使うようになっています。ASP.NET 互換モードの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが ASP.NET Web サービスの動作を真似るようになっていますが、<xref:System.Xml.Serialization.XmlSerializer> を使わなければならないわけではありません。  必要であれば ASP.NET 互換モードでも <xref:System.Runtime.Serialization.DataContractSerializer> も使えるようになっています。  
+  
+## サービスの開発  
+ ASP.NET を使用してサービスを開発する場合、通常は <xref:System.Web.Services.WebService> 属性をクラスに追加し、<xref:System.Web.Services.WebMethodAttribute> を当該クラスのサービスに対する操作メソッドに追加します。  
+  
+```  
+[WebService]  
+public class Service : T:System.Web.Services.WebService  
+{  
+    [WebMethod]  
+    public string Echo(string input)   
+    {  
+       return input;  
+    }  
+}  
+```  
+  
+ ASP.NET 2.0 では、<xref:System.Web.Services.WebService> 属性や <xref:System.Web.Services.WebMethodAttribute> 属性をクラスではなくインターフェイスに追加し、そのインターフェイスを実装するクラスを記述する、という方法も使えるようになりました。  
+  
+```  
+[WebService]  
+public interface IEcho  
+{  
+    [WebMethod]  
+    string Echo(string input);  
+}  
+  
+public class Service : IEcho  
+{  
+  
+   public string Echo(string input)  
+   {  
+        return input;  
+    }  
+}  
+```  
+  
+ <xref:System.Web.Services.WebService> 属性を持つインターフェイスは、サービスによって実行される操作のコントラクトを構成し、またそれをさまざまなクラスで再利用することによって、同じコントラクトをさまざまな方法で実装できるので、このオプションの使用をお勧めします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントをいくつか定義することにより提供されます。  エンドポイントは、アドレス、バインディング、サービス コントラクトで定義します。  アドレスとは、サービスが配備された場所のことです。  バインディングはサービスとの通信方法を表します。  サービス コントラクトとは、サービスが実行できる操作の定義のことです。  
+  
+ サービス コントラクトは通常、インターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> および <xref:System.ServiceModel.OperationContractAttribute> を追加して定義します。  
+  
+```  
+[ServiceContract]  
+public interface IEcho  
+{  
+     [OperationContract]  
+     string Echo(string input);  
+}  
+```  
+  
+ <xref:System.ServiceModel.ServiceContractAttribute> は、当該インターフェイスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス コントラクトを定義することを表します。また、<xref:System.ServiceModel.OperationContractAttribute> は、インターフェイスのどのメソッドが \(存在する場合\) サービス コントラクトの操作を定義しているかを表します。  
+  
+ このようにして定義されたサービス コントラクトをクラスとして実装します。サービス コントラクトを定義するインターフェイスを実装するクラスという形で記述します。  
+  
+```  
+public class Service : IEcho  
+{  
+    public string Echo(string input)  
+    {  
+       return input;  
+    }  
+}  
+```  
+  
+ サービス コントラクトを実装したクラスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではサービスとして参照できます。  
+  
+ 次に、アドレスとバインディングを、サービス型と関連付けます。  これは通常、構成ファイルを直接編集するか、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に収録されている構成エディターを使って行います。  構成ファイルの例を以下に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+     <system.serviceModel>  
+      <services>  
+      <service name="Service ">  
+       <endpoint   
+        address="EchoService"  
+        binding="basicHttpBinding"  
+        contract="IEchoService "/>  
+      </service>  
+      </services>  
+     </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ バインディングは、アプリケーションとの通信に使う一連のプロトコルを表します。  一般的なシステム指定のバインディングを以下に示します。  
+  
+|名前|目的|  
+|--------|--------|  
+|BasicHttpBinding|WS\-BasicProfile 1.1 および Basic Security Profile 1.0 に対応した Web サービスやクライアントとの相互運用性。|  
+|WSHttpBinding|HTTP 上の WS\-\* プロトコルに対応した Web サービスやクライアントとの相互運用性。|  
+|WSDualHttpBinding|双方向 HTTP 通信。最初のメッセージの受信者は送信元に直接は応答せず、代わりに、WS\-\* プロトコルに準拠した HTTP で、ある期間にわたって任意の数の応答を送信することができます。|  
+|WSFederationBinding|HTTP 通信。サービスのリソースに対するアクセスを、明示的に指定された資格情報プロバイダーによって発行された証明書に基づいて制御することができます。|  
+|NetTcpBinding|ネットワーク全体に分散する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソフトウェア エンティティ間の、安全性や信頼性を確保した高速通信。|  
+|NetNamedPipeBinding|同一コンピューター上の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソフトウェア エンティティ間の、安全性や信頼性を確保した高速通信。|  
+|NetMsmqBinding|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソフトウェア エンティティ間の、MSMQ を使用した通信。|  
+|MsmqIntegrationBinding|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソフトウェアと他のソフトウェア エンティティ間の、MSMQ を使用した通信。|  
+|NetPeerTcpBinding|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソフトウェア エンティティ間の、Windows ピアツーピア ネットワークを使用した通信。|  
+  
+ システム指定のバインディングである <xref:System.ServiceModel.BasicHttpBinding> には、ASP.NET Web サービスが対応している一連のプロトコルが組み込まれています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション用の独自バインディングは、バインド要素クラスのコレクションとして定義し、各クラスに個々のプロトコルを実装して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で使えるようにすることができます。  追加のプロトコルを表す、新しいバインド要素を記述することも可能です。  
+  
+ サービス型の内部的な動作は、動作を表すクラス群のプロパティで調整できます。  次の例で、<xref:System.ServiceModel.ServiceBehaviorAttribute> クラスは、サービス型がマルチスレッド処理されることを指定しています。  
+  
+```  
+[ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Multiple]  
+public class DerivativesCalculatorServiceType: IDerivativesCalculator  
+  
+```  
+  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> など、属性として定義された動作もあります。  これに対し、管理者がプロパティを設定できる動作は、アプリケーションの構成ファイルで変更することができます。  
+  
+ サービス型のプログラムの記述には、多くの場合 <xref:System.ServiceModel.OperationContext> クラスを使います。  静的プロパティである <xref:System.ServiceModel.OperationContext.Current%2A> を介して、実行コンテキストに関する情報にアクセスできます。  <xref:System.ServiceModel.OperationContext> の使い方は、<xref:System.Web.HttpContext> クラスや <xref:System.EnterpriseServices.ContextUtil> クラスと同様です。  
+  
+## ホスト  
+ ASP.NET Web サービスは、コンパイルしてクラス ライブラリ アセンブリの形になっています。  サービス ファイルという、拡張子が .asmx のファイルの `@ WebService` ディレクティブに、サービスの実行コードが組み込まれたクラスと、これを収容するアセンブリが定義されています。  
+  
+```  
+<%@ WebService Language="C#" Class="Service,ServiceAssembly" %>  
+```  
+  
+ サービス ファイルをインターネット インフォメーション サービス \(IIS\) の ASP.NET アプリケーション ルート、アセンブリをアプリケーション ルートのサブディレクトリ \\bin 以下にコピーすると、  このサービス ファイルの URL \(Uniform Resource Locator\) でアプリケーションにアクセスできるようになります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、IIS 5.1 や 6.0 の他、IIS 7.0 の一部として提供される Windows プロセス アクティブ化サービス \(WAS\) や、.NET アプリケーション上でホストすることができます。  ただし IIS 5.1\/6.0 の場合、通信トランスポート プロトコルは HTTP に限ります。  
+  
+ IIS 5.1\/6.0 または WAS 上でサービスをホストする手順を以下に示します。  
+  
+1.  サービス型をコンパイルしてクラス ライブラリ アセンブリを生成します。  
+  
+2.  拡張子を .svc としたサービス ファイルを作り、サービス型を `@ ServiceHost` ディレクティブで次のように指定します。  
+  
+    ```  
+    <%@ServiceHost language=”c#” Service="MyService" %>  
+    ```  
+  
+3.  サービス ファイルを仮想ディレクトリにコピーし、アセンブリをその仮想ディレクトリの \\bin サブディレクトリにコピーします。  
+  
+4.  構成ファイルを仮想ディレクトリに、Web.config という名前でコピーします。  
+  
+ するとアプリケーションには、アプリケーション ルートに置いたサービス ファイルの URL でアクセスできるようになります。  
+  
+ .NET アプリケーション上で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする場合は、サービス型をコンパイルしてクラス ライブラリ アセンブリを生成し、これをアプリケーションが参照できるようにします。アプリケーション側では、<xref:System.ServiceModel.ServiceHost> クラスを使って、サービスを管理できるようプログラムを記述します。  サービスを管理する基本的なプログラムの例を以下に示します。  
+  
+```  
+string httpBaseAddress = "http://www.contoso.com:8000/";  
+string tcpBaseAddress = "net.tcp://www.contoso.com:8080/";  
+  
+Uri httpBaseAddressUri = new Uri(httpBaseAddress);  
+Uri tcpBaseAddressUri = new Uri(tcpBaseAddress);  
+  
+Uri[] baseAdresses = new Uri[] {   
+ httpBaseAddressUri,  
+ tcpBaseAddressUri};  
+  
+using(ServiceHost host = new ServiceHost(  
+typeof(Service), //”Service” is the name of the service type baseAdresses))  
+{  
+     host.Open();  
+  
+     […] //Wait to receive messages  
+     host.Close();  
+}  
+```  
+  
+ この例では <xref:System.ServiceModel.ServiceHost> の構築時にトランスポート プロトコルに対してアドレスを指定しています。  このアドレスをベース アドレスと呼びます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのエンドポイントは、エンドポイントのホストに設定されたベース アドレスから見た相対アドレスで表します。  ホストではトランスポート プロトコルごとに 1 つベース アドレスを設定できます。  上記の構成ファイルの構成例では、エンドポイントに対して選択された <xref:System.ServiceModel.BasicHttpBinding> はトランスポート プロトコルとして HTTP を使用しているので、エンドポイント `EchoService` のアドレスは、HTTP に対して設定されたベース アドレスを基準としたものになります。  上記の例に挙げたホストの場合、HTTP ベース アドレスは http:\/\/www.contoso.com:8000\/ です。  なお、IIS や WAS 上でホストされているサービスの場合、ベース アドレスはサービス ファイルの URL になります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を ASP.NET 互換モードで動かせるのは、IIS や WAS 上でホストされていて、トランスポート プロトコルとしてもっぱら HTTP を使うサービスに限ります。  ASP.NET 互換モードは、次の 2 つの手順で切り替えます。  
+  
+1.  プログラムの開発者は、サービス型に <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> 属性を追加し、ASP.NET 互換モードに切り替えることができる、または切り替えることが必須である旨の指定をしておく必要があります。  
+  
+    ```  
+    [System.ServiceModel.Activation.AspNetCompatibilityRequirements(  
+          RequirementsMode=AspNetCompatbilityRequirementsMode.Require)]  
+    public class DerivativesCalculatorServiceType: IDerivativesCalculator  
+    ```  
+  
+2.  管理者は、アプリケーションが ASP.NET 互換モードで動作するよう、次のように構成する必要があります。  
+  
+    ```  
+    <configuration>  
+         <system.serviceModel>  
+          <services>  
+          […]  
+          </services>  
+          <serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>  
+        </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、サービス ファイルの拡張子として .svc ではなく .asmx を使用するように構成することも可能です。  
+  
+    ```  
+    <system.web>  
+         <compilation>  
+          <compilation debug="true">  
+          <buildProviders>  
+           <remove extension=".asmx"/>  
+           <add extension=".asmx"   
+            type="System.ServiceModel.ServiceBuildProvider,   
+            Systemm.ServiceModel,   
+            Version=3.0.0.0,   
+            Culture=neutral,   
+            PublicKeyToken=b77a5c561934e089" />  
+          </buildProviders>  
+          </compilation>  
+         </compilation>  
+    </system.web>  
+    ```  
+  
+     このように構成すると、.asmx サービス ファイルの URL を使用するようクライアント側を変更しなくても、サービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用するようになります。  
+  
+## クライアント開発  
+ ASP.NET Web サービスのクライアントの開発にはコマンド ライン ツール WSDL.exe を使用します。.asmx ファイルの URL を入力として指定します。  これに対応する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のツールは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) です。  これは、サービス コントラクトおよび [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスの定義から、コード モジュールを生成します。  また、サービスのアドレスとバインディングを指定して、構成ファイルを生成することもできます。  
+  
+ リモート サービスのクライアントを開発する場合、通常は、非同期パターンに従ってプログラムを記述するようお勧めします。  WSDL.exe ツールは、特段の指定をしなくても、同期パターンと非同期パターンを使ったコードをそれぞれ生成します。  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) は、どちらのパターンのコードでも生成できます。  特に指定しなければ同期パターン用です。  `/async` スイッチを指定して実行すれば、生成されるコードは非同期パターン用になります。  
+  
+ ASP.NET の WSDL.exe で生成した [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスの名前が、Svcutil.exe で生成した [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスの名前と一致するとは限りません。  特に、<xref:System.Xml.Serialization.XmlSerializer> でシリアル化したクラスのプロパティ名は、Svcutil.exe で生成した場合 "Property" という接頭辞が付きますが、WSDL.exe の場合はそうなりません。  
+  
+## メッセージ表現  
+ ASP.NET Web サービスとやり取りする SOAP メッセージのヘッダーはカスタマイズ可能です。  <xref:System.Web.Services.Protocols.SoapHeader> の派生クラスでヘッダーの構造を定義し、<xref:System.Web.Services.Protocols.SoapHeaderAttribute> でヘッダーが存在することを指定します。  
+  
+```  
+public class SomeProtocol : SoapHeader  
+{  
+     public long CurrentValue;  
+     public long Total;  
+}  
+  
+[WebService]  
+public interface IEcho  
+{  
+     SomeProtocol ProtocolHeader  
+     {  
+      get;  
+     set;  
+     }  
+  
+     [WebMethod]  
+     [SoapHeader("ProtocolHeader")]  
+     string PlaceOrders(PurchaseOrderType order);  
+}  
+  
+public class Service: WebService, IEcho  
+{  
+     private SomeProtocol protocolHeader;  
+  
+     public SomeProtocol ProtocolHeader  
+     {  
+         get  
+         {  
+              return this.protocolHeader;  
+         }  
+  
+         set  
+         {  
+              this.protocolHeader = value;  
+         }  
+     }  
+  
+     string PlaceOrders(PurchaseOrderType order)  
+     {  
+         long currentValue = this.protocolHeader.CurrentValue;  
+     }  
+}  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、サービスとやり取りする SOAP メッセージの構造を記述する、<xref:System.ServiceModel.MessageContractAttribute>、<xref:System.ServiceModel.MessageHeaderAttribute>、および <xref:System.ServiceModel.MessageBodyMemberAttribute> という属性があります。  
+  
+```  
+[DataContract]  
+public class SomeProtocol  
+{  
+     [DataMember]  
+     public long CurrentValue;  
+     [DataMember]  
+     public long Total;  
+}  
+  
+[DataContract]  
+public class Item  
+{  
+     [DataMember]  
+     public string ItemNumber;  
+     [DataMember]  
+     public decimal Quantity;  
+     [DataMember]  
+     public decimal UnitPrice;  
+}  
+  
+[MessageContract]  
+public class ItemMesage  
+{  
+     [MessageHeader]  
+     public SomeProtocol ProtocolHeader;  
+     [MessageBody]  
+     public Item Content;  
+}  
+  
+[ServiceContract]  
+public interface IItemService  
+{  
+     [OperationContract]  
+     public void DeliverItem(ItemMessage itemMessage);  
+}  
+```  
+  
+ この構文でメッセージ構造を明示的に記述できますが、ASP.NET Web サービスのコードからメッセージ構造を導くことも可能です。  ASP.NET の構文では、メッセージ ヘッダーは上記の例の `ProtocolHeader` のようにサービスのプロパティとして表現されますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではメッセージのプロパティとしてより厳密に表現できます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではさらに、エンドポイントの構成にメッセージ ヘッダーを追加することも可能です。  
+  
+```  
+<service name="Service ">  
+     <endpoint   
+      address="EchoService"  
+      binding="basicHttpBinding"  
+      contract="IEchoService ">  
+      <headers>  
+      <dsig:X509Certificate   
+       xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">  
+       ...  
+      </dsig:X509Certificate>  
+      </headers>  
+     </endpoint>  
+</service>  
+  
+```  
+  
+ この方法では、クライアントやサービスのコード内で、基盤となるプロトコル ヘッダーを参照しなくても済みます。エンドポイントが適切に構成されているので、ヘッダーがメッセージ中に取り込まれるからです。  
+  
+## サービスの説明  
+ WSDL で記述したクエリを HTTP GET 要求として発行して、ASP.NET Web サービスの .asmx ファイルを取得しようとすると、ASP.NET は WSDL によるサービス記述を生成し、  要求に対する応答として返します。  
+  
+ ASP.NET 2.0 では、サービスが Web Services\-Interoperability Organization \(WS\-I\) の Basic Profile 1.1 に準拠していることを検証し、その旨を WSDL による記述に追加できるようになりました。  この処理には、<xref:System.Web.Services.WebServiceBindingAttribute> 属性の `ConformsTo` および `EmitConformanceClaims` パラメーターを使用します。  
+  
+```  
+  
+[WebService(Namespace = "http://tempuri.org/")]  
+[WebServiceBinding(  
+     ConformsTo = WsiProfiles.BasicProfile1_1,  
+     EmitConformanceClaims=true)]  
+public interface IEcho  
+```  
+  
+ ASP.NET が WSDL で生成したサービス記述はカスタマイズ可能です。  <xref:System.Web.Services.Description.ServiceDescriptionFormatExtension> の派生クラスを作成し、WSDL による記述に項目を追加する、という形でカスタマイズします。  
+  
+ WSDL で記述したクエリを HTTP GET 要求として発行して、IIS 5.1\/6.0 または WAS でホストされていて HTTP エンドポイントを持つ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの .svc ファイルを取得しようとすると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は WSDL によるサービス記述を生成して返します。  httpGetEnabled が true に設定されている場合は、WSDL で記述したクエリを HTTP GET 要求として、.NET アプリケーション上でホストされているサービスの HTTP ベース アドレスに発行しても同じ効力があります。  
+  
+ 一方、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-MetadataExchange 要求に対しても、WSDL によるサービス記述を生成して返します。  ASP.NET Web サービスには、WS\-MetadataExchange 要求に応答する機能がありません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が WSDL で生成したサービス記述は広範なカスタマイズが可能です。  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> クラスには、WSDL による記述をカスタマイズするための機能がいくつか組み込まれています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] も、WSDL による記述を生成する代わりに、所定の URL に置いた静的な WSDL ファイルを使用するように構成できます。  
+  
+```  
+<behaviors>  
+     <behavior name="DescriptionBehavior">  
+     <metadataPublishing   
+      enableMetadataExchange="true"   
+      enableGetWsdl="true"   
+      enableHelpPage="true"   
+      metadataLocation=  
+      "http://localhost/DerivativesCalculatorService/Service.WSDL"/>  
+     </behavior>  
+</behaviors>  
+```  
+  
+## 例外処理  
+ ASP.NET Web サービスでは、処理できない例外が発生すると、SOAP エラーとしてクライアントに返されます。  また、<xref:System.Web.Services.Protocols.SoapException> クラスのインスタンスを明示的にスローして、クライアント側に SOAP エラーの詳しい状況を通知し、より適切に管理させることも可能です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、処理できない例外が発生しても SOAP エラーとしてクライアントに返すことはありません。重要な情報が不用意に表示され、第三者に漏洩するのを防ぐためです。  ただしデバッグ目的で、このような例外をクライアントに返すように設定することは可能です。  
+  
+ SOAP エラーをクライアントに返す場合、データ コントラクト型を汎用型 <xref:System.ServiceModel.FaultException%601> のインスタンスとしてキャストし、これをスローする方法が使えます。  また、操作に <xref:System.ServiceModel.FaultContractAttribute> 属性を追加して、操作で生じうるエラーを指定する方法もあります。  
+  
+```  
+[DataContract]  
+public class MathFault  
+{   
+     [DataMember]  
+     public string operation;  
+     [DataMember]  
+     public string problemType;  
+}  
+  
+[ServiceContract]  
+public interface ICalculator  
+{  
+     [OperationContract]  
+     [FaultContract(typeof(MathFault))]  
+     int Divide(int n1, int n2);  
+}  
+```  
+  
+ これにより、サービスで発生する可能性のあるエラーが WSDL の形で公開されます。クライアント側の開発者は、当該操作によりどのようなエラーが生じうるかをあらかじめ予測し、catch ブロック内に適切な処理を組み込んでおくことができます。  
+  
+```  
+try  
+{  
+     result = client.Divide(value1, value2);  
+}  
+catch (FaultException<MathFault> e)  
+{  
+ Console.WriteLine("FaultException<MathFault>: Math fault while doing "   
+  + e.Detail.operation   
+  + ". Problem: "   
+  + e.Detail.problemType);  
+}  
+```  
+  
+## 状態管理  
+ ASP.NET Web サービスの実装には <xref:System.Web.Services.WebService> の派生クラスを使うこともできます。  
+  
+```  
+public class Service : WebService, IEcho  
+{  
+  
+ public string Echo(string input)  
+ {  
+  return input;  
+ }  
+}  
+```  
+  
+ この場合、基本クラス <xref:System.Web.Services.WebService> に定義された Context プロパティを使って、<xref:System.Web.HttpContext> オブジェクトにアクセスすることになります。  <xref:System.Web.HttpContext> オブジェクトには、アプリケーションやセッションの状態情報をそれぞれ更新、取得する、Application プロパティ、Session プロパティがあります。  
+  
+ ASP.NET では、<xref:System.Web.HttpContext> の Session プロパティでアクセスするセッション状態情報の、実際の格納場所を細かく制御できます。  格納場所としては、クッキー内、データベース内、稼動中のサーバーのメモリ上、状態管理用の特別なサーバーのメモリ上があり、  サービスの構成ファイルで指定します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、状態管理用に拡張可能なオブジェクトがいくつか用意されています。  いずれも <xref:System.ServiceModel.IExtensibleObject%601> を実装しています。  中でも重要な拡張可能オブジェクトは、<xref:System.ServiceModel.ServiceHostBase> および <xref:System.ServiceModel.InstanceContext> です。  `ServiceHostBase` を使用すると、同一ホスト上の全サービス型のあらゆるインスタンスからアクセスできる状態を管理できます。一方、`InstanceContext` を使用すると、同じサービス型のインスタンス内で実行されるコードからアクセスできる状態を管理できます。  
+  
+ 次の例で、サービス型 `TradingSystem` には <xref:System.ServiceModel.ServiceBehaviorAttribute> という属性があります。同じ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント インスタンスからの呼び出しはすべて、同じサービス型のインスタンスに転送されることを表します。  
+  
+```  
+[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]  
+public class TradingSystem: ITradingService  
+```  
+  
+ 次のクラス `DealData` に定義されている状態には、同じサービス型のインスタンス内で実行されるどのコードからでもアクセスできます。  
+  
+```  
+internal class DealData: IExtension<InstanceContext>  
+{  
+ public string DealIdentifier = null;  
+ public Trade[] Trades = null;  
+}  
+```  
+  
+ サービス コントラクトの操作のいずれかを実装するサービス型のコードでは、状態オブジェクト `DealData` を、当該サービス型の現在のインスタンスに関する状態として追加することができます。  
+  
+```  
+string ITradingService.BeginDeal()  
+{  
+ string dealIdentifier = Guid.NewGuid().ToString();  
+ DealData state = new DealData(dealIdentifier);  
+ OperationContext.Current.InstanceContext.Extensions.Add(state);  
+ return dealIdentifier;  
+}  
+```  
+  
+ この状態オブジェクトは、サービス コントラクトの他の操作を実装するコードから取得、更新できます。  
+  
+```  
+void ITradingService.AddTrade(Trade trade)  
+{  
+ DealData dealData =  OperationContext.Current.InstanceContext.Extensions.Find<DealData>();  
+ dealData.AddTrade(trade);  
+}  
+```  
+  
+ ASP.NET では <xref:System.Web.HttpContext> クラスで管理する状態情報の実際の格納場所を制御できますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の場合、少なくとも初期バージョンのままでは、まったく制御ができません。  これも [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの ASP.NET 互換モードを推奨する理由の 1 つです。  このような制御が不可欠な応用の場合、ASP.NET 互換モードにすれば、ASP.NET と同様に <xref:System.Web.HttpContext> クラスの機能を活用できるばかりでなく、<xref:System.Web.HttpContext> クラスで管理する状態情報の実際の格納場所も制御できます。  
+  
+## セキュリティ  
+ ASP.NET Web サービスのセキュリティ保全の手順は、IIS アプリケーションのセキュリティ保全の手順と同じです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは IIS に限らずどんな .NET 実行可能ファイル上でも動作するので、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションのセキュリティ保全の手順も IIS の機能に依存しないものにする必要があります。  しかし ASP.NET Web サービスが提供する機能は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスからも、ASP.NET 互換モードで動作していれば利用できます。  
+  
+### セキュリティ : 認証  
+ IIS にはアプリケーションへのアクセス制御機能が組み込まれており、匿名アクセスの他、Windows 認証、ダイジェスト認証、基本認証、.NET パスポート認証など、さまざまな認証モードを切り替えることができます。  Windows 認証は、ASP.NET Web サービスへのアクセス制御に使えます。  しかし [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを IIS 上でホストする場合、アプリケーションへの匿名アクセスを許可するように IIS を構成し、認証処理は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 自身で、Windows 認証その他により行えるようにしなければなりません。  他の認証方法としては、ユーザー名トークン、X.509 証明書、SAML トークン、CardSpace カードなどが組み込まれていますが、独自の認証機構を定義することも可能です。  
+  
+### セキュリティ : 偽装  
+ ASP.NET Web サービスは ASP.NET の ID 要素を使用して、あるユーザーに偽装することができます。あらかじめ設定した特定のユーザーでなくても、要求に資格情報が添えられていれば、その要求元ユーザーに偽装できます。  ASP.NET 互換モードで動作する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでは、この要素を使って偽装を構成できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、特定のユーザーに偽装する、独自の ID 要素を設定できるようになっています。  また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアント側とサービス側で、別々に偽装を構成できます。  クライアント側では、要求を送信する現在のユーザーに偽装する構成が可能です。  
+  
+```  
+<behaviors>  
+     <behavior name="DerivativesCalculatorClientBehavior">  
+      <clientCredentials>  
+      <windows allowedImpersonationLevel="Impersonation"/>  
+      </clientCredentials>  
+     </behavior>  
+</behaviors>  
+```  
+  
+ サービス側では、現在の要求と共に提供された資格情報のユーザーに偽装するように構成できます。  
+  
+```  
+[OperationBehavior(Impersonation = ImpersonationOption.Required)]  
+public void Receive(Message input)  
+```  
+  
+### セキュリティ : アクセス制御リストによる承認  
+ アクセス制御リスト \(ACL\) を使って .asmx ファイルへのアクセスを制限できます。  しかし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の .svc ファイルに対しては、ASP.NET 互換モードでない限り、ACL でアクセス制限することはできません。  
+  
+### セキュリティ : ロール ベースの承認  
+ IIS の Windows 認証オプションを、ASP.NET 構成言語の承認要素と組み合わせて使用すると、ASP.NET Web サービスに対し、各ユーザーが属する Windows グループに基づくロール ベースの承認機構を提供できます。  ASP.NET 2.0 には、より汎用的なロール ベースの承認機構である、ロール プロバイダーが導入されました。  
+  
+ ロール プロバイダーとは、ユーザーが割り当てられたロールに関する問い合わせを行う、基本インターフェイスを実装したクラス群です。各ロール プロバイダーには、さまざまな情報源から必要な情報を取得する手段が組み込まれています。  ASP.NET 2.0 には、Microsoft SQL Server データベースからロールの割り当てを検索できるロール プロバイダーと、Windows Server 2003 承認マネージャーから検索できるロール プロバイダーがあります。  
+  
+ .NET アプリケーションでは、ロール プロバイダーの機構は ASP.NET と独立に使われています。これは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションも同様です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション用の構成例を以下に示します。このように、ASP.NET のロール プロバイダーの使い方は、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> で選択できます。  
+  
+```  
+<system.serviceModel>  
+     <services>  
+         <service name="Service.ResourceAccessServiceType"   
+             behaviorConfiguration="ServiceBehavior">  
+             <endpoint   
+              address="ResourceAccessService"   
+              binding="wsHttpBinding"   
+              contract="Service.IResourceAccessContract"/>  
+         </service>  
+     </services>  
+     <behaviors>  
+       <behavior name="ServiceBehavior">  
+       <serviceAuthorization principalPermissionMode="UseAspNetRoles"/>  
+      </behavior>  
+     </behaviors>  
+</system.serviceModel>  
+```  
+  
+### セキュリティ : クレーム ベースの承認  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に導入された革新的な機能の 1 つで、保護されたリソースへのアクセスを、クレーム ベースで承認するというものです。  クレームは、型、権限、および値で構成されます。たとえば、運転免許証を考えてみましょう。  ここには所持者に関する誕生日などの情報 \(ここでいう「クレーム」\) が記載されています。  つまり、クレームの型は「誕生日」、値は運転者の実際の誕生日です。  また、クレームの権限は、所持者がこの値に対してできることを表します。  誕生日について言えば、所持者はこの情報を「見る」ことはできますが、「書き換える」ことはできません。  クレーム ベースの承認は、ロール ベースの承認を包含する概念です。というのも、ロールはクレームの 1 つの型であると考えることができるからです。  
+  
+ クレーム ベースの承認では、一連のクレームを操作のアクセス要求と比較し、その結果に応じてアクセスを許可または拒否します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、クレーム ベースの承認を実行するクラスも、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> の `ServiceAuthorizationManager` プロパティで指定します。  
+  
+```  
+<behaviors>  
+     <behavior name='ServiceBehavior'>  
+     <serviceAuthorization   
+     serviceAuthorizationManagerType=  
+                   'Service.AccessChecker, Service' />  
+     </behavior>  
+</behaviors>  
+```  
+  
+ クレーム ベースの承認を行うクラスは、<xref:System.ServiceModel.ServiceAuthorizationManager> を継承し、`AccessCheck()` メソッドだけをオーバーライドして定義します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、このメソッドを、サービスの操作が起動されたときに呼び出します。該当するユーザーのクレームを `ServiceSecurityContext.AuthorizationContext` プロパティに設定した、<xref:System.ServiceModel.OperationContext> オブジェクトを引数として渡します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、提示されたセキュリティ トークンからユーザーに関するクレームを抽出、アセンブルし、要求された操作を許可してもよいかどうかを評価します。  
+  
+ どのようなセキュリティ トークンからでも自動的にクレームをアセンブルできることが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の革新的な技術です。これにより、認証機構と完全に独立して、クレーム ベースの承認を行うコードを実装できるようになりました。  これに対し、ACL やロール ベースの承認は、Windows 認証と密に関連し合っています。  
+  
+### セキュリティ : 機密性  
+ ASP.NET Web サービスとの間でやり取りするメッセージの機密性は、トランスポート層で、IIS 上のアプリケーションが Secure Hypertext Transfer Protocol \(HTTPS\) を使うように構成することによって確保します。  IIS 上でホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションについても同様です。  しかし、IIS 以外でホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションも、安全なトランスポート プロトコルを使うように構成できます。  さらに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、メッセージを転送前に WS\-Security プロトコルにより保護するように構成することも可能です。  メッセージの本体を WS\-Security で保護することにより、最終送信先に到達するまでの中継ノードで機密が洩れないようにすることができます。  
+  
+## グローバリゼーション  
+ ASP.NET 構成言語では、個々のサービスごとにカルチャを指定することができます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でこの設定ができるのは、ASP.NET 互換モードの場合に限ります。  ASP.NET 互換モードでない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをローカライズするためには、サービス型をコンパイルしてカルチャごとのアセンブリを生成し、エンドポイントもカルチャごとのアセンブリそれぞれについて用意する必要があります。  
+  
+## 参照  
+ [使用目的と使用標準に基づく ASP.NET Web サービスと WCF との比較](../../../../docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md b/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md
new file mode 100644
index 00000000000..5b399928168
--- /dev/null
+++ b/docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md
@@ -0,0 +1,27 @@
+---
+title: "使用目的と使用標準に基づく ASP.NET Web サービスと WCF との比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d3890278-fa9b-4902-91ea-8da73b7143cc
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 使用目的と使用標準に基づく ASP.NET Web サービスと WCF との比較
+ASP.NET Web サービスは、HTTP 上で SOAP \(Simple Object Access Protocol\) を使用してメッセージを送受信するアプリケーションを構築するために開発されました。  メッセージ構造は XML スキーマを使用して定義できます。また、.NET Framework オブジェクトに対するメッセージのシリアル化を容易にするツールも提供されています。  このテクノロジを使用すると、Web サービス記述言語 \(WSDL\) で Web サービスを記述するメタデータが自動で生成されます。また、WSDL から Web サービス用のクライアントを生成する別のツールも用意されています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、.NET Framework アプリケーションで他のソフトウェア エンティティとメッセージを交換できます。  既定では SOAP が使用されますが、任意の形式のメッセージを使用でき、任意のトランスポート プロトコルを使用してメッセージを伝達できます。  メッセージ構造は XML スキーマを使用して定義できます。また、.NET Framework オブジェクトに対するメッセージをシリアル化するさまざまなオプションがあります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、このテクノロジで構築されたアプリケーションを WSDL で記述するメタデータが自動で生成されます。また、WSDL からこのようなアプリケーション用のクライアントを生成するツールも用意されています。  
+  
+ ASP.NET Web サービスでサポートされる標準については、「[ASP.NET を使用して作成された XML Web サービス](http://go.microsoft.com/fwlink/?LinkId=94872)」を参照してください。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされる標準の詳細な一覧については、「[システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)」を参照してください。  
+  
+## 参照  
+ [開発者の視点から見た ASP.NET Web サービスと WCF との比較](../../../../docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-development.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/comparing-transactions-in-com-and-servicemodel.md b/docs/framework/wcf/feature-details/comparing-transactions-in-com-and-servicemodel.md
new file mode 100644
index 00000000000..d9d3b60374f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/comparing-transactions-in-com-and-servicemodel.md
@@ -0,0 +1,31 @@
+---
+title: "COM+ と ServiceModel でのトランザクションの比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e493bcdd-b91a-4486-853f-83dbcd1931b7
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# COM+ と ServiceModel でのトランザクションの比較
+このトピックでは、トランザクション COM\+ サービスの動作を、<xref:System.ServiceModel> 名前空間で定義された [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 属性を使用してシミュレートする方法について説明します。  
+  
+## ServiceModel 属性を使った COM\+ のエミュレート  
+ 次の表では、`EnterpriseServices` トランザクションの生成に使用される <xref:System.EnterpriseServices.TransactionOption> 列挙体の各値を比較し、<xref:System.ServiceModel> 名前空間で定義された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 属性との関連を示します。  
+  
+|COM\+ 属性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 属性|  
+|--------------|----------------------------------------------------------------|  
+|RequiresNew|<xref:System.ServiceModel.TransactionFlowAttribute> が <xref:System.ServiceModel.TransactionFlowOption> に設定されます。<br /><br /> <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> は `true` です。<br /><br /> バインド要素の `TransactionFlow` 属性は `false` です。|  
+|必須|<xref:System.ServiceModel.TransactionFlowAttribute> が <xref:System.ServiceModel.TransactionFlowOption> に設定されます。<br /><br /> <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> は `true` です。<br /><br /> バインド要素の `TransactionFlow` 属性は `true` です。|  
+|サポート状況|同等の属性はありません。  一般に、`Required` を指定した場合の動作を採用することをお勧めします。|  
+|NotSupported|<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> は `false` です。<br /><br /> バインド要素の `TransactionFlow` 属性は `false` です。|  
+|Disabled|同等の属性はありません。  一般に、`NotSupported` を指定した場合の動作を採用することをお勧めします。|
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/config-wcf-service-with-aspnet-web-service.md b/docs/framework/wcf/feature-details/config-wcf-service-with-aspnet-web-service.md
new file mode 100644
index 00000000000..db157f1d756
--- /dev/null
+++ b/docs/framework/wcf/feature-details/config-wcf-service-with-aspnet-web-service.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : WCF サービスおよび ASP.NET Web サービス クライアントを相互運用するために構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48e1cd90-de80-4d6c-846e-631878955762
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : WCF サービスおよび ASP.NET Web サービス クライアントを相互運用するために構成する
+構成する、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]と相互運用できるようにするサービス エンドポイント[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)]Web サービス クライアントを使用して、 <xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName>サービス エンドポイントのバインディングの種類として。  
+  
+ 必要に応じて、HTTPS およびトランスポート レベルのクライアント認証のサポートをバインディングで有効にできます。 [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)]Web サービス クライアントは MTOM メッセージ エンコーディングをサポートしていないため、 <xref:System.ServiceModel.BasicHttpBinding.MessageEncoding%2A?displayProperty=fullName>プロパティは、既定値は、これは残しておく必要が<xref:System.ServiceModel.WSMessageEncoding?displayProperty=fullName>します。 ASP.Net Web サービス クライアントは、Ws-security をサポートしていないため、 <xref:System.ServiceModel.BasicHttpBinding.Security%2A?displayProperty=fullName>に設定する必要があります<xref:System.ServiceModel.BasicHttpSecurityMode>します。  
+  
+ メタデータを有効にする、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]に利用できるサービス[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)]Web サービス プロキシ生成ツール (つまり、 [Web サービス記述言語ツール (Wsdl.exe)](http://go.microsoft.com/fwlink/?LinkId=73833)、 [Web サービス検出ツール (Disco.exe)](http://go.microsoft.com/fwlink/?LinkId=73834)、および Visual Studio で Web 参照の追加機能)、HTTP GET メタデータ エンドポイントを公開する必要があります。  
+  
+### <a name="to-add-a-wcf-endpoint-that-is-compatible-with-aspnet-web-service-clients-in-code"></a>コードを使用して ASP.NET Web サービス クライアントと互換性のある WCF エンドポイントを追加するには  
+  
+1.  新しい<xref:System.ServiceModel.BasicHttpBinding>インスタンス  
+  
+2.  必要に応じてこのサービス エンドポイント バインディングのトランスポート セキュリティを有効にするバインディングのセキュリティ モードを設定して<xref:System.ServiceModel.BasicHttpSecurityMode>します。 詳細については、「[トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security.md)します。  
+  
+3.  上で作成したバインディング インスタンスを使用して、サービス ホストに新しいアプリケーション エンドポイントを追加します。 コードでサービス エンドポイントを追加する方法の詳細については、「、[方法: コードでサービス エンドポイントを作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md)します。  
+  
+4.  サービス用に HTTP/GET メタデータのエンドポイントを有効にします。 詳細をご覧ください[方法: サービスを使用してコードのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)します。  
+  
+### <a name="to-add-a-wcf-endpoint-that-is-compatible-with-aspnet-web-service-clients-in-a-configuration-file"></a>構成ファイルを使用して ASP.NET Web サービス クライアントと互換性のある WCF エンドポイントを追加するには  
+  
+1.  新しい<xref:System.ServiceModel.BasicHttpBinding>バインド構成します。 詳細については、「、[方法: 構成では、サービス バインドを指定](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)します。  
+  
+2.  必要に応じてこのサービス エンドポイントのバインディング構成のトランスポート セキュリティを有効にするバインディングのセキュリティ モードを設定して<xref:System.ServiceModel.BasicHttpSecurityMode>します。 詳細については、「[トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security.md)します。  
+  
+3.  上で作成したバインド構成を使用して、サービスに新しいアプリケーション エンドポイントを構成します。 構成ファイルでサービス エンドポイントを追加する方法の詳細については、「、[方法: 構成でサービス エンドポイントを作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)します。  
+  
+4.  サービス用に HTTP/GET メタデータのエンドポイントを有効にします。 詳細情報を参照してください、[方法: 構成ファイルを使用して、サービスのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)します。  
+  
+## <a name="example"></a>例  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービス クライアントと互換性のある [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] エンドポイントをコードおよび構成ファイルで追加する方法を次のコード例に示します。  
+  
+ [!code-csharp[C_HowTo-WCFServiceAndASMXClient#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/cs/program.cs#0)]
+ [!code-vb[C_HowTo-WCFServiceAndASMXClient#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/vb/program.vb#0)]  
+  
+ [!code[C_HowTo-WCFServiceAndASMXClient#1](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto-wcfserviceandasmxclient/common/app.config#1)]  
+  
+## <a name="see-also"></a>関連項目  
+ [方法: コードでサービス エンドポイントの作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md)   
+ [方法: コードを使用して、サービスのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)   
+ [方法: 構成でサービス バインディングを指定](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)   
+ [方法: 構成でサービス エンドポイントの作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)   
+ [方法: 構成ファイルを使用して、サービスのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [メタデータを使用します。](../../../../docs/framework/wcf/feature-details/using-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md b/docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md
new file mode 100644
index 00000000000..9c0790a067d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md
@@ -0,0 +1,65 @@
+---
+title: "ワークフロー サービスの未処理の例外動作を構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51b25c86-292c-43e4-8d13-273d2badc8ad
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ワークフロー サービスの未処理の例外動作を構成する方法
+<xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> は、<xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされるワークフロー内で未処理の例外が発生した場合のアクションを指定できるようにする動作です。このトピックでは、この動作を構成ファイルで構成する方法を示します。  
+  
+### WorkflowUnhandledExceptionBehavior を構成するには  
+  
+1.  次の例に示すように、\<`workflowUnhandledException`\> 要素を \<`behavior`\> 要素の \<`serviceBehaviors`\> 要素内に追加し、`action` 属性を使用して、未処理の例外が発生した場合のアクションを指定します。  
+  
+    ```  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="">  
+          <workflowUnhandledException action="abandonAndSuspend"/>   
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    ```  
+  
+    > [!NOTE]
+    >  前の構成サンプルでは、簡略化された構成を使用しています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md).  
+  
+     この動作は、次の例に示すように、コードで構成できます。  
+  
+    ```csharp  
+    host.Description.Behaviors.Add(new WorkflowUnhandledExceptionBehavior { Action = WorkflowUnhandledExceptionAction.AbandonAndSuspend });  
+  
+    ```  
+  
+     \<`workflowUnhandledException`\> 要素の `action` 属性は、次のいずれかの値に設定できます。  
+  
+     **abandon**  
+     永続化されているインスタンス状態を変更することなく、メモリ内のインスタンスを中止します \(つまり、最後の永続性ポイントにロールバックします\)。  
+  
+     **abandonAndSuspend**  
+     メモリ内のインスタンスを中止し、永続化されているインスタンスを中断状態に更新します。  
+  
+     **cancel**  
+     インスタンスのキャンセル ハンドラーを呼び出してから、メモリ内のインスタンスを完了状態にします。これにより、そのインスタンスがインスタンス ストアから削除される場合もあります。  
+  
+     **terminate**  
+     メモリ内のインスタンスを完了状態にし、そのインスタンスをインスタンス ストアから削除します。  
+  
+     <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)」を参照してください。  
+  
+## 参照  
+ [ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)   
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuration-based-activation-in-iis-and-was.md b/docs/framework/wcf/feature-details/configuration-based-activation-in-iis-and-was.md
new file mode 100644
index 00000000000..d78afabcf16
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuration-based-activation-in-iis-and-was.md
@@ -0,0 +1,52 @@
+---
+title: "IIS と WAS における構成ベースのアクティブ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a927e1f-b905-4ee5-ad0f-78265da38238
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# IIS と WAS における構成ベースのアクティブ化
+インターネット インフォメーション サービス \(IIS: Internet Information Services\) または Windows プロセス アクティブ化サービス \(WAS\) で [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストする場合は、.svc ファイルを用意する必要があります。.svc ファイルには、サービスの名前と、オプションのカスタム サービス ホスト ファクトリが含まれています。この追加ファイルによって、管理のオーバーヘッドが増加します。構成ベースのアクティブ化機能により、.svc ファイルを用意する必要がなくなり、関連するオーバーヘッドも発生しません。  
+  
+## 構成ベースのアクティブ化  
+ 構成ベースのアクティブ化では、以前は .svc ファイルに配置されていたメタデータを受け取り、それを Web.config ファイルに配置します。\<`serviceHostingEnvironment`\> 要素内には \<`serviceActivations`\> 要素があります。\<`serviceActivations`\> 要素内には、ホストされる各サービスに 1 つずつの \<`add`\> 要素が 1 つ以上あります。\<`add`\> 要素に含まれている属性を使用すると、サービスおよびサービス型 \(サービス ホスト ファクトリ\) の相対アドレスを設定できます。次の構成コード例は、このセクションの使用方法を示しています。  
+  
+> [!NOTE]
+>  各 \<`add`\> 要素では、サービスまたはファクトリ属性を指定する必要があります。サービスとファクトリ属性の両方を指定することもできます。  
+  
+```  
+<serviceHostingEnvironment>  
+  <serviceActivations>  
+    <add relativeAddress="MyServiceAddress" service="Service" factory=”MyServiceHostFactory”/>  
+  </serviceActivations>  
+</serviceHostingEnvironment>  
+```  
+  
+ このコードを Web.config ファイルに含めると、サービス ソース コードをアプリケーションの App\_Code ディレクトリに配置するか、コンパイル済みアセンブリをアプリケーションの Bin ディレクトリに配置することができます。  
+  
+> [!NOTE]
+>  -   構成ベースのアクティブ化機能を使用する場合、.svc ファイルのインライン コードはサポートされません。  
+> -   `relativeAddress` 属性は、"\<sub\-directory\>\/service.svc" や "~\/\<sub\-directory\/service.svc" などの相対アドレスに設定する必要があります。  
+> -   WCF と関連付けられている既知の拡張子を持たない相対アドレスを登録すると、構成例外がスローされます。  
+> -   指定された相対アドレスは、仮想アプリケーションのルートが基準になります。  
+> -   構成の階層的モデルにより、コンピューター レベルおよびサイト レベルの登録された相対アドレスは、仮想アプリケーションによって継承されます。  
+> -   構成ファイル内での登録は、.svc、.xamlx、.xoml、またはその他のファイルでの設定よりも優先されます。  
+> -   IIS\/WAS に送信された URI 内の \\ \(円記号\) は、自動的に \/ \(スラッシュ\) に変換されます。\\ を含む相対アドレスが追加され、その相対アドレスを使用する URI を IIS に送信した場合は、円記号がスラッシュに変換されるため、IIS では、それを相対アドレスと一致させることができません。IIS は、一致するものが見つからなかったことを示すトレース情報を送信します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection.ServiceActivations%2A>   
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)   
+ [ワークフロー サービスのホストの概要](../../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md)   
+ [\<serviceHostingEnvironment\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-discovery-in-a-configuration-file.md b/docs/framework/wcf/feature-details/configuring-discovery-in-a-configuration-file.md
new file mode 100644
index 00000000000..68e2877520f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-discovery-in-a-configuration-file.md
@@ -0,0 +1,280 @@
+---
+title: "構成ファイルにおける探索の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9884c11-8011-4763-bc2c-c526b80175d0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 構成ファイルにおける探索の構成
+探索で使用される構成設定は、4 つの主なグループに分類されます。  このトピックでは、各グループについて簡単に説明し、各グループの構成方法の例を紹介します。  以下の各セクションは、各領域についてのより詳細なドキュメントにリンクされます。  
+  
+## 動作の構成  
+ 探索では、サービスの動作とエンドポイントの動作が使用されます。  <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> 動作により、サービスのすべてのエンドポイントの探索が有効になるだけでなく、アナウンス エンドポイントの指定が可能になります。  次の例は、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> を追加し、アナウンス エンドポイントを指定する方法を示しています。  
+  
+```  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior name="helloWorldServiceBehavior">  
+          <serviceDiscovery>  
+            <announcementEndpoints>  
+              <endpoint kind="udpAnnouncementEndpoint"/>  
+            </announcementEndpoints>  
+          </serviceDiscovery>  
+        </behavior>  
+      </serviceBehaviors>  
+```  
+  
+ 動作を指定したら、これを \<`service`\> 要素から参照します。次にその例を示します。  
+  
+```  
+<system.serviceModel>  
+   <services>  
+      <service name="HelloWorldService" behaviorConfiguration="helloWorldServiceBehavior">  
+         <!-- Application Endpoint -->  
+         <endpoint address="endpoint0"  
+                   binding="basicHttpBinding"  
+                   contract="IHelloWorldService" />  
+         <!-- Discovery Endpoints -->  
+         <endpoint kind="udpDiscoveryEndpoint" />  
+        </service>  
+    </service>  
+```  
+  
+ サービスを探索可能にするには、探索エンドポイントを追加する必要もあります。上の例では、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> 標準エンドポイントを追加しています。  
+  
+ アナウンス エンドポイントを追加する場合は、アナウンス リスナー サービスを \<`services`\> 要素に追加する必要もあります。次にその例を示します。  
+  
+```  
+<services>  
+   <service name="HelloWorldService" behaviorConfiguration="helloWorldServiceBehavior">  
+      <!-- Application Endpoint -->  
+      <endpoint address="endpoint0"  
+                binding="basicHttpBinding"  
+                contract="IHelloWorldService" />  
+      <!-- Discovery Endpoints -->  
+      <endpoint kind="udpDiscoveryEndpoint" />  
+   </service>  
+   <!-- Announcement Listener Configuration -->  
+   <service name="AnnouncementListener">  
+      <endpoint kind="udpAnnouncementEndpoint" />  
+   </service>  
+```  
+  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> 動作は、特定のエンドポイントの探索を有効または無効にするために使用されます。  次の例では、サービスに 2 つのアプリケーション エンドポイントを構成します。1 つのエンドポイントでは探索を有効し、もう 1 つでは探索を無効にします。  それぞれのエンドポイントには <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> 動作が追加されます。  
+  
+```  
+<system.serviceModel>  
+   <services>  
+      <service name="HelloWorldService"  
+               behaviorConfiguration="helloWorldServiceBehavior">  
+  
+        <!-- Application Endpoints -->  
+        <endpoint address="endpoint0"  
+                 binding="basicHttpBinding"  
+                 contract="IHelloWorldService"   
+                 behaviorConfiguration="ep0Behavior" />  
+  
+        <endpoint address="endpoint1"  
+                  binding="basicHttpBinding"  
+                  contract="IHelloWorldService"  
+                  behaviorConfiguration="ep1Behavior" />  
+  
+        <!-- Discovery Endpoints -->  
+        <endpoint kind="udpDiscoveryEndpoint" />  
+      </service>  
+   </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="helloWorldServiceBehavior">  
+          <serviceDiscovery />  
+        </behavior>  
+      </serviceBehaviors>  
+      <endpointBehaviors>  
+        <behavior name="ep0Behavior">  
+          <endpointDiscovery enabled="true"/>  
+        </behavior>  
+        <behavior name="ep1Behavior">  
+          <endpointDiscovery enabled="false"/>  
+        </behavior>  
+     </endpointBehaviors>  
+   </behaviors>  
+  
+```  
+  
+ <xref:System.ServiceModel.Discovery.EndpointBehavior> 動作を使用すると、サービスから返されるエンドポイント メタデータにカスタム メタデータを追加することもできます。  その方法を次の例に示します。  
+  
+```  
+<behavior name="ep4Behavior">  
+   <endpointDiscovery enabled="true">  
+      <extensions>  
+         <CustomMetadata>This is custom metadata.</CustomMetadata>  
+         <d:Types xmlns:d="http://schemas.xmlsoap.org/ws/2005/04/discovery" xmlns:i="http://printer.example.org/2003/imaging">i:PrintBasic</d:Types>  
+         <CustomMetadata netsted="true">  
+            <NestedMetadata>This is a nested custom metadata.</NestedMetadata>  
+         </CustomMetadata>  
+      </extensions>  
+   </endpointDiscovery>  
+</behavior>  
+```  
+  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> 動作を使用すると、クライアントがサービスの検索に使用するスコープと型を追加することもできます。  クライアント側の構成ファイルでこの構成を行う方法を次の例に示します。  
+  
+```  
+<behavior name="ep2Behavior">  
+   <endpointDiscovery enabled="true">  
+      <scopes>  
+         <add scope="http://www.microsoft.com/building42/floor1"/>  
+         <add scope="ldap:///ou=engineeringo=examplecomc=us"/>  
+      </scopes>  
+      <types>  
+         <add name="test" namespace="http://example.microsoft.com/" />  
+         <add name="additionalContract" namespace="http://example.microsoft.com/" />  
+      </types>  
+   </endpointDiscovery>  
+</behavior>  
+```  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)] <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> および <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> については、「[WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)」を参照してください。  
+  
+## バインディング要素の構成  
+ バインディング要素の構成は、クライアント側で最も興味深い構成です。  構成を使用して、WCF クライアント アプリケーションからのサービスの探索に使用する検索条件を指定できます。  次の例では、<xref:System.ServiceModel.Discovery.DiscoveryClient> チャネルとのカスタム バインディングを作成し、型とスコープを含む検索条件を指定しています。  また、<xref:System.ServiceModel.Discovery.FindCritera.Duration%2A> プロパティと <xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> プロパティの値も指定しています。  
+  
+```  
+<bindings>  
+   <customBinding>  
+      <!-- Binding Configuration for the Application Endpoint -->  
+      <binding name="discoBindingConfiguration">  
+         <discoveryClient>  
+            <endpoint kind="discoveryEndpoint"  
+                      address="http://localhost:8000/ConfigTest/Discovery"  
+                      binding="customBinding"  
+                      bindingConfiguration="httpSoap12WSAddressing10"/>  
+            <findCriteria duration="00:00:10" maxResults="2">  
+              <types>  
+                <add name="IHelloWorldService"/>  
+              </types>  
+              <scopes>  
+                <add scope="http://www.microsoft.com/building42/floor1"/>  
+              </scopes>              
+            </findCriteria>  
+          </discoveryClient>  
+          <textMessageEncoding messageVersion="Soap11"/>  
+          <httpTransport />  
+        </binding>  
+```  
+  
+ このカスタム バインディング構成は、クライアント エンドポイントから参照される必要があります。  
+  
+```  
+<client>  
+      <endpoint address="http://schemas.microsoft.com/discovery/dynamic"  
+                binding="customBinding"  
+                bindingConfiguration="discoBindingConfiguration"  
+                contract="IHelloWorldService" />  
+    </client>  
+```  
+  
+ 検索条件[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[探索検索と FindCriteria](../../../../docs/framework/wcf/feature-details/discovery-find-and-findcriteria.md)」を参照してください。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] 探索およびバインディング要素については、「[WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)」を参照してください。  
+  
+## 標準エンドポイントの構成  
+ 標準エンドポイントは定義済みのエンドポイントで、これには、1 つ以上のプロパティ \(アドレス、バインディング、またはコントラクト\) の既定値、または、変更できない 1 つ以上のプロパティ値が設定されています。  .NET 4 には、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>、<xref:System.ServiceModel.Discovery.UpdAnnouncementEndpoint>、および <xref:System.ServiceModel.Discovery.DynamicEndpoint> という 3 種類の探索関連の標準エンドポイントが用意されています。  <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> は、UDP マルチキャスト バインディングを使用した探索操作用に事前に構成されている標準エンドポイントです。  <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> は、UDP バインディングを使用したアナウンスの送信用に事前に構成されている標準エンドポイントです。  <xref:System.ServiceModel.Discovery.DynamicEnpoint> は、実行時に探索対象のサービスのエンドポイント アドレスを動的に検索するために探索が使用する標準エンドポイントです。  標準のバインディングは、追加する標準エンドポイントの種類を指定した種類属性を含む \<`endpoint`\> 要素を使用して、指定されます。  <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> および <xref:System.ServiceModel.Discovery.UpdAnnouncementEndpoint> を追加する方法を次の例に示します。  
+  
+```  
+<services>  
+   <service name="HelloWorldService">  
+      <!-- ...  -->          
+      <endpoint kind="udpDiscoveryEndpoint" />  
+   </service>  
+   <service name="AnnouncementListener">  
+      <endpoint kind="udpAnnouncementEndpoint" />  
+   </service>  
+</services>  
+```  
+  
+ 標準エンドポイントは、\<`standardEndpoints`\> 要素で構成します。  <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> および <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> を構成する方法を次の例に示します。  
+  
+```  
+<standardEndpoints>  
+      <udpAnnouncementEndpoint>  
+        <standardEndpoint   
+            name="udpAnnouncementEndpointSettings"   
+            multicastAddress="soap.udp://239.255.255.250:3703"    
+            maxAnnouncementDelay="00:00:00.800">  
+          <transportSettings  
+            duplicateMessageHistoryLength="1028"  
+            maxPendingMessageCount="10"  
+            maxMulticastRetransmitCount="3"  
+            maxUnicastRetransmitCount="2"  
+            socketReceiveBufferSize="131072"  
+            timeToLive="2" />  
+        </standardEndpoint>  
+      </udpAnnouncementEndpoint>  
+      <udpDiscoveryEndpoint>  
+        <standardEndpoint  
+            name="udpDiscoveryEndpointSettings"  
+            multicastAddress="soap.udp://239.255.255.252:3704"  
+            maxResponseDelay="00:00:00.800">  
+          <transportSettings  
+            duplicateMessageHistoryLength="2048"  
+            maxPendingMessageCount="5"  
+            maxReceivedMessageSize="8192"  
+            maxBufferPoolSize="262144"/>  
+        </standardEndpoint>  
+      </udpDiscoveryEndpoint>  
+```  
+  
+ 標準エンドポイント構成を追加したら、各エンドポイントの \<`endpoint`\> 要素でこの構成を参照します。次にその例を示します。  
+  
+```  
+<services>  
+   <service name="HelloWorldService">  
+      <!-- ...  -->          
+      <endpoint kind="udpDiscoveryEndpoint" endpointConfiguration="udpDiscoveryEndpointSettings"/>  
+   </service>  
+   <service name="AnnouncementListener">  
+      <endpoint kind="udpAnnouncementEndpoint" endpointConfiguration="udpAnnouncementEndpointSettings" >  
+   </service>  
+</services>  
+```  
+  
+ 探索で使用されるその他の標準エンドポイントとは異なり、<xref:System.ServiceModel.Discovery.DynamicEndpoint> にはバインディングとコントラクトを指定します。  <xref:System.ServiceModel.Discovery.DynamicEndpoint> を追加し、構成する方法を次の例に示します。  
+  
+```  
+<system.serviceModel>  
+    <client>  
+      <endpoint kind="dynamicEndpoint" binding="basicHttpBinding" contract="IHelloWorldService" endpointConfiguration="dynamicEndpointConfiguration" />  
+    </client>   
+   <standardEndpoints>  
+      <dynamicEndpoint>  
+         <standardEndpoint name="dynamicEndpointConfiguration">  
+             <discoveryClientSettings>  
+              <findCriteria scopeMatchBy="http://schemas.microsoft.com/ws/2008/06/discovery/rfc" duration="00:00:10" maxResults="2">  
+                 <types>  
+                   <add name="IHelloWorldService"/>  
+                 </types>  
+                 <scopes>  
+                   <add scope="http://www.microsoft.com/building42/floor1"/>  
+                 </scopes>  
+                 <extensions>  
+                   <CustomMetadata>This is custom metadata.</CustomMetadata>          
+                 </extensions>  
+               </findCriteria>  
+             </discoveryClientSettings>  
+           </standardEndpoint>  
+         </dynamicEndpoint>  
+   </standardEndpoints>  
+</system.ServiceModel>  
+```  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)] 標準エンドポイント、「」を参照してください。 [標準エンドポイント](../../../../docs/framework/wcf/feature-details/standard-endpoints.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-http-and-https.md b/docs/framework/wcf/feature-details/configuring-http-and-https.md
new file mode 100644
index 00000000000..ff0c0732ebb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-http-and-https.md
@@ -0,0 +1,105 @@
+---
+title: "HTTP および HTTPS の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "HTTP の構成 [WCF]"
+ms.assetid: b0c29a86-bc0c-41b3-bc1e-4eb5bb5714d4
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# HTTP および HTTPS の構成
+WCF サービスと WCF クライアントは、HTTP および HTTPS を介して通信できます。  HTTP または HTTPS の設定は、インターネット インフォメーション サービス \(IIS\) またはコマンド ライン ツールを使用して構成します。  WCF サービスが IIS でホストされている場合は、IIS 内で HTTP または HTTPS の設定を構成できます \(inetmgr.exe ツールを使用\)。  WCF サービスが自己ホスト型の場合は、コマンド ライン ツールを使用して HTTP または HTTPS の設定を構成します。  
+  
+ 少なくとも、URL 登録を構成し、サービスで使用される URL のファイアウォール例外を追加する必要があります。  
+  
+ HTTP 設定の構成に使用するツールは、コンピューターで実行されているオペレーティング システムによって異なります。  
+  
+ [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] を実行している場合は、HttpCfg.exe ツールを使用します。  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] ではこのツールが自動的にインストールされます。  [!INCLUDE[wxp](../../../../includes/wxp-md.md)] を実行している場合は、「[Windows XP Service Pack 2 サポート ツール](http://go.microsoft.com/fwlink/?LinkId=88606)」からツールをダウンロードできます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][Httpcfg の概要に関するページ](http://go.microsoft.com/fwlink/?LinkId=88605)を参照してください。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] または Windows 7 を実行している場合は、Netsh.exe ツールを使用してこれらの設定を構成します。  
+  
+## 名前空間予約の構成  
+ 名前空間予約では、HTTP URL 名前空間の一部に対する権限を特定のユーザー グループに割り当てます。  予約によって、名前空間のその部分でリッスンするサービスを作成する権限をユーザーに与えます。  予約は URL プレフィックスを使用します。つまり、予約は予約パスのすべてのサブパスを範囲とします。  名前空間予約では、2 つの方法でワイルドカードを使用できます。  HTTP Server API のドキュメントでは、[ワイルドカードを含む名前空間クレーム間の解決順序](http://go.microsoft.com/fwlink/?LinkId=94841)について説明しています。  
+  
+ 実行中のアプリケーションは、同様の要求を作成して、名前空間登録を追加できます。  名前空間の同じ部分について、登録と予約の間で競合が発生します。  [ワイルドカードを含む名前空間クレーム間の解決順序](http://go.microsoft.com/fwlink/?LinkId=94841)で指定された解決順序に従って、予約が登録より優先される可能性があります。  この場合、実行中のアプリケーションがクレームを受信する動作が、予約によってブロックされます。  
+  
+### Windows XP または Windows Server 2003 を実行している場合  
+ 名前空間予約を変更するには、`httpcfg.exe set urlacl` コマンドを使用します。  「[Httpcfg 構文](http://go.microsoft.com/fwlink/?LinkId=94840)」では、Httpcfg.exe ツールの構文について説明しています。  名前空間の一部に対する予約権限を変更するには、管理特権または名前空間のその部分の所有権が必要です。  最初は、ローカル管理者が HTTP 名前空間全体を所有しています。  
+  
+ `set urlacl` オプションを使用する Httpcfg コマンドの構文を次に示します。  
+  
+```  
+httpcfg set urlacl /u {http://URL:Port/ | https://URL:Port/} /aACL  
+  
+```  
+  
+ `/u` を使用する場合には、`set urlacl` パラメーターが必要です。  このパラメーターには、実行された予約のレコード キーとして動作する完全修飾 URL を含む文字列を指定します。  
+  
+ `/a` を使用する場合には、`set urlacl` パラメーターも必要です。  このパラメーターには、SDDL \(Security Descriptor Definition Language\) の形式によるアクセス制御リスト \(ACL\) を含む文字列を指定します。  
+  
+ このコマンドの使用例を次に示します。  
+  
+```  
+httpcfg.exe set urlacl /u http://myhost:8000/ /a "O:AOG:DAD:(A;;RPWPCCDCLCSWRCWDWOGA;;;S-1-0-0)"  
+  
+```  
+  
+### Windows Vista、Windows Server 2008 R2、または Windows 7 を実行している場合  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)]、Windows Server 2008 R2、または Windows 7 を実行している場合は、Netsh.exe ツールを使用します。  このコマンドの使用例を次に示します。  
+  
+```  
+netsh http add urlacl url=http://+:80/MyUri user=DOMAIN\user  
+  
+```  
+  
+ このコマンドにより、DOMAIN\\ユーザー アカウントについて指定した URL 名前空間の URL 予約が追加されます。  netsh コマンドの使用方法の詳細については、コマンド プロンプトで「netsh http add urlacl」と入力し、Enter キーを押してください。  
+  
+## ファイアウォールの例外の構成  
+ HTTP 経由の通信を行う WCF サービスを自己ホストする際は、例外をファイアウォール構成に追加して、特定の URL を使用した着信接続を可能にする必要があります。  詳細については、「[Windows ファイアウォールでポートを開く \(Windows 7\)](http://go.microsoft.com/fwlink/?LinkId=239961)」を参照してください。  
+  
+## SSL 証明書の構成  
+ SSL \(Secure Sockets Layer\) プロトコルは、クライアントとサーバー上で証明書を使用して暗号化キーを格納します。  サーバーは、クライアントがサーバーの ID を検証できるように接続時に SSL 証明書を提供します。  また、サーバーはクライアントに証明書を要求して、接続の両側で相互認証を実行することもできます。  
+  
+ 証明書は、接続の IP アドレスとポート番号に基づいて集中ストアに格納されます。  特別な IP アドレス 0.0.0.0 は、ローカル コンピューターの任意の IP アドレスに一致します。  証明書ストアでは、パスを基準にした URL を区別しません。  同じ IP アドレスとポートの組み合わせを持つサービスは、そのサービスの URL でのパスが異なる場合でも証明書を共有する必要があります。  
+  
+ 手順の詳細については、「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。  
+  
+## IP リッスン一覧の構成  
+ HTTP Server API は、ユーザーが URL を登録すると、IP アドレスとポートだけにバインドします。  既定では、HTTP Server API は、コンピューターのすべての IP アドレスに対して、URL でポートにバインドします。  その IP アドレスとポートの組み合わせにバインドしている HTTP Server API をアプリケーションが使用していない場合、競合が発生します。  IP リッスン一覧によって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、コンピューターの一部の IP アドレスに対してポートを使用するアプリケーションと共存できます。  IP リッスン一覧にエントリがある場合、HTTP Server API は、その一覧に指定されている IP アドレスだけにバインドします。  IP リッスン一覧を変更するには、管理特権が必要です。  
+  
+### Windows XP または Windows Server 2003 を実行している場合  
+ httpcfg ツールを使用して IP リッスン一覧を変更します。次に例を示します。  「[Httpcfg 構文](http://go.microsoft.com/fwlink/?LinkId=94840)」では、httpcfg.exe ツールの構文について説明しています。  
+  
+```  
+httpcfg.exe set iplisten -i 0.0.0.0:8000  
+```  
+  
+### Windows Vista または Windows 7 を実行している場合  
+ netsh ツールを使用して IP リッスン一覧を変更します。次に例を示します。  
+  
+```  
+netsh http add iplisten ipaddress=0.0.0.0:8000  
+```  
+  
+## その他の構成設定  
+ <xref:System.ServiceModel.WsDualHttpBinding> を使用すると、クライアント接続では、名前空間予約と Windows ファイアウォールに対応できる既定値が使用されます。  双方向接続のクライアント ベース アドレスをカスタマイズする場合、クライアント上で HTTP 設定を行い、新しいアドレスに一致させる必要があります。  
+  
+ HTTP Server API には、HttpCfg からは使用できない高度な構成設定があります。  この設定は、レジストリで管理され、HTTP Server API を使用するシステムで実行中のすべてのアプリケーションに適用されます。  これらの設定については、「[IIS 用の Http.sys レジストリ設定](http://go.microsoft.com/fwlink/?LinkId=94843)」を参照してください。  ほとんどのユーザーは、この設定を変更する必要がありません。  
+  
+## Windows XP に固有の問題  
+ IIS では、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] 上でのポート共有がサポートされていません。  IIS を実行していて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが同じポートを持つ名前空間を使用しようとすると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは開始に失敗します。  IIS と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではどちらも、既定でポート 80 が使用されます。  いずれかのサービスのポート割り当てを変更するか、IP リッスン一覧を使用して、IIS で使用されていないネットワーク アダプターに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを割り当てます。  IIS 6.0 以上では、HTTP Server API を使用できるように設計が変更されています。  
+  
+## 参照  
+ <xref:System.ServiceModel.WsDualHttpBinding>   
+ [方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-iis-for-wcf.md b/docs/framework/wcf/feature-details/configuring-iis-for-wcf.md
new file mode 100644
index 00000000000..ca71216c618
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-iis-for-wcf.md
@@ -0,0 +1,83 @@
+---
+title: "Windows Communication Foundation での Internet Information Services 7.0 の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1050d395-092e-44d3-b4ba-66be3b039ffb
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Windows Communication Foundation での Internet Information Services 7.0 の構成
+Internet Information Services \(IIS\) 7.0 はモジュール設計になっており、必要なコンポーネントを選択してインストールできます。この設計は、[!INCLUDE[wv](../../../../includes/wv-md.md)] で新しく導入されたマニフェスト ドリブンのコンポーネント テクノロジに基づいています。[!INCLUDE[iisver](../../../../includes/iisver-md.md)] には、40 以上のスタンドアロン機能コンポーネントがあり、個別にインストールできます。これにより、IT プロフェッショナルは必要に応じてインストールをカスタマイズできます。このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で使用する [!INCLUDE[iisver](../../../../includes/iisver-md.md)] を構成し、必要なコンポーネントを決定する方法について説明します。  
+  
+## 最小インストール : WAS のインストール  
+ 完全な [!INCLUDE[iisver](../../../../includes/iisver-md.md)] パッケージの最小インストールでは、Windows プロセス アクティブ化サービス \(WAS: Windows Process Activation Service\) をインストールします。WAS はスタンドアロン機能であり、すべての [!INCLUDE[wv](../../../../includes/wv-md.md)] オペレーティング システム \(Home Basic、Home Premium、Business、Ultimate、および Enterprise\) で利用できる唯一の [!INCLUDE[iisver](../../../../includes/iisver-md.md)] の機能です。  
+  
+ コントロール パネルの **\[プログラム\]** をクリックし、**\[プログラムと機能\]** に表示される **\[Windows の機能を有効化または無効化\]** をクリックします。次の図に示すように、一覧に WAS コンポーネントが表示されます。  
+  
+ ![機能の有効化または無効化ダイアログ](../../../../docs/framework/wcf/feature-details/media/wcfc-turnfeaturesonoroffs.gif "wcfc\_TurnFeaturesOnOrOffs")  
+  
+ この機能には、次のサブコンポーネントがあります。  
+  
+-   .NET 環境  
+  
+-   構成 API  
+  
+-   プロセス モデル  
+  
+ WAS のルート ノードを選択した場合は、既定で **\[プロセス モデル\]** サブノードだけがオンになっています。このインストールでは Web サーバーをサポートしないため、WAS のみをインストールすることに注意してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] または任意の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションを機能させるには、**\[.NET 環境\]** チェック ボックスをオンにします。つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] および [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] を適切に機能させるには、すべての WAS コンポーネントが必要です。これらのコンポーネントのいずれかを一度インストールすると、チェック ボックスは自動的にオンになります。  
+  
+## IIS 7.0 : 既定のインストール  
+ **\[インターネット インフォメーション サービス\]** 機能をオンにすることで、次の図に示すように、一部のサブノードが自動的にオンになります。  
+  
+ ![IIS 7.0 の各機能の既定の設定](../../../../docs/framework/wcf/feature-details/media/wcfc-turningfeaturesonoroff2.gif "wcfc\_TurningFeaturesOnOrOff2")  
+  
+ これは [!INCLUDE[iisver](../../../../includes/iisver-md.md)] の既定のインストールです。このインストールにより、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] を使用して静的コンテンツ \(HTML ページなど\) を提供できます。ただし、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] や CGI アプリケーションを実行したり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストしたりすることはできません。  
+  
+## IIS 7.0 : ASP.NET サポートを行うインストール  
+ IIS 7.0 で [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] を機能させるには [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] をインストールする必要があります。**\[ASP.NET\]** をオンにすると、画面は次のようになります。  
+  
+ ![ASP.NET の必須の設定](../../../../docs/framework/wcf/feature-details/media/wcfc-trunfeaturesonoroff3s.gif "wcfc\_TrunFeaturesOnOrOFf3s")  
+  
+ これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションと [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの両方が [!INCLUDE[iisver](../../../../includes/iisver-md.md)] で機能するための最小限の環境です。  
+  
+## IIS 7.0 : IIS 6.0 互換コンポーネントを備えたインストール  
+ Visual Studio 2005 や、[!INCLUDE[iis601](../../../../includes/iis601-md.md)] メタベース API を使用する仮想アプリケーションを構成するオートメーション スクリプトおよびツール \(Adsutil.vbs など\) と共にシステムに [!INCLUDE[iisver](../../../../includes/iisver-md.md)] をインストールする場合は、**\[[!INCLUDE[iis601](../../../../includes/iis601-md.md)] スクリプト ツール\]** を必ずオンにしてください。これにより、**\[[!INCLUDE[iis601](../../../../includes/iis601-md.md)] Management 互換性\]** の他のサブノードが自動的にオンになります。実行後の画面を次の図に示します。  
+  
+ ![IIS 6.0 管理互換の設定](../../../../docs/framework/wcf/feature-details/media/scfc-turnfeaturesonoroff5s.gif "scfc\_TurnFeaturesOnOrOff5s")  
+  
+ このインストールにより、[!INCLUDE[iisver](../../../../includes/iisver-md.md)]、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)]、および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 機能を使用するために必要な準備ができ、Web でサンプルを利用できるようになります。  
+  
+## 要求の制限  
+ IIS 7.0 がインストールされた [!INCLUDE[wv](../../../../includes/wv-md.md)] では、`maxUri` および `maxQueryStringSize` の設定の既定値が変更されています。既定では、IIS 7.0 における要求のフィルター処理で使用できる文字数は、URL が 4096 文字、クエリ文字列が 2048 文字です。これらの既定値を変更するには、App.config ファイルに次の XML を追加します。  
+  
+ `<system.webServer>`  
+  
+ `<security>`  
+  
+ `<requestFiltering>`  
+  
+ `<requestLimits maxUrl=”8192” maxQueryString=”8192” />`  
+  
+ `</requestFiltering>`  
+  
+ `</security>`  
+  
+ `</system.webServer>`  
+  
+## 参照  
+ [WAS アクティベーション アーキテクチャ](../../../../docs/framework/wcf/feature-details/was-activation-architecture.md)   
+ [WCF で使用するための WAS を設定する](../../../../docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md)   
+ [方法 : WCF アクティブ化コンポーネントをインストールして設定する](../../../../docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-serialization-in-a-workflow-service.md b/docs/framework/wcf/feature-details/configuring-serialization-in-a-workflow-service.md
new file mode 100644
index 00000000000..1558da241b3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-serialization-in-a-workflow-service.md
@@ -0,0 +1,62 @@
+---
+title: "ワークフロー サービス内でのシリアル化の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa70b290-a2ee-4c3c-90ea-d0a7665096ae
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ワークフロー サービス内でのシリアル化の構成
+ワークフロー サービスは [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスであるため、<xref:System.Runtime.Serialization.DataContractSerializer> \(既定\) または <xref:System.Xml.Serialization.XmlSerializer> を使用するオプションがあります。ワークフロー以外のサービスを記述する場合、使用するシリアライザーの型はサービスまたは操作コントラクトで指定されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ワークフロー サービスを作成する場合、これらのコントラクトはコードで指定せずに、コントラクト推論で実行時に生成されます。コントラクト推論[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー内でのコントラクトの使用](../../../../docs/framework/wcf/feature-details/using-contracts-in-workflow.md)」を参照してください。シリアライザーは、<xref:System.ServiceModel.Activities.Receive.SerializerOption%2A> プロパティを使用して指定されます。これは、次の図に示すようにデザイナーで設定できます。  
+  
+ ![シリアライザーの設定](../../../../docs/framework/wcf/feature-details/media/settingserialzier.png "SettingSerialzier")  
+  
+ シリアライザーは、次の例に示すようにコードで設定することもできます。  
+  
+```  
+Receive approveExpense = new Receive  
+            {  
+                OperationName = "ApproveExpense",  
+                CanCreateInstance = true,  
+                ServiceContractName = "FinanceService",  
+                SerializerOption = SerializerOption.DataContractSerializer,  
+                Content = ReceiveContent.Create(new OutArgument<Expense>(expense))  
+            };  
+  
+```  
+  
+ ワークフロー サービスにも既知の型を指定できます。既知の型[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。既知の型は、デザイナーまたはコードで指定できます。デザイナーで既知の型を指定するには、次の図に示すように <xref:System.ServiceModel.Activities.Receive> アクティビティのプロパティ ウィンドウで KnownTypes プロパティの横の省略記号ボタンをクリックします。  
+  
+ ![KnownTypes プロパティ](../../../../docs/framework/wcf/feature-details/media/knowntypes.png "KnownTypes")  
+  
+ これにより、既知の型を検索および指定できる型コレクション エディターが表示されます。  
+  
+ ![既知の型の追加](../../../../docs/framework/wcf/feature-details/media/typecollectionseditor.gif "TypeCollectionsEditor")  
+  
+ **\[新しい型の追加\]** リンクをクリックし、ドロップダウンを使用して既知の型コレクションに追加する型を選択または検索します。既知の型をコードで指定するには、次の例に示すように <xref:System.ServiceModel.Activities.Receive.KnownTypes%2A> プロパティを使用します。  
+  
+```  
+Receive approveExpense = new Receive  
+            {  
+                OperationName = "ApproveExpense",  
+                CanCreateInstance = true,  
+                ServiceContractName = "FinanceService",  
+                SerializerOption = SerializerOption.DataContractSerializer,  
+                Content = ReceiveContent.Create(new OutArgument<Expense>(expense))  
+            };  
+            approveExpense.KnownTypes.Add(typeof(Travel));  
+            approveExpense.KnownTypes.Add(typeof(Meal));  
+  
+```  
+  
+ ワークフロー サービスのシリアル化の構成方法を示す完全なコード例を確認するには、「[ワークフロー サービスでのメッセージの書式設定](../../../../docs/framework/windows-workflow-foundation/samples/formatting-messages-in-workflow-services.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-system-provided-bindings.md b/docs/framework/wcf/feature-details/configuring-system-provided-bindings.md
new file mode 100644
index 00000000000..31115e0066d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-system-provided-bindings.md
@@ -0,0 +1,89 @@
+---
+title: "システムが提供するバインディングの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング [WCF], システム指定"
+  - "WCF [WCF], システム指定のバインディング"
+  - "Windows Communication Foundation [WCF], システム指定のバインディング"
+ms.assetid: 443f8d65-f1f2-4311-83b3-4d8fdf7ccf16
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# システムが提供するバインディングの構成
+バインディングにより、エンドポイントとの通信で使用する通信メカニズムが指定され、エンドポイントへの接続方法が示されます。  バインディングは、必要な通信機能を提供するために [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] チャネルを階層化する方法を定義する要素から構成されます。  バインディングには次の 3 種類の要素が含まれます。  
+  
+-   プロトコル チャネル バインド要素 : エンドポイントに送信されるメッセージで使用するセキュリティ、信頼性、コンテキスト フローの設定、またはユーザー定義のプロトコルを指定します。  
+  
+-   トランスポート チャネル バインド要素 : エンドポイントにメッセージを送信するときに使用する基礎トランスポート プロトコル \(TCP や HTTP など\) を指定します。  
+  
+-   メッセージ エンコーディング バインド要素 : エンドポイントに送信されるメッセージに使用するネットワーク エンコード \(text\/XML、バイナリ、MTOM \(Message Transmission Optimization Mechanism\) など\) を指定します。  
+  
+ ここでは、システム指定の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] バインディングをすべて示します。  このバインディングがいずれもアプリケーションの要件を満たさない場合は、<xref:System.ServiceModel.Channels.CustomBinding> クラスを使用してバインディングを作成できます。  カスタム バインディングの作成の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  セキュリティが有効になっているバインディングを選択します。  既定では、<xref:System.ServiceModel.BasicHttpBinding> バインディング以外のバインディングではセキュリティが有効になっています。  セキュリティで保護されたバインディングを選択しない場合、またはセキュリティを無効にする場合は、セキュリティで保護されたデータ センターや隔離されたネットワークを使用するなど、他の方法でネットワーク交換が保護されていることを確認してください。  
+  
+> [!IMPORTANT]
+>  他の方法によってネットワーク交換がセキュリティ保護されない限り、セキュリティをサポートしないバインディングやセキュリティが無効になっているバインディングでは、双方向コントラクトを使用しないでください。  
+  
+## システム標準のバインディング  
+ 次のバインディングは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に付属します。  
+  
+|バインド|構成要素|説明|  
+|----------|----------|--------|  
+|<xref:System.ServiceModel.BasicHttpBinding>|[\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)|ASP.NET Web サービス \(ASMX\) ベースのサービスなど、WS\-Basic Profile に適合する Web サービスとの通信に適したバインディング。  このバインディングはトランスポートとして HTTP を、既定のメッセージ エンコーディングとして text\/XML を使用します。|  
+|<xref:System.ServiceModel.WSHttpBinding>|[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)|二重のサービス コントラクト以外に適した、セキュリティで保護された相互操作可能なバインディング。|  
+|<xref:System.ServiceModel.WS2007HttpBinding>|[\<ws2007HttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md)|<xref:System.ServiceModel.WSHttpBinding.Security%2A>、<xref:System.ServiceModel.ReliableSession>、および <xref:System.ServiceModel.WSHttpBindingBase.TransactionFlow%2A> の各バインド要素の適切なバージョンをサポートする、セキュリティで保護された相互運用可能なバインディング。|  
+|<xref:System.ServiceModel.WSDualHttpBinding>|[\<wsDualHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)|二重のサービス コントラクト、または SOAP 中継局を介しての通信に適した、セキュリティで保護された相互操作可能なバインディング。|  
+|<xref:System.ServiceModel.WSFederationHttpBinding>|[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)|WS\-Federation プロトコルをサポートする、セキュリティで保護された相互操作可能なバインディングで、フェデレーションに属す組織のユーザーを効率的に認証、および承認することができます。|  
+|<xref:System.ServiceModel.WS2007FederationHttpBinding>|[\<ws2007FederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md)|<xref:System.ServiceModel.WS2007HttpBinding>から派生し、フェデレーション セキュリティをサポートする、セキュリティで保護された相互運用可能なバインディングです。|  
+|<xref:System.ServiceModel.NetTcpBinding>|[\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション間での複数コンピューターの通信に適した、セキュリティで保護された最適バインディング。|  
+|<xref:System.ServiceModel.NetNamedPipeBinding>|[\<netNamedPipeBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md)|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション間でのコンピューター通信に適した、セキュリティで保護された信頼できる最適バインディング。|  
+|<xref:System.ServiceModel.NetMsmqBinding>|[\<netMsmqBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md)|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション間での複数コンピューターの通信に適した、キューに置かれたバインディング。|  
+|<xref:System.ServiceModel.NetPeerTcpBinding>|[\<netPeerTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)|セキュリティで保護された、複数のコンピューター通信を可能にするバインディング。|  
+|<xref:System.ServiceModel.WebHttpBinding>|[\<webHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md)|SOAP メッセージではなく、HTTP 要求を介して公開される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービスのエンドポイントを構成するために使用されるバインディング。|  
+|<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>|[\<msmqIntegrationBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md)|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションと既存のメッセージ キュー \(MSMQ: Message Queuing\) アプリケーション間のコンピューター間通信に適したバインディング。|  
+  
+## バインディング機能  
+ システム指定の各バインディングで提供される主要機能の一部を次の表に示します。  各バインディングを 1 列目に示します。機能に関する情報については表で説明します。  次の表に、使用されるバインディングの省略形のキーを示します。  バインディングを選択するには、必要な行の機能がすべて含まれる列を調べます。  
+  
+|バインディング|相互運用性|セキュリティ モード \(既定\)|セッション<br /><br /> \(既定\)|トランザクション|二重|  
+|-------------|-----------|-----------------------|----------------------|--------------|--------|  
+|<xref:System.ServiceModel.BasicHttpBinding>|Basic Profile 1.1|\(なし\)、トランスポート、メッセージ、混在|なし、\(なし\)|\(なし\)|N\/A|  
+|<xref:System.ServiceModel.WSHttpBinding>|WS|なし、トランスポート、\(メッセージ\)、混在|\(なし\)、トランスポート、信頼できるセッション|\(なし\)、あり|N\/A|  
+|<xref:System.ServiceModel.WS2007HttpBinding>|WS\-Security、WS\-Trust、WS\-SecureConversation、WS\-SecurityPolicy|なし、トランスポート、\(メッセージ\)、混在|\(なし\)、トランスポート、信頼できるセッション|\(なし\)、あり|N\/A|  
+|<xref:System.ServiceModel.WSDualHttpBinding>|WS|なし、\(メッセージ\)|\(信頼できるセッション\)|\(なし\)、あり|はい|  
+|<xref:System.ServiceModel.WSFederationHttpBinding>|WS\-Federation|なし、\(メッセージ\)、混在|\(なし\)、信頼できるセッション|\(なし\)、あり|いいえ|  
+|<xref:System.ServiceModel.WS2007FederationHttpBinding>|WS\-Federation|なし、\(メッセージ\)、混在|\(なし\)、信頼できるセッション|\(なし\)、あり|いいえ|  
+|<xref:System.ServiceModel.NetTcpBinding>|.NET|なし、\(トランスポート\)、メッセージ、<br /><br /> Mixed|信頼できるセッション、\(トランスポート\)|\(なし\)、あり|はい|  
+|<xref:System.ServiceModel.NetNamedPipeBinding>|.NET|なし、<br /><br /> \(トランスポート\)|なし、\(トランスポート\)|\(なし\)、あり|はい|  
+|<xref:System.ServiceModel.NetMsmqBinding>|.NET|なし、メッセージ、\(トランスポート\)、両方|\(なし\)|\(なし\)、あり|いいえ|  
+|<xref:System.ServiceModel.NetPeerTcpBinding>|Peer|なし、メッセージ、\(トランスポート\)、混在|\(なし\)|\(なし\)|はい|  
+|<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>|MSMQ|なし、\(トランスポート\)|\(なし\)|\(なし\)、あり|適用なし|  
+  
+ 次の表では、前の表内の機能について説明します。  
+  
+|特性|説明|  
+|--------|--------|  
+|相互運用性の種類|バインディングによる相互操作を可能にするプロトコルまたはテクノロジに名前を付けます。|  
+|セキュリティ|チャネルをセキュリティで保護する方法を指定します。<br /><br /> -   なし : SOAP のメッセージはセキュリティで保護されず、クライアントは認証されません。<br />-   トランスポート : セキュリティ要件はトランスポート層で満たされます。<br />-   メッセージ : セキュリティ要件はメッセージ層で満たされます。<br />-   混在 : このセキュリティ モードは `TransportWithMessageCredentials` として知られています。  メッセージ レベルで資格情報を処理し、整合性と機密性の要件がトランスポート層で満たされます。<br />-   両方 : メッセージ レベルとトランスポート レベルのセキュリティが共に使用されます。  この機能は、<xref:System.ServiceModel.NetMsmqBinding> に特有の機能です。|  
+|セッション|このバインディングでセッション コントラクトをサポートするかどうかを指定します。|  
+|トランザクション|トランザクションが有効かどうかを指定します。|  
+|二重|二重のコントラクトがサポートされているかどうかを指定します。  この機能はバインディングでセッションをサポートする必要があることに注意してください。|  
+|ストリーム|メッセージ ストリーミングをサポートするかどうかを指定します。|  
+  
+## 参照  
+ [エンドポイントの作成の概要](../../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [サービスとクライアントを構成するためのバインディングの使用](../../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-the-net-tcp-port-sharing-service.md b/docs/framework/wcf/feature-details/configuring-the-net-tcp-port-sharing-service.md
new file mode 100644
index 00000000000..648d2abdba5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-the-net-tcp-port-sharing-service.md
@@ -0,0 +1,74 @@
+---
+title: "Net.TCP ポート共有サービスを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6dd81fa-68b7-4e1b-868e-88e5901b7ea0
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# Net.TCP ポート共有サービスを構成する
+Net.TCP トランスポートを使用する自己ホスト型サービスは、`ListenBacklog` や `MaxPendingAccepts` など、いくつかの高度な設定を制御できます。これらは、ネットワーク通信で使用される、ベースである TCP ソケットの動作をコンロトールします。  ただし、各ソケットに対するこれらの設定は、トランスポート バインディングでポート共有が無効化されている場合 \(既定では有効\) に、バインディング レベルでのみ適用されます。  
+  
+ net.tcp バインディングは、\(トランスポート バインド要素で `portSharingEnabled =true` を設定することで\) ポート共有が有効化されている場合、外部プロセス \(Net.TCP ポート共有サービスをホストする SMSvcHost.exe\) に対し、自身の代わりに TCP ソケットを管理することを暗黙的に許可しています。  たとえば、TCP を使用している場合は次のように指定します。  
+  
+```  
+    <tcpTransport   
+        portSharingEnabled="true"  
+/>  
+```  
+  
+ この方法で設定すると、サービスのトランスポート バインド要素に指定したソケット設定は無視され、SMSvcHost.exe で指定されたソケット設定が採用されます。  
+  
+ SMSvcHost.exe を構成するには、SmSvcHost.exe.config という XML 構成ファイルを作成し、SMSvcHost.exe 実行可能ファイルと同じ物理ディレクトリ \(たとえば、C:\\Windows\\Microsoft.NET\\Framework\\v4.5\) に配置します。  
+  
+ 次の例では、すべての構成可能値の既定値を明示的に指定した SMSvcHost.exe.config のサンプルを示します。  
+  
+```  
+<configuration>  
+   <system.serviceModel.activation>  
+       <net.tcp listenBacklog="16" <!—16 * # of processors -->  
+          maxPendingAccepts="4"<!— 4 * # of processors -->  
+          maxPendingConnections="100"  
+          receiveTimeout="00:00:30" <!—30 seconds -->  
+          teredoEnabled="false">  
+          <allowAccounts>  
+             <!-- LocalSystem account -->  
+             <add securityIdentifier="S-1-5-18"/>  
+             <!-- LocalService account -->  
+             <add securityIdentifier="S-1-5-19"/>  
+             <!-- Administrators account -->  
+             <add securityIdentifier="S-1-5-20"/>  
+             <!-- Network Service account -->  
+             <add securityIdentifier="S-1-5-32-544" />  
+             <!-- IIS_IUSRS account (Vista only) -->  
+             <add securityIdentifier="S-1-5-32-568"/>  
+           </allowAccounts>  
+       </net.tcp>  
+</configuration>  
+```  
+  
+## SMSvcHost.exe.config を変更する場合  
+ 一般的に、SMSvcHost.exe.config ファイルの内容を変更する際には、このファイルに指定するすべての構成設定は、Net.TCP ポート共有サービスを使用するコンピューターのすべてのサービスに影響するため、注意が必要です。  これには、Windows プロセス アクティブ化サービス \(WAS\) の TCP アクティベーション機能を使用する [!INCLUDE[wv](../../../../includes/wv-md.md)] 上のアプリケーションも含まれます。  
+  
+ ただし、Net.TCP ポート共有サービスの既定の構成を変更する必要のある状況もあります。  たとえば、`maxPendingAccepts` の既定値は 4 \* プロセッサ数です。  ポート共有を使用する多数のサービスをホストするサーバーでは、この値を大きくして、最大のスループットを実現することができます。  `maxPendingConnections` の既定値は 100 です。  サービスを呼び出すクライアントが同時に複数存在し、サービスがクライアント接続を切断する場合も、この値を大きくすることを検討してください。  
+  
+ SMSvcHost.exe.config には、ポート共有サービスを使用する可能性のあるプロセス ID に関する情報も含まれています。  プロセスが、共有 TCP ポートを使用するためにポート共有サービスに接続すると、そのプロセスのプロセス ID が、ポート共有サービスの使用が許可されている ID のリストに照合されます。  これらの ID は、SMSvcHost.exe.config ファイルの \<allowAccounts\> セクションにセキュリティ識別子 \(SID\) として指定されています。  既定では、ポート共有サービスへのアクセス許可は、システム アカウント \(LocalService、LocalSystem、NetworkService\) や管理者グループのメンバーに与えられます。  ポート共有サービスに接続するために別の ID \(ユーザー ID など\) でプロセスが実行されることを許可しているアプリケーションでは、適切な SID を SMSvcHost.exe.config に明示的に追加する必要があります \(これらの変更は SMSvc.exe プロセスが再起動されるまで適用されません\)。  
+  
+> [!NOTE]
+>  ユーザー アカウント コントロール \(UAC\) が有効化されている [!INCLUDE[wv](../../../../includes/wv-md.md)] システムでは、アカウントが管理者グループのメンバーであっても、ローカル ユーザーには昇格されたアクセス許可が必要です。  このようなユーザーが昇格なしでもポート共有サービスを使用できるようにするには、ユーザーの SID \(またはそのユーザーがメンバーとなっているグループの SID\) を SMSvcHost.exe.config の \<allowAccounts\> セクションに明示的に追加する必要があります。  
+  
+> [!WARNING]
+>  既定の SMSvcHost.exe.config ファイルは、カスタムの `etwProviderId` を指定することによって、SMSvcHost.exe のトレースの影響がサービス トレースに及ぶのを防ぎます。  
+  
+## 参照  
+ [\<net.tcp\>](../../../../docs/framework/configure-apps/file-schema/wcf/net-tcp.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md b/docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md
new file mode 100644
index 00000000000..9632f5d92f8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md
@@ -0,0 +1,108 @@
+---
+title: "Windows Communication Foundation で使用するための Windows プロセス アクティブ化サービスを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d50712e-53cd-4773-b8bc-a1e1aad66b78
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Windows Communication Foundation で使用するための Windows プロセス アクティブ化サービスを設定する
+ここでは、Windows プロセス アクティブ化サービス \(WAS: Windows Process Activation Service\) を [!INCLUDE[wv](../../../../includes/wv-md.md)] で構成して、HTTP ネットワーク プロトコルでは通信しない [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストするために必要な手順について説明します。以降の各セクションで、この構成に関する手順について概説します。  
+  
+-   必要な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティベーション コンポーネントをインストール \(またはそのインストールを確認\) します。  
+  
+-   使用するネットワーク プロトコル バインドを含む WAS サイトを作成するか、新しいプロトコル バインドを既存のサイトに追加します。  
+  
+-   サービスをホストするアプリケーションを作成し、必要なネットワーク プロトコルを使用するようにそのアプリケーションを設定します。  
+  
+-   非 HTTP エンドポイントを公開する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構築します。  
+  
+## 非 HTTP バインドを使用したサイトの構成  
+ WAS で非 HTTP バインドを使用するには、サイト バインドを WAS 構成に追加する必要があります。WAS の構成ストアは、%windir%\\system32\\inetsrv\\config ディレクトリにある applicationHost.config ファイルです。この構成ストアは、WAS と IIS 7.0 の両方で共有されます。  
+  
+ applicationHost.config は、任意の標準テキスト エディター \(メモ帳など\) で開くことが可能な XML テキスト ファイルです。ただし、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] コマンド ライン構成ツール \(appcmd.exe\) の方が、非 HTTP サイトのバインディングの追加には適しています。  
+  
+ 次のコマンドは、appcmd.exe を使用して、既定の Web サイトに net.tcp サイト バインドを追加します \(このコマンドは 1 行で入力します\)。  
+  
+```  
+appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']  
+```  
+  
+ このコマンドは、次に示す行を applicationHost.config ファイルに追加することによって、既定の Web サイトに新しい net.tcp バインドを追加します。  
+  
+```  
+<sites>  
+    <site name="Default Web Site" id="1">  
+        <bindings>  
+            <binding protocol="HTTP" bindingInformation="*:80:" />  
+            //The following line is added by the command.  
+            <binding protocol="net.tcp" bindingInformation="808:*" />  
+        </bindings>  
+    </site>  
+</sites>  
+```  
+  
+## 非 HTTP プロトコルを使用するためのアプリケーションの設定  
+ 個々のネットワーク プロトコルは、アプリケーション レベルで有効\/無効を切り替えることができます。次のコマンドは、`Default Web Site` で動作するアプリケーションに対して、HTTP プロトコルと net.tcp プロトコルの両方を有効にする方法を示しています。  
+  
+```  
+appcmd.exe set app "Default Web Site/appOne" /enabledProtocols:net.tcp  
+```  
+  
+ 有効にするプロトコルのリストは、ApplicationHost.config に保存されたサイトの XML 構成の \<applicationDefaults\> 要素に設定することもできます。  
+  
+ 次の applicationHost.config からの XML コードは、HTTP プロトコルと非 HTTP プロトコルの両方にバインドされたサイトを示しています。非 HTTP プロトコルのサポートに必要な追加の構成は、コメントで付記されています。  
+  
+```  
+<sites>  
+    <site name="Default Web Site" id="1">  
+    <application path="/">  
+        <virtualDirectory path="/" physicalPath="D:\inetpub\wwwroot" />  
+    </application>  
+       <bindings>  
+            //The following two lines are added by the command.  
+            <binding protocol="HTTP" bindingInformation="*:80:" />  
+            <binding protocol="net.tcp" bindingInformation="808:*" />  
+       </bindings>  
+    </site>  
+    <siteDefaults>  
+        <logFile   
+        customLogPluginClsid="{FF160663-DE82-11CF-BC0A-00AA006111E0}"  
+          directory="D:\inetpub\logs\LogFiles" />  
+        <traceFailedRequestsLogging   
+          directory="D:\inetpub\logs\FailedReqLogFiles" />  
+    </siteDefaults>  
+    <applicationDefaults   
+      applicationPool="DefaultAppPool"   
+      //The following line is inserted by the command.  
+      enabledProtocols="http, net.tcp" />  
+    <virtualDirectoryDefaults allowSubDirConfig="true" />  
+</sites>  
+```  
+  
+ 非 HTTP アクティブ化の WAS を使用するサービスをアクティブ化しようとしたときに、WAS をインストールおよび構成していない場合、次のエラーが表示されることがあります。  
+  
+```Output  
+[InvalidOperationException: The protocol 'net.tcp' does not have an implementation of HostedTransportConfiguration type registered.]System.ServiceModel.AsyncResult.End(IAsyncResult result) +15778592   System.ServiceModel.Activation.HostedHttpRequestAsyncResult.End(IAsyncResult result) +15698937   System.ServiceModel.Activation.HostedHttpRequestAsyncResult.ExecuteSynchronous(HttpApplication context, Boolean flowContext) +265   System.ServiceModel.Activation.HttpModule.ProcessRequest(Object sender, EventArgs e) +227   System.Web.SyncEventExecutionStep.System.Web.HttpApplication.IExecutionStep.Execute() +80   System.Web.HttpApplication.ExecuteStep(IExecutionStep step, Boolean& completedSynchronously) +171  
+```  
+  
+ このエラーが表示された場合は、非 HTTP アクティブ化の WAS が適切にインストールおよび構成されていることを確認してください。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : WCF アクティブ化コンポーネントをインストールして設定する](../../../../docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md).  
+  
+## 非 HTTP のアクティブ化で WAS を使用する WCF サービスの構築  
+ WAS をインストールして構成する手順 \(「[方法 : WCF アクティブ化コンポーネントをインストールして設定する](../../../../docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md)」を参照\) を実行した後の、アクティブ化で WAS を使用するためのサービスの構成は、IIS でホストされるサービスの構成に似ています。  
+  
+ WAS によりアクティブ化される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの構築の詳細な手順については、「[方法 : WAS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)」を参照してください。  
+  
+## 参照  
+ [Windows プロセス アクティブ化サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-timeout-values-on-a-binding.md b/docs/framework/wcf/feature-details/configuring-timeout-values-on-a-binding.md
new file mode 100644
index 00000000000..ef1f748b717
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-timeout-values-on-a-binding.md
@@ -0,0 +1,102 @@
+---
+title: "バインディングでのタイムアウト値の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b5c825a2-b48f-444a-8659-61751ff11d34
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# バインディングでのタイムアウト値の構成
+WCF バインディングには、さまざまなタイムアウト設定が用意されています。  これらのタイムアウト設定を正しく行うことによって、サービスのパフォーマンスが向上するだけでなく、サービスの操作性とセキュリティにも役立ちます。  WCF バインディングで使用できるタイムアウトは次のとおりです。  
+  
+1.  OpenTimeout  
+  
+2.  CloseTimeout  
+  
+3.  SendTimeout  
+  
+4.  ReceiveTimeout  
+  
+## WCF バインディングのタイムアウト  
+ このトピックで説明する各設定は、バインディング自体に対して、コードまたは構成を使用して適用されます。  次のコードは、自己ホスト型サービスのコンテキストで、WCF バインディングのタイムアウトをプログラムで設定する方法を示します。  
+  
+```csharp  
+public static void Main()  
+        {  
+            Uri baseAddress = new Uri("http://localhost/MyServer/MyService");  
+  
+            try  
+            {  
+                ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService));  
+  
+                WSHttpBinding binding = new WSHttpBinding();  
+                binding.OpenTimeout = new TimeSpan(0, 10, 0);  
+                binding.CloseTimeout = new TimeSpan(0, 10, 0);  
+                binding.SendTimeout = new TimeSpan(0, 10, 0);  
+                binding.ReceiveTimeout = new TimeSpan(0, 10, 0);  
+  
+                serviceHost.AddServiceEndpoint("ICalculator", binding, baseAddress);  
+                serviceHost.Open();  
+  
+                // The service can now be accessed.  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+            }  
+            catch (CommunicationException ex)  
+            {  
+                // Handle exception ...  
+            }  
+        }  
+  
+```  
+  
+ 次の例は、構成ファイル内でバインディングのタイムアウトを構成する方法を示します。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding openTimeout="00:10:00"   
+                 closeTimeout="00:10:00"   
+                 sendTimeout="00:10:00"   
+                 receiveTimeout="00:10:00">  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  </system.serviceModel>  
+  
+```  
+  
+ これらの設定の詳細については、<xref:System.ServiceModel.Channels.Binding> クラスに関するドキュメントを参照してください。  
+  
+### サービス側のタイムアウト  
+ クライアント側のタイムアウトは次のとおりです。  
+  
+1.  SendTimeout: OperationTimeout の初期化に使用します。要求\/応答サービス操作の応答メッセージの受信を含め、メッセージの送信プロセス全体を制御します。  このタイムアウトは、コールバック コントラクト メソッドから応答メッセージを送信するときにも適用されます。  
+  
+2.  OpenTimeout: 明示的なタイムアウト値が指定されていない場合、チャネルを開くときに使用します。  
+  
+3.  CloseTimeout: 明示的なタイムアウト値が指定されていない場合、チャネルを閉じるときに使用します。  
+  
+4.  ReceiveTimeout: 使用されません。  
+  
+### サービス側のタイムアウト  
+ サービス側のタイムアウトは次のとおりです。  
+  
+1.  SendTimeout、OpentTimeout、CloseTimeout は、クライアント側と同じです。  
+  
+2.  ReceiveTimeout: セッションがタイムアウトするまでのアイドル状態の時間を制御するセッション アイドル タイムアウトを初期化するために Service Framework Layer で使用します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-workflowservicehost.md b/docs/framework/wcf/feature-details/configuring-workflowservicehost.md
new file mode 100644
index 00000000000..75b9ddc83eb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-workflowservicehost.md
@@ -0,0 +1,37 @@
+---
+title: "WorkflowServiceHost の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8e961cb-0ef5-4f8c-8a25-e76ae6334fed
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WorkflowServiceHost の構成
+このセクションには、構成に含まれる <xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスの各種機能を構成する方法について簡単に説明する、操作方法についての短いトピックが含まれます。  これらのトピックでは、ワークフロー サービス固有の構成について説明しています。その他のすべての構成は、通常の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同じ方法で構成されます。  
+  
+## このセクションの内容  
+ [WorkflowServiceHost を使用して永続性を構成する方法](../../../../docs/framework/wcf/feature-details/how-to-configure-persistence-with-workflowservicehost.md)  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用して、ワークフロー サービスに永続性を構成する方法を説明します。  
+  
+ [方法: WorkflowServiceHost を使用して追跡を構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-tracking-with-workflowservicehost.md)  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用して、ワークフロー サービスにワークフロー追跡を構成する方法を説明します。  
+  
+ [WorkflowServiceHost を使用してアイドル動作を構成する方法](../../../../docs/framework/wcf/feature-details/how-to-configure-idle-behavior-with-workflowservicehost.md)  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用して、ワークフロー サービスのアイドル動作を構成する方法を説明します。  
+  
+ [ワークフロー サービスの未処理の例外動作を構成する方法](../../../../docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md)  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用して、ワークフロー サービスの未処理の例外動作を構成する方法を説明します。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [ワークフロー サービスのホストの概要](../../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md b/docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md
new file mode 100644
index 00000000000..b67befcc79d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md
@@ -0,0 +1,130 @@
+---
+title: "WS-AtomicTransaction サポートの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WS-AT プロトコル [WCF], WS-AtomicTransaction の構成"
+ms.assetid: cb9f1c9c-1439-4172-b9bc-b01c3e09ac48
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# WS-AtomicTransaction サポートの構成
+ここでは、WS\-AtomicTransaction \(WS\-AT\) 構成ユーティリティを使用して WS\-AT サポートを構成する方法について説明します。  
+  
+## WS\-AT 構成ユーティリティの使用  
+ WS\-AT 構成ユーティリティ \(wsatConfig.exe\) は、WS\-AT 設定の構成に使用されます。  WS\-AT プロトコル サービスを有効にするには、この構成ユーティリティを使用して、WS\-AT の HTTPS ポートを構成し、X.509 証明書をその HTTPS ポートにバインドし、証明書のサブジェクト名または拇印を指定して、承認されたパートナーの証明書を構成する必要があります。  この構成ユーティリティでは、トレース モードを選択して、送信トランザクションの既定のタイムアウト値と受信トランザクションの最大タイムアウト値を設定することもできます。  
+  
+ このツールの機能は、コンポーネント サービス管理コンソールで Microsoft 管理コンソール \(MMC\) のプロパティ ページ スナップインを使用するか、またはコマンド ライン ウィンドウから操作できます。  WS\-AT サポートをローカル コンピューターで構成するには、コマンド ライン ウィンドウを使用し、ローカル コンピューターとリモート コンピューターの両方で設定を構成するには、MMC スナップインを使用します。  
+  
+ コマンド ライン ウィンドウは、Windows SDK のインストール場所の "%WINDIR%\\Microsoft.NET\\Framework\\v3.0\\Windows Communication Foundation" で使用できます。  
+  
+ コマンド ライン ツール[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)」を参照してください。  
+  
+ [!INCLUDE[wxp](../../../../includes/wxp-md.md)] または [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] を実行している場合に、MMC スナップインにアクセスするには、**\[コントロール パネル\]、\[管理ツール\]、\[コンポーネント サービス\]** の順にクリックし、**\[マイ コンピューター\]** を右クリックして、**\[プロパティ\]** を選択します。  この場所では、Microsoft 分散トランザクション コーディネーター \(MSDTC\) を構成することもできます。  構成で使用できるオプションは、**\[WS\-AT\]** タブにグループ化されています。  Windows Vista または [!INCLUDE[lserver](../../../../includes/lserver-md.md)] を実行している場合に、MMC スナップインにアクセスするには、**\[スタート\]** ボタンをクリックし、**\[検索\]** ボックスに「`dcomcnfg.exe`」と入力します。  MMC が開いている場合は、**\[マイ コンピューター\]、\[分散トランザクション コーディネーター\]** ノードの順にクリックし、\[ローカル DTC\] ノードを右クリックして、**\[プロパティ\]** をクリックします。  構成で使用できるオプションは、**\[WS\-AT\]** タブにグループ化されています。  
+  
+ MMC スナップイン[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WS\-AtomicTransaction 構成 MMC スナップイン](../../../../docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md)」を参照してください。  
+  
+ ツールのユーザー インターフェイスを有効にするには、WsatUI.dll ファイルを登録しておく必要があります。このファイルは、次のパスにあります。  
+  
+ %PROGRAMFILES%\\Microsoft SDKs\\Windows\\v6.0\\Bin  
+  
+ 製品を登録するには、\[コマンド プロンプト\] ウィンドウから次のコマンドを実行します。  
+  
+ `regasm.exe /codebase WsatUI.dll`  
+  
+## WS\-AT の有効化  
+ ポート 443 と、ローカル コンピューター ストアにインストールされている秘密キーを持つ X.509 証明書を使用して、MSDTC 内部で WS\-AT プロトコル サービスを有効にするには、wsatConfig.exe ツールを使用して次のコマンドを実行します。  
+  
+ `WsatConfig.exe –network:enable –port:8443 –endpointCert:<machine|"Issuer\SubjectName"> -accountsCerts:<thumbprint|"Issuer\SubjectName"> -restart`  
+  
+ 個々のパラメーターを、ユーザーの環境に適した値に置き換えます。  
+  
+ MSDTC 内部で WS\-AT プロトコル サービスを無効にするには、wsatConfig.exe ツールを使用して次のコマンドを実行します。  
+  
+ `WsatConfig.exe –network:disable -restart`  
+  
+## 2 台のコンピューター間での信頼の確立  
+ WS\-AT プロトコル サービスでは、管理者が、分散トランザクションに参加する個々のアカウントを明示的に承認する必要があります。  2 台のコンピューターの管理者である場合は、両方のコンピューターを構成して、相互の信頼関係を確立することができます。それには、コンピューター間で適切な証明書を交換し、その証明書を適切な証明書ストアにインストールし、wsatConfig.exe ツールを使用して各コンピューターの証明書をお互いの承認済み参加者の証明書リストに追加します。  この手順は、WS\-AT を使用する 2 台のコンピューター間で分散トランザクションを実行するために必要です。  
+  
+ 次の例では、A と B という 2 台のコンピューター間で信頼を確立する手順を示します。  
+  
+### 証明書の作成とエクスポート  
+ この手順では、MMC 証明書スナップインを使用する必要があります。  このスナップインにアクセスするには、\[スタート\] ボタンをクリックして \[ファイル名を指定して実行\] をクリックし、入力ボックスに「mmc」と入力して \[OK\] をクリックします。  次に、**\[コンソール1\]** ウィンドウで **\[ファイル\]** メニューの **\[スナップインの追加と削除\]** をクリックし、\[追加\] をクリックして、**\[利用できるスタンドアロン スナップイン\]** ボックスの一覧の **\[証明書\]** をクリックします。  最後に、管理先として **\[コンピューター アカウント\]** をクリックし、**\[OK\]** をクリックします。  **\[証明書\]** ノードがスナップイン コンソールに表示されます。  
+  
+ 信頼を確立するために必要な証明書は、あらかじめ用意されている必要があります。  以下の手順に進む前に新しい証明書を作成してインストールする方法については、「[方法: 開発時に WCF の一時的なクライアント証明書を作成およびインストールする](http://go.microsoft.com/fwlink/?LinkId=158925)」を参照してください。  
+  
+1.  コンピューター A で、MMC 証明書スナップインを使用して、既存の証明書 \(certA\) を LocalMachine\\MY \(Personal Node\) ストアと LocalMachine\\ROOT \(信頼されたルート証明機関のノード\) ストアにインポートします。  証明書を特定のノードにインポートするには、ノードを右クリックして、**\[すべてのタスク\]、\[インポート\]** の順にクリックします。  
+  
+2.  コンピューター B で、MMC 証明書スナップインを使用して、秘密キーを持つ証明書 certB を作成するか取得し、LocalMachine\\MY \(Personal Node\) ストアと LocalMachine\\ROOT \(信頼されたルート証明機関のノード\) ストアにインポートします。  
+  
+3.  certA の秘密キーをファイルにエクスポートします \(エクスポートしていない場合\)。  
+  
+4.  certB の秘密キーをファイルにエクスポートします \(エクスポートしていない場合\)。  
+  
+### コンピューター間での相互の信頼関係の確立  
+  
+1.  コンピューター A で、certB のファイルを LocalMachine\\MY ストアと LocalMachine\\ROOT ストアにインポートします。  これによって、コンピューター A が certB を信頼して通信することを宣言します。  
+  
+2.  コンピューター B で、certA のファイルを LocalMachine\\MY ストアと LocalMachine\\ROOT ストアにインポートします。  これによって、コンピューター B が certA を信頼して通信することを示します。  
+  
+ この手順が完了すると、2 台のコンピューター間に信頼が確立されるので、WS\-AT を使用して相互に通信するように構成できます。  
+  
+### MSDTC での証明書の使用の構成  
+ WS\-AT プロトコル サービスは、クライアントとサーバーの両方として機能するので、このサービスは、受信接続のリッスンと送信接続の開始を実行する必要があります。  このため、外部の通信相手と通信するときに使用する証明書と、受信接続を受け入れるときに承認する証明書を MSDTC に設定する必要があります。  
+  
+ これを構成するには、MMC WS\-AT スナップインを使用します。  このツール[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WS\-AtomicTransaction 構成 MMC スナップイン](../../../../docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md)」を参照してください。  次の手順では、MSDTC を実行している 2 台のコンピューター間に信頼を確立する方法を説明します。  
+  
+1.  コンピューター A の設定を構成します。  \[エンドポイント証明書\] に certA を選択します。  \[承認された証明書\] に certB を選択します。  
+  
+2.  コンピューター B の設定を構成します。  \[エンドポイント証明書\] に certB を選択します。  \[承認された証明書\] に certA を選択します。  
+  
+> [!NOTE]
+>  一方のコンピューターからもう一方のコンピューターにメッセージを送信する場合、送信側は、受信側の証明書のサブジェクト名と受信側のコンピューターの名前が一致することを確認します。  これらが一致しないと、証明書の確認が失敗し、2 台のコンピューターは通信できなくなります。  
+>   
+>  ドメインに参加しているコンピューターの名前は完全修飾ドメイン名です。  既定では、ワークグループ上のコンピューターの名前は、コンピューターの NetBIOS 名です。  ただし、2 台のコンピューター間で使用されている接続用のドメイン ネーム システム \(DNS\) サフィックスが存在する場合は、名前に DNS サフィックス含めることもできます。  
+>   
+>  ワークグループ コンピューターがドメインに参加するときなどにコンピューターの名前を変更した場合は、証明書を再発行するか、DNS サフィックスを手動で構成する必要があります。  
+  
+## セキュリティ  
+ 一部の MSDTC と WS\-AT 関連の設定はそれぞれ、レジストリ HKLM\\Software\\Microsoft\\MSDTC と HKLM\\Software\\Microsoft\\WSAT に格納されるので、必ずこのレジストリ キーをセキュリティで保護し、管理者だけがそのキーに書き込めるようにします。  レジストリ エディターで、セキュリティで保護するキーを右クリックし、**\[アクセス許可\]** をクリックして該当するアクセス制御を設定します。  重要なキーを特権の低いユーザーに対して読み取り専用にしておくことが、システムのセキュリティと整合性を確保するために重要です。  
+  
+ MSDTC を展開する場合、管理者は、すべての MSDTC データの交換がセキュリティで保護されるようにする必要があります。  ワークグループの展開では、トランザクションのインフラストラクチャを悪質なユーザーから隔離してください。クラスターの展開では、クラスター レジストリをセキュリティで保護してください。  
+  
+## トレース  
+ WS\-AT プロトコル サービスは、[WS\-AtomicTransaction 構成 MMC スナップイン](../../../../docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md) ツールを使用して有効化および管理できる、トランザクション固有の統合トレースをサポートします。  トレースには、特定のトランザクションに参加した時刻、トランザクションが終了状態に到達した時刻、各トランザクション参加で受け取った結果などを示すデータを含めることができます。  すべてのトレースは、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) ツールを使用して表示できます。  
+  
+ WS\-AT プロトコル サービスは、ETW トレース セッションを通じて統合 ServiceModel トレースもサポートします。  これにより、既存のトランザクション トレースに加えて、より詳細な通信固有のトレースが得られます。  これらの追加トレースを有効にするには、次の手順を実行します。  
+  
+1.  **\[スタート\] ボタン、\[ファイル名を指定して実行\]** の順にクリックし、入力ボックスに「regedit」と入力して、**\[OK\]** をクリックします。  
+  
+2.  **レジストリ エディター**の左ペインで、Hkey\_Local\_Machine\\SOFTWARE\\Microsoft\\WSAT\\3.0\\ に移動します。  
+  
+3.  右ペインで `ServiceModelDiagnosticTracing` 値を右クリックし、**\[変更\]** をクリックします。  
+  
+4.  **\[値のデータ\]** 入力ボックスに、次の有効な値のいずれかを入力し、有効にするトレース レベルを指定します。  
+  
+-   0 : オフ  
+  
+-   1 : クリティカル  
+  
+-   3 : エラー \(  既定値\)  
+  
+-   7 : 警告  
+  
+-   15 : 情報  
+  
+-   31 : 詳細  
+  
+## 参照  
+ [WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)   
+ [WS\-AtomicTransaction 構成 MMC スナップイン](../../../../docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/content-based-correlation.md b/docs/framework/wcf/feature-details/content-based-correlation.md
new file mode 100644
index 00000000000..2549321d747
--- /dev/null
+++ b/docs/framework/wcf/feature-details/content-based-correlation.md
@@ -0,0 +1,73 @@
+---
+title: "コンテンツ ベースの相関関係。 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f46a2b68-8d24-4122-bbee-9573fc3f9fb4
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# コンテンツ ベースの相関関係。
+ワークフロー サービスがクライアントや他のサービスと通信するときに、交換されるメッセージに、特定のインスタンスに一意に関連付けられたデータが含まれることがよくあります。  コンテンツ ベースの相関関係では、顧客番号や注文 ID などのメッセージ内のデータを使用して、適切なワークフロー インスタンスにメッセージをルーティングします。  このトピックでは、コンテンツ ベースの相関関係をワークフロー内で使用する方法について説明します。  
+  
+## コンテンツ ベースの相関関係の使用  
+ コンテンツ ベースの相関関係は、単一のクライアントによってアクセスされる複数のメソッドがワークフロー サービスにあり、交換されるメッセージ内の一部のデータによって目的のインスタンスが識別される場合に使用されます。  
+  
+> [!NOTE]
+>  コンテンツ ベースの相関関係は、コンテキスト交換のバインドがサポート対象のものではないためにコンテキスト相関関係を使用できない場合に便利です。  コンテキスト相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[コンテキスト交換](../../../../docs/framework/wcf/feature-details/context-exchange-correlation.md)」を参照してください。  
+  
+ これらの通信で使用される各メッセージ アクティビティでは、インスタンスを一意に識別するメッセージ内のデータの場所を指定する必要があります。  これを行うには、<xref:System.ServiceModel.Activities.QueryCorrelationInitializer> または <xref:System.ServiceModel.Activities.Receive.CorrelatesOn%2A> を使用して <xref:System.ServiceModel.MessageQuerySet> を指定し、インスタンスを一意に識別するデータを求めるクエリをメッセージに対して実行します。  
+  
+> [!WARNING]
+>  インスタンスの識別に使用されるデータは、相関関係キーにハッシュされます。  相関関係による関連付けで使用するデータは必ず、一意にする必要があります。一意でない場合は、ハッシュされたキーで競合が発生し、誤った場所にメッセージがルーティングされる可能性があります。  たとえば、顧客名だけに基づいた関連付けでは、同じ名前の顧客が複数存在する場合があるため、競合が発生する可能性があります。  メッセージの関連付けに使用するデータの一部として、コロン \(`:`\) を使用することはできません。コロンは、メッセージ クエリのキーと値の区切り文字として既に使用されており、後でハッシュされる文字列に含まれるためです。  
+  
+ 次の例では、ワークフロー サービスの最初の <xref:System.ServiceModel.Activities.Receive> または <xref:System.ServiceModel.Activities.SendReply> が `OrderId` を返します。これは、ワークフロー サービス内の後続の <xref:System.ServiceModel.Activities.Receive> アクティビティへの呼び出しで、クライアントから再び渡されます。  
+  
+ [!code-csharp[CFX_ContentCorrelation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#1)]  
+  
+ 前の例は、<xref:System.ServiceModel.Activities.SendReply> によって初期化される、コンテンツ ベースの相関関係を示しています。  <xref:System.ServiceModel.MessageQuerySet> は、このサービスに送信される後続のメッセージを特定するために使用されるデータが `OrderId` であることを指定します。  
+  
+ [!code-csharp[CFX_ContentCorrelation#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#2)]  
+  
+ ワークフロー内で <xref:System.ServiceModel.Activities.SendReply> に続く <xref:System.ServiceModel.Activities.Receive> アクティビティは、<xref:System.ServiceModel.Activities.SendReply> によって初期化された関連付けに従います。  どちらのアクティビティも同じ <xref:System.ServiceModel.Activities.CorrelationHandle> を共有しますが、それぞれには、その特定のメッセージ内のどこに対象データがあるかを指定する独自の <xref:System.ServiceModel.MessageQuerySet> および <xref:System.ServiceModel.XPathMessageQuery> があります。  関連付けを初期化するアクティビティでは、この <xref:System.ServiceModel.MessageQuerySet> が <xref:System.ServiceModel.Activities.Receive.CorrelationInitializers%2A> プロパティで指定され、後続のすべての <xref:System.ServiceModel.Activities.Receive> アクティビティについては、<xref:System.ServiceModel.Activities.Receive.CorrelatesOn%2A> プロパティを使用して指定されます。  
+  
+ [!code-csharp[CFX_ContentCorrelation#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#3)]  
+  
+ コンテンツ ベースの相関関係は、すべてのメッセージ アクティビティ \(<xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.Receive>、<xref:System.ServiceModel.Activities.SendReply>、<xref:System.ServiceModel.Activities.ReceiveReply>\) によって、メッセージの一部としてデータが送信されるときに初期化できます。  特定のデータがメッセージの一部として送信されない場合は、明示的に <xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティを使用することで初期化できます。  データの複数の部分で一意にメッセージを識別する必要がある場合は、複数のクエリを <xref:System.ServiceModel.MessageQuerySet> に追加できます。  これらの例では、`CorrelatesWith` または `CorrelationHandle` プロパティを使用して、<xref:System.ServiceModel.Activities.CorrelationHandle> が各アクティビティに明示的に提供されていますが、すべてが `OrderId` で相関するこの例のように、ワークフロー全体で必要な関連付けが 1 つのみである場合は、<xref:System.ServiceModel.Activities.WorkflowServiceHost> で提供される、暗黙の関連付けハンドル管理で十分です。  
+  
+## InitializeCorrelation アクティビティの使用  
+ 前の例では、<xref:System.ServiceModel.Activities.SendReply> アクティビティを通じて、`OrderId` が呼び出し元に送信され、このアクティビティで関連付けが初期化されました。  同じ動作を、<xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティを使用して実現することもできます。  <xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティは、<xref:System.ServiceModel.Activities.CorrelationHandle> と、メッセージを適切なインスタンスに割り当てるために使用する項目を表す辞書を受け取ります。  <xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティを前のサンプルで使用するには、<xref:System.ServiceModel.Activities.SendReply> アクティビティから <xref:System.ServiceModel.Activities.SendReply.CorrelationInitializers%2A> を削除し、<xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティを使用して、関連付けを初期化します。  
+  
+ [!code-csharp[CFX_ContentCorrelation#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#4)]  
+  
+ その後、<xref:System.ServiceModel.Activities.InitializeCorrelation> アクティビティは、データを保持する変数が挿入された後、かつ、初期化された <xref:System.ServiceModel.Activities.CorrelationHandle> との関連付けを行う <xref:System.ServiceModel.Activities.Receive> アクティビティの前にワークフローで使用されます。  
+  
+ [!code-csharp[CFX_ContentCorrelation#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#5)]  
+  
+## ワークフロー デザイナーを使用した XPath クエリの構成  
+ 前の例では、メッセージ クエリで使用されているアクティビティおよび XPath クエリがコードで指定されています。  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] のワークフロー デザイナーでは、XPath の生成を、コンテンツ ベースの相関関係の `DataContract` 型から行うための機能も提供されています。  前の例に示した 1 つ目の XPath 構成は、<xref:System.ServiceModel.Activities.SendReply> 用に構成されていました。  
+  
+ [!code-csharp[CFX_ContentCorrelation#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#2)]  
+  
+ XPath をワークフロー デザイナーでメッセージ アクティビティ用に構成するには、ワークフロー デザイナーでアクティビティを選択します。  前の例で示したように、アクティビティが関連付けの初期化を行っている場合は、**\[プロパティ\]** ウィンドウの **CorrelationInitializers** プロパティの省略記号ボタンをクリックします。  **\[関連付け初期化子の追加\]** ダイアログ ウィンドウが表示されます。  このダイアログ ボックスで、関連付けの種類を指定し、関連付けに使用する内容を選択できます。  <xref:System.ServiceModel.Activities.CorrelationHandle> 変数を **\[初期化子の追加\]** ボックスで指定し、関連付けの種類と関連付けに使用するデータをダイアログ ボックスの **\[XPath クエリ\]** セクションで選択します。  
+  
+ ![CorrelationInitializer ダイアログ](../../../../docs/framework/wcf/feature-details/media/correlationinitializerdlg.jpg "CorrelationInitializerDlg")  
+  
+ 前の例に示した 2 つ目の XPath クエリは、<xref:System.ServiceModel.Activities.Receive> アクティビティで構成されました。  
+  
+ [!code-csharp[CFX_ContentCorrelation#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_contentcorrelation/cs/program.cs#3)]  
+  
+ 関連付けの初期化を行わないメッセージ アクティビティ用の XPath クエリを構成するには、ワークフロー デザイナーでアクティビティを選択し、**\[プロパティ\]** ウィンドウの **CorrelatesOn** プロパティの省略記号ボタンをクリックします。  **\[CorrelatesOn の定義\]** ダイアログ ウィンドウが表示されます。  
+  
+ ![&#91;CorrelatesOn の定義&#93;](../../../../docs/framework/wcf/feature-details/media/correlatesondialog.jpg "CorrelatesOnDialog")  
+  
+ このダイアログで <xref:System.ServiceModel.Activities.CorrelationHandle> を指定し、**\[XPath クエリ\]** 一覧から項目を選択して XPath クエリをビルドします。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/context-exchange-correlation.md b/docs/framework/wcf/feature-details/context-exchange-correlation.md
new file mode 100644
index 00000000000..badc8317056
--- /dev/null
+++ b/docs/framework/wcf/feature-details/context-exchange-correlation.md
@@ -0,0 +1,110 @@
+---
+title: "コンテキスト交換の相関関係 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e2852be-3601-45ae-b507-ccc465d45c60
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# コンテキスト交換の相関関係
+コンテキスト相関関係は、[.NET コンテキスト交換プロトコルの仕様](http://go.microsoft.com/fwlink/?LinkId=166059)で説明されているコンテキスト交換メカニズムに基づきます。コンテキスト相関関係では、既知のコンテキスト ヘッダーまたはクッキーを使用して、メッセージを正しいインスタンスに関連付けます。コンテキスト相関関係を使用するには、<xref:System.ServiceModel.BasicHttpContextBinding>、<xref:System.ServiceModel.WSHttpContextBinding>、<xref:System.ServiceModel.NetTcpContextBinding> などのコンテキスト ベースのバインディングが、<xref:System.ServiceModel.Activities.WorkflowServiceHost> に提供されるエンドポイントで使用される必要があります。このトピックでは、メッセージング アクティビティを指定したコンテキスト相関関係をワークフロー サービス内で使用する方法について説明します。  
+  
+## コンテキスト相関関係の使用  
+ クライアントがワークフロー サービスに繰り返し呼び出しを行う必要があり、そのサービスがコンテキスト バインディングの 1 つを使用してホストされている場合に、コンテキスト相関関係が使用されます。この種類の相関関係は、ワークフロー サービス内で <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアによって初期化されます。コンテキストは、応答と共にクライアントに送り返されます。その後、クライアントによって、サービスへの以降の呼び出しにアタッチされます。  
+  
+### ワークフロー サービス内でのコンテキスト相関関係の構成  
+ コンテキスト相関関係は、最初の受信メッセージに応答する <xref:System.ServiceModel.Activities.SendReply> アクティビティと関連付けられている <xref:System.ServiceModel.Activities.ContextCorrelationInitializer> を使用して初期化されます。次の例では、コンテキスト相関関係を初期化するように <xref:System.ServiceModel.Activities.SendReply> が構成されています。  
+  
+```csharp  
+Variable<string> Item = new Variable<string>();  
+Variable<CorrelationHandle> OrderHandle = new Variable<CorrelationHandle>();  
+  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = "IOrderService",  
+    OperationName = "StartOrder"  
+};  
+  
+SendReply ReplyToStartOrder = new SendReply  
+{  
+    Request = StartOrder,  
+    CorrelationInitializers =  
+    {  
+        new ContextCorrelationInitializer  
+        {  
+            CorrelationHandle = OrderHandle  
+        }  
+    }  
+};  
+```  
+  
+> [!NOTE]
+>  この例では、実際にはコンテキストの関連付けおよび要求\/応答の相関関係の 2 種類の相関関係が使用されています。コンテキストの相関関係は、クライアントからの呼び出しが適切なインスタンスにルーティングされるように使用されます。要求\/応答の相関関係は、これらのアクティビティによってモデル化される双方向の操作を実装するために、<xref:System.ServiceModel.Activities.Receive> アクティビティおよび <xref:System.ServiceModel.Activities.SendReply> アクティビティで使用されます。この例では、コンテキストの相関関係のみが明示的に構成され、<xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> ペアは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> の暗黙の <xref:System.ServiceModel.Activities.CorrelationHandle> 管理で提供される、既定の要求\/応答の相関関係を使用しています。ワークフロー デザイナーで **ReceiveAndSendReply** アクティビティ テンプレートを使用する場合、要求\/応答の相関関係は明示的に構成されます。要求\/応答の相関関係および暗黙の関連付けハンドル管理[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[要求\/応答](../../../../docs/framework/wcf/feature-details/request-reply-correlation.md)」および「[相関関係の概要](../../../../docs/framework/wcf/feature-details/correlation-overview.md)」を参照してください。**ReceiveAndSendReply** アクティビティ テンプレート[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ReceiveAndSendReply](../Topic/ReceiveAndSendReply%20Template%20Designer.md)」を参照してください。  
+  
+ ワークフロー サービス内の以降の <xref:System.ServiceModel.Activities.Receive> アクティビティは、前の例の <xref:System.ServiceModel.Activities.SendReply> で初期化された <xref:System.ServiceModel.Activities.CorrelationHandle> を参照できます。  
+  
+```csharp  
+Receive AddItem = new Receive  
+{  
+    ServiceContractName = "IOrderService",  
+    OperationName = "AddItem",  
+    CorrelatesWith = OrderHandle  
+};  
+```  
+  
+ エンドポイントは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> で、<xref:System.ServiceModel.BasicHttpContextBinding> などのコンテキスト ベースのバインディングを使用するように構成されます。  
+  
+```xml  
+<endpoint  
+  contract=”IOrderContract”  
+  binding = “basicHttpContextBinding”  
+  address=”http://localhost:8080/OrderService” />  
+```  
+  
+### ワークフロー クライアント内でのコンテキスト相関関係の構成  
+ クライアントが別のワークフローである場合は、コンテキスト相関関係をクライアントでも構成する必要があります。クライアント ワークフローでは、ワークフロー サービスへの最初の呼び出しを行う <xref:System.ServiceModel.Activities.Send>\/<xref:System.ServiceModel.Activities.ReceiveReply> ペアの <xref:System.ServiceModel.Activities.ReceiveReply> が、<xref:System.ServiceModel.Activities.ContextCorrelationInitializer> で構成される必要があります。  
+  
+```csharp  
+Variable<CorrelationHandle> cchandle = new Variable<CorrelationHandle>();  
+Send request = new Send  
+{  
+    // Activity configuration omitted.  
+};  
+  
+ReceiveReply reply = new ReceiveReply  
+{  
+    Request = request,  
+    CorrelationInitializers =   
+    {  
+        new ContextCorrelationInitializer  
+        {  
+            CorrelationHandle = cchandle  
+        }  
+    }  
+};  
+```  
+  
+ 相関関係が初期化されると、以降の <xref:System.ServiceModel.Activities.Send> アクティビティでは、<xref:System.ServiceModel.Activities.CorrelationHandle> を使用して、同じサービス インスタンスでメソッドを呼び出すことができます。  
+  
+```csharp  
+Send request2 = new Send  
+{  
+    CorrelatesWith = cchandle,  
+    // Remaining activity configuration omitted.  
+};  
+```  
+  
+ これらの例では、コンテキスト相関関係が明示的に構成されています。クライアント ワークフローが <xref:System.ServiceModel.Activities.WorkflowServiceHost> でもホストされていない場合は、アクティビティが <xref:System.ServiceModel.Activities.CorrelationScope> アクティビティ内に含まれていない限り、相関関係を明示的に構成する必要があります。コンテキスト相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[NetContextExchangeCorrelation](http://msdn.microsoft.com/ja-jp/93c74a1a-b9e2-46c6-95c0-c9b0e9472caf)」を参照してください。  
+  
+ ワークフロー サービスへの呼び出しを行うクライアントがワークフローではない場合でも、ワークフロー サービスへの最初の呼び出しで返されたコンテキストを明示的に渡す限り、呼び出しを繰り返して行うことができます。サービス参照を [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ストアに追加することでプロキシが生成され、このコンテキストが既定で渡されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/context-exchange-protocol.md b/docs/framework/wcf/feature-details/context-exchange-protocol.md
new file mode 100644
index 00000000000..378e82c4a9a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/context-exchange-protocol.md
@@ -0,0 +1,78 @@
+---
+title: "コンテキスト交換プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3dfd38e0-ae52-491c-94f4-7a862b9843d4
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# コンテキスト交換プロトコル
+このセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)][!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] リリースで導入されたコンテキスト交換プロトコルについて説明します。このプロトコルを使用すると、クライアント チャネルはサービスから送られたコンテキストを受け入れ、以降はそのコンテキストを、同じクライアント チャネル インスタンス経由でそのサービスに送信されるすべての要求に適用できます。コンテキスト交換プロトコルを実装されると、2 つの機構 \(HTTP クッキーまたは SOAP ヘッダー\) のいずれか 1 つを使用し、サーバーとクライアント間でコンテキストを伝達できます。  
+  
+ コンテキスト交換プロトコルは、カスタム チャネル層に実装されます。チャネルでは <xref:System.ServiceModel.Channels.ContextMessageProperty> プロパティを使用して、アプリケーション層とコンテキストを送受信します。エンドポイント間の転送については、コンテキストの値は、チャネル層で SOAP ヘッダーとしてシリアル化されるか、HTTP 要求および応答を表すメッセージ プロパティとの間で双方向に変換されます。後者の場合、下位のチャネル層のいずれか 1 つで、HTTP 要求および応答のメッセージ プロパティをそれぞれ HTTP クッキーとの間で双方向に変換する必要があります。コンテキスト交換に使用する機構の選択は、<xref:System.ServiceModel.Channels.ContextBindingElement> の <xref:System.ServiceModel.Channels.ContextExchangeMechanism> プロパティを使用します。有効な値は、`HttpCookie` または `SoapHeader` です。  
+  
+ クライアントでは、チャネルのインスタンスは <xref:System.ServiceModel.Channels.IContextManager.Enabled%2A> チャネル プロパティの設定値に基づいて 2 つのモードで動作します。  
+  
+## モード 1: チャネル コンテキスト管理  
+ これは、<xref:System.ServiceModel.Channels.IContextManager.Enabled%2A> を `true` に設定した場合の既定のモードです。このモードでは、コンテキスト チャネルはコンテキストを管理し、その有効期間中、コンテキストをキャッシュします。コンテキストは、`GetContext` メソッドを呼び出して、`IContextManager` チャネル プロパティ経由でチャネルから取得できます。チャネルを開く前に、チャネル プロパティで `SetContext` メソッドを呼び出して、事前に特定のコンテキストで初期化できます。チャネルは一度コンテキストで初期化すると、リセットできません。  
+  
+ このモードのインバリアントの一覧を次に示します。  
+  
+-   チャネルを開いた後に `SetContext` を使用してコンテキストをリセットしようとすると、<xref:System.InvalidOperationException> がスローされます。  
+  
+-   送信メッセージで <xref:System.ServiceModel.Channels.ContextMessageProperty> を使用してコンテキストを送信しようとすると、<xref:System.InvalidOperationException> がスローされます。  
+  
+-   特定のコンテキストを持つサーバーからメッセージを受信する場合に、チャネルが既に特定のコンテキストで初期化されていると、<xref:System.ServiceModel.ProtocolException> が発生します。  
+  
+    > [!NOTE]
+    >  明示的にコンテキストが設定されていないチャネルを開いている場合に限り、サーバーから初期コンテキストを受信するのが適切です。  
+  
+-   受信メッセージの <xref:System.ServiceModel.Channels.ContextMessageProperty> は常に null です。  
+  
+## モード 2: アプリケーション コンテキスト管理  
+ これは、<xref:System.ServiceModel.Channels.IContextManager.Enabled%2A> を `false` に設定した場合のモードです。このモードでは、コンテキスト チャネルでコンテキストを管理しません。コンテキストの取得、管理、および適用は、<xref:System.ServiceModel.Channels.ContextMessageProperty> を使用してアプリケーションで行う必要があります。`GetContext` または `SetContext` を呼び出そうとすると、<xref:System.InvalidOperationException> が発生します。  
+  
+ どちらのモードを選択しても、クライアント チャネル ファクトリは、<xref:System.ServiceModel.Channels.IRequestChannel>、<xref:System.ServiceModel.Channels.IRequestSessionChannel>、および <xref:System.ServiceModel.Channels.IDuplexSessionChannel> の各メッセージ交換パターンをサポートします。  
+  
+ サービスでは、チャネルのインスタンスが、受信メッセージでクライアントから送られたコンテキストを <xref:System.ServiceModel.Channels.ContextMessageProperty> に変換します。これで、アプリケーション層、または呼び出しスタックの上位に位置する他のチャネルから、メッセージ プロパティにアクセスできるようになります。サービス チャネルを使用し、応答メッセージに <xref:System.ServiceModel.Channels.ContextMessageProperty> をアタッチすることによって、クライアントに返される新しいコンテキスト値をアプリケーション層で指定することもできます。このプロパティは、コンテキストを含む SOAP ヘッダーまたは HTTP クッキーに変換されます。どちらに変換されるかは、バイディングの構成によって決まります。サービス チャネル リスナーは、<xref:System.ServiceModel.Channels.IReplyChannel>、<xref:System.ServiceModel.Channels.IReplySessionChannel>、および <xref:System.ServiceModel.Channels.IReplySessionChannel> の各メッセージ交換パターンをサポートします。  
+  
+ コンテキスト交換プロトコルは、コンテキストの伝達に HTTP クッキーを使用しない場合にコンテキスト情報を表す新しい `wsc:Context` SOAP ヘッダーを使用します。コンテキスト ヘッダー スキーマでは、文字列キーと文字列コンテンツを持つ任意の数の子要素を使用できます。コンテキスト ヘッダーの例を次に示します。  
+  
+ `<Context xmlns="http://schemas.microsoft.com/ws/2006/05/context">`  
+  
+ `<property name="myContext">context-2</property>`  
+  
+ `</Context>`  
+  
+ `HttpCookie` モードの場合、`SetCookie` ヘッダーを使用してクッキーが設定されます。クッキーの名前は `WscContext` です。クッキーの値は、`wsc:Context` ヘッダーの Base64 エンコーディングです。この値は引用符で囲まれます。  
+  
+ WS\-Addressing ヘッダーを保護するのと同じ理由により、コンテキスト値は、転送中に変更されないように保護する必要があります。WS\-Addressing ヘッダーは、サービスで要求のディスパッチ先を確認するのに使用されます。したがって、バインディングにメッセージ保護機能がある場合、SOAP レベルかトランスポート レベルのいずれかで `wsc:Context` ヘッダーにデジタル署名するか、署名と暗号化を行う必要があります。HTTP クッキーを使用してコンテキストを伝達する場合は、トランスポート セキュリティを使用して保護する必要があります。  
+  
+ サービス エンドポイントでコンテキスト交換プロトコルのサポートを必要とする場合は、公開するポリシーにそのことを明示できます。新たに 2 つのポリシー アサーションが導入され、SOAP レベルでコンテキスト交換プロトコルをサポートしたり、HTTP クッキーのサポートを有効化したりするクライアント要件を示すことができます。このアサーションはサービスのポリシー内に生成されます。生成は次のように、<xref:System.ServiceModel.Channels.ContextBindingElement.ContextExchangeMechanism%2A> プロパティの値によって制御します。  
+  
+-   <xref:System.ServiceModel.Channels.ContextExchangeMechanism> の場合は、次のアサーションが生成されます。  
+  
+    ```  
+    <IncludeContext   
+    xmlns="http://schemas.microsoft.com/ws/2006/05/context"  
+    protectionLevel="Sign" />  
+    ```  
+  
+-   <xref:System.ServiceModel.Channels.ContextExchangeMechanism> の場合は、次のアサーションが生成されます。  
+  
+    ```  
+    <HttpUseCookie xmlns="http://schemas.xmlsoap.org/soap/http"/>  
+    ```  
+  
+## 参照  
+ [Web サービス プロトコルの相互運用性ガイド](../../../../docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/contracts.md b/docs/framework/wcf/feature-details/contracts.md
new file mode 100644
index 00000000000..f10d6245c96
--- /dev/null
+++ b/docs/framework/wcf/feature-details/contracts.md
@@ -0,0 +1,78 @@
+---
+title: "コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントラクト [WCF]"
+  - "WCF [WCF], コントラクト"
+  - "Windows Communication Foundation [WCF], コントラクト"
+ms.assetid: c8364183-4ac1-480b-804a-c5e6c59a5d7d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# コントラクト
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] コントラクトを定義および実装する方法について説明します。  サービス コントラクトでは、エンドポイントが外部と何をやりとりするかが指定されます。  具体的には、要求\/応答、一方向、双方向など、基本的なメッセージ交換パターン \(MEP\) に編成された一連のメッセージに関する記述です。  サービス コントラクトがメッセージ交換の論理的に関連したセットであるとすると、サービス操作は単一のメッセージ交換です。  たとえば、`Hello` という操作では、1 つのメッセージを受け取り、呼び出し元があいさつを通知できるようにする必要があり、メッセージを返すことができます \(マナーが悪ければ返さない場合もあり得ます\)。  
+  
+ コントラクトおよび [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のその他の中心的概念[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Communication Foundation の基本概念](../../../../docs/framework/wcf/fundamental-concepts.md)」を参照してください。  ここでは、サービス コントラクトを理解することに重点を置きます。  サービス コントラクトを使用してサービスに接続するクライアントを構築する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)」を参照してください。  クライアント チャネル、クライアント アーキテクチャ、およびその他クライアントに関する問題[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[クライアント](../../../../docs/framework/wcf/feature-details/clients.md)」を参照してください。  
+  
+## 概要  
+ ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの設計および実装に関する大まかな概念的位置付けについて説明します。  サブトピックでは、設計と実装の仕様についてより詳しく説明します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを設計および実装する前に、次の準備をしておくことをお勧めします。  
+  
+-   サービス コントラクトの概要、しくみ、および作成方法について理解する。  
+  
+-   コントラクトとは、実行時の構成またはホスト環境でサポートされていない可能性のある最小限の要件を記述するものであることを理解する。  
+  
+## サービス コントラクト  
+ サービス コントラクトとは、以下の項目に関する記述です。  
+  
+-   サービスでの操作のグループ化  
+  
+-   交換するメッセージに関する操作のシグネチャ  
+  
+-   交換するメッセージのデータ型  
+  
+-   操作の場所  
+  
+-   サービスとの正常な通信をサポートするために使用するプロトコルとシリアル化形式  
+  
+ たとえば、注文情報の種類に関する入力を受け入れ、発注 ID を含めた成功または失敗の情報を返す `CreateOrder` 操作が含まれた発注書コントラクトがあるとします。  このコントラクトには、発注 ID を受け入れ、注文ステータス情報を返す `GetOrderStatus` 操作も含まれている場合があります。  この種のサービス コントラクトの場合、以下を明示します。  
+  
+-   発注書コントラクトが `CreateOrder` 操作と `GetOrderStatus` 操作で構成されていること。  
+  
+-   これらの操作によって、入力メッセージと出力メッセージが指定されていること。  
+  
+-   これらのメッセージが伝達できるデータ。  
+  
+-   メッセージを正常に処理するために必要な通信インフラストラクチャに関する明確な記述。  たとえば、正常な通信を確立するためにセキュリティが必要かどうか、また、どのような形式のセキュリティが必要かなどの詳細を記述します。  
+  
+ このような種類の情報を他のさまざまなプラットフォーム上 \(マイクロソフト以外のプラットフォームも含む\) のアプリケーションに伝達するために、XML サービス コントラクトは、[Web Services Description Language \(WSDL\)](http://go.microsoft.com/fwlink/?LinkId=87004) や [XML Schema \(XSD\)](http://go.microsoft.com/fwlink/?LinkId=87005) などの標準 XML 形式で公開されます。  多くのプラットフォームの開発者は、このパブリック コントラクト情報を使用して、サービスと通信できるアプリケーションを作成できます。これは、開発者が仕様の言語を理解しているだけでなく、これらの言語はサービスがサポートするパブリックな形式、書式、およびプロトコルを記述することで相互運用できるように設計されているためです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がこの種の情報を処理する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)」を参照してください。  
+  
+ コントラクトはさまざまな方法で表現できます。ただし、WSDL と XSD は、利用しやすい方法でサービスを記述する優れた言語ではあるものの直接使用するのが難しいため、どのような場合でも、サービス コントラクトの実装ではなく、サービスを記述するだけです。  そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでは、マネージ属性、マネージ インターフェイス、およびマネージ クラスを使用して、サービスの構造の定義と実装の両方を行います。  
+  
+ マネージ型で定義されたコントラクトは、特に他のプラットフォーム上のクライアントやその他のサービス実装側が必要とする場合に、メタデータ \(WSDL および XSD\) として変換 \(*エクスポート*とも呼ばれます\) できます。  これにより、どのクライアント アプリケーションに対してもパブリック メタデータを使用して記述できる、簡単なプログラミング モデルが実現します。  基になる SOAP メッセージの詳細 \(トランスポートとセキュリティ関連の情報など\) は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に残しておくことができます。WCF は、サービス コントラクト型システムと XML 型システム間で必要な変換を自動的に実行します。  
+  
+ コントラクトの設計[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  コントラクトの実装[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス コントラクトの実装](../../../../docs/framework/wcf/implementing-service-contracts.md)」を参照してください。  
+  
+ さらに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、メッセージ レベルでサービス コントラクト全体を開発できる機能も備わっています。  メッセージ レベルでサービス コントラクトを開発する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md)」を参照してください。  SOAP XML 以外でサービスを開発する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[POX アプリケーションとの相互運用性](../../../../docs/framework/wcf/feature-details/interoperability-with-pox-applications.md)」を参照してください。  
+  
+### 要件の階層の理解  
+ サービス コントラクトは、操作をグループ化し、MEP、メッセージの種類、およびメッセージに格納されているデータ型を指定します。さらに、実装でコントラクトをサポートするために必要な実行時の動作のカテゴリ \(メッセージの暗号化と署名を要求するなど\) を示します。  ただし、サービス コントラクト自体は、これらの要件を満たす方法を正確に指定するわけではなく、これらの要件が必要であることを示すだけです。  暗号化の種類やメッセージに署名する方法は、準拠サービスの実装と構成によって決まります。  
+  
+ コントラクトに必要なのは、サービス コントラクトの実装と、動作を追加するための実行時の構成に関するものであるという点に注意してください。  使用するサービスを公開するために満たす必要のある要件のセットは、上記の要件のセットを基に作成されます。  コントラクトが実装の要件を作成しても、実装ではサービスの実行を可能にするために、さらに多くの構成とバインディングを必要とする場合があります。  また、ホスト アプリケーションも、サービス構成とバインディングによって追加されるすべての要件をサポートする必要があります。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス アプリケーションを設計、実装、構成、およびホストする際には、この追加要件のプロセスに注意することが重要です。  たとえば、コントラクトでセッションをサポートする必要があることが指定されている場合があります。  その場合、コントラクトの要件をサポートするようにバインディングを構成する必要があります。そうしないと、サービス実装は機能しなくなります。  また、サービスが統合 Windows 認証を必要としており、インターネット インフォメーション サービス \(IIS\) でホストされる場合、サービスが存在する Web アプリケーションでは、統合 Windows 認証を有効にし、匿名サポートを無効にしておく必要があります。  各種サービス ホスト アプリケーションの機能と影響[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)」を参照してください。  
+  
+## 参照  
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)   
+ [サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)   
+ [サービス コントラクトの実装](../../../../docs/framework/wcf/implementing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/controlling-serialization-and-deserialization-with-serializationbinder.md b/docs/framework/wcf/feature-details/controlling-serialization-and-deserialization-with-serializationbinder.md
new file mode 100644
index 00000000000..7c3794c14a9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/controlling-serialization-and-deserialization-with-serializationbinder.md
@@ -0,0 +1,30 @@
+---
+title: "SerializationBinder を使用したシリアル化および逆シリアル化の制御 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba8dcecf-acc7-467c-939d-021bbac797d4
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# SerializationBinder を使用したシリアル化および逆シリアル化の制御
+シリアル化中に、フォーマッタは、正しい型およびバージョンのオブジェクトのインスタンスを作成するために必要な情報を送信します。  通常、この情報には、オブジェクトの完全な型名および完全なアセンブリ名が含まれます。  既定では、逆シリアル化でこの情報を使用して、同一のオブジェクトのインスタンスを作成します。  場合によっては、シリアル化するクラスと逆シリアル化するクラスの制御が必要となります。これは、元のクラスが逆シリアル化を実行するコンピューター上に存在していない可能性がある場合、元のクラスがアセンブリ間で移動されている場合、または、サーバー上とクライアント上では異なるバージョンのクラスが必要である場合です。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [シリアル化バインダーの使用](../../../../docs/framework/wcf/samples/usage-of-serialization-binder.md).  
+  
+> [!WARNING]
+>  この機能は、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> または <xref:System.Runtime.Serialization.NetDataContractSerializer> を使用してのみ、使用可能です。  
+  
+## SerializationBinder の使用  
+ <xref:System.Runtime.Serialization.SerializationBinder> は、シリアル化中および逆シリアル化中に使用される実際の型を制御するために使用される抽象クラスです。  シリアル化中および逆シリアル化中に使用される型を制御するには、<xref:System.Runtime.Serialization.SerializationBinder> の派生クラスを作成し、<xref:System.Runtime.Serialization.SerializationBinder.BindToName%2A> System.String, System.String)?qualifyHint=False&autoUpgrade=True メソッドと <xref:System.Runtime.Serialization.SerializationBinder.BindToType%2A> System.String)?qualifyHint=False&autoUpgrade=True メソッドをオーバーライドします。  <xref:System.Runtime.Serialization.SerializationBinder.BindToName%2A> System.String, System.String)?qualifyHint=False&autoUpgrade=True メソッドは <xref:System.Type> を受け取り、アセンブリと型名を返します。  <xref:System.Runtime.Serialization.SerializationBinder.BindToType%2A> System.String)?qualifyHint=False&autoUpgrade=True メソッドはアセンブリと型名を受け取り、<xref:System.Type> を返します。  
+  
+## 参照  
+ [シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)   
+ [シリアル化バインダーの使用](../../../../docs/framework/wcf/samples/usage-of-serialization-binder.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/converting-a-nettcpbinding-application-to-a-peer-channel-application.md b/docs/framework/wcf/feature-details/converting-a-nettcpbinding-application-to-a-peer-channel-application.md
new file mode 100644
index 00000000000..89bccf1931c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/converting-a-nettcpbinding-application-to-a-peer-channel-application.md
@@ -0,0 +1,26 @@
+---
+title: "NetTcpBinding アプリケーションからピア チャネル アプリケーションへの変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4137292-a923-4b8f-8594-42276f2d3ce2
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# NetTcpBinding アプリケーションからピア チャネル アプリケーションへの変換
+[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] を使用するクライアント間の接続は、その接続パラメーターを記述するバインディングを使用して作成できます。  ピアツーピア接続を使用するように [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションを変換するには、クライアントを接続するときにこのテクノロジをサポートするバインディングが必要です。  ピア チャネルには、<xref:System.ServiceModel.NetPeerTcpBinding> と呼ばれるバインディングが用意されています。このバインディングは、<xref:System.ServiceModel.NetTcpBinding> と同じような方法で使用できます。  主な違いは、リゾルバー サービスの仕様とセキュリティ設定の定義です。  
+  
+ アプリケーションでリゾルバーとセキュリティの既定の設定を使用する場合、通常のクライアント\/サーバー ベースのアプリケーションは、アプリケーションの構成ファイルでバインディング名を "NetTcpBinding" から "NetPeerTcpBinding" に変更するだけで、ピア チャネルを使用するように変換できます。アプリケーションのコード ベースを変更する必要はありません。  
+  
+## 参照  
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/correlation-overview.md b/docs/framework/wcf/feature-details/correlation-overview.md
new file mode 100644
index 00000000000..e5b5f3a7035
--- /dev/null
+++ b/docs/framework/wcf/feature-details/correlation-overview.md
@@ -0,0 +1,39 @@
+---
+title: "相関関係の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: edcc0315-5d26-44d6-a36d-ea554c418e9f
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 相関関係の概要
+相関関係とは、ワークフロー サービス メッセージを互いに関連付ける、最初の要求への応答などのアプリケーションのインスタンス状態と関連付ける、または特定の注文 ID を注文処理ワークフローの永続化された状態に関連付けるためのしくみです。  ここでは、相関関係の概要について説明します。  このセクションの他のトピックでは、相関関係の各種類についての追加情報を提供します。  
+  
+## 相関関係の種類  
+ 相関関係には、プロトコル ベースとコンテンツ ベースがあります。  プロトコル ベースの相関関係では、メッセージ間のマッピングを提供するためのメッセージ配信インフラストラクチャで提供されるデータが使用されます。  プロトコル ベースの相関関係を使用して関連付けられたメッセージは、メモリ内の <xref:System.ServiceModel.Channels.RequestContext> などのオブジェクトを使用して、またはトランスポート プロトコルで提供されるトークンによって、互いに関連付けられます。  コンテンツ ベースの相関関係では、メッセージが、アプリケーションで指定されたデータを使用して関連付けられます。  コンテンツ ベースの相関関係を使用して関連付けられたメッセージは、アプリケーションが定義する顧客番号などのメッセージ内のデータによって互いに関連付けられます。  
+  
+ 相関関係に参加するアクティビティは、<xref:System.ServiceModel.Activities.CorrelationHandle> を使用してメッセージング アクティビティを互いに結び付けます。  たとえば、サービスの呼び出しに使用される <xref:System.ServiceModel.Activities.Send> と、それに続く、サービスからのコールバックの受信に使用される <xref:System.ServiceModel.Activities.Receive> は、同じ <xref:System.ServiceModel.Activities.CorrelationHandle> を共有します。  この基本的なパターンは、相関関係がコンテンツ ベースであっても、プロトコル ベースであっても使用されます。  関連付けハンドルは、各アクティビティに明示的に設定する、またはアクティビティを <xref:System.ServiceModel.Activities.CorrelationScope> アクティビティに格納することができます。  <xref:System.ServiceModel.Activities.CorrelationScope> に格納されたアクティビティには、<xref:System.ServiceModel.Activities.CorrelationScope> が管理する関連付けハンドルがあり、<xref:System.ServiceModel.Activities.CorrelationHandle> を明示的に設定する必要がありません。  <xref:System.ServiceModel.Activities.CorrelationScope> スコープでは、要求\/応答の相関関係と、もう 1 つの種類の相関関係のための <xref:System.ServiceModel.Activities.CorrelationHandle> 管理が提供されます。  <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされるワークフロー サービスには、<xref:System.ServiceModel.Activities.CorrelationScope> アクティビティと同じ既定の関連付け管理があります。  多くのシナリオで、この既定の関連付け管理は、<xref:System.ServiceModel.Activities.CorrelationScope> 内のメッセージング アクティビティ、またはワークフロー サービスが <xref:System.ServiceModel.Activities.CorrelationHandle> セットを要求しないことを意味します。ただし、2 つの <xref:System.ServiceModel.Activities.Receive> アクティビティが並行している、または 2 つの <xref:System.ServiceModel.Activities.Send> アクティビティに 2 つの <xref:System.ServiceModel.Activities.Receive> アクティビティが続くなど、複数のメッセージング アクティビティが並行または重複している場合を除きます。  既定の相関関係の詳細情報は、このセクションの中のそれぞれの種類の相関関係を説明するトピックに記述されています。  メッセージング アクティビティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)」および「[方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)」を参照してください。  
+  
+## プロトコル ベースの相関関係  
+ プロトコル ベースの相関関係では、メッセージを相互に関連付け、該当するインスタンスと関連付けるために、トランスポート機構が使用されます。  システムで提供される一部のプロトコル相関関係には、要求\/応答の相関関係とコンテキスト ベースの相関関係が含まれます。  要求\/応答の相関関係を使用して、メッセージング アクティビティの 1 つのペアが関連付けられ、<xref:System.ServiceModel.Activities.ReceiveReply> と <xref:System.ServiceModel.Activities.Send> のペアや、<xref:System.ServiceModel.Activities.SendReply> と <xref:System.ServiceModel.Activities.Receive> のペアなどの双方向の操作が形成されます。  また、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ワークフロー デザイナーには、このパターンに迅速に実装できるアクティビティ テンプレートのセットが用意されています。  コンテキスト ベースの相関関係は、「[.NET コンテキスト交換プロトコルの仕様](http://go.microsoft.com/fwlink/?LinkID=166059)」で説明されているコンテキスト交換メカニズムに基づきます。  コンテキスト ベースの相関関係を使用するには、<xref:System.ServiceModel.BasicHttpContextBinding>、<xref:System.ServiceModel.WSHttpContextBinding>、または <xref:System.ServiceModel.NetTcpContextBinding> などのコンテキスト ベースのバインディングがエンドポイントで使用される必要があります。  
+  
+ プロトコルの相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[コンテキスト交換](../../../../docs/framework/wcf/feature-details/context-exchange-correlation.md)」、「[永続的な二重](../../../../docs/framework/wcf/feature-details/durable-duplex-correlation.md)」、および「[要求\/応答](../../../../docs/framework/wcf/feature-details/request-reply-correlation.md)」を参照してください。  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ワークフロー デザイナーのアクティビティ テンプレートの使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)」を参照してください。  サンプル コードについては、「[永続的な二重 &#91;WF サンプル&#93;](../../../../docs/framework/windows-workflow-foundation/samples/durable-duplex.md)」および「[NetContextExchangeCorrelation](http://msdn.microsoft.com/ja-jp/93c74a1a-b9e2-46c6-95c0-c9b0e9472caf)」のサンプルを参照してください。  
+  
+## コンテンツ ベースの相関関係  
+ コンテンツ ベースの相関関係では、メッセージ内の一部の情報を特定のインスタンスとの関連付けに使用します。  プロトコル ベースの相関関係と異なり、コンテンツ ベースの相関関係では、各関連メッセージ内のこの情報がある場所に、アプリケーションの作成者が明示的に記述されている必要があります。  コンテンツ ベースの相関関係を使用するアクティビティでは、<xref:System.ServiceModel.MessageQuerySet> を使用して、このメッセージ データを指定します。  コンテンツ ベースの相関関係は、<xref:System.ServiceModel.BasicHttpContextBinding> などのコンテキスト バインディングの 1 つを使用しないサービスと通信する場合に便利です。  コンテンツ ベースの相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[コンテンツ ベース](../../../../docs/framework/wcf/feature-details/content-based-correlation.md)」を参照してください。  サンプル コードについては、「[コンテンツ ベースの相関関係](../../../../docs/framework/windows-workflow-foundation/samples/content-based-correlation.md)」および「[相関電卓](../../../../docs/framework/windows-workflow-foundation/samples/correlated-calculator.md)」のサンプルを参照してください。  
+  
+## 参照  
+ [コンテンツ ベースの相関関係](../../../../docs/framework/windows-workflow-foundation/samples/content-based-correlation.md)   
+ [相関電卓](../../../../docs/framework/windows-workflow-foundation/samples/correlated-calculator.md)   
+ [永続的な二重 &#91;WF サンプル&#93;](../../../../docs/framework/windows-workflow-foundation/samples/durable-duplex.md)   
+ [NetContextExchangeCorrelation](http://msdn.microsoft.com/ja-jp/93c74a1a-b9e2-46c6-95c0-c9b0e9472caf)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/correlation.md b/docs/framework/wcf/feature-details/correlation.md
new file mode 100644
index 00000000000..0189fd6351b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/correlation.md
@@ -0,0 +1,47 @@
+---
+title: "関連付け | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 60151f6c-19b7-47af-9cdc-76c2ac95f301
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 関連付け
+ワークフロー サービス アプリケーションが他のサービスと通信するときには、やり取りされるメッセージが、適切なワークフロー インスタンスにディスパッチされることが重要です。相関関係によって、これを実現する機構が提供されます。このセクションの各トピックでは、相関関係の概要を示し、さまざまなワークフロー サービス シナリオで相関関係を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [相関関係の概要](../../../../docs/framework/wcf/feature-details/correlation-overview.md)  
+ [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] で使用可能な相関関係の種類の概要を示します。  
+  
+ [コンテキスト交換](../../../../docs/framework/wcf/feature-details/context-exchange-correlation.md)  
+ コンテキスト交換の相関関係について説明します。  
+  
+ [永続的な二重](../../../../docs/framework/wcf/feature-details/durable-duplex-correlation.md)  
+ 永続的な二重の相関関係について説明します。  
+  
+ [コンテンツ ベース](../../../../docs/framework/wcf/feature-details/content-based-correlation.md)  
+ コンテンツ ベースの相関関係について説明します。  
+  
+ [要求\/応答](../../../../docs/framework/wcf/feature-details/request-reply-correlation.md)  
+ 要求\/応答の相関関係について説明します。  
+  
+ [相関関係のトラブルシューティング](../../../../docs/framework/wcf/feature-details/troubleshooting-correlation.md)  
+ 相関関係のトラブルシューティング方法を説明します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Activities.CorrelationHandle>   
+ <xref:System.ServiceModel.Activities.Send>   
+ <xref:System.ServiceModel.Activities.Receive>   
+ <xref:System.ServiceModel.CorrelationQuery>   
+ [コンテンツ ベースの相関関係](../../../../docs/framework/windows-workflow-foundation/samples/content-based-correlation.md)   
+ [相関電卓](../../../../docs/framework/windows-workflow-foundation/samples/correlated-calculator.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/create-a-service-arbitrary-data-using-wcf.md b/docs/framework/wcf/feature-details/create-a-service-arbitrary-data-using-wcf.md
new file mode 100644
index 00000000000..d780feb63ee
--- /dev/null
+++ b/docs/framework/wcf/feature-details/create-a-service-arbitrary-data-using-wcf.md
@@ -0,0 +1,212 @@
+---
+title: "方法 : WCF REST プログラミング モデルを使用して任意のデータを受け入れるサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e566c15a-b600-4e4a-be3a-4af43e767dae
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : WCF REST プログラミング モデルを使用して任意のデータを受け入れるサービスを作成する
+開発者は、データがサービス操作から返される流れを完全に制御する必要が生じることがあります。 たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではサポートされない形式のデータを、サービス操作から返す必要がある場合です。 このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST プログラミング モデルを使用して任意のデータを受信するサービスの作成方法について説明します。  
+  
+### <a name="to-implement-the-service-contract"></a>サービス コントラクトを実装するには  
+  
+1.  サービス コントラクトを定義します。 任意のデータを受信する操作は、型のパラメーターを持つ必要があります<xref:System.IO.Stream>します。 さらに、このパラメーターは要求の本文に渡される唯一のパラメーターでなければなりません。 この例で説明されている操作では、filename パラメーターも使用できます。 このパラメーターは要求の URL に格納されて渡されます。 指定して、URL 内でパラメーターを渡すことを指定する、 <xref:System.UriTemplate>で、 <xref:System.ServiceModel.Web.WebInvokeAttribute>します。 この場合、このメソッドを呼び出すのに使用する URI は “UploadFile/Some-Filename” で終わります。 URI テンプレートの "{filename}" 部分は、操作に使用する filename パラメーターが操作の呼び出しに使用する URI に格納されて渡されるように指定します。  
+  
+    ```  
+     [ServiceContract]  
+    public interface IReceiveData  
+    {  
+        [WebInvoke(UriTemplate = "UploadFile/{fileName}")]  
+        void UploadFile(string fileName, Stream fileContents);  
+    }  
+    ```  
+  
+2.  サービス コントラクトを実装します。 コントラクトには、ストリーム内の任意のデータのファイルを受け取る `UploadFile` というメソッドが&1; つだけあります。 操作では、ストリームを読み取り、読み取ったバイト数をカウントしてから、ファイル名と読み取ったバイト数を表示します。  
+  
+    ```  
+    public class RawDataService : IReceiveData  
+    {  
+        public void UploadFile(string fileName, Stream fileContents)  
+        {  
+            byte[] buffer = new byte[10000];  
+            int bytesRead, totalBytesRead = 0;  
+            do  
+            {  
+                bytesRead = fileContents.Read(buffer, 0, buffer.Length);  
+                totalBytesRead += bytesRead;  
+            } while (bytesRead > 0);  
+            Console.WriteLine("Service: Received file {0} with {1} bytes", fileName, totalBytesRead);  
+        }  
+    }  
+    ```  
+  
+### <a name="to-host-the-service"></a>サービスをホストするには  
+  
+1.  コンソール アプリケーションを作成し、サービスをホストします。  
+  
+    ```  
+    class Program  
+    {  
+       static void Main(string[] args)  
+       {  
+       }  
+    }  
+  
+    ```  
+  
+2.  変数を作成し、`Main` メソッド内のサービスに使用するベース アドレスを保持します。  
+  
+    ```  
+    string baseAddress = "http://" + Environment.MachineName + ":8000/Service";  
+    ```  
+  
+3.  作成、 <xref:System.ServiceModel.ServiceHost>サービス クラスとベース アドレスを指定するサービスのインスタンス。  
+  
+    ```  
+    ServiceHost host = new ServiceHost(typeof(RawDataService), new Uri(baseAddress));  
+    ```  
+  
+4.  コントラクトを指定するエンドポイントを追加<xref:System.ServiceModel.WebHttpBinding>、および<xref:System.ServiceModel.Description.WebHttpBehavior>します。  
+  
+    ```  
+    host.AddServiceEndpoint(typeof(IReceiveData), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+    ```  
+  
+5.  サービス ホストを開きます。 サービスは要求を受け取る準備ができました。  
+  
+    ```  
+    host.Open();  
+    Console.WriteLine("Host opened");  
+    ```  
+  
+### <a name="to-call-the-service-programmatically"></a>プログラムによってサービスを呼び出すには  
+  
+1.  作成、 <xref:System.Net.HttpWebRequest>サービスを呼び出すために使用する URI を使用します。 このコードでは、ベース アドレスは `“/UploadFile/Text”` と組み合わされています。 URI の `“UploadFile”` 部分で呼び出す操作を指定します。 URI の `“Test.txt”` 部分で `UploadFile` 操作に渡す filename パラメーターを指定します。 これらの項目の両方にマップ、 <xref:System.UriTemplate>操作コントラクトに適用します。  
+  
+    ```  
+    HttpWebRequest req = (HttpWebRequest)HttpWebRequest.Create(baseAddress + "/UploadFile/Test.txt");  
+  
+    ```  
+  
+2.  設定、<xref:System.Net.HttpWebRequest.Method%2A>のプロパティ、 <xref:System.Net.HttpWebRequest>に`POST`と<xref:System.Net.HttpWebRequest.ContentType%2A>プロパティを`“text/plain”`します。 この設定により、サービスはコードがデータを送信し、そのデータがプレーン テキストであることを認識します。  
+  
+    ```  
+    req.Method = "POST";  
+    req.ContentType = "text/plain";  
+    ```  
+  
+3.  呼び出す<xref:System.Net.HttpWebRequest.GetRequestStream%2A>要求ストリームを取得するには、送信、要求ストリームにそのデータを書き込みおよびストリームを閉じるにデータを作成します。  
+  
+    ```  
+    Stream reqStream = req.GetRequestStream();  
+    byte[] fileToSend = new byte[12345];  
+    for (int i = 0; i < fileToSend.Length; i++)  
+       {  
+           fileToSend[i] = (byte)('a' + (i % 26));  
+       }  
+    reqStream.Write(fileToSend, 0, fileToSend.Length);  
+    reqStream.Close();  
+    ```  
+  
+4.  呼び出して、サービスから応答を取得<xref:System.Net.HttpWebRequest.GetResponse%2A>し、応答データをコンソールに表示します。  
+  
+    ```  
+    HttpWebResponse resp = (HttpWebResponse)req.GetResponse();  
+    Console.WriteLine("Client: Receive Response HTTP/{0} {1} {2}", resp.ProtocolVersion, (int)resp.StatusCode, resp.StatusDescription);  
+  
+    ```  
+  
+5.  サービス ホストを閉じます。  
+  
+    ```  
+    host.Close();  
+    ```  
+  
+## <a name="example"></a>例  
+ この例で使用されているコードの完全な一覧を次に示します。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.ServiceModel;  
+using System.ServiceModel.Web;  
+using System.ServiceModel.Description;  
+using System.IO;  
+using System.Net;  
+  
+namespace ReceiveRawData  
+{  
+    [ServiceContract]  
+    public interface IReceiveData  
+    {  
+        [WebInvoke(UriTemplate = "UploadFile/{fileName}")]  
+        void UploadFile(string fileName, Stream fileContents);  
+    }  
+    public class RawDataService : IReceiveData  
+    {  
+        public void UploadFile(string fileName, Stream fileContents)  
+        {  
+            byte[] buffer = new byte[10000];  
+            int bytesRead, totalBytesRead = 0;  
+            do  
+            {  
+                bytesRead = fileContents.Read(buffer, 0, buffer.Length);  
+                totalBytesRead += bytesRead;  
+            } while (bytesRead > 0);  
+            Console.WriteLine("Service: Received file {0} with {1} bytes", fileName, totalBytesRead);  
+        }  
+    }  
+  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            string baseAddress = "http://" + Environment.MachineName + ":8000/Service";  
+            ServiceHost host = new ServiceHost(typeof(RawDataService), new Uri(baseAddress));  
+            host.AddServiceEndpoint(typeof(IReceiveData), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+            host.Open();  
+            Console.WriteLine("Host opened");  
+  
+            HttpWebRequest req = (HttpWebRequest)HttpWebRequest.Create(baseAddress + "/UploadFile/Test.txt");  
+            req.Method = "POST";  
+            req.ContentType = "text/plain";  
+            Stream reqStream = req.GetRequestStream();  
+            byte[] fileToSend = new byte[12345];  
+            for (int i = 0; i < fileToSend.Length; i++)  
+            {  
+                fileToSend[i] = (byte)('a' + (i % 26));  
+            }  
+            reqStream.Write(fileToSend, 0, fileToSend.Length);  
+            reqStream.Close();  
+            HttpWebResponse resp = (HttpWebResponse)req.GetResponse();  
+            Console.WriteLine("Client: Receive Response HTTP/{0} {1} {2}", resp.ProtocolVersion, (int)resp.StatusCode, resp.StatusDescription);  
+            host.Close();  
+  
+        }  
+    }  
+}  
+  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+  
+-   コードのコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll を参照します。  
+  
+## <a name="see-also"></a>関連項目  
+ [UriTemplate と UriTemplateTable](../../../../docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md)   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/create-an-ajax-wcf-asp-net-client.md b/docs/framework/wcf/feature-details/create-an-ajax-wcf-asp-net-client.md
new file mode 100644
index 00000000000..1ab1b28184f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/create-an-ajax-wcf-asp-net-client.md
@@ -0,0 +1,181 @@
+---
+title: "方法 : AJAX 対応 WCF サービスとこのサービスにアクセスする ASP.NET クライアントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95012df8-2a66-420d-944a-8afab261013e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : AJAX 対応 WCF サービスとこのサービスにアクセスする ASP.NET クライアントを作成する
+ここでは、Visual Studio 2008 を使用して AJAX 対応の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスと、このサービスにアクセスする ASP.NET クライアントを作成する方法について説明します。 これらを作成するための手順を示した後、「使用例」のセクションにサービスおよびクライアント用のコードを示します。  
+  
+### <a name="to-create-the-aspnet-client-application"></a>ASP.NET クライアント アプリケーションを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を開きます。  
+  
+2.  **ファイル**メニューの **新規**、し**プロジェクト**、し**Web**、し、 **ASP.NET Web アプリケーション**します。  
+  
+3.  プロジェクトに名前を`SandwichServices` をクリック**OK**します。  
+  
+### <a name="to-create-the-wcf-ajax-enabled-service"></a>WCF AJAX 対応サービスを作成するには  
+  
+1.  右クリックし、`SandwichServices`プロジェクトで、**ソリューション エクスプ ローラー**ウィンドウを選択**追加**、し**新しい項目の**、し**AJAX 対応 WCF サービス**します。  
+  
+2.  サービスの名前を`CostService`で、**名**ボックスし、をクリックして**追加**します。  
+  
+3.  CostService.svc.cs ファイルを開きます。  
+  
+4.  指定の`Namespace`の<xref:System.ServiceModel.ServiceContractAttribute>として`SandwichService`:  
+  
+    ```  
+    namespace SandwichServices  
+    {  
+      [ServiceContract(Namespace = "SandwichServices")]  
+      [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]  
+       public class CostService  
+       {  
+         …  
+       }  
+     }  
+    ```  
+  
+5.  サービスに操作を実装します。 追加、 <xref:System.ServiceModel.OperationContractAttribute>に各コントラクトの一部であることを示すために操作します。 次の例では、指定したサンドイッチの数に対して価格を返すメソッドを実装します。  
+  
+    ```  
+    public class CostService  
+    {  
+        [OperationContract]  
+        public double CostOfSandwiches(int quantity)  
+        {  
+            return 1.25 * quantity;  
+        }  
+  
+    // Add more operations here and mark them with [OperationContract]  
+    }  
+    ```  
+  
+### <a name="to-configure-the-client-to-access-the-service"></a>サービスにアクセスするようにクライアントを構成するには  
+  
+1.  Default.aspx ページを開き、選択、**デザイン**表示します。  
+  
+2.  **ビュー**メニューの **ツールボックス**します。  
+  
+3.  展開、 **AJAX Extensions**ノードやドラッグ アンド ドロップ、 **ScriptManager** Default.aspx ページにします。  
+  
+4.  右クリックし、 **ScriptManager**選択**プロパティ**します。  
+  
+5.  展開、**サービス**内のコレクション、**プロパティ**ウィンドウを開きます、 **ServiceReference コレクション エディター**ウィンドウです。  
+  
+6.  をクリックして**追加**、指定`CostService.svc`として、**パス** をクリックし、参照**OK**します。  
+  
+7.  展開、 **HTML**内のノード、**ツールボックス**しドラッグ アンド ドロップ、**入力 (ボタン)** Default.aspx ページにします。  
+  
+8.  右クリックし、**ボタン**選択**プロパティ**します。  
+  
+9. 変更、**値**フィールドを`Price for 3 Sandwiches`します。  
+  
+10. ダブルクリックして、**ボタン**JavaScript コードにアクセスします。  
+  
+11. 次の JavaScript コードを渡す、 `script`> 要素。  
+  
+    ```  
+    function Button1_onclick() {  
+    var service = new SandwichServices.CostService();  
+    service.CostOfSandwiches(3, onSuccess, null, null);  
+    }  
+  
+    function onSuccess(result){  
+    alert(result);  
+    }  
+    ```  
+  
+### <a name="to-access-the-service-from-the-client"></a>クライアントからサービスにアクセスするには  
+  
+1.  Ctrl キーを押しながら F5 キーを押して、サービスと Web クライアントを起動します。 クリックして、 **Price for 3 Sandwiches** 「3.75」の予想される出力を生成する ボタンをクリックします。  
+  
+## <a name="example"></a>例  
+ この例には、WCFService.svc.cs ファイルに含まれるサービスのコードと Default.aspx ファイルに含まれるクライアントのコードが含まれています。  
+  
+```  
+//The service code contained in the CostService.svc.cs file.  
+  
+using System;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Activation;  
+using System.ServiceModel.Web;  
+  
+namespace SandwichServices  
+{  
+    [ServiceContract(Namespace="SandwichServices")]  
+    [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]  
+    public class CostService  
+    {  
+        // Add [WebGet] attribute to use HTTP GET  
+        [OperationContract]  
+        public double CostOfSandwiches(int quantity)  
+        {  
+            return 1.25 * quantity;  
+        }  
+  
+        // Add more operations here and mark them with [OperationContract]  
+    }  
+}  
+//The code for hosting the service is contained in the CostService.svc file.  
+  
+<%@ ServiceHost Language="C#" Debug="true" Service="SandwichServices.CostService" CodeBehind="CostService.svc.cs" %>  
+  
+//The client code contained in the Default.aspx file.  
+  
+<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="SandwichServices._Default" %>  
+  
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">  
+  
+<html >  
+<head runat="server">  
+    <title>Untitled Page</title>  
+<script language="javascript" type="text/javascript">  
+// <!CDATA[  
+  
+function Button1_onclick() {  
+var service = new SandwichServices.CostService();  
+service.CostOfSandwiches(3, onSuccess, null, null);  
+}  
+  
+function onSuccess(result){  
+alert(result);  
+}  
+  
+// ]]>  
+</script>  
+</head>  
+<body>  
+    <form id="form1" runat="server">  
+    <div>  
+  
+    </div>  
+    <asp:ScriptManager ID="ScriptManager1" runat="server">  
+        <services>  
+            <asp:servicereference Path="CostService.svc" />  
+        </services>  
+    </asp:ScriptManager>  
+    </form>  
+    <p>  
+        <input id="Button1" type="button" value="Price for 3 Sandwiches" onclick="return Button1_onclick()" /></p>  
+</body>  
+</html>  
+  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/creating-a-custom-header-that-is-signed-and-or-encrypted.md b/docs/framework/wcf/feature-details/creating-a-custom-header-that-is-signed-and-or-encrypted.md
new file mode 100644
index 00000000000..86f4f7ed5e2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/creating-a-custom-header-that-is-signed-and-or-encrypted.md
@@ -0,0 +1,70 @@
+---
+title: "署名または暗号化、あるいはその両方が行われたカスタム ヘッダーの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8668b37-c79f-4714-9de5-afcb88b9ff02
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 署名または暗号化、あるいはその両方が行われたカスタム ヘッダーの作成
+WCF クライアントを使用して WCF 以外のサービスを呼び出す場合、状況によっては、カスタム SOAP ヘッダーが必要です。  WCF には正規化のバグがあり、署名および暗号化されたカスタム ヘッダーは、WCF 以外のサービスで使用できません。  この問題は、既定の XML 名前空間に対する正規化の誤りが原因で発生します。  この問題が生じるのは、署名または暗号化、あるいはその両方が行われたカスタム ヘッダーを持つ、WCF 以外のサービスを呼び出す場合のみです。  サービスは、受信したメッセージに署名または暗号化、あるいはその両方が行われたカスタム ヘッダーが含まれている場合、署名を検証できません。  この回避策では正規化のバグを回避し、WCF 以外のサービスとの相互運用が可能になりますが、WCF サービスとの相互運用性は妨げられません。  
+  
+## カスタム ヘッダーの定義  
+ カスタム ヘッダーは、メッセージ コントラクトを定義し、ヘッダーとして送信するメンバーを <xref:System.ServiceModel.MessageHeaderAttribute> 属性を使用してマークすることで定義されます。  正規化のバグを回避するには、XML シリアライザーが既定の名前空間の宣言ではなくプレフィックスによってカスタム ヘッダーの名前空間を宣言する必要があります。  次のコードは、メッセージ ヘッダーとして使用されるデータ型を正しい名前空間宣言で定義する方法を示します。  
+  
+```  
+[System.CodeDom.Compiler.GeneratedCodeAttribute("svcutil", "3.0.4506.648")]  
+[System.SerializableAttribute()]  
+[System.Diagnostics.DebuggerStepThroughAttribute()]  
+[System.ComponentModel.DesignerCategoryAttribute("code")]  
+[System.Xml.Serialization.XmlTypeAttribute(AnonymousType=true, Namespace="http://www.example.org/getMessage/")]  
+public partial class msgHeaderElement  
+{  
+   // Define the XML namespace and force it to use an ‘h’ prefix  
+    [System.Xml.Serialization.XmlNamespaceDeclarations]  
+    public System.Xml.Serialization.XmlSerializerNamespaces _xsns = new System.Xml.Serialization.XmlSerializerNamespaces(new System.Xml.XmlQualifiedName[] { new System.Xml.XmlQualifiedName("h", "http://www.example.org/getMessage/") });  
+  
+    private string msgHeaderInputField;  
+  [System.Xml.Serialization.XmlElementAttribute(Form=System.Xml.Schema.XmlSchemaForm.Unqualified, Order=0)]  
+    public string msgHeaderInput  
+    {  
+        get  
+        {  
+            return this.msgHeaderInputField;  
+        }  
+        set  
+        {  
+            this.msgHeaderInputField = value;  
+        }  
+    }  
+}  
+```  
+  
+ このコードでは、XML シリアライザーによってシリアル化される `msgHeaderElement` という新しい型を宣言しています。  この型のインスタンスがシリアル化されると、名前空間が "h" プレフィックスで定義されるため、正規化のバグが回避されます。  この後、次の例に示すように、メッセージ コントラクトによって `msgHeaderElement` のインスタンスを定義し、<xref:System.ServiceModel.MessageHeaderAttribute> 属性でそのインスタンスをマークします。  
+  
+```  
+[MessageContract]  
+public  class MyMessageContract  
+{  
+   // other message contents...  
+   [MessageHeader(ProductionLevel=ProtectionLevel.EncryptAndSign)]  
+   public msgHeaderElement;  
+   // other message contents...  
+}  
+  
+```  
+  
+## 参照  
+ [既定のメッセージ コントラクト](../../../../docs/framework/wcf/samples/default-message-contract.md)   
+ [メッセージ コントラクト](../../../../docs/framework/wcf/samples/message-contracts.md)   
+ [メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md b/docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md
new file mode 100644
index 00000000000..c7b6fce23db
--- /dev/null
+++ b/docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md
@@ -0,0 +1,217 @@
+---
+title: "長時間のワークフロー サービスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4c39bd04-5b8a-4562-a343-2c63c2821345
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 長時間のワークフロー サービスの作成
+ここでは、実行時間の長いワークフロー サービスを作成する方法について説明します。  実行時間の長いワークフロー サービスは、長期間にわたって実行できます。  ワークフローでは、いくつかの追加情報を待つ間アイドル状態になることがあります。  アイドル状態になると、ワークフローは SQL データベースに永続化され、メモリから削除されます。  追加情報が使用可能になると、ワークフロー インスタンスがメモリに読み込み直されて、実行を継続します。  このシナリオでは、非常に簡略化された注文システムを実装します。  クライアントは、最初のメッセージをワークフロー サービスに送信して注文を開始します。  ワークフロー サービスは、注文 ID をクライアントに返します。  この時点で、ワークフロー サービスは、クライアントからの別のメッセージを待機しており、アイドル状態に入って、SQL Server データベースに永続化されます。  クライアントが次のメッセージを送信して項目を注文すると、ワークフロー サービスはメモリに読み込み直されて、注文の処理を終了します。  次のコード例では、項目が注文に追加されたことを示す文字列を返します。  このコード例は、テクノロジの実際の適用を意図するものではなく、実行時間の長いワークフロー サービスを示す簡単な例です。このトピックでは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] のプロジェクトおよびソリューションの作成方法を理解していることを前提としています。  
+  
+## 必須コンポーネント  
+ このチュートリアルを使用するには、次のソフトウェアがインストールされている必要があります。  
+  
+1.  Microsoft SQL Server 2008  
+  
+2.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)]  
+  
+3.  Microsoft [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)]  
+  
+4.  ユーザーは WCF および [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] に精通しており、プロジェクトおよびソリューションの作成方法を理解している必要があります。  
+  
+### SQL データベースを設定するには  
+  
+1.  ワークフロー サービス インスタンスが永続化されるようにするには、Microsoft SQL Server をインストールして、永続化ワークフロー インスタンスを保存するようにデータベースを設定する必要があります。  **\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[Microsoft SQL Server 2008\]**、**\[Microsoft SQL Management Studio\]** の順にクリックして、Microsoft SQL Management Studio を実行します。  
+  
+2.  **\[接続\]** ボタンをクリックして、SQL Server インスタンスにログオンします。  
+  
+3.  ツリー ビューで **\[データベース\]** を右クリックして **\[新しいデータベース\]** をクリックし、`SQLPersistenceStore` という名前の新しいデータベースを作成します。  
+  
+4.  SQLPersistenceStore データベースの C:\\Windows\\Microsoft.NET\\Framework\\v4.0\\SQL\\en ディレクトリにある SqlWorkflowInstanceStoreSchema.sql スクリプト ファイルを実行して、必要なデータベース スキーマを設定します。  
+  
+5.  SQLPersistenceStore データベースの C:\\Windows\\Microsoft.NET\\Framework\\v4.0\\SQL\\en ディレクトリにある SqlWorkflowInstanceStoreLogic.sql スクリプト ファイルを実行して、必要なデータベース ロジックを設定します。  
+  
+### Web ホスト ワークフロー サービスを作成するには  
+  
+1.  空の [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ソリューションを作成し、`OrderProcessing` という名前を付けます。  
+  
+2.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] という新しい `OrderService` ワークフロー サービス アプリケーション プロジェクトをソリューションに追加します。  
+  
+3.  プロジェクトのプロパティのダイアログで、**\[Web\]** タブをクリックします。  
+  
+    1.  **\[開始動作\]** の **\[ページを指定する\]** をクリックし、`Service1.xamlx` を指定します。  
+  
+         ![ワークフロー サービス プロジェクトの Web プロパティ](../../../../docs/framework/wcf/feature-details/media/startaction.png "StartAction")  
+  
+    2.  **\[サーバー\]** の **\[ローカル IIS Web サーバーを使用する\]** を選択します。  
+  
+         ![ローカル Web サーバーの設定](../../../../docs/framework/wcf/feature-details/media/uselocalwebserver.png "UseLocalWebServer")  
+  
+        > [!WARNING]
+        >  この設定を行うには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を管理者モードで実行する必要があります。  
+  
+         次の 2 つの手順で、ワークフロー サービス プロジェクトが IIS でホストされるように設定します。  
+  
+4.  `Service1.xamlx` が開いていない場合は開き、既存の **ReceiveRequest** アクティビティと **SendResponse** アクティビティを削除します。  
+  
+5.  **\[シーケンシャル サービス\]** アクティビティを選択して **\[変数\]** リンクをクリックし、次の図に示されている変数を追加します。  こうするといくつかの変数が追加され、後でワークフロー サービスで使用されます。  
+  
+    > [!NOTE]
+    >  CorrelationHandle が \[変数の型\] ボックスにない場合、ボックスから **\[型の参照\]** を選択します。  **\[型名\]** ボックスに「CorrelationHandle」と入力し、リスト ボックスから CorrelationHandle を選択して **\[OK\]** をクリックします。  
+  
+     ![変数の追加](../../../../docs/framework/wcf/feature-details/media/addvariables.gif "AddVariables")  
+  
+6.  **ReceiveAndSendReply** アクティビティ テンプレートをドラッグして、**\[シーケンシャル サービス\]** アクティビティにドロップします。  このアクティビティのセットは、クライアントからメッセージを受信して、返信を送信します。  
+  
+    1.  **Receive** アクティビティを選択し、次の図で強調表示されているプロパティを設定します。  
+  
+         ![Receive アクティビティのプロパティの設定](../../../../docs/framework/wcf/feature-details/media/setreceiveproperties.png "SetReceiveProperties")  
+  
+         DisplayName プロパティは、デザイナーに表示される Receive アクティビティの名前を設定します。  ServiceContractName プロパティと OperationName プロパティは、Receive アクティビティで実装されるサービス コントラクトおよび操作の名前を指定します。  ワークフロー サービスでのコントラクトの使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー内でのコントラクトの使用](../../../../docs/framework/wcf/feature-details/using-contracts-in-workflow.md)」を参照してください。  
+  
+    2.  **ReceiveStartOrder** アクティビティの **\[定義\]** リンクをクリックし、次の図に示されているプロパティを設定します。  **\[パラメーター\]** オプション ボタンが選択され、`p_customerName` という名前のパラメーターが `customerName` 変数にバインドされていることに注目してください。  これにより、**Receive** アクティビティがいくつかのデータを受け取り、そのデータをローカル変数にバインドするように設定されます。  
+  
+         ![Receive アクティビティが受信するデータの設定](../../../../docs/framework/wcf/feature-details/media/setreceivecontent.png "SetReceiveContent")  
+  
+    3.  **SendReplyToReceive** アクティビティを選択し、次の図で強調表示されているプロパティを設定します。  
+  
+         ![SendReply アクティビティのプロパティの設定](../../../../docs/framework/wcf/feature-details/media/setreplyproperties.png "SetReplyProperties")  
+  
+    4.  **SendReplyToStartOrder** アクティビティの **\[定義\]** リンクをクリックし、次の図に示されているプロパティを設定します。  **\[パラメーター\]** オプション ボタンが選択され、`p_orderId` という名前のパラメーターが `orderId` 変数にバインドされていることに注目してください。  この設定により、SendReplyToStartOrder アクティビティが型文字列の値を呼び出し元に返すように指定されます。  
+  
+         ![SendReply アクティビティのコンテンツ データの構成](../../../../docs/framework/wcf/feature-details/media/setreplycontent.png "SetReplyContent")  
+  
+        > [!NOTE]
+    5.  Assign アクティビティをドラッグして **Receive** アクティビティと **SendReply** アクティビティの間にドロップし、次の図に示されているようにプロパティを設定します。  
+  
+         ![Assign アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/addassign.png "AddAssign")  
+  
+         これにより、新しい注文 ID が作成され、orderId 変数に値が配置されます。  
+  
+    6.  **ReplyToStartOrder** アクティビティを選択します。  プロパティ ウィンドウで、**CorrelationInitializers** の省略記号ボタンをクリックします。  **\[初期化子の追加\]** リンクを選択し、\[初期化子\] ボックスに「`orderIdHandle`」と入力して、\[関連付けの種類\] に \[クエリ関連付け初期化子\] を選択し、\[XPATH クエリ\] ボックスの p\_orderId を選択します。  これらの設定を次の図に示します。  **\[OK\]** をクリックします。  これにより、クライアントとワークフロー サービスのこのインスタンス間の相関関係が初期化されます。  この注文 ID を含むメッセージが受信されると、ワークフロー サービスのこのインスタンスにルーティングされます。  
+  
+         ![関連付け初期化子の追加](../../../../docs/framework/wcf/feature-details/media/addcorrelationinitializers.png "AddCorrelationInitializers")  
+  
+7.  別の **ReceiveAndSendReply** アクティビティをドラッグしてワークフローの最後 \(最初の **Receive** アクティビティと **SendReply** アクティビティを含む **\[シーケンス\]** の外側\) にドロップします。  これで、クライアントで送信された 2 つ目のメッセージを受信し、それに応答します。  
+  
+    1.  新しく追加した **Receive** アクティビティと **SendReply** アクティビティを含む **\[シーケンス\]** を選択し、**\[変数\]** ボタンをクリックします。  次の図で強調表示されている変数を追加します。  
+  
+         ![新しい変数の追加](../../../../docs/framework/wcf/feature-details/media/addorderitemidvariable.png "AddOrderItemIdVariable")  
+  
+    2.  **Receive** アクティビティを選択し、次の図に示されているプロパティを設定します。  
+  
+         ![Receive アクティビティのプロパティの設定](../../../../docs/framework/wcf/feature-details/media/setreceiveproperties2.png "SetReceiveProperties2")  
+  
+    3.  **ReceiveAddItem** アクティビティの **\[定義\]** リンクをクリックし、次の図に示されているパラメーターを追加します。これにより、Receive アクティビティが 2 つのパラメーター、注文 ID、および注文されている項目の ID を受け取るように設定されます。  
+  
+         ![2 つ目の Receive のパラメーター指定](../../../../docs/framework/wcf/feature-details/media/addreceive2parameters.png "AddReceive2Parameters")  
+  
+    4.  **CorrelateOn** の省略記号ボタンをクリックし、「`orderIdHandle`」を入力します。  **\[XPath クエリ\]** のドロップダウン矢印をクリックし、`p_orderId` を選択します。  これにより、2 つ目の Receive アクティビティに相関関係が設定されます。  相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[関連付け](../../../../docs/framework/wcf/feature-details/correlation.md)」を参照してください。  
+  
+         ![CorrelatesOn プロパティの設定](../../../../docs/framework/wcf/feature-details/media/correlateson.png "CorrelatesOn")  
+  
+    5.  **If** アクティビティをドラッグして **ReceiveAddItem** アクティビティの直後にドロップします。  このアクティビティは、if ステートメントと同様に動作します。  
+  
+        1.  **Condition** プロパティを `itemId==”Zune HD” (itemId=”Zune HD” for Visual Basic)` に設定します。  
+  
+        2.  **Assign** アクティビティを **Then** セクションと **Else** セクションにそれぞれドラッグ アンド ドロップして、次の図に示されているように **Assign** アクティビティのプロパティを設定します。  
+  
+             ![サービス呼び出しの結果の割り当て](../../../../docs/framework/wcf/feature-details/media/resultassign.png "ResultAssign")  
+  
+             条件が `true` である場合、**Then** セクションが実行されます。  条件が `false` である場合、**Else** セクションが実行されます。  
+  
+        3.  **SendReplyToReceive** アクティビティを選択し、次の図で強調表示されている **DisplayName** プロパティを設定します。  
+  
+             ![SendReply アクティビティのプロパティの設定](../../../../docs/framework/wcf/feature-details/media/setreply2properties.png "SetReply2Properties")  
+  
+        4.  **SetReplyToAddItem** アクティビティの **\[定義\]** リンクをクリックし、次の図に示されているように設定します。  これにより、**SendReplyToAddItem** アクティビティが `orderResult` 変数に値を返すように設定されます。  
+  
+             ![SendReply アクティビティのデータ バインディングの設定](../../../../docs/framework/wcf/feature-details/media/replytoadditemcontent.gif "ReplyToAddItemContent")  
+  
+8.  web.config ファイルを開いて、次の要素を \<behavior\> セクションに追加し、ワークフロー永続化を有効にします。  
+  
+    ```xml  
+    <sqlWorkflowInstanceStore connectionString="Data Source=your-machine\SQLExpress;Initial Catalog=SQLPersistenceStore;Integrated Security=True;Asynchronous Processing=True" instanceEncodingOption="None" instanceCompletionAction="DeleteAll" instanceLockedExceptionAction="BasicRetry" hostLockRenewalPeriod="00:00:30" runnableInstancesDetectionPeriod="00:00:02" />  
+              <workflowIdle timeToUnload="0"/>  
+  
+    ```  
+  
+    > [!WARNING]
+    >  前のコード スニペットでホストと SQL Server インスタンス名を置換するようにします。  
+  
+9. ソリューションをビルドします。  
+  
+### クライアント アプリケーションを作成してワークフロー サービスを呼び出すには  
+  
+1.  `OrderClient` という新しいコンソール アプリケーション プロジェクトをソリューションに追加します。  
+  
+2.  次のアセンブリへの参照を `OrderClient` プロジェクトに追加します。  
+  
+    1.  System.ServiceModel.dll  
+  
+    2.  System.ServiceModel.Activities.dll  
+  
+3.  サービス参照をワークフロー サービスに追加し、`OrderService` を名前空間として指定します。  
+  
+4.  クライアント プロジェクトの `Main()` メソッド内に次のコードを追加します。  
+  
+    ```  
+    static void Main(string[] args)  
+    {  
+       // Send initial message to start the workflow service  
+       Console.WriteLine("Sending start message");  
+       StartOrderClient startProxy = new StartOrderClient();  
+       string orderId = startProxy.StartOrder("Kim Abercrombie");  
+  
+       // The workflow service is now waiting for the second message to be sent  
+       Console.WriteLine("Workflow service is idle...");  
+       Console.WriteLine("Press [ENTER] to send an add item message to reactivate the workflow service...");  
+       Console.ReadLine();  
+  
+       // Send the second message  
+       Console.WriteLine("Sending add item message");  
+       AddItemClient addProxy = new AddItemClient();  
+       AddItem item = new AddItem();  
+       item.p_itemId = "Zune HD";  
+       item.p_orderId = orderId;  
+  
+       string orderResult = addProxy.AddItem(item);  
+       Console.WriteLine("Service returned: " + orderResult);  
+    }  
+  
+    ```  
+  
+5.  ソリューションをビルドし、`OrderClient` アプリケーションを実行します。  クライアントに次のテキストが表示されます。  
+  
+    ```Output  
+  
+                  開始メッセージを送信します  
+    ワークフロー サービスがアイドル状態です...  Enter キーを押して項目の追加メッセージを送信し、ワークフロー サービスを再びアクティブにします。    
+    ```  
+  
+6.  ワークフロー サービスが永続化されていることを確認するには、**\[スタート\]** メニューで **\[すべてのプログラム\]**、**\[Microsoft SQL Server 2008\]**、**\[SQL Server Management Studio\]** の順にクリックして、SQL Server Management Studio を起動します。  
+  
+    1.  左ペインで、**\[データベース\]**、**\[SQLPersistenceStore\]**、**\[ビュー\]** の順に展開し、**System.Activities.DurableInstancing.Instances** を右クリックして **\[上位 1000 行を選択\]** をクリックします。  **\[結果\]** ペインで、少なくとも 1 つのインスタンスがリストされていることを確認します。  実行中に例外が発生した場合は、前の実行のその他のインスタンスがある可能性があります。  既存の行を削除するには、**System.Activities.DurableInstancing.Instances** を右クリックして **\[上位 200 行を編集\]** をクリックし、**\[実行\]** ボタンを押し、\[結果\] ペインのすべての行を選択して **\[削除\]** をクリックします。  データベースに表示されているインスタンスが、アプリケーションで作成されたインスタンスであることを確認するには、クライアントを実行する前に、Instances ビューが空であることを確認します。  クライアントが実行されると、クエリ \(\[上位 1000 行を選択\]\) を再実行し、新しいインスタンスが追加されていることを確認します。  
+  
+7.  Enter キーを押して、項目の追加メッセージをワークフロー サービスに送信します。  クライアントに次のテキストが表示されます。  
+  
+    ```Output  
+  
+                  項目の追加メッセージを送信します。  
+    サービスは注文に追加された項目を返しました。  
+    続行するには、いずれかのキーを押します.  .  .    
+    ```  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/creating-multicasting-applications-using-the-udp-transport.md b/docs/framework/wcf/feature-details/creating-multicasting-applications-using-the-udp-transport.md
new file mode 100644
index 00000000000..aa8b4e42d0c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/creating-multicasting-applications-using-the-udp-transport.md
@@ -0,0 +1,130 @@
+---
+title: "UDP トランスポートを使用するマルチキャスト アプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7485154a-6e85-4a67-a9d4-9008e741d4df
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# UDP トランスポートを使用するマルチキャスト アプリケーションの作成
+マルチキャスト アプリケーションは、ポイント ツー ポイント接続を確立することなく多数の受信者に小さいメッセージを同時に送信します。このようなアプリケーションの重点は、信頼性よりも速度です。つまり、特定のメッセージが実際に受信されるということよりも、迅速にデータを送信することの方が重要です。WCF は、<xref:System.ServiceModel.UdpBinding> を使用して、書き込みマルチキャスト アプリケーションをサポートします。このトランスポートは、サービスが複数のクライアントに小さいメッセージを同時に送信する必要がある場合に便利です。株価表示器のアプリケーションは、このようなサービスの例です。  
+  
+## マルチキャスト アプリケーションの実装  
+ マルチキャストのアプリケーションを実装するには、サービス コントラクトを定義し、マルチキャストのメッセージに応答する必要がある各ソフトウェア コンポーネントについては、サービス コントラクトを実装します。たとえば、株価表示器のアプリケーションは、サービス コントラクトを定義する場合があります:  
+  
+```  
+// Shared contracts between the client and the service  
+    [ServiceContract]  
+    interface IStockTicker  
+    {  
+        [OperationContract(IsOneWay = true)]  
+        void SendStockInfo(StockInfo[] stockInfo);  
+    }  
+  
+    [DataContract]  
+    class StockInfo  
+    {  
+        [DataMember]  
+        public string Symbol;  
+  
+        [DataMember]  
+        public float Price;  
+  
+        public StockInfo(string symbol, float price)  
+        {  
+            this.Symbol = symbol;  
+            this.Price = price;  
+        }  
+    }  
+  
+```  
+  
+ マルチキャストのメッセージを受信する各アプリケーションはこのインターフェイスを公開するサービスをホストする必要があります。たとえば、マルチキャストのメッセージを受信する方法を示すコード サンプルを次に示します:  
+  
+```  
+// Service Address  
+            string serviceAddress = "soap.udp://224.0.0.1:40000";  
+            // Binding  
+            UdpBinding myBinding = new UdpBinding();  
+            // Host  
+            ServiceHost host = new ServiceHost(typeof  
+                (StockTickerService), new Uri(serviceAddress));  
+            // Add service endpoint  
+            host.AddServiceEndpoint(typeof(IStockTicker), myBinding, string.Empty);  
+            // Openup the service host  
+            host.Open();  
+  
+            Console.WriteLine("Start receiving stock information");  
+            Console.ReadLine();  
+  
+```  
+  
+ アプリケーションはすべてのサービスがリッスンする UDP アドレスを指定します。新しい <xref:System.ServiceModel.ServiceHost> が作成され、サービス エンドポイントは <xref:System.ServiceModel.UdpBinding> を使用して公開されます。<xref:System.ServiceModel.ServiceHost> が開き、受信メッセージのリッスンを開始します。  
+  
+ このような場合、実際にマルチキャストのメッセージを送信するのは、クライアントです。正しい UDP アドレスでリッスンする各サービスはマルチキャストのメッセージを受信します。マルチキャストのメッセージを送信するクライアントの例を次に示します:  
+  
+```  
+// Multicast Address  
+            string serviceAddress = "soap.udp://224.0.0.1:40000";  
+  
+            // Binding  
+            UdpBinding myBinding = new UdpBinding();  
+  
+            // Channel factory  
+            ChannelFactory<IStockTicker> factory  
+                = new ChannelFactory<IStockTicker>(myBinding,  
+                            new EndpointAddress(serviceAddress));  
+  
+            // Call service  
+            IStockTicker proxy = factory.CreateChannel();  
+  
+            while (true)  
+            {  
+                // This will continue to mulicast stock information   
+                proxy.SendStockInfo(GetStockInfo());  
+                Console.WriteLine(String.Format("sent stock info at {0}", DateTime.Now));  
+                // Wait for one second before sending another update  
+                System.Threading.Thread.Sleep(new TimeSpan(0, 0, 1));  
+            }  
+  
+```  
+  
+ このコードは、株式の情報を生成し、サービス コントラクト IStockTicker を使用してマルチキャストのメッセージを送信することによって、正しい UDP アドレスでリッスンするサービスを呼び出します。  
+  
+### UDP および信頼できるメッセージング  
+ UDP バインディングでは、UDP プロトコルに軽量という性質があるために信頼できるメッセージングをサポートしていません。メッセージがリモート エンドポイントによって受信されることを確認する必要がある場合は、HTTP や TCP などの信頼できるメッセージングをサポートするトランスポートを使用します。信頼できるメッセージングの詳細については、http:\/\/go.microsoft.com\/fwlink\/?LinkId\=231830 を参照してください。  
+  
+### 双方向マルチキャストのメッセージング  
+ マルチキャストのメッセージは通常、一方向ですが、UdpBinding は要求\/応答メッセージ交換をサポートします。UDP トランスポートを使用して送信されたメッセージには送信者と宛先のアドレスがいずれも含まれます。送信者のアドレスを使う場合は、送信中に悪意により変更されることがあるため、注意が必要です。アドレスは、次のコードを使用してチェックすることができます:  
+  
+```  
+if (address.AddressFamily == AddressFamily.InterNetwork)  
+          {  
+              // IPv4  
+              byte[] addressBytes = address.GetAddressBytes();  
+              return ((addressBytes[0] & 0xE0) == 0xE0);  
+          }  
+          else  
+          {  
+              // IPv6   
+              return address.IsIPv6Multicast;  
+          }  
+  
+```  
+  
+ このコードは、送信者のアドレスの先頭バイトをチェックして、アドレスがマルチキャスト アドレスであることを示す 0xE0 が含まれているかどうかを調べます。  
+  
+### セキュリティの考慮事項  
+ マルチキャストのメッセージをリッスンする場合、マルチキャストのアドレスでリッスンしていることを通知するルーターに ICMP パケットが送信されます。アクセス許可を持つローカル サブネット上に存在するすべてのユーザーが、これらの型のパケットをリッスンし、リッスンしているマルチキャストのアドレスとポートを特定できます。  
+  
+ セキュリティ上の目的に送信者の IP アドレスを使用しないでください。この情報は偽装され、アプリケーションが間違ったコンピューターに応答を送信する場合があります。この脅威を軽減する方法には、メッセージ レベルのセキュリティを有効にすることがあります。ネットワーク レベルでは、IPsec \(インターネット プロトコル セキュリティ\) やNAP \(ネットワーク アクセス保護\) も使用できます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/creating-wcf-ajax-services-without-aspnet.md b/docs/framework/wcf/feature-details/creating-wcf-ajax-services-without-aspnet.md
new file mode 100644
index 00000000000..b59c42bec2c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/creating-wcf-ajax-services-without-aspnet.md
@@ -0,0 +1,118 @@
+---
+title: "ASP.NET を使用せずに WCF AJAX サービスを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba4a7d1b-e277-4978-9f62-37684e6dc934
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ASP.NET を使用せずに WCF AJAX サービスを作成する方法
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] AJAX サービスには、JavaScript 対応の Web ページからアクセスできます。ASP.NET AJAX は必要ありません。  ここでは、このような [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成する方法について説明します。  
+  
+ ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する手順については、「[ASP.NET AJAX 用の WCF サービスの作成](../../../../docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] AJAX サービスを作成する手順は、次の 3 つに分けられます。  
+  
+-   ブラウザーからアクセスできる AJAX エンドポイントの作成  
+  
+-   AJAX 互換サービス コントラクトの作成  
+  
+-   WCF AJAX サービスへのアクセス  
+  
+## AJAX エンドポイントの作成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで AJAX のサポートを有効にする最も基本的な方法は、次の例に示すように、サービスに関連付けられた .svc ファイルの <xref:System.ServiceModel.Activation.WebServiceHostFactory> を使用することです。  
+  
+```  
+<%ServiceHost   
+    language=c#  
+    Debug="true"  
+    Service="Microsoft.Ajax.Samples.CityService"  
+    Factory=System.ServiceModel.Activation.WebServiceHostFactory  
+%>  
+```  
+  
+ 構成を使用して AJAX エンドポイントを追加することもできます。  次のコード スニペットに示すように、サービス エンドポイントで <xref:System.ServiceModel.WebHttpBinding> を使用し、<xref:System.ServiceModel.Description.WebHttpBehavior> を使用してこのエンドポイントを構成します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="AjaxBehavior">  
+          <webHttp/>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="Microsoft.Ajax.Samples.CityService">  
+        <endpoint   
+          address="ajaxEndpoint"  
+          behaviorConfiguration="AjaxBehavior"  
+          binding="webHttpBinding"  
+          contract="Microsoft.Ajax.Samples.ICityService" />  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ 実施例については、「[JSON および XML 形式の AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md)」を参照してください。  
+  
+## AJAX 互換サービス コントラクトの作成  
+ 既定では、AJAX エンドポイントを介して公開されるサービス コントラクトは、XML 形式でデータを返します。  また、次の例に示すように、既定では、エンドポイント アドレスの後に操作名を追加した URL に対する HTTP POST 要求によって、サービス操作にアクセスできます。  
+  
+```  
+[OperationContract]  
+string[] GetCities(string firstLetters);  
+```  
+  
+ この操作には、`http://serviceaddress/endpointaddress/GetCities` に対して HTTP POST を使用することによってアクセスでき、操作から XML メッセージが返されます。  
+  
+ Web プログラミング モデルを活用することで、これらの基本的な部分をカスタマイズできます。  たとえば、<xref:System.ServiceModel.Web.WebGetAttribute> 属性または <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性を使用して、操作が応答する HTTP 動詞を制御したり、これらの属性の `UriTemplate` プロパティを使用して、カスタム URI を指定したりできます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)」のトピックを参照してください。  
+  
+ AJAX サービスでは、JSON データ形式がよく使用されます。  XML ではなく JSON を返す操作を作成するには、<xref:System.ServiceModel.Web.WebGetAttribute.ResponseFormat%2A> \(または <xref:System.ServiceModel.Web.WebInvokeAttribute.ResponseFormat%2A>\) プロパティを <xref:System.ServiceModel.Web.WebMessageFormat> に設定します。  「[スタンドアロン JSON のシリアル化](../../../../docs/framework/wcf/feature-details/stand-alone-json-serialization.md)」には、組み込みの .NET 型やデータ コントラクト型を JSON にマッピングする方法が示されています。  
+  
+ JSON の要求と応答は、通常 1 つの項目のみで構成されます。  前述の `GetCities` 操作の場合、要求は次のようなステートメントになります。  
+  
+```  
+“na”  
+```  
+  
+ この要求に対する応答は、次のようなステートメントになります。  
+  
+```  
+[“Nairobi”, “Naples”, “Nashville”]  
+```  
+  
+ 操作で追加のパラメーターを受け取る場合は、両方のパラメーターを 1 つの JSON オブジェクトにラップするために、要求スタイルをラップする必要があります。  このスタイルの JSON メッセージの一例を次に示します。  
+  
+```  
+{“firstLetters”: “na”, “maxNumber”: 2}  
+```  
+  
+ 次のコントラクトがこのメッセージを受け入れます。  
+  
+```  
+[WebInvoke(BodyStyle=WebMessageBodyStyle.WrappedRequest, ResponseFormat=WebMessageFormat.Json)]  
+[OperationContract]  
+string[] GetCities(string firstLetters, int maxNumber);  
+```  
+  
+## AJAX サービスへのアクセス  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] AJAX エンドポイントでは、常に JSON と XML の両方の要求を受け入れます。  
+  
+ コンテンツ タイプが "application\/json" である HTTP POST 要求は JSON として処理され、コンテンツ タイプが XML を示している \("text\/xml" など\) HTTP POST 要求は XML として処理されます。  
+  
+ HTTP GET 要求では、URL 自体にすべての要求パラメーターが含まれています。  
+  
+ エンドポイントに対して HTTP 要求を作成する方法は、ユーザーが自由に決定できます。  また、要求の本文を構成する JSON の作成についても、ユーザーが完全に制御できます。  JavaScript から要求を作成する方法の例については、「[JSON および XML 形式の AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md b/docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md
new file mode 100644
index 00000000000..443164f2bfd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md
@@ -0,0 +1,72 @@
+---
+title: "ASP.NET AJAX 用の WCF サービスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04c0402c-e617-4ba5-aedf-d17692234776
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# ASP.NET AJAX 用の WCF サービスの作成
+Microsoft ASP.NET AJAX により、応答性に優れ、使い慣れたユーザー インターフェイス要素を使用して、充実したユーザー エクスペリエンスを提供する Web ページを簡単に作成できます。ASP.NET AJAX には、ブラウザーに依存しない ECMAScript \(JavaScript\) テクノロジとダイナミック HTML \(DHTML\) テクノロジを組み込んだクライアント スクリプト ライブラリが用意されており、これらのライブラリが ASP.NET 2.0 サーバー ベース開発プラットフォームと統合されます。ASP.NET AJAX を使用することで、Web アプリケーションのユーザー エクスペリエンスと効率を向上させることができます。  
+  
+ ASP.NET AJAX は、クライアント スクリプト ライブラリとサーバー コンポーネントを統合した強固な開発フレームワークです。ASP.NET ページからサービスにアクセスする場合、サービス URL をページ上の ASP.NET スクリプト マネージャーに追加すると、標準の JavaScript 関数の呼び出しとまったく同じに見える JavaScript コードを使い、サービス操作を呼び出すことができます。AJAX フレームワーク内での Web サービスの使用については、「[ASP.NET AJAX について](http://go.microsoft.com/fwlink/?LinkId=186475)」を参照してください。  
+  
+ 適切な ASP.NET AJAX エンドポイントを追加すると、ほとんどの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを、ASP.NET AJAX 互換のサービスとして公開できます。  
+  
+ Visual Studio を使用する場合は、AJAX 対応 WCF サービス用のビルド済みテンプレートを使用できます。このテンプレートは、ASP.NET Web サイトまたは Web アプリケーションでの作業中に **\[新しい項目の追加\]** ダイアログ ボックスで選択できます。  
+  
+ Visual Studio テンプレートを使用しない場合、ASP.NET AJAX エンドポイントを作成するには次の 2 つの方法があります。  
+  
+-   構成を使用せずに、動的ホスト アクティブ化を使用してエンドポイントを作成する。これは、WCF 構成システムの操作に慣れていない場合の最も簡単な方法です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md).  
+  
+-   構成を使用して、AJAX 対応のエンドポイントを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに追加する。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md).  
+  
+ 「[WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)」で説明されている Web プログラミング モデルは、ASP.NET AJAX サービスと共に使うことができます。具体的には、次のように使用します。  
+  
+-   <xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性を使用して、HTTP GET 動詞と HTTP POST 動詞のいずれかを選択できます。正しく使用すれば、アプリケーションのパフォーマンスを大幅に向上させることができます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : ASP.NET AJAX エンドポイントのために HTTP POST または HTTP GET を選択する](../../../../docs/framework/wcf/feature-details/http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md).  
+  
+-   <xref:System.ServiceModel.Web.WebGetAttribute.ResponseFormat%2A> および <xref:System.ServiceModel.Web.WebInvokeAttribute.ResponseFormat%2A> プロパティを使用して、サービスが返すデータを、既定の JSON \(JavaScript Object Notation\) ではなく XML データにすることができます。これを ASP.NET AJAX フレームワークで行うと、JavaScript クライアントは XML DOM オブジェクトを受け取ります。  
+  
+    > [!WARNING]
+    >  この動作を機能させるには、コンテンツ タイプを text\/xml に設定する必要があります。設定しない場合、JavaScript クライアントは XML DOM オブジェクトではなく XML を含む文字列を受け取ります。  
+  
+     コンテンツ タイプが適切に設定された XML データを返す操作の例を次に示します。  
+  
+    ```  
+    [OperationContract, WebGet(ResponseFormat=WebMessageFormat.Xml)]  
+    public XElement GetData()  
+    {  
+    XElement x;  
+    //Get some data here...  
+  
+    WebOperationContext.Current.OutgoingResponse.ContentType = "text/xml";      
+    return x;  
+    }  
+  
+    ```  
+  
+-   ASP.NET AJAX との互換性が必要な場合、<xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性の他の属性は変更できません。ASP.NET AJAX 呼び出し規約に違反しない限り、Web プログラミング モデルのその他の機能を使用できます。  
+  
+ より高度なシナリオでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での AJAX サポートについて、他にいくつかの詳細な事項を理解する必要があります。  
+  
+-   JavaScript を使用して AJAX ページ クライアントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス間でデータを転送する方法と、.NET Framework の型を JavaScript の型に割り当てる方法の詳細については、「[JSON などのデータ転送形式のサポート](../../../../docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md)」を参照してください。  
+  
+-   たとえば、URL ベースの認証や ASP.NET セッション情報へのアクセスなどの ASP.NET 機能を活用するには、構成で ASP.NET 互換モードを有効にします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の AJAX エンドポイントは、ASP.NET AJAX フレームワークなしで使用できます。これを行うには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での AJAX サポートのサポート アーキテクチャに関する知識が必要です。このアーキテクチャについては、「[WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)」を参照してください。この方法を実行するコード例については、「[JSON および XML 形式の AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md)」を参照してください。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md)   
+ [方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)   
+ [方法 : ASP.NET AJAX エンドポイントのために HTTP POST または HTTP GET を選択する](../../../../docs/framework/wcf/feature-details/http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/custom-filters.md b/docs/framework/wcf/feature-details/custom-filters.md
new file mode 100644
index 00000000000..7745491bb46
--- /dev/null
+++ b/docs/framework/wcf/feature-details/custom-filters.md
@@ -0,0 +1,93 @@
+---
+title: "カスタム フィルター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97cf247d-be0a-4057-bba9-3be5c45029d5
+caps.latest.revision: 5
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# カスタム フィルター
+カスタム フィルターを使用すると、システムが提供するメッセージ フィルターを使用して実現できない一致ロジックを定義できます。たとえば、特定のメッセージ要素をハッシュし、その値を検証してフィルターが true または false のどちらを返すかを決定するカスタム フィルターを作成できます。  
+  
+## 実装  
+ カスタム フィルターは、<xref:System.ServiceModel.Dispatcher.MessageFilter> 抽象基本クラスの実装です。カスタム フィルターを実装する場合は、コンストラクターが必要に応じて、文字列パラメーターを 1 つだけ受け取ることができます。このパラメーターには、MessageFilter コンストラクターに渡される構成情報が含まれ、フィルターが照合を実行するために実行時に必要とする値や構成を指示します。これは、評価対象のメッセージ内でフィルターが検索する必要がある値を提供する場合などに使用できます。文字列パラメーターを受け取るカスタムのメッセージ フィルターの基本の実装例を次に示します。  
+  
+```csharp  
+public class MyMessageFilter: MessageFilter  
+{  
+    string filterData;  
+    public MyMessageFilter(string filterData)  
+    {  
+        if(string.IsNullOrEmpty(filterData)  
+            throw new ArgumentNullException("filterData");  
+        this.filterData=filterData;  
+    }  
+    public override bool Match(System.ServiceModel.Channels.Message message)  
+    {  
+        ...  
+        return retValue;  
+    }  
+    public override bool Match(System.ServiceModel.Channels.MessageBuffer buffer)  
+    {  
+        ...  
+        return retValue;  
+    }  
+}  
+```  
+  
+> [!NOTE]
+>  実際の実装では、Match メソッドには、メッセージ フィルターが **true** と **false** のどちらを返すかを決めるためにメッセージを検証するロジックが設定されます。  
+  
+### パフォーマンス  
+ カスタム フィルターを実装する場合は、フィルターがメッセージの評価を完了するのに要する最大時間を考慮する必要があります。メッセージは、一致が見つかるまでに複数のフィルターに対して評価される場合があるので、すべてのフィルターを評価する前にクライアント要求がタイムアウトしないようにすることが重要です。したがって、カスタム フィルターのコードは、メッセージがフィルター条件に一致するかどうかを調べるために、メッセージのコンテンツまたは属性を評価するのに必要なコードだけにする必要があります。  
+  
+ 一般に、カスタム フィルターを実装する場合は、次のことを避ける必要があります。  
+  
+-   IO。たとえば、ディスクやデータベースへのデータの保存です。  
+  
+-   不要な処理。たとえば、ドキュメントの複数のレコードのループ処理です。  
+  
+-   ブロック操作。たとえば、共有リソースに対するロックの取得を必要とする呼び出しや、データベースに対する検索の実行です。  
+  
+ 実稼働環境でカスタム フィルターを使用する前に、パフォーマンス テストを実行して、フィルターがメッセージを評価するのに要する平均時間を調べる必要があります。フィルター テーブルで使用される他のフィルターの平均処理時間と合わせることで、クライアント アプリケーションで指定する必要がある最大タイムアウト値を正確に計算できます。  
+  
+## 使用法  
+ カスタム フィルターをルーティング サービスと使用するには、種類が "Custom" の新しいフィルター エントリ、メッセージ フィルターの完全修飾型名、およびアセンブリの名前を指定して、フィルター テーブルにカスタム フィルターを追加する必要があります。その他の MessageFilter と同様に、カスタム フィルターのコンストラクターに渡される文字列 filterData を指定できます。  
+  
+ カスタム フィルターをルーティング サービスと使用する例を次に示します。  
+  
+```xml  
+<!--ROUTING SECTION -->  
+<routing>  
+  <filters>  
+    <filter name="CustomFilter1" filterType="Custom"   
+            customType="CustomAssembly.MyMessageFilter,   
+            CustomAssembly" filterData="custom data" />  
+  </filters>  
+  <filterTables>  
+    <table name="routingTable1">  
+      <filters>  
+        <add filterName="CustomFilter1" endpointName="CalculatorService" />  
+      </filters>  
+    </table>  
+  </filterTables>  
+</routing>  
+```  
+  
+```csharp  
+RoutingConfiguration rc = new RoutingConfiguration();  
+List<ServiceEndpoint> endpointList = new List<ServiceEndpoint>();  
+endpointList.Add(client);  
+rc.FilterTable.Add(new MyMessageFilter("CustomData"), endpointList);  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-equivalence.md b/docs/framework/wcf/feature-details/data-contract-equivalence.md
new file mode 100644
index 00000000000..f8f476d624f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-equivalence.md
@@ -0,0 +1,75 @@
+---
+title: "データ コントラクトの等価性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], 等価性"
+ms.assetid: f06f3c7e-c235-4ec1-b200-68142edf1ed1
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# データ コントラクトの等価性
+クライアントがサービスに特定の型のデータを正常に送信するために、またはサービスがクライアントにデータを正常に送信するために、送信する型が受信側に存在する必要があるとは限りません。  両方の型のデータ コントラクトが同等であるということが唯一の要件です  \([データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md) で説明されているように、厳密な同等が必要ない場合もあります\)。  
+  
+ データ コントラクトを同等にするには、そのデータ コントラクトに同じ名前空間と名前を使用する必要があります。  また、一方のデータ コントラクトの各データ メンバーには、他方のデータ コントラクトに同等のデータ メンバーがある必要があります。  
+  
+ データ メンバーを同等にするには、そのデータ メンバーに同じ名前を使用する必要があります。  さらに、データ メンバーは同じ型のデータを表す必要があります。つまり、データ コントラクトが同等である必要があります。  
+  
+> [!NOTE]
+>  データ コントラクト名と名前空間、およびデータ メンバー名は、大文字と小文字を区別します。  
+  
+ データ コントラクト名と名前空間、およびデータ メンバー名の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」を参照してください。  
+  
+ 2 つの型が両側 \(送信者と受信者\) に存在し、そのデータ コントラクトが同等でない場合 \(たとえば、異なるデータ メンバーを含んでいる場合\)、そのデータ コントラクトに同じ名前と名前空間を使用しないでください。  同じ名前と名前空間を使用すると、例外がスローされる可能性があります。  
+  
+ 次の型のデータ コントラクトは同等です。  
+  
+ [!code-csharp[C_DataContractNames#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#5)]
+ [!code-vb[C_DataContractNames#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#5)]  
+  
+## データ メンバーの順序とデータ コントラクトの等価性  
+ <xref:System.Runtime.Serialization.DataMemberAttribute> クラスの <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> プロパティの使用は、データ コントラクトの等価性に影響を与えることがあります。  データ コントラクトを同等にするには、データ メンバーが同じ順序で現れる必要があります。  既定の順序はアルファベット順です。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ メンバーの順序](../../../../docs/framework/wcf/feature-details/data-member-order.md).  
+  
+ たとえば、次のコードでは、同等なデータ コントラクトが生成されます。  
+  
+ [!code-csharp[C_DataContractNames#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#6)]
+ [!code-vb[C_DataContractNames#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#6)]  
+  
+ 次のコードでは、同等なデータ コントラクトは生成されません。  
+  
+ [!code-csharp[C_DataContractNames#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#7)]
+ [!code-vb[C_DataContractNames#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#7)]  
+  
+## 継承、インターフェイス、およびデータ コントラクトの等価性  
+ 等価性を判断するとき、別のデータ コントラクトから継承したデータ コントラクトは、基本型のすべてのデータ メンバーを含んでいる 1 つのデータ コントラクトとして扱われます。  データ メンバーの順序が一致する必要があり、基本型のメンバーは派生型のメンバーより前に現れる必要があります。  さらに、次のコード例のように、2 つのデータ メンバーの順序の値が同じ場合、そのデータ メンバーの順序はアルファベット順になります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ メンバーの順序](../../../../docs/framework/wcf/feature-details/data-member-order.md).  
+  
+ 次の例では、型 `Employee` のデータ コントラクトは型 `Worker` のデータ コントラクトと同等です。  
+  
+ [!code-csharp[C_DataContractNames#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#8)]
+ [!code-vb[C_DataContractNames#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#8)]  
+  
+ クライアントとサービスの間でパラメーターを渡し、値を返すとき、受信エンドポイントが派生クラスからのデータ コントラクトを予期している場合、基本クラスからのデータ コントラクトを送信できません。  これは、オブジェクト指向プログラミングの原則に基づいています。  前の例では、`Employee` が予期される場合、型 `Person` のオブジェクトを送信できません。  
+  
+ 基本クラスからのデータ コントラクトが予期されるときに派生クラスからのデータ コントラクトを送信することは可能ですが、受信エンドポイントが <xref:System.Runtime.Serialization.KnownTypeAttribute> を使用して派生型を認識している場合に限ります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md).  上記の例では、`Person` が予期されるときに、受信者のコードが既知の型のリストに `Employee` を追加するために <xref:System.Runtime.Serialization.KnownTypeAttribute> を使用している場合のみ、型 Employee のオブジェクトを送信できます。  
+  
+ アプリケーション間でパラメーターを渡し、値を返すとき、予期される型がインターフェイスの場合、その型は、型が <xref:System.Object> の予期される型と同等です。  すべての型は最終的に <xref:System.Object> から派生するので、すべてのデータ コントラクトは最終的に、<xref:System.Object> のデータ コントラクトから派生します。  したがって、インターフェイスが予期されるとき、すべてのデータ コントラクト型を渡すことができます。  インターフェイスを正常に操作するには追加の手順が必要です。詳細については、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ [データ メンバーの順序](../../../../docs/framework/wcf/feature-details/data-member-order.md)   
+ [既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-known-types.md b/docs/framework/wcf/feature-details/data-contract-known-types.md
new file mode 100644
index 00000000000..8667bd96c0e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-known-types.md
@@ -0,0 +1,185 @@
+---
+title: "既知のデータ コントラクト型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], 既知の型"
+  - "KnownTypeAttribute [WCF]"
+  - "KnownTypes [WCF]"
+ms.assetid: 1a0baea1-27b7-470d-9136-5bbad86c4337
+caps.latest.revision: 42
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 42
+---
+# 既知のデータ コントラクト型
+<xref:System.Runtime.Serialization.KnownTypeAttribute> クラスを使用すると、逆シリアル化において考慮する必要のある型を事前に指定できます。 実施例については、「[既知の型](../../../../docs/framework/wcf/samples/known-types.md)」の例を参照してください。  
+  
+ 通常は、クライアントとサービス間でパラメーターを渡したり、値を返したりするときに、転送するデータのデータ コントラクトのすべてが両方のエンドポイントで共有されます。 ただし、次の場合はこれが該当しません。  
+  
+-   送信データ コントラクトが、予想データ コントラクトから派生する場合。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)」の継承に関するセクションを参照してください。 この場合、送信されるデータには、受信エンドポイントで予想しているデータ コントラクトが含まれません。  
+  
+-   クラス、構造体、または列挙とは対照的に、送信される情報の宣言型がインターフェイスである場合。 したがって、インターフェイスを実装するどの型が実際に送信されるかを事前に知ることができないため、受信エンドポイントでは送信されるデータのデータ コントラクトを事前に確認することができません。  
+  
+-   送信される情報の宣言型が <xref:System.Object> である場合。 すべての型が <xref:System.Object> から継承され、どの型が実際に送信されるかを事前に知ることができないため、受信エンドポイントでは送信されるデータのデータ コントラクトを事前に確認することができません。 これは最初の項目についての特殊なケースです。すべてのデータ コントラクトは既定で、<xref:System.Object> に対して生成された空のデータ コントラクトから派生します。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型を含む一部の型に、前述した 3 つのカテゴリの 1 つに分類されるメンバーが含まれる場合。 たとえば、<xref:System.Collections.Hashtable> は <xref:System.Object> を使用して、ハッシュ テーブルに実際のオブジェクトを保存します。 これらの型をシリアル化する場合、受信側ではこれらのメンバーのデータ コントラクトを事前に確認することができません。  
+  
+## KnownTypeAttribute クラス  
+ データが受信エンドポイントに到着すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムはデータを共通言語ランタイム \(CLR: Common Language Runtime\) 型のインスタンスに逆シリアル化しようとします。 逆シリアル化するためにインスタンス化される型は、まず受信メッセージを調べてメッセージの内容が従うデータ コントラクトを特定することで選択されます。 次に逆シリアル化エンジンは、メッセージの内容と互換性のあるデータ コントラクトを実装する CLR 型を探します。 逆シリアル化エンジンによってこの処理中に逆シリアル化の候補の型として許可される一連の型は、逆シリアル化の "既知の型" のセットと呼ばれます。  
+  
+ 逆シリアル化エンジンに型の情報を知らせる方法として、<xref:System.Runtime.Serialization.KnownTypeAttribute> を使用する方法があります。 この属性は、データ コントラクト型全体に適用できるだけで、個々のデータ メンバーには適用できません。 この属性は、クラスまたは構造体にすることが可能な*外部型*に適用されます。 最も簡単な使用方法は、属性を適用するときに "既知の型" として型を指定することです。 これによって、外部型のオブジェクトまたはメンバーを通して参照される任意のオブジェクトが逆シリアル化されるときに、必ず、その既知の型が既知の型のセットに追加されます。 複数の <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を同じ型に適用することができます。  
+  
+## 既知の型とプリミティブ  
+ プリミティブとして扱われる特定の型 \(<xref:System.DateTime>、<xref:System.Xml.XmlElement> など\) と同様に、プリミティブ型は、常に "既知" であり、このメカニズムを通して追加する必要がありません。 ただし、プリミティブ型の配列は明示的に追加する必要があります。 ほとんどのコレクションは、配列と同等に扱われます。 \(非ジェネリック コレクションは、<xref:System.Object> の配列と同等に扱われます\)。 プリミティブ、プリミティブ配列、およびプリミティブ コレクションの使用例については、例 4 を参照してください。  
+  
+> [!NOTE]
+>  他のプリミティブ型とは異なり、<xref:System.DateTimeOffset> 構造は、既定では既知の型ではないため、既知の型のリストに手動で追加する必要があります。  
+  
+## 例  
+ <xref:System.Runtime.Serialization.KnownTypeAttribute> クラスの使用例を次に示します。  
+  
+#### 例 1  
+ 継承関係にある 3 つのクラスがあります。  
+  
+ [!code-csharp[C_KnownTypeAttribute#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#1)]
+ [!code-vb[C_KnownTypeAttribute#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#1)]  
+  
+ 次の `CompanyLogo` クラスはシリアル化できますが、`ShapeOfLogo` メンバーが `CircleType` オブジェクトと `TriangleType` オブジェクトのどちらかに設定されている場合は、逆シリアル化エンジンが "Circle" や "Triangle" という名前のデータ コントラクト型を認識しないため、逆シリアル化することはできません。  
+  
+ [!code-csharp[C_KnownTypeAttribute#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#2)]
+ [!code-vb[C_KnownTypeAttribute#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#2)]  
+  
+ `CompanyLogo` 型の正しいコードの記述方法は次のとおりです。  
+  
+ [!code-csharp[C_KnownTypeAttribute#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#3)]
+ [!code-vb[C_KnownTypeAttribute#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#3)]  
+  
+ 外部型の `CompanyLogo2` が逆シリアル化されるときは、必ず、逆シリアル化エンジンが `CircleType` と `TriangleType` を認識するため、"Circle" データ コントラクトおよび "Triangle" データ コントラクトと一致する型を検出できます。  
+  
+#### 例 2  
+ 次の例では、`CustomerTypeA` と `CustomerTypeB` の両方が `Customer` データ コントラクトを持っている場合でも、逆シリアル化エンジンは `CustomerTypeB` だけを認識するため、`PurchaseOrder` が逆シリアル化されるときは必ず `CustomerTypeB` のインスタンスが作成されます。  
+  
+ [!code-csharp[C_KnownTypeAttribute#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#4)]
+ [!code-vb[C_KnownTypeAttribute#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#4)]  
+  
+#### 例 3  
+ 次の例では、<xref:System.Collections.Hashtable> が <xref:System.Object> として内部的にその内容を保存します。 ハッシュ テーブルを正常に逆シリアル化するには、逆シリアル化エンジンがそのテーブルに現れる可能性のある型のセットを認識している必要があります。 この場合は、`Book` オブジェクトと `Magazine` オブジェクトだけが `Catalog` に保存されているため、この 2 つが <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を使用して追加されることが事前にわかっています。  
+  
+ [!code-csharp[C_KnownTypeAttribute#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#5)]
+ [!code-vb[C_KnownTypeAttribute#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#5)]  
+  
+#### 例 4  
+ 次の例では、データ コントラクトには数値と、その数値に基づいて実行する演算が含まれています。`Numbers` データ メンバーは、整数、整数の配列、または整数を含む <xref:System.Collections.Generic.List%601> にすることができます。  
+  
+> [!CAUTION]
+>  この例は、WCF プロキシを生成するために SVCUTIL.EXE が使用されている場合にのみ、クライアント側で機能します。 SVCUTIL.EXE は、サービスからメタデータ \(任意の既知の型を含む\) を取得します。 この情報がない場合、クライアントは型を逆シリアル化できません。  
+  
+ [!code-csharp[C_KnownTypeAttribute#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#6)]
+ [!code-vb[C_KnownTypeAttribute#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#6)]  
+  
+ アプリケーション コードは次のとおりです。  
+  
+ [!code-csharp[C_KnownTypeAttribute#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#7)]
+ [!code-vb[C_KnownTypeAttribute#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#7)]  
+  
+## 既知の型、継承、およびインターフェイス  
+ `KnownTypeAttribute` 属性を使用して既知の型を特定の型に関連付けると、その既知の型がその特定の型から派生したすべての型に関連付けられます。 たとえば、次のコードを参照してください。  
+  
+ [!code-csharp[C_KnownTypeAttribute#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#8)]
+ [!code-vb[C_KnownTypeAttribute#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#8)]  
+  
+ `DoubleDrawing` クラスは、`KnownTypeAttribute` フィールドで `Square` と `Circle` を使用するために `AdditionalShape` 属性を必要としません。これは、既に基本クラス \(`Drawing`\) にこれらの属性が適用されているためです。  
+  
+ 既知の型は、クラスと構造体にのみ関連付けることができます。インターフェイスに関連付けることはできません。  
+  
+## オープン ジェネリック メソッドを使用する既知の型  
+ 既知の型としてジェネリック型の追加が必要な場合があります。 ただし、オープン ジェネリック型をパラメーターとして `KnownTypeAttribute` 属性に渡すことはできません。  
+  
+ この問題は、型の一覧を返すメソッドを作成して既知の型のコレクションに追加するという代替機構を使用することで解決できます。 次に、いくつかの制限事項があるため、このメソッドの名前を `KnownTypeAttribute` 属性への文字列引数として指定します。  
+  
+ このメソッドは、`KnownTypeAttribute` 属性を適用する型上に存在し、静的で、パラメーターを必要とせず、<xref:System.Collections.IEnumerable> の <xref:System.Type> に代入可能なオブジェクトを返す必要があります。  
+  
+ 同じ型上で、メソッド名を持つ `KnownTypeAttribute` 属性と実際の型を持つ `KnownTypeAttribute` 属性を組み合わせることはできません。 また、メソッド名が同じ複数の `KnownTypeAttribute` を同じ型に適用することはできません。  
+  
+ 次のクラスを参照してください。  
+  
+ [!code-csharp[C_KnownTypeAttribute#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#9)]
+ [!code-vb[C_KnownTypeAttribute#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#9)]  
+  
+ `theDrawing` フィールドには、`ColorDrawing` ジェネリック クラスおよび `BlackAndWhiteDrawing` ジェネリック クラスのインスタンスを格納でき、これらのクラスは両方とも `Drawing` ジェネリック クラスから継承されています。 通常、両クラスとも既知の型に追加する必要がありますが、次の属性の構文は無効です。  
+  
+```csharp  
+// Invalid syntax for attributes:  
+// [KnownType(typeof(ColorDrawing<T>))]  
+// [KnownType(typeof(BlackAndWhiteDrawing<T>))]  
+```  
+  
+```vb  
+' Invalid syntax for attributes:  
+' <KnownType(GetType(ColorDrawing(Of T))), _  
+' KnownType(GetType(BlackAndWhiteDrawing(Of T)))>  
+```  
+  
+ したがって、これらの型を返すメソッドを作成する必要があります。 この型の正しいコードの記述方法は次のとおりです。  
+  
+ [!code-csharp[C_KnownTypeAttribute#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_knowntypeattribute/cs/source.cs#10)]
+ [!code-vb[C_KnownTypeAttribute#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_knowntypeattribute/vb/source.vb#10)]  
+  
+## 既知の型を追加するその他の方法  
+ また、既知の型は、構成ファイルを使用して追加することもできます。 この方法は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でサードパーティ製の型ライブラリを使用する場合のように、既知の型の逆シリアル化が制御できない場合に便利です。  
+  
+ 構成ファイルで既知の型を指定する方法を次に示します。  
+  
+ `<configuration>`  
+  
+ `<system.runtime.serialization>`  
+  
+ `<dataContractSerializer>`  
+  
+ `<declaredTypes>`  
+  
+ `<add type="MyCompany.Library.Shape,`  
+  
+ `MyAssembly, Version=2.0.0.0, Culture=neutral,`  
+  
+ `PublicKeyToken=XXXXXX, processorArchitecture=MSIL">`  
+  
+ `<knownType type="MyCompany.Library.Circle,`  
+  
+ `MyAssembly, Version=2.0.0.0, Culture=neutral,`  
+  
+ `PublicKeyToken=XXXXXX, processorArchitecture=MSIL"/>`  
+  
+ `</add>`  
+  
+ `</declaredTypes>`  
+  
+ `</dataContractSerializer>`  
+  
+ `</system.runtime.serialization>`  
+  
+ `</configuration>`  
+  
+ 前の構成ファイルでは、`MyCompany.Library.Shape` というコントラクト型が `MyCompany.Library.Circle` を既知の型として持つと宣言されています。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.KnownTypeAttribute>   
+ <xref:System.Collections.Hashtable>   
+ <xref:System.Object>   
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.DataContractSerializer.KnownTypes%2A>   
+ [既知の型](../../../../docs/framework/wcf/samples/known-types.md)   
+ [データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-names.md b/docs/framework/wcf/feature-details/data-contract-names.md
new file mode 100644
index 00000000000..e42df436011
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-names.md
@@ -0,0 +1,88 @@
+---
+title: "データ コントラクト名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], 名前付け"
+ms.assetid: 31f87e6c-247b-48f5-8e94-b9e1e33d8d09
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# データ コントラクト名
+クライアントとサービスが同じ型を共有しないことがあります。このような場合でも、双方のデータ コントラクトが等価であれば、相互にデータを受け渡すことができます。[データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)は、データ コントラクトとデータ メンバーの名前に基づいているため、型とメンバーを名前にマップするための機構が用意されています。ここでは、データ コントラクトの命名規則に加えて、名前を作成する際の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] インフラストラクチャの既定の動作についても説明します。  
+  
+## 基本的な規則  
+ データ コントラクトの名前付けに関する基本的な規則は次のとおりです。  
+  
+-   データ コントラクトの完全修飾名は、名前空間と名前から構成されます。  
+  
+-   データ メンバーは名前のみを持ち、名前空間はありません。  
+  
+-   データ コントラクトを処理するときに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、データ コントラクトの名前空間と名前およびデータ メンバーの名前について大文字と小文字を区別します。  
+  
+## データ コントラクト名前空間  
+ データ コントラクトの名前空間は、URI \(Uniform Resource Identifier\) の形式を使用します。URI は、絶対 URI でも相対 URI のどちらでもかまいません。既定では、特定の型のデータ コントラクトには、その型の共通言語ランタイム \(CLR: Common Language Runtime\) 名前空間に基づく名前空間が割り当てられます。  
+  
+ 既定では、任意の CLR 名前空間 \(*Clr.Namespace* の形式\) が、名前空間 "http:\/\/schemas.datacontract.org\/2004\/07\/Clr.Namespace" にマップされます。この既定をオーバーライドするには、<xref:System.Runtime.Serialization.ContractNamespaceAttribute> 属性をモジュールまたはアセンブリ全体に適用します。また、型ごとにデータ コントラクト名前空間を制御するには、<xref:System.Runtime.Serialization.DataContractAttribute> の <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A> プロパティを設定します。  
+  
+> [!NOTE]
+>  "http:\/\/schemas.microsoft.com\/2003\/10\/Serialization" 名前空間は予約されているため、データ コントラクトの名前空間として使用することはできません。  
+  
+> [!NOTE]
+>  `delegate` 宣言を含むデータ コントラクト型では、既定の名前空間をオーバーライドすることはできません。  
+  
+## データ コントラクト名  
+ ある型のデータ コントラクトの既定の名前は、その型の名前になります。この既定をオーバーライドするには、<xref:System.Runtime.Serialization.DataContractAttribute> の <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> プロパティを別の名前に設定します。ジェネリック型に関する特別な規則については、このトピックで後述される「ジェネリック型のデータ コントラクト名」で説明します。  
+  
+## データ メンバー名  
+ フィールドまたはプロパティのデータ メンバーの既定の名前は、そのフィールドまたはプロパティの名前になります。この既定をオーバーライドするには、<xref:System.Runtime.Serialization.DataMemberAttribute> の <xref:System.Runtime.Serialization.DataMemberAttribute.Name%2A> プロパティを別の値に設定します。  
+  
+### 例  
+ 次の例では、データ コントラクトおよびデータ メンバーの既定の名前付け動作をオーバーライドする方法を示します。  
+  
+ [!code-csharp[C_DataContractNames#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#1)]
+ [!code-vb[C_DataContractNames#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#1)]  
+  
+## ジェネリック型のデータ コントラクト名  
+ ジェネリック型のデータ コントラクト名を決定する場合は、特別な規則があります。これらの規則は、同じジェネリック型の 2 つのクローズ ジェネリックの間でデータ コントラクト名の競合を回避するのに役立ちます。  
+  
+ 既定では、ジェネリック型のデータ コントラクト名は、型の名前の後に文字列 "Of"、ジェネリック パラメーターのデータ コントラクト名、ジェネリック パラメーターのデータ コントラクト名前空間を使用して計算された*ハッシュ*が続きます。ハッシュとは、1 つのデータを一意に識別するための "指紋" として機能する、数学関数の結果です。ジェネリック パラメーターがすべてプリミティブ型の場合は、ハッシュは省略されます。  
+  
+ たとえば、次の例の型を見てください。  
+  
+ [!code-csharp[C_DataContractNames#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#2)]
+ [!code-vb[C_DataContractNames#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#2)]  
+  
+ この例では、`Drawing<Square,RegularRedBrush>` 型は "DrawingOfSquareRedBrush5HWGAU6h" というデータ コントラクト名を持ちます。ここで "5HWGAU6h" は "urn:shapes" および "urn:default" 名前空間のハッシュになります。`Drawing<Square,SpecialRedBrush>` 型は "DrawingOfSquareRedBrushjpB5LgQ\_S" というデータ コントラクト名を持ちます。ここで "jpB5LgQ\_S" は "urn:shapes" および "urn:special" 名前空間のハッシュになります。ハッシュを使用しないと 2 つの名前は同一になり、名前の競合が発生することに注意してください。  
+  
+## ジェネリック型のデータ コントラクト名のカスタマイズ  
+ 前述のようにジェネリック型用に生成されたデータ コントラクト名を容認できない場合があります。たとえば、名前の競合が起こらないことが前もってわかっているため、ハッシュを削除するとします。この場合、`DataContractAttribute` 属性の <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> プロパティを使用して、名前を生成する別の方法を指定できます。`Name` プロパティの中かっこ内に数字を指定して、ジェネリック パラメーターのデータ コントラクト名を参照できます \(0 は最初のパラメーターを参照し、1 は 2 番目のパラメーターを参照します。以下同様です\)。中かっこ内にシャープ記号 \(\#\) を指定すると、ハッシュを参照できます。これらの各参照は、複数回使用しても、まったく使用しなくてもかまいません。  
+  
+ たとえば、前の `Drawing` ジェネリック型は次の例に示すように宣言できます。  
+  
+ [!code-csharp[c_DataContractNames#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#3)]
+ [!code-vb[c_DataContractNames#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#3)]  
+  
+ この場合、`Drawing<Square,RegularRedBrush>` 型は、"Drawing\_using\_RedBrush\_brush\_and\_Square\_shape" というデータ コントラクト名になります。<xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> プロパティに "{\#}" があるため、名前にはハッシュは含まれません。したがって、この型では名前の競合が発生しやすくなります。たとえば、`Drawing<Square,SpecialRedBrush>` 型は、まったく同じデータ コントラクト名を持ちます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ <xref:System.Runtime.Serialization.ContractNamespaceAttribute>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [Data Contract Names](../../../../docs/framework/wcf/feature-details/data-contract-names.md)   
+ [データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-schema-reference.md b/docs/framework/wcf/feature-details/data-contract-schema-reference.md
new file mode 100644
index 00000000000..ea2767a3d0c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-schema-reference.md
@@ -0,0 +1,697 @@
+---
+title: "データ コントラクト スキーマの参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], スキーマの参照"
+ms.assetid: 9ebb0ebe-8166-4c93-980a-7c8f1f38f7c0
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# データ コントラクト スキーマの参照
+ここでは、XML シリアル化用の共通言語ランタイム \(CLR\) 型を表すために <xref:System.Runtime.Serialization.DataContractSerializer> が使用する XML スキーマ \(XSD\) のサブセットについて説明します。  
+  
+## DataContractSerializer のマッピング  
+ `DataContractSerializer` は、メタデータ エンドポイントや [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してメタデータを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスからエクスポートするときに、CLR 型を XSD にマッピングします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクト シリアライザー](../../../../docs/framework/wcf/feature-details/data-contract-serializer.md)。  
+  
+ また、`DataContractSerializer` は、Svcutil.exe を使用して Web サービス記述言語 \(WSDL\) や XSD ドキュメントにアクセスし、サービスまたはクライアントのデータ コントラクトを生成するときに、XSD を CLR 型にマッピングします。  
+  
+ `DataContractSerializer` を使用して CLR 型にマッピングできるのは、この文書に記載されている要件に適合する XML スキーマ インスタンスに限られます。  
+  
+### サポート レベル  
+ `DataContractSerializer` は、特定の XML スキーマ機能に次のサポート レベルを提供します。  
+  
+-   **サポートあり**。 この機能から CLR 型または属性の一方または両方への、`DataContractSerializer` を使用する明示的なマッピングが存在します。  
+  
+-   **無視**。 この機能は、`DataContractSerializer` によってインポートされたスキーマで使用できますが、コードの生成に影響しません。  
+  
+-   **禁止**。`DataContractSerializer` は、この機能を使用するスキーマのインポートをサポートしません。 たとえば、Svcutil.exe は、この機能を使用するスキーマに基づいて WSDL にアクセスする場合、代わりに <xref:System.Xml.Serialization.XmlSerializer> を使用します。 これが既定値です。  
+  
+## 一般情報  
+  
+-   スキーマ名前空間については、「[XML Schema \(XML スキーマ\)](http://go.microsoft.com/fwlink/?LinkId=95475)」を参照してください。 このドキュメントでは、プレフィックス "xs" を使用しています。  
+  
+-   スキーマ以外の名前空間を含む属性は無視されます。  
+  
+-   注釈 \(このドキュメントで説明しているものを除きます\) はすべて無視されます。  
+  
+### \<xs:schema\>: 属性  
+  
+|属性|DataContract|  
+|--------|------------------|  
+|`attributeFormDefault`|無視されます。|  
+|`blockDefault`|無視されます。|  
+|`elementFormDefault`|修飾する必要があります。`DataContractSerializer` でスキーマをサポートするには、すべての要素を修飾する必要があります。 要素を修飾するには、xs:schema\/@elementFormDefault を "qualified" に設定するか、個々の要素の宣言で xs:element\/@form を "qualified" に設定します。|  
+|`finalDefault`|無視されます。|  
+|`Id`|無視されます。|  
+|`targetNamespace`|サポートされます。データ コントラクト名前空間にマッピングされます。 この属性を指定しなかった場合は、空の名前空間が使用されます。 予約されている名前空間 http:\/\/schemas.microsoft.com\/2003\/10\/Serialization\/ は指定できません。|  
+|`version`|無視されます。|  
+  
+### \<xs:schema\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`include`|サポートされています。`DataContractSerializer` では xs:include と xs:import がサポートされています。 ただし、メタデータをローカル ファイルから読み込む場合、Svcutil.exe では、後続の `xs:include/@schemaLocation` 参照と `xs:import/@location` 参照が制限されます。 この場合、`include` ではなく帯域外機構を通じてスキーマ ファイルの一覧を渡す必要があります。`include` されたスキーマ ドキュメントは無視されます。|  
+|`redefine`|禁止。 セキュリティ上の理由により、`xs:redefine` では、`DataContractSerializer` の使用が禁止されています。`x:redefine` では、`schemaLocation` を後続させる必要があります。 状況によっては、DataContract を使用する Svcutil.exe では、`schemaLocation` の使用が制限されます。|  
+|`import`|サポートされています。`DataContractSerializer` では、`xs:include` と `xs:import` がサポートされています。 ただし、メタデータをローカル ファイルから読み込む場合、Svcutil.exe では、後続の `xs:include/@schemaLocation` 参照と `xs:import/@location` 参照が制限されます。 この場合、`include` ではなく帯域外機構を通じてスキーマ ファイルの一覧を渡す必要があります。`include` されたスキーマ ドキュメントは無視されます。|  
+|`simpleType`|サポートされています。`xs:simpleType` のセクションを参照してください。|  
+|`complexType`|サポートされます。データ コントラクトにマッピングされます。`xs:complexType` のセクションを参照してください。|  
+|`group`|無視されます。`DataContractSerializer` では、`xs:group`、`xs:attributeGroup`、および `xs:attribute` の使用はサポートされていません。 これらの宣言は `xs:schema` の子として無視され、`complexType` やその他のサポートされている構文内から参照できません。|  
+|`attributeGroup`|無視されます。`DataContractSerializer` では、`xs:group`、`xs:attributeGroup`、および `xs:attribute` の使用はサポートされていません。 これらの宣言は `xs:schema` の子として無視され、`complexType` やその他のサポートされている構文内から参照できません。|  
+|`element`|サポートされています。 グローバル要素宣言 \(GED\) を参照してください。|  
+|`attribute`|無視されます。`DataContractSerializer` では、`xs:group`、`xs:attributeGroup`、および `xs:attribute` の使用はサポートされていません。 これらの宣言は `xs:schema` の子として無視され、`complexType` やその他のサポートされている構文内から参照できません。|  
+|`notation`|無視されます。|  
+  
+## 複合型 – \<xs:complexType\>  
+  
+### 一般情報  
+ 各複合型 \<xs:complexType\> は、データ コントラクトにマッピングされます。  
+  
+### \<xs:complexType\>: 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`abstract`|false \(既定\) のみ有効です。|  
+|`block`|禁止。|  
+|`final`|無視されます。|  
+|`id`|無視されます。|  
+|`mixed`|false \(既定\) のみ有効です。|  
+|`name`|サポートされています。データ コントラクト名にマッピングされます。 名前にピリオドが含まれている場合は、内部型への型のマッピングが実行されます。 たとえば、`A.B` という名前の複合型は、データ コントラクト名 `A` を持つ型の内部型であるデータ コントラクト型にマッピングされますが、このようなデータ コントラクト型が存在する場合に限られます。 複数レベルの入れ子が可能です。たとえば、`A.B.C` という内部型も可能ですが、これは、`A` と `A.B` の両方が存在する場合に限られます。|  
+  
+### \<xs:complexType\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`simpleContent`|拡張は禁止です。<br /><br /> 制限は、`anySimpleType` からのみ許可されます。|  
+|`complexContent`|サポートされています。 「継承」を参照してください。|  
+|`group`|禁止。|  
+|`all`|禁止。|  
+|`choice`|禁止。|  
+|`sequence`|サポートされます。データ コントラクトのデータ メンバーにマッピングされます。|  
+|`attribute`|use\="prohibited" の場合でも禁止です \(ただし、例外が 1 つあります\)。 標準シリアル化スキーマ名前空間のオプションの属性のみがサポートされます。 これらは、データ コントラクト プログラミング モデルのデータ メンバーにマッピングされません。 現在、これらの属性で意味のあるものは 1 つだけです。詳細については、ISerializable のセクションを参照してください。 他の属性はすべて無視されます。|  
+|`attributeGroup`|禁止。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] v1 リリースの `DataContractSerializer` では、`attributeGroup` 内部の `xs:complexType` の存在が無視されます。|  
+|`anyAttribute`|禁止。|  
+|\(空\)|データ メンバーを持たないデータ コントラクトにマッピングされます。|  
+  
+### 複合型での \<xs:sequence\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`id`|無視されます。|  
+|`maxOccurs`|1 \(既定\) のみ有効です。|  
+|`minOccurs`|1 \(既定\) のみ有効です。|  
+  
+### 複合型での \<xs:sequence\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`element`|各インスタンスがデータ メンバーにマッピングされます。|  
+|`group`|禁止。|  
+|`choice`|禁止。|  
+|`sequence`|禁止。|  
+|`any`|禁止。|  
+|\(空\)|データ メンバーを持たないデータ コントラクトにマッピングされます。|  
+  
+## 要素 – \<xs:element\>  
+  
+### 一般情報  
+ `<xs:element>` は、次の構文で発生します。  
+  
+-   `<xs:sequence>` 内で発生し、通常 \(コレクション以外\) のデータ コントラクトのデータ メンバーを表すことができます。 この場合、`maxOccurs` 属性は 1 にする必要があります  \(値 0 は使用できません\)。  
+  
+-   `<xs:sequence>` 内で発生し、コレクション データ コントラクトのデータ メンバーを表すことができます。 この場合、`maxOccurs` 属性は 2 以上の値か、"unbounded" にする必要があります。  
+  
+-   `<xs:schema>` 内で GED \(グローバル要素宣言\) として発生します。  
+  
+### \<xs:sequence\> 内の maxOccurs\=1 を持つ \<xs:element\> \(データ メンバー\)  
+  
+|属性|Schema|  
+|--------|------------|  
+|`ref`|禁止。|  
+|`name`|サポートされます。データ メンバー名にマッピングされます。|  
+|`type`|サポートされます。データ メンバー型にマッピングされます。 詳細については、「型\/プリミティブのマッピング」を参照してください。 指定しない場合 \(および要素に匿名型が含まれていない場合\) は、`xs:anyType` が使用されます。|  
+|`block`|無視されます。|  
+|`default`|禁止。|  
+|`fixed`|禁止。|  
+|`form`|修飾する必要があります。 この属性は、`elementFormDefault` の `xs:schema` を通じて設定できます。|  
+|`id`|無視されます。|  
+|`maxOccurs`|1|  
+|`minOccurs`|データ メンバーの <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティにマッピングされます \(`IsRequired` が 1 の場合、`minOccurs` は true です\)。|  
+|`nillable`|型のマッピングに影響します。 「型\/プリミティブのマッピング」を参照してください。|  
+  
+### \<xs:sequence\> 内の maxOccurs\>1 を持つ \<xs:element\> \(コレクション\)  
+  
+-   <xref:System.Runtime.Serialization.CollectionDataContractAttribute> にマッピングされます。  
+  
+-   コレクションの型では、xs:sequence 内で xs:element を 1 つしか使用できません。  
+  
+ コレクションは次のいずれかになります。  
+  
+-   標準コレクション \(配列など\)。  
+  
+-   ディクショナリ コレクション \(1 つの値を別の値にマッピングする、<xref:System.Collections.Hashtable> など\)。  
+  
+-   ディクショナリとキー\/値ペアの配列の種類との唯一の相違は、生成されるプログラミング モデルにあります。 特定の種類がディクショナリ コレクションであることを示すには、スキーマ注釈機構を使用できます。  
+  
+ `ref`、`block`、`default`、`fixed`、`form`、および `id` の各属性に対するルールは、コレクション以外の場合と同じです。 その他に、次の表に示す属性があります。  
+  
+|属性|Schema|  
+|--------|------------|  
+|`name`|サポートされます。<xref:System.Runtime.Serialization.CollectionDataContractAttribute.ItemName%2A> 属性の `CollectionDataContractAttribute` プロパティにマッピングされます。|  
+|`type`|サポートされます。コレクションに格納されている型にマッピングされます。|  
+|`maxOccurs`|2 以上または "unbounded"。 DC スキーマでは、"unbounded" を使用する必要があります。|  
+|`minOccurs`|無視されます。|  
+|`nillable`|型のマッピングに影響します。 この属性は、ディクショナリ コレクションでは無視されます。|  
+  
+### \<xs:schema\> グローバル要素宣言内の \<xs:element\>  
+  
+-   スキーマ内の型と同じ名前および名前空間を持つか、それ自体の内部で匿名型を定義するグローバル要素宣言 \(GED\) は、型に関連付けられていると言います。  
+  
+-   スキーマのエクスポート : 単純型と複合型の両方で、生成された型ごとに関連 GED が生成されます。  
+  
+-   逆シリアル化\/シリアル化 : 関連 GED が、該当する型のルート要素として使用されます。  
+  
+-   スキーマのインポート : 次のルールに従う場合、関連 GED は不要となり無視されます \(ただし、それが型を定義する場合を除きます\)。  
+  
+|属性|Schema|  
+|--------|------------|  
+|`abstract`|関連 GED では false のみ有効です。|  
+|`block`|関連 GED では禁止です。|  
+|`default`|関連 GED では禁止です。|  
+|`final`|関連 GED では false のみ有効です。|  
+|`fixed`|関連 GED では禁止です。|  
+|`id`|無視されます。|  
+|`name`|サポートされています。 関連 GED の定義を参照してください。|  
+|`nillable`|関連 GED では true のみ有効です。|  
+|`substitutionGroup`|関連 GED では禁止です。|  
+|`type`|サポートされます。関連 GED に関連付けられた型に一致させる必要があります \(ただし、要素に匿名型が含まれている場合を除きます\)。|  
+  
+### \<xs:element\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`simpleType`|サポートされています。\*|  
+|`complexType`|サポートされています。\*|  
+|`unique`|無視されます。|  
+|`key`|無視されます。|  
+|`keyref`|無視されます。|  
+|\(空白\)|サポートされています。|  
+  
+ \* `simpleType` および `complexType,` を使用する場合、匿名型のマッピングは、匿名データ コントラクトが存在しないことを除き、非匿名型の場合と同じです。そのため、要素名から派生した名前の付いたデータ コントラクトが作成されます。 匿名型のルールは、次のとおりです。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装詳細 : `xs:element` 名にピリオドが含まれていない場合、匿名型は、外部データ コントラクト型の内部型にマッピングされます。 名前にピリオドが含まれている場合、結果のデータ コントラクト型は、内部型ではなく、独立した型になります。  
+  
+-   内部型の生成されたデータ コントラクト名は、外部型のデータ コントラクト名の後にピリオド、要素の名前、および文字列 "Type" が付いたものになります。  
+  
+-   そのような名前を持つデータ コントラクトが既に存在する場合は、"1"、"2"、"3" などの番号が付加されて一意の名前になります。  
+  
+## 単純型 \- \<xs:simpleType\>  
+  
+### \<xs:simpleType\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`final`|無視されます。|  
+|`id`|無視されます。|  
+|`name`|サポートされます。データ コントラクト名にマッピングされます。|  
+  
+### \<xs:simpleType\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`restriction`|サポートされています。 列挙データ コントラクトにマッピングされます。 列挙パターンに一致しない場合、この属性は無視されます。`xs:simpleType` の制限のセクションを参照してください。|  
+|`list`|サポートされています。 フラグ列挙データ コントラクトにマッピングされます。`xs:simpleType` の一覧のセクションを参照してください。|  
+|`union`|禁止。|  
+  
+### \<xs:restriction\>  
+  
+-   複合型制限は、base\="`xs:anyType`" の場合のみサポートされます。  
+  
+-   `xs:string` 以外の制限ファセットを持たない `xs:enumeration` の単純型制限は、列挙データ コントラクトにマッピングされます。  
+  
+-   その他すべての単純型制限は、それぞれが制限する型にマッピングされます。 たとえば、`xs:int` の制限は、`xs:int` 自体と同様に整数にマッピングされます。 プリミティブ型のマッピング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「型\/プリミティブのマッピング」を参照してください。  
+  
+### \<xs:restriction\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`base`|サポートされている単純型または `xs:anyType` のみ有効です。|  
+|`id`|無視されます。|  
+  
+### 他のすべての場合の \<xs:restriction\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`simpleType`|存在する場合、サポートされているプリミティブ型から派生する必要があります。|  
+|`minExclusive`|無視されます。|  
+|`minInclusive`|無視されます。|  
+|`maxExclusive`|無視されます。|  
+|`maxInclusive`|無視されます。|  
+|`totalDigits`|無視されます。|  
+|`fractionDigits`|無視されます。|  
+|`length`|無視されます。|  
+|`minLength`|無視されます。|  
+|`maxLength`|無視されます。|  
+|`enumeration`|無視されます。|  
+|`whiteSpace`|無視されます。|  
+|`pattern`|無視されます。|  
+|\(空白\)|サポートされています。|  
+  
+## 列挙  
+  
+### 列挙体の \<xs:restriction\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`base`|存在する場合、`xs:string` のみ有効です。|  
+|`id`|無視されます。|  
+  
+### 列挙体の \<xs:restriction\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`simpleType`|存在する場合、データ コントラクトによってサポートされている列挙体制限 \(このセクション\) のみ有効です。|  
+|`minExclusive`|無視されます。|  
+|`minInclusive`|無視されます。|  
+|`maxExclusive`|無視されます。|  
+|`maxInclusive`|無視されます。|  
+|`totalDigits`|無視されます。|  
+|`fractionDigits`|無視されます。|  
+|`length`|禁止。|  
+|`minLength`|禁止。|  
+|`maxLength`|禁止。|  
+|`enumeration`|サポートされています。 列挙体 "id" は無視され、"値" が列挙データ コントラクトの値の名前にマッピングされます。|  
+|`whiteSpace`|禁止。|  
+|`pattern`|禁止。|  
+|\(空\)|サポートされます。空の列挙型にマッピングされます。|  
+  
+ 次のコードは、C\# の列挙クラスを示しています。  
+  
+```  
+public enum MyEnum  
+{  
+   first = 3,  
+   second = 4,  
+   third =5  
+```  
+  
+ }  
+  
+ このクラスは `DataContractSerializer` により、次のスキーマにマッピングされます。 列挙値が 1 から始まる場合、`xs:annotation` ブロックは生成されません。  
+  
+```  
+<xs:simpleType name="MyEnum">  
+<xs:restriction base="xs:string">  
+ <xs:enumeration value="first">  
+  <xs:annotation>  
+   <xs:appinfo>  
+    <EnumerationValue   
+     xmlns="http://schemas.microsoft.com/2003/10/Serialization/">  
+     3  
+    </EnumerationValue>  
+   </xs:appinfo>  
+  </xs:annotation>  
+ </xs:enumeration>  
+ <xs:enumeration value="second">  
+  <xs:annotation>  
+   <xs:appinfo>  
+    <EnumerationValue   
+     xmlns="http://schemas.microsoft.com/2003/10/Serialization/">  
+     4  
+    </EnumerationValue>  
+   </xs:appinfo>  
+  </xs:annotation>  
+ </xs:enumeration>   
+</xs:restriction>  
+</xs:simpleType>  
+```  
+  
+### \<xs:list\>  
+ `DataContractSerializer` は、`System.FlagsAttribute` によってマークされた列挙型を、`xs:list` から派生した `xs:string` にマッピングします。 これ以外の `xs:list` のバリエーションはサポートされません。  
+  
+### \<xs:list\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`itemType`|禁止。|  
+|`id`|無視されます。|  
+  
+### \<xs:list\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`simpleType`|`xs:string` ファセットを使用する `xs:enumeration` からの制限のみ有効です。|  
+  
+ 列挙値が 2 の累乗の数列 \(フラグの既定\) に従わない場合、値は `xs:annotation/xs:appInfo/ser:EnumerationValue` 要素に格納されます。  
+  
+ たとえば、次のコードは列挙型をフラグとして処理します。  
+  
+```  
+[Flags]  
+public enum AuthFlags  
+{    
+  AuthAnonymous = 1,  
+  AuthBasic = 2,  
+  AuthNTLM = 4,  
+  AuthMD5 = 16,  
+  AuthWindowsLiveID = 64,  
+}  
+```  
+  
+ この列挙型は次のスキーマにマッピングされます。  
+  
+```  
+<xs:simpleType name="AuthFlags">  
+    <xs:list>  
+      <xs:simpleType>  
+        <xs:restriction base="xs:string">  
+          <xs:enumeration value="AuthAnonymous" />  
+          <xs:enumeration value="AuthBasic" />  
+          <xs:enumeration value="AuthNTLM" />  
+          <xs:enumeration value="AuthMD5">  
+            <xs:annotation>  
+              <xs:appinfo>  
+                <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Se  
+rialization/">16</EnumerationValue>  
+              </xs:appinfo>  
+            </xs:annotation>  
+          </xs:enumeration>  
+          <xs:enumeration value="AuthWindowsLiveID">  
+            <xs:annotation>  
+              <xs:appinfo>  
+                <EnumerationValue xmlns="http://schemas.microsoft.com/2003/10/Se  
+rialization/">64</EnumerationValue>  
+              </xs:appinfo>  
+            </xs:annotation>  
+          </xs:enumeration>  
+        </xs:restriction>  
+      </xs:simpleType>  
+    </xs:list>  
+  </xs:simpleType>  
+```  
+  
+## 継承  
+  
+### 一般ルール  
+ データ コントラクトは、別のデータ コントラクトを継承できます。 このようなデータ コントラクトは base にマッピングされ、`<xs:extension>` XML スキーマ コントラクトを使用する拡張型によって派生されます。  
+  
+ データ コントラクトは、コレクション データ コントラクトを継承できません。  
+  
+ データ コントラクトの例を次のコードに示します。  
+  
+```  
+[DataContract]  
+public class Person  
+{  
+  [DataMember]  
+  public string Name;  
+}  
+[DataContract]  
+public class Employee : Person   
+{      
+  [DataMember]  
+  public int ID;  
+}  
+```  
+  
+ このデータ コントラクトは次の XML スキーマ型の宣言にマッピングされます。  
+  
+```  
+<xs:complexType name="Employee">  
+ <xs:complexContent mixed="false">  
+  <xs:extension base="tns:Person">  
+   <xs:sequence>  
+    <xs:element minOccurs="0" name="ID" type="xs:int"/>  
+   </xs:sequence>  
+  </xs:extension>  
+ </xs:complexContent>  
+</xs:complexType>  
+<xs:complexType name="Person">  
+ <xs:sequence>  
+  <xs:element minOccurs="0" name="Name"   
+    nillable="true" type="xs:string"/>  
+ </xs:sequence>  
+</xs:complexType>  
+```  
+  
+### \<xs:complexContent\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`id`|無視されます。|  
+|`mixed`|false のみ有効です。|  
+  
+### \<xs:complexContent\> : コンテンツ  
+  
+|目次|Schema|  
+|--------|------------|  
+|`restriction`|禁止ですが、base\="`xs:anyType`" の場合を除きます。 後者は、`xs:restriction` のコンテナーの下に `xs:complexContent` のコンテンツを直接配置するのと同じです。|  
+|`extension`|サポートされています。 データ コントラクトの継承にマッピングされます。|  
+  
+### \<xs:complexContent\> での \<xs:extension\> : 属性  
+  
+|属性|Schema|  
+|--------|------------|  
+|`id`|無視されます。|  
+|`base`|サポートされています。 この型が継承する基本データ コントラクト型にマッピングされます。|  
+  
+### \<xs:complexContent\> での \<xs:extension\> : コンテンツ  
+ `<xs:complexType>` コンテンツと同じルールです。  
+  
+ `<xs:sequence>` を指定した場合は、そのメンバー要素が、派生データ コントラクトに存在する追加のデータ メンバーにマッピングされます。  
+  
+ 基本型の要素と同じ名前を持つ要素が派生型に含まれている場合は、重複する要素宣言が、一意のものとして生成される名前を持つデータ メンバーにマッピングされます。 データ メンバーの名前には、一意の名前が見つかるまで正の整数が付加されます \("member1"、"member2" など\)。 これに対して、次のようになります。  
+  
+-   基本データ コントラクトのデータ メンバーと同じ名前および型を持つデータ メンバーが派生データ コントラクトに存在する場合、`DataContractSerializer` は、これに対応する要素を派生型で生成します。  
+  
+-   基本データ コントラクトのデータ メンバーと名前は同じでも型が異なるデータ メンバーが派生データ コントラクトに存在する場合、`DataContractSerializer` は、`xs:anyType` 型の要素を含むスキーマを、基本型と派生型の両方の宣言にインポートします。 元の型名は、`xs:annotations/xs:appInfo/ser:ActualType/@Name` に保持されます。  
+  
+ それぞれのデータ メンバーの順序によっては、これら両方のバリエーションにより、あいまいなコンテンツ モデルを含むスキーマが生じる場合があります。  
+  
+## 型\/プリミティブのマッピング  
+ `DataContractSerializer` は、XML スキーマのプリミティブ型で次のマッピングを使用します。  
+  
+|XSD 型|.NET 型|  
+|-----------|------------|  
+|`anyType`|<xref:System.Object>。|  
+|`anySimpleType`|<xref:System.String>。|  
+|`duration`|<xref:System.TimeSpan>。|  
+|`dateTime`|<xref:System.DateTime>。|  
+|`dateTimeOffset`|オフセットの <xref:System.DateTime> および <xref:System.TimeSpan>。 後の「DateTimeOffset のシリアル化」を参照してください。|  
+|`time`|<xref:System.String>。|  
+|`date`|<xref:System.String>。|  
+|`gYearMonth`|<xref:System.String>。|  
+|`gYear`|<xref:System.String>。|  
+|`gMonthDay`|<xref:System.String>。|  
+|`gDay`|<xref:System.String>。|  
+|`gMonth`|<xref:System.String>。|  
+|`boolean`|<xref:System.Boolean>|  
+|`base64Binary`|<xref:System.Byte> 配列|  
+|`hexBinary`|<xref:System.String>。|  
+|`float`|<xref:System.Single>。|  
+|`double`|<xref:System.Double>。|  
+|`anyURI`|<xref:System.Uri>。|  
+|`QName`|<xref:System.Xml.XmlQualifiedName>。|  
+|`string`|<xref:System.String>。|  
+|`normalizedString`|<xref:System.String>。|  
+|`token`|<xref:System.String>。|  
+|`language`|<xref:System.String>。|  
+|`Name`|<xref:System.String>。|  
+|`NCName`|<xref:System.String>。|  
+|`ID`|<xref:System.String>。|  
+|`IDREF`|<xref:System.String>。|  
+|`IDREFS`|<xref:System.String>。|  
+|`ENTITY`|<xref:System.String>。|  
+|`ENTITIES`|<xref:System.String>。|  
+|`NMTOKEN`|<xref:System.String>。|  
+|`NMTOKENS`|<xref:System.String>。|  
+|`decimal`|<xref:System.Decimal>。|  
+|`integer`|<xref:System.Int64>。|  
+|`nonPositiveInteger`|<xref:System.Int64>。|  
+|`negativeInteger`|<xref:System.Int64>。|  
+|`long`|<xref:System.Int64>。|  
+|`int`|<xref:System.Int32>。|  
+|`short`|<xref:System.Int16>。|  
+|`Byte`|<xref:System.SByte>。|  
+|`nonNegativeInteger`|<xref:System.Int64>。|  
+|`unsignedLong`|<xref:System.UInt64>。|  
+|`unsignedInt`|<xref:System.UInt32>。|  
+|`unsignedShort`|<xref:System.UInt16>。|  
+|`unsignedByte`|<xref:System.Byte>。|  
+|`positiveInteger`|<xref:System.Int64>。|  
+  
+## ISerializable 型のマッピング  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] Version 1.0 では、永続性の確保やデータ転送のためにオブジェクトをシリアル化する一般的な機構として `ISerializable` が導入されました。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] を実装したり、アプリケーション間で受け渡したりできる、さまざまな `ISerializable` 型があります。`DataContractSerializer` は、当然ながら `ISerializable` クラスをサポートします。`DataContractSerializer` は、型の QName \(修飾名\) のみが異なり、事実上プロパティ コレクションである `ISerializable` 実装スキーマ型をマッピングします。 たとえば、`DataContractSerializer` は、http:\/\/schemas.datacontract.org\/2004\/07\/System 名前空間にある次の XSD 型に <xref:System.Exception> をマッピングします。  
+  
+```  
+<xs:complexType name="Exception">  
+ <xs:sequence>  
+  <xs:any minOccurs="0" maxOccurs="unbounded"   
+      namespace="##local" processContents="skip"/>  
+ </xs:sequence>  
+ <xs:attribute ref="ser:FactoryType"/>  
+</xs:complexType>  
+```  
+  
+ データ コントラクトのシリアル化スキーマで宣言されたオプションの属性 `ser:FactoryType` は、型を逆シリアル化できるファクトリ クラスを参照します。 ファクトリ クラスは、使用する `DataContractSerializer` インスタンスの既知の型コレクションの一部である必要があります。 既知の型[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+## DataContract のシリアル化スキーマ  
+ `DataContractSerializer` によってエクスポートされたいくつかのスキーマでは、次の特別なデータ コントラクト シリアル化名前空間の型、要素、および属性を使用します。  
+  
+ http:\/\/schemas.microsoft.com\/2003\/10\/Serialization  
+  
+ データ コントラクト シリアル化スキーマの完全な宣言を次に示します。  
+  
+```  
+<xs:schema attributeFormDefault="qualified"          
+   elementFormDefault="qualified"        
+   targetNamespace =   
+    "http://schemas.microsoft.com/2003/10/Serialization/"   
+   xmlns:xs="http://www.w3.org/2001/XMLSchema"        
+   xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/">  
+  
+ <!-- Top-level elements for primitive types. -->  
+ <xs:element name="anyType" nillable="true" type="xs:anyType"/>  
+ <xs:element name="anyURI" nillable="true" type="xs:anyURI"/>  
+ <xs:element name="base64Binary"   
+       nillable="true" type="xs:base64Binary"/>  
+ <xs:element name="boolean" nillable="true" type="xs:boolean"/>  
+ <xs:element name="byte" nillable="true" type="xs:byte"/>  
+ <xs:element name="dateTime" nillable="true" type="xs:dateTime"/>  
+ <xs:element name="decimal" nillable="true" type="xs:decimal"/>  
+ <xs:element name="double" nillable="true" type="xs:double"/>  
+ <xs:element name="float" nillable="true" type="xs:float"/>  
+ <xs:element name="int" nillable="true" type="xs:int"/>  
+ <xs:element name="long" nillable="true" type="xs:long"/>  
+ <xs:element name="QName" nillable="true" type="xs:QName"/>  
+ <xs:element name="short" nillable="true" type="xs:short"/>  
+ <xs:element name="string" nillable="true" type="xs:string"/>  
+ <xs:element name="unsignedByte"   
+       nillable="true" type="xs:unsignedByte"/>  
+ <xs:element name="unsignedInt"   
+       nillable="true" type="xs:unsignedInt"/>  
+ <xs:element name="unsignedLong"   
+       nillable="true" type="xs:unsignedLong"/>  
+ <xs:element name="unsignedShort"   
+       nillable="true" type="xs:unsignedShort"/>  
+  
+ <!-- Primitive types introduced for certain .NET simple types. -->  
+ <xs:element name="char" nillable="true" type="tns:char"/>  
+ <xs:simpleType name="char">  
+  <xs:restriction base="xs:int"/>  
+ </xs:simpleType>  
+  
+ <!-- xs:duration is restricted to an ordered value space,   
+    to map to System.TimeSpan -->  
+ <xs:element name="duration" nillable="true" type="tns:duration"/>  
+ <xs:simpleType name="duration">  
+  <xs:restriction base="xs:duration">  
+   <xs:pattern   
+     value="\-?P(\d*D)?(T(\d*H)?(\d*M)?(\d*(\.\d*)?S)?)?"/>  
+   <xs:minInclusive value="-P10675199DT2H48M5.4775808S"/>  
+   <xs:maxInclusive value="P10675199DT2H48M5.4775807S"/>  
+  </xs:restriction>  
+ </xs:simpleType>  
+  
+ <xs:element name="guid" nillable="true" type="tns:guid"/>  
+ <xs:simpleType name="guid">  
+  <xs:restriction base="xs:string">  
+   <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}"/>  
+  </xs:restriction>  
+ </xs:simpleType>  
+  
+ <!-- This is used for schemas exported from ISerializable type. -->  
+ <xs:attribute name="FactoryType" type="xs:QName"/>  
+</xs:schema>  
+```  
+  
+ ここで次の点に注意します。  
+  
+-   `ser:char` を導入して、型 <xref:System.Char> の Unicode 文字を表現します。  
+  
+-   `valuespace` の `xs:duration` を順序付きセットに縮小し、<xref:System.TimeSpan> にマッピングできるようにします。  
+  
+-   `FactoryType` から派生した型からエクスポートされたスキーマで <xref:System.Runtime.Serialization.ISerializable> を使用します。  
+  
+## 非 DataContract スキーマのインポート  
+ `DataContractSerializer` には、`ImportXmlTypes` XSD プロファイルに準拠しないスキーマのインポートを可能にする `DataContractSerializer` オプションがあります \(「<xref:System.Runtime.Serialization.XsdDataContractImporter.Options%2A> プロパティ」を参照してください\)。 このオプションを `true` に設定すると、非準拠スキーマ型を受け入れ、それを次の実装 \(<xref:System.Xml.Serialization.IXmlSerializable> の配列をラップする <xref:System.Xml.XmlNode>\) にマッピングできるようになります \(クラス名のみ異なります\)。  
+  
+```  
+[GeneratedCodeAttribute("System.Runtime.Serialization", "3.0.0.0")]  
+[System.Xml.Serialization.XmlSchemaProviderAttribute("ExportSchema")]  
+[System.Xml.Serialization.XmlRootAttribute(IsNullable=false)]  
+public partial class Person : object, IXmlSerializable  
+{    
+  private XmlNode[] nodesField;    
+  private static XmlQualifiedName typeName =   
+new XmlQualifiedName("Person","http://Microsoft.ServiceModel.Samples");    
+  public XmlNode[] Nodes  
+  {  
+    get {return this.nodesField;}  
+    set {this.nodesField = value;}  
+  }    
+  public void ReadXml(XmlReader reader)  
+  {  
+    this.nodesField = XmlSerializableServices.ReadNodes(reader);  
+  }    
+  public void WriteXml(XmlWriter writer)  
+  {  
+    XmlSerializableServices.WriteNodes(writer, this.Nodes);  
+  }    
+  public System.Xml.Schema.XmlSchema GetSchema()  
+  {  
+    return null;  
+  }    
+  public static XmlQualifiedName ExportSchema(XmlSchemaSet schemas)  
+  {  
+    XmlSerializableServices.AddDefaultSchema(schemas, typeName);  
+    return typeName;  
+  }  
+}  
+```  
+  
+## DateTimeOffset のシリアル化  
+ <xref:System.DateTimeOffset> はプリミティブ型としては扱われません。 その代わりに、2 つの部分から成る複合型要素としてシリアル化されます。 最初の部分は日時を表し、2 番目の部分は日時からのオフセットを表します。 次のコード例に、シリアル化された DateTimeOffset 値を示します。  
+  
+```  
+<OffSet xmlns:a="http://schemas.datacontract.org/2004/07/System">  
+  <DateTime i:type="b:dateTime"   
+    xmlns:b="http://www.w3.org/2001/XMLSchema">2008-08-28T08:00:00    
+  </DateTime>   
+  <OffsetMinutes i:type="b:short"   
+   xmlns:b="http://www.w3.org/2001/XMLSchema">-480  
+   </OffsetMinutes>   
+</OffSet>  
+```  
+  
+ スキーマは次のとおりです。  
+  
+```  
+<xs:schema targetNamespace="http://schemas.datacontract.org/2004/07/System">  
+   <xs:complexType name="DateTimeOffset">  
+      <xs:sequence minOccurs="1" maxOccurs="1">  
+         <xs:element name="DateTime" type="xs:dateTime"  
+         minOccurs="1" maxOccurs="1" />  
+         <xs:elementname="OffsetMinutes" type="xs:short"  
+         minOccurs="1" maxOccurs="1" />  
+      </xs:sequence>  
+   </xs:complexType>  
+</xs:schema>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ <xref:System.Runtime.Serialization.XsdDataContractImporter>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-serializer.md b/docs/framework/wcf/feature-details/data-contract-serializer.md
new file mode 100644
index 00000000000..09d08ea718b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-serializer.md
@@ -0,0 +1,49 @@
+---
+title: "データ コントラクト シリアライザー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], シリアライザー"
+  - "DataContractSerializer"
+  - "WCF, データ"
+ms.assetid: 3d64837e-0a0c-4cc8-90ff-a5c6f313c63a
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# データ コントラクト シリアライザー
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] インフラストラクチャでは、<xref:System.Runtime.Serialization.DataContractSerializer> クラスを既定のシリアライザーとして使用します。このセクションの各トピックでは、これをスタンドアロンのシリアライザーとして使用するときの詳細について説明します。  
+  
+## このセクションの内容  
+ [シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)  
+ <xref:System.Runtime.Serialization.DataContractSerializer> クラスを使用してオブジェクト グラフをシリアル化したり、XML ドキュメントをオブジェクトに逆シリアル化したりする方法を詳細に説明します。  
+  
+ [スキーマのインポートとエクスポート](../../../../docs/framework/wcf/feature-details/schema-import-and-export.md)  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] クラスから XML スキーマ定義言語 \(XSD: XML Schema Definition Language\) スキーマを生成する方法、また XSD スキーマ ドキュメントからコードを生成する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Runtime.Serialization.DataContractSerializer>  
+  
+ <xref:System.Runtime.Serialization.NetDataContractSerializer>  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute>  
+  
+ <xref:System.Runtime.Serialization.DataMemberAttribute>  
+  
+## 関連項目  
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)  
+  
+ [データ転送とシリアル化](../../../../docs/framework/wcf/feature-details/data-transfer-and-serialization.md)  
+  
+## 参照  
+ [データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)   
+ [サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-contract-versioning.md b/docs/framework/wcf/feature-details/data-contract-versioning.md
new file mode 100644
index 00000000000..36982980ec2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-contract-versioning.md
@@ -0,0 +1,138 @@
+---
+title: "データ コントラクトのバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], バージョン管理"
+  - "バージョン管理 [WCF]"
+  - "バージョン管理 [WCF], データ コントラクト"
+ms.assetid: 4a0700cb-5f5f-4137-8705-3a3ecf06461f
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# データ コントラクトのバージョン管理
+アプリケーションの進化に伴って、サービスが使用するデータ コントラクトを変更することが必要になる場合があります。  ここでは、データ コントラクトをバージョン管理する方法について説明します。  データ コントラクトのバージョン管理のメカニズムについても説明します。  バージョン管理全般の概要および規範となるガイダンスについては、「[ベスト プラクティス : データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md)」を参照してください。  
+  
+## 互換性に影響する変更と影響しない変更  
+ データ コントラクトへの変更には、互換性に影響するものと影響しないものとがあります。  互換性に影響しない方法でデータ コントラクトを変更すると、古いバージョンのコントラクトを使用するアプリケーションは新しいバージョンを使用するアプリケーションと通信できます。また、新しいバージョンを使用するアプリケーションも古いバージョンを使用するアプリケーションと通信できます。  一方、互換性に影響する変更では、一方向または双方向で通信できなくなります。  
+  
+ 型を変更してもその送受信方法に影響しない場合は、互換性に影響しない変更と呼びます。  このような変更では、データ コントラクトは変更されず、基になる型のみが変更されます。  たとえば、フィールドの名前を変更した後で <xref:System.Runtime.Serialization.DataMemberAttribute.Name%2A> の <xref:System.Runtime.Serialization.DataMemberAttribute> プロパティを以前のバージョン名に設定すれば、互換性に影響しません。  次のコードに、バージョン 1 のデータ コントラクトを示します。  
+  
+ [!code-csharp[C_DataContractVersioning#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractversioning/cs/source.cs#1)]
+ [!code-vb[C_DataContractVersioning#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractversioning/vb/source.vb#1)]  
+  
+ 互換性に影響しない変更を次のコードに示します。  
+  
+ [!code-csharp[C_DataContractVersioning#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractversioning/cs/source.cs#2)]
+ [!code-vb[C_DataContractVersioning#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractversioning/vb/source.vb#2)]  
+  
+ 変更によっては、送信されるデータを変更しても、必ずしも互換性に影響しない場合もあります。  次の変更は常に互換性に影響します。  
+  
+-   データ コントラクトの <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> 値または <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A> 値の変更。  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> の <xref:System.Runtime.Serialization.DataMemberAttribute> プロパティを使用したデータ メンバーの順序の変更。  
+  
+-   データ メンバーの名前の変更。  
+  
+-   データ メンバーのデータ コントラクトの変更   \(たとえば、データ メンバーの型を整数型から文字列型に変更したり、"Customer" という名前のデータ コントラクトを持つ型を "Person" という名前のデータ コントラクトを持つ型に変更したりするなど\)。  
+  
+ 以下のような変更も考えられます。  
+  
+## データ メンバーの追加と削除  
+ 厳密なスキーマ検証 \(古いスキーマに基づく新しいインスタンスの検証\) が必要ではない限り、多くの場合、データ メンバーの追加または削除は互換性に影響する変更ではありません。  
+  
+ 追加のフィールドを持つ型が、そのフィールドを持たない型に逆シリアル化された場合、追加のフィールドにある情報は無視されます   \(ラウンド トリップのために、この情報が保存される場合もあります。詳細については、「[上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」を参照してください\)。  
+  
+ 一部のフィールドが足りない型が、追加のフィールドを持つ型に逆シリアル化された場合、追加のフィールドは既定値 \(通常はゼロまたは `null`\) のままになります   \(既定値は変更される場合があります。詳細については、「[バージョン トレラントなシリアル化コールバック](../../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)」を参照してください\)。  
+  
+ たとえば、クライアントで `CarV1` クラスを使用し、サービスで `CarV2` クラスを使用することも、サービスで `CarV1` クラスを使用し、クライアントで `CarV2` クラスを使用することもできます。  
+  
+ [!code-csharp[C_DataContractVersioning#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractversioning/cs/source.cs#3)]
+ [!code-vb[C_DataContractVersioning#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractversioning/vb/source.vb#3)]  
+  
+ バージョン 2 のエンドポイントからバージョン 1 のエンドポイントに正常にデータを送信できます。  `Car` データ コントラクトのバージョン 2 をシリアル化すると、次のような XML が生成されます。  
+  
+```  
+<Car>  
+    <Model>Porsche</Model>  
+    <HorsePower>300</HorsePower>  
+</Car>  
+```  
+  
+ バージョン 1 の逆シリアル化エンジンでは、`HorsePower` フィールドに一致するデータ メンバーを見つけられないため、データは破棄されます。  
+  
+ また、バージョン 1 のエンドポイントからバージョン 2 のエンドポイントにデータを送信することもできます。  `Car` データ コントラクトのバージョン 1 をシリアル化すると、次のような XML が生成されます。  
+  
+```  
+<Car>  
+    <Model>Porsche</Model>  
+</Car>  
+```  
+  
+ 受信 XML に一致するデータがないため、バージョン 2 のデシリアライザーでは `HorsePower` フィールドを何に設定するのか判別できません。  そのため、このフィールドには既定値である 0 が設定されます。  
+  
+## 必須データ メンバー  
+ <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> の <xref:System.Runtime.Serialization.DataMemberAttribute> プロパティを `true` に設定すると、データ メンバーを必須のデータ メンバーとしてマークできます。  逆シリアル化中に必須データがない場合、データ メンバーは既定値に設定されず、代わりに例外がスローされます。  
+  
+ 必須のデータ メンバーの追加は、互換性に影響する変更です。  つまり、新しい型を古い型のエンドポイントに送信することはできますが、その逆はできなくなります。  以前のバージョンで必須としてマークされていたデータ メンバーを削除することも、互換性に影響する変更です。  
+  
+ <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティの値を `true` から `false` に変更することは互換性に影響しませんが、`false` から `true` に変更すると、これよりも以前のいずれかのバージョンの型にこのデータ メンバーが存在していない場合、互換性に影響することがあります。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティが `true` に設定されていても、受信データは NULL またはゼロの場合があるので、型ではこの可能性を処理できるようにしておく必要があります。  不適切な受信データに対するセキュリティ保護メカニズムとして <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> を使用しないでください。  
+  
+## 既定値の省略  
+ 「[データ メンバーの既定値](../../../../docs/framework/wcf/feature-details/data-member-default-values.md)」で説明したように、DataMemberAttribute 属性の `EmitDefaultValue` プロパティを `false` に設定できます \(ただし、この設定はお勧めしません\)。  このプロパティが `false` に設定されている場合、データ メンバーが既定値 \(通常 NULL またはゼロ\) に設定されていても、そのデータ メンバーは出力されません。  これにより、次の 2 つの点で、異なるバージョンの必須データ メンバーの互換性が失われます。  
+  
+-   あるバージョンで必須になっているデータ メンバーを持つデータ コントラクトは、データ メンバーの `EmitDefaultValue` が `false` に設定されている別のバージョンから既定 \(NULL またはゼロ\) のデータを受信できません。  
+  
+-   `EmitDefaultValue` が `false` に設定されている必須データ メンバーは、既定値 \(NULL またはゼロ\) をシリアル化で使用できませんが、逆シリアル化ではこのような値を受信できます。  これによりラウンド トリップの問題が発生します \(データを読み取ることはできますが、書き込むことができません\)。  そのため、あるバージョンにおいて `IsRequired` が `true` であり、`EmitDefaultValue` が `false` である場合、どのバージョンのデータ コントラクトにおいてもラウンド トリップを発生させる値を生成できるように、これ以外のすべてのバージョンに同じ組み合わせを適用する必要があります。  
+  
+## スキーマの考慮事項  
+ データ コントラクト型用に生成されるスキーマについては、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。  
+  
+ データ コントラクト型用に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が生成するスキーマは、バージョン管理に対応していません。  つまり、あるバージョンの型からエクスポートされたスキーマには、そのバージョンに存在するデータ メンバーのみが含まれます。  <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装しても、型のスキーマは変更されません。  
+  
+ データ メンバーは、既定でオプション要素としてスキーマにエクスポートされます。  つまり、`minOccurs` \(XML 属性\) の値は 0 に設定されています。  `minOccurs` を 1 に設定した場合、必須データ メンバーがエクスポートされます。  
+  
+ スキーマを厳密に遵守する必要がある場合、互換性に影響しないと思われる変更の多くが、実際には互換性に影響します。  前述の例では、`CarV1` 要素だけを持つ `Model` インスタンスは、`CarV2` スキーマ \(`Model` と `Horsepower` の 2 つの要素を持ちますが、いずれも省略可能です\) に対して有効です。  しかし、この逆は真ではありません。つまり、`CarV2` インスタンスは `CarV1` スキーマに対して検証が失敗します。  
+  
+ ラウンド トリップにもいくつかの考慮事項があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」の「スキーマの考慮事項」のセクションを参照してください。  
+  
+### 許可されるその他の変更  
+ <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスの実装は、互換性に影響しない変更です。  ただし、<xref:System.Runtime.Serialization.IExtensibleDataObject> が実装されていた型のバージョンより前のバージョンでは、ラウンド トリップはサポートされていません。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」を参照してください。  
+  
+## 列挙  
+ 列挙体メンバーの追加や削除は、互換性に影響する変更です。  `EnumMemberAtttribute` 属性を使用して古いバージョンのコントラクト名を保持しない限り、列挙体メンバーの名前の変更は互換性に影響します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[データ コントラクトの列挙型](../../../../docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md)」を参照してください。  
+  
+## コレクション  
+ コレクション型の大半はデータ コントラクト モデル内で交換可能であるため、多くの場合、コレクションの変更は互換性に影響しません。  ただし、カスタマイズされていないコレクションからカスタマイズされたコレクションへの変更またはその逆の変更は、互換性に影響する変更です。  また、コレクションのカスタマイズ設定の変更 \(データ コントラクトの名前と名前空間の変更、要素名、キー要素名、および値要素名の反復\) も互換性に影響します。  コレクションのカスタマイズ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[データ コントラクトのコレクション型](../../../../docs/framework/wcf/feature-details/collection-types-in-data-contracts.md)」を参照してください。    
+また、コレクションの内容のデータ コントラクトの変更 \(整数のリストから文字列のリストへの変更など\) は互換性に影響する変更です。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataMemberAttribute.Name%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A>   
+ <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A>   
+ <xref:System.Runtime.Serialization.SerializationException>   
+ <xref:System.Runtime.Serialization.IExtensibleDataObject>   
+ [バージョン トレラントなシリアル化コールバック](../../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)   
+ [ベスト プラクティス : データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md)   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-member-default-values.md b/docs/framework/wcf/feature-details/data-member-default-values.md
new file mode 100644
index 00000000000..b06fdec2520
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-member-default-values.md
@@ -0,0 +1,65 @@
+---
+title: "データ メンバーの既定値 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ メンバー [WCF]"
+  - "データ メンバー [WCF], 既定値"
+ms.assetid: 53a3b505-4b27-444b-b079-0eb84a97cfd8
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# データ メンバーの既定値
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、型に*既定値*の概念があります。たとえば、参照型の既定値は `null` で、整数型の既定値は 0 です。しかし、データ メンバーが既定値に設定されている場合は、シリアル化されたデータからそのデータ メンバーを省略することが望ましいことがあります。それは、メンバーが既定値に設定されているために実際の値をシリアル化する必要がなく、パフォーマンスの点で有利だからです。  
+  
+ シリアル化されたデータからデータ メンバーを省略するには、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性の <xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> プロパティを `false` に設定します \(既定値は `true`\)。  
+  
+> [!NOTE]
+>  相互運用性の維持やデータ サイズの縮小のような特別なニーズがある場合は、<xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> を `false` に設定する必要があります。  
+  
+## 例  
+ 次のコードには、<xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> が `false` に設定された複数のメンバーが含まれています。  
+  
+ [!code-csharp[DataMemberAttribute#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/datamemberattribute/cs/overview.cs#4)]
+ [!code-vb[DataMemberAttribute#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/datamemberattribute/vb/overview.vb#4)]  
+  
+ このクラスのインスタンスをシリアル化すると、次に示すように `employeeName` と `employeeID` がシリアル化されます。`employeeName` の null 値と `employeeID` の値 0 は、シリアル化されるデータに明示的に含められます。ただし、`position`、`salary`、および `bonus` のメンバーはシリアル化されません。また、<xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> プロパティは `false` に設定されていますが、57800 が .NET の整数の既定値 \(0\) と一致しないため、`targetSalary` が通常どおりにシリアル化されます。  
+  
+### XML 表現  
+ 前の例を XML にシリアル化すると、生成される XML 表現は次のようになります。  
+  
+```  
+<Employee>  
+   <employeeName xsi:nil="true" />  
+   <employeeID>0</employeeID>  
+<targetSalary>57800</targetSalary>  
+</Employee>  
+```  
+  
+ `xsi:nil` 属性は W3C \(World Wide Web Consortium\) XML スキーマ インスタンス名前空間の特別な属性であり、null 値を明示的に表すための相互運用可能な方法を提供します。この XML には、地位、給与、ボーナスの各データ メンバーに関する情報がまったく含まれていないことに注目してください。これらのデータ メンバーは、受信エンドポイントで、それぞれ `null`、0、および `null` として解釈します。これらをサードパーティ製のデシリアライザーで正しく解釈できる保証はないため、このパターンはお勧めしません。<xref:System.Runtime.Serialization.DataContractSerializer> クラスを使用すると、値が指定されていない場合でも、常に正しい解釈が選択されます。  
+  
+### IsRequired との対話  
+ 「[データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md)」で説明されているように、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性には <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> プロパティ \(既定値は `false`\) があります。このプロパティは、シリアル化されたデータを逆シリアル化する際に、指定されたデータ メンバーが存在する必要があるかどうかを示します。`IsRequired` が `true` \(値が存在する必要がある\) に設定され、<xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> が `false` \(既定値に設定されている場合は、値が存在する必要がない\) に設定されている場合は、結果が矛盾するため、このデータ メンバーの既定値をシリアル化できません。このようなデータ メンバーを既定値 \(通常は `null` または 0\) に設定してシリアル化を実行すると、<xref:System.Runtime.Serialization.SerializationException> がスローされます。  
+  
+### スキーマ表現  
+ `EmitDefaultValue` プロパティを `false` に設定したときのデータ メンバーの XML スキーマ定義言語 \(XSD: XML Schema Definition Language\) スキーマ表現の詳細については、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。以下に、その概要を簡単に説明します。  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> を `false` に設定すると、スキーマでは [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に固有の注釈として表現されます。この情報を表すための相互運用可能な方法はありません。特に、スキーマにおける "default" 属性はこの目的では使用されません。また、`minOccurs` 属性は <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> 設定だけに影響され、`nillable` 属性はデータ メンバーの型だけに影響されます。  
+  
+-   使用される実際の既定値は、スキーマには存在しません。指定されていない要素が適切に解釈されるかどうかは、受信エンドポイントに依存します。  
+  
+ スキーマのインポートでは、前述の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に固有の注釈が検出されるたびに <xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> プロパティが自動的に `false` に設定されます。また、このプロパティは、一般に [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスを使用したときに発生する特定の相互運用シナリオをサポートするために、`nillable` プロパティが `false` に設定されている参照型に対しても、`false` に設定されます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-member-order.md b/docs/framework/wcf/feature-details/data-member-order.md
new file mode 100644
index 00000000000..f660237ec87
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-member-order.md
@@ -0,0 +1,72 @@
+---
+title: "データ メンバーの順序 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], メンバーの順序"
+ms.assetid: 0658a47d-b6e5-4ae0-ba72-ababc3c6ff33
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# データ メンバーの順序
+一部のアプリケーションでは、各種のデータ メンバーから送信される、または受信されると予想できるデータの順序 \(たとえばシリアル化された XML でデータが表れる順序\) がわかると便利です。この順序を変更する必要が生じることもあります。ここでは、このような順序を決定する規則について説明します。  
+  
+## 基本的な規則  
+ データの順序を決定する基本的な規則には、次のようなものがあります。  
+  
+-   データ コントラクト型が継承階層の一部である場合、その基本型のデータ メンバーが常に最初の順番になります。  
+  
+-   次に来るのは <xref:System.Runtime.Serialization.DataMemberAttribute> 属性の <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> プロパティが設定されていない、現在の型のデータ メンバー \(アルファベット順\) になります。  
+  
+-   その次に来るのは、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性の <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> プロパティが設定されているすべてのデータ メンバーです。これらのデータ メンバーはまず `Order` プロパティの値によって並べられ、次に特定の `Order` 値を持つメンバーが複数ある場合は、そのアルファベット順に並びます。Order 値はスキップされることがあります。  
+  
+ アルファベット順は、<xref:System.String.CompareOrdinal%2A> メソッドを呼び出すことによって確立されます。  
+  
+## 例  
+ 次のコードについて考えてみましょう。  
+  
+ [!code-csharp[C_DataContractNames#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractnames/cs/source.cs#4)]
+ [!code-vb[C_DataContractNames#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractnames/vb/source.vb#4)]  
+  
+ 作成される XML は、次のようになります。  
+  
+```  
+<DerivedType>  
+    <!-- Zebra is a base data member, and appears first. -->  
+    <zebra/>   
+  
+    <!-- Cat has no Order, appears alphabetically first. -->  
+    <cat/>  
+  
+   <!-- Dog has no Order, appears alphabetically last. -->  
+    <dog/>   
+  
+    <!-- Bird is the member with the smallest Order value -->  
+    <bird/>  
+  
+    <!-- Albatross has the next Order value, alphabetically first. -->  
+    <albatross/>  
+  
+    <!-- Parrot, with the next Order value, alphabetically last. -->  
+     <parrot/>  
+  
+    <!-- Antelope is the member with the highest Order value. Note that   
+    Order=2 is skipped -->  
+     <antelope/>   
+</DerivedType>  
+```  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ [データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-transfer-and-serialization.md b/docs/framework/wcf/feature-details/data-transfer-and-serialization.md
new file mode 100644
index 00000000000..f3c772be070
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-transfer-and-serialization.md
@@ -0,0 +1,72 @@
+---
+title: "データ転送とシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ シリアル化 [WCF]"
+  - "データ転送 [WCF]"
+ms.assetid: 0f03c635-f3e7-4c5c-9463-3cb0135e221e
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# データ転送とシリアル化
+接続されたシステムでは、サービスとクライアントのタスクの実行は、データの交換に依存します。サービスやクライアントの開発者は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のデータ処理方法とデータのシリアル化を理解して、効果的で保守しやすいアプリケーションを作成する必要があります。  
+  
+## このセクションの内容  
+ [サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)  
+ サービスでのデータ転送の基本的な概念について説明します。  
+  
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)  
+ データ コントラクトの定義と、その作成方法と使用方法について説明します。  
+  
+ [データ コントラクト シリアライザー](../../../../docs/framework/wcf/feature-details/data-contract-serializer.md)  
+ <xref:System.Runtime.Serialization.DataContractSerializer> クラス、または <xref:System.Runtime.Serialization.XmlObjectSerializer> クラスの拡張機能で、データのシリアル化を実行する方法について説明します。  
+  
+ [XmlSerializer クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-xmlserializer-class.md)  
+ <xref:System.Runtime.Serialization.DataContractSerializer> クラスの代わりに、<xref:System.Xml.Serialization.XmlSerializer> クラスを使う方法とその理由について説明します。  
+  
+ [メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md)  
+ メッセージ コントラクトで SOAP メッセージを詳細に制御する方法について説明します。  
+  
+ [メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)  
+ メッセージ クラス機能の使用方法について説明します。  
+  
+ [フィルター処理](../../../../docs/framework/wcf/feature-details/filtering.md)  
+ 各種の条件に基づいて、メッセージを事前処理できるフィルター処理について説明します。  
+  
+ [大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)  
+ バイナリ ファイルなど、大きなデータ ブロックを送信する方法について説明します。  
+  
+ [セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)  
+ データの転送とシリアル化をプログラムするときに注意する必要のある項目について説明します。  
+  
+ [データ転送のアーキテクチャの概要](../../../../docs/framework/wcf/feature-details/data-transfer-architectural-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] におけるデータ転送の全般的な設計について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer>  
+  
+ <xref:System.Xml.Serialization.XmlSerializer>  
+  
+ <xref:System.Runtime.Serialization>  
+  
+ <xref:System.Xml.Serialization>  
+  
+## 関連項目  
+ [エンコーダーとシリアライザーの拡張](../../../../docs/framework/wcf/extending/extending-encoders-and-serializers.md)  
+  
+## 参照  
+ [ベスト プラクティス : データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md)   
+ [サービスのバージョン管理](../../../../docs/framework/wcf/service-versioning.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/data-transfer-architectural-overview.md b/docs/framework/wcf/feature-details/data-transfer-architectural-overview.md
new file mode 100644
index 00000000000..fa1a82b3460
--- /dev/null
+++ b/docs/framework/wcf/feature-details/data-transfer-architectural-overview.md
@@ -0,0 +1,280 @@
+---
+title: "データ転送のアーキテクチャの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ転送 [WCF], アーキテクチャの概要"
+ms.assetid: 343c2ca2-af53-4936-a28c-c186b3524ee9
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# データ転送のアーキテクチャの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、一種のメッセージング インフラストラクチャと考えることができます。 WCF は、メッセージを受信し、それらのメッセージを処理し、さらにアクションを実行するためにユーザー コードにディスパッチすることができます。また、ユーザー コードで指定されたデータからメッセージを作成し、送信先に配布することもできます。 ここでは、メッセージを処理するためのアーキテクチャと格納されるデータについて説明します。このトピックは、上級開発者を対象としています。 データを送受信する方法のより簡単なタスク指向の概要については、「[サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。  
+  
+> [!NOTE]
+>  ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] オブジェクト モデルを調べても明らかにはならない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装の詳細について説明します。 文書化された実装の詳細について、2 つの注意事項があります。 1 つは、説明が簡略化されているという点です。実際の実装は、最適化やその他の理由から、より複雑であることが考えられます。 もう 1 つの注意事項として、特定の実装の詳細が文書化されていても、その詳細に依存しないようにしてください。これらの詳細は、バージョン間で予告なしに変更されることがあるからです。これは、サービス リリースにおいても同様です。  
+  
+## 基本アーキテクチャ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ処理機能の中核となるのは、<xref:System.ServiceModel.Channels.Message> クラスです。このクラスの詳細については、「[メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)」を参照してください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のランタイム コンポーネントは、チャネル スタックとサービス フレームワークという 2 つの主要部分に分けることができ、<xref:System.ServiceModel.Channels.Message> クラスがコネクション ポイントになります。  
+  
+ チャネル スタックは、有効な <xref:System.ServiceModel.Channels.Message> インスタンスと、メッセージ データの送信または受信に対応するアクションとの間の変換を行います。 送信側のチャネル スタックは、有効な <xref:System.ServiceModel.Channels.Message> インスタンスを取得し、何らかの処理を行った後、メッセージの送信に論理的に対応するアクションを実行します。 このアクションには、TCP パケットまたは HTTP パケットの送信、メッセージ キューへのメッセージの配置、データベースへのメッセージの書き込み、ファイル共有へのメッセージの保存、実装によって異なるその他のアクションなどがあります。 最も一般的なアクションは、ネットワーク プロトコル上でのメッセージの送信です。 受信側では、この逆のことが行われます。つまり、アクション \(TCP パケットまたは HTTP パケットの到着の場合もあれば、その他のアクションの場合もあります\) が検出され、チャネル スタックが処理を行った後に、このアクションを有効な <xref:System.ServiceModel.Channels.Message> インスタンスに変換します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クラスとチャネル スタックを直接使用して、<xref:System.ServiceModel.Channels.Message> を使用できます。 ただし、この作業は困難であり、時間もかかります。 また、<xref:System.ServiceModel.Channels.Message> オブジェクトはメタデータをサポートしていないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をこのように使用した場合、厳密に型指定された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成することはできません。  
+  
+ そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、`Message` オブジェクトの構築と受信に使用できる使いやすいプログラミング モデルを提供するサービス フレームワークが用意されています。 サービス フレームワークは、サービス コントラクトの概念によってサービスを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型にマップし、<xref:System.ServiceModel.OperationContractAttribute> 属性でマークされた [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メソッドであるユーザー操作にメッセージをディスパッチします \(詳細については、「[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください\)。 これらのメソッドは、パラメーターと戻り値を持つことができます。 サービス側では、サービス フレームワークが受信 <xref:System.ServiceModel.Channels.Message> インスタンスをパラメーターに変換し、戻り値を送信 <xref:System.ServiceModel.Channels.Message> インスタンスに変換します。 クライアント側では、この逆のことが行われます。 たとえば、次のような `FindAirfare` の操作について考えてみます。  
+  
+ [!code-csharp[c_DataArchitecture#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#1)]
+ [!code-vb[c_DataArchitecture#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#1)]  
+  
+ クライアントで `FindAirfare` が呼び出されたとします。 クライアントのサービス フレームワークは、`FromCity` パラメーターと `ToCity` パラメーターを送信 <xref:System.ServiceModel.Channels.Message> インスタンスに変換し、これをチャネル スタックに渡して送信します。  
+  
+ サービス側では、チャネル スタックから <xref:System.ServiceModel.Channels.Message> インスタンスが到着すると、サービス フレームワークがメッセージから関連データを抽出して `FromCity` パラメーターと `ToCity` パラメーターを設定し、サービス側の `FindAirfare` メソッドを呼び出します。 メソッドから制御が戻ると、サービス フレームワークは、返された整数値と `IsDirectFlight` 出力パラメーターを取得し、この情報を格納する <xref:System.ServiceModel.Channels.Message> オブジェクトのインスタンスを作成します。 次に、この `Message` インスタンスをチャネル スタックに渡して、クライアントに返送します。  
+  
+ クライアント側では、応答メッセージが格納された <xref:System.ServiceModel.Channels.Message> インスタンスが、チャネル スタックから取り出されます。 サービス フレームワークは、戻り値と `IsDirectFlight`  値を抽出し、これらをクライアントの呼び出し元に返します。  
+  
+## Message クラス  
+ <xref:System.ServiceModel.Channels.Message> クラスはメッセージの抽象表現を意図したものですが、そのデザインは SOAP メッセージと密接に関連しています。<xref:System.ServiceModel.Channels.Message> には、情報の 3 つの主要部分であるメッセージ本文、メッセージ ヘッダー、およびメッセージ プロパティが含まれます。  
+  
+## メッセージ本文  
+ メッセージ本文は、メッセージの実際のデータ ペイロードを表すためのものです。 メッセージ本文は、常に XML Infoset として表されます。 これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で作成または受信されるすべてのメッセージが XML 形式でなければならないということではありません。 メッセージ本文を解釈する方法を決定するのはチャネル スタックです。 チャネル スタックは、メッセージ本文を XML として出力する場合もあれば、他の形式に変換する場合もあります。また、メッセージ本文を完全に除外する場合もあります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供されるほとんどのバインディングでは、メッセージ本文は SOAP エンベロープの body セクションに XML コンテンツとして表されます。  
+  
+ `Message` クラスは、本文を表す XML データを保持するバッファーを必ずしも含むわけではないことを認識しておくことが重要です。`Message` には XML Infoset が論理的に含まれますが、この Infoset は動的に構築可能であると同時に、メモリ内に物理的に存在することはありません。  
+  
+### メッセージ本文へのデータの配置  
+ メッセージ本文にデータを配置するための統一された機構はありません。<xref:System.ServiceModel.Channels.Message> クラスには、抽象メソッド <xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%28System.Xml.XmlDictionaryWriter%29> があります。このメソッドは、<xref:System.Xml.XmlDictionaryWriter> を取得します。<xref:System.ServiceModel.Channels.Message> クラスの各サブクラスは、このメソッドをオーバーライドし、独自のコンテンツを書き込む必要があります。 メッセージ本文には、`OnWriteBodyContent` によって生成された XML Infoset が論理的に含まれます。 たとえば、次のような `Message` サブクラスについて考えてみます。  
+  
+ [!code-csharp[c_DataArchitecture#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#2)]
+ [!code-vb[c_DataArchitecture#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#2)]  
+  
+ 物理的には、`AirfareRequestMessage` インスタンスには 2 つの文字列 \("fromCity" と "toCity"\) しか含まれていません。 ただし、このメッセージには、次のような XML Infoset が論理的に含まれています。  
+  
+```  
+<airfareRequest>  
+    <from>Tokyo</from>  
+    <to>London</to>  
+</airfareRequest>  
+```  
+  
+ もちろん、このようにメッセージを作成することは、通常はありません。上記のようなメッセージは、サービス フレームワークを使用して、操作コントラクト パラメーターから作成できるためです。 さらに、<xref:System.ServiceModel.Channels.Message> クラスには、静的 `CreateMessage` メソッドもあります。このメソッドを使用すると、一般的な種類の内容を含むメッセージ \(空のメッセージ、<xref:System.Runtime.Serialization.DataContractSerializer> によって XML にシリアル化されたオブジェクトを含むメッセージ、SOAP エラーを含むメッセージ、<xref:System.Xml.XmlReader> によって表された XML を含むメッセージなど\) を作成できます。  
+  
+### メッセージ本文からのデータの取得  
+ メッセージ本文に格納されたデータは、主に次の 2 とおりの方法で抽出できます。  
+  
+-   <xref:System.ServiceModel.Channels.Message.WriteBodyContents%28System.Xml.XmlDictionaryWriter%29> メソッドを呼び出し、XML ライターに渡すことにより、メッセージ本文全体を一度に取得できます。 メッセージ本文全体がこのライターに書き込まれます。 メッセージ本文全体を一度に取得することを、*メッセージの書き込み*とも呼びます。 書き込みは、メッセージの送信時に主にチャネル スタックによって実行されます。チャネル スタックには、通常、メッセージ本文全体にアクセスし、本文全体をエンコードして送信する部分があります。  
+  
+-   メッセージ本文から情報を取得するもう 1 つの方法は、<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents> を呼び出し、XML リーダーを取得する方法です。 リーダーでメソッドを呼び出すことにより、必要に応じてメッセージ本文に順次アクセスできます。 メッセージ本文を少しずつ取得することを、*メッセージの読み取り*とも呼びます。 メッセージの読み取りは、メッセージの受信時にサービス フレームワークによって主に使用されます。 たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> の使用時に、サービス フレームワークは本文で XML リーダーを取得し、逆シリアル化エンジンに渡します。逆シリアル化エンジンは、要素単位でメッセージを読み取り、対応するオブジェクト グラフの構築を開始します。  
+  
+ メッセージ本文を取得できるのは一度だけです。 これにより、転送専用ストリームを使用することが可能になります。 たとえば、<xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%28System.Xml.XmlDictionaryWriter%29> から読み取り、XML Infoset として結果を返す <xref:System.IO.FileStream> のオーバーライドを作成できます。 ファイルの先頭まで "巻き戻す" 必要はありません。  
+  
+ `WriteBodyContents` メソッドと `GetReaderAtBodyContents` メソッドは、メッセージ本文がこれまで一度も取得されていないことを簡単にチェックした後、それぞれ `OnWriteBodyContents` と `OnGetReaderAtBodyContents` を呼び出します。  
+  
+## WCF でのメッセージの使用  
+ ほとんどのメッセージは、*送信* \(チャネル スタックによって送信するために、サービス フレームワークが作成するメッセージ\) または*受信* \(チャネル スタックから到着し、サービス フレームワークが解釈するメッセージ\) のいずれかに分類できます。 さらに、チャネル スタックは、バッファー モードまたはストリーミング モードで動作できます。 また、サービス フレームワークが、ストリーム プログラミング モデルを公開する場合もあれば、非ストリーム プログラミング モデルを公開する場合もあります。 この結果として生じるケースと、その実装の簡略化した詳細を次の表に示します。  
+  
+|メッセージの種類|メッセージの本文データ|書き込み \(OnWriteBodyContents\) 実装|読み取り \(OnGetReaderAtBodyContents\) 実装|  
+|--------------|-----------------|-------------------------------------|-------------------------------------------|  
+|送信 \(非ストリーム プログラミング モデルから作成\)|メッセージの書き込みに必要なデータ \(例 : オブジェクトとそのシリアル化に必要な <xref:System.Runtime.Serialization.DataContractSerializer> インスタンス\)\*|格納されたデータに基づいてメッセージを書き込むためのカスタム ロジック \(例 : `WriteObject` を使用している場合に、このシリアライザーで `DataContractSerializer` を呼び出す\)\*|`OnWriteBodyContents` を呼び出し、結果をバッファーに保持し、バッファーで XML リーダーを返します。|  
+|送信 \(ストリーム プログラミング モデルから作成\)|書き込むデータを含む `Stream`\*|<xref:System.Xml.IStreamProvider> 機構を使用して、格納されたストリームからデータを書き込みます\*。|`OnWriteBodyContents` を呼び出し、結果をバッファーに保持し、バッファーで XML リーダーを返します。|  
+|ストリーミング チャネル スタックからの受信|ネットワーク上で到着したデータを表す `Stream` オブジェクトと、このオブジェクトに配置された <xref:System.Xml.XmlReader>|`XmlReader` を使用して、格納された `WriteNode` からコンテンツを書き込みます。|格納された `XmlReader` を返します。|  
+|非ストリーミング チャネル スタックからの受信|本文データを格納するバッファーと、このバッファーに配置された `XmlReader`|`XmlReader` を使用して、格納された `WriteNode` からコンテンツを書き込みます。|格納された lang を返します。|  
+  
+ \* これらの項目は、`Message` サブクラスに直接実装されるのではなく、<xref:System.ServiceModel.Channels.BodyWriter> クラスのサブクラスに実装されます。<xref:System.ServiceModel.Channels.BodyWriter> の詳細については、「[メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)」を参照してください。  
+  
+## メッセージ ヘッダー  
+ メッセージには、ヘッダーを含めることができます。 ヘッダーは、名前、名前空間、および他の複数のプロパティに関連付けられた XML Infoset で論理的に構成されます。 メッセージ ヘッダーには、`Headers` の <xref:System.ServiceModel.Channels.Message> プロパティを使用してアクセスします。 各ヘッダーは、<xref:System.ServiceModel.Channels.MessageHeader> クラスによって表されます。 通常、SOAP メッセージを使用するように構成されたチャネル スタックを使用している場合、メッセージ ヘッダーは SOAP メッセージ ヘッダーにマップされます。  
+  
+ メッセージ ヘッダーへの情報の配置と、メッセージ ヘッダーからの情報の抽出は、メッセージ本文を使用する場合と似ています。 ストリーミングがサポートされていないため、プロセスは若干簡略化されます。 ヘッダーは常に強制的にバッファーに保持されるため、同じヘッダーの内容に何度もアクセスすることが可能であり、各ヘッダーに任意の順序でアクセスできます。 ヘッダーで XML リーダーを取得するために使用できる汎用の機構はありませんが、このような機能を備えた読み取り可能なヘッダーを表す `MessageHeader` サブクラスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の内部に存在します。 この種の `MessageHeader` は、カスタム アプリケーション ヘッダーを持つメッセージが到着したときにチャネル スタックによって作成されます。 これにより、サービス フレームワークは、逆シリアル化エンジン \(<xref:System.Runtime.Serialization.DataContractSerializer> など\) を使用してこれらのヘッダーを解釈できます。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)。  
+  
+## メッセージ プロパティ  
+ メッセージには、プロパティを含めることができます。*"プロパティ"* とは、文字列名に関連付けられた任意の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトです。 プロパティには、`Properties` の `Message` プロパティからアクセスします。  
+  
+ 通常、メッセージ本文とメッセージ ヘッダーは、それぞれ SOAP 本文および SOAP ヘッダーにマップされますが、メッセージ プロパティがメッセージと共に送信または受信されることは通常ありません。 メッセージ プロパティは、チャネル スタック内のさまざまなチャネル間、およびチャネル スタックとサービス モデルの間で、メッセージに関するデータを渡す通信機構として主に存在します。  
+  
+ たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の一部として含まれる HTTP トランスポート チャネルは、クライアントに応答を送信するときに、"404 \(ページが見つかりません\)" や "500 \(内部サーバー エラー\)" などのさまざまな HTTP ステータス コードを生成できます。 HTTP トランスポート チャネルは、応答メッセージを送信する前に、`Properties` の `Message` に <xref:System.ServiceModel.Channels.HttpResponseMessageProperty> 型のオブジェクトを格納する "httpResponse" というプロパティが含まれているかどうかをチェックします。 このようなプロパティが見つかった場合、<xref:System.ServiceModel.Channels.HttpResponseMessageProperty.StatusCode%2A> プロパティを調べ、そのステータス コードを使用します。 該当のプロパティが見つからなかった場合は、既定の "200 \(OK\)" コードが使用されます。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)。  
+  
+### メッセージ全体  
+ これまで、メッセージのさまざまな部分に個別にアクセスするためのメソッドについて説明してきましたが、<xref:System.ServiceModel.Channels.Message> クラスには、メッセージ全体を使用するためのメソッドも用意されています。 たとえば、`WriteMessage` メソッドは、メッセージ全体を XML ライターに書き込みます。  
+  
+ これを可能にするには、`Message` インスタンス全体と XML Infoset 間のマッピングが定義されている必要があります。 実際に、このようなマッピングは存在します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、SOAP 標準を使用して、このマッピングを定義します。`Message` インスタンスが XML Infoset として書き込まれると、書き込まれた Infoset はメッセージを含む有効な SOAP エンベロープになります。 したがって、通常、`WriteMessage` は次の手順を実行します。  
+  
+1.  SOAP エンベロープ要素の開始タグを書き込みます。  
+  
+2.  SOAP ヘッダー要素の開始タグを書き込み、すべてのヘッダーを書き込んで、ヘッダー要素を閉じます。  
+  
+3.  SOAP 本文要素の開始タグを書き込みます。  
+  
+4.  `WriteBodyContents` または同等のメソッドを呼び出して、本文を書き込みます。  
+  
+5.  本文要素とエンベロープ要素を閉じます。  
+  
+ 上記の手順は、SOAP 標準に密接に関連しています。 これは、SOAP の複数のバージョンが存在することで複雑になります。たとえば、使用している SOAP のバージョンがわからなければ、SOAP エンベロープ要素を正しく書き込むことはできません。 また、SOAP 固有のこの複雑なマッピングを完全に無効にすることが望ましい場合もあります。  
+  
+ このため、`Version` には `Message` プロパティが用意されています。 このプロパティをメッセージの書き込み時に使用する SOAP バージョンに設定できます。また、`None` に設定することで、SOAP 固有のマッピングを使用しないようにすることもできます。`Version` プロパティを `None` に設定すると、メッセージ全体を使用するメソッドは、メッセージが本文だけで構成されている場合と同様に機能します。たとえば、`WriteMessage` は前述の複数の手順を実行するのではなく、`WriteBodyContents` を呼び出すだけです。 受信メッセージでは、`Version` が自動検出され、適切に設定されることが求められます。  
+  
+## チャネル スタック  
+  
+### チャネル  
+ 既に説明したように、チャネル スタックは、送信 <xref:System.ServiceModel.Channels.Message> インスタンスをアクション \(ネットワーク上でのパケットの送信など\) に変換したり、アクション \(ネットワーク パケットの受信など\) を受信 `Message` インスタンスに変換したりする役割を担います。  
+  
+ チャネル スタックは、一連の順序付けられた 1 つ以上のチャネルで構成されます。 送信 `Message` インスタンスは、スタック内の最初のチャネル \(*"最上位チャネル"* とも呼ばれます\) に渡され、このチャネルからスタック内の 1 つ下のチャネルに渡されます。以降、同様にスタック内の 1 つ下のチャネルに順次渡されていきます。 メッセージは、*"トランスポート チャネル"* と呼ばれる最後のチャネルで終了します。 受信メッセージはトランスポート チャネルから始まり、スタック内の下位のチャネルから上位のチャネルに順次渡されていきます。 通常、メッセージは最上位チャネルからサービス フレームワークに渡されます。 これは、アプリケーション メッセージの通常のパターンですが、若干動作が異なるチャネルもあります。たとえば、上のチャネルからメッセージが渡されることなく、独自のインフラストラクチャ メッセージを送信する場合があります。  
+  
+ メッセージがスタックを通過するときに、チャネルではさまざまな方法でメッセージを処理できます。 最も一般的な処理は、送信メッセージにヘッダーを追加し、受信メッセージのヘッダーを読み取ることです。 たとえば、チャネルでメッセージのデジタル署名を計算し、ヘッダーとして追加できます。 また、受信メッセージのこのデジタル署名ヘッダーを検査し、有効な署名のないメッセージがチャネル スタック内の上位のチャネルに渡されないようにブロックすることもできます。 多くの場合、チャネルはメッセージ プロパティの設定や検査も行います。 通常、メッセージ本文は変更されませんが、変更は可能です。たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ チャネルはメッセージ本文を暗号化できます。  
+  
+### トランスポート チャネルとメッセージ エンコーダー  
+ 他のチャネルによって変更された送信 <xref:System.ServiceModel.Channels.Message> を実際に何らかのアクションに変換するのは、スタック内の最下位チャネルです。 受信側では、このチャネルがアクションを `Message` に変換して、他のチャネルが処理できるようにします。  
+  
+ 既に説明したように、アクションはさまざまです。たとえば、各種プロトコル上でのネットワーク パケットの送信\/受信、データベースでのメッセージの読み取り\/書き込み、メッセージ キューへのメッセージの配置\/キューからのメッセージの削除などがあります。 これらのアクションには、共通点が 1 つあります。それは、すべてのアクションには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の `Message` インスタンスと、送信、受信、読み取り、書き込み、キューへの配置、またはキューからの削除が可能な実際のバイト グループとの間の変換が必要であるということです。`Message` をバイト グループに変換するプロセスは*エンコード*と呼ばれ、バイト グループから `Message` を作成する逆のプロセスは*デコード*と呼ばれます。  
+  
+ ほとんどのトランスポート チャネルでは、*メッセージ エンコーダー*と呼ばれるコンポーネントを使用して、エンコードとデコードの処理を行います。 メッセージ エンコーダーは、<xref:System.ServiceModel.Channels.MessageEncoder> クラスのサブクラスです。`MessageEncoder` には、`ReadMessage` とバイト グループとの間の変換を行う `WriteMessage` メソッドと `Message` メソッドのさまざまなオーバーロードが含まれます。  
+  
+ 送信側では、バッファー トランスポート チャネルが上のチャネルから受け取った `Message` オブジェクトを `WriteMessage` に渡します。 バッファー トランスポート チャネルはバイト配列を取得し、アクション \(これらのバイトを有効な TCP パケットとしてパッケージングし、適切な送信先に送信するなど\) を実行するために使用します。 ストリーミング トランスポート チャネルは、\(たとえば、送信 TCP 接続で\) まず `Stream` を作成します。次に、この `Stream` と送信に必要な `Message` の両方を適切な `WriteMessage` オーバーロードに渡し、このオーバーロードによってメッセージが書き込まれます。  
+  
+ 受信側では、バッファー トランスポート チャネルは、\(たとえば、受信 TCP パケットから\) 受信バイトを配列に抽出し、`ReadMessage` を呼び出して、チャネル スタックの上位に渡すことができる `Message` オブジェクトを取得します。 ストリーミング トランスポート チャネルは、`Stream` オブジェクト \(受信 TCP 接続のネットワーク ストリームなど\) を作成し、`ReadMessage` に渡して `Message` オブジェクトを取得します。  
+  
+ トランスポート チャネルとメッセージ エンコーダーの分離は必須ではありません。つまり、メッセージ エンコーダーを使用しないトランスポート チャネルの作成が可能です。 ただし、この分離には、構成しやすいという利点があります。 トランスポート チャネルが基本 <xref:System.ServiceModel.Channels.MessageEncoder> だけを使用する限り、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ エンコーダーを使用することも、サードパーティのメッセージ エンコーダーを使用することもできます。 同様に、通常はどのトランスポート チャネルでも同じエンコーダーを使用できます。  
+  
+### メッセージ エンコーダーの動作  
+ エンコーダーの一般的な動作を記述する場合、次の 4 つのケースについて検討すると有益です。  
+  
+|操作|コメント|  
+|--------|----------|  
+|エンコード \(バッファー\)|バッファー モードでは、通常、エンコーダーは可変サイズのバッファーを作成し、このバッファーに XML ライターを作成します。 エンコーダーは、エンコードするメッセージに対して <xref:System.ServiceModel.Channels.Message.WriteMessage%28System.Xml.XmlWriter%29> を呼び出してヘッダーを書き込みます。次に、このトピックの <xref:System.ServiceModel.Channels.Message.WriteBodyContents%28System.Xml.XmlDictionaryWriter%29> に関するセクションで説明したように、`Message` を使用して本文を書き込みます。 その後、トランスポート チャネルで使用できるように、\(バイト配列として表される\) バッファーの内容が返されます。|  
+|エンコード \(ストリーミング\)|ストリーミング モードでは、動作が上記に似ていますが、より単純です。 バッファーは必要ありません。 通常、XML ライターがストリームに作成され、このライターに書き込むために <xref:System.ServiceModel.Channels.Message.WriteMessage%28System.Xml.XmlWriter%29> に対して `Message` が呼び出されます。|  
+|デコード \(バッファー\)|バッファー モードでデコードする場合、通常、バッファーされたデータを格納する特殊な `Message` サブクラスが作成されます。 メッセージのヘッダーが読み取られ、メッセージ本文に配置する XML リーダーが作成されます。 これは、<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents> で返されるリーダーです。|  
+|デコード \(ストリーミング\)|ストリーミング モードでデコードする場合、通常、特殊な Message サブクラスが作成されます。 ストリームは、すべてのヘッダーを読み取り、メッセージ本文に配置できる位置まで進められます。 次に、ストリームに XML リーダーが作成されます。 これは、<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents> で返されるリーダーです。|  
+  
+ エンコーダーでは、他の機能も実行できます。 たとえば、エンコーダーは XML リーダーとライターをプールできます。 新しい XML リーダーまたはライターが必要になるたびに作成すると負荷がかかります。 したがって、通常、エンコーダーは構成可能なサイズのリーダーのプールとライターのプールを保持しています。 前述のエンコーダーの動作の説明の中の、"XML リーダー\/ライターを作成する" という表現は、"プールから取得し、プールされているものを使用できない場合に作成する" という意味です。 エンコーダー \(およびデコード時にエンコーダーが作成する `Message` サブクラス\) には、リーダーとライターが必要でなくなったら \(`Message` を閉じたときなどに\) プールに戻すためのロジックが含まれています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、3 つのメッセージ エンコーダーが用意されていますが、さらにカスタム エンコーダーを作成することもできます。 用意されているエンコーダーは、Text、Binary、および MTOM \(Message Transmission Optimization Mechanism\) の 3 種類です。 これらの詳細については、「[メッセージ エンコーダーを選択する](../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)」を参照してください。  
+  
+### IStreamProvider インターフェイス  
+ ストリーミングされた本文を含む送信メッセージを XML ライターに書き込むときに、<xref:System.ServiceModel.Channels.Message> は <xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%28System.Xml.XmlDictionaryWriter%29> 実装で次のような一連の呼び出しを使用します。  
+  
+-   ストリームの前に必要な情報を書き込みます \(XML 開始タグなど\)。  
+  
+-   ストリームを書き込みます。  
+  
+-   ストリームの後に情報を書き込みます \(XML 終了タグなど\)。  
+  
+ これは、テキスト XML エンコーディングに類似するエンコードで有効に機能します。 ただし、XML Infoset 情報 \(XML 要素を開始および終了するためのタグなど\) を、要素内に含まれるデータと共には配置しないエンコードもあります。 たとえば、MTOM エンコーディングでは、メッセージは複数の部分に分割されます。 ある部分に XML Infoset が含まれ、要素の実際のコンテンツについては他の部分への参照が含まれている場合があります。 通常、XML Infoset は、ストリーミングされたコンテンツと比べてサイズが小さいため、Infoset をバッファーに格納し、これを書き込んだ後に、ストリーミング方式でコンテンツを書き込むことには意味があります。 これは、終了要素タグが書き込まれるまでは、ストリームを書き込むことができないことを意味します。  
+  
+ このために、<xref:System.Xml.IStreamProvider> インターフェイスが使用されます。 このインターフェイスには、書き込むストリームを返す <xref:System.Xml.IStreamProvider.GetStream> メソッドがあります。<xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%28System.Xml.XmlDictionaryWriter%29> でストリーミングされたメッセージ本文を書き込む適切な方法は次のとおりです。  
+  
+1.  ストリームの前に必要な情報を書き込みます \(XML 開始タグなど\)。  
+  
+2.  書き込むストリームを返す `WriteValue` 実装で、<xref:System.Xml.XmlDictionaryWriter> を受け取る <xref:System.Xml.IStreamProvider> に対して `IStreamProvider` オーバーロードを呼び出します。  
+  
+3.  ストリームの後に情報を書き込みます \(XML 終了タグなど\)。  
+  
+ この方法を使用すると、XML ライターは <xref:System.Xml.IStreamProvider.GetStream> を呼び出し、ストリーミングされたデータを書き込む時期を選択できます。 たとえば、テキスト XML ライターやバイナリ XML ライターは、このメソッドをすぐに呼び出し、開始タグと終了タグの間にストリーミングされたコンテンツを書き込むことができます。 MTOM ライターは、メッセージの適切な部分を書き込む準備ができたときに、後で <xref:System.Xml.IStreamProvider.GetStream> を呼び出すことができます。  
+  
+## サービス フレームワークでのデータの表現  
+ このトピックの「基本アーキテクチャ」で説明したように、サービス フレームワークは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の一部であり、特に、メッセージ データのユーザー フレンドリなプログラミング モデルと実際の `Message` インスタンス間で変換を行う機能を果たします。 通常、サービス フレームワークでは、メッセージ交換は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 属性でマークされた <xref:System.ServiceModel.OperationContractAttribute> メソッドとして表されます。 このメソッドは複数のパラメーターを取得でき、戻り値または出力パラメーター \(または両方\) を返すことができます。 サービス側では、入力パラメーターは受信メッセージを表し、戻り値と出力パラメーターは送信メッセージを表します。 クライアント側では、この逆になります。 パラメーターと戻り値を使用してメッセージを記述するためのプログラミング モデルの詳細については、「[サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。 ここでは、概要を簡単に説明します。  
+  
+## プログラミング モデル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス フレームワークでは、メッセージを記述するための次の 5 種類のプログラミング モデルをサポートしています。  
+  
+### 1.空のメッセージ  
+ これは、最も簡単なケースです。 空の受信メッセージを記述する場合は、次のように入力パラメーターは使用しないでください。  
+  
+ [!code-csharp[C_DataArchitecture#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#3)]
+ [!code-vb[C_DataArchitecture#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#3)]  
+  
+ 空の送信メッセージを記述する場合は、次のように void 戻り値を使用し、出力パラメーターは使用しないでください。  
+  
+ [!code-csharp[C_DataArchitecture#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#4)]
+ [!code-vb[C_DataArchitecture#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#4)]  
+  
+ 次のように、一方向の操作コントラクトとは異なることに注意してください。  
+  
+ [!code-csharp[C_DataArchitecture#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#5)]
+ [!code-vb[C_DataArchitecture#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#5)]  
+  
+ `SetDesiredTemperature` の例では、双方向メッセージ交換パターンが記述されています。 メッセージは操作から返されますが、このメッセージは空です。 操作からエラーを返すことができます。 "SetLightbulb" の例では、メッセージ交換パターンは一方向であるため、記述する送信メッセージはありません。 この場合、サービスはクライアントにステータスを通知できません。  
+  
+### 2.Message クラスの直接使用  
+ 操作コントラクトで <xref:System.ServiceModel.Channels.Message> クラス \(またはサブクラスのいずれか\) を直接使用できます。 この場合、サービス フレームワークは、操作からチャネル スタックおよびチャネル スタックから操作に `Message` を渡すだけであり、それ以上の処理は行いません。  
+  
+ `Message` を直接使用するケースとして、主に 2 つのケースがあります。 1 つは、他のプログラミング モデルでは、メッセージを記述できるだけの柔軟性を得ることができない高度なシナリオで使用します。 たとえば、ディスク上のファイルを使用して、ファイルのプロパティがメッセージ ヘッダーになり、ファイルの内容がメッセージ本文になるようにメッセージを記述することが必要になる場合があります。 これは、次のように作成できます。  
+  
+ [!code-csharp[C_DataArchitecture#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#6)]
+ [!code-vb[C_DataArchitecture#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#6)]  
+  
+ 操作コントラクトで `Message` を一般的に使用するもう 1 つのケースは、サービスがメッセージの特定の内容に留意しているわけではなく、ブラック ボックスと同様にメッセージを処理する場合です。 たとえば、メッセージを他の複数の受信者に転送するサービスを使用することがあります。 コントラクトは、次のように作成できます。  
+  
+ [!code-csharp[C_DataArchitecture#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#7)]
+ [!code-vb[C_DataArchitecture#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#7)]  
+  
+ Action\="\*" 行により、メッセージのディスパッチが実質的に無効になり、`IForwardingService` コントラクトに送信されるすべてのメッセージが確実に `ForwardMessage` 操作に送られます  \(通常、ディスパッチャーは、メッセージの "Action" ヘッダーを調べて、対象とする操作を特定します。 Action\="\*" は、"Action ヘッダーに設定可能なすべての値" を意味します。\) Action\="\*" とパラメーターとしての Message の使用を組み合わせると、存在し得るすべてのメッセージを取得できるため、この組み合わせは "ユニバーサル コントラクト" と呼ばれます。 存在し得るすべてのメッセージを送信できるようにするには、Message を戻り値として使用し、`ReplyAction` を "\*" に設定します。 これにより、サービス フレームワークは独自の Action ヘッダーを追加できなくなるため、開発者が返す `Message` オブジェクトを使用して、このヘッダーを制御できます。  
+  
+### 3.メッセージ コントラクト  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、*"メッセージ コントラクト"* と呼ばれるメッセージを記述するための宣言型プログラミング モデルが用意されています。 このモデルの詳細については、「[メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md)」を参照してください。 基本的に、単一の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型によってメッセージ全体が表されます。この型は、<xref:System.ServiceModel.MessageBodyMemberAttribute> や <xref:System.ServiceModel.MessageHeaderAttribute> などの属性を使用して、メッセージ コントラクト クラスのどの部分をメッセージのどの部分にマップする必要があるかを示します。  
+  
+ メッセージ コントラクトは、結果として生成される `Message` インスタンスに対してさまざまな制御を行うことができます \(ただし、`Message` クラスを直接使用した場合と同様に制御できるわけではありません\)。 たとえば、多くの場合、メッセージ本文は情報の複数の部分で構成され、各部分は独自の XML 要素によって表されます。 これらの要素は、本文に直接出現することも \(*ベア* モード\)、XML 要素で囲んで*ラップ*することもできます。 メッセージ コントラクト プログラミング モデルを使用すると、ベアとラップのどちらを使用するかを決定し、ラッパー名と名前空間の名前を制御できます。  
+  
+ 前述の機能を示すメッセージ コントラクトのコード例を次に示します。  
+  
+ [!code-csharp[C_DataArchitecture#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#9)]
+ [!code-vb[C_DataArchitecture#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#9)]  
+  
+ <xref:System.ServiceModel.MessageBodyMemberAttribute>、<xref:System.ServiceModel.MessageHeaderAttribute>、または他の関連する属性を使用して、シリアル化対象としてマークされた項目は、メッセージ コントラクトに関与するためにシリアル化可能であることが必要です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]このトピックで後述する「シリアル化」を参照してください。  
+  
+### 4.パラメーター  
+ 多くの場合、データの複数の部分に作用する操作を記述する開発者は、メッセージ コントラクトによって実現される制御のレベルを必要としていません。 たとえば、新しいサービスの作成時に、ベアとラップのどちらを使用するかを決定し、ラッパー要素名を決めることは通常望まれていません。 多くの場合、これらを決定するには Web サービスと SOAP の深い知識が必要となります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス フレームワークは、こうした選択をユーザーに強制することなく、情報の複数の関連部分を送信または受信するのに最適で、相互運用性が最も高い SOAP 表現を自動的に選択できます。 これは、情報のこのような部分を操作コントラクトのパラメーターまたは戻り値として記述するだけで実現されます。 たとえば、次のような操作コントラクトについて考えてみます。  
+  
+ [!code-csharp[C_DataArchitecture#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_dataarchitecture/cs/source.cs#11)]
+ [!code-vb[C_DataArchitecture#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_dataarchitecture/vb/source.vb#11)]  
+  
+ サービス フレームワークは、情報の 3 つの部分 \(`customerID`、`item`、および `quantity`\) をすべてメッセージ本文に配置し、`SubmitOrderRequest` というラッパー要素にラップすることを自動的に決定します。  
+  
+ より複雑なメッセージ コントラクトや `Message` ベースのプログラミング モデルに移行する特別な理由がない限り、操作コントラクト パラメーターの簡単なリストとして送信または受信するように情報を記述することをお勧めします。  
+  
+### 5.ストリーム  
+ `Stream` またはそのサブクラスのいずれかを、操作コントラクトで使用したり、メッセージ コントラクトでメッセージ本文の単独の部分として使用したりすることは、これまでに説明したものとは別のプログラミング モデルと考えることができます。 ストリーミングに対応する独自の `Stream` サブクラスを作成する場合を除き、`Message` をこのように使用することは、コントラクトをストリーミング方式で使用できることを保証する唯一の方法です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)。  
+  
+ `Stream` またはそのサブクラスのいずれかをこのように使用した場合、シリアライザーは呼び出されません。 送信メッセージの場合、`Message` インターフェイスのセクションで説明したように、特殊なストリーミング <xref:System.Xml.IStreamProvider> サブクラスが作成され、ストリームが書き込まれます。 受信メッセージの場合は、サービス フレームワークが受信メッセージに `Stream` サブクラスを作成し、操作に提供します。  
+  
+## プログラミング モデルの制限  
+ 前述のプログラミング モデルを任意に組み合わせることはできません。 たとえば、ある操作でメッセージ コントラクトを受け入れる場合、そのメッセージ コントラクトは入力パラメーターのみであることが必要です。 さらに、操作では、空のメッセージ \(戻り値の型が void\) または別のメッセージ コントラクトを返す必要があります。 プログラミング モデルのこれらの制限については、各プログラミング モデルに関するトピック \(「[メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md)」、「[メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)」、および「[大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)」\) に記載されています。  
+  
+## メッセージ フォーマッタ  
+ 前述の各プログラミング モデルは、*"メッセージ フォーマッタ"* と呼ばれるコンポーネントをサービス フレームワークにプラグインすることによってサポートされます。 メッセージ フォーマッタは、<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> インターフェイス \(クライアントで使用\)、または <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> インターフェイス \([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス クライアントで使用\)、あるいはこの両方を実装する型です。  
+  
+ 通常、メッセージ フォーマッタは動作によってプラグインされます。 たとえば、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> は、データ コントラクト メッセージ フォーマッタをプラグインします。 これを行うには、サービス側では <xref:System.ServiceModel.Dispatcher.DispatchOperation.Formatter%2A> メソッドで <xref:System.ServiceModel.Description.IOperationBehavior.ApplyDispatchBehavior%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Dispatcher.DispatchOperation%29> を適切なフォーマッタに設定します。クライアント側では、<xref:System.ServiceModel.Dispatcher.ClientOperation.Formatter%2A> メソッドで <xref:System.ServiceModel.Description.IOperationBehavior.ApplyClientBehavior%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Dispatcher.ClientOperation%29> を適切なフォーマッタに設定します。  
+  
+ メッセージ フォーマッタが実装できるメソッドを次の表に示します。  
+  
+|インターフェイス|メソッド|アクション|  
+|--------------|----------|-----------|  
+|<xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter>|[DeserializeRequest\(Message, Object\<xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter.DeserializeRequest%28System.ServiceModel.Channels.Message%2CSystem.Object%5B%5D%29>|受信 `Message` を操作パラメーターに変換します。|  
+|<xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter>|[SerializeReply\(MessageVersion, Object\<xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter.SerializeReply%28System.ServiceModel.Channels.MessageVersion%2CSystem.Object%5B%5D%2CSystem.Object%29>|操作の戻り値または出力パラメーターから送信 `Message` を作成します。|  
+|<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter>|[SerializeRequest\(MessageVersion, Object\<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.SerializeRequest%28System.ServiceModel.Channels.MessageVersion%2CSystem.Object%5B%5D%29>|操作パラメーターから送信 `Message` を作成します。|  
+|<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter>|[DeserializeReply\(Message, Object\<xref:System.ServiceModel.Dispatcher.IClientMessageFormatter.DeserializeReply%28System.ServiceModel.Channels.Message%2CSystem.Object%5B%5D%29>|受信 `Message` を戻り値または出力パラメーターに変換します。|  
+  
+## シリアル化  
+ メッセージ コントラクトまたはパラメーターを使用してメッセージの内容を記述する場合は、常にシリアル化を使用して [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型と XML Infoset 表現の間の変換を行う必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、他の場所でもシリアル化を使用します。たとえば、<xref:System.ServiceModel.Channels.Message> の <xref:System.ServiceModel.Channels.Message.GetBody%2A> ジェネリック メソッドを使用すると、オブジェクトに逆シリアル化されたメッセージの本文全体を読み取ることができます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、パラメーターおよびメッセージ各部のシリアル化と逆シリアル化を行うためにすぐに使用できるシリアル化技術として、<xref:System.Runtime.Serialization.DataContractSerializer> と `XmlSerializer` をサポートしています。 また、カスタム シリアライザーを作成することもできます。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のその他の部分 \(`GetBody` ジェネリック メソッドや SOAP エラーのシリアル化など\) では、<xref:System.Runtime.Serialization.XmlObjectSerializer> のサブクラス \(<xref:System.Runtime.Serialization.DataContractSerializer> および <xref:System.Runtime.Serialization.NetDataContractSerializer>。<xref:System.Xml.Serialization.XmlSerializer> は対象外\) だけを使用するように制限されている場合があります。また、<xref:System.Runtime.Serialization.DataContractSerializer> だけを使用するようにハードコーディングされている場合もあります。  
+  
+ `XmlSerializer` は、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスで使用されるシリアル化エンジンです。`DataContractSerializer` は、新しいデータ コントラクト プログラミング モデルを認識する新しいシリアル化エンジンです。`DataContractSerializer` が既定で選択されています。`XmlSerializer` を使用する場合は、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.DataContractFormatAttribute%2A> 属性を使用して操作ごとに選択できます。  
+  
+ <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> と <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior> は、それぞれ `DataContractSerializer` および `XmlSerializer` のメッセージ フォーマッタをプラグインする役割を担う操作の動作です。<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> の動作は、<xref:System.Runtime.Serialization.XmlObjectSerializer> など、<xref:System.Runtime.Serialization.NetDataContractSerializer> から派生した任意のシリアライザーで実際に操作できます \(詳細については、「スタンドアロンのシリアル化の使用」を参照してください\)。 この動作では、`CreateSerializer` 仮想メソッド オーバーロードのいずれかを呼び出して、シリアライザーを取得します。 別のシリアライザーをプラグインするには、新しい <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> サブクラスを作成し、`CreateSerializer` の両方のオーバーロードをオーバーライドします。  
+  
+## 参照  
+ [サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md b/docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md
new file mode 100644
index 00000000000..61fcdeac54a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md
@@ -0,0 +1,157 @@
+---
+title: "Windows 認証エラーのデバッグ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, 認証"
+  - "WCF, Windows 認証"
+ms.assetid: 181be4bd-79b1-4a66-aee2-931887a6d7cc
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# Windows 認証エラーのデバッグ
+セキュリティ機構として Windows 認証を使用する場合、セキュリティ サポート プロバイダー インターフェイス \(SSPI: Security Support Provider Interface\) がセキュリティ プロセスを処理します。SSPI 層でセキュリティ エラーが発生すると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] によってこれらのエラーが示されます。このトピックでは、エラーの診断に役立つフレームワークと一連の質問を示します。  
+  
+ Kerberos プロトコルの概要については、「[Kerberos の説明](http://go.microsoft.com/fwlink/?LinkID=86946)」を参照してください。SSPI の概要については、「[SSPI](http://go.microsoft.com/fwlink/?LinkId=88941)」を参照してください。  
+  
+ Windows 認証の場合、通常、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は*ネゴシエート* セキュリティ サポート プロバイダー \(SSP: Security Support Provider\) を使用します。ネゴシエート SSP は、クライアントとサービス間で Kerberos 相互認証を実行します。Kerberos プロトコルを使用できない場合、既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は NTLM \(NT LAN Manager\) にフォールバックします。ただし、Kerberos プロトコルのみを使用するように \(Kerberos を使用できない場合は例外をスローするように\) [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を構成できます。また、Kerberos プロトコルの制限付きの形式を使用するように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を構成することもできます。  
+  
+## デバッグ方法  
+ 基本的な方法は次のとおりです。  
+  
+1.  Windows 認証を使用しているかどうかを確認します。他の方式を使用している場合には、このトピックは該当しません。  
+  
+2.  Windows 認証を使用していることが確実である場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の構成で Kerberos ダイレクトと Negotiate のどちらを使用しているかを確認します。  
+  
+3.  構成で Kerberos プロトコルと NTLM のどちらを使用しているかを確認した後は、現在のコンテキストでのエラー メッセージを理解できます。  
+  
+### Kerberos プロトコルと NTLM の可用性  
+ Kerberos SSP は、Kerberos キー配布センター \(KDC: Key Distribution Center\) として機能するドメイン コントローラーを必要とします。Kerberos プロトコルを使用できるのは、クライアントとサービスの両方がドメイン ID を使用している場合だけです。次の表に示すように、アカウントの他の組み合わせでは NTLM が使用されます。  
+  
+ この表の列見出しは、サーバーが使用すると考えられるアカウントの種類を示します。左の列は、クライアントが使用すると考えられるアカウントの種類を示します。  
+  
+||Local User|Local System|Domain User|Domain Machine|  
+|-|----------------|------------------|-----------------|--------------------|  
+|Local User|NTLM|NTLM|NTLM|NTLM|  
+|Local System|匿名 NTLM|匿名 NTLM|匿名 NTLM|匿名 NTLM|  
+|Domain User|NTLM|NTLM|Kerberos|Kerberos|  
+|Domain Machine|NTLM|NTLM|Kerberos|Kerberos|  
+  
+ 具体的には、次の 4 種類のアカウントがあります。  
+  
+-   Local User : コンピューター専用のユーザー プロファイル。例 : `MachineName\Administrator` または `MachineName\ProfileName`。  
+  
+-   Local System : ドメインに参加していないコンピューターの SYSTEM ビルトイン アカウント。  
+  
+-   Domain User : Windows ドメインのユーザー アカウント。例 : `DomainName\ProfileName`。  
+  
+-   Domain Machine : Windows ドメインに参加しているコンピューターで実行されている、コンピューター ID を使用するプロセス。例 : `MachineName\Network Service`。  
+  
+> [!NOTE]
+>  サービス資格情報は、<xref:System.ServiceModel.ServiceHost> クラスの <xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドが呼び出されたときにキャプチャされます。クライアント資格情報は、クライアントがメッセージを送信するたびに読み取られます。  
+  
+## Windows 認証の一般的な問題  
+ ここでは、Windows 認証に関するいくつかの一般的な問題と、考えられる解決策について説明します。  
+  
+### Kerberos プロトコル  
+  
+#### Kerberos プロトコルでの SPN と UPN の問題  
+ Windows 認証を使用し、SSPI が Kerberos プロトコルを使用またはネゴシエートする場合、クライアント エンドポイントが使用する URL には、サービス URL 内のサービスのホストの完全修飾ドメイン名が含まれている必要があります。これは、サービスを実行しているアカウントがコンピューターの \(既定の\) サービス プリンシパル名 \(SPN: Service Principal Name\) キーにアクセスできることを前提としています。このキーは、コンピューターを Active Directory ドメインに追加したときに作成されます。コンピューターの SPN キーにアクセスできるようにするには、Network Service アカウントでサービスを実行するのが最も一般的な方法です。サービスがコンピューターの SPN キーにアクセスできない場合は、クライアントのエンドポイント ID でサービスを実行しているアカウントの正しい SPN またはユーザー プリンシパル名 \(UPN: User Principal Name\) を指定する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が SPN と UPN を使用するしくみ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+ Web ファームや Web ガーデンなどの負荷分散シナリオでは、各アプリケーションに一意のアカウントを定義し、そのアカウントに SPN を割り当て、アプリケーションのサービスすべてがそのアカウントで実行されるようにするのが一般的です。  
+  
+ サービスのアカウント用の SPN を取得するには、Active Directory ドメイン管理者である必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[Kerberos Technical Supplement for Windows](http://go.microsoft.com/fwlink/?LinkID=88330)」を参照してください。  
+  
+#### Kerberos プロトコル ダイレクトでは Domain Machine アカウントでサービスを実行する必要がある  
+ この状況は、次のコードに示すように、`ClientCredentialType` プロパティが `Windows` に設定され、<xref:System.ServiceModel.MessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティが `false` に設定されている場合に発生します。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#1)]
+ [!code-vb[C_DebuggingWindowsAuth#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#1)]  
+  
+ これを解決するには、ドメインに参加しているコンピューターで、Domain Machine アカウント \(Network Service など\) を使用してサービスを実行します。  
+  
+### 委任には資格情報ネゴシエーションが必要  
+ 委任で Kerberos 認証プロトコルを使用するには、資格情報ネゴシエーションを使用する Kerberos プロトコル \("マルチレッグ" Kerberos または "マルチステップ" Kerberos とも呼ばれます\) を実装する必要があります。資格情報ネゴシエーションを使用しない Kerberos 認証 \("ワンショット" Kerberos または "シングルレッグ" Kerberos とも呼ばれます\) を実装した場合は、例外がスローされます。  
+  
+ 資格情報ネゴシエーションを使用する Kerberos を実装するには、次の手順を実行します。  
+  
+1.  <xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> を <xref:System.Security.Principal.TokenImpersonationLevel> に設定して委任を実装します。  
+  
+2.  次のような SSPI ネゴシエーションが必要です。  
+  
+    1.  標準バインディングを使用する場合は、`NegotiateServiceCredential` プロパティを `true` に設定します。  
+  
+    2.  カスタム バインディングを使用する場合は、`Security` 要素の `AuthenticationMode` 属性を `SspiNegotiated` に設定します。  
+  
+3.  次のように、NTLM を使用できないようにすることで、SSPI ネゴシエーションで Kerberos を使用する必要があります。  
+  
+    1.  NTLM を使用できないようにするには、コードで `ChannelFactory.Credentials.Windows.AllowNtlm = false` ステートメントを使用します。  
+  
+    2.  構成ファイルで `allowNtlm` 属性を `false` に設定することもできます。この属性は、[\<windows\>](../../../../docs/framework/configure-apps/file-schema/wcf/windows-of-clientcredentials-element.md) に含まれています。  
+  
+### NTLM プロトコル  
+  
+#### ネゴシエート SSP は NTLM にフォールバックするが、NTLM が無効になっている  
+ <xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm%2A> プロパティを `false` に設定すると、NTLM が使用されている場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はベスト エフォートで例外をスローします。このプロパティを `false` に設定すると、ネットワークで経由で NTLM 資格情報が送信できない可能性があります。  
+  
+ NTLM へのフォールバックを無効にする方法を次に示します。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#4)]
+ [!code-vb[C_DebuggingWindowsAuth#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#4)]  
+  
+#### NTLM ログオンが失敗する  
+ サービスで、クライアント資格情報が有効ではありません。ユーザー名とパスワードが正しく設定されており、サービスを実行しているコンピューターに認識されているアカウントに対応していることを確認します。NTLM では、指定された資格情報を使用してサービスのコンピューターにログオンします。資格情報がクライアントを実行しているコンピューターで有効であっても、サービスのコンピューターでは有効でない場合、このログオンは失敗します。  
+  
+#### 匿名 NTLM ログオンが発生するが、既定では匿名ログオンが無効になっている  
+ 次の例に示すように、クライアントの作成時に、<xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> プロパティを <xref:System.Security.Principal.TokenImpersonationLevel> に設定します。ただし、既定では、サーバーは匿名ログオンを許可しません。これは、<xref:System.ServiceModel.Security.WindowsServiceCredential> クラスの <xref:System.ServiceModel.Security.WindowsServiceCredential.AllowAnonymousLogons%2A> プロパティの既定値が `false` であるためです。  
+  
+ 匿名ログオンを有効にすることを試みるクライアント コードを次に示します \(既定のプロパティは `Identification` です\)。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#5)]
+ [!code-vb[C_DebuggingWindowsAuth#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#5)]  
+  
+ サーバーによって匿名ログオンを有効にするように既定値を変更するサービス コードを次に示します。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#6)]
+ [!code-vb[C_DebuggingWindowsAuth#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#6)]  
+  
+ 偽装[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+ もう 1 つの方法として、SYSTEM ビルトイン アカウントを使用する Windows サービスとしてクライアントを実行します。  
+  
+### その他の問題  
+  
+#### クライアント資格情報が正しく設定されていない  
+ Windows 認証では、<xref:System.ServiceModel.Security.UserNamePasswordClientCredential> ではなく、<xref:System.ServiceModel.ClientBase%601> クラスの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティによって返された <xref:System.ServiceModel.Security.WindowsClientCredential> インスタンスを使用します。誤りのあるコード例を次に示します。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#2)]
+ [!code-vb[C_DebuggingWindowsAuth#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#2)]  
+  
+ 正しいコード例を次に示します。  
+  
+ [!code-csharp[C_DebuggingWindowsAuth#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_debuggingwindowsauth/cs/source.cs#3)]
+ [!code-vb[C_DebuggingWindowsAuth#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_debuggingwindowsauth/vb/source.vb#3)]  
+  
+#### SSPI を使用できない  
+ [!INCLUDE[wxp](../../../../includes/wxp-md.md)] Home Edition、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] Media Center Edition、および [!INCLUDE[wv](../../../../includes/wv-md.md)] Home Edition の各オペレーティング システムは、サーバーとして使用した場合には Windows 認証をサポートしません。  
+  
+#### 異なる ID を使用した開発と展開  
+ アプリケーションを 1 台のコンピューターで開発し、別のコンピューターに展開し、異なるアカウントの種類を使用して各コンピューターで認証を行う場合、動作の違いが発生する場合があります。たとえば、`SSPI Negotiated` 認証モードを使用して Windows XP Professional コンピューターでアプリケーションを開発するとします。ローカル ユーザー アカウントを使用して認証する場合は、NTLM プロトコルが使用されます。アプリケーションを開発した後は、ドメイン アカウントで実行されるサービスを Windows Server 2003 コンピューターに展開します。この時点で、クライアントは Kerberos とドメイン コントローラーを使用するため、このサービスを認証できなくなります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.WindowsClientCredential>   
+ <xref:System.ServiceModel.Security.WindowsServiceCredential>   
+ <xref:System.ServiceModel.Security.WindowsClientCredential>   
+ <xref:System.ServiceModel.ClientBase%601>   
+ [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md b/docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md
new file mode 100644
index 00000000000..630aef7bf29
--- /dev/null
+++ b/docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md
@@ -0,0 +1,233 @@
+---
+title: "WCF の委任と偽装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "偽装 [WCF]"
+  - "委任 [WCF]"
+ms.assetid: 110e60f7-5b03-4b69-b667-31721b8e3152
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# WCF の委任と偽装
+*偽装*は、サービス ドメインのリソースへのクライアント アクセスを制限するためにサービスが使用する一般的な手法です。 サービス ドメインのリソースは、ローカル ファイルなどのコンピューター リソースの場合もあれば \(偽装\)、ファイル共有などの別のコンピューター上のリソースの場合もあります \(委任\)。 サンプル アプリケーションについては、「[クライアントの偽装](../../../../docs/framework/wcf/samples/impersonating-the-client.md)」を参照してください。 偽装の使用方法の例については、「[方法 : サービスでクライアントに偽装する](../../../../docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  サービスでクライアントを偽装すると、サービスはそのクライアントの資格情報を使用して実行されます。この資格情報の特権がサーバー プロセスより高い場合があることに注意してください。  
+  
+## 概要  
+ 通常、クライアントは、クライアントに代わって何らかのアクションを実行してもらうためにサービスを呼び出します。 偽装により、サービスはアクションの実行時にクライアントとして機能できます。 委任を使用すると、フロントエンド サービスは、バックエンド サービスもクライアントを偽装できるような方法で、バックエンド サービスにクライアントの要求を転送できます。 偽装は、クライアントが特定のアクションを実行するために承認されているかどうかを確認する方法として、最も一般的に使用されます。委任は、偽装機能をクライアントの ID と共にバックエンド サービスにフローする方法です。 委任は、Kerberos ベースの認証を実行するときに使用できる Windows ドメインの機能です。 委任は ID フローとは異なります。委任では、クライアントのパスワードを保持せずにクライアントを偽装する機能を転送するため、ID フローよりもかなり高い特権が与えられた操作です。  
+  
+ 偽装と委任はいずれも、クライアントが Windows ID を保持していることが必要となります。 クライアントが Windows ID を保持していない場合、クライアントの ID を 2 番目のサービスにフローする以外に選択肢はありません。  
+  
+## 偽装の基本  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、さまざまなクライアント資格情報の偽装をサポートしています。 このトピックでは、サービス メソッドの実装時に呼び出し元を偽装するためのサービス モデルのサポートについて説明します。 また、偽装と SOAP セキュリティを必要とする一般的な展開シナリオ、およびこれらのシナリオでの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のオプションについても説明します。  
+  
+ ここでは、SOAP セキュリティを使用する場合の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での偽装と委任について集中的に説明します。 「[トランスポート セキュリティでの偽装の使用](../../../../docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md)」に記載されているように、トランスポート セキュリティを使用する場合にも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で偽装と委任を使用できます。  
+  
+## 2 つの方法  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の SOAP セキュリティには、偽装を実行するための 2 とおりの方法があります。 使用する方法は、バインディングによって異なります。 1 つは、セキュリティ サポート プロバイダー インターフェイス \(SSPI\) または Kerberos 認証から取得し、サーバーにキャッシュされた Windows トークンの偽装です。 もう 1 つは、*Service\-for\-User \(S4U\)* と総称される Kerberos 拡張から取得した Windows トークンの偽装です。  
+  
+### キャッシュされたトークンの偽装  
+ キャッシュされたトークンの偽装は、以下で実行できます。  
+  
+-   Windows クライアント資格情報を使用する <xref:System.ServiceModel.WSHttpBinding>、<xref:System.ServiceModel.WSDualHttpBinding>、および <xref:System.ServiceModel.NetTcpBinding>。  
+  
+-   <xref:System.ServiceModel.BasicHttpBinding> が <xref:System.ServiceModel.BasicHttpSecurityMode> 資格情報に設定された <xref:System.ServiceModel.BasicHttpSecurityMode>。または、サービスが有効な Windows アカウントにマップできるユーザー名資格情報をクライアントが提示する、その他の標準バインディング。  
+  
+-   <xref:System.ServiceModel.Channels.CustomBinding> が `requireCancellation` に設定された Windows クライアント資格情報を使用する `true` \(このプロパティは、<xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters>、<xref:System.ServiceModel.Security.Tokens.SslSecurityTokenParameters>、および <xref:System.ServiceModel.Security.Tokens.SspiSecurityTokenParameters> の各クラスで使用できます\)。 セキュリティで保護されたメッセージ交換をバインディングで使用する場合は、`requireCancellation` プロパティを `true` に設定することも必要です。  
+  
+-   クライアントがユーザー名資格情報を提示する <xref:System.ServiceModel.Channels.CustomBinding>。 セキュリティで保護されたメッセージ交換をバインディングで使用する場合は、`requireCancellation` プロパティを `true` に設定することも必要です。  
+  
+### S4U ベースの偽装  
+ S4U ベースの偽装は、以下で実行できます。  
+  
+-   サービスが有効な Windows アカウントにマップできる証明書クライアント資格情報を使用する <xref:System.ServiceModel.WSHttpBinding>、<xref:System.ServiceModel.WSDualHttpBinding>、および <xref:System.ServiceModel.NetTcpBinding>。  
+  
+-   <xref:System.ServiceModel.Channels.CustomBinding> プロパティが `requireCancellation` に設定された Windows クライアント資格情報を使用する `false`。  
+  
+-   <xref:System.ServiceModel.Channels.CustomBinding> プロパティが `requireCancellation` に設定されたユーザー名資格情報または Windows クライアント資格情報とセキュリティで保護されたメッセージ交換を使用する `false`。  
+  
+ サービスがクライアントを偽装できるエクステントは、偽装を試みるときにサービス アカウントが保持している特権、使用する偽装の種類、およびクライアントが許可すると考えられる偽装のエクステントによって異なります。  
+  
+> [!NOTE]
+>  クライアントとサービスが同じコンピューター上で実行されており、クライアントがシステム アカウント \(`Local System` や `Network Service` など\) で実行されているときに、ステートレスなセキュリティ コンテキスト トークンを使用してセキュリティで保護されたセッションを確立した場合は、クライアントを偽装できません。 通常、Windows フォームまたはコンソール アプリケーションは、現在ログインしているアカウントで実行されるため、既定でそのアカウントを偽装できます。 ただし、クライアントが [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ページであり、そのページが [!INCLUDE[iis601](../../../../includes/iis601-md.md)] または [!INCLUDE[iisver](../../../../includes/iisver-md.md)] でホストされている場合、既定では、クライアントは `Network Service` アカウントで実行されます。 セキュリティで保護されたセッションをサポートするシステム提供のすべてのバインディングは、ステートフルなセキュリティ コンテキスト トークン \(SCT: Security Context Token\) を既定で使用します。 ただし、クライアントが [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ページであり、ステートフルな SCT を使用する、セキュリティで保護されたセッションを使用している場合は、クライアントを偽装できません。 セキュリティで保護されたセッションでステートフルな SCT を使用する方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。  
+  
+## サービス メソッドでの偽装 : 宣言モデル  
+ ほとんどの偽装シナリオでは、呼び出し元のコンテキストでサービス メソッドを実行する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、ユーザーが <xref:System.ServiceModel.OperationBehaviorAttribute> 属性で偽装要件を指定できるようにすることで、これを容易に実行できるようにした偽装機能が用意されています。 たとえば、次のコードでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは `Hello` メソッドを実行する前に呼び出し元を偽装します。`Hello` メソッド内でネイティブ リソースへのアクセス試行が成功するのは、そのリソースのアクセス制御リスト \(ACL\) で呼び出し元のアクセス特権が許可されている場合だけです。 偽装を有効にするには、次の例に示すように、<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> プロパティを <xref:System.ServiceModel.ImpersonationOption> 列挙値のいずれか \(<xref:System.ServiceModel.ImpersonationOption?displayProperty=fullName> または <xref:System.ServiceModel.ImpersonationOption?displayProperty=fullName>\) に設定します。  
+  
+> [!NOTE]
+>  サービスの資格情報がリモート クライアントよりも高い場合は、<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> プロパティが <xref:System.ServiceModel.ImpersonationOption> に設定されていても、サービスの資格情報が使用されます。 つまり、低い特権を持つユーザーがその資格情報を提示した場合、そのユーザーよりも高い特権を持つサービスは、サービスの資格情報を使用してメソッドを実行し、特権の低いユーザーが本来は使用できないリソースを使用できることになります。  
+  
+ [!code-csharp[c_ImpersonationAndDelegation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_impersonationanddelegation/cs/source.cs#1)]
+ [!code-vb[c_ImpersonationAndDelegation#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_impersonationanddelegation/vb/source.vb#1)]  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャが呼び出し元を偽装できるのは、呼び出し元が Windows ユーザー アカウントにマップできる資格情報を使用して認証された場合だけです。 サービスが Windows アカウントにマップできない資格情報を使用して認証を行うように構成されている場合には、サービス メソッドは実行されません。  
+  
+> [!NOTE]
+>  [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、ステートフルな SCT が作成されると偽装が失敗し、<xref:System.InvalidOperationException> になります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)。  
+  
+## サービス メソッドでの偽装 : 強制モデル  
+ 呼び出し元がサービス メソッドの全体ではなく、一部を偽装するだけで、その機能が実行される場合があります。 この場合、サービス メソッド内で呼び出し元の Windows ID を取得し、偽装を強制的に実行します。 これを行うには、<xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> の <xref:System.ServiceModel.ServiceSecurityContext> プロパティを使用して <xref:System.Security.Principal.WindowsIdentity> クラスのインスタンスを返し、このインスタンスを使用する前に <xref:System.Security.Principal.WindowsIdentity.Impersonate%2A> メソッドを呼び出します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の `Using` ステートメント、または C\# の `using` ステートメントを使用して、偽装操作を自動的に元に戻すようにしてください。 これらのステートメントを使用しない場合、または [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] や C\# 以外のプログラミング言語を使用する場合は、偽装レベルを必ず元に戻してください。 この作業を怠ると、サービス拒否攻撃や権限の昇格攻撃のもとになるおそれがあります。  
+  
+ [!code-csharp[c_ImpersonationAndDelegation#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_impersonationanddelegation/cs/source.cs#2)]
+ [!code-vb[c_ImpersonationAndDelegation#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_impersonationanddelegation/vb/source.vb#2)]  
+  
+## すべてのサービス メソッドの偽装  
+ サービスのすべてのメソッドを呼び出し元のコンテキストで実行することが必要になる場合があります。 メソッドごとにこの機能を明示的に有効にするのではなく、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> を使用します。 次のコードに示すように、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ImpersonateCallerForAllOperations%2A> プロパティを `true` に設定します。<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> は、<xref:System.ServiceModel.ServiceHost> クラスの動作コレクションから取得されます。 また、各メソッドに適用する `Impersonation` の <xref:System.ServiceModel.OperationBehaviorAttribute> プロパティを <xref:System.ServiceModel.ImpersonationOption> または <xref:System.ServiceModel.ImpersonationOption> に設定することも必要です。  
+  
+ [!code-csharp[c_ImpersonationAndDelegation#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_impersonationanddelegation/cs/source.cs#3)]
+ [!code-vb[c_ImpersonationAndDelegation#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_impersonationanddelegation/vb/source.vb#3)]  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と `ImpersonationOption` の可能なすべての組み合わせに対する `ImpersonateCallerForAllServiceOperations` の動作を次の表に示します。  
+  
+|`ImpersonationOption`|`ImpersonateCallerForAllServiceOperations`|動作|  
+|---------------------------|------------------------------------------------|--------|  
+|必須|適用なし|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、呼び出し元を偽装します。|  
+|Allowed|false|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、呼び出し元を偽装しません。|  
+|Allowed|TRUE|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、呼び出し元を偽装します。|  
+|NotAllowed|false|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、呼び出し元を偽装しません。|  
+|NotAllowed|TRUE|使用できません  \(<xref:System.InvalidOperationException> がスローされます\)。|  
+  
+## Windows 資格情報とキャッシュされたトークンの偽装から取得する偽装レベル  
+ Windows クライアント資格情報の使用時にサービスが実行する偽装のレベルを、クライアントが部分的に制御するシナリオがあります。 クライアントが匿名偽装レベルを指定した場合に発生するシナリオもあれば、 キャッシュされたトークンを使用して偽装を実行した場合に発生するシナリオもあります。 これを行うには、<xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> クラスの <xref:System.ServiceModel.Security.WindowsClientCredential> プロパティを設定します。このクラスには、ジェネリック クラス <xref:System.ServiceModel.ChannelFactory%601> のプロパティとしてアクセスします。  
+  
+> [!NOTE]
+>  匿名偽装レベルを指定すると、クライアントはサービスに匿名でログオンします。 したがって、偽装を実行するかどうかに関係なく、サービスは匿名ログオンを許可する必要があります。  
+  
+ クライアントは、偽装レベルとして <xref:System.Security.Principal.TokenImpersonationLevel>、<xref:System.Security.Principal.TokenImpersonationLevel>、<xref:System.Security.Principal.TokenImpersonationLevel>、または <xref:System.Security.Principal.TokenImpersonationLevel> を指定できます。 次のコードに示すように、指定したレベルのトークンだけが作成されます。  
+  
+ [!code-csharp[c_ImpersonationAndDelegation#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_impersonationanddelegation/cs/source.cs#4)]
+ [!code-vb[c_ImpersonationAndDelegation#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_impersonationanddelegation/vb/source.vb#4)]  
+  
+ キャッシュされたトークンを使用して偽装するときに、サービスが取得する偽装レベルを次の表に示します。  
+  
+|`AllowedImpersonationLevel` の値|サービスに `SeImpersonatePrivilege` がある|サービスとクライアントに処理を代行する機能がある|キャッシュされたトークンの `ImpersonationLevel`|  
+|------------------------------------|----------------------------------------|------------------------------|----------------------------------------|  
+|Anonymous|はい|適用なし|偽装|  
+|Anonymous|いいえ|適用なし|識別|  
+|識別|適用なし|適用なし|識別|  
+|偽装|はい|適用なし|偽装|  
+|偽装|いいえ|適用なし|識別|  
+|処理の代行|はい|はい|処理の代行|  
+|処理の代行|はい|いいえ|偽装|  
+|処理の代行|いいえ|適用なし|識別|  
+  
+## ユーザー名資格情報とキャッシュされたトークンの偽装から取得する偽装レベル  
+ クライアントがユーザー名とパスワードをサービスに渡すことで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はそのユーザーとしてログオンできるようになります。これは、`AllowedImpersonationLevel` プロパティを <xref:System.Security.Principal.TokenImpersonationLevel> に設定することに相当します  \(`AllowedImpersonationLevel` は、<xref:System.ServiceModel.Security.WindowsClientCredential> クラスと <xref:System.ServiceModel.Security.HttpDigestClientCredential> クラスで使用できます\)。 サービスがユーザー名資格情報を受け取るときに取得する偽装レベルを次の表に示します。  
+  
+|`AllowedImpersonationLevel`|サービスに `SeImpersonatePrivilege` がある|サービスとクライアントに処理を代行する機能がある|キャッシュされたトークンの `ImpersonationLevel`|  
+|---------------------------------|----------------------------------------|------------------------------|----------------------------------------|  
+|適用なし|はい|はい|処理の代行|  
+|適用なし|はい|いいえ|偽装|  
+|適用なし|いいえ|適用なし|識別|  
+  
+## S4U ベースの偽装から取得する偽装レベル  
+  
+|サービスに `SeTcbPrivilege` がある|サービスに `SeImpersonatePrivilege` がある|サービスとクライアントに処理を代行する機能がある|キャッシュされたトークンの `ImpersonationLevel`|  
+|--------------------------------|----------------------------------------|------------------------------|----------------------------------------|  
+|はい|はい|適用なし|偽装|  
+|はい|いいえ|適用なし|識別|  
+|いいえ|適用なし|適用なし|識別|  
+  
+## クライアント証明書から Windows アカウントへのマッピング  
+ クライアントは、証明書を使用してサービスに対してクライアント自身を認証し、サービスが Active Directory を使用してクライアントを既存のアカウントにマップするように操作できます。 次の XML は、証明書をマップするためにサービスを構成する方法を示しています。  
+  
+```xml  
+  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="MapToWindowsAccount">  
+      <serviceCredentials>  
+        <clientCertificate>  
+          <authentication mapClientCertificateToWindowsAccount="true" />  
+        </clientCertificate>  
+      </serviceCredentials>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ 次のコードはサービスを構成する方法を示しています。  
+  
+```  
+  
+// Create a binding that sets a certificate as the client credential type.  
+WSHttpBinding b = new WSHttpBinding();  
+b.Security.Message.ClientCredentialType = MessageCredentialType.Certificate;  
+  
+// Create a service host that maps the certificate to a Windows account.  
+Uri httpUri = new Uri("http://localhost/Calculator");  
+ServiceHost sh = new ServiceHost(typeof(HelloService), httpUri);  
+sh.Credentials.ClientCertificate.Authentication.MapClientCertificateToWindowsAccount = true;  
+  
+```  
+  
+## 処理の代行  
+ バックエンド サービスに処理を代行させるには、サービスが Kerberos マルチレッグ \(NTLM にフォールバックしない SSPI\) を実行するか、クライアントの Windows ID を使用して、バックエンド サービスに対する Kerberos 直接認証を実行する必要があります。 バックエンド サービスに処理を代行させる場合、<xref:System.ServiceModel.ChannelFactory%601> とチャネルを作成し、クライアントを偽装している間、このチャネル経由で通信を行います。 この形式の委任では、バックエンド サービスとフロントエンド サービス間の距離は、フロントエンド サービスで実現される偽装レベルによって決まります。 偽装レベルが <xref:System.Security.Principal.TokenImpersonationLevel> の場合、フロントエンド サービスとバックエンド サービスは、同じコンピューター上で実行されている必要があります。 偽装レベルが <xref:System.Security.Principal.TokenImpersonationLevel> の場合、フロントエンド サービスとバックエンド サービスは、別々のコンピューター上にあっても、同じコンピューター上にあってもかまいません。 Delegation レベルの偽装を有効にする場合、委任を許可するように Windows ドメイン ポリシーを構成する必要があります。 委任をサポートできるように Active Directory を構成する方法の詳細については、「[Enabling Delegated Authentication \(委任認証の有効化\)](http://go.microsoft.com/fwlink/?LinkId=99690)」を参照してください。  
+  
+> [!NOTE]
+>  バックエンド サービスで Windows アカウントに対応するユーザー名とパスワードを使用して、フロントエンド サービスに対するクライアント認証を行うと、フロントエンド サービスはこのユーザー名とパスワードを再利用して、バックエンド サービスに対する認証を行うことができます。 ユーザー名とパスワードをバックエンド サービスに渡すことで、バックエンド サービスが偽装を実行できるため、これは ID フローの特に強力な形式と言えますが、Kerberos を使用しないため、委任は構成されません。 Active Directory による委任の制御は、ユーザー名\/パスワード認証には適用されません。  
+  
+### 偽装レベルの 1 つの機能としての委任機能  
+  
+|偽装レベル|サービスがプロセス間の委任を実行できる|サービスがコンピューター間の委任を実行できる|  
+|-----------|-------------------------|----------------------------|  
+|<xref:System.Security.Principal.TokenImpersonationLevel>|いいえ|いいえ|  
+|<xref:System.Security.Principal.TokenImpersonationLevel>|○|いいえ|  
+|<xref:System.Security.Principal.TokenImpersonationLevel>|はい|はい|  
+  
+ 委任の使用方法を次のコード例に示します。  
+  
+ [!code-csharp[c_delegation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_delegation/cs/source.cs#1)]
+ [!code-vb[c_delegation#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_delegation/vb/source.vb#1)]  
+  
+### 制約された委任を使用するようにアプリケーションを構成する方法  
+ 制約された委任を使用するには、送信側、受信側、およびドメイン コントローラーを制約された委任を使用するように構成する必要があります。 制約された委任を有効にする手順を以下に示します。 委任と制約された委任の違いの詳細については、「[Windows Server 2003 Kerberos Extensions \(Windows Server 2003 Kerberos 拡張機能\)](http://go.microsoft.com/fwlink/?LinkId=100194)」の制約された委任に関する部分を参照してください。  
+  
+1.  ドメイン コントローラーで、クライアント アプリケーションを実行しているアカウントの **\[アカウントは重要なので委任できない\]** チェック ボックスをオフにします。  
+  
+2.  ドメイン コントローラーで、クライアント アプリケーションを実行しているアカウントの **\[アカウントは委任に対して信頼されている\]** チェック ボックスをオンにします。  
+  
+3.  ドメイン コントローラーで、**\[コンピューターを委任に対して信頼する\]** をクリックして、委任に対して信頼されるように中間層コンピューターを構成します。  
+  
+4.  ドメイン コントローラーで、**\[指定されたサービスへの委任でのみこのコンピューターを信頼する\]** をクリックして、制約された委任を使用するように中間層コンピューターを構成します。  
+  
+ 制約された委任を構成する手順の詳細については、MSDN の次のトピックを参照してください。  
+  
+-   [Kerberos 委任のトラブルシューティング](http://go.microsoft.com/fwlink/?LinkId=36724)  
+  
+-   [Kerberos プロトコルの遷移および制約委任](http://go.microsoft.com/fwlink/?LinkId=36725)  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationBehaviorAttribute>   
+ <xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A>   
+ <xref:System.ServiceModel.ImpersonationOption>   
+ <xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A>   
+ <xref:System.ServiceModel.ServiceSecurityContext>   
+ <xref:System.Security.Principal.WindowsIdentity>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>   
+ <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ImpersonateCallerForAllOperations%2A>   
+ <xref:System.ServiceModel.ServiceHost>   
+ <xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A>   
+ <xref:System.ServiceModel.Security.WindowsClientCredential>   
+ <xref:System.ServiceModel.ChannelFactory%601>   
+ <xref:System.Security.Principal.TokenImpersonationLevel>   
+ [トランスポート セキュリティでの偽装の使用](../../../../docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md)   
+ [クライアントの偽装](../../../../docs/framework/wcf/samples/impersonating-the-client.md)   
+ [方法 : サービスでクライアントに偽装する](../../../../docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/denial-of-service.md b/docs/framework/wcf/feature-details/denial-of-service.md
new file mode 100644
index 00000000000..1d2f95b687b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/denial-of-service.md
@@ -0,0 +1,96 @@
+---
+title: "サービス拒否 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス拒否 [WCF]"
+ms.assetid: dfb150f3-d598-4697-a5e6-6779e4f9b600
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# サービス拒否
+サービス拒否は、メッセージを処理できなくしたり、メッセージ処理を大幅に遅延させたりするなど、システムに過大な負荷が生じた場合に発生します。  
+  
+## 過度のメモリ消費  
+ 一意のローカル名、名前空間、またはプレフィックスを大量に含んだ XML ドキュメントを読み込むと、問題が発生する場合があります。  <xref:System.Xml.XmlReader> から派生したクラスを使用している場合、<xref:System.Xml.XmlReader.LocalName%2A>、<xref:System.Xml.XmlReader.Prefix%2A>、または <xref:System.Xml.XmlReader.NamespaceUri%2A> のいずれかのプロパティが項目ごとに呼び出され、それによって返された文字列が <xref:System.Xml.NameTable> に追加されます。  <xref:System.Xml.NameTable> が保持するコレクションのサイズは決して減ることがありません。その結果、文字列ハンドルの実質的な "メモリ リーク" が発生する場合があります。  
+  
+ 回避事項を次に示します。  
+  
+-   <xref:System.Xml.NameTable> からの派生クラスを作成し、最大サイズのクォータを指定します   \(<xref:System.Xml.NameTable> の使用を回避したり、サイズが上限に達したときに <xref:System.Xml.NameTable> を切り替えたりすることはできません\)。  
+  
+-   可能であれば、前述のプロパティを使用せずに、<xref:System.Xml.XmlReader.MoveToAttribute%2A> メソッドと <xref:System.Xml.XmlReader.IsStartElement%2A> メソッドを使用します。これらのメソッドでは、文字列が返されないため、<xref:System.Xml.NameTable> コレクションがあふれてしまう問題を回避できます。  
+  
+## 悪質なクライアントにより過度のライセンス要求がサービスに送信される  
+ 悪質なクライアントが過度のライセンス要求を実行してサービスを攻撃する場合、サーバーは過度のメモリを使用することになります。  
+  
+ 回避方法 : <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings> クラスの次のプロパティを使用します。  
+  
+-   <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.MaxCachedCookies%2A> : `SPNego` または `SSL` ネゴシエーションの後にサーバーがキャッシュする、期限付きの `SecurityContextToken` の最大数を制御します。  
+  
+-   <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.IssuedCookieLifetime%2A> : `SPNego` または `SSL` ネゴシエーションに続いてサーバーが発行する `SecurityContextTokens` の有効期限を制御します。  サーバーは、この期間の `SecurityContextToken` をキャッシュします。  
+  
+-   <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.MaxPendingSessions%2A>: サーバーで確立されているが、そのアプリケーション メッセージが処理されていない、セキュリティで保護されたメッセージ交換の最大数を制御します。  このクォータは、クライアントが、セキュリティで保護されたメッセージ交換をサービスで確立しないようにします。それによって、サービスはクライアントごとの状態を保持できますが、それらの状態を使用することはありません。  
+  
+-   <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.InactivityTimeout%2A> : サービスが、セキュリティで保護されたメッセージ交換を、その当事者のクライアントからのアプリケーション メッセージを受信しなくても確立したままにする最長時間を制御します。  このクォータは、クライアントが、セキュリティで保護されたメッセージ交換をサービスで確立しないようにします。それによって、サービスはクライアントごとの状態を保持できますが、それらの状態を使用することはありません。  
+  
+## WSDualHttpBinding または二重カスタム バインディングにクライアント認証が必要になる  
+ 既定では、<xref:System.ServiceModel.WSDualHttpBinding> のセキュリティは有効になっています。  ただし、<xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType%2A> プロパティを <xref:System.ServiceModel.MessageCredentialType> に設定してクライアント認証を無効にすると、第 3 のサービスで悪質なユーザーからサービス拒否攻撃を受ける可能性があります。  これは、悪質なクライアントが、メッセージ ストリームを第 3 のサービスに送信するようサービスに指示できるためです。  
+  
+ これを防ぐには、このプロパティを `None` に設定しないようにします。  二重メッセージ パターンを持つカスタム バインディングを作成する場合もこの可能性があることに注意してください。  
+  
+## 監査イベント ログがいっぱいになる可能性がある  
+ 悪意のあるユーザーに監査が有効になっていることを知られると、その攻撃者に監査エントリの書き込みにつながる無効なメッセージを送信される可能性があります。  このような方法で監査ログに書き込みが行われると、監査システムに障害が発生します。  
+  
+ これを防ぐには、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure%2A> プロパティを `true` に設定し、イベント ビューアーのプロパティを使用して監査動作を制御します。  イベント ビューアーを使用してイベント ログを表示および管理する方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[イベント ビューアー](http://go.microsoft.com/fwlink/?LinkId=186123)」を参照してください。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md).  
+  
+## IAuthorizationPolicy の無効な実装によりサービスが停止する可能性がある  
+ 欠陥のある <xref:System.IdentityModel.Policy.IAuthorizationPolicy> インターフェイスの実装で <xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%2A> メソッドを呼び出すと、サービスが停止する可能性があります。  
+  
+ 回避方法 : 信頼されたコードのみを使用します。  つまり、ユーザーが記述しテストしたコード、または信頼されたプロバイダーが提供するコードのみを使用します。  十分な検討を行わずに、<xref:System.IdentityModel.Policy.IAuthorizationPolicy> の信頼されない拡張をユーザーのコードに接続することを許可しないでください。  これは、サービスの実装で使用されるすべての拡張に当てはまります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、アプリケーション コードと、拡張ポイントを使用して接続される外部コードを区別しません。  
+  
+## Kerberos の最大トークン サイズの変更が必要になる場合がある  
+ クライアントが多数のグループ \(実際の数はグループにより異なるが、約 900\) に属している場合、メッセージ ヘッダーのブロックが 64 KB を超えると問題が発生する場合があります。  このような場合は、最大 Kerberos トークンサイズを Microsoft サポート オンラインの「[Internet Explorer Kerberos 認証は、IIS に接続している十分なバッファーのため、機能しません。](http://go.microsoft.com/fwlink/?LinkId=89176)」で説明されているとおりに増加できます。最大 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ サイズを Kerberos トークンの増加に合わせて増加させることが必要な場合もあります。  
+  
+## 自動登録によってコンピューターに同一サブジェクト名の証明書が複数発生する  
+ *自動登録*は、証明書用のユーザーとコンピューターを自動で登録する [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] の機能です。  この機能が有効になっているドメイン上にコンピューターがある場合、新しいコンピューターがネットワークに参加するたびに、クライアント認証を目的とする X.509 証明書が自動的に作成されローカル コンピューターの個人用証明書のストアに自動で挿入されます。  ただし、自動登録では、キャッシュに作成されたすべての証明書に同じサブジェクト名が使用されます。  
+  
+ この影響で、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを自動登録のドメインで開始できない場合があります。  コンピューターの完全修飾ドメイン ネーム システム \(DNS\) 名を持つ証明書が複数あるため、既定サービスの X.509 資格情報検索の条件が不明確になり、このような問題が発生します。  この場合、1 つは自動登録で作成された証明書、もう 1 つは自己発行された証明書です。  
+  
+ これを防ぐには、より厳密な [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)の検索条件を使用して、使用する正確な証明書を参照します。  たとえば、<xref:System.Security.Cryptography.X509Certificates.X509FindType> オプションを使用し、一意の拇印 \(ハッシュ\) により証明書を指定します。  
+  
+ 自動登録機能の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[Windows Server 2003 の証明書自動登録](http://go.microsoft.com/fwlink/?LinkId=95166)」を参照してください。  
+  
+## 複数の代替サブジェクト名の最後が承認に使用される  
+ まれなケースとして X.509 証明書に複数の代替サブジェクト名が含まれる場合、その代替サブジェクト名を使用して承認を行うと、承認は失敗する場合があります。  
+  
+## ACL を使用して構成ファイルを保護する  
+ [!INCLUDE[infocard](../../../../includes/infocard-md.md)] で発行されたトークンについては、必須およびオプションのクレームをコードおよび構成ファイルに指定できます。  これにより、対応する要素が、セキュリティ トークン サービスに送信される `RequestSecurityToken` メッセージに送出されます。  攻撃者は、コードまたは構成を変更して必須またはオプションのクレームを削除でき、対象サービスへのアクセスが許可されていないトークンをセキュリティ トークン サービスに発行させることができます。  
+  
+ これを防ぐには、コンピューターにアクセスして構成ファイルを変更する必要があります。  アクセス制御リスト \(ACL: Access Control List\) を使用して構成ファイルをセキュリティで保護します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、コードが構成から読み込まれる前に、そのコードをアプリケーション ディレクトリまたはグローバル アセンブリ キャッシュに格納する必要があります。  ディレクトリの ACL を使用してディレクトリをセキュリティで保護します。  
+  
+## 1 つのサービスに対して、セキュリティで保護されたセッションが最大数に達する  
+ クライアントがサービスにより正常に認証され、セキュリティで保護されたセッションがサービスと共に確立されると、クライアントがセッションをキャンセルするか、セッションの期限が切れるまで、サービスはそのセッションを追跡します。  セッションが確立されるたびに、1 つのサービスで同時にアクティブにできるセッションは上限に近づいていきます。  この上限に達した場合、1 つ以上のアクティブなセッションが期限切れになるかまたはクライアントによりキャンセルされるまで、そのサービスで新しいセッションの作成を試みるクライアントは拒否されます。  クライアントは 1 つのサービスで複数のセッションを保持できますが、その各セッションは上限に反映されます。  
+  
+> [!NOTE]
+>  ステートフルなセッションを使用する場合、前の段落は適用されません。  ステートフルなセッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。  
+  
+ これを防ぐには、<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの <xref:System.ServiceModel.Channels.SecurityBindingElement> プロパティを設定して、アクティブなセッションの最大数とセッションの最長有効期間の制限を設定します。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)   
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)   
+ [Denial of Service](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)   
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md b/docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md
new file mode 100644
index 00000000000..f1fa567d1b3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md
@@ -0,0 +1,115 @@
+---
+title: "インターネット インフォメーション サービスでホストされる WCF サービスの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04ebd329-3fbd-44c3-b3ab-1de3517e27d7
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# インターネット インフォメーション サービスでホストされる WCF サービスの配置
+IIS \(インターネット インフォメーション サービス\) でホストされている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの開発と展開には、次のタスクが含まれます。  
+  
+-   IIS、ASP.NET、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]、および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティブ化コンポーネントが正しくインストールおよび登録されていることを確認します。  
+  
+-   新しい IIS アプリケーションを作成するか、既存の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションを再利用します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス用の .svc ファイルを作成します。  
+  
+-   IIS アプリケーションにサービス実装を展開します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成します。  
+  
+ IIS によってホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの作成に関する詳細なチュートリアルについては、「[方法 : IIS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)」を参照してください。  
+  
+## IIS、ASP.NET、および WCF が正しくインストールおよび登録されていることの確認  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを正常に機能させるには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]、IIS、および ASP.NET をインストールする必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] \([!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] の一部として\)、ASP.NET、および IIS のインストール手順は、使用しているオペレーティング システムのバージョンによって異なります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] および [!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] のインストール[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Microsoft .NET Framework 4.0 \(Web インストーラー\)](http://go.microsoft.com/fwlink/?LinkId=201185)」を参照してください。 IIS のインストール手順については、「[IIS のインストール](http://go.microsoft.com/fwlink/?LinkId=201188)」を参照してください。  
+  
+ IIS が既にコンピューターにインストールされている場合は、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] のインストール プロセスにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が IIS に自動登録されます。[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] の後に IIS をインストールした場合は、追加の手順に従って、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を IIS と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] に登録する必要があります。 使用しているオペレーティング システムに応じて、次のように実行します。  
+  
+-   [!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)]、Windows 7、および [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]: [ServiceModel 登録ツール \(ServiceModelReg.exe\)](../../../../docs/framework/wcf/servicemodelreg-exe.md) ツールを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を IIS に登録します。このツールを使用するには、Visual Studio コマンド プロンプトに「**ServiceModelReg.exe \/i \/x**」と入力します。 このコマンド プロンプトを開くには、\[スタート\] ボタンをクリックし、**\[すべてのプログラム\]**、**\[Microsoft Visual Studio 2012\]**、**\[Visual Studio ツール\]** の順にポイントし、**\[Visual Studio コマンド プロンプト\]** をクリックします。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] : [!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] のサブコンポーネントの Windows Communication Foundation アクティベーション コンポーネントをインストールします。 これを行うには、\[コントロール パネル\] の **\[プログラムの追加と削除\]** をクリックして、**\[Windows コンポーネントの追加と削除\]** をクリックします。**Windows コンポーネント ウィザード**がアクティブになります。  
+  
+-   Windows 7:  
+  
+ 最後に、ASP.NET が .NET Framework Version 4 を使用するように設定されていることを確認する必要があります。 これには、–i オプションを指定して ASPNET\_Regiis ツールを実行します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ASP.NET IIS 登録ツール](http://go.microsoft.com/fwlink/?LinkId=201186)  
+  
+## 新しい IIS アプリケーションの作成、または既存の ASP.NET アプリケーションの再利用  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、IIS アプリケーションの内部に存在する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのみをホストする新しい IIS アプリケーションを作成できます。 または、既に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンテンツ \(.aspx ページや ASP.NET Web サービス \(ASMX\) など\) をホストしている既存のアプリケーションに [!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] サービスを展開することもできます。 これらのオプション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」の「WCF と ASP.NET の並行ホスト」および「ASP.NET 互換モードでの WCF サービスのホスト」のセクションを参照してください。  
+  
+ [!INCLUDE[iis601](../../../../includes/iis601-md.md)] とそれ以降のバージョンでは、隔離されているオブジェクト指向プログラミング アプリケーションは定期的に再起動されることに注意してください。 既定値は 1740 分です。 サポートされている最大値は 71,582 分です。 この再起動は、無効にできます。 このプロパティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[PeriodicRestartTime](http://go.microsoft.com/fwlink/?LinkId=109968)」を参照してください。  
+  
+## WCF サービス用の .svc ファイルの作成  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、IIS アプリケーションの内部で特別なコンテンツ ファイル \(.svc ファイル\) として表現されます。 これは、ASMX ページが、IIS アプリケーションの内部で .asmx ファイルとして表現されるのと同様です。 .svc ファイルには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスト インフラストラクチャで、着信メッセージに応えてホスト対象サービスをアクティブ化できるようにする、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 固有の処理ディレクティブ \([@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md)\) が含まれます。 .svc ファイルの最も一般的な構文を次のステートメントに示します。  
+  
+```  
+<% @ServiceHost Service="MyNamespace.MyServiceImplementationTypeName" %>  
+```  
+  
+ この構文には、[@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブと単一の属性 `Service` が含まれます。`Service` 属性の値は、サービス実装の共通言語ランタイム \(CLR: Common Language Runtime\) 型名です。 このディレクティブを使用することは、次のコードを使用してサービス ホストを作成することと基本的に同じです。  
+  
+```  
+new ServiceHost( typeof( MyNamespace.MyServiceImplementationTypeName ) );  
+```  
+  
+ サービスのベース アドレスの一覧を作成するなど、追加のホスト構成を実行することもできます。 カスタム <xref:System.ServiceModel.Activation.ServiceHostFactory> を使用して、このディレクティブをカスタム ホスト ソリューション用に拡張することもできます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする IIS アプリケーションは、<xref:System.ServiceModel.ServiceHost> インスタンスの作成とライフタイムの管理を実行しません。 管理対象の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスト インフラストラクチャは、.svc ファイルに対する最初の要求を受け取ったときに、必要な <xref:System.ServiceModel.ServiceHost> インスタンスを動的に作成します。 このインスタンスは、コードによって明示的に閉じられるか、アプリケーションがリサイクルされるときまで解放されません。  
+  
+ .svc ファイルの構文[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md)」を参照してください。  
+  
+## IIS アプリケーションへのサービス実装の展開  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] と同一の動的なコンパイル モデルを使用します。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の場合と同様に、IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実装コードは、次のようないくつかの方法でさまざまな場所に展開できます。  
+  
+-   グローバル アセンブリ キャッシュ \(GAC: Global Assembly Cache\) またはアプリケーションの \\bin ディレクトリに配置される、プリコンパイルされた .dll ファイルとして展開します。 プリコンパイルされたバイナリは、新しいバージョンのクラス ライブラリが展開されるまで更新されません。  
+  
+-   アプリケーションの \\App\_Code ディレクトリに配置される、コンパイル解除されたソース ファイルとして展開します。 このディレクトリに配置されたソース ファイルは、アプリケーションの最初の要求を処理するときに動的に要求されます。 \\App\_Code ディレクトリ内のファイルを変更すると、次の要求を受け取ったときにアプリケーション全体がリサイクルされ、再コンパイルされます。  
+  
+-   .svc ファイルに直接格納される、コンパイル解除されたコードとして展開します。 また、実装コードも、サービスの .svc ファイル内の @ServiceHost ディレクティブの後にインラインで配置できます。 インライン コードを変更すると、次の要求を受け取ったときにアプリケーションがリサイクルされ、再コンパイルされます。  
+  
+ [!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] コンパイル モデル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ASP.NET コンパイルの概要](http://go.microsoft.com/fwlink/?LinkId=94773)」を参照してください。  
+  
+## WCF サービスの構成  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの構成は、アプリケーションの Web.config ファイルに格納されます。 IIS でホストされるサービスは、IIS の外部でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同じ構成要素と構文を使用します。 ただし、次の制約は、IIS ホスト環境に固有です。  
+  
+-   IIS でホストされるサービスのベース アドレス。  
+  
+-   IIS の外部の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストするアプリケーションは、ベース アドレス URI のセットを <xref:System.ServiceModel.ServiceHost> コンストラクターに渡すか、サービスの構成に [\<host\>](../../../../docs/framework/configure-apps/file-schema/wcf/host.md) 要素を指定することによって、ホストするサービスのベース アドレスを制御できます。 IIS でホストされるサービスは、それぞれのベース アドレスを制御できません。IIS でホストされるサービスのベース アドレスは、その .svc ファイルのアドレスです。  
+  
+### IIS でホストされるサービスのエンドポイント アドレス  
+ IIS でホストされるときのエンドポイント アドレスは、常にサービスを表す .svc ファイルのアドレスを基準にした相対アドレスと見なされます。 たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのベース アドレスが http:\/\/localhost\/Application1\/MyService.svc で、次のエンドポイント構成を伴う場合  
+  
+```  
+<endpoint address="anotherEndpoint" .../>  
+```  
+  
+ "http:\/\/localhost\/Application1\/MyService.svc\/anotherEndpoint" に到達できるエンドポイントが得られます。  
+  
+ 同様に、相対アドレスとして空の文字列を使用するエンドポイント構成要素では、ベース アドレスである http:\/\/localhost\/Application1\/MyService.svc に到達できるエンドポイントが得られます。  
+  
+```  
+<endpoint address="" ... />  
+```  
+  
+ IIS でホストされるサービスのエンドポイントには、常に相対エンドポイント アドレスを使用する必要があります。 完全修飾されたエンドポイント アドレス \(http:\/\/localhost\/MyService.svc など\) を指定すると、エンドポイント アドレスが、エンドポイントを公開するサービスをホストする IIS アプリケーションを指さない場合、サービスの展開エラーになる可能性があります。 ホストされるサービスに相対エンドポイント アドレスを使用すると、このような競合が回避されます。  
+  
+### 利用可能なトランスポート  
+ IIS 5.1 および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でホストされる [!INCLUDE[iis601](../../../../includes/iis601-md.md)] サービスが使用できるのは、HTTP ベースの通信のみに制限されています。 これらの IIS プラットフォームでホストされるサービスで、非 HTTP バインドを使用するように構成すると、サービスをアクティブ化するときにエラーが発生します。[!INCLUDE[iisver](../../../../includes/iisver-md.md)] でサポートされるトランスポートには、既存の MSMQ アプリケーションとの後方互換性を実現する HTTP、Net.TCP、Net.Pipe、Net.MSMQ、msmq.formatname があります。  
+  
+### HTTP トランスポート セキュリティ  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、サービスを格納する IIS 仮想ディレクトリで設定がサポートされている場合、HTTP トランスポート セキュリティ \(基本認証、ダイジェスト認証、Windows 統合認証などの HTTPS および HTTP 認証\) を利用できます。 ホストされるエンドポイントのバインディングでの HTTP トランスポート セキュリティ設定は、そのエンドポイントを格納する IIS 仮想ディレクトリでのトランスポート セキュリティ設定と一致する必要があります。  
+  
+ たとえば、HTTP ダイジェスト認証を使用するように構成された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、HTTP ダイジェスト認証を許可するように構成された IIS 仮想ディレクトリに存在する必要があります。 IIS の設定と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントの設定の組み合わせが一致しない場合、サービスをアクティブ化するときにエラーが発生します。  
+  
+## 参照  
+ [インターネット インフォメーション サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)   
+ [インターネット インフォメーション サービス ホスティングのベスト プラクティス](../../../../docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/diagnosing-transactional-applications.md b/docs/framework/wcf/feature-details/diagnosing-transactional-applications.md
new file mode 100644
index 00000000000..3f2c7d10323
--- /dev/null
+++ b/docs/framework/wcf/feature-details/diagnosing-transactional-applications.md
@@ -0,0 +1,133 @@
+---
+title: "トランザクション アプリケーションの診断 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a993492-1088-4d10-871b-0c09916af05f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# トランザクション アプリケーションの診断
+このトピックでは、トランザクションのアプリケーションをトラブルシューティングするために、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に用意されている管理機能および診断機能の使用方法について説明します。  
+  
+## パフォーマンス カウンター  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、トランザクション アプリケーションのパフォーマンスを測定するための、標準のパフォーマンス カウンターが用意されています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[WCF パフォーマンス カウンター](../../../../docs/framework/wcf/diagnostics/performance-counters/index.md)」を参照してください。  
+  
+ パフォーマンス カウンターには次の表に示すように、サービス、エンドポイント、操作の 3 つのレベルがあります。  
+  
+### サービス パフォーマンス カウンター  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|トランザクション フロー|このサービスで操作に対して実行されたトランザクションの数です。  このカウンターは、サービスに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+|1 秒あたりのトランザクション フロー|このサービスの操作に対して実行された 1 秒あたりのトランザクションの数です。  このカウンターは、サービスに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+|コミットされたトランザクション操作|このサービスで、結果がコミットされた状態で完了したトランザクション操作の数です。  そのような操作中に実行された作業は完全にコミットされました。  リソースは、操作で実行された作業に応じて更新されます。|  
+|1 秒あたりのコミットされたトランザクション操作|このサービスで、結果がコミットされた状態で完了したトランザクション操作の 1 秒あたりの数です。  そのような操作中に実行された作業は完全にコミットされました。  リソースは、操作で実行された作業に応じて更新されます。|  
+|中止されたトランザクション操作|このサービスで、結果が中止された状態で完了したトランザクション操作の数です。  そのような操作中に実行された作業はロールバックされました。  リソースは、それぞれの直前の状態に復元されました。|  
+|1 秒あたりの中止されたトランザクション操作|このサービスで、結果が中止された状態で完了したトランザクション操作の 1 秒あたりの数です。  そのような操作中に実行された作業はロールバックされました。  リソースは、それぞれの直前の状態に復元されました。|  
+|不明なトランザクション操作|このサービスで、結果が不明な状態で完了したトランザクション操作の数です。  結果が不明な作業は中間状態になります。  リソースは、保留中となります。|  
+|1 秒あたりの不明なトランザクション操作|このサービスで、結果が不明な状態で完了したトランザクション操作の 1 秒あたりの数です。  結果が不明な作業は中間状態になります。  リソースは、保留中となります。|  
+  
+### エンドポイントのパフォーマンス カウンター  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|トランザクション フロー|このエンドポイントでの操作に対して実行されたトランザクションの数。  このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+|1 秒あたりのトランザクション フロー|毎秒ごとにこのエンドポイントでの操作に対して実行されたトランザクションの数。  このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+  
+### 操作パフォーマンス カウンター  
+  
+|パフォーマンス カウンター|説明|  
+|-------------------|--------|  
+|トランザクション フロー|このエンドポイントでの操作に対して実行されたトランザクションの数。  このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+|1 秒あたりのトランザクション フロー|毎秒ごとにこのエンドポイントでの操作に対して実行されたトランザクションの数。  このカウンターは、エンドポイントに送信されたメッセージにトランザクションがある場合は常にインクリメントされます。|  
+  
+## WMI \(Windows Management Instrumentation\)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WMI \(Windows Management Instrumentation\) プロバイダーを介して実行時のサービスの検査データを公開します。  WMI データへのアクセス[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[診断用の WMI \(Windows Management Instrumentation\) の使用](../../../../docs/framework/wcf/diagnostics/wmi/index.md)」を参照してください。  
+  
+ WMI プロパティには、サービスに適用されるトランザクション設定を示す読み取り専用のプロパティが多数あります。  次の表にこれらの設定をすべて示します。  
+  
+ サービスの `ServiceBehaviorAttribute` には、次のプロパティがあります。  
+  
+|名前|種類|説明|  
+|--------|--------|--------|  
+|ReleaseServiceInstanceOnTransactionComplete|ブール型|現在のトランザクションの完了時に、サービス オブジェクトをリサイクルするかどうかを指定します。|  
+|TransactionAutoCompleteOnSessionClose|ブール型|現在のセッションの終了時に、保留中のトランザクションを完了するかどうかを指定します。|  
+|TransactionIsolationLevel|<xref:System.Transactions.IsolationLevel> 列挙体の有効な値を含む文字列。|このサービスがサポートするトランザクションの分離レベルを指定します。|  
+|TransactionTimeout|<xref:System.DateTime>|トランザクションを完了しなければならない期間を指定します。|  
+  
+ `ServiceTimeoutsBehavior` には、次のプロパティがあります。  
+  
+|名前|種類|説明|  
+|--------|--------|--------|  
+|TransactionTimeout|<xref:System.DateTime>|トランザクションを完了しなければならない期間を指定します。|  
+  
+ バインディングの `TransactionFlowBindingElement` には、次のプロパティがあります。  
+  
+|名前|種類|説明|  
+|--------|--------|--------|  
+|TransactionProtocol|<xref:System.ServiceModel.TransactionProtocol> 型の有効な値を含む文字列。|トランザクションをフローさせるために使用するトランザクション プロトコルを指定します。|  
+|TransactionFlow|ブール型|受信トランザクション フローを有効にするかどうかを指定します。|  
+  
+ 操作の `OperationBehaviorAttribute` には、次のプロパティがあります。  
+  
+|名前|種類|説明|  
+|--------|--------|--------|  
+|TransactionAutoComplete|ブール型|未処理の例外が発生しなかった場合に、現在のトランザクションを自動的にコミットするかどうかを指定します。|  
+|TransactionScopeRequired|ブール型|操作がトランザクションを必要とするかどうかを指定します。|  
+  
+ 操作の `TransactionFlowAttribute` には、次のプロパティがあります。  
+  
+|名前|種類|説明|  
+|--------|--------|--------|  
+|TransactionFlowOption|<xref:System.ServiceModel.TransactionFlowOption> 列挙体の有効な値を含む文字列。|トランザクション フローが要求される範囲を指定します。|  
+  
+## トレース  
+ トレースを使用すると、トランザクション アプリケーションにおけるエラーを監視および分析できます。  トレースは次の方法を使用して有効にできます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の標準トレース  
+  
+     このトレースは、通常の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションのトレースと同じものです。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[トレースの構成](../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」を参照してください。  
+  
+-   WS\-AtomicTransaction トレース  
+  
+     WS\-AtomicTransaction トレースは、[WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)を使用して有効にすることができます。  このトレースでは、トランザクションの状態とシステム内の参加要素を把握できます。  内部のサービス モデル トレースも有効にするには、`HKLM\SOFTWARE\Microsoft\WSAT\3.0\ServiceModelDiagnosticTracing` レジストリ キーを <xref:System.Diagnostics.SourceLevels> 列挙体の有効な値に設定します。  メッセージ ログは、他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションと同じ方法で有効にできます。  
+  
+-   `System.Transactions` トレース  
+  
+     OleTransactions プロトコルを使用する場合、プロトコル メッセージはトレースできません。  <xref:System.Transactions> インフラストラクチャではトレースがサポートされるため \(OleTransactions を使用\)、ユーザーはトランザクションで発生したイベントを確認できます。  <xref:System.Transactions> アプリケーションのトレースを有効にするには、`App.config` 構成ファイルに次のコードを含めます。  
+  
+    ```  
+    <configuration>  
+      <system.diagnostics>  
+         <sources>  
+            <source name="System.Transactions" switchValue="Verbose, ActivityTracing">  
+               <listeners>  
+                  <add name="Text"  
+                     type="System.Diagnostics.XmlWriterTraceListener"  
+                     initializeData="SysTx.log"  
+                     traceOutputOptions="Callstack" />  
+               </listeners>  
+            </source>  
+         </sources>  
+         <trace autoflush="true" indentsize="4">  
+         </trace>  
+      </system.diagnostics>  
+    </configuration>  
+    ```  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でも使用されるので、このコードにより、<xref:System.Transactions> のトレースも有効になります。  
+  
+## 参照  
+ [管理と診断](../../../../docs/framework/wcf/diagnostics/index.md)   
+ [トレースの構成](../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md b/docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md
new file mode 100644
index 00000000000..7ca1d0fce4f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md
@@ -0,0 +1,47 @@
+---
+title: "Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キュー [WCF], オペレーティング システム間の相違点"
+ms.assetid: aa809d93-d0a3-4ae6-a726-d015cca37c04
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点
+ここでは、[!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] における [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] キュー機能の相違について説明します。  
+  
+## アプリケーションごとの配信不能キュー  
+ キューに置かれたメッセージは、受信側のアプリケーションでタイムリーに読み取らなれないと、無期限にキューに残ることがあります。時間依存のメッセージでは、このような動作は適切ではありません。時間依存のメッセージとは、キューに置かれたバインディングで `TimeToLive` プロパティが設定されているメッセージです。このプロパティでは、メッセージの期限が切れるまでのキュー内での保持期間を指定します。期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。また、キューのクォータの超過、認証エラーの発生など、その他の理由でメッセージが配信不能キューに送信される場合もあります。  
+  
+ 通常は、同じキュー マネージャーを共有する、キューに置かれたすべてのアプリケーションに対して、システム全体の配信不能キューが 1 つ存在します。アプリケーションごとの配信不能キューを使用した場合は、個々のアプリケーションがそのアプリケーションごとの配信不能キューを指定できます。このため、キューに置かれた、同じキュー マネージャーを共有しているアプリケーション間の分離を改善できます。配信不能キューを他のアプリケーションと共有しているアプリケーションは、キューをブラウズしてそのアプリケーション用のメッセージを見つける必要があります。アプリケーションごとの配信不能キューが使用されている場合、アプリケーション専用の配信不能キューにあるメッセージはすべて、そのアプリケーション用ということになります。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] では、アプリケーションごとの配信不能キューが提供されます。[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、アプリケーションごとの配信不能キューを使用できないので、アプリケーションは、システム全体の配信不能キューを使用する必要があります。  
+  
+## 有害メッセージの処理  
+ 有害メッセージとは、受信側アプリケーションへの配信試行の回数が最大値を超えたメッセージのことです。この状況が生じるのは、トランザクション キューからメッセージを読み取るアプリケーションが、エラーなどの原因でメッセージをすぐに処理できないような場合です。アプリケーションは、キューに置かれたメッセージを受信したトランザクションを中止した場合、メッセージをキューに戻します。その後、アプリケーションは、新しいトランザクションで再度メッセージを取得しようとします。エラーを引き起こす問題が解決しないと、受信側のアプリケーションは、同じメッセージの受信と中止を繰り返すループから出られなくなる可能性があります。その結果、配信試行回数が最大値を超過し、有害メッセージの状況が生じます。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] のメッセージ キュー \(MSMQ\) には、有害メッセージの処理に関して次のような重要な相違点があります。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] の MSMQ はサブキューをサポートしますが、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] はサポートしません。サブキューは、有害メッセージ処理で使用されます。再試行キューと有害キューは、有害メッセージ処理の設定に基づいて作成されるアプリケーション キューのサブキューです。作成する再試行サブキューの数は、`MaxRetryCycles` で指定します。したがって、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] で実行している場合、`MaxRetryCycles` は無視されるため、`ReceiveErrorHandling.Move` は使用できません。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] の MSMQ では、否定受信確認がサポートされます。[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] の MSMQ ではサポートされません。受信側キュー マネージャーから否定受信確認を受け取ると、送信側キュー マネージャーは拒否されたメッセージを配信不能キューに入れます。そのため、`ReceiveErrorHandling.Reject` は、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では使用できません。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] の MSMQ は、メッセージの配信試行回数を保持するメッセージ プロパティをサポートします。この中止回数のプロパティは、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では使用できません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、中止回数をメモリで保持するため、同じメッセージが Web ファーム内の複数の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスによって読み取られた場合、このプロパティは、正確な値を格納できない可能性があります。  
+  
+## リモート トランザクション読み取り  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] 上の MSMQ は、リモート トランザクション読み取りをサポートします。これによって、キューから読み取りを行うアプリケーションを、そのキューをホストしているコンピューターとは別のコンピューター上でホストすることが可能になります。これにより、サービスのファーム全体で中央のキューから読み取りを行うことができるようになり、システムの全体のスループットが向上します。また、メッセージの読み取り中および処理中にエラーが発生した場合、トランザクションはロールバックし、メッセージは後で処理できるようにキューに残るようにもなります。  
+  
+## 参照  
+ [配信不能キューを使用したメッセージ転送エラー処理](../../../../docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md)   
+ [有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/diff-service-certificate-validation-ie-and-wcf.md b/docs/framework/wcf/feature-details/diff-service-certificate-validation-ie-and-wcf.md
new file mode 100644
index 00000000000..7d66c3d2971
--- /dev/null
+++ b/docs/framework/wcf/feature-details/diff-service-certificate-validation-ie-and-wcf.md
@@ -0,0 +1,27 @@
+---
+title: "Internet Explorer と WCF で実行されるサービス証明書の検証の相違点 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], サービス証明書の検証"
+  - "サービス証明書の検証 [WCF]"
+ms.assetid: 9dffcab2-70a9-40f0-99fd-d3a0b296028f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Internet Explorer と WCF で実行されるサービス証明書の検証の相違点
+HTTPS を使用した場合、Internet Explorer と [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ではサービス証明書の検証方法に違いがあるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントからサービス エンドポイントに正常にメッセージを送信できても、サービスのヘルプ ページや Web サービス記述言語 \(WSDL: Web Services Description Language\) に Internet Explorer からアクセスできないことがあります。これは、サービス証明書の拡張使用法フラグに `ServerAuthentication` オブジェクト識別子 \(OID: Object Identifier\) があるかどうかを Internet Explorer がチェックするのに対し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はそのような制限を適用しないためです。サービスのヘルプ ページまたはサービスの WSDL に Internet Explorer からアクセスできないときは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してそのサービスのメタデータにアクセスします。  
+  
+## 参照  
+ [HTTPS、SSL Over TCP、SOAP セキュリティ間における証明書検証方法の相違点](../../../../docs/framework/wcf/feature-details/cert-val-diff-https-ssl-over-tcp-and-soap.md)   
+ [方法 : メタデータの取得および準拠サービスの実装をする](../../../../docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md b/docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md
new file mode 100644
index 00000000000..a10f8bb283c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md
@@ -0,0 +1,304 @@
+---
+title: "探索プロキシで登録される探索可能なサービスの実装方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eb275bc1-535b-44c8-b9f3-0b75e9aa473b
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 探索プロキシで登録される探索可能なサービスの実装方法
+これは、探索プロキシの実装方法に関する&4; つのトピックのうちの&2; 番目のトピックです。 前のトピックで[方法: 探索プロキシの実装](../../../../docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md)、探索プロキシを実装します。 このトピックでは、アナウンス メッセージ ([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] および `Hello`) を探索プロキシに送信する `Bye` サービスを作成します。この送信により、サービスが探索プロキシに登録または登録解除されます。  
+  
+### <a name="to-define-the-service-contract"></a>サービス コントラクトを定義するには  
+  
+1.  新しいコンソール アプリケーション プロジェクトを、`DiscoveryProxyExample` という `Service` ソリューションに追加します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    1.  System.ServiceModel  
+  
+    2.  System.ServiceModel.Discovery  
+  
+3.  新しいクラスを `CalculatorService` プロジェクトに追加します。  
+  
+4.  次の using ステートメントを追加します。  
+  
+    ```  
+    using System;  
+    using System.ServiceModel;  
+    ```  
+  
+5.  CalculatorService.cs でサービス コントラクトを定義します。  
+  
+    ```  
+    // Define a service contract.  
+        [ServiceContract(Namespace = "http://Microsoft.Samples.Discovery")]  
+        public interface ICalculatorService  
+        {  
+            [OperationContract]  
+            double Add(double n1, double n2);  
+            [OperationContract]  
+            double Subtract(double n1, double n2);  
+            [OperationContract]  
+            double Multiply(double n1, double n2);  
+            [OperationContract]  
+            double Divide(double n1, double n2);  
+        }  
+  
+    ```  
+  
+6.  また、CalculatorService.cs でサービス コントラクトを実装します。  
+  
+    ```  
+    // Service class which implements the service contract.      
+        public class CalculatorService : ICalculatorService  
+        {  
+            public double Add(double n1, double n2)  
+            {  
+                double result = n1 + n2;  
+                Console.WriteLine("Received Add({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Subtract(double n1, double n2)  
+            {  
+                double result = n1 - n2;  
+                Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Multiply(double n1, double n2)  
+            {  
+                double result = n1 * n2;  
+                Console.WriteLine("Received Multiply({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Divide(double n1, double n2)  
+            {  
+                double result = n1 / n2;  
+                Console.WriteLine("Received Divide({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+        }  
+  
+    ```  
+  
+### <a name="to-host-the-service"></a>サービスをホストするには  
+  
+1.  プロジェクトの作成時に生成された Program.cs ファイルを開きます。  
+  
+2.  次の using ステートメントを追加します。  
+  
+    ```  
+    using System;  
+    using System.ServiceModel;  
+    using System.ServiceModel.Description;  
+    using System.ServiceModel.Discovery;  
+  
+    ```  
+  
+3.  `Main()` メソッド内に次のコードを追加します。  
+  
+    ```  
+  
+    // Define the base address of the service  
+    Uri baseAddress = new Uri("net.tcp://localhost:9002/CalculatorService/" + Guid.NewGuid().ToString());  
+    // Define the endpoint address where announcement messages will be sent  
+    Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");  
+  
+    // Create the service host  
+    ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);  
+    try  
+    {  
+       // Add a service endpoint  
+       ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new NetTcpBinding(), string.Empty);                
+  
+       // Create an announcement endpoint, which points to the Announcement Endpoint hosted by the proxy service.  
+       AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(), new EndpointAddress(announcementEndpointAddress));  
+  
+       // Create a ServiceDiscoveryBehavior and add the announcement endpoint  
+       ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();  
+                    serviceDiscoveryBehavior.AnnouncementEndpoints.Add(announcementEndpoint);  
+  
+       // Add the ServiceDiscoveryBehavior to the service host to make the service discoverable  
+       serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);  
+  
+       // Start listening for messages  
+      serviceHost.Open();  
+  
+       Console.WriteLine("Calculator Service started at {0}", baseAddress);  
+       Console.WriteLine();  
+       Console.WriteLine("Press <ENTER> to terminate the service.");  
+       Console.WriteLine();  
+       Console.ReadLine();  
+  
+       serviceHost.Close();  
+    }  
+    catch (CommunicationException e)  
+    {  
+       Console.WriteLine(e.Message);  
+    }  
+    catch (TimeoutException e)  
+    {  
+       Console.WriteLine(e.Message);  
+    }     
+  
+    if (serviceHost.State != CommunicationState.Closed)  
+    {  
+       Console.WriteLine("Aborting the service...");  
+       serviceHost.Abort();  
+    }  
+    ```  
+  
+ これで、探索サービスの実装が完了しました。 進んで[方法: 探索プロキシを使用して、サービスを検索するクライアント アプリケーションの実装](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)します。  
+  
+## <a name="example"></a>例  
+ このトピックで使用するコード全体の一覧を次に示します。  
+  
+```  
+// CalculatorService.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    // Define a service contract.  
+    [ServiceContract(Namespace = "http://Microsoft.Samples.Discovery")]  
+    public interface ICalculatorService  
+    {  
+        [OperationContract]  
+        double Add(double n1, double n2);  
+        [OperationContract]  
+        double Subtract(double n1, double n2);  
+        [OperationContract]  
+        double Multiply(double n1, double n2);  
+        [OperationContract]  
+        double Divide(double n1, double n2);  
+    }  
+  
+    // Service class which implements the service contract.      
+    public class CalculatorService : ICalculatorService  
+    {  
+        public double Add(double n1, double n2)  
+        {  
+            double result = n1 + n2;  
+            Console.WriteLine("Received Add({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Subtract(double n1, double n2)  
+        {  
+            double result = n1 - n2;  
+            Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Multiply(double n1, double n2)  
+        {  
+            double result = n1 * n2;  
+            Console.WriteLine("Received Multiply({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Divide(double n1, double n2)  
+        {  
+            double result = n1 / n2;  
+            Console.WriteLine("Received Divide({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// Program.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel;  
+using System.ServiceModel.Description;  
+using System.ServiceModel.Discovery;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    class Program  
+    {  
+        public static void Main()  
+        {  
+            Uri baseAddress = new Uri("net.tcp://localhost:9002/CalculatorService/" + Guid.NewGuid().ToString());  
+            Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");  
+  
+            ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress);  
+            try  
+            {  
+                ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new NetTcpBinding(), string.Empty);                
+  
+                // Create an announcement endpoint, which points to the Announcement Endpoint hosted by the proxy service.  
+                AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(), new EndpointAddress(announcementEndpointAddress));  
+                ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();  
+                serviceDiscoveryBehavior.AnnouncementEndpoints.Add(announcementEndpoint);  
+  
+                // Make the service discoverable  
+                serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);  
+  
+                serviceHost.Open();  
+  
+                Console.WriteLine("Calculator Service started at {0}", baseAddress);  
+                Console.WriteLine();  
+                Console.WriteLine("Press <ENTER> to terminate the service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+                serviceHost.Close();  
+            }  
+            catch (CommunicationException e)  
+            {  
+                Console.WriteLine(e.Message);  
+            }  
+            catch (TimeoutException e)  
+            {  
+                Console.WriteLine(e.Message);  
+            }     
+  
+            if (serviceHost.State != CommunicationState.Closed)  
+            {  
+                Console.WriteLine("Aborting the service...");  
+                serviceHost.Abort();  
+            }  
+        }  
+    }  
+}  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## <a name="see-also"></a>関連項目  
+ [WCF Discovery](../../../../docs/framework/wcf/feature-details/wcf-discovery.md)   
+ [方法: 探索プロキシの実装](../../../../docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md)   
+ [方法: 探索プロキシを使用して、サービスを検索するクライアント アプリケーションの実装](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/discovery-announcements-and-announcement-client.md b/docs/framework/wcf/feature-details/discovery-announcements-and-announcement-client.md
new file mode 100644
index 00000000000..987d35b4356
--- /dev/null
+++ b/docs/framework/wcf/feature-details/discovery-announcements-and-announcement-client.md
@@ -0,0 +1,105 @@
+---
+title: "探索アナウンスとアナウンス クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 426c6437-f8d2-4968-b23a-18afd671aa4b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 探索アナウンスとアナウンス クライアント
+[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の探索機能では、コンポーネントがその可用性をアナウンスできます。そのように構成されている場合、サービスは Hello アナウンスと Bye アナウンスを送信します。クライアントまたはその他のコンポーネントは、それらのアナウンス メッセージをリッスンして、対応します。これにより、クライアントは別の手段でサービスを認識します。アナウンス機能にはいくつかの用途があります。たとえば、サービスがネットワークに頻繁に出入りする場合は、サービスを検索するよりも、アナウンスを利用する方が効果的です。この方法を使用すると、ネットワーク トラフィックが減少し、クライアントは、アナウンスを受信するとすぐに、そのサービスが存在するかどうかを知ることができます。  
+  
+## 探索アナウンス  
+ アナウンスが構成されたサービスがネットワークに参加し、探索可能になると、そのサービスは、リッスンしているクライアントにそのサービスの可用性をアナウンスする Hello メッセージを送信します。このメッセージには、サービスのコントラクト、エンドポイント アドレス、および関連付けられたスコープなど、探索関連の情報が含まれています。アナウンス メッセージを送信する先を <xref:System.ServiceModel.Discovery.AnnouncementEndpoint> クラスで指定できます。アナウンス エンドポイントが <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> の場合、Hello および Bye はマルチキャストです。また、アナウンス エンドポイントがユニキャストの場合、メッセージは指定されたエンドポイントに直接送信されます。  
+  
+> [!NOTE]
+>  アナウンスは、サービス ホストが開いたときと閉じたときに送信されます。これらの呼び出しが適切に終了しない場合は、アナウンス メッセージが送信されないことがあります。たとえば、サービスがエラーになった場合は、Bye アナウンス メッセージが送信されません。  
+  
+> [!TIP]
+>  アナウンス機能をカスタマイズして、選択したタイミングでアナウンスを送信することができます。  
+  
+ [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] では、<xref:System.ServiceModel.Discovery.AnnouncementEndpoint> および <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> が標準エンドポイントとして定義されているため、サービスとクライアントが簡単に Hello アナウンスと Bye アナウンスを送信できます。  
+  
+### サービスのアナウンス  
+ アナウンスを送信するようにサービスを構成するには、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> をアナウンス エンドポイントと共に追加します。次の例は、この動作をプログラムでサービス ホストに追加する方法を示しています。この例では、アナウンスが、その標準エンドポイントで指定される場所へのマルチキャストであることを暗黙で示す `UdpAnnouncementEndpoint` を使用しています。  
+  
+```  
+ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();  
+serviceDiscoveryBehavior.AnnouncementEndpoints.Add(new UdpAnnouncementEndpoint());  
+serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);  
+```  
+  
+ この動作は、次の例に示すように、構成ファイルで構成することもできます。  
+  
+```  
+<services>  
+  <service behaviorConfiguration="CalculatorBehavior" name="Microsoft.Samples.Discovery.CalculatorService">  
+    <!--Add Discovery Endpoint-->  
+    <endpoint name="udpDiscoveryEpt" kind="udpDiscoveryEndpoint" />  
+  </service>  
+</services>  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorBehavior">  
+      <!--Add Discovery behavior-->  
+      <serviceDiscovery>  
+        <announcementEndpoints>  
+          <endpoint kind="udpAnnouncementEndpoint" />  
+        </announcementEndpoints>  
+      </serviceDiscovery>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ 前の例では、サービスが自動的にアナウンス メッセージを送信するように構成します。<xref:System.ServiceModel.Discovery.AnnouncementClient> クラスを使用して、アナウンス メッセージを明示的に送信することもできます。  
+  
+### クライアントのアナウンス  
+ クライアント アプリケーションは、アナウンス サービスをホストして Hello メッセージと Bye メッセージに応答し、<xref:System.ServiceModel.Discovery.AnnouncementService.OnlineAnnouncementReceived> イベントと <xref:System.ServiceModel.Discovery.AnnouncementService.OfflineAnnouncementReceived> イベントを定期受信する必要があります。その方法を次の例に示します。  
+  
+```  
+// Create an AnnouncementService instance  
+AnnouncementService announcementService = new AnnouncementService();  
+  
+// Subscribe the announcement events  
+announcementService.OnlineAnnouncementReceived += OnOnlineEvent;  
+announcementService.OfflineAnnouncementReceived += OnOfflineEvent;  
+  
+// Create ServiceHost for the AnnouncementService  
+using (ServiceHost announcementServiceHost = new ServiceHost(announcementService))  
+{  
+    // Listen for the announcements sent over UDP multicast  
+    announcementServiceHost.AddServiceEndpoint(new UdpAnnouncementEndpoint());  
+    announcementServiceHost.Open();  
+  
+    Console.WriteLine("Press <ENTER> to terminate.");  
+    Console.ReadLine();  
+}  
+  
+```  
+  
+ Hello メッセージまたは Bye メッセージを受信したら、次の例に示すように、<xref:System.ServiceModel.Discovery.AnnouncementEventArgs> を介してエンドポイント探索メタデータにアクセスできます。  
+  
+```  
+static void OnOnlineEvent(object sender, AnnouncementEventArgs e)  
+{  
+    Console.WriteLine("Received an online announcement from {0}",   
+e.EndpointDiscoveryMetadata.Address);  
+}  
+  
+static void OnOfflineEvent(object sender, AnnouncementEventArgs e)  
+{  
+    Console.WriteLine("Received an offline announcement from {0}",   
+e.EndpointDiscoveryMetadata.Address);  
+}  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/discovery-find-and-findcriteria.md b/docs/framework/wcf/feature-details/discovery-find-and-findcriteria.md
new file mode 100644
index 00000000000..7226a60c544
--- /dev/null
+++ b/docs/framework/wcf/feature-details/discovery-find-and-findcriteria.md
@@ -0,0 +1,80 @@
+---
+title: "探索検索と FindCriteria | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99016fa4-1778-495b-b4cc-0e22fbec42c6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 探索検索と FindCriteria
+探索検索操作は、1 つ以上のサービスを探索するためにクライアントによって開始される操作であり、探索における主要なアクションの 1 つです。検索を実行すると、WS\-Discovery Probe メッセージがネットワークを介して送信されます。指定された条件に一致するサービスは、WS\-Discovery ProbeMatch メッセージを使用して応答します。探索メッセージ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[WS\-Discovery の仕様](http://go.microsoft.com/fwlink/?LinkID=122347)を参照してください。  
+  
+## DiscoveryClient  
+ <xref:System.ServiceModel.Discovery.DiscoveryClient> クラスは、検索操作を実行するメカニズムを提供し、探索クライアントの操作を簡単に実行できるようにします。このクラスには、\(ブロックする\) 同期検索を実行する <xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> メソッドと、ブロックしない非同期検索を実行する <xref:System.ServiceModel.Discovery.DiscoveryClient.FindAsync%2A> メソッドが含まれます。どちらのメソッドも <xref:System.ServiceModel.Discovery.FindCriteria> パラメーターを使用し、<xref:System.ServiceModel.Discovery.FindResponse> オブジェクトを介してユーザーに結果を提供します。  
+  
+## FindCriteria  
+ <xref:System.ServiceModel.Discovery.FindCriteria> にはいくつかのプロパティがあり、検索対象のサービスを指定する検索条件と、検索を続行する期間を指定する検索終了条件に分類できます。<xref:System.ServiceModel.Discovery.FindCriteria> には、複数の検索条件を指定できます。既定では、サービスがすべての条件に一致する必要があり、そうでない場合は、サービスがそれ自体を一致サービスと見なしません。条件の一部にのみ一致するサービスを検索する場合は、サービスにカスタムの検索ロジックを実装するか、複数のクエリを使用します。  
+  
+ 検索条件は、次のとおりです。  
+  
+-   <xref:System.ServiceModel.Discovery.ContractTypeNames%2A> \- 省略できます。検索対象のサービスのコントラクト名、およびサービスの検索に通常使用される条件を指定します。複数のコントラクト名が指定されると、すべてのコントラクトに一致するサービス エンドポイントのみが応答します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、各エンドポイントでサポートされるコントラクトは 1 つだけです。  
+  
+-   <xref:System.ServiceModel.Discovery.Scopes%2A> \- 省略できます。Scopes は、個々のサービス エンドポイントの分類に使用される絶対 URI です。複数のエンドポイントが同じコントラクトを公開し、これらのエンドポイントのサブセットを検索する手段が必要な場合は、これを使用できます。複数のスコープが指定されると、すべてのスコープに一致するサービス エンドポイントのみが応答します。  
+  
+-   <xref:System.ServiceModel.Discovery.ScopeMatchBy%2A> \- Probe メッセージのスコープとエンドポイントのスコープとの一致の判定に使用する、一致アルゴリズムを指定します。サポートされているスコープ一致規則は、次の 5 つです。  
+  
+    -   <xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByExact%2A>: 大文字と小文字が区別される基本の文字列比較を実行します。  
+  
+    -   <xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByPrefix%2A>: "\/" によって区切られたセグメント単位で一致を判定します。http:\/\/contoso\/building1 を検索する場合、サービスは http:\/\/contoso\/building\/floor1 というスコープと一致します。http:\/\/contoso\/building100 とは、最後の 2 セグメントが一致しないため、一致しません。  
+  
+    -   <xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByLdap%2A>: LDAP URL を使用してセグメント単位でスコープの一致を判定します。  
+  
+    -   <xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByUuid%2A>: UUID 文字列を使用して、スコープが完全に一致するかどうかを判定します。  
+  
+    -   <xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByNone%2A>: スコープを指定していないサービスのみを対象に一致を判定します。  
+  
+     スコープ一致規則が指定されていない場合は、<xref:System.ServiceModel.Discovery.FindCriteria.ScopeMatchByPrefix%2A> が使用されます。  
+  
+ 終了条件は次のとおりです。  
+  
+1.  <xref:System.ServiceModel.Discovery.FindCriteria.Duration%2A> \- ネットワーク上でサービスからの応答を待機する最長時間。既定の時間は 20 秒です。  
+  
+2.  <xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> \- 待機する応答の最大件数。<xref:System.ServiceModel.Discovery.FindCriteria.Duration%2A> が経過する前に <xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> 応答が受信された場合は、検出操作が終了します。  
+  
+## FindResponse  
+ <xref:System.ServiceModel.Discovery.FindResponse> には、ネットワーク上で一致するサービスから送信された応答を保持する <xref:System.ServiceModel.Discovery.FindResponse.Endpoints%2A> コレクション プロパティがあります。応答したサービスがない場合、このコレクションは空です。1 つ以上のサービスが応答した場合、各応答は <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> オブジェクトに格納されます。これには、アドレスやコントラクトなど、サービスについての追加情報が含まれます。  
+  
+ 次の例は、コードで検索操作を実行する方法を示しています。  
+  
+```  
+// Create DiscoveryClient  
+DiscoveryClient discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint());  
+  
+// Create FindCriteria  
+FindCriteria findCriteria = new FindCriteria(typeof(IPrinterService));  
+findCriteria.Scopes.Add(new Uri("http://www.contoso.com/building1/floor1"));  
+findCriteria.Duration = TimeSpan.FromSeconds(10);   
+  
+// Find ICalculatorService endpoints              
+FindResponse findResponse = discoveryClient.Find(findCriteria);  
+  
+Console.WriteLine("Found {0} ICalculatorService endpoint(s).", findResponse.Endpoints.Count)  
+  
+```  
+  
+## 参照  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [探索クライアント チャネルの使用](../../../../docs/framework/wcf/feature-details/using-the-discovery-client-channel.md)   
+ [スコープを使用した探索](../../../../docs/framework/wcf/samples/discovery-with-scopes-sample.md)   
+ [非同期検索](../../../../docs/framework/wcf/samples/asynchronous-find-sample.md)   
+ [Basic](../../../../docs/framework/wcf/samples/basic-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/discovery-versioning.md b/docs/framework/wcf/feature-details/discovery-versioning.md
new file mode 100644
index 00000000000..d1b34fc42ac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/discovery-versioning.md
@@ -0,0 +1,57 @@
+---
+title: "探索機能のバージョン指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f91c6d0a-3af2-45c5-9a5c-e75390619836
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 探索機能のバージョン指定
+ここでは、新しい探索機能の実装の概要について簡単に説明します。  使用する探索バージョンを選択する方法の概要も示します。  
+  
+## 探索機能のバージョン指定  
+ 探索機能は、WS\_Discovery プロトコルの 3 つのバージョンをサポートします。  探索 API を使用すると、使用するプロトコルのバージョンを選択できます。  このドキュメントでは、バージョン指定に関連する設定について簡単に説明します。  
+  
+ 次の Discovery クラスには <xref:System.ServiceModel.Discovery.DiscoveryVersion> プロパティがあり、コンストラクターで <xref:System.ServiceModel.Discovery.DiscoveryVersion> 引数を受け取ります。  
+  
+-   <xref:System.ServiceModel.Discovery.AnnouncementEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint>  
+  
+### DiscoveryVersion.WSDiscoveryApril2005  
+ コンストラクターのパラメーターとして <xref:System.ServiceModel.Discovery.DiscoveryVersion.WSDiscoveryApril2005> を使用することで、WS\-Discovery プロトコルの April2005 バージョンが実装で使用されます。  このバージョンは、WS\-Discovery プロトコル仕様の発行済みバージョンに対応します。  このバージョンは、WS\-Discovery の April2005 バージョンを利用しているレガシ アプリケーションとの相互運用時に使用する必要があります。  
+  
+### DiscoveryVersion.WSDiscovery11  
+ API で使用される既定の探索機能のバージョンは <xref:System.ServiceModel.Discovery.DiscoveryVersion.WSDiscovery11> です。  これは、現在標準化されている WS\-Discovery プロトコルのバージョンです。  
+  
+## DiscoveryVersion.WSDiscoveryCD1  
+ コンストラクターのパラメーターとして <xref:System.ServiceModel.Discovery.DiscoveryVersion.WSDiscoveryCD1> を使用することで、WS\-Discovery プロトコルの Committee Draft 1 バージョンが実装で使用されます。  このバージョンのプロトコルは、WS\-Discovery プロトコルの CD1 バージョンを利用している実装との相互運用時に使用する必要があります。  
+  
+## 単一のサービス ホスト上にある異なる探索バージョン用の複数の UDP 探索エンドポイントのサポート  
+ 単一のサービス ホスト上にある、異なる探索バージョン用の複数の UDP 探索エンドポイントを公開する場合があります。  このような場合、UDP 探索エンドポイントごとに一意のアドレスを指定する必要があります。  その方法を次の例に示します。  
+  
+```  
+UdpDiscoveryEndpoint newVersionUdpEndpoint = new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscovery11);  
+UdpDiscoveryEndpoint oldVersionUdpEndpoint = new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscoveryApril2005);  
+  
+newVersionUdpEndpoint.Address = new EndpointAddress(newVersionUdpEndpoint.Address.Uri.ToString() + "/version11");  
+oldVersionUdpEndpoint.Address = new EndpointAddress(oldVersionUdpEndpoint.Address.Uri.ToString() + "/versionAril2005");  
+  
+serviceHost.AddServiceEndpoint(newVersionUdpEndpoint);  
+serviceHost.AddServiceEndpoint(oldVersionUdpEndpoint);  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/discoveryclient-and-dynamicendpoint.md b/docs/framework/wcf/feature-details/discoveryclient-and-dynamicendpoint.md
new file mode 100644
index 00000000000..696a7d69700
--- /dev/null
+++ b/docs/framework/wcf/feature-details/discoveryclient-and-dynamicendpoint.md
@@ -0,0 +1,125 @@
+---
+title: "DiscoveryClient と DynamicEndpoint | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7cd418f0-0eab-48d1-a493-7eb907867ec3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# DiscoveryClient と DynamicEndpoint
+<xref:System.ServiceModel.Discovery.DiscoveryClient> および <xref:System.ServiceModel.Discovery.DynamicEndpoint> の 2 つは、サービスの検索にクライアント側で使用されるクラスです。<xref:System.ServiceModel.Discovery.DiscoveryClient> は、特定の条件に一致するサービスの一覧を表示し、サービスに接続できるようにします。<xref:System.ServiceModel.Discovery.DynamicEndpoint> は同じ操作を実行するだけでなく、見つかったサービスの 1 つに自動的に接続します。<xref:System.ServiceModel.Discovery.DynamicEndpoint> には任意のエンドポイントを指定でき、構成に検索条件も追加できます。このため、ソリューションに探索機能が必要だが、クライアント ロジックを変更したくないという場合は、<xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用すると、エンドポイントを変更するだけで済み、便利です。これに対して、<xref:System.ServiceModel.Discovery.DiscoveryClient> は、検索操作を詳細に制御する場合に使用できます。次に、それぞれのクラスの用途と利点について詳しく説明します。  
+  
+## DiscoveryClient  
+ <xref:System.ServiceModel.Discovery.DiscoveryClient> は、同期および非同期の Find メソッド、<xref:System.ServiceModel.Discovery.DiscoveryClient.FindCompleted> イベント、および <xref:System.ServiceModel.Discovery.DiscoveryClient.FindProgressChanged> イベントを定義します。さらに、同期および非同期の Resolve メソッド、および <xref:System.ServiceModel.Discovery.DiscoveryClient.ResolveCompleted> イベントも定義します。<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> メソッドまたは <xref:System.ServiceModel.Discovery.DiscoveryClient.FindAsync%2A> メソッドを使用して、サービスを検索します。これらのメソッドは両方とも <xref:System.ServiceModel.Discovery.FindCriteria> インスタンスを受け取ります。このインスタンスにより、コントラクト型名、スコープ、要求した結果の最大数、およびスコープ一致規則の指定が可能になります。<xref:System.ServiceModel.Discovery.DiscoveryClient.FindAsync%2A> メソッドを呼び出す際には、<xref:System.ServiceModel.Discovery.DiscoveryClient.FindCompleted> イベントおよび <xref:System.ServiceModel.Discovery.DiscoveryClient.FindProgressChanged> イベントが使用できます。<xref:System.ServiceModel.Discovery.DiscoveryClient> がサービスからの応答を受け取るたびに、<xref:System.ServiceModel.Discovery.DiscoveryClient.FindProgressChanged> が発生します。これを使用して、検索操作の進捗状況を示すプログレス バーを表示できます。また、受け取った検索応答を処理するのにも使用できます。検索操作が完了すると、<xref:System.ServiceModel.Discovery.DiscoveryClient.FindCompleted> イベントが発生します。最大数の応答を受信した場合、または <xref:System.ServiceModel.Discovery.FindCriteria.Duration%2A> が経過した場合に、これが発生することがあります。検索操作が完了すると、結果が <xref:System.ServiceModel.Discovery.FindResponse> インスタンスで返されます。<xref:System.ServiceModel.Discovery.FindResponse> には <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のコレクションが含まれており、これには、一致するサービスのアドレス、コントラクト型名、拡張子、リッスン URI、およびスコープが格納されています。この情報を使用して、一致するいずれかのサービスに接続し、呼び出すことができます。次の例は、[the M:System.ServiceModel.Discovery.DiscoveryClient.Find\(System.ServiceModel.Discovery.FindCriteria\)](assetId:///the M:System.ServiceModel.Discovery.DiscoveryClient.Find(System.ServiceModel.Discovery.FindCriteria)?qualifyHint=False&autoUpgrade=True) メソッドを呼び出し、返されたメタデータを使用して、見つかったサービスを呼び出す方法を示しています。<xref:System.ServiceModel.Discovery.DiscoveryClient> を使用する利点は、見つかったエンドポイントのリストをキャッシュして、後で使用できることです。このキャッシュを使用して、さまざまなエラー状況を処理するカスタム ロジックを構築できます。  
+  
+```  
+DiscoveryClient dc = new DiscoveryClient(new UdpDiscoveryEndpoint());  
+  
+FindCriteria criteria = new FindCriteria(typeof(ICalculatorService));  
+FindResponse fr = dc.Find(criteria);  
+  
+if (fr.Endpoints.Count > 0)  
+{  
+   EndpointAddress ep = fr.Endpoints[0].Address;  
+   CalculatorServiceClient client = new CalculatorServiceClient();  
+  
+    // Connect to the discovered service endpoint  
+   client.Endpoint.Address = endpointAddress;  
+   Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress);  
+  
+   double value1 = 100.00D;  
+   double value2 = 15.99D;  
+  
+   // Call the Add service operation.  
+   double result = client.Add(value1, value2);  
+   Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+}  
+else  
+   Console.WriteLine(“No matching endpoints found”);  
+  
+```  
+  
+ 次の例は、検索操作を非同期で実行する方法を示しています。  
+  
+```  
+static void FindServiceAsync()  
+{  
+   DiscoveryClient dc = new DiscoveryClient(new UdpDiscoveryEndpoint());   
+   dc.FindCompleted += new EventHandler<FindCompletedEventArgs>( discoveryClient_FindCompleted);  
+   dc.FindProgressChanged += new EventHandler<FindProgressChangedEventArgs>(discoveryClient_FindProgressChanged);  
+   dc.FindAsync(new FindCriteria(typeof(ICalculatorService)));   
+}   
+static void discoveryClient_FindProgressChanged(object sender, FindProgressChangedEventArgs e)  
+{  
+   Console.WriteLine("Found service at: " + e.EndpointDiscoveryMetadata.Address  
+}   
+  
+static void discoveryClient_FindCompleted(object sender, FindCompletedEventArgs e)  
+{    
+      if (e.Result.Endpoints.Count > 0)  
+            {  
+                EndpointAddress ep = e.Result.Endpoints[0].Address;  
+                CalculatorServiceClient client = new CalculatorServiceClient();  
+  
+                // Connect to the discovered service endpoint  
+                client.Endpoint.Address = ep;  
+                Console.WriteLine("Invoking CalculatorService at {0}", ep);  
+  
+                double value1 = 100.00D;  
+                double value2 = 15.99D;  
+  
+                double result = client.Add(value1, value2);  
+                Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+            }  
+            else  
+                Console.WriteLine("No matching endpoints found");  
+  
+        }  
+  
+```  
+  
+ 非同期の検索呼び出し[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[非同期検索](../../../../docs/framework/wcf/samples/asynchronous-find-sample.md)」を参照してください。  
+  
+ エンドポイント アドレスに基づいてサービスを検索するには、<xref:System.ServiceModel.Discovery.DiscoveryClient.Resolve%2A> メソッドおよび <xref:System.ServiceModel.Discovery.ResolveAsync%28System.ServiceModel.Discovery.ResolveCriteria%29> メソッドを使用します。エンドポイント アドレスをネットワーク アドレスで指定できないアドレスの場合は、これが便利です。Resolve メソッドは、<xref:System.ServiceModel.Discovery.ResolveCriteria> のインスタンスを受け取ります。このインスタンスは、解決するサービスのエンドポイント アドレス、解決操作の最大期間、および拡張のセットを指定できるようにします。次の例は、<xref:System.ServiceModel.Discovery.DiscoveryClient.Resolve%2A> メソッドを使用してサービスを解決する方法を示しています。  
+  
+```  
+DiscoveryClient dc = new DiscoveryClient(new UdpDiscoveryEndpoint());  
+ResolveCriteria criteria = new ResolveCriteria(endpointAddress);  
+ResolveResponse response = dc.Resolve(criteria);  
+EndpointAddress newEp = response.EndpointDiscoveryMetadata.Address;  
+  
+```  
+  
+## DynamicEndpoint  
+ <xref:System.ServiceModel.Discovery.DynamicEndpoint> は、探索を実行し、一致するサービスを自動的に選択する、標準エンドポイント \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[標準エンドポイント](../../../../docs/framework/wcf/feature-details/standard-endpoints.md)」を参照\) です。<xref:System.ServiceModel.Discovery.DynamicEndpoint> を作成して、検索するコントラクトおよび使用するバインディングを渡し、<xref:System.ServiceModel.Discovery.DynamicEndpoint> インスタンスを WCF クライアントに渡します。次の例は、<xref:System.ServiceModel.Discovery.DynamicEndpoint> を作成および使用して電卓サービスを呼び出す方法を示しています。クライアントが開かれるたびに、探索が実行されます。エンドポイント構成要素に `kind =”dynamicEndpoint”` 属性を追加して、構成で定義されているエンドポイントを <xref:System.ServiceModel.Discovery.DynamicEndpoint> にすることもできます。  
+  
+```  
+  
+DynamicEndpoint dynamicEndpoint = new DynamicEndpoint(ContractDescription.GetContract(typeof(ICalculatorService)), new WSHttpBinding());  
+CalculatorServiceClient client = new CalculatorServiceClient(dynamicEndpoint);  
+  
+Console.WriteLine("Invoking CalculatorService");  
+Console.WriteLine();  
+  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+  
+double result = client.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+```  
+  
+## 参照  
+ [スコープを使用した探索](../../../../docs/framework/wcf/samples/discovery-with-scopes-sample.md)   
+ [非同期検索](../../../../docs/framework/wcf/samples/asynchronous-find-sample.md)   
+ [Basic](../../../../docs/framework/wcf/samples/basic-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/distributed-application-security.md b/docs/framework/wcf/feature-details/distributed-application-security.md
new file mode 100644
index 00000000000..f9ea05f7563
--- /dev/null
+++ b/docs/framework/wcf/feature-details/distributed-application-security.md
@@ -0,0 +1,111 @@
+---
+title: "分散アプリケーションのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "分散アプリケーションのセキュリティ [WCF]"
+  - "セキュリティ [WCF], 転送"
+ms.assetid: 53928a10-e474-46d0-ab90-5f98f8d7b668
+caps.latest.revision: 32
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 32
+---
+# 分散アプリケーションのセキュリティ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティは、転送セキュリティ、アクセス制御、および監査の 3 つの主要な機能領域に分けられます。転送セキュリティは、整合性、機密性、および認証を実現します。転送セキュリティは、トランスポート セキュリティ、メッセージ セキュリティ、または `TransportWithMessageCredential` のいずれかによって提供されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ セキュリティの概要については、「[セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)」を参照してください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の他の 2 種類のセキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)」および「[監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)」を参照してください。  
+  
+## 転送セキュリティのシナリオ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 転送セキュリティを使用する一般的なシナリオには、次のようなものがあります。  
+  
+-   Windows を使用した、セキュリティで保護された転送。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスが Windows ドメイン \(または Windows フォレスト\) で展開されます。メッセージには個人データが含まれるため、要件には、クライアントとサービスの相互認証、メッセージの整合性、および機密性が含まれます。また、特定のトランザクションが発生したという証明も必要であり、たとえば、メッセージの受信側では署名情報を記録する必要があります。  
+  
+-   `UserName` と HTTPS を使用した、セキュリティで保護された転送。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスを、インターネット経由で動作するように開発する必要があります。クライアント資格情報を使用して、ユーザー名とパスワードの組み合わせをデータベースに照らして認証します。サービスは、信頼された SSL \(Secure Sockets Layer\) 証明書を使用して HTTPS アドレスに展開されます。メッセージはインターネット経由で転送されるため、クライアントとサービスは相互認証する必要があり、メッセージの機密性と整合性を転送時に維持する必要があります。  
+  
+-   証明書を使用した、セキュリティで保護された転送。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスを、パブリック インターネット経由で動作するように開発する必要があります。クライアントとサービスには共に証明書があり、それを使用してメッセージをセキュリティ保護できます。クライアントとサービスは、インターネットを使用して相互に通信し、メッセージの整合性、機密性、および相互認証を必要とする高価値のトランザクションを実行します。  
+  
+## 整合性、機密性、および認証  
+ 整合性、機密性、および認証の 3 つの機能は、合わせて転送セキュリティと呼ばれます。転送セキュリティは、分散アプリケーションに対する脅威の軽減に役立つ機能を提供します。転送セキュリティを構成するこれら 3 つの機能について、次の表で簡単に説明します。  
+  
+|機能|説明|  
+|--------|--------|  
+|整合性|*"整合性"* とは、特に、データが 1 つの地点から別の地点に移動し、多くのアクターによって読み取られた後などにデータが完全かつ正確であることを保証することです。整合性は、データの改ざんを防止するために保持する必要があり、一般にメッセージのデジタル署名によって実現されます。|  
+|機密性|*機密性*とは、メッセージが対象の閲覧者以外によって読み取られていないことを保証することです。たとえば、クレジット カード番号などは、インターネット経由で送信されるときに機密性を保持する必要があります。機密性は、多くの場合、公開キー\/秘密キー スキームを使用するデータ暗号化によって実現されます。|  
+|認証|*認証*とは、クレーム ID を検証することです。たとえば、銀行口座の使用時には、口座の実際の所有者だけが預金の引き出しを許可されるようにすることが必須です。認証は、さまざまな手段によって実現できます。一般的な方法の 1 つとして、ユーザー\/パスワード システムがあります。また、サードパーティから提供される X.509 証明書を使用する方法もあります。|  
+  
+## セキュリティ モード  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されている転送セキュリティの各モードを次の表に示します。  
+  
+|モード|説明|  
+|---------|--------|  
+|なし|トランスポート層とメッセージ層でセキュリティが一切提供されません。[\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素、つまりコードで <xref:System.ServiceModel.BasicHttpBinding> クラスを使用する場合を除き、このモードを既定で使用する定義済みのバインディングはありません。|  
+|トランスポート|HTTPS など、セキュリティで保護されたトランスポートを使用して、整合性、機密性、および相互認証を実現します。|  
+|メッセージ|SOAP メッセージ セキュリティを使用して、整合性、機密性、および相互認証を実現します。SOAP メッセージは、WS\-Security 標準に従ってセキュリティ保護されます。|  
+|混在モード|トランスポート セキュリティを使用して、整合性、機密性、およびサーバー認証を実現します。クライアント認証のためにメッセージ セキュリティ \(WS\-Security およびその他の標準\) を使用します。<br /><br /> \(このモードの列挙体は `TransportWithMessageCredential` になります\)。|  
+|両方|両方のレベルで保護と認証を実行します。このモードは、[\<netMsmqBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md) 要素でのみ使用できます。|  
+  
+## 資格情報と転送セキュリティ  
+ *資格情報*は、クレーム ID または資格を確立するために提示されるデータです。資格情報の提示には、データ自体の提示とデータの所有証明の提示が関与します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、トランスポートとメッセージの両方のセキュリティ レベルで、さまざまな種類の資格情報がサポートされています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディング用の資格情報の種類を指定できます。  
+  
+ 多くの国や地域での資格情報の例として、運転免許証があります。免許証には、個人の ID と資格を表すデータが記載されます。この免許証には所有者の写真のような形式の所有権の証明が含まれます。免許証は、政府機関など、信頼された証明機関によって発行されます。免許証はシールされ、ホログラムを含めることができ、改ざんあるいは偽造されたものではないことを示します。  
+  
+ 一例として、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされている、ユーザー名と \(X.509\) 証明書の 2 種類の資格情報を考えてみます。  
+  
+ ユーザー名資格情報では、ユーザー名がクレーム ID を表し、パスワードが所有権の証明を行います。この場合の信頼された証明機関は、ユーザー名とパスワードを検証するシステムです。  
+  
+ 証明書資格情報では、サブジェクト名、サブジェクト代替名、または証明書内の特定のフィールドを使用して、クレーム ID と資格を表すことができます。資格情報に含まれるデータの所有権の証明は、署名の生成のために関連付けられた秘密キーを使用して行われます。  
+  
+ 転送セキュリティのプログラミングと資格情報の指定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)」および「[セキュリティ動作](../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)」を参照してください。  
+  
+### トランスポート クライアント資格情報の種類  
+ 転送セキュリティを使用するアプリケーションを作成するときに使用できる値を次の表に示します。これらの値は、コードまたはバインディング設定で使用できます。  
+  
+|設定|説明|  
+|--------|--------|  
+|なし|クライアントは資格情報を提示する必要がないことを指定します。これにより匿名クライアントになります。|  
+|基本|基本認証を指定します。詳細については、RFC2617『[HTTP Authentication: Basic and Digest Authentication](http://go.microsoft.com/fwlink/?LinkId=88313)』を参照してください。|  
+|ダイジェスト|ダイジェスト認証を指定します。詳細については、RFC2617,『[HTTP Authentication: Basic and Digest Authentication](http://go.microsoft.com/fwlink/?LinkId=88313)』を参照してください。|  
+|Ntlm|Windows ドメインで SSPI ネゴシエーションを使用する Windows 認証を指定します。<br /><br /> SSPI ネゴシエーションの結果、Kerberos プロトコルまたは NTLM \(NT LanMan\) を使用することになります。|  
+|Windows|Windows ドメインで SSPI を使用する Windows 認証を指定します。SSPI では、認証サービスとして Kerberos プロトコルまたは NTLM が選択されます。<br /><br /> SSPI は、最初に Kerberos プロトコルの使用を試み、使用できない場合は NTLM を使用します。|  
+|証明書|証明書 \(通常は X.509\) を使用して、クライアント認証を実行します。|  
+  
+### メッセージ クライアント資格情報の種類  
+ メッセージ セキュリティを使用するアプリケーションを作成するときに使用できる値を次の表に示します。これらの値は、コードまたはバインディング設定で使用できます。  
+  
+|設定|説明|  
+|--------|--------|  
+|なし|サービスが匿名クライアントとやり取りを行うことが可能になります。|  
+|Windows|Windows 資格情報の認証済みコンテキストで SOAP メッセージ交換を実行できるようにします。SSPI ネゴシエーション機構を使用して、認証サービスとして Kerberos プロトコルまたは NTLM を選択します。|  
+|ユーザー名|ユーザー名資格情報を使用したクライアントの認証をサービスで要求できるようにします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、署名の生成やデータの暗号化など、ユーザー名を使用した暗号化操作が許可されないことに注意してください。そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザー名資格情報を使用する場合は、トランスポートが強制的にセキュリティで保護されます。|  
+|Certificate|証明書を使用したクライアントの認証を、サービスで要求することが可能になります。|  
+|[!INCLUDE[infocard](../../../../includes/infocard-md.md)]|[!INCLUDE[infocard](../../../../includes/infocard-md.md)] を使用したクライアントの認証をサービスで要求できるようにします。|  
+  
+### 資格情報のプログラミング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルにより、クライアント資格情報の種類ごとに、サービス動作とチャネル動作を使用して、資格情報の値と検証コントロールを指定できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティには、サービス資格情報動作とチャネル資格情報動作の 2 種類の資格情報があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の資格情報動作は、実際のデータ、つまりバインディングによって示されるセキュリティ要件を満たすために使用される資格情報を指定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、クライアント クラスは、操作呼び出しとメッセージ間で変換されるランタイム コンポーネントです。すべてのクライアントが <xref:System.ServiceModel.ClientBase%601> クラスを継承します。基本クラスの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティにより、クライアント資格情報のさまざまな値を指定できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス動作は、プログラムによってサービスを制御するために、サービス コントラクト \(インターフェイス\) を実装するクラスに適用される属性です。<xref:System.ServiceModel.Description.ServiceCredentials> クラスにより、サービス資格情報の証明書を指定でき、さらにクライアント資格情報のさまざまな種類に対応するクライアント検証設定を指定できます。  
+  
+### メッセージ セキュリティのネゴシエーション モデル  
+ メッセージ セキュリティ モードでは、クライアント側でサービス資格情報が帯域外で構成されるように転送のセキュリティを設定できます。たとえば、Windows 証明書ストアに格納されている証明書を使用する場合は、Microsoft 管理コンソール \(MMC: Microsoft Management Console\) スナップインなどのツールを使用する必要があります。  
+  
+ また、メッセージ セキュリティ モードでは、初期ネゴシエーションの一環としてサービス資格情報がクライアントと交換されるように転送のセキュリティを実行できます。ネゴシエーションを有効にするには、<xref:System.ServiceModel.MessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ [エンドポイントの作成の概要](../../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/duplex-services.md b/docs/framework/wcf/feature-details/duplex-services.md
new file mode 100644
index 00000000000..f3a636193e2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/duplex-services.md
@@ -0,0 +1,95 @@
+---
+title: "双方向サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 396b875a-d203-4ebe-a3a1-6a330d962e95
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 双方向サービス
+双方向サービス コントラクトは、両方のエンドポイントが互いに独立してメッセージを送信できるメッセージ交換パターンです。 双方向サービスでは、クライアントのエンドポイントにメッセージを返信できるため、イベントのような動作を実現できます。 双方向通信は、クライアントがサービスに接続し、サービスからクライアントにメッセージを返信できるチャネルがサービスに提供されると発生します。 双方向サービスにおけるイベントのような動作は、セッション内でのみ機能することに注意してください。  
+  
+ 双方向コントラクトを作成するには、インターフェイスのペアを作成します。 最初のインターフェイスは、クライアントから呼び出すことのできる操作を記述したサービス コントラクト インターフェイスです。 サービス コントラクトを指定する必要があります、*コールバック コントラクト*で、 <xref:System.ServiceModel.ServiceContractAttribute.CallbackContract%2A?displayProperty=fullName>プロパティです。 このコールバック コントラクトが、サービスがクライアント エンドポイントで呼び出すことのできる操作を定義するインターフェイスになります。 双方向コントラクトではセッションは必要ありませんが、システム指定の二重バインディングではセッションを利用します。  
+  
+ 双方向コントラクトの例を次に示します。  
+  
+ [!code-csharp[c_DuplexServices#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_duplexservices/cs/service.cs#0)]
+ [!code-vb[c_DuplexServices#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_duplexservices/vb/service.vb#0)]  
+  
+ `CalculatorService` クラスは、プライマリ `ICalculatorDuplex` インターフェイスを実装します。 サービスは使用して、 <xref:System.ServiceModel.InstanceContextMode>インスタンス モードがセッションごとの結果を保持します。 `Callback` というプライベート プロパティを使用して、クライアントへのコールバック チャネルにアクセスします。 次のサンプル コードに示すように、サービスはこのコールバックを使用し、コールバック インターフェイスを介してメッセージをクライアントに返信します。  
+  
+ [!code-csharp[c_DuplexServices#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_duplexservices/cs/service.cs#1)]
+ [!code-vb[c_DuplexServices#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_duplexservices/vb/service.vb#1)]  
+  
+ クライアントは、サービスからのメッセージを受信するために、双方向コントラクトのコールバック インターフェイスを実装するクラスを提供する必要があります。 次のサンプル コードに、`CallbackHandler` インターフェイスを実装する `ICalculatorDuplexCallback` クラスを示します。  
+  
+ [!code-csharp[c_DuplexServices#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_duplexservices/cs/client.cs#2)]
+ [!code-vb[c_DuplexServices#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_duplexservices/vb/client.vb#2)]  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]双方向コントラクトに必要なために生成されるクライアント、 <xref:System.ServiceModel.InstanceContext>クラスを構築時に提供します。 これは、 <xref:System.ServiceModel.InstanceContext>クラスは、コールバック インターフェイスを実装して、サービスから返信されるメッセージを処理するオブジェクトのサイトとして使用します。 <xref:System.ServiceModel.InstanceContext>のインスタンスとクラスが生成される、`CallbackHandler`クラスです。 このオブジェクトは、コールバック インターフェイスでサービスからクライアントに送信されるメッセージを処理します。  
+  
+ [!code-csharp[c_DuplexServices#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_duplexservices/cs/client.cs#3)]
+ [!code-vb[c_DuplexServices#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_duplexservices/vb/client.vb#3)]  
+  
+ サービスの構成は、セッション通信と双方向通信の両方をサポートするバインディングを提供するように設定する必要があります。 `wsDualHttpBinding` 要素はセッション通信をサポートし、どちらの方向にも HTTP 接続が&1; つ用意される双方向 HTTP 接続を提供して双方向通信を実現します。  
+  
+ クライアントで、サーバーがクライアントへの接続に使用するアドレスを構成する必要があります。次のサンプル構成を参照してください。  
+  
+  
+  
+> [!NOTE]
+>  通常、セキュリティで保護されたメッセージ交換を使用して認証に失敗した非双方向クライアントのスロー、 <xref:System.ServiceModel.Security.MessageSecurityException>します。 ただし、セキュリティで保護されたメッセージ交換を使用する双方向クライアントが認証に失敗した場合、クライアントを受け取る、 <xref:System.TimeoutException>代わりにします。  
+  
+ `WSHttpBinding` 要素を使用するクライアントとサービスを作成しても、クライアントのコールバック エンドポイントが含まれていない場合は、次のエラーが発生します。  
+  
+```  
+HTTP could not register URL  
+htp://+:80/Temporary_Listen_Addresses/<guid> because TCP port 80 is being used by another application.  
+```  
+  
+ 次のサンプル コードは、コードでクライアントのエンドポイント アドレスを指定する方法を示しています。  
+  
+```  
+WSDualHttpBinding binding = new WSDualHttpBinding();  
+EndpointAddress endptadr = new EndpointAddress("http://localhost:12000/DuplexTestUsingCode/Server");  
+binding.ClientBaseAddress = new Uri("http://localhost:8000/DuplexTestUsingCode/Client/");  
+```  
+  
+ 次のサンプル コードは、構成でクライアントのエンドポイント アドレスを指定する方法を示しています。  
+  
+```  
+<client>  
+    <endpoint name ="ServerEndpoint"   
+          address="http://localhost:12000/DuplexTestUsingConfig/Server"  
+          bindingConfiguration="WSDualHttpBinding_IDuplexTest"   
+            binding="wsDualHttpBinding"  
+           contract="IDuplexTest" />  
+</client>  
+<bindings>  
+    <wsDualHttpBinding>  
+        <binding name="WSDualHttpBinding_IDuplexTest"    
+          clientBaseAddress="http://localhost:8000/myClient/" >  
+            <security mode="None"/>  
+         </binding>  
+    </wsDualHttpBinding>  
+</bindings>  
+  
+```  
+  
+> [!WARNING]
+>  双方向モデルでは、サービスまたはクライアントによってチャネルがいつ閉じられたかが自動的に検出されません。 このため、サービスが突然終了した場合、既定ではクライアントには通知されず、クライアントが突然終了した場合も、サービスには通知されません。 クライアントとサービスは、独自のプロトコルを実装して、互いに通知するように選択できます。  
+  
+## <a name="see-also"></a>関連項目  
+ [両面印刷](../../../../docs/framework/wcf/samples/duplex.md)   
+ [クライアントのランタイム動作を指定します。](../../../../docs/framework/wcf/specifying-client-run-time-behavior.md)   
+ [方法: チャネル ファクトリを作成し、使用して作成およびチャネルの管理](../../../../docs/framework/wcf/feature-details/how-to-create-a-channel-factory-and-use-it-to-create-and-manage-channels.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/durable-duplex-correlation.md b/docs/framework/wcf/feature-details/durable-duplex-correlation.md
new file mode 100644
index 00000000000..8675c81da63
--- /dev/null
+++ b/docs/framework/wcf/feature-details/durable-duplex-correlation.md
@@ -0,0 +1,212 @@
+---
+title: "永続的な二重の相関関係 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8eb0e49a-6d3b-4f7e-a054-0d4febee2ffb
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 永続的な二重の相関関係
+永続的な二重の相関関係 \(コールバック相関関係\) は、ワークフロー サービスがコールバックを最初の呼び出し元に送信する必要がある場合に便利です。WCF の二重とは異なり、コールバックは、将来のどの時点でも発生する可能性があり、同じチャネルにも同じチャネルの有効期間にも関連付けられていません。唯一の要件は、呼び出し元にコールバック メッセージをリッスンするアクティブなエンドポイントを用意することです。このため、2 つのワークフロー サービスが長時間のメッセージ交換を使用して通信できます。このトピックでは、永続的な二重の相関関係について概説します。  
+  
+## 永続的な二重の相関関係の使用  
+ 永続的な二重の相関関係を使用するには、2 つのサービスが、<xref:System.ServiceModel.NetTcpContextBinding> や <xref:System.ServiceModel.WSHttpContextBinding> など、双方向の操作をサポートするコンテキスト対応バインドを使用する必要があります。呼び出し側サービスは、クライアントの <xref:System.ServiceModel.Endpoint> で使用するバインドを指定して <xref:System.ServiceModel.WSHttpContextBinding.ClientCallbackAddress%2A> を登録します。受信側サービスは、このデータを最初の呼び出しで受信し、呼び出し側サービスへのコールバックを行う <xref:System.ServiceModel.Activities.Send> アクティビティにおいて、受信側サービス自体の <xref:System.ServiceModel.Endpoint> でこのデータを使用します。次の例では、2 つのサービスが互いに通信しています。1 つ目のサービスは、2 つ目のサービスに対してメソッドを呼び出し、応答を待機します。2 つ目のサービスでは、コールバック メソッドの名前が認識されていますが、このメソッドを実装するサービスのエンドポイントは、設計時には認識されていません。  
+  
+> [!NOTE]
+>  エンドポイントの <xref:System.ServiceModel.Channels.AddressingVersion> が <xref:System.ServiceModel.Channels.AddressingVersion.WSAddressing10%2A> で構成される場合は、永続的な二重のみが使用できます。そうでない場合は、<xref:System.InvalidOperation> 例外が次のメッセージと共にスローされます。"メッセージに、AddressingVersion 'Addressing200408 \(http:\/\/schemas.xmlsoap.org\/ws\/2004\/08\/addressing\)' のエンドポイント参照を含むコールバック コンテキスト ヘッダーが含まれています。コールバック コンテキストを送信できるのは、AddressingVersion で 'WSAddressing10' が構成されている場合のみです。"  
+  
+ 次の例では、<xref:System.ServiceModel.WSHttpContextBinding> を使用してコールバック <xref:System.ServiceModel.Endpoint> を作成するワークフロー サービスがホストされます。  
+  
+```csharp  
+// Host WF Service 1.  
+string baseAddress1 = "http://localhost:8080/Service1";  
+WorkflowServiceHost host1 = new WorkflowServiceHost(GetWF1(), new Uri(baseAddress1));  
+  
+// Add the callback endpoint.  
+WSHttpContextBinding Binding1 = new WSHttpContextBinding();  
+host1.AddServiceEndpoint("ICallbackItemsReady", Binding1, "ItemsReady");  
+  
+// Add the service endpoint.  
+host1.AddServiceEndpoint("IService1", Binding1, baseAddress1);  
+  
+// Open the first workflow service.  
+host1.Open();  
+Console.WriteLine("Service1 waiting at: {0}", baseAddress1);  
+```  
+  
+ このワークフロー サービスを実装するワークフローは、ワークフロー自体の <xref:System.ServiceModel.Activities.Send> アクティビティを使用してコールバック相関関係を初期化し、<xref:System.ServiceModel.Activities.Send> と相関関係にある <xref:System.ServiceModel.Activities.Receive> アクティビティからこのコールバック エンドポイントを参照します。次の例は、`GetWF1` メソッドから返されるワークフローです。  
+  
+```csharp  
+Variable<CorrelationHandle> CallbackHandle = new Variable<CorrelationHandle>();  
+  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = "IService1",  
+    OperationName = "StartOrder"  
+};  
+  
+Send GetItems = new Send  
+{  
+    CorrelationInitializers =   
+    {  
+        new CallbackCorrelationInitializer  
+        {  
+            CorrelationHandle = CallbackHandle  
+        }  
+    },  
+    ServiceContractName = "IService2",  
+    OperationName = "StartItems",  
+    Endpoint = new Endpoint  
+    {  
+        AddressUri = new Uri("http://localhost:8081/Service2"),  
+        Binding = new WSHttpContextBinding  
+        {  
+            ClientCallbackAddress = new Uri("http://localhost:8080/Service1/ItemsReady")                          
+        }  
+    }  
+};  
+  
+Receive ItemsReady = new Receive  
+{  
+    ServiceContractName = "ICallbackItemsReady",  
+    OperationName = "ItemsReady",  
+    CorrelatesWith = CallbackHandle,  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables =  
+    {  
+        CallbackHandle  
+    },  
+    Activities =  
+    {  
+        StartOrder,  
+        new WriteLine  
+        {  
+            Text = "WF1 - Started"  
+        },  
+        GetItems,  
+        new WriteLine  
+        {  
+            Text = "WF1 - Request Submitted"  
+        },  
+        ItemsReady,  
+        new WriteLine  
+        {  
+            Text = "WF1 - Items Received"  
+        }  
+     }  
+};  
+```  
+  
+ 2 つ目のワークフロー サービスは、システムが提供するコンテキスト ベースのバインドを使用してホストされます。  
+  
+```csharp  
+// Host WF Service 2.  
+string baseAddress2 = "http://localhost:8081/Service2";  
+WorkflowServiceHost host2 = new WorkflowServiceHost(GetWF2(), new Uri(baseAddress2));  
+  
+// Add the service endpoint.  
+WSHttpContextBinding Binding2 = new WSHttpContextBinding();  
+host2.AddServiceEndpoint("IService2", Binding2, baseAddress2);  
+  
+// Open the second workflow service.  
+host2.Open();  
+Console.WriteLine("Service2 waiting at: {0}", baseAddress2);  
+```  
+  
+ このワークフロー サービスを実装するワークフローは、<xref:System.ServiceModel.Activities.Receive> アクティビティから開始されます。この受信アクティビティは、このサービスのコールバック相関関係を初期化し、一定の遅延時間を設けて長時間の作業をシミュレーションして、サービスへの最初の呼び出しで渡されたコールバック コンテキストを使用して、最初のサービスにコールバックします。次の例は、`GetWF2` への呼び出しから返されるワークフローです。<xref:System.ServiceModel.Activities.Send> アクティビティには、`http://www.contoso.com` のプレースホルダー アドレスが設定されていることに注意してください。実行時に使用される実際のアドレスは、指定されたコールバック アドレスです。  
+  
+```csharp  
+Variable<CorrelationHandle> ItemsCallbackHandle = new Variable<CorrelationHandle>();  
+  
+Receive StartItems = new Receive  
+{  
+    CorrelationInitializers =   
+    {  
+        new CallbackCorrelationInitializer  
+        {  
+            CorrelationHandle = ItemsCallbackHandle  
+        }  
+    },  
+    CanCreateInstance = true,  
+    ServiceContractName = "IService2",  
+    OperationName = "StartItems"  
+};  
+  
+Send ItemsReady = new Send  
+{  
+    CorrelatesWith = ItemsCallbackHandle,  
+    Endpoint = new Endpoint  
+    {  
+        // The callback address on the binding is used  
+        // instead of this placeholder address.  
+        AddressUri = new Uri("http://www.contoso.com"),  
+  
+        Binding = new WSHttpContextBinding()  
+    },  
+    OperationName = "ItemsReady",  
+    ServiceContractName = "ICallbackItemsReady"  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables =  
+    {  
+        ItemsCallbackHandle  
+    },  
+    Activities =  
+    {  
+        StartItems,  
+        new WriteLine  
+        {  
+            Text = "WF2 - Request Received"  
+        },  
+        new Delay  
+        {  
+            Duration = TimeSpan.FromMinutes(90)  
+        },  
+        new WriteLine  
+        {  
+            Text = "WF2 - Sending items"  
+        },  
+        ItemsReady,  
+        new WriteLine  
+        {  
+            Text = "WF2 - Items sent"  
+        }  
+     }  
+};  
+```  
+  
+ `StartOrder` メソッドが最初のワークフローで呼び出されると、次の出力が表示されます。これは、2 つのワークフローの実行フローを示しています。  
+  
+```Output  
+Service1 waiting at: http://localhost:8080/Service1  
+Service2 waiting at: http://localhost:8081/Service2  
+Enter キーを押して閉じます。  
+WF1 - Started  
+WF2 - Request Received  
+WF1 - Request Submitted  
+WF2 - Sending items  
+WF2 - Items sent  
+WF1 - Items Received  
+  
+```  
+  
+ この例では、どちらのワークフローも <xref:System.ServiceModel.Activities.CallbackCorrelationInitializer> を使用して相関関係を明示的に管理しています。サンプル ワークフローには相関関係が 1 つしかないため、既定の <xref:System.ServiceModel.Activities.CorrelationHandle> で十分に管理できます。  
+  
+## 参照  
+ [永続的な二重 &#91;WF サンプル&#93;](../../../../docs/framework/windows-workflow-foundation/samples/durable-duplex.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/elevation-of-privilege.md b/docs/framework/wcf/feature-details/elevation-of-privilege.md
new file mode 100644
index 00000000000..ad2f5c1731a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/elevation-of-privilege.md
@@ -0,0 +1,98 @@
+---
+title: "権限の昇格 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "権限の昇格 [WCF]"
+  - "セキュリティ [WCF], 権限の昇格"
+ms.assetid: 146e1c66-2a76-4ed3-98a5-fd77851a06d9
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 権限の昇格
+*権限の昇格*は、本来付与されたものよりも高い承認アクセス許可を攻撃者に与えた結果として発生します。たとえば、"読み取り専用" アクセス許可の権限セットを持つ攻撃者が、何らかの方法で権限セットを "読み取り\/書き込み" アクセス許可を含むものに昇格させます。  
+  
+## SAML トークンのクレームには信頼された STS による署名が必要  
+ SAML \(Security Assertions Markup Language\) トークンは、発行済みトークンの既定の型である汎用 XML トークンです。SAML トークンは、通常の交換においてエンド Web サービスから信頼されたセキュリティ トークン サービス \(STS\) によって作成できます。SAML トークンには、ステートメント内にクレームが格納されます。攻撃者は、有効なトークンからクレームをコピーして新しい SAML トークンを作成し、別の発行者による署名を行うことがあります。この目的は、サーバーが発行者を検証するかどうかを確認し、検証しない場合に、この脆弱性を利用して信頼された STS が意図したものよりも高い権限を与える SAML トークンを作成することです。  
+  
+ <xref:System.IdentityModel.Tokens.SamlAssertion> クラスは、SAML トークンに含まれるデジタル署名を検証します。<xref:System.ServiceModel.Security.IssuedTokenServiceCredential> クラスの <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A> が <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定されている場合、既定の <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator> は、SAML トークンが有効な X.509 証明書によって署名されていることを要求します。SAML トークンの発行者を信頼できるかどうか判断するには、`ChainTrust` モードだけでは不十分です。より詳細な信頼モデルを必要とするサービスは、承認ポリシーと強制ポリシーを使用して、発行済みトークン認証によって生成されたクレーム セットの発行者をチェックするか、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential> の X.509 検証設定を使用して、許可する署名証明書のセットを制限できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)」および「[フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+## セキュリティ コンテキストを使用しない ID の切り替え  
+ 次の内容は、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] にのみ適用されます。  
+  
+ クライアントとサーバー間の接続が確立すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを開いた後に次のすべての条件に該当する場合を除き、クライアントの ID は変更されません。  
+  
+-   セキュリティ コンテキストを確立するプロシージャ \(トランスポート セキュリティ セッションまたはメッセージ セキュリティ セッションを使用\) が無効になっている \(メッセージ セキュリティの場合は、<xref:System.ServiceModel.NonDualMessageSecurityOverHttp.EstablishSecurityContext%2A> プロパティが `false`  に設定されている。トランスポート セキュリティの場合は、セキュリティ セッションを確立できないトランスポート \(HTTPS など\) が使用されている\)。  
+  
+-   Windows 認証を使用している。  
+  
+-   資格情報を明示的に設定していない。  
+  
+-   偽装されたセキュリティ コンテキストでサービスを呼び出している。  
+  
+ これらの条件に該当する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを開いた後で、サービスに対するクライアントの認証に使用する ID が変更されることがあります \(偽装された ID ではなく、プロセス ID になります\)。この状況が発生するのは、サービスに対するクライアントの認証に使用する Windows 資格情報がすべてのメッセージと共に送信され、認証に使用する資格情報が現在のスレッドの Windows ID から取得されるためです。\(たとえば、別の呼び出し元を偽装することによって\) 現在のスレッドの Windows ID が変更された場合、メッセージに添付され、サービスに対するクライアントの認証に使用する資格情報も変更される可能性があります。  
+  
+ 偽装と共に Windows 認証を使用する場合に動作を確定する必要があるときは、Windows 資格情報を明示的に設定するか、サービスでセキュリティ コンテキストを確立する必要があります。これを行うには、メッセージ セキュリティ セッションまたはトランスポート セキュリティ セッションを使用します。たとえば、net.tcp トランスポートは、トランスポート セキュリティ セッションを提供します。また、サービスの呼び出し時に、クライアント操作の同期バージョンだけを使用する必要があります。メッセージ セキュリティ コンテキストを確立する場合は、構成済みセッションの更新時間よりも長い時間、サービスへの接続を開いたままにしないようにしてください。セッション更新プロセスの間にも ID が変更される可能性があるためです。  
+  
+### 資格情報のキャプチャ  
+ 次の内容は、[!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] 以降のバージョンに適用されます。  
+  
+ クライアントまたはサービスが使用する資格情報は、現在のコンテキストのスレッドに基づきます。資格情報は、クライアントまたはサービスの `Open` メソッド \(または、非同期呼び出しの場合は `BeginOpen`\) が呼び出された場合に取得されます。<xref:System.ServiceModel.ServiceHost> クラスおよび <xref:System.ServiceModel.ClientBase%601> クラスのいずれの場合も、`Open` メソッドおよび `BeginOpen` メソッドは、<xref:System.ServiceModel.Channels.CommunicationObject> クラスの <xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> メソッドおよび <xref:System.ServiceModel.Channels.CommunicationObject.BeginOpen%2A> メソッドから継承されます。  
+  
+> [!NOTE]
+>  `BeginOpen` メソッドを使用する場合、キャプチャされた資格情報は、このメソッドを呼び出したプロセスの資格情報であることが保証されません。  
+  
+## トークン キャッシュによる以前のデータを使用した再生の許可  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ローカル セキュリティ機関 \(LSA\) の `LogonUser` 関数を使用して、ユーザー名とパスワードによってユーザーを認証します。ログオン関数はコストの高い操作であるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、パフォーマンスを向上させるために、認証済みユーザーを表すトークンをキャッシュできます。キャッシュ機構は、それ以降に使用できるように `LogonUser` の結果を保存します。この機構は、既定で無効になっています。有効にするには、<xref:System.ServiceModel.Security.UserNamePasswordServiceCredential.CacheLogonTokens%2A> プロパティを `true` に設定するか、[\<userNameAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md) の `cacheLogonTokens` 属性を使用します。  
+  
+ <xref:System.ServiceModel.Security.UserNamePasswordServiceCredential.CachedLogonTokenLifetime%2A> プロパティを <xref:System.TimeSpan> に設定するか、`userNameAuthentication` 要素の `cachedLogonTokenLifetime` 属性を使用することで、キャッシュされたトークンの有効期間 \(TTL\) を設定できます。既定値は 15 分です。Windows からユーザー アカウントが削除された場合や、パスワードが変更されている場合でも、トークンがキャッシュされている間は、同じユーザー名とパスワードを指定すると、どのクライアントもこのトークンを使用できます。TTL が終了し、トークンがキャッシュから削除されるまで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は悪意のあるユーザーである可能性があっても、ユーザー認証を許可します。  
+  
+ これをできるだけ防ぐには、`cachedLogonTokenLifetime` の設定値をユーザーが必要とする最低の期間に限定して攻撃領域を減らします。  
+  
+## 発行済みトークンの承認 : 大きな値にリセットされた有効期限  
+ 一定の条件下で、<xref:System.IdentityModel.Policy.AuthorizationContext> の <xref:System.IdentityModel.Policy.AuthorizationContext.ExpirationTime%2A> プロパティが予期しない大きな値 \(<xref:System.DateTime.MaxValue> フィールド値から 1 日引いた値 \(December 20, 9999\)\) に設定される場合があります。  
+  
+ これは、<xref:System.ServiceModel.WSFederationHttpBinding>、およびクライアント資格情報の種類が発行済みトークンであるシステム提供のバインディングを使用している場合に発生します。  
+  
+ また、以下のメソッドのいずれかを使用して、カスタム バインディングを作成した場合にも発生します。  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenBindingElement%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenForCertificateBindingElement%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenForSslBindingElement%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenOverTransportBindingElement%2A>  
+  
+ これをできるだけ防ぐには、承認ポリシーによって各承認ポリシーのアクションと有効期限をチェックする必要があります。  
+  
+## クライアントで予定していたものと異なる証明書をサービスで使用する場合  
+ 一定の条件下で、クライアントが X.509 証明書を使用してメッセージにデジタル署名したときに、予定していたものと異なる証明書をサービスが取得する場合があります。  
+  
+ これは、次のような状況で発生する可能性があります。  
+  
+-   クライアントが X.509 証明書を使用してメッセージにデジタル署名したときに、その X.509 証明書をメッセージに添付するのではなく、サブジェクト キー識別子を使用して証明書を参照しているだけの場合。  
+  
+-   サービスのコンピューターに同じ公開キーを持つ複数の証明書が格納されており、それらの証明書に含まれる情報が異なる場合。  
+  
+-   サービスがサブジェクト キー識別子と一致する証明書を取得したが、クライアントが使用する予定だったものではない場合。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でメッセージを取得し署名を検証すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は予定されていたものと異なる X.509 証明書の情報をクレーム セットに対応付けます。このクレーム セットは、クライアントが必要とした内容とは異なり、昇格されている可能性があります。  
+  
+ これをできるだけ防ぐには、X.509 証明書を別の方法 \(<xref:System.ServiceModel.Security.Tokens.X509KeyIdentifierClauseType> の使用など\) で参照します。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)   
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)   
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/enabling-transaction-flow.md b/docs/framework/wcf/feature-details/enabling-transaction-flow.md
new file mode 100644
index 00000000000..de2a475fcc1
--- /dev/null
+++ b/docs/framework/wcf/feature-details/enabling-transaction-flow.md
@@ -0,0 +1,102 @@
+---
+title: "トランザクション フローの有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランザクション [WCF], フローの有効化"
+ms.assetid: a03f5041-5049-43f4-897c-e0292d4718f7
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# トランザクション フローの有効化
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、高い柔軟性を備えた、トランザクション フローの制御用オプションが用意されています。サービスのトランザクション フローの設定は、属性と構成の組み合わせを使用して表すことができます。  
+  
+## トランザクション フローの設定  
+ トランザクション フローの設定は、次の 3 つの値の積集合の結果として、サービス エンドポイントに対して生成されます。  
+  
+-   サービス コントラクトの各メソッドに指定された <xref:System.ServiceModel.TransactionFlowAttribute> 属性。  
+  
+-   特定のバインディングの `TransactionFlow` バインディング プロパティ。  
+  
+-   特定のバインディングの `TransactionFlowProtocol` バインディング プロパティ。`TransactionFlowProtocol` バインディング プロパティでは、トランザクションをフローさせるために使用できる 2 つのトランザクション プロトコルのいずれかを選択できます。次のセクションでは、これらのプロパティについてそれぞれ簡単に説明します。  
+  
+### WS\-AtomicTransaction プロトコル  
+ サード パーティのプロトコル スタックとの相互運用性が必要なシナリオでは、WS\-AT \(WS\-AtomicTransaction\) プロトコルが有用です。  
+  
+### OleTransactions プロトコル  
+ OleTransactions プロトコルは、サードパーティのプロトコル スタックとの相互運用性が必要ではなく、WS\-AT プロトコル サービスがローカルで無効になっていること、または既存のネットワーク トポロジが WS\-AT の使用に向いていないことがサービスを配置する前に既にわかっている場合に有効です。  
+  
+ これらのさまざまな組み合わせを使用して生成できるトランザクション フローの種類を次の表に示します。  
+  
+|TransactionFlow<br /><br /> バインディング|TransactionFlow バインディング プロパティ|TransactionFlowProtocol バインディング プロパティ|トランザクション フローの種類|  
+|---------------------------------|-----------------------------------|-------------------------------------------|---------------------|  
+|必須|true|WS\-AT|トランザクションは、相互運用可能な WS\-AT 形式でフローさせる必要があります。|  
+|Mandatory|true|OleTransactions|トランザクションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の OleTransactions 形式でフローさせる必要があります。|  
+|Mandatory|false|適用なし|この構成は無効なため、適用できません。|  
+|Allowed|true|WS\-AT|トランザクションは、相互運用可能な WS\-AT 形式でフローさせることができます。|  
+|Allowed|true|OleTransactions|トランザクションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の OleTransactions 形式でフローさせることができます。|  
+|Allowed|false|任意の値|トランザクションは送信されません。|  
+|NotAllowed|任意の値|任意の値|トランザクションは送信されません。|  
+  
+ メッセージ処理の結果を次の表にまとめます。  
+  
+|受信メッセージ|トランザクション フローの設定|トランザクション ヘッダー|メッセージ処理の結果|  
+|-------------|---------------------|-------------------|----------------|  
+|トランザクションは予期されたプロトコル形式に一致します|Allowed または Mandatory|`MustUnderstand`  と `true` は等しい。|処理|  
+|トランザクションは予期されたプロトコル形式に一致しません|Mandatory|`MustUnderstand`  と `false` は等しい。|トランザクションが必須のため拒否|  
+|トランザクションは予期されたプロトコル形式に一致しません|Allowed|`MustUnderstand`  と `false` は等しい。|ヘッダーが認識されないため拒否|  
+|任意のプロトコル形式を使用しているトランザクション|NotAllowed|`MustUnderstand`  と `false` は等しい。|ヘッダーが認識されないため拒否|  
+|トランザクションなし|Mandatory|N\/A|トランザクションが必須のため拒否|  
+|トランザクションなし|Allowed|N\/A|処理|  
+|トランザクションなし|NotAllowed|N\/A|プロセス|  
+  
+ コントラクトの各メソッドには、トランザクション フローに関するさまざまな要件を割り当てることができますが、トランザクション フローのプロトコル設定のスコープは、バインディングのレベルになります。このため、同じエンドポイント \(ひいては同じバインディング\) を共有するすべてのメソッドは、トランザクション フローを許可または必要とする同じポリシー、および同じトランザクション プロトコル \(該当する場合\) を共有します。  
+  
+## メソッド レベルでのトランザクション フローの有効化  
+ トランザクション フローの要件は、サービス コントラクトのすべてのメソッドで常に同じであるとは限りません。そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、各メソッドのトランザクション フロー設定を指定することができる属性ベースの機構も用意されています。これは、サービス操作がトランザクション ヘッダーを受け入れるレベルを指定する <xref:System.ServiceModel.TransactionFlowAttribute> によって実現されます。トランザクション フローを有効にする場合は、この属性を使用してサービス コントラクト メソッドをマークする必要があります。この属性は、<xref:System.ServiceModel.TransactionFlowOption> 列挙値のいずれかを取り、既定値は <xref:System.ServiceModel.TransactionFlowOption> です。<xref:System.ServiceModel.TransactionFlowOption> 以外の値を指定する場合、メソッドは一方向ではない必要があります。開発者は、この属性を使用して、メソッド レベルのトランザクション フローに関する要件や制約をデザイン時に指定できます。  
+  
+## エンドポイント レベルでのトランザクション フローの有効化  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.TransactionFlowAttribute> によって提供されるメソッド レベルのトランザクション フロー設定に加えて、トランザクション フローに対するエンドポイント全体の設定が提供されています。これにより、管理者はトランザクション フローをより高いレベルで制御できるようになります。  
+  
+ これは、<xref:System.ServiceModel.Channels.TransactionFlowBindingElement> によって実現され、エンドポイントのバインディング設定で受信トランザクション フローを有効化または無効化する他に、受信トランザクションに必要なトランザクション プロトコル形式を指定できるようになります。  
+  
+ バインディングによりトランザクション フローが無効にされているとき、サービス コントラクトのいずれかの操作が受信トランザクションを必要とした場合は、サービスの起動時に検証例外がスローされます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されているほとんどの標準バインディングには、`transactionFlow` 属性と `transactionProtocol` 属性が含まれています。これらの属性を使用すると、受信トランザクションを受け入れるように特定のバインディングを構成できます。構成要素の設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[\<binding\>](../../../../docs/framework/misc/binding.md)」を参照してください。  
+  
+ 管理者や展開担当者は、エンドポイント レベルのトランザクション フローを使用することで、展開時に構成ファイルを使用してトランザクション フローの要件や制約を構成できます。  
+  
+## セキュリティ  
+ システムのセキュリティと整合性を確保するために、アプリケーション間でトランザクションをフローさせるときは、メッセージ交換をセキュリティで保護する必要があります。同じトランザクションに参加する資格のないアプリケーションには、トランザクションの詳細をフローさせたり、公開したりしないでください。  
+  
+ メタデータ交換を使用して、未知または信頼できない Web サービスに対して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成するときは、可能であれば、これらの Web サービスでの操作の呼び出しでは現在のトランザクションを使用しないようにする必要があります。この方法を次の例に示します。  
+  
+```  
+//client code which has an ambient transaction  
+using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Suppress))  
+{  
+    // No transaction will flow to this operation  
+    untrustedProxy.Operation1(...);  
+    scope.Complete();  
+}  
+//remainder of client code  
+```  
+  
+ さらに、サービスは、認証および承認済みのクライアントからの受信トランザクションのみを受け入れるように構成する必要があります。受信トランザクションは、高信頼クライアントから送られてきた場合にのみ受け入れるようにする必要があります。  
+  
+## ポリシー アサーション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ポリシー アサーションを使用してトランザクション フローを制御します。ポリシー アサーションは、コントラクト、構成、および属性を集約して生成される、サービスのポリシー ドキュメントに含まれています。クライアントは、HTTP GET または WS\-MetadataExchange 要求\/応答を使用して、サービスのポリシー ドキュメントを取得できます。クライアントは、取得したポリシー ドキュメントを処理して、トランザクション フローをサポートまたは必要とする可能性があるサービス コントラクトの操作を判別できます。  
+  
+ トランザクション フローのポリシー アサーションは、クライアントがサービスに送信する必要がある、トランザクションを表す SOAP ヘッダーを指定することで、トランザクション フローに影響します。すべてのトランザクション ヘッダーの `MustUnderstand` は、`true` に設定する必要があります。これ以外の値に設定されたメッセージは、SOAP エラーによりすべて拒否されます。  
+  
+ トランザクション関連のポリシー アサーションは、1 つの操作に 1 つしか存在できません。1 つの操作に複数のトランザクション アサーションが存在するポリシー ドキュメントは無効と見なされ、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] により拒否されます。さらに、トランザクション プロトコルも各ポートの種類の内部に 1 つしか存在できません。単一のポートの種類の内部の複数のトランザクション プロトコルを参照する操作がポリシー ドキュメントに含まれている場合、そのポリシー ドキュメントは無効と見なされ、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)により拒否されます。また、出力メッセージや一方向の入力メッセージに関するトランザクション アサーションが存在するポリシー ドキュメントも無効と見なされます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/encoding-binary-objects-with-bytestream-encoder.md b/docs/framework/wcf/feature-details/encoding-binary-objects-with-bytestream-encoder.md
new file mode 100644
index 00000000000..7a83f1e02ec
--- /dev/null
+++ b/docs/framework/wcf/feature-details/encoding-binary-objects-with-bytestream-encoder.md
@@ -0,0 +1,53 @@
+---
+title: "バイトストリーム エンコーダーを使用したバイナリ オブジェクトのエンコーディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 020ee981-c889-4b12-a3ea-91823ef46444
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# バイトストリーム エンコーダーを使用したバイナリ オブジェクトのエンコーディング
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] による生のバイナリ データの送受信は、<xref:System.ServiceModel.Channels.ByteStreamMessageEncodingBindingElement> を使用して構成されます。  
+  
+## バイト ストリーム メッセージ エンコーダーのアーキテクチャ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で使用されるバイナリ メッセージ エンコーダーには、メッセージ内の基になるバイナリ メッセージを処理、検証、または識別する機能がありません。データ パッケージは、XML にエンコード、送受信、およびデコードされます。エンコーダーは、トランスポートに渡された後に、メッセージがメッセージ キューに送られる前にデータを処理します。機能的には、バイナリ エンコーダーが、送信用にメッセージ データを `<binary>` 要素にラップし、そのメッセージが受信された後にこの要素を削除します。  
+  
+## バイト ストリーム メッセージ エンコーダーの使用  
+ 次の例は、バイト ストリーム メッセージ エンコーダーを実装するサービス コントラクトを示しています。  
+  
+```csharp  
+[OperationContract]  
+Void Myfunction(Stream stream);  
+```  
+  
+ 次の例は、呼び出されたサービスを示しています。  
+  
+```csharp  
+proxy.MyFunction(stream);  
+```  
+  
+ ルーターなどのメッセージ インフラストラクチャを実装するサービスを使用する場合、そのメッセージは、次の例に示すように、メッセージの検査、検証、およびメッセージとの対話操作のいずれも行うことなく処理されます。  
+  
+```csharp  
+[OperationContract]  
+void ProcessMessage(Message message) ;  
+```  
+  
+## シナリオ  
+ バイト ストリーム エンコーダーは、次のシナリオに役立ちます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用してコンピューター間で JPEG イメージを転送する。このシナリオでは、イメージは外部ソースから転送によって到着し、送信されたデータはイメージを構成する生バイトになります。サービスはバイナリ データを受信してイメージを表示します。  
+  
+-   メッセージ キューからの情報の読み取りと処理。メッセージはメッセージ キュー マネージャーから読み取られ、処理対象のメッセージ キュー チャネルに渡されます。メッセージ キュー チャネルは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル スタックでキュー マネージャーとして機能します。  
+  
+ メッセージをメッセージ キュー チャネルを介して送信する場合、送信者はキュー マネージャーから受信したバイトを制御できません。受信プロセスで生バイトを読み取ることができない場合、メッセージは不適切な書式として受信され処理されません。受信プロセスは受信したバイトを利用可能な形式に変換する機能があると見なされます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/encryption-of-digital-signatures.md b/docs/framework/wcf/feature-details/encryption-of-digital-signatures.md
new file mode 100644
index 00000000000..87191fbb58d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/encryption-of-digital-signatures.md
@@ -0,0 +1,44 @@
+---
+title: "電子署名の暗号化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "電子署名 [WCF]"
+  - "電子署名 [WCF], 暗号化"
+  - "電子署名の暗号化 [WCF]"
+ms.assetid: 0868866d-40b4-4341-8e42-eee3b7f15b69
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 電子署名の暗号化
+既定では、メッセージは署名および暗号化され、署名はデジタル暗号化されます。これは、<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> のインスタンスを使用してカスタム バインディングを作成し、いずれかのクラスの `MessageProtectionOrder` プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> 列挙値に設定することによって制御できます。既定値は <xref:System.ServiceModel.Security.MessageProtectionOrder> です。このプロセスは、単に署名して暗号化する場合よりも時間が 10 ～ 40 % 長くかかります。ただし、署名の暗号化を無効にすると、攻撃者がメッセージの内容を予想できるようになる恐れがあります。その理由は、メッセージ内のすべての署名部分のプレーン テキストのハッシュ コードが署名要素に含まれるからです。たとえば、メッセージ本体は既定で暗号化されますが、暗号化されていない署名には、メッセージ本体のハッシュ コードが含まれます。メッセージが短い場合は、攻撃者に内容を推測されてしまうおそれがあります。署名を暗号化すると、このような危険性が低減または解消されます。  
+  
+ そのため、署名の暗号化を無効にするのは、セキュリティに影響しない大型のバイナリ ファイルを送信する場合などの、内容の重要性が低く、パフォーマンスの向上が重要な場合に限定してください。  
+  
+### デジタル署名を無効にするには  
+  
+1.  <xref:System.ServiceModel.Channels.CustomBinding> を作成します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md).  
+  
+2.  <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> をバインディング コレクションに追加します。  
+  
+3.  <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> に設定するか、または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> に設定します。  
+  
+ カスタム バインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)」を参照してください。特定の認証モード用のカスタム バインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.MessageProtectionOrder>   
+ <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [ユーザー定義バインディングの作成](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)   
+ [方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/endpoint-addresses.md b/docs/framework/wcf/feature-details/endpoint-addresses.md
new file mode 100644
index 00000000000..998047120e2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/endpoint-addresses.md
@@ -0,0 +1,150 @@
+---
+title: "エンドポイントのアドレス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アドレス [WCF]"
+  - "WCF [WCF], アドレス"
+  - "Windows Communication Foundation [WCF], アドレス"
+ms.assetid: 13f269e3-ebb1-433c-86cf-54fbd866a627
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# エンドポイントのアドレス
+すべてのエンドポイントにはこれと関連するアドレスがあり、エンドポイントの検索と識別に使用されます。このアドレスは主にエンドポイントの位置を指定する URI \(Uniform Resource Identifier\) で構成されます。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のプログラミング モデルでは、エンドポイント アドレスは <xref:System.ServiceModel.EndpointAddress> クラスによって表されます。このクラスには、このエンドポイントとメッセージを交換する他のエンドポイントがエンドポイントを認証できるようにする、オプションの <xref:System.ServiceModel.EndpointAddress.Identity%2A> プロパティ、およびサービスに到達するために必要な他の任意の SOAP ヘッダーを定義するオプションの <xref:System.ServiceModel.EndpointAddress.Headers%2A> プロパティが含まれます。オプションのヘッダーは、サービス エンドポイントの識別または対話のために、より詳細なアドレス指定情報を提供します。エンドポイントのアドレスは、ネットワーク上では WS\-Addressing エンドポイント参照 \(EPR\) として表されます。  
+  
+## アドレスの URI 構造  
+ ほとんどのトランスポートの URI アドレスは、4 つの部分から構成されます。たとえば、http:\/\/www.fabrikam.com:322\/mathservice.svc\/secureEndpoint という URI は、次の 4 つの部分から構成されます。  
+  
+-   スキーム : http:  
+  
+-   コンピューター : www.fabrikam.com  
+  
+-   \(省略可能\) ポート : 322  
+  
+-   パス : \/mathservice.svc\/secureEndpoint  
+  
+## サービスのアドレスの定義  
+ サービスのエンドポイント アドレスは、コードを使用して命令的に、または構成を通じて宣言的に指定できます。展開済みサービスのバインディングおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。一般に、サービス エンドポイントの定義にはコードではなく、構成を使用する方がより実用的です。バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+### 構成によるアドレス定義  
+ 構成ファイルでエンドポイントを定義するには、[\<endpoint\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md) 要素を使用します。使用例と詳細については、「[エンドポイント アドレスの指定](../../../../docs/framework/wcf/specifying-an-endpoint-address.md)」を参照してください。  
+  
+### コードによるアドレス定義  
+ エンドポイント アドレスは、コードで <xref:System.ServiceModel.EndpointAddress> クラスを使用して作成できます。使用例と詳細については、「[エンドポイント アドレスの指定](../../../../docs/framework/wcf/specifying-an-endpoint-address.md)」を参照してください。  
+  
+### WSDL のエンドポイント  
+ エンドポイント アドレスは、対応するエンドポイントの `wsdl:port` 要素内の WS\-Addressing EPR 要素として WSDL で表すこともできます。EPR には、エンドポイントのアドレスのほかに、アドレスのすべてのプロパティが含まれます。使用例と詳細については、「[エンドポイント アドレスの指定](../../../../docs/framework/wcf/specifying-an-endpoint-address.md)」を参照してください。  
+  
+## .NET Framework 3.5 での複数の IIS バインディングのサポート  
+ インターネット サービス プロバイダーは、多くの場合、サイトの密度を高めて総所有コストを抑えるため、同じサーバーまたはサイト上で複数のアプリケーションをホストしています。通常、これらのアプリケーションは、異なるベース アドレスにバインドされています。インターネット インフォメーション サービス \(IIS\) Web サイトは、複数のアプリケーションを格納できます。サイト内のアプリケーションに、1 つ以上の IIS バインディングからアクセスできます。  
+  
+ IIS バインディングは、バインディング プロトコルとバインディング情報という 2 つの情報を提供します。バインディング プロトコルは通信を行うスキームを定義するもので、バインディング情報はサイトにアクセスするために使用する情報です。  
+  
+ IIS バインディングに使用されるコンポーネントの例を次に示します。  
+  
+-   バインディング プロトコル : HTTP  
+  
+-   バインディング情報 : IP アドレス、ポート、ホスト ヘッダー  
+  
+ IIS ではサイトごとに複数の IIS バインディングを指定でき、これによりスキームごとに複数のベース アドレスをサポートできます。[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] 以前は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではスキームごとに複数のアドレスがサポートされておらず、複数のアドレスが指定された場合は、アクティブ化の間に <xref:System.ArgumentException> がスローされました。  
+  
+ [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] により、インターネット サービス プロバイダーは同じサイト上の同じスキームに対して別のベース アドレスを使用して複数のアプリケーションをホストできます。  
+  
+ たとえば、サイトで次のベース アドレスを使用できます。  
+  
+-   http:\/\/payroll.myorg.com\/Service.svc  
+  
+-   http:\/\/shipping.myorg.com\/Service.svc  
+  
+ [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] では、構成ファイルの AppDomain レベルでプレフィックス フィルターを指定できます。これには、プレフィックスの一覧を格納する [\<baseAddressPrefixFilters\>](../../../../docs/framework/configure-apps/file-schema/wcf/baseaddressprefixfilters.md) 要素を使用します。IIS によって指定される受信ベース アドレスは、オプションのプレフィックス一覧に基づいてフィルター処理されます。既定では、プレフィックスを指定しない場合、すべてのアドレスが渡されます。プレフィックスを指定すると、そのスキームに一致するベース アドレスだけが渡されます。  
+  
+ プレフィックス フィルターを使用する構成コード例を次に示します。  
+  
+```  
+<system.serviceModel>  
+  <serviceHostingEnvironment>  
+     <baseAddressPrefixFilters>  
+        <add prefix="net.tcp://payroll.myorg.com:8000"/>  
+        <add prefix="http://shipping.myorg.com:8000"/>  
+    </baseAddressPrefixFilters>  
+  </serviceHostingEnvironment>  
+</system.serviceModel>  
+```  
+  
+ 上記の例では、net.tcp:\/\/payroll.myorg.com:8000 と http:\/\/shipping.myorg.com:8000 が、対応するスキームに対して渡されるベース アドレスです。  
+  
+ `baseAddressPrefixFilter` では、ワイルカードはサポートされません。  
+  
+ IIS が提供するベース アドレスには、`baseAddressPrefixFilters` 一覧に存在しない他のスキームにバインドされたアドレスが指定される場合があります。これらのアドレスはフィルターで除外されません。  
+  
+## .NET Framework 4 以降での複数の IIS バインディングのサポート  
+ .NET 4 以降、<xref:System.ServiceModel.ServiceHostingEnvironment> の <xref:System.ServiceModel.ServiceHostingEnvironment.MultipleSiteBindingsEnabled%2A> 設定を true に設定するだけで、1 つのベース アドレスを選択しなくても、IIS で複数のバインディングのサポートが有効になります。このサポートは、HTTP プロトコル スキームに限定されます。  
+  
+ [\<serviceHostingEnvironment\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) 上で multipleSiteBindingsEnabled を使用する構成コード例を次に示します。  
+  
+```  
+  
+<system.serviceModel>  
+  <serviceHostingEnvironment multipleSiteBindingsEnabled=”true” >  
+  </serviceHostingEnvironment>  
+</system.serviceModel>  
+```  
+  
+ 複数のサイト バインディングがこの設定を使用して有効になっている場合、HTTP プロトコルと非 HTTP プロトコルの両方について、baseAddressPrefixFilters 設定は無視されます。  
+  
+ 詳細および例については、「[複数の IIS サイト バインディングのサポート](../../../../docs/framework/wcf/feature-details/supporting-multiple-iis-site-bindings.md)」および「<xref:System.ServiceModel.ServiceHostingEnvironment.MultipleSiteBindingsEnabled%2A>」を参照してください。  
+  
+## WCF サービスによるアドレスの拡張  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの既定のアドレス指定モデルでは、エンドポイント アドレス URI を次の目的で使用します。  
+  
+-   サービスがリッスンするアドレス、つまりエンドポイントがメッセージをリッスンする位置の指定  
+  
+-   SOAP アドレス フィルター、つまりエンドポイントが SOAP ヘッダーとして待機するアドレスの指定  
+  
+ これらの目的で使用する値は個別に指定することができるため、アドレス指定の拡張が可能になり、次に示すような役に立つシナリオに対応します。  
+  
+-   SOAP 中継局 : クライアントが送信したメッセージは、最終目的地に到達する前にメッセージを処理する 1 つ以上の追加サービスを経由します。SOAP 中継局は、メッセージのキャッシュ、ルーティング、負荷分散、スキーム検証など多様なタスクを実行できます。このシナリオは、最終的な送信先である論理アドレス \(`wsa:To`\) ではなく、中継局を目的とする独立した物理アドレス \(`via`\) にメッセージを送信することによって実現されます。  
+  
+-   エンドポイントがリッスンするアドレスはプライベート URI であり、`listenURI` プロパティとは異なる値が設定されます。  
+  
+ `via` が指定するトランスポート アドレスはメッセージが最初に送信される場所で、この後にメッセージは、`to` パラメーターによって指定された、サービスが存在する別のリモート アドレスに送信されます。インターネットの場合、`via` URI は、サービスの最終的な `to` アドレスの <xref:System.ServiceModel.EndpointAddress.Uri%2A> プロパティと同じになります。この 2 つのアドレスを区別するのは、手動ルーティングを行う必要がある場合のみです。  
+  
+### ヘッダーのアドレス指定  
+ エンドポイントは、基本となる URI だけでなく、1 つ以上の SOAP ヘッダーによってアドレス指定することもできます。これが役に立つのは、エンドポイントのクライアントに中継局を指す SOAP ヘッダーを含める必要がある、SOAP 中継局のシナリオの場合です。  
+  
+ カスタムのアドレス ヘッダーは、コードまたは構成のいずれかを使用して次のように定義できます。  
+  
+-   コードを使用する場合、カスタムのアドレス ヘッダーは <xref:System.ServiceModel.Channels.AddressHeader> クラスを使用して作成し、<xref:System.ServiceModel.EndpointAddress> の構築時に使用されます。  
+  
+-   構成を使用する場合、カスタムの [\<headers\>](../../../../docs/framework/configure-apps/file-schema/wcf/headers.md)[\<endpoint\> は、](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の子要素として指定します。  
+  
+ 配置後もヘッダーを変更できるため、コードよりも構成を使用する方法を一般的にお勧めします。  
+  
+### カスタム リッスン アドレス  
+ リッスンするアドレスには、エンドポイントの URI とは異なる値を設定できます。これは、SOAP アドレスがパブリックな SOAP 中継局として公開される一方、エンドポイントが実際にリッスンするアドレスはプライベートなネットワーク アドレスであるような中継局シナリオの場合に便利です。  
+  
+ カスタム リッスン アドレスは、コードまたは構成のいずれかを使用して指定できます。  
+  
+-   コードを使用する場合、カスタム リッスン アドレスはエンドポイントの動作コレクションに <xref:System.ServiceModel.Description.ClientViaBehavior> クラスを追加して指定します。  
+  
+-   構成を使用する場合、カスタム リッスン アドレスはサービスの [\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の `ListenUri` 属性で指定します。  
+  
+### カスタム SOAP アドレス フィルター  
+ エンドポイントの SOAP アドレス フィルター \(<xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter%2A>\) を定義するには、<xref:System.ServiceModel.EndpointAddress.Uri%2A> に任意の <xref:System.ServiceModel.EndpointAddress.Headers%2A> プロパティを組み合わせて使用します。既定では、このフィルターは受信メッセージの `To` メッセージ ヘッダーが、エンドポイントの URI に一致し、必要なすべてのエンドポイント ヘッダーがメッセージ内に存在していることを検証します。  
+  
+ シナリオによっては、適切な `To` ヘッダーを持つメッセージだけではなく、基になるトランスポートに到着したすべてのメッセージをエンドポイントで受信します。これを行うには、ユーザーは <xref:System.ServiceModel.Dispatcher.MatchAllMessageFilter> クラスを使用します。  
+  
+## 参照  
+ [エンドポイント アドレスの指定](../../../../docs/framework/wcf/specifying-an-endpoint-address.md)   
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md b/docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md
new file mode 100644
index 00000000000..4c6545a5dc7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md
@@ -0,0 +1,99 @@
+---
+title: "エンドポイント : アドレス、バインディング、およびコントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エンドポイント [WCF]"
+  - "WCF [WCF], エンドポイント"
+  - "Windows Communication Foundation [WCF], エンドポイント"
+ms.assetid: 9ddc46ee-1883-4291-9926-28848c57e858
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# エンドポイント : アドレス、バインディング、およびコントラクト
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを使用して行われるすべての通信では、サービスの*エンドポイント*が使用されます。エンドポイントは、クライアントが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスによって提供される機能にアクセスできるようにします。  
+  
+ 各エンドポイントは、次の 4 つのプロパティで構成されます。  
+  
+-   そのエンドポイントの場所を示すアドレス。  
+  
+-   クライアントがエンドポイントと通信する方法を指定するバインディング。  
+  
+-   利用可能な操作を識別するためのコントラクト。  
+  
+-   エンドポイントのローカル実装の詳細を指定する一連の動作。  
+  
+ ここでは、エンドポイントの構造と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] オブジェクト モデルでの表現方法について説明します。  
+  
+## エンドポイントの構造  
+ 各エンドポイントの構造は次のとおりです。  
+  
+-   アドレス : アドレスは、エンドポイントを一意に識別し、サービスの潜在的ユーザーにそのエンドポイントの場所を示します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] オブジェクト モデルでは、<xref:System.ServiceModel.EndpointAddress> クラスで表されます。<xref:System.ServiceModel.EndpointAddress> クラスには次のものが含まれます。  
+  
+    -   <xref:System.ServiceModel.EndpointAddress.Uri%2A> プロパティは、サービスのアドレスを表します。  
+  
+    -   <xref:System.ServiceModel.EndpointAddress.Identity%2A> プロパティは、サービスのセキュリティ ID とオプションのメッセージ ヘッダーのコレクションを表します。オプションのメッセージ ヘッダーは、エンドポイントの識別またはエンドポイントとの対話のための、より詳細なアドレス指定情報を追加するために使用されます。  
+  
+     [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [エンドポイント アドレスの指定](../../../../docs/framework/wcf/specifying-an-endpoint-address.md).  
+  
+-   バインディング : バインディングは、エンドポイントとの通信方法を指定します。バインディングには、以下の項目が含まれます。  
+  
+    -   使用するトランスポート プロトコル \(例 : TCP や HTTP\)。  
+  
+    -   メッセージに使用するエンコーディング \(例 : テキストやバイナリ\)。  
+  
+    -   必要なセキュリティ要件 \(例 : SSL メッセージ セキュリティや SOAP メッセージ セキュリティ\)。  
+  
+     [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [WCF のバインディングの概要](../../../../docs/framework/wcf/bindings-overview.md).[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] オブジェクト モデルでは、バインディングは抽象基本クラス <xref:System.ServiceModel.Channels.Binding> で表されます。ほとんどのシナリオでは、システム指定のバインディングを使用できます。詳細については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+-   コントラクト : コントラクトは、エンドポイントがクライアントに公開する機能を示します。コントラクトは、以下の項目を指定します。  
+  
+    -   クライアントから呼び出すことができる操作。  
+  
+    -   メッセージの形式。  
+  
+    -   操作を呼び出すために必要な入力パラメーターまたはデータの型。  
+  
+    -   クライアントが予期できる処理メッセージまたは応答メッセージの種類。  
+  
+     コントラクトの定義の詳細については、「[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  
+  
+-   動作 : エンドポイントの動作を使用すると、サービス エンドポイントのローカル動作をカスタマイズできます。これを実現するため、エンドポイントの動作は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムのビルド プロセスに参加します。エンドポイントの動作の一例は、<xref:System.ServiceModel.Description.ServiceEndpoint.ListenUri%2A> プロパティです。これにより、SOAP アドレスまたは Web サービス記述言語 \(WSDL\) アドレスとは異なるリッスン アドレスを指定できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ClientViaBehavior](../../../../docs/framework/wcf/diagnostics/wmi/clientviabehavior.md).  
+  
+## エンドポイントの定義  
+ サービスのエンドポイントはコードを使用して強制的に指定するか、構成を介して宣言として指定できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[方法 : 構成にサービス エンドポイントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)」および「[方法 : コード内にサービス エンドポイントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md)」を参照してください。  
+  
+## このセクションの内容  
+ このセクションでは、バインディング、エンドポイント、およびアドレスの目的を説明し、バインディングとエンドポイントの構成方法および `ClientVia` 動作と `ListenUri` プロパティの使用方法を示します。  
+  
+ [アドレス](../../../../docs/framework/wcf/feature-details/endpoint-addresses.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのエンドポイントのアドレス指定の方法について説明します。  
+  
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)  
+ バインディングを使用して、クライアントとサービスが相互に通信するために必要なトランスポート、エンコーディング、およびプロトコルの詳細を指定する方法について説明します。  
+  
+ [コントラクト](../../../../docs/framework/wcf/feature-details/contracts.md)  
+ コントラクトでサービスのメソッドが定義されるしくみについて説明します。  
+  
+ [方法 : 構成にサービス エンドポイントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md)  
+ 構成にサービス エンドポイントを作成する方法について説明します。  
+  
+ [方法 : コード内にサービス エンドポイントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md)  
+ コード内にサービス エンドポイントを作成する方法について説明します。  
+  
+ [方法 : Svcutil.exe を使用してコンパイル済みサービス コードを検証する](../../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-validate-compiled-service-code.md)  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、サービスをホストせずにサービスの実装と構成でエラーを検出する方法について説明します。  
+  
+## 参照  
+ [サービスの構成](../../../../docs/framework/wcf/configuring-services.md)   
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md b/docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md
new file mode 100644
index 00000000000..ca465f97600
--- /dev/null
+++ b/docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md
@@ -0,0 +1,106 @@
+---
+title: "データ コントラクトの列挙型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], 列挙型"
+ms.assetid: b5d694da-68cb-4b74-a5fb-75108a68ec3b
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# データ コントラクトの列挙型
+列挙はデータ コントラクト モデルで表現できます。  このトピックでは、いくつかの例を通してプログラミング モデルを説明します。  
+  
+## 列挙の基本  
+ データ コントラクト モデルで列挙型を使用する 1 つの方法として、<xref:System.Runtime.Serialization.DataContractAttribute> 属性を型に割り当てる方法があります。  この場合、データ コントラクトに含める必要のある各メンバーに <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性を適用する必要があります。  
+  
+ 2 つのクラスを次の例に示します。  1 つ目は列挙を使用し、2 つ目は列挙を定義します。  
+  
+ [!code-csharp[c_DataContractEnumerations#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#1)]
+ [!code-vb[c_DataContractEnumerations#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#1)]  
+  
+ `Car` クラスのインスタンスは、`condition` フィールドの値が `New`、`Used`、`Rental` のいずれかに設定されている場合にのみ送受信できます。  `condition` が、`Broken` または `Stolen` の場合、<xref:System.Runtime.Serialization.SerializationException> がスローされます。  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute> プロパティ \(<xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> と <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A>\) を、列挙データ コントラクトとして通常通り使用できます。  
+  
+### 列挙メンバー値  
+ 通常、データ コントラクトには、数値ではなく列挙メンバー名が含まれます。  ただし、データ コントラクト モデルを使用しているときに、受信側が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントである場合、エクスポートされたスキーマは数値を保持します。  これは、[XmlSerializer クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-xmlserializer-class.md)を使用している場合は、当てはまりません。  
+  
+ 前の例では、`condition` が `Used` に設定され、データが XML にシリアル化されると、結果の XML は `<condition>Used</condition>` になりますが `<condition>1</condition>` にはなりません。  したがって、次のデータ コントラクトは、`CarConditionEnum` のデータ コントラクトと同じです。  
+  
+ [!code-csharp[c_DataContractEnumerations#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#2)]
+ [!code-vb[c_DataContractEnumerations#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#2)]  
+  
+ たとえば、`CarConditionEnum` を送信側で使用し、`CarConditionWithNumbers` を受信側で使用できます。  送信側で `Used` に値 "1" を使用し、受信側で値 "20" を使用しても、XML 表現は送信側と受信側共に `<condition>Used</condition>` です。  
+  
+ データ コントラクトに含めるには、<xref:System.Runtime.Serialization.EnumMemberAttribute> 属性を適用する必要があります。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、列挙に特殊な値 0 \(ゼロ\) を常に割り当てることができます。これはまた、すべての列挙の既定値になります。  ただし、この特殊値ゼロも <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性を使用してマークされない限りシリアル化できません。  
+  
+ これには、次のような 2 つの例外があります。  
+  
+-   フラグ列挙体 \(このトピックの後で説明\)  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute.EmitDefaultValue%2A> プロパティが `false` に設定された列挙データ メンバー \(この場合、値がゼロの列挙はシリアル化されたデータから除外される\)  
+  
+### 列挙メンバー値のカスタマイズ  
+ データ コントラクトの一部を形成する列挙メンバー値は、<xref:System.Runtime.Serialization.EnumMemberAttribute> 属性の <xref:System.Runtime.Serialization.EnumMemberAttribute.Value%2A> プロパティを使ってカスタマイズできます。  
+  
+ たとえば、次のデータ コントラクトは `CarConditionEnum` のデータ コントラクトとも等価です。  
+  
+ [!code-csharp[c_DataContractEnumerations#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#3)]
+ [!code-vb[c_DataContractEnumerations#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#3)]  
+  
+ シリアル化されると、`PreviouslyOwned` の値には XML 表現 `<condition>Used</condition>` が含まれます。  
+  
+## 単純な列挙  
+ <xref:System.Runtime.Serialization.DataContractAttribute> 属性が割り当てられていない列挙型をシリアル化することもできます。  このような列挙型は、前の説明とまったく同じように扱われます。ただし、すべてのメンバー \(<xref:System.NonSerializedAttribute> 属性は適用されていない\) に <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性が適用されているかのように扱われる点が異なります。  たとえば、次の列挙は、前の `CarConditionEnum` の例と同じデータ コントラクトが暗黙的に含まれます。  
+  
+ [!code-csharp[c_DataContractEnumerations#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#6)]
+ [!code-vb[c_DataContractEnumerations#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#6)]  
+  
+ 列挙のデータ コントラクト名と名前空間、および列挙メンバー値をカスタマイズする必要がない場合に、単純な列挙を使用できます。  
+  
+#### 単純な列挙に関するメモ  
+ <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性を単純な列挙に適用しても効力はありません。  
+  
+ <xref:System.SerializableAttribute> 属性を列挙に適用してもしなくても変わりはありません。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> クラスが、列挙メンバーに適用された <xref:System.NonSerializedAttribute> 属性を受け入れるという事実は、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> と <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> の動作とは異なります。  この 2 つのシリアライザーは <xref:System.NonSerializedAttribute> 属性を無視します。  
+  
+## フラグ列挙体  
+ 列挙体に <xref:System.FlagsAttribute> 属性を適用できます。  この場合、ゼロ個以上の列挙値のリストを同時に送受信できます。  
+  
+ これを行うには、<xref:System.Runtime.Serialization.DataContractAttribute> 属性をフラグ列挙体に適用し、2 の累乗であるすべてのメンバーを、<xref:System.Runtime.Serialization.EnumMemberAttribute> 属性を使用してマークします。  フラグ列挙体を使用するには、数列は \(1、2、4、8、16、32、64 のように\) 2 の累乗の連続である必要があります。  
+  
+ フラグの列挙値を送信する手順を次に示します。  
+  
+1.  数値にマップする列挙メンバー \(<xref:System.Runtime.Serialization.EnumMemberAttribute> 属性が適用されている\) の検索を試みます。  見つかった場合、そのメンバーのみを含むリストを送信します。  
+  
+2.  合計の各部にマップされる列挙メンバー \(それぞれに <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性が適用されている\) が存在するような形で、数値をこの合計に分割します。  このメンバーすべてのリストを送信します。  このような合計を見つけるために、*最長一致アルゴリズム*が使用されます。したがって、このような合計が存在したとしても見つかるとは限りません。  この問題を回避するには、列挙メンバーの数値を必ず 2 の累乗数にします。  
+  
+3.  前の 2 つの手順が失敗し、数値がゼロ以外の場合、<xref:System.Runtime.Serialization.SerializationException> をスローします。  数値がゼロの場合、空のリストを送信します。  
+  
+### 例  
+ フラグ操作で使用できる列挙の例を次に示します。  
+  
+ [!code-csharp[c_DataContractEnumerations#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#4)]
+ [!code-vb[c_DataContractEnumerations#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#4)]  
+  
+ 次の各値は、示されているようにシリアル化されます。  
+  
+ [!code-csharp[c_DataContractEnumerations#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontractenumerations/cs/source.cs#5)]
+ [!code-vb[c_DataContractEnumerations#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontractenumerations/vb/source.vb#5)]  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/error-handling.md b/docs/framework/wcf/feature-details/error-handling.md
new file mode 100644
index 00000000000..dcad4a0918e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/error-handling.md
@@ -0,0 +1,78 @@
+---
+title: "Error handling | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c948841a-7db9-40ae-9b78-587d216cbcaf
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Error handling
+## Windows Communication Foundation でのエラー処理  
+ サービスで予期しない例外やエラーが発生した場合、例外処理ソリューションを設計する方法は複数あります。  "正しい" または "最善" のエラー処理ソリューションが 1 つもない場合でも、検討する必要のある有効な手段が複数あります。  通常は、WCF 実装の複雑さ、例外の種類と頻度、例外の性質上処理対象かどうか、および関連付けられたトレース、ログ、またはポリシー要件に応じて、  以下に記載されている手法を複数組み合わせたハイブリッド ソリューションを実装することをお勧めします。  
+  
+ これらのソリューションについては、このセクションの残りの部分で詳しく説明します。  
+  
+### Microsoft Enterprise Library  
+ Microsoft Enterprise Library Exception Handling Application Block は、共通の設計パターンを実装し、エンタープライズ アプリケーションのすべてのアーキテクチャ レイヤーで発生する例外を処理するための一貫した戦略を策定するのに役立ちます。  これは、アプリケーション コンポーネントの catch ステートメントに含まれる一般的なコードをサポートするように設計されています。  開発者は、アプリケーション全体で同一の catch ブロックにこのコード \(例外情報をログに記録するコードなど\) を繰り返し使用する代わりに、Exception Handling Application Block を使用すると、このロジックを再利用可能な例外ハンドラーとしてカプセル化できます。  
+  
+ このライブラリには、すぐに使用できる Fault Contract Exception Handler が含まれています。  この例外ハンドラーは、Windows® Communication Foundation \(WCF\) のサービス境界で使用することを目的に設計されており、例外から新しいエラー コントラクトを生成します。  
+  
+ アプリケーション ブロックは、よく使用されるベスト プラクティスを組み込み、アプリケーション全体の例外処理に共通の方法を提供することを目的としています。  その一方で、独自に開発されたカスタム エラー ハンドラーやエラー コントラクトが非常に便利な場合もあります。  たとえば、カスタム エラー ハンドラーを使用すると、すべての例外を自動的に FaultExceptions に昇格し、さらにアプリケーションにログ機能を追加できるようになります。  
+  
+ 詳細については、「[Microsoft Enterprise Library](http://msdn.microsoft.com/library/ff632023.aspx)」を参照してください。  
+  
+### 予期される例外の処理  
+ 適切な行動方針として、各操作または関連する機能拡張ポイントにおいて予期される例外をキャッチし、キャッチした例外を回復できるかどうかを判断して、FaultException\<T\> で適切なカスタム エラーを返します。  
+  
+### IErrorHandler を使用した予期しない例外の処理  
+ 予期しない例外を処理するには、行動方針として IErrorHandler を "フックする" ことをお勧めします。  エラー ハンドラーは、チャネル層ではなく WCF ランタイム レベル \("サービス モデル" 層\) でのみ例外をキャッチします。  チャネル レベルで IErrorHandler をフックする唯一の方法は、カスタム チャネルを作成することです。ただし、これはほとんどのシナリオで推奨されていません。  
+  
+ 一般的に、"予期しない例外" とは、回復不可能な例外でも処理例外でもなく、予期しないユーザー例外のことです。  回復不可能な例外 \(メモリ不足の例外など\) は、一般的に[ExceptionHandler クラス](http://msdn.microsoft.com/library/system.servicemodel.dispatcher.exceptionhandler.aspx)によって自動的に処理される例外で、通常は正常に処理できません。このような例外の処理は、単に追加のログ記録を行うため、または標準の例外をクライアントに返すためにのみ行われます。  処理例外は、シリアル化、エンコーダー、フォーマッタ レベルなどのメッセージの処理中に発生します。通常、この例外は IErrorHandler では処理できません。これは、一般的に、このような例外が発生するまでにエラー ハンドラーの介入が早すぎるか、遅すぎることが原因です。  同様に、トランスポート例外も IErrorHandler では処理できません。  
+  
+ IErrorHandler を使用すると、例外がスローされたときのアプリケーションの動作を明示的に制御できます。  次のような操作が可能です。  
+  
+1.  クライアントにエラーを送信するかどうかを決定する  
+  
+2.  例外をエラーに置き換える  
+  
+3.  エラーを別のエラーに置き換える  
+  
+4.  ログまたはトレースを実行する  
+  
+5.  他のカスタム アクティビティを実行する  
+  
+ カスタム エラー ハンドラーは、サービスのチャネル ディスパッチャーの ErrorHandlers プロパティに追加することでインストールできます。  複数のエラー ハンドラーを設定することができ、これらはこのコレクションに追加された順序で呼び出されます。  
+  
+ IErrorHandler.ProvideFault は、クライアントに送信されるエラー メッセージを制御します。  このメソッドは、サービスの操作によってスローされた例外の種類に関係なく呼び出されます。  ここで操作が実行されない場合、WCF は、その既定の動作を想定し、カスタム エラー ハンドラーが存在しないかのように続行します。  
+  
+ この方法を使用する可能性がある場合として、クライアントに送信される前の例外をエラーに変換するための一元的な場所を作成する場合があります \(インスタンスが破棄されておらず、チャネルが Faulted 状態に移行していないことを確認します\)。  
+  
+ 通常、IErrorHandler.HandleError メソッドは、エラー ログ記録、システム通知、アプリケーションのシャットダウンなど、エラー関連の動作を実装するために使用されます。  IErrorHandler.HandleError は、サービス内の複数の場所で呼び出すことができます。エラーがスローされた場所に応じて、HandleError メソッドは操作と同じスレッドから呼び出される場合と呼び出されない場合があります \(この点について保証はありません\)。  
+  
+### WCF 外部での例外の処理  
+ 多くの場合、構成の例外、データベース接続文字列の例外、およびその他の同様の例外は、WCF アプリケーションのコンテキスト内で発生する可能性がありますが、これらの例外自体は、サービス モデルまたは Web サービス自体が原因で発生する例外ではありません。  これらの例外は、Web サービス外部の "標準" の例外で、環境の中で他の外部例外が処理されるのと同様に処理される必要があります。  
+  
+### 例外のトレース  
+ トレースとは、すべての例外を確認できる可能性のある唯一の "汎用的な" 場所です。  例外のトレースとログの詳細については、「トレースとログ」を参照してください。  
+  
+### WebGetAttribute と WebInvokeAttribute を使用した場合の URI テンプレート エラー  
+ WebGet 属性と WebInvoke 属性を使用すると、要求アドレスのコンポーネントを操作パラメーターにマップする URI テンプレートを指定できます。  たとえば、URI テンプレートが "weather\/{state}\/{city}" の場合は、要求アドレスがリテラル トークン、state という名前のパラメーター、および city という名前にマップされます。  その後、これらのパラメーターは、名前によって、操作の仮パラメーターの一部にバインドされる場合があります。  
+  
+ テンプレート パラメーターが URI 内の文字列の形式で表されるのに対し、型指定されたコントラクトの仮パラメーターは文字列以外の型である可能性があります。  そのため、操作が呼び出される前に変換を行う必要があります。  [変換形式の表](http://msdn.microsoft.com/library/bb412172.aspx)をご利用いただけます。  
+  
+ ただし、変換に失敗した場合は、失敗したことを操作に認識させる方法はありません。  代わりに、型変換は、ディスパッチ エラーの形式で表示されます。  
+  
+ 型変換のディスパッチ エラーは、エラー ハンドラーをインストールすることで、その他多くの種類のディスパッチ エラーと同様に調査できます。  IErrorHandler 機能拡張ポイントは、サービス レベルの例外を処理するために呼び出されます。  そこから、呼び出し元に返される応答を選択できます \(カスタム タスクとレポートを実行することもできます\)。  
+  
+## 参照  
+ [WCF エラー処理](http://msdn.microsoft.com/library/gg281715.aspx)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/exporting-and-importing-metadata.md b/docs/framework/wcf/feature-details/exporting-and-importing-metadata.md
new file mode 100644
index 00000000000..8b0366a4a46
--- /dev/null
+++ b/docs/framework/wcf/feature-details/exporting-and-importing-metadata.md
@@ -0,0 +1,80 @@
+---
+title: "メタデータのエクスポートとインポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ [WCF], エクスポートとインポート"
+ms.assetid: 614a75bb-e0b0-4c95-b6d8-02cb5e5ddb38
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# メタデータのエクスポートとインポート
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、メタデータのエクスポートは、サービス エンドポイントを説明したり、クライアントがサービスの使用方法を理解するために使用できる、対応した標準的な表現にメタデータを移し替えたりするプロセスです。サービス メタデータのインポートは <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンス、またはサービス メタデータの一部を生成するプロセスです。  
+  
+## メタデータのエクスポート  
+ メタデータを <xref:System.ServiceModel.Description.ServiceEndpoint?displayProperty=fullName> インスタンスからエクスポートするには、<xref:System.ServiceModel.Description.MetadataExporter> 抽象クラスの実装を使用します。<xref:System.ServiceModel.Description.WsdlExporter> 型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる <xref:System.ServiceModel.Description.MetadataExporter> 抽象クラスの実装です。  
+  
+ <xref:System.ServiceModel.Description.WsdlExporter?displayProperty=fullName> 型は Web サービス記述言語 \(WSDL: Web Services Description Language\) メタデータを生成します。このメタデータには、<xref:System.ServiceModel.Description.MetadataSet> インスタンス内にカプセル化されたポリシー表現が関連付けられています。<xref:System.ServiceModel.Description.WsdlExporter?displayProperty=fullName> インスタンスを使用すると、<xref:System.ServiceModel.Description.ContractDescription> オブジェクトと <xref:System.ServiceModel.Description.ServiceEndpoint> オブジェクトのメタデータを反復してエクスポートできます。<xref:System.ServiceModel.Description.ServiceEndpoint> オブジェクトのコレクションをエクスポートして、特定のサービス名に関連付けることもできます。  
+  
+> [!NOTE]
+>  `WsdlExporter` は、`ContractDescription.GetContract` メソッドを使用するか、`ServiceHost` インスタンスの `ServiceDescription` の一部として作成された `ContractDescription` インスタンスなど、共通言語ランタイム \(CLR\) の型情報を含む `ContractDescription` インスタンスからメタデータをエクスポートする場合にのみ使用できます。サービス メタデータからインポートした `ContractDescription` インスタンスや、型情報を使用せずに作成したインスタンスからは、`WsdlExporter` を使用してメタデータをエクスポートできません。  
+  
+## メタデータのインポート  
+  
+### WSDL ドキュメントのインポート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス メタデータをインポートするには、<xref:System.ServiceModel.Description.MetadataImporter> 抽象クラスの実装を使用します。<xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> 型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる <xref:System.ServiceModel.Description.MetadataImporter> 抽象クラスの実装です。<xref:System.ServiceModel.Description.WsdlImporter> 型は、<xref:System.ServiceModel.Description.MetadataSet> オブジェクトにまとめられた、結び付けられているポリシーを使用して WSDL メタデータをインポートします。  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter> 型を使用すると、メタデータをインポートする方法を制御できます。すべてのエンドポイント、すべてのバインディング、またはすべてのコントラクトをインポートできます。特定の WSDL サービス、バインディング、またはポートの種類に関連付けられたすべてのエンドポイントをインポートすることもできます。また、特定の WSDL ポートのエンドポイント、特定の WSDL バインディングのバインディング、または特定の WSDL ポートの種類のコントラクトをインポートすることもできます。  
+  
+ また、<xref:System.ServiceModel.Description.WsdlImporter> では、インポートする必要がないコントラクトのセットを指定できるようにする <xref:System.ServiceModel.Description.MetadataImporter.KnownContracts%2A> プロパティが公開されています。この場合、<xref:System.ServiceModel.Description.WsdlImporter> は、同じ修飾名を持つコントラクトをメタデータからインポートする代わりに、<xref:System.ServiceModel.Description.MetadataImporter.KnownContracts%2A> プロパティのコントラクトを使用します。  
+  
+### ポリシーのインポート  
+ <xref:System.ServiceModel.Description.WsdlImporter> 型は、メッセージ、操作、およびエンドポイントのポリシー サブジェクトに関連付けられたポリシー表現を収集した後で、<xref:System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions%2A> コレクションの <xref:System.ServiceModel.Description.IPolicyImportExtension> 実装を使用してポリシー表現をインポートします。  
+  
+ ポリシーのインポート ロジックは、同じ WSDL ドキュメント内のポリシー表現へのポリシーの参照を自動的に処理します。インポート ロジックは `wsu:Id` 属性または `xml:id` 属性で識別されます。ポリシーのインポート ロジックは、アプリケーションでポリシーの循環参照が発生しないようにポリシー表現のサイズを 4096 ノードに制限します。ノードとは、`wsp:Policy`、`wsp:All`、`wsp:ExactlyOne`、または `wsp:policyReference` 要素です。  
+  
+ また、ポリシーのインポート ロジックは、ポリシー表現を自動的に正規化します。入れ子になったポリシー表現や `wsp:Optional` 属性は正規化されません。実行される正規化処理の量は 4096 ステップに制限されます。各ステップでは、ポリシー アサーション、または `wsp:ExactlyOne` 要素の子要素が生成されます。  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter> 型は、異なる WSDL ポリシー サブジェクトに結び付けられているポリシー代替手段の組み合わせを最大で 32 組まで試行します。どの組み合わせを使用しても完全にインポートできない場合は、最初の組み合わせを使用して部分カスタム バインディングが作成されます。  
+  
+## エラー処理  
+ <xref:System.ServiceModel.Description.MetadataExporter> 型や <xref:System.ServiceModel.Description.MetadataImporter> 型は、どちらも `Errors` プロパティを公開します。このプロパティには、エクスポート プロセスおよびインポート プロセスで発生したエラー メッセージおよび警告メッセージのコレクションを格納でき、ツールの実装時に使用できます。  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter> 型は、通常、インポート プロセスでキャッチされた例外に対して例外をスローし、対応するエラーをその `Errors` プロパティに追加します。ただし、<xref:System.ServiceModel.Description.WsdlImporter.ImportAllContracts%2A>、<xref:System.ServiceModel.Description.WsdlImporter.ImportAllBindings%2A>、<xref:System.ServiceModel.Description.WsdlImporter.ImportAllEndpoints%2A>、および <xref:System.ServiceModel.Description.WsdlImporter.ImportEndpoints%2A> の各メソッドはこうした例外をスローしないため、`Errors` プロパティを調べて、これらのメソッドの呼び出し時に問題が発生したかどうかを確認する必要があります。  
+  
+ <xref:System.ServiceModel.Description.WsdlExporter> 型は、エクスポート プロセスでキャッチされたすべての例外を再スローします。`Errors` プロパティでは、この例外はエラーとしてキャプチャされません。<xref:System.ServiceModel.Description.WsdlExporter> は、例外をスローするとエラー状態になるため、再使用できません。ワイルドカード アクションを使用しているために操作をエクスポートできない場合や、重複したバインディング名を検出した場合、<xref:System.ServiceModel.Description.WsdlExporter> はその `Errors` プロパティに警告を追加します。  
+  
+## このセクションの内容  
+ [方法 : メタデータをサービス エンドポイントにインポートする](../../../../docs/framework/wcf/feature-details/how-to-import-metadata-into-service-endpoints.md)  
+ ダウンロードされたメタデータを説明オブジェクトにインポートする方法について説明します。  
+  
+ [方法 : メタデータをサービス エンドポイントからエクスポートする](../../../../docs/framework/wcf/feature-details/how-to-export-metadata-from-service-endpoints.md)  
+ 説明オブジェクトをメタデータにエクスポートする方法について説明します。  
+  
+ [ServiceDescription と WSDL 参照](../../../../docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md)  
+ 説明オブジェクトと WSDL の間のマッピングについて説明します。  
+  
+ [方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする](../../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md)  
+ Svcutil.exe を使用して、コンパイル済みアセンブリのサービス型、コントラクト型、およびデータ型のメタデータをエクスポートする方法について説明します。  
+  
+ [データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)  
+ XML シリアル化用の共通言語ランタイム \(CLR\) 型を表すために <xref:System.Runtime.Serialization.DataContractSerializer> が使用する XML スキーマ \(XSD\) のサブセットについて説明します。  
+  
+## リファレンス  
+ <xref:System.ServiceModel.Description.WsdlExporter>  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter>  
+  
+## 参照  
+ [WCF 拡張に対するカスタム メタデータのエクスポート](../../../../docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md)   
+ [WCF 拡張に対するカスタム メタデータのインポート](../../../../docs/framework/wcf/extending/importing-custom-metadata-for-a-wcf-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/exporting-schemas-from-classes.md b/docs/framework/wcf/feature-details/exporting-schemas-from-classes.md
new file mode 100644
index 00000000000..f00a42cd688
--- /dev/null
+++ b/docs/framework/wcf/feature-details/exporting-schemas-from-classes.md
@@ -0,0 +1,73 @@
+---
+title: "クラスからのスキーマのエクスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, スキーマのインポートとエクスポート"
+  - "スキーマ [WCF], クラスからのエクスポート"
+  - "スキーマ [WCF]"
+  - "XsdDataContractExporter クラス"
+  - "XsdDataContractImporter クラス"
+ms.assetid: bb57b962-70c1-45a9-93d5-e721e340a13f
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# クラスからのスキーマのエクスポート
+データ コントラクト モデルで使用されているクラスから XML スキーマ定義言語 \(XSD\) スキーマを生成するには、<xref:System.Runtime.Serialization.XsdDataContractExporter> クラスを使います。 このトピックでは、スキーマの作成手順を説明します。  
+  
+## エクスポート処理  
+ スキーマのエクスポート処理では、まず型の定義をエクスポートするので、型定義を XML 形式で記述した <xref:System.Xml.Schema.XmlSchemaSet> を生成します。  
+  
+ `XmlSchemaSet` は、一連の XSD スキーマ ドキュメントを表す [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のスキーマ オブジェクト モデル \(SOM\) の一部です。 XSD ドキュメントを `XmlSchemaSet` から生成するために、<xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> クラスの `XmlSchemaSet` プロパティから取得した、スキーマのコレクションを使います。 次に各 <xref:System.Xml.Schema.XmlSchema> オブジェクトを、<xref:System.Xml.Serialization.XmlSerializer> を使ってシリアル化します。  
+  
+#### スキーマをエクスポートするには  
+  
+1.  <xref:System.Runtime.Serialization.XsdDataContractExporter> のインスタンスを作成します。  
+  
+2.  省略可能です。<xref:System.Xml.Schema.XmlSchemaSet> をコンストラクターに渡します。 この場合、空の <xref:System.Xml.Schema.XmlSchemaSet> から開始するのではなく、スキーマのエクスポート時に生成されたスキーマが、この <xref:System.Xml.Schema.XmlSchemaSet> インスタンスに追加されます。  
+  
+3.  省略可能です。<xref:System.Runtime.Serialization.XsdDataContractExporter.CanExport%2A> メソッドのいずれかを呼び出します。 指定された型がエクスポート可能かどうかを判定するメソッドです。 このメソッドには、次に説明する `Export` メソッドと同じオーバーロードがあります。  
+  
+4.  <xref:System.Runtime.Serialization.XsdDataContractExporter.Export%2A> メソッドのいずれかを呼び出します。<xref:System.Type>、<xref:System.Collections.Generic.List%601> オブジェクトの `Type`、または <xref:System.Collections.Generic.List%601> オブジェクトの <xref:System.Reflection.Assembly> を受け取る 3 種類のオーバーロードがあります。 3 つ目のメソッドの場合、指定されたアセンブリのすべての型がエクスポートされます。  
+  
+     `Export` メソッドを何度も呼び出すと、同じ `XmlSchemaSet` に複数の項目が追加されます。`XmlSchemaSet` に既に存在する型は生成されません。 したがって、`Export`  クラスのインスタンスを複数作成するのではなく、同じ `XsdDataContractExporter` に対して `XsdDataContractExporter` を複数回呼び出すようにします。 これにより、同じスキーマ型が重複して生成される状況を回避できます。  
+  
+    > [!NOTE]
+    >  エクスポート処理中に障害が発生した場合、`XmlSchemaSet` は予測できない状態になります。  
+  
+5.  <xref:System.Xml.Schema.XmlSchemaSet> プロパティを介して、<xref:System.Runtime.Serialization.XsdDataContractExporter.Schemas%2A> にアクセスします。  
+  
+## エクスポート オプション  
+ <xref:System.Runtime.Serialization.XsdDataContractExporter.Options%2A> の <xref:System.Runtime.Serialization.XsdDataContractExporter> プロパティとして <xref:System.Runtime.Serialization.ExportOptions> クラスのインスタンスを設定することにより、エクスポート処理の方法を制御できます。 具体的には、次のオプションを設定できます。  
+  
+-   <xref:System.Runtime.Serialization.ExportOptions.KnownTypes%2A>。`Type` のコレクションであり、エクスポートされる型に対応する既知の型を表します  \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください\)。 これらの既知の型は、`Export` メソッドに渡された型と共に、`Export` 呼び出しが行われるたびにエクスポートされます。  
+  
+-   <xref:System.Runtime.Serialization.ExportOptions.DataContractSurrogate%2A>。 このプロパティを介して <xref:System.Runtime.Serialization.IDataContractSurrogate> を渡すことにより、エクスポート処理をカスタマイズできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md)。 既定では、サロゲートは使用されません。  
+  
+## ヘルパー メソッド  
+ `XsdDataContractExporter` には、主要な機能であるスキーマのエクスポート処理に加え、型に関する情報を調べるためのヘルパー メソッドが定義されています。 以下に例を示します。  
+  
+-   <xref:System.Runtime.Serialization.XsdDataContractExporter.GetRootElementName%2A> メソッド`Type` を受け取り、この型をルート オブジェクトとしてシリアル化した場合に使用されるルート要素名と名前空間を表す <xref:System.Xml.XmlQualifiedName> を返します。  
+  
+-   <xref:System.Runtime.Serialization.XsdDataContractExporter.GetSchemaTypeName%2A> メソッド`Type` を引数とし、この型をスキーマにエクスポートした場合に使用される XSD スキーマ型の名前を表す <xref:System.Xml.XmlQualifiedName> を返します。 スキーマ内で匿名型として表される <xref:System.Xml.Serialization.IXmlSerializable> 型を引数として渡すと、`null` を返します。  
+  
+-   <xref:System.Runtime.Serialization.XsdDataContractExporter.GetSchemaType%2A> メソッド スキーマ内で匿名型として表される <xref:System.Xml.Serialization.IXmlSerializable> 型を渡した場合にのみ有効なメソッドで、それ以外の型の場合は `null` を返します。 匿名型に対しては、特定の <xref:System.Xml.Schema.XmlSchemaType> を表す `Type` を返します。  
+  
+ 以上のメソッドの動作は、エクスポート オプションの影響を受けます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.XsdDataContractImporter>   
+ <xref:System.Runtime.Serialization.XsdDataContractExporter>   
+ [スキーマのインポートとエクスポート](../../../../docs/framework/wcf/feature-details/schema-import-and-export.md)   
+ [クラスを作成するためのスキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/extended-protection-for-authentication-overview.md b/docs/framework/wcf/feature-details/extended-protection-for-authentication-overview.md
new file mode 100644
index 00000000000..926d0f0a47b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/extended-protection-for-authentication-overview.md
@@ -0,0 +1,43 @@
+---
+title: "認証の拡張保護の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d2ceffe-a7bf-4bd9-a5a2-9406423bd7f8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# 認証の拡張保護の概要
+認証時の拡張保護によって、攻撃者がクライアントの資格情報をインターセプトして特定のサーバーに転送する man\-in\-the\-middle \(MITM\) 攻撃を防ぐことができます。  
+  
+ クライアント、サーバー、および攻撃者の 3 つの参加要素が存在するシナリオについて考えてみます。サーバーには `https://server` という URL があり、一方で攻撃者には `https://attacker` という URL があります。攻撃者は、自身がサーバーであるかのようにしてクライアントが攻撃者にアクセスするように騙します。次に、攻撃者はサーバーに要求を送信します。攻撃者がセキュリティで保護されたリソースへのアクセスを試みると、サーバーは攻撃者に対して WWW 認証ヘッダーで応答します。攻撃者は認証情報を持っていないため、WWW 認証ヘッダーをクライアントに送信します。クライアントは攻撃者に WWW 認証ヘッダーを送信し、攻撃者はそのヘッダーをサーバーに送信してクライアントの資格情報を利用してセキュリティで保護されたリソースにアクセスします。  
+  
+ 現在のところ、クライアント アプリケーションが HTTPS で Kerberos、Digest または NTLM を使用してサーバーに対する認証を実行する場合、最初にトランスポート レベルのセキュリティ \(TLS\) チャネルが構築され、このチャネルを使用して認証が行われます。しかし、Secure Sockets Layer \(SSL\) によって生成されるセッション キーと認証時に生成されるセッション キーはバインドされていません。そのため前述のシナリオでは、TLS \(HTTPS チャネルなど\) で通信が行われると、2 つの SSL チャネルが作成されます。1 つはクライアントと攻撃者間のチャネルで、もう 1 つは攻撃者とサーバー間のチャネルです。まず、クライアントの資格情報がクライアントと攻撃者間の SSL チャネルでクライアントからサーバーに送信され、次に、攻撃者とサーバー間のチャネルでクライアントの資格情報が送信されます。クライアントの資格情報がサーバーに届くと、サーバーは情報が送信されたチャネルを検出せずに、クライアントではなく攻撃者から発信された資格情報を確認します。  
+  
+ これを解決するには、TLS で保護された外部チャネルとクライアントが認証されている内部チャネルを使用して、チャネル バインディング トークン \(CBT\) をサーバーに渡します。CBT は TLS で保護された外部チャネルのプロパティで、外部チャネルをクライアントが認証されている内部チャネルでの対話とバインドするために使用します。  
+  
+ 前述のシナリオでは、クライアントと攻撃者間の TLS チャネルの CBT は、サーバーに送信される認証情報によって結び付けられます。CBT 管理サーバーは、クライアントと攻撃者間のチャネルに対応するクライアント認証情報内の CBT を、攻撃者とサーバー間のチャネルに追加されている CBT と比較します。CBT はチャネルの送信先によって特定されるため、クライアントと攻撃者間の CBT は、攻撃者とサーバー間の CBT とは一致しません。これにより、サーバーは MITM 攻撃を検出して認証要求を拒否することができます。  
+  
+ クライアント側が構成設定する必要は一切ありません。クライアントが CBT をサーバーに渡すように更新しておくと、常にこの動作が実行されます。サーバーを更新しておくと、サーバーが CBT を使用するように設定したり、CBT を無視するように設定することもできます。サーバーを更新しない場合、CBT は無視されます。  
+  
+ サーバーには、次の保護レベルを設定できます。  
+  
+-   なし。チャネル バインディングの検証は実行されません。更新されていないすべてのサーバーの動作です。  
+  
+-   一部。更新されたすべてのクライアントは、サーバーにチャネル バインディング情報を提供する必要があります。クライアントが更新されていなければ、その必要はありません。アプリケーションの互換性を許容する中間のオプションです。  
+  
+-   完全。すべてのクライアントがチャネル バインディング情報を提供する必要があります。サーバーは、クライアントが要求しないクライアントからの認証要求を拒否します。  
+  
+ 詳細については、Win7 CBT\/拡張保護サンプルを参照してください。  
+  
+## 参照  
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/federation-and-issued-tokens.md b/docs/framework/wcf/feature-details/federation-and-issued-tokens.md
new file mode 100644
index 00000000000..39eb33d7f87
--- /dev/null
+++ b/docs/framework/wcf/feature-details/federation-and-issued-tokens.md
@@ -0,0 +1,74 @@
+---
+title: "フェデレーションと発行済みトークン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション [WCF], 発行済みトークン"
+  - "発行済みトークン [WCF]"
+  - "WCF, フェデレーション"
+ms.assetid: 4c31ee7d-a820-4067-8b84-a83049021bb6
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# フェデレーションと発行済みトークン
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用すれば、WS\-Federation および WS\-Trust 仕様を実装したサービスとセキュリティで保護された通信を行うクライアントを作成できます。これらの仕様では、異なる信頼領域間での認証と承認を可能にする機構を提供するために、XML、SOAP、および Web サービス記述言語 \(WSDL: Web Services Description Language\) が使用されます。  
+  
+## このセクションの内容  
+ [フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)  
+ フェデレーションの概要を説明します。  
+  
+ [フェデレーションと信頼](../../../../docs/framework/wcf/feature-details/federation-and-trust.md)  
+ フェデレーション サービスまたはクライアントを作成するときに注意する必要がある設計上の問題を示します。  
+  
+ [方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でフェデレーション クライアントを作成するための基本を説明します。  
+  
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)  
+ フェデレーション サービスを作成する手順を説明します。  
+  
+ [方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)  
+ `WSFederationHttpBinding` を使用するクライアントおよびサービスを構成する方法を説明します。  
+  
+ [方法 : セキュリティ トークン サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-token-service.md)  
+ セキュリティ トークン サービスを作成する手順を説明します。  
+  
+ [SAML \(Security Assertions Markup Language\) トークンとクレーム](../../../../docs/framework/wcf/feature-details/saml-tokens-and-claims.md)  
+ 多様なクレームの種類を作成できる拡張可能な SAML \(Security Assertions Markup Language\) トークンについて説明します。  
+  
+ [方法 : ローカル発行者を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)  
+ セキュリティ トークンのローカル発行者の作成方法を説明します。  
+  
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)  
+ `WSFederationHttpBinding` のセキュリティで保護されたセッションを無効にする方法を説明します。クライアントごとにセッションが必要になる Web ファームを作成する場合には、セキュリティで保護されたセッションを無効化する必要があります。  
+  
+## 関連項目  
+ <xref:System.IdentityModel.Claims>  
+  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>  
+  
+ <xref:System.IdentityModel.Tokens.SamlSecurityToken>  
+  
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential>  
+  
+ <xref:System.ServiceModel.Security.IssuedTokenServiceCredential>  
+  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters>  
+  
+ <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenProvider>  
+  
+ <xref:System.ServiceModel.WSFederationHttpBinding>  
+  
+## 参照  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)   
+ [カスタム トークン](../../../../docs/framework/wcf/extending/custom-tokens.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/federation-and-trust.md b/docs/framework/wcf/feature-details/federation-and-trust.md
new file mode 100644
index 00000000000..88e36743b4c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/federation-and-trust.md
@@ -0,0 +1,51 @@
+---
+title: "フェデレーションと信頼 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション [WCF], 信頼"
+ms.assetid: 4bdec4f2-f8a2-4512-bdcf-14ef54b5877a
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# フェデレーションと信頼
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] におけるフェデレーション アプリケーション、信頼の境界と構成、および発行済みトークンの使用に関連したさまざまな側面について説明します。  
+  
+## サービス、セキュリティ トークン サービス、および信頼  
+ フェデレーション エンドポイントを公開するサービスを使用する場合、通常、特定の発行者によって提供されたトークンを使用してクライアント認証を行う必要があります。そのため、発行者の正しい資格情報を使用してサービスが構成されていることが重要です。そうでないと、サービスは発行済みトークンの署名を検証することができず、クライアントはサービスと通信できません。サービスで発行者の資格情報を構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  
+  
+ 同様に、対称キーを使用する場合も、キーがターゲット サービス用に暗号化されるため、セキュリティ トークン サービスがターゲット サービスの正しい資格情報で構成される必要があります。そうでないと、セキュリティ トークン サービスはターゲット サービス用にキーを暗号化できないため、この場合も、クライアントはサービスと通信できなくなります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、[SecurityBindingElement](../../../../docs/framework/wcf/diagnostics/wmi/securitybindingelement.md) にある <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.MaxClockSkew%2A> プロパティの値を使用してクライアントとサービスとの間の時刻のずれを許可します。フェデレーションでは、`MaxClockSkew` 設定が、クライアントと、クライアントが発行済みトークンを取得したセキュリティ トークン サービスの両方の時刻のずれに対して適用されます。そのため、発行済みトークンの有効期間の開始時刻と終了時刻が設定する際、セキュリティ トークン サービスで時刻のずれを許可する必要はありません。  
+  
+> [!NOTE]
+>  時刻のずれの重要性は、発行済みトークンの有効期間が短くなるほど大きくなります。トークンの有効期間が 30 分以上あれば、多くの場合、時刻のずれは大きな問題にはなりません。短い有効期間が使用されるシナリオやトークンの正確な有効時間が重要となるシナリオでは、時刻のずれを考慮に入れて設計する必要があります。  
+  
+## フェデレーション エンドポイントとタイムアウト  
+ クライアントがフェデレーション エンドポイントと通信するときは、最初にセキュリティ トークン サービスから適切なトークンを取得する必要があります。このセキュリティ トークン サービスがフェデレーション エンドポイントを公開している場合、クライアントは最初にそのエンドポイントの発行者からトークンを取得する必要があります。それぞれのトークンの取得には時間がかかり、この時間が実際のメッセージを最終的なエンドポイントに送信するときの全体的なタイムアウトの影響を受けます。  
+  
+ たとえば、クライアント側チャネルのタイムアウトが 30 秒に設定されているとします。またメッセージを最終的なエンドポイントに送信する前に、トークンを取得するために 2 つのトークン発行者を呼び出す必要があり、それぞれのトークンの発行に 15 秒を要するとします。この場合、この試行は失敗し、<xref:System.TimeoutException> がスローされます。したがって、クライアント チャネルの <xref:System.ServiceModel.IContextChannel.OperationTimeout%2A> 値は、すべての発行済みトークンを取得するのにかかる時間を含めた、十分大きな値に設定する必要があります。<xref:System.ServiceModel.IContextChannel.OperationTimeout%2A> プロパティの値が指定されていない場合、<xref:System.ServiceModel.Channels.Binding.OpenTimeout%2A> プロパティ、または <xref:System.ServiceModel.Channels.Binding.SendTimeout%2A> プロパティ \(あるいはその両方\) を、すべての発行済みトークンを取得するのにかかる時間を含めた、十分大きな値に設定する必要があります。  
+  
+## トークンの有効期間と更新  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは、サービスへの最初の要求を行う際に発行済みトークンのチェックを行いません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、セキュリティ トークン サービスによって適切な有効期間を持つトークンが発行されることが信頼されています。トークンがクライアントによってキャッシュされて再使用される場合は、トークンの有効期間が、後続する要求によってチェックされ、クライアントは必要に応じてトークンを自動的に更新します。トークンのキャッシュ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)」を参照してください。  
+  
+ 発行済みトークンまたはセキュリティ コンテキスト トークンに対して、30 秒以下などの短い有効期間を指定すると、発行済みトークンを要求したり、セキュリティ コンテキスト トークンのネゴシエーションや更新を行ったりした場合に、ネゴシエーションのタイムアウトやその他の例外が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントによってスローされることがあります。  
+  
+## 発行済みトークンと InclusionMode  
+ クライアントからフェデレーション エンドポイントに送信されたメッセージで発行済みトークンがシリアル化されるかどうかは、<xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters> クラスの <xref:System.ServiceModel.Security.Tokens.SecurityTokenParameters.InclusionMode%2A> プロパティを設定することによって制御します。このプロパティは <xref:System.ServiceModel.Security.Tokens.SecurityTokenInclusionMode> 列挙値のいずれかに設定できますが、これはほとんどのフェデレーション シナリオでは役に立ちません。`SecurityTokenInclusionMode.Never` 値および `SecurityTokenInclusionMode.AlwaysToInitiator` 値を設定すると、クライアントによって、セキュリティ トークンサービスによって発行されたトークンへの参照が証明書利用者に送信されます。証明書利用者がこの発行済みトークンのコピーを持っていない限り、トークン参照が解決されないため、認証は失敗します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では `SecurityTokenInclusionMode.Once` を `SecurityTokenInclusionMode.AlwaysToRecipient` と等価のものとして扱います。  
+  
+## 参照  
+ <xref:System.ServiceModel.Security.Tokens.SecurityTokenInclusionMode>   
+ [方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/federation.md b/docs/framework/wcf/feature-details/federation.md
new file mode 100644
index 00000000000..543409d6730
--- /dev/null
+++ b/docs/framework/wcf/feature-details/federation.md
@@ -0,0 +1,297 @@
+---
+title: "フェデレーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション [WCF]"
+  - "WCF, フェデレーション"
+ms.assetid: 2f1e646f-8361-48d4-9d5d-1b961f31ede4
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# フェデレーション
+ここでは、フェデレーション セキュリティの概念について簡単に説明します。また、フェデレーション セキュリティ アーキテクチャを展開する際の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のサポートについても説明します。フェデレーションのサンプル アプリケーションについては、「[フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)」を参照してください。  
+  
+## フェデレーション セキュリティの定義  
+ フェデレーション セキュリティにより、クライアントがアクセスするサービスと、関連する認証および承認の手順を明確に分離できます。また、フェデレーション セキュリティを使用すると、異なる信頼レルムに属する複数のシステム、ネットワーク、および組織間のコラボレーションが可能になります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、フェデレーション セキュリティを使用する分散システムの構築と展開をサポートします。  
+  
+### フェデレーション セキュリティ アーキテクチャの要素  
+ 次の表に示すように、フェデレーション セキュリティ アーキテクチャには 3 つの主要な要素があります。  
+  
+|要素|説明|  
+|--------|--------|  
+|ドメイン\/レルム|セキュリティ管理または信頼の単位。ドメインには通常、1 つの組織が含まれます。|  
+|フェデレーション|信頼が確立されたドメインのコレクション。信頼のレベルはさまざまですが、通常は認証レベルが含まれ、ほとんどの場合に承認レベルが含まれます。典型的なフェデレーションには、一連のリソースへの共有アクセスを可能にする信頼を確立した多くの組織が含まれます。|  
+|STS \(セキュリティ トークン サービス\)|セキュリティ トークンを発行する Web サービス。つまり、信頼できる証拠に基づいて、サービスを信頼する任意の相手に対してアサーションを行います。これによりドメイン間における信頼の橋渡しの基礎が形成されます。|  
+  
+### サンプル シナリオ  
+ フェデレーション セキュリティの例を次の図に示します。  
+  
+ ![フェデレーション](../../../../docs/framework/wcf/feature-details/media/typicalfederatedsecurityscenario.gif "TypicalFederatedSecurityScenario")  
+  
+ このシナリオでは、A と B の 2 つの組織があります。組織 B には、組織 A の一部のユーザーにとって有用な Web リソース \(Web サービス\) があります。  
+  
+> [!NOTE]
+>  このセクションでは、*"リソース"*、*"サービス"*、および *"Web サービス"* を相互に置き換え可能な用語として使用します。  
+  
+ 通常、組織 B は、組織 A のユーザーに対して、サービスにアクセスする前になんらかの有効な形式の認証を行うことを要求します。さらに、組織 B では、当該の特定リソースにアクセスするためにユーザーが承認されることを要求する場合もあります。この問題に対処し、組織 A のユーザーが組織 B のリソースにアクセスできるようにする 1 つの方法として、次のような方法があります。  
+  
+-   組織 A のユーザーは、各自の資格情報 \(ユーザー名とパスワード\) を組織 B に登録します。  
+  
+-   組織 A のユーザーがリソースにアクセスするには、リソースにアクセスする前に自分の資格情報を組織 B に提示して認証を受けます。  
+  
+ この方法には、次の 3 つの重大な欠点があります。  
+  
+-   組織 B では、ローカル ユーザーの資格情報の管理に加えて、組織 A のユーザーの資格情報の管理も必要になります。  
+  
+-   組織 A のユーザーは、組織 A 内のリソースにアクセスするために通常使用する資格情報以外に、別の資格情報セットを保持する \(つまり、別のユーザー名とパスワードを覚えておく\) 必要があります。通常、これは、複数のサービス サイトで同じユーザー名とパスワードが使用される可能性を高めるため、脆弱なセキュリティ対策と言えます。  
+  
+-   組織 B にあるリソースの価値を認識する組織の数が増えても、アーキテクチャを拡張できません。  
+  
+ 上記の欠点に対処する別の方法として、フェデレーション セキュリティの使用があります。この方法では、組織 A と組織 B が信頼関係を確立し、セキュリティ トークン サービス \(STS: Security Token Service\) を使用して、確立された信頼を仲介できるようにします。  
+  
+ フェデレーション セキュリティ アーキテクチャでは、組織 A のユーザーが、組織 B の Web サービスにアクセスする場合に、組織 B の STS から発行された有効なセキュリティ トークンを提示する必要があることを認識しています。この STS が、特定のサービスへのアクセスを認証および承認します。  
+  
+ STS B に接続したユーザーは、STS に関連付けられたポリシーから別のレベルの間接指定を受け取ります。このユーザーは、STS B がセキュリティ トークンを発行する前に、STS A \(クライアントの信頼レルム\) の有効なセキュリティ トークンを提示しておく必要があります。これは、2 つの組織間で確立された信頼関係から生じた結果であり、組織 B には組織 A のユーザーの ID を管理する必要がないことを意味します。実際には、STS B の `issuerAddress` と `issuerMetadataAddress` は、通常 null になります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : ローカル発行者を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md).この場合、クライアントは STS A を見つけるためにローカル ポリシーを調べます。この構成は、*"ホーム レルム フェデレーション"* と呼ばれ、STS B は STS A に関する情報を管理する必要がないため、拡張性が高まります。  
+  
+ ユーザーは、組織 A の STS に接続し、組織 A 内の他のリソースにアクセスする際に通常使用する認証資格情報を提示して、セキュリティ トークンを取得します。これにより、ユーザーが複数の資格情報セットを保持する必要があるという問題や、複数のサービス サイトで同じ資格情報セットを使用するという問題が、ある程度解決されます。  
+  
+ STS A からセキュリティ トークンを取得したユーザーは、このトークンを STS B に提示します。組織 B はユーザーの要求の承認手順を進め、独自のセキュリティ トークン セットからユーザーにセキュリティ トークンを発行します。ユーザーは、このトークンを組織 B のリソースに提示し、サービスにアクセスします。  
+  
+## WCF におけるフェデレーション セキュリティのサポート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)を使用して、フェデレーション セキュリティ アーキテクチャの展開を設定不要でサポートします。  
+  
+ [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)は、安全で信頼性が高く相互運用可能なバインディングを提供します。このバインディングでは、要求\/応答形式の通信を実現するための基盤となるトランスポート機構として HTTP を使用する必要があり、エンコーディングのワイヤ形式としてテキストと XML を使用します。  
+  
+ フェデレーション セキュリティ シナリオで [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)を使用する場合、次のセクションで説明するように、論理的に独立した 2 つのフェーズに分けることができます。  
+  
+### 第 1 フェーズ : 設計  
+ 設計フェーズでは、クライアントは [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してサービス エンドポイントが公開するポリシーを読み取り、サービスの認証と承認の要件を収集します。次のフェデレーション セキュリティの通信パターンをクライアントで作成するために、適切なプロキシが構築されます。  
+  
+-   クライアント信頼レルムにある STS からセキュリティ トークンを取得する。  
+  
+-   サービス信頼レルムにある STS にトークンを提示する。  
+  
+-   サービス信頼レルムにある STS からセキュリティ トークンを取得する。  
+  
+-   サービスにトークンを提示してサービスにアクセスする。  
+  
+### 第 2 フェーズ : 実行時  
+ 実行時フェーズでは、クライアントは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスのオブジェクトをインスタンス化し、この [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを使用して呼び出しを行います。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の基盤となるフレームワークにより、フェデレーション セキュリティの通信パターンにおける前述の手順が処理され、クライアントがシームレスにサービスを利用できるようにします。  
+  
+## WCF を使用した実装のサンプル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のネイティブ サポートを使用したフェデレーション セキュリティ アーキテクチャの実装サンプルを次の図に示します。  
+  
+ ![WCF のフェデレーション セキュリティ](../../../../docs/framework/wcf/feature-details/media/federatedsecurityinwcf.gif "FederatedSecurityInWCF")  
+  
+### MyService の例  
+ `MyService` サービスは、`MyServiceEndpoint` を介して単一のエンドポイントを公開します。このエンドポイントに関連付けられたアドレス、バインディング、およびコントラクトを次の図に示します。  
+  
+ ![フェデレーション](../../../../docs/framework/wcf/feature-details/media/myservice.gif "MyService")  
+  
+ サービス エンドポイント `MyServiceEndpoint` は、[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) を使用し、STS B によって発行された `accessAuthorized` クレームを含む有効な SAML \(Security Assertions Markup Language\) トークンを要求します。これは、サービス構成で宣言によって指定されます。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service type="FederationSample.MyService"      
+        behaviorConfiguration='MyServiceBehavior'>  
+        <endpoint address=""  
+            binding=" wsFederationHttpBinding"  
+            bindingConfiguration='MyServiceBinding'  
+            contract="Federation.IMyService" />  
+   </service>  
+  </services>  
+  
+  <bindings>  
+    <wsFederationHttpBinding>  
+    <!-- This is the binding used by MyService. It redirects   
+    clients to STS-B. -->  
+      <binding name='MyServiceBinding'>  
+        <security mode="Message">  
+           <message issuedTokenType=  
+"http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1">  
+           <issuer address="http://localhost/FederationSample/STS-B/STS.svc" />  
+            <issuerMetadata   
+           address=  
+"http://localhost/FederationSample/STS-B/STS.svc/mex" />  
+         <requiredClaimTypes>  
+            <add claimType="http://tempuri.org:accessAuthorized" />  
+         </requiredClaimTypes>  
+        </message>  
+      </security>  
+      </binding>  
+    </wsFederationHttpBinding>  
+  </bindings>  
+  
+  <behaviors>  
+    <behavior name='MyServiceBehavior'>  
+      <serviceAuthorization   
+operationRequirementType="FederationSample.MyServiceOperationRequirement, MyService" />  
+       <serviceCredentials>  
+         <serviceCertificate findValue="CN=FederationSample.com"  
+         x509FindType="FindBySubjectDistinguishedName"  
+         storeLocation='LocalMachine'  
+         storeName='My' />  
+      </serviceCredentials>  
+    </behavior>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+> [!NOTE]
+>  `MyService` が要求するクレームについては、細かい点に注意が必要です。2 番目の図は、`MyService` が `accessAuthorized` クレームを含む SAML トークンを要求していることを示しています。より正確には、これで、`MyService` が必要とするクレームの種類が指定されます。このクレームの種類の完全修飾名は http:\/\/tempuri.org:accessAuthorized \(関連する名前空間を含みます\) で、この名前がサービス構成ファイルで使用されます。このクレームの値は、このクレームが存在することが示しており、STS B によって `true` に設定されると想定されます。  
+  
+ このポリシーは、`MyService` の一部として実装されている `MyServiceOperationRequirement` クラスによって実行時に適用されます。  
+  
+ [!code-csharp[C_Federation#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#0)]
+ [!code-vb[C_Federation#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#0)]  
+[!code-csharp[C_Federation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#1)]
+[!code-vb[C_Federation#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#1)]  
+  
+#### STS B  
+ STS B を次の図に示します。前述のように、セキュリティ トークン サービス \(STS\) も Web サービスであり、エンドポイントやポリシーなどを関連付けることができます。  
+  
+ ![フェデレーション](../../../../docs/framework/wcf/feature-details/media/msservicestsb.gif "MsServiceSTSB")  
+  
+ STS B は、セキュリティ トークンを要求する際に使用できる `STSEndpoint` という単一のエンドポイントを公開します。具体的には、STS B は、`accessAuthorized` クレームを含む SAML トークンを発行します。このトークンは、サービスにアクセスするために `MyService` サービス サイトで提示できます。ただし、STS B は、STS A によって発行された `userAuthenticated` クレームを含む有効な SAML トークンを提示することをユーザーに要求します。これは、STS 構成で宣言によって指定されます。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service type="FederationSample.STS_B" behaviorConfiguration=  
+     "STS-B_Behavior">  
+    <endpoint address=""  
+              binding="wsFederationHttpBinding"  
+              bindingConfiguration='STS-B_Binding'  
+      contract="FederationSample.ISts" />  
+    </service>  
+  </services>  
+  <bindings>  
+    <wsFederationHttpBinding>  
+    <!-- This is the binding used by STS-B. It redirects clients to   
+         STS-A. -->  
+      <binding name='STS-B_Binding'>  
+        <security mode='Message'>  
+          <message issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1">  
+          <issuer address='http://localhost/FederationSample/STS-A/STS.svc' />  
+          <issuerMetadata address='http://localhost/FederationSample/STS-A/STS.svc/mex'/>  
+          <requiredClaimTypes>  
+            <add claimType='http://tempuri.org:userAuthenticated'/>  
+          </requiredClaimTypes>  
+          </message>  
+        </security>  
+    </binding>  
+   </wsFederationHttpBinding>  
+  </bindings>  
+  <behaviors>  
+  <behavior name='STS-B_Behavior'>  
+    <serviceAuthorization   operationRequirementType='FederationSample.STS_B_OperationRequirement, STS_B' />  
+    <serviceCredentials>  
+      <serviceCertificate findValue='CN=FederationSample.com'  
+      x509FindType='FindBySubjectDistinguishedName'  
+       storeLocation='LocalMachine'  
+       storeName='My' />  
+     </serviceCredentials>  
+   </behavior>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+> [!NOTE]
+>  この場合も、`userAuthenticated` クレームは、STS B が必要とするクレームの種類です。このクレームの種類の完全修飾名は http:\/\/tempuri.org:userAuthenticated \(関連する名前空間を含みます\) で、この名前が STS 構成ファイルで使用されます。このクレームの値は、このクレームが存在することを示しており、STS A によって `true` に設定されると想定されます。  
+  
+ STS B の一部として実装されているこのポリシーは、`STS_B_OperationRequirement` クラスによって実行時に適用されます。  
+  
+ [!code-csharp[C_Federation#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#2)]
+ [!code-vb[C_Federation#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#2)]  
+  
+ アクセス チェックで問題がなければ、STS B は、`accessAuthorized` クレームを含む SAML トークンを発行します。  
+  
+ [!code-csharp[C_Federation#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#3)]
+ [!code-vb[C_Federation#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#3)]  
+  
+#### STS A  
+ STS A を次の図に示します。  
+  
+ ![フェデレーション](../../../../docs/framework/wcf/feature-details/media/sts-b.gif "STS\_B")  
+  
+ STS B と同様に、STS A もセキュリティ トークンを発行する Web サービスであり、そのための単一のエンドポイントを公開します。ただし、STS A は別のバインディング \(`wsHttpBinding`\) を使用し、`emailAddress` クレームを含む有効な [!INCLUDE[infocard](../../../../includes/infocard-md.md)] を提示することをユーザーに要求します。応答で、STS A は `userAuthenticated` クレームを含む SAML トークンを発行します。これは、サービス構成で宣言によって指定されます。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service type="FederationSample.STS_A" behaviorConfiguration="STS-A_Behavior">  
+      <endpoint address=""  
+                binding="wsHttpBinding"  
+                bindingConfiguration="STS-A_Binding"  
+                contract="FederationSample.ISts">  
+       <identity>  
+       <certificateReference findValue="CN=FederationSample.com"    
+                       x509FindType="FindBySubjectDistinguishedName"  
+                       storeLocation="LocalMachine"   
+                       storeName="My" />  
+       </identity>  
+    <endpoint>  
+  </service>  
+</services>  
+  
+<bindings>  
+  <wsHttpBinding>  
+  <!-- This is the binding used by STS-A. It requires users to present  
+   a CardSpace. -->  
+    <binding name='STS-A_Binding'>  
+      <security mode='Message'>  
+        <message clientCredentialType="CardSpace" />  
+      </security>  
+    </binding>  
+  </wsHttpBinding>  
+</bindings>  
+  
+<behaviors>  
+  <behavior name='STS-A_Behavior'>  
+    <serviceAuthorization operationRequirementType=  
+     "FederationSample.STS_A_OperationRequirement, STS_A" />  
+      <serviceCredentials>  
+  <serviceCertificate findValue="CN=FederationSample.com"  
+                     x509FindType='FindBySubjectDistinguishedName'  
+                     storeLocation='LocalMachine'  
+                     storeName='My' />  
+      </serviceCredentials>  
+    </behavior>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+ STS A の一部として実装されているこのポリシーは、`STS_A_OperationRequirement` クラスによって実行時に適用されます。  
+  
+ [!code-csharp[C_Federation#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#4)]
+ [!code-vb[C_Federation#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#4)]  
+  
+ アクセスが `true` であれば、STS A は、`userAuthenticated` クレームを含む SAML トークンを発行します。  
+  
+ [!code-csharp[C_Federation#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federation/cs/source.cs#5)]
+ [!code-vb[C_Federation#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federation/vb/source.vb#5)]  
+  
+### 組織 A のクライアント  
+ `MyService` サービスの呼び出しに必要な手順と共に、組織 A のクライアントを次の図に示します。全体の処理を示すために、他の機能コンポーネントも示します。  
+  
+ ![フェデレーション](../../../../docs/framework/wcf/feature-details/media/federationclienta.gif "FederationClientA")  
+  
+## 概要  
+ フェデレーション セキュリティを使用すると、役割を明確に分離できるため、安全で拡張性のあるサービス アーキテクチャを構築できます。分散アプリケーションの構築と展開を行うためのプラットフォームとして、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではフェデレーション セキュリティの実装をネイティブにサポートをしています。  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/filtering.md b/docs/framework/wcf/feature-details/filtering.md
new file mode 100644
index 00000000000..7198617a322
--- /dev/null
+++ b/docs/framework/wcf/feature-details/filtering.md
@@ -0,0 +1,94 @@
+---
+title: "フィルター処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4002946c-e34a-4356-8cfb-e25912a4be63
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# フィルター処理
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] フィルター処理システムは、宣言的なフィルターを使用してメッセージの照合処理と操作上の判断を行います。フィルターを使用してメッセージの一部を調べることで、そのメッセージで必要な操作を決定できます。たとえば、キュー プロセスでは、XPath 1.0 クエリを使用して既知のヘッダー優先度要素をチェックし、メッセージをキューの先頭に移動するべきかどうかを決定します。  
+  
+ フィルター処理システムは、特定の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージに対して、どのフィルターのセットが `true` であるかを効率よく判断できる一連のクラスから構成されます。  
+  
+ フィルター処理システムは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージングの中核となるコンポーネントであり、非常に高速に動作するように設計されています。フィルターの各実装は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージの特定の種類の照合に対して最適化されています。  
+  
+ フィルター処理システムは、スレッド セーフではありません。アプリケーションは、すべてのロック セマンティクスを処理する必要があります。ただし、\(スレッドに対する\) マルチ リーダー\/シングル ライターはサポートされています。  
+  
+## フィルター処理が適する場合  
+ フィルター処理は、メッセージを適切なアプリケーション コンポーネントにディスパッチする処理の一部であり、メッセージの受信後に行われます。フィルター処理システムの設計では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のいくつかのサブシステム \(メッセージング、ルーティング、セキュリティ、イベント処理、およびシステム管理など\) の要件に対処します。  
+  
+## フィルター  
+ フィルター エンジンには、フィルターとフィルター テーブルという 2 つの主要コンポーネントが含まれます。フィルターは、ユーザーが指定した論理条件に基づいてメッセージに関する論理判定を行います。フィルターは <xref:System.ServiceModel.Dispatcher.MessageFilter> クラスを実装します。  
+  
+ メッセージがフィルターの一致条件を満たしているかどうかを判定するには、<xref:System.ServiceModel.Dispatcher.MessageFilter.Match%2A> メソッドを使用します。これらのメソッドの中の 1 つは、メッセージのヘッダーをテストしますが、メッセージ本文は検査できません。他のメソッドは入力パラメーターとして*メッセージ バッファー*を取得し、メッセージ本文の検査が可能です。  
+  
+ 通常、フィルターは個別にテストされるのではなく、フィルター テーブルの一部としてテストされます。フィルター テーブルは、<xref:System.ServiceModel.Dispatcher.MessageFilterTable%601.CreateFilterTable%2A> メソッドによって作成されるジェネリック クラスです。  
+  
+ 数種類のフィルターがあり、それぞれが特定の種類のブール型の条件での照合処理に特化されています。フィルターを作成した後に、フィルターが使用する条件を変更することはできません。フィルターの条件を変更するには、新しいフィルターを作成し、既存のフィルターを削除します。  
+  
+### アクション フィルター  
+ <xref:System.ServiceModel.Dispatcher.ActionMessageFilter> には、アクション文字列の一覧が含まれます。フィルターの一覧にあるアクションのいずれかが、メッセージまたはメッセージ バッファーにある Action ヘッダーに一致した場合、`Match` メソッドは `true` を返します。この一覧が空である場合、フィルターはすべてに一致するフィルターと見なされるため、メッセージまたはメッセージ バッファーはすべて一致することになり、`Match` メソッドは `true` を返します。フィルターの一覧にあるすべてのアクションが、メッセージまたはメッセージ バッファーにある Action ヘッダーに一致しない場合、`Match` メソッドは `false` を返します。メッセージにアクションがなく、フィルターの一覧が空でない場合、`Match` メソッドは `false` を返します。  
+  
+### エンドポイント アドレス フィルター  
+ <xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter> は、メッセージのヘッダー コレクションに示されるエンドポイント アドレスに基づいて、メッセージおよびメッセージ バッファーのフィルター処理を行います。メッセージがこのようなフィルターを通過するには、次の条件を満たす必要があります。  
+  
+-   フィルターのアドレス URI \(Uniform Resource Identifier\) がメッセージの To ヘッダーのアドレスと同じであること。  
+  
+-   フィルターのアドレス \(`address.Headers` コレクション\) にある各エンドポイント パラメーターが、マッピング対象のヘッダーをメッセージ内で見つけることができること。メッセージまたはメッセージ バッファーの追加のヘッダーは、一致を `true` の状態にしておくためであれば、許容されます。  
+  
+### プレフィックス エンドポイント アドレス フィルター  
+  
+1.  <xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter> は、メッセージ URI のプレフィックスとも一致できるという点を除けば、<xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter> フィルターと同じように動作します。たとえば、アドレス http:\/\/www.adatum.com を指定したフィルターは、http:\/\/www.adatum.com\/userA 宛のメッセージと一致します。  
+  
+### XPath メッセージ フィルター  
+ <xref:System.ServiceModel.Dispatcher.XPathMessageFilter> は、XPath 式を使用して、XML ドキュメントに特定の要素、属性、テキスト、その他の XML 構文が含まれているかどうかを判定します。このフィルターは、XPath の厳密なサブセットに対して非常に効率的に処理できるように最適化されています。XML Path 言語の詳細については、[W3C XML Path Language 1.0 の仕様](http://go.microsoft.com/fwlink/?LinkId=94779)を参照してください。  
+  
+ アプリケーションは通常、エンドポイントで <xref:System.ServiceModel.Dispatcher.XPathMessageFilter> を使用して SOAP メッセージの内容を問い合わせ、その結果に基づいて適切なアクションを実行します。たとえば、キューの処理では、XPath クエリを使用して既知のヘッダーの優先度要素を検査し、メッセージをキューの先頭に移動するべきかどうかを決定します。  
+  
+## フィルター テーブル  
+ フィルター テーブルは、キーと値のペアを保存するために使用されます。ここで、フィルターがキーであり、これに関連するデータが値になります。このフィルター データは、メッセージがフィルターに一致した場合に起きるアクションを示すために使用することができ、その型はフィルター テーブル クラスのジェネリック パラメーターになります。フィルター データは、ルーティングのルール、セッション セキュリティの状態、チャネル上のリスナーなどで構成できます。データは、データ フロー制御が必要な場所で使用できます。  
+  
+ フィルター テーブルは、<xref:System.ServiceModel.Dispatcher.IMessageFilterTable%601> ジェネリック インターフェイスを実装します。  
+  
+ フィルター テーブルには、テーブル内のすべてのフィルターに対してメッセージとの一致を調べて、一致したフィルターまたはデータの順序付けられていないコレクションを返すメソッドがいくつかあります。メソッドの中には複数回の一致を調べて、一致したすべての項目を返すものもあります。それ以外のメソッドは 1 回だけの一致となり、1 つの項目のみを返し、フィルターが複数回一致する場合には、<xref:System.ServiceModel.Dispatcher.MultipleFilterMatchesException> をスローします。  
+  
+### メッセージ フィルター テーブル  
+ <xref:System.ServiceModel.Dispatcher.MessageFilterTable%601> は、<xref:System.ServiceModel.Dispatcher.IMessageFilterTable%601> の最も一般的な実装です。このテーブルには、すべての種類のフィルターを格納できます。  
+  
+ フィルターには数字による優先順位を割り当てることができます。一番大きな数が最も高い優先順位となります。複数の種類のフィルターが、同じ優先度を持つことができます。また特定の種類のフィルターが、複数の優先順位レベルに現れることもできます。  
+  
+ 照合処理は優先順位が最も高いフィルターから開始され、ある優先順位で一致するフィルターが見つかると、それよりも優先順位の低いフィルターは検査されません。そのため、フィルターが 1 回だけ一致するメソッドを使用しているときに、あるメッセージに対してフィルターの一致が複数回発生した場合、一致フィルターの優先順位がそれぞれ異なっていれば、例外はスローされず、最も優先順位の高いフィルターが返されます。同様に、複数回フィルターが一致するメソッドでも、優先順位が最も高い一致フィルターのみが返されます。  
+  
+### XPath メッセージ フィルター テーブル  
+ <xref:System.ServiceModel.Dispatcher.XPathMessageFilterTable%601> は宣言的な XPath フィルターに最適化されているため、テーブル キーは <xref:System.ServiceModel.Dispatcher.XPathMessageFilter> になります。  
+  
+ <xref:System.ServiceModel.Dispatcher.XPathMessageFilterTable%601> クラスは、ほとんどのメッセージ シナリオをカバーし、XPath 1.0 の文法を完全にサポートする XPath のサブセットに合わせてマッチングを最適化します。また、効率的な並列マッチング用のアルゴリズムも最適化します。  
+  
+ このテーブルには、<xref:System.Xml.XPath.XPathNavigator> および <xref:System.ServiceModel.Dispatcher.SeekableXPathNavigator> 上で動作する特殊な `Match` メソッドがいくつかあります。<xref:System.ServiceModel.Dispatcher.SeekableXPathNavigator> は、<xref:System.ServiceModel.Dispatcher.SeekableXPathNavigator.CurrentPosition%2A> プロパティを追加することで、<xref:System.Xml.XPath.XPathNavigator> クラスを拡張します。このプロパティを使用すると、ナビゲーターを複製せずに XML ドキュメント内の位置を迅速に保存し、読み込むことができます。<xref:System.Xml.XPath.XPathNavigator> を使用してそうした操作を行うには、大量のメモリ領域を割り当てる必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] XPath エンジンでは、XML ドキュメントでクエリの実行中にカーソルの位置を頻繁に記録する必要があるため、<xref:System.ServiceModel.Dispatcher.SeekableXPathNavigator> により、メッセージ処理にとって重要な最適化が提供されます。  
+  
+## 顧客シナリオ  
+ フィルター処理は、メッセージに含まれるデータに応じて、異なる処理モジュールにメッセージを送信する必要がある場合に、いつでも使用できます。一般的なのは、アクション コードに基づいてメッセージをルーティングするシナリオと、メッセージのエンドポイント アドレスに基づいてメッセージのストリームを分離化するシナリオの 2 つです。  
+  
+### ルーティング  
+ エンドポイントのリスナーは、メッセージの SOAP ヘッダーに 1 つ以上のアクション コードが含まれるメッセージをリッスンします。これは、アクション コードを含む配列をコンストラクターに渡して <xref:System.ServiceModel.Dispatcher.ActionMessageFilter> を作成することで実装します。このフィルターは、`ListenerFactory` に登録するために使用されるため、アクションがフィルター内のアクション コードのいずれかと一致するメッセージだけが特定のエンドポイントに到達します。  
+  
+### 分離化  
+ 複数のエンドポイントがネットワーク上の同じ `ServiceListener` から分散している場合、メッセージを分離化し、メッセージが特定のエンドポイント アドレスに属しているかどうかを確認する唯一の方法は、<xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter> を使用することです。このフィルターは、ヘッダーに格納されている情報に対して検索を実行して、登録されているエンドポイントに向けられたメッセージを選択します。このようなフィルターを通過するのは、次の両方に対応する必要なヘッダーをすべて持っているメッセージだけです。  
+  
+-   `EndpointAddress` にある URI  
+  
+-   <xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter> で指定された `EndpointAddress` にある残りのエンドポイント パラメーター  
+  
+## 参照  
+ [データ転送とシリアル化](../../../../docs/framework/wcf/feature-details/data-transfer-and-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/finding-claims-in-a-claimset.md b/docs/framework/wcf/feature-details/finding-claims-in-a-claimset.md
new file mode 100644
index 00000000000..e68d409fab2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/finding-claims-in-a-claimset.md
@@ -0,0 +1,30 @@
+---
+title: "ClaimSet でのクレームの検索 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クレーム [WCF]"
+  - "クレーム [WCF], ClaimSet での検索"
+ms.assetid: a76ce107-aeb3-47d0-bfa9-134c53664e20
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ClaimSet でのクレームの検索
+クレームに基づく承認を使用する場合に、特定の種類のクレームの <xref:System.IdentityModel.Claims.ClaimSet> の内容を調べることは、一般的なタスクです。特定のクレームが存在するかどうか、<xref:System.IdentityModel.Claims.ClaimSet> を検査するには、<xref:System.IdentityModel.Claims.ClaimSet.FindClaims%2A> メソッドを使用します。このメソッドでは、<xref:System.IdentityModel.Claims.ClaimSet> を直接繰り返すよりも優れたパフォーマンスが得られます。次の例は、この使用方法を示しています。`claimType` パラメーターと `claimRight` パラメーターには `null` を指定できます。その場合、パラメーターはすべてのクレームの種類および権限と一致します。  
+  
+## 例  
+ [!code-csharp[c_FindClaimsPerf#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_findclaimsperf/cs/c_findclaimsperf.cs#2)]
+ [!code-vb[c_FindClaimsPerf#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_findclaimsperf/vb/c_findclaimsperf.vb#2)]  
+  
+## 参照  
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/flowing-transactions-into-and-out-of-workflow-services.md b/docs/framework/wcf/feature-details/flowing-transactions-into-and-out-of-workflow-services.md
new file mode 100644
index 00000000000..473541eff2a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/flowing-transactions-into-and-out-of-workflow-services.md
@@ -0,0 +1,329 @@
+---
+title: "ワークフロー サービスへのトランザクションのフロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03ced70e-b540-4dd9-86c8-87f7bd61f609
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ワークフロー サービスへのトランザクションのフロー
+ワークフロー サービスとワークフロー クライアントはトランザクションに参加できます。サービス操作をアンビエント トランザクションの一部にするには、<xref:System.ServiceModel.Activities.Receive> アクティビティを <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティの中に配置します。<xref:System.ServiceModel.Activities.TransactedReceiveScope> 内の <xref:System.ServiceModel.Activities.Send> または <xref:System.ServiceModel.Activities.SendReply> アクティビティによる呼び出しが行われると、アンビエント トランザクション内でも呼び出しが行われます。ワークフロー クライアント アプリケーションでは、<xref:System.Activities.Statements.TransactionScope> アクティビティを使用してアンビエント トランザクションを作成し、そのアンビエント トランザクションを使用してサービス操作を呼び出すことができます。ここでは、トランザクションに参加するワークフロー サービスとワークフロー クライアントを作成する手順について説明します。  
+  
+> [!WARNING]
+>  ワークフロー サービス インスタンスがトランザクション内に読み込まれて、ワークフローに <xref:System.Activities.Statements.Persist> アクティビティが含まれている場合、ワークフロー インスタンスはトランザクションがタイムアウトするまでハングします。  
+  
+> [!IMPORTANT]
+>  <xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用する場合は、<xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティ内のワークフローにすべての受信を配置することをお勧めします。  
+  
+> [!IMPORTANT]
+>  <xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用して、メッセージが不適切な順序で到着する場合、最初の順序を無視したメッセージを配信しようとするとワークフローは中止されます。ワークフローがアイドル状態である場合、ワークフローは常に一致する停止ポイントにあるようにする必要があります。これによって、ワークフローが中止された場合、前の永続性ポイントからワークフローを再開することができます。  
+  
+### 共有ライブラリの作成  
+  
+1.  新しい空の Visual Studio ソリューションを作成します。  
+  
+2.  `Common` という新しいクラス ライブラリ プロジェクトを追加します。次のアセンブリへの参照を追加します。  
+  
+    -   System.Activities.dll  
+  
+    -   System.ServiceModel.dll  
+  
+    -   System.ServiceModel.Activities.dll  
+  
+    -   System.Transactions.dll  
+  
+3.  `PrintTransactionInfo` という新しいクラスを `Common` プロジェクトに追加します。このクラスは <xref:System.Activities.NativeActivity> の派生クラスで、<xref:System.Activities.NativeActivity.Execute%2A> メソッドをオーバーロードします。  
+  
+    ```  
+    using System;  
+    using System;  
+    using System.Activities;  
+    using System.Transactions;  
+  
+    namespace Common  
+    {  
+        public class PrintTransactionInfo : NativeActivity  
+        {  
+            protected override void Execute(NativeActivityContext context)  
+            {  
+                RuntimeTransactionHandle rth = context.Properties.Find(typeof(RuntimeTransactionHandle).FullName) as RuntimeTransactionHandle;  
+  
+                if (rth == null)  
+                {  
+                    Console.WriteLine("There is no ambient RuntimeTransactionHandle");  
+                }  
+  
+                Transaction t = rth.GetCurrentTransaction(context);  
+  
+                if (t == null)  
+                {  
+                    Console.WriteLine("There is no ambient transaction");  
+                }  
+                else  
+                {  
+                    Console.WriteLine("Transaction: {0} is {1}", t.TransactionInformation.DistributedIdentifier, t.TransactionInformation.Status);  
+                }  
+            }  
+        }  
+  
+    }  
+  
+    ```  
+  
+     これは、アンビエント トランザクションに関する情報を表示するネイティブ アクティビティで、ここで使用するサービス ワークフローとクライアント ワークフローの両方で使用されます。ソリューションをビルドして、このアクティビティを **\[ツールボックス\]** の **\[Common\]** セクションで使用できるようにします。  
+  
+### ワークフロー サービスの実装  
+  
+1.  `WorkflowService` という新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ワークフロー サービスを `Common` プロジェクトに追加します。そのためには、`Common` プロジェクトを右クリックし、**\[追加\]**、**\[新しい項目\]** の順にクリックします。次に、**\[インストールされているテンプレート\]** で **\[ワークフロー\]** をクリックし、**\[WCF ワークフロー サービス\]** をクリックします。  
+  
+     ![ワークフロー サービスの追加](../../../../docs/framework/wcf/feature-details/media/addwfservice.JPG "AddWFService")  
+  
+2.  既定の `ReceiveRequest` アクティビティと `SendResponse` アクティビティを削除します。  
+  
+3.  <xref:System.Activities.Statements.WriteLine> アクティビティを `Sequential Service` アクティビティにドラッグ アンド ドロップします。次の例に示すように、Text プロパティを `"Workflow Service starting ..."` に設定します。  
+  
+     ![WriteLine アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/addwriteline.JPG "AddWriteLine")  
+  
+4.  <xref:System.ServiceModel.Activities.TransactedReceiveScope> を <xref:System.Activities.Statements.WriteLine> アクティビティの後にドラッグ アンド ドロップします。<xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティは、**\[ツールボックス\]** の **\[メッセージング\]** セクションにあり、**Request** と **Body** の 2 つのセクションで構成されています。**Request** セクションには、<xref:System.ServiceModel.Activities.Receive> アクティビティが含まれます。**Body** セクションには、メッセージの受信後にトランザクション内で実行されるアクティビティが含まれます。  
+  
+     ![TransactedReceiveScope アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/trs.JPG "TRS")  
+  
+5.  <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティを選択し、**\[変数\]** をクリックします。次の変数を追加します。  
+  
+     ![TransactedReceiveScope への変数の追加](../../../../docs/framework/wcf/feature-details/media/trsvariables.JPG "TRSVariables")  
+  
+    > [!NOTE]
+    >  既定で含まれているデータ変数は削除してかまいません。既存のハンドル変数を使用することもできます。  
+  
+6.  <xref:System.ServiceModel.Activities.Receive> アクティビティを <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティの **Request** セクションにドラッグ アンド ドロップします。次のプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |CanCreateInstance|True \(チェック ボックスをオンにする\)|  
+    |OperationName|StartSample|  
+    |ServiceContractName|ITransactionSample|  
+  
+     ワークフローは次のようになります。  
+  
+     ![Receive アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/serviceaddreceive.JPG "ServiceAddReceive")  
+  
+7.  <xref:System.ServiceModel.Activities.Receive> アクティビティの **\[定義...\]** リンクをクリックし、次の設定を行います。  
+  
+     ![Recieve アクティビティのメッセージ設定](../../../../docs/framework/wcf/feature-details/media/receivemessagesettings.JPG "ReceiveMessageSettings")  
+  
+8.  <xref:System.Activities.Statements.Sequence> アクティビティを <xref:System.ServiceModel.Activities.TransactedReceiveScope> の Body セクションにドラッグ アンド ドロップします。<xref:System.Activities.Statements.Sequence> アクティビティに 2 つの <xref:System.Activities.Statements.WriteLine> アクティビティをドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを次の表のとおりに設定します。  
+  
+    |アクティビティ|値|  
+    |-------------|-------|  
+    |1 つ目の WriteLine|“Service: Receive Completed”|  
+    |2 つ目の WriteLine|"Service: Received \= " \+ requestMessage|  
+  
+     ワークフローは次のようになります。  
+  
+     ![WriteLine アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/afteraddingwritelines.JPG "AfterAddingWriteLines")  
+  
+9. `PrintTransactionInfo` アクティビティを、<xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティの **Body** の 2 つ目の <xref:System.Activities.Statements.WriteLine> アクティビティの後にドラッグ アンド ドロップします。  
+  
+     ![PrintTransactionInfo の追加後](../../../../docs/framework/wcf/feature-details/media/afteraddingprinttransactioninfo.JPG "AfterAddingPrintTransactionInfo")  
+  
+10. <xref:System.Activities.Statements.Assign> アクティビティを `PrintTransactionInfo` アクティビティの後にドラッグ アンド ドロップし、次の表のとおりにプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |To|replyMessage|  
+    |Value|"Service: Sending reply."|  
+  
+11. <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.Activities.Statements.Assign> アクティビティの後にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Service: Begin reply" に設定します。  
+  
+     ワークフローは次のようになります。  
+  
+     ![Assign および WriteLine の追加後](../../../../docs/framework/wcf/feature-details/media/afteraddingsbrwriteline.JPG "AfterAddingSBRWriteLine")  
+  
+12. <xref:System.ServiceModel.Activities.Receive> アクティビティを右クリックして **\[SendReply の作成\]** をクリックし、最後の <xref:System.Activities.Statements.WriteLine> アクティビティの後に貼り付けます。`SendReplyToReceive` アクティビティの **\[定義...\]** リンクをクリックし、次の設定を行います。  
+  
+     ![応答メッセージの設定](../../../../docs/framework/wcf/feature-details/media/replymessagesettings.JPG "ReplyMessageSettings")  
+  
+13. <xref:System.Activities.Statements.WriteLine> アクティビティを `SendReplyToReceive` アクティビティの後にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Service: Reply sent" に設定します。  
+  
+14. <xref:System.Activities.Statements.WriteLine> アクティビティをワークフローの末尾にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Service: Workflow ends, press ENTER to exit" に設定します。  
+  
+     完成したサービス ワークフローは次のようになります。  
+  
+     ![完全なサービス ワークフロー](../../../../docs/framework/wcf/feature-details/media/servicecomplete.jpg "ServiceComplete")  
+  
+### ワークフロー クライアントの実装  
+  
+1.  `WorkflowClient` という新しい WCF ワークフロー アプリケーションを `Common` プロジェクトに追加します。そのためには、`Common` プロジェクトを右クリックし、**\[追加\]**、**\[新しい項目\]** の順にクリックします。次に、**\[インストールされているテンプレート\]** で **\[ワークフロー\]** をクリックし、**\[アクティビティ\]** をクリックします。  
+  
+     ![アクティビティ プロジェクトの追加](../../../../docs/framework/wcf/feature-details/media/addactivity.JPG "AddActivity")  
+  
+2.  <xref:System.Activities.Statements.Sequence> アクティビティをデザイン画面にドラッグ アンド ドロップします。  
+  
+3.  <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.Activities.Statements.Sequence> アクティビティにドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを `"Client: Workflow starting"` に設定します。ワークフローは次のようになります。  
+  
+     ![WriteLine アクティビティを追加する](../../../../docs/framework/wcf/feature-details/media/clientaddwriteline.JPG "ClientAddWriteLine")  
+  
+4.  <xref:System.Activities.Statements.TransactionScope> アクティビティを <xref:System.Activities.Statements.WriteLine> アクティビティの後にドラッグ アンド ドロップします。<xref:System.Activities.Statements.TransactionScope> アクティビティを選択し、\[変数\] をクリックして次の変数を追加します。  
+  
+     ![TransactionScope への変数の追加](../../../../docs/framework/wcf/feature-details/media/tsvariables.JPG "TSVariables")  
+  
+5.  <xref:System.Activities.Statements.Sequence> アクティビティを <xref:System.Activities.Statements.TransactionScope> アクティビティの Body セクションにドラッグ アンド ドロップします。  
+  
+6.  `PrintTransactionInfo` アクティビティを <xref:System.Activities.Statements.Sequence> アクティビティにドラッグ アンド ドロップします。  
+  
+7.  <xref:System.Activities.Statements.WriteLine> アクティビティを `PrintTransactionInfo` アクティビティの後にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Client: Beginning Send" に設定します。ワークフローは次のようになります。  
+  
+     ![アクティビティの追加](../../../../docs/framework/wcf/feature-details/media/clientaddcbswriteline.JPG "ClientAddCBSWriteLine")  
+  
+8.  <xref:System.ServiceModel.Activities.Send> アクティビティを <xref:System.Activities.Statements.Assign> アクティビティの後にドラッグ アンド ドロップし、次のプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |EndpointConfigurationName|workflowServiceEndpoint|  
+    |OperationName|StartSample|  
+    |ServiceContractName|ITransactionSample|  
+  
+     ワークフローは次のようになります。  
+  
+     ![Send アクティビティのプロパティの設定](../../../../docs/framework/wcf/feature-details/media/clientsendsettings.JPG "ClientSendSettings")  
+  
+9. **\[定義...\]** リンクをクリックし、次の設定を行います。  
+  
+     ![Send アクティビティのメッセージの設定](../../../../docs/framework/wcf/feature-details/media/sendmessagesettings.JPG "SendMessageSettings")  
+  
+10. <xref:System.ServiceModel.Activities.Send> アクティビティを右クリックし、**\[ReceiveReply の作成\]** をクリックします。<xref:System.ServiceModel.Activities.ReceiveReply> アクティビティが <xref:System.ServiceModel.Activities.Send> アクティビティの後に自動的に配置されます。  
+  
+11. ReceiveReplyForSend アクティビティの \[定義\] リンクをクリックし、次の設定を行います。  
+  
+     ![ReceiveForSend メッセージの設定](../../../../docs/framework/wcf/feature-details/media/clientreplymessagesettings.JPG "ClientReplyMessageSettings")  
+  
+12. <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティの間にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Client: Send complete" に設定します。  
+  
+13. <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティの後にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Client side: Reply received \= " \+ replyMessage に設定します。  
+  
+14. `PrintTransactionInfo` アクティビティを <xref:System.Activities.Statements.WriteLine> アクティビティの後にドラッグ アンド ドロップします。  
+  
+15. <xref:System.Activities.Statements.WriteLine> アクティビティをワークフローの末尾にドラッグ アンド ドロップし、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Client workflow ends" に設定します。完成したクライアント ワークフローは次の図のようになります。  
+  
+     ![完成したクライアント ワークフロー](../../../../docs/framework/wcf/feature-details/media/clientcompleteworkflow.jpg "ClientCompleteWorkflow")  
+  
+16. ソリューションをビルドします。  
+  
+### サービス アプリケーションの作成  
+  
+1.  `Service` という新しいコンソール アプリケーション プロジェクトをソリューションに追加します。次のアセンブリへの参照を追加します。  
+  
+    1.  System.Activities.dll  
+  
+    2.  System.ServiceModel.dll  
+  
+    3.  System.ServiceModel.Activities.dll  
+  
+2.  生成された Program.cs ファイルを開き、次のコードを追加します。  
+  
+    ```  
+    static void Main()  
+          {  
+              Console.WriteLine("Building the server.");  
+              using (WorkflowServiceHost host = new WorkflowServiceHost(new DeclarativeServiceWorkflow(), new Uri("net.tcp://localhost:8000/TransactedReceiveService/Declarative")))  
+              {                
+                  //Start the server  
+                  host.Open();  
+                  Console.WriteLine("Service started.");  
+  
+                  Console.WriteLine();  
+                  Console.ReadLine();  
+                  //Shutdown  
+                  host.Close();  
+              };         
+          }  
+  
+    ```  
+  
+3.  次の app.config ファイルをプロジェクトに追加します。  
+  
+    ```xml  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <!-- Copyright © Microsoft Corporation.  All rights reserved. -->  
+    <configuration>  
+        <system.serviceModel>  
+            <bindings>  
+                <netTcpBinding>  
+                    <binding transactionFlow="true" />  
+                </netTcpBinding>  
+            </bindings>  
+        </system.serviceModel>  
+    </configuration>  
+  
+    ```  
+  
+### クライアント アプリケーションの作成  
+  
+1.  `Client` という新しいコンソール アプリケーション プロジェクトをソリューションに追加します。System.Activities.dll への参照を追加します。  
+  
+2.  program.cs ファイルを開き、次のコードを追加します。  
+  
+    ```  
+    class Program  
+        {  
+  
+            private static AutoResetEvent syncEvent = new AutoResetEvent(false);  
+  
+            static void Main(string[] args)  
+            {  
+                //Build client  
+                Console.WriteLine("Building the client.");  
+                WorkflowApplication client = new WorkflowApplication(new DeclarativeClientWorkflow());  
+                client.Completed = Program.Completed;  
+                client.Aborted = Program.Aborted;  
+                client.OnUnhandledException = Program.OnUnhandledException;  
+  
+                //Wait for service to start  
+                Console.WriteLine("Press ENTER once service is started.");  
+                Console.ReadLine();  
+  
+                //Start the client              
+                Console.WriteLine("Starting the client.");  
+                client.Run();  
+                syncEvent.WaitOne();  
+  
+                //Sample complete  
+                Console.WriteLine();  
+                Console.WriteLine("Client complete. Press ENTER to exit.");  
+                Console.ReadLine();  
+            }  
+  
+            private static void Completed(WorkflowApplicationCompletedEventArgs e)  
+            {  
+                Program.syncEvent.Set();  
+            }  
+  
+            private static void Aborted(WorkflowApplicationAbortedEventArgs e)  
+            {  
+                Console.WriteLine("Client Aborted: {0}", e.Reason);  
+                Program.syncEvent.Set();  
+            }  
+  
+            private static UnhandledExceptionAction OnUnhandledException(WorkflowApplicationUnhandledExceptionEventArgs e)  
+            {  
+                Console.WriteLine("Client had an unhandled exception: {0}", e.UnhandledException);  
+                return UnhandledExceptionAction.Cancel;  
+            }  
+        }  
+  
+    ```  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [Windows Communication Foundation のトランザクションの概要](../../../../docs/framework/wcf/feature-details/transactions-overview.md)   
+ [TransactedReceiveScope の使用](../../../../docs/framework/windows-workflow-foundation/samples/use-of-transactedreceivescope.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/forward-compatible-data-contracts.md b/docs/framework/wcf/feature-details/forward-compatible-data-contracts.md
new file mode 100644
index 00000000000..b195ac5907f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/forward-compatible-data-contracts.md
@@ -0,0 +1,55 @@
+---
+title: "上位互換性のあるデータ コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], 上位互換性"
+ms.assetid: 413c9044-26f8-4ecb-968c-18495ea52cd9
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 上位互換性のあるデータ コントラクト
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のデータ コントラクト システムの特徴の 1 つは、コントラクトが互換性に影響のない形で時間の経過に応じて変化できる点にあります。つまり、古いバージョンのデータ コントラクトを使用するクライアントが同じデータ コントラクトの新しいバージョンのサービスと通信すること、または新しいバージョンのデータ コントラクトを使用するクライアントが同じデータ コントラクトの古いバージョンと通信することが可能です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ベスト プラクティス : データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md).  
+  
+ バージョン管理機能の大半は、既存のデータ コントラクトの新しいバージョンが作成されたときに、必要に応じて適用できます。ただし、*"ラウンド トリップ"* というバージョン管理機能は、正しく動作するように最初のバージョンから型に組み込んでおく必要があります。  
+  
+## ラウンド トリップ  
+ ラウンド トリップは、データ コントラクトの新しいバージョンから古いバージョンにデータが渡され、新しいバージョンに戻されるときに発生します。ラウンド トリップでは、データの損失がないことが保証されます。ラウンド トリップを有効にすると、データ コントラクト バージョン管理モデルによってサポートされる将来の変更に関して、型の上位互換性が保たれます。  
+  
+ 特定の型のラウンド トリップを有効にするには、この型に <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装する必要があります。このインターフェイスには、\(<xref:System.Runtime.Serialization.ExtensionDataObject> 型を返す\) <xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティが含まれます。このプロパティにより、現在のバージョンでは未知の、今後使用されるデータ コントラクトの任意のデータが格納されます。  
+  
+### 例  
+ 次のデータ コントラクトは、将来の変更に対して上位互換性がありません。  
+  
+ [!code-csharp[C_DataContract#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#7)]
+ [!code-vb[C_DataContract#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#7)]  
+  
+ 将来の変更 \(たとえば、"phoneNumber" という名前の新しいデータ メンバーを追加する\) に対して互換性を確保するには、<xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを次のように実装します。  
+  
+ [!code-csharp[C_DataContract#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#8)]
+ [!code-vb[C_DataContract#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#8)]  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャが、元のデータ コントラクトに含まれないデータを検出すると、このデータはプロパティに格納されて維持されます。データは一時的に格納されるだけで、処理されることはありません。オブジェクトを発生元に返すと、元の \(未知の\) データも返されます。したがって、データが失われることなく、元のエンドポイントとの間でラウンド トリップ \(往復\) が行われます。ただし、発生元のエンドポイントでデータを処理する必要がある場合、この要求は満たされないため、このエンドポイントでは何らかの方法で変更を検出して対応する必要があることに注意してください。  
+  
+ <xref:System.Runtime.Serialization.ExtensionDataObject> 型にはパブリックなメソッドやプロパティはありません。そのため、<xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティ内に格納されているデータに直接アクセスすることはできません。  
+  
+ ラウンド トリップ機能は、<xref:System.Runtime.Serialization.DataContractSerializer> コンストラクターで `ignoreExtensionDataObject` を `true` に設定する、または <xref:System.ServiceModel.ServiceBehaviorAttribute> で <xref:System.ServiceModel.ServiceBehaviorAttribute.IgnoreExtensionDataObject%2A> プロパティを `true` に設定することで無効にできます。この機能を無効にすると、デシリアライザーが <xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティを設定しないため、シリアライザーはプロパティの内容を出力しません。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.IExtensibleDataObject>   
+ <xref:System.Runtime.Serialization.ExtensionDataObject>   
+ [データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md)   
+ [ベスト プラクティス : データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/generating-a-wcf-client-from-service-metadata.md b/docs/framework/wcf/feature-details/generating-a-wcf-client-from-service-metadata.md
new file mode 100644
index 00000000000..34b6c9e6b4b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/generating-a-wcf-client-from-service-metadata.md
@@ -0,0 +1,81 @@
+---
+title: "サービス メタデータからの WCF クライアントの生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27f8f545-cc44-412a-b104-617e0781b803
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス メタデータからの WCF クライアントの生成
+ここでは、Svcutil.exe の各種のスイッチを使用して、メタデータ ドキュメントからクライアントを生成する方法を説明します。  
+  
+ メタデータ ドキュメントは、永続ストレージに保存したり、オンラインで取得したりできます。オンライン取得では、WS\-MetadataExchange プロトコルまたは DISCO \(Microsoft Discovery\) プロトコルに従います。Svcutil.exe は、メタデータを取得するために次のメタデータ要求を同時に発行します。  
+  
+-   指定されたアドレスへの WS\-MetadataExchange \(MEX\) 要求  
+  
+-   指定された `/mex` 付きアドレスへの MEX 要求  
+  
+-   指定されたアドレスへの DISCO 要求 \(ASP.NET Web サービス の [DiscoveryClientProtocol クラス](http://go.microsoft.com/fwlink/?LinkId=94777) を使用\)  
+  
+ Svcutil.exe は、Web サービス記述言語 \(WSDL: Web Services Description Language\) ファイル、またはサービスから受け取ったポリシー ファイルに基づいてクライアントを生成します。ユーザー プリンシパル名 \(UPN\) は、ユーザー名、"@"、完全修飾ドメイン名 \(FQDN\) を順に連結して生成されます。ただし、Active Directory に登録されているユーザーの場合、この形式は無効であり、ツールが生成する UPN を使用すると、Kerberos 認証でエラーが発生し、エラー メッセージ **\[ログインに失敗しました\]** が表示されます。この問題を解決するには、このツールが生成するクライアント ファイルを手動で修正する必要があります。  
+  
+```  
+svcutil.exe [/t:code]  <metadataDocumentPath>* | <url>* | <epr>  
+```  
+  
+## 型の参照と共有  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/reference:\<file path\>**|指定されたアセンブリの型を参照します。クライアントの生成時に、このオプションを使用して、インポートするメタデータを表す型を含むアセンブリを指定します。<br /><br /> 短縮形: `/r`|  
+|**\/excludeType:\<type\>**|参照されるコントラクト型から除外する完全修飾またはアセンブリ修飾の型名を指定します。<br /><br /> 短縮形: `/et`|  
+  
+## シリアライザーの選択  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/serializer:Auto**|シリアライザーを自動的に選択します。これは、`DataContract` シリアライザーを使用します。この処理が失敗すると、`XmlSerializer` が使用されます。<br /><br /> 短縮形: `/ser:Auto`|  
+|**\/serializer:DataContractSerializer**|シリアル化と逆シリアル化に `DataContract` シリアライザーを使用するデータ型を生成します。<br /><br /> 短縮形: `/ser:DataContractSerializer`|  
+|**\/serializer:XmlSerializer**|シリアル化と逆シリアル化に `XmlSerializer` を使用するデータ型を生成します。<br /><br /> 短縮形: `/ser:XmlSerializer`|  
+|**\/importXmlTypes**|`IXmlSerializable` 型として非 `DataContract` 型をインポートする `DataContract` シリアライザーを構成します。<br /><br /> 短縮形: `/ixt`|  
+|**\/dataContractOnly**|`DataContract` 型に対してのみコードを生成します。`ServiceContract` 型が生成されます。<br /><br /> このオプションにはローカル メタデータ ファイルだけを指定する必要があります。<br /><br /> 短縮形: `/dconly`|  
+  
+## クライアントの言語の選択  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/language:\<language\>**|コード生成に使用するプログラミング言語を指定します。Machine.config ファイルに登録された言語名か、<xref:System.CodeDom.Compiler.CodeDomProvider> から継承するクラスの完全修飾名のいずれかを指定します。<br /><br /> 値は、c\#、cs、csharp、vb、vbs、visualbasic、vbscript、javascript、c\+\+、mc、cpp になります。<br /><br /> 既定値 : csharp<br /><br /> 短縮形 : `/l`<br /><br /> [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[CodeDomProvider クラス](http://go.microsoft.com/fwlink/?LinkId=94778)」を参照してください。|  
+  
+## クライアントの名前空間の選択  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/namespace:\<string,string\>**|WSDL または XML スキーマの `targetNamespace` から共通言語ランタイム \(CLR: Common Language Runtime\) 名前空間へのマッピングを指定します。`targetNamespace` にワイルドカード \(\*\) を使用すると、マッピングを明示的に指定せずにすべての `targetNamespaces` がその CLR 名前空間にマップされます。<br /><br /> メッセージ コントラクト名が操作名と競合しないようにするには、型参照を 2 つのコロン `::` で修飾するか、名前を一意にします。<br /><br /> 既定 : `DataContracts` のスキーマ ドキュメントのターゲット名前空間から派生します。既定の名前空間は、生成される他のすべての型に使用されます。<br /><br /> 短縮形: `/n`|  
+  
+## データ バインディングの選択  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/enableDataBinding**|データ バインディングを有効にするために、すべての `DataContract` 型に <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装します。<br /><br /> 短縮形: `/edb`|  
+  
+## 構成ファイルの生成  
+  
+|オプション|説明|  
+|-----------|--------|  
+|**\/config:\<configFile\>**|生成される構成ファイルの名前を指定します。<br /><br /> 既定値: output.config|  
+|**\/mergeConfig**|既存のファイルを上書きする代わりに、生成される構成ファイルを既存のファイルにマージします。|  
+|**\/noConfig**|構成ファイルを生成しません。|  
+  
+## 参照  
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)   
+ [メタデータ アーキテクチャの概要](../../../../docs/framework/wcf/feature-details/metadata-architecture-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md b/docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md
new file mode 100644
index 00000000000..349542f155f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md
@@ -0,0 +1,97 @@
+---
+title: "セッションでキューに置かれたメッセージのグループ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "キュー [WCF]。 メッセージをグループ化"
+ms.assetid: 63b23b36-261f-4c37-99a2-cc323cd72a1a
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# セッションでキューに置かれたメッセージのグループ化
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、単一の受信側アプリケーションで処理できるよう、一連の関連メッセージをグループ化するセッションが用意されています。 セッションに含まれるメッセージは、同じトランザクションに含まれる必要があります。 すべてのメッセージが同じトランザクションに含まれるため、1 つのメッセージの処理が失敗すると、セッション全体がロールバックされます。 各セッションは、配信不能キューや有害キューに関してよく似た動作をします。 キューに置かれたバインディングに設定される有効期間 (TTL: Time To Live) プロパティがセッションに構成されている場合は、セッション全体に適用されます。 したがって、TTL が切れる前にセッション内の一部のメッセージが送信された場合は、セッション全体が配信不能キューに配置されます。 同様に、アプリケーション キューからアプリケーションにセッション内のメッセージを送信できなかった場合は、セッション全体が有害キューに配置されます (有害キューを使用できる場合)。  
+  
+## <a name="message-grouping-example"></a>メッセージのグループ化の例  
+ メッセージのグループ化が役立つ&1; つの例は、注文処理アプリケーションを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとして実装する場合です。 たとえば、クライアントがこのアプリケーションに多数の項目を含む注文を送信するとします。 このクライアントは、項目ごとにサービスを呼び出すため、個別のメッセージが送信されることになります。 このため、最初の項目はサーバー A で受信され、2 番目の項目はサーバー B で受信される可能性があります。 項目が追加されるたびに、この項目を処理するサーバーは適切な注文を見つけて項目を追加する必要があるため、効率が非常に悪くなります。 すべての要求を&1; 台のサーバーのみで処理する場合でも、現在処理中のすべての注文をこのサーバーによって常に把握し、新しい項目がどの注文に属するものなのかを判別する必要があるため、同様の非効率が生じます。 単一の注文に属するすべての要求をグループ化すると、このようなアプリケーションの実装は大幅に簡素化されます。 1 つの注文に属するすべての項目が&1; セッションとしてクライアント アプリケーションから送信されるため、サービスは注文を処理するときにセッション全体を&1; 回で処理できます。 \  
+  
+## <a name="procedures"></a>手順  
+  
+#### <a name="to-set-up-a-service-contract-to-use-sessions"></a>セッションを使用するようにサービス コントラクトを設定するには  
+  
+1.  セッションを必要とするサービス コントラクトを定義します。 そのためには、 <xref:System.ServiceModel.OperationContractAttribute>属性し、値を指定します。  
+  
+    ```  
+    SessionMode=SessionMode.Required  
+    ```  
+  
+2.  これらのメソッドは何も返さないため、コントラクト内の操作を一方向としてマークします。 これは、 <xref:System.ServiceModel.OperationContractAttribute>属性し、値を指定します。  
+  
+    ```  
+    [OperationContract(IsOneWay = true)]  
+    ```  
+  
+3.  サービス コントラクトを実装し、`InstanceContextMode` に `PerSession` を指定します。 これにより、セッションごとに&1; 回だけサービスがインスタンス化されます。  
+  
+    ```  
+    [ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+    ```  
+  
+4.  各サービス操作には、トランザクションが必要になります。 これを指定する、 <xref:System.ServiceModel.OperationBehaviorAttribute>属性です。 トランザクションを完了する操作では、`TransactionAutoComplete` を `true` に設定する必要があります。  
+  
+    ```  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]   
+    ```  
+  
+5.  システム指定の `NetProfileMsmqBinding` バインディングを使用するエンドポイントを構成します。  
+  
+6.  トランザクション キューを使用して作成<xref:System.Messaging>します。 代わりに、MSMQ (メッセージ キュー) または MMC を使用してキューを作成することもできます。 この場合、トランザクション キューを作成します。  
+  
+7.  使用して、サービスのサービス ホストを作成<xref:System.ServiceModel.ServiceHost>します。  
+  
+8.  サービス ホストを開いてサービスを使用できるようにします。  
+  
+9. サービス ホストを閉じます。  
+  
+#### <a name="to-set-up-a-client"></a>クライアントを設定するには  
+  
+1.  トランザクションのスコープを作成してトランザクション キューに書き込みます。  
+  
+2.  作成、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントを使用して、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)ツールです。  
+  
+3.  注文を行います。  
+  
+4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを閉じます。  
+  
+## <a name="example"></a>例  
+  
+### <a name="description"></a>説明  
+ 次の例では、`IProcessOrder` サービス、およびこのサービスを使用するクライアントのコードを示します。 このコードは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が、キューに置かれたセッションを使用して動作をグループ化するしくみを示しています。  
+  
+### <a name="code-for-the-service"></a>サービスのコード  
+ [!code-csharp[S_Msmq_Session#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_session/cs/service.cs#1)]
+ [!code-vb[S_Msmq_Session#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_session/vb/service.vb#1)]  
+  
+  
+  
+### <a name="code-for-the-client"></a>クライアントのコード  
+ [!code-csharp[S_Msmq_Session#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_session/cs/client.cs#3)]
+ [!code-vb[S_Msmq_Session#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_session/vb/client.vb#3)]  
+  
+  
+  
+## <a name="see-also"></a>関連項目  
+ [セッションとキュー](../../../../docs/framework/wcf/samples/sessions-and-queues.md)   
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-in-a-managed-application.md b/docs/framework/wcf/feature-details/hosting-in-a-managed-application.md
new file mode 100644
index 00000000000..fb5f245a6ac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-in-a-managed-application.md
@@ -0,0 +1,36 @@
+---
+title: "マネージ アプリケーションのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: af70132d-e9e1-4f32-b20f-f0014629758a
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# マネージ アプリケーションのホスト
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスは、任意の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションでホストできます。 自己ホスト型サービスは、展開を要するインフラストラクチャが最も少ないので、最も柔軟なホスト オプションです。 ただし、マネージ アプリケーションは、インターネット インフォメーション サービス \(IIS\) や Windows サービスなど、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の他のホスト オプションが備えている高度なホスト機能と管理機能を提供しないので、堅牢さに最も乏しいホスト オプションでもあります。  
+  
+ 自己ホスト型サービスを作成するには、メッセージをリッスンするサービスを開始する <xref:System.ServiceModel.ServiceHost> のインスタンスを作成して開きます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : マネージ アプリケーションで WCF サービスをホストする](../../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)。  
+  
+ コントラクトの定義方法、コントラクトの実装方法、およびマネージ アプリケーション内部にサービスをホストする方法の完全な例については、「[チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)」および「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」を参照してください。  
+  
+ 以下に、このホスト オプションを使用する一般的なシナリオについて説明します。  
+  
+## コンソール アプリケーション  
+ 自己ホストによって可能になる一般的なシナリオは、コンソール アプリケーション内部で実行する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。 コンソール アプリケーション内部の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストすることは、一般的にサービスの開発フェーズで有用です。 コンソール アプリケーションにより、アプリケーション内部で起こっている状況を見極めるための情報のデバッグやトレースが容易になり、新しい場所にアプリケーションをコピーして移動することも簡単に行うことができます。  
+  
+## リッチ クライアント アプリケーション  
+ 自己ホストによって可能になるもう 1 つの一般的なシナリオは、リッチ クライアント アプリケーションです。これには、[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] または Windows フォーム \(WinForms\) に基づいて作成されたリッチ クライアント アプリケーションなどがあります。 このホスト オプションを使用すると、[!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] や WinForms アプリケーションなど、外部と通信を行うリッチ クライアント アプリケーションの作成も容易になります。 たとえば、ユーザー インターフェイスに [!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] を使用しながら、他のクライアントからの接続を許容して情報を共有するために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストするピア ツー ピア コラボレーションのクライアントなどです。  
+  
+## 参照  
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)   
+ [チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-in-a-windows-service-application.md b/docs/framework/wcf/feature-details/hosting-in-a-windows-service-application.md
new file mode 100644
index 00000000000..880e6d82edd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-in-a-windows-service-application.md
@@ -0,0 +1,52 @@
+---
+title: "Windows サービス アプリケーションのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4199998-27f3-4dd9-aee4-0a4addfa9f24
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Windows サービス アプリケーションのホスト
+Windows サービス \(従来 Windows NT サービスと呼ばれていたもの\) が提供するプロセス モデルが特に適しているのは、長い期間にわたって動作し続ける必要があり、どのような形式でもユーザー インターフェイスを表示することのないアプリケーションです。  Windows サービス アプリケーションのプロセスの有効期間を管理するのは、サービス コントロール マネージャー \(SCM\) です。SCM を使用して、Windows サービス アプリケーションを起動、停止、および一時停止できます。  Windows サービスのプロセスは、コンピューターの起動時に自動的に起動されるように構成できるので、常時稼働するアプリケーションのホスティング環境として適しています。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] Windows サービス アプリケーション、「[Windows サービス アプリケーション](http://go.microsoft.com/fwlink/?LinkId=89450)」を参照してください。  
+  
+ 長い期間にわたって動作し続ける [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストするアプリケーションは、さまざまな点で Windows サービスに似ています。  中でも顕著な類似点は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは長期間動作し続けるサーバー側実行可能ファイルであり、画面上でユーザーと直接対話することがないので、ユーザー インターフェイスを実装する必要がない、ということです。  したがって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを Windows サービス アプリケーション上でホストするやり方も、頑健で長期間動作し続ける [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの構築方法として選択肢となります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を開発する際には、多くの場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを Windows サービス上でホストするか、それとも Internet Information Services \(IIS\) や Windows Process Activation Service \(WAS\) のホスティング環境を使うか、決定しなければなりません。  次のような場合、Windows サービス上でホストする方法を使用できないか検討してください。  
+  
+-   アプリケーションを明示的にアクティブ化する必要がある場合。  たとえば、サーバー起動時に自動的にアプリケーションも起動しなければならず、最初に届いたメッセージに応答して動的に起動するのでは困るような場合です。  
+  
+-   アプリケーションをホストするプロセスが、起動されたらそのまま動作し続けなければならない場合。  一度起動した Windows サービスのプロセスは、サーバー管理者がサービス コントロール マネージャーで明示的にシャットダウンしない限り、そのまま動作し続けます。  IIS や WAS 上でホストするアプリケーションは、動的に起動および停止して、システム リソースを効率よく使うことができます。  しかし、ホストするプロセスの有効期間にわたって明示的に制御しなければならない場合、IIS や WAS ではなく Windows サービスを使う必要があります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを Windows Server 2003 上で実行する必要があり、HTTP 以外のトランスポート層プロトコルを使う場合。  Windows Server 2003 では、[!INCLUDE[iis601](../../../../includes/iis601-md.md)] ホスティング環境は HTTP 通信しかできないようになっています。  Windows サービス アプリケーションにはこのような制限がなく、net.tcp、net.pipe、net.msmq など、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が対応しているトランスポート層プロトコルはどれでも使用できます。  
+  
+### Windows サービス アプリケーションの内部で WCF をホストするには  
+  
+1.  Windows サービス アプリケーションを作成します。  Windows サービス アプリケーションは、<xref:System.ServiceProcess> 名前空間のクラスを使用して、マネージ コードとして記述することができます。  このアプリケーションには、<xref:System.ServiceProcess.ServiceBase> から派生したクラスを 1 つ含める必要があります。  
+  
+2.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの有効期間を、Windows サービス アプリケーションの有効期間とリンクさせます。  通常、Windows サービス アプリケーションでホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、ホストする側のサービスの起動時にアクティブになり、停止時にメッセージの監視をやめ、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにエラーが生じた場合はホストする側のプロセスをシャットダウンするようにします。  これは次のようにして実装します。  
+  
+    -   [OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> をオーバーライドして、<xref:System.ServiceModel.ServiceHost> のインスタンスを必要な個数開くようにします。  単一の Windows サービス アプリケーションで、一体となって開始および終了する複数の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストできます。  
+  
+    -   <xref:System.ServiceProcess.ServiceBase.OnStop%2A> をオーバーライドして、[OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> 時に起動された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが稼働する <xref:System.ServiceModel.ServiceHost> の、<xref:System.ServiceModel.Channels.CommunicationObject.Closed> を呼び出します。  
+  
+    -   <xref:System.ServiceModel.ServiceHost> の <xref:System.ServiceModel.Channels.CommunicationObject.Faulted> イベントを定期受信し、エラー時には、<xref:System.ServiceProcess.ServiceController> クラスを使用して Windows サービス アプリケーションをシャットダウンします。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする Windows サービス アプリケーションも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使わない Windows サービス アプリケーションと同様に展開および管理されます。  
+  
+## 参照  
+ <xref:System.ServiceProcess>   
+ [チュートリアル: コンポーネント デザイナによる Windows サービス アプリケーションの作成](http://go.microsoft.com/fwlink/?LinkId=94875)   
+ [方法 : マネージ Windows サービスで WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md)   
+ [Windows サービス ホスト](../../../../docs/framework/wcf/samples/windows-service-host.md)   
+ [サービス アプリケーションのプログラミング アーキテクチャ](http://go.microsoft.com/fwlink/?LinkId=94876)   
+ [Windows Server AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-in-internet-information-services.md b/docs/framework/wcf/feature-details/hosting-in-internet-information-services.md
new file mode 100644
index 00000000000..432d3aada47
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-in-internet-information-services.md
@@ -0,0 +1,72 @@
+---
+title: "インターネット インフォメーション サービスでのホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスティング サービス [WCF], IIS"
+ms.assetid: ddae14e8-143c-442d-b660-2046809b2d43
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# インターネット インフォメーション サービスでのホスティング
+インターネット インフォメーション サービス \(IIS\) アプリケーションの中に [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストする 1 つのオプションがあります。  このホスティング モデルは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] や ASP.NET Web サービス \(ASMX\) が使用するモデルと似ています。  
+  
+## IIS バージョン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をホストできるオペレーティング システムと IIS バージョンの組み合わせは次のとおりです。  
+  
+-   [!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] 上で IIS 5.1 を使用。  この環境は、後で [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] などのサーバー オペレーティング システムに展開される、IIS ホスト型アプリケーションの設計と開発に役立ちます。  
+  
+-   [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] に対する [!INCLUDE[iis601](../../../../includes/iis601-md.md)]。  [!INCLUDE[iis601](../../../../includes/iis601-md.md)] は、スケーラビリティと信頼性を向上し、アプリケーションの分離を実現する高度なプロセス モデルを提供します。  この環境は、HTTP 通信のみを使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの本運用展開に適しています。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] および [!INCLUDE[lserver](../../../../includes/lserver-md.md)] 上で IIS 7.0 を使用。  IIS 7.0 は、[!INCLUDE[iis601](../../../../includes/iis601-md.md)] と同じ高度なプロセス モデルを提供しますが、Windows プロセス アクティブ化サービス \(WAS\) を使用して、HTTP 以外のプロトコル経由でのアクティブ化とネットワーク通信を可能にします。  この環境は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされる任意のネットワーク プロトコル \(HTTP、net.tcp、net.pipe、net.msmq など\) で通信を行う [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの開発に適しています。  WAS [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows プロセス アクティブ化サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)」を参照してください。  
+  
+-   [Windows Server AppFabric](http://go.microsoft.com/fwlink/?LinkId=196496) は、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] および Windows Process Activation Service \(WAS\) と連携して、NET4 WCF および WF のサービスのための充実したアプリケーションのホスト環境を提供します。  この利点には、プロセス ライフサイクル管理、プロセス リサイクル、共有ホスティング、迅速な障害保護、プロセスの孤立化、オンデマンド アクティブ化、状態監視などがあります。  詳細については、「[AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=196494)」および「[AppFabric ホスティングの概念](http://go.microsoft.com/fwlink/?LinkId=196495)」を参照してください。  
+  
+## IIS ホスティングの利点  
+ IIS で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホスティングすることには、いくつかの利点があります。  
+  
+-   IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションや ASMX などの他の種類の IIS アプリケーションと同じように展開、管理されます。  
+  
+-   IIS はプロセスのアクティブ化、状態管理、リサイクル機能を提供し、ホストされるアプリケーションの信頼性を向上します。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] と同様に、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] でホストされた [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 共有ホスティング モデルを利用できます。このモデルでは、共通のワーカー プロセス内に複数のアプリケーションが存在し、サーバー密度とスケーラビリティが向上します。  
+  
+-   IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] と同じ動的なコンパイル モデルを使用します。これにより、ホストされるサービスの開発と展開が簡素化されます。  
+  
+ IIS で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストすることを決定する場合、IIS 5.1 と [!INCLUDE[iis601](../../../../includes/iis601-md.md)] は HTTP 通信のみに限定されることに注意することが重要です。  ホスト環境の選択[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+## IIS にホストされた WCF サービスの展開  
+ IIS でホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの開発と展開を行うには、次のタスクを実行します。  
+  
+-   IIS、ASP.NET、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]、および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] HTTP アクティブ化コンポーネントが正しくインストールおよび登録されていることを確認します。  
+  
+-   新しい IIS アプリケーションを作成するか、既存の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションを再利用します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス用の .svc ファイルを作成します。  
+  
+-   IIS アプリケーションにサービス実装を展開します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成します。  
+  
+ 各タスクの説明については、「[インターネット インフォメーション サービスでホストされる WCF サービスの配置](../../../../docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md)」を参照してください。  
+  
+## WCF サービスと ASP.NET  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] とサイド バイ サイドでホストするか、または [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換モードでホストできます。この互換モードでは、サービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーション プラットフォームが提供する機能を最大限に活用できます。  これらの機能の詳細については、「[WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」を参照してください。  
+  
+## 参照  
+ [ServiceHostFactory を使用したホストの拡張](../../../../docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md)   
+ [インターネット インフォメーション サービスでホストされる WCF サービスの配置](../../../../docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md)   
+ [WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)   
+ [インターネット インフォメーション サービス ホスティングのベスト プラクティス](../../../../docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md)   
+ [Windows Communication Foundation での Internet Information Services 7.0 の構成](../../../../docs/framework/wcf/feature-details/configuring-iis-for-wcf.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md b/docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md
new file mode 100644
index 00000000000..ede7ec162db
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md
@@ -0,0 +1,66 @@
+---
+title: "Windows プロセス アクティブ化サービスでのホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスティング サービス [WCF], WAS"
+ms.assetid: d2b9d226-15b7-41fc-8c9a-cb651ac20ecd
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# Windows プロセス アクティブ化サービスでのホスティング
+Windows プロセス アクティブ化サービス \(WAS\) は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストするアプリケーションが含まれるワーカー プロセスのアクティベーションと有効期間を管理します。  WAS プロセス モデルは HTTP の依存関係を取り除くことにより、HTTP サーバーの [!INCLUDE[iis601](../../../../includes/iis601-md.md)] プロセス モデルを一般化します。  これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、メッセージ ベースのアクティベーションがサポートされ、特定のコンピューター上で多数のアプリケーションをホストできるホスト環境で、Net.TCP などの HTTP プロトコルと非 HTTP プロトコルの両方を使用できるようになります。  
+  
+ WAS ホスト環境で実行される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構築する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : WAS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)」を参照してください。  
+  
+ WAS プロセスモデルは、信頼性が高く管理も容易でリソースを効果的に使用する方法でアプリケーションのホストを実現するいくつかの機能を提供します。  
+  
+-   HTTP と非 HTTP ネットワーク プロトコルを使用して到着する作業アイテムに応答して、アプリケーションやワーカー プロセス アプリケーションを動的に起動、停止する、メッセージに基づくアクティベーション。  
+  
+-   実行中のアプリケーションの状態を維持するための、信頼性の高いアプリケーションとワーカー プロセスのリサイクル。  
+  
+-   集中化されたアプリケーション設定と管理。  
+  
+-   完全な IIS インストールの配置スペースを必要とせずに、アプリケーションで IIS プロセス モデルを利用可能。  
+  
+ WAS 機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[IIS 7.0 Beta: IIS 7.0 Web Administration](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)」を参照してください。  
+  
+ [Windows Server AppFabric](http://go.microsoft.com/fwlink/?LinkId=196496) は、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] および Windows Process Activation Service \(WAS\) と連携して、NET4 WCF および WF のサービスのための充実したアプリケーションのホスト環境を提供します。  この利点には、プロセス ライフサイクル管理、プロセス リサイクル、共有ホスティング、迅速な障害保護、プロセスの孤立化、オンデマンド アクティブ化、状態監視などがあります。  詳細については、「[AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=196494)」および「[AppFabric ホスティングの概念](http://go.microsoft.com/fwlink/?LinkId=196495)」を参照してください。  
+  
+## WAS アドレス指定モデルの要素  
+ アプリケーションには、サーバーによって有効期間と実行環境が管理されているコード単位である URI \(Uniform Resource Identifier\) アドレスがあります。  1 つの WAS サーバー インスタンスを多数の異なるアプリケーションでホームとすることができます。  サーバーでアプリケーションは*サイト*と呼ばれるグループに編成されます。  サイト内でアプリケーションは階層で整理されます。この階層は URI の構造に反映されてアプリケーションの外部アドレスとして提供されます。  
+  
+ アプリケーション アドレスは、ベース URI プレフィックスとアプリケーション固有の相対アドレス \(パス\) の 2 つの部分に分かれます。この 2 つの部分が結合されアプリケーションの外部アドレスが提供されます。  ベース URI プレフィックスは、サイト バインドで構築され、サイト内のすべてのアプリケーションで使用されます。  次に、アプリケーション固有のパス フラグメント \(“\/applicationOne” など\) が取得され、ベース URI プレフィックス \(“net.tcp:\/\/localhost” など\) に追加されてアプリケーション アドレスが構築されます。これでアプリケーションの完全 URI になります。  
+  
+ HTTP と 非 HTTP サイト バインディングの両方の WAS サイト用に考えられるアドレス シナリオを次の表に示します。  
+  
+|シナリオ|サイト バインディング|アプリケーション パス|ベース アプリケーション URI|  
+|----------|-----------------|-----------------|----------------------|  
+|HTTP のみ|http: \*:80:\*|\/appTwo|http:\/\/localhost\/appTwo\/|  
+|HTTP と 非 HTTP の混在|http: \*:80:\*<br /><br /> net.tcp: 808:\*|\/appTwo|http:\/\/localhost\/appTwo\/                 <br /> net.tcp:\/\/localhost\/appTwo\/|  
+|非 HTTP のみ|net.pipe: \*|\/appThree|net.pipe:\/\/appThree\/|  
+  
+ アプリケーション内のサービスとリソースにもアドレスを指定できます。  アプリケーション内では、アプリケーション リソースにベース アプリケーション パスに対する相対アドレスが指定されます。  たとえば、コンピューター名 contoso.com のサイトに HTTP と Net.TCP プロトコルの両方のサイト バインドがあるとします。  さらに、そのサイトには 1 つのアプリケーションが \/Billing に格納されており、GetOrders.svc でサービスを公開しているとします。  このとき、GetOrders.svc サービスで SecureEndpoint の相対アドレスを持つエンドポイントが公開されている場合、サービスのエンドポイントは次の 2 つの URI で公開されることになります。  
+  
+ http:\/\/contoso.com\/Billing\/GetOrders.svc\/SecureEndpoint           
+ net.tcp:\/\/contoso.com\/Billing\/GetOrders.svc\/SecureEndpoint  
+  
+## WAS ランタイム  
+ アプリケーションは、アドレス指定と管理の目的でサイトに編成されます。  実行時にもアプリケーションはアプリケーション プールにグループ化されます。  アプリケーション プールには、多数の異なるサイトからの多数の異なるアプリケーションを格納できます。  アプリケーション プール内のすべてのアプリケーションで、一連の共通の実行時特性を共有します。  たとえば、すべてのアプリケーションは同じバージョンの共通言語ランタイム \(CLR\) 下で実行され、またすべてのアプリケーションで共通のプロセス ID を共有します。  各アプリケーション プールはワーカー プロセス \(w3wp.exe\) のインスタンスに対応します。  共有アプリケーション プール内で実行される各マネージ アプリケーションは、CLR AppDomain により他のアプリケーションから分離されます。  
+  
+## 参照  
+ [WAS アクティベーション アーキテクチャ](../../../../docs/framework/wcf/feature-details/was-activation-architecture.md)   
+ [WCF で使用するための WAS を設定する](../../../../docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md)   
+ [方法 : WCF アクティブ化コンポーネントをインストールして設定する](../../../../docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md)   
+ [方法 : WAS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-workflow-services-overview.md b/docs/framework/wcf/feature-details/hosting-workflow-services-overview.md
new file mode 100644
index 00000000000..88e28b7f0bb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-workflow-services-overview.md
@@ -0,0 +1,56 @@
+---
+title: "ワークフロー サービスのホストの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19f3704f-06bf-4eeb-8724-5224e02d7ead
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ワークフロー サービスのホストの概要
+ワークフロー サービスを実行するには、ホストされている必要があります。<xref:System.ServiceModel.WorkflowServiceHost> は、複数のインスタンス、構成、および WCF メッセージングをサポートする標準ワークフロー ホストです \(ワークフローはホストされるためにメッセージングを使用する必要はありません\)。また、一連のサービス動作を介して永続性、追跡、およびインスタンス コントロールを統合します。WCF の <xref:System.ServiceModel.ServiceHost> と同様に、<xref:System.ServiceModel.WorkflowServiceHost> は任意のマネージ .NET アプリケーションでの自己ホスト、または IIS\/WAS での Web ホスト \(.xamlx ファイルとして\) が可能です。このセクションのトピックでは、ワークフロー サービスをホストする方法について説明します。  
+  
+## このセクションの内容  
+ [ワークフロー サービスのホスティング](../../../../docs/framework/wcf/feature-details/hosting-workflow-services.md)  
+ ワークフロー サービスのホスティングについて説明します。  
+  
+ [ワークフロー サービス ホストの内部](../../../../docs/framework/wcf/feature-details/workflow-service-host-internals.md)  
+ <xref:System.ServiceModel.WorkflowServiceHost> がどのように受信メッセージを処理するかについて説明します。  
+  
+ [ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)  
+ ワークフロー サービス ホストの機能を拡張する方法について説明します。  
+  
+ [ワークフロー コントロール エンドポイント](../../../../docs/framework/wcf/feature-details/workflow-control-endpoint.md)  
+ ワークフロー インスタンスを作成できるエンドポイントを定義する方法について説明します。  
+  
+ [方法 : IIS でサービス以外のワークフローをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-non-service-workflow-in-iis.md)  
+ IIS のワークフロー サービスではないワークフローのホスティングについて説明します。  
+  
+ [方法 : Windows Server AppFabric を使用してワークフロー サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-workflow-service-with-windows-server-app-fabric.md)  
+ Windows Server AppFabric の既存のワークフロー サービスをホストする方法について説明します。  
+  
+ [WorkflowServiceHost の構成](../../../../docs/framework/wcf/feature-details/configuring-workflowservicehost.md)  
+ 永続性、追跡、アイドル状態、および未処理の例外動作を制御する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost>  
+  
+ <xref:System.ServiceModel.Activities.WorkflowService>  
+  
+ <xref:System.ServiceModel.Activation.ServiceHostFactory>  
+  
+ <xref:System.ServiceModel.Activation.ServiceHostFactoryBase>  
+  
+ <xref:System.ServiceModel.Activation.WorkflowServiceHostFactory>  
+  
+## 関連項目  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting-workflow-services.md b/docs/framework/wcf/feature-details/hosting-workflow-services.md
new file mode 100644
index 00000000000..cf19a7581c8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting-workflow-services.md
@@ -0,0 +1,66 @@
+---
+title: "ワークフロー サービスのホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d55217e-8697-4113-94ce-10b60863342e
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ワークフロー サービスのホスティング
+ワークフロー サービスが受信メッセージに応答するには、ワークフロー サービスがホストされている必要があります。ワークフロー サービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージング インフラストラクチャを使用するため、これと似た方法でホストされます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様に、ワークフロー サービスは、インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) の下で、任意のマネージ アプリケーションでホストできます。また、ワークフロー サービスは Windows Server AppFabric でホストできます。Windows Server App Fabric [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server App Fabric のドキュメント](http://go.microsoft.com/fwlink/?LinkId=193037)」、「[AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=196494)」、および「[AppFabric ホスティングの概念](http://go.microsoft.com/fwlink/?LinkId=196495)」を参照してください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストするためのさまざまな方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+## マネージ アプリケーションでのホスト  
+ マネージ アプリケーションでワークフロー サービスをホストするには、<xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスを使用します。<xref:System.ServiceModel.Activities.WorkflowServiceHost> コンストラクターにより、シングルトン ワークフロー サービス インスタンス、ワークフロー サービス定義、またはワークフロー メッセージング アクティビティを使用するアクティビティを指定できます。<xref:System.ServiceModel.Activities.WorkflowServiceHost.Open%2A> の呼び出しによって、サービスが受信メッセージのリッスンを開始します。  
+  
+## IIS または WAS の下でのホスト  
+ IIS または WAS の下でワークフロー サービスをホストする場合は、仮想ディレクトリを作成し、サービスとその動作を定義するファイルをその仮想ディレクトリ内に配置します。IIS または WAS の下でワークフローをホストする場合は、いくつかの方法が考えられます。  
+  
+-   ワークフロー サービスを定義する .xamlx ファイルを、サービス動作、エンドポイント、およびその他の構成要素を指定する Web.config ファイルと共に、IIS\/WAS 仮想ディレクトリに配置します。  
+  
+-   ワークフロー サービスを定義する .xamlx ファイルを IIS\/WAS 仮想ディレクトリに配置します。この .xamlx ファイルで、公開するエンドポイントが指定されます。エンドポイントは、次の例に示すように、`WorkflowService.Endpoints` 要素で指定されます。  
+  
+    ```  
+    <WorkflowService xmlns="http://schemas.microsoft.com/netfx/2009/xaml/servicemodel"  xmlns:p1="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:sad="clr-namespace:System.Activities.Debugger;assembly=System.Activities" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+      <WorkflowService.Endpoints>  
+        <Endpoint ServiceContractName="IWorkFlowEchoService" AddressUri="">  
+          <Endpoint.Binding>  
+            <BasicHttpBinding />  
+          </Endpoint.Binding>  
+        </Endpoint>  
+      </WorkflowService.Endpoints>  
+    <!-- ... -->  
+    </WorkflowService>  
+  
+    ```  
+  
+    > [!NOTE]
+    >  動作は .xamlx ファイルで指定できないため、動作設定を指定するには Web.config を使用する必要があります。  
+  
+-   ワークフロー サービスを定義する .xamlx ファイルを IIS\/WAS 仮想ディレクトリに配置します。さらに、.svc ファイルを仮想ディレクトリに配置します。.svc ファイルでは、カスタム Web サービス ホスト ファクトリの指定、カスタム動作の適用、またはカスタムの場所からの構成の読み込みが可能です。  
+  
+-   WCF メッセージング アクティビティを使用するアクティビティを含むアセンブリを IIS\/WAS 仮想ディレクトリに配置します。  
+  
+ ワークフロー サービスを定義する .xamlx ファイルには、\<`Service`\> ルート要素、または <xref:System.Workflow.ComponentModel.Activity> から派生する型を含むルート要素が含まれている必要があります。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アクティビティ テンプレートを使用する場合は、.xamlx ファイルが作成されます。WCF ワークフロー サービス テンプレートを使用する場合は、.xamlx ファイルが作成されます。  
+  
+## Windows Server AppFabric でのワークフロー サービスのホスティング  
+ Windows Server AppFabric でのワークフロー サービスのホスティングは IIS\/WAS でのホスティングと同じ方法で行われます。唯一の違いは、Windows Server AppFabric がインストールされるということです。Windows Server AppFabric には、PowerShell コマンドと同様に、インターネット インフォメーション サービス マネージャーに追加されるツールが用意されています。これらのツールによって、ワークフロー サービスおよび WCF サービスの配置、管理、および追跡を簡略化することができます。.Windows Server AppFabric [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server AppFabric](http://go.microsoft.com/fwlink/?LinkId=193037)」を参照してください。  
+  
+## カスタム アクティビティの参照  
+ カスタム アクティビティの参照は、\<`System.Web.Compilation`\> の下の \<`Assemblies`\> セクションに追加する必要があります。これにより、この参照がアプリケーション ドメインに読み込まれ、XAML デシリアライザーが型を見つけることができます。これらの設定をコンピューター上のすべてのアプリケーションに適用する必要がある場合は、アプリケーション レベルまたはルートの Web.config で設定できます。  
+  
+## 配置  
+ 配置作業を容易にするために、Web 配置ツールが作成されています。このツールを使用すると、アプリケーションの IIS 6.0 および IIS 7.0 間での移行や、サーバー ファームの同期のほか、Web アプリケーションのパッケージ化、アーカイブ、および配置を実行できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][、MS 配置ツールを参照してください。](http://go.microsoft.com/fwlink/?LinkId=178690)  
+  
+## 参照  
+ [ワークフロー サービス ホストの内部](../../../../docs/framework/wcf/feature-details/workflow-service-host-internals.md)   
+ [WorkflowServiceHost の構成](../../../../docs/framework/wcf/feature-details/configuring-workflowservicehost.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/hosting.md b/docs/framework/wcf/feature-details/hosting.md
new file mode 100644
index 00000000000..e1f65e98560
--- /dev/null
+++ b/docs/framework/wcf/feature-details/hosting.md
@@ -0,0 +1,45 @@
+---
+title: "ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0820c7e5-0b50-4cde-80e7-74e346513002
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# ホスト
+このセクションのトピックでは、サービス ホスティングについて説明します。サービスは、インターネット インフォメーション サービス \(IIS\)、Windows プロセス アクティブ化サービス \(WAS\)、Windows Server AppFabric、Windows サービス、またはマネージ アプリケーションによってホストできます。マネージ アプリケーションによるホストは、一般に、*自己ホスト*と呼ばれます。  
+  
+ 信頼されていないホストからサービスや拡張機能を実行すると、セキュリティが損なわれるので注意してください。  
+  
+## このセクションの内容  
+ [インターネット インフォメーション サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)  
+ インターネット インフォメーション サービスまたは [Windows Server AppFabric](http://go.microsoft.com/fwlink/?LinkId=196496) で [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストする方法について説明します。  
+  
+ [Windows プロセス アクティブ化サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)  
+ Windows プロセス アクティブ化サービス \(WAS\) で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする方法について説明します。  
+  
+ [Windows サービス アプリケーションのホスト](../../../../docs/framework/wcf/feature-details/hosting-in-a-windows-service-application.md)  
+ Windows サービスで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をホストする方法について説明します。  
+  
+ [マネージ アプリケーションのホスト](../../../../docs/framework/wcf/feature-details/hosting-in-a-managed-application.md)  
+ マネージ アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をホストする方法について説明します。  
+  
+ [IIS と WAS における構成ベースのアクティブ化](../../../../docs/framework/wcf/feature-details/configuration-based-activation-in-iis-and-was.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが、.svc ファイルを使用せずに、IIS または WAS でホストされるしくみについて説明します。  
+  
+ [複数の IIS サイト バインディングのサポート](../../../../docs/framework/wcf/feature-details/supporting-multiple-iis-site-bindings.md)  
+ 1 つの Web サイト上で同じ URI スキームを使用してサービスの複数のベース アドレスを指定する方法について説明します。  
+  
+## 参照  
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md b/docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md
new file mode 100644
index 00000000000..6fe7d7ca325
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md
@@ -0,0 +1,409 @@
+---
+title: "WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0365eb37-98cc-4b13-80fb-f1e78847a748
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 配信サービスを開発する場合、次のクラスを使用するフィードや項目を作成します。  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationFeed>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationItem>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationPerson>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationLink>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationCategory>  
+  
+-   <xref:System.ServiceModel.Syndication.TextSyndicationContent>  
+  
+-   <xref:System.ServiceModel.Syndication.UrlSyndicationContent>  
+  
+-   <xref:System.ServiceModel.Syndication.XmlSyndicationContent>  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationFeed> はフォーマッタが定義されている任意の配信フォーマットにシリアル化できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、<xref:System.ServiceModel.Syndication.Atom10FeedFormatter> および <xref:System.ServiceModel.Syndication.Rss20FeedFormatter> の 2 つのフォーマッタが付属しています。  
+  
+ RSS 2.0 仕様より Atom 1.0 仕様の方が、<xref:System.ServiceModel.Syndication.SyndicationFeed> および <xref:System.ServiceModel.Syndication.SyndicationItem> 周辺のオブジェクト モデルをより細かく調整しています。これは、Atom 1.0 が、あいまいな要素または RSS 2.0 仕様から省略された要素を定義する、より基本的な仕様であるためです。このため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 配信オブジェクト モデルにある多くの項目には、RSS 2.0 仕様の直接表現がありません。<xref:System.ServiceModel.Syndication.SyndicationFeed> および <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトを RSS 2.0 にシリアル化する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] により、Atom 固有のデータ要素を、Atom 仕様に準拠する名前空間で修飾された拡張要素にシリアル化できます。これは、<xref:System.ServiceModel.Syndication.Rss20FeedFormatter> コンストラクターに渡すパラメーターで制御できます。  
+  
+ このトピックのコード例では、ここで定義される 2 つのメソッドのいずれかを使い、実際のシリアル化を行っています。  
+  
+ `SerializeFeed` は、配信フィードをシリアル化します。  
+  
+ [!code-csharp[SyndicationMapping#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#10)]
+ [!code-vb[SyndicationMapping#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#10)]  
+  
+ `SerializeItem` は、配信項目をシリアル化します。  
+  
+ [!code-csharp[SyndicationMapping#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#11)]
+ [!code-vb[SyndicationMapping#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#11)]  
+  
+## SyndicationFeed  
+ <xref:System.ServiceModel.Syndication.SyndicationFeed> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#0)]
+ [!code-vb[SyndicationMapping#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#0)]  
+  
+ 次の XML は、<xref:System.ServiceModel.Syndication.SyndicationFeed> を Atom 1.0 にシリアル化する方法を示しています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<feed xml:lang="EN-US" xmlns="http://www.w3.org/2005/Atom">  
+  <title type="text">My Feed Title</title>  
+  <subtitle type="text">My Feed Description</subtitle>  
+  <id>FeedID</id>  
+  <rights type="text">Copyright 2007</rights>  
+  <updated>2007-08-29T13:57:17-07:00</updated>  
+  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />  
+  <logo>http://server/image.jpg</logo>  
+  <generator>Sample Code</generator>  
+  <link rel="alternate" href="http://myfeeduri/" />  
+  <entry>  
+    <id>ItemID</id>  
+    <title type="text">Item Title</title>  
+    <summary type="text">Item Summary</summary>  
+    <published>2007-08-29T00:00:00-07:00</published>  
+    <updated>2007-08-29T13:57:17-07:00</updated>  
+    <author>  
+      <name>Jesper Aaberg</name>  
+      <uri>http://Jesper/Aaberg</uri>  
+      <email>Jesper@Aaberg.com</email>  
+    </author>  
+    <contributor>  
+      <name>Lene Aaling</name>  
+      <uri>http://Lene/Aaling</uri>  
+      <email>Lene@Aaling.com</email>  
+    </contributor>  
+    <link rel="alternate" href="http://myitemuri/" />  
+    <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />  
+    <content type="text">Item Content</content>  
+    <rights type="text">Copyright 2007</rights>  
+    <source>  
+      <title type="text">My Feed Title</title>  
+      <subtitle type="text">My Feed Description</subtitle>  
+      <id>FeedID</id>  
+      <rights type="text">Copyright 2007</rights>  
+      <updated>2007-08-29T13:57:17-07:00</updated>  
+      <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />  
+      <logo>http://server/image.jpg</logo>  
+      <generator>Sample Code</generator>  
+      <link rel="alternate" href="http://myfeeduri/" />  
+    </source>  
+  </entry>  
+</feed>  
+```  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationFeed> を RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<rss xmlns:a10="http://www.w3.org/2005/Atom" version="2.0">  
+  <channel>  
+    <title>My Feed Title</title>  
+    <link>http://myfeeduri/</link>  
+    <description>My Feed Description</description>  
+    <language>EN-US</language>  
+    <copyright>Copyright 2007</copyright>  
+    <lastBuildDate>Wed, 29 Aug 2007 13:57:17 -0700</lastBuildDate>  
+    <category domain="categoryScheme">categoryName</category>  
+    <generator>Sample Code</generator>  
+    <image>  
+      <url>http://server/image.jpg</url>  
+      <title>My Feed Title</title>  
+      <link>http://myfeeduri/</link>  
+    </image>  
+    <a10:id>FeedID</a10:id>  
+    <item>  
+      <guid isPermaLink="false">ItemID</guid>  
+      <link>http://myitemuri/</link>  
+      <author>Jesper@Aaberg.com</author>  
+      <category domain="categoryScheme">categoryName</category>  
+      <title>Item Title</title>  
+      <description>Item Summary</description>  
+      <source>My Feed Title</source>  
+      <pubDate>Wed, 29 Aug 2007 00:00:00 -0700</pubDate>  
+      <a10:updated>2007-08-29T13:57:17-07:00</a10:updated>  
+      <a10:rights type="text">Copyright 2007</a10:rights>  
+      <a10:content type="text">Item Content</a10:content>  
+      <a10:contributor>  
+        <a10:name>Lene Aaling</a10:name>  
+        <a10:uri>http://Lene/Aaling</a10:uri>  
+        <a10:email>Lene@Aaling.com</a10:email>  
+      </a10:contributor>  
+    </item>  
+  </channel>  
+</rss>  
+```  
+  
+## SyndicationItem  
+ <xref:System.ServiceModel.Syndication.SyndicationItem> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#1)]
+ [!code-vb[SyndicationMapping#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#1)]  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationItem> を Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+<entry xmlns="http://www.w3.org/2005/Atom">  
+  <id>ItemID</id>  
+  <title type="text">Item Title</title>  
+  <summary type="text">Item Summary</summary>  
+  <published>2007-08-29T00:00:00-07:00</published>  
+  <updated>2007-08-29T14:07:09-07:00</updated>  
+  <author>  
+    <name>Jesper Aaberg</name>  
+    <uri>http://Contoso/Aaberg</uri>  
+    <email>Jesper.Aaberg@contoso.com</email>  
+  </author>  
+  <author>  
+    <name>Syed Abbas</name>  
+    <uri>http://Contoso/Abbas</uri>  
+    <email>Syed.Abbas@contoso.com</email>  
+  </author>  
+  <contributor>  
+    <name>Lene Aaling</name>  
+    <uri>http://Contoso/Aaling</uri>  
+    <email>Lene.Aaling@contoso.com</email>  
+  </contributor>  
+  <contributor>  
+    <name>Kim Abercrombie</name>  
+    <uri>http://Contoso/Abercrombie</uri>  
+    <email>Kim.Abercrombie@contoso.com</email>  
+  </contributor>  
+  <link rel="alternate" href="http://myitemuri/" />  
+  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />  
+  <category term="categoryName" label="categoryLabel" scheme="categoryScheme" />  
+  <content type="text">Item Content</content>  
+  <rights type="text">Copyright 2007</rights>  
+  <source>  
+    <title type="text">My Feed Title</title>  
+    <subtitle type="text">My Feed Description</subtitle>  
+    <link rel="alternate" href="http://myfeeduri/" />  
+  </source>  
+</entry>  
+```  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationItem> を RSS 2.0.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+<item>  
+  <guid isPermaLink="false">ItemID</guid>  
+  <link>http://myitemuri/</link>  
+  <author xmlns="http://www.w3.org/2005/Atom">  
+    <name>Jesper Aaberg</name>  
+    <uri>http://Jesper/Aaberg</uri>  
+    <email>Jesper@Aaberg.com</email>  
+  </author>  
+  <author xmlns="http://www.w3.org/2005/Atom">  
+    <name>Syed Abbas</name>  
+    <uri>http://Contoso/Abbas</uri>  
+    <email>Syed.Abbas@contoso.com</email>  
+  </author>  
+  <category domain="categoryScheme">categoryName</category>  
+  <category domain="categoryScheme">categoryName</category>  
+  <title>Item Title</title>  
+  <description>Item Summary</description>  
+  <source>My Feed Title</source>  
+  <pubDate>Wed, 29 Aug 2007 00:00:00 -0700</pubDate>  
+  <updated xmlns="http://www.w3.org/2005/Atom">2007-08-29T14:07:09-07:00</updated>  
+  <rights type="text" xmlns="http://www.w3.org/2005/Atom">Copyright 2007</rights>  
+  <content type="text" xmlns="http://www.w3.org/2005/Atom">Item Content</content>  
+  <contributor xmlns="http://www.w3.org/2005/Atom">  
+    <name>Lene Aaling</name>  
+    <uri>http://Contoso/Aaling</uri>  
+    <email>Lene.Aaling@contoso.com</email>  
+  </contributor>  
+  <contributor xmlns="http://www.w3.org/2005/Atom">  
+    <name>Kim Abercrombie</name>  
+    <uri>http://Contoso/Abercrombie</uri>  
+    <email>Kim.Abercrombie@contoso.com</email>  
+  </contributor>  
+</item>  
+```  
+  
+## SyndicationPerson  
+ <xref:System.ServiceModel.Syndication.SyndicationPerson> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#2)]
+ [!code-vb[SyndicationMapping#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#2)]  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationPerson> を Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+  <author>  
+    <name>Jesper Aaberg</name>  
+    <uri>http://Contoso/Aaberg</uri>  
+    <email>Jesper.Aaberg@contoso.com</email>  
+  </author>  
+<contributor>  
+    <name>Lene Aaling</name>  
+    <uri>http://Contoso/Aaling</uri>  
+    <email>Lene.Aaling@contoso.com</email>  
+  </contributor>  
+```  
+  
+ `Authors` コレクションまたは `Contributors` コレクションに、それぞれ <xref:System.ServiceModel.Syndication.SyndicationPerson> が 1 つのみ存在する場合に、<xref:System.ServiceModel.Syndication.SyndicationPerson> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+<author>Jesper.Aaberg@contoso.com</author>  
+<a10:contributor>  
+    <a10:name>Lene Aaling</a10:name>  
+    <a10:uri>http://Contoso/Aaling</a10:uri>  
+    <a10:email>Lene.Aaling@contoso.com</a10:email>  
+</a10:contributor>  
+```  
+  
+ `Authors` コレクションまたは `Contributors` コレクションに、それぞれ <xref:System.ServiceModel.Syndication.SyndicationPerson> が複数存在する場合に、<xref:System.ServiceModel.Syndication.SyndicationPerson> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+```  
+<a10:author>  
+    <a10:name>Jesper Aaberg</a10:name>  
+    <a10:uri>http://Contoso/Aaberg</a10:uri>  
+    <a10:email>Jesper.Aaberg@contoso.com</a10:email>  
+</a10:author>  
+<a10:author>  
+    <a10:name>Syed Abbas</a10:name>  
+    <a10:uri>http://Contoso/Abbas</a10:uri>  
+    <a10:email>Syed.Abbas@contoso.com</a10:email>  
+</a10:author>  
+<a10:contributor>  
+    <a10:name>Lene Aaling</a10:name>  
+    <a10:uri>http://Contoso/Aaling</a10:uri>  
+    <a10:email>Lene.Aaling@contoso.com</a10:email>  
+</a10:contributor>  
+<a10:contributor>  
+    <a10:name>Kim Abercrombie</a10:name>  
+    <a10:uri>http://Contoso/Abercrombie</a10:uri>  
+    <a10:email>Kim.Abercrombie@contoso.com</a10:email>  
+</a10:contributor>  
+```  
+  
+## SyndicationLink  
+ <xref:System.ServiceModel.Syndication.SyndicationLink> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#3)]
+ [!code-vb[SyndicationMapping#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#3)]  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationLink> を Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<link rel="alternate" type="text/html" title="My Link Title" length="2048" href="http://contoso/MyLink" />`  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationLink> を RSS 2.0.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<a10:link rel="alternate" type="text/html" title="My Link Title" length="2048" href="http://contoso/MyLink" />`  
+  
+## SyndicationCategory  
+ <xref:System.ServiceModel.Syndication.SyndicationCategory> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#4)]
+ [!code-vb[SyndicationMapping#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#4)]  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationCategory> を Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<category term="categoryName" label="categoryLabel" scheme="categoryScheme" />`  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationCategory> を RSS 2.0.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<category domain="categoryScheme">categoryName</category>`  
+  
+## TextSyndicationContent  
+ <xref:System.ServiceModel.Syndication.TextSyndicationContent> が HTML コンテンツと共に作成される場合に <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#5)]
+ [!code-vb[SyndicationMapping#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#5)]  
+  
+ HTML コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="html"><html> some html </html></content>`  
+  
+ HTML コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<description><html> some html </html></description>`  
+  
+ <xref:System.ServiceModel.Syndication.TextSyndicationContent> がプレーンテキスト コンテンツと共に作成される場合に、<xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#6)]
+ [!code-vb[SyndicationMapping#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#6)]  
+  
+ プレーンテキスト コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="text">Some Plain Text</content>`  
+  
+ プレーンテキスト コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<description>Some Plain Text</description>`  
+  
+ <xref:System.ServiceModel.Syndication.TextSyndicationContent> が XHTML コンテンツと共に作成される場合に、<xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#7)]
+ [!code-vb[SyndicationMapping#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#7)]  
+  
+ XHTML コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="xhtml">`  
+  
+ `<html> some xhtml </html>`  
+  
+ `</content>`  
+  
+ XHTML コンテンツ付きの <xref:System.ServiceModel.Syndication.TextSyndicationContent> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<description><html> some xhtml </html></description>`  
+  
+## UrlSyndicationContent  
+ <xref:System.ServiceModel.Syndication.UrlSyndicationContent> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#8)]
+ [!code-vb[SyndicationMapping#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#8)]  
+  
+ <xref:System.ServiceModel.Syndication.UrlSyndicationContent> クラスを Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="audio" src="http://someurl/" />`  
+  
+ XHTML コンテンツ付きの <xref:System.ServiceModel.Syndication.UrlSyndicationContent> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<description />`  
+  
+ `<content type="audio" src="http://Contoso/someurl/" xmlns="http://www.w3.org/2005/Atom" />`  
+  
+## XmlSyndicationContent  
+ <xref:System.ServiceModel.Syndication.XmlSyndicationContent> クラスを Atom 1.0 および RSS 2.0 にシリアル化するコード例を次に示します。  
+  
+ [!code-csharp[SyndicationMapping#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/syndicationmapping/cs/snippets.cs#9)]
+ [!code-vb[SyndicationMapping#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/syndicationmapping/vb/snippets.vb#9)]  
+  
+ <xref:System.ServiceModel.Syndication.XmlSyndicationContent> クラスを Atom 1.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="mytype">`  
+  
+ `<SomeData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/FeedMapping" />`  
+  
+ `</content>`  
+  
+ XHTML コンテンツ付きの <xref:System.ServiceModel.Syndication.XmlSyndicationContent> クラスを RSS 2.0 にシリアル化する方法を次の XML に示します。  
+  
+ `<content type="mytype" xmlns="http://www.w3.org/2005/Atom">`  
+  
+ `<SomeData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/FeedMapping" />`  
+  
+ `</content>`  
+  
+## 参照  
+ [WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)   
+ [配信のアーキテクチャ](../../../../docs/framework/wcf/feature-details/architecture-of-syndication.md)   
+ [方法 : 基本的な RSS フィードを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-rss-feed.md)   
+ [方法 : 基本的な ATOM フィードを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-atom-feed.md)   
+ [方法 : Atom および RSS の両方としてフィードを公開する](../../../../docs/framework/wcf/feature-details/how-to-expose-a-feed-as-both-atom-and-rss.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md b/docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md
new file mode 100644
index 00000000000..851e562a5de
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md
@@ -0,0 +1,75 @@
+---
+title: "方法: ワークフロー アプリケーションからサービスにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 925ef8ea-5550-4c9d-bb7b-209e20c280ad
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法: ワークフロー アプリケーションからサービスにアクセスする
+このトピックでは、ワークフロー コンソール アプリケーションからワークフロー サービスを呼び出す方法について説明します。これを実行するには、「[方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)」を完了している必要があります。このトピックでは、ワークフロー アプリケーションからワークフロー サービスを呼び出す方法について説明していますが、同じ方法を使用して、どのような [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスでもワークフロー アプリケーションから呼び出すことができます。  
+  
+### ワークフロー コンソール アプリケーション プロジェクトの作成  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動します。  
+  
+2.  「[方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)」で作成した MyWFService プロジェクトを読み込みます。  
+  
+3.  **ソリューション エクスプローラー**で **MyWFService** ソリューションを右クリックし、**\[追加\]** をクリックして、**\[新しいプロジェクト\]** をクリックします。**\[インストールされたテンプレート\]** から **\[ワークフロー\]** を選択し、プロジェクトの種類の一覧から **\[ワークフロー コンソール アプリケーション\]** を選択します。次の図に示すように、プロジェクトに MyWFClient という名前を付け、既定の場所を使用します。  
+  
+     ![&#91;新しいプロジェクトの追加&#93; ダイアログ](../../../../docs/framework/wcf/feature-details/media/addnewprojectdlg.JPG "AddNewProjectDlg")  
+  
+     **\[OK\]** をクリックして **\[新しいプロジェクトの追加\]** ダイアログ ボックスを閉じます。  
+  
+4.  プロジェクトが作成されると、Workflow1.xaml ファイルがデザイナーで開かれます。**\[ツールボックス\]** タブが開かれていない場合は、これをクリックして開き、プッシュピンをクリックしてツールボックス ウィンドウを開いたままにします。  
+  
+5.  Ctrl キーを押しながら F5 キーを押して、サービスを起動します。以前と同様に、ASP.NET 開発サーバーが起動され、Internet Explorer に WCF ヘルプ ページが表示されます。このページの URI は、次の手順で使用する必要があるため、確認しておいてください。  
+  
+     ![WCF ヘルプ ページと URI を表示している IE](../../../../docs/framework/wcf/feature-details/media/iewcfhelppagewuri.JPG "IEWCFHelpPageWURI")  
+  
+6.  **ソリューション エクスプローラー**で **MyWFClient** プロジェクトを右クリックし、**\[サービス参照の追加\]** をクリックします。**\[探索\]** ボタンをクリックして、サービスに使用できる現在のソリューションを検索します。\[サービス\] ボックスで、Service1.xamlx の横にある三角形をクリックします。Service1 の横にある三角形をクリックして、Service1 サービスによって実装されるコントラクトの一覧を表示します。**\[サービス\]** ボックスで、**\[Service1\]** ノードを展開します。次の図のように、**\[操作\]** ボックスに Echo 操作が表示されます。  
+  
+     ![&#91;サービス参照の追加&#93; ダイアログ](../../../../docs/framework/wcf/feature-details/media/addservicereference.JPG "AddServiceReference")  
+  
+     既定の名前空間のままにし、**\[OK\]** をクリックして **\[サービス参照の追加\]** ダイアログ ボックスを閉じます。次のダイアログ ボックスが表示されます。  
+  
+     ![サービス参照の追加の通知ダイアログ](../../../../docs/framework/wcf/feature-details/media/asrdlg.JPG "ASRDlg")  
+  
+     **\[OK\]** をクリックして、このダイアログ ボックスを閉じます。次に、Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。ツールボックスに **MyWFClient.ServiceReference1.Activities** という名前の新しい選択肢が追加されていることを確認します。この選択肢を展開して、次の図のように、追加されている Echo アクティビティを確認します。  
+  
+     ![ツールボックスのエコー アクティビティ](../../../../docs/framework/wcf/feature-details/media/echoactivity.JPG "EchoActivity")  
+  
+7.  <xref:System.ServiceModel.Activities.Sequence> アクティビティをデザイナー画面にドラッグ アンド ドロップします。これは、ツールボックスの **\[制御フロー\]** セクションにあります。  
+  
+8.  <xref:System.ServiceModel.Activities.Sequence> アクティビティにフォーカスがある状態で、**\[変数\]** リンクをクリックして、`inString` という名前の文字列変数を追加します。この変数と `outString` という名前の文字列変数に、既定値である `“Hello, world”` を設定します。  
+  
+     ![変数の追加](../../../../docs/framework/wcf/feature-details/media/instringvar.JPG "inStringVar")  
+  
+9. **Echo** アクティビティを <xref:System.ServiceModel.Activities.Sequence> にドラッグ アンド ドロップします。次の図のように、プロパティ ウィンドウで、\_string 引数を `inString` 変数にバインドし、`out_string` 引数を outString 変数にバインドします。これにより、`inString` 変数の値を操作に渡し、戻り値を取得し、その戻り値を `outString` 変数に格納します。  
+  
+     ![変数への引数のバインド](../../../../docs/framework/wcf/feature-details/media/argumentbind.JPG "ArgumentBind")  
+  
+10. サービス呼び出しによって返された文字列を表示するために、**Echo** アクティビティの下に **WriteLine** アクティビティをドラッグ アンド ドロップします。**WriteLine** アクティビティは、ツールボックスの **\[プリミティブ\]** ノードにあります。**WriteLine** アクティビティのテキスト ボックスに「`outString`」と入力し、**WriteLine** アクティビティの **Text** 引数を `outString` 変数にバインドします。この時点で、ワークフローは次の図のようになります。  
+  
+     ![完全なクライアント ワークフロー](../../../../docs/framework/wcf/feature-details/media/completeclientwf.JPG "CompleteClientWF")  
+  
+11. MyWFService ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。次の図のように、**\[マルチ スタートアップ プロジェクト\]** ボタンを選択し、各プロジェクトの **\[アクション\]** 列で **\[開始\]** を選択します。  
+  
+     ![スタートアップ プロジェクトのオプション](../../../../docs/framework/wcf/feature-details/media/startupprojects.JPG "StartupProjects")  
+  
+12. Ctrl キーを押しながら F5 キーを押し、サービスとクライアントの両方を起動します。ASP.NET 開発サーバーがサービスをホストし、Internet Explorer に WCF ヘルプ ページが表示され、コンソール ウィンドウでクライアント ワークフロー アプリケーションが起動して、サービスから返された文字列 \("Hello, world"\) が表示されます。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)   
+ [Web プロジェクトでのワークフローからの WCF サービスの使用](http://go.microsoft.com/fwlink/?LinkId=207725)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md b/docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md
new file mode 100644
index 00000000000..9950803893e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : WCF クライアントで WSE 3.0 サービスにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f9bcd9b-8f8f-47fa-8f1e-0d47236eb800
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : WCF クライアントで WSE 3.0 サービスにアクセスする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントが WS-Addressing 仕様の 2004 年 8 月版を使用するように構成されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは Microsoft .NET サービスの Web サービス拡張 (WSE: Web Services Enhancements) 3.0 とネットワーク レベルの互換性があります。 ただし、WSE 3.0 サービスは、メタデータ交換 (MEX) プロトコルをサポートしないので使用すると、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)を作成する、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアント クラスでは、セキュリティ設定が適用され、生成された[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントです。 そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの生成後に、WSE 3.0 サービスで必要なセキュリティ設定を指定する必要があります。  
+  
+ カスタム バインディングを使用してこれらのセキュリティ設定を適用することにより、WSE 3.0 サービスの要件、および WSE 3.0 サービスと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントとの相互運用性の要件を考慮に入れることができます。 これらの相互運用性要件には、2004 年 8 月の前述の使用が含まれます。 メッセージの保護の Ws-addressing 仕様と WSE 3.0default <xref:System.ServiceModel.Security.MessageProtectionOrder>します。 既定のメッセージ保護[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]は<xref:System.ServiceModel.Security.MessageProtectionOrder>します。 このトピックでは、WSE 3.0 サービスと相互運用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングの作成方法について詳しく説明します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このバインディングが組み込まれたサンプルも用意されています。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]このサンプルを参照してください[ASMX Web サービスとの相互運用](../../../../docs/framework/wcf/samples/interoperating-with-asmx-web-services.md)します。  
+  
+### <a name="to-access-a-wse-30-web-service-with-a-wcf-client"></a>WCF クライアントで WSE 3.0 サービスにアクセスするには  
+  
+1.  実行、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)を作成する、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WSE 3.0 Web サービスのクライアントです。  
+  
+     WSE 3.0 Web サービスに対して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが作成されます。 WSE 3.0 は MEX プロトコルをサポートしていないため、このツールを使用して Web サービスのセキュリティ要件を取得することはできません。 アプリケーション開発者は、クライアントのセキュリティ設定を追加する必要があります。  
+  
+     [!INCLUDE[crabout](../../../../includes/crabout-md.md)]作成する、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントを参照してください、[方法: クライアントを作成する](../../../../docs/framework/wcf/how-to-create-a-wcf-client.md)です。  
+  
+2.  WSE 3.0 Web サービスと通信できるバインディングを表すクラスを作成します。  
+  
+     次のクラスの一部である、 [WSE との相互運用](http://msdn.microsoft.com/ja-jp/f6816861-96a0-45f9-8736-8e4e82cd3a41)サンプル。  
+  
+    1.  派生したクラスを作成、<xref:System.ServiceModel.Channels.Binding>クラスです。  
+  
+         次のコード例は、という名前のクラスを作成`WseHttpBinding`から派生した、<xref:System.ServiceModel.Channels.Binding>クラスです。  
+  
+         [!code-csharp[c_WCFClientToWSEService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#1)]
+         [!code-vb[c_WCFClientToWSEService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#1)]  
+  
+    2.  WSE サービスで使用する WSE 設定不要アサーション、派生キーが必要かどうか、セキュリティで保護されたセッションを使用するかどうか、署名の確認が必要かどうか、およびメッセージ保護設定を指定するプロパティを、このクラスに追加します。 WSE 3.0 では、設定不要アサーションはクライアントまたは Web サービスのセキュリティ要件を指定します。これらのセキュリティ要件は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のバインディングの認証モードに似ています。  
+  
+         WSE 設定不要アサーション、派生キーが必要かどうか、セキュリティで保護されたセッションを使用するかどうか、署名の確認が必要かどうか、およびメッセージ保護設定をそれぞれ指定する、`SecurityAssertion`、`RequireDerivedKeys`、`EstablishSecurityContext`、および `MessageProtectionOrder` の各プロパティを定義するコード例を次に示します。  
+  
+         [!code-csharp[c_WCFClientToWSEService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#3)]
+         [!code-vb[c_WCFClientToWSEService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#3)]  
+  
+    3.  オーバーライド、 <xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A>バインドのプロパティを設定します。  
+  
+         `SecurityAssertion` プロパティと `MessageProtectionOrder` プロパティの値を取得することで、トランスポート、メッセージ エンコーディング、メッセージ保護設定を指定するコード例を次に示します。  
+  
+         [!code-csharp[c_WCFClientToWSEService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#2)]
+         [!code-vb[c_WCFClientToWSEService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#2)]  
+  
+3.  クライアントのアプリケーション コードでは、コードを追加してバインディングのプロパティを設定します。  
+  
+     WSE 3.0 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の設定不要なセキュリティ アサーションで定義されているように、メッセージの保護と認証を使用しなければならない `AnonymousForCertificate` クライアントを指定するコード例を次に示します。 また、セキュリティで保護されたセッションと派生キーが必要です。  
+  
+     [!code-csharp[c_WCFClientToWSEService#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/client.cs#4)]
+     [!code-vb[c_WCFClientToWSEService#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/client.vb#4)]  
+  
+## <a name="example"></a>例  
+ WSE 3.0 の設定不要のセキュリティ アサーションのプロパティに対応するプロパティを公開するカスタムのバインディングを定義するコード例を次に示します。 この `WseHttpBinding` という名前のカスタムのバインディングは、WSSecurityAnonymous WSE 3.0 QuickStart のサンプルと通信する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのバインディング プロパティの指定に使用されます。  
+  
+  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Channels.Binding>   
+ [WSE との相互運用](http://msdn.microsoft.com/ja-jp/f6816861-96a0-45f9-8736-8e4e82cd3a41)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md b/docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md
new file mode 100644
index 00000000000..6ecd6a1df91
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : 双方向コントラクトを使用してサービスにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "双方向コントラクト [WCF]"
+ms.assetid: 746a9d64-f21c-426c-b85d-972e916ec6c5
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : 双方向コントラクトを使用してサービスにアクセスする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の機能の 1 つに、双方向のメッセージング パターンを使用するサービスを作成する機能があります。双方向のメッセージング パターンを使用するサービスは、コールバックを通じてクライアントと通信できます。ここでは、コールバック インターフェイスを実装するクライアント クラス内に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成する手順を示します。  
+  
+ 二重バインディングでは、クライアントの IP アドレスをサービスに公開します。クライアントは、セキュリティを使用して信頼するサービスだけに接続できるようにする必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の基本的なサービスとクライアントの作成方法に関するチュートリアルについては、「[チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+### 双方向サービスにアクセスするには  
+  
+1.  2 つのインターフェイスを含むサービスを作成します。1 つ目のインターフェイスはサービスに使用し、2 つ目のインターフェイスはコールバックに使用します。双方向サービスを作成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+2.  サービスを実行します。  
+  
+3.  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、クライアントのコントラクト \(インターフェイス\) を生成します。これを実行する方法については、「[方法 : クライアントを作成する](../../../../docs/framework/wcf/how-to-create-a-wcf-client.md)」を参照してください。  
+  
+4.  次の例に示すように、クライアント クラスにコールバック インターフェイスを実装します。  
+  
+    ```csharp  
+    public class CallbackHandler : ICalculatorDuplexCallback  
+    {  
+        public void Result(double result)  
+        {  
+            Console.WriteLine("Result ({0})", result);  
+        }  
+        public void Equation(string equation)  
+        {  
+            Console.WriteLine("Equation({0})", equation);  
+        }  
+    }  
+    ```  
+  
+    ```vb  
+    Public Class CallbackHandler   
+    Implements ICalculatorDuplexCallback  
+       Public Sub Result (ByVal result As Double)  
+          Console.WriteLine("Result ({0})", result)  
+       End Sub  
+        Public Sub Equation(ByVal equation As String)  
+            Console.Writeline("Equation({0})", equation)  
+        End Sub  
+    End Class  
+  
+    ```  
+  
+5.  <xref:System.ServiceModel.InstanceContext> クラスのインスタンスを作成します。コンストラクターには、クライアント クラスのインスタンスが必要です。  
+  
+    ```csharp  
+    InstanceContext site = new InstanceContext(new CallbackHandler());  
+    ```  
+  
+    ```vb  
+    Dim site As InstanceContext = New InstanceContext(new CallbackHandler())  
+    ```  
+  
+6.  <xref:System.ServiceModel.InstanceContext> オブジェクトを必要とするコンストラクターを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのインスタンスを作成します。コンストラクターの 2 番目のパラメーターは、構成ファイルに含まれるエンドポイントの名前です。  
+  
+    ```csharp  
+    CalculatorDuplexClient wcfClient =   
+    new CalculatorDuplexClient(site, "default")  
+    ```  
+  
+    ```vb  
+    Dim wcfClient As New CalculatorDuplexClient(site, "default")  
+    ```  
+  
+7.  必要に応じて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのメソッドを呼び出します。  
+  
+## 使用例  
+ 双方向コントラクトにアクセスするクライアント クラスを作成する方法を次のコード例に示します。  
+  
+ [!code-csharp[S_DuplexClients#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_duplexclients/cs/client.cs#1)]
+ [!code-vb[S_DuplexClients#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_duplexclients/vb/client.vb#1)]  
+  
+## .NET Framework セキュリティ  
+  
+## 参照  
+ [チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)   
+ [方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [方法 : クライアントを作成する](../../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [方法 : ChannelFactory を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md b/docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md
new file mode 100644
index 00000000000..4e9e72fab12
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md
@@ -0,0 +1,416 @@
+---
+title: "方法 : 一方向コントラクトと要求/応答コントラクトを使用して WCF サービスにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e10d3a5-fcf4-4a4b-a8d6-92ee2c988b3b
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : 一方向コントラクトと要求/応答コントラクトを使用して WCF サービスにアクセスする
+次の手順では、一方向コントラクトと要求/応答コントラクトを定義し、双方向通信パターンを使用しない [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスにアクセスする方法を説明します。  
+  
+### <a name="to-define-the-service"></a>サービスを定義するには  
+  
+1.  サービス コントラクトを宣言します。 一方向では、操作が必要`IsOneWay`設定`true`内で、 <xref:System.ServiceModel.OperationContractAttribute>します。 次のコードは、`IOneWayCalculator`、`Add`、`Subtract`、および `Multiply` に対して一方向の操作を行う `Divide` コントラクトを宣言します。 また、`SayHello` という要求応答操作も定義します。  
+  
+    ```  
+    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+    public interface IOneWayCalculator  
+    {  
+        [OperationContract(IsOneWay = true)]  
+        void Add(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Subtract(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Multiply(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Divide(double n1, double n2);  
+        [OperationContract]  
+        string SayHello(string name);  
+    }  
+    ```  
+  
+2.  サービス コントラクトを実装します。 次のコードは `IOnewayCalculator` インターフェイスを実装します。  
+  
+    ```  
+    [ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple, InstanceContextMode = InstanceContextMode.PerCall)]  
+    public class CalculatorService : IOneWayCalculator  
+    {  
+        public void Add(double n1, double n2)  
+        {  
+           double result = n1 + n2;  
+           Console.WriteLine("Add({0},{1}) = {2} ", n1, n2, result);  
+        }  
+  
+        public void Subtract(double n1, double n2)  
+        {  
+           double result = n1 - n2;  
+           Console.WriteLine("Subtract({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public void Multiply(double n1, double n2)  
+        {  
+            double result = n1 * n2;  
+            Console.WriteLine("Multiply({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public void Divide(double n1, double n2)  
+        {  
+            double result = n1 / n2;  
+            Console.WriteLine("Divide({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public string SayHello(string name)  
+        {  
+            Console.WriteLine("SayHello({0})", name);  
+            return "Hello " + name;  
+        }  
+    }  
+    ```  
+  
+3.  コンソール アプリケーションでサービスをホストします。 次のコードはサービスをホストする方法を示しています。  
+  
+    ```  
+    // Host the service within this EXE console application.  
+    public static void Main()  
+    {  
+       // Define the base address for the service.  
+       Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");  
+  
+       // Create a ServiceHost for the CalculatorService type and provide the base address.  
+       using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+       {  
+            // Add an endpoint using the IOneWayCalculator contract and the WSHttpBinding  
+            serviceHost.AddServiceEndpoint(typeof(IOneWayCalculator), new WSHttpBinding(), "");  
+  
+          // Turn on the metadata behavior, this allows svcutil to get metadata for the service.  
+          ServiceMetadataBehavior smb = (ServiceMetadataBehavior) serviceHost.Description.Behaviors.Find<ServiceMetadataBehavior>();  
+          if (smb == null)  
+          {  
+                smb = new ServiceMetadataBehavior();  
+                smb.HttpGetEnabled = true;  
+                serviceHost.Description.Behaviors.Add(smb);  
+          }  
+  
+          // Open the ServiceHostBase to create listeners and start listening for messages.  
+          serviceHost.Open();  
+  
+          // The service can now be accessed.  
+          Console.WriteLine("The service is ready.");  
+          Console.WriteLine("Press <ENTER> to terminate service.");  
+          Console.WriteLine();  
+          Console.ReadLine();  
+        }  
+    }  
+    ```  
+  
+### <a name="to-access-the-service"></a>サービスにアクセスするには  
+  
+1.  実行、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)メタデータ交換エンドポイント アドレスを使用して、次のコマンドラインを使用して、サービスのクライアント クラスを作成する: `Svcutil http://localhost:8000/Service` 、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)の次のサンプル コードに示すように、インターフェイスとクラスのセットを生成します。  
+  
+    ```  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]  
+    [System.ServiceModel.ServiceContractAttribute(Namespace="http://Microsoft.ServiceModel.Samples", ConfigurationName="IOneWayCalculator")]  
+    public interface IOneWayCalculator  
+    {  
+  
+        [System.ServiceModel.OperationContractAttribute(IsOneWay=true, Action="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/Add")]  
+        void Add(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(IsOneWay=true, Action="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/Subtract")]  
+        void Subtract(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(IsOneWay=true, Action="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/Multiply")]  
+        void Multiply(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(IsOneWay=true, Action="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/Divide")]  
+        void Divide(double n1, double n2);  
+  
+        [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/SayHello", ReplyAction="http://Microsoft.ServiceModel.Samples/IOneWayCalculator/SayHelloResponse")]  
+        string SayHello(string name);  
+    }  
+  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]  
+    public interface IOneWayCalculatorChannel : IOneWayCalculator, System.ServiceModel.IClientChannel  
+    {  
+    }  
+  
+    [System.Diagnostics.DebuggerStepThroughAttribute()]  
+    [System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]  
+    public partial class OneWayCalculatorClient : System.ServiceModel.ClientBase<IOneWayCalculator>, IOneWayCalculator  
+    {  
+  
+        public OneWayCalculatorClient()  
+        {  
+        }  
+  
+        public OneWayCalculatorClient(string endpointConfigurationName) :   
+                base(endpointConfigurationName)  
+        {  
+        }  
+  
+        public OneWayCalculatorClient(string endpointConfigurationName, string remoteAddress) :   
+                base(endpointConfigurationName, remoteAddress)  
+        {  
+        }  
+  
+        public OneWayCalculatorClient(string endpointConfigurationName, System.ServiceModel.EndpointAddress remoteAddress) :   
+                base(endpointConfigurationName, remoteAddress)  
+        {  
+        }  
+  
+        public OneWayCalculatorClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress remoteAddress) :   
+                base(binding, remoteAddress)  
+        {  
+        }  
+  
+        public void Add(double n1, double n2)  
+        {  
+            base.Channel.Add(n1, n2);  
+        }  
+  
+        public void Subtract(double n1, double n2)  
+        {  
+            base.Channel.Subtract(n1, n2);  
+        }  
+  
+        public void Multiply(double n1, double n2)  
+        {  
+            base.Channel.Multiply(n1, n2);  
+        }  
+  
+        public void Divide(double n1, double n2)  
+        {  
+            base.Channel.Divide(n1, n2);  
+        }  
+  
+        public string SayHello(string name)  
+        {  
+            return base.Channel.SayHello(name);  
+        }  
+    }  
+  
+    ```  
+  
+     `IOneWayCalculator`一方向サービス操作があるインターフェイス、 <xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A>属性に設定`true`要求/応答サービス操作には、既定値に設定された属性が必要があると`false`です。 また、`OneWayCalculatorClient` クラスにも注目してください。 これはサービスを呼び出すために使用するクラスです。  
+  
+2.  クライアント オブジェクトを作成します。  
+  
+    ```  
+    // Create a client  
+    WSHttpBinding binding = new WSHttpBinding();  
+    EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/servicemodelsamples/service");  
+    OneWayCalculatorClient client = new OneWayCalculatorClient(binding, epAddress);  
+  
+    ```  
+  
+3.  サービス操作を呼び出します。  
+  
+    ```  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    client.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1})", value1, value2);  
+  
+    // Call the Subtract service operation.  
+    value1 = 145.00D;  
+    value2 = 76.54D;  
+    client.Subtract(value1, value2);  
+    Console.WriteLine("Subtract({0},{1})", value1, value2);  
+  
+    // Call the Multiply service operation.  
+    value1 = 9.00D;  
+    value2 = 81.25D;  
+    client.Multiply(value1, value2);  
+    Console.WriteLine("Multiply({0},{1})", value1, value2);  
+  
+    // Call the Divide service operation.  
+    value1 = 22.00D;  
+    value2 = 7.00D;  
+    client.Divide(value1, value2);  
+    Console.WriteLine("Divide({0},{1})", value1, value2);  
+  
+    // Call the SayHello service operation  
+    string name = "World";  
+    string response = client.SayHello(name);  
+    Console.WriteLine("SayHello([0])", name);  
+    Console.WriteLine("SayHello() returned: " + response);  
+  
+    ```  
+  
+4.  クライアントを閉じて接続を終了し、リソースをクリーンアップします。  
+  
+    ```  
+    //Closing the client gracefully closes the connection and cleans up resources  
+    client.Close();  
+  
+    ```  
+  
+## <a name="example"></a>例  
+ このトピックで使用されているコードの完全な一覧を次に示します。  
+  
+```  
+// Service.cs  
+using System;  
+using System.Configuration;  
+using System.ServiceModel;  
+using System.ServiceModel.Description;  
+  
+namespace Microsoft.ServiceModel.Samples  
+{  
+    // Define a service contract.   
+    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+    public interface IOneWayCalculator  
+    {  
+        [OperationContract(IsOneWay = true)]  
+        void Add(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Subtract(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Multiply(double n1, double n2);  
+        [OperationContract(IsOneWay = true)]  
+        void Divide(double n1, double n2);  
+        [OperationContract]  
+        string SayHello(string name);  
+    }  
+  
+    // Service class which implements the service contract.  
+    // Added code to write output to the console window  
+    [ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple, InstanceContextMode = InstanceContextMode.PerCall)]  
+    public class CalculatorService : IOneWayCalculator  
+    {  
+        public void Add(double n1, double n2)  
+        {  
+            double result = n1 + n2;  
+            Console.WriteLine("Add({0},{1}) = {2} ", n1, n2, result);  
+        }  
+  
+        public void Subtract(double n1, double n2)  
+        {  
+            double result = n1 - n2;  
+            Console.WriteLine("Subtract({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public void Multiply(double n1, double n2)  
+        {  
+            double result = n1 * n2;  
+            Console.WriteLine("Multiply({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public void Divide(double n1, double n2)  
+        {  
+            double result = n1 / n2;  
+            Console.WriteLine("Divide({0},{1}) = {2}", n1, n2, result);  
+        }  
+  
+        public string SayHello(string name)  
+        {  
+            Console.WriteLine("SayHello({0})", name);  
+            return "Hello " + name;  
+        }  
+  
+        // Host the service within this EXE console application.  
+        public static void Main()  
+        {  
+            // Define the base address for the service.  
+            Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");  
+  
+            // Create a ServiceHost for the CalculatorService type and provide the base address.  
+            using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+            {  
+                // Add an endpoint using the IOneWayCalculator contract and the WSHttpBinding  
+                serviceHost.AddServiceEndpoint(typeof(IOneWayCalculator), new WSHttpBinding(), "");  
+  
+                // Turn on the metadata behavior, this allows svcutil to get metadata for the service.  
+                ServiceMetadataBehavior smb = (ServiceMetadataBehavior) serviceHost.Description.Behaviors.Find<ServiceMetadataBehavior>();  
+                if (smb == null)  
+                {  
+                    smb = new ServiceMetadataBehavior();  
+                    smb.HttpGetEnabled = true;  
+                    serviceHost.Description.Behaviors.Add(smb);  
+                }  
+  
+                // Open the ServiceHostBase to create listeners and start listening for messages.  
+                serviceHost.Open();  
+  
+                // The service can now be accessed.  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+            }  
+        }  
+    }  
+}  
+  
+// client.cs  
+using System;  
+using System.ServiceModel;  
+  
+namespace Microsoft.ServiceModel.Samples  
+{  
+    //The service contract is defined in generatedClient.cs, generated from the service by the svcutil tool.  
+  
+    //Client implementation code.  
+    class Client  
+    {  
+        static void Main()  
+        {  
+            // Create a client  
+            WSHttpBinding binding = new WSHttpBinding();  
+            EndpointAddress epAddress = new EndpointAddress("http://localhost:8000/servicemodelsamples/service");  
+            OneWayCalculatorClient client = new OneWayCalculatorClient(binding, epAddress);  
+  
+            // Call the Add service operation.  
+            double value1 = 100.00D;  
+            double value2 = 15.99D;  
+            client.Add(value1, value2);  
+            Console.WriteLine("Add({0},{1})", value1, value2);  
+  
+            // Call the Subtract service operation.  
+            value1 = 145.00D;  
+            value2 = 76.54D;  
+            client.Subtract(value1, value2);  
+            Console.WriteLine("Subtract({0},{1})", value1, value2);  
+  
+            // Call the Multiply service operation.  
+            value1 = 9.00D;  
+            value2 = 81.25D;  
+            client.Multiply(value1, value2);  
+            Console.WriteLine("Multiply({0},{1})", value1, value2);  
+  
+            // Call the Divide service operation.  
+            value1 = 22.00D;  
+            value2 = 7.00D;  
+            client.Divide(value1, value2);  
+            Console.WriteLine("Divide({0},{1})", value1, value2);  
+  
+            // Call the SayHello service operation  
+            string name = "World";  
+            string response = client.SayHello(name);  
+            Console.WriteLine("SayHello([0])", name);  
+            Console.WriteLine("SayHello() returned: " + response);  
+            //Closing the client gracefully closes the connection and cleans up resources  
+            client.Close();  
+  
+        }  
+    }  
+}  
+  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## <a name="see-also"></a>関連項目  
+ [一方向サービス](../../../../docs/framework/wcf/feature-details/one-way-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md b/docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md
new file mode 100644
index 00000000000..ca2bbee9bc4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md
@@ -0,0 +1,109 @@
+---
+title: "方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b05c1742-8d0a-4673-9d71-725b18a3008e
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、クライアント Web サイトの JavaScript から呼び出される ASP.NET AJAX 対応のエンドポイントを公開するサービスを作成できます。 このようなエンドポイントを作成するには、他のすべての WCF エンドポイントと同様に、構成ファイルを使用するか、または構成要素を必要としないメソッドを使用することができます。 ここでは、2 番目の方法について説明します。  
+  
+ 構成を使用せずに ASP.NET AJAX エンドポイントを持つサービスを作成するには、サービスがインターネット インフォメーション サービス (IIS) でホストされている必要があります。 このアプローチを使用して ASP.NET AJAX エンドポイントを有効にするには指定、 <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>にある Factory パラメーターとして、 [ @ServiceHost ](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) .svc ファイル ディレクティブです。 このカスタム ファクトリは自動的に ASP.NET AJAX エンドポイントを構成するコンポーネントであるため、クライアント Web サイトの JavaScript から呼び出すことができます。  
+  
+ 実施例については、次を参照してください。、[サービスを構成せず AJAX](../../../../docs/framework/wcf/samples/ajax-service-without-configuration.md)します。  
+  
+ 構成要素を使用して ASP.NET AJAX エンドポイントを構成する方法の概要を参照してください。[方法: ASP.NET AJAX エンドポイントを追加する構成を使用して](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)します。  
+  
+### <a name="to-create-a-basic-wcf-service"></a>基本的な WCF サービスを作成するには  
+  
+1.  基本的な定義[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]でマークされたサービス コントラクト インターフェイスを<xref:System.ServiceModel.ServiceContractAttribute>属性です。 各操作にマークを付ける、 <xref:System.ServiceModel.OperationContractAttribute>します。 設定して、 <xref:System.ServiceModel.ServiceContractAttribute.Namespace%2A>プロパティです。  
+  
+    ```  
+    [ServiceContract(Namespace = "MyService")]]  
+    public interface ICalculator  
+    {  
+        [OperationContract]  
+        // This operation returns the sum of d1 and d2.  
+        double Add(double n1, double n2);  
+  
+        //Other operations omitted…  
+  
+    }  
+    ```  
+  
+2.  `ICalculator` を使用して、`CalculatorService` サービス コントラクトを実装します。  
+  
+    ```  
+    public class CalculatorService : ICalculator  
+    {  
+        public double Add(double n1, double n2)  
+        {  
+            return n1 + n2;  
+        }  
+  
+    //Other operations omitted…  
+    ```  
+  
+3.  名前空間ブロック内にラップすることにより、`ICalculator` と `CalculatorService` の実装の名前空間を定義します。  
+  
+    ```  
+    Namespace Microsoft.Ajax.Samples  
+    {  
+        //Include the code for ICalculator and Caculator here.  
+    }  
+    ```  
+  
+### <a name="to-host-the-service-in-internet-information-services-without-configuration"></a>構成を使用せずにインターネット インフォメーション サービスでサービスをホストするには  
+  
+1.  アプリケーションで、.svc という拡張子を付けて新しい service ファイルを作成します。 このファイルを編集するには、追加、適切な[ @ServiceHost ](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md)ディレクティブ情報をサービスします。 指定する、 <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>で使用するのには、 [ @ServiceHost ](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md)ディレクティブで使用すると、自動的に ASP.NET AJAX エンドポイントを構成します。  
+  
+    ```  
+    <%@ServiceHost   
+        language=c#   
+        Debug="true"   
+        Service="Microsoft.Ajax.Samples.CalculatorService"  
+        Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory  
+    %>  
+    ```  
+  
+2.  サービスをビルドしてクライアントから呼び出します。 呼び出されたサービスがインターネット インフォメーション サービス (IIS) によってアクティブ化されます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]IIS では、ホストを参照してください[方法: IIS で WCF サービスをホスト](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)します。  
+  
+### <a name="to-call-the-service"></a>サービスを呼び出すには  
+  
+1.  .Svc ファイルに相対する空のアドレスでエンドポイントが構成されて、サービスを使用できるよう、に対してに要求を送信することによって呼び出すことがため<>\> - たとえば、service.svc/Add の`Add`操作します。 これは、ASP.NET AJAX Script Manager コントロールのスクリプト コレクションにサービス URL を入力することで使用できます。 例については、次を参照してください。、[サービスを構成せず AJAX](../../../../docs/framework/wcf/samples/ajax-service-without-configuration.md)します。  
+  
+## <a name="example"></a>例  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+ 自動的に構成されたエンドポイントは、ベース URL に対して相対的に空のアドレスの位置に作成されます。 この方法では、構成ファイルを追加して使用することもできます。 構成ファイルにエンドポイントの定義がある場合、これらのエンドポイントは自動的に構成されたエンドポイントに追加されます。  
+  
+ たとえば、service.svc が使用して、 <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>サービス ディレクトリを使用して同じサービスのエンドポイントを定義する Web.config ファイルが含まれている、 <xref:System.ServiceModel.BasicHttpBinding> "soap"の相対アドレスにします。 この場合、サービスには、service.svc に含まれるエンドポイント (ASP.NET AJAX 要求に応答) と、service.svc/soap にあるもう&1; つのエンドポイント (SOAP 要求に応答) の&2; つのエンドポイントが含まれることになります。  
+  
+ 構成ファイルが空の相対アドレスにエンドポイントを定義するかどうか、 <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>は、使用、例外がスローされ、サービスの開始に失敗します。  
+  
+ 自動的に構成されるエンドポイントの設定を変更するために構成を使用することはできません。 リーダーのクォータなど、設定の有効期限があります変更されると、使用しないでください構成を必要としないアプローチを削除して、 <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> .svc ファイルと、エンドポイントの構成エントリを作成するからです。  
+  
+ サービスが必要な場合 ASP.NET 互換モード - たとえば、使用されている場合、 <xref:System.Web.HttpContext>クラスや ASP.NET 承認機構構成ファイルは、このモードを有効にするために必要です。 必要な構成要素は、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md)要素は、次のように追加する必要があります。  
+  
+ `<system.serviceModel>`  
+  
+ `<serviceHostingEnvironment aspNetCompatibilityEnabled=”true” /> </system.serviceModel>`  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)トピックです。  
+  
+ <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory>クラスの派生クラスは、 <xref:System.ServiceModel.Activation.ServiceHostFactory>します。 サービス ホスト ファクトリ機構の詳細については、次を参照してください。、[を使用して ServiceHostFactory のホストを拡張する](../../../../docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md)トピックです。  
+  
+## <a name="see-also"></a>関連項目  
+ [ASP.NET AJAX の WCF サービスを作成します。](../../../../docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md)   
+ [方法: AJAX 対応 ASP.NET Web サービスを WCF に移行します。](../../../../docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-allow-metadata-requests-while-authorizing.md b/docs/framework/wcf/feature-details/how-to-allow-metadata-requests-while-authorizing.md
new file mode 100644
index 00000000000..9d0863d7658
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-allow-metadata-requests-while-authorizing.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 承認中にメタデータ要求を許可する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "承認中のメタデータ要求の許可 [WCF]"
+ms.assetid: 90cec34f-b619-452b-a056-8b1c0de49d05
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : 承認中にメタデータ要求を許可する
+カスタム承認中に、メタデータの処理要求を許可することがあります。ここでは、このような要求を検証する手順を示します。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の承認[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)」を参照してください。  
+  
+### 承認中にメタデータ要求を許可するには  
+  
+1.  <xref:System.ServiceModel.ServiceAuthorizationManager> クラスの拡張を作成します。  
+  
+2.  <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッドをオーバーライドします。このメソッドは、承認が許可されるかどうかによって、`true` または `false` を返します。現在のプロシージャに関する情報は、メソッドへのパラメーターとして渡される <xref:System.ServiceModel.OperationContext> にあります。  
+  
+3.  オーバーライドで、コントラクト名、名前空間、およびアクションを確認します。次の例を参照してください。条件が有効な場合は、`true` を返します。  
+  
+4.  クラスを使用するための拡張ポイントを使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md).  
+  
+## 使用例  
+ <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッドを上書きする方法を次の例に示します。  
+  
+ [!code-csharp[C_HowtoCheckForMexRequestsInAuthorization#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtocheckformexrequestsinauthorization/cs/source.cs#1)]
+ [!code-vb[C_HowtoCheckForMexRequestsInAuthorization#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtocheckformexrequestsinauthorization/vb/source.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceAuthorizationManager>   
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)   
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md b/docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md
new file mode 100644
index 00000000000..afcc3361c37
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : Windows Communication Foundation セキュリティ イベントを監査する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], イベントの監査"
+ms.assetid: e71e9587-3336-46a2-9a9e-d72a1743ecec
+caps.latest.revision: 19
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 19
+---
+# 方法 : Windows Communication Foundation セキュリティ イベントを監査する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] にはセキュリティ イベントを Windows イベント ログに記録する機能があります。これは Windows イベント ビューアーに表示できます。  このトピックでは、セキュリティ イベントをログ出力するようにアプリケーションを設定する方法について説明します。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 監査については、「[監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)」を参照してください。  
+  
+### セキュリティ イベントを監査するコードを記述するには  
+  
+1.  監査ログの場所を指定します。  それには、次のコードに示すように、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> クラスの <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.AuditLogLocation%2A> プロパティに <xref:System.ServiceModel.AuditLogLocation> 列挙体のいずれかの値を設定します。  
+  
+     [!code-csharp[AuditingSecurityEvents#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/auditingsecurityevents/cs/auditingsecurityevents.cs#2)]
+     [!code-vb[AuditingSecurityEvents#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/auditingsecurityevents/vb/auditingsecurityevents.vb#2)]  
+  
+     <xref:System.ServiceModel.AuditLogLocation> 列挙体には `Application`、`Security`、および `Default` の 3 つの値が定義されています。  これは、イベント ビューアーを開いたとき、セキュリティ ログとアプリケーション ログのどちらが表示されるかを表します。  `Default` を指定した場合の動作は、アプリケーションが稼働するオペレーティング システムに依存します。  ログの場所を指定せずに監査機能を有効にした場合、セキュリティ ログに書き込み可能なプラットフォームであれば `Security` ログに、そうでなければ `Application` ログに出力するようになります。  セキュリティ ログへの書き込みが可能なのは、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wv](../../../../includes/wv-md.md)] に限ります。  
+  
+2.  イベントの種類を監査対象として設定します。  サービス レベルのイベントとメッセージ レベルの承認イベントを同時に監査できます。  それには、次のコードに示すように、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.ServiceAuthorizationAuditLevel%2A> プロパティまたは <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.MessageAuthenticationAuditLevel%2A> プロパティに <xref:System.ServiceModel.AuditLevel> 列挙体のいずれかの値を設定します。  
+  
+     [!code-csharp[AuditingSecurityEvents#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/auditingsecurityevents/cs/auditingsecurityevents.cs#3)]
+     [!code-vb[AuditingSecurityEvents#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/auditingsecurityevents/vb/auditingsecurityevents.vb#3)]  
+  
+3.  ログ監査イベントに関して、単に無視してアプリケーションの処理を続行するか、それとも失敗を通知するかを設定します。  次のコードに示すように、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure%2A> プロパティに `true` または `false` を設定します。  
+  
+     [!code-csharp[AuditingSecurityEvents#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/auditingsecurityevents/cs/auditingsecurityevents.cs#4)]
+     [!code-vb[AuditingSecurityEvents#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/auditingsecurityevents/vb/auditingsecurityevents.vb#4)]  
+  
+     `SuppressAuditFailure` プロパティの既定値は `true` なので、監査に失敗してもアプリケーションには影響しません。  それ以外の場合は、例外がスローされます。  正常な監査に関するログは、Verbose レベルで出力されます。  異常発生時には、Error レベルでトレースが出力されます。  
+  
+4.  既存の <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> を、<xref:System.ServiceModel.ServiceHost> の説明にある動作のコレクションから削除します。  動作のコレクションは、<xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A> プロパティからアクセスできます。また、<xref:System.ServiceModel.ServiceHostBase.Description%2A> プロパティからもアクセスできます。  その後、次のコードに示すように、新しい <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> を同じコレクションに追加します。  
+  
+     [!code-csharp[AuditingSecurityEvents#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/auditingsecurityevents/cs/auditingsecurityevents.cs#5)]
+     [!code-vb[AuditingSecurityEvents#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/auditingsecurityevents/vb/auditingsecurityevents.vb#5)]  
+  
+### 構成ファイルで監査を設定するには  
+  
+1.  構成ファイルで監査を設定するには、web.config ファイルの [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) セクションに [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md) 要素を追加します。  その後、次の例に示すように、[\<serviceSecurityAudit\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md) 要素を追加し、必要な属性を設定します。  
+  
+    ```  
+    <behaviors>  
+       <behavior name="myAuditBehavior">  
+          <serviceSecurityAudit auditLogLocation="Application"  
+                suppressAuditFailure="false"   
+                serviceAuthorizationAuditLevel="None"   
+                messageAuthenticationAuditLevel="SuccessOrFailure" />  
+          </behavior>  
+    </behaviors>  
+    ```  
+  
+2.  次の例に示すように、サービスに対して動作を指定する必要があります。  
+  
+    ```  
+    <services>  
+        <service type="WCS.Samples.Service.Echo"   
+        behaviorConfiguration=" myAuditBehavior">  
+           <endpoint address=""  
+                    binding="wsHttpBinding"  
+                    bindingConfiguration="CertificateDefault"   
+                    contract="WCS.Samples.Service.IEcho" />  
+        </service>  
+    </services>  
+  
+    ```  
+  
+## 使用例  
+ <xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成し、新しい <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> をその動作のコレクションに追加するコード例を次に示します。  
+  
+ [!code-csharp[AuditingSecurityEvents#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/auditingsecurityevents/cs/auditingsecurityevents.cs#1)]
+ [!code-vb[AuditingSecurityEvents#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/auditingsecurityevents/vb/auditingsecurityevents.vb#1)]  
+  
+## .NET Framework セキュリティ  
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.SuppressAuditFailure%2A> プロパティを `true` に設定すると、セキュリティ監査を生成する失敗が抑制されます \(`false` に設定した場合は、例外がスローされます\)。  ただし、次の Windows の **"ローカル セキュリティ設定"** プロパティを有効にした場合、監査イベントを生成する失敗により Windows が直ちにシャットダウンします。  
+  
+ **監査 : セキュリティ監査を記録できない場合システムを直ちにシャット ダウンします。**  
+  
+ プロパティを設定するには、**\[ローカル セキュリティ 設定\]** ダイアログ ボックスを開きます。  **\[セキュリティの設定\]** の **\[ローカル ポリシー\]** フォルダーをクリックします。  次に、**\[セキュリティ オプション\]** をクリックします。  
+  
+ <xref:System.ServiceModel.AuditLogLocation> プロパティが <xref:System.ServiceModel.AuditLogLocation> に設定されている場合で、**\[オブジェクト アクセスの監査\]** が **\[ローカル セキュリティ ポリシー\]** で設定されていないときは、監査イベントはセキュリティ ログに書き込まれません。  エラーが返らない場合でも、監査エントリはセキュリティ ログに書き込まれません。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior.AuditLogLocation%2A>   
+ <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>   
+ <xref:System.ServiceModel.AuditLogLocation>   
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-authenticate-with-a-user-name-and-password.md b/docs/framework/wcf/feature-details/how-to-authenticate-with-a-user-name-and-password.md
new file mode 100644
index 00000000000..8696223f7cf
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-authenticate-with-a-user-name-and-password.md
@@ -0,0 +1,103 @@
+---
+title: "方法 : ユーザー名とパスワードで認証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "認証 [WCF], ユーザー名とパスワード"
+ms.assetid: a5415be2-0ef3-464c-9f76-c255cb8165a4
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : ユーザー名とパスワードで認証する
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスが Windows ドメイン ユーザー名とパスワードを使用してクライアントを認証できるようにする方法を示します。自己ホスト型 WCF サービスが稼働していることを前提としています。基本的な自己ホスト型 WCF サービスを作成する例については、「[チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。このトピックでは、サービスがコードで構成されているものとします。構成ファイルを使用して同様のサービスを構成する例については、「[メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)」を参照してください。  
+  
+ Windows ドメイン ユーザー名とパスワードを使用してクライアントを認証するようにサービスを構成するには、<xref:System.ServiceModel.WSHttpBinding> を使用し、その `Security.Mode` プロパティを `Message` に設定します。また、ユーザー名とパスワードをクライアントからサービスに送信するときにそれらを暗号化するために使用する X.509 証明書を指定する必要があります。  
+  
+ クライアント側では、ユーザー名とパスワードをユーザーにたずね、WCF クライアント プロキシでユーザーの資格情報を指定する必要があります。  
+  
+### Windows ドメイン ユーザー名とパスワードを使用して認証するように WCF サービスを構成するには  
+  
+1.  次のコードに示すように、<xref:System.ServiceModel.WSHttpBinding> のインスタンスを作成し、バインディングのセキュリティ モードを `SecurityMode.Message` に設定した後、バインディングの `ClientCredentialType` を `MessageCredentialType.UserName` に設定し、構成されたバインディングを使用するサービス エンドポイントをサービス ホストに追加します。  
+  
+    ```  
+    // ...  
+    WSHttpBinding userNameBinding = new WSHttpBinding();  
+    userNameBinding.Security.Mode = SecurityMode.Message;  
+    userNameBinding.Security.Message.ClientCredentialType = MessageCredentialType.UserName;  
+    svcHost.AddServiceEndpoint(typeof(IService1), userNameBinding, "");  
+    // ...  
+    ```  
+  
+2.  ネットワーク経由で送信されるユーザー名とパスワードの情報を暗号化するために使用するサーバー証明書を指定します。このコードは、上記のコードの直後に追加します。次の例では、「[メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)」のサンプルの setup.bat ファイルによって作成された証明書を使用します。  
+  
+    ```  
+    // ...  
+    svcHost.Credentials.ServiceCertificate.SetCertificate(StoreLocation.LocalMachine, StoreName.My, X509FindType.FindBySubjectName, "localhost");  
+    // ...  
+    ```  
+  
+     独自の証明書を使用する場合は、その証明書を参照するようにコードを変更します。証明書の作成と使用の詳細については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。証明書がローカル マシンの信頼されたユーザーの証明書ストア内に存在することを確認します。これを行うには、mmc.exe を実行し、**\[ファイル\]**、**\[スナップインの追加と削除\]** メニュー項目を順にクリックします。**\[スナップインの追加と削除\]** ダイアログ ボックスで、**\[証明書スナップイン\]** を選択し、**\[追加\]** をクリックします。\[証明書スナップイン\] ダイアログ ボックスで、**\[コンピューター アカウント\]** を選択します。既定では、メッセージ セキュリティ ユーザー名のサンプルから生成された証明書は個人\/証明書フォルダーに配置されます。これは、MMC ウィンドウの \[発行先\] 列に "localhost" として表示されます。**\[信頼されたユーザー\]** フォルダーに証明書をドラッグ アンド ドロップします。これにより、認証を実行するときに、WCF は証明書を信頼された証明書として処理することができます。  
+  
+### ユーザー名とパスワードを渡すサービスを呼び出すには  
+  
+1.  クライアント アプリケーションは、ユーザー名とパスワードをユーザーにたずねる必要があります。次のコードでは、ユーザー名とパスワードをユーザーにたずねます。  
+  
+    > [!WARNING]
+    >  このコードは、パスワードが入力中に表示されるため、運用環境では使用しないでください。  
+  
+    ```  
+    public static void GetPassword(out string username, out string password)  
+            {  
+                Console.WriteLine("Provide a valid machine or domain account. [domain\\user]");  
+                Console.WriteLine("   Enter username:");  
+                username = Console.ReadLine();  
+                Console.WriteLine("   Enter password:");  
+                password = Console.ReadLine();             
+                return;  
+            }  
+  
+    ```  
+  
+2.  次のコードのように、クライアントの資格情報を指定して、クライアント プロキシのインスタンスを作成します。  
+  
+    ```  
+    string username;  
+    string password;  
+  
+    // Instantiate the proxy  
+    Service1Client proxy = new Service1Client();  
+  
+    // Prompt the user for username & password  
+    GetPassword(out username, out password);  
+  
+    // Set the user’s credentials on the proxy  
+    proxy.ClientCredentials.UserName.UserName = username;  
+    proxy.ClientCredentials.UserName.Password = password;  
+  
+    // Treat the test certificate as trusted  
+    proxy.ClientCredentials.ServiceCertificate.Authentication.CertificateValidationMode = System.ServiceModel.Security.X509CertificateValidationMode.PeerOrChainTrust;  
+    // Call the service operation using the proxy  
+    ```  
+  
+## 参照  
+ <xref:System.ServiceModel.WsHttpBinding>   
+ <xref:System.ServiceModel.WSHttpSecurity>   
+ <xref:System.ServiceModel.SecurityMode>   
+ <xref:System.ServiceModel.Security.UserNamePasswordClientCredential.UserName%2A>   
+ <xref:System.ServiceModel.Security.UserNamePasswordClientCredential.Password%2A>   
+ <xref:System.ServiceModel.Security.UserNamePasswordClientCredential>   
+ <xref:System.ServiceModel.WSHttpSecurity.Mode%2A>   
+ <xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType%2A>   
+ [基本認証でのトランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security-with-basic-authentication.md)   
+ [分散アプリケーションのセキュリティ](../../../../docs/framework/wcf/feature-details/distributed-application-security.md)   
+ [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-call-operations-asynchronously-using-a-channel-factory.md b/docs/framework/wcf/feature-details/how-to-call-operations-asynchronously-using-a-channel-factory.md
new file mode 100644
index 00000000000..a1c772eba80
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-call-operations-asynchronously-using-a-channel-factory.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : チャネル ファクトリを使用して、非同期的に操作を呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cc17dd47-b9ad-451c-a362-e36e0aac7ba0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : チャネル ファクトリを使用して、非同期的に操作を呼び出す
+ここでは、<xref:System.ServiceModel.ChannelFactory%601> ベースのクライアント アプリケーションを使用する場合に、クライアントからサービス操作に非同期にアクセスする方法について説明します。  サービスを呼び出すために <xref:System.ServiceModel.ClientBase%601?displayProperty=fullName> オブジェクトを使用する場合は、イベント ドリブンの非同期呼び出しモデルを使用できます。  詳細については、「[方法 : サービス操作を非同期に呼び出す](../../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)」を参照してください。  イベント ベースの非同期呼び出しモデルの詳細については、「[Multithreaded Programming with the Event\-based Asynchronous Pattern](../../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+ このトピックのサービスは、`ICalculator` インターフェイスを実装しています。  クライアントはこのインターフェイスにある操作を非同期に呼び出すことができます。これはたとえば `Add` という操作を `BeginAdd` と `EndAdd` の 2 つのメソッドに分割できることを意味します。前者によって呼び出しを開始し、後者によって操作の完了時に結果を取得します。  サービス操作を非同期的に実装する方法を示す例については、「[方法 : 非同期サービス操作を実装する](../../../../docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md)」を参照してください。  同期操作と非同期操作の詳細については、「[同期操作と非同期操作](../../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)」を参照してください。  
+  
+## 手順  
+  
+#### WCF サービス操作を非同期に呼び出すには  
+  
+1.  次のコマンドに示すように、`/async` オプションを指定して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールを実行します。  
+  
+    ```  
+    svcutil /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost:8000/servicemodelsamples/service/mex /a  
+  
+    ```  
+  
+     これにより、操作の非同期クライアント版のサービス コントラクトが生成されます。  
+  
+2.  次のサンプル コードに示すように、非同期操作の完了時に呼び出されるコールバック関数を作成します。  
+  
+     [!code-csharp[C_How_To_CF_Async#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_how_to_cf_async/cs/client.cs#2)]
+     [!code-vb[C_How_To_CF_Async#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_how_to_cf_async/vb/client.vb#2)]  
+  
+3.  サービス操作に非同期にアクセスするには、次のサンプル コードに示すように、クライアントを作成して `Begin[Operation]` \(たとえば `BeginAdd`\) を呼び出し、コールバック関数を指定します。  
+  
+     [!code-csharp[C_How_To_CF_Async#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_how_to_cf_async/cs/client.cs#3)]
+     [!code-vb[C_How_To_CF_Async#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_how_to_cf_async/vb/client.vb#3)]  
+  
+     コールバック関数が実行されると、クライアントは `End<operation>` \(`EndAdd` など\) を呼び出して結果を取得します。  
+  
+## 使用例  
+ 上記の手順で使用したクライアント コードで使用するサービスは、次のコードに示すように `ICalculator` インターフェイスを実装しています。  コントラクトの `Add` 操作と `Subtract` 操作は、上記のクライアントの手順がクライアントで非同期に呼び出される場合でも、サービス側では [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のランタイムにより同期して呼び出されます。  `Multiply` 操作と `Divide` 操作は、クライアントで同期して呼び出される場合でも、サービス側ではサービスを非同期に呼び出すように使用されます。  この例では、<xref:System.ServiceModel.OperationContractAttribute.AsyncPattern%2A> プロパティを `true` に設定します。  このプロパティ設定は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 非同期パターンの実装と共に、ランタイムに対して、操作を非同期で呼び出すよう指示します。  
+  
+ [!code-csharp[C_How_To_CF_Async#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_how_to_cf_async/cs/service.cs#4)]
+ [!code-vb[C_How_To_CF_Async#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_how_to_cf_async/vb/service.vb#4)]  
+  
+## 参照  
+ [Service Contract: Asynchronous Sample](http://msdn.microsoft.com/ja-jp/833db946-f511-4f64-a26f-2759a11217c7)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md b/docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md
new file mode 100644
index 00000000000..c57d221f888
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : WCF サービス操作を非同期に呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0face17f-43ca-417b-9b33-737c0fc360df
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : WCF サービス操作を非同期に呼び出す
+ここでは、クライアントからサービス操作に非同期にアクセスする方法について説明します。このトピックのサービスは、`ICalculator` インターフェイスを実装しています。クライアントは、イベント ドリブンの非同期呼び出しモデルを使用して、このインターフェイスで操作を非同期に呼び出すことができます \(イベント ベースの非同期呼び出しモデルの詳細については、「[イベント ベースの非同期パターンを使用したマルチスレッド プログラミング](http://go.microsoft.com/fwlink/?LinkId=248184)」を参照してください\)。サービス操作を非同期に実装する方法を示す例については、「[方法 : 非同期サービス操作を実装する](../../../../docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md)」を参照してください。同期操作と非同期操作の詳細については、「[同期操作と非同期操作](../../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.ChannelFactory%601> を使用している場合、イベント ドリブンの非同期呼び出しモデルはサポートされません。<xref:System.ServiceModel.ChannelFactory%601> を使用して非同期呼び出しを作成する方法については、「[方法 : チャネル ファクトリを使用して、非同期的に操作を呼び出す](../../../../docs/framework/wcf/feature-details/how-to-call-operations-asynchronously-using-a-channel-factory.md)」を参照してください。  
+  
+## 手順  
+  
+#### WCF サービス操作を非同期に呼び出すには  
+  
+1.  次のコマンドに示すように、`/async` と `/tcv:Version35` の両方のコマンド オプションを指定して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行します。  
+  
+    ```  
+    svcutil /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost:8000/servicemodelsamples/service/mex /a /tcv:Version35  
+    ```  
+  
+     これにより、同期操作と標準のデリゲート ベースの非同期操作だけでなく、以下を含む [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスも生成されます。  
+  
+    -   イベント ベースの非同期呼び出し方法で使用するための 2 つの \<`operationName`\>`Async` 操作。次に例を示します。  
+  
+         [!code-csharp[EventAsync#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/generatedclient.cs#1)]
+         [!code-vb[EventAsync#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/generatedclient.vb#1)]  
+  
+    -   イベント ベースの非同期呼び出し方法で使用するための \<`operationName`\>`Completed` 形式の操作完了イベント。次に例を示します。  
+  
+         [!code-csharp[EventAsync#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/generatedclient.cs#2)]
+         [!code-vb[EventAsync#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/generatedclient.vb#2)]  
+  
+    -   イベント ベースの非同期呼び出し方法で使用するための \(\<`operationName`\>`CompletedEventArgs` 形式の\) 各操作の <xref:System.EventArgs?displayProperty=fullName> 型。次に例を示します。  
+  
+         [!code-csharp[EventAsync#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/generatedclient.cs#3)]
+         [!code-vb[EventAsync#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/generatedclient.vb#3)]  
+  
+2.  次のサンプル コードに示すように、呼び出し元アプリケーションで、非同期操作の完了時に呼び出されるコールバック メソッドを作成します。  
+  
+     [!code-csharp[EventAsync#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/client.cs#4)]
+     [!code-vb[EventAsync#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/client.vb#4)]  
+  
+3.  操作を呼び出す前に、\<`operationName`\>`EventArgs` 型の新しいジェネリック <xref:System.EventHandler%601?displayProperty=fullName> を使用して、\(前の手順で作成した\) ハンドラー メソッドを \<`operationName`\>`Completed` イベントに追加します。次に、\<`operationName`\>`Async` メソッドを呼び出します。次に例を示します。  
+  
+     [!code-csharp[EventAsync#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/client.cs#5)]
+     [!code-vb[EventAsync#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/client.vb#5)]  
+  
+## 使用例  
+  
+> [!NOTE]
+>  イベント ベースの非同期モデルのデザイン ガイドラインには、複数の値を返す場合に、1 つの値を `Result` プロパティとして返し、残りの値を <xref:System.EventArgs> オブジェクトのプロパティとして返すことが記載されています。この 1 つの結果として、クライアントがイベント ベースの非同期コマンド オプションを使用してメタデータをインポートし、操作から複数の値が返される場合、既定の <xref:System.EventArgs> オブジェクトが 1 つの値を `Result` プロパティとして返し、残りの値は <xref:System.EventArgs> オブジェクトのプロパティになります。メッセージ オブジェクトを `Result` プロパティとして受け取り、返された値をそのオブジェクトのプロパティとして取得する場合は、`/messageContract` コマンド オプションを使用します。これにより、<xref:System.EventArgs> オブジェクトの `Result` プロパティとして応答メッセージを返すシグネチャが生成されます。すべての内部戻り値は、応答メッセージ オブジェクトのプロパティになります。  
+  
+ [!code-csharp[EventAsync#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/eventasync/cs/client.cs#6)]
+ [!code-vb[EventAsync#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/eventasync/vb/client.vb#6)]  
+  
+## 参照  
+ [方法 : 非同期サービス操作を実装する](../../../../docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md b/docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md
new file mode 100644
index 00000000000..6a37208426c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md
@@ -0,0 +1,84 @@
+---
+title: "方法 : ローカル発行者を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: 15263371-514e-4ea6-90fb-14b4939154cd
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : ローカル発行者を設定する
+ここでは、発行済みトークンに対してローカル発行者を使用するようにクライアントを構成する方法を説明します。  
+  
+ クライアントがフェデレーション サービスと通信する場合、クライアントが自分をフェデレーション サービスに対して認証するときに使用するトークンの発行元となるセキュリティ トークン サービスのアドレスが、サービスによって指定されることがよくあります。特定の状況では、クライアントが*ローカル発行者*を使用するように構成されることがあります。  
+  
+ フェデレーション バインディングの発行者アドレスが http:\/\/schemas.microsoft.com\/2005\/12\/ServiceModel\/Addressing\/Anonymous または `null` である場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はローカル発行者を使用します。そのような場合は、ローカルの発行者およびバインディングのアドレスと共に <xref:System.ServiceModel.Description.ClientCredentials> を構成し、その発行者との通信に使用する必要があります。  
+  
+> [!NOTE]
+>  `ClientCredentials` クラスの <xref:System.ServiceModel.Description.ClientCredentials.SupportInteractive%2A> プロパティが `true` に設定されており、ローカル発行者アドレスが指定されておらず、[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)または他のフェデレーション バインディングで指定される発行者アドレスが http:\/\/schemas.xmlsoap.org\/ws\/2005\/05\/identity\/issuer\/self、http:\/\/schemas.microsoft.com\/2005\/12\/ServiceModel\/Addressing\/Anonymous、または `null` である場合、Windows の [!INCLUDE[infocard](../../../../includes/infocard-md.md)] 発行者が使用されます。  
+  
+### コードでローカル発行者を構成するには  
+  
+1.  <xref:System.ServiceModel.Security.IssuedTokenClientCredential> 型の変数を作成します。  
+  
+2.  `ClientCredentials` クラスの <xref:System.ServiceModel.Description.ClientCredentials.IssuedToken%2A> プロパティから返されるインスタンスに変数を設定します。このインスタンスは、\(<xref:System.ServiceModel.ClientBase%601> から継承された\) クライアントの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティ、または <xref:System.ServiceModel.ChannelFactory> の <xref:System.ServiceModel.ChannelFactory.Credentials%2A> プロパティから次のように返されます。  
+  
+     [!code-csharp[c_CreateSTS#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#9)]
+     [!code-vb[c_CreateSTS#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#9)]  
+  
+3.  <xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerAddress%2A> プロパティを <xref:System.ServiceModel.EndpointAddress> の新規インスタンスに設定します。このとき、次のようにコンストラクターに対する引数としてローカル発行者のアドレスを使用します。  
+  
+     [!code-csharp[c_CreateSTS#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#10)]
+     [!code-vb[c_CreateSTS#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#10)]  
+  
+     あるいは、次のように新規の <xref:System.Uri> インスタンスをコンストラクターへの引数として作成します。  
+  
+     [!code-csharp[c_CreateSTS#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#11)]
+     [!code-vb[c_CreateSTS#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#11)]  
+  
+     次に示すように、`addressHeaders` パラメーターは <xref:System.ServiceModel.Channels.AddressHeader> インスタンスの配列です。  
+  
+     [!code-csharp[c_CreateSTS#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#12)]
+     [!code-vb[c_CreateSTS#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#12)]  
+  
+4.  <xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerBinding%2A> プロパティを使用して、ローカル発行者のバインディングを次のように設定します。  
+  
+     [!code-csharp[c_CreateSTS#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#13)]
+     [!code-vb[c_CreateSTS#13](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#13)]  
+  
+5.  省略可能。ローカル発行者に対して構成したエンドポイントの動作を <xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerChannelBehaviors%2A> プロパティから返されるコレクションに追加することにより、この動作を次のように追加します。  
+  
+     [!code-csharp[c_CreateSTS#14](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#14)]
+     [!code-vb[c_CreateSTS#14](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#14)]  
+  
+### 構成でローカル発行者を構成するには  
+  
+1.  その要素自体がエンドポイント動作の [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素の子要素である [\<issuedToken\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md) 要素の子として、[\<localIssuer\>](../../../../docs/framework/configure-apps/file-schema/wcf/localissuer.md) 要素を作成します。  
+  
+2.  `address` 属性を、トークン要求を受け入れるローカル発行者のアドレスに設定します。  
+  
+3.  `binding` および `bindingConfiguration` 属性を、ローカル発行者のエンドポイントと通信するときに使用する適切なバインディングを参照する値に設定します。  
+  
+4.  省略可能。\<`localIssuer`\> 要素の子要素として [\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md) 要素を設定し、ローカル発行者の ID 情報を指定します。  
+  
+5.  省略可能。\<`localIssuer`\> 要素の子要素として [\<headers\>](../../../../docs/framework/configure-apps/file-schema/wcf/headers.md) 要素を設定し、ローカル発行者を正しくアドレス指定するために必要な追加ヘッダーを指定します。  
+  
+## .NET Framework セキュリティ  
+ 特定のバインディングに対して発行者アドレスとバインディングが指定されている場合、ローカル発行者はこのバインディングを使用するエンドポイントには使用されません。ローカル発行者を常に使用する必要があるクライアントには、このようなバインディングが使用されることがないこと、または発行者アドレスが `null` となるようにクライアントによってバインディングが変更されることが保証されている必要があります。  
+  
+## 参照  
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md b/docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md
new file mode 100644
index 00000000000..e203613c19e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md
@@ -0,0 +1,137 @@
+---
+title: "方法 : SSL 証明書を使用してポートを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "SSL"
+  - "WCF, セキュリティ"
+  - "WCF, セキュリティ モード"
+ms.assetid: b8abcc8e-a5f5-4317-aca5-01e3c40ab24d
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : SSL 証明書を使用してポートを構成する
+トランスポート セキュリティを使用する自己ホスト型 [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを <xref:System.ServiceModel.WSHttpBinding> クラスを使って作成する場合は、X.509 証明書でポートを構成する作業も必要になります。  自己ホスト型サービスを作成するのでなければ、インターネット インフォメーション サービス \(IIS\) でサービスをホストできます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md).  
+  
+ ポートを構成する場合に使用するツールは、コンピューターで実行されているオペレーティング システムによって異なります。  
+  
+ [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] を実行している場合は、HttpCfg.exe ツールを使用します。  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では、このツールは自動的にインストールされています。  [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、「[Windows XP Service Pack 2 サポート ツール](http://go.microsoft.com/fwlink/?LinkId=88606)」からツールをダウンロードできます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 「[Httpcfg Overview](http://go.microsoft.com/fwlink/?LinkId=88605)」。  「[Httpcfg 構文](http://go.microsoft.com/fwlink/?LinkId=94840)」では、Httpcfg.exe ツールの構文について説明しています。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] を実行している場合は、Netsh.exe ツールを使用します。これは既にインストールされています。  
+  
+ このトピックでは、次のようなさまざまな手順を実行する方法について説明します。  
+  
+-   コンピューターの現在のポート構成を確認する。  
+  
+-   証明書の拇印を取得する \(次の 2 つの手順に必要\)。  
+  
+-   SSL 証明書をポート構成にバインドする。  
+  
+-   SSL 証明書をポート構成にバインドし、クライアント証明書をサポートする。  
+  
+-   ポート番号から SSL 証明書を削除する。  
+  
+ コンピューターに格納されている証明書を変更するには、管理特権が必要です。  
+  
+### ポートの構成を確認するには  
+  
+1.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] で現在のポート構成を表示するには、HttpCfg.exe ツールを使用します。次の例に示すように、**query** スイッチと **ssl** スイッチを使用します。  
+  
+    ```  
+    httpcfg query ssl  
+    ```  
+  
+2.  [!INCLUDE[wv](../../../../includes/wv-md.md)] で現在のポート構成を表示するには、Netsh.exe ツールを使用します。次に例を示します。  
+  
+    ```  
+    netsh http show sslcert  
+    ```  
+  
+### 証明書の拇印を取得するには  
+  
+1.  証明書 MMC スナップインを使用して、クライアント認証を目的として含む X.509 証明書を検索します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md).  
+  
+2.  証明書の拇印にアクセスします。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : 証明書のサムプリントを取得する](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md).  
+  
+3.  証明書のサムプリントを、メモ帳などのテキスト エディターにコピーします。  
+  
+4.  16 進文字の間にある空白をすべて削除します。  たとえばエディターの "すべて置換" 機能を使用して、空白を空文字列に置き換えるとよいでしょう。  
+  
+### SSL 証明書をポート番号にバインドするには  
+  
+1.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] で証明書をポート番号にバインドするには、HttpCfg.exe ツールを SSL \(Secure Sockets Layer\) ストアに対して "set" モードで使用します。  このツールは、次のように、拇印を使用して証明書を識別します。  
+  
+    ```  
+    httpcfg set ssl -i 0.0.0.0:8012 -h 0000000000003ed9cd0c315bbb6dc1c08da5e6  
+    ```  
+  
+    -   **\-i** スイッチには、`IP`:`port` という構文を使用します。上の例では、コンピューターのポート 8012 に証明書を設定するようにツールに対して指示しています。  "0.0.0.0" の部分は、必要に応じて、コンピューターの実際の IP アドレスに置き換えてください。  
+  
+    -   **\-h**  スイッチは、証明書の拇印を指定します。  
+  
+2.  [!INCLUDE[wv](../../../../includes/wv-md.md)] では、Netsh.exe ツールを使用します。次に例を示します。  
+  
+    ```  
+    netsh http add sslcert ipport=0.0.0.0:8000 certhash=0000000000003ed9cd0c315bbb6dc1c08da5e6 appid={00112233-4455-6677-8899-AABBCCDDEEFF}   
+    ```  
+  
+    -   **certhash** パラメーターは、証明書の拇印を指定します。  
+  
+    -   **ipport** パラメーターは、IP アドレスとポートを指定します。このパラメーターは、既に説明した Httpcfg.exe ツールの **\-i** スイッチと同じように機能します。  
+  
+    -   **appid** パラメーターは、所有するアプリケーションの識別に使用できる GUID です。  
+  
+### SSL 証明書をポート番号にバインドし、クライアント証明書をサポートするには  
+  
+1.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、トランスポート層で X.509 証明書を使用して認証するクライアントをサポートするには、前と同じ手順を実行しますが、次のように HttpCfg.exe に追加のコマンド ライン パラメーターを指定します。  
+  
+    ```  
+    httpcfg set ssl -i 0.0.0.0:8012 -h 0000000000003ed9cd0c315bbb6dc1c08da5e6 -f 2  
+    ```  
+  
+     **\-f** スイッチには、`n` という構文を使用します。n は 1 ～ 7 の数字を表します。  前の例のように 2 を指定すると、クライアントはトランスポート層で認証することになります。  値として 3 を指定すると、クライアント証明書が有効になり、それらの証明書が Windows アカウントに対応付けられます。  他の値については、HttpCfg.exe のヘルプ機能を参照してください。  
+  
+2.  [!INCLUDE[wv](../../../../includes/wv-md.md)] では、トランスポート層で X.509 証明書を使用して認証するクライアントをサポートするには、前と同じ手順を実行しますが、次のように追加のパラメーターを指定します。  
+  
+    ```  
+    netsh http add sslcert ipport=0.0.0.0:8000 certhash=0000000000003ed9cd0c315bbb6dc1c08da5e6 appid={00112233-4455-6677-8899-AABBCCDDEEFF} clientcertnegotiation=enable  
+    ```  
+  
+### ポート番号から SSL 証明書を削除するには  
+  
+1.  HttpCfg.exe または Netsh.exe ツールを使用して、コンピューター上のすべてのバインディングのポートと拇印を確認します。  情報をディスクに出力するには、次の例のようにリダイレクト文字 "\>" を使用します。  
+  
+    ```  
+    httpcfg query ssl>myMachinePorts.txt  
+    ```  
+  
+2.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、HttpCfg.exe ツールを **delete** および **ssl** の各キーワードと共に使用します。  **\-i** スイッチで `IP`:`port` 番号を、**\-h** スイッチで拇印を指定します。  
+  
+    ```  
+    httpcfg delete ssl -i 0.0.0.0:8005 -h 0000000000003ed9cd0c315bbb6dc1c08da5e6  
+    ```  
+  
+3.  [!INCLUDE[wv](../../../../includes/wv-md.md)] では、Netsh.exe ツールを使用します。次に例を示します。  
+  
+    ```  
+    Netsh http delete sslcert ipport=0.0.0.0:8005  
+    ```  
+  
+## 使用例  
+ 次のコードは、トランスポート セキュリティを設定した <xref:System.ServiceModel.WSHttpBinding> クラスを使用して、自己ホスト型サービスを作成する方法を示します。  アプリケーションを作成する際、アドレス中にポート番号を指定してください。  
+  
+ [!code-csharp[c_WsHttpService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wshttpservice/cs/source.cs#3)]
+ [!code-vb[c_WsHttpService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wshttpservice/vb/source.vb#3)]  
+  
+## 参照  
+ [HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-a-wcf-client-to-interoperate-with-wse3-0-services.md b/docs/framework/wcf/feature-details/how-to-configure-a-wcf-client-to-interoperate-with-wse3-0-services.md
new file mode 100644
index 00000000000..0ef82ff1549
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-a-wcf-client-to-interoperate-with-wse3-0-services.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : WCF クライアントと WSE3.0 サービスを相互運用するために構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3dadd7f1-d207-4ea5-a73b-3e8aa44407f8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : WCF クライアントと WSE3.0 サービスを相互運用するために構成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントが WS-Addressing 仕様の 2004 年 8 月版を使用して構成されている場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは Microsoft .NET サービスの WSE (Web サービス拡張) 3.0 とネットワーク レベルで互換性があります。  
+  
+### <a name="to-configure-a-wcf-client-to-interoperate-with-a-wse-30-web-service"></a>WSE 3.0 Web サービスと相互運用するように WCF クライアントを構成するには  
+  
+1.  実行、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)を作成する、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WSE 3.0 Web サービスのクライアントです。  
+  
+     WSE Web サービスに対して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスが作成されます。  
+  
+     作成する方法について、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントを参照してください、[方法: クライアントを作成する](../../../../docs/framework/wcf/how-to-create-a-wcf-client.md)です。  
+  
+2.  WSE 3.0 Web サービスと通信できるバインディングを表すクラスを作成します。  
+  
+     次のクラスの一部である、 [WSE との相互運用](http://msdn.microsoft.com/ja-jp/f6816861-96a0-45f9-8736-8e4e82cd3a41)サンプルです。  
+  
+    1.  派生したクラスを作成、<xref:System.ServiceModel.Channels.Binding>クラスです。  
+  
+         次のコード例は、という名前のクラスを作成`WseHttpBinding`から派生した、<xref:System.ServiceModel.Channels.Binding>クラスです。  
+  
+         [!code-csharp[c_WCFClientToWSEService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#1)]
+         [!code-vb[c_WCFClientToWSEService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#1)]  
+  
+    2.  WSE の設定不要アサーションを指定するクラスに、派生キーが必要か、セキュリティで保護されたセッションが使用されるか、署名の確認が必要かどうかの指定、およびメッセージ保護設定などのプロパティを追加します。  
+  
+         次のコード例では定義`SecurityAssertion,``RequireDerivedKeys, EstablishSecurityContext, MessageProtectionOrder`WSE 設定不要アサーション、派生キーが必要かどうか、セキュリティで保護されたセッションを使用するかどうか、署名の確認が必要かどうかおよびメッセージの保護設定をそれぞれ指定するプロパティです。  
+  
+         [!code-csharp[c_WCFClientToWSEService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#3)]
+         [!code-vb[c_WCFClientToWSEService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#3)]  
+  
+    3.  オーバーライド、 <xref:System.ServiceModel.Channels.Binding.CreateBindingElements%2A>バインドのプロパティを設定します。  
+  
+         `SecurityAssertion` プロパティと `MessageProtectionOrder` プロパティの値を取得することで、トランスポート、メッセージ エンコーディング、メッセージ保護設定を指定するコード例を次に示します。  
+  
+         [!code-csharp[c_WCFClientToWSEService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/wsehttpbinding.cs#2)]
+         [!code-vb[c_WCFClientToWSEService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/wsehttpbinding.vb#2)]  
+  
+3.  クライアントのアプリケーション コードでは、コードを追加してバインディングのプロパティを設定します。  
+  
+     WSE 3.0 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の設定不要なセキュリティ アサーションで定義されているように、メッセージの保護と認証を使用しなければならない `AnonymousForCertificate` クライアントを指定するコード例を次に示します。 また、セキュリティで保護されたセッションと派生キーが必要です。  
+  
+     [!code-csharp[c_WCFClientToWSEService#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/client.cs#4)]
+     [!code-vb[c_WCFClientToWSEService#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/client.vb#4)]  
+  
+## <a name="example"></a>例  
+ WSE 3.0 の設定不要のセキュリティ アサーションのプロパティに対応するプロパティを公開するカスタムのバインディングを定義するコード例を次に示します。 この `WseHttpBinding` という名前のカスタム バインディングを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのバインディング プロパティを指定します。  
+  
+  
+[!code-csharp[c_WCFClientToWSEService#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wcfclienttowseservice/cs/client.cs#0)]
+[!code-vb[c_WCFClientToWSEService#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wcfclienttowseservice/vb/client.vb#0)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Channels.Binding>   
+ [WSE との相互運用](http://msdn.microsoft.com/ja-jp/f6816861-96a0-45f9-8736-8e4e82cd3a41)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md b/docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md
new file mode 100644
index 00000000000..58cb320741f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : ポート共有を使用するように Windows Communication Foundation サービスを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6400bc71-a858-4ac2-8d5a-caa72d3b5482
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : ポート共有を使用するように Windows Communication Foundation サービスを構成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションで net.tcp:\/\/ ポート共有を使用する最も簡単な方法は、<xref:System.ServiceModel.NetTcpBinding> を使用してサービスを公開することです。  
+  
+ このバインディングは、<xref:System.ServiceModel.NetTcpBinding.PortSharingEnabled%2A> プロパティを提供します。このプロパティは、このバインディングを使用して構成されるサービスに対して net.tcp:\/\/ ポート共有を有効にするかどうかを制御します。  
+  
+ 以下の手順では、<xref:System.ServiceModel.NetTcpBinding> クラスを使用して URI \(Uniform Resource Identifier\)、net.tcp:\/\/localhost\/MyService にあるエンドポイントを開く方法を示します。最初にコードを使用する場合の手順を示し、次に構成要素を使用する場合の手順を示します。  
+  
+### コードで NetTcpBinding の net.tcp:\/\/ ポート共有を有効にするには  
+  
+1.  `IMyService` という名前のコントラクトを実装するサービスを作成し、`MyService` という名前を付けます。  
+  
+     [!code-csharp[c_ConfigurePortSharing#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_configureportsharing/cs/source.cs#1)]
+     [!code-vb[c_ConfigurePortSharing#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_configureportsharing/vb/source.vb#1)]  
+  
+2.  <xref:System.ServiceModel.NetTcpBinding> クラスのインスタンスを作成し、<xref:System.ServiceModel.NetTcpBinding.PortSharingEnabled%2A> プロパティを `true` に設定します。  
+  
+     [!code-csharp[c_ConfigurePortSharing#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_configureportsharing/cs/source.cs#2)]
+     [!code-vb[c_ConfigurePortSharing#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_configureportsharing/vb/source.vb#2)]  
+  
+3.  <xref:System.ServiceModel.ServiceHost> を作成し、ポート共有を有効にした <xref:System.ServiceModel.NetTcpBinding> を使用し、エンドポイント アドレス URI "net.tcp:\/\/localhost\/MyService" をリッスンする `MyService` のサービス エンドポイントを追加します。  
+  
+     [!code-csharp[c_ConfigurePortSharing#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_configureportsharing/cs/source.cs#3)]
+     [!code-vb[c_ConfigurePortSharing#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_configureportsharing/vb/source.vb#3)]  
+  
+    > [!NOTE]
+    >  このエンドポイント アドレス URI は異なるポート番号を指定しないため、この例では既定の TCP ポートである 808 を使用します。トランスポート バインディングでポート共有が明示的に有効になっているため、このサービスはポート 808 を他のプロセスの他のサービスと共有できます。ポート共有が許可されておらず、既に別のアプリケーションがポート 808 を使用している場合は、このサービスを開こうとすると <xref:System.ServiceModel.AddressAlreadyInUseException> がスローされます。  
+  
+### 構成で NetTcpBinding の net.tcp:\/\/ ポート共有を有効にするには  
+  
+1.  次の例では、構成要素を使用してポート共有を有効にし、サービス エンドポイントを追加します。  
+  
+```  
+<system.serviceModel>  
+  <bindings>  
+    <netTcpBinding name="portSharingBinding"   
+                   portSharingEnabled="true" />  
+  </bindings>  
+  <services>  
+    <service name="MyService">  
+        <endpoint address="net.tcp://localhost/MyService"  
+                  binding="netTcpBinding"  
+                  contract="IMyService"  
+                  bindingConfiguration="portSharingBinding" />  
+    </service>  
+  </services>  
+</system.serviceModel>  
+```  
+  
+## 参照  
+ [Net.TCP Port Sharing](http://msdn.microsoft.com/ja-jp/f13692ee-a179-4439-ae72-50db9534eded)   
+ [方法 : Net.TCP ポート共有サービスを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-an-iis-hosted-wcf-service-with-ssl.md b/docs/framework/wcf/feature-details/how-to-configure-an-iis-hosted-wcf-service-with-ssl.md
new file mode 100644
index 00000000000..1d39a8020a8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-an-iis-hosted-wcf-service-with-ssl.md
@@ -0,0 +1,163 @@
+---
+title: "IIS でホストされる WCF サービスに SSL を構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: df2fe31f-a4bb-4024-92ca-b74ba055e038
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# IIS でホストされる WCF サービスに SSL を構成する方法
+ここでは、HTTP トランスポート セキュリティを使用するように IIS でホストされる WCF サービスをセットアップする方法について説明します。  HTTP トランスポート セキュリティを使用するには、SSL 証明書が IIS に登録されている必要があります。  SSL 証明書がない場合は、IIS を使用してテスト証明書を生成できます。  次に、Web サイトに SSL バインディングを追加し、Web サイトの認証プロパティを構成する必要があります。  最後に、HTTPS を使用するように WCF サービスを構成する必要があります。  
+  
+### 自己署名証明書の作成  
+  
+1.  インターネット インフォメーション サービス マネージャー \(inetmgr.exe\) を開き、左側のツリー ビューでコンピューター名を選択します。  画面の右側で \[サーバー証明書\] を選択します。  
+  
+     ![IIS マネージャー ホーム画面](../../../../docs/framework/wcf/feature-details/media/mg-inetmgrhome.jpg "mg\_INetMgrHome")  
+  
+2.  \[サーバー証明書\] ウィンドウで、**\[自己署名入り証明書の作成\]** リンクをクリックします。  
+  
+     ![IIS での自己署名証明書の作成](../../../../docs/framework/wcf/feature-details/media/mg-createselfsignedcert.jpg "mg\_CreateSelfSignedCert")  
+  
+3.  自己署名証明書の表示名を入力し、**\[OK\]** をクリックします。  
+  
+     ![&#91;自己署名入り証明書の作成&#93; ダイアログ](../../../../docs/framework/wcf/feature-details/media/mg-mycert.jpg "mg\_MyCert")  
+  
+     これで、新しく作成された自己署名証明書の詳細が **\[サーバー証明書\]** ウィンドウに表示されます。  
+  
+     ![&#91;サーバー証明書&#93; ウィンドウ](../../../../docs/framework/wcf/feature-details/media/mg-servercertificatewindow.jpg "mg\_ServerCertificateWindow")  
+  
+     生成された証明書が、信頼されたルート証明機関ストアにインストールされます。  
+  
+### SSL バインドの追加  
+  
+1.  インターネット インフォメーション サービス マネージャーで、画面の左側にあるツリー ビューの **\[サイト\]** フォルダーを展開し、**\[既定の Web サイト\]** フォルダーを展開します。  
+  
+2.  ウィンドウの右上にある **\[操作\]** セクションの **\[バインド\]** リンクをクリックします。  
+  
+     ![SSL バインディングの追加](../../../../docs/framework/wcf/feature-details/media/mg-addsslbinding.jpg "mg\_AddSSLBinding")  
+  
+3.  \[サイト バインド\] ウィンドウで **\[追加\]** をクリックします。  
+  
+     ![&#91;サイト バインド&#93; ダイアログ](../../../../docs/framework/wcf/feature-details/media/mg-sitebindingsdialog.jpg "mg\_SiteBindingsDialog")  
+  
+4.  **\[サイト バインドの追加\]** ダイアログ ボックスで、作成した自己署名証明書の種類 \(https\) と表示名を選択します。  
+  
+     ![サイト バインディングの例](../../../../docs/framework/wcf/feature-details/media/mg-mycertbinding.jpg "mg\_MyCertBinding")  
+  
+### SSL の仮想ディレクトリの構成  
+  
+1.  インターネット インフォメーション サービス マネージャーで、WCF のセキュリティで保護されたサービスが含まれている仮想ディレクトリを選択します。  
+  
+2.  ウィンドウの中央ペインにある IIS セクションで **\[SSL 設定\]** を選択します。  
+  
+     ![仮想ディレクトリの SSL 設定](../../../../docs/framework/wcf/feature-details/media/mg-sslsettingsforvdir.jpg "mg\_SSLSettingsForVDir")  
+  
+3.  \[SSL 設定\] ペインで、**\[SSL が必要\]** チェック ボックスをオンにし、画面右側の **\[操作\]** セクションで **\[適用\]** リンクをクリックします。  
+  
+     ![仮想ディレクトリの SSL 設定](../../../../docs/framework/wcf/feature-details/media/mg-vdirsslsettings.JPG "mg\_VDirSSLSettings")  
+  
+### HTTP トランスポート セキュリティのための WCF サービスの構成  
+  
+1.  WCF サービスの Web.config で、次の XML に示すように、トランスポート セキュリティを使用するよう HTTP バインドを構成します。  
+  
+    ```  
+    <bindings>  
+          <basicHttpBinding>  
+            <binding name="secureHttpBinding">  
+              <security mode="Transport">  
+                <transport clientCredentialType="None"/>  
+              </security>  
+            </binding>  
+          </basicHttpBinding>  
+        </bindings>  
+  
+    ```  
+  
+2.  次の XML に示すように、サービスとサービス エンドポイントを指定します。  
+  
+    ```  
+    <services>  
+          <service name="MySecureWCFService.Service1">  
+            <endpoint address=""  
+                      binding="basicHttpBinding"  
+                      bindingConfiguration="secureHttpBinding"  
+                      contract="MySecureWCFService.IService1"/>  
+  
+            <endpoint address="mex"  
+                      binding="mexHttpsBinding"  
+                      contract="IMetadataExchange" />  
+          </service>  
+        </services>  
+  
+    ```  
+  
+## 使用例  
+ 次は、HTTP トランスポート セキュリティを使用した WCF サービスの web.config ファイルの詳細な例です。  
+  
+```  
+<?xml version="1.0"?>  
+<configuration>  
+  
+  <system.web>  
+    <compilation debug="true" targetFramework="4.0" />  
+  </system.web>  
+  <system.serviceModel>  
+    <services>  
+      <service name="MySecureWCFService.Service1">  
+        <endpoint address=""  
+                  binding="basicHttpBinding"  
+                  bindingConfiguration="secureHttpBinding"  
+                  contract="MySecureWCFService.IService1"/>  
+  
+        <endpoint address="mex"  
+                  binding="mexHttpsBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <basicHttpBinding>  
+        <binding name="secureHttpBinding">  
+          <security mode="Transport">  
+            <transport clientCredentialType="None"/>  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <!-- To avoid disclosing metadata information, set the value below to false and remove the metadata endpoint above before deployment -->  
+          <serviceMetadata httpsGetEnabled="true"/>  
+          <!-- To receive exception details in faults for debugging purposes, set the value below to true.  Set to false before deployment to avoid disclosing exception information -->  
+          <serviceDebug includeExceptionDetailInFaults="false"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <serviceHostingEnvironment multipleSiteBindingsEnabled="true" />  
+  </system.serviceModel>  
+ <system.webServer>  
+    <modules runAllManagedModulesForAllRequests="true"/>  
+  </system.webServer>  
+  
+</configuration>  
+  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## 参照  
+ [インターネット インフォメーション サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)   
+ [インターネット インフォメーション サービスのホスティング手順](../../../../docs/framework/wcf/samples/internet-information-service-hosting-instructions.md)   
+ [インターネット インフォメーション サービス ホスティングのベスト プラクティス](../../../../docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md)   
+ [インライン コードを使用した IIS ホスティング](../../../../docs/framework/wcf/samples/iis-hosting-using-inline-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md b/docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md
new file mode 100644
index 00000000000..80962b37539
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : COM+ サービス設定を構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "COM+ [WCF], サービス設定の構成"
+ms.assetid: f42a55a8-3af8-4394-9fdd-bf12a93780eb
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法 : COM+ サービス設定を構成する
+COM\+ サービス構成ツールを使用してアプリケーション インターフェイスを追加または削除すると、アプリケーション構成ファイル内の Web サービス構成が更新されます。  COM\+ ホスト モードでは、Application.config ファイルはアプリケーションのルート ディレクトリ \(既定は %PROGRAMFILES%\\ComPlus Applications\\{appid}\) に配置されます。  いずれの Web ホスト モードでも、Web.config ファイルは指定した vroot ディレクトリに配置されます。  
+  
+> [!NOTE]
+>  クライアントとサーバー間のメッセージの改ざんを防止するには、メッセージの署名を使用する必要があります。  また、クライアントとサーバー間のメッセージから情報が漏えいするのを防止するには、メッセージまたはトランスポート層の暗号化を使用する必要があります。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの場合と同様に、調整機能を使用して同時呼び出し、同時接続、同時インスタンス、同時保留操作の数を制限する必要があります。  これによりリソースの過剰消費を防ぐことができます。  調整の動作は、サービス構成ファイルの設定で指定します。  
+  
+## 使用例  
+ 次のインターフェイスを実装するコンポーネントについて考えます。  
+  
+```  
+[Guid("C551FBA9-E3AA-4272-8C2A-84BD8D290AC7")]  
+public interface IFinances  
+{  
+    string Debit(string accountNo, double amount);  
+    string Credit(string accountNo, double amount);  
+}  
+  
+```  
+  
+ コンポーネントを Web サービスとして公開する場合、クライアントが準拠する必要のある対応の公開サービス コントラクトは次のとおりです。  
+  
+```  
+[ServiceContract(Session = true,  
+Namespace = "http://tempuri.org/C551FBA9-E3AA-4272-8C2A-84BD8D290AC7",  
+Name = "IFinances")]  
+public interface IFinancesContract : IDisposable  
+{  
+    [OperationContract]  
+    string Debit(string accountNo, double amount);  
+    [OperationContract]  
+    string Credit(string accountNo, double amount);  
+}  
+  
+```  
+  
+> [!NOTE]
+>  IID はコントラクトの初期名前空間の一部です。  
+  
+ このサービスを使用するクライアント アプリケーションはこのコントラクトに準拠し、さらにアプリケーションの構成に指定したバインディングと互換性のあるバインディングを使用する必要があります。  
+  
+ 次のコード例は、既定の構成ファイルの例を示しています。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web サービスであるため、これは標準サービス モデルの構成スキーマに準拠し、他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの構成ファイルと同様の方法で編集できます。  
+  
+ 通常、次のような変更を行います。  
+  
+-   エンドポイント アドレスを既定の ApplicationName\/ComponentName\/InterfaceName という形式から、より利用しやすい形式に変更する。  
+  
+-   サービスの名前空間を既定の "http:\/\/tempuri.org\/InterfaceID" という形式から、より関連性の高い形式に変更する。  
+  
+-   異なるトランスポート バインディングを使用するようにエンドポイントを変更する。  
+  
+     COM\+ ホスト モードの場合、既定では名前付きパイプ トランスポートが使用されますが、その代わりに TCP などのコンピューターに関係のないトランスポートも使用できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+            <netNamedPipeBinding>  
+                <binding name="comNonTransactionalBinding" />  
+                <binding name="comTransactionalBinding" transactionFlow="true" />  
+            </netNamedPipeBinding>  
+        </bindings>  
+        <comContracts>  
+            <comContract contract="{C551FBA9-E3AA-4272-8C2A-84BD8D290AC7}"  
+                name="IFinances" namespace="http://tempuri.org/C551FBA9-E3AA-4272-8C2A-84BD8D290AC7"  
+                requiresSession="true">  
+                <exposedMethods>  
+                    <add exposedMethod="Debit" />  
+                    <add exposedMethod="Credit" />  
+                </exposedMethods>  
+            </comContract>  
+        </comContracts>  
+        <services>  
+            <service name="{DCDB24CC-0B19-4534-95CD-FBBFF4D67DD9},{C942B840-AD54-4A44-B5F7-928130980AB9}">  
+                <endpoint address="IFinances" binding="netNamedPipeBinding" bindingConfiguration="comNonTransactionalBinding"  
+                    contract="{C551FBA9-E3AA-4272-8C2A-84BD8D290AC7}" />  
+                <host>  
+                    <baseAddresses>  
+                        <add baseAddress="net.pipe://localhost/ServiceModelDocSampleApp/ServiceModelDocSample.esFinance" />  
+                    </baseAddresses>  
+                </host>  
+            </service>  
+        </services>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [COM\+ アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md b/docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md
new file mode 100644
index 00000000000..3cf18d7d7c9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : フェデレーション サービスで資格情報を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: 149ab165-0ef3-490a-83a9-4322a07bd98a
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 方法 : フェデレーション サービスで資格情報を設定する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でフェデレーション サービスを作成するには、大きく分けると次のような手順があります。  
+  
+1.  <xref:System.ServiceModel.WSFederationHttpBinding> または同様のカスタム バインディングの構成。適切なバインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)」を参照してください。  
+  
+2.  サービスに提示される発行済みトークンの認証方法を制御する <xref:System.ServiceModel.Security.IssuedTokenServiceCredential> の構成。  
+  
+ このトピックでは、2 番目の手順について詳しく説明します。フェデレーション サービスのしくみ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)」を参照してください。  
+  
+### コードで IssuedTokenServiceCredential のプロパティを設定するには  
+  
+1.  <xref:System.ServiceModel.Description.ServiceCredentials> クラスの <xref:System.ServiceModel.Description.ServiceCredentials.IssuedTokenAuthentication%2A> プロパティを使用して、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential> インスタンスへの参照を返します。このプロパティは、<xref:System.ServiceModel.ServiceHostBase> クラスの <xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティからアクセスされます。  
+  
+2.  [!INCLUDE[infocard](../../../../includes/infocard-md.md)] カードのように自己発行されるトークンを認証する場合は、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.AllowUntrustedRsaIssuers%2A> プロパティを `true` に設定します。既定値は `false` です。  
+  
+3.  <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A> プロパティによって返されるコレクションに <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> クラスのインスタンスを設定します。各インスタンスは、サービスが認証を行うトークンの発行者を表します。  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A> プロパティによって返されるクライアント側のコレクションとは異なり、既知の証明書コレクションはキー付きのコレクションではありません。指定した証明書が発行するトークンは、発行済みトークンを含むメッセージを送信したクライアントのアドレスとは無関係に、サービスによって受け入れられます \(その他の制約については以下で説明します\)。  
+  
+4.  <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A> プロパティを <xref:System.ServiceModel.Security.X509CertificateValidationMode> 列挙値のいずれかに設定します。これは、コードでのみ設定することができます。既定値は <xref:System.IdentityModel.Selectors.X509CertificateValidator.ChainTrust%2A> です。  
+  
+5.  <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A> プロパティが <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定されている場合、カスタム <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスのインスタンスを <xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CustomCertificateValidator%2A> プロパティに割り当てます。  
+  
+6.  <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A> が `ChainTrust` または `PeerOrChainTrust` に設定されている場合、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.RevocationMode%2A> プロパティを <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 列挙値にある適切な値に設定します。失効モードは `PeerTrust` または `Custom` 検証モードでは使用されないことに注意してください。  
+  
+7.  必要に応じて、カスタム <xref:System.IdentityModel.Tokens.SamlSerializer> クラスのインスタンスを <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.SamlSerializer%2A> プロパティに割り当てます。カスタム SAML \(Security Assertions Markup Language\) アサーションの解析などには、カスタム SAML シリアライザーが必要です。  
+  
+### 構成で IssuedTokenServiceCredential のプロパティを設定するには  
+  
+1.  \<`serviceCredentials`\> 要素の子として `<issuedTokenAuthentication>` 要素を作成します。  
+  
+2.  [!INCLUDE[infocard](../../../../includes/infocard-md.md)] カードのように自己発行されるトークンを認証する場合は、`<issuedTokenAuthentication>` 要素の `allowUntrustedRsaIssuers` 属性を `true` に設定します。  
+  
+3.  `<issuedTokenAuthentication>` 要素の子要素として `<knownCertificates>` 要素を作成します。  
+  
+4.  `<knownCertificates>` 要素の子要素として 0 個以上の `<add>` 要素を作成し、`storeLocation`、`storeName`、`x509FindType`、および `findValue` 属性を使用して証明書の検索方法を指定します。  
+  
+5.  必要に応じて、\<`issuedTokenAuthentication`\> 要素の `samlSerializer` 属性をカスタム <xref:System.IdentityModel.Tokens.SamlSerializer> クラスの型名に設定します。  
+  
+## 使用例  
+ 次の例では、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential> のプロパティをコードで設定しています。  
+  
+ [!code-csharp[C_FederatedService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federatedservice/cs/source.cs#2)]
+ [!code-vb[C_FederatedService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federatedservice/vb/source.vb#2)]  
+  
+ クライアントがフェデレーション サービスによって認証されるためには、発行済みトークンが次のことを満たす必要があります。  
+  
+-   発行済みトークンのデジタル署名が RSA セキュリティ キー識別子を使用している場合、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.AllowUntrustedRsaIssuers%2A> プロパティを `true` にする必要があります。  
+  
+-   発行済みトークンの署名に X.509 発行者シリアル番号、X.509 サブジェクト キー識別子、または X.509 拇印セキュリティ識別子が使用されている場合、発行済みトークンは <xref:System.ServiceModel.Security.IssuedTokenServiceCredential> クラスの <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A> プロパティによって返されたコレクションにある証明書で署名されている必要があります。  
+  
+-   発行済みトークンが X.509 証明書を使用して署名されている場合、証明書が <xref:System.IdentityModel.Tokens.X509RawDataKeyIdentifierClause> として証明書利用者に送信されたか、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A> プロパティから取得されたかに関係なく、<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CertificateValidationMode%2A> プロパティの値で指定されるセマンティックスごとに証明書を検証する必要があります。X.509 証明書の検証[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+ たとえば、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A> を <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定すると、その署名の証明書が `TrustedPeople` 証明書ストアに格納されている任意の発行済みトークンが認証されます。この場合、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.TrustedStoreLocation%2A> プロパティを <xref:System.Security.Cryptography.X509Certificates.StoreLocation> または <xref:System.Security.Cryptography.X509Certificates.StoreLocation> に設定します。<xref:System.ServiceModel.Security.X509CertificateValidationMode> を含めて、他のモードを選択できます。`Custom` を選択した場合、<xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスのインスタンスを <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CustomCertificateValidator%2A> プロパティに割り当てる必要があります。カスタム検証では、任意の基準を使用して証明書を検証できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : カスタム証明書検証を使用するサービスを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md).  
+  
+## 参照  
+ [フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)   
+ [フェデレーションと信頼](../../../../docs/framework/wcf/feature-details/federation-and-trust.md)   
+ [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)   
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)   
+ [方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-idle-behavior-with-workflowservicehost.md b/docs/framework/wcf/feature-details/how-to-configure-idle-behavior-with-workflowservicehost.md
new file mode 100644
index 00000000000..d29115e062b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-idle-behavior-with-workflowservicehost.md
@@ -0,0 +1,46 @@
+---
+title: "WorkflowServiceHost を使用してアイドル動作を構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bb93652-d687-46ff-bff6-69ecdcf97437
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# WorkflowServiceHost を使用してアイドル動作を構成する方法
+ワークフローは、外部からの働きかけによって再開される必要があるブックマークに遭遇すると、アイドル状態になります。たとえば、<xref:System.ServiceModel.Activities.Receive> アクティビティを使用して配信されるメッセージをワークフローが待機している場合などです。<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior> は、サービス インスタンスがアイドル状態になってから、インスタンスが永続化またはアンロードされるまでの時間を指定できる動作です。 これには、これらの時間の範囲を設定する 2 つのプロパティがあります。<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToPersist%2A> は、ワークフロー サービス インスタンスがアイドル状態になってから、そのワークフロー サービス インスタンスが永続化されるまでの時間の範囲を指定します。<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> は、ワークフロー サービス インスタンスがアイドル状態になってから、そのワークフロー サービス インスタンスがアンロードされるまでの時間の範囲を指定します。アンロードとは、インスタンスをインスタンス ストアに永続化し、メモリから削除することを意味します。 このトピックでは、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior> を構成ファイルで構成する方法について説明します。  
+  
+### WorkflowIdleBehavior を構成するには  
+  
+1.  次の例に示すように、\<`workflowIdle`\> 要素を \<`serviceBehaviors`\> 要素内の \<`behavior`\> 要素に追加します。  
+  
+    ```xml  
+    <behaviors> <serviceBehaviors> <behavior name=""> <workflowIdle timeToUnload="0:05:0" timeToPersist="0:04:0"/> </behavior> </serviceBehaviors> </behaviors>  
+  
+    ```  
+  
+     `timeToUnload` 属性は、ワークフロー サービス インスタンスがアイドル状態になってから、そのワークフロー サービス インスタンスがアンロードされるまでの時間の範囲を指定します。`timeToPersist` 属性は、ワークフロー サービス インスタンスがアイドル状態になってから、そのワークフロー サービス インスタンスが永続化されるまでの時間の範囲を指定します。`timeToUnload` の既定値は 1 分です。`timeToPersist` の既定値は <xref:System.TimeSpan.MaxValue> です。 インスタンスをメモリ内でアイドル状態を保ちながら信頼性を保持する場合、`timeToPersist` \< `timeToUnload` となるように値を設定します。 アイドル状態のインスタンスがアンロードされないようにするには、`timeToUnload` を <xref:System.TimeSpan.MaxValue> に設定します。<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior>[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)」を参照してください  
+  
+    > [!NOTE]
+    >  前の構成サンプルでは、簡略化された構成を使用しています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)。  
+  
+### コードのアイドル動作を変更するには  
+  
+-   次の例では、プログラムによって永続化とアンロードを行う前に待機する時間を変更します。  
+  
+     [!code-csharp[Wf_SvcHost_Idle_persist#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/wf_svchost_idle_persist/cs/source.cs#1)]
+     [!code-vb[Wf_SvcHost_Idle_persist#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/wf_svchost_idle_persist/vb/source.vb#1)]  
+  
+## 参照  
+ [ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)   
+ [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)   
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-persistence-with-workflowservicehost.md b/docs/framework/wcf/feature-details/how-to-configure-persistence-with-workflowservicehost.md
new file mode 100644
index 00000000000..c92f661fb7d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-persistence-with-workflowservicehost.md
@@ -0,0 +1,73 @@
+---
+title: "WorkflowServiceHost を使用して永続性を構成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e31cd4df-13a3-4a9a-9be8-5243e0055356
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# WorkflowServiceHost を使用して永続性を構成する方法
+このトピックでは、構成ファイルを使用して、<xref:System.ServiceHost.Activities.WorkflowServiceHost> でホストされるワークフローに対して永続化を有効にするように、SQL Workflow Instance Store の機能を構成する方法について説明します。  SQL Workflow Instance Store 機能を使用する前に、ワークフロー インスタンスの永続化に使用する SQL データベースを作成する必要があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ワークフローとワークフロー サービスの SQL 永続性を有効にする方法](../../../../docs/framework/windows-workflow-foundation//how-to-enable-sql-persistence-for-workflows-and-workflow-services.md).  
+  
+### 構成において SQL Workflow Instance Store を構成するには  
+  
+1.  SQL Workflow Instance Store のプロパティは、<xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> を使用して構成できます。これは、XML 構成で設定を変更するために使用できるサービス動作です。  次の構成例では、構成ファイルで \<`sqlWorkflowInstanceStore`\> という動作要素を使用して SQL Workflow Instance Store を構成する方法について説明します。  
+  
+    ```xml  
+    <serviceBehaviors>  
+        <behavior name="">  
+            <sqlWorkflowInstanceStore   
+                 connectionString="provider=System.Data.SqlClient;Data Source=(local);Initial Catalog=DefaultPersistenceProviderDb;Integrated Security=True;Async=true"  
+                 instanceEncodingOption="GZip | None"  
+                 instanceCompletionAction="DeleteAll | DeleteNothing"  
+                 instanceLockedExceptionAction="NoRetry | SimpleRetry | AggressiveRetry"  
+                 hostLockRenewalPeriod="00:00:30"   
+                 runnableInstancesDetectionPeriod="00:00:05">  
+            <sqlWorkflowInstanceStore/>  
+        </behavior>  
+    </serviceBehaviors>  
+  
+    ```  
+  
+     SQL Workflow Instance Store を構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフローとワークフロー サービスの SQL 永続性を有効にする方法](../../../../docs/framework/windows-workflow-foundation//how-to-enable-sql-persistence-for-workflows-and-workflow-services.md)」を参照してください。  \<`sqlWorkflowInstanceStore`\> 動作要素の個別の設定の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[SQL Workflow Instance Store](../../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)」を参照してください。  Windows Server AppFabric は自己の永続ストアを提供します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 「[Windows Server AppFabric の永続化](http://go.microsoft.com/fwlink/?LinkId=193121)」。  
+  
+    > [!NOTE]
+    >  前の構成例では、簡略化された構成を使用しています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)  
+  
+### コードで SQL Workflow Instance Store を構成するには  
+  
+1.  SQL Workflow Instance Store のプロパティは、<xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> を使用して構成できます。これは、コードで設定を変更できるサービス動作です。  次の例では、コードで <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> という動作要素を使用して SQL Workflow Instance Store を構成する方法を示します。  
+  
+    ```csharp  
+    host.Description.Behaviors.Add(new SqlWorkflowInstanceStoreBehavior  
+    {  
+       ConnectionString = "provider=System.Data.SqlClient;Data Source=(local);Initial Catalog=DefaultPersistenceProviderDb;Integrated Security=True;Async=true",  
+       InstanceEncodingOption = "GZip | None",  
+       InstanceCompletionAction = "DeleteAll | DeleteNothing",  
+       InstanceLockedExceptionAction = "NoRetry | SimpleRetry | AggressiveRetry",  
+       HostLockRenewalPeriod = new TimeSpan(00, 00, 30),  
+       RunnableInstancesDetectionPeriod = new TimeSpan(00, 00, 05)  
+    });  
+    ```  
+  
+     SQL Workflow Instance Store を構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフローとワークフロー サービスの SQL 永続性を有効にする方法](../../../../docs/framework/windows-workflow-foundation//how-to-enable-sql-persistence-for-workflows-and-workflow-services.md)」を参照してください。  <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> 動作要素の個別の設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SQL Workflow Instance Store](../../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)」を参照してください。  Windows Server AppFabric は自己の永続ストアを提供します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 「[Windows Server AppFabric の永続化](http://go.microsoft.com/fwlink/?LinkId=193121)」。  
+  
+    > [!NOTE]
+    >  前の構成例では、簡略化された構成を使用しています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)  
+  
+     プログラムによって永続化を構成する方法の例については、「[ワークフローとワークフロー サービスの永続化を有効にする方法](../../../../docs/framework/windows-workflow-foundation//how-to-enable-persistence-for-workflows-and-workflow-services.md)」を参照してください。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [ワークフローの永続性](../../../../docs/framework/windows-workflow-foundation//workflow-persistence.md)   
+ [Windows Server AppFabric の永続化](http://go.microsoft.com/fwlink/?LinkId=193121)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-tracking-with-workflowservicehost.md b/docs/framework/wcf/feature-details/how-to-configure-tracking-with-workflowservicehost.md
new file mode 100644
index 00000000000..566dfeb2431
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-tracking-with-workflowservicehost.md
@@ -0,0 +1,83 @@
+---
+title: "方法: WorkflowServiceHost を使用して追跡を構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed1485fe-7529-4351-bca3-8bb915260b17
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法: WorkflowServiceHost を使用して追跡を構成する
+このトピックでは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされている [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] ワークフロー サービスの追跡を構成する方法について説明します。  これは、Web.config ファイルにサービスの動作を指定することによって指定します。  
+  
+### 構成での追跡の構成  
+  
+1.  次の例に示すように、\<`behavior`\> 要素を構成ファイルで使用し、<xref:System.Activities.Tracking.EtwTrackingParticipant> を追加します。  
+  
+    ```  
+    <behaviors>  
+       <serviceBehaviors>  
+         <behavior>  
+           <etwTracking profileName="Sample Tracking Profile" />  
+         </behavior>              
+       </serviceBehaviors>  
+    <behaviors>  
+  
+    ```  
+  
+    > [!NOTE]
+    >  前の構成サンプルでは、簡略化された構成を使用しています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md).  
+  
+     前の構成サンプルでは、<xref:System.Activities.Tracking.EtwTrackingParticipant> を追加し、追跡プロファイル名を指定します。  追跡プロファイルは、\<`tracking`\> 要素内の \<`trackingProfile`\> 要素で作成されます。  追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信できるようにする、追跡クエリが含まれています。  追跡プロファイルを作成する方法を次の例に示します。  
+  
+    ```xml  
+    <system.serviceModel>  
+        <tracking>   
+         <trackingProfile name="Sample Tracking Profile">  
+            <workflow activityDefinitionId="*">  
+               <workflowInstanceQueries>  
+                 <workflowInstanceQuery>  
+                    <states>  
+                       <state name="Started"/>  
+                       <state name="Completed"/>  
+                    </states>  
+                </workflowInstanceQuery>  
+             </workflowInstanceQueries>  
+           </workflow>  
+         </trackingProfile>   
+       </tracking>  
+    </system.serviceModel>  
+  
+    ```  
+  
+     追跡プロファイル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[追跡プロファイル](../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+     追跡全般[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー追跡とトレース](../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」を参照してください。  
+  
+### コードでの追跡の構成  
+  
+1.  次の例に示すように、コードで <xref:System.ServiceModel.Activities.Description.EtwTrackingBehavior> を動作を使用して <xref:System.Activities.Tracking.EtwTrackingParticipant> を追加します。  
+  
+    ```csharp  
+    host.Description.Behaviors.Add(new EtwTrackingBehavior { ProfileName = "Sample Tracking Profile" });  
+    ```  
+  
+     前のコード サンプルでは、<xref:System.Activities.Tracking.EtwTrackingParticipant> を追加し、追跡プロファイル名を指定します。  追跡プロファイルは、前のセクションで説明したように \<`tracking`\> 要素内の \<`trackingProfile`\> 要素で作成されます。  
+  
+     追跡プロファイル[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[追跡プロファイル](../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)」を参照してください。  
+  
+     追跡全般[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー追跡とトレース](../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」を参照してください。  プログラムによる追跡の構成例については、「[ワークフローの追跡の構成](../../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」を参照してください。  
+  
+## 参照  
+ [WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)   
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [追跡プロファイル](../../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-configure-wcf-services-to-interoperate-with-wse-3-0-clients.md b/docs/framework/wcf/feature-details/how-to-configure-wcf-services-to-interoperate-with-wse-3-0-clients.md
new file mode 100644
index 00000000000..7e0e6c978d4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-configure-wcf-services-to-interoperate-with-wse-3-0-clients.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : WCF サービスと WSE 3.0 クライアントを相互運用するために構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f38c4a0-49a6-437c-bdde-ad1d138d3c4a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : WCF サービスと WSE 3.0 クライアントを相互運用するために構成する
+[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが WS\-Addressing 仕様の 2004 年 8 月版を使用して構成されている場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスは Microsoft .NET クライアントの WSE \(Web サービス拡張\) 3.0 とネットワーク レベルで互換性があります。  
+  
+### WCF サービスを WSE 3.0 クライアントと相互運用できるようにするには  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのカスタム バインディングを定義します。  
+  
+     メッセージ エンコーディングに 2004 年 8 月版の WS\-Addressing 仕様が使用されるように指定するには、カスタム バインディングを作成する必要があります。  
+  
+    1.  サービスの構成ファイルの [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) に子要素として [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を追加します。  
+  
+    2.  [\<binding\>](../../../../docs/framework/misc/binding.md)を [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)に追加して、`name` 属性を設定することにより、バインディングの名前を指定します。  
+  
+    3.  [\<binding\>](../../../../docs/framework/misc/binding.md)の子要素として[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)を追加することで、WSE 3.0 と互換性があるメッセージをセキュリティ保護するために使用される認証モードと WS\-Security 仕様のバージョンを指定します。  
+  
+         認証モードを設定するには、[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)の `authenicationMode` 属性を設定します。認証モードは、WSE 3.0 の設定不要のセキュリティ アサーションとほぼ同等です。次の表に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の認証モードと WSE 3.0 の設定不要のセキュリティ アサーションとの対応を示します。  
+  
+        |WCF 認証モード|WSE 3.0 の設定不要のセキュリティ アサーション|  
+        |---------------|---------------------------------|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`anonymousForCertificateSecurity`|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`kerberosSecurity`|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`mutualCertificate10Security`\*|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`mutualCertificate11Security`\*|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`usernameOverTransportSecurity`|  
+        |<xref:System.ServiceModel.Configuration.AuthenticationMode>|`usernameForCertificateSecurity`|  
+  
+         \* `mutualCertificate10Security` と `mutualCertificate11Security` の設定不要のセキュリティ アサーションとの主な相違点の 1 つに、WSE が SOAP メッセージのセキュリティ保護で使用する WS\-Security 仕様のバージョンがあります。`mutualCertificate10Security` では WS\-Security 1.0 が使用され、`mutualCertificate11Security` では WS\-Security 1.1 が使用されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-Security 仕様のバージョンは [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)の `messageSecurityVersion` 属性で指定されます。  
+  
+         セキュリティ保護された SOAP メッセージで使用される WS\-Security 仕様のバージョンを設定するには、[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)の `messageSecurityVersion` 属性を設定します。WSE 3.0 と相互運用するには、`messageSecurityVersion` 属性の値を <xref:System.ServiceModel.MessageSecurityVersion.WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10%2A> に設定します。  
+  
+    4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が 2004 年 8 月版の WS\-Addressing 仕様を使用することを指定するには、[\<textMessageEncoding\>](../../../../docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md)を追加し、その `messageVersion` の値を <xref:System.ServiceModel.Channels.MessageVersion.Soap11WSAddressingAugust2004%2A> に設定します。  
+  
+        > [!NOTE]
+        >  SOAP 1.2 の使用時には、`messageVersion` 属性を <xref:System.ServiceModel.Channels.MessageVersion.Soap12WSAddressingAugust2004%2A> に設定します。  
+  
+2.  サービスがカスタム バインディングを使用するように指定します。  
+  
+    1.  [\<endpoint\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md)要素の `binding` 属性を `customBinding` に設定します。  
+  
+    2.  [\<endpoint\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md)要素の `bindingConfiguration` 属性をカスタム バインディングの[\<binding\>](../../../../docs/framework/misc/binding.md)の `name` 属性で指定されている値に設定します。  
+  
+## 使用例  
+ 次のコード例では、`Service.HelloWorldService` が WSE 3.0 クライアントと相互運用するためにカスタム バインディングを使用するように指定します。カスタム バインディングには 2004 年 8 月版の WS\-Addressing が指定され、WS\-Security 1.1 の一連の仕様が、交換されるメッセージのエンコードに使用されます。メッセージは、<xref:System.ServiceModel.Configuration.AuthenticationMode> 認証モードを使用してセキュリティ保護されます。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+        behaviorConfiguration="ServiceBehavior"   
+        name="Service.HelloWorldService">  
+        <endpoint binding="customBinding" address=""  
+          bindingConfiguration="ServiceBinding"  
+          contract="Service.IHelloWorld"></endpoint>  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <customBinding>  
+        <binding name="ServiceBinding">  
+          <security authenticationMode="AnonymousForCertificate"  
+                  messageProtectionOrder="SignBeforeEncrypt"  
+                  messageSecurityVersion="WSSecurity11WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10"  
+                  requireDerivedKeys="false">  
+          </security>  
+          <textMessageEncoding messageVersion ="Soap11WSAddressingAugust2004"></textMessageEncoding>  
+          <httpTransport/>  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    <behaviors>  
+      <behavior name="ServiceBehavior" returnUnknownExceptionsAsFaults="true">  
+        <serviceCredentials>  
+          <serviceCertificate findValue="CN=WCFQuickstartServer" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectDistinguishedName"/>  
+        </serviceCredentials>  
+      </behavior>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [方法 : システム指定のバインディングをカスタマイズする](../../../../docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-consistently-reference-x-509-certificates.md b/docs/framework/wcf/feature-details/how-to-consistently-reference-x-509-certificates.md
new file mode 100644
index 00000000000..0712a649f6c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-consistently-reference-x-509-certificates.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : 一貫性を保って X.509 証明書を参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], X.509 証明書の参照"
+ms.assetid: a6de1c63-e450-4640-ad08-ad7302dbfbfc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : 一貫性を保って X.509 証明書を参照する
+証明書を識別する方法には、証明書のハッシュを使用する方法、発行者とシリアル番号を使用する方法、またはサブジェクト キー識別子 \(SKI\) を使用する方法があります。SKI を使用すると、証明書のサブジェクト公開キーを一意に識別できます。SKI は、XML デジタル署名を処理する場合によく使用されます。SKI の値は、通常、*X.509 証明書の拡張*として X.509 証明書の一部を構成します。SKI 拡張が証明書に見つからない場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、発行者とシリアル番号を使用する既定の*参照スタイル*を使用します。証明書に SKI 拡張が含まれる場合、既定の参照スタイルは SKI を使用してその証明書を識別します。アプリケーションの開発中に、SKI 拡張を使用しない証明書から SKI 拡張を使用する証明書に切り替えた場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が生成するメッセージに使用される参照スタイルも変更されます。  
+  
+ SKI 拡張が存在するかどうかに関係なく、一貫性のある参照スタイルが必要な場合は、次のコードに示されているような参照スタイルを構成できます。  
+  
+## 使用例  
+ 次の例では、1 つの一貫した参照スタイル \(ユーザー名とシリアル番号\) を使用するカスタム セキュリティ バインド要素を作成します。  
+  
+ [!code-csharp[c_ReferencingCertificatesConsistently#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_referencingcertificatesconsistently/cs/source.cs#1)]
+ [!code-vb[c_ReferencingCertificatesConsistently#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_referencingcertificatesconsistently/vb/source.vb#1)]  
+  
+## コードのコンパイル  
+ 次の名前空間は以下のコードのコンパイルに必要です。  
+  
+-   <xref:System>  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.ServiceModel.Channels>  
+  
+-   <xref:System.ServiceModel.Security.Tokens>  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-control-service-instancing.md b/docs/framework/wcf/feature-details/how-to-control-service-instancing.md
new file mode 100644
index 00000000000..442ff62d8c1
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-control-service-instancing.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : サービスのインスタンス化を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: e0b12b34-8004-443a-a46d-83a5c00f2601
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 方法 : サービスのインスタンス化を制御する
+サービスのインスタンス モードを設定することにより、<xref:System.ServiceModel.InstanceContext?displayProperty=fullName> \(およびそのユーザー定義のサービス オブジェクト\) をいつ生成するかを指定できます。  設定できるモードについては、<xref:System.ServiceModel.InstanceContextMode> 列挙体を参照してください。  動作[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[動作を使用したランタイムの構成と拡張](../../../../docs/framework/wcf/extending/configuring-and-extending-the-runtime-with-behaviors.md)」を参照してください。  実施例については、「[動作](../../../../docs/framework/wcf/samples/behaviors.md)」を参照してください。  
+  
+### サービス インスタンスの有効期間をコードで制御するには  
+  
+1.  サービス クラスに <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性を適用します。  
+  
+2.  <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティを <xref:System.ServiceModel.InstanceContextMode>、<xref:System.ServiceModel.InstanceContextMode>、<xref:System.ServiceModel.InstanceContextMode> のいずれかの値に設定します。  
+  
+     [!code-csharp[C_ControlServiceInstancing#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_controlserviceinstancing/cs/source.cs#1)]
+     [!code-vb[C_ControlServiceInstancing#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_controlserviceinstancing/vb/source.vb#1)]  
+  
+## 使用例  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性の <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティを <xref:System.ServiceModel.InstanceContextMode> に設定するコード例を示します。  
+  
+ [!code-csharp[c_ControlServiceInstancing#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_controlserviceinstancing/cs/source.cs#2)]
+ [!code-vb[c_ControlServiceInstancing#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_controlserviceinstancing/vb/source.vb#2)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute>   
+ <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A>   
+ <xref:System.ServiceModel.InstanceContextMode>   
+ [Service: Behaviors Samples](http://msdn.microsoft.com/ja-jp/4e3c6513-a7ff-4b35-8dcf-b5506c6f39a7)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-basic-atom-feed.md b/docs/framework/wcf/feature-details/how-to-create-a-basic-atom-feed.md
new file mode 100644
index 00000000000..f7a7ea4b117
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-basic-atom-feed.md
@@ -0,0 +1,105 @@
+---
+title: "方法 : 基本的な ATOM フィードを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6e0cacc1-9b11-4665-adb7-577a62626fd6
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 基本的な ATOM フィードを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、配信フィードを公開するサービスを作成できます。ここでは、ATOM 配信フィードを公開する配信サービスを作成する方法について説明します。  
+  
+### 基本的な配信サービスを作成するには  
+  
+1.  <xref:System.ServiceModel.Web.WebGetAttribute> 属性でマークされたインターフェイスを使用して、サービス コントラクトを定義します。配信フィードとして公開される各操作は、<xref:System.ServiceModel.Syndication.Atom10FeedFormatter> オブジェクトを返す必要があります。  
+  
+     [!code-csharp[htAtomBasic#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#0)]
+     [!code-vb[htAtomBasic#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#0)]  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceModel.Web.WebGetAttribute> を適用するすべてのサービス操作は、HTTP GET 要求にマッピングされます。他の HTTP メソッドに操作をマッピングするには、代わりに <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md).  
+  
+2.  サービス コントラクトを実装します。  
+  
+     [!code-csharp[htAtomBasic#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#1)]
+     [!code-vb[htAtomBasic#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#1)]  
+  
+3.  <xref:System.ServiceModel.Syndication.SyndicationFeed> オブジェクトを作成し、作成者、カテゴリ、および説明を追加します。  
+  
+     [!code-csharp[htAtomBasic#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#2)]
+     [!code-vb[htAtomBasic#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#2)]  
+  
+4.  複数の <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトを作成します。  
+  
+     [!code-csharp[htAtomBasic#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#3)]
+     [!code-vb[htAtomBasic#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#3)]  
+  
+5.  <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトをフィードに追加します。  
+  
+     [!code-csharp[htAtomBasic#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#4)]
+     [!code-vb[htAtomBasic#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#4)]  
+  
+6.  フィードを返します。  
+  
+     [!code-csharp[htAtomBasic#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#5)]
+     [!code-vb[htAtomBasic#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#5)]  
+  
+### サービスをホストするには  
+  
+1.  <xref:System.ServiceModel.Web.WebServiceHost> オブジェクトを作成します。  
+  
+     [!code-csharp[htAtomBasic#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#6)]
+     [!code-vb[htAtomBasic#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#6)]  
+  
+2.  サービス ホストを開き、サービスからフィードを読み込み、フィードを表示してから、ユーザーが Enter キーを押すのを待ちます。  
+  
+     [!code-csharp[htAtomBasic#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#8)]
+     [!code-vb[htAtomBasic#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#8)]  
+  
+### HTTP GET で GetBlog\(\) を呼び出すには  
+  
+1.  Internet Explorer を開いて「http:\/\/localhost:8000\/BlogService\/GetBlog」という URL を入力し、Enter キーを押します。  
+  
+     この URL には、サービスのベース アドレス \(http:\/\/localhost:8000\/BlogService\)、エンドポイントの相対アドレス、および呼び出すサービス操作が含まれます。  
+  
+### コードから GetBlog\(\) を呼び出すには  
+  
+1.  ベース アドレスと呼び出すメソッドを使用して <xref:System.Xml.XmlReader> を作成します。  
+  
+     [!code-csharp[htAtomBasic#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/snippets.cs#9)]
+     [!code-vb[htAtomBasic#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/snippets.vb#9)]  
+  
+2.  静的な <xref:System.ServiceModel.Syndication.SyndicationFeed.Load%28System.Xml.XmlReader%29> メソッドを呼び出し、作成した <xref:System.Xml.XmlReader> を渡します。  
+  
+     [!code-csharp[htAtomBasic#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/snippets.cs#10)]
+     [!code-vb[htAtomBasic#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/snippets.vb#10)]  
+  
+     これにより、サービス操作が呼び出され、サービス操作から返されたフォーマッタが新しい <xref:System.ServiceModel.Syndication.SyndicationFeed> に設定されます。  
+  
+3.  フィード オブジェクトにアクセスします。  
+  
+     [!code-csharp[htAtomBasic#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/snippets.cs#11)]
+     [!code-vb[htAtomBasic#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/snippets.vb#11)]  
+  
+## 使用例  
+ この例の完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[htAtomBasic#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatombasic/cs/program.cs#12)]
+ [!code-vb[htAtomBasic#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatombasic/vb/program.vb#12)]  
+  
+## コードのコンパイル  
+ 上記のコードのコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll が参照されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md b/docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md
new file mode 100644
index 00000000000..b52f906b69a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト [WCF], クラスまたは構造体に作成"
+  - "DataContractAttribute クラス"
+  - "DataMemberAttribute"
+ms.assetid: bc464889-3070-4a2f-91d2-e788a0f686a7
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# 方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する
+このトピックでは、クラスまたは構造体を使用してデータ コントラクトを作成する基本的な手順を示します。  データ コントラクトおよびその使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)」を参照してください。  
+  
+ 基本的な [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスおよびクライアントの作成方法を順を追って解説したチュートリアルが必要な場合は、「[チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  基本的なサービスとクライアントで構成される実際のサンプル アプリケーションについては、「[基本的なデータ コントラクト](../../../../docs/framework/wcf/samples/basic-data-contract.md)」を参照してください。  
+  
+### クラスまたは構造体に基本的なデータ コントラクトを作成するには  
+  
+1.  クラスに <xref:System.Runtime.Serialization.DataContractAttribute> 属性を適用することにより、データ コントラクトを持つ型であることを宣言します。  パブリック型は、属性のないものも含めてすべてシリアル化されます。  <xref:System.Runtime.Serialization.DataContractAttribute> 属性がない場合は、<xref:System.Runtime.Serialization.DataContractSerializer> によってデータ コントラクトが推論されます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)」を参照してください。  
+  
+2.  シリアル化するメンバー \(プロパティ、フィールド、またはイベント\) を定義します。これは、該当する各メンバーに <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用することで行います。  このようなメンバーのことを、データ メンバーと呼びます。  既定では、すべてのパブリック型がシリアル化されます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  プライベート フィールドであっても、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用すると、データが外部に公開されることになります。  機密性のあるデータが含まれていないかどうか確認してください。  
+  
+## 使用例  
+ 次の例では、<xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性をクラスとそのメンバーに適用して、`Person` 型のデータ コントラクトを作成する方法を示します。  
+  
+ [!code-csharp[DataContractAttribute#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/datacontractattribute/cs/overview.cs#2)]
+ [!code-vb[DataContractAttribute#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/datacontractattribute/vb/overview.vb#2)]  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)   
+ [概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-basic-rss-feed.md b/docs/framework/wcf/feature-details/how-to-create-a-basic-rss-feed.md
new file mode 100644
index 00000000000..2f1ef8fcb79
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-basic-rss-feed.md
@@ -0,0 +1,103 @@
+---
+title: "方法 : 基本的な RSS フィードを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 431879b8-a5f8-4947-ad1e-4768c726aca8
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : 基本的な RSS フィードを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、配信フィードを公開するサービスを作成できます。ここでは、RSS 配信フィードを公開する配信サービスを作成する方法について説明します。  
+  
+### 基本的な配信サービスを作成するには  
+  
+1.  <xref:System.ServiceModel.Web.WebGetAttribute> 属性でマークされたインターフェイスを使用して、サービス コントラクトを定義します。配信フィードとして公開される各操作は、<xref:System.ServiceModel.Syndication.Rss20FeedFormatter> オブジェクトを返す必要があります。  
+  
+     [!code-csharp[htRssBasic#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#0)]
+     [!code-vb[htRssBasic#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#0)]  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceModel.Web.WebGetAttribute> 属性を適用するすべてのサービス操作は、HTTP GET 要求にマッピングされます。他の HTTP メソッドに操作をマッピングするには、代わりに <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md).  
+  
+2.  サービス コントラクトを実装します。  
+  
+     [!code-csharp[htRssBasic#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#1)]
+     [!code-vb[htRssBasic#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#1)]  
+  
+3.  <xref:System.ServiceModel.Syndication.SyndicationFeed> オブジェクトを作成し、作成者、カテゴリ、および説明を追加します。  
+  
+     [!code-csharp[htRssBasic#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#2)]
+     [!code-vb[htRssBasic#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#2)]  
+  
+4.  複数の <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトを作成します。  
+  
+     [!code-csharp[htRssBasic#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#3)]
+     [!code-vb[htRssBasic#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#3)]  
+  
+5.  <xref:System.ServiceModel.Syndication.SyndicationItem> をフィードに追加します。  
+  
+     [!code-csharp[htRssBasic#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#4)]
+     [!code-vb[htRssBasic#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#4)]  
+  
+6.  フィードを返します。  
+  
+     [!code-csharp[htRssBasic#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#5)]
+     [!code-vb[htRssBasic#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#5)]  
+  
+### サービスをホストするには  
+  
+1.  <xref:System.ServiceModel.Web.WebServiceHost> オブジェクトを作成します。  
+  
+     [!code-csharp[htRssBasic#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#6)]
+     [!code-vb[htRssBasic#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#6)]  
+  
+2.  サービス ホストを開き、ユーザーが Enter キーを押すのを待ちます。  
+  
+     [!code-csharp[htRssBasic#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#8)]
+     [!code-vb[htRssBasic#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#8)]  
+  
+### HTTP GET で GetBlog\(\) を呼び出すには  
+  
+1.  Internet Explorer を開いて「http:\/\/localhost:8000\/BlogService\/GetBlog」という URL を入力し、Enter キーを押します。この URL には、サービスのベース アドレス \(http:\/\/localhost:8000\/BlogService\)、エンドポイントの相対アドレス、および呼び出すサービス操作が含まれます。  
+  
+### コードから GetBlog\(\) を呼び出すには  
+  
+1.  ベース アドレスと呼び出すメソッドを使用して <xref:System.Xml.XmlReader> を作成します。  
+  
+     [!code-csharp[htRssBasic#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/snippets.cs#9)]
+     [!code-vb[htRssBasic#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/snippets.vb#9)]  
+  
+2.  静的な <xref:System.ServiceModel.Syndication.SyndicationFeed.Load%28System.Xml.XmlReader%29> メソッドを呼び出し、作成した <xref:System.Xml.XmlReader> を渡します。  
+  
+     [!code-csharp[htRssBasic#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/snippets.cs#10)]
+     [!code-vb[htRssBasic#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/snippets.vb#10)]  
+  
+     これにより、サービス操作が呼び出され、サービス操作から返されたフォーマッタが新しい <xref:System.ServiceModel.Syndication.SyndicationFeed> に設定されます。  
+  
+3.  フィード オブジェクトにアクセスします。  
+  
+     [!code-csharp[htRssBasic#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/snippets.cs#11)]
+     [!code-vb[htRssBasic#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/snippets.vb#11)]  
+  
+## 使用例  
+ この例の完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[htRssBasic#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/htrssbasic/cs/program.cs#12)]
+ [!code-vb[htRssBasic#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htrssbasic/vb/program.vb#12)]  
+  
+## コードのコンパイル  
+ 上記のコードのコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll が参照されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md b/docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md
new file mode 100644
index 00000000000..91300238cfe
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md
@@ -0,0 +1,123 @@
+---
+title: "方法 : 基本的な WCF Web HTTP サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 877662d3-d372-4e08-b417-51f66a0095cd
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 方法 : 基本的な WCF Web HTTP サービスを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、Web エンドポイントを公開するサービスを作成できます。Web エンドポイントは、XML または JSON でデータを送信します。SOAP エンベロープはありません。ここでは、このようなエンドポイントを公開する方法を示します。  
+  
+> [!NOTE]
+>  Web エンドポイントをセキュリティで保護する唯一の方法は、トランスポート セキュリティを使用する HTTPS を介してエンドポイントを公開することです。メッセージ ベースのセキュリティを使用する場合、セキュリティ情報は通常 SOAP ヘッダーに配置されます。SOAP 以外のエンドポイントに送信するメッセージには SOAP エンベロープが含まれないため、セキュリティ情報を配置する場所がなく、トランスポート セキュリティに依存する必要があります。  
+  
+### Web エンドポイントを作成するには  
+  
+1.  <xref:System.ServiceModel.ServiceContractAttribute>、<xref:System.ServiceModel.Web.WebInvokeAttribute>、および <xref:System.ServiceModel.Web.WebGetAttribute> の各属性でマークされたインターフェイスを使用して、サービス コントラクトを定義します。  
+  
+     [!code-csharp[htBasicService#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#0)]
+     [!code-vb[htBasicService#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#0)]  
+  
+    > [!NOTE]
+    >  既定では、<xref:System.ServiceModel.Web.WebInvokeAttribute> は POST 呼び出しを操作にマッピングします。ただし、"method\=" パラメーターを指定することで、操作にマッピングする HTTP メソッド \(HEAD、PUT、DELETE など\) を指定できます。<xref:System.ServiceModel.Web.WebGetAttribute> には "method\=" パラメーターがないため、サービス操作には GET 呼び出しのみがマッピングされます。  
+  
+2.  サービス コントラクトを実装します。  
+  
+     [!code-csharp[htBasicService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#1)]
+     [!code-vb[htBasicService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#1)]  
+  
+### サービスをホストするには  
+  
+1.  <xref:System.ServiceModel.Web.WebServiceHost> オブジェクトを作成します。  
+  
+     [!code-csharp[htBasicService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#2)]
+     [!code-vb[htBasicService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#2)]  
+  
+2.  <xref:System.ServiceModel.Description.WebHttpBehavior> を持つ <xref:System.ServiceModel.Description.ServiceEndpoint> を追加します。  
+  
+     [!code-csharp[htBasicService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#3)]
+     [!code-vb[htBasicService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#3)]  
+  
+    > [!NOTE]
+    >  エンド ポイントを追加しない場合は、<xref:System.ServiceModel.Web.WebServiceHost> が自動的に既定のエンド ポイントを作成します。<xref:System.ServiceModel.Web.WebServiceHost> は、ほかにも <xref:System.ServiceModel.Description.WebHttpBehavior> を追加し、HTTP ヘルプ ページと Web サービス記述言語 \(WSDL\) GET 機能を無効にすることによって、メタデータ エンドポイントが既定の HTTP エンドポイントに干渉しないようにします。  
+    >   
+    >  URL が "" である SOAP 以外のエンドポイントを追加すると、エンドポイント上の操作の呼び出しを行うときに予期しない動作が発生します。これはエンドポイントのリッスン URI が、ヘルプ ページ \([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのベース アドレスに移動すると表示されるページ\) の URI と同じになるためです。  
+  
+     これを回避するには、次のいずれかの操作を行います。  
+  
+    -   SOAP 以外のエンドポイントについては、空ではない URI を指定するようにします。  
+  
+    -   ヘルプ ページを無効にします。これは、次のコードで実現できます。  
+  
+     [!code-csharp[htBasicService#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/snippets.cs#4)]
+     [!code-vb[htBasicService#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/snippets.vb#4)]  
+  
+3.  サービス ホストを開き、ユーザーが Enter キーを押すのを待ちます。  
+  
+     [!code-csharp[htBasicService#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/snippets.cs#5)]
+     [!code-vb[htBasicService#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/snippets.vb#5)]  
+  
+     このサンプルでは、コンソール アプリケーションで Web スタイル サービスをホストする方法を示します。IIS からこのようなサービスをホストすることもできます。これを行うには、次のコードに示すように、.svc ファイルで <xref:System.ServiceModel.Activation.WebServiceHostFactory> クラスを指定します。  
+  
+    ```  
+    <%ServiceHost   
+        language=c#  
+        Debug="true"  
+        Service="Microsoft.Samples.Service"  
+        Factory=System.ServiceModel.Activation.WebServiceHostFactory%>  
+    ```  
+  
+### Internet Explorer で GET にマッピングされたサービス操作を呼び出すには  
+  
+1.  Internet Explorer を開いて「`http://localhost:8000/EchoWithGet?s=Hello, world!`」と入力し、Enter キーを押します。この URL には、サービスのベース アドレス \("http:\/\/localhost:8000\/"\) が含まれており、エンドポイントの相対アドレス \(""\)、呼び出しを行うサービス操作 \("EchoWithGet"\)、疑問符の後にアンパサンド \(&\) で区切られた名前付きパラメーターのリストが続きます。  
+  
+### コードからサービス操作を呼び出すには  
+  
+1.  `using` ブロック内で <xref:System.ServiceModel.Web.WebChannelFactory> のインスタンスを作成します。  
+  
+     [!code-csharp[htBasicService#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#6)]
+     [!code-vb[htBasicService#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#6)]  
+  
+2.  <xref:System.ServiceModel.ChannelFactory> が呼び出すエンドポイントに <xref:System.ServiceModel.Description.WebHttpBehavior> を追加します。  
+  
+     [!code-csharp[htBasicService#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#7)]
+     [!code-vb[htBasicService#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#7)]  
+  
+3.  チャネルを作成し、サービスを呼び出します。  
+  
+     [!code-csharp[htBasicService#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#8)]
+     [!code-vb[htBasicService#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#8)]  
+  
+4.  <xref:System.ServiceModel.Web.WebServiceHost> を閉じます。  
+  
+     [!code-csharp[htBasicService#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#9)]
+     [!code-vb[htBasicService#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#9)]  
+  
+## 使用例  
+ この例の完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[htBasicService#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htbasicservice/cs/service.cs#10)]
+ [!code-vb[htBasicService#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htbasicservice/vb/service.vb#10)]  
+  
+## コードのコンパイル  
+ Service.cs のコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll が参照されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>   
+ <xref:System.ServiceModel.Web.WebInvokeAttribute>   
+ <xref:System.ServiceModel.Web.WebServiceHost>   
+ <xref:System.ServiceModel.Web.WebChannelFactory>   
+ <xref:System.ServiceModel.Description.WebHttpBehavior>   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-channel-factory-and-use-it-to-create-and-manage-channels.md b/docs/framework/wcf/feature-details/how-to-create-a-channel-factory-and-use-it-to-create-and-manage-channels.md
new file mode 100644
index 00000000000..156a2cb972c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-channel-factory-and-use-it-to-create-and-manage-channels.md
@@ -0,0 +1,28 @@
+---
+title: "方法 : チャネル ファクトリを作成および使用して、チャネルを作成および管理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 018dcc30-9f61-419e-af8e-412a85e8d282
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 方法 : チャネル ファクトリを作成および使用して、チャネルを作成および管理する
+<xref:System.ServiceModel.DuplexChannelFactory%601> クラスは、クライアントがサービス エンドポイントとの間でメッセージを送受信するために使用する、さまざまな種類の双方向チャネルを作成したり、管理したりする手段を提供します。  
+  
+## 使用例  
+ 次のコードは、チャネル ファクトリを作成および使用して、チャネルを作成および管理する方法を示しています。  
+  
+ [!code-csharp[S_CustomAuthentication#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_customauthentication/cs/instance.cs#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.DuplexChannelFactory%601>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md b/docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md
new file mode 100644
index 00000000000..148fd3fe036
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md
@@ -0,0 +1,119 @@
+---
+title: "方法 : SecurityBindingElement を使用してカスタム バインドを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF] カスタム バインディングの作成"
+ms.assetid: 203a9f9e-3a73-427c-87aa-721c56265b29
+caps.latest.revision: 19
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 19
+---
+# 方法 : SecurityBindingElement を使用してカスタム バインドを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] にはシステム指定のバインディングがいくつか含まれています。これらのバインディングは構成できますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がサポートするすべてのセキュリティ オプションを構成しようとする場合には十分な柔軟性が得られません。 ここでは、個別のバインド要素からカスタム バインドを直接作成する方法を説明し、このようなバインディングを作成する場合に指定できるセキュリティ設定のいくつかに焦点を当てます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]カスタム バインディングを作成するを参照してください[バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)します。  
+  
+> [!WARNING]
+>  <xref:System.ServiceModel.Channels.SecurityBindingElement>はサポートしていません、 <xref:System.ServiceModel.Channels.IDuplexSessionChannel>チャネル形状をチャネル形状によって使用される既定の TCP は、トランスポートの場合に<xref:System.ServiceModel.TransferMode>に設定されている<xref:System.ServiceModel.TransferMode.Buffered>します。 設定する必要があります<xref:System.ServiceModel.TransferMode>に<xref:System.ServiceModel.TransferMode.Streamed>を使用するために<xref:System.ServiceModel.Channels.SecurityBindingElement>このシナリオでします。  
+  
+## <a name="creating-a-custom-binding"></a>カスタム バインドの作成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]のすべてのバインドが構成されている*バインド要素*します。 派生した各バインド要素、 <xref:System.ServiceModel.Channels.BindingElement>クラスです。 標準のシステム指定のバインディングの場合、バインド要素は自動的に作成および構成されます。ただし、プロパティ設定の一部はカスタマイズが可能です。  
+  
+ これに対し、カスタム バインディングを作成するバインド要素作成および構成されると、 <xref:System.ServiceModel.Channels.CustomBinding>のバインド要素から作成します。  
+  
+ これを行うには、インスタンスによって表されるコレクションに個別のバインド要素を追加した、 <xref:System.ServiceModel.Channels.BindingElementCollection>クラス、および設定し、`Elements`のプロパティ、`CustomBinding`そのオブジェクトと等しい。 バインド要素は、トランザクション フロー、信頼できるセッション、セキュリティ、複合二重、一方向、ストリーム セキュリティ、メッセージ エンコーディング、トランスポートの順に追加する必要があります。 どのバインディングでも、これらすべてのバインド要素が必要になるとは限りません。  
+  
+## <a name="securitybindingelement"></a>SecurityBindingElement  
+ 次の&3; つのバインド要素から派生できるすべてのメッセージ レベルのセキュリティに関連、 <xref:System.ServiceModel.Channels.SecurityBindingElement>クラスです。 3 つ<xref:System.ServiceModel.Channels.TransportSecurityBindingElement>、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>、および<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>します。 <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>混合モード セキュリティを提供するために使用します。 他の&2; つの要素は、メッセージ層でセキュリティを提供する場合に使用します。  
+  
+ トランスポート レベルのセキュリティが提供される場合は、次の追加のクラスが使用されます。  
+  
+-   <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>  
+  
+## <a name="required-binding-elements"></a>必要なバインド要素  
+ 1 つのバインディングに結合できる可能性のあるバインド要素は多数存在します。 これらの組み合わせすべてが有効なわけではありません。 ここでは、セキュリティ バインディングに存在する必要のある要素について説明します。  
+  
+ 有効なセキュリティ バインディングは、次のような多くの要因に依存します。  
+  
+-   セキュリティ モード  
+  
+-   トランスポート プロトコル  
+  
+-   コントラクトに指定されているメッセージ交換パターン (MEP)  
+  
+ 前述の要因の各組み合わせに有効なバインド要素のスタックの構成を次の表に示します。 これらは最小限の要件であることに注意してください。 メッセージ エンコーディング バインド要素、トランザクション バインド要素などの追加のバインド要素をバインディングに追加することもできます。  
+  
+|セキュリティ モード|Transport|コントラクトのメッセージ交換パターン|コントラクトのメッセージ交換パターン|コントラクトのメッセージ交換パターン|  
+|-------------------|---------------|---------------------------------------|---------------------------------------|---------------------------------------|  
+|||`Datagram`|`Request Reply`|`Duplex`|  
+|Transport|Https||||  
+|||OneWayBindingElement|||  
+|||HttpsTransportBindingElement|HttpsTransportBindingElement||  
+||TCP||||  
+|||OneWayBindingElement|||  
+|||SSL または Windows StreamSecurityBindingElement|SSL または Windows StreamSecurityBindingElement|SSL または Windows StreamSecurityBindingElement|  
+|||TcpTransportBindingElement|TcpTransportBindingElement|TcpTransportBindingElement|  
+|メッセージ|Http|SymmetricSecurityBindingElement|SymmetricSecurityBindingElement|SymmetricSecurityBindingElement (認証モード = SecureConversation)|  
+|||||CompositeDuplexBindingElement|  
+|||OneWayBindingElement||OneWayBindingElement|  
+|||HttpTransportBindingElement|HttpTransportBindingElement|HttpTransportBindingElement|  
+||Tcp|SecurityBindingElement|SecurityBindingElement|SymmetricSecurityBindingElement (認証モード = SecureConversation)|  
+|||TcpTransportBindingElement|TcpTransportBindingElement|TcpTransportBindingElement|  
+|混合 (メッセージ資格情報付きトランスポート)|Https|TransportSecurityBindingElement|TransportSecurityBindingElement||  
+|||OneWayBindingElement|||  
+|||HttpsTransportBindingElement|HttpsTransportBindingElement||  
+||TCP|TransportSecurityBindingElement|SymmetricSecurityBindingElement (認証モード = SecureConversation)|SymmetricSecurityBindingElement (認証モード = SecureConversation)|  
+|||OneWayBindingElement|||  
+|||SSL または Windows StreamSecurityBindingElement|SSL または Windows StreamSecurityBindingElement|SSL または Windows StreamSecurityBindingElement|  
+|||TcpTransportBindingElement|TcpTransportBindingElement|TcpTransportBindingElement|  
+  
+ SecurityBindingElements には構成可能な設定が多数あることに注意してください。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)します。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][メッセージ交換とセッションをセキュリティで保護](../../../../docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md)します。  
+  
+## <a name="procedures"></a>手順  
+  
+#### <a name="to-create-a-custom-binding-that-uses-a-symmetricsecuritybindingelement"></a>SymmetricSecurityBindingElement を使用するカスタム バインドを作成するには  
+  
+1.  インスタンスを作成、 <xref:System.ServiceModel.Channels.BindingElementCollection>名前を持つクラス`outputBec`します。  
+  
+2.  静的メソッドを呼び出して`M:System.ServiceModel.Channels.SecurityBindingElement.CreateSspiNegotiationBindingElement(true)`のインスタンスを返す、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>クラスです。  
+  
+3.  追加、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>コレクション (`outputBec`) を呼び出して、`Add`のメソッド、<xref:System.Collections.ObjectModel.Collection%601>の<xref:System.ServiceModel.Channels.BindingElement>クラスです。  
+  
+4.  インスタンスを作成、 <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>クラスにし、コレクションに追加 (`outputBec`)。 これにより、バインディングによって使用されるエンコーディングが指定されます。  
+  
+5.  作成、 <xref:System.ServiceModel.Channels.HttpTransportBindingElement>コレクションに追加し、(`outputBec`)。 これにより、バインディングが HTTP トランスポートを使用することが指定されます。  
+  
+6.  インスタンスを作成することで、新しいカスタム バインドを作成、 <xref:System.ServiceModel.Channels.CustomBinding>クラスとコレクションを渡す`outputBec`コンス トラクターにします。  
+  
+7.  作成されたカスタム バインディングは、標準と同じ特性を数多く共有<xref:System.ServiceModel.WSHttpBinding>します。 カスタム バインディングではメッセージ レベルのセキュリティと Windows 資格情報が指定されていますが、セキュリティで保護されたセッションは無効になっているため、サービス資格情報が帯域外で指定される必要があり、また署名も暗号化されません。 最後は設定によってのみ制御できます、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.MessageProtectionOrder%2A>プロパティ手順 4. で示したようにします。 他の&2; つについては、標準バインディングの設定を使用することで制御できます。  
+  
+## <a name="example"></a>例  
+  
+### <a name="description"></a>説明  
+ 次の例を使用するカスタム バインディングを作成する関数全体を提供する、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>します。  
+  
+### <a name="code"></a>コード  
+ [!code-csharp[c_CustomBinding#20](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#20)]
+ [!code-vb[c_CustomBinding#20](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_custombinding/vb/source.vb#20)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)   
+ [システム指定のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md b/docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md
new file mode 100644
index 00000000000..da530b35a9f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md
@@ -0,0 +1,81 @@
+---
+title: "方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa772232-da1f-4c66-8c94-e36c0584b549
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する
+ここでは、信頼できるセッションを使用した SSL \(Secure Sockets Layer\) トランスポート セキュリティの使用方法について説明します。  HTTPS 上で信頼できるセッションを使用するには、信頼できるセッションと HTTPS トランスポートを使用するカスタム バインディングを作成する必要があります。  信頼できるセッションを有効にするには、コードを使用して強制的に行うか、構成ファイルで宣言します。  この手順では、クライアントとサービスの構成ファイルを使用して、信頼できるセッションと [\<httpsTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httpstransport.md) 要素を有効にします。  
+  
+ この手順で重要なのは、`endpoint` 構成要素に "reliableSessionOverHttps" という名前のカスタム バインディング構成を参照する `bindingConfiguration` 属性が含まれていることです。  その後、[\<binding\>](../../../../docs/framework/misc/binding.md) 構成要素は、この名前を参照して、`reliableSession` 要素と `httpsTransport` 要素を含めることにより、信頼できるセッションと HTTPS トランスポートの使用を指定できます。  
+  
+ この例のソースのコピーについては、「[HTTPS を介したカスタム バインディングの信頼できるセッション](../../../../docs/framework/wcf/samples/custom-binding-reliable-session-over-https.md)」を参照してください。  
+  
+### HTTPS で信頼できるセッションを使用するためにサービスを CustomBinding で構成するには  
+  
+1.  サービスの種類にサービス コントラクトを定義します。  
+  
+     [!code-csharp[c_HowTo_CreateReliableSessionHTTPS#1121](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createreliablesessionhttps/cs/service.cs#1121)]  
+  
+2.  サービス クラスにサービス コントラクトを実装します。  アドレス情報とバインディング情報はサービスの実装内では指定されないことに注意してください。  同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[c_HowTo_CreateReliableSessionHTTPS#1122](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createreliablesessionhttps/cs/service.cs#1122)]  
+  
+3.  Web.config ファイルを作成し、信頼できるセッションと HTTPS トランスポートを使用する "reliableSessionOverHttps" というカスタムバインディングを使用して、`CalculatorService` のエンドポイントを構成します。  
+  
+     [!code[c_HowTo_CreateReliableSessionHTTPS#2111](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_createreliablesessionhttps/common/web.config#2111)]  
+  
+4.  次の行を含む Service.svc ファイルを作成します。  
+  
+    ```  
+    <%@ServiceHost language=c# Service="CalculatorService" %>   
+    ```  
+  
+5.  インターネット インフォメーション サービス \(IIS\) 仮想ディレクトリに Service.svc ファイルを配置します。  
+  
+### HTTPS で信頼できるセッションを使用するためにクライアントを CustomBinding で構成するには  
+  
+1.  コマンド ラインから [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行して、サービス メタデータからコードを生成します。  
+  
+    ```  
+    Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+    ```  
+  
+2.  生成されたクライアントには、クライアントの実装時に満たされなければならないサービス コントラクトを定義する `ICalculator` インターフェイスが含まれます。  
+  
+     [!code-csharp[C_HowTo_CreateReliableSessionHTTPS#1221](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createreliablesessionhttps/cs/client.cs#1221)]  
+  
+3.  生成されたクライアント アプリケーションは `ClientCalculator` も実装します。  このサービスの実装では、アドレス情報とバインディング情報が指定されないことに注意してください。  同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[C_HowTo_CreateReliableSessionHTTPS#1222](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createreliablesessionhttps/cs/client.cs#1222)]  
+  
+4.  HTTPS トランスポートと信頼できるセッションを使用する "reliableSessionOverHttps" という名前のカスタム バインディングを構成します。  
+  
+     [!code[C_HowTo_CreateReliableSessionHTTPS#2211](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_createreliablesessionhttps/common/app.config#2211)]  
+  
+5.  アプリケーションで `ClientCalculator` のインスタンスを作成し、サービス操作を呼び出します。  
+  
+     [!code-csharp[C_HowTo_CreateReliableSessionHTTPS#1223](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createreliablesessionhttps/cs/client.cs#1223)]  
+  
+6.  クライアントをコンパイルして実行します。  
+  
+## 使用例  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## .NET Framework セキュリティ  
+ このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザーで https:\/\/localhost\/servicemodelsamples\/service.svc のような HTTPS アドレスにアクセスしようとするとセキュリティ警告が表示されます。  
+  
+## 参照  
+ [信頼できるセッション](../../../../docs/framework/wcf/feature-details/reliable-sessions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md b/docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md
new file mode 100644
index 00000000000..07e34b0fa19
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md
@@ -0,0 +1,84 @@
+---
+title: "方法 : 双方向コントラクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "双方向コントラクト [WCF]"
+ms.assetid: 500a75b6-998a-47d5-8e3b-24e3aba2a434
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 方法 : 双方向コントラクトを作成する
+ここでは、双方向コントラクトを使用するメソッドを作成するための基本手順を示します。双方向コントラクトでは、クライアントとサーバーが互いに独立して通信できるため、どちらからでも相手の呼び出しを開始できます。双方向コントラクトは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに使用できる 3 つのメッセージ パターンのうちの 1 つです。他の 2 つのメッセージ パターンは、一方向および要求\/応答です。双方向コントラクトは、クライアントとサーバー間の 2 つの一方向コントラクトで構成され、メソッドの呼び出しが相互に関連付けられている必要はありません。サービスでクライアントに詳細を照会したり、クライアントで明示的にイベントを発生させたりする必要がある場合は、この種のコントラクトを使用します。双方向コントラクトのクライアント アプリケーションの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)」を参照してください。実際に動作するサンプルについては、「[二重](../../../../docs/framework/wcf/samples/duplex.md)」を参照してください。  
+  
+### 双方向コントラクトを作成するには  
+  
+1.  双方向コントラクトのサーバー側を構成するインターフェイスを作成します。  
+  
+2.  インターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> クラスを適用します。  
+  
+     [!code-csharp[S_WS_DualHttp#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ws_dualhttp/cs/service.cs#3)]
+     [!code-vb[S_WS_DualHttp#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_ws_dualhttp/vb/service.vb#3)]  
+  
+3.  インターフェイスでメソッド署名を宣言します。  
+  
+4.  パブリック コントラクトの一部であることが必要な各メソッド シグネチャに、<xref:System.ServiceModel.OperationContractAttribute> クラスを適用します。  
+  
+5.  クライアントでサービスが呼び出すことができる一連の操作を定義するコールバック インターフェイスを作成します。  
+  
+     [!code-csharp[S_WS_DualHttp#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ws_dualhttp/cs/service.cs#4)]
+     [!code-vb[S_WS_DualHttp#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_ws_dualhttp/vb/service.vb#4)]  
+  
+6.  コールバック インターフェイスでメソッド署名を宣言します。  
+  
+7.  パブリック コントラクトの一部であることが必要な各メソッド シグネチャに、<xref:System.ServiceModel.OperationContractAttribute> クラスを適用します。  
+  
+8.  プライマリ インターフェイスの <xref:System.ServiceModel.ServiceContractAttribute.CallbackContract%2A> プロパティをコールバック インターフェイスの型に設定することにより、2 つのインターフェイスを双方向コントラクトにリンクします。  
+  
+### クライアントでメソッドを呼び出すには  
+  
+1.  サービスのプライマリ コントラクトの実装で、コールバック インターフェイスの変数を宣言します。  
+  
+2.  <xref:System.ServiceModel.OperationContext> クラスの <xref:System.ServiceModel.OperationContext.GetCallbackChannel%2A> メソッドから返されるオブジェクト参照に変数を設定します。  
+  
+     [!code-csharp[S_WS_DualHttp#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ws_dualhttp/cs/service.cs#1)]
+     [!code-vb[S_WS_DualHttp#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_ws_dualhttp/vb/service.vb#1)]  
+  
+     [!code-csharp[S_WS_DualHttp#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ws_dualhttp/cs/service.cs#2)]
+     [!code-vb[S_WS_DualHttp#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_ws_dualhttp/vb/service.vb#2)]  
+  
+3.  コールバック インターフェイスで定義されたメソッドを呼び出します。  
+  
+## 使用例  
+ 次のコード例は、双方向通信を示しています。サービスのコントラクトには、順方向および逆方向に移動するためのサービス操作が含まれます。クライアントのコントラクトには、位置を報告するためのサービス操作が含まれます。  
+  
+ [!code-csharp[S_WS_DualHttp#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ws_dualhttp/cs/service.cs#5)]
+ [!code-vb[S_WS_DualHttp#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_ws_dualhttp/vb/service.vb#5)]  
+  
+-   <xref:System.ServiceModel.ServiceContractAttribute> 属性と <xref:System.ServiceModel.OperationContractAttribute> 属性を適用すると、サービス コントラクトの定義を Web サービス記述言語 \(WSDL\) で自動的に生成できます。  
+  
+-   [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、クライアントの WSDL ドキュメントと \(オプションの\) コードおよび構成を取得します。  
+  
+-   双方向サービスを公開しているエンドポイントは、セキュリティで保護されている必要があります。サービスが双方向メッセージを受信すると、その受信メッセージの ReplyTo を参照して応答の送信先を決定します。チャネルがセキュリティで保護されていない場合、信頼関係のないクライアントが対象コンピューターの ReplyTo を使用して悪意のあるメッセージを送信し、その対象コンピューターのサービス拒否 \(DOS: Denial Of Service\) を引き起こす可能性があります。通常の要求\/応答メッセージでは、ReplyTo は無視され、元のメッセージを受信したチャネルで応答が送信されます。したがって、この問題は発生しません。  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ [方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)   
+ [二重](../../../../docs/framework/wcf/samples/duplex.md)   
+ [サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md)   
+ [方法 : サービス コントラクトを定義する](../../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)   
+ [セッション](../../../../docs/framework/wcf/samples/session.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-duplex-federated-binding.md b/docs/framework/wcf/feature-details/how-to-create-a-duplex-federated-binding.md
new file mode 100644
index 00000000000..7867ad84938
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-duplex-federated-binding.md
@@ -0,0 +1,107 @@
+---
+title: "方法 : 双方向フェデレーション バインディングを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4331d2bc-5455-492a-9189-634a82597726
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : 双方向フェデレーション バインディングを作成する
+<xref:System.ServiceModel.WSFederationHttpBinding> はデータグラムと要求\/応答メッセージの交換コントラクトのみをサポートします。双方向メッセージ交換コントラクトを使用するには、カスタム バインディングを作成する必要があります。次の手順は、構成の中でそれを行う方法を説明します。HTTP と TCP トランスポートにはメッセージ モード セキュリティを、TCP トランスポートには混合モード セキュリティを使用します。このトピックの最後に 3 つのバインディングすべてのサンプル コードがあります。  
+  
+ バインディングはコード内でも作成できます。作成するバインド要素スタックの詳細については、「[方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)」を参照してください。  
+  
+### HTTP で双方向カスタム フェデレーション バインディングを作成するには  
+  
+1.  構成ファイルの [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)[\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) 要素を作成します。  
+  
+2.  [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) 要素内で、`name` 属性が `FederationDuplexHttpMessageSecurityBinding` に設定された [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を作成します。  
+  
+3.  [\<binding\>](../../../../docs/framework/misc/binding.md) 要素内で、`authenticationMode` 属性が `SecureConversation` に設定された [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素を作成します。  
+  
+4.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素内で、`authenticationMode` 属性が `IssuedTokenForCertificate` または `IssuedTokenForSslNegotiated` に設定された [\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md) 要素を作成します。  
+  
+5.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素に続いて、空の [\<compositeDuplex\>](../../../../docs/framework/configure-apps/file-schema/wcf/compositeduplex.md) 要素を作成します。  
+  
+6.  [\<compositeDuplex\>](../../../../docs/framework/configure-apps/file-schema/wcf/compositeduplex.md) 要素に続いて、空の [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素を作成します。  
+  
+7.  [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素に続いて、空の [\<httpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httptransport.md) 要素を作成します。  
+  
+### TCP メッセージ セキュリティ モードで双方向カスタム フェデレーション バインディングを作成するには  
+  
+1.  構成ファイルの [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md)[\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素を作成します。  
+  
+2.  [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素内で、`name` 属性が `FederationDuplexTcpMessageSecurityBinding` に設定された [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素を作成します。  
+  
+3.  [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素内で、`authenticationMode` 属性が `SecureConversation` に設定された [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素を作成します。  
+  
+4.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素内で、`authenticationMode` 属性が `IssuedTokenForCertificate` または `IssuedTokenForSslNegotiated` に設定された [\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md) 要素を作成します。  
+  
+5.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素に続いて、空の [\<tcpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/tcptransport.md) 要素を作成します。  
+  
+### TCP 混合セキュリティ モードで双方向カスタム フェデレーション バインディングを作成するには  
+  
+1.  構成ファイルの [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md)[\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素を作成します。  
+  
+2.  [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素内で、`name` 属性が `FederationDuplexTcpTransportSecurityWithMessageCredentialBinding` に設定された [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素を作成します。  
+  
+3.  [\<oneWay\>](../../../../docs/framework/configure-apps/file-schema/wcf/oneway.md) 要素内で、`authenticationMode` 属性が `SecureConversation` に設定された [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素を作成します。  
+  
+4.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素内で、`authenticationMode` 属性が `IssuedTokenForCertificate` または `IssuedTokenForSslNegotiated` に設定された [\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md) 要素を作成します。  
+  
+5.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) 要素に続いて、空の [\<sslStreamSecurity\>](../../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md) 要素を作成します。  
+  
+6.  [\<sslStreamSecurity\>](../../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md) 要素に続いて、空の [\<tcpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/tcptransport.md) 要素を作成します。  
+  
+## サンプル コード  
+  
+#### 3 つのバインディングの例  
+  
+1.  次のコードを構成ファイルに挿入します。  
+  
+## 使用例  
+  
+```  
+  
+<bindings>  
+   <customBinding>  
+      <binding name="FederationDuplexHttpMessageSecurityBinding">  
+<!-- duplex contract requires secure conversation with require cancellation = true -->  
+          <security authenticationMode="SecureConversation">  
+              <secureConversationBootstrap authenticationMode="IssuedTokenForSslNegotiated" />  
+          </security>  
+          <compositeDuplex />  
+          <oneWay />  
+          <httpTransport />  
+       </binding>  
+<!-- duplex over https is not supported -->  
+       <binding name="FederationDuplexTcpMessageSecurityBinding">  
+<!-- duplex contract requires secure conversation with require cancellation = true -->  
+          <security authenticationMode="SecureConversation">  
+              <secureConversationBootstrap authenticationMode="IssuedTokenForSslNegotiated" />  
+          </security>  
+          <tcpTransport />  
+       </binding>              
+       <binding name="FederationDuplexTcpTransportSecurityWithMessageCredentialsBinding">  
+<!-- duplex contract requires secure conversation with require cancellation = true -->  
+          <security authenticationMode="SecureConversation">  
+              <secureConversationBootstrap authenticationMode="IssuedTokenOverTransport" />  
+          </security>  
+<!-- requireClientCertificate = true or <windowsStreamSecurity /> can be used, but does not make sense for most scenarios -->  
+          <sslStreamSecurity />  
+          <tcpTransport />  
+       </binding>              
+    </customBinding>  
+</bindings>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-federated-client.md b/docs/framework/wcf/feature-details/how-to-create-a-federated-client.md
new file mode 100644
index 00000000000..ec07ec621cd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-federated-client.md
@@ -0,0 +1,174 @@
+---
+title: "方法 : フェデレーション クライアントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: 56ece47e-98bf-4346-b92b-fda1fc3b4d9c
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 方法 : フェデレーション クライアントを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での*フェデレーション サービス*用クライアントの作成は、主に次の 3 つの手順で構成されます。  
+  
+1.  [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)または同様のカスタム バインディングを構成します。適切なバインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)」を参照してください。または、フェデレーション サービスのメタデータ エンドポイントに対して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行し、フェデレーション サービスおよび 1 つ以上のセキュリティ トークン サービスとの通信用の構成ファイルを作成します。  
+  
+2.  クライアントがセキュリティ トークン サービスと対話する際のさまざまな側面を制御する <xref:System.ServiceModel.Security.IssuedTokenClientCredential> のプロパティを設定します。  
+  
+3.  セキュリティ トークン サービスなど、特定のエンドポイントとのセキュリティ保護された通信に必要な証明書を許可する <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential> のプロパティを設定します。  
+  
+> [!NOTE]
+>  クライアントが、偽装された資格情報、<xref:System.ServiceModel.WSFederationHttpBinding> バインディングやカスタムの発行済みトークン、および非対称キーを使用すると、<xref:System.Security.Cryptography.CryptographicException> がスローされる可能性があります。<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuedKeyType%2A> プロパティと <xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeyType%2A> プロパティをそれぞれ <xref:System.IdentityModel.Tokens.SecurityKeyType> に設定すると、<xref:System.ServiceModel.WSFederationHttpBinding> バインディングとカスタムの発行済みトークンで非対称キーが使用されます。クライアントがメッセージを送信しようとするときに、クライアントが偽装している ID のユーザー プロファイルが存在しないと、<xref:System.Security.Cryptography.CryptographicException> がスローされます。この問題を回避するには、クライアント コンピューターにログオンした後、または `LoadUserProfile` を呼び出した後に、メッセージを送信します。  
+  
+ ここでは、これらの手順について詳しく説明します。適切なバインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)」を参照してください。フェデレーション サービスのしくみ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)」を参照してください。  
+  
+### フェデレーション サービスの構成を生成し、確認するには  
+  
+1.  コマンド ライン パラメーターとしてサービスのメタデータ URL のアドレスを使用し、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行します。  
+  
+2.  生成された構成ファイルを適切なエディターで開きます。  
+  
+3.  生成されたすべての [\<issuer\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuer.md) 要素と [\<issuerMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuermetadata.md) 要素の属性と内容を調べます。これらは、[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) 要素またはカスタム バインド要素の [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wsfederationhttpbinding.md) 要素内にあります。予期されたドメイン名やその他のアドレス情報がアドレスに含まれていることを確認します。この情報をチェックすることは重要です。それは、クライアントがこれらのアドレスに対して認証を行い、ユーザー名とパスワードの組み合わせなどの情報を公開する可能性があるためです。アドレスが予期されたアドレスではない場合、意図しない受信者に情報が公開されるおそれがあります。  
+  
+4.  コメント アウトされた \<`alternativeIssuedTokenParameters`\> 要素内の追加の [\<issuedTokenParameters\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md) 要素をすべて調べます。Svcutil.exe ツールを使用してフェデレーション サービスの構成を生成するときに、フェデレーション サービスまたは任意の中間セキュリティ トークン サービスが、発行者アドレスを指定せずに、複数のエンドポイントを公開するセキュリティ トークン サービスのメタデータ アドレスを指定している場合、生成された構成ファイルは最初のエンドポイントを参照します。追加のエンドポイントは、コメント アウトされた \<`alternativeIssuedTokenParameters`\> 要素として構成ファイルに含まれます。  
+  
+     これらの \<`issuedTokenParameters`\> のいずれかが、既に構成に存在するものよりも適切かどうかを判断します。たとえば、セキュリティ トークン サービスに対する認証を行う際は、ユーザー名とパスワードの組み合わせよりも Windows [!INCLUDE[infocard](../../../../includes/infocard-md.md)] トークンを使用する方が、クライアントにとって望ましい場合があります。  
+  
+    > [!NOTE]
+    >  サービスと通信するまでに複数のセキュリティ トークン サービスをたどる必要がある場合は、中間セキュリティ トークン サービスがクライアントを不適切なセキュリティ トークン サービスにダイレクトする可能性があります。そのため、[\<issuedTokenParameters\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenparameters.md) 内のセキュリティ トークン サービスのエンドポイントが、予期されたセキュリティ トークン サービスであり、未確認のセキュリティ トークン サービスでないことを確認します。  
+  
+### コードで IssuedTokenClientCredential を構成するには  
+  
+1.  次のコード例に示すように、<xref:System.ServiceModel.ClientBase%601> クラスの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティまたは <xref:System.ServiceModel.ChannelFactory> クラスから返された、<xref:System.ServiceModel.Description.ClientCredentials> クラスの <xref:System.ServiceModel.Description.ClientCredentials.IssuedToken%2A> プロパティから <xref:System.ServiceModel.Security.IssuedTokenClientCredential> にアクセスします。  
+  
+     [!code-csharp[c_CreateSTS#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#9)]
+     [!code-vb[c_CreateSTS#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#9)]  
+  
+2.  トークン キャッシュが不要な場合は、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.CacheIssuedTokens%2A> プロパティを `false` に設定します。<xref:System.ServiceModel.Security.IssuedTokenClientCredential.CacheIssuedTokens%2A> プロパティにより、セキュリティ トークン サービスからのこれらのトークンをキャッシュするかどうかが制御されます。このプロパティを `false` に設定すると、クライアントは、以前のトークンがいまだに有効な場合でも、フェデレーション サービスに対してクライアント自体を再認証する必要があるときに、新しいトークンをセキュリティ トークン サービスに要求します。このプロパティを `true` に設定すると、クライアントは、トークンの有効期限が切れていない限り、フェデレーション サービスに対してクライアント自体を再認証する必要があるときに既存のトークンを再利用します。既定値は `true` です。  
+  
+3.  キャッシュされたトークンの制限時間を設ける必要がある場合は、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.MaxIssuedTokenCachingTime%2A> プロパティを <xref:System.TimeSpan> 値に設定します。このプロパティは、トークンがキャッシュされる時間を指定します。指定の時間が経過すると、トークンはクライアントのキャッシュから削除されます。既定では、トークンは無期限でキャッシュされます。制限時間を 10 分に設定する例を次に示します。  
+  
+     [!code-csharp[c_CreateSTS#15](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#15)]
+     [!code-vb[c_CreateSTS#15](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#15)]  
+  
+4.  省略可能。<xref:System.ServiceModel.Security.IssuedTokenClientCredential.IssuedTokenRenewalThresholdPercentage%2A> をパーセンテージに設定します。既定値は 60 \(パーセント\) です。このプロパティは、トークンの有効期間をパーセンテージで指定します。たとえば、発行されたトークンが 10 時間有効で、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.IssuedTokenRenewalThresholdPercentage%2A> が 80 に設定されている場合、このトークンは 8 時間後に更新されます。この値を 80% に設定する例を次に示します。  
+  
+     [!code-csharp[c_CreateSTS#16](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#16)]
+     [!code-vb[c_CreateSTS#16](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#16)]  
+  
+     トークンの有効期間と `IssuedTokenRenewalThresholdPercentage` 値によって決まる更新間隔は、キャッシュ時間が更新しきい時間よりも短い場合には、`MaxIssuedTokenCachingTime` 値によってオーバーライドされます。たとえば、`IssuedTokenRenewalThresholdPercentage` とトークンの有効期間を掛けた積が 8 時間であり、`MaxIssuedTokenCachingTime` 値が 10 分の場合、クライアントは、トークンの更新のために 10 分ごとにセキュリティ トークン サービスに連絡します。  
+  
+5.  <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> 以外のキー エントロピ モードが、メッセージ セキュリティやメッセージ資格情報付きトランスポート セキュリティを使用しないバインディング \(たとえば、バインディングに <xref:System.ServiceModel.Channels.SecurityBindingElement> が存在しない場合\) で必要な場合は、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.DefaultKeyEntropyMode%2A> プロパティに適切な値を設定します。*エントロピ*モードにより、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.DefaultKeyEntropyMode%2A> プロパティを使用して対称キーを制御できるかどうかが決まります。この既定値は <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> であり、この場合、クライアントとトークン発行者の両方から、実際のキーを生成する際に組み合わせるデータが提供されます。これ以外の値は <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> と <xref:System.ServiceModel.Security.SecurityKeyEntropyMode> であり、それぞれクライアントまたはサーバーによってキー全体が指定されます。サーバーのデータのみを使用してキーを指定するよう、このプロパティを設定する例を次に示します。  
+  
+     [!code-csharp[c_CreateSTS#17](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#17)]
+     [!code-vb[c_CreateSTS#17](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#17)]  
+  
+    > [!NOTE]
+    >  セキュリティ トークン サービスまたはサービス バインディングに <xref:System.ServiceModel.Channels.SecurityBindingElement> が存在する場合、<xref:System.ServiceModel.Security.IssuedTokenClientCredential> で設定された <xref:System.ServiceModel.Security.IssuedTokenClientCredential.DefaultKeyEntropyMode%2A> は、`SecurityBindingElement` の <xref:System.ServiceModel.Channels.SecurityBindingElement.KeyEntropyMode%2A> プロパティによってオーバーライドされます。  
+  
+6.  <xref:System.ServiceModel.Security.IssuedTokenClientCredential.IssuerChannelBehaviors%2A> プロパティによって返されるコレクションに発行者固有のエンドポイント動作を追加して、これらの動作を構成します。  
+  
+     [!code-csharp[c_CreateSTS#14](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#14)]
+     [!code-vb[c_CreateSTS#14](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#14)]  
+  
+### 構成で IssuedTokenClientCredential を構成するには  
+  
+1.  エンドポイントの動作で、[\<issuedToken\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md) 要素の子として [\<issuedToken\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md) 要素を作成します。  
+  
+2.  トークン キャッシュが不要な場合は、\<`issuedToken`\> 要素の `cacheIssuedTokens` 属性を `false` に設定します。  
+  
+3.  キャッシュされたトークンの制限時間を設ける必要がある場合は、\<`issuedToken`\> 要素の `maxIssuedTokenCachingTime` 属性を適切な値に設定します。次に例を示します。  
+    `<issuedToken maxIssuedTokenCachingTime='00:10:00' />`  
+  
+4.  既定値以外の値にする場合は、\<`issuedToken`\> 要素の `issuedTokenRenewalThresholdPercentage` 属性を適切な値に設定します。次に例を示します。  
+  
+    ```  
+    <issuedToken issuedTokenRenewalThresholdPercentage = "80" />  
+    ```  
+  
+5.  メッセージ セキュリティやメッセージ資格情報付きトランスポート セキュリティを使用しないバインディングで `CombinedEntropy` 以外のキー エントロピ モードが必要な場合 \(たとえば、バインディングに `SecurityBindingElement` が存在しない場合\) は、必要に応じて次のように `<issuedToken>` 要素の `defaultKeyEntropyMode` 属性を `ServerEntropy` または `ClientEntropy` に設定します。  
+  
+    ```  
+    <issuedToken defaultKeyEntropyMode = "ServerEntropy" />  
+    ```  
+  
+6.  省略可能。\<`issuedToken`\> 要素の子として \<`issuerChannelBehaviors`\> 要素を作成して、発行者固有のカスタム エンドポイント動作を構成します。動作ごとに、\<`issuerChannelBehaviors`\> 要素の子として \<`add`\> 要素を作成します。\<`add`\> 要素の `issuerAddress` 属性を設定して、動作の発行者アドレスを指定します。\<`add`\> 要素の `behaviorConfiguration` 属性を設定して、動作自体を指定します。  
+  
+    ```  
+    <issuerChannelBehaviors>  
+    <add issuerAddress="http://fabrikam.org/sts" behaviorConfiguration="FabrikamSTS" />  
+    </issuerChannelBehaviors>  
+    ```  
+  
+### コードで X509CertificateRecipientClientCredential を構成するには  
+  
+1.  <xref:System.ServiceModel.ClientBase%601> クラスまたは <xref:System.ServiceModel.ChannelFactory> プロパティの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティが持つ <xref:System.ServiceModel.Description.ClientCredentials.ServiceCertificate%2A> プロパティを介して、次のように <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential> にアクセスします。  
+  
+     [!code-csharp[c_CreateSTS#18](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#18)]
+     [!code-vb[c_CreateSTS#18](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#18)]  
+  
+2.  特定のエンドポイントの証明書として <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> インスタンスを使用できる場合は、<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A> プロパティによって返されるコレクションの <xref:System.Collections.Generic.ICollection%601.Add%2A> メソッドを使用します。  
+  
+     [!code-csharp[c_CreateSTS#19](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#19)]
+     [!code-vb[c_CreateSTS#19](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#19)]  
+  
+3.  <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> インスタンスが使用できない場合は、次の例に示すように、<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.SetScopedCertificate%2A> メソッドを使用します。  
+  
+     [!code-csharp[c_CreateSTS#20](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#20)]
+     [!code-vb[c_CreateSTS#20](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#20)]  
+  
+### 構成で X509CertificateRecipientClientCredential を構成するには  
+  
+1.  その要素自体がエンドポイント動作の [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素の子要素である [\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md) 要素の子として、[\<scopedCertificates\>](../../../../docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md) 要素を作成します。  
+  
+2.  `<scopedCertificates>` 要素の子要素として `<add>` 要素を作成します。適切な証明書を参照するように `storeLocation`、`storeName`、`x509FindType`、`findValue` の各属性の値を指定します。次の例に示すように、`targetUri` 属性を、証明書が使用されるエンドポイントのアドレスを指定する値に設定します。  
+  
+    ```  
+    <scopedCertificates>  
+     <add targetUri="http://fabrikam.com/sts"   
+          storeLocation="CurrentUser"  
+          storeName="TrustedPeople"  
+          x509FindType="FindBySubjectName"  
+          findValue="FabrikamSTS" />  
+    </scopedCertificates>  
+    ```  
+  
+## 使用例  
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential> クラスのインスタンスをコードで構成する例を、次のコード サンプルに示します。  
+  
+ [!code-csharp[c_FederatedClient#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federatedclient/cs/source.cs#2)]
+ [!code-vb[c_FederatedClient#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federatedclient/vb/source.vb#2)]  
+  
+## .NET Framework セキュリティ  
+ 情報の漏えいを防ぐために、Svcutil.exe ツールを使用してフェデレーション エンドポイントからのメタデータを処理するクライアントでは、生成されたセキュリティ トークン サービス アドレスが予期されたものであることを確認する必要があります。これが特に重要なのは、セキュリティ トークン サービスが複数のエンドポイントを公開する場合です。この場合、Svcutil.exe ツールは、複数のエンドポイントうちの最初のエンドポイントを使用する構成ファイルを生成しますが、このエンドポイントは、クライアントが使用する必要のあるエンドポイントと異なる場合があるためです。  
+  
+## LocalIssuer が必要な場合  
+ チェーン内の 2 番目から最後までのセキュリティ トークン サービスによって発行者アドレスまたは発行者メタデータ アドレスが指定されている場合、Svcutil.exe の既定の出力では、ローカル発行者が使用されません。クライアントで常にローカル発行者を使用する場合は、この点に注意が必要です。  
+  
+ <xref:System.ServiceModel.Security.IssuedTokenClientCredential> クラスの <xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerAddress%2A>、<xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerBinding%2A>、および <xref:System.ServiceModel.Security.IssuedTokenClientCredential.LocalIssuerChannelBehaviors%2A> プロパティの設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : ローカル発行者を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)」を参照してください。  
+  
+## 範囲指定された証明書  
+ 証明書ネゴシエーションを使用しないという一般的な理由により、任意のセキュリティ トークン サービスとの通信用のサービス証明書を指定する必要がある場合は、<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A> プロパティを使用して指定できます。<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.SetDefaultCertificate%2A> メソッドは、パラメーターとして <xref:System.Uri> と <xref:System.Security.Cryptography.X509Certificates.X509Certificate2> を受け取ります。指定した証明書は、指定した URI のエンドポイントと通信するときに使用されます。または、<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.SetScopedCertificate%2A> メソッドを使用して、<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential.ScopedCertificates%2A> プロパティによって返されるコレクションに証明書を追加することもできます。  
+  
+> [!NOTE]
+>  特定の URI に範囲指定された証明書というクライアントの概念は、該当する URI でエンドポイントを公開するサービスへの送信呼び出しを行うアプリケーションにだけ適用されます。これは、<xref:System.ServiceModel.Security.IssuedTokenServiceCredential> クラスの <xref:System.ServiceModel.Security.IssuedTokenServiceCredential.KnownCertificates%2A> によって返されたコレクション内のサーバーで構成された証明書など、発行済みトークンの署名に使用される証明書には適用されません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md).  
+  
+## 参照  
+ [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)   
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)   
+ [方法 : WSFederationHttpBinding を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [方法 : ローカル発行者を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)   
+ [メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)   
+ [方法 : セキュリティで保護されたメタデータ エンドポイント](../../../../docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md b/docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md
new file mode 100644
index 00000000000..0b64b8c7039
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 一方向コントラクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 85084cd9-31cc-4e95-b667-42ef01336622
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 方法 : 一方向コントラクトを作成する
+ここでは、一方向コントラクトを使用するメソッドを作成するための基本手順を示します。このようなメソッドは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの操作をクライアントから呼び出しますが、応答を待ちません。この種のコントラクトは、たとえば、多数のサブスクライバーに対して通知を発行するために使用できます。一方向コントラクトは、二重のコントラクトを作成する場合にも使用できます。その場合は、クライアントとサーバーが互いに独立して通信できるため、どちらからでも相手の呼び出しを開始できます。これにより、特にサーバーは、クライアントがイベントとして処理できる一方向の呼び出しをクライアントに対して実行できます。一方向メソッドの指定の詳細については、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティおよび <xref:System.ServiceModel.OperationContractAttribute> クラスのトピックを参照してください。  
+  
+ 双方向コントラクト用のクライアント アプリケーションを作成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 一方向コントラクトと要求\/応答コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-wcf-services-with-one-way-and-request-reply-contracts.md)」を参照してください。実際に動作するサンプルについては、「[一方向](../../../../docs/framework/wcf/samples/one-way.md)」を参照してください。  
+  
+### 一方向コントラクトを作成するには  
+  
+1.  サービスにより実装されるメソッドを定義するインターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> クラスを適用することにより、サービス コントラクトを作成します。  
+  
+2.  <xref:System.ServiceModel.OperationContractAttribute> クラスをメソッドに適用する際に、クライアントが呼び出すことのできるインターフェイスのメソッドを指定します。  
+  
+3.  <xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティを `true` に設定することにより、出力を行わない \(戻り値および出力または参照パラメーターを持たない\) 一方向の操作を指定します。<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティの既定値は `false` であるため、<xref:System.ServiceModel.OperationContractAttribute> クラスを持つ操作では、既定で要求\/応答コントラクトが満たされることに注意してください。したがって、このメソッドに一方向コントラクトが必要な場合は、この属性プロパティの値を明示的に `true` に指定する必要があります。  
+  
+## 使用例  
+ 複数の一方向メソッドを含むサービスのコントラクトを定義する方法を次のコード例に示します。`Equals` \(既定で応答\/要求コントラクトに設定され、結果を返します\) を除き、すべてのメソッドは一方向コントラクトを持ちます。  
+  
+ [!code-csharp[S_Service_Session#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_service_session/cs/service.cs#1)]
+ [!code-vb[S_Service_Session#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_service_session/vb/service.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ [サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md)   
+ [方法 : サービス コントラクトを定義する](../../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)   
+ [セッション](../../../../docs/framework/wcf/samples/session.md)   
+ [方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md b/docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md
new file mode 100644
index 00000000000..e63833e0bfd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 要求/応答コントラクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 801d90da-3d45-4284-9c9f-56c8aadb4060
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 方法 : 要求/応答コントラクトを作成する
+要求\/応答コントラクトは、応答を返すメソッドを指定します。応答が送信され、このコントラクトの条件の下で要求に関連付けられる必要があります。メソッドが応答を返さない場合 \(C\# の場合は `void` または Visual Basic の場合は `Sub`\) でも、インフラストラクチャは、空のメッセージを作成して送信することで、メソッドが返ったことを呼び出し元に示します。空の応答メッセージが送信されるのを防ぐには、操作で 1 方向コントラクトを使用します。  
+  
+### 要求\/応答コントラクトを作成するには  
+  
+1.  選択したプログラミング言語でインターフェイスを作成します。  
+  
+2.  インターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> 属性を適用します。  
+  
+3.  クライアントが呼び出すことのできる各メソッドに <xref:System.ServiceModel.OperationContractAttribute> 属性を適用します。  
+  
+4.  省略可能。<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティの値を `true` に設定して、空の応答メッセージが送信されることを防止します。既定では、すべての操作は要求\/応答コントラクトです。  
+  
+## 使用例  
+ 次のサンプルは、`Add` メソッドと `Subtract` メソッドを提供する電卓サービスのコントラクトを定義します。`Multiply` メソッドは <xref:System.ServiceModel.OperationContractAttribute> クラスでマークされていないため、このコントラクトの一部ではありません。したがって、クライアントからはアクセスできません。  
+  
+```  
+using System.ServiceModel;   
+  
+[ServiceContract]   
+public interface ICalculator   
+{   
+[OperationContract]   
+// It would be equivalent to write explicitly:  
+// [OperationContract(IsOneWay=false)]   
+int Add(int a, int b);   
+  
+[OperationContract]   
+int Subtract(int a, int b);   
+  
+int Multiply(int a, int b)  
+}  
+```  
+  
+-   操作コントラクトを指定する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、<xref:System.ServiceModel.OperationContractAttribute> クラスおよび <xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティのトピックを参照してください。  
+  
+-   <xref:System.ServiceModel.ServiceContractAttribute> 属性と <xref:System.ServiceModel.OperationContractAttribute> 属性を適用すると、サービスを展開した後に Web サービス記述言語 \(WSDL\) ドキュメントでサービス コントラクト定義が自動的に生成されます。ドキュメントは、サービスの HTTP ベース アドレスに `?wsdl` を付け加えてしてダウンロードできます。たとえば、「`http://microsoft/CalculatorService?wsdl`」と入力します。  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ [サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)   
+ [方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-secure-session.md b/docs/framework/wcf/feature-details/how-to-create-a-secure-session.md
new file mode 100644
index 00000000000..8244d61cf79
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-secure-session.md
@@ -0,0 +1,91 @@
+---
+title: "方法 : セキュリティで保護されたセッションを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], セッションの作成"
+ms.assetid: b6f42b5a-bbf7-45cf-b917-7ec9fa7ae110
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# 方法 : セキュリティで保護されたセッションを作成する
+メッセージ セキュリティを有効にすると、[\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) バインディングを除き、システム提供のバインディング [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、セキュリティで保護されたセッションが自動的に使用されます。  
+  
+ 既定では、セキュリティで保護されたセッションは、再利用される Web サーバーで存続します。  セキュリティで保護されたセッションが確立されると、クライアントとサービスが、セキュリティで保護されたセッションに関連付けられているキーをキャッシュします。  メッセージを交換するときは、キャッシュされたキーの識別子のみが交換されます。  Web サーバーが再利用される場合は、Web サーバーが識別子のキャッシュされたキーを取得できないようにキャッシュも再利用されます。  これが発生した場合、例外がクライアントにスローされます。  ステートフルなセキュリティ コンテキスト トークン \(SCT: Security Context Token\) を使用するセキュリティで保護されたセッションは、再利用される Web サーバーで存続することができます。  セキュリティで保護されたセッションでステートフルな SCT を使用する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。  
+  
+### サービスが、システム提供のバインディングの 1 つを使用して、セキュリティで保護されたセッションを使用するように指定するには  
+  
+-   メッセージ セキュリティをサポートするシステム提供のバインディングを使用するようにサービスを構成します。  
+  
+     [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) バインディングを除き、システム提供のバインディングでメッセージ セキュリティが使用されるように設定しておくと、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではセキュリティで保護されたセッションが自動的に使用されます。  次の表は、メッセージ セキュリティをサポートするシステム提供のバインディングを示し、そのバインディングでメッセージ セキュリティが既定のセキュリティ機構であるかどうかを示しています。  
+  
+    |システム提供のバインディング|構成要素|既定でメッセージ セキュリティが有効|  
+    |--------------------|----------|------------------------|  
+    |<xref:System.ServiceModel.BasicHttpBinding>|[\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)|Ｘ|  
+    |<xref:System.ServiceModel.WSHttpBinding>|[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)|はい|  
+    |<xref:System.ServiceModel.WSDualHttpBinding>|[\<wsDualHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)|はい|  
+    |<xref:System.ServiceModel.WSFederationHttpBinding>|[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)|はい|  
+    |<xref:System.ServiceModel.NetTcpBinding>|[\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)|Ｘ|  
+    |<xref:System.ServiceModel.NetMsmqBinding>|[\<netMsmqBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md)|Ｘ|  
+  
+     次のコード例に使用されている構成では、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)、メッセージ セキュリティ、およびセキュリティで保護されたセッションを使用する `wsHttpBinding_Calculator` という名前のバインディングを指定しています。  
+  
+    ```  
+    <bindings>  
+      <WSHttpBinding>  
+       <binding name = "wsHttpBinding_Calculator">  
+         <security mode="Message">  
+           <message clientCredentialType="Windows"/>  
+         </security>  
+        </binding>  
+      </WSHttpBinding>  
+    </bindings>  
+    ```  
+  
+     [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)、メッセージ セキュリティ、およびセキュリティで保護されたセッションを使用して、`secureCalculator` サービスをセキュリティで保護するように指定するコード例を次に示します。  
+  
+     [!code-csharp[c_CreateSecureSession#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_createsecuresession/cs/secureservice.cs#1)]
+     [!code-vb[c_CreateSecureSession#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_createsecuresession/vb/secureservice.vb#1)]  
+  
+    > [!NOTE]
+    >  [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) については、`establishSecurityContext` 属性を `false` に設定してセキュリティで保護されたセッションを無効にできます。  他のシステム提供のバインディングについては、カスタム バインディングを作成することでのみ、セキュリティで保護されたセッションを無効にできます。  
+  
+### カスタム バインディングを使用して、サービスでセキュリティで保護されたセッションが使用されるように指定するには  
+  
+-   セキュリティで保護されたセッションで SOAP メッセージが保護されるように指定したカスタム バインディングを作成します。  
+  
+     カスタム バインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : システム指定のバインディングをカスタマイズする](../../../../docs/framework/wcf/extending/how-to-customize-a-system-provided-binding.md)」を参照してください。  
+  
+     次のコード例で使用されている構成では、セキュリティで保護されたセッションを使用して SOAP メッセージを保護するカスタム バインディングを指定しています。  
+  
+    ```  
+    <bindings>  
+      <!-- configure a custom binding -->  
+      <customBinding>  
+        <binding name="customBinding_Calculator">  
+          <security authenticationMode="SecureConversation" />  
+          <secureConversationBootstrap authenticationMode="SspiNegotiated" />  
+          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8"/>  
+          <httpTransport/>  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    ```  
+  
+     セキュリティで保護されたセッションをブートストラップするための <xref:System.ServiceModel.Configuration.AuthenticationMode> 認証モードを使用する、カスタム バインディングを作成するコード例を次に示します。  
+  
+     [!code-csharp[c_CreateSecureSession#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_createsecuresession/cs/secureservice.cs#2)]
+     [!code-vb[c_CreateSecureSession#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_createsecuresession/vb/secureservice.vb#2)]  
+  
+## 参照  
+ [WCF のバインディングの概要](../../../../docs/framework/wcf/bindings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md b/docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md
new file mode 100644
index 00000000000..00f19cf3591
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md
@@ -0,0 +1,118 @@
+---
+title: "方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 640676b6-c75a-4ff7-aea4-b1a1524d71b2
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# 方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する
+セキュリティで保護されたセッションでステートフルなセキュリティ コンテキスト トークン \(SCT: Security Context Token\) を使用すると、そのセッションでサービスを再利用できます。たとえば、セキュリティで保護されたセッションでステートレスな SCT を使用しているときにインターネット インフォメーション サービス \(IIS\) をリセットすると、サービスに関連付けられているセッション データが失われます。このセッション データには、SCT キャッシュが含まれています。このため、クライアントが次回ステートレスな SCT をサービスに送信すると、エラーが返されます。これは、SCT に関連付けられているキーを取得できないためです。しかし、ステートフルな SCT を使用した場合、SCT に関連付けられているキーは、その SCT 内に格納されます。キーが SCT 内、つまりメッセージ内に格納されているため、セキュリティで保護されたセッションは、サービスの再使用の影響を受けません。既定では、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、セキュリティで保護されたセッションでステートレスな SCT を使用します。ここでは、セキュリティで保護されたセッションでステートフルな SCT を使用する方法について詳しく説明します。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.Channels.IDuplexChannel> から派生したコントラクトに関係する、セキュリティで保護されたセッションでは、ステートフルな SCT を使用できません。  
+  
+> [!NOTE]
+>  セキュリティで保護されたセッションでステートフルな SCT を使用するアプリケーションでは、サービスのスレッド ID は、関連付けられたユーザー プロファイルを持つユーザー アカウントである必要があります。ユーザー プロファイルを持たないアカウント \(`Local Service` など\) でサービスを実行すると、例外がスローされる場合があります。  
+  
+> [!NOTE]
+>  Windows XP で偽装が必要な場合は、ステートフルな SCT を使用しない、セキュリティで保護されたセッションを使用します。ステートフル SCT が偽装と共に使用されると、<xref:System.InvalidOperationException> がスローされます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md).  
+  
+### セキュリティで保護されたセッションでステートフルな SCT を使用するには  
+  
+-   ステートフルな SCT を使用する、セキュリティで保護されたセッションによって SOAP メッセージを保護するように指定するカスタム バインディングを作成します。  
+  
+    1.  サービスの構成ファイルに [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を追加して、カスタム バインディングを定義します。  
+  
+        ```  
+        <customBinding>  
+        ```  
+  
+    2.  [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)に [\<binding\>](../../../../docs/framework/misc/binding.md) 子要素を追加します。  
+  
+         `name` 属性を、構成ファイル内で一意の名前に設定してバンディング名を指定します。  
+  
+        ```  
+        <binding name="StatefulSCTSecureSession">  
+        ```  
+  
+    3.  [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)に [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)子要素を追加して、このサービスとの間で送受信されるメッセージの認証モードを指定します。  
+  
+         `authenticationMode` 属性を `SecureConversation` に設定して、セキュリティで保護されたセッションを指定します。`requireSecurityContextCancellation` 属性を `false` に設定して、ステートフルな SCT を使用するように指定します。  
+  
+        ```  
+        <security authenticationMode="SecureConversation"  
+                  requireSecurityContextCancellation="false">  
+        ```  
+  
+    4.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)に [\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)子要素を追加して、セキュリティで保護されたセッションが確立されているときにクライアントが認証される方法を指定します。  
+  
+         クライアントの認証方法は、`authenticationMode` 属性を設定して指定します。  
+  
+        ```  
+        <secureConversationBootstrap authenticationMode="UserNameForCertificate" />  
+        ```  
+  
+    5.  [\<textMessageEncoding\>](../../../../docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md)のようなエンコーディング要素を追加して、メッセージ エンコーディングを指定します。  
+  
+        ```  
+        <textMessageEncoding />  
+        ```  
+  
+    6.  [\<httpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httptransport.md)などのトランスポート要素を追加して、トランスポートを指定します。  
+  
+        ```  
+        <httpTransport />  
+        ```  
+  
+     次のコード例では、構成を使用して、セキュリティで保護されたセッションでメッセージがステートフルな SCT と共に使用できるカスタム バインディングを指定します。  
+  
+    ```  
+    <customBinding>  
+      <binding name="StatefulSCTSecureSession">  
+        <security authenticationMode="SecureConversation"  
+                  requireSecurityContextCancellation="false">  
+          <secureConversationBootstrap authenticationMode="UserNameForCertificate" />  
+        </security>  
+        <textMessageEncoding />  
+        <httpTransport />  
+      </binding>  
+    </customBinding>  
+    ```  
+  
+## 使用例  
+ セキュリティで保護されたセッションをブートストラップするための <xref:System.ServiceModel.Configuration.AuthenticationMode> 認証モードを使用する、カスタム バインディングを作成するコード例を次に示します。  
+  
+ [!code-csharp[c_CreateStatefulSCT#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_createstatefulsct/cs/secureservice.cs#2)]
+ [!code-vb[c_CreateStatefulSCT#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_createstatefulsct/vb/secureservice.vb#2)]  
+  
+ Windows 認証をステートフルな SCT と組み合わせて使用すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では <xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> プロパティに実際の呼び出し元の ID が設定されず、代わりに "anonymous" が設定されます。その場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティは、受信 SCT からの要求ごとにサービスのセキュリティ コンテキストの内容を再作成する必要があるため、サーバーはメモリ内でセキュリティ セッションを追跡できません。また、<xref:System.Security.Principal.WindowsIdentity> インスタンスは SCT にシリアル化できないため、<xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> プロパティは匿名 ID を返します。  
+  
+ 次の構成は、この動作を示します。  
+  
+```  
+<customBinding>  
+  <binding name="Cancellation">  
+       <textMessageEncoding />  
+        <security   
+            requireSecurityContextCancellation="false">  
+              <secureConversationBootstrap />  
+      </security>  
+    <httpTransport />  
+  </binding>  
+</customBinding>  
+  
+```  
+  
+## 参照  
+ [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-security-token-service.md b/docs/framework/wcf/feature-details/how-to-create-a-security-token-service.md
new file mode 100644
index 00000000000..e166b27b80e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-security-token-service.md
@@ -0,0 +1,138 @@
+---
+title: "方法 : セキュリティ トークン サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: 98e82101-4cff-4bb8-a220-f7abed3556e5
+caps.latest.revision: 12
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 12
+---
+# 方法 : セキュリティ トークン サービスを作成する
+セキュリティ トークン サービスは、WS\-Trust 仕様に定義されているプロトコルを実装します。このプロトコルでは、セキュリティ トークンの発行、更新、キャンセル、および検証を行うためのメッセージ形式とメッセージ交換パターンが定義されています。セキュリティ トークン サービスでは、これらの機能が 1 つ以上提供されます。ここでは、最も一般的なシナリオであるトークンの発行の実装について説明します。  
+  
+## トークンの発行  
+ WS\-Trust は、トークンを発行するための `RequestSecurityToken` XML スキーマ定義言語 \(XSD: XML Schema Definition Language\) スキーマ要素および `RequestSecurityTokenResponse` XSD スキーマ要素に基づいたメッセージ形式を定義しています。また、関連するアクション URI \(Uniform Resource Identifier\) も定義しています。`RequestSecurityToken` メッセージに関連付けられているアクション URI は http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/Issue です。`RequestSecurityTokenResponse` メッセージに関連付けられているアクション URI は http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/Issue です。  
+  
+### 要求メッセージの構造  
+ 発行要求メッセージの構造は、通常、次の項目で構成されます。  
+  
+-   "要求の種類" URI。値は http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/Issue です。  
+  
+-   "トークンの種類" URI。SAML \(Security Assertions Markup Language\) 1.1 トークンの場合、この URI の値は http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.1\#SAMLV1.1 です。  
+  
+-   発行済みトークンに関連付けられるキーのビット数を示すキー サイズの値。  
+  
+-   "キーの種類" URI。対称キーの場合、この URI の値は http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/SymmetricKey です。  
+  
+ また、以下のような項目が含まれている必要があります。  
+  
+-   クライアントによって提供されたキー マテリアル。  
+  
+-   発行済みトークンが使用されるターゲット サービスを示すスコープ情報。  
+  
+ セキュリティ トークン サービスは、発行応答メッセージを作成する際に、発行要求メッセージの情報を使用します。  
+  
+## 応答メッセージの構造  
+ 発行応答メッセージの構造は、通常、次の項目で構成されます。  
+  
+-   発行済みセキュリティ トークン \(例 : SAML 1.1 アサーション\)。  
+  
+-   セキュリティ トークンに関連付けられた証明トークン。対称キーでは、多くの場合、これは暗号化されたキー マテリアルです。  
+  
+-   発行済みセキュリティ トークンへの参照。通常、セキュリティ トークン サービスが返す参照は、2 とおりに使用できます。1 つは、クライアントによって送信された後続のメッセージ内に、発行済みトークンが存在する場合で、もう 1 つは、後続のメッセージ内にトークンが存在しない場合です。  
+  
+ さらに、2 つの項目が含まれている必要があります。  
+  
+-   セキュリティ トークン サービスによって提供されたキー マテリアル。  
+  
+-   共有キーを計算するために必要なアルゴリズム。  
+  
+-   発行済みトークンの有効期間情報。  
+  
+## 要求メッセージの処理  
+ セキュリティ トークン サービスは、要求メッセージのさまざまな部分を検査し、要求を満たすトークンを発行できることを確認することによって発行要求を処理します。セキュリティ トークン サービスは、発行するトークンを作成する前に次のことを確認する必要があります。  
+  
+-   要求が、実際に発行されるトークンに対する要求であること。  
+  
+-   要求されたトークンの種類をセキュリティ トークン サービスがサポートしていること。  
+  
+-   要求を行う権限が要求者にあること。  
+  
+-   キー マテリアルに関する要求者の期待にセキュリティ トークン サービスが応えられること。  
+  
+ トークンを作成する際には、トークンの署名に使用されるキーと共有キーの暗号化に使用されるキーの 2 つを決定することが重要です。トークンに署名が必要なのは、クライアントがターゲット サービスにトークンを提示する際に、そのサービスが、そのトークンを発行したのが信頼されるセキュリティ トークン サービスであると判定できるようにするためです。キー マテリアルは、ターゲット サービスが復号化できる方法で暗号化される必要があります。  
+  
+ SAML アサーションに署名する処理では、<xref:System.IdentityModel.Tokens.SigningCredentials> インスタンスを作成します。このクラスのコンストラクターは、次のものを受け取ります  
+  
+-   SAML アサーションに署名するために使用する <xref:System.IdentityModel.Tokens.SecurityKey>。  
+  
+-   使用する署名アルゴリズムを識別する文字列。  
+  
+-   使用するダイジェスト アルゴリズムを識別する文字列。  
+  
+-   アサーションの署名に使用されるキーを識別する <xref:System.IdentityModel.Tokens.SecurityKeyIdentifier> \(必要な場合\)。  
+  
+ [!code-csharp[c_CreateSTS#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#1)]
+ [!code-vb[c_CreateSTS#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#1)]  
+  
+ 共有キーを暗号化する処理では、キー マテリアルを受け取り、それをターゲット サービスが共有キーの復号化に使用できるキーで暗号化します。通常は、ターゲット サービスの公開キーが使用されます。  
+  
+ [!code-csharp[c_CreateSTS#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#2)]
+ [!code-vb[c_CreateSTS#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#2)]  
+  
+ さらに、暗号化されたキーの <xref:System.IdentityModel.Tokens.SecurityKeyIdentifier> も必要です。  
+  
+ [!code-csharp[c_CreateSTS#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#3)]
+ [!code-vb[c_CreateSTS#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#3)]  
+  
+ 最後に、この <xref:System.IdentityModel.Tokens.SecurityKeyIdentifier> を使用して、`SamlSubject` を `SamlToken` の一部として作成します。  
+  
+ [!code-csharp[c_CreateSTS#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#4)]
+ [!code-vb[c_CreateSTS#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#4)]  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md).  
+  
+## 応答メッセージの作成  
+ セキュリティ トークン サービスによって発行要求が処理され、発行されるトークンと証明キーが作成されたら、少なくとも、要求されたトークン、証明トークン、および発行されたトークンの参照を含む応答メッセージを作成する必要があります。発行済みトークンは、通常、<xref:System.IdentityModel.Tokens.SamlAssertion> から作成された <xref:System.IdentityModel.Tokens.SamlSecurityToken> です。次の例を参照してください。  
+  
+ [!code-csharp[c_CreateSTS#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#5)]
+ [!code-vb[c_CreateSTS#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#5)]  
+  
+ セキュリティ トークン サービスによって共有キー マテリアルが提供される場合は、<xref:System.ServiceModel.Security.Tokens.BinarySecretSecurityToken> を作成することにより、証明トークンが作成されます。  
+  
+ [!code-csharp[c_CreateSTS#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#6)]
+ [!code-vb[c_CreateSTS#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#6)]  
+  
+ クライアントとセキュリティ トークン サービスの両方によって共有キーのキー マテリアルが提供される場合の証明トークンの作成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)」を参照してください。  
+  
+ 発行済みトークンの参照を作成するには、<xref:System.IdentityModel.Tokens.SecurityKeyIdentifierClause> クラスのインスタンスを作成します。  
+  
+ [!code-csharp[c_CreateSTS#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#7)]
+ [!code-vb[c_CreateSTS#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#7)]  
+  
+ 最後に、これらの値を、クライアントに返される応答メッセージにシリアル化します。  
+  
+## 例  
+ セキュリティ トークン サービスの完全なコードについては、「[フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.IdentityModel.Tokens.SigningCredentials>   
+ <xref:System.IdentityModel.Tokens.SecurityKey>   
+ <xref:System.IdentityModel.Tokens.SecurityKeyIdentifier>   
+ <xref:System.IdentityModel.Tokens.SamlSecurityToken>   
+ <xref:System.IdentityModel.Tokens.SamlAssertion>   
+ <xref:System.ServiceModel.Security.Tokens.BinarySecretSecurityToken>   
+ <xref:System.IdentityModel.Tokens.SecurityKeyIdentifierClause>   
+ [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md b/docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md
new file mode 100644
index 00000000000..938f9577086
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : 指定した認証モード用の SecurityBindingElement を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7c7747a-5b8c-463f-8493-7266dac75066
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# 方法 : 指定した認証モード用の SecurityBindingElement を作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、クライアントとサービスが互いに認証するためのモードが複数あります。これらの認証モード用のセキュリティ バインド要素は、次の例のように、<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの静的メソッドまたは構成を使用して作成できます。  
+  
+ 18 個の認証モード[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)」を参照してください。  
+  
+## 使用例  
+ 次のコード例では、複数の認証モードのバインディングを作成するメソッドを示します。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.Channels.SecurityBindingElement> オブジェクトのインスタンスが一度作成されると、<xref:System.ServiceModel.Security.Tokens.IssuedSecurityTokenParameters.KeyType%2A> や <xref:System.ServiceModel.Channels.SecurityBindingElement.MessageSecurityVersion%2A> などの多数のプロパティは変更できなくなります。これらのプロパティで `set` を呼び出しても変更されません。  
+  
+ [!code-csharp[c_CustomBindingsAuthMode#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombindingsauthmode/cs/source.cs#2)]
+ [!code-vb[c_CustomBindingsAuthMode#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_custombindingsauthmode/vb/source.vb#2)]  
+  
+## 参照  
+ [SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md b/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md
new file mode 100644
index 00000000000..9516a3e225c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-code.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : コード内にサービス エンドポイントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fbb22fa-2930-48b8-b437-def1de87c6a0
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : コード内にサービス エンドポイントを作成する
+この例では、電卓サービスに `ICalculator` コントラクトを定義し、そのサービスを `CalculatorService` クラスに実装し、コード内でサービス エンドポイントを定義します。このエンドポイントでは、サービスが <xref:System.ServiceModel.BasicHttpBinding> クラスを使用するように指定します。  
+  
+ 通常、ベスト プラクティスは、コードで命令として記述するよりも、構成でバインディングを指定して情報を明示的にアドレス指定することです。展開済みサービスのバインディングおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。一般的に、バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+#### コード内にサービス エンドポイントを作成するには  
+  
+1.  サービス コントラクトを定義するインターフェイスを作成します。  
+  
+     [!code-csharp[c_HowTo_CodeServiceBinding#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#1)]
+     [!code-vb[c_HowTo_CodeServiceBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#1)]  
+  
+2.  手順 1. で定義したサービス コントラクトを実装します。  
+  
+     [!code-csharp[c_HowTo_CodeServiceBinding#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#2)]
+     [!code-vb[c_HowTo_CodeServiceBinding#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#2)]  
+  
+3.  アプリケーションをホストする場合は、サービスで使用するサービスとバインディングのベース アドレスを作成します。  
+  
+     [!code-csharp[c_HowTo_CodeServiceBinding#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#3)]
+     [!code-vb[c_HowTo_CodeServiceBinding#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#3)]  
+  
+4.  ホストを作成し、<xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%28System.Type%2CSystem.ServiceModel.Channels.Binding%2CSystem.String%29> または他のオーバーロードの 1 つを呼び出して、ホストのサービス エンドポイントを追加します。  
+  
+     [!code-csharp[c_HowTo_CodeServiceBinding#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#6)]
+     [!code-vb[c_HowTo_CodeServiceBinding#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#6)]  
+  
+     コードのバインディングを指定し、同時にランタイムによって提供された既定のエンドポイントを使用する場合は、<xref:System.ServiceModel.ServiceHost> の作成時にベース アドレスをコンストラクターに渡します。<xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> は呼び出さないでください。  
+  
+     [!code-csharp[c_HowTo_CodeServiceBinding#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#7)]
+     [!code-vb[c_HowTo_CodeServiceBinding#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#7)]  
+  
+     既定のエンドポイント[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## 参照  
+ [方法 : コード内でサービス バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md b/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md
new file mode 100644
index 00000000000..170eb480748
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-service-endpoint-in-configuration.md
@@ -0,0 +1,154 @@
+---
+title: "方法 : 構成にサービス エンドポイントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "2016-06-16"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f474e25d-2a27-4f31-84c5-395c442b8e70
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 構成にサービス エンドポイントを作成する
+エンドポイントは、クライアントが [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスによって提供される機能にアクセスできるようにします。 エンドポイントの相対アドレスと絶対アドレスを組み合わせてサービスのエンドポイントを 1 つ以上定義できます。または、サービス エンドポイントを定義しない場合、ランタイムは既定で一部を提供します。 このトピックでは、相対アドレスと絶対アドレスの両方を含んでいる構成ファイルを使用したエンドポイントの使用方法について説明します。  
+  
+## 使用例  
+ 次のサービス構成では、1 つのベース アドレスと 5 つのエンドポイントを指定します。  
+  
+```xml  
+<configuration>  
+  
+  <appSettings>  
+    <!-- use appSetting to configure base address provided by host -->  
+    <add key="baseAddress" value="http://localhost:8000/servicemodelsamples/service" />  
+  </appSettings>  
+  
+  <system.serviceModel>  
+    <services>  
+    <!-- This section is optional with the default configuration introduced  
+         in .NET Framework 4. -->  
+      <service  
+          name="Microsoft.ServiceModel.Samples.CalculatorService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <endpoint address=""  
+                  binding="wsHttpBinding"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <endpoint address="/test"  
+                  binding="wsHttpBinding"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <endpoint address="http://localhost:8001/hello/servicemodelsamples"  
+                  binding="wsHttpBinding"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <endpoint address="net.tcp://localhost:9000/servicemodelsamples/service"  
+                  binding="netTcpBinding"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is another relative address exposed at   
+             http://localhost:8000/ServiceModelSamples/service/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+  
+```  
+  
+## 使用例  
+ ベース アドレスは、次のサンプルのように `add` 要素を使用して service\/host\/baseAddresses の下に指定します。  
+  
+```xml  
+<service   
+    name="Microsoft.ServiceModel.Samples.CalculatorService">  
+  <host>  
+    <baseAddresses>  
+      <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+    </baseAddresses>  
+  </host>  
+```  
+  
+## 使用例  
+ 次のサンプルの最初のエンドポイント定義では、相対アドレスを指定します。つまり、エンドポイント アドレスは、ベース アドレスと URI \(Uniform Resource Identifier\) 構造の規則に従った相対アドレスの組み合わせということを意味します。 相対アドレスが空 \(""\) のため、エンドポイント アドレスはベース アドレスと同じになります。 具体的には http:\/\/localhost:8000\/servicemodelsamples\/service です。  
+  
+```xml  
+<endpoint address=""   
+    binding="wsHttpBinding"  
+    contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+## 使用例  
+ 2 番目のエンドポイント定義でも、相対アドレスを指定します。次のサンプル構成を参照してください。 相対アドレス "test" がベース アドレスの末尾に追加されています。 具体的には http:\/\/localhost:8000\/servicemodelsamples\/service\/test です。  
+  
+```xml  
+<endpoint address="/test"  
+    binding="wsHttpBinding"  
+    contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+## 使用例  
+ 3 番目のエンドポイント定義では、絶対アドレスを指定します。次のサンプル構成を参照してください。 このアドレスでは、ベース アドレスは使用されていません。 具体的には http:\/\/localhost:8001\/hello\/servicemodelsamples です。  
+  
+```xml  
+<endpoint address="http://localhost:8001/hello/servicemodelsamples"  
+    binding="wsHttpBinding"  
+    contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+## 使用例  
+ 4 番目のエンドポイント アドレスは、絶対アドレスと別のトランスポート \(ここでは TCP\) を指定しています。 このアドレスでは、ベース アドレスは使用されていません。 具体的には net.tcp:\/\/localhost:9000\/servicemodelsamples\/service です。  
+  
+```xml  
+<endpoint address="net.tcp://localhost:9000/servicemodelsamples/service"  
+    binding="netTcpBinding"  
+    contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+## 使用例  
+ ランタイムによって提供された既定のエンドポイントを使用するには、コードまたは構成ファイルでサービス エンドポイントを指定しないでください。 次の例では、サービスを開くときに、ランタイムは既定のエンドポイントを作成します。 既定のエンドポイント、バインディング、および動作の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+```xml  
+<configuration>  
+  
+  <appSettings>  
+    <!-- use appSetting to configure base address provided by host -->  
+    <add key="baseAddress" value="http://localhost:8000/servicemodelsamples/service" />  
+  </appSettings>  
+  
+  <system.serviceModel>  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md b/docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md
new file mode 100644
index 00000000000..42b743f7eb5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : セッションを必要とするサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a7613ef-0df9-47c3-b8dc-47f42cb1fd8b
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : セッションを必要とするサービスを作成する
+セッションでは、複数のエンドポイント間で共有される状態が作成されます。これにより、クライアントとサービス インスタンス間でのコールバック、マルチホップ セキュリティ、関連付けなどの便利な機能を使用できるようになります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]セッションで[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]、アプリケーションを参照してください[セッションを使用した](../../../../docs/framework/wcf/using-sessions.md)します。  
+  
+### <a name="to-specify-that-a-contract-require-its-binding-to-support-sessions"></a>バインディングによるセッションのサポートを要求するコントラクトを指定するには  
+  
+1.  操作を&1; つ以上含むサービス コントラクトを作成します。 サービス コントラクトを作成する方法の例は、次を参照してください。[方法: サービス コントラクトを定義する](../../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)です。  
+  
+2.  変更、 <xref:System.ServiceModel.ServiceContractAttribute?displayProperty=fullName>を設定して、コントラクトを宣言する、 <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName>プロパティをいずれか。  
+  
+    -   <xref:System.ServiceModel.SessionMode?displayProperty=fullName>場合はこのコントラクトは、セッション内で実行する必要があります。  
+  
+    -   <xref:System.ServiceModel.SessionMode?displayProperty=fullName>でこのコントラクトは、セッション内で実行できる場合です。  
+  
+    -   <xref:System.ServiceModel.SessionMode?displayProperty=fullName>場合は、セッション内で、このコントラクトを実行しない必要があります。  
+  
+3.  セッションをサポートするバインディングを使用するようにサービス エンドポイントを構成します。 次の構成例の使用を示しています、 <xref:System.ServiceModel.WSDualHttpBinding?displayProperty=fullName>をサポートする、WS`-`ReliableMessaging セッションです。  
+  
+     [!code[SCA.Session#2](../../../../samples/snippets/common/VS_Snippets_CFX/sca.session/common/hostapplication.exe.config#2)]
+     [!code-csharp[SCA.Session#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/sca.session/cs/hostapplication.exe.config#2)]
+     [!code-vb[SCA.Session#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/sca.session/vb/hostapplication.exe.config#2)]  
+  
+## <a name="example"></a>例  
+ 次のコード例は、コントラクト レベルでのセッション要件を指定して、によってこの要件をサポートするために、構成ファイルを使用する方法を示しています、 <xref:System.ServiceModel.WSDualHttpBinding?displayProperty=fullName>バインドします。  
+  
+ [!code-csharp[SCA.Session#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/sca.session/cs/services.cs#1)]
+ [!code-vb[SCA.Session#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/sca.session/vb/services.vb#1)]  
+  
+ [!code[SCA.Session#2](../../../../samples/snippets/common/VS_Snippets_CFX/sca.session/common/hostapplication.exe.config#2)]
+ [!code-csharp[SCA.Session#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/sca.session/cs/hostapplication.exe.config#2)]
+ [!code-vb[SCA.Session#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/sca.session/vb/hostapplication.exe.config#2)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.ServiceContractAttribute?displayProperty=fullName>   
+ <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.SessionMode?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-service-with-a-contract-interface.md b/docs/framework/wcf/feature-details/how-to-create-a-service-with-a-contract-interface.md
new file mode 100644
index 00000000000..9b3efeb1f7e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-service-with-a-contract-interface.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : コントラクト インターフェイスを使用してサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7b6803f6-d6f9-4cc2-9f1b-6f4c920475d5
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : コントラクト インターフェイスを使用してサービスを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] コントラクトの作成には、インターフェイスの使用が適しています。このコントラクトでは、サービスが提供する操作にアクセスするために必要なメッセージのコレクションと構造を指定します。このインターフェイスでは、インターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> クラスを適用し、公開するメソッドに <xref:System.ServiceModel.OperationContractAttribute> クラスを適用して、入力と出力の種類を定義します。  
+  
+ サービス コントラクト[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  
+  
+### インターフェイスを使用した WCF コントラクトの作成  
+  
+1.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]、C\#、またはその他の共通言語ランタイム言語を使用して、新しいインターフェイスを作成します。  
+  
+2.  インターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> クラスを適用します。  
+  
+3.  インターフェイスのメソッドを定義します。  
+  
+4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のパブリック コントラクトの一部として公開する必要のある各メソッドに、<xref:System.ServiceModel.OperationContractAttribute> クラスを適用します。  
+  
+## 使用例  
+ 次のコード例は、サービス コントラクトを定義するインターフェイスを示しています。  
+  
+ [!code-csharp[c_HowTo_CreateContractWithInterface#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createcontractwithinterface/cs/source.cs#1)]
+ [!code-vb[c_HowTo_CreateContractWithInterface#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_createcontractwithinterface/vb/source.vb#1)]  
+  
+ <xref:System.ServiceModel.OperationContractAttribute> クラスが適用されたメソッドは、既定で要求\/応答メッセージ パターンを使用します。このメッセージ パターン[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 要求\/応答コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md)」を参照してください。属性のプロパティを設定することにより、他のメッセージ パターンを作成および使用できるようになります。その他の例については、「[方法 : 一方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md)」および「[方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-supporting-credential.md b/docs/framework/wcf/feature-details/how-to-create-a-supporting-credential.md
new file mode 100644
index 00000000000..2da03aa3eae
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-supporting-credential.md
@@ -0,0 +1,91 @@
+---
+title: "方法 : サポート資格情報を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0952919-8bb4-4978-926c-9cc108f89806
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : サポート資格情報を作成する
+カスタムのセキュリティ スキームでは、複数の資格情報が必要になることがあります。  たとえば、サービスが、ユーザー名とパスワードだけでなく、クライアントが 18 歳以上であることを証明する資格情報もクライアントに要求することがあります。  この 2 番目の資格情報を*サポート資格情報*と呼びます。  ここでは、このような資格情報を [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントで実装する方法について説明します。  
+  
+> [!NOTE]
+>  サポート資格情報の仕様は、WS\-SecurityPolicy 仕様の一部です。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 「[Web サービスのセキュリティ仕様](http://go.microsoft.com/fwlink/?LinkId=88537)」を参照してください。  
+  
+## トークンのサポート  
+ 簡単に説明すると、メッセージ セキュリティを使用した場合は、常に*プライマリ資格情報* \(たとえば、X.509 証明書、Kerberos チケット\) によってメッセージがセキュリティで保護されます。  
+  
+ 仕様で定義されているとおり、セキュリティ バインディングは、*トークン*を使用してメッセージ交換をセキュリティで保護します。  *トークン*は、セキュリティ資格情報を表したものです。  
+  
+ セキュリティ バインディングは、セキュリティ バインディング ポリシーで特定されたプライマリ トークンを使用して、署名を作成します。  この署名を*メッセージ署名*と呼びます。  
+  
+ メッセージ署名に関連付けられたトークンによって提供されるクレームを増やすために、追加のトークンを指定できます。  
+  
+## 保証、署名、および暗号化  
+ サポート資格情報は、メッセージ内部で送信された*サポート トークン*になります。  WS\-SecurityPolicy 仕様では、次の表に示すように、サポート トークンをメッセージに追加する方法が 4 つ定義されています。  
+  
+|目的|説明|  
+|--------|--------|  
+|符号付き|サポート トークンはセキュリティ ヘッダーに追加され、メッセージ署名によって署名されます。|  
+|保証|*保証トークン*は、メッセージ署名を行います。|  
+|署名および保証|署名付き保証トークンは、メッセージ署名から生成された `ds:Signature` 要素全体を署名し、それ自体がこのメッセージ署名によって署名されます。つまり、両方のトークン \(メッセージ署名に使用されるトークンと署名付き保証トークン\) がお互いに署名します。|  
+|署名および暗号化|暗号化された署名付きサポート トークンは、`wsse:SecurityHeader` に表示されたときに暗号化されている署名付きサポート トークンです。|  
+  
+## サポート資格情報のプログラミング  
+ サポート トークンを使用するサービスを作成するには、[\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を作成する必要があります   \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md).\)  
+  
+ カスタム バインディングを作成する最初の手順は、次の 3 種類のいずれかのセキュリティ バインディング要素を作成することです。  
+  
+-   <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>  
+  
+-   <xref:System.ServiceModel.Channels.TransportSecurityBindingElement>  
+  
+ すべてのクラスは、次の 4 つの関連プロパティを備えた <xref:System.ServiceModel.Channels.SecurityBindingElement> から継承します。  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.EndpointSupportingTokenParameters%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.OperationSupportingTokenParameters%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.OptionalEndpointSupportingTokenParameters%2A>  
+  
+-   <xref:System.ServiceModel.Channels.SecurityBindingElement.OptionalOperationSupportingTokenParameters%2A>  
+  
+#### スコープ  
+ サポート資格情報には、次の 2 つのスコープがあります。  
+  
+-   *エンドポイント サポート トークン*は、エンドポイントのすべての操作をサポートします。  つまり、サポート トークンによって表される資格情報は、エンドポイントの任意の操作が呼び出されたときにいつでも使用できます。  
+  
+-   *操作サポート トークン*は、エンドポイントの特定の操作だけをサポートします。  
+  
+ プロパティ名に示されているように、サポート資格情報は必須またはオプションのどちらかになることができます。  つまり、サポート資格情報は必須ではありませんが、存在する場合は使用され、存在しない場合も認証は失敗しません。  
+  
+## 手順  
+  
+#### サポート資格情報を備えたカスタム バインディングを作成するには  
+  
+1.  セキュリティ バインド要素を作成します。  次の例では、`UserNameForCertificate` 認証モードで <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> を作成します。  <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateUserNameForCertificateBindingElement%2A> メソッドを使用します。  
+  
+2.  サポート パラメーターを対応するプロパティ \(`Endorsing`、`Signed`、`SignedEncrypted`、または `SignedEndorsed`\) によって返される型のコレクションに追加します。  <xref:System.ServiceModel.Security.Tokens> 名前空間に存在する型には、<xref:System.ServiceModel.Security.Tokens.X509SecurityTokenParameters> など、一般的に使用される型があります。  
+  
+## 例  
+  
+### 説明  
+ <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> のインスタンスを作成し、<xref:System.ServiceModel.Security.Tokens.KerberosSecurityTokenParameters> クラスのインスタンスを、Endorsing プロパティによって返されるコレクションに追加する例を次に示します。  
+  
+### コード  
+ [!code-csharp[c_SupportingCredential#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_supportingcredential/cs/source.cs#1)]  
+  
+## 参照  
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-transactional-service.md b/docs/framework/wcf/feature-details/how-to-create-a-transactional-service.md
new file mode 100644
index 00000000000..48dba731368
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-transactional-service.md
@@ -0,0 +1,227 @@
+---
+title: "方法 : トランザクション サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1bd2e4ed-a557-43f9-ba98-4c70cb75c154
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : トランザクション サービスを作成する
+このサンプルでは、トランザクション サービスを作成する際のさまざまな側面と、サービス操作を調整するためにクライアントが起動するトランザクションの使用について説明します。  
+  
+### トランザクション サービスの作成  
+  
+1.  サービス コントラクトを作成し、<xref:System.ServiceModel.TransactionFlowOption> 列挙型の適切な設定を使用して操作に注釈を付け、受信トランザクションの要件を指定します。<xref:System.ServiceModel.TransactionFlowAttribute> は、実装するサービス クラスにも置くことができることに注意してください。こうすると、これらのトランザクション設定を使用するインターフェイスを 1 回実装するだけで済むため、すべての実装で設定を行う必要がありません。  
+  
+    ```  
+    [ServiceContract]  
+    public interface ICalculator  
+    {  
+        [OperationContract]  
+        // Use this to require an incoming transaction  
+        [TransactionFlow(TransactionFlowOption.Mandatory)]  
+        double Add(double n1, double n2);  
+        [OperationContract]  
+        // Use this to permit an incoming transaction  
+        [TransactionFlow(TransactionFlowOption.Allowed)]  
+        double Subtract(double n1, double n2);  
+    }  
+    ```  
+  
+2.  実装クラスを作成し、オプションとして <xref:System.ServiceModel.ServiceBehaviorAttribute> を使用して <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionIsolationLevel%2A> および <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionTimeout%2A> を指定します。多くの場合、<xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionTimeout%2A> の既定値である 60 秒、および <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionIsolationLevel%2A> の既定値である `Unspecified` が適切な設定値となります。操作ごとに、<xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用して、メソッド内で実行される処理が、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> 属性の値に応じたトランザクション スコープの範囲内で行われる必要があるかどうかを指定できます。この場合、`Add` メソッドで使用されるトランザクションは、クライアントからフローしてくる必須の受信トランザクションと同じになり、`Subtract` メソッドで使用されるトランザクションは、受信トランザクションと同じになるか \(クライアントからフローしてくる場合\)、暗黙的にローカルで新たに作成されたトランザクションになります。  
+  
+    ```  
+    [ServiceBehavior(  
+        TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable,  
+        TransactionTimeout = "00:00:45")]  
+    public class CalculatorService : ICalculator  
+    {  
+        [OperationBehavior(TransactionScopeRequired = true)]  
+        public double Add(double n1, double n2)  
+        {  
+            // Perform transactional operation  
+            RecordToLog(String.Format("Adding {0} to {1}", n1, n2));  
+            return n1 + n2;  
+        }  
+  
+        [OperationBehavior(TransactionScopeRequired = true)]  
+        public double Subtract(double n1, double n2)  
+        {  
+            // Perform transactional operation  
+            RecordToLog(String.Format("Subtracting {0} from {1}", n2, n1));  
+            return n1 - n2;  
+        }  
+  
+        private static void RecordToLog(string recordText)  
+        {  
+            // Database operations omitted for brevity  
+            // This is where the transaction provides specific benefit  
+            // - changes to the database will be committed only when  
+            // the transaction completes.  
+        }  
+    }  
+    ```  
+  
+3.  構成ファイルでバインディングを構成して、トランザクション コンテキストのフローを指定し、そのとき使用されるプロトコルを指定します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ServiceModel トランザクションの構成](../../../../docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md).具体的には、エンドポイント要素の `binding` 属性でバインド型を指定します。次のサンプル構成のように、[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素には `transactionalOleTransactionsTcpBinding` という名前のバインディング構成を参照する `bindingConfiguration` 属性が含まれます。  
+  
+    ```  
+    <service name="CalculatorService">  
+      <endpoint address="net.tcp://localhost:8008/CalcService"  
+        binding="netTcpBinding"  
+        bindingConfiguration="transactionalOleTransactionsTcpBinding"  
+        contract="ICalculator"  
+        name="OleTransactions_endpoint" />  
+    </service>  
+    ```  
+  
+     次の構成で示すように、トランザクション フローは、`transactionFlow` 属性を使用して構成レベルで有効にすることができ、トランザクション プロトコルは、`transactionProtocol` 属性を使用して指定できます。  
+  
+    ```  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="transactionalOleTransactionsTcpBinding"  
+          transactionFlow="true"  
+          transactionProtocol="OleTransactions"/>  
+      </netTcpBinding>  
+    </bindings>  
+    ```  
+  
+### 複数のトランザクション プロトコルのサポート  
+  
+1.  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して作成されたクライアントとサービスが関係するシナリオの場合、最適なパフォーマンスを得るためには OleTransactions プロトコルを使用する必要があります。ただし、サード パーティのプロトコル スタックとの相互運用性が必要なシナリオでは、WS\-AT \(WS\-AtomicTransaction\) プロトコルが有用です。次の構成ファイルの例で示すように、プロトコル固有の適切なバインディングを持つ複数のエンドポイントを用意することで、両方のプロトコルを受け入れるように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成できます。  
+  
+    ```  
+    <service name="CalculatorService">  
+      <endpoint address="http://localhost:8000/CalcService"  
+        binding="wsHttpBinding"  
+        bindingConfiguration="transactionalWsatHttpBinding"  
+        contract="ICalculator"  
+        name="WSAtomicTransaction_endpoint" />  
+      <endpoint address="net.tcp://localhost:8008/CalcService"  
+        binding="netTcpBinding"  
+        bindingConfiguration="transactionalOleTransactionsTcpBinding"  
+        contract="ICalculator"  
+        name="OleTransactions_endpoint" />  
+    </service>  
+    ```  
+  
+     トランザクション プロトコルは、`transactionProtocol` 属性を使用して指定します。ただし、このバインディングは WS\-AT プロトコルのみを使用するため、この属性は、システム指定の `wsHttpBinding` には存在しません。  
+  
+    ```  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="transactionalWsatHttpBinding"  
+          transactionFlow="true" />  
+      </wsHttpBinding>  
+      <netTcpBinding>  
+        <binding name="transactionalOleTransactionsTcpBinding"  
+          transactionFlow="true"  
+          transactionProtocol="OleTransactions"/>  
+      </netTcpBinding>  
+    </bindings>  
+    ```  
+  
+### トランザクションの完了の制御  
+  
+1.  既定では [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の操作は、未処理の例外がスローされなかった場合、トランザクションを自動的に完了します。この動作を変更するには、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> プロパティと <xref:System.ServiceModel.OperationContext.SetTransactionComplete%2A> メソッドを使用します。ある操作を他の操作と同じトランザクション内で行う必要がある場合 \(借方と貸方の操作など\)、次の `Debit` 操作の例に示すように、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> プロパティを `false` に設定することで自動完了の動作を無効にできます。`Debit` 操作で使用されるトランザクションは、`Credit1` 操作に示すように <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> プロパティが `true` に設定されているメソッドが呼び出されるまで、または `Credit2` 操作に示すように、<xref:System.ServiceModel.OperationContext.SetTransactionComplete%2A> メソッドを呼び出してトランザクションの完了が明示的に示されるまで、完了しません。2 つの貸方操作は説明のために示されています。一般には単一の貸方処理が使用されます。  
+  
+    ```  
+    [ServiceBehavior]  
+    public class CalculatorService : IAccount  
+    {  
+        [OperationBehavior(  
+            TransactionScopeRequired = true, TransactionAutoComplete = false)]  
+        public void Debit(double n)  
+        {  
+            // Perform debit operation  
+  
+            return;  
+        }  
+  
+        [OperationBehavior(  
+            TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+        public void Credit1(double n)  
+        {  
+            // Perform credit operation  
+  
+            return;  
+        }  
+  
+        [OperationBehavior(  
+            TransactionScopeRequired = true, TransactionAutoComplete = false)]  
+        public void Credit2(double n)  
+        {  
+            // Perform alternate credit operation  
+  
+            OperationContext.Current.SetTransactionComplete();  
+            return;  
+        }  
+    }  
+    ```  
+  
+2.  トランザクションの関連付けを行うため、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> プロパティを `false` に設定するには、セッションの多いバインディングを使用する必要があります。この要件は、<xref:System.ServiceModel.ServiceContractAttribute> の `SessionMode` プロパティで指定します。  
+  
+    ```  
+    [ServiceContract(SessionMode = SessionMode.Required)]  
+    public interface IAccount  
+    {  
+        [OperationContract]  
+        [TransactionFlow(TransactionFlowOption.Allowed)]  
+        void Debit(double n);  
+        [OperationContract]  
+        [TransactionFlow(TransactionFlowOption.Allowed)]  
+        void Credit1(double n);  
+        [OperationContract]  
+        [TransactionFlow(TransactionFlowOption.Allowed)]  
+        void Credit2(double n);  
+    }  
+    ```  
+  
+### トランザクション サービス インスタンスの有効期間の制御  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A> プロパティを使用して、トランザクションが完了したときに基になるサービス インスタンスを解放するかどうかを指定します。構成が変更されていない限り、これは既定で `true` に設定されているため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は効率的で予測可能な "ジャスト イン タイム" アクティベーション動作を示します。後続するトランザクションでサービスを呼び出すと、前回のトランザクションの状態が残らない新規のサービス インスタンスが必ず呼び出されます。これは通常は便利ですが、トランザクションの完了後もサービス インスタンス内に状態を保持する必要がある場合もあります。この例としては、必要な状態やリソースへのハンドルの取得または再構成に負荷がかかる場合があります。これを実行するには、<xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A> プロパティを `false` に設定します。このように設定することで、インスタンスとこれに関連する任意の状態が、後続する呼び出しからも利用できるようになります。この設定を使用する場合は、状態とトランザクションを消去して完了するタイミングと方法を入念に考慮する必要があります。`runningTotal` 変数を使用してインスタンスを保持することで、これを行う方法を次のサンプルに示します。  
+  
+    ```  
+    [ServiceBehavior(TransactionIsolationLevel = [ServiceBehavior(  
+        ReleaseServiceInstanceOnTransactionComplete = false)]  
+    public class CalculatorService : ICalculator  
+    {  
+        double runningTotal = 0;  
+  
+        [OperationBehavior(TransactionScopeRequired = true)]  
+        public double Add(double n)  
+        {  
+            // Perform transactional operation  
+            RecordToLog(String.Format("Adding {0} to {1}", n, runningTotal));  
+            runningTotal = runningTotal + n;  
+            return runningTotal;  
+        }  
+  
+        [OperationBehavior(TransactionScopeRequired = true)]  
+        public double Subtract(double n)  
+        {  
+            // Perform transactional operation  
+            RecordToLog(String.Format("Subtracting {0} from {1}", n, runningTotal));  
+            runningTotal = runningTotal - n;  
+            return runningTotal;  
+        }  
+  
+        private static void RecordToLog(string recordText)  
+        {  
+            // Database operations omitted for brevity  
+        }  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  インスタンスの有効期間はサービスの内部に属する動作であり、<xref:System.ServiceModel.ServiceBehaviorAttribute> プロパティを介して制御できるため、インスタンスの動作を設定するためにサービス構成やサービス コントラクトを変更する必要はありません。また、ネットワーク上にもこれに相当する表現はありません。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-wcf-contract-with-a-class.md b/docs/framework/wcf/feature-details/how-to-create-a-wcf-contract-with-a-class.md
new file mode 100644
index 00000000000..25ba4938ee6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-wcf-contract-with-a-class.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : クラスを使用して Windows Communication Foundation コントラクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 1ad69393-3915-4e7f-9b91-b6fc59c6f5ba
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 方法 : クラスを使用して Windows Communication Foundation コントラクトを作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] コントラクトの作成には、インターフェイスの使用が適しています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : サービス コントラクトを定義する](../../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md).ここで説明する代替方法では、クラスを作成してから、<xref:System.ServiceModel.ServiceContractAttribute> 属性を直接そのクラスに適用し、<xref:System.ServiceModel.OperationContractAttribute> 属性をコントラクトに含まれるクラス内の各メソッドに適用します。  
+  
+> [!WARNING]
+>  `[ServiceContract]` と `[ServiceContractAttribute]` は、同じことを行います。`[OperationContract]` と `[OperationContractAttribute]` でも、同様です。各ケースで、前者は後者の短縮形です。  
+  
+ サービス コントラクト[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  
+  
+### クラスを使用した Windows Communication Foundation コントラクトの作成  
+  
+1.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]、C\#、またはその他の任意の共通言語ランタイム言語を使用して、新しいクラスを作成します。  
+  
+2.  クラスに <xref:System.ServiceModel.ServiceContractAttribute> クラスを適用します。  
+  
+3.  クラスでメソッドを作成します。  
+  
+4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のパブリック コントラクトの一部として公開する必要のある各メソッドに <xref:System.ServiceModel.OperationContractAttribute> クラスを適用します。  
+  
+## 使用例  
+ 次のコード例は、サービス コントラクトを定義するクラスを示しています。  
+  
+ [!code-csharp[c_HowTo_CreateContractWithClass#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_createcontractwithclass/cs/source.cs#1)]
+ [!code-vb[c_HowTo_CreateContractWithClass#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_createcontractwithclass/vb/source.vb#1)]  
+  
+ <xref:System.ServiceModel.OperationContractAttribute> クラスが適用されたメソッドは、既定で要求\/応答メッセージ パターンを使用します。このメッセージ パターン[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 要求\/応答コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-request-reply-contract.md)」を参照してください。属性のプロパティを設定することにより、他のメッセージ パターンを作成および使用できるようになります。その他の例については、「[方法 : 一方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-one-way-contract.md)」および「[方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-wcf-service-that-communicates-over-websockets.md b/docs/framework/wcf/feature-details/how-to-create-a-wcf-service-that-communicates-over-websockets.md
new file mode 100644
index 00000000000..f7d94c4f117
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-wcf-service-that-communicates-over-websockets.md
@@ -0,0 +1,331 @@
+---
+title: "WebSockets 上で通信する WCF サービスを作成する用法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bafbbd89-eab8-4e9a-b4c3-b7b0178e12d8
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WebSockets 上で通信する WCF サービスを作成する用法
+WCF サービスと WCF クライアントは、<xref:System.ServiceModel.NetHttpBinding> バインディングを使用することにより、WebSocket 経由で通信できます。  WebSocket が使用されるのは、サービス コントラクトによってコールバック コントラクトが定義されていると <xref:System.ServiceModel.NetHttpBinding> によって判断された場合です。  ここでは、<xref:System.ServiceModel.NetHttpBinding> を使用して WebSocket 経由で通信する WCF サービスと WCF クライアントの実装方法について説明します。  
+  
+### サービスの定義  
+  
+1.  コールバック コントラクトを定義します。  
+  
+    ```csharp  
+    [ServiceContract]  
+        public interface IStockQuoteCallback  
+        {  
+            [OperationContract(IsOneWay = true)]  
+            Task SendQuote(string code, double value);  
+        }  
+    ```  
+  
+     このコントラクトは、サービス側からクライアントにメッセージを返すことができるようにクライアント アプリケーションで実装されます。  
+  
+2.  サービス コントラクトを定義し、コールバック コントラクトとして `IStockQuoteCallback` インターフェイスを指定します。  
+  
+    ```csharp  
+    [ServiceContract(CallbackContract = typeof(IStockQuoteCallback))]  
+        public interface IStockQuoteService  
+        {  
+            [OperationContract(IsOneWay = true)]  
+            Task StartSendingQuotes();  
+        }  
+    ```  
+  
+3.  サービス コントラクトを実装します。  
+  
+    ```  
+    public class StockQuoteService : IStockQuoteService  
+        {  
+            public async Task StartSendingQuotes()  
+            {  
+                var callback = OperationContext.Current.GetCallbackChannel<IStockQuoteCallback>();  
+                var random = new Random();  
+                double price = 29.00;  
+  
+                while (((IChannel)callback).State == CommunicationState.Opened)  
+                {  
+                    await callback.SendQuote("MSFT", price);  
+                    price += random.NextDouble();  
+                    await Task.Delay(1000);  
+                }  
+            }  
+        }  
+    ```  
+  
+     サービス操作 `StartSendingQuotes` は、非同期呼び出しとして実装されます。  `OperationContext` を使ってコールバック チャネルを取得します。チャネルが開いている場合は、コールバック チャネルで非同期呼び出しを行います。  
+  
+4.  サービスの構成  
+  
+    ```xml  
+    <configuration>  
+        <appSettings>  
+          <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />        
+        </appSettings>  
+        <system.web>  
+          <compilation debug="true" targetFramework="4.5" />        
+        </system.web>  
+        <system.serviceModel>  
+            <protocolMapping>  
+              <add scheme="http" binding="netHttpBinding"/>  
+              <add scheme="https" binding="netHttpsBinding"/>  
+            </protocolMapping>  
+            <behaviors>  
+                <serviceBehaviors>  
+                    <behavior name="">  
+                        <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />  
+                        <serviceDebug includeExceptionDetailInFaults="false" />  
+                    </behavior>  
+                </serviceBehaviors>  
+            </behaviors>  
+            <serviceHostingEnvironment aspNetCompatibilityEnabled="true"  
+                multipleSiteBindingsEnabled="true" />  
+        </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     サービスの構成ファイルは WCF の既定のエンドポイントに依存しています。  作成された既定のエンドポイントに `NetHttpBinding` を使用するように、`<protocolMapping>` セクションを使用して指定しています。  
+  
+### クライアントの定義  
+  
+1.  コールバック コントラクトを実装します。  
+  
+    ```csharp  
+    private class CallbackHandler : StockQuoteServiceReference.IStockQuoteServiceCallback  
+            {  
+                public async Task SendQuoteAsync(string code, double value)  
+                {  
+                    Console.WriteLine("{0}: {1:f2}", code, value);  
+                }  
+            }  
+    ```  
+  
+     コールバック コントラクト操作は、非同期メソッドとして実装されます。  
+  
+    1.  クライアント コードを実装します。  
+  
+        ```csharp  
+        class Program  
+        {  
+            static void Main(string[] args)  
+            {  
+                var context = new InstanceContext(new CallbackHandler());  
+                var client = new StockQuoteServiceReference.StockQuoteServiceClient(context);  
+                client.StartSendingQuotes();              
+                Console.ReadLine();  
+            }  
+  
+            private class CallbackHandler : StockQuoteServiceReference.IStockQuoteServiceCallback  
+            {  
+                public async Task SendQuoteAsync(string code, double value)  
+                {  
+                    Console.WriteLine("{0}: {1:f2}", code, value);  
+                }  
+            }  
+        }  
+        ```  
+  
+         ここでは、わかりやすいように CallbackHandler を繰り返しています。  クライアント アプリケーションは、新しい InstanceContext を作成し、コールバック インターフェイスの実装を指定します。  次に、新しく作成された InstanceContext への参照を送信するプロキシ クラスのインスタンスを作成します。  クライアントがサービスを呼び出すと、サービスは、指定されたコールバック コントラクトを使用してクライアントを呼び出します。  
+  
+    2.  クライアントの構成  
+  
+        ```xml  
+        <?xml version="1.0" encoding="utf-8" ?>  
+        <configuration>  
+            <startup>   
+                <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />  
+            </startup>  
+            <system.serviceModel>  
+                <bindings>  
+                    <netHttpBinding>  
+                        <binding name="NetHttpBinding_IStockQuoteService">  
+                            <webSocketSettings transportUsage="Always" />  
+                        </binding>  
+                    </netHttpBinding>  
+                </bindings>  
+                <client>  
+                    <endpoint address="ws://localhost/NetHttpSampleServer/StockQuoteService.svc"  
+                        binding="netHttpBinding" bindingConfiguration="NetHttpBinding_IStockQuoteService"  
+                        contract="StockQuoteServiceReference.IStockQuoteService" name="NetHttpBinding_IStockQuoteService" />  
+                </client>  
+            </system.serviceModel>  
+        </configuration>  
+        ```  
+  
+         クライアント構成では特別な操作を実行する必要はありません。`NetHttpBinding` を使用して、クライアント側のエンドポイントを指定するだけです。  
+  
+## 使用例  
+ このトピックで使用されているコード全体を次に示します。  
+  
+```csharp  
+// IStockQuoteService.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.Text;  
+using System.Threading.Tasks;  
+  
+namespace Server  
+{  
+    [ServiceContract(CallbackContract = typeof(IStockQuoteCallback))]  
+    public interface IStockQuoteService  
+    {  
+        [OperationContract(IsOneWay = true)]  
+        Task StartSendingQuotes();  
+    }  
+  
+    [ServiceContract]  
+    public interface IStockQuoteCallback  
+    {  
+        [OperationContract(IsOneWay = true)]  
+        Task SendQuote(string code, double value);  
+    }  
+}  
+  
+```  
+  
+```  
+// StockQuoteService.svc.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Channels;  
+using System.Text;  
+using System.Threading.Tasks;  
+  
+namespace Server  
+{  
+    public class StockQuoteService : IStockQuoteService  
+    {  
+        public async Task StartSendingQuotes()  
+        {  
+            var callback = OperationContext.Current.GetCallbackChannel<IStockQuoteCallback>();  
+            var random = new Random();  
+            double price = 29.00;  
+  
+            while (((IChannel)callback).State == CommunicationState.Opened)  
+            {  
+                await callback.SendQuote("MSFT", price);  
+                price += random.NextDouble();  
+                await Task.Delay(1000);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+```xml  
+<?xml version="1.0"?>  
+  
+<!--  
+  For more information on how to configure your ASP.NET application, please visit  
+  http://go.microsoft.com/fwlink/?LinkId=169433  
+  -->  
+  
+<configuration>  
+    <appSettings>  
+      <add key="aspnet:UseTaskFriendlySynchronizationContext" value="true" />        
+    </appSettings>  
+    <system.web>  
+      <compilation debug="true" targetFramework="4.5" />        
+    </system.web>  
+    <system.serviceModel>  
+        <protocolMapping>  
+          <add scheme="http" binding="netHttpBinding"/>  
+          <add scheme="https" binding="netHttpsBinding"/>  
+        </protocolMapping>  
+        <behaviors>  
+            <serviceBehaviors>  
+                <behavior name="">  
+                    <serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />  
+                    <serviceDebug includeExceptionDetailInFaults="false" />  
+                </behavior>  
+            </serviceBehaviors>  
+        </behaviors>  
+        <serviceHostingEnvironment aspNetCompatibilityEnabled="true"  
+            multipleSiteBindingsEnabled="true" />  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+```  
+<!-- StockQuoteService.svc -->  
+<%@ ServiceHost Language="C#" Debug="true" Service="Server.StockQuoteService" CodeBehind="StockQuoteService.svc.cs" %>  
+```  
+  
+```csharp  
+// Client.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.ServiceModel;  
+using System.Text;  
+using System.Threading.Tasks;  
+  
+namespace Client  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            var context = new InstanceContext(new CallbackHandler());  
+            var client = new StockQuoteServiceReference.StockQuoteServiceClient(context);  
+            client.StartSendingQuotes();              
+            Console.ReadLine();  
+        }  
+  
+        private class CallbackHandler : StockQuoteServiceReference.IStockQuoteServiceCallback  
+        {  
+            public async Task SendQuoteAsync(string code, double value)  
+            {  
+                Console.WriteLine("{0}: {1:f2}", code, value);  
+            }  
+        }  
+    }  
+}  
+```  
+  
+```xml  
+<!—App.config -->  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+    <startup>   
+        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />  
+    </startup>  
+    <system.serviceModel>  
+        <bindings>  
+            <netHttpBinding>  
+                <binding name="NetHttpBinding_IStockQuoteService">  
+                    <webSocketSettings transportUsage="Always" />  
+                </binding>  
+            </netHttpBinding>  
+        </bindings>  
+        <client>  
+            <endpoint address="ws://localhost/NetHttpSampleServer/StockQuoteService.svc"  
+                binding="netHttpBinding" bindingConfiguration="NetHttpBinding_IStockQuoteService"  
+                contract="StockQuoteServiceReference.IStockQuoteService" name="NetHttpBinding_IStockQuoteService" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [同期操作と非同期操作](../../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)   
+ [NetHttpBinding の使用](../../../../docs/framework/wcf/feature-details/using-the-nethttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-that-calls-another-workflow-service.md b/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-that-calls-another-workflow-service.md
new file mode 100644
index 00000000000..de3289799b6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-that-calls-another-workflow-service.md
@@ -0,0 +1,140 @@
+---
+title: "方法: 別のワークフロー サービスを呼び出すワークフロー サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99b3ee3e-aeb7-4e6f-8321-60fe6140eb67
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法: 別のワークフロー サービスを呼び出すワークフロー サービスを作成する
+ワークフロー サービスでは、別のワークフロー サービスから情報を取得することが必要になる場合があります。このトピックでは、別のワークフロー サービスからワークフロー サービスを呼び出す方法について説明します。このトピックでは、2 つのワークフロー サービスを作成します。入力文字列を反転させるメソッドを持つワークフロー サービスと、その最初のサービスを使用して文字列を反転させた後、入力文字列を大文字に変換するワークフロー サービスです。  
+  
+### Reverser ワークフロー サービスを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を管理者として実行します。  
+  
+2.  **\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順にクリックします。**\[インストールされたテンプレート\]** ペインの **\[ワークフロー\]** ノードで、**\[WCF ワークフロー サービス アプリケーション\]** を選択します。ソリューションに `NestedServices` という名前を付けて、**\[OK\]** をクリックします。  
+  
+3.  **\[サーバー\]** の **\[ローカル IIS Web サーバーを使用する\]** が選択されていることを確認します。**\[仮想ディレクトリの作成\]** をクリックします。仮想ディレクトリが正しく作成されたことを示すダイアログ ボックスで **\[OK\]** をクリックします。  
+  
+4.  ソリューション エクスプローラーで、Service1.xamlx を `StringReverserService.xamlx` という名前に変更します。  
+  
+5.  新しいプロジェクトの **\[プロジェクトのプロパティ\]** ページで、**\[Web\]** タブをクリックします。**\[開始動作\]** を **\[ページを指定する\]** に設定し、StringReverserService.xamlx を開始するページとして選択します。  
+  
+6.  デザイナーで StringReverserService.xamlx を開いて、既存の `ReceiveRequest` アクティビティおよび `SendReply` アクティビティを削除し、`ReceiveAndSendReply` アクティビティを既存のシーケンス アクティビティにドラッグします。  
+  
+    1.  **\[OperationName\]** を \[ReverseString\] に設定します。  
+  
+    2.  **\[ServiceContractName\]** を \[IReverseString\] に設定します。  
+  
+    3.  **\[CanCreateInstance\]** チェック ボックスをオンにします。  
+  
+7.  **\[SequentialService\]** アクティビティを選択し、デザイナーの下部にある **\[変数\]** タブをクリックします。StringToReverse と ReversedStringToReturn という文字列型の 2 つの新しい変数を作成します。  
+  
+8.  **Receive** アクティビティの **\[定義\]** リンクをクリックします。**\[パラメーター\]** をクリックし、StringToReverse に代入する InputString という文字列型のパラメーターを作成します。  
+  
+9. **SendReplyToReceive** アクティビティの **\[定義\]** リンクをクリックします。**\[パラメーター\]** をクリックし、ReversedStringToReturn に代入される  ReversedString という文字列型のパラメーターを作成します。  
+  
+10. サービスのロジックを実装するには、StringLibrary というプロジェクトで新しいクラスを作成します。クラスの定義を次のコードに置き換えます。  
+  
+    ```  
+    public class StringLibrary  
+        {  
+            public static String ReverseString(string StringToReverse)  
+            {  
+                char[] charArray = StringToReverse.ToCharArray();  
+                Array.Reverse(charArray);  
+                return new String(charArray);  
+            }  
+        }  
+  
+    ```  
+  
+11. 入力で ReverseString メソッドを呼び出すには、ツールボックスから **InvokeMethod** アクティビティを **Receive** アクティビティと **SendReply** アクティビティの間の空白にドラッグします。アクティビティのプロパティを次のように設定します。  
+  
+    1.  **\[MethodName\]**: ReverseString  
+  
+    2.  **\[結果\]**: ReversedStringToReturn  
+  
+    3.  **\[パラメーター\]**: 新しいパラメーターを作成し、**\[方向\]** を \[イン\]、**\[型\]** を \[文字列\]、**\[値\]** を \[StringToReverse\] に設定します。  
+  
+    4.  **\[TargetType\]**: NestedServices.StringLibrary  
+  
+12. F5 キーを押して、サービスをテストします。表示される \[WCF テスト クライアント\] で、ReverseString\(\) メソッドをダブルクリックします。\[要求\] ペインで、InputString パラメーターの \[値\] に 「`Sample`」と入力します。**\[起動\]** をクリックします。サービスにより "elpmaS" が返されます。  
+  
+### UpperCaser ワークフロー サービスを作成するには  
+  
+1.  NestedServices プロジェクトを右クリックして、**\[追加\]**、**\[新しい項目\]** の順に選択します。**\[ワークフロー\]** ノードで、**\[WCF ワークフロー サービス\]** を選択し、新しいサービスに `UpperCaserService` という名前を付けます。**\[追加\]** をクリックします。これにより、UpperCaserService.xamlx という新しいワークフロー サービスがプロジェクトに追加されます。  
+  
+2.  デザイナーで UpperCaserService.xamlx を開いて、既存の **ReceiveRequest** アクティビティおよび `SendReply` アクティビティを削除し、`ReceiveAndSendReply` アクティビティを既存のシーケンス アクティビティにドラッグします。  
+  
+    1.  **\[OperationName\]** を \[UpperCaseString\] に設定します。  
+  
+    2.  **\[ServiceContractName\]** を \[IUpperCaseString\] に設定します。  
+  
+    3.  **\[CanCreateInstance\]** チェック ボックスをオンにします。  
+  
+3.  SequentialService アクティビティを選択し、デザイナーの下部にある **\[変数\]** タブをクリックします。StringToUpper、StringToReverse、StringToReturn という文字列型の 3 つの新しい変数を作成します。  
+  
+4.  **Receive** アクティビティの **\[定義\]** リンクをクリックします。**\[パラメーター\]** をクリックし、StringToUpper に代入する InputString という文字列型のパラメーターを作成します。  
+  
+5.  **SendReplyToReceive** アクティビティの **\[定義\]** リンクをクリックします。**\[パラメーター\]** をクリックし、StringToReturn に代入される ModifiedString という文字列型のパラメーターを作成します。  
+  
+6.  サービスのロジックを実装するには、次のコードを使用して、StringLibrary クラスで新しいメソッドを作成します。  
+  
+    ```  
+    public static String UpperCaseString(string StringToUpperCase)  
+    {  
+         return StringToUpperCase.ToUpper();  
+  
+    }  
+  
+    ```  
+  
+7.  入力で UpperCaseString メソッドを呼び出すには、ツールボックスから **InvokeMethod** アクティビティを **Receive** アクティビティと **SendReply** アクティビティの間の空白にドラッグします。アクティビティのプロパティを次のように設定します。  
+  
+    1.  **\[MethodName\]**: UpperCaseString  
+  
+    2.  **\[結果\]**: StringToReverse  
+  
+    3.  **\[パラメーター\]**: 新しいパラメーターを作成し、**\[方向\]** を \[イン\]、**\[型\]** を \[文字列\]、**\[値\]** を \[StringToUpper\] に設定します。  
+  
+    4.  **\[TargetType\]**: NestedServices.StringLibrary  
+  
+8.  ここで、修正済みの文字列で最初のサービスを呼び出します。プロジェクトを右クリックし、**\[サービス参照の追加\]** をクリックします。http:\/\/localhost\/NestedServices\/StringReverserService.xamlx でサービス参照をサービスに追加し、プロジェクトをビルドして最初の Web サービスにアクセスするカスタム アクティビティを作成します。  
+  
+9. 新しいアクティビティのインスタンスを、**InvokeMethod** アクティビティと **SendReplyToReceive** アクティビティの間のワークフローにドラッグします。変数 StringToReverse を新しいアクティビティの InputString プロパティに、変数 StringToReturn を StringToReturn プロパティに割り当てます。  
+  
+10. NestedServices プロジェクトの \[プロパティ\] ページを開き、**\[Web\]** タブの **\[ページを指定する\]** を UpperCaserService.xamlx に変更します。  
+  
+11. F5 キーを押して、サービスをテストします。表示される \[WCF テスト クライアント\] で、ReverseString\(\) メソッドをダブルクリックします。\[要求\] ペインで、InputString パラメーターの \[値\] に 「`Sample`」と入力します。**\[起動\]** をクリックします。サービスにより "ELPMAS" が返されます。  
+  
+### サービスを呼び出すクライアントを作成するには  
+  
+1.  クライアントという新しいコンソール アプリケーション プロジェクトをソリューションに追加します。  
+  
+2.  クライアント プロジェクトを右クリックして、**\[サービス参照の追加\]** をクリックします。表示されるウィンドウで、**\[探索\]** をクリックします。StringReverserService.xamlx を選択し、名前空間として「ReverseService」と入力します。**\[OK\]** をクリックします。  
+  
+3.  Program.cs の Main メソッドを次のコードで置き換えます。  
+  
+    ```  
+    static void Main(string[] args)  
+    {  
+        Console.Write("Input string to process:");  
+        String input = Console.ReadLine();  
+        var service = new ReverseService.ReverseStringClient();  
+        Console.WriteLine("Output from service: {0}", service.ReverseString(input));  
+        Console.ReadKey();  
+    }  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md b/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md
new file mode 100644
index 00000000000..2978ccbaaad
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md
@@ -0,0 +1,102 @@
+---
+title: "方法: メッセージング アクティビティを使用してワークフロー サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 53d094e2-6901-4aa1-88b8-024b27ccf78b
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法: メッセージング アクティビティを使用してワークフロー サービスを作成する
+このトピックでは、メッセージング アクティビティを使用して単純なワークフロー サービスを作成する方法について説明します。  ここでは、メッセージング アクティビティだけで構成されるサービスのワークフロー サービスを作成する機構に重点を置きます。  実際のサービスでは、ワークフローに他の多くのアクティビティが含まれます。  このサービスは、文字列を取得して、それを呼び出し元に返す、Echo という 1 つの操作を実装します。  このトピックは、一連の 2 つのトピックの最初のものです。  次のトピック「[方法: ワークフロー アプリケーションからサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md)」では、このトピックで作成したサービスを呼び出すワークフロー アプリケーションの作成方法について説明します。  
+  
+### ワークフロー サービス プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動します。  
+  
+2.  **\[ファイル\]** メニューで **\[新規作成\]**、**\[プロジェクト\]** の順に選択して、**\[新しいプロジェクト\]** ダイアログ ボックスを表示します。  インストールされているテンプレートの一覧で **\[ワークフロー\]** を選択し、プロジェクトの種類の一覧で **\[WCF ワークフロー サービス アプリケーション\]** を選択します。  次の図に示すように、プロジェクトに `MyWFService` という名前を付け、既定の場所を使用します。  
+  
+     **\[OK\]** をクリックして **\[新しいプロジェクト\]** ダイアログ ボックスを閉じます。  
+  
+3.  プロジェクトが作成されると、次の図に示すように、Service1.xamlx ファイルがデザイナーで開かれます。  
+  
+     ![デザイナーに表示されている既定のワークフロー](../../../../docs/framework/wcf/feature-details/media/defaultworkflowservice.JPG "DefaultWorkflowService")  
+  
+     "**シーケンシャル サービス**" というラベルの付いたアクティビティを右クリックし、**\[削除\]** をクリックします。  
+  
+### ワークフロー サービスを実装するには  
+  
+1.  画面左側の **\[ツールボックス\]** タブをクリックしてツールボックスを表示し、プッシュピンをクリックしてウィンドウを開いたままにします。  次の図に示すように、ツールボックスの **\[メッセージング\]** セクションを展開して、メッセージング アクティビティおよびメッセージング アクティビティ テンプレートを表示します。  
+  
+     ![メッセージング タブが展開されているツールボックス](../../../../docs/framework/wcf/feature-details/media/wfdesignertoolbox.JPG "WFDesignerToolbox")  
+  
+2.  **\[ReceiveAndSendReply\]** テンプレートをワークフロー デザイナーにドラッグ アンド ドロップします。  これにより、<xref:System.ServiceModel.Activities.Sequence> アクティビティが作成されます。次の図に示すように、**Receive** アクティビティの後に <xref:System.ServiceModel.Activities.SendReply> アクティビティがあります。  
+  
+     ![デザイナーに表示された ReceiveAndSendReply テンプレート](../../../../docs/framework/wcf/feature-details/media/receiveandsendreply.JPG "ReceiveAndSendReply")  
+  
+     <xref:System.ServiceModel.Activities.SendReply> アクティビティの <xref:System.ServiceModel.Activities.SendReply.Request%2A> プロパティは `Receive` に設定されています。これは、<xref:System.ServiceModel.Activities.Receive> アクティビティが応答する <xref:System.ServiceModel.Activities.SendReply> アクティビティの名前です。  
+  
+3.  <xref:System.ServiceModel.Activities.Receive> アクティビティの `[OperationName]` というラベルの付いたボックスに「**Echo**」と入力します。  これにより、サービスが実装する操作の名前が定義されます。  
+  
+     ![操作名を指定する](../../../../docs/framework/wcf/feature-details/media/defineoperation.JPG "DefineOperation")  
+  
+4.  <xref:System.ServiceModel.Activities.Receive> アクティビティを選択した状態で、プロパティ ウィンドウがまだ開いていない場合は、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** をクリックして開きます。  **\[プロパティ ウィンドウ\]** で、**\[CanCreateInstance\]** が表示されるまで下へスクロールし、次の図に示すように、チェックボックスをオンにします。  この設定によって、ワークフロー サービス ホストはメッセージが受信されると \(必要に応じて\) サービスの新しいインスタンスを作成できるようになります。  
+  
+     ![CanCreateInstance プロパティ](../../../../docs/framework/wcf/feature-details/media/cancreateinstance.JPG "CanCreateInstance")  
+  
+5.  <xref:System.ServiceModel.Activities.Sequence> アクティビティを選択し、デザイナーの左下隅にある **\[変数\]** をクリックします。  これにより、変数エディターが開かれます。  **\[変数の作成\]** リンクをクリックして、操作に送られる文字列を格納する変数を追加します。  変数に `msg` という名前を付け、次の図に示すように、その **\[変数\]** の種類を文字列に設定します。  
+  
+     ![変数の追加](../../../../docs/framework/wcf/feature-details/media/addvariable.JPG "AddVariable")  
+  
+     **\[変数\]** をもう一度クリックして、変数エディターを閉じます。  
+  
+6.  アクティビティの **\[コンテンツ\]** ボックスの <xref:System.ServiceModel.Activities.Receive> **\[定義..\]** リンクをクリックして、**\[コンテンツ定義\]** ダイアログ ボックスを表示します。  **\[パラメーター\]** オプション ボタンを選択し、**\[新しいパラメーターの追加\]** リンクをクリックし、`[名前]` ボックスに**「inMsg」**と入力し、**\[型\]** ボックスの **\[文字列\]** を選択し、`[割り当て先]` ボックスに「**msg**」と入力します。  
+  
+     ![パラメーター コンテンツの追加](../../../../docs/framework/wcf/feature-details/media/parameterscontent.jpg "ParametersContent")  
+  
+     これにより、Receive アクティビティが文字列パラメーターを受け取り、そのデータが `msg` 変数にバインドされるように指定されます。  **\[OK\]** をクリックして **\[コンテンツ定義\]** ダイアログ ボックスを閉じます。  
+  
+7.  **\[定義...\]** アクティビティの **\[コンテンツ\]** ボックスの <xref:System.ServiceModel.Activities.SendReply> リンクをクリックして、**\[コンテンツ定義\]** ダイアログ ボックスを表示します。  **\[パラメーター\]** オプション ボタンを選択し、**\[新しいパラメーターの追加\]** リンクをクリックして `[名前]` ボックスに**「msg」**と入力し、**\[型\]** ボックスの **\[文字列\]** を選択し、`[値]` ボックスに「**msg**」と入力します。  
+  
+     ![パラメーター コンテンツの追加](../../../../docs/framework/wcf/feature-details/media/parameterscontent2.jpg "ParametersContent2")  
+  
+     これにより、<xref:System.ServiceModel.Activities.SendReply> アクティビティがメッセージまたはメッセージ コントラクト型を送信し、そのデータが `msg` 変数にバインドされるように指定されます。  これは <xref:System.ServiceModel.Activities.SendReply> アクティビティであるため、`msg` のデータは、アクティビティがクライアントに送り返すメッセージの設定に使用されます。  **\[OK\]** をクリックして **\[コンテンツ定義\]** ダイアログ ボックスを閉じます。  
+  
+8.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックして、ソリューションを保存およびビルドします。  
+  
+## ワークフロー サービス プロジェクトの構成  
+ ワークフロー サービスは完成しました。  ここでは、ホストと実行を容易にするように、ワークフロー サービス ソリューションを構成する方法について説明します。  このソリューションでは、ASP.NET 開発サーバーを使用してサービスをホストします。  
+  
+#### プロジェクトのスタートアップ オプションを設定するには  
+  
+1.  **ソリューション エクスプローラー**で **\[MyWFService\]** を右クリックし、**\[プロパティ\]** をクリックして **\[プロジェクトのプロパティ\]** ダイアログ ボックスを表示します。  
+  
+2.  **\[Web\]** タブを選択し、次の図に示すように、**\[開始動作\]** の **\[ページを指定する\]** を選択して、ボックスに「`Service1.xamlx`」と入力します。  
+  
+     ![プロジェクト プロパティ ダイアログ](../../../../docs/framework/wcf/feature-details/media/projectpropertiesdlg.JPG "ProjectPropertiesDlg")  
+  
+     これにより、ASP.NET 開発サーバーの Service1.xamlx で定義されたサービスがホストされます。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、サービスを起動します。  次の図に示すように、ASP.NET 開発サーバーのアイコンが、デスクトップの右下側に表示されます。  
+  
+     ![ASP.NET Developer Server のアイコン](../../../../docs/framework/wcf/feature-details/media/aspnetdevservericon.JPG "ASPNETDEVServerIcon")  
+  
+     また、Internet Explorer に、サービスの WCF サービス ヘルプ ページが表示されます。  
+  
+     ![WCF ヘルプ ページ](../../../../docs/framework/wcf/feature-details/media/wcfhelppate.JPG "WCFHelpPate")  
+  
+4.  「[方法: ワークフロー アプリケーションからサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md)」トピックに進み、このサービスを呼び出すワークフロー クライアントを作成します。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [ワークフロー サービスのホストの概要](../../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md)   
+ [メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md b/docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md
new file mode 100644
index 00000000000..07833ccc985
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-a-wsfederationhttpbinding.md
@@ -0,0 +1,114 @@
+---
+title: "方法 : WSFederationHttpBinding を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: e54897d7-aa6c-46ec-a278-b2430c8c2e10
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 方法 : WSFederationHttpBinding を作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、<xref:System.ServiceModel.WSFederationHttpBinding> クラス \(構成の [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)\) が、フェデレーション サービスを公開するための機構を提供します。  これはクライアントに対して認証を要求するサービスであって、認証にはセキュリティ トークン サービスが発行するセキュリティ トークンが必要となります。  このトピックでは、必要な処理をコード中に埋め込む形、あるいは構成ファイルに必要な記述を加える形で、<xref:System.ServiceModel.WSFederationHttpBinding> の設定をする手順を説明します。  バインディングを作成すると、エンドポイントを設定してこのバインディングを使用できるようになります。  
+  
+ 基本的な手順の概略を以下に示します。  
+  
+1.  セキュリティ モードを選択します。  <xref:System.ServiceModel.WSFederationHttpBinding> には、メッセージ レベルでエンドツーエンドのセキュリティを提供する `Message` を指定できます。複数のホップや `TransportWithMessageCredential` にまたがる通信であってもこれは有効です。クライアントとサービスが HTTPS 上で直接接続できる場合に、特に性能を発揮します。  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceModel.WSFederationHttpBinding> には、セキュリティ モードとして `None` を指定することもできます。  このモードは安全性が低く、デバッグ目的での使用のみを目的としています。  セキュリティ モードが `None` の <xref:System.ServiceModel.WSFederationHttpBinding> を使用してサービス エンドポイントを配置した場合、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成される <xref:System.ServiceModel.WsHttpBinding> のセキュリティ モードも `None` になります。  
+  
+     `WSFederationHttpBinding` の場合、システムに組み込まれている他のバインディングとは違って、クライアント資格情報の種類を選択する必要はありません。  これは、常に、発行されたトークンを資格情報として使うからです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は指定された発行者からトークンを取得し、これをサービスに提示することによりクライアント認証を行います。  
+  
+2.  フェデレーション クライアントの場合、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerAddress%2A> プロパティの値として、セキュリティ トークン サービスの URL を指定します。  <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerBinding%2A> としてバインディングを指定し、セキュリティ トークン サービスとの通信に使用します。  
+  
+3.  省略可能です。  <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuedTokenType%2A> プロパティの値として、トークンの種類の URI \(Uniform Resource Identifier\) を指定します。  フェデレーション サービスについては、提示されれば受理できるトークンの種類を指定します。  フェデレーション クライアントについては、セキュリティ トークン サービスに要求するトークンの種類を指定します。  
+  
+     トークンの種類を指定しなければ、クライアント側ではその URI なしで WS\-Trust のセキュリティ トークン要求 \(RTS\) を生成します。また、サービス側では、クライアントが既定で SAML \(Security Assertions Markup Language\) 1.1 のトークンを提示して認証するものと想定します。  
+  
+     SAML 1.1 トークンの URI は "http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.1\#SAMLV1.1" です。  
+  
+4.  省略可能です。  フェデレーション サービスの場合、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerMetadataAddress%2A> プロパティの値として、セキュリティ トークン サービスのメタデータ URL を指定します。  メタデータ エンドポイントは、サービスがメタデータを公開するよう設定されている場合に、クライアントが適切なバインディング\/エンドポイントのペアを選択するために必要です。  メタデータの公開[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)」を参照してください。  
+  
+ 他に設定できるプロパティとしては、発行されたトークンの証明キーとして使用するキーの種類、クライアント\/サーバー間で使用するアルゴリズム スイート、サービス資格情報をネゴシエートするか明示的に指定するか、トークンに入っていればそれに応じてサービス側で処理できるクレームの種類、クライアントがセキュリティ トークン サービスに送信する要求に追加しなければならない他の XML 要素などがあります。  
+  
+> [!NOTE]
+>  `NegotiateServiceCredential` プロパティが意味をなすのは、`SecurityMode` の設定値が `Message` である場合に限ります。  `SecurityMode` の設定値が `TransportWithMessageCredential` であれば、`NegotiateServiceCredential` プロパティは無視されます。  
+  
+### 必要な処理をコード中に埋め込む形で WSFederationHttpBinding を設定するには  
+  
+1.  <xref:System.ServiceModel.WSFederationHttpBinding> のインスタンスを作成します。  
+  
+2.  必要に応じて、<xref:System.ServiceModel.WSFederationHttpSecurity.Mode%2A> プロパティを <xref:System.ServiceModel.WSFederationHttpSecurityMode> または <xref:System.ServiceModel.WSFederationHttpSecurityMode> に設定します。  <xref:System.ServiceModel.Security.SecurityAlgorithmSuite.Basic256%2A> 以外のアルゴリズム スイートが必要であれば、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.AlgorithmSuite%2A> プロパティに、列挙体 <xref:System.ServiceModel.Security.SecurityAlgorithmSuite> のいずれかの値を設定します。  
+  
+3.  <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティに適切な値を設定します。  
+  
+4.  必要に応じて、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuedKeyType%2A> プロパティに <xref:System.IdentityModel.Tokens.SecurityKeyType> の `SymmetricKey` または `AsymmetricKey` を設定します。  
+  
+5.  <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuedTokenType%2A> プロパティに適切な値を設定します。  値を設定しない場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって既定値 "http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.1\#SAMLV1.1" に設定されます。これは SAML 1.1 トークンを表します。  
+  
+6.  クライアント側ではローカル発行者が指定されていなければ必須。サービス側では省略可能。  セキュリティ トークン サービスのアドレスと ID 情報が設定された <xref:System.ServiceModel.EndpointAddress> を作成し、この <xref:System.ServiceModel.EndpointAddress> インスタンスを <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerAddress%2A> プロパティに代入します。  
+  
+7.  クライアント側ではローカル発行者が指定されていなければ必須。サービス側では不要。  `SecurityTokenService` の <xref:System.ServiceModel.Channels.Binding> を作成し、この <xref:System.ServiceModel.Channels.Binding> インスタンスを <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.IssuerBinding%2A> プロパティに代入します。  
+  
+8.  クライアント側では不要。サービス側では省略可能。  セキュリティ トークン サービスのメタデータ用の <xref:System.ServiceModel.EndpointAddress> インスタンスを作成し、`IssuerMetadataAddress` プロパティに代入します。  
+  
+9. クライアント側、サービス側とも省略可能。  必要な数の <xref:System.ServiceModel.Security.Tokens.ClaimTypeRequirement> インスタンスを生成し、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.ClaimTypeRequirements%2A> プロパティで返されたコレクションに追加します。  
+  
+10. クライアント側、サービス側とも省略可能。  必要な数の <xref:System.Xml.XmlElement> インスタンスを生成し、<xref:System.ServiceModel.FederatedMessageSecurityOverHttp.TokenRequestParameters%2A> プロパティで返されたコレクションに追加します。  
+  
+### 構成ファイルに必要な記述を加える形でフェデレーション エンドポイントを作成するには  
+  
+1.  [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素の子要素として [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) 要素をアプリケーション構成ファイルに作成します。  
+  
+2.  [\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md) 要素の子要素として [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を 作成し、`name` 属性に適切な値を設定します。  
+  
+3.  [\<binding\>](../../../../docs/framework/misc/binding.md) 要素の子要素として `<security>` 要素を作成します。  
+  
+4.  必要に応じて、`<security>` 要素の `mode` 属性値に `Message` または `TransportWithMessageCredential` を設定します。  
+  
+5.  `<security>` 要素の子要素として `<message>` 要素を作成します。  
+  
+6.  省略可能です。  `<message>` 要素の `algorithmSuite` 属性に適切な値を設定します。  既定値は、`Basic256` です。  
+  
+7.  省略可能です。  非対称証明キーが必要ならば、`<message>` 要素の `issuedKeyType` 属性を `AsymmetricKey` に設定します。  既定値は、`SymmetricKey` です。  
+  
+8.  省略可能です。  `<message>` 要素の `issuedTokenType` 属性を設定します。  
+  
+9. クライアント側ではローカル発行者が指定されていなければ必須。サービス側では省略可能。  `<message>` 要素の子要素として `<issuer>` 要素を作成します。  
+  
+10. `<issuer>` 要素に `address` 属性を設定し、セキュリティ トークン サービスがトークン要求を受け付けるアドレスを指定します。  
+  
+11. 省略可能です。  `<identity>` 子要素を追加し、セキュリティ トークン サービスの識別子を指定します。  
+  
+12. [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md).  
+  
+13. クライアント側ではローカル発行者が指定されていなければ必須。サービス側では不要。  バインディング セクション内に、セキュリティ トークン サービスとの通信に使用可能な [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を作成します。  バインディングの作成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成でサービス バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。  
+  
+14. `<issuer>` 要素の `binding` 属性および `bindingConfiguration` 属性に設定して、前の手順で作成したバインディングを指定します。  
+  
+15. クライアント側では不要。サービス側では省略可能。  \<`message`\> 要素の子要素として `<issuerMetadata>` 要素を作成します。  次に、`<issuerMetadata>` 要素の `address` 属性に、セキュリティ トークン サービスがメタデータを公開するアドレスを指定します。  オプションで、`<identity>` 子要素を追加し、セキュリティ トークン サービスの識別子を指定します。  
+  
+16. クライアント側、サービス側とも省略可能。  `<message>` 要素の子要素として `<claimTypeRequirements>` 要素を追加します。  サービスが依存する必須または省略可能なクレームを指定します。それには、[\<add\>](../../../../docs/framework/configure-apps/file-schema/wcf/add-of-claimtyperequirements.md) 要素を `<claimTypeRequirements>` 要素に追加し、`claimType` 属性でクレームの種類を指定します。  さらに、`isOptional` 属性に、クレームが必須か省略可能かを設定します。  
+  
+## 使用例  
+ 強制的に `WSFederationHttpBinding` を設定するコード例を以下に示します。  
+  
+ [!code-csharp[c_FederationBinding#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_federationbinding/cs/source.cs#2)]
+ [!code-vb[c_FederationBinding#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_federationbinding/vb/source.vb#2)]  
+  
+## 参照  
+ [フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)   
+ [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)   
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md b/docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md
new file mode 100644
index 00000000000..fb525e4de3b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md
@@ -0,0 +1,126 @@
+---
+title: "方法 : 開発中に使用する一時的な証明書を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], 一時的な証明書の作成"
+  - "一時的な証明書 [WCF]"
+ms.assetid: bc5f6637-5513-4d27-99bb-51aad7741e4a
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 開発中に使用する一時的な証明書を作成する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使ってセキュリティ保護されたサービスやクライアントを開発する場合、資格情報として使えるように X.509 証明書を提供する必要が生じることも少なくありません。 証明書は通常、単独ではなく、いくつもの証明書が信頼チェーンとしてつながった形で存在しており、その最上位に位置するルート証明機関の証明書は、各コンピューターの \[信頼されたルート証明機関\] の証明書ストアに格納されています。 証明書を調べて順に信頼チェーンをたどっていくと、たとえば所属する会社や事業部門が運営する、ルート証明機関に到達します。 開発時にこの過程をエミュレートするためには、セキュリティ要件を満たす 2 種類の証明書を作る必要があります。 1 つは自己署名証明書で、\[信頼されたルート証明機関\] の証明書ストアに配置します。もう 1 つは、先の自己署名証明書を使って署名を施した証明書で、\[ローカル コンピューター\] の \[個人\] ストア、または \[現在のユーザー\] の \[個人\] ストアに配置します。 ここでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] SDK に付属する[証明書作成ツール \(MakeCert.exe\)](http://go.microsoft.com/fwlink/?LinkId=248185) を使用して、これら 2 つの証明書を作成する手順を示します。  
+  
+> [!IMPORTANT]
+>  証明書作成ツールによって作成された証明書は、テスト目的にのみ使用できます。 実際にサービスやクライアントを業務に使用する際には、証明機関から取得した、適切な証明書が必要です。 所属する会社が運営している [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] 証明書サーバー、または専門の第三者機関から取得してください。  
+>   
+>  既定では、[Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md) は **"Root Agency"** というルート証明機関の証明書を作成します。"Root Agency" は、\[信頼されたルート証明機関\] の証明書ストアに含まれていないため、作成された証明書はセキュリティで保護されません。 そこで自己署名証明書を作り、\[信頼されたルート証明機関\] の証明書ストアに置くことにより、実際の運用環境をより忠実にシミュレートする開発環境を構築できます。  
+  
+ 証明書の作成方法および使用方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。 証明書を資格情報として使用する方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)」を参照してください。 Microsoft Authenticode テクノロジの使用方法については、「[Authenticode Overviews and Tutorials \(Authenticode の概要とチュートリアル\)](http://go.microsoft.com/fwlink/?LinkId=88919)」を参照してください。  
+  
+### 自己署名ルート証明書を作成して秘密キーをエクスポートするには  
+  
+1.  次のスイッチを指定して MakeCert.exe ツールを使用します。  
+  
+    1.  `-n` `subjectName`。 サブジェクト名を指定します。 命名規則では、サブジェクト名の前に、"Common Name" を示す "CN \= " を付加します。  
+  
+    2.  `-r`。 証明書が自己署名されるように指定します。  
+  
+    3.  `-sv` `privateKeyFile`。 秘密キーを書き出すファイルを指定します。  
+  
+     たとえば次のコマンドを実行すると、サブジェクト名を "CN\=TempCA" とした自己署名証明書が作成されます。  
+  
+    ```  
+    makecert -n "CN=TempCA" -r -sv TempCA.pvk TempCA.cer  
+    ```  
+  
+     秘密キーを保護するためのパスワードを入力するように求められます。 このパスワードは、このルート証明書によって署名された証明書を作成する際に必要になります。  
+  
+### ルート証明書によって署名された新しい証明書を作成するには  
+  
+1.  次のスイッチを指定して MakeCert.exe ツールを使用します。  
+  
+    1.  `-sk` `subjectKey`。 秘密キーを格納する、サブジェクトのキー コンテナーの位置を指定します。 キー コンテナーが存在しない場合は、作成されます。 \-sk も \-sv も指定しなかった場合、既定で JoeSoft という名前のキー コンテナーが作成されます。  
+  
+    2.  `-n` `subjectName`。 サブジェクト名を指定します。 命名規則では、サブジェクト名の前に、"Common Name" を示す "CN \= " を付加します。  
+  
+    3.  `-iv` `issuerKeyFile`。 発行元の秘密キー ファイルを指定します。  
+  
+    4.  `-ic` `issuerCertFile`。 発行元の証明書の位置を指定します。  
+  
+     たとえば、次のコマンドを実行すると、サブジェクト名が `TempCA` で、発行元の秘密キーを使用する証明書が作成されます。ルート証明機関 `"CN=SignedByCA"` の証明書を使って署名されます。  
+  
+    ```  
+    makecert -sk SignedByCA -iv TempCA.pvk -n "CN=SignedByCA" -ic TempCA.cer SignedByCA.cer -sr currentuser -ss My  
+    ```  
+  
+## 信頼されたルート証明機関の証明書ストアに証明書をインストールする  
+ 作成された自己署名証明書は、\[信頼されたルート証明機関\] の証明書ストアにインストールできます。 この証明書で署名された証明書は、この時点で信頼できるものと見なされるようになります。 したがって、この証明書が不要になった場合は、直ちに証明書ストアから削除してください。 この証明書を削除すると、それを使って署名した証明書は認証されなくなります。 ルート証明機関の証明書は、必要に応じて一連の証明書を有効化する手段の 1 つにすぎません。 たとえばピアツーピア アプリケーションの場合、証明書が提示されれば相手の識別情報を信頼できるので、ルート証明機関は必要ないのが普通です。  
+  
+#### 自己署名証明書を信頼されたルート証明機関としてインストールするには  
+  
+1.  証明書スナップインを開きます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)。  
+  
+2.  証明書の格納先となる、**\[ローカル コンピューター\]** または **\[現在のユーザー\]** のフォルダーを開きます。  
+  
+3.  **\[信頼されたルート証明機関\]** フォルダーを開きます。  
+  
+4.  **\[証明書\]** フォルダーを右クリックして、**\[すべてのタスク\]** メニューの **\[インポート\]** を実行します。  
+  
+5.  ウィザード画面が開くので、その指示に従って TempCa.cer を証明書ストアにインポートしてください。  
+  
+## WCF で証明書を使用する  
+ 一時的な証明書を設定したら、それを使用して、クライアント資格情報の種類として証明書を指定する WCF ソリューションを開発できます。 たとえば、次の XML 構成では、メッセージ セキュリティを設定して、クライアント資格情報の種類として証明書を指定しています。  
+  
+#### クライアント資格情報の種類として証明書を指定するには  
+  
+-   サービスの構成ファイルで、次の XML を使用して、セキュリティ モードをメッセージに、クライアント資格情報の種類を証明書に設定します。  
+  
+    ```xml  
+    <bindings>       
+      <wsHttpBinding>  
+        <binding name="CertificateForClient">  
+          <security>  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  
+    ```  
+  
+ クライアントの構成ファイルで、次の XML を使用して、その証明書がユーザーのストアにあり、SubjectName フィールドで "CohoWinery" という値を検索すると見つかることを指定します。  
+  
+```xml  
+  
+<behaviors>  
+  <endpointBehaviors>  
+    <behavior name="CertForClient">  
+      <clientCredentials>  
+        <clientCertificate findValue="CohoWinery" x509FindType="FindBySubjectName" />  
+       </clientCredentials>  
+     </behavior>  
+   </endpointBehaviors>  
+</behaviors>  
+```  
+  
+ WCF での証明書の使用に関する詳細については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+## .NET Framework セキュリティ  
+ 一時的なルート証明書は、不要になったら **\[信頼されたルート証明機関\]** フォルダーや **\[個人\]** フォルダーから確実に削除してください。削除するには、証明書を右クリックし、**\[削除\]** をクリックします。  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-deploy-a-com-integration-application.md b/docs/framework/wcf/feature-details/how-to-deploy-a-com-integration-application.md
new file mode 100644
index 00000000000..fc0114fa91d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-deploy-a-com-integration-application.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : COM+ 統合アプリケーションを展開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e5a0510-db3c-4988-a09c-696285836650
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 方法 : COM+ 統合アプリケーションを展開する
+COM\+ 統合アプリケーションを作成した後、これを別のコンピューターに展開する必要が生じる場合があります。ここでは、COM\+ 統合アプリケーションをコンピューター間で移動する方法を説明します。  
+  
+### COM\+ ホスト統合アプリケーションの移動  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が両方のコンピューターにインストールされていることを確認します。  
+  
+2.  コンピューター A からアプリケーションをエクスポートします。  
+  
+3.  コンピューター B にアプリケーションをインポートします。  
+  
+4.  アプリケーション ルート ディレクトリを設定します。通常これは %PROGRAMFILES%\/ComPlus Applications\/{AppGUID} になります。  
+  
+5.  コンピューター A のアプリケーション ルート ディレクトリにある Application.config ファイルおよび Application.manifest ファイルを、コンピューター B のアプリケーション ルート ディレクトリにコピーします。  
+  
+6.  コンピューター B の Application.config ファイルのサービス エンドポイント アドレスを編集して、コンピューター B が識別されるようにします。たとえば、http:\/\/machineA\/MyService から http:\/\/machineB\/MyService に変更します。  
+  
+### Web ホスト統合アプリケーションの移動  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が両方のコンピューターにインストールされていることを確認します。  
+  
+2.  コンピューター A からアプリケーションをエクスポートします。  
+  
+3.  コンピューター B にアプリケーションをインポートします。  
+  
+4.  コンピューター B で IIS vroot を作成します。  
+  
+5.  コンピューター A の vroot にある .svc ファイル \(componentName.svc\) と Web.config ファイルを、コンピューター B で新しく作成した vroot にコピーします。  
+  
+## 参照  
+ [COM\+ アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md)   
+ [方法 : COM\+ サービス設定を構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)   
+ [方法 : COM\+ サービス モデル構成ツールを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-determine-the-discovery-version-of-a-probe-request.md b/docs/framework/wcf/feature-details/how-to-determine-the-discovery-version-of-a-probe-request.md
new file mode 100644
index 00000000000..3267a20f479
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-determine-the-discovery-version-of-a-probe-request.md
@@ -0,0 +1,36 @@
+---
+title: "方法: Probe 要求の探索バージョンを特定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b3c4e2e2-2957-4074-ae6a-776a5ca84278
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 方法: Probe 要求の探索バージョンを特定する
+探索プロキシでは、異なる探索バージョンを使用する複数の探索エンドポイントを公開する場合があります。  プロキシでは、UDP マルチキャスト Probe 要求を受け取った場合、マルチキャスト抑制メッセージで応答する必要があります。  これを行うには、要求の探索バージョンを特定する必要があります。  
+  
+### Probe 要求の探索バージョンを特定するには  
+  
+1.  次のコードに示すように、Probe 要求に応答するメソッド \(<xref:System.ServiceModel.Discovery.DiscoveryProxy.OnBeginFind%2A> など\) で静的 <xref:System.ServiceModel.OperationContext.Current%2A> プロパティを使用して <xref:System.ServiceModel.Discovery.DiscoveryOperationContextExtension> を検索します。  
+  
+    ```  
+    DiscoveryOperationContextExtension doce = OperationContext.Current.Extensions.Find<DiscoveryOperationContextExtension>();  
+    // Access the discovery version from the DiscoveryOperationContextExtension  
+    doce.DiscoveryVersion;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.ServiceModel.Discovery.Configuration.AnnouncementEndpointElement.DiscoveryVersion%2A>   
+ [探索プロキシの実装](../../../../docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md)   
+ [探索プロキシのサンプル](../../../../docs/framework/wcf/samples/discovery-proxy-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-disable-encryption-of-digital-signatures.md b/docs/framework/wcf/feature-details/how-to-disable-encryption-of-digital-signatures.md
new file mode 100644
index 00000000000..54bb2b88ffb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-disable-encryption-of-digital-signatures.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : デジタル署名の暗号化を無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fd174313-ad81-4dca-898a-016ccaff8187
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : デジタル署名の暗号化を無効にする
+既定では、メッセージは署名され、署名はデジタル暗号化されます。  これは、<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> のインスタンスを使用してカスタム バインディングを作成し、いずれかのクラスの `MessageProtectionOrder` プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> 列挙値に設定することによって制御されます。  既定値は、<xref:System.ServiceModel.Security.MessageProtectionOrder> です。  このプロセスは、単に署名して暗号化する場合よりも、メッセージ全体のサイズによって最大で 30 パーセントほど長い時間がかかります \(メッセージが小さいほどパフォーマンスへの影響は大きくなります\)。  ただし、署名の暗号化を無効にすると、攻撃者がメッセージの内容を予想できるようになる危険性があります。  その理由は、メッセージ内のすべての署名部分のプレーン テキストのハッシュ コードが署名要素に含まれるからです。  たとえば、メッセージ本体は既定で暗号化されますが、暗号化されていない署名には、暗号化される前のメッセージ本体のハッシュ コードが含まれます。  署名および暗号化された部分に指定できる一連の値が小さい場合、攻撃者にハッシュ値を参照され、内容を推測されてしまうおそれがあります。  署名を暗号化すると、このような攻撃は軽減します。  
+  
+ そのため、署名の暗号化を無効にするのは、コンテンツの重要性が低いか、または指定できる一連のコンテンツの値が大きくて非決定性があり、前述の攻撃を軽減するよりもパフォーマンスの向上が重要な場合に限定してください。  
+  
+> [!NOTE]
+>  メッセージ内に暗号化する対象が存在しない場合は、<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティまたは <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティが <xref:System.ServiceModel.Security.MessageProtectionOrder> に設定されていても、署名要素は暗号化されません。  この動作は、システム指定のバインディングでも発生します。すべてのシステム指定のバインディングには、メッセージを保護する順序が `SignBeforeEncryptAndEncryptSignature` に設定されています。  ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が生成する Web サービス記述言語 \(WSDL\) には、依然として `<sp:EncryptSignature>` アサーションが含まれます。  
+  
+### デジタル署名を無効にするには  
+  
+1.  <xref:System.ServiceModel.Channels.CustomBinding> を作成します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md).  
+  
+2.  <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> をバインディング コレクションに追加します。  
+  
+3.  <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> に設定するか、または <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.MessageProtectionOrder%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.Security.MessageProtectionOrder> に設定します。  
+  
+## 参照  
+ [カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md b/docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md
new file mode 100644
index 00000000000..cf836be9dd9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "WCF, フェデレーション"
+ms.assetid: 675fa143-6a4e-4be3-8afc-673334ab55ec
+caps.latest.revision: 16
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 16
+---
+# 方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする
+フェデレーション資格情報を必要とするサービスの中には、セキュリティで保護されたセッションをサポートしないものがあります。その場合は、セキュリティで保護されたセッション機能を無効にする必要があります。<xref:System.ServiceModel.WsHttpBinding> とは異なり、<xref:System.ServiceModel.WSFederationHttpBinding> クラスでは、サービスとの通信中に、セキュリティで保護されたセッションを無効にできません。代わりに、セキュリティで保護されたセッションの設定をブートストラップで置き換えるカスタム バインディングを作成する必要があります。  
+  
+ ここでは、<xref:System.ServiceModel.WSFederationHttpBinding> に含まれるバインド要素を変更してカスタム バインディングを作成する方法を示します。結果は、セキュリティで保護されたセッションを使用しないことを除き、<xref:System.ServiceModel.WSFederationHttpBinding> と同じです。  
+  
+### セキュリティで保護されたセッションを使用しないカスタム フェデレーション バインディングを作成するには  
+  
+1.  コードで強制的に、または構成ファイルから読み込む方法によって、<xref:System.ServiceModel.WSFederationHttpBinding> クラスのインスタンスを作成します。  
+  
+2.  <xref:System.ServiceModel.WSFederationHttpBinding> の複製を <xref:System.ServiceModel.Channels.CustomBinding> 内に作成します。  
+  
+3.  <xref:System.ServiceModel.Channels.CustomBinding> 内で <xref:System.ServiceModel.Channels.SecurityBindingElement> を見つけます。  
+  
+4.  <xref:System.ServiceModel.Channels.SecurityBindingElement> 内で <xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters> を見つけます。  
+  
+5.  元の <xref:System.ServiceModel.Channels.SecurityBindingElement> を <xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters> のブートストラップ セキュリティ バインド要素で置き換えます。  
+  
+## 使用例  
+ 次の例では、セキュリティで保護されたセッションを使用しないカスタム フェデレーション バインディングを作成します。  
+  
+ [!code-csharp[c_CustomFederationBinding#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customfederationbinding/cs/c_customfederationbinding.cs#0)]
+ [!code-vb[c_CustomFederationBinding#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customfederationbinding/vb/c_customfederationbinding.vb#0)]  
+  
+## コードのコンパイル  
+  
+-   このコード例をコンパイルするには、System.ServiceModel.dll アセンブリを参照するプロジェクトを作成します。  
+  
+## 参照  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-dynamic-update.md b/docs/framework/wcf/feature-details/how-to-dynamic-update.md
new file mode 100644
index 00000000000..90f7f15c183
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-dynamic-update.md
@@ -0,0 +1,312 @@
+---
+title: "動的な更新を行う方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b8f6e0d-edab-4a7e-86e3-8c66bebc64bb
+caps.latest.revision: 4
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 動的な更新を行う方法
+ここでは、ルーティング構成の作成および動的な更新に必要な基本的手順について説明します。この例では、ルーティングの初期構成を構成ファイルから取得し、すべてのメッセージを regularCalc 電卓サービスにルーティングします。ただし、これは、roundingCalc のサービスの提供先となるエンドポイントを変更するために、後でプログラムによって更新されます。  
+  
+> [!NOTE]
+>  多くの実装では、構成が完全に動的で、既定の構成に依存しません。ただし、このトピックのシナリオのように、サービスの開始時は既定の構成の状態を使用することが望ましい場合もあります。  
+  
+> [!NOTE]
+>  動的な更新はメモリ内のみで実行され、構成ファイルが変更されることはありません。  
+  
+ regularCalc でも roundingCalc でも、同じ加算、減算、乗算、および除算の操作がサポートされますが、roundingCalc では、すべての計算結果が、四捨五入によって最も近い整数値に変換されてから返されます。regularCalc サービスにすべてのメッセージをルーティングするようにサービスを構成するには、構成ファイルが使用されます。ルーティング サービスが開始されると、<xref:System.ServiceModel.Routing.RoutingExtension.ApplyConfiguration%2A> を使用して、メッセージを roundingCalc サービスにルーティングするようにルーティング サービスが構成されます。  
+  
+### 初期構成の実装  
+  
+1.  サービスによって公開されるサービス エンドポイントを指定することによって、ルーティング サービスの基本的な構成を作成します。次の例では、メッセージの受信に使用される、単一のサービス エンドポイントを定義します。また、regularCalc へのメッセージ送信に使用するクライアント エンドポイントも定義します。  
+  
+    ```xml  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoint for the Routing Service-->  
+        <endpoint address="calculator"  
+                  binding="wsHttpBinding"  
+                  name="routerEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+      </service>  
+    </services>  
+    <client>  
+    <!--set up the destination endpoint-->  
+      <endpoint name="regularCalcEndpoint"  
+                address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+    </client>  
+    ```  
+  
+2.  送信先エンドポイントへのメッセージのルーティングに使用するフィルターを定義します。この例では、MatchAll フィルターを使用して、前に定義した regularCalcEndpoint にすべてのメッセージをルーティングしています。次の例では、フィルターおよびフィルター テーブルを定義します。  
+  
+    ```xml  
+    <filters>  
+      <!--define the message filter-->  
+      <filter name="MatchAllFilter" filterType="MatchAll"/>  
+    </filters>  
+    <filterTables>  
+      <filterTable name="filterTable1">  
+          <!--add the filter to the message filter table-->  
+          <add filterName="MatchAllFilter" endpointName="regularCalcEndpoint"/>  
+      </filterTable>  
+    </filterTables>  
+  
+    ```  
+  
+3.  受信メッセージをフィルター テーブルに含まれているフィルターと照合して評価するには、ルーティング動作を使用して、フィルター テーブルをサービス エンドポイントと関連付ける必要があります。次の例は、filterTable1 をサービス エンドポイントと関連付ける方法を示しています。  
+  
+    ```xml  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+## 動的構成の実装  
+ ルーティング サービスの動的構成は、コードでのみ実行できます。これを実行するには、新しい <xref:System.ServiceModel.Routing.RoutingConfiguration> を作成し、<xref:System.ServiceModel.Routing.RoutingExtension.ApplyConfiguration%2A> を使用して現在の構成を置き換えます。この例では、ルーティング サービスがコンソール アプリケーション内に自己ホストされます。アプリケーションが起動したら、ルーティングの構成を変更できます。メッセージのルーティング先のエンドポイントを構成するには、コンソール ウィンドウで「regular」または「rounding」と入力します。「regular」と入力した場合は regularCalc が、「rounding」と入力した場合は roundingCalc になります。  
+  
+1.  ルーティング サービスをサポートするには、次の using ステートメントを追加する必要があります。  
+  
+    ```csharp  
+    using System;  
+    using System.Collections.Generic;  
+    using System.ServiceModel;  
+    using System.ServiceModel.Channels;  
+    using System.ServiceModel.Description;  
+    using System.ServiceModel.Dispatcher;  
+    using System.ServiceModel.Routing;  
+  
+    ```  
+  
+2.  ルーティング サービスをコンソール アプリケーションとして自己ホストするには、次のコードを使用します。これは、前の手順で説明した構成を使用してルーティング サービスを初期化します。この構成は、アプリケーション構成ファイルに保持されています。while ループには、ルーティング構成の変更に使用されるコードが設定されています。  
+  
+    ```csharp  
+    // Host the service within this EXE console application.  
+    public static void Main()  
+    {  
+        // Create a ServiceHost for the CalculatorService type.  
+        using (ServiceHost serviceHost =  
+            new ServiceHost(typeof(RoutingService)))  
+        {  
+            // Open the ServiceHost to create listeners           
+            // and start listening for messages.  
+            Console.WriteLine("The Routing Service configured, opening....");  
+            serviceHost.Open();  
+            Console.WriteLine("The Routing Service is now running.");  
+             Console.WriteLine("Type 'quit' to terminate router.");  
+             Console.WriteLine("<ENTER> to change routing configuration.");  
+             while (Console.ReadLine() != "quit")  
+             {  
+            ....  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+3.  ルーティング構成を動的に更新するには、新しいルーティング構成を作成する必要があります。作成する構成には、新しいルーティング構成に必要なすべてのエンドポイント、フィルター、およびフィルター テーブルの情報が含まれている必要があります。これは、既存のルーティング構成全体が、この構成に置き換えられるためです。新しいルーティング構成を使用するには、<xref:System.ServiceModel.Routing.RoutingExtension.ApplyConfiguration%2A> を呼び出して新しい構成を渡す必要があります。  
+  
+     前の手順で定義した while ループに次のコードを追加して、ユーザー入力を基にサービスを再構成できるようにします。  
+  
+    ```csharp  
+    Console.WriteLine("Enter 'regular' or 'rounding' to set the destination endpoint:");  
+    string destEndpoint = Console.ReadLine();  
+    // Create a new RoutingConfiguration  
+    RoutingConfiguration rc = new RoutingConfiguration();  
+    // Determine the endpoint to configure for  
+    switch (destEndpoint)  
+    {  
+        case "regular":  
+            // Define the destination endpoint  
+            ServiceEndpoint regularCalc = new ServiceEndpoint(  
+               ContractDescription.GetContract(typeof(IRequestReplyRouter)),  
+               new NetTcpBinding(),  
+               new EndpointAddress("net.tcp://localhost:9090/servicemodelsamples/service/"));  
+            // Create a MatchAll filter and add to the filter table  
+            rc.FilterTable.Add(new MatchAllMessageFilter(), new List<ServiceEndpoint> { regularCalc });  
+            // Use ApplyConfiguration to update the Routing Service  
+            serviceHost.Extensions.Find<RoutingExtension>().ApplyConfiguration(rc);  
+            Console.WriteLine("Applied new routing configuration.");  
+            break;  
+        case "rounding":  
+            // Define the destination endpoint  
+            ServiceEndpoint roundingCalc = new ServiceEndpoint(  
+               ContractDescription.GetContract(typeof(IRequestReplyRouter)),  
+               new NetTcpBinding(),  
+               new EndpointAddress("net.tcp://localhost:8080/servicemodelsamples/service/"));  
+            // Create a MatchAll filter and add to the filter table  
+            rc.FilterTable.Add(new MatchAllMessageFilter(), new List<ServiceEndpoint> { roundingCalc });  
+            // Use ApplyConfiguration to update the Routing Service  
+            serviceHost.Extensions.Find<RoutingExtension>().ApplyConfiguration(rc);  
+            Console.WriteLine("Applied new routing configuration.");  
+            break;  
+        default:  
+            Console.WriteLine("Incorrect value entered, no change.");  
+            break;  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  新しい RoutingConfiguration を提供するメソッドは RoutingExtension service サービス拡張に含まれているため、新しい RoutingConfiguration オブジェクトは、ServiceHost または ServiceExtension \(別の ServiceExtension など\) への参照を含む WCF 拡張モデル、またはこの参照を取得できる WCF 拡張モデル内の任意の場所で提供できます。この方法で RoutingConfiguration を動的に更新する例については、「[動的再構成](../../../../docs/framework/wcf/samples/dynamic-reconfiguration.md)」を参照してください。  
+  
+## 使用例  
+ この例で使用されているコンソール アプリケーション全体の一覧を次に示します。  
+  
+```  
+//-----------------------------------------------------------------  
+//  Copyright (c) Microsoft Corporation.  All Rights Reserved.  
+//-----------------------------------------------------------------  
+  
+using System;  
+using System.Collections.Generic;  
+using System.ServiceModel;  
+using System.ServiceModel.Channels;  
+using System.ServiceModel.Description;  
+using System.ServiceModel.Dispatcher;  
+using System.ServiceModel.Routing;  
+  
+namespace Microsoft.Samples.AdvancedFilters  
+{  
+    public class Router  
+    {  
+        // Host the service within this EXE console application.  
+        public static void Main()  
+        {             
+            // Create a ServiceHost for the CalculatorService type.  
+            using (ServiceHost serviceHost =  
+                new ServiceHost(typeof(RoutingService)))  
+            {  
+                // Open the ServiceHost to create listeners           
+                // and start listening for messages.  
+                Console.WriteLine("The Routing Service configured, opening....");  
+                serviceHost.Open();  
+                Console.WriteLine("The Routing Service is now running.");  
+                Console.WriteLine("Type 'quit' to terminate router.");  
+                Console.WriteLine("<ENTER> to change routing configuration.");  
+                while (Console.ReadLine() != "quit")  
+                {  
+                    Console.WriteLine("Enter 'regular' or 'rounding' to set the destination endpoint:");  
+                    string destEndpoint = Console.ReadLine();  
+                    // Create a new RoutingConfiguration  
+                    RoutingConfiguration rc = new RoutingConfiguration();  
+                    // Determine the endpoint to configure for  
+                    switch (destEndpoint)  
+                    {  
+                        case "regular":  
+                            // Define the destination endpoint  
+                            ServiceEndpoint regularCalc = new ServiceEndpoint(  
+                            ContractDescription.GetContract(typeof(IRequestReplyRouter)),  
+                            new NetTcpBinding(),  
+                            new EndpointAddress("net.tcp://localhost:9090/servicemodelsamples/service/"));  
+                            // Create a MatchAll filter and add to the filter table  
+                            rc.FilterTable.Add(new MatchAllMessageFilter(), new List<ServiceEndpoint> { regularCalc });  
+                            // Use ApplyConfiguration to update the Routing Service  
+                            serviceHost.Extensions.Find<RoutingExtension>().ApplyConfiguration(rc);  
+                            Console.WriteLine("Applied new routing configuration.");  
+                            break;  
+                        case "rounding":  
+                            // Define the destination endpoint  
+                            ServiceEndpoint roundingCalc = new ServiceEndpoint(  
+                                ContractDescription.GetContract(typeof(IRequestReplyRouter)),  
+                                new NetTcpBinding(),  
+                                new EndpointAddress("net.tcp://localhost:8080/servicemodelsamples/service/"));  
+                            // Create a MatchAll filter and add to the filter table  
+                            rc.FilterTable.Add(new MatchAllMessageFilter(), new List<ServiceEndpoint> { roundingCalc });  
+                            // Use ApplyConfiguration to update the Routing Service  
+                            serviceHost.Extensions.Find<RoutingExtension>().ApplyConfiguration(rc);  
+                            Console.WriteLine("Applied new routing configuration.");  
+                            break;  
+                        default:  
+                            Console.WriteLine("Incorrect value entered, no change.");  
+                            break;  
+                    }  
+                }  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+## 使用例  
+ この例で使用されている構成ファイルの全体の一覧を次に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright (c) Microsoft Corporation. All rights reserved -->  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoint for the Routing Service-->  
+        <endpoint address="calculator"  
+                  binding="wsHttpBinding"  
+                  name="routerEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    <client>  
+<!--set up the destination endpoint-->  
+      <endpoint name="regularCalcEndpoint"  
+                address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+    </client>  
+    <routing>  
+  
+      <filters>  
+        <!--define the message filter-->  
+        <filter name="MatchAllFilter" filterType="MatchAll"/>  
+      </filters>  
+      <filterTables>  
+        <filterTable name="filterTable1">  
+            <!--add the filter to the message filter table-->  
+            <add filterName="MatchAllFilter" endpointName="regularCalcEndpoint"/>  
+        </filterTable>  
+      </filterTables>  
+    </routing>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [ルーティング サービス](../../../../docs/framework/wcf/samples/routing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-enable-message-replay-detection.md b/docs/framework/wcf/feature-details/how-to-enable-message-replay-detection.md
new file mode 100644
index 00000000000..824b49338fe
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-enable-message-replay-detection.md
@@ -0,0 +1,114 @@
+---
+title: "方法 : メッセージ リプレイ検出を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "リプレイ検出 [WCF]"
+  - "WCF セキュリティ"
+  - "WCF, カスタム バインディング"
+  - "WCF, セキュリティ"
+ms.assetid: 8b847e91-69a3-49e1-9e5f-0c455e50d804
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 方法 : メッセージ リプレイ検出を有効にする
+リプレイ攻撃は、攻撃者がメッセージのストリームを 2 つのパーティ間でコピーし、そのストリームを他の 1 つ以上のパーティにリプレイすることで発生します。攻撃が止むまで、攻撃対象になったコンピューターはストリームを正当なメッセージとして処理しようとし、その結果、命令が重複するなど、望ましくない状況に陥ります。  
+  
+ メッセージ リプレイ検出[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージ リプレイ検出](http://go.microsoft.com/fwlink/?LinkId=88536)」を参照してください。  
+  
+ 以下の手順では、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でリプレイ検出を制御するために使用できるさまざまなプロパティを示します。  
+  
+### コードを使用してクライアントでのリプレイ検出を制御するには  
+  
+1.  <xref:System.ServiceModel.Channels.CustomBinding> で使用する <xref:System.ServiceModel.Channels.SecurityBindingElement> を作成します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md).次の例では、<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateKerberosBindingElement%2A> を使用して作成された <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> を使用します。  
+  
+2.  <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalClientSettings%2A> プロパティを使用して <xref:System.ServiceModel.Channels.LocalClientSecuritySettings> クラスへの参照を返し、次のプロパティを適切な値に設定します。  
+  
+    1.  `DetectReplay`.ブール値。サーバーからのリプレイをクライアントが検出するかどうかを制御します。既定値は `true` です。  
+  
+    2.  `MaxClockSkew`.<xref:System.TimeSpan> 値。リプレイ機構に許容されるクライアントとサーバー間の時刻のずれを制御します。セキュリティ機構は送信されたメッセージのタイム スタンプを調べ、メッセージが古すぎるかどうかを決定します。既定値は 5 分です。  
+  
+    3.  `ReplayWindow`.`TimeSpan` 値。メッセージがサーバーによって送信されてから \(中継局を通過して\) クライアントに到達するまで、ネットワーク内に存在できる期間を制御します。クライアントは、リプレイ検出のため、最新の `ReplayWindow` 内で送信されたメッセージの署名を追跡します。  
+  
+    4.  `ReplayCacheSize`.整数値。クライアントは、メッセージの署名をキャッシュに格納します。この設定は、キャッシュに格納できる署名の数を指定します。最新のリプレイ ウィンドウ内の送信されたメッセージの数がキャッシュ制限に達すると、キャッシュされた最も古い署名が制限時間に達するまで、新しいメッセージは拒否されます。既定値は 500000 です。  
+  
+### コードを使用してサービスでのリプレイ検出を制御するには  
+  
+1.  <xref:System.ServiceModel.Channels.CustomBinding> で使用する <xref:System.ServiceModel.Channels.SecurityBindingElement> を作成します。  
+  
+2.  <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalServiceSettings%2A> プロパティを使用して <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings> クラスへの参照を返し、前述のように各プロパティを設定します。  
+  
+### クライアントまたはサービスの構成でリプレイ検出を制御するには  
+  
+1.  [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を作成します。  
+  
+2.  `<security>` 要素を作成します。  
+  
+3.  [\<localClientSettings\>](../../../../docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md)または [\<localServiceSettings\>](../../../../docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md)を作成します。  
+  
+4.  `detectReplays`、`maxClockSkew`、`replayWindow`、および `replayCacheSize` の各属性値を適切に設定します。`<localServiceSettings>``<localClientSettings> 要素と`  要素の両方の属性を設定する例を次に示します。  
+  
+    ```  
+    <customBinding>  
+      <binding name="NewBinding0">  
+       <textMessageEncoding />  
+        <security>  
+         <localClientSettings   
+          replayCacheSize="800000"   
+          maxClockSkew="00:03:00"  
+          replayWindow="00:03:00" />  
+         <localServiceSettings   
+          replayCacheSize="800000"   
+          maxClockSkew="00:03:00"  
+          replayWindow="00:03:00" />  
+        <secureConversationBootstrap />  
+       </security>  
+      <httpTransport />  
+     </binding>  
+    </customBinding>  
+    ```  
+  
+## 使用例  
+ 次の例は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateKerberosBindingElement%2A> メソッドを使用して <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> を作成し、作成されたバインディングのリプレイ プロパティを設定します。  
+  
+ [!code-csharp[c_ReplayDetection#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_replaydetection/cs/source.cs#1)]
+ [!code-vb[c_ReplayDetection#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_replaydetection/vb/source.vb#1)]  
+  
+## リプレイのスコープ : メッセージ セキュリティのみ  
+ 次の手順は、メッセージ セキュリティ モードにのみ適用されます。トランスポート モードとメッセージ資格情報付きトランスポート モードでは、トランスポート機構がリプレイを検出します。  
+  
+## セキュリティで保護されたメッセージ交換に関するメモ  
+ セキュリティで保護されたメッセージ交換を有効にするバインディングでは、アプリケーション チャネルとセキュリティで保護されたメッセージ交換のブートストラップ バインディングの両方で、上記の設定を調整できます。たとえば、アプリケーション チャネルに対するリプレイを無効にして、セキュリティで保護されたメッセージ交換を確立するブートストラップ チャネルに対するリプレイを有効にできます。  
+  
+ セキュリティで保護されたメッセージ交換セッションを使用しない場合、サーバー ファームのシナリオでのリプレイや、プロセスをリサイクルしたときのリプレイについては、リプレイ検出による検出が保証されません。これは、次のシステム指定のバインディングに当てはまります。  
+  
+-   <xref:System.ServiceModel.BasicHttpBinding>.  
+  
+-   <xref:System.ServiceModel.NonDualMessageSecurityOverHttp.EstablishSecurityContext%2A> プロパティが `false` に設定された <xref:System.ServiceModel.WSHttpBinding>。  
+  
+## コードのコンパイル  
+  
+-   コードのコンパイルには次の名前空間が必要です。  
+  
+-   <xref:System>  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.ServiceModel.Channels>  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.LocalClientSecuritySettings>   
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>   
+ [セキュリティ保護されたメッセージ交換とセッション](../../../../docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md)   
+ [\<localClientSettings\>](../../../../docs/framework/configure-apps/file-schema/wcf/localclientsettings-element.md)   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-enable-streaming.md b/docs/framework/wcf/feature-details/how-to-enable-streaming.md
new file mode 100644
index 00000000000..b8ede97058f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-enable-streaming.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : ストリーミングを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ca2cf4b-c7a1-49d8-a79b-843a90556ba4
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : ストリーミングを有効にする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、バッファー転送またはストリーミング転送を使用してメッセージを送信できます。 既定のバッファー転送モードでは、受信側がメッセージを読み取る前に、メッセージの送信が完了している必要があります。 ストリーミング転送モードでは、送信が完了していなくても、受信側でメッセージの処理を開始できます。 ストリーミング モードは、渡される情報が長い場合、または連続的に処理する場合に役立ちます。 ストリーミング モードは、メッセージが大きすぎてすべてをバッファーできない場合にも役立ちます。  
+  
+ ストリーミングを有効にするには、`OperationContract` を適切に定義し、トランスポート レベルでストリーミングを有効にします。  
+  
+### <a name="to-stream-data"></a>データをストリーミングするには  
+  
+1.  データをストリーミングするには、サービスの `OperationContract` が次の&2; つの要件を満たしている必要があります。  
+  
+    1.  ストリーミングするデータを保持するパラメーターが、メソッド内の唯一のパラメーターになるようにします。 たとえば、入力メッセージをストリーミングする場合、厳密に&1; つの入力パラメーターが操作に含まれている必要があります。 同様に、出力メッセージをストリーミングする場合、厳密に&1; つの出力パラメーターまたは戻り値が操作に含まれている必要があります。  
+  
+    2.  パラメーターと戻り値の型の少なくとも&1; つある必要があります<xref:System.IO.Stream>、<xref:System.ServiceModel.Channels.Message>、または<xref:System.Xml.Serialization.IXmlSerializable>します。  
+  
+     ストリーミングされたデータのコントラクトの例を次に示します。  
+  
+     [!code-csharp[c_HowTo_EnableStreaming#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_enablestreaming/cs/service.cs#1)]
+     [!code-vb[c_HowTo_EnableStreaming#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_enablestreaming/vb/service.vb#1)]  
+  
+     `GetStream` 操作は、バッファーされた入力データを `string` として受信し、ストリーミングされた `Stream` を返します。 逆に言えば、`UploadStream` は `Stream` (ストリーミング) を取り込んで、`bool` (バッファー) を返します。 `EchoStream` は `Stream` を出し入れします。これは、入力および出力メッセージがどちらもストリーミングされる操作の例です。 最後に、`GetReversedStream` は入力を行わずに `Stream` (ストリーミング) を返します。  
+  
+2.  バインディングではストリーミングを有効にする必要があります。 `TransferMode` プロパティを次の値のいずれかに設定します。  
+  
+    1.  `Buffered`、  
+  
+    2.  `Streamed` (両方向のストリーミング通信を有効にする)。  
+  
+    3.  `StreamedRequest` (要求に対してのみストリーミングを有効にする)。  
+  
+    4.  `StreamedResponse` (応答に対してのみストリーミングを有効にする)。  
+  
+     `BasicHttpBinding` は、バインディングの `TransferMode` プロパティを公開し、`NetTcpBinding` と `NetNamedPipeBinding` も公開します。 `TransferMode` プロパティをトランスポート バインド要素に設定し、カスタム バインディングで使用することもできます。  
+  
+     次のサンプルは、コードで `TransferMode` を設定する方法と、構成ファイルを変更して設定する方法を示しています。 どちらのサンプルも、受信可能なメッセージの最大サイズを決定する `maxReceivedMessageSize` プロパティを 64 MB に設定します。 既定の `maxReceivedMessageSize` は 64 KB です。これは、多くの場合ストリーミングを行うには小さすぎます。 アプリケーションでの受信が予想されるメッセージ最大サイズに応じて、このクォータ設定を適切に変更してください。 また、`maxBufferSize` によりバッファーの最大サイズが決定されるので、適切に設定してください。  
+  
+    1.  次のサンプルの構成スニペットでは、`TransferMode` とカスタム HTTP バインディングで、`basicHttpBinding` プロパティをストリーミングに設定しています。  
+  
+         [!code[c_HowTo_EnableStreaming#103](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_enablestreaming/common/app.config#103)]  
+  
+    2.  次のコード スニペットでは、`TransferMode` とカスタム HTTP バインディングで、`basicHttpBinding` プロパティをストリーミングに設定しています。  
+  
+         [!code-csharp[c_HowTo_EnableStreaming_code#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_enablestreaming_code/cs/c_howto_enablestreaming_code.cs#2)]
+         [!code-vb[c_HowTo_EnableStreaming_code#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_enablestreaming_code/vb/c_howto_enablestreaming_code.vb#2)]  
+  
+    3.  次のコード スニペットでは、カスタム TCP バインディングで、`TransferMode` プロパティをストリーミングに設定しています。  
+  
+         [!code-csharp[c_HowTo_EnableStreaming_code#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_enablestreaming_code/cs/c_howto_enablestreaming_code.cs#3)]
+         [!code-vb[c_HowTo_EnableStreaming_code#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_enablestreaming_code/vb/c_howto_enablestreaming_code.vb#3)]  
+  
+3.  `GetStream`、`UploadStream`、および `EchoStream` の各操作では、ファイルからデータを直接送信したり、受信したデータを直接ファイルに保存します。 次のコードは、`GetStream` の例です。  
+  
+     [!code-csharp[c_HowTo_EnableStreaming#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_enablestreaming/cs/service.cs#4)]
+     [!code-vb[c_HowTo_EnableStreaming#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_enablestreaming/vb/service.vb#4)]  
+  
+### <a name="writing-a-custom-stream"></a>カスタム ストリームの書き込み  
+  
+1.  カスタム ストリーム クラスを派生が送信されるデータ ストリームの各チャンクに対して特殊な処理を行うに<xref:System.IO.Stream>します。 カスタム ストリームの例として、`GetReversedStream` メソッドと `ReverseStream` クラスのコードを次に示します。  
+  
+     `GetReversedStream` では、`ReverseStream` の新しいインスタンスを作成して返します。 実際の処理は、システムが `ReverseStream` オブジェクトの読み取りを行うときに発生します。 `ReverseStream.Read` メソッドは、基になるファイルからバイトのチャンクを読み取り、バイトを反転し、その反転したバイトを返します。 このメソッドは、ファイル全体の内容を反転しません。一度に&1; つのバイト チャンクを反転します。 この例では、ストリームの内容の読み取りやストリームへの書き込み時に、ストリーミング処理を実行する方法を示します。  
+  
+     [!code-csharp[c_HowTo_EnableStreaming#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_enablestreaming/cs/service.cs#2)]
+     [!code-vb[c_HowTo_EnableStreaming#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_enablestreaming/vb/service.vb#2)]  
+  
+## <a name="see-also"></a>関連項目  
+ [大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md)   
+ [ストリーム](../../../../docs/framework/wcf/samples/stream.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md b/docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md
new file mode 100644
index 00000000000..47eea89faa5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Net.TCP ポート共有サービスを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ポート共有 [WCF]"
+  - "アクティブ化サービス [WCF]"
+ms.assetid: c9175af4-c27c-4765-bf45-b8f7528a7282
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : Net.TCP ポート共有サービスを有効にする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は NET.TCP ポート共有サービスと呼ばれる Windows サービスを使用し、複数のプロセス間での TCP ポート共有を実現します。 このサービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の一部としてインストールされますが、セキュリティ予防措置としてデフォルトでは有効になっていません。したがって、初めて使用する前に手動で有効にする必要があります。 このトピックでは、Microsoft 管理コンソール (MMC) スナップインを使用して、Net TCP ポート共有サービスを設定する方法について説明します。  
+  
+ Net.TCP ポート共有サービスを有効にするし、手動で開始するを参照してください。[する方法: ポート共有を使用する WCF サービスを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md)このサービスを使用するサービスを構成する方法についてです。  
+  
+ Net.tcp:// ポート共有を使用してサンプルの場合は、次を参照してください。、 [Net.TCP ポート共有のサンプル](../../../../docs/framework/wcf/samples/net-tcp-port-sharing-sample.md)します。  
+  
+### <a name="to-enable-the-nettcp-port-sharing-service-using-mmc"></a>MMC を使用して Net.TCP ポート共有サービスを有効にするには  
+  
+1.  [スタート] メニューから、コマンド プロンプト ウィンドウを開き、入力のいずれかのサービス管理コンソールを開きます`services.msc`または実行を開き、」と入力して`services.msc`ボックスにします。  
+  
+2.  **名**サービスの一覧の列を右クリックし、 **Net.Tcp ポート共有サービス**を選択して**プロパティ** メニューからです。  
+  
+3.  サービスの手動起動を有効にする、**プロパティ**ウィンドウ] を選択、**全般**] タブの [し、[、**スタートアップの種類**ボックスの [手動] をクリックして**適用**します。  
+  
+4.  サービスの状態 領域で、サービスを開始する場合、**開始** ボタンをクリックします。 これで、サービスの状態には "開始" が表示されます。  
+  
+5.  サービスの一覧に戻り、をクリックして、 **OK**、MMC コンソールを終了するとします。  
+  
+## <a name="example"></a>例  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## <a name="see-also"></a>関連項目  
+ [Net.TCP ポート共有](../../../../docs/framework/wcf/feature-details/net-tcp-port-sharing.md)   
+ [Net.TCP ポート共有サービスを構成します。](../../../../docs/framework/wcf/feature-details/configuring-the-net-tcp-port-sharing-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-error-handling.md b/docs/framework/wcf/feature-details/how-to-error-handling.md
new file mode 100644
index 00000000000..eb350a7b51e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-error-handling.md
@@ -0,0 +1,186 @@
+---
+title: "エラーを処理する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: de566e39-9358-44ff-8244-780f6b799966
+caps.latest.revision: 5
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# エラーを処理する方法
+ここでは、エラー処理を使用するルーティング構成の作成に必要な基本的な手順について説明します。  この例では、メッセージは送信先エンドポイントにルーティングされます。  ネットワークまたは通信関係の障害 \(<xref:System.ServiceModel.CommunicationException>\) のために、メッセージを配信できない場合、そのメッセージは代替エンドポイントに再送信されます。  
+  
+> [!NOTE]
+>  ネットワーク障害をシミュレートするために、この例で使用される送信先エンドポイントには、誤ったアドレスが格納されています。  指定したアドレスをリッスンするサービスがないため、このエンドポイントにルーティングされるメッセージはエラーになります。  
+  
+> [!NOTE]
+>  このトピックの例では、タイムアウト設定について明示的に説明していませんが、エラー処理を使用する際には、この点を考慮する必要があります。  エラーが発生すると、クライアントが応答を受け取る前に、追加の遅延が発生します。  これは、ルーティング サービスがエラーを受信し、そのメッセージをバックアップ エンドポイントに送信しようとするためです。  プライマリおよびバックアップの送信先エンドポイントに関連付けられたタイムアウト値が大きい場合は、クライアントでの遅延が大きくなることがあります。これは、メッセージが、バックアップ リスト内の複数のエンドポイントをフェールオーバーした後に、正常に送信されるためです。  
+>   
+>  ルーティング サービスが受ける遅延は、最大の場合、フィルターと関連付けられたすべてのエンドポイントのタイムアウト値の合計となる可能性があるため、これに応じて、クライアントで予測されるタイムアウト値を増やすことをお勧めします。  
+  
+### エラー処理の実装  
+  
+1.  サービスによって公開されるサービス エンドポイントを指定することによって、ルーティング サービスの基本的な構成を作成します。  次の例では、メッセージの受信に使用される、単一のサービス エンドポイントを定義します。  また、メッセージ送信に使用する deadDestination および realDestination クライアント エンドポイントも定義します。  deadDestination エンドポイントには、実行中のサービスを参照していないアドレスが格納されており、このエンドポイントへのメッセージ送信時のネットワーク障害をシミュレートするために使用されます。  
+  
+    ```xml  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/" />  
+          </baseAddresses>  
+        </host>  
+        <!-- Create the Routing Service endpoint -->  
+        <endpoint address="router"  
+                  binding="basicHttpBinding"  
+                  name="RoutingServiceEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+      </service>  
+    </services>  
+  
+    <!-- Create the destination endpoints that we want to send to -->  
+    <client>  
+      <!-- Create a dummy endpoint that we know will be down -->  
+      <endpoint name="deadDestination"   
+                address="net.tcp://localhost:9090/servicemodelsamples/fakeDestination"  
+                binding="netTcpBinding"  
+                contract="*" />  
+  
+      <!-- Now create the real service endpoint -->  
+      <endpoint name="realDestination"   
+                address="net.tcp://localhost:8080/servicemodelsamples/service"  
+                binding="netTcpBinding"   
+                contract="*" />  
+    </client>  
+    ```  
+  
+2.  送信先エンドポイントにメッセージをルーティングするのに使用するフィルターを定義します。  この例では、ルーティング サービスが受信するすべてのメッセージと照合するために MatchAll フィルターを使用します。  
+  
+    ```xml  
+    <filters>  
+      <!-- Create a MatchAll filter which will catch all messages -->  
+      <filter name="MatchAllFilter1" filterType="MatchAll" />  
+    </filters>  
+  
+    ```  
+  
+3.  バックアップ エンドポイント リストを定義します。このリストには、プライマリ送信先エンドポイントへの送信時にネットワークまたは通信の障害が発生した場合に、メッセージの送信先となるエンドポイントを格納します。  次の例では、1 つのエンドポイントを格納しているバックアップ リストを定義します。ただし、複数のエンドポイントを 1 つのバックアップ リストに指定できます。  
+  
+     バックアップ リストに複数のエンドポイントが格納されている場合、ネットワークまたは通信の障害が発生すると、ルーティング サービスでは、そのリスト内の最初のエンドポイントにメッセージを送信しようとします。  このエンドポイントへの送信時にネットワークまたは通信の障害が発生した場合、そのルーティング サービスでは、そのリスト内の次のエンドポイントにメッセージを送信しようとします。  このサービスは、メッセージが正常に送信されるか、すべてのバックアップ エンドポイントがネットワークまたは通信関連のエラーを返すか、メッセージが送信されてエンドポイントがネットワーク以外で通信関連以外のエラーを返すまで、このバックアップ エンドポイント リスト内の各エンドポイントにメッセージの送信を続けます。  
+  
+    ```  
+    <backupLists>          
+      <backupList name="backupEndpointList">  
+          <add endpointName="realDestination" />  
+      </backupList>  
+    </backupLists>  
+    ```  
+  
+4.  フィルターを deadDestination エンドポイントおよびバックアップ エンドポイント リストと関連付けるフィルター テーブルを定義します。  まず、ルーティング サービスは、このフィルターに関連付けられた送信先エンドポイントにメッセージを送信しようとします。  deadDestination エンドポイントには、実行中のサービスを参照していないアドレスが格納されているため、これはネットワーク エラーになります。  次に、このルーティング サービスは、backupEndpointlist に指定されたエンドポイントにメッセージを送信しようとします。  
+  
+    ```xml  
+    <filterTables>  
+            <!-- Set up the Routing Service's Message Filter Table -->  
+            <filterTable name="filterTable1">  
+                <!-- Add an entity that maps the MatchAllMessageFilter to the dead destination -->  
+                <!-- If that endpoint is down, tell the Routing Service to try the endpoints -->  
+                <!-- Listed in the backupEndpointList -->  
+                <add filterName="MatchAllFilter1" endpointName="deadDestination" backupList="backupEndpointList"/>  
+            </filterTable>  
+          </filterTables>  
+  
+    ```  
+  
+5.  受信メッセージをフィルター テーブルに含まれているフィルターと照合して評価するには、ルーティング動作を使用して、フィルター テーブルをサービス エンドポイントと関連付ける必要があります。  次の例は、filterTable1 をサービス エンドポイントと関連付ける方法を示しています。  
+  
+    ```xml  
+    <behaviors>  
+      <serviceBehaviors>  
+        <!-- Set up the Routing Behavior -->  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+## 使用例  
+ 構成ファイル全体の一覧を次に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright (c) Microsoft Corporation.  All Rights Reserved. -->  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/" />  
+          </baseAddresses>  
+        </host>  
+        <!-- Create the Routing Service endpoint -->  
+        <endpoint address="router"  
+                  binding="basicHttpBinding"  
+                  name="RoutingServiceEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <!-- Set up the Routing Behavior -->  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <!-- Create the destination endpoints that we want to send to -->  
+    <client>  
+      <!-- Create a dummy endpoint that we know will be down -->  
+      <endpoint name="deadDestination"   
+                address="net.tcp://localhost:9090/servicemodelsamples/fakeDestination"  
+                binding="netTcpBinding"  
+                contract="*" />  
+  
+      <!-- Now create the real service endpoint -->  
+      <endpoint name="realDestination"   
+                address="net.tcp://localhost:8080/servicemodelsamples/service"  
+                binding="netTcpBinding"   
+                contract="*" />  
+    </client>  
+    <routing>  
+      <filters>  
+        <!-- Create a MatchAll filter which will catch all messages -->  
+        <filter name="MatchAllFilter1" filterType="MatchAll" />  
+      </filters>  
+      <filterTables>  
+        <!-- Set up the Routing Service's Message Filter Table -->  
+        <filterTable name="filterTable1">  
+            <!-- Add an entrty that maps the MatchAllMessageFilter to the dead destination -->  
+            <!-- If that endpoint is down, tell the Routing Service to try the endpoints -->  
+            <!-- Listed in the backupEndpointList -->  
+            <add filterName="MatchAllFilter1" endpointName="deadDestination" backupList="backupEndpointList"/>  
+        </filterTable>  
+      </filterTables>  
+      <!-- Create the backup endpoint list -->  
+      <backupLists>          
+        <backupList name="backupEndpointList">  
+            <add endpointName="realDestination" />  
+        </backupList>  
+      </backupLists>  
+      </routing>  
+  </system.serviceModel>  
+</configuration>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md b/docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md
new file mode 100644
index 00000000000..a23403d7c62
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62210fd8-a372-4d55-ab9b-c99827d1885e
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する
+既存の MSMQ アプリケーションを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションと統合できます。それには、メッセージ キュー (MSMQ) 統合バインディングを使用して MSMQ メッセージを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージとの間で相互に変換できます。 これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントから MSMQ の受信側アプリケーションを呼び出したり、MSMQ の送信元アプリケーションから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを呼び出したりできます。  
+  
+ このセクションで使用する方法について説明<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>間キューに置かれた通信の (1) [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] System.Messaging および (2) MSMQ アプリケーション クライアントを使用して作成された MSMQ アプリケーション サービスとクライアントと[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]サービスです。  
+  
+ MSMQ 受信側のアプリケーションを呼び出す方法を説明する完全なサンプルについては、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントを参照してください、 [Windows Communication Foundation メッセージ キューが](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)サンプルです。  
+  
+ 呼び出す方法を説明する完全なサンプルについては、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] MSMQ クライアントからサービスを参照してください、[メッセージ キューが Windows Communication Foundation](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)サンプルです。  
+  
+### <a name="to-create-a-wcf-service-that-receives-messages-from-a-msmq-client"></a>MSMQ クライアントからのメッセージを受信する WCF サービスを作成するには  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのサービス コントラクトを定義するインターフェイスを、次のコード例に示すように定義します。このサービスは、MSMQ の送信元アプリケーションからキューに置かれたメッセージを受信します。  
+  
+     [!code-csharp[S_MsmqToWcf#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmqtowcf/cs/service.cs#1)]
+     [!code-vb[S_MsmqToWcf#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmqtowcf/vb/service.vb#1)]  
+  
+2.  インターフェイスを実装し、適用、 <xref:System.ServiceModel.ServiceBehaviorAttribute>クラスに属性の次のコード例に示すようにします。  
+  
+     [!code-csharp[S_MsmqToWcf#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmqtowcf/cs/service.cs#2)]
+     [!code-vb[S_MsmqToWcf#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmqtowcf/vb/service.vb#2)]  
+  
+3.  指定する構成ファイルを作成、 <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>します。  
+  
+  
+  
+4.  インスタンスを作成、 <xref:System.ServiceModel.ServiceHost>構成のバインディングを使用するオブジェクト。  
+  
+  
+  
+### <a name="to-create-a-wcf-client-that-sends-messages-to-a-msmq-receiver-application"></a>MSMQ の受信側アプリケーションにメッセージを送信する WCF クライアントを作成するには  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのサービス コントラクトを定義するインターフェイスを、次のコード例に示すように定義します。このクライアントは、キューに置かれたメッセージを MSMQ の受信側に送信します。  
+  
+     [!code-csharp[S_WcfToMsmq#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_wcftomsmq/cs/proxy.cs#6)]
+     [!code-vb[S_WcfToMsmq#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_wcftomsmq/vb/proxy.vb#6)]  
+  
+2.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが MSMQ の受信側を呼び出すために使用するクライアント クラスを定義します。  
+  
+     [!code-csharp[S_WcfToMsmq#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_wcftomsmq/cs/snippets.cs#2)]
+     [!code-vb[S_WcfToMsmq#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_wcftomsmq/vb/snippets.vb#2)]  
+  
+3.  MsmqIntegrationBinding バインディングの使用を指定する構成を作成します。  
+  
+     [!code-csharp[S_WcfToMsmq#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_wcftomsmq/cs/snippets.cs#3)]
+     [!code-vb[S_WcfToMsmq#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_wcftomsmq/vb/snippets.vb#3)]  
+  
+4.  クライアント クラスのインスタンスを作成し、メッセージ受信サービスによって定義されたメソッドを呼び出します。  
+  
+     [!code-csharp[S_WcfToMsmq#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_wcftomsmq/cs/client.cs#4)]  
+  
+## <a name="see-also"></a>関連項目  
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)   
+ [方法: キューの WCF エンドポイントとメッセージを交換](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)   
+ [Windows Communication Foundation メッセージ キュー](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)   
+ [メッセージ キュー (MSMQ) をインストールします。](../../../../docs/framework/wcf/samples/installing-message-queuing-msmq.md)   
+ [Windows Communication Foundation へのメッセージ キュー](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)   
+ [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md b/docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md
new file mode 100644
index 00000000000..eeee74c52c0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md
@@ -0,0 +1,88 @@
+---
+title: "方法 : 信頼されたセッション内のメッセージを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 87cd0e75-dd2c-44c1-8da0-7b494bbdeaea
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : 信頼されたセッション内のメッセージを変換する
+このトピックでは、信頼できるセッションを有効にするために必要な手順について説明します。ここでは、信頼できるセッションを \(既定ではなく\) オプションでサポートするシステム指定のバインディングを使用します。信頼できるセッションはコードを使用して強制的に有効にするか、構成ファイルで宣言して有効にします。この手順では、クライアントとサービスの構成ファイルを使用して、信頼できるセッションを有効にし、送信された順序でメッセージが受信されるように指定します。  
+  
+ この手順で重要なのは、エンドポイント構成要素に "Binding1" という名前のバインディング構成を参照する `bindingConfiguration` 属性が含まれていることです。[\<binding\>](../../../../docs/framework/misc/binding.md) 構成要素は、この名前を参照して、[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b) 要素の `enabled` 属性を `true` に設定することで信頼できるセッションを有効にします。信頼できるセッションで順序付き配信の保証を指定するには、`ordered` 属性を `true` に設定します。  
+  
+ この例のソースのコピーについては、「[WS 信頼できるセッション](../../../../docs/framework/wcf/samples/ws-reliable-session.md)」を参照してください。  
+  
+### 信頼できるセッションを使用するためにサービスを WSHttpBinding で構成するには  
+  
+1.  サービスの種類にサービス コントラクトを定義します。  
+  
+     [!code-csharp[c_HowTo_UseReliableSession#1121](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_usereliablesession/cs/service.cs#1121)]  
+  
+2.  サービス クラスにサービス コントラクトを実装します。アドレス情報とバインディング情報はサービスの実装内では指定されないことに注意してください。同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[c_HowTo_UseReliableSession#1122](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_usereliablesession/cs/service.cs#1122)]  
+  
+3.  Web.config ファイルを作成し、信頼できるセッションが有効で、メッセージの順序付き配信を要求する <xref:System.ServiceModel.WSHttpBinding> を使用する `CalculatorService` のエンドポイントを構成します。  
+  
+     [!code[c_HowTo_UseReliableSession#2111](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_usereliablesession/common/web.config#2111)]  
+  
+4.  次の行を含む Service.svc ファイルを作成します。  
+  
+    ```  
+    <%@ServiceHost language=c# Service="CalculatorService" %>   
+    ```  
+  
+5.  インターネット インフォメーション サービス \(IIS\) 仮想ディレクトリに Service.svc ファイルを配置します。  
+  
+### 信頼できるセッションを使用するためにクライアントを WSHttpBinding で構成するには  
+  
+1.  コマンド ラインから [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行して、サービス メタデータからコードを生成します。  
+  
+    ```  
+    Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+    ```  
+  
+2.  生成されたクライアントには、クライアントの実装時に満たされなければならないサービス コントラクトを定義する `ICalculator` インターフェイスが含まれます。  
+  
+     [!code-csharp[C_HowTo_UseReliableSession#1221](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_usereliablesession/cs/client.cs#1221)]  
+  
+3.  生成されたクライアント アプリケーションは `ClientCalculator` も実装します。このサービスの実装では、アドレス情報とバインディング情報が指定されないことに注意してください。同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[C_HowTo_UseReliableSession#1222](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_usereliablesession/cs/client.cs#1222)]  
+  
+4.  <xref:System.ServiceModel.WSHttpBinding> クラスを使用するクライアントの構成も、Svcutil.exe により生成されます。[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を使用する場合、このファイルには App.config という名前を付ける必要があります。  
+  
+     [!code[C_HowTo_UseReliableSession#2211](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_usereliablesession/common/app.config#2211)]  
+  
+5.  アプリケーションで `ClientCalculator` のインスタンスを作成し、サービス操作を呼び出します。  
+  
+     [!code-csharp[C_HowTo_UseReliableSession#1223](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_usereliablesession/cs/client.cs#1223)]  
+  
+6.  クライアントをコンパイルして実行します。  
+  
+## 使用例  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+ システム指定のバインディングの中には、信頼できるセッションを既定でサポートするものがあります。具体的には、次のようなバインディングです。  
+  
+-   <xref:System.ServiceModel.WSDualHttpBinding>  
+  
+-   <xref:System.ServiceModel.NetNamedPipeBinding>  
+  
+-   <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>  
+  
+ 信頼できるセッションをサポートするカスタム バインディングを作成する方法の例については、「[方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md)」を参照してください。  
+  
+## 参照  
+ [信頼できるセッション](../../../../docs/framework/wcf/feature-details/reliable-sessions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md b/docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md
new file mode 100644
index 00000000000..8da05f128a6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 938e7825-f63a-4c3d-b603-63772fabfdb3
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する
+キューを使用すると、通信中にサービスを使用できない場合でも、クライアントと [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス間で信頼できるメッセージングを使用できます。 以下の手順は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実装時に、標準のキューに置かれたバインディングを使用してクライアントとサービス間で永続的な通信を確保する方法を示しています。  
+  
+ このセクションを使用する方法について説明<xref:System.ServiceModel.NetMsmqBinding>間キューに置かれた通信の[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントと[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]サービスです。  
+  
+### <a name="to-use-queuing-in-a-wcf-service"></a>WCF サービスでキューを使用するには  
+  
+1.  マークされたインターフェイスを使用してサービス コントラクトを定義する、 <xref:System.ServiceModel.ServiceContractAttribute>します。 マークされたサービス コントラクトの一部であるインターフェイスの動作、 <xref:System.ServiceModel.OperationContractAttribute>方向と指定してメソッドへの応答が返されないためです。 サービス コントラクトおよびその操作の定義の例を次のコードに示します。  
+  
+     [!code-csharp[S_Msmq_Transacted#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/service.cs#1)]
+     [!code-vb[S_Msmq_Transacted#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/service.vb#1)]  
+  
+2.  サービス コントラクトがユーザー定義型を渡す場合は、その型のデータ コントラクトを定義する必要があります。 次のコードは、2 つのデータ コントラクト (`PurchaseOrder` および `PurchaseOrderLineItem`) を示します。 これらの&2; つの型は、サービスに送信されるデータを定義します  (このデータ コントラクトを定義するクラスによって多数のメソッドが定義されることに注意してください)。 これらのメソッドは、データ コントラクトの一部とは見なされません。 `DataMember` 属性で宣言されているメンバーだけがデータ コントラクトに含まれます。  
+  
+     [!code-csharp[S_Msmq_Transacted#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/service.cs#2)]
+     [!code-vb[S_Msmq_Transacted#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/service.vb#2)]  
+  
+3.  インターフェイスで定義したサービス コントラクトのメソッドをクラスに実装します。  
+  
+     [!code-csharp[S_Msmq_Transacted#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/service.cs#3)]
+     [!code-vb[S_Msmq_Transacted#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/service.vb#3)]  
+  
+     通知、 <xref:System.ServiceModel.OperationBehaviorAttribute>上に配置、`SubmitPurchaseOrder`メソッドです。 これは、トランザクション内でこの操作を呼び出す必要があること、およびメソッドが完了したときにトランザクションが自動的に完了することを指定します。  
+  
+4.  トランザクション キューを使用して作成<xref:System.Messaging>します。 代わりに、MSMQ (Microsoft Message Queuing) Microsoft 管理コンソール (MMC: Microsoft Management Console) を使用してキューを作成することもできます。 その場合は、トランザクション キューを作成してください。  
+  
+     [!code-csharp[S_Msmq_Transacted#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/hostapp.cs#4)]
+     [!code-vb[S_Msmq_Transacted#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/hostapp.vb#4)]  
+  
+5.  定義、 <xref:System.ServiceModel.Description.ServiceEndpoint>構成サービスのアドレスを指定し、標準を使用する<xref:System.ServiceModel.NetMsmqBinding>バインドします。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]使用して[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]構成を参照してください[Windows Communication Foundation アプリケーションの構成](http://msdn.microsoft.com/ja-jp/13cb368e-88d4-4c61-8eed-2af0361c6d7a)します。  
+  
+  
+  
+6.  ホストを作成、`OrderProcessing`サービスを使用して<xref:System.ServiceModel.ServiceHost>メッセージをキューから読み取ってそれを処理します。 サービス ホストを開いてサービスを使用できるようにします。 任意のキーを押してサービスを終了するようユーザーに伝えるメッセージを表示します。 `ReadLine` を呼び出して、キーが押されるまで待機してサービスを終了します。  
+  
+     [!code-csharp[S_Msmq_Transacted#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/hostapp.cs#6)]
+     [!code-vb[S_Msmq_Transacted#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/hostapp.vb#6)]  
+  
+### <a name="to-create-a-client-for-the-queued-service"></a>キューに置かれたサービスのクライアントを作成するには  
+  
+1.  次の例は、ホスト アプリケーションを実行し、Svcutil.exe ツールを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成する方法を示します。  
+  
+    ```  
+    svcutil http://localhost:8000/ServiceModelSamples/service  
+    ```  
+  
+2.  定義、 <xref:System.ServiceModel.Description.ServiceEndpoint>構成のアドレスを指定し、標準を使用する<xref:System.ServiceModel.NetMsmqBinding>の次の例に示すようにバインドします。  
+  
+  
+  
+3.  次の例に示すように、トランザクション キューに書き込むトランザクション スコープを作成し、`SubmitPurchaseOrder` 操作を呼び出して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを閉じます。  
+  
+     [!code-csharp[S_Msmq_Transacted#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/client.cs#8)]
+     [!code-vb[S_Msmq_Transacted#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/client.vb#8)]  
+  
+## <a name="example"></a>例  
+ 次の例は、この例に含まれるサービス コード、ホスト アプリケーション、App.config ファイル、およびクライアント コードを示します。  
+  
+ [!code-csharp[S_Msmq_Transacted#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/service.cs#9)]
+ [!code-vb[S_Msmq_Transacted#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/service.vb#9)]  
+  
+ [!code-csharp[S_Msmq_Transacted#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/hostapp.cs#10)]
+ [!code-vb[S_Msmq_Transacted#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/hostapp.vb#10)]  
+  
+  
+  
+ [!code-csharp[S_Msmq_Transacted#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_msmq_transacted/cs/client.cs#12)]
+ [!code-vb[S_Msmq_Transacted#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_msmq_transacted/vb/client.vb#12)]  
+  
+  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.NetMsmqBinding>   
+ [トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)   
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [方法: WCF エンドポイントでメッセージを交換して、メッセージ キュー アプリケーション](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)   
+ [Windows Communication Foundation メッセージ キュー](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)   
+ [メッセージ キュー (MSMQ) をインストールします。](../../../../docs/framework/wcf/samples/installing-message-queuing-msmq.md)   
+ [メッセージ キュー統合バインディング サンプル](http://msdn.microsoft.com/ja-jp/997d11cb-f2c5-4ba0-9209-92843d4d0e1a)   
+ [Windows Communication Foundation へのメッセージ キュー](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)   
+ [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-export-metadata-from-service-endpoints.md b/docs/framework/wcf/feature-details/how-to-export-metadata-from-service-endpoints.md
new file mode 100644
index 00000000000..205764cbb71
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-export-metadata-from-service-endpoints.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : メタデータをサービス エンドポイントからエクスポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6c4dfd0-f270-43ec-961a-e16eb6af2f2c
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : メタデータをサービス エンドポイントからエクスポートする
+このトピックでは、メタデータをサービス エンドポイントからエクスポートする方法について説明します。  
+  
+### メタデータをサービス エンドポイントからエクスポートするには  
+  
+1.  新しい Visual Studio コンソール アプリケーション プロジェクトを作成します。  以下の手順で示されているコードを、生成された Program.cs ファイルの main\(\) メソッド内に追加します。  
+  
+2.  <xref:System.ServiceModel.Description.WsdlExporter> を作成します。  
+  
+     [!code-csharp[S_UEWsdlExporter#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#1)]
+     [!code-vb[S_UEWsdlExporter#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#1)]  
+  
+3.  <xref:System.ServiceModel.Description.MetadataExporter.PolicyVersion%2A> プロパティを <xref:System.ServiceModel.Description.PolicyVersion> 列挙体のいずれかの値に設定します。  この例では、値を、WS\-Policy 1.5 に対応する <xref:System.ServiceModel.Description.PolicyVersion.Policy15%2A> に設定します。  
+  
+     [!code-csharp[S_UEWsdlExporter#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#2)]
+     [!code-vb[S_UEWsdlExporter#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#2)]  
+  
+4.  <xref:System.ServiceModel.Description.ServiceEndpoint> オブジェクトの配列を作成します。  
+  
+     [!code-csharp[S_UEWsdlExporter#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#3)]
+     [!code-vb[S_UEWsdlExporter#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#3)]  
+  
+5.  サービス エンドポイントのメタデータをエクスポートします。  
+  
+     [!code-csharp[S_UEWsdlExporter#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#4)]
+     [!code-vb[S_UEWsdlExporter#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#4)]  
+  
+6.  エクスポート プロセス中にエラーが発生していないことを確認し、メタデータを取得します。  
+  
+     [!code-csharp[S_UEWsdlExporter#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#5)]
+     [!code-vb[S_UEWsdlExporter#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#5)]  
+  
+7.  これで、メタデータを使用できます。たとえば、<xref:System.ServiceModel.Description.MetadataSet.WriteTo%28System.Xml.XmlWriter%29> メソッドを呼び出してメタデータをファイルに書き込むことができます。  
+  
+## 使用例  
+ この例の完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[S_UEWsdlExporter#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_uewsdlexporter/cs/program.cs#0)]
+ [!code-vb[S_UEWsdlExporter#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_uewsdlexporter/vb/program.vb#0)]  
+  
+## コードのコンパイル  
+ Program.cs をコンパイルするときは、System.ServiceModel.dll への参照を追加してください。  
+  
+## 参照  
+ [メタデータ アーキテクチャの概要](../../../../docs/framework/wcf/feature-details/metadata-architecture-overview.md)   
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-expose-a-contract-to-soap-and-web-clients.md b/docs/framework/wcf/feature-details/how-to-expose-a-contract-to-soap-and-web-clients.md
new file mode 100644
index 00000000000..181da6a25f3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-expose-a-contract-to-soap-and-web-clients.md
@@ -0,0 +1,113 @@
+---
+title: "方法 : コントラクトを SOAP クライアントおよび Web クライアントに公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb765a48-12f2-430d-a54d-6f0c20f2a23a
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 方法 : コントラクトを SOAP クライアントおよび Web クライアントに公開する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、既定でエンドポイントは SOAP クライアントでのみ利用できます。  SOAP 以外のクライアントでもエンドポイントを利用できるようにする方法については、「[方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md)」を参照してください。  状況によっては、同じコントラクトを Web エンドポイントと SOAP エンドポイントのどちらとしても利用できることが望ましい場合があります。  ここでは、これを実現する方法の例について示します。  
+  
+### サービス コントラクトを定義するには  
+  
+1.  次のコードのように、<xref:System.ServiceModel.ServiceContractAttribute>、<xref:System.ServiceModel.Web.WebInvokeAttribute> および <xref:System.ServiceModel.Web.WebGetAttribute> の各属性でマークされたインターフェイスを使用して、サービス コントラクトを定義します。  
+  
+     [!code-csharp[htSoapWeb#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#0)]
+     [!code-vb[htSoapWeb#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#0)]  
+  
+    > [!NOTE]
+    >  既定では、<xref:System.ServiceModel.Web.WebInvokeAttribute> は POST 呼び出しを操作にマッピングします。  ただし、"method\=" パラメーターを指定することで、操作にマッピングするメソッドを指定できます。  <xref:System.ServiceModel.Web.WebGetAttribute> には "method\=" パラメーターがないため、サービス操作には GET 呼び出しのみがマッピングされます。  
+  
+2.  次のコードに示すように、サービス コントラクトを実装します。  
+  
+     [!code-csharp[htSoapWeb#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#1)]
+     [!code-vb[htSoapWeb#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#1)]  
+  
+### サービスをホストするには  
+  
+1.  次のコードに示すように、<xref:System.ServiceModel.ServiceHost> オブジェクトを作成します。  
+  
+     [!code-csharp[htSoapWeb#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#2)]
+     [!code-vb[htSoapWeb#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#2)]  
+  
+2.  次のコードに示すように、SOAP 以外のエンドポイント用に、<xref:System.ServiceModel.Description.ServiceEndpoint> に <xref:System.ServiceModel.BasicHttpBinding> を追加します。  
+  
+     [!code-csharp[htSoapWeb#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#3)]
+     [!code-vb[htSoapWeb#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#3)]  
+  
+3.  次のコードに示すように、SOAP 以外のエンドポイント用に、<xref:System.ServiceModel.Description.ServiceEndpoint> に <xref:System.ServiceModel.WebHttpBinding> を追加し、エンドポイントに <xref:System.ServiceModel.Description.WebHttpBehavior> を追加します。  
+  
+     [!code-csharp[htSoapWeb#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#4)]
+     [!code-vb[htSoapWeb#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#4)]  
+  
+4.  次のコードに示すように、`Open()` を <xref:System.ServiceModel.ServiceHost> インスタンスで呼び出して、サービス ホストを開きます。  
+  
+     [!code-csharp[htSoapWeb#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#5)]
+     [!code-vb[htSoapWeb#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#5)]  
+  
+### Internet Explorer で GET にマッピングされたサービス操作を呼び出すには  
+  
+1.  Internet Explorer を開いて「`http://localhost:8000/Web/EchoWithGet?s=Hello, world!`」と入力し、Enter キーを押します。  この URL には、サービスのベース アドレス \("http:\/\/localhost:8000\/"\) が含まれており、エンドポイントの相対アドレス \(""\)、呼び出すサービス操作 \("EchoWithGet"\)、疑問符の後にアンパサンド \(&\) で区切られた名前付きパラメーターのリストが続きます。  
+  
+### コードから Web エンドポイントにあるサービス操作を呼び出すには  
+  
+1.  次のコードに示すように、<xref:System.ServiceModel.Web.WebChannelFactory%601> のインスタンスを `using` ブロック内に作成します。  
+  
+     [!code-csharp[htSoapWeb#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#6)]
+     [!code-vb[htSoapWeb#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#6)]  
+  
+> [!NOTE]
+>  `Close()` は `using` ブロックの末尾のチャネルで自動的に呼び出されます。  
+  
+1.  次のコードに示すように、チャネルを作成してサービスを呼び出します。  
+  
+     [!code-csharp[htSoapWeb#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#8)]
+     [!code-vb[htSoapWeb#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#8)]  
+  
+### SOAP エンドポイントにあるサービス操作を呼び出すには  
+  
+1.  次のコードに示すように、<xref:System.ServiceModel.ChannelFactory> のインスタンスを `using` ブロック内に作成します。  
+  
+     [!code-csharp[htSoapWeb#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#10)]
+     [!code-vb[htSoapWeb#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#10)]  
+  
+2.  次のコードに示すように、チャネルを作成してサービスを呼び出します。  
+  
+     [!code-csharp[htSoapWeb#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#11)]
+     [!code-vb[htSoapWeb#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#11)]  
+  
+### サービス ホストを閉じるは  
+  
+1.  次のコードに示すように、サービス ホストを閉じます。  
+  
+     [!code-csharp[htSoapWeb#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#9)]
+     [!code-vb[htSoapWeb#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#9)]  
+  
+## 使用例  
+ このトピックの完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[htSoapWeb#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/htsoapweb/cs/program.cs#13)]
+ [!code-vb[htSoapWeb#13](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htsoapweb/vb/program.vb#13)]  
+  
+## コードのコンパイル  
+ Service.cs のコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll を参照します。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>   
+ <xref:System.ServiceModel.Web.WebInvokeAttribute>   
+ <xref:System.ServiceModel.Web.WebServiceHost>   
+ <xref:System.ServiceModel.ChannelFactory>   
+ <xref:System.ServiceModel.Description.WebHttpBehavior>   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-expose-a-feed-as-both-atom-and-rss.md b/docs/framework/wcf/feature-details/how-to-expose-a-feed-as-both-atom-and-rss.md
new file mode 100644
index 00000000000..a1d7521ba25
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-expose-a-feed-as-both-atom-and-rss.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : Atom および RSS の両方としてフィードを公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe374932-67f5-487d-9325-f868812b92e4
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 方法 : Atom および RSS の両方としてフィードを公開する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、配信フィードを公開するサービスを作成できます。  このトピックでは、Atom 1.0 と RSS 2.0 の両方を使用して配信フィードを公開する配信サービスを作成する方法について説明します。  このサービスは、どちらかの配信フォーマットを返すエンドポイントを公開します。  簡略化のため、この例で使用するサービスは自己ホスト型です。  運用環境では、このタイプのサービスは IIS または WAS でホストされます。  各種の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスティング オプション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)」を参照してください。  
+  
+### 基本的な配信サービスを作成するには  
+  
+1.  <xref:System.ServiceModel.Web.WebGetAttribute> 属性でマークされたインターフェイスを使用して、サービス コントラクトを定義します。  配信フィードとして公開される各操作は、<xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> オブジェクトを返します。  <xref:System.ServiceModel.Web.WebGetAttribute> のパラメーターに注意してください。  `UriTemplate` は、このサービス操作を呼び出すために使用される URL を指定します。  このパラメーターに対する文字列には、\({*format*}\) のように、リテラルと変数を中かっこで囲んで指定します。  この変数は、サービス操作の `format` パラメーターに対応します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.UriTemplate>.  `BodyStyle` は、このサービス操作が送受信するメッセージの書き方に影響を与えます。  <xref:System.ServiceModel.Web.WebMessageBodyStyle> は、このサービス操作に送受信されるデータが、インフラストラクチャにより定義された XML 要素でラップされないことを指定します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.Web.WebMessageBodyStyle>.  
+  
+     [!code-csharp[htAtomRss#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#0)]
+     [!code-vb[htAtomRss#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#0)]  
+  
+    > [!NOTE]
+    >  このインターフェイスのサービス操作により返される型を指定するには、<xref:System.ServiceModel.ServiceKnownTypeAttribute> を使用します。  
+  
+2.  サービス コントラクトを実装します。  
+  
+     [!code-csharp[htAtomRss#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#1)]
+     [!code-vb[htAtomRss#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#1)]  
+  
+3.  <xref:System.ServiceModel.Syndication.SyndicationFeed> オブジェクトを作成し、作成者、カテゴリ、および説明を追加します。  
+  
+     [!code-csharp[htAtomRss#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#2)]
+     [!code-vb[htAtomRss#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#2)]  
+  
+4.  複数の <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトを作成します。  
+  
+     [!code-csharp[htAtomRss#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#3)]
+     [!code-vb[htAtomRss#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#3)]  
+  
+5.  <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトをフィードに追加します。  
+  
+     [!code-csharp[htAtomRss#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#4)]
+     [!code-vb[htAtomRss#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#4)]  
+  
+6.  format パラメーターを使用して、要求された形式を返します。  
+  
+     [!code-csharp[htAtomRss#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#5)]
+     [!code-vb[htAtomRss#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#5)]  
+  
+### サービスをホストするには  
+  
+1.  <xref:System.ServiceModel.Web.WebServiceHost> オブジェクトを作成します。  <xref:System.ServiceModel.Web.WebServiceHost> クラスは、エンドポイントがコードまたは構成で指定されない限り、自動的にエンドポイントをサービスのベース アドレスで追加します。  次の例は、既定のエンドポイントが公開されるので、エンドポイントは指定されません。  
+  
+     [!code-csharp[htAtomRss#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#6)]
+     [!code-vb[htAtomRss#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#6)]  
+  
+2.  サービス ホストを開き、サービスからフィードを読み込み、フィードを表示してから、ユーザーが Enter キーを押すのを待ちます。  
+  
+     [!code-csharp[htAtomRss#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#8)]
+     [!code-vb[htAtomRss#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/program.vb#8)]  
+  
+### HTTP GET を使用して GetBlog を呼び出すには  
+  
+1.  Internet Explorer を開いて、次の URL を入力し、Enter キーを押します。  http:\/\/localhost:8000\/BlogService\/GetBlog  
+  
+     この URL には、サービスのベース アドレス \(http:\/\/localhost:8000\/BlogService\)、エンドポイントの相対アドレス、および呼び出すサービス操作が含まれます。  
+  
+### コードから GetBlog\(\) を呼び出すには  
+  
+1.  ベース アドレスと呼び出すメソッドを使用して <xref:System.Xml.XmlReader> を作成します。  
+  
+     [!code-csharp[htAtomRss#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/snippets.cs#9)]
+     [!code-vb[htAtomRss#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/snippets.vb#9)]  
+  
+2.  静的な <xref:System.ServiceModel.Syndication.SyndicationFeed.Load%28System.Xml.XmlReader%29> メソッドを呼び出し、作成した <xref:System.Xml.XmlReader> を渡します。  
+  
+     [!code-csharp[htAtomRss#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/snippets.cs#10)]
+     [!code-vb[htAtomRss#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/snippets.vb#10)]  
+  
+     これにより、サービス操作が呼び出され、サービス操作から返されたフォーマッタが新しい <xref:System.ServiceModel.Syndication.SyndicationFeed> に設定されます。  
+  
+3.  フィード オブジェクトにアクセスします。  
+  
+     [!code-csharp[htAtomRss#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/snippets.cs#11)]
+     [!code-vb[htAtomRss#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htatomrss/vb/snippets.vb#11)]  
+  
+## 使用例  
+ この例の完全なコードの一覧を以下に示します。  
+  
+ [!code-csharp[htAtomRss#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/htatomrss/cs/program.cs#12)]  
+  
+## コードのコンパイル  
+ 上記のコードのコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll が参照されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-host-a-non-service-workflow-in-iis.md b/docs/framework/wcf/feature-details/how-to-host-a-non-service-workflow-in-iis.md
new file mode 100644
index 00000000000..8b530e17cc5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-host-a-non-service-workflow-in-iis.md
@@ -0,0 +1,702 @@
+---
+title: "方法 : IIS でサービス以外のワークフローをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f362562c-767d-401b-8257-916616568fd4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : IIS でサービス以外のワークフローをホストする
+ワークフロー サービスではないワークフローは IIS\/WAS でホストできます。  これは他の人が作成したワークフローをホストする必要がある場合に役に立ちます。  たとえば、ワークフロー デザイナーを再ホストして、ユーザーが独自のワークフローを作成できるようにする場合がその例です。  IIS でサービス以外のワークフローをホストすると、プロセス リサイクル、アイドル シャットダウン、処理状況の監視、メッセージ ベースのアクティブ化などの機能をサポートできます。  IIS でホストされるワークフロー サービスには <xref:System.ServiceModel.Activities.Receive> アクティビティが含まれ、IIS がメッセージを受け取るとアクティブ化されます。  サービス以外のワークフローにはメッセージング アクティビティは含まれないので、既定ではメッセージを送信することによってアクティブ化できません。  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> からクラスを派生させ、そのワークフローのインスタンスを作成する操作を含むサービス コントラクトを定義する必要があります。  このトピックでは、単純なワークフローを作成して、クライアントがワークフローのアクティブ化に使用できるサービス コントラクトを定義し、そのサービス コントラクトを使ってワークフロー作成のリクエストをリッスンする <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> からクラスを派生させる方法を説明します。  
+  
+### 単純なワークフローの作成  
+  
+1.  `CreationEndpointTest` という名前で、新しい空の [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ソリューションを作成します。  
+  
+2.  `SimpleWorkflow` という新しい WCF ワークフロー サービス アプリケーション プロジェクトをソリューションに追加します。  ワークフロー デザイナーが開きます。  
+  
+3.  ReceiveRequest アクティビティと SendResponse アクティビティを削除します。  ワークフローはこれらのアクティビティによってワークフロー サービスになります。  ここではワークフロー サービスを使用しないので、これらのアクティビティは必要ありません。  
+  
+4.  シーケンス アクティビティの DisplayName を "Sequential Workflow" に設定します。  
+  
+5.  Service1.xamlx を Workflow1.xamlx という名前に変更します。  
+  
+6.  シーケンス アクティビティの外でデザイナーをクリックして、Name プロパティと ConfigurationName プロパティを "Workflow1" に設定します。  
+  
+7.  <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.Activities.Statements.Sequence> にドラッグします。  <xref:System.Activities.Statements.WriteLine> アクティビティはツールボックスの **\[プリミティブ\]** セクションにあります。  <xref:System.Activities.Statements.WriteLine> アクティビティの <xref:System.Activities.Statements.WriteLine.Text%2A> プロパティを "Hello, world" に設定します。  
+  
+     この時点で、ワークフローは次の図のようになります。  
+  
+     ![単純なワークフロー](../../../../docs/framework/wcf/feature-details/media/simpleworkflow.png "SimpleWorkflow")  
+  
+### ワークフロー作成サービス コントラクトの作成  
+  
+1.  `CreationEndpointTest` に `Shared` という新しいクラス ライブラリ プロジェクトを追加します。  
+  
+2.  System.ServiceModel.dll、System.Configuration、および System.ServiceModel.Activities への参照を `Shared` プロジェクトに追加します。  
+  
+3.  Class1.cs ファイルの名前を IWorkflowCreation.cs に変更し、次のコードをそのファイルに追加します。  
+  
+    ```  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Linq;  
+    using System.Text;  
+    using System.ServiceModel;  
+  
+    namespace Shared  
+    {  
+        //service contract exposed from the endpoint  
+        [ServiceContract(Name = "IWorkflowCreation")]  
+        public interface IWorkflowCreation  
+        {  
+            [OperationContract(Name = "Create")]  
+            Guid Create(IDictionary<string, object> inputs);  
+  
+            [OperationContract(Name = "CreateWithInstanceId", IsOneWay = true)]  
+            void CreateWithInstanceId(IDictionary<string, object> inputs, Guid instanceId);  
+        }  
+    }  
+    ```  
+  
+     このコントラクトは 2 つの操作を定義します。どちらも作成したサービス以外のワークフローの新しいインスタンスを作成します。  1 つは生成されたインスタンス ID を持つ新しいインスタンスを作成し、もう 1 つは新しいワークフロー インスタンスのインスタンス ID を指定できるようにします。  どちらの方法でも、新しいワークフロー インスタンスにパラメーターを渡すことができます。  このコントラクトは <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> によって公開され、クライアントがサービス以外のワークフローの新しいインスタンスを作成できるようにします。  
+  
+### WorkflowHostingEndpoint からのクラスの派生  
+  
+1.  `CreationEndpoint` という <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> から派生された新しいクラスを `Shared` プロジェクトに追加します。  
+  
+    ```  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Diagnostics;  
+    using System.Globalization;  
+    using System.ServiceModel;  
+    using System.ServiceModel.Activities;  
+    using System.ServiceModel.Channels;  
+  
+    namespace Shared  
+    {  
+        public class CreationEndpoint : WorkflowHostingEndpoint  
+        {  
+        }  
+    }  
+    ```  
+  
+2.  `defaultBaseUri` というローカルの静的 <xref:System.Uri> 変数を `CreationEndpoint` クラスに追加します。  
+  
+    ```  
+    public class CreationEndpoint : WorkflowHostingEndpoint  
+    {  
+        static Uri defaultBaseUri;  
+    }  
+    ```  
+  
+3.  `CreationEndpoint` クラスに次のコンストラクターを追加します。  基本コンストラクターへの呼び出しに `IWorkflowCreation` サービス コントラクトを指定することに注意してください。  
+  
+    ```  
+    public CreationEndpoint(Binding binding, EndpointAddress address)  
+       : base(typeof(IWorkflowCreation), binding, address)  
+       {  
+       }  
+    ```  
+  
+4.  `CreationEndpoint` クラスに次の既定のコンストラクターを追加します。  
+  
+    ```  
+    public CreationEndpoint()  
+       : this(GetDefaultBinding(),  
+       new EndpointAddress(new Uri(DefaultBaseUri, new Uri(Guid.NewGuid().ToString(), UriKind.Relative))))  
+       {  
+       }  
+    ```  
+  
+5.  `DefaultBaseUri` という静的プロパティを `CreationEndpoint` クラスに追加します。  このプロパティは既定のベース URI の保持に使用されます \(指定されない場合\)。  
+  
+    ```  
+    static Uri DefaultBaseUri  
+    {  
+       get  
+       {  
+          if (defaultBaseUri == null)  
+          {  
+             defaultBaseUri = new Uri(string.Format(CultureInfo.InvariantCulture, "net.pipe://localhost/workflowCreationEndpoint/{0}/{1}",  
+                Process.GetCurrentProcess().Id,  
+                AppDomain.CurrentDomain.Id));  
+          }  
+          return defaultBaseUri;  
+       }  
+     }  
+    ```  
+  
+6.  作成エンドポイントに使用する既定のバインディングを取得するための次のメソッドを作成します。  
+  
+    ```  
+    //defaults to NetNamedPipeBinding  
+    public static Binding GetDefaultBinding()  
+    {  
+       return new NetNamedPipeBinding(NetNamedPipeSecurityMode.None) { TransactionFlow = true };  
+    }  
+    ```  
+  
+7.  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetInstanceId%2A> メソッドをオーバーライドしてワークフロー インスタンス ID を返します。  `Action` ヘッダーが "Create" で終わる場合は空の GUID を返し、`Action` ヘッダーが "CreateWithInstanceId" で終わる場合はメソッドに渡す GUID を返します。  それ以外の場合は、<xref:System.InvalidOperationException> がスローされます。  これらの `Action` ヘッダーは `IWorkflowCreation` サービス コントラクトで定義した 2 つの操作に対応しています。  
+  
+    ```  
+    protected override Guid OnGetInstanceId(object[] inputs, OperationContext operationContext)  
+    {  
+       //Create was called by client  
+       if (operationContext.IncomingMessageHeaders.Action.EndsWith("Create"))  
+       {  
+          return Guid.Empty;  
+       }  
+       //CreateWithInstanceId was called by client  
+       else if (operationContext.IncomingMessageHeaders.Action.EndsWith("CreateWithInstanceId"))  
+       {  
+          return (Guid)inputs[1];  
+       }  
+       else  
+       {  
+          throw new InvalidOperationException("Invalid Action: " + operationContext.IncomingMessageHeaders.Action);  
+       }  
+    }  
+    ```  
+  
+8.  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetCreationContext%2A> メソッドをオーバーライドして <xref:System.ServiceModel.Activities.WorkflowCreationContext> を作成し、ワークフローに引数があれば追加し、クライアントにインスタンス ID を送信して、<xref:System.ServiceModel.Activities.WorkflowCreationContext> を返します。  
+  
+    ```  
+    protected override WorkflowCreationContext OnGetCreationContext(object[] inputs, OperationContext operationContext, Guid instanceId, WorkflowHostingResponseContext responseContext)  
+    {  
+       WorkflowCreationContext creationContext = new WorkflowCreationContext();  
+       if (operationContext.IncomingMessageHeaders.Action.EndsWith("Create") || (operationContext.IncomingMessageHeaders.Action.EndsWith("CreateWithInstanceId")))  
+       {  
+          Dictionary<string, object> arguments = (Dictionary<string, object>)inputs[0];  
+          if (arguments != null && arguments.Count > 0)  
+          {  
+             foreach (KeyValuePair<string, object> pair in arguments)  
+             {  
+                //arguments to pass to the workflow  
+                creationContext.WorkflowArguments.Add(pair.Key, pair.Value);  
+             }  
+          }  
+          //reply to client with instanceId  
+          responseContext.SendResponse(instanceId, null);  
+       }  
+       else  
+       {  
+          throw new InvalidOperationException("Invalid Action: " + operationContext.IncomingMessageHeaders.Action);  
+       }  
+       return creationContext;  
+    }  
+    ```  
+  
+### WorkflowCreationEndpoint の構成を可能にする標準エンドポイント要素の作成  
+  
+1.  `CreationEndpoint` プロジェクトの Shared への参照を追加します。  
+  
+2.  `CreationEndpointElement` という <xref:System.ServiceModel.Configuration.StandardEndpointElement> から派生された新しいクラスを `CreationEndpoint` プロジェクトに追加します。  このクラスは web.config ファイル内の `CreationEndpoint` を表します。  
+  
+    ```  
+    using System;  
+    using System.Configuration;  
+    using System.ServiceModel.Activities;  
+    using System.ServiceModel.Configuration;  
+    using System.ServiceModel.Description;  
+    using Shared;  
+  
+    namespace CreationEndpointTest  
+    {  
+        //config element for CreationEndpoint  
+        public class CreationEndpointElement : StandardEndpointElement  
+        {  
+       }  
+    ```  
+  
+3.  エンドポイントの型を返すために `EndpointType` というプロパティを追加します。  
+  
+    ```  
+    protected override Type EndpointType  
+    {  
+       get { return typeof(CreationEndpoint); }  
+    }  
+    ```  
+  
+4.  <xref:System.ServiceModel.Configuration.StandardEndpointElement.CreateServiceEndpoint%2A> メソッドをオーバーライドし、`CreationEndpoint` を返します。  
+  
+    ```  
+    protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contractDescription)  
+    {  
+       return new CreationEndpoint();  
+    }  
+  
+    ```  
+  
+5.  <xref:System.ServiceModel.Configuration.StandardEndpointElement.OnApplyConfiguration%2A>、<xref:System.ServiceModel.Configuration.StandardEndpointElement.OnApplyConfiguration%2A>、<xref:System.ServiceModel.Configuration.StandardEndpointElement.OnInitializeAndValidate%2A>、および <xref:System.ServiceModel.Configuration.StandardEndpointElement.OnInitializeAndValidate%2A> の各メソッドをオーバーロードします。  これらのメソッドは定義する必要があるだけで、コードを追加する必要はありません。  
+  
+    ```  
+    protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)  
+    {  
+    }  
+  
+    protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)  
+    {  
+    }  
+  
+    protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)  
+    {  
+    }  
+  
+    protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)  
+    {  
+    }  
+    ```  
+  
+6.  `CreationEndpoint` のコレクション クラスを `CreationEndpoint` プロジェクト内の CreationEndpointElement.cs ファイルに追加します。  このクラスは構成によって使用され、web.config ファイル内に `CreationEndpoint` のインスタンス数を格納します。  
+  
+    ```  
+    public class CreationEndpointCollection : StandardEndpointCollectionElement<CreationEndpoint, CreationEndpointElement>  
+    {  
+    }  
+    ```  
+  
+7.  ソリューションをビルドします。  
+  
+### IIS でのワークフローのホスト  
+  
+1.  IIS 内に `MyCreationEndpoint` という新しいアプリケーションを作成します。  
+  
+2.  ワークフロー デザイナーによって生成された workflow1.xaml というファイルをアプリケーション ディレクトリにコピーして、その名前を workflow1.xamlx に変更します。  
+  
+3.  shared.dll と CreationEndpoint.dll というファイルをアプリケーションの bin ディレクトリにコピーします \(bin ディレクトリは存在しなければ作成します\)。  
+  
+4.  `CreationEndpoint` プロジェクト内の Web.config ファイルの内容を次のコードで置き換えます。  
+  
+    ```xaml  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.web>  
+        <compilation debug="true" targetFramework="4.0" />  
+      </system.web>   
+    </configuration>  
+    ```  
+  
+5.  `<system.web>` 要素の後に、次の構成コードを追加して、`CreationEndpoint` を登録します。  
+  
+    ```  
+    <system.serviceModel>  
+        <!--register CreationEndpoint-->  
+        <serviceHostingEnvironment multipleSiteBindingsEnabled="true" />  
+        <extensions>  
+          <endpointExtensions>  
+            <add name="creationEndpoint" type="CreationEndpointTest.CreationEndpointCollection, CreationEndpoint, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+          </endpointExtensions>  
+        </extensions>  
+    </system.serviceModel>  
+  
+    ```  
+  
+     これによって、`CreationEndpointCollection` クラスが登録され、web.config ファイル内で `CreationEndpoint` を構成できるようになります。  
+  
+6.  受信メッセージをリッスンする `CreationEndpoint` と共に `<service>` 要素を \<\/extensions\> タグの後に追加します。  
+  
+    ```  
+    <services>  
+          <!-- add endpoint to service-->  
+          <service name="Workflow1" behaviorConfiguration="basicConfig" >  
+            <endpoint kind="creationEndpoint" binding="basicHttpBinding" address=""/>  
+          </service>  
+        </services>  
+  
+    ```  
+  
+7.  サービス メタデータを有効にするために、\<behaviors\> 要素を \<\/services\> タグの後に追加します。  
+  
+    ```xml  
+    <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="basicConfig">  
+              <serviceMetadata httpGetEnabled="true" />  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+  
+    ```  
+  
+8.  web.config ファイルを IIS アプリケーション ディレクトリにコピーします。  
+  
+9. 作成エンドポイントが機能しているかどうかをテストするために、Internet Explorer を起動して http:\/\/localhost\/MyCreationEndpoint\/Workflow1.xamlx を表示します。  Internet Explorer には次のような画面が表示されます。  
+  
+     ![サービスのテスト](../../../../docs/framework/wcf/feature-details/media/testservice.gif "TestService")  
+  
+### CreationEndpoint を呼び出すクライアントの作成  
+  
+1.  新しいコンソール アプリケーションを `CreationEndpointTest` ソリューションに追加します。  
+  
+2.  System.ServiceModel.dll、System.ServiceModel.Activities、および `Shared` プロジェクトへの参照を追加します。  
+  
+3.  `Main` メソッド内に `IWorkflowCreation` 型の <xref:System.ServiceModel.ChannelFactory%601> を作成して、<xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A> を呼び出します。  これはプロキシを返します。  次に、そのプロキシの `Create` を呼び出して、IIS でホストされるワークフロー インスタンスを作成します。  
+  
+    ```  
+    using System.Text;  
+    using Shared;  
+    using System.ServiceModel;  
+  
+    namespace CreationEndpointClient  
+    {  
+        class Program  
+        {  
+            static void Main(string[] args)  
+            {  
+                try  
+                {  
+                    //client using BasicHttpBinding  
+                    IWorkflowCreation client = new ChannelFactory<IWorkflowCreation>(new BasicHttpBinding(), new EndpointAddress("http://localhost/CreationEndpoint/Workflow1.xamlx")).CreateChannel();  
+  
+                    Console.WriteLine("Workflow Instance created using CreationEndpoint added in config. Instance Id: {0}", client.Create(null));  
+                    Console.WriteLine("Press return to exit ...");  
+                    Console.ReadLine();  
+                }  
+                catch (Exception ex)  
+                {  
+                    Console.WriteLine(ex);  
+                    Console.ReadLine();  
+                }  
+            }  
+        }  
+    }  
+    ```  
+  
+4.  CreationEndpointClient を実行します。  出力の内容は次のようになります。  
+  
+    ```Output  
+  
+                "Workflow Instance created using CreationEndpoint added in config.  Instance Id: 0875dac0-2b8b-473e-b3cc-abcb235e9693  
+    Press return to exit ...    
+    ```  
+  
+    > [!NOTE]
+    >  ワークフローの出力は表示されません。これはコンソール出力を持たない IIS を使って実行しているためです。  
+  
+## 使用例  
+ 以下はこのサンプルの完全なコードです。  
+  
+```xaml  
+<!-— workflow1.xamlx -->  
+<WorkflowService mc:Ignorable="sap"   
+                 ConfigurationName="Workflow1"   
+                 sap:VirtualizedContainerService.HintSize="263,230"   
+                 Name="Workflow1"   
+                 mva:VisualBasic.Settings="Assembly references and imported namespaces serialized as XML namespaces"   
+                 xmlns="http://schemas.microsoft.com/netfx/2009/xaml/servicemodel"   
+                 xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"   
+                 xmlns:mv="clr-namespace:Microsoft.VisualBasic;assembly=System"   
+                 xmlns:mva="clr-namespace:Microsoft.VisualBasic.Activities;assembly=System.Activities"   
+                 xmlns:p="http://schemas.microsoft.com/netfx/2009/xaml/activities"   
+                 xmlns:s="clr-namespace:System;assembly=mscorlib"   
+                 xmlns:s1="clr-namespace:System;assembly=System"   
+                 xmlns:s2="clr-namespace:System;assembly=System.Xml"   
+                 xmlns:s3="clr-namespace:System;assembly=System.Core"   
+                 xmlns:sad="clr-namespace:System.Activities.Debugger;assembly=System.Activities"   
+                 xmlns:sap="http://schemas.microsoft.com/netfx/2009/xaml/activities/presentation"   
+                 xmlns:scg="clr-namespace:System.Collections.Generic;assembly=System"   
+                 xmlns:scg1="clr-namespace:System.Collections.Generic;assembly=System.ServiceModel"   
+                 xmlns:scg2="clr-namespace:System.Collections.Generic;assembly=System.Core"   
+                 xmlns:scg3="clr-namespace:System.Collections.Generic;assembly=mscorlib"   
+                 xmlns:sd="clr-namespace:System.Data;assembly=System.Data"   
+                 xmlns:sl="clr-namespace:System.Linq;assembly=System.Core"   
+                 xmlns:st="clr-namespace:System.Text;assembly=mscorlib"   
+                 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <p:Sequence DisplayName="Sequential Service"   
+              sad:XamlDebuggerXmlReader.FileName="c:\projects\CreationEndpointTest\CreationEndpoint\Service1.xamlx"   
+              sap:VirtualizedContainerService.HintSize="233,200"   
+              mva:VisualBasic.Settings="Assembly references and imported namespaces serialized as XML namespaces">  
+    <p:Sequence.Variables>  
+      <p:Variable x:TypeArguments="CorrelationHandle" Name="handle" />  
+      <p:Variable x:TypeArguments="x:Int32" Name="data" />  
+    </p:Sequence.Variables>  
+    <sap:WorkflowViewStateService.ViewState>  
+      <scg3:Dictionary x:TypeArguments="x:String, x:Object">  
+        <x:Boolean x:Key="IsExpanded">True</x:Boolean>  
+      </scg3:Dictionary>  
+    </sap:WorkflowViewStateService.ViewState>  
+    <p:WriteLine sap:VirtualizedContainerService.HintSize="211,61" Text="Hello, world" />  
+  </p:Sequence>  
+</WorkflowService>  
+  
+```  
+  
+```csharp  
+// CreationEndpointElement.cs  
+using System;  
+using System.Configuration;  
+using System.ServiceModel.Activities;  
+using System.ServiceModel.Configuration;  
+using System.ServiceModel.Description;  
+using Shared;  
+  
+namespace CreationEndpointTest  
+{  
+    //config element for CreationEndpoint  
+    public class CreationEndpointElement : StandardEndpointElement  
+    {  
+        protected override Type EndpointType  
+        {  
+            get { return typeof(CreationEndpoint); }  
+        }  
+  
+        protected override ConfigurationPropertyCollection Properties  
+        {  
+            get  
+            {  
+                ConfigurationPropertyCollection properties = base.Properties;  
+                properties.Add(new ConfigurationProperty("name", typeof(String), null, ConfigurationPropertyOptions.IsRequired));  
+                return properties;  
+            }  
+        }  
+  
+        protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contractDescription)  
+        {  
+            return new CreationEndpoint();  
+        }  
+  
+        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)  
+        {  
+        }  
+  
+        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)  
+        {  
+        }  
+  
+        protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)  
+        {  
+        }  
+  
+        protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)  
+        {  
+        }  
+    }  
+  
+    public class CreationEndpointCollection : StandardEndpointCollectionElement<CreationEndpoint, CreationEndpointElement>  
+    {  
+    }  
+}  
+  
+```  
+  
+```xml  
+<!-- web.config -->  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.web>  
+    <compilation debug="true" targetFramework="4.0" />  
+  </system.web>  
+  <system.serviceModel>  
+    <!--register CreationEndpoint-->  
+    <serviceHostingEnvironment multipleSiteBindingsEnabled="true" />  
+    <extensions>  
+      <endpointExtensions>  
+        <add name="creationEndpoint" type="CreationEndpointTest.CreationEndpointCollection, Shared, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+      </endpointExtensions>  
+    </extensions>  
+    <services>  
+      <!-- add endpoint to service-->  
+      <service name="Workflow1" behaviorConfiguration="basicConfig" >  
+        <endpoint kind="creationEndpoint" binding="basicHttpBinding" address=""/>  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="basicConfig">  
+          <serviceMetadata httpGetEnabled="true" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+```csharp  
+// IWorkflowCreation.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.ServiceModel;  
+  
+namespace Shared  
+{  
+    //service contract exposed from the endpoint  
+    [ServiceContract(Name = "IWorkflowCreation")]  
+    public interface IWorkflowCreation  
+    {  
+        [OperationContract(Name = "Create")]  
+        Guid Create(IDictionary<string, object> inputs);  
+  
+        [OperationContract(Name = "CreateWithInstanceId", IsOneWay = true)]  
+        void CreateWithInstanceId(IDictionary<string, object> inputs, Guid instanceId);  
+    }  
+}  
+  
+```  
+  
+```csharp  
+// CreationEndpoint.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.ServiceModel.Activities;  
+using System.ServiceModel.Channels;  
+using System.ServiceModel;  
+using System.Globalization;  
+using System.Diagnostics;  
+  
+namespace Shared  
+{  
+    public class CreationEndpoint : WorkflowHostingEndpoint  
+    {  
+        static Uri defaultBaseUri;  
+  
+        public CreationEndpoint(Binding binding, EndpointAddress address)  
+            : base(typeof(IWorkflowCreation), binding, address) { }  
+  
+        public CreationEndpoint()  
+            : this(GetDefaultBinding(),  
+                new EndpointAddress(new Uri(DefaultBaseUri, new Uri(Guid.NewGuid().ToString(), UriKind.Relative)))) { }  
+  
+        static Uri DefaultBaseUri  
+        {  
+            get  
+            {  
+                if (defaultBaseUri == null)  
+                {  
+                    defaultBaseUri = new Uri(string.Format(CultureInfo.InvariantCulture, "net.pipe://localhost/workflowCreationEndpoint/{0}/{1}",  
+                        Process.GetCurrentProcess().Id,  
+                        AppDomain.CurrentDomain.Id));  
+                }  
+                return defaultBaseUri;  
+            }  
+        }  
+  
+        //defaults to NetNamedPipeBinding  
+        public static Binding GetDefaultBinding()  
+        {  
+            return new NetNamedPipeBinding(NetNamedPipeSecurityMode.None) { TransactionFlow = true };  
+        }  
+  
+        protected override Guid OnGetInstanceId(object[] inputs, OperationContext operationContext)  
+        {  
+            //Create was called by client  
+            if (operationContext.IncomingMessageHeaders.Action.EndsWith("Create"))  
+            {  
+                return Guid.Empty;  
+            }  
+  
+            //CreateWithInstanceId was called by client  
+            else if (operationContext.IncomingMessageHeaders.Action.EndsWith("CreateWithInstanceId"))  
+            {  
+                return (Guid)inputs[1];  
+            }  
+            else  
+            {  
+                throw new InvalidOperationException("Invalid Action: " + operationContext.IncomingMessageHeaders.Action);  
+            }  
+        }  
+  
+        protected override WorkflowCreationContext OnGetCreationContext(object[] inputs, OperationContext operationContext, Guid instanceId, WorkflowHostingResponseContext responseContext)  
+        {  
+            WorkflowCreationContext creationContext = new WorkflowCreationContext();  
+            if (operationContext.IncomingMessageHeaders.Action.EndsWith("Create"))  
+            {  
+                Dictionary<string, object> arguments = (Dictionary<string, object>)inputs[0];  
+                if (arguments != null && arguments.Count > 0)  
+                {  
+                    foreach (KeyValuePair<string, object> pair in arguments)  
+                    {  
+                        //arguments to pass to the workflow  
+                        creationContext.WorkflowArguments.Add(pair.Key, pair.Value);  
+                    }  
+                }  
+                //reply to client with instanceId  
+                responseContext.SendResponse(instanceId, null);  
+            }  
+            else if (operationContext.IncomingMessageHeaders.Action.EndsWith("CreateWithInstanceId"))  
+            {  
+                Dictionary<string, object> arguments = (Dictionary<string, object>)inputs[0];  
+                if (arguments != null && arguments.Count > 0)  
+                {  
+                    foreach (KeyValuePair<string, object> pair in arguments)  
+                    {  
+                        //arguments to pass to workflow  
+                        creationContext.WorkflowArguments.Add(pair.Key, pair.Value);  
+                    }  
+                }  
+            }  
+            else  
+            {  
+                throw new InvalidOperationException("Invalid Action: " + operationContext.IncomingMessageHeaders.Action);  
+            }  
+            return creationContext;  
+        }  
+    }  
+}  
+  
+```  
+  
+```csharp  
+// CreationEndpointClient.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using Shared;  
+using System.ServiceModel;  
+  
+namespace CreationClient  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            try  
+            {  
+                //client using BasicHttpBinding  
+                IWorkflowCreation client = new ChannelFactory<IWorkflowCreation>(new BasicHttpBinding(), new EndpointAddress("http://localhost/MyCreationEndpoint/Workflow1.xamlx")).CreateChannel();  
+  
+                Console.WriteLine("Workflow Instance created using CreationEndpoint added in config. Instance Id: {0}", client.Create(null));  
+                Console.WriteLine("Press return to exit ...");  
+                Console.ReadLine();  
+            }  
+            catch (Exception ex)  
+            {  
+                Console.WriteLine(ex);  
+                Console.ReadLine();  
+            }  
+  
+        }  
+    }  
+  
+}  
+  
+```  
+  
+ この例では `IWorkflowCreation` を実装するサービスを実装しないので、わかりにくい可能性があります。  これは、`CreationEndpoint` がユーザーに代わって実装するためです。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [インターネット インフォメーション サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)   
+ [インターネット インフォメーション サービス ホスティングのベスト プラクティス](../../../../docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md)   
+ [インターネット インフォメーション サービスのホスティング手順](../../../../docs/framework/wcf/samples/internet-information-service-hosting-instructions.md)   
+ [Windows Workflow のアーキテクチャ](../../../../docs/framework/windows-workflow-foundation//architecture.md)   
+ [WorkflowHostingEndpoint 再開ブックマーク](../../../../docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md)   
+ [ワークフロー デザイナーのホスト変更](../../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)   
+ [Windows Workflow の概要](../../../../docs/framework/windows-workflow-foundation//overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md
new file mode 100644
index 00000000000..bf699311ef6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md
@@ -0,0 +1,145 @@
+---
+title: "方法 : マネージ Windows サービスで WCF サービスをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8e37363b-4dad-4fb6-907f-73c30fac1d9a
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 方法 : マネージ Windows サービスで WCF サービスをホストする
+ここでは、Windows サービスでホストされる [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを作成するために必要な基本手順について説明します。このシナリオは、マネージ Windows サービスのホスト オプションによって有効になります。このサービスは、メッセージがアクティブ化されていない、セキュリティ保護された環境において、インターネット インフォメーション サービス \(IIS\) の外部でホストされ、長時間実行される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。サービスの有効期限は代わりにオペレーティング システムによって制御されます。このホスト オプションは Windows のすべてのバージョンで使用できます。  
+  
+ Windows サービスは、Microsoft 管理コンソール \(MMC\) の Microsoft.ManagementConsole.SnapIn を使用して管理し、システムのブート時に自動的に起動するように構成できます。このホスト オプションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをマネージ Windows サービスとしてホストするアプリケーション ドメイン \(AppDomain\) の登録から構成されているため、サービスのプロセス有効期間は Windows サービスのサービス コントロール マネージャー \(SCM\) によって制御されます。  
+  
+ サービス コードには、サービス コントラクトのサービス実装、Windows サービス クラス、およびインストーラー クラスが含まれています。サービス実装クラスである `CalculatorService` は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。一方、`CalculatorWindowsService` は Windows サービスです。Windows サービスとして限定するため、このクラスは `ServiceBase` を継承し、`OnStart` メソッドと `OnStop` メソッドを実装しています。`OnStart` では、`CalculatorService` 型の <xref:System.ServiceModel.ServiceHost> が作成され、開かれます。`OnStop` では、このサービスが停止され、破棄されます。ホストはベース アドレスをサービス ホストに提供する必要もあります。サービス ホストは、アプリケーション設定で構成されます。インストーラー クラスは <xref:System.Configuration.Install.Installer> を継承します。このクラスを使用すると、Installutil.exe ツールにより、プログラムを Windows サービスとしてインストールできます。  
+  
+### サービスを構築してホスティング コードを提供する  
+  
+1.  "Service" という新しい Visual Studio Console Application プロジェクトを作成します。  
+  
+2.  Program.cs を Service.cs に変更します。  
+  
+3.  名前空間を Microsoft.ServiceModel.Samples に変更します。  
+  
+4.  次のアセンブリへの参照を追加します。  
+  
+    -   System.ServiceModel.dll  
+  
+    -   System.ServiceProcess.dll  
+  
+    -   System.Configuration.Install.dll  
+  
+5.  次の using ステートメントを Service.cs に追加します。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#0)]
+     [!code-vb[c_HowTo_HostInNTService#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#0)]  
+  
+6.  次のコードに示すように、`ICalculator` サービス コントラクトを定義します。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#1)]
+     [!code-vb[c_HowTo_HostInNTService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#1)]  
+  
+7.  次のコードに示すように、`CalculatorService` というクラスにサービス コントラクトを実装します。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#2)]
+     [!code-vb[c_HowTo_HostInNTService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#2)]  
+  
+8.  <xref:System.ServiceProcess.ServiceBase> クラスから継承する `CalculatorWindowsService` という新しいクラスを作成します。`serviceHost` というローカル変数を追加して、<xref:System.ServiceModel.ServiceHost> インスタンスを参照します。`ServiceBase.Run(new CalculatorWindowsService)` を呼び出す `Main` というメソッドを定義します。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#3)]
+     [!code-vb[c_HowTo_HostInNTService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#3)]  
+  
+9. 次のコードに示すように、新しい <xref:System.ServiceModel.ServiceHost> インスタンスを作成して開くことによって [OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> メソッドをオーバーライドします。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#4)]
+     [!code-vb[c_HowTo_HostInNTService#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#4)]  
+  
+10. 次のコードに示すように、<xref:System.ServiceModel.ServiceHost> を閉じて <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドをオーバーライドします。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#5)]
+     [!code-vb[c_HowTo_HostInNTService#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#5)]  
+  
+11. <xref:System.Configuration.Install.Installer> から継承し、`true` に設定された <xref:System.ComponentModel.RunInstallerAttribute> でマークされた `ProjectInstaller` という新しいクラスを作成します。これで、Installutil.exe ツールで Windows サービスをインストールできるようになります。  
+  
+     [!code-csharp[c_HowTo_HostInNTService#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#6)]
+     [!code-vb[c_HowTo_HostInNTService#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#6)]  
+  
+12. プロジェクトを作成したときに生成された `Service` クラスを削除します。  
+  
+13. アプリケーション構成ファイルをプロジェクトに追加します。ファイルの内容を次の構成 XML に置き換えます。  
+  
+    ```xml  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.serviceModel>    <services>  
+          <!-- This section is optional with the new configuration model  
+               introduced in .NET Framework 4. -->  
+          <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+                   behaviorConfiguration="CalculatorServiceBehavior">  
+            <host>  
+              <baseAddresses>  
+                <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+              </baseAddresses>  
+            </host>  
+            <!-- this endpoint is exposed at the base address provided by host: http://localhost:8000/ServiceModelSamples/service  -->  
+            <endpoint address=""  
+                      binding="wsHttpBinding"  
+                      contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+            <!-- the mex endpoint is exposed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+            <endpoint address="mex"  
+                      binding="mexHttpBinding"  
+                      contract="IMetadataExchange" />  
+          </service>  
+        </services>  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="CalculatorServiceBehavior">  
+              <serviceMetadata httpGetEnabled="true"/>  
+              <serviceDebug includeExceptionDetailInFaults="False"/>  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     **ソリューション エクスプローラー**で App.config ファイルを右クリックし、**\[プロパティ\]** をクリックします。**\[出力ディレクトリにコピー\]** の下で **\[新しい場合はコピーする\]** を選択します。  
+  
+     この例では、構成ファイルにエンドポイントを明示的に指定します。エンドポイントをサービスに追加しない場合、ランタイムによって既定のエンドポイントが追加されます。この例では、サービスには `true` に設定された <xref:System.ServiceModel.Description.ServiceMetadataBehavior> があるので、サービスで公開メタデータも有効化されています。既定のエンドポイント、バインディング、および動作[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+### サービスをインストールして実行する  
+  
+1.  ソリューションをビルドして `Service.exe` 実行可能ファイルを作成します。  
+  
+2.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、プロジェクト ディレクトリに移動します。コマンド プロンプトで「`installutil bin\service.exe`」と入力して、Windows サービスをインストールします。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを使用しない場合、`%WinDir%\Microsoft.NET\Framework\v4.0.<current version>` ディレクトリがシステム パスにあることを確認してください。  
+  
+     コマンド プロンプトで「`services.msc`」と入力してサービス コントロール マネージャー \(SCM\) にアクセスします。Windows サービスは、\[Services\] に "WCFWindowsServiceSample" として表示されます。Windows サービスが実行されている場合、クライアントに応答できるサービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのみです。サービスを開始するには、SCM でそのサービスを右クリックして \[Start\] をクリックするか、コマンド プロンプトで「**net start WCFWindowsServiceSample**」と入力します。  
+  
+3.  サービスを変更する場合は、まずそのサービスを停止してからアンインストールする必要があります。サービスを停止するには、SCM でそのサービスを右クリックして \[Stop\] をクリックするか、コマンド プロンプトで「**type net stop WCFWindowsServiceSample**」と入力します。Windows サービスを停止してクライアントを実行すると、クライアントがこのサービスにアクセスしようとしたときに <xref:System.ServiceModel.EndpointNotFoundException> 例外が発生することに注意してください。Windows サービスをアンインストールするには、コマンド プロンプトで「**installutil \/u bin\\service.exe**」と入力します。  
+  
+## 使用例  
+ このトピックで使用されているコードの完全な一覧を次に示します。  
+  
+ [!code-csharp[c_HowTo_HostInNTService#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinntservice/cs/service.cs#8)]
+ [!code-vb[c_HowTo_HostInNTService#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostinntservice/vb/service.vb#8)]  
+  
+ "自己ホスト" オプションと同様、Windows サービス ホスト環境では、ホスト コードをアプリケーションの一部として記述する必要があります。サービスはコンソール アプリケーションとして実装され、独自のホスティング コードが指定されます。インターネット インフォメーション サービス \(IIS\) でホストされる Windows プロセス アクティブ化サービス \(WAS\) など、他のホスト環境ではホスティング コードを記述する必要はありません。  
+  
+## 参照  
+ [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)   
+ [マネージ アプリケーションのホスト](../../../../docs/framework/wcf/feature-details/hosting-in-a-managed-application.md)   
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md
new file mode 100644
index 00000000000..dc478cf1d2a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md
@@ -0,0 +1,115 @@
+---
+title: "方法 : IIS で WCF サービスをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: b044b1c9-c1e5-4c9f-84d8-0f02f4537f8b
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 方法 : IIS で WCF サービスをホストする
+ここでは、インターネット インフォメーション サービス (IIS) でホストされる [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを作成するために必要な基本手順について説明します。 このトピックは、IIS に関する知識があり、IIS 管理ツールを使用して IIS アプリケーションを作成および管理する方法を理解していることを前提としています。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]IIS を参照してください[インターネット インフォメーション サービス](http://go.microsoft.com/fwlink/?LinkId=132449)A [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] IIS 環境で実行されているサービスがプロセスのリサイクル、アイドル シャット ダウン、処理状況の監視、およびメッセージに基づくアクティベーションなどの IIS 機能を最大限に活用します。 このホスト オプションでは、IIS が正しく構成されている必要がありますが、アプリケーションの一部としてホスト コードを書く必要はありません。 IIS ホストは、HTTP トランスポートでのみ使用できます。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]どのように[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]と[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)]操作は、「 [WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]セキュリティの構成を参照してください[セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)します。  
+  
+ この例のソースのコピーを次を参照してください。 [IIS は、インラインのコードを使用してホスト](../../../../docs/framework/wcf/samples/iis-hosting-using-inline-code.md)します。  
+  
+### <a name="to-create-a-service-hosted-by-iis"></a>IIS でホストされるサービスを作成するには  
+  
+1.  コンピューターに IIS がインストールされ、実行されていることを確認します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]インストールと IIS の構成を参照してください[のインストールと IIS 7.0 の構成。](http://go.microsoft.com/fwlink/?LinkID=132128)  
+  
+2.  アプリケーション ファイル用に "IISHostedCalcService" という新しいフォルダーを作成し、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] がそのフォルダーの内容にアクセスできることを確認します。次に、IIS 管理ツールを使用して、このアプリケーション ディレクトリに物理的に配置する新しい IIS アプリケーションを作成します。 アプリケーション ディレクトリのエイリアスを作成する場合は、"IISHostedCalc" を使用します。  
+  
+3.  "service.svc" という新しいファイルをアプリケーション ディレクトリに作成します。 次を追加することでこのファイルを編集@ServiceHost要素。  
+  
+    ```  
+    <%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService"%>  
+    ```  
+  
+4.  アプリケーション ディレクトリ内に App_Code サブディレクトリを作成します。  
+  
+5.  App_Code サブディレクトリに Service.cs というコード ファイルを作成します。  
+  
+6.  Service.cs ファイルの先頭に次の using ステートメントを追加します。  
+  
+    ```  
+    using System;  
+    using System.ServiceModel;  
+    ```  
+  
+7.  using ステートメントの後に、次の名前空間宣言を追加します。  
+  
+    ```  
+    namespace Microsoft.ServiceModel.Samples  
+    {  
+    }  
+    ```  
+  
+8.  次のコードに示すように、名前空間宣言内にサービス コントラクトを定義します。  
+  
+     [!code-csharp[c_HowTo_HostInIIS#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostiniis/cs/source.cs#11)]
+     [!code-vb[c_HowTo_HostInIIS#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostiniis/vb/source.vb#11)]  
+  
+9. 次のコードに示すように、サービス コントラクト定義の後に、サービス コントラクトを実装します。  
+  
+     [!code-csharp[c_HowTo_HostInIIS#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostiniis/cs/source.cs#12)]
+     [!code-vb[c_HowTo_HostInIIS#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostiniis/vb/source.vb#12)]  
+  
+10. アプリケーション ディレクトリ内に "Web.config" というファイルを作成し、次の構成コードをファイルに追加します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、実行時にこの情報を使用して、クライアント アプリケーションが通信できるエンドポイントを作成します。  
+  
+    ```xml  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.serviceModel>  
+        <services>  
+          <!-- This section is optional with the default configuration  
+            model introduced in .NET Framework 4 -->  
+          <service name="Microsoft.ServiceModel.Samples.CalculatorService">  
+  
+            <!-- This endpoint is exposed at the base address provided by host:                                        http://localhost/servicemodelsamples/service.svc  -->  
+            <endpoint address=""  
+                      binding="wsHttpBinding"  
+                      contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  
+            <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->  
+            <endpoint address="mex"  
+                      binding="mexHttpBinding"  
+                      contract="IMetadataExchange" />  
+          </service>  
+        </services>  
+      </system.serviceModel>  
+  
+    </configuration>  
+  
+    ```  
+  
+     この例では、構成ファイルにエンドポイントを明示的に指定します。 エンドポイントをサービスに追加しない場合、ランタイムによって既定のエンドポイントが追加されます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]既定のエンドポイント、バインディング、および動作を参照してください[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)と[WCF サービスの構成を簡略化](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)します。  
+  
+11. サービスが正確にホストされるようにするには、Internet Explorer のインスタンスを開き、サービスの URL: `http://localhost/IISHostedCalc/Service.svc` を参照します。  
+  
+## <a name="example"></a>例  
+ IIS がホストする電卓サービスのコードの完全な一覧を次に示します。  
+  
+ [!code-csharp[C_HowTo_HostInIIS#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostiniis/cs/source.cs#1)]
+ [!code-vb[C_HowTo_HostInIIS#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_hostiniis/vb/source.vb#1)]  
+  
+ [!code[c_HowTo_HostInIIS#100](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_hostiniis/common/web.config#100)]  
+  
+## <a name="see-also"></a>関連項目  
+ [インターネット インフォメーション サービスをホストしています。](../../../../docs/framework/wcf/feature-details/hosting-in-internet-information-services.md)   
+ [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)   
+ [WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)   
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)   
+ [Windows Server App Fabric の機能をホストしています。](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md
new file mode 100644
index 00000000000..bdda3acf34a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : WAS で WCF サービスをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e3e213e-2dce-4f98-81a3-f62f44caeb54
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# 方法 : WAS で WCF サービスをホストする
+ここでは、Windows プロセス アクティブ化サービス (WAS) でホストされる [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを作成するために必要な基本手順について説明します。 WAS は、HTTP 以外のトランスポート プロトコルで動作するインターネット インフォメーション サービス (IIS) 機能を一般化した新しいプロセス アクティブ化サービスです。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、リスナー アダプター インターフェイスを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされる HTTP 以外のプロトコル (TCP、名前付きパイプ、メッセージ キューなど) を介して受信されるアクティブ化要求を伝達します。  
+  
+ このホスト オプションでは、WAS アクティブ化コンポーネントのインストールと構成が正しく行われている必要がありますが、アプリケーションの一部としてホスト コードを記述する必要はありません。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]インストールと、WAS の構成を参照してください。[方法: WCF アクティブ化コンポーネントの構成のインストールおよび](../../../../docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md)です。  
+  
+> [!WARNING]
+>  Web サーバーの要求処理パイプラインをクラシック モードに設定すると、WAS のアクティブ化がサポートされません。 WAS のアクティブ化を使用する場合は、Web サーバーの要求処理パイプラインを統合モードに設定する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが WAS でホストされている場合、標準バインディングは通常の方法で使用されます。 ただしを使用する場合、 <xref:System.ServiceModel.NetTcpBinding>と<xref:System.ServiceModel.NetNamedPipeBinding> WAS でホストされるサービスを構成する、制限を遵守する必要があります。 つまり、異なるエンドポイントが同じトランスポートを使用する場合、次の&7; つのプロパティでバインディング設定が一致する必要があります。  
+  
+-   ConnectionBufferSize  
+  
+-   ChannelInitializationTimeout  
+  
+-   MaxPendingConnections  
+  
+-   MaxOutputDelay  
+  
+-   MaxPendingAccepts  
+  
+-   ConnectionPoolSettings.IdleTimeout  
+  
+-   ConnectionPoolSettings.MaxOutboundConnectionsPerEndpoint  
+  
+ それ以外の場合、まず初期化されているエンドポイント常に、これらのプロパティの値を決定し、後で追加したエンドポイントをスローする<xref:System.ServiceModel.ServiceActivationException>これらの設定と一致しない場合。  
+  
+ この例のソースのコピーを次を参照してください。 [TCP のアクティブ化](../../../../docs/framework/wcf/samples/tcp-activation.md)します。  
+  
+### <a name="to-create-a-basic-service-hosted-by-was"></a>WAS でホストされる基本サービスを作成するには  
+  
+1.  サービスの種類にサービス コントラクトを定義します。  
+  
+     [!code-csharp[C_HowTo_HostInWAS#1121](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinwas/cs/service.cs#1121)]  
+  
+2.  サービス クラスにサービス コントラクトを実装します。 アドレス情報とバインディング情報はサービスの実装内では指定されないことに注意してください。 同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[C_HowTo_HostInWAS#1122](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinwas/cs/service.cs#1122)]  
+  
+3.  定義する Web.config ファイルを作成、 <xref:System.ServiceModel.NetTcpBinding>で使用するバインディングを`CalculatorService`エンドポイント。  
+  
+    ```xml  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.serviceModel>  
+        <bindings>  
+          <netTcpBinding>  
+            <binding portSharingEnabled="true">  
+              <security mode="None" />  
+            </binding>  
+          </netTcpBinding>  
+        </bindings>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+4.  次のコードを含む Service.svc ファイルを作成します。  
+  
+    ```  
+    <%@ServiceHost language=c# Service="CalculatorService" %>   
+    ```  
+  
+5.  IIS 仮想ディレクトリに Service.svc ファイルを配置します。  
+  
+### <a name="to-create-a-client-to-use-the-service"></a>サービスを使用するクライアントを作成するには  
+  
+1.  使用[ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)を使用してサービス メタデータからコードを生成します。  
+  
+    ```  
+    Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+    ```  
+  
+2.  生成されたクライアントには、クライアントの実装時に満たされなければならないサービス コントラクトを定義する `ICalculator` インターフェイスが含まれます。  
+  
+     [!code-csharp[C_HowTo_HostInWAS#1221](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinwas/cs/client.cs#1221)]  
+  
+3.  生成されたクライアント アプリケーションは `ClientCalculator` も実装します。 このサービスの実装では、アドレス情報とバインディング情報が指定されないことに注意してください。 同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code-csharp[C_HowTo_HostInWAS#1222](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinwas/cs/client.cs#1222)]  
+  
+4.  使用するクライアントの構成、 <xref:System.ServiceModel.NetTcpBinding>も Svcutil.exe によって生成されます。 Visual Studio を使用する場合は、このファイルの名前は App.config ファイル内で指定する必要があります。  
+  
+     [!code[C_HowTo_HostInWAS#2211](../../../../samples/snippets/common/VS_Snippets_CFX/c_howto_hostinwas/common/app.config#2211)]  
+  
+5.  アプリケーションで `ClientCalculator` のインスタンスを作成し、サービス操作を呼び出します。  
+  
+     [!code-csharp[C_HowTo_HostInWAS#1223](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_hostinwas/cs/client.cs#1223)]  
+  
+6.  クライアントをコンパイルして実行します。  
+  
+## <a name="see-also"></a>関連項目  
+ [TCP のアクティブ化](../../../../docs/framework/wcf/samples/tcp-activation.md)   
+ [Windows Server App Fabric の機能をホストしています。](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-host-a-workflow-service-with-windows-server-app-fabric.md b/docs/framework/wcf/feature-details/how-to-host-a-workflow-service-with-windows-server-app-fabric.md
new file mode 100644
index 00000000000..9b1f166d57b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-host-a-workflow-service-with-windows-server-app-fabric.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : Windows Server AppFabric を使用してワークフロー サービスをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83b62cce-5fc2-4c6d-b27c-5742ba3bac73
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : Windows Server AppFabric を使用してワークフロー サービスをホストする
+AppFabric でのワークフロー サービスのホスティングは IIS\/WAS でのホスティングに似ています。唯一の違いは、ワークフロー サービスの投入、監視、および管理のために AppFabric に用意されているツールです。このトピックでは「[長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)」で作成されたワークフロー サービスを使用します。ワークフロー サービスの作成方法はそちらのトピックで説明されています。このトピックでは、AppFabric を使用したワークフロー サービスのホスティング方法を説明します。Windows Server AppFabric [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[Windows Server AppFabric のドキュメント](http://go.microsoft.com/fwlink/?LinkID=193037&clcid=0x409)を参照してください。下の手順を完了する前に、Windows Server AppFabric がインストールされていることを確認してください。それには、Internet Information Services \(inetmgr.exe\) を開いて、**\[接続\]** ビューでサーバー名をクリックし、\[サイト\] をクリックして、**\[既定の Web サイト\]** をクリックします。画面の右側に **\[AppFabric\]** というセクションが表示されます。\(右側のペインの一番上に表示される\) このセクションが表示されないのであれば、AppFabric がインストールされていません。Windows Server AppFabric のインストール[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server AppFabric のインストール](http://go.microsoft.com/fwlink/?LinkId=193136)」を参照してください。  
+  
+### 単純なワークフロー サービスの作成  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を開き、「[長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)」のトピックで作成した OrderProcessing ソリューションを読み込みます。  
+  
+2.  **\[OrderService\]** プロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[Web\]** タブをクリックします。  
+  
+3.  プロパティ ページの **\[開始動作\]** セクションで **\[ページを指定する\]** をクリックして、編集ボックスに「Service1.xamlx」と入力します。  
+  
+4.  プロパティ ページの **\[サーバー\]** セクションで **\[ローカル IIS Web サーバーを使用する\]** をクリックして、「`http://localhost/OrderService`」と入力します。  
+  
+5.  **\[仮想ディレクトリの作成\]** ボタンをクリックします。これで新しい仮想ディレクトリが作成され、プロジェクトが作成されるときに必要なファイルが仮想ディレクトリにコピーされるようにプロジェクトが設定されます。または、仮想ディレクトリに .xamlx、web.config、および必要な DLL を手動でコピーすることもできます。  
+  
+### Windows Server AppFabric でホストされるワークフロー サービスの構成  
+  
+1.  インターネット インフォメーション サービス マネージャー \(inetmgr.exe\) を開きます。  
+  
+2.  **\[接続\]** ペインで OrderService 仮想ディレクトリに移動します。  
+  
+3.  OrderService を右クリックし、**\[WCF サービスと WF サービスの管理\]**、**\[構成\]** の順にクリックします。**\[アプリケーションの WCF と WF の構成\]** ダイアログ ボックスが表示されます。  
+  
+4.  **\[全般\]** タブをクリックして、次のスクリーン ショットに示すようなアプリケーションに関する全般的な情報を表示します。  
+  
+     ![App Fabric の構成ダイアログの &#91;全般&#93; タブ](../../../../docs/framework/wcf/feature-details/media/appfabricconfiguration-general.gif "AppFabricConfiguration\-General")  
+  
+5.  **\[監視\]** タブをクリックします。次のスクリーン ショットに示すような各種の監視設定が表示されます。  
+  
+     ![App Fabric の構成の &#91;監視&#93; タブ](../../../../docs/framework/wcf/feature-details/media/appfabricconfiguration-monitoring.gif "AppFabricConfiguration\-Monitoring")  
+  
+     AppFabric におけるワークフロー サービスの監視を構成する手順[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[監視を構成する](http://go.microsoft.com/fwlink/?LinkId=193153)」を参照してください。  
+  
+6.  **\[ワークフローの永続化\]** タブをクリックします。ここでは、次のスクリーン ショットに示すように、AppFabric の既定の永続化プロバイダーをアプリケーションで使用するように構成できます。  
+  
+     ![App Fabric の構成 &#45; 永続化](../../../../docs/framework/wcf/feature-details/media/appfabricconfiguration-persistence.gif "AppFabricConfiguration\-Persistence")  
+  
+     Windows Server AppFabric におけるワークフロー永続化を構成する手順[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[ワークフロー永続化を構成する](http://go.microsoft.com/fwlink/?LinkId=193148)」を参照してください。  
+  
+7.  **\[ワークフロー ホスト管理\]** タブをクリックします。ここでは、次のスクリーン ショットに見られるように、アイドル状態のワークフロー サービス インスタンスをいつアンロードして永続化するかを指定できます。  
+  
+     ![App Fabric の構成の &#91;ワークフロー ホスト管理&#93; タブ](../../../../docs/framework/wcf/feature-details/media/appfabricconfiguration-management.gif "AppFabricConfiguration\-Management")  
+  
+     ワークフロー ホスト管理の構成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[ワークフロー ホスト管理を構成する](http://go.microsoft.com/fwlink/?LinkId=193151)」を参照してください。  
+  
+8.  **\[自動開始\]** タブをクリックします。ここでは、次のスクリーン ショットに示すように、アプリケーションでのワークフロー サービスに対する自動開始の設定を指定できます。  
+  
+     ![App Fabric の自動開始構成](../../../../docs/framework/wcf/feature-details/media/appfabricconfigurationautostart.gif "AppFabricConfigurationAutostart")  
+  
+     自動開始の構成手順[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[自動開始の構成](http://go.microsoft.com/fwlink/?LinkId=193150)」を参照してください。  
+  
+9. **\[スロットル\]** タブをクリックします。ここでは、次のスクリーン ショットに示すように、ワークフロー サービスのスロットル設定を構成できます。  
+  
+     ![App Fabric の構成の調整](../../../../docs/framework/wcf/feature-details/media/appfabricconfigurationthrottling.gif "AppFabricConfigurationThrottling")  
+  
+     スロットルの構成手順[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[スロットルを構成する](http://go.microsoft.com/fwlink/?LinkId=193149)」を参照してください。  
+  
+10. **\[セキュリティ\]** タブをクリックします。ここでは、次のスクリーン ショットに示すように、アプリケーションに対するセキュリティの設定を構成できます。  
+  
+     ![App Fabric のセキュリティ構成](../../../../docs/framework/wcf/feature-details/media/appfabricconfiguration-security.gif "AppFabricConfiguration\-Security")  
+  
+     Windows Server AppFabric でのセキュリティの構成手順[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、AppFabric ドキュメントの「[セキュリティの構成](http://go.microsoft.com/fwlink/?LinkId=193152)」を参照してください。  
+  
+### Windows Server AppFabric の使用  
+  
+1.  ソリューションを作成して、仮想ディレクトリに必要なファイルをコピーします。  
+  
+2.  OrderClient プロジェクトを右クリックし、**\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックして、クライアント アプリケーションを実行します。  
+  
+3.  クライアントが実行され、Visual Studio により **\[アタッチのセキュリティ警告\]** ダイアログ ボックスが表示されたら、**\[アタッチしない\]** ボタンをクリックします。これにより、IIS プロセスにアタッチしてデバッグしないように Visual Studio に指示します。  
+  
+4.  クライアント アプリケーションは直ちにワークフロー サービスを呼び出して待機します。ワークフロー サービスはアイドル状態になり永続化されます。これは、インターネット インフォメーション サービス \(inetmgr.exe\) を開始して、\[接続\] ペインで \[OrderService\] に移動し、それを選択することによって確認できます。次に、右側のペインで \[AppFabric ダッシュボード\] のアイコンをクリックします。次のスクリーン ショットに示すように、\[永続的な WF インスタンス\] の下に、永続化されたワークフロー サービスのインスタンスが 1 つ表示されます。  
+  
+     ![App Fabric ダッシュボード](../../../../docs/framework/wcf/feature-details/media/appfabricdashboard.gif "AppFabricDashboard")  
+  
+     **\[WF インスタンスの履歴\]** には、ワークフロー サービスのアクティベーション数、ワークフロー サービス インスタンスの完了数、ワークフロー インスタンスの失敗数など、そのワークフロー サービスに関する情報が表示されます。\[アクティブなインスタンスまたはアイドル状態のインスタンス\] の下に表示されるリンクをクリックすると、次のスクリーン ショットに示すように、アイドル状態のワークフロー インスタンスの詳細情報が表示されます。  
+  
+     ![永続化ワークフロー インスタンスの詳細](../../../../docs/framework/wcf/feature-details/media/persisteddetail.gif "PersistedDetail")  
+  
+     Windows Server AppFabric の機能に関する詳細については、「[AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkID=193143&clcid=0x409)」を参照してください。  
+  
+## 参照  
+ [長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=193143)   
+ [Windows Server AppFabric のインストール](http://go.microsoft.com/fwlink/?LinkId=193136)   
+ [Windows Server AppFabric のドキュメント](http://go.microsoft.com/fwlink/?LinkID=193037&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md b/docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md
new file mode 100644
index 00000000000..6f2400e18e4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md
@@ -0,0 +1,1013 @@
+---
+title: "探索プロキシを実装する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78d70e0a-f6c3-4cfb-a7ca-f66ebddadde0
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 探索プロキシを実装する方法
+このトピックでは、探索プロキシの実装方法について説明します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の探索機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)」を参照してください。探索プロキシを実装するには、抽象クラス <xref:System.ServiceModel.Discovery.DiscoveryProxy> を拡張するクラスを作成します。このサンプルでは、他の多くのサポート クラスも定義され、使用されています。`OnResolveAsyncResult`、`OnFindAsyncResult`、および `AsyncResult`このクラスは、<xref:System.IAsyncResult> インターフェイスを実装します。<xref:System.IAsyncResult>[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[System.IAsyncResult インターフェイス](http://go.microsoft.com/fwlink/?LinkId=128519)」を参照してください。  
+  
+ このトピックでは、探索プロキシの実装を 3 つの主要な部分に分けて説明します。  
+  
+-   データ ストアを含み、抽象クラス <xref:System.ServiceModel.Discovery.DiscoveryProxy> を拡張するクラスを定義する。  
+  
+-   ヘルパー クラス `AsyncResult` を実装する。  
+  
+-   探索プロキシをホストする。  
+  
+### 新しいコンソール アプリケーション プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動します。  
+  
+2.  新しいコンソール アプリケーション プロジェクトを作成します。プロジェクトに「`DiscoveryProxy`」という名前を付け、ソリューションに「`DiscoveryProxyExample`」という名前を付けます。  
+  
+3.  プロジェクトに次の参照を追加します。  
+  
+    1.  System.ServiceModel.dll  
+  
+    2.  System.Servicemodel.Discovery.dll  
+  
+    > [!CAUTION]
+    >  必ず、これらのアセンブリのバージョン 4.0 以降を参照してください。  
+  
+### ProxyDiscoveryService クラスを実装するには  
+  
+1.  新しいコード ファイルをプロジェクトに追加し、DiscoveryProxy.cs という名前を付けます。  
+  
+2.  次の `using` ステートメントを DiscoveryProxy.cs に追加します。  
+  
+    ```  
+    using System;  
+    using System.Collections.Generic;  
+    using System.ServiceModel;  
+    using System.ServiceModel.Discovery;  
+    using System.Xml;  
+    ```  
+  
+3.  <xref:System.ServiceModel.Discovery.DiscoveryProxy> から `DiscoveryProxyService` を派生させます。下の例に示すように、`ServiceBehavior` 属性をクラスに適用します。  
+  
+    ```  
+    // Implement DiscoveryProxy by extending the DiscoveryProxy class and overriding the abstract methods  
+    [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single, ConcurrencyMode = ConcurrencyMode.Multiple)]  
+    public class DiscoveryProxyService : DiscoveryProxy  
+    {  
+    }  
+  
+    ```  
+  
+4.  `DiscoveryProxy` クラス内で、登録済みサービスを保持するディクショナリを定義します。  
+  
+    ```  
+    // Repository to store EndpointDiscoveryMetadata.   
+    Dictionary<EndpointAddress, EndpointDiscoveryMetadata> onlineServices;  
+  
+    ```  
+  
+5.  ディクショナリを初期化するコンストラクターを定義します。  
+  
+    ```  
+    public DiscoveryProxyService()  
+            {  
+                this.onlineServices = new Dictionary<EndpointAddress, EndpointDiscoveryMetadata>();  
+            }  
+  
+    ```  
+  
+### 探索プロキシ キャッシュの更新に使用するメソッドを定義するには  
+  
+1.  `AddOnlineservice` メソッドを実装して、サービスをキャッシュに追加します。これは、プロキシがアナウンス メッセージを受け取るたびに呼び出されます。  
+  
+    ```  
+    void AddOnlineService(EndpointDiscoveryMetadata endpointDiscoveryMetadata)  
+            {  
+                lock (this.onlineServices)  
+                {  
+                    this.onlineServices[endpointDiscoveryMetadata.Address] = endpointDiscoveryMetadata;                  
+                }  
+  
+                PrintDiscoveryMetadata(endpointDiscoveryMetadata, "Adding");  
+            }  
+  
+    ```  
+  
+2.  キャッシュからサービスを削除するのに使用する `RemoveOnlineService` メソッドを実装します。  
+  
+    ```  
+    void RemoveOnlineService(EndpointDiscoveryMetadata endpointDiscoveryMetadata)  
+            {  
+                if (endpointDiscoveryMetadata != null)  
+                {  
+                    lock (this.onlineServices)  
+                    {  
+                        this.onlineServices.Remove(endpointDiscoveryMetadata.Address);                      
+                    }  
+  
+                    PrintDiscoveryMetadata(endpointDiscoveryMetadata, "Removing");  
+                }      
+            }  
+  
+    ```  
+  
+3.  サービスをディクショナリ内のサービスと照合する、`MatchFromOnlineService` メソッドを実装します。  
+  
+    ```  
+    void MatchFromOnlineService(FindRequestContext findRequestContext)  
+            {  
+                lock (this.onlineServices)  
+                {  
+                    foreach (EndpointDiscoveryMetadata endpointDiscoveryMetadata in this.onlineServices.Values)  
+                    {  
+                        if (findRequestContext.Criteria.IsMatch(endpointDiscoveryMetadata))  
+                        {  
+                            findRequestContext.AddMatchingEndpoint(endpointDiscoveryMetadata);  
+                        }  
+                    }  
+                }  
+            }  
+  
+    ```  
+  
+    ```  
+    EndpointDiscoveryMetadata MatchFromOnlineService(ResolveCriteria criteria)  
+            {  
+                EndpointDiscoveryMetadata matchingEndpoint = null;  
+                lock (this.onlineServices)  
+                {  
+                    foreach (EndpointDiscoveryMetadata endpointDiscoveryMetadata in this.onlineServices.Values)  
+                    {  
+                        if (criteria.Address == endpointDiscoveryMetadata.Address)  
+                        {  
+                            matchingEndpoint = endpointDiscoveryMetadata;  
+                        }  
+                    }  
+                }  
+                return matchingEndpoint;  
+            }  
+  
+    ```  
+  
+4.  探索プロキシの処理に関するコンソール テキスト出力をユーザーに提供する、`PrintDiscoveryMetadata` メソッドを実装します。  
+  
+    ```  
+    void PrintDiscoveryMetadata(EndpointDiscoveryMetadata endpointDiscoveryMetadata, string verb)  
+            {  
+                Console.WriteLine("\n**** " + verb + " service of the following type from cache. ");  
+                foreach (XmlQualifiedName contractName in endpointDiscoveryMetadata.ContractTypeNames)  
+                {  
+                    Console.WriteLine("** " + contractName.ToString());  
+                    break;  
+                }  
+                Console.WriteLine("**** Operation Completed");  
+            }  
+  
+    ```  
+  
+5.  次の AsyncResult クラスを DiscoveryProxyService に追加します。これらのクラスは、非同期操作の各結果を区別するために使用されます。  
+  
+    ```  
+    sealed class OnOnlineAnnouncementAsyncResult : AsyncResult  
+            {  
+                public OnOnlineAnnouncementAsyncResult(AsyncCallback callback, object state)  
+                    : base(callback, state)  
+                {  
+                    this.Complete(true);  
+                }  
+  
+                public static void End(IAsyncResult result)  
+                {  
+                    AsyncResult.End<OnOnlineAnnouncementAsyncResult>(result);  
+                }  
+            }  
+  
+            sealed class OnOfflineAnnouncementAsyncResult : AsyncResult  
+            {  
+                public OnOfflineAnnouncementAsyncResult(AsyncCallback callback, object state)  
+                    : base(callback, state)  
+                {  
+                    this.Complete(true);  
+                }  
+  
+                public static void End(IAsyncResult result)  
+                {  
+                    AsyncResult.End<OnOfflineAnnouncementAsyncResult>(result);  
+                }  
+            }  
+  
+            sealed class OnFindAsyncResult : AsyncResult  
+            {  
+                public OnFindAsyncResult(AsyncCallback callback, object state)  
+                    : base(callback, state)  
+                {  
+                    this.Complete(true);  
+                }  
+  
+                public static void End(IAsyncResult result)  
+                {  
+                    AsyncResult.End<OnFindAsyncResult>(result);  
+                }  
+            }  
+  
+            sealed class OnResolveAsyncResult : AsyncResult  
+            {  
+                EndpointDiscoveryMetadata matchingEndpoint;  
+  
+                public OnResolveAsyncResult(EndpointDiscoveryMetadata matchingEndpoint, AsyncCallback callback, object state)  
+                    : base(callback, state)  
+                {  
+                    this.matchingEndpoint = matchingEndpoint;  
+                    this.Complete(true);  
+                }  
+  
+                public static EndpointDiscoveryMetadata End(IAsyncResult result)  
+                {  
+                    OnResolveAsyncResult thisPtr = AsyncResult.End<OnResolveAsyncResult>(result);  
+                    return thisPtr.matchingEndpoint;  
+                }  
+            }  
+  
+    ```  
+  
+### 探索プロキシ機能を実装するメソッドを定義するには  
+  
+1.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnBeginOnlineAnnouncement%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシがオンライン アナウンス メッセージを受け取ると呼び出されます。  
+  
+    ```  
+    // OnBeginOnlineAnnouncement method is called when a Hello message is received by the Proxy  
+            protected override IAsyncResult OnBeginOnlineAnnouncement(DiscoveryMessageSequence messageSequence, EndpointDiscoveryMetadata endpointDiscoveryMetadata, AsyncCallback callback, object state)  
+            {          
+                this.AddOnlineService(endpointDiscoveryMetadata);  
+                return new OnOnlineAnnouncementAsyncResult(callback, state);  
+            }  
+  
+    ```  
+  
+2.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnEndOnlineAnnouncement%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシがアナウンス メッセージの処理を終了すると呼び出されます。  
+  
+    ```  
+    protected override void OnEndOnlineAnnouncement(IAsyncResult result)  
+            {  
+                OnOnlineAnnouncementAsyncResult.End(result);  
+            }  
+  
+    ```  
+  
+3.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnBeginOfflineAnnouncement%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシがオフライン アナウンス メッセージを受け取ると呼び出されます。  
+  
+    ```  
+    // OnBeginOfflineAnnouncement method is called when a Bye message is received by the Proxy  
+            protected override IAsyncResult OnBeginOfflineAnnouncement(DiscoveryMessageSequence messageSequence, EndpointDiscoveryMetadata endpointDiscoveryMetadata, AsyncCallback callback, object state)  
+            {  
+                this.RemoveOnlineService(endpointDiscoveryMetadata);  
+                return new OnOfflineAnnouncementAsyncResult(callback, state);  
+            }  
+  
+    ```  
+  
+4.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnEndOfflineAnnouncement%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシがオフライン アナウンス メッセージの処理を終了すると呼び出されます。  
+  
+    ```  
+    protected override void OnEndOfflineAnnouncement(IAsyncResult result)  
+            {  
+                OnOfflineAnnouncementAsyncResult.End(result);  
+            }  
+  
+    ```  
+  
+5.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnBeginFind%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシが検索要求を受け取ると呼び出されます。  
+  
+    ```  
+    // OnBeginFind method is called when a Probe request message is received by the Proxy  
+            protected override IAsyncResult OnBeginFind(FindRequestContext findRequestContext, AsyncCallback callback, object state)  
+            {  
+                this.MatchFromOnlineService(findRequestContext);  
+                return new OnFindAsyncResult(callback, state);  
+            }  
+    protected override IAsyncResult OnBeginFind(FindRequest findRequest, AsyncCallback callback, object state)  
+    {  
+        Collection<EndpointDiscoveryMetadata> matchingEndpoints = MatchFromCache(findRequest.Criteria);  
+        return new OnFindAsyncResult(  
+                    matchingEndpoints,  
+                    callback,  
+                    state);  
+    }  
+    ```  
+  
+6.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnEndFind%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシが検索要求の処理を終了すると呼び出されます。  
+  
+    ```  
+    protected override void OnEndFind(IAsyncResult result)  
+            {  
+                OnFindAsyncResult.End(result);  
+            }  
+  
+    ```  
+  
+7.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnBeginResolve%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシが解決メッセージを受け取ると呼び出されます。  
+  
+    ```  
+    // OnBeginFind method is called when a Resolve request message is received by the Proxy  
+            protected override IAsyncResult OnBeginResolve(ResolveCriteria resolveCriteria, AsyncCallback callback, object state)  
+            {  
+                return new OnResolveAsyncResult(this.MatchFromOnlineService(resolveCriteria), callback, state);  
+            }  
+    protected override IAsyncResult OnBeginResolve(ResolveRequest resolveRequest, AsyncCallback callback, object state)  
+    {  
+        return new OnResolveAsyncResult(  
+            this.proxy.MatchFromOnlineService(resolveRequest.Criteria),  
+            callback,  
+            state);  
+    }  
+    ```  
+  
+8.  <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnEndResolve%2A> メソッドをオーバーライドします。このメソッドは、探索プロキシが解決メッセージの処理を終了すると呼び出されます。  
+  
+    ```  
+    protected override EndpointDiscoveryMetadata OnEndResolve(IAsyncResult result)  
+    {  
+        return OnResolveAsyncResult.End(result);  
+    }  
+  
+    ```  
+  
+ OnBegin..\/ OnEnd..メソッドは、以降の探索操作のロジックを提供します。たとえば、<xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnBeginFind%2A> メソッドおよび <xref:System.ServiceModel.Discovery.DiscoveryProxyBase.OnEndFind%2A> メソッドは、探索プロキシの検索ロジックを実装します。探索プロキシがプローブ メッセージを受け取ると、これらのメソッドが実行されて、クライアントに応答が返されます。必要に応じて、検索ロジックを変更できます。たとえば、アルゴリズムによるカスタム スコープ一致や、検索操作の一環として解析するアプリケーション固有の XML メタデータを組み込むことができます。  
+  
+### AsyncResult クラスを実装するには  
+  
+1.  各種の非同期結果クラスを派生させるために使用する抽象基本クラス AsyncResult を定義します。  
+  
+2.  AsyncResult.cs という名前の新しいコード ファイルを作成します。  
+  
+3.  次の `using` ステートメントを AsyncResult.cs に追加します。  
+  
+    ```  
+    using System;  
+    using System.Threading;  
+  
+    ```  
+  
+4.  次の AsyncResult クラスを追加します。  
+  
+    ```  
+    abstract class AsyncResult : IAsyncResult  
+        {  
+            AsyncCallback callback;  
+            bool completedSynchronously;  
+            bool endCalled;  
+            Exception exception;  
+            bool isCompleted;  
+            ManualResetEvent manualResetEvent;  
+            object state;  
+            object thisLock;  
+  
+            protected AsyncResult(AsyncCallback callback, object state)  
+            {  
+                this.callback = callback;  
+                this.state = state;  
+                this.thisLock = new object();  
+            }  
+  
+            public object AsyncState  
+            {  
+                get  
+                {  
+                    return state;  
+                }  
+            }  
+  
+            public WaitHandle AsyncWaitHandle  
+            {  
+                get  
+                {  
+                    if (manualResetEvent != null)  
+                    {  
+                        return manualResetEvent;  
+                    }  
+                    lock (ThisLock)  
+                    {  
+                        if (manualResetEvent == null)  
+                        {  
+                            manualResetEvent = new ManualResetEvent(isCompleted);  
+                        }  
+                    }  
+                    return manualResetEvent;  
+                }  
+            }  
+  
+            public bool CompletedSynchronously  
+            {  
+                get  
+                {  
+                    return completedSynchronously;  
+                }  
+            }  
+  
+            public bool IsCompleted  
+            {  
+                get  
+                {  
+                    return isCompleted;  
+                }  
+            }  
+  
+            object ThisLock  
+            {  
+                get  
+                {  
+                    return this.thisLock;  
+                }  
+            }  
+  
+            protected static TAsyncResult End<TAsyncResult>(IAsyncResult result)  
+                where TAsyncResult : AsyncResult  
+            {  
+                if (result == null)  
+                {  
+                    throw new ArgumentNullException("result");  
+                }  
+  
+                TAsyncResult asyncResult = result as TAsyncResult;  
+  
+                if (asyncResult == null)  
+                {  
+                    throw new ArgumentException("Invalid async result.", "result");  
+                }  
+  
+                if (asyncResult.endCalled)  
+                {  
+                    throw new InvalidOperationException("Async object already ended.");  
+                }  
+  
+                asyncResult.endCalled = true;  
+  
+                if (!asyncResult.isCompleted)  
+                {  
+                    asyncResult.AsyncWaitHandle.WaitOne();  
+                }  
+  
+                if (asyncResult.manualResetEvent != null)  
+                {  
+                    asyncResult.manualResetEvent.Close();  
+                }  
+  
+                if (asyncResult.exception != null)  
+                {  
+                    throw asyncResult.exception;  
+                }  
+  
+                return asyncResult;  
+            }  
+  
+            protected void Complete(bool completedSynchronously)  
+            {  
+                if (isCompleted)  
+                {  
+                    throw new InvalidOperationException("This async result is already completed.");  
+                }  
+  
+                this.completedSynchronously = completedSynchronously;  
+  
+                if (completedSynchronously)  
+                {  
+                    this.isCompleted = true;  
+                }  
+                else  
+                {  
+                    lock (ThisLock)  
+                    {  
+                        this.isCompleted = true;  
+                        if (this.manualResetEvent != null)  
+                        {  
+                            this.manualResetEvent.Set();  
+                        }  
+                    }  
+                }  
+  
+                if (callback != null)  
+                {  
+                    callback(this);  
+                }  
+            }  
+  
+            protected void Complete(bool completedSynchronously, Exception exception)  
+            {  
+                this.exception = exception;  
+                Complete(completedSynchronously);  
+            }  
+        }  
+  
+    ```  
+  
+### DiscoveryProxy をホストするには  
+  
+1.  DiscoveryProxyExample プロジェクトで Program.cs ファイルを開きます。  
+  
+2.  次の `using` ステートメントを追加します。  
+  
+    ```  
+    using System;  
+    using System.ServiceModel;  
+    using System.ServiceModel.Discovery;  
+    ```  
+  
+3.  `Main()` メソッド内に次のコードを追加します。これにより、`DiscoveryProxy` クラスのインスタンスが作成されます。  
+  
+    ```  
+    Uri probeEndpointAddress = new Uri("net.tcp://localhost:8001/Probe");  
+                Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");  
+  
+                // Host the DiscoveryProxy service  
+                ServiceHost proxyServiceHost = new ServiceHost(new DiscoveryProxyService());  
+  
+    ```  
+  
+4.  次に、探索エンドポイントとアナウンス エンドポイントを追加する、次のコードを追加します。  
+  
+    ```  
+    try  
+              {                  
+                  // Add DiscoveryEndpoint to receive Probe and Resolve messages  
+                  DiscoveryEndpoint discoveryEndpoint = new DiscoveryEndpoint(new NetTcpBinding(), new EndpointAddress(probeEndpointAddress));  
+                  discoveryEndpoint.IsSystemEndpoint = false;  
+  
+                  // Add AnnouncementEndpoint to receive Hello and Bye announcement messages  
+                  AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(), new EndpointAddress(announcementEndpointAddress));                  
+  
+                  proxyServiceHost.AddServiceEndpoint(discoveryEndpoint);  
+                  proxyServiceHost.AddServiceEndpoint(announcementEndpoint);  
+  
+                  proxyServiceHost.Open();  
+  
+                  Console.WriteLine("Proxy Service started.");  
+                  Console.WriteLine();  
+                  Console.WriteLine("Press <ENTER> to terminate the service.");  
+                  Console.WriteLine();  
+                  Console.ReadLine();  
+  
+                  proxyServiceHost.Close();  
+              }  
+              catch (CommunicationException e)  
+              {  
+                  Console.WriteLine(e.Message);  
+              }  
+              catch (TimeoutException e)  
+              {  
+                  Console.WriteLine(e.Message);  
+              }     
+  
+              if (proxyServiceHost.State != CommunicationState.Closed)  
+              {  
+                  Console.WriteLine("Aborting the service...");  
+                  proxyServiceHost.Abort();  
+              }  
+  
+    ```  
+  
+ これで、探索プロキシの実装が完了しました。次に、「[探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)」に進みます。  
+  
+## 使用例  
+ このトピックで使用するコード全体の一覧を次に示します。  
+  
+```  
+// DiscoveryProxy.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Collections.Generic;  
+using System.ServiceModel;  
+using System.ServiceModel.Discovery;  
+using System.Xml;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    // Implement DiscoveryProxy by extending the DiscoveryProxy class and overriding the abstract methods  
+    [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single, ConcurrencyMode = ConcurrencyMode.Multiple)]  
+    public class DiscoveryProxyService : DiscoveryProxy  
+    {  
+        // Repository to store EndpointDiscoveryMetadata. A database or a flat file could also be used instead.  
+        Dictionary<EndpointAddress, EndpointDiscoveryMetadata> onlineServices;  
+  
+        public DiscoveryProxyService()  
+        {  
+            this.onlineServices = new Dictionary<EndpointAddress, EndpointDiscoveryMetadata>();  
+        }  
+  
+        // OnBeginOnlineAnnouncement method is called when a Hello message is received by the Proxy  
+        protected override IAsyncResult OnBeginOnlineAnnouncement(DiscoveryMessageSequence messageSequence, EndpointDiscoveryMetadata endpointDiscoveryMetadata, AsyncCallback callback, object state)  
+        {          
+            this.AddOnlineService(endpointDiscoveryMetadata);  
+            return new OnOnlineAnnouncementAsyncResult(callback, state);  
+        }  
+  
+        protected override void OnEndOnlineAnnouncement(IAsyncResult result)  
+        {  
+            OnOnlineAnnouncementAsyncResult.End(result);  
+        }  
+  
+        // OnBeginOfflineAnnouncement method is called when a Bye message is received by the Proxy  
+        protected override IAsyncResult OnBeginOfflineAnnouncement(DiscoveryMessageSequence messageSequence, EndpointDiscoveryMetadata endpointDiscoveryMetadata, AsyncCallback callback, object state)  
+        {  
+            this.RemoveOnlineService(endpointDiscoveryMetadata);  
+            return new OnOfflineAnnouncementAsyncResult(callback, state);  
+        }  
+  
+        protected override void OnEndOfflineAnnouncement(IAsyncResult result)  
+        {  
+            OnOfflineAnnouncementAsyncResult.End(result);  
+        }  
+  
+        // OnBeginFind method is called when a Probe request message is received by the Proxy  
+        protected override IAsyncResult OnBeginFind(FindRequestContext findRequestContext, AsyncCallback callback, object state)  
+        {  
+            this.MatchFromOnlineService(findRequestContext);  
+            return new OnFindAsyncResult(callback, state);  
+        }  
+  
+        protected override void OnEndFind(IAsyncResult result)  
+        {  
+            OnFindAsyncResult.End(result);  
+        }  
+  
+        // OnBeginFind method is called when a Resolve request message is received by the Proxy  
+        protected override IAsyncResult OnBeginResolve(ResolveCriteria resolveCriteria, AsyncCallback callback, object state)  
+        {  
+            return new OnResolveAsyncResult(this.MatchFromOnlineService(resolveCriteria), callback, state);  
+        }  
+  
+        protected override EndpointDiscoveryMetadata OnEndResolve(IAsyncResult result)  
+        {  
+            return OnResolveAsyncResult.End(result);  
+        }  
+  
+        // The following are helper methods required by the Proxy implementation  
+        void AddOnlineService(EndpointDiscoveryMetadata endpointDiscoveryMetadata)  
+        {  
+            lock (this.onlineServices)  
+            {  
+                this.onlineServices[endpointDiscoveryMetadata.Address] = endpointDiscoveryMetadata;                  
+            }  
+  
+            PrintDiscoveryMetadata(endpointDiscoveryMetadata, "Adding");  
+        }  
+  
+        void RemoveOnlineService(EndpointDiscoveryMetadata endpointDiscoveryMetadata)  
+        {  
+            if (endpointDiscoveryMetadata != null)  
+            {  
+                lock (this.onlineServices)  
+                {  
+                    this.onlineServices.Remove(endpointDiscoveryMetadata.Address);                      
+                }  
+  
+                PrintDiscoveryMetadata(endpointDiscoveryMetadata, "Removing");  
+            }      
+        }  
+  
+        void MatchFromOnlineService(FindRequestContext findRequestContext)  
+        {  
+            lock (this.onlineServices)  
+            {  
+                foreach (EndpointDiscoveryMetadata endpointDiscoveryMetadata in this.onlineServices.Values)  
+                {  
+                    if (findRequestContext.Criteria.IsMatch(endpointDiscoveryMetadata))  
+                    {  
+                        findRequestContext.AddMatchingEndpoint(endpointDiscoveryMetadata);  
+                    }  
+                }  
+            }  
+        }  
+  
+        EndpointDiscoveryMetadata MatchFromOnlineService(ResolveCriteria criteria)  
+        {  
+            EndpointDiscoveryMetadata matchingEndpoint = null;  
+            lock (this.onlineServices)  
+            {  
+                foreach (EndpointDiscoveryMetadata endpointDiscoveryMetadata in this.onlineServices.Values)  
+                {  
+                    if (criteria.Address == endpointDiscoveryMetadata.Address)  
+                    {  
+                        matchingEndpoint = endpointDiscoveryMetadata;  
+                    }  
+                }  
+            }  
+            return matchingEndpoint;  
+        }  
+  
+        void PrintDiscoveryMetadata(EndpointDiscoveryMetadata endpointDiscoveryMetadata, string verb)  
+        {  
+            Console.WriteLine("\n**** " + verb + " service of the following type from cache. ");  
+            foreach (XmlQualifiedName contractName in endpointDiscoveryMetadata.ContractTypeNames)  
+            {  
+                Console.WriteLine("** " + contractName.ToString());  
+                break;  
+            }  
+            Console.WriteLine("**** Operation Completed");  
+        }  
+  
+        sealed class OnOnlineAnnouncementAsyncResult : AsyncResult  
+        {  
+            public OnOnlineAnnouncementAsyncResult(AsyncCallback callback, object state)  
+                : base(callback, state)  
+            {  
+                this.Complete(true);  
+            }  
+  
+            public static void End(IAsyncResult result)  
+            {  
+                AsyncResult.End<OnOnlineAnnouncementAsyncResult>(result);  
+            }  
+        }  
+  
+        sealed class OnOfflineAnnouncementAsyncResult : AsyncResult  
+        {  
+            public OnOfflineAnnouncementAsyncResult(AsyncCallback callback, object state)  
+                : base(callback, state)  
+            {  
+                this.Complete(true);  
+            }  
+  
+            public static void End(IAsyncResult result)  
+            {  
+                AsyncResult.End<OnOfflineAnnouncementAsyncResult>(result);  
+            }  
+        }  
+  
+        sealed class OnFindAsyncResult : AsyncResult  
+        {  
+            public OnFindAsyncResult(AsyncCallback callback, object state)  
+                : base(callback, state)  
+            {  
+                this.Complete(true);  
+            }  
+  
+            public static void End(IAsyncResult result)  
+            {  
+                AsyncResult.End<OnFindAsyncResult>(result);  
+            }  
+        }  
+  
+        sealed class OnResolveAsyncResult : AsyncResult  
+        {  
+            EndpointDiscoveryMetadata matchingEndpoint;  
+  
+            public OnResolveAsyncResult(EndpointDiscoveryMetadata matchingEndpoint, AsyncCallback callback, object state)  
+                : base(callback, state)  
+            {  
+                this.matchingEndpoint = matchingEndpoint;  
+                this.Complete(true);  
+            }  
+  
+            public static EndpointDiscoveryMetadata End(IAsyncResult result)  
+            {  
+                OnResolveAsyncResult thisPtr = AsyncResult.End<OnResolveAsyncResult>(result);  
+                return thisPtr.matchingEndpoint;  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// AsyncResult.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.Threading;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    abstract class AsyncResult : IAsyncResult  
+    {  
+        AsyncCallback callback;  
+        bool completedSynchronously;  
+        bool endCalled;  
+        Exception exception;  
+        bool isCompleted;  
+        ManualResetEvent manualResetEvent;  
+        object state;  
+        object thisLock;  
+  
+        protected AsyncResult(AsyncCallback callback, object state)  
+        {  
+            this.callback = callback;  
+            this.state = state;  
+            this.thisLock = new object();  
+        }  
+  
+        public object AsyncState  
+        {  
+            get  
+            {  
+                return state;  
+            }  
+        }  
+  
+        public WaitHandle AsyncWaitHandle  
+        {  
+            get  
+            {  
+                if (manualResetEvent != null)  
+                {  
+                    return manualResetEvent;  
+                }  
+                lock (ThisLock)  
+                {  
+                    if (manualResetEvent == null)  
+                    {  
+                        manualResetEvent = new ManualResetEvent(isCompleted);  
+                    }  
+                }  
+                return manualResetEvent;  
+            }  
+        }  
+  
+        public bool CompletedSynchronously  
+        {  
+            get  
+            {  
+                return completedSynchronously;  
+            }  
+        }  
+  
+        public bool IsCompleted  
+        {  
+            get  
+            {  
+                return isCompleted;  
+            }  
+        }  
+  
+        object ThisLock  
+        {  
+            get  
+            {  
+                return this.thisLock;  
+            }  
+        }  
+  
+        protected static TAsyncResult End<TAsyncResult>(IAsyncResult result)  
+            where TAsyncResult : AsyncResult  
+        {  
+            if (result == null)  
+            {  
+                throw new ArgumentNullException("result");  
+            }  
+  
+            TAsyncResult asyncResult = result as TAsyncResult;  
+  
+            if (asyncResult == null)  
+            {  
+                throw new ArgumentException("Invalid async result.", "result");  
+            }  
+  
+            if (asyncResult.endCalled)  
+            {  
+                throw new InvalidOperationException("Async object already ended.");  
+            }  
+  
+            asyncResult.endCalled = true;  
+  
+            if (!asyncResult.isCompleted)  
+            {  
+                asyncResult.AsyncWaitHandle.WaitOne();  
+            }  
+  
+            if (asyncResult.manualResetEvent != null)  
+            {  
+                asyncResult.manualResetEvent.Close();  
+            }  
+  
+            if (asyncResult.exception != null)  
+            {  
+                throw asyncResult.exception;  
+            }  
+  
+            return asyncResult;  
+        }  
+  
+        protected void Complete(bool completedSynchronously)  
+        {  
+            if (isCompleted)  
+            {  
+                throw new InvalidOperationException("This async result is already completed.");  
+            }  
+  
+            this.completedSynchronously = completedSynchronously;  
+  
+            if (completedSynchronously)  
+            {  
+                this.isCompleted = true;  
+            }  
+            else  
+            {  
+                lock (ThisLock)  
+                {  
+                    this.isCompleted = true;  
+                    if (this.manualResetEvent != null)  
+                    {  
+                        this.manualResetEvent.Set();  
+                    }  
+                }  
+            }  
+  
+            if (callback != null)  
+            {  
+                callback(this);  
+            }  
+        }  
+  
+        protected void Complete(bool completedSynchronously, Exception exception)  
+        {  
+            this.exception = exception;  
+            Complete(completedSynchronously);  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+// program.cs  
+//----------------------------------------------------------------  
+// Copyright (c) Microsoft Corporation.  All rights reserved.  
+//----------------------------------------------------------------  
+  
+using System;  
+using System.ServiceModel;  
+using System.ServiceModel.Discovery;  
+  
+namespace Microsoft.Samples.Discovery  
+{  
+    class Program  
+    {  
+        public static void Main()  
+        {  
+            Uri probeEndpointAddress = new Uri("net.tcp://localhost:8001/Probe");  
+            Uri announcementEndpointAddress = new Uri("net.tcp://localhost:9021/Announcement");  
+  
+            // Host the DiscoveryProxy service  
+            ServiceHost proxyServiceHost = new ServiceHost(new DiscoveryProxyService());  
+  
+            try  
+            {                  
+                // Add DiscoveryEndpoint to receive Probe and Resolve messages  
+                DiscoveryEndpoint discoveryEndpoint = new DiscoveryEndpoint(new NetTcpBinding(), new EndpointAddress(probeEndpointAddress));  
+                discoveryEndpoint.IsSystemEndpoint = false;  
+  
+                // Add AnnouncementEndpoint to receive Hello and Bye announcement messages  
+                AnnouncementEndpoint announcementEndpoint = new AnnouncementEndpoint(new NetTcpBinding(), new EndpointAddress(announcementEndpointAddress));                  
+  
+                proxyServiceHost.AddServiceEndpoint(discoveryEndpoint);  
+                proxyServiceHost.AddServiceEndpoint(announcementEndpoint);  
+  
+                proxyServiceHost.Open();  
+  
+                Console.WriteLine("Proxy Service started.");  
+                Console.WriteLine();  
+                Console.WriteLine("Press <ENTER> to terminate the service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+                proxyServiceHost.Close();  
+            }  
+            catch (CommunicationException e)  
+            {  
+                Console.WriteLine(e.Message);  
+            }  
+            catch (TimeoutException e)  
+            {  
+                Console.WriteLine(e.Message);  
+            }     
+  
+            if (proxyServiceHost.State != CommunicationState.Closed)  
+            {  
+                Console.WriteLine("Aborting the service...");  
+                proxyServiceHost.Abort();  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)   
+ [探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)   
+ [探索プロキシをテストする方法](../../../../docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-import-metadata-into-service-endpoints.md b/docs/framework/wcf/feature-details/how-to-import-metadata-into-service-endpoints.md
new file mode 100644
index 00000000000..fcf2d4fc308
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-import-metadata-into-service-endpoints.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : メタデータをサービス エンドポイントにインポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b69dbe20-92a1-4911-89d8-ffbc3dad4663
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : メタデータをサービス エンドポイントにインポートする
+このトピックでは、メタデータをサービス エンドポイントのコレクションにインポートし、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に定義されているサービスを使用する方法について説明します。  また、サービスからメタデータをインポートし、次にそのサービスに対して `Add` メソッドを呼び出すクライアント アプリケーションを作成する方法についても説明します。  
+  
+### メタデータをサービス エンドポイントにインポートするには  
+  
+1.  <xref:System.ServiceModel.EndpointAddress> オブジェクトを定義し、サービスの metadata exchange \(MEX\) アドレスの URI \(Uniform Resource Identifier\) を使ってそのオブジェクトを初期化します。  
+  
+     [!code-csharp[UE_ImportMetadata#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/ue_importmetadata/cs/client.cs#0)]  
+  
+2.  <xref:System.ServiceModel.Description.MetadataExchangeClient> を作成し、MEX アドレスを渡して <xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> を呼び出します。  これにより、メタデータをサービスから取得します。  
+  
+     [!code-csharp[UE_ImportMetadata#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/ue_importmetadata/cs/client.cs#1)]  
+  
+3.  <xref:System.ServiceModel.Description.WsdlImporter> を作成し、前に取得したメタデータを渡して <xref:System.ServiceModel.Description.WsdlImporter.ImportAllContracts%2A> を呼び出します。  これにより、<xref:System.ServiceModel.Description.ContractDescription> オブジェクトのコレクションを生成します。  必要に応じて、<xref:System.ServiceModel.Description.WsdlImporter.ImportAllEndpoints%2A> または <xref:System.ServiceModel.Description.WsdlImporter.ImportAllBindings%2A> を呼び出すこともできます。  
+  
+     [!code-csharp[UE_ImportMetadata#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/ue_importmetadata/cs/client.cs#2)]  
+  
+    > [!NOTE]
+    >  メタデータのインポートが完了すると、クライアント チャネルの作成もメタデータのエクスポートもできなくなります。  これは、この時点で型情報を使用できないためです。  型情報は、サービスと実際に対話する場合またはメタデータをエクスポートする場合に必要です。  型情報を生成するには、コードを生成する必要があります。これについては、手順 4. ～ 5. で説明します。  別の方法として、<xref:System.ServiceModel.Description.MetadataResolver> ヘルパー クラスを使用することもできます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : MetadataResolver を使用してバインディング メタデータを動的に取得する](../../../../docs/framework/wcf/feature-details/how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md).  
+  
+4.  各コントラクトに型情報を生成します。  
+  
+     [!code-csharp[UE_ImportMetadata#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/ue_importmetadata/cs/client.cs#3)]  
+  
+5.  これで、この情報を使用できます。  次の例では、C\# ソース コードが生成されます。  
+  
+     [!code-csharp[UE_ImportMetadata#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/ue_importmetadata/cs/client.cs#4)]  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)   
+ [概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md b/docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md
new file mode 100644
index 00000000000..42e88d1e821
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-install-and-configure-wcf-activation-components.md
@@ -0,0 +1,114 @@
+---
+title: "方法 : WCF アクティブ化コンポーネントをインストールして設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "HTTP アクティベーション [WCF]"
+ms.assetid: 33a7054a-73ec-464d-83e5-b203aeded658
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 方法 : WCF アクティブ化コンポーネントをインストールして設定する
+ここでは、HTTP ネットワーク プロトコルでは通信しない [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストするように Windows プロセス アクティブ化サービス \(WAS: Windows Process Activation Service\) を [!INCLUDE[wv](../../../../includes/wv-md.md)] に構成するために必要な手順について説明します。以降の各セクションで、この構成に関する手順について概説します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティブ化コンポーネントをインストール \(またはそのインストールを確認\) します。  
+  
+-   非 HTTP プロトコルをサポートようにする WAS を構成します。次の手順では、TCP アクティベーション用に [!INCLUDE[wv](../../../../includes/wv-md.md)] を構成します。  
+  
+ WAS をインストールして構成したら、「[方法 : WAS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)」の手順を参照して、WAS を使用する非 HTTP エンドポイントを公開する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成します。  
+  
+### WCF 非 HTTP アクティブ化コンポーネントをインストールするには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]** をクリックします。  
+  
+2.  **\[プログラム\]** をクリックし、**\[プログラムと機能\]** をクリックします。  
+  
+3.  **\[タスク\]** メニューの **\[Windows の機能を有効化または無効化\]** をクリックします。  
+  
+4.  [!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] ノードを検索し、それを選択して展開します。  
+  
+5.  **\[WCF Non\-Http Activation Components\]** ボックスをオンにして、設定を保存します。  
+  
+### TCP アクティベーションをサポートするように WAS を構成するには  
+  
+1.  net.tcp アクティベーションをサポートするには、既定の Web サイトをあらかじめ net.tcp ポートにバインドしておく必要があります。これは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] 管理ツール セットと共にインストールされる Appcmd.exe を使用して行います。管理者レベルのコマンド プロンプト ウィンドウで、次のコマンドを実行します。  
+  
+    ```  
+    %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']  
+    ```  
+  
+    > [!NOTE]
+    >  このコマンドはテキスト 1 行です。このコマンドは、net.tcp サイト バインディングを、TCP ポート 808 で任意のホスト名をリッスンする既定の Web サイトに追加します。  
+  
+2.  サイト内のすべてのアプリケーションが同じ net.tcp バインディングを共有しますが、net.tcp サポートの有効化はアプリケーションごとに指定できます。アプリケーションで net.tcp を有効にするには、管理者レベルのコマンド プロンプトから、次のコマンドを実行します。  
+  
+    ```  
+    %windir%\system32\inetsrv\appcmd.exe set app   
+    "Default Web Site/<WCF Application>" /enabledProtocols:http,net.tcp  
+    ```  
+  
+    > [!NOTE]
+    >  このコマンドはテキスト 1 行です。このコマンドにより、\/\<*WCF Application*\> アプリケーションには、http:\/\/localhost*\/\<WCF Application\>* および net.tcp:\/\/localhost\/*\<WCF Application\>* のどちらからでもアクセスできるようになります。  
+  
+     このサンプル用に追加した net.tcp サイト バインディングを削除します。  
+  
+     便宜上次の 2 つの手順が、サンプル ディレクトリにある RemoveNetTcpSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  管理者レベルのコマンド プロンプト ウィンドウで次のコマンドを実行して、有効なプロトコルの一覧から net.tcp を削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app   
+        "Default Web Site/servicemodelsamples<WCF Application>" " /enabledProtocols:http  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+    2.  権限のレベルが高いコマンド プロンプト ウィンドウで次のコマンドを実行して、net.tcp サイト バインディングを削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"   
+        --bindings.[protocol='net.tcp',bindingInformation='808:*']  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+### 有効なプロトコルの一覧から net.tcp を削除するには  
+  
+1.  有効なプロトコルの一覧から net.tcp を削除するには、管理者レベルのコマンド プロンプト ウィンドウで次のコマンドを実行します。  
+  
+    ```  
+    %windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples<WCF Application>" " /enabledProtocols:http  
+    ```  
+  
+    > [!NOTE]
+    >  このコマンドはテキスト 1 行です。  
+  
+### net.tcp サイト バインディングを削除するには  
+  
+1.  net.tcp サイト バインディングを削除するには、管理者レベルのコマンド プロンプト ウィンドウで次のコマンドを実行します。  
+  
+    ```  
+    %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"   
+    -bindings.[protocol='net.tcp',bindingInformation='808:*']  
+    ```  
+  
+    > [!NOTE]
+    >  このコマンドはテキスト 1 行です。  
+  
+## 参照  
+ [TCP アクティベーション](../../../../docs/framework/wcf/samples/tcp-activation.md)   
+ [MSMQ アクティベーション](../../../../docs/framework/wcf/samples/msmq-activation.md)   
+ [NamedPipe アクティベーション](../../../../docs/framework/wcf/samples/namedpipe-activation.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-make-x-509-certificates-accessible-to-wcf.md b/docs/framework/wcf/feature-details/how-to-make-x-509-certificates-accessible-to-wcf.md
new file mode 100644
index 00000000000..f4584731ec0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-make-x-509-certificates-accessible-to-wcf.md
@@ -0,0 +1,80 @@
+---
+title: "方法 : X.509 証明書を WCF からアクセス可能にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], X.509 証明書を WCF からアクセス可能にする"
+  - "X.509 証明書 [WCF]"
+  - "X.509 証明書 [WCF], WCF からアクセス可能にする"
+ms.assetid: a54e407c-c2b5-4319-a648-60e43413664b
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 方法 : X.509 証明書を WCF からアクセス可能にする
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] から X.509 証明書にアクセスできるようにするには、アプリケーション コードで証明書ストアの名前と場所を指定する必要があります。特定の状況では、X.509 証明書に関連付けられた秘密キーを格納しているファイルにプロセス ID がアクセスできる必要があります。証明書ストア内の X.509 証明書に関連付けられている秘密キーを取得するには、それを行うためのアクセス許可が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に必要になります。既定では、所有者と System アカウントだけが証明書の秘密キーにアクセスできます。  
+  
+### X.509 証明書を WCF からアクセス可能にするには  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実行されているアカウントに対して、X.509 証明書に関連付けられている秘密キーを格納しているファイルへの読み取りアクセス権を与えます。  
+  
+    1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に X.509 証明書の秘密キーへの読み取りアクセス権が必要かどうかを判断します。  
+  
+         次の表は、X.509 証明書を使用する際に秘密キーを使用できる必要があるかどうかを示しています。  
+  
+        |X.509 証明書の使用法|秘密キー|  
+        |-------------------|----------|  
+        |送信 SOAP メッセージにデジタル署名する。|必要|  
+        |受信 SOAP メッセージの署名を検証する。|不要|  
+        |送信 SOAP メッセージを暗号化する。|不要|  
+        |受信 SOAP メッセージを復号化する。|必要|  
+  
+    2.  証明書が格納されている証明書ストアの場所と名前を決定します。  
+  
+         証明書が格納されている証明書ストアは、アプリケーション コードまたは構成で指定します。たとえば、次の例では、証明書が `My` という名前の `CurrentUser` 証明書ストア内に存在することを指定します。  
+  
+         [!code-csharp[x509Accessible#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/x509accessible/cs/source.cs#1)]
+         [!code-vb[x509Accessible#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/x509accessible/vb/source.vb#1)]  
+  
+    3.  [FindPrivateKey](../../../../docs/framework/wcf/samples/findprivatekey.md) ツールを使用して、証明書の秘密キーがコンピューター上のどこに存在するかを確認します。  
+  
+         [FindPrivateKey](../../../../docs/framework/wcf/samples/findprivatekey.md) ツールには、証明書ストアの名前、証明書ストアの場所、および証明書を一意に識別する情報を指定する必要があります。このツールは、証明書のサブジェクト名または拇印を一意の識別子として受け入れます。証明書の拇印の確認方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 証明書のサムプリントを取得する](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)」を参照してください。  
+  
+         次のコード例では、[FindPrivateKey](../../../../docs/framework/wcf/samples/findprivatekey.md) ツールを使用して、`CurrentUser` の `My` ストア内に存在する、拇印 `46 dd 0e 7a ed 0b 7a 31 9b 02 a3 a0 43 7a d8 3f 60 40 92 9d` を持つ証明書の秘密キーの場所を特定します。  
+  
+        ```  
+        findprivatekey.exe My CurrentUser -t "46 dd 0e 7a ed 0b 7a 31 9b 02 a3 a0 43 7a d8 3f 60 40 92 9d" -a  
+        ```  
+  
+    4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実行されているアカウントを確認します。  
+  
+         次の表は、特定のシナリオで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実行されているアカウントの詳細を示しています。  
+  
+        |シナリオ|プロセス ID|  
+        |----------|-------------|  
+        |クライアント \(コンソールまたは WinForms アプリケーション\)|現在ログインしているユーザー|  
+        |自己ホスト型のサービス|現在ログインしているユーザー|  
+        |IIS 6.0 \([!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]\) または IIS 7.0 \([!INCLUDE[wv](../../../../includes/wv-md.md)]\) でホストされているサービス|NETWORK SERVICE|  
+        |IIS 5.X \([!INCLUDE[wxp](../../../../includes/wxp-md.md)]\) でホストされているサービス|Machine.config ファイル内の `<processModel>` 要素によって制御されます。既定のアカウントは ASPNET です。|  
+  
+    5.  cacls.exe などのツールを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実行されているアカウントに、秘密キーを格納しているファイルへの読み取りアクセス権を与えます。  
+  
+         次のコード例では、指定したファイルのアクセス制御リスト \(ACL\) を編集 \(\/E\) して、NETWORK SERVICE アカウントにそのファイルへの読み取り \(R\) アクセス権を与えます。  
+  
+        ```  
+        cacls.exe "C:\Documents and Settings\All Users\Application Data\Microsoft\Crypto\RSA\MachineKeys\8aeda5eb81555f14f8f9960745b5a40d_38f7de48-5ee9-452d-8a5a-92789d7110b1" /E /G "NETWORK SERVICE":R  
+        ```  
+  
+## 参照  
+ [FindPrivateKey](../../../../docs/framework/wcf/samples/findprivatekey.md)   
+ [方法 : 証明書のサムプリントを取得する](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md b/docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md
new file mode 100644
index 00000000000..ce79671d736
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md
@@ -0,0 +1,223 @@
+---
+title: "方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1428df4d-b18f-4e6d-bd4d-79ab3dd5147c
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する
+ここでは、基本的な ASP.NET AJAX サービスを同等の AJAX 対応 [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに移行する手順の概要を説明します。  ここでは、ASP.NET AJAX サービスの、機能的に同等の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バージョンを作成する方法を示します。  この 2 つのサービスを並行して使用することも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを ASP.NET AJAX サービスと置き換えて使用することもできます。  
+  
+ 既存の ASP.NET AJAX サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] AJAX サービスに移行すると、次のような利点が得られます。  
+  
+-   最小限の追加構成で、AJAX サービスを SOAP サービスとして公開できます。  
+  
+-   トレースなどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の機能の利点が得られます。  
+  
+ 次の手順では、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] が使用されていることを前提としています。  
+  
+ 手順に続く例で、ここで説明する手順によって作成されるコードを示します。  
+  
+ AJAX 対応エンドポイントを介した [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの公開[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)」トピックを参照してください。  
+  
+### ASP.NET Web サービス アプリケーションを作成してテストする  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を開きます。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をクリックし、**\[プロジェクト\]**、**\[Web\]** の順にクリックして、**\[ASP.NET Web サービス アプリケーション\]** をクリックします。  
+  
+3.  プロジェクトに「`ASPHello`」という名前を付け、**\[OK\]** をクリックます。  
+  
+4.  Service1.asmx.cs ファイルで、`System.Web.Script.Services.ScriptService]` が含まれた行のコメントを解除し、このサービスに対して AJAX を有効にします。  
+  
+5.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+6.  **\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックします。  
+  
+7.  生成された Web ページで、`HelloWorld` 操作を選択します。  
+  
+8.  テスト ページで、`HelloWorld`**\[起動\]** をクリックします。  次の XML 応答を受信します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <string xmlns="http://tempuri.org/">Hello World</string>  
+    ```  
+  
+9. この応答は、ASP.NET AJAX サービスが現在機能していること、およびこのサービスが現在 Service1.asmx\/HelloWorld でエンドポイントを公開していることを確認するものです。このエンドポイントが HTTP POST 要求に応答し、XML を返します。  
+  
+     これで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] AJAX サービスを使用するために、このサービスを変換する準備ができました。  
+  
+### 同等の WCF AJAX サービス アプリケーションを作成するには  
+  
+1.  **ASPHello** プロジェクトを右クリックして、**\[追加\]**、**\[新しい項目\]** の順にクリックして、**\[AJAX 対応 WCF サービス\]** をクリックします。  
+  
+2.  サービスに「`WCFHello`」という名前を付けて、**\[追加\]** をクリックします。  
+  
+3.  WCFHello.svc.cs ファイルを開きます。  
+  
+4.  Service1.asmx.cs から、`HelloWorld` 操作の次の実装をコピーします。  
+  
+    ```  
+    public string HelloWorld()  
+    {  
+         return "Hello World";  
+    }  
+    ```  
+  
+5.  コピーした `HelloWorld` 操作の実装を、WCFHello.svc.cs ファイルの次のコードの代わりに貼り付けます。  
+  
+    ```  
+    public void DoWork()  
+    {  
+          // Add your operation implementation here  
+          return;  
+    }  
+    ```  
+  
+6.  `Namespace` の <xref:System.ServiceModel.ServiceContractAttribute> 属性を `WCFHello` に指定します。  
+  
+    ```  
+    [ServiceContract(Namespace="WCFHello")]  
+    [AspNetCompatibilityRequirements(RequirementsMode=AspNetCompatibilityRequirementsMode.Required)]  
+    public class WCFHello  
+    { … }  
+    ```  
+  
+7.  <xref:System.ServiceModel.Web.WebInvokeAttribute> を `HelloWorld` 操作に追加し、<xref:System.ServiceModel.Web.WebInvokeAttribute.ResponseFormat%2A> を返すように <xref:System.ServiceModel.Web.WebMessageFormat> プロパティを設定します。  この設定を行わない場合、既定の戻り値の型は <xref:System.ServiceModel.Web.WebMessageFormat> です。  
+  
+    ```  
+    [OperationContract]  
+    [WebInvoke(ResponseFormat=WebMessageFormat.Xml)]  
+    public string HelloWorld()  
+    {  
+        return "Hello World";  
+    }  
+    ```  
+  
+8.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+9. WCFHello.svc ファイルを開き、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックします。  
+  
+10. 現在、サービスは、`WCFHello.svc/HelloWorld` でエンドポイントを公開しています。このエンドポイントが HTTP POST 要求に応答します。  HTTP POST 要求をブラウザーからテストすることはできませんが、エンドポイントは次の XML を返します。  
+  
+    ```  
+    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">Hello World</string>  
+    ```  
+  
+11. これで、`WCFHello.svc/HelloWorld` エンドポイントと `Service1.aspx/HelloWorld` エンドポイントは機能的に同等になりました。  
+  
+## 使用例  
+ このトピックで説明した手順によって作成されるコードを次の例に示します。  
+  
+```  
+//This is the ASP.NET code in the Service1.asmx.cs file.  
+  
+using System;  
+using System.Collections;  
+using System.ComponentModel;  
+using System.Data;  
+using System.Linq;  
+using System.Web;  
+using System.Web.Services;  
+using System.Web.Services.Protocols;  
+using System.Xml.Linq;  
+using System.Web.Script.Services;  
+  
+namespace ASPHello  
+{  
+    /// <summary>  
+    /// Summary description for Service1.  
+    /// </summary>  
+    [WebService(Namespace = "http://tempuri.org/")]  
+    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]  
+    [ToolboxItem(false)]  
+    // To allow this Web Service to be called from script, using ASP.NET AJAX, uncomment the following line.   
+    [System.Web.Script.Services.ScriptService]  
+    public class Service1 : System.Web.Services.WebService  
+    {  
+  
+        [WebMethod]  
+        public string HelloWorld()  
+        {  
+            return "Hello World";  
+        }  
+    }  
+}   
+  
+//This is the WCF code in the WCFHello.svc.cs file.  
+using System;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Activation;  
+using System.ServiceModel.Web;  
+  
+namespace ASPHello  
+{  
+    [ServiceContract(Namespace = "WCFHello")]  
+    [AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]  
+    public class WCFHello  
+    {  
+        // Add [WebInvoke] attribute to use HTTP GET.  
+        [OperationContract]  
+        [WebInvoke(ResponseFormat=WebMessageFormat.Xml)]  
+        public string HelloWorld()  
+        {  
+            return "Hello World";  
+        }  
+  
+        // Add more operations here and mark them with [OperationContract].  
+    }  
+}  
+```  
+  
+ <xref:System.Xml.XmlDocument> 型は、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> によってシリアル化できないため、<xref:System.Xml.Serialization.XmlSerializer> ではサポートされていません。  <xref:System.Xml.Linq.XDocument> 型を使用するか、<xref:System.Xml.XmlDocument.DocumentElement%2A> をシリアル化します。  
+  
+ ASMX Web サービスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと並行してアップグレードおよび移行される場合は、クライアントで 2 つの型を同じ名前に割り当てないようにします。  同じ名前が割り当てられていると、<xref:System.Web.Services.WebMethodAttribute> と <xref:System.ServiceModel.ServiceContractAttribute> で同じ型が使用されている場合に、シリアライザーで次のような例外が発生します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが先に追加された場合は、ASMX Web サービスでメソッドを呼び出すと、<xref:System.Web.UI.ObjectConverter.ConvertValue%28System.Object%2CSystem.Type%2CSystem.String%29> で例外が発生します。これは、プロキシでの順序の定義で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] スタイル定義が優先されるためです。  
+  
+-   ASMX Web サービスが先に追加された場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでメソッドを呼び出すと、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> で例外が発生します。これは、プロキシでの順序の定義で Web サービス スタイル定義が優先されるためです。  
+  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> と ASP.NET AJAX <xref:System.Web.Script.Serialization.JavascriptSerializer> の動作には大きな違いがあります。  たとえば、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> はディクショナリをキーと値のペアの配列として表しますが、ASP.NET AJAX <xref:System.Web.Script.Serialization.JavascriptSerializer> はディクショナリを実際の JSON オブジェクトとして表します。  したがって、ASP.NET AJAX では、ディクショナリが次のように表されます。  
+  
+```  
+Dictionary<string, int> d = new Dictionary<string, int>();  
+d.Add(“one”, 1);  
+d.Add(“two”, 2);  
+```  
+  
+ このディクショナリは、JSON オブジェクトでは次のように表されます。  
+  
+-   <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> では \[{"Key":"one","Value":1},{"Key":"two","Value":2}\] と表され、  
+  
+-   ASP.NET AJAX <xref:System.Web.Script.Serialization.JavascriptSerializer> では、{“one”:1,”two”:2} と表されます。  
+  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> は、キーの種類が文字列ではないディクショナリを処理でき、<xref:System.Web.Script.Serialization.JavascriptSerializer> はできません。この点で前者はより強力と言えます。  しかし、後者の方が JSON で使いやすいと言えます。  
+  
+ これらのシリアライザーの主な違いを次の表に示します。  
+  
+|相違点のカテゴリ|DataContractJsonSerializer|ASP.NET AJAX JavaScriptSerializer|  
+|--------------|--------------------------------|---------------------------------------|  
+|空きバッファー \(新しい byte\[0\]\) の <xref:System.Object> \(または <xref:System.Uri>、あるいは他の一部のクラス\) への逆シリアル化|SerializationException|null|  
+|<xref:System.DBNull.Value> のシリアル化|{} \(or {"\_\_type":"\#System"}\)|Null|  
+|\[Serializable\] 型のプライベート メンバーのシリアル化|シリアル化できます|シリアル化できません|  
+|<xref:System.Runtime.Serialization.ISerializable> 型のパブリック プロパティのシリアル化|シリアル化できません|シリアル化できます|  
+|JSON の「拡張機能」|オブジェクト メンバー名で引用符を必要とする \({"a":"hello"}\) JSON 仕様に準拠しています。|引用符のないオブジェクト メンバー名 \({a:"hello"}\) をサポートします。|  
+|<xref:System.DateTime> 協定世界時刻 \(UTC\)|"\\\/Date\(123456789U\)\\\/" 形式または "\\\/Date\\\(\\d\+\(U&#124;\(\\\+\\\-\[\\d{4}\]\)\)?  \\\)\\\\\/\)" 形式をサポートしません。|DateTime 値として、"\\\/Date\(123456789U\)\\\/" 形式と "\\\/Date\\\(\\d\+\(U&#124;\(\\\+\\\-\[\\d{4}\]\)\)?  \\\)\\\\\/\)" 形式をサポートします。|  
+|ディクショナリの表現|KeyValuePair\<K,V\> の配列。文字列以外の種類のキーを処理します。|実際の JSON オブジェクトですが、文字列の種類のキーのみ処理します。|  
+|エスケープ文字|必ず、エスケープ文字であるスラッシュ \(\/\) を付けます。"\\n" などのエスケープされない無効な JSON 文字は使用できません。|DateTime 値には、エスケープ文字スラッシュ \(\/\) を付けます。|  
+  
+## 参照  
+ [方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-obtain-a-certificate-wcf.md b/docs/framework/wcf/feature-details/how-to-obtain-a-certificate-wcf.md
new file mode 100644
index 00000000000..6d23f72d519
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-obtain-a-certificate-wcf.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 証明書 (WCF) を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], 取得"
+ms.assetid: d53762fd-15ea-42dc-b0ea-6a6597aa23f7
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : 証明書 (WCF) を取得する
+X.509 証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の機能を使用するには、最初に証明書を取得します。  
+  
+### X.509 証明書を取得するには  
+  
+1.  次のいずれかを選択します。  
+  
+    -   VeriSign, Inc. などの証明機関から証明書を購入します。  
+  
+    -   独自の証明書サービスを設定し、証明機関に証明書への署名を依頼します。  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、Windows 2000 Server、Windows 2000 Server Datacenter、および Windows 2000 Datacenter Server にはすべて、公開キー基盤 \(PKI\) をサポートする証明書サービスが用意されています。  Windows Server 2008 で、「[Active Directory 証明書サービスの概要](http://go.microsoft.com/fwlink/?LinkID=153483)」 ロールを使用して証明機関を管理します。  
+  
+    -   独自の証明書サービスを設定し、証明書には署名しません。  
+  
+    > [!NOTE]
+    >  どの方法を使用する場合でも、X.509 証明書を含む SOAP 要求の受信者は、その X.509 証明書を信頼する必要があります。  つまり、証明書チェーン内の X.509 証明書または発行者は、信頼されたユーザーの証明書ストア内に存在し、また X.509 証明書は信頼されない証明書ストア内には存在しないということを意味します。  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md b/docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md
new file mode 100644
index 00000000000..ed75887962a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md
@@ -0,0 +1,356 @@
+---
+title: "プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f7ae7ab-6fc8-4769-9730-c14d43f7b9b1
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法
+このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを探索可能にする方法について説明します。 基にして、[自己ホスト](http://go.microsoft.com/fwlink/?LinkId=145523)サンプルです。  
+  
+### <a name="to-configure-the-existing-self-host-service-sample-for-discovery"></a>既存の自己ホスト サービス サンプルを探索用に構成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で自己ホスト ソリューションを開きます。 このサンプルは、TechnologySamples\Basic\Service\Hosting\SelfHost ディレクトリにあります。  
+  
+2.  `System.ServiceModel.Discovery.dll` への参照をサービス プロジェクトに追加します。 "System. ServiceModel.Discovery.dll またはその依存関係の&1; つの以降のバージョンが必要です、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]プロジェクト... に指定されているよりも" ソリューション エクスプ ローラーでプロジェクトを右クリックして、このメッセージを表示する場合は**プロパティ**します。 **プロジェクトのプロパティ**ウィンドウことを確認して、**ターゲット フレームワーク**は[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)]です。  
+  
+3.  Service.cs ファイルを開き、次の `using` ステートメントを追加します。  
+  
+    ```  
+    using System.ServiceModel.Discovery;  
+    ```  
+  
+4.  `Main()`メソッド内で、`using`ステートメントを追加、 <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior>をサービス ホストのインスタンス。  
+  
+    ```  
+    public static void Main()  
+    {  
+        // Create a ServiceHost for the CalculatorService type.  
+        using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))  
+        {  
+            // Add a ServiceDiscoveryBehavior  
+            serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());                  
+  
+            // ...  
+        }  
+    }  
+    ```  
+  
+     <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior>に適用されたサービスが探索可能なことを指定します。  
+  
+5.  追加、 <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> 、サービス ホストを追加するコードの直後後に、 <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior>します。  
+  
+    ```  
+    // Add ServiceDiscoveryBehavior  
+    serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());  
+  
+    // Add a UdpDiscoveryEndpoint  
+    serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());  
+    ```  
+  
+     このコードは、探索メッセージを標準の UDP 探索エンドポイントに送信する必要があることを指定します。  
+  
+### <a name="to-create-a-client-application-that-uses-discovery-to-call-the-service"></a>探索を使用してサービスを呼び出すクライアント アプリケーションを作成するには  
+  
+1.  新しいコンソール アプリケーションを `DiscoveryClientApp` というソリューションに追加します。  
+  
+2.  `System.ServiceModel.dll` および `System.ServiceModel.Discovery.dll` への参照を追加します。  
+  
+3.  GeneratedClient.cs ファイルおよび App.config ファイルを、既存のクライアント プロジェクトから新しい DiscoveryClientApp プロジェクトに追加します。 これを行うには、内のファイルを右クリックし、**ソリューション エクスプ ローラー**を選択**コピー**、クリックして、 **DiscoveryClientApp**プロジェクトを右クリックして選択**貼り付け**します。  
+  
+4.  Program.cs を開きます。  
+  
+5.  次の `using` ステートメントを追加します。  
+  
+    ```  
+    using System.ServiceModel;  
+    using System.ServiceModel.Discovery;  
+    using Microsoft.ServiceModel.Samples;  
+  
+    ```  
+  
+6.  `FindCalculatorServiceAddress()` という静的メソッドを `Program` クラスに追加します。  
+  
+    ```  
+    static EndpointAddress FindCalculatorServiceAddress()  
+    {  
+    }  
+    ```  
+  
+     このメソッドは、探索を使用して `CalculatorService` サービスを検索します。  
+  
+7.  内部、`FindCalculatorServiceAddress`メソッドを新規作成<xref:System.ServiceModel.Discovery.DiscoveryClient>を渡して、インスタンス、 <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>コンス トラクターにします。  
+  
+    ```  
+    static EndpointAddress FindCalculatorServiceAddress()  
+    {  
+        // Create DiscoveryClient  
+        DiscoveryClient discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint());  
+    }  
+    ```  
+  
+     これにより[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を<xref:System.ServiceModel.Discovery.DiscoveryClient>クラスは、標準の UDP 探索エンドポイントを使用して探索メッセージを送受信する必要があります。  
+  
+8.  次の行で、<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A>メソッドを指定し、 <xref:System.ServiceModel.Discovery.FindCriteria>を検索する対象のサービス コントラクトを格納しているインスタンス。 ここでは、`ICalculator` を指定します。  
+  
+    ```  
+    // Find ICalculatorService endpoints              
+    FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculator)));  
+    ```  
+  
+9. 呼び出しの後に<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A>、少なくとも&1; つの一致するサービスがないかどうかを確認し、返す、 <xref:System.ServiceModel.EndpointAddress>最初に一致するサービスのです。 一致するサービスがない場合は `null` を返します。  
+  
+    ```  
+    if (findResponse.Endpoints.Count > 0)  
+    {  
+        return findResponse.Endpoints[0].Address;  
+    }  
+    else  
+    {  
+        return null;  
+    }  
+    ```  
+  
+10. `InvokeCalculatorService` という名前の静的メソッドを `Program` クラスに追加します。  
+  
+    ```  
+    static void InvokeCalculatorService(EndpointAddress endpointAddress)  
+    {  
+    }  
+    ```  
+  
+     このメソッドは、`FindCalculatorServiceAddress` から返されたエンドポイント アドレスを使用して、電卓サービスを呼び出します。  
+  
+11. `InvokeCalculatorService` メソッド内で、`CalculatorServiceClient` クラスのインスタンスを作成します。 このクラスは、[自己ホスト](http://go.microsoft.com/fwlink/?LinkId=145523)サンプルです。 これは、Svcutil.exe を使用して生成されました。  
+  
+    ```  
+    // Create a client  
+    CalculatorClient client = new CalculatorClient();  
+    ```  
+  
+12. 次の行では、クライアントのエンドポイント アドレスを、`FindCalculatorServiceAddress()` から返されたエンドポイント アドレスに設定します。  
+  
+    ```  
+    // Connect to the discovered service endpoint  
+    client.Endpoint.Address = endpointAddress;  
+    ```  
+  
+13. 前の手順のコードの直後に、電卓サービスで公開されたメソッドを呼び出します。  
+  
+    ```  
+    Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress);  
+  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+  
+    // Call the Add service operation.  
+    double result = client.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Subtract service operation.  
+    result = client.Subtract(value1, value2);  
+    Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Multiply service operation.  
+    result = client.Multiply(value1, value2);  
+    Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Divide service operation.  
+    result = client.Divide(value1, value2);  
+    Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+    Console.WriteLine();  
+  
+    //Closing the client gracefully closes the connection and cleans up resources  
+    client.Close();  
+    ```  
+  
+14. `Main()` クラスの `Program` メソッドにコードを追加して、`FindCalculatorServiceAddress` を呼び出します。  
+  
+    ```  
+    public static void Main()  
+    {  
+        EndpointAddress endpointAddress = FindCalculatorServiceAddress();  
+    }  
+    ```  
+  
+15. 次の行では、`InvokeCalculatorService()` を呼び出し、`FindCalculatorServiceAddress()` から返されたエンドポイント アドレスを渡します。  
+  
+    ```  
+    if (endpointAddress != null)  
+    {  
+        InvokeCalculatorService(endpointAddress);  
+    }  
+  
+    Console.WriteLine("Press <ENTER> to exit.");  
+    Console.ReadLine();  
+    ```  
+  
+### <a name="to-test-the-application"></a>アプリケーションをテストするには  
+  
+1.  権限のレベルが高いコマンド プロンプトを開き、Service.exe を実行します。  
+  
+2.  コマンド プロンプトを開き、Discoveryclientapp.exe を実行します。  
+  
+3.  Service.exe からの出力は次のようになります。  
+  
+    ```Output  
+    Received Add(100,15.99)  
+    Return: 115.99  
+    Received Subtract(100,15.99)  
+    Return: 84.01  
+    Received Multiply(100,15.99)  
+    Return: 1599  
+    Received Divide(100,15.99)  
+    Return: 6.25390869293308  
+    ```  
+  
+4.  Discoveryclientapp.exe からの出力は次のようになります。  
+  
+    ```Output  
+    Invoking CalculatorService at http://localhost:8000/ServiceModelSamples/service  
+    Add(100,15.99) = 115.99  
+    Subtract(100,15.99) = 84.01  
+    Multiply(100,15.99) = 1599  
+    Divide(100,15.99) = 6.25390869293308  
+  
+    Press <ENTER> to exit.  
+    ```  
+  
+## <a name="example"></a>例  
+ このサンプルで使用されているコード全体の一覧を次に示します。 このコードに基づいているため、[自己ホスト](http://go.microsoft.com/fwlink/?LinkId=145523)サンプルを変更されているファイルのみが一覧表示します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]自己ホスト サンプルを参照してください[のセットアップ手順](http://go.microsoft.com/fwlink/?LinkId=145522)します。  
+  
+```  
+  
+// Service.cs  
+using System;  
+using System.Configuration;  
+using System.ServiceModel;  
+using System.ServiceModel.Discovery;  
+  
+namespace Microsoft.ServiceModel.Samples  
+{  
+    // See SelfHost sample for service contract and implementation  
+    // ...  
+  
+        // Host the service within this EXE console application.  
+        public static void Main()  
+        {  
+            // Create a ServiceHost for the CalculatorService type.  
+            using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService)))  
+            {  
+                // Add the ServiceDiscoveryBehavior to make the service discoverable  
+                serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());  
+                serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());  
+  
+                // Open the ServiceHost to create listeners and start listening for messages.  
+                serviceHost.Open();  
+  
+                // The service can now be accessed.  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+            }  
+        }  
+    }  
+}  
+```  
+  
+```  
+// Program.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.ServiceModel;  
+using System.ServiceModel.Discovery;  
+using Microsoft.ServiceModel.Samples;  
+using System.Text;  
+  
+namespace DiscoveryClientApp  
+{  
+    class Program  
+    {  
+        static EndpointAddress FindCalculatorServiceAddress()  
+        {  
+            // Create DiscoveryClient  
+            DiscoveryClient discoveryClient = new DiscoveryClient(new UdpDiscoveryEndpoint());  
+  
+            // Find ICalculatorService endpoints              
+            FindResponse findResponse = discoveryClient.Find(new FindCriteria(typeof(ICalculator)));  
+  
+            if (findResponse.Endpoints.Count > 0)  
+            {  
+                return findResponse.Endpoints[0].Address;  
+            }  
+            else  
+            {  
+                return null;  
+            }  
+        }  
+  
+        static void InvokeCalculatorService(EndpointAddress endpointAddress)  
+        {  
+            // Create a client  
+            CalculatorClient client = new CalculatorClient();  
+  
+            // Connect to the discovered service endpoint  
+            client.Endpoint.Address = endpointAddress;  
+  
+            Console.WriteLine("Invoking CalculatorService at {0}", endpointAddress);  
+  
+            double value1 = 100.00D;  
+            double value2 = 15.99D;  
+  
+            // Call the Add service operation.  
+            double result = client.Add(value1, value2);  
+            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Subtract service operation.  
+            result = client.Subtract(value1, value2);  
+            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Multiply service operation.  
+            result = client.Multiply(value1, value2);  
+            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Divide service operation.  
+            result = client.Divide(value1, value2);  
+            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+            Console.WriteLine();  
+  
+            //Closing the client gracefully closes the connection and cleans up resources  
+            client.Close();  
+        }  
+        static void Main(string[] args)  
+        {  
+            EndpointAddress endpointAddress = FindCalculatorServiceAddress();  
+  
+            if (endpointAddress != null)  
+            {  
+                InvokeCalculatorService(endpointAddress);  
+            }  
+  
+            Console.WriteLine("Press <ENTER> to exit.");  
+            Console.ReadLine();  
+  
+        }  
+    }  
+}  
+```  
+  
+<!-- TODO: review snippet reference  [!CODE [Microsoft.Win32.RegistryKey#4](Microsoft.Win32.RegistryKey#4)]  -->  
+  
+## <a name="see-also"></a>関連項目  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [WCF Discovery オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-discovery-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md b/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md
new file mode 100644
index 00000000000..da58ecff190
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md
@@ -0,0 +1,282 @@
+---
+title: "方法: 構成ファイルを使用してサービスのメタデータを公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f061443f-92df-4824-b36a-609c4cd14a17
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 方法: 構成ファイルを使用してサービスのメタデータを公開する
+このトピックは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスのメタデータを公開する手段を示す&2; つの「方法」トピックのうちの&1; つです。 構成ファイルとコードを使用して、サービスがメタデータを公開する手段を指定する方法は&2; つあります。 このトピックでは、構成ファイルを使用してサービスのメタデータを公開する方法について説明します。  
+  
+> [!CAUTION]
+>  このトピックでは、セキュリティで保護されていない方法でメタデータを公開する方法について説明します。 クライアントは、サービスからメタデータを取得できます。 安全な方法でメタデータを公開するサービスを必要とする場合は、次を参照してください。[カスタム セキュリティで保護されたメタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)します。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]コードでは、メタデータの公開を参照してください[方法: サービスを使用してコードのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)します。 メタデータを公開すると、クライアントが `?wsdl` クエリ文字列を使用した WS-Transfer GET 要求または HTTP/GET 要求によりメタデータを取得できるようになります。 コードが機能するかどうかを確認するために、基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成します。 簡略化のため、次のコードに基本的な自己ホスト型サービスが用意されています。  
+  
+```csharp  
+using System;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Description;  
+  
+namespace Metadata.Samples  
+{  
+    [ServiceContract]  
+    public interface ISimpleService  
+    {  
+        [OperationContract]  
+        string SimpleMethod(string msg);  
+    }  
+  
+    class SimpleService : ISimpleService  
+    {  
+        public string SimpleMethod(string msg)  
+        {  
+            Console.WriteLine("The caller passed in " + msg);  
+            return "Hello " + msg;  
+        }  
+    }  
+  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            ServiceHost host = new ServiceHost(typeof(SimpleService),  
+                new Uri("http://localhost:8001/MetadataSample"));   
+            try  
+            {  
+                // Open the service host to accept incoming calls  
+                host.Open();  
+  
+                // The service can now be accessed.  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+                // Close the ServiceHostBase to shutdown the service.  
+                host.Close();  
+            }  
+            catch (CommunicationException commProblem)  
+            {  
+                Console.WriteLine("There was a communication problem. " + commProblem.Message);  
+                Console.Read();  
+            }  
+        }  
+    }  
+}  
+```  
+  
+ これは、構成ファイルを使用して構成された自己ホスト型サービスです。 以下の構成ファイルをベースとして使用します。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Metadata.Example.SimpleService">  
+        <endpoint address=""  
+                  binding="basicHttpBinding"  
+                  contract="Metadata.Example.ISimpleService" />  
+      </service>  
+    </services>  
+    <behaviors>  
+  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### <a name="to-publish-metadata-for-a-wcf-service-using-an-application-configuration-file"></a>アプリケーション構成ファイルを使用して WCF サービスのメタデータを公開するには  
+  
+1.  
+          `</services>` 要素を閉じた後、App.config ファイル内に `<behaviors>` 要素を作成します。  
+  
+  
+  
+2.  
+          `<behaviors>` 要素内に `<serviceBehaviors>` 要素を追加します。  
+  
+  
+  
+3.  
+          `<behavior>`要素に `<serviceBehaviors>` 要素を追加し、`name` 要素の `<behavior>` 属性に値を指定します。  
+  
+  
+  
+4.  
+          `<serviceMetadata>` 要素を `<behavior>` 要素に追加します。 `httpGetEnabled` 属性を `true` に設定し、`policyVersion` 属性を Policy15 に設定します。 `httpGetEnabled` により、サービスは HTTP GET 要求からのメタデータ要求に応答できるようになります。 `policyVersion` は、サービスに対して、WS-Policy 1.5 準拠でメタデータを生成するように指示します。  
+  
+  
+  
+5.  次のコード例に示すように、`behaviorConfiguration` 要素に `<service>` 属性を追加し、手順 1. で追加した `name` 要素の `<behavior>` 属性を指定します。  
+  
+    ```xml  
+    <services>  
+      <service  
+          name="Metadata.Example.SimpleService"  
+          behaviorConfiguration="SimpleServiceBehavior">  
+        ...  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="SimpleServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True" policyVersion="Policy15" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+6.  1 つ以上の `<endpoint>` 要素を追加して、コントラクトを `IMetadataExchange` に設定します。コード例を次に示します。  
+  
+    ```xml  
+    <services>  
+      <service  
+          name="Metadata.Example.SimpleService"  
+          behaviorConfiguration="SimpleServiceBehavior">  
+  
+        <endpoint address=""  
+                  binding="wsHttpBinding"  
+                  contract="Metadata.Example.ISimpleService" />  
+  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+    ```  
+  
+7.  前の手順で追加したメタデータ エンドポイントについて、`binding` 属性に次のいずれかの値を設定します。  
+  
+    -   HTTP 公開の場合、`mexHttpBinding`  
+  
+    -   HTTPS 公開の場合、`mexHttpsBinding`  
+  
+    -   名前付きパイプ公開の場合、`mexNamedPipeBinding`  
+  
+    -   TCP 公開の場合、`mexTcpBinding`  
+  
+8.  前の手順で追加したメタデータ エンドポイントについて、次のいずれかに等しいアドレスを設定します。  
+  
+    -   ベース アドレスがメタデータ バインディングと同じ場合に、公開ポイントとしてホスト アプリケーションのベース アドレスを使用するための空の文字列  
+  
+    -   ホスト アプリケーションにベース アドレスがある場合、相対アドレス  
+  
+    -   絶対アドレス  
+  
+9. コンソール アプリケーションのビルドと実行  
+  
+10. Internet Explorer を使用してサービスのベース アドレス (この例では、http://localhost:8001/MetadataSample) を参照し、メタデータの公開が有効になっていることを確認します。 有効になっていない場合は、"このサービスのメタデータ公開は現在は無効になっています。" というメッセージが結果ページの上部に表示されます。  
+  
+### <a name="to-use-default-endpoints"></a>既定のエンドポイントを使用するには  
+  
+1.  既定のエンドポイントを使用するサービスのメタデータを構成するには、指定、 <xref:System.ServiceModel.Description.ServiceMetadataBehavior>の構成ファイルの前の例のように、任意のエンドポイントを指定しません。 構成ファイルは、次のようになります。  
+  
+    ```xml  
+    <configuration>  
+      <system.serviceModel>  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="SimpleServiceBehavior">  
+              <serviceMetadata httpGetEnabled="True" policyVersion="Policy12" />  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     サービスがあるため、 <xref:System.ServiceModel.Description.ServiceMetadataBehavior>で、`httpGetEnabled`に設定`true`サービスが有効な場合、メタデータの公開、およびエンドポイントが明示的に追加されていないため、ランタイムは既定のエンドポイントを追加します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]既定のエンドポイント、バインディング、および動作を参照してください[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)と[WCF サービスの構成を簡略化](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)します。  
+  
+## <a name="example"></a>例  
+ 次のコード例は、基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実装と、このサービスのメタデータを公開する構成ファイルを示しています。  
+  
+```csharp  
+using System;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.ServiceModel.Description;  
+  
+namespace Metadata.Samples  
+{  
+    [ServiceContract]  
+    public interface ISimpleService  
+    {  
+        [OperationContract]  
+        string SimpleMethod(string msg);  
+    }  
+  
+    class SimpleService : ISimpleService  
+    {  
+        public string SimpleMethod(string msg)  
+        {  
+            Console.WriteLine("The caller passed in " + msg);  
+            return "Hello " + msg;  
+        }  
+    }  
+  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            ServiceHost host = new ServiceHost(typeof(SimpleService),  
+                new Uri("http://localhost:8001/MetadataSample"));   
+            try  
+            {  
+                // Open the service host to accept incoming calls  
+                host.Open();  
+  
+                // The service can now be accessed.  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+                // Close the ServiceHostBase to shutdown the service.  
+                host.Close();  
+            }  
+            catch (CommunicationException commProblem)  
+            {  
+                Console.WriteLine("There was a communication problem. " + commProblem.Message);  
+                Console.Read();  
+            }  
+        }  
+    }  
+}  
+```  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="SimpleServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True" policyVersion="Policy12" />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior>   
+ [方法: マネージ アプリケーションで WCF サービスをホスト](../../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)   
+ [自己ホストします。](../../../../docs/framework/wcf/samples/self-host.md)   
+ [メタデータ アーキテクチャの概要](../../../../docs/framework/wcf/feature-details/metadata-architecture-overview.md)   
+ [メタデータを使用します。](../../../../docs/framework/wcf/feature-details/using-metadata.md)   
+ [方法: コードを使用して、サービスのメタデータを公開](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md b/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md
new file mode 100644
index 00000000000..73597c6f277
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md
@@ -0,0 +1,98 @@
+---
+title: "方法 : コードを使用してサービスのメタデータを公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51407e6d-4d87-42d5-be7c-9887b8652006
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 方法 : コードを使用してサービスのメタデータを公開する
+これは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスのメタデータの公開方法を説明する 2 つの「方法」トピックの 1 つです。構成ファイルとコードを使用して、サービスがメタデータを公開する手段を指定する方法は 2 つあります。このトピックでは、コードを使用してサービスのメタデータを公開する方法について説明します。  
+  
+> [!CAUTION]
+>  このトピックでは、セキュリティで保護されていない方法でメタデータを公開する方法について説明します。クライアントは、サービスからメタデータを取得できます。セキュリティで保護された方法でメタデータを公開するサービスが必要な場合は、[カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md) を参照してください。  
+  
+ 構成ファイル内の公開メタデータ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)」を参照してください。メタデータを公開すると、クライアントが `?wsdl` クエリ文字列を使用した WS\-Transfer GET 要求または HTTP\/GET 要求によりメタデータを取得できるようになります。コードを機能させるには、基本的な WCF サービスを作成する必要があります。次のコードは基本的な自己ホスト型サービスの例です。  
+  
+ [!code-csharp[htPublishMetadataCode#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#0)]
+ [!code-vb[htPublishMetadataCode#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#0)]  
+  
+### コードでメタデータを公開するには  
+  
+1.  コンソール アプリケーションのメイン メソッド内で、サービス型とベース アドレスを渡して <xref:System.ServiceModel.ServiceHost> オブジェクトをインスタンス化します。  
+  
+     [!code-csharp[htPublishMetadataCode#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#1)]
+     [!code-vb[htPublishMetadataCode#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#1)]  
+  
+2.  手順 1. のコードのすぐ下に try ブロックを作成します。これにより、サービスの実行中にスローされる例外がすべてキャッチされます。  
+  
+     [!code-csharp[htPublishMetadataCode#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#2)]
+     [!code-vb[htPublishMetadataCode#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#2)]  
+  
+     [!code-csharp[htPublishMetadataCode#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#3)]
+     [!code-vb[htPublishMetadataCode#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#3)]  
+  
+3.  サービス ホストに <xref:System.ServiceModel.Description.ServiceMetadataBehavior> が含まれているかどうかを確認し、含まれていない場合は、新しい <xref:System.ServiceModel.Description.ServiceMetadataBehavior> インスタンスを作成します。  
+  
+     [!code-csharp[htPublishMetadataCode#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#4)]
+     [!code-vb[htPublishMetadataCode#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#4)]  
+  
+4.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A> プロパティを `true.` に設定します。  
+  
+     [!code-csharp[htPublishMetadataCode#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#5)]
+     [!code-vb[htPublishMetadataCode#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#5)]  
+  
+5.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> には <xref:System.ServiceModel.Description.MetadataExporter> プロパティが含まれています。<xref:System.ServiceModel.Description.MetadataExporter> には <xref:System.ServiceModel.Description.MetadataExporter.PolicyVersion%2A> プロパティが含まれています。<xref:System.ServiceModel.Description.MetadataExporter.PolicyVersion%2A> プロパティの値を <xref:System.ServiceModel.Description.PolicyVersion.Policy15%2A> に設定します。<xref:System.ServiceModel.Description.MetadataExporter.PolicyVersion%2A> プロパティを <xref:System.ServiceModel.Description.PolicyVersion.Policy12%2A> に設定することもできます。<xref:System.ServiceModel.Description.PolicyVersion.Policy15%2A> に設定すると、WS\-Policy 1.5 に準拠したメタデータでポリシー情報がメタデータ エクスポーターによって生成されます。<xref:System.ServiceModel.Description.PolicyVersion.Policy12%2A> に設定すると、WS\-Policy 1.2 に準拠したポリシー情報がメタデータ エクスポーターによって生成されます。  
+  
+     [!code-csharp[htPublishMetadataCode#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#6)]
+     [!code-vb[htPublishMetadataCode#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#6)]  
+  
+6.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> インスタンスをサービス ホストの動作コレクションに追加します。  
+  
+     [!code-csharp[htPublishMetadataCode#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#7)]
+     [!code-vb[htPublishMetadataCode#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#7)]  
+  
+7.  メタデータ交換エンドポイントをサービス ホストに追加します。  
+  
+     [!code-csharp[htPublishMetadataCode#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#8)]
+     [!code-vb[htPublishMetadataCode#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#8)]  
+  
+8.  アプリケーション エンドポイントをサービス ホストに追加します。  
+  
+     [!code-csharp[htPublishMetadataCode#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#9)]
+     [!code-vb[htPublishMetadataCode#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#9)]  
+  
+    > [!NOTE]
+    >  エンドポイントをサービスに追加しない場合、ランタイムによって既定のエンドポイントが追加されます。この例では、サービスには `true` に設定された <xref:System.ServiceModel.Description.ServiceMetadataBehavior> があるので、サービスで公開メタデータも有効化されています。既定のエンドポイント[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+9. サービス ホストを開き、受信呼び出しを待ちます。ユーザーが Enter キーを押すと、サービス ホストが終了します。  
+  
+     [!code-csharp[htPublishMetadataCode#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#10)]
+     [!code-vb[htPublishMetadataCode#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#10)]  
+  
+10. コンソール アプリケーションのビルドと実行  
+  
+11. Internet Explorer を使用してサービスのベース アドレス \(この例では、http:\/\/localhost:8001\/MetadataSample\) を参照し、メタデータの公開が有効になっていることを確認します。上部の "サービスを作成しました" のすぐ下に "Simple Service" と表示された Web ページが表示されます。有効になっていない場合は、"このサービスのメタデータ公開は現在は無効になっています。" というメッセージが結果ページの上部に表示されます。  
+  
+## 使用例  
+ 次のコード例は、コードを使用してサービスのメタデータを公開する基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実装を示しています。  
+  
+ [!code-csharp[htPublishMetadataCode#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/htpublishmetadatacode/cs/program.cs#11)]
+ [!code-vb[htPublishMetadataCode#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/htpublishmetadatacode/vb/program.vb#11)]  
+  
+## 参照  
+ [方法 : マネージ アプリケーションで WCF サービスをホストする](../../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)   
+ [自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)   
+ [メタデータ アーキテクチャの概要](../../../../docs/framework/wcf/feature-details/metadata-architecture-overview.md)   
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md b/docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md
new file mode 100644
index 00000000000..f47e3f63d0e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md
@@ -0,0 +1,114 @@
+---
+title: "方法 : サービス モニカーを登録および構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "COM [WCF], サービス モニカーの構成"
+  - "COM [WCF], サービス モニカーの登録"
+ms.assetid: e5e16c80-8a8e-4eef-af53-564933b651ef
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# 方法 : サービス モニカーを登録および構成する
+COM アプリケーションの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス モニカーを型付きコントラクトで使うには、必要な属性を備えた型を COM に登録し、COM アプリケーションとモニカーに、必要なバインディング設定を組み込まなければなりません。  
+  
+### 必要な属性を備えた型を COM に登録するには  
+  
+1.  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスからメタデータ コントラクトを取得します。  これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アセンブリに組み込むソース コードと、クライアント アプリケーションの構成ファイルが生成されます。  
+  
+2.  アセンブリ内で定義されている型に `ComVisible` という設定をします。  Visual Studio プロジェクトで、AssemblyInfo.cs ファイルに次の属性を追加してください。  
+  
+    ```  
+    [assembly: ComVisible(true)]  
+    ```  
+  
+3.  マネージ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを、厳密な名前のアセンブリとしてコンパイルします。  そのためには暗号キー ペアで署名する必要があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] 『.NET 開発者ガイド』の「[厳密な名前でのアセンブリへの署名](http://go.microsoft.com/fwlink/?LinkId=94874)」を参照してください。  
+  
+4.  アセンブリ登録 \(Regasm.exe\) ツールに `/tlb` オプションを指定して、アセンブリで定義されている型を COM に登録します。  
+  
+5.  グローバル アセンブリ キャッシュ ツール \(Gacutil.exe\) で、グローバル アセンブリ キャッシュにアセンブリを追加します。  
+  
+    > [!NOTE]
+    >  アセンブリへの署名とグローバル アセンブリ キャッシュへの追加は、必須ではありません。しかしこれを済ませておくと、実行時には、適切な場所からアセンブリを読み込むための手順が簡単になります。  
+  
+### COM アプリケーションとモニカーに必要なバインディングを設定するには  
+  
+-   [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で生成したバインディング定義を、クライアント アプリケーションの構成ファイルにコピーします。  たとえば、Visual Basic 6.0 で開発した実行可能ファイルの名前が CallCenterClient.exe の場合、これと同じディレクトリに、CallCenterConfig.exe.config という名前で構成ファイルを作成します。  するとクライアント アプリケーションはモニカーを使えるようになります。  なお、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に組み込まれている標準のバインディング型を使うのであれば、バインディングの設定は必要ありません。  
+  
+     次の型が登録されています。  
+  
+    ```  
+    using System.ServiceModel;  
+  
+    ...  
+  
+    [ServiceContract]   
+    public interface IMathService   
+    {  
+    [OperationContract]  
+    public int Add(int x, int y);  
+    [OperationContract]  
+    public int Subtract(int x, int y);  
+    }  
+    ```  
+  
+     このアプリケーションは、`wsHttpBinding` バインディングを使用して公開されています。  このような型とアプリケーション設定であれば、次のようなモニカー文字列が使用されます。  
+  
+    ```  
+    service4:address=http://localhost/MathService, binding=wsHttpBinding, bindingConfiguration=Binding1  
+  
+    ```  
+  
+     `or`  
+  
+    ```  
+    service4:address=http://localhost/MathService, binding=wsHttpBinding, bindingConfiguration=Binding1, contract={36ADAD5A-A944-4d5c-9B7C-967E4F00A090}  
+  
+    ```  
+  
+     `IMathService` 型を定義するアセンブリへの参照を追加すれば、次のコード例のように、Visual Basic 6.0 アプリケーションに上記のモニカー文字列 \(どちらの形式でも可\) を記述できるようになります。  
+  
+    ```  
+    Dim MathProxy As IMathService  
+    Dim result As Integer  
+  
+    Set MathProxy = GetObject( _  
+            "service4:address=http://localhost/MathService, _  
+            binding=wsHttpBinding, _  
+            bindingConfiguration=Binding1")  
+  
+    result = MathProxy.Add(3, 5)  
+  
+    ```  
+  
+     この例で、バインディング構成 `Binding1` の定義は、クライアント アプリケーションごとに、vb6appname.exe.config など該当する名前の構成ファイルに記述します。  
+  
+    > [!NOTE]
+    >  同様のコードを C\#、C\+\+、およびその他の .NET 言語アプリケーションで使用できます。  
+  
+    > [!NOTE]
+    >  モニカーの形式が正しくないか、サービスを使用できない場合は、`GetObject` を呼び出すと、"構文が無効です" というエラーが返されます。  このエラーが発生した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。  
+  
+     このトピックでは、主に VB 6.0 コードからサービス モニカーを使用する方法について説明していますが、他の言語からサービス モニカーを使用することもできます。  C\+\+ コードからモニカーを使用している場合、次のコードに示すように、Svcutil.exe によって生成されたアセンブリを、"no\_namespace named\_guids raw\_interfaces\_only" と共にインポートする必要があります。  
+  
+    ```  
+    #import "ComTestProxy.tlb" no_namespace named_guids  
+    ```  
+  
+     これにより、インポートされたインターフェイス定義は、すべてのメソッドが `HResult` を返すように変更されます。  他の戻り値は、出力パラメーターに変換されます。  メソッドの実行全体は、同じままです。  このために、プロキシでメソッドを呼び出したときの例外の原因を特定できます。  この機能は C\+\+ コードからのみ使用できます。  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-replace-the-wcf-url-reservation-with-a-restricted-reservation.md b/docs/framework/wcf/feature-details/how-to-replace-the-wcf-url-reservation-with-a-restricted-reservation.md
new file mode 100644
index 00000000000..232d6ae18a6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-replace-the-wcf-url-reservation-with-a-restricted-reservation.md
@@ -0,0 +1,67 @@
+---
+title: "方法: WCF URL 予約を制限付きの予約に置き換える | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2754d223-79fc-4e2b-a6ce-989889f2abfa
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法: WCF URL 予約を制限付きの予約に置き換える
+URL 予約を使用すると、特定の URL または URL セットからメッセージを受信するユーザーを制限できます。予約は、URL テンプレート、アクセス制御リスト \(ACL\)、およびフラグのセットで構成されます。URL テンプレートは、予約の対象となる URL を定義します。URL テンプレートが処理される方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[受信要求のルーティング](http://go.microsoft.com/fwlink/?LinkId=136764)」を参照してください。ACL は、指定された URL からメッセージを受信できるユーザーまたはユーザー グループを制御します。フラグは、その予約で、ユーザーまたはグループに URL を直接リッスンする権限を与えるか、リッスンを他のプロセスに委任する権限を与えるかを指定します。  
+  
+ 既定のオペレーティング システム構成の一部として、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はポート 80 に対してグローバルにアクセス可能な予約を作成します。これにより、すべてのユーザーは、双方向通信にデュアル HTTP バインディングを使用するアプリケーションを実行できます。この予約の ACL はすべてのユーザー向けなので、管理者は URL または URL セットをリッスンする権限を明示的に許可または拒否することはできません。このトピックでは、この予約を削除し、制限された ACL を使用する予約を再作成する方法について説明します。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] または [!INCLUDE[lserver](../../../../includes/lserver-md.md)] では、管理特権でのコマンド プロンプトから「`netsh http show urlacl`」と入力することで、すべての HTTP URL 予約を表示できます。次に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] URL 予約の例を示します。  
+  
+```  
+Reserved URL : http://+:80/Temporary_Listen_Addresses/  
+        User: \Everyone  
+            Listen: Yes  
+            Delegate: No  
+            SDDL: D:(A;;GX;;;WD)  
+```  
+  
+ この予約には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションが双方向通信にデュアル HTTP バインディングを使用する際の URL テンプレートが含まれています。この形式の URL は、デュアル HTTP バインディングを介して通信する際に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントにメッセージを返信するために使用されます。すべてのユーザーに対して、URL をリッスンする権限が与えられていますが、リッスンを他のプロセスに委任する権限は与えられていません。また、ACL は SSDL \(Security Descriptor Definition Language\) で記述されています。SSDL [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SSDL](http://go.microsoft.com/fwlink/?LinkId=136789)」を参照してください。  
+  
+### WCF URL 予約を削除するには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[アクセサリ\]** の順にポイントします。次に、**\[コマンド プロンプト\]** を右クリックし、表示されるコンテキスト メニューで **\[管理者として実行\]** をクリックします。ユーザー アカウント制御 \(UAC\) のウィンドウで、続行するためのアクセス許可を要求された場合は、**\[続行\]** をクリックします。  
+  
+2.  \[コマンド プロンプト\] ウィンドウに「**netsh http delete urlacl url\=http:\/\/\+:80\/Temporary\_Listen\_Addresses\/**」と入力します。  
+  
+3.  予約が正常に削除されると、次のメッセージが表示されます。**URL reservation successfully deleted**  
+  
+## 新しいセキュリティ グループおよび新しい制限付き URL 予約の作成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] URL 予約を制限付きの予約に置き換えるには、まず新しいセキュリティ グループを作成する必要があります。この操作は、コマンド プロンプトを使用する方法か、コンピューターの管理コンソールを使用する方法で行うことができます。行う必要があるのはいずれか一方のみです。  
+  
+#### コマンド プロンプトで新しいセキュリティ グループを作成するには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[アクセサリ\]** の順にポイントします。次に、**\[コマンド プロンプト\]** を右クリックし、表示されるコンテキスト メニューで **\[管理者として実行\]** をクリックします。ユーザー アカウント制御 \(UAC\) のウィンドウで、続行するためのアクセス許可を要求された場合は、**\[続行\]** をクリックします。  
+  
+2.  コマンド プロンプトで、「**net localgroup "\<security group name\>" \/comment:"\<security group description\>" \/add**」と入力します。**\<security group name\>** は作成するセキュリティ グループの名前に、**\<security group description\>** はそのセキュリティ グループに適した説明に置き換えて入力してください。  
+  
+3.  セキュリティ グループが正常に作成されると、次のメッセージが表示されます。**The command completed successfully.**  
+  
+#### コンピューターの管理コンソールで新しいセキュリティ グループを作成するには  
+  
+1.  **\[スタート\]** ボタンをクリックして **\[コントロール パネル\]**、**\[管理ツール\]** の順にポイントし、**\[コンピューターの管理\]** をクリックしてコンピューターの管理コンソールを開きます。ユーザー アカウント制御 \(UAC\) のウィンドウで、続行するためのアクセス許可を要求された場合は、**\[続行\]** をクリックします。  
+  
+2.  **\[システム ツール\]** をクリックして、**\[ローカル ユーザーとグループ\]** をクリックします。次に、**\[グループ\]** フォルダーを右クリックし、表示されるコンテキスト メニューで **\[新しいグループ\]** をクリックします。作成する新しいセキュリティ グループについて、**\[グループ名\]** や **\[説明\]** などの情報を入力し、**\[作成\]** をクリックしてセキュリティ グループを作成します。  
+  
+#### 制限付き URL 予約を作成するには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、**\[アクセサリ\]** の順にポイントします。次に、**\[コマンド プロンプト\]** を右クリックし、表示されるコンテキスト メニューで **\[管理者として実行\]** をクリックします。ユーザー アカウント制御 \(UAC\) のウィンドウで、続行するためのアクセス許可を要求された場合は、**\[続行\]** をクリックします。  
+  
+2.  コマンド プロンプトで、「**netsh http add urlacl url\=http:\/\/\+:80\/Temporary\_Listen\_Addresses\/ user\="\<machine name\>\\\<security group name\>**」と入力します。**\<machine name\>** はグループを作成するコンピューター名に、**\<security group name\>** は上の手順で作成したセキュリティ グループ名に置き換えて入力してください。  
+  
+3.  予約が正常に作成されると、**URL reservation successfully added**.
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md b/docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md
new file mode 100644
index 00000000000..73b0bef9782
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : メタデータの取得および準拠サービスの実装をする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f6f3a2b9-c8aa-4b0b-832c-ec2927bf1163
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : メタデータの取得および準拠サービスの実装をする
+サービスのデザイン担当者と実装担当者が同じであるとは限りません。 アプリケーションの相互運用が重要な環境では、コントラクトを Web サービス記述言語 (WSDL) でデザインまたは記述した場合、開発者はそのコントラクトに準拠するサービスを実装する必要があります。 既存のサービスを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に移行することもできますが、その物理メッセージ フォーマットを維持しなければなりません。 さらに、双方向コントラクトでは、呼び出し元でコールバック コントラクトを実装する必要もあります。  
+  
+ このような場合は、使用する必要があります、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) (または同等のツール) をコントラクトの要件を満たすために実装可能なマネージ言語でサービス コントラクト インターフェイスを生成します。 通常、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)が、チャネル ファクトリを使用するサービス コントラクトを取得するために使用または[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クライアントの種類と同様に、正しいバインディングとアドレスを設定するクライアント構成ファイルもあります。 生成された構成ファイルを使用するには、それをサービスの構成ファイルに変更する必要があります。 また、サービス コントラクトを変更する必要もあります。  
+  
+### <a name="to-retrieve-data-and-implement-a-compliant-service"></a>データを取得して準拠サービスを実装するには  
+  
+1.  使用して、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)メタデータ ファイルまたはコード ファイルを生成するメタデータ エンドポイントに対してです。  
+  
+2.  マークされている (ある場合は&1; つ以上の) で関係のあるインターフェイスが含まれる出力コード ファイルの部分の検索、 <xref:System.ServiceModel.ServiceContractAttribute?displayProperty=fullName>属性です。 次のコード例によって生成された&2; つのインターフェイスを示しています。 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)します。 最初の例 (`ISampleService`) は、準拠サービスを作成するために実装するサービス コントラクト インターフェイスです。 2 番目 (`ISampleServiceChannel`)、サービス コントラクト インターフェイスを拡張するクライアント用のヘルパー インターフェイスですし、 <xref:System.ServiceModel.IClientChannel?displayProperty=fullName>クライアント アプリケーションで使用されます。  
+  
+     [!code-csharp[ClientProxyCodeSample#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/clientproxycodesample/cs/proxycode.cs#2)]  
+  
+3.  WSDL がすべての操作に対する応答アクションを指定していない場合、生成後の操作コントラクトがあります、 <xref:System.ServiceModel.OperationContractAttribute.ReplyAction%2A>プロパティがワイルドカード文字 (*) に設定します。 このプロパティの設定を削除します。 削除しない場合は、サービス コントラクト メタデータを実装するときに、それらの操作のメタデータをエクスポートできません。  
+  
+4.  クラスにインターフェイスを実装してサービスをホストします。 例については、次を参照してください。[方法: サービス コントラクトを実装する](../../../../docs/framework/wcf/how-to-implement-a-wcf-contract.md)、または例」のセクションの下の単純な実装を参照してください。  
+  
+5.  クライアント構成ファイルを[ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)生成されると、変更、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/client.md)構成セクションに、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/services.md)構成セクション。 (生成されたクライアント アプリケーション構成ファイルの例については、次の例を参照してください)。  
+  
+6.  内で、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/services.md)構成セクションで、作成、`name`属性、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/services.md)サービス実装の構成セクション。  
+  
+7.  サービスの `name` 属性をユーザーのサービス実装の構成名に設定します。  
+  
+8.  実装するサービス コントラクトを使用するエンドポイント構成要素をサービス構成セクションに追加します。  
+  
+## <a name="example"></a>例  
+ 次のコード例を実行して、生成されたコード ファイルの大部分を示しています、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)メタデータ ファイルに対してです。  
+  
+ このコードには、次の項目が示されています。  
+  
+-   コントラクトの要件に準拠するサービス コントラクト インターフェイス (実装する場合) (`ISampleService`)。  
+  
+-   サービス コントラクト インターフェイスを拡張するクライアント用のヘルパー インターフェイスと<xref:System.ServiceModel.IClientChannel?displayProperty=fullName>クライアント アプリケーションで使用されます (`ISampleServiceChannel`)。  
+  
+-   拡張するヘルパー クラス<xref:System.ServiceModel.ClientBase%601?displayProperty=fullName>クライアント アプリケーションで使用されます (`SampleServiceClient`)。  
+  
+-   サービスから生成された構成ファイル。  
+  
+-   `ISampleService` サービスの簡単な実装。  
+  
+-   クライアント側の構成ファイルからサービス側バージョンへの変換。  
+  
+ [!code-csharp[ClientProxyCodeSample#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/clientproxycodesample/cs/proxycode.cs#1)]  
+  
+ [!code[ClientProxyCodeSample#10](../../../../samples/snippets/common/VS_Snippets_CFX/clientproxycodesample/common/client.exe.config#10)]
+ [!code-csharp[ClientProxyCodeSample#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/clientproxycodesample/cs/client.exe.config#10)]  
+  
+ [!code-csharp[ClientProxyCodeSample#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/clientproxycodesample/cs/hostapplication.cs#5)]  
+  
+ [!code[ClientProxyCodeSample#20](../../../../samples/snippets/common/VS_Snippets_CFX/clientproxycodesample/common/hostapplication.exe.config#20)]
+ [!code-csharp[ClientProxyCodeSample#20](../../../../samples/snippets/csharp/VS_Snippets_CFX/clientproxycodesample/cs/hostapplication.exe.config#20)]  
+  
+## <a name="see-also"></a>関連項目  
+ [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md b/docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md
new file mode 100644
index 00000000000..cd33b31aeb8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : 証明書のサムプリントを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], サムプリントの取得"
+ms.assetid: da3101aa-78cd-4c34-9652-d1f24777eeab
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法 : 証明書のサムプリントを取得する
+認証に X.509 証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションを記述するときは、多くの場合、証明書に含まれているクレームを指定する必要があります。 たとえば、<xref:System.Security.Cryptography.X509Certificates.X509FindType> メソッドで <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> 列挙体を使用する場合は、拇印クレームを指定する必要があります。 クレーム値を検索するには 2 つの手順を実行する必要があります。 まず、証明書用の Microsoft 管理コンソール \(MMC\) スナップインを開きます  \(「[方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)」を参照\)。 次に、ここで説明されているとおりに適切な証明書を検索してその拇印 \(または他のクレーム値\) をコピーします。  
+  
+ サービス認証で証明書を使用する場合は、**\[Issued To\]** 列 \(コンソールの 1 番目の列\) の値に注意することが重要です。 トランスポート セキュリティとして SSL \(Secure Sockets Layer\) を使用する場合、実行される最初のチェックの 1 つで、サービスのベース アドレス URI \(Uniform Resource Identifier\) が **\[Issued To\]** の値と比較されます。 値は一致する必要があります。一致しない場合は、認証が停止します。  
+  
+ また、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] SDK の Makecert.exe ツールを使用して、開発時専用の一時的な証明書を作成することもできます。 ただし、既定では、このような証明書は証明機関から発行されないため、実稼働環境では使用できません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)。  
+  
+### 証明書の拇印を取得するには  
+  
+1.  証明書用の Microsoft 管理コンソール \(MMC\) スナップインを開きます  \(「[方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)」を参照\)。  
+  
+2.  **\[Console Root\]** ウィンドウの左ペインで、**\[Certificates \(Local Computer\)\]** をクリックします。  
+  
+3.  **\[Personal\]** フォルダーをクリックして展開します。  
+  
+4.  **\[Certificates\]** フォルダーをクリックして展開します。  
+  
+5.  証明書リストの **\[Intended Purposes\]** 見出しを確認します。 目的として **\[Client Authentication\]** が表示されている証明書を検索します。  
+  
+6.  証明書をダブルクリックします。  
+  
+7.  **\[Certificate\]** ダイアログ ボックスの **\[Details\]** タブをクリックします。  
+  
+8.  フィールド リストをスクロールし、**\[Thumbprint\]** をクリックします。  
+  
+9. ボックスから 16 進文字をコピーします。 この拇印を `X509FindType` のコードで使用する場合は、16 進文字の間のスペースを削除します。 たとえば、拇印 "a9 09 50 2d d8 2a e4 14 33 e6 f8 38 86 b0 0d 42 77 a3 2a 7b" は、コード内で "a909502dd82ae41433e6f83886b00d4277a32a7b" として指定する必要があります。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.X509Certificates.X509FindType>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A>   
+ [方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)   
+ [方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)   
+ [方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-secure-a-service-with-an-x-509-certificate.md b/docs/framework/wcf/feature-details/how-to-secure-a-service-with-an-x-509-certificate.md
new file mode 100644
index 00000000000..8c827b5c273
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-secure-a-service-with-an-x-509-certificate.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : X.509 証明書を使用してサービスをセキュリティで保護する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d06c2aa-d0d7-4e5e-ad7e-77416aa1c10b
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# 方法 : X.509 証明書を使用してサービスをセキュリティで保護する
+X.509 証明書を使用してサービスをセキュリティ保護することは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の大半のバインディングで使用される基本的な手法です。ここでは、X.509 証明書を使用して自己ホスト サービスを構成する手順を示します。  
+  
+ サーバーの認証に使用できる有効な証明書があることが前提条件になります。この証明書は、信頼された証明機関によってサーバーに対して発行される必要があります。証明書が有効でない場合、サービスの使用を試みるすべてのクライアントがサービスを信頼しなくなるため、接続が作成されません。証明書の使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+### コードにより証明書を使用してサービスを構成するには  
+  
+1.  サービス コントラクトを作成し、サービスを実装します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md).  
+  
+2.  次のコードに示すように、<xref:System.ServiceModel.WSHttpBinding> クラスのインスタンスを作成し、そのセキュリティ モードを <xref:System.ServiceModel.SecurityMode> に設定します。  
+  
+     [!code-csharp[C_SecureWithCertificate#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#1)]
+     [!code-vb[C_SecureWithCertificate#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#1)]  
+  
+3.  次のコードに示すように、2 つの <xref:System.Type> 変数を作成し、それぞれコントラクト型と実装されたコントラクトに割り当てます。  
+  
+     [!code-csharp[C_SecureWithCertificate#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#2)]
+     [!code-vb[C_SecureWithCertificate#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#2)]  
+  
+4.  サービスのベース アドレス用に <xref:System.Uri> クラスのインスタンスを作成します。`WSHttpBinding` では HTTP トランスポートを使用するため、URI \(Uniform Resource Identifier\) がこのスキーマで開始されている必要があります。そうでない場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、サービスが開かれたときに例外をスローします。  
+  
+     [!code-csharp[C_SecureWithCertificate#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#3)]
+     [!code-vb[C_SecureWithCertificate#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#3)]  
+  
+5.  実装したコントラクト型変数と URI を使用して <xref:System.ServiceModel.ServiceHost> クラスの新しいインスタンスを作成します。  
+  
+     [!code-csharp[C_SecureWithCertificate#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#4)]
+     [!code-vb[C_SecureWithCertificate#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#4)]  
+  
+6.  <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを使用して、サービスに <xref:System.ServiceModel.Description.ServiceEndpoint> を追加します。次のコードに示すように、コントラクト、バインディング、およびエンドポイント アドレスをコンストラクターに渡します。  
+  
+     [!code-csharp[C_SecureWithCertificate#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#5)]
+     [!code-vb[C_SecureWithCertificate#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#5)]  
+  
+7.  省略可能。サービスからメタデータを取得するには、新しい <xref:System.ServiceModel.Description.ServiceMetadataBehavior> オブジェクトを作成し、<xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A> プロパティを `true` に設定します。  
+  
+     [!code-csharp[C_SecureWithCertificate#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#6)]
+     [!code-vb[C_SecureWithCertificate#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#6)]  
+  
+8.  <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A> メソッドを使用して、有効な証明書をサービスに追加します。このメソッドでは、いくつかある方法の 1 つを使用して証明書を見つけます。この例では、<xref:System.Security.Cryptography.X509Certificates.X509FindType> 列挙体を使用します。この列挙体では、提供された値が証明書の発行先のエンティティの名前であることを指定します。  
+  
+     [!code-csharp[C_SecureWithCertificate#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#7)]
+     [!code-vb[C_SecureWithCertificate#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#7)]  
+  
+9. <xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> メソッドを呼び出して、サービスのリッスンを開始します。コンソール アプリケーションを作成する場合は、<xref:System.Console.ReadLine%2A> メソッドを呼び出して、サービスをリッスン状態に保持します。  
+  
+     [!code-csharp[C_SecureWithCertificate#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#8)]
+     [!code-vb[C_SecureWithCertificate#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#8)]  
+  
+## 使用例  
+ 次の例では、<xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A> メソッドを使用して、X.509 証明書でサービスを構成します。  
+  
+ [!code-csharp[C_SecureWithCertificate#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewithcertificate/cs/source.cs#9)]
+ [!code-vb[C_SecureWithCertificate#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewithcertificate/vb/source.vb#9)]  
+  
+## コードのコンパイル  
+ コードのコンパイルには次の名前空間が必要です。  
+  
+-   <xref:System>  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.ServiceModel.Channels>  
+  
+-   <xref:System.Web.Services.Description>  
+  
+-   <xref:System.Security.Cryptography.X509Certificates>  
+  
+-   <xref:System.Runtime.Serialization>  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-secure-messages-within-reliable-sessions.md b/docs/framework/wcf/feature-details/how-to-secure-messages-within-reliable-sessions.md
new file mode 100644
index 00000000000..f6151e3aebd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-secure-messages-within-reliable-sessions.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : 信頼できるセッション内でメッセージをセキュリティで保護する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aee33e50-936f-4486-9ca8-c1520c19a62d
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# 方法 : 信頼できるセッション内でメッセージをセキュリティで保護する
+ここでは、信頼できるセッション内で交換されるメッセージに対して、メッセージ レベルのセキュリティを有効にするために必要な手順について説明します。このとき、信頼できるセッションがオプションでサポートされているシステム指定のバインディングを使用します。セキュリティで保護された信頼できるセッションを有効にするには、コードを使用して強制的に行うか、構成ファイルで宣言します。この手順では、クライアントとサービスの構成ファイルを使用して、セキュリティで保護された信頼できるセッションを有効にします。  
+  
+ この手順の主な部分は、次の 3 つの作業で構成されます。  
+  
+1.  クライアントとサービスのメッセージ交換は信頼できるセッション内で行うことを指定します。  
+  
+2.  信頼できるセッション内でメッセージ レベルのセキュリティを要求します。  
+  
+3.  サービスに対する認証時にクライアントが使用する必要があるクライアント資格情報を指定します。  
+  
+ 最初の作業で重要なのは、エンドポイント構成要素に \(この例の場合\) "MessageSecurity" という名前のバインディング構成を参照する `bindingConfiguration` 属性が含まれていることです。[\<binding\>](../../../../docs/framework/misc/binding.md) 構成要素は、この名前を参照して、[reliableSession](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b) 要素の `enabled` 属性を `true` に設定することで信頼できるセッションを有効にします。信頼できるセッション内で使用できる順序付き配信の保証は、`ordered` 属性を `true` に設定することによって要求できます。  
+  
+ この構成手順のベースであるソース例については、「[WS 信頼できるセッション](../../../../docs/framework/wcf/samples/ws-reliable-session.md)」を参照してください。  
+  
+ 2 番目の作業で必要な項目は、クライアントとサービスの\<`binding`\> 要素に含まれている \<`security`\> 要素の `mode` 属性を `Message` に設定することによって達成できます。  
+  
+ 3 番目の作業で必要な項目は、クライアントとサービスの\<`security`\> 要素に含まれている \<`message`\> 要素の `clientCredentialType` 属性を `Certificate` に設定することによって達成できます。  
+  
+> [!NOTE]
+>  信頼できるセッションでメッセージ セキュリティを使用するときに、クライアントが認証されていないと、信頼できるメッセージ機能は最初の失敗で例外をスローするのではなく、タイムアウトが発生するまでクライアントの認証を試みます。  
+  
+### 信頼できるセッションを使用するためにサービスを WSHttpBinding で構成するには  
+  
+1.  この手順については、「[方法 : 信頼されたセッション内のメッセージを変換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md)」を参照してください。  
+  
+### 信頼できるセッションを使用するためにクライアントを WSHttpBinding で構成するには  
+  
+1.  この手順については、「[方法 : 信頼されたセッション内のメッセージを変換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md)」を参照してください。  
+  
+### 構成でモードと ClientCredentialType を設定するには  
+  
+1.  構成ファイルの [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素に、適切なバインド要素を追加します。次の例では [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素を追加しています。  
+  
+2.  \<`binding`\> 要素を追加し、`name` 属性に適切な値を設定します。  
+  
+3.  `<security>` 要素を追加し、`mode` 属性に `Message` を設定します。  
+  
+     次の例では、mode を `Message` に設定し、\<`message`\> 要素の `clientCredentialType` 属性を `Certificate` に設定します。  
+  
+    ```  
+    <wsHttpBinding>  
+    <binding name="MessageSecurity">  
+        <security mode="Message" />  
+           <message clientCredentialType = " Certificate" />  
+        </security>  
+    </binding>  
+    </wsHttpBinding >  
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md b/docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md
new file mode 100644
index 00000000000..1cade39d6c2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md
@@ -0,0 +1,106 @@
+---
+title: "方法 : セキュリティで保護されたメタデータ エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9f71b6ae-737c-4382-8d89-0a7b1c7e182b
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# 方法 : セキュリティで保護されたメタデータ エンドポイント
+サービスのメタデータには、悪意のあるユーザーに利用される可能性がある、アプリケーションに関する機密情報が含まれています。また、サービスのコンシューマーにも、サービスのメタデータを取得するためのセキュリティで保護された機構が必要です。したがって、状況に応じて、セキュリティで保護されたエンドポイントを使用してメタデータを公開する必要があります。  
+  
+ メタデータ エンドポイントは、一般に、アプリケーション エンドポイントをセキュリティで保護するために [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に定義されている標準のセキュリティ機構を使用して保護されます \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md).\)  
+  
+ ここでは、SSL \(Secure Sockets Layer\) 証明書によって保護されたエンドポイント \(つまり、HTTPS エンドポイント\) を作成する手順を示します。  
+  
+### セキュリティで保護された HTTPS GET メタデータ エンドポイントをコードで作成するには  
+  
+1.  適切な X.509 証明書を使用してポートを構成します。この証明書は信頼された証明機関から発行され、かつ "サービス承認" の用途に使用される必要があります。証明書をポートに関連付けるには、HttpCfg.exe ツールを使用する必要があります。「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。  
+  
+    > [!IMPORTANT]
+    >  証明書またはそのドメイン ネーム システム \(DNS: Domain Name System\) のサブジェクトが、コンピューターの名前と一致している必要があります。これは、HTTPS 機構が最初に実行する手順に、呼び出されたアドレスと同じ URI \(Uniform Resource Identifier\) に対して証明書が発行されているかどうかのチェックが含まれるために必要です。  
+  
+2.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> クラスの新しいインスタンスを作成します。  
+  
+3.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> クラスの <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A> プロパティを `true` に設定します。  
+  
+4.  <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetUrl%2A> プロパティを適切な URL に設定します。絶対アドレスを指定する場合、URL は "https:\/\/" で開始する必要があります。相対アドレスを指定する場合は、サービス ホストに HTTPS ベースのアドレスを指定する必要があります。このプロパティが設定されていない場合、既定のアドレスは ""、またはサービスに HTTPS ベースのアドレスを直接指定したものになります。  
+  
+5.  作成したインスタンスを、<xref:System.ServiceModel.Description.ServiceDescription> クラスの <xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A> プロパティから返される動作コレクションに追加します。コードは次のようになります。  
+  
+     [!code-csharp[c_HowToSecureEndpoint#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosecureendpoint/cs/source.cs#1)]
+     [!code-vb[c_HowToSecureEndpoint#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosecureendpoint/vb/source.vb#1)]  
+  
+### セキュリティで保護された HTTPS GET メタデータ エンドポイントを構成で作成するには  
+  
+1.  サービスの構成ファイルで、[\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素を [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素に追加します。  
+  
+2.  [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) 要素を [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素に追加します。  
+  
+3.  [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md) 要素を `<serviceBehaviors>` 要素に追加します。  
+  
+4.  `<behavior>` 要素の `name` 属性を適切な値に設定します。`name` 属性は必須です。下の例では、`mySvcBehavior` を値として使用しています。  
+  
+5.  [\<serviceMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicemetadata.md)を `<behavior>` 要素に追加します。  
+  
+6.  `<serviceMetadata>` 要素の `httpsGetEnabled` 属性を `true` に設定します。  
+  
+7.  `<serviceMetadata>` 要素の `httpsGetUrl` 属性を適切な値に設定します。絶対アドレスを指定する場合、URL は "https:\/\/" で開始する必要があります。相対アドレスを指定する場合は、サービス ホストに HTTPS ベースのアドレスを指定する必要があります。このプロパティが設定されていない場合、既定のアドレスは ""、またはサービスに HTTPS ベースのアドレスを直接指定したものになります。  
+  
+8.  サービスで動作を使用するには、[\<service\>](../../../../docs/framework/configure-apps/file-schema/wcf/service.md) 要素の `behaviorConfiguration` 属性を動作要素の名前属性の値に設定します。完全な構成コードを次の例に示します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+     <system.serviceModel>  
+      <behaviors>  
+       <serviceBehaviors>  
+        <behavior name="mySvcBehavior">  
+         <serviceMetadata httpsGetEnabled="true"   
+              httpsGetUrl="https://localhost:8036/calcMetadata" />  
+        </behavior>  
+       </serviceBehaviors>  
+      </behaviors>  
+     <services>  
+      <service behaviorConfiguration="mySvcBehavior"   
+            name="Microsoft.Security.Samples.Calculator">  
+       <endpoint address="http://localhost:8037/ServiceModelSamples/calculator"  
+       binding="wsHttpBinding" bindingConfiguration=""     
+       contract="Microsoft.Security.Samples.ICalculator" />  
+      </service>  
+     </services>  
+    </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+## 使用例  
+ 次の例では、<xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成して、エンドポイントを追加します。次に、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> クラスのインスタンスを作成し、プロパティを設定してセキュリティで保護された Metadata Exchange ポイントを作成しています。  
+  
+ [!code-csharp[c_HowToSecureEndpoint#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtosecureendpoint/cs/source.cs#0)]
+ [!code-vb[c_HowToSecureEndpoint#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtosecureendpoint/vb/source.vb#0)]  
+  
+## コードのコンパイル  
+ このコード例では、次の名前空間を使用します。  
+  
+-   <xref:System.ServiceModel?displayProperty=fullName>  
+  
+-   <xref:System.ServiceModel.Description?displayProperty=fullName>  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A>   
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior>   
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetUrl%2A>   
+ [方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md b/docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md
new file mode 100644
index 00000000000..afdc1d5a740
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md
@@ -0,0 +1,151 @@
+---
+title: "方法 : JSON データをシリアル化および逆シリアル化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88abc1fb-8196-4ee3-a23b-c6934144d1dd
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : JSON データをシリアル化および逆シリアル化する
+JSON (JavaScript Object Notation) は、クライアント ブラウザーと AJAX 対応の Web サービスとの間で、少量のデータを高速に交換できる効率的なデータ エンコード形式です。  
+  
+ ここでは JSON でエンコードされたデータに .NET 型のオブジェクトをシリアル化し、逆シリアル化、JSON 形式でデータを使用して .NET 型のインスタンスを<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>します。 この例では、ユーザー定義された `Person` 型のシリアル化と逆シリアル化を示すためにデータ コントラクトを使用します。  
+  
+ AJAX 対応エンドポイントで公開されたサービス操作でデータ コントラクト型を使用する場合、JSON でのシリアル化および逆シリアル化は通常 [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] によって自動的に処理されます。 ただし、特定の場合においては JSON データを直接処理する必要があります。このトピックでは、このようなシナリオについて説明します。  
+  
+> [!NOTE]
+>  サーバー上で送信応答のシリアル化中にエラーが発生した場合、または応答操作がなんらかの理由で例外をスローした場合、エラーにより応答がクライアントに戻らないことがあります。  
+  
+ このトピックのに基づいて、 [JSON のシリアル化](../../../../docs/framework/wcf/samples/json-serialization.md)サンプルです。  
+  
+### <a name="to-define-the-data-contract-for-a-person"></a>Person のデータ コントラクトを定義するには  
+  
+1.  データ コントラクトを定義`Person`アタッチすることにより、 <xref:System.Runtime.Serialization.DataContractAttribute>クラスにし、 <xref:System.Runtime.Serialization.DataMemberAttribute>属性メンバーをシリアル化します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]データ コントラクトを参照してください[サービス コントラクトの設計](../../../../docs/framework/wcf/designing-service-contracts.md)します。  
+  
+    ```  
+    [DataContract]  
+        internal class Person  
+        {  
+            [DataMember]  
+            internal string name;  
+  
+            [DataMember]  
+            internal int age;  
+        }  
+    ```  
+  
+### <a name="to-serialize-an-instance-of-type-person-to-json"></a>Person 型のインスタンスを JSON にシリアル化するには  
+  
+1.  `Person` 型のインスタンスを作成します。  
+  
+    ```  
+    Person p = new Person();  
+    p.name = "John";  
+    p.age = 42;  
+    ```  
+  
+2.  シリアル化、`Person`オブジェクトを使用してメモリ ストリームを<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>します。  
+  
+    ```  
+    MemoryStream stream1 = new MemoryStream();  
+    DataContractJsonSerializer ser = new DataContractJsonSerializer(typeof(Person));  
+    ```  
+  
+3.  使用して、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer.WriteObject%2A>に JSON データをストリームに書き込みます。  
+  
+    ```  
+    ser.WriteObject(stream1, p);  
+    ```  
+  
+4.  JSON の出力を表示します。  
+  
+    ```  
+    stream1.Position = 0;  
+    StreamReader sr = new StreamReader(stream1);  
+    Console.Write("JSON form of Person object: ");  
+    Console.WriteLine(sr.ReadToEnd());  
+    ```  
+  
+### <a name="to-deserialize-an-instance-of-type-person-from-json"></a>JSON から Person 型のインスタンスに逆シリアル化するには  
+  
+1.  新しいインスタンスに、JSON エンコードされたデータを逆シリアル化`Person`を使用して、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer.ReadObject%2A>のメソッド、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>します。  
+  
+    ```  
+    stream1.Position = 0;  
+    Person p2 = (Person)ser.ReadObject(stream1);  
+    ```  
+  
+2.  結果を表示します。  
+  
+    ```  
+    Console.Write("Deserialized back, got name=");  
+    Console.Write(p2.name);  
+    Console.Write(", age=");  
+    Console.WriteLine(p2.age);  
+    ```  
+  
+## <a name="example"></a>例  
+  
+```  
+// Create a User object and serialize it to a JSON stream.  
+public static string WriteFromObject()  
+{  
+    //Create User object.  
+    User user = new User("Bob", 42);  
+  
+    //Create a stream to serialize the object to.  
+    MemoryStream ms = new MemoryStream();  
+  
+    // Serializer the User object to the stream.  
+    DataContractJsonSerializer ser = new DataContractJsonSerializer(typeof(User));  
+    ser.WriteObject(ms, user);  
+    byte[] json = ms.ToArray();  
+    ms.Close();  
+    return Encoding.UTF8.GetString(json, 0, json.Length);  
+  
+}  
+  
+// Deserialize a JSON stream to a User object.  
+public static User ReadToObject(string json)  
+{  
+    User deserializedUser = new User();  
+    MemoryStream ms = new MemoryStream(Encoding.UTF8.GetBytes(json));  
+    DataContractJsonSerializer ser = new DataContractJsonSerializer(deserializedUser.GetType());  
+    deserializedUser = ser.ReadObject(ms) as User;  
+    ms.Close();  
+    return deserializedUser;  
+}  
+  
+```  
+  
+> [!NOTE]
+>  JSON シリアライザーは、次のサンプル コードに示すように、データ コントラクターの複数のメンバーが同じ名前である場合、シリアル化例外をスローします。  
+  
+```  
+[DataContract]  
+public class TestDuplicateDataBase  
+{  
+    [DataMember]  
+    public int field1 = 123;  
+}  
+[DataContract]  
+public class TestDuplicateDataDerived : TestDuplicateDataBase  
+{  
+    [DataMember]  
+    public new int field1 = 999;  
+}  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [スタンドアロン JSON のシリアル化](../../../../docs/framework/wcf/feature-details/stand-alone-json-serialization.md)   
+ [JSON およびその他のデータ転送形式をサポートします。](../../../../docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-service-data-partitioning.md b/docs/framework/wcf/feature-details/how-to-service-data-partitioning.md
new file mode 100644
index 00000000000..1a8ea00c0fc
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-service-data-partitioning.md
@@ -0,0 +1,187 @@
+---
+title: "サービス データのパーティションを分割する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ccff72e-d76b-4e36-93a2-e51f7b32dc83
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# サービス データのパーティションを分割する方法
+このトピックでは、メッセージを同じ送信先サービスの複数のインスタンスにパーティション分割するのに必要な、基本的な手順について説明します。サービス データのパーティション分割は、一般的に、優れた品質のサービスを提供するためにサービスを拡張する必要がある場合や、さまざまな顧客からの要求を特定の方法で処理する必要がある場合に使用されます。たとえば、重要な顧客 \("ゴールド" 顧客\) からのメッセージは、標準顧客からのメッセージよりも高い優先度で処理される必要がある場合があります。  
+  
+ この例では、メッセージが regularCalc サービスの 2 つのインスタンスの 1 つにルーティングされます。サービスの両方のインスタンスは同じですが、calculator1 エンドポイントで表されるサービスは、重要な顧客から受け取ったメッセージを処理し、calculator 2 エンドポイントは、その他の顧客からのメッセージを処理します。  
+  
+ クライアントから送信されたメッセージには、どちらのサービス インスタンスにメッセージをルーティングする必要があるかを識別するのに使用できる一意のデータはありません。各クライアントが特定の送信先サービスにデータをルーティングできるようにするため、メッセージの受信に使用される 2 つのサービス エンドポイントを実装します。  
+  
+> [!NOTE]
+>  この例では、特定のエンドポイントを使用してデータをパーティション分割しますが、ヘッダーや本文データなど、メッセージ自体に含まれている情報を使用することもできます。  
+  
+### サービス データのパーティション分割の実装  
+  
+1.  サービスによって公開されるサービス エンドポイントを指定することによって、ルーティング サービスの基本的な構成を作成します。次の例では、メッセージの受信に使用する、2 つのサービス エンドポイントを定義します。また、regularCalc サービス インスタンスへのメッセージ送信に使用する、クライアント エンドポイントも定義します。  
+  
+    ```xml  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoints for the Routing Service-->  
+        <!--create the endpoints for the calculator service-->  
+        <endpoint address="calculator1"  
+                  binding="wsHttpBinding"  
+                  name="calculator1Endpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+        <endpoint address="calculator2"  
+                  binding="wsHttpBinding"  
+                  name="calculator2Endpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+       </service>  
+    </services>  
+    <client>  
+    <!--set up the destination endpoints-->  
+        <endpoint name="CalcEndpoint1"  
+                  address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                  binding="netTcpBinding"  
+                  contract="*" />  
+  
+        <endpoint name="CalcEndpoint2"  
+                  address="net.tcp://localhost:8080/servicemodelsamples/service/"  
+                  binding="netTcpBinding"  
+                  contract="*" />  
+     </client>  
+  
+    ```  
+  
+2.  送信先エンドポイントにメッセージをルーティングするのに使用するフィルターを定義します。この例では、EndpointName フィルターを使用して、どのサービス エンドポイントがメッセージを受信したかを判断します。次の例では、必要なルーティング セクションおよびフィルターを定義します。  
+  
+    ```xml  
+    <filters>  
+      <!--define the different message filters-->  
+      <!--define endpoint name filters looking for messages that show up on the virtual endpoints-->  
+      <filter name="HighPriority" filterType="EndpointName"  
+              filterData="calculator1Endpoint"/>  
+      <filter name="NormalPriority" filterType="EndpointName"  
+              filterData="calculator2Endpoint"/>  
+    </filters>  
+    ```  
+  
+3.  各フィルターをクライアント エンドポイントと関連付けるフィルター テーブルを定義します。この例では、メッセージの受信に使用された特定のエンドポイントに基づいて、メッセージがルーティングされます。メッセージは 2 つのフィルターのどちらかにのみ一致するため、フィルターが評価される順序をフィルターの優先順位で制御する必要はありません。  
+  
+     次のコードでは、フィルター テーブルを定義し、前に定義されたフィルターを追加します。  
+  
+    ```xml  
+    <filterTables>  
+       <filterTable name="filterTable1">  
+         <!--add the filters to the message filter table-->  
+         <add filterName="HighPriority" endpointName="CalcEndpoint1"/>  
+         <add filterName="NormalPriority" endpointName="CalcEndpoint2"/>  
+       </filterTable>  
+    </filterTables>  
+  
+    ```  
+  
+4.  受信メッセージをテーブルに含まれているフィルターと照合して評価するには、ルーティング動作を使用して、フィルター テーブルをサービス エンドポイントと関連付ける必要があります。次の例は、filterTable1 をサービス エンドポイントと関連付ける方法を示しています。  
+  
+    ```xml  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    ```  
+  
+## 使用例  
+ 構成ファイル全体の一覧を次に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright (c) Microsoft Corporation. All rights reserved -->  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoints for the Routing Service-->  
+        <!--create the endpoints for the calculator service-->  
+        <endpoint address="calculator1"  
+                  binding="wsHttpBinding"  
+                  name="calculator1Endpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+        <endpoint address="calculator2"  
+                  binding="wsHttpBinding"  
+                  name="calculator2Endpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+  
+      </service>  
+    </services>  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    <client>  
+<!--set up the destination endpoints-->  
+      <endpoint name="CalcEndpoint1"  
+                address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+  
+      <endpoint name="CalcEndpoint2"  
+                address="net.tcp://localhost:8080/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+    </client>  
+    <routing>  
+      <!-- use the namespace table element to define a prefix for our custom namespace-->  
+  
+      <filters>  
+        <!--define the different message filters-->  
+        <!--define endpoint name filters looking for messages that show up on the virtual endpoints-->  
+        <filter name="HighPriority" filterType="EndpointName"  
+                filterData="calculator1Endpoint"/>  
+        <filter name="NormalPriority" filterType="EndpointName"  
+                filterData="calculator2Endpoint"/>  
+      </filters>  
+  
+      <filterTables>  
+        <filterTable name="filterTable1">  
+          <!--add the filters to the message filter table-->  
+          <add filterName="HighPriority" endpointName="CalcEndpoint1"/>  
+          <add filterName="NormalPriority" endpointName="CalcEndpoint2"/>  
+        </filterTable>  
+      </filterTables>  
+  
+    </routing>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [ルーティング サービス](../../../../docs/framework/wcf/samples/routing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-service-versioning.md b/docs/framework/wcf/feature-details/how-to-service-versioning.md
new file mode 100644
index 00000000000..d5a31abdd7d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-service-versioning.md
@@ -0,0 +1,340 @@
+---
+title: "サービスのバージョンを管理する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4287b6b3-b207-41cf-aebe-3b1d4363b098
+caps.latest.revision: 6
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# サービスのバージョンを管理する方法
+このトピックでは、メッセージを同じサービスの異なるバージョンにルーティングするルーティング構成を作成するために必要な、基本的な手順について説明します。この例では、電卓サービスの 2 つのバージョン `roundingCalc` \(v1\) および `regularCalc` \(v2\) にメッセージがルーティングされます。これらの実装は両方とも同じ操作をサポートしますが、古い方のサービス `roundingCalc` では、戻る前にすべての計算を最も近い整数値に丸めます。クライアント アプリケーションは、新しい方の `regularCalc` サービスを使用するかどうかを示すことが可能である必要があります。  
+  
+> [!WARNING]
+>  メッセージをサービスの特定のバージョンにルーティングするには、ルーティング サービスで、メッセージの内容に基づいて、そのメッセージの転送先を特定できることが必要です。次に示す手法では、クライアントがメッセージ ヘッダーに情報を挿入することでバージョンを指定します。サービスのバージョンを指定するいくつかの手法では、クライアントが追加データを渡す必要はありません。たとえば、サービスの最新のバージョン、または最も互換性のあるバージョンにメッセージをルーティングしたり、ルーターが標準の SOAP エンベロープの一部を使用したりすることもできます。  
+  
+ 次の操作が両方のサービスによって公開されます。  
+  
+-   \[追加\]  
+  
+-   減算  
+  
+-   乗算  
+  
+-   除算  
+  
+ 両方のサービス実装が同じ操作を処理し、返すデータを除いて基本的には同一であるため、クライアント アプリケーションから送信されるメッセージに含まれる基本データでは、要求をルーティングする方法を決定できません。たとえば、両方のサービスの既定のアクションが同じであるために、アクション フィルターを使用できない場合があります。  
+  
+ この問題は、いくつかの方法で解決できます。たとえば、ルーター上でサービスの各バージョン用に特定のエンドポイントを公開したり、メッセージにカスタム ヘッダー要素を追加してサービスのバージョンを示したりできます。どちらの方法でも、受信メッセージをサービスの特定のバージョンに一意にルーティングできますが、異なるサービス バージョンの要求を区別するには、一意のメッセージ コンテンツを使用することをお勧めします。  
+  
+ この例では、クライアント アプリケーションがカスタム ヘッダー CalcVer を要求メッセージに追加します。このヘッダーには、メッセージのルーティング先となるサービスのバージョンを示す値が含まれています。値が 1 の場合は roundingCalc サービス、値が 2 の場合は regularCalc サービスが、メッセージを処理する必要があります。これにより、クライアント アプリケーションは、サービスのどちらのバージョンでメッセージが処理されるかを直接制御できます。カスタム ヘッダーはメッセージ内に含まれる値であるため、1 つのエンドポイントを使用して、サービスの両方のバージョン宛てのメッセージを受信できます。クライアント アプリケーションで次のコードを使用して、このカスタム ヘッダーをメッセージに追加できます。  
+  
+```csharp  
+messageHeadersElement.Add(MessageHeader.CreateHeader("CalcVer", "http://my.custom.namespace/", "2"));  
+```  
+  
+### サービスのバージョン管理の実装  
+  
+1.  サービスによって公開されるサービス エンドポイントを指定することによって、ルーティング サービスの基本的な構成を作成します。次の例では、メッセージの受信に使用される、単一のサービス エンドポイントを定義します。また、`roundingCalc` \(v1\) サービスおよび `regularCalc` \(v2\) サービスへのメッセージ送信に使用する、クライアント エンドポイントも定義します。  
+  
+    ```xml  
+    <services>  
+        <service behaviorConfiguration="routingConfiguration"  
+                 name="System.ServiceModel.Routing.RoutingService">  
+          <host>  
+            <baseAddresses>  
+              <add baseAddress="http://localhost/routingservice/router" />  
+            </baseAddresses>  
+          </host>  
+          <!--Set up the inbound endpoint for the Routing Service-->  
+          <endpoint address="calculator"  
+                    binding="wsHttpBinding"  
+                    name="routerEndpoint"  
+                    contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+        </service>  
+    </services>  
+    <client>  
+    <!--set up the destination endpoints-->  
+          <endpoint name="regularCalcEndpoint"  
+                    address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                    binding="netTcpBinding"  
+                    contract="*" />  
+  
+          <endpoint name="roundingCalcEndpoint"  
+                    address="http://localhost:8080/servicemodelsamples/service/"  
+                    binding="wsHttpBinding"  
+                    contract="*" />  
+        </client>  
+  
+    ```  
+  
+2.  送信先エンドポイントにメッセージをルーティングするのに使用するフィルターを定義します。この例では、XPath フィルターを使用してカスタム ヘッダー CalcVer の値を検出し、メッセージのルーティング先となるバージョンを特定します。XPath フィルターは、CalcVer ヘッダーを含まないメッセージの検出にも使用します。次の例では、必要なフィルターおよび名前空間のテーブルを定義します。  
+  
+    ```xml  
+    <!-- use the namespace table element to define a prefix for our custom namespace-->  
+    <namespaceTable>  
+      <add prefix="custom" namespace="http://my.custom.namespace/"/>  
+    </namespaceTable>  
+    <filters>  
+      <!--define the different message filters-->  
+      <!--define an xpath message filter to look for the  
+          custom header containing a value of 2-->  
+      <filter name="XPathFilterRegular" filterType="XPath"  
+              filterData="sm:header()/custom:CalcVer = '2'"/>  
+      <!--define an xpath message filter to look for the  
+          custom header containing a value of 1-->  
+      <filter name="XPathFilterRounding" filterType="XPath"  
+              filterData="sm:header()/custom:CalcVer = '1'"/>  
+       <!--define an xpath message filter to look for  
+           messages that do not contain the custom header-->  
+       <filter name="XPathFilterNoHeader" filterType="XPath"  
+               filterData="count(sm:header()/custom:CalcVer)=0"/>  
+    </filters  
+    ```  
+  
+    > [!NOTE]
+    >  s12 の名前空間プレフィックスは、既定では名前空間のテーブルで定義され、名前空間 "http:\/\/www.w3.org\/2003\/05\/soap\-envelope" を表します。  
+  
+3.  各フィルターをクライアント エンドポイントと関連付けるフィルター テーブルを定義します。値が 1 の CalcVer ヘッダーがメッセージに含まれる場合は、regularCalc サービスに送信されます。ヘッダーに値 2 が含まれる場合は、roundingCalc サービスに送信されます。ヘッダーがない場合、メッセージは regularCalc にルーティングされます。  
+  
+     次のコードでは、フィルター テーブルを定義し、前に定義されたフィルターを追加します。  
+  
+    ```xml  
+    <filterTables>  
+      <filterTable name="filterTable1">  
+          <!--add the filters to the message filter table-->  
+          <!--look for the custom header = 1, and if we find it,  
+              send the message to the rounding calc endpoint-->  
+          <add filterName="XPathFilterRounding" endpointName="roundingCalcEndpoint"/>  
+          <!--look for the custom header = 2, and if we find it,  
+              send the message to the rounding calc endpoint-->  
+          <add filterName="XPathFilterRegular" endpointName="regularCalcEndpoint"/>  
+          <!--look for the absence of the custom header, and if  
+              it is not present, assume the v1 endpoint-->  
+          <add filterName="XPathFilterNoHeader" endpointName="roundingCalcEndpoint"/>  
+      </filterTable>  
+    </filterTables>  
+    ```  
+  
+4.  受信メッセージをフィルター テーブルに含まれているフィルターと照合して評価するには、ルーティング動作を使用して、フィルター テーブルをサービス エンドポイントと関連付ける必要があります。次の例は、filterTable1 をサービス エンドポイントと関連付ける方法を示しています。  
+  
+    ```xml  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    ```  
+  
+## 使用例  
+ 構成ファイル全体の一覧を次に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright (c) Microsoft Corporation. All rights reserved -->  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoint for the Routing Service-->  
+        <endpoint address="calculator"  
+                  binding="wsHttpBinding"  
+                  name="routerEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    <client>  
+<!--set up the destination endpoints-->  
+      <endpoint name="regularCalcEndpoint"  
+                address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+  
+      <endpoint name="roundingCalcEndpoint"  
+                address="http://localhost:8080/servicemodelsamples/service/"  
+                binding="wsHttpBinding"  
+                contract="*" />  
+    </client>  
+    <routing>  
+      <!-- use the namespace table element to define a prefix for our custom namespace-->  
+      <namespaceTable>  
+        <add prefix="custom" namespace="http://my.custom.namespace/"/>  
+      </namespaceTable>  
+      <filters>  
+        <!--define the different message filters-->  
+        <!--define an xpath message filter to look for the  
+            custom header containing a value of 2-->  
+        <filter name="XPathFilterRegular" filterType="XPath"  
+                filterData="sm:header()/custom:CalcVer = '2'"/>  
+        <!--define an xpath message filter to look for the  
+            custom header containing a value of 1-->  
+        <filter name="XPathFilterRounding" filterType="XPath"  
+                filterData="sm:header()/custom:CalcVer = '1'"/>  
+        <!--define an xpath message filter to look for  
+            messages that do not contain the custom header-->  
+        <filter name="XPathFilterNoHeader" filterType="XPath"  
+                filterData="count(sm:header()/custom:CalcVer)=0"/>  
+      </filters>  
+      <filterTables>  
+        <filterTable name="filterTable1">  
+            <!--add the filters to the message filter table-->  
+            <!--look for the custom header = 1, and if we find it,  
+                send the message to the rounding calc endpoint-->  
+            <add filterName="XPathFilterRounding" endpointName="roundingCalcEndpoint"/>  
+            <!--look for the custom header = 2, and if we find it,  
+                send the message to the rounding calc endpoint-->  
+            <add filterName="XPathFilterRegular" endpointName="regularCalcEndpoint"/>  
+            <!--look for the absence of the custom header, and if  
+                it is not present, assume the v1 endpoint-->  
+            <add filterName="XPathFilterNoHeader" endpointName="roundingCalcEndpoint"/>  
+        </filterTable>  
+      </filterTables>  
+    </routing>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 使用例  
+ クライアント アプリケーションの全体の一覧を次に示します。  
+  
+```csharp  
+  
+using System;  
+using System.ServiceModel;  
+using System.ServiceModel.Channels;  
+  
+namespace Microsoft.Samples.AdvancedFilters  
+{  
+    //The service contract is defined in generatedClient.cs, generated from the service by the svcutil tool.  
+  
+    //Client implementation code.  
+    class Client  
+    {  
+        static void Main()  
+        {  
+            //Print out the welcome text  
+            Console.WriteLine("This sample routes the Calculator Sample through the new WCF RoutingService");  
+            Console.WriteLine("Wait for all the services to indicate that they've started, then press");  
+            Console.WriteLine("<ENTER> to start the client.");  
+  
+            while (Console.ReadLine() != "quit")  
+            {  
+                //Offer the Address configuration for the client  
+                Console.WriteLine("");  
+                Console.WriteLine("Welcome to the Calculator Client!");  
+  
+                EndpointAddress epa;  
+                //set the default address as the general router endpoint  
+                epa = new EndpointAddress("http://localhost/routingservice/router/calculator");  
+  
+                //set up the CalculatorClient with the EndpointAddress, the WSHttpBinding, and the ICalculator contract  
+                //We use the WSHttpBinding so that the outgoing has a message envelope, which we'll manipulate in a minute  
+                CalculatorClient client = new CalculatorClient(new WSHttpBinding(), epa);  
+                //client.Endpoint.Contract = ContractDescription.GetContract(typeof(ICalculator));  
+  
+                //Ask the customer if they want to add a custom header to the outgoing message.  
+                //The Router will look for this header, and if so ignore the endpoint the message was  
+                //received on, and instead direct the message to the RoundingCalcService.  
+                Console.WriteLine("");  
+                Console.WriteLine("Which calculator service should be used?");  
+                Console.WriteLine("Enter 1 for the rounding calculator, 2 for the regular calculator.");  
+                Console.WriteLine("[1] or [2]?");  
+  
+                string header = Console.ReadLine();  
+  
+                //get the current operationContextScope from the client's inner channel  
+                using (OperationContextScope ocs = new OperationContextScope((client.InnerChannel)))  
+                {  
+                    //get the outgoing message headers element (collection) from the context  
+                    MessageHeaders messageHeadersElement = OperationContext.Current.OutgoingMessageHeaders;  
+  
+                    //if they wanted to create the header, go ahead and add it to the outgoing message  
+                    if (header != null && (header=="1" || header=="2"))  
+                    {  
+                        //create a new header "RoundingCalculator", no specific namespace, and set the value to   
+                        //the value of header.  
+                        //the Routing Service will look for this header in order to determine if the message  
+                        //should be routed to the RoundingCalculator  
+                        messageHeadersElement.Add(MessageHeader.CreateHeader("CalcVer", "http://my.custom.namespace/", header));  
+                    }  
+                    else //incorrect choice, no header added  
+                    {  
+                        Console.WriteLine("Incorrect value entered, not adding a header");  
+                    }  
+  
+                        //call the client operations  
+                        CallClient(client);  
+                }  
+  
+                //close the client to clean it up  
+                client.Close();  
+                Console.WriteLine();  
+                Console.WriteLine("Press <ENTER> to run the client again or type 'quit' to quit.");  
+            }  
+        }  
+  
+        private static void CallClient(CalculatorClient client)  
+        {  
+            Console.WriteLine("");  
+            Console.WriteLine("Sending!");  
+            // Call the Add service operation.  
+            double value1 = 100.00D;  
+            double value2 = 15.99D;  
+            double result = client.Add(value1, value2);  
+            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Subtract service operation.  
+            value1 = 145.00D;  
+            value2 = 76.54D;  
+            result = client.Subtract(value1, value2);  
+            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Multiply service operation.  
+            value1 = 9.00D;  
+            value2 = 81.25D;  
+            result = client.Multiply(value1, value2);  
+            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+            // Call the Divide service operation.  
+            value1 = 22.00D;  
+            value2 = 7.00D;  
+            result = client.Divide(value1, value2);  
+            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [ルーティング サービス](../../../../docs/framework/wcf/samples/routing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-set-a-max-clock-skew.md b/docs/framework/wcf/feature-details/how-to-set-a-max-clock-skew.md
new file mode 100644
index 00000000000..cc725992d73
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-set-a-max-clock-skew.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : 時刻のずれの最大値を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "MaxClockSkew プロパティ"
+  - "WCF, カスタム バインディング"
+ms.assetid: 491d1705-eb29-43c2-a44c-c0cf996f74eb
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : 時刻のずれの最大値を設定する
+時刻が重要な要素となる機能は、2 台のコンピューターで時刻の設定が異なっていると失敗する可能性があります。  この可能性を減らすには、`MaxClockSkew` プロパティを <xref:System.TimeSpan> に設定します。  このプロパティは、次の 2 つのクラスで使用できます。  
+  
+ <xref:System.ServiceModel.Channels.LocalClientSecuritySettings>  
+  
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>  
+  
+> [!IMPORTANT]
+>  重要   セキュリティで保護されたメッセージ交換を行うために、`MaxClockSkew` プロパティへの変更は、サービスまたはクライアントがブートストラップされているときに行う必要があります。  これを行うには、 <xref:System.ServiceModel.Channels.SecurityBindingElement> によって返された <xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters.BootstrapSecurityBindingElement%2A> に対してプロパティを設定する必要があります。  
+  
+ システム提供のバインディングの 1 つでこのプロパティを変更するには、バインディングのコレクションでセキュリティ バインド要素を見つけて、`MaxClockSkew` プロパティを新しい値に設定する必要があります。  <xref:System.ServiceModel.Channels.SecurityBindingElement> から派生される 2 つのクラスは、<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> クラスおよび <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> クラスです。  コレクションからセキュリティ バインディングを取得する場合は、`MaxClockSkew` プロパティを正しく設定するために、これらの型のどちらかにキャストする必要があります。  次の例では、<xref:System.ServiceModel.WSHttpBinding> を使用していますが、これは <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> を使用します。  システム提供の各バインディングで使用するセキュリティ バインディングの型を示す一覧については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+### コードを使用して時刻のずれの新しい値を持つカスタム バインディングを作成するには  
+  
+1.  > [!WARNING]
+    >  メモ   コード内の次の名前空間に参照先を追加してください。<xref:System.ServiceModel.Channels>、<xref:System.ServiceModel.Description>、<xref:System.Security.Permissions>、および <xref:System.ServiceModel.Security.Tokens>  
+  
+     <xref:System.ServiceModel.WSHttpBinding> クラスのインスタンスを作成し、セキュリティ モードを <xref:System.ServiceModel.SecurityMode> に設定します。  
+  
+2.  <xref:System.ServiceModel.Channels.BindingElementCollection> メソッドを呼び出して、<xref:System.ServiceModel.WSHttpBinding.CreateBindingElements%2A> クラスの新しいインスタンスを作成します。  
+  
+3.  <xref:System.ServiceModel.Channels.BindingElementCollection.Find%2A> クラスの <xref:System.ServiceModel.Channels.BindingElementCollection> メソッドを使用して、セキュリティ バインド要素を検索します。  
+  
+4.  <xref:System.ServiceModel.Channels.BindingElementCollection.Find%2A> メソッドを使用する場合には、実際の型にキャストします。  次の例では <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> 型にキャストしています。  
+  
+5.  セキュリティ バインド要素の <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.MaxClockSkew%2A> プロパティを設定します。  
+  
+6.  適切なサービス型とベース アドレスを使用して、<xref:System.ServiceModel.ServiceHost> を作成します。  
+  
+7.  <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを使用してエンドポイントを追加し、<xref:System.ServiceModel.Channels.CustomBinding> を含めます。  
+  
+     [!code-csharp[c_MaxClockSkew#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_maxclockskew/cs/source.cs#1)]
+     [!code-vb[c_MaxClockSkew#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_maxclockskew/vb/source.vb#1)]  
+  
+### 構成で MaxClockSkew を設定するには  
+  
+1.  [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素セクションに [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を作成します。  
+  
+2.  [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を作成し、`name` 属性を適切な値に設定します。  `MaxClockSkewBinding` に設定する方法の例を次に示します。  
+  
+3.  エンコーディング要素を追加します。  下の例では、[\<textMessageEncoding\>](../../../../docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md)を追加しています。  
+  
+4.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)を追加し、`authenticationMode` 属性を適切に設定します。  次の例では、この属性を `Kerberos` に設定して、サービスが Windows 認証を使用するように指定しています。  
+  
+5.  [\<localServiceSettings\>](../../../../docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md)を追加し、`maxClockSkew` 属性を `"##:##:##"` の書式の値に設定します。  次の例では 7 分に設定しています。  必要に応じて、[\<localServiceSettings\>](../../../../docs/framework/configure-apps/file-schema/wcf/localservicesettings-element.md)を追加し、`maxClockSkew` 属性を適切に設定します。  
+  
+6.  transport 要素を追加します。  下の例では、[\<httpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httptransport.md)を使用しています。  
+  
+7.  セキュリティで保護されたメッセージ交換を行うために、セキュリティ設定は、[\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md) 要素のブートストラップ時に行う必要があります。  
+  
+    ```  
+  
+    <bindings>  
+      <customBinding>  
+        <binding name="MaxClockSkewBinding">  
+            <textMessageEncoding />  
+            <security authenticationMode="Kerberos">  
+               <localClientSettings maxClockSkew="00:07:00" />  
+               <localServiceSettings maxClockSkew="00:07:00" />  
+               <secureConversationBootstrap>  
+                  <localClientSettings maxClockSkew="00:30:00" />  
+                  <localServiceSettings maxClockSkew="00:30:00" />  
+               </secureConversationBootstrap>  
+            </security>  
+            <httpTransport />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+  
+    ```  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.LocalClientSecuritySettings>   
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>   
+ <xref:System.ServiceModel.Channels.CustomBinding>   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-set-up-a-signature-confirmation.md b/docs/framework/wcf/feature-details/how-to-set-up-a-signature-confirmation.md
new file mode 100644
index 00000000000..e28780297b3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-set-up-a-signature-confirmation.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : 署名確認を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "署名確認"
+  - "WCF, セキュリティ"
+ms.assetid: 2424c137-c7c2-4aa9-8d5d-a066e12fefda
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : 署名確認を設定する
+*署名確認*は、メッセージのイニシエーターが受信した応答が、送信者の元のメッセージへの応答として生成されたものであることを確認するメカニズムです。署名確認は、WS\-Security 1.1 仕様で定義されています。エンドポイントが WS\-Security 1.0 をサポートしている場合は、署名確認を使用できません。  
+  
+ 以下の手順では、<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> を使用して署名確認を有効にする方法を示します。<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> でも同じ手順を使用できます。この手順は、「[方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)」に記載されている基本的な手順に基づいています。  
+  
+### コードを使用して署名確認を有効にするには  
+  
+1.  <xref:System.ServiceModel.Channels.BindingElementCollection> クラスのインスタンスを作成します。  
+  
+2.  <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> クラスのインスタンスを作成します。  
+  
+3.  <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.RequireSignatureConfirmation%2A> を `true` に設定します。  
+  
+4.  バインディング コレクションにセキュリティ要素を追加します。  
+  
+5.  「[方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)」の記載に従って、カスタム バインディングを作成します。  
+  
+### 構成を使用して署名確認を有効にするには  
+  
+1.  `<customBinding>` 要素を構成ファイルの `<bindings>` セクションに追加します。  
+  
+2.  `<binding>` 要素を追加し、名前属性を適切な値に設定します。  
+  
+3.  適切なエンコード要素を追加します。次の例では `<TextMessageEncoding>` 要素を追加しています。  
+  
+4.  `<security>` 子要素を追加し、`requireSignatureConfirmation` 属性を `true` に設定します。  
+  
+5.  省略可能。ブートストラップ中に署名確認を有効にするには、[\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md) 子要素を追加し、`equireSignatureConfirmation` 属性を `true` に設定します。  
+  
+6.  適切なトランスポート要素を追加します。次の例では、[\<httpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httptransport.md)を追加します。  
+  
+    ```  
+    <bindings>  
+      <customBinding>  
+        <binding name="SignatureConfirmationBinding">  
+          <security requireSignatureConfirmation="true">  
+            <secureConversationBootstrap requireSignatureConfirmation="true" />  
+              </security>  
+           <textMessageEncoding />  
+             <httpTransport />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    ```  
+  
+## 使用例  
+ 次のコードでは、<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> のインスタンスを作成し、<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement.RequireSignatureConfirmation%2A> プロパティを `true` に設定しています。この例では、前の例で示した `<secureConversationBootstrap>` 要素は使用していません。この例は、Windows \(Kerberos プロトコル\) トークンを使用した場合の署名確認を示しています。この場合、クライアントの署名はサービスからのすべての応答で返され、クライアントによって確認されます。  
+  
+ [!code-csharp[c_SignatureConfirmation#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_signatureconfirmation/cs/source.cs#1)]
+ [!code-vb[c_SignatureConfirmation#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_signatureconfirmation/vb/source.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>   
+ <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateMutualCertificateBindingElement%2A>   
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-specify-channel-security-credentials.md b/docs/framework/wcf/feature-details/how-to-specify-channel-security-credentials.md
new file mode 100644
index 00000000000..778f6a444d5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-specify-channel-security-credentials.md
@@ -0,0 +1,153 @@
+---
+title: "方法 : チャネルのセキュリティ資格情報を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8e03f47-9c4f-4dd5-8f85-429e6d876119
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# 方法 : チャネルのセキュリティ資格情報を指定する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス モニカーを使用すると、COM アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを呼び出すことができます。 ほとんどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで、クライアントは認証と承認のための資格情報の指定が要求されます。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントから呼び出す場合、この資格情報をマネージ コードまたはアプリケーション構成ファイルに指定できます。 呼び出すときに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]サービス、COM アプリケーションから使用して、 <xref:System.ServiceModel.ComIntegration.IChannelCredentials>インターフェイス資格情報を指定します。 このトピックを使用して資格情報を指定するさまざまな方法を示しますが、 <xref:System.ServiceModel.ComIntegration.IChannelCredentials>インターフェイスです。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.ComIntegration.IChannelCredentials> IDispatch ベースのインターフェイスは、Visual Studio 環境で IntelliSense 機能は得られません。  
+  
+ この記事を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]で定義されたサービス、[メッセージ セキュリティ サンプル](../../../../docs/framework/wcf/samples/message-security-sample.md)します。  
+  
+### <a name="to-specify-a-client-certificate"></a>クライアント証明書を指定するには  
+  
+1.  メッセージ セキュリティのディレクトリの Setup.bat ファイルを実行し、必要なテスト証明書を作成してインストールします。  
+  
+2.  メッセージ セキュリティのプロジェクトを開きます。  
+  
+3.  追加`[ServiceBehavior(Namespace=``http://Microsoft.ServiceModel.Samples``)]`に、`ICalculator`インターフェイス定義です。  
+  
+4.  追加`bindingNamespace=``http://Microsoft.ServiceModel.Samples`サービスの App.config 内のエンドポイント タグにします。  
+  
+5.  メッセージ セキュリティ サンプルをビルドし、Service.exe を実行します。 Internet Explorer を使用してサービスの URI (http://localhost:8000/ServiceModelSamples/Service) を参照し、サービスが動作していることを確認します。  
+  
+6.  Visual Basic 6.0 を開き、新しい標準 .exe ファイルを作成します。 フォームにボタンを追加し、追加したボタンをダブルクリックして次のコードをクリック ハンドラーに追加します。  
+  
+    ```  
+        monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
+        monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
+        monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  
+        monString = monString + ", binding=BasicHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
+  
+        Set monikerProxy = GetObject(monString)  
+  
+        'Set the Service Certificate.  
+     monikerProxy.ChannelCredentials.SetServiceCertificateAuthentication "CurrentUser", "NoCheck", "PeerOrChainTrust"  
+    monikerProxy.ChannelCredentials.SetDefaultServiceCertificateFromStore "CurrentUser", "TrustedPeople", "FindBySubjectName", "localhost"  
+  
+        'Set the Client Certificate.  
+        monikerProxy.ChannelCredentials.SetClientCertificateFromStoreByName "CN=client.com", "CurrentUser", "My"  
+        MsgBox monikerProxy.Add(3, 4)  
+    ```  
+  
+7.  Visual Basic アプリケーションを実行し、結果を確認します。  
+  
+     Visual Basic アプリケーションに Add(3,4) の結果を示すメッセージ ボックスが表示されます。 <xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetClientCertificateFromFile%28System.String%2CSystem.String%2CSystem.String%29>または<xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetClientCertificateFromStoreByName%28System.String%2CSystem.String%2CSystem.String%29>の代わりに使用することもできます<xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetClientCertificateFromStore%28System.String%2CSystem.String%2CSystem.String%2CSystem.Object%29>クライアント資格情報を設定します。  
+  
+    ```  
+    monikerProxy.ChannelCredentials.SetClientCertificateFromFile "C:\MyClientCert.pfx", "password", "DefaultKeySet"  
+    ```  
+  
+> [!NOTE]
+>  この呼び出しを機能させるには、クライアントが実行されているコンピューターでクライアント証明書を信頼する必要があります。  
+  
+> [!NOTE]
+>  モニカーの形式が正しくないか、`GetObject` を呼び出せない場合は、"構文が無効です" というメッセージが返されます。 このエラーが発生した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。  
+  
+### <a name="to-specify-user-name-and-password"></a>ユーザー名とパスワードを指定するには  
+  
+1.  `wsHttpBinding` を使用するよう App.config ファイルを変更します。 これは、ユーザー名とパスワードの検証に必要です。  
+  
+  
+  
+2.  
+          `clientCredentialType` を UserName に設定します。  
+  
+  
+  
+3.  Visual Basic 6.0 を開き、新しい標準 .exe ファイルを作成します。 フォームにボタンを追加し、追加したボタンをダブルクリックして次のコードをクリック ハンドラーに追加します。  
+  
+    ```  
+    monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
+    monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
+    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  
+    monString = monString + ", binding=WSHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
+  
+    Set monikerProxy = GetObject(monString)  
+  
+    monikerProxy.ChannelCredentials.SetServiceCertificateAuthentication "CurrentUser", "NoCheck", "PeerOrChainTrust"  
+    monikerProxy.ChannelCredentials.SetUserNameCredential "username", "password"  
+  
+    MsgBox monikerProxy.Add(3, 4)  
+    ```  
+  
+4.  Visual Basic アプリケーションを実行し、結果を確認します。 Visual Basic アプリケーションに Add(3,4) の結果を示すメッセージ ボックスが表示されます。  
+  
+    > [!NOTE]
+    >  この例のサービス モニカーに指定されたバインディングは、WSHttpBinding_ICalculator に変更されました。 なお、有効なユーザー名とパスワードへの呼び出しで指定する必要があります<xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetUserNameCredential%28System.String%2CSystem.String%29>します。  
+  
+### <a name="to-specify-windows-credentials"></a>Windows 資格情報を指定するには  
+  
+1.  サービスの App.config ファイルで、`clientCredentialType` を Windows に設定します。  
+  
+  
+  
+2.  Visual Basic 6.0 を開き、新しい標準 .exe ファイルを作成します。 フォームにボタンを追加し、追加したボタンをダブルクリックして次のコードをクリック ハンドラーに追加します。  
+  
+    ```  
+    monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
+    monString = monString + ", address=http://localhost:8000/ServiceModelSamples/Service"  
+    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  
+    monString = monString + ", binding=WSHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
+    monString = monString + ", upnidentity=domain\userID"  
+  
+    Set monikerProxy = GetObject(monString)  
+     monikerProxy.ChannelCredentials.SetWindowsCredential "domain", "userID", "password", 1, True  
+  
+    MsgBox monikerProxy.Add(3, 4)  
+    ```  
+  
+3.  Visual Basic アプリケーションを実行し、結果を確認します。 Visual Basic アプリケーションに Add(3,4) の結果を示すメッセージ ボックスが表示されます。  
+  
+    > [!NOTE]
+    >  "ドメイン"、"ユーザー ID"、"パスワード" を有効な値に置き換える必要があります。  
+  
+### <a name="to-specify-an-issue-token"></a>発行トークンを指定するには  
+  
+1.  発行トークンは、フェデレーション セキュリティを使用するアプリケーションのみが使用します。 フェデレーション セキュリティの詳細については、次を参照してください。[フェデレーションと発行されたトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)と[フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)します。  
+  
+     次の Visual Basic のコード例を呼び出す方法を示しています、 <xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetIssuedToken%28System.String%2CSystem.String%2CSystem.String%29>メソッド。  
+  
+    ```  
+        monString = "service:mexAddress=http://localhost:8000/ServiceModelSamples/Service?wsdl"  
+        monString = monString + ", address=http://localhost:8000/SomeService/Service"  
+        monString = monString + ", contract=ICalculator, contractNamespace=http://SomeService.Samples"  
+        monString = monString + ", binding=WSHttpBinding_ISomeContract, bindingNamespace=http://SomeService.Samples"  
+  
+        Set monikerProxy = GetObject(monString)  
+    monikerProxy.SetIssuedToken("http://somemachine/sts", "bindingType", "binding")  
+    ```  
+  
+     このメソッドのパラメーターの詳細については、次を参照してください。 <xref:System.ServiceModel.ComIntegration.IChannelCredentials.SetIssuedToken%28System.String%2CSystem.String%2CSystem.String%29>します。  
+  
+## <a name="see-also"></a>関連項目  
+ [フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)   
+ [方法: フェデレーション サービスで資格情報を構成します。](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [方法: フェデレーション クライアントを作成します。](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [メッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)   
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md b/docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md
new file mode 100644
index 00000000000..bf4c0c48221
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md
@@ -0,0 +1,64 @@
+---
+title: "探索プロキシをテストする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d96e3fa2-3c42-4e5d-8244-2694081bdc32
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 探索プロキシをテストする方法
+これは、探索プロキシの実装方法に関する 4 つのトピックのうちの 4 番目のトピックです。  前のトピック「[探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)」では、探索プロキシを使用してサービスを検索し、そのサービスを呼び出す [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションを実装しました。  このトピックでは、探索プロキシ、サービス、およびクライアント アプリケーションが予期したとおりに動作することを確認する方法について説明します。  
+  
+### 探索プロキシの実行  
+  
+1.  管理者としてコマンド プロンプトを開きます。  
+  
+2.  "このプログラムの機能のいくつかが Windows ファイアウォールでブロックされています" という内容のダイアログが表示される場合があります。  このメッセージが表示された場合は、**\[ブロックを解除する\]** をクリックします。  
+  
+3.  コマンド プロンプトから、探索プロキシ DiscoveryProxy.exe を実行します。  
+  
+4.  「`Proxy started. Hit Enter to exit`」というテキストが表示されます。  
+  
+### 探索サービスの実行  
+  
+1.  管理者としてコマンド プロンプトを開きます。  
+  
+2.  コマンド プロンプトから、探索サービス Service.exe を実行します。  
+  
+3.  DiscoveryProxy.exe により、次のテキストが表示されます。`******* Adding the following service: ** [Service Contract Name] ** [Service Endpoint Addr] 3.******* Done *******` .  
+  
+### クライアント アプリケーションの実行  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  コマンド プロンプトから、client.exe アプリケーションを実行します。  
+  
+3.  数秒後に、クライアント アプリケーションにより「\<サービス エンドポイント\> に接続しています」というテキストが表示されます。  
+  
+4.  次に、service.exe により「Greeting request received, I will respond」というテキストが表示されます。  
+  
+5.  その後、client.exe により「Hello Client\!」というテキストが表示されます。  
+  
+### アプリケーションのシャットダウン  
+  
+1.  クライアント アプリケーションをシャットダウンします。  
+  
+2.  サービスをシャットダウンします。  探索プロキシにより、次のテキストが表示されます。`******* Removing the following service: ** [Service Contract Name] ** [Service Endpoint Addr] 2.3.******* Done *******`  
+  
+3.  探索プロキシをシャットダウンします。  
+  
+## 参照  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [探索プロキシを実装する方法](../../../../docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md)   
+ [探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)   
+ [探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-a-custom-user-name-and-password-validator.md b/docs/framework/wcf/feature-details/how-to-use-a-custom-user-name-and-password-validator.md
new file mode 100644
index 00000000000..994c2a5c9f3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-a-custom-user-name-and-password-validator.md
@@ -0,0 +1,127 @@
+---
+title: "方法 : カスタム ユーザー名およびパスワード検証を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, ユーザー名とパスワード"
+ms.assetid: 8e08b74b-fa44-4018-b63d-0d0805f85e3f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : カスタム ユーザー名およびパスワード検証を使用する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、認証にユーザー名とパスワードを使用すると、既定の Windows 認証を使用してユーザー名とパスワードが検証されます。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、*"検証コントロール"* と呼ばれるカスタムのユーザー名\/パスワード認証方式を使用できます。ユーザー名およびパスワードのカスタム検証を組み込むには、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator> から派生するクラスを作成して構成します。  
+  
+ サンプル アプリケーションについては、「[ユーザー名パスワード検証](../../../../docs/framework/wcf/samples/user-name-password-validator.md)」を参照してください。  
+  
+### カスタムのユーザー名\/パスワード検証コントロールを作成するには  
+  
+1.  <xref:System.IdentityModel.Selectors.UserNamePasswordValidator> から派生するクラスを作成します。  
+  
+     [!code-csharp[C_CustomUsernameAndPasswordValidator#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customusernameandpasswordvalidator/cs/service.cs#3)]
+     [!code-vb[C_CustomUsernameAndPasswordValidator#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customusernameandpasswordvalidator/vb/service.vb#3)]  
+  
+2.  <xref:System.IdentityModel.Selectors.UserNamePasswordValidator.Validate%2A> メソッドをオーバーライドして、カスタム認証方式を実装します。  
+  
+     次の例のコードは、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator.Validate%2A> メソッドをオーバーライドします。稼働環境では、このようなコードを使用しないでください。このコードをカスタムのユーザー名\/パスワード検証方式に置き換えます。この場合、ユーザー名とパスワードの組み合わせをデータベースから取得する必要があります。  
+  
+     クライアントに認証エラーを返すには、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator.Validate%2A> メソッドで <xref:System.ServiceModel.FaultException> をスローします。  
+  
+     [!code-csharp[C_CustomUsernameAndPasswordValidator#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customusernameandpasswordvalidator/cs/service.cs#4)]
+     [!code-vb[C_CustomUsernameAndPasswordValidator#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customusernameandpasswordvalidator/vb/service.vb#4)]  
+  
+### カスタムのユーザー名\/パスワード検証コントロールを使用するようにサービスを構成するには  
+  
+1.  任意のトランスポート上のメッセージ セキュリティ、または HTTP\(S\) 上のトランスポート レベル セキュリティを使用するバインディングを構成します。  
+  
+     メッセージ セキュリティを使用する場合は、メッセージ セキュリティと `UserName` 資格情報の種類をサポートするシステム指定のバインディングのいずれか \([\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) や [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) など\) を追加します。  
+  
+     HTTP\(S\) 上のトランスポート レベル セキュリティを使用する場合は、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) と [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) のいずれか、[\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)、または HTTP\(S\) と `Basic` 認証方式を使用する [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) を追加します。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] 以降を使用する場合は、メッセージおよびトランスポート セキュリティでカスタムのユーザー名\/パスワード検証コントロールを使用できます。[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] では、カスタムのユーザー名\/パスワード検証コントロールを使用できるのは、メッセージ セキュリティだけです。  
+  
+    > [!TIP]
+    >  このコンテキストでの \<netTcpBinding\> の使用方法の詳細については、「[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)」を参照してください。  
+  
+    1.  構成ファイルの [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素の下に、[\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素を追加します。  
+  
+    2.  [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素または [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素をバインド セクションに追加します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインド要素の作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成でサービス バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。  
+  
+    3.  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)または [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md) の `mode` 属性を `Message`、`Transport`、または `TransportWithMessageCredential` に設定します。  
+  
+    4.  [\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md)または [\<transport\>](../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md) の `clientCredentialType` 属性を設定します。  
+  
+         メッセージ セキュリティを使用する場合は、[\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md) の `clientCredentialType` 属性を `UserName` に設定します。  
+  
+         HTTP\(S\) 上でトランスポート レベルのセキュリティを使用する場合は、[\<transport\>](../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-wshttpbinding.md) または [\<transport\>](../../../../docs/framework/configure-apps/file-schema/wcf/transport-of-basichttpbinding.md) の `clientCredentialType` 属性を `Basic` に設定します。  
+  
+        > [!NOTE]
+        >  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスがインターネット インフォメーション サービス \(IIS\) でトランスポート レベルのセキュリティを使用してホストされており、<xref:System.ServiceModel.Security.UserNamePasswordServiceCredential.UserNamePasswordValidationMode%2A> プロパティが <xref:System.ServiceModel.Security.UserNamePasswordValidationMode> に設定されている場合、カスタム認証方式では Windows 認証のサブセットが使用されます。これは、このシナリオの場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がカスタム認証を呼び出す前に IIS によって Windows 認証が実行されるためです。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインド要素の作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成でサービス バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。  
+  
+     次のコード例は、バインディングの構成コードを示しています。  
+  
+    ```  
+    <system.serviceModel>   
+      <bindings>  
+      <wsHttpBinding>  
+          <binding name="Binding1">  
+            <security mode="Message">  
+              <message clientCredentialType="UserName" />  
+            </security>  
+          </binding>          
+        </wsHttpBinding>  
+      </bindings>  
+    </system.serviceModel>  
+    ```  
+  
+2.  受信 <xref:System.IdentityModel.Tokens.UserNameSecurityToken> セキュリティ トークンのユーザー名とパスワードの組み合わせを検証する際に、カスタムのユーザー名\/パスワード検証コントロールを使用することを指定する動作を構成します。  
+  
+    1.  [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素の子として [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素を追加します。  
+  
+    2.  [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) を [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素に追加します。  
+  
+    3.  [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md) 要素を追加し、`name` 属性に適切な値を設定します。  
+  
+    4.  [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)を [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-servicebehaviors.md) 要素に追加します。  
+  
+    5.  [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)に [\<userNameAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md)を追加します。  
+  
+    6.  `userNamePasswordValidationMode` を `Custom` に設定します。  
+  
+        > [!IMPORTANT]
+        >  `userNamePasswordValidationMode` 値が設定されていない場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、カスタムのユーザー名\/パスワード検証コントロールの代わりに Windows 認証が使用されます。  
+  
+    7.  `customUserNamePasswordValidatorType` を、カスタムのユーザー名\/パスワード検証コントロールを表す型に設定します。  
+  
+     次の例に、この時点での `<serviceCredentials>` のフラグメントを示します。  
+  
+    ```  
+    <serviceCredentials>  
+      <userNameAuthentication userNamePasswordValidationMode="Custom" customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.CalculatorService.CustomUserNameValidator, service" />  
+    </serviceCredentials>  
+    ```  
+  
+## 使用例  
+ カスタムのユーザー名\/パスワード検証コントロールを作成する方法を次のコード例に示します。稼働環境では、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator.Validate%2A> メソッドをオーバーライドするコードを使用しないでください。このコードをカスタムのユーザー名\/パスワード検証方式に置き換えます。この場合、ユーザー名とパスワードの組み合わせをデータベースから取得する必要があります。  
+  
+ [!code-csharp[C_CustomUsernameAndPasswordValidator#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customusernameandpasswordvalidator/cs/service.cs#1)]
+ [!code-vb[C_CustomUsernameAndPasswordValidator#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customusernameandpasswordvalidator/vb/service.vb#1)]  
+[!code-csharp[C_CustomUsernameAndPasswordValidator#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_customusernameandpasswordvalidator/cs/service.cs#2)]
+[!code-vb[C_CustomUsernameAndPasswordValidator#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_customusernameandpasswordvalidator/vb/service.vb#2)]  
+  
+## 参照  
+ <xref:System.IdentityModel.Selectors.UserNamePasswordValidator>   
+ [方法 : ASP.NET メンバーシップ プロバイダーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md)   
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-metadata-exchange-contracts.md b/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-metadata-exchange-contracts.md
new file mode 100644
index 00000000000..5a6b83b53bb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-metadata-exchange-contracts.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Metadata Exchange コントラクトと共にサービス モニカーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c41a07e5-cb9d-45d6-9ea4-34511e227faf
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : Metadata Exchange コントラクトと共にサービス モニカーを使用する
+新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをいくつか開発した後に、そのサービスをスクリプトまたは Visual Basic 6.0 アプリケーションから呼び出せるようにする必要が生じる場合があります。  この方法の 1 つに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アセンブリを作成し、そのアセンブリを COM を使用して登録して GAC にインストールし、Visual Basic コードで COM 型を参照する方法があります。  アプリケーションを配布するときに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アセンブリも配信する必要があります。  次にユーザーは COM を使用して WCF クライアント アセンブリを登録し、それを GAC に配置する必要があります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] COM Interop でも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アセンブリに依存しない同じサービス呼び出しを作成できます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] モニカーを使用すれば、サービスに関する型情報を抽出するためにサービス モニカーで使用されるメタデータ交換 \(Mex\) エンドポイント URI を指定することにより、必要な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを任意の COM 互換言語 \(Visual Basic、VBScript、Visual Basic for Applications \(VBA\) など\) から呼び出すことができます。  ここでは、Mex エンドポイントを指定する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] モニカーを使用して、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の入門サンプルを呼び出す方法を説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アセンブリで定義された型は、実際にインスタンス化されることはありません。  アセンブリはメタデータにのみ使用されます。  
+  
+### Mex アドレスを使うサービス モニカーの使用  
+  
+1.  入門サンプルを構築し、Internet Explorer を使用してその URL \(http:\/\/localhost\/ServiceModelSamples\/Service.svc\) を参照し、サービスが動作していることを確認します。  
+  
+2.  Visual Basic スクリプトまたは Visual Basic アプリケーションを作成し、次のコードを記述します。  
+  
+    ```  
+    monString = "service:mexaddress=http://localhost/ServiceModelSamples/Service.svc/MEX"  
+    monString = monString + ", address=http://localhost/ServiceModelSamples/Service.svc"  
+    monString = monString + ", contract=ICalculator, contractNamespace=http://Microsoft.ServiceModel.Samples"  
+    monString = monString + ", binding=WSHttpBinding_ICalculator, bindingNamespace=http://Microsoft.ServiceModel.Samples"  
+  
+    Set calc = GetObject(monString)  
+    MsgBox calc.Add(3, 4)  
+    ```  
+  
+3.  作成した Visual Basic アプリケーションまたはスクリプトを実行します。  
+  
+    > [!NOTE]
+    >  モニカーがサービスのメタデータを読み取るには、呼び出すサービスで、Mex エンドポイントが公開されている必要があります。  詳細については、「[方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  モニカーの形式が正しくないか、`GetObject` を呼び出せない場合は、"構文が無効です" というメッセージが返されます。このエラーが発生した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。  
+  
+## 参照  
+ [方法 : 未登録で Windows Communication Foundation のサービス モニカーを使用する](../../../../docs/framework/wcf/feature-details/use-the-wcf-service-moniker-without-registration.md)   
+ [方法 : WSDL コントラクトと共にサービス モニカーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-wsdl-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-wsdl-contracts.md b/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-wsdl-contracts.md
new file mode 100644
index 00000000000..f91d6563f9e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-wsdl-contracts.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : WSDL コントラクトと共にサービス モニカーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a88d9650-bb50-4f48-8c85-12f5ce98a83a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : WSDL コントラクトと共にサービス モニカーを使用する
+完全に自己完結型である COM Interop クライアントの構築が必要になる場合があります。呼び出そうとするサービスで MEX エンドポイントが公開されておらず、WCF クライアントの DLL が COM interop に登録されていないこともあります。このような場合、サービスを記述した WSDL ファイルを作成し、そのファイルを WCF サービス モニカーに渡すことができます。ここでは、WCF WSDL モニカーを使用して、WCF の入門サンプルを呼び出す方法を説明します。  
+  
+### WSDL サービス モニカーの使用  
+  
+1.  入門サンプル ソリューションを開き、ビルドします。  
+  
+2.  Internet Explorer を開いて http:\/\/localhost\/ServiceModelSamples\/Service.svc に移動し、サービスが動作していることを確認します。  
+  
+3.  Service.cs ファイルで、次の属性を CalculatorService クラスに追加します。  
+  
+     [!code-csharp[S_WSDL_Client#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_wsdl_client/cs/service.cs#0)]  
+  
+4.  バインディング名前空間をサービスの App.config に追加します。  
+  
+  
+  
+5.  アプリケーションが読み取る WSDL ファイルを作成します。名前空間を手順 3. と 4. で追加したので、IE で http:\/\/localhost\/ServiceModelSamples\/Service.svc?wsdl を表示することによって、サービスの WSDL 記述全体を照会できます。次に、そのファイルをサービスの WSDL.xml として Internet Explorer で保存できます。手順 3. と 4. で名前空間を指定しなかった場合、上記の URL を照会したときに返される WSDL ドキュメントは、完全な WSDL ではありません。返される WSDL ドキュメントには、他の WSDL ドキュメントをインポートするためのインポート ステートメントが追加されています。各インポート ステートメントを実行し、サービスから返された WSDL とインポートした WSDL を組み合わせることによって、完全な WSDL ドキュメントを作成する必要があります。  
+  
+6.  Visual Basic 6.0 を開き、新しい標準 .exe ファイルを作成します。フォームにボタンを追加し、追加したボタンをダブルクリックして次のコードをクリック ハンドラーに追加します。  
+  
+    ```  
+    ' Open the WSDL contract file and read it all into the wsdlContract string.  
+    Const ForReading = 1  
+    Set objFSO = CreateObject("Scripting.FileSystemObject")  
+    Set objFile = objFSO.OpenTextFile("c:\serviceWsdl.xml", ForReading)  
+    wsdlContract = objFile.ReadAll  
+    objFile.Close  
+  
+    ' Create a string for the service moniker including the content of the WSDL contract file.  
+    wsdlMonikerString = "service4:address='http://localhost/ServiceModelSamples/service.svc'"  
+    wsdlMonikerString = wsdlMonikerString + ", wsdl='" & wsdlContract & "'"  
+    wsdlMonikerString = wsdlMonikerString + ", binding=WSHttpBinding_ICalculator, bindingNamespace='http://Microsoft.ServiceModel.Samples'"  
+    wsdlMonikerString = wsdlMonikerString + ", contract=ICalculator, contractNamespace='http://Microsoft.ServiceModel.Samples'"  
+  
+    ' Create the service moniker object.  
+    Set wsdlServiceMoniker = GetObject(wsdlMonikerString)  
+  
+    ' Call the service operations using the moniker object.  
+    MsgBox "WSDL service moniker: 145 - 76.54 = " & wsdlServiceMoniker.Subtract(145, 76.54)  
+    ```  
+  
+    > [!NOTE]
+    >  モニカーの形式が正しくないか、`GetObject` を呼び出せない場合は、"構文が無効です" というメッセージが返されます。このエラーを受信した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。  
+  
+7.  Visual Basic アプリケーションを実行します。メッセージ ボックスに、Subtract\(145, 76.54\) を呼び出した結果が表示されます。  
+  
+## 参照  
+ [概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [COM アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md b/docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md
new file mode 100644
index 00000000000..dbd5d6f205a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md
@@ -0,0 +1,116 @@
+---
+title: "方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7cd0099e-dc3a-47e4-a38c-6e10f997f6ea
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、クライアント Web サイトの JavaScript から呼び出される ASP.NET AJAX 対応のエンドポイントを使用できるようにするサービスを作成できます。このようなエンドポイントを作成するには、他のすべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] エンドポイントと同様に、構成ファイルを使用するか、または構成要素を必要としないメソッドを使用できます。ここでは、構成を使用する方法について説明します。  
+  
+ サービス エンドポイントを ASP.NET AJAX 対応にする手順には、<xref:System.ServiceModel.WebHttpBinding> を使用するようにエンドポイントを構成し、[\<enableWebScript\>](../../../../docs/framework/configure-apps/file-schema/wcf/enablewebscript.md) エンドポイント動作を追加することが含まれます。エンドポイントの構成後、サービスを実装してホストする手順は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで使用される手順に似ています。実施例については、「[HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)」を参照してください。  
+  
+ 構成を使用せずに ASP.NET AJAX エンドポイントを構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md)」を参照してください。  
+  
+### 基本的な WCF サービスを作成するには  
+  
+1.  <xref:System.ServiceModel.ServiceContractAttribute> 属性でマークされたインターフェイスを使用して、基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス コントラクトを定義します。各操作を <xref:System.ServiceModel.OperationContractAttribute> でマークします。<xref:System.ServiceModel.ServiceContractAttribute.Namespace%2A> プロパティが設定されていることを確認します。  
+  
+    ```  
+    [ServiceContract(Namespace = "MyService")]  
+    public interface ICalculator  
+    {  
+        [OperationContract]  
+         // This operation returns the sum of d1 and d2.  
+        double Add(double n1, double n2);  
+  
+        //Other operations omitted…  
+  
+    }  
+    ```  
+  
+2.  `CalculatorService` を使用して、`ICalculator` サービス コントラクトを実装します。  
+  
+    ```  
+    public class CalculatorService : ICalculator  
+    {  
+        public double Add(double n1, double n2)  
+        {  
+            return n1 + n2;  
+        }  
+  
+    //Other operations omitted…  
+    ```  
+  
+3.  名前空間ブロック内にラップすることにより、`ICalculator` と `CalculatorService` の実装の名前空間を定義します。  
+  
+    ```  
+    Namespace Microsoft.Ajax.Samples  
+    {  
+        //Include the code for ICalculator and Caculator here.  
+    }  
+    ```  
+  
+### サービスに ASP.NET AJAX エンドポイントを作成するには  
+  
+1.  動作の構成を作成し、サービスの ASP.NET AJAX 対応のエンドポイント用に [\<enableWebScript\>](../../../../docs/framework/configure-apps/file-schema/wcf/enablewebscript.md) 動作を指定します。  
+  
+    ```  
+    <system.serviceModel>  
+        <behaviors>  
+            <endpointBehaviors>  
+                <behavior name="AspNetAjaxBehavior">  
+                    <enableWebScript />  
+                </behavior>  
+            </endpointBehaviors>  
+        </behaviors>  
+    </system.serviceModel>  
+    ```  
+  
+2.  <xref:System.ServiceModel.WebHttpBinding> と、前の手順で定義した ASP.NET AJAX 動作を使用するサービスのエンドポイントを作成します。  
+  
+    ```  
+    <system.serviceModel>  
+        <services>  
+            <service name="Microsoft.Ajax.Samples.CalculatorService">  
+                <endpoint address=""  
+                    behaviorConfiguration="AspNetAjaxBehavior"   
+                    binding="webHttpBinding"  
+                    contract="Microsoft.Ajax.Samples.ICalculator" />  
+            </service>  
+        </services>  
+    </system.serviceModel>   
+    ```  
+  
+### IIS でサービスをホストするには  
+  
+1.  IIS でサービスをホストするには、アプリケーションで .svc 拡張子の新しいサービス ファイルを作成します。サービスに該当する [@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブ情報を追加して、このファイルを編集します。たとえば、`CalculatorService` サンプルに対応するサービス ファイルのコンテンツには、次の情報が記述されています。  
+  
+    ```  
+    <%@ServiceHost   
+    language=c#   
+    Debug="true"   
+    Service="Microsoft.Ajax.Samples.CalculatorService"  
+    %>  
+    ```  
+  
+2.  IIS でのホスト[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : IIS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)」を参照してください。  
+  
+### サービスを呼び出すには  
+  
+1.  エンドポイントは .svc ファイルを基準にした空のアドレスの位置に構成されているので、サービスは使用可能であり、service.svc\/\<操作\> に対して要求を送信することで、サービスを呼び出すことができます。たとえば、service.svc\/Add では `Add` 操作を呼び出します。これは、ASP.NET AJAX Script Manager コントロールのスクリプト コレクションにエンドポイント URL を入力することで使用できます。例については、「[HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)」を参照してください。  
+  
+## 参照  
+ [ASP.NET AJAX 用の WCF サービスの作成](../../../../docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md)   
+ [方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-filters.md b/docs/framework/wcf/feature-details/how-to-use-filters.md
new file mode 100644
index 00000000000..a1a4c162554
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-filters.md
@@ -0,0 +1,347 @@
+---
+title: "フィルターを使用する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2c7255f-c376-460e-aa20-14071f1666e5
+caps.latest.revision: 12
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# フィルターを使用する方法
+ここでは、複数のフィルターを使用したルーティング構成を作成するために必要な基本手順について説明します。  この例では、メッセージが、電卓サービスの 2 つの実装である regularCalc および roundingCalc にルーティングされます。  これらの実装は両方とも同じ操作をサポートしますが、片方のサービスでは、値を返す前にすべての計算を最も近い整数値に丸めます。  クライアント アプリケーションが、丸め処理を行うバージョンのサービスを使用するかどうかを表示可能である必要がありますが、優先するサービスが示されていない場合は、メッセージが 2 つのサービス間で負荷分散されます。  次の操作が両方のサービスによって公開されます。  
+  
+-   追加  
+  
+-   減算  
+  
+-   乗算  
+  
+-   除算  
+  
+ どちらのサービスも同じ操作を実装するため、アクション フィルターを使用することはできません。メッセージで指定されるアクションが一意にならないためです。  代わりに、メッセージが適切なエンドポイントに必ずルーティングされるための追加作業が必要になります。  
+  
+### 一意なデータを特定する  
+  
+1.  両方のサービス実装が同じ操作を処理し、返すデータを除いて基本的に同一であるため、クライアント アプリケーションから送信されるメッセージに含まれる基本データでは、要求をルーティングする方法を特定できません。  ただし、クライアント アプリケーションでメッセージに一意のヘッダー値を追加すると、この値を使用して、メッセージのルーティング方法を決定できます。  
+  
+     この例では、クライアント アプリケーションで丸め処理を行う電卓を使ってメッセージを処理する必要がある場合に、次のコードを使用してカスタム ヘッダーを追加します。  
+  
+    ```csharp  
+    messageHeadersElement.Add(MessageHeader.CreateHeader("RoundingCalculator",   
+                                   "http://my.custom.namespace/", "rounding"));  
+  
+    ```  
+  
+     これで、XPath フィルターを使用して、メッセージにこのヘッダーが含まれるかどうかを確認し、このヘッダーを持つメッセージを roundCalc サービスにルーティングできるようになります。  
+  
+2.  さらに、ルーティング サービスが、EndpointName、EndpointAddress、または PrefixEndpointAddress の各フィルターと共に使用できる仮想サービス エンドポイントを 2 つ公開し、クライアント アプリケーションの要求の送信先エンドポイントに基づいて、受信メッセージを特定の電卓の実装に一意にルーティングします。  
+  
+### エンドポイントを定義する  
+  
+1.  ルーティング サービスで使用するエンドポイントを定義する場合は、最初にクライアントおよびサービスが使用するチャンネルの形状を決める必要があります。  このシナリオでは、両方の送信先サービスで要求\/応答パターンが使用されるため、<xref:System.ServiceModel.Routing.IRequestReplyRouter> を使用します。  次の例では、ルーティング サービスが公開するサービス エンドポイントを定義します。  
+  
+    ```xml  
+    <services>  
+          <service behaviorConfiguration="routingConfiguration"  
+                   name="System.ServiceModel.Routing.RoutingService">  
+            <host>  
+              <baseAddresses>  
+                <add baseAddress="http://localhost/routingservice/router" />  
+              </baseAddresses>  
+            </host>  
+            <!--Set up the inbound endpoints for the Routing Service-->  
+            <!--first create the general router endpoint-->  
+            <endpoint address="general"  
+                      binding="wsHttpBinding"  
+                      name="routerEndpoint"  
+                      contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+            <!--create a virtual endpoint for the regular calculator service-->  
+            <endpoint address="regular/calculator"  
+                      binding="wsHttpBinding"  
+                      name="calculatorEndpoint"  
+                      contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+            <!--now create a virtual endpoint for the rounding calculator-->  
+            <endpoint address="rounding/calculator"  
+                      binding="wsHttpBinding"  
+                      name="roundingEndpoint"  
+                      contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+  
+          </service>  
+    </services>  
+  
+    ```  
+  
+     この構成では、ルーティング サービスは 3 つの別個のエンドポイントを公開します。  実行時の選択に応じて、クライアント アプリケーションは、これらのアドレスの 1 つにメッセージを送ります。  "仮想" サービス エンドポイントの 1 つ \("rounding\/calculator" または "regular\/calculator"\) に到着したメッセージは、対応する電卓の実装に転送されます。  クライアント アプリケーションが特定のエンドポイントに要求を送信しない場合、メッセージの送信先は標準のエンドポイントになります。  選択されたエンドポイントにかかわらず、クライアント アプリケーションでは、メッセージにカスタム ヘッダーを含めるように選択することで、丸め処理を行う電卓の実装にメッセージを転送するように指定することもできます。  
+  
+2.  次の例では、ルーティング サービスによるメッセージのルーティング先であるクライアント \(送信先\) エンドポイントを定義します。  
+  
+    ```xml  
+    <client>  
+          <endpoint name="regularCalcEndpoint"  
+                    address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                    binding="netTcpBinding"  
+                    contract="*" />  
+  
+          <endpoint name="roundingCalcEndpoint"  
+                    address="net.tcp://localhost:8080/servicemodelsamples/service/"  
+                    binding="netTcpBinding"  
+                    contract="*" />  
+    </client>  
+  
+    ```  
+  
+     これらのエンドポイントは、特定のフィルターと一致したメッセージの送信先エンドポイントを示すために、フィルター テーブルで使用されます。  
+  
+### フィルターを定義する  
+  
+1.  クライアント アプリケーションがメッセージに追加した "RoundingCalculator" カスタム ヘッダーに基づいてメッセージをルーティングするには、このヘッダーの有無を確認するための XPath クエリを使用したフィルターを定義します。  このヘッダーは、カスタムの名前空間を使用して定義されるため、XPath クエリで使用されているカスタムの名前空間プレフィックス "custom" を定義する、名前空間のエントリも追加します。  次の例では、必要なルーティング セクション、名前空間のテーブル、および XPath フィルターを定義します。  
+  
+    ```xml  
+    <routing>  
+          <!-- use the namespace table element to define a prefix for our custom namespace-->  
+          <namespaceTable>  
+            <add prefix="custom" namespace="http://my.custom.namespace/"/>  
+          </namespaceTable>  
+          <filters>  
+            <!--define the different message filters-->  
+            <!--define an xpath message filter to look for the custom header coming from the client-->  
+            <filter name="XPathFilter" filterType="XPath"   
+                    filterData="/s12:Envelope/s12:Header/custom:RoundingCalculator = 'rounding'"/>  
+          </filters>  
+    </routing>  
+  
+    ```  
+  
+     この **MessageFilter** は、"rounding" という値を含むメッセージに RoundingCalculator ヘッダーがあるかどうかを検索します。  このヘッダーは、メッセージを roundingCalc サービスにルーティングする必要があることを示すために、クライアント側で設定されたものです。  
+  
+    > [!NOTE]
+    >  s12 の名前空間プレフィックスは、既定で名前空間のテーブルで定義され、名前空間 "http:\/\/www.w3.org\/2003\/05\/soap\-envelope" を表します。  
+  
+2.  また、2 つの仮想エンドポイントで受信したメッセージがあるかどうかを検索するフィルターも定義する必要があります。  1 つ目の仮想エンドポイントは、"regular\/calculator" エンドポイントです。  クライアントは、メッセージを regularCalc サービスにルーティングする必要があることを示すために、このエンドポイントに要求を送信できます。  次の構成では、<xref:System.ServiceModel.Dispatcher.EndpointNameMessageFilter> を使用するフィルターを定義して、filterData で指定された名前のエンドポイントでメッセージが受信されたかどうかを確認します。  
+  
+    ```xml  
+    <!--define an endpoint name filter looking for messages that show up on the virtual regular calculator endpoint-->  
+    <filter name="EndpointNameFilter" filterType="EndpointName" filterData="calculatorEndpoint"/>  
+  
+    ```  
+  
+     "calculatorEndpoint" という名前のサービス エンドポイントでメッセージが受信された場合は、このフィルターが `true` に評価されます。  
+  
+3.  次に、roundingEndpoint のアドレスに送信されたメッセージがあるかどうかを検索するフィルターを定義します。  クライアントは、メッセージを roundingCalc サービスにルーティングする必要があることを示すために、このエンドポイントに要求を送信できます。  次の構成では、<xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter> を使用するフィルターを定義して、"rounding\/calculator" エンドポイントでメッセージが受信されたかどうかを確認します。  
+  
+    ```xml  
+    <!--define a filter looking for messages that show up with the address prefix.  The corresponds to the rounding calc virtual endpoint-->  
+    <filter name="PrefixAddressFilter" filterType="PrefixEndpointAddress"  
+            filterData="http://localhost/routingservice/router/rounding/"/>  
+  
+    ```  
+  
+     "http:\/\/localhost\/routingservice\/router\/rounding\/" で始まるアドレスでメッセージが受信された場合は、このフィルターが **true** に評価されます。  この構成で使用されているベース アドレスは "http:\/\/localhost\/routingservice\/router" で、roundingEndpoint に指定されているアドレスは "rounding\/calculator" であるため、このエンドポイントと通信するために使用される完全なアドレスは "http:\/\/localhost\/routingservice\/router\/rounding\/calculator" となります。これは、フィルターで指定されている内容と一致します。  
+  
+    > [!NOTE]
+    >  PrefixEndpointAddress フィルターは、一致するメッセージの確認を行う際にホスト名を評価しません。これは、1 つのホストへの参照を表す際に使用できるホスト名にはさまざまな種類があり、そのすべてが、クライアント アプリケーションからホストを参照するための正しい方法であるためです。  たとえば、次の例はすべて、同じホストを参照します。  
+    >   
+    >  -   localhost  
+    > -   127.0.0.1  
+    > -   www.contoso.com  
+    > -   ContosoWeb01  
+  
+4.  最後のフィルターでは、標準のエンドポイントで受信する、カスタム ヘッダーのないメッセージのルーティングがサポートされている必要があります。  このシナリオでは、regularCalc サービスと roundingCalc サービスで交互にメッセージが処理されます。  このような "ラウンド ロビン" 方式のメッセージのルーティングをサポートするには、フィルター インスタンスおよび処理されるメッセージを 1 対 1 で一致させるカスタム フィルターを使用します。  次のコードでは、RoundRobinMessageFilter のインスタンスを 2 つ定義します。これらは、交互に使用されることを示すために、グループ化されています。  
+  
+    ```xml  
+    <!-- Set up the custom message filters.  In this example,   
+         we'll use the example round robin message filter,   
+         which alternates between the references-->  
+    <filter name="RoundRobinFilter1" filterType="Custom"  
+                    customType="CustomFilterAssembly.RoundRobinMessageFilter, CustomFilterAssembly"  
+                    filterData="group1"/>  
+    <filter name="RoundRobinFilter2" filterType="Custom"  
+                    customType="CustomFilterAssembly.RoundRobinMessageFilter, CustomFilterAssembly"  
+                    filterData="group1"/>  
+  
+    ```  
+  
+     実行中に、このフィルターの種類は、同じグループで 1 つのコレクションとして構成されている、この種類の定義済みフィルター インスタンスすべてを相次いで使用します。  これにより、このカスタム フィルターで処理されるメッセージは、RoundRobinFilter1 および RoundRobinFilter2 に交互に `true` を返します。  
+  
+### フィルター テーブルを定義する  
+  
+1.  フィルターを特定のクライアント エンドポイントと関連付けるには、それぞれをフィルター テーブル内で指定する必要があります。  このサンプルのシナリオでは、フィルターの優先順位設定も使用しています。この設定は省略可能で、フィルターを処理する順序を指定できます。  優先順位を指定しない場合は、すべてのフィルターが同時に評価されます。  
+  
+    > [!NOTE]
+    >  フィルターの優先順位を指定すると、フィルターが処理される順序を制御できますが、ルーティング サービスのパフォーマンスに影響を与える場合があります。  可能な場合は、フィルターの優先順位設定が不要になるようにフィルター ロジックを構築します。  
+  
+     次のコードでは、フィルター テーブルを定義し、以前優先順位 2 でテーブルに定義された "XPathFilter" を追加します。  ここでは、"XPathFilter" と一致したメッセージが "roundingCalcEndpoint" にルーティングされることも指定します。  
+  
+    ```xml  
+    <routing>  
+    ...      <filters>  
+    ...      </filters>  
+          <filterTables>  
+            <table name="filterTable1">  
+              <entries>  
+                <!--add the filters to the message filter table-->  
+                <!--first look for the custom header, and if we find it,  
+                    send the message to the rounding calc endpoint-->  
+                <add filterName="XPathFilter" endpointName="roundingCalcEndpoint" priority="2"/>  
+              </entries>  
+            </table>  
+          <filterTables>  
+    </routing>  
+  
+    ```  
+  
+     フィルターの優先順位を指定すると、優先順位の高いフィルターから評価されます。  指定された優先順位と一致するフィルターが 1 つまたは複数ある場合は、指定した優先順位より低いレベルのフィルターは評価されません。  ここでは、2 が、指定されている優先順位で最高であり、このレベルの唯一のフィルター エントリです。  
+  
+2.  フィルター エントリは、メッセージが特定のエンドポイントで受信されているかどうかを、エンドポイント名またはアドレスのプレフィックスを調べることによって確認するために定義されています。  次のように入力することで、これらのフィルター エントリの両方をフィルター テーブルに追加し、メッセージがルーティングされる送信先エンドポイントに関連付けます。  前の XPath フィルターがメッセージと一致しない場合にのみ、これらのフィルターが実行されるようにするため、これらのフィルターの優先順位は 1 に設定されています。  
+  
+    ```xml  
+    <!--if the header wasn't there, send the message based on which virtual endpoint it arrived at-->  
+    <!--we determine this through the endpoint name, or through the address prefix-->  
+    <add filterName="EndpointNameFilter" endpointName="regularCalcEndpoint" priority="1"/>  
+    <add filterName="PrefixAddressFilter" endpointName="roundingCalcEndpoint" priority="1"/>  
+  
+    ```  
+  
+     優先順位が 1 に設定されているため、これらのフィルターは、優先順位が 2 に設定されているフィルターがメッセージと一致しない場合にのみ評価されます。  また、両方のフィルターに同じ優先順位が指定されているため、これらは同時に評価されます。  これらのフィルターは同時に指定できないため、いずれか一方だけがメッセージと一致する可能性があります。  
+  
+3.  それまでのどのフィルターとも一致しないメッセージは、一般的なサービス エンドポイントを介して受信されており、ルーティング先を示すヘッダー情報が含まれていないメッセージです。  このようなメッセージはカスタム フィルターによって処理され、2 つの電卓サービス間で負荷分散されます。  次の例では、フィルター テーブルにフィルター エントリを追加する方法を示しています。各フィルターは、2 つの送信先エンドポイントのうちの 1 つに関連付けられます。  
+  
+    ```xml  
+    <!--if none of the other filters have matched,   
+        this message showed up on the default router endpoint,   
+        with no custom header-->  
+    <!--round robin these requests between the two services-->  
+    <add filterName="RoundRobinFilter1" endpointName="regularCalcEndpoint" priority="0"/>  
+    <add filterName="RoundRobinFilter2" endpointName="roundingCalcEndpoint" priority="0"/>  
+  
+    ```  
+  
+     これらのエントリの優先順位は 0 に設定されているため、これらのフィルターは、優先順位が高いフィルターがメッセージと一致しない場合にのみ評価されます。  また、両方のフィルターに同じ優先順位が指定されているため、これらは同時に評価されます。  
+  
+     既に説明したように、これらのフィルター定義で使用されるカスタム フィルターは、受信するメッセージごとにどちらかのフィルターだけを `true` と評価します。  このフィルターを使用して定義されたフィルターは、同じグループ設定を持つ 2 つのフィルターのみであるため、ルーティング サービスが、regularCalcEndpoint と roundingCalcEndpoint に交互に送信するという効果をもたらします。  
+  
+4.  メッセージをフィルターと照合して評価するには、最初に、フィルター テーブルをメッセージの受信に使用するサービス エンドポイントに関連付ける必要があります。  次の例は、ルーティング動作を使用して、ルーティング テーブルをサービス エンドポイントに関連付ける方法を示しています。  
+  
+    ```xml  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+## 使用例  
+ 構成ファイル全体の一覧を次に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright (c) Microsoft Corporation. All rights reserved -->  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="routingConfiguration"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost/routingservice/router" />  
+          </baseAddresses>  
+        </host>  
+        <!--Set up the inbound endpoints for the Routing Service-->  
+        <!--first create the general router endpoint-->  
+        <endpoint address="general"  
+                  binding="wsHttpBinding"  
+                  name="routerEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+        <!--create a virtual endpoint for the regular calculator service-->  
+        <endpoint address="regular/calculator"  
+                  binding="wsHttpBinding"  
+                  name="calculatorEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+        <!--now create a virtual endpoint for the rounding calculator-->  
+        <endpoint address="rounding/calculator"  
+                  binding="wsHttpBinding"  
+                  name="roundingEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />  
+  
+      </service>  
+    </services>  
+    <behaviors>  
+      <!--default routing service behavior definition-->  
+      <serviceBehaviors>  
+        <behavior name="routingConfiguration">  
+          <routing filterTableName="filterTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+    <client>  
+<!--set up the destination endpoints-->  
+      <endpoint name="regularCalcEndpoint"  
+                address="net.tcp://localhost:9090/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+  
+      <endpoint name="roundingCalcEndpoint"  
+                address="net.tcp://localhost:8080/servicemodelsamples/service/"  
+                binding="netTcpBinding"  
+                contract="*" />  
+    </client>  
+    <routing>  
+      <!-- use the namespace table element to define a prefix for our custom namespace-->  
+      <namespaceTable>  
+        <add prefix="custom" namespace="http://my.custom.namespace/"/>  
+      </namespaceTable>  
+      <filters>  
+        <!--define the different message filters-->  
+        <!--define an xpath message filter to look for the custom header coming from the client-->  
+        <filter name="XPathFilter" filterType="XPath" filterData="/s12:Envelope/s12:Header/custom:RoundingCalculator = 'rounding'"/>  
+  
+        <!--define an endpoint name filter looking for messages that show up on the virtual regular calculator endpoint-->  
+        <filter name="EndpointNameFilter" filterType="EndpointName" filterData="calculatorEndpoint"/>  
+  
+        <!--define a filter looking for messages that show up with the address prefix.  The corresponds to the rounding calc virtual endpoint-->  
+        <filter name="PrefixAddressFilter" filterType="PrefixEndpointAddress" filterData="http://localhost/routingservice/router/rounding/"/>  
+  
+        <!--Set up the custom message filters.  In this example, we'll use the example round robin message filter, which alternates between the references-->  
+        <filter name="RoundRobinFilter1" filterType="Custom" customType="CustomFilterAssembly.RoundRobinMessageFilter, CustomFilterAssembly" filterData="group1"/>  
+        <filter name="RoundRobinFilter2" filterType="Custom" customType="CustomFilterAssembly.RoundRobinMessageFilter, CustomFilterAssembly" filterData="group1"/>  
+      </filters>  
+      <filterTables>  
+        <table name="filterTable1">  
+          <entries>  
+            <!--add the filters to the message filter table-->  
+            <!--first look for the custom header, and if we find it, send the message to the rounding calc endpoint-->  
+            <add filterName="XPathFilter" endpointName="roundingCalcEndpoint" priority="2"/>  
+  
+            <!--if the header wasn't there, send the message based on which virtual endpoint it arrived at-->  
+            <!--we determine this through the endpoint name, or through the address prefix-->  
+            <add filterName="EndpointNameFilter" endpointName="regularCalcEndpoint" priority="1"/>  
+            <add filterName="PrefixAddressFilter" endpointName="roundingCalcEndpoint" priority="1"/>  
+  
+            <!--if none of the other filters have matched, this message showed up on the default router endpoint, with no custom header-->  
+            <!--round robin these requests between the two services-->  
+            <add filterName="RoundRobinFilter1" endpointName="regularCalcEndpoint" priority="0"/>  
+            <add filterName="RoundRobinFilter2" endpointName="roundingCalcEndpoint" priority="0"/>  
+          </entries>  
+        </table>  
+      </filterTables>  
+    </routing>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [ルーティング サービス](../../../../docs/framework/wcf/samples/routing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-metadataexchangeclient-to-retrieve-metadata.md b/docs/framework/wcf/feature-details/how-to-use-metadataexchangeclient-to-retrieve-metadata.md
new file mode 100644
index 00000000000..3b4b478db92
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-metadataexchangeclient-to-retrieve-metadata.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : MetadataExchangeClient を使用してメタデータを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0754e9dc-13c5-45c2-81b5-f3da466e5a87
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 方法 : MetadataExchangeClient を使用してメタデータを取得する
+WS\-MetadataExchange \(MEX\) プロトコルを使用してメタデータをダウンロードするには、<xref:System.ServiceModel.Description.MetadataExchangeClient> クラスを使用します。取得されたメタデータ ファイルは、<xref:System.ServiceModel.Description.MetadataSet> オブジェクトとして返されます。返された <xref:System.ServiceModel.Description.MetadataSet> オブジェクトには、<xref:System.ServiceModel.Description.MetadataSection> オブジェクトのコレクションが含まれ、コレクションの各オブジェクトには、特定のメタデータの言語と識別子が含まれます。返されたメタデータはファイルに書き込むことができます。また、返されたメタデータに Web サービス記述言語 \(WSDL: Web Services Description Language\) ドキュメントが含まれている場合は、<xref:System.ServiceModel.Description.WsdlImporter> を使用してメタデータをインポートできます。  
+  
+ アドレスを取得する <xref:System.ServiceModel.Description.MetadataExchangeClient> コンストラクターは、アドレスの URI \(Uniform Resource Identifier\) スキームに一致する <xref:System.ServiceModel.Description.MetadataExchangeBindings> 静的クラスでバインディングを使用します。または、使用するバインディングを明示的に指定できるようにする <xref:System.ServiceModel.Description.MetadataExchangeClient> コンストラクターを使用することもできます。指定したバインディングは、すべてのメタデータ参照を解決するために使用されます。  
+  
+ 他の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントと同様に、<xref:System.ServiceModel.Description.MetadataExchangeClient> 型は、エンドポイント構成名を使用してクライアント エンドポイント構成を読み込むためのコンストラクターを提供します。指定したエンドポイント構成では、<xref:System.ServiceModel.Description.IMetadataExchange> コントラクトを指定する必要があります。エンドポイント構成のアドレスは読み込まれないため、アドレスを受け取る <xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> オーバーロードのいずれかを使用する必要があります。<xref:System.ServiceModel.EndpointAddress> インスタンスを使用してメタデータ アドレスを指定した場合、<xref:System.ServiceModel.Description.MetadataExchangeClient> は、指定したアドレスが MEX エンドポイントを指すものと想定します。メタデータ アドレスを URL として指定した場合は、使用する <xref:System.ServiceModel.Description.MetadataExchangeClientMode> として、MEX または HTTP GET のいずれかを指定する必要もあります。  
+  
+> [!IMPORTANT]
+>  既定では、<xref:System.ServiceModel.Description.MetadataExchangeClient> は、WSDL と XML スキーマのインポートおよびインクルードを含むすべての参照を解決します。<xref:System.ServiceModel.Description.MetadataExchangeClient.ResolveMetadataReferences%2A> プロパティを `false` に設定すると、この機能を無効にできます。解決する参照の最大数を制御するには、<xref:System.ServiceModel.Description.MetadataExchangeClient.MaximumResolvedReferences%2A> プロパティを使用します。バインディングでこのプロパティと `MaxReceivedMessageSize` プロパティを組み合わせて使用すると、取得するメタデータのサイズを制御できます。  
+  
+### MetadataExchangeClient を使用してメタデータを取得するには  
+  
+1.  新しい <xref:System.ServiceModel.Description.MetadataExchangeClient> オブジェクトを作成するには、バインディング、エンドポイント構成名、またはメタデータのアドレスを明示的に指定します。  
+  
+2.  必要に応じて <xref:System.ServiceModel.Description.MetadataExchangeClient> を構成します。たとえば、メタデータを要求するときに使用する証明書を指定したり、メタデータ参照の解決方法を制御したり、<xref:System.ServiceModel.Description.MetadataExchangeClient.OperationTimeout%2A> プロパティを設定してメタデータ要求がタイムアウトするまでの待機時間を制御したりできます。  
+  
+3.  <xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> メソッドのいずれかを呼び出して、取得されたメタデータを含む <xref:System.ServiceModel.Description.MetadataSet> オブジェクトを取得します。<xref:System.ServiceModel.Description.MetadataExchangeClient> の構築時にアドレスを明示的に指定した場合は、引数を受け取らない <xref:System.ServiceModel.Description.MetadataExchangeClient.GetMetadata%2A> オーバーロードしか使用できません。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Description.MetadataExchangeClient> を使用してメタデータ ファイルをダウンロードし、列挙する方法を次のコード例に示します。  
+  
+ [!code-csharp[MetadataResolver#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/metadataresolver/cs/client.cs#3)]  
+  
+## コードのコンパイル  
+ このコード例をコンパイルするには、System.ServiceModel.dll アセンブリを参照し、<xref:System.ServiceModel.Description> 名前空間をインポートする必要があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MetadataResolver>   
+ <xref:System.ServiceModel.Description.MetadataExchangeClient>   
+ <xref:System.ServiceModel.Description.WsdlImporter>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md b/docs/framework/wcf/feature-details/how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md
new file mode 100644
index 00000000000..2266517e09c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : MetadataResolver を使用してバインディング メタデータを動的に取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56ffcb99-fff0-4479-aca0-e3909009f605
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : MetadataResolver を使用してバインディング メタデータを動的に取得する
+ここでは、<xref:System.ServiceModel.Description.MetadataResolver> クラスを使用してバインディング メタデータを動的に取得する方法を示します。  
+  
+### バインディング メタデータを動的に取得するには  
+  
+1.  メタデータ エンドポイントのアドレスを持つ <xref:System.ServiceModel.EndpointAddress> オブジェクトを作成します。  
+  
+    ```  
+    EndpointAddress metaAddress  
+      = new EndpointAddress(new   Uri("http://localhost:8080/SampleService/mex"));  
+    ```  
+  
+2.  サービス型とメタデータ エンドポイント アドレスを渡して、<xref:System.ServiceModel.Description.MetadataResolver.Resolve%28System.Type%2CSystem.ServiceModel.EndpointAddress%29> を呼び出します。これにより、指定したコントラクトを実装したエンドポイントのコレクションが返されます。メタデータからはバインディング情報のみがインポートされます。コントラクト情報はインポートされません。提供されたコントラクトが代わりに使用されます。  
+  
+    ```  
+    ServiceEndpointCollection endpoints = MetadataResolver.Resolve(typeof(SampleServiceClient),metaAddress);  
+    ```  
+  
+3.  これで、サービス エンドポイントのコレクションを反復処理して必要なバインディング情報を抽出できます。次のコードは、エンドポイントを反復処理し、現在のエンドポイントに関連付けられたバインディングとアドレスを渡すサービス クライアント オブジェクトを作成し、そのサービスでメソッドを呼び出します。  
+  
+    ```  
+    foreach (ServiceEndpoint point in endpoints)  
+    {  
+       if (point != null)  
+       {  
+          // Create a new wcfClient using retrieved endpoints.  
+          using (wcfClient = new SampleServiceClient(point.Binding, point.Address))  
+          {  
+             Console.WriteLine(  
+               wcfClient.SampleMethod("Client used the "  
+               + point.Address.ToString() + " address."));  
+          }  
+      }  
+    }  
+    ```  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-multiple-security-tokens-of-the-same-type.md b/docs/framework/wcf/feature-details/how-to-use-multiple-security-tokens-of-the-same-type.md
new file mode 100644
index 00000000000..e2ca5c2feac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-multiple-security-tokens-of-the-same-type.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 同じ型の複数のセキュリティ トークンを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf179f48-4ed4-4caa-86a5-ef8eecc231cd
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# 方法 : 同じ型の複数のセキュリティ トークンを使用する
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 3.0 では、クライアント メッセージには任意の型のトークンを 1 つしか含めることができませんでしたが、  現在は、同じ型の複数のトークンをクライアント メッセージに含めることができるようになりました。  このトピックでは、同じ型の複数のトークンをクライアント メッセージに含める方法について説明します。  
+  
+-   この方法でサービスを構成することはできません。サービスに含めることができるサポート トークンは 1 つだけです。  
+  
+### 同じ型の複数のセキュリティ トークンを使用するには  
+  
+1.  設定する空のバインド要素コレクションを作成します。  
+  
+     [!code-csharp[C_CustomBinding#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#9)]  
+  
+2.  <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateMutualCertificateBindingElement%2A> を呼び出して <xref:System.ServiceModel.Channels.SecurityBindingElement> を作成します。  
+  
+     [!code-csharp[C_CustomBinding#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#10)]  
+  
+3.  <xref:System.ServiceModel.Security.Tokens.SupportingTokenParameters> のコレクションを作成します。  
+  
+     [!code-csharp[C_CustomBinding#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#11)]  
+  
+4.  SAML トークンをコレクションに追加します。  
+  
+     [!code-csharp[C_CustomBinding#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#12)]  
+  
+5.  コレクションを <xref:System.ServiceModel.Channels.SecurityBindingElement> に追加します。  
+  
+     [!code-csharp[C_CustomBinding#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#13)]  
+  
+6.  バインド要素をバインド要素コレクションに追加します。  
+  
+     [!code-csharp[C_CustomBinding#14](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#14)]  
+  
+7.  作成した新しいカスタム バインディングをバインド要素コレクションから返します。  
+  
+     [!code-csharp[C_CustomBinding#15](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#15)]  
+  
+## 使用例  
+ 上記の手順で説明したメソッド全体を次に示します。  
+  
+ [!code-csharp[C_CustomBinding#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombinding/cs/c_custombinding.cs#7)]  
+  
+## 参照  
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md
new file mode 100644
index 00000000000..571d7995812
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 15524274-3167-4627-b722-d6cedb9fa8c6
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする
+Svcutil.exe を使用すると、実行中のサービスからメタデータをダウンロードして、ローカル ファイルに保存できます。URL スキームが HTTP および HTTPS の場合、Svcutil.exe はメタデータの抽出に WS\-MetadataExchange および [XML Web サービス検索](http://go.microsoft.com/fwlink/?LinkId=94950)を使用します。その他の URL スキームの場合、Svcutil.exe は WS\-MetadataExchange のみを使用します。  
+  
+ 既定で、Svcutil.exe は <xref:System.ServiceModel.Description.MetadataExchangeBindings> クラスに定義されているバインディングを使用します。WS\-MetadataExchange で使用するバインディングを構成するには、Svcutil.exe の構成ファイル \(svcutil.exe.config\) でクライアント エンドポイントを定義する必要があります。このとき、クライアント エンドポイントが `IMetadataExchange` コントラクトを使用し、メタデータ エンドポイントのアドレスの URI \(Uniform Resource Identifier\) スキームと同じ名前を持つように定義します。  
+  
+> [!CAUTION]
+>  Svcutil.exe を実行して、それぞれに同じ名前の操作が含まれる 2 つの異なるサービス コントラクトを公開するサービスのメタデータを取得する場合、Svcutil.exe は、「.... からメタデータを取得できません」というエラーを表示します。たとえば、Get\(Car c\) 操作を含む ICarService という名前のサービス コントラクトを公開するサービスがあり、その同じサービスが Get\(Book b\) 操作を含む IBookService という名前のサービス コントラクトを公開する場合です。この問題を回避するには、次のいずれかの操作を実行します。  
+>   
+>  -   操作の名前を変更する。  
+> -   <xref:System.ServiceModel.OperationContractAttribute.Name%2A> を別の名前に設定する。  
+> -   <xref:System.ServiceModel.ServiceContractAttribute.Namespace%2A> プロパティを使用して、操作の名前空間のいずれかを別の名前空間に設定する。  
+  
+### Svcutil.exe を使用してメタデータをダウンロードするには  
+  
+1.  次の場所で Svcutil.exe ツールを検索します。  
+  
+     C:\\Program Files\\Microsoft SDKs\\Windows\\v1.0.\\bin  
+  
+2.  コマンド プロンプトで、次の形式を使用してツールを起動します。  
+  
+    ```  
+    svcutil.exe /t:metadata  <url>* | <epr>  
+    ```  
+  
+     メタデータをダウンロードするには `/t:metadata` オプションを指定する必要があります。このオプションを指定しないと、クライアントのコードと構成が生成されます。  
+  
+3.  \<`url`\> 引数は、メタデータを提供するサービス エンドポイントの URL またはオンラインになっているメタデータ ドキュメントの URL を指定します。\<`epr`\> 引数では、WS\-MetadataExchange をサポートするサービス エンドポイント用の WS\-Addressing `EndpointAddress` が含まれる XML ファイルへのパスを指定します。  
+  
+ このツールを使用してメタデータをダウンロードするときのその他のオプションについては、「[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)」を参照してください。  
+  
+## 使用例  
+ 次のコマンドにより、実行中のサービスからメタデータ ドキュメントがダウンロードされます。  
+  
+```  
+svcutil /t:metadata http://service/metadataEndpoint  
+```  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md
new file mode 100644
index 00000000000..5a7def26ef0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md
@@ -0,0 +1,175 @@
+---
+title: "方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95d0aed3-16a2-4398-89bb-39418eeb7355
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする
+Svcutil.exe は、次のように、コンパイル済みアセンブリのサービス、コントラクト、およびデータ型のメタデータをエクスポートできます。  
+  
+-   Svcutil.exe を使用して、アセンブリのセットに対するすべてのコンパイル済みサービス コントラクトのメタデータをエクスポートするには、入力パラメーターとして各アセンブリを指定します。これが既定の動作です。  
+  
+-   Svcutil.exe を使用して、コンパイル済みサービスのメタデータをエクスポートするには、入力パラメーターとしてサービス アセンブリを指定します。`/serviceName` オプションを使用して、エクスポートするサービスの構成名を指定する必要があります。Svcutil.exe を実行すると、指定した実行可能アセンブリの構成ファイルが自動的に読み込まれます。  
+  
+-   アセンブリ セットのすべてのデータ コントラクト型をエクスポートするには、`/dataContractOnly` オプションを使用します。  
+  
+> [!NOTE]
+>  `/reference` オプションを使用して、任意の依存アセンブリへのファイル パスを指定してください。  
+  
+### コンパイル済みサービス コントラクトのメタデータをエクスポートするには  
+  
+1.  サービス コントラクトの実装を 1 つ以上のクラス ライブラリにコンパイルします。  
+  
+2.  コンパイルされたアセンブリに対して Svcutil.exe を実行します。  
+  
+    > [!NOTE]
+    >  依存アセンブリへのファイル パスを指定するには、`/reference` スイッチを使用する必要があります。  
+  
+    ```  
+    svcutil.exe Contracts.dll  
+    ```  
+  
+### コンパイル済みサービスのメタデータをエクスポートするには  
+  
+1.  サービスの実装を実行可能アセンブリにコンパイルします。  
+  
+2.  サービス実行可能ファイルの構成ファイルを作成し、サービス構成を追加します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.serviceModel>  
+        <services>  
+          <service name="MyService" >  
+            <endpoint address="finder" contract="IPeopleFinder" binding="wsHttpBinding" />  
+          </service>  
+        </services>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+3.  コンパイルされたサービス実行可能ファイルに対して Svcutil.exe を実行します。その際、`/serviceName` スイッチを使用してサービスの構成名を指定してください。  
+  
+    > [!NOTE]
+    >  依存アセンブリへのファイル パスを指定するには、`/reference` スイッチを使用する必要があります。  
+  
+    ```  
+    svcutil.exe /serviceName:MyService Service.exe /reference:path/Contracts.dll  
+    ```  
+  
+### コンパイル済みデータ コントラクトのメタデータをエクスポートするには  
+  
+1.  データ コントラクトの実装を 1 つ以上のクラス ライブラリにコンパイルします。  
+  
+2.  コンパイルされたアセンブリに対して Svcutil.exe を実行します。その際、`/dataContract` スイッチを使用して、データ コントラクトのメタデータだけが生成されるように指定してください。  
+  
+    > [!NOTE]
+    >  依存アセンブリへのファイル パスを指定するには、`/reference` スイッチを使用する必要があります。  
+  
+    ```  
+    svcutil.exe /dataContractOnly Contracts.dll  
+    ```  
+  
+## 使用例  
+ 単純なサービス実装および構成のメタデータを生成する方法を次の例に示します。  
+  
+ サービス コントラクトのメタデータをエクスポートするには、次のように指定します。  
+  
+```  
+svcutil.exe Contracts.dll  
+```  
+  
+ データ コントラクトのメタデータをエクスポートするには、次のように指定します。  
+  
+```  
+svcutil.exe /dataContractOnly Contracts.dll  
+```  
+  
+ サービス実装のメタデータをエクスポートするには、次のように指定します。  
+  
+```  
+svcutil.exe /serviceName:MyService Service.exe /reference:<path>/Contracts.dll  
+```  
+  
+ `<path>` は Contracts.dll へのパスです。  
+  
+```  
+// The following service contract and data contracts are compiled into   
+// Contracts.dll.  
+[ServiceContract(ConfigurationName="IPeopleFinder")]  
+public interface IPersonFinder  
+{  
+    [OperationContract]  
+    Address GetAddress(Person s);  
+}  
+  
+[DataContract]  
+public class Person  
+{  
+    [DataMember]  
+    public string firstName;  
+    [DataMember]  
+    public string lastName;  
+    [DataMember]  
+    public int age;  
+}  
+  
+[DataContract]  
+public class Address  
+{  
+    [DataMember]  
+    public string city;  
+    [DataMember]  
+    public string state;  
+    [DataMember]  
+    public string street;  
+    [DataMember]  
+    public int zipCode;  
+    [DataMember]  
+    public Person person;  
+}  
+  
+// The following service implementation is compiled into Service.exe.     
+// This service uses the contracts specified in Contracts.dll.  
+[ServiceBehavior(ConfigurationName = "MyService")]  
+public class MyService : IPersonFinder  
+{  
+    public Address GetAddress(Person person)  
+    {  
+        Address address = new Address();  
+        address.person = person;  
+        return address;  
+    }  
+}  
+  
+<!-- The following is the configuration file for Service.exe. -->  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="MyService">  
+         <endpoint  address="finder"  
+                    binding="basicHttpBinding"  
+                    contract="IPeopleFinder"/>  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-validate-compiled-service-code.md b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-validate-compiled-service-code.md
new file mode 100644
index 00000000000..4fac8e25c53
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-validate-compiled-service-code.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Svcutil.exe を使用してコンパイル済みサービス コードを検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0d820fb-41c2-45b8-8f22-0fa5aeebbbaa
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : Svcutil.exe を使用してコンパイル済みサービス コードを検証する
+[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すると、サービスをホストせずにサービスの実装と構成でエラーを検出できます。  
+  
+### サービスを検証するには  
+  
+1.  サービスを実行可能ファイルおよび 1 つ以上の依存アセンブリにコンパイルします。  
+  
+2.  SDK コマンド プロンプトを開きます。  
+  
+3.  コマンド プロンプトで、次の形式を使用して Svcutil.exe ツールを起動します。  各パラメーターの詳細については、「[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)」トピックの「サービスの検証」を参照してください。  
+  
+    ```  
+    svcutil.exe /validate /serviceName:<serviceConfigName>  <assemblyPath>*  
+    ```  
+  
+     `/serviceName` オプションを使用して、検証するサービスの構成名を指定する必要があります。  
+  
+     `assemblyPath` 引数には、検証対象のサービスの実行可能ファイルへのパス、およびサービス型を格納している 1 つ以上のアセンブリへのパスを指定します。  実行可能アセンブリに、サービス構成を提供する関連構成ファイルが存在している必要があります。  標準のコマンドライン ワイルドカードを使用して、複数のアセンブリを指定できます。  
+  
+## 使用例  
+ 次のコマンドでは、myServiceHost.exe 実行可能ファイルに実装されたサービス myServiceName を検証します。  サービスの構成ファイル \(myServiceHost.exe.config\) は自動的に読み込まれます。  
+  
+```  
+svcutil /validate /serviceName:myServiceName myServiceHost.exe  
+```  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md
new file mode 100644
index 00000000000..b2ef7bd9a89
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-authorization-manager-role-provider-with-a-service.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f21deb81-91ef-49ef-94d6-494785143271
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : ASP.NET の承認マネージャー ロール プロバイダーとサービスを使用する
+[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] が Web サービスをホストする場合は、承認マネージャーをアプリケーションに統合してサービスを承認することができます。  承認マネージャーを使用して、アプリケーション開発者は個々の操作を定義できます。また、個々の操作をグループ化してタスクを形成できます。  次に管理者は、ロールを承認して特定のタスクまたは個々の操作を実行できます。  承認マネージャーでは、ロール、タスク、操作、ユーザーを管理する管理ツールとして Microsoft 管理コンソール \(MMC\) スナップインが提供されます。  管理者は、承認マネージャーのポリシー ストアを XML ファイル、Active Directory、または Active Directory アプリケーション モード \(ADAM\) ストアに構成します。  
+  
+ 承認マネージャーをアプリケーションに統合するには、Web サービスをホストする [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションの承認マネージャーの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーを構成します。  他の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーと同様、承認マネージャーの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーは \<`providers`\> 要素を使用して構成します。  
+  
+ 承認マネージャーをアプリケーションに統合する Web サービスの構成ファイルの一部を示すコード例を次に示します。  
+  
+```  
+<system.web>  
+    <roleManager enabled="true" defaultProvider="AzManRoleProvider">  
+      <providers>  
+        <add name="AzManRoleProvider"  
+             type="System.Web.Security.AuthorizationStoreRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, publicKeyToken=b03f5f7f11d50a3a"  
+             connectionStringName="AzManPolicyStoreConnectionString"   
+             applicationName="SecureService"/>  
+      </providers>  
+    </roleManager>  
+</system.web>  
+```  
+  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを統合する [!INCLUDE[crabout](../../../../includes/crabout-md.md)] については、「[方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)」を参照してください。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] で承認マネージャーを使用する [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] については、「[方法: ASP.NET 2.0 で認証マネージャー \(AzMan\) を使用する](http://go.microsoft.com/fwlink/?LinkId=71303)」を参照してください。  
+  
+## 参照  
+ [方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md
new file mode 100644
index 00000000000..f55b9b6a304
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md
@@ -0,0 +1,168 @@
+---
+title: "方法 : ASP.NET メンバーシップ プロバイダーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF と ASP.NET"
+  - "WCF, 承認"
+  - "WCF, セキュリティ"
+ms.assetid: 322c56e0-938f-4f19-a981-7b6530045b90
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法 : ASP.NET メンバーシップ プロバイダーを使用する
+[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップ プロバイダーを使用すると、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発者は、ユーザーが一意のユーザー名とパスワードの組み合わせを作成できる Web サイトを作成できます。この機能を使用すれば、ユーザーはだれでもサイトでアカウントを作成し、そのサイトにサインインして、サービスに排他的にアクセスできます。これは、ユーザーが Windows ドメイン内にアカウントを持っていることが必要な Windows セキュリティとは対照的です。自分の資格情報 \(ユーザー名とパスワードの組み合わせ\) を提示したユーザーは、だれでもサイトとそのサービスを使用できるからです。  
+  
+ サンプル アプリケーションについては、「[メンバーシップとロール プロバイダー](../../../../docs/framework/wcf/samples/membership-and-role-provider.md)」を参照してください。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダー機能の使用については、「[方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)」を参照してください。  
+  
+ メンバーシップ機能では、SQL Server データベースを使用してユーザー情報を格納する必要があります。メンバーシップ機能には、パスワードを忘れたユーザーへの質問を行うためのメソッドも含まれています。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 開発者は、セキュリティを向上させるためにこれらの機能を利用できます。この機能を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに統合した場合、ユーザーはユーザー名とパスワードの組み合わせを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションに提示する必要があります。データを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに転送するには、<xref:System.ServiceModel.WSHttpBinding> \(構成では [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)\) のような、ユーザー名\/パスワード資格情報をサポートするバインディングを使用し、クライアントの資格情報の種類を `UserName` に設定します。サービス側では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティが、ユーザー名とパスワードに基づいてユーザーを認証し、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロールによって指定されるロールを割り当てます。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザー名\/パスワードの組み合わせ、またはその他のユーザー情報をデータベースに格納するメソッドは提供されません。  
+  
+### メンバーシップ プロバイダーを構成するには  
+  
+1.  Web.config ファイルの \<`system.web`\> 要素の下に \<`membership`\> 要素を作成します。  
+  
+2.  `<membership>` `<providers> 要素の下に、` 要素を作成します。  
+  
+3.  \<`providers`\> 要素の子要素として、`<clear />` 要素を追加し、プロバイダーのコレクションをフラッシュします。  
+  
+4.  `<clear />`\< `要素の下に add`\>`name 要素を作成し、``type、``connectionStringName、``applicationName、``enablePasswordRetrieval、``enablePasswordReset、``requiresQuestionAndAnswer、``requiresUniqueEmail、``passwordFormat、および`  の各属性を適切な値に設定します。`name` 属性は、構成ファイルの値として後で使用します。`SqlMembershipProvider` に設定する方法の例を次に示します。  
+  
+     次の例は構成セクションを示します。  
+  
+    ```xml  
+    <!-- Configure the Sql Membership Provider -->  
+    <membership defaultProvider="SqlMembershipProvider" userIsOnlineTimeWindow="15">  
+      <providers>  
+        <clear />  
+          <add   
+            name="SqlMembershipProvider"   
+            type="System.Web.Security.SqlMembershipProvider"   
+            connectionStringName="SqlConn"  
+            applicationName="MembershipAndRoleProviderSample"  
+            enablePasswordRetrieval="false"  
+            enablePasswordReset="false"  
+            requiresQuestionAndAnswer="false"  
+            requiresUniqueEmail="true"  
+            passwordFormat="Hashed" />  
+      </providers>  
+    </membership>  
+    ```  
+  
+### ユーザー名\/パスワードの組み合わせを受け入れるようにサービス セキュリティを構成するには  
+  
+1.  構成ファイルの [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)[\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素を追加します。  
+  
+2.  [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)をバインディング セクションに追加します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインド要素の作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 構成でサービス バインディングを指定する](../../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。  
+  
+3.  `<security>` 要素の `modeMessage 属性を`  に設定します。  
+  
+4.  \<`message`\> 要素の `clientCredentialType` 属性を `UserName` に設定します。これにより、ユーザー名\/パスワードの組み合わせがクライアントの資格情報として使用されるようになります。  
+  
+     次のコード例は、バインディングの構成コードを示しています。  
+  
+    ```xml  
+    <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+      <!-- Set up a binding that uses UserName as the client credential type -->  
+        <binding name="MembershipBinding">  
+          <security mode ="Message">  
+            <message clientCredentialType ="UserName"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    </system.serviceModel>  
+    ```  
+  
+### メンバーシップ プロバイダーを使用するようにサービスを構成するには  
+  
+1.  `<system.serviceModel>` [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素を追加します。  
+  
+2.  [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) を \<`behaviors`\> 要素に追加します。  
+  
+3.  [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md) を追加し、`name` 属性を適切な値に設定します。  
+  
+4.  [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)\<`behaviorを` \> 要素に追加します。  
+  
+5.  [\<userNameAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/usernameauthentication.md)を `<serviceCredentials>` 要素に追加します。  
+  
+6.  `userNamePasswordValidationMode` 属性を `MembershipProvider` に設定します。  
+  
+    > [!IMPORTANT]
+    >  `userNamePasswordValidationMode` 値が設定されていない場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップ プロバイダーの代わりに Windows 認証を使用します。  
+  
+7.  `membershipProviderName` 属性をプロバイダーの名前 \(このトピックの最初の手順でプロバイダーを追加したときに指定したもの\) に設定します。次の例に、この時点での `<serviceCredentials>` のフラグメントを示します。  
+  
+    ```xml  
+    <behaviors>  
+       <serviceBehaviors>  
+          <behavior name="MyServiceBehavior">  
+             <serviceCredentials>  
+                <userNameAuthentication   
+                userNamePasswordValidationMode="MembershipProvider"  
+                membershipProviderName="SqlMembershipProvider" />  
+             </serviceCredentials>  
+          </behavior>  
+       </serviceBehaviors>  
+    </behaviors>  
+  
+    ```  
+  
+## 使用例  
+ 次のコードは、ASP メンバーシップ機能を使用するサービスの構成を示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="MyServiceBehavior" name="Microsoft.Samples.GettingStarted.CalculatorService">  
+        <endpoint address="http://microsoft.com/WCFservices/Calculator"  
+          binding="wsHttpBinding" bindingConfiguration="MembershipBinding"  
+          name="ASPmemberUserName" contract="Microsoft.Samples.GettingStarted.ICalculator" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="MyServiceBehavior">  
+          <serviceCredentials>  
+            <userNameAuthentication   
+              userNamePasswordValidationMode="MembershipProvider"  
+              membershipProviderName="SqlMembershipProvider" />  
+          </serviceCredentials>  
+        </behavior>  
+          </serviceBehaviors>  
+    </behaviors>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="MembershipBinding">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ [方法 : ASP.NET のロール プロバイダーとサービスを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md)   
+ [メンバーシップとロール プロバイダー](../../../../docs/framework/wcf/samples/membership-and-role-provider.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md
new file mode 100644
index 00000000000..a8a2d8e3fc9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-the-aspnet-role-provider-with-a-service.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : ASP.NET のロール プロバイダーとサービスを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88d33a81-8ac7-48de-978c-5c5b1257951e
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : ASP.NET のロール プロバイダーとサービスを使用する
+[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーを [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップ プロバイダーと共に使用すると、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 開発者は、サイトで使用するアカウントをユーザーが作成し、承認のためにユーザーにロールを割り当てることができる Web サイトを作成できます。この機能を使用すれば、ユーザーはだれでもサイトでアカウントを作成し、そのサイトにログインしてサービスに排他的にアクセスできます。これは、ユーザーが Windows ドメイン内にアカウントを持っていることが必要な Windows セキュリティとは対照的です。自分の資格情報 \(ユーザー名とパスワードの組み合わせ\) を提示したユーザーは、だれでもサイトとそのサービスを使用できます。  
+  
+ サンプル アプリケーションについては、「[メンバーシップとロール プロバイダー](../../../../docs/framework/wcf/samples/membership-and-role-provider.md)」を参照してください。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] のメンバーシップ プロバイダー機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : ASP.NET メンバーシップ プロバイダーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md)」を参照してください。  
+  
+ ロール プロバイダー機能では、SQL Server データベースを使用してユーザー情報を格納します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 開発者は、セキュリティを向上させるためにこれらの機能を利用できます。この機能を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに統合した場合、ユーザーはユーザー名とパスワードの組み合わせを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションに提示する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でデータベースを使用できるようにするには、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> クラスのインスタンスを作成し、その <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.PrincipalPermissionMode%2A> プロパティを <xref:System.ServiceModel.Description.PrincipalPermissionMode> に設定してから、サービスをホストしている <xref:System.ServiceModel.ServiceHost> に対する動作のコレクションにそのインスタンスを追加します。  
+  
+### ロール プロバイダーを構成するには  
+  
+1.  Web.config ファイルで、\<`system.web`\> 要素の下に \<`roleManager`\> 要素を追加し、その `enabled` 属性を `true` に設定します。  
+  
+2.  `defaultProvider` 属性を `SqlRoleProvider` に追加します。  
+  
+3.  \<`roleManager`\> 要素の子として \<`providers`\> 要素を追加します。  
+  
+4.  次の例に示すように、\<`providers`\> 要素の子として \<`add`\> 要素を追加し、`name`、`type`、`connectionStringName`、および `applicationName` の各属性を適切な値に設定します。  
+  
+    ```  
+    <!-- Configure the Sql Role Provider. -->  
+    <roleManager enabled ="true"   
+     defaultProvider ="SqlRoleProvider" >  
+       <providers>  
+         <add name ="SqlRoleProvider"   
+           type="System.Web.Security.SqlRoleProvider"   
+           connectionStringName="SqlConn"   
+           applicationName="MembershipAndRoleProviderSample"/>  
+       </providers>  
+    </roleManager>  
+    ```  
+  
+### ロール プロバイダーを使用するようにサービスを構成するには  
+  
+1.  Web.config ファイルで [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素を追加します。  
+  
+2.  [\<behaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素を \<`system.ServiceModel`\> 要素に追加します。  
+  
+3.  \<`behaviors`\> 要素に [\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md)を追加します。  
+  
+4.  [\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)を追加し、`name` 属性を適切な値に設定します。  
+  
+5.  [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)を \<`behavior`\> 要素に追加します。  
+  
+6.  `principalPermissionMode` 属性を `UseAspNetRoles` に追加します。  
+  
+7.  `roleProviderName` 属性を `SqlRoleProvider` に追加します。この構成の一部を次の例に示します。  
+  
+    ```  
+    <behaviors>  
+     <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior">  
+       <serviceAuthorization principalPermissionMode ="UseAspNetRoles"  
+                             roleProviderName ="SqlRoleProvider" />  
+      </behavior>  
+     </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+## 参照  
+ [メンバーシップとロール プロバイダー](../../../../docs/framework/wcf/samples/membership-and-role-provider.md)   
+ [方法 : ASP.NET メンバーシップ プロバイダーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-aspnet-membership-provider.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md b/docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md
new file mode 100644
index 00000000000..34eff34bf5b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : ChannelFactory を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: d48f01b5-582b-4c8b-b547-8adddae7e371
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : ChannelFactory を使用する
+<xref:System.ServiceModel.ChannelFactory%601> ジェネリック クラスは、複数チャネルの作成に使用できるチャネル ファクトリの作成を必要とする高度なシナリオで使用します。  
+  
+### ChannelFactory クラスの作成方法と使用方法  
+  
+1.  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをビルドして実行します。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md)、[サービスの構成](../../../../docs/framework/wcf/configuring-services.md)、および [ホスティング サービス](../../../../docs/framework/wcf/hosting-services.md)。  
+  
+2.  クライアントのコントラクト \(インターフェイス\) を生成するには、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用します。  
+  
+3.  クライアント コード内で、<xref:System.ServiceModel.ChannelFactory%601> クラスを使用して複数のエンドポイント リスナーを作成します。  
+  
+## 使用例  
+ [!code-csharp[c_HowToUseChannelFactory#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_howtousechannelfactory/cs/source.cs#1)]
+ [!code-vb[c_HowToUseChannelFactory#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howtousechannelfactory/vb/source.vb#1)]
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md b/docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md
new file mode 100644
index 00000000000..a1907b86360
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md
@@ -0,0 +1,121 @@
+---
+title: "方法 : COM+ サービス モデル構成ツールを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "COM+ [WCF], サービス モデル構成ツールの使用"
+ms.assetid: 7e68cd8d-5fda-4641-b92f-290db874376e
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 方法 : COM+ サービス モデル構成ツールを使用する
+適切なホスト モードを選択したら、COM\+ サービス モデル構成コマンド ライン ツール \(ComSvcConfig.exe\) を使用して、Web サービスとして公開されるアプリケーション インターフェイスを構成します。  
+  
+> [!NOTE]
+>  以下の各作業を実行するには、コンピューターの管理者である必要があります。  
+  
+ Windows 7 コンピューターで ComSvcConfig.exe を使用して、最新のサービス モデル バージョン \(現在 v4.5\) を使用するように Web サービスを構成する場合は、次の手順を実行します。  
+  
+1.  レジストリ キー `[HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR` に DWORD 値 0x00000001 を設定します。  
+  
+2.  comsvcconfig.exe を実行します。  
+  
+3.  手順 1. で追加したレジストリ キーを元の値に戻すか、存在しない場合は削除します。  
+  
+> [!IMPORTANT]
+>  このレジストリ キーを元に戻すことは重要です。これは互換性のキーです。この変更を元に戻さないと、コンピューターで実行している他の .NET アプリケーションで問題が発生する可能性があります。  
+  
+> [!WARNING]
+>  Windows 8 コンピューターで ComSvcConfig.exe \/install を使用すると、.NET Framework 3.5 がインストールされていない場合は、"お使いの PC にあるアプリには、Windows の次の機能が必要です: .NET Framework 3.5 \(.NET 2.0 と .NET 3.0 を含む\)" というメッセージを示すダイアログが表示されます。このダイアログは無視してもかまいません。また、OnlyUseLatestCLR レジストリ キーを DWORD 値 0x00000001 に設定することもできます。  
+  
+### COM\+ ホスト モードを使用して、Web サービスとして公開されるインターフェイスのセットにインターフェイスを追加するには  
+  
+-   次の例に示すように、`/install` オプションと `/hosting:complus` オプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose  
+    ```  
+  
+     このコマンドは、Web サービスとして公開されるインターフェイスのセットに \(OnlineStore COM\+ アプリケーションの\) `ItemOrders.IFinancial` コンポーネントの `IFinances` インターフェイスを追加します。サービスは COM\+ ホスト モードを使用するため、アプリケーションを明示的にアクティブ化する必要があります。  
+  
+     コンポーネントとインターフェイスにはアスタリスク \(\*\) をワイルドカード文字として使用できますが、選択した機能だけを Web サービスとして公開する場合は使用しないでください。ワイルドカードを使用すると、このコンポーネントの将来のバージョンを使用して実行したときに、構成構文の決定時には存在しなかったインターフェイスが誤って公開される可能性があります。  
+  
+     \/verbose オプションを指定すると、ツールは、エラーだけでなく警告も表示します。  
+  
+     公開されたサービスのコントラクトには、`IFinances` インターフェイスのすべてのメソッドが含まれます。  
+  
+### COM\+ ホスト モードを使用して、Web サービスとして公開されるインターフェイスのセットにインターフェイスの特定のメソッドだけを追加するには  
+  
+-   次の例に示すように、`/install` オプションと `/hosting:complus` オプション、および必要なメソッドの名前を明示的に指定して、ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose  
+    ```  
+  
+     このコマンドは、公開されたサービス コントラクトに `IFinances` インターフェイスの `Credit` メソッドと `Debit` メソッドだけを操作として追加します。インターフェイスのその他のメソッドはすべてコントラクトから除外されるため、Web サービス クライアントから呼び出すことができません。  
+  
+### Web ホスト モードを使用して、Web サービスとして公開されるインターフェイスのセットにインターフェイスを追加するには  
+  
+-   次の例に示すように、`/install` オプションと `/hosting:was` オプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose  
+    ```  
+  
+     このコマンドは、Web サービスとして公開されるインターフェイスのセットに \(OnlineWarehouse COM\+ アプリケーションの\) `ItemInventory.Warehouse` コンポーネントの `IStockLevels` インターフェイスを追加します。サービスは、COM\+ 内ではなく、IIS の OnlineWarehouse 仮想ディレクトリ内で Web ホストされるため、アプリケーションは、必要に応じて自動的にアクティブ化されます。  
+  
+     Web ホスト \(インプロセス\) 構成を使用するには、コンポーネント サービス管理コンソールを使用して、サーバー アプリケーションではなくライブラリ アプリケーションとして実行されるように COM\+ アプリケーションを構成する必要があります。サーバー アプリケーションとして構成されたアプリケーションは、標準の Web ホスト モードを使用するため、各要求の処理でプロセス ホップが発生します。  
+  
+     `/mex` オプションは、サービスからコントラクト定義を取得するクライアントをサポートするために、アプリケーションのサービス エンドポイントと同じトランスポートを使用する追加の Metadata Exchange \(MEX\) サービス エンドポイントを追加します。  
+  
+### 指定したインターフェイスの Web サービスを削除するには  
+  
+-   次の例に示すように、`/uninstall` のオプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus  
+    ```  
+  
+     このコマンドは、\(OnlineStore COM\+ アプリケーションから\) `ItemOrders.Financial` コンポーネントの `IFinances` インターフェイスを削除します。  
+  
+### 現在公開されているインターフェイスを一覧表示するには  
+  
+-   次の例に示すように、`/list` のオプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /list  
+    ```  
+  
+     このコマンドは、ローカル コンピューターに関して、現在公開されているインターフェイス、および対応するアドレスとバインディングの詳細を一覧表示します。  
+  
+### 現在公開されている特定のインターフェイスを一覧表示するには  
+  
+-   次の例に示すように、`/list` のオプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /list /application:OnlineStore /hosting:complus  
+    ```  
+  
+     このコマンドは、ローカル コンピューター上の OnlineStore COM\+ アプリケーションの現在公開されている COM\+ ホスト インターフェイスを、対応するアドレスやバインディングの詳細と共に一覧表示します。  
+  
+### ユーティリティで使用できるオプションに関するヘルプを表示するには  
+  
+-   次の例に示すように、\/? オプションを使用して ComSvcConfig を実行します。  
+  
+    ```  
+    ComSvcConfig.exe /?  
+  
+    ```  
+  
+## 参照  
+ [COM\+ アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md b/docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md
new file mode 100644
index 00000000000..30789f959f7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md
@@ -0,0 +1,171 @@
+---
+title: "方法 : トランスポート セキュリティとメッセージ資格情報を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TransportWithMessageCredentials"
+ms.assetid: 6cc35346-c37a-4859-b82b-946c0ba6e68f
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# 方法 : トランスポート セキュリティとメッセージ資格情報を使用する
+トランスポート資格情報とメッセージ資格情報の両方を使用してサービスをセキュリティで保護する場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、トランスポート セキュリティ モードとメッセージ セキュリティ モードの両方が最適に使用されます。つまり、トランスポート層セキュリティでは整合性と機密性が提供され、メッセージ層セキュリティでは、厳密なトランスポート セキュリティ機構では実現できないさまざまな資格情報が提供されます。ここでは、<xref:System.ServiceModel.WSHttpBinding> バインディングと <xref:System.ServiceModel.NetTcpBinding> バインディングを使用して、メッセージ資格情報付きトランスポートを実装するための基本手順を示します。セキュリティ モードの設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : セキュリティ モードを設定する](../../../../docs/framework/wcf/how-to-set-the-security-mode.md)」を参照してください。  
+  
+ セキュリティ モードを `TransportWithMessageCredential` に設定した場合、トランスポート レベルのセキュリティを提供する実際の機構は、トランスポートによって決まります。この機構は、HTTP の場合は SSL \(Secure Sockets Layer\) over HTTP \(HTTPS\)、TCP の場合は SSL over TCP または Windows です。  
+  
+ トランスポートが HTTP \(<xref:System.ServiceModel.WSHttpBinding> を使用\) の場合は、トランスポート レベルのセキュリティが SSL over HTTP によって提供されます。この場合、このトピックで後述するように、ポートにバインドされた SSL 証明書を使用してサービスをホストするコンピューターを構成する必要があります。  
+  
+ トランスポートが TCP \(<xref:System.ServiceModel.NetTcpBinding> を使用\) の場合、既定では、Windows セキュリティ または SSL over TCP によってトランスポート レベルのセキュリティが提供されます。SSL over TCP を使用する場合は、このトピックで後述するように、<xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A> メソッドを使用して証明書を指定する必要があります。  
+  
+### WSHttpBinding と証明書を使用してトランスポート セキュリティを提供するには \(コードを使用する場合\)  
+  
+1.  HttpCfg.exe ツールを使用して、コンピューターの任意のポートに SSL 証明書をバインドします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md).  
+  
+2.  <xref:System.ServiceModel.WSHttpBinding> クラスのインスタンスを作成し、<xref:System.ServiceModel.WSHttpSecurity.Mode%2A> プロパティを <xref:System.ServiceModel.SecurityMode> に設定します。  
+  
+3.  <xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType%2A> プロパティに適切な値を設定します \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][資格情報の種類の選択](../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md).\)次のコードでは、<xref:System.ServiceModel.MessageCredentialType> 値を使用しています。  
+  
+4.  適切なベース アドレスを持つ <xref:System.Uri> クラスのインスタンスを作成します。このアドレスでは、"HTTPS" スキームを使用し、コンピューターの実際の名前と SSL 証明書のバインド先のポート番号を含める必要があります \(または、構成で基本アドレスを設定できます。\)  
+  
+5.  <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを使用してサービス エンドポイントを追加します。  
+  
+6.  <xref:System.ServiceModel.ServiceHost> のインスタンスを作成し、<xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出します。コードは次のようになります。  
+  
+     [!code-csharp[c_SettingSecurityMode#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#7)]
+     [!code-vb[c_SettingSecurityMode#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#7)]  
+  
+### NetTcpBinding と証明書を使用してトランスポート セキュリティを提供するには \(コードを使用する場合\)  
+  
+1.  <xref:System.ServiceModel.NetTcpBinding> クラスのインスタンスを作成し、<xref:System.ServiceModel.NetTcpSecurity.Mode%2A> プロパティを <xref:System.ServiceModel.SecurityMode> に設定します。  
+  
+2.  <xref:System.ServiceModel.MessageSecurityOverTcp.ClientCredentialType%2A> を適切な値に設定します。次のコードでは、<xref:System.ServiceModel.MessageCredentialType> 値を使用しています。  
+  
+3.  適切なベース アドレスを持つ <xref:System.Uri> クラスのインスタンスを作成します。アドレスには "net.tcp" スキーマを使用する必要があることに注意してください。\(または、構成で基本アドレスを設定できます。\)  
+  
+4.  <xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成します。  
+  
+5.  <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A> メソッドを使用して、サービスに X.509 資格情報を明示的に設定します。  
+  
+6.  <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを使用してサービス エンドポイントを追加します。  
+  
+7.  次のコードに示すように、<xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[c_SettingSecurityMode#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#8)]
+     [!code-vb[c_SettingSecurityMode#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#8)]  
+  
+### NetTcpBinding と Windows を使用してトランスポート セキュリティを提供するには \(コードを使用する場合\)  
+  
+1.  <xref:System.ServiceModel.NetTcpBinding> クラスのインスタンスを作成し、<xref:System.ServiceModel.NetTcpSecurity.Mode%2A> プロパティを <xref:System.ServiceModel.SecurityMode> に設定します。  
+  
+2.  トランスポート セキュリティが Windows を使用するように、<xref:System.ServiceModel.TcpTransportSecurity.ClientCredentialType%2A> を <xref:System.ServiceModel.TcpClientCredentialType> に設定します \(これは、既定の設定です\)。  
+  
+3.  <xref:System.ServiceModel.MessageSecurityOverTcp.ClientCredentialType%2A> を適切な値に設定します。次のコードでは、<xref:System.ServiceModel.MessageCredentialType> 値を使用しています。  
+  
+4.  適切なベース アドレスを持つ <xref:System.Uri> クラスのインスタンスを作成します。アドレスには "net.tcp" スキーマを使用する必要があることに注意してください。\(または、構成で基本アドレスを設定できます。\)  
+  
+5.  <xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成します。  
+  
+6.  <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A> メソッドを使用して、サービスに X.509 資格情報を明示的に設定します。  
+  
+7.  <xref:System.ServiceModel.ServiceHost.AddServiceEndpoint%2A> メソッドを使用してサービス エンドポイントを追加します。  
+  
+8.  次のコードに示すように、<xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[c_SettingSecurityMode#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#9)]
+     [!code-vb[c_SettingSecurityMode#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#9)]  
+  
+## 構成の使用  
+  
+#### WSHttpBinding を使用するには  
+  
+1.  ポートにバインドされた SSL 証明書を使用してコンピューターを構成します \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)\).この構成では、\<`transport`\> 要素値を設定する必要はありません。  
+  
+2.  メッセージ レベルのセキュリティのクライアント資格情報の種類を指定します。次の例では、\<`message`\> 要素の `clientCredentialType` 属性を `UserName` に設定しています。  
+  
+    ```  
+    <wsHttpBinding>  
+    <binding name="WsHttpBinding_ICalculator">  
+            <security mode="TransportWithMessageCredential" >  
+               <message clientCredentialType="UserName" />  
+            </security>  
+    </binding>  
+    </wsHttpBinding>  
+    ```  
+  
+#### NetTcpBinding と証明書を使用してトランスポート セキュリティを提供するには  
+  
+1.  SSL over TCP の場合、`<behaviors>` 要素内で証明書を明示的に指定する必要があります。既定のストアの場所 \(ローカル コンピューターの個人ストア\) にある証明書を、発行者で指定する例を次に示します。  
+  
+    ```  
+    <behaviors>  
+     <serviceBehaviors>  
+       <behavior name="mySvcBehavior">  
+           <serviceCredentials>  
+             <serviceCertificate findValue="contoso.com"  
+                                 x509FindType="FindByIssuerName" />  
+           </serviceCredentials>  
+       </behavior>  
+     </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+2.  [\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)をバインディング セクションに追加します。  
+  
+3.  バインド要素を追加して、`name` 属性を適切な値に設定します。  
+  
+4.  \<`security`\> 要素を追加し、`mode` 属性に `TransportWithMessageCredential` を設定します。  
+  
+5.  \<`message>` 要素を追加し、`clientCredentialType` 属性を適切な値に設定します。  
+  
+    ```  
+    <bindings>  
+    <netTcpBinding>  
+      <binding name="myTcpBinding">  
+        <security mode="TransportWithMessageCredential" >  
+           <message clientCredentialType="Windows" />  
+        </security>  
+      </binding>  
+    </netTcpBinding>  
+    </bindings>  
+    ```  
+  
+#### NetTcpBinding と Windows を使用してトランスポート セキュリティを提供するには  
+  
+1.  [\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)をバインディング セクションに追加します。  
+  
+2.  \<`binding`\> 要素を追加し、`name` 属性を適切な値に設定します。  
+  
+3.  \<`security`\> 要素を追加し、`mode` 属性に `TransportWithMessageCredential` を設定します。  
+  
+4.  \<`transport`\> 要素を追加し、`clientCredentialType` 属性に `Windows` を設定します。  
+  
+5.  \<`message`\> 要素を追加し、`clientCredentialType` 属性を適切な値に設定します。次のコードは、値を証明書に設定します。  
+  
+    ```  
+    <bindings>  
+    <netTcpBinding>  
+      <binding name="myTcpBinding">  
+        <security mode="TransportWithMessageCredential" >  
+           <transport clientCredentialType="Windows" />  
+           <message clientCredentialType="Certificate" />  
+        </security>  
+      </binding>  
+    </netTcpBinding>  
+    </bindings>  
+  
+    ```  
+  
+## 参照  
+ [方法 : セキュリティ モードを設定する](../../../../docs/framework/wcf/how-to-set-the-security-mode.md)   
+ [サービスのセキュリティ保護](../../../../docs/framework/wcf/securing-services.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md b/docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md
new file mode 100644
index 00000000000..9d76e1e8b65
--- /dev/null
+++ b/docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : MMC スナップインを使用して証明書を参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], MMC スナップインを使用した参照"
+ms.assetid: 2b8782aa-ebb4-4ee7-974b-90299e356dc5
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 方法 : MMC スナップインを使用して証明書を参照する
+X.509 証明書は、広く使用されている資格情報です。セキュリティで保護されたサービスやクライアントを作成する場合、<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> メソッドなどのメソッドを使用して、クライアントやサービスの資格情報として使用する証明書を指定できます。このメソッドでは、証明書を格納するストアや証明書を検索するときに使用する値など、さまざまなパラメーターが必要になります。次の手順では、コンピューター上のストアを調べて適切な証明書を検索する方法を示します。証明書の拇印の検索の例については、「[方法 : 証明書のサムプリントを取得する](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)」を参照してください。  
+  
+### MMC スナップインで証明書を参照するには  
+  
+1.  コマンド プロンプト ウィンドウを開きます。  
+  
+2.  「`mmc`」と入力し、Enter キーを押します。ローカル コンピューターのストアにある証明書を表示するには、管理者のロールが必要です。  
+  
+3.  **\[ファイル\]** メニューの **\[スナップインの追加と削除\]** をクリックします。  
+  
+4.  **\[追加\]** をクリックします。  
+  
+5.  **\[スタンドアロン スナップインの追加\]** ダイアログ ボックスで、**\[証明書\]** を選択します。  
+  
+6.  **\[追加\]** をクリックします。  
+  
+7.  **\[証明書スナップイン\]** ダイアログ ボックスで、**\[コンピューター アカウント\]** を選択し、**\[次へ\]** をクリックします。必要に応じて、**\[ユーザー アカウント\]** や **\[サービス アカウント\]** も選択できます。そのコンピューターの管理者でない場合は、自分のユーザー アカウントの証明書のみを管理できます。  
+  
+8.  **\[コンピューターの選択\]** ダイアログ ボックスで、**\[完了\]** をクリックします。  
+  
+9. **\[スタンドアロン スナップインの追加\]** ダイアログ ボックスで、**\[閉じる\]** をクリックします。  
+  
+10. **\[スナップインの追加と削除\]** ダイアログ ボックスで、**\[OK\]** をクリックします。  
+  
+11. **\[コンソール ルート\]** ウィンドウで、**\[証明書 \(ローカル コンピューター\)\]** をクリックしてコンピューターの証明書ストアを表示します。  
+  
+12. 省略可能。自分のアカウントの証明書を表示するには、手順 3. ～ 6. を繰り返し、手順 7. で **\[コンピューター アカウント\]** を選択する代わりに **\[ユーザー アカウント\]** をクリックして、手順 8. ～ 10. を繰り返します。  
+  
+13. 省略可能。**\[ファイル\]** メニューの **\[保存\]** または **\[名前を付けて保存\]** をクリックします。再利用できるようにコンソール ファイルを保存します。  
+  
+## Internet Explorer を使用した証明書の表示  
+ Internet Explorer を使用して、証明書を表示、エクスポート、インポート、または削除することもできます。  
+  
+#### Internet Explorer で証明書を表示するには  
+  
+1.  Internet Explorer で **\[ツール\]** をクリックし、**\[インターネット オプション\]** をクリックして **\[インターネット オプション\]** ダイアログ ボックスを表示します。  
+  
+2.  **\[コンテンツ\]** タブをクリックします。  
+  
+3.  **\[証明書\]** で、**\[証明書\]** をクリックします。  
+  
+4.  証明書の詳細を表示するには、その証明書を選択し、**\[表示\]** をクリックします。  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)   
+ [方法 : 証明書のサムプリントを取得する](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md b/docs/framework/wcf/feature-details/http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md
new file mode 100644
index 00000000000..10df59b93bb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/http-post-and-http-get-requests-for-aspnet-ajax-endpoints.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : ASP.NET AJAX エンドポイントのために HTTP POST または HTTP GET を選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b47de82a-4c92-4af6-bceb-a5cb8bb8ede9
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 方法 : ASP.NET AJAX エンドポイントのために HTTP POST または HTTP GET を選択する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、クライアント Web サイトの JavaScript から呼び出される ASP.NET AJAX 対応のエンドポイントを公開するサービスを作成できます。  このようなサービスを構築するための基本的な手順については、「[方法 : 構成を使用して ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-use-configuration-to-add-an-aspnet-ajax-endpoint.md)」および「[方法 : 構成を使用せずに ASP.NET AJAX エンドポイントを追加する](../../../../docs/framework/wcf/feature-details/how-to-add-an-aspnet-ajax-endpoint-without-using-configuration.md)」を参照してください。  
+  
+ ASP.NET AJAX では、HTTP POST 動詞および HTTP GET 動詞を使用する操作をサポートしており、HTTP POST が既定となっています。  副作用がなく、返されるデータがほとんど、またはまったく変更されない操作を作成する場合は、代わりに HTTP GET を使用します。  GET 操作の結果はキャッシュされます。つまり、同じ操作についての複数の呼び出し結果がサービスに対する 1 回だけの要求で済むことになります。  このキャッシュ動作は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってではなく、任意のレベル \(ユーザーのブラウザーやプロキシ サーバー、その他のレベル\) で実行できます。キャッシュはサービス パフォーマンスの向上が望まれる場合には有効ですが、データの変更が頻繁であったり、操作によって何かのアクションが実行される場合は適していません。  
+  
+ たとえば、ユーザーの音楽ライブラリを管理するサービスをデザインする場合、アルバムのタイトルに基づいてアーティストを検索する操作では GET の使用は役に立ちますが、ユーザーの個人コレクションにアルバムを追加する操作では POST を使用する必要があります。  
+  
+ キャッシュの有効期間を制御するには、<xref:System.ServiceModel.Web.OutgoingWebResponseContext> 型を使用します。  たとえば、1 時間ごとに更新される天気予報を返すサービスをデザインする場合、GET を使用することが考えられますが、サービスを使用するユーザーが古いデータにアクセスすることを防止するために、キャッシュの有効期間を 1 時間以内に制限します。  
+  
+ Script Manager コントロールを使用する ASP.NET AJAX ページからサービスを使用する場合は、Script Manager のメカニズムにより適切な要求の種類が発行されることが保証されているため、操作で GET と POST のどちらを使用しても違いはありません。  
+  
+ HTTP GET 操作では、複合型データ コントラクト型も含めて、POST 操作でサポートされるすべての入力パラメーターを使用できます。  ただし、多くの場合、キャッシュの効率が低下するため、多数のパラメーター、または複雑すぎるパラメーターを GET 操作で使用しないことをお勧めします。  
+  
+ このトピックでは、<xref:System.ServiceModel.Web.WebGetAttribute> または <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性を追加することで、サービス コントラクトに適切な操作を GET と POST から選択する方法について説明します。  サービスの実行に必要な他の手順 \(サービスの実装、構成、およびホスト\) は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ASP.NET AJAX サービスで使用される手順と同様になります。  
+  
+ <xref:System.ServiceModel.Web.WebGetAttribute> でマークされた操作では、常に GET 要求が使用されます。  <xref:System.ServiceModel.Web.WebInvokeAttribute> でマークされた操作と、これらの 2 つの属性のどちらでもマークされていない操作では、POST 要求が使用されます。  <xref:System.ServiceModel.Web.WebInvokeAttribute> は、<xref:System.ServiceModel.Web.WebInvokeAttribute.Method%2A> プロパティを介して、GET と POST 以外の HTTP 動詞 \(PUT や DELETE など\) の使用を許可します。  ただし、これらの動詞は ASP.NET AJAX ではサポートされていません。  Script Manager コントロールを使用して ASP.NET ページからサービスを使用する場合は、<xref:System.ServiceModel.Web.WebInvokeAttribute.Method%2A> プロパティは使用しないでください。  
+  
+ GET に切り替える実施例については、「[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)」のサンプルを参照してください。  
+  
+ POST の使用例については、「[HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)」のサンプルを参照してください。  
+  
+### HTTP GET または HTTP POST 要求に応答する WCF サービスを作成するには  
+  
+1.  <xref:System.ServiceModel.ServiceContractAttribute> 属性でマークされたインターフェイスを使用して、基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス コントラクトを定義します。  各操作を <xref:System.ServiceModel.OperationContractAttribute> でマークします。  <xref:System.ServiceModel.Web.WebGetAttribute> 属性を追加して、操作が HTTP GET 要求に応答するように指定します。  HTTP POST を明示的に指定するために <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性を追加することもできます。また、属性を指定しなければ、既定で HTTP POST となります。  
+  
+    ```  
+    [ServiceContract]  
+    public interface IMusicService  
+    {  
+        //This operation uses a GET method.  
+        [OperationContract]  
+        [WebGet]  
+        string LookUpArtist(string album);  
+  
+        //This operation will use a POST method.  
+        [OperationContract]  
+        [WebInvoke]  
+        void AddAlbum(string user, string album);  
+  
+        //This operation will use POST method by default  
+        //since nothing else is explicitly specified.  
+        [OperationContract]  
+        string[] GetAlbums(string user);  
+  
+        //Other operations omitted…  
+  
+    }  
+    ```  
+  
+2.  `MusicService` を使用して、`IMusicService` サービス コントラクトを実装します。  
+  
+    ```  
+    public class MusicService : IMusicService  
+    {  
+        public void AddAlbum(string user, string album)  
+        {  
+            //Add implementation here.  
+        }  
+  
+         //Other operations omitted…  
+    }  
+    ```  
+  
+3.  アプリケーションで、.svc という拡張子を付けて新しい service ファイルを作成します。  サービスに該当する [@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブ情報を追加して、このファイルを編集します。  ASP.NET AJAX エンドポイントが自動的に構成されるように、[@ServiceHost](../../../../docs/framework/configure-apps/file-schema/wcf-directive/servicehost.md) ディレクティブで <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> を使用することを指定します。  
+  
+    ```  
+    <%@ServiceHost   
+        language=c#   
+        Debug="true"   
+        Service="Microsoft.Ajax.Samples.MusicService"  
+        Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory  
+    %>  
+    ```  
+  
+### サービスを呼び出すには  
+  
+1.  ブラウザーを使用すると、クライアントのコードなしでサービスの GET 操作をテストできます。  たとえば、サービスがアドレス "http:\/\/example.com\/service.svc" で構成されている場合、ブラウザーのアドレス バーに「http:\/\/example.com\/service.svc\/LookUpArtist?album\=SomeAlbum」と入力するとサービスが呼び出され、応答がダウンロードまたは表示されます。  
+  
+2.  GET 操作によるサービスは、他の ASP.NET AJAX サービスと同様に、サービス URL を ASP.NET AJAX Script Manager コントロールのスクリプト コレクションに入力することで使用できます。  例については、「[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)」を参照してください。  
+  
+## 参照  
+ [ASP.NET AJAX 用の WCF サービスの作成](../../../../docs/framework/wcf/feature-details/creating-wcf-services-for-aspnet-ajax.md)   
+ [方法 : AJAX 対応 ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/how-to-migrate-ajax-enabled-aspnet-web-services-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/http-transport-security.md b/docs/framework/wcf/feature-details/http-transport-security.md
new file mode 100644
index 00000000000..2b2ad7a1ce4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/http-transport-security.md
@@ -0,0 +1,64 @@
+---
+title: "HTTP トランスポート セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d3439262-c58e-4d30-9f2b-a160170582bb
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# HTTP トランスポート セキュリティ
+トランスポートとして HTTP を使用すると、SSL \(Secure Sockets Layer\) によりセキュリティが提供されます。  SSL はクライアントに対してサービスの認証を行い、機密性 \(暗号化\) をチャネルに提供する技術としてインターネットで広く使用されています。  このトピックでは、SSL の機能と SSL を [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に実装する方法について説明します。  
+  
+## 基本 SSL  
+ SSL の機能について一般的なシナリオを用いて説明します。ここでは、銀行の Web サイトを考えます。  ユーザーはユーザー名とパスワードを使用してサイトにログオンできます。  認証された後、ユーザーは、残高照会、支払い、口座間振り替えなどの各種取引を実行できます。  
+  
+ ユーザーがサイトに最初にアクセスする時に、SSL メカニズムは、ユーザーのクライアント \(この場合は Internet Explorer\) との*ハンドシェイク*と呼ばれる一連のネゴシエーションを開始します。  SSL は最初にユーザーに対して銀行サイトの認証を行います。  ユーザーを誘導してユーザー名とパスワードを入力させる "なりすまし" サイトではなく、通信先が実際のサイトであることをユーザーが最初に認識する必要があるため、この手順は不可欠です。  SSL は、VeriSign などの信頼された機関から提供される SSL 証明書を使用してこの認証を行います。  論理上は、VeriSign が銀行サイトの識別情報を保証することになります。  Internet Explorer では VeriSign が信頼済みであるため、このサイトも信頼されます。  VeriSign に確認する場合は、VeriSign のロゴをクリックします。  有効期限や発行先 \(銀行サイト\) などの信頼性に関する報告が表示されます。  
+  
+ セキュリティで保護されたセッションを開始するには、クライアントは「もしもし」と同等の情報を暗号アルゴリズムのリストと共にサーバーに送信します。サーバーはこの暗号アルゴリズムのリストを使用して署名、ハッシュの生成、暗号化と複号化を行えます。  これに対して、サイトからは受信確認、およびサイトが選択したアルゴリズム スイートの 1 つが返送されます。  この初期ハンドシェイク中に、両方のパーティは nonce を送受信します。  *nonce* は、ランダムに生成される使用データの一部で、サイトの公開キーと組み合わせてハッシュの作成に使用します。  *ハッシュ*とは、SHA1 などの標準アルゴリズムに基づいて 2 つの数値から派生した新しい数値です   \(クライアントとサイトは、使用するハッシュ アルゴリズムに同意するためのメッセージも交換します\)。ハッシュは一意の数値で、クライアントとサイト間のセッションでメッセージの暗号化および復号化を行うためにのみ使用されます。  クライアントとサービスの両方に、元の nonce と証明書の公開キーがあるので、両者で同じハッシュを生成できます。  したがって、クライアントがサービスから送信されたハッシュを検証するには、\(a\) 同意したアルゴリズムを使用してデータからハッシュを計算し、\(b\) サービスから送信されたハッシュと比較します。両方が一致する場合は、クライアントはハッシュが改ざんされていないことを確認できます。  次にクライアントはこのハッシュを、さらに別の新しいハッシュが含まれるメッセージを暗号化するキーとして使用します。  サービスはハッシュを使用してこのメッセージを複号化でき、最後から 2 番目のハッシュを復帰できます。  ここで、累積された情報 \(nonce、公開キーなどのデータ\) が両者で認識されるので、最後のハッシュ \(マスター キー\) を作成できます。  最後のキーは、最後から 2 番目のハッシュで暗号化され送信されます。  次に、マスター キーを使ってメッセージの暗号化と複号化が行われセッションがリセットされます。  クライアントとサービスの両方で同じキーを使用するため、このキーは*セッション キー*とも呼ばれます。  
+  
+ セッション キーは、対称キーまたは "共有シークレット" としての特性も持っています。対称キーを使用すると、トランザクションの両側で必要となる計算が削減されるため、このキーを持つことは重要です。  すべてのメッセージが新しい nonce とハッシュの交換を要求した場合、パフォーマンスは低下します。  したがって、対称キーを使用して高い安全性と効率を確保しながらメッセージを両側に自由にフローさせることが、SSL の最終的な目標になります。  
+  
+ プロトコルはサイトによってさまざまなので、以上の説明では動作を簡略化しています。  また、データ交換処理をさらに複雑にするため \(保護を強化するため\) に、ハンドシェイク中にクライアントとサイトの両方でアルゴリズムを組み合わせた nonce を別々に生成することもできます。  
+  
+### 証明書および公開キー基盤  
+ ハンドシェイク中に、サービスは SSL 証明書もクライアントに送信します。  証明書には、有効期限、発行元証明機関、サイトの URI \(Uniform Resource Identifier\) などの情報が含まれます。  クライアントは、この URI と最初にアクセスした URI を比較して一致するかどうかを確認し、また、日付と発行元証明機関をチェックします。  
+  
+ すべての証明書には、秘密キーと公開キーの 2 つのキーが含まれます。この 2 つのキーは、*交換キー ペア*と呼ばれます。  簡単に説明すると、秘密キーは証明書の所有者のみが認識し、公開キーは証明書から読み取ることができます。  どちらのキーもダイジェスト、ハッシュ、その他のキーの暗号化と複号化に使用できますが、逆の操作としての使用に限られます。  たとえば、クライアントで公開キーを使用して暗号化した場合、サイトのみが秘密キーを使用してメッセージを複号化できます。  同様に、サイトで秘密キーを使用して暗号化した場合、クライアントは公開キーを使用して複号化できます。  秘密キーを使用して暗号化されたメッセージのみが公開キーを使用して復号化できるため、クライアントには、秘密キーの所有者のみとメッセージ交換することが保証されます。  サイトには、公開キーを使用して暗号化を行っているクライアントとメッセージを交換していることが保証されます。  この交換は初期ハンドシェイクの場合のみセキュリティで保護されます。このため、実際の対称キーを作成する多くの試みが行われています。  いずれにしても、すべての通信は有効な SSL 証明書を保有するサービスに依存します。  
+  
+## WCF を使用する SSL の実装  
+ HTTP トランスポート セキュリティ \(つまり SSL\) は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の外部に提供されます。  SSL は、次のいずれかの方法で実装できますが、その方法は、アプリケーションがどのようにホストされるかによって決まります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のホストとしてインターネット インフォメーション サービス \(IIS\) を使用する場合、IIS インフラストラクチャを使用して SSL サービスを設定します。  
+  
+-   自己ホスト型の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを作成する場合は、HttpCfg.exe ツールを使用して SSL 証明書をアドレスにバインドできます。  
+  
+### トランスポート セキュリティのための IIS の使用  
+  
+#### IIS 7.0  
+ セキュリティで保護されたホスト \(SSL を使用\) として [!INCLUDE[iisver](../../../../includes/iisver-md.md)] を設定する場合は、「[IIS 7.0 Beta: IIS 7.0 で SSL \(Secure Sockets Layer\) を構成する](http://go.microsoft.com/fwlink/?LinkId=88600)」を参照してください。  
+  
+ [!INCLUDE[iisver](../../../../includes/iisver-md.md)] 用の証明書を構成する場合は、「[IIS 7.0 Beta: IIS 7.0 でサーバー証明書を構成する](http://go.microsoft.com/fwlink/?LinkID=88595)」を参照してください。  
+  
+#### IIS 6.0  
+ セキュリティで保護されたホスト \(SSL を使用\) として [!INCLUDE[iis601](../../../../includes/iis601-md.md)] を設定する場合は、「[SSL \(Secure Sockets Layer\) を構成する](http://go.microsoft.com/fwlink/?LinkId=88601)」を参照してください。  
+  
+ [!INCLUDE[iis601](../../../../includes/iis601-md.md)] 用の証明書を構成する場合は、「[Certificates\_IIS\_SP1\_Ops](http://go.microsoft.com/fwlink/?LinkId=88602)」を参照してください。  
+  
+### SSL での HttpCfg の使用  
+ 自己ホスト型の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを作成する場合は、「[Windows XP Service Pack 2 サポート ツール](http://go.microsoft.com/fwlink/?LinkId=29002)」のサイトから HttpCfg.exe ツールをダウンロードしてください。  
+  
+ HttpCfg.exe ツールで X.509 証明書を使用してポートを設定する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。  
+  
+## 参照  
+ [トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [メッセージのセキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md b/docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md
new file mode 100644
index 00000000000..c9e7d6f70e6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md
@@ -0,0 +1,41 @@
+---
+title: "探索プロキシの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dda20e79-8df3-438e-a281-69d779d978ec
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 探索プロキシの実装
+ここでは、探索プロキシの実装に必要な手順について説明します。  探索プロキシは、サービスのリポジトリを格納するスタンドアロンのサービスです。  クライアントは探索プロキシに対し、そのプロキシで認識される探索可能なサービスを問い合わせることができます。  プロキシにサービスを登録する方法は、実装手段によって異なります。  たとえば、探索プロキシが既存のサービス リポジトリに接続でき、その情報を探索可能にできる場合、管理者は管理 API を使用して探索可能なサービスをプロキシに追加することができます。または、探索プロキシにアナウンス機能を使用し、内部キャッシュを更新できます。  
+  
+ WCF 実装は、プロキシを簡単にビルドできる基本クラスを提供します。  これらの API を利用して、既存のリポジトリの上に探索プロキシをビルドできます。  
+  
+ ここで実装される探索プロキシは、探索可能にしてクライアントからエンドポイントを検索できるという点で、他の WCF サービスと似ています。  
+  
+## このセクションの内容  
+ [探索プロキシを実装する方法](../../../../docs/framework/wcf/feature-details/how-to-implement-a-discovery-proxy.md)  
+ 探索プロキシを実装する方法について説明します。  
+  
+ [探索プロキシで登録される探索可能なサービスの実装方法](../../../../docs/framework/wcf/feature-details/discoverable-service-that-registers-with-the-discovery-proxy.md)  
+ 探索プロキシに登録する、探索可能な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実装方法について説明します。  
+  
+ [探索プロキシを使用してサービスを検索するクライアント アプリケーションの実装方法](../../../../docs/framework/wcf/feature-details/client-app-discovery-proxy-to-find-a-service.md)  
+ 探索プロキシを使用してサービスを検索する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションの実装方法について説明します。  
+  
+ [探索プロキシをテストする方法](../../../../docs/framework/wcf/feature-details/how-to-test-the-discovery-proxy.md)  
+ 前の 3 つのトピックに記述されたコードのテスト方法について説明します。  
+  
+## 参照  
+ [WCF Discovery](../../../../docs/framework/wcf/feature-details/wcf-discovery.md)   
+ [プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法](../../../../docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md b/docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md
new file mode 100644
index 00000000000..1791c2f9fba
--- /dev/null
+++ b/docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md
@@ -0,0 +1,197 @@
+---
+title: "クラスを作成するためのスキーマのインポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, スキーマのインポートとエクスポート"
+  - "XsdDataContractImporter クラス"
+ms.assetid: b9170583-8c34-43bd-97bb-6c0c8dddeee0
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# クラスを作成するためのスキーマのインポート
+クラスで使用可能なスキーマを生成する[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]を使用して、 <xref:System.Runtime.Serialization.XsdDataContractImporter>クラスです。 ここでは、生成時に指定できる各種のオプションについて解説します。  
+  
+## <a name="the-import-process"></a>インポート処理  
+ スキーマのインポート処理が始まり、 <xref:System.Xml.Schema.XmlSchemaSet>を生成し、 <xref:System.CodeDom.CodeCompileUnit>します。  
+  
+ `XmlSchemaSet` は、一連の XML スキーマ定義言語 (XSD) スキーマ ドキュメントを表す [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のスキーマ オブジェクト モデル (SOM) の一部です。 作成する、`XmlSchemaSet`オブジェクトの一連の XSD ドキュメントから、各ドキュメントに逆シリアル化、 <xref:System.Xml.Schema.XmlSchema>オブジェクト (を使用して、 <xref:System.Xml.Serialization.XmlSerializer>)、新規作成 を追加して`XmlSchemaSet`します。  
+  
+ `CodeCompileUnit` は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] コードを抽象化して表す、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のコード ドキュメント オブジェクト モデル (CodeDOM) の一部です。 実際のコードを生成する、`CodeCompileUnit`のサブクラスを使用して、 <xref:System.CodeDom.Compiler.CodeDomProvider>クラスなど、 <xref:Microsoft.CSharp.CSharpCodeProvider>または<xref:Microsoft.VisualBasic.VBCodeProvider>クラスです。  
+  
+#### <a name="to-import-a-schema"></a>スキーマをインポートするには  
+  
+1.  インスタンスを作成、 <xref:System.Runtime.Serialization.XsdDataContractImporter>します。  
+  
+2.  省略可能です。 `CodeCompileUnit` をコンストラクターに渡します。 スキーマのインポート時に生成された型がこの `CodeCompileUnit` インスタンスに追加されるので、以降の処理は、`CodeCompileUnit` が空でない状態から始まります。  
+  
+3.  省略可能です。 1 つを呼び出して、 <xref:System.Runtime.Serialization.XsdDataContractImporter.CanImport%2A>メソッドです。 指定されたスキーマが有効なデータ コントラクト スキーマであって、インポートしても問題ないかどうかを判断するメソッドです。 `CanImport` メソッドには、次の手順に出てくる `Import` と同様に、オーバーロードがあります。  
+  
+4.  オーバー ロードされたいずれかを呼び出して`Import`メソッドなど、 <xref:System.Runtime.Serialization.XsdDataContractImporter.Import%28System.Xml.Schema.XmlSchemaSet%29>メソッドです。  
+  
+     これは、指定しなければならない引数が `XmlSchemaSet` だけという最も簡潔なオーバーロードであり、匿名型を含め、一連のスキーマに記述されている型をすべてインポートできます。 他のオーバー ロードでは、インポートするには、XSD 型または型の一覧を指定できます (の形式で、 <xref:System.Xml.XmlQualifiedName>または一連の`XmlQualifiedName`オブジェクト)。 この場合は、指定した型だけがインポートされます。 オーバー ロードは、 <xref:System.Xml.Schema.XmlSchemaElement>のうち特定の要素をインポートする、 `XmlSchemaSet`、(かどうかが匿名か)、関連する種類とします。 このメソッドの戻り値は `XmlQualifiedName` であり、この要素に対応して生成された型のデータ コントラクト名を表します。  
+  
+     `Import` メソッドを何度も呼び出すと、同じ `CodeCompileUnit` に複数の項目が追加されます。 `CodeCompileUnit` に既に存在する型は生成されません。 したがって、`Import` オブジェクトをいくつも使うのではなく、同じ `XsdDataContractImporter` の `XsdDataContractImporter` を必要な回数呼び出すようにしてください。 同じ型が重複して生成されることがないので、この方法をお勧めします。  
+  
+    > [!NOTE]
+    >  インポート中に障害が発生した場合の `CodeCompileUnit` の状態は不定です。 このような `CodeCompileUnit` を使うと、セキュリティ上の脆弱性につながるおそれがあります。  
+  
+5.  アクセス、`CodeCompileUnit`を通じて、 <xref:System.Runtime.Serialization.XsdDataContractImporter.CodeCompileUnit%2A>プロパティです。  
+  
+### <a name="import-options-customizing-the-generated-types"></a>インポート オプション : 生成された型のカスタマイズ  
+ 設定することができます、<xref:System.Runtime.Serialization.XsdDataContractImporter.Options%2A>のプロパティ、 <xref:System.Runtime.Serialization.XsdDataContractImporter>のインスタンスに、 <xref:System.Runtime.Serialization.ImportOptions>クラスをインポート処理のさまざまな側面を制御します。 生成される型に直接影響するオプションが多数あります。  
+  
+#### <a name="controlling-the-access-level-generateinternal-or-the-internal-switch"></a>アクセス レベルの制御 (GenerateInternal または /internal スイッチ)  
+ これに対応して、 **/内部**スイッチ、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)します。  
+  
+ 通常、スキーマから生成されるのはパブリック型です。ここにプライベート フィールドや対応するパブリック データ メンバー プロパティが定義されます。 代わりに、内部型を生成するには、設定、 <xref:System.Runtime.Serialization.ImportOptions.GenerateInternal%2A>プロパティを`true`します。  
+  
+ 次の例では、内部に変換するスキーマ クラスの場合、 <xref:System.Runtime.Serialization.ImportOptions.GenerateInternal%2A>にプロパティが設定されています。`true.`  
+  
+ [!code-csharp[c_SchemaImportExport#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#2)]
+ [!code-vb[c_SchemaImportExport#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#2)]  
+  
+#### <a name="controlling-namespaces-namespaces-or-the-namespace-switch"></a>名前空間の制御 (Namespaces または /namespace スイッチ)  
+ これに対応して、 **/namespace**スイッチ、`Svcutil.exe`ツールです。  
+  
+ 通常、スキーマから生成された型が生成される[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]名前空間の特定に対応する各 XSD 名前空間を持つ、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]で説明するマッピングに従って名前空間[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)します。 このマッピングをカスタマイズすることができます、<xref:System.Runtime.Serialization.ImportOptions.Namespaces%2A>プロパティを<xref:System.Collections.Generic.Dictionary%602>\</TKey, TValue>。 指定した XSD 名前空間がディクショナリに存在する場合、その XSD 名前空間に対応する [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 名前空間も、ディクショナリから取得されます。  
+  
+ たとえば、次のスキーマを考えます。  
+  
+ [!code[c_SchemaImportExport#10](../../../../samples/snippets/common/VS_Snippets_CFX/c_schemaimportexport/common/source.config#10)]  
+  
+ 
+          `Namespaces` プロパティを使って、"http://schemas.contoso.com/carSchema" という名前空間を "Contoso.Cars" に対応付ける例を示します。  
+  
+ [!code-csharp[c_SchemaImportExport#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#8)]
+ [!code-vb[c_SchemaImportExport#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#8)]  
+  
+#### <a name="adding-the-serializableattribute-generateserializable-or-the-serializable-switch"></a>SerializableAttribute の追加 (GenerateSerializable または /serializable スイッチ)  
+ これに対応して、 **/serializable**スイッチ、`Svcutil.exe`ツールです。  
+  
+ 使用できるようにするために、スキーマから生成された型に対して重要な場合があります[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]ランタイム シリアル化エンジン (たとえば、 <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter?displayProperty=fullName>と<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>クラス)。 たとえば、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] リモート処理に使うような場合がこれに当たります。 これを有効にする必要がありますを適用する、 <xref:System.SerializableAttribute>属性だけでなく、通常、生成された型を<xref:System.Runtime.Serialization.DataContractAttribute>属性です。 `GenerateSerializable` オプションを `true` に設定すると、この属性が自動的に生成されます。  
+  
+ 
+          `Vehicle` オプションを `GenerateSerializable` に設定して `true` クラスを生成する例を示します。  
+  
+ [!code-csharp[c_SchemaImportExport#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#4)]
+ [!code-vb[c_SchemaImportExport#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#4)]  
+  
+#### <a name="adding-data-binding-support-enabledatabinding-or-the-enabledatabinding-switch"></a>データ バインディング機能の追加 (EnableDataBinding または /enableDataBinding スイッチ)  
+ これに対応して、 **/enableDataBinding** Svcutil.exe ツールをオンにします。  
+  
+ スキーマから生成された型を GUI コンポーネントにバインドして、この型のインスタンスを更新したとき、自動的に UI にも反映されるようにする場合があります。 `XsdDataContractImporter`を実装する型を生成することができます、 <xref:System.ComponentModel.INotifyPropertyChanged>インターフェイス、プロパティが変更にイベントがトリガーされるようにします。 このインターフェイスをサポートするクライアント UI プログラミング環境で使用するための型を生成している場合 (など[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)])、設定、 <xref:System.Runtime.Serialization.ImportOptions.EnableDataBinding%2A>プロパティを`true`この機能を有効にします。  
+  
+ 例を次に、`Vehicle`で生成されたクラス、 <xref:System.Runtime.Serialization.ImportOptions.EnableDataBinding%2A>設定`true`します。  
+  
+ [!code-csharp[C_SchemaImportExport#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#5)]
+ [!code-vb[C_SchemaImportExport#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#5)]  
+  
+### <a name="import-options-choosing-collection-types"></a>インポート オプション: コレクション型の選択  
+ XML でアイテムのコレクションを表すパターンには、アイテムのリストと、アイテム間の関連付けの&2; 種類があります。 文字列のリストの例を次に示します。  
+  
+ [!code[C_SchemaImportExport#11](../../../../samples/snippets/common/VS_Snippets_CFX/c_schemaimportexport/common/source.config#11)]  
+  
+ 文字列と整数 (`city name` と `population`) を関連付ける例を次に示します。  
+  
+ [!code[C_SchemaImportExport#12](../../../../samples/snippets/common/VS_Snippets_CFX/c_schemaimportexport/common/source.config#12)]  
+  
+> [!NOTE]
+>  関連付けもリストと見なすことができます。 たとえば、上記の関連付けは、文字列と整数の&2; つのフィールドから成る複雑な `city` オブジェクトのリストと考えることも可能です。 どちらの方法であっても、XSD スキーマで表現できます。 この&2; つを区別する手段はないので、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に特有の特別な注釈がスキーマ内になければ、このようなパターンは常にリストとして扱われます。 注釈がある場合は、関連付けを表すものとして扱われます。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクト スキーマ リファレンス](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)します。  
+  
+ リストは通常、ジェネリック リストから派生したコレクション データ コントラクト、または [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の配列としてインポートされます。スキーマがコレクションの標準的な名前付けパターンに従っているかどうかによって切り分けます。 これについては説明について詳しく[データ コントラクトのコレクション型](../../../../docs/framework/wcf/feature-details/collection-types-in-data-contracts.md)します。 関連付けは通常、いずれかとしてインポート、<xref:System.Collections.Generic.Dictionary%602>または辞書オブジェクトから派生したコレクション データ コントラクト\</TKey, TValue>。 たとえば、次のスキーマを考えます。  
+  
+ [!code[c_SchemaImportExport#13](../../../../samples/snippets/common/VS_Snippets_CFX/c_schemaimportexport/common/source.config#13)]  
+  
+ これをインポートすると次のようになります (読みやすいようプロパティの代わりにフィールドを記載)。  
+  
+ [!code-csharp[c_SchemaImportExport#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#6)]
+ [!code-vb[c_SchemaImportExport#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#6)]  
+  
+ このようなスキーマ パターンに対し、生成されるコレクション型をカスタマイズすることも可能です。 などからコレクションを生成する場合、 <xref:System.ComponentModel.BindingList%601>の代わりに、<xref:System.Collections.Generic.List%601>コレクションの内容が変わるクラス型をリスト ボックスにバインドして、それをするために自動的に更新します。 これを行うには、設定、 <xref:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes%2A>のプロパティ、 <xref:System.Runtime.Serialization.ImportOptions> (以下参照先の型として知られている) で使用されるコレクション型の一覧にクラスをします。 コレクションのインポート時には、参照されるコレクション型のリストが順に調べられ、最も適したコレクションがあれば、それが使用されます。 アソシエーションはジェネリックか否かにかかわらずを実装する型とのみ一致<xref:System.Collections.IDictionary>インターフェイスのリストは、すべてのサポートされるコレクション型を照合されます。  
+  
+ たとえば場合、 <xref:System.Runtime.Serialization.ImportOptions.ReferencedCollectionTypes%2A>プロパティに設定されて、 <xref:System.ComponentModel.BindingList%601>、`people`前の例での種類は、次のように生成します。  
+  
+ [!code-csharp[C_SchemaImportExport#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#7)]
+ [!code-vb[C_SchemaImportExport#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#7)]  
+  
+ クローズ ジェネリック型 (型パラメーターすべてに具体的な型が指定されているジェネリック型) は、合致度が最も高いと見なされます。 たとえば場合、種類`BindingList(Of Integer)`と<xref:System.Collections.ArrayList>渡されるとして参照される型のコレクションにスキーマ内に整数のリストをインポート、`BindingList(Of Integer)`です。 一方、それ以外のリスト (`List(Of String)` など) は、`ArrayList` としてインポートされます。  
+  
+ ジェネリック `IDictionary` インターフェイスを実装する型を "参照される" 型のコレクションに追加した場合、型パラメーターは、完全にオープンであるか完全にクローズであるかのどちらかです。  
+  
+ 複製は使用できません。 たとえば `List(Of Integer)` と `Collection(Of Integer)` の両方を "参照される" 型に追加することはできません。 仮に追加したとしても、整数のリストがスキーマ中に表れたとき、どちらを使うか決められないからです。 もっとも、このような重複が検出されるのは、それが問題になるような型がスキーマ中にある場合だけです。 インポートするスキーマ中に、たとえば整数のリストがないのであれば、`List(Of Integer)` と `Collection(Of Integer)` の両方が "参照される" 型のコレクションにあっても問題はなく、単に何にも使われなかったというだけのことです。  
+  
+ 参照されるコレクション型のしくみは、プリミティブ型のコレクションばかりでなく、複合型のコレクション (他のコレクションから成るコレクションを含む) にも同様に働きます。  
+  
+ `ReferencedCollectionTypes`プロパティに対応して、 **/collectionType** SvcUtil.exe ツールをオンにします。 複数のコレクション型を参照することに注意してください、 **/collectionType**スイッチを複数回指定する必要があります。 型が MsCorLib.dll にない場合は、そのアセンブリも参照する必要を使用して、 **/reference**切り替えます。  
+  
+#### <a name="import-options-referencing-existing-types"></a>インポート オプション : 既存の型の参照  
+ スキーマ内の型が既存の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型に対応する場合は、その型を一から作成する必要はありません  (以下の説明は、非コレクション型にのみ当てはまります。 コレクション型については、前のセクションを参照してください)。  
+  
+ たとえば、企業全体で共通に、"Person" というデータ コントラクト型を使っており、人を表す場合には常にこれを使いたいとします。 いくつかのサービスでこの型を利用し、そのスキーマがサービス メタデータに表示される場合は、このスキーマをインポートするときに既存の `Person` 型を再利用でき、サービスごとに新たに生成する必要がありません。  
+  
+ これを行うには、一覧を渡す[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]コレクションに再利用する型、 <xref:System.Runtime.Serialization.ImportOptions.ReferencedTypes%2A>プロパティ上を返します、 <xref:System.Runtime.Serialization.ImportOptions>クラスです。 これらの型のいずれかが、スキーマ型の名前および名前空間と一致すれば、その構造が比較されます。 名前も構造も合致した場合は、型は新たに生成されず、既存の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型が再利用されます。 名前だけが一致して構造が一致しない場合は、例外が発生します。 型の参照時に、バージョンによる (オプションのデータ メンバーの追加などの) 差異は許容されません。 構造は厳密に合致しなければなりません。  
+  
+ "参照される" 型のコレクションに、データ コントラクト名と名前空間が同一である型を重複して追加しても、その名前と名前空間でスキーマ型をインポートしない限り問題ありません。 したがって、実際にはスキーマに現れることのない型については重複を気にすることなく、アセンブリ内の型をすべてコレクションに追加してしまうことができます。  
+  
+ `ReferencedTypes`プロパティに対応して、 **/reference** Svcutil.exe ツールの特定のモードに切り替えます。  
+  
+> [!NOTE]
+>  Svcutil.exe を使用する場合または (で[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)])、**サービス参照の追加**MsCorLib.dll に型のすべてのツールが自動的に参照します。  
+  
+#### <a name="import-options-importing-non-datacontract-schema-as-ixmlserializable-types"></a>インポート オプション : 非データ コントラクト スキーマを IXmlSerializable 型としてインポート  
+ <xref:System.Runtime.Serialization.XsdDataContractImporter>スキーマの限られたサブセットをサポートします。 未対応のスキーマ構造 (たとえば XML 属性) をインポートしようとすると例外が発生します。 ただし、設定、 <xref:System.Runtime.Serialization.ImportOptions.ImportXmlType%2A>プロパティを`true`がサポートするスキーマの範囲が広がります。 設定すると`true`、 <xref:System.Runtime.Serialization.XsdDataContractImporter>を実装する型を生成、 <xref:System.Xml.Serialization.IXmlSerializable>インターフェイスです。 そのため、これらの型の XML 表現に直接アクセスできるようになります。  
+  
+##### <a name="design-considerations"></a>設計上の考慮事項  
+  
+-   弱く型指定された XML 表現を直接扱うのは困難です。 など、別のシリアル化エンジンとしての使用を検討、 <xref:System.Xml.Serialization.XmlSerializer>厳密に型指定のデータと互換性のないスキーマ コントラクトと操作する。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][XmlSerializer クラスを使用して](../../../../docs/framework/wcf/feature-details/using-the-xmlserializer-class.md)します。  
+  
+-   スキーマ構造をインポートできない、 <xref:System.Runtime.Serialization.XsdDataContractImporter>場合でも、 <xref:System.Runtime.Serialization.ImportOptions.ImportXmlType%2A>にプロパティが設定されている`true`します。 ここでも、使用を検討して、 <xref:System.Xml.Serialization.XmlSerializer>このような場合です。  
+  
+-   詳細なスキーマ構造には、両方がサポートされているときに<xref:System.Runtime.Serialization.ImportOptions.ImportXmlType%2A>は`true`または`false`は「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)します。  
+  
+-   スキーマの生成<xref:System.Xml.Serialization.IXmlSerializable>型では、インポートし、エクスポートの忠実性は保持されないためです。 つまり、生成された型を基にスキーマをエクスポートし、再びこれをクラスとしてインポートした場合、元どおりのスキーマにはなりません。  
+  
+ 結合するには、 <xref:System.Runtime.Serialization.ImportOptions.ImportXmlType%2A>オプションを指定する、 <xref:System.ServiceModel.Description.ServiceContractGenerator.ReferencedTypes%2A>前に説明したオプション。 型として生成する必要がある<xref:System.Xml.Serialization.IXmlSerializable>実装では、構造的なチェックをスキップして、使用して、 <xref:System.ServiceModel.Description.ServiceContractGenerator.ReferencedTypes%2A>機能します。  
+  
+ <xref:System.Runtime.Serialization.ImportOptions.ImportXmlType%2A>オプションに対応して、 **/importXmlTypes** Svcutil.exe ツールをオンにします。  
+  
+##### <a name="working-with-generated-ixmlserializable-types"></a>生成された IXmlSerializable 型の使い方  
+ 生成された`IXmlSerializable`種類には、"nodesField"というプライベート フィールドが含まれているの配列を返す<xref:System.Xml.XmlNode>オブジェクトです。 このような型のインスタンスを逆シリアル化すると、XML ドキュメント オブジェクト モデルに基づき、このフィールドを介して XML データに直接アクセスできるようになります。 この型のインスタンスをシリアル化する際、"nodesField" フィールドに XML データを設定しておくと、これもシリアル化の対象になります。  
+  
+ 以上の処理は `IXmlSerializable` インターフェイスで実装されます。 生成された`IXmlSerializable`の種類、 <xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A>実装の呼び出し、 <xref:System.Runtime.Serialization.XmlSerializableServices.ReadNodes%2A>のメソッド、 <xref:System.Runtime.Serialization.XmlSerializableServices>クラスです。 メソッドがを通じて提供される XML に変換するヘルパー メソッド、 <xref:System.Xml.XmlReader>型の配列を<xref:System.Xml.XmlNode>オブジェクトです。 <xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A>実装では、その逆の配列に変換する`XmlNode`オブジェクトのシーケンスを<xref:System.Xml.XmlWriter>呼び出しです。 これは、 <xref:System.Runtime.Serialization.XmlSerializableServices.WriteNodes%2A>メソッドです。  
+  
+ スキーマのエクスポート処理は、生成された `IXmlSerializable` クラスに対して実行できます。 ただし、先に述べたように、元どおりのスキーマは再現されません。 任意の XSD 型を表す、"anyType" という標準型になります。  
+  
+ これを行うに適用することで、 <xref:System.Xml.Serialization.XmlSchemaProviderAttribute>属性を生成された`IXmlSerializable`クラスとメソッドを指定することを呼び出す、 <xref:System.Runtime.Serialization.XmlSerializableServices.AddDefaultSchema%2A> "anyType"型を生成するメソッドです。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Serialization.XmlSerializableServices>型がこの特定の機能をサポートするためにのみ存在します。 他の目的で使用することはお勧めできません。  
+  
+#### <a name="import-options-advanced-options"></a>インポート オプション : 高度なオプション  
+ 他にも、次のようなオプションがあります。  
+  
+-   <xref:System.Runtime.Serialization.ImportOptions.CodeProvider%2A>プロパティです。 指定の<xref:System.CodeDom.Compiler.CodeDomProvider>を使用して生成されたクラスのコードを生成します。 機能が回避インポート メカニズムされます、 <xref:System.CodeDom.Compiler.CodeDomProvider>はサポートしていません。 たとえば J# にはジェネリック型の機能がありません。 このプロパティに j# コード プロバイダーを指定する場合のジェネリック型は生成されません、インポート側の<xref:System.CodeDom.CodeCompileUnit>します。 場合、 <xref:System.Runtime.Serialization.ImportOptions.CodeProvider%2A>の完全なセットを設定しない[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]機能が制限なしで使用されます。  
+  
+-   <xref:System.Runtime.Serialization.ImportOptions.DataContractSurrogate%2A>プロパティです。 <xref:System.Runtime.Serialization.IDataContractSurrogate>実装は、このプロパティを指定します。 <xref:System.Runtime.Serialization.IDataContractSurrogate>インポート処理をカスタマイズします。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md)します。 既定では、サロゲートは使用されません。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.XsdDataContractImporter>   
+ <xref:System.Runtime.Serialization.XsdDataContractExporter>   
+ <xref:System.Runtime.Serialization.ImportOptions>   
+ [データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)   
+ [データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md)   
+ [スキーマのインポートとエクスポート](../../../../docs/framework/wcf/feature-details/schema-import-and-export.md)   
+ [クラスからのスキーマのエクスポート](../../../../docs/framework/wcf/feature-details/exporting-schemas-from-classes.md)   
+ [データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/index.md b/docs/framework/wcf/feature-details/index.md
new file mode 100644
index 00000000000..ac52a593ce4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/index.md
@@ -0,0 +1,91 @@
+---
+title: "WCF 機能の詳細 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "機能 [WCF]"
+  - "WCF, 機能"
+  - "Windows Communication Foundation, 機能"
+ms.assetid: 9b4368ca-0bd3-40dc-a539-bcd5779cee5f
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# WCF 機能の詳細
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、アプリケーションのメッセージング機能を広範囲に制御できます。このセクションの各トピックでは、使用できる機能について詳しく説明します。基本的なプログラミング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+## このセクションの内容  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)  
+ ワークフロー サービスを作成および構成する方法について説明します。  
+  
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)  
+ サービスのさまざまな側面を制御する方法について説明します。  
+  
+ [データ転送とシリアル化](../../../../docs/framework/wcf/feature-details/data-transfer-and-serialization.md)  
+ 相互運用性または将来の互換性を実現するために、データのシリアル化を調整する方法について説明します。  
+  
+ [セッション、インスタンス化、および同時実行](../../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のインスタンス化モードとセッション モードについて説明し、アプリケーションに適したモードを選択する方法を示します。  
+  
+ [トランスポート](../../../../docs/framework/wcf/feature-details/transports.md)  
+ チャネル スタックの最も低いレベルにあるトランスポート層を構成する方法について説明します。  
+  
+ [キューと信頼できるセッション](../../../../docs/framework/wcf/feature-details/queues-and-reliable-sessions.md)  
+ キューについて説明します。キューは、送信元アプリケーションが送ったメッセージを受信側アプリケーションに代わって保存しておき、後で受信側アプリケーションに転送します。  
+  
+ [トランザクション](../../../../docs/framework/wcf/feature-details/transactions-in-wcf.md)  
+ 必要に応じてロールバックできるトランザクション操作を作成する方法について説明します。  
+  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)  
+ 機密性と整合性を備えたアプリケーションを作成するうえで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティがどのように役立つかについて説明します。監査機能として、認証と承認を使用することもできます。  
+  
+ [ピアツーピア ネットワーク](../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)  
+ ビア サービスとクライアントを作成する方法について詳しく説明します。  
+  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)  
+ メタデータのアーキテクチャと形式について説明します。  
+  
+ [クライアント](../../../../docs/framework/wcf/feature-details/clients.md)  
+ サービスにアクセスするさまざまなクライアントを作成する方法について説明します。  
+  
+ [ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)  
+ ホストについて説明します。サービスは、別のアプリケーションまたは自己ホストを使用してホストできます。  
+  
+ [相互運用性と統合](../../../../docs/framework/wcf/feature-details/interoperability-and-integration.md)  
+ COM\+ でホストされるコンポーネント ベースのアプリケーション ロジックに多くの投資を行っている場合に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して既存のロジックを修正することなく拡張する方法について説明します。  
+  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web プログラミング モデルについて説明します。このモデルを使用すると、開発者は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス操作を SOAP 以外のエンドポイントに公開できるようになります。  
+  
+ [WCF 配信](../../../../docs/framework/wcf/feature-details/wcf-syndication.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスから配信フィードを容易に公開できるようにするためのサポートについて説明します。  
+  
+ [AJAX の統合と JSON のサポート](../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)  
+ ASP.NET AJAX \(Asynchronous JavaScript and XML\) と、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが AJAX クライアントに操作を公開できるようにする JSON \(JavaScript Object Notation\) データ形式のサポートについて説明します。  
+  
+ [WCF Discovery](../../../../docs/framework/wcf/feature-details/wcf-discovery.md)  
+ WS\-Discovery プロトコルを使用して、相互運用可能な方法で実行時にサービスを探索可能にするためのサポートについて説明します。  
+  
+ [ルーティング](../../../../docs/framework/wcf/feature-details/routing.md)  
+ ルーティング サービスについて説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.IdentityModel.Selectors>  
+  
+ <xref:System.ServiceModel.Routing>  
+  
+## 関連項目  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/information-disclosure.md b/docs/framework/wcf/feature-details/information-disclosure.md
new file mode 100644
index 00000000000..7473a8e9f21
--- /dev/null
+++ b/docs/framework/wcf/feature-details/information-disclosure.md
@@ -0,0 +1,72 @@
+---
+title: "情報の漏えい | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4064c89f-afa6-444a-aa7e-807ef072131c
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 情報の漏えい
+情報が漏えいすると、攻撃者はシステムに関する重要情報を入手できます。そのため、どのような情報を公開しているか、また、その情報が悪意のあるユーザーによって使用される可能性があるかどうかに常に気を配る必要があります。考えられる情報漏えい攻撃とその軽減策を以下に示します。  
+  
+## メッセージ セキュリティと HTTP  
+ HTTP トランスポート層でメッセージ レベルのセキュリティを使用している場合は、メッセージ レベルのセキュリティで HTTP ヘッダーが保護されないことに注意してください。HTTP ヘッダーを保護する唯一の方法は、HTTP ではなく、HTTPS トランスポートを使用することです。HTTPS トランスポートを使用すると、HTTP ヘッダーを含むメッセージ全体が SSL \(Secure Sockets Layer\) プロトコルを使用して暗号化されます。  
+  
+## ポリシー情報  
+ ポリシーをセキュリティで保護することが重要です。特に、機密事項が含まれる発行済みトークンの要件や、トークン発行者の情報がポリシーで公開されるフェデレーション シナリオでは重要です。このような場合は、フェデレーション サービスのポリシー エンドポイントをセキュリティで保護し、発行済みトークンに含まれるクレームの種類などサービスに関する情報が攻撃者の手に渡らないようにしたり、クライアントが悪意のあるトークン発行者にリダイレクトされたりしないようにすることをお勧めします。たとえば、攻撃者は、フェデレーション信頼チェーンが man\-in\-the\-middle 攻撃を実行する発行者で終了するように再構成することで、ユーザー名\/パスワードのペアを発見することがあります。また、ポリシーの取得によってバインディングを取得するフェデレーション クライアントの場合は、取得したフェデレーション信頼チェーンに含まれる発行者の信頼性を検証することもお勧めします。フェデレーション シナリオ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)」を参照してください。  
+  
+## メモリ ダンプによるクレーム情報の漏えい  
+ アプリケーションにエラーが発生した場合、ワトソン博士などによって作成されたログ ファイルには、クレーム情報が含まれることがあります。この情報はサポート チームなどの他のエンティティに対してエクスポートしないでください。プライベートなデータを含むクレーム情報もエクスポートされます。ログ ファイルを未知のエンティティに送信しないようにすることで、クレーム情報が漏えいするリスクを軽減できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[Windows Server 2003](http://go.microsoft.com/fwlink/?LinkId=89160)」を参照してください。  
+  
+## エンドポイント アドレス  
+ エンドポイント アドレスには、エンドポイントとの通信に必要な情報が含まれます。SOAP セキュリティでは、クライアントとサーバーとの間で対称キーをネゴシエートするために交換されるセキュリティ ネゴシエーション メッセージに、完全なアドレスが含まれている必要があります。セキュリティ ネゴシエーションはブートストラップ プロセスであるため、このプロセスの間、アドレス ヘッダーを暗号化することはできません。したがって、アドレスには機密データを含めないようにします。そうしないと、情報漏えい攻撃につながります。  
+  
+## 暗号化されていない証明書の転送  
+ クライアントの認証に X.509 証明書を使用する場合、証明書は SOAP ヘッダー内で暗号化されずに転送されます。これは潜在的に個人を特定できる情報 \(PII\) の漏えいにつながるので注意が必要です。トランスポート レベルのセキュリティでメッセージが暗号化される `TransportWithMessageCredential` モードでは、これは問題とはなりません。  
+  
+## サービス参照  
+ サービス参照は、別のサービスへの参照です。たとえば、サービスは、操作の過程でクライアントにサービス参照を渡すことがあります。サービス参照は、アプリケーション データや資格情報などをターゲットに対して情報開示する前に、ターゲットのプリンシパル ID を確認する内部コンポーネントである*信頼できる ID 検証機能*と共に使用されることもあります。リモートの信頼できる ID が検証できない、または正しくない場合、送信側は、送信者自身、アプリケーション、またはユーザーが侵害されるおそれのあるデータを開示しないようにする必要があります。  
+  
+ 回避策は次のとおりです。  
+  
+-   サービス参照は信頼できるものと仮定されています。サービス参照インスタンスを転送する場合は、改ざんされていないことを必ず確認するよう注意してください。  
+  
+-   一部のアプリケーションで得られるユーザー エクスペリエンスでは、サービス参照内のデータと、リモート ホストによって信頼性が証明されているデータに基づいて、対話により信頼を確立することができます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このような機能のための拡張ポイントが用意されていますが、実装はユーザーが行う必要があります。  
+  
+## NTLM  
+ Windows ドメイン環境の既定では、Windows 認証は Kerberos プロトコルを使用して、ユーザーの認証と承認を行います。何かの理由で Kerberos プロトコルを使用できない場合は、その代替システムとして NTLM \(NT LAN Manager\) が使用されます。<xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm%2A> プロパティを `false` に設定することで、この動作を無効にできます。NTLM を許可する場合は、次の点に注意してください。  
+  
+-   NTLM はクライアントのユーザー名を公開します。ユーザー名を非公開にしておく必要がある場合は、バインディングの `AllowNTLM` プロパティを `false` に設定します。  
+  
+-   NTLM は、サーバー認証を提供しません。したがって、認証プロトコルとして NTLM が使用されていると、クライアントは自分が適切なサービスと通信しているかどうかを確認できません。  
+  
+### クライアント資格情報または無効な ID の指定による強制的な NTLM の使用  
+ クライアントの作成時に、ドメイン名なしでクライアント資格情報を指定するか、無効なサーバー ID を指定すると、Kerberos プロトコルではなく NTLM が使用されます \(`AlllowNtlm` プロパティが `true` に設定されている場合\)。NTLM ではサーバー認証を行わないため、情報が漏えいするおそれがあります。  
+  
+ たとえば、次の [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコードに示すように、ドメイン名なしで Windows クライアント資格情報を指定できます。  
+  
+```  
+MyChannelFactory.Credentials.Windows.ClientCredential = new System.Net.NetworkCredential("username", "password");  
+```  
+  
+ このコードではドメイン名が指定されておらず、そのため NTLM が使用されます。  
+  
+ ドメインを指定していても、エンドポイント ID 機能を使用して無効なサービス プリンシパル名を指定した場合は、NTLM が使用されます。エンドポイント ID を指定する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)   
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/inside-the-custompeerresolverservice-client-registrations.md b/docs/framework/wcf/feature-details/inside-the-custompeerresolverservice-client-registrations.md
new file mode 100644
index 00000000000..ef2ac2ac76f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/inside-the-custompeerresolverservice-client-registrations.md
@@ -0,0 +1,44 @@
+---
+title: "CustomPeerResolverService 内部 : クライアント登録 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40236953-a916-4236-84a6-928859e1331a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# CustomPeerResolverService 内部 : クライアント登録
+メッシュ内の各ノードは、`Register` 関数を介してエンドポイント情報をリゾルバー サービスに公開します。  リゾルバー サービスは、登録レコードとしてこの情報を保存します。  このレコードには、ノードの一意の識別子 \(RegistrationID\) およびエンドポイント情報 \`\(PeerNodeAddress\) が格納されます。  
+  
+## 古くなったレコードと有効期限  
+ ノードがメッシュからの離脱時に `Unregister` 関数を呼び出し、それによってリゾルバー サービスで登録エントリが削除されるのが理想的ですが、  `Unregister` を呼び出す前に、ノードがシャットダウンしたりアクセスできなくなったりするために、古い登録レコードが残ることがあります。  
+  
+ リゾルバー サービス内の古くなったレコードは、接続障害の原因となる場合があります。  メッシュへの接続時に、ノードがリゾルバー サービスから古い接続情報を受け取った場合、メッシュへの参加に時間がかかることがあります。  古いレコードはメモリも消費します。  効率的なクリーンアップ処理がなければ、登録の保存に使用したキャッシュがオーバーフローしてリゾルバー サービスがクラッシュする可能性があります。  
+  
+ <xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService> は、各レコードを有効期限 \(DateTime\) でマークし、レコードの一部としてその情報を保存します。  サービスは、有効期限を使用してレコードを識別します。  カスタム実装でも同様な処理が必要です。  
+  
+## RefreshInterval および CleanupInterval  
+ `RefreshInterval` の <xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService> プロパティは、サービスの登録ルックアップ テーブルで登録レコードが有効である期間を定義します。  特定のレコードについて、このプロパティで指定された時間が経過すると、そのレコードは古くなり、削除対象としてマークされます。  
+  
+ `CleanupInterval` の <xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService> プロパティは、古くなったレコードの検索と削除の頻度をサービスに指示します。  `CleanupInterval` は、サービスに設定されている `RefreshInterval` 以上の時間に設定する必要があります。  
+  
+ 独自のリゾルバー サービスを実装するためには、古い登録レコードを削除するメンテナンス関数を作成する必要があります。  これにはいくつかの方法があります。  
+  
+-   定期的な管理 : 定期的に鳴るようにタイマーを設定し、データ ストアを調べて古いレコードを削除します。  <xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService> では、この方法を使用します。  
+  
+-   パッシブ削除 : 古くなったレコードを一定間隔で検索する代りに、サービスが既に別の関数を実行中の場合に古くなったレコードを識別し、削除できます。  この方法では、リゾルバー クライアントからの要求に対する応答時間が遅くなる可能性がありますが、タイマーの必要がなくなるほか、一部のノードが `Unregister` を呼び出さずに離脱することが予想される場合には効果的です。  
+  
+## RegistrationLifetime および Refresh  
+ リゾルバー サービスに登録されると、ノードはサービスから <xref:System.ServiceModel.PeerResolvers.RegisterResponseInfo> オブジェクトを受け取ります。  このオブジェクトには、`RegistrationLifetime` プロパティが含まれます。このプロパティは、登録の期限が切れてリゾルバー サービスによって削除されるまでに、どれだけの時間があるかを示します。  たとえば、`RegistrationLifetime` が 2 分である場合、レコードが古くならず、削除されないようにするためには、ノードは 2 分以内に `Refresh` を呼び出す必要があります。  リゾルバー サービスは `Refresh` 要求を受け取ると、レコードを検索し、有効期限をリセットします。  Refresh は、<xref:System.ServiceModel.PeerResolvers.RefreshResponseInfo> プロパティのある `RegistrationLifetime` オブジェクトを返します。  
+  
+## 参照  
+ [ピア リゾルバー](../../../../docs/framework/wcf/feature-details/peer-resolvers.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/integrating-enterprise-services-transactional-components.md b/docs/framework/wcf/feature-details/integrating-enterprise-services-transactional-components.md
new file mode 100644
index 00000000000..65d95d2cde7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/integrating-enterprise-services-transactional-components.md
@@ -0,0 +1,104 @@
+---
+title: "エンタープライズ サービスのトランザクション コンポーネントの統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05dab277-b8b2-48cf-b40c-826be128b175
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# エンタープライズ サービスのトランザクション コンポーネントの統合
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、エンタープライズ サービスと統合するための自動的な機構を提供します \(「[COM\+ アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)」を参照\)。ただし、柔軟性を高めるために、エンタープライズ サービス内でホストされるトランザクション コンポーネントを内部的に使用するサービスを開発する場合があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランザクション機能は <xref:System.Transactions> インフラストラクチャ上に構築されているため、エンタープライズ サービスと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] との統合プロセスは、「[Enterprise Service および COM\+ トランザクションとの相互運用性](http://go.microsoft.com/fwlink/?LinkId=94949)」で概説されている <xref:System.Transactions> とエンタープライズ サービス間の相互運用性を指定するプロセスと同じになります。  
+  
+ フローされる受信トランザクションと COM\+ コンテキスト トランザクションの間に必要なレベルの相互運用性を提供するには、サービス実装で <xref:System.Transactions.TransactionScope> インスタンスを作成し、<xref:System.Transactions.EnterpriseServicesInteropOption> 列挙型の適切な値を使用する必要があります。  
+  
+## エンタープライズ サービスとサービス操作の統合  
+ Allowed トランザクション フローで、<xref:System.Transactions.EnterpriseServicesInteropOption> オプションを指定して <xref:System.Transactions.TransactionScope> を作成する操作を次のコードに示します。このシナリオでは次の条件が適用されます。  
+  
+-   クライアントがトランザクションをフローする場合、エンタープライズ サービス コンポーネント呼び出しを含む操作は、トランザクションのスコープ内で実行されます。<xref:System.Transactions.EnterpriseServicesInteropOption> を使用すると、トランザクションが <xref:System.EnterpriseServices> コンテキストと同期することが保証されます。つまり、<xref:System.Transactions> のアンビエント トランザクションと <xref:System.EnterpriseServices> とが同じになります。  
+  
+-   クライアントがトランザクションをフローしない場合、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> を `true` に設定すると操作の新しいトランザクション スコープが作成されます。同様に、<xref:System.Transactions.EnterpriseServicesInteropOption> を使用すると、操作のトランザクションが <xref:System.EnterpriseServices> コンポーネントのコンテキスト内で使用されるトランザクションと同じになることが保証されます。  
+  
+ 任意の追加のメソッド呼び出しも、同じ操作のトランザクションのスコープ内で行われます。  
+  
+```  
+[ServiceContract()]  
+public interface ICustomerServiceContract  
+{  
+   [OperationContract]  
+   [TransactionFlow(TransactionFlowOption.Allowed)]  
+   void UpdateCustomerNameOperation(int customerID, string newCustomerName);  
+}  
+  
+[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]  
+public class CustomerService : ICustomerServiceContract  
+{  
+   [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+   public void UpdateCustomerNameOperation(int customerID, string newCustomerName)  
+   {  
+   // Create a transaction scope with full ES interop  
+      using (TransactionScope ts = new TransactionScope(  
+                     TransactionScopeOption.Required,  
+                     new TransactionOptions(),  
+                     EnterpriseServicesInteropOption.Full))  
+      {  
+         // Create an Enterprise Services component  
+         // Call UpdateCustomer method on an Enterprise Services   
+         // component   
+  
+         // Call UpdateOtherCustomerData method on an Enterprise   
+         // Services component   
+         ts.Complete();  
+      }  
+  
+      // Do UpdateAdditionalData on an non-Enterprise Services  
+      // component  
+   }  
+}  
+```  
+  
+ 操作の現在のトランザクションと、エンタープライズ サービスのトランザクション コンポーネント呼び出しとの間の同期が不要な場合は、<xref:System.Transactions.TransactionScope> インスタンスのインスタンス化時に <xref:System.Transactions.EnterpriseServicesInteropOption> オプションを使用する必要があります。  
+  
+## エンタープライズ サービスとクライアントの統合  
+ <xref:System.Transactions.EnterpriseServicesInteropOption> を設定した <xref:System.Transactions.TransactionScope> インスタンスを使用するクライアント コードを次のコードに示します。このシナリオでは、トランザクション フローをサポートするサービス操作の呼び出しが、エンタープライズ サービス コンポーネントへの呼び出しと同じトランザクションのスコープ内で発生します。  
+  
+```  
+static void Main()  
+{  
+    // Create a client  
+    CalculatorClient client = new CalculatorClient();  
+  
+    // Create a transaction scope with full ES interop  
+    using (TransactionScope ts = new TransactionScope(  
+          TransactionScopeOption.Required,  
+          new TransactionOptions(),  
+          EnterpriseServicesInteropOption.Full))  
+    {  
+        // Call Add calculator service operation  
+  
+        // Create an Enterprise Services component  
+  
+        // Call UpdateCustomer method on an Enterprise Services   
+        // component   
+  
+        ts.Complete();  
+    }  
+  
+    // Closing the client gracefully closes the connection and   
+    // cleans up resources  
+    client.Close();  
+}  
+```  
+  
+## 参照  
+ [COM\+ アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)   
+ [COM アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md b/docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md
new file mode 100644
index 00000000000..d8d40734d49
--- /dev/null
+++ b/docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md
@@ -0,0 +1,79 @@
+---
+title: "COM アプリケーションとの統合の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "COM [WCF], 統合の概要"
+ms.assetid: 02c5697f-6e2e-47d6-b715-f3a28aebfbd5
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# COM アプリケーションとの統合の概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、マネージ コード開発者は、接続されたアプリケーションを作成するための多彩な環境を使用できます。ただし、COM ベースのアンマネージ コードにかなりの投資を行っており移行を望まない場合でも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーを使用することで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービスを既存のコードに直接統合できます。サービス モニカーは Office VBA、Visual Basic 6.0、または Visual C\+\+ 6.0 などの幅広い COM ベースの開発環境で使用可能です。  
+  
+> [!NOTE]
+>  サービス モニカーは、すべての通信に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の通信チャネルを使用します。このチャネルのセキュリティ メカニズムと識別メカニズムは、標準の COM および DCOM プロキシで使用されるものとは異なります。また、サービス モニカーでは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の通信チャネルを使用するため、すべての呼び出しの既定のタイムアウト時間が 1 分になります。  
+  
+ サービス モニカーを `GetObject` 関数と共に使用することで、アンマネージ開発者は、厳密に型指定された COM 固有の方法を使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービスを呼び出すことができます。そのためには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web サービス コントラクトの定義と、使用されるバインディングが、ローカル COM から参照できる必要があります。他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの場合と同様に、サービス モニカーではサービスへの型指定されたチャネルを構築する必要がありますが、このチャネルは、最初のメソッド呼び出し時に COM プログラマには透過的に構築されます。  
+  
+ 他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと同じように、アプリケーションはモニカーを使用する際に、サービスとの通信に使用するアドレス、バインディング、およびコントラクトを指定します。コントラクトは、次のいずれかの方法で指定できます。  
+  
+-   型指定のあるコントラクト \- クライアント コンピューターで COM から参照できる型として登録されます。  
+  
+-   WSDL コントラクト \- WSDL ドキュメントという形で供給されます。  
+  
+-   MEX コントラクト \- 実行時に Metadata Exchange \(MEX\) エンドポイントから取得されます。  
+  
+## サービス モニカーでサポートされるパラメーター  
+ サービス モニカーでサポートされるパラメーターを次の表に示します。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|`address`|サービスの URL 位置。|  
+|`binding`|アプリケーション構成のバインディング セクションの名前。|  
+|`bindingConfiguration`|名前付きバインディング セクション内の名前付きバインディング インスタンス。|  
+|`contract`|サービス コントラクトまたは \(MEX の\) コントラクト名を表すインターフェイス識別子 \(IID\)。|  
+|`wsdl`|代替形式のコントラクト定義を提供する WSDL ドキュメント。|  
+|`spnIdentity`|サービスとの通信に使用するサーバー プリンシパル名 \(SPN\) ID。|  
+|`upnIdentity`|サービスとの通信に使用するユーザー プリンシパル名 \(UPN\) ID。|  
+|`dnsIdentity`|サービスとの通信に使用する DNS ID。|  
+|`mexAddress`|サービスの Metadata Exchange \(MEX\) エンドポイントの URL 位置。|  
+|`mexBinding`|MEX エンドポイントと接続するための、アプリケーション構成のバインディング セクションの名前。|  
+|`mexBindingConfiguration`|MEX エンドポイントと接続する名前付きバインディング セクション内の名前付きバインディング インスタンス。|  
+|`bindingNamespace`|取得する MEX のバインディング セクション名の名前空間。|  
+|`contractNamespace`|取得する MEX のコントラクトの名前空間。|  
+|`mexSpnIdentity`|MEX エンドポイントとの通信に使用するサーバー プリンシパル名 \(SPN\) ID。|  
+|`mexUpnIdentity`|MEX エンドポイントとの通信に使用するユーザー プリンシパル名 \(UPN\) ID。|  
+|`mexDnsIdentity`|MEX エンドポイントとの通信に使用する DNS ID。|  
+|`serializer`|"XML" シリアライザーと "datacontract" シリアライザーのいずれを使用するかを指定します。|  
+  
+> [!NOTE]
+>  完全に COM ベースのクライアントと共にサービス モニカーを使用する場合でも、クライアント コンピューターには [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] とこれをサポートする .NET Framework 2.0 がインストールされている必要があります。また、サービス モニカーを使用するクライアント アプリケーションには、適切なバージョンの .NET Framework ランタイムが読み込まれていることが重要です。Office アプリケーション内でモニカーを使用する場合、構成ファイルに、正しいフレームワーク バージョンが読み込まれていることを確認する必要があります。たとえば Excel の場合、Excel.exe ファイルと同じディレクトリにある Excel.exe.config というファイルに、次のテキストが記述されている必要があります。  
+>   
+>  `<?xml version="1.0" encoding="utf-8"?>`  
+>   
+>  `<configuration xmlns=` `http://schemas.microsoft.com/.NetConfiguration/v2.0` `>`  
+>   
+>  `<startup>`  
+>   
+>  `<requiredRuntime version="v2.0.50727" />`  
+>   
+>  `</startup>`  
+>   
+>  `</configuration>`  
+  
+## 参照  
+ [方法 : サービス モニカーを登録および構成する](../../../../docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/integrating-with-com-applications.md b/docs/framework/wcf/feature-details/integrating-with-com-applications.md
new file mode 100644
index 00000000000..414426a9ce7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/integrating-with-com-applications.md
@@ -0,0 +1,52 @@
+---
+title: "COM アプリケーションとの統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "COM [WCF]"
+  - "COM [WCF], Windows Communication Foundation の統合"
+  - "WCF, COM 統合"
+  - "WCF, コードの再利用"
+  - "Windows Communication Foundation, COM 統合"
+  - "Windows Communication Foundation, コードの再利用"
+ms.assetid: c98bda3e-6779-419e-8e6d-9aa94053026d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# COM アプリケーションとの統合
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーを使用することによって既存のコードに直接統合できます。  サービス モニカーは Office VBA、Visual Basic 6.0、または Visual C\+\+ 6.0 などの幅広い COM ベースの開発環境で使用可能です。  
+  
+## このセクションの内容  
+ [COM アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md)  
+ 統合プロセスの主要部分の概要を説明します。  
+  
+ [方法 : サービス モニカーを登録および構成する](../../../../docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーを COM アプリケーションで使用するには、必要な属性型を COM に登録し、必要なバインディング構成を使用して COM アプリケーションとモニカーを構成します。  
+  
+ [方法 : 未登録で Windows Communication Foundation のサービス モニカーを使用する](../../../../docs/framework/wcf/feature-details/use-the-wcf-service-moniker-without-registration.md)  
+ WSDL \(Web Services Definition Language\) ドキュメントの形式で、または WS\-MetadataExchange エンドポイントからコントラクトの定義を取得する方法を説明します。  
+  
+ [方法 : WSDL コントラクトと共にサービス モニカーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-wsdl-contracts.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WSDL モニカーを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサンプルを呼び出す方法を説明します。  
+  
+ [方法 : Metadata Exchange コントラクトと共にサービス モニカーを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-a-service-moniker-with-metadata-exchange-contracts.md)  
+ Mex エンドポイントを指定する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] モニカーを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサンプルを呼び出す方法を説明します。  
+  
+ [方法 : チャネルのセキュリティ資格情報を指定する](../../../../docs/framework/wcf/feature-details/how-to-specify-channel-security-credentials.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーは、チャネル資格情報を指定するためのさまざまな代替メソッドの使用を許可する `IChannelCredentials` インターフェイスをサポートします。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 参照  
+ [COM\+ アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md b/docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md
new file mode 100644
index 00000000000..90c5d83d7c5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md
@@ -0,0 +1,115 @@
+---
+title: "COM+ アプリケーションとの統合の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF, COM+ 統合"
+  - "Windows Communication Foundation, COM+ 統合"
+ms.assetid: e481e48f-7096-40eb-9f20-7f0098412941
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# COM+ アプリケーションとの統合の概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は分散アプリケーションを作成するための有用な環境を提供します。  COM\+ でホストされるコンポーネント ベースのアプリケーション ロジックを既に使用している場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、既存のロジックを修正することなく拡張することができます。  既存の COM\+ サービスまたはエンタープライズ サービスの業務ロジックを、Web サービスを介して公開する場合に役立ちます。  
+  
+ COM\+ コンポーネントのインターフェイスを Web サービスとして公開する場合、その仕様やコントラクトは、アプリケーションの初期化の際に実行される自動マッピングによって決まります。  このマッピングの概念モデルを次に示します。  
+  
+-   公開する COM クラスごとに 1 つのサービスが定義されます。  
+  
+-   サービスのコントラクトは、選択されたコンポーネントのインターフェイス定義から直接派生しますが、一部のメソッドを除外することも可能です。  
+  
+-   このコントラクトに定義する操作は、コンポーネントのインターフェイス定義のメソッドから直接派生します。  
+  
+-   操作のためのパラメーターは、コンポーネントのメソッド パラメーターに対応する COM の \(相互運用性を実現するための\) 型から直接派生します。  
+  
+ サービスのアドレス既定値やトランスポート バインディングは、サービス構成ファイルに記述しますが、必要に応じて再設定も可能です。  
+  
+> [!NOTE]
+>  公開した Web サービスのコントラクトは、COM\+ インターフェイスや構成を変更しない限り変わりません。  また、複数のインターフェイスを変更しても、利用できるサービスが自動的に更新されることはありません。COM\+ サービス モデル構成ツール \(ComSvcConfig.exe\) を再実行する必要があります。  
+  
+ COM\+ アプリケーションおよびそのコンポーネントの認証\/承認要求は、Web サービスを使う場合でもやはり必要です。  
+  
+ 呼び出し元が Web サービス トランザクションを起動すると、トランザクション処理中としてマークされたコンポーネントが、該当するトランザクション スコープに入ります。  
+  
+ COM\+ コンポーネントを修正することなく、そのインターフェイスを Web サービスとして公開するための手順を次に示します。  
+  
+1.  COM\+ コンポーネントのインターフェイスを、実際に Web サービスとして公開してかまわないかどうか、あらかじめ確認してください。  
+  
+2.  適切なホスティング モードを選択します。  
+  
+3.  COM\+ サービス モデル構成ツール \(ComSvcConfig.exe\) を使用して、当該インターフェイスを公開するための Web サービスを追加します。  ComSvcConfig.exe の使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : COM\+ サービス モデル構成ツールを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md)」を参照してください。  
+  
+4.  アプリケーション構成ファイルで、追加のサービス設定を構成します。  コンポーネントの構成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : COM\+ サービス設定を構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)」を参照してください。  
+  
+## 公開可能なインターフェイス  
+ Web サービスとして公開できるインターフェイスの種類に関して、いくつか制約があります。  次のようなインターフェイスは公開できません。  
+  
+-   オブジェクト参照をパラメーターとして渡すインターフェイス。ただし、「オブジェクト参照を渡せる場合」で説明されているようにいくつか例外があります。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] COM 相互運用変換ができない型を渡すインターフェイス。  
+  
+-   COM\+ でサービスを提供する場合にアプリケーション プールが有効になるアプリケーションに対するインターフェイス。  
+  
+-   アプリケーション内部でのみ有効な \(プライベートと指定された\) コンポーネントのインターフェイス。  
+  
+-   COM\+ インフラストラクチャ インターフェイス。  
+  
+-   システム アプリケーションからのインターフェース。  
+  
+-   エンタープライズ サービス コンポーネントからのインターフェイスで、グローバル アセンブリ キャッシュに追加されていないもの。  
+  
+### オブジェクト参照を渡せる場合  
+ 展開済みの COM\+ コンポーネントの多くが、ADO Recordset オブジェクトを返す場合などに、パラメーターとしてオブジェクト参照を渡すようになっているため、COM\+ 統合においても、一定の条件を満たす場合には、オブジェクト参照をパラメーターとして渡せるようになっています。  オブジェクト参照を渡せるのは、`IPersistStream` COM インターフェイスを実装しているオブジェクトに限ります。  たとえば ADO Recordset オブジェクトがそうで、アプリケーション固有の COM オブジェクトについてはオブジェクト参照を実装できます。  
+  
+ これに対応して、ComSvcConfig.exe ツールには、メソッドの引数型並び \(シグネチャ\) の検査を省略する **allowreferences** スイッチが用意されています。このスイッチを使用すると、オブジェクト参照がパラメーターに現れていてもエラーになりません。  ただし、パラメーターとして渡すオブジェクト型に名前を付け、\<`persistableTypes`\> 構成要素 \(\<`comContract`\> 要素の子要素\) で識別できるようにする必要があります。  
+  
+ この機能を使用する場合、COM\+ 統合サービスは、`IPersistStream` インターフェイスを使用してオブジェクト インスタンスのシリアル化および逆シリアル化を行います。  オブジェクト インスタンスが `IPersistStream` インターフェイスを実装していない場合、例外がスローされます。  
+  
+ クライアント アプリケーションがサービスとの間でオブジェクトをやり取りするためには、<xref:System.ServiceModel.ComIntegration.PersistStreamTypeWrapper> オブジェクトの該当するメソッドを使用できます。  
+  
+> [!NOTE]
+>  このメソッドはプラットフォーム固有の独自の方式でシリアル化を行うようになっているので、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの間でやり取りする場合に最も適しています。  
+  
+## ホスティング モードの選択  
+ COM\+ が Web サービスを公開する際のホスティング モードには、次のようなものがあります。  
+  
+-   COM\+ ホスト  
+  
+     Web サービスを各アプリケーション専用の COM\+ サーバー プロセス \(Dllhost.exe\) から提供します。  この場合、実際に Web サービス要求が届く前に、あらかじめアプリケーションを起動しておかなければなりません。  COM\+ オプション "Run as an NT Service" または "Leave running when idle" を指定することにより、アプリケーションやサービスがアイドル状態になっても停止しないようになります。  このモードでは、サーバー アプリケーションから Web サービスと DCOM アクセスの両方を利用できます。  
+  
+-   Web ホスト  
+  
+     Web サービスを Web サーバーのワーカー プロセス内で提供します。  最初の要求が届いた時点で、あらかじめ COM\+ がアクティブになっている必要はありません。  必要に応じ、自動的にアクティブ化してから要求を処理するようになっています。  このモードでも、サーバー アプリケーションから Web サービスと DCOM アクセスの両方を利用できますが、Web サービス要求の転送が発生するため、プロセス ホップが発生します。  通常、クライアント側で偽装が必要になります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.Security.WindowsClientCredential> クラスの <xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> プロパティ \(ジェネリック <xref:System.ServiceModel.ChannelFactory%601> クラスのプロパティとしてアクセス\) および <xref:System.Security.Principal.TokenImpersonationLevel> 列挙値を使用してこれを行います。  
+  
+-   Web ホスト \(インプロセス\)  
+  
+     Web サービスと COM\+ アプリケーション ロジックの両方を Web サーバーのワーカー プロセス内で提供します。  Web サービス要求を転送することなく、自動的に Web ホスト モードにすることができます。  ただし、サーバー アプリケーションに DCOM でアクセスできない、という短所があります。  
+  
+### セキュリティの考慮事項  
+ 他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様、公開するサービスのセキュリティ設定は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルに対して行います。  従来の DCOM セキュリティ設定には、コンピューター全体のアクセス権限設定などがありましたが、これは必須ではありません。  COM\+ アプリケーション ロールを強制する場合、コンポーネントの "コンポーネント レベルのアクセス確認" 承認を有効にする必要があります。  
+  
+ セキュリティ保護されていないバインディングは改ざんや情報漏洩を招くので、  セキュリティ保護されたバインディングを使用することをお勧めします。  
+  
+ "COM\+ ホスト" モードおよび "Web ホスト" モードの場合、クライアント アプリケーション側で、サーバー プロセスによるクライアント ユーザーの偽装を許可する必要があります。  これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント側で、偽装レベルを <xref:System.Security.Principal.TokenImpersonationLevel> と設定することにより行います。  
+  
+ インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) で HTTP トランスポートを使用する場合、Httpcfg.exe ツールでトランスポート エンドポイントのアドレスを確保し、他の用途には使用しないように予約することができます。  他の構成では、正当なサービスのように機能する不正なサービスからの防御が重要です。  接続先のエンドポイントで不正なサービスが起動されるのを防ぐため、正当なサービスは NT サービスとして動作するよう設定するとよいでしょう。  これにより、正当なサービスは、他の不正なサービスに優先してエンドポイント アドレスを確保できるようになります。  
+  
+ COM\+ ロールを設定した COM\+ アプリケーションを "Web ホスト" モードで公開する場合、アプリケーションのロールとして "Launch IIS Process Account" を追加する必要があります。  このアカウントは通常、IWAM\_machinename という形の名前で、オブジェクトの使用後、安全にシャットダウンできるようにするために必要です。  ただし、このアカウントにその他の権限は与えないでください。  
+  
+ COM\+ のプロセス リサイクル機能は、統合アプリケーションでは使えません。  アプリケーションがこの機能を使用するよう設定されている場合、コンポーネントが COM\+ ホスト プロセスとして動作していると、サービスを起動できません。  "Web ホスト \(インプロセス\)" モードであれば、プロセス リサイクル設定は適用されないので問題ありません。  
+  
+## 参照  
+ [COM アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md b/docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md
new file mode 100644
index 00000000000..2263410dd6c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md
@@ -0,0 +1,46 @@
+---
+title: "COM+ アプリケーションとの統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "COM+ [WCF]"
+  - "COM+ [WCF], Windows Communication Foundation の統合"
+  - "WCF, COM+ 統合"
+  - "WCF, コードの再利用"
+  - "Windows Communication Foundation, COM+ 統合"
+  - "Windows Communication Foundation, コードの再利用"
+ms.assetid: 98bf7dc4-d49a-4129-a59b-db7a7ec8c241
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# COM+ アプリケーションとの統合
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は分散アプリケーションを作成するための有用な環境を提供します。COM\+ でホストされるコンポーネント ベースのアプリケーション ロジックに多くの時間と労力を費やしている場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、既存のロジックを修正することなく拡張することができます。このセクションのトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で COM\+ を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [COM\+ アプリケーションとの統合の概要](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md)  
+ COM\+ コンポーネントを統合するタイミングと方法の概要を説明します。  
+  
+ [方法 : COM\+ サービス モデル構成ツールを使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-com-service-model-configuration-tool.md)  
+ COM\+ サービス モデル構成コマンド ライン ツール \(ComSvcConfig.exe\) を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとして公開するアプリケーション インターフェイスを構成する方法について説明します。  
+  
+ [方法 : COM\+ サービス設定を構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-com-service-settings.md)  
+ COM\+ オブジェクトを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとして構成する方法について説明します。  
+  
+ [方法 : COM\+ 統合アプリケーションを展開する](../../../../docs/framework/wcf/feature-details/how-to-deploy-a-com-integration-application.md)  
+ COM\+ 統合アプリケーションを移動する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 参照  
+ [COM アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md b/docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md
new file mode 100644
index 00000000000..e6586a7dbb2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md
@@ -0,0 +1,95 @@
+---
+title: "インターネット インフォメーション サービス ホスティングのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0834768e-9665-46bf-86eb-d4b09ab91af5
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# インターネット インフォメーション サービス ホスティングのベスト プラクティス
+このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスのホスティングに関するベスト プラクティスについて概説します。  
+  
+## WCF サービスの DLL としての実装  
+ Web アプリケーションの \\bin ディレクトリに展開される DLL として [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実装すると、Web アプリケーション モデルの外部 \(IIS を展開できないテスト環境など\) でサービスを再利用できるようになります。  
+  
+## IIS でホストされるアプリケーションでのサービス ホスト  
+ IIS ホスト環境によってネイティブにサポートされていないネットワーク トランスポートで待機する新しいサービス ホストを作成する場合は、強制自己ホスト API を使用しないでください \(たとえば、TCP サービスをホストする [!INCLUDE[iis601](../../../../includes/iis601-md.md)]。TCP 通信は、[!INCLUDE[iis601](../../../../includes/iis601-md.md)] でネイティブにサポートされていません\)。この方法はお勧めしません。強制的に作成されたサービス ホストは、IIS ホスト環境内で認識されないからです。重要な点は、IIS がホスト アプリケーション プールがアイドル状態であるかどうかを判断するときに、強制的に作成されたサービスによって実行される処理が IIS によって考慮されないことです。この結果、強制的に作成されたサービス ホストを持つアプリケーションは、IIS ホスト プロセスを積極的に廃棄する IIS ホスト環境を持つことになります。  
+  
+## URI と IIS でホストされるエンドポイント  
+ IIS でホストされるサービスのエンドポイントは、絶対アドレスではなく、相対 URI \(Uniform Resource Identifier\) を使用して構成する必要があります。これにより、エンドポイント アドレスが、ホスト アプリケーションに属する URI アドレスのセット内に確実に含まれ、メッセージに基づくアクティベーションが正常に行われるようになります。  
+  
+## 状態管理とプロセスのリサイクル  
+ IIS ホスト環境は、メモリにローカル状態を保持しないサービスに最適化されています。IIS は、さまざまな外部および内部イベントに応答してホスト プロセスをリサイクルするため、メモリのみに格納される揮発性の状態はすべて失われます。IIS でホストされるサービスは、それぞれの状態をプロセスの外部 \(データベースなど\)、またはアプリケーションのリサイクル イベントが発生した場合に簡単に再作成できるメモリ内キャッシュに格納する必要があります。  
+  
+> [!NOTE]
+>  メッセージ レイヤーの信頼性とセキュリティを確保するために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって使用されるプロトコルは、揮発性のメモリ内状態を利用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるセッションとセキュリティ セッションは、アプリケーションのリサイクルにより、予期しないときに終了する場合があります。これらのプロトコルを利用する、IIS でホストされるアプリケーションでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって提供されるセッション キー以外の要素 \(アプリケーション レイヤー構造やカスタム相関ヘッダーなど\) に依存してアプリケーション レイヤーの状態を関連付けるか、ホストされるアプリケーションでの IIS プロセスのリサイクルを無効にする必要があります。  
+  
+## 中間層シナリオでのパフォーマンスの最適化  
+ *中間層シナリオ* \(受信メッセージに応答して他のサービスを呼び出すサービス\) で最適なパフォーマンスを実現するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス クライアントをリモート サービスに 1 回インスタンス化し、インスタンス化したクライアントを複数の受信要求で繰り返し使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス クライアントのインスタンス化は、既存のクライアント インスタンスでのサービスの呼び出しに比べて負荷のかかる処理ですが、中間層シナリオでは、要求全体でリモート クライアントをキャッシュすることで、パフォーマンスが大幅に向上します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス クライアントはスレッド セーフであるため、複数のスレッドにわたってクライアントへのアクセスを同期する必要がありません。  
+  
+ また、中間層シナリオでは、`svcutil /a` オプションによって生成された非同期 API を使用してパフォーマンスを向上させます。`/a` オプションにより、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) が各サービス操作に対して `BeginXXX/EndXXX` メソッドを生成し、時間のかかる可能性があるリモート サービスへの呼び出しをバックグラウンド スレッドで行うことができるようにします。  
+  
+## マルチホーム シナリオまたはマルチネーム シナリオでの WCF  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、複数のコンピューターが共通の外部名 \(http:\/\/www.contoso.com など\) を共有していても、異なるホスト名によって個別にアドレス指定される \(たとえば、http:\/\/www.contoso.com により、http:\/\/machine1.internal.contoso.com および http:\/\/machine2.internal.contoso.com という 2 台のコンピューターにトラフィックが送られる場合など\) IIS Web ファームの内部に展開できます。この展開シナリオは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって完全にサポートされますが、正確な \(外部\) ホスト名がサービスのメタデータ \(Web サービス記述言語\) に表示されるように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする IIS Web サイトを特別に構成する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって生成されたサービス メタデータに正確なホスト名が確実に表示されるように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする IIS Web サイトの既定 ID を構成して、明示的なホスト名を使用します。たとえば、www.contoso.com ファームの内部に存在するコンピューターでは、HTTP には \*:80:www.contoso.com、HTTPS には \*:443:www.contoso.com という IIS サイト バインディングを使用する必要があります。  
+  
+ Microsoft 管理コンソール \(MMC\) スナップインを使用して、IIS Web サイト バインディングを構成できます。  
+  
+## 異なるユーザー コンテキストで実行されるアプリケーション プールが、一時フォルダー内の他のアカウントのアセンブリを上書きする  
+ 異なるユーザー コンテキストで実行されているアプリケーション プールが、一時的な [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ファイル フォルダー内の他のアカウントのアセンブリを上書きできないようにするには、アプリケーションごとに個別の ID と一時フォルダーを使用します。たとえば、\/Application1 と \/Application2 という 2 つの仮想アプリケーションがある場合は、2 つの異なる ID を使用して、A と B の 2 つのアプリケーション プールを作成できます。アプリケーション プール A は、一方のユーザー ID \(user1\) の下で、アプリケーション プール B は、もう一方のユーザー ID \(user2\) の下で実行でき、\/Application1 が A を、\/Application2 が B を使用するように構成します。  
+  
+ Web.config で、\<system.web\/compilation\/@tempFolder\> を使用して一時フォルダーを構成できます。\/Application1 には "c:\\tempForUser1" を、\/Application2 には "c:\\tempForUser2" を構成できます。これらのフォルダーに対応する書き込みアクセス許可を 2 つの ID に与えます。  
+  
+ これで、user2 は、\(c:\\tempForUser1 の下にある\) \/Application2 のコード生成フォルダーを変更できなくなります。  
+  
+## 非同期処理の有効化  
+ 既定では、IIS 6.0 以前でホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス宛てのメッセージは同期的に処理されます。ASP.NET は、独自のスレッド \(ASP.NET のワーカー スレッド\) で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を呼び出し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は別のスレッドを使用してその要求を処理します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、その処理が完了するまで ASP.NET のワーカー スレッドを保持します。このため、要求は同期的に処理されます。要求を非同期で処理すると、要求の処理に必要なスレッド数が減るため、優れたスケーラビリティが得られます。つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、要求の処理中に ASP.NET のスレッドで保持されません。非同期動作は、IIS 6.0 を実行しているコンピューターでは、サーバーが*サービス拒否* \(DOS\) 攻撃を受ける受信要求を抑制する方法がないため、使用することはお勧めしません。IIS 7.0 以降では、同時要求スロットルが導入されています。`[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ASP.NET\2.0.50727.0]“MaxConcurrentRequestsPerCpu`。この新しいスロットルにより、非同期処理を安全に使用することができます。IIS 7.0 の既定では、非同期のハンドラーとモジュールが登録されます。この機能が無効になっている場合は、アプリケーションの Web.config ファイルで要求の非同期処理を手動で有効にすることができます。使用する設定は、`aspNetCompatibilityEnabled` 設定によって異なります。`aspNetCompatibilityEnabled` を `false` に設定している場合は、次の構成スニペットに示すように、<xref:System.ServiceModel.Activation.ServiceHttpModule> を構成します。  
+  
+```  
+<system.serviceModel>  
+    <serviceHostingEnvironment aspNetCompatibilityEnabled="false" />      
+  </system.serviceModel>  
+  <system.webServer>  
+    <modules>  
+      <remove name="ServiceModel"/>  
+      <add name="ServiceModel"   
+           preCondition="integratedMode,runtimeVersionv2.0"   
+           type="System.ServiceModel.Activation.ServiceHttpModule, System.ServiceModel,Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
+    </modules>  
+    </system.webServer>  
+  
+```  
+  
+ `aspNetCompatibilityEnabled` を `true` に設定している場合は、次の構成スニペットに示すように、<xref:System.ServiceModel.Activation.ServiceHttpHandlerFactory> を構成します。  
+  
+```  
+<system.serviceModel>  
+    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />      
+  </system.serviceModel>  
+  <system.webServer>  
+    <handlers>  
+          <clear/>  
+          <add name="TestAsyncHttpHandler"   
+               path="*.svc"   
+               verb="*"   
+               type="System.ServiceModel.Activation.ServiceHttpHandlerFactory, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"           
+               />  
+    </handlers>      
+  </system.webServer>  
+  
+```  
+  
+## 参照  
+ [Service Hosting Samples](http://msdn.microsoft.com/ja-jp/f703a3f6-0fba-418a-a92f-7ce75ccfa47e)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/internet-unsecured-client-and-service.md b/docs/framework/wcf/feature-details/internet-unsecured-client-and-service.md
new file mode 100644
index 00000000000..ae1da42636e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/internet-unsecured-client-and-service.md
@@ -0,0 +1,119 @@
+---
+title: "セキュリティで保護されていないインターネット環境のクライアントとサービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97a10d79-3e7d-4bd1-9a99-fd9807fd70bc
+caps.latest.revision: 17
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 17
+---
+# セキュリティで保護されていないインターネット環境のクライアントとサービス
+セキュリティで保護されていないパブリックな [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントとサービスの例を次の図に示します。  
+  
+ ![セキュリティで保護されていないインターネット クライアントとサービスのシナリオ](../../../../docs/framework/wcf/feature-details/media/publicunsecured.gif "publicUnsecured")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|なし|  
+|トランスポート|HTTP|  
+|バインディング|<xref:System.ServiceModel.BasicHttpBinding> \(コードを使用する場合\) または [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素 \(構成を使用する場合\)。|  
+|相互運用性|既存の Web サービス クライアントとサービスを使用する|  
+|認証|なし|  
+|整合性|なし|  
+|機密性|なし|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、セキュリティで保護されないエンドポイントを作成する方法を示しています。既定では、<xref:System.ServiceModel.BasicHttpBinding> のセキュリティ モードは <xref:System.ServiceModel.BasicHttpSecurityMode> に設定されます。  
+  
+ [!code-csharp[C_UnsecuredService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_unsecuredservice/cs/source.cs#1)]
+ [!code-vb[C_UnsecuredService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_unsecuredservice/vb/source.vb#1)]  
+  
+### サービス構成  
+ 次のコードは、構成を使用して同一のエンドポイントをセットアップします。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors />  
+    <services>  
+      <service behaviorConfiguration="" name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="basicHttpBinding"  
+                  bindingConfiguration="Basic_Unsecured"   
+                  name="BasicHttp_ICalculator"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <basicHttpBinding>  
+        <binding name="Basic_Unsecured" />  
+      </basicHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ 次のコードは、セキュリティで保護されていないエンドポイントにアクセスする基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを示します。  
+  
+ [!code-csharp[C_UnsecuredClient#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_unsecuredclient/cs/source.cs#1)]
+ [!code-vb[C_UnsecuredClient#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_unsecuredclient/vb/source.vb#1)]  
+  
+### クライアントの設定  
+ クライアントを構成する場合のコード例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <basicHttpBinding>  
+        <binding name="BasicHttpBinding_ICalculator" >  
+          <security mode="None">  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://localhost/Calculator/Unsecured"  
+          binding="basicHttpBinding"   
+          bindingConfiguration="BasicHttpBinding_ICalculator"  
+          contract="ICalculator"   
+          name="BasicHttpBinding_ICalculator" />  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md b/docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md
new file mode 100644
index 00000000000..74b6df3613c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md
@@ -0,0 +1,67 @@
+---
+title: "ASP.NET Web サービスとの相互運用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 622422f8-6651-442f-b8be-e654a4aabcac
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ASP.NET Web サービスとの相互運用
+[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスと [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web サービスの相互運用性は、この 2 つのテクノロジを使用して実装されたサービスを確実に WS\-I Basic Profile 1.1 仕様に準拠させることによって実現されます。WS\-I Basic Profile 1.1 準拠の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] システムによって提供されるバインディングである <xref:System.ServiceModel.BasicHttpBinding> を使用することで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと相互運用できます。  
+  
+ 次のサンプル コードに示すように、<xref:System.Web.Services.WebService> 属性と <xref:System.Web.Services.WebMethodAttribute> 属性をインターフェイス \(クラスではありません\) に追加し、そのインターフェイスを実装するクラスを作成するという、[!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] のオプションを使用します。  
+  
+```  
+[WebService]  
+public interface IEcho  
+{  
+    [WebMethod]  
+    string Echo(string input);  
+}  
+  
+public class Service : IEcho  
+{  
+  
+   public string Echo(string input)  
+   {  
+        return input;  
+    }  
+}  
+```  
+  
+ <xref:System.Web.Services.WebService> 属性を持つインターフェイスは、同じコントラクトを異なる方法で実装する可能性のあるさまざまなクラスで再利用可能なサービスによって実行される操作のコントラクトを構成するため、このオプションを使用することをお勧めします。  
+  
+ <xref:System.Web.Services.Protocols.SoapDocumentServiceAttribute> 属性を使用する場合、`SOAPAction` HTTP ヘッダーではなく、SOAP メッセージの本文要素の完全修飾名に基づいてメッセージをメソッドへルーティングすることは避けます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`SOAPAction` HTTP ヘッダーを使用してメッセージをルーティングします。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> によって既定で型のシリアル化が行われる XML は、XML の名前空間が明示的に定義されている場合、<xref:System.Runtime.Serialization.DataContractSerializer> によって型のシリアル化が行われる XML と意味的に同一です。将来 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用する予定がある場合、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスで使用するデータ型を定義するには、次の操作を実行します。  
+  
+-   XML スキーマではなく、.NET Framework クラスを使用して型を定義します。  
+  
+-   <xref:System.SerializableAttribute> と <xref:System.Xml.Serialization.XmlRootAttribute> だけをそのクラスに追加します。後者を使用して型の名前空間を明示的に定義してください。.NET Framework クラスを XML に変換する方法を制御する目的で、<xref:System.Xml.Serialization> 名前空間の属性を追加しないでください。  
+  
+-   この手法を採用すると、後から <xref:System.Runtime.Serialization.DataContractAttribute> および <xref:System.Runtime.Serialization.DataMemberAttribute> を追加することで、転送のためにクラスをシリアル化する XML に大きな変更を加えることなく .NET クラスをデータ コントラクトにすることができます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスがメッセージ内で使用する型をデータ コントラクトとして処理できます。これは、特に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションのパフォーマンスを向上できるという利点があります。  
+  
+ インターネット インフォメーション サービス \(IIS\) に用意されている認証オプションは使用しないでください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントではこれらの認証オプションはサポートされません。サービスをセキュリティで保護する必要がある場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供されるオプションを使用します。これらのオプションの方が信頼性が高く、標準プロトコルに基づいているためです。  
+  
+## ServiceModel HttpModule の読み込みがパフォーマンスに及ぼす影響  
+ .NET Framework Version 3.0 では、WCF `HttpModule` が、すべての ASP.NET アプリケーションが WCF 対応になるように、ルートの Web.config ファイルにインストールされます。これによりパフォーマンスに影響が出る場合があるため、次の例に示すように、Web.config ファイルの `ServiceModel` を削除することもできます。  
+  
+```  
+<httpModules>  
+    <remove name=”ServiceModel” />  
+<httpModules/>  
+  
+```  
+  
+## 参照  
+ [方法 : WCF サービスおよび ASP.NET Web サービス クライアントを相互運用するために構成する](../../../../docs/framework/wcf/feature-details/config-wcf-service-with-aspnet-web-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/interoperability-and-integration.md b/docs/framework/wcf/feature-details/interoperability-and-integration.md
new file mode 100644
index 00000000000..085388c6fe2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/interoperability-and-integration.md
@@ -0,0 +1,60 @@
+---
+title: "相互運用性と統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d925119-01a1-45c2-9ea0-23061323ad33
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 相互運用性と統合
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の相互運用性と統合について説明します。  
+  
+## このセクションの内容  
+ [Web サービス プロトコルの相互運用性ガイド](../../../../docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Web サービス仕様として知られる一連の仕様をサポートする Web サービスと相互運用するために構築されます。このトピックでは、サポートされている仕様と、それらをサポートするバインドについて説明します。  
+  
+ [COM\+ アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications.md)  
+ COM\+ アプリケーションを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとして公開する方法について説明します。  
+  
+ [COM アプリケーションとの統合](../../../../docs/framework/wcf/feature-details/integrating-with-com-applications.md)  
+ COM アプリケーションから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを呼び出す各種のメソッドについて説明します。  
+  
+ [.NET リモート処理アプリケーションの WCF への移行](../../../../docs/framework/wcf/feature-details/migrating-net-remoting-applications-to-wcf.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] リモート処理と共に使用する方法を説明します。  
+  
+ [Web サービス拡張 3.0 との相互運用](../../../../docs/framework/wcf/feature-details/interoperability-with-web-services-enhancements-3-0.md)  
+ WSE \(Web Services Enhancement\) 3.0 で実装された Web サービスと共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する方法を説明します。  
+  
+ [WSE 3.0 Web サービスの WCF への移行](../../../../docs/framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md)  
+ WSE 3.0 Web サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに移行する方法を説明します。  
+  
+ [ASP.NET Web サービスとの相互運用](../../../../docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスを相互運用する方法について説明します。  
+  
+ [ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに移行する方法を説明します。  
+  
+ [ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに移行する方法を説明します。  
+  
+ [ASP.NET Web サービスを WCF に移行する](../../../../docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md)  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに移行する方法を説明します。  
+  
+ [POX アプリケーションとの相互運用性](../../../../docs/framework/wcf/feature-details/interoperability-with-pox-applications.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって POX \(Plain Old XML\) メッセージを使用するサービスとクライアントの両方を提供する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+## 関連項目  
+ [WCF の拡張](../../../../docs/framework/wcf/extending/extending-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/interoperability-with-pox-applications.md b/docs/framework/wcf/feature-details/interoperability-with-pox-applications.md
new file mode 100644
index 00000000000..7e2b2cc71bf
--- /dev/null
+++ b/docs/framework/wcf/feature-details/interoperability-with-pox-applications.md
@@ -0,0 +1,81 @@
+---
+title: "POX アプリケーションとの相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 449276b8-4633-46f0-85c9-81f01d127636
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# POX アプリケーションとの相互運用性
+"Plain Old XML" \(POX\) アプリケーションは、SOAP エンベロープで囲まれていない XML アプリケーション データのみを含んだ生の HTTP メッセージの交換によって通信するアプリケーションです。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、POX メッセージを使用するサービスとクライアントの両方を提供できます。サービスでは、POX メッセージを送受信する Web ブラウザーやスクリプト言語などのクライアントに対してエンドポイントを公開するサービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して実装できます。クライアントでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルを使用して、POX ベースのサービスと通信するクライアントを実装できます。  
+  
+> [!NOTE]
+>  このドキュメントはもともと [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 3.0 用に書かれたものです。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 3.5 には POX アプリケーション用のサポートが組み込まれています。[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 参照[WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)  
+  
+## WCF による POX プログラミング  
+ POX メッセージを使用して HTTP を介して通信する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、次の [\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を使用します。  
+  
+```  
+<customBinding>  
+   <binding name="poxServerBinding">  
+       <textMessageEncoding messageVersion="None" />  
+       <httpTransport />  
+   </binding>  
+</customBinding>  
+  
+```  
+  
+ このカスタム バインディングには、次の 2 つの要素があります。  
+  
+-   [\<httpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httptransport.md)、および  
+  
+-   [\<textMessageEncoding\>](../../../../docs/framework/configure-apps/file-schema/wcf/textmessageencoding.md)。  
+  
+ 標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テキスト メッセージ エンコーダーで <xref:System.ServiceModel.Channels.MessageVersion.None%2A> 値を使用するように特別に構成することにより、SOAP エンベロープにラップされずに到着する XML メッセージ ペイロードを処理できるようになります。  
+  
+ POX メッセージを使用して HTTP を介して通信する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントでも、次の強制コードに示すように、同様のバインディングを使用します。  
+  
+```  
+private static Binding CreatePoxBinding()  
+{  
+    TextMessageEncodingBindingElement encoder =   
+    new TextMessageEncodingBindingElement( MessageVersion.None, Encoding.UTF8 );  
+    HttpTransportBindingElement transport = new HttpTransportBindingElement();  
+    transport.ManualAddressing = true;  
+    return new CustomBinding( new BindingElement[] { encoder, transport } );  
+}   
+```  
+  
+ POX クライアントでは、メッセージの送信先となる URI を明示的に指定する必要があるため、クライアントの <xref:System.ServiceModel.Channels.TransportBindingElement.ManualAddressing%2A> プロパティを `true` に設定することで、通常、<xref:System.ServiceModel.Channels.HttpTransportBindingElement> を手動アドレス指定モードに構成する必要があります。これにより、アプリケーション コードによってメッセージのアドレスが明示的に指定されることになり、アプリケーションで異なる HTTP URI にメッセージを送信するたびに、新しい <xref:System.ServiceModel.ChannelFactory> を作成する必要がなくなります。  
+  
+ POX メッセージでは重要なプロトコル情報の搬送に SOAP ヘッダーを使用しないため、POX クライアントおよびサービスでは、メッセージの送受信に使用される、基になる HTTP 要求の情報を操作する必要が生じる場合がよく起こります。HTTP ヘッダーやステータス コードなど、HTTP 固有のプロトコル情報は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルでは次の 2 つのクラスを通じて表現されます。  
+  
+-   <xref:System.ServiceModel.Channels.HttpRequestMessageProperty> には、HTTP メソッドと要求ヘッダーなど、HTTP 要求についての情報が含まれます。  
+  
+-   <xref:System.ServiceModel.Channels.HttpResponseMessageProperty> には、HTTP ステータス コード、ステータスの説明、および任意の HTTP 応答ヘッダーなど、HTTP 応答についての情報が含まれます。  
+  
+ http:\/\/localhost:8100\/customers にアドレス指定される HTTP GET 要求メッセージの作成方法を、次のコード例に示します。  
+  
+```  
+Message request = Message.CreateMessage( MessageVersion.None, String.Empty );  
+request.Headers.To = “http://localhost:8100/customers”;  
+  
+HttpRequestMessageProperty property = new HttpRequestMessageProperty();  
+property.Method = “GET”;  
+property.SuppressEntityBody = true;  
+request.Properties.Add( HttpRequestMessageProperty.Name, property );  
+```  
+  
+ 初めに、<xref:System.ServiceModel.Channels.Message.CreateMessage%28System.ServiceModel.Channels.MessageVersion%2CSystem.String%29> を呼び出すことで、空の <xref:System.ServiceModel.Channels.Message> 要求を作成します。<xref:System.ServiceModel.Channels.MessageVersion.None%2A> パラメーターを使用して SOAP エンベロープが不要であることを示し、<xref:System.String.Empty> パラメーターをアクションとして渡します。次に、<xref:System.ServiceModel.Channels.MessageHeaders.To%2A> を目的の URI に設定することで、要求メッセージをアドレス指定します。さらに、<xref:System.ServiceModel.Channels.HttpRequestMessageProperty> を作成し、<xref:System.ServiceModel.Channels.HttpRequestMessageProperty.Method%2A> を HTTP 動詞の GET メソッドに設定し、また <xref:System.ServiceModel.Channels.HttpRequestMessageProperty.SuppressEntityBody%2A> を `true` に設定して、送信 HTTP 要求メッセージの本文でデータが送信されないことを示します。最後に、要求プロパティを要求メッセージの <xref:System.ServiceModel.Channels.Message.Properties%2A> コレクションに追加して、HTTP トランスポートによる要求の送信方法に影響を与えることができるようにします。これで <xref:System.ServiceModel.Channels.IRequestChannel> の適切なインスタンスを使用してメッセージを送信する用意が整いました。  
+  
+ サービスにおいても、受信メッセージから <xref:System.ServiceModel.Channels.HttpRequestMessageProperty> を抽出して応答を構築する際に同様のテクニックを使用できます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/interoperability-with-web-services-enhancements-3-0.md b/docs/framework/wcf/feature-details/interoperability-with-web-services-enhancements-3-0.md
new file mode 100644
index 00000000000..ee5efea9f5a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/interoperability-with-web-services-enhancements-3-0.md
@@ -0,0 +1,33 @@
+---
+title: "Web サービス拡張 3.0 との相互運用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8e589d2-12c6-4794-8a11-1ee90b47dfaa
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Web サービス拡張 3.0 との相互運用
+[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスが WS\-Addressing 仕様の 2004 年 8 月版を使用して構成されている場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントおよびサービスは Microsoft .NET クライアントおよびサービスの WSE \(Web サービス拡張\) 3.0 とネットワーク レベルで互換性があります。  
+  
+## このセクションの内容  
+ [方法 : WCF サービスと WSE 3.0 クライアントを相互運用するために構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-wcf-services-to-interoperate-with-wse-3-0-clients.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスが Microsoft .NET 用 Web サービス拡張 \(WSE\) 3.0 のクライアントと通信できるよう設定する手順を説明します。  
+  
+ [方法 : WCF クライアントと WSE3.0 サービスを相互運用するために構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-wcf-client-to-interoperate-with-wse3-0-services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアントが Microsoft .NET 用 WSE \(Web サービス拡張\) 3.0 のサービスと通信できるよう設定する手順を説明します。  
+  
+## 関連項目  
+ [WSE 3.0 Web サービスの WCF への移行](../../../../docs/framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md)  
+  
+## 参照  
+ [ASP.NET Web サービスとの相互運用](../../../../docs/framework/wcf/feature-details/interop-with-aspnet-web-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/interoperable-object-references.md b/docs/framework/wcf/feature-details/interoperable-object-references.md
new file mode 100644
index 00000000000..6f50fab7939
--- /dev/null
+++ b/docs/framework/wcf/feature-details/interoperable-object-references.md
@@ -0,0 +1,109 @@
+---
+title: "相互運用可能なオブジェクト参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb8da4c8-08ca-4220-a16b-e04c8f527f1b
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 相互運用可能なオブジェクト参照
+既定では、<xref:System.Runtime.Serialization.DataContractSerializer> はオブジェクトを値でシリアル化します。  <xref:System.Runtime.Serialization.DataContractAttribute.IsReference%2A> プロパティを使用すると、型のオブジェクトをシリアル化する場合に、オブジェクト参照を保持するようにデータ コントラクト シリアライザーに指示できます。  
+  
+## 生成される XML  
+ 例として、次のオブジェクトを考えます。  
+  
+```  
+[DataContract]  
+public class X  
+{  
+    SomeClass someInstance = new SomeClass();  
+    [DataMember]  
+    public SomeClass A = someInstance;  
+    [DataMember]  
+    public SomeClass B = someInstance;  
+}  
+  
+public class SomeClass   
+{  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer.PreserveObjectReferences%2A> を `false` \(既定値\) に設定すると、次の XML が生成されます。  
+  
+```  
+<X>  
+   <A>contents of someInstance</A>  
+   <B>contents of someInstance</B>  
+</X>  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer.PreserveObjectReferences%2A> を `true` に設定すると、次の XML が生成されます。  
+  
+```  
+<X>  
+   <A id="1">contents of someInstance</A>  
+   <B ref="1" />  
+</X>  
+```  
+  
+ ただし、`preserveObjectReferences` プロパティが `true` に設定されている場合でも、<xref:System.Runtime.Serialization.XsdDataContractExporter> がそのスキーマに `id` 属性や `ref` 属性を記述することはありません。  
+  
+## IsReference の使用  
+ スキーマの記述に従った有効なオブジェクト参照情報を生成するには、<xref:System.Runtime.Serialization.DataContractAttribute> 属性を型に適用し、<xref:System.Runtime.Serialization.DataContractAttribute.IsReference%2A> フラグを `true` に設定します。  前のサンプル クラス `X` で `IsReference` を使用するには、次のようにします。  
+  
+ `[DataContract(IsReference=true)] public class X`  
+  
+ `{`  
+  
+ `SomeClass someInstance = new SomeClass();`  
+  
+ `[DataMember]`  
+  
+ `public SomeClass A = someInstance;`  
+  
+ `[DataMember]`  
+  
+ `public SomeClass B = someInstance;`  
+  
+ `}`  
+  
+ `public class SomeClass`  
+  
+ `{`  
+  
+ `}`  
+  
+ 次のような XML が生成されます。  
+  
+ `<X>`  
+  
+ `<A id="1">`  
+  
+ `<Value>contents of A</Value>`  
+  
+ `</A>`  
+  
+ `<B ref="1">`  
+  
+ `</B>`  
+  
+ `</X>`  
+  
+ `IsReference` を使用すると、メッセージのラウンド トリップに対応できます。  これを使用しない場合、型をスキーマから生成しても、その型に対して返された XML に、もともと想定していたスキーマとの互換性があるとは限りません。  つまり、`id` 属性と `ref` 属性がシリアル化されたとしても、元のスキーマによってこれらの属性 \(またはすべての属性\) が拒否される可能性があります。  `IsReference` をデータ メンバーに適用すれば、そのメンバーは、ラウンド トリップ時にも "参照可能" として認識され続けます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.CollectionDataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute.IsReference%2A>   
+ <xref:System.Runtime.Serialization.CollectionDataContractAttribute.IsReference%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/intranet-unsecured-client-and-service.md b/docs/framework/wcf/feature-details/intranet-unsecured-client-and-service.md
new file mode 100644
index 00000000000..47610221c21
--- /dev/null
+++ b/docs/framework/wcf/feature-details/intranet-unsecured-client-and-service.md
@@ -0,0 +1,122 @@
+---
+title: "セキュリティで保護されていないイントラネットのクライアントとサービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f450f5d4-3547-47ec-9320-2809e6a12634
+caps.latest.revision: 20
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 20
+---
+# セキュリティで保護されていないイントラネットのクライアントとサービス
+次の図は、セキュリティで保護されたプライベート ネットワーク上で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに情報を提供するために開発された単純な [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを示しています。  データの重要性が低いか、ネットワークが本質的に安全であることが期待されるか、または [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャよりも下位層でセキュリティが提供されているため、セキュリティは必要ではありません。  
+  
+ ![セキュリティで保護されていないイントラネットのクライアントとサービスのシナリオ](../../../../docs/framework/wcf/feature-details/media/unsecuredwebservice.gif "UnsecuredWebService")  
+  
+|特徴|説明|  
+|--------|--------|  
+|セキュリティ モード|なし|  
+|Transport|TCP|  
+|バインディング|<xref:System.ServiceModel.NetTcpBinding>|  
+|相互運用性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のみ|  
+|認証|なし|  
+|整合性|なし|  
+|機密性|なし|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、セキュリティで保護されないエンドポイントを作成する方法を示しています。  
+  
+ [!code-csharp[C_UnsecuredService#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_unsecuredservice/cs/source.cs#2)]
+ [!code-vb[C_UnsecuredService#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_unsecuredservice/vb/source.vb#2)]  
+  
+### 構成  
+ 次のコードは、次に示す構成を使用して同一のエンドポイントをセットアップします。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors />  
+    <services>  
+      <service behaviorConfiguration=""   
+               name="ServiceModel.Calculator">  
+        <endpoint address="net.tcp://localhost:8008/Calculator"   
+                  binding="netTcpBinding"  
+                  bindingConfiguration="tcp_Unsecured"   
+                  name="netTcp_ICalculator"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="tcp_Unsecured">  
+          <security mode="None" />  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## Client  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。  代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。  次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ 次のコードは、TCP プロトコルを使用してセキュリティで保護されていないエンドポイントにアクセスする基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの作成方法を示します。  
+  
+ [!code-csharp[C_UnsecuredClient#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_unsecuredclient/cs/source.cs#2)]
+ [!code-vb[C_UnsecuredClient#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_unsecuredclient/vb/source.vb#2)]  
+  
+### 構成  
+ 次の構成コードは、クライアントに適用されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="NetTcpBinding_ICalculator" >  
+          <security mode="None">  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="net.tcp://machineName:8008/Calculator "  
+                binding="netTcpBinding"   
+                bindingConfiguration="NetTcpBinding_ICalculator"  
+                contract="ICalculator"   
+                name="NetTcpBinding_ICalculator" />  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetTcpBinding>   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/large-data-and-streaming.md b/docs/framework/wcf/feature-details/large-data-and-streaming.md
new file mode 100644
index 00000000000..058e43216db
--- /dev/null
+++ b/docs/framework/wcf/feature-details/large-data-and-streaming.md
@@ -0,0 +1,249 @@
+---
+title: "大規模データとストリーミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab2851f5-966b-4549-80ab-c94c5c0502d2
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# 大規模データとストリーミング
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、XML ベースの通信インフラストラクチャです。  XML データは通常、[XML 1.0 仕様](http://go.microsoft.com/fwlink/?LinkId=94838)で定義された標準テキスト形式でエンコードされるので、接続されたシステムの開発者および設計者にとって共通の関心事は、ネットワーク経由で送信されるメッセージのネットワーク フットプリント \(サイズ\) です。XML のエンコーディングをテキスト ベースで行う一方で、バイナリ データを効率的に転送することは容易ではありません。  
+  
+## 基本的な考慮事項  
+ 後で示される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の情報に関する背景情報として、接続されたシステムのインフラストラクチャ全般に当てはまる、エンコーディング、バイナリ データ、およびストリーミングに関する一般的な注意点や考慮事項から説明します。  
+  
+### データのエンコーディング: テキストとバイナリ  
+ 開発者が揃って口にする懸念には、開始タグと終了タグが繰り返し使用される XML では、バイナリ形式と比較してオーバーヘッドが大きくなるのではないか、数値のエンコーディングは、数値をテキスト値で表現するのでサイズが膨れ上がるのではないか、バイナリ データをテキスト形式に埋め込むためには特別なエンコーディングが必要なので、バイナリ データを効率的に表現することはできないのではないか、などがあります。  
+  
+ このような懸念の多くは当然ではありますが、XML Web サービス環境で XML のテキスト エンコードされたメッセージと、従来のリモート プロシージャ コール \(RPC\) 環境でバイナリ エンコードされたメッセージとの間の実際の相違は、それほど大きくありません。  
+  
+ XML のテキスト エンコードされたメッセージは、透過的であり、ユーザーが "読める" のに比べ、バイナリ メッセージのほとんどはわかりにくく、ツールなしでデコードすることは困難です。  このような読みやすさの違いから見過ごされる点は、バイナリ メッセージにはペイロードにインライン メタデータも含まれている場合が多く、これによって、XML テキスト メッセージと同様のオーバーヘッドが追加されるという事実です。  これは特に、疎結合および動的呼び出しの実現を目的としたバイナリ形式に当てはまります。  
+  
+ ただし、バイナリ形式では、これらのメタデータ記述情報が "ヘッダー" に格納されるのが普通です。ヘッダーでは、後続のデータ レコードに関するデータ レイアウトも宣言します。  この共通メタデータ ブロック宣言の後に続くペイロードに伴うオーバーヘッドは最小限です。  一方、XML では、各データ項目は要素または属性に囲まれ、外側のメタデータはシリアル化されたペイロード オブジェクトごとに、繰り返し含められます。  これらのことと、一部のメタデータ記述はテキストとバイナリの両方に対して必要になることを考えると、シリアル化するペイロード オブジェクトが 1 つであれば、テキスト表現とバイナリ表現のサイズは同様になることがわかります。ただしバイナリ形式の方が全体のオーバーヘッドが低いため、転送するペイロード オブジェクトの数が増えるごとに、共通のメタデータ記述によるメリットが生じます。  
+  
+ 数値など特定のデータ型では、プレーンテキストの代わりに 128 ビットの decimal 型など固定サイズのバイナリ数値表現を使用するデメリットもあります。プレーンテキスト表現を使用すると何バイトか小さくなる可能性があります。  また、テキスト データには、より柔軟性に優れた XML テキスト エンコーディングのオプションから選択できることによるメリットがあります。一方、一部のバイナリ形式では、16 ビットまたは 32 ビットの Unicode が既定値として設定されている場合があります \(これは、.NET Binary XML 形式には当てはまりません\)。  
+  
+ したがって、テキストかバイナリかを決定する場合、バイナリ メッセージは常に XML テキスト メッセージよりも小さいという推測に基づいて簡単に決めることはできません。  
+  
+ XML テキスト メッセージは、標準ベースのメッセージであるため、きわめて広範囲な相互運用性オプションとプラットフォーム サポートが提供されるという明確な利点があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、このトピックで後述する「エンコーディング」を参照してください。  
+  
+### バイナリ コンテンツ  
+ 写真、ビデオ、サウンド クリップのほか、サービスとコンシューマーとの間で交換される他の不透明な形式のバイナリ データなど、サイズの大きいバイナリ データ項目の場合、生成されるメッセージ サイズに関しては、テキスト ベースのエンコーディングよりバイナリ エンコーディングの方が優れています。  このようなデータを XML テキストに格納するには、Base64 エンコーディングを使用してそのデータをエンコードするのが一般的です。  
+  
+ Base64 でエンコードされた文字列では、各文字で元の 8 ビット データのうち 6 ビット分を表すので、その結果、Base64 ではエンコーディングとオーバーヘッドの比率が 4:3 になります。このとき、通常追加される書式設定文字 \(復帰とライン フィード\) は計算に入れていません。  XML エンコーディングとバイナリ エンコーディングとの間の相違の大きさは、通常、シナリオによって異なりますが、500 MB のペイロードを送信するときにサイズの増加率が 33% を超えることは、受け入れられません。  
+  
+ このようなエンコーディングのオーバーヘッドを回避するには、MTOM \(Message Transmission Optimization Mechanism\) 規格を使用すると、特別なエンコーディングを行うことなく、メッセージに含まれている大きいデータ要素を外部化し、それをバイナリ データとしてメッセージと共に送信できます。  MTOM でメッセージを交換する方法は、添付ファイルや埋め込みコンテンツ \(写真やその他の埋め込みコンテンツ\) が付属している簡易メール転送プロトコル \(SMTP\) 電子メール メッセージを交換する方法と似ています。MTOM メッセージは multipart\/related MIME シーケンスとしてパッケージ化され、ルート パートが実際の SOAP メッセージになります。  
+  
+ MTOM SOAP メッセージが、エンコードされていないバージョンと異なるのは、メッセージ内でバイナリ データを含んでいた元の要素の代わりに、それぞれの MIME パートを参照している特別な要素タグが配置される点です。  つまり SOAP メッセージでは、メッセージと共に送信される MIME パートを指すことによってバイナリ コンテンツが参照されますが、含まれているのは XML テキスト データのみです。  このモデルは、広く確立している SMTP モデルに厳密に適合するように作成されています。このため、さまざまなプラットフォームで、MTOM メッセージをエンコードまたはデコードするための幅広いツール サポートが提供され、きわめて高い相互運用性が確保されています。  
+  
+ ただし MTOM でも Base64 の場合と同様、MIME 形式をサポートするためのオーバーヘッドが伴います。このため、MTOM を使用するメリットが現れるのは、バイナリ データ要素のサイズが約 1 KB を超える場合だけです。  バイナリ ペイロードが 1 KB を下回る場合は、このオーバーヘッドが原因で、バイナリ データに Base64 エンコーディングを使用したメッセージよりも、エンコード済みの MTOM メッセージの方が大きくなる可能性があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、このトピックで後述する「エンコーディング」を参照してください。  
+  
+### 大規模データ コンテンツ  
+ ネットワーク フットプリントとは別に、前述の例のようにペイロードが 500 MB であれば、サービスとクライアントにもローカルの問題が生じます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の既定では、*"バッファー モード"* でメッセージが処理されます。  つまり、メッセージ コンテンツ全体が、送信前にも受信後にもメモリに存在します。  この方式は、ほとんどのシナリオに対して有効であり、デジタル署名や信頼できる配信などのメッセージング機能には必要ですが、メッセージが大きいと、システムのリソースが使い果たされてしまう可能性があります。  
+  
+ ペイロードが大きい場合、有効な処理方法は、ストリーミングです。  メッセージ、特に XML で表現されているメッセージは一般的に、比較的小型のデータ パッケージであると思われがちですが、メッセージのサイズは数ギガバイトになることもあり、データ パッケージというよりも連続したデータ ストリームに似ています。  バッファー モードではなく、ストリーミング モードでデータを転送する場合、送信側が、メッセージ本体のコンテンツをストリームの形で受信側に対して準備します。続いてメッセージ インフラストラクチャは、このデータの準備が整い次第、送信側から受信側にデータを転送します。  
+  
+ このような大きいデータ コンテンツの転送が発生する最も一般的なシナリオは、次のようなバイナリ データ オブジェクトの転送です。  
+  
+-   簡単にメッセージ シーケンスに分割できないバイナリ データ オブジェクト  
+  
+-   タイムリーに配信する必要があるバイナリ データ オブジェクト  
+  
+-   転送の開始時に完全な形で準備されていないバイナリ データ オブジェクト  
+  
+ 通常、データにこのような制約がない場合は、1 つの大きいメッセージではなく、セッションの有効範囲内でメッセージ シーケンスを送信することをお勧めします。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、このトピックで後述する「データのストリーミング」を参照してください。  
+  
+ 大量のデータを送信する場合は、maxAllowedContentLength の IIS 設定 \(詳細については、「[要求の制限 requestLimits](http://go.microsoft.com/fwlink/?LinkId=253165)」を参照してください\) および maxReceivedMessageSize のバインディング設定 \(<xref:System.ServiceModel.BasicHttpBinding.MaxReceivedMessageSize%2A>、<xref:System.ServiceModel.NetTcpBinding.MaxReceivedMessageSize%2A> など\) を行う必要があります。  maxAllowedContentLength プロパティの既定値は 28.6 MB で、maxReceivedMessageSize プロパティの既定値は 64 KB です。  
+  
+## エンコーディング  
+ *エンコーディング*とは、ネットワーク上でのメッセージの表示方法に関する規則を定義したものです。  *エンコーダー*はこのようなエンコーディングを実装し、送信側では、メモリ内メッセージの <xref:System.ServiceModel.Channels.Message> を変換して、ネットワークで送信できるバイト ストリームまたはバイト バッファーにする役割を担います。  受信側では、バイト シーケンスがエンコーダーによってメモリ内メッセージに変換されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、3 つのエンコーダーが用意されています。開発者は、必要に応じて独自のエンコーダーを作成してプラグインすることもできます。  
+  
+ 個々の標準バインディングには、構成済みのエンコーダーが含まれています。Net\* プレフィックスで始まるバインディングでは、\(<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> クラスを含めることで\) バイナリ エンコーダーが使用されるのに対し、<xref:System.ServiceModel.BasicHttpBinding> クラスと <xref:System.ServiceModel.WSHttpBinding> クラスでは、既定で \(<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> クラスを含めることで\) テキスト メッセージ エンコーダーが使用されます。  
+  
+|エンコーダー バインド要素|説明|  
+|-------------------|--------|  
+|<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>|テキスト メッセージ エンコーダーは、すべての HTTP ベースのバインディングに対する既定のエンコーダーで、相互運用性が特に重要になるカスタムのバインディングにも適しています。  このエンコーダーで入出力が行われるのは、標準の SOAP 1.1\/SOAP 1.2 テキスト メッセージであり、バイナリ データに対して特別な処理は行われません。  メッセージの <xref:System.ServiceModel.Channels.MessageVersion> が `None` に設定されている場合、出力から SOAP エンベロープ ラッパーが除去され、メッセージ本体のコンテンツだけがシリアル化されます。|  
+|<xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement>|MTOM メッセージ エンコーダーは、バイナリ データに対する特別な処理を実装したテキスト エンコーダーです。このエンコーダーは、状況に応じた最適化を要するユーティリティなので、どの標準バインディングでも既定では使用されません。  MTOM エンコーディングのメリットを生じるしきい値より大きいバイナリ データがメッセージにある場合、そのデータは、メッセージ エンベロープの後に続く MIME パートとして外部化されます。  このセクションの「MTOM の有効化」を参照してください。|  
+|<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>|バイナリ メッセージ エンコーダーは、Net\* バインディングの既定のエンコーダーであり、送信側と受信側の両方が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をベースとしている場合にも適しています。  バイナリ メッセージ エンコーダーでは、XML 情報セット \(Infoset\) を対象とした Microsoft 固有のバイナリ表現である .NET Binary XML 形式が使用されます。この形式ではバイナリ データがバイト ストリームとしてエンコードされ、通常は、同等の XML 1.0 表現よりもフットプリントが小さくなりきます。|  
+  
+ 相互運用性が要求される通信パスでは一般的にテキスト メッセージ エンコーディングが最適であり、それ以外の通信パスではバイナリ メッセージ エンコーディングが最適です。  バイナリ メッセージ エンコーディングで生成されるメッセージのサイズは、単一のメッセージであればテキストより小さくなることが普通ですが、通信セッションの間に、さらに小さくなっていきます。  テキスト エンコーディングと異なり、バイナリ エンコーディングでは、Base64 を使用するなど、バイナリ データに対する特別な処理を行う必要がありません。このエンコーディングでは、バイトがバイトとして表現されます。  
+  
+ ソリューションで、相互運用性は必要ではないが、HTTP トランスポートを使用する場合は、トランスポートとして <xref:System.ServiceModel.Channels.HttpTransportBindingElement> クラスを使用するカスタム バインディングに <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> を組み込むことができます。  サービスを利用する多数のクライアントが相互運用性を必要とする場合は、両者にとって適切な種類のトランスポートとエンコーディングがそれぞれに有効化された並行エンドポイントを公開することをお勧めします。  
+  
+### MTOM の有効化  
+ 相互運用性が必須である一方で、大きなバイナリ データを送信する必要がある場合、エンコーディング方法のもう 1 つの選択肢に、MTOM メッセージ エンコーディングがあります。このエンコーディングを有効化するには、標準の <xref:System.ServiceModel.BasicHttpBinding> バインディングまたは <xref:System.ServiceModel.WSHttpBinding> バインディングでそれぞれの `MessageEncoding` プロパティを <xref:System.ServiceModel.WSMessageEncoding> に設定するか、<xref:System.ServiceModel.Channels.CustomBinding> に <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> を組み込みます。  次のコード例は、「[MTOM エンコーディング](../../../../docs/framework/wcf/samples/mtom-encoding.md)」のサンプルからの抜粋であり、構成で MTOM を有効化する方法を示しています。  
+  
+```  
+<system.serviceModel>  
+     …  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="ExampleBinding" messageEncoding="Mtom"/>  
+      </wsHttpBinding>  
+    </bindings>  
+     …  
+<system.serviceModel>  
+```  
+  
+ 前述のように、MTOM エンコーディングの使用が適しているかどうかは、送信するデータ量によって異なります。  また、MTOM はバインディング レベルで有効になるので、MTOM を有効にすると、個々のエンドポイント上のすべての操作に作用します。  
+  
+ MTOM エンコーダーでは、バイナリ データが最終的に外部化されるかどうかに関係なく、MTOM エンコードされた MIME\/multipart メッセージが常に出力されるので、通常は、1 KB を超えるバイナリ データを含んだメッセージの交換が行われるエンドポイントに対してのみ、MTOM を有効にしてください。  また、MTOM が有効化されたエンドポイント用に設計されたサービス コントラクトは、可能であれば、このようなデータ転送操作を指定するように制限してください。  関連する制御機能は別のコントラクトに記述するようにしてください。  この "MTOM のみ" の規則が当てはまるのは、MTOM が有効化されたエンドポイントを経由して送信されるメッセージだけです。MTOM 以外の受信メッセージについては、MTOM エンコーダーによって同様にデコードおよび解析されます。  
+  
+ MTOM エンコーダーの使用は、他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 機能すべてに適合しています。  セッション サポートが必要な場合などのように、すべての場合でこの規則が守られるわけではありません。  
+  
+### プログラミング モデル  
+ 3 つの組み込みエンコーダーのうち、どのエンコーダーをアプリケーションで使用する場合も、バイナリ データの転送に関するプログラミング方法は同じです。  違いは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] による、データ型に基づいたデータ処理の方法です。  
+  
+```  
+[DataContract]  
+class MyData  
+{  
+    [DataMember]  
+    byte[] binaryBuffer;  
+    [DataMember]  
+    string someStringData;  
+}   
+```  
+  
+ MTOM を使用する場合、上記のデータ コントラクトは次の規則に従ってシリアル化されます。  
+  
+-   `binaryBuffer` が `null` ではなく、それぞれに格納されているデータのサイズが大きい場合、つまり Base64 エンコーディングと比較しても MTOM 外部化によるオーバーヘッド \(MIME ヘッダーなど\) を正当化できるサイズである場合は、データが外部化され、バイナリ MIME パートとしてメッセージと共に転送されます。  しきい値を超えていない場合、データは Base64 としてエンコードされます。  
+  
+-   メッセージの本体で、文字列 \(およびバイナリ以外のその他の型\) はサイズに関係なく文字列として表現されます。  
+  
+ 上記の例に示したような明示的なデータ コントラクトを使用する場合も、操作にパラメーター リストを使用する場合も、入れ子構造のデータ コントラクトを使用する場合も、コレクション内でデータ コントラクト オブジェクトを転送する場合も、MTOM エンコーディングへの作用は同じです。  バイト配列は、常に最適化の対象と見なされるため、最適化のしきい値条件を満たしていれば最適化されます。  
+  
+> [!NOTE]
+>  データ コントラクト内では <xref:System.IO.Stream?displayProperty=fullName> の派生型を使用しないでください。  ストリーム データは、次の「データのストリーミング」で説明するストリーミング モデルを使用して送受信する必要があります。  
+  
+## データのストリーミング  
+ 大量のデータを転送する場合、メッセージ全体をメモリ内でバッファー化および処理するという既定動作の代わりに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のストリーミング転送モードを使用することができます。  
+  
+ 前述のように、ストリーミングの有効化は、データをセグメントに分割できない場合、メッセージをタイムリーに配信する必要がある場合、または転送の開始時にデータがすべて揃っていない場合に、テキストまたはバイナリのコンテンツを伴う大きなメッセージに関してのみ実行するようにしてください。  
+  
+### 制限  
+ ストリーミングを有効化した状態では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の多くの機能を使用できません。  
+  
+-   メッセージ本体に対するデジタル署名は実行できません。デジタル署名では、メッセージ コンテンツ全体に対してハッシュを計算する必要があります。  ところがストリーミングでは、メッセージ ヘッダーが作成され、送信される時点では、メッセージ コンテンツがすべて揃っているわけではありません。デジタル署名を処理できないのは、このためです。  
+  
+-   暗号化では、データが正しく再構築されていることを検証するために、デジタル署名が必要になります。  
+  
+-   信頼できるセッションでは、メッセージが転送中に失われた場合に再配信できるように、クライアントで送信メッセージをバッファー化する必要があります。また、サービス実装にメッセージを渡す前に、いったんメッセージをサービスで格納し、メッセージが正しい順序で受信されなかった場合に備えてメッセージの順序を保持する必要があります。  
+  
+ このような機能上の制約により、ストリーミングではトランスポート レベルのセキュリティ オプションしか使用できず、信頼できるセッションを有効にできません。  ストリーミングは、以下のシステム定義バインディングでしか使用できません。  
+  
+-   <xref:System.ServiceModel.BasicHttpBinding>  
+  
+-   <xref:System.ServiceModel.NetTcpBinding>  
+  
+-   <xref:System.ServiceModel.NetNamedPipeBinding>  
+  
+-   <xref:System.ServiceModel.WebHttpBinding>  
+  
+ HTTP とは異なり、<xref:System.ServiceModel.NetTcpBinding> と <xref:System.ServiceModel.NetNamedPipeBinding> の基になるトランスポートには、信頼できる配信と接続ベースのセッション サポートが備わっているので、これら 2 つのバインディングが上記の制約から受ける影響はわずかです。  
+  
+ ストリーミングは、メッセージ キュー \(MSMQ\) トランスポートでは利用できないため、<xref:System.ServiceModel.NetMsmqBinding> クラスまたは <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> クラスと共に使用することはできません。  メッセージ キュー トランスポートでは、メッセージ サイズを制限したバッファー化によるデータ転送だけがサポートされています。これに対し他のトランスポートでは、ほとんどのシナリオにおいてメッセージ サイズの実質的な制限はありません。  
+  
+ ストリーミングは、ピア チャネル トランスポートを使用している場合も利用できないため、<xref:System.ServiceModel.NetPeerTcpBinding> と共に使用することはできません。  
+  
+#### ストリーミングとセッション  
+ セッション ベースのバインディングでストリーミングを呼び出すと、予期しない動作を引き起こすことがあります。  すべてのストリーミング呼び出しは単一のチャネル \(データグラム チャネル\) を通じて行われますが、このチャネルは使用されるバインディングがセッションを使用するように構成されている場合であっても、セッションをサポートしません。  セッション ベースのバインディングによって複数のクライアントが同一のサービス オブジェクトに対してストリーミング呼び出しを行う場合、このサービス オブジェクトの同時実行モードが単一に設定され、インスタンス コンテキスト モードが PerSession に設定されていると、すべての呼び出しがこのデータグラム チャネルを通過する必要があるため、同時に処理される呼び出しは 1 つに限られることになります。  そのため、1 つ以上のクライアントがタイムアウトとなる可能性があります。  サービス オブジェクトのインスタンス コンテキスト モードを呼び出しごと \(PerCall\) に設定するか、または同時実行モードを複数に設定することで、この問題を回避できます。  
+  
+> [!NOTE]
+>  この場合、利用可能になる "セッション" は 1 つしかないため、MaxConcurrentSessions は効力を失います。  
+  
+### ストリーミングの有効化  
+ ストリーミングは次の方法で有効にできます。  
+  
+-   ストリーミング モードで要求の送信および受け入れを行い、バッファー モードで応答の受け入れおよび返信を行う \(<xref:System.ServiceModel.TransferMode>\)。  
+  
+-   バッファー モードで要求の送信および受け入れを行い、ストリーミング モードで応答の受け入れおよび返信を行う \(<xref:System.ServiceModel.TransferMode>\)。  
+  
+-   両方向の要求および応答をストリーミング モードで送受信する   \(<xref:System.ServiceModel.TransferMode>\).  
+  
+ ストリーミングを無効化するには、転送モードを <xref:System.ServiceModel.TransferMode> \(すべてのバインディングでの既定の設定\) に設定します。  構成で転送モードを設定する方法を次のコードに示します。  
+  
+```  
+<system.serviceModel>  
+     …  
+    <bindings>  
+      <basicHttpBinding>  
+        <binding name="ExampleBinding" transferMode="Streaming"/>  
+      </basicHttpBinding>  
+    </bindings>  
+     …  
+<system.serviceModel>  
+```  
+  
+ コード内でバインディングをインスタンス化するときは、そのバインディングの `TransferMode` プロパティ \(またはカスタム バインディングを作成している場合は、トランスポート バインド要素\) をそれぞれ上記の値のいずれかに設定する必要があります。  
+  
+ 送信側と受信側で別々に、要求または応答あるいは両方向に対してストリーミングを有効化しても、機能には影響しません。  ただし、転送されるデータのサイズが大きくて、ストリーミングを有効化することが双方にとってのメリットになるかどうかを常に前提として判断する必要があります。  一方のエンドポイントに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実装されていないようなクロス プラットフォームの通信の場合、ストリーミングが使用できるかどうかは、そのプラットフォームのストリーミング機能に依存します。  もう 1 つのまれな例外は、クライアントまたはサービスが作業セットを最小限に抑える必要があり、使用できるバッファー サイズが制限されるような、メモリ消費重視のシナリオです。  
+  
+### 非同期ストリーミングの有効化  
+ 非同期ストリーミングを有効にするには、エンドポイントの <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior> 動作をサービス ホストに追加し、その <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior.AsynchronousSendEnabled%2A> プロパティを `true` に設定します。  送信側に実際の非同期ストリーミング機能も追加されています。  これによって、複数のクライアントにメッセージをストリーム出力するシナリオで、一部のクライアントがネットワークの混雑により読み取りが遅いか、読み取りをまったく行っていない場合に、サービスのスケーラビリティが向上します。  このようなシナリオでは、クライアントごとのサービスの個別のスレッドがブロックされないようになりました。  サービスはこれによってこれまで以上のクライアントを処理できるようになり、スケーラビリティが向上します。  
+  
+### ストリーミング転送のプログラミング モデル  
+ ストリーミングのプログラミング モデルは単純です。  ストリーム化されたデータを受信するには、<xref:System.IO.Stream> 型の入力パラメーターを 1 つ使用する操作コントラクトを指定します。  ストリーム化されたデータを返信するには、<xref:System.IO.Stream> 参照を返します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IStreamedService  
+{  
+    [OperationContract]  
+    Stream Echo(Stream data);  
+    [OperationContract]  
+    Stream RequestInfo(string query);  
+    [OperationContract(OneWay=true)]  
+    void ProvideInfo(Stream data);  
+}  
+```  
+  
+ 上記の例で操作 `Echo` は、ストリームの受信および返信を行うので、<xref:System.ServiceModel.TransferMode> が設定されたバインディングで使用する必要があります。  `RequestInfo` 操作の場合、<xref:System.IO.Stream> だけを返すので、<xref:System.ServiceModel.TransferMode> が最も適しています。  一方向操作は、<xref:System.ServiceModel.TransferMode> に最適です。  
+  
+ 次の `Echo` 操作または `ProvideInfo` 操作に 2 つ目のパラメーターを追加すると、サービス モデルはバッファー モードに戻り、ストリームの実行時シリアル化表現が使用されます。  エンドツーエンドの要求ストリーミングとの互換性があるのは、単一の入力ストリーム パラメーターを使用する操作だけです。  
+  
+ この規則は、メッセージ コントラクトにも同様に適用されます。  次の例に示すように、メッセージ コントラクトには、ストリームであるメッセージ本体メンバーを 1 つだけ指定できます。  ストリームと共に他の追加情報も転送する場合、追加情報はメッセージ ヘッダーに入れる必要があります。  メッセージ本体は、ストリーム コンテンツ専用として予約されています。  
+  
+```  
+[MessageContract]  
+public class UploadStreamMessage  
+{  
+   [MessageHeader]  
+   public string appRef;  
+   [MessageBodyMember]  
+   public Stream data;  
+}   
+```  
+  
+ ストリームがファイルの末尾 \(EOF\) に達すると、ストリーミング転送は終了し、メッセージが閉じられます。  値を返したり操作を呼び出したりするためにメッセージを送信する際には、<xref:System.IO.FileStream> を渡すことができます。すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、ストリームの読み出しが完了して EOF に達するまで、ストリームのデータをすべて獲得します。  ストリーム化されたデータを転送する際に、このような <xref:System.IO.Stream> のビルド済み派生クラスがそのデータのソースに存在しない場合は、対応するクラスを作成し、そのクラスでストリーム ソースを覆ったうえで、これを引数または戻り値として使用する必要があります。  
+  
+ メッセージを受信したとき、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は Base64 でエンコードされたメッセージ本体のコンテンツ \(MTOM が使用されていれば各 MIME パート\) についてストリームを作成します。コンテンツの読み取りが完了した時点でストリームは EOF に達します。  
+  
+ トランスポート レベルのストリーミングは、その他のメッセージ コントラクト型 \(パラメーター リスト、データ コントラクトの引数、明示的なメッセージ コントラクト\) でも使用できますが、このような型指定メッセージのシリアル化および逆シリアル化には、シリアライザーによるバッファー化が必要なので、これらの使用は適切ではありません。  
+  
+### 大規模データに関するセキュリティの考慮事項  
+ すべてのバインディングで、受信メッセージのサイズを制限して、サービス拒否攻撃を防止できます。  たとえば、<xref:System.ServiceModel.BasicHttpBinding> は、受信メッセージのサイズを制限し、メッセージの処理時にアクセスされるメモリの最大容量も制限する <xref:System.ServiceModel.BasicHttpBinding.MaxReceivedMessageSize%2A> プロパティを公開します。  この単位はバイトで設定されます。既定値は 65,536 バイトです。  
+  
+ 大きなデータのストリーミングを行うシナリオに特有のセキュリティの脅威は、受信側が、データがストリーミングされることを想定しているときに、データをバッファーさせることで、サービス拒否が誘発されることです。  たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、常にメッセージの SOAP ヘッダーをバッファーするため、攻撃者は、すべてがヘッダーで構成されている悪意のある大きなメッセージを作成して、データをバッファーさせることができます。  ストリーミングが有効になっている場合は、`MaxReceivedMessageSize` を極端に大きい値に設定できます。これは、受信側が、一度にメッセージ全体をメモリにバッファーすることを想定していないためです。  メッセージをバッファーするように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に強制している場合は、メモリのオーバーフローが発生します。  
+  
+ そのため、この場合は、受信メッセージの最大サイズを制限するだけでは不十分です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がバッファーするメモリを制限するには、`MaxBufferSize` プロパティが必要です。  ストリーミングを使用する場合は、これを安全な値に設定する \(または既定値のままにしておく\) ことが重要です。  たとえば、サービスでは、サイズが 4 GB までのファイルを受信し、それをローカル ディスクに格納する必要があるとします。  また、一度に 64 KB のデータしかバッファーできないようにメモリが制限されているとします。  その場合、`MaxReceivedMessageSize` を 4 GB、`MaxBufferSize` を 64 KB に設定します。  また、サービス実装において、64 KB ずつ受信ストリームから読み取り、前のデータがディスクに書き込まれ、メモリから破棄されるまで次のデータを読み取らないようにする必要があります。  
+  
+ このクォータは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって行われるバッファーのみを制限するものであり、独自のサービスまたはクライアント実装で行われるバッファーからは保護できないことを理解しておくことも重要です。  その他のセキュリティ上の考慮事項の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」を参照してください。  
+  
+> [!NOTE]
+>  バッファー転送とストリーミング転送のどちらを使用するかは、エンドポイントごとにローカルに決定します。  HTTP トランスポートの場合、転送モードは、接続、つまりプロキシ サーバーなどの中継局に伝達されません。  転送モードを設定しても、サービス インターフェイスの記述には反映されません。  サービスに対して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成した後、ストリーミング転送で使用する予定のサービスの構成ファイルを編集し、転送モードを設定する必要があります。  TCP トランスポートおよび名前付きパイプ トランスポートの場合、転送モードはポリシー アサーションとして伝達されます。  
+  
+## 参照  
+ [方法 : ストリーミングを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-streaming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/limiting-message-distribution.md b/docs/framework/wcf/feature-details/limiting-message-distribution.md
new file mode 100644
index 00000000000..376faedd01e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/limiting-message-distribution.md
@@ -0,0 +1,75 @@
+---
+title: "メッセージ配布の制限 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b5ec4b8-1ce9-45ef-bb90-2c840456bcc1
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# メッセージ配布の制限
+ピア チャネルは仕様上はブロードキャスト メッシュです。その基本的な大量転送モデルでは、メッシュの任意のメンバーが送信した各メッセージをそのメッシュの他のメンバー全員に配布します。これは、1 人のメンバーが生成した各メッセージが他のメンバー全員に関係していて、役立つものであるような状況 \(チャット ルームなど\) に最適です。ただし、多くのアプリケーションではメッセージの配布を制限する必要が生じることがあります。たとえば、新しいメンバーがメッシュに参加し、メッシュを経由して送信された最新のメッセージを取得しようとする場合、この要求をメッシュのメンバー全員に転送する必要はありません。要求は近くの近隣ノードに制限できます。また、ローカルで生成されたメッセージをフィルターで除外することもできます。メッセージはメッシュの個別のノードに送信することもできます。このトピックでは、ホップ数、メッセージ伝達フィルター、ローカル フィルター、または直接接続を使用し、メッシュを経由してメッセージを転送する方法について説明し、1 つの方法を選択するための一般的なガイドラインを示します。  
+  
+## ホップ数  
+ `PeerHopCount` の概念は、IP プロトコルで使用される TTL \(Time\-To\-Live\) に似ています。`PeerHopCount` の値はメッセージのインスタンスに関連付けられ、メッセージを破棄するまでの転送回数を指定します。ピア チャネル クライアントがメッセージを受信するたびに、クライアントはメッセージに `PeerHopCount` が指定されているかどうかを確認します。指定されている場合、クライアントはメッセージを近隣ノードに転送する前に、ホップ数の値を 1 つデクリメントします。クライアントがゼロのホップ数値を持つメッセージを受信した場合、そのメッセージは処理されますが、近隣ノードには転送されません。  
+  
+ ホップ数をメッセージに追加するには、メッセージ クラスの実装で、適切なプロパティまたはフィールドに `PeerHopCount` を属性として追加します。この値は、メッセージをメッシュに送信する前に特定の値に設定できます。このように、ホップ数を使用するとメッシュを経由したメッセージの配布を必要に応じて制限し、不要なメッセージの重複を避けることができます。これは、メッシュに大量の重複データが含まれている場合や、メッセージをすぐ隣の近隣ノードまたはいくつかのホップ内の近隣ノードに送信する場合に役立ちます。  
+  
+-   コード スニペットと関連情報については、[ピア チャネルのブログ](http://go.microsoft.com/fwlink/?LinkID=114531) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=114531\) を参照してください。  
+  
+## メッセージ伝達フィルター  
+ `MessagePropagationFilter` は、特にメッセージの内容や他の特定のシナリオによってメッセージを伝達するかどうかを決定する場合など、メッセージの大量転送の制御をカスタマイズするために使用できます。このフィルターにより、ノードを通過する各メッセージを伝達するかどうかが決定されます。これは、メッシュ内の他の場所から送信され、使用しているノードで受信したメッセージと、使用しているアプリケーションで作成したメッセージの両方に適用されます。フィルターはメッセージとその発信元の両方にアクセスできるため、利用できるすべての情報に基づいてメッセージを転送するか、破棄するかを決定します。  
+  
+ <xref:System.ServiceModel.PeerMessagePropagationFilter> は、単一の関数 <xref:System.ServiceModel.PeerMessagePropagationFilter.ShouldMessagePropagate%2A> を持つ抽象基本クラスです。メソッド呼び出しの最初の引数には、メッセージの完全なコピーを渡します。このメッセージに対して行われた変更が実際のメッセージに影響することはありません。このメソッド呼び出しの最後の引数は、メッセージの送信元 \(`PeerMessageOrigination.Local` または `PeerMessageOrigination.Remote`\) を識別します。このメソッドの具体的な実装は、メッセージの転送先 \(ローカル アプリケーション \(`Local`\)、リモート クライアント \(`Remote`\)、ローカル アプリケーションとリモート クライアントの両方 \(`LocalAndRemote`\)、どちらにも転送しない \(`None`\)\) を示す <xref:System.ServiceModel.PeerMessagePropagation> 列挙体から定数を返す必要があります。このフィルターは、対応する `PeerNode` オブジェクトにアクセスし、`PeerNode.MessagePropagationFilter` プロパティで伝達フィルター派生クラスのインスタンスを指定することによって適用できます。ピア チャネルを開く前に、伝達フィルターがアタッチされていることを確認してください。  
+  
+-   コード スニペットと関連情報については、[ピア チャネルのブログ](http://go.microsoft.com/fwlink/?LinkID=114532) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=114532\) を参照してください。  
+  
+## メッシュ内の個別ノードへのアクセス  
+ メッシュ内の個別のノードには、ローカル フィルターを設定するか、直接接続を設定することでアクセスできます。  
+  
+ メッシュ内の各ノードに個別の ID が割り当てられている場合は、メッセージの実装に宛先 ID を指定できます。ローカル フィルターを設定するには、指定した宛先 ID にノードの ID が一致する場合にのみメッセージを現在のノードに表示する関数をメッセージ コントラクト内に作成します。メッセージはメッシュが転送するため、新しい接続を設定するオーバーヘッドが発生しません。ただし、メッセージはメッシュを経由して何度も送信されるため、効率が低下します。この方法は、メッセージのサイズが大きくなく、メッセージを頻繁に送信しない限り、メッシュの個別のメンバーにメッセージを送信する場合に適しています。  
+  
+ 帯域幅の広い長時間の接続には、直接接続が適しています。接続情報はメッシュを経由して送信でき、その後、メッセージを送受信するために選択した直接接続を設定できます。  
+  
+## メッセージ配布の制限方法の選択  
+ メッセージの配布を制限する必要があるシナリオに遭遇した場合は、次の点を検討してください。  
+  
+-   **誰**がメッセージを受信する必要があるか。1 つの近隣ノードのみか。メッシュ内の別の場所にあるノードか。メッシュ内の半分のノードか。  
+  
+-   **どのような頻度**でこのメッセージを送信する必要があるか。  
+  
+-   どのような**帯域幅**をこのメッセージは使用するか。  
+  
+ これらの質問の回答は、ホップ数、メッセージ伝達フィルター、ローカル フィルター、直接接続のいずれを使用するかを決定するのに役立ちます。次の一般的なガイドラインを考慮してください。  
+  
+-   **誰**  
+  
+    -   個別のノード : ローカル フィルターまたは直接接続  
+  
+    -   特定の領域内の近隣ノード : PeerHopCount  
+  
+    -   メッシュの複雑なサブセット : MessagePropagationFilter  
+  
+-   **頻度**  
+  
+    -   頻繁 : 直接接続、PeerHopCount、MessagePropagationFilter  
+  
+    -   時折 : ローカル フィルター  
+  
+-   **帯域幅の使用**  
+  
+    -   広い : 直接接続。MessagePropagationFilter またはローカル フィルターの使用は奨励できない  
+  
+    -   狭い : 任意。直接接続は通常は不要  
+  
+## 参照  
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md b/docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md
new file mode 100644
index 00000000000..82c7a866682
--- /dev/null
+++ b/docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md
@@ -0,0 +1,188 @@
+---
+title: "ID モデルを使用したクレームと承認の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "承認 [WCF]"
+  - "承認 [WCF], ID モデルを使用した管理"
+  - "クレーム [WCF]"
+  - "クレーム [WCF], ID モデルを使用した管理"
+  - "WCF セキュリティ"
+ms.assetid: 099defbb-5d35-434e-9336-1a49b9ec7663
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# ID モデルを使用したクレームと承認の管理
+承認は、コンピューター リソースを変更または表示したり、コンピューター リソースにアクセスしたりする権限を持つエンティティを特定するプロセスです。たとえば、ある業務で、管理者だけが従業員のファイルへのアクセスを許可される場合があります。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、承認処理を実行するための 2 つの機構をサポートしています。1 つ目の機構では、既存の共通言語ランタイム \(CLR: Common Language Runtime\) 構造を使用して承認を制御できます。もう 1 つはクレームに基づくモデルで、*"ID モデル"* と呼ばれます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ID モデルを使用して受信メッセージからクレームを作成します。ID モデル クラスを拡張することで、カスタム承認方式に対応する新しいクレームの種類をサポートできます。このトピックでは、ID モデル機能のプログラミングの主要概念について概説し、この機能で使用する最も重要なクラスの一覧を示します。  
+  
+## ID モデルのシナリオ  
+ ID モデルの使用例を以下のシナリオに示します。  
+  
+### シナリオ 1 : ID、ロール、およびグループの各クレームをサポートする場合  
+ 複数のユーザーが Web サービスにメッセージを送信します。この Web サービスのアクセス制御要件では、ID、ロール、またはグループを使用します。メッセージ送信者は、一連のロールまたはグループに割り当てられます。ロールまたはグループの情報は、アクセス チェックを実行する際に使用されます。  
+  
+### シナリオ 2 : 多様なクレームをサポートする場合  
+ 複数のユーザーが Web サービスにメッセージを送信します。この Web サービスのアクセス制御要件では、ID、ロール、またはグループよりも多様なモデルを必要とします。Web サービスは、クレームに基づく多様なモデルを使用して、指定のユーザーが保護された特定のリソースにアクセスできるかどうかを判断します。たとえば、あるユーザーは、他のユーザーがアクセスできない給与情報などの特定の情報を読み取ることができます。  
+  
+### シナリオ 3 : さまざまなクレームを割り当てる場合  
+ ユーザーが Web サービスにメッセージを送信します。ユーザーは、X.509 証明書、ユーザー名トークン、または Kerberos トークンを使用して資格情報を指定できます。Web サービスは、ユーザーの資格情報の種類を問わず、アクセス制御チェックを同様に実行する必要があります。時間の経過に伴って、サポート対象となる資格情報の種類が追加された場合、それに応じてシステムを拡張する必要があります。  
+  
+### シナリオ 4 : 複数のリソースへのアクセスを特定する場合  
+ ある Web サービスでは、複数のリソースへのアクセスを試みます。このサービスは、指定のユーザーに関連付けられたクレームと、保護されたリソースにアクセスするために必要なクレームを比較することによって、そのユーザーがアクセスできるリソースを特定します。  
+  
+## ID モデルの用語  
+ ID モデルの概念の説明に使用される重要な用語の定義を以下に示します。  
+  
+ 承認ポリシー  
+ 入力クレーム セットを出力クレーム セットに割り当てる一連のルール。承認ポリシーを評価すると、クレーム セットが評価コンテキストに追加され、次に承認コンテキストに追加されます。  
+  
+ 承認コンテキスト  
+ 一連のクレーム セットと 0 個以上のプロパティ。1 つ以上の承認ポリシーの評価結果です。  
+  
+ クレーム  
+ クレームの種類、権限、および値の組み合わせ。  
+  
+ クレーム セット  
+ 特定の発行者によって発行された一連のクレーム。  
+  
+ クレームの種類  
+ クレームの種類。ID モデル API によって定義されたクレームは、<xref:System.IdentityModel.Claims.Claim.ClaimType%2A> クラスのプロパティです。システムが提供するクレームの種類には、<xref:System.IdentityModel.Claims.ClaimTypes.Dns%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Email%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Hash%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Name%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Rsa%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Sid%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Spn%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.System%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Thumbprint%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.Uri%2A>、<xref:System.IdentityModel.Claims.ClaimTypes.X500DistinguishedName%2A> などがあります。  
+  
+ 評価コンテキスト  
+ 承認ポリシーが評価されるコンテキスト。プロパティとクレーム セットが含まれます。評価が完了すると、評価コンテキストは承認コンテキストの基礎となります。  
+  
+ ID クレーム  
+ 権限が ID であるクレーム。  
+  
+ 発行者  
+ 1 つ以上の ID クレームを含み、別のクレーム セットを発行したと見なされているクレーム セット。  
+  
+ プロパティ  
+ 評価コンテキストまたは承認コンテキストに関連付けられた一連の情報。  
+  
+ 保護されたリソース  
+ システム内に存在するものの中で、まず特定の要件が満たされた場合にのみ、使用、アクセス、または操作が可能になるもの。  
+  
+ 権限  
+ リソースに対する使用能力。ID モデル API によって定義された権限は、<xref:System.IdentityModel.Claims.Rights> クラスのプロパティです。システムが提供する権限には、<xref:System.IdentityModel.Claims.Rights.Identity%2A> や <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A> などがあります。  
+  
+ 値  
+ 権限がクレームされる対象。  
+  
+## クレーム  
+ ID モデルはクレームに基づくシステムです。クレームは、システム内の何らかのエンティティ \(多くの場合システムのユーザー\) に関連する機能について記述します。指定のエンティティに関連するクレームのセットをキーと考えることができます。個別のクレームによりキーの形状が定義されます。このしくみは、ドアを開けるための物理的なキーと似ています。クレームは、リソースへのアクセスを取得するために使用されます。保護された指定のリソースへのアクセスの可否は、そのリソースにアクセスするために必要なクレームと、アクセスを試みるエンティティに関連付けられたクレームを比較することにより特定されます。  
+  
+ クレームは、特定の値に関連付けられる権限の表現です。権限には、"読み取り"、"書き込み"、"実行" などがあります。値には、データベース、ファイル、メールボックス、またはプロパティが使用できます。クレームはまた、特定のクレームの種類に属します。クレームの種類と権限の組み合わせにより、値に関する機能を指定するための機構が得られます。たとえば、値 "Biography.doc" に対して権限 "読み取り" を持つ種類 "File" のクレームは、そのようなクレームに関連するエンティティが Biography.doc ファイルに対して読み取りアクセスを持つことを示します。また、値 "Martin" に対して権限 "PossessProperty" を持つ種類 "Name" のクレームは、そのようなクレームに関連するエンティティが値 "Martin" を持つ "Name" プロパティを所有することを示します。  
+  
+ さまざまなクレームの種類と権限が ID モデルの一部として定義されています。ただし、システムは拡張できるため、ID モデル インフラストラクチャ上に構築するさまざまなシステムで、必要に応じて他のクレームの種類や権限を定義できます。  
+  
+### ID クレーム  
+ 特殊な権限の 1 つとして、ID の権限があります。この権限を持つクレームは、エンティティの ID を示します。たとえば、種類がユーザー プリンシパル名 \(UPN: User Principal Name\)、値が "someone@example.com"、権限が ID であるクレームは、特定のドメインの特定の ID を示します。  
+  
+#### System ID クレーム  
+ ID モデルでは、System という ID クレームが定義されています。System ID クレームは、エンティティが現在のアプリケーションまたはシステムであることを示します。  
+  
+### クレーム セット  
+ クレームは、システム内の何らかのエンティティによって常に発行されるため、ID を表すクレームのモデルは重要です。エンティティが最終的には何らかの "自己" の概念である場合でも、クレームは発行されます。クレームは 1 つのセットとしてグループ化され、各セットは発行者を持ちます。発行者は、1 つのクレーム セットにすぎません。このような再帰的な関係は最終的に終了する必要があるため、どのクレーム セットもそれ自体の発行者になることができます。  
+  
+ 次の図は、3 つのクレーム セットの一例を示しています。この例では、1 つ目のクレーム セットの発行者は 2 つ目のクレーム セットであり、さらにこの 2 つ目のクレーム セットの発行者は System クレーム セットです。このように、クレーム セットは任意の深さの階層を形成します。  
+  
+ ![クレームと承認の管理](../../../../docs/framework/wcf/feature-details/media/claimshierarchy.gif "claimshierarchy")  
+  
+ 次の図に示すように、複数のクレーム セットが同じクレーム セットから発行されている場合もあります。  
+  
+ ![クレームと承認の管理](../../../../docs/framework/wcf/feature-details/media/multiplesetsofclaims.gif "multiplesetsofclaims")  
+  
+ クレーム セットがそれ自体の発行者である場合を除き、ID モデルではクレーム セットによるループの形成を一切サポートしていません。したがって、クレーム セット A がクレーム セット B によって発行された場合に、クレーム セット B 自体がクレーム セット A によって発行されたという状況はありえません。また、ID モデルでは、クレーム セットが複数の発行者を持つことはできません。ある特定のクレーム セットを複数の発行者が発行する必要がある場合は、同じクレームを含み、発行者がそれぞれ異なる複数のクレーム セットを使用する必要があります。  
+  
+### クレームの発生元  
+ クレームは、さまざまな発生元から発生する可能性があります。たとえば、Web サービスに送信されるメッセージの一部としてユーザーから提示される資格情報は、クレームの一般的な発生元の 1 つです。このようなクレームはシステムによって検証され、そのユーザーに関連付けられたクレーム セットの一部になります。システムの他のコンポーネント \(オペレーティング システム、ネットワーク スタック、ランタイム環境、アプリケーションなど\) もクレームの発生元になることがあります。また、リモート サービスが発生元になる場合もあります。  
+  
+### 承認ポリシー  
+ ID モデルでは、承認ポリシーの評価プロセスの一環としてクレームが生成されます。承認ポリシーは、既存のクレーム セット \(空の場合もあります\) を調べます。そして、既に存在するクレームやクレームが破棄された時点の追加情報に基づいて、別のクレームを追加する場合があります。これは、クレーム間のマッピングの基盤となります。システム内でのクレームの有無は、別のクレームを追加するかどうかという承認ポリシーの動作に影響します。  
+  
+ たとえば、システムを使用するさまざまなエンティティの誕生日が含まれたデータベースにアクセスできる承認ポリシーがあるとします。承認ポリシーは、この情報を使用して "Over18" というクレームをコンテキストに追加します。この Over18 クレームは、エンティティが 18 歳以上であるということ以外に、エンティティに関する情報を公開しません。"Over18" クレームの解釈は、このクレームのセマンティクスの認識によって異なります。クレームを追加した承認ポリシーは、何らかのレベルでこれらのセマンティクスを認識しています。ポリシー評価の結果として生成されたクレームを調べるコードにも、これらのセマンティクスが通知されます。  
+  
+ 特定の承認ポリシーを複数回評価することが必要になる場合があります。これは、他の承認ポリシーがクレームを追加したときに、該当の承認ポリシーがさらにクレームを追加する可能性があるためです。ID モデルは、適用されているすべての承認ポリシーがクレームをコンテキストに追加しなくなるまで、評価を続行するように設計されています。このように、承認ポリシーの評価を続行することにより、承認ポリシーに関して一定の評価順序を適用する必要性がなくなります。つまり、承認ポリシーを任意の順序で評価できます。たとえば、ポリシー A がクレーム B を追加した場合にのみ、ポリシー X がクレーム Z を追加するとします。この場合、X が先に評価されると、その時点ではクレーム Z は追加されません。その後、A が評価され、クレーム B が追加されます。次に、X の 2 回目の評価が行われ、この時点でクレーム Z が追加されます。  
+  
+ システムによっては多数の承認ポリシーが適用されている場合があります。  
+  
+### キーを作成するマシン  
+ 関連する承認ポリシーのグループを評価することは、キーを作成する機械を使用することに似ています。承認ポリシーがそれぞれ評価され、クレーム セットが生成されて、キーの形状が確立されていきます。キーの形状が完成すると、このキーを使用していくつかのロックを開いてみることができます。キーの形状は、承認マネージャーによって作成される "承認コンテキスト" に格納されます。  
+  
+### 承認コンテキスト  
+ 既に説明したように、承認マネージャーはさまざまな承認ポリシーを評価します。この評価の結果が承認コンテキスト \(一連のクレーム セットと関連する複数のプロパティ\) です。承認コンテキストを調べて、そのコンテキスト内に存在するクレームや、それらのさまざまなクレーム間の関係 \(発行側クレーム セットなど\) を確認し、最終的にリソースにアクセスするために満たす必要のある要件と比較できます。  
+  
+### ロック  
+ 承認コンテキスト \(クレーム セット\) がキーであるとすれば、保護された特定のリソースへのアクセスを許可するために満たす必要のある要件は、このキーが適合する必要のあるロックに相当します。ID モデルでは、このような要件を表現する方法は形式化されていませんが、クレームに基づくというシステムの特性により、これらの要件には、承認コンテキスト内のクレームと一部の必須のクレーム セットの比較が必ず含まれることになります。  
+  
+### まとめ  
+ ID モデルは、クレームの概念に基づいています。クレームはセットにグループ化され、承認コンテキストに集約されます。承認コンテキストは、承認マネージャーに関連付けられた 1 つ以上の承認ポリシーの評価結果であり、クレーム セットを含んでいます。これらのクレーム セットを調べて、アクセス要件が満たされているかどうか確認できます。ID モデルのさまざまな概念の関係を次の図に示します。  
+  
+ ![クレームと承認の管理](../../../../docs/framework/wcf/feature-details/media/xsi-recap.gif "xsi\_recap")  
+  
+## WCF と ID モデル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、承認を実行するための基盤として ID モデル インフラストラクチャを使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> クラスを使用することにより、*承認*ポリシーをサービスの一部として指定できます。このような承認ポリシーは、*"外部承認ポリシー"* と呼ばれ、ローカル ポリシーに基づいてクレーム処理を実行できます。また、リモート サービスとのやり取りによってクレーム処理を実行することもできます。<xref:System.ServiceModel.ServiceAuthorizationManager> クラスによって表される承認マネージャーは、さまざまな種類の資格情報 \(トークン\) を認識する承認ポリシーと共に外部承認ポリシーを評価し、受信メッセージに適したクレームを使用して *"承認コンテキスト"* を作成します。承認コンテキストは、<xref:System.IdentityModel.Policy.AuthorizationContext> クラスによって表されます。  
+  
+## ID モデルのプログラミング  
+ ID モデル拡張のプログラミングに使用するオブジェクト モデルを次の表に示します。これらのクラスはすべて、<xref:System.IdentityModel.Policy> 名前空間または <xref:System.IdentityModel.Claims> 名前空間にあります。  
+  
+|クラス|説明|  
+|---------|--------|  
+|Authorization Component|<xref:System.IdentityModel.Policy.IAuthorizationComponent> インターフェイスを実装する ID モデル クラス。|  
+|<xref:System.IdentityModel.Policy.IAuthorizationComponent>|単一の読み取り専用文字列プロパティ \(Id\) を提供するインターフェイス。このプロパティの値は、システム内でこのインターフェイスを実装するインスタンスごとに一意です。|  
+|<xref:System.IdentityModel.Policy.AuthorizationContext>|0 個以上のプロパティを持つ一連の `ClaimSet` インスタンスを格納する*承認コンポーネント*。1 つ以上の承認ポリシーの評価結果です。|  
+|<xref:System.IdentityModel.Claims.Claim>|クレームの種類、権限、および値の組み合わせ。権限と値の部分は、クレームの種類によって制約されます。|  
+|<xref:System.IdentityModel.Claims.ClaimSet>|抽象ベース クラス。`Claim` のインスタンスのコレクション。|  
+|<xref:System.IdentityModel.Claims.DefaultClaimSet>|シール クラス。`ClaimSet` クラスの実装。|  
+|<xref:System.IdentityModel.Policy.EvaluationContext>|抽象基本クラス。ポリシーの評価時に承認ポリシーに渡されます。|  
+|<xref:System.IdentityModel.Policy.IAuthorizationPolicy>|`IAuthorizationComponent` から派生し、承認ポリシーのクラスによって実装されるインターフェイス。|  
+|<xref:System.IdentityModel.Claims.Rights>|定義済みの権限値が格納された静的クラス。|  
+  
+ 以下のクラスも ID モデルのプログラミングに使用しますが、<xref:System.IdentityModel.Policy> 名前空間または <xref:System.IdentityModel.Claims> 名前空間には含まれません。  
+  
+|クラス|説明|  
+|---------|--------|  
+|<xref:System.ServiceModel.ServiceAuthorizationManager>|サービスでの操作ごとにクレームに基づく承認チェックを実行するメソッド \(<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A>\) を提供するクラス。このクラスから派生し、メソッドをオーバーライドする必要があります。|  
+|<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>|承認に関係するサービスの動作に関連するさまざまなプロパティを提供するシール クラス。|  
+|<xref:System.ServiceModel.ServiceSecurityContext>|現在実行中 \(または実行直前\) の操作のセキュリティ コンテキスト \(承認コンテキストなど\) を提供するクラス。このクラスのインスタンスは、<xref:System.ServiceModel.OperationContext> に含まれます。|  
+  
+### 重要なメンバー  
+ 次のメンバーは、新しいクレームの種類を作成する際に一般的に使用されます。  
+  
+|メンバー|説明|  
+|----------|--------|  
+|<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A>|派生クラスは、このメソッドを実装して、サービスで操作を実行する前にクレームに基づくアクセス チェックを実行します。アクセス チェックの決定を行うときに、指定された <xref:System.ServiceModel.OperationContext>、または他の場所にあるすべての情報を確認できます。<xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> が `true` を返した場合は、アクセスが許可され、操作を実行できるようになります。`CheckAccessCore` が `false` を返した場合は、アクセスが拒否され、操作は実行されません。例については、「[方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)」を参照してください。|  
+|<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ServiceAuthorizationManager%2A>|サービスの <xref:System.ServiceModel.ServiceAuthorizationManager> を返します。承認決定は、<xref:System.ServiceModel.ServiceAuthorizationManager> が行います。|  
+|<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.ExternalAuthorizationPolicies%2A>|サービスに指定されたカスタム承認ポリシーのコレクション。受信メッセージの資格情報に関連するポリシーに加え、これらのポリシーも評価されます。|  
+  
+## 参照  
+ <xref:System.IdentityModel.Policy.AuthorizationContext>   
+ <xref:System.IdentityModel.Claims.Claim>   
+ <xref:System.IdentityModel.Policy.EvaluationContext>   
+ <xref:System.IdentityModel.Policy.IAuthorizationComponent>   
+ <xref:System.IdentityModel.Policy.IAuthorizationPolicy>   
+ <xref:System.IdentityModel.Claims.Rights>   
+ <xref:System.IdentityModel.Claims>   
+ <xref:System.IdentityModel.Policy>   
+ <xref:System.IdentityModel.Tokens>   
+ <xref:System.IdentityModel.Selectors>   
+ [クレームとトークン](../../../../docs/framework/wcf/feature-details/claims-and-tokens.md)   
+ [リソースへのアクセスのクレームと拒否](../../../../docs/framework/wcf/feature-details/claims-and-denying-access-to-resources.md)   
+ [クレームの作成とリソース値](../../../../docs/framework/wcf/feature-details/claim-creation-and-resource-values.md)   
+ [方法 : カスタム クレームを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-claim.md)   
+ [方法 : クレームを比較する](../../../../docs/framework/wcf/extending/how-to-compare-claims.md)   
+ [方法 : カスタム承認ポリシーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-policy.md)   
+ [方法 : サービスで使用するカスタム承認マネージャーを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-authorization-manager-for-a-service.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/mapping-between-json-and-xml.md b/docs/framework/wcf/feature-details/mapping-between-json-and-xml.md
new file mode 100644
index 00000000000..9a6960e08b5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/mapping-between-json-and-xml.md
@@ -0,0 +1,243 @@
+---
+title: "JSON と XML 間のマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22ee1f52-c708-4024-bbf0-572e0dae64af
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# JSON と XML 間のマッピング
+リーダーとライターによって生成される、 <xref:System.Runtime.Serialization.Json.JsonReaderWriterFactory> JavaScript Object Notation (JSON) コンテンツを XML API を提供します。 JSON は、JavaScript のオブジェクト リテラルのサブセットを使用してデータをエンコードします。 リーダーとライターはこのファクトリによって生成される、ときにも使用 JSON コンテンツの送信または受信[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]を使用してアプリケーション、 <xref:System.ServiceModel.Channels.WebMessageEncodingBindingElement>または<xref:System.ServiceModel.WebHttpBinding>します。  
+  
+ JSON リーダーは JSON コンテンツで初期化されると、XML インスタンスで動作するテキストの XML リーダーと同じ方法で動作します。 テキストの XML リーダーでの一連の呼び出しによって特定の XML インスタンスが生成されると、JSON ライターは JSON コンテンツを書き出します。 このトピックでは、高度なシナリオで使用するために、この XML のインスタンスと JSON コンテンツ間のマッピングについて説明します。  
+  
+ 内部的には、JSON は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって処理される際に XML 情報セットとして表されます。 マッピングは論理上の処理であるため、通常はこのような内部表現を考慮する必要はありません。JSON は通常、メモリで物理的に XML に変換されたり、XML から JSON に変換されたりすることはありません。 マッピングとは、XML API を使用して JSON コンテンツにアクセスすることを意味します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]は、通常のシナリオである JSON を使用、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>によって自動的にプラグインは、 <xref:System.ServiceModel.Description.WebScriptEnablingBehavior>動作、または、 <xref:System.ServiceModel.Description.WebHttpBehavior>該当する場合。 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> JSON と XML 情報セット間のマッピングを認識し、直接 JSON を処理してかのように動作します。 (使用可能であれば、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>任意の XML リーダーまたはライターが XML を次のマッピングに従うという了解の下にします)。  
+  
+ 高度なシナリオでは、次のマッピングへの直接アクセスが必要になることがあります。 およびに頼ることがなく、独自の方法で JSON を逆シリアル化する場合に、これらのシナリオが発生する、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>を処理する場合や、<xref:System.ServiceModel.Channels.Message>JSON を含むメッセージの直接の型。 JSON と XML 間のマッピングは、メッセージ ログにも使用されます。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ ログ機能を使用する場合、次のセクションで説明するマッピングに従って、JSON メッセージが XML としてログに記録されます。  
+  
+ マッピングの概念を明確にするために、次に JSON ドキュメントの例を示します。  
+  
+```  
+{"product":"pencil","price":12}  
+```  
+  
+ 前述のリーダーのいずれかを使用してこの JSON ドキュメントを読み取るには、使用の同じシーケンス<xref:System.Xml.XmlDictionaryReader>を次の XML ドキュメントを読み取るを呼び出します。  
+  
+```  
+<root type="object">  
+    <product type="string">pencil</product>  
+    <price type="number">12</price>  
+</root>  
+```  
+  
+ また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってこの例の JSON メッセージが取得されてログに記録される場合は、先行ログの XML フラグメントを参照します。  
+  
+## <a name="mapping-between-json-and-the-xml-infoset"></a>JSON と XML 情報セット間のマッピング  
+ 正式には、マッピングは JSON の間で説明した[RFC 4627](http://go.microsoft.com/fwlink/?LinkId=98808) (を除く厳密でない、および一部の特定の制限を追加するその他の制限) XML 情報セット (といないテキスト形式の XML) として「 [XML Information Set](http://go.microsoft.com/fwlink/?LinkId=98809)します。 定義については、このトピックを参照してください*情報項目*と角かっこ [] でのフィールドです。  
+  
+ 空白の JSON ドキュメントは空白の XML ドキュメントにマップされ、空白の XML ドキュメントは空白の JSON ドキュメントにマップされます。 XML から JSON へのマッピングで、先行する空白およびドキュメント後続の空白は許可されません。  
+  
+ マッピングは、ドキュメント情報項目 (DII: Document Information Item) または要素情報項目 (EII: Element Information Item) のいずれか一方と JSON の間に定義されます。 EII、または DII の [document element] プロパティは、Root JSON Element と呼ばれます。 また、ドキュメント フラグメント (ルート要素を複数持つ XML) は、このマッピングではサポートされません。  
+  
+ 例 : 次のドキュメントがあるとします。  
+  
+ `<?xml version="1.0"?>`  
+  
+ `<root type="number">42</root>`  
+  
+ また、次の要素があるとします。  
+  
+ `<root type="number">42</root>`  
+  
+ どちらにも JSON へのマッピングが存在します。 `root`> 要素は、どちらの場合も、Root JSON Element です。  
+  
+ また、DII の場合は次の点を考慮する必要があります。  
+  
+-   [children] 一覧には、除外する必要のある項目が含まれています。 JSON からマッピングされた XML を読み取るときは、この事実に依存しないでください。  
+  
+-   [children] 一覧には、注釈情報項目が保持されません。  
+  
+-   [children] 一覧には、DTD 情報項目が保持されません。  
+  
+-   [children] 一覧には、個人情報 (PI: Personal Information) 情報項目が保持されません (\<?xml…> 宣言は PI 情報項目と見なされません)。  
+  
+-   [notations] セットは空です。  
+  
+-   [unparsed entities] セットは空です。  
+  
+ 例 : 次のドキュメントでは [children] が PI とコメントを保持するため、JSON へのマッピングが存在しません。  
+  
+ `<?xml version="1.0"?>`  
+  
+ `<!--comment--><?pi?>`  
+  
+ `<root type="number">42</root>`  
+  
+ Root JSON Element としての EII には次の特性があります。  
+  
+-   [local name] は値 "root" を持ちます。  
+  
+-   [namespace name] は値を持ちません。  
+  
+-   [prefix] は値を持ちません。  
+  
+-   [children] には、後述するように内部要素である EII、または文字情報項目 (CII: Character Information Item) のいずれか一方が含まれる場合と、どちらも含まれない場合がありますが、両方とも含まれることはありません。  
+  
+-   [attributes] には、次のオプションの属性情報項目 (AII: Attribute Information Item) が含まれる場合があります。  
+  
+-   後述の JSON Type Attribute ("type")。 この属性は、マップされた XML で JSON 型 (文字列、数値、ブール値、オブジェクト、配列、または null) を保持するのに使用します。  
+  
+-   後述の Data Contract Name Attribute ("__type")。 この属性は、JSON Type Attribute が存在し、その [normalized value] が "object" であるときにのみ存在します。 この属性は、派生型がシリアル化されたり、基本型が要求されたりするポリモーフィックな場合などに、`DataContractJsonSerializer` によりデータ コントラクトの型情報を保持するために使用されます。 `DataContractJsonSerializer` を使用していなければ、この属性はほとんどの場合に無視されます。  
+  
+-   XML 情報セットの仕様に規定されるように、[in-scope namespaces] には、"xml" から "http://www.w3.org/XML/1998/namespace" へのバインディングが含まれます。  
+  
+-   [children]、[attributes]、および[in-scope namespaces] は、あらかじめ指定した項目以外の項目を持つことができず、[namespace attributes] はメンバーを持つことができませんが、JSON からマップされた XML を読み取るときには、この事実に依存しないでください。  
+  
+ 例 : 次のドキュメントでは [namespace attributes] が空ではないため、JSON へのマッピングが存在しません。  
+  
+ `<?xml version="1.0"?>`  
+  
+ `<root  xmlns:a="myattributevalue">42</root>`  
+  
+ JSON Type Attribute としての AII には次の特性があります。  
+  
+-   [namespace name] は値を持ちません。  
+  
+-   [prefix] は値を持ちません。  
+  
+-   [local name] は "type" です。  
+  
+-   [normalized value] は、次のセクションで説明する型の値のいずれかになります。  
+  
+-   [specified] は `true` です。  
+  
+-   [attribute type] は値を持ちません。  
+  
+-   [references] は値を持ちません。  
+  
+ Data Contract Name Attribute としての AII には次の特性があります。  
+  
+-   [namespace name] は値を持ちません。  
+  
+-   [prefix] は値を持ちません。  
+  
+-   [local name] は "__type" (2 連続のアンダースコアの直後に "type") です。  
+  
+-   [normalized value] は、任意の有効な Unicode 文字列です。この文字列から JSON へのマッピングは、次のセクションで説明します。  
+  
+-   [specified] は `true` です。  
+  
+-   [attribute type] は値を持ちません。  
+  
+-   [references] は値を持ちません。  
+  
+ Root JSON Element に含まれる内部要素、またはその他の内部要素には、次の特性があります。  
+  
+-   後述するように、[local name] は任意の値を持つことができます。  
+  
+-   [namespace name]、[prefix]、[children]、[attributes]、[namespace attributes]、および [in-scope namespaces] は、Root JSON Element と同じ規則に従います。  
+  
+ Root JSON Element および内部要素では、JSON Type Attribute により JSON へのマッピングと、[children] およびその解釈が定義されます。 この属性の [normalized value] では大文字と小文字が区別され、小文字を使用する必要があります。また、ここに空白を含めることはできません。  
+  
+|`JSON Type Attribute` としての AII の [normalized value]|対応する EII の許可された [children]|JSON へのマッピング|  
+|---------------------------------------------------------|---------------------------------------------------|---------------------|  
+|`string` (または JSON 型 AII なし)<br /><br /> `string` および JSON 型 AII なしは同じです。`string` を既定値にします。<br /><br /> その結果、`<root> string1</root>` が JSON `string` "string1" にマップされます。|0 または複数個の Cii|JSON `string` (JSON RFC section 2.5)。 `char` はそれぞれ、CII の [character code] に対応する文字です。 CII が存在しない場合は、空の JSON `string` にマップされます。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> `<root type="string">42</root>`<br /><br /> JSON フラグメントは "42" です。<br /><br /> XML から JSON へのマッピングでは、エスケープする必要がある文字はエスケープ文字にマップされ、その他はすべて、エスケープされない文字にマップされます。 スラッシュ (/) 文字は特殊 – はエスケープする必要はありませんが (として書き出さ"\\/") です。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> `<root type="string">the "da/ta"</root>`<br /><br /> JSON フラグメントは"、 \\"da\\/ta\\""です。<br /><br /> JSON から XML へのマッピングでは、エスケープ文字およびエスケープされない文字が、対応する [character code] に正しくマップされます。<br /><br /> 例 : JSON フラグメント "\u0041BC" が次の XML 要素にマップされます。<br /><br /> `<root type="string">ABC</root>`<br /><br /> 文字列は、XML にマップされない空白 (JSON RFC section 2 の 'ws') で囲むことができます。<br /><br /> 例 : JSON フラグメント           "ABC" (最初の二重引用符の前に空白があります) が次の XML 要素にマップされます。<br /><br /> `<root type="string">ABC</root>`<br /><br /> XML の空白が、JSON の空白にマップされます。<br /><br /> 例 : 次の XML 要素は JSON フラグメントにマップされます。<br /><br /> `<root type="string">  A BC      </root>`<br /><br /> JSON フラグメントは " A BC " です。|  
+|`number`|1 個以上の CII|JSON `number` (JSON RFC section 2.4)。空白で囲まれている場合があります。 数値と空白の組み合わせに含まれる文字はそれぞれ、CII の [character code] に対応する文字です。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> `<root type="number">    42</root>`<br /><br /> JSON フラグメントは    42 です <br /><br /> (空白が保持されます)。|  
+|`boolean`|4 個または 5 個の CII (`true` または `false` に対応)。追加の空白の CII で囲まれている場合があります。|文字列 "true" に対応する CII シーケンスは、リテラルの `true` にマップされ、文字列 "false" に対応する CII シーケンスは、リテラルの `false` にマップされます。 囲んでいる空白は保持されます。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> `<root type="boolean"> false</root>`<br /><br /> JSON フラグメントは `false` です。|  
+|`null`|いずれも許可されません。|リテラルの `null`。 JSON から XML へのマッピングでは、`null` は、XML にマップされない空白 (section 2 の 'ws') で囲まれる場合があります。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> `<root type="null"/>`<br /><br /> または<br /><br /> `<root type="null"></root>`<br /><br /> :<br /><br /> いずれの場合も、JSON フラグメントは `Null` です。|  
+|`object`|0 個以上の EII|JSON RFC section 2.2 にあるように、`begin-object` (左中かっこ) の直後に、後述するように各 EII のメンバー レコードが続きます。 EII が複数個存在する場合、メンバー レコードの間に値区切り記号 (コンマ) が配置されます。 最後尾には、end-object (右中かっこ) が置かれます。<br /><br /> 例 : 次の要素は JSON フラグメントにマップされます。<br /><br /> <root type="object"></root>\><br /><br /> <type1 type="string"></type1>\>aaa\><br /><br /> <type2 type="string"></type2>\>bbb\><br /><br /> \><br /><br /> JSON フラグメントは {"type1":"aaa","type2":"bbb"} です。<br /><br /> XML から JSON へのマッピングに Data Contract Type Attribute が存在する場合は、最初に追加のメンバー レコードが挿入されます。 その名前は Data Contract Type Attribute ("__type") の [local name] であり、その値はこの属性の [normalized value] です。 JSON から XML へのマッピングで、最初のメンバー レコードの名前は Data Contract Type Attribute の [local name] に逆に、(つまり、"\_ください (_t)")、対応する Data Contract Type Attribute がマップされた XML であるが、対応する EII は存在しません。 また、このような特定のマッピングが適用されるには、このメンバー レコードが最初に JSON オブジェクトに存在している必要があります。 これは、メンバー レコードの順序が重要ではない通常の JSON 処理とは異なっています。<br /><br /> 例:<br /><br /> 次の JSON フラグメントは XML にマップされます。<br /><br /> `{"__type":"Person","name":"John"}`<br /><br /> XML は次のコードです。<br /><br /> `<root type="object" __type="Person">   <name type="string">John</name> </root>`<br /><br /> 注意して、 \_AII ください (_t) が存在する場合があるない\_EII ください (_t)。<br /><br /> ただし、次の例に示すように、JSON での順序が逆になる場合があります。<br /><br /> {"name":"John「,」\_ください (_t)":"Person"}<br /><br /> このとき、対応する XML は次のとおりです。<br /><br /> `<root type="object">   <name type="string">John</name>   <__type type="string">Person</__type> </root>`<br /><br /> つまり、 \_AII ではない、EII に対応して特別な意味を通常どおりがください (_t) 停止します。<br /><br /> JSON 値にマップされるときの、AII の [normalized value] に対するエスケープ/エスケープ解除ルールは、このテーブルの "string" 行で指定された JSON 文字列に対するルールと同じです。<br /><br /> 例:<br /><br /> `<root type="object" __type="\abc" />`<br /><br /> これを前の例に適用すると、次の JSON にマップされます。<br /><br /> `{"__type":"\\abc"}`<br /><br /> Xml JSON へのマッピングからを最初の EII の [local name] することはできません"\_ください (_t)"です。<br /><br /> オブジェクト用の XML から JSON へのマッピングでは空白 (`ws`) が生成されることはなく、JSON から XML のマッピングでは空白が無視されます。<br /><br /> 例 : 次の JSON フラグメントは XML 要素にマップされます。<br /><br /> {   "ccc"   :  "aaa",   "ddd"    :"bbb"}<br /><br /> XML 要素を、次のコードで示します。<br /><br /> `<root type="object">    <ccc type="string">aaa</ccc>    <ddd type="string">bbb</bar> </root >`|  
+ray'|0 個以上の EII|JSON RFC section 2.3 にあるように、begin-array (左角かっこ) の直後に、後述する各 EII の配列レコードが続きます。 EII が複数個存在する場合、配列レコードの間に値区切り記号 (コンマ) が配置されます。 最後尾には、end-array が置かれます。<br /><br /> 例 : 次の XML 要素は JSON フラグメントにマップされます。<br /><br /> `<root type="array"/>    <item type="string">aaa</item>    <item type="string">bbb</item> </root >`<br /><br /> JSON フラグメントは ["aaa","bbb"] です。<br /><br /> 配列用の XML から JSON へのマッピングでは空白 (`ws`) が生成されることはなく、JSON から XML のマッピングでは空白が無視されます。<br /><br /> 例 : JSON フラグメント<br /><br /> [     "aaa",     "bbb"]<br /><br /> マップされる XML 要素は、次のとおりです。<br /><br /> `<root type="array"/>    <item type="string">aaa</item>    <item type="string">bbb</item> </root >`|  
+  
+ メンバー レコードの動作は次のとおりです。  
+  
+-   JSON RFC section 2.2 で規定されるように、内部要素の [local name] は `string` の `member` 部分にマップされます。  
+  
+ 例 : 次の要素は JSON フラグメントにマップされます。  
+  
+ `<root type="object"/>`  
+  
+ `<myLocalName type="string">aaa</myLocalName>`  
+  
+ `</root >`  
+  
+ 次の JSON フラグメントが示されます。  
+  
+ `{"myLocalName":"aaa"}`  
+  
+-   XML から JSON へのマッピングでは、JSON でエスケープする必要がある文字はエスケープされ、それ以外はエスケープされません。 "/" 文字は、エスケープする必要のない文字ですが、エスケープされます (JSON から XML へのマッピングではエスケープする必要はありません)。 これは、JSON の `DateTime` データに対する ASP.NET AJAX 形式をサポートするために必要な処理です。  
+  
+-   JSON から XML へのマッピングでは、すべての文字が (必要に応じて非エスケープ文字も含む) [local name] を生成する `string` を形成するために使用されます。  
+  
+-   内部要素 [children] は `JSON Type Attribute` の場合と同じように、`Root JSON Element` に従って section 2.2 の値にマップされます。 EII の複数レベルの入れ子 (配列内の入れ子も含む) が許可されます。  
+  
+ 例 : 次の要素は JSON フラグメントにマップされます。  
+  
+ `<root type="object">`  
+  
+ `<myLocalName1 type="string">myValue1</myLocalName1>`  
+  
+ `<myLocalName2 type="number">2</myLocalName2>`  
+  
+ `<myLocalName3 type="object">`  
+  
+ `<myNestedName1 type="boolean">true</myNestedName1>`  
+  
+ `<myNestedName2 type="null"/>`  
+  
+ `</myLocalName3>`  
+  
+ `</root >`  
+  
+ マップされる JSON フラグメントは次のとおりです。  
+  
+ `{"myLocalName1":"myValue1","myLocalName2":2,"myLocalName3":{"myNestedName1":true,"myNestedName2":null}}`  
+  
+> [!NOTE]
+>  上記のマッピングには、XML エンコーディングの手順がありません。 したがって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、キー名のすべての文字が XML 要素名の有効な文字である JSON ドキュメントのみをサポートします。 たとえば、JSON ドキュメント {"<":"a"} は、< が XML 要素の有効な名前ではないため、サポートされません。  
+  
+ 逆に、XML では有効であり、JSON では有効でない文字は、上記のマッピングに JSON のエスケープ/エスケープ解除の手順が含まれるため、問題が生じません。  
+  
+ Array Record の動作は次のとおりです。  
+  
+-   内部要素の [local name] は "item" です。  
+  
+-   内部要素の [children] は、Root JSON Element の場合と同じように、JSON Type Attribute に従って section 2.3 の値にマップされます。 EII の複数の入れ子 (オブジェクト内の入れ子も含む) が許可されます。  
+  
+ 例 : 次の要素は JSON フラグメントにマップされます。  
+  
+ `<root type="array"/>`  
+  
+ `<item type="string">myValue1</item>`  
+  
+ `<item type="number">2</item>`  
+  
+ `<item type="array">`  
+  
+ `<item type="boolean">true</item>`  
+  
+ `<item type="null"/>`  
+  
+ `</item>`  
+  
+ `</root >`  
+  
+ JSON フラグメントは次のとおりです。  
+  
+ `["myValue1",2,[true,null]]`  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Runtime.Serialization.Json.JsonReaderWriterFactory>   
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>   
+ [スタンドアロン JSON のシリアル化](../../../../docs/framework/wcf/feature-details/stand-alone-json-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/media/0c9f9baa-2439-4ef9-92f4-43c242d85d0d.gif b/docs/framework/wcf/feature-details/media/0c9f9baa-2439-4ef9-92f4-43c242d85d0d.gif
new file mode 100644
index 00000000000..f750073afd2
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/0c9f9baa-2439-4ef9-92f4-43c242d85d0d.gif differ
diff --git a/docs/framework/wcf/feature-details/media/1c8618d4-0005-4022-beb6-32fd087a8c3c.gif b/docs/framework/wcf/feature-details/media/1c8618d4-0005-4022-beb6-32fd087a8c3c.gif
new file mode 100644
index 00000000000..24f0403d21a
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/1c8618d4-0005-4022-beb6-32fd087a8c3c.gif differ
diff --git a/docs/framework/wcf/feature-details/media/1fb10a61-7e1d-42f5-b1af-195bfee5b3c6.gif b/docs/framework/wcf/feature-details/media/1fb10a61-7e1d-42f5-b1af-195bfee5b3c6.gif
new file mode 100644
index 00000000000..9b1c5d6fdbd
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/1fb10a61-7e1d-42f5-b1af-195bfee5b3c6.gif differ
diff --git a/docs/framework/wcf/feature-details/media/4f3695e0-fb0b-4c5b-afac-75f8860d2bb0.jpg b/docs/framework/wcf/feature-details/media/4f3695e0-fb0b-4c5b-afac-75f8860d2bb0.jpg
new file mode 100644
index 00000000000..e5feb9bc534
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/4f3695e0-fb0b-4c5b-afac-75f8860d2bb0.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/8f7b8968-899f-4538-a9e8-0eaa872a291c.gif b/docs/framework/wcf/feature-details/media/8f7b8968-899f-4538-a9e8-0eaa872a291c.gif
new file mode 100644
index 00000000000..060789312c3
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/8f7b8968-899f-4538-a9e8-0eaa872a291c.gif differ
diff --git a/docs/framework/wcf/feature-details/media/8fa2e931-0cfb-4aaa-9272-91d652b85d8d.gif b/docs/framework/wcf/feature-details/media/8fa2e931-0cfb-4aaa-9272-91d652b85d8d.gif
new file mode 100644
index 00000000000..635026fa7a4
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/8fa2e931-0cfb-4aaa-9272-91d652b85d8d.gif differ
diff --git a/docs/framework/wcf/feature-details/media/addactivity.JPG b/docs/framework/wcf/feature-details/media/addactivity.JPG
new file mode 100644
index 00000000000..b7c9e178f84
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addactivity.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/addassign.png b/docs/framework/wcf/feature-details/media/addassign.png
new file mode 100644
index 00000000000..8f151302fd8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addassign.png differ
diff --git a/docs/framework/wcf/feature-details/media/addcorrelationinitializers.png b/docs/framework/wcf/feature-details/media/addcorrelationinitializers.png
new file mode 100644
index 00000000000..4fd2fc74ca0
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addcorrelationinitializers.png differ
diff --git a/docs/framework/wcf/feature-details/media/addnewprojectdlg.JPG b/docs/framework/wcf/feature-details/media/addnewprojectdlg.JPG
new file mode 100644
index 00000000000..df2a8734fcc
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addnewprojectdlg.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/addorderitemidvariable.png b/docs/framework/wcf/feature-details/media/addorderitemidvariable.png
new file mode 100644
index 00000000000..22606fe0088
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addorderitemidvariable.png differ
diff --git a/docs/framework/wcf/feature-details/media/addreceive2parameters.png b/docs/framework/wcf/feature-details/media/addreceive2parameters.png
new file mode 100644
index 00000000000..cfbe0401f43
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addreceive2parameters.png differ
diff --git a/docs/framework/wcf/feature-details/media/addservicereference.JPG b/docs/framework/wcf/feature-details/media/addservicereference.JPG
new file mode 100644
index 00000000000..28bf95c811b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addservicereference.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/addvariable.JPG b/docs/framework/wcf/feature-details/media/addvariable.JPG
new file mode 100644
index 00000000000..effd02586f6
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addvariable.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/addvariables.gif b/docs/framework/wcf/feature-details/media/addvariables.gif
new file mode 100644
index 00000000000..01e1e9b42c7
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addvariables.gif differ
diff --git a/docs/framework/wcf/feature-details/media/addwfservice.JPG b/docs/framework/wcf/feature-details/media/addwfservice.JPG
new file mode 100644
index 00000000000..a35193e789e
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addwfservice.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/addwriteline.JPG b/docs/framework/wcf/feature-details/media/addwriteline.JPG
new file mode 100644
index 00000000000..29915dd7efb
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/addwriteline.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/afteraddingprinttransactioninfo.JPG b/docs/framework/wcf/feature-details/media/afteraddingprinttransactioninfo.JPG
new file mode 100644
index 00000000000..2c47c489890
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/afteraddingprinttransactioninfo.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/afteraddingsbrwriteline.JPG b/docs/framework/wcf/feature-details/media/afteraddingsbrwriteline.JPG
new file mode 100644
index 00000000000..cf51e73b4d5
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/afteraddingsbrwriteline.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/afteraddingwritelines.JPG b/docs/framework/wcf/feature-details/media/afteraddingwritelines.JPG
new file mode 100644
index 00000000000..d06596fa2a6
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/afteraddingwritelines.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfiguration-general.gif b/docs/framework/wcf/feature-details/media/appfabricconfiguration-general.gif
new file mode 100644
index 00000000000..2b0540598b8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfiguration-general.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfiguration-management.gif b/docs/framework/wcf/feature-details/media/appfabricconfiguration-management.gif
new file mode 100644
index 00000000000..f9fc279fd4e
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfiguration-management.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfiguration-monitoring.gif b/docs/framework/wcf/feature-details/media/appfabricconfiguration-monitoring.gif
new file mode 100644
index 00000000000..8599325bf93
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfiguration-monitoring.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfiguration-persistence.gif b/docs/framework/wcf/feature-details/media/appfabricconfiguration-persistence.gif
new file mode 100644
index 00000000000..2504174585c
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfiguration-persistence.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfiguration-security.gif b/docs/framework/wcf/feature-details/media/appfabricconfiguration-security.gif
new file mode 100644
index 00000000000..2f74b2f32ca
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfiguration-security.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfigurationautostart.gif b/docs/framework/wcf/feature-details/media/appfabricconfigurationautostart.gif
new file mode 100644
index 00000000000..ebfcb239780
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfigurationautostart.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricconfigurationthrottling.gif b/docs/framework/wcf/feature-details/media/appfabricconfigurationthrottling.gif
new file mode 100644
index 00000000000..8616c992f55
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricconfigurationthrottling.gif differ
diff --git a/docs/framework/wcf/feature-details/media/appfabricdashboard.gif b/docs/framework/wcf/feature-details/media/appfabricdashboard.gif
new file mode 100644
index 00000000000..a0cb89bf74d
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/appfabricdashboard.gif differ
diff --git a/docs/framework/wcf/feature-details/media/applicationserveraddcomps.jpg b/docs/framework/wcf/feature-details/media/applicationserveraddcomps.jpg
new file mode 100644
index 00000000000..a4c27c81e1b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/applicationserveraddcomps.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/argumentbind.JPG b/docs/framework/wcf/feature-details/media/argumentbind.JPG
new file mode 100644
index 00000000000..668da648db7
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/argumentbind.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/aspnetdevservericon.JPG b/docs/framework/wcf/feature-details/media/aspnetdevservericon.JPG
new file mode 100644
index 00000000000..81fb6564c7a
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/aspnetdevservericon.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/asrdlg.JPG b/docs/framework/wcf/feature-details/media/asrdlg.JPG
new file mode 100644
index 00000000000..47975017450
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/asrdlg.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/b361a565-831c-4c10-90d7-66d8eeece0a1.gif b/docs/framework/wcf/feature-details/media/b361a565-831c-4c10-90d7-66d8eeece0a1.gif
new file mode 100644
index 00000000000..77b209ffdd8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/b361a565-831c-4c10-90d7-66d8eeece0a1.gif differ
diff --git a/docs/framework/wcf/feature-details/media/cancreateinstance.JPG b/docs/framework/wcf/feature-details/media/cancreateinstance.JPG
new file mode 100644
index 00000000000..751342073f8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/cancreateinstance.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/checkmark.gif b/docs/framework/wcf/feature-details/media/checkmark.gif
new file mode 100644
index 00000000000..dac5608968f
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/checkmark.gif differ
diff --git a/docs/framework/wcf/feature-details/media/claimshierarchy.gif b/docs/framework/wcf/feature-details/media/claimshierarchy.gif
new file mode 100644
index 00000000000..f72fc95b298
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/claimshierarchy.gif differ
diff --git a/docs/framework/wcf/feature-details/media/clientaddcbswriteline.JPG b/docs/framework/wcf/feature-details/media/clientaddcbswriteline.JPG
new file mode 100644
index 00000000000..5b9722e7bda
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientaddcbswriteline.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/clientaddwriteline.JPG b/docs/framework/wcf/feature-details/media/clientaddwriteline.JPG
new file mode 100644
index 00000000000..52d57026377
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientaddwriteline.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/clientcompleteworkflow.jpg b/docs/framework/wcf/feature-details/media/clientcompleteworkflow.jpg
new file mode 100644
index 00000000000..aa5c9470053
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientcompleteworkflow.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/clientreplymessagesettings.JPG b/docs/framework/wcf/feature-details/media/clientreplymessagesettings.JPG
new file mode 100644
index 00000000000..cc8e9a53bc6
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientreplymessagesettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/clientsendsettings.JPG b/docs/framework/wcf/feature-details/media/clientsendsettings.JPG
new file mode 100644
index 00000000000..60862a4f2e1
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientsendsettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/clientwithcertificate.gif b/docs/framework/wcf/feature-details/media/clientwithcertificate.gif
new file mode 100644
index 00000000000..80d9a95ef12
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/clientwithcertificate.gif differ
diff --git a/docs/framework/wcf/feature-details/media/completeclientwf.JPG b/docs/framework/wcf/feature-details/media/completeclientwf.JPG
new file mode 100644
index 00000000000..ccede0f56f5
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/completeclientwf.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/correlateson.png b/docs/framework/wcf/feature-details/media/correlateson.png
new file mode 100644
index 00000000000..7d40a08c17a
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/correlateson.png differ
diff --git a/docs/framework/wcf/feature-details/media/correlatesondialog.jpg b/docs/framework/wcf/feature-details/media/correlatesondialog.jpg
new file mode 100644
index 00000000000..44cddc6bf12
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/correlatesondialog.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/correlationinitializerdlg.jpg b/docs/framework/wcf/feature-details/media/correlationinitializerdlg.jpg
new file mode 100644
index 00000000000..8a8547e5f53
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/correlationinitializerdlg.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/defaultworkflowservice.JPG b/docs/framework/wcf/feature-details/media/defaultworkflowservice.JPG
new file mode 100644
index 00000000000..b5f34515111
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/defaultworkflowservice.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/defineoperation.JPG b/docs/framework/wcf/feature-details/media/defineoperation.JPG
new file mode 100644
index 00000000000..eb72bfcfe7f
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/defineoperation.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg b/docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg
new file mode 100644
index 00000000000..ad57331567b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/echoactivity.JPG b/docs/framework/wcf/feature-details/media/echoactivity.JPG
new file mode 100644
index 00000000000..52030cfcb46
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/echoactivity.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/f4157312-b17c-416c-a5ee-fa7b54db211b.gif b/docs/framework/wcf/feature-details/media/f4157312-b17c-416c-a5ee-fa7b54db211b.gif
new file mode 100644
index 00000000000..d391b2e5622
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/f4157312-b17c-416c-a5ee-fa7b54db211b.gif differ
diff --git a/docs/framework/wcf/feature-details/media/federatedsecurityinwcf.gif b/docs/framework/wcf/feature-details/media/federatedsecurityinwcf.gif
new file mode 100644
index 00000000000..e25e8390612
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/federatedsecurityinwcf.gif differ
diff --git a/docs/framework/wcf/feature-details/media/federationclienta.gif b/docs/framework/wcf/feature-details/media/federationclienta.gif
new file mode 100644
index 00000000000..5a1896d038b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/federationclienta.gif differ
diff --git a/docs/framework/wcf/feature-details/media/hostingwcfwithaspnet.gif b/docs/framework/wcf/feature-details/media/hostingwcfwithaspnet.gif
new file mode 100644
index 00000000000..364018172ec
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/hostingwcfwithaspnet.gif differ
diff --git a/docs/framework/wcf/feature-details/media/iewcfhelppagewuri.JPG b/docs/framework/wcf/feature-details/media/iewcfhelppagewuri.JPG
new file mode 100644
index 00000000000..9cb3ed66a87
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/iewcfhelppagewuri.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/instringvar.JPG b/docs/framework/wcf/feature-details/media/instringvar.JPG
new file mode 100644
index 00000000000..115a59e5127
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/instringvar.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/knowntypes.png b/docs/framework/wcf/feature-details/media/knowntypes.png
new file mode 100644
index 00000000000..ae1b9025a00
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/knowntypes.png differ
diff --git a/docs/framework/wcf/feature-details/media/mg-addsslbinding.jpg b/docs/framework/wcf/feature-details/media/mg-addsslbinding.jpg
new file mode 100644
index 00000000000..b1208d46297
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-addsslbinding.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-createselfsignedcert.jpg b/docs/framework/wcf/feature-details/media/mg-createselfsignedcert.jpg
new file mode 100644
index 00000000000..942b215955d
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-createselfsignedcert.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-inetmgrhome.jpg b/docs/framework/wcf/feature-details/media/mg-inetmgrhome.jpg
new file mode 100644
index 00000000000..1868c7f7651
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-inetmgrhome.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-mycert.jpg b/docs/framework/wcf/feature-details/media/mg-mycert.jpg
new file mode 100644
index 00000000000..66f77aabe46
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-mycert.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-mycertbinding.jpg b/docs/framework/wcf/feature-details/media/mg-mycertbinding.jpg
new file mode 100644
index 00000000000..af9a08dc149
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-mycertbinding.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-servercertificatewindow.jpg b/docs/framework/wcf/feature-details/media/mg-servercertificatewindow.jpg
new file mode 100644
index 00000000000..4fb04536289
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-servercertificatewindow.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-sitebindingsdialog.jpg b/docs/framework/wcf/feature-details/media/mg-sitebindingsdialog.jpg
new file mode 100644
index 00000000000..53951e551b3
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-sitebindingsdialog.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-sslsettingsforvdir.jpg b/docs/framework/wcf/feature-details/media/mg-sslsettingsforvdir.jpg
new file mode 100644
index 00000000000..5ce537eedbc
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-sslsettingsforvdir.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/mg-vdirsslsettings.JPG b/docs/framework/wcf/feature-details/media/mg-vdirsslsettings.JPG
new file mode 100644
index 00000000000..ce40420b652
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/mg-vdirsslsettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/msservicestsb.gif b/docs/framework/wcf/feature-details/media/msservicestsb.gif
new file mode 100644
index 00000000000..646b2c6ea65
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/msservicestsb.gif differ
diff --git a/docs/framework/wcf/feature-details/media/multiplesetsofclaims.gif b/docs/framework/wcf/feature-details/media/multiplesetsofclaims.gif
new file mode 100644
index 00000000000..66f973e89c4
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/multiplesetsofclaims.gif differ
diff --git a/docs/framework/wcf/feature-details/media/myservice.gif b/docs/framework/wcf/feature-details/media/myservice.gif
new file mode 100644
index 00000000000..e0ccc844795
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/myservice.gif differ
diff --git a/docs/framework/wcf/feature-details/media/parameterscontent.jpg b/docs/framework/wcf/feature-details/media/parameterscontent.jpg
new file mode 100644
index 00000000000..10066752623
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/parameterscontent.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/parameterscontent2.jpg b/docs/framework/wcf/feature-details/media/parameterscontent2.jpg
new file mode 100644
index 00000000000..66bbeebf232
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/parameterscontent2.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/persisteddetail.gif b/docs/framework/wcf/feature-details/media/persisteddetail.gif
new file mode 100644
index 00000000000..a595aee0268
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/persisteddetail.gif differ
diff --git a/docs/framework/wcf/feature-details/media/projectpropertiesdlg.JPG b/docs/framework/wcf/feature-details/media/projectpropertiesdlg.JPG
new file mode 100644
index 00000000000..5c0c2a9e6e9
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/projectpropertiesdlg.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/publicunsecured.gif b/docs/framework/wcf/feature-details/media/publicunsecured.gif
new file mode 100644
index 00000000000..e9f2709d842
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/publicunsecured.gif differ
diff --git a/docs/framework/wcf/feature-details/media/qconceptual-figure1c.gif b/docs/framework/wcf/feature-details/media/qconceptual-figure1c.gif
new file mode 100644
index 00000000000..7c27420e58c
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/qconceptual-figure1c.gif differ
diff --git a/docs/framework/wcf/feature-details/media/qwithtransactions-figure3.gif b/docs/framework/wcf/feature-details/media/qwithtransactions-figure3.gif
new file mode 100644
index 00000000000..807e8932261
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/qwithtransactions-figure3.gif differ
diff --git a/docs/framework/wcf/feature-details/media/receiveandsendreply.JPG b/docs/framework/wcf/feature-details/media/receiveandsendreply.JPG
new file mode 100644
index 00000000000..d8fff4d28ef
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/receiveandsendreply.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/receivemessagesettings.JPG b/docs/framework/wcf/feature-details/media/receivemessagesettings.JPG
new file mode 100644
index 00000000000..96273707dc8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/receivemessagesettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/replymessagesettings.JPG b/docs/framework/wcf/feature-details/media/replymessagesettings.JPG
new file mode 100644
index 00000000000..964c6b487d8
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/replymessagesettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/replytoadditemcontent.gif b/docs/framework/wcf/feature-details/media/replytoadditemcontent.gif
new file mode 100644
index 00000000000..583613ba9fa
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/replytoadditemcontent.gif differ
diff --git a/docs/framework/wcf/feature-details/media/resultassign.png b/docs/framework/wcf/feature-details/media/resultassign.png
new file mode 100644
index 00000000000..da5cf4e9b5f
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/resultassign.png differ
diff --git a/docs/framework/wcf/feature-details/media/scfc-turnfeaturesonoroff5s.gif b/docs/framework/wcf/feature-details/media/scfc-turnfeaturesonoroff5s.gif
new file mode 100644
index 00000000000..b533327f4c7
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/scfc-turnfeaturesonoroff5s.gif differ
diff --git a/docs/framework/wcf/feature-details/media/securedbyusername.gif b/docs/framework/wcf/feature-details/media/securedbyusername.gif
new file mode 100644
index 00000000000..f2d125d6500
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/securedbyusername.gif differ
diff --git a/docs/framework/wcf/feature-details/media/securedbywindows.gif b/docs/framework/wcf/feature-details/media/securedbywindows.gif
new file mode 100644
index 00000000000..8deb431057d
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/securedbywindows.gif differ
diff --git a/docs/framework/wcf/feature-details/media/sendmessagesettings.JPG b/docs/framework/wcf/feature-details/media/sendmessagesettings.JPG
new file mode 100644
index 00000000000..ba76335fe5b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/sendmessagesettings.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/serviceaddreceive.JPG b/docs/framework/wcf/feature-details/media/serviceaddreceive.JPG
new file mode 100644
index 00000000000..43df81cd7f9
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/serviceaddreceive.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/servicecomplete.jpg b/docs/framework/wcf/feature-details/media/servicecomplete.jpg
new file mode 100644
index 00000000000..6c5ece6f539
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/servicecomplete.jpg differ
diff --git a/docs/framework/wcf/feature-details/media/setreceivecontent.png b/docs/framework/wcf/feature-details/media/setreceivecontent.png
new file mode 100644
index 00000000000..fd870d5340a
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreceivecontent.png differ
diff --git a/docs/framework/wcf/feature-details/media/setreceiveproperties.png b/docs/framework/wcf/feature-details/media/setreceiveproperties.png
new file mode 100644
index 00000000000..e457748d337
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreceiveproperties.png differ
diff --git a/docs/framework/wcf/feature-details/media/setreceiveproperties2.png b/docs/framework/wcf/feature-details/media/setreceiveproperties2.png
new file mode 100644
index 00000000000..ed111e83612
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreceiveproperties2.png differ
diff --git a/docs/framework/wcf/feature-details/media/setreply2properties.png b/docs/framework/wcf/feature-details/media/setreply2properties.png
new file mode 100644
index 00000000000..f2af370bb54
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreply2properties.png differ
diff --git a/docs/framework/wcf/feature-details/media/setreplycontent.png b/docs/framework/wcf/feature-details/media/setreplycontent.png
new file mode 100644
index 00000000000..2fea9d67d27
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreplycontent.png differ
diff --git a/docs/framework/wcf/feature-details/media/setreplyproperties.png b/docs/framework/wcf/feature-details/media/setreplyproperties.png
new file mode 100644
index 00000000000..28e68052fa3
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/setreplyproperties.png differ
diff --git a/docs/framework/wcf/feature-details/media/settingserialzier.png b/docs/framework/wcf/feature-details/media/settingserialzier.png
new file mode 100644
index 00000000000..eedd02fd74a
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/settingserialzier.png differ
diff --git a/docs/framework/wcf/feature-details/media/simpleworkflow.png b/docs/framework/wcf/feature-details/media/simpleworkflow.png
new file mode 100644
index 00000000000..7b1dd9e6386
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/simpleworkflow.png differ
diff --git a/docs/framework/wcf/feature-details/media/startaction.png b/docs/framework/wcf/feature-details/media/startaction.png
new file mode 100644
index 00000000000..936b61dc8d0
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/startaction.png differ
diff --git a/docs/framework/wcf/feature-details/media/startupprojects.JPG b/docs/framework/wcf/feature-details/media/startupprojects.JPG
new file mode 100644
index 00000000000..3a0b7e6f3ce
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/startupprojects.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/sts-b.gif b/docs/framework/wcf/feature-details/media/sts-b.gif
new file mode 100644
index 00000000000..da27f34bacf
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/sts-b.gif differ
diff --git a/docs/framework/wcf/feature-details/media/testservice.gif b/docs/framework/wcf/feature-details/media/testservice.gif
new file mode 100644
index 00000000000..7c53ab1c76e
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/testservice.gif differ
diff --git a/docs/framework/wcf/feature-details/media/transactionmanagers.gif b/docs/framework/wcf/feature-details/media/transactionmanagers.gif
new file mode 100644
index 00000000000..147bd510954
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/transactionmanagers.gif differ
diff --git a/docs/framework/wcf/feature-details/media/trs.JPG b/docs/framework/wcf/feature-details/media/trs.JPG
new file mode 100644
index 00000000000..bdb20d4a871
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/trs.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/trsvariables.JPG b/docs/framework/wcf/feature-details/media/trsvariables.JPG
new file mode 100644
index 00000000000..b3c6c6edc8e
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/trsvariables.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/tsvariables.JPG b/docs/framework/wcf/feature-details/media/tsvariables.JPG
new file mode 100644
index 00000000000..785237959be
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/tsvariables.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/typecollectionseditor.gif b/docs/framework/wcf/feature-details/media/typecollectionseditor.gif
new file mode 100644
index 00000000000..146d6a02017
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/typecollectionseditor.gif differ
diff --git a/docs/framework/wcf/feature-details/media/typicalfederatedsecurityscenario.gif b/docs/framework/wcf/feature-details/media/typicalfederatedsecurityscenario.gif
new file mode 100644
index 00000000000..3e2d186fba6
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/typicalfederatedsecurityscenario.gif differ
diff --git a/docs/framework/wcf/feature-details/media/unsecuredwebservice.gif b/docs/framework/wcf/feature-details/media/unsecuredwebservice.gif
new file mode 100644
index 00000000000..fd4dfd3a720
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/unsecuredwebservice.gif differ
diff --git a/docs/framework/wcf/feature-details/media/uselocalwebserver.png b/docs/framework/wcf/feature-details/media/uselocalwebserver.png
new file mode 100644
index 00000000000..20f5e51afea
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/uselocalwebserver.png differ
diff --git a/docs/framework/wcf/feature-details/media/wasarchitecture.gif b/docs/framework/wcf/feature-details/media/wasarchitecture.gif
new file mode 100644
index 00000000000..1dce7853d48
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wasarchitecture.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wcfc-trunfeaturesonoroff3s.gif b/docs/framework/wcf/feature-details/media/wcfc-trunfeaturesonoroff3s.gif
new file mode 100644
index 00000000000..e85f2bea8ae
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wcfc-trunfeaturesonoroff3s.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wcfc-trustedsubsystemc.gif b/docs/framework/wcf/feature-details/media/wcfc-trustedsubsystemc.gif
new file mode 100644
index 00000000000..1382630a98e
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wcfc-trustedsubsystemc.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wcfc-turnfeaturesonoroffs.gif b/docs/framework/wcf/feature-details/media/wcfc-turnfeaturesonoroffs.gif
new file mode 100644
index 00000000000..1e36fc9558f
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wcfc-turnfeaturesonoroffs.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wcfc-turningfeaturesonoroff2.gif b/docs/framework/wcf/feature-details/media/wcfc-turningfeaturesonoroff2.gif
new file mode 100644
index 00000000000..b539dd42fca
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wcfc-turningfeaturesonoroff2.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wcfhelppate.JPG b/docs/framework/wcf/feature-details/media/wcfhelppate.JPG
new file mode 100644
index 00000000000..96712493a3c
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wcfhelppate.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/wfdesignertoolbox.JPG b/docs/framework/wcf/feature-details/media/wfdesignertoolbox.JPG
new file mode 100644
index 00000000000..0166fb16c73
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfdesignertoolbox.JPG differ
diff --git a/docs/framework/wcf/feature-details/media/wfhostopen.gif b/docs/framework/wcf/feature-details/media/wfhostopen.gif
new file mode 100644
index 00000000000..be647f8422c
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfhostopen.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wfhreceivemessagecci.gif b/docs/framework/wcf/feature-details/media/wfhreceivemessagecci.gif
new file mode 100644
index 00000000000..df5447f6bc3
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfhreceivemessagecci.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wfshhighlevel.gif b/docs/framework/wcf/feature-details/media/wfshhighlevel.gif
new file mode 100644
index 00000000000..ad07e5c311b
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfshhighlevel.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wfshmessageflow.gif b/docs/framework/wcf/feature-details/media/wfshmessageflow.gif
new file mode 100644
index 00000000000..0f17f4a6315
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfshmessageflow.gif differ
diff --git a/docs/framework/wcf/feature-details/media/wfshreceivemessage.gif b/docs/framework/wcf/feature-details/media/wfshreceivemessage.gif
new file mode 100644
index 00000000000..45d119cdf18
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/wfshreceivemessage.gif differ
diff --git a/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv1.bmp b/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv1.bmp
new file mode 100644
index 00000000000..95682e90874
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv1.bmp differ
diff --git a/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv2.bmp b/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv2.bmp
new file mode 100644
index 00000000000..97ee2004272
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv2.bmp differ
diff --git a/docs/framework/wcf/feature-details/media/xsi-recap.gif b/docs/framework/wcf/feature-details/media/xsi-recap.gif
new file mode 100644
index 00000000000..c7d8a034494
Binary files /dev/null and b/docs/framework/wcf/feature-details/media/xsi-recap.gif differ
diff --git a/docs/framework/wcf/feature-details/message-filters.md b/docs/framework/wcf/feature-details/message-filters.md
new file mode 100644
index 00000000000..4bbaf46946a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-filters.md
@@ -0,0 +1,163 @@
+---
+title: "メッセージ フィルター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ルーティング [WCF], メッセージ フィルター"
+ms.assetid: cb33ba49-8b1f-4099-8acb-240404a46d9a
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# メッセージ フィルター
+コンテンツ ベースのルーティングを実装する場合、ルーティング サービスは、アドレス、エンドポイント名、特定の XPath ステートメントなど、メッセージの特定のセクションを確認する <xref:System.ServiceModel.Dispatcher.MessageFilter> 実装を使用します。  [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] に付属のメッセージ フィルターの中にニーズを満たすものがない場合は、<xref:System.ServiceModel.Dispatcher.MessageFilter> 基本クラスの新しい実装を作成することで、カスタム フィルターを作成できます。  
+  
+ ルーティング サービスを構成する場合、**MessageFilter** の型と、メッセージ内の検索に使用する特定の文字列値など、フィルターの作成に必要なサポート データを記述するフィルター要素 \(<xref:System.ServiceModel.Routing.Configuration.FilterElement> オブジェクト\) を定義する必要があります。  フィルター要素を作成しても、個々のメッセージ フィルターが定義されるだけです。フィルターを使用してメッセージを評価およびルーティングするには、フィルター テーブル \(<xref:System.ServiceModel.Routing.Configuration.FilterTableEntryCollection>\) を定義する必要もあります。  
+  
+ フィルター テーブル内の各エントリは、特定のフィルター要素を参照し、メッセージがフィルターに一致した場合にメッセージのルーティング先となるクライアント エンドポイントを指定します。  フィルター テーブルのエントリでは、バックアップ エンドポイントのコレクション \(<xref:System.ServiceModel.Routing.Configuration.BackupEndpointCollection>\) を指定することもできます。このコレクションは、プライマリ エンドポイントへの送信時に転送エラーが発生した場合に、メッセージの転送先となるエンドポイントのリストを定義します。  それらのエンドポイントのいずれかで転送が成功するまで、指定された順番でバックアップ エンドポイントへの転送が試行されます。  
+  
+## メッセージ フィルター  
+ ルーティング サービスが使用するメッセージ フィルターは、メッセージの送信先の名前、SOAP アクション、メッセージの送信先のアドレスまたはアドレス プレフィックスの評価など、一般的なメッセージ選択機能を提供します。  フィルターに `AND` 条件を付けて、メッセージが両方のフィルターに一致した場合は、特定のエンドポイントにのみルーティングされるように指定することもできます。  また、<xref:System.ServiceModel.Dispatcher.MessageFilter> の独自の実装を作成することで、カスタム フィルターを作成することもできます。  
+  
+ 次の表に、ルーティング サービスが使用する <xref:System.ServiceModel.Routing.Configuration.FilterType>、そのメッセージ フィルターを実装するクラス、および必須の <xref:System.ServiceModel.Routing.Configuration.FilterElement.FilterData%2A> パラメーターを示します。  
+  
+|フィルターの型|説明|フィルター データの意味|フィルターの例|  
+|-------------|--------|------------------|-------------|  
+|動作|<xref:System.ServiceModel.Dispatcher.ActionMessageFilter> クラスを使用して、特定のアクションを含むメッセージを照合します。|フィルター処理するアクション。|\<filter name\="action1" filterType\="Action" filterData\="http:\/\/namespace\/contract\/operation" \/\>|  
+|EndpointAddress|<xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter> クラスを <xref:System.ServiceModel.Dispatcher.EndpointAddressMessageFilter.IncludeHostNameInComparison%2A> \=\= `true` と組み合わせて使用して、特定のアドレスを含むメッセージを照合します。|フィルター処理するアドレス \(To ヘッダー\)。|\<filter name\="address1" filterType\="EndpointAddress" filterData\="http:\/\/host\/vdir\/s.svc\/b"  \/\>|  
+|EndpointAddressPrefix|<xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter> クラスを <xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter.IncludeHostNameInComparison%2A> \=\= `true` と組み合わせて、特定のアドレス プレフィックスを含むメッセージを照合します。|最長プレフィックス一致を使用してフィルター処理するアドレス。|\<filter name\="prefix1" filterType\="EndpointAddressPrefix" filterData\="http:\/\/host\/" \/\>|  
+|And|常に両方の条件を評価してから結果を返す <xref:System.ServiceModel.Dispatcher.StrictAndMessageFilter> クラスを使用します。|filterData は使用されません。代わりに、filter1 および filter2 には、対応するメッセージ フィルターの名前が \(同じくテーブル内に\) あるので、これらを **AND** で連結します。|\<filter name\="and1" filterType\="And" filter1\="address1" filter2\="action1" \/\>|  
+|Custom|<xref:System.ServiceModel.Dispatcher.MessageFilter> クラスを拡張し、文字列を受け取るコンストラクターを持つユーザー定義の型。|customType 属性は、作成するクラスの完全修飾型名で、filterData は、フィルターの作成時にコンストラクターに渡す文字列です。|\<filter name\="custom1" filterType\="Custom" customType\="CustomAssembly.CustomMsgFilter, CustomAssembly" filterData\="Custom Data" \/\>|  
+|EndpointName|<xref:System.ServiceModel.Dispatcher.EndpointNameMessageFilter> クラスを使用して、メッセージを受信したサービス エンドポイントの名前を基にメッセージを照合します。|サービス エンドポイントの名前 \(例: "serviceEndpoint1"\)。これは、ルーティング サービスで公開されているエンドポイントのいずれかである必要があります。|\<filter name\="stock1" filterType\="Endpoint" filterData\="SvcEndpoint" \/\>|  
+|MatchAll|<xref:System.ServiceModel.Dispatcher.MatchAllMessageFilter> クラスを使用します。  このフィルターは、すべての着信メッセージを照合します。|filterData は使用されません。  このフィルターは、常にすべてのメッセージを照合します。|\<filter name\="matchAll1" filterType\="MatchAll" \/\>|  
+|XPath|<xref:System.ServiceModel.Dispatcher.XPathMessageFilter> クラスを使用して、メッセージ内の特定の XPath クエリを照合します。|メッセージの照合時に使用する XPath クエリ。|\<filter name\="XPath1" filterType\="XPath" filterData\="\/\/ns:element" \/\>|  
+  
+ 次の例では、XPath、EndpointName、および PrefixEndpointAddress メッセージ フィルターを使用するフィルター エントリを定義しています。  また、この例では、RoundRobinFilter1 エントリと RoundRobinFilter2 エントリに対するカスタム フィルターの使用方法も示しています。  
+  
+```xml  
+<filters>  
+     <filter name="XPathFilter" filterType="XPath"   
+             filterData="/s12:Envelope/s12:Header/custom:RoundingCalculator = 1"/>  
+     <filter name="EndpointNameFilter" filterType="EndpointName"   
+             filterData="calculatorEndpoint"/>  
+     <filter name="PrefixAddressFilter" filterType="PrefixEndpointAddress"   
+             filterData="http://localhost/routingservice/router/rounding/"/>  
+     <filter name="RoundRobinFilter1" filterType="Custom"   
+             customType="RoutingServiceFilters.RoundRobinMessageFilter,   
+             RoutingService" filterData="group1"/>  
+     <filter name="RoundRobinFilter2" filterType="Custom"   
+             customType="RoutingServiceFilters.RoundRobinMessageFilter,   
+             RoutingService" filterData="group1"/>  
+</filters>  
+  
+```  
+  
+> [!NOTE]
+>  単にフィルターを定義しただけでは、そのフィルターに対してメッセージが評価されるとは限りません。  フィルターをフィルター テーブルに追加する必要があります。テーブルに追加することで、ルーティング サービスが公開するサービス エンドポイントに関連付けられます。  
+  
+### 名前空間テーブル  
+ XPath フィルターを使用すると、XPath クエリを含むフィルター データは、名前空間を使用するため、非常に大きくなることがあります。  この問題を軽減するために、ルーティング サービスでは、名前空間テーブルを使用して、独自の名前空間プレフィックスを定義できるようにしています。  
+  
+ 名前空間テーブルは、XPath で使用できる一般的な名前空間の名前空間プレフィックスを定義する <xref:System.ServiceModel.Routing.Configuration.NamespaceElement> オブジェクトのコレクションです。  以下は、名前空間テーブルに格納されている既定の名前空間およびプレフィックスです。  
+  
+|プレフィックス|Namespace|  
+|-------------|---------------|  
+|s11|http:\/\/schemas.xmlsoap.org\/soap\/envelope|  
+|s12|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|wsaAugust2004|http:\/\/schemas.xmlsoap.org\/ws\/2004\/08\/addressing|  
+|wsa10|http:\/\/www.w3.org\/2005\/08\/addressing|  
+|sm|http:\/\/schemas.microsoft.com\/serviceModel\/2004\/05\/xpathfunctions|  
+|tempuri|http:\/\/tempuri.org|  
+|ser|http:\/\/schemas.microsoft.com\/2003\/10\/Serialization|  
+  
+ XPath クエリに特定の名前空間を使用することがわかっている場合は、その名前空間を一意の名前空間プレフィックスと併せて名前空間テーブルに追加し、完全名前空間ではなく、プレフィックスを XPath クエリで使用できます。  次の例では、名前空間 "http:\/\/my.custom.namespace" に対して "custom" というプレフィックスを定義し、  これを filterData 内の XPath クエリで使用しています。  
+  
+```xml  
+<namespaceTable>  
+     <add prefix="custom" namespace="http://my.custom.namespace/"/>  
+</namespaceTable>  
+<filters>  
+     <filter name="XPathFilter" filterType="XPath" filterData="/s12:Envelope/s12:Header/custom:RoundingCalculator = 1"/>  
+</filters>  
+  
+```  
+  
+## フィルター テーブル  
+ 各フィルター要素では、メッセージに適用できる論理比較が定義されますが、フィルター テーブルでは、フィルター要素と送信先クライアント エンドポイントが関連付けられます。  フィルター テーブルは、フィルター、プライマリの送信先エンドポイント、および代替のバックアップ エンドポイントのリスト間の関連付けを定義する <xref:System.ServiceModel.Routing.Configuration.FilterTableEntryElement> オブジェクトの名前付きコレクションです。  フィルター テーブル エントリでは、必要に応じて、各フィルター条件に優先度を指定することもできます。  次の例では、まず、2 つのフィルターを定義し、各フィルターを送信先エンドポイントに関連付けるフィルター テーブルを定義しています。  
+  
+```xml  
+<routing>  
+     <filters>  
+       <filter name="AddAction" filterType="Action" filterData=”Add” />  
+       <filter name="SubtractAction" filterType="Action" filterData=”Subtract” />  
+     </filters>  
+     <filterTables>  
+       <table name="routingTable1">  
+         <filters>  
+           <add filterName="AddAction" endpointName="Addition" />  
+           <add filterName="SubtractAction" endpointName="Subtraction" />  
+         </filters>  
+       </table>  
+     </filterTables>      
+</routing>  
+  
+```  
+  
+### フィルター評価の優先度  
+ 既定では、フィルター テーブルのすべてのエントリが同時に評価され、評価対象のメッセージは、一致するフィルター エントリに関連付けられているエンドポイントにルーティングされます。  複数のフィルターが `true` に評価され、メッセージが一方向または双方向である場合は、メッセージが、一致するすべてのフィルターのエンドポイントにマルチキャストされます。  要求\/応答メッセージは、クライアントに返すことができる応答が 1 つのみであるため、マルチキャストできません。  
+  
+ 各フィルターに優先度レベルを指定することで、より複雑なルーティング ロジックを実装できます。ルーティング サービスは、優先度レベルが最も高いフィルターをすべて最初に評価します。  メッセージがこのレベルのフィルターに一致した場合、優先度がこれよりも低いフィルターは処理されません。  たとえば、一方向の受信メッセージは、最初に、優先度が 2 であるすべてのフィルターに対して評価されるとします。  この優先度レベルのどのフィルターにもメッセージが一致しなかった場合は、次に、優先度が 1 のフィルターと比較されます。  優先度 1 のフィルターのうち、2 つがメッセージに一致した場合、メッセージは、一方向のメッセージであるため、両方の送信先エンドポイントにルーティングされます。  優先度 1 のフィルターの中に一致するものが見つかったため、優先度が 0 のフィルターは評価されません。  
+  
+> [!NOTE]
+>  優先度が指定されていない場合は、既定の優先度の 0 が使用されます。  
+  
+ 次の例では、フィルター テーブルを定義しています。このテーブルでは、テーブルで参照しているフィルターに優先度 2、1、および 0 を指定しています。  
+  
+```xml  
+<filterTables>  
+     <filterTable name="filterTable1">  
+          <add filterName="XPathFilter" endpointName="roundingCalcEndpoint"   
+               priority="2"/>  
+          <add filterName="EndpointNameFilter" endpointName="regularCalcEndpoint"   
+               priority="1"/>  
+          <add filterName="PrefixAddressFilter" endpointName="roundingCalcEndpoint"   
+               priority="1"/>  
+          <add filterName="MatchAllMessageFilter" endpointName="defaultCalcEndpoint"   
+               priority="0"/>  
+     </filterTable>  
+</filterTables>  
+  
+```  
+  
+ 上記の例では、メッセージが XPathFilter に一致すると、roundingCalcEndpoint にルーティングされます。また、その他のフィルターはすべて、これよりも優先度が低いため、テーブル内の他のフィルターは評価されません。  ただし、メッセージが XPathFilter に一致しなかった場合は、次に優先度が低いすべてのフィルター、つまり、EndpointNameFilter と PrefixAddressFilter に対してメッセージが評価されます。  
+  
+> [!NOTE]
+>  可能な場合は、優先度の評価によってパフォーマンスが低下する可能性があるため、優先度を指定する代わりに、排他的なフィルターを使用してください。  
+  
+### バックアップ リスト  
+ フィルター テーブルの各フィルターには、必要に応じて、バックアップ リストを指定できます。バックアップ リストは、エンドポイントの名前付きコレクション \(<xref:System.ServiceModel.Routing.Configuration.BackupEndpointCollection>\) です。  このコレクションには、<xref:System.ServiceModel.Routing.Configuration.FilterTableEntryElement.EndpointName%2A> に指定されているプライマリ エンドポイントへの送信時に <xref:System.ServiceModel.CommunicationException> が発生した場合に、メッセージの転送先となるエンドポイントの順序指定されたリストが保持されます。  次の例では、2 つのエンドポイントを保持している "backupServiceEndpoints" という名前のバックアップ リストを定義しています。  
+  
+```xml  
+<filterTables>  
+     <filterTable name="filterTable1">  
+          <add filterName="MatchAllFilter1" endpointName="Destination" backupList="backupEndpointList"/>  
+     </filterTable>  
+</filterTables>  
+<backupLists>  
+     <backupList name="backupEndpointList">  
+          <add endpointName="backupServiceQueue" />  
+          <add endpointName="alternateServiceQueue" />  
+     </backupList>  
+</backupLists>  
+```  
+  
+ 上記の例では、プライマリ エンドポイント "Destination" への送信が失敗した場合、ルーティング サービスは、シーケンス内の各エンドポイントへの送信を試みます。まず、backupServiceQueue への送信を試み、backupServiceQueue への送信が失敗した場合は、alternateServiceQueue への送信を試みます。  すべてのバックアップ エンドポイントへの送信が失敗した場合は、エラーが返されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-in-wcf.md b/docs/framework/wcf/feature-details/message-security-in-wcf.md
new file mode 100644
index 00000000000..a35fd624438
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-in-wcf.md
@@ -0,0 +1,72 @@
+---
+title: "WCF のメッセージのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a80efb59-591a-4a37-bb3c-8fffa6ca0b7d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# WCF のメッセージのセキュリティ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、セキュリティを提供する 2 つの主なモード \(`Transport` および `Message`\) と、この 2 つを組み合わせた 3 番目のモード \(`TransportWithMessageCredential`\) があります。ここでは、メッセージ セキュリティとその必要性について説明します。  
+  
+## メッセージ セキュリティとは  
+ メッセージ セキュリティでは、メッセージをセキュリティで保護するために WS\-Security 仕様を使用します。WS\-Security 仕様では、トランスポート レベルではなく、SOAP メッセージ レベルで機密性、整合性、および認証を確保するための、SOAP メッセージングの機能拡張が規定されています。  
+  
+ 簡単に言えば、メッセージ セキュリティでは、メッセージごとにセキュリティ資格情報とクレームが署名や暗号化などのメッセージ保護措置と共にカプセル化さるという点で、トランスポート セキュリティと異なります。メッセージの内容を変更してメッセージに直接セキュリティを適用することによって、セキュリティで保護されたメッセージは、セキュリティ面で自己完結する形になります。これによって、トランスポート セキュリティでは実現できないシナリオが可能になります。  
+  
+## メッセージ セキュリティを使用する理由  
+ メッセージ レベルのセキュリティでは、すべてのセキュリティ情報がメッセージ内にカプセル化されます。トランスポート レベルのセキュリティではなく、メッセージ レベルのセキュリティを使用してメッセージをセキュリティで保護することによって、次の利点を得ることができます。  
+  
+-   エンドツーエンドのセキュリティ。SSL \(Secure Sockets Layer\) などのトランスポート セキュリティは、通信が Point\-to\-Point の場合にのみメッセージを保護します。メッセージが最終の受信者に到達する前に 1 つ以上の SOAP 中継局 \(ルーターなど\) にルーティングされる場合、中継局でネットワークからメッセージが読み取られると、そのメッセージ自体は保護されない状態になります。また、クライアントの認証情報は最初の中継局しか使用できず、必要に応じて帯域外の方法で、最終の受信者にその情報を再度転送する必要があります。これは、経路全体で各ホップ間に SSL セキュリティを使用している場合にも当てはまります。メッセージ セキュリティはメッセージに直接作用し、メッセージ内の XML をセキュリティで保護するので、メッセージが最終の受信者に到達するまでに経由する中継局の数に関係なく、メッセージをセキュリティで保護できます。これによって、真の意味でエンド ツー エンドのセキュリティ シナリオが実現します。  
+  
+-   柔軟性の向上。メッセージ全体ではなく、メッセージの一部を署名または暗号化できます。つまり、中継局は、その中継局に対して用意されたメッセージの一部を確認できます。メッセージ内の情報の一部を中継局に渡す必要があり、メッセージの改ざんを確実に防止する必要もある場合は、メッセージを暗号化せずに署名だけを行うことができます。署名はメッセージの一部なので、最終の受信者は受信メッセージ内の情報が元のままの状態であることを確認できます。シナリオの 1 つとして、Action ヘッダーの値に従ってメッセージをルーティングする SOAP 中継局サービスが考えられます。既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でメッセージ セキュリティを使用した場合、Action 値は暗号化されず、署名されます。この情報はすべての中継局で使用できますが、変更はできなくなります。  
+  
+-   複数のトランスポートに対するサポート。複数のトランスポートに対するサポート : セキュリティ用のプロトコルに依存することなく、名前付きパイプ、TCP などの複数の異なるトランスポートを経由して、セキュリティで保護されたメッセージを送信できます。トランスポート レベルのセキュリティでは、すべてのセキュリティ情報の有効範囲が 1 つの特定のトランスポート接続に限定されるので、メッセージの内容からその情報を使用することはできません。メッセージ セキュリティでは、メッセージの送信に使用するトランスポートの種類に関係なく、メッセージがセキュリティで保護されます。セキュリティ コンテキストはメッセージの内部に直接埋め込まれます。  
+  
+-   資格情報とクレームのセットを広範囲にサポート。メッセージ セキュリティは、SOAP メッセージの内部で任意の種類のクレームを送信できる拡張可能なフレームワークを提供する WS\-Security 仕様に基づいています。トランスポート セキュリティとは異なり、使用できる認証機構またはクレームはトランスポートの機能によって制限されません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ セキュリティには、複数の種類の認証とクレームの送信があります。必要に応じて、追加の種類がサポートされるように拡張できます。このため、たとえば、フェデレーション資格情報シナリオは、メッセージ セキュリティなしでは実現できません。WCF がサポートするフェデレーション シナリオ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+## メッセージ セキュリティとトランスポート セキュリティの比較  
+  
+### トランスポート レベルのセキュリティの利点と欠点  
+ トランスポート セキュリティの利点は次のとおりです。  
+  
+-   通信元と通信先では XML レベルのセキュリティ概念を理解する必要がありません。このため、たとえば、通信のセキュリティ保護に HTTPS が使用されている場合に相互運用性が向上します。  
+  
+-   パフォーマンスが全般的に向上します。  
+  
+-   ハードウェア アクセラレータを使用できます。  
+  
+-   ストリーミングが可能です。  
+  
+ トランスポート セキュリティの欠点は次のとおりです。  
+  
+-   セキュリティが提供されるのはホップからホップのみです。  
+  
+-   資格情報のセットが制限され、拡張はできません。  
+  
+-   トランスポートに依存します。  
+  
+### メッセージ レベルのセキュリティの欠点  
+ メッセージ セキュリティの欠点は次のとおりです。  
+  
+-   パフォーマンスがトランスポート セキュリティより劣ります。  
+  
+-   メッセージ ストリーミングを使用できません。  
+  
+-   XML レベルのセキュリティ機構の実装と WS\-Security 仕様のサポートが必要です。これは、相互運用性に影響する可能性があります。  
+  
+## 参照  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [方法 : トランスポート セキュリティとメッセージ資格情報を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md)   
+ [Microsoft Patterns and Practices, Chapter 3: Implementing Transport and Message Layer Security](http://go.microsoft.com/fwlink/?LinkId=88897)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-a-certificate-client.md b/docs/framework/wcf/feature-details/message-security-with-a-certificate-client.md
new file mode 100644
index 00000000000..45823601656
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-a-certificate-client.md
@@ -0,0 +1,154 @@
+---
+title: "メッセージ セキュリティと証明書クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99770573-c815-4428-a38c-e4335c8bd7ce
+caps.latest.revision: 16
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 16
+---
+# メッセージ セキュリティと証明書クライアント
+次のシナリオでは、メッセージ セキュリティ モードを使用して保護されている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントおよびサービスを示します。クライアントとサービスは、どちらも証明書を使用して認証されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][分散アプリケーションのセキュリティ](../../../../docs/framework/wcf/feature-details/distributed-application-security.md).  
+  
+ サンプル アプリケーションについては、「[メッセージ セキュリティ証明書](../../../../docs/framework/wcf/samples/message-security-certificate.md)」を参照してください。  
+  
+ ![証明書を持つクライアント](../../../../docs/framework/wcf/feature-details/media/clientwithcertificate.gif "ClientWithCertificate")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のみ|  
+|認証 \(サーバー\)|サービス証明書を使用|  
+|認証 \(クライアント\)|クライアント証明書を使用|  
+|整合性|○|  
+|機密性|○|  
+|トランスポート|HTTP|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、メッセージ セキュリティを使用するサービス エンドポイントを作成し、セキュリティで保護されたコンテキストを確立する方法を示しています。  
+  
+ [!code-csharp[C_SecurityScenarios#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#10)]
+ [!code-vb[C_SecurityScenarios#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#10)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="ServiceCredentialsBehavior">  
+          <serviceCredentials>  
+            <serviceCertificate findValue="Contoso.com"  
+                                x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service behaviorConfiguration="ServiceCredentialsBehavior"   
+               name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="MessageAndCerficiateClient"   
+                  name="SecuredByClientCertificate"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator">  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用する。次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントを作成する場合のコード例を次に示します。バインディングではメッセージ モード セキュリティを使用し、クライアント資格情報の種類は `Certificate` に設定します。  
+  
+ [!code-csharp[C_SecurityScenarios#17](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#17)]
+ [!code-vb[C_SecurityScenarios#17](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#17)]  
+  
+### 構成  
+ 次の構成は、エンドポイントの動作を使用してクライアント証明書を指定します。証明書の詳細については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。また、コード内で \<`identity`\> 要素を使用して、予想されるサーバー ID のドメイン ネーム システム \(DNS: Domain Name System\) を指定します。ID [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」を参照してください。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="endpointCredentialsBehavior">  
+          <clientCredentials>  
+            <clientCertificate findValue="Cohowinery.com"   
+               storeLocation="LocalMachine"  
+              x509FindType="FindBySubjectName" />  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://machineName/Calculator"   
+                behaviorConfiguration="endpointCredentialsBehavior"  
+                binding="wsHttpBinding"  
+                bindingConfiguration="WSHttpBinding_ICalculator"  
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator">  
+        <identity>  
+          <dns value="Contoso.com" />  
+        </identity>  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-a-user-name-client.md b/docs/framework/wcf/feature-details/message-security-with-a-user-name-client.md
new file mode 100644
index 00000000000..150780f11bb
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-a-user-name-client.md
@@ -0,0 +1,137 @@
+---
+title: "ユーザー名クライアントを使用したメッセージ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 36335cb9-76b8-4443-92c7-44f081eabb21
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# ユーザー名クライアントを使用したメッセージ セキュリティ
+メッセージ レベルのセキュリティで保護された [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスとクライアントを次の図に示します。サービスは X.509 証明書を使用して認証されます。クライアントはユーザー名とパスワードを使用して認証されます。  
+  
+ サンプル アプリケーションについては、「[メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)」を参照してください。  
+  
+ ![ユーザー名認証を使用する場合のメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/media/1fb10a61-7e1d-42f5-b1af-195bfee5b3c6.gif "1fb10a61\-7e1d\-42f5\-b1af\-195bfee5b3c6")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のみ|  
+|認証 \(サーバー\)|初期ネゴシエーションにはサーバー認証が必要|  
+|認証 \(クライアント\)|ユーザー名\/パスワード|  
+|整合性|はい、共有のセキュリティ コンテキストを使用します|  
+|機密性|はい、共有のセキュリティ コンテキストを使用します|  
+|トランスポート|HTTP|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、メッセージ セキュリティを使用するサービス エンドポイントの作成方法を示します。  
+  
+ [!code-csharp[C_SecurityScenarios#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#9)]
+ [!code-vb[C_SecurityScenarios#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#9)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="ServiceCredentialsBehavior">  
+          <serviceCredentials>  
+            <serviceCertificate findValue="Contoso.com"   
+                                storeLocation="LocalMachine"  
+                                storeName="My"     
+                                x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service behaviorConfiguration="ServiceCredentialsBehavior"  
+               name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="MessageAndUserName"  
+                  name="SecuredByTransportEndpoint"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="MessageAndUserName">  
+          <security mode="Message">              
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+  
+### コード  
+ クライアントを作成する場合のコード例を次に示します。バインディングはメッセージ モード セキュリティに対して行い、クライアント資格情報の種類は `UserName` に設定します。ユーザー名とパスワードの指定はコードを使用する場合に限られます \(構成可能ではありません\)。ユーザー名とパスワードを返すコードは、アプリケーション レベルで実行される必要があるため、ここには示しません。たとえば、Windows フォーム ダイアログ ボックスを使用してユーザーにデータを照会します。  
+  
+ [!code-csharp[C_SecurityScenarios#16](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#16)]
+ [!code-vb[C_SecurityScenarios#16](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#16)]  
+  
+### 構成  
+ クライアントを構成する場合のコード例を次に示します。バインディングはメッセージ モード セキュリティに対して行い、クライアント資格情報の種類は `UserName` に設定します。ユーザー名とパスワードの指定はコードを使用する場合に限られます \(構成可能ではありません\)。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://machineName/Calculator"   
+                binding="wsHttpBinding"  
+                bindingConfiguration="WSHttpBinding_ICalculator"   
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator">  
+        <identity>  
+          <dns value ="Contoso.com" />  
+        </identity>  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)   
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-a-windows-client-without-credential-negotiation.md b/docs/framework/wcf/feature-details/message-security-with-a-windows-client-without-credential-negotiation.md
new file mode 100644
index 00000000000..d92b6159e27
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-a-windows-client-without-credential-negotiation.md
@@ -0,0 +1,156 @@
+---
+title: "資格情報ネゴシエーションを使用しない Windows クライアントを使用するメッセージ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc07a26c-cbee-41c5-8fb0-329085fef749
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# 資格情報ネゴシエーションを使用しない Windows クライアントを使用するメッセージ セキュリティ
+次のシナリオは、Kerberos プロトコルによって保護される [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のクライアントとサービスを示します。  
+  
+ サービスとクライアントは、いずれも同じドメインまたは信頼できるドメインに配置されています。  
+  
+> [!NOTE]
+>  「[Windows クライアントとのメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/message-security-with-a-windows-client.md)」と異なり、このシナリオでは、アプリケーション メッセージを送信する前にサービスの資格情報をサービスとネゴシエートしません。  また、このシナリオでは Kerberos プロトコルを使用するので、Windows ドメイン環境が必要になります。  
+  
+ ![資格情報ネゴシエーションを使用しない場合のメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/media/0c9f9baa-2439-4ef9-92f4-43c242d85d0d.gif "0c9f9baa\-2439\-4ef9\-92f4\-43c242d85d0d")  
+  
+|特徴|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|○ Kerberos トークン プロファイル互換クライアントを使用する WS\-Security|  
+|認証 \(サーバー\)|サーバーとクライアントの相互認証|  
+|認証 \(クライアント\)|サーバーとクライアントの相互認証|  
+|整合性|はい|  
+|機密性|はい|  
+|Transport|HTTP|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、メッセージ セキュリティを使用するサービス エンドポイントを作成します。  このコードは、サービス資格情報のネゴシエーションとセキュリティ コンテキスト トークン \(SCT\) の確立を無効にします。  
+  
+> [!NOTE]
+>  ネゴシエートせずに Windows の資格情報を使用するには、サービスのユーザー アカウントが、Active Directory ドメインを使用して登録されたサービス プリンシパル名 \(SPN\) にアクセスする必要があります。  これは次の 2 つの方法で実行できます。  
+  
+1.  `NetworkService` アカウントまたは `LocalSystem` アカウントを使用してサービスを実行します。  これらのアカウントは、コンピューターが Active Directory ドメインに参加したときに確立されたコンピューターの SPN にアクセスできるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は適切な SPN 要素をサービスのメタデータ \(Web サービス記述言語 \(WSDL\)\) にあるサービスのエンドポイント内部に自動的に生成します。  
+  
+2.  任意の Active Directory ドメイン アカウントを使用してサービスを実行します。  この場合、そのドメイン アカウント用の SPN を確立する必要があります。  これを行うには、Setspn.exe ユーティリティ ツールを使用する方法があります。  サービスのアカウント用の SPN を作成したら、SPN をそのメタデータ \(WSDL\) を通じてサービスのクライアントに公開するように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を構成します。  これを行うには、アプリケーション構成ファイルまたはコードのどちらかを使用して、公開されるエンドポイントのエンドポイント ID を設定します。  プログラムで ID を公開する方法を次の例に示します。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)] SPN、Kerberos プロトコル、および Active Directory、「[Kerberos に関する技術的な補足 \(Windows 用\)](http://go.microsoft.com/fwlink/?LinkId=88330)」を参照してください。  エンドポイント ID[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)」を参照してください。  
+  
+ [!code-csharp[C_SecurityScenarios#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#12)]
+ [!code-vb[C_SecurityScenarios#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#12)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors />  
+    <services>  
+      <service behaviorConfiguration="" name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="KerberosBinding"  
+                  name="WSHttpBinding_ICalculator"  
+                  contract="ServiceModel.ICalculator"   
+                  listenUri="net.tcp://localhost/metadata" >  
+         <identity>  
+            <servicePrincipalName value="service_spn_name" />  
+         </identity>  
+        </endpoint>  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="KerberosBinding">  
+          <security>  
+            <message negotiateServiceCredential="false"   
+                     establishSecurityContext="false" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## Client  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。  代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。  次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントを構成する場合のコード例を次に示します。  セキュリティ モードは Message に設定され、クライアント資格情報の種類は Windows に設定されています。  <xref:System.ServiceModel.MessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティと <xref:System.ServiceModel.NonDualMessageSecurityOverHttp.EstablishSecurityContext%2A> プロパティには、`false` が設定されていることに注意してください。  
+  
+> [!NOTE]
+>  ネゴシエートせずに Windows の資格情報を使用するには、サービスとの通信を開始する前に、サービスのアカウントの SPN を使用してクライアントを構成する必要があります。  クライアントは SPN を使用して Kerberos トークンを取得し、サービスとの通信を認証し保護します。  サービスの SPN を使用してクライアントを構成する方法を次の例に示します。  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してクライアントを生成する場合に、サービスのメタデータ \(WSDL\) にサービスの SPN 情報が含まれていれば、サービスのメタデータからサービスの SPN が自動的にクライアントに伝達されます。  サービスのメタデータにその SPN を含めるようにサービスを構成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、このトピックの「サービス」を参照してください。  
+>   
+>  SPN、Kerberos、および Active Directory の詳細については、「[Kerberos に関する技術的な補足 \(Windows 用\)](http://go.microsoft.com/fwlink/?LinkId=88330)」を参照してください。  エンドポイント ID[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)」を参照してください。  
+  
+ [!code-csharp[C_SecurityScenarios#19](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#19)]
+ [!code-vb[C_SecurityScenarios#19](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#19)]  
+  
+### 構成  
+ クライアントを構成する場合のコード例を次に示します。  [\<servicePrincipalName\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md) 要素は、Active Directory ドメイン内でサービスのアカウント用に登録されたサービスの SPN と一致するように設定する必要があります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="Windows"   
+                     negotiateServiceCredential="false"  
+                     establishSecurityContext="false" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://localhost/Calculator"   
+                binding="wsHttpBinding"  
+                bindingConfiguration="WSHttpBinding_ICalculator"  
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator">  
+        <identity>  
+          <servicePrincipalName value="service_spn_name" />  
+        </identity>  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-a-windows-client.md b/docs/framework/wcf/feature-details/message-security-with-a-windows-client.md
new file mode 100644
index 00000000000..9426c495500
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-a-windows-client.md
@@ -0,0 +1,125 @@
+---
+title: "Windows クライアントとのメッセージ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 01e7d0b8-10f9-45c3-a4c5-53d44dc61eb8
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# Windows クライアントとのメッセージ セキュリティ
+このシナリオでは、メッセージ セキュリティ モードによって保護されている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントおよびサーバーを示します。クライアントとサービスは、Windows 資格情報を使用して認証します。  
+  
+ ![Windows クライアントを使用する場合のメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/media/1c8618d4-0005-4022-beb6-32fd087a8c3c.gif "1c8618d4\-0005\-4022\-beb6\-32fd087a8c3c")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のみ|  
+|認証 \(サーバー\)|サーバーとクライアントの相互認証|  
+|認証 \(クライアント\)|サーバーとクライアントの相互認証|  
+|整合性|はい、共有のセキュリティ コンテキストを使用します|  
+|機密性|はい、共有のセキュリティ コンテキストを使用します|  
+|トランスポート|NET.TCP|  
+|バインディング|<xref:System.ServiceModel.NetTcpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードでは、メッセージ セキュリティを使用するサービス エンドポイントを作成し、Windows コンピューターとの間にセキュリティで保護されたコンテキストを確立する方法を示します。  
+  
+ [!code-csharp[C_SecurityScenarios#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#11)]
+ [!code-vb[C_SecurityScenarios#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#11)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用して、サービスをセットアップできます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration=""  
+               name="ServiceModel.Calculator">  
+        <endpoint address="net.tcp://localhost:8008/Calculator"  
+                  binding="netTcpBinding"  
+                  bindingConfiguration="Windows"  
+                  name="WindowsOverMessage"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="Windows">  
+          <security mode="Message">  
+            <message clientCredentialType="Windows" />  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。例 :  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントを作成する場合のコード例を次に示します。バインディングはメッセージ モード セキュリティに対して行い、クライアント資格情報の種類は `Windows` に設定します。  
+  
+ [!code-csharp[C_SecurityScenarios#18](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#18)]
+ [!code-vb[C_SecurityScenarios#18](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#18)]  
+  
+### 構成  
+ 次の構成を使用してクライアントのプロパティを設定します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="NetTcpBinding_ICalculator" >  
+         <security mode="Message">  
+            <message clientCredentialType="Windows" />  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="net.tcp://machineName:8008/Calculator"   
+                binding="netTcpBinding"  
+                bindingConfiguration="NetTcpBinding_ICalculator"  
+                contract="ICalculator"  
+                name="NetTcpBinding_ICalculator">          
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-an-anonymous-client.md b/docs/framework/wcf/feature-details/message-security-with-an-anonymous-client.md
new file mode 100644
index 00000000000..36f1fbdbfb2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-an-anonymous-client.md
@@ -0,0 +1,143 @@
+---
+title: "メッセージ セキュリティと匿名クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cad53e1a-b7c9-4064-bc87-508c3d1dce49
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# メッセージ セキュリティと匿名クライアント
+次のシナリオでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] メッセージ セキュリティによって保護されているクライアントおよびサービスを示します。  設計目標は、トランスポート セキュリティではなくメッセージ セキュリティを使用することです。これによって将来、多様なクレームに基づくモデルをサポートできます。  承認に多様なクレームを使用する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)」を参照してください。  
+  
+ サンプル アプリケーションについては、「[メッセージ セキュリティ匿名](../../../../docs/framework/wcf/samples/message-security-anonymous.md)」を参照してください。  
+  
+ ![匿名クライアントを使用する場合のメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/media/b361a565-831c-4c10-90d7-66d8eeece0a1.gif "b361a565\-831c\-4c10\-90d7\-66d8eeece0a1")  
+  
+|特徴|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のみ|  
+|認証 \(サーバー\)|初期ネゴシエーションには、サーバー認証が必要ですが、クライアント認証は不要です|  
+|認証 \(クライアント\)|なし|  
+|整合性|はい、共有のセキュリティ コンテキストを使用します|  
+|機密性|はい、共有のセキュリティ コンテキストを使用します|  
+|Transport|HTTP|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、メッセージ セキュリティを使用するサービス エンドポイントの作成方法を示します。  
+  
+ [!code-csharp[C_SecurityScenarios#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#8)]
+ [!code-vb[C_SecurityScenarios#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#8)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用できます。  サービス動作要素を使用して、クライアントに対するサービスの認証に使用する証明書を指定します。  サービス要素は、`behaviorConfiguration` 属性を使用して動作を指定する必要があります。  バインド要素で、クライアント資格情報の種類が `None` であることを指定します。この資格情報の種類では、匿名クライアントがサービスを使用できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="ServiceCredentialsBehavior">  
+          <serviceCredentials>  
+            <serviceCertificate findValue="contoso.com"   
+                                storeLocation="LocalMachine"  
+                                storeName="My" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service behaviorConfiguration="ServiceCredentialsBehavior"   
+               name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="WSHttpBinding_ICalculator"   
+                  name="CalculatorService"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="None" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## Client  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。  代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。  次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントのインスタンスを作成するコード例を次に示します。  バインディングはメッセージ モード セキュリティを使用し、クライアント資格情報の種類は None に設定されます。  
+  
+ [!code-csharp[C_SecurityScenarios#15](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#15)]
+ [!code-vb[C_SecurityScenarios#15](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#15)]  
+  
+### 構成  
+ クライアントを構成する場合のコード例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="None" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://machineName/Calculator"  
+        binding="wsHttpBinding"  
+        bindingConfiguration="WSHttpBinding_ICalculator"   
+        contract="ICalculator"  
+        name="WSHttpBinding_ICalculator">  
+        <identity>  
+          <dns value="contoso.com" />  
+        </identity>  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [分散アプリケーションのセキュリティ](../../../../docs/framework/wcf/feature-details/distributed-application-security.md)   
+ [メッセージ セキュリティ匿名](../../../../docs/framework/wcf/samples/message-security-anonymous.md)   
+ [サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-issued-tokens.md b/docs/framework/wcf/feature-details/message-security-with-issued-tokens.md
new file mode 100644
index 00000000000..d4a6c0f391b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-issued-tokens.md
@@ -0,0 +1,28 @@
+---
+title: "発行済みトークンを使用したメッセージ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 731fc871-54d0-4689-90fd-1c9415c45621
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# 発行済みトークンを使用したメッセージ セキュリティ
+発行済みトークン クライアントにより、フェデレーション セキュリティのシナリオが [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で有効になります。  
+  
+ フェデレーション セキュリティにより独立したドメイン間で信頼を確立できます。各ドメインは、セキュリティ トークン サービスで認証と承認を集中管理します。このようなサービス間に信頼が確立されると、各ドメインのメンバーは相手のドメインのサービスを使用できます。  
+  
+ フェデレーション シナリオの詳細については、「[フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。  
+  
+## 参照  
+ [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/message-security-with-mutual-certificates.md b/docs/framework/wcf/feature-details/message-security-with-mutual-certificates.md
new file mode 100644
index 00000000000..f4b7823cc67
--- /dev/null
+++ b/docs/framework/wcf/feature-details/message-security-with-mutual-certificates.md
@@ -0,0 +1,168 @@
+---
+title: "メッセージ セキュリティと相互の証明書 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 99d7a528-7ae4-4d39-a0f9-3066ea237de0
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# メッセージ セキュリティと相互の証明書
+次のシナリオでは、メッセージ セキュリティ モードを使用して保護されている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスおよびクライアントを示します。クライアントとサービスは、証明書を使用して認証されます。  
+  
+ このシナリオは、X.509 証明書トークン プロファイルと共に WS\-Security を使用するため、相互運用性があります。  
+  
+> [!NOTE]
+>  このシナリオでは、サービス証明書のネゴシエーションは実行されません。通信を開始する前に、サービス証明書をクライアントに提供しておく必要があります。サーバー証明書は、アプリケーションと共に配布したり、帯域外通信で提供できます。  
+  
+ ![相互の証明書を使用する場合のメッセージ セキュリティ](../../../../docs/framework/wcf/feature-details/media/f4157312-b17c-416c-a5ee-fa7b54db211b.gif "f4157312\-b17c\-416c\-a5ee\-fa7b54db211b")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|○ WS\-Security および X.509 証明書トークン プロファイルと互換性があるクライアントとサービスで相互運用性があります。|  
+|認証|サーバーとクライアントの相互認証|  
+|整合性|○|  
+|機密性|○|  
+|トランスポート|HTTP|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成するが、エンドポイントを定義しない。  
+  
+### コード  
+ 次のコードでは、メッセージ セキュリティを使用するサービス エンドポイントを作成します。サービスには、自身を認証するための証明書が必要です。  
+  
+ [!code-csharp[C_SecurityScenarios#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#13)]
+ [!code-vb[C_SecurityScenarios#13](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#13)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用して、同じサービスを作成できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="serviceCredentialBehavior">  
+          <serviceCredentials>  
+            <serviceCertificate findValue="Contoso.com"   
+                                storeLocation="LocalMachine"  
+                                storeName="My"   
+                                x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service behaviorConfiguration="serviceCredentialBehavior"   
+               name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="InteropCertificateBinding"  
+                  name="WSHttpBinding_ICalculator"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="InteropCertificateBinding">  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate"  
+                     negotiateServiceCredential="false"  
+                     establishSecurityContext="false" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用する。次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントを作成する場合のコード例を次に示します。セキュリティ モードは Message に設定され、クライアント資格情報の種類は Certificate に設定されています。  
+  
+ [!code-csharp[C_SecurityScenarios#20](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#20)]
+ [!code-vb[C_SecurityScenarios#20](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#20)]  
+  
+### 構成  
+ 次のコードは、クライアントを構成します。クライアント証明書は、[\<clientCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md)を使用して指定する必要があります。また、サービス証明書は、[\<defaultCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md)を使用して指定します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientCredentialsBehavior">  
+          <clientCredentials>  
+            <clientCertificate findValue="Cohowinery.com"   
+                 storeLocation="CurrentUser"  
+                 storeName="My"  
+                 x509FindType="FindBySubjectName" />  
+            <serviceCertificate>  
+              <defaultCertificate findValue="Contoso.com"   
+                                  storeLocation="CurrentUser"  
+                                  storeName="TrustedPeople"  
+                                  x509FindType="FindBySubjectName" />  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate"   
+                     negotiateServiceCredential="false"  
+                     establishSecurityContext="false" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="http://machineName/Calculator"   
+                behaviorConfiguration="ClientCredentialsBehavior"  
+                binding="wsHttpBinding"   
+                bindingConfiguration="WSHttpBinding_ICalculator"  
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator">  
+        <identity>  
+          <certificate encodedValue="Encoded_Value_Not_Shown" />  
+        </identity>  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)   
+ [方法: 開発時にトランスポート セキュリティのために WCF の一時的な証明書を作成およびインストールする](http://go.microsoft.com/fwlink/?LinkId=244264)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/messaging-activities.md b/docs/framework/wcf/feature-details/messaging-activities.md
new file mode 100644
index 00000000000..e8f06483aa8
--- /dev/null
+++ b/docs/framework/wcf/feature-details/messaging-activities.md
@@ -0,0 +1,116 @@
+---
+title: "メッセージング アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8498f215-1823-4aba-a6e1-391407f8c273
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# メッセージング アクティビティ
+アクティビティを管理することで、ワークフローが WCF メッセージを送受信できるようになります。メッセージング アクティビティをワークフローに追加することで、任意に複雑なメッセージ交換パターン \(MEP\) をモデル化できます。  
+  
+## メッセージ交換パターン  
+ 基本的なメッセージ交換パターンは、次の 3 種類です。  
+  
+-   **データグラム** \- データグラム MEP を使用する場合は、クライアントがメッセージをサービスに送信しても、サービスは応答しません。これは、"ファイア アンド フォーゲット \(撃ち放し\)" と呼ばれる場合があります。このような交換では、配信の成否について帯域外での確認が必要になります。メッセージが移動中に失われて、サービスに到達しない可能性があります。クライアントが正常にメッセージを送信した場合でも、サービスがメッセージを受信したとは限りません。サービスは、メッセージングの不可欠な構成要素であり、これを基盤として独自の MEP を構築できます。  
+  
+-   **要求 \- 応答** \- 要求 \- 応答 MEP を使用する場合は、クライアントがメッセージをサービスに送信し、サービスは必要な処理を実行して、応答をクライアントに返します。パターンは、要求 \- 応答のペアで構成されます。要求 \- 応答呼び出しの例として、リモート プロシージャ コール \(RPC\) やブラウザー GET 要求などがあります。このパターンは、半二重とも呼ばれます。  
+  
+-   **二重** \- 二重 MEP を使用する場合は、クライアントとサービスが、任意の順番でメッセージを相互に送信できます。二重 MEP は、話される語の 1 つずつがメッセージである電話の会話に似ています。  
+  
+ メッセージング アクティビティを使用すると、これらの基本の MEP のほかに、任意の複雑な MEP を実装できます。  
+  
+## メッセージング アクティビティ  
+ [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] では、次のメッセージング アクティビティが定義されています。  
+  
+-   <xref:System.ServiceModel.Activities.Send>\- メッセージの送信には <xref:System.ServiceModel.Activities.Send> アクティビティを使用します。  
+  
+-   <xref:System.ServiceModel.Activities.SendReply> \- 受信したメッセージに対する応答の送信には、<xref:System.ServiceModel.Activities.SendReply> アクティビティを使用します。このアクティビティは、要求\/応答 MEP を実装した場合に、ワークフロー サービスによって使用されます。  
+  
+-   <xref:System.ServiceModel.Activities.Receive>\- メッセージの受信には <xref:System.ServiceModel.Activities.Receive> アクティビティを使用します。  
+  
+-   <xref:System.ServiceModel.Activities.ReceiveReply>\- 応答メッセージの受信には <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティを使用します。このアクティビティは、要求\/応答 MEP を実装した場合に、ワークフロー サービス クライアントによって使用されます。  
+  
+## メッセージング アクティビティとメッセージ交換パターン  
+ データグラム MEP には、メッセージを送信するクライアントとメッセージを受信するサービスが必要です。クライアントがワークフローの場合は、<xref:System.ServiceModel.Activities.Send> アクティビティを使用してメッセージを送信します。そのメッセージをワークフローで受信するには、<xref:System.ServiceModel.Activities.Receive> アクティビティを使用します。<xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.Receive> アクティビティのどちらにも、`Content` という名前のプロパティがあります。このプロパティには、送信または受信されるデータが保持されます。要求 \- 応答 MEP を実装する場合は、クライアントとサービスの両方で、アクティビティの組を使用します。クライアントは、<xref:System.ServiceModel.Activities.Send> アクティビティを使用してメッセージを送信し、<xref:System.ServiceModel.Activities.ReceiveReply> アクティビティを使用してサービスからの応答を受信します。これらの 2 つのアクティビティは、<xref:System.ServiceModel.Activities.ReceiveReply.Request%2A> プロパティによって互いに関連付けられています。このプロパティは、元のメッセージを送信した <xref:System.ServiceModel.Activities.Send> アクティビティに設定されます。サービスも、相互に関連付けられた、<xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.SendReply> というアクティビティのペアを使用します。これらの 2 つのアクティビティは、<xref:System.ServiceModel.Activities.SendReply.Request%2A> プロパティによって関連付けられています。このプロパティは、元のメッセージを受信した <xref:System.ServiceModel.Activities.Receive> アクティビティに設定されます。<xref:System.ServiceModel.Activities.ReceiveReply> アクティビティおよび <xref:System.ServiceModel.Activities.SendReply> アクティビティを使用すると、<xref:System.ServiceModel.Activities.Send> アクティビティおよび <xref:System.ServiceModel.Activities.Receive> アクティビティと同様に、<xref:System.ServiceModel.Channels.Message> インスタンスまたはメッセージ コントラクト型を送信できます。  
+  
+ ワークフローは長時間にわたって実行されることが多いため、通信の二重パターンでは、長時間のメッセージ交換をサポートすることも重要です。長時間のメッセージ交換をサポートするには、メッセージ交換を開始するクライアントが、後でデータが利用可能になった時点でクライアントにコールバックする機会をサービスに提供する必要があります。たとえば、マネージャーの承認を受けるために発注書の要求が送信された場合に、この要求が、1 日、1 週間、または 1 年間処理されない可能性があるとします。この場合、マネージャーが発注書を承認するワークフローは、承認を受けた後に再開することを認識している必要があります。この二重通信のパターンは、相関関係を使用するワークフローでサポートされています。二重パターンを実装するには、<xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.Receive> アクティビティを使用します。<xref:System.ServiceModel.Activities.Receive> アクティビティで、特殊なキー値の <xref:System.ServiceModel.Activities.CorrelationHandle.CallbackHandleName%2A> を使用して、相関関係を初期化します。<xref:System.ServiceModel.Activities.Send> アクティビティで、その関連付けハンドルを <xref:System.ServiceModel.Activities.Send.CorrelatesWith%2A> プロパティの値として設定します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][永続的な二重](../../../../docs/framework/wcf/feature-details/durable-duplex-correlation.md).  
+  
+> [!NOTE]
+>  ワークフローにコールバック相関関係を使用する二重 \("永続的な二重"\) を実装するのは、長時間のメッセージ交換のためです。これは、コールバック コントラクトを使用する WCF の二重と同じではありません。WCF の二重では、メッセージ交換が短時間 \(チャネルの有効期間\) で処理されます。  
+  
+## メッセージの書式設定とメッセージング アクティビティ  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティと <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティには、`Content` という名前のプロパティがあります。このプロパティは <xref:System.ServiceModel.Activities.ReceiveContent> 型で、<xref:System.ServiceModel.Activities.Receive> アクティビティまたは <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティが受信するデータを表します。.NET Framework では、<xref:System.ServiceModel.Activities.RecieveMessageContent> および <xref:System.ServiceModel.Activities.ReceiveParametersContent> という 2 つの関連クラスが定義されています。どちらも、<xref:System.ServiceModel.Activities.ReceiveContent> から派生しています。ワークフロー サービスでデータを受信するには、<xref:System.ServiceModel.Activities.Receive> アクティビティまたは <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティの `Content` プロパティを、これらの型のいずれかのインスタンスに設定します。どの型を使用するかは、アクティビティが受信するデータの型によって異なります。アクティビティが `Message` オブジェクト型またはメッセージ コントラクト型を受信する場合は、<xref:System.ServiceModel.Activities.ReceiveMessageContent> を使用します。シリアル化できるデータ コントラクトまたは XML 型をアクティビティが受信した場合には、<xref:System.ServiceModel.Activities.ReceiveParametersContent> を使用します。<xref:System.ServiceModel.Activities.ReceiveParametersContent> では複数のパラメーターを送信できますが、<xref:System.ServiceModel.Activities.ReceiveMessageContent> で送信できるのは、1 つのオブジェクト、つまり、メッセージ \(またはメッセージ コントラクト型\) のみです。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.Activities.ReceiveMessageContent> は、シリアル化できるデータ コントラクトまたは XML 型が 1 つだけの場合も使用できます。パラメーターが 1 つだけの <xref:System.ServiceModel.Activities.ReceiveParametersContent> を使用する場合と、<xref:System.ServiceModel.Activities.RecieveMessageContent> に直接渡されるオブジェクトとの違いは、ワイヤ形式です。パラメーターのコンテンツは、操作名に対応する XML 要素でラップされ、シリアル化されたオブジェクトは、パラメーター名を使用した XML 要素でラップされます \(例: `<Echo><msg>Hello, World</msg></Echo>`\)。メッセージの内容は、操作名によってラップされません。代わりに、シリアル化されたオブジェクトが、XML 修飾型の名前を使用して XML 要素内に格納されます \(例: `<string>Hello, World</string>`\)。  
+  
+ <xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.SendReply> アクティビティにも、`Content` という名前のプロパティがあります。このプロパティは <xref:System.ServiceModel.Activities.SendContent> 型で、<xref:System.ServiceModel.Activities.Send> アクティビティまたは <xref:System.ServiceModel.Activities.SendReply> アクティビティが送信するデータを表します。.NET Framework では、<xref:System.ServiceModel.Activities.SendMessageContent> および <xref:System.ServiceModel.Activities.SendParametersContent> という 2 つの関連型が定義されています。どちらも、<xref:System.ServiceModel.Activities.SendContent> から派生しています。ワークフロー サービスからデータを送信するには、<xref:System.ServiceModel.Activities.Send> アクティビティまたは <xref:System.ServiceModel.Activities.SendReply> アクティビティの `Content` プロパティを、これらの型のいずれかのインスタンスに設定します。どの型を使用するかは、アクティビティが送信するデータの型によって異なります。アクティビティが `Message` オブジェクト型またはメッセージ コントラクト型を送信する場合は、<xref:System.ServiceModel.Activities.SendMessageContent> を使用します。アクティビティがデータ コントラクト型を送信する場合は、<xref:System.ServiceModel.Activities.SendParametersContent> を使用します。<xref:System.ServiceModel.Activities.SendParametersContent> では複数のパラメーターを送信できますが、<xref:System.ServiceModel.Activities.SendMessageContent> で送信できるのは、1 つのオブジェクト、つまり、メッセージ \(またはメッセージ コントラクト型\) のみです。  
+  
+ 強制的にメッセージング アクティビティを使用してプログラミングを行う場合は、汎用の <xref:System.ServiceModel.Activities.InArgument%601> および <xref:System.ServiceModel.Activities.OutArgument%601> を使用して、メッセージまたは <xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.SendReply>、<xref:System.ServiceModel.Activities.Receive>、および <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティのパラメーター プロパティに割り当てるオブジェクトをラップします。<xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.SendReply> アクティビティには <xref:System.ServiceModel.Activities.InArgument%601> を、<xref:System.ServiceModel.Activities.Receive> アクティビティと <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティには <xref:System.ServiceModel.Activities.OutArgument%601> を使用します。`In` 引数は、データがアクティビティに渡されるため、送信アクティビティで使用されます。`Out` 引数は、データがアクティビティから渡されるため、受信アクティビティで使用されます。この例を次に示します。  
+  
+```  
+Receive reserveSeat = new Receive  
+{   
+    ...   
+    Content = new ReceiveParametersContent  
+    {  
+        Parameters =  
+        {  
+            { "ReservationInfo", new OutArgument<ReservationRequest>(reservationInfo) }  
+        }  
+    }  
+};  
+SendReply reserveSeat = new SendReply  
+{   
+    ...   
+    Request = reserveSeat,  
+    Content = new SendParametersContent  
+    {  
+        Parameters =  
+        {  
+            { "ReservationId", new InArgument<string>(reservationId) }  
+        }  
+    },  
+};  
+```  
+  
+ void を返す要求\/応答操作を定義するワークフロー サービスを実装する場合は、<xref:System.ServiceModel.Activities.SendReply> アクティビティをインスタンス化して、<xref:System.ServiceModel.Activities.SendReply.Content%2A> プロパティをコンテンツの種類 \(<xref:System.ServiceModel.Activities.SendMesageContent> または <xref:System.ServiceModel.Activities.SendParametersContent>\) のいずれかのインスタンスに設定します。この例を次に示します。  
+  
+```  
+Receive rcv = new Receive()  
+{  
+ServiceContractName = "IService",  
+OperationName = "NullReturningContract",  
+Content = new ReceiveParametersContent( new Dictionary<string, OutArgument>() { { "message", new OutArgument<string>() } } )  
+};  
+SendReply sr = new SendReply()  
+{  
+Request = rcv  
+   Content = new SendParametersContent();  
+};  
+  
+```  
+  
+## サービス参照の追加  
+ ワークフロー アプリケーションからワークフロー サービスを呼び出すと、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] では、要求\/応答 MEP で使用される通常の <xref:System.ServiceModel.Activities.Send> アクティビティと <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティをカプセル化したカスタムのメッセージング アクティビティが生成されます。この機能を使用するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でクライアント プロジェクトを右クリックして、**\[サービス参照の追加\]** をクリックします。アドレス ボックスにサービスのベース アドレスを入力し、\[移動\] をクリックします。使用可能なサービスが、**\[サービス\]** ボックスに表示されます。サービス ノードを展開して、サポートされるコントラクトを表示します。呼び出すコントラクトを選択すると、使用可能な操作の一覧が **\[操作\]** ボックスに表示されます。生成されたアクティビティの名前空間を指定し、**\[OK\]** をクリックします。操作が正常に完了したことを示すダイアログが表示され、プロジェクトを再度ビルドすると、生成されたカスタム アクティビティがツールボックスに表示されます。サービス コントラクトに定義されている操作ごとに 1 つのアクティビティがあります。プロジェクトを再度ビルドしたら、カスタム アクティビティをワークフローにドラッグ アンド ドロップして、必要なプロパティをプロパティ ウィンドウで設定できます。  
+  
+## メッセージング アクティビティ テンプレート  
+ クライアントとサービスでの要求\/応答 MEP の設定を簡単にするため、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] では、2 種類のメッセージング アクティビティ テンプレートが提供されています。<xref:System.ServiceModel.Activities.Design.ReceiveAndSendReply> はサービスで、<xref:System.ServiceModel.Activities.Design.SendAndReceiveReply> はクライアントで使用されます。どちらの場合も、テンプレートによって、適切なメッセージング アクティビティがワークフローに追加されます。サービスの場合、<xref:System.ServiceModel.Activities.Design.ReceiveAndSendReply> は <xref:System.ServiceModel.Activities.Receive> アクティビティを追加し、次に <xref:System.ServiceModel.Activities.SendReply> アクティビティを追加します。<xref:System.ServiceModel.Activities.SendReply.Request> プロパティは自動的に <xref:System.ServiceModel.Activities.Receive> アクティビティに設定されます。クライアントの場合、<xref:System.ServiceModel.Activities.Design.SendAndReceiveReply> は <xref:System.ServiceModel.Activities.Send> アクティビティを追加し、次に <xref:System.ServiceModel.Activities.ReceiveReply> アクティビティを追加します。<xref:System.ServiceModel.Activities.ReceiveReply.Request%2A> プロパティは自動的に <xref:System.ServiceModel.Activities.Send> アクティビティに設定されます。これらのテンプレートは、適切なテンプレートをワークフローにドラッグ アンド ドロップするだけで使用できます。  
+  
+## メッセージング アクティビティとトランザクション  
+ ワークフロー サービスが呼び出されるときに、サービス操作にトランザクションをフローする必要がある場合があります。それには、<xref:System.ServiceModel.Activities.Receive> アクティビティを <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティ内に配置します。<xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティには、`Receive` アクティビティと本体が含まれます。サービスにフローされるトランザクションは、<xref:System.ServiceModel.Activities.TransactedReceiveScope> の本体の実行の開始から終了まで、アンビエント トランザクションのままです。トランザクションは、本体の実行が終了した時点で完了します。ワークフローとトランザクション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー トランザクション](../../../../docs/framework/windows-workflow-foundation//workflow-transactions.md)」を参照してください。  
+  
+## 参照  
+ [ワークフロー サービスでエラーを送受信する方法](http://go.microsoft.com/fwlink/?LinkId=189151)   
+ [長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/messaging-protocols.md b/docs/framework/wcf/feature-details/messaging-protocols.md
new file mode 100644
index 00000000000..2bbc7e4357d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/messaging-protocols.md
@@ -0,0 +1,717 @@
+---
+title: "メッセージング プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b20bca7-87b3-4c8f-811b-f215b5987104
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# メッセージング プロトコル
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] チャネル スタックは、エンコーディングとトランスポート チャネルを使用して、内部メッセージ表現をワイヤ形式に変換し、特定のトランスポートを使用して送信します。Web サービスの相互運用性を確保するために、最も一般的に使用されるトランスポートは HTTP です。また、Web サービスが使用する最も一般的なエンコーディングは、XML ベースの SOAP 1.1、SOAP 1.2、および MTOM \(Message Transmission Optimization Mechanism\) です。  
+  
+ このトピックでは、<xref:System.ServiceModel.Channels.HttpTransportBindingElement> で使用する以下のプロトコルに関する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装の詳細について説明します。  
+  
+|仕様\/ドキュメント|リンク|  
+|----------------|---------|  
+|HTTP 1.1|http:\/\/www.ietf.org\/rfc\/rfc2616.txt|  
+|SOAP 1.1 HTTP バインディング|http:\/\/www.w3.org\/TR\/2000\/NOTE\-SOAP\-20000508\/、セクション 7|  
+|SOAP 1.2 HTTP バインディング|http:\/\/www.w3.org\/TR\/soap12\-part2\/、セクション 7|  
+  
+ ここでは、<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> および <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> で使用する以下のプロトコルに関する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装の詳細について説明します。  
+  
+|仕様\/ドキュメント|リンク|  
+|----------------|---------|  
+|XML|http:\/\/www.w3.org\/TR\/REC\-xml|  
+|SOAP 1.1|http:\/\/www.w3.org\/TR\/2000\/NOTE\-SOAP\-20000508\/|  
+|SOAP 1.2 コア|http:\/\/www.w3.org\/TR\/soap12\-part1\/|  
+|WS\-Addressing 2004\/08|http:\/\/www.w3.org\/Submission\/2004\/SUBM\-ws\-addressing\-20040810\/|  
+|W3C Web Services Addressing 1.0 \- コア|http:\/\/www.w3.org\/TR\/2006\/REC\-ws\-addr\-core\-20060509|  
+|W3C Web Services Addressing 1.0 \- SOAP バインディング|http:\/\/www.w3.org\/TR\/2006\/REC\-ws\-addr\-soap\-20060509|  
+|W3C Web Services Addressing 1.0 \- WSDL バインディング|http:\/\/www.w3.org\/TR\/2006\/CR\-ws\-addr\-wsdl\-20060529\/|  
+|W3C Web Services Addressing 1.0 \- メタデータ|http:\/\/www.w3.org\/TR\/ws\-addr\-metadata\/|  
+|WSDL SOAP1.1 バインディング|http:\/\/www.w3.org\/TR\/wsdl\/|  
+|WSDL SOAP1.2 バインディング|http:\/\/www.w3.org\/Submission\/wsdl11soap12\/|  
+  
+ ここでは、<xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> で使用する以下のプロトコルに関する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装の詳細について説明します。  
+  
+|仕様\/ドキュメント|リンク|  
+|----------------|---------|  
+|XOP|http:\/\/www.w3.org\/TR\/xop10\/|  
+|MTOM および SOAP 1.2 バインディング|http:\/\/www.w3.org\/TR\/soap12\-mtom\/|  
+|MTOM SOAP 1.1 バインディング|http:\/\/www.w3.org\/Submission\/soap11mtom10\/|  
+|MTOM WS\-Policy アサーション|http:\/\/www.w3.org\/Submission\/2006\/SUBM\-WS\-MTOMPolicy\-20061101\/|  
+  
+ ここでは、次の XML 名前空間と関連付けられたプレフィックスが使用されます。  
+  
+|プレフィックス|名前空間 URI \(Uniform Resource Identifier\)|  
+|-------------|----------------------------------------------|  
+|s11|http:\/\/schemas.xmlsoap.org\/soap\/envelope|  
+|s12|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|wsa|http:\/\/www.w3.org\/2004\/08\/addressing|  
+|wsam|http:\/\/www.w3.org\/2007\/05\/addressing\/metadata|  
+|wsap|http:\/\/schemas.xmlsoap.org\/ws\/2004\/09\/policy\/addressing|  
+|wsa10|http:\/\/www.w3.org\/2005\/08\/addressing|  
+|wsaw10|http:\/\/www.w3.org\/2006\/05\/addressing\/wsdl|  
+|xop|http:\/\/www.w3.org\/2004\/08\/xop\/include|  
+|xmime|http:\/\/www.w3.org\/2004\/06\/xmlmime<br /><br /> http:\/\/www.w3.org\/2005\/05\/xmlmime|  
+|cdp|http:\/\/schemas.microsoft.com\/net\/2006\/06\/duplex|  
+  
+## SOAP 1.1 と SOAP 1.2  
+  
+### エンベロープと処理モデル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Basic Profile 1.1 \(BP11\) および Basic Profile 1.0 \(SSBP10\) に従って、SOAP 1.1 エンベロープの処理を実装しています。SOAP 1.2 エンベロープの処理は、SOAP12\-Part1 に従って実装されます。  
+  
+ このセクションでは、BP11 および SOAP12\-Part1 に関して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で選択されている一部の実装について説明します。  
+  
+#### 必須のヘッダー処理  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAP 1.1 仕様と SOAP 1.2 仕様に記載されたルールに従って、`mustUnderstand` としてマークされたヘッダーを次のように処理します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル スタックに入ったメッセージは、関連付けられたバインド要素 \(テキスト メッセージ エンコーディング、セキュリティ、信頼できるメッセージング、トランザクションなど\) によって構成された個々のチャネルで処理されます。各チャネルは、関連付けられた名前空間からヘッダーを認識し、認識済みとしてマークします。メッセージがディスパッチャーに入ると、操作フォーマッタは対応するメッセージ コントラクトと操作コントラクトで想定されたヘッダーを読み取り、認識済みとしてマークします。次に、ディスパッチャーは、`mustUnderstand` としてマークされているにもかかわらず、認識されていないヘッダーが残っていないかどうかを検証し、例外をスローします。受信者を対象とする `mustUnderstand` ヘッダーが含まれたメッセージが、受信者のアプリケーション コードで処理されることはありません。  
+  
+ このようなレイヤー化された処理により、SOAP ノードのインフラストラクチャ レイヤーとアプリケーション レイヤーを次のように分離することが可能になります。  
+  
+-   B1111 : 認識されていないヘッダーは、メッセージが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャ チャネル スタックによって処理された後、アプリケーションによって処理される前に検出されます。  
+  
+     `mustUnderstand` ヘッダーの値は、SOAP 1.1 と SOAP 1.2 で異なります。Basic Profile 1.1 では、SOAP 1.1 メッセージの `mustUnderstand` の値が 0 または 1 である必要があります。SOAP 1.2 では、値として 0、1、`false`、および `true` を使用できますが、`xs:boolean` 値の正規表現 \(`false`、`true`\) を出力することをお勧めします。  
+  
+-   B1112: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAP 1.1 および SOAP 1.2 の両方のバージョンの SOAP エンベロープで、`mustUnderstand` の値として 0 と 1 を出力します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`mustUnderstand` ヘッダーの `xs:boolean` の値空間全体 \(0、1、`false`、`true`\) を受け入れます。  
+  
+#### SOAP エラー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 固有の SOAP エラー実装を以下に示します。  
+  
+-   B2121 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`s11:mustUnderstand`、`s11:Client`、および `s11:Server` の各 SOAP 1.1 エラー コードを返します。  
+  
+-   B2122 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`s12:MustUnderstand`、`s12:Sender`、および `s12:Receiver` の各 SOAP 1.2 エラー コードを返します。  
+  
+### HTTP バインディング  
+  
+#### SOAP 1.1 HTTP バインディング  
+ 次に説明するように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Basic Profile 1.1 仕様のセクション 3.4 に従って、SOAP1.1 HTTP バインディングを実装しています。  
+  
+-   B2211 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、HTTP POST 要求のリダイレクトを実装していません。  
+  
+-   B2212 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは、セクション 3.4.8 に従って HTTP クッキーをサポートします。  
+  
+#### SOAP 1.2 HTTP バインディング  
+ 次に説明するように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAP 1.2\-part 2 \(SOAP12Part2\) 仕様に従って、SOAP 1.2 HTTP バインディングを実装しています。  
+  
+ SOAP 1.2 では、`application/soap+xml` メディア タイプの省略可能なアクション パラメーターが導入されました。このパラメーターは、WS\-Addressing を使用していない場合に、SOAP メッセージの本文を解析する必要なく、メッセージ ディスパッチを最適化する際に役立ちます。  
+  
+-   R2221 : `application/soap+xml` のアクション パラメーターが SOAP 1.2 要求に含まれている場合、対応する WSDL バインディング内の `wsoap12:operation` 要素の `soapAction` 属性と一致する必要があります。  
+  
+-   R2222 : WS\-Addressing 2004\/08 または WS\-Addressing 1.0 を使用しているときに、`application/soap+xml` のアクション パラメーターが SOAP 1.2 メッセージに含まれている場合、`wsa:Action` と一致する必要があります。  
+  
+ WS\-Addressing が無効になっているときに、受信要求にアクション パラメーターが含まれていない場合、メッセージの `Action` は指定されていないものと見なされます。  
+  
+## WS\-Addressing  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Addressing の次の 3 つのバージョンを実装しています。  
+  
+-   WS\-Addressing 2004\/08  
+  
+-   W3C Web Services Addressing 1.0 コア \(ADDR10\-CORE\) \- SOAP バインディング \(ADDR10\-SOAP\)  
+  
+-   WS\-Addressing 1.0 \- メタデータ  
+  
+### エンドポイント参照  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で実装されている WS\-Addressing のすべてのバージョンでは、エンドポイント参照を使用してエンドポイントを記述します。  
+  
+#### エンドポイント参照と WS\-Addressing のバージョン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、特に `EndpointReference` 要素と `W3C.WsAddressing.EndpointReferenceType` クラスで WS\-Addressing を使用する多数のインフラストラクチャ プロトコルを実装しています \(WS\-ReliableMessaging、WS\-SecureConversation、WS\-Trust など\)。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、いずれかのバージョンの WS\-Addressing を他のインフラストラクチャ プロトコルと共に使用できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、エンドポイントごとに WS\-Addressing の 1 つのバージョンをサポートします。  
+  
+ R3111 では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントと交換されるメッセージで使用する `EndpointReference` 要素または型の名前空間は、そのエンドポイントで実装されている WS\-Addressing のバージョンに適合する必要があります。  
+  
+ たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントが WS\-ReliableMessaging を実装している場合、`CreateSequenceResponse` 内でこのようなエンドポイントによって返される `AcksTo` ヘッダーでは、そのエンドポイントの `EncodingBinding` 要素で指定された WS\-Addressing のバージョンを使用します。  
+  
+#### エンドポイント参照とメタデータ  
+ 多くのシナリオでは、指定されたエンドポイントのメタデータまたはメタデータへの参照を伝達する必要があります。  
+  
+ B3121 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-MetadataExchange \(MEX\) 仕様のセクション 6 に記載された機構を使用して、エンドポイント参照のメタデータを値または参照で含めます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが http:\/\/sts.fabrikam123.com のトークン発行者によって発行された SAML \(Security Assertions Markup Language\) トークンを使用して、認証を行う必要があるシナリオについて考えてみます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントでは、トークン発行者を指し示す `sp:Issuer` アサーションが入れ子になった `sp:IssuedToken` アサーションを使用して、この認証要件が記述されます。`sp:Issuer` アサーションにアクセスするクライアント アプリケーションは、トークン発行者のエンドポイントとの通信方法を知る必要があります。クライアントは、トークン発行者に関するメタデータを知る必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、MEX で定義されたエンドポイント参照のメタデータ拡張を使用して、トークン発行者のメタデータへの参照を提供します。  
+  
+```  
+<sp:IssuedToken>  
+  <sp:Issuer>  
+    <wsa10:Address>  
+      http://sts.fabrikam123.com  
+    </wsa10:Address>  
+    <wsa10:Metadata>  
+      <mex:Metadata>  
+        <mex:MetadataSection>  
+          <mex:MetadataReference>  
+            <wsa10:Address>  
+              http://sts.fabrikam123.com/mex  
+            </wsa10:Address>  
+          </mex:MetadataReference>  
+        </mex:MetadataSection>  
+      </mex:Metadata>  
+    </wsa10:Metadata>  
+  </sp:Issuer>  
+</sp:IssuedToken>  
+  
+```  
+  
+### メッセージのアドレス指定ヘッダー  
+  
+#### メッセージ ヘッダー  
+ WS\-Addressing の両方のバージョンで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は仕様で規定された `wsa:To`、 `wsa:ReplyTo`、 `wsa:Action`、 `wsa:MessageID`、、および  `wsa:RelatesTo` の各メッセージ ヘッダーを使用します。  
+  
+ B3211 : WS\-Addressing のすべてのバージョンで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsa:FaultTo` および `wsa:From` の各 WS\-Addressing メッセージ ヘッダーを受け入れますが、これらのヘッダーを独自に生成することはありません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションとやり取りするアプリケーションは、これらのメッセージ ヘッダーを追加できます。追加されたヘッダーは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって適切に処理されます。  
+  
+#### 参照パラメーターと参照プロパティ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、それぞれの仕様に従って、エンドポイントの参照パラメーターと  
+  
+ 参照プロパティの処理を実装しています。  
+  
+ B3221 : WS\-Addressing 2004\/08 を使用するように構成されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、参照プロパティと参照パラメーターの処理を区別しません。  
+  
+### メッセージ交換パターン  
+ Web サービス操作呼び出しに関連するメッセージ シーケンスは、*"メッセージ交換パターン"* と呼ばれます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、一方向、要求\/応答、および双方向の各メッセージ交換パターンをサポートしています。このセクションでは、使用するメッセージ交換パターンによって異なるメッセージ処理に関する WS\-Addressing の要件について説明します。  
+  
+ このセクション全体を通して、リクエスターが最初のメッセージを送信し、レスポンダーが最初のメッセージを受信します。  
+  
+#### 一方向のメッセージ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントが一方向パターンに従うために、指定の `Action` を含むメッセージをサポートするように構成されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、次の動作と要件に従います。他に特に指定がなければ、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされている WS\-Addressing の両方のバージョンに対して動作とルールが適用されます。  
+  
+-   R3311 : リクエスターは、`wsa:To`、`wsa:Action`、およびエンドポイント参照によって指定されたすべての参照パラメーターのヘッダーを含める必要があります。WS\-Addressing 2004\/08 を使用し、エンドポイント参照によって参照プロパティが指定されている場合、対応するヘッダーもメッセージに追加する必要があります。  
+  
+-   B3312 : リクエスターは、`MessageID`、`ReplyTo`、および `FaultTo` の各ヘッダーを含めることができます。受信側のインフラストラクチャはこれらのヘッダーを無視し、ヘッダーはアプリケーションに渡されます。  
+  
+-   R3313 : HTTP を使用し、HTTP 応答レッグで送信するメッセージがない場合、レスポンダーは空の本文と HTTP 202 ステータス コードを含む HTTP 応答を送信する必要があります。  
+  
+     HTTP トランスポートを使用しており、操作コントラクトで一方向のメッセージが宣言されている場合でも、HTTP 応答を使用してインフラストラクチャ メッセージを送信できます。たとえば、信頼できるメッセージングでは、HTTP 応答で `SequenceAcknowledgement` メッセージを送信できます。  
+  
+-   B3314 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、一方向メッセージへの応答でエラー メッセージを送信しません。  
+  
+#### 要求\/応答  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントが要求\/応答パターンに従うために、指定の `Action` を含むメッセージに対応するように構成されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、以下の動作と要件に従います。他に特に指定がなければ、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされている WS\-Addressing の両方のバージョンに対して動作とルールが適用されます。  
+  
+-   R3321 : リクエスターは、`wsa:To`、`wsa:Action`、`wsa:MessageID`、およびエンドポイント参照によって指定されたすべての参照パラメーターまたは参照プロパティ \(または両方\) のヘッダーを要求に含める必要があります。  
+  
+-   R3322 : WS\-Addressing 2004\/08 を使用する場合、`ReplyTo` も要求に含める必要があります。  
+  
+-   R3323 : WS\-Addressing 1.0 を使用し、`ReplyTo` が要求に含まれていない場合、\[address\] プロパティが "http:\/\/www.w3.org\/2005\/08\/addressing\/anonymous" である既定のエンドポイント参照が使用されます。  
+  
+-   R3324 : リクエスターは、`wsa:To`、`wsa:Action`、および `wsa:RelatesTo` の各ヘッダーを応答メッセージに含め、`ReplyTo` エンドポイント参照によって指定されたすべての参照パラメーターまたは参照プロパティ \(または両方\) のヘッダーを要求に含める必要があります。  
+  
+### Web Services Addressing エラー  
+ R3411 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Addressing 2004\/08 で定義された以下のエラーを生成します。  
+  
+|コード|原因|  
+|---------|--------|  
+|wsa:DestinationUnreachable|このチャネル用に確立された応答アドレスとは異なる `ReplyTo` を使用してメッセージが到着しました。To ヘッダーに指定されたアドレスをリッスンしているエンドポイントはありません。|  
+|wsa:ActionNotSupported|`Action` ヘッダーに指定されたアクションは、エンドポイントに関連付けられたインフラストラクチャ チャネルまたはディスパッチャーによって認識されません。|  
+  
+ R3412 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Addressing 1.0 で定義された以下のエラーを生成します。  
+  
+|コード|原因|  
+|---------|--------|  
+|wsa10:InvalidAddressingHeader|`wsa:To`、`wsa:ReplyTo`、`wsa:From` 、または `wsa:MessageID` が重複しています。同じ `RelationshipType` を使用する `wsa:RelatesTo`  が重複しています。|  
+|wsa10:MessageAddressingHeaderRequired|必須の Addressing ヘッダーがありません。|  
+|wsa10:DestinationUnreachable|このチャネル用に確立された応答アドレスとは異なる `ReplyTo` を使用してメッセージが到着しました。To ヘッダーに指定されたアドレスをリッスンしているエンドポイントはありません。|  
+|wsa10:ActionNotSupported|`Action` ヘッダーに指定されたアクションは、エンドポイントに関連付けられたインフラストラクチャ チャネルまたはディスパッチャーによって認識されません。|  
+|wsa10:EndpointUnavailable|RM チャネルは、`CreateSequence` メッセージのアドレス指定ヘッダーの検査に基づいて、エンドポイントでシーケンスが処理されないことを示すために、このエラーを返しました。|  
+  
+ 上記の 2 つの表に示すコードは、SOAP 1.1 の `FaultCode`、および SOAP 1.2 の `SubCode` \(Code\=Sender\) に対応付けられています。  
+  
+### WSDL 1.1 バインディングと WS\-Policy アサーション  
+  
+#### WS\-Addressing の使用の提示  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ポリシー アサーションを使用して、エンドポイントが WS\-Addressing の特定のバージョンをサポートすることを示します。  
+  
+ 次のポリシー アサーションには、エンドポイント ポリシー サブジェクト \[WS\-PA\] が含まれており、そのエンドポイントで送受信されるメッセージでは WS\-Addressing 2004\/08 を使用する必要があることを示しています。  
+  
+```  
+<wsap:UsingAddressing />  
+```  
+  
+ このポリシー アサーションは、WS\-Addressing 2004\/08 仕様を補うものです。  
+  
+ 次のポリシー アサーションは、送受信されるメッセージでは WS\-Addressing 1.0 を使用する必要があることを示しています。  
+  
+```vb  
+<wsam:Addressing/>   
+```  
+  
+ 次のポリシー アサーションには、エンドポイント ポリシー サブジェクト \[WS\-PA\] が含まれており、そのエンドポイントで送受信されるメッセージでは WS\-Addressing 2004\/08 を使用する必要があることを示しています。  
+  
+```  
+<wsaw10:UsingAddressing />  
+```  
+  
+ `wsaw10:UsingAddressing` 要素は、WS\-Addressing\-WSDL から借用したものです。この要素は、この仕様のセクション 3.1.2 に従って、WS\-Policy のコンテキストで使用されます。  
+  
+ Addressing を使用しても、WSDL 1.1、SOAP 1.1、および SOAP 1.2 HTTP バインディングのセマンティクスが変更されるわけではありません。たとえば、Addressing と WSDL SOAP 1.x HTTP バインディングを使用するエンドポイントに送信する要求に対して応答が求められている場合、この応答は HTTP 応答を使用して送信する必要があります。  
+  
+ HTTP 応答を使用して送信された応答の場合、WS\-AM アサーションは次のようになります。  
+  
+```xml  
+<wsam:AnonymousResponses/>  
+```  
+  
+ 完全なポリシー アサーションは次のようになる場合があります。  
+  
+```xml  
+<wsam:Addressing>  
+    <wsp:Policy>  
+        <wsam:AnonymousResponses />   
+    </wsp:Policy>  
+</wsam:Addressing>  
+```  
+  
+ ただし、リクエスターとレスポンダー間で 2 つの独立した逆方向の HTTP 接続を確立することによってメリットのあるメッセージ交換パターンがあります。たとえば、レスポンダーによって送信される要求されていない一方向のメッセージなどです。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、基になる 2 つのトランスポート チャネルで、一方のチャネルを入力メッセージに使用し、もう一方を出力メッセージに使用する複合二重チャネルを形成できる機能が用意されています。HTTP トランスポートの場合、複合二重によって 2 つの逆方向の HTTP 接続が実現します。一方の接続はリクエスターがレスポンダーにメッセージを送信するために使用し、もう一方はレスポンダーがリクエスターにメッセージを返すために使用します。  
+  
+ 個別の HTTP 要求を使用して送信された応答の場合、WS\-AM アサーションは次のようになります。  
+  
+```xml  
+<wsam:NonAnonymousResponses/>  
+```  
+  
+ 完全なポリシー アサーションは次のようになる場合があります。  
+  
+```xml  
+<wsam:Addressing>  
+    <wsp:Policy>  
+      <wsam:NonAnonymousResponses />   
+   </wsp:Policy>  
+  </wsam:Addressing>  
+```  
+  
+ WSDL 1.1 SOAP 1.x HTTP バインディングを使用するエンドポイントで、エンドポイント ポリシー サブジェクト \[WS\-PA\] を含む次のアサーションを使用する場合、リクエスターからレスポンダーおよびレスポンダーからリクエスターへのメッセージ フローにそれぞれ別の逆方向の HTTP 接続を使用する必要があります。  
+  
+```  
+<cdp:CompositeDuplex/>  
+```  
+  
+ 上記のステートメントにより、要求メッセージの `wsa:ReplyTo` ヘッダーに関する以下の要件が発生します。  
+  
+-   R3514 : エンドポイントが WSDL 1.1 SOAP 1.x HTTP バインディングを使用しており、`wsap10:UsingAddressing` アサーションまたは `wsap:UsingAddressing` アサーションを含み、`cdp:CompositeDuplex` が関連付けられたポリシー代替手段を持つ場合、エンドポイントに送信する要求メッセージには、`[address]` プロパティが "http:\/\/www.w3.org\/2005\/08\/addressing\/anonymous" ではない `ReplyTo` ヘッダーが必要です。  
+  
+-   R3515 : エンドポイントに送信する要求メッセージには、`[address]` プロパティが "http:\/\/www.w3.org\/2005\/08\/addressing\/anonymous" である `ReplyTo` ヘッダーが必要です。エンドポイントが WSDL 1.1 SOAP 1.x HTTP バインディングを使用しており、`wsap10:UsingAddressing` アサーションを含み、`cdp:CompositeDuplex` アサーションが関連付けられていないポリシー代替手段を持つ場合、`ReplyTo` ヘッダーはまったく必要ありません。  
+  
+-   R3516 : エンドポイントが WSDL 1.1 SOAP 1.x HTTP バインディングを使用しており、`wsap:UsingAddressing` アサーションを含み、`cdp:CompositeDuplex` アサーションが関連付けられていないポリシー代替手段を持つ場合、エンドポイントに送信する要求メッセージには、`[address]` プロパティが "http:\/\/www.w3.org\/2005\/08\/addressing\/anonymous" である `ReplyTo` ヘッダーが必要です。  
+  
+ WS\-Addressing の WSDL 仕様では、`wsa:ReplyTo` ヘッダーの要件を示す 3 つのテキスト値 \(required、optional、および prohibited\) を持つ `<wsaw:Anonymous/>` 要素を導入することにより、同様のプロトコル バインディングを記述することを試みています \(セクション 3.2\)。残念ながら、このような要素の定義では、要素をアサーションとして使用する代替手段の共通部分をサポートするために、ドメイン固有の拡張を必要とするため、特に WS\-Policy のコンテキストではアサーションとして使用することはできません。また、このような要素の定義は、ネットワーク上のエンドポイントの動作に相反する `ReplyTo` ヘッダーの値を示すため、HTTP トランスポートに固有のものになります。  
+  
+#### アクション定義  
+ WS\-Addressing 2004\/08 では、`wsdl:portType/wsdl:operation/[wsdl:input | wsdl:output | wsdl:fault]` 要素の `wsa:Action` 属性が定義されています。WS\-Addressing 1.0 WSDL バインディング \(WS\-ADDR10\-WSDL\) では、同様の属性として `wsaw10:Action` が定義されています。  
+  
+ この 2 つの属性の唯一の違いは、既定の Action パターンのセマンティクスです。これは、WS\-ADDR のセクション 3.3.2 および WS\-ADDR10\-WSDL のセクション 4.4.4 にそれぞれ記載されています。  
+  
+ 同じ `portType` \([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の用語ではコントラクト\) を共有し、異なるバージョンの WS\-Addressing を使用する 2 つのエンドポイントを持つことは一見合理的に思われます。しかし、Action は `portType` によって定義され、`portType` を実装するエンドポイント間で変更できないことを考えると、両方の既定のアクション パターンをサポートすることは不可能になります。  
+  
+ この問題を解決するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では `Action` 属性の単一のバージョンをサポートしています。  
+  
+ B3521 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ADDR10\-WSDL に定義された `wsdl:portType/wsdl:operation/[wsdl:input | wsdl:output | wsdl:fault]` 要素の `wsaw10:Action` 属性を使用して、エンドポイントが使用する WS\-Addressing のバージョンに関係なく、対応するメッセージの `Action` URI を決定します。  
+  
+#### WSDL ポート内でのエンドポイント参照の使用  
+ WS\-ADDR10\-WSDL のセクション 4.1 では、`wsdl:port` 要素を拡張して、WS\-Addressing の観点でエンドポイントを記述する `<wsa10:EndpointReference…/>` 子要素を含めています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-Addressing 2004\/08 のこのユーティリティを拡張し、`<wsa:EndpointReference…/>` が `wsdl:port` の子要素として使用できるようにしています。  
+  
+-   R3531 : エンドポイントが `<wsaw10:UsingAddressing/>` ポリシー アサーションに関連付けられたポリシー代替手段を持つ場合、対応する `wsdl:port` 要素に `<wsa10:EndpointReference  />` 子要素を含めることができます。  
+  
+-   R3532 : `wsdl:port` に `<wsa10:EndpointReference  />` 子要素が含まれている場合、`wsa10:EndpointReference/wsa10:Address` 子要素の値は、`wsdl:port`\/`wsdl:location` 兄弟要素の `@address` 属性の値に一致する必要があります。  
+  
+-   R3533 : エンドポイントが `<wsap:UsingAddressing/>` ポリシー アサーションに関連付けられたポリシー代替手段を持つ場合、対応する `wsdl:port` 要素に `<wsa:EndpointReference  />` 子要素を含めることができます。  
+  
+-   R3534 : `wsdl:port` に `<wsa:EndpointReference  />` 子要素が含まれている場合、`wsa:EndpointReference/wsa:Address` 子要素の値は、`wsdl:port`\/`wsdl:location` 兄弟要素の `@address` 属性の値に一致する必要があります。  
+  
+### WS\-Security によるコンポジション  
+ WS\-ADDR および WS\-ADDR10 のセキュリティに関する考慮事項のセクションに従って、メッセージ本文と共にすべてのアドレス指定メッセージ ヘッダーに署名し、これらをバインドすることをお勧めします。  
+  
+ メッセージの整合性を保護するために WS\-Security を使用する場合は、メッセージの本文と共に、WS\-Addressing メッセージ ヘッダーと、参照パラメーターまたは参照プロパティ \(または両方\) によって生成されたヘッダーに署名する必要があります。  
+  
+### 例  
+  
+#### 一方向のメッセージ  
+ このシナリオでは、送信者は一方向のメッセージを受信者に送信します。SOAP 1.2、HTTP 1.1、および W3C WS\-Addressing 1.0 を使用します。  
+  
+ 要求メッセージの構造 : メッセージ ヘッダーには、`wsa10:To` 要素と `wsa10:Action` 要素が含まれます。メッセージ本文には、アプリケーション名前空間の特定の `<app:Ping>` 要素が含まれます。  
+  
+ HTTP ヘッダー : POST の送信先は、`wsa10:To`  要素の URI に一致します。  
+  
+ Content\-Type ヘッダーには、SOAP 1.2 で必要とされる値 `application/soap+xml` が含まれます。また、`charset` パラメーターと `action` パラメーターも含まれます。Content\-Type ヘッダーの `action` パラメーターは、`wsa10:Action` メッセージ ヘッダーの値に一致します。  
+  
+```  
+POST http://fabrikam123.com/Service HTTP/1.1  
+Content-Type: application/soap+xml; charset=utf-8;    
+              action="http://fabrikam123.com/Service/OneWay"  
+Host: 131.107.72.15  
+Content-Length: 1501  
+Expect: 100-continue  
+Proxy-Connection: Keep-Alive  
+<s12:Envelope>  
+  <s12:Header>  
+    <wsa10:To s12:mustUnderstand="1">  
+        http://fabrikam123.com/Service  
+    </wsa10:To>  
+    <wsa10:Action s12:mustUnderstand="1">  
+        http://fabrikam123.com/Service/OneWay   
+    </wsa10:Action>  
+  </s12:Header>  
+  <s12:Body>  
+    <Ping xmlns="http://fabrikam123.com/Service/">  
+      <Text>Hello World</Text>  
+    </Ping>  
+  </s12:Body>  
+</s12:Envelope>  
+```  
+  
+ 受信側は、空の HTTP 応答と 202 ステータスで応答します。HTTP 応答の一例を次に示します。  
+  
+```  
+HTTP/1.1 202 Accepted  
+Date: Fri, 15 Jul 2005 08:56:07 GMT  
+Server: Microsoft-IIS/6.0  
+MicrosoftOfficeWebServer: 5.0_Pub  
+X-Powered-By: ASP.NET  
+X-AspNet-Version: 2.0.50215  
+Cache-Control: private  
+Content-Length: 0  
+```  
+  
+## SOAP Message Transmission Optimization Mechanism  
+ ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] における HTTP SOAP MTOM 実装の詳細について説明します。MTOM テクノロジは、従来の Text\/XML エンコーディングや [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バイナリ エンコーディングと同じクラスの SOAP メッセージ エンコーディング機構です。MTOM には、次のような機能があります。  
+  
+-   XOP によって記述された XML エンコーディングおよびパッケージング機構。XOP は、Base64 で個別のバイナリ部分にエンコードされたバイナリ データを含む XML 情報項目を最適化します。  
+  
+-   XML Infoset と XOP パッケージの各バイナリ部分を個別の MIME パートにシリアル化する、XOP パッケージの MIME カプセル化。  
+  
+-   SOAP 1.x エンベロープに適用される MIME XOP エンコーディング。  
+  
+-   HTTP トランスポート バインディング。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、HTTP 以外のトランスポートで MTOM を使用できます。しかし、ここでは HTTP に焦点を合わせます。  
+  
+ MTOM 形式では、MTOM 自体、XOP、および MIME に適用されるさまざまな仕様を利用します。この仕様セットのモジュール性により、形式と処理のセマンティクスの要件を正確に再構築することが若干難しくなります。このセクションでは、MTOM HTTP バインディングの形式と処理の要件について説明します。  
+  
+### MTOM メッセージ エンコーディング  
+  
+#### MTOM メッセージの生成  
+ XOP のセクション 3.1 には、Base64 値を抽象的に定義された XOP パッケージに格納する要素情報項目を使用して、XML をエンコーディングするプロセスが記載されています。  
+  
+ 次の一連の手順は、MTOM 固有のエンコーディング プロセスを示しています。  
+  
+1.  エンコードする SOAP エンベロープに、`[namespace name]` が "http:\/\/www.w3.org\/2004\/08\/xop\/include" で、`[local name]` が `Include` である要素情報項目が含まれていないことを確認します。  
+  
+2.  空の MIME パッケージを作成します。  
+  
+3.  元の XML Infoset 内で、最適化する要素情報項目を特定します。項目を最適化する場合、要素情報項目の `[children]` を構成する文字は、`xs:base64Binary` の正規形式であることが必要です \(XSD\-2 セクション 3.2.16 の base64Binary を参照\)。また、空白以外のコンテンツの前、インライン、または後に、空白文字を含めることはできません。  
+  
+4.  元の SOAP エンベロープのコピーである XOP SOAP エンベロープを作成します。ただし、このコピーには、前の手順で特定した各要素情報項目の子が含まれます。これらの子は、以下の手順に従って構築された `xop:Include` 要素情報項目に置き換えられています。  
+  
+    1.  置換対象の文字を Base64 でエンコードされたデータとして処理することにより、バイナリ データに変換します。  
+  
+    2.  R3133 および R3134 の各要件を満たす Content\-ID ヘッダーの一意の値を生成します。  
+  
+    3.  バイナリ値を使用して、Content\-Transfer\-Encoding MIME ヘッダーを生成します。  
+  
+    4.  最適化する要素情報項目 \(新しく挿入する `xop:Include` 要素情報項目の \[parent\]\) に、`xmime:contentType` 属性情報項目が含まれている場合、`xmime:contentType` 属性の値を使用して Content\-Type MIME ヘッダーを生成します。  
+  
+    5.  Base64 として処理された置換対象文字からデコードされたバイナリ データ、Content\-ID ヘッダー \(手順 4b. で生成\)、Content\- Transfer\-Encoding ヘッダー \(手順 4c. で生成\)、および Content\-Type ヘッダー \(手順 4d. で生成した場合\) で構成されたコンテンツを含む、新しいバイナリ MIME パートを生成します。  
+  
+    6.  値 cid: uri を持つ `xop:Include` 要素に `href` 属性を追加します。uri は、手順 4b. で生成した Content\-ID ヘッダーの値から派生したものです。囲んでいる "\<" と "\>" を削除し、残りの文字列を URL エスケープし、プレフィックス `cid:` を追加します。RFC1738 と RFC2396 に従って、次の最小限の文字セットをエスケープする必要があります。その他の文字もエスケープすることができます。  
+  
+        ```  
+        Hexadecimal 00-1F , 7F, 20, "<" | ">" | "#" | "%" | <">  
+        "{" | "}" | "|" | "\" | "^" | "[" | "]" | "`" | "~" | "^"  
+        ```  
+  
+5.  手順 4. の XOP SOAP エンベロープを含むルート MIME パートを作成します。  
+  
+6.  HTTP Content\-Type ヘッダーなどの HTTP ヘッダーを書き込みます。  
+  
+7.  MIME パッケージを書き込みます。  
+  
+#### MTOM メッセージの処理  
+ MTOM メッセージの処理は、前述の「MTOM メッセージの生成」で説明したプロセスと正反対のプロセスになります。  
+  
+1.  ルート MIME パートに Content\-Type `application/xop+xml` が含まれていることを確認します。  
+  
+2.  パッケージのルート MIME パートを XML ドキュメントとして解析して、SOAP エンベロープを作成します。文字エンコーディングは、ルート MIME パートの Content\-Type の `charset` パラメーターによって決まります。  
+  
+3.  作成した SOAP エンベロープ内の各要素情報項目について、以下の処理を行います。これらの要素情報項目には、\[children\] プロパティの唯一のメンバーとして、`xop:Include` 要素情報項目が含まれています。  
+  
+    1.  プレフィックス `cid:` を削除し、`xop:Include` 要素の `@href` 属性の値に含まれるすべての URI エスケープ シーケンスのエスケープを解除します \(RFC 2396\)。エスケープ解除した文字列を "\<" と "\>" で囲みます。  
+  
+    2.  Content\-ID ヘッダーの値が手順 3a. で取得した文字列に一致する MIME パートを検索します。  
+  
+    3.  各項目の `children` プロパティに出現する `xop:Include` 要素情報項目を、手順 3b. で特定した MIME パートのエンティティ本体の正規 Base64 エンコーディング \(XSD\-2 セクション 3.2.16 の base64Binary を参照\) を表す文字情報項目に置き換えます \(`xop:Include` 要素情報項目をパッケージ パーツから再構築したデータに効率的に置き換えます\)。  
+  
+#### HTTP Content\-Type ヘッダー  
+ ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で使用する、SOAP 1.x MTOM でエンコードされたメッセージの HTTP Content\-Type ヘッダーの形式について説明します。これらの形式は、MTOM 仕様に記載された要件と、MTOM および RFC 2387 に基づいています。  
+  
+-   R4131 : HTTP Content\-Type ヘッダーには、multipart\/related \(大文字と小文字は区別されません\) とそのパラメーターの値が必要です。パラメーター名では、大文字と小文字は区別されません。パラメーターの順序は重要ではありません。  
+  
+-   MIME メッセージの Content\-Type ヘッダーのすべての Backus\-Naur Form \(BNF\) については、RFC 2045 のセクション 5.1 に記載されています。  
+  
+-   R4132 : HTTP Content\-Type ヘッダーには、二重引用符で囲まれた値 `application/xop+xml` が指定された型パラメーターが必要です。  
+  
+ 二重引用符を使用する際の要件は、RFC 2387 に明示されているわけではありませんが、ほとんどの場合、multipart\/related メディア タイプのすべてのパラメーターに、"@" や "\/" などの予約された文字が含まれているため、二重引用符が必要であることが確認されています。  
+  
+-   R4133 : HTTP Content\-Type ヘッダーには、start パラメーターを含める必要があります。このパラメーターには、SOAP 1.x エンベロープを含む MIME パートの Content\-ID ヘッダーの値を二重引用符で囲んで指定します。start パラメーターを省略する場合は、最初の MIME パートに SOAP 1.x エンベロープを含める必要があります。  
+  
+-   R4134 : SOAP 1.1 MTOM でエンコードされたメッセージの HTTP Content\-Type ヘッダーには、start\-info パラメーターを含める必要があります。このパラメーターには、値 text\/xml を二重引用符で囲んで指定します。  
+  
+-   R4135 : SOAP 1.2 MTOM でエンコードされたメッセージの HTTP Content\-Type ヘッダーには、start\-info パラメーターを含める必要があります。このパラメーターには、値 `application/soap+xml` を二重引用符で囲んで指定します。  
+  
+-   R4136 : SOAP 1.x MTOM でエンコードされたメッセージの HTTP Content\-Type ヘッダーには、boundary パラメーターを含める必要があります。このパラメーターには、RFC 2046 のセクション 5.1.1 で定義された MIME 境界の BNF に一致する \(二重引用符で囲まれた\) 値を指定します。  
+  
+    ```  
+    boundary := 0*69<bchars> bcharsnospace   
+    bchars := bcharsnospace / " "   
+    bcharsnospace :=    DIGIT / ALPHA / "'" / "(" / ")" / "+"   
+                        / "_" / "," / "-" / "." / "/" / ":" / "=" / "?"  
+    ```  
+  
+     次に例を示します。  
+  
+     正  
+  
+    ```  
+    Content-Type: multipart/related; type="application/xop+xml";start=" <part0@tempuri.org>";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1";start-info="text/xml"  
+  
+    ```  
+  
+     正  
+  
+    ```  
+    Content-Type: Multipart/Related; type="application/xop+xml";start-info="text/xml";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"  
+  
+    ```  
+  
+     誤  
+  
+    ```  
+    Content-Type: Multipart/Related; type=application/xop+xml;start=" <part0@tempuri.org>";start-info="text/xml";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"   
+    ```  
+  
+#### Infoset MIME パート  
+ SOAP 1.x エンベロープは、XOP MIME パッケージのルート部分としてカプセル化され、多くの場合、`infoset` パートと呼ばれます。  
+  
+-   R4141 : SOAP 1.x エンベロープは、XOP MIME パッケージのルート部分としてカプセル化する必要があります。これは `infoset` パートと呼ばれ、HTTP Content\-Type から参照されます。  
+  
+-   R4142 : SOAP `Infoset` パートには、`Content-ID`、`Content-Transfer-Encoding`、および `Content-Type` の各 MIME ヘッダーを含める必要があります。  
+  
+ Content\-ID ヘッダーの形式は、RFC 2045 で次のように定義されています。  
+  
+```  
+"Content-ID" ":" msg-id  
+```  
+  
+ ここで、`msg-id` は、RFC 2822 で次のように定義されています \(RFC 2045 で参照されている RFC 822 は、RFC 2822 に置き換えられています\)。  
+  
+```  
+msg-id    =       [CFWS] "<" id-left "@" id-right ">" [CFWS]  
+```  
+  
+ msg\-id は、"\<" と "\>" で囲まれた有効な電子メール アドレスです。`[CFWS]` プレフィックスとサフィックスは、コメントを伝達するために RFC 2822 で追加されたものですが、相互運用性を維持する場合は、使用しないことをお勧めします。  
+  
+ R4143 : Infoset MIME パートの Content\-ID ヘッダーの値は、RFC 2822 の `msg-id` の定義内容から `[CFWS]` プレフィックスとサフィックスの部分を省略した形式に従う必要があります。  
+  
+ 多くの MIME 実装では、"\<" と "\>" で囲まれた値が電子メール アドレスであるという要件を緩和し、電子メール アドレス以外に、"\<" と "\>" で囲まれた `absoluteURI` を使用しています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のこのバージョンでは、次の形式の Content\-ID MIME ヘッダーの値を使用します。  
+  
+```  
+Content-ID: <http://tempuri.org/0>   
+```  
+  
+ R4144 : MTOM プロセッサは、次の厳密でない `msg-id` に一致する Content\-ID ヘッダーの値を受け入れる必要があります。  
+  
+```  
+msg-id-relaxed =     [CFWS] "<" (absoluteURI | mail-address) ">" [CFWS]  
+mail-address   =     id-left "@" id-right  
+```  
+  
+ MIME \(RFC 2045\) では、MIME パートのコンテンツのエンコーディングを伝達する Content\-Transfer\-Encoding ヘッダーを使用できます。Content\-Transfer\-Encoding に定義されている既定値は 7 ビットですが、これはほとんどの SOAP メッセージに適していません。そのため、Content\-Transfer\-Encoding ヘッダーの相互運用性を高めるために、以下を行う必要があります。  
+  
+-   R4145 : SOAP Infoset パートに、Content\-Transfer\-Encoding ヘッダーを含める必要があります。  
+  
+-   R4146 : SOAP エンベロープの文字エンコーディングが UTF\-8 の場合、Content\-Transfer\-Encoding ヘッダーの値は 8 ビットであることが必要です。  
+  
+-   R4147 : SOAP エンベロープの文字エンコーディングが UTF\-16 の場合、Content\-Transfer\-Encoding ヘッダーの値はバイナリであることが必要です。  
+  
+-   以下の要件は、XOP のセクション 5 に基づいています。  
+  
+-   R4148 : SOAP1.1 Infoset パートに、application\/xop\+xml メディア タイプ、および type\="text\/xml" パラメーターと charset パラメーターを指定した Content\-Type ヘッダーを含める必要があります。  
+  
+    ```  
+    Content-Type: application/xop+xml;  
+                  charset=utf-8;type="text/xml"  
+    ```  
+  
+-   R4149 : SOAP1.2 Infoset パートに、`application/xop+xml` メディア タイプ、および type\="`application/soap+xml`" パラメーターと `charset` パラメーターを指定した Content\-Type ヘッダーを含める必要があります。  
+  
+    ```  
+    Content-Type: application/xop+xml;  
+                  charset=utf-8;type="application/soap+xml"  
+    ```  
+  
+     XOP では、`application/xop+xml` の `charset` パラメーターは省略可能と定義されていますが、`text/xml` メディア タイプの `charset` パラメーターについては、BP 1.1 の要件と同様の相互運用性が必要とされます。  
+  
+-   R41410 : `type` パラメーターと `charset` パラメーターは、SOAP 1.x Infoset パートの Content\-Type ヘッダーに含まれている必要があります。  
+  
+#### WCF エンドポイントによる MTOM のサポート  
+ MTOM の目的は、SOAP メッセージをエンコードして、Base64 でエンコードされたデータを最適化することです。制約は次のとおりです。  
+  
+-   R4151 : Base64 でエンコードされたデータを含むすべての要素情報項目を最適化できます。  
+  
+-   B4152 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、Base64 でエンコードされたデータを含み、長さが 1024 バイトを上回る要素情報項目を最適化します。  
+  
+ MTOM を使用するように構成された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、常に MTOM でエンコードされたメッセージを送信します。必要な条件を満たすパートがない場合でも、メッセージは MTOM でエンコードされます \(SOAP エンベロープを含む単一の MIME パートを持つ MIME パッケージとしてシリアル化されます\)。  
+  
+### MTOM の WS\-Policy アサーション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、次のポリシー アサーションを使用して、エンドポイントによる MTOM の使用方法を示します。  
+  
+```  
+<wsoma:OptimizedMimeSerialization ... />  
+```  
+  
+-   R4211 : 上記のポリシー アサーションには、エンドポイント ポリシー サブジェクトが含まれており、MTOM を使用して、エンドポイントで送受信されるすべてのメッセージを最適化する必要があることを示しています。  
+  
+-   B4212 : MTOM による最適化を使用するように構成されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントは、対応する `wsdl:binding` に関連付けられたポリシーに MTOM ポリシー アサーションを追加します。  
+  
+### WS\-Security によるコンポジション  
+ MTOM は、`text/xml` および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バイナリ XML と同様のエンコーディング機構です。MTOM は、WS\-Security とその他の WS\-\* プロトコルによる自然なコンポジションを提供します。WS\-Security を使用してセキュリティ保護されたメッセージは、MTOM を使用して最適化できます。  
+  
+### 例  
+  
+#### MTOM を使用してエンコードされた WCF SOAP 1.1 メッセージ  
+  
+```  
+POST http://131.107.72.15/Mtom/svc/service.svc/Soap11MtomUTF8 HTTP/1.1  
+SOAPAction: "http://xmlsoap.org/echoBinaryAsString"  
+Content-Type: multipart/related;type="application/xop+xml";  
+              start="<http://tempuri.org/0>";start-info="text/xml";  
+       boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"  
+Host: 131.107.72.15  
+Content-Length: 1501  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1  
+Content-ID: <http://tempuri.org/0>  
+Content-Transfer-Encoding: 8bit  
+Content-Type: application/xop+xml;charset=utf-8;type="text/xml"  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+  <s:Body>  
+    <EchoBinaryAsString xmlns="http://xmlsoap.org/Ping">  
+      <array>  
+        <xop:Include   
+         href="cid:http%3A%2F%2Ftempuri.org%2F1%2F632618206521093670"   
+         xmlns:xop="http://www.w3.org/2004/08/xop/include"/>  
+      </array>  
+    </EchoBinaryAsString>  
+  </s:Body>  
+</s:Envelope>  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1  
+Content-ID: <http://tempuri.org/1/632618206521093670>  
+Content-Transfer-Encoding: binary  
+Content-Type: application/octet-stream  
+…Binary Content..  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1  
+```  
+  
+#### MTOM を使用してエンコードされた WCF Secure SOAP 1.2 メッセージ  
+ この例では、WS\-Security を使用して保護されたメッセージを MTOM と SOAP 1.2 を使用してエンコードします。エンコーディングの対象として特定されたバイナリ部分は、`BinarySecurityToken`、暗号化された署名に対応する `EncryptedData` の `CipherValue`、および暗号化された本文の内容です。`EncryptedKey` の `CipherValue` は、長さが 1024 バイト未満であるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] による最適化の対象として特定されませんでした。  
+  
+```  
+POST http://131.107.72.15/Mtom/service.svc/Soap12MtomSecureSignEncrypt HTTP/1.1  
+Content-Type: multipart/related; type="application/xop+xml";  
+              start="<http://tempuri.org/0>";  
+            boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3";  
+              start-info="application/soap+xml";   
+              action="http://xmlsoap.org/echoBinaryAsString"  
+Host: 131.107.72.15  
+Content-Length: 1941  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3  
+Content-ID: <http://tempuri.org/0>  
+Content-Transfer-Encoding: 8bit  
+Content-Type: application/xop+xml;charset=utf-8;type="application/soap+xml"  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+  <s:Header>  
+    <o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+      <u:Timestamp u:Id="uuid-4d4ee765-5717-4d53-9ac9-99bddc07df6c-5">  
+        <u:Created>2005-09-09T06:57:32.488Z</u:Created>  
+        <u:Expires>2005-09-09T07:02:32.488Z</u:Expires>  
+      </u:Timestamp>  
+      <o:BinarySecurityToken u:Id="uuid-4d4ee765-5717-4d53-9ac9-99bddc07df6c-2" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">  
+        <xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F1%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>  
+      </o:BinarySecurityToken>  
+      <e:EncryptedKey Id="_1" xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+        <e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p"/>  
+        <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">  
+          <o:SecurityTokenReference>  
+            <o:KeyIdentifier ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier">Xeg55vRyK3ZhAEhEf+YT0z986L0=</o:KeyIdentifier>  
+          </o:SecurityTokenReference>  
+        </KeyInfo>  
+        <e:CipherData>          <e:CipherValue>oQfpxwT8/SAGyZQzKE2b4yO6dXuQj7pwJ+5CGL3Rf7C06bQ5ttMoQ9GLJcQYkXTzin+WwHEgs5bj5ml9HKTW9QAU5JJ6lksdymmQvWP5ZtGPBVchO4sofEGoCKmBiZL/DYS/cnbzgnc/3a6NYnc10y2fWGaGLiqa00zijAw7o0Y=</e:CipherValue>  
+        </e:CipherData>  
+      </e:EncryptedKey>  
+      <c:DerivedKeyToken u:Id="_2" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc">  
+        <o:SecurityTokenReference>  
+          <o:Reference URI="#_1"/>  
+        </o:SecurityTokenReference>  
+        <c:Nonce>OrEPRX7fISIS4sXYWPMv3g==</c:Nonce>  
+      </c:DerivedKeyToken>  
+      <e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+        <e:DataReference URI="#_3"/>  
+        <e:DataReference URI="#_4"/>  
+      </e:ReferenceList>  
+      <e:EncryptedData Id="_4" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+        <e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc"/>  
+        <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">  
+          <o:SecurityTokenReference>  
+            <o:Reference URI="#_2"/>  
+          </o:SecurityTokenReference>  
+        </KeyInfo>  
+        <e:CipherData>  
+          <e:CipherValue>  
+            <xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F2%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>  
+          </e:CipherValue>  
+        </e:CipherData>  
+      </e:EncryptedData>  
+    </o:Security>  
+  </s:Header>  
+  <s:Body u:Id="_0">  
+    <e:EncryptedData Id="_3" Type="http://www.w3.org/2001/04/xmlenc#Content" xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+      <e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc"/>  
+      <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">  
+        <o:SecurityTokenReference xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+          <o:Reference URI="#_2"/>  
+        </o:SecurityTokenReference>  
+      </KeyInfo>  
+      <e:CipherData>  
+        <e:CipherValue>  
+          <xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F3%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>  
+        </e:CipherValue>  
+      </e:CipherData>  
+    </e:EncryptedData>  
+  </s:Body>  
+</s:Envelope>  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3  
+Content-ID: <http://tempuri.org/1/632618206525089430>  
+Content-Transfer-Encoding: binary  
+Content-Type: application/octet-stream  
+...Binary content of BinarySecurityToken - X509 Certificate...  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3  
+Content-ID: <http://tempuri.org/2/632618206525089430>  
+Content-Transfer-Encoding: binary  
+Content-Type: application/octet-stream  
+...Binary serialization of the encrypted primary signature...  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3  
+Content-ID: <http://tempuri.org/3/632618206525089430>  
+Content-Transfer-Encoding: binary  
+Content-Type: application/octet-stream  
+...Binary serialization of the encrypted Body...  
+--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3--  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/metadata-architecture-overview.md b/docs/framework/wcf/feature-details/metadata-architecture-overview.md
new file mode 100644
index 00000000000..29ac841c3e2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/metadata-architecture-overview.md
@@ -0,0 +1,105 @@
+---
+title: "メタデータ アーキテクチャの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ [WCF], 概要"
+ms.assetid: 1d37645e-086d-4d68-a358-f3c5b6e8205e
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# メタデータ アーキテクチャの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、サービス メタデータをエクスポート、公開、取得、およびインポートするための豊富なインフラストラクチャが用意されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、メタデータを使用してサービスのエンドポイントとの対話方法を記述し、Svcutil.exe などのツールでサービスにアクセスするためのクライアント コードを自動的に生成できるようにします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メタデータ インフラストラクチャを構成するほとんどの型が、<xref:System.ServiceModel.Description> 名前空間に存在します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.ServiceEndpoint> クラスを使用して、サービス内のエンドポイントを記述します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、サービス エンドポイント用のメタデータを生成したり、サービス メタデータをインポートして <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスを生成したりできます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.MetadataSet> 型のインスタンスとしてサービスのメタデータを表現します。その構造は、WS\-MetadataExchange で定義されているメタデータのシリアル化形式に強く関連付けられています。<xref:System.ServiceModel.Description.MetadataSet> 型は、Web サービス記述言語 \(WSDL: Web Services Description Language\) ドキュメント、XML スキーマ ドキュメント、WS\-Policy 表現などの実際のサービス メタデータを <xref:System.ServiceModel.Description.MetadataSection> インスタンスのコレクションとしてバンドルします。各 <xref:System.ServiceModel.Description.MetadataSection?displayProperty=fullName> インスタンスには、特定のメタデータ言語と識別子が含まれます。<xref:System.ServiceModel.Description.MetadataSection?displayProperty=fullName> はその <xref:System.ServiceModel.Description.MetadataSection.Metadata%2A?displayProperty=fullName> プロパティに、次のアイテムを含むことができます。  
+  
+-   生のメタデータ。  
+  
+-   <xref:System.ServiceModel.Description.MetadataReference> のインスタンス。  
+  
+-   <xref:System.ServiceModel.Description.MetadataLocation> のインスタンス。  
+  
+ <xref:System.ServiceModel.Description.MetadataReference?displayProperty=fullName> インスタンスは別のメタデータ交換 \(MEX\) エンドポイントをポイントし、<xref:System.ServiceModel.Description.MetadataLocation?displayProperty=fullName> インスタンスは HTTP URL を使用してメタデータ ドキュメントをポイントします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、サービスで実装するサービス エンドポイント、サービス コントラクト、バインディング、メッセージ交換パターン、メッセージ、およびエラー メッセージを記述するために WSDL ドキュメントの使用をサポートします。サービスで使用されるデータ型は、XML スキーマを使用して WSDL ドキュメントに記述されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][スキーマのインポートとエクスポート](../../../../docs/framework/wcf/feature-details/schema-import-and-export.md).[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、サービス動作、コントラクト動作、およびバインディング要素の WSDL 拡張をエクスポートおよびインポートでき、この拡張により、サービスの機能が拡張されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][WCF 拡張に対するカスタム メタデータのエクスポート](../../../../docs/framework/wcf/extending/exporting-custom-metadata-for-a-wcf-extension.md).  
+  
+## サービス メタデータのエクスポート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、*メタデータのエクスポート*は、サービス エンドポイントを説明したり、それらを対応する標準化表現に投影したりするプロセスです。クライアントはこのプロセスを利用してサービスの使用方法を理解します。メタデータを <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスからエクスポートするには、<xref:System.ServiceModel.Description.MetadataExporter> 抽象クラスの実装を使用します。<xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> の実装によって、<xref:System.ServiceModel.Description.MetadataSet> インスタンスにカプセル化されたメタデータが生成されます。  
+  
+ <xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> クラスには、エンドポイント バインディングの機能と要件、エンドポイントに関連付けられた処理、メッセージ、エラーを記述するポリシー式を生成するためのフレームワークが用意されています。これらのポリシー式は、<xref:System.ServiceModel.Description.PolicyConversionContext> インスタンスにキャプチャされます。<xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> を実装すると、生成したメタデータにこれらのポリシー式を結び付けることができます。  
+  
+ <xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> は、<xref:System.ServiceModel.Description.PolicyConversionContext> オブジェクトを <xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> の実装で使用するために生成するときに、<xref:System.ServiceModel.Description.ServiceEndpoint> のバインディングで <xref:System.ServiceModel.Description.IPolicyExportExtension> インターフェイスを実装する各 <xref:System.ServiceModel.Channels.BindingElement?displayProperty=fullName> を呼び出します。<xref:System.ServiceModel.Channels.BindingElement> 型のカスタム実装の <xref:System.ServiceModel.Description.IPolicyExportExtension> インターフェイスを実装することで、新規のポリシー アサーションをエクスポートできます。  
+  
+ <xref:System.ServiceModel.Description.WsdlExporter> 型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる <xref:System.ServiceModel.Description.MetadataExporter?displayProperty=fullName> 抽象クラスの実装です。<xref:System.ServiceModel.Description.WsdlExporter> 型は、結び付けられたポリシー式を使用して WSDL メタデータを生成します。  
+  
+ サービス エンドポイントでのエンドポイント動作、コントラクト動作、またはバインディング要素のカスタム WSDL メタデータまたは WSDL 拡張をエクスポートするには、<xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイスを実装する必要があります。<xref:System.ServiceModel.Description.WsdlExporter> は WSDL ドキュメントの生成時に、<xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイスを実装するバインディング要素、処理動作、コントラクト動作、およびエンドポイント動作の <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスを参照します。  
+  
+## サービス メタデータの公開  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは 1 つ以上のメタデータ エンドポイントを公開することにより、メタデータを公開します。サービス メタデータを公開すると、サービス メタデータで MEX や HTTP\/GET 要求などの標準化プロトコルを使用できるようになります。メタデータ エンドポイントは、アドレス、バインディング、およびコントラクトを持つという点で、他のサービス エンドポイントと似ています。メタデータ エンドポイントは、構成またはコードを使用してサービス ホストに追加できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのメタデータ エンドポイントを公開するには、最初に <xref:System.ServiceModel.Description.ServiceMetadataBehavior> サービス動作のインスタンスをサービスに追加しておく必要があります。サービスに <xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> インスタンスを追加することによって、1 つ以上のメタデータ エンドポイントを公開することでメタデータを公開する機能がサービスに追加されます。<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> サービス動作を追加すると、MEX プロトコルをサポートするメタデータ エンドポイント、または HTTP\/GET 要求に応答するメタデータ エンドポイントを公開できます。  
+  
+ MEX プロトコルを使用するメタデータ エンドポイントを追加するには、IMetadataExchange という名前のサービス コントラクトを使用するサービス エンドポイントをサービス ホストに追加します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] により、このサービス コントラクト名を持つ <xref:System.ServiceModel.Description.IMetadataExchange> インターフェイスが定義されます。WS\-MetadataExchange のエンドポイント、つまり MEX エンドポイントは、<xref:System.ServiceModel.Description.MetadataExchangeBindings> クラスで静的ファクトリ メソッドが公開する 4 つの既定のバインディングの 1 つを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ツール \(Svcutil.exe など\) によって使用される既定のバインディングを照合できます。また、カスタム バインディングを使用して MEX メタデータ エンドポイントを構成することもできます。  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior> は <xref:System.ServiceModel.Description.WsdlExporter?displayProperty=fullName> を使用して、サービス内のすべてのサービス エンドポイント用のメタデータをエクスポートします。サービスからメタデータをエクスポートする方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)」を参照してください。  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior> は、<xref:System.ServiceModel.Description.ServiceMetadataExtension> インスタンスを拡張としてサービス ホストに追加することで、サービス ホストを拡張します。<xref:System.ServiceModel.Description.ServiceMetadataExtension?displayProperty=fullName> により、メタデータ公開プロトコルを実装することができます。また、<xref:System.ServiceModel.Description.ServiceMetadataExtension?displayProperty=fullName> を使用して、<xref:System.ServiceModel.Description.ServiceMetadataExtension.Metadata%2A> プロパティにアクセスすることにより、実行時にサービスのメタデータを取得できます。  
+  
+> [!CAUTION]
+>  MEX エンドポイントをアプリケーション構成ファイルに追加した後で、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> をコード内のサービス ホストに追加しようとすると、次の例外が発生します。  
+>   
+>  System.InvalidOperationException: コントラクト名 'IMetadataExchange' は、サービス Service1 によって実装されたコントラクトの一覧に見つかりませんでした。ServiceMetadataBehavior を構成ファイルまたは ServiceHost ディレクトリに直接追加してこのコントラクトのサポートを有効にしてください。  
+>   
+>  <xref:System.ServiceModel.Description.ServiceMetadataBehavior> を構成ファイルに追加するか、またはエンドポイントと <xref:System.ServiceModel.Description.ServiceMetadataBehavior> の両方をコードに追加することにより、この問題を回避できます。  
+>   
+>  アプリケーション構成ファイルへの <xref:System.ServiceModel.Description.ServiceMetadataBehavior> の追加の例については、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」を参照してください。コードへの <xref:System.ServiceModel.Description.ServiceMetadataBehavior> の追加の例については、「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」のサンプルを参照してください。  
+  
+> [!CAUTION]
+>  それぞれに同じ名前の操作が含まれている 2 つ異なるサービス コントラクトを公開するサービスのメタデータを公開すると、例外がスローされます。たとえば、Get\(Car c\) 操作を含む ICarService という名前のサービス コントラクトを公開するサービスがあり、その同じサービスが Get\(Book b\) 操作を含む IBookService という名前のサービス コントラクトを公開する場合、サービスのメタデータを生成するときに、例外がスローされるか、エラー メッセージが表示されます。この問題を回避するには、次のいずれかの操作を実行します。  
+>   
+>  -   操作の名前を変更する。  
+> -   <xref:System.ServiceModel.OperationContractAttribute.Name%2A> を別の名前に設定する。  
+> -   <xref:System.ServiceModel.ServiceContractAttribute.Namespace%2A> プロパティを使用して、操作の名前空間のいずれかを別の名前空間に設定する。  
+  
+## サービス メタデータの取得  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は WS\-MetadataExchange、HTTP などの標準化プロトコルを使用してサービス メタデータを取得できます。これらのプロトコルはいずれも、<xref:System.ServiceModel.Description.MetadataExchangeClient> 型でサポートされます。アドレスとオプションのバインディングを提供することによって、<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> 型を使用して、サービス メタデータを取得します。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスで使用するバインディングは、<xref:System.ServiceModel.Description.MetadataExchangeBindings> 静的クラスの既定のバインディング、ユーザー指定のバインディング、`IMetadataExchange` コントラクト用のエンドポイント構成から読み込まれたバインディングのいずれかです。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> は同様に、<xref:System.Net.HttpWebRequest> 型を使用して、メタデータへの HTTP URL 参照を解決できます。  
+  
+ 既定では、<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスは、1 つの <xref:System.ServiceModel.Channels.ChannelFactoryBase> インスタンスに結び付けられています。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> によって使用される <xref:System.ServiceModel.Channels.ChannelFactoryBase> インスタンスは、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetChannelFactory%2A> 仮想メソッドを上書きすることによって変更または置換することができます。同様に、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetWebRequest%2A?displayProperty=fullName> 仮想メソッドをオーバーライドすることによって、HTTP\/GET 要求を行うために <xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> が使用する <xref:System.Net.HttpWebRequest?displayProperty=fullName> インスタンスを変更または置換できます。  
+  
+ Svcutil.exe ツールを使用して、**\/target:metadata** スイッチとアドレスを渡すことにより、WS\-MetadataExchange 要求または HTTP\/GET 要求を使用してサービス メタデータを取得できます。Svcutil.exe は指定したアドレスでメタデータをダウンロードし、ディスクにファイルを保存します。Svcutil.exe は、<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスを内部的に使用し、Svcutil.exe に渡されたアドレスのスキームに一致する名前を持つ MEX エンドポイント構成が存在する場合は、これをアプリケーション構成ファイルから読み込みます。存在しない場合、Svcutil.exe は、<xref:System.ServiceModel.Description.MetadataExchangeBindings> 静的ファクトリ型によって定義されたバインディングの 1 つを既定で使用します。  
+  
+## サービス メタデータのインポート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、メタデータのインポートとは、サービス、またはサービスのコンポーネントの抽象表現をサービスのメタデータから生成するプロセスです。たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.ServiceModel.Description.ServiceEndpoint> インスタンス、<xref:System.ServiceModel.Channels.Binding> インスタンス、または <xref:System.ServiceModel.Description.ContractDescription> インスタンスをサービスの WSDL ドキュメントからインポートできます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス メタデータをインポートするには、<xref:System.ServiceModel.Description.MetadataImporter> 抽象クラスの実装を使用します。<xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> クラスから派生した型では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-Policy インポート ロジックを利用したメタデータ形式のインポートをサポートします。  
+  
+ <xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> の実装は、<xref:System.ServiceModel.Description.PolicyConversionContext> オブジェクトでサービス メタデータに結び付けられたポリシー表現を収集します。その後、<xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> は、<xref:System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions%2A> プロパティ内の <xref:System.ServiceModel.Description.IPolicyImportExtension> インターフェイスの実装を呼び出すことによって、メタデータのインポートの一部として、ポリシーを処理します。  
+  
+ <xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> インスタンスの <xref:System.ServiceModel.Description.MetadataImporter.PolicyImportExtensions%2A> コレクションに <xref:System.ServiceModel.Description.IPolicyImportExtension> インターフェイスの独自の実装を追加することによって、新しいポリシー アサーションをインポートするためのサポートを <xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> に追加できます。または、クライアント アプリケーション構成ファイルにポリシー インポート拡張を登録できます。  
+  
+ <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> 型は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる <xref:System.ServiceModel.Description.MetadataImporter?displayProperty=fullName> 抽象クラスの実装です。<xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> 型は、<xref:System.ServiceModel.Description.MetadataSet> オブジェクトにまとめられた、結び付けられているポリシーを使用して WSDL メタデータをインポートします。  
+  
+ <xref:System.ServiceModel.Description.IWsdlImportExtension> インターフェイスを実装し、この実装を <xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> インスタンスの <xref:System.ServiceModel.Description.WsdlImporter.WsdlImportExtensions%2A> プロパティに追加することで、WSDL 拡張のインポートのサポートを追加できます。<xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> は、クライアント アプリケーション構成ファイルに登録された <xref:System.ServiceModel.Description.IWsdlImportExtension?displayProperty=fullName> インターフェイスの実装を読み込むこともできます。  
+  
+## 動的なバインド  
+ エンドポイントのバインドが変化するイベントでサービス エンドポイントへのチャネルを作成する、または、同じコントラクトを使用しているがバインドが異なるエンドポイントへのチャネルを作成するために使用するバインドを動的に更新することができます。<xref:System.ServiceModel.Description.MetadataResolver> 静的クラスを使用して、特定のコントラクトを実装しているサービス エンドポイントのメタデータを、実行時に取得またはインポートできます。その後、インポートした <xref:System.ServiceModel.Description.ServiceEndpoint?displayProperty=fullName> オブジェクトを使用して、必要なエンドポイントに対するクライアントまたはチャネル ファクトリを作成できます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description>   
+ [メタデータ形式](../../../../docs/framework/wcf/feature-details/metadata-formats.md)   
+ [メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)   
+ [メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)   
+ [メタデータを取得する](../../../../docs/framework/wcf/feature-details/retrieving-metadata.md)   
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)   
+ [メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)   
+ [メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/metadata-formats.md b/docs/framework/wcf/feature-details/metadata-formats.md
new file mode 100644
index 00000000000..7509efc241c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/metadata-formats.md
@@ -0,0 +1,35 @@
+---
+title: "メタデータ形式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: baad1e68-28fc-4a6a-8a43-75e47e7fa871
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# メタデータ形式
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、次の表に示すメタデータ形式をサポートしています。  
+  
+## メタデータの仕様と用途  
+  
+|プロトコル|仕様と用途|  
+|-----------|-----------|  
+|WSDL 1.1|[Web Services Description Language \(WSDL\) 1.1](http://go.microsoft.com/fwlink/?LinkId=94859)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービスの記述に Web サービス記述言語 \(WSDL\) を使用します。|  
+|XML スキーマ|[XML Schema Part 2: Datatypes Second Edition](http://go.microsoft.com/fwlink/?LinkId=94861) および [XML Schema Part 1: Structures Second Edition](http://go.microsoft.com/fwlink/?LinkId=94862)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、メッセージ内で使用されるデータ型の記述に XML スキーマを使用します。|  
+|WS\-Policy|[Web Services Policy 1.2 \- Framework \(WS\-Policy\)](http://go.microsoft.com/fwlink/?LinkId=94864)<br /><br /> [Web Services Policy 1.5 \- Framework](http://go.microsoft.com/fwlink/?LinkId=94865)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ドメイン固有のアサーションと共に WS\-Policy 1.2 または 1.5 の仕様を使用して、サービス要件と機能を記述します。|  
+|WS\-PolicyAttachments|[Web Services Policy 1.2 \- Attachment \(WS\-PolicyAttachment\)](http://go.microsoft.com/fwlink/?LinkId=94866)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WSDL のさまざまなスコープにポリシー表現を関連付けるために、WS\-PolicyAttachments が実装されています。|  
+|WS\-Metadata Exchange|[Web Services Metadata Exchange \(WS\-MetadataExchange\) version 1.1](http://go.microsoft.com/fwlink/?LinkId=94868)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、XML スキーマ、WSDL、WS\-Policy を取得するために WS\-MetadataExchange が実装されています。|  
+|WS Addressing Binding for WSDL|[Web Services Addressing 1.0 \- WSDL Binding](http://go.microsoft.com/fwlink/?LinkId=94869)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WSDL でアドレス指定情報を関連付けるために、WS\-Addressing Binding for WSDL が実装されています。|  
+  
+## 参照  
+ [システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)   
+ [WSDL とポリシー](../../../../docs/framework/wcf/feature-details/wsdl-and-policy.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/metadata.md b/docs/framework/wcf/feature-details/metadata.md
new file mode 100644
index 00000000000..202d43a9c16
--- /dev/null
+++ b/docs/framework/wcf/feature-details/metadata.md
@@ -0,0 +1,47 @@
+---
+title: "メタデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ [WCF]"
+ms.assetid: 66a61bd0-18d3-4e7e-bf8b-177a10ac2f60
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# メタデータ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、サービス メタデータをエクスポート、公開、取得、およびインポートするためのインフラストラクチャが用意されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、メタデータを使用してサービスのエンドポイントとの対話方法を記述し、Svcutil.exe などのツールでサービスにアクセスするためのクライアント コードを自動的に生成できるようにします。  
+  
+## このセクションの内容  
+ [メタデータ アーキテクチャの概要](../../../../docs/framework/wcf/feature-details/metadata-architecture-overview.md)  
+ メタデータ アーキテクチャの全般的な概要です。  
+  
+ [メタデータ形式](../../../../docs/framework/wcf/feature-details/metadata-formats.md)  
+ さまざまなメタデータ形式について説明します。  
+  
+ [メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)  
+ メタデータをエクスポートおよびインポートする方法について説明します。  
+  
+ [メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってメタデータが公開される方法を説明します。  
+  
+ [メタデータを取得する](../../../../docs/framework/wcf/feature-details/retrieving-metadata.md)  
+ メタデータを取得するためのさまざまな方法について説明します。  
+  
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)  
+ サービス メタデータを使用するためのさまざまな方法について説明します。  
+  
+ [メタデータを使用する場合のセキュリティ上の考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-with-metadata.md)  
+ サービス メタデータを処理する際のセキュリティ上の重要な考慮事項について説明します。  
+  
+## 参照  
+ [メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/middle-tier-client-applications.md b/docs/framework/wcf/feature-details/middle-tier-client-applications.md
new file mode 100644
index 00000000000..3d545358564
--- /dev/null
+++ b/docs/framework/wcf/feature-details/middle-tier-client-applications.md
@@ -0,0 +1,46 @@
+---
+title: "中間層クライアント アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f9714a64-d0ae-4a98-bca0-5d370fdbd631
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 中間層クライアント アプリケーション
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用する中間層クライアント アプリケーション固有のさまざまな問題について説明します。  
+  
+## 中間層クライアントのパフォーマンス向上  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] を使用する Web サービスなど従来の通信技術と比べ、豊富な機能セットを備えた [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント インスタンスの作成が複雑になる場合があります。  たとえば、<xref:System.ServiceModel.ChannelFactory%601> オブジェクトを開いている場合、サービスとの間にセキュリティで保護されたセッションを確立できますが、そのぶんクライアント インスタンスの起動時間が長くなります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントはいくつかの呼び出しを実行してから閉じるため、通常、このような追加機能がクライアント アプリケーションに大きな影響を与えることはありません。  
+  
+ ただし、中間層クライアント アプリケーションは、多くの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトをすばやく作成できるので、その結果、初期化要件が増加します。  サービスを呼び出すときに中間層アプリケーションのパフォーマンスを向上させる方法は主に 2 つあります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトをキャッシュし、以降の呼び出しで可能であればそれを再利用します。  
+  
+-   <xref:System.ServiceModel.ChannelFactory%601> オブジェクトを作成し、そのオブジェクトを使用して呼び出しごとに新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネルを作成します。  
+  
+ これらの方法を使用するときに検討すべきいくつかの問題があります。  
+  
+-   サービスがセッションを使用してクライアント固有の状態を維持する場合、サービスの状態が中間層クライアントの状態に関連付けられているため、クライアント層の複数の要求を持つ中間層の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを再利用することはできません。  
+  
+-   サービスがクライアントごとに認証を実行する必要がある場合、中間層のクライアント資格情報を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント \(または <xref:System.ServiceModel.ChannelFactory%601>\) の作成後に変更できないため、中間層の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント \(または [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント チャネル オブジェクト\) を再利用するのではなく、受信要求ごとに新しいクライアントを中間層に作成する必要があります。  
+  
+-   チャネルにより作成されたチャネルとクライアントは、スレッド セーフですが複数のメッセージをネットワークに同時に書き込むことをサポートしていない場合があります。  大容量メッセージ \(特にストリーミング\) を送信すると、送信操作はブロックされ別の送信が完了するまで待機する場合があります。  チャネルを再利用するサービスに制御フローが戻った場合、これにより、同時性の欠如とデッドロックの可能性という 2 種類の問題が発生します \(つまり、共有クライアントがサービスを呼び出すと、そのコード パスは結果的に共有クライアントにコールバックします\)。  これは、再利用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの型には左右されません。  
+  
+-   チャネルを共有しているかどうかに関係なく、エラーの発生したチャネルを処理する必要があります。  ただし、チャネルを再利用するときに、エラーの発生しているチャネルは複数の保留中の要求を削除するか送信することができます。  
+  
+ 複数の要求に対してクライアントを再利用するためのベスト プラクティスが示された例については、「[ASP.NET クライアントでのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md)」を参照してください。  
+  
+ さらに、<xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるデータ型を使用するクライアントの起動時のパフォーマンスを向上したり、実行時にこのようなデータ型のシリアル化コードを生成およびコンパイルしたりできます \(この場合、起動時のパフォーマンスが低下することがあります\)。  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すると、必要なシリアル化コードをアプリケーションのコンパイル済みアセンブリから生成することで、このようなアプリケーションの起動時のパフォーマンスを改善できます。  詳細については、「[方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)」を参照してください。  
+  
+## 参照  
+ [WCF クライアントを使用したサービスへのアクセス](../../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/migrate-asp-net-web-service-client-to-wcf.md b/docs/framework/wcf/feature-details/migrate-asp-net-web-service-client-to-wcf.md
new file mode 100644
index 00000000000..1eee9573760
--- /dev/null
+++ b/docs/framework/wcf/feature-details/migrate-asp-net-web-service-client-to-wcf.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ASP.NET Web サービス クライアント コードを Windows Communication Foundation に移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e0a22a7-e1d5-4718-8997-4319a7cd9027
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : ASP.NET Web サービス クライアント コードを Windows Communication Foundation に移行する
+次の手順では、ASP.NET Web サービス クライアント コードを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行するために従う必要のある大まかな手順を説明します。  
+  
+## 手順  
+  
+#### ASP.NET Web サービス クライアント コードを WCF に移行するには  
+  
+1.  クライアントの包括的なテスト セットが存在することを確認します。  
+  
+2.  Visual Studio 2005 を使用して、クライアント アプリケーションを .NET 2.0 にアップグレードします。テスト セットを実行します。  
+  
+3.  クライアント プロジェクトから ASP.NET クライアント コードを削除します。このコードは、WSDL.exe ツールを使用して生成したモジュールにあります。  
+  
+4.  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント コードを生成します。このコードをクライアント プロジェクトに追加し、構成の出力をクライアントの既存の構成ファイルにマージします。  
+  
+5.  アプリケーションをコンパイルします。以前の ASP.NET クライアント型への参照を新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント型への参照に置き換えることで、コンパイル エラーを修正します。  
+  
+6.  テスト セットを実行します。  
+  
+## 参照  
+ [方法 : ASP.NET Web サービス コードを Windows Communication Foundation に移行する](../../../../docs/framework/wcf/feature-details/migrate-asp-net-web-service-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/migrate-asp-net-web-service-to-wcf.md b/docs/framework/wcf/feature-details/migrate-asp-net-web-service-to-wcf.md
new file mode 100644
index 00000000000..48732fae82f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/migrate-asp-net-web-service-to-wcf.md
@@ -0,0 +1,225 @@
+---
+title: "方法 : ASP.NET Web サービス コードを Windows Communication Foundation に移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e528c64f-c027-4f2e-ada6-d8f3994cf8d6
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : ASP.NET Web サービス コードを Windows Communication Foundation に移行する
+ASP.NET Web サービスを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に移行する手順を次に示します。  
+  
+## 手順  
+  
+#### ASP.NET Web サービス コードを WCF に移行するには  
+  
+1.  サービスの包括的なテスト セットが存在することを確認します。  
+  
+2.  サービスの WSDL を生成し、サービスの .asmx ファイルと同じフォルダーに保存します。  
+  
+3.  ASP.NET Web サービスをアップグレードして、.NET 2.0 を基盤として動作するようにします。  まず、.NET Framework 2.0 を IIS のアプリケーションに配置してから、Visual Studio 2005 を使用してコードを自動変換します。この自動変換の手順については、「[Visual Studio .NET 2002\/2003 から Visual Studio 2005 への Web プロジェクト変換ステップバイステップ ガイド](http://go.microsoft.com/fwlink/?LinkId=96492)」を参照してください。  テスト セットを実行します。  
+  
+4.  <xref:System.Web.Services.WebService> 属性の `Namespace` および `Name` パラメーターにまだ値を指定していない場合は、ここで明示的に指定します。  <xref:System.Web.Services.WebMethodAttribute> の `MessageName` パラメーターについても同様に値を指定してください。  メソッドに要求が送られるように SOAPAction HTTP ヘッダーに値を明示的に指定していない場合は、<xref:System.Web.Services.Protocols.SoapDocumentMethodAttribute> で `Action` パラメーターの既定値を明示的に指定します。  
+  
+    ```  
+    [WebService(Namespace = "http://tempuri.org/", Name = "Adder")]  
+    public class Adder  
+    {  
+         [WebMethod(MessageName = "Add")]  
+         [SoapDocumentMethod(Action = "http://tempuri.org/Add")]  
+         public double Add(SumInput input)  
+         {  
+              double sum = 0.00;  
+              foreach (double inputValue in input.Input)  
+              {  
+                  sum += inputValue;  
+              }  
+          return sum;  
+         }  
+    }  
+    ```  
+  
+5.  変更点をテストします。  
+  
+6.  クラスのメソッド本体にある実質的なコードを、独立した別のクラスに移動し、これを元のクラスで使用します。  
+  
+    ```  
+    [WebService(Namespace = "http://tempuri.org/", Name = "Adder")]  
+    public class Adder  
+    {  
+         [WebMethod(MessageName = "Add")]  
+         [SoapDocumentMethod(Action = "http://tempuri.org/Add")]  
+         public double Add(SumInput input)  
+         {  
+              return new ActualAdder().Add(input);  
+         }  
+    }  
+  
+    internal class ActualAdder  
+    {  
+         internal double Add(SumInput input)  
+         {  
+              double sum = 0.00;  
+              foreach (double inputValue in input.Input)  
+              {  
+                  sum += inputValue;  
+              }  
+          return sum;  
+         }  
+    }  
+    ```  
+  
+7.  変更点をテストします。  
+  
+8.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のアセンブリである System.ServiceModel および System.Runtime.Serialization の参照を ASP.NET Web サービス プロジェクトに追加します。  
+  
+9. [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行し、WSDL を基に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスを生成します。  生成されたクラス モジュールをソリューションに追加します。  
+  
+10. 前の手順で生成したクラス モジュールには、インターフェイスの定義が含まれます。  
+  
+    ```  
+    [System.ServiceModel.ServiceContractAttribute()]  
+    public interface AdderSoap  
+    {  
+         [System.ServiceModel.OperationContractAttribute(  
+          Action="http://tempuri.org/Add",   
+          ReplyAction="http://tempuri.org/Add")]  
+         AddResponse Add(AddRequest request);  
+    }  
+    ```  
+  
+     ASP.NET Web サービス クラスの定義を変更して、次のコード例のように、このインターフェイスを実装するようにします。  
+  
+    ```  
+    [WebService(Namespace = "http://tempuri.org/", Name = "Adder")]  
+    public class Adder: AdderSoap  
+    {  
+         [WebMethod(MessageName = "Add")]  
+         [SoapDocumentMethod(Action = "http://tempuri.org/Add")]  
+         public double Add(SumInput input)  
+         {  
+              return new ActualAdder().Add(input);  
+         }  
+  
+         public AddResponse Add(AddRequest request)  
+         {  
+            return new AddResponse(  
+            new AddResponseBody(  
+            this.Add(request.Body.input)));  
+         }  
+    }  
+    ```  
+  
+11. プロジェクトをコンパイルします。  手順 9. で生成したコードには型定義の重複があるため、エラーが何件か発生する可能性があります。  発生したエラーは、通常は、元からあった方の型定義を削除することで修正できます。  変更点をテストします。  
+  
+12. <xref:System.Web.Services.WebService>、<xref:System.Web.Services.WebMethodAttribute>、<xref:System.Web.Services.Protocols.SoapDocumentMethodAttribute> など、ASP.NET 固有の属性を削除します。  
+  
+    ```  
+    public class Adder: AdderSoap  
+    {  
+         public double Add(SumInput input)  
+         {  
+              return new ActualAdder().Add(input);  
+         }  
+  
+         public AddResponse Add(AddRequest request)  
+         {  
+              return new AddResponse(  
+             new AddResponseBody(  
+            this.Add(request.Body.input)));  
+         }  
+    }  
+    ```  
+  
+13. 以上の手順により、クラスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス型になりました。ASP.NET Web サービスが次のいずれかに依存する場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ASP.NET 互換モードであることを要求するよう、クラスのモードを設定します。  
+  
+    -   <xref:System.Web.HttpContext> クラス  
+  
+    -   ASP.NET プロファイル  
+  
+    -   .asmx ファイルの ACL  
+  
+    -   IIS 認証オプション  
+  
+    -   ASP.NET の偽装オプション  
+  
+    -   ASP.NET のグローバリゼーション  
+  
+    ```  
+    [System.ServiceModel.AspNetCompatibilityRequirements(  
+      RequirementsMode=AspNetCompatbilityRequirementsMode.Required)]  
+    public class Adder: AdderSoap  
+    ```  
+  
+14. 元の .asmx ファイルを .asmx.old と改名します。  
+  
+15. サービスの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス ファイルを作成し、その拡張子を .asmx として、IIS のアプリケーション ルートに保存します。  
+  
+    ```  
+    <%@Service Class="MyOrganization.Adder" %>  
+    <%@Assembly Name="MyServiceAssembly" %>   
+    ```  
+  
+16. サービスの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 構成を Web.config ファイルに追加します。  [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)を使用する設定、前の手順で作成した .asmx サービス ファイルを使用する設定、WSDL を生成する代わりに手順 2. で作成した WSDL を使用する設定を行います。  さらに、必要に応じて、ASP.NET 互換モードを使用するように設定します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+     <system.web>  
+      <compilation>  
+      <buildProviders>  
+       <remove extension=".asmx" />  
+       <add extension=".asmx"   
+        type=  
+        "System.ServiceModel.Activation.ServiceBuildProvider,  
+        T:System.ServiceModel, Version=2.0.0.0,   
+       Culture=neutral,   
+       PublicKeyToken=b77a5c561934e089" />  
+      </buildProviders>  
+      </compilation>  
+     </system.web>  
+     <system.serviceModel>  
+      <services>  
+      <service name="MyOrganization.Adder "  
+        behaviorConfiguration="AdderBehavior">  
+       <endpoint   
+        address="”  
+        binding="basicHttpBinding"  
+        contract="AdderSoap "/>  
+       </service>  
+      </services>  
+      <behaviors>  
+      <behavior name="AdderBehavior">  
+       <metadataPublishing   
+        enableMetadataExchange="true"   
+        enableGetWsdl="true"   
+        enableHelpPage="true"   
+        metadataLocation=  
+        "http://MyHost.com/AdderService/Service.WSDL"/>  
+      </behavior>  
+      </behaviors>  
+      <serviceHostingEnvironment   
+       aspNetCompatibilityEnabled ="true"/>  
+     </system.serviceModel>  
+    </configuration>  
+  
+    ```  
+  
+17. 構成を保存します。  
+  
+18. プロジェクトをコンパイルします。  
+  
+19. テスト セットを実行して、想定どおりに変更されていることを確認してください。  
+  
+## 参照  
+ [方法 : ASP.NET Web サービス クライアント コードを Windows Communication Foundation に移行する](../../../../docs/framework/wcf/feature-details/migrate-asp-net-web-service-client-to-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md b/docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md
new file mode 100644
index 00000000000..fefac442e83
--- /dev/null
+++ b/docs/framework/wcf/feature-details/migrating-aspnet-web-services-to-wcf.md
@@ -0,0 +1,50 @@
+---
+title: "ASP.NET Web サービスを WCF に移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1adbb931-f0b1-47f3-9caf-169e4edc9907
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ASP.NET Web サービスを WCF に移行する
+ASP.NET には Web サービスを構築するための .NET Framework クラス ライブラリとツールが用意されています。また、インターネット インフォメーション サービス \(IIS\) 内でサービスをホストする機能も用意されています。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、.NET Framework クラス ライブラリ、ツール、およびホスティング機能が用意されており、ソフトウェア エンティティが、Web サービスによって使用されるプロトコルを含む、任意のプロトコルを使用して通信できるようになっています。ASP.NET Web サービスから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 独自の新しい機能や強化された機能をアプリケーションで利用できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、ASP.NET Web サービスと比較した場合に重要な利点がいくつかあります。ASP.NET Web サービスのツールは Web サービスの構築専用であるのに対して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供するツールは、ソフトウェア エンティティを互いに通信させる必要がある場合にも使用できます。これにより、さまざまなソフトウェア通信シナリオを実現するために開発者が知っておく必要があるテクノロジの数が少なくて済むため、ソフトウェア開発プロジェクトが完了するまでの時間だけでなく、ソフトウェア開発リソースのコストが削減されます。  
+  
+ Web サービスの開発プロジェクトの場合でも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は ASP.NET Web サービスよりも多くの Web サービス プロトコルをサポートします。これらの追加プロトコルにより、特に信頼できるセッションとトランザクションという点で、より洗練されたソリューションが実現されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では ASP.NET Web サービスに比べ、多くのメッセージ トランスポート用プロトコルをサポートします。ASP.NET Web サービスでは、HTTP \(ハイパーテキスト転送プロトコル\) を使用したメッセージの送信しかサポートしていません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、HTTP を使用したメッセージの送信の他に、TCP \(伝送制御プロトコル\)、名前付きパイプ、MSMQ \(Microsoft メッセージ キュー\) をサポートしています。さらに重要なことは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を拡張することにより、追加のトランスポート プロトコルをサポートできることです。これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して開発されたソフトウェアは、他の多様なソフトウェアと連携するよう適合させることができるため、投資収益率を高めることができます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ASP.NET Web サービスに比べ、アプリケーションを展開および管理するための機能が格段に豊富に提供されています。ASP.NET でも用意されている構成システムに加えて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では構成エディター、任意の数の中継局を介した送信者から受信者へのアクティビティ トレース、トレース ビューアー、メッセージ ログ、多数のパフォーマンス カウンター、Windows Management Instrumentation のサポートなどが用意されています。  
+  
+ ASP.NET Web サービスと比較したときの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の潜在的な利点を考えると、ASP.NET Web サービスを使用している、または使用を検討している場合、次のようなオプションがあります。  
+  
+-   ASP.NET Web サービスの使用を継続し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供される利点については見送ります。  
+  
+-   将来的には [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用することを見据えながら、ASP.NET Web サービスの使用を継続します。このセクションのトピックでは、新規作成する ASP.NET Web サービス アプリケーションと将来の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションとを同時に使用できる可能性を最大限にする方法について説明します。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行を容易にするための、新規の ASP.NET Web サービスの構築方法についても説明します。ただし、サービスのセキュリティ保護が重要な場合、信頼性やトランザクションの確実性が求められる場合、またはカスタムの管理機能を構築する必要がある場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の採用をお勧めします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、まさにこのようなシナリオのために設計されています。  
+  
+-   新規開発については [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用し、既存の ASP.NET Web サービス アプリケーションは保持します。おそらくこれが最適な選択です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の利点を引き出しつつ、既存のアプリケーションを変更して WCF を使用できるようにするためのコストを削減できます。このシナリオでは、新規の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、既存の ASP.NET アプリケーションと共存できます。新規の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは既存の ASP.NET Web サービスを使用でき、また [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には ASP.NET 互換モードがあるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して既存の ASP.NET アプリケーションに新しい処理機能をプログラムできます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を採用し、既存の ASP.NET Web サービス アプリケーションを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行します。このオプションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供する機能を使用して既存のアプリケーションを拡張する場合、または既存の ASP.NET Web サービスの機能を新しく、より強力な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションによって作り直す場合に選択します。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが IIS 5.x によってホストされており、ASP.NET がアンインストールされている場合は注意が必要です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが IIS 5.x によってホストされていて、ASP.NET がアンインストールされている場合、サービスのコードが要求されることがあります。IIS 5.x が実行されているオペレーティング システムで ASP.NET がアンインストールされており、さらに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がアンインストールされると、拡張子 .svc を持つファイルがテキスト ファイルと見なされ、これに含まれる、ソース コードを含む内容は要求元に返されます。  
+  
+ このセクションでは、上記のオプションの詳細、ASP.NET Web サービスと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] との比較、ASP.NET Web サービスのコードを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行する方法の手順について説明します。  
+  
+## 参照  
+ [Windows Communication Foundation の採用 : 将来の移行の簡略化](../../../../docs/framework/wcf/feature-details/anticipating-adopting-wcf-migration.md)   
+ [Windows Communication Foundation 導入の準備 : 将来的な統合の容易化](../../../../docs/framework/wcf/feature-details/anticipating-adopting-the-wcf-easing-future-integration.md)   
+ [Windows Communication Foundation の採用](../../../../docs/framework/wcf/feature-details/adopting-wcf.md)   
+ [使用目的と使用標準に基づく ASP.NET Web サービスと WCF との比較](../../../../docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-purpose-and-standards-used.md)   
+ [開発者の視点から見た ASP.NET Web サービスと WCF との比較](../../../../docs/framework/wcf/feature-details/comparing-aspnet-web-services-to-wcf-based-on-development.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/migrating-net-remoting-applications-to-wcf.md b/docs/framework/wcf/feature-details/migrating-net-remoting-applications-to-wcf.md
new file mode 100644
index 00000000000..04fc98d142b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/migrating-net-remoting-applications-to-wcf.md
@@ -0,0 +1,27 @@
+---
+title: ".NET リモート処理アプリケーションの WCF への移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ", .NET リモート処理 [WCF]"
+ms.assetid: 24793465-65ae-4308-8c12-dce4fd12a583
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# .NET リモート処理アプリケーションの WCF への移行
+**このトピックの対象は、既存のアプリケーションとの下位互換性のために残されているレガシ テクノロジに特定されています。新規の開発には、このトピックを適用しないでください。現在、分散アプリケーションは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して開発する必要があります。**  
+  
+ 既存の .NET リモート処理アプリケーションから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を利用するには、統合と移行という 2 つの方法があります。統合によって、.NET Remoting 2.0 と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を並行で実行できるようになり、既存の.NET Remoting 2.0 のコードに手を加えることなく、両方のテクノロジで同時に同じビジネス オブジェクトを公開できます。統合では、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 2.0 以降が実行されている必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の機能を利用し、Remoting 2.0 システムとのネットワーク上での互換性が必要ではない場合は、サービス全体を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行できます。.NET Remoting 2.0 から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行には、リモート オブジェクトのインターフェイスとその構成設定の変更が必要になります。この両トピックについては、「[From .NET Remoting to the Windows Communication Foundation \(WCF\)](http://go.microsoft.com/fwlink/?LinkId=74403)」を参照してください。  
+  
+## 参照  
+ [概念](../../../../docs/framework/wcf/conceptual-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md b/docs/framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md
new file mode 100644
index 00000000000..00969abd118
--- /dev/null
+++ b/docs/framework/wcf/feature-details/migrating-wse-3-0-web-services-to-wcf.md
@@ -0,0 +1,136 @@
+---
+title: "WSE 3.0 Web サービスの WCF への移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7bc5fff7-a2b2-4dbc-86cc-ecf73653dcdc
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# WSE 3.0 Web サービスの WCF への移行
+WSE 3.0 Web サービスを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に移行する利点には、パフォーマンスの向上と、追加のトランスポート、追加のセキュリティ シナリオ、および WS-* 仕様のサポートなどがあります。 WSE 3.0 から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行した Web サービスでは、パフォーマンスが最大 200% から 400% 向上する可能性があります。 サポートされているトランスポートの詳細については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください[トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)します。 サポートされるシナリオの一覧については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください[一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)します。 サポートされている仕様の一覧については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください[Web サービス プロトコルの相互運用性ガイド](../../../../docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md)します。  
+  
+ 以下の各セクションでは、WSE 3.0 Web サービスの特定の機能を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行する方法についてのガイドラインを示します。  
+  
+## <a name="general"></a>全般  
+ WSE 3.0 アプリケーションと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションには、ネットワーク レベルの相互運用性と、共通の用語セットが含まれます。 WSE 3.0 アプリケーションと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、両方がサポートする WS-* 仕様セットに基づき、ネットワーク レベルで相互運用できます。 WSE 3.0 アプリケーションや [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの展開時には、WSE の設定不要なセキュリティ アサーションの名前や認証モードなど、共通の用語セットが使用されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と ASP.NET または WSE 3.0 のプログラミング モデルの間には、類似した側面が数多くありますが、同一ではありません。 詳細については、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]プログラミング モデルを参照してください[基本的なプログラミング ライフ サイクル](../../../../docs/framework/wcf/basic-programming-lifecycle.md)します。  
+  
+> [!NOTE]
+>  WSE Web サービスを WCF に移行する、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)ツールは、クライアントを生成するために使用できます。 ただし、このクライアントには、WCF サービスの開始点として使用できるインターフェイスとクラスも含まれます。 生成されるインターフェイスが、 <xref:System.ServiceModel.OperationContractAttribute>されたコントラクトのメンバーに適用される属性、 <xref:System.ServiceModel.OperationContractAttribute.ReplyAction%2A>プロパティに設定`*`します。 WSE クライアントは、この設定では、Web サービスを呼び出して、次の例外がスローされます。 **Web.services3.responseprocessingexception:: WSE910: 応答メッセージの処理中に、エラーが発生したと内部例外で、エラーが見つかります**します。 これを防ぐには、設定、 <xref:System.ServiceModel.OperationContractAttribute.ReplyAction%2A>のプロパティ、 <xref:System.ServiceModel.OperationContractAttribute>属性以外に`null`などの値`http://Microsoft.WCF.Documentation/ResponseToOCAMethod`です。  
+  
+## <a name="security"></a>セキュリティ  
+  
+### <a name="wse-30-web-services-that-are-secured-using-a-policy-file"></a>ポリシー ファイルを使用してセキュリティ保護される WSE 3.0 Web サービス  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、構成ファイルを使用してサービスをセキュリティで保護できます。この機構は、WSE 3.0 ポリシー ファイルと似ています。 WSE 3.0 でポリシー ファイルを使用して Web サービスをセキュリティ保護するときは、設定不要のセキュリティ アサーションまたはカスタム ポリシー アサーションを使用します。 設定不要のセキュリティ アサーションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ バインド要素の認証モードに厳密にマップされます。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 認証モードと WSE 3.0 の設定不要のセキュリティ アサーションには、同一または類似の名前が付けられているだけでなく、これらは同じ資格情報の種類を使用してメッセージをセキュリティ保護します。 たとえば、WSE 3.0 の設定不要の `usernameForCertificate` セキュリティ アサーションは、`UsernameForCertificate` の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 認証モードにマップされます。 WSE 3.0 の設定不要の `usernameForCertificate` セキュリティ アサーションを使用する最小ポリシーが、カスタム バインディングの `UsernameForCertificate` の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 認証モードにどのようにマップされるかを次のコード例に示します。  
+  
+ **WSE 3.0**  
+  
+```  
+<policies>  
+  <policy name="MyPolicy">  
+    <usernameForCertificate messageProtectionOrder="SignBeforeEncrypt"  
+                            requireDeriveKeys="true"/>  
+  </policy>  
+</policies>  
+```  
+  
+ **WCF**  
+  
+```  
+<customBinding>  
+  <binding name="MyBinding">  
+    <security authenticationMode="UserNameForCertificate"   
+              messageProtectionOrder="SignBeforeEncrypt"  
+              requireDerivedKeys="true"/>  
+  </binding>  
+</customBinding>  
+```  
+  
+ ポリシー ファイルで指定されている WSE 3.0 Web サービスのセキュリティ設定を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行するには、構成ファイルでカスタム バインディングを作成し、設定不要のセキュリティ アサーションを同等の認証モードに設定する必要があります。 さらに、WSE 3.0 クライアントがサービスと通信するときに 2004 年 8 月版の WS-Addressing 仕様を使用するように、カスタム バインディングを構成する必要もあります。 移行後の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが WSE 3.0 クライアントと通信する必要がなく、等価のセキュリティの保持のみが必要な場合は、カスタム バインディングを作成する代わりに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] システム定義のバインディングと適切なセキュリティ設定を使用することを考慮してください。  
+  
+ WSE 3.0 ポリシー ファイルと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の同等のカスタム バインディングとの対応関係を次の表に示します。  
+  
+|WSE 3.0 の設定不要のセキュリティ アサーション|WCF のカスタム バインド構成|  
+|----------------------------------------|--------------------------------------|  
+|<usernameOverTransportSecurity></usernameOverTransportSecurity>\>|`<customBinding>   <binding name="MyBinding">     <security authenticationMode="UserNameOverTransport" />     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+|<mutualCertificate10Security></mutualCertificate10Security>\>|`<customBinding>   <binding name="MyBinding">     <security messageSecurityVersion="WSSecurity10WSTrustFebruary2005WSSecureConversationFebruary2005WSSecurityPolicy11BasicSecurityProfile10" authenticationMode="MutualCertificate" />     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+|<usernameForCertificateSecurity></usernameForCertificateSecurity>\>|`<customBinding>   <binding name="MyBinding">     <security authenticationMode="UsernameForCertificate"/>     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+|<anonymousForCertificateSecurity></anonymousForCertificateSecurity>\>|`<customBinding>   <binding name="MyBinding">     <security authenticationMode="AnonymousForCertificate"/>     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+|<kerberosSecurity></kerberosSecurity>\>|`<customBinding>   <binding name="MyBinding">     <security authenticationMode="Kerberos"/>     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+|<mutualCertificate11Security></mutualCertificate11Security>\>|`<customBinding>   <binding name="MyBinding">     <security authenticationMode="MutualCertificate"/>     <textMessageEncoding messageVersion="Soap12WSAddressingAugust2004" />   </binding> </customBinding>`|  
+  
+ WCF でカスタム バインディングの作成の詳細については、次を参照してください。[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)します。  
+  
+### <a name="wse-30-web-services-that-are-secured-using-application-code"></a>アプリケーション コードを使用してセキュリティ保護される WSE 3.0 Web サービス  
+ WSE 3.0 と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のいずれを使用する場合でも、構成ではなくアプリケーション コードでセキュリティ要件を指定できます。 WSE 3.0 でこれを行うには、`Policy` クラスの派生クラスを作成してから、`Add` メソッドを呼び出して要件を追加します。 セキュリティ要件を指定するコードの詳細については、次を参照してください。[方法: セキュリティで保護された Web サービスなしを使用して、ポリシー ファイル](http://go.microsoft.com/fwlink/?LinkId=73747)します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]をコードでセキュリティ要件を指定してのインスタンスを作成する、 <xref:System.ServiceModel.Channels.BindingElementCollection>クラスし、インスタンスの追加、 <xref:System.ServiceModel.Channels.SecurityBindingElement>に、 <xref:System.ServiceModel.Channels.BindingElementCollection>します。 セキュリティ アサーション要件は、の静的認証モード ヘルパー メソッドを使用して設定された、 <xref:System.ServiceModel.Channels.SecurityBindingElement>クラスです。 使用してコードでのセキュリティ要件の指定の詳細については[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください[方法: SecurityBindingElement を作成するカスタム バインディングを使用して、](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)と[方法: 指定の認証モード用の SecurityBindingElement を作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)します。  
+  
+### <a name="wse-30-custom-policy-assertion"></a>WSE 3.0 カスタム ポリシー アサーション  
+ WSE 3.0 には、2 種類のカスタム ポリシー アサーションがあります。一方は SOAP メッセージをセキュリティで保護し、もう一方は SOAP メッセージをセキュリティで保護しません。 SOAP メッセージをセキュリティで保護されたポリシー アサーションは WSE 3.0 から派生`SecurityPolicyAssertion`クラスと同等の概念[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]は、 <xref:System.ServiceModel.Channels.SecurityBindingElement>クラスです。  
+  
+ 注意すべき重要な点は、WSE 3.0 の設定不要のセキュリティ アサーションは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 認証モードのサブセットであるということです。 WSE 3.0 でカスタム ポリシー アサーションを既に作成している場合は、同等の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 認証モードが存在する可能性があります。 たとえば、WSE 3.0 は、設定不要の `UsernameOverTransport` セキュリティ アサーションと等価な CertificateOverTransport セキュリティ アサーションを提供しませんが、クライアントを認証するために X.509 証明書を使用します。 このシナリオ用の独自のカスタム ポリシー アサーションを定義していれば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって移行が容易になります。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]静的認証モードの利点を構成するヘルパー メソッドを実行できるように、このシナリオでは、認証モードを定義、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] <xref:System.ServiceModel.Channels.SecurityBindingElement>します。  
+  
+ ない場合、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 、SOAP メッセージをセキュリティで保護するカスタム ポリシー アサーションと等価な認証モードからクラスを派生する<xref:System.ServiceModel.Channels.TransportSecurityBindingElement>、 <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>または<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]クラスし、等価なバインド要素を指定します。 詳細については、次を参照してください。[方法: SecurityBindingElement を作成するカスタム バインディングを使用して、](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)です。  
+  
+ SOAP メッセージを保護していないカスタム ポリシー アサーションを変換するには、次を参照してください。[フィルタ リング](../../../../docs/framework/wcf/feature-details/filtering.md)サンプルとサンプル[カスタム メッセージ インターセプター](../../../../docs/framework/wcf/samples/custom-message-interceptor.md)します。  
+  
+### <a name="wse-30-custom-security-token"></a>WSE 3.0 カスタム セキュリティ トークン  
+ カスタム トークンを作成するための [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルは、WSE 3.0 と異なります。 WSE でカスタム トークンを作成する方法については、「[カスタム セキュリティ トークンの作成](http://go.microsoft.com/fwlink/?LinkID=73750)します。 カスタム トークンを作成する方法について[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を参照してください[方法: カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)です。  
+  
+### <a name="wse-30-custom-token-manager"></a>WSE 3.0 カスタム トークン マネージャー  
+ カスタム トークン マネージャーを作成するためのプログラミング モデルは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と WSE 3.0 で異なります。 カスタム トークン マネージャーとカスタム セキュリティ トークンに必要な他のコンポーネントを作成する方法の詳細については、「[方法: カスタム トークンを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-token.md)です。  
+  
+> [!NOTE]
+>  カスタムの `UsernameToken` セキュリティ トークン マネージャーを既に作成している場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、カスタム セキュリティ マネージャーを作成するよりも簡単に認証ロジックを指定する機構が提供されています。 詳細については、次を参照してください。[方法: カスタム ユーザー名およびパスワード検証を使用して](../../../../docs/framework/wcf/feature-details/how-to-use-a-custom-user-name-and-password-validator.md)します。  
+  
+### <a name="wse-30-web-services-that-use-mtom-encoded-soap-messages"></a>MTOM エンコードされた SOAP メッセージを使用する WSE 3.0 Web サービス  
+ WSE 3.0 アプリケーションと同様に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでは、MTOM メッセージ エンコードを構成で指定できます。 この設定を移行するには、追加、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/mtommessageencoding.md) 、サービスのバインドにします。 WSE 3.0 での MTOM エンコードの指定方法と、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での等価な MTOM エンコードの指定方法を、次のコード例に示します。  
+  
+ **WSE 3.0**  
+  
+```  
+<messaging>  
+    <mtom clientMode="On"/>  
+</messaging>  
+```  
+  
+ **WCF**  
+  
+```  
+<customBinding>  
+  <binding name="MyBinding">  
+    <mtomMessageEncoding/>  
+  </binding>  
+</customBinding>  
+```  
+  
+## <a name="messaging"></a>メッセージング  
+  
+### <a name="wse-30-applications-that-use-the-wse-messaging-api"></a>WSE メッセージング API を使用する WSE 3.0 アプリケーション  
+ クライアントと Web サービス間でやり取りされる XML に直接アクセスするために WSE メッセージング API が使用されている場合は、"Plain Old XML" (POX) を使用するようにアプリケーションを変換できます。 POX の詳細については、次を参照してください。 [POX アプリケーションとの相互運用](../../../../docs/framework/wcf/feature-details/interoperability-with-pox-applications.md)します。 WSE メッセージング API の詳細については、次を参照してください。[送信および受信 SOAP メッセージを使用して WSE メッセージング API](http://go.microsoft.com/fwlink/?LinkID=73755)します。  
+  
+## <a name="transports"></a>トランスポート  
+  
+### <a name="tcp"></a>TCP  
+ 既定では、TCP トランスポートを使用して SOAP メッセージを送信する WSE 3.0 クライアントおよび Web サービスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアントおよび Web サービスと相互運用できません。 このような非互換性は、TCP プロトコルで使用されるフレームの違いとパフォーマンス上の理由に起因します。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサンプルでは、WSE 3.0 と相互運用するカスタム TCP セッションの実装方法を詳しく示しています。 詳細については、このサンプルは、次を参照してください。[トランスポート: WSE 3.0 TCP 相互運用性](../../../../docs/framework/wcf/samples/transport-wse-3-0-tcp-interoperability.md)します。  
+  
+ 指定する、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]アプリケーションは、TCP トランスポートを使用して、使用して、 [ <> \</> \>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)します。  
+  
+### <a name="custom-transport"></a>カスタム トランスポート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] において WSE 3.0 カスタム トランスポートに相当するのは、チャネル拡張です。 チャネル拡張機能の作成に関する詳細については、「[チャネル レイヤーの拡張](../../../../docs/framework/wcf/extending/extending-the-channel-layer.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [基本的なプログラミング ライフ サイクル](../../../../docs/framework/wcf/basic-programming-lifecycle.md)   
+ [カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)   
+ [方法: SecurityBindingElement を使用してカスタム バインディングを作成します。](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [方法: 指定した認証モード用の SecurityBindingElement を作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/mixing-trust-protocols-in-federated-scenarios.md b/docs/framework/wcf/feature-details/mixing-trust-protocols-in-federated-scenarios.md
new file mode 100644
index 00000000000..761f16f1838
--- /dev/null
+++ b/docs/framework/wcf/feature-details/mixing-trust-protocols-in-federated-scenarios.md
@@ -0,0 +1,108 @@
+---
+title: "Trust プロトコルが混在するフェデレーション シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d7b5fee9-2246-4b09-b8d7-9e63cb817279
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# Trust プロトコルが混在するフェデレーション シナリオ
+シナリオによっては、フェデレーション クライアントが、Trust バージョンの一致しないサービスやセキュリティ トークン サービス \(STS: Security Token Service\) と通信する場合があります。  たとえば、サービス WSDL に、STS とは異なるバージョンの WS\-Trust 要素を持つ `RequestSecurityTokenTemplate` アサーションが含まれることがあります。  このような場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントは、`RequestSecurityTokenTemplate` から受け取った WS\-Trust 要素を、STS Trust のバージョンに一致するように変換します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、標準バインディングでのみ不一致の Trust バージョンを処理します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって認識されるすべての標準アルゴリズム パラメーターは、標準バインディングの一部です。  このトピックでは、サービスと STS との間のさまざまな Trust 設定での [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作について説明します。  
+  
+## RP 2005\/02 および STS 2005\/02  
+ 証明書利用者 \(RP: Relying Party\) の WSDL には、`RequestSecurityTokenTemplate` セクション内に次の要素が含まれます。  
+  
+-   `CanonicalizationAlgorithm`  
+  
+-   `EncryptionAlgorithm`  
+  
+-   `EncryptWith`  
+  
+-   `SignWith`  
+  
+-   `KeySize`  
+  
+-   `KeyType`  
+  
+ クライアント構成ファイルには、パラメーターのリストが含まれます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、クライアント パラメーターとサービス パラメーターを区別することはできません。すべてのパラメーターが追加され、`RequestSecurityTokenTemplate` \(RST\) で送信されます。  
+  
+## RP Trust 1.3 および STS Trust 1.3  
+ RP の WSDL には、`RequestSecurityTokenTemplate` セクション内に次の要素が含まれます。  
+  
+-   `CanonicalizationAlgorithm`  
+  
+-   `EncryptionAlgorithm`  
+  
+-   `EncryptWith`  
+  
+-   `SignWith`  
+  
+-   `KeySize`  
+  
+-   `KeyType`  
+  
+-   `KeyWrapAlgorithm`  
+  
+ クライアント構成ファイルには、RP によって指定されたパラメーターをラップする `secondaryParameters` 要素が含まれます。  
+  
+ `EncryptionAlgorithm`、`CanonicalizationAlgorithm`、および `KeyWrapAlgorithm` の各要素が `SecondaryParameters` 要素の中に存在する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はこれらを RST の最上位の要素から削除します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`SecondaryParameters` 要素を変更せずに送信 RST に追加します。  
+  
+## RP Trust 2005\/02 および STS Trust 1.3  
+ RP の WSDL には、`RequestSecurityTokenTemplate` セクション内に次の要素が含まれます。  
+  
+-   `CanonicalizationAlgorithm`  
+  
+-   `EncryptionAlgorithm`  
+  
+-   `EncryptWith`  
+  
+-   `SignWith`  
+  
+-   `KeySize`  
+  
+-   `KeyType`  
+  
+ クライアント構成ファイルには、パラメーターのリストが含まれます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、クライアント構成ファイルからサービス パラメーターとクライアント パラメーターを区別することはできません。  このため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、すべてのパラメーターを Trust バージョン 1.3 の名前空間に変換します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`KeyType`、`KeySize`、および `TokenType` の各要素を次のように処理します。  
+  
+-   WSDL をダウンロードし、バインディングを作成して、`KeyType`、`KeySize`、および `TokenType` を RP パラメーターから割り当てます。  その後、クライアント構成ファイルが生成されます。  
+  
+-   この時点で、クライアントは構成ファイル内のパラメーターを変更できます。  
+  
+-   実行時には、指定されたすべてのパラメーターが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってクライアント構成ファイルの `AdditionalTokenParameters` セクションにコピーされます。ただし、`KeyType`、`KeySize`、および `TokenType` は構成ファイルの生成時に処理されるため、これらのパラメーターのコピーは行われません。  
+  
+## RP Trust 1.3 および STS Trust 2005\/02  
+ RP の WSDL には、`RequestSecurityTokenTemplate` セクション内に次の要素が含まれます。  
+  
+-   `CanonicalizationAlgorithm`  
+  
+-   `EncryptionAlgorithm`  
+  
+-   `EncryptWith`  
+  
+-   `SignWith`  
+  
+-   `KeySize`  
+  
+-   `KeyType`  
+  
+-   `KeyWrapAlgorithm`  
+  
+ クライアント構成ファイルには、RP によって指定されたパラメーターをラップする `secondaryParamters` 要素が含まれます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`SecondaryParameters` セクション内に指定されたすべてのパラメーターを最上位の RST 要素にコピーしますが、2005 WS\-Trust の名前空間には変換しません。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/net-tcp-port-sharing.md b/docs/framework/wcf/feature-details/net-tcp-port-sharing.md
new file mode 100644
index 00000000000..39d12a51209
--- /dev/null
+++ b/docs/framework/wcf/feature-details/net-tcp-port-sharing.md
@@ -0,0 +1,62 @@
+---
+title: "Net.TCP ポート共有 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ポート アクティベーション [WCF]"
+  - "ポート共有 [WCF]"
+ms.assetid: f13692ee-a179-4439-ae72-50db9534eded
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# Net.TCP ポート共有
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、高パフォーマンス通信用の新しい TCP ベースのネットワーク プロトコル \(net.tcp:\/\/\) が提供されます。  また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、net.tcp ポートを複数のユーザー プロセスで共有できる新しいシステム コンポーネントとして Net.TCP ポート共有サービスが導入されています。  
+  
+## 背景と動機  
+ TCP\/IP プロトコルの導入当初は、それを使用するアプリケーション プロトコルは少ししかありませんでした。  TCP\/IP では、ポート番号を使用して一意の 16 ビットのポート番号を各アプリケーション プロトコルに割り当てることでアプリケーションが区別されました。  たとえば、現在 HTTP トラフィックは TCP ポート 80、SMTP は TCP ポート 25、FTP は TCP ポート 20 と 21 を使用するように標準化されています。  他のアプリケーションで TCP をトランスポートとして使用する場合は、規則により、または正式な標準化を通じて別の利用可能なポート番号を選択できます。  
+  
+ ポート番号を使用してアプリケーションを区別することについては、セキュリティの問題がありました。  通常、ファイアウォールは、よく知られたわずかなエントリ ポイントを除いてすべてのポートの TCP トラフィックをブロックするよう構成されています。そのため、非標準のポートを使用するアプリケーションを展開する際に、企業のファイアウォールまたはパーソナル ファイアウォールがあるために展開が複雑になることや、展開が不可能になる場合がよくあります。  アプリケーションが、許可済みの標準の Well\-known ポートで通信できる場合は、外部攻撃の侵入経路を減らすことができます。  多くのファイアウォールは、TCP ポート 80 のトラフィックを既定で許可するよう構成されているため、多くのネットワーク アプリケーションが HTTP プロトコルを利用します。  
+  
+ 多くの異なる HTTP アプリケーションのトラフィックを 1 つの TCP ポートに多重化する HTTP.SYS モデルが、Windows プラットフォームで標準になってきました。  このモデルを使用すると、ファイアウォール管理者は共通の制御点を使用できるようになり、また、アプリケーション開発者はネットワークを利用できる新しいアプリケーションを構築する際に、展開コストを最小限にできます。  
+  
+ インターネット インフォメーション サービス \(IIS\) には、HTTP アプリケーション間でポートを共有する機能が以前からあります。  しかし、このインフラストラクチャが完全に一般化されたのは、[!INCLUDE[iis601](../../../../includes/iis601-md.md)] での HTTP.SYS \(カーネル モードの HTTP プロトコル リスナー\) の導入以降のことでした。  実際には、HTTP.SYS が、任意のユーザー プロセスで HTTP トラフィック専用の TCP ポートを共有することを許可します。  この機能により、多数の HTTP アプリケーションが同一の物理コンピューター上にそれぞれ別の独立したプロセスとして共存しながら、TCP ポート 80 でのトラフィックの送受信に必要なネットワーク インフラストラクチャを共有することができます。  Net.TCP ポート共有サービスは、net.tcp アプリケーションで同じ種類のポート共有を可能にします。  
+  
+## ポート共有アーキテクチャ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のポート共有アーキテクチャには主に 3 つのコンポーネントがあります。  
+  
+-   ワーカー プロセス : 共有ポートを使用して net.tcp:\/\/ で通信するすべてのプロセスです。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] TCP トランスポート : net.tcp:\/\/ protocol を実装します。  
+  
+-   Net.TCP ポート共有サービス : 多数のワーカー プロセスで 1 つの TCP ポートを共有できます。  
+  
+ Net.TCP ポート共有サービスは、net.tcp:\/\/ を通じて通信されるワーカー プロセスの代わりに net.tcp:\/\/ 接続を受け入れるユーザー モードの Windows サービスです。  ソケット接続が到着すると、ポート共有サービスは受信メッセージ ストリームを検査して送信先アドレスを取得します。  このアドレスを基にポート共有サービスは、最終的に処理されるアプリケーションにデータ ストリームをルーティングできます。  
+  
+ net.tcp:\/\/ ポート共有を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを開くときに、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] TCP トランスポート インフラストラクチャは、アプリケーション プロセスの TCP ソケットを直接開きません。  その代わりにトランスポート インフラストラクチャは、サービスのベース アドレス URI \(Uniform Resource Identifier\) を Net.TCP ポート共有サービスに登録し、ポート共有サービスがトランスポート インフラストラクチャの代わりにメッセージをリッスンするまで待機します。  アプリケーション サービス宛てのメッセージが到着すると、そのメッセージはポート共有サービスによりディスパッチされます。  
+  
+## ポート共有のインストール  
+ Net.TCP ポート共有サービスは、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] をサポートするすべてのオペレーティング システムで利用できますが、サービスは既定では有効にされていません。  セキュリティ予防措置として、管理者は Net.TCP ポート共有サービスを初めて使用する前に手動で有効にする必要があります。  Net.TCP ポート共有サービスでは、ポート共有サービスが所有するネットワーク ソケットのいくつかの特性を操作するための構成オプションが公開されます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : Net.TCP ポート共有サービスを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md).  
+  
+## アプリケーションでの Net.tcp ポート共有の使用  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションで net.tcp:\/\/ ポート共有を使用する最も簡単な方法は、<xref:System.ServiceModel.NetTcpBinding> を使用してサービスを公開し、<xref:System.ServiceModel.NetTcpBinding.PortSharingEnabled%2A> プロパティを使用して Net.TCP ポート共有サービスを有効にすることです。  
+  
+ その方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]「[方法 : ポート共有を使用するように WCF サービスを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md)」を参照してください。  
+  
+## ポート共有のセキュリティへの影響  
+ Net.TCP ポート共有サービスは、アプリケーションとネットワークの間に、処理を行うための 1 つの層を提供しますが、アプリケーションでポート共有を使用する場合、アプリケーションがネットワークを直接リッスンしている場合と同様に、アプリケーションをセキュリティで保護する必要があります。  具体的には、ポート共有を使用するアプリケーションでは、そのアプリケーションが実行される際のプロセス特権を評価する必要があります。  組み込みの Network Service アカウントを使用してアプリケーションを実行することを検討します。このアカウントはネットワーク通信に必要な最小限のプロセス特権のセットを使用して実行されます。  
+  
+## 参照  
+ [Net.TCP ポート共有サービスを構成する](../../../../docs/framework/wcf/feature-details/configuring-the-net-tcp-port-sharing-service.md)   
+ [ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)   
+ [方法 : ポート共有を使用するように WCF サービスを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-wcf-service-to-use-port-sharing.md)   
+ [方法 : Net.TCP ポート共有サービスを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/one-way-services.md b/docs/framework/wcf/feature-details/one-way-services.md
new file mode 100644
index 00000000000..ef0ae4a32e4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/one-way-services.md
@@ -0,0 +1,65 @@
+---
+title: "一方向サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], 一方向の定義"
+  - "WCF [WCF], 一方向のサービス コントラクト"
+  - "Windows Communication Foundation [WCF], 一方向のサービス コントラクト"
+ms.assetid: 19053a36-4492-45a3-bfe6-0365ee0205a3
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 一方向サービス
+サービス操作の既定の動作は、要求\/応答パターンです。要求\/応答パターンでは、サービス操作がコードで `void` 型のメソッドとして表される場合であっても、クライアントは応答メッセージを待機します。一方向操作では、メッセージが 1 つ送信されるだけです。受信者は応答メッセージを送信せず、送信者もこれを待機しません。  
+  
+ 一方向デザイン パターンは次の場合に使用します。  
+  
+-   クライアントが操作を呼び出す必要があり、操作レベルで操作の結果に影響を受けない場合。  
+  
+-   <xref:System.ServiceModel.NetMsmqBinding> クラスまたは <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> クラスを使用している場合 \(このシナリオ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF のキュー](../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)」を参照してください\)。  
+  
+ 操作が一方向の場合、エラー情報をクライアントに伝達する応答メッセージはありません。エラー状態を検出するには、信頼できるセッションのような基になるバインディングの機能を使用できます。また、2 つの一方向操作 \(1 つは、サービス操作を呼び出すための、クライアントからサービスへの一方向コントラクト、もう 1 つは、クライアントが実装するコールバックを使用してサービスがエラーを返せるようにする、サービスとクライアントの間の一方向コントラクト\) を使用する双方向サービス コントラクトをデザインすることもできます。  
+  
+ 一方向サービス コントラクトを作成するには、サービス コントラクトを定義し、<xref:System.ServiceModel.OperationContractAttribute> クラスを各操作に適用し、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティを `true` に設定します。次のコードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOneWayCalculator  
+{  
+    [OperationContract(IsOneWay=true)]  
+    void Add(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Subtract(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Multiply(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Divide(double n1, double n2);  
+}  
+```  
+  
+ 完全な例については、「[一方向](../../../../docs/framework/wcf/samples/one-way.md)」のサンプルを参照してください。  
+  
+## 一方向操作でのクライアントのブロック  
+ 一方向アプリケーションの中には、送信データをネットワーク接続に書き込むとすぐに処理を終了するものがある一方で、バインディングまたはサービスの実装により [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが一方向操作を使用できなくなるというシナリオもあることを理解することが重要です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションでは、送信データがネットワーク接続に書き込まれるまで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトは処理を終了しません。これは一方向操作を含め、すべてのメッセージ交換パターンについて当てはまることで、トランスポートへのデータの書き込みに何らかの問題があると、クライアントが処理を終了できなくなることを意味します。問題の種類によっては、例外が発生したりサービスへのメッセージの送信に遅延が発生したりする結果となることがあります。  
+  
+ たとえば、トランスポートがエンドポイントを見つけられない場合、大きな遅延なしに <xref:System.ServiceModel.EndpointNotFoundException?displayProperty=fullName> 例外がスローされます。ただし、サービスが何らかの理由によりデータをネットワークから読み込めないために、クライアントのトランスポート送信操作が終了しない可能性もあります。このような場合、クライアントのトランスポート バインディングで <xref:System.ServiceModel.Channels.Binding.SendTimeout%2A?displayProperty=fullName> 期間が経過すると、<xref:System.TimeoutException?displayProperty=fullName> がスローされますが、タイムアウト時間が経過するまで例外はスローされません。またサービスに多数のメッセージが集中しているために、一定の期間が経過するまでサービスがメッセージを処理できないことがあります。この場合も、サービスがメッセージを処理できるまで、または例外がスローされるまで、一方向クライアントはブロックします。  
+  
+ さらに別の状況として、サービスの <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A?displayProperty=fullName> プロパティが <xref:System.ServiceModel.ConcurrencyMode> に設定されているのに、バインディングが複数のセッションを使用する場合があります。この場合、ディスパッチャーにより受信メッセージの並び替え \(セッションの要件\) が強制され、サービスがそのセッションの以前のメッセージの処理を終えるまで、後続のメッセージはネットワークから読み込まれません。この場合も、クライアントはブロックしますが、例外が発生するかどうかは、サービスがこのクライアントで設定されているタイムアウト期間が経過する前に、待機中のデータを処理できるかどうかによって異なります。  
+  
+ この問題を軽減するには、クライアント オブジェクトとクライアントのトランスポート送信操作との間にバッファーを挿入します。たとえば、非同期呼び出しまたはメモリ内メッセージ キューを使用すると、クライアント オブジェクトの処理を短時間で終了できます。どちらのアプローチでも機能性は向上しますが、スレッド プールとメッセージ キューのサイズによる制限は残ります。  
+  
+ 代わりに、クライアントおよびサービスの各種コントロールを調べてアプリケーション シナリオをテストし、最適な構成がどちら側にあるのかを判断することをお勧めします。たとえば、セッションの使用によりサービスでのメッセージの処理がブロックされている場合、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.InstanceContextMode> に設定することによって、異なるサービス インスタンスによって各メッセージが処理されるようにし、また <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> を <xref:System.ServiceModel.ConcurrencyMode> に設定することによって、複数のスレッドで同時にメッセージをディスパッチできるようにします。また、別のアプローチとして、サービスとクライアント バインディングの読み取りクォータを増やすという方法もあります。  
+  
+## 参照  
+ [一方向](../../../../docs/framework/wcf/samples/one-way.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/ordered-processing-of-messages-in-single-concurrency-mode.md b/docs/framework/wcf/feature-details/ordered-processing-of-messages-in-single-concurrency-mode.md
new file mode 100644
index 00000000000..d7bf2b3bf97
--- /dev/null
+++ b/docs/framework/wcf/feature-details/ordered-processing-of-messages-in-single-concurrency-mode.md
@@ -0,0 +1,38 @@
+---
+title: "Single 同時実行モードでメッセージを順番に処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a90f5662-a796-46cd-ae33-30a4072838af
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# Single 同時実行モードでメッセージを順番に処理する
+WCF では、基になるチャネルがセッションフルでない場合、メッセージを処理する順序については保証されません。たとえば、セッションフル チャネルではない MsmqInputChannel を使用する WCF サービスでは、メッセージを順番に処理できません。開発者には、セッションを使用しないで、順番どおりの処理動作が必要な場合があります。このトピックでは、サービスが Single 同時実行モードで実行されている場合に、この動作を構成する方法について説明します。  
+  
+## 順番に従ったメッセージの処理  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute.EnsureOrderedDispatch%2A> という名前の新しい属性が <xref:System.ServiceModel.ServiceBehaviorAttribute> に追加されました。<xref:System.ServiceModel.ServiceBehaviorAttribute.EnsureOrderedDispatch%2A> を true に設定し、<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> を <xref:System.ServiceModel.ConcurrencyMode> に設定すると、サービスに送信されたメッセージは順番に処理されます。次のコード スニペットは、これらの属性の設定方法を示しています。  
+  
+```  
+[ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Single, EnsureOrderedDispatch = true )]  
+    class Service : IService  
+    {  
+         // ...  
+    }  
+  
+```  
+  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> を他の値に設定すると、<xref:System.InvalidOperationException> がスローされます。  
+  
+## 参照  
+ [セッション、インスタンス化、および同時実行](../../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)   
+ [同時実行](../../../../docs/framework/wcf/samples/concurrency.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/out-of-order-message-processing.md b/docs/framework/wcf/feature-details/out-of-order-message-processing.md
new file mode 100644
index 00000000000..365304b5e65
--- /dev/null
+++ b/docs/framework/wcf/feature-details/out-of-order-message-processing.md
@@ -0,0 +1,48 @@
+---
+title: "順番を無視したメッセージの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33fc62a5-5d59-461c-a37a-0e1b51ac763d
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 順番を無視したメッセージの処理
+ワークフロー サービスは、特定の順序で送信されるメッセージに依存する場合があります。ワークフロー サービスには 1 つ以上の <xref:System.ServiceModel.Activities.Receive> アクティビティが含まれ、それぞれの <xref:System.ServiceModel.Activities.Receive> アクティビティは特定のメッセージに対応しています。特定のトランスポート配信保証がないと、クライアントから送信されるメッセージに遅延が生じ、それによって、ワークフロー サービスが予期しない順序でメッセージが配信されることがあります。特定の順序でメッセージが送信されることを必要としないワークフローは、通常、Parallel アクティビティを使用して実装されます。アプリケーション プロトコルがより複雑な場合は、ワークフローがすぐに複雑になります。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のメッセージ処理機能では、順番が無視されるため、入れ子になった複雑な Parallel アクティビティを含まないワークフローを作成できます。順番を無視したメッセージ処理は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] MSMQ バインディングなど、<xref:System.ServiceModel.Channele.ReceiveContext> に対応するチャネルでのみサポートされます。  
+  
+## 順番を無視したメッセージ処理の有効化  
+ 順番を無視したメッセージ処理は、ワークフロー サービスで <xref:System.ServiceModel.Activities.WorkflowService.AllowBufferedReceive%2A> プロパティを `true` に設定することで有効化できます。次の例は、コードで <xref:System.ServiceModel.Activities.WorkflowService.AllowBufferedReceive%2A> プロパティを設定する方法を示しています。  
+  
+```csharp  
+// Code: Opt-in to Buffered Receive processing...  
+WorkflowService service = new WorkflowService  
+{  
+    Name="MyService",  
+    Body = workflow,  
+    AllowBufferedReceive = true  
+};  
+  
+```  
+  
+ また、次の例に示すように、XAML で `AllowBufferedReceive` 属性をワークフロー サービスに適用することもできます。  
+  
+```xaml  
+// Xaml: Opt-in to Buffered Receive processing...  
+<WorkflowService AllowBufferedReceive="True">  
+   <!—the actual children activities -->  
+</Sequence>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.ReceiveContext>   
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [キューと信頼できるセッション](../../../../docs/framework/wcf/feature-details/queues-and-reliable-sessions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/partial-trust-best-practices.md b/docs/framework/wcf/feature-details/partial-trust-best-practices.md
new file mode 100644
index 00000000000..b1868913ebd
--- /dev/null
+++ b/docs/framework/wcf/feature-details/partial-trust-best-practices.md
@@ -0,0 +1,77 @@
+---
+title: "部分信頼のベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d052bc0-5b98-4c50-8bb5-270cc8a8b145
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 部分信頼のベスト プラクティス
+このトピックでは、部分信頼環境で [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を実行する場合のベスト プラクティスについて説明します。  
+  
+## シリアル化  
+ 部分信頼アプリケーションで <xref:System.Runtime.Serialization.DataContractSerializer> を使用する場合は、次の方法を適用します。  
+  
+-   すべてのシリアル化可能な型は、`[DataContract]` 属性で明示的にマークする必要があります。次の手法は、部分信頼環境ではサポートされていません。  
+  
+-   シリアル化するクラスを <xref:System.SerializableAttribute> でマークする。  
+  
+-   クラスでシリアル化プロセスを制御できるように <xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装する。  
+  
+### DataContractSerializer の使用  
+  
+-   `[DataContract]` 属性でマークされたすべての型は、パブリックである必要があります。部分信頼環境では、非パブリック型はシリアル化できません。  
+  
+-   シリアル化できる `[DataContract]` 型のすべての `[DataContract]` メンバーは、パブリックである必要があります。部分信頼環境では、非パブリック `[DataMember]` 型はシリアル化できません。  
+  
+-   `OnSerializing`、`OnSerialized`、`OnDeserializing`、`OnDeserialized` などのシリアル化イベントを処理するメソッドは、パブリックとして宣言する必要があります。ただし、明示的および暗黙的な <xref:System.Runtime.Serialization.IDeserializationCallback.OnDeserialization%28System.Object%29> の実装は、いずれもサポートされています。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> は、逆シリアル化の間に新しくインスタンス化されたオブジェクトのコンストラクターを呼び出さないため、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> でマークされて、アセンブリで実装された `[DataContract]` 型は、型コンストラクターでセキュリティ関連の操作を実行することはできません。特に、`[DataContract]` 型では、次の一般的なセキュリティ手法の使用を避ける必要があります。  
+  
+-   型のコンストラクターを内部またはプライベートにすることにより、部分信頼アクセスを制限する。  
+  
+-   型のコンストラクターに `[LinkDemand]` を追加することにより、型へのアクセスを制限する。  
+  
+-   オブジェクトが正常にインスタンス化されたため、コンストラクターが強制するチェックがすべて正常に終了したと仮定する。  
+  
+### IXmlSerializable の使用  
+ <xref:System.Xml.Serialization.IXmlSerializable> を実装し、<xref:System.Runtime.Serialization.DataContractSerializer> を使用してシリアル化される型に適用されるベスト プラクティスを次に示します。  
+  
+-   静的 <xref:System.Xml.Serialization.IXmlSerializable.GetSchema%2A> メソッドの実装は、`public` とする必要があります。  
+  
+-   <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装するインスタンス メソッドは、`public` とする必要があります。  
+  
+## 部分信頼の呼び出し元から呼び出せる完全信頼のプラットフォーム コードで WCF を使用する  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の部分信頼セキュリティ モデルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] パブリック メソッドまたはプロパティのすべての呼び出し元は、ホスト アプリケーションのコード アクセス セキュリティ \(CAS: Code Access Security\) コンテキストで実行されていることを前提としています。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、各 <xref:System.AppDomain> に対して存在するアプリケーション セキュリティ コンテキストが 1 つのみであり、このコンテキストが <xref:System.AppDomain.CreateDomain%2A> への呼び出しまたは、ASP.NET アプリケーション マネージャーなどの信頼されているホストにより、<xref:System.AppDomain> 作成時に確立されることを前提としています。  
+  
+ このセキュリティ モデルは、信頼性が "中" の ASP.NET アプリケーションで実行されているユーザー コードなど、追加の CAS アクセス許可をアサートできないユーザー記述のアプリケーションに適用されます。ただし、完全信頼のプラットフォーム コード \(たとえば、グローバル アセンブリ キャッシュにインストールされているサード パーティ アセンブリや、部分信頼コードからの呼び出しを受け入れるサード パーティ アセンブリなど\) は、アプリケーション レベルのセキュリティの脆弱性が発生しないよう、部分信頼アプリケーションに代わって [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を呼び出す場合に、明示的な注意を行う必要があります。  
+  
+ 完全信頼コードでは、部分信頼コードに代わって [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] API を呼び出す前に、<xref:System.Security.PermissionSet.Assert%2A>、<xref:System.Security.PermissionSet.PermitOnly%2A>、または <xref:System.Security.PermissionSet.Deny%2A> を呼び出して、現在のスレッドの CAS アクセス許可セットを変更しないようにする必要があります。アプリケーション レベルのセキュリティ コンテキストに依存しないスレッド固有のアクセス許可コンテキストのアサート、拒否、または作成により、予期しない動作が発生することがあります。アプリケーションによっては、この動作がアプリケーション レベルのセキュリティの脆弱性となることがあります。  
+  
+ 次のような状況の発生に対処するには、スレッド固有のアクセス許可コンテキストを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を呼び出すコードを準備する必要があります。  
+  
+-   スレッド固有のセキュリティ コンテキストを処理の期間全体にわたっては保持できない場合があり、このときセキュリティの例外が発生する可能性があります。  
+  
+-   内部 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コードとユーザーが指定したコールバックが、呼び出しが開始された元のセキュリティ コンテキストとは異なるセキュリティ コンテキストで実行される場合があります。次のようなコンテキストが含まれます。  
+  
+    -   アプリケーションのアクセス許可コンテキスト。  
+  
+    -   現在実行している <xref:System.AppDomain> の有効期間中に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の呼び出しに使用される他のユーザー スレッドが以前に作成したスレッド固有のアクセス許可コンテキスト。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] パブリック API の呼び出しの前に、完全信頼コンポーネントによってこのようなアクセス許可がアサートされない限り、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、部分信頼コードで完全信頼アクセス許可を取得できないことが保証されます。ただし、完全信頼をアサートした効果が特定のスレッド、操作、またはユーザー操作として隔離されることは保証されません。  
+  
+ <xref:System.Security.PermissionSet.Assert%2A>、<xref:System.Security.PermissionSet.PermitOnly%2A>、または <xref:System.Security.PermissionSet.Deny%2A> を呼び出すことにより、スレッド固有のアクセス許可コンテキストを作成しないことをお勧めします。代わりに、<xref:System.Security.PermissionSet.Assert%2A>、<xref:System.Security.PermissionSet.Deny%2A>、または <xref:System.Security.PermissionSet.PermitOnly%2A> が不要となるように、アプリケーション自体に特権を付与するか、特権を拒否します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Xml.Serialization.IXmlSerializable>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md b/docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md
new file mode 100644
index 00000000000..241449d97f6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md
@@ -0,0 +1,175 @@
+---
+title: "部分信頼機能の互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a36a540b-1606-4e63-88e0-b7c59e0e6ab7
+caps.latest.revision: 75
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 74
+---
+# 部分信頼機能の互換性
+部分信頼環境で実行される場合、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でサポートされる機能は、限られたサブセットになります。 部分信頼でサポートされる機能は、「[サポートされている配置シナリオ](../../../../docs/framework/wcf/feature-details/supported-deployment-scenarios.md)」のトピックで説明される特定のシナリオを念頭にデザインされています。  
+  
+## 最小のアクセス許可の要件  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、次の標準の名前付きアクセス許可セットのいずれかで実行されるアプリケーションの機能のサブセットをサポートします。  
+  
+-   中程度の信頼アクセス許可  
+  
+-   インターネット ゾーン アクセス許可  
+  
+ これよりも制限の厳しいアクセス許可が設定された部分信頼アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、実行時にセキュリティ例外が発生することがあります。  
+  
+## コントラクト  
+ 部分信頼で実行される場合、コントラクトには次の制限があります。  
+  
+-   `[ServiceContract]` インターフェイスを実装するサービス クラスは、`public` であること、および `public` コンストラクターを持っていることが必要です。 このクラスで `[OperationContract]` メソッドを定義する場合、それらも `public` である必要があります。 代わりに `[ServiceContract]` インターフェイスを実装する場合は、`private` インターフェイスが `[ServiceContract]` であれば、それらのメソッド実装は明示的でも `public` でもかまいません。  
+  
+-   `[ServiceKnownType]` 属性を使用するときは、指定するメソッドは `public` である必要があります。  
+  
+-   `[MessageContract]` クラスとそのメンバーは、`public` である場合があります。`[MessageContract]` クラスがアプリケーション アセンブリで定義されている場合は、`internal` であり、`internal` メンバーを持つ場合があります。  
+  
+## システム標準のバインディング  
+ 部分信頼環境では、<xref:System.ServiceModel.BasicHttpBinding> と <xref:System.ServiceModel.WebHttpBinding> が完全にサポートされています。<xref:System.ServiceModel.WSHttpBinding> は、トランスポート セキュリティ モードでのみサポートされます。  
+  
+ <xref:System.ServiceModel.NetTcpBinding>、<xref:System.ServiceModel.NetNamedPipeBinding>、または <xref:System.ServiceModel.NetMsmqBinding> など、HTTP 以外のトランスポートを使用するバインディングは、部分信頼環境で実行される場合はサポートされません。  
+  
+## カスタム バインディング  
+ 部分信頼環境ではカスタム バインディングの作成と使用が可能ですが、このセクションに示した制限に従う必要があります。  
+  
+### トランスポート  
+ 使用できるトランスポート バインド要素は、<xref:System.ServiceModel.Channels.HttpTransportBindingElement> と <xref:System.ServiceModel.Channels.HttpsTransportBindingElement> に限られます。  
+  
+### エンコーダー  
+ 次のエンコーダーを指定できます。  
+  
+-   テキスト エンコーダー \(<xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>\)  
+  
+-   バイナリ エンコーダー \(<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement>\)  
+  
+-   Web メッセージ エンコーダー \(<xref:System.ServiceModel.Channels.WebMessageEncodingBindingElement>\)  
+  
+ MTOM \(Message Transmission Optimization Mechanism\) エンコーダーはサポートされていません。  
+  
+### セキュリティ  
+ 部分信頼アプリケーションは、通信をセキュリティで保護するために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランスポート レベルのセキュリティ機能を使用することがあります。 メッセージ レベルのセキュリティはサポートされていません。 メッセージ レベルのセキュリティを使用するようにバインディングを構成すると、実行時に例外が発生します。  
+  
+### サポートされないバインディング  
+ 信頼できるメッセージング、トランザクション、またはメッセージ レベルのセキュリティを使用するバインディングはサポートされません。  
+  
+## シリアル化  
+ 部分信頼環境では、<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Xml.Serialization.XmlSerializer> の両方がサポートされています。 ただし、<xref:System.Runtime.Serialization.DataContractSerializer> の使用は、次の条件に従う必要があります。  
+  
+-   シリアル化可能なすべての `[DataContract]` 型は `public` である必要があります。  
+  
+-   `[DataMember]` 型にあるシリアル化可能なすべての `[DataContract]` フィールドまたはプロパティは、パブリックで読み書き可能である必要があります。[読み取り専用](http://go.microsoft.com/fwlink/?LinkID=98854)フィールドのシリアル化と逆シリアル化は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を部分信頼アプリケーションで実行する場合にはサポートされません。  
+  
+-   部分信頼環境では、`[Serializable]`\/ISerializable プログラミング モデルはサポートされていません。  
+  
+-   既知の型はコード内、またはマシン レベルの構成 \(machine.config\) で指定する必要があります。 既知の型はセキュリティ上の理由からアプリケーション レベルの構成では指定できません。  
+  
+-   <xref:System.Runtime.Serialization.IObjectReference> を実装する型は、部分信頼環境では例外をスローします。  
+  
+ 部分信頼アプリケーションで <xref:System.Runtime.Serialization.DataContractSerializer> を安全に使用する場合のセキュリティ情報の詳細については、「[部分信頼のベスト プラクティス](../../../../docs/framework/wcf/feature-details/partial-trust-best-practices.md)」のシリアル化のセクションを参照してください。  
+  
+### コレクション型  
+ コレクション型の中には、<xref:System.Collections.Generic.IEnumerable%601> と <xref:System.Collections.IEnumerable> の両方を実装するものがあります。 たとえば、<xref:System.Collections.Generic.ICollection%601> を実装する型がこれに当たります。 このような型では、`public` の `GetEnumerator()` な実装と、`GetEnumerator()` の明示的な実装を実装できます。 この場合、<xref:System.Runtime.Serialization.DataContractSerializer> は `public` の `GetEnumerator()` な実装を呼び出し、`GetEnumerator()` の明示的な実装は呼び出しません。`GetEnumerator()` 実装のいずれも `public` ではなく、すべてが明示的な実装である場合、<xref:System.Runtime.Serialization.DataContractSerializer> は `IEnumerable.GetEnumerator()` を呼び出します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が部分信頼環境で実行されているときに、コレクション型の `GetEnumerator()` の実装がどれも `public` ではなく、またそのどれもが明示的なインターフェイスの実装でない場合は、セキュリティ例外がスローされます。  
+  
+### NetDataContractSerializer  
+ 部分信頼の場合、<xref:System.Collections.Generic.List%601>、<xref:System.Collections.ArrayList>、<xref:System.Collections.Generic.Dictionary%602>、および <xref:System.Collections.Hashtable> などの、.NET Framework コレクション型の多くは、<xref:System.Runtime.Serialization.NetDataContractSerializer> によってサポートされていません。 これらの型には `[Serializable]` 属性セットがあり、シリアル化のセクションで説明したように、この属性は部分信頼ではサポートされません。<xref:System.Runtime.Serialization.DataContractSerializer> はコレクションを特殊な方法で扱うため、この制限を回避できますが、<xref:System.Runtime.Serialization.NetDataContractSerializer> には、この制限の適用を避けるメカニズムはありません。  
+  
+ <xref:System.DateTimeOffset> 型は、部分信頼では <xref:System.Runtime.Serialization.NetDataContractSerializer> によってサポートされません。  
+  
+ 部分信頼で実行するときは、\(<xref:System.Runtime.Serialization.NetDataContractSerializer> メカニズムを使用して\) <xref:System.Runtime.Serialization.SurrogateSelector> でサロゲートを使用できません。 この制限は、シリアル化ではなく、サロゲートの使用に適用されることに注意してください。  
+  
+## 実行する共通動作の有効化  
+ アプリケーションが部分信頼環境で実行されている場合、構成ファイルの [\<commonBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/commonbehaviors.md) セクションに追加された <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性 \(APTCA\) でマークされていないサービス動作またはエンドポイント動作は実行されません。この場合、動作が実行されなくても、例外はスローされません。 共通動作を強制的に実行するには、次のいずれかを行う必要があります。  
+  
+-   共通動作を <xref:System.Security.AllowPartiallyTrustedCallersAttribute> 属性でマークし、部分信頼アプリケーションとして展開したときに実行できるようにします。 APTCA でマークされたアセンブリを実行できないように、コンピューターでレジストリ エントリを設定できます。 」を参照してください。  
+  
+-   アプリケーションが完全信頼アプリケーションとして配置されている場合に、ユーザーが部分信頼環境でアプリケーションを実行するようにコード アクセス セキュリティ設定を変更できないことを確認します。 ユーザーがこのような変更を行うことができる場合、動作は実行されず、例外もスローされません。 これを確認するためには、[Caspol.exe \(コード アクセス セキュリティ ポリシー ツール\)](../../../../docs/framework/tools/caspol-exe-code-access-security-policy-tool.md) を使用した**levelfinal** オプションを参照してください。  
+  
+ 共通動作[!INCLUDE[crexample](../../../../includes/crexample-md.md)]、「[方法 : 企業内のエンドポイントをロックダウンする](../../../../docs/framework/wcf/extending/how-to-lock-down-endpoints-in-the-enterprise.md)」を参照してください。  
+  
+## 構成  
+ 1 つの例外を除き、部分信頼コードは、ローカルの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ファイルにある `app.config` 構成セクションのみを読み込むことができます。 machine.config ファイルまたはルート web.config ファイルの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セクションを参照する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 構成セクションを読み込むには、ConfigurationPermission\(Unrestricted\) が必要です。 このアクセス許可がない場合、ローカルの構成ファイル外の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 構成セクション \(behaviors、bindings\) を参照すると、構成の読み込み時に例外が発生します。  
+  
+ 例外は、このトピックのシリアル化のセクションで説明したように、シリアル化の既知の型の構成です。  
+  
+> [!IMPORTANT]
+>  構成の拡張は、完全信頼で実行される場合にのみサポートされます。  
+  
+## 診断  
+  
+### イベント ログ  
+ 部分信頼では、限定されたイベント ログがサポートされます。 イベント ログには、サービス アクティベーション エラーおよびトレース\/メッセージ ログ エラーのみが記録されます。 イベント ログに過剰な数のメッセージが書き込まれないように、ログに記録できるイベントの最大数は 5 つです。  
+  
+### メッセージ ログ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が部分信頼環境で実行されていると、メッセージ ログは動作しません。 部分信頼環境下で有効になっても、サービスのアクティブ化には失敗しませんが、メッセージはログに記録されません。  
+  
+### トレース  
+ 部分信頼環境で実行される場合、利用できるトレース機能には制限があります。 構成ファイルの \<`listeners`\> 要素に追加できる型は <xref:System.Diagnostics.TextWriterTraceListener> と新しい <xref:System.Diagnostics.EventSchemaTraceListener> に限られます。 標準の <xref:System.Diagnostics.XmlWriterTraceListener> を使用すると、ログが不完全または不正確になります。  
+  
+ 次のトレース ソースがサポートされています。  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.Runtime.Serialization>  
+  
+-   <xref:System.IdentityModel.Claims>、<xref:System.IdentityModel.Policy>、<xref:System.IdentityModel.Selectors>、および <xref:System.IdentityModel.Tokens>。  
+  
+ 次のトレース ソースはサポートされていません。  
+  
+-   CardSpace  
+  
+-   <xref:System.IO.Log>  
+  
+-   <xref:System.ServiceModel.Internal.TransactionBridge>  
+  
+ <xref:System.Diagnostics.TraceOptions> 列挙体の次のメンバーは指定できません。  
+  
+-   <xref:System.Diagnostics.TraceOptions>  
+  
+-   <xref:System.Diagnostics.TraceOptions.ProcessID>  
+  
+ 部分信頼環境でトレースを使用する場合は、アプリケーションにトレース リスナーの出力を保存するための十分なアクセス許可があることを確認します。 たとえば、<xref:System.Diagnostics.TextWriterTraceListener> を使用してトレース出力をテキスト ファイルに書き込む場合は、アプリケーションにトレース ファイルを書き込むために必要な FileIOPermission があることを確認します。  
+  
+> [!NOTE]
+>  トレース ファイルが重複したエラーでいっぱいになるのを防ぐために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では最初のセキュリティ エラーの後でリソースまたはアクションのトレースを無効にします。 リソースへのアクセスまたはアクションの実行が初めて行われようとしたとき、例外トレースはリソース アクセスの各失敗に対して、1 回だけ行われます。  
+  
+## WCF サービス ホスト  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス ホストは、部分信頼をサポートしません。 部分信頼において [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを使用する場合は、サービスをビルドするために [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] にある [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] サービス ライブラリ プロジェクト テンプレートを使用しないでください。 代わりに、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] 部分信頼がサポートされている Web サーバーでサービスをホストできる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス Web サイト テンプレートを選択して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に新しい Web サイトを作成します。  
+  
+## 他の制約  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は通常、ホスト アプリケーションによってもたらされるセキュリティ上の考慮事項によって制限されます。 たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が XAML ブラウザー アプリケーション \(XBAP\) でホストされている場合は、「[Windows Presentation Foundation 部分信頼セキュリティ](http://go.microsoft.com/fwlink/?LinkId=89138)」で説明されているように、XBAP の制限に従うことになります。  
+  
+ 次の追加機能は indigo2 が部分信頼環境で実行されていると有効になりません。  
+  
+-   WMI \(Windows Management Instrumentation\)  
+  
+-   イベント ログは部分的にしか有効になりません \(診断のセクションの説明を参照\)。  
+  
+-   パフォーマンス カウンター  
+  
+ 部分信頼環境でサポートされていない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 機能を使用すると、実行時に例外が発生することがあります。  
+  
+## 記載されていない機能  
+ 部分信頼環境で利用できない情報やアクションを見つけ出す最善の方法は、リソースへのアクセスまたはアクションの実行を `try` ブロックの内側で試みて、エラーを `catch` することです。 トレース ファイルが重複したエラーでいっぱいになるのを防ぐために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では最初のセキュリティ エラーの後でリソースまたはアクションのトレースを無効にします。 リソースへのアクセスまたはアクションの実行が初めて行われようとしたとき、例外トレースはリソース アクセスの各失敗に対して、1 回だけ行われます。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement>   
+ <xref:System.ServiceModel.Channels.WebMessageEncodingBindingElement>   
+ [サポートされている配置シナリオ](../../../../docs/framework/wcf/feature-details/supported-deployment-scenarios.md)   
+ [部分信頼のベスト プラクティス](../../../../docs/framework/wcf/feature-details/partial-trust-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/partial-trust.md b/docs/framework/wcf/feature-details/partial-trust.md
new file mode 100644
index 00000000000..cd01a3f047f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/partial-trust.md
@@ -0,0 +1,30 @@
+---
+title: "部分信頼 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 489b1587-9909-4d0e-8c1a-5e83c8f8292b
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 部分信頼
+[!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] 以降では、部分的に信頼された呼び出し元は、<xref:System.ServiceModel>、<xref:System.Runtime.Serialization>、および <xref:System.ServiceModel.Web> に実装されたパブリック型とパブリック メソッドにアクセスできます。このセクションでは、部分的に信頼されたアプリケーション内における [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の使用でサポートされるシナリオと、コード アクセス セキュリティ \(CAS: Code Access Security\) のアクセス許可レベルを下げて実行されるアプリケーションで利用できる、限られた [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 機能について説明します。  
+  
+## このセクションの内容  
+ [サポートされている配置シナリオ](../../../../docs/framework/wcf/feature-details/supported-deployment-scenarios.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を実行するための主な部分信頼シナリオについて説明します。  
+  
+ [部分信頼機能の互換性](../../../../docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md)  
+ 部分信頼では使用できない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 機能について説明します。  
+  
+ [部分信頼のベスト プラクティス](../../../../docs/framework/wcf/feature-details/partial-trust-best-practices.md)  
+ 部分信頼アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用するためのベスト プラクティスを紹介します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-channel-concepts.md b/docs/framework/wcf/feature-details/peer-channel-concepts.md
new file mode 100644
index 00000000000..f56360c1232
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-channel-concepts.md
@@ -0,0 +1,32 @@
+---
+title: "ピア チャネルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 379c2c0b-a44f-4423-9480-4739e7f18614
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ピア チャネルの概要
+このセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のピア チャネルを構成する概念について簡単に説明します。  
+  
+## このセクションの内容  
+ [ピア メッシュ](../../../../docs/framework/wcf/feature-details/peer-meshes.md) : ピア チャネルを使用して作成するメッシュの特性について説明します。  
+  
+ [ピア ノード](../../../../docs/framework/wcf/feature-details/peer-nodes.md) : ピア ノードについて説明します。  
+  
+ [ピア チャネルのセキュリティ](../../../../docs/framework/wcf/feature-details/peer-channel-security.md) : ピア チャネルによって提供されるセキュリティ シナリオとソリューションについて説明します。  
+  
+ [ピア リゾルバー](../../../../docs/framework/wcf/feature-details/peer-resolvers.md) : PRNP \(Peer Name Resolution Protocol\) および他のカスタム リゾルバーの使用について説明します。  
+  
+## 参照  
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-channel-scenarios.md b/docs/framework/wcf/feature-details/peer-channel-scenarios.md
new file mode 100644
index 00000000000..e24292481e5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-channel-scenarios.md
@@ -0,0 +1,35 @@
+---
+title: "ピア チャネルのシナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dae6e0f7-900c-45ee-8be9-3647698382fb
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ピア チャネルのシナリオ
+ピア チャネル API は、次の開発シナリオをサポートします。  
+  
+## パブリケーション\/サブスクリプション メッセージング  
+ パブリケーション\/サブスクリプション アプリケーション \(株価情報、ニュース見出しのパブリッシャー、スポーツの得点結果、天気予報など\) を構築する企業では、ピア チャネルを使用することで、サーバーを使用しないアプリケーションを実現できます。  たとえば、ユーザーは、共通メッシュ \(クライアント グループ\) に参加することで、スポーツの最新の得点経過を取得でき、サーバーの負荷を増大させずに、最新の試合データを大量に伝達できます。  これにより、データ プロバイダーは、サーバー ベース技術への投資を大幅に増大することなしに、これまでよりも高品質のサービスを提供できるようになります。  
+  
+## コラボレーション  
+ 独立ソフトウェア ベンダー \(ISV\) は、ピアツーピアのアクティビティに参加するための緊密なグループをユーザーが作成できるようなアプリケーションを構築できます。  たとえば、共同プロジェクトでのチームによる作業、友人による画像の共有、パーティ計画の各種作業などがあります。  従来、このようなアクティビティにはサーバーが必要でしたが、ピア チャネルでは、従来のサーバーとクライアントのモデルでは容易に実装できなかったオフライン アクセス シナリオを実現することにより、費用効果の高い方法でこのアクティビティを実現できるようになります。  
+  
+## 分散処理と計算クラスター  
+ 一般に、計算クラスターと分散処理は、財務モデルや天気モデル、人間の DNA のデコードなどの大規模計算で使用します。  通常、このような計算は、サーバーを使用して計算クラスターに参加するすべてのクライアントにタスクを個別に割り当てることで実行されます。  このサーバーには追加の要求が生じる場合もあります。たとえば、特定の期間内にすべてのタスクを終了させるため、各タスクに複数のコンピューターが必要となる場合があります。  また、タスクを実行しているあるクライアントが停止した場合は、別のクライアントでそのタスクを引き継いで実行する必要があります。  さらに、一貫性のある結果を確保するために複数のクライアントで同じタスクを実行しなければならない場合もあります。  サーバーは、このようなクライアントの調整を実行できますが、個別にタスクを受け取るクライアントが、タスクに関係するサーバーの要件を決定し、計算メッシュを使用してタスクを完了する方法を特定するピアツーピア ソリューションを作成できます。  
+  
+## ゲーム  
+ ピア チャネルを使用することで、アプリケーション開発者はサーバーを使用しないバージョンのゲームを作成できます。このゲームでは、中央サーバーを使用するのではなくピアツーピア メカニズムによって、ゲームの動作を他のプレーヤーに転送したり他のプレーヤーと同期したりします。  小規模の ISV では、これにより、中央サーバーの配置、保守、サービス提供などに関連する運用コストを削減できます。  ピアツーピア アーキテクチャを使用して記述されたゲームは、インターネットや有線または無線のローカル ネットワークでプレイできます。  さらに、ロビーやゲーム内チャットなどのゲームのアクティビティをピアツーピア ネットワークを使用して開発できます。  
+  
+## 参照  
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-channel-security.md b/docs/framework/wcf/feature-details/peer-channel-security.md
new file mode 100644
index 00000000000..979bd31392a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-channel-security.md
@@ -0,0 +1,46 @@
+---
+title: "ピア チャネルのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c59b164-3729-44f0-a967-f247c42de662
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ピア チャネルのセキュリティ
+ピア チャネルは、マルチパーティ メッセージングに基づく各種分散アプリケーションを実現します。例として、インターネット規模のコンテンツ配布 \(信頼されたソースによるコンテンツ \(メディアやソフトウェア更新プログラムなど\) 配布\)、友人グループによる音楽や写真の交換、同僚チームによるドキュメントの共同編集などが挙げられます。これらのシナリオでは、それぞれに一意のセキュリティ モデルが必要です。ピア チャネル セキュリティ モデルは、このようなシナリオに対処するようにデザインされており、さまざまな ID モデル、認証モデル、および承認モデルの各ニーズに対応する堅牢なセキュリティ モデルを提供します。  
+  
+## セキュリティ シナリオ  
+ コンテンツ配布シナリオでは、コンテンツの各受信者がコンテンツ ソースを識別する必要があります。配布を行うというシナリオの性質上、メッセージの処理または途中受信を行う中継局を確認および信頼することは必ずしも可能ではありません。信頼できない中継局によるメッセージ改ざんの脅威を効果的に軽減するには、アプリケーションで送信時にメッセージをセキュリティで保護することにより、改ざんの試みを容易に検出できるようにします。この場合、コンテンツの機密度に応じて、暗号化が必要な場合があります。  
+  
+ グループによるドキュメント編集のようなコラボレーション シナリオでは、多くの場合、セッションに参加する各メンバーを個別に識別し、認証する必要があります。これは、セッションをセキュリティで保護するには、ユーザー グループを定義し、これらのグループを認証するメカニズムが必要であるということを意味しています。さらに、アプリケーションでは、メッセージ レベルの認証によって各メッセージのトレースを行う必要が生じる場合があります。この種のアプリケーションでは、より強固なセキュリティ スキームを実現するためにパフォーマンスが犠牲となることがあります。  
+  
+ 非公式のグループにおける通信セッションでは、グループ内での秘密の共有など、形式張らないセキュリティ モデルが必要になることがあります。この種のアプリケーションでは、強力な認証方法を使用したり、否認防止手段を提供したりするよりも、セキュリティ モデルの確立と構成が容易であることの方が重要となります。このようなシナリオでは、通信レイヤーをセキュリティで保護すると同時にメッセージの認証も可能にする、パスワード ベースの認証機構が役立ちます。パスワード ベースのセキュリティは、ピア チャネルの既定の設定です。  
+  
+## トークンの種類  
+ ピア チャネルでは、トークンの種類として、強力な識別手段である X.509 証明書だけを認識します。X.509 証明書は、実装可能な認証および承認の種類に基づいて強力な ID モデルを提供します。証明書を使用することで、機密性と整合性を容易に実現することができます。ただし、X.509 証明書は使用と展開が困難な場合があります。  
+  
+ ピア チャネルでは、パスワードを使用した簡単なアプリケーションもサポートしています。これらのアプリケーションでは、指定したパスワードに基づいて単純なピア グループをセットアップできます。この場合、グループの所有者がパスワードを決定してメンバーに通知します。各メンバーは、セッションに参加するためにこのパスワードを使用して事前にサインインする必要があります。パスワードは、セッションへのエントリを許可する目的でのみ使用できます。パスワードを使用して、メッセージの認証を行うことはできません。これは、ピア グループで共有する共通鍵トークンをソース認証に使用することは困難かつ不適切であるためです。  
+  
+## セキュリティ モデル  
+ ピア チャネルは、ピア間の個々のリンクをセキュリティで保護する機能を提供します。これは、\(アプリケーションの観点から\) セキュリティ保護されていないリンク上でメッセージがフローすることはないことを意味します。内部的には、各リンク \(2 つのピア間のトランスポート チャネル\) は トランスポート層セキュリティ \(TLS\) を使用してセキュリティ保護されます。つまり、送信者がメッセージを作成し、送信すると、このメッセージは、セキュリティで保護されたトランスポートを介して、メッセージにアクセスする直近のピアに送信されます。次に、このピアが、セキュリティで保護された接続を介して直近のピアにメッセージを送信することになります。このセキュリティはトランスポート レベルでのみ動作し、メッセージのセキュリティ モデルには依存しません。  
+  
+ ピア チャネルでは、使用するトランスポート セキュリティとは別に、メッセージをセキュリティ保護する方法も用意されています。このモデルでは、メッセージはソースのセキュリティ トークンを使用してソースで保護されます。ただし、現在サポートされているのは X.509 証明書だけです。セキュリティ保護されたメッセージは、ピア ネットワーク経由で送信されます。各受信ピアは、ソースの信頼性を確認できます。メッセージはセキュリティで保護されているため、中継局がメッセージを改ざんすることはできません。  
+  
+ 機密性を実現するために、アプリケーションでは強力なグループ メンバーシップ スキームを持つトランスポート セキュリティを採用して、メッセージへの権限のないアクセスを禁止できます。  
+  
+ ピア チャネルでは、サポートされているトークンの種類のいずれかをアプリケーションで選択する限り、特定の ID モデルを必要としません。これらの ID と認証決定のライフサイクルは、アプリケーションにより完全に支配されます。  
+  
+## 参照  
+ [セキュリティによるピア チャネル アプリケーションの保護](../../../../docs/framework/wcf/feature-details/securing-peer-channel-applications.md)   
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md)   
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-meshes.md b/docs/framework/wcf/feature-details/peer-meshes.md
new file mode 100644
index 00000000000..f5ab534a590
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-meshes.md
@@ -0,0 +1,41 @@
+---
+title: "ピア メッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d93e312e-ac04-40f8-baea-5da1cacb546e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ピア メッシュ
+*メッシュ*は、互いに通信可能で、一意のメッシュ ID により識別されるピア ノードの名前付きコレクション \(相関グラフ\) です。  各ノードは複数の別のノードに接続されています。  接続状況が良好なメッシュでは、2 つのノード間にパスが存在します。メッシュの一番端のノード間には比較的少数のホップがあります。メッシュは、一部のノードまたは接続が落ちた場合でも、接続されたままになります。  メッシュ内のアクティブ ノードは、エンドポイント情報と対応するメッシュ ID を公開して他のピアが検索できるようにします。  
+  
+## ピア メッシュを使用して作成されたメッシュの特徴  
+  
+#### 一意の識別  
+  
+-   一意の ID によって各メッシュが識別されます。  メッシュ名 \(メッシュ ID\) はドメイン ネーム システム \(DNS\) ホスト名と同じ形式です。  したがって、このメッシュ ID は、アプリケーションの対象クライアントに対して、リゾルバーの使用範囲内で一意にする必要があります。  "MyFamilysPeers" や "KevinsPokerTable" のような一般的な名前にすると、他のユーザー名と容易に衝突する可能性があり、意図しないピア エンドポイントの情報が返る場合があります。その結果、プライバシーの問題が発生したり、接続の待ち時間が増加したりする可能性があります。  このような問題を回避する 1 つの方法は、一意の ID をメッシュのニックネームの接尾辞として追加することです \(たとえば、"KevinsPokerTable90210" のようにします\)。  
+  
+#### 大量のメッセージ  
+  
+-   メッシュでは、1 人以上の送信者から同じメッシュ内の他のすべてのピア ノードにメッセージを伝達できます。  ピア ノードから大量に送られたメッセージは、`http://schemas.microsoft.com/net/2006/05/peer` の名前空間で指定されたヘッダーを使用します。  
+  
+#### 最適化された接続  
+  
+-   ノードが参加したり離脱したりすると、ピア チャネル メッシュが自動的に調整されます。これにより、良好な接続が維持され、パーティション \(互いに分離するノード グループ\) が作成される可能性はほとんどなくなります。  メッシュ内の接続は現在のトラフィック パターンに基づいて動的に最適化され、送信者から受信者へのメッセージの待ち時間は可能な限り短縮されます。  
+  
+#### ピア チャネルで提供されない一般的なネットワーク機能  
+ ピア チャネルで提供されない一般的なネットワーク機能を認識しておくことは重要です。  その機能 \(ピア チャネルの上にすべて構築される場合もあります\) を次に示します。  
+  
+-   メッセージの順序付け : 単独のソースから送信されたメッセージは、他のすべてのパーティに同じ順序またはソースが送信した順序で到着しない場合があります。  メッセージを特定の順序で配信する必要のあるアプリケーションでは、その順序をアプリケーションに組み込む必要があります \(決まった値で増加する ID をすべてのメッセージに含めるなど\)。  
+  
+-   信頼できるメッセージング : ピア チャネルには、すべてのピアによりメッセージの受信を確認するメカニズムはありません。  メッセージの配信を保証するには、信頼性の層をピア チャネルの上に記述する必要があります。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-nodes.md b/docs/framework/wcf/feature-details/peer-nodes.md
new file mode 100644
index 00000000000..26ad06feed5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-nodes.md
@@ -0,0 +1,27 @@
+---
+title: "ピア ノード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0732b314-6006-4ec6-999d-ec9476c9e5bb
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ピア ノード
+PeerNode はピア チャネル メッシュ内の単一エンドポイントです。アプリケーションは、複数のピア ノードを使用して、異なるメッシュに参加できます。たとえば、1 つのピアツーピア チャット アプリケーションを、高校生時代の友人とのチャット用のメッシュと、会社の同僚とのチャット用のメッシュという 2 つの独立したメッシュの一部とすることができます。  
+  
+## 参照  
+ <xref:System.ServiceModel.PeerNode>  
+  
+## 参照  
+ [ピア メッシュ](../../../../docs/framework/wcf/feature-details/peer-meshes.md)   
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-resolvers.md b/docs/framework/wcf/feature-details/peer-resolvers.md
new file mode 100644
index 00000000000..1dfb3ed730d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-resolvers.md
@@ -0,0 +1,50 @@
+---
+title: "ピア リゾルバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d86d12a1-7358-450f-9727-b6afb95adb9c
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ピア リゾルバー
+メッシュに接続するには、ピア ノードに他のノードの IP アドレスが必要です。  IP アドレスを取得するには、リゾルバー サービスにアクセスします。このサービスは、メッシュ ID を受け取り、そのメッシュ ID で登録されているノードに対応するアドレスの一覧を返します。  リゾルバーは登録されたアドレスのリストを保持します。そのリストには、メッシュ レジスタの各ノードとサービスが含まれます。  
+  
+ 使用する PeerResolver サービスは、<xref:System.ServiceModel.NetPeerTcpBinding> の `Resolver` プロパティから指定できます。  
+  
+## サポートされるピア リゾルバー  
+ ピア チャネルは、PNRP \(Peer Name Resolution Protocol\) サービスとカスタム リゾルバー サービスの 2 種類のリゾルバーをサポートします。  
+  
+ 既定で、ピア チャネルは PNRP ピア リゾルバー サービスを使用して、メッシュ内のピアと近隣ノードを検出します。  PNRP が利用できない、または適切でない状況やプラットフォームでは、別の方法として、サーバー ベースの検索サービスである <xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService> が [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に用意されています。  また、<xref:System.ServiceModel.PeerResolvers.IPeerResolverContract> インターフェイスを実装するクラスを書き込むと、カスタム リゾルバー サービスを明示的に定義することもできます。  
+  
+### PNRP \(Peer Name Resolution Protocol\)  
+ PNRP \([!INCLUDE[wv](../../../../includes/wv-md.md)] の既定のリゾルバー\) は、分散型でサーバーを使用しない、名前のリゾルバー サービスです。  PNRP は、Advanced Networking Pack をインストールすれば [!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] でも使用できます。  2 つのクライアントが同じバージョンの PNRP を実行している場合、特定の条件 \(途中に企業のファイアウォールが存在しないなどの条件\) を満たせば、このプロトコルを使用してお互いを検索できます。  [!INCLUDE[wv](../../../../includes/wv-md.md)] に付属する PNRP は、Advanced Networking Pack に含まれているバージョンよりも新しいバージョンです。  [!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] 用の PNRP への更新については、Microsoft ダウンロード センターで確認してください。  
+  
+### カスタム リゾルバー サービス  
+ PNRP サービスを利用できない場合、またはメッシュ形状を完全に制御する必要がある場合は、サーバー ベースのカスタム リゾルバー サービスを使用できます。  このサービスは、<xref:System.ServiceModel.PeerResolvers.IPeerResolverContract> インターフェイスを実装するリゾルバー クラスを記述するか、既定の受信トレイ実装 \(<xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService>\) を使用することで、明示的に定義できます。  
+  
+ サービスの既定の実装では、クライアント登録は、クライアントが明示的に更新しない限り、特定の期間が経過した後に期限切れになります。  そこで、リゾルバー サービスを使用するクライアントは、登録を時間内に正常に更新するために、クライアントとサーバー間の待ち時間に上限の概念を設ける必要があります。  そのために、リゾルバー サービスに適切な更新タイムアウト \(`RefreshInterval`\) を選択します。  \(詳細については、「[CustomPeerResolverService 内部 : クライアント登録](../../../../docs/framework/wcf/feature-details/inside-the-custompeerresolverservice-client-registrations.md)」を参照してください\)。  
+  
+ アプリケーションを記述する際には、クライアントとカスタム リゾルバー サービス間の接続をセキュリティで保護することも考慮する必要があります。  これは、クライアントがリゾルバー サービスへのアクセスに使用する <xref:System.ServiceModel.NetTcpBinding> のセキュリティ設定を使用することで実現できます。  資格情報を使用する場合は、ピア チャネルの作成に使用する `ChannelFactory` で、それを指定する必要があります。  この資格情報は、カスタム リゾルバーへのチャネルの作成に使用される `ChannelFactory` に渡されます。  
+  
+> [!NOTE]
+>  ローカル ネットワークや即席のネットワークでカスタム リゾルバーを使用するときは、リンク ローカル ネットワークまたは即席のネットワークを使用またはサポートするアプリケーションに、接続時に使用するリンク ローカル アドレスを 1 つだけ選択するロジックを含めることを強くお勧めします。  これにより、複数のリンク ローカル アドレスを持つコンピューターによって発生する可能性のある混乱をすべて回避できます。  このロジックに従って、ピア チャネルは、1 度に 1 つのリンク ローカル アドレスを使用することだけをサポートします。  このアドレスは、<xref:System.ServiceModel.NetPeerTcpBinding> の `ListenIpAddress` プロパティを使用して指定できます。  
+  
+ カスタム リゾルバーを実装する方法の例については、「[Peer Channel Custom Peer Resolver](http://msdn.microsoft.com/ja-jp/5b75a2bb-7ff1-4a14-abe7-3debf0537d23)」を参照してください。  
+  
+## このセクションの内容  
+ [CustomPeerResolverService 内部 : クライアント登録](../../../../docs/framework/wcf/feature-details/inside-the-custompeerresolverservice-client-registrations.md)  
+  
+## 参照  
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md)   
+ [ピア チャネルのセキュリティ](../../../../docs/framework/wcf/feature-details/peer-channel-security.md)   
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/peer-to-peer-networking.md b/docs/framework/wcf/feature-details/peer-to-peer-networking.md
new file mode 100644
index 00000000000..c50461db67c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/peer-to-peer-networking.md
@@ -0,0 +1,37 @@
+---
+title: "ピアツーピア ネットワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ad6cb67b-fd1c-4ca1-a767-b410da2e16ca
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# ピアツーピア ネットワーク
+ピア チャネルとは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のマルチパーティ対応ピアツーピア \(P2P\) 通信技術です。  この技術によって、アプリケーション開発者は安全で拡張可能なメッセージ ベースの P2P 通信チャネルを利用できます。  ピア チャネルのメリットを活用するマルチパーティ アプリケーションの一般的な例は、チャットなどの共同作業アプリケーションです。チャットでは、ユーザーのグループがサーバーなしのピアツーピア方式で互いに会話します。  ピア チャネルを使用することで、顧客シナリオや企業シナリオでの P2P コラボレーション、コンテンツ配布、負荷分散、および分散処理が実現します。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] では、すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と同様に、既定でピア チャネルが有効になっています。  ピア チャネルのクラスにアクセスするには、プロジェクトに System.ServiceModel.dll への参照を追加します。  
+  
+ 次の各セクションには、ピアツーピア ネットワークに関する情報と、ピア チャネルのクラスを使用してピア対応のネットワーク アプリケーションを作成する方法が記載されています。  
+  
+## このセクションの内容  
+ [ピア チャネルのシナリオ](../../../../docs/framework/wcf/feature-details/peer-channel-scenarios.md): パブリケーション\/サブスクリプション メッセージング、コラボレーション、分散処理、ゲームなど、ピア チャネル API でサポートされる開発シナリオを紹介します。  
+  
+ [ピア チャネルの概要](../../../../docs/framework/wcf/feature-details/peer-channel-concepts.md): ピア メッシュ、ピア ノード、ピア チャネルのセキュリティ、およびピア リゾルバーについて説明します。  
+  
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md): ピア チャネル アプリケーションの開発に関するガイダンスを示します。  
+  
+## ピア チャネルのコード例  
+ [ピア チャネル カスタム ピア リゾルバー](http://msdn.microsoft.com/ja-jp/5b75a2bb-7ff1-4a14-abe7-3debf0537d23)  
+  
+## ピア チャネル チームのブログ  
+ [ピア チャネル チームのブログ](http://go.microsoft.com/fwlink/?LinkID=114530) \(http:\/\/go.microsoft.com\/fwlink\/?LinkID\=114530\)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/performance-considerations.md b/docs/framework/wcf/feature-details/performance-considerations.md
new file mode 100644
index 00000000000..82141a56042
--- /dev/null
+++ b/docs/framework/wcf/feature-details/performance-considerations.md
@@ -0,0 +1,31 @@
+---
+title: "パフォーマンスに関する考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 83082d4a-7350-4b04-ab2d-1fa5ffd643f5
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# パフォーマンスに関する考慮事項
+アプリケーションを構築する際には、パフォーマンスについて常に考慮することが重要です。このセクションには、パフォーマンスとセキュリティに関連するトピックが含まれています。  
+  
+## このセクションの内容  
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)  
+ クレームのコレクション内ですばやくクレームを検索するための機構について説明します。  
+  
+ [電子署名の暗号化](../../../../docs/framework/wcf/feature-details/encryption-of-digital-signatures.md)  
+ デジタル署名の暗号化がパフォーマンスに及ぼす影響と、この機能を無効にする方法について説明します。  
+  
+## 参照  
+ [セキュリティのベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md)   
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/poison-message-handling.md b/docs/framework/wcf/feature-details/poison-message-handling.md
new file mode 100644
index 00000000000..5503c60c348
--- /dev/null
+++ b/docs/framework/wcf/feature-details/poison-message-handling.md
@@ -0,0 +1,118 @@
+---
+title: "有害メッセージ処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d1c5e5a-7928-4a80-95ed-d8da211b8595
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# 有害メッセージ処理
+A*有害なメッセージ*をアプリケーションに配信が試行の最大数を超えたメッセージです。 この状況は、キュー ベースのアプリケーションがエラーによってメッセージを処理できないときに発生する可能性があります。 信頼性に対する要求を満たすために、キューに置かれたアプリケーションはトランザクションの下でメッセージを受信します。 キューに置かれたメッセージを受信したトランザクションを中止すると、メッセージはそのままキューに残り、新しいトランザクションの下で再試行されます。 トランザクションを中止させた問題が解決されなければ、受信側のアプリケーションは、配信試行回数の最大値を超えるまで同じメッセージの受信と中止を繰り返す悪循環に陥る可能性があり、その結果、有害メッセージが生じることになります。  
+  
+ メッセージは、さまざまな理由で有害メッセージになる可能性があります。 最も一般的な理由は、アプリケーション固有の理由です。 たとえば、アプリケーションがキューからメッセージを読み取り、なんらかのデータベース処理を実行する場合は、アプリケーションがデータベースをロックできないことによって、トランザクションが中止されることが考えられます。 データベース トランザクションが中止されたために、メッセージはキューに残ります。これにより、アプリケーションではメッセージを再度読み取り、データベースのロックの取得を再試行します。 メッセージに無効な情報が含まれている場合にも、有害メッセージになる可能性があります。 たとえば、発注書に無効な顧客番号が含まれている場合があります。 このような場合、アプリケーションは自発的にトランザクションを中止し、メッセージを強制的に有害メッセージにすることがあります。  
+  
+ まれに、メッセージをアプリケーションにディスパッチできないことがあります。 メッセージに不適切なフレームがあったり、無効なメッセージ資格情報が割り当てられていたり、無効なアクション ヘッダーが含まれていたりする場合などは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] レイヤーがメッセージの問題を検出することがあります。 このような場合、アプリケーションはメッセージを受信しません。ただし、メッセージは有害メッセージとなるため、手動で処理できます。  
+  
+## <a name="handling-poison-messages"></a>有害メッセージの処理  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の有害メッセージ処理は、アプリケーションにディスパッチできないメッセージや、アプリケーションにディスパッチされても、アプリケーション固有の理由によって処理できないメッセージを、受信側アプリケーションで処理する機構を提供します。 有害メッセージ処理は、キューに置かれた使用可能な各バインディングの次のプロパティで構成されます。  
+  
+-   `ReceiveRetryCount`. アプリケーション キューからアプリケーションへのメッセージの配信を再試行する最大回数を示す整数値。 既定値は 5 です。 データベースの一時的なデッドロックなどの問題を即時再試行で解決する場合は、この値で十分です。  
+  
+-   `MaxRetryCycles`. 再試行サイクルの最大数を示す整数値。 再試行サイクルは、アプリケーション キューから再試行サブキューにメッセージを転送し、構成可能な遅延の後に再試行サブキューからアプリケーション キューにメッセージを転送して配信を再試行するプロセスで構成されます。 既定値は 2 です。 [!INCLUDE[wv](../../../../includes/wv-md.md)] では、メッセージが最大で (`ReceiveRetryCount` + 1) × (`MaxRetryCycles` + 1) 回試行されます。 `MaxRetryCycles` は、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では無視されます。  
+  
+-   `RetryCycleDelay`. 再試行サイクル間の遅延時間。 既定値は 30 分です。 `MaxRetryCycles` と `RetryCycleDelay` の組み合わせにより、問題に対処する機構が提供されます。この場合、定期的な遅延後に再試行が行われ、問題が解決されます。 たとえば、SQL Server の保留中のトランザクションのコミットでロックされた行セットが処理されます。  
+  
+-   `ReceiveErrorHandling`. 再試行を最大回数実行しても配信できなかったメッセージに対して実行するアクションを示す列挙値。 値には、Fault、Drop、Reject、および Move の&4; つがあります。 既定のオプションは Fault です。  
+  
+-   Fault :  このオプションでは、`ServiceHost` のエラーの原因となったリスナーにエラーが送信されます。 アプリケーションでキューのメッセージの処理を継続するには、なんらかの外部機構によってアプリケーション キューからメッセージを削除する必要があります。  
+  
+-   Drop :  このオプションでは、有害メッセージが破棄されます。メッセージがアプリケーションに配信されることはありません。 この時点でメッセージの `TimeToLive` プロパティの有効期限が既に切れている場合は、メッセージが送信側の配信不能キューに表示されることがあります。 有効期限が切れていない場合は、どこにも表示されません。 このオプションは、メッセージが失われたときにユーザーが実行する操作が指定されていないことを示します。  
+  
+-   Reject :  このオプションは、[!INCLUDE[wv](../../../../includes/wv-md.md)] 専用です。 アプリケーションがメッセージを受信できないという否定受信確認を送信側キュー マネージャーに返信するように、メッセージ キュー (MSMQ) に指示します。 メッセージは、送信側キュー マネージャーの配信不能キューに置かれます。  
+  
+-   Move :  このオプションは、[!INCLUDE[wv](../../../../includes/wv-md.md)] 専用です。 有害メッセージを有害メッセージ キューに移動して、後で有害メッセージ処理アプリケーションで処理できるようにします。 有害メッセージ キューは、アプリケーション キューのサブキューです。 有害メッセージ処理アプリケーションを、有害キューからメッセージを読み取る [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにすることができます。 有害キューはアプリケーション キューのサブキューであり、net.msmq:// としてアドレス指定できます*マシン名*>/*applicationQueue*有害、;、*マシン名*キューが存在するコンピューターの名前を指定します、 *applicationQueue*アプリケーションに固有のキューの名前を指定します。  
+  
+ メッセージに対して実行される配信の最大試行回数は、次のようになります。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] の場合、((ReceiveRetryCount + 1) × (MaxRetryCycles + 1))。  
+  
+-   [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] の場合、(ReceiveRetryCount + 1)。  
+  
+> [!NOTE]
+>  正常に配信されたメッセージについては、再試行は行われません。  
+  
+ メッセージの読み取りが試行された回数を追跡するために、[!INCLUDE[wv](../../../../includes/wv-md.md)] では、中止回数をカウントする永続的なメッセージ プロパティと、アプリケーション キューとサブキューの間でメッセージが移動された回数をカウントする移動回数プロパティを保持します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルはこれらを使用して、受信再試行回数と再試行サイクル数を計算します。 [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、中止回数が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルによってメモリに保持され、アプリケーションでエラーが発生した場合にリセットされます。 また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルはいつでも、最大 256 のメッセージの中止回数をメモリに保持できます。 257 番目のメッセージを読み取ると、最も古いメッセージの中止回数がリセットされます。  
+  
+ 中止回数と移動回数のプロパティは、操作コンテキストを通じてサービス操作で使用できます。 これらのプロパティにアクセスする方法を次のコード例に示します。  
+  
+ [!code-csharp[S_UE_MSMQ_Poison#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ue_msmq_poison/cs/service.cs#1)]  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、標準の、キューに置かれたバインディングを&2; つ提供します。  
+  
+-   <xref:System.ServiceModel.NetMsmqBinding>します。 他の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] エンドポイントとのキュー ベースの通信を実行するのに適した [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディング。  
+  
+-   <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>します。 既存のメッセージ キュー アプリケーションとの通信に適したバインディング。  
+  
+> [!NOTE]
+>  これらのバインディングでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの要件に基づいてプロパティを変更できます。 有害メッセージ処理機構全体は、受信側アプリケーションに対してローカルです。 このプロセスは、受信側アプリケーションが最終的に処理を停止し、送信側に否定受信確認を返信する場合を除き、送信元アプリケーションには認識されません。 この場合、メッセージは、送信元の配信不能キューに送られます。  
+  
+## <a name="best-practice-handling-msmqpoisonmessageexception"></a>ベスト プラクティス : MsmqPoisonMessageException の処理  
+ キューに置かれたトランスポートによってスロー、サービス、メッセージが有害であると判断した場合、 <xref:System.ServiceModel.MsmqPoisonMessageException>を含む、`LookupId`有害メッセージのです。  
+  
+ 受信側アプリケーションを実装する、 <xref:System.ServiceModel.Dispatcher.IErrorHandler>インターフェイスをアプリケーションに必要なエラーがあれば処理します。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][エラー処理およびレポートに対する制御の拡張](../../../../docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md)します。  
+  
+ アプリケーションでは、有害メッセージを有害メッセージ キューに移動し、サービスがキュー内の残りのメッセージにアクセスできるようにする、なんらかの有害メッセージ自動処理を必要とする場合があります。 エラー処理機構を使用して、有害メッセージの例外をリッスンする唯一のシナリオは、 <xref:System.ServiceModel.Configuration.MsmqBindingElementBase.ReceiveErrorHandling%2A>に設定した<xref:System.ServiceModel.ReceiveErrorHandling>します。 メッセージ キュー 3.0 の有害メッセージ サンプルは、この動作を示しています。 ベスト プラクティスを含め、有害メッセージを処理するために必要な手順の概要を以下に示します。  
+  
+1.  有害メッセージの設定がアプリケーションの要件を反映していることを確認します。 設定を処理するときは、[!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] でのメッセージ キューの機能の相違点を理解してください。  
+  
+2.  必要に応じて `IErrorHandler` を実装し、有害メッセージのエラーを処理します。 `ReceiveErrorHandling` を `Fault` に設定する場合、有害メッセージをキューから取り除いたり、外部の従属的な問題を解決したりする手動の機構が必要となります。そのため、`IErrorHandler` を `ReceiveErrorHandling` に設定するときは、次のコードに示すように `Fault` を実装するのが一般的です。  
+  
+     [!code-csharp[S_UE_MSMQ_Poison#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ue_msmq_poison/cs/poisonerrorhandler.cs#2)]  
+  
+3.  サービス動作が使用できる `PoisonBehaviorAttribute` を作成します。 この動作により、`IErrorHandler` がディスパッチャーにインストールされます。 このコード例を次に示します。  
+  
+     [!code-csharp[S_UE_MSMQ_Poison#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_ue_msmq_poison/cs/poisonbehaviorattribute.cs#3)]  
+  
+4.  サービスに有害動作属性による注釈が付けられていることを確認します。  
+  
+  
+  
+ また、`ReceiveErrorHandling` を `Fault` に設定した場合は、`ServiceHost` が有害メッセージを検出するとエラーになります。 この場合、faulted イベントにフックしてサービスを終了し、是正措置を講じた後に再起動できます。 など、`LookupId`で、 <xref:System.ServiceModel.MsmqPoisonMessageException>に反映、`IErrorHandler`ことに注意して、サービス ホストはエラーに使用するとでしたし、 `System.Messaging` API を使用してキューからメッセージを受信する、`LookupId`キューからメッセージを削除して、外部ストアまたは別のキューにメッセージを格納します。 これで `ServiceHost` を再起動して、通常の処理を再開できるようになります。 [の有害メッセージ処理で MSMQ 4.0](../../../../docs/framework/wcf/samples/poison-message-handling-in-msmq-4-0.md)この動作を示します。  
+  
+## <a name="transaction-time-out-and-poison-messages"></a>トランザクション タイムアウトと有害メッセージ  
+ キューに置かれたトランスポート チャネルとユーザー コードの間では、特定の部類のエラーが発生する可能性があります。 これらのエラーは、メッセージ セキュリティ レイヤーやサービス ディスパッチ ロジックなど、中間のレイヤーで検出される場合があります。 たとえば、SOAP セキュリティ レイヤーで X.509 証明書がないことが検出された場合やアクションがない場合は、メッセージがアプリケーションにディスパッチされます。 この場合、サービス モデルはそのメッセージを破棄します。 メッセージはトランザクションで読み取られますが、そのトランザクションの結果は提供されないため、トランザクションが最終的にタイムアウトになって中止され、メッセージはキューに戻されます。 つまり、エラーの部類によっては、トランザクションがすぐに中止されるわけではなく、タイムアウトになるまで待機します。 使用してサービスのトランザクション タイムアウトを変更する<xref:System.ServiceModel.ServiceBehaviorAttribute>します。  
+  
+ トランザクション タイムアウトをコンピューター全体で変更するには、machine.config ファイルを変更し、適切なトランザクション タイムアウトを設定します。 トランザクションに設定されたタイムアウトに従って、トランザクションは最終的に中止され、キューに戻されることになり、中止回数がインクリメントされることに注意してください。 最終的に、メッセージは有害メッセージになり、ユーザー設定に従って適切な処理が行われます。  
+  
+## <a name="sessions-and-poison-messages"></a>セッションと有害メッセージ  
+ セッションでは、単一のメッセージと同じ再試行および有害メッセージ処理手順が行われます。 有害メッセージに対する上記のプロパティは、セッション全体に適用されます。 つまり、セッション全体が再試行され、メッセージは最終有害メッセージ キューに送られます。または、メッセージが拒否された場合は、送信側の配信不能キューに送られます。  
+  
+## <a name="batching-and-poison-messages"></a>バッチ処理と有害メッセージ  
+ バッチの一部であるメッセージが有害メッセージになった場合は、バッチ全体がロールバックされ、チャネルはメッセージを&1; つずつ読み取る処理に戻ります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]バッチ処理を参照してください[トランザクションでメッセージのバッチ処理](../../../../docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md)  
+  
+## <a name="poison-message-handling-for-messages-in-a-poison-queue"></a>有害キュー内のメッセージに対する有害メッセージ処理  
+ 有害メッセージ処理は、メッセージが有害メッセージ キューに配置された時点では終了しません。 有害メッセージ キューに置かれたメッセージは、依然として読み取り、処理する必要があります。 最終有害サブキューからメッセージを読み取るときは、有害メッセージ処理設定のサブセットを使用できます。 適用できる設定は、`ReceiveRetryCount` と `ReceiveErrorHandling` です。 `ReceiveErrorHandling` は Drop、Rreject、Fault のいずれかに設定できます。 `MaxRetryCycles` が Move に設定されている場合は、`ReceiveErrorHandling` が無視され、例外がスローされます。  
+  
+## <a name="windows-vista-windows-server-2003-and-windows-xp-differences"></a>Windows Vista、Windows Server 2003、および Windows XP の相違点  
+ 前述のように、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] には、すべての有害メッセージ処理設定が適用されるわけではありません。 [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、[!INCLUDE[wxp](../../../../includes/wxp-md.md)]、および [!INCLUDE[wv](../../../../includes/wv-md.md)] のメッセージ キューには、有害メッセージの処理に関連する次のような重要な違いがあります。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] のメッセージ キューはサブキューをサポートしていますが、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] はサポートしていません。 サブキューは、有害メッセージ処理で使用されます。 再試行キューと有害キューは、有害メッセージ処理の設定に基づいて作成されるアプリケーション キューのサブキューです。 作成する再試行サブキューの数は、`MaxRetryCycles` で指定します。 したがって、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] または [!INCLUDE[wxp](../../../../includes/wxp-md.md)] で実行している場合、`MaxRetryCycles` は無視されるため、`ReceiveErrorHandling.Move` は使用できません。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] のメッセージ キューは否定受信確認をサポートしていますが、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] はサポートしていません。 受信側キュー マネージャーから否定受信確認を受け取ると、送信側キュー マネージャーは拒否されたメッセージを配信不能キューに入れます。 そのため、`ReceiveErrorHandling.Reject` は、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では使用できません。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] のメッセージ キューは、メッセージの配信試行回数を保持するメッセージ プロパティをサポートしています。 この中止回数のプロパティは、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では使用できません。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、中止回数をメモリで保持するため、同じメッセージがファーム内の複数の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスによって読み取られた場合、このプロパティは、正確な値を格納できない可能性があります。  
+  
+## <a name="see-also"></a>関連項目  
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)   
+ [Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](../../../../docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md)   
+ [指定して、コントラクトおよびサービスでエラーを処理](../../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/preventing-replay-attacks-when-a-wcf-service-is-hosted-in-a-web-farm.md b/docs/framework/wcf/feature-details/preventing-replay-attacks-when-a-wcf-service-is-hosted-in-a-web-farm.md
new file mode 100644
index 00000000000..862c215e107
--- /dev/null
+++ b/docs/framework/wcf/feature-details/preventing-replay-attacks-when-a-wcf-service-is-hosted-in-a-web-farm.md
@@ -0,0 +1,27 @@
+---
+title: "WCF サービスが Web ファームでホストされている場合のリプレイ攻撃の回避 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c2ed695-7a31-4257-92bd-9e9731b886a5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF サービスが Web ファームでホストされている場合のリプレイ攻撃の回避
+メッセージ セキュリティ WCF の使用により、受信メッセージから NONCE を作成し、生成された NONCE が内部 `InMemoryNonceCache` にあるかどうかを確認することで、リプレイ攻撃が防止される場合。そうである場合、メッセージはリプレイとして破棄されます。WCF サービスが Web ファームでホストされている場合、`InMemoryNonceCache` は Web ファームのノード間で共有されていないため、サービスはリプレイ攻撃に対して脆弱です。このシナリオの危険性を軽減するために、WCF 4.5 では抽象クラス <xref:System.ServiceModel.Security.NoneCache> からクラスを派生させることによって独自の共有 NONCE キャッシュを実装できるようにする機能拡張ポイントを提供しています。  
+  
+## NoneCache の実装  
+ 独自の共有 NONCE キャッシュを実装するには、<xref:System.ServiceModel.Security.NoneCache> からクラスを派生させ、[M:System.ServiceModel.Security.NoneCache.CheckNonce\(System.Byte\<xref:System.ServiceModel.Security.NoneCache.CheckNonce%2A> メソッドと [M:System.ServiceModel.Security.NoneCache.TryAddNonce\(System.Byte\<xref:System.ServiceModel.Security.NoneCache.TryAddNonce%2A> メソッドをオーバーライドします。[M:System.ServiceModel.Security.NoneCache.CheckNonce\(System.Byte\<xref:System.ServiceModel.Security.NoneCache.CheckNonce%2A> は、指定された NONCE がキャッシュに存在するかどうかを確認します。[M:System.ServiceModel.Security.NoneCache.TryAddNonce\(System.Byte\<xref:System.ServiceModel.Security.NoneCache.TryAddNonce%2A> は NONCE をキャッシュに追加しようとします。クラスを実装したら、インスタンスを作成して、それをクライアント側でのリプレイ検出用には <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalClientSecuritySettings.NonceCache%2A>、サーバー側でのリプレイ検出用には <xref:System.ServiceModel.Channels.SecurityBindingElement.LocalServiceSecuritySettings.NonceCache%2A> に割り当てて準備します。この機能のためにすぐに使用できる構成サポートはありません。  
+  
+## 参照  
+ [メッセージのセキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)   
+ [SymmetricSecurityBindingElement](../../../../docs/framework/wcf/diagnostics/wmi/symmetricsecuritybindingelement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/programming-wcf-security.md b/docs/framework/wcf/feature-details/programming-wcf-security.md
new file mode 100644
index 00000000000..29b3721e51f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/programming-wcf-security.md
@@ -0,0 +1,110 @@
+---
+title: "WCF セキュリティのプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メッセージ セキュリティ [WCF], プログラミングの概要"
+ms.assetid: 739ec222-4eda-4cc9-a470-67e64a7a3f10
+caps.latest.revision: 25
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 25
+---
+# WCF セキュリティのプログラミング
+このトピックでは、セキュリティで保護された [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションを作成するために使用する基本的なセキュリティ プログラミング タスクについて説明します。ここでは、*転送セキュリティ*と総称される認証、機密性、および整合性についてのみ説明します。承認 \(リソースまたはサービスへのアクセスの制御\) についての説明は含まれません。承認の詳細については、「[承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)」を参照してください。  
+  
+> [!NOTE]
+>  セキュリティの概念、特に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に関するセキュリティの概念については、MSDN の「[Web サービス拡張 \(WSE\) 3.0 のシナリオ、パターン、および実装のガイダンス](http://go.microsoft.com/fwlink/?LinkID=88250)」にある patterns & practices の一連のチュートリアルを参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティのプログラミングは、セキュリティ モードの設定、クライアント資格情報の種類の設定、および資格情報の値の設定の 3 つの手順に基づいています。これらの手順は、コードまたは構成を使用して実行できます。  
+  
+## セキュリティ モードの設定  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ モードに関する一般的なプログラミング手順は、次のとおりです。  
+  
+1.  アプリケーション要件を満たす適切な定義済みバインディングを選択します。バインディングの選択肢の一覧については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。既定では、ほとんどのバインディングでセキュリティが有効になっています。唯一の例外は、<xref:System.ServiceModel.BasicHttpBinding> クラス \(構成を使用する場合は [\<basicHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)\) です。  
+  
+     選択するバインディングによってトランスポートが決まります。たとえば、<xref:System.ServiceModel.WSHttpBinding> はトランスポートとして HTTP を使用し、<xref:System.ServiceModel.NetTcpBinding> は TCP を使用します。  
+  
+2.  バインディングのセキュリティ モードを選択します。選択したバインディングによって、選択できるモードが決まります。たとえば、<xref:System.ServiceModel.WSDualHttpBinding> を選択すると、トランスポート セキュリティを使用できません \(このオプションはありません\)。同様に、<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> や <xref:System.ServiceModel.NetNamedPipeBinding> を選択すると、メッセージ セキュリティを使用できません。  
+  
+     次の 3 つの選択肢があります。  
+  
+    1.  `Transport`  
+  
+         トランスポート セキュリティは、選択したバインディングが使用する機構に依存します。たとえば、`WSHttpBinding` を使用している場合、セキュリティ機構は SSL \(Secure Sockets Layer\) です \(これは、HTTPS プロトコルの機構でもあります\)。一般に、トランスポート セキュリティの主な利点は、使用するトランスポートに関係なく、優れたスループットが得られることです。ただし、制限が 2 つあります。1 つは、ユーザーの認証に使用する資格情報の種類がトランスポート機構によって決まることです。これは、異なる種類の資格情報を要求する他のサービスと相互運用する必要がある場合には不都合です。もう 1 つの制限は、メッセージ レベルでセキュリティが適用されないため、エンド ツー エンドではなく、ホップ単位でセキュリティが実装されることです。この 2 つ目の制限は、クライアントとサービス間のメッセージ パスに中継局が含まれている場合にのみ問題になります。使用するトランスポート[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)」を参照してください。トランスポート セキュリティの使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)」を参照してください。  
+  
+    2.  `Message`  
+  
+         メッセージ セキュリティでは、メッセージの安全性を維持するために必要なヘッダーとデータがすべてのメッセージに含まれます。ヘッダーの構成は変更可能であるため、任意の数の資格情報を含めることができます。トランスポート機構で提供できない特殊な資格情報の種類を要求する他のサービスと相互運用している場合や、メッセージを複数のサービスで使用する必要があり、各サービスが異なる資格情報の種類を要求する場合には、これは重要な要素になります。  
+  
+         [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [メッセージのセキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md).  
+  
+    3.  `TransportWithMessageCredential`  
+  
+         このモードを選択すると、トランスポート層を使用してメッセージの転送がセキュリティで保護されると同時に、他のサービスが必要とするさまざまな資格情報がすべてのメッセージに含まれます。これにより、トランスポート セキュリティのパフォーマンス上の利点とメッセージ セキュリティの豊富な資格情報の利点の両方が提供されます。このモードは、<xref:System.ServiceModel.BasicHttpBinding>、<xref:System.ServiceModel.WSFederationHttpBinding>、<xref:System.ServiceModel.NetPeerTcpBinding>、および <xref:System.ServiceModel.WSHttpBinding> の各バインディングで使用できます。  
+  
+3.  HTTP でトランスポート セキュリティを使用する \(つまり、HTTPS を使用する\) 場合は、SSL 資格情報を使用してホストを構成し、ポートで SSL を有効にします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md).  
+  
+4.  <xref:System.ServiceModel.WSHttpBinding> を使用している場合、セキュリティで保護されたセッションを確立する必要がないときは、<xref:System.ServiceModel.NonDualMessageSecurityOverHttp.EstablishSecurityContext%2A> プロパティを `false` に設定します。  
+  
+     セキュリティで保護されたセッションは、クライアントとサーバーが対称キーを使用してチャネルを作成するときに発生します \(メッセージ交換中、やりとりが終了するまで、クライアントとサーバーの両方が同じキーを使用します\)。  
+  
+## クライアント資格情報の種類の設定  
+ 適切なクライアント資格情報の種類を選択します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][資格情報の種類の選択](../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md).使用できるクライアント資格情報の種類は、次のとおりです。  
+  
+-   `Windows`  
+  
+-   `Certificate`  
+  
+-   `Digest`  
+  
+-   `Basic`  
+  
+-   `UserName`  
+  
+-   `NTLM`  
+  
+-   `IssuedToken`  
+  
+ モードの設定に応じて、資格情報の種類を設定する必要があります。たとえば、次の構成例に示すように、`wsHttpBinding` を選択しており、モードを "Message" に設定した場合は、Message 要素の `clientCredentialType` 属性の値を `None`、`Windows`、`UserName`、`Certificate`、および `IssuedToken` のいずれかに設定できます。  
+  
+```  
+<system.serviceModel>  
+<bindings>  
+  <wsHttpBinding>  
+    <binding name="myBinding">  
+      <security mode="Message"/>  
+      <message clientCredentialType="Windows"/>  
+    </binding>  
+</bindings>  
+</system.serviceModel>  
+```  
+  
+ または  
+  
+ [!code-csharp[c_WsHttpService#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_wshttpservice/cs/source.cs#1)]
+ [!code-vb[c_WsHttpService#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_wshttpservice/vb/source.vb#1)]  
+  
+## サービス資格情報の値の設定  
+ クライアント資格情報の種類を選択したら、サービスとクライアントが使用する実際の資格情報を設定する必要があります。サービスでは、資格情報は <xref:System.ServiceModel.Description.ServiceCredentials> クラスを使用して設定します。また、資格情報は <xref:System.ServiceModel.ServiceHostBase> クラスの <xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティによって返されます。使用しているバインディングによって、サービス資格情報の種類、選択されるセキュリティ モード、およびクライアント資格情報の種類が暗黙的に決まります。サービス資格情報の証明書を設定するコードを次に示します。  
+  
+ [!code-csharp[c_tcpService#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_tcpservice/cs/source.cs#3)]
+ [!code-vb[c_tcpService#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_tcpservice/vb/source.vb#3)]  
+  
+## クライアント資格情報の値の設定  
+ クライアントでは、クライアント資格情報の値は <xref:System.ServiceModel.Description.ClientCredentials> クラスを使用して設定します。また、クライアント資格情報の値は <xref:System.ServiceModel.ClientBase%601> クラスの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティから返されます。TCP プロトコルを使用するクライアントで、資格情報として証明書を設定するコードを次に示します。  
+  
+ [!code-csharp[c_TcpClient#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_tcpclient/cs/source.cs#1)]
+ [!code-vb[c_TcpClient#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_tcpclient/vb/source.vb#1)]  
+  
+## 参照  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/publishing-metadata.md b/docs/framework/wcf/feature-details/publishing-metadata.md
new file mode 100644
index 00000000000..7e215a0a3b6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/publishing-metadata.md
@@ -0,0 +1,54 @@
+---
+title: "メタデータの公開 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ [WCF], 公開"
+ms.assetid: 3a56831a-cabc-45c0-bd02-12e2e9bd7313
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# メタデータの公開
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスは 1 つ以上のメタデータ エンドポイントを公開することにより、メタデータを公開します。サービス メタデータを公開すると、そのメタデータで WS\-MetadataExchange \(MEX\) や HTTP\/GET 要求などの標準化プロトコルを使用できるようになります。メタデータのエンドポイントはアドレス、バインディング、コントラクトを持つ他のサービス エンドポイントに類似し、それらは構成か命令コードを使用してサービス ホストに追加することができます。  
+  
+## メタデータ エンドポイントを公開する  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのメタデータ エンドポイントを公開するには、最初に <xref:System.ServiceModel.Description.ServiceMetadataBehavior> のサービスの動作をサービスに追加しておく必要があります。<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> インスタンスを追加すると、サービスからメタデータ エンドポイントを公開できます。<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> サービス動作を追加すると、MEX プロトコルをサポートするメタデータ エンドポイント、または HTTP\/GET 要求に応答するメタデータ エンドポイントを公開できます。  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> は <xref:System.ServiceModel.Description.WsdlExporter> を使用して、サービス内のすべてのサービス エンドポイント用のメタデータをエクスポートします。サービスからメタデータをエクスポートする方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)」を参照してください。  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> は、<xref:System.ServiceModel.Description.ServiceMetadataExtension> インスタンスをサービス ホストへの拡張として追加します。<xref:System.ServiceModel.Description.ServiceMetadataExtension?displayProperty=fullName> により、メタデータ公開プロトコルを実装することができます。また、<xref:System.ServiceModel.Description.ServiceMetadataExtension?displayProperty=fullName> を使用して、<xref:System.ServiceModel.Description.ServiceMetadataExtension.Metadata%2A?displayProperty=fullName> プロパティにアクセスすることにより、実行時にサービスのメタデータを取得できます。  
+  
+### MEX メタデータ エンドポイント  
+ MEX プロトコルを使用するメタデータ エンドポイントを追加するには、`IMetadataExchange` サービス コントラクトを使用するサービス エンドポイントをサービス ホストに追加します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルの一部として使用できるこのサービス コントラクト名を持つ <xref:System.ServiceModel.Description.IMetadataExchange> インターフェイスが用意されます。WS\-MetadataExchange のエンドポイント、つまり MEX エンドポイントは、<xref:System.ServiceModel.Description.MetadataExchangeBindings> クラスで静的ファクトリ メソッドが公開する 4 つの既定のバインディングの 1 つを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ツール \(Svcutil.exe など\) によって使用される既定のバインディングを照合できます。また、独自のカスタム バインディングを使用して MEX メタデータ エンドポイントを構成することもできます。  
+  
+### HTTP GET メタデータ エンドポイント  
+ HTTP\/GET 要求に応答するメタデータ エンドポイントをサービスに追加するには、<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> の <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A> プロパティを `true` に設定します。また、<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> の <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A> プロパティを `true` に設定することで、HTTPS を使用するメタデータ エンドポイントを構成することもできます。  
+  
+## このセクションの内容  
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成してメタデータを公開し、クライアントが `?wsdl` クエリ文字列を使用した WS\-MetadataExchange または HTTP\/GET 要求によりメタデータを取得できるようにする方法を示します。  
+  
+ [方法 : コードを使用してサービスのメタデータを公開する](../../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)  
+ コードを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのメタデータの公開を有効にして、クライアントが `?wsdl` クエリ文字列を使用した WS\-MetadataExchange または HTTP\/GET 要求によりメタデータを取得できるようにする方法を示します。  
+  
+## リファレンス  
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior>  
+  
+ <xref:System.ServiceModel.Description.IMetadataExchange>  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataExtension>  
+  
+ <xref:System.ServiceModel.Description.MetadataExchangeBindings>  
+  
+## 参照  
+ [メタデータのエクスポートとインポート](../../../../docs/framework/wcf/feature-details/exporting-and-importing-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/queues-and-reliable-sessions.md b/docs/framework/wcf/feature-details/queues-and-reliable-sessions.md
new file mode 100644
index 00000000000..4ba6bfc327f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/queues-and-reliable-sessions.md
@@ -0,0 +1,52 @@
+---
+title: "キューと信頼できるセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e794d03-141c-45ed-b6b1-6c0e104c1464
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# キューと信頼できるセッション
+キューおよび信頼できるセッションは、信頼できるメッセージングを実装する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の機能です。このセクションの各トピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージング機能について説明します。  
+  
+ 信頼できるメッセージングとは、信頼できるメッセージング送信元 \(送信元と呼ぶ\) から信頼できるメッセージング送信先 \(送信先と呼ぶ\) にメッセージを確実に転送することを指します。  
+  
+ 信頼できるメッセージングの主要な側面は、次のとおりです。  
+  
+-   メッセージ転送エラーまたはトランスポート エラーに関係なく、送信元から送信先に送られるメッセージの転送が保証されること。  
+  
+-   送信元と送信先を互いに分離することにより、送信元または送信先が利用できない場合でも、送信元と送信先でのそれぞれ独立したエラーと回復が可能になると共に、信頼できるメッセージの転送と配信が実現されること。  
+  
+ 信頼できるメッセージングを実現すると、待ち時間が長くなることがよくあります。待ち時間とは、メッセージが送信元から送信先に到達するまでにかかる時間です。そこで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、信頼できるメッセージングとして、次の 2 種類を提供します。  
+  
+-   [信頼できるセッション](../../../../docs/framework/wcf/feature-details/reliable-sessions.md) : 長い待ち時間という代償を伴わずに、信頼できる転送を実現します。  
+  
+-   [WCF のキュー](../../../../docs/framework/wcf/feature-details/queues-in-wcf.md) : 信頼できる転送、および送信元と送信先の分離を共に実現します。  
+  
+## 信頼できるセッション  
+ 信頼できるセッションでは、メッセージング \(送信元および送信先\) エンドポイントを分離する中継局の数や種類に関係なく、WS\-ReliableMessaging プロトコルを使用して、送信元から送信先へのエンドツーエンドの信頼できるメッセージ転送を実現します。これには SOAP を使用しないトランスポート手段 \(HTTP プロキシなど\)、またはエンドポイント間でメッセージをやりとりする場合に必要となる SOAP を使用する手段 \(SOAP ベースのルーターやブリッジなど\) が含まれます。信頼できるセッションでは、メモリ内転送ウィンドウを使用して、トランスポート エラーが発生した場合に SOAP メッセージ レベル エラーをマスクし、接続を再確立します。  
+  
+ 信頼できるセッションは、待ち時間の短い、信頼できるメッセージ転送を実現します。これらは、TCP が IP ブリッジ経由のパケットで実現するものと同等の転送を、プロキシや中継局経由の SOAP メッセージで実現します。信頼できるセッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[信頼できるセッション](../../../../docs/framework/wcf/feature-details/reliable-sessions.md)」を参照してください。  
+  
+### キュー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューでは、待ち時間は長くなりますが、信頼できるメッセージの転送と共に送信元および送信先の分離が実現されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキュー通信は、Microsoft Message Queuing \(MSMQ\) に基づいています。  
+  
+ MSMQ は Windows にオプションとして付属し、NT サービスの 1 つとして実行されます。MSMQ サービスは、送信元の代わりに転送キューで転送用のメッセージを取得し、ターゲット キューに配信します。ターゲット キューは、送信先の代わりにメッセージを受け取り、後で送信先がメッセージを要求したときに配信します。MSMQ キュー マネージャーは信頼できるメッセージ転送プロトコルを実装して、送信中にメッセージが失われないようにします。このプロトコルは、ネイティブまたは SOAP リライアブル メッセージ プロトコル \(SRMP\) などの SOAP ベースのプロトコルです。  
+  
+ キュー間でのメッセージの信頼できる転送に加え、送信元と送信先の分離により、疎結合されたアプリケーションで信頼できる通信を実現できます。信頼できるセッションとは異なり、送信元と送信先が同時に実行されている必要はありません。このため、送信元によるメッセージの生成レートと送信先によるメッセージの消費レートが一致しないときに、キューを実質的に負荷平準化機構として使用できるようになります。キュー[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF のキュー](../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)」を参照してください。  
+  
+## 参照  
+ [WCF のキュー](../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [信頼できるセッション](../../../../docs/framework/wcf/feature-details/reliable-sessions.md)   
+ [信頼できるセッションの概要](../../../../docs/framework/wcf/feature-details/reliable-sessions-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/queues-in-wcf.md b/docs/framework/wcf/feature-details/queues-in-wcf.md
new file mode 100644
index 00000000000..07e0ce3049f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/queues-in-wcf.md
@@ -0,0 +1,75 @@
+---
+title: "Windows Communication Foundation のキュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キュー [WCF]"
+ms.assetid: 43008409-1bb4-4bd4-85d7-862c8f10ae20
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# Windows Communication Foundation のキュー
+このセクションの各トピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのキューのサポートについて説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、Microsoft Message Queuing \(以前の MSMQ\) をトランスポートとして利用することによってキューをサポートしており、次のシナリオを実現できます。  
+  
+-   疎結合アプリケーション。送信元アプリケーションは、受信側アプリケーションでメッセージ処理の用意ができているかどうかを確認せずにキューにメッセージを送信できます。キューにより処理の独立性が提供されるため、送信元アプリケーションは、受信側アプリケーションのメッセージ処理速度とは関係なく、キューにメッセージを送信できます。キューに対するメッセージの送信がメッセージ処理と密接に結び付けられていない場合は、システムの全体的な可用性が向上します。  
+  
+-   エラーの分離。キューにメッセージを送受信するアプリケーションは、互いに影響を与えずにエラーを発生させることができます。たとえば、受信側のアプリケーションでエラーが発生しても、送信側のアプリケーションではメッセージをキューに送信し続けることができます。受信側は、エラーからの復帰後、キューにあるメッセージを処理できます。エラーの分離により、システムの全体的な信頼性と可用性が向上します。  
+  
+-   負荷の平準化。送信元アプリケーションから送信するメッセージが多すぎるために、受信側アプリケーションの処理が間に合わなくなることがあります。キューによってこの送信側と受信側のメッセージの不均衡が調整されるため、受信側の処理が間に合わなくなることはありません。  
+  
+-   操作の切断。モバイル デバイスのように遅延の大きなネットワーク、または可用性に制限のあるネットワークを介して通信を行う場合に、送信、受信、および処理の各操作を切断できます。エンドポイントが切断された場合も、キューによってこれらの操作を続行できます。接続が再度確立されると、メッセージはキューから受信側アプリケーションに転送されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでキューの機能を使用する場合は、標準バインディングのいずれかを使用できます。また、標準バインディングでは要件が満たされない場合には、カスタム バインディングを作成することもできます。関連する標準バインディング、および標準バインディングの選択方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)」を参照してください。カスタム バインディングの作成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## このセクションの内容  
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)  
+ メッセージ キュー概念について概要を示します。  
+  
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によるキューのサポートの概要です。  
+  
+ [方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)  
+ <xref:System.ServiceModel.NetMsmqBinding> クラスを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス間で通信を行う方法を説明します。  
+  
+ [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)  
+ <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションとメッセージ キュー アプリケーション間で通信を行う方法を説明します。  
+  
+ [セッションでキューに置かれたメッセージのグループ化](../../../../docs/framework/wcf/feature-details/grouping-queued-messages-in-a-session.md)  
+ 単一の受信側アプリケーションが関連メッセージを迅速に処理できるように、キューでメッセージをグループ化する方法を説明します。  
+  
+ [トランザクションに含まれるメッセージのバッチ処理](../../../../docs/framework/wcf/feature-details/batching-messages-in-a-transaction.md)  
+ トランザクションでメッセージをバッチ処理する方法について説明します。  
+  
+ [配信不能キューを使用したメッセージ転送エラー処理](../../../../docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md)  
+ 配信不能キューを使用してメッセージの転送エラーと配信エラーを処理する方法、および配信不能キューのメッセージを処理する方法を説明します。  
+  
+ [有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)  
+ 有害メッセージ \(受信側アプリケーションへの配信試行の回数が最大値を超えたメッセージ\) の処理方法を説明します。  
+  
+ [Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](../../../../docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md)  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)]、および [!INCLUDE[wxp](../../../../includes/wxp-md.md)] における [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] キュー機能の相違についてまとめています。  
+  
+ [トランスポート セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-transport-security.md)  
+ トランスポート セキュリティを使用して、キューに置かれたメッセージを保護する方法を説明します。  
+  
+ [メッセージ セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-message-security.md)  
+ メッセージ セキュリティを使用して、キューに置かれたメッセージを保護する方法を説明します。  
+  
+ [キューに置かれたメッセージングのトラブルシューティング](../../../../docs/framework/wcf/feature-details/troubleshooting-queued-messaging.md)  
+ 一般的なキューの問題をトラブルシューティングする方法について説明します。  
+  
+ [キューに置かれた通信のベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-queued-communication.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューを使用した通信のベスト プラクティスについて説明します。  
+  
+## 参照  
+ [Message Queuing](http://msdn.microsoft.com/ja-jp/ff917e87-05d5-478f-9430-0f560675ece1)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/queues-overview.md b/docs/framework/wcf/feature-details/queues-overview.md
new file mode 100644
index 00000000000..eefd806e41a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/queues-overview.md
@@ -0,0 +1,96 @@
+---
+title: "キューの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "キュー [WCF], MSMQ 統合"
+ms.assetid: b8757992-ffce-40ad-9e9b-3243f6d0fce1
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# キューの概要
+ここでは、キューを使った通信の概要とその基本概念を解説します。  後の各セクションでは、キューの概念がどのように [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に活かされているかを詳しく説明します。  
+  
+## キューの基本概念  
+ 分散アプリケーションの設計では、サービスとクライアントとの間の通信に適したトランスポートを選択することが重要になります。  使用するトランスポートの種類の決定には、いくつかの要素が影響します。  そのうちの 1 つである、サービス、クライアント、トランスポートの分離という重要な要素により、キューを使用するトランスポートと、TCP や HTTP などの直接的なトランスポートのどちらを使用するかが決定します。  TCP や HTTP などの直接的なトランスポートの性質により、サービスやクライアントの機能が停止したり、ネットワークに障害が発生したりすると、通信全体が停止します。  アプリケーションが全体として正常に機能するためには、サービス、クライアント、ネットワークがすべて揃って稼働している必要があります。  キューを使用するトランスポートでは、分離が実現されます。つまり、サービスやクライアントが停止したり、これらの間の通信リンクに障害が発生したりしても、障害が発生していないサービスやクライアントは引き続き機能します。  
+  
+ キューとは、通信ノードやネットワークの障害時にも通信の信頼性を確保するための手段です。  通信ノード間で交換されたメッセージは、いったんキューに取り込まれ、それから配信されます。  通常、キューはその過程で、記憶装置に保存されます。これは、一時的に記憶されるだけの場合も、ある程度の期間保存される場合もあります。  キューは、クライアントからのメッセージをサービスに代わって保存しておき、後でサービスに転送します。  このように、仲介の役割を果たすキューにより、いずれかの通信ノードで生じた障害が分離されるので、システムの可用性およびサービスの分離を実現するには、キューを使用するトランスポートが適しています。  しかしその一方で、通信の遅延が大きい、という欠点があります。  *遅延*とは、クライアントがメッセージを送信してから、サービスが受け取るまでの時間のことです。  遅延が大きいと、メッセージを送ってから実際に処理されるまでに、時間がかかります。  キューを使用する多くのアプリケーションでは、この遅延への対策が講じられています。  次の図は、キューに置かれた通信の概念モデルを表したものです。  
+  
+ ![キューに置かれた通信のモデル](../../../../docs/framework/wcf/feature-details/media/qconceptual-figure1c.gif "QConceptual\-Figure1c")  
+  
+ キューを使う通信の概念モデル  
+  
+ 現実には、キューの概念は分散処理モデルに基づいています。  キューはサービスまたはクライアントと同じホスト上に配置される場合も、この両方から独立している場合もあります。  一般的には、キューはサービスと同じホスト上に配置します。  このような構成の場合、クライアント側では、リモート キューに接続していつでも使用できると想定することはできません。  同様に、キューを使用するサービスの可用性に関係なく、キューの可用性が確保されなければなりません。  そこで、キューの管理がキュー マネージャーによって行われます。  キュー マネージャーは、他のキュー マネージャーからキューに送信されたメッセージを受け取ります。  さらに、リモート キューとの接続を管理し、これらのリモート キューにメッセージを転送するのもキュー マネージャーの役割です。  クライアントやサービスに障害が発生してもキューの可用性を確保できるように、キュー マネージャーは通常、外部サービスとして実行されます。  
+  
+ クライアントがメッセージをキューに送信すると、そのメッセージがターゲット キュー \(サービス側のキュー マネージャーが管理するキュー\) に送信されます。  クライアント側のキュー マネージャーは、メッセージを転送キュー \(送信キュー\) に送ります。  転送キューとは、クライアントのキュー マネージャーが管理するキューであり、ここではターゲット キューに転送されるメッセージがいったん蓄積されます。  次にキュー マネージャーは、ターゲット キューを管理するキュー マネージャーとの通信経路を検索し、転送します。  通信の信頼性を確保するために、キュー マネージャーには、データの損失を防止する転送プロトコルが実装されています。  送信先のキュー マネージャーは、ターゲット キュー宛てのメッセージを受信してターゲット キューに格納します。  ターゲット キューからの読み出しをサービスが要求すると、キュー マネージャーから目的のアプリケーションにメッセージが配信されます。  以上のやり取りに関与する 4 者の関係を図に示します。  
+  
+ ![キューに置かれたアプリケーションの図](../../../../docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg "Distributed\-Queue\-Figure")  
+  
+ キューを使った通信 \- 標準的な構成  
+  
+ このように、キュー マネージャーによりサービスとクライアントが分離されているため、送信側または受信側のいずれかが停止していても、実際の通信には影響しません。  キューの導入によるもう 1 つの利点として、複数のアプリケーションが同じキューからメッセージを読み込めるため、各ノードが個別に通信する場合に比べ、スループットを改善できるという点があります。  実際、拡張性やスループットを改善するためにキューを使用するケースも少なくありません。  
+  
+## キューとトランザクション  
+ トランザクションでは、複数の操作をグループ化できるため、トランザクションに含まれる操作が 1 つでも失敗すると、すべての処理が失敗となります。  例として、ATM を使用して 10 万円を普通預金から当座預金に移すことを考えてみましょう。  これは、次の操作を伴います。  
+  
+-   普通預金から 10 万円を引き出す。  
+  
+-   当座預金に 10 万円を預ける。  
+  
+ 最初の処理が成功して 10 万円が引き出された後、2 番目の操作が失敗すれば、既に引き出された 10 万円が失われてしまいます。  このような状況を避けて口座の状態を有効に維持するには、いずれか一方の操作に失敗したら、両方の操作を失敗と見なす必要があります。  
+  
+ トランザクション メッセージでは、メッセージをキューに送る操作やキューから読み出す操作を、トランザクション内で行えます。  つまり、トランザクション内でメッセージをキューに送った後でそのトランザクションがロールバックされると、その結果は、始めからメッセージを送らなかった場合と同じになります。  同様に、トランザクション内でメッセージを受け取った後でそのトランザクションがロールバックされると、その結果は、メッセージを受信しなかった場合と同じになります。  メッセージはキューに残り、読み出せる状態になります。  
+  
+ 遅延が大きいため、メッセージを送る時点では、ターゲット キューに到達するまでどれぐらいかかるか、サービスがそのメッセージを処理するのにどれぐらいかかるかを知る手段はありません。  したがって、単一のトランザクションを使用してメッセージの送信、受信、処理を行うことは、望ましくありません。  トランザクション全体がコミットされるまでの時間が予測できないからです。  トランザクションを使用してクライアントとサービスがキューを介して通信する場合は、クライアントとサービスでそれぞれトランザクションが必要になります。  下の図は、キューを使った典型的な通信でのトランザクション境界を示しています。  
+  
+ ![トランザクションを含むキュー](../../../../docs/framework/wcf/feature-details/media/qwithtransactions-figure3.gif "QWithTransactions\-Figure3")  
+  
+ キューを使った通信 \- 送受信の別個のトランザクション  
+  
+ クライアントのトランザクションでは、メッセージを処理し、送信します。  トランザクションがコミットされると、メッセージは転送キューに入ります。  一方、サービスでは、ターゲット キューからメッセージを読み取り、メッセージを処理して、トランザクションをコミットします。  メッセージの処理中にエラーが発生すると、そのメッセージはロールバックされ、ターゲット キューに置かれます。  
+  
+## キューを使った非同期通信  
+ キューを利用すると非同期通信も可能です。  キューを使用してメッセージを送信するアプリケーションは、キュー マネージャーで生じる遅延が大きいため、メッセージが受信側で受信および処理されるまで待機することができません。  想定以上に長い期間、メッセージがキューに残ったままになる可能性があるからです。  この状況を回避するために、メッセージに有効期間 \(TTL: Time\-To\-Live\) を設定できるようになっています。  これはメッセージが転送キューに留まっていられる時間を表す値です。  この時間が経過してもターゲット キューに送信されなかったメッセージは、配信不能キューに転送することができます。  
+  
+ 送信側がメッセージを送信した時点で、送信操作から制御が戻っても、送信側の転送キューにメッセージが到達したことを示しているにすぎません。  ターゲット キューへの転送に失敗していても、送信元アプリケーションで、すぐにそれを知ることはできないのです。  このような失敗を記録するために、失敗したメッセージは配信不能キューに転送されます。  
+  
+ ターゲット キューに到達できなかったり有効期間を経過したエラーは、個別に処理する必要があります。  このため、キューを使用するアプリケーションでは、次の 2 つに分けてロジックを記述することも少なくありません。  
+  
+-   正常時にクライアントおよびサービスがメッセージを送受信するためのロジック  
+  
+-   失敗した転送や配信からのメッセージを処理するための補正ロジック  
+  
+ 以下のセクションで、これらの概念について説明します。  
+  
+## 配信不能キューのプログラミング  
+ 配信不能キューには、さまざまな原因によりターゲット キューに到達できなかったメッセージが収容されます。  原因としては、有効期限の経過や、ターゲット キューとの接続経路の異常などが考えられます。  
+  
+ 通常、アプリケーションは、システム全体の配信不能キューを読み取り、エラー原因を調べたうえで、エラー状態を修復して再送したり、エラーを記録したりするなどの適切な処理を行うことができます。  
+  
+## 有害メッセージ キューのプログラミング  
+ メッセージがターゲット キューに到達しても、サービス側で繰り返し処理に失敗する場合があります。  原因としては、アプリケーションがトランザクション内でキューからメッセージを読み込み、データベースを更新しようとしたところ、データベースの接続が一時的に切断されていた、というような状況が考えられます。  この場合は、トランザクションのロールバック、新たなトランザクションの作成、メッセージの再読み込みが行われます。  ただし、2 回目の試行で成功するかどうかはわかりません。  エラーの原因によっては、メッセージをアプリケーションに配信する処理が繰り返し失敗することがあります。  このようなメッセージは "有害" であると見なされ、有害メッセージ キューに移されます。このキューの内容は、有害メッセージを処理するアプリケーションに渡すことができます。  
+  
+## 参照  
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [セッションとキュー](../../../../docs/framework/wcf/samples/sessions-and-queues.md)   
+ [配信不能キュー](../../../../docs/framework/wcf/samples/dead-letter-queues.md)   
+ [揮発性キューによる通信](../../../../docs/framework/wcf/samples/volatile-queued-communication.md)   
+ [Windows Communication Foundation でのメッセージ キュー](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)   
+ [メッセージ キュー \(MSMQ\) のインストール](../../../../docs/framework/wcf/samples/installing-message-queuing-msmq.md)   
+ [Message Queuing Integration Binding Samples](http://msdn.microsoft.com/ja-jp/997d11cb-f2c5-4ba0-9209-92843d4d0e1a)   
+ [Windows Communication Foundation へのメッセージ キュー](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)   
+ [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/queuing-in-wcf.md b/docs/framework/wcf/feature-details/queuing-in-wcf.md
new file mode 100644
index 00000000000..82508b62cbc
--- /dev/null
+++ b/docs/framework/wcf/feature-details/queuing-in-wcf.md
@@ -0,0 +1,139 @@
+---
+title: "WCF でのキュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e98d76ba-1acf-42cd-b137-0f8214661112
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# WCF でのキュー
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でキュー通信を使用する方法について説明します。  
+  
+## WCF トランスポート バインディングとしてのキュー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、交換する内容をコントラクトによって指定します。  コントラクトは、ビジネスによって異なるまたはアプリケーション固有のメッセージ交換です。  メッセージ交換に使用する機構 \(または "方法"\) は、バインディングで指定します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のバインディングは、メッセージ交換の詳細をカプセル化します。  バインディングは、そのバインディングが表すトランスポートまたはプロトコルのさまざまな部分をユーザーが制御するための構成調整情報を公開します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューは、他のトランスポート バインディングと同様に扱われます。これは、多くのキュー アプリケーションにとって大きな利点となります。  現在、多くのキュー アプリケーションは、他のリモート プロシージャ コール \(RPC\) スタイルの分散アプリケーションとは異なる方法で記述されており、これが原因でフォローと管理が難しくなっています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、分散アプリケーションを記述するスタイルはほとんど同じなので、フォローと管理が簡単です。  さらに、交換の機構をビジネス ロジックから切り離すことによって、アプリケーション固有のコードに影響を与えることなく、簡単にトランスポートを構成したり、そのトランスポートに変更を加えたりできます。  次の図は、MSMQ をトランスポートとして使用する WCF サービスとクライアントの構造を示しています。  
+  
+ ![キューに置かれたアプリケーションの図](../../../../docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg "Distributed\-Queue\-Figure")  
+  
+ 上の図からわかるように、クライアントとサービスは、アプリケーションのセマンティクス、つまりコントラクトと実装だけを定義する必要があります。  サービスは、優先設定を使用してキューに置かれたバインディングを構成します。  クライアントは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、サービスに対する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成し、サービスへのメッセージ送信に使用するバインディングを記述した構成ファイルを生成します。  したがって、キューに置かれたメッセージを送信するとき、クライアントは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントをインスタンス化し、そのクライアントに対する操作を呼び出します。  これによって、メッセージは転送キューに送信され、次にターゲット キューに転送されます。  キュー通信の複雑さはすべて、メッセージを送受信するアプリケーションからは見えません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューに置かれたバインディングには、次の注意事項があります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で既定のキューに置かれたバインディングは、キューを使用した双方向通信をサポートしないので、すべてのサービス操作は一方向である必要があります。  双方向通信のサンプル \(「[双方向通信](../../../../docs/framework/wcf/samples/two-way-communication.md)」\) では、2 つの一方向コントラクトを使用して、キューを使用した双方向通信を実装する方法について説明しています。  
+  
+-   メタデータ交換を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成するには、サービスに追加の HTTP エンドポイントが必要です。これによって、エンドポイントを直接照会して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを生成したり、キュー通信を適切に構成するためにバインディング情報を取得したりできるようになります。  
+  
+-   キューに置かれたバインディングに応じて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の外側で別の構成が必要になります。  たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に付属の <xref:System.ServiceModel.NetMsmqBinding> クラスでは、バインディングを構成する以外に、メッセージ キュー \(MSMQ\) を最小限構成することが必要です。  
+  
+ 後のセクションでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に付属する、MSMQ に基づいた特定のキューに置かれたバインディングについて説明します。  
+  
+### MSMQ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューに置かれたトランスポートでは、そのキュー通信に MSMQ を使用します。  
+  
+ MSMQ は Windows のオプション コンポーネントとして付属し、NT サービスの 1 つとして実行されます。  MSMQ サービスは、転送するメッセージを転送キューから取り込み、配信するメッセージをターゲット キューから取り込みます。  MSMQ キュー マネージャーは信頼できるメッセージ転送プロトコルを実装して、送信中にメッセージが失われないようにします。  このプロトコルは、ネイティブまたは SOAP リライアブル メッセージ プロトコル \(SRMP\) などの SOAP ベースのプロトコルです。  
+  
+ MSMQ では、キューをトランザクションまたは非トランザクションとして設定できます。  トランザクション キューの場合、トランザクションによるメッセージの取り込みと配信が可能です。メッセージは、キューに永続的に格納されます。  トランザクション キューに送信されたメッセージは、正確に 1 回だけ、順序どおりに転送されます。  非トランザクション キューを使用すると、揮発性メッセージと非揮発性メッセージの両方を送信できます。  非トランザクション キューに送信されたメッセージには、信頼できる転送保証がありません。したがって、メッセージが失われる可能性があります。  
+  
+ MSMQ キューも、Active Directory ディレクトリ サービスに登録された Windows ID を使用してセキュリティで保護できます。  MSMQ をインストールするとき、Active Directory 統合をインストールできます。Active Directory 統合では、コンピューターを Windows ドメイン ネットワークに含める必要があります。  
+  
+ MSMQ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Message Queuing \(MSMQ\)](http://msdn.microsoft.com/ja-jp/ff917e87-05d5-478f-9430-0f560675ece1)」を参照してください。  
+  
+### NetMsmqBinding  
+ [\<netMsmqBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md) [!INCLUDE[indigo2 は、]()] [!INCLUDE[indigo2 に用意されているキューに置かれたバインディングで、2 つの]()] エンドポイントが MSMQ を使用して通信するために使用します。  したがって、このバインディングは、MSMQ 固有のプロパティを公開します。  ただし、すべての MSMQ 機能とプロパティが `NetMsmqBinding` で公開されるわけではありません。  コンパクトな `NetMsmqBinding` は、大部分のユーザーが満足できる最適な機能セットを考慮して設計されています。  
+  
+ `NetMsmqBinding` は、これまでに説明した基本的なキューの概念をバインディングのプロパティという形で明確に示しています。  このプロパティは、メッセージの転送方法と配信方法を MSMQ に伝達します。  プロパティのカテゴリの詳細については、後のセクションを参照してください。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、特定のプロパティについて詳しく説明している概念に関するトピックを参照してください。  
+  
+#### ExactlyOnce プロパティと Durable プロパティ  
+ `ExactlyOnce` プロパティと `Durable` プロパティは、キュー間のメッセージの転送方法を制御します。  
+  
+-   `ExactlyOnce`: `true` \(既定\) に設定した場合、キューに置かれたチャネルによって、メッセージが重複しないようにすることができます \(メッセージが配信される場合\)。  また、メッセージが失われないようにすることもできます。  メッセージを配信できない場合、またはメッセージを配信する前にメッセージの有効期間 \(TTL: Time To Live\) が切れた場合、失敗したメッセージが配信エラー理由と共に配信不能キューに記録されます。  `false` に設定した場合、キューに置かれたチャネルにより、メッセージの転送が試行されます。  この場合、必要に応じて配信不能キューを選択できます。  
+  
+-   `Durable:` `true` \(既定\) に設定した場合、キューに置かれたチャネルによって、MSMQ がメッセージをディスクに永続的に格納することが保証されます。  したがって、MSMQ サービスを停止して再起動した場合、ディスク上のメッセージがターゲット キューに転送されるか、サービスに配信されます。  `false` に設定した場合、メッセージは揮発性ストアに格納され、MSMQ サービスを停止して再起動すると、メッセージは失われます。  
+  
+ `ExactlyOnce` の信頼できる転送を実現するために、MSMQ ではトランザクション キューを使用する必要があります。  また、MSMQ では、トランザクションがトランザクション キューから読み取られる必要があります。  このため、`NetMsmqBinding` を使用する場合、`ExactlyOnce` を `true` に設定したときは、メッセージの送受信にトランザクションが必要なことに注意してください。  同様に、ベスト エフォート保証を使用する場合 \(`ExactlyOnce` が `false` の場合など\) および揮発性メッセージングを行う場合、MSMQ で非トランザクション キューを使用する必要があります。  このため、`ExactlyOnce` を `false` に設定するか、または Durable を `false` に設定した場合、トランザクションを使用して送受信できません。  
+  
+> [!NOTE]
+>  正しいキュー \(トランザクションまたは非トランザクション\) がバインディングの設定に基づいて作成されるようにしてください。  `ExactlyOnce` が `true` の場合はトランザクション キューを使用し、false の場合は非トランザクション キューを使用します。  
+  
+#### 配信不能キューのプロパティ  
+ 配信不能キューは、配信に失敗したメッセージを格納するために使用されます。  ユーザーは、配信不能キューからメッセージを読み取る補正ロジックを記述できます。  
+  
+ 多くのキュー システムは、システム全体の配信不能キューを提供します。  MSMQ は、非トランザクション キューへの配信が失敗したメッセージに対してシステム全体の非トランザクション配信不能キューを提供し、トランザクション キューへの配信が失敗したメッセージに対してシステム全体のトランザクション配信不能キューを提供します。  
+  
+ 異なるターゲット キューにメッセージを送信する複数のクライアントによって MSMQ サービスが共有される場合、クライアントが送信したすべてのメッセージが同じ配信不能キューに集まります。  これが適さない状況もあります。  分離を向上するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [!INCLUDE[wv](../../../../includes/wv-md.md)] の MSMQ には、ユーザーが配信に失敗したメッセージを格納するために指定できるカスタム配信不能キュー \(またはアプリケーション固有の配信不能キュー\) が用意されています。  したがって、異なるクライアントが同じ配信不能キューを共有することがありません。  
+  
+ バインディングには、2 つの該当するプロパティがあります。  
+  
+-   `DeadLetterQueue`: このプロパティは、配信不能キューが要求されるかどうかを示す列挙体です。  この列挙体では、配信不能キューが要求される場合、そのキューの種類も指定します。  値は、`None`、`System`、および `Custom` です。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] これらのプロパティの解釈については、「[配信不能キューを使用したメッセージ転送エラー処理](../../../../docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md)」を参照してください。  
+  
+-   `CustomDeadLetterQueue`: このプロパティは、アプリケーション固有の配信不能キューの URI \(Uniform Resource Identifier\) アドレスです。  `DeadLetterQueue`.`Custom` を選択した場合、このプロパティは必須です。  
+  
+#### 有害メッセージ処理プロパティ  
+ サービスがトランザクションでターゲット キューからメッセージを読み取るとき、サービスはさまざまな原因でメッセージの処理に失敗する可能性があります。  失敗したメッセージは、再度読み取るためにキューに戻されます。  繰り返し失敗するメッセージを処理するために、有害メッセージ処理プロパティをバインディングで構成できます。  `ReceiveRetryCount`、`MaxRetryCycles`、`RetryCycleDelay`、および `ReceiveErrorHandling` という 4 つのプロパティがあります。  これらのプロパティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)」を参照してください。  
+  
+#### セキュリティ プロパティ  
+ MSMQ では、キューのアクセス制御リスト \(ACL\)、認証されたメッセージの送信など、独自のセキュリティ モデルを公開します。  `NetMsmqBinding` は、このセキュリティ プロパティをそのトランスポート セキュリティ設定の一部として公開します。  トランスポート セキュリティのバインディングには、`MsmqAuthenticationMode` プロパティおよび `MsmqProtectionLevel` プロパティという 2 つのプロパティがあります。  このプロパティの設定は、MSMQ の構成方法によって異なります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [トランスポート セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-transport-security.md).  
+  
+ トランスポート セキュリティに加えて、実際の SOAP メッセージはメッセージ セキュリティでも保護できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [メッセージ セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-message-security.md).  
+  
+ また、`MsmqTransportSecurity` は、2 つのプロパティ `MsmqEncryptionAlgorithm` と `MsmqHashAlgorithm` を公開します。  このプロパティは、キュー間の転送でメッセージを暗号化するために、または署名をハッシュするために選択できる異なるアルゴリズムの列挙体です。  
+  
+#### その他のプロパティ  
+ 上記のプロパティに加えて、次の MSMQ 固有のプロパティがバインディングで公開されます。  
+  
+-   `UseSourceJournal`: ソース ジャーナリングが有効かどうかを示すプロパティです。  ソース ジャーナリングとは、転送キューから正常に送信されたメッセージを追跡する MSMQ の機能です。  
+  
+-   `UseMsmqTracing`: MSMQ トレースが有効かどうかを示すプロパティです。  MSMQ トレースでは、MSMQ キュー マネージャーをホストしているコンピューターでメッセージが送受信されるたびに、レポート メッセージをレポート キューに送信します。  
+  
+-   `QueueTransferProtocol`: キュー間のメッセージ転送に使用するプロトコルの列挙体です。  MSMQ では、ネイティブのキュー間転送プロトコルおよび SOAP リライアブル メッセージ プロトコル \(SRMP\) と呼ばれる SOAP ベースのプロトコルを実装しています。  SRMP は、キュー間の転送に HTTP トランスポートを使用している場合に使用します。  SRMP Secure は、キュー間の転送に HTTPS を使用している場合に使用します。  
+  
+-   `UseActiveDirectory`: キューのアドレス解決に Active Directory を使用する必要があるかどうかを示すブール値です。  既定ではオフになっています。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [サービス エンドポイントとキューのアドレス指定](../../../../docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md).  
+  
+### MsmqIntegrationBinding  
+ `MsmqIntegrationBinding` は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントが、C、C\+\+、COM、または System.Messaging API を使用して作成された既存の MSMQ アプリケーションと通信する場合に使用されます。  
+  
+ このバインディングのプロパティは、`NetMsmqBinding` のプロパティと同じです。  ただし、次のような違いがあります。  
+  
+-   `MsmqIntegrationBinding` の操作コントラクトは、型パラメーターが本文型である型 <xref:System.ServiceModel.MsmqIntegration.MsmqMessage%601> の 1 つのパラメーターしか指定することができません。  
+  
+-   ほとんどの MSMQ ネイティブ メッセージ プロパティは、使用するために <xref:System.ServiceModel.MsmqIntegration.MsmqMessage%601> で公開されます。  
+  
+-   メッセージ本文のシリアル化と逆シリアル化のために、XML、ActiveX などのシリアライザーが用意されています。  
+  
+### サンプル コード  
+ MSMQ を使用する WCF サービスを書き込む方法の手順については、次のトピックを参照してください。  
+  
+-   [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)  
+  
+-   [方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)  
+  
+ WCF での MSMQ の使用を示す完全なコード サンプルについては、次のトピックを参照してください。  
+  
+-   [トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)  
+  
+-   [揮発性キューによる通信](../../../../docs/framework/wcf/samples/volatile-queued-communication.md)  
+  
+-   [配信不能キュー](../../../../docs/framework/wcf/samples/dead-letter-queues.md)  
+  
+-   [セッションとキュー](../../../../docs/framework/wcf/samples/sessions-and-queues.md)  
+  
+-   [双方向通信](../../../../docs/framework/wcf/samples/two-way-communication.md)  
+  
+-   [トランザクション バッチ](../../../../docs/framework/wcf/samples/transacted-batching.md)  
+  
+-   [SRMP](../../../../docs/framework/wcf/samples/srmp.md)  
+  
+-   [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)  
+  
+## 参照  
+ [サービス エンドポイントとキューのアドレス指定](../../../../docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md)   
+ [キューに置かれたアプリケーションの Web ホスト](../../../../docs/framework/wcf/feature-details/web-hosting-a-queued-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/readme-for-extended-protection-authentication-sample.md b/docs/framework/wcf/feature-details/readme-for-extended-protection-authentication-sample.md
new file mode 100644
index 00000000000..e7dd1b868d6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/readme-for-extended-protection-authentication-sample.md
@@ -0,0 +1,55 @@
+---
+title: "拡張保護認証のサンプルの ReadMe | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 80bf2e97-398d-4db5-9040-d96478a2ccab
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# 拡張保護認証のサンプルの ReadMe
+拡張保護は、攻撃者 \(man\-in\-the\-middle\) がクライアントの資格情報をインターセプトしてクライアントの目的のサーバー上のセキュリティ保護されたリソースにアクセスする MITM \(man\-in\-the\-middle\) 攻撃に対するセキュリティ イニシアチブです。  
+  
+ 詳細については、「[認証の拡張保護の概要](../../../../docs/framework/wcf/feature-details/extended-protection-for-authentication-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルは、IIS でホストされた場合にのみ機能します。このサンプルは HTTPS をサポートしないので、Visual Studio Development Server 上では機能しません。  
+  
+## サンプルをセットアップしてビルドし、実行するには  
+  
+1.  \[プログラムの追加と削除\] の \[Windows の機能\] から IIS をインストールします。  
+  
+2.  Windows 機能の Windows 認証を有効にします \(\[インターネット インフォメーション サービス\] \-\> \[World Wide Web サービス\] \-\> \[セキュリティ\] \-\> \[Windows 認証\]\)。  
+  
+3.  Windows 機能の HTTP アクティブ化を有効にします \(\[Microsoft .NET Framework 3.5.1\] \-\> \[Windows Communication Foundation HTTP Activation\]\)。  
+  
+4.  このサンプルを実行するには、サーバーとの安全なチャネルを確立する必要のあるクライアントが必要なので、インターネット インフォメーション サービス \(IIS\) マネージャーからインストールすることのできるサーバー証明書が存在する必要があります。  
+  
+    1.  IIS マネージャーを開いて、\[機能表示\] タブから \[サーバー証明書\] を選択します。  
+  
+    2.  このサンプルをテストする目的で、自己署名証明書を作成できます \(インターネット エクスプローラーで証明書の安全性に関するプロンプトが表示されないようにする場合は、信頼されたルート証明機関ストアに証明書をインストールできます\)。  
+  
+5.  既定の Web サイトの操作ウィンドウに移動します。\[サイトの編集\] の \[バインド\] をクリックします。存在しない場合は、種類として HTTPS を追加します。ポート番号に 443 を指定し、前の手順で作成した SSL 証明書を割り当てます。  
+  
+6.  サービスをビルドします。\(プロジェクト プロパティで指定されたビルド後のアクションから\) IIS に仮想ディレクトリが作成され、サービスを Web ホスト サービスにするために必要な dll、.svc、および構成ファイルがコピーされます。  
+  
+7.  IIS マネージャーを開きます。前の手順で作成した仮想ディレクトリ \(ExtendedProtection\) を右クリックして、\[アプリケーションへの変換\] を選択します。  
+  
+8.  この仮想ディレクトリの認証モジュールを IIS マネージャーで開き、Windows 認証を有効にします。  
+  
+9. このサンプルでは対応する ExtendedProtection 設定が \[常に\] に設定されているので、この仮想ディレクトリの Windows 認証の \[詳細設定\] を開き、\[必須\] に設定します。  
+  
+10. ブラウザー ウィンドウから URL にアクセスして、サービスをテストできます。コンピューター間でこの URL にアクセスする場合は、すべての受信 HTTP および HTTPS 通信に対してファイアウォールが開かれていることを確認してください。  
+  
+11. クライアント構成ファイルを開いて、\<\<full\_machine\_name\>\> を置き換えて \<\<client \- \>\>endpoint \- address attribute の完全なマシン名を指定します。  
+  
+12. クライアントを実行します。クライアントがセキュリティで保護されたチャネルを確立し、エンドポイント保護を使用してサービスと通信します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-0.md b/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-0.md
new file mode 100644
index 00000000000..c2e75ac9d46
--- /dev/null
+++ b/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-0.md
@@ -0,0 +1,415 @@
+---
+title: "信頼できるメッセージング プロトコル バージョン 1.0 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5509a5c-de24-4bc2-9a48-19138055dcce
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 信頼できるメッセージング プロトコル バージョン 1.0
+ここでは、HTTP トランスポートを使用した相互運用に必要な WS\-ReliableMessaging 2005\/02 \(バージョン 1.0\) プロトコルに関する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 実装の詳細について説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ここに記載した制約と説明に基づく WS\-ReliableMessaging 仕様に従っています。WS\-ReliableMessaging バージョン 1.0 プロトコルは、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] 以降に実装されています。  
+  
+ WS\-ReliableMessaging 2005\/02 プロトコルは、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement> によって [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に実装されます。  
+  
+ 便宜上、ここでは次のロールを使用します。  
+  
+-   イニシエーター : WS\-Reliable メッセージ シーケンスの作成を開始するクライアント  
+  
+-   レスポンダー : イニシエーターの要求を受け取るサービス  
+  
+ このドキュメントでは、次の表に示すプレフィックスと名前空間を使用します。  
+  
+|プレフィックス|名前空間|  
+|-------------|----------|  
+|wsrm|http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/rm|  
+|netrm|http:\/\/schemas.microsoft.com\/ws\/2006\/05\/rm|  
+|s|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|wsa|http:\/\/schemas.xmlsoap.org\/ws\/2005\/08\/addressing|  
+|wsse|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wssecurity\-secext\-1.0.xsd|  
+  
+## メッセージング  
+  
+### シーケンス確立メッセージ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、信頼性の高いメッセージ シーケンスを確立するために、`CreateSequence` メッセージと `CreateSequenceResponse` メッセージを実装しています。以下の制約が適用されます。  
+  
+-   B1101 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CreateSequence` メッセージのオプションの Expires 要素を生成しません。また、`CreateSequence` メッセージに `Offer` 要素が含まれているときに、この `Offer` 要素内のオプションの `Expires` 要素も生成しません。  
+  
+-   B1102 : `CreateSequence` メッセージのアクセス時に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]`Responder` は、両方の `Expires` 要素を送受信しますが \(存在する場合\)、値は使用しません。  
+  
+ WS\-ReliableMessaging では、セッションを形成する、相関する 2 つの逆方向シーケンスを確立するために、`Offer` 機構が導入されています。  
+  
+-   R1103 : `CreateSequence` に `Offer` 要素が含まれている場合、Reliable メッセージング レスポンダーは、シーケンスを受け入れ、`wsrm:Accept` 要素を含む `CreateSequenceResponse` で応答して、相関する 2 つの逆方向シーケンスを形成するか、`CreateSequence` 要求を拒否する必要があります。  
+  
+-   R1104 : 逆方向シーケンスでフローする `SequenceAcknowledgement` およびアプリケーション メッセージは、`CreateSequence` の `ReplyTo` エンドポイント参照に送信される必要があります。  
+  
+-   R1105 : `CreateSequence` の `AcksTo` エンドポイント参照と `ReplyTo` エンドポイント参照には、オクテット単位で一致するアドレス値が必要です。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`AcksTo` EPR と `ReplyTo` EPR の URI 部分が同一であるかどうかを検証します。  
+  
+-   R1106 : `CreateSequence` の `AcksTo` および `ReplyTo` の各エンドポイント参照は、参照パラメーターの同じセットを持つ必要があります。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CreateSequence` の `AcksTo` と `ReplyTo` の \[参照パラメーター\] が同一であることを強制するわけではありません。ただし、これらが同一であると想定した上で、受信確認と逆方向シーケンス メッセージに `ReplyTo` エンドポイント参照の \[参照パラメーター\] を使用します。  
+  
+-   R1107 : `Offer` 機構を使用して 2 つの逆方向シーケンスを確立した場合、逆方向シーケンスでフローする `SequenceAcknowledgement` およびアプリケーション メッセージは、`CreateSequence` の `ReplyTo` エンドポイント参照に送信される必要があります。  
+  
+-   R1108 : Offer 機構を使用して 2 つの逆方向シーケンスを確立した場合、`CreateSequenceResponse` の `wsrm:Accept` 要素の `wsrm:AcksTo` エンドポイント参照子要素の `[address]` プロパティは、`CreateSequence` の送信先 URI とバイト単位で一致する必要があります。  
+  
+-   R1109 : `Offer` 機構を使用して 2 つの逆方向シーケンスを確立した場合、イニシエーターによって送信されたメッセージとレスポンダーによるメッセージの受信確認は、同じエンドポイント参照に送信される必要があります。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging を使用して、イニシエーターとレスポンダー間で信頼性できるセッションを確立します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-ReliableMessaging 実装により、一方向、要求\/応答、双方向の各メッセージ パターンの信頼できるセッションが実現します。`CreateSequence`\/`CreateSequenceResponse` で WS\-ReliableMessaging の `Offer` 機構を使用すると、相関する 2 つの逆方向シーケンスを確立でき、すべてのメッセージ エンドポイントに適したセッション プロトコルが提供されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、セッション整合性を保つためのエンドツーエンドの保護を含むこのようなセッションに対してセキュリティが保証されているため、同じパーティを対象とするメッセージが同じ送信先に到着することが事実上保証されます。また、これにより、アプリケーション メッセージにシーケンス受信確認を抱き合わせることができます。したがって、制約 R1104、R1105、および R1108 が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用されています。  
+  
+ `CreateSequence` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action s:mustUnderstand="1">  
+      http://schemas.xmlsoap.org/ws/2005/02/rm/CreateSequence  
+    </a:Action>  
+    <a:ReplyTo>  
+      <a:Address>          
+         http://Business456.com/clientA        
+      </a:Address>  
+    </a:ReplyTo>  
+    <a:MessageID>  
+      urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36  
+    </a:MessageID>  
+    <a:To s:mustUnderstand="1">  
+      http://Business456.com/clientA  
+    </a:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:CreateSequence>  
+      <wsrm:AcksTo>  
+       <wsa:Address>  
+         http://Business456.com/clientA  
+       </wsa:Address>  
+     </wsrm:AcksTo>  
+     <wsrm:Offer>  
+      <wsrm:Identifier>  
+        urn:uuid:0afb8d36-bf26-4776-b8cf-8c91fddb5496  
+      </wsrm:Identifier>  
+     </wsrm:Offer>  
+   </wsrm:CreateSequence>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+ `CreateSequenceResponse` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action s:mustUnderstand="1">  
+      http://schemas.xmlsoap.org/ws/2005/02/rm/CreateSequenceResponse  
+    </a:Action>  
+    <a:RelatesTo>  
+      urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36  
+    </a:RelatesTo>  
+    <a:To s:mustUnderstand="1">  
+      http://Business456.com/clientA  
+    </a:To>  
+  </s:Header>  
+  <s:Body>  
+   <wsrm:CreateSequenceResponse>  
+    <Identifier>  
+     urn:uuid:eea0a36c-b38a-43e8-8c76-2fabe2d76386  
+    </Identifier>  
+    <Accept>  
+    <AcksTo>  
+      <a:Address>  
+        http://BusinessABC.com/serviceA  
+      </a:Address>  
+    </AcksTo>  
+    </Accept>  
+   </wsrm:CreateSequenceResponse>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### シーケンス  
+ シーケンスに適用される制約を以下に示します。  
+  
+-   B1201 :[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`xs:long` の最大値 \(9223372036854775807\) 以下のシーケンス番号を生成し、これらの番号にアクセスします。  
+  
+-   B1202 :[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、アクション URI が http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/rm\/LastMessage である、空の本文を持つ最後のメッセージを必ず生成します。  
+  
+-   B1203 : アクション URI が http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/rm\/LastMessage でない場合には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `LastMessage` 要素を含むシーケンス ヘッダーを持つメッセージを受信および配信します。  
+  
+ シーケンス ヘッダーのサンプル  
+  
+```  
+<wsrm:Sequence>  
+  <wsrm:Identifier>  
+    urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36  
+  </wsrm:Identifier>  
+  <wsrm:MessageNumber>  
+    10  
+  </wsrm:MessageNumber>  
+  <wsrm:LastMessage/>  
+ </wsrm:Sequence>  
+```  
+  
+### AckRequested ヘッダー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Keep\-alive 機構として `AckRequested` ヘッダーを使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、オプションの `MessageNumber` 要素を生成しません。`MessageNumber` 要素を含む `AckRequested` ヘッダーを持つメッセージを受信すると、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `MessageNumber` 要素の値を無視します。  
+  
+```  
+<wsrm:AckRequested>  
+  <wsrm:Identifier>  
+    urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36  
+  </wsrm:Identifier>  
+</wsrm:AckRequested>  
+```  
+  
+### SequenceAcknowledgement ヘッダー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging で用意されているシーケンス受信確認の抱き合わせ機構を使用します。  
+  
+-   R1401 : `Offer` 機構を使用して 2 つの逆方向シーケンスを確立した場合、目的の受信者に送信されるアプリケーション メッセージに、`SequenceAcknowledgement` ヘッダーを含めることができます。  
+  
+-   B1402 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がシーケンス メッセージを受信する前に受信確認を生成する必要がある場合 \(`AckRequested` メッセージに応える場合など\)、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は範囲 0 ～ 0 を含む `SequenceAcknowledgement` ヘッダーを生成します。  
+  
+    ```  
+    <wsrm:SequenceAcknowledgement>  
+      <wsrm:Identifier>  
+        urn:uuid:addabbbf-60cb-44d3-8c5b-9e0841629a36  
+      </wsrm:Identifier>  
+      <wsrm:AcknowledgementRange Upper="0" Lower="0"/>  
+    </wsrm:SequenceAcknowledgement>  
+    ```  
+  
+-   B1403 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`Nack` 要素をサポートしていますが、`Nack` 要素を含む `SequenceAcknowledgement` ヘッダーは生成しません。  
+  
+### WS\-ReliableMessaging エラー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-ReliableMessaging エラー実装に適用される制約を以下に示します。  
+  
+-   B1501 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`MessageNumberRollover` エラーを生成しません。  
+  
+-   B1502 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]エンドポイントは、仕様に記載されているように `CreateSequenceRefused` エラーを生成する場合があります。  
+  
+-   B1503 :サービス エンドポイントが接続制限に達したため、新しい接続を処理できない場合、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `CreateSequenceRefused` エラー サブコード `netrm:ConnectionLimitReached` を追加生成します。  
+  
+    ```  
+    <s:Envelope>  
+      <s:Header>  
+        <wsa:Action>  
+          http://schemas.xmlsoap.org/ws/2005/08/addressing/fault  
+        </wsa:Action>  
+      </s:Header>  
+      <s:Body>  
+        <s:Fault>  
+          <s:Code>  
+            <s:Value>  
+              s:Receiver  
+            </s:Value>  
+            <s:Subcode>  
+              <s:Value>  
+                wsrm:CreateSequenceRefused  
+              </s:Value>  
+              <s:Subcode>  
+                <s:Value>  
+                  netrm:ConnectionLimitReached  
+                </s:Value>  
+              </s:Subcode>  
+            </s:Subcode>  
+          </s:Code>  
+          <s:Reason>  
+            <s:Text xml:lang="en">  
+              [Reason]  
+            </s:Text>  
+          </s:Reason>  
+        </s:Fault>  
+      </s:Body>  
+    </s:Envelope>  
+    ```  
+  
+### WS\-Addressing エラー  
+ WS\-ReliableMessaging は WS\-Addressing を使用するため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-ReliableMessaging 実装は、WS\-Addressing エラーを生成する場合があります。ここでは、WS\-ReliableMessaging レイヤーで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が明示的に生成する WS\-Addressing エラーについて説明します。  
+  
+-   B1601 :次のいずれかに該当する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は Message Addressing Header Required エラーを生成します。  
+  
+    -   メッセージに `Sequence` ヘッダーと `Action` ヘッダーがない。  
+  
+    -   `CreateSequence` メッセージに `MessageId` ヘッダーがない。  
+  
+    -   `CreateSequence` メッセージに `ReplyTo` ヘッダーがない。  
+  
+-   B1602 :[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`Sequence` ヘッダーがなく、WS\-Reliable Messaging 仕様では認識されない `Action` ヘッダーを持つメッセージへの応答として Action Not Supported エラーを生成します。  
+  
+-   B1603 :[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CreateSequence` メッセージのアドレス指定ヘッダーの検査に基づいて、エンドポイントがそのシーケンスを処理しないことを示す Endpoint Unavailable エラーを生成します。  
+  
+## プロトコル コンポジション  
+  
+### WS\-Addressing によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Addressing の 2 つのバージョンをサポートしています。WS\-Addressing 2004\/08 \[WS\-ADDR\] と、W3C WS\-Addressing 1.0 Recommendation \(\[WS\-ADDR\-CORE\] および \[WS\-ADDR\-SOAP\]\) です。  
+  
+ WS\-ReliableMessaging 仕様に記載されているのは、WS\-Addressing 2004\/08 だけですが、使用する WS\-Addressing のバージョンが制限されているわけではありません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   R2101 :WS\-Addressing 2004\/08 と WS\-Addressing 1.0 の両方を WS\-ReliableMessaging で使用できます。  
+  
+-   R2102 :特定の WS\-ReliableMessaging シーケンス、または `wsrm:Offer` 機構を使用して関連付けられた逆方向シーケンスのペアでは、同じバージョンの WS\-Addressing を使用する必要があります。  
+  
+### SOAP によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-ReliableMessaging で SOAP 1.1 と SOAP 1.2 の両方を使用できます。  
+  
+### WS\-Security と WS\-SecureConversation によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティで保護されたトランスポート \(HTTPS\)、WS\-Security によるコンポジション、および WS\-SecureConversation によるコンポジションを使用して、WS\-ReliableMessaging シーケンスを保護します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   R2301 :個々のメッセージの整合性と機密性だけでなく、WS\-ReliableMessaging シーケンスの整合性を保護するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では WS\-SecureConversation を使用する必要があります。  
+  
+-   R2302 :WS\-ReliableMessaging シーケンスを確立する前に、WS\-SecureConversation セッションを確立する必要があります。  
+  
+-   R2303 : WS\-ReliableMessaging シーケンスの有効期間が WS\-SecureConversation セッションの有効期間よりも長い場合は、対応する WS\-SecureConversation Renewal バインディングを使用して、WS\-SecureConversation によって確立された `SecurityContextToken` を更新する必要があります。  
+  
+-   B2304 :WS\-ReliableMessaging シーケンスまたは相関する逆方向シーケンスのペアは、必ず同じ WS\-SecureConversation セッションにバインドされます。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ソースは、`CreateSequence` メッセージの要素拡張セクションに、`wsse:SecurityTokenReference` 要素を生成します。  
+  
+-   R2305 :WS\-SecureConversation を使用して構成した場合、`CreateSequence` メッセージに `wsse:SecurityTokenReference` 要素が含まれている必要があります。  
+  
+## WS\-ReliableMessaging の WS\-Policy アサーション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging の `wsrm:RMAssertion` WS\-Policy アサーションを使用して、エンドポイントの機能を記述します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   B3001: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsrm:RMAssertion` WS\-Policy アサーションを `wsdl:binding` 要素に添付します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsdl:binding` 要素および `wsdl:port` 要素への添付をサポートしています。  
+  
+-   B3002 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging アサーションの以下のオプション プロパティをサポートしており、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の `ReliableMessagingBindingElement` でこれらのプロパティを制御できます。  
+  
+    -   `wsrm:InactivityTimeout`  
+  
+    -   `wsrm:AcknowledgementInterval`  
+  
+     例を次に示します。  
+  
+    ```  
+    <wsrm:RMAssertion>  
+      <wsrm:InactivityTimeout Milliseconds="600000" />  
+      <wsrm:AcknowledgementInterval Milliseconds="200" />  
+    </wsrm:RMAssertion>  
+    ```  
+  
+## WS\-ReliableMessaging のフロー制御拡張  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Reliable Messaging の機能拡張を使用して、シーケンス メッセージ フローのさらに厳密な制御を実現します。  
+  
+ フロー制御を有効にするには、`ReliableSessionBindingElement` の `FlowControlEnabled``bool` プロパティを `true` に設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   B4001 : 信頼できるメッセージング フロー制御を有効にした場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `SequenceAcknowledgement` ヘッダーの要素拡張に `netrm:BufferRemaining` 要素を生成します。  
+  
+-   B4002 : 信頼できるメッセージング フロー制御を有効にした場合、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では `netrm:BufferRemaining` 要素が `SequenceAcknowledgement` ヘッダーに存在する必要はありません。  
+  
+    ```  
+    <wsrm:SequenceAcknowledgement>  
+      <wsrm:Identifier>  
+        http://fabrikam123.com/abc  
+      </wsrm:Identifier>  
+      <wsrm:AcknowledgementRange Upper="1" Lower="1"/>             
+      <netrm:BufferRemaining>  
+        8  
+      </netrm:BufferRemaining>  
+    </wsrm:SequenceAcknowledgement>  
+  
+    ```  
+  
+-   B4003 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`netrm:BufferRemaining` を使用して、信頼できるメッセージングの送信先がバッファーに保持できる新しいメッセージの数を示します。  
+  
+-   B4004 :信頼できるメッセージングの送信先アプリケーションがメッセージを迅速に受信できない場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージング サービスは、送信するメッセージの数を抑制します。信頼できるメッセージングの送信先がメッセージをバッファーに保持する場合、要素の値が 0 になります。  
+  
+-   B4005 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、0 ～ 4096 の整数値の `netrm:BufferRemaining` を生成し、0 ～ 214748364 \(`xs:int` の `maxInclusive` 値\) の整数値を読み取ります。  
+  
+## メッセージ交換パターン  
+ ここでは、WS\-ReliableMessaging をさまざまなメッセージ交換パターンに使用する際の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作について説明します。各メッセージ交換パターンについて、次の 2 つの展開シナリオを考えます。  
+  
+-   アドレス不可能なイニシエーター : イニシエーターはファイアウォールの内側にあります。レスポンダーは HTTP 応答でのみイニシエーターにメッセージを配信できます。  
+  
+-   アドレス可能なイニシエーター : イニシエーターとレスポンダーの両方に HTTP 要求を送信できます。つまり、逆方向の 2 つの HTTP 接続を確立できます。  
+  
+### 一方向 : アドレス不可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、1 つの HTTP チャネルで 1 つのシーケンスを使用して、一方向メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用して RMS から RMD にすべてのメッセージを送信し、HTTP 応答を使用して RMD から RMS にすべてのメッセージを送信します。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オファーを含まない `CreateSequence` メッセージを生成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`CreateSequence` にオファーが含まれていないことを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequenceResponse` メッセージで `CreateSequence` 要求に応答します。  
+  
+#### SequenceAcknowledgement  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CreateSequence` メッセージとエラー メッセージを除くすべてのメッセージの応答で受信確認を処理します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンス メッセージと `AckRequested` メッセージの両方への応答として、常にスタンドアロンの受信確認を生成します。  
+  
+#### TerminateSequence メッセージ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`TerminateSequence` を一方向操作として処理します。つまり、HTTP 応答には、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+### 一方向 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信用 HTTP チャネルと送信用 HTTP チャネルで 1 つのシーケンスを使用して、一方向メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オファーを含まない `CreateSequence` メッセージを生成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`CreateSequence` にオファーが含まれていないことを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`ReplyTo` エンドポイント参照によってアドレス指定された HTTP 要求で `CreateSequenceResponse` メッセージを送信します。  
+  
+### 双方向 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信用 HTTP チャネルと送信用 HTTP チャネルで 2 つのシーケンスを使用して、完全に非同期の双方向メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オファーを含む `CreateSequence` メッセージを生成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`CreateSequence` にオファーが含まれていることを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CreateSequence` の `ReplyTo` エンドポイント参照にアドレス指定された HTTP 要求で `CreateSequenceResponse` を送信します。  
+  
+#### シーケンスの有効期間  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、2 つのシーケンスを 1 つの完全な双方向セッションとして処理します。  
+  
+ 一方のシーケンスをフォールトするエラーが生成されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、リモート エンドポイントに両方のシーケンスをフォールトするよう要求します。一方のシーケンスをフォールトするエラーを読み取ると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は両方のシーケンスをフォールトします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、送信シーケンスを終了し、受信シーケンスで引き続きメッセージを処理できます。逆に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信シーケンスの終了を処理し、送信シーケンスで引き続きメッセージを送信することもできます。  
+  
+### 要求\/応答 : アドレス不可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、1 つの HTTP チャネルで 2 つのシーケンスを使用して、一方向の要求\/応答メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用して要求シーケンスのメッセージを送信し、HTTP 応答を使用して応答シーケンスのメッセージを送信します。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オファーを含む `CreateSequence` メッセージを生成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`CreateSequence` にオファーが含まれていることを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequenceResponse` メッセージで `CreateSequence` 要求に応答します。  
+  
+#### 一方向のメッセージ  
+ 一方向メッセージ交換プロトコルを正常に完了するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で要求シーケンス メッセージを送信し、HTTP 応答でスタンドアロンの `SequenceAcknowledgement` メッセージを受信します。`SequenceAcknowledgement` は、送信されたメッセージの受信確認を行う必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、受信確認、エラー、または空の本文と HTTP 202 ステータス コードで要求に応答できます。  
+  
+#### 双方向のメッセージ  
+ 双方向メッセージ交換プロトコルを正常に完了するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で要求シーケンス メッセージを送信し、HTTP 応答で応答シーケンス メッセージを受信します。応答では、送信された要求シーケンス メッセージの受信確認を行う `SequenceAcknowledgement` を送信する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、アプリケーション応答、エラー、または空の本文と HTTP 202 ステータス コードで要求に応答できます。  
+  
+ 一方向のメッセージが存在することと、アプリケーション応答のタイミングもあるため、要求シーケンス メッセージのシーケンス番号と応答メッセージのシーケンス番号には相関関係はありません。  
+  
+#### 応答の再試行  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、双方向メッセージ交換プロトコルの相関関係について、HTTP 要求\/応答の相関関係に依存しています。このため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、要求シーケンス メッセージが受信確認されたときではなく、HTTP 応答によって受信確認、ユーザー メッセージ、またはエラーが送信されたときに、要求シーケンス メッセージの再試行を停止します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、応答が関連付けられている要求の HTTP 要求レッグで応答を再試行します。  
+  
+#### LastMessage の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求レッグで空の本文の最後のメッセージを生成し、送信します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は応答を要求しますが、実際の応答メッセージは無視します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、応答シーケンスの空の本文の最後のメッセージで、要求シーケンスの空の本文の最後のメッセージに応答します。  
+  
+ アクション URI が http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/rm\/LastMessage ではない最後のメッセージを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーが受信した場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は最後のメッセージで応答します。双方向メッセージ交換プロトコルの場合、最後のメッセージでアプリケーション メッセージが送信されます。一方向メッセージ交換プロトコルの場合、最後のメッセージは空です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、応答シーケンスの空の本文の最後のメッセージに対する受信確認を要求しません。  
+  
+#### TerminateSequence の交換  
+ すべての要求が有効な応答を受信すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求レッグで要求シーケンスの `TerminateSequence` メッセージを生成し、送信します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は応答を要求しますが、実際の応答メッセージは無視します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、応答シーケンスの `TerminateSequence` メッセージで、要求シーケンスの `TerminateSequence` メッセージに応答します。  
+  
+ 通常のシャットダウン シーケンスでは、両方の `TerminateSequence` メッセージで完全な `SequenceAcknowledgement` を送信します。  
+  
+### 要求\/応答 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信用 HTTP チャネルと送信用 HTTP チャネルで 2 つのシーケンスを使用して、要求\/応答メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オファーを含む `CreateSequence` メッセージを生成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`CreateSequence` にオファーが含まれていることを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CreateSequence` の `ReplyTo` エンドポイント参照にアドレス指定された HTTP 要求で `CreateSequenceResponse` を送信します。  
+  
+#### 要求\/応答の相関関係  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、すべてのアプリケーション要求メッセージに `MessageId` と `ReplyTo` エンドポイント参照が保持されていることを確認します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、各アプリケーション要求メッセージで、`CreateSequence` メッセージの `ReplyTo` エンドポイント参照を適用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、受信要求メッセージに `MessageId` と `ReplyTo` が保持されていることを要求します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequence` とすべてのアプリケーション要求メッセージのエンドポイント参照の URI が同一であることを確認します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-1.md b/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-1.md
new file mode 100644
index 00000000000..8aabb244294
--- /dev/null
+++ b/docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-1.md
@@ -0,0 +1,532 @@
+---
+title: "リライアブル メッセージング プロトコル バージョン 1.1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0da47b82-f8eb-42da-8bfe-e56ce7ba6f59
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# リライアブル メッセージング プロトコル バージョン 1.1
+ここでは、HTTP トランスポートを使用した相互運用に必要な WS\-ReliableMessaging 2007\/02 \(バージョン 1.1\) プロトコルに関する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 実装の詳細について説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ここに記載した制約と説明に基づく WS\-ReliableMessaging 仕様に従っています。WS\-ReliableMessaging バージョン 1.1 プロトコルは、[!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] 以降に実装されます。  
+  
+ WS\-ReliableMessaging 2007\/02 プロトコルは、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement> により [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に実装されます。  
+  
+ 便宜上、ここでは次のロールを使用します。  
+  
+-   イニシエーター : WS\-Reliable メッセージ シーケンスの作成を開始するクライアント。  
+  
+-   レスポンダー : イニシエーターの要求を受け取るサービス。  
+  
+ このドキュメントでは、次の表に示すプレフィックスと名前空間を使用します。  
+  
+|||  
+|-|-|  
+|プレフィックス|名前空間|  
+|wsrm|http:\/\/docs.oasis\-open.org\/ws\-rx\/wsrm\/200702|  
+|netrm|http:\/\/schemas.microsoft.com\/ws\/2006\/05\/rm|  
+|s|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|wsa|http:\/\/schemas.xmlsoap.org\/ws\/2005\/08\/addressing|  
+|wsse|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wssecurity\-secext\-1.0.xsd|  
+|wsrmp|http:\/\/docs.oasis\-open.org\/ws\-rx\/wsrmp\/200702|  
+|netrmp|http:\/\/schemas.microsoft.com\/ws\-rx\/wsrmp\/200702|  
+|wsp|\(WS\-Policy 1.2 または WS\-Policy 1.5 のいずれか\)|  
+  
+## メッセージング  
+  
+### シーケンスの作成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、信頼できるメッセージ シーケンスを確立するために、`CreateSequence` メッセージと `CreateSequenceResponse` メッセージを実装します。以下の制約が適用されます。  
+  
+-   B1101: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CreateSequence` メッセージの `ReplyTo`、`AcksTo`、および `Offer/Endpoint` と同じエンドポイント参照を使用します。  
+  
+-   R1102: `CreateSequence` メッセージの `AcksTo`、`ReplyTo`、および `Offer/Endpoint` の各エンドポイント参照には、オクテット単位で一致する同じ文字列表現のアドレス値が必要です。  
+  
+    -   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成する前に、`AcksTo`、`ReplyTo`、および `Endpoint` の各エンドポイント参照の URI 部分が同一であるかどうかを検証します。  
+  
+-   R1103: `CreateSequence` メッセージの `AcksTo`、`ReplyTo`、および `Offer/Endpoint` の各エンドポイント参照には、同一の参照パラメーターのセットが必要です。  
+  
+    -   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CreateSequence` の `AcksTo`、`ReplyTo`、および `Offer/Endpoint` エンドポイント参照の参照パラメーターが同一であることを強制しません。ただし、これらが同一であることを前提とした上で、`ReplyTo` エンドポイント参照からの参照パラメーターを受信確認と逆方向シーケンス メッセージに使用します。  
+  
+-   B1104: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CreateSequence` メッセージでオプションの `Expires` 要素または `Offer/Expires` 要素を生成しません。  
+  
+-   B1105: `CreateSequence` メッセージにアクセスする場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequence` 要素の `Expires` 値を `CreateSequenceResponse` 要素の `Expires` 値として使用します。それ以外の場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは `Expires` 値および `Offer/Expires` 値を読み込んで無視します。  
+  
+-   B1106: `CreateSequenceResponse` メッセージにアクセスする場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、オプションの `Expires` 値を読み込みますが、使用しません。  
+  
+-   B1107: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターおよびレスポンダーは、`CreateSequence/Offer` 要素および `CreateSequenceResponse` 要素にオプションの `IncompleteSequenceBehavior` 要素を必ず生成します。  
+  
+-   B1108: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`IncompleteSequenceBehavior` 要素にある `DiscardFollowingFirstGap` 値および `NoDiscard` 値のみ使用します。  
+  
+    -   WS\-ReliableMessaging では、セッションを形成する、相関する 2 つの逆方向シーケンスを確立するために、`Offer` 機構を利用しています。  
+  
+-   B1109: `CreateSequence` に `Offer` 要素が格納されている場合、一方向 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`Accept` 要素なしに `CreateSequenceResponse` で応答することにより、用意されたシーケンスを拒否します。  
+  
+-   B1110: 信頼できるメッセージング レスポンダーが用意されたシーケンスを拒否する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは新しく確立されたシーケンスをエラーとします。  
+  
+-   B1111: `CreateSequence` に `Offer` 要素が格納されていない場合、双方向 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequenceRefused` フォールトで応答することにより用意されたシーケンスを拒否します。  
+  
+-   R1112: 2 つの逆方向シーケンスが `Offer` 機構を使用して確立された場合、`CreateSequenceResponse/Accept/AcksTo` エンドポイント参照の `[address]` プロパティは、バイト単位で `CreateSequence` メッセージの送信先 URI と一致する必要があります。  
+  
+-   R1113: 2 つの逆方向シーケンスが `Offer` 機構を使用して確立された場合、イニシエーターからレスポンダーに流れる両方のシーケンスにあるすべてのメッセージは、同じエンドポイント参照に送信される必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging を使用して、イニシエーターとレスポンダー間で信頼できるセッションを確立します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WS\-ReliableMessaging 実装により、一方向、要求\/応答、双方向の各メッセージ パターンの信頼できるセッションが実現します。`CreateSequence` および `CreateSequenceResponse` で WS\-ReliableMessaging の `Offer` 機構を使用すると、相関する 2 つの逆方向シーケンスを確立できます。また、Offer 機構は、すべてのメッセージ エンドポイントに適したセッション プロトコルを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、セッション整合性を保つためのエンドツーエンドの保護を含むこのようなセッションに対してセキュリティが保証されているため、同じパーティを対象とするメッセージが同じ送信先に到着することが事実上保証されます。また、これにより、アプリケーション メッセージにシーケンス受信確認を抱き合わせることができます。したがって、制約 R1102、R1112、および R1113 が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用されています。  
+  
+ `CreateSequence` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequence</wsa:Action>  
+    <wsa:MessageID>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:MessageID>  
+    <wsa:ReplyTo>  
+        <wsa:Address>http://Business456.com/clientA</wsa:Address>   
+    </wsa:ReplyTo>  
+    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:CreateSequence>  
+      <wsrm:AcksTo>  
+        <wsa:Address>http://Business456.com/clientA</wsa:Address>  
+      </wsrm:AcksTo>  
+      <wsrm:Offer>  
+        <wsrm:Identifier>urn:uuid:066b4730-fc82-458a-a5c1-210be4fb4e4e</wsrm:Identifier>  
+        <wsrm:Endpoint>  
+          <wsa:Address>http://Business456.com/clientA</wsa:Address>  
+        </wsrm:Endpoint>  
+        <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>  
+      </wsrm:Offer>  
+    </wsrm:CreateSequence>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+ `CreateSequenceResponse` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CreateSequenceResponse</wsa:Action>  
+    <wsa:RelatesTo>urn:uuid:949cca61-8813-42ff-ab33-18d9e3fa82fa</wsa:RelatesTo>  
+    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:CreateSequenceResponse>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:IncompleteSequenceBehavior>DiscardFollowingFirstGap</wsrm:IncompleteSequenceBehavior>  
+      <wsrm:Accept>  
+        <wsrm:AcksTo>  
+          <wsa:Address>http://BusinessABC.com/serviceA</wsa:Address>  
+        </wsrm:AcksTo>  
+      </wsrm:Accept>  
+    </wsrm:CreateSequenceResponse>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### シーケンスを閉じる  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、信頼できるメッセージの送信元が開始するシャットダウンに `CloseSequence` メッセージおよび `CloseSequenceResponse` メッセージを使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信先はシャットダウンを開始せず、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージング送信元は、信頼できるメッセージの送信先が開始するシャットダウンをサポートしません。以下の制約が適用されます。  
+  
+-   B1201: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信元は、シーケンスをシャットダウンする場合に、常に `CloseSequence` メッセージを送信します。  
+  
+-   B1202: 信頼できるメッセージの送信元は、`CloseSequence` メッセージを送信する前に、すべてのシーケンス メッセージの受信確認を待機します。  
+  
+-   B1203: 信頼できるメッセージの送信元は、シーケンスにメッセージが含まれない場合を除き、常にオプションの `LastMsgNumber` 要素を含めます。  
+  
+-   R1204: 信頼できるメッセージの送信先は、`CloseSequence` メッセージを送信してシャットダウンを開始することはできません。  
+  
+-   B1205: `CloseSequence` メッセージを受け取ると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信元はシーケンスが不完全と見なし、エラーを送信します。  
+  
+ `CloseSequence` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequence</wsa:Action>  
+    <wsa:MessageID>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:MessageID>  
+    <wsa:ReplyTo>  
+      <wsa:Address>http://Business456.com/clientA</wsa:Address>  
+    </wsa:ReplyTo>  
+    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:CloseSequence>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>  
+    </wsrm:CloseSequence>  
+  </s:Body>  
+</s:Envelope>  
+Example CloseSequenceResponse message:  
+<s:Envelope>  
+  <s:Header>  
+    <wsrm:SequenceAcknowledgement>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>  
+      <wsrm:Final></wsrm:Final>  
+      <netrm:BufferRemaining>8</netrm:BufferRemaining>  
+    </wsrm:SequenceAcknowledgement>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/CloseSequenceResponse</wsa:Action>  
+    <wsa:RelatesTo>urn:uuid:6ce1d4c3-e1c1-474f-a8c9-4210e37f7877</wsa:RelatesTo>  
+    <wsa:To s:mustUnderstand="1">http://Business456.com/clientA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:CloseSequenceResponse>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+    </wsrm:CloseSequenceResponse>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### シーケンスの終了  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`CloseSequence/CloseSequenceResponse` ハンドシェイクを完了した後、`TerminateSequence/TerminateSequenceResponse` ハンドシェイクを主に使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信先は終了を開始せず、信頼できるメッセージの送信元は、信頼できるメッセージの送信先が開始する終了をサポートしません。以下の制約が適用されます。  
+  
+-   B1301: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CloseSequence/CloseSequenceResponse` ハンドシェイクが正常に完了した後にのみ、`TerminateSequence` メッセージを送信します。  
+  
+-   R1302: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`LastMsgNumber` 要素が、各シーケンスのすべての `CloseSequence` メッセージおよび `TerminateSequence` メッセージに対し一貫性があることを検証します。つまり、`LastMsgNumber` は、すべての `CloseSequence` メッセージおよび `TerminateSequence` メッセージに存在しないか、すべての `CloseSequence` メッセージおよび `TerminateSequence` メッセージに存在し、同一であるかのいずれかです。  
+  
+-   B1303: `CloseSequence/CloseSequenceResponse` ハンドシェイクの後、`TerminateSequence` メッセージを受け取ると、信頼できるメッセージの送信先が `TerminateSequenceResponse` メッセージで応答します。信頼できるメッセージの配信元は、`TerminateSequence` メッセージを送信する前に最終受信確認を受けるため、信頼できるメッセージの送信先ではシーケンスが終了したことが確実にわかり、すぐにリソースを再要求します。  
+  
+-   B1304: `CloseSequence/CloseSequenceResponse` ハンドシェイクの前に、`TerminateSequence` メッセージを受け取ると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信先が `TerminateSequenceResponse` メッセージで応答します。信頼できるメッセージの送信先でシーケンスが一貫していると判断した場合、信頼できるメッセージの送信先は、リソースを再要求する前にアプリケーションの送信先で指定された時間待機し、クライアントが最終受信確認を受け取ることができるようにします。それ以外の場合は、信頼できるメッセージの送信先はすぐにリソースを再要求し、`Faulted` イベントを発生させて、不明なシーケンスの終了をアプリケーションの送信先に示します。  
+  
+ `TerminateSequence` メッセージの例を次に示します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequence</wsa:Action>  
+    <wsa:MessageID>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:MessageID>  
+    <wsa:ReplyTo>  
+      <wsa:Address>http://Business456.com/clientA</wsa:Address>  
+    </wsa:ReplyTo>  
+    <wsa:To s:mustUnderstand="1">http://BusinessABC.com/serviceA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:TerminateSequence>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:LastMsgNumber>30</wsrm:LastMsgNumber>  
+      </wsrm:TerminateSequence>  
+  </s:Body>  
+</s:Envelope>  
+Example TerminateSequenceResponse message:  
+<s:Envelope>  
+  <s:Header>  
+    <wsrm:SequenceAcknowledgement>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:AcknowledgementRange Lower="1" Upper="30"></wsrm:AcknowledgementRange>  
+      <wsrm:Final></wsrm:Final>  
+      <netrm:BufferRemaining>8</netrm:BufferRemaining>  
+    </wsrm:SequenceAcknowledgement>  
+    <wsa:Action s:mustUnderstand="1">http://docs.oasis-open.org/ws-rx/wsrm/200702/TerminateSequenceResponse</wsa:Action>  
+    <wsa:RelatesTo>urn:uuid:3597a398-4f3c-40f4-9335-8f1515572fdf</wsa:RelatesTo>  
+    <wsa:To s:mustUnderstand="1">://Business456.com/clientA</wsa:To>  
+  </s:Header>  
+  <s:Body>  
+    <wsrm:TerminateSequenceResponse>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+    </wsrm:TerminateSequenceResponse>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### シーケンス  
+ シーケンスに適用される制約を以下に示します。  
+  
+-   B1401:[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`xs:long` の最大値 \(9223372036854775807\) 以下のシーケンス番号を生成し、これらの番号にアクセスします。  
+  
+ `Sequence` ヘッダーの例を次に示します。  
+  
+```  
+<wsrm:Sequence s:mustUnderstand="1">  
+  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+  <wsrm:MessageNumber>1</wsrm:MessageNumber>  
+</wsrm:Sequence>  
+```  
+  
+### 受信確認の要求  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Keep\-alive 機構として `AckRequested` ヘッダーを使用します。  
+  
+ `AckRequested` ヘッダーの例を次に示します。  
+  
+```  
+<wsrm:AckRequested>  
+  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+</wsrm:AckRequested>  
+```  
+  
+### SequenceAcknowledgement  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging で用意されているシーケンス受信確認の抱き合わせ機構を使用します。以下の制約が適用されます。  
+  
+-   R1601: `Offer` 機構を使用して 2 つの逆方向シーケンスを確立した場合、目的の受信者に送信されるアプリケーション メッセージに、`SequenceAcknowledgement` ヘッダーを含めることができます。リモートのエンドポイントは、追加された `SequenceAcknowledgement` ヘッダーにアクセスできる必要があります。  
+  
+-   B1602 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`Nack` 要素を含む `SequenceAcknowledgement` ヘッダーは生成しません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、各 `Nack` 要素にシーケンス番号が格納されていることを検証しますが、シーケンス番号が格納されていない場合は、`Nack` 要素および値を無視します。  
+  
+ `SequenceAcknowledgement` ヘッダーの例を次に示します。  
+  
+```  
+<wsrm:SequenceAcknowledgement>  
+  <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+  <wsrm:AcknowledgementRange Lower="1" Upper="1"></wsrm:AcknowledgementRange>  
+</wsrm:SequenceAcknowledgement>  
+```  
+  
+### WS\-ReliableMessaging エラー  
+ WS\-ReliableMessaging エラーの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装に適用される制約を以下に示します。以下の制約が適用されます。  
+  
+-   B1701: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`MessageNumberRollover` エラーを生成しません。  
+  
+-   B1702: SOAP 1.2 では、サービス エンドポイントが接続制限に達し、新しい接続を処理できない場合、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は入れ子にした `CreateSequenceRefused` エラー サブコード `netrm:ConnectionLimitReached` を生成します。  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <wsa:Action>http://docs.oasis-open.org/ws-rx/wsrm/200702/fault</wsa:Action>  
+  </s:Header>  
+  <s:Body>  
+    <s:Fault>  
+      <s:Code>  
+        <s:Value>s:Receiver</s:Value>  
+        <s:Subcode>  
+          <s:Value>wsrm:CreateSequenceRefused</s:Value>  
+          <s:Subcode>  
+            <s:Value>netrm:ConnectionLimitReached</s:Value>  
+          </s:Subcode>  
+        </s:Subcode>  
+      </s:Code>  
+      <s:Reason>  
+        <s:Text xml:lang="en">Server 'http://BusinessABC.com/serviceA' is too busy to process this request. Try again later.</s:Text>  
+      </s:Reason>  
+    </s:Fault>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### WS\-Addressing エラー  
+ WS\-ReliableMessaging は WS\-Addressing を使用するため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の WS\-ReliableMessaging 実装は、WS\-Addressing エラーを生成して送信できます。ここでは、WS\-ReliableMessaging レイヤーで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が明示的に生成および送信する WS\-Addressing エラーについて説明します。  
+  
+-   B1801:次のいずれかに該当する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `Message Addressing Header Required` エラーを生成して送信します。  
+  
+    -   `CreateSequence`、`CloseSequence`、または `TerminateSequence` メッセージに `MessageId` ヘッダーがない。  
+  
+    -   `CreateSequence`、`CloseSequence`、または `TerminateSequence` メッセージに `ReplyTo` ヘッダーがない。  
+  
+    -   `CreateSequenceResponse`、`CloseSequenceResponse`、または `TerminateSequenceResponse` メッセージに `RelatesTo` ヘッダーがない。  
+  
+-   B1802:[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`Endpoint Unavailable` エラーを生成して送信し、`CreateSequence` メッセージにあるアドレス指定ヘッダーのチェックに基づき、シーケンスを処理できるリッスン中のエンドポイントがないことを示します。  
+  
+## プロトコル コンポジション  
+  
+### WS\-Addressing によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Addressing の 2 つのバージョンをサポートしています。WS\-Addressing 2004\/08 \(\[WS\-ADDR\]\) と、W3C WS\-Addressing 1.0 Recommendation \(\[WS\-ADDR\-CORE\] および \[WS\-ADDR\-SOAP\]\) です。  
+  
+ WS\-ReliableMessaging 仕様に記載されているのは、WS\-Addressing 2004\/08 だけですが、使用する WS\-Addressing のバージョンが制限されているわけではありません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   R2101: WS\-Addressing 2004\/08 と WS\-Addressing 1.0 の両方を WS\-ReliableMessaging で使用できます。  
+  
+-   R2102: 特定の WS\-ReliableMessaging シーケンス、または `Offer` 機構を使用して関連付けられた逆方向シーケンスのペアでは、同じバージョンの WS\-Addressing を使用する必要があります。  
+  
+### SOAP によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-ReliableMessaging で SOAP 1.1 と SOAP 1.2 の両方を使用できます。  
+  
+### WS\-Security と WS\-SecureConversation によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティで保護されたトランスポート \(HTTPS\)、WS\-Security によるコンポジション、および WS\-SecureConversation によるコンポジションを使用して、WS\-ReliableMessaging シーケンスを保護します。WS\-ReliableMessaging 1.1 プロトコル、WS\-Security 1.1、および WS\-Secure Conversation 1.3 プロトコルは一緒に使う必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   R2301: 個々のメッセージの整合性と機密性だけでなく、WS\-ReliableMessaging シーケンスの整合性を保護するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では WS\-SecureConversation を使用する必要があります。  
+  
+-   R2302:WS\-ReliableMessaging シーケンスを確立する前に、WS\-SecureConversation セッションを確立する必要があります。  
+  
+-   R2303: WS\-ReliableMessaging シーケンスの有効期間が WS\-SecureConversation セッションの有効期間よりも長い場合は、対応する WS\-SecureConversation Renewal バインディングを使用して、WS\-SecureConversation によって確立された `SecurityContextToken` を更新する必要があります。  
+  
+-   B2304:WS\-ReliableMessaging シーケンスまたは相関する逆方向シーケンスのペアは、必ず同じ WS\-SecureConversation セッションにバインドされます。  
+  
+-   R2305: WS\-SecureConversation を使用して構成した場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーでは、`CreateSequence` メッセージに `wsse:SecurityTokenReference` 要素および `wsrm:UsesSequenceSTR` ヘッダーが含まれていることが必要です。  
+  
+ `UsesSequenceSTR` ヘッダーの例を次に示します。  
+  
+```  
+<wsrm:UsesSequenceSTR></wsrm:UsesSequenceSTR>  
+```  
+  
+### SSL\/TLS セッションによるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、次のようにSSL\/TLS セッションによるコンポジションをサポートしていません。  
+  
+-   B2401: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsrm:UsesSequenceSSL` ヘッダーを生成しません。  
+  
+-   R2402: 信頼できるメッセージのイニシエーターは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーに `wsrm:UsesSequenceSSL` ヘッダーが付いた `CreateSequence` メッセージを送信できません。  
+  
+### WS\-Policy によるコンポジション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-Policy 1.2 および WS\-Policy 1.5 の 2 つのバージョンの WS\-Policy をサポートしています。  
+  
+## WS\-ReliableMessaging の WS\-Policy アサーション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging の `wsrm:RMAssertion` WS\-Policy アサーションを使用して、エンドポイントの機能を記述します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   B3001: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsrmn:RMAssertion` WS\-Policy アサーションを `wsdl:binding` 要素に添付します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsdl:binding` 要素および `wsdl:port` 要素への添付をサポートしています。  
+  
+-   B3002: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsp:Optional` タグを生成しません。  
+  
+-   B3003: `wsrmp:RMAssertion` WS\-Policy アサーションにアクセスする場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `wsp:Optional` タグを無視し、WS\-RM ポリシーを必須のポリシーとして使用します。  
+  
+-   R3004: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は SSL\/TLS セッションで構成できないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `wsrmp:SequenceTransportSecurity` を指定するポリシーを受け付けません。  
+  
+-   B3005: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、常に `wsrmp:DeliveryAssurance` 要素を生成します。  
+  
+-   B3006: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は常に `wsrmp:ExactlyOnce` 配信保証を指定します。  
+  
+-   B3007: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging アサーションの以下のプロパティを生成して読み込み、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の `ReliableSessionBindingElement` でこれらのプロパティを制御します。  
+  
+    -   `netrmp:InactivityTimeout`  
+  
+    -   `netrmp:AcknowledgementInterval`  
+  
+     `RMAssertion` の例を次に示します。  
+  
+    ```  
+    <wsrmp:RMAssertion>  
+      <wsp:Policy>  
+        <wsrmp:SequenceSTR/>  
+        <wsrmp:DeliveryAssurance>  
+          <wsp:Policy>  
+            <wsrmp:ExactlyOnce/>  
+            <wsrmp:InOrder/>  
+          </wsp:Policy>  
+        </wsrmp:DeliveryAssurance>  
+      </wsp:Policy>  
+      <netrmp:InactivityTimeout Milliseconds="600000"/>  
+      <netrmp:AcknowledgementInterval Milliseconds="200"/>  
+    </wsrmp:RMAssertion>  
+    ```  
+  
+## WS\-ReliableMessaging のフロー制御拡張  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-ReliableMessaging の機能拡張を使用して、シーケンス メッセージ フローのさらに厳密な制御を実現します。  
+  
+ フロー制御を有効にするには、`ReliableSessionBindingElement` の `FlowControlEnabled``boolean` プロパティを `true` に設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に適用される制約を以下に示します。  
+  
+-   B4001: 信頼できるメッセージング フロー制御を有効にした場合、次の例に示すように、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `SequenceAcknowledgement` ヘッダーの要素拡張で `netrm:BufferRemaining` 要素を生成します。  
+  
+    ```  
+    <wsrm:SequenceAcknowledgement>  
+      <wsrm:Identifier>urn:uuid:656652b8-9af2-4e94-9d07-2dc21c05ed27</wsrm:Identifier>  
+      <wsrm:AcknowledgementRange Upper="1" Lower="1"/>             
+      <netrm:BufferRemaining>8</netrm:BufferRemaining>  
+    </wsrm:SequenceAcknowledgement>  
+    ```  
+  
+-   B4002: 信頼できるメッセージング フロー制御を有効にした場合でも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では `SequenceAcknowledgement` ヘッダーに `netrm:BufferRemaining` 要素は必要ありません。  
+  
+-   B4003: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージの送信先は、`netrm:BufferRemaining` を使用して、バッファーに保持できる新しいメッセージの数を示します。  
+  
+-   B4004:信頼できるメッセージング フロー制御を有効にした場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるメッセージング送信元は `netrm:BufferRemaining` の値を使用してメッセージの転送を調整します。  
+  
+-   B4005 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、0 ～ 4096 の整数値の `netrm:BufferRemaining` を生成し、0 ～ 214748364 \(`xs:int` の `maxInclusive` 値\) の整数値を読み取ります。  
+  
+## メッセージ交換パターン  
+ ここでは、WS\-ReliableMessaging をさまざまなメッセージ交換パターンに使用する際の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作について説明します。各メッセージ交換パターンについて、次の 2 つの展開シナリオを考えます。  
+  
+-   アドレス不可能なイニシエーター : イニシエーターはファイアウォールの内側にあります。レスポンダーは HTTP 応答でのみイニシエーターにメッセージを配信できます。  
+  
+-   アドレス可能なイニシエーター : イニシエーターとレスポンダーの両方に HTTP 要求を送信できます。つまり、逆方向の 2 つの HTTP 接続を確立できます。  
+  
+### 一方向 : アドレス不可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、1 つの HTTP チャネルで 1 つのシーケンスを使用して、一方向メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してイニシエーターからレスポンダーにすべてのメッセージを送信し、HTTP 応答を使用してレスポンダーからイニシエーターにすべてのメッセージを送信します。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `Offer` 要素のない `CreateSequence` メッセージを転送し、HTTP 応答で `CreateSequenceResponse` メッセージを待機します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成し、HTTP 応答で `Accept` 要素のない `CreateSequenceResponse` メッセージを転送します。  
+  
+#### SequenceAcknowledgement  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CreateSequence` メッセージとエラー メッセージを除くすべてのメッセージの応答で受信確認を処理します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、すべてのシーケンス メッセージと `AckRequested` メッセージへの HTTP 応答として、必ずスタンドアロンの受信確認を転送します。  
+  
+#### CloseSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `CloseSequence` メッセージを転送し、HTTP 応答で `CreateSequenceResponse` メッセージを待機します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、HTTP 応答で `CloseSequenceResponse` メッセージを転送します。  
+  
+#### TerminateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `TerminateSequence` メッセージを転送し、HTTP 応答で `TerminateSequenceResponse` メッセージを待機します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、HTTP 応答で `TerminateSequenceResponse` メッセージを転送します。  
+  
+### 一方向 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、受信用 HTTP チャネルと送信用 HTTP チャネルで 1 つのシーケンスを使用する、一方向メッセージ交換パターンが用意されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `Offer` 要素のない `CreateSequence` メッセージを転送します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成し、HTTP 要求で `Accept` 要素のない `CreateSequenceResponse` メッセージを転送します。  
+  
+### 双方向 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、受信用 HTTP チャネルと送信用 HTTP チャネルで 2 つのシーケンスを使用する、完全に非同期の双方向メッセージ交換パターンが用意されています。このメッセージ交換パターンは、限定された方法で `Request/Reply`、`Addressable` イニシエーター メッセージ交換パターンに組み込むことができます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `Offer` 要素のある `CreateSequence` メッセージを転送します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequence` に `Offer` 要素があることを確認し、シーケンスを作成して `Accept` 要素のない `CreateSequenceResponse` メッセージを転送します。  
+  
+#### シーケンスの有効期間  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、2 つのシーケンスを 1 つの完全な双方向セッションとして処理します。  
+  
+ 一方のシーケンスをフォールトするエラーが生成されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、リモート エンドポイントに両方のシーケンスをフォールトするよう要求します。一方のシーケンスをフォールトするエラーを読み取ると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は両方のシーケンスをフォールトします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、送信シーケンスを終了し、受信シーケンスで引き続きメッセージを処理できます。逆に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信シーケンスの終了を処理し、送信シーケンスで引き続きメッセージを送信することもできます。  
+  
+### 要求\/応答および一方向のアドレス不可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、1 つの HTTP チャネルで 2 つのシーケンスを使用して、一方向の要求\/応答メッセージ交換パターンを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してイニシエーターからレスポンダーにすべてのメッセージを送信し、HTTP 応答を使用してレスポンダーからイニシエーターにすべてのメッセージを送信します。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `Offer` 要素がある `CreateSequence` メッセージを転送し、HTTP 応答で `CreateSequenceResponse` メッセージを待機します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、シーケンスを作成し、HTTP 応答で `Accept` 要素がある `CreateSequenceResponse` メッセージを転送します。  
+  
+#### 一方向のメッセージ  
+ 一方向メッセージ交換を正常に完了するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で要求シーケンス メッセージを送信し、HTTP 応答でスタンドアロンの `SequenceAcknowledgement` メッセージを受信します。`SequenceAcknowledgement` は、送信されたメッセージの受信確認を行う必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、受信確認、エラー、または空の本文と HTTP 202 ステータス コードによる応答で要求に応答します。  
+  
+#### 双方向のメッセージ  
+ 双方向メッセージ交換プロトコルを正常に完了するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で要求シーケンス メッセージを送信し、HTTP 応答で応答シーケンス メッセージを受信します。応答では、送信された要求シーケンス メッセージの受信確認を行う `SequenceAcknowledgement` を送信する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、アプリケーション応答、エラー、または空の本文と HTTP 202 ステータス コードで要求に応答できます。  
+  
+ 一方向のメッセージが存在することと、アプリケーション応答のタイミングもあるため、要求シーケンス メッセージのシーケンス番号と応答メッセージのシーケンス番号には相関関係はありません。  
+  
+#### 応答の再試行  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、双方向メッセージ交換プロトコルの相関関係について、HTTP 要求\/応答の相関関係に依存しています。このため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、要求シーケンス メッセージが受信確認されたときではなく、HTTP 応答によって `SequenceAcknowledgement`、アプリケーション応答、またはエラーが送信されたときに、要求シーケンス メッセージの再試行を停止します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、応答が関連付けられている要求の HTTP 要求で応答を再試行します。  
+  
+#### CloseSequence の交換  
+ すべての一方向の要求シーケンス メッセージが、すべての応答シーケンス メッセージおよび受信確認を受信した後、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で要求シーケンスに `CloseSequence` メッセージを転送し、HTTP 応答で `CloseSequenceResponse` を待機します。  
+  
+ 要求シーケンスを終了すると、暗黙的に応答シーケンスが終了します。つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`CloseSequence` メッセージに応答シーケンスの最終的な `SequenceAcknowledgement` を含め、応答シーケンスには `CloseSequence` 交換がありません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、すべての応答が受信確認されたことを確認し、HTTP 応答で `CloseSequenceResponse` メッセージを転送します。  
+  
+#### TerminateSequence の交換  
+ `CloseSequenceResponse` メッセージを受け取った後、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは HTTP 要求で要求シーケンスに `TerminateSequence` メッセージを転送し、HTTP 応答で `TerminateSequenceResponse` を待機します。  
+  
+ `CloseSequence` 交換と同じように、要求シーケンスを終了すると、暗黙的に応答シーケンスが終了します。つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、`TerminateSequence` メッセージに応答シーケンスの最終的な `SequenceAcknowledgement` を含め、応答シーケンスには `TerminateSequence` 交換がありません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、HTTP 応答で `TerminateSequenceResponse` メッセージを転送します。  
+  
+### 要求\/応答 : アドレス可能なイニシエーター  
+  
+#### バインディング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、受信用 HTTP チャネルと送信用 HTTP チャネルで 2 つのシーケンスを使用する、要求\/応答メッセージ交換パターンが用意されています。このメッセージ交換パターンは、限定された方法で `Duplex, Addressable` イニシエーター メッセージ交換パターンに組み込むことができます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTP 要求を使用してすべてのメッセージを送信します。すべての HTTP 応答に、空の本文と HTTP 202 ステータス コードが含まれます。  
+  
+#### CreateSequence の交換  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] イニシエーターは、HTTP 要求で `Offer` 要素のある `CreateSequence` メッセージを転送します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] レスポンダーは、`CreateSequence` に `Offer` 要素があることを確認し、シーケンスを作成して `Accept` 要素がある `CreateSequenceResponse` メッセージを転送します。  
+  
+#### 要求\/応答の相関関係  
+ 次の状況は、すべての相関関係にある要求\/応答で発生します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、すべてのアプリケーション要求メッセージに `ReplyTo` エンドポイント参照と `MessageId` が保持されていることを確認します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、各アプリケーション要求メッセージの `ReplyTo` としてローカル エンドポイント参照を適用します。ローカル エンドポイント参照は、イニシエーターの `CreateSequence` メッセージの `ReplyTo` であり、レスポンダーの `CreateSequence` メッセージの `To` です。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、受信要求メッセージに `MessageId` と `ReplyTo` が保持されていることを確認します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、すべてのアプリケーション要求メッセージの `ReplyTo` エンドポイント参照の URI が、先に定義したローカル エンドポイント参照と一致していることを確認します。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、`wsa` 要求\/応答の相関ルールに従い、すべての応答に正しい `RelatesTo` ヘッダーおよび `To` ヘッダーが保持されていることを確認します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/reliable-sessions-overview.md b/docs/framework/wcf/feature-details/reliable-sessions-overview.md
new file mode 100644
index 00000000000..63d38d9f042
--- /dev/null
+++ b/docs/framework/wcf/feature-details/reliable-sessions-overview.md
@@ -0,0 +1,132 @@
+---
+title: "信頼できるセッションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: a7fc4146-ee2c-444c-82d4-ef6faffccc2d
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# 信頼できるセッションの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の SOAP リライアブル メッセージ機能では、SOAP エンドポイント間でエンドツーエンドのメッセージ転送に信頼性が提供されます。これにより、信頼性の低いネットワーク上でも、トランスポート エラーや SOAP メッセージ レベルのエラーに対処できます。具体的には、SOAP またはトランスポート中継局を経由して送信されるメッセージに関して、1 回だけの配信や \(オプションで\) 順序保証の配信がセッション ベースで提供されます。セッション ベースの配信では、セッション中のメッセージがグループ化され、オプションでメッセージの順序保証が適用されます。  
+  
+ ここでは、信頼できるセッションについての概要、使用方法と使用する状況、およびこれをセキュリティで保護する方法について説明します。  
+  
+## WCF の信頼できるセッション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるセッションは、WS\-ReliableMessaging プロトコルの定義に準拠した SOAP リライアブル メッセージ機能の実装です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の SOAP リライアブル メッセージ機能は、メッセージング エンドポイントを分離する中継局の数や種類に関係なく、2 つのエンドポイント間でエンドツーエンドの信頼できるセッションを実現します。これには SOAP を使用しないトランスポート手段 \(HTTP プロキシなど\)、またはエンドポイント間でメッセージをやりとりする場合に必要となる SOAP を使用する手段 \(SOAP ベースのルーターやブリッジなど\) が含まれます。信頼できるセッション チャネルでは "インタラクティブな" 通信がサポートされるので、これらのチャネルによって接続されている複数のサービスを同時に実行したり、短い待ち時間 \(比較的短い間隔\) でメッセージを処理することができます。つまりこれらのコンポーネントは同時に進行または失敗するので、コンポーネント間の分離は提供されません。  
+  
+ 信頼できるセッションでは次の 2 種類のエラーがマスクされます。  
+  
+-   SOAP メッセージ レベルのエラー \(メッセージの喪失または重複、および送信順序と異なる順序で到着するメッセージを含む\)  
+  
+-   トランスポート エラー  
+  
+ 信頼できるセッションは、WS\-ReliableMessaging プロトコルとメモリ内転送ウィンドウを実装することにより、トランスポート エラーが発生した場合に SOAP メッセージ レベルのエラーをマスクし、接続を再確立します。  
+  
+ 信頼できるセッションは、TCP が IP パケットに提供する信頼性を SOAP メッセージに提供します。TCP ソケット接続では、ノード間で IP パケットが 1 回のみ、正しい順序で転送されます。信頼できるチャネルでも、これと同じタイプの信頼できる転送が提供されますが、次の点で TCP ソケットの信頼性とは異なります。  
+  
+-   信頼性は、任意のサイズのバイト パケットに対してではなく、SOAP メッセージ レベルで提供されます。  
+  
+-   信頼性は、TCP を経由する転送に対してだけでなく、トランスポート中立の形で提供されます。  
+  
+-   信頼性は、特定のトランスポート セッション \(たとえば、TCP 接続によって提供されるセッション\) に関連付けられておらず、信頼できるセッションの有効期間中、複数のトランスポート セッションを同時にまたは連続して使用できます。  
+  
+-   信頼できるセッションは、送信側と受信側の SOAP エンドポイント間の接続に必要なトランスポート接続の数に関係なく、両者の間で提供されます。つまり、TCP の信頼性はトランスポート接続が終了した時点で終わるのに対し、信頼できるセッションではエンドツーエンドの信頼性が提供されます。  
+  
+## 信頼できるセッションとバインディング  
+ 前述のように、信頼できるセッションはトランスポート中立なので、多数のトランスポート上で実装できます。また、信頼できるセッションは、要求\/応答や双方向など複数のメッセージ交換パターンで確立できます。このため [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるセッションは、一連のバインディングに対するプロパティの 1 つとして公開されています。  
+  
+ 信頼できるセッションは、次のバインディングを使用するエンドポイントで使用できます。  
+  
+-   HTTP ベース トランスポートの標準バインディング  
+  
+    -   `WsHttpBinding` : 要求\/応答または一方向のコントラクトを公開します。  
+  
+    -   要求\/応答または一方向のサービス コントラクトで信頼できるセッションを使用しているときに使用できます。  
+  
+    -   `WsDualHttpBinding` : 双方向、要求\/応答、または一方向のコントラクトを公開します。  
+  
+    -   `WsFederationHttpBinding` : 要求\/応答または一方向のコントラクトを公開します。  
+  
+-   TCP ベース トランスポートの標準バインディング  
+  
+    -   `NetTcpBinding` : 双方向、要求\/応答、または一方向のコントラクトを公開します。  
+  
+ 信頼できるセッションは、HTTPS \(問題点の詳細については、後述の「信頼できるセッションとセキュリティ」を参照\) や名前付きパイプ バインディングなどのカスタム バインディングを作成することによって、他のバインディングでも使用できます。  
+  
+ 信頼できるセッションは、多様な種類のチャネルに重ねることができ、その結果形成された信頼できるセッションのチャネル形状はそれぞれ異なります。クライアントとサーバーの両方でサポートされる、信頼できるセッション チャネルの種類は、使用される土台のチャネルの種類によって異なります。次の表では、基になるチャネルの種類ごとに、クライアントでサポートされるセッション チャネルの種類を示します。  
+  
+|サポートされる信頼できるセッション チャネルの種類 \(基になるチャネルの種類でサポートされる `TChannel` の値\)|`IRequestChannel`|`IRequestSessionChannel`|`IDuplexChannel`|`IDuplexSessionChannel`|  
+|---------------------------------------------------------------------|-----------------------|------------------------------|----------------------|-----------------------------|  
+|`IOutputSessionChannel`|○|○|○|○|  
+|`IRequestSessionChannel`|○|○|×|×|  
+|`IDuplexSessionChannel`|×|×|○|○|  
+  
+ サポートされるチャネルの種類は、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement.BuildChannelFactory%60%601%28System.ServiceModel.Channels.BindingContext%29> メソッドに渡されるジェネリック パラメーター `TChannel` に使用できる値です。  
+  
+ 次の表では、基になるチャネルの種類ごとに、サーバーでサポートされるセッション チャネルの種類を示します。  
+  
+|サポートされる信頼できるセッション チャネルの種類 \(基になるチャネルの種類でサポートされる `TChannel` の値\)|`IReplyChannel`|`IReplySessionChannel`|`IDuplexChannel`|`IDuplexSessionChannel`|  
+|---------------------------------------------------------------------|---------------------|----------------------------|----------------------|-----------------------------|  
+|`IInputSessionChannel`|○|○|○|○|  
+|`IReplySessionChannel`|○|○|×|×|  
+|`IDuplexSessionChannel`|×|×|○|○|  
+  
+ サポートされるチャネルの種類は、<xref:System.ServiceModel.Channels.ReliableSessionBindingElement.BuildChannelListener%60%601%28System.ServiceModel.Channels.BindingContext%29> メソッドに渡されるジェネリック パラメーター `TChannel` に使用できる値です。  
+  
+## 信頼できるセッションとセキュリティ  
+ 双方 \(サービスとクライアント\) が認証され、交換されるメッセージが改ざんされない環境で通信を行うには、信頼できるセッションをセキュリティで保護することが重要です。さらに、個別の信頼できるセッションの整合性を確保することも重要です。信頼できるセッションのセキュリティ保護は、セキュリティ セッション チャネルで管理および提示されるセキュリティ コンテキストにバインドすることによって行います。セキュリティ チャネルによって、セキュリティ セッションが可能になります。セッション確立中に交換されるセキュリティ トークンは、信頼できるセッションでメッセージをセキュリティで保護するために使用されます。  
+  
+ 信頼できるセッションが TCP\-S を経由する場合、信頼できるセッションに TCP セッションが関連付けられます。このため、トランスポート セキュリティによって、信頼できるセッションにセキュリティが確実に関連付けられます。この場合、接続の再確立は無効になります。  
+  
+ 唯一の例外は、HTTPS の使用時です。SSL \(Secure Sockets Layer\) セッションは信頼できるセッションにバインドされません。この場合、セキュリティ コンテキスト \(SSL セッション\) を共有しているセッションどうしは相互に保護されないので、脅威につながります。アプリケーションによっては現実的な脅威となる可能性もあります。  
+  
+## 信頼できるセッションの使用  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の信頼できるセッションを使用するには、信頼できるセッションをサポートするバインディングを使用してエンドポイントを作成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって提供される、信頼できるセッションが有効化されたシステム指定のバインディングの 1 つを使用するか、信頼できるセッションを有効にしたカスタム バインディングを作成します。信頼できるセッションが既定でサポートおよび有効化されているシステム定義のバインディングは、次のとおりです。  
+  
+-   <xref:System.ServiceModel.WSDualHttpBinding>  
+  
+ 信頼できるセッションがオプションとしてサポートされ、既定では有効化されていないシステム指定のバインディングは、次のとおりです。  
+  
+-   <xref:System.ServiceModel.WSHttpBinding>  
+  
+-   <xref:System.ServiceModel.WSFederationHttpBinding>  
+  
+-   <xref:System.ServiceModel.NetTcpBinding>  
+  
+ カスタム バインディングを作成する方法の例については、「[方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md)」を参照してください。  
+  
+ 信頼できるセッションをサポートする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングの詳細については、「[システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## 信頼できるセッションを使用する状況  
+ アプリケーションで信頼できるセッションの使用が求められる状況を理解することが重要です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、双方のエンドポイントがどちらもアクティブである場合に、信頼できるセッションがサポートされます。アプリケーションで、エンドポイントの一方が一定期間使用できないことが必要である場合は、信頼性を実現するためにキューを使用できます。  
+  
+ 2 つのエンドポイントを TCP 経由で接続する必要がある場合、TCP ではパケットが正しい順序で 1 回だけ届くことが保証されているため、信頼できるメッセージ交換を行うために信頼できるセッションを使用する必要はなく、TCP だけで十分な場合があります。  
+  
+ ただし、次のいずれかの特性があるシナリオでは、信頼できるセッションの使用を真剣に検討する必要があります。  
+  
+-   SOAP ルーターなどの SOAP 中継局  
+  
+-   プロキシ中継局またはトランスポート ブリッジ  
+  
+-   断続的な接続  
+  
+-   HTTP を経由するセッション  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [WS 信頼できるセッション](../../../../docs/framework/wcf/samples/ws-reliable-session.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/reliable-sessions.md b/docs/framework/wcf/feature-details/reliable-sessions.md
new file mode 100644
index 00000000000..b084494fc07
--- /dev/null
+++ b/docs/framework/wcf/feature-details/reliable-sessions.md
@@ -0,0 +1,54 @@
+---
+title: "信頼できるセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Windows Communication Foundation, sessions and instances"
+  - "WCF, sessions and instances"
+  - "sessions and instances [WCF]"
+helpviewer_keywords: 
+  - "インスタンス [WCF]"
+  - "セッション [WCF]"
+ms.assetid: 143951b3-3aa0-4540-b4b7-d33e77e874a1
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 信頼できるセッション
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の信頼できるセッションについて、その使用目的、使用方法と使用する状況、サポートするバインディング構成、およびベスト プラクティスの参照先について説明します。このセクションの重要なポイントと関連するトピックの詳細について、次の表にまとめます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって提供される信頼できるセッションでは、SOAP またはトランスポート中継局を経由してエンドポイント間で送信されるメッセージが 1 回だけ配信され、オプションとして送信時と同じ順序で配信されることが保証されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションで信頼できるセッションを使用するには、既定またはオプションとして、信頼できるセッションをサポートする、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のシステム提供のバインディングの 1 つを使用するか、または信頼できるセッションをサポートする独自のカスタム バインディングを作成します。  
+  
+## このセクションの内容  
+ [信頼できるセッションの概要](../../../../docs/framework/wcf/feature-details/reliable-sessions-overview.md)  
+ 信頼できるセッションの概要、信頼できるセッションを使用する状況、信頼できるセッションをサポートする各種のバインディング、および動作のしくみについて説明します。  
+  
+ [方法 : 信頼されたセッション内のメッセージを変換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-within-a-reliable-session.md)  
+ 構成で指定したカスタム バインディングを使用して、HTTP 上で信頼できるセッションを作成する方法を説明します。  
+  
+ [方法 : 信頼できるセッション内でメッセージをセキュリティで保護する](../../../../docs/framework/wcf/feature-details/how-to-secure-messages-within-reliable-sessions.md)  
+ 信頼できるセッションを保護する方法について説明します。  
+  
+ [方法 : カスタムの信頼できるセッションによる HTTPS を使用したバインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-reliable-session-binding-with-https.md)  
+ HTTPS 上で信頼できるセッションを作成する方法について説明します。  
+  
+ [信頼できるセッションのベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-reliable-sessions.md)  
+ 信頼できるセッションの使用に関するベスト プラクティスについて説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.ReliableSession>  
+  
+## 参照  
+ [キューと信頼できるセッション](../../../../docs/framework/wcf/feature-details/queues-and-reliable-sessions.md)   
+ [セッション、インスタンス化、および同時実行](../../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/replay-attacks.md b/docs/framework/wcf/feature-details/replay-attacks.md
new file mode 100644
index 00000000000..d64bbd3d044
--- /dev/null
+++ b/docs/framework/wcf/feature-details/replay-attacks.md
@@ -0,0 +1,52 @@
+---
+title: "リプレイ攻撃 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a17e040-93cd-4432-81b9-9f62fec78c8f
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# リプレイ攻撃
+*リプレイ攻撃*は、攻撃者がメッセージのストリームを 2 つのパーティ間でコピーし、そのストリームを他の 1 つ以上のパーティにリプレイすることで発生します。攻撃が和らげられていない場合、攻撃対象になったコンピューターはストリームを正当なメッセージとして処理するため、項目の順序が重複するなど、望ましくない状況に陥ります。  
+  
+## バインディングはリフレクション攻撃にさらされる可能性がある  
+ *"リフレクション攻撃"* は、受信者からの応答であるかのように送信者に返信されるメッセージのリプレイです。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 機構の標準の*リプレイ検出*では、この攻撃を自動的に処理できません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス モデルは、署名されたメッセージ ID を要求メッセージに追加し、署名された `relates-to` ヘッダーを応答メッセージに要求するため、既定でリフレクション攻撃が軽減されます。その結果、要求メッセージを応答としてリプレイできません。セキュリティで保護された信頼できるメッセージ \(RM\) シナリオでは、リフレクション攻撃は次の理由で軽減されます。  
+  
+-   シーケンス メッセージの作成スキーマとシーケンス応答メッセージの作成スキーマが異なります。  
+  
+-   一方向シーケンスの場合、クライアントから送信されたシーケンス メッセージをクライアントに対してリプレイすることはできません。これは、クライアントがこのようなメッセージを認識できないためです。  
+  
+-   双方向シーケンスの場合、2 つのシーケンス ID が一意である必要があります。このため、送信シーケンス メッセージを受信シーケンス メッセージとしてリプレイできません \(すべてのシーケンス ヘッダーと本文も署名されています\)。  
+  
+ リフレクション攻撃の影響を受けやすい唯一のバインディングは WS\-Addressing を使用しないバインディング \(WS\-Addressing を無効にして、対称キー ベースのセキュリティを使用するカスタム バインディング\) です。<xref:System.ServiceModel.BasicHttpBinding> は、既定では WS\-Addressing を使用しませんが、この攻撃を受けやすい方法で対称キー ベースのセキュリティを使用することはありません。  
+  
+ カスタム バインディングに対する攻撃を軽減するには、セキュリティ コンテキストを確立しないか、WS\-Addressing ヘッダーを要求します。  
+  
+## Web ファーム : 攻撃者が複数のノードに対して要求をリプレイする  
+ クライアントは、Web ファームに実装されているサービスを使用します。攻撃者は、ファーム内の特定のノードに送信された要求を同じファーム内の別のノードに対してリプレイします。また、サービスが再開されると、リプレイ キャッシュがフラッシュされ、攻撃者が要求をリプレイできるようになります \(このキャッシュには、以前使用されたメッセージ署名の値が格納されています。これにより、メッセージ署名は一度しか使用できないため、リプレイを防止できます。リプレイ キャッシュは Web ファーム内で共有されません\)。  
+  
+ 回避事項を次に示します。  
+  
+-   ステートフルなセキュリティ コンテキスト トークンと共にメッセージ モード セキュリティを使用します \(セキュリティで保護されたメッセージ交換を有効にするかどうかは任意\)。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md).  
+  
+-   トランスポート レベルのセキュリティを使用するようにサービスを構成します。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)   
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)   
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/request-reply-correlation.md b/docs/framework/wcf/feature-details/request-reply-correlation.md
new file mode 100644
index 00000000000..75266ae4260
--- /dev/null
+++ b/docs/framework/wcf/feature-details/request-reply-correlation.md
@@ -0,0 +1,109 @@
+---
+title: "要求/応答の相関関係 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf4379bf-2d08-43f3-9584-dfa30ffcb1f6
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 要求/応答の相関関係
+要求\/応答の相関関係は、<xref:System.ServiceModel.Activities.ReceiveReply> と <xref:System.ServiceModel.Activities.Send> のペアと使用すると、ワークフロー サービスに双方向の操作を実装でき、<xref:System.ServiceModel.Activities.SendReply> と <xref:System.ServiceModel.Activities.Receive> のペアと使用すると、別の Web サービスの双方向の操作を呼び出すことができます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの双方向の操作を呼び出す場合、このサービスには、従来の命令型のコード ベースの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを使用することも、ワークフロー サービスを使用することもできます。  要求\/応答の相関関係を使用するには、<xref:System.ServiceModel.BasicHttpBinding> などの双方向のバインドを使用する必要があります。  双方向の操作を呼び出す場合と実装する場合では、相関関係の初期化に同様の手順が使用されます。これらの手順については、このセクションで説明します。  
+  
+## Receive\/SendReply による双方向の操作での相関関係の使用  
+ <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアは、ワークフロー  サービスに双方向の操作を実装するために使用されます。  ランタイムは、要求\/応答の相関関係を使用して、応答が正しい呼び出し元にディスパッチされるようにします。  ワークフローが <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされている場合、つまり、ワークフロー サービスの場合は、既定の相関関係の初期化で十分です。  このシナリオでは、<xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアがワークフローによって使用されます。特定の相関関係の構成は不要です。  
+  
+```csharp  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = OrderContractName,  
+    OperationName = "StartOrder"  
+};  
+  
+SendReply ReplyToStartOrder = new SendReply  
+{  
+    Request = StartOrder,  
+    Content = … // Contains the return value, if any.  
+};  
+  
+// Construct a workflow using StartOrder and ReplyToStartOrder.  
+  
+```  
+  
+### 要求\/応答の相関関係の明示的な初期化  
+ 他の双方向の操作が並列実行される場合、相関関係を明示的に構成する必要があります。  それには、<xref:System.ServiceModel.Activities.CorrelationHandle> と <xref:System.ServiceModel.Activities.RequestReplyCorrelationInitializer> を指定するか、<xref:System.ServiceModel.Activities.CorrelationScope> 内に <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> を設定します。  この例では、要求\/応答の相関関係が <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアを使用して構成されています。  
+  
+```csharp  
+Variable<CorrelationHandle> RRHandle = new Variable<CorrelationHandle>();  
+  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = OrderContractName,  
+    OperationName = "StartOrder",  
+    CorrelationInitializers =  
+    {  
+        new RequestReplyCorrelationInitializer  
+        {  
+            CorrelationHandle = RRHandle  
+        }  
+    }  
+};  
+  
+SendReply ReplyToStartOrder = new SendReply  
+{  
+    Request = StartOrder,  
+    Content = … // Contains the return value, if any.  
+};  
+  
+// Construct a workflow using StartOrder and ReplyToStartOrder.  
+```  
+  
+ 相関関係を明示的に構成する代わりに、<xref:System.ServiceModel.Activities.CorrelationScope> アクティビティを使用することもできます。  <xref:System.ServiceModel.Activities.CorrelationScope> は、内包しているメッセージング アクティビティに暗黙の <xref:System.ServiceModel.Activities.CorrelationHandle> を提供します。  この例では、<xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> ペアが <xref:System.ServiceModel.Activities.CorrelationScope> に内包されています。  明示的な相関関係の構成は不要です。  
+  
+```csharp  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = OrderContractName,  
+    OperationName = "StartOrder"  
+};  
+  
+SendReply ReplyToStartOrder = new SendReply  
+{  
+    Request = StartOrder,  
+    Content = … // Contains the return value, if any.  
+};  
+  
+CorrelationScope s = new CorrelationScope  
+{  
+    Body = new Sequence  
+    {  
+        Activities =   
+        {  
+            StartOrder,  
+            // Activities that create the reply.  
+            ReplyToStartOrder  
+        }  
+    }  
+};  
+  
+// Construct a workflow using the CorrelationScope.  
+```  
+  
+ 追加の相関関係が必要な場合は、目的の種類の `CorrelationInitializer` を使用する各メッセージング アクティビティの <xref:System.ServiceModel.Activities.Send.CorrelationInitializers%2A> プロパティを使用して、追加の相関関係を構成します。  
+  
+## Send\/ReceiveReply による双方向の操作での相関関係の使用  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> によってホストされるワークフロー サービスでのみ使用できますが、<xref:System.ServiceModel.Activities.Send> および <xref:System.ServiceModel.Activities.Send>\/<xref:System.ServiceModel.Activities.ReceiveReply> のペアは、Web サービスに対してメソッドを呼び出す必要のあるすべてのワークフローで使用できます。  ワークフローが <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされる場合は、前のセクションで説明した既定の相関関係が適用されますが、そうでない場合は、目的の <xref:System.ServiceModel.Activities.CorrelationInitializer> と <xref:System.ServiceModel.Activities.CorrelationHandle> を明示的に使用するか、<xref:System.ServiceModel.Activities.CorrelationScope> による暗黙の処理管理を使用して、相関関係を構成する必要があります。  
+  
+ 双方向の操作があるサービスで **\[サービス参照の追加\]** を使用する場合は、明示的に指定された Request\/Reply 相関関係を使用して、内部に <xref:System.ServiceModel.Activities.Send>\/<xref:System.ServiceModel.Activities.ReceiveReply> ペア アクティビティをラップするアクティビティが生成されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/request-reply-services.md b/docs/framework/wcf/feature-details/request-reply-services.md
new file mode 100644
index 00000000000..8957d2e3ff1
--- /dev/null
+++ b/docs/framework/wcf/feature-details/request-reply-services.md
@@ -0,0 +1,43 @@
+---
+title: "要求/応答サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントラクト [WCF], 要求/応答サービス"
+  - "要求/応答コントラクト [WCF]"
+  - "WCF [WCF], 要求/応答サービス"
+  - "Windows Communication Foundation [WCF], 要求/応答サービス"
+ms.assetid: 2fa710f1-47f4-4598-b063-3ab3bd22ebba
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 要求/応答サービス
+要求\/応答サービスは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の操作コントラクトの既定の種類です。クライアントはサービス操作を呼び出し、サービスからの応答を待機します。サービス操作の呼び出しは、同期的または非同期的に実行できます。同期呼び出しでは、応答を受信するか、呼び出しがタイムアウトするまで、クライアントがブロックされます。非同期呼び出しでは、クライアントはサービス操作の呼び出し後、動作を続行し、別のスレッドのサービスからの応答を受信できます。  
+  
+ 要求\/応答サービス コントラクトを作成するには、サービス コントラクトを定義し、次のサンプル コードに示すように <xref:System.ServiceModel.OperationContractAttribute> クラスを各操作に適用します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IRequestReplyCalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+}  
+  
+```  
+  
+ これは既定の動作であるため、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> プロパティを `false` に設定する必要はありません。  
+  
+## 参照  
+ [一方向サービス](../../../../docs/framework/wcf/feature-details/one-way-services.md)   
+ [双方向サービス](../../../../docs/framework/wcf/feature-details/duplex-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/retrieving-metadata.md b/docs/framework/wcf/feature-details/retrieving-metadata.md
new file mode 100644
index 00000000000..0ba0771bb5a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/retrieving-metadata.md
@@ -0,0 +1,43 @@
+---
+title: "メタデータを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ [WCF], 取得"
+ms.assetid: 18d8ba4c-af0f-4827-a50b-4202d767bacc
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# メタデータを取得する
+メタデータの取得は、WS\-MetadataExchange \(MEX\) メタデータ エンドポイントや HTTP\/GET メタデータ エンドポイントなどのメタデータ エンドポイントに対してメタデータを要求して取得する処理です。  
+  
+## Svcutil.exe を使用した、コマンドラインからのメタデータの取得  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールを使用して、`/target:metadata` スイッチとアドレスを渡すことにより、WS\-MetadataExchange 要求または HTTP\/GET 要求を使用してサービス メタデータを取得できます。Svcutil.exe は指定したアドレスでメタデータをダウンロードし、ディスクにファイルを保存します。Svcutil.exe は内部的に <xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスを使用し、構成 \(Svcutil.exe に入力として渡されたアドレスのスキーマに一致する名前の <xref:System.ServiceModel.Description.IMetadataExchange> エンドポイント構成\) から読み込まれます。  
+  
+## MetadataExchangeClient を使用した、プログラムによるメタデータの取得  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、WS\-MetadataExchange 要求や HTTP\/GET 要求などの標準化プロトコルを使用してサービス メタデータを取得できます。これらのプロトコルはいずれも、<xref:System.ServiceModel.Description.MetadataExchangeClient> 型でサポートされます。メタデータ エンドポイントのアドレスとオプションのバインディングを指定することにより、<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> 型を使用してサービス メタデータを取得します。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスで使用するバインディングは、<xref:System.ServiceModel.Description.MetadataExchangeBindings> 静的クラスの既定のバインディング、ユーザー指定のバインディング、`IMetadataExchange` コントラクト用のエンドポイント構成から読み込まれたバインディングのいずれかです。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> は同様に、<xref:System.Net.HttpWebRequest> 型を使用して、メタデータへの HTTP URL 参照を解決できます。  
+  
+ 既定では、<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> インスタンスは、1 つの <xref:System.ServiceModel.ChannelFactory> インスタンスに結び付けられています。<xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> によって使用される <xref:System.ServiceModel.ChannelFactory?displayProperty=fullName> インスタンスは、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetChannelFactory%2A> 仮想メソッドを上書きすることによって変更または置換することができます。同様に、<xref:System.ServiceModel.Description.MetadataExchangeClient.GetWebRequest%2A?displayProperty=fullName> 仮想メソッドをオーバーライドすることによって、HTTP\/GET 要求を行うために <xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> が使用する <xref:System.Net.HttpWebRequest> インスタンスを変更または置換できます。  
+  
+## このセクションの内容  
+ [方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする](../../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md)  
+ Svcutil.exe を使用して、メタデータ ドキュメントをダウンロードする方法を示します。  
+  
+ [方法 : MetadataResolver を使用してバインディング メタデータを動的に取得する](../../../../docs/framework/wcf/feature-details/how-to-use-metadataresolver-to-obtain-binding-metadata-dynamically.md)  
+ <xref:System.ServiceModel.Description.MetadataResolver?displayProperty=fullName> を使用して、実行時に動的にバインディング メタデータを取得する方法を示します。  
+  
+ [方法 : MetadataExchangeClient を使用してメタデータを取得する](../../../../docs/framework/wcf/feature-details/how-to-use-metadataexchangeclient-to-retrieve-metadata.md)  
+ <xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> クラスを使用して、<xref:System.ServiceModel.Description.MetadataSection?displayProperty=fullName> オブジェクトを含む <xref:System.ServiceModel.Description.MetadataSet?displayProperty=fullName> オブジェクトにメタデータ ファイルをダウンロードし、ファイルに書き込んだり、他の目的に使用したりする方法を示します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Description.MetadataExchangeClient>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/routing-contracts.md b/docs/framework/wcf/feature-details/routing-contracts.md
new file mode 100644
index 00000000000..86b41673d89
--- /dev/null
+++ b/docs/framework/wcf/feature-details/routing-contracts.md
@@ -0,0 +1,38 @@
+---
+title: "ルーティング コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ceea7ae-ea19-4cf9-ba4f-d071e236546d
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# ルーティング コントラクト
+ルーティング コントラクトは、ルーティング サービスが処理できるメッセージ パターンを定義します。各コントラクトは型指定されておらず、サービスは、メッセージ スキーマやアクションを認識していない場合でもメッセージを受信できます。このため、ルーティング サービスは、ルーティングされる基盤のメッセージの詳細構成を追加することなく、メッセージをジェネリックにルーティングできます。  
+  
+## ルーティング コントラクト  
+ ルーティング サービスには汎用 WCF メッセージ オブジェクトを使用できるため、コントラクトを選ぶ場合の最大の検討事項は、クライアントとサービスとの通信時に使用されるチャネルの形状です。ルーティング サービスは、メッセージを処理するときに対象型メッセージ ポンプを使用するため、通常、受信コントラクトの形状は、送信コントラクトの形状と一致します。ただし、サービス モデルのディスパッチャーがこの形状を変更する場合があります。たとえば、ディスパッチャーは、二重チャネルを要求\/応答チャネルに変換したり、セッションのサポートが不要で使用されていない場合に、このサポートを削除 \(つまり、**SessionMode.Allowed** が設定されている場合に、**IInputSessionChannel** を **IInputChannel** に変更\) したりします。  
+  
+ これらのメッセージ ポンプをサポートするために、ルーティング サービスでは、<xref:System.ServiceModel.Routing> 名前空間にコントラクトを用意しています。これらのコントラクトは、ルーティング サービスが使用するサービス エンドポイントを定義するときに、使用される必要があります。これらのコントラクトは型指定されていないため、どのようなメッセージの種類やアクションでも受信でき、ルーティング サービスは、特定のメッセージ スキーマを認識しない場合でもメッセージを処理できます。ルーティング サービスが使用するコントラクトの詳細については、「[Routing Contracts](../../../../docs/framework/wcf/feature-details/routing-contracts.md)」を参照してください。  
+  
+ ルーティング サービスによって提供されるコントラクトは、<xref:System.ServiceModel.Routing> 名前空間に含まれています。これらのコントラクトは、次の表のとおりです。  
+  
+|コントラクト|\[図形\]|チャネル形状|  
+|------------|------------|------------|  
+|<xref:System.ServiceModel.Routing.ISimplexDatagramRouter>|SessionMode \= SessionMode.Allowed<br /><br /> AsyncPattern \= true<br /><br /> IsOneWay \= true|IInputChannel \-\> IOutputChannel|  
+|<xref:System.ServiceModel.Routing.ISimplexSessionRouter>|SessionMode \= SessionMode.Required<br /><br /> AsyncPattern \= true<br /><br /> IsOneWay \= true|IInputSessionChannel \-\> IOutputSessionChannel|  
+|<xref:System.ServiceModel.Routing.IRequestReplyRouter>|SessionMode \= SessionMode.Allowed<br /><br /> AsyncPattern \= true|IReplyChannel \-\> IRequestChannel|  
+|<xref:System.ServiceModel.Routing.IDuplexSessionRouter>|SessionMode\=SessionMode.Required<br /><br /> CallbackContract\=typeof\(ISimplexSession\)<br /><br /> AsyncPattern \= true<br /><br /> IsOneWay \= true<br /><br /> TransactionFlow\(TransactionFlowOption.Allowed\)|IDuplexSessionChannel \-\> IDuplexSessionChannel|  
+  
+## 参照  
+ [Routing Service](http://msdn.microsoft.com/ja-jp/5ac8718c-bcef-456f-bfd5-1e60a30d6eaa)   
+ [ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/routing-introduction.md b/docs/framework/wcf/feature-details/routing-introduction.md
new file mode 100644
index 00000000000..d499c4ec210
--- /dev/null
+++ b/docs/framework/wcf/feature-details/routing-introduction.md
@@ -0,0 +1,415 @@
+---
+title: "ルーティングの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf6ceb38-6622-433b-9ee7-f79bc93497a1
+caps.latest.revision: 11
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ルーティングの概要
+ルーティング サービスは、メッセージの内容を基にメッセージをルーティングできる、プラグ可能な汎用の SOAP 中継局を提供します。  ルーティング サービスを使用すると、サービスの集計、サービスのバージョン管理、優先度ルーティング、マルチキャスト ルーティングなどのシナリオを実装できる複雑なルーティング ロジックを作成できます。  また、ルーティング サービスは、バックアップ エンドポイントのリストを設定できるエラー処理機能も提供します。バックアップ エンドポイントは、プライマリ送信先エンドポイントへの送信時に障害が発生した場合に、メッセージの送信先になります。  
+  
+ このトピックでは、ルーティング サービスをご存じない方を対象としています。ここでは、ルーティング サービスの基本的な構成とホストについて説明します。  
+  
+## 構成  
+ ルーティング サービスは、1 つ以上のサービス エンドポイントを公開する WCF サービスとして実装されます。サービス エンドポイントは、クライアント アプリケーションからメッセージを受信し、受信したメッセージを 1 つ以上の送信先エンドポイントにルーティングします。  ルーティング サービスには <xref:System.ServiceModel.Routing.RoutingBehavior> があります。これは、このサービスによって公開されるサービス エンドポイントに適用されます。  この動作を使用して、サービスの稼働方法について詳細を構成します。  構成ファイルを使用する場合に構成しやすいように、パラメーターを **RoutingBehavior** に指定します。  コード ベースのシナリオでは、これらのパラメーターを <xref:System.ServiceModel.Routing.RoutingConfiguration> オブジェクトの一部として指定し、このオブジェクトを **RoutingBehavior** に渡すことができます。  
+  
+ 開始時に、この動作はメッセージの SOAP 処理の実行に使用される <xref:System.ServiceModel.Routing.SoapProcessingBehavior> をクライアントのエンドポイントに追加します。  追加されると、ルーティング サービスが、メッセージを受信したエンドポイントとは異なる **MessageVersion** が必要なエンドポイントにメッセージを転送できるようになります。  **RoutingBehavior** は、サービス拡張である <xref:System.ServiceModel.Routing.RoutingExtension> も登録します。この機能拡張は、実行時にルーティング サービスを変更するためのアクセス ポイントを提供します。  
+  
+ **RoutingConfiguration** クラスは、ルーティング サービスの構成および構成の更新を一貫性を持って実行できる手段を提供します。  このクラスには、ルーティング サービスの設定となるパラメーターが含まれます。これらのパラメーターは、サービスの開始時に **RoutingBehavior** を構成するために使用されるか、実行時にルーティング構成を変更するために **RoutingExtension** に渡されます。  
+  
+ メッセージのコンテンツ ベースのルーティングを実行するために使用するルーティング ロジックは、複数の <xref:System.ServiceModel.Dispatcher.MessageFilter> オブジェクトをフィルター テーブル \(<xref:System.ServiceModel.Dispatcher.MessageFilterTable%601> オブジェクト\) にまとめて定義します。  受信メッセージは、フィルター テーブルに保持されているメッセージ フィルターに対して評価され、メッセージに一致する各 **MessageFilter** に従って、送信先エンドポイントに転送されます。  メッセージのルーティングに使用するフィルター テーブルは、構成で **RoutingBehavior** を使用するか、**RoutingConfiguration** オブジェクトを使用してコードにより指定します。  
+  
+### エンドポイントの定義  
+ 構成を行うには、使用するルーティング ロジックの定義から始めるように思えますが、実際には、まず、メッセージのルーティング先になるエンドポイントの形状を決定する必要があります。  ルーティング サービスは、メッセージの送受信に使用するチャネルの形状を定義するコントラクトを使用するため、入力チャネルの形状と出力チャネルの形状が一致する必要があります。  たとえば、要求\/応答チャネル形状を使用するエンドポイントにルーティングする場合は、<xref:System.ServiceModel.Routing.IRequestReplyRouter> など、着信エンドポイントでも、互換性のあるコントラクトを使用する必要があります。  
+  
+ つまり、複数の送信先エンドポイントが、複数の通信パターン \(一方向の操作と双方向の操作の混合など\) のコントラクトを使用している場合は、すべての送信先エンドポイントへのメッセージの受信とルーティングを行う単一のサービス エンドポイントを作成することはできません。  互換性のある形状を使用するエンドポイントを特定し、送信先エンドポイントにルーティングされるメッセージの受信に使用するサービス エンドポイントを 1 つ以上定義する必要があります。  
+  
+> [!NOTE]
+>  複数の通信パターン \(一方向の操作と双方向の操作の混合など\) を指定するコントラクトを使用している場合は、<xref:System.ServiceModel.Routing.IDuplexSessionRouter> など、二重のコントラクトをルーティング サービスで使用して対処します。  ただし、この場合は、バインドが二重通信に対応可能である必要があり、シナリオによっては、それが可能でない場合もあります。  対応が不可能なシナリオでは、複数のエンドポイントに通信をファクタリングするか、アプリケーションの変更が必要になる可能性があります。  
+  
+ ルーティング コントラクトの詳細については、「[ルーティング コントラクト](../../../../docs/framework/wcf/feature-details/routing-contracts.md)」を参照してください。  
+  
+ サービス エンドポイントが定義されたら、**RoutingBehavior** を使用して特定の **RoutingConfiguration** をエンドポイントに関連付けることができます。  構成ファイルを使用してルーティング サービスを構成する場合は、**RoutingBehavior** を使用して、このエンドポイントで受信されるメッセージの処理に使用するルーティング ロジックを保持しているフィルター テーブルを指定します。  ルーティング サービスをプログラムにより構成する場合は、**RoutingConfiguration** を使用して、フィルター テーブルを指定できます。  
+  
+ 以下に、プログラムによる方法と構成ファイルを使用する方法の両方で、ルーティング サービスが使用するサービスおよびクライアント エンドポイントを定義する例を示します。  
+  
+```xml  
+<services>  
+      <!--ROUTING SERVICE -->  
+      <service behaviorConfiguration="routingData"  
+               name="System.ServiceModel.Routing.RoutingService">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/routingservice/router"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- Define the service endpoints that are receive messages -->  
+        <endpoint address=""  
+                  binding="wsHttpBinding"  
+                  name="reqReplyEndpoint"  
+                  contract="System.ServiceModel.Routing.IRequestReplyRouter" />      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="routingData">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <!-- Add the RoutingBehavior and specify the Routing Table to use -->  
+          <routing filterTableName="routingTable1" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <client>  
+    <!-- Define the client endpoint(s) to route messages to -->  
+      <endpoint name="CalculatorService"  
+                address="http://localhost:8000/servicemodelsamples/service"  
+                binding="wsHttpBinding" contract="*" />  
+    </client>  
+```  
+  
+```csharp  
+//set up some communication defaults  
+string clientAddress = "http://localhost:8000/servicemodelsamples/service";  
+string routerAddress = "http://localhost:8000/routingservice/router";  
+Binding routerBinding = new WSHttpBinding();  
+Binding clientBinding = new WSHttpBinding();  
+//add the endpoint the router uses to receive messages  
+serviceHost.AddServiceEndpoint(  
+     typeof(IRequestReplyRouter),   
+     routerBinding,   
+     routerAddress);  
+//create the client endpoint the router routes messages to  
+ContractDescription contract = ContractDescription.GetContract(  
+     typeof(IRequestReplyRouter));  
+ServiceEndpoint client = new ServiceEndpoint(  
+     contract,   
+     clientBinding,   
+     new EndpointAddress(clientAddress));  
+//create a new routing configuration object  
+RoutingConfiguration rc = new RoutingConfiguration();  
+….  
+rc.FilterTable.Add(new MatchAllMessageFilter(), endpointList);  
+//attach the behavior to the service host  
+serviceHost.Description.Behaviors.Add(  
+     new RoutingBehavior(rc));  
+```  
+  
+ この例では、アドレスが "http:\/\/localhost:8000\/routingservice\/router" である単一のエンドポイントを公開するようにルーティング サービスを構成しています。このエンドポイントは、ルーティングされるメッセージの受信に使用されます。  メッセージは要求\/応答エンドポイントにルーティングされるため、サービス エンドポイントは <xref:System.ServiceModel.Routing.IRequestReplyRouter> コントラクトを使用します。  この構成では、メッセージのルーティング先となる単一のクライアント エンドポイント "http:\/\/localhost:8000\/servicemodelsample\/service" も定義しています。  "routingTable1" という名前のフィルター テーブル \(例には含まれていません\) は、メッセージのルーティングに使用されるルーティング ロジックを保持しており、**RoutingBehavior** \(構成ファイルの場合\) または **RoutingConfiguration** \(プログラムによる構成の場合\) を使用してサービス エンドポイントに関連付けられています。  
+  
+### ルーティング ロジック  
+ メッセージのルーティングに使用されるルーティング ロジックを定義するには、受信メッセージに含まれるデータのうち、一意に識別して処理できるものを特定する必要があります。  たとえば、ルーティング先のすべてのエンドポイントが同じ SOAP アクションを共有する場合、メッセージに含まれる Action の値は、メッセージのルーティング先となる特定のエンドポイントを示す値としては不適切です。  ある特定のエンドポイントにメッセージを一意にルーティングする必要がある場合は、メッセージのルーティング先エンドポイントを一意に識別できるデータを基に、フィルター処理を行います。  
+  
+ ルーティング サービスには、アドレス、アクション、エンドポイント名、さらには XPath クエリなど、メッセージ内の特定の値を確認する **MessageFilter** 実装がいくつかあります。  これらの実装の中にニーズに合うものがない場合は、カスタムの **MessageFilter** 実装を作成できます。  メッセージ フィルターの詳細およびルーティング サービスが使用する実装の比較については、「[メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)」および「[フィルターの選択](../../../../docs/framework/wcf/feature-details/choosing-a-filter.md)」を参照してください。  
+  
+ 複数のメッセージ フィルターをまとめて、フィルター テーブルで管理します。このテーブルで、各 **MessageFilter** と送信先エンドポイントが関連付けられます。  または、フィルター テーブルを使用して、通信エラーが発生した場合に、ルーティング サービスがメッセージを送信するバックアップ エンドポイントのリストを指定することもできます。  
+  
+ 既定では、フィルター テーブル内のすべてのメッセージ フィルターが同時に評価されます。ただし、<xref:System.ServiceModel.Routing.Configuration.FilterTableEntryElement.Priority%2A> を指定すると、特定の順序でメッセージ フィルターが評価されるようにすることができます。  優先度が最も高いすべてのエントリが最初に評価されます。優先度レベルが高いフィルターの中に一致するものが見つかった場合、それよりも優先度の低いメッセージ フィルターは評価されません。  フィルター テーブルの詳細については、「[メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)」を参照してください。  
+  
+ 次の例では <xref:System.ServiceModel.Dispatcher.MatchAllMessageFilter> を使用しています。これは、すべてのメッセージに対して `true` に評価されます。  この **MessageFilter** は "routingTable1" フィルター テーブルに追加され、このテーブルで **MessageFilter** が、"CalculatorService" という名前のクライアント エンドポイントに関連付けられます。  次に、**RoutingBehavior** で、サービス エンドポイントが処理するメッセージのルーティングに、このテーブルが使用されるように指定しています。  
+  
+```xml  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="routingData">  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <!-- Add the RoutingBehavior and specify the Routing Table to use -->  
+      <routing filterTableName="routingTable1" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+<!--ROUTING SECTION -->  
+<routing>  
+  <filters>  
+    <filter name="MatchAllFilter1" filterType="MatchAll" />  
+  </filters>  
+  <filterTables>  
+    <table name="routingTable1">  
+      <filters>  
+        <add filterName="MatchAllFilter1" endpointName="CalculatorService" />  
+      </filters>  
+    </table>  
+  </filterTables>  
+</routing>  
+```  
+  
+```csharp  
+//create a new routing configuration object  
+RoutingConfiguration rc = new RoutingConfiguration();  
+//create the endpoint list that contains the endpoints to route to  
+//in this case we have only one  
+List<ServiceEndpoint> endpointList = new List<ServiceEndpoint>();  
+endpointList.Add(client);  
+//add a MatchAll filter to the Router's filter table  
+//map it to the endpoint list defined earlier  
+//when a message matches this filter, it is sent to the endpoint contained in the list  
+rc.FilterTable.Add(new MatchAllMessageFilter(), endpointList);  
+```  
+  
+> [!NOTE]
+>  既定でルーティング サービスによって評価されるのは、メッセージのヘッダーのみです。  フィルターがメッセージ本文にアクセスできるようにするには、<xref:System.ServiceModel.Routing.RoutingConfiguration.RouteOnHeadersOnly%2A> を `false` に設定します。  
+  
+ **マルチキャスト**  
+  
+ 多くのルーティング サービス構成では、特定の 1 つのエンドポイントにのみメッセージをルーティングする排他的なフィルター ロジックが使用されますが、特定のメッセージを、複数の送信先エンドポイントにルーティングすることが必要な場合もあります。  メッセージを複数の送信先にマルチキャストするには、次の条件を満たす必要があります。  
+  
+-   要求への応答時にクライアント アプリケーションが受信できるのは 1 つの応答のみであるため、チャネル形状が要求\/応答でない \(一方向または二重のどちらでもよい\) ことが必要である。  
+  
+-   複数のフィルターが、メッセージの評価時に `true` を返す必要がある。  
+  
+ これらの条件が満たされる場合は、メッセージが、`true` に評価されたすべてのフィルターのすべてのエンドポイントにルーティングされます。  次の例では、メッセージ内のエンドポイント アドレスが http:\/\/localhost:8000\/routingservice\/router\/rounding である場合、両方のエンドポイントにメッセージがルーティングされるルーティング構成を定義しています。  
+  
+```xml  
+<!--ROUTING SECTION -->  
+<routing>  
+  <filters>  
+    <filter name="MatchAllFilter1" filterType="MatchAll" />  
+    <filter name="RoundingFilter1" filterType="EndpointAddress"  
+            filterData="http://localhost:8000/routingservice/router/rounding" />  
+  </filters>  
+  <filterTables>  
+    <table name="routingTable1">  
+      <filters>  
+        <add filterName="MatchAllFilter1" endpointName="CalculatorService" />  
+        <add filterName="RoundingFilter1" endpointName="RoundingCalcService" />  
+      </filters>  
+    </table>  
+  </filterTables>  
+</routing>  
+```  
+  
+```csharp  
+rc.FilterTable.Add(new MatchAllMessageFilter(), calculatorEndpointList);  
+rc.FilterTable.Add(new EndpointAddressMessageFilter(new EndpointAddress(  
+    "http://localhost:8000/routingservice/router/rounding")),  
+    roundingCalcEndpointList);  
+```  
+  
+### SOAP 処理  
+ 異種プロトコル間でのメッセージのルーティングをサポートするために、既定では、**RoutingBehavior** が、メッセージのルーティング先であるすべてのクライアント エンドポイントに <xref:System.ServiceModel.Routing.SoapProcessingBehavior> を追加します。  この動作は、メッセージがエンドポイントにルーティングされる前に、自動的に新しい **MessageVersion** を作成するだけでなく、要求側クライアント アプリケーションに応答ドキュメントを返す前に、応答ドキュメント用に互換性のある **MessageVersion** を作成します。  
+  
+ 送信メッセージ用に新しい **MessageVersion** を作成する手順は、次のとおりです。  
+  
+ **要求の処理**  
+  
+-   送信バインドおよびチャネルの **MessageVersion** を取得します。  
+  
+-   元のメッセージの本文のリーダーを取得します。  
+  
+-   同じ操作、同じ本文のリーダーと、新しい **MessageVersion** を使用して新しいメッセージを作成します。  
+  
+-   <xref:System.ServiceModel.Channels.MessageVersion.Addressing%2A> \!\= **Addressing.None** の場合は、To、From、FaultTo、および RelatesTo の各ヘッダーを新しいメッセージにコピーします。  
+  
+-   新しいメッセージにすべてのメッセージ プロパティをコピーします。  
+  
+-   応答の処理時に使用するために、元の要求メッセージを保存します。  
+  
+-   新しい要求メッセージを返します。  
+  
+ **応答の処理**  
+  
+-   元の要求メッセージの **MessageVersion** を取得します。  
+  
+-   受信した応答メッセージの本文のリーダーを取得します。  
+  
+-   同じ操作、同じ本文のリーダー、および、元の要求メッセージの **MessageVersion** を使用して、新しい応答メッセージを作します。  
+  
+-   <xref:System.ServiceModel.Channels.MessageVersion.Addressing%2A> \!\= **Addressing.None** の場合は、To、From、FaultTo、および RelatesTo の各ヘッダーを新しいメッセージにコピーします。  
+  
+-   新しいメッセージにメッセージ プロパティをコピーします。  
+  
+-   新しい応答メッセージを返します。  
+  
+ 既定では、サービスの開始時に **SoapProcessingBehavior** が <xref:System.ServiceModel.Routing.RoutingBehavior> によって自動的にクライアント エンドポイントに追加されますが、<xref:System.ServiceModel.Routing.RoutingConfiguration.SoapProcessingEnabled%2A> プロパティを使用することで、すべてのクライアント エンドポイントに SOAP 処理を追加するかどうかを制御できます。  また、この動作を直接特定のエンドポイントに追加したり、SOAP 処理をより細かく制御する必要がある場合に、エンドポイント レベルでこの動作を無効にしたりすることもできます。  
+  
+> [!NOTE]
+>  元の要求メッセージとは異なる MessageVersion を必要とするエンドポイントで SOAP 処理を無効にする場合は、送信先エンドポイントにメッセージを送信する前に必要な SOAP の変更を実行するカスタムのメカニズムを提供する必要があります。  
+  
+ 次の例では、**soapProcessingEnabled** プロパティを使用して、**SoapProcessingBehavior** が自動的にすべてのクライアント エンドポイントに追加されないようにしています。  
+  
+```xml  
+<behaviors>  
+  <!--default routing service behavior definition-->  
+  <serviceBehaviors>  
+    <behavior name="routingConfiguration">  
+      <routing filterTableName="filterTable1" soapProcessingEnabled="false"/>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+```csharp  
+//create the default RoutingConfiguration  
+RoutingConfiguration rc = new RoutingConfiguration();  
+rc.SoapProcessingEnabled = false;  
+```  
+  
+### 動的構成  
+ 追加のクライアント エンドポイントを追加する場合、またはメッセージのルーティングに使用されるフィルターを変更する必要がある場合は、ルーティング サービスを介してメッセージを現在受信しているエンドポイントへのサービスを中断しないように、実行時に動的に構成を更新できる手段を用意する必要があります。  ホスト アプリケーションの構成ファイルまたはコードを変更するだけでは、不十分な場合があります。どちらの方法にもアプリケーションのリサイクルが必要で、現在転送中のメッセージが失われたり、サービスの再起動の処理中にダウンタイムが発生したりする可能性があるためです。  
+  
+ **RoutingConfiguration** は、プログラムによってのみ変更できます。  サービスの初期構成は構成ファイルで実行できますが、実行時に構成を変更する方法は、新しい **RoutingConfigution** を作成して、<xref:System.ServiceModel.Routing.RoutingExtension> サービス拡張が公開する <xref:System.ServiceModel.Routing.RoutingExtension.ApplyConfiguration%2A> メソッドにパラメーターとして渡すことのみです。  現在転送中のメッセージでは、以前の構成を使用してルーティングの処理が続けられますが、**ApplyConfiguration** への呼び出し後に受信されたメッセージでは、新しい構成が使用されます。  次の例では、ルーティング サービスのインスタンスを作成し、次に、構成を変更しています。  
+  
+```csharp  
+RoutingConfiguration routingConfig = new RoutingConfiguration();  
+routingConfig.RouteOnHeadersOnly = true;  
+routingConfig.FilterTable.Add(new MatchAllMessageFilter(), endpointList);  
+RoutingBehavior routing = new RoutingBehavior(routingConfig);  
+routerHost.Description.Behaviors.Add(routing);  
+routerHost.Open();  
+// Construct a new RoutingConfiguration  
+RoutingConfiguration rc2 = new RoutingConfiguration();  
+ServiceEndpoint clientEndpoint = new ServiceEndpoint();  
+ServiceEndpoint clientEndpoint2 = new ServiceEndpoint();  
+// Add filters to the FilterTable in the new configuration  
+rc2.FilterTable.add(new MatchAllMessageFilter(),  
+       new List<ServiceEndpoint>() { clientEndpoint });  
+rc2.FilterTable.add(new MatchAllMessageFilter(),  
+       new List<ServiceEndpoint>() { clientEndpoint2 });  
+rc2.RouteOnHeadersOnly = false;  
+// Apply the new configuration to the Routing Service hosted in  
+routerHost.routerHost.Extensions.Find<RoutingExtension>().ApplyConfiguration(rc2);  
+```  
+  
+> [!NOTE]
+>  この場合は、新しい構成を渡すことが、ルーティング サービスを更新する唯一の方法です。  現在の構成から選択した要素のみを変更することも、新しいエントリを現在の構成に追加することもできません。既存の構成に代わる新しい構成を作成して、これを渡す必要があります。  
+  
+> [!NOTE]
+>  以前の構成を使用して開かれているセッションでは、引き続き、以前の構成が使用されます。  新しい構成は、新しいセッションでのみ使用されます。  
+  
+## エラー処理  
+ メッセージの送信時に <xref:System.ServiceModel.CommunicationException> が発生した場合は、エラー処理が実行されます。  これらの例外は、一般的に、<xref:System.ServiceModel.EndpointNotFoundException>、<xref:System.ServiceModel.ServerTooBusyException>、<xref:System.ServiceModel.CommunicationObjectFaultedException> など、定義されているクライアント エンドポイントとの通信を試みている間に問題が発生したことを示します。  また、エラー処理コードは、<xref:System.TimeoutException> が発生すると、それをキャッチして再送信を試みます。この例外も、**CommunicationException** から派生したのではない、一般的な例外です。  
+  
+ 上記の例外のいずれかが発生した場合、ルーティング サービスは、バックアップ エンドポイントのリストにフェールオーバーします。  すべてのバックアップ エンドポイントで通信エラーが発生した場合、または、送信先サービス内でのエラーを示す例外がエンドポイントから返された場合は、ルーティング サービスがクライアント アプリケーションにエラーを返します。  
+  
+> [!NOTE]
+>  エラー処理機能は、メッセージの送信時とチャネルの終了時に発生した例外をキャプチャーし、処理します。  エラー処理コードは、通信対象のアプリケーション エンドポイントによって作成された例外については、検出も処理も行いません。サービスからスローされた <xref:System.ServiceModel.FaultException> は、ルーティング サービスでは **FaultMessage** として扱われ、クライアントに戻されます。  
+>   
+>  ルーティング サービスによってメッセージを転送しようとしてエラーが発生した場合、通常、ルーティング サービスが行われない場合に受け取る <xref:System.ServiceModel.EndpointNotFoundException> ではなく、<xref:System.ServiceModel.FaultException> をクライアント サイドで受け取る可能性があります。  入れ子になった例外を調べないと、このようにルーティング サービスによって例外がマスクされて完全な透過性が提供されない可能性があります。  
+  
+### 例外のトレース  
+ メッセージをリスト内のエンドポイントに送信できなかった場合、ルーティング サービスは、生成された例外データをトレースして、**Exceptions** という名前のメッセージ プロパティに例外の詳細をアタッチします。  これで、例外データを保存し、ユーザーがメッセージ インスペクターを利用して、プログラムでアクセスできるようにします。  例外データは、メッセージごとにディクショナリに格納されます。ディクショナリでは、エンドポイント名と、そのエンドポイントにメッセージを送信する際に発生した例外の詳細がマップされます。  
+  
+### バックアップ エンドポイント  
+ フィルター テーブル内の各フィルター エントリには、必要に応じて、バックアップ エンドポイントのリストを指定できます。バックアップ エンドポイントは、プライマリ エンドポイントへの送信時に通信エラーが発生した場合に使用されます。  このようなエラーが発生した場合、ルーティング サービスでは、このバックアップ エンドポイントのリスト内の最初のエントリに対して、メッセージの転送を試みます。  この送信でも通信エラーが発生した場合は、バックアップ リスト内の次のエンドポイントが試されます。  ルーティング サービスは、メッセージの受信が成功するか、すべてのエンドポイントが通信エラーを返すか、またはエンドポイントによって通信エラー以外のエラーが返されるまで、リスト内の各エンドポイントに対してメッセージの送信を続行します。  
+  
+ 次の例では、バックアップ リストを使用するようにルーティング サービスを構成しています。  
+  
+```xml  
+<routing>  
+  <filters>  
+    <!-- Create a MatchAll filter that catches all messages -->  
+    <filter name="MatchAllFilter1" filterType="MatchAll" />  
+  </filters>  
+  <filterTables>  
+    <!-- Set up the Routing Service's Message Filter Table -->  
+    <filterTable name="filterTable1">  
+        <!-- Add an entry that maps the MatchAllMessageFilter to the dead destination -->  
+        <!-- If that endpoint is down, tell the Routing Service to try the endpoints -->  
+        <!-- Listed in the backupEndpointList -->  
+        <add filterName="MatchAllFilter1" endpointName="deadDestination" backupList="backupEndpointList"/>  
+    </filterTable>  
+  </filterTables>  
+  <!-- Create the backup endpoint list -->  
+  <backupLists>  
+    <!-- Add an endpoint list that contains the backup destinations -->  
+    <backupList name="backupEndpointList">  
+      <add endpointName="realDestination" />  
+      <add endpointName="backupDestination" />  
+    </backupList>  
+  </backupLists>  
+</routing>  
+```  
+  
+```csharp  
+//create the endpoint list that contains the service endpoints we want to route to  
+List<ServiceEndpoint> backupList = new List<ServiceEndpoint>();  
+//add the endpoints in the order that the Routing Service should contact them  
+//first add the endpoint that we know is down  
+//clearly, normally you wouldn't know that this endpoint was down by default  
+backupList.Add(fakeDestination);  
+//then add the real Destination endpoint  
+//the Routing Service attempts to send to this endpoint only if it   
+//encounters a TimeOutException or CommunicationException when sending  
+//to the previous endpoint in the list.  
+backupList.Add(realDestination);  
+//add the backupDestination endpoint  
+//the Routing Service attempts to send to this endpoint only if it  
+//encounters a TimeOutException or CommunicationsException when sending  
+//to the previous endpoints in the list  
+backupList.Add(backupDestination);  
+//create the default RoutingConfiguration option              
+RoutingConfiguration rc = new RoutingConfiguration();  
+//add a MatchAll filter to the Routing Configuration's filter table  
+//map it to the list of endpoints defined above  
+//when a message matches this filter, it is sent to the endpoints in the list in order  
+//if an endpoint is down or does not respond (which the first endpoint won't  
+//since the client does not exist), the Routing Service automatically moves the message  
+//to the next endpoint in the list and try again.  
+rc.FilterTable.Add(new MatchAllMessageFilter(), backupList);  
+```  
+  
+### サポートされるエラー パターン  
+ 次の表に、バックアップ エンドポイント リストを使用できるパターンと、各パターンのエラー処理の詳細な説明を示します。  
+  
+|パターン|セッション|トランザクション|受信コンテキスト|サポートされるバックアップ リスト|メモ|  
+|----------|-----------|--------------|--------------|-----------------------|--------|  
+|一方向||||はい|バックアップ エンドポイントでメッセージの再送を試みます。  このメッセージがマルチキャストされる場合は、エラーが発生したチャネルのメッセージのみが、バックアップ先に移動されます。|  
+|一方向||![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")||Ｘ|例外がスローされ、トランザクションがロールバックされます。|  
+|一方向|||![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|はい|バックアップ エンドポイントでメッセージの再送を試みます。  メッセージの受信が成功したら、すべての受信コンテキストを完了します。  どのエンドポイントでもメッセージを受信できなかった場合は、受信コンテキストを完了しません。<br /><br /> このメッセージがマルチキャストされる場合は、少なくとも 1 つのエンドポイント \(プライマリでもバックアップでも\) でメッセージが受信された場合にのみ、受信コンテキストが完了されます。  どのマルチキャスト パスのエンドポイントでもメッセージを受信できなかった場合は、受信コンテキストを完了しません。|  
+|一方向||![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|はい|前のトランザクションを中止し、新しいトランザクションを作成して、すべてのメッセージを再送します。  エラーが発生したメッセージは、バックアップ先に転送されます。<br /><br /> すべての転送が成功するトランザクションが作成されたら、受信コンテキストを完了して、転送をコミットします。|  
+|一方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|||はい|バックアップ エンドポイントでメッセージの再送を試みます。  マルチキャスト セッションの場合は、エラーが発生したセッションまたはセッションを終了できなかったセッションのメッセージのみが、バックアップ先に送信されます。|  
+|一方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")||Ｘ|例外がスローされ、トランザクションがロールバックされます。|  
+|一方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")||![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|はい|バックアップ エンドポイントでメッセージの再送を試みます。  エラーが発生せずに、すべてのメッセージ送信が完了したら、セッションが他にメッセージがないことを通知して、ルーティング サービスがすべての送信セッション チャネルを終了します。また、受信コンテキストが完了し、受信セッション チャネルが終了します。|  
+|一方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|はい|現在のトランザクションを中止し、新しいトランザクションを作成します。  セッションに含まれる、以前のメッセージをすべて再送します。  すべてのメッセージ送信が成功したトランザクションが作成され、セッションが他にメッセージがないことを通知すると、すべての送信セッション チャネルが終了します。また、そのトランザクションのすべての受信コンテキストが完了し、受信セッション チャネルが終了して、トランザクションがコミットされます。<br /><br /> セッションがマルチキャストされる場合は、エラーが発生していないメッセージが、前回と同じ送信先に再送され、エラーが発生したメッセージはバックアップ先に送信されます。|  
+|双方向||||はい|バックアップ先に送信します。  チャネルが応答メッセージを返した後に、元のクライアントに応答を返します。|  
+|双方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|||はい|チャネルのすべてのメッセージをバックアップ先に送信します。  チャネルが応答メッセージを返した後に、元のクライアントに応答を返します。|  
+|双方向||![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")||Ｘ|例外がスローされ、トランザクションがロールバックされます。|  
+|双方向|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")||Ｘ|例外がスローされ、トランザクションがロールバックされます。|  
+|二重||||Ｘ|セッションのない二重通信は、現在サポートされていません。|  
+|二重|![チェック マーク](../../../../docs/framework/wcf/feature-details/media/checkmark.gif "Checkmark")|||はい|バックアップ先に送信します。|  
+  
+## ホスト  
+ ルーティング サービスは WCF サービスとして実装されるため、アプリケーション内に自己ホストされるか、IIS または WAS によってホストされる必要があります。  ルーティング サービスは、IIS、WAS、または Windows サービス アプリケーションにホストし、これらのホスト環境で提供される自動開始機能やライフ サイクル管理機能を利用できるようにすることをお勧めします。  
+  
+ 次の例では、アプリケーションでルーティング サービスをホストしています。  
+  
+```csharp  
+using (ServiceHost serviceHost =  
+                new ServiceHost(typeof(RoutingService)))  
+  
+```  
+  
+ ルーティング サービスを IIS または WAS 内でホストするには、サービス ファイル \(.svc\) を作成するか、サービスの構成ベースのアクティブ化を使用する必要があります。  サービス ファイルを使用する場合は、Service パラメーターを使用して <xref:System.ServiceModel.Routing.RoutingService> を指定する必要があります。  次の例は、IIS または WAS によるルーティング サービスのホストに使用できるサンプルのサービス ファイルです。  
+  
+```  
+<%@ ServiceHost Language="C#" Debug="true" Service="System.ServiceModel.Routing.RoutingService,   
+     System.ServiceModel.Routing, version=4.0.0.0, Culture=neutral,   
+     PublicKeyToken=31bf3856ad364e35" %>  
+  
+```  
+  
+## ルーティング サービスと偽装  
+ WCF ルーティング サービスは、メッセージの送受信両方の偽装で使用できます。  偽装に関する通常の Windows のすべての制約が適用されます。  独自のサービスを作成する際、偽装を使用するためにサービスまたはアカウントのアクセス許可を設定する必要があった場合は、ルーティング サービスで偽装を使用する場合と同じ手順を実行する必要があります。  詳細については、「[委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+ ルーティング サービスでの偽装には、ASP.NET 互換モードで ASP.NET の偽装を使用するか、偽装を許可するように構成された Windows 資格情報を使用する必要があります。  ASP.NET 互換モードの詳細については、「[WCF サービスと ASP.NET](../../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」を参照してください。  
+  
+> [!WARNING]
+>  WCF ルーティング サービスは、基本認証での偽装をサポートしません。  
+  
+ ルーティング サービスで ASP.NET の偽装を使用するには、サービス ホスティング環境で ASP.NET 互換モードを有効にします。  ルーティング サービスは既に ASP.NET 互換モードを許可するようにマークされているため、偽装が自動的に有効になります。  偽装は、ルーティング サービスとの ASP.NET 統合で唯一サポートされている用法です。  
+  
+ ルーティング サービスで Windows 資格情報の偽装を使用するには、資格情報とサービスの両方を構成する必要があります。  クライアント資格情報オブジェクト \(<xref:System.ServiceModel.ChannelFactory> からアクセス可能な <xref:System.ServiceModel.Security.WindowsClientCredential>\) は、<xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> プロパティを定義します。偽装を許可するには、このプロパティを設定する必要があります。  最後に、サービスで、<xref:System.ServiceModel.Description.ServiceAuthorization> 動作を構成して、`ImpersonateCallerForAllOperations` を `true` に設定する必要があります。  ルーティング サービスでは、偽装が有効になっているメッセージを転送するためのクライアントを作成するかどうかを、このフラグを使用して決定します。  
+  
+## 参照  
+ [メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)   
+ [ルーティング コントラクト](../../../../docs/framework/wcf/feature-details/routing-contracts.md)   
+ [フィルターの選択](../../../../docs/framework/wcf/feature-details/choosing-a-filter.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/routing-scenarios.md b/docs/framework/wcf/feature-details/routing-scenarios.md
new file mode 100644
index 00000000000..57775fb2d19
--- /dev/null
+++ b/docs/framework/wcf/feature-details/routing-scenarios.md
@@ -0,0 +1,87 @@
+---
+title: "ルーティング シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ルーティング [WCF], シナリオ"
+ms.assetid: ec22f308-665a-413e-9f94-7267cb665dab
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# ルーティング シナリオ
+ルーティング サービスは自由にカスタマイズできますが、まったく新しい構成を作成するときは、効率的なルーティング ロジックを設計するのが困難である場合があります。  しかし、ほとんどのルーティング サービスの構成で想定されている一般的なシナリオがいくつかあります。  これらのシナリオは、特定の構成に直接、適用できない場合もありますが、これらのシナリオに対応するルーティング サービスの構成方法を理解しておくことは、ルーティング サービスを理解する助けとなります。  
+  
+## 一般的なシナリオ  
+ ルーティング サービスの最も基本的な用法は、複数の送信先エンドポイントを集約してクライアント アプリケーションに公開するエンドポイントの数を減らし、その後にメッセージ フィルターを使用して、各メッセージを適切な送信先にルーティングすることです。  メッセージは、論理的または物理的な処理要件 \(特定のサービスで処理する必要がある種類のメッセージなど\)、または任意のビジネス ニーズ \(特定の送信元からのメッセージを優先的に処理するなど\) に基づいてルーティングされます。  次の表に、いくつかの一般的なシナリオと、それらが発生する場面の一覧を示します。  
+  
+|シナリオ|使用する状況|  
+|----------|------------|  
+|サービスのバージョン管理|サービスの複数のバージョンをサポートする必要がある、または更新されたサービスを将来配置する可能性がある場合|  
+|サービス データのパーティション分割|複数のホストにわたってサービスをパーティション分割する必要がある場合|  
+|動的な更新|変化するサービス展開に対処するために、実行時のルーティング ロジックを動的に再構成する必要がある場合|  
+|マルチキャスト|1 つのメッセージを複数のエンドポイントに送信する必要がある場合|  
+|プロトコル ブリッジ|1 つのトランスポート プロトコルでメッセージを受信し、その送信先エンドポイントで別のプロトコルが使用されている場合|  
+|エラー処理|ネットワーク障害と通信障害に対する回復力を提供する必要がある場合|  
+  
+> [!NOTE]
+>  ここに示したシナリオの多くは、特定のビジネス ニーズや処理要件に特化したものですが、実行時のルーティング ロジックの変更や、一時的なネットワーク障害および通信障害からの回復を可能にする、動的な更新のサポートの計画およびエラー処理の利用は、多くの場合、ベスト プラクティスと見なされます。  
+  
+### サービスのバージョン管理  
+ 新しいバージョンのサービスを導入するときは、多くの場合、すべてのクライアントが新しいサービスに移行するまで、以前のバージョンを保持することが必要になります。  これは、サービスが完了までに数日、数週間、または数か月にさえ及ぶ長期の処理になる場合に特に重要です。  この場合、通常は、以前のバージョンのサービスに対して元のエンドポイントを維持したままで、新しいサービスに対して新しいエンドポイント アドレスを実装する必要があります。  
+  
+ ルーティング サービスを使用することで、クライアント アプリケーションからメッセージを受信するための 1 つのエンドポイントを公開し、メッセージの内容に基づいて、各メッセージを適切なバージョンのサービスにルーティングできます。  最も基本的な実装には、メッセージを処理するサービスのバージョンを示すカスタム ヘッダーをメッセージに追加することが含まれます。  ルーティング サービスでは、各メッセージにカスタム ヘッダーがあるかどうかを確認し、メッセージを適切な送信先エンドポイントにルーティングするために XPathMessageFilter を使用できます。  
+  
+ サービスのバージョン管理構成を作成するために使用する手順については、「[サービスのバージョンを管理する方法](../../../../docs/framework/wcf/feature-details/how-to-service-versioning.md)」を参照してください。  XPathMessageFilter を使用し、カスタム ヘッダーに基づいてメッセージをルーティングする方法の例については、「[高度なフィルター](../../../../docs/framework/wcf/samples/advanced-filters.md)」のサンプルを参照してください。  
+  
+### サービス データのパーティション分割  
+ 分散環境を設計するときは、多くの場合、複数のコンピューターに処理負荷を分散することが望ましいとされています。これは、可用性を高め、個々のコンピューターの処理負荷を軽減し、メッセージの特定のサブセットに対して専用のリソースを提供するためです。  ルーティング サービスは負荷分散専用のソリューションに代わるものではありませんが、このサービスが内容に基づくルーティングを実施する機能は、特定の送信先に類似のメッセージをルーティングする方法として使用できます。  この例として、その他のクライアントから受信するメッセージとは別に、特定のクライアントからのメッセージを処理する必要がある場合が挙げられます。  
+  
+ サービス データのパーティション分割構成を作成するために使用する手順については、「[サービス データのパーティションを分割する方法](../../../../docs/framework/wcf/feature-details/how-to-service-data-partitioning.md)」を参照してください。  フィルターを使用し、URL およびカスタム ヘッダーに基づいてデータをパーティション分割する方法の例については、「[高度なフィルター](../../../../docs/framework/wcf/samples/advanced-filters.md)」のサンプルを参照してください。  
+  
+### 動的ルーティング  
+ 変化するビジネス ニーズを満たすために、ルーティング構成を変更した方がよい場合がよくあります。たとえば、新しいバージョンのサービスに対してルートを追加する、ルーティング条件を変更する、または、特定のメッセージに対してフィルターがルーティング先とする送信先エンドポイントを変更することが考えられます。  ルーティング サービスでは、<xref:System.ServiceModel.Routing.RoutingExtension> を使用して、新しい RoutingConfiguration を実行時に提供できるため、これが実現されます。  新しい構成は直ちに有効になりますが、ルーティング サービスで処理される任意の新しいセッションのみに適用されます。  
+  
+ 動的ルーティングの実装に使用する手順については、「[動的な更新を行う方法](../../../../docs/framework/wcf/feature-details/how-to-dynamic-update.md)」を参照してください。  動的ルーティングの使用方法の例については、「[動的再構成](../../../../docs/framework/wcf/samples/dynamic-reconfiguration.md)」のサンプルを参照してください。  
+  
+### マルチキャスト  
+ メッセージをルーティングするときに、通常は、各メッセージを 1 つの特定の送信先エンドポイントにルーティングします。  しかし、メッセージのコピーを複数の送信先エンドポイントにルーティングする必要がある場合もあります。  マルチキャスト ルーティングを実行するには、次の条件を満たしている必要があります。  
+  
+-   要求\/応答では、要求への応答時にクライアント アプリケーションが受信できるのが 1 つの応答のみであることが要求されるため、チャネル形状が要求\/応答でない \(一方向または二重のどちらでもよい\) ことが必要である。  
+  
+-   複数のフィルターは、メッセージの評価時に **true** を返す必要がある。  
+  
+ これらの条件を満たす場合、true を返すフィルターと関連付けられた各送信先エンドポイントは、メッセージのコピーを受信します。  
+  
+### プロトコル ブリッジ  
+ メッセージを異種の SOAP プロトコル間でルーティングするときに、ルーティング サービスは、WCF API を使用して、1 つのプロトコルから他のプロトコルにメッセージを変換します。  この処理は、ルーティング サービスが公開するサービス エンドポイントで、メッセージのルーティング先のクライアント エンドポイントとは異なるプロトコルが使用されると自動的に実行されます。  使用されているプロトコルが標準ではない場合は、この動作を無効にすることができますが、ブリッジのための独自のコードを提供する必要があります。  
+  
+ .  ルーティング サービスを使用してプロトコル間でメッセージを変換する方法の例については、「[ブリッジとエラー処理](../../../../docs/framework/wcf/samples/bridging-and-error-handling.md)」のサンプルを参照してください。  
+  
+### エラー処理  
+ 分散環境では、一時的なネットワークまたは通信の障害が発生することは少なくありません。  ルーティング サービスなどの中継局サービスがない場合は、このような障害処理の負担がクライアント アプリケーションにかかることになります。  ネットワークまたは通信の障害発生時に再試行するための特定のロジックと、代替の場所に関する情報がクライアント アプリケーションに含まれていない場合は、メッセージが送信先サービスで正常に処理されるまでに、ユーザーがメッセージを複数回送信することが必要になる可能性があります。  これは、信頼性が低いと見なされる可能性があるため、アプリケーションの顧客満足度の低下につながります。  
+  
+ ルーティング サービスは、ネットワークまたは通信関連の障害発生時のメッセージに対して堅牢なエラー処理機能を提供することで、このシナリオを対処しようとします。  可能な送信先エンドポイントのリストを作成し、このリストを各メッセージ フィルターと関連付けることで、設定可能な送信先が 1 つのみであるために発生する単一障害点を排除します。  障害が発生した場合、ルーティング サービスは、メッセージが配信されるか、通信以外の障害が発生するか、またはすべてのエンドポイントに対する試行が終わるまで、次のエンドポイントにメッセージを配信しようとします。  
+  
+ エラー処理の構成に使用する手順については、「[エラーを処理する方法](../../../../docs/framework/wcf/feature-details/how-to-error-handling.md)」を参照してください。  エラー処理の実装例については、「[ブリッジとエラー処理](../../../../docs/framework/wcf/samples/bridging-and-error-handling.md) および [高度なエラー処理](../../../../docs/framework/wcf/samples/advanced-error-handling.md)」のサンプルを参照してください。  
+  
+### このセクションの内容  
+ [サービスのバージョンを管理する方法](../../../../docs/framework/wcf/feature-details/how-to-service-versioning.md)  
+  
+ [サービス データのパーティションを分割する方法](../../../../docs/framework/wcf/feature-details/how-to-service-data-partitioning.md)  
+  
+ [動的な更新を行う方法](../../../../docs/framework/wcf/feature-details/how-to-dynamic-update.md)  
+  
+ [エラーを処理する方法](../../../../docs/framework/wcf/feature-details/how-to-error-handling.md)  
+  
+## 参照  
+ [ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/routing-service.md b/docs/framework/wcf/feature-details/routing-service.md
new file mode 100644
index 00000000000..0b89ee8c429
--- /dev/null
+++ b/docs/framework/wcf/feature-details/routing-service.md
@@ -0,0 +1,118 @@
+---
+title: "ルーティング サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca7c216a-5141-4132-8193-102c181d2eba
+caps.latest.revision: 13
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ルーティング サービス
+ルーティング サービスは、メッセージ ルーターとして機能する、汎用の SOAP 中継局です。  ルーティング サービスの主要な機能は、メッセージのコンテンツに基づいてメッセージをルーティングする機能です。これにより、メッセージのヘッダーまたはメッセージ本文内に含まれる値に基づいて、メッセージをクライアント エンドポイントに転送できます。  
+  
+ <xref:System.ServiceModel.Routing.RoutingService> は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスとして <xref:System.ServiceModel.Routing> 名前空間で実装されます。  ルーティング サービスは、メッセージを受信し、その内容に基づいて各メッセージを 1 つ以上のクライアント エンドポイントにルーティングする、1 つ以上のサービス エンドポイントを公開します。  このサービスには、次の機能が用意されています。  
+  
+-   コンテンツ ベースのルーティング  
+  
+    -   サービスの集計  
+  
+    -   サービスのバージョン管理  
+  
+    -   優先度ルーティング  
+  
+    -   動的構成  
+  
+-   プロトコル ブリッジ  
+  
+-   SOAP 処理  
+  
+-   高度なエラー処理  
+  
+-   バックアップ エンドポイント  
+  
+ 上記の機能の 1 つ以上を実現する中間サービスを作成することもできますが、このような実装では、特定のシナリオまたはソリューションに制限され、新しいアプリケーションにすぐに適用できません。  
+  
+ ルーティング サービスは、動的に構成できるプラグ可能な汎用の SOAP 中継局を提供します。この中継局は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスおよびチャネル モデルと互換性があり、SOAP ベースのメッセージのコンテンツ ベースのルーティングを実行できます。  
+  
+> [!NOTE]
+>  ルーティング サービスは、現在 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST サービスのルーティングをサポートしていません。  REST 呼び出しをルーティングする場合は、<xref:System.Web.Routing> または[アプリケーション要求ルーティング処理](http://go.microsoft.com/fwlink/?LinkId=164589) \(http:\/\/go.microsoft.com\/fwlink\/?LinkId\=164589\) を使用することを検討してください。  
+  
+## コンテンツ ベースのルーティング  
+ コンテンツ ベースのルーティングは、メッセージに含まれている 1 つ以上の値に基づいて、メッセージをルーティングする機能です。  ルーティング サービスでは、各メッセージを確認し、メッセージの内容と開発者が作成したルーティング ロジックに基づいて、送信先エンドポイントにメッセージをルーティングします。  コンテンツ ベースのルーティングは、サービス集計、サービスのバージョン管理、および優先度ルーティングの基礎になります。  
+  
+ コンテンツ ベースのルーティングを実装するために、ルーティング サービスは <xref:System.ServiceModel.Dispatcher.MessageFilter> 実装に依存しています。これらの実装は、ルーティングするメッセージ内の特定の値を照合するために使用されます。  **MessageFilter** が 1 つのメッセージと一致すると、そのメッセージは、**MessageFilter** と関連付けられている送信先エンドポイントにルーティングされます。  メッセージ フィルターはフィルター テーブル \(<xref:System.ServiceModel.Routing.Configuration.FilterTableCollection>\) にグループ化されて、複雑なルーティング ロジックを構築します。  たとえば、フィルター テーブルに 5 つの相互に排他的なメッセージ フィルターが含まれ、それによって、5 つの送信先エンドポイントのうちの 1 つだけにメッセージがルーティングされる場合があります。  
+  
+ ルーティング サービスを使用すると、コンテンツ ベースのルーティングの実行に使用するロジックを構成できるほか、ルーティング ロジックを実行時に動的に更新できます。  
+  
+ メッセージ フィルターをフィルター テーブルにグループ化することで、ルーティング ロジックを構築し、次のような複数のルーティング シナリオを処理できます。  
+  
+-   サービスの集計  
+  
+-   サービスのバージョン管理  
+  
+-   優先度ルーティング  
+  
+-   動的構成  
+  
+ メッセージ フィルターとフィルター テーブルの詳細については、「[ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)」および「[メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)」を参照してください。  
+  
+### サービスの集計  
+ コンテンツ ベースのルーティングを使用することで、外部のクライアント アプリケーションからメッセージを受信する 1 つのエンドポイントを公開し、メッセージ内の値に基づいて、各メッセージを適切な内部エンドポイントにルーティングできます。  これは、さまざまなバックエンド アプリケーションに対して単一のエンドポイントを提供する場合だけでなく、アプリケーションをさまざまなサービスにファクタリングしているときに単一のアプリケーション エンドポイントを顧客に提供する場合にも便利です。  
+  
+### サービスのバージョン管理  
+ ソリューションを新しいバージョンに移行するときに、既存の顧客に対応するために、古いバージョンを同時に維持する必要がある場合があります。  このような場合の多くでは、新しいバージョンに接続するクライアントが、ソリューションとの通信時に別のアドレスを使用することが必要になります。  ルーティング サービスを使用すると、メッセージに含まれるバージョン固有の情報に基づいて、適切なソリューションにメッセージをルーティングすることで、ソリューションの両方のバージョンに対応する単一のサービス エンドポイントを公開できます。  実装の例については、「[サービスのバージョンを管理する方法](../../../../docs/framework/wcf/feature-details/how-to-service-versioning.md)」を参照してください。  
+  
+### 優先度ルーティング  
+ サービスを複数のクライアントに提供するときに、パートナーとサービス レベル アグリーメント \(SLA\) を結び、それらのパートナーのデータをすべて、その他のクライアントのデータとは別に処理するように規定している場合があります。  メッセージに含まれる顧客固有の情報を検索するフィルターを使用すると、特定のパートナーから送られたメッセージを、各パートナーの SLA 要件に合わせて作成されたエンドポイントに容易にルーティングできます。  
+  
+## 動的構成  
+ サービスを中断させずにメッセージを処理する必要があるミッション クリティカルなシステムをサポートするには、システム内のコンポーネントの構成を実行時に変更できることが非常に重要です。  このニーズを満たすために、ルーティング サービスでは <xref:System.ServiceModel.IExtension%601> 実装が提供されています。これは、実行時にルーティング サービス構成を動的に更新できるようにする <xref:System.ServiceModel.Routing.RoutingExtension> です。  
+  
+ ルーティング サービスの動的構成の詳細については、「[ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)」を参照してください。  
+  
+## プロトコル ブリッジ  
+ 中継局シナリオの課題の 1 つは、内部エンドポイントとメッセージの送信先エンドポイントのトランスポートまたは SOAP バージョンの要件が異なる場合があることです。  このシナリオをサポートするために、ルーティング サービスでは、SOAP メッセージを送信先エンドポイントが必要とする <xref:System.ServiceModel.Channels.MessageVersion> に合わせて処理するなど、プロトコル間をブリッジできます。  これを利用して、内部の通信と外部の通信に別々のプロトコルを使用することができます。  
+  
+ 異なるトランスポートを持つエンドポイント間でのメッセージのルーティングをサポートするために、ルーティング サービスでは、サービスが複数の異なるプロトコルをブリッジできるようにする、システム指定のバインディングを使用します。  この処理は、ルーティング サービスが公開するサービス エンドポイントで、メッセージのルーティング先のクライアント エンドポイントとは異なるプロトコルが使用されると、自動的に実行されます。  
+  
+## SOAP 処理  
+ 一般的なルーティング要件は、異なる SOAP 要件を持つエンドポイント間でメッセージをルーティングできることです。  この要件を満たすために、ルーティング サービスでは <xref:System.ServiceModel.Routing.SoapProcessingBehavior> が提供されます。これにより、送信先エンドポイントにメッセージがルーティングされる前に、送信先エンドポイントの要件を満たす新しい **MessageVersion** が自動的に作成されます。  この動作では、要求元のクライアント アプリケーションに応答メッセージを返す前に、その応答メッセージ用の新しい **MessageVersion** も作成されます。これによって、応答の **MessageVersion** が、元の要求のものと一致するようになります。  
+  
+ SOAP 処理の詳細については、「[ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)」を参照してください。  
+  
+## エラー処理  
+ システムを構成する分散サービスがネットワーク通信に依存する場合は、システム内の通信が、一時的なネットワーク障害に対応可能である必要があります。  ルーティング サービスはエラー処理を実装しており、これによって、サービスの停止を招く可能性がある多くの通信障害を処理できます。  
+  
+ ルーティング サービスがメッセージを送信している間に <xref:System.ServiceModel.CommunicationException> が発生した場合は、エラー処理が実行されます。  これらの例外は、一般的に、<xref:System.ServiceModel.EndpointNotFoundException>、<xref:System.ServiceModel.ServerTooBusyException>、<xref:System.ServiceModel.CommunicationObjectFaultedException> など、定義されているクライアント エンドポイントとの通信を試みている間に問題が発生したことを示します。  また、エラー処理コードは、**TimeoutException** が発生すると、それをキャッチして再送信を試みます。この例外も、**CommunicationException** からは派生していない、一般的な例外です。  
+  
+ エラー処理[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)」を参照してください。  
+  
+## バックアップ エンドポイント  
+ フィルター テーブル内の各フィルター定義と関連付けられる送信先クライアント エンドポイントに加えて、転送エラーが発生した場合にメッセージをルーティングする、バックアップ エンドポイントのリストも作成できます。  エラーが発生した場合に、フィルター エントリのバックアップ リストが定義されていると、ルーティング サービスにより、そのリストに定義されている最初のエンドポイントにメッセージが送信されます。  この送信に失敗した場合は、送信に成功する、送信失敗に関連しないエラーが返される、またはバックアップ リスト内のすべてのエンドポイントで送信エラーが返されるまで、次のエンドポイントへの送信が試みられます。  
+  
+ バックアップ エンドポイント[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)」および「[メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)」を参照してください。  
+  
+## ストリーム  
+ バインディングがストリーミングをサポートするように設定すると、ルーティング サービスはメッセージを正常にストリーミングできます。  ただし、メッセージのバッファーが必要となる可能性のある条件がいくつかあります。  
+  
+-   マルチキャスト \(追加のメッセージ コピーを作成するためのバッファー\)  
+  
+-   フェールオーバー \(メッセージがバックアップに送信される必要がある場合のバッファー\)  
+  
+-   System.ServiceModel.Routing.RoutingConfiguration.RouteOnHeadersOnly は false です \(フィルターが本文を検査できるように MessageBuffer と共に MessageFilterTable を示すバッファー\)  
+  
+-   動的構成  
+  
+## 参照  
+ [ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)   
+ [ルーティング コントラクト](../../../../docs/framework/wcf/feature-details/routing-contracts.md)   
+ [メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/routing.md b/docs/framework/wcf/feature-details/routing.md
new file mode 100644
index 00000000000..cd156c8de9e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/routing.md
@@ -0,0 +1,43 @@
+---
+title: "ルーティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ルーティング [WCF]"
+  - "WCF [WCF], ルーティング"
+  - "Windows Communication Foundation [WCF], ルーティング"
+ms.assetid: bd56516c-420d-4c4e-97f9-f72d28d149a9
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# ルーティング
+このセクションのトピックでは、ルーティング サービスについて説明します。  ルーティング サービスは、構成可能な汎用の SOAP 中継局です。ルーティング サービスを使用すると、コンテンツ ベースのルーティングの構成、プロトコル ブリッジの設定、通信エラーの処理、および実行時のルーティング ロジックの動的な更新が可能となります。  
+  
+## このセクションの内容  
+ [ルーティング サービス](../../../../docs/framework/wcf/feature-details/routing-service.md)  
+ ルーティング サービスの機能について概説します。  
+  
+ [Routing Service](http://msdn.microsoft.com/ja-jp/5ac8718c-bcef-456f-bfd5-1e60a30d6eaa)  
+ ルーティング サービスの機能について説明します。  
+  
+ [ルーティングの概要](../../../../docs/framework/wcf/feature-details/routing-introduction.md)  
+ ルーティング サービスの機能について説明します。  
+  
+ [ルーティング コントラクト](../../../../docs/framework/wcf/feature-details/routing-contracts.md)  
+ ルーティング サービスが処理できるメッセージ パターンについて説明します。  
+  
+ [メッセージ フィルター](../../../../docs/framework/wcf/feature-details/message-filters.md)  
+ メッセージ フィルターのコンテンツ ベースのルーティングへの使用方法を説明します。  
+  
+ [ルーティング シナリオ](../../../../docs/framework/wcf/feature-details/routing-scenarios.md)  
+ 共通のルーティング シナリオについて説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/saml-tokens-and-claims.md b/docs/framework/wcf/feature-details/saml-tokens-and-claims.md
new file mode 100644
index 00000000000..c2f08d247c5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/saml-tokens-and-claims.md
@@ -0,0 +1,59 @@
+---
+title: "SAML トークンとクレーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フェデレーション"
+  - "発行済みトークン"
+  - "SAML トークン"
+  - "WCF, フェデレーション"
+ms.assetid: 930b6e34-9eab-4e95-826c-4e06659bb977
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# SAML トークンとクレーム
+SAML \(Security Assertion Markup Language\) *トークン*は、クレームの XML 表現です。既定では、フェデレーション セキュリティ シナリオで [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が使用する SAML トークンは、*"発行済みトークン"* です。  
+  
+ SAML トークンは、ステートメント \(特定のエンティティによって他のエンティティに関して作成されるクレームのセット\) を伝達します。たとえば、フェデレーション セキュリティ シナリオでは、ステートメントがセキュリティ トークン サービスによって、システム内の特定のユーザーに関して作成されます。セキュリティ トークン サービスは、トークンに含まれるステートメントの信憑性を示すために SAML トークンに署名します。また、SAML トークンは、SAML トークンのユーザーが証明として提示する暗号化キー マテリアルに関連付けられています。これが証拠となり、証明書利用者は、SAML トークンが実際にそのユーザーに対して発行されたことを確認できます。一般的なシナリオでの例を次に示します。  
+  
+1.  クライアントは、セキュリティ トークン サービスから SAML トークンを要求し、Windows 資格情報を使用して、そのセキュリティ トークン サービスに対して認証を行います。  
+  
+2.  セキュリティ トークン サービスは、SAML トークンをクライアントに発行します。SAML トークンは、セキュリティ トークン サービスに関連付けられた証明書を使用して署名され、ターゲット サービス用に暗号化された証明キーを含んでいます。  
+  
+3.  クライアントは、*証明キー*のコピーも受け取ります。クライアントは、発行された SAML トークンをアプリケーション サービス \(*証明書利用者*\) に提示し、証明キーを使用してメッセージに署名します。  
+  
+4.  SAML トークンの署名は、そのトークンがセキュリティ トークン サービスによって発行されたことを証明書利用者に示します。また、証明キーを使用して作成されたメッセージ署名は、トークンがそのクライアントに対して発行されたことを示します。  
+  
+## クレームから SamlAttributes  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、SAML トークン内のステートメントは <xref:System.IdentityModel.Tokens.SamlAttribute> オブジェクトとしてモデル化されています。<xref:System.IdentityModel.Claims.Claim> オブジェクトが <xref:System.IdentityModel.Claims.Rights.PossessProperty%2A> の <xref:System.IdentityModel.Claims.Claim.Right%2A> プロパティを持ち、<xref:System.IdentityModel.Claims.Claim.Resource%2A> プロパティが <xref:System.String> 型である場合、このオブジェクトは <xref:System.IdentityModel.Claims.Claim> オブジェクトから直接設定できます。次に例を示します。  
+  
+ [!code-csharp[c_CreateSTS#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_creatests/cs/source.cs#8)]
+ [!code-vb[c_CreateSTS#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_creatests/vb/source.vb#8)]  
+  
+> [!NOTE]
+>  セキュリティ トークン サービスによって発行されたか、または認証の一部としてクライアントからサービスに提示されたときに、SAML トークンがメッセージ内にシリアル化される場合、メッセージの最大クォータ サイズが、SAML トークンおよびメッセージの他の部分を格納できるだけの大きさである必要があります。通常は、既定のメッセージ クォータ サイズで十分です。ただし、何百ものクレームを含んでいるために SAML トークンのサイズが大きい場合には、シリアル化されたトークンを格納できるように、クォータを増やす必要が生じることがあります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md).  
+  
+## SamlAttributes からクレーム  
+ SAML トークンがメッセージで受信されると、SAML トークン内のさまざまなステートメントは、<xref:System.IdentityModel.Policy.IAuthorizationPolicy> オブジェクトに変換され、<xref:System.IdentityModel.Policy.AuthorizationContext> に配置されます。各 SAML ステートメントのクレームは <xref:System.IdentityModel.Policy.AuthorizationContext> の <xref:System.IdentityModel.Policy.AuthorizationContext.ClaimSets%2A> プロパティによって返され、これを調べることによってユーザーの認証と承認を行うかどうかを決定できます。  
+  
+## 参照  
+ <xref:System.IdentityModel.Policy.AuthorizationContext>   
+ <xref:System.IdentityModel.Policy.IAuthorizationPolicy>   
+ <xref:System.IdentityModel.Claims.ClaimSet>   
+ [フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)   
+ [方法 : フェデレーション クライアントを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-federated-client.md)   
+ [方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)   
+ [ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)   
+ [クレームとトークン](../../../../docs/framework/wcf/feature-details/claims-and-tokens.md)   
+ [クレームの作成とリソース値](../../../../docs/framework/wcf/feature-details/claim-creation-and-resource-values.md)   
+ [方法 : カスタム クレームを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-custom-claim.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/schema-import-and-export.md b/docs/framework/wcf/feature-details/schema-import-and-export.md
new file mode 100644
index 00000000000..133bc4bbf9f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/schema-import-and-export.md
@@ -0,0 +1,71 @@
+---
+title: "スキーマのインポートとエクスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, スキーマのインポートとエクスポート"
+  - "XsdDataContractExporter クラス"
+  - "XsdDataContractImporter クラス"
+ms.assetid: 0da32b50-ccd9-463a-844c-7fe803d3bf44
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# スキーマのインポートとエクスポート
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]新しいシリアル化エンジンが含まれています、 <xref:System.Runtime.Serialization.DataContractSerializer>します。 `DataContractSerializer` は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトと XML を双方向で変換します。 このシリアライザー自体の他に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、関連するスキーマ インポート機構とスキーマ エクスポート機構が用意されています。 *スキーマ*シリアライザーが生成するか、デシリアライザーがアクセスできる、または XML の形状の正式かつ正確であり、コンピューターが認識できる説明を示します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、多数のサードパーティ プラットフォームとの広範な相互運用性を持つ W3C (World Wide Web Consortium) XML スキーマ定義言語 (XSD: XML Schema Definition Language) をスキーマ表現として使用します。  
+  
+ スキーマ インポート コンポーネント<xref:System.Runtime.Serialization.XsdDataContractImporter>、XSD スキーマ ドキュメントを取得、および生成[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]クラス (通常、データ コントラクト クラス) をシリアル化された形式が特定のスキーマに対応するようにします。  
+  
+ たとえば、次のスキーマ フラグメントがあるとします。  
+  
+ [!code-csharp[c_SchemaImportExport#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#8)]
+ [!code-vb[c_SchemaImportExport#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#8)]  
+  
+ これは、読みやすいように、やや簡素化された次の型を生成します。  
+  
+ [!code-csharp[c_SchemaImportExport#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_schemaimportexport/cs/source.cs#1)]
+ [!code-vb[c_SchemaImportExport#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_schemaimportexport/vb/source.vb#1)]  
+  
+ 生成された型がいくつかのデータ コントラクトのベスト プラクティスを準拠していることに注意してください (で見つかった[ベスト プラクティス: データ コントラクトのバージョン管理](../../../../docs/framework/wcf/best-practices-data-contract-versioning.md))。  
+  
+-   型が実装、 <xref:System.Runtime.Serialization.IExtensibleDataObject>インターフェイスです。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)します。  
+  
+-   データ メンバーは、プライベート フィールドをラップするパブリック プロパティとして実装されます。  
+  
+-   クラスは部分クラスであり、生成されたコードを変更せずに追加を行うことができます。  
+  
+ <xref:System.Runtime.Serialization.XsdDataContractExporter>逆を行うことができます-によってシリアル化できる型を受け取る、 `DataContractSerializer` XSD スキーマ ドキュメントを生成します。  
+  
+## <a name="fidelity-is-not-guaranteed"></a>忠実性は保証されない  
+ スキーマや型のラウンド トリップでの完全な忠実性は保証されません  (A*ラウンド トリップ*クラスのセットを作成し、もう一度スキーマを作成する結果をエクスポートするスキーマをインポートすることを意味します)。同じスキーマが返されない場合があります。 また、これとは逆のプロセスでも忠実性は保証されません  (スキーマを生成する型をエクスポートしてから、型をインポートし直す場合です。 この場合も、同じ型が返されない可能性があります)。  
+  
+## <a name="supported-types"></a>サポートされている型  
+ データ コントラクト モデルは、WC3 スキーマの限られたサブセットしかサポートしません。 このサブセットに準拠しないスキーマを使用すると、インポート プロセスで例外が発生します。 たとえば、データ コントラクトのデータ メンバーを XML 属性としてシリアル化するように指定することはできません。 したがって、XML 属性を使用する必要があるスキーマはサポートされず、適切な XML 投影を持つデータ コントラクトを生成できないため、インポート時に例外が発生します。  
+  
+ たとえば、次のスキーマ フラグメントは、既定のインポート設定を使用してインポートすることはできません。  
+  
+ [!code[c_SchemaImportExport#9](../../../../samples/snippets/common/VS_Snippets_CFX/c_schemaimportexport/common/source.config#9)]  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクト スキーマ リファレンス](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)します。 スキーマがデータ コントラクト ルールに準拠していない場合は、別のシリアル化エンジンを使用します。 たとえば、 <xref:System.Xml.Serialization.XmlSerializer>独自のスキーマ インポート機構を使用します。 また、サポートされるスキーマの範囲を拡張する特別なインポート モードもあります。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]生成に関するセクション<xref:System.Xml.Serialization.IXmlSerializable>型[クラスを生成するには、スキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)します。  
+  
+ `XsdDataContractExporter` は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] によってシリアル化できるすべての `DataContractSerializer` 型をサポートします。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)します。 使用して作成されたそのスキーマ、`XsdDataContractExporter`通常有効なデータを`XsdDataContractImporter`使用できます (しない限り、 <xref:System.Xml.Serialization.XmlSchemaProviderAttribute>スキーマをカスタマイズするために使用)。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]使用して、 <xref:System.Runtime.Serialization.XsdDataContractImporter>を参照してください[クラスを生成するには、スキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)します。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]使用して、 <xref:System.Runtime.Serialization.XsdDataContractExporter>を参照してください[クラスからのスキーマのエクスポート](../../../../docs/framework/wcf/feature-details/exporting-schemas-from-classes.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.XsdDataContractImporter>   
+ <xref:System.Runtime.Serialization.XsdDataContractExporter>   
+ [クラスを生成するスキーマをインポートします。](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)   
+ [クラスからのスキーマのエクスポート](../../../../docs/framework/wcf/feature-details/exporting-schemas-from-classes.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md b/docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md
new file mode 100644
index 00000000000..a55bc08aab7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md
@@ -0,0 +1,28 @@
+---
+title: "セキュリティ保護されたメッセージ交換とセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48cb104a-532d-40ae-aa57-769dae103fda
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# セキュリティ保護されたメッセージ交換とセッション
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の特徴の 1 つは、相互に認証を行い暗号化とデジタル署名のプロセスについて同意する、2 つのエンドポイント間でのセキュリティ保護されたセッションを確立する機能にあります。たとえば、サービス エンドポイントは、クライアント エンドポイントに対して認証のために X.509 証明書に基づいたセキュリティ トークンを送信するよう要求する場合があります。クライアントの認証が終わると、サービス エンドポイントはセキュリティ コンテキスト トークン \(SCT: Security Context Token\) をクライアントに返します。このセッションにおける後続のすべてのメッセージは、このセキュリティ トークンを使用してセキュリティ保護されます。セキュリティで保護されたセッションが確立されると、SCT には対称キーが含まれるため、2 つのエンドポイント間で交換される一連のメッセージの効率が向上します。X.509 証明書の基盤となる非対称キーでは、デジタル署名の生成やデータの暗号化を行う場合に、対称キーに比べて非常に大きな計算能力が必要になります。  
+  
+ [WS\-SecurityPolicy](http://go.microsoft.com/fwlink/?LinkId=99817) 標準の 6.2.7 節で定義されているブートストラップ ポリシーには、チャネルをセキュリティで保護し、クライアントを RST\/SCT および RSTR\/SCT 交換よりも前に認証するために使用されるメッセージ セキュリティ アサーションが含まれます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の標準バインディングの中には、セキュリティで保護されたメッセージ交換を使用するかどうかを制御する `Security.Message.EstablishSecurityContext` プロパティを持つものがあります。カスタム バインディングを使用する場合、ブートストラップは、構成ファイル内の [\<secureConversationBootstrap\>](../../../../docs/framework/configure-apps/file-schema/wcf/secureconversationbootstrap.md)、またはコードからの <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSecureConversationBindingElement%2A>の呼び出しを介して、セキュリティ バインド要素を入れ子構造にすることによって示されます。  
+  
+ セッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セッションの使用](../../../../docs/framework/wcf/using-sessions.md)」を参照してください。  
+  
+## 参照  
+ [セッション、インスタンス化、および同時実行](../../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)   
+ [方法 : セッションを必要とするサービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/secure-sessions.md b/docs/framework/wcf/feature-details/secure-sessions.md
new file mode 100644
index 00000000000..02633174a37
--- /dev/null
+++ b/docs/framework/wcf/feature-details/secure-sessions.md
@@ -0,0 +1,47 @@
+---
+title: "セキュリティで保護されたセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7b50602f-d7b5-42e9-8e92-1f0413df0d8b
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# セキュリティで保護されたセッション
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の機能の 1 つに、送信された順序でメッセージが受信されることを保証する "信頼できるセッション" があります。このセクションの各トピックでは、信頼できるセッションを作成する際に考慮する必要のあるセキュリティへの影響について説明します。信頼できるセッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セッションの使用](../../../../docs/framework/wcf/using-sessions.md)」を参照してください。  
+  
+> [!NOTE]
+>  Windows XP で偽装が必要な場合は、ステートフルなセキュリティ コンテキスト トークン \(SCT: Security Context Token\) を使用しない、セキュリティで保護されたセッションを使用します。ステートフル SCT が偽装と共に使用されると、<xref:System.InvalidOperationException> がスローされます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md).  
+  
+## このセクションの内容  
+  
+|||  
+|-|-|  
+|[セキュリティ保護されたメッセージ交換とセッション](../../../../docs/framework/wcf/feature-details/secure-conversations-and-secure-sessions.md)|セキュリティで保護されたメッセージ交換とセキュリティで保護されたセッションは、同じ意味で使用されます。ここでは、セキュリティで保護されたメッセージ交換のしくみ、およびこのパターンを使用する状況と理由について説明します。|  
+|[方法 : セキュリティで保護されたセッションを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-secure-session.md)|セキュリティで保護されたセッションの基本的な作成手順を説明するチュートリアルです。|  
+|[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)|クライアントの状態とセッションを保持する Web ファームを作成する手順について説明します。|  
+|[セキュリティで保護されたセッションに関するセキュリティの検討](../../../../docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md)|セキュリティで保護されたセッションに関する特別な考慮事項について説明します。|  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+## 関連項目  
+ [セッション、インスタンス化、および同時実行](../../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)  
+  
+ [サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md)  
+  
+## 参照  
+ [方法 : メッセージ リプレイ検出を有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-message-replay-detection.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)   
+ [方法 : セッションを必要とするサービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/securing-messages-using-message-security.md b/docs/framework/wcf/feature-details/securing-messages-using-message-security.md
new file mode 100644
index 00000000000..7aeeef328f9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/securing-messages-using-message-security.md
@@ -0,0 +1,77 @@
+---
+title: "メッセージ セキュリティを使用したメッセージのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a17ebe67-836b-4c52-9a81-2c3d58e225ee
+caps.latest.revision: 16
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 16
+---
+# メッセージ セキュリティを使用したメッセージのセキュリティ保護
+ここでは、<xref:System.ServiceModel.NetMsmqBinding> を使用した場合の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ セキュリティについて説明します。  
+  
+> [!NOTE]
+>  このトピックに進む前に、「[セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)」に目を通すことをお勧めします。  
+  
+ 次の図は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する、キューに置かれた通信の概念モデルを表したものです。この図および用語を使用して、トランスポート セキュリティの  
+  
+ 概念について解説します。  
+  
+ ![キューに置かれたアプリケーションの図](../../../../docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg "Distributed\-Queue\-Figure")  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用してキューに置かれたメッセージを送信すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージはメッセージ キュー \(MSMQ\) メッセージの本文として添付されます。トランスポート セキュリティが MSMQ メッセージ全体を保護するのに対し、メッセージ \(SOAP\) セキュリティは MSMQ メッセージの本文だけを保護します。  
+  
+ メッセージ セキュリティの重要な概念は、クライアントが受信側アプリケーション \(サービス\) のメッセージを保護する点にあります。これは、クライアントがターゲット キューのメッセージを保護するトランスポート セキュリティとは異なります。したがって、メッセージ セキュリティを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージを保護する場合、MSMQ は何の役割も果たしません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ セキュリティでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージにセキュリティ ヘッダーが追加されます。これは、既存のセキュリティ インフラストラクチャ \(証明書や Kerberos プロトコルなど\) と統合されます。  
+  
+## メッセージ資格情報の種類  
+ メッセージ セキュリティを使用すると、サービスとクライアントは、資格情報を提示して相互を認証します。メッセージ セキュリティを選択するには、<xref:System.ServiceModel.NetMsmqBinding.Security%2A> モードを `Message` または `Both` \(トランスポート セキュリティとメッセージ セキュリティの両方を使用\) に設定します。  
+  
+ サービスは、<xref:System.ServiceModel.ServiceSecurityContext.Current%2A> プロパティを使用して、クライアントを認証するために使用される資格情報を検査できます。このプロパティを使用して承認チェックも追加できますが、これを実装するかどうかはサービスで選択します。  
+  
+ ここでは、さまざまな資格情報の種類およびそれらをキューで使用する方法について説明します。  
+  
+### 証明書  
+ 資格情報の種類に証明書を設定すると、X509 証明書を使用してサービスとクライアントが識別されます。  
+  
+ 一般的なシナリオでは、信頼された証明機関によってクライアントとサービスに有効な証明書が発行されます。その後、接続が確立され、クライアントは、サービスの証明書を使用してサービスの有効性を確認することにより、サービスを信頼できるかどうかを判断します。同様に、サービスは、クライアントの証明書を使用してクライアントの信頼性を検証します。  
+  
+ キューは切断されているため、クライアントとサービスが同時にオンライン状態にならない可能性があります。したがって、クライアントとサービスは、帯域外で証明書を交換する必要があります。特にクライアントは、信頼されたストア内にサービスの証明書 \(証明機関にチェーンできる\) を保持しているという理由で、正しいサービスと通信していることを信じる必要があります。クライアントを認証する場合、サービスはメッセージに添付された X509 証明書を使用し、ストア内の証明書と照合してクライアントの信頼性を確認します。この場合も、証明書は証明機関にチェーンされている必要があります。  
+  
+ Windows を実行しているコンピューターでは、証明書は数種類のストアで保持されています。各種ストア[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書ストア](http://go.microsoft.com/fwlink/?LinkId=87787)」を参照してください。  
+  
+### Windows  
+ メッセージ資格情報の種類に Windows を設定すると、Kerberos プロトコルが使用されます。  
+  
+ Kerberos プロトコルは、ドメインのユーザーを認証するためのセキュリティ機構で、認証済みユーザーは、ドメインの他のエンティティとの間にセキュリティで保護されたコンテキストを確立できます。  
+  
+ キューを使用した通信で Kerberos プロトコルを使用する場合の問題は、キー配布センター \(KDC\) が配布するクライアント ID を含むチケットの有効期間が比較的短いことです。Kerberos チケットには、そのチケットの有効性を示す*有効期間*が関連付けられています。そのため、遅延が大きい場合、クライアントを認証するサービスに対してトークンがまだ有効であるかどうかを確信できなくなります。  
+  
+ この種類の資格情報を使用する場合、SERVICE アカウントでサービスが実行されている必要があります。  
+  
+ メッセージ資格情報を選択すると、既定で Kerberos プロトコルが使用されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[Exploring Kerberos, the Protocol for Distributed Security in Windows 2000](http://go.microsoft.com/fwlink/?LinkId=87790)」を参照してください。  
+  
+### ユーザー名とパスワード  
+ このプロパティを使用すると、クライアントは、メッセージのセキュリティ ヘッダーに含まれるユーザー名とパスワードを使用してサーバーに認証できます。  
+  
+### IssuedToken  
+ クライアントは、セキュリティ トークン サービスを使用してトークンを発行できます。発行されたトークンをサービスへのメッセージに添付することで、クライアントが認証されます。  
+  
+## トランスポート セキュリティとメッセージ セキュリティの使用  
+ トランスポート セキュリティとメッセージ セキュリティの両方を使用する場合は、トランスポート レベルと SOAP メッセージ レベルの両方で同じ証明書を使用してメッセージを保護する必要があります。  
+  
+## 参照  
+ [トランスポート セキュリティを使用したメッセージのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-messages-using-transport-security.md)   
+ [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)   
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/securing-messages-using-transport-security.md b/docs/framework/wcf/feature-details/securing-messages-using-transport-security.md
new file mode 100644
index 00000000000..05f0ef5f0cc
--- /dev/null
+++ b/docs/framework/wcf/feature-details/securing-messages-using-transport-security.md
@@ -0,0 +1,109 @@
+---
+title: "トランスポート セキュリティを使用したメッセージのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9029771a-097e-448a-a13a-55d2878330b8
+caps.latest.revision: 21
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 21
+---
+# トランスポート セキュリティを使用したメッセージのセキュリティ保護
+ここでは、キューに送信されるメッセージをセキュリティで保護するために使用できるメッセージ キュー \(MSMQ\) トランスポート セキュリティについて説明します。  
+  
+> [!NOTE]
+>  このトピックに進む前に、「[セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)」に目を通すことをお勧めします。  
+  
+ 次の図は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用する、キューに置かれた通信の概念モデルを表したものです。この図および用語を使用して、トランスポート セキュリティの概念について解説します。  
+  
+ ![キューに置かれたアプリケーションの図](../../../../docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg "Distributed\-Queue\-Figure")  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と <xref:System.ServiceModel.NetMsmqBinding> を使用してキューに置かれたメッセージを送信すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージは MSMQ メッセージの本文として添付されます。トランスポート セキュリティは、MSMQ メッセージ全体 \(MSMQ メッセージ ヘッダーまたはプロパティ、およびメッセージ本文\) をセキュリティで保護します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージは MSMQ メッセージの本文であるために、このメッセージもトランスポート セキュリティで保護されます。  
+  
+ トランスポート セキュリティの背後にある重要な概念は、メッセージがターゲット キューに到達するためには、クライアントがセキュリティ要件を満たす必要があるという点です。これは、メッセージ セキュリティとは異なります。メッセージ セキュリティでは、メッセージを受信するアプリケーションに対してメッセージが保護されます。  
+  
+ <xref:System.ServiceModel.NetMsmqBinding> と <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を使用するトランスポート セキュリティは、転送キューとターゲット キュー間を移動している MSMQ メッセージがセキュリティで保護される方法に影響します。この場合、"セキュリティで保護される" とは次のことを意味します。  
+  
+-   メッセージが改ざんされないように、メッセージに署名する。  
+  
+-   メッセージが読み取られたり、改ざんされたりしないしないように、メッセージを暗号化する。これは推奨事項ですが、必須ではありません。  
+  
+-   否認防止のため、ターゲット キュー マネージャーがメッセージの送信者を識別する。  
+  
+ MSMQ では、認証とは別に、ターゲット キューがアクセス制御リスト \(ACL: Access Control List\) を持っており、これで、ターゲット キューにメッセージを送信するためのアクセス許可がクライアントに与えられているどうかをチェックします。ターゲット キューからメッセージを受信するためのアクセス許可があるかどうかのチェックは、受信側のアプリケーションに対しても行われます。  
+  
+## WCF MSMQ トランスポート セキュリティのプロパティ  
+ MSMQ では、Windows セキュリティを使用して認証を行います。Windows セキュリティは、Windows セキュリティ識別子 \(SID: Security Identifier\) を使用してクライアントを識別し、クライアントの認証時に、証明機関として Active Directory ディレクトリ サービスを使用します。このため、MSMQ を Active Directory 統合と共にインストールする必要があります。クライアントの識別には Windows ドメインの SID が使用されるため、このセキュリティ オプションは、クライアントとサービスの両方が同じ Windows ドメインに属している場合にのみ有効です。  
+  
+ また、MSMQ は、Active Directory に登録されていないメッセージに証明書を添付する機能も提供します。この場合は、添付された証明書を使用してメッセージが署名されたことが保証されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、両方のオプションが MSMQ トランスポート セキュリティの一部として提供されます。これらのオプションは、トランスポート セキュリティの中核です。  
+  
+ 既定では、トランスポート セキュリティが有効になります。  
+  
+ これらの基本事項に基づいて、以降のセクションでは <xref:System.ServiceModel.NetMsmqBinding> および <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> に結び付けられたトランスポート セキュリティのプロパティについて詳しく説明します。  
+  
+#### MSMQ 認証モード  
+ <xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> は、Windows ドメインのセキュリティと外部の証明書ベースのセキュリティのどちらを使用してメッセージを保護するかを決定します。どちらの認証モードでも、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューに置かれたトランスポート チャネルは、サービス構成で指定された `CertificateValidationMode` を使用します。証明書検証モードは、証明書の有効性を確認するために使用される機構を指定します。  
+  
+ トランスポート セキュリティが有効になっている場合、既定の設定は <xref:System.ServiceModel.MsmqAuthenticationMode> です。  
+  
+#### Windows ドメイン認証モード  
+ Windows セキュリティを選択した場合は、Active Directory 統合をインストールする必要があります。既定のトランスポート セキュリティ モードは <xref:System.ServiceModel.MsmqAuthenticationMode> です。このモードを設定すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルは MSMQ メッセージに Windows SID を添付し、Active Directory から取得した内部証明書を使用します。MSMQ は、この内部証明書を使用してメッセージをセキュリティで保護します。受信側キュー マネージャーは、Active Directory を使用して一致する証明書を検索し、クライアントを認証します。また、SID がクライアントの SID と一致するかどうかをチェックします。この認証手順は、認証を要求するようにターゲット キューがマークされていない場合でも、内部的 \(`WindowsDomain` 認証モードの場合\) または外部的 \(`Certificate` 認証モードの場合\) に生成された証明書がメッセージに添付されているときに実行されます。  
+  
+> [!NOTE]
+>  キューを作成する際に認証キューとしてマークすることにより、そのキューにメッセージを送信するクライアントに対して認証を求めることができます。これにより、認証されたメッセージだけをキューに受け入れることができます。  
+  
+ また、メッセージに添付された SID は、キューにメッセージを送信する権限をクライアントが持つことを確認するためにターゲット キューの ACL をチェックする目的でも使用されます。  
+  
+#### 証明書認証モード  
+ 証明書認証モードを選択した場合は、Active Directory 統合をインストールする必要がありません。実際、\(Active Directory 統合をインストールせずに\) MSMQ をワークグループ モードでインストールしている場合や、SOAP リライアブル メッセージ プロトコル \(SRMP: SOAP Reliable Messaging Protocol\) 転送プロトコルを使用してメッセージをキューに送信する場合など、<xref:System.ServiceModel.MsmqAuthenticationMode> だけが機能するというケースもあります。  
+  
+ <xref:System.ServiceModel.MsmqAuthenticationMode> を使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージを送信した場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルは Windows SID を MSMQ メッセージに添付しません。そのため、ターゲット キューの ACL は、キューへの送信に対して `Anonymous` ユーザー アクセスを許可する必要があります。受信側キュー マネージャーは、証明書を使用して MSMQ メッセージが署名されたかどうかをチェックしますが、認証は行いません。  
+  
+ クレームと ID 情報を持つ証明書は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のキューに置かれたトランスポート チャネルによって <xref:System.ServiceModel.ServiceSecurityContext> 内に設定されます。サービスは、この情報を使用して独自の方式で送信者の認証を行います。  
+  
+### MSMQ の保護レベル  
+ 保護レベルは、MSMQ メッセージが改ざんされないように MSMQ メッセージを保護する方法を決定します。これは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> プロパティで指定します。既定値は、<xref:System.Net.Security.ProtectionLevel> です。  
+  
+#### 署名による保護レベル  
+ MSMQ メッセージでは、`WindowsDomain` 認証モードを使用する場合は内部生成された証明書を使用して署名され、`Certificate` 認証モードを使用する場合は、外部生成された証明書を使用して署名されます。  
+  
+#### 署名と暗号化による保護レベル  
+ MSMQ メッセージでは、`WindowsDomain` 認証モードを使用する場合は内部生成された証明書を使用して署名され、`Certificate` 認証モードを使用する場合は、外部生成された証明書を使用して署名されます。  
+  
+ メッセージの署名に加えて、MSMQ メッセージは、ターゲット キューをホストする受信側キュー マネージャーに属する Active Directory から取得した証明書の公開キーを使用して暗号化されます。送信側キュー マネージャーは、MSMQ メッセージが送信時に暗号化されているかどうかを確認します。受信側キュー マネージャーは、内部証明書の秘密キーを使用して MSMQ メッセージを復号化し、クリア テキストでメッセージをキューに格納します \(認証と承認が完了している場合\)。  
+  
+> [!NOTE]
+>  メッセージを暗号化するには、Active Directory にアクセスでき \(<xref:System.ServiceModel.NetMsmqBinding> の `UseActiveDirectory` プロパティが `true` に設定されている\)、かつ <xref:System.ServiceModel.MsmqAuthenticationMode> と <xref:System.ServiceModel.MsmqAuthenticationMode> の両方で Active Directory を使用できる必要があります。  
+  
+#### 保護のないレベル  
+ <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> を <xref:System.Net.Security.ProtectionLevel> に設定することにより指定されます。この値は、他の認証モードに対しては無効です。  
+  
+> [!NOTE]
+>  MSMQ メッセージが署名されている場合は、キューの状態 \(つまり、認証キューであるかどうか\) に関係なく、添付されている \(内部または外部\) 証明書を使用してメッセージが署名されているかどうかがチェックされます。  
+  
+### MSMQ の暗号化アルゴリズム  
+ 暗号化アルゴリズムは、ネットワーク上の MSMQ メッセージを暗号化するために使用されるアルゴリズムを指定します。このプロパティは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> が <xref:System.Net.Security.ProtectionLevel> に設定されている場合にのみ使用されます。  
+  
+ サポートされているアルゴリズムは `RC4Stream` と `AES` で、既定値は `RC4Stream` です。  
+  
+ `AES` アルゴリズムは、送信元が MSMQ 4.0 以降をインストールしている場合にのみ使用できます。また、ターゲット キューも MSMQ 4.0 でホストされている必要があります。  
+  
+### MSMQ ハッシュ アルゴリズム  
+ ハッシュ アルゴリズムは、MSMQ メッセージのデジタル署名を作成するために使用されるアルゴリズムを指定します。受信側キュー マネージャーも、これと同じアルゴリズムを使用して MSMQ メッセージを認証します。このプロパティは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> が <xref:System.Net.Security.ProtectionLevel> または <xref:System.Net.Security.ProtectionLevel> に設定されている場合にのみ使用されます。  
+  
+ サポートされるアルゴリズムは、`MD5`、`SHA1`、`SHA256`、および `SHA512` です。既定値は `SHA1` です。  
+  
+## 参照  
+ [Message Queuing](http://msdn.microsoft.com/ja-jp/ff917e87-05d5-478f-9430-0f560675ece1)   
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/securing-peer-channel-applications.md b/docs/framework/wcf/feature-details/securing-peer-channel-applications.md
new file mode 100644
index 00000000000..c1bb68bfbe4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/securing-peer-channel-applications.md
@@ -0,0 +1,53 @@
+---
+title: "セキュリティによるピア チャネル アプリケーションの保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4a0311d-3f78-4525-9c4b-5c93c4492f28
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# セキュリティによるピア チャネル アプリケーションの保護
+[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] での他のバインディングと同様に、`NetPeerTcpBinding` には、既定で有効にされているセキュリティがあり、トランスポート ベースのセキュリティとメッセージ ベースのセキュリティが提供されます。  このトピックでは、これら 2 種類のセキュリティについて説明します。  セキュリティの種類は、バインディング仕様のセキュリティ モード タグ \(<xref:System.ServiceModel.NetPeerTcpBinding.Security%2A> `Mode`\) で指定します。  
+  
+## トランスポート ベースのセキュリティ  
+ ピア チャネルでは、トランスポートをセキュリティで保護するための 2 種類の認証資格情報がサポートされます。両方とも、関連する `ChannelFactory` で `ClientCredentialSettings.Peer` プロパティを設定する必要があります。  
+  
+-   パスワード。  クライアントは、接続の認証に秘密パスワードの知識を利用します。  この種類の資格情報を使用する場合、`ClientCredentialSettings.Peer.MeshPassword` は、有効なパスワードと、必要に応じて `X509Certificate2` インスタンスを転送する必要があります。  
+  
+-   証明書。  特定のアプリケーション認証を使用します。  この種類の資格情報を使用する場合は、`ClientCredentialSettings.Peer.PeerAuthentication` で <xref:System.IdentityModel.Selectors.X509CertificateValidator> の具体的な実装を使用する必要があります。  
+  
+## メッセージ ベース セキュリティ  
+ メッセージ セキュリティを使用すると、アプリケーションで送信メッセージに署名できるので、メッセージが信頼されたパーティから送信されたこと、および転送中にメッセージが改ざんされていないことをすべての受信パーティが確認できます。  現在、ピア チャネルでは、X.509 資格情報メッセージの署名のみがサポートされます。  
+  
+## ベスト プラクティス  
+  
+-   ここでは、ピア チャネル アプリケーションをセキュリティで保護するためのベスト プラクティスについて説明します。  
+  
+### ピア チャネル アプリケーションでセキュリティを有効にする  
+ ピア チャネル プロトコルは分散的な性質のため、セキュリティで保護されていないメッシュ内でメッシュ メンバーシップ、機密性、およびプライバシーを強化することは困難です。  クライアントとリゾルバー サービス間の通信をセキュリティで保護することも重要です。  PNRP \(Peer Name Resolution Protocol\) では、セキュリティで保護された名前を使用してスプーフィングや他の一般的な攻撃を回避してください。  カスタム リゾルバー サービスをセキュリティで保護するには、メッセージ ベース セキュリティおよびトランスポート ベース セキュリティの両方を含むリゾルバー サービスにアクセスするためにクライアントが使用する接続でセキュリティを有効にします。  
+  
+### 可能な限り強力なセキュリティ モデルを使用する  
+ たとえば、メッシュの各メンバーを個々に識別する必要がある場合は、証明書ベースの認証モデルを使用します。  これが不可能な場合は、セキュリティ保護のための最新の推奨事項に従ってパスワード ベースの認証を使用します。  推奨事項には、信頼されたパーティとのパスワードの共有、セキュリティで保護された媒介を使用するパスワードの転送、パスワードの頻繁な変更、強力なパスワード \(8 文字以上で、1 文字以上の大文字\/小文字、数字、特殊文字を含める\) の確認などがあります。  
+  
+### 自己署名された証明書を受け入れない  
+ サブジェクト名に基づいて証明書の資格情報を受け入れないでください。  証明書はだれもが作成でき、検証する名前をだれもが選択できることに注意してください。  スプーフィングの可能性を回避するには、発行元証明機関 \(信頼された発行者またはルート証明機関\) の資格情報に基づいて証明書を検証します。  
+  
+### メッセージ認証を使用する  
+ メッセージ認証を使用して、メッセージが信用されるソースから送信されていること、および送信中にメッセージが改ざんされていないことを確認します。  メッセージ認証を使用しないと、悪質なクライアントがメッセージを使用して容易に他人になりすましたり、メッセージを容易に改ざんしたりできます。  
+  
+## ピア チャネルのコード例  
+ [ピア チャネルのシナリオ](../../../../docs/framework/wcf/feature-details/peer-channel-scenarios.md)  
+  
+## 参照  
+ [ピア チャネルのセキュリティ](../../../../docs/framework/wcf/feature-details/peer-channel-security.md)   
+ [ピア チャネル アプリケーションの構築](../../../../docs/framework/wcf/feature-details/building-a-peer-channel-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/securing-services-and-clients.md b/docs/framework/wcf/feature-details/securing-services-and-clients.md
new file mode 100644
index 00000000000..8f6c4d80237
--- /dev/null
+++ b/docs/framework/wcf/feature-details/securing-services-and-clients.md
@@ -0,0 +1,64 @@
+---
+title: "サービスおよびクライアントのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メッセージ セキュリティ [WCF]"
+ms.assetid: e681f3bd-0c09-4a58-b0e4-0ecbdf1aa6c7
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# サービスおよびクライアントのセキュリティ保護
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのセキュリティのプログラミングについて説明します。  一般に、これには、システムが提供する適切なバインディングを選択すること、セキュリティ要素のプロパティを適切に設定すること、サービス側\/クライアント側で使う資格情報の検索方法にまつわる、サービスの動作に関するプロパティを適切に設定することなどが含まれます。  これらの技術を知っていると、「[一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)」に記載されているようなさまざまな状況で、セキュリティ要件に対処できます。  ただし、さらに高度な対策が必要な場合は、最初に「[カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)」、次に「[セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)」を参照してください。  多様なクレームに対応するシステムを構築する場合 \(または、そのようなシステムと相互運用する場合\) は、「[承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)」の各トピックを参照してください。  
+  
+## このセクションの内容  
+ [WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)  
+ メッセージを保護するために使うプログラミング モデルの概要  
+  
+ [トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)  
+ トランスポート層を介してやり取りするメッセージを保護する方法の概要  
+  
+ [メッセージのセキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のメッセージ レベル セキュリティを使用する理由の要約  
+  
+ [セキュリティで保護されたセッション](../../../../docs/framework/wcf/feature-details/secure-sessions.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションのセキュリティを保護する際の考慮事項  
+  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)  
+ X.509 証明書を使用する際に必要となる主な作業の解説  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+## 関連項目  
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)  
+  
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)  
+  
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)  
+  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)  
+  
+ [カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)  
+  
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)  
+  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+  
+## 参照  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-behaviors-in-wcf.md b/docs/framework/wcf/feature-details/security-behaviors-in-wcf.md
new file mode 100644
index 00000000000..c6207b6bc67
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-behaviors-in-wcf.md
@@ -0,0 +1,229 @@
+---
+title: "Windows Communication Foundation のセキュリティ動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 513232c0-39fd-4409-bda6-5ebd5e0ea7b0
+caps.latest.revision: 23
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 23
+---
+# Windows Communication Foundation のセキュリティ動作
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、さまざまな動作によって、サービス レベルまたはエンドポイント レベルで実行時の動作が変更されます \(一般的な動作[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービスのランタイム動作の指定](../../../../docs/framework/wcf/specifying-service-run-time-behavior.md)」を参照してください\)。*"セキュリティ動作"* により、資格情報、認証、承認、および監査ログの制御が可能になります。動作は、プログラムまたは構成を通じて使用できます。ここでは、セキュリティ機能に関連する以下の動作の構成について説明します。  
+  
+-   [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md).  
+  
+-   [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md).  
+  
+-   [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md).  
+  
+-   [\<serviceSecurityAudit\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md).  
+  
+-   [\<serviceMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicemetadata.md)。この要素を使用すると、クライアントがメタデータを取得するためにアクセスできる、セキュリティで保護されたエンドポイントを指定することもできます。  
+  
+## 動作を使用した資格情報の設定  
+ サービスまたはクライアントの資格情報の値を設定するには、[\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)と [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)を使用します。基になるバインディング構成によって、資格情報を設定する必要があるかどうかが決まります。たとえば、セキュリティ モードが `None` に設定されている場合、クライアントとサービスは相互に認証を行わないため、どの種類の資格情報も必要ありません。  
+  
+ 一方、サービス バインディングでは、クライアント資格情報の種類が必要になることがあります。その場合は、動作を使用して資格情報の値を設定することが必要になる場合があります \(使用できる資格情報の種類[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[資格情報の種類の選択](../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)」を参照してください\)。Windows 資格情報を使用して認証を行う場合などは、実際の資格情報の値が環境によって自動的に設定されるため、資格情報の別のセットを指定する場合を除き、資格情報の値を明示的に設定する必要がないこともあります。  
+  
+ すべてのサービス資格情報は、[\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md)の子要素として存在します。サービス資格情報として使用される証明書を次の例に示します。  
+  
+```  
+<configuration>  
+ <system.serviceModel>  
+  <behaviors>  
+   <serviceBehaviors>  
+    <behavior name="ServiceBehavior1">  
+     <serviceCredentials>  
+      <serviceCertificate findValue="000000000000000000000000000"   
+                          storeLocation="CurrentUser"  
+      storeName="Root" x509FindType="FindByThumbprint" />  
+     </serviceCredentials>  
+    </behavior>  
+   </serviceBehaviors>  
+  </behaviors>  
+ </system.serviceModel>  
+</configuration>  
+```  
+  
+## サービス資格情報  
+ [\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md) には 4 つの子要素があります。以下のセクションでは、これらの要素とそれぞれの使い方について説明します。  
+  
+### \<serviceCertificate\> 要素  
+ メッセージ セキュリティ モードを使用しているクライアントへのサービスの認証に使用する X.509 証明書を指定するには、この要素を使用します。定期的に更新される証明書を使用している場合は、証明書のサムプリントが変更されます。その場合、証明書を同じサブジェクト名で再発行できるため、`X509FindType` としてサブジェクト名を使用します。  
+  
+ この要素の使い方[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : クライアントの資格情報の値を指定する](../../../../docs/framework/wcf/how-to-specify-client-credential-values.md)」を参照してください。  
+  
+### \<clientCertificate\> 要素の \<certificate\>  
+ [\<certificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/certificate-of-clientcertificate-element.md) 要素は、サービスがクライアントと安全に通信するために、クライアントの証明書をあらかじめ持っている必要がある場合に使用します。このような状況は、双方向通信パターンを使用する場合に生じます。より一般的な要求\/応答パターンでは、クライアントが自身の証明書を要求に含め、サービスはこの証明書を使用して、クライアントへの応答をセキュリティで保護します。ただし、双方向通信パターンには要求も応答もありません。サービスは、クライアントの証明書を通信から推測できないため、クライアントへのメッセージをセキュリティで保護するためにクライアントの証明書が前もって必要になります。このため、クライアントの証明書を帯域外方式で取得し、この要素を使用して証明書を指定する必要があります。双方向サービス[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 双方向コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)」を参照してください。  
+  
+### \<clientCertificate\> 要素の \<authentication\>  
+ [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md) 要素を使用すると、クライアントを認証する方法をカスタマイズできます。`CertificateValidationMode` 属性は、`None`、`ChainTrust`、`PeerOrChainTrust`、`PeerTrust`、または `Custom` に設定できます。既定のレベルは `ChainTrust` に設定され、チェーンの最上位の*ルート証明機関*で終了する証明書の階層構造で各証明書を検索するよう指定します。これは最もセキュリティで保護されているモードです。また、値を `PeerOrChainTrust` に設定することもできます。これは、信頼されたチェーン内の証明書と共に、自己発行された証明書 \(ピア信頼\) も受け入れるよう指定します。自己発行の資格情報は信頼された証明機関から購入したものである必要はないため、この値はクライアントとサービスの開発およびデバッグに使用されます。クライアントを展開するときは、代わりに `ChainTrust` 値を使用します。また、値を `Custom` に設定することもできます。`Custom` 値に設定する場合は、`CustomCertificateValidatorType` 属性を、証明書の検証に使用するアセンブリと型に設定する必要もあります。独自のカスタム検証を作成するには、抽象 <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスを継承する必要があります。  
+  
+### \<issuedTokenAuthentication\> 要素  
+ 発行されるトークンのシナリオには、3 つの段階があります。まず、サービスにアクセスしようとしているクライアントは、*セキュリティ トークン サービス* \(STS\) に回されます。次に、STS がクライアントを認証し、その後、クライアントにトークン \(通常は、SAML \(Security Assertions Markup Language\) トークン\) を発行します。最後に、クライアントがトークンを持ってサービスに戻ります。サービスはトークンを調べ、トークンを認証することでクライアントの認証を可能にするデータを確認します。トークンを認証するには、セキュリティ トークン サービスで使用される証明書がサービスによって認識されている必要があります。[\<issuedTokenAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md) 要素は、このようなセキュリティ トークン サービス証明書のリポジトリです。証明書を追加するには、[\<knownCertificates\>](../../../../docs/framework/configure-apps/file-schema/wcf/knowncertificates.md) を使用します。次の例に示すように、証明書ごとに [\<add\>](../../../../docs/framework/configure-apps/file-schema/wcf/add-of-knowncertificates.md) を挿入します。  
+  
+```  
+<issuedTokenAuthentication>  
+   <knownCertificates>  
+      <add findValue="www.contoso.com"   
+           storeLocation="LocalMachine" storeName="My"   
+           X509FindType="FindBySubjectName" />  
+    </knownCertificates>  
+</issuedTokenAuthentication>  
+```  
+  
+ 既定では、証明書はセキュリティ トークン サービスから取得する必要があります。このような "既知" の証明書により、正当なクライアントのみがサービスにアクセスできるようになります。  
+  
+ `SamlSecurityToken` セキュリティ トークンを発効する*セキュリティ トークン サービス* \(STS\) を利用するフェデレーション アプリケーション内の [\<allowedAudienceUris\>](../../../../docs/framework/configure-apps/file-schema/wcf/allowedaudienceuris.md) コレクションを使用する必要があります。STS がセキュリティ トークンを発行する場合、このセキュリティ トークンに `SamlAudienceRestrictionCondition` を追加して、セキュリティ トークンの提供先となる Web サービスの URI を指定できます。これにより、受け取り側 `SamlSecurityTokenAuthenticator` Web サービスは、次のようにしてこのチェックが行われるように指定することで、発行されたセキュリティ トークンがこの Web サービスを対象としていることを確認できます。  
+  
+-   [\<issuedTokenAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md) の `audienceUriMode` 属性を `Always`または `BearerKeyOnly` に設定します。  
+  
+-   このコレクションに URI を追加して、有効な URI のセットを指定します。それには、各 URI に [\<add\>](../../../../docs/framework/configure-apps/file-schema/wcf/add-of-allowedaudienceuris.md) を挿入します。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.IdentityModel.Selectors.SamlSecurityTokenAuthenticator>.  
+  
+ この構成要素の使い方[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : フェデレーション サービスで資格情報を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-credentials-on-a-federation-service.md)」を参照してください。  
+  
+#### 匿名の CardSpace ユーザーの許可  
+ `<IssuedTokenAuthentication>` 要素の `AllowUntrustedRsaIssuers` 属性を `true` に設定すると、任意の RSA キー ペアで署名された自己発行トークンを提示することがすべてのクライアントに明示的に許可されます。このキーには、発行者のデータが関連付けられていないため、発行者は*信頼できません*。[!INCLUDE[infocard](../../../../includes/infocard-md.md)] ユーザーは、ID の自己提供クレームを含む自己発行カードを作成できます。この機能を使用するときは十分に注意してください。この機能を使用する場合は、RSA 公開キーを、ユーザー名と一緒にデータベースに格納する必要のある比較的安全なパスワードとして考えます。サービスへのクライアント アクセスを許可する前に、クライアントから提示された RSA 公開キーを、提示されたユーザー名に対応する格納済みの公開キーと比較して検証します。これは、ユーザーが各自のユーザー名を登録し、自己発行の RSA 公開キーに関連付けることができる登録プロセスが確立されていることが前提となります。  
+  
+## クライアント資格情報  
+ クライアント資格情報は、相互認証が必要な場合にサービスに対するクライアントの認証に使用されます。また、このセクションを使用して、クライアントがサービスの証明書によってサービスへのメッセージをセキュリティで保護する必要がある場合に使用するサービス証明書を指定することもできます。  
+  
+ セキュリティ トークン サービスまたはローカル発行者から発行されたトークンを使用するフェデレーション シナリオの一部として、クライアントを構成することもできます。フェデレーション シナリオ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)」を参照してください。次のコードに示すように、すべてのクライアント資格情報は、[\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md)にあります。  
+  
+```  
+<behaviors>  
+ <endpointBehaviors>  
+  <behavior name="EndpointBehavior1">  
+   <clientCredentials>  
+    <clientCertificate findValue="cn=www.contoso.com"     
+        storeLocation="LocalMachine"  
+        storeName="AuthRoot" x509FindType="FindBySubjectName" />  
+    <serviceCertificate>  
+     <defaultCertificate findValue="www.cohowinery.com"   
+                    storeLocation="LocalMachine"  
+                    storeName="Root" x509FindType="FindByIssuerName" />  
+    <authentication revocationMode="Online"  
+                    trustedStoreLocation="LocalMachine" />  
+    </serviceCertificate>  
+   </clientCredentials>  
+  </behavior>  
+ </endpointBehaviors>  
+```  
+  
+#### \<clientCertifictate\> 要素  
+ この要素で、クライアントの認証に使用する証明書を設定します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : クライアントの資格情報の値を指定する](../../../../docs/framework/wcf/how-to-specify-client-credential-values.md).  
+  
+#### \<httpDigest\>  
+ この機能は、Windows の Active Directory およびインターネット インフォメーション サービス \(IIS\) と共に有効にする必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[IIS 6.0 のダイジェスト認証](http://go.microsoft.com/fwlink/?LinkId=88443)」を参照してください。  
+  
+#### \<issuedToken\> 要素  
+ [\<issuedToken\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtoken.md) には、トークンのローカル発行者やセキュリティ トークン サービスで使用する動作の構成に使用する要素が含まれます。ローカル発行者を使用するようにクライアントを構成する手順については、「[方法 : ローカル発行者を設定する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-local-issuer.md)」を参照してください。  
+  
+#### \<ocalIssuerAddress\>  
+ 既定のセキュリティ トークン サービス アドレスを指定します。この要素を使用するのは、<xref:System.ServiceModel.WSFederationHttpBinding> がセキュリティ トークン サービスに URL を提供しない場合、またはフェデレーション バインディングの発行者アドレスが http:\/\/schemas.microsoft.com\/2005\/12\/ServiceModel\/Addressing\/Anonymous または `null` の場合です。そのような場合、<xref:System.ServiceModel.Description.ClientCredentials> は、ローカルの発行者およびバインディングのアドレスと共に構成し、その発行者と通信するために使用する必要があります。  
+  
+#### \<issuerChannelBehaviors\>  
+ セキュリティ トークン サービスとの通信時に使用する  クライアントの動作を追加するには、[\<issuerChannelBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuerchannelbehaviors-element.md)[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]を使用します。[\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md) セクションでクライアントの動作を定義します。定義された動作を使用するには、\<`add`\> 要素を `<issuerChannelBehaviors>` 要素に追加し、2 つの属性を設定します。次の例に示すように、`issuerAddress` をセキュリティ トークン サービスの URL に設定し、`behaviorConfiguration` 属性を定義済みのエンドポイントの動作の名前に設定します。  
+  
+```  
+<clientCredentials>  
+   <issuedToken>  
+      <issuerChannelBehaviors>  
+         <add issuerAddress="http://www.contoso.com"  
+               behaviorConfiguration="clientBehavior1" />     
+```  
+  
+#### \<serviceCertificate\> 要素  
+ サービス証明書の認証を制御するには、この要素を使用します。  
+  
+ [\<defaultCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md) 要素には、サービスで証明書が指定されていないときに使用する証明書を 1 つ格納できます。  
+  
+ 特定のサービスに関連付けられているサービス証明書を設定するには、[\<scopedCertificates\>](../../../../docs/framework/configure-apps/file-schema/wcf/scopedcertificates-element.md)[\<add\>](../../../../docs/framework/configure-apps/file-schema/wcf/add-of-scopedcertificates-element.md) と  を使用します。`<add>` 要素には、証明書をサービスに関連付けるために使用する `targetUri` 属性があります。  
+  
+ [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md) 要素は、証明書の認証に使用する信頼のレベルを指定します。既定のレベルは "ChainTrust" に設定され、チェーンの最上位の信頼された証明機関で終了する証明書の階層構造で各証明書を検索するよう指定します。これは最もセキュリティで保護されているモードです。また、値を "PeerOrChainTrust" に設定することもできます。これは、信頼されたチェーン内の証明書と共に、自己発行された証明書 \(ピア信頼\) も受け入れることを指定します。自己発行の資格情報は信頼された証明機関から購入したものである必要はないため、この値はクライアントとサービスの開発およびデバッグに使用されます。クライアントを展開するときは、代わりに "ChainTrust" 値を使用します。値を "Custom" または "None" に設定できます。"Custom" 値を使用するには、`CustomCertificateValidatorType` 属性も証明書の検証に使用するアセンブリと型に設定する必要があります。独自のカスタム検証を作成するには、抽象 <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスを継承する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : カスタム証明書検証を使用するサービスを作成する](../../../../docs/framework/wcf/extending/how-to-create-a-service-that-employs-a-custom-certificate-validator.md).  
+  
+ [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md) `RevocationMode 要素には、証明書が失効していないかどうかをチェックする方法を指定する`  属性が含まれます。既定値は "online" です。この場合、証明書が失効していないかどうかが自動的にチェックされます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md).  
+  
+## ServiceAuthorization  
+ [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md) 要素には、承認、カスタム ロール プロバイダー、および偽装に影響する要素が含まれます。  
+  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute> クラスは、サービス メソッドに適用されます。この属性は、保護メソッドの使用を承認するときに使用するユーザー グループを指定します。既定値は "UseWindowsGroups" で、リソースにアクセスしようとしている ID を Windows グループ \("管理者" や "ユーザー" など\) で検索するよう指定します。次のコードに示すように、"UseAspNetRoles" を指定して、\<`system.web` \> 要素の下で構成されるカスタム ロール プロバイダーを使用することもできます。  
+  
+```  
+<system.web>  
+  <membership defaultProvider="SqlProvider"   
+   userIsOnlineTimeWindow="15">  
+     <providers>  
+       <clear />  
+       <add   
+          name="SqlProvider"   
+          type="System.Web.Security.SqlMembershipProvider"   
+          connectionStringName="SqlConn"  
+          applicationName="MembershipProvider"  
+          enablePasswordRetrieval="false"  
+          enablePasswordReset="false"  
+          requiresQuestionAndAnswer="false"  
+          requiresUniqueEmail="true"  
+          passwordFormat="Hashed" />  
+     </providers>  
+   </membership>  
+  <!-- Other configuration code not shown.-->  
+</system.web>  
+```  
+  
+ `principalPermissionMode` 属性で `roleProviderName` を使用する方法を次のコードに示します。  
+  
+```  
+<behaviors>  
+ <behavior name="ServiceBehaviour">          
+  <serviceAuthorization principalPermissionMode ="UseAspNetRoles"   
+                        roleProviderName ="SqlProvider" />  
+</behavior>   
+   <!-- Other configuration code not shown. -->  
+</behaviors>  
+```  
+  
+## セキュリティ監査の構成  
+ 書き込み先のログとログに記録するイベントの種類を指定するには、[\<serviceSecurityAudit\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicesecurityaudit.md) を使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md).  
+  
+```  
+<system.serviceModel>  
+<serviceBehaviors>  
+  <behavior name="NewBehavior">  
+    <serviceSecurityAudit auditLogLocation="Application"   
+             suppressAuditFailure="true"  
+             serviceAuthorizationAuditLevel="Success"   
+             messageAuthenticationAuditLevel="Success" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## セキュリティで保護されたメタデータ交換  
+ メタデータをクライアントにエクスポートすると、構成やクライアント コードのダウンロードが可能になるため、サービスとクライアントの開発者にとって便利です。サービスが悪意のあるユーザーに公開されないようにするために、SSL over HTTP \(HTTPS\) 機構を使用して転送をセキュリティで保護できます。転送を保護するには、まず、サービスをホストしているコンピューターの特定のポートに適切な X.509 証明書をバインドする必要があります \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md).\)次に、[\<serviceMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicemetadata.md)`HttpsGetEnabled`をサービス構成に追加し、`true` 属性を  に設定します。最後に、次の例に示すように、`HttpsGetUrl` 属性をサービス メタデータ エンドポイントの URL に設定します。  
+  
+```  
+<behaviors>  
+ <serviceBehaviors>  
+  <behavior name="NewBehavior">  
+    <serviceMetadata httpsGetEnabled="true"   
+     httpsGetUrl="https://myComputerName/myEndpoint" />  
+  </behavior>  
+ </serviceBehaviors>  
+</behaviors>  
+```  
+  
+## 参照  
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md b/docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md
new file mode 100644
index 00000000000..6a8a8af6aec
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md
@@ -0,0 +1,63 @@
+---
+title: "カスタム バインディングを使用したセキュリティ機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2425679-484a-4e6c-9c98-7da7304f1516
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# カスタム バインディングを使用したセキュリティ機能
+一般的なセキュリティ タスクのほとんどは、システム指定のバインディングのいずれかを使用して実行できます。ただし、より高度な制御が必要な場合は、以下のトピックで説明するように、<xref:System.ServiceModel.Channels.SecurityBindingElement> を使用してカスタム バインディングを作成できます。カスタム バインディング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## このセクションの内容  
+ [SecurityBindingElement 認証モード](../../../../docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md)  
+ カスタム バインディングで使用できる認証モードについて説明します。  
+  
+ [方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)  
+ セキュリティ要素を使用してカスタム バインディングを作成するための基本手順について説明します。  
+  
+ [方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)  
+ 指定した認証モード用のセキュリティ要素を作成する方法について説明します。  
+  
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)  
+ フェデレーション サービスを作成する際に、セキュリティで保護されたセッションを無効にする方法について説明します。  
+  
+ [方法 : メッセージ リプレイ検出を有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-message-replay-detection.md)  
+ リプレイ攻撃の発生を確認する方法について説明します。  
+  
+ [方法 : サポート資格情報を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-supporting-credential.md)  
+ 必要な場合に、サービスにサポート資格情報を提供する方法について説明します。  
+  
+ [方法 : 署名確認を設定する](../../../../docs/framework/wcf/feature-details/how-to-set-up-a-signature-confirmation.md)  
+ メッセージにデジタル署名する際に署名を確認する手順について説明します。  
+  
+ [方法 : 時刻のずれの最大値を設定する](../../../../docs/framework/wcf/feature-details/how-to-set-a-max-clock-skew.md)  
+ サービスとクライアント間で許容される最大の時刻のずれを設定する方法について説明します。  
+  
+ [方法 : デジタル署名の暗号化を無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-encryption-of-digital-signatures.md)  
+ デジタル署名の暗号化を無効にするとどのようなパフォーマンス上の利点があるかを説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>  
+  
+ [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)  
+  
+## 関連項目  
+ [保護レベルの理解](../../../../docs/framework/wcf/understanding-protection-level.md)  
+  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)  
+  
+## 参照  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-concepts-used-in-wcf.md b/docs/framework/wcf/feature-details/security-concepts-used-in-wcf.md
new file mode 100644
index 00000000000..15b2e89aed0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-concepts-used-in-wcf.md
@@ -0,0 +1,58 @@
+---
+title: "WCF で使用されるセキュリティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b9dfcf5-4bf1-4f35-9070-723171c823a1
+caps.latest.revision: 15
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 15
+---
+# WCF で使用されるセキュリティの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティは、各種のセキュリティ インフラストラクチャで既に使用され展開されている概念の上に構築されています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、これらのインフラストラクチャの一部 \(SSL \(Secure Sockets Layer\) over HTTP \(HTTPS\) など\) をサポートしています。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、新しい相互運用可能なセキュリティ標準 \(WS\-Security など\) を SOAP エンコード メッセージに実装することで、既存のセキュリティ インフラストラクチャをサポートする以上の機能を実現しています。既存の機構と新規の相互運用可能な標準のどちらを使用する場合でも、背後にあるセキュリティ概念に変わりはありません。既存のインフラストラクチャおよび新しい標準を支える概念を理解することが、アプリケーションにとって最善のセキュリティ モデルを実装するための要になります。  
+  
+## WCF Web サービスのセキュリティの概要  
+ Microsoft Patterns and Practices グループでは、WCF セキュリティ ガイダンスに関する詳細なホワイト ペーパーを作成しました \(「[WCF セキュリティ ガイド](http://go.microsoft.com/fwlink/?LinkId=210210)」からダウンロードできます\)。このホワイト ペーパーでは、Web サービス、WCF セキュリティの主な概念、イントラネット アプリケーション シナリオ、およびインターネット アプリケーション シナリオに関連するセキュリティの基本概念について説明しています。  
+  
+## 業界標準のセキュリティ仕様  
+  
+### 公開キー基盤  
+ 公開キー基盤 \(PKI: Public Key Infrastructure\) は、デジタル証明書、証明機関、およびその他の登録機関で構成されるシステムです。PKI では、公開キー暗号化を使用して、電子取引に関与する各当事者の検証と認証を行います。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[Windows Server 2008 R2 証明書サービス](http://go.microsoft.com/fwlink/?LinkId=210211)」を参照してください。  
+  
+### Kerberos プロトコル  
+ *"Kerberos プロトコル"* は、Windows ドメインでユーザーを認証するセキュリティ機構を作成するための仕様です。ユーザーはドメイン内の他のエンティティと、セキュリティで保護されたコンテキストを確立できます。Windows 2000 以降のプラットフォームでは、Kerberos プロトコルが既定で使用されます。システムの機構を理解することは、イントラネット クライアントと対話するサービスを作成する場合に役立ちます。また、*Web Services Security Kerberos Binding* が広く公開されているため、Kerberos プロトコルを使用してインターネット クライアントと通信できます \(つまり、Kerberos プロトコルには相互運用性があります\)。Kerberos プロトコルを Windows で実装する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Microsoft Kerberos](http://go.microsoft.com/fwlink/?LinkId=210212)」を参照してください。  
+  
+### X.509 証明書  
+ X.509 証明書は、セキュリティ アプリケーションで使用される主要な資格情報の形式です。X.509 証明書の詳細については、「[X.509 公開キー証明書](http://go.microsoft.com/fwlink/?LinkId=210213)」を参照してください。X.509 証明書は証明書ストア内に格納されます。Windows を実行しているコンピューターには、それぞれ目的が異なる数種類の証明書ストアがあります。各種ストア[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書ストア](http://go.microsoft.com/fwlink/?LinkID=87787)」を参照してください。  
+  
+## Web サービスのセキュリティ仕様  
+ システム定義のバインディングでは、一般に使用されるさまざまな Web サービスのセキュリティ仕様をサポートしています。システム定義のバインディングとサポートされる Web サービスの仕様の全一覧については、「[システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)」を参照してください。  
+  
+## アクセス制御機構  
+ WCF には、サービスや操作へのアクセスを制御するさまざまな方法が用意されています。次に例を示します。  
+  
+1.  <xref:System.Security.Permissions.PrinciplePermissionAttribute>  
+  
+2.  ASP.NET メンバーシップ プロバイダー  
+  
+3.  ASP.NET ロール プロバイダー  
+  
+4.  承認マネージャー  
+  
+5.  ID モデル  
+  
+ 各項目の詳細については、「[アクセス制御機構](../../../../docs/framework/wcf/feature-details/access-control-mechanisms.md)」を参照してください。  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-concepts.md b/docs/framework/wcf/feature-details/security-concepts.md
new file mode 100644
index 00000000000..f0a71e6a125
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-concepts.md
@@ -0,0 +1,49 @@
+---
+title: "セキュリティの概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 944fa5ca-2c34-4268-8897-e005a61b470d
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# セキュリティの概念
+このセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティに関連する概念について簡単に説明します。  
+  
+## このセクションの内容  
+ [WCF で使用されるセキュリティの概要](../../../../docs/framework/wcf/feature-details/security-concepts-used-in-wcf.md)  
+ セキュリティの実装で使用される概念の概要を示します。  
+  
+ [分散アプリケーションのセキュリティ](../../../../docs/framework/wcf/feature-details/distributed-application-security.md)  
+ 分散アプリケーション トポグラフィで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がセキュリティを提供するしくみの概要を示します。  
+  
+ [セキュリティ用語](../../../../docs/framework/wcf/feature-details/wcf-security-terminology.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティの説明に使用される用語集です。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Description>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+ <xref:System.Security>  
+  
+## 関連項目  
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-considerations-for-data.md b/docs/framework/wcf/feature-details/security-considerations-for-data.md
new file mode 100644
index 00000000000..b6ac145d232
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-considerations-for-data.md
@@ -0,0 +1,364 @@
+---
+title: "セキュリティに関するデータの考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7eb98da-4a93-4692-8b59-9d670c79ffb2
+caps.latest.revision: 23
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 23
+---
+# セキュリティに関するデータの考慮事項
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でデータを処理するとき、さまざまな種類の脅威について考慮する必要があります。 データ処理に関連する最も重要な脅威の種類を次の表に示します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、これらの脅威を軽減するためのツールが用意されています。  
+  
+ サービス拒否  
+ 信頼できないデータを受信すると、受信側では、そのデータによって非常に長い計算が発生し、メモリ、スレッド、利用可能な接続、プロセッサ サイクルなど複数のリソースに過剰にアクセスすることがあります。 サーバーに対するサービス拒否攻撃によって、サーバーがクラッシュし、正当なクライアントからのメッセージを処理できなくなる場合があります。  
+  
+ 悪質なコードの実行  
+ 信頼できないデータを受信すると、受信側で本来意図してしないコードが実行されます。  
+  
+ 情報の漏えい  
+ リモートの攻撃者は、受信側に要求への応答を強制し、受信側が意図した以上の情報を公開させます。  
+  
+## ユーザー指定のコードとコード アクセス セキュリティ  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] インフラストラクチャのさまざまな場所で、ユーザーが指定したコードが実行されます。 たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> シリアル化エンジンでは、ユーザー指定のプロパティの `set` アクセサーと `get` アクセサーが呼び出されることがあります。 また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル インフラストラクチャで、<xref:System.ServiceModel.Channels.Message> クラスのユーザー指定の派生クラスが呼び出されることもあります。  
+  
+ コード作成者は、コードにセキュリティの脆弱性が存在しないことを確認する必要があります。 たとえば、整数型のデータ メンバー プロパティを使用してデータ コントラクト型を作成し、`set` アクセサー実装でこのプロパティ値に基づいて配列を割り当てた場合、悪質なメッセージにこのデータ メンバーの極端に大きな値が含まれていると、サービス拒否攻撃の危険にさらされることになります。 一般的に、受信データに基づく割り当てや、ユーザー指定のコードでの長時間に及ぶ処理は回避します \(特に、長時間に及ぶ処理が少量の受信データによって発生する可能性がある場合\)。 ユーザー指定のコードのセキュリティ分析を実行するときは、必ず失敗した場合 \(つまり、例外をスローするすべてのコード分岐\) も考慮してください。  
+  
+ ユーザー指定コードの特に重要な例は、各操作に対するサービス実装内部のコードです。 サービス実装のセキュリティを確保することはユーザーの責任です。 サービス拒否の脆弱性を生じるような、セキュリティで保護されていない操作実装は、不注意によって容易に作成されてしまいます。 たとえば、文字列を受け取り、名前がその文字列で始まる顧客のリストをデータベースから返す操作があるとします。 使用しているデータベースの規模が大きく、渡された文字列が 1 文字の場合、ユーザーのコードは、使用可能なメモリより大きなメッセージを作成しようとする可能性があります。これによって、サービス全体が失敗します \(<xref:System.OutOfMemoryException> では [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] を回復できないため、アプリケーションは必ず強制終了されます\)。  
+  
+ 悪質なコードがさまざまな機能拡張ポイントに接続されないようにする必要があります。 これが特に関係するのは、部分信頼で実行する場合、部分信頼アセンブリの型を処理する場合、または部分信頼コードで使用できるコンポーネントを作成する場合です。 詳細については、後のセクションの「部分信頼に関する脅威」を参照してください。  
+  
+ 部分信頼で実行する場合、データ コントラクトのシリアル化インフラストラクチャがサポートするのは、データ コントラクト プログラミング モデルの一部のサブセットのみです。たとえば、<xref:System.SerializableAttribute> 属性を使用するプライベート データ メンバーや型はサポートされません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [部分信頼](../../../../docs/framework/wcf/feature-details/partial-trust.md)。  
+  
+## 意図しない情報公開の回避  
+ セキュリティを念頭に置いてシリアル化可能な型を設計するとき、情報の漏えい公開は考慮事項の 1 つです。  
+  
+ 次の点を考慮してください。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> プログラミング モデルでは、シリアル化中に型またはアセンブリの外側で、プライベートな内部データの公開が許可されます。 さらに、スキーマのエクスポート時に型の形状が公開されることがあります。 必ず、型のシリアル化射影について理解してください。 型を公開しない場合は、シリアル化を無効にします \(たとえば、データ コントラクトの場合、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用しないことによって無効にします\)。  
+  
+-   使用するシリアライザーによっては、同じ型に対して複数のシリアル化射影が存在することがあります。 また、同じ型であっても、<xref:System.Runtime.Serialization.DataContractSerializer> を使用したときに公開されるデータ セットと、<xref:System.Xml.Serialization.XmlSerializer> を使用したとき公開されるデータ セットが異なる可能性があります。 使用するシリアライザーを誤ると、情報の漏えいを招く場合があります。  
+  
+-   従来のリモート プロシージャ コール \(RPC\)\/エンコード モードで <xref:System.Xml.Serialization.XmlSerializer> を使用すると、送信側のオブジェクト グラフの形状が誤って受信側に公開されることがあります。  
+  
+## サービス拒否攻撃の防止  
+  
+### クォータ  
+ 受信側で大量のメモリ割り当てが発生した場合、サービス拒否攻撃の可能性があります。 ここでは、主に大きいメッセージが原因で起こるメモリ消費の問題について説明しますが、攻撃には他の種類もあります。 たとえば、メッセージに過度の処理時間が使用される場合があります。  
+  
+ サービス拒否攻撃の緩和には通常、クォータを使用します。 クォータを超えると、通常は <xref:System.ServiceModel.QuotaExceededException> 例外がスローされます。 クォータが設定されていないと、悪質なメッセージが使用可能なすべてのメモリにアクセスし、<xref:System.OutOfMemoryException> 例外が発生したり、使用可能なすべてのスタックにアクセスし、<xref:System.StackOverflowException> 例外が発生したりする可能性があります。  
+  
+ クォータが超過した状況は、回復可能です。実行中のサービスでこの状況が発生した場合、現在処理されているメッセージは破棄されますが、サービスの実行は続行され、次のメッセージが処理されます。 ただし、メモリ不足とスタック オーバーフローの場合は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のどの場所でも回復不可能です。このような例外が発生した場合、サービスは強制終了されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクォータには、事前割り当ては含まれません。 たとえば、さまざまなクラスにある <xref:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize%2A> クォータを 128 KB に設定した場合、各メッセージに 128 KB が自動的に割り当てられるわけではありません。 実際の割当量は、実際の受信メッセージのサイズによって異なります。  
+  
+ トランスポート層には、利用できるクォータが多数あります。 使用しているトランスポート チャネル \(HTTP、TCP など\) によって指定されるクォータもあります。 ここでは、これらのクォータの一部について説明しますが、詳細については、「[トランスポート クォータ](../../../../docs/framework/wcf/feature-details/transport-quotas.md)」を参照してください。  
+  
+### ハッシュ テーブルの脆弱性  
+ データ コントラクトにハッシュ テーブルまたはコレクションが含まれている場合は脆弱性が存在します。 多数の値がハッシュ テーブルに挿入されると問題が発生します。ハッシュ テーブルでは、このような多数の値によって同じハッシュ値が生成されます。 これは、DOS 攻撃に使用される可能性があります。  この脆弱性は、MaxRecievedMessageSize バインディング クォータを設定すると軽減できます。 このような攻撃を防ぐためにこのクォータを設定している場合は注意が必要です。 このクォータにより、WCF メッセージのサイズに上限が設定されます。 また、データ コントラクトではハッシュ テーブルやコレクションを使用しないようにしてください。  
+  
+## メモリ消費の制限 \(ストリーミングなしの場合\)  
+ 大きいメッセージに関するセキュリティ モデルは、ストリーミングが使用されているかどうかによって異なります。 ストリーミングを使用しない基本的なケースでは、メッセージはメモリにバッファーされます。 この場合、<xref:System.ServiceModel.Channels.TransportBindingElement.MaxReceivedMessageSize%2A> またはシステム指定のバインディングで <xref:System.ServiceModel.Channels.TransportBindingElement> クォータを使用して、アクセスするメッセージの最大サイズを制限することによって、サイズの大きいメッセージからシステムを保護します。 サービスが複数のメッセージを同時に処理していることがありますが、この場合、メッセージはすべてメモリ内にあります。 この脅威を軽減するには、調整機能を使用します。  
+  
+ また、`MaxReceivedMessageSize` ではメッセージごとのメモリ消費に対して上限値が設定されませんが、メッセージごとのメモリ消費が定数係数以内に制限されます。 たとえば、`MaxReceivedMessageSize` が 1 MB のときに 1 MB のメッセージを受信し、逆シリアル化した場合、逆シリアル化されたオブジェクト グラフを格納するために追加のメモリが必要となるため、メモリの総消費量が 1 MB を超えることになります。 このため、受信するデータは大きくなくてもメモリ消費量が極端に大きくなるような、シリアル化可能な型は作成しないようにします。 たとえば、50 個の省略可能なデータ メンバー フィールドと 100 個のプライベート フィールドが設定されたデータ コントラクト "MyContract" が、"\<MyContract\/\>" という XML 構造でインスタンス化されるとします。 この XML は、150 個のフィールドに対応するメモリにアクセスすることになります。 既定では、このデータ メンバーは省略可能です。 このような型が配列に含まれていると、問題はさらに悪化します。  
+  
+ `MaxReceivedMessageSize` だけでは、すべてのサービス拒否攻撃を防止できません。 たとえば、受信メッセージによって、デシリアライザーが深く入れ子になったオブジェクト グラフ \(オブジェクトに別のオブジェクトが格納され、その別のオブジェクトにさらに別のオブジェクトが格納されているということが繰り返されているオブジェクト\) を逆シリアル化することを強制される場合があります。<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Xml.Serialization.XmlSerializer> は、このオブジェクト グラフを逆シリアル化するために入れ子形態でメソッドを呼び出します。 メソッド呼び出しがレベルの深い入れ子構造になっていると、回復不可能な <xref:System.StackOverflowException> が発生する可能性があります。 この脅威は、このトピックの後半の「XML の安全な使用」で説明するように、<xref:System.ServiceModel.Configuration.XmlDictionaryReaderQuotasElement.MaxDepth%2A> クォータを設定して、XML の入れ子レベルを制限することによって軽減できます。  
+  
+ バイナリ XML エンコーディングを使用する場合は、追加のクォータを `MaxReceivedMessageSize` に設定することが特に重要です。 バイナリ エンコーディングの使用は、圧縮に似ているところがあります。受信メッセージ内の少量のバイトで、大量のデータが表されていることがあります。 したがって、`MaxReceivedMessageSize` の制限に収まるメッセージでも、完全に展開された形式では、さらに多くのメモリを消費する可能性があります。 このような XML 固有の脅威を軽減するには、すべての XML リーダーのクォータを、このトピックの後半の「XML の安全な使用」で説明するとおりに設定する必要があります。  
+  
+## メモリ消費の制限 \(ストリーミングありの場合\)  
+ ストリーミング中、`MaxReceivedMessageSize` の設定値を小さくすることで、サービス拒否攻撃を防止できます。 ただし、ストリーミングを伴う場合、状況が複雑になります。 たとえば、ファイル アップロード サービスでは使用可能なメモリより大きいファイルが許容されます。 この場合、メモリにバッファーされるデータはほとんどなく、メッセージが直接ディスクにストリーミングされると予測して、`MaxReceivedMessageSize` を非常に大きな値に設定します。 何らかの方法で悪質なメッセージがデータをストリーミングするのではなく、バッファーに格納することを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に強制した場合、メッセージが使用可能なすべてのメモリにアクセスする状況を `MaxReceivedMessageSize` で防ぐことはできなくなります。  
+  
+ この脅威を軽減するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に含まれる複数のデータ処理コンポーネントには、バッファー化を制限するためのクォータ設定が存在します。 この中で最も重要なのは、複数のトランスポート バインド要素と標準バインディングに存在する `MaxBufferSize` プロパティです。 ストリーミングを使用する場合は、メッセージごとに割り当て可能なメモリの最大量を考慮して、このクォータを設定する必要があります。`MaxReceivedMessageSize` と同様、この設定ではメモリ消費の絶対的な最大値が設定されるのではなく、メモリ消費が定数係数以内に制限されるだけです。 また、`MaxReceivedMessageSize` の場合と同じく、複数のメッセージが同時に処理されている可能性もあります。  
+  
+### MaxBufferSize の詳細  
+ `MaxBufferSize`  プロパティは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実行するすべての大量バッファーを制限します。 たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では常に、SOAP ヘッダーと SOAP エラー、さらに MTOM \(Message Transmission Optimization Mechanism\) メッセージ内で自然な読み取り順序ではないことが検出された MIME パートがバッファー化されます。 この設定では、このようなすべての状況でバッファー量が制限されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、バッファー化を行う可能性がある多様なコンポーネントに `MaxBufferSize` の値を渡すことによって、この制限を実現します。 たとえば、<xref:System.ServiceModel.Channels.Message.CreateMessage%2A> クラスの一部の <xref:System.ServiceModel.Channels.Message> オーバーロードは、`maxSizeOfHeaders` パラメーターを受け取ります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、このパラメーターに `MaxBufferSize` の値を渡して、SOAP ヘッダーのバッファー量を制限します。<xref:System.ServiceModel.Channels.Message> クラスを直接使用する場合、このパラメーターを設定することが重要です。 通常、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でクォータ パラメーターを受け取るコンポーネントを使用する場合、このパラメーターのセキュリティに対する影響を理解し、正しく設定することが重要です。  
+  
+ MTOM メッセージ エンコーダーには、`MaxBufferSize` 設定もあります。 標準バインディングを使用する場合、この値は自動的にトランスポート レベルの `MaxBufferSize` に設定されます。 ただし、MTOM メッセージ エンコーダーのバインド要素を使用してカスタム バインディングを作成する場合、ストリーミングの使用時には `MaxBufferSize` プロパティを安全な値に設定することが重要です。  
+  
+## XML ベースのストリーミング攻撃  
+ ストリーミングが予想される場合、`MaxBufferSize` だけでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によるバッファー化が強制されないようにすることができません。 たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の XML リーダーは、新しい要素の読み取りを開始すると、必ず XML 要素の開始タグ全体をバッファー化します。 この処理は、名前空間と属性を適切に処理するために行われます。 \(たとえば、大きいファイルを直接ディスクにストリーミングするシナリオを可能にする目的で\) `MaxReceivedMessageSize` が大きい値に設定されている場合、メッセージの本文全体が大きい XML 要素の開始タグであるような、悪質なメッセージが作成される可能性があります。 このメッセージを読み取ろうとすると、<xref:System.OutOfMemoryException> が発生します。 これは、XML ベースのサービス拒否攻撃の 1 つです。このような XML ベースのサービス拒否攻撃はすべて、このトピックの後半の「XML の安全な使用」で説明する XML リーダーのクォータを使用して軽減できます。 ストリーミングを使用する場合、これらのクォータをすべて設定することが特に重要です。  
+  
+### ストリーミングとバッファー プログラミング モデルの混在  
+ 攻撃の多くは、同じサービス内にストリーミングとストリーミング以外のプログラミング モデルを混在させることによって発生することが考えられます。 2 つの操作が設定されたサービス コントラクトがあるとします。一方は <xref:System.IO.Stream> を使用し、他方はカスタム型の配列を使用します。 また、1 つ目の操作で、大きいストリームを処理できるように、`MaxReceivedMessageSize` が大きい値に設定されているとします。 この場合、大きいメッセージを 2 つ目の操作でも受け取れることになってしまいます。デシリアライザーは、操作が呼び出される前にデータを配列としてメモリにバッファー化します。 この状況では、サービス拒否攻撃が発生する可能性があります。`MaxBufferSize` クォータでは、メッセージ本文のサイズ、つまり、デシリアライザーが処理するデータのサイズは制限できません。  
+  
+ このため、同じコントラクトにストリーム ベースの操作とストリーム以外の操作を混合しないようにしてください。 この 2 つのプログラミング モデルを混合する必要がある場合は、次の予防策を使用します。  
+  
+-   <xref:System.Runtime.Serialization.IExtensibleDataObject> の <xref:System.ServiceModel.ServiceBehaviorAttribute.IgnoreExtensionDataObject%2A> プロパティを <xref:System.ServiceModel.ServiceBehaviorAttribute> に設定して、`true` 機能を無効にします。 これによって、コントラクトの一部であるメンバーだけが逆シリアル化されます。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer.MaxItemsInObjectGraph%2A> の <xref:System.Runtime.Serialization.DataContractSerializer> プロパティを安全な値に設定します。 このクォータは、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性または構成からも操作できます。 このクォータは、1 回の逆シリアル化で逆シリアル化されるオブジェクトの数を制限します。 通常、1 回の逆シリアル化で、メッセージ コントラクト内の 1 つの操作パラメーターまたはメッセージ本文が逆シリアル化されます。 配列を逆シリアル化する場合、各配列エントリは個別のオブジェクトとしてカウントされます。  
+  
+-   すべての XML リーダーのクォータを安全な値に設定します。<xref:System.Xml.XmlDictionaryReaderQuotas.MaxDepth%2A>、<xref:System.Xml.XmlDictionaryReaderQuotas.MaxStringContentLength%2A>、および <xref:System.Xml.XmlDictionaryReaderQuotas.MaxArrayLength%2A> に注意して、ストリーミング以外の操作で文字列の使用を避けます。  
+  
+-   既知の型のリストを確認し、ここにある型はいつでもインスタンス化が可能であることを覚えておいてください \(このトピックの後半の「意図しない型の読み込み防止」を参照\)。  
+  
+-   <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装して大量のデータをバッファー化する型は使用しないようにします。 このような型は既知の型のリストに追加しないでください。  
+  
+-   <xref:System.Xml.XmlElement>、<xref:System.Xml.XmlNode>、<xref:System.Byte> の各配列や、<xref:System.Runtime.Serialization.ISerializable> を実装する型をコントラクトで使用しないでください。  
+  
+-   <xref:System.Xml.XmlElement>、<xref:System.Xml.XmlNode>、<xref:System.Byte> の各配列や、<xref:System.Runtime.Serialization.ISerializable> を実装する型は、既知の型のリストで使用しないでください。  
+  
+ 前述の予防策は、ストリーミング以外の操作で <xref:System.Runtime.Serialization.DataContractSerializer> を使用する場合に適用できます。<xref:System.Xml.Serialization.XmlSerializer> を使用している場合、これには <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.MaxItemsInObjectGraph%2A> クォータによる保護がないので、同じサービスにストリーミングとストリーミング以外のプログラミング モデルを絶対に混在させないでください。  
+  
+### 遅いストリームによる攻撃  
+ ストリーミング サービス拒否攻撃では、メモリ消費は発生しません。 代わりに、この攻撃では送信側または受信側でデータの転送が遅くなります。 データが送信または受信されるのを待っている間、スレッドや利用可能な接続などのリソースが消耗します。 この状況は、悪質な攻撃を受けた結果として、または正当な送信側または受信側が遅いネットワーク接続を使用していることが原因で起こる可能性があります。  
+  
+ この攻撃を軽減するには、トランスポートのタイムアウトを適切に設定します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [トランスポート クォータ](../../../../docs/framework/wcf/feature-details/transport-quotas.md)。 また、`Read` でストリームを処理するときは、同期 `Write` 操作または同期 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 操作を使用しないでください。  
+  
+## XML の安全な使用  
+  
+> [!NOTE]
+>  このセクションは XML に関するものですが、ここに記載された情報は、JSON \(JavaScript Object Notation\) ドキュメントにも該当します。[JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)を使用することで、クォータは同様に機能します。  
+  
+### セキュリティで保護された XML リーダー  
+ XML Infoset は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのすべてのメッセージ処理の基礎となります。 信頼できない送信元からの XML データを受け入れる場合、多数のサービス拒否攻撃が存在する可能性があり、これを軽減する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、セキュリティで保護された特別な XML リーダーが用意されています。 このリーダーは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で標準エンコーディング \(テキスト、バイナリ、MTOM\) のいずれかを使用しているときに自動的に作成されます。  
+  
+ このリーダーでは、一部のセキュリティ機能が常にアクティブです。 たとえば、このリーダーは文書型定義 \(DTD\) を処理しません。文書型定義は、サービス拒否攻撃のソースの 1 つになり得るものであり、正当な SOAP メッセージに使用すべきではありません。 他のセキュリティ機能としてリーダーのクォータがあり、これらを設定する必要があります。この機能については、次のセクションで説明します。  
+  
+ XML リーダーを直接操作するとき \(カスタム エンコーダーを記述するときや、<xref:System.ServiceModel.Channels.Message> クラスを直接操作するときなど\)、信頼できないデータを処理する可能性がある場合は必ず、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティで保護されたリーダーを使用します。 セキュリティで保護されたリーダーは、<xref:System.Xml.XmlDictionaryReader.CreateTextReader%2A> クラス上で <xref:System.Xml.XmlDictionaryReader.CreateBinaryReader%2A>、<xref:System.Xml.XmlDictionaryReader.CreateMtomReader%2A>、または <xref:System.Xml.XmlDictionaryReader> の静的ファクトリ メソッドのオーバーロードのいずれかを呼び出すことによって作成します。 リーダーを作成したら、安全なクォータ値を渡します。`Create` メソッドのオーバーロードを呼び出さないでください。 オーバーロードを呼び出しても [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のリーダーは作成されません。 作成されるのは、このセクションで説明したセキュリティ機能で保護されていないリーダーです。  
+  
+### リーダーのクォータ  
+ セキュリティで保護された XML リーダーには、5 つの設定可能なクォータがあります。 これらのクォータは通常、標準バインディングまたはエンコーディング バインド要素で `ReaderQuotas` プロパティを使用するか、リーダーの作成時に渡される <xref:System.Xml.XmlDictionaryReaderQuotas> オブジェクトを使用して設定します。  
+  
+#### MaxBytesPerRead  
+ このクォータは、要素の開始タグとその属性を読み取るときに、1 回の `Read` 操作で読み取るバイト数を制限します  \(ストリーミングを使用しない場合、要素名自体がクォータに照らし合わせてカウントされることはありません\)。<xref:System.Xml.XmlDictionaryReaderQuotas.MaxBytesPerRead%2A> が重要な理由は、次のとおりです。  
+  
+-   要素名とその属性は、読み取り時に必ずメモリ内でバッファー化されます。 このため、ストリーミングが予想されるときにこのクォータをストリーミング モードで適切に設定して、過度のバッファーを防止することが重要です。 実行されるバッファリングの実際の量については、`MaxDepth` クォータのセクションを参照してください。  
+  
+-   XML 属性が多すぎると、属性名は一意かどうかを確認する必要があるため、処理時間が大幅に増加する可能性があります。`MaxBytesPerRead` によってこの脅威を軽減できます。  
+  
+#### MaxDepth  
+ このクォータは、XML 要素の入れ子の深さの最大値を制限します。 たとえば、ドキュメント "\<A\>\<B\>\<C\/\>\<\/B\>\<\/A\>" には 3 レベルの入れ子があります。<xref:System.Xml.XmlDictionaryReaderQuotas.MaxDepth%2A> が重要な理由は、次のとおりです。  
+  
+-   `MaxDepth` は `MaxBytesPerRead` と相互に関係しています。リーダーは常に、現在の要素とそのすべての先祖に関するデータをメモリ内に維持します。このため、リーダーのメモリ消費の最大値は、この 2 つの設定値の積に比例します。  
+  
+-   深く入れ子になったオブジェクト グラフを逆シリアル化する場合、デシリアライザーはスタック全体にアクセスし、回復不可能な <xref:System.StackOverflowException> をスローするしかありません。<xref:System.Runtime.Serialization.DataContractSerializer> の場合も <xref:System.Xml.Serialization.XmlSerializer> の場合も、XML の入れ子構造とオブジェクトの入れ子構造との間に直接的な相関関係が存在します。 この脅威を軽減するには、`MaxDepth` を使用します。  
+  
+#### MaxNameTableCharCount  
+ このクォータは、リーダーの *nametable* のサイズを制限します。 nametable には、XML ドキュメントを処理するときに出現する特定の文字列 \(名前空間やプレフィックスなど\) が入っています。 この文字列はメモリ内でバッファー化されるので、ストリーミングが予想されるときは、このクォータを設定して過度のバッファーを防止します。  
+  
+#### MaxStringContentLength  
+ このクォータは、XML リーダーが返す文字列の最大サイズを制限します。 このクォータは、XML リーダー自体のメモリ消費は制限しませんが、このリーダーを使用するコンポーネントのメモリ消費を制限します。 たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> が <xref:System.Xml.XmlDictionaryReaderQuotas.MaxStringContentLength%2A> でセキュリティ保護されたリーダーを使用するときは、このクォータを超える文字列を逆シリアル化することはありません。<xref:System.Xml.XmlDictionaryReader> クラスを直接使用すると、すべてのメソッドではなく、文字列を読み取ることを目的としたメソッド \(<xref:System.Xml.XmlDictionaryReader.ReadContentAsString%2A> メソッドなど\) だけがこのクォータに従います。 リーダー上の <xref:System.Xml.XmlReader.Value%2A> プロパティはこのクォータの影響を受けないので、このクォータによる保護が必要な場合はこのプロパティを使用しないでください。  
+  
+#### MaxArrayLength  
+ このクォータは、XML リーダーが返すプリミティブ配列 \(バイト配列など\) の最大サイズを制限します。 このクォータは、XML リーダー自体のメモリ消費は制限しませんが、このリーダーを使用するコンポーネントのメモリ消費を制限します。 たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> が <xref:System.Xml.XmlDictionaryReaderQuotas.MaxArrayLength%2A> でセキュリティ保護されたリーダーを使用するときは、このクォータを超えるバイト配列を逆シリアル化することはありません。 1 つのコントラクトでストリーミングとバッファー プログラミング モデルを混合する場合は、このクォータを設定することが重要です。<xref:System.Xml.XmlDictionaryReader> クラスを直接使用すると、特定のプリミティブ型の任意のサイズの配列を読み取ることを目的としたメソッド \(<xref:System.Xml.XmlDictionaryReader.ReadInt32Array%2A> メソッドなど\) だけがこのクォータに従います。  
+  
+## バイナリ エンコーディングに固有の脅威  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がサポートするバイナリ XML エンコーディングには、*ディクショナリ文字列*機能があります。 長い文字列をわずかなバイト数でエンコードすることができます。 これによって、パフォーマンスは大幅に向上しますが、新たなサービス拒否攻撃の脅威を招き、その対策が必要になります。  
+  
+ ディクショナリには、*静的ディクショナリ*と*動的ディクショナリ*の 2 種類があります。 静的ディクショナリは、バイナリ エンコーディングで短いコードを使用して表現できる長い文字列の組み込みリストです。 この文字列のリストは、リーダーの作成時に固定され、変更できません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が既定で使用する静的ディクショナリ内の文字列はいずれも、重大なサービス拒否攻撃の脅威を招くほど長くありません。ただし、ディクショナリ拡大攻撃に使用される可能性はあります。 独自の静的ディクショナリを使用する高度なシナリオでは、長いディクショナリ文字列を追加するときに注意が必要です。  
+  
+ 動的ディクショナリ機能では、メッセージで独自の文字列を定義し、その文字列を短いコードに関連付けることができます。 この文字列とコードのマッピングは、通信セッション中にメモリに格納されるので、後続のメッセージは文字列を再送信する必要がなく、既に定義されているコードを利用できます。 この文字列は、任意の長さになるので、静的ディクショナリの場合よりも重大な脅威を招く可能性があります。  
+  
+ 軽減する必要がある第 1 の脅威は、動的ディクショナリ \(文字列とコードのマッピング テーブル\) が大きくなりすぎる可能性です。 このディクショナリは、複数のメッセージを処理するうちに拡大する可能性があります。`MaxReceivedMessageSize` クォータは各メッセージに個別に適用されるだけなので、このクォータで保護することはできません。 このため、<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement.MaxSessionSize%2A> にはディクショナリのサイズを制限する個別の <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> プロパティがあります。  
+  
+ 他のほとんどのクォータと異なり、このクォータはメッセージの書き込み時にも適用されます。 メッセージの読み取り時にこのクォータを超えた場合は、`QuotaExceededException` が通常どおりスローされます。 メッセージの書き込み時にこのクォータを超えた場合は、クォータの超過を引き起こす文字列はそのまま書き込まれますが、動的ディクショナリ機能は使用されません。  
+  
+### ディクショナリ拡大攻撃  
+ 重大なバイナリ固有の攻撃は、ディクショナリの拡大が原因で発生します。 文字列ディクショナリ機能を利用した場合、バイナリ形式の小さいメッセージが、完全に展開されたテキスト形式では非常に大きいメッセージになることがあります。 動的ディクショナリの文字列がディクショナリ全体の最大サイズを超えることはないため、動的ディクショナリの文字列の拡大要因は、<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement.MaxSessionSize%2A> クォータで制限できます。  
+  
+ <xref:System.Xml.XmlDictionaryReaderQuotas.MaxNameTableCharCount%2A>、`MaxStringContentLength`、および `MaxArrayLength` の各プロパティで制限されるのは、メモリ消費だけです。 メモリ使用量は `MaxReceivedMessageSize` によって既に制限されているため、通常、ストリーミングを使用しない状況で脅威を軽減するためにこれらのプロパティを使用する必要はありません。 ただし、`MaxReceivedMessageSize`  では、展開前のバイト数がカウントされます。 バイナリ エンコーディングを使用しているとき、メモリ消費は、`MaxReceivedMessageSize` という因数によってのみ制限される、<xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement.MaxSessionSize%2A> を超える可能性があります。 このため、バイナリ エンコーディングを使用するときはすべてのリーダーのクォータ \(特に <xref:System.Xml.XmlDictionaryReaderQuotas.MaxStringContentLength%2A>\) を必ず設定することが重要です。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> と共にバイナリ エンコーディングを使用する場合、`IExtensibleDataObject` インターフェイスを誤用して、ディクショナリ拡大攻撃を引き起こす可能性があります。 このインターフェイスは、コントラクトの一部でない任意のデータに対して無制限のストレージを提供します。`MaxSessionSize` に `MaxReceivedMessageSize` を掛けた値によって問題が起こらない程度に低くクォータを設定できない場合は、バイナリ エンコーディングを使用するときに `IExtensibleDataObject` 機能を無効にします。`IgnoreExtensionDataObject`  属性では `true` プロパティを `ServiceBehaviorAttribute` に設定します。 または `IExtensibleDataObject` インターフェイスを実装しないという方法もあります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)。  
+  
+### クォータの概要  
+ 次の表では、クォータを使用するときのヒントを示します。  
+  
+|条件|設定が重要なクォータ|  
+|--------|----------------|  
+|ストリーミングのない、またはストリーミングのある小さいメッセージ、テキスト、MTOM エンコーディング|`MaxReceivedMessageSize`、`MaxBytesPerRead`、および `MaxDepth`|  
+|ストリーミングのない、またはストリーミングのある小さいメッセージ、バイナリ エンコーディング|`MaxReceivedMessageSize`、`MaxSessionSize`、およびすべての `ReaderQuotas`|  
+|大きいストリーミング メッセージ、テキスト、MTOM エンコーディング|`MaxBufferSize` およびすべての `ReaderQuotas`|  
+|大きいストリーミング メッセージ、バイナリ エンコーディング|`MaxBufferSize`、`MaxSessionSize`、およびすべての `ReaderQuotas`|  
+  
+-   トランスポート レベルのタイムアウトを常に設定する必要があります。ストリーミングを使用するときは、ストリーミングするメッセージが大きいか小さいかに関係なく、同期読み取りと書き込みを使用しないでください。  
+  
+-   クォータについて確信がない場合は、そのクォータを未決定のままにするのではなく、安全な値を設定します。  
+  
+## 悪質なコードの実行の防止  
+ 主に、次の種類の脅威が、コードを実行し、意図しない結果をもたらす可能性があります。  
+  
+-   デシリアライザーが、悪質、安全でない、またはセキュリティに注意する必要がある型を読み込んでしまう。  
+  
+-   受信メッセージが原因で、デシリアライザーが通常は安全な型のインスタンスを作成する際に、意図しない結果を引き起こすようなインスタンスが生成されてしまう。  
+  
+ 次の各セクションで、これらの種類の脅威について詳しく説明します。  
+  
+## DataContractSerializer  
+ \(<xref:System.Xml.Serialization.XmlSerializer> のセキュリティ情報については、関連ドキュメントを参照してください\)。<xref:System.Xml.Serialization.XmlSerializer> のセキュリティ モデルは、<xref:System.Runtime.Serialization.DataContractSerializer> のセキュリティ モデルに似ていますが、細かい部分が異なります。 たとえば、型を含めるために、<xref:System.Xml.Serialization.XmlIncludeAttribute> 属性ではなく <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性が使用されます。<xref:System.Xml.Serialization.XmlSerializer> に固有のいくつかの脅威については、このトピックの後半で説明します。  
+  
+### 意図しない型の読み込み防止  
+ 意図しない型を読み込むと、その型が悪質である場合も、単にセキュリティに影響するような副作用がある型の場合も、重大な結果を引き起こす可能性があります。 型は、悪用されやすいセキュリティの脆弱性を含んでいたり、その型のコンストラクターまたはクラス コンストラクターでセキュリティに影響するアクションを実行したりする可能性があります。また、サービス拒否攻撃の実行を容易にしてしまうほどメモリ フットプリントが大きい場合や、回復不可能な例外をスローする場合もあります。 型には、インスタンスが作成されるよりも前に、その型が読み込まれると直ちに実行されるクラス コンストラクターが用意されている可能性があります。 これらの理由から、デシリアライザーがどのような型を読み込むかを制御することが重要です。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> での逆シリアル化は、疎結合的な方法で行われます。 共通言語ランタイム \(CLR\) 型とアセンブリ名は、受信データから読み取られません。 これは、<xref:System.Xml.Serialization.XmlSerializer> の動作と似ていますが、<xref:System.Runtime.Serialization.NetDataContractSerializer>、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>、および <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> の動作とは異なります。 疎結合的な方法をとることによって、ある程度の安全を確保できます。リモートの攻撃者は、メッセージ内で型の名前を示すだけでは、意図した型が読み込まれるように指定することができません。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> は常に、コントラクトに基づいて現在予期される型を読み込むことができます。 たとえば、データ コントラクトに `Customer` 型のデータ メンバーが含まれている場合、<xref:System.Runtime.Serialization.DataContractSerializer> は、このデータ メンバーを逆シリアル化するときに `Customer` 型を読み込むことができます。  
+  
+ また、<xref:System.Runtime.Serialization.DataContractSerializer> はポリモーフィズムをサポートします。 データ メンバーを <xref:System.Object> として宣言しておき、受信データに `Customer` インスタンスを含めることができます。 これが可能なのは、次のいずれかのメカニズムにより、`Customer` 型がデシリアライザーに対して既知の型になっている場合だけです。  
+  
+-   型に <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を適用する。  
+  
+-   `KnownTypeAttribute` 属性で、型のリストを返すメソッドを指定する。  
+  
+-   `ServiceKnownTypeAttribute` 属性を使用する。  
+  
+-   `KnownTypes` 構成セクションを使用する。  
+  
+-   構築時に <xref:System.Runtime.Serialization.DataContractSerializer> に既知の型のリストを明示的に渡す \(シリアライザーを直接使用している場合\)。  
+  
+ これらのメカニズムを使用すると、デシリアライザーが読み込むことのできる型が追加されるので、攻撃を受け得る表面積は拡大します。 既知の型リストに、悪質な型または意図しない型が追加されることのないように、これらのメカニズムを制御する必要があります。  
+  
+ 型が既知の型リストに追加されると、コントラクトでその型の使用が禁止されている場合でも、その型をいつでも読み込むことができ、その型のインスタンスを作成できるようになります。 たとえば、前述のメカニズムのいずれかを使用して "MyDangerousType" という型が既知の型のリストに追加されるとします。 これによって、次のことが起こります。  
+  
+-   `MyDangerousType` が読み込まれ、そのクラス コンストラクターが実行されます。  
+  
+-   文字列データ メンバーが指定されたデータ コントラクトを逆シリアル化している場合でも、悪質なメッセージによって `MyDangerousType` のインスタンスが作成される可能性があります。 プロパティの setter など、`MyDangerousType` のコードが実行される可能性があります。 その後で、デシリアライザーが文字列データ メンバーにこのインスタンスを割り当てる動作を試行し、例外が発生して失敗します。  
+  
+ 既知の型のリストを返すメソッドを作成する場合、またはリストを直接 <xref:System.Runtime.Serialization.DataContractSerializer> コンストラクターに渡す場合は、リストを準備するためのコードをセキュリティで保護し、信頼されたデータだけを操作対象にします。  
+  
+ 構成で既知の型を指定する場合は、構成ファイルをセキュリティで保護します。 構成では必ず厳密な名前を使用します \(型が含まれている署名付きアセンブリの公開キーを指定します\)。ただし、読み込む型のバージョンは指定しないでください。 型ローダーにより、可能であれば最新のバージョンが自動的に選択されます。 セキュリティの脆弱性を持つ型の場合、その脆弱性が今後のバージョンで修正される可能性があります。しかし、構成でバージョンを明示的に指定していると、脆弱なバージョンが引き続き読み込まれます。構成で特定のバージョンを指定した場合には、このリスクを負うことになります。  
+  
+ 既知の型が多すぎると、もう 1 つ問題が生じます。<xref:System.Runtime.Serialization.DataContractSerializer> は、アプリケーション ドメインでシリアル化コードまたは逆シリアル化コードのキャッシュを作成し、シリアル化または逆シリアル化する必要がある型ごとにエントリを作成します。 このキャッシュは、アプリケーション ドメインの実行中はクリアされません。 このため、アプリケーションに多くの既知の型が使用されていることを知る攻撃者は、これらの既知の型がすべて逆シリアル化され、キャッシュで大量のメモリが消費されるように仕向けることが可能です。  
+  
+### 型の意図しない状態の防止  
+ 型には、従う必要がある内部の一貫性に対する制約が存在することがあります。 逆シリアル化中にこの制約に違反しないように注意する必要があります。  
+  
+ 次の型は、宇宙船でのエアロックの状態を表します。この型では、内側のドアと外側のドアを両方同時に開くことはできないという制約が適用されます。  
+  
+ [!code-csharp[DataContractAttribute#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/datacontractattribute/cs/overview.cs#3)]
+ [!code-vb[DataContractAttribute#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/datacontractattribute/vb/overview.vb#3)]  
+  
+ 攻撃者は、次のような悪質なメッセージを送信することによってこの制約を迂回し、オブジェクトを無効な状態にする可能性があります。これにより、意図しない予測不可能な結果を招くおそれがあります。  
+  
+```  
+<SpaceStationAirlock>  
+    <innerDoorOpen>true</innerDoorOpen>  
+    <outerDoorOpen>true</outerDoorOpen>  
+</SpaceStationAirlock>  
+```  
+  
+ このような状況は、次の点を知っていると防止できます。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> で逆シリアル化が行われる際に、ほとんどのクラスで、コンストラクターが実行されません。 このため、コンストラクターで実行される状態管理には依存できません。  
+  
+-   コールバックを使用して、オブジェクトを確実に有効な状態にします。<xref:System.Runtime.Serialization.OnDeserializedAttribute> 属性でマークされたコールバックは、逆シリアル化の完了後に実行され、全体の状態を調査して訂正できるので便利です。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [バージョン トレラントなシリアル化コールバック](../../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)。  
+  
+-   データ コントラクト型は、プロパティの setter が特定の順序で呼び出されなくてもよいように設計します。  
+  
+-   <xref:System.SerializableAttribute> 属性でマークされた従来の型を使用する場合は十分に注意します。 このような型のほとんどは、信頼されたデータのみで使用するために、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] リモート処理で操作することを目的に設計されています。 この属性でマークされた既存の型は、状態の安全性を考えて設計されていない可能性があります。  
+  
+-   状態の安全性に関しては、データの存在を保証するために、<xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A> 属性の `DataMemberAttribute` プロパティに依存することはできません。 データは常に `null`、`zero`、または `invalid` になります。  
+  
+-   信頼できないデータ ソースから逆シリアル化されたオブジェクト グラフは、検証せずに信頼してはいけません。 各オブジェクトが整合状態にあっても、オブジェクト グラフ全体としては整合状態にない場合があります。 さらに、オブジェクト グラフの保存モードが無効になっている場合でも、逆シリアル化されたグラフに、同じオブジェクトへの複数の参照または循環参照が存在することがあります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)。  
+  
+### NetDataContractSerializer の安全な使用  
+ <xref:System.Runtime.Serialization.NetDataContractSerializer> は、型に対して密結合を使用するシリアル化エンジンです。 これは、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> および <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> に類似しています。 つまり、このシリアル化エンジンでは、受信データから [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アセンブリと型名を読み取って、インスタンス化する型を決定します。 このシリアル化エンジンは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の一部ですが、このエンジンにプラグインする方法は用意されていないため、カスタム コードを記述する必要があります。`NetDataContractSerializer` は、主に、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] リモート処理から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行を容易にするためのものです。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)」の関連セクションを参照してください。  
+  
+ 読み込むことができる型はメッセージ自身が示すことができるため、<xref:System.Runtime.Serialization.NetDataContractSerializer> のメカニズムは本質的にセキュリティで保護されていません。このエンジンでは、信頼されたデータだけを使用してください。<xref:System.Runtime.Serialization.NetDataContractSerializer.Binder%2A> プロパティを使用して、セキュリティで保護され、型を限定する型バインダーを記述して、安全な型の読み込みだけを許可することによって、このエンジンをセキュリティで保護された状態にすることができます。  
+  
+ 信頼されたデータを使用している場合でも、特に <xref:System.Runtime.Serialization.NetDataContractSerializer.AssemblyFormat%2A> プロパティが <xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle> に設定されている場合は、読み込む型が受信データで適切に指定されないことがあります。 アプリケーションのディレクトリまたはグローバル アセンブリ キャッシュにアクセスできればだれにでも、読み込むべき型の代わりに、悪質な型を配置することができます。 アクセス許可を適切に設定することによって、アプリケーション ディレクトリとグローバル アセンブリ キャッシュのセキュリティを必ず確保してください。  
+  
+ 通常、部分信頼コードで `NetDataContractSerializer` インスタンスにアクセスしたり、サロゲート セレクター \(<xref:System.Runtime.Serialization.ISurrogateSelector>\) やシリアル化バインダー \(<xref:System.Runtime.Serialization.SerializationBinder>\) を制御したりできるようにすると、コードによってシリアル化と逆シリアル化のプロセスが細かく制御される可能性があります。 たとえば、コードによって任意の型が挿入されたり、情報漏えいにつながったりする場合があります。また、生成されたオブジェクト グラフやシリアル化されたデータが改ざんされたり、生成されたシリアル化ストリームをオーバーフローさせたりする場合もあります。  
+  
+ `NetDataContractSerializer` に関するもう 1 つのセキュリティの問題は、悪質なコードの実行ではなく、サービス拒否攻撃です。`NetDataContractSerializer` を使用する場合は、必ず <xref:System.Runtime.Serialization.NetDataContractSerializer.MaxItemsInObjectGraph%2A> クォータを安全な値に設定してください。 サイズがこのクォータでしか制限されないようなオブジェクトであれば、そのオブジェクトの配列を割り当てるための悪質な小さいメッセージを作成することは容易です。  
+  
+### XmlSerializer 固有の脅威  
+ <xref:System.Xml.Serialization.XmlSerializer> のセキュリティ モデルは、<xref:System.Runtime.Serialization.DataContractSerializer> のセキュリティ モデルに似ています。 ただし、<xref:System.Xml.Serialization.XmlSerializer> に固有の脅威がいくつか存在します。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> は、実際にシリアル化と逆シリアル化を実行するコードが含まれた*シリアル化アセンブリ*を実行時に生成します。これらのアセンブリは、ファイルの一時ディレクトリに作成されます。 他のプロセスまたはユーザーがこのディレクトリにアクセスできる場合は、シリアル化または逆シリアル化のコードが任意のコードで上書きされる可能性があります。 その結果、シリアル化または逆シリアル化のコードではなく、上書き後のコードのセキュリティ コンテキストを使用して、<xref:System.Xml.Serialization.XmlSerializer> がこのコードを実行します。 一時ファイルのディレクトリへのアクセス許可が適切に設定されていることを確認し、この状況が起こらないようにしてください。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> には、シリアル化アセンブリを実行時に生成するのではなく、事前生成済みのシリアル化アセンブリを使用するモードもあります。 このモードは、<xref:System.Xml.Serialization.XmlSerializer> が適切なシリアル化アセンブリを検出できるとトリガーされます。<xref:System.Xml.Serialization.XmlSerializer> は、シリアル化アセンブリの署名に使用されているキーが、シリアル化する型を含むアセンブリの署名に使用されたものと同じであるかどうかをチェックします。 このチェックによって、シリアル化アセンブリに偽装した悪質なアセンブリからの保護が可能になります。 ただし、シリアル化可能な型を含むアセンブリが署名されていない場合、<xref:System.Xml.Serialization.XmlSerializer> はこのチェックを実行できず、正しい名前を持つ任意のアセンブリを使用することになります。 これによって、悪質なコードの実行が生じる可能性があります。 シリアル化可能な型が属するアセンブリに必ず署名するか、アプリケーション ディレクトリとグローバル アセンブリ キャッシュへのアクセスを厳密に制御することによって、悪質なアセンブリの侵入を防止します。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> は、サービス拒否攻撃にもさらされる可能性があります。<xref:System.Xml.Serialization.XmlSerializer> には、\(`MaxItemsInObjectGraph` で利用できるような\) <xref:System.Runtime.Serialization.DataContractSerializer> クォータがありません。 したがって、逆シリアル化されるオブジェクトの量は、メッセージ サイズによってのみ制限されるため、不定になります。  
+  
+### 部分信頼に関する脅威  
+ 部分信頼で実行されているコードに関連する脅威について、以下の懸念事項に注意してください。 これらの脅威には、悪質な部分信頼コードと、他の攻撃シナリオと結びついた悪質な部分信頼コード \(特定の文字列を作成し、それを逆シリアル化する部分信頼コードなど\) があります。  
+  
+-   シリアル化コンポーネントを使用するときは、使用前にどのアクセス許可もアサートしないでください。これは、シリアル化シナリオ全体がアサートのスコープ内であり、信頼できないデータまたはオブジェクトは処理しない場合も同様です。 アクセス許可をアサートすると、セキュリティ上の脆弱性の原因となる場合があります。  
+  
+-   部分信頼コードで拡張ポイント \(サロゲート\)、シリアル化する型、または他の方法によってシリアル化プロセスを制御している場合、部分信頼コードが原因でシリアライザーが大量のデータをシリアル化ストリームに出力し、このストリームの受信側に対してサービス拒否 \(DoS: Denial of Service\) を引き起こす可能性があります。 DoS の脅威の影響を受けやすいターゲットを対象とするデータをシリアル化する場合、部分信頼の型をシリアル化したり、部分信頼コードでシリアル化を制御したりしないでください。  
+  
+-   部分信頼コードで <xref:System.Runtime.Serialization.DataContractSerializer> インスタンスにアクセスしたり、[データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md) を制御したりできるようにすると、部分信頼コードによってシリアル化と逆シリアル化のプロセスが細かく制御される可能性があります。 たとえば、コードによって任意の型が挿入されたり、情報漏えいにつながったりする場合があります。また、生成されたオブジェクト グラフやシリアル化されたデータが改ざんされたり、生成されたシリアル化ストリームをオーバーフローさせたりする場合もあります。<xref:System.Runtime.Serialization.NetDataContractSerializer> に関する同等の脅威については、「NetDataContractSerializer の安全な使用」で説明しています。  
+  
+-   <xref:System.Runtime.Serialization.DataContractAttribute> 属性が型 \(または `[Serializable]` ではなく `ISerializable` とマークされた型\) に適用されている場合、すべてのコンストラクターが非パブリックであるか、または要求で保護されている場合でも、デシリアライザーはこのような型のインスタンスを作成できます。  
+  
+-   逆シリアル化されるデータが信頼できるものであり、すべての既知の型が信頼した型であることが確実である場合を除き、逆シリアル化の結果を信頼しないでください。 部分信頼で実行されている場合、既知の型はアプリケーション構成ファイルから読み込まれません \(ただし、コンピューター構成ファイルからは読み込まれます\)。  
+  
+-   部分信頼コードに追加されたサロゲートと共に `DataContractSerializer` インスタンスを渡すと、コードによってそのサロゲートの変更可能な設定が変更される可能性があります。  
+  
+-   逆シリアル化されたオブジェクトでは、XML リーダー \(またはそれに含まれるデータ\) が部分信頼コードからのものである場合、結果の逆シリアル化されたオブジェクトを信頼できないデータとして扱ってください。  
+  
+-   <xref:System.Runtime.Serialization.ExtensionDataObject> 型がパブリック メンバーを含んでいなくても、それに含まれるデータが安全であるとは限りません。 たとえば、特権が付与されたデータ ソースから、いくつかのデータを含むオブジェクトに逆シリアル化し、そのオブジェクトを部分信頼コードに渡した場合、部分信頼コードは、オブジェクトをシリアル化して `ExtensionDataObject` のデータを読み取ることができます。 特権が付与されたデータ ソースから、後で部分信頼コードに渡されるオブジェクトに逆シリアル化する場合は、<xref:System.Runtime.Serialization.DataContractSerializer.IgnoreExtensionDataObject%2A> を `true` に設定するよう考慮してください。  
+  
+-   完全信頼では、<xref:System.Runtime.Serialization.DataContractSerializer> および <xref:System.Runtime.Serialization.DataContractJsonSerializer> が、プライベート メンバー、プロテクト メンバー、内部メンバー、およびパブリック メンバーのシリアル化をサポートします。 一方、部分信頼ではパブリック メンバーのシリアル化のみが可能です。 アプリケーションがパブリック メンバー以外のメンバーのシリアル化を試みると、`SecurityException` がスローされます。  
+  
+     部分信頼で内部メンバーまたはプロテクト内部メンバーをシリアル化するには、`System.Runtime.CompilerServices.InternalsVisibleTo` アセンブリ属性を使用します。 この属性を使用すると、アセンブリは内部メンバーが他のアセンブリから参照できることを宣言できます。 この場合、内部メンバーのシリアル化が必要なアセンブリは、その内部メンバーが System.Runtime.Serialization.dll から参照できることを宣言します。  
+  
+     この方法の利点は、昇格されたコード生成パスが不要なことです。  
+  
+     ただし、2 つの大きな欠点もあります。  
+  
+     1 つ目の欠点は、`InternalsVisibleTo` 属性のオプトイン プロパティがアセンブリ全体に適用されることです。 つまり、特定のクラスに対してのみ内部メンバーのシリアル化を可能にするような指定はできません。 もちろん、`DataMember` 属性をメンバーに追加しないことで、特定の内部メンバーをシリアル化しないことは可能です。 同様に、メンバーをプライベート メンバーまたはプロテクト メンバーではなく内部メンバーにすることもできますが、参照可能範囲の問題が残ります。  
+  
+     2 つ目の欠点は、プライベート メンバーやプロテクト メンバーがサポートされないことです。  
+  
+     部分信頼での `InternalsVisibleTo` 属性の使用を理解するために、次のプログラムについて考えてみましょう。  
+  
+     [!code-csharp[CDF_WCF_SecurityConsiderationsForData#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/cdf_wcf_securityconsiderationsfordata/cs/program.cs#1)]  
+  
+     上の例で、`PermissionsHelper.InternetZone` は部分信頼の `PermissionSet` に対応します。 ここで、`InternalsVisibleToAttribute` を指定しなければ、パブリック メンバー以外のメンバーは部分信頼でシリアル化できないことを示す `SecurityException` がスローされてアプリケーションは失敗します。  
+  
+     ただし、ソース ファイルに次の行を追加すると、プログラムは正常に実行されます。  
+  
+     [!code-csharp[CDF_WCF_SecurityConsiderationsForData#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/cdf_wcf_securityconsiderationsfordata/cs/program.cs#2)]  
+  
+## 状態管理に関するその他の注意事項  
+ オブジェクトの状態管理に関してその他の注意すべき点を以下に示します。  
+  
+-   ストリーミング トランスポートでストリーム ベースのプログラミング モデルを使用した場合、メッセージが到着するとメッセージの処理が開始されます。 メッセージの送信側によってストリームの途中で送信操作が中止されることはあり得ますが、このとき続きのコンテンツを待機していた場合、コードの状態を予想できなくなります。 一般に、ストリームは完全であると考えないでください。また、ストリーミングが中止されたときにロールバックできないようなストリーム ベースの操作では、処理を行わないでください。 このことは、ストリーミングの本文の後に続くメッセージの形式が正しくない可能性があるような状況にも当てはまります \(たとえば、SOAP エンベロープの終了タグが不足している、または 2 つ目のメッセージ本文があるなど\)。  
+  
+-   `IExtensibleDataObject` 機能を使用すると、機密データが出力される可能性があります。`IExtensibleObjectData` を含むデータ コントラクトに、信頼できない送信元のデータを受け入れ、その後、メッセージが署名される、セキュリティで保護されたチャネルにそのデータを再送した場合、一切確認していないデータを保証していることになります。 さらに、既知のデータと不明なデータの両方を考慮すると、送信している全体の状態が無効になる可能性があります。 このような状況を回避するには、拡張データ プロパティを `null` に設定するか、`IExtensibleObjectData` 機能を無効にします。  
+  
+## スキーマのインポート  
+ 通常、型を生成するためにスキーマをインポートするプロセスは、設計時にのみ発生します。たとえば、クライアント クラスを生成するために Web サービス上で [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用しているときなどです。 ただし、さらに高度なシナリオでは、スキーマを実行時に処理することがあります。 この場合、サービス拒否攻撃の危険にさらされる可能性があることを覚えておく必要があります。 スキーマによっては、インポートに時間がかかる場合があります。 スキーマが信頼できないソースからのものである可能性がある場合は、このようなシナリオで <xref:System.Xml.Serialization.XmlSerializer> のスキーマ インポート コンポーネントを使用しないでください。  
+  
+## ASP.NET AJAX 統合に固有の脅威  
+ ユーザーが <xref:System.ServiceModel.Description.WebScriptEnablingBehavior> または <xref:System.ServiceModel.Description.WebHttpBehavior> を実装すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は XML メッセージと JSON メッセージの両方を受け入れることができるエンドポイントを公開します。 ただし、XML リーダーと JSON リーダーの両方が使用するリーダー クォータのセットは 1 つしかありません。 一部のクォータ設定が一方のリーダーには適切であっても、もう一方のリーダーには大きすぎる場合があります。  
+  
+ `WebScriptEnablingBehavior` を実装すると、ユーザーはエンドポイントで JavaScript プロキシを公開するオプションを使用できます。 セキュリティに関する次の問題を考慮する必要があります。  
+  
+-   JavaScript プロキシを調べることで、サービスに関する情報 \(操作名、パラメーター名など\) を取得できます。  
+  
+-   JavaScript エンドポイントを使用すると、機密性の高い情報やプライベートな情報がクライアントの Web ブラウザーのキャッシュに保持される可能性があります。  
+  
+## コンポーネントに関する注意事項  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、柔軟でカスタマイズ可能なシステムです。 このトピックのほとんどの内容は、最も一般的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の使用シナリオに基づいています。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供するコンポーネントは、複数の異なる方法で構築できます。 各コンポーネントを使用した場合のセキュリティへの影響について理解することが重要です。 特に次の点に注意してください。  
+  
+-   XML リーダーを使用する必要があるときは、<xref:System.Xml.XmlDictionaryReader> クラスに用意されたリーダーを使用し、それ以外のリーダーは使用しないようにします。 安全なリーダーは、<xref:System.Xml.XmlDictionaryReader.CreateTextReader%2A>、<xref:System.Xml.XmlDictionaryReader.CreateBinaryReader%2A>、<xref:System.Xml.XmlDictionaryReader.CreateMtomReader%2A> のいずれかのメソッドを使用して作成できます。<xref:System.Xml.XmlReader.Create%2A> メソッドは使用しないでください。 リーダーは、必ず安全なクォータを使用して設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のシリアル化エンジンがセキュリティで保護されるのは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供されるセキュリティで保護された XML リーダーを使用する場合だけです。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> を使用して、信頼できない可能性のあるデータを逆シリアル化する場合は、必ず <xref:System.Runtime.Serialization.DataContractSerializer.MaxItemsInObjectGraph%2A> プロパティを設定します。  
+  
+-   メッセージを作成する場合、`maxSizeOfHeaders`  による保護が十分でないときは `MaxReceivedMessageSize`  パラメーターを設定します。  
+  
+-   エンコーダーを作成する場合、`MaxSessionSize` や `MaxBufferSize` などの関連クォータを必ず設定します。  
+  
+-   XPath メッセージ フィルターを使用する場合は、<xref:System.ServiceModel.Dispatcher.XPathMessageFilter.NodeQuota%2A> を設定してそのフィルターがアクセスする XML ノードの量を制限します。 多数のノードにアクセスせず、計算に長い時間がかかる可能性がある XPath 式は使用しないようにします。  
+  
+-   通常、クォータを受け入れるコンポーネントを使用する場合は、そのセキュリティへの影響を理解し、クォータを安全な値に設定します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Xml.XmlDictionaryReader>   
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ [既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md b/docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md
new file mode 100644
index 00000000000..1b9c981e602
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md
@@ -0,0 +1,33 @@
+---
+title: "セキュリティで保護されたセッションに関するセキュリティの検討 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d5be591-9a7b-4a6f-a906-95d3abafe8db
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# セキュリティで保護されたセッションに関するセキュリティの検討
+セキュリティで保護されたセッションを実装する場合に、セキュリティに影響を及ぼす次の項目について考慮する必要があります。セキュリティの考慮事項[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)」および「[セキュリティのベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md)」を参照してください。  
+  
+## セキュリティで保護されたセッションとメタデータ  
+ セキュリティで保護されたセッションが確立され、<xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters.RequireCancellation%2A> プロパティが `false` に設定されると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はサービス エンドポイントの Web サービス記述言語 \(WSDL: Web Services Description Language\) ドキュメントにメタデータの一部として `mssp:MustNotSendCancel` アサーションを出力します。`mssp:MustNotSendCancel` アサーションは、クライアントに対してセキュリティで保護されたセッションのキャンセル要求にサービスが応答しないことを通知します。<xref:System.ServiceModel.Security.Tokens.SecureConversationSecurityTokenParameters.RequireCancellation%2A> プロパティが `true` に設定されている場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は WSDL ドキュメントに `mssp:MustNotSendCancel` アサーションを出力しません。セキュリティで保護されたセッションが必要でなくなった場合、クライアントはサービスに対してキャンセル要求を送る必要があります。[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してクライアントを生成した場合、クライアント コードは、`mssp:MustNotSendCancel` アサーションが存在するかどうかに対して適切に反応するようになります。  
+  
+## セキュリティ保護されたメッセージ交換とカスタム トークン  
+ WS\-SecureConversation 仕様での定義方法に起因する、カスタム トークンと派生キーの混在に関する問題があります。仕様では、派生トークンを参照するオプション要素の `wsse:SecurityTokenReference` について次のような記述があります。「`/wsc:DerivedKeyToken/wsse:SecurityTokenReference` このオプション要素は、派生用のセキュリティ コンテキスト トークン、セキュリティ トークン、または共有キーやシークレットの指定に使用されます。指定されていない場合、受信者はメッセージのコンテキストから共有キーを判断できると想定されます。コンテキストを判断できない場合は、`wsc:UnknownDerivationSource` などのエラーが発生します。」  
+  
+ つまり、カスタム トークンを派生させるには、`SecurityTokenReference` 要素にその句型をラップする必要があります。派生をオフにするオプションもありますが、キーを派生させるオプションが既定となっています。キーをラップしなかった場合、派生キー トークンのシリアル化は実行されますが、その逆シリアル化を試みると例外がスローされます。  
+  
+## 参照  
+ [方法 : WSFederationHttpBinding のセキュリティで保護されたセッションを無効にする](../../../../docs/framework/wcf/feature-details/how-to-disable-secure-sessions-on-a-wsfederationhttpbinding.md)   
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [セキュリティのベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-considerations-in-wcf.md b/docs/framework/wcf/feature-details/security-considerations-in-wcf.md
new file mode 100644
index 00000000000..e1a536f1158
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-considerations-in-wcf.md
@@ -0,0 +1,61 @@
+---
+title: "WCF でのセキュリティの考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF]"
+  - "WCF, セキュリティ"
+  - "Windows Communication Foundation, セキュリティ"
+ms.assetid: 42055ee0-6d0c-443d-9d89-788dfc345d6d
+caps.latest.revision: 49
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 49
+---
+# WCF でのセキュリティの考慮事項
+このセクションの各トピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションの設計時に考慮する必要のあるセキュリティ関連の各種項目を示します。  
+  
+## このセクションの内容  
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)  
+ 情報が開示または攻撃されるさまざまな方法、およびそれを軽減する方法について説明します。  
+  
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)  
+ 最初に付与されたものよりも高い承認アクセス許可を攻撃者に与えることの影響、およびそれを軽減する方法について説明します。  
+  
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)  
+ システムがメッセージを適切に処理できない場合の影響、およびそれを軽減する方法について説明します。  
+  
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)  
+ メッセージの改ざんやメッセージの配信先の変更、およびそれを軽減する方法について説明します。  
+  
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)  
+ 攻撃者がメッセージのストリームを送受信者間でコピーし、そのストリームを 1 つ以上の第三者に対してリプレイすることによる影響、およびそれを軽減する方法について説明します。  
+  
+ [セキュリティで保護されたセッションに関するセキュリティの検討](../../../../docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md)  
+ セキュリティで保護されたセッションを実装する場合に、セキュリティに影響を及ぼす次の項目について説明します。  
+  
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)  
+ セキュリティの特定の側面がサポートされないため、避けたり配慮したりする必要のあるさまざまなシナリオを示します。  
+  
+## 関連項目  
+ <xref:System.IdentityModel.Tokens>  
+  
+ <xref:System.IdentityModel.Claims>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+ <xref:System.ServiceModel>  
+  
+## 関連項目  
+ [セキュリティ ガイドラインとベスト プラクティス](../../../../docs/framework/wcf/feature-details/security-guidance-and-best-practices.md)  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-considerations-with-metadata.md b/docs/framework/wcf/feature-details/security-considerations-with-metadata.md
new file mode 100644
index 00000000000..8525c134d53
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-considerations-with-metadata.md
@@ -0,0 +1,50 @@
+---
+title: "メタデータを使用する場合のセキュリティ上の考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e78ef8ab-4f63-4656-ab93-b1deab2666d5
+caps.latest.revision: 10
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 10
+---
+# メタデータを使用する場合のセキュリティ上の考慮事項
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のメタデータの機能を使用するときは、サービス メタデータの公開、取得、および使用によって生じるセキュリティへの影響を考慮する必要があります。  
+  
+## メタデータを公開する場合と公開しない場合  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、既定ではメタデータを公開しない設定になっています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのメタデータを公開するには、メタデータ エンドポイントをサービスに追加することにより、メタデータの公開を明示的に指定する必要があります \(「[メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)」を参照\)。  メタデータの公開を無効のままにしておけば、攻撃者にとっては侵入経路が少ないことになり、したがって情報漏洩の危険を減らすことができます。  メタデータを公開する必要のないサービスもあります。  必要ないのであれば無効のままにしておくようお勧めします。  この状態でも、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すれば、サービス アセンブリから直接、メタデータやクライアント コードを生成できます。  Svcutil.exe を使用してメタデータをエクスポートする方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする](../../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md)」を参照してください。  
+  
+## セキュリティ保護されたバインディングによるメタデータの公開  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に組み込まれた既定のメタデータ バインディングはセキュリティ保護されておらず、メタデータへの匿名アクセスを許可するようになっています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが公開するサービス メタデータにはサービスに関する詳細な記述があるので、故意または過失により、重要な情報が漏洩するおそれがあります。  たとえば、一般に公開するべきではない、インフラストラクチャ操作に関する情報が入った状態で発行される可能性があるのです。  権限のないアクセスを拒否する方法として、メタデータ エンドポイントで、セキュリティ保護されたバインディングを使う、というものがあります。  メタデータ エンドポイントは HTTP\/GET 要求に応答しますが、ここに SSL \(Secure Sockets Layer\) を使用すれば、メタデータを保護できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : セキュリティで保護されたメタデータ エンドポイント](../../../../docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md).  
+  
+ メタデータ エンドポイントを保護することで、正当なユーザーが、改ざんやなりすましを恐れずに安全にサービス メタデータを取得できる手段も提供されます。  
+  
+## 信頼できるメタデータのみを使用  
+ サービス メタデータを使用すると、サービスの呼び出しに必要なランタイム コンポーネントを自動構築できます。  たとえば、設計時には、クライアント アプリケーションを開発するためにメタデータを利用できます。また、実行時には、メタデータを利用して、クライアントがサービス呼び出しのために使用するバインディングを動的に更新できます。  
+  
+ サービス メタデータを取得する際、セキュリティ保護された方法を使わないと、改ざんやなりすましのおそれがあります。  メタデータが改ざんされると、知らない間に悪質なサービスに接続されたり、セキュリティ上問題のある設定に切り替えられたり、XML 構造が破壊されたりすることがあります。  メタデータ ドキュメントはかなりの容量になることがあるので、多くの場合、ファイル システムに保存することになります。  改ざんやなりすましを防ぐために、サービス メタデータを要求するときには、できるだけセキュリティで保護されたバインディングを使用してください。  
+  
+## 安全な技術を使ってメタデータを処理  
+ サービス メタデータは多くの場合、MEX \(WS\-Metadata Exchange\) などの標準的なプロトコルを使用して、ネットワーク経由で伝送されます。  メタデータの形式を見ると、多くの場合、他のメタデータを参照する旨の記述ができるようになっています。  <xref:System.ServiceModel.Description.MetadataExchangeClient> 型は、Web サービス記述言語 \(WSDL\) ドキュメント、XML スキーマ、および MEX ドキュメント内の参照を自動的に処理します。  取得したメタデータから生成される <xref:System.ServiceModel.Description.MetadataSet> オブジェクトのサイズは、使用されている <xref:System.ServiceModel.Description.MetadataExchangeClient> インスタンスの <xref:System.ServiceModel.Description.MetadataExchangeClient.MaximumResolvedReferences%2A> の値と、この <xref:System.ServiceModel.Description.MetadataExchangeClient> インスタンスが使用するバインディングの `MaxReceivedMessageSize` の値に比例します。  動作環境に合わせてこのクォータ値を適切に設定してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービス メタデータは XML の形で処理されます。  XML ドキュメントを処理するアプリケーションは、悪質な XML 構造が現れても破綻しないようになっていなければなりません。  XML を処理するときは、`XmlDictionaryReader` に適切なクォータ値を設定して使用すると共に、<xref:System.Xml.XmlReader> インスタンスに対する <xref:System.Xml.XmlReaderSettings> オブジェクトの <xref:System.XML.XmlReaderSettings.ProhibitDtd%2A> プロパティを `true` に設定してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメタデータ システムは、メタデータ拡張をアプリケーションの構成ファイルに登録することにより、容易に拡張できるようになっています \(「[メタデータ システムの拡張](../../../../docs/framework/wcf/extending/extending-the-metadata-system.md)」を参照\)。  メタデータ拡張はどのようなコードでも実行できるので、適切なアクセス制御リスト \(ACL\) でアプリケーション構成ファイルを保護し、信頼できるメタデータ拡張以外は登録しないようにする必要があります。  
+  
+## 生成されたクライアントの検証  
+ 信頼できないソースから取得したメタデータを基にクライアント コードを生成した場合、これがクライアント アプリケーションのセキュリティ ポリシーに合致しているかどうか検証する必要があります。  動作を検証するための専用クライアントを使うか、あるいはツールが生成したコードを目視で検査してください。  動作を検証するためのクライアントを実装する例については、「[クライアント検証](../../../../docs/framework/wcf/samples/client-validation.md)」を参照してください。  
+  
+## アプリケーション構成ファイルの保護  
+ サービスのアプリケーション構成ファイルでは、メタデータを公開する方法、および公開の有無を制御できます。  攻撃者が設定を変更できないように、適切なアクセス制御リスト \(ACL\) でアプリケーション構成ファイルを保護することをお勧めします。  
+  
+## 参照  
+ [方法 : セキュリティで保護されたメタデータ エンドポイント](../../../../docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md)   
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-guidance-and-best-practices.md b/docs/framework/wcf/feature-details/security-guidance-and-best-practices.md
new file mode 100644
index 00000000000..f491a2fde50
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-guidance-and-best-practices.md
@@ -0,0 +1,36 @@
+---
+title: "セキュリティ ガイドラインとベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティで保護されたアプリケーション [WCF]"
+ms.assetid: 79e4e6f7-0c00-4045-b0f0-e6a7c37c7788
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# セキュリティ ガイドラインとベスト プラクティス
+このセクションのトピックでは、セキュリティで保護された [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションの作成に関するガイドラインおよび考慮事項を示します。Windows Server AppFabric およびセキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)」を参照してください。  
+  
+## このセクションの内容  
+ [セキュリティのベスト プラクティス](../../../../docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md)  
+ アプリケーションをセキュリティで保護する際に役立つ推奨事項を示します。  
+  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション作成時の考慮事項を示します。  
+  
+ [パフォーマンスに関する考慮事項](../../../../docs/framework/wcf/feature-details/performance-considerations.md)  
+ パフォーマンスとセキュリティに関連するトピックが含まれています。  
+  
+## 参照  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-negotiation-and-timeouts.md b/docs/framework/wcf/feature-details/security-negotiation-and-timeouts.md
new file mode 100644
index 00000000000..7ec7e6ae452
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-negotiation-and-timeouts.md
@@ -0,0 +1,24 @@
+---
+title: "セキュリティ ネゴシエーションとタイムアウト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02a428f1-84e5-4d28-a11f-53ce31d63196
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# セキュリティ ネゴシエーションとタイムアウト
+クライアントとサービスの認証では、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は認証の一環としてサービス資格情報をネゴシエートするモードをサポートします。このようなシナリオでは、サービス資格情報をクライアントに反映させるために、クライアントとサービスの間でマルチレッグ交換が発生する可能性があります。<xref:System.ServiceModel.Channels.LocalServiceSecuritySettings.NegotiationTimeout%2A> プロパティは、マルチレッグ交換の完了に要する時間を制御します。ただし、このタイムアウトは、実際に、単一の要求 \- 応答よりも長い時間が交換にかかる場合のみ適用されます。単一のラウンド トリップでネゴシエーションが完了する場合、このタイムアウトは適用されません。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.LocalServiceSecuritySettings>   
+ [方法 : 時刻のずれの最大値を設定する](../../../../docs/framework/wcf/feature-details/how-to-set-a-max-clock-skew.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-overview.md b/docs/framework/wcf/feature-details/security-overview.md
new file mode 100644
index 00000000000..34d8f34bc88
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-overview.md
@@ -0,0 +1,125 @@
+---
+title: "セキュリティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF, セキュリティ"
+  - "Windows Communication Foundation, セキュリティ"
+ms.assetid: f478c80d-792d-4e7a-96bd-a2ff0b6f65f9
+caps.latest.revision: 37
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 37
+---
+# セキュリティの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、SOAP メッセージに基づく分散プログラミングのプラットフォームです。データを保護するには、クライアントとサービス間のメッセージをセキュリティで保護することが不可欠です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、既存のセキュリティ インフラストラクチャと、認識されている SOAP メッセージのセキュリティ標準の両方に基づき、セキュリティで保護されたメッセージを交換する汎用的で相互運用可能なプラットフォームを提供します。  
+  
+> [!NOTE]
+>  WCF セキュリティの包括的なガイドについては、「[WCF セキュリティ ガイダンス](http://go.microsoft.com/fwlink/?LinkID=158912)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTPS、Windows 統合セキュリティ、ユーザー認証のためのユーザー名とパスワードなど、既存の技術を使用してセキュリティで保護された分散アプリケーションを構築した経験のあるユーザーには、なじみのある概念を使用します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、既存のセキュリティ インフラストラクチャを統合するだけではありません。セキュリティで保護された SOAP メッセージを使用して Windows のみのドメインを超えて分散セキュリティを拡張します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] については、既存のプロトコルに加えて SOAP をプロトコルとして使用する大きな利点を兼ね備えた、既存のセキュリティ機構の実装と考えます。  たとえば、ユーザー名とパスワードや X.509 証明書など、クライアントまたはサービスを識別する資格情報には、相互運用可能な XML ベースの SOAP プロファイルがあります。  このプロファイルを使用して、XML デジタル署名や XML 暗号化などの公開仕様を利用するセキュリティで保護されたメッセージ交換を行います。  仕様の一覧については、「[システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)」を参照してください。  
+  
+ また他にも、Windows プラットフォームのコンポーネント オブジェクト モデル \(COM\) があり、セキュリティで保護された分散アプリケーションを実現します。  COM は、包括的なセキュリティ機構を有します。このセキュリティ機構により、セキュリティ コンテキストはコンポーネント間をフローできます。また、整合性、機密性、および認証を実現できます。  ただし COM では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が行うようなクロス プラットフォームでのセキュリティで保護されたメッセージ処理を実現できません。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、Windows ドメインからインターネットにまで及ぶサービスとクライアントを構築できます。  情報セキュリティに対する確信を持てるビジネス重視の動的サービスを構築するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の相互運用可能なメッセージが必須です。  
+  
+## Windows Communication Foundation セキュリティの利点  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SOAP メッセージに基づく分散プログラミングのプラットフォームです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、サービスとサービス クライアントの両方の機能のアプリケーションを構築でき、他の無数のサービスやクライアントからのメッセージを作成および処理できます。  このような分散アプリケーションでは、メッセージをノード間でフローさせ、ファイアウォールを経由してインターネットに送信し、多くの SOAP 中継局を経由させることができます。  しかしこれは、さまざまなメッセージ セキュリティの脅威を招きます。  エンティティ間でメッセージ交換を行うときに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティで軽減できる一般的な脅威の例をいくつか示します。  
+  
+-   機密情報を取得するネットワーク トラフィックの監視。  たとえば、オンライン バンキング シナリオを考えます。クライアントは口座間の資金の移動を要求します。  悪意のあるユーザーはメッセージを途中受信し、後で口座番号とパスワードを使用して、侵害した口座から資金を移動します。  
+  
+-   クライアントに気付かれることなくサービスとして動作する承認されていないエンティティ。  このシナリオでは、悪意のある \(承認されていない\) ユーザーがオンライン サービスとして動作し、クライアントからメッセージを途中受信して機密情報を取得します。  次にこの承認されていないユーザーは、盗んだデータを使用して侵害した口座から資金を転送します。  この攻撃は、*フィッシング攻撃*としても知られています。  
+  
+-   呼び出し元が意図したものと異なる結果を取得するようなメッセージの改ざん。  たとえば、預金先の口座番号を変更して、資金を承認されていない口座に移動できます。  
+  
+-   迷惑なハッカーは、同じ注文をリプレイします。  たとえば、オンライン書店は数百の注文を受け、注文していない顧客に書籍を送付します。  
+  
+-   クライアントを認証する能力の欠如。  この場合、サービスは、適切なユーザーがトランザクションを実行していることを保証できません。  
+  
+ 転送セキュリティが提供する保証を簡単に説明すると次のようになります。  
+  
+-   サービス エンドポイント \(応答者\) の認証  
+  
+-   クライアント プリンシパル \(イニシエーター\) の認証  
+  
+-   メッセージの整合性  
+  
+-   メッセージの機密性  
+  
+-   リプレイの検出  
+  
+### 既存のセキュリティ インフラストラクチャとの統合  
+ ほとんどの場合、Web サービス展開には、SSL \(Secure Sockets Layer\) や Kerberos プロトコルなどの既存のセキュリティ ソリューションが実装されています。  Active Directory を使用する Windows ドメインなど、既に展開されているセキュリティ インフラストラクチャを利用する場合もあります。  新しい技術を評価し採用している間に、これらの既存の技術と統合する必要が生じることはよくあります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティは、既存のトランスポート セキュリティ モデルを統合します。また、既存のインフラストラクチャを活用して SOAP メッセージ セキュリティに基づく新しいトランスポート セキュリティ モデルを実現することもできます。  
+  
+### 既存の認証モデルとの統合  
+ すべての通信セキュリティ モデルにとって、通信のエンティティを識別し認証する機能は重要です。  この通信のエンティティは、"デジタル ID" または資格情報を使用し、通信先のピアで自身を認証します。  分散型の通信プラットフォームの発展により、さまざまな資格情報認証モデルや関連セキュリティ モデルが実装されてきました。  たとえば、インターネットでは、ユーザー名とパスワードを使用してユーザーを識別することが一般的に行われています。  イントラネットでは、ユーザーとサービスの認証をサポートする Kerberos ドメイン コントローラーの使用が一般的になりつつあります。  たとえば、2 つのビジネス パートナー間での特定のシナリオでは、証明書を使用してお互いにパートナーを認証する場合もあります。  
+  
+ 同じサービスを企業内のユーザーや外部のパートナーまたはインターネット ユーザーに公開する Web サービスの世界では、インフラストラクチャがこのような既存のセキュリティ認証モデルとの統合に備えることが重要です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティは、次のようなさまざまな資格情報の種類 \(認証モデル\) をサポートします。  
+  
+-   匿名の呼び出し元  
+  
+-   ユーザー名クライアント資格情報  
+  
+-   証明書クライアント資格情報  
+  
+-   Windows \(Kerberos プロトコルと NT LanMan \[NTLM\] の両方\)  
+  
+### 標準と相互運用  
+ 既存の大規模展開の世界では、均一性はほとんどありません。  分散型のコンピューティングまたは通信のプラットフォームでは、さまざまなベンダーから提供される技術を相互運用する必要があります。  同様に、セキュリティも相互運用可能である必要があります。  
+  
+ 相互運用可能なセキュリティ システムを実現するため、Web サービス業界で活動する企業はさまざまな標準を作成してきました。  特にセキュリティに関して、注目すべき標準がいくつか提案されています。それは、WS\-Security の SOAP メッセージ セキュリティ \(標準化団体の OASIS で認められ正式には WS\-Security として知られる\)、WS\-Trust、WS\-SecureConversation、および WS\-SecurityPolicy です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、さまざまな相互運用可能なシナリオをサポートします。  <xref:System.ServiceModel.BasicHttpBinding> クラスは、基本セキュリティ プロファイル \(BSP\) を対象とし、<xref:System.ServiceModel.WSHttpBinding> クラスは、WS\-Security 1.1 や WS\-SecureConversation などの最新のセキュリティ標準を対象とします。  これらの標準に準拠することで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティは、Microsoft Windows 以外のオペレーティング システムやプラットフォームでホストされる Web サービスと相互運用および統合できます。  
+  
+## WCF セキュリティの機能領域  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティは、転送セキュリティ、アクセス制御、および監査の 3 つの主要な機能領域に分けられます。  この後の各セクションでは、これらの領域について簡単に説明します。また、詳細情報へのリンクを示します。  
+  
+### 転送セキュリティ  
+ 転送セキュリティには、整合性、機密性、および認証の 3 つの主要なセキュリティ機能があります。  *整合性*とは、メッセージが改ざんされているかどうかを検出する機能です。  *機密性*とは、目的の受信者以外のユーザーにはメッセージを読み取り不可にする機能のことです。これを実現するために暗号化が使用されます。  *認証*とは、提示された ID を検証する機能です。  これらの 3 つの機能を一緒に使用して、メッセージをある地点から別の地点に安全に到着させることができます。  
+  
+#### トランスポート セキュリティ モードとメッセージ セキュリティ モード  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で転送セキュリティを実装するには、*トランスポート* セキュリティ モードと*メッセージ* セキュリティ モードの 2 つの主要な機構を使用します。  
+  
+-   *トランスポート セキュリティ モード*では、HTTPS などのトランスポート レベルのプロトコルを使用して転送セキュリティを実現します。  トランスポート モードの利点は、広範囲に採用されていること、多くのプラットフォームで利用可能なこと、コンピューター処理上の複雑性が低いことです。  ただし、Point\-to\-Point からのメッセージだけのセキュリティを保護するという欠点もあります。  
+  
+-   一方、*メッセージ セキュリティ モード*は、WS\-Security \(および他の仕様\) を使用して転送セキュリティを実現します。  メッセージ セキュリティは、SOAP メッセージに直接適用され、また SOAP エンベロープ内にアプリケーション データと共に格納されるため、トランスポート プロトコルに依存しない、拡張性が高い、エンド ツー エンド \(Point\-to\-Point と対照\) のセキュリティが保証される、という利点があります。ただし、SOAP メッセージの XML の性質を処理する必要があるため、トランスポート セキュリティ モードよりも処理が数倍遅くなる欠点があります。  
+  
+ これらの相違点[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)」を参照してください。  
+  
+ 3 番目のセキュリティ モードは、上記の 2 つのモードを使用し、その両方の利点を引き継ぎます。  このモードは、`TransportWithMessageCredential` と呼ばれます。  このモードでは、クライアントの認証にメッセージ セキュリティを使用し、サーバーの認証にトランスポート セキュリティを使用して、メッセージの機密性と整合性を実現します。  これにより、`TransportWithMessageCredential` セキュリティ モードでは、トランスポート セキュリティ モードと同じ速度で処理が実行され、メッセージ セキュリティ モードと同じ方法でクライアント認証の拡張性が提供されます。  ただし、メッセージ セキュリティ モードと異なり、完全なエンド ツー エンド セキュリティは提供されません。  
+  
+### アクセス制御  
+ *アクセス制御*は、承認とも呼ばれます。  *承認*を使って、さまざまなユーザーにさまざまなデータ参照権限を持たせることができます。  たとえば、企業の人事ファイルには従業員の機密データが含まれているため、管理者だけが従業員データの参照を許可されます。  また、管理者は直接報告書のデータのみを参照できます。  このような場合、アクセス制御は、ロール \("manager"\) と管理者の特定 ID の両方に基づいて行われます \(ある管理者が別の管理者の部下のレコードを参照できないようにします\)。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のアクセス制御機能は、共通言語ランタイム \(CLR\) の <xref:System.Security.Permissions.PrincipalPermissionAttribute> との統合、および *ID モデル*として知られる一連の API により提供されます。  アクセス制御とクレームに基づく承認の詳細については、「[セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)」を参照してください。  
+  
+### 監査  
+ *監査*とは、セキュリティ イベントを Windows イベント ログに記録することです。  認証の失敗 \(または成功\) などのセキュリティ関連のイベントをログに記録できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md).  プログラミングの詳細については、「[方法 : セキュリティ イベントを監査する](../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>   
+ [サービスのセキュリティ保護](../../../../docs/framework/wcf/securing-services.md)   
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)   
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)   
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)   
+ [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)   
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)   
+ [セキュリティ ガイドラインとベスト プラクティス](../../../../docs/framework/wcf/feature-details/security-guidance-and-best-practices.md)   
+ [構成ファイルを使用してサービスを構成する方法](../../../../docs/framework/wcf/configuring-services-using-configuration-files.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [エンドポイントの作成の概要](../../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [セキュリティの拡張](../../../../docs/framework/wcf/extending/extending-security.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-protocols-version-1-0.md b/docs/framework/wcf/feature-details/security-protocols-version-1-0.md
new file mode 100644
index 00000000000..639dd89fb3b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-protocols-version-1-0.md
@@ -0,0 +1,2774 @@
+---
+title: "セキュリティ プロトコル バージョン 1.0 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee3402d2-1076-410b-a3cb-fae0372bd7af
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# セキュリティ プロトコル バージョン 1.0
+Web サービス セキュリティ プロトコルには、既存のエンタープライズ メッセージング セキュリティのあらゆる要件に対応する Web サービス セキュリティ機構が用意されています。  ここでは、以下の Web サービス セキュリティ プロトコルについて、\(<xref:System.ServiceModel.Channels.SecurityBindingElement> で実装される\) [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] バージョン 1.0 の詳細を説明します。  
+  
+|||  
+|-|-|  
+|仕様\/ドキュメント|Link|  
+|WSS SOAP Message Security 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-soap\-message\-security\-1.0.pdf|  
+|WSS: Username Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-username\-token\-profile\-1.0.pdf|  
+|WSS: X509 Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-x509\-token\-profile\-1.0.pdf|  
+|WSS: SAML 1.1 Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.0.pdf|  
+|WSS SOAP Message Security 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16790\/wss\-v1.1\-spec\-os\-SOAPMessageSecurity.pdf|  
+|WSS Username Token Profile 1.1|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-username\-token\-profile\-1.0.pdf|  
+|WSS: X.509 Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16785\/wss\-v1.1\-spec\-os\-x509TokenProfile.pdf|  
+|WSS: Kerberos Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16788\/wss\-v1.1\-spec\-os\-KerberosTokenProfile.pdf|  
+|WSS: SAML 1.1 Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16768\/wss\-v1.1\-spec\-os\-SAMLTokenProfile.pdf|  
+|WS\-SecureConversation|http:\/\/msdn.microsoft.com\/ws\/2005\/02\/ws\-secure\-conversation\/|  
+|WS\-Trust|http:\/\/msdn.microsoft.com\/ws\/2005\/02\/ws\-trust\/|  
+|Application Note:<br /><br /> Using WS\-Trust for TLS Handshake|公開予定|  
+|Application Note:<br /><br /> Using WS\-Trust for SPNEGO|公開予定|  
+|Application Note:<br /><br /> Web Services Addressing Endpoint References And Identity|公開予定|  
+|WS\-SecurityPolicy 1.1<br /><br /> \(2005\/07\)|http:\/\/msdn.microsoft.com\/ws\/2005\/07\/ws\-security\-policy\/<br /><br /> OASIS WS\-SX 技術委員会 http:\/\/www.oasis\-open.org\/archives\/ws\-sx\/200512\/msg00017.html に提出された正誤表によって修正済み|  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Version 1 には、Web サービス セキュリティ構成の基礎として使用できる 17 個の認証モードが用意されています。  各モードは、次のような一般的な展開要件について最適化されています。  
+  
+-   クライアントとサービスの認証に使用する資格情報  
+  
+-   メッセージまたはトランスポートのセキュリティ保護機構  
+  
+-   メッセージ交換パターン  
+  
+|認証モード|クライアント認証|サーバー認証|モード|  
+|-----------|--------------|------------|---------|  
+|UserNameOverTransport|ユーザー名\/パスワード|X509|Transport|  
+|CertificateOverTransport|X509|X509|Transport|  
+|KerberosOverTransport|Windows|X509|Transport|  
+|IssuedTokenOverTransport|フェデレーション|X509|Transport|  
+|SspiNegotiatedOverTransport|Windows SSPI ネゴシエーション|Windows SSPI ネゴシエーション|Transport|  
+|AnonymousForCertificate|なし|X509|メッセージ|  
+|UserNameForCertificate|ユーザー名\/パスワード|X509|メッセージ|  
+|MutualCertificate|X509|X509|メッセージ|  
+|MutualCertificateDuplex|X509|X509|メッセージ|  
+|IssuedTokenForCertificate|フェデレーション|X509|メッセージ|  
+|Kerberos|Windows|Windows|メッセージ|  
+|IssuedToken|フェデレーション|フェデレーション|メッセージ|  
+|SspiNegotiated|Windows SSPI ネゴシエーション|Windows SSPI ネゴシエーション|メッセージ|  
+|AnonymousForSslNegotiated|なし|X509、TLS ネゴシエーション|メッセージ|  
+|UserNameForSslNegotiated|ユーザー名\/パスワード|X509、TLS ネゴシエーション|メッセージ|  
+|MutualSslNegotiated|X509|X509、TLS ネゴシエーション|メッセージ|  
+|IssuedTokenForSslNegotiated|フェデレーション|X509、TLS ネゴシエーション|メッセージ|  
+  
+ このような認証モードを使用するエンドポイントは、WS\-SecurityPolicy \(WS\-SP\) を使用してセキュリティ要件を表現できます。  ここでは、各認証モードのセキュリティ ヘッダーとインフラストラクチャ メッセージの構造について説明します。また、ポリシーとメッセージの例も示します。  
+  
+ アプリケーション間での複数のメッセージ交換を保護するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では WS\-SecureConversation を使用してセキュリティで保護されたセッションをサポートします。  実装の詳細については、後述の「セキュリティで保護されたセッション」を参照してください。  
+  
+ 認証モードに加え、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、メッセージ セキュリティ ベースのほとんどの認証モードに適用される一般的な保護機構を制御するための設定 \(署名と暗号化操作の順序、アルゴリズム スイート、キー派生、署名確認など\) も用意されています。  
+  
+ このドキュメントでは、以下のプレフィックスと名前空間を使用します。  
+  
+|プレフィックス|Namespace|  
+|-------------|---------------|  
+|s|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|sp|http:\/\/schemas.xmlsoap.org\/ws\/2005\/07\/securitypolicy|  
+|a|http:\/\/www.w3.org\/2005\/08\/addressing|  
+|wsse|未定 \- OASIS WSS 1.0 の URI|  
+|wsse11|未定 \- OASIS WSS 1.1 の URI|  
+|wsu|未定 \- OASIS WSS 1.0 Utility の URI|  
+|ds|未定 \- W3C XMLDSig の URI|  
+|wst|未定 \- WS\-Trust 2005\/02 の URI|  
+|wssc|未定 \- WS\-SecureConversation 2005\/02 の URI|  
+|wsaw|未定 \- WS\-Addressing ポリシーの名前空間|  
+|wsp|http:\/\/schemas.xmlsoap.org\/ws\/2004\/09\/policy|  
+|mssp|http:\/\/schemas.microsoft.com\/ws\/2005\/07\/securitypolicy|  
+  
+## 1.トークン プロファイル  
+ Web サービス セキュリティ仕様では、資格情報をセキュリティ トークンとして表します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、以下のトークンの種類をサポートしています。  
+  
+### 1.1 UsernameToken  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、以下の制約で UsernameToken10 プロファイルおよび UsernameToken11 プロファイルに従います。  
+  
+ R1101 : UsernameToken\\Password 要素の PasswordType 属性では、\#PasswordText \(既定値\) を省略するか、指定する必要があります。  
+  
+ 機能拡張を使用すると、\#PasswordDigest を実装できます。  \#PasswordDigest は、十分に安全性の高いパスワード保護機構であると誤解されがちであることが報告されています。  しかし、\#PasswordDigest は、UsernameToken の暗号化の代替として使用できるわけではありません。  \#PasswordDigest の第一の目的は、リプレイ攻撃から保護することです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の各認証モードでは、メッセージ署名を使用することで、リプレイ攻撃の脅威が軽減されます。  
+  
+ B1102 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Nonce および UsernameToken の作成済みサブ要素を出力することはありません。  
+  
+ これらのサブ要素は、リプレイ検出を支援するためのものです。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、代わりにメッセージ署名を使用します。  
+  
+ OASIS WSS SOAP Message Security UsernameToken Profile 1.1 \(UsernameToken11\) では、パスワードからのキー派生機能が導入されています。  
+  
+ B1103 : UsernameToken のパスワードをキー派生に使用することはできません。したがって、暗号化操作では使用できません。  
+  
+ 理由 : パスワードは、一般に暗号化操作に使用するには脆弱すぎると見なされています。  
+  
+### 1.2 X509 トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、資格情報の種類として X509v3 証明書をサポートしており、以下の制約で X509TokenProfile1.0 と X509TokenProfile1.1 に従います。  
+  
+ R1201 : BinarySecurityToken 要素に X509v3 証明書が含まれている場合、この要素の ValueType 属性の値は \#X509v3 であることが必要です。  
+  
+ WSS X509 Token Profile 1.0 および 1.1 では、値の種類として \#X509PKIPathv1 と \#PKCS7 も定義されています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、これらの種類をサポートしていません。  
+  
+ R1202 : X509 証明書に SubjectKeyIdentifier \(SKI\) 拡張が含まれている場合、トークンへの外部参照に wsse:KeyIdentifier を使用する必要があります。この場合、ValueType 属性に \#X509SubjectKeyIdentifier を指定し、証明書の SKI 拡張の Base64 でエンコードされた値を含めます。  
+  
+ SKI 参照は幅広く実装されており、相互運用性の高い外部参照型であることが証明されています。  
+  
+ R1203 : X509 セキュリティ トークンへの外部参照では、ds:X509IssuerSerial を使用できません。  
+  
+ R1204 : X509TokenProfile1.1 を使用している場合、X509 セキュリティ トークンへの外部参照では、WS\-Security 1.1 で導入された拇印を使用する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、X509IssuerSerial をサポートしています。  ただし、X509IssuerSerial には相互運用性の問題があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、文字列を使用して X509IssuerSerial の 2 つの値を比較します。  したがって、サブジェクト名の構成要素を並べ替えて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに証明書への参照を送信した場合、参照が見つからないことがあります。  
+  
+### 1.3 Kerberos トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Windows 認証のために、以下の制約で KerberosTokenProfile1.1 をサポートしています。  
+  
+ R1301 : GSS\_API と Kerberos 仕様で定義されているように、Kerberos トークンは GSS によってラップされた Kerberos v4 AP\_REQ の値を伝達する必要があります。また、値 \#GSS\_Kerberosv5\_AP\_REQ が指定された ValueType 属性を持つ必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ベア AP\-REQ ではなく、GSS によってラップされた Kerberos AP\-REQ を使用します。  これは、セキュリティのベスト プラクティスです。  
+  
+### 1.4 SAML v1.1 トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SAML v1.1 トークンの WSS SAML Token Profile 1.0 および 1.1 をサポートしています。  SAML トークンの形式のその他のバージョンも実装できます。  
+  
+### 1.5 セキュリティ コンテキスト トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-SecureCoversation に導入されたセキュリティ コンテキスト トークン \(SCT\) をサポートしています。  SCT は、SecureConversation と、後述する TLS および SSPI の各バイナリ ネゴシエーション プロトコルで確立されたセキュリティ コンテキストを表すために使用されます。  
+  
+## 2.一般的なメッセージ セキュリティ パラメーター  
+  
+### 2.1 タイムスタンプ  
+ タイムスタンプの有無は、<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの <xref:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp%2A> プロパティを使用して制御します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、常に wsse:Created および wsse:Expires の各フィールドと共に wsse:TimeStamp をシリアル化します。  署名を使用する場合、wsse:TimeStamp は必ず署名されます。  
+  
+### 2.2 保護の順序  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、メッセージ保護の順序として、"暗号化前に署名" と "署名前に暗号化" をサポートしています \(Security Policy 1.1\)。"  WS\-Security 1.1 の SignatureConfirmation 機構を使用していない場合、"署名前に暗号化" を使用して保護されたメッセージを開くと、置き換え攻撃への署名が行われます。また、暗号化された内容に署名すると監査が困難になります。これらの理由から、"暗号化前に署名" を使用することをお勧めします。  
+  
+### 2.3 署名の保護  
+ "署名前に暗号化" を使用する場合、暗号化された内容や署名キー \(特に、脆弱なキー マテリアルでカスタム トークンを使用する場合\) を推測するブルート フォース攻撃を防ぐために、署名を保護することをお勧めします。  
+  
+### 2.4 アルゴリズム スイート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Security Policy 1.1 に記載されたすべてのアルゴリズム スイートをサポートしています。  
+  
+### 2.5 キー派生  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-SecureConversation に記載された "対称キーのキー派生" を使用します。  
+  
+### 2.6 署名確認  
+ 署名確認によって "man\-in\-the\-middle" 攻撃から保護することで、署名セットを保護できます。  
+  
+### 2.7 セキュリティ ヘッダーのレイアウト  
+ 各認証モードでは、セキュリティ ヘッダーの特定のレイアウトが使用されます。  セキュリティ ヘッダー内の要素は、部分的に順序付けられています。  セキュリティ ヘッダーの子要素の順序を定義するために、WS\-Security Policy では、以下のセキュリティ ヘッダー レイアウト モードが定義されています。  
+  
+|||  
+|-|-|  
+|Strict|"使用前に宣言する" という一般的原則に基づき、Security Policy のセクション 7.7.1 に記載された番号付きレイアウト ルールに従って、項目がセキュリティ ヘッダーに追加されます。|  
+|Lax|WSS: SOAP Message Security に準拠した任意の順序で、項目がセキュリティ ヘッダーに追加されます。|  
+|LaxTimestampFirst|セキュリティ ヘッダー内の最初の項目が wsse:Timestamp でなければならないという点を除き、Lax と同じです。|  
+|LaxTimestampLast|セキュリティ ヘッダー内の最後の項目が wsse:Timestamp でなければならないという点を除き、Lax と同じです。|  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティ ヘッダーの 4 つのレイアウト モードをすべてサポートしています。  後ほど示す各認証モードのセキュリティ ヘッダーの構造とメッセージの例では、"Strict" モードに従っています。  
+  
+## 2.一般的なメッセージ セキュリティ パラメーター  
+ このセクションでは、各認証モードのポリシーの例、およびクライアントとサービスによって交換されるメッセージのセキュリティ ヘッダーの構造を示す例を紹介します。  
+  
+### 6.1 トランスポートの保護  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された UserNameOverTransport、CertificateOverTransport、KerberosOverTransport、IssuedTokenOverTransport、および SspiNegotiatedOverTransport の 5 つの認証モードでは、セキュリティで保護されたトランスポートを使用してメッセージを保護します。  
+  
+ これらの認証モードは、SecurityPolicy に記載されたトランスポート バインディングを使用して構築されます。  UserNameOverTransport 認証モードの場合、UsernameToken は署名付きサポート トークンです。  その他の認証モードでは、トークンは署名付き保証トークンとして表示されます。  SecurityPolicy の Appendix C.1.2 および C.1.3 には、セキュリティ ヘッダーのレイアウトの詳細が記載されています。  以降のセキュリティ ヘッダーの例は、指定の認証モードの Strict レイアウトを示しています。  
+  
+ すべてのケースで、トークンの "派生キー" プロパティの値は "false" です。  
+  
+ トランスポート バインディングの各プロパティの値は次のとおりです。  
+  
+ タイムスタンプ : true  
+  
+ セキュリティ ヘッダーのレイアウト : Strict  
+  
+ アルゴリズム スイート : Basic256  
+  
+#### 6.1.1 UsernameOverTransport  
+ この認証モードでは、クライアントはユーザー名トークンを使用して認証を行います。ユーザー名トークンは、イニシエーターから受信者に必ず送信される署名付きサポート トークンとして SOAP 層に表示されます。  サービスはトランスポート層で X.509 証明書を使用して認証されます。  使用するバインディングは、トランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='UsernameOverTransport_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:TransportBinding >  
+        <wsp:Policy>  
+          <sp:TransportToken>  
+            <wsp:Policy>  
+              <sp:HttpsToken RequireClientCertificate='false' />   
+            </wsp:Policy>  
+          </sp:TransportToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+        </wsp:Policy>  
+      </sp:TransportBinding>  
+      <sp:SignedSupportingTokens >  
+        <wsp:Policy>  
+          <sp:UsernameToken   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+            <wsp:Policy>  
+              <sp:WssUsernameToken10 />   
+            </wsp:Policy>  
+          </sp:UsernameToken>  
+        </wsp:Policy>  
+      </sp:SignedSupportingTokens>  
+      <sp:Wss11 >  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10 >  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:UsernameToken ... >  
+  ...  
+  </wsse:UsernameToken>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+</wsse:Security>  
+```  
+  
+#### 6.1.2 CertificateOverTransport  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。  サービスはトランスポート層で X.509 証明書を使用して認証されます。  使用するバインディングは、トランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='CertificateOverTransport_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:TransportBinding xmlns:sp='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy' >  
+        <wsp:Policy>  
+          <sp:TransportToken>  
+            <wsp:Policy>  
+             <sp:HttpsToken RequireClientCertificate='false' />   
+            </wsp:Policy>  
+          </sp:TransportToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+        </wsp:Policy>  
+      </sp:TransportBinding>  
+      <sp:EndorsingSupportingTokens>  
+        <wsp:Policy>  
+          <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+            <wsp:Policy>  
+              <sp:RequireThumbprintReference />   
+              <sp:WssX509V3Token10 />   
+            </wsp:Policy>  
+          </sp:X509Token>  
+          <sp:SignedParts>  
+            <sp:Header Name='To'   
+Namespace='http://www.w3.org/2005/08/addressing' />   
+          </sp:SignedParts>  
+        </wsp:Policy>  
+      </sp:EndorsingSupportingTokens>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wse:Timestamp u:Id="_0">  
+  ...  
+  </wse:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security>  
+  <u:Timestamp u:Id="_0">  
+  ...  
+  </u:Timestamp>  
+</o:Security>  
+```  
+  
+#### 6.1.3 IssuedTokenOverTransport  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、セキュリティ トークン サービス \(STS\) により発行されたトークンを示すことで、共有キーの有無を示します。  発行されたトークンは、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。  サービスはトランスポート層で X.509 証明書を使用して認証されます。  バインディングはトランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='IssuedTokenOverTransport_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:TransportBinding >  
+        <wsp:Policy>  
+          <sp:TransportToken>  
+            <wsp:Policy>  
+              <sp:HttpsToken RequireClientCertificate='false' />   
+            </wsp:Policy>  
+          </sp:TransportToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+        </wsp:Policy>  
+      </sp:TransportBinding>  
+      <sp:EndorsingSupportingTokens>  
+        <wsp:Policy>  
+          <sp:IssuedToken   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+            <sp:RequestSecurityTokenTemplate>  
+              <wst:KeyType>  
+              http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey  
+              </wst:KeyType>   
+            </sp:RequestSecurityTokenTemplate>  
+            <wsp:Policy>  
+              <sp:RequireInternalReference />   
+            </wsp:Policy>  
+          </sp:IssuedToken>  
+          <sp:SignedParts>  
+            <sp:Header Name='To'   
+Namespace='http://www.w3.org/2005/08/addressing' />   
+          </sp:SignedParts>  
+        </wsp:Policy>  
+      </sp:EndorsingSupportingTokens>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1" >  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <saml:Assertion ...>  
+  ...  
+  </saml:Assertion>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+</wsse:Security>  
+```  
+  
+#### 6.1.4 KerberosOverTransport  
+ この認証モードを使用すると、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。  Kerberos トークンは、保証サポート トークンとして SOAP 層に表示されます。  サービスはトランスポート層で X.509 証明書を使用して認証されます。  バインディングはトランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='KerberosOverTransport_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:TransportBinding>  
+        <wsp:Policy>  
+          <sp:TransportToken>  
+            <wsp:Policy>  
+              <sp:HttpsToken RequireClientCertificate='false' />   
+            </wsp:Policy>  
+          </sp:TransportToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic128 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+        </wsp:Policy>  
+      </sp:TransportBinding>  
+      <sp:EndorsingSupportingTokens>  
+        <wsp:Policy>  
+          <sp:KerberosToken  
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/Once' >  
+            <wsp:Policy>  
+              <sp:WssGssKerberosV5ApReqToken11 />   
+            </wsp:Policy>  
+          </sp:KerberosToken>  
+          <sp:SignedParts>  
+            <sp:Header Name='To'   
+Namespace='http://www.w3.org/2005/08/addressing' />   
+          </sp:SignedParts>  
+        </wsp:Policy>  
+      </sp:EndorsingSupportingTokens>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1" >  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken ValueType="...#GSS_Kerberosv5_AP_REQ">  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+</wsse:Security>  
+```  
+  
+#### 6.1.5 SspiNegotiatedOverTransport  
+ このモードでは、ネゴシエーション プロトコルを使用して、クライアントとサーバーの認証を行います。  Kerberos を使用できる場合は Kerberos が使用され、それ以外の場合は NTLM が使用されます。  発行された SCT は、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。  サービスは、トランスポート層で X.509 証明書により追加的に認証されます。  使用するバインディングは、トランスポート バインディングです。"  SPNEGO" \(ネゴシエーション\) には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が WS\-Trust で SSPI バイナリ ネゴシエーション プロトコルを使用する方法が記述されます。  このセクションで示すセキュリティ ヘッダーの例は、SPNEGO ハンドシェイクによって SCT が確立された後の状態を示しています。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='SspiNegotiatedOverTransport_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:TransportBinding>  
+        <wsp:Policy>  
+          <sp:TransportToken>  
+            <wsp:Policy>  
+              <sp:HttpsToken RequireClientCertificate='false' />   
+            </wsp:Policy>  
+          </sp:TransportToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+        </wsp:Policy>  
+      </sp:TransportBinding>  
+      <sp:EndorsingSupportingTokens>  
+        <wsp:Policy>  
+          <sp:SpnegoContextToken   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+            <wsp:Policy />   
+          </sp:SpnegoContextToken>  
+          <sp:SignedParts>  
+            <sp:Header Name='To'   
+Namespace='http://www.w3.org/2005/08/addressing' />   
+          </sp:SignedParts>  
+        </wsp:Policy>  
+      </sp:EndorsingSupportingTokens>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例  
+ WS\-Trust バイナリ ネゴシエーションを使用して、SPNEGO ハンドシェイクによってセキュリティ コンテキスト トークンが確立されると、アプリケーション メッセージのセキュリティ ヘッダーは、次のような構造になります。  
+  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:SecurityContextToken u:Id="uuid-2202746a-7725-453d-8747-809cb718dab0-29" >  
+  ...  
+  </wssc:SecurityContextToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+</wsse:Security>  
+```  
+  
+### 6.2 X.509 証明書を使用したサービス認証  
+ このセクションでは、MutualCertificate WSS1.0、Mutual CertificateDuplex、MutualCertificate WSS1.1、AnonymousForCertificate、UserNameForCertificate、および IssuedTokenForCertificate の各認証モードについて説明します。  
+  
+#### 6.2.1 MutualCertificate WSS1.0  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーター トークンとして SOAP 層に表示されます。  また、サービスは X.509 証明書を使用して認証されます。  
+  
+ 使用するバインディングは、次のプロパティ値が設定された非対称バインディングです。  
+  
+ イニシエーター トークン : インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定されたクライアントの X.509 証明書  
+  
+ 受信者トークン : インクルード モードが …\/IncludeToken\/Never に設定されたサーバーの X.509 証明書  
+  
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='MutualCertificate_WSS10_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:AsymmetricBinding>  
+        <wsp:Policy>  
+          <sp:InitiatorToken>  
+            <wsp:Policy>  
+              <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                <wsp:Policy>  
+                  <sp:WssX509V3Token10 />   
+                </wsp:Policy>  
+              </sp:X509Token>  
+            </wsp:Policy>  
+          </sp:InitiatorToken>  
+          <sp:RecipientToken>  
+            <wsp:Policy>  
+              <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/Never' >  
+                <wsp:Policy>  
+                  <sp:WssX509V3Token10 />   
+                </wsp:Policy>  
+              </sp:X509Token>  
+            </wsp:Policy>  
+          </sp:RecipientToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:AsymmetricBinding>  
+      <sp:Wss10>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+        </wsp:Policy>  
+      </sp:Wss10>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedKey>  
+  ...  
+    <xenc:ReferenceList>  
+    ...  
+    </xenc:ReferenceList>  
+  </xenc:EncryptedKey>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+    <xenc:ReferenceList>  
+    ...  
+    </xenc:ReferenceList>  
+  </xenc:EncryptedKey>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ セキュリティ ヘッダーの例 : EncryptBeforeSign  
+  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.2.2 MutualCertificateDuplex  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーター トークンとして SOAP 層に表示されます。  また、サービスは X.509 証明書を使用して認証されます。  
+  
+ 使用するバインディングは、次のプロパティ値が設定された非対称バインディングです。  
+  
+ イニシエーター トークン : インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定されたクライアントの X.509 証明書  
+  
+ 受信者トークン : インクルード モードが ...\/IncludeToken\/AlwaysToInitiator に設定されたサーバーの X509 証明書  
+  
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='MutualCertificateDuplex_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:AsymmetricBinding>  
+        <wsp:Policy>  
+          <sp:InitiatorToken>  
+            <wsp:Policy>  
+              <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                <wsp:Policy>  
+                  <sp:WssX509V3Token10 />   
+                </wsp:Policy>  
+              </sp:X509Token>  
+            </wsp:Policy>  
+          </sp:InitiatorToken>  
+          <sp:RecipientToken>  
+            <wsp:Policy>  
+              <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToInitiator' >  
+                <wsp:Policy>  
+                  <sp:WssX509V3Token10 />   
+                </wsp:Policy>  
+              </sp:X509Token>  
+            </wsp:Policy>  
+          </sp:RecipientToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:AsymmetricBinding>  
+      <sp:Wss10>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+        </wsp:Policy>  
+      </sp:Wss10>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求と応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedKey>  
+  ...  
+    <xenc:ReferenceList>  
+    ...  
+    </xenc:ReferenceList>  
+  </xenc:EncryptedKey>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求と応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.2.3 X.509 サービス認証での SymmetricBinding の使用  
+ "WSS10" では、X509 トークンを使用するシナリオのサポートが制限されていました。  たとえば、サービスの X509 トークンだけを使用して、メッセージの署名と暗号化を保護することはできませんでした。"  WSS11" では、EncryptedKey を共通鍵トークンとして使用する方法が導入されています。  これにより、サービスの X.509 証明書の暗号化された一時キーを使用して、要求メッセージと応答メッセージの両方を保護できるようになります。  セクション 6.4 で説明する認証モードでは、このパターンを使用します。  
+  
+ WS\-SecurityPolicy には、サービスの X509 トークンを保護トークンとして使用して SymmetricBinding を使用するこのパターンが記載されています。  
+  
+ AnonymousForCertificate、UsernameForCertificate、MutualCertificate WSS11、および IssuedTokenForCertificate の各認証モードはすべて、以下のプロパティ値が設定された sp:SymmetricBinding の同様のインスタンスを使用します。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Never に設定されたサーバーの X509 証明書                   
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ 前述の各認証モードは、使用するサポート トークンだけが異なります。  AnonymousForCertificate はサポート トークンをまったく使用せず、MutualCertificate WSS 1.1 は保証サポート トークンとしてクライアントの X509 証明書を使用します。また、UserNameForCertificate は署名付きサポート トークンとしてユーザー名トークンを使用し、IssuedTokenForCertificate は保証サポート トークンとして発行済みトークンを使用します。  
+  
+ ポリシー  
+  
+ 対称バインディング  
+  
+```  
+<wsp:Policy wsu:Id='SymmetricCert_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <sp:X509Token   
+sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/Never' >  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                  <sp:RequireThumbprintReference />   
+                  <sp:WssX509V3Token10 />   
+                </wsp:Policy>  
+              </sp:X509Token>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />  
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <!-- Supporting Token Assertions appear here -->  
+      ...  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+          <sp:RequireSignatureConfirmation />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+#### 6.2.4 AnonymousForCertificate  
+ この認証モードでは、クライアントは匿名になり、X.509 証明書を使用してサービスが認証されます。  使用するバインディングは、6.4.2 で説明する対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.2.3 の「ポリシー」を参照してください。  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wsse11:SignatureConfirmation />  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.2.5 UserNameForCertificate  
+ この認証モードでは、クライアントはユーザー名トークンを使用してサーバーに対する認証を行います。ユーザー名トークンは、署名付きサポート トークンとして SOAP 層に表示されます。  X.509 証明書を使用したクライアントに対するサービス認証。  使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.2.3 の「ポリシー」を参照してください。  
+  
+ 署名付きサポート トークン  
+  
+```  
+<sp:SignedSupportingTokens>  
+  <wsp:Policy>  
+    <sp:UsernameToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <wsp:Policy>  
+        <sp:WssUsernameToken10 />   
+      </wsp:Policy>  
+    </sp:UsernameToken>  
+  </wsp:Policy>  
+</sp:SignedSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.2.6 MutualCertificate \(WSS 1.1\)  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、保証サポート トークンとして SOAP 層に表示されます。  また、サービスは X.509 証明書を使用して認証されます。  使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.2.3 の「ポリシー」を参照してください。  
+  
+ 保証サポート トークン  
+  
+```  
+<sp:EndorsingSupportingTokens>  
+  <wsp:Policy>  
+    <sp:X509Token sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <wsp:Policy>  
+        <sp:RequireThumbprintReference />   
+        <sp:WssX509V3Token10 />   
+      </wsp:Policy>  
+    </sp:X509Token>  
+  </wsp:Policy>  
+</sp:EndorsingSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wsse11:SignatureConfirmation />  
+  <wsse11:SignatureConfirmation />  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.2.7 IssuedTokenForCertificate  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。  発行済みトークンは、保証サポート トークンとして SOAP 層に表示されます。  X.509 証明書を使用したクライアントに対するサービス認証。  使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.2.3 の「ポリシー」を参照してください。  
+  
+ 保証サポート トークン  
+  
+```  
+<sp:EndorsingSupportingTokens>  
+  <wsp:Policy>  
+    <sp:IssuedToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <sp:RequestSecurityTokenTemplate>  
+        <wst:KeyType>  
+http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey  
+       </wst:KeyType>  
+     </sp:RequestSecurityTokenTemplate>  
+     <wsp:Policy>  
+       <sp:RequireDerivedKeys />   
+       <sp:RequireInternalReference />   
+     </wsp:Policy>  
+   </sp:IssuedToken>  
+  </wsp:Policy>  
+</sp:EndorsingSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <xenc:EncryptedKey>  
+  ...  
+  </xenc:EncryptedKey>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp u:Id="_0">  
+  ...  
+  </wsu:Timestamp>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wssc:DerivedKeyToken>  
+  ...  
+  </wssc:DerivedKeyToken>  
+  <wsse11:SignatureConfirmation />  
+  <wsse11:SignatureConfirmation />  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+## 6.3 Kerberos  
+ この認証モードを使用すると、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。  また、その同じチケットによってサーバーが認証されます。  使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Once に設定された Kerberos チケット           
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='Kerberos_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <sp:KerberosToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/Once' >  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                  <sp:WssGssKerberosV5ApReqToken11 />   
+                </wsp:Policy>  
+              </sp:KerberosToken>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic128 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsse:BinarySecurityToken>  
+  ...  
+  </wsse:BinarySecurityToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+TBD  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+TBD  
+</wsse:Security>  
+```  
+  
+#### 6.4 IssuedToken  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。  サービスはクライアントに対する認証を行いませんが、そのサービスだけがキーを復号化できるように、STS は発行されたトークンの一部として共有キーを暗号化します。  使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定された発行済みトークン                   
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='CustomBinding_ISimple3_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <sp:IssuedToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                <sp:RequestSecurityTokenTemplate>  
+                  <wst:KeyType>  
+http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey  
+                  </wst:KeyType>   
+                </sp:RequestSecurityTokenTemplate>  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                  <sp:RequireInternalReference />   
+                </wsp:Policy>  
+              </sp:IssuedToken>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+### 6.5 SslNegotiated を使用したサービス認証  
+ このセクションでは、WS\-SecureConversation \(WS\-SC\) ごとのセキュリティ コンテキスト トークンである保護トークンと共に、対称バインディングを使用する認証モードのグループについて説明します。WS\-SecureConversation \(WS\-SC\) のキー値は、WS\-Trust \(WS\-T\) RST\/RSTR メッセージで TLS プロトコルを実行することによりネゴシエートされます。  WS\-Trust を使用した TLS ハンドシェイク実装の詳細は、TLSNEGO に記述されます。  ここで示すメッセージの例は、セキュリティ コンテキストに関連付けられた SCT が、ハンドシェイクによって既に確立されていることを前提としています。  
+  
+ 使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Never に設定された SslContextToken               
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+#### 6.5.1 SslNegotiated サービス認証のポリシー  
+ このセクションで説明するすべての認証モードのポリシーは、使用する署名付きサポート トークンまたは保証トークンだけが異なります。  
+  
+```  
+<wsp:Policy wsu:Id='SslNegotiated_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <mssp:SslContextToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' />  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                </wsp:Policy>  
+              </mssp:SslContextToken>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <!-- Supporting token assertions go here -->  
+      ..  
+      <sp:Wss11>   
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+#### 6.5.2 AnonymousForSslNegotiated  
+ この認証モードでは、クライアントは匿名になり、X.509 証明書を使用してサービスが認証されます。  使用するバインディングは、前述の 6.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.5.1 の「ポリシー」を参照してください。  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.5.3 UserNameForSslNegotiated  
+ この認証モードでは、クライアントはユーザー名トークンを使用して認証を行います。ユーザー名トークンは、署名付きサポート トークンとして SOAP 層に表示されます。  サービスは X.509 証明書を使用して認証されます。  使用するバインディングは、6.5.1 で説明した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.5.1 を参照してください。  
+  
+ 署名付きサポート トークン  
+  
+```  
+<sp:SignedSupportingTokens>  
+  <wsp:Policy>  
+    <sp:UsernameToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <wsp:Policy>  
+        <sp:WssUsernameToken10 />   
+      </wsp:Policy>  
+    </sp:UsernameToken>  
+  </wsp:Policy>  
+</sp:SignedSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.5.4 IssuedTokenForSslNegotiated  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。  発行済みトークンは、保証サポート トークンとして SOAP 層に表示されます。  サービスは X.509 証明書を使用して認証されます。  使用するバインディングは、前述の 6.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.5.1 を参照してください。  
+  
+ 保証サポート トークン  
+  
+```  
+<sp:EndorsingSupportingTokens>  
+  <wsp:Policy>  
+    <sp:IssuedToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <sp:RequestSecurityTokenTemplate>  
+        <wst:KeyType>  
+http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey  
+        </wst:KeyType>   
+      </sp:RequestSecurityTokenTemplate>  
+      <wsp:Policy>  
+        <sp:RequireDerivedKeys />   
+        <sp:RequireInternalReference />   
+      </wsp:Policy>  
+    </sp:IssuedToken>  
+  </wsp:Policy>  
+</sp:EndorsingSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <saml:Assertion>  
+  ...  
+  </saml:Assertion>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsse11:SignatureConfirmation />  
+  <wsse11:SignatureConfirmation />  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+#### 6.5.5 MutualSslNegotiated  
+ この認証モードでは、クライアントとサービスは X.509 証明書を使用して認証を行います。  使用するバインディングは、前述の 6.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+ バインディングの詳細については、前述の 6.5.1 を参照してください。  
+  
+ 保証サポート トークン  
+  
+```  
+<sp:EndorsingSupportingTokens>  
+  <wsp:Policy>  
+    <sp:X509Token sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+      <wsp:Policy>  
+        <sp:RequireThumbprintReference />   
+        <sp:WssX509V3Token10 />   
+      </wsp:Policy>  
+    </sp:X509Token>  
+  </wsp:Policy>  
+</sp:EndorsingSupportingTokens>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+### 6.6 SspiNegotiated  
+ この認証モードを使用すると、クライアントとサーバーの認証を実行するために、ネゴシエーション プロトコルが使用されます。  Kerberos を使用できる場合は Kerberos が使用され、それ以外の場合は NTLM が使用されます。  使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定された SpnegoContextToken               
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='CustomBinding_ISimple13_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <sp:SpnegoContextToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                </wsp:Policy>  
+              </sp:SpnegoContextToken>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+<wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+### 6.7 SecureConversation  
+ 使用するバインディングは、WS\-SecureConversation \(WS\-SC\) ごとの SCT を保護トークンとして使用する対称バインディングです。  入れ子になったバインディング \(このバインディング自体も、ネゴシエーション プロトコルを使用する対称バインディングです\) に従い、SCT は WS\-Trust \(WS\-Trust\) または WS\-SecureConversation \(WS\-SC\) を使用してネゴシエートされます。  ネゴシエーション プロトコルは、可能であれば Kerberos を使用してクライアントとサーバーの認証を行います。  Kerberos を使用できない場合は、NTLM が使用されます。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id='SecureConversation_policy' >  
+  <wsp:ExactlyOne>  
+    <wsp:All>  
+      <sp:SymmetricBinding>  
+        <wsp:Policy>  
+          <sp:ProtectionToken>  
+            <wsp:Policy>  
+              <sp:SecureConversationToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                <wsp:Policy>  
+                  <sp:RequireDerivedKeys />   
+                  <sp:BootstrapPolicy>  
+                    <wsp:Policy>  
+                      <sp:SignedParts>  
+                        <sp:Body />   
+                        <sp:Header Name='To' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='From' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='FaultTo' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='ReplyTo' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='MessageID' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='RelatesTo' Namespace='http://www.w3.org/2005/08/addressing' />   
+                        <sp:Header Name='Action' Namespace='http://www.w3.org/2005/08/addressing' />   
+                      </sp:SignedParts>  
+                      <sp:EncryptedParts>  
+                        <sp:Body />   
+                      </sp:EncryptedParts>  
+                      <sp:SymmetricBinding>  
+                        <wsp:Policy>  
+                          <sp:ProtectionToken>  
+                            <wsp:Policy>  
+                              <sp:SpnegoContextToken sp:IncludeToken='http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient' >  
+                                <wsp:Policy>  
+                                  <sp:RequireDerivedKeys />   
+                                </wsp:Policy>  
+                              </sp:SpnegoContextToken>  
+                            </wsp:Policy>  
+                          </sp:ProtectionToken>  
+                          <sp:AlgorithmSuite>  
+                            <wsp:Policy>  
+                              <sp:Basic256 />   
+                            </wsp:Policy>  
+                          </sp:AlgorithmSuite>  
+                          <sp:Layout>  
+                            <wsp:Policy>  
+                              <sp:Strict />   
+                            </wsp:Policy>  
+                          </sp:Layout>  
+                          <sp:IncludeTimestamp />   
+                          <sp:EncryptSignature />   
+                          <sp:OnlySignEntireHeadersAndBody />   
+                        </wsp:Policy>  
+                      </sp:SymmetricBinding>  
+                      <sp:Wss11>  
+                        <wsp:Policy>  
+                          <sp:MustSupportRefKeyIdentifier />   
+                          <sp:MustSupportRefIssuerSerial />   
+                          <sp:MustSupportRefThumbprint />   
+                          <sp:MustSupportRefEncryptedKey />   
+                        </wsp:Policy>  
+                      </sp:Wss11>  
+                      <sp:Trust10>  
+                        <wsp:Policy>  
+                          <sp:MustSupportIssuedTokens />   
+                          <sp:RequireClientEntropy />   
+                          <sp:RequireServerEntropy />   
+                        </wsp:Policy>  
+                      </sp:Trust10>  
+                    </wsp:Policy>  
+                  </sp:BootstrapPolicy>  
+                </wsp:Policy>  
+              </sp:SecureConversationToken>  
+            </wsp:Policy>  
+          </sp:ProtectionToken>  
+          <sp:AlgorithmSuite>  
+            <wsp:Policy>  
+              <sp:Basic256 />   
+            </wsp:Policy>  
+          </sp:AlgorithmSuite>  
+          <sp:Layout>  
+            <wsp:Policy>  
+              <sp:Strict />   
+            </wsp:Policy>  
+          </sp:Layout>  
+          <sp:IncludeTimestamp />   
+          <sp:EncryptSignature />   
+          <sp:OnlySignEntireHeadersAndBody />   
+        </wsp:Policy>  
+      </sp:SymmetricBinding>  
+      <sp:Wss11>  
+        <wsp:Policy>  
+          <sp:MustSupportRefKeyIdentifier />   
+          <sp:MustSupportRefIssuerSerial />   
+          <sp:MustSupportRefThumbprint />   
+          <sp:MustSupportRefEncryptedKey />   
+        </wsp:Policy>  
+      </sp:Wss11>  
+      <sp:Trust10>  
+        <wsp:Policy>  
+          <sp:MustSupportIssuedTokens />   
+          <sp:RequireClientEntropy />   
+          <sp:RequireServerEntropy />   
+        </wsp:Policy>  
+      </sp:Trust10>  
+      <wsaw:UsingAddressing />   
+    </wsp:All>  
+  </wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security s:mustUnderstand="1">  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+  <xenc:EncryptedData>  
+  ...  
+  </xenc:EncryptedData>  
+</wsse:Security>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:SecurityContextToken>  
+  ...  
+  </wsc:SecurityContextToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```  
+  
+ 応答  
+  
+```  
+<wsse:Security>  
+  <wsu:Timestamp>  
+  ...  
+  </wsu:Timestamp>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <wsc:DerivedKeyToken>  
+  ...  
+  </wsc:DerivedKeyToken>  
+  <ds:Signature>  
+  ...  
+  </ds:Signature>  
+  <xenc:ReferenceList>  
+  ...  
+  </xenc:ReferenceList>  
+</wsse:Security>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security-protocols.md b/docs/framework/wcf/feature-details/security-protocols.md
new file mode 100644
index 00000000000..f5364cca7ab
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security-protocols.md
@@ -0,0 +1,977 @@
+---
+title: "セキュリティ プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], プロトコル"
+ms.assetid: 57ffcbea-807c-4e43-a41c-44b3db8ed2af
+caps.latest.revision: 11
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 11
+---
+# セキュリティ プロトコル
+Web サービス セキュリティ プロトコルには、既存のエンタープライズ メッセージング セキュリティのあらゆる要件に対応する Web サービス セキュリティ機構が用意されています。ここでは、以下の Web サービス セキュリティ プロトコルについて、\(<xref:System.ServiceModel.Channels.SecurityBindingElement> で実装される\) [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の詳細を説明します。  
+  
+|||  
+|-|-|  
+|仕様\/ドキュメント|リンク|  
+|WSS: SOAP Message Security 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-soap\-message\-security\-1.0.pdf|  
+|WSS: Username Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-username\-token\-profile\-1.0.pdf|  
+|WSS: X509 Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-x509\-token\-profile\-1.0.pdf|  
+|WSS: SAML 1.1 Token Profile 1.0|http:\/\/docs.oasis\-open.org\/wss\/oasis\-wss\-saml\-token\-profile\-1.0.pdf|  
+|WSS SOAP Message Security 1.1\*|http:\/\/www.oasis\-open.org\/committees\/download.php\/16790\/wss\-v1.1\-spec\-os\-SOAPMessageSecurity.pdf|  
+|WSS Username Token Profile 1.1|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-username\-token\-profile\-1.0.pdf|  
+|WSS: X.509 Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16785\/wss\-v1.1\-spec\-os\-x509TokenProfile.pdf|  
+|WSS: Kerberos Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16788\/wss\-v1.1\-spec\-os\-KerberosTokenProfile.pdf|  
+|WSS: SAML 1.1 Token Profile 1.1|http:\/\/www.oasis\-open.org\/committees\/download.php\/16768\/wss\-v1.1\-spec\-os\-SAMLTokenProfile.pdf|  
+|WS\-Secure Conversation 1.3|http:\/\/docs.oasis\-open.org\/ws\-sx\/ws\-secureconversation\/200512\/ws\-secureconversation\-1.3\-os.pdf|  
+|WS\-Trust 1.3|http:\/\/docs.oasis\-open.org\/ws\-sx\/ws\-trust\/200512\/ws\-trust\-1.3\-os.pdf|  
+|Application Note:<br /><br /> Using WS\-Trust for TLS Handshake|公開予定|  
+|Application Note:<br /><br /> Using WS\-Trust for SPNEGO|公開予定|  
+|Application Note:<br /><br /> Web Services Addressing Endpoint References And Identity|公開予定|  
+|WS\-SecurityPolicy 1.2 \(2007\/04\)|http:\/\/www.oasis\-open.org\/committees\/download.php\/23821\/ws\-securitypolicy\-1.2\-spec\-cs.pdf|  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Version 1 には、Web サービス セキュリティ構成の基礎として使用できる 17 個の認証モードが用意されています。各モードは、次のような一般的な展開要件について最適化されています。  
+  
+-   クライアントとサービスの認証に使用する資格情報  
+  
+-   メッセージまたはトランスポートのセキュリティ保護機構  
+  
+-   メッセージ交換パターン  
+  
+|認証モード|クライアント認証|サーバー認証|モード|  
+|-----------|--------------|------------|---------|  
+|UserNameOverTransport|ユーザー名\/パスワード|X509|トランスポート|  
+|CertificateOverTransport|X509|X509|トランスポート|  
+|KerberosOverTransport|Windows|X509|トランスポート|  
+|IssuedTokenOverTransport|フェデレーション|X509|トランスポート|  
+|SspiNegotiatedOverTransport|Windows SSPI ネゴシエーション|Windows SSPI ネゴシエーション|トランスポート|  
+|AnonymousForCertificate|なし|X509|メッセージ|  
+|UserNameForCertificate|ユーザー名\/パスワード|X509|Message|  
+|MutualCertificate|X509|X509|Message|  
+|MutualCertificateDuplex|X509|X509|Message|  
+|IssuedTokenForCertificate|フェデレーション|X509|Message|  
+|Kerberos|Windows|Windows|Message|  
+|IssuedToken|フェデレーション|フェデレーション|Message|  
+|SspiNegotiated|Windows SSPI ネゴシエーション|Windows SSPI ネゴシエーション|Message|  
+|AnonymousForSslNegotiated|なし|X509、TLS ネゴシエーション|Message|  
+|UserNameForSslNegotiated|ユーザー名\/パスワード|X509、TLS ネゴシエーション|Message|  
+|MutualSslNegotiated|X509|X509、TLS ネゴシエーション|Message|  
+|IssuedTokenForSslNegotiated|フェデレーション|X509、TLS ネゴシエーション|Message|  
+  
+ このような認証モードを使用するエンドポイントは、WS\-SecurityPolicy \(WS\-SP\) を使用してセキュリティ要件を表現できます。ここでは、各認証モードのセキュリティ ヘッダーとインフラストラクチャ メッセージの構造について説明します。また、ポリシーとメッセージの例も示します。  
+  
+ アプリケーション間での複数のメッセージ交換を保護するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では WS\-SecureConversation を使用してセキュリティで保護されたセッションをサポートします。実装の詳細については、後述の「セキュリティで保護されたセッション」を参照してください。  
+  
+ 認証モードに加え、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、メッセージ セキュリティ ベースのほとんどの認証モードに適用される一般的な保護機構を制御するための設定 \(署名と暗号化操作の順序、アルゴリズム スイート、キー派生、署名確認など\) も用意されています。  
+  
+ このドキュメントでは、以下のプレフィックスと名前空間を使用します。  
+  
+|プレフィックス|名前空間|  
+|-------------|----------|  
+|s|http:\/\/www.w3.org\/2003\/05\/soap\-envelope|  
+|sp|http:\/\/docs.oasis\-open.org\/ws\-sx\/ws\-securitypolicy\/200702|  
+|a|http:\/\/www.w3.org\/2005\/08\/addressing|  
+|wsse|未定 \- OASIS WSS 1.0 の URI|  
+|wsse11|未定 \- OASIS WSS 1.1 の URI|  
+|wsu|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-wssecurity\-utility\-1.0.xsd|  
+|ds|未定 \- W3C XMLDSig の URI|  
+|wst|未定 \- WS\-Trust 2005\/02 の URI|  
+|wssc|未定 \- WS\-SecureConversation 2005\/02 の URI|  
+|wsaw|http:\/\/www.w3.org\/2006\/05\/addressing\/wsdl|  
+|wsp|http:\/\/schemas.xmlsoap.org\/ws\/2004\/09\/policy|  
+|mssp|http:\/\/schemas.microsoft.com\/ws\/2005\/07\/securitypolicy|  
+  
+## 1.トークン プロファイル  
+ Web サービス セキュリティ仕様では、資格情報をセキュリティ トークンとして表します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、以下のトークンの種類をサポートしています。  
+  
+### 1.1 UsernameToken  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、以下の制約で UsernameToken10 プロファイルおよび UsernameToken11 プロファイルに従います。  
+  
+ R1101 : UsernameToken\\Password 要素の PasswordType 属性では、\#PasswordText \(既定値\) を省略するか、指定する必要があります。  
+  
+ 機能拡張を使用すると、\#PasswordDigest を実装できます。\#PasswordDigest は、十分に安全性の高いパスワード保護機構であると誤解されがちであることが報告されています。しかし、\#PasswordDigest は、UsernameToken の暗号化の代替として使用できるわけではありません。\#PasswordDigest の第一の目的は、リプレイ攻撃から保護することです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の各認証モードでは、メッセージ署名を使用することで、リプレイ攻撃の脅威が軽減されます。  
+  
+ B1102 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Nonce および UsernameToken の作成済みサブ要素を出力することはありません。  
+  
+ これらのサブ要素は、リプレイ検出を支援するためのものです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、代わりにメッセージ署名を使用します。  
+  
+ OASIS WSS SOAP Message Security UsernameToken Profile 1.1 \(UsernameToken11\) では、パスワードからのキー派生機能が導入されています。  
+  
+ B1103 : UsernameToken のパスワードをキー派生に使用することはできません。したがって、暗号化操作では使用できません。  
+  
+ 理由 : パスワードは、一般に暗号化操作に使用するには脆弱すぎると見なされています。  
+  
+### 1.2 X509 トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、資格情報の種類として X509v3 証明書をサポートしており、以下の制約で X509TokenProfile1.0 と X509TokenProfile1.1 に従います。  
+  
+ R1201 : BinarySecurityToken 要素に X509v3 証明書が含まれている場合、この要素の ValueType 属性の値は \#X509v3 であることが必要です。  
+  
+ WSS X509 Token Profile 1.0 および 1.1 では、値の種類として \#X509PKIPathv1 と \#PKCS7 も定義されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、これらの種類をサポートしていません。  
+  
+ R1202 : X509 証明書に SubjectKeyIdentifier \(SKI\) 拡張が含まれている場合、トークンへの外部参照に wsse:KeyIdentifier を使用する必要があります。この場合、ValueType 属性に \#X509SubjectKeyIdentifier を指定し、証明書の SKI 拡張の Base64 でエンコードされた値を含めます。  
+  
+ SKI 参照は幅広く実装されており、相互運用性の高い外部参照型であることが証明されています。  
+  
+ R1203 : X509 セキュリティ トークンへの外部参照では、ds:X509IssuerSerial を使用できません。  
+  
+ R1204 : X509TokenProfile1.1 を使用している場合、X509 セキュリティ トークンへの外部参照では、WS\-Security 1.1 で導入された拇印を使用する必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、X509IssuerSerial をサポートしています。ただし、X509IssuerSerial には相互運用性の問題があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、文字列を使用して X509IssuerSerial の 2 つの値を比較します。したがって、サブジェクト名の構成要素を並べ替えて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに証明書への参照を送信した場合、参照が見つからないことがあります。  
+  
+### 1.3 Kerberos トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Windows 認証のために、以下の制約で KerberosTokenProfile1.1 をサポートしています。  
+  
+ R1301 : GSS\_API と Kerberos 仕様で定義されているように、Kerberos トークンは GSS によってラップされた Kerberos v4 AP\_REQ の値を伝達する必要があります。また、値 \#GSS\_Kerberosv5\_AP\_REQ が指定された ValueType 属性を持つ必要があります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ベア AP\-REQ ではなく、GSS によってラップされた Kerberos AP\-REQ を使用します。これは、セキュリティのベスト プラクティスです。  
+  
+### 1.4 SAML v1.1 トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SAML v1.1 トークンの WSS SAML Token Profile 1.0 および 1.1 をサポートしています。SAML トークンの形式のその他のバージョンも実装できます。  
+  
+### 1.5 セキュリティ コンテキスト トークン  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-SecureCoversation に導入されたセキュリティ コンテキスト トークン \(SCT\) をサポートしています。SCT は、SecureConversation と、後述する TLS および SSPI の各バイナリ ネゴシエーション プロトコルで確立されたセキュリティ コンテキストを表すために使用されます。  
+  
+## 2.一般的なメッセージ セキュリティ パラメーター  
+  
+### 2.1 タイムスタンプ  
+ タイムスタンプの有無は、<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの <xref:System.ServiceModel.Channels.SecurityBindingElement.IncludeTimestamp%2A> プロパティを使用して制御します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、常に wsse:Created および wsse:Expires の各フィールドと共に wsse:TimeStamp をシリアル化します。署名を使用する場合、wsse:TimeStamp は必ず署名されます。  
+  
+### 2.2 保護の順序  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、メッセージ保護の順序として、"暗号化前に署名" と "署名前に暗号化" をサポートしています \(Security Policy 1.2\)。"WS\-Security 1.1 の SignatureConfirmation 機構を使用していない場合、"署名前に暗号化" を使用して保護されたメッセージを開くと、置き換え攻撃への署名が行われます。また、暗号化された内容に署名すると監査が困難になります。これらの理由から、"暗号化前に署名" を使用することをお勧めします。  
+  
+### 2.3 署名の保護  
+ "署名前に暗号化" を使用する場合、暗号化された内容や署名キー \(特に、脆弱なキー マテリアルでカスタム トークンを使用する場合\) を推測するブルート フォース攻撃を防ぐために、署名を保護することをお勧めします。  
+  
+### 2.4 アルゴリズム スイート  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、Security Policy 1.2 に記載されたすべてのアルゴリズム スイートをサポートしています。  
+  
+### 2.5 キー派生  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、WS\-SecureConversation に記載された "対称キーのキー派生" を使用します。  
+  
+### 2.6 署名確認  
+ "man\-in\-the\-middle" 攻撃への対策として署名確認を使用することによって、署名セットを保護できます。  
+  
+### 2.7 セキュリティ ヘッダーのレイアウト  
+ 各認証モードでは、セキュリティ ヘッダーの特定のレイアウトが使用されます。セキュリティ ヘッダー内の要素は、部分的に順序付けられています。セキュリティ ヘッダーの子要素の順序を定義するために、WS\-Security Policy では、以下のセキュリティ ヘッダー レイアウト モードが定義されています。  
+  
+|||  
+|-|-|  
+|Strict|"使用前に宣言する" という一般的原則に基づき、Security Policy のセクション 7.7.1 に記載された番号付きレイアウト ルールに従って、項目がセキュリティ ヘッダーに追加されます。|  
+|Lax|WSS: SOAP Message Security に準拠した任意の順序で、項目がセキュリティ ヘッダーに追加されます。|  
+|LaxTimestampFirst|セキュリティ ヘッダー内の最初の項目が wsse:Timestamp でなければならないという点を除き、Lax と同じです。|  
+|LaxTimestampLast|セキュリティ ヘッダー内の最後の項目が wsse:Timestamp でなければならないという点を除き、Lax と同じです。|  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティ ヘッダーの 4 つのレイアウト モードをすべてサポートしています。後ほど示す各認証モードのセキュリティ ヘッダーの構造とメッセージの例では、"Strict" モードに従っています。  
+  
+## 3.一般的なメッセージ セキュリティ パラメーター  
+ このセクションでは、各認証モードのポリシーの例、およびクライアントとサービスによって交換されるメッセージのセキュリティ ヘッダーの構造を示す例を紹介します。  
+  
+### 3.1 トランスポートの保護  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意された UserNameOverTransport、CertificateOverTransport、KerberosOverTransport、IssuedTokenOverTransport、および SspiNegotiatedOverTransport の 5 つの認証モードでは、セキュリティで保護されたトランスポートを使用してメッセージを保護します。  
+  
+ これらの認証モードは、SecurityPolicy に記載されたトランスポート バインディングを使用して構築されます。UserNameOverTransport 認証モードの場合、UsernameToken は署名付きサポート トークンです。その他の認証モードでは、トークンは署名付き保証トークンとして表示されます。SecurityPolicy の Appendix C.1.2 および C.1.3 には、セキュリティ ヘッダーのレイアウトの詳細が記載されています。以降のセキュリティ ヘッダーの例は、指定の認証モードの Strict レイアウトを示しています。  
+  
+ すべてのケースで、トークンの "派生キー" プロパティの値は "false" です。  
+  
+ トランスポート バインディングの各プロパティの値は次のとおりです。  
+  
+ タイムスタンプ : true  
+  
+ セキュリティ ヘッダーのレイアウト : Strict  
+  
+ アルゴリズム スイート : Basic256  
+  
+#### 3.1.1 UsernameOverTransport  
+ この認証モードでは、クライアントはユーザー名トークンを使用して認証を行います。ユーザー名トークンは、イニシエーターから受信者に必ず送信される署名付きサポート トークンとして SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。使用するバインディングは、トランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="UserNameOverTransport_policy"><wsp:ExactlyOne><wsp:All><sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:TransportToken><wsp:Policy><sp:HttpsToken/></wsp:Policy></sp:TransportToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/></wsp:Policy></sp:TransportBinding><sp:SignedEncryptedSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssUsernameToken10/></wsp:Policy></sp:UsernameToken></wsp:Policy></sp:SignedEncryptedSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp><o:UsernameToken u:Id="uuid-b96fbb3a-e646-4403-9473-2e5ffc733ff8-1"> ... </o:UsernameToken></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp></o:Security>  
+```  
+  
+#### 3.1.2 CertificateOverTransport  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。使用するバインディングは、トランスポート バインディングです。CertificateOverTransport が署名するのは SOAP ヘッダーのみで、SOAP 本文には署名しません。これは、TransportWithMessageCredentials セキュリティ モードで使用される認証モードです。認証はメッセージ資格情報を使用して行われるので、SOAP ヘッダーのみが署名されます。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="CertificateOverTransport_policy"><wsp:ExactlyOne><wsp:All><sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:TransportToken><wsp:Policy><sp:HttpsToken/></wsp:Policy></sp:TransportToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/></wsp:Policy></sp:TransportBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token><sp:SignedParts><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp></o:Security>  
+```  
+  
+#### 3.1.3 IssuedTokenOverTransport  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、セキュリティ トークン サービス \(STS\) により発行されたトークンを示すことで、共有キーの有無を示します。発行されたトークンは、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。バインディングはトランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedTokenOverTransport_policy"><wsp:ExactlyOne><wsp:All><sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:TransportToken><wsp:Policy><sp:HttpsToken/></wsp:Policy></sp:TransportToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/></wsp:Policy></sp:TransportBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ...  </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken><sp:SignedParts><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-67692bb6-85b7-4299-8587-3ce60086b0d2-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-fab7e1b2-8dc4-412b-bda9-b95a4f836815-16" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-fab7e1b2-8dc4-412b-bda9-b95a4f836815-21"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+#### 3.1.4 KerberosOverTransport  
+ この認証モードを使用すると、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。Kerberos トークンは、保証サポート トークンとして SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。バインディングはトランスポート バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="KerberosOverTransport_policy"><wsp:ExactlyOne><wsp:All><sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:TransportToken><wsp:Policy><sp:HttpsToken/></wsp:Policy></sp:TransportToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic128/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/></wsp:Policy></sp:TransportBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:KerberosToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Once"><wsp:Policy><sp:WssGssKerberosV5ApReqToken11/></wsp:Policy></sp:KerberosToken><sp:SignedParts><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+ セキュリティ ヘッダーのレイアウト  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp></o:Security>  
+```  
+  
+#### 3.1.5 SspiNegotiatedOverTransport  
+ このモードでは、ネゴシエーション プロトコルを使用して、クライアントとサーバーの認証を行います。Kerberos を使用できる場合は Kerberos が使用され、それ以外の場合は NTLM が使用されます。発行された SCT は、イニシエーターから受信者に必ず送信される保証サポート トークンとして SOAP 層に表示されます。サービスは、トランスポート層で X.509 証明書により追加的に認証されます。使用するバインディングは、トランスポート バインディングです。""SPNEGO" \(ネゴシエーション\) には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が WS\-Trust で SSPI バイナリ ネゴシエーション プロトコルを使用する方法が記述されます。このセクションで示すセキュリティ ヘッダーの例は、SPNEGO ハンドシェイクによって SCT が確立された後の状態を示しています。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="SspiNegotiatedOverTransport_policy"><wsp:ExactlyOne><wsp:All><sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:TransportToken><wsp:Policy><sp:HttpsToken/></wsp:Policy></sp:TransportToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/></wsp:Policy></sp:TransportBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:SpnegoContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></sp:SpnegoContextToken><sp:SignedParts><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例  
+ WS\-Trust バイナリ ネゴシエーションを使用して、SPNEGO ハンドシェイクによってセキュリティ コンテキスト トークンが確立されると、アプリケーション メッセージのセキュリティ ヘッダーは、次のような構造になります。  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-9a29d087-5dae-4d40-bf86-5746d9d30eca-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="_0"> ... </u:Timestamp></o:Security>  
+```  
+  
+### 3.2 X.509 証明書を使用したサービス認証  
+ このセクションでは、MutualCertificate WSS1.0、Mutual CertificateDuplex、MutualCertificate WSS1.1、AnonymousForCertificate、UserNameForCertificate、および IssuedTokenForCertificate の各認証モードについて説明します。  
+  
+#### 3.2.1 MutualCertificate WSS1.0  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーター トークンとして SOAP 層に表示されます。また、サービスは X.509 証明書を使用して認証されます。SOAP ヘッダーと SOAP 本文の両方が署名されます。対称キーが作成され、受信者のトランスポート証明書を使用して暗号化されます。  
+  
+ 使用するバインディングは、次のプロパティ値が設定された非対称バインディングです。  
+  
+ イニシエーター トークン : インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定されたクライアントの X.509 証明書  
+  
+ 受信者トークン : インクルード モードが ...\/IncludeToken\/Never に設定されたサーバーの X.509 証明書  
+  
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:AsymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:InitiatorToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:InitiatorToken><sp:RecipientToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:RecipientToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:AsymmetricBinding><sp:Wss10 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/></wsp:Policy></sp:Wss10><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-39cb393e-9da8-4d5d-b273-540ef614569b-1"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><e:EncryptedData Id="_7" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"> <u:Timestamp u:Id="uuid-3d742930-70d3-4d7e-aa0a-8721128dc115-8"> ... </u:Timestamp><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><e:EncryptedData Id="_5" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:AsymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:InitiatorToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:InitiatorToken><sp:RecipientToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:RecipientToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:AsymmetricBinding><sp:Wss10 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/></wsp:Policy></sp:Wss10><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-73da3e21-abff-4294-a910-e75303d280cc-1"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-02f276b6-804f-480d-99e9-2e90fc76ab27-3"> ... </u:Timestamp><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.2.2 MutualCertificateDuplex  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、イニシエーター トークンとして SOAP 層に表示されます。また、サービスは X.509 証明書を使用して認証されます。  
+  
+ 使用するバインディングは、次のプロパティ値が設定された非対称バインディングです。  
+  
+ イニシエーター トークン : インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定されたクライアントの X.509 証明書  
+  
+ 受信者トークン : インクルード モードが ...\/IncludeToken\/AlwaysToInitiator に設定されたサーバーの X509 証明書  
+  
+ トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualCertificateDuplex_policy"><wsp:ExactlyOne><wsp:All><sp:AsymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:InitiatorToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:InitiatorToken><sp:RecipientToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToInitiator"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:RecipientToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:AsymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><cdp:CompositeDuplex xmlns:cdp="http://schemas.microsoft.com/net/2006/06/duplex"/><ow:OneWay xmlns:ow="http://schemas.microsoft.com/ws/2005/05/routing/policy"/><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ 要求と応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-4dec3da4-b572-4654-ba4d-4a2f84a87510-1"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><e:EncryptedData Id="_7" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualCertificateDuplex_policy"><wsp:ExactlyOne><wsp:All><sp:AsymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:InitiatorToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:InitiatorToken><sp:RecipientToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToInitiator"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:RecipientToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:AsymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><cdp:CompositeDuplex xmlns:cdp="http://schemas.microsoft.com/net/2006/06/duplex"/><ow:OneWay xmlns:ow="http://schemas.microsoft.com/ws/2005/05/routing/policy"/><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ 要求と応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-b0e23feb-cd2d-4dc1-bad9-284bc45f3be3-1"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><e:EncryptedKey Id="_0" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.2.3 X.509 サービス認証での SymmetricBinding の使用  
+ "WSS10" では、X509 トークンを使用するシナリオのサポートが制限されていました。たとえば、サービスの X509 トークンだけを使用して、メッセージの署名と暗号化を保護することはできませんでした。""WSS11" では、EncryptedKey を共通鍵トークンとして使用する方法が導入されています。これにより、サービスの X.509 証明書の暗号化された一時キーを使用して、要求メッセージと応答メッセージの両方を保護できるようになります。セクション 3.4 で説明する認証モードでは、このパターンを使用します。  
+  
+ WS\-SecurityPolicy には、サービスの X509 トークンを保護トークンとして使用して SymmetricBinding を使用するこのパターンが記載されています。  
+  
+ AnonymousForCertificate、UsernameForCertificate、MutualCertificate WSS11、および IssuedTokenForCertificate の各認証モードはすべて、以下のプロパティ値が設定された sp:SymmetricBinding の同様のインスタンスを使用します。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Never に設定されたサーバーの X509 証明書  
+トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ 前述の各認証モードは、使用するサポート トークンだけが異なります。AnonymousForCertificate はサポート トークンをまったく使用せず、MutualCertificate WSS 1.1 は保証サポート トークンとしてクライアントの X509 証明書を使用します。また、UserNameForCertificate は署名付きサポート トークンとしてユーザー名トークンを使用し、IssuedTokenForCertificate は保証サポート トークンとして発行済みトークンを使用します。  
+  
+#### 3.2.4 AnonymousForCertificate  
+ この認証モードでは、クライアントは匿名になり、X.509 証明書を使用してサービスが認証されます。使用するバインディングは、3.4.2 で説明する対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="AnonymousforCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-4de2d2a1-6266-4a02-93e6-242a1ac2aeb3-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-4de2d2a1-6266-4a02-93e6-242a1ac2aeb3-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-b06cb481-3176-4c56-af35-c38252bb6c78-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_2" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_7" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="AnonymousforCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-562aac68-8cdd-45d5-bc03-df662e6ed048-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-562aac68-8cdd-45d5-bc03-df662e6ed048-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-15b48260-23da-424d-8dc4-8f4e150fb8cf-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><k:SignatureConfirmation u:Id="_2" Value="ALF+QNGmWn2k3LpWEDIzSBgTkvo=" xmlns:k="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd"></k:SignatureConfirmation><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.2.5 UserNameForCertificate  
+ この認証モードでは、クライアントはユーザー名トークンを使用してサーバーに対する認証を行います。ユーザー名トークンは、署名付きサポート トークンとして SOAP 層に表示されます。X.509 証明書を使用したクライアントに対するサービス認証です。使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="UserNameForCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:SignedEncryptedSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssUsernameToken10/></wsp:Policy></sp:UsernameToken></wsp:Policy></sp:SignedEncryptedSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><http:BasicAuthentication xmlns:http="http://schemas.microsoft.com/ws/06/2004/policy/http"/><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-27196139-acb9-410f-a2c6-51d20d24278b-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-27196139-acb9-410f-a2c6-51d20d24278b-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_9" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-681226f7-126a-4806-b732-fcca097cd7a8-5"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id=”UserNameForCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:SignedEncryptedSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssUsernameToken10/></wsp:Policy></sp:UsernameToken></wsp:Policy></sp:SignedEncryptedSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><http:BasicAuthentication xmlns:http="http://schemas.microsoft.com/ws/06/2004/policy/http"/><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-8276d8b7-74a0-4257-b8a5-e25350e7c2d4-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-8276d8b7-74a0-4257-b8a5-e25350e7c2d4-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-8a7ad353-f071-49dc-90dd-5ad2e9abd40a-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+  
+```  
+  
+#### 3.2.6 MutualCertificate \(WSS 1.1\)  
+ この認証モードでは、クライアントは X.509 証明書を使用して認証を行います。X.509 証明書は、保証サポート トークンとして SOAP 層に表示されます。また、サービスは X.509 証明書を使用して認証されます。使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id=”MutualCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-75305d4e-f54f-4e36-9de9-45b6d2053c80-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-75305d4e-f54f-4e36-9de9-45b6d2053c80-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_2" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><o:BinarySecurityToken> ...</o:BinarySecurityToken><e:EncryptedData Id="_9" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_10" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-8c73fa91-f95b-40ff-b088-48118e6fadcf-5"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_3" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_9" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_10" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-0b940a9e-606f-43b9-b05d-a162043529bc-2"> ... </u:Timestamp><e:EncryptedKey Id="uuid-0b940a9e-606f-43b9-b05d-a162043529bc-1" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedKey><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><o:BinarySecurityToken> ... </o:BinarySecurityToken><Signature Id="_2" xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-67dacc31-4a50-4866-b673-ccc03e156337-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><k:SignatureConfirmation u:Id="_2" Value="mYyksUQKkK27Fd6hmgOiqFwvudk=" xmlns:k="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd"></k:SignatureConfirmation><k:SignatureConfirmation u:Id="_3" Value="SreOZ4Rr2BcXjFQFvgN55ERypI/1/86hdWThE5lav0eYIxF1OCzQgZF+y7cQ82t+g3CRnLbE3c52DqMpY/HXlrdMct3m3rnpDH+fqdhNY4fE+M2v4zUMFR7uxDKWcEm9zZpmUvJCDfJRfKRaKjy5cTbccRKqSxw7HAqOYnqibA4=" xmlns:k="http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd"></k:SignatureConfirmation><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.2.7 IssuedTokenForCertificate  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。発行済みトークンは、保証サポート トークンとして SOAP 層に表示されます。サービスはクライアントに対して X.509 証明書を使用して認証します。使用するバインディングは、クライアントによって生成され、サービスの公開キーで暗号化されたキーを保護トークンとして使用する対称バインディングです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedTokenForCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ...  </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-1d2c03e6-0b69-4483-903a-6ef9b9d286ed-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-3f0f57fa-046d-40c0-919f-d0d7aa640b9f-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-3f0f57fa-046d-40c0-919f-d0d7aa640b9f-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedTokenForCertificate_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:X509Token sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Never"><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireThumbprintReference/><sp:WssX509V3Token10/></wsp:Policy></sp:X509Token></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ...  </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+ 要求  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-de1c51aa-2ecc-4e70-b6bd-9dca58331fa7-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-96c5e80a-9b87-4c6f-af77-752ca65cf607-16" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-96c5e80a-9b87-4c6f-af77-752ca65cf607-21"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+## 3.3 Kerberos  
+ この認証モードを使用すると、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。また、その同じチケットによってサーバーが認証されます。使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Once に設定された Kerberos チケット  
+トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="Kerberos_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:KerberosToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Once"><wsp:Policy><sp:RequireDerivedKeys/><sp:WssGssKerberosV5ApReqToken11/></wsp:Policy></sp:KerberosToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic128/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-e8f6dc3b-407d-4387-bd33-97aedfd8bf13-2"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-7b03568e-66ae-49da-82ee-5d12d372876e-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="Kerberos_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:KerberosToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/Once"><wsp:Policy><sp:RequireDerivedKeys/><sp:WssGssKerberosV5ApReqToken11/></wsp:Policy></sp:KerberosToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic128/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-d29247f0-f220-4e81-9a8d-a15f5ac31072-2"> ... </u:Timestamp><o:BinarySecurityToken> ... </o:BinarySecurityToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-9025b930-4f15-42fe-8e78-35d3a3480177-2"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.4 IssuedToken  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。サービスはクライアントに対する認証を行いませんが、そのサービスだけがキーを復号化できるように、STS は発行されたトークンの一部として共有キーを暗号化します。使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定された発行済みトークン  
+トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedToken_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ...  </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-61ce3989-bc38-4d67-8262-6232c9d49a26-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-7e2d2617-1c28-465a-be30-de4a78cfc0e2-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-7e2d2617-1c28-465a-be30-de4a78cfc0e2-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>    
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedToken_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ...  </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-1dc8bdef-4202-4e08-8a5e-ab94da579dec-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-7e004f51-63a3-4069-9b03-6a1a311a3181-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-7e004f51-63a3-4069-9b03-6a1a311a3181-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> </c:DerivedKeyToken> ... <c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+### 3.5 SslNegotiated を使用したサービス認証  
+ このセクションでは、WS\-SecureConversation \(WS\-SC\) ごとのセキュリティ コンテキスト トークンである保護トークンと共に、対称バインディングを使用する認証モードのグループについて説明します。WS\-SecureConversation \(WS\-SC\) のキー値は、WS\-Trust \(WS\-T\) RST\/RSTR メッセージで TLS プロトコルを実行することによりネゴシエートされます。WS\-Trust を使用した TLS ハンドシェイク実装の詳細は、TLSNEGO に記述されます。ここで示すメッセージの例は、セキュリティ コンテキストに関連付けられた SCT が、ハンドシェイクによって既に確立されていることを前提としています。  
+  
+ 使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/Never に設定された SslContextToken  
+トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+#### 3.5.1 SslNegotiated サービス認証のポリシー  
+ このセクションで説明するすべての認証モードのポリシーは、使用する署名付きサポート トークンまたは保証トークンだけが異なります。  
+  
+#### 3.5.2 AnonymousForSslNegotiated  
+ この認証モードでは、クライアントは匿名になり、X.509 証明書を使用してサービスが認証されます。使用するバインディングは、前述の 3.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="AnonymousForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-f4b86ce2-4ba6-4c55-bac1-2e920fc6d5db-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-d21ec2b8-99f5-443c-a4c6-a4d40619187e-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-d21ec2b8-99f5-443c-a4c6-a4d40619187e-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="AnonymousForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-c84b24b9-39e0-4cc3-99e2-cec088f1b9eb-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-df206ad9-1ee2-46d7-9fb4-6e4631c9762f-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-df206ad9-1ee2-46d7-9fb4-6e4631c9762f-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.5.3 UserNameForSslNegotiated  
+ この認証モードでは、クライアントはユーザー名トークンを使用して認証を行います。ユーザー名トークンは、署名付きサポート トークンとして SOAP 層に表示されます。サービスは X.509 証明書を使用して認証されます。使用するバインディングは、3.5.1 で説明した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id=”UserNameForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:SignedEncryptedSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssUsernameToken10/></wsp:Policy></sp:UsernameToken></wsp:Policy></sp:SignedEncryptedSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-3d1a12c3-e690-474a-a223-a346fc0329a9-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-137ea768-7d49-404b-87eb-f11d9c7154aa-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_9" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-137ea768-7d49-404b-87eb-f11d9c7154aa-5"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="UserNameForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:SignedEncryptedSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:UsernameToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:WssUsernameToken10/></wsp:Policy></sp:UsernameToken></wsp:Policy></sp:SignedEncryptedSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-56e931e8-20c2-457f-a83e-8fcd6b92c258-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-83d053cb-03a0-4461-9616-86475cf083c4-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-83d053cb-03a0-4461-9616-86475cf083c4-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+#### 3.5.4 IssuedTokenForSslNegotiated  
+ この認証モードでは、クライアントはサービスに対する認証を行わず、STS により発行されたトークンを示すことで、共有キーの有無を示します。発行済みトークンは、保証サポート トークンとして SOAP 層に表示されます。サービスは X.509 証明書を使用して認証されます。使用するバインディングは、前述の 3.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedTokenForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ... </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-b19fb2e7-8f0c-45c1-b62c-45d6ff6d57e7-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-199509f9-7963-42b7-b340-7598ee261d5a-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-199509f9-7963-42b7-b340-7598ee261d5a-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="IssuedTokenForSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:EndorsingSupportingTokens xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:IssuedToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><Issuer xmlns="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><Address xmlns="http://www.w3.org/2005/08/addressing">http://www.w3.org/2005/08/addressing/anonymous</Address><Metadata xmlns="http://www.w3.org/2005/08/addressing"><Metadata xmlns="http://schemas.xmlsoap.org/ws/2004/09/mex" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><wsx:MetadataSection xmlns=""><wsx:MetadataReference><Address xmlns="http://www.w3.org/2005/08/addressing"> ... </Address><Identity xmlns="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity"><Dns> ... </Dns></Identity></wsx:MetadataReference></wsx:MetadataSection></Metadata></Metadata></Issuer><sp:RequestSecurityTokenTemplate><trust:KeyType xmlns:trust="http://docs.oasis-open.org/ws-sx/ws-trust/200512">http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey</trust:KeyType></sp:RequestSecurityTokenTemplate><wsp:Policy><sp:RequireDerivedKeys/><sp:RequireInternalReference/></wsp:Policy></sp:IssuedToken></wsp:Policy></sp:EndorsingSupportingTokens><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/><sp:RequireSignatureConfirmation/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>    
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-d75104d5-313e-440f-b112-db8aff57a5fe-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-e668caab-b7e4-4056-ac42-4015ae2a67a6-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-e668caab-b7e4-4056-ac42-4015ae2a67a6-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+#### 3.5.5 MutualSslNegotiated  
+ この認証モードでは、クライアントとサービスは X.509 証明書を使用して認証を行います。使用するバインディングは、前述の 3.5.1 に示した対称バインディングのインスタンスです。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><mssp:RequireClientCertificate/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-d1e6037e-8a64-494f-9447-07d3125b81b5-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-e4b73625-3011-4f6d-a6f9-4d682e860801-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-e4b73625-3011-4f6d-a6f9-4d682e860801-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="MutualSslNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><mssp:SslContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient" xmlns:mssp="http://schemas.microsoft.com/ws/2005/07/securitypolicy"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><mssp:RequireClientCertificate/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></mssp:SslContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>   
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-c2a6ab10-889a-4ee1-871d-05410c90fc10-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-ede0bd89-1f7e-4453-96ed-13e58c7ba8fe-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-ede0bd89-1f7e-4453-96ed-13e58c7ba8fe-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+### 3.6 SspiNegotiated  
+ この認証モードを使用すると、クライアントとサーバーの認証を実行するために、ネゴシエーション プロトコルが使用されます。Kerberos を使用できる場合は Kerberos が使用され、それ以外の場合は NTLM が使用されます。使用するバインディングは、以下のプロパティが設定された対称バインディングです。  
+  
+ 保護トークン: インクルード モードが ...\/IncludeToken\/AlwaysToRecipient に設定された SpnegoContextToken  
+トークンの保護 : False  
+  
+ ヘッダーと本文全体の署名 : True  
+  
+ 保護の順序 : SignBeforeEncrypt  
+  
+ 署名の暗号化 : True  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="SspiNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SpnegoContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></sp:SpnegoContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-9a954fcb-4df2-4610-9800-f542f2b5130a-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-554d8cfc-e956-43db-9abb-afcafd024347-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-554d8cfc-e956-43db-9abb-afcafd024347-4"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>   
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="SspiNegotiated_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SpnegoContextToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/><sp:MustNotSendCancel/><sp:MustNotSendAmend/><sp:MustNotSendRenew/></wsp:Policy></sp:SpnegoContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-f1673773-f9a7-4b43-b13b-405e7dd4a6e3-4"> ... </u:Timestamp><sc:SecurityContextToken u:Id="uuid-e0aabc81-6942-4fe6-81bc-9def184565ea-1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:SecurityContextToken><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-e0aabc81-6942-4fe6-81bc-9def184565ea-3"> ... </u:Timestamp><sc:DerivedKeyToken u:Id="_1" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><sc:DerivedKeyToken u:Id="_0" xmlns:sc="http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512"> ... </sc:DerivedKeyToken><Signature xmlns="http://www.w3.org/2000/09/xmldsig#"> ... </Signature><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList></o:Security>  
+```  
+  
+### 3.7 SecureConversation  
+ 使用するバインディングは、WS\-SecureConversation \(WS\-SC\) ごとの SCT を保護トークンとして使用する対称バインディングです。入れ子になったバインディング \(このバインディング自体も、ネゴシエーション プロトコルを使用する対称バインディングです\) に従い、SCT は WS\-Trust \(WS\-Trust\) または WS\-SecureConversation \(WS\-SC\) を使用してネゴシエートされます。ネゴシエーション プロトコルは、可能であれば Kerberos を使用してクライアントとサーバーの認証を行います。Kerberos を使用できない場合は、NTLM が使用されます。  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="SecureConversation_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SecureConversationToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/><sp:BootstrapPolicy><wsp:Policy><sp:SignedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><sp:Body/><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="From" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="FaultTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="ReplyTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="MessageID" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="RelatesTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="Action" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts><sp:EncryptedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><sp:Body/></sp:EncryptedParts><sp:SymmetricBinding xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SpnegoContextToken sp:IncludeToken="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/></wsp:Policy></sp:SpnegoContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust10 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust10></wsp:Policy></sp:BootstrapPolicy><sp:MustNotSendAmend/></wsp:Policy></sp:SecureConversationToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+```  
+  
+### セキュリティ ヘッダーの例 : SignBeforeEncrypt、EncryptSignature  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-f01c6159-f159-454d-bd97-bbcc9b8e25d3-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-582920d7-14a7-4adc-8091-e1f92d7d8055-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-582920d7-14a7-4adc-8091-e1f92d7d8055-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ ポリシー  
+  
+```  
+<wsp:Policy wsu:Id="SecureConversation_policy"><wsp:ExactlyOne><wsp:All><sp:SymmetricBinding xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SecureConversationToken sp:IncludeToken="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/><sp:BootstrapPolicy><wsp:Policy><sp:SignedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><sp:Body/><sp:Header Name="To" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="From" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="FaultTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="ReplyTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="MessageID" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="RelatesTo" Namespace="http://www.w3.org/2005/08/addressing"/><sp:Header Name="Action" Namespace="http://www.w3.org/2005/08/addressing"/></sp:SignedParts><sp:EncryptedParts xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><sp:Body/></sp:EncryptedParts><sp:SymmetricBinding xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:ProtectionToken><wsp:Policy><sp:SpnegoContextToken sp:IncludeToken="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy/IncludeToken/AlwaysToRecipient"><wsp:Policy><sp:RequireDerivedKeys/></wsp:Policy></sp:SpnegoContextToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptSignature/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust10 xmlns:sp="http://schemas.xmlsoap.org/ws/2005/07/securitypolicy"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust10></wsp:Policy></sp:BootstrapPolicy><sp:MustNotSendAmend/></wsp:Policy></sp:SecureConversationToken></wsp:Policy></sp:ProtectionToken><sp:AlgorithmSuite><wsp:Policy><sp:Basic256/></wsp:Policy></sp:AlgorithmSuite><sp:Layout><wsp:Policy><sp:Strict/></wsp:Policy></sp:Layout><sp:IncludeTimestamp/><sp:EncryptBeforeSigning/><sp:OnlySignEntireHeadersAndBody/></wsp:Policy></sp:SymmetricBinding><sp:Wss11 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportRefKeyIdentifier/><sp:MustSupportRefIssuerSerial/><sp:MustSupportRefThumbprint/><sp:MustSupportRefEncryptedKey/></wsp:Policy></sp:Wss11><sp:Trust13 xmlns:sp="http://docs.oasis-open.org/ws-sx/ws-securitypolicy/200702"><wsp:Policy><sp:MustSupportIssuedTokens/><sp:RequireClientEntropy/><sp:RequireServerEntropy/></wsp:Policy></sp:Trust13><wsaw:UsingAddressing/></wsp:All></wsp:ExactlyOne></wsp:Policy>  
+  
+```  
+  
+### セキュリティ ヘッダーの例 : EncryptBeforeSign  
+ Request  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-d57e6342-1c68-4095-a0c1-41979088a944-5"> ... </u:Timestamp><c:SecurityContextToken u:Id="uuid-9b22407d-b914-4c41-9105-1cf8cf7c3fe5-1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:SecurityContextToken><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_8" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```  
+  
+ 応答  
+  
+```  
+<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"><u:Timestamp u:Id="uuid-9b22407d-b914-4c41-9105-1cf8cf7c3fe5-6"> ... </u:Timestamp><c:DerivedKeyToken u:Id="_0" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><c:DerivedKeyToken u:Id="_1" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc"> ... </c:DerivedKeyToken><e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:ReferenceList><e:EncryptedData Id="_6" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#"> ... </e:EncryptedData></o:Security>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/security.md b/docs/framework/wcf/feature-details/security.md
new file mode 100644
index 00000000000..8590329077e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/security.md
@@ -0,0 +1,80 @@
+---
+title: "Windows Communication Foundation セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF]"
+  - "Windows Communication Foundation, プログラミング"
+  - "Windows Communication Foundation, セキュリティ"
+ms.assetid: 7ea87fcb-dcfb-4a4a-8b03-6b954575d45b
+caps.latest.revision: 21
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 21
+---
+# Windows Communication Foundation セキュリティ
+このセクションの各トピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティ機能、およびこれらの機能を使用してメッセージをセキュリティで保護する方法について説明します。  
+  
+ Windows Server AppFabric およびセキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)」を参照してください。  
+  
+## このセクションの内容  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ機能について説明します。  
+  
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティで使用される基本的な用語と概念について説明します。  
+  
+ [一般的なセキュリティ シナリオ](../../../../docs/framework/wcf/feature-details/common-security-scenarios.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で構成できるシナリオとトポロジについて説明します。  
+  
+ [セキュリティ動作](../../../../docs/framework/wcf/feature-details/security-behaviors-in-wcf.md)  
+ 資格情報の設定など、セキュリティに影響する WCF の動作に関する概要について説明します。  
+  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)  
+ カスタム セキュリティ バインディングの作成方法を示すトピックなど、バインディングをセキュリティの観点から説明します。  
+  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ機能を使用して、メッセージをセキュリティで保護する方法について説明します。  
+  
+ [認証](../../../../docs/framework/wcf/feature-details/authentication-in-wcf.md)  
+ 一般的な認証タスクを示します。  
+  
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)  
+ セキュリティ実装を使用した一般的な承認シナリオについて説明します。  
+  
+ [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)  
+ フェデレーションの基本事項と、フェデレーション サーバーと通信するクライアントを作成する方法について説明します。  
+  
+ [部分信頼](../../../../docs/framework/wcf/feature-details/partial-trust.md)  
+ 部分的な信頼のシナリオを実行する方法と、部分的な信頼を実行するときの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の制限について説明します。  
+  
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)  
+ セキュリティ イベントを監査する方法について説明します。  
+  
+ [セキュリティ ガイドラインとベスト プラクティス](../../../../docs/framework/wcf/feature-details/security-guidance-and-best-practices.md)  
+ セキュリティで保護された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの作成に関するガイドラインを示します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+## 関連項目  
+ [WCF 機能の詳細](../../../../docs/framework/wcf/feature-details/index.md)  
+  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+ [チュートリアル入門](../../../../docs/framework/wcf/getting-started-tutorial.md)  
+  
+ [概念](../../../../docs/framework/wcf/conceptual-overview.md)  
+  
+## 参照  
+ [アプリケーションの構成](../../../../docs/framework/wcf/diagnostics/configuring-your-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md b/docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md
new file mode 100644
index 00000000000..b2f28520e7c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/securitybindingelement-authentication-modes.md
@@ -0,0 +1,129 @@
+---
+title: "SecurityBindingElement 認証モード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 12300bf4-c730-4405-9f65-d286f68b5a43
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# SecurityBindingElement 認証モード
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、クライアントとサービスが互いに認証するためのモードが複数あります。<xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの静的メソッドまたは構成を使用して、この認証モード用のセキュリティ バインド要素を作成できます。このトピックでは、18 の認証モードについて簡単に説明します。  
+  
+ 認証モードのいずれかで要素を使用する例については、「[方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)」を参照してください。  
+  
+## 基本的な構成プログラミング  
+ 構成ファイルで認証モードを設定する手順を次に示します。  
+  
+#### 構成で認証モードを設定するには  
+  
+1.  [\<bindings\>](../../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素に、[\<customBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)を追加します。  
+  
+2.  子要素として、[\<binding\>](../../../../docs/framework/misc/binding.md) 要素を `<customBinding>` 要素に追加します。  
+  
+3.  `<security>` 要素を `<binding>` 要素に追加します。  
+  
+4.  `authenticationMode` 属性を、以下で説明する値のいずれかに設定します。たとえば、次のコードによりモードは `AnonymousForCertificate` に設定されます。  
+  
+    ```  
+    <bindings>  
+      <customBinding>  
+        <binding name="SecureCustomBinding">  
+         <security authenticationMode ="AnonymousForCertificate" />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    ```  
+  
+#### プログラムでモードを設定するには  
+  
+1.  戻り値の型を決めます。<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement>、<xref:System.ServiceModel.Channels.TransportSecurityBindingElement>、<xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement>、または <xref:System.ServiceModel.Channels.SecurityBindingElement> のいずれかを指定できます。  
+  
+2.  <xref:System.ServiceModel.Channels.SecurityBindingElement> クラスの適切な静的メソッドを呼び出します。たとえば、次のコードは <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateAnonymousForCertificateBindingElement%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[c_CustomBindingsAuthMode#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_custombindingsauthmode/cs/source.cs#3)]
+     [!code-vb[c_CustomBindingsAuthMode#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_custombindingsauthmode/vb/source.vb#3)]  
+  
+3.  カスタム バインディングを作成するにはバインド要素を使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md).  
+  
+## モードの説明  
+  
+### AnonymousForCertificate  
+ この認証モードでは、クライアントは匿名になり、X.509 証明書を使用してサービスが認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateAnonymousForCertificateBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> です。または、\<`security`\> 要素の `authenticationMode` 属性を `AnonymousForCertificate` に設定します。  
+  
+### AnonymousForSslNegotiated  
+ この認証モードでは、クライアントが匿名になり、実行時にネゴシエートされる X.509 証明書を使用してサービスが認証されます。セキュリティ バインド要素は、最初のパラメーターに `false` の値が渡される場合に <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSslNegotiationBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> です。代わりに、`authenticationMode` 属性に `AnonymousForSslNegotiated` を設定します。  
+  
+### CertificateOverTransport  
+ この認証モードでは、クライアントは、保証サポート トークン、つまりメッセージ署名を行うトークンとして SOAP 層に表示される X.509 証明書を使用して認証を行います。サービスはトランスポート層で X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateCertificateOverTransportBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.TransportSecurityBindingElement> です。代わりに、`authenticationMode` 属性に `CertificateOverTransport` を設定します。  
+  
+### IssuedToken  
+ この認証モードでは、クライアントはサービスに対する認証を行いません。代わりに、クライアントはセキュリティ トークン サービスに対して認証を行い、SAML トークンを受信します。その後、クライアントはサーバーに対してこのトークンを提示し、共有キーの情報を示します。サービスはクライアントに対して認証されませんが、そのサービスだけがキーを復号化できるように、セキュリティ トークン サービスは発行されたトークンの一部として共有キーを暗号化します。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> です。代わりに、`authenticationMode` 属性を `IssuedToken` に設定します。  
+  
+### IssuedTokenForCertificate  
+ この認証モードでは、クライアントはサービスに対する認証を行いません。代わりに、クライアントはセキュリティ トークン サービスに対して認証を行い、SAML トークンを受信します。その後、クライアントはサーバーに対してこのトークンを提示し、共有キーの情報を示します。発行済みトークンは、保証サポート トークンまたは所有者トークン \(メッセージ署名を行うトークン\) として SOAP 層に表示されます。サービスはクライアントに対して X.509 証明書を使用して認証します。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenForCertificateBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> です。代わりに、`authenticationMode` 属性に `IssuedTokenForCertificate` を設定します。  
+  
+### IssuedTokenForSslNegotiated  
+ この認証モードでは、クライアントはサービスに対する認証を行いません。代わりに、クライアントはセキュリティ トークン サービスに対して認証を行い、SAML トークンを受信します。その後、クライアントはサーバーに対してこのトークンを提示し、共有キーの情報を示します。発行済みトークンは、保証サポート トークンまたは所有者トークン \(メッセージ署名を行うトークン\) として SOAP 層に表示されます。サービスは X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenForSslBindingElement%2A> メソッドによって返される <xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> です。代わりに、`authenticationMode` 属性に `IssuedTokenForSslnegotiated` を設定します。  
+  
+### IssuedTokenOverTransport  
+ この認証モードでは、クライアントはサービスに対する認証を行いません。代わりに、クライアントはセキュリティ トークン サービスに対して認証を行い、SAML トークンを受信します。その後、クライアントはサーバーに対してこのトークンを提示し、共有キーの情報を示します。発行済みトークンは、保証サポート トークンまたは所有者トークン \(メッセージ署名を行うトークン\) として SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateIssuedTokenOverTransportBindingElement%2A> メソッドによって返される `TransportSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `IssuedTokenOverTransport` を設定します。  
+  
+### Kerberos  
+ この認証モードでは、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。また、その同じチケットによってサーバーが認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateKerberosBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `Kerberos` を設定します。  
+  
+> [!NOTE]
+>  この認証モードを使用するには、サービス アカウントをサービス プリンシパル名 \(SPN: Service Principal Name\) に関連付ける必要があります。この関連付けを行うには、NETWORK SERVICE アカウントまたは LOCAL SYSTEM アカウントでサービスを実行します。または、SetSpn.exe ツールを使用して、サービス アカウントの SPN を作成します。いずれの場合も、クライアントは [\<servicePrincipalName\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md) 要素で正しい SPN を使用するか、<xref:System.ServiceModel.EndpointAddress> コンストラクターを使用して正しい SPN を使用する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md).  
+  
+> [!NOTE]
+>  `Kerberos` 認証モードを使用する場合、<xref:System.Security.Principal.TokenImpersonationLevel> および <xref:System.Security.Principal.TokenImpersonationLevel> の各偽装レベルはサポートされません。  
+  
+### KerberosOverTransport  
+ この認証モードでは、クライアントは Kerberos チケットを使用してサービスに対する認証を行います。Kerberos トークンは、保証サポート トークン、つまりメッセージ署名を行うトークンとして SOAP 層に表示されます。サービスはトランスポート層で X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateKerberosOverTransportBindingElement%2A> メソッドによって返される `TransportSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `KerberosOverTransport` を設定します。  
+  
+> [!NOTE]
+>  この認証モードを使用するには、サービス アカウントを SPN に関連付ける必要があります。この関連付けを行うには、NETWORK SERVICE アカウントまたは LOCAL SYSTEM アカウントでサービスを実行します。または、SetSpn.exe ツールを使用して、サービス アカウントの SPN を作成します。いずれの場合も、クライアントは [\<servicePrincipalName\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceprincipalname.md) 要素で正しい SPN を使用するか、<xref:System.ServiceModel.EndpointAddress> コンストラクターを使用して正しい SPN を使用する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md).  
+  
+### MutualCertificate  
+ この認証モードでは、クライアントは、保証サポート トークン、つまりメッセージ署名を行うトークンとして SOAP 層に表示される X.509 証明書を使用して認証を行います。また、サービスは X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateMutualCertificateBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `MutualCertificate` を設定します。  
+  
+### MutualCertificateDuplex  
+ この認証モードでは、クライアントは、保証サポート トークン、つまりメッセージ署名を行うトークンとして SOAP 層に表示される X.509 証明書を使用して認証を行います。また、サービスは X.509 証明書を使用して認証されます。バインディングは、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateMutualCertificateDuplexBindingElement%2A> メソッドによって返される `AsymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `MutualCertificateDuplex` を設定します。  
+  
+### MutalSslNegotiation  
+ この認証モードでは、クライアントとサービスは X.509 証明書を使用して認証を行います。セキュリティ バインド要素は、最初のパラメーターに `true` の値が渡される場合に <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSslNegotiationBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `MutualSslNegotiated` を設定します。  
+  
+### SecureConversation  
+ セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSecureConversationBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。このメソッドは、パラメーターとして <xref:System.ServiceModel.Channels.SecurityBindingElement> を受け取り、初期化時にこれを使用してセキュリティで保護されたセッションを確立します。代わりに、`authenticationMode` 属性に `SecureConversation` を設定します。  
+  
+ ブートストラップ バインディングを指定していない場合は、ブートストラップのために `SspiNegotiated` 認証モードが使用されます。  
+  
+### SspiNegotiation  
+ この認証モードでは、ネゴシエーション プロトコルを使用して、クライアントとサーバーの認証を行います。Kerberos を使用できる場合は Kerberos が使用され、それ以外の場合は、NTLM \(NT LanMan\) が使用されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSspiNegotiationBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `SspiNegotiated` を設定します。  
+  
+### SspiNegotiatedOverTransport  
+ この認証モードでは、ネゴシエーション プロトコルを使用して、クライアントとサーバーの認証を行います。Kerberos プロトコルを使用できる場合は Kerberos プロトコルが使用され、それ以外の場合は NTLM が使用されます。発行されたトークンは、保証サポート トークン、つまりメッセージ署名を行うトークンとして SOAP 層に表示されます。サービスは、トランスポート層で X.509 証明書により追加的に認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSspiNegotiationOverTransportBindingElement%2A> メソッドによって返される `TransportSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `SspiNegotiatedOverTransport` を設定します。  
+  
+### UserNameForCertificate  
+ この認証モードでは、クライアントは、署名付きサポート トークン、つまりメッセージ署名で署名されたトークンとして SOAP 層に表示されるユーザー名トークンを使用してサービスに対する認証を行います。X.509 証明書を使用したクライアントに対するサービス認証。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateUserNameForCertificateBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `UserNameForCertificate` を設定します。  
+  
+ `UserNameForCertificate` 認証モードでは、クライアントとサービスの両方が WS\-Security 1.1 を使用している必要があります。  
+  
+### UserNameForSslNegotiated  
+ この認証モードでは、クライアントは、署名付きサポート トークン、つまりメッセージ署名で署名されたトークンとして SOAP 層に表示されるユーザー名トークンを使用して認証を行います。サービスは X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateUserNameForSslBindingElement%2A> メソッドによって返される `SymmetricSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `UserNameForSslNegotiated` を設定します。  
+  
+### UserNameOverTransport  
+ この認証モードでは、クライアントは、署名付きサポート トークン、つまりメッセージ署名で署名されたトークンとして SOAP 層に表示されるユーザー名トークンを使用して認証を行います。サービスはトランスポート層で X.509 証明書を使用して認証されます。セキュリティ バインド要素は、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateUserNameOverTransportBindingElement%2A> メソッドによって返される `TransportSecurityBindingElement` です。代わりに、`authenticationMode` 属性に `UserNameOverTransport` を設定します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.SecurityBindingElement>   
+ [方法 : 指定した認証モード用の SecurityBindingElement を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/selecting-a-credential-type.md b/docs/framework/wcf/feature-details/selecting-a-credential-type.md
new file mode 100644
index 00000000000..def1d37e923
--- /dev/null
+++ b/docs/framework/wcf/feature-details/selecting-a-credential-type.md
@@ -0,0 +1,123 @@
+---
+title: "資格情報の種類の選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf707063-3f30-4304-ab53-0e63413728a8
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# 資格情報の種類の選択
+*"資格情報"* とは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が、クレームされた ID または機能を確立するために使用するデータです。  たとえば、パスポートは、政府によって発行される、国籍または地域籍を証明するための資格情報です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザー名トークンや X.509 証明書など多数の形式を資格情報に使用できます。  ここでは、資格情報について説明し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で資格情報を使用する方法およびアプリケーションに適切な資格情報を選択する方法についても説明します。  
+  
+ 多くの国や地域において、運転免許証は資格情報の一例です。  運転免許証には、個人を識別する情報や能力を表すデータが記載されます。  この免許証には、所有者の写真という形式で所有の証明が含まれています。  免許証は、政府機関など、信頼された証明機関によって発行されます。  免許証には発行機関印が押され \(国や地域によってはホログラムが使用され\) ており、これによって、改ざんあるいは偽造されたものではないことが示されています。  
+  
+ 資格情報の提示には、データ自体の提示とデータの所有証明の提示が関与します。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、トランスポートとメッセージの両方のセキュリティ レベルで、さまざまな種類の資格情報がサポートされています。  例えば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされている、ユーザー名と \(X.509\) 証明書の 2 種類の資格情報を考えてみましょう。  
+  
+ ユーザー名資格情報で、ユーザー名はクレームされた ID を表しており、パスワードは所有の証明に使用されます。  この場合の信頼された証明機関とは、ユーザー名とパスワードを検証するシステムです。  
+  
+ X.509 証明書資格情報を使用する場合、サブジェクト名、サブジェクト代替名、または証明書内の特定のフィールドを ID のクレームとして使用し、`Valid From` 、`Valid To` などの他のフィールドで証明書の有効性を示すことができます。  
+  
+## トランスポート資格情報の種類  
+ 転送セキュリティ モードのバインディングによって使用できるクライアント資格情報の種類を次の表に示します。  サービスを作成する際には、`ClientCredentialType` プロパティを次のいずれかの値に設定し、クライアントがサービスと通信するときに提供する必要がある資格情報の種類を指定します。  この種類は、コードまたは構成ファイルで設定できます。  
+  
+|設定|説明|  
+|--------|--------|  
+|なし|クライアントが資格情報を提示する必要がないことを指定します。  匿名クライアントであると解釈されます。|  
+|Basic|クライアントに基本認証を指定します。  詳細については、RFC2617『[HTTP Authentication: Basic and Digest Authentication](http://go.microsoft.com/fwlink/?LinkID=88313)』を参照してください。|  
+|Digest|クライアントにダイジェスト認証を指定します。  詳細については、RFC2617『[HTTP Authentication: Basic and Digest Authentication](http://go.microsoft.com/fwlink/?LinkID=88313)』を参照してください。|  
+|Ntlm|NT LAN Manager \(NTLM\) 認証を指定します。  これは、何らかの理由で Kerberos 認証を使用できないときに使用されます。  <xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm%2A> プロパティを `false` に設定すると、フォールバックとしての NTLM の使用を無効にすることもできます。これにより、NTLM が使用されていれば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はベスト エフォートで例外をスローするようになります。  ただし、このプロパティを `false` に設定しても、ネットワーク経由で NTLM 資格情報が送信されなくなるとは限りません。|  
+|Windows|Windows 認証を指定します。  Windows ドメインで Kerberos プロトコルだけを指定するには、<xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm%2A> プロパティを `false` \(既定値は `true`\) に設定する必要があります。|  
+|証明書|X.509 証明書を使用したクライアント認証を実行します。|  
+|\[Password\]|ユーザーは、ユーザー名とパスワードを提供する必要があります。  Windows 認証または他のカスタム ソリューションを使用して、ユーザー名とパスワードの組み合わせを検証します。|  
+  
+### メッセージ クライアント資格情報の種類  
+ メッセージ セキュリティを使用するアプリケーションを作成するときに使用できる資格情報の種類を次の表に示します。  これらの値は、コードまたは構成ファイルで使用できます。  
+  
+|設定|説明|  
+|--------|--------|  
+|なし|クライアントが資格情報を提示する必要がないことを指定します。  匿名クライアントであると解釈されます。|  
+|Windows|Windows 資格情報によって確立されたセキュリティ コンテキストで、SOAP メッセージ交換を実行できます。|  
+|\[ユーザー名\]|ユーザー名資格情報を使用したクライアントの認証をサービスで要求できるようにします。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、署名の生成やデータの暗号化など、ユーザー名を使用した暗号化操作が許可されていない点に注意してください。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ユーザー名資格情報の使用時に、トランスポートが確実にセキュリティで保護されます。|  
+|証明書|X.509 証明書を使用したクライアントの認証をサービスで要求できるようにします。|  
+|IssuedToken|セキュリティ ポリシーに従って構成されるカスタム トークンです。  既定のトークンの種類は、SAML \(Security Assertion Markup Language\) です。  トークンは、セキュリティ トークン サービスによって発行されます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md).|  
+  
+### サービス資格情報のネゴシエーション モデル  
+ *ネゴシエーション*とは、資格情報を交換することによって、クライアントとサービスとの間に信頼を確立するプロセスです。  このプロセスは、ネゴシエーション プロセスの次の手順に必要な情報だけを公開するために、クライアントとサービスとの間で反復して実行されます。  実際には、最後に、後続の操作で使用されるサービスの資格情報がクライアントに配信されます。  
+  
+ 1 つの例外を除き、既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のシステム指定のバインディングは、メッセージ レベルのセキュリティを使用しているときに、サービス資格情報を自動的にネゴシエートします   \(例外とは、<xref:System.ServiceModel.BasicHttpBinding> の場合です。このバインディングでは、既定ではセキュリティが有効化されません\)。この動作を無効にするには、<xref:System.ServiceModel.MessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティと <xref:System.ServiceModel.FederatedMessageSecurityOverHttp.NegotiateServiceCredential%2A> プロパティを参照してください。  
+  
+> [!NOTE]
+>  SSL セキュリティを .NET Framework 3.5 以降と共に使用すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは、証明書ストア内の中間証明書と SSL ネゴシエーション中に受信した中間証明書の両方を使用して、サービスの証明書に対して証明書チェーンの検証を実行します。  .NET Framework 3.0 では、ローカルの証明書ストアにインストールされている中間証明書のみが使用されます。  
+  
+#### 帯域外ネゴシエーション  
+ 自動ネゴシエーションを無効にした場合、サービスにメッセージを送信する前にクライアント側にサービス資格情報が準備されている必要があります。  これは、*帯域外*プロビジョニングとも呼ばれます。  たとえば、指定された資格情報の種類が証明書で、自動ネゴシエーションが無効の場合、クライアントはサービス所有者に連絡し、証明書を受け取って、クライアント アプリケーションを実行しているコンピューターにインストールする必要があります。  この方法は、たとえば B2B シナリオで、サービスにアクセスできるクライアントを厳密に制御することが必要な場合に使用される可能性があります。  この帯域外ネゴシエーションは、電子メールで実行できます。X.509 証明書は、Microsoft 管理コンソール \(MMC\) の証明書スナップインなどのツールを使用して、Windows 証明書ストアに格納します。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティを使用して、帯域外ネゴシエーションによって取得した証明書をサービスに提供します。  バインディングでは自動ネゴシエーションが許可されないので、<xref:System.ServiceModel.BasicHttpBinding> クラスを使用するときはこの操作が必要になります。  このプロパティは、相関関係のない双方向シナリオでも使用します。  このシナリオでは、クライアントが先にサーバーへの要求を送信する必要がなく、サーバーからクライアントにメッセージが送信されます。  サーバーにはクライアントからの要求がないので、サーバーはクライアントの証明書を使用して、クライアントへのメッセージを暗号化する必要があります。  
+  
+## 資格情報の値の設定  
+ セキュリティ モードを選択したら、実際の資格情報を指定する必要があります。  たとえば、資格情報の種類を "Certificate" に設定した場合、特定の資格情報 \(特定の X.509 証明書など\) をサービスまたはクライアントに関連付ける必要があります。  
+  
+ サービスをプログラミングしている場合とクライアントをプログラミングしている場合で、資格情報の値を設定する方法が少し異なります。  
+  
+### サービス資格情報の設定  
+ トランスポート モードを使用し、HTTP をトランスポートとして使用する場合は、インターネット インフォメーション サービス \(IIS\) を使用するか、証明書でポートを構成する必要があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md) および [HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md)。  
+  
+ コードで資格情報をサービスに提供するには、<xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成し、<xref:System.ServiceModel.ServiceHostBase.Credentials%2A> プロパティからアクセスできる <xref:System.ServiceModel.Description.ServiceCredentials> クラスを使用して適切な資格情報を指定します。  
+  
+#### 証明書の設定  
+ クライアントに対するサービスの認証に使用される X.509 証明書をサービスに提供するには、<xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.SetCertificate%2A> メソッドを使用します。  
+  
+ クライアント証明書をサービスに提供するには、<xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> メソッドを使用します。  
+  
+#### Windows 資格情報の設定  
+ クライアントが有効なユーザー名とパスワードを指定した場合、その資格情報がクライアントの認証に使用されます。  それ以外の場合は、現在ログオンしているユーザーの資格情報が使用されます。  
+  
+### クライアント資格情報の設定  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、クライアント アプリケーションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを使用してサービスに接続します。  各クライアントは、<xref:System.ServiceModel.ClientBase%601> クラスから派生しています。各クライアントでは <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティを使用して、クライアント資格情報のさまざまな値を指定できます。  
+  
+#### 証明書の設定  
+ サービスに対するクライアントの認証に使用される X.509 証明書をサービスに提供するには、<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential> クラスの <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> メソッドを使用します。  
+  
+## サービスに対するクライアントの認証でのクライアント資格情報の使用  
+ サービスとの通信に必要なクライアント資格情報は、<xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティまたは <xref:System.ServiceModel.ChannelFactory.Credentials%2A> プロパティを使用して提供されます。  この情報は、サービスに対してクライアントを認証するためにセキュリティ チャネルで使用されます。  認証は、次のいずれかの方法で実行されます。  
+  
+-   クライアント資格情報を 1 回使用してから、セキュリティ コンテキストを確立するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントのインスタンスを使用して最初のメッセージを送信します。  アプリケーション メッセージはすべて、そのセキュリティ コンテキストで保護されます。  
+  
+-   サービスに送信されたアプリケーション メッセージごとの認証に、クライアント資格情報を使用します。  この場合、クライアントとサービスとの間にコンテキストは確立されません。  
+  
+### 変更できない確立された ID  
+ 1 つ目の方法を使用した場合、確立されたコンテキストは、クライアント ID に永続的に関連付けられます。  つまり、セキュリティ コンテキストが確立されると、クライアントに関連付けられた ID を変更できません。  
+  
+> [!IMPORTANT]
+>  ID の切り替えができないこと \(つまり、セキュリティ コンテキストを確立する場合の既定の動作\) について、注意が必要な状況があります。  別のサービスと通信するサービスを作成する場合、この 2 番目のサービスに対して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを開くために使用した ID は変更できません。  これは、複数のクライアントが最初のサービスを使用できる状況で、2 番目のサービスにアクセスするときに最初のサービスがクライアントを偽装する場合、問題になります。  サービスがすべての呼び出し元に対して同じクライアントを再利用する場合、2 番目のサービスへの呼び出しはすべて、2 番目のサービスに対してクライアントを開くために使用した最初の呼び出し元の ID によって実行されます。  つまり、このサービスでは、すべてのクライアントが 2 番目のサービスと通信できるように、最初のクライアントの ID が使用されます。  これによって、権限の昇格が発生する可能性があります。  これがサービスの目的の動作でない場合、各呼び出し元を追跡し、その呼び出し元ごとに 2 番目のサービスに対する新しいクライアントを作成する必要があります。これによって、適切な呼び出し元が 2 番目のサービスと通信するために、サービスは適切なクライアントだけを使用できます。  
+  
+ 資格情報とセキュリティで保護されたセッション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティで保護されたセッションに関するセキュリティの検討](../../../../docs/framework/wcf/feature-details/security-considerations-for-secure-sessions.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.ClientBase%601?displayProperty=fullName>   
+ <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.Description.ClientCredentials.ClientCertificate%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.BasicHttpMessageSecurity.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.MessageSecurityOverMsmq.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.MessageSecurityOverTcp.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.TcpTransportSecurity.ClientCredentialType%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A?displayProperty=fullName>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.SetCertificate%2A?displayProperty=fullName>   
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)   
+ [WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)   
+ [HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/serializable-types.md b/docs/framework/wcf/feature-details/serializable-types.md
new file mode 100644
index 00000000000..763e595d402
--- /dev/null
+++ b/docs/framework/wcf/feature-details/serializable-types.md
@@ -0,0 +1,53 @@
+---
+title: "シリアル化可能な型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1c8539a-6a79-4413-b294-896f0957b2cd
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# シリアル化可能な型
+既定では、<xref:System.Runtime.Serialization.DataContractSerializer> は公開されている型をすべてシリアル化します。  その型の読み書き可能なパブリック プロパティおよびパブリック フィールドは、すべてシリアル化されます。  
+  
+ 既定の動作を変更するには、<xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を型とメンバーに適用します。この機能は、使用するコントロールに型がない場合や属性を追加するように変更できない場合に役立ちます。  <xref:System.Runtime.Serialization.DataContractSerializer> は "マークされていない" 型を認識します。  
+  
+## シリアル化の既定  
+ <xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用して、型とメンバーのシリアル化を明示的に制御またはカスタマイズできます。  さらに、これらの属性をプライベート フィールドに適用することもできます。  ただし、これらの属性でマークされていない型もシリアル化および逆シリアル化されます。  次のルールと例外が適用されます。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> は、新しく作成した型の既定のプロパティを使用して、属性のない型からデータ コントラクトを推論します。  
+  
+-   すべてのパブリック フィールドと、パブリック `get` メソッドおよび `set` メソッドを持つプロパティは、<xref:System.Runtime.Serialization.IgnoreDataMemberAttribute> 属性をそのメンバーに適用しない限りシリアル化されます。  
+  
+-   シリアル化のセマンティクスは <xref:System.Xml.Serialization.XmlSerializer> に似ています。  
+  
+-   マークされていない型では、パラメーターのないコンストラクターを持つパブリック型のみがシリアル化されます。  このルールの例外として、<xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスとして使用される <xref:System.Runtime.Serialization.ExtensionDataObject> があります。  
+  
+-   読み取り専用フィールド、`get` メソッドまたは `set` メソッドのないプロパティ、内部またはプライベート `set` メソッドまたは `get` メソッドのあるプロパティはシリアル化されません。  そのようなプロパティは無視され、例外はスローされません。ただし、取得専用のコレクションの場合は除きます。  
+  
+-   <xref:System.Xml.Serialization.XmlSerializer> 属性 \(`XmlElement`、`XmlAttribute`、`XmlIgnore`、`XmlInclude` など\) は無視されます。  
+  
+-   <xref:System.Runtime.Serialization.DataContractAttribute> 属性を指定の型に適用しない場合は、シリアライザーは <xref:System.Runtime.Serialization.DataMemberAttribute> 属性が適用されるその型のすべてのメンバーを無視します。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer.KnownTypes%2A> プロパティは <xref:System.Runtime.Serialization.DataContractAttribute> 属性でマークされていない型でサポートされます。  これには、マークされていない型での <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性のサポートも含まれます。  
+  
+-   パブリック メンバー、プロパティ、またはフィールドのシリアル化のプロセスを "取り消す" には、<xref:System.Runtime.Serialization.IgnoreDataMemberAttribute> 属性をそのメンバーに適用します。  
+  
+## 継承  
+ マークされていない型 \(<xref:System.Runtime.Serialization.DataContractAttribute> 属性のない型\) は、この属性を持つ型から継承できます。ただし、その反対はできません。つまり、マークされていない型から属性を持つ型を継承することはできません。  このルールは、主に以前のバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で書かれたコードとの下位互換性を保つために適用されます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.IgnoreDataMemberAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ [データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/serialization-and-deserialization.md b/docs/framework/wcf/feature-details/serialization-and-deserialization.md
new file mode 100644
index 00000000000..12e33e6cf29
--- /dev/null
+++ b/docs/framework/wcf/feature-details/serialization-and-deserialization.md
@@ -0,0 +1,272 @@
+---
+title: "シリアル化と逆シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d71814c-bda7-424b-85b7-15084ff9377a
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# シリアル化と逆シリアル化
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には新しいシリアル化エンジン、<xref:System.Runtime.Serialization.DataContractSerializer> が含まれます。<xref:System.Runtime.Serialization.DataContractSerializer> は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトと XML を双方向で変換します。 ここでは、シリアライザーのしくみについて説明します。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトをシリアル化するときに、シリアライザーは新しい*データ コントラクト* モデルも含めて、さまざまなシリアル化プログラミング モデルを認識します。 サポートされるすべての型の一覧については、「[データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)」を参照してください。 データ コントラクトの概要については、「[データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)」を参照してください。  
+  
+ XML を逆シリアル化するときに、シリアライザーは <xref:System.Xml.XmlReader> クラスと <xref:System.Xml.XmlWriter> クラスを使用します。 また、<xref:System.Xml.XmlDictionaryReader> バイナリ XML 形式を使用する場合などに、最適化された XML を生成できるように、<xref:System.Xml.XmlDictionaryWriter> クラスと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クラスもサポートしています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、コンパニオン シリアライザーである <xref:System.Runtime.Serialization.NetDataContractSerializer> も含まれます。<xref:System.Runtime.Serialization.NetDataContractSerializer> は、シリアル化されたデータの一部として <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> 型名を出力するため、<xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> シリアライザーや [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] シリアライザーに似ています。 このシリアライザーは、シリアル化と逆シリアル化の終了時に、同じ型を共有する場合に使用します。<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.NetDataContractSerializer> は、共通の基本クラスである <xref:System.Runtime.Serialization.XmlObjectSerializer> から派生します。  
+  
+> [!WARNING]
+>  <xref:System.Runtime.Serialization.DataContractSerializer> は、20 未満の 16 進数値と制御文字を含む文字列を XML エンティティとしてシリアル化します。 このため、WCF サービスにそのようなデータを送信する際に WCF 以外のクライアントに問題が発生することがあります。  
+  
+## DataContractSerializer インスタンスの作成  
+ <xref:System.Runtime.Serialization.DataContractSerializer> のインスタンスの作成は重要な手順です。 インスタンスの作成後に、設定を変更することはできません。  
+  
+### ルート型の指定  
+ *ルート型*は、シリアル化または逆シリアル化するインスタンスの型です。<xref:System.Runtime.Serialization.DataContractSerializer> には、多数のコンストラクター オーバーロードがありますが、`type`  パラメーターを使用して、少なくともルート型を指定する必要があります。  
+  
+ 特定のルート型に対応するシリアライザーを作成した場合、このシリアライザーを使用して別の型をシリアル化 \(または逆シリアル化\) することはできません。ただし、対象の型がルート型の派生型である場合を除きます。 2 つのクラスを次の例に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#1)]
+ [!code-vb[c_StandaloneDataContractSerializer#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#1)]  
+  
+ `DataContractSerializer` クラスのインスタンスをシリアル化または逆シリアル化する場合にのみ使用できる `Person` のインスタンスを作成するコードを次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#2)]
+ [!code-vb[c_StandaloneDataContractSerializer#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#2)]  
+  
+### 既知の型の指定  
+ <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性またはその他の機構を使用してまだ処理されていないシリアル化対象の型にポリモーフィズムが必要な場合、`knownTypes` パラメーターを使用して、存在し得る既知の型のリストをシリアライザーのコンストラクターに渡す必要があります。 既知の型[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+ `LibraryPatron` 型のコレクションを含む `LibraryItem` クラスの例を次に示します。 2 番目のクラスでは、`LibraryItem` 型を定義しています。 3 番目と 4 番目のクラス \(`Book` と `Newspaper`\) は、`LibraryItem` クラスを継承しています。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#3)]
+ [!code-vb[c_StandaloneDataContractSerializer#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#3)]  
+  
+ `knownTypes` パラメーターを使用して、シリアライザーのインスタンスを作成するコードを次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#4)]
+ [!code-vb[c_StandaloneDataContractSerializer#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#4)]  
+  
+### 既定のルート名と名前空間の指定  
+ 通常、オブジェクトをシリアル化すると、データ コントラクト名と名前空間に従って、最も外側にある XML 要素の既定の名前と名前空間が決定されます。 内側のすべての要素の名前はデータ メンバー名から決定され、名前空間にはデータ コントラクトの名前空間が使用されます。`Name` クラスと `Namespace` クラスのコンストラクターで、<xref:System.Runtime.Serialization.DataContractAttribute> および <xref:System.Runtime.Serialization.DataMemberAttribute> の値を設定する例を次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#5)]
+ [!code-vb[c_StandaloneDataContractSerializer#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#5)]  
+  
+ `Person` クラスのインスタンスをシリアル化すると、次のような XML が生成されます。  
+  
+```  
+<PersonContract xmlns="http://schemas.contoso.com">  
+  <AddressMember>  
+    <StreetMember>123 Main Street</StreetMember>  
+   </AddressMember>  
+</PersonContract>  
+```  
+  
+ ただし、`rootName` パラメーターと `rootNamespace` パラメーターの値を <xref:System.Runtime.Serialization.DataContractSerializer> のコンストラクターに渡すことにより、ルート要素の既定の名前と名前空間をカスタマイズできます。`rootNamespace` は、データ メンバーに対応する格納されている要素の名前空間には影響を及ぼしません。 このパラメーターの影響を受けるのは、最も外側の要素の名前空間だけです。  
+  
+ これらの値を文字列または <xref:System.Xml.XmlDictionaryString> クラスのインスタンスとして渡すと、バイナリ XML 形式を使用して最適化できます。  
+  
+### オブジェクトの最大クォータの設定  
+ `DataContractSerializer` の一部のコンストラクター オーバーロードには、`maxItemsInObjectGraph` パラメーターが含まれています。 このパラメーターにより、<xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> メソッドの 1 回の呼び出しで、シリアライザーがシリアル化または逆シリアル化するオブジェクトの最大数が決まります  \(このメソッドは常に、1 つのルート オブジェクトを読み取りますが、このオブジェクトはそのデータ メンバー内に他のオブジェクトを保持する場合があります。 さらに、そうしたオブジェクトも他のオブジェクトを持つ場合があります。以降のオブジェクトについても同様です\)。 既定値は 65536 です。 配列のシリアル化または逆シリアル化を行う場合、すべての配列エントリが個別のオブジェクトとしてカウントされることに注意してください。 また、オブジェクトによってはメモリ表現が大きくなる場合があり、このクォータだけでは、サービス拒否攻撃の防止には不十分である可能性があることに注意してください。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)。 このクォータはデータの読み取り時と書き込み時の両方に適用されるため、このクォータに既定値を上回る値を設定する必要がある場合は、送信側 \(シリアル化\) と受信側 \(逆シリアル化\) の両方で設定することが重要です。  
+  
+### ラウンド トリップ  
+ *ラウンド トリップ*は、1 つの操作でオブジェクトの逆シリアル化と再シリアル化が行われるときに発生します。 したがって、XML からオブジェクト インスタンスを経由し、再び XML ストリームに戻るラウンド トリップが発生します。  
+  
+ `DataContractSerializer` の一部のコンストラクター オーバーロードには、`ignoreExtensionDataObject`  パラメーターが含まれており、既定で `false`  に設定されています。 この既定のモードでは、データ コントラクトが <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装していれば、データ コントラクトの新しいバージョンから以前のバージョンを経由し、新しいバージョンに戻るラウンド トリップで、データを失うことなく送信できます。 たとえば、`Person` データ コントラクトのバージョン 1 に、`Name` および `PhoneNumber` の各データ メンバーが含まれており、バージョン 2 で `Nickname` メンバーを追加したとします。`IExtensibleDataObject` を実装している場合、バージョン 2 からバージョン 1 に情報を送信すると、`Nickname` データが格納され、データを再度シリアル化したときに再出力されます。したがって、ラウンド トリップでデータが失われることはありません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」および「[データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md)」を参照してください。  
+  
+#### ラウンド トリップでのセキュリティとスキーマ検証の問題  
+ ラウンド トリップは、セキュリティに影響する場合があります。 たとえば、大量の無関係のデータを逆シリアル化し格納した場合、セキュリティ リスクが生じる可能性があります。 特に、デジタル署名を伴う場合は、検証方法のないこのようなデータの再出力について、セキュリティの問題が発生することがあります。 たとえば、前のシナリオでは、バージョン 1 エンドポイントが、悪質なデータを含む `Nickname` 値に署名する可能性があります。 また、スキーマ検証の問題が発生することもあります。エンドポイントでは、余分な値を出力せずに、記述されたコントラクトに厳密に従ったデータを常に出力することが必要な場合があります。 前の例では、バージョン 1 エンドポイントのコントラクトで `Name` と `PhoneNumber` だけを出力するよう指定されているときに、スキーマ検証を使用すると、余分な `Nickname` 値の出力によって検証が失敗します。  
+  
+#### ラウンド トリップの有効化と無効化  
+ ラウンド トリップを無効にする場合は、<xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装しないでください。 型を制御できない場合は、`ignoreExtensionDataObject` パラメーターを `true` に設定することで、同じ効果を得ることができます。  
+  
+### オブジェクト グラフの保存  
+ 次のコードに示すように、通常、シリアライザーはオブジェクト ID に留意することはありません。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#6)]
+ [!code-vb[c_StandaloneDataContractSerializer#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#6)]  
+  
+ 発注書を作成するコードを次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#7)]
+ [!code-vb[c_StandaloneDataContractSerializer#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#7)]  
+  
+ `billTo` フィールドと `shipTo` フィールドが、同じオブジェクト インスタンスに設定されていることに注意してください。 ただし、生成される XML は重複する情報を繰り返します。XML は次のようになります。  
+  
+```  
+<PurchaseOrder>  
+  <billTo><street>123 Main St.</street></billTo>  
+  <shipTo><street>123 Main St.</street></shipTo>  
+</PurchaseOrder>  
+```  
+  
+ この方法には以下の特性があり、望ましくないことがあります。  
+  
+-   パフォーマンス。 データのレプリケートは非効率的です。  
+  
+-   循環参照。 他のオブジェクトを介してであっても、オブジェクトがそれ自体を参照している場合、レプリケーションによるシリアル化は無限ループを発生させます  \(この状況が発生した場合、シリアライザーは <xref:System.Runtime.Serialization.SerializationException> をスローします\)。  
+  
+-   セマンティクス。 2 つの参照の参照先が 1 つのオブジェクトであり、2 つの同一のオブジェクトではない状態を維持することが重要な場合があります。  
+  
+ 上記の理由から、`DataContractSerializer` の一部のコンストラクター オーバーロードには、`preserveObjectReferences` パラメーターが含まれています \(既定値は `false` です\)。 このパラメーターを `true` に設定すると、オブジェクト参照をエンコードする特殊なメソッドが使用されます。これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] だけが認識するメソッドです。`true` に設定すると、XML コードの例は次のようになります。  
+  
+```  
+<PurchaseOrder ser:id="1">  
+  <billTo ser:id="2"><street ser:id="3">123 Main St.</street></billTo>  
+  <shipTo ser:ref="2"/>  
+</PurchaseOrder>  
+```  
+  
+ "ser" 名前空間は、シリアル化標準名前空間である http:\/\/schemas.microsoft.com\/2003\/10\/Serialization\/ を指します。 データの各部分は 1 回だけシリアル化され、ID 番号が与えられます。以降は、既にシリアル化されたデータへの参照を使用することになります。  
+  
+> [!IMPORTANT]
+>  "id" および "ref" 属性の両方がデータ コントラクト `XMLElement` に存在する場合、"ref" 属性が使用され、"id" 属性は無視されます。  
+  
+ このモードの以下の制限を理解しておくことが重要です。  
+  
+-   `DataContractSerializer` が `preserveObjectReferences`  に設定された `true` によって生成した XML は、他のテクノロジと相互運用できません。この XML にアクセスできるのは、`DataContractSerializer` が `preserveObjectReferences` に設定された別の `true` インスタンスだけです。  
+  
+-   この機能では、メタデータ \(スキーマ\) はサポートされていません。 生成されるスキーマは、`preserveObjectReferences` が `false` に設定されている場合にのみ有効です。  
+  
+-   この機能により、シリアル化および逆シリアル化プロセスの実行速度が低下することがあります。 データをレプリケートする必要はありませんが、このモードではオブジェクトの比較を追加で実行する必要があります。  
+  
+> [!CAUTION]
+>  `preserveObjectReferences` モードを有効にする場合、`maxItemsInObjectGraph` の値を適切なクォータに設定することが特に重要となります。 このモードでの配列の処理方法に起因して、攻撃者は `maxItemsInObjectGraph` のクォータによってのみ制限される、メモリを大量に消費させる小さい悪質なメッセージを容易に作成できます。  
+  
+### データ コントラクト サロゲートの指定  
+ `DataContractSerializer` の一部のコンストラクター オーバーロードには、`dataContractSurrogate` パラメーターが含まれています。このパラメーターは、`null` に設定できます。 それ以外の場合は、このパラメーターを使用して、*データ コントラクト サロゲート*を指定できます。データ コントラクト サロゲートは、<xref:System.Runtime.Serialization.IDataContractSurrogate> インターフェイスを実装する型です。 このインターフェイスを使用して、シリアル化および逆シリアル化プロセスをカスタマイズできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md)。  
+  
+## シリアル化  
+ 次の情報は <xref:System.Runtime.Serialization.XmlObjectSerializer> を継承するすべてのクラス \(<xref:System.Runtime.Serialization.DataContractSerializer> クラスおよび <xref:System.Runtime.Serialization.NetDataContractSerializer> クラスを含む\) に適用されます。  
+  
+### 単純なシリアル化  
+ オブジェクトをシリアル化する最も簡単な方法は、オブジェクトを <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObject%2A> メソッドに渡すことです。 このメソッドには 3 つのオーバーロードがあり、それぞれ <xref:System.IO.Stream>、<xref:System.Xml.XmlWriter>、および <xref:System.Xml.XmlDictionaryWriter> への書き込みに対応しています。<xref:System.IO.Stream> オーバーロードの場合、出力は UTF\-8 エンコードの XML です。<xref:System.Xml.XmlDictionaryWriter> オーバーロードを使用すると、シリアライザーによってバイナリ XML の出力が最適化されます。  
+  
+ <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObject%2A> メソッドを使用した場合、シリアライザーはラッパー要素の既定の名前と名前空間を使用し、コンテンツと共に書き込みます \(前の「既定のルート名と名前空間の指定」セクションを参照してください\)。  
+  
+ <xref:System.Xml.XmlDictionaryWriter> を使用した書き込みの例を次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#8)]
+ [!code-vb[c_StandaloneDataContractSerializer#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#8)]  
+  
+ これにより作成される XML は、次のようになります。  
+  
+```  
+<Person>  
+  <Name>Jay Hamlin</Name>  
+  <Address>123 Main St.</Address>  
+</Person>  
+```  
+  
+### 段階的なシリアル化  
+ 終了要素を書き込み、オブジェクトの内容を書き込み、ラッパー要素を閉じるには、それぞれ <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject%2A>、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObjectContent%2A>、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject%2A> の各メソッドを使用します。  
+  
+> [!NOTE]
+>  これらのメソッドの <xref:System.IO.Stream> オーバーロードはありません。  
+  
+ この段階的なシリアル化には、2 つの一般的な使用方法があります。 次の例に示すように、1 つは属性やコメントなどのコンテンツを `WriteStartObject` と `WriteObjectContent` の間に挿入する場合に使用します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#9)]
+ [!code-vb[c_StandaloneDataContractSerializer#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#9)]  
+  
+ これにより作成される XML は、次のようになります。  
+  
+```  
+<Person serializedBy="myCode">  
+  <Name>Jay Hamlin</Name>  
+  <Address>123 Main St.</Address>  
+</Person>  
+```  
+  
+ もう 1 つは、次のコードに示すように、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject%2A> と <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject%2A> を使用せずに、独自のカスタム ラッパー要素を書き込む場合 \(ラッパーの書き込みを省略する場合もあります\) に使用します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#10)]
+ [!code-vb[c_StandaloneDataContractSerializer#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#10)]  
+  
+ これにより作成される XML は、次のようになります。  
+  
+```  
+<MyCustomWrapper>  
+  <Name>Jay Hamlin</Name>  
+  <Address>123 Main St.</Address>  
+</MyCustomWrapper>  
+```  
+  
+> [!NOTE]
+>  段階的なシリアル化を使用すると、スキーマが無効な XML が生成されることがあります。  
+  
+## 逆シリアル化  
+ 次の情報は <xref:System.Runtime.Serialization.XmlObjectSerializer> を継承するすべてのクラス \(<xref:System.Runtime.Serialization.DataContractSerializer> クラスおよび <xref:System.Runtime.Serialization.NetDataContractSerializer> クラスを含む\) に適用されます。  
+  
+ オブジェクトを逆シリアル化する最も簡単な方法は、<xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> メソッド オーバーロードのいずれかを呼び出すことです。 3 つのオーバーロードがあり、それぞれ <xref:System.Xml.XmlDictionaryReader>、`XmlReader`、および `Stream` を使用した読み取りに対応しています。`Stream` オーバーロードは、クォータによって保護されていないテキスト形式の <xref:System.Xml.XmlDictionaryReader> を作成するため、信頼されたデータを読み取る場合にのみ使用します。  
+  
+ `ReadObject` メソッドが返すオブジェクトは、適切な型にキャストする必要があります。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> のインスタンスと <xref:System.Xml.XmlDictionaryReader> を作成し、`Person` インスタンスを逆シリアル化するコードを次に示します。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#11)]
+ [!code-vb[c_StandaloneDataContractSerializer#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#11)]  
+  
+ <xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> メソッドを呼び出す前に、ラッパー要素またはラッパー要素の前にあるコンテンツ ノード以外のノードに XML リーダーを配置します。 これを行うには、次のコードに示すように、<xref:System.Xml.XmlReader.Read%2A> またはその派生クラスの <xref:System.Xml.XmlReader> メソッドを呼び出し、<xref:System.Xml.XmlReader.NodeType%2A> を調べます。  
+  
+ [!code-csharp[c_StandaloneDataContractSerializer#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_standalonedatacontractserializer/cs/source.cs#12)]
+ [!code-vb[c_StandaloneDataContractSerializer#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_standalonedatacontractserializer/vb/source.vb#12)]  
+  
+ `ReadObject` にリーダーを渡す前に、このラッパー要素の属性を読み取ることができます。  
+  
+ 簡単な `ReadObject` オーバーロードのいずれかを使用すると、デシリアライザーはラッパー要素の既定の名前と名前空間を検索し \(前の「既定のルート名と名前空間の指定」セクションを参照\)、不明な要素が見つかった場合は例外をスローします。 前の例では、`<Person>` ラッパー要素が必要とされます。 予想どおりの名前が付けられた要素にリーダーが配置されているかどうかを確認するために、<xref:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject%2A> メソッドが呼び出されます。  
+  
+ ラッパー要素のこの名前チェックを無効にする方法があります。`ReadObject` メソッドの一部のオーバーロードは、ブール型パラメーター `verifyObjectName` を取得します。このパラメーターは、既定で `true` に設定されています。 このパラメーターを `false` に設定すると、ラッパー要素の名前と名前空間が無視されます。 これは、前述の段階的なシリアル化機構を使用して書き込まれた XML を読み取る際に役立ちます。  
+  
+## NetDataContractSerializer の使用  
+ `DataContractSerializer` と <xref:System.Runtime.Serialization.NetDataContractSerializer> の大きな違いは、`DataContractSerializer` は、データ コントラクト名を使用するのに対し、`NetDataContractSerializer` は、シリアル化された XML に [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アセンブリと型の完全名を出力するという点です。 これは、シリアル化エンドポイントと逆シリアル化エンドポイント間で、まったく同じ型を共有する必要があることを意味します。 逆シリアル化する正確な型が常にわかっているため、`NetDataContractSerializer` では既知の型機構は必要ないということです。  
+  
+ ただし、次のようないくつかの問題が発生する可能性があります。  
+  
+-   セキュリティ。 逆シリアル化する XML で見つかったすべての型が読み込まれます。 これを利用して、悪質な型が強制的に読み込まれるおそれがあります。 信頼できないデータでの `NetDataContractSerializer` の使用は、\(<xref:System.Runtime.Serialization.NetDataContractSerializer.Binder%2A> プロパティまたはコンストラクター パラメーターを使用して\) *シリアル化バインダー*を使用する場合に限定する必要があります。 バインダーが読み込みを許可するのは安全な型だけです。 このバインダー機構は、<xref:System.Runtime.Serialization> 名前空間の型が使用するものと同じです。  
+  
+-   バージョン管理。 XML で型とアセンブリの完全名を使用する場合、型をバージョン管理する方法が厳しく制限されます。 型名、名前空間、アセンブリ名、およびアセンブリのバージョンを変更することはできません。<xref:System.Runtime.Serialization.NetDataContractSerializer.AssemblyFormat%2A> プロパティまたはコンストラクター パラメーターを既定値の <xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle> ではなく、<xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle> に設定すると、アセンブリのバージョンを変更できるようになりますが、ジェネリック パラメーターの型を変更することはできません。  
+  
+-   相互運用性。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型名とアセンブリ名は XML に含まれるため、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 以外のプラットフォームでは、生成されたデータにアクセスできません。  
+  
+-   パフォーマンス。 型名とアセンブリ名を書き込むと、生成される XML のサイズが大幅に増加します。  
+  
+ この機構は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] リモート処理で使用されるバイナリ シリアル化または SOAP シリアル化 \(具体的には、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> と <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>\) に似ています。  
+  
+ `NetDataContractSerializer` の使用方法と `DataContractSerializer` の使用方法は似ていますが、次のような違いがあります。  
+  
+-   コンストラクターでルート型を指定する必要はありません。`NetDataContractSerializer` の同じインスタンスを使用して、すべての型をシリアル化できます。  
+  
+-   コンストラクターは、既知の型のリストを受け入れません。 型名を XML にシリアル化する場合、既知の型機構は不要です。  
+  
+-   コンストラクターは、データ コントラクト サロゲートを受け入れません。 代わりに、\(<xref:System.Runtime.Serialization.ISurrogateSelector> プロパティに割り当てられた\) `surrogateSelector` という <xref:System.Runtime.Serialization.NetDataContractSerializer.SurrogateSelector%2A> のパラメーターを受け入れます。 これは、従来のサロゲート機構です。  
+  
+-   コンストラクターは、`assemblyFormat` プロパティに割り当てられた、<xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle> の <xref:System.Runtime.Serialization.NetDataContractSerializer.AssemblyFormat%2A> というパラメーターを受け入れます。 前述のように、このパラメーターを使用することで、シリアライザーのバージョン管理機能を強化できます。 これは、バイナリ シリアル化または SOAP シリアル化の <xref:System.Runtime.Serialization.Formatters.FormatterAssemblyStyle> 機構と同じです。  
+  
+-   コンストラクターは、<xref:System.Runtime.Serialization.StreamingContext> プロパティに割り当てられた `context` という <xref:System.Runtime.Serialization.NetDataContractSerializer.Context%2A> のパラメーターを受け入れます。 このパラメーターを使用して、シリアル化する型に情報を渡すことができます。 この使用方法は、他の <xref:System.Runtime.Serialization.StreamingContext> クラスで使用する <xref:System.Runtime.Serialization> 機構と同じです。  
+  
+-   <xref:System.Runtime.Serialization.NetDataContractSerializer.Serialize%2A> メソッドと <xref:System.Runtime.Serialization.NetDataContractSerializer.Deserialize%2A> メソッドは、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObject%2A> メソッドと <xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> メソッドのエイリアスです。 これらのメソッドは、より一貫性のあるプログラミング モデルで、バイナリ シリアル化または SOAP シリアル化を使用できるようにするために存在しています。  
+  
+ このような機能の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[バイナリ シリアル化](../../../../docs/framework/serialization/binary-serialization.md)」を参照してください。  
+  
+ 通常、`NetDataContractSerializer` と `DataContractSerializer` が使用する XML 形式には互換性がありません。 したがって、これらのシリアライザーの一方を使用してシリアル化し、もう一方を使用して逆シリアル化するシナリオはサポートされていません。  
+  
+ また、`NetDataContractSerializer` は、オブジェクト グラフの各ノードについて、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型とアセンブリの完全名を出力しません。 この情報を出力するのは、情報が不明確な場合だけです。 つまり、ポリモーフィックである場合に、ルート オブジェクト レベルで出力します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.NetDataContractSerializer>   
+ <xref:System.Runtime.Serialization.XmlObjectSerializer>   
+ [バイナリ シリアル化](../../../../docs/framework/serialization/binary-serialization.md)   
+ [データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/serializing-in-json-with-message-level-programming.md b/docs/framework/wcf/feature-details/serializing-in-json-with-message-level-programming.md
new file mode 100644
index 00000000000..12292e8fd6e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/serializing-in-json-with-message-level-programming.md
@@ -0,0 +1,45 @@
+---
+title: "メッセージ レベルのプログラミングによる JSON 形式でのシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f940ba2-57ee-4c49-a779-957c5e7e71fa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# メッセージ レベルのプログラミングによる JSON 形式でのシリアル化
+WCF は、JSON 形式でのデータのシリアル化をサポートします。このトピックでは、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用して型をシリアル化することを WCF に命令する方法について説明します。  
+  
+## 型指定されたメッセージのプログラミング  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> は、<xref:System.ServiceModel.Web.WebGetAttribute> または <xref:System.ServiceModel.Web.WebInvokeAttribute> がサービス操作に適用されるときに使用されます。どちらの属性でも、`RequestFormat` と `ResponseFormat` を指定できます。要求と応答に JSON を使用するには、両方の属性を `WebMessageFormat.Json` に設定します。JSON を使用するには、<xref:System.ServiceModel.WebHttpBinding> を使用する必要があります。これにより、<xref:System.ServiceModel.Description.WebHttpBehavior> が自動的に構成されます。WCF のシリアル化の詳細については、「[シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)」および「[Windows Communication Foundation でのシリアル化](http://msdn.microsoft.com/magazine/cc163569.aspx)」を参照してください。JSON と WCF の詳細については、「[WCF の RESTful サービスの概要](http://msdn.microsoft.com/magazine/dd315413.aspx)」、「[.NET 3.5 での JSON が有効な WCF サービスの作成](http://www.pluralsight-training.net/community/blogs/fritz/archive/2008/01/31/50121.aspx)」、および「[WCF REST の概要](http://msdn.microsoft.com/netframework/dd547388)」を参照してください。  
+  
+> [!IMPORTANT]
+>  JSON を使用するには、SOAP 通信をサポートしていない <xref:System.ServiceModel.WebHttpBinding> と <xref:System.ServiceModel.Description.WebHttpBehavior> を使用する必要があります。<xref:System.ServiceModel.WebHttpBinding> と通信を行うサービスは、サービス メタデータの公開をサポートしません。したがって、Visual Studio の "サービス参照の追加" 機能または svcutil コマンド ライン ツールを使用してクライアント側プロキシを生成することはできません。<xref:System.ServiceModel.WebHttpBinding> を使用するサービスをプログラムで呼び出す方法については、「[WCF で REST サービスを使用する方法](http://blogs.msdn.com/b/pedram/archive/2008/04/21/how-to-consume-rest-services-with-wcf.aspx)」を参照してください。  
+  
+## 型指定されていないメッセージのプログラミング  
+ 型指定されていないメッセージ オブジェクトを直接操作する場合は、型指定されていないメッセージのプロパティを明示的に設定して JSON としてシリアル化する必要があります。これを行う方法を次のコード スニペットに示します。  
+  
+```  
+ Message response = Message.CreateMessage(  
+                  MessageVersion.None,    // No SOAP message version  
+                             "*",                     // SOAP action, ignored since this is JSON  
+                             "Response string: JSON format specified", // Message body  
+                             new DataContractJsonSerializer(typeof(string))); // Specify DataContractJsonSerializer  
+      response.Properties.Add( WebBodyFormatMessageProperty.Name,   
+                    new WebBodyFormatMessageProperty(WebContentFormat.Json)); // Use JSON format  
+  
+```  
+  
+## 参照  
+ [AJAX の統合と JSON のサポート](../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)   
+ [スタンドアロン JSON のシリアル化](../../../../docs/framework/wcf/feature-details/stand-alone-json-serialization.md)   
+ [JSON シリアル化](../../../../docs/framework/wcf/samples/json-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md b/docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md
new file mode 100644
index 00000000000..07d853aaec2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md
@@ -0,0 +1,115 @@
+---
+title: "サービス エンドポイントとキューのアドレス指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d2d59d7-f08b-44ed-bd31-913908b83d97
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# サービス エンドポイントとキューのアドレス指定
+ここでは、キューから読み取るサービスをクライアントがアドレス指定するしくみと、サービス エンドポイントがキューにマップされるしくみについて説明します。キューに置かれた [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションの標準的な配置を次の図に示します。  
+  
+ ![キューに置かれたアプリケーションの図](../../../../docs/framework/wcf/feature-details/media/distributed-queue-figure.jpg "Distributed\-Queue\-Figure")  
+  
+ クライアントは、メッセージをサービスに送信するために、メッセージをターゲット キューにアドレス指定します。サービスは、キューからメッセージを読み取るために、リッスン アドレスをターゲット キューに設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのアドレス指定は URI \(Uniform Resource Identifier\) ベースですが、メッセージ キュー \(MSMQ\) のキュー名は URI ベースでありません。そのため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、MSMQ で作成されたキューをアドレス指定する方法を理解しておくことが不可欠となります。  
+  
+## MSMQ のアドレス指定  
+ MSMQ は、パスと形式名を使用してキューを識別します。パスでは、ホスト名と `QueueName` を指定します。必要に応じて、ホスト名と `QueueName` の間に `Private$` を指定して、Active Directory ディレクトリ サービスで公開されないプライベート キューを示すこともできます。  
+  
+ パス名は、ルーティングやキュー マネージャー転送プロトコルを含む、アドレスの追加の側面を指定する "FormatNames" にマップされます。キュー マネージャーは、ネイティブの MSMQ プロトコルと SOAP リライアブル メッセージ プロトコル \(SRMP: SOAP Reliable Messaging Protocol\) の 2 つの転送プロトコルをサポートしています。  
+  
+ MSMQ のパスと形式名[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[About Message Queuing](http://go.microsoft.com/fwlink/?LinkId=94837)」を参照してください。  
+  
+## NetMsmqBinding とサービスのアドレス指定  
+ メッセージをサービスにアドレス指定するときは、通信に使用するトランスポートに基づいて URI のスキームが選択されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の各トランスポートには、一意のスキームがあります。このスキームには、通信に使用されるトランスポートの性質を反映する必要があります。たとえば、net.tcp、net.pipe、HTTP などがあります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 内の MSMQ のキューに置かれたトランスポートは、net.msmq スキームを公開します。net.msmq スキームを使用してアドレス指定されたすべてのメッセージは、`NetMsmqBinding` を使用して、MSMQ のキューに置かれたトランスポート チャネル経由で送信されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのキューのアドレス指定は、次のパターンに基づきます。  
+  
+ net.msmq: \/\/ \<*host\-name*\> \/ \[private\/\] \<*queue\-name*\>  
+  
+ 指定する項目は次のとおりです。  
+  
+-   \<*host\-name*\> は、ターゲット キューをホストするコンピューターの名前です。  
+  
+-   \[private\] はオプションです。専用キューであるターゲット キューをアドレス指定するときに使用します。パブリック キューをアドレス指定する場合は、private を指定しないでください。MSMQ のパスとは異なり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の URI 形式には "$" はありません。  
+  
+-   \<*queue\-name*\> は、キューの名前です。キュー名では、サブキューを参照することもできます。したがって、\<*queue\-name*\> \= \<*name\-of\-queue*\> \[;*sub\-queue\-name*\]。  
+  
+ 例 1 : コンピューター abc atadatum.com でホストされているプライベート キュー PurchaseOrders をアドレス指定する場合、URI は net.msmq:\/\/abc.adatum.com\/private\/PurchaseOrders になります。  
+  
+ 例 2 : コンピューター def atadatum.com でホストされているパブリック キュー AccountsPayable をアドレス指定する場合、URI は net.msmq:\/\/def.adatum.com\/AccountsPayable になります。  
+  
+ キュー アドレスは、メッセージを読み取るリスナーにより、リッスン URI として使用されます。つまり、キュー アドレスは TCP ソケットのリッスン ポートと同じです。  
+  
+ キューから読み取りを行うエンドポイントは、ServiceHost を開いたときにあらかじめ指定されているスキームと同じスキームを使用して、キューのアドレスを指定する必要があります。例については、「[ネット MSMQ バインディング](../../../../docs/framework/wcf/samples/net-msmq-binding.md)」および「[Message Queuing Integration Binding Samples](http://msdn.microsoft.com/ja-jp/997d11cb-f2c5-4ba0-9209-92843d4d0e1a)」を参照してください。  
+  
+### キュー内の複数のコントラクト  
+ キュー内のメッセージは、さまざまなコントラクトを実装している可能性があります。この場合、すべてのメッセージを正常に読み取って処理するためには、次のいずれかの処置を行う必要があります。  
+  
+-   すべてのコントラクトを実装するサービス エンドポイントを指定します。この方法をお勧めします。  
+  
+-   異なるコントラクトを持つ複数のエンドポイントを指定します。ただし、すべてのエンドポイントで同じ `NetMsmqBinding` オブジェクトを使用するようにしてください。ServiceModel のディスパッチ ロジックでは、ディスパッチ用のトランスポート チャネルからメッセージを読み取るメッセージ ポンプを使用します。メッセージ ポンプは、最終的にコントラクトに基づいてこれらのメッセージをさまざまなエンドポイントに非多重化します。メッセージ ポンプは、リッスン URI とバインディングの組み合わせに対して作成されます。キュー アドレスは、キューに格納されたリスナーにより、リッスン URI として使用されます。すべてのエンドポイントで同じバインディング オブジェクトを使用するようにすると、1 つのメッセージ ポンプを使用してメッセージを読み取り、コントラクトに基づいて関連するエンドポイントに非多重化できるようになります。  
+  
+### SRMP メッセージング  
+ 既に説明したように、キュー間の転送には SRMP プロトコルを使用できます。このプロトコルは、HTTP トランスポートを使用して転送キューとターゲット キューの間でメッセージを送信する場合に使用するのが一般的です。  
+  
+ SRMP 転送プロトコルを使用するには、前述の net.msmq URI スキームを使用してメッセージをアドレス指定し、`NetMsmqBinding` の `QueueTransferProtocol` プロパティで SRMP または Secured SRMP を指定します。  
+  
+ `QueueTransferProtocol` プロパティの指定は、送信専用の機能です。これは、使用するキュー転送プロトコルの種類の、クライアントによる指示です。  
+  
+### Active Directory の使用  
+ MSMQ は、Active Directory 統合をサポートします。MSMQ を Active Directory 統合と共にインストールした場合、コンピューターを Windows ドメインに含める必要があります。Active Directory は、探索用のキューを公開するために使用されます。このようなキューを *"パブリック キュー"* と呼びます。アドレス指定されたキューは、Active Directory を使用して解決できます。これは、ドメイン ネーム システム \(DNS: Domain Name System\) を使用して、ネットワーク名の IP アドレスを解決するしくみに似ています。`NetMsmqBinding` の `UseActiveDirectory` プロパティは、キューに置かれたチャネルでキューの URI を解決するために Active Directory を使用する必要があるかどうかを示すブール値です。既定では `false` に設定されています。`UseActiveDirectory` プロパティを `true` に設定すると、キューに置かれたチャネルは、Active Directory を使用して net.msmq:\/\/ URI を形式名に変換します。  
+  
+ `UseActiveDirectory` プロパティは、メッセージの送信時にキューのアドレスを解決するために使用されるので、メッセージを送信するクライアントに対してのみ有効です。  
+  
+### メッセージ キュー形式名への net.msmq URI のマップ  
+ キューに置かれたチャネルは、チャネルに提供された net.msmq URI 名を MSMQ 形式名にマップします。これらをマップする際に使用されるルールを次の表にまとめます。  
+  
+|WCF の URI ベースのキュー アドレス|UseActiveDirectory プロパティ|QueueTransferProtocol プロパティ|結果の MSMQ 形式名|  
+|----------------------------|------------------------------|---------------------------------|------------------|  
+|Net.msmq:\/\/\<machine\-name\>\/private\/abc|False \(既定値\)|Native \(既定値\)|DIRECT\=OS:machine\-name\\private$\\abc|  
+|Net.msmq:\/\/\<コンピューター名\>\/private\/abc|False|SRMP|DIRECT\=http:\/\/machine\/msmq\/private$\/abc|  
+|Net.msmq:\/\/\<コンピューター名\>\/private\/abc|True|Native|PUBLIC\=some\-guid \(キューの GUID\)|  
+  
+### 配信不能キューまたは有害メッセージ キューからのメッセージの読み取り  
+ ターゲット キューのサブキューである有害メッセージ キューからメッセージを読み取るには、サブキューのアドレスを使用して `ServiceHost` を開きます。  
+  
+ 例 : ローカル コンピューターの PurchaseOrders 専用キューの有害メッセージ キューから読み取るサービスでは、net.msmq:\/\/localhost\/private\/PurchaseOrders;poison というアドレスを指定します。  
+  
+ システム トランザクション配信不能キューからメッセージを読み取るには、URI を net.msmq:\/\/localhost\/system$;DeadXact という形式にする必要があります。  
+  
+ システム非トランザクション配信不能キューからメッセージを読み取るには、URI を net.msmq:\/\/localhost\/system$;DeadLetter という形式にする必要があります。  
+  
+ カスタムの配信不能キューを使用する場合は、配信不能キューをローカル コンピューターに配置する必要があります。そのため、配信不能キューの URI は次の形式に限定されます。  
+  
+ net.msmq: \/\/localhost\/ \[private\/\]  \<*custom\-dead\-letter\-queue\-name*\>.  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、受信するすべてのメッセージが、リッスンしている特定のキューにアドレス指定されているかどうかを確認します。メッセージの送信先キューとメッセージが置かれているキューが一致しない場合、サービスはメッセージを処理しません。この問題には、配信不能キューをリッスンしているサービスが対処する必要があります。これは、配信不能キューにあるメッセージが、他の場所に配信されることになっていたメッセージであるためです。配信不能キューや有害メッセージ キューからメッセージを読み取るには、<xref:System.ServiceModel.AddressFilterMode> パラメーターが設定された `ServiceBehavior` を使用する必要があります。例については、「[配信不能キュー](../../../../docs/framework/wcf/samples/dead-letter-queues.md)」を参照してください。  
+  
+## MsmqIntegrationBinding とサービスのアドレス指定  
+ `MsmqIntegrationBinding` は、従来の MSMQ アプリケーションとの通信に使用されます。既存の MSMQ アプリケーションとの相互運用を容易にするために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は形式名のアドレス指定のみをサポートしています。そのため、このバインディングを使用して送信されるメッセージは、次の URI スキームに従う必要があります。  
+  
+ msmq.formatname:\<*MSMQ\-format\-name*\>\>  
+  
+ "MSMQ\-format\-name" は、「[About Message Queuing](http://go.microsoft.com/fwlink/?LinkId=94837)」の MSMQ で指定された形式になります。  
+  
+ `MsmqIntegrationBinding` を使用してキューからメッセージを受信する場合、使用できるのは、直接形式名とパブリック\/プライベート形式名 \(ActiveDirectory 統合が必要です\) のみです。ただし、直接形式名を使用することをお勧めします。たとえば、[!INCLUDE[wv](../../../../includes/wv-md.md)] では、他の形式名を使用すると、エラーが発生します。これは、システムがサブキューを開こうとしても、サブキューは直接形式名でしか開くことができないためです。  
+  
+ `MsmqIntegrationBinding` を使用して SRMP のアドレス指定を行う場合は、インターネット インフォメーション サービス \(IIS: Internet Information Services\) のディスパッチを支援するために、直接形式名で \/msmq\/ を追加するという要件はありません。たとえば、SRMP プロトコルを使用してキュー abc をアドレス指定する場合は、DIRECT\=http:\/\/adatum.com\/msmq\/private$\/abc ではなく、DIRECT\=http:\/\/adatum.com\/private$\/abc を使用してください。  
+  
+ `MsmqIntegrationBinding` では、net.msmq:\/\/ によるアドレス指定を使用できないことに注意してください。`MsmqIntegrationBinding` は、自由形式の MSMQ 形式名によるアドレス指定をサポートしているため、このバインディングを使って MSMQ のマルチキャスト機能と配布リスト機能を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを使用できます。ただし、`MsmqIntegrationBinding` を使用するときに、`CustomDeadLetterQueue` を指定する場合を除きます。これは、`NetMsmqBinding` を使用して指定するのと同様に、net.msmq:\/\/ という形式にする必要があります。  
+  
+## 参照  
+ [キューに置かれたアプリケーションの Web ホスト](../../../../docs/framework/wcf/feature-details/web-hosting-a-queued-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/service-identity-and-authentication.md b/docs/framework/wcf/feature-details/service-identity-and-authentication.md
new file mode 100644
index 00000000000..14051c96b13
--- /dev/null
+++ b/docs/framework/wcf/feature-details/service-identity-and-authentication.md
@@ -0,0 +1,127 @@
+---
+title: "サービス ID と認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービスの id を指定する認証 [WCF]"
+ms.assetid: a4c8f52c-5b30-45c4-a545-63244aba82be
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# サービス ID と認証
+サービスの*エンドポイント id*サービス Web サービス記述言語 (WSDL) から生成される値です。 この値は、すべてのクライアントに反映され、サービスの認証に使用されます。 クライアントがエンドポイントとの通信を開始し、サービスがクライアントに対して認証を行った後に、クライアントは、エンドポイント ID 値とエンドポイントの認証プロセスから返された実際の値を比較します。 この&2; つの値が一致した場合、クライアントは要求したサービス エンドポイントに接続していることを確認できます。 これは、関数は、保護として*フィッシング*クライアントが悪質なサービスでホストされるエンドポイントにリダイレクトされるようにすることで。  
+  
+ Id の設定を示すサンプル アプリケーションを参照してください。[サービス Id サンプル](../../../../docs/framework/wcf/samples/service-identity-sample.md)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]エンドポイントとエンドポイント アドレスを参照してください。[アドレス](../../../../docs/framework/wcf/feature-details/endpoint-addresses.md)です。  
+  
+> [!NOTE]
+>  認証に NTLM (NT LanMan) を使用する場合、NTLM ではクライアントがサーバーを認証できないため、サービス ID はチェックされません。 NTLM はコンピューターが Windows ワークグループの一部である場合、または Kerberos 認証をサポートしていない古いバージョンの Windows が実行されている場合に使用されます。  
+  
+ サービスに対してメッセージを送信するためにクライアントがセキュリティで保護されたチャネルを開始すると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] インフラストラクチャはこのサービスを認証し、サービス ID がクライアントの使用するエンドポイント アドレスに指定された ID と一致する場合にのみメッセージを送信します。  
+  
+ ID の処理は、次の&2; 段階から成ります。  
+  
+-   デザイン時に、クライアント開発者は、(WSDL を通じて公開される) エンドポイントのメタデータでサービスの ID を確認します。  
+  
+-   実行時に、クライアント アプリケーションは、メッセージをサービスに送信する前に、サービスのセキュリティ資格情報のクレームを確認します。  
+  
+ クライアントでの ID の処理は、サービスでのクライアント認証と似ています。 セキュリティで保護されたサービスは、クライアントの資格情報が認証されるまでコードを実行しません。 同様に、クライアントは、サービスのメタデータによって事前に認識されている内容に基づいて、サービスの資格情報が認証されるまでメッセージを送信しません。  
+  
+ <xref:System.ServiceModel.EndpointAddress.Identity%2A>のプロパティ、 <xref:System.ServiceModel.EndpointAddress>クラスは、クライアントによって呼び出されるサービスの id を表します。 サービスが公開、 <xref:System.ServiceModel.EndpointAddress.Identity%2A>のメタデータ。 クライアントの開発者が実行されるとき、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) 、生成された構成が、サービスの値を格納するサービスのエンドポイントに対して<xref:System.ServiceModel.EndpointAddress.Identity%2A>プロパティです。 (セキュリティが構成されている場合) [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、サービスが指定された ID を所有しているかどうかを検査します。  
+  
+> [!IMPORTANT]
+>  メタデータには、サービスに要求される ID が含まれています。したがって、安全な方法 (サービスの HTTPS エンドポイントを作成するなど) でサービス メタデータを公開することをお勧めします。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法: メタデータ エンドポイントをセキュリティで保護された](../../../../docs/framework/wcf/feature-details/how-to-secure-metadata-endpoints.md)します。  
+  
+## <a name="identity-types"></a>ID の種類  
+ サービスが提供できる ID は&5; 種類あります。 ID の各種類は、構成内の `<identity>` 要素に含めることのできる要素に対応します。 使用する ID の種類は、シナリオとサービスのセキュリティ要件によって異なります。 ID の各種類の説明を次の表に示します。  
+  
+|ID の種類|説明|一般的なシナリオ|  
+|-------------------|-----------------|----------------------|  
+|ドメイン ネーム システム (DNS)|この要素は X.509 証明書または Windows アカウントと一緒に使用します。 資格情報に指定されている DNS 名とこの要素で指定されている値とが比較されます。|DNS チェックを行うことにより、DNS 名またはサブジェクト名を含む証明書を使用できます。 同じ DNS 名またはサブジェクト名を使用して証明書が再発行された場合、ID 検査は引き続き有効になります。 証明書を再発行すると、新しい RSA キーが取得されますが、同じ DNS 名またはサブジェクト名が保持されます。 つまり、クライアントはサービスの ID 情報を更新する必要がありません。|  
+|証明書。 `ClientCredentialType` が Certificate に設定されている場合の既定値です。|この要素は、クライアントと比較するための Base64 でエンコードされた X.509 証明書の値を指定します。<br /><br /> サービスを認証するときの資格情報として [!INCLUDE[infocard](../../../../includes/infocard-md.md)] を使用する場合にも、この要素が使用されます。|この要素は、証明書の拇印の値に基づいて、認証を&1; つの証明書に制限します。 拇印の値は一意であるため、この制限によってより厳密な認証が可能になります。 同じサブジェクト名を使用して証明書が再発行された場合、証明書には新しい拇印が含まれることになるので注意が必要です。 つまり、新しい拇印が認識されていない場合、クライアントはサービスを検証できなくなります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]証明書の拇印を検索するを参照してください[方法: 証明書のサムプリントを取得](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)します。|  
+|証明書参照|前述の証明書オプションと同じです。 ただし、この要素を使用すると、証明書の名前と証明書を取得するストアの場所を指定できます。|前述の証明書のシナリオと同じです。<br /><br /> 利点は、証明書ストアの場所を変更できることです。|  
+|RSA|この要素は、クライアントと比較するための RSA キーの値を指定します。 これは証明書オプションに似ていますが、証明書の拇印を使用するのではなく、証明書の RSA キーを使用します。|RSA チェックを行うと、証明書の RSA キーに基づいて、単一の証明書に基づく認証に明確に制限できます。 これにより、RSA キーが変更された場合に既存のクライアントでサービスが使用できなくなるのと引き換えに、特定の RSA キーをより厳しく認証できます。|  
+|ユーザー プリンシパル名 (UPN)。 `ClientCredentialType` が Windows に設定されており、サービス プロセスがシステム アカウントのいずれかで実行されていない場合の既定値です。|この要素は、サービスを実行中の UPN を指定します。 Kerberos プロトコルと Id のセクションを参照して[認証サービスの Id をオーバーライドする](../../../../docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md)です。|この設定では、サービスが特定の Windows ユーザー アカウントで実行されていることを確認します。 このユーザー アカウントは、現在ログオンしているユーザーである場合もあれば、特定のユーザー アカウントで実行されているサービスである場合もあります。<br /><br /> サービスが Active Directory 環境のドメイン アカウントで実行されている場合、この設定では Windows Kerberos セキュリティを利用します。|  
+|サービス プリンシパル名 (SPN)。 `ClientCredentialType` が Windows に設定されており、サービス プロセスがシステム アカウント (LocalService、LocalSystem、または NetworkService) のいずれかで実行されている場合の既定値です。|この要素は、サービスのアカウントに関連付けられている SPN を指定します。 Kerberos プロトコルと Id のセクションを参照して[認証サービスの Id をオーバーライドする](../../../../docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md)です。|これにより、SPN と SPN に関連付けられた特定の Windows アカウントによってサービスが識別されます。<br /><br /> Setspn.exe ツールを使用すると、サービスのユーザー アカウントに対してコンピューター アカウントを関連付けることができます。<br /><br /> サービスがシステム アカウントのいずれか、または SPN 名に関連付けられたドメイン アカウントで実行されており、コンピューターが Active Directory 環境のドメインのメンバーである場合、この設定では Windows Kerberos セキュリティを利用します。|  
+  
+## <a name="specifying-identity-at-the-service"></a>サービスでの ID の指定  
+ クライアント資格情報の種類を選択すると、サービス メタデータで公開される ID の種類が指定されるため、通常、サービスで ID を設定する必要はありません。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]オーバーライドまたはを指定する方法のサービスの id を参照してください[認証サービスの Id をオーバーライドする](../../../../docs/framework/wcf/extending/overriding-the-identity-of-a-service-for-authentication.md)です。  
+  
+## <a name="using-the-identity-element-in-configuration"></a>使用して、 <> \>構成内の要素  
+ 上記の例で示したバインディングのクライアント資格情報の種類を `Certificate,` に変更すると、次のコードに示すように、生成される WSDL には、Base64 でシリアル化された、ID 値用の X.509 証明書が含まれます。 これは、Windows 以外のすべてのクライアント資格情報の種類の既定値です。  
+  
+  
+  
+ 既定のサービス id の値を変更またはを使用して、id の種類を変更することができます、`<identity>`要素の構成またはコードで id を設定します。 値 `contoso.com` を使用してドメイン ネーム システム (DNS) ID を設定する構成コードを次に示します。  
+  
+  
+  
+## <a name="setting-identity-programmatically"></a>プログラムによる ID の設定  
+ ID は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって自動的に決定されるため、サービスで ID を明示的に指定する必要はありません。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、必要に応じてエンドポイントの ID を指定できます。 特定の DNS ID を持つ新しいサービス エンドポイントを追加するコードを次に示します。  
+  
+ [!code-csharp[C_Identity#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_identity/cs/source.cs#5)]
+ [!code-vb[C_Identity#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_identity/vb/source.vb#5)]  
+  
+## <a name="specifying-identity-at-the-client"></a>クライアントでの ID の指定  
+ デザイン時に、クライアント開発者が通常使用して、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)クライアント構成を生成します。 生成された構成ファイル (クライアントが使用するもの) には、サービスの ID が含まれます。 たとえば、次のコードは、前の例で示した DNS ID を指定するサービスから生成されたものです。 クライアントのエンドポイント ID 値が、サービスのエンドポイント ID 値と一致していることに注意してください。 この場合、クライアントは、サービスの Windows (Kerberos) 資格情報を受け取るときに、この値が `contoso.com` であることを要求します。  
+  
+  
+  
+ サービスでクライアント資格情報の種類として Windows ではなく証明書を指定した場合は、証明書の DNS プロパティの値が `contoso.com` であることが要求されます  (DNS プロパティが `null` の場合は、証明書のサブジェクト名が `contoso.com` である必要があります)。  
+  
+#### <a name="using-a-specific-value-for-identity"></a>ID の特定の値の使用  
+ 次のクライアント構成ファイルは、サービスの ID に特定の値を要求する方法を示しています。 次の例では、クライアントは&2; つのエンドポイントと通信できます。 1 つ目のエンドポイントは証明書の拇印で識別され、もう&1; つは証明書の RSA キーで識別されます。 つまり、公開キーと秘密キーのペアだけが含まれた証明書ですが、この証明書は信頼された証明機関によって発行されたものではありません。  
+  
+  
+  
+## <a name="identity-checking-at-run-time"></a>実行時の ID 検査  
+ デザイン時には、クライアント開発者はサービスのメタデータで ID を確認します。 実行時には、サービスのエンドポイントを呼び出す前に ID 検査が実行されます。  
+  
+ ID 値は、メタデータで指定された認証の種類 (つまり、サービスで使用される資格情報の種類) に関連付けられています。  
+  
+ 認証に X.509 証明書を使用するメッセージ レベルまたはトランスポート レベルの SSL (Secure Sockets Layer) を使用して認証を行うようにチャネルが構成されている場合、次の ID 値が有効になります。  
+  
+-   DNS。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SSL ハンドシェイク中に提示された証明書に、クライアントの DNS ID に指定された値と等価の DNS または `CommonName` (CN) 属性が含まれているかどうかを確認します。 この検査は、サーバー証明書の有効性の確認とは別に行われます。 既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、サーバー証明書が信頼されたルート証明機関によって発行されたものかどうかを検証します。  
+  
+-   証明書。 SSL ハンドシェイク中に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ID に指定された証明書の値が、リモート エンドポイントによって間違いなく提示されているかどうかを確認します。  
+  
+-   証明書参照。 証明書と同じです。  
+  
+-   RSA。 SSL ハンドシェイク中に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ID に指定された RSA キーの値が、リモート エンドポイントによって間違いなく提示されているかどうかを確認します。  
+  
+ サービスが認証に Windows 資格情報を使用するメッセージ レベルまたはトランスポート レベル SSL の認証を行い、資格情報をネゴシエートする場合、次の ID 値が有効になります。  
+  
+-   DNS。 ネゴシエーションでは、DNS 名を確認できるように、サービスの SPN が渡されます。 SPN の形式は `host/<dns name>` です。  
+  
+-   SPN。 サービスの明示的な SPN (例 : `host/myservice`) が返されます。  
+  
+-   UPN。 サービス アカウントの UPN です。 フォームでの UPN は`username` @`domain`します。 たとえば、サービスがユーザー アカウントで実行されている場合、UPN は `username@contoso.com` のようになります。  
+  
+ プログラムによる id の指定 (を使用して、 <xref:System.ServiceModel.EndpointAddress.Identity%2A>プロパティ) は省略可能です。 ID が指定されておらず、クライアント資格情報の種類が Windows の場合、既定値は、先頭に "host/" リテラルが付加されたサービス エンドポイント アドレスのホスト名の部分に値が設定された SPN になります。 ID が指定されておらず、クライアント資格情報の種類が証明書の場合、既定値は `Certificate` です。 これは、メッセージ レベルとトランスポート レベルの両方のセキュリティに適用されます。  
+  
+## <a name="identity-and-custom-bindings"></a>ID とカスタム バインディング  
+ サービスの ID は使用するバインディングの種類によって異なるため、カスタム バインディングの作成時には、適切な ID が公開されていることを確認する必要があります。 たとえば、次のコード例では、セキュリティで保護された通信のブートストラップ バインディングの ID と、エンドポイントのバインディングの ID が一致していないため、セキュリティの種類と適合しない ID が公開されます。 セキュリティで保護されたメッセージ交換のバインディングは、DNS id を設定中に、 <xref:System.ServiceModel.Channels.WindowsStreamSecurityBindingElement>は UPN または SPN id が設定されます。  
+  
+ [!code-csharp[C_Identity#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_identity/cs/source.cs#8)]
+ [!code-vb[C_Identity#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_identity/vb/source.vb#8)]  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]バインド要素をカスタム バインディングを正しくスタックする方法[ユーザー定義バインディング](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]使用してカスタム バインディングを作成する、 <xref:System.ServiceModel.Channels.SecurityBindingElement>を参照してください[方法: 指定の認証モード用の SecurityBindingElement を作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [方法: SecurityBindingElement を使用してカスタム バインディングを作成します。](../../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)   
+ [方法: 指定した認証モード用の SecurityBindingElement を作成](../../../../docs/framework/wcf/feature-details/how-to-create-a-securitybindingelement-for-a-specified-authentication-mode.md)   
+ [方法: カスタム クライアント Id 検証機能を作成します。](../../../../docs/framework/wcf/extending/how-to-create-a-custom-client-identity-verifier.md)   
+ [資格情報の種類を選択します。](../../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [ユーザー定義のバインディングを作成します。](../../../../docs/framework/wcf/extending/creating-user-defined-bindings.md)   
+ [方法: 証明書のサムプリントの取得](../../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/service-returns-arbitrary-data-using-the-wcf-web.md b/docs/framework/wcf/feature-details/service-returns-arbitrary-data-using-the-wcf-web.md
new file mode 100644
index 00000000000..6ad08984de0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/service-returns-arbitrary-data-using-the-wcf-web.md
@@ -0,0 +1,190 @@
+---
+title: "方法 : WCF Web HTTP プログラミング モデルを使用して任意のデータを返すサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0283955a-b4ae-458d-ad9e-6fbb6f529e3d
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : WCF Web HTTP プログラミング モデルを使用して任意のデータを返すサービスを作成する
+開発者は、データがサービス操作から返される流れを完全に制御する必要が生じることがあります。サービス操作が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではサポートされない形式でデータを返す必要がある場合がこれに当てはまります。このトピックでは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルを使用してこのようなサービスを作成する方法を説明します。ストリームを返す操作を 1 つ持つサービスを例に取ります。  
+  
+### サービス コントラクトを実装するには  
+  
+1.  サービス コントラクトを定義します。コントラクトは `IImageServer` と呼ばれ、<xref:System.IO.Stream> を返す `GetImage` というメソッドが入っています。  
+  
+    ```  
+    [ServiceContract]  
+        public interface IImageServer  
+        {  
+            [WebGet]  
+            Stream GetImage(int width, int height);  
+        }  
+    ```  
+  
+     このメソッドは <xref:System.IO.Stream> を戻すので、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はその操作がサービス操作から戻るデータを完全に制御できると想定し、戻されたデータにフォーマットを適用しません。  
+  
+2.  サービス コントラクトを実装します。コントラクトには 1 つの操作 \(`GetImage`\) しかありません。このメソッドはビットマップを生成して、それを <xref:System.IO.MemoryStream> に .jpg 形式で保存します。操作はそのストリームを呼び出し元に戻します。  
+  
+    ```  
+    public class Service : IImageServer  
+       {  
+           public Stream GetImage(int width, int height)  
+           {  
+               Bitmap bitmap = new Bitmap(width, height);  
+               for (int i = 0; i < bitmap.Width; i++)  
+               {  
+                   for (int j = 0; j < bitmap.Height; j++)  
+                   {  
+                       bitmap.SetPixel(i, j, (Math.Abs(i - j) < 2) ? Color.Blue : Color.Yellow);  
+                   }  
+               }  
+               MemoryStream ms = new MemoryStream();  
+               bitmap.Save(ms, System.Drawing.Imaging.ImageFormat.Jpeg);  
+               ms.Position = 0;  
+               WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";  
+               return ms;  
+           }  
+       }  
+    ```  
+  
+     コードの最後から 2 番目の行にある `WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";`  に注意してください。  
+  
+     これはコンテンツの種類のヘッダーを `“image/jpeg”` に設定します。この例では .jpg ファイルを戻す方法を示していますが、必要に応じて、任意の種類のデータを任意の形式で戻すように変更できます。操作はデータを生成または取得してそれをストリームに書き込む必要があります。  
+  
+### サービスをホストするには  
+  
+1.  コンソール アプリケーションを作成し、サービスをホストします。  
+  
+    ```  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+        }   
+    }  
+    ```  
+  
+2.  変数を作成し、`Main` メソッド内のサービスに使用するベース アドレスを保持します。  
+  
+    ```  
+    string baseAddress = "http://" + Environment.MachineName + ":8000/Service";  
+    ```  
+  
+3.  サービス クラスとベース アドレスを指定するサービスの <xref:System.ServiceModel.ServiceHost> インスタンスを作成します。  
+  
+    ```  
+    ServiceHost host = new ServiceHost(typeof(Service), new Uri(baseAddress));  
+  
+    ```  
+  
+4.  <xref:System.ServiceModel.WebHttpBinding> と <xref:System.ServiceModel.Description.WebHttpBehavior> を使用して、エンドポイントを追加します。  
+  
+    ```  
+    host.AddServiceEndpoint(typeof(IImageServer), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+  
+    ```  
+  
+5.  サービス ホストを開きます。  
+  
+    ```  
+    host.Open()  
+    ```  
+  
+6.  サービスを終了するためにユーザーが Enter キーを押すのを待ちます。  
+  
+    ```  
+    Console.WriteLine("Service is running");  
+    Console.Write("Press ENTER to close the host");  
+    Console.ReadLine();  
+    host.Close();  
+  
+    ```  
+  
+### Internet Explorer を使用して生のサービスを呼び出すには  
+  
+1.  サービスを実行します。サービスからの次の出力が表示されます。`Service is running Press ENTER to close the host`  
+  
+2.  Internet Explorer を開き「`http://localhost:8000/Service/GetImage?width=50&height=40`」と入力します。黄色い長方形とその中心を通る青い斜線が表示されます。  
+  
+## 使用例  
+ この例で使用されているコードの全容を次に示します。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Text;  
+using System.ServiceModel;  
+using System.ServiceModel.Web;  
+using System.ServiceModel.Description;  
+using System.IO;  
+using System.Drawing;  
+  
+namespace RawImageService  
+{  
+    // Define the service contract  
+    [ServiceContract]  
+    public interface IImageServer  
+    {  
+        [WebGet]  
+        Stream GetImage(int width, int height);  
+    }  
+  
+    // implement the service contract  
+    public class Service : IImageServer  
+    {  
+        public Stream GetImage(int width, int height)  
+        {  
+            // Although this method returns a jpeg, it can be  
+            // modified to return any data you want within the stream  
+            Bitmap bitmap = new Bitmap(width, height);  
+            for (int i = 0; i < bitmap.Width; i++)  
+            {  
+                for (int j = 0; j < bitmap.Height; j++)  
+                {  
+                    bitmap.SetPixel(i, j, (Math.Abs(i - j) < 2) ? Color.Blue : Color.Yellow);  
+                }  
+            }  
+            MemoryStream ms = new MemoryStream();  
+            bitmap.Save(ms, System.Drawing.Imaging.ImageFormat.Jpeg);  
+            ms.Position = 0;  
+            WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";  
+            return ms;  
+        }  
+    }  
+  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            string baseAddress = "http://" + Environment.MachineName + ":8000/Service";  
+            ServiceHost host = new ServiceHost(typeof(Service), new Uri(baseAddress));  
+            host.AddServiceEndpoint(typeof(IImageServer), new WebHttpBinding(), "").Behaviors.Add(new WebHttpBehavior());  
+            host.Open();  
+            Console.WriteLine("Service is running");  
+            Console.Write("Press ENTER to close the host");  
+            Console.ReadLine();  
+            host.Close();  
+  
+        }  
+    }  
+}  
+  
+```  
+  
+## コードのコンパイル  
+  
+-   コード例のコンパイル時には、System.ServiceModel.dll と System.ServiceModel.Web.dll を参照します。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md b/docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md
new file mode 100644
index 00000000000..1653cd2bc56
--- /dev/null
+++ b/docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md
@@ -0,0 +1,162 @@
+---
+title: "ServiceDescription と WSDL 参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eedc025d-abd9-46b1-bf3b-61d2d5c95fd6
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# ServiceDescription と WSDL 参照
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で行われる Web サービス記述言語 \(WSDL\) ドキュメントと <xref:System.ServiceModel.Description.ServiceDescription> インスタンスの間のマッピングについて説明します。  
+  
+## ServiceDescription から WSDL 1.1 へのマッピング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、サービスの <xref:System.ServiceModel.Description.ServiceDescription> インスタンスから WSDL ドキュメントをエクスポートできます。  WSDL ドキュメントは、メタデータ エンドポイントを公開したときに自動的にサービスに対して生成されます。  
+  
+ また、`WsdlImporter` 型を使用して、WSDL ドキュメントから <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンス、<xref:System.ServiceModel.Description.ContractDescription> インスタンス、および <xref:System.ServiceModel.Channels.Binding> インスタンスをインポートできます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってエクスポートされる WSDL ドキュメントは、外部の XML スキーマ ドキュメントから使用する XML スキーマ定義をインポートします。  データ型がサービスで使用するターゲット名前空間ごとに、個別の XML スキーマ ドキュメントがエクスポートされます。  同様に、サービス コントラクトが使用するターゲット名前空間ごとに、個別の WSDL ドキュメントがエクスポートされます。  
+  
+### ServiceDescription  
+ <xref:System.ServiceModel.Description.ServiceDescription> インスタンスは `wsdl:service` 要素にマップされます。  <xref:System.ServiceModel.Description.ServiceDescription> インスタンスは、それぞれが個別の `wsdl:port` 要素にマップされる <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスのコレクションを格納します。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|サービスの `wsdl:service`\/@name 値|  
+|`Namespace`|サービスの `wsdl:service` 定義の targetNamespace|  
+|`Endpoints`|サービスの `wsdl:port` 定義|  
+  
+### ServiceEndpoint  
+ <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスは `wsdl:port` 要素にマップされます。  <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスは、アドレス、バインディング、およびコントラクトを格納します。  
+  
+ <xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイスを実装するエンドポイント動作は、その動作が関連付けられているエンドポイントの `wsdl:port` 要素を変更できます。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|エンドポイントの `wsdl:port`\/@name 値およびエンドポイント バインディングの `wsdl:binding`\/@name 値|  
+|`Address`|エンドポイントの `wsdl:port` 定義のアドレス<br /><br /> アドレスの形式は、エンドポイントのトランスポートによって決まります。  たとえば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされるトランスポートの場合、SOAP アドレスまたはエンドポイント参照になります。|  
+|`Binding`|エンドポイントの `wsdl:binding` 定義<br /><br /> `wsdl:binding` 定義とは異なり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のバインディングはどのコントラクトにも関連付けられません。|  
+|`Contract`|エンドポイントの `wsdl:portType` 定義|  
+|`Behaviors`|<xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイスを実装するエンドポイント動作は、エンドポイントの `wsdl:port` を変更できます。|  
+  
+### バインディング  
+ `ServiceEndpoint` インスタンスのバインディング インスタンスは、`wsdl:binding` 定義にマップされます。  特定の `wsdl:portType` 定義に関連付ける必要がある `wsdl:binding` 定義とは異なり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のバインディングは、どのコントラクトにも依存しません。  
+  
+ バインディングは、バインド要素のコレクションで構成されます。  各要素は、エンドポイントがクライアントと通信する方法の一部分を記述します。  また、バインディングには、エンドポイントの <xref:System.ServiceModel.EnvelopeVersion> と <xref:System.ServiceModel.Channels.AddressingVersion> を示すための <xref:System.ServiceModel.Channels.MessageVersion> があります。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|エンドポイントの既定の名前で使用されます。この名前は、バインディング名にコントラクト名を追加し、アンダースコアで区切った形で表記されます。|  
+|`Namespace`|`wsdl:binding` 定義の `targetNamespace`。<br /><br /> インポートでは、WSDL ポートに関連付けられたポリシーがある場合、インポートされたバインディング名前空間は、`wsdl:port` 定義の `targetNamespace` にマップされます。|  
+|`BindingElementCollection` \(`CreateBindingElements`\(\) メソッドによって返されるプロパティとして\)|`wsdl:binding` 定義に対するさまざまなドメイン固有の拡張。通常は、ポリシー アサーション。|  
+|`MessageVersion`|エンドポイントの `EnvelopeVersion` および `AddressingVersion`。<br /><br /> `MessageVersion.None` が指定されている場合、WSDL バインディングは SOAP バインディングを格納せず、WSDL ポートは WS\-Addressing コンテンツを含みません。  この設定は、通常、Plain Old XML \(POX\) エンドポイントに対して使用されます。|  
+  
+#### BindingElements  
+ エンドポイント バインディングのバインド要素は、ポリシー アサーションなど、`wsdl:binding` のさまざまな WSDL 拡張にマップされます。  
+  
+ SOAP バインディングのトランスポート URI \(Uniform Resource Identifier\) は、バインディングの <xref:System.ServiceModel.Channels.TransportBindingElement> によって決まります。  
+  
+#### AddressingVersion  
+ バインディングの `AddressingVersion` は、`wsd:port` で使用されるアドレス指定のバージョンにマップされます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、SOAP 1.1 と SOAP 1.2 のアドレスおよび WS\-Addressing 08\/2004 と WS\-Addressing 1.0 のエンドポイント参照をサポートします。  
+  
+#### EnvelopeVersion  
+ バインディングの `EnvelopeVersion` は、`wsdl:binding` で使用される SOAP のバージョンにマップされます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、SOAP 1.1 と SOAP 1.2 のバインディングをサポートします。  
+  
+### コントラクト  
+ `ServiceEndpoint` インスタンスの <xref:System.ServiceModel.Description.ContractDescription> インスタンスは、`wsdl:portType` にマップされます。  `ContractDescription` インスタンスは、特定のコントラクトのすべての操作を記述します。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|コントラクトの `wsdl:portType`\/@name 値|  
+|`Namespace`|`wsdl:portType` 定義の targetNamespace|  
+|`SessionMode`|コントラクトの `wsdl:portType`\/@msc:usingSession 値。  この属性は、WSDL 1.1 用の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張です。|  
+|`Operations`|コントラクトの `wsdl:operation` 定義|  
+  
+### 操作  
+ <xref:System.ServiceModel.Description.OperationDescription> インスタンスは、`wsdl:portType`\/`wsdl:operation` にマップされます。  `OperationDescription` は、操作のメッセージを記述する `MessageDescription` インスタンスのコレクションを格納します。  
+  
+ 主に、2 つの操作動作 `DataContractSerializerOperationBehavior` および `XmlSerializerOperationBehavior` が、`OperationDescription` を WSDL ドキュメントにマップする方法に関与しています。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|操作の `wsdl:portType`\/`wsdl:operation`\/@name 値|  
+|`ProtectionLevel`|この操作の `wsdl:binding/wsdl:operation` メッセージに関連付けられたセキュリティ ポリシーの保護アサーション|  
+|`IsInitiating`|操作の `wsdl:portType`\/`wsdl:operation`\/@msc:isInitiating 値。  この属性は、WSDL 1.1 用の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張です。|  
+|`IsTerminating`|操作の `wsdl:portType`\/`wsdl:operation`\/@msc:isTerminating 値。  この属性は、WSDL 1.1 用の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張です。|  
+|`Messages`|操作の `wsdl:portType`\/`wsdl:operation`\/`wsdl:input` メッセージおよび `wsdl:portType`\/`wsdl:operation`\/`wsdl:output` メッセージ|  
+|`Faults`|操作の `wsdl:portType`\/`wsdl:operation`\/`wsdl:fault` 定義|  
+|`Behaviors`|`DataContractSerializerOperationBehavior` および `XmlSerializerOperationBehavior` は、操作バインディングおよび操作メッセージを扱います。|  
+  
+#### DataContractSerializerOperationBehavior  
+ 操作の `DataContractSerializerOperationBehavior` は、その操作の WSDL メッセージとバインディングをエクスポートする `IWsdlExportExtension` の実装です。  XML スキーマ型は、`XsdDataContractExporter` を使用してエクスポートされます。  また、`DataContractSerializerOperationBehavior` では、その操作に使用する使用方法、スタイル、およびスキーマ エクスポーターとインポーターを決定します。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`DataContractFormatAttribute`|この属性の `Style` プロパティは、操作の `wsdl:binding`\/`wsdl:operation`\/`soap:operation`\/@style 値にマップされます。<br /><br /> `DataContractSerializerOperationBehavior` は、WSDL のスキーマ型のリテラル使用だけをサポートします。|  
+  
+#### XmlSerializerOperationBehavior  
+ 操作の `XmlSerializerOperationBehavior` は、その操作の WSDL メッセージとバインディングをエクスポートする `IWsdlExportExtension` の実装です。  XML スキーマ型は、`XmlSchemaExporter` を使用してエクスポートされます。  また、`XmlSerializerOperationBehavior` では、その操作に使用する使用方法、スタイル、およびスキーマ エクスポーターとインポーターを決定します。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`XmlSerializerFormatAttribute`|この属性の `Style` プロパティは、操作の `wsdl:binding`\/`wsdl:operation`\/`soap:operation`\/@style 値にマップされます。<br /><br /> この属性の `Use` プロパティは、操作のすべてのメッセージについて、`wsdl:binding`\/`wsdl:operation`\/`soap:operation`\/\*\/@use 値にマップされます。|  
+  
+### \[メッセージ\]  
+ `MessageDescription` インスタンスは、操作の `wsdl:portType`\/`wsdl:operation`\/`wsdl:input` メッセージまたは `wsdl:portType`\/`wsdl:operation`\/`wsdl:output` メッセージによって参照される `wsdl:message` にマップされます。  `MessageDescription` には、本文とヘッダーがあります。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Action`|メッセージの SOAP アクションまたは WS\-Addressing アクション。<br /><br /> Action 文字列 "\*" を使用する操作は、WSDL では表示されません。|  
+|`Direction`|`MessageDirection.Input` は `wsdl:input` にマップされます。<br /><br /> `MessageDirection.Output` は `wsdl:output` にマップされます。|  
+|`ProtectionLevel`|このメッセージの `wsdl:message` 定義に関連付けられたセキュリティ ポリシーの保護アサーション|  
+|`Body`|メッセージのメッセージ本文|  
+|`Headers`|メッセージのヘッダー|  
+|`ContractDescription.Name`, `OperationContract.Name`|エクスポートするときに、`wsdl:message`\/@name 値を派生するために使用されます。|  
+  
+#### メッセージ本文  
+ `MessageBodyDescription` インスタンスは、メッセージ本文の `wsdl:message`\/`wsdl:part` 定義にマップされます。  メッセージ本文は、ラップされている場合とベアの場合があります。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`WrapperName`|スタイルが RPC 以外の場合、`WrapperName` は、@name が "parameters" に設定された `wsdl:message`\/`wsdl:part` によって参照される要素名にマップされます。|  
+|`WrapperNamespace`|スタイルが RPC 以外の場合、`WrapperNamespace` は、@name が "parameters" に設定された `wsdl:message`\/`wsdl:part` の要素の名前空間にマップされます。|  
+|`Parts`|このメッセージ本文のメッセージ部分|  
+|`ReturnValue`|ラッパー要素が存在する場合 \(ドキュメント ラップ スタイルまたは RPC スタイル\)、そのラッパー要素の子要素。存在しない場合、メッセージに最初に現れる `wsdl:message`\/`wsdl:part`。|  
+  
+#### メッセージ部分  
+ `MessagePartDescription` インスタンスは、`wsdl:message`\/`wsdl:part` およびメッセージ部分が指す XML スキーマ型または要素にマップされます。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|メッセージ部分の `wsd:message`\/`wsdl:part`\/@name 値およびメッセージ部分が指す要素の名前|  
+|`Namespace`|メッセージ部分が指す要素の名前空間|  
+|`Index`|メッセージの `wsdl:message`\/`wsdl:part` のインデックス|  
+|`ProtectionLevel`|このメッセージ部分の `wsdl:message` 定義に関連付けられたセキュリティ ポリシーの保護アサーション。  ポリシーは、特定のメッセージ部分を指すためにパラメーター化されます。|  
+|`MessageType`|メッセージ部分が指す要素の XML スキーマ型|  
+  
+#### メッセージ ヘッダー  
+ `MessageHeaderDescription` インスタンスは、メッセージ部分の `soap:header` バインディングにもマップされるメッセージ部分です。  
+  
+### エラー  
+ `FaultDescription` インスタンスは、`wsdl:portType`\/`wsdl:operation`\/`wsdl:fault` 定義およびその関連する `wsdl:message` 定義にマップされます。  `wsdl:message` は、関連する WSDL ポートの種類と同じターゲット名前空間に追加されます。  `wsdl:message` には、`FaultDescription` インスタンスの `DefaultType` プロパティ値に相当する XML スキーマ要素を指す、"detail" という名前の 1 つのメッセージ部分があります。  
+  
+|プロパティ|WSDL マッピング|  
+|-----------|----------------|  
+|`Name`|エラーの `wsdl:portType`\/`wsdl:operation`\/`wsdl:fault`\/@name 値|  
+|`Namespace`|エラー詳細メッセージ部分が指す XML スキーマ要素の名前空間|  
+|`Action`|エラーの SOAP アクションまたは WS\-Addressing アクション|  
+|`ProtectionLevel`|このエラーの `wsdl:message` 定義に関連付けられたセキュリティ ポリシーの保護アサーション|  
+|`DetailType`|詳細メッセージ部分が指す要素の XML スキーマ型|  
+|`Name, ContractDescription.Name, OperationDescription.Name,`|エラー メッセージの `wsdl:message`\/@name 値を派生するために使用されます。|  
+  
+## 参照  
+ <xref:System.ServiceModel.Description>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/servicemodel-attributes-and-servicedescription-reference.md b/docs/framework/wcf/feature-details/servicemodel-attributes-and-servicedescription-reference.md
new file mode 100644
index 00000000000..3fee066332b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/servicemodel-attributes-and-servicedescription-reference.md
@@ -0,0 +1,124 @@
+---
+title: "ServiceModel 属性および ServiceDescription 参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ab86b17-eab9-4846-a881-0099f9a7cc64
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# ServiceModel 属性および ServiceDescription 参照
+*"説明ツリー"* は、サービスのすべての側面をまとめて示す \(<xref:System.ServiceModel.Description.ServiceDescription?displayProperty=fullName> クラスで始まる\) 型の階層です。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、説明ツリーを使用して、有効なサービス ランタイムの構築、Web サービス記述言語 \(WSDL: Web Services Description Language\)、XML スキーマ定義言語 \(XSD: XML Schema Definition language\)、およびクライアントが接続して使用できるサービスに関するポリシー アサーション \(メタデータ\) の公開、説明ツリーの値を表すさまざまなコードと構成ファイルの生成を行います。  
+  
+ ここでは、サービス コントラクトからコントラクトに関連するプロパティが取得されるしくみ、およびこれらのプロパティが実装され、説明ツリーに追加されるしくみについて説明します。属性値が動作プロパティに変換された後、動作が説明ツリーに挿入される場合もあります。説明ツリーの値がメタデータに変換されるしくみ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ServiceDescription と WSDL 参照](../../../../docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md)」を参照してください。  
+  
+## 説明ツリーへの操作のマッピング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでは、サービス コントラクトが、属性を使用してインターフェイスまたはクラスとそのメソッドを操作のグループとしてマークするインターフェイス \(またはクラス\) によってモデル化されます。<xref:System.ServiceModel.ServiceHost> クラスを開くと、サービス コントラクトと実装が構成情報に反映され、構成情報とマージされて、説明ツリーに挿入されます。  
+  
+ 操作モデルには、*"パラメーター"* モデルと *"メッセージ コントラクト"* モデルの 2 種類があります。パラメーター モデルでは、<xref:System.ServiceModel.MessageContractAttribute?displayProperty=fullName> クラスによってマークされたパラメーターまたは戻り値の型を持たないマネージ メソッドを使用します。このモデルでは、開発者がパラメーターと戻り値のシリアル化を制御しますが、サービスとそのコントラクトの説明ツリーの設定に使用する値は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって生成されます。  
+  
+ 構成ファイルで指定されたバインディングは、<xref:System.ServiceModel.Description.ServiceEndpoint.Binding%2A?displayProperty=fullName> プロパティに直接読み込まれます。  
+  
+|ServiceBehaviorAttribute プロパティ|影響を受ける説明ツリーの値|  
+|------------------------------------|-------------------|  
+|Name|<xref:System.ServiceModel.Description.ServiceDescription.Name%2A>|  
+|Namespace|<xref:System.ServiceModel.Description.ServiceDescription.Namespace%2A>|  
+|ConfigurationName|<xref:System.ServiceModel.Description.ServiceDescription.ConfigurationName%2A>|  
+|IgnoreExtensionDataObject|すべての操作の <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.IgnoreExtensionDataObject%2A> プロパティを設定します。|  
+|MaxItemsInObjectGraph|すべての操作の <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior.MaxItemsInObjectGraph%2A> プロパティを設定します。|  
+  
+|ServiceContractAttribute プロパティ|影響を受ける説明ツリーの値|  
+|------------------------------------|-------------------|  
+|CallbackContract|すべての操作の <xref:System.ServiceModel.Description.OperationDescription.Messages%2A> に追加される <xref:System.ServiceModel.Description.ContractDescription.CallbackContractType%2A>、<xref:System.ServiceModel.Description.MessageDescription>|  
+|ConfigurationName|<xref:System.ServiceModel.Description.ContractDescription.ConfigurationName%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.ContractDescription.ProtectionLevel%2A> と、場合によっては子の保護レベル。保護レベルの階層[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[保護レベルの理解](../../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。|  
+|SessionMode|<xref:System.ServiceModel.Description.ContractDescription.SessionMode%2A>|  
+  
+|ServiceKnownTypesAttribute 値|影響を受ける説明ツリーの値|  
+|----------------------------------|-------------------|  
+|MethodName|<xref:System.ServiceModel.Description.OperationDescription.KnownTypes%2A>|  
+  
+|OperationContractAttribute 値|影響を受ける説明ツリーの値|  
+|----------------------------------|-------------------|  
+|Action|出力メッセージまたは入力メッセージの <xref:System.ServiceModel.Description.MessageDescription.Action%2A>。コントラクトまたはコールバック コントラクトによって異なります。|  
+|AsyncPattern|true の場合は、<xref:System.ServiceModel.Description.OperationDescription.BeginMethod%2A> と <xref:System.ServiceModel.Description.OperationDescription.EndMethod%2A>|  
+|IsOneWay|<xref:System.ServiceModel.Description.OperationDescription.Messages%2A> の 1 つの <xref:System.ServiceModel.Description.MessageDescription> にマップします。|  
+|IsInitiating|<xref:System.ServiceModel.Description.OperationDescription.IsInitiating%2A>|  
+|IsTerminating|<xref:System.ServiceModel.Description.OperationDescription.IsTerminating%2A>|  
+|名前|<xref:System.ServiceModel.Description.OperationDescription.Name%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.OperationDescription.ProtectionLevel%2A> と、場合によっては子の保護レベル。保護レベルの階層[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[保護レベルの理解](../../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。|  
+|ReplyAction|出力メッセージまたは入力メッセージの <xref:System.ServiceModel.Description.MessageDescription.Action%2A>。コントラクトまたはコールバック コントラクトによって異なります。|  
+  
+|FaultContractAttribute 値|影響を受ける説明ツリーの値|  
+|------------------------------|-------------------|  
+|Action|<xref:System.ServiceModel.Description.FaultDescription.Action%2A>。コントラクトまたはコールバック コントラクトによって異なります。|  
+|DetailType|<xref:System.ServiceModel.Description.FaultDescription.DetailType%2A>|  
+|Name|<xref:System.ServiceModel.Description.FaultDescription.Name%2A>|  
+|Namespace|<xref:System.ServiceModel.Description.FaultDescription.Namespace%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.FaultDescription.ProtectionLevel%2A>|  
+  
+|DataContractFormatAttribute 値|影響を受ける説明ツリーの値|  
+|-----------------------------------|-------------------|  
+|Use|操作の <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> に <xref:System.ServiceModel.DataContractFormatAttribute.Style%2A> 値が設定されます。|  
+  
+|XmlSerializerFormatAttribute 値|影響を受ける説明ツリーの値|  
+|------------------------------------|-------------------|  
+|Style|操作の <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior> に、この <xref:System.ServiceModel.XmlSerializerFormatAttribute> プロパティが設定されます。|  
+|Use|操作の <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior> に、<xref:System.ServiceModel.XmlSerializerFormatAttribute> が設定されます。|  
+  
+|TransactionFlowAttribute 値|影響を受ける説明ツリーの値|  
+|--------------------------------|-------------------|  
+|TransactionFlowOption|<xref:System.ServiceModel.TransactionFlowAttribute> が <xref:System.ServiceModel.Description.OperationDescription.Behaviors%2A> プロパティに操作の動作として追加されます。|  
+  
+|MessageContractAttribute 値|影響を受ける説明ツリーの値|  
+|--------------------------------|-------------------|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.MessageDescription.ProtectionLevel%2A>|  
+|WrapperName|<xref:System.ServiceModel.Description.MessageBodyDescription.WrapperName%2A>|  
+|WrapperNamespace|<xref:System.ServiceModel.Description.MessageBodyDescription.WrapperNamespace%2A>|  
+  
+|MessageHeaderAttribute 値|影響を受ける説明ツリーの値|  
+|------------------------------|-------------------|  
+|Actor|<xref:System.ServiceModel.Description.MessageHeaderDescription.Actor%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+|MustUnderstand|<xref:System.ServiceModel.Description.MessageHeaderDescription.MustUnderstand%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+|Name|<xref:System.ServiceModel.Description.MessagePartDescription.Name%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+|Namespace|<xref:System.ServiceModel.Description.MessagePartDescription.Namespace%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.MessagePartDescription.ProtectionLevel%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+|Relay|<xref:System.ServiceModel.Description.MessageHeaderDescription.Relay%2A> 内の対応するヘッダーの<xref:System.ServiceModel.Description.MessageDescription.Headers%2A>|  
+  
+|MessageBodyMemberAttribute 値|影響を受ける説明ツリーの値|  
+|----------------------------------|-------------------|  
+|Name|<xref:System.ServiceModel.Description.MessagePartDescription.Name%2A> 内の対応する部分の<xref:System.ServiceModel.Description.MessageBodyDescription.Parts%2A>|  
+|Namespace|<xref:System.ServiceModel.Description.MessagePartDescription.Namespace%2A> 内の対応する部分の<xref:System.ServiceModel.Description.MessageBodyDescription.Parts%2A>|  
+|Order|<xref:System.ServiceModel.Description.MessagePartDescription.Index%2A> 内の対応する部分の<xref:System.ServiceModel.Description.MessageBodyDescription.Parts%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.MessagePartDescription.ProtectionLevel%2A> 内の対応する部分の<xref:System.ServiceModel.Description.MessageBodyDescription.Parts%2A>|  
+  
+|MessageHeaderArrayAttribute 値|影響を受ける説明ツリーの値|  
+|-----------------------------------|-------------------|  
+|Actor|<xref:System.ServiceModel.Description.MessageHeaderDescription.Actor%2A>|  
+|MustUnderstand|<xref:System.ServiceModel.Description.MessageHeaderDescription.MustUnderstand%2A>|  
+|Name|<xref:System.ServiceModel.Description.MessagePartDescription.Name%2A>|  
+|名前空間|<xref:System.ServiceModel.Description.MessagePartDescription.Namespace%2A>|  
+|ProtectionLevel|<xref:System.ServiceModel.Description.MessagePartDescription.ProtectionLevel%2A>|  
+|Relay|<xref:System.ServiceModel.Description.MessageHeaderDescription.Relay%2A>|  
+  
+|MessagePropertyAttribute 値|影響を受ける説明ツリーの値|  
+|--------------------------------|-------------------|  
+|Name|<xref:System.ServiceModel.Description.MessagePartDescription.Name%2A>|  
+  
+|MessageParameterAttribute 値|影響を受ける説明ツリーの値|  
+|---------------------------------|-------------------|  
+|Name|<xref:System.ServiceModel.Description.MessagePartDescription.name%2A> 内の対応する部分の<xref:System.ServiceModel.Description.MessageBodyDescription.Parts%2A>|  
+  
+ 説明ツリーの値がメタデータに変換されるしくみ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ServiceDescription と WSDL 参照](../../../../docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md)」を参照してください。  
+  
+## 参照  
+ [ServiceDescription と WSDL 参照](../../../../docs/framework/wcf/feature-details/servicedescription-and-wsdl-reference.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md b/docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md
new file mode 100644
index 00000000000..88587aa86fc
--- /dev/null
+++ b/docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md
@@ -0,0 +1,61 @@
+---
+title: "ServiceModel トランザクションの属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランザクション [WCF], ServiceModel の属性"
+ms.assetid: 1e0d2436-6ae5-439b-9765-a448d6f60000
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# ServiceModel トランザクションの属性
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのトランザクションの動作を構成できる次の 3 つの標準的な <xref:System.ServiceModel> 属性のプロパティが用意されています。  
+  
+-   <xref:System.ServiceModel.TransactionFlowAttribute>  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute>  
+  
+-   <xref:System.ServiceModel.OperationBehaviorAttribute>  
+  
+## TransactionFlowAttribute  
+ <xref:System.ServiceModel.TransactionFlowAttribute> 属性は、クライアントから受信トランザクションを受け入れるときのサービス コントラクトにおける操作の受け入れやすさを指定します。この属性は、次のプロパティを使用してこの制御を行います。トランザクションは、<xref:System.ServiceModel.TransactionFlowOption> 列挙型を使用して、受信トランザクションが <xref:System.ServiceModel.TransactionFlowOption>、<xref:System.ServiceModel.TransactionFlowOption>、<xref:System.ServiceModel.TransactionFlowOption> のいずれであるかを指定します。  
+  
+ これは、サービス操作をクライアントの外部とのやり取りに関連付ける唯一の属性です。次のセクションで説明する属性は、操作の実行内部におけるトランザクションの使用と関連しています。  
+  
+## ServiceBehaviorAttribute  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性は、サービス コントラクト実装の内部実行動作を指定します。この属性のトランザクション固有のプロパティは次のとおりです。  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionAutoCompleteOnSessionClose%2A> は、セッションの終了時に、未完了のトランザクションを完了させるかどうかを指定します。このプロパティの既定値は `false` です。このプロパティが `true` で、ネットワークまたはクライアントの障害が原因で、入力セッションが終了せずにシャットダウンした場合は、すべての未完了のトランザクションが正常に完了します。このプロパティが `false` の場合、またはセッションが正常に終了しなかった場合は、セッションの終了時にすべての未完了のトランザクションがロールバックされます。このプロパティを `true` に設定する場合、受信チャネルはセッション ベースである必要があります。  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A> は、トランザクションが完了したときに基になるサービス インスタンスを解放するかどうかを指定します。このプロパティの既定値は `true` です。次の受信メッセージによって、基になる新しいインスタンスが作成されると、以前のインスタンスが保持していたトランザクションごとの状態は破棄されます。サービス インスタンスの解放はサービスが実行する内部動作であるため、クライアントが確立した既存の接続またはセッションに影響を及ぼすことはありません。この機能は、COM\+ に用意された Just\-In\-Time アクティベーション機能に相当します。このプロパティが `true` の場合は、<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> と <xref:System.ServiceModel.ConcurrencyMode> を一致させる必要があります。そうでない場合、サービスの起動中に無効な構成の検証例外がスローされます。  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionIsolationLevel%2A> は、サービスのトランザクションで使用する分離レベルを指定します。このプロパティは、<xref:System.Transactions.IsolationLevel> の値のいずれかに設定されます。ローカルの分離レベル プロパティが、<xref:System.Transactions.IsolationLevel> 以外に設定されている場合は、受信トランザクションの分離レベルをこのローカルのプロパティの設定に一致させる必要があります。そうでない場合、受信トランザクションは拒否され、クライアントにエラーが返されます。<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> が `true` であり、トランザクションがフローしていない場合、このプロパティによって、ローカルで作成されるトランザクションに使用する <xref:System.Transactions.IsolationLevel> の値が決まります。<xref:System.Transactions.IsolationLevel> が <xref:System.Transactions.IsolationLevel> に設定されている場合は、<xref:System.Transactions.IsolationLevel><xref:System.Transactions.IsolationLevel> が使用されます。  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionTimeout%2A> は、サービスで作成された新しいトランザクションを完了させる期間を指定します。この期間が過ぎてもトランザクションが完了しない場合は、トランザクションは中止されます。<xref:System.TimeSpan> は、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> が `true` に設定された任意の操作、および新しいトランザクションが作成された任意の操作の <xref:System.Transactions.TransactionScope> タイムアウトとして使用されます。このタイムアウトは、2 フェーズ コミット プロトコルにおいて、トランザクションが作成されてからフェーズ 1 が完了するまでの最大許容時間です。使用されるタイムアウト値は、<xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionTimeout%2A> プロパティと `transactionTimeout` 構成設定のうち、常に小さい方の値になります。  
+  
+## OperationBehaviorAttribute  
+ <xref:System.ServiceModel.OperationBehaviorAttribute> 属性は、サービス実装におけるメソッドの動作を指定します。この属性を使用して、操作の特定の実行動作を示すことができます。この属性のプロパティは、サービス コントラクトの Web サービス記述言語 \(WSDL: Web Service Description Language\) 記述には影響しません。また、このプロパティがない場合に開発者が実装する必要のある共通の機能を有効にする、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プログラミング モデルの要素にすぎません。  
+  
+ この属性には、次のようなトランザクション固有のプロパティがあります。  
+  
+-   <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> は、メソッドをアクティブなトランザクション スコープ内で実行する必要があるかどうかを指定します。既定値は `false` です。<xref:System.ServiceModel.OperationBehaviorAttribute> 属性がメソッドに対して設定されていない場合は、そのメソッドがトランザクション内で実行されないことを意味します。操作のトランザクション スコープが要求されない場合、メッセージ ヘッダーにあるトランザクションはアクティブ化されず、<xref:System.ServiceModel.OperationContext> の <xref:System.ServiceModel.OperationContext.IncomingMessageProperties%2A> の要素として残ります。操作のトランザクション スコープが必要な場合は、トランザクションのソースは次のいずれかから派生します。  
+  
+    -   トランザクションがクライアントからフローされた場合、その分散トランザクションを使用して作成されたトランザクション スコープの下でメソッドが実行されます。  
+  
+    -   キューに置かれたトランスポートでは、メッセージをキューから削除するトランザクションが使用されます。使用されるトランザクションはフローされたトランザクションではなく、したがってメッセージの送信元によって提供されたものではないことに注意してください。  
+  
+    -   カスタム トランスポートは、`TransportTransactionProperty` を使用することによってトランザクションを提供できます。  
+  
+    -   上記のいずれもがトランザクションの外部ソースを提供しない場合は、メソッドの呼び出しの直前に新規の <xref:System.Transactions.Transaction> インスタンスが作成されます。  
+  
+-   <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> は、未処理の例外がスローされなかった場合に、メソッドが実行されているトランザクションが自動的に完了されるかどうかを指定します。このプロパティが `true` の場合は、ユーザー メソッドが例外をスローせずに復帰したときに、呼び出し側のインフラストラクチャが自動的にそのトランザクションを "完了" としてマークします。このプロパティが `false` の場合、トランザクションはインスタンスにアタッチされ、このプロパティが `true` とマークされた後続のメソッドがクライアントによって呼び出されるか、または後続のメソッドから <xref:System.ServiceModel.OperationContext.SetTransactionComplete%2A> が明示的に呼び出された場合にのみ、"完了" とマークされます。<xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionAutoCompleteOnSessionClose%2A> プロパティを `true` に設定しない限り、これらのどちらの実行に失敗しても、トランザクションは "完了" にならなくなり、格納されている作業はコミットされません。このプロパティが `true` に設定されている場合、セッションのあるチャネルを使用し、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> を <xref:System.ServiceModel.InstanceContextMode> に設定する必要があります。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md b/docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md
new file mode 100644
index 00000000000..be46c2fc772
--- /dev/null
+++ b/docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md
@@ -0,0 +1,74 @@
+---
+title: "ServiceModel トランザクションの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランザクション [WCF], ServiceModel 構成"
+ms.assetid: 5636067a-7fbd-4485-aaa2-8141c502acf3
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ServiceModel トランザクションの構成
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、サービスのトランザクションを構成するために、`transactionFlow`、`transactionProtocol`、および `transactionTimeout` という 3 つの属性が用意されています。  
+  
+## transactionFlow の構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されているほとんどの定義済みバインディングには、`transactionFlow` 属性と `transactionProtocol` 属性が含まれています。これらの属性を使用すると、特定のトランザクション フロー プロトコルを使用する特定のエンドポイントの受信トランザクションを受け入れるようにバインディングを構成できます。さらに、`transactionFlow` 要素とその `transactionProtocol` 属性を使用して、ユーザー独自のカスタム バインディングを構築できます。構成要素の設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[\<binding\>](../../../../docs/framework/misc/binding.md)」および「[WCF 構成スキーマ](../../../../docs/framework/configure-apps/file-schema/wcf/index.md)」を参照してください。  
+  
+ `transactionFlow` 属性は、バインディングを使用するサービス エンドポイントに対してトランザクション フローを有効にするかどうかを指定します。  
+  
+## transactionProtocol の構成  
+ `transactionProtocol` 属性は、バインディングを使用するサービス エンドポイントで使用されるトランザクション プロトコルを指定します。  
+  
+ 以下に、指定したバインディングがトランザクション フローをサポートし、WS\-AtomicTransaction プロトコルを使用するように構成する構成セクションの例を示します。  
+  
+```  
+<netNamedPipeBinding>  
+   <binding name="test"  
+      closeTimeout="00:00:10"  
+      openTimeout="00:00:20"   
+      receiveTimeout="00:00:30"  
+      sendTimeout="00:00:40"  
+      transactionFlow="true"  
+      transactionProtocol="WSAtomicTransactionOctober2004"  
+      hostNameComparisonMode="WeakWildcard"  
+      maxBufferSize="1001"  
+      maxConnections="123"   
+      maxReceivedMessageSize="1000">  
+   </binding>  
+</netNamedPipeBinding>  
+```  
+  
+## transactionTimeout の構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの `transactionTimeout` 属性は、構成ファイルの `behavior` 要素内で構成できます。次のコードでは、この設定方法について説明します。  
+  
+```  
+<configuration>  
+   <system.serviceModel>  
+      <behaviors>  
+         <behavior name="NewBehavior" transactionTimeout="00:01:00" /> <!-- 1 minute timeout -->  
+      </behaviors>  
+   </system.serviceModel>  
+</configuration>  
+```  
+  
+ `transactionTimeout` 属性は、サービスで作成された新しいトランザクションを完了させる期間を指定します。この属性は、新しいトランザクションを確立するすべての操作の <xref:System.Transactions.TransactionScope> タイムアウトとして使用され、<xref:System.ServiceModel.OperationBehaviorAttribute> が適用されている場合、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> プロパティは `true` に設定されます。  
+  
+ このタイムアウトは、2 フェーズ コミット プロトコルにおける、トランザクションの作成からフェーズ 1 の完了までの期間を指定します。  
+  
+ この属性を `service` 構成セクション内に設定する場合は、対応するサービスの 1 つ以上のメソッドで、<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> プロパティが `true` に設定された <xref:System.ServiceModel.OperationBehaviorAttribute> を適用する必要があります。  
+  
+ 使用されるタイムアウト値は常に、この `transactionTimeout` 構成設定と <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionTimeout%2A> プロパティの小さい方の値になります。  
+  
+## 参照  
+ [\<binding\>](../../../../docs/framework/misc/binding.md)   
+ [WCF 構成スキーマ](../../../../docs/framework/configure-apps/file-schema/wcf/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md b/docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md
new file mode 100644
index 00000000000..34ff28c99f5
--- /dev/null
+++ b/docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md
@@ -0,0 +1,124 @@
+---
+title: "セッション、インスタンス化、および同時実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 50797a3b-7678-44ed-8138-49ac1602f35b
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# セッション、インスタンス化、および同時実行
+*"セッション"* とは、2 つのエンドポイント間で送信されるすべてのメッセージを相互に関連付けたものです。*"インスタンス化"* とは、ユーザー定義のサービス オブジェクトとこれらのオブジェクトに関連する <xref:System.ServiceModel.InstanceContext> オブジェクトの有効期間を制御することです。 また、*同時実行*は、<xref:System.ServiceModel.InstanceContext> で同時に実行されるスレッドの数の制御を表す用語です。  
+  
+ ここでは、これらの設定とその使用方法、各設定間のさまざまな相互作用について説明します。  
+  
+## セッション  
+ サービス コントラクトによって <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName> プロパティが <xref:System.ServiceModel.SessionMode?displayProperty=fullName> に設定されている場合、すべての呼び出し \(つまり、呼び出しをサポートする、基になるメッセージ交換\) を同じメッセージ交換の一部にする必要があります。 セッションが許可されるが必須ではないコントラクトの場合、クライアントは、接続した後にセッションを確立できます。また、セッションを確立しないままにしておくこともできます。 セッションが終了したのに、同じセッション ベースのチャネルでメッセージが送信されると、例外がスローされます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションには、主に次のような概念的特徴があります。  
+  
+-   呼び出し側アプリケーションによって明示的に開始および終了される。  
+  
+-   セッション中に配信されたメッセージは、受信された順に処理される。  
+  
+-   セッションはメッセージのグループを相互に関連付けて通信を行う。 ここで "相互に関連付ける" は、抽象的な意味を持ちます。 たとえば、あるセッション ベースのチャネルでは、共有ネットワーク接続に基づいてメッセージが相互に関連付けられる一方、別のセッション ベースのチャネルでは、メッセージ本文にある共有タグに基づいてメッセージが相互に関連付けられます。 セッションから派生可能な機能は、相互関連付けの性質によって異なります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションに関連付けられた一般的なデータ ストアはありません。  
+  
+ <xref:System.Web.SessionState.HttpSessionState?displayProperty=fullName> アプリケーションの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] クラスに精通している場合は、この種のセッションと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションの間に次のような相違があることがわかります。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッションは、常にサーバーによって開始される。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッションは、暗黙的に順序付けされない。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッションは、要求全体について一般的なデータ ストレージ機構を提供する。  
+  
+ クライアント アプリケーションとサービス アプリケーションでは、異なる方法でセッションと対話します。 クライアント アプリケーションはセッションを開始し、セッション内で送信されてきたメッセージの受信と処理を行います。 サービス アプリケーションでは、動作を追加するための機能拡張ポイントとしてセッションを使用できます。 これは <xref:System.ServiceModel.InstanceContext> を直接操作する、またはカスタムのインスタンス コンテキスト プロバイダーを実装することで可能になります。  
+  
+## インスタンス化  
+ インスタンス化動作 \(<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティを使用して設定します\) は、受信メッセージに応答して <xref:System.ServiceModel.InstanceContext> を作成する方法を制御します。 既定では、各 <xref:System.ServiceModel.InstanceContext> は 1 つのユーザー定義サービス オブジェクトに関連付けられています。したがって、\(既定では\) <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティを設定することによってもユーザー定義サービス オブジェクトのインスタンス化を制御できます。 インスタンス化モードは <xref:System.ServiceModel.InstanceContextMode> 列挙体によって定義されます。  
+  
+ 次のインスタンス化モードを使用できます。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : 新しい <xref:System.ServiceModel.InstanceContext> \(およびサービス オブジェクト\) がクライアント要求ごとに作成されます。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : 新しい <xref:System.ServiceModel.InstanceContext> \(およびサービス オブジェクト\) が新しいクライアント セッションごとに作成され、そのセッションの有効期間中、保持されます \(ただし、セッションをサポートするバインディングが必要です\)。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : アプリケーションの有効期間中は、単一の <xref:System.ServiceModel.InstanceContext> \(およびサービス オブジェクト\) がすべてのクライアント要求を処理します。  
+  
+ 既定の <xref:System.ServiceModel.InstanceContextMode> 値 \(サービス クラスで明示的に設定された <xref:System.ServiceModel.InstanceContextMode>\) を次のコード例に示します。  
+  
+```  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]   
+public class CalculatorService : ICalculatorInstance   
+{   
+    ...  
+}  
+```  
+  
+ また、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティは <xref:System.ServiceModel.InstanceContext> の解放頻度を制御しますが、<xref:System.ServiceModel.OperationBehaviorAttribute.ReleaseInstanceMode%2A?displayProperty=fullName> プロパティと <xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A?displayProperty=fullName> プロパティはサービス オブジェクトの解放時期を制御します。  
+  
+### 既知のシングルトン サービス  
+ 単一インスタンス サービス オブジェクトの 1 つのバリエーションとして、サービス オブジェクトをユーザーが自分で作成し、このオブジェクトを使用してサービス ホストを作成すると有用な場合があります。 そのためには、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.InstanceContextMode> に設定するか、サービス ホストが開かれたときに例外をスローする必要があります。  
+  
+ このようなサービスを作成するには、[ServiceHost.ServiceHost\(Object, Uri\<xref:System.ServiceModel.ServiceHost.%23ctor%28System.Object%2CSystem.Uri%5B%5D%29?displayProperty=fullName> コンストラクターを使用します。 この方法は、シングルトン サービスが使用する特定のオブジェクト インスタンスを提供する場合に、カスタムの <xref:System.ServiceModel.Dispatcher.IInstanceContextInitializer?displayProperty=fullName> を実装する代わりに使用できます。 サービス実装の型を作成することが困難な場合 \(たとえば、既定のパラメーターなしのコンストラクターが作成されない場合\) は、このオーバーロードを使用できます。  
+  
+ オブジェクトをこのコンストラクターに指定すると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のインスタンス化動作に関するいくつかの機能が異なる動作をすることに注意してください。 たとえば、シングルトン オブジェクト インスタンスを指定しているときは、<xref:System.ServiceModel.InstanceContext.ReleaseServiceInstance%2A?displayProperty=fullName> を呼び出しても効果はありません。 他のインスタンス解放機構も、同様に無視されます。<xref:System.ServiceModel.ServiceHost> は常に、すべての操作について <xref:System.ServiceModel.OperationBehaviorAttribute.ReleaseInstanceMode%2A?displayProperty=fullName> プロパティが <xref:System.ServiceModel.ReleaseInstanceMode?displayProperty=fullName> に設定されているかのように動作します。  
+  
+### InstanceContext オブジェクトの共有  
+ ユーザーが自ら関連付けを行うことにより、どの <xref:System.ServiceModel.InstanceContext> オブジェクトに、どのセッションフル チャネルまたは呼び出しを関連付けるかを制御することもできます。  
+  
+## 同時実行  
+ 同時実行は、<xref:System.ServiceModel.InstanceContext> 内で同時にアクティブになるスレッドの数を制御します。 同時実行を制御するには、<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A?displayProperty=fullName> と <xref:System.ServiceModel.ConcurrencyMode> 列挙値を使用します。  
+  
+ 選択可能な同時実行モードは次の 3 つです。  
+  
+-   <xref:System.ServiceModel.ConcurrencyMode>: 各インスタンス コンテキストは、そのインスタンス コンテキスト内でメッセージを処理するスレッドを最大で一度に 1 つ持つことができます。 他のスレッドは、最初のスレッドがインスタンス コンテキストを使用し終えるまで、同じインスタンス コンテキストを使用できません。  
+  
+-   <xref:System.ServiceModel.ConcurrencyMode>: 各サービス インスタンスは、同時にメッセージを処理する複数のスレッドを持つことができます。 この同時実行モードを使用するには、サービスの実装がスレッドセーフである必要があります。  
+  
+-   <xref:System.ServiceModel.ConcurrencyMode> : 各サービス インスタンスは、一度に 1 つのメッセージを処理しますが、再入操作の呼び出しを受け入れます。 サービスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント オブジェクトを通じて呼び出しを行う場合のみ、この呼び出しを受け入れます。  
+  
+> [!NOTE]
+>  複数のスレッドを安全に使用するコードを理解し、適切に記述することが困難な場合もあります。<xref:System.ServiceModel.ConcurrencyMode> 値や <xref:System.ServiceModel.ConcurrencyMode> 値を使用する前に、これらのモード用にサービスが適切に設計されていることを確認してください。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A>。  
+  
+ 同時実行の使用は、インスタンス化モードに関連します。<xref:System.ServiceModel.InstanceContextMode>`` インスタンス化では、各メッセージが新しい <xref:System.ServiceModel.InstanceContext> によって処理され、<xref:System.ServiceModel.InstanceContext> で複数のスレッドがアクティブになることはないため、同時実行とは関連しません。  
+  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> プロパティを <xref:System.ServiceModel.ConcurrencyMode> に設定するコード例を次に示します。  
+  
+```  
+[ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Multiple, InstanceContextMode = InstanceContextMode.Single)]   
+public class CalculatorService : ICalculatorConcurrency   
+{   
+    ...  
+}  
+  
+```  
+  
+## InstanceContext 設定と対話するセッション  
+ セッションと <xref:System.ServiceModel.InstanceContext> は、コントラクト内の <xref:System.ServiceModel.SessionMode> 列挙値と、チャネルと特定のサービス オブジェクト間の関連付けを制御するサービス実装の <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティ値の組み合わせに応じて、相互に作用します。  
+  
+ サービスの <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName> プロパティと <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティの値の組み合わせが指定されているという条件で、セッションをサポートしている受信チャネルまたはサポートしていない受信チャネルの結果を次の表に示します。  
+  
+|InstanceContextMode 値|<xref:System.ServiceModel.SessionMode>|<xref:System.ServiceModel.SessionMode>|<xref:System.ServiceModel.SessionMode>|  
+|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|PerCall|-   セッションフル チャネルでの動作 : 呼び出しごとに 1 つのセッションと <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作: 例外がスローされます。|-   セッションフル チャネルでの動作 : 呼び出しごとに 1 つのセッションと <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作 : 呼び出しごとに 1 つの <xref:System.ServiceModel.InstanceContext>。|-   セッションフル チャネルでの動作: 例外がスローされます。<br />-   セッションレス チャネルでの動作 : 呼び出しごとに 1 つの <xref:System.ServiceModel.InstanceContext>。|  
+|PerSession|-   セッションフル チャネルでの動作 : チャネルごとに 1 つのセッションと <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作: 例外がスローされます。|-   セッションフル チャネルでの動作 : チャネルごとに 1 つのセッションと <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作 : 呼び出しごとに 1 つの <xref:System.ServiceModel.InstanceContext>。|-   セッションフル チャネルでの動作: 例外がスローされます。<br />-   セッションレス チャネルでの動作 : 呼び出しごとに 1 つの <xref:System.ServiceModel.InstanceContext>。|  
+|Single|-   セッションフル チャネルでの動作 : すべての呼び出しに対して 1 つのセッションと 1 つの <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作: 例外がスローされます。|-   セッションフル チャネルでの動作 : 作成したシングルトンまたはユーザー指定のシングルトンに対して 1 つのセッションと <xref:System.ServiceModel.InstanceContext>。<br />-   セッションレス チャネルでの動作 : 作成したシングルトンまたはユーザー指定のシングルトンに対して <xref:System.ServiceModel.InstanceContext>。|-   セッションフル チャネルでの動作: 例外がスローされます。<br />-   セッションレス チャネルでの動作 : 作成したシングルトンまたはユーザー指定のシングルトンごとに <xref:System.ServiceModel.InstanceContext>。|  
+  
+## 参照  
+ [セッションの使用](../../../../docs/framework/wcf/using-sessions.md)   
+ [方法 : セッションを必要とするサービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md)   
+ [方法 : サービスのインスタンス化を制御する](../../../../docs/framework/wcf/feature-details/how-to-control-service-instancing.md)   
+ [同時実行](../../../../docs/framework/wcf/samples/concurrency.md)   
+ [インスタンス化](../../../../docs/framework/wcf/samples/instancing.md)   
+ [セッション](../../../../docs/framework/wcf/samples/session.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md b/docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md
new file mode 100644
index 00000000000..6934a0b2df9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md
@@ -0,0 +1,171 @@
+---
+title: "WorkflowServiceHost による side-by-side でのバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 60887eed-df40-4412-b812-41e1dd329d15
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WorkflowServiceHost による side-by-side でのバージョン管理
+[!INCLUDE[net_v45](../../../../includes/net-v45-md.md)] で導入された <xref:System.ServiceModel.Activities.WorkflowServiceHost> による side\-by\-side でのバージョン管理は、1 つのエンドポイントでワークフロー サービスの複数のバージョンをホストする機能を提供します。  提供される side\-by\-side 機能により、既存の定義を使用してインスタンスを実行しているときに、新しいワークフロー定義を使用してワークフロー サービスの新しいインスタンスが作成されるように、ワークフロー サービスを構成できます。  このトピックでは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用したワークフロー サービスの side\-by\-side での実行の概要を提供します。  
+  
+> [!NOTE]
+>  サンプルをダウンロードしてワークフロー サービスの side\-by\-side でのバージョン管理のチュートリアル ビデオを閲覧するには、「[Side by Side Versioning with a Web\-Hosted Xamlx Workflow Service \(Web ホスト XAMLX ワークフロー サービスによる side\-by\-side でのバージョン管理\)](http://go.microsoft.com/fwlink/?LinkId=393746)」を参照してください。  
+  
+## ワークフロー サービスでの複数のバージョンのホスティング  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> には、ワークフローの複数のバージョンを side\-by\-side 実行するように構成できる <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> と <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> の 2 つのプロパティが含まれています。  <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> には、ワークフロー サービスのサポートされているバージョンが含まれます。<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> は、各ワークフロー サービスを一意に識別するために使用されます。  これは、<xref:System.Activities.WorkflowIdentity> をワークフロー サービスと関連付けることによって行われます。  <xref:System.Activities.WorkflowIdentity> には 3 種類の識別情報が格納されます。  <xref:System.Activities.WorkflowIdentity.Name%2A> と <xref:System.Activities.WorkflowIdentity.Version%2A> は必須で、名前と <xref:System.Version> を表します。また、<xref:System.Activities.WorkflowIdentity.Package%2A> は省略可能で、アセンブリ名やその他の必要な情報などの情報を格納する追加文字列の指定に使用できます。  <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> コレクションに含まれる各ワークフロー サービスは、一意の <xref:System.Activities.WorkflowIdentity> を持つ必要があります。  <xref:System.Activities.WorkflowIdentity> は、その 3 つのプロパティのいずれかが他の <xref:System.Activities.WorkflowIdentity> と異なる場合に一意です。  `null` の <xref:System.Activities.WorkflowIdentity> は、<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> に有効な値でし。しかし、ワークフロー サービスの以前のバージョンのうちの 1 つだけが `null` の <xref:System.Activities.WorkflowIdentity> を持つことができます。  
+  
+> [!IMPORTANT]
+>  <xref:System.Activities.WorkflowIdentity> には、個人を特定できる情報 \(PII\) を含めないでください。  <xref:System.Activities.WorkflowIdentity> は、<xref:System.Activities.WorkflowIdentity.Name%2A> \(<xref:System.String>\)、<xref:System.Activities.WorkflowIdentity.Version%2A> \(<xref:System.Version>\)、および <xref:System.Activities.WorkflowIdentity.Package%2A> \(<xref:System.String>\) の 3 つの部分で構成されます。  インスタンスの作成に使用される <xref:System.Activities.WorkflowIdentity> に関する情報は、ランタイムによるアクティビティ ライフ サイクルのさまざまなポイントで構成されているすべての追跡サービスに出力されます。  WF の追跡には PII \(機密ユーザー データ\) を非表示にするメカニズムがありません。  そのため、<xref:System.Activities.WorkflowIdentity> インスタンスには PII データを含めないでください。PII データは、ランタイムによって追跡レコードに出力され、追跡レコードを表示するためのアクセス権を持つユーザーに表示できます。  
+  
+### ワークフロー サービスでの複数のバージョンのホスティングに関する規則  
+ ユーザーが追加のバージョンを <xref:System.ServiceModel.Activities.WorkflowServiceHost> に追加する場合、エンドポイントと説明の同じセットを使用してワークフロー サービスをホストするために満たす必要があるいくつかの条件があります。  追加のバージョンのいずれかがこれらの条件を満たすことができない場合、<xref:System.ServiceModel.Activities.WorkflowServiceHost> は `Open` が呼び出されたときに例外をスローします。  追加のバージョンとしてホストに提供される各ワークフロー定義は、次の要件を満たす必要があります \(プライマリ バージョンは、ホストのコンストラクターに提供されるワークフロー サービス定義です\)。  追加のワークフローのバージョンは、次の条件を満たす必要があります。  
+  
+-   ワークフロー サービスのプライマリ バージョンと同じ <xref:System.ServiceModel.Activities.WorkflowService.Name%2A> を持つ必要があります。  
+  
+-   プライマリ バージョンにない <xref:System.ServiceModel.Activities.WorkflowService.Body%2A> に <xref:System.ServiceModel.Activities.Receive> アクティビティまたは <xref:System.ServiceModel.Activities.SendReply> アクティビティがあってはならず、これらは操作コントラクトに一致する必要があります。  
+  
+-   一意の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を持つ必要があります。  `null`<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を持つことができるワークフロー定義は 1 つだけです。  
+  
+ 一部の変更は可能です。  次の項目は、バージョン間で異なることができます。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> は、プライマリ バージョンと異なる名前およびパッケージを持つことができます。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowService.AllowBufferedReceive%2A> 値は、プライマリ バージョンと異なることができます。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowService.ConfigurationName%2A> 値は、プライマリ バージョンと異なることができます。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowService.ImplementedContracts%2A> 値は、プライマリ バージョンと異なることができます。  
+  
+### DefinitionIdentity の構成  
+ ワークフロー デザイナーを使用してワークフロー サービスを作成する場合、**\[プロパティ\]** ウィンドウを使用して <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を設定します。  デザイナーのサービスのルート アクティビティの外部でクリックしてワークフロー サービスを選択し、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** を選択します。  **DefinitionIdentity** プロパティの横にあるドロップダウン リストから **\[WorkflowIdentity\]** を選択して展開し、目的の <xref:System.Activities.WorkflowIdentity> プロパティを指定します。  次の例の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> では、<xref:System.Activities.WorkflowIdentity.Name%2A> に `MortgageWorkflow` が構成され、<xref:System.Activities.WorkflowIdentity.Version%2A> に `1.0.0.0` が構成されています。  <xref:System.Activities.WorkflowIdentity.Package%2A> は省略可能です。この例では、`null` です。  
+  
+ ![DefinitionIdentity](../../../../docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv1.bmp "WorkflowServiceDefinitionIdentityv1")  
+  
+ ワークフロー サービスが自己ホスト型の場合、<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> はワークフロー サービスを構築するときに構成されます。  次の例では、<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> が前の例と同じ値を使用して構成されています \(つまり <xref:System.Activities.WorkflowIdentity.Name%2A> が `MortgageWorkflow`、<xref:System.Activities.WorkflowIdentity.Name%2A> が `1.0.0.0`\)。  
+  
+```csharp  
+WorkflowService service = new WorkflowService  
+{  
+    Name = "MortgageWorkflowService",  
+    Body = new MortgageWorkflow(),  
+    DefinitionIdentity = new WorkflowIdentity  
+    {  
+        Name = "MortgageWorkflow",  
+        Version = new Version(1, 0, 0, 0)  
+    }  
+};  
+  
+```  
+  
+```vb  
+Dim service As New WorkflowService  
+With service  
+    .Name = "MortgageWorkflowService"  
+    .Body = New MortgageWorkflow  
+    .DefinitionIdentity = New WorkflowIdentity With _  
+    { _  
+        .Name = "MortgageWorkflow", _  
+        .Version = New Version(1, 0, 0, 0) _  
+    }  
+End With  
+```  
+  
+ ワークフロー サービスのただ 1 つのバージョンだけが **null** の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を持つことができますが、<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> は必須ではありません。  
+  
+> [!NOTE]
+>  これは、最初に <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を構成せずにサービスを配置し、後で更新されたバージョンを作成する場合に便利です。  
+  
+### Web ホスト ワークフロー サービスへの新しいバージョンの追加  
+ Web ホスト サービスで新しいバージョンのワークフロー サービスを構成する最初の手順では、`App_Code` フォルダーにサービス ファイルと同じ名前を持つ新しいフォルダーを作成します。  たとえば、サービスの `xamlx` ファイルの名前が `MortgageWorkflow.xamlx` である場合は、フォルダーに `MortgageWorkflow` という名前を付ける必要があります。  元のサービスの `xamlx` ファイルをこのフォルダーにコピーした後、新しい名前 \(たとえば、`MortgageWorkflowV1.xamlx`\) に変更します。  プライマリ サービスに必要な変更を加え、その <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を更新し、サービスを展開します。  次の例の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> は、`MortageWorkflow` という値の <xref:System.Activities.WorkflowIdentity.Name%2A> と `2.0.0.0` という値の <xref:System.Activities.WorkflowIdentity.Version%2A> で更新されています。  
+  
+ ![DefinitionIdentity](../../../../docs/framework/wcf/feature-details/media/workflowservicedefinitionidentityv2.bmp "WorkflowServiceDefinitionIdentityv2")  
+  
+ サービスが再起動されたとき、以前のバージョンは指定された `App_Code` サブフォルダーにないため、<xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> コレクションに自動的に追加されます。  ワークフロー サービスのプライマリ バージョンに `null`<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> がある場合は以前のバージョンは追加されないことに注意してください。  `null` の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を持つことができるのは 1 つのバージョンのみです。しかし、複数のバージョンがある場合、プライマリ バージョンは `null`<xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> を持つバージョンであることはできません。そうでないと、以前のバージョンが <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> コレクションに追加されません。  
+  
+### 自己ホスト型ワークフロー サービスへの新しいバージョンの追加  
+ 自己ホスト型ワークフロー サービスに新しいバージョンを追加する場合、ワークフロー サービスのプライマリ バージョンを使用して <xref:System.ServiceModel.Activities.WorkflowServiceHost> が構成されます。以前のバージョンは明示的に <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> コレクションに追加する必要があります。  次の例では、`MortgageWorkflowV2` ワークフロー定義を使用するプライマリ ワークフロー サービスを使用して <xref:System.ServiceModel.Activities.WorkflowServiceHost> が構成されています。さらに、`MortgageWorkflowV1` ワークフロー定義を使用して構成されたワークフロー サービスが <xref:System.ServiceModel.Activities.WorkflowServiceHost.SupportedVersions%2A> コレクションに追加されています。  各ワークフロー サービスは、ワークフロー定義のバージョンを反映する一意の <xref:System.ServiceModel.Activities.WorkflowService.DefinitionIdentity%2A> で構成されます。  
+  
+```csharp  
+// Create the primary version of the workflow service.  
+WorkflowService serviceV2 = new WorkflowService  
+{  
+    Name = "MortgageWorkflowService",  
+    Body = new MortgageWorkflowV2(),  
+    DefinitionIdentity = new WorkflowIdentity  
+    {  
+        Name = "MortgageWorkflow",  
+        Version = new Version(2, 0, 0, 0)  
+    }  
+};  
+  
+// Configure the WorkflowServiceHost with the current version  
+// of the workflow service. This code requires Administrator  
+// privileges to function correctly. If running from Visual  
+// Studio, Visual Studio must be run with Administrator privileges.  
+WorkflowServiceHost host = new WorkflowServiceHost(serviceV2,   
+    new Uri("http://localhost:8080/MortgageWorkflowService"));  
+  
+// Create the previous version of the workflow service.  
+WorkflowService serviceV1 = new WorkflowService  
+{  
+    Name = "MortgageWorkflowService",  
+    Body = new MortgageWorkflowV1(),  
+    DefinitionIdentity = new WorkflowIdentity  
+    {  
+        Name = "MortgageWorkflow",  
+        Version = new Version(1, 0, 0, 0)  
+    }  
+};  
+  
+// Add the previous version of the service to the SupportedVersions collection.  
+host.SupportedVersions.Add(serviceV1);  
+  
+```  
+  
+```vb  
+'Create the primary version of the workflow service  
+Dim serviceV2 As New WorkflowService  
+With serviceV2  
+    .Name = "MortgageWorkflowService"  
+    .Body = New MortgageWorkflowV2  
+    .DefinitionIdentity = New WorkflowIdentity With _  
+    { _  
+        .Name = "MortgageWorkflow", _  
+        .Version = New Version(2, 0, 0, 0) _  
+    }  
+End With  
+  
+'Configure the WorkflowServiceHost with the current version  
+'of the workflow service. This code requires Administrator  
+'privileges to function correctly. If running from Visual  
+'Studio, Visual Studio must be run with Administrator privileges.  
+  
+Dim host As New WorkflowServiceHost(serviceV2, _  
+    New Uri("http://localhost:8080/MortgageWorkflowService"))  
+  
+'Create the previous version of the workflow service.  
+Dim serviceV1 As New WorkflowService  
+With serviceV1  
+    .Name = "MortgageWorkflowService"  
+    .Body = New MortgageWorkflowV1  
+    .DefinitionIdentity = New WorkflowIdentity With _  
+    { _  
+        .Name = "MortgageWorkflow", _  
+        .Version = New Version(1, 0, 0, 0) _  
+    }  
+End With  
+  
+'Add the previous version of the service to the SupportedVersions collection.  
+host.SupportedVersions.Add(serviceV1)  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/specify-the-certificate-authority-chain-verify-signatures-wcf.md b/docs/framework/wcf/feature-details/specify-the-certificate-authority-chain-verify-signatures-wcf.md
new file mode 100644
index 00000000000..4696b690170
--- /dev/null
+++ b/docs/framework/wcf/feature-details/specify-the-certificate-authority-chain-verify-signatures-wcf.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : 署名の検証に使用する証明機関の証明書チェーンを指定する (WCF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF], 証明機関証明書チェーンの指定"
+  - "証明書 [WCF], 署名の検査"
+ms.assetid: 7c719355-aa41-4567-80d0-5115a8cf73fd
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 方法 : 署名の検証に使用する証明機関の証明書チェーンを指定する (WCF)
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、X.509 証明書を使用して署名された SOAP メッセージを受信すると、その X.509 証明書が信頼された証明機関によって発行されたものかどうかを既定で検証します。これは、証明書ストアを検索し、その証明機関の証明書が信頼された証明書として指定されているかどうかを確認することによって行われます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でこれが確認されるようにするには、証明機関証明書チェーンを適切な証明書ストアにインストールする必要があります。  
+  
+### 証明機関証明書チェーンをインストールするには  
+  
+-   SOAP メッセージの受信者が信頼する必要のある X.509 証明書の発行元の各証明機関について、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で X.509 証明書の取得元として構成されている証明書ストアに、証明機関証明書チェーンをインストールします。  
+  
+     たとえば、SOAP メッセージの受信者がマイクロソフトによって発行された X.509 証明書を信頼する必要がある場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で X.509 証明書の検索先として設定されている証明書ストアに、マイクロソフトの証明機関証明書チェーンをインストールする必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が X.509 証明書を検索する証明書ストアは、コードまたは構成で指定できます。たとえば、これをコードで指定するには、<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> メソッドを使用します。構成では、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md)など、複数の方法で指定できます。  
+  
+     Windows には、信頼された証明機関の既定の証明書チェーンのセットが用意されているため、一部の CA については証明書チェーンをインストールする必要はありません。  
+  
+    1.  証明機関証明書チェーンをエクスポートします。  
+  
+         正確なエクスポート方法は、証明機関によって異なります。証明機関で Microsoft 証明書サービスを実行している場合は、**\[CA 証明書、証明書チェーン、または CRL のダウンロード\]** を選択し、**\[CA 証明書のダウンロード\]** を選択します。  
+  
+    2.  証明機関証明書チェーンをインポートします。  
+  
+         Microsoft 管理コンソール \(MMC: Microsoft Management Console\) で、証明書スナップインを開きます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で X.509 証明書の取得元として構成されている証明書ストアの場合は、**\[信頼されたルート** **証明機関\]** フォルダーを選択します。**\[信頼されたルート証明機関\]** フォルダーの下の **\[証明書\]** フォルダーを右クリックし、**\[すべてのタスク\]** をポイントして、**\[インポート\]** をクリックします。手順 a. でエクスポートしたファイルを指定します。  
+  
+         MMC で証明書スナップインを使用する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)」を参照してください。  
+  
+## 参照  
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md b/docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md
new file mode 100644
index 00000000000..ea22c7dea31
--- /dev/null
+++ b/docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md
@@ -0,0 +1,620 @@
+---
+title: "サービス コントラクトでのデータ転送の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], データ転送"
+ms.assetid: 7c5a26c8-89c9-4bcb-a4bc-7131e6d01f0c
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# サービス コントラクトでのデータ転送の指定
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、一種のメッセージング インフラストラクチャと考えることができます。サービス操作では、メッセージを受信し、それらのメッセージを処理し、送信することができます。メッセージは、操作コントラクトを使用して記述されます。たとえば、次のようなコントラクトがあるとします。  
+  
+```csharp  
+[ServiceContract]  
+public interface IAirfareQuoteService  
+{  
+    [OperationContract]  
+    float GetAirfare(string fromCity, string toCity);  
+}  
+```  
+  
+```vb  
+<ServiceContract()>  
+Public Interface IAirfareQuoteService  
+  
+    <OperationContract()>  
+    Function GetAirfare(fromCity As String, toCity As String) As Double  
+End Interface  
+```  
+  
+ この場合、`GetAirfare` 操作では、`fromCity` と `toCity` に関する情報を含むメッセージを受け入れ、数値を含むメッセージを返します。  
+  
+ ここでは、操作コントラクトでメッセージを記述するさまざまな方法について説明します。  
+  
+## パラメーターを使用したメッセージの記述  
+ メッセージを記述する最も簡単な方法は、パラメーター リストと戻り値を使用することです。前の例では、`fromCity` と `toCity` の 2 つの文字列パラメーターを使用して要求メッセージを記述し、float 型の戻り値を使用して応答メッセージを記述しました。戻り値だけでは応答メッセージを記述できない場合は、out パラメーターを使用できます。たとえば、次の操作は、`fromCity` と `toCity` を要求メッセージに含め、数値と通貨を応答メッセージに含めます。  
+  
+```csharp  
+[OperationContract]  
+float GetAirfare(string fromCity, string toCity, out string currency);  
+```  
+  
+```vb  
+<OperationContract()>  
+    Function GetAirfare(fromCity As String, toCity As String) As Double  
+```  
+  
+ また、参照パラメーターを使用すると、要求メッセージと応答メッセージの両方のパラメーター部分を作成できます。パラメーターは、シリアル化 \(XML への変換\) が可能な型にする必要があります。既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、<xref:System.Runtime.Serialization.DataContractSerializer> クラスというコンポーネントを使用してこの変換を実行します。ほとんどのプリミティブ型 \(`int`、`string`、`float`、`DateTime` など\) がサポートされます。ユーザー定義型には、通常、データ コントラクトが存在する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md).  
+  
+```  
+public interface IAirfareQuoteService  
+{  
+    [OperationContract]  
+    float GetAirfare(Itinerary itinerary, DateTime date);  
+  
+    [DataContract]  
+    public class Itinerary  
+    {  
+        [DataMember]  
+        public string fromCity;  
+        [DataMember]  
+        public string toCity;  
+   }  
+}  
+```  
+  
+```vb  
+Public Interface IAirfareQuoteService  
+    <OperationContract()>  
+    GetAirfare(itinerary as Itinerary, date as DateTime) as Double  
+  
+    <DataContract()>  
+    Class Itinerary  
+  
+        <DataMember()>  
+        Public fromCity As String  
+        <DataMember()>  
+        Public toCity As String  
+    End Class  
+End Interface  
+  
+```  
+  
+ 場合によっては、使用する型のシリアル化に `DataContractSerializer` が適さないことがあります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、代替のシリアル化エンジンとして <xref:System.Xml.Serialization.XmlSerializer> をサポートしているため、パラメーターのシリアル化にこれを使用することもできます。<xref:System.Xml.Serialization.XmlSerializer> では、`XmlAttributeAttribute` などの属性を使用することによって、結果の XML をより細かく制御できます。特定の操作やサービス全体で <xref:System.Xml.Serialization.XmlSerializer> を使用するように切り替えるには、<xref:System.ServiceModel.XmlSerializerFormatAttribute> 属性を操作またはサービスに適用します。次に例を示します。  
+  
+```csharp  
+[ServiceContract]  
+public interface IAirfareQuoteService  
+{  
+    [OperationContract]  
+    [XmlSerializerFormat]  
+    float GetAirfare(Itinerary itinerary, DateTime date);  
+}  
+public class Itinerary  
+{  
+    public string fromCity;  
+    public string toCity;  
+    [XmlAttribute]  
+    public bool isFirstClass;  
+}  
+  
+```  
+  
+```vb  
+<ServiceContract()>  
+Public Interface IAirfareQuoteService  
+    <OperationContract()>  
+    <XmlSerializerFormat>  
+    GetAirfare(itinerary as Itinerary, date as DateTime) as Double  
+  
+End Interface  
+  
+Class Itinerary  
+  
+    Public fromCity As String  
+    Public toCity As String  
+    <XmlSerializerFormat()>  
+    Public isFirstClass As Boolean  
+End Class  
+  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [XmlSerializer クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-xmlserializer-class.md).「XmlSerializer の使用」で説明するような明確な理由がある場合を除き、ここで示す <xref:System.Xml.Serialization.XmlSerializer> への手動での切り替えはお勧めしません。  
+  
+ .NET パラメーター名をコントラクト名から分離するには、<xref:System.ServiceModel.MessageParameterAttribute> 属性を使用し、`Name` プロパティを使用してコントラクト名を設定します。たとえば、次の操作コントラクトは、このトピックの最初の例に相当します。  
+  
+```csharp  
+[OperationContract]  
+public float GetAirfare(  
+    [MessageParameter(Name="fromCity")] string originCity,  
+    [MessageParameter(Name="toCity")] string destinationCity);  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+  Function GetAirfare(<MessageParameter(Name := "fromCity")> fromCity As String, <MessageParameter(Name := "toCity")> toCity As String) As Double  
+  
+```  
+  
+## 空のメッセージの記述  
+ 空の要求メッセージを記述するには、入力パラメーターや参照パラメーターを一切指定しません。C\# の場合:  
+  
+ `[OperationContract]`  
+  
+ `public int GetCurrentTemperature();`  
+  
+ VB の場合:  
+  
+ `<OperationContract()>`  
+  
+ `Function GetCurrentTemperature() as Integer`  
+  
+ 空の応答メッセージを記述するには、戻り値の型として `void` を指定し、出力パラメーターや参照パラメーターを一切指定しません。たとえば:  
+  
+```csharp  
+[OperationContract]  
+public void SetTemperature(int temperature);  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Sub SetTemperature(temperature As Integer)  
+  
+```  
+  
+ これは、次のような一方向操作コントラクトと異なります。  
+  
+```csharp  
+[OperationContract(IsOneWay=true)]  
+public void SetLightbulbStatus(bool isOn);  
+  
+```  
+  
+```vb  
+<OperationContract(IsOneWay:=True)>  
+Sub SetLightbulbStatus(isOne As Boolean)  
+  
+```  
+  
+ `SetTemperatureStatus` 操作は空のメッセージを返します。入力メッセージの処理中にエラーが発生した場合は、代わりにエラーを返す可能性があります。`SetLightbulbStatus` 操作は何も返しません。この操作からエラー状態を伝達することはできません。  
+  
+## メッセージ コントラクトを使用したメッセージの記述  
+ 1 つの型を使用してメッセージ全体を表現する場合があります。この場合、データ コントラクトを使用することもできますが、メッセージ コントラクトを使用する方法をお勧めします。この方法を使用すると、結果の XML での不要なレベルのラップを回避できます。さらに、メッセージ コントラクトを使用すると、結果のメッセージをより細かく制御できます。たとえば、メッセージの本文とヘッダーに含める情報をそれぞれ決めることができます。次に、メッセージ コントラクトの使用例を示します。  
+  
+```csharp  
+[ServiceContract]  
+public interface IAirfareQuoteService  
+{  
+    [OperationContract]  
+    GetAirfareResponse GetAirfare(GetAirfareRequest request);  
+}  
+  
+[MessageContract]  
+public class GetAirfareRequest  
+{  
+    [MessageHeader] public DateTime date;  
+    [MessageBodyMember] public Itinerary itinerary;  
+}  
+  
+[MessageContract]  
+public class GetAirfareResponse  
+{  
+    [MessageBodyMember] public float airfare;  
+    [MessageBodyMember] public string currency;  
+}  
+  
+[DataContract]  
+public class Itinerary  
+{  
+    [DataMember] public string fromCity;  
+    [DataMember] public string toCity;  
+}  
+  
+```  
+  
+```vb  
+<ServiceContract()>  
+Public Interface IAirfareQuoteService  
+    <OperationContract()>  
+    Function GetAirfare(request As GetAirfareRequest) As GetAirfareResponse  
+End Interface  
+  
+<MessageContract()>  
+Public Class GetAirfareRequest  
+    <MessageHeader()>   
+    Public Property date as DateTime  
+    <MessageBodyMember()>  
+    Public Property itinerary As Itinerary  
+End Class  
+  
+<MessageContract()>  
+Public Class GetAirfareResponse  
+    <MessageBodyMember()>  
+    Public Property airfare As Double  
+    <MessageBodyMember()> Public Property currency As String  
+End Class  
+  
+<DataContract()>  
+Public Class Itinerary  
+    <DataMember()> Public Property fromCity As String  
+    <DataMember()> Public Property toCity As String  
+End Class  
+  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [メッセージ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-message-contracts.md).  
+  
+ 前の例でも <xref:System.Runtime.Serialization.DataContractSerializer> クラスが既定で使用されます。メッセージ コントラクトで、<xref:System.Xml.Serialization.XmlSerializer> クラスを使用することもできます。これを行うには、操作またはコントラクトに <xref:System.ServiceModel.XmlSerializerFormatAttribute> 属性を適用し、メッセージ ヘッダーと本文メンバーで <xref:System.Xml.Serialization.XmlSerializer> クラスと互換性のある型を使用します。  
+  
+## ストリームを使用したメッセージの記述  
+ 操作でメッセージを記述する場合は、<xref:System.IO.Stream> クラスまたはその派生クラスを操作コントラクトで使用したり、メッセージ コントラクト本文メンバー \(この場合、唯一のメンバーである必要があります\) として使用したりする方法もあります。受信メッセージの場合、型は `Stream` である必要があり、派生クラスを使用することはできません。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、シリアライザーを呼び出す代わりに、ストリームからデータを取得して送信メッセージに直接配置するか、受信メッセージからデータを取得してストリームに直接配置します。次に、ストリームの使用例を示します。  
+  
+```csharp  
+[OperationContract]  
+public Stream DownloadFile(string fileName);  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Function DownloadFile(fileName As String) As String  
+  
+```  
+  
+ 1 つのメッセージ本文で `Stream` と非ストリーム データを組み合わせることはできません。追加データをメッセージ ヘッダーに配置するには、メッセージ コントラクトを使用します。操作コントラクトを定義するときのストリームの不適切な使用例を次に示します。  
+  
+```csharp  
+//Incorrect:  
+// [OperationContract]  
+// public void UploadFile (string fileName, Stream fileData);  
+  
+```  
+  
+```vb  
+'Incorrect:  
+    '<OperationContract()>  
+    Public Sub UploadFile(fileName As String, fileData As StreamingContext)  
+  
+```  
+  
+ 操作コントラクトを定義するときのストリームの正しい使用例を次に示します。  
+  
+```csharp  
+[OperationContract]  
+public void UploadFile (UploadFileMessage message);  
+//code omitted  
+[MessageContract]  
+public class UploadFileMessage  
+{  
+    [MessageHeader] public string fileName;  
+    [MessageBodyMember] public Stream fileData;  
+}  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Public Sub UploadFile(fileName As String, fileData As StreamingContext)  
+'Code Omitted  
+<MessageContract()>  
+Public Class UploadFileMessage  
+   <MessageHeader()>  
+    Public Property fileName As String  
+    <MessageBodyMember()>  
+    Public Property fileData As Stream  
+End Class  
+  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [大規模データとストリーミング](../../../../docs/framework/wcf/feature-details/large-data-and-streaming.md).  
+  
+## メッセージ クラスの使用  
+ 送受信されるメッセージをプログラムによって完全に制御するには、次のコード例に示すように <xref:System.ServiceModel.Channels.Message> クラスを直接使用します。  
+  
+```csharp  
+[OperationContract]  
+public void LogMessage(Message m);  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Sub LogMessage(m As Message)  
+  
+```  
+  
+ これは高度なシナリオです。詳細については、「[メッセージ クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-message-class.md)」を参照してください。  
+  
+## エラー メッセージの記述  
+ 一方向ではない操作では、戻り値と出力パラメーターまたは参照パラメーターによって記述されるメッセージに加え、通常の応答メッセージとエラー メッセージの少なくとも 2 つのメッセージを返すことができます。たとえば、次の操作コントラクトがあるとします。  
+  
+```csharp  
+[OperationContract]  
+float GetAirfare(string fromCity, string toCity, DateTime date);  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Function GetAirfare(fromCity As String, toCity As String, date as DateTime)  
+  
+```  
+  
+ この操作は、`float` 型の数値を含む通常のメッセージか、エラー コードと説明を含むエラー メッセージのいずれかを返すことができます。これは、サービス実装で <xref:System.ServiceModel.FaultException> をスローすることによって実現できます。  
+  
+ <xref:System.ServiceModel.FaultContractAttribute> 属性を使用すると、追加のエラー メッセージを指定できます。追加のエラーは、次のコード例に示すように、<xref:System.Runtime.Serialization.DataContractSerializer> を使用してシリアル化できる必要があります。  
+  
+```csharp  
+[OperationContract]  
+[FaultContract(typeof(ItineraryNotAvailableFault))]  
+float GetAirfare(string fromCity, string toCity, DateTime date);  
+  
+//code omitted  
+  
+[DataContract]  
+public class ItineraryNotAvailableFault  
+{  
+    [DataMember]  
+    public bool IsAlternativeDateAvailable;  
+  
+    [DataMember]  
+    public DateTime alternativeSuggestedDate;  
+}  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+<FaultContract(GetType(ItineraryNotAvailableFault))>  
+Function GetAirfare(fromCity As String, toCity As String, date as DateTime) As Double  
+  
+'Code Omitted  
+<DataContract()>  
+Public Class  
+  <DataMember()>  
+  Public Property IsAlternativeDateAvailable As Boolean  
+  <DataMember()>  
+  Public Property alternativeSuggestedDate As DateTime  
+End Class  
+  
+```  
+  
+ これらの追加エラーは、適切なデータ コントラクト型の <xref:System.ServiceModel.FaultException%601> をスローすることによって生成できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][例外とエラーの処理](../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md).  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスを使用してエラーを記述することはできません。<xref:System.ServiceModel.XmlSerializerFormatAttribute> は、エラー コントラクトに影響を及ぼしません。  
+  
+## 派生型の使用  
+ 操作コントラクトやメッセージ コントラクトで基本型を使用し、その後、実際に操作を呼び出すときに派生型を使用する場合があります。この場合、<xref:System.ServiceModel.ServiceKnownTypeAttribute> 属性または何らかの代替機構を使用して、派生型を使用できるようにする必要があります。次の操作があるとします。  
+  
+```csharp  
+[OperationContract]  
+public bool IsLibraryItemAvailable(LibraryItem item);  
+  
+```  
+  
+```vbs  
+<OperationContract()>  
+    Function IsLibraryItemAvailable(item As LibraryItem) As Boolean  
+  
+```  
+  
+ `LibraryItem` から派生する `Book` と `Magazine` の 2 つの型があると想定します。`IsLibraryItemAvailable` 操作でこれらの型を使用するには、操作を次のように変更します。  
+  
+ `[OperationContract]`  
+  
+ `[ServiceKnownType(typeof(Book))]`  
+  
+ `[ServiceKnownType(typeof(Magazine))]`  
+  
+ `public bool IsLibraryItemAvailable(LibraryItem item);`  
+  
+ 既定の <xref:System.Runtime.Serialization.DataContractSerializer> を使用している場合は、次のコード例に示すように <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を使用できます。  
+  
+```csharp  
+  
+[OperationContract]  
+public bool IsLibraryItemAvailable(LibraryItem item);  
+  
+// code omitted   
+  
+[DataContract]  
+[KnownType(typeof(Book))]  
+[KnownType(typeof(Magazine))]  
+public class LibraryItem  
+{  
+    //code omitted  
+}  
+  
+```  
+  
+```vb  
+<OperationContract()>  
+Function IsLibraryItemAvailable(item As LibraryItem) As Boolean  
+  
+'Code Omitted  
+<DataContract()>  
+<KnownType(GetType(Book))>  
+<KnownType(GetType(Magazine))>  
+Public Class LibraryItem  
+  'Code Omitted  
+End Class  
+  
+```  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> を使用する場合は、<xref:System.Xml.Serialization.XmlIncludeAttribute> 属性を使用できます。  
+  
+ <xref:System.ServiceModel.ServiceKnownTypeAttribute> 属性は、操作に適用することもサービス全体に適用することもできます。この属性は、<xref:System.Runtime.Serialization.KnownTypeAttribute> 属性と同様に、型を受け取るか、既知の型の一覧を取得するために呼び出すメソッドの名前を受け取ります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md).  
+  
+## Use と Style の指定  
+ Web サービス記述言語 \(WSDL: Web Services Description Language\) を使用してサービスを記述するときは、一般にドキュメントとリモート プロシージャ コール \(RPC: Remote Procedure Call\) の 2 つのスタイルが使用されます。ドキュメント スタイルでは、スキーマを使用してメッセージ本文全体が記述されます。WSDL では、該当するスキーマの中の要素を参照して、メッセージ本文のさまざまな部分を記述します。RPC スタイルでは、WSDL は、要素ではなく、メッセージの各部を表すスキーマ型を参照します。場合によっては、これらのスタイルのいずれかを手動で選択することが必要になります。これを行うには、<xref:System.ServiceModel.DataContractFormatAttribute> 属性を適用し、`Style` プロパティを設定するか \(<xref:System.Runtime.Serialization.DataContractSerializer> を使用している場合\)、<xref:System.ServiceModel.XmlSerializerFormatAttribute> 属性の `Style` を設定します \(<xref:System.Xml.Serialization.XmlSerializer> を使用している場合\)。  
+  
+ また、<xref:System.Xml.Serialization.XmlSerializer> はシリアル化された XML の形式を 2 とおり \(`Literal` および `Encoded`\) サポートしています。`Literal` は最も一般に受け入れられたフォームであり、<xref:System.Runtime.Serialization.DataContractSerializer> がサポートする唯一のフォームです。`Encoded` は SOAP 仕様のセクション 5 に記載されたレガシ フォームであり、新しいサービスにはお勧めしません。`Encoded` モードに切り替えるには、<xref:System.ServiceModel.XmlSerializerFormatAttribute> 属性の `Use` プロパティを `Encoded` に設定します。  
+  
+ ほとんどの場合、`Style` プロパティと `Use` プロパティの既定の設定は変更しないでください。  
+  
+## シリアル化プロセスの制御  
+ データをシリアル化する方法をカスタマイズする場合、さまざまな設定を行うことができます。  
+  
+### サーバーのシリアル化設定の変更  
+ 既定の <xref:System.Runtime.Serialization.DataContractSerializer> を使用している場合は、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性をサービスに適用することで、サービスでのシリアル化プロセスの一部の側面を制御できます。具体的には、`MaxItemsInObjectGraph` プロパティを使用して、<xref:System.Runtime.Serialization.DataContractSerializer> が逆シリアル化するオブジェクトの最大数を制限するクォータを設定できます。また、`IgnoreExtensionDataObject` プロパティを使用すると、ラウンド トリップ バージョン管理機能を無効にできます。クォータ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[セキュリティに関するデータの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」を参照してください。ラウンドトリップ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)」を参照してください。  
+  
+```csharp  
+  
+[ServiceBehavior(MaxItemsInObjectGraph=100000)]  
+public class MyDataService:IDataService  
+{  
+    public DataPoint[] GetData()  
+    {  
+       // Implementation omitted  
+    }  
+}  
+```  
+  
+```vb  
+  
+<ServiceBehavior(MaxItemsInObjectGraph:=100000)>  
+Public Class MyDataService Implements IDataService  
+  
+    Function GetData() As DataPoint()  
+         ‘ Implementation omitted  
+    End Function  
+End Interface  
+  
+```  
+  
+### シリアル化の動作  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、特定の操作で使用しているシリアライザーに応じて自動的にプラグインされる、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> と <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior> の 2 つの動作が用意されています。これらの動作は自動的に適用されるため、通常、これらの動作を意識する必要はありません。  
+  
+ ただし、`DataContractSerializerOperationBehavior` には、`MaxItemsInObjectGraph`、`IgnoreExtensionDataObject`、および `DataContractSurrogate` の 3 つのプロパティがあり、これらを使用してシリアル化プロセスをカスタマイズできます。最初の 2 つのプロパティの意味は、前のセクションの説明と同じです。`DataContractSurrogate` プロパティを使用すると、シリアル化プロセスをカスタマイズおよび拡張するための強力な機構であるデータ コントラクト サロゲートを有効にできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクト サロゲート](../../../../docs/framework/wcf/extending/data-contract-surrogates.md).  
+  
+ `DataContractSerializerOperationBehavior` を使用すると、クライアントとサーバーの両方のシリアル化をカスタマイズできます。クライアントで `MaxItemsInObjectGraph` クォータを増やす方法を次の例に示します。  
+  
+```csharp  
+ChannelFactory<IDataService> factory = new ChannelFactory<IDataService>(binding, address);  
+foreach (OperationDescription op in factory.Endpoint.Contract.Operations)  
+{  
+    DataContractSerializerOperationBehavior dataContractBehavior =  
+                op.Behaviors.Find<DataContractSerializerOperationBehavior>()  
+                as DataContractSerializerOperationBehavior;  
+    if (dataContractBehavior != null)  
+    {  
+        dataContractBehavior.MaxItemsInObjectGraph = 100000;  
+    }  
+}  
+IDataService client = factory.CreateChannel();  
+  
+```  
+  
+```vb  
+Dim factory As ChannelFactory(Of IDataService) = New ChannelFactory(Of IDataService)(binding, address)  
+For Each op As OperationDescription In factory.Endpoint.Contract.Operations  
+        Dim dataContractBehavior As DataContractSerializerOperationBehavior = op.Behaviors.Find(Of DataContractSerializerOperationBehavior)()  
+        If dataContractBehavior IsNot Nothing Then  
+            dataContractBehavior.MaxItemsInObjectGraph = 100000  
+        End If  
+     Next  
+    Dim client As IDataService = factory.CreateChannel  
+  
+```  
+  
+ 自己ホスト型サービスでの同等のコードを次に示します。  
+  
+```csharp  
+ServiceHost serviceHost = new ServiceHost(typeof(IDataService))  
+foreach (ServiceEndpoint ep in serviceHost.Description.Endpoints)  
+{  
+foreach (OperationDescription op in ep.Contract.Operations)  
+{  
+        DataContractSerializerOperationBehavior dataContractBehavior =  
+           op.Behaviors.Find<DataContractSerializerOperationBehavior>()  
+                as DataContractSerializerOperationBehavior;  
+        if (dataContractBehavior != null)  
+        {  
+            dataContractBehavior.MaxItemsInObjectGraph = 100000;  
+        }  
+}  
+}  
+serviceHost.Open();  
+  
+```  
+  
+```vb  
+Dim serviceHost As ServiceHost = New ServiceHost(GetType(IDataService))  
+        For Each ep As ServiceEndpoint In serviceHost.Description.Endpoints  
+            For Each op As OperationDescription In ep.Contract.Operations  
+                Dim dataContractBehavior As DataContractSerializerOperationBehavior = op.Behaviors.Find(Of DataContractSerializerOperationBehavior)()  
+  
+                If dataContractBehavior IsNot Nothing Then  
+                    dataContractBehavior.MaxItemsInObjectGraph = 100000  
+                End If  
+            Next  
+        Next  
+        serviceHost.Open()  
+  
+```  
+  
+ Web ホスト型の場合は、新しい `ServiceHost` 派生クラスを作成し、サービス ホスト ファクトリを使用してプラグインする必要があります。  
+  
+### 構成でのシリアル化設定の制御  
+ 次の例に示すように、`MaxItemsInObjectGraph` と `IgnoreExtensionDataObject` は、`dataContractSerializer` エンドポイントまたはサービスの動作を使用して構成によって制御できます。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+        <behaviors>  
+            <endpointBehaviors>  
+                <behavior name="LargeQuotaBehavior">  
+                    <dataContractSerializer  
+                      maxItemsInObjectGraph="100000" />  
+                </behavior>  
+            </endpointBehaviors>  
+        </behaviors>  
+        <client>  
+            <endpoint address=http://example.com/myservice  
+                  behaviorConfiguration="LargeQuotaBehavior"  
+                binding="basicHttpBinding" bindingConfiguration=""   
+                            contract="IDataService"  
+                name="" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### 共有する型のシリアル化、オブジェクト グラフの保存、およびカスタム シリアライザー  
+ <xref:System.Runtime.Serialization.DataContractSerializer> は、.NET 型名ではなく、データ コントラクト名を使用してシリアル化を実行します。これは、サービス指向アーキテクチャの基本思想と一致しており、高度な柔軟性の実現を可能にします。つまり、ネットワーク コントラクトに影響を及ぼさずに .NET 型を変更できます。まれなケースとして、実際の .NET 型名をシリアル化することにより、.NET Framework リモート処理テクノロジと同様のクライアントとサーバー間の密結合を導入することが必要になる場合があります。.NET Framework リモート処理から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] への移行時に発生するまれなケースを除き、これはお勧めしません。この場合、<xref:System.Runtime.Serialization.DataContractSerializer> クラスではなく、<xref:System.Runtime.Serialization.NetDataContractSerializer> クラスを使用する必要があります。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> は、通常、オブジェクト グラフをオブジェクト ツリーとしてシリアル化します。つまり、同じオブジェクトが複数回にわたって参照される場合、そのオブジェクトは複数回にわたってシリアル化されます。たとえば、`billTo` および `shipTo` という、Address 型の 2 つのフィールドを持つ `PurchaseOrder` インスタンスがあるとします。この両方のフィールドに同じ Address インスタンスを設定すると、シリアル化および逆シリアル化の後に 2 つの同一の Address インスタンスが生じます。これは、オブジェクト グラフを XML で表現する相互運用可能な標準の方法がないためです \(ただし、`Style` と `Use` に関する前のセクションで説明した <xref:System.Xml.Serialization.XmlSerializer> で使用できる従来の SOAP エンコード標準を除きます\)。オブジェクト グラフをツリーとしてシリアル化する場合、循環参照が含まれたグラフをシリアル化できないなどの欠点があります。場合によっては、相互運用が可能ではありませんが、真のオブジェクト グラフ シリアル化に切り替えることが必要になります。これを行うには、`preserveObjectReferences` パラメーターを `true` に設定して構築した <xref:System.Runtime.Serialization.DataContractSerializer> を使用します。  
+  
+ シナリオによっては、組み込みのシリアライザーでは不十分な場合があります。ただし、ほとんどの場合、<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.NetDataContractSerializer> の派生元である <xref:System.Runtime.Serialization.XmlObjectSerializer> 抽象クラスを使用できます。  
+  
+ 前述の 3 つのケース \(.NET 型の保存、オブジェクト グラフの保存、および `XmlObjectSerializer` ベースの完全なカスタム シリアル化\) では、必ずカスタム シリアライザーをプラグインする必要があります。これを行うには、次の手順を実行します:  
+  
+1.  <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> から派生する独自の動作を記述します。  
+  
+2.  独自のシリアライザー \(<xref:System.Runtime.Serialization.NetDataContractSerializer>、`preserveObjectReferences` が `true` に設定された <xref:System.Runtime.Serialization.DataContractSerializer>、独自のカスタム <xref:System.Runtime.Serialization.XmlObjectSerializer> のいずれか\) を返すように 2 つの `CreateSerializer` メソッドをオーバーライドします。  
+  
+3.  サービス ホストを開いたり、クライアント チャネルを作成したりする前に、既存の <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> 動作を削除し、前の手順で作成したカスタム派生クラスをプラグインします。  
+  
+ シリアル化の高度な概念[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)」を参照してください。  
+  
+## 参照  
+ [XmlSerializer クラスの使用](../../../../docs/framework/wcf/feature-details/using-the-xmlserializer-class.md)   
+ [方法 : ストリーミングを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-streaming.md)   
+ [方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/stand-alone-json-serialization.md b/docs/framework/wcf/feature-details/stand-alone-json-serialization.md
new file mode 100644
index 00000000000..9a5284ade1b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/stand-alone-json-serialization.md
@@ -0,0 +1,271 @@
+---
+title: "スタンドアロン JSON のシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 312bd7b2-1300-4b12-801e-ebe742bd2287
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# スタンドアロン JSON のシリアル化
+JSON \(JavaScript Object Notation\) は、ブラウザー内の Web ページで実行される JavaScript コードで使用するために特別に設計されたデータ形式です。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で作成される ASP.NET AJAX サービスは、既定でこのデータ形式を使用します。  
+  
+ この形式は、ASP.NET と統合せずに AJAX サービスを作成する場合にも使用できます。この場合、XML が既定のデータ形式になりますが、JSON を選択することもできます。  
+  
+ JSON をサポートする必要はあっても AJAX サービスを作成する予定はない場合は、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用することで、.NET オブジェクトを JSON データに直接シリアル化したり、このようなデータを .NET 型のインスタンスに逆シリアル化したりできます。この手順の詳細については、「[方法 : JSON データをシリアル化および逆シリアル化する](../../../../docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md)」を参照してください。  
+  
+ JSON を使用する場合、一部例外はありますが、<xref:System.Runtime.Serialization.DataContractSerializer> でサポートされているものと同じ .NET 型 がサポートされます。サポートされる型の一覧については、「[データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)」を参照してください。これには、ほとんどのプリミティブ型、ほとんどの配列型とコレクション型、<xref:System.Runtime.Serialization.DataContractAttribute> と <xref:System.Runtime.Serialization.DataMemberAttribute> を使用する複合型などがあります。  
+  
+## .NET 型から JSON 型へのマッピング  
+ シリアル化および逆シリアル化の手順でマップされる場合の .NET 型と JSON\/JavaScript 型の対応表を次に示します。  
+  
+|.NET 型|JSON\/JavaScript|注意|  
+|------------|----------------------|--------|  
+|すべての数値型 \(<xref:System.Int32>、<xref:System.Decimal>、<xref:System.Double> など\)|数値|`Double.NaN`、`Double.PositiveInfinity`、`Double.NegativeInfinity` などの特殊な値はサポートされていないため、無効な JSON になります。|  
+|<xref:System.Enum>|数値|このトピックの「列挙体と JSON」を参照してください。|  
+|<xref:System.Boolean>|ブール|\-\-|  
+|<xref:System.String>,<xref:System.Char>|文字列|\-\-|  
+|<xref:System.Timespan>, <xref:System.Guid>, <xref:System.Uri>|文字列|JSON のこれらの型の形式は、XML の場合と同じです \(基本的には、TimeSpan は ISO 8601 の日付\/時刻形式、GUID は "12345678\-ABCD\-ABCD\-ABCD\-1234567890AB" 形式、URI は "http:\/\/www.example.com" のような自然な文字列形式です\)。正確な情報については、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。|  
+|<xref:System.Xml.XmlQualifiedName>|文字列|形式は "name:namespace" です \(最初のコロンの前が名前です\)。名前または名前空間が存在しない場合があります。名前空間がない場合、コロンも省略されることがあります。|  
+|<xref:System.Array> 型の<xref:System.Byte>|数値の配列型|各数値は、1 バイトの値を表します。|  
+|<xref:System.Datetime>|DateTime 型または文字列型|このトピックの「日付\/時刻と JSON」を参照してください。|  
+|<xref:System.DatetimeOffset>|複合型|このトピックの「日付\/時刻と JSON」を参照してください。|  
+|XML 型および ADO.NET 型 \(<xref:System.Xml.XmlElement>、<br /><br /> <xref:System.Xml.Linq.XElement>.<xref:System.Xml.XmlNode> の配列、<br /><br /> <xref:System.Runtime.Serialization.ISerializable>,<br /><br /> <xref:System.Data.DataSet>\).|文字列|このトピックの「XML 型と JSON」を参照してください。|  
+|<xref:System.DBNull>|空の複合型|\-\-|  
+|コレクション、ディクショナリ、および配列|配列|このトピックの「コレクション、ディクショナリ、および配列」を参照してください。|  
+|複合型 \(<xref:System.Runtime.Serialization.DataContractAttribute> または <xref:System.SerializableAttribute> が適用された型\)|複合型|データ メンバーは、JavaScript 複合型のメンバーになります。|  
+|<xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装する複合型|複合型|他の複合型と同じですが、一部の <xref:System.Runtime.Serialization.ISerializable> 型はサポートされません。このトピックの「高度な情報」の「ISerializable のサポート」を参照してください。|  
+|任意の型の `Null` 値|null|null 許容型もサポートされており、null 非許容型と同様に JSON にマップされます。|  
+  
+### 列挙体と JSON  
+ 列挙メンバー値は、JSON では数値として処理されるため、列挙メンバー値がメンバー名として含まれているデータ コントラクトでの処理方法とは異なります。データ コントラクトでの処理[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[データ コントラクトの列挙型](../../../../docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md)」を参照してください。  
+  
+-   たとえば、`public enum Color {red, green, blue, yellow, pink}` の場合、`yellow` をシリアル化すると、文字列の "yellow" ではなく、数字の 3 が生成されます。  
+  
+-   `enum` のメンバーはすべて、シリアル化できます。<xref:System.Runtime.Serialization.EnumMemberAttribute> 属性と <xref:System.NonSerializedAttribute> 属性は、使用しても無視されます。  
+  
+-   存在しない `enum` 値を逆シリアル化できます。たとえば、値 87 に対応する色の名前が定義されていなくても、この値を上記の Color 列挙値に逆シリアル化できます。  
+  
+-   フラグ `enum` は特殊ではなく、他の `enum` と同様に処理されます。  
+  
+### 日付時刻 とJSON  
+ JSON 形式では、日付と時刻を直接サポートしていません。ただし、日付と時刻は使用されることが非常に多いため、ASP.NET AJAX ではこれらの型を特別にサポートしています。ASP.NET AJAX プロキシを使用する場合、.NET の <xref:System.DateTime> 型は JavaScript の `DateTime` 型に完全に対応します。  
+  
+-   ASP.NET を使用しない場合、JSON では、<xref:System.DateTime> 型はこのトピックの「高度な情報」で説明する特殊な形式の文字列として表されます。  
+  
+-   JSON では、<xref:System.DateTimeOffset> が複合型 {"DateTime":dateTime,"OffsetMinutes":offsetMinutes} として表現されます。`offsetMinutes` メンバーは、当該イベントの場所に関連付けられたグリニッジ標準時 \(GMT\) \(協定世界時 \(UTC\) とも呼ばれます\) からの現地時刻のオフセットです。`dateTime` メンバーは、当該イベントが発生した時点のインスタンスを表します \(この場合も、ASP.NET AJAX を使用しているときは JavaScript の `DateTime` になり、使用していないときは文字列になります\)。シリアル化時には、`dateTime` メンバーは常に GMT でシリアル化されます。したがって、ニューヨーク時間の午前 3 時を示す場合、`dateTime` の時刻コンポーネントは 8:00 AM であり、`offsetMinutes` は 300 \(GMT マイナス 300 分 \(5 時間\)\) です。  
+  
+    > [!NOTE]
+    >  <xref:System.DateTime> オブジェクトと <xref:System.DateTimeOffset> オブジェクトを JSON にシリアル化した場合、ミリ秒の精度までしか情報は保持されません。1 ミリ秒未満の値 \(マイクロ秒\/ナノ秒\) は、シリアル化時に失われます。  
+  
+### XML 型と JSON  
+ XML 型は JSON 文字列になります。  
+  
+-   たとえば、XElement 型のデータ メンバー "q" が \<abc\/\> を含む場合、JSON は {"q":"\<abc\/\>"} になります。  
+  
+-   XML のラップ方法を指定する特別なルールがいくつかあります。詳細については、このトピックで後述する「高度な情報」を参照してください。  
+  
+-   ASP.NET AJAX を使用している場合に、JavaScript で文字列ではなく XML DOM を使用するときは、<xref:System.ServiceModel.Web.WebGetAttribute> で <xref:System.ServiceModel.Web.WebGetAttribute.ResponseFormat%2A> プロパティを XML に設定するか、<xref:System.ServiceModel.Web.WebInvokeAttribute> で <xref:System.ServiceModel.Web.WebInvokeAttribute.ResponseFormat%2A> プロパティを XML に設定します。  
+  
+### コレクション、ディクショナリ、および配列  
+ コレクション、ディクショナリ、および配列は、JSON ではすべて配列として表されます。  
+  
+-   <xref:System.Runtime.Serialization.CollectionDataContractAttribute> を使用するカスタマイズは、JSON 表現では無視されます。  
+  
+-   ディクショナリは、直接 JSON を操作する手段ではありません。ディクショナリの \<string,object\> は、他の JSON テクノロジの使用方法から予想されるように [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされていない場合があります。たとえば、ディクショナリで "abc" が "xyz" にマップされ、"def" が 42 にマップされている場合、JSON 表現では {"abc":"xyz","def":42} ではなく、\[{"Key":"abc","Value":"xyz"},{"Key":"def","Value":42}\] になります。  
+  
+-   JSON を直接使用する \(厳密なコントラクトをあらかじめ定義せずに、キーと値に動的にアクセスする\) 場合、いくつかのオプションがあります。  
+  
+    -   「[弱い型指定の JSON のシリアル化 \(AJAX\)](../../../../docs/framework/wcf/samples/weakly-typed-json-serialization-sample.md)」のサンプルを使用することを検討します。  
+  
+    -   <xref:System.Runtime.Serialization.ISerializable> インターフェイスと逆シリアル化コンストラクターを使用することを検討します。この 2 つの機構を使用すると、シリアル化と逆シリアル化の実行時にそれぞれ JSON のキーと値のペアにアクセスできます。ただし、これらの機構は、部分信頼シナリオでは機能しません。  
+  
+    -   シリアライザーを使用するのではなく、[JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)を使用することを検討します。  
+  
+    -   シリアル化のコンテキストにおける *"ポリモーフィズム"* は、基本型が必要な場合に派生型をシリアル化できることを指します。コレクションをポリモーフィックに使用する場合は \(コレクションを <xref:System.Object> に割り当てる場合など\)、JSON 固有の特別なルールがあります。この問題については、後の「高度な情報」で詳しく説明します。  
+  
+## 追加の詳細情報  
+  
+### データ メンバーの順序  
+ JSON を使用する際、データ メンバーの順序は重要ではありません。具体的には、<xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A> が設定されていても、JSON データを任意の順序で逆シリアル化できます。  
+  
+### JSON の型  
+ JSON の型は、逆シリアル化時には前述の表と一致する必要はありません。たとえば、`Int` は通常 JSON の数値にマップされますが、JSON 文字列に有効な数値が含まれていれば、その文字列から正常に逆シリアル化することもできます。つまり、"q" という `Int` データ メンバーが存在する場合は、{"q":42} も {"q":"42"} も有効です。  
+  
+### ポリモーフィズム  
+ ポリモーフィックなシリアル化は、基本型が必要な場合に派生型をシリアル化できることで成り立ちます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] による JSON シリアル化でこれがサポートされているのは、XML シリアル化がサポートされている方法と互換性がある場合です。たとえば、`MyBaseType` が必要な場合に `MyDerivedType` をシリアル化したり、`Object` が必要な場合に `Int` をシリアル化したりできます。  
+  
+ 複合型を逆シリアル化する場合を除き、基本型が必要な場合に派生型を逆シリアル化すると、型情報が失われることがあります。たとえば、<xref:System.Object> が必要な場合に <xref:System.Uri> をシリアル化すると、JSON 文字列になります。この文字列を <xref:System.Object> に逆シリアル化した場合、.NET の <xref:System.String> が返されます。デシリアライザーは、この文字列が最初は <xref:System.Uri> 型であったことを認識していません。通常、<xref:System.Object> を必要とするときに、すべての JSON 文字列が .NET 文字列として逆シリアル化されます。また、.NET のコレクション、ディクショナリ、および配列のシリアル化に使用するすべての JSON 配列は、実際の元の型に関係なく、<xref:System.Object> 型の .NET <xref:System.Array> として逆シリアル化されます。JSON のブール型は .NET の <xref:System.Boolean> にマップされます。ただし、<xref:System.Object> が必要な場合、JSON の数値型は .NET の <xref:System.Int32>、<xref:System.Decimal>、または <xref:System.Double> の型として逆シリアル化されます。この場合、最も適切な型が自動的に選択されます。  
+  
+ インターフェイス型に逆シリアル化する場合、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> は、宣言された型がオブジェクトである場合と同様に逆シリアル化します。  
+  
+ 独自の基本型と派生型を使用している場合は、通常、<xref:System.Runtime.Serialization.KnownTypeAttribute>、<xref:System.ServiceModel.ServiceKnownTypeAttribute>、または同等の機構を使用する必要があります。たとえば、戻り値が `Animal` である操作があり、実際には \(`Animal` から派生した\) `Cat` のインスタンスを返す場合、<xref:System.Runtime.Serialization.KnownTypeAttribute> を `Animal` 型に適用するか、<xref:System.ServiceModel.ServiceKnownTypeAttribute> を操作に適用し、これらの属性で `Cat` 型を指定する必要があります。詳細については、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。  
+  
+ ポリモーフィックなシリアル化のしくみの詳細、およびポリモーフィックなシリアル化を使用するときに留意する必要のある制限事項については、このトピックで後述する「高度な情報」を参照してください。  
+  
+### バージョン管理  
+ <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスをはじめとするデータ コントラクトのバージョン管理機能は、JSON で完全にサポートされています。また、ほとんどの場合、ある形式 \(XML など\) で型を逆シリアル化した後、その型を別の形式 \(JSON など\) にシリアル化しても、<xref:System.Runtime.Serialization.IExtensibleDataObject> にデータを保持できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md).JSON は順序なしであるため、順序情報は失われることに注意してください。また、JSON では、同じキー名を持つ複数のキーと値のペアをサポートしていません。<xref:System.Runtime.Serialization.IExtensibleDataObject> でのすべての操作は、本質的にポリモーフィックです。つまり、派生型はすべての型の基本型である <xref:System.Object> に割り当てられます。  
+  
+## URL 内の JSON  
+ \(<xref:System.ServiceModel.Web.WebGetAttribute> 属性を使用して\) HTTP GET 動詞と共に ASP.NET AJAX エンドポイントを使用する場合、受信パラメーターは、メッセージ本文ではなく要求 URL に配置されます。JSON は、要求 URL 内でもサポートされます。そのため、"number" という `Int` 型と "p" という `Person` 複合型を取得する操作がある場合、次のような URL になります。  
+  
+```  
+http://example.com/myservice.svc/MyOperation?number=7&p={"name":"John","age":42}  
+```  
+  
+ ASP.NET AJAX Script Manager コントロールとプロキシを使用してサービスを呼び出すと、この URL はプロキシによって自動的に生成されるため、確認することはできません。JSON は、ASP.NET AJAX エンドポイントを使用しない URL では使用できません。  
+  
+## 高度な情報  
+  
+### ISerializable のサポート  
+  
+#### サポートされる ISerializable 型とサポートされない ISerializable 型  
+ 通常、JSON をシリアル化または逆シリアル化するときに、<xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装する型は完全にサポートされています。ただし、これらの型の一部 \(一部の .NET Framework 型を含みます\) は、次のような JSON 固有のシリアル化の側面が原因で正しく逆シリアル化されない方法で実装されています。  
+  
+-   <xref:System.Runtime.Serialization.ISerializable> では、個々のデータ メンバーの型は事前にはわかりません。このため、型をオブジェクトに逆シリアル化する場合と同様のポリモーフィックな状況になります。前述のように、これは JSON で型情報が失われる原因となる場合があります。たとえば、<xref:System.Runtime.Serialization.ISerializable> 実装で `enum` をシリアル化した型を \(適切にキャストせずに\) `enum` に直接逆シリアル化しようとした場合、逆シリアル化は失敗します。これは、`enum` は JSON の数値型を使用してシリアル化されますが、JSON の数値型は .NET の組み込みの数値型 \(Int32、Decimal、または Double\) に逆シリアル化されるためです。そのため、この数値が `enum` 値を表すために使用されているという情報が失われます。  
+  
+-   <xref:System.Runtime.Serialization.ISerializable> 型が逆シリアル化コンストラクターで特定の順序の逆シリアル化に依存する場合も、一部の JSON データの逆シリアル化に失敗する場合があります。これは、ほとんどの JSON シリアライザーが特定の順序を保証しないためです。  
+  
+#### ファクトリ型  
+ <xref:System.Runtime.Serialization.IObjectReference> インターフェイスは JSON で一般にサポートされますが、"ファクトリ型" 機能 \(<xref:System.Runtime.Serialization.IObjectReference.GetRealObject%28System.Runtime.Serialization.StreamingContext%29> から、このインターフェイスを実装する型とは異なる型のインスタンスを返す機能\) を必要とする型はサポートされません。  
+  
+### DateTime ワイヤ形式  
+ <xref:System.DateTime> 値は、"\/Date\(700000\+0500\)\/" 形式の JSON 文字列として表されます。ここで、最初の数値 \(この例では 700000\) は GMT タイム ゾーンのミリ秒数であり、1970 年 1 月 1 日午前 0 時以降の \(夏時間ではなく\) 通常時間です。これより前の時間を表すために、この数値が負の値になる場合があります。この例の "\+0500" で構成される部分は省略可能であり、<xref:System.DateTimeKind> の時刻を示します。つまり、逆シリアル化時にローカル タイム ゾーンに変換される必要があります。この部分が指定されていない場合、時刻は <xref:System.DateTimeKind> として逆シリアル化されます。実際の数値 \(この例では "0500"\) と記号 \(\+ または \-\) は無視されます。  
+  
+ <xref:System.DateTime> をシリアル化すると、<xref:System.DateTimeKind> と <xref:System.DateTimeKind> の時刻はオフセットして書き込まれ、<xref:System.DateTimeKind> はオフセットせずに書き込まれます。  
+  
+ ASP.NET AJAX クライアントの JavaScript コードにより、このような文字列は JavaScript の `DateTime` インスタンスに自動的に変換されます。類似する形式で .NET の <xref:System.DateTime> 型ではない他の文字列が存在する場合、これらの文字列も変換されます。  
+  
+ 変換は、文字 "\/" をエスケープする場合 \(つまり、JSON が "\\\/Date\(700000\+0500\)\\\/" のような場合\) にのみ実行されます。このため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の JSON エンコーダー \(<xref:System.ServiceModel.WebHttpBinding> によって有効になります\) は、文字 "\/" を常にエスケープします。  
+  
+### JSON 文字列内の XML  
+  
+#### XmlElement  
+ <xref:System.Xml.XmlElement> は、ラップされずにそのままの状態でシリアル化されます。たとえば、\<abc\/\> を含む <xref:System.Xml.XmlElement> 型のデータ メンバー "x" は、次のように表されます。  
+  
+```  
+{"x":"<abc/>"}  
+```  
+  
+#### XmlNode の配列  
+ <xref:System.Xml.XmlNode> 型の <xref:System.Array> オブジェクトは、この型の標準のデータ コントラクト名前空間にある ArrayOfXmlNode という要素にラップされます。"x" が、"value" と空の要素ノード "M" を含む名前空間 "ns" にある、属性ノード "N" を含む配列である場合、次のように表されます。  
+  
+```  
+{"x":"<ArrayOfXmlNode xmlns=\"http://schemas.datacontract.org/2004/07/System.Xml\" a:N=\"value\" xmlns:a=\"ns\"><M/></ArrayOfXmlNode>"}  
+```  
+  
+ XmlNode 配列の先頭 \(他の要素の前\) にある空の名前空間の属性はサポートされません。  
+  
+#### XElement と DataSet を含む IXmlSerializable 型  
+ <xref:System.Runtime.Serialization.ISerializable> 型は、"コンテンツ型"、"DataSet 型"、および "要素型" に細分化されます。これらの型の定義については、「[データ コントラクトの XML および ADO.NET の種類](../../../../docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md)」を参照してください。  
+  
+ "コンテンツ" 型と "DataSet" 型は、前のセクションで説明した <xref:System.Xml.XmlNode> の <xref:System.Array> オブジェクトと同様にシリアル化されます。これらの型は、その型のデータ コントラクトの名前と名前空間に対応する名前と名前空間を持つ要素にラップされます。  
+  
+ <xref:System.Xml.Linq.XElement> などの "要素" 型は、このトピックで既に説明した <xref:System.Xml.XmlElement> と同様に、そのままの状態でシリアル化されます。  
+  
+### ポリモーフィズム  
+  
+#### 型情報の保持  
+ 前述のように、ポリモーフィズムは JSON でサポートされていますが、いくつかの制限があります。JavaScript は厳密に型指定されていない言語であるため、通常、型 ID は問題ではありません。ただし、JSON を使用して厳密に型指定されたシステム \(.NET\) と厳密に型指定されていないシステム \(JavaScript\) 間で通信する場合、型 ID を保持していると役立ちます。たとえば、"Square" と "Circle" というデータ コントラクト名を持つ型が "Shape" というデータ コントラクト名を持つ型から派生したとします。"Circle" が .NET から JavaScript に送信され、後で "Shape" を必要とする .NET メソッドに返された場合、該当のオブジェクトが本来は "Circle" であったことが .NET 側でわかれば役立ちます。そうでない場合、派生型に固有の情報 \("Circle" のデータ メンバー "radius" など\) が失われることがあります。  
+  
+ 型 ID を保持するために、複合型を JSON にシリアル化するときに "型ヒント" を追加できます。デシリアライザーはこのヒントを認識し、適切に動作します。"型ヒント" は、JSON のキーと値のペアです。キー名は "\_\_type" です \(2 つのアンダースコアの後に "type" という語が続きます\)。値は、"DataContractName:DataContractNamespace" 形式の JSON 文字列です \(最初のコロンまでが名前です\)。前述の例の "Circle" は、次のようにシリアル化できます。  
+  
+```  
+{"__type":"Circle:http://example.com/myNamespace","x":50,"y":70,"radius":10}  
+```  
+  
+ 型ヒントは、XML スキーマ インスタンス標準で定義された `xsi:type` 属性によく似ており、XML をシリアル化または逆シリアル化するときに使用されます。  
+  
+ "\_\_type" というデータ メンバーは、型ヒントと競合する可能性があるため、禁止されています。  
+  
+#### 型ヒントのサイズの削減  
+ JSON メッセージのサイズを縮小するために、既定のデータ コントラクト名前空間プレフィックス \(http:\/\/schemas.datacontract.org\/2004\/07\/\) は文字 "\#" に置き換えられます \(この置換を元に戻すことを可能にするために、エスケープ ルールが使用されます。名前空間が "\#" または "\\" で始まる場合、これらの文字に "\\" が追加されます\)。したがって、"Circle" が .NET の "MyApp.Shapes" 名前空間の型である場合、既定のデータ コントラクト名前空間は http:\/\/schemas.datacontract.org\/2004\/07\/MyApp になります。形状と JSON 表現は次のようになります。  
+  
+```  
+{"__type":"Circle:#MyApp.Shapes","x":50,"y":70,"radius":10}  
+```  
+  
+ 逆シリアル化時には、切り捨てられた名前 \(\#MyApp.Shapes\) と完全名 \(http:\/\/schemas.datacontract.org\/2004\/07\/MyApp.Shapes\) の両方が認識されます。  
+  
+#### JSON オブジェクト内での型ヒントの位置  
+ JSON 表現では、型ヒントは最初に出現する必要があります。JSON の処理でキーと値のペアの順序が重要となるのはこの場合だけです。たとえば、型ヒントの次の指定方法は無効です。  
+  
+```  
+{"x":50,"y":70,"radius":10,"__type":"Circle:#MyApp.Shapes"}  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が使用する <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> と ASP.NET AJAX クライアント ページでは、いずれも型ヒントが常に最初に出力されます。  
+  
+#### 複合型にのみ適用される型ヒント  
+ 複合型以外の型の型ヒントを出力する方法はありません。たとえば、戻り値の型が <xref:System.Object> である操作で Circle を返す場合、前に示したような JSON 表現が可能であり、型情報は保持されます。ただし、Uri が返される場合、JSON 表現は文字列であり、この文字列が Uri を表すために使用されているという情報は失われます。これは、プリミティブ型だけでなく、コレクションと配列にも適用されます。  
+  
+#### 型ヒントが出力される状況  
+ 型ヒントにより、メッセージ サイズが大幅に増加することがあります \(これを軽減する 1 つの方法として、可能であれば短いデータ コントラクト名前空間を使用します\)。そのため、次のルールによって型ヒントを出力するかどうかが制御されます。  
+  
+-   ASP.NET AJAX を使用する場合、基本型と派生型の割り当てが存在しない場合でも \(Circle を Circle に割り当てる場合など\)、型ヒントは可能である限り常に出力されます \(これは、厳密に型指定されていない JSON 環境から厳密に型指定された .NET 環境への呼び出しプロセスにおいて、情報が予想外に失われることのないプロセスを完全に実現するために必要です\)。  
+  
+-   ASP.NET と統合せずに AJAX サービスを使用する場合、基本型と派生型の割り当てが存在する場合にのみ、型ヒントが出力されます。つまり、Circle を Shape または <xref:System.Object> に割り当てるときは出力されますが、Circle に割り当てるときには出力されません。この場合、JavaScript クライアントを適切に実装するために必要な最小限の情報しか提供されないため、パフォーマンスは向上しますが、適切に設計されていないクライアントでの型情報の損失を防ぐことはできません。クライアントでこの問題に対処することを避ける必要がある場合は、サーバーで基本型と派生型の割り当てを一切行わないようにします。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> 型を使用する場合、`alwaysEmitTypeInformation` コンストラクター パラメーターを使用すると、上記の 2 つのモードのいずれかを選択できます。既定値は "`false`" \(必要な場合にのみ型情報を出力\) です。  
+  
+#### 重複するデータ メンバー名  
+ 派生型情報は、基本型情報と共に同じ JSON オブジェクト内に存在しますが、任意の順序で出現する場合があります。たとえば、`Shape` は次のように表されることがあります。  
+  
+```  
+{"__type":"Shape:#MyApp.Shapes","x":50,"y":70}  
+```  
+  
+ Circle は、次のように表されることがあります。  
+  
+```  
+{"__type":"Circle:#MyApp.Shapes","x":50, "radius":10,"y":70}  
+```  
+  
+ 基本型 `Shape` にも "`radius`" というデータ メンバーが含まれている場合、シリアル化と逆シリアル化の両方で競合が発生することになります。これは、シリアル化では JSON オブジェクトは反復するキー名を持つことができないためであり、逆シリアル化では "radius" が `Shape.radius` と `Circle.radius` のどちらを参照しているかが不明確であるためです。そのため、データ コントラクト クラスでは、"プロパティの隠ぺい" \(基本クラスと派生クラスに同じ名前のデータ メンバーが存在する\) という概念は一般に推奨されていませんが、JSON では実際には禁止されています。  
+  
+#### ポリモーフィズムと IXmlSerializable 型  
+ <xref:System.Xml.Serialization.IXmlSerializable> 型は、既知の型の要件を満たしている限り、通常のデータ コントラクト規則に従って、通常どおり相互にポリモーフィックな割り当てを行うことができます。ただし、<xref:System.Object> の代わりに <xref:System.Xml.Serialization.IXmlSerializable> 型をシリアル化すると、結果が JSON 文字列になるため、型情報が失われることになります。  
+  
+#### ポリモーフィズムと一部のインターフェイス型  
+ <xref:System.Xml.Serialization.IXmlSerializable> ではないコレクション型以外の型 \(<xref:System.Object> を除きます\) が必要な場合、コレクション型または <xref:System.Xml.Serialization.IXmlSerializable> を実装する型をシリアル化することは禁止されています。たとえば、`IMyInterface` というカスタム インターフェイスと、`int` 型の <xref:System.Collections.Generic.IEnumerable%601> と `IMyInterface` の両方を実装する `MyType` 型があるとします。この場合、戻り値の型が `IMyInterface` である操作から、`MyType` を返すことは禁止されています。これは、`MyType` は JSON 配列としてシリアル化する必要があり、型ヒントを必要としますが、前述のように型ヒントを配列と共に含めることはできないためです。型ヒントを含めることができるのは、複合型を使用する場合だけです。  
+  
+#### 既知の型と構成  
+ <xref:System.Runtime.Serialization.DataContractSerializer> が使用する既知の型機構は、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> の場合と同様にすべてサポートされます。両方のシリアライザーが同じ構成要素 \([\<system.runtime.serialization\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-runtime-serialization.md) の [\<dataContractSerializer\>](../../../../docs/framework/configure-apps/file-schema/wcf/datacontractserializer-of-system-runtime-serialization.md)\) を読み取って、構成ファイルを通じて追加された既知の型を検出します。  
+  
+#### Object に割り当てられたコレクション  
+ Object に割り当てられたコレクションは、<xref:System.Collections.Generic.IEnumerable%601> を実装するコレクションと同様にシリアル化されます。複合型の場合は、各エントリに型ヒントが含まれた JSON 配列になります。たとえば、<xref:System.Object> に割り当てられた `Shape` 型の <xref:System.Collections.Generic.List%601> は、次のようになります。  
+  
+```  
+[{"__type":"Shape:#MyApp.Shapes","x":50,"y":70},  
+{"__type":"Shape:#MyApp.Shapes","x":58,"y":73},  
+{"__type":"Shape:#MyApp.Shapes","x":41,"y":32}]  
+```  
+  
+ <xref:System.Object> に逆シリアル化するときは、次の点に注意してください。  
+  
+-   `Shape` は、既知の型リストに含まれている必要があります。既知の型に含まれている `Shape` 型の <xref:System.Collections.Generic.List%601> があっても効果はありません。この場合、シリアル化時に `Shape` を既知の型に追加する必要はありません。これは、自動的に実行されます。  
+  
+-   コレクションは、`Shape` インスタンスを格納する <xref:System.Object> 型の <xref:System.Array> として逆シリアル化されます。  
+  
+#### 基本コレクションに割り当てられた派生コレクション  
+ 派生コレクションを基本コレクションに割り当てると、通常、そのコレクションは基本型のコレクションと同様にシリアル化されます。ただし、派生コレクションの項目の型を基本コレクションの項目の型に割り当てることができない場合は、例外がスローされます。  
+  
+#### 型ヒントとディクショナリ  
+ ディクショナリを <xref:System.Object> に割り当てると、ディクショナリに含まれる Key および Value の各エントリは、<xref:System.Object> に割り当てられている場合と同様に処理され、型ヒントを取得します。  
+  
+ ディクショナリ型をシリアル化した場合、"Key" メンバーと "Value" メンバーを含む JSON オブジェクトは、`alwaysEmitTypeInformation` 設定の影響を受けません。オブジェクトに型ヒントが含まれるのは、前述のコレクション ルールで必要とされる場合だけです。  
+  
+### JSON の有効なキー名  
+ シリアライザーは、有効な XML 名ではないキー名を XML エンコードします。たとえば、"123" という名前のデータ メンバーの場合、"123" は無効な XML 要素名 \(数字で始まる要素名\) であるため、"\_x0031\_\_x0032\_\_x0033\_" のような名前にエンコードされます。XML 名が有効ではない一部の国際文字セットでも、同様の状況が発生する場合があります。JSON 処理に対する XML のこの影響については、「[JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)」を参照してください。  
+  
+## 参照  
+ [JSON などのデータ転送形式のサポート](../../../../docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/standard-endpoints.md b/docs/framework/wcf/feature-details/standard-endpoints.md
new file mode 100644
index 00000000000..91bbcc86869
--- /dev/null
+++ b/docs/framework/wcf/feature-details/standard-endpoints.md
@@ -0,0 +1,203 @@
+---
+title: "標準エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3fcb4225-addc-44f2-935d-30e4943a8812
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 標準エンドポイント
+エンドポイントは、アドレス、バインディング、およびコントラクトを指定して定義します。エンドポイントに設定できるその他のパラメーターには、動作構成、ヘッダー、リッスン URI などがあります。特定の種類のエンドポイントでは、これらの値が変化しません。たとえば、メタデータ交換エンドポイントでは、常に <xref:System.ServiceModel.Description.IMetadataExchange> コントラクトを使用します。<xref:System.ServiceModel.Web.WebHttpEndpoint> などのその他のエンドポイントでは、指定されたエンドポイント動作が必要です。一般的に使用されるエンドポイント プロパティの既定の値を設定することによって、エンドポイントの操作性を向上させることができます。開発者は、標準エンドポイントを使用して、既定値を持つエンドポイント、またはエンドポイントの 1 つ以上のプロパティが変化しないエンドポイントを定義できます。これらのエンドポイントによって、静的な性質の情報を指定する必要がないエンドポイントの使用が可能になります。標準エンドポイントは、インフラストラクチャ エンドポイントおよびアプリケーション エンドポイントに使用できます。  
+  
+## インフラストラクチャ エンドポイント  
+ サービスの作成者が明示的に実装していないいくつかのプロパティを持つエンドポイントを、サービスが公開することがあります。たとえば、メタデータ交換エンドポイントは <xref:System.ServiceModel.Description.IMetadataExchange> コントラクトを公開しますが、そのインターフェイスを実装するのは、サービスの作成者ではなく、WCF です。このようなインフラストラクチャ エンドポイントには、1 つ以上のプロパティの既定値があり、そのいくつかは変更できません。メタデータ交換エンドポイントの <xref:System.ServiceModel.Description.ServiceEndpoint.Contract%2A> プロパティは <xref:System.ServiceModel.Description.IMetadataExchange> である必要がありますが、バインディングなど、その他のプロパティは開発者が提供できます。インフラストラクチャ エンドポイントは、<xref:System.ServiceModel.Description.ServiceEndpoint.IsSystemEndpoint%2A> プロパティを `true` に設定することによって識別されます。  
+  
+## アプリケーション エンドポイント  
+ アプリケーション開発者は独自の標準エンドポイントを定義でき、このエンドポイントでアドレス、バインディング、またはコントラクトの既定値が指定されます。標準エンドポイントを定義するには、<xref:System.ServiceModel.Description.ServiceEndpoint> からクラスを派生させ、適切なエンドポイント プロパティを設定します。変更可能な既定値をプロパティに設定できます。他のいくつかのプロパティには、変更できない静的な値が設定されます。次の例は、標準エンドポイントの実装方法を示しています。  
+  
+```  
+public class CustomEndpoint : ServiceEndpoint  
+    {  
+        public CustomEndpoint()  
+            : this(string.Empty)  
+        {  
+        }  
+  
+        public CustomEndpoint(string address)  
+            : this(address, ContractDescription.GetContract(typeof(ICalculator)))  
+        {  
+        }  
+  
+        // Create the custom endpoint with a fixed binding  
+        public CustomEndpoint(string address, ContractDescription contract)  
+            : base(contract)  
+        {  
+            this.Binding = new BasicHttpBinding();  
+            this.IsSystemEndpoint = false;  
+        }  
+  
+        // Definition of the additional property of this endpoint  
+        public bool Property  
+        {  
+            get;  
+            set;  
+        }  
+    }  
+```  
+  
+ ユーザー定義のカスタム エンドポイントを構成ファイルで使用するには、<xref:System.ServiceModel.Configuration.StandardEndpointElement> から 1 つのクラスを派生させ、<xref:System.ServiceModel.Configuration.StandardEndpointCollectionElement> から 1 つのクラスを派生させて、新しい標準エンドポイントを app.config または machine.config の拡張セクションに登録します。<xref:System.ServiceModel.Configuration.StandardEndpointElement> は、次の例に示すように、標準エンドポイントの構成サポートを提供します。  
+  
+```  
+public class CustomEndpointElement : StandardEndpointElement  
+    {  
+        // Definition of the additional property for the standard endpoint element  
+        public bool Property  
+        {  
+            get { return (bool)base["property"]; }  
+            set { base["property"] = value; }  
+        }  
+  
+        // The additional property needs to be added to the properties of the standard endpoint element  
+        protected override ConfigurationPropertyCollection Properties  
+        {  
+            get  
+            {  
+                ConfigurationPropertyCollection properties = base.Properties;  
+                properties.Add(new ConfigurationProperty("property", typeof(bool), false, ConfigurationPropertyOptions.None));  
+                return properties;  
+            }  
+        }  
+  
+        // Return the type of this standard endpoint  
+        protected override Type EndpointType  
+        {  
+            get { return typeof(CustomEndpoint); }  
+        }  
+  
+        // Create the custom service endpoint  
+        protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contract)  
+        {  
+            return new CustomEndpoint();  
+        }  
+  
+        // Read the value given to the property in config and save it  
+        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)  
+        {  
+            CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;  
+            customEndpoint.Property = this.Property;  
+        }  
+  
+        // Read the value given to the property in config and save it  
+        protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)  
+        {  
+            CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;  
+            customEndpoint.Property = this.Property;  
+        }  
+  
+        // No validation in this sample  
+        protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)  
+        {  
+        }  
+  
+        // No validation in this sample  
+        protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)  
+        {  
+        }  
+    }  
+  
+```  
+  
+ <xref:System.ServiceModel.Configuration.StandardEndpointCollectionElement> は、標準エンドポイントの構成の \<`standardEndpoints`\> セクションの下に表示されるコレクションのバッキング型を提供します。次の例は、このクラスを実装する方法を示しています。  
+  
+```  
+public class CustomEndpointCollectionElement : StandardEndpointCollectionElement<CustomEndpoint, CustomEndpointElement>  
+    {  
+         // ...  
+  
+    }  
+```  
+  
+ 次の例は、拡張セクションで標準エンドポイントを登録する方法を示しています。  
+  
+```  
+<extensions>  
+      <standardEndpointExtensions>  
+        <add  
+          name="customStandardEndpoint"  
+          type="CustomEndpointCollectionElement, Example.dll,  
+                Version=1.0.0.0, Culture=neutral, PublicKeyToken=ffffffffffffffff"/>  
+  
+```  
+  
+## 標準エンドポイントの構成  
+ 標準エンドポイントは、コードまたは構成で追加できます。標準エンドポイントをコードで追加するには、次の例に示すように、適切な標準エンドポイントの種類をインスタンス化し、それをサービス ホストに追加します。  
+  
+```csharp  
+serviceHost.AddServiceEndpoint(new CustomEndpoint());  
+```  
+  
+ 標準エンドポイントを構成で追加するには、\<`endpoint`\> 要素を、\<`service`\> 要素、および \<`standardEndpoints`\> 要素内の必要な構成設定に追加します。次の例は、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> を追加する方法を示しています。これは、[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] に付属する標準エンドポイントのいずれかです。  
+  
+```xml  
+<services>  
+  <service>  
+    <endpoint isSystemEndpoint=”true” kind=”udpDiscoveryEndpoint” />  
+  </service>  
+</services>  
+<standardEndpoints>    
+  <udpDiscoveryEndpoint>  
+     <standardEndpoint multicastAddress="soap.udp://239.255.255.250:3702" />   
+  </udpDiscoveryEndpoint>  
+</ standardEndpoints >  
+```  
+  
+ 標準エンドポイントの種類は、\<`endpoint`\> 要素の種類属性を使用して指定します。エンドポイントは、\<`standardEndpoints`\> 要素内で構成されます。前の例では、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> エンドポイントが追加され、構成されます。\<`udpDiscoveryEndpoint`\> 要素は、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> の <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint.MulticastAddress%2A> プロパティを設定する \<`standardEndpoint`\> を格納します。  
+  
+## .NET Framework に付属する標準エンドポイント  
+ 次の表は、[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] に付属する標準エンドポイントを示しています。  
+  
+ `Mex Endpoint`  
+ サービス メタデータの公開に使用する標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Discovery.AnnouncementEndpoint>  
+ サービスがアナウンス メッセージを送信するために使用する標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryEndpoint>  
+ サービスが探索メッセージを送信するために使用する標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>  
+ UDP マルチキャスト バインディング上での探索操作用に事前構成済みの標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint>  
+ サービスが UDP バインディングでアナウンス メッセージを送信するために使用する標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Discovery.DynamicEndpoint>  
+ 実行時にエンドポイント アドレスを動的に検索するために WS\-Discovery を使用する標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Description.ServiceMetadataEndpoint>  
+ メタデータ交換用の標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Description.WebHttpEndpoint>  
+ <xref:System.ServiceModel.Description.WebHttpBehavior> の動作を自動的に追加する <xref:System.ServiceModel.WebHttpBinding> バインディングを持つ標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Description.WebScriptEndpoint>  
+ <xref:System.ServiceModel.Description.WebScriptEnablingBehavior> の動作を自動的に追加する <xref:System.ServiceModel.WebHttpBinding> バインディングを持つ標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Description.WebServiceEndpoint>  
+ <xref:System.ServiceModel.WebHttpBinding> バインディングを持つ標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Activities.WorkflowControlEndpoint>  
+ ワークフロー インスタンスでの制御操作の呼び出しを可能にする標準エンドポイント。  
+  
+ <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint>  
+ ワークフローの作成とブックマークの再開をサポートする標準エンドポイント。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md b/docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md
new file mode 100644
index 00000000000..fc6304e83b4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21093451-0bc3-4b1a-9a9d-05f7f71fa7d0
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する
+<xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるデータ型を使用するサービスおよびクライアント アプリケーションは、実行時にこのようなデータ型のシリアル化コードを生成およびコンパイルします。このため、起動時のパフォーマンスが低下することがあります。  
+  
+> [!NOTE]
+>  事前生成済みシリアル化コードはクライアント アプリケーションでのみ使用できます。サービスでは使用できません。  
+  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すると、必要なシリアル化コードをアプリケーションのコンパイル済みアセンブリから生成することで、このようなアプリケーションの起動時のパフォーマンスを改善できます。Svcutil.exe は、<xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるコンパイル済みアプリケーション アセンブリに格納されたサービス コントラクトで使用されるすべてのデータ型に対して、シリアル化コードを生成します。<xref:System.Xml.Serialization.XmlSerializer> を使用するサービスおよび操作コントラクトは、<xref:System.ServiceModel.XmlSerializerFormatAttribute> でマークされます。  
+  
+### XmlSerializer シリアル化コードを生成するには  
+  
+1.  サービスまたはクライアント コードを 1 つ以上のアセンブリにコンパイルします。  
+  
+2.  SDK コマンド プロンプトを開きます。  
+  
+3.  コマンド プロンプトで、次の形式を使用して Svcutil.exe ツールを起動します。  
+  
+    ```  
+    svcutil.exe /t:xmlSerializer  <assemblyPath>*  
+    ```  
+  
+     `assemblyPath` 引数には、サービス コントラクト型を格納するアセンブリへのパスを指定します。Svcutil.exe は、<xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるコンパイル済みアプリケーション アセンブリに格納されたサービス コントラクトで使用されるすべてのデータ型に対して、シリアル化コードを生成します。  
+  
+     Svcutil.exe は、C\# のシリアル化コードのみを生成できます。入力アセンブリごとに、1 つのソース コード ファイルが生成されます。生成されるコードの言語を変更するために、**\/language** スイッチを使用することはできません。  
+  
+     依存アセンブリへのパスを指定するには、**\/reference** オプションを使用します。  
+  
+4.  次のオプションのいずれかを使用して、生成したシリアル化コードをアプリケーションから利用できるようにします。  
+  
+    1.  生成されたシリアル化コードを \[*original assembly*\].XmlSerializers.dll という名前 \(たとえば、MyApp.XmlSerializers.dll\) で別個のアセンブリにコンパイルします。アプリケーションがアセンブリを読み込むことができ、アセンブリが元のアセンブリと同じキーで署名されている必要があります。元のアセンブリを再コンパイルする場合は、シリアル化アセンブリも再生成する必要があります。  
+  
+    2.  生成されたシリアル化コードを別個のアセンブリにコンパイルし、<xref:System.ServiceModel.XmlSerializerFormatAttribute> を使用するサービス コントラクトで <xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute> を使用します。<xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute.AssemblyName%2A> プロパティまたは <xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute.CodeBase%2A> プロパティが、コンパイル済みのシリアル化アセンブリを指すように設定します。  
+  
+    3.  生成されたシリアル化コードをアプリケーション アセンブリにコンパイルし、<xref:System.ServiceModel.XmlSerializerFormatAttribute> を使用するサービス コントラクトに <xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute> を追加します。<xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute.AssemblyName%2A> プロパティおよび <xref:System.Xml.Serialization.XmlSerializerAssemblyAttribute.CodeBase%2A> プロパティは設定しないでください。既定のシリアル化アセンブリが現在のアセンブリであると見なされます。  
+  
+## 使用例  
+ 次のコマンドにより、アセンブリに含まれているサービス コントラクトが使用する `XmlSerializer` 型用のシリアル化型を生成します。  
+  
+```  
+svcutil /t:xmlserializer myContractLibrary.exe  
+```  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/streaming-message-transfer.md b/docs/framework/wcf/feature-details/streaming-message-transfer.md
new file mode 100644
index 00000000000..6e0901af0f9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/streaming-message-transfer.md
@@ -0,0 +1,57 @@
+---
+title: "メッセージ転送ストリーミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72a47a51-e5e7-4b76-b24a-299d51e0ae5a
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# メッセージ転送ストリーミング
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランスポートでは、メッセージを転送するための次の 2 つのモードをサポートしています。  
+  
+-   バッファー転送では、転送が完了するまで、メッセージ全体がメモリ バッファーに保持されます。受信側がメッセージを読み取るためには、バッファー内のメッセージが完全に配信される必要があります。  
+  
+-   ストリーミング転送では、ストリームとしてメッセージが公開されます。受信側は、メッセージが完全に配信される前にメッセージの処理を開始できます。  
+  
+-   ストリーミング転送では、大容量のメモリ バッファーが不要なため、サービスのスケーラビリティを向上できます。転送モードを変更することによってスケーラビリティが向上するかどうかは、転送されるメッセージのサイズによって決まります。メッセージのサイズが大きい場合は、ストリーム転送の使用をお勧めします。  
+  
+ 既定では、HTTP、TCP\/IP、および名前付きパイプの各トランスポートはバッファー転送を使用します。ここでは、これらのトランスポートをバッファー転送モードからストリーミング転送モードに切り替える方法と、その結果について説明します。  
+  
+## ストリーミング転送の有効化  
+ バッファー転送モードとストリーミング転送モードは、トランスポートのバインド要素で切り替えます。バインド要素には、<xref:System.ServiceModel.TransferMode> プロパティがあり、`Buffered`、`Streamed`、`StreamedRequest`、または `StreamedResponse` に設定できます。転送モードを `Streamed` に設定すると、両方向のストリーミング通信が可能になります。転送モードを `StreamedRequest` または `StreamedResponse` に設定すると、指定した方向のストリーミング通信だけが有効になります。  
+  
+ <xref:System.ServiceModel.BasicHttpBinding>、<xref:System.ServiceModel.NetTcpBinding>、および <xref:System.ServiceModel.NetNamedPipeBinding> の各バインディングは、<xref:System.ServiceModel.TransferMode> プロパティを公開します。他のトランスポートの場合、転送モードを設定するにはカスタム バインディングを作成する必要があります。  
+  
+ バッファー転送とストリーミング転送のどちらを使用するかは、エンドポイントでローカルに決定します。HTTP トランスポートの場合、転送モードは、接続、つまりサーバーなどの中継局に伝達されません。転送モードの設定は、サービス インターフェイスの記述に反映されません。サービスに対してクライアント クラスを生成した後、ストリーミング転送で使用する予定のサービスの構成ファイルを編集し、転送モードを設定する必要があります。TCP トランスポートと名前付きパイプ トランスポートの場合、転送モードはポリシー アサーションとして伝達されます。  
+  
+ コード例については、「[方法 : ストリーミングを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-streaming.md)」を参照してください。  
+  
+## 非同期ストリーミングの有効化  
+ 非同期ストリーミングを有効にするには、エンドポイントの <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior> 動作をサービス ホストに追加し、<xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior.AsynchronousSendEnabled%2A> プロパティを `true` に設定します。  
+  
+ WCF のこのバージョンでは、ほかにも送信側の実際の非同期ストリーミング機能が追加されています。これによって、多数のクライアントにメッセージをストリーム出力するシナリオで、一部のクライアントがネットワークの混雑があるために読み取りが遅いか、読み取りがまったくない場合に、サービスのスケーラビリティを向上します。このようなシナリオでは、WCF はクライアントごとのサービスの個別のスレッドをブロックしません。サービスはこれによってこれまで以上のクライアントを処理できるようになり、スケーラビリティが向上します。  
+  
+## ストリーミング転送の制限  
+ ストリーミング転送モードを使用すると、ランタイムによって追加の制限が適用されます。  
+  
+ ストリーミングされたトランスポートで発生する操作は、最大で 1 つの入力パラメーターまたは出力パラメーターが指定されたコントラクトを持つことができます。設定するパラメーターは、メッセージの本文全体に対応し、<xref:System.ServiceModel.Channels.Message>、 <xref:System.IO.Stream> の派生型、または <xref:System.Xml.Serialization.IXmlSerializable> 実装であることが必要です。操作の戻り値を取得することは、出力パラメーターを取得することと同じです。  
+  
+ 信頼できるメッセージング、トランザクション、SOAP メッセージ レベルのセキュリティなど、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の一部の機能は転送メッセージのバッファー処理に依存しています。これらの機能を使用すると、ストリーミングによって得られるパフォーマンス上の利点が減少したり、失われたりする可能性があります。ストリーミングされたトランスポートをセキュリティで保護する場合は、トランスポート レベルのセキュリティだけを使用するか、または、トランスポート レベルのセキュリティと認証のみのメッセージ セキュリティを組み合わせて使用してください。  
+  
+ SOAP ヘッダーは、転送モードがストリーミングに設定されている場合でも、必ずバッファーされます。メッセージのヘッダーが `MaxBufferSize` トランスポート クォータのサイズを超えないようにしてください。この設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポート クォータ](../../../../docs/framework/wcf/feature-details/transport-quotas.md)」を参照してください。  
+  
+## バッファー転送とストリーミング転送の違い  
+ 転送モードをバッファーからストリーミングに変更すると、TCP トランスポートと名前付きパイプ トランスポートのネイティブなチャネル形状も変更されます。バッファー転送では、ネイティブなチャネル形状は <xref:System.ServiceModel.Channels.IDuplexSessionChannel> です。ストリーム転送では、ネイティブなチャネル形状は <xref:System.ServiceModel.Channels.IRequestChannel> と <xref:System.ServiceModel.Channels.IReplyChannel> です。これらのトランスポートを直接 \(つまり、サービス コントラクトを介さずに\) 使用する既存のアプリケーションで転送モードを変更するには、チャネル ファクトリおよびリスナーの予測されるチャネル形状を変更する必要があります。  
+  
+## 参照  
+ [方法 : ストリーミングを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-streaming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md b/docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md
new file mode 100644
index 00000000000..4a447604b94
--- /dev/null
+++ b/docs/framework/wcf/feature-details/support-for-json-and-other-data-transfer-formats.md
@@ -0,0 +1,34 @@
+---
+title: "JSON などのデータ転送形式のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a527f1be-4e37-4beb-9a95-291480d19627
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# JSON などのデータ転送形式のサポート
+JSON \(JavaScript Object Notation\) は、クライアント ブラウザーと AJAX \(Asynchronous JavaScript and XML\) 対応の Web サービスとの間で少量のデータを高速に交換できる効率的なデータ エンコード形式です。  
+  
+## このセクションの内容  
+ [スタンドアロン JSON のシリアル化](../../../../docs/framework/wcf/feature-details/stand-alone-json-serialization.md)  
+ スタンドアロン JSON のシリアル化について説明します。  
+  
+ [方法 : JSON データをシリアル化および逆シリアル化する](../../../../docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md)  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用して .NET 型のオブジェクトを JSON エンコードされたデータにシリアル化し、この JSON 形式のデータを .NET 型のインスタンスに戻すために逆シリアル化する方法について説明します。  
+  
+ [JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)  
+ JSON \(JavaScript Object Notation\) エンコードと、JSON エンコードされたデータおよびドキュメントを表すために [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 内部で使用される XML Infoset との関連について説明します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>   
+ <xref:System.Runtime.Serialization.Json.JsonReaderWriterFactory>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/supported-deployment-scenarios.md b/docs/framework/wcf/feature-details/supported-deployment-scenarios.md
new file mode 100644
index 00000000000..8fcc26f44a7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/supported-deployment-scenarios.md
@@ -0,0 +1,53 @@
+---
+title: "サポートされている配置シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3399f208-3504-4c70-a22e-a7c02a8b94a6
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# サポートされている配置シナリオ
+部分的に信頼されたアプリケーションでの使用のために用意されている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 機能のサブセットは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用するための一部のシナリオ \(全部ではありません\) の要件を満たすように作成されています。 サーバーでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、セキュリティの理由により [!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] の中程度の信頼アクセス許可セットでサードパーティ製アプリケーションを実行するインターネット規模の共有ホスティング プロバイダーの要件を満たします。 クライアントでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の部分信頼サポート機能は、[ClickOnce 展開](http://go.microsoft.com/fwlink/?LinkId=83712)または [!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] の XAML ブラウザー アプリケーション \(XBAP\) テクノロジなどの展開技術の要件を満たすように設計されています。これらの技術は、信頼できないサイトからシームレスかつ安全にデスクトップ アプリケーションを展開できるようにするためのものです。  
+  
+## 最小のアクセス許可の要件  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、次の標準の名前付きアクセス許可セットのいずれかで実行されるアプリケーションの機能のサブセットをサポートします。  
+  
+-   中程度の信頼アクセス許可  
+  
+-   インターネット ゾーン アクセス許可  
+  
+ これよりも制限の厳しいアクセス許可が設定された部分信頼アプリケーションで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、実行時にセキュリティ例外が発生することがあります。  
+  
+ このようなアクセス許可セットでサポートされる機能の詳細については、「[部分信頼機能の互換性](../../../../docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md)」を参照してください。  
+  
+## サーバーでの部分信頼  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーション ホスティング サービスのプロバイダー事業者の多くは、それぞれのサーバーで動作するアプリケーションが [!INCLUDE[vstecasplong](../../../../includes/vstecasplong-md.md)] の中程度の信頼アクセス許可セットを使用して実行されることを義務付けています。 その業者がトランスポートレベルのセキュリティで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]、<xref:System.ServiceModel.BasicHttpBinding>、または <xref:System.ServiceModel.WebHttpBinding> を使用する場合、<xref:System.ServiceModel.WsHttpBinding> サービスは、このような環境で動作します。  
+  
+ 信頼レベルが中程度のホスティング環境で動作する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、クライアント要求に応じて他のサーバーにメッセージを送信することによって、中間層サービスとして動作することもできます。 ホスティング環境が適切な <xref:System.Net.WebPermission> をアプリケーションに与えて、目的のサーバーに送信要求を行うようにする場合は、サーバーでの中間層のシナリオがサポートされます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、サポートされる SOAP バインディングのいずれか 1 つを使用する SOAP メッセージングの他にも、部分的に信頼されたアプリケーションで Web スタイルのサービスを構築するための <xref:System.ServiceModel.WebHttpBinding> をサポートします。 部分信頼では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)、[WCF 配信](../../../../docs/framework/wcf/feature-details/wcf-syndication.md)、および [AJAX の統合と JSON のサポート](../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md) の各機能がすべてサポートされます。  
+  
+ ワークフロー サービスは完全信頼のアクセス許可を必要とし、部分的に信頼されたアプリケーションでは使用できません。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [How To: ASP.NET 2.0 で中程度の信頼を使用する方法](http://go.microsoft.com/fwlink/?LinkId=84603)」を参照してください。  
+  
+## クライアントでの部分信頼  
+ 信頼されていないインターネット サイトからコードをダウンロードして実行する場合、ある程度のセキュリティ対策が必要です。[ClickOnce 展開](http://go.microsoft.com/fwlink/?LinkId=83712)と [!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] の XBAP テクノロジでは共に、部分信頼を利用して信頼できないコードに制限付きのアクセス許可 \(インターネット ゾーン\) を与えます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、[ClickOnce 展開](http://go.microsoft.com/fwlink/?LinkId=83712)または XBAP によって展開された部分信頼のアプリケーション内からリモート サーバーと通信するときに使用できます。 インターネット ゾーン アクセス許可セットには、元のホスト用の <xref:System.Net.WebPermission> が含まれます。これにより、このようなアプリケーションは、サポートされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインディングのいずれかを使用してそれぞれの元のサーバーと通信できます \(「[部分信頼機能の互換性](../../../../docs/framework/wcf/feature-details/partial-trust-feature-compatibility.md)」を参照\)。  
+  
+## 参照  
+ [コード アクセス セキュリティ](http://go.microsoft.com/fwlink/?LinkId=83717)   
+ [Windows Presentation Foundation ブラウザーによってホストされるアプリケーションの概要](http://go.microsoft.com/fwlink/?LinkId=98397)   
+ [部分信頼](../../../../docs/framework/wcf/feature-details/partial-trust.md)   
+ [ASP.NET の中程度の信頼](http://go.microsoft.com/fwlink/?LinkId=69328)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/supporting-multiple-iis-site-bindings.md b/docs/framework/wcf/feature-details/supporting-multiple-iis-site-bindings.md
new file mode 100644
index 00000000000..635f7e6d5c2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/supporting-multiple-iis-site-bindings.md
@@ -0,0 +1,37 @@
+---
+title: "複数の IIS サイト バインディングのサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 40440495-254d-45c8-a8c6-b29f364892ba
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 複数の IIS サイト バインディングのサポート
+インターネット インフォメーション サービス \(IIS: Internet Information Services\) 7.0 で [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストする場合は、同じサイトで同じプロトコルを使用する、複数のベース アドレスを提供できます。これにより、同じサービスで多数の異なる URI に応答できます。http:\/\/www.contoso.com および http:\/\/contoso.com でリッスンするサービスをホストするときには、これが役立ちます。また、内部ユーザー用に 1 つのベース アドレスを持ち、外部ユーザー用に別のベース アドレスを持つサービスを作成するのにも役立ちます。たとえば、http:\/\/internal.contoso.com および http:\/\/www.contoso.com というベース アドレスを持つ場合があります。  
+  
+> [!NOTE]
+>  この機能は、HTTP プロトコルを使用してのみ、使用可能です。  
+  
+## 複数のベース アドレス  
+ この機能は、IIS でホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでのみ使用可能です。この機能は、既定では有効にされません。有効にするには、次の例に示すように、Web.config ファイルで `multipleSiteBindingsEnabled` 属性を \<`serviceHostingEnvironment`\> 要素に追加し、`true` に設定します。  
+  
+```xml  
+<serviceHostingEnvironment multipleSiteBindingsEnabled=”true”/>  
+```  
+  
+ IIS で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする場合、IIS では、アプリケーションを格納している仮想ディレクトリへの URI に基づいて、1 つのベース アドレスが作成されます。インターネット インフォメーション サービス マネージャーを使用して、同じプロトコルを使用するベース アドレスを追加し、1 つ以上のバインディングを Web サイトに追加できます。それぞれのバインディングに対して、プロトコル \(HTTP または HTTPS\)、IP アドレス、ポート、およびホスト名を指定します。インターネット インフォメーション サービス マネージャーの使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[IIS マネージャー \(IIS 7\)](http://go.microsoft.com/fwlink/?LinkId=164057)」を参照してください。サイトへのバインディングの追加[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Web サイトを作成する \(IIS 7\)](http://go.microsoft.com/fwlink/?LinkId=164060)」を参照してください。  
+  
+ 同じサイトに複数のベース アドレスを指定すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のヘルプ ページ、スキーマのインポート、サービスによって生成される WSDL\/MEX 情報に影響が生じます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のヘルプ ページには、サービスと通信できる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの生成に使用する、コマンド ラインが表示されます。このコマンド ラインには、その Web サイト用の IIS バインディングで指定された最初のアドレスだけが含まれています。同様に、スキーマをインポートするときには、IIS バインディングで指定された最初のベース アドレスだけが使用されます。WSDL および MEX データには、IIS バインディングで指定されたすべてのベース アドレスが含まれています。  
+  
+> [!WARNING]
+>  つまり、サービスに 2 つのベース アドレス \(1 つは内部ユーザー用、もう 1 つは外部ユーザー用\) がある場合、サービスによって生成される WSDL\/MEX 情報では、両方のベース アドレスが指定されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/syndication-extensibility.md b/docs/framework/wcf/feature-details/syndication-extensibility.md
new file mode 100644
index 00000000000..168aace7e17
--- /dev/null
+++ b/docs/framework/wcf/feature-details/syndication-extensibility.md
@@ -0,0 +1,56 @@
+---
+title: "配信の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d941175-74a2-4b15-81b3-086e8a95d25f
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 配信の拡張
+配信 API は、形式に依存せず、さまざま形式で概要コンテンツをネットワークに書き込むことができるプログラミング モデルを提供することを目的としています。抽象データ モデルは、次のクラスで構成されています。  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationCategory>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationFeed>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationItem>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationLink>  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationPerson>  
+  
+ これらのクラスは、一部の名前が異なっていますが、Atom 1.0 仕様に規定されるコンストラクトに厳密にマップされています。  
+  
+ 配信プロトコルの主な機能は拡張性です。Atom 1.0 と RSS 2.0 のどちらも、仕様で定義されていない属性と要素を配信フィードに追加できます。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の配信プログラミング モデルには、カスタム属性と拡張機能を扱う方法として、次のように、弱い型指定のアクセスと新しいクラスの派生が用意されています。  
+  
+## 弱い型指定のアクセス  
+ 新しいクラスの派生によって拡張機能を追加するには、追加のコードを記述する必要があります。別の方法として、弱い型指定で拡張機能にアクセスする方法もあります。配信抽象データ モデルに定義される型にはすべて、`AttributeExtensions` および `ElementExtensions` という名前のプロパティが含まれます。ただし、<xref:System.ServiceModel.Syndication.SyndicationContent> には `AttributeExtensions` プロパティがありますが、`ElementExtensions` プロパティはありません。この 2 つのプロパティはそれぞれ、`TryParseAttribute` メソッドと `TryParseElement` メソッドで処理されない拡張機能のコレクションです。この処理されない拡張機能にアクセスするには、<xref:System.ServiceModel.Syndication.SyndicationFeed>、<xref:System.ServiceModel.Syndication.SyndicationItem>、<xref:System.ServiceModel.Syndication.SyndicationLink>、<xref:System.ServiceModel.Syndication.SyndicationPerson>、および <xref:System.ServiceModel.Syndication.SyndicationCategory> の `ElementExtensions` プロパティで <xref:System.ServiceModel.Syndication.SyndicationElementExtensionCollection.ReadElementExtensions%2A?displayProperty=fullName> を呼び出します。このメソッドのセットは、指定した名前と名前空間を持つ拡張機能をすべて検索し、個別に `TExtension` のインスタンスに逆シリアル化して `TExtension` オブジェクトのコレクションとして返します。  
+  
+## 新しいクラスの派生  
+ 任意の既存抽象データ モデル クラスから、新しいクラスを派生できます。これは、対象フィードのほとんどに特定の拡張機能が含まれるアプリケーションを実装する際に行います。このトピックでは、プログラムで処理するフィードのほとんどに、`MyExtension` 拡張機能が含まれています。プログラミング性を向上するには、次の手順を実行します。  
+  
+-   拡張機能データを保持するクラスを作成します。この場合、MyExtension というクラスを作成します。  
+  
+-   プログラミング性を向上するには、<xref:System.ServiceModel.Syndication.SyndicationItem> から MyExtensionItem というクラスを派生させ、MyExtension 型のプロパティを公開します。  
+  
+-   MyExtensionItem クラスの <xref:System.ServiceModel.Syndication.SyndicationItem.TryParseElement%28System.Xml.XmlReader%2CSystem.String%29> をオーバーライドし、MyExtension が読み込まれたら新しい MyExtension インスタンスをインスタンス化します。  
+  
+-   MyExtensionItem クラスの <xref:System.ServiceModel.Syndication.SyndicationItem.WriteElementExtensions%28System.Xml.XmlWriter%2CSystem.String%29> をオーバーライドし、MyExtension プロパティのコンテンツを XML ライターに書き出します。  
+  
+-   <xref:System.ServiceModel.Syndication.SyndicationFeed> から、MyExtensionFeed というクラスを派生させます。  
+  
+-   MyExtensionFeed クラスの <xref:System.ServiceModel.Syndication.SyndicationFeed.CreateItem> をオーバーライドし、既定の <xref:System.ServiceModel.Syndication.SyndicationItem> の代わりに MyExtensionItem をインスタンス化します。<xref:System.ServiceModel.Syndication.SyndicationFeed> および <xref:System.ServiceModel.Syndication.SyndicationItem> に、<xref:System.ServiceModel.Syndication.SyndicationLink>、<xref:System.ServiceModel.Syndication.SyndicationCategory>、および <xref:System.ServiceModel.Syndication.SyndicationPerson> の各オブジェクトを生成する一連のメソッドが定義されます \(たとえば、<xref:System.ServiceModel.Syndication.SyndicationFeed.CreateLink>、<xref:System.ServiceModel.Syndication.SyndicationFeed.CreateCategory>、<xref:System.ServiceModel.Syndication.SyndicationFeed.CreatePerson> など\)。そのどれもが、カスタム派生クラスを作成するためにオーバーライドできます。  
+  
+## 参照  
+ [WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)   
+ [配信のアーキテクチャ](../../../../docs/framework/wcf/feature-details/architecture-of-syndication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/system-web-routing-integration.md b/docs/framework/wcf/feature-details/system-web-routing-integration.md
new file mode 100644
index 00000000000..64dd5b215d3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/system-web-routing-integration.md
@@ -0,0 +1,82 @@
+---
+title: "System.Web.Routing 統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31fe2a4f-5c47-4e5d-8ee1-84c524609d41
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# System.Web.Routing 統合
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをインターネット インフォメーション サービス \(IIS\) でホストするときは、.svc ファイルを仮想ディレクトリに配置します。この .svc ファイルは、使用するサービス ホスト ファクトリと、サービスを実装するクラスを指定します。サービスを要求するときは、http:\/\/contoso.com\/EmployeeServce.svc などの URI で .svc ファイルを指定します。REST サービスを記述するプログラマにとっては、この種類の URI は最適とは言えません。REST サービス用の URI は、特定のリソースを指定しており、拡張子がないのが普通です。<xref:System.Web.Routing> 統合機能では、拡張子のない URI に応答する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST サービスをホストできます。ルーティング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ASP.NET ルーティング](http://go.microsoft.com/fwlink/?LinkId=184660)」および「[AspNetRouteIntegration](../../../../docs/framework/wcf/samples/aspnetrouteintegration.md)」のサンプルを参照してください。  
+  
+## System.Web.Routing 統合の使用  
+ <xref:System.Web.Routing> 統合機能を使用するには、<xref:System.ServiceModel.Activation.ServiceRoute> クラスを使用して 1 つ以上のルートを作成し、Global.asax ファイルでそれらを <xref:System.Web.Routing.RouteTable> に追加します。これらのルートは、サービスが応答する相対 URI を指定します。その方法を次の例に示します。  
+  
+```  
+<%@ Application Language="C#" %>  
+<%@ Import Namespace="System.Web.Routing" %>  
+<%@ Import Namespace="System.ServiceModel.Activation" %>  
+<%@ Import Namespace="System.ServiceModel.Web " %>  
+  
+<script RunAt="server">  
+    void Application_Start(object sender, EventArgs e)  
+    {  
+        RegisterRoutes(RouteTable.Routes);  
+    }  
+  
+    private void RegisterRoutes(RouteCollection routes)  
+    {  
+        routes.Add(new ServiceRoute("Customers", new WebServiceHostFactory(), typeof(Service)));   
+   }  
+</script>  
+  
+```  
+  
+ これは、Customers で始まる相対 URI が指定されたすべての要求を `Service` サービスにルーティングします。  
+  
+ Web.config ファイルでは、次の例に示すように、`System.Web.Routing.UrlRoutingModule` モジュールを追加し、`runAllManagedModulesForAllRequests` 属性を `true` に設定し、`UrlRoutingHandler` ハンドラーを `<system.webServer>` 要素に追加する必要があります。  
+  
+```xml  
+<system.webServer>  
+      <modules runAllManagedModulesForAllRequests="true">  
+        <add name="UrlRoutingModule" type="System.Web.Routing.UrlRoutingModule, System.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />  
+      </modules>  
+      <handlers>  
+        <add name="UrlRoutingHandler" preCondition="integratedMode" verb="*" path="UrlRouting.axd"/>  
+      </handlers>  
+    </system.webServer>  
+```  
+  
+ これで、ルーティングに必要なモジュールとハンドラーが読み込まれます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][ルーティング](../../../../docs/framework/wcf/feature-details/routing.md).また、次の例に示すように、`<serviceHostingEnvironment>` 要素で `aspNetCompatibilityEnabled` 属性を `true` に設定する必要もあります。  
+  
+```  
+<system.serviceModel>  
+    <serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>  
+        <!-- ... -->  
+    </system.serviceModel>  
+```  
+  
+ 次の例に示すように、このサービスを実装するクラスでは、ASP.NET 互換要件を有効にする必要があります。  
+  
+```  
+[ServiceContract]  
+[AspNetCompatibilityRequirements(RequirementsMode=AspNetCompatibilityRequirementsMode.Allowed)]  
+    public class Service  
+    {  
+        // ...  
+    }  
+```  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [ASP.NET ルーティング](http://go.microsoft.com/fwlink/?LinkId=184660)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/tampering.md b/docs/framework/wcf/feature-details/tampering.md
new file mode 100644
index 00000000000..2b5776172a9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/tampering.md
@@ -0,0 +1,35 @@
+---
+title: "改変 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bad93be-60bb-4f89-96ab-a1c3dc7c0fad
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 改変
+*改変*は、メッセージまたはメッセージの配信を変更し、意図された以外の目的のために、変更したメッセージを使用する行為です。  
+  
+## WS\-Addressing を無効にしない  
+ WS\-Addressing の仕様では、各メッセージにアドレス ヘッダーが提供されるため、メッセージの受信者はメッセージの送信者を検証できます。この機能を無効にするには、<xref:System.ServiceModel.Channels.MessageVersion.Addressing%2A> プロパティを <xref:System.ServiceModel.Channels.AddressingVersion.None%2A> に設定します。  
+  
+ セキュリティ モードが Message に設定された状態で、WS\-Addressing が無効になっていると、攻撃者がクライアントから要求を取得して、これを別のサービスに送信した場合、要求を受信したサービスは、このメッセージが元のクライアントから送信されたことを検出できません。事実上、最初のサービスは、2 番目のサービスと対話するときに、自分をクライアントと偽ることができます。  
+  
+ これを防ぐには、<xref:System.ServiceModel.Channels.MessageVersion.Addressing%2A> プロパティを絶対に <xref:System.ServiceModel.Channels.AddressingVersion.None%2A> に設定しないようにし、静的 <xref:System.ServiceModel.Channels.MessageVersion.Soap12%2A> プロパティのように、<xref:System.ServiceModel.Channels.MessageVersion.Addressing%2A> プロパティを <xref:System.ServiceModel.Channels.AddressingVersion.None%2A> に設定する <xref:System.ServiceModel.Channels.MessageVersion> の使用を避けます。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)   
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)   
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [サポートされていないシナリオ](../../../../docs/framework/wcf/feature-details/unsupported-scenarios.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transaction-models.md b/docs/framework/wcf/feature-details/transaction-models.md
new file mode 100644
index 00000000000..ed4656e77ce
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transaction-models.md
@@ -0,0 +1,43 @@
+---
+title: "トランザクション モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48a8bc1b-128b-4cf1-a421-8cc73223c340
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# トランザクション モデル
+ここでは、トランザクション プログラミング モデルと、マイクロソフトが提供するインフラストラクチャ コンポーネントとの関係を説明します。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でトランザクションを使用する場合、選択するトランザクション モデルが異なるのではなく、統合され一貫した 1 つのモデルにおいて操作するレイヤーが異なるのだということを理解することが大切です。  
+  
+ 以下に、3 つの主要なトランザクション コンポーネントについて説明します。  
+  
+## Windows Communication Foundation トランザクション  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされるトランザクションでは、トランザクション サービスを作成することができます。さらに、WS\-AtomicTransaction \(WS\-AT\) プロトコルのサポートにより、アプリケーションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] またはサードパーティのテクノロジを使用して構築された Web サービスにトランザクションをフローさせることができます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたはアプリケーションでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランザクション機能により、インフラストラクチャがトランザクションを作成、フロー、同期する方法と時期を宣言的に指定するための属性と構成が提供されます。  
+  
+## System.Transactions トランザクション  
+ <xref:System.Transactions> 名前空間は、<xref:System.Transactions.Transaction> クラスに基づく明示的なプログラミング モデルだけでなく、インフラストラクチャがトランザクションを自動的に管理する、<xref:System.Transactions.TransactionScope> クラスを使用した暗黙的なプログラミング モデルも提供します。  
+  
+ この 2 つのモデルを使用したトランザクション アプリケーション作成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランザクション アプリケーションの作成](http://go.microsoft.com/fwlink/?LinkId=94947)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたはアプリケーションでは、クライアント アプリケーション内にトランザクションを作成し、サービス内で必要な場合に、明示的にトランザクションと対話するためのプログラミング モデルが <xref:System.Transactions> により提供されます。  
+  
+## MSDTC トランザクション  
+ Microsoft 分散トランザクション コーディネーター \(MSDTC\) は、分散トランザクションをサポートするトランザクション マネージャーです。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[DTC Programmer's Reference](http://go.microsoft.com/fwlink/?LinkId=94948)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスまたはアプリケーションにおいて MSDTC は、クライアントまたはサービス内で作成されたトランザクションを調整するためのインフラストラクチャを提供します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transaction-protocols-version-1-0.md b/docs/framework/wcf/feature-details/transaction-protocols-version-1-0.md
new file mode 100644
index 00000000000..4a5f783f4c7
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transaction-protocols-version-1-0.md
@@ -0,0 +1,437 @@
+---
+title: "トランザクション プロトコル バージョン 1.0 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 034679af-0002-402e-98a8-ef73dcd71bb6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# トランザクション プロトコル バージョン 1.0
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] バージョン 1 は、WS\-Atomic Transaction プロトコルおよび WS\-Coordination プロトコルのバージョン 1.0 を実装します。バージョン 1.1 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランザクション プロトコル](../../../../docs/framework/wcf/feature-details/transaction-protocols.md)」を参照してください。  
+  
+|仕様\/ドキュメント|リンク|  
+|----------------|---------|  
+|WS\-Coordination|http:\/\/msdn.microsoft.com\/ws\/2005\/08\/ws\-coordination\/|  
+|WS\-AtomicTransaction|http:\/\/msdn.microsoft.com\/ws\/2005\/08\/ws\-atomictransaction\/|  
+  
+ これらのプロトコル仕様の相互運用性は、アプリケーション間とトランザクション マネージャー間の 2 つのレベルで必要です \(次の図を参照\)。仕様では、相互運用性の両方のレベルについて、メッセージ形式とメッセージ交換が詳細に説明されます。アプリケーション間での交換に必要な一定のセキュリティ、信頼性、およびエンコーディングは、通常のアプリケーションによる交換にも当てはまります。ただし、トランザクション マネージャー間で適切な相互運用性を実現するには、特定のバインディングを使用するという合意が必要となります。通常、バインディングはユーザーによって構成されないためです。  
+  
+ ここでは、WS\-AtomicTransaction \(WS\-AT\) 仕様のセキュリティに関する構成と、トランザクション マネージャー間の通信に使用されるセキュリティで保護されたバインディングについて説明します。このドキュメントで説明されているアプローチは、IBM、IONA、Sun Microsystems などを含む WS\-AT および WS\-Coordination の各種の実装でテスト済みのものです。  
+  
+ 次の図は、2 つのトランザクション マネージャー \(Transaction Manager 1 と Transaction Manager 2\)、および 2 つのアプリケーション \(Application 1 と Application 2\) 間の相互運用性を示しています。  
+  
+ ![トランザクション プロトコル](../../../../docs/framework/wcf/feature-details/media/transactionmanagers.gif "TransactionManagers")  
+  
+ 1 つのイニシエーター \(I\) と 1 つの参加要素 \(P\) を持つ、一般的な WS\-Coordination\/WS\-AtomicTransaction のシナリオを考えます。イニシエーターと参加要素の両方にトランザクション マネージャー \(それぞれ ITM および PTM と呼びます\) があります。2 フェーズ コミットは、このトピックでは 2PC と呼びます。  
+  
+|||  
+|-|-|  
+|1.CreateCoordinationContext|12.アプリケーション メッセージ応答|  
+|2.CreateCoordinationContextResponse|13.Commit \(完了\)|  
+|3.Register \(完了\)|14.Prepare \(2PC\)|  
+|4.RegisterResponse|15.Prepare \(2PC\)|  
+|5.アプリケーション メッセージ|16.Prepared \(2PC\)|  
+|6.CreateCoordinationContext with Context|17.Prepared \(2PC\)|  
+|7.Register \(永続的\)|18.Committed \(完了\)|  
+|8.RegisterResponse|19.Commit \(2PC\)|  
+|9.CreateCoordinationContextResponse|20.Commit \(2PC\)|  
+|10.Register \(永続的\)|21.Committed \(2PC\)|  
+|11.RegisterResponse|22.Committed \(2PC\)|  
+  
+ このドキュメントでは、WS\-AtomicTransaction 仕様のセキュリティに関する構成と、トランザクション マネージャー間の通信に使用されるセキュリティで保護されたバインディングについて説明します。このドキュメントで説明されているアプローチは、WS\-AT および WS\-Coordination の各種の実装でテスト済みのものです。  
+  
+ この図および表では、セキュリティの観点から見た次の 4 つのクラスのメッセージを示しています。  
+  
+-   アクティベーション メッセージ \(CreateCoordinationContext と CreateCoordinationContextResponse\)  
+  
+-   登録メッセージ \(Register と RegisterResponse\)  
+  
+-   プロトコル メッセージ \(Prepare、Rollback、Commit、Aborted など\)  
+  
+-   アプリケーション メッセージ  
+  
+ 最初の 3 つのメッセージ クラスはトランザクション マネージャーのメッセージと考えられます。これらのクラスのバインディング構成については、後の「アプリケーション メッセージ交換」で説明します。4 番目のメッセージ クラスは、アプリケーション間のメッセージであり、後の「メッセージの例」で説明します。ここでは、これらの各クラスで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって使用されるプロトコル バインディングについて説明します。  
+  
+ このドキュメントでは、次の XML 名前空間と関連付けられたプレフィックスが使用されます。  
+  
+|プレフィックス|名前空間 URI|  
+|-------------|--------------|  
+|s11|http:\/\/schemas.xmlsoap.org\/soap\/envelope|  
+|wsa|http:\/\/www.w3.org\/2004\/08\/addressing|  
+|wscoor|http:\/\/schemas.xmlsoap.org\/ws\/2004\/10\/wscoor|  
+|wsat|http:\/\/schemas.xmlsoap.org\/ws\/2004\/10\/wsat|  
+|t|http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust|  
+|o|http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-wssecurity\-secext\-1.0.xsd|  
+|xsd|http:\/\/www.w3.org\/2001\/XMLSchema|  
+  
+## トランザクション マネージャー バインディング  
+ R1001 : トランザクション マネージャーは、SOAP 1.1、WS\-Addressing 2004\/08 for WS\-AtomicTransaction、および WS\-Coordination メッセージ交換を使用する必要があります。  
+  
+ アプリケーション メッセージは、後で説明するように、これらのバインディングに制限されません。  
+  
+### トランザクション マネージャー HTTPS バインディング  
+ トランザクション マネージャー HTTPS バインディングは、セキュリティを実現してトランザクション ツリー内の送信者と受信者の各ペア間で信頼を確立するトランスポート セキュリティにのみ依存します。  
+  
+#### HTTPS トランスポート構成  
+ トランザクション マネージャー ID を確立するために X.509 証明書が使用されます。クライアントおよびサーバーの承認が必要です。クライアントおよびサーバーの承認は、以下のような実装詳細の状態にしておきます。  
+  
+-   R1111 : ネットワーク経由で示された X.509 証明書は、発信元コンピューターの完全修飾ドメイン名 \(FQDN\) と一致するサブジェクト名を持っている必要があります。  
+  
+-   B1112 : X.509 のサブジェクト名のチェックが成功するには、システム内の送信者と受信者の各ペア間で、DNS が機能している必要があります。  
+  
+#### アクティベーションと登録のバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、HTTPS 上での関連付けにおいて要求\/応答の二重バインディングが必要です \(関連付けと要求\/応答メッセージ交換パターンの詳細については、WS\-AtomicTransaction 仕様のセクション 8 を参照してください\)。  
+  
+#### 2PC プロトコルのバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTPS 上の一方向 \(データグラム\) メッセージをサポートしています。メッセージ間の関連付けは、実装詳細の状態にしておきます。  
+  
+ B2131 : 実装では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の 2PC メッセージの関連付けを実現するために、WS\-Addressing で説明されているように、`wsa:ReferenceParameters` をサポートする必要があります。  
+  
+### トランザクション マネージャーによる混合セキュリティ バインディング  
+ これは、ID を確立する目的で WS\-Coordination 発行済みトークン モデルにトランスポート セキュリティを組み合わせて使用する代替の \(混合モードの\) バインディングです。2 つのバインディングを区別する要素は、アクティベーションと登録のみです。  
+  
+#### HTTPS トランスポート構成  
+ トランザクション マネージャー ID を確立するために X.509 証明書が使用されます。クライアントおよびサーバーの承認が必要です。クライアントおよびサーバーの承認は、以下のような実装詳細の状態にしておきます。  
+  
+#### アクティベーション メッセージのバインディング構成  
+ アクティベーション メッセージは通常、アプリケーションとローカルのトランザクション マネージャー間で発生するため、相互運用には参加しません。  
+  
+ B1221 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、アクティベーション メッセージに \(「[メッセージング プロトコル](../../../../docs/framework/wcf/feature-details/messaging-protocols.md)」で説明する\) HTTPS の二重バインディングを使用します。要求および応答メッセージは、WS\-Addressing 2004\/08 を使用して関連付けられます。  
+  
+ WS\-AtomicTransaction 仕様のセクション 8 では、関連付けとメッセージ交換のパターンについて詳細に説明されています。  
+  
+-   R1222 : `CreateCoordinationContext` を受信すると、コーディネーターは、関連付けられている秘密の `STx` を使用して `SecurityContextToken` を発行します。このトークンは、WS\-Trust の仕様に従って、`t:IssuedTokens` ヘッダー内に返されます。  
+  
+-   R1223 : アクティベーションが既存のコーディネーション コンテキスト内で発生した場合、既存のコンテキストに関連付けられた `SecurityContextToken` がある `t:IssuedTokens` ヘッダーは、`CreateCoordinationContext` メッセージでフローする必要があります。  
+  
+ `wscoor:CreateCoordinationContextResponse`  送信メッセージに添付する新しい `t:IssuedTokens` ヘッダーが生成されます。  
+  
+#### 登録メッセージのバインディング構成  
+ B1231 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、\(「[メッセージング プロトコル](../../../../docs/framework/wcf/feature-details/messaging-protocols.md)」で説明する\) HTTPS の二重バインディングを使用します。要求および応答メッセージは、WS\-Addressing 2004\/08 を使用して関連付けられます。  
+  
+ WS\-AtomicTransaction 仕様のセクション 8 では、関連付けとメッセージ交換のパターンについて詳細に説明されています。  
+  
+ R1232 : `wscoor:Register` 送信メッセージでは、「[セキュリティ プロトコル](../../../../docs/framework/wcf/feature-details/security-protocols.md)」で説明する `IssuedTokenOverTransport` 認証モードを使用する必要があります。  
+  
+ `wsse:Timestamp` 要素は、`STx` によって発行された `SecurityContextToken` を使用して署名される必要があります。この署名は特定のトランザクションに関連付けられたトークンを所有していることの証明であり、トランザクションに登録されている参加要素の認証で使用されます。RegistrationResponse メッセージは、HTTPS を使用して返信されます。  
+  
+#### 2PC プロトコルのバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTPS 上の一方向 \(データグラム\) メッセージをサポートしています。メッセージ間の関連付けは、実装詳細の状態にしておきます。  
+  
+ B2131: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の 2PC メッセージの関連付けを行うには、WS\-Addressing に記載されているように、実装では `wsa:ReferenceParameters` をサポートする必要があります。  
+  
+## アプリケーション メッセージ交換  
+ アプリケーションでは、バインディングが次のセキュリティ要件を満たしている限り、アプリケーション間メッセージに任意のバインディングを使用できます。  
+  
+-   R2001 : アプリケーション間メッセージでは、メッセージのヘッダーの `CoordinationContext` に加えて `t:IssuedTokens` ヘッダーをフローする必要があります。  
+  
+-   R2002 : `t:IssuedToken` の整合性と機密性が提供される必要があります。  
+  
+ `CoordinationContext` ヘッダーには `wscoor:Identifier` が含まれます。`xsd:AnyURI` の定義では、絶対 URI と相対 URI の両方の使用が許可されていますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では絶対 URI である `wscoor:Identifiers` のみがサポートされています。  
+  
+ `wscoor:CoordinationContext` の `wscoor:Identifier` が相対 URI である場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランザクション サービスからエラーが返されます。  
+  
+## メッセージの例  
+  
+### CreateCoordinationContext 要求\/応答メッセージ  
+ 次のメッセージは、要求\/応答のパターンに従います。  
+  
+#### CreateCoordinationContext  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://.../ws/2004/10/wscoor/CreateCoordinationContext</Action>  
+    <a:MessageID>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</MessageID>  
+    <a:ReplyTo>  
+      <Address>https://...</a:Address>  
+    </a:ReplyTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security>  
+      <u:Timestamp>  
+        <wsu:Created>2005-12-15T23:36:09.921Z</u:Created>  
+        <wsu:Expires>2005-12-15T23:41:09.921Z</u:Expires>  
+      </u:Timestamp>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:CreateCoordinationContext>  
+      <wscoor:CoordinationType>...</wscoor:CoordinationType>  
+    </wscoor:CreateCoordinationContext>  
+  </s:Body>  
+</s11:Envelope>  
+  
+```  
+  
+#### CreateCoordinationContextResponse  
+  
+```  
+<s:Envelope>  
+  <!-- Data below is shown in the clear for  
+       illustration purposes only. -->  
+  <s:Header>  
+    <a:Action>./ws/2004/10/wscoor/CreateCoordinationContextResponse </a:Action>  
+    <a:RelatesTo>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</a:RelatesTo>  
+    <a:To s:mustUnderstand="1">https://... </a:To>  
+    <t:IssuedTokens>  
+ <wst:RequestSecurityTokenResponse     
+    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+    xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"   
+    xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust"  
+    xmlns:wsc="http://schemas.xmlsoap.org/ws/2005/02/sc"  
+    xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy">  
+    <wst:TokenType>http://schemas.xmlsoap.org/ws/2005/02/sc/sct</wst:TokenType>  
+    <wst:RequestedSecurityToken>  
+      <wsc:SecurityContextToken>  
+        <wssu:Identifier>  
+          http://fabrikam123.com/SCTi  
+        </wssu:Identifier>  
+      </wsc:SecurityContextToken>   
+    </wst:RequestedSecurityToken>  
+    <wsp:AppliesTo>  
+        http://fabrikam123.com/CCi  
+    </wsp:AppliesTo>    
+    <wst:RequestedAttachedReference>  
+      <wsse:SecurityTokenReference >  
+        <wsse:Reference   
+           ValueType="http://schemas.xmlsoap.org/ws/2005/02/sc/sct"  
+           URI="http://fabrikam123.com/SCTi"/>  
+      </wsse:SecurityTokenReference>  
+    </wst:RequestedAttachedReference>  
+    <wst:RequestedUnattachedReference>  
+      <wsse:SecurityTokenReference>  
+        <wsse:Reference   
+          ValueType="http://schemas.xmlsoap.org/ws/2005/02/sc/sct"  
+          URI="http://fabrikam123.com/SCTi"/>  
+      </wsse:SecurityTokenReference>  
+    </wst:RequestedUnattachedReference>  
+    <wst:RequestedProofToken>  
+      <wst:BinarySecret   
+        Type="http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey">  
+        <!-- base64 encoded value -->  
+      </wst:BinarySecret>  
+    </wst:RequestedProofToken>  
+    <wst:Lifetime>  
+      <wssu:Created>2005-10-24T20:19:26.526Z</wssu:Created>  
+      <wssu:Expires>2005-10-25T06:24:26.526Z</wssu:Expires>  
+    </wst:Lifetime>  
+    <wst:KeySize>256</wst:KeySize>  
+</wst:RequestSecurityTokenResponse>  
+    </t:IssuedTokens>  
+    <o:Security xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+      <u:Timestamp u:Id="_0">  
+        <u:Created>2005-12-15T23:36:12.015Z</u:Created>  
+        <u:Expires>2005-12-15T23:41:12.015Z</u:Expires>  
+      </u:Timestamp>  
+    </o:Security>  
+  </s:Header>  
+  <s:Body>  
+    <wscoor:CreateCoordinationContextResponse>  
+      <wscoor:CoordinationContext>  
+        <wscoor:Identifier>  
+     http://fabrikam123.com/CCi  
+      </wscoor:Identifier>  
+        <wscoor:Expires>...</wscoor:Expires>  
+        <wscoor:CoordinationType>...</wscoor:CoordinationType>  
+        <wscoor:RegistrationService>  
+          <a:Address>https://...</a:Address>  
+          <a:ReferenceParameters>  
+             ...  
+          </a:ReferenceParameters>  
+        </wscoor:RegistrationService>  
+      </wscoor:CoordinationContext>  
+    </wscoor:CreateCoordinationContextResponse>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+### 登録メッセージ  
+ 次のメッセージは、登録メッセージです。  
+  
+#### Register  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://schemas.xmlsoap.org/ws/2004/10/wscoor/Register</a:Action>  
+    <a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e</a:MessageID>  
+    <a:ReplyTo>  
+      <a:Address>https://...</a:Address>        
+    </a:ReplyTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp wssu:Id="_0" >  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+      <wsc:SecurityContextToken>  
+      <wssu:Identifier>  
+          http://fabrikam123.com/SCTi  
+      </wssu:Identifier>  
+      </wsc:SecurityContextToken>  
+      <!-- supporting signature over the timestamp -->  
+      <wsse:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">  
+        <ds:SignedInfo>  
+          <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>  
+          <ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#hmac-sha1"/>  
+          <ds:Reference URI="#_0">  
+            <ds:Transforms>  
+              <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>  
+            </ds:Transforms>  
+            <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>  
+            <ds:DigestValue>  
+              alRzyhjLgoUOYoh8cx4n75eTcUk=  
+            </ds:DigestValue>  
+          </ds:Reference>  
+        </ds:SignedInfo>  
+        <ds:SignatureValue>YZYjnVvSOVasAQqQxaaviTSWtqI=</ds:SignatureValue>  
+        <ds:KeyInfo>  
+          <wsse:SecurityTokenReference  
+            xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+            <wsse:Reference   
+              URI="http://fabrikam123.com/SCTi"/>  
+          </wsse:SecurityTokenReference>  
+        </ds:KeyInfo>  
+      </wsse:Signature>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:Register>  
+      <wscoor:ProtocolIdentifier>...</wscoor:ProtocolIdentifier>  
+      <wscoor:ParticipantProtocolService>  
+        <a:Address>https://... </a:Address>  
+      </wscoor:ParticipantProtocolService>  
+    </wscoor:Register>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+#### RegisterResponse  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>  
+      http://schemas.xmlsoap.org/ws/2004/10/wscoor/RegisterResponse  
+    </a:Action>  
+    <a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088d</a:MessageID>  
+    <a:RelatesTo>  
+      urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e        
+    </a:RelatesTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp>  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:RegisterResponse>  
+      <wscoor:CoordinatorProtocolService>  
+        <a:Address>https://...</a:Address>  
+        <a:ReferenceParameters>  
+          ...  
+        </a:ReferenceParameters>  
+      </wscoor:CoordinatorProtocolService>  
+    </wscoor:RegisterResponse>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+### 2 フェーズ コミット プロトコル メッセージ  
+ 次のメッセージは、2 フェーズ コミット \(2PC\) プロトコルに関連しています。  
+  
+#### Commit  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://.../ws/2004/10/wsat/Commit</a:Action>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp wssu:Id="_0" >  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+   </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wsat:Commit />  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+### アプリケーション メッセージ  
+ 次のメッセージは、アプリケーション メッセージです。  
+  
+#### アプリケーション メッセージ \(要求\)  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+<!-- Addressing headers, all signed-->  
+    <wsse:Security s:mustUnderstand="1">  
+      <wssu:Timestamp wssu:Id="timestamp">   
+        <wssu:Created>2005-10-25T06:29:18.703Z</wssu:Created>  
+        <wssu:Expires>2005-10-25T06:34:18.703Z</wssu:Expires>  
+      </wssu:Timestamp>  
+      <wsse:BinarySecurityToken   
+          wssu:Id="IA_Certificate"   
+          ValueType="...#X509v3"   
+          EncodingType="...#Base64Binary">  
+        <!-- IA certificate -->  
+      </wsse:BinarySecurityToken>  
+      <e:EncryptedKey Id="encrypted_key">  
+            <!-- ephemeral key encrypted for PA certificate -->    
+        <e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+          <e:DataReference URI="#encrypted_body"/>  
+          <e:DataReference URI="#encrypted_CCi"/>  
+          <e:DataReference URI="#encrypted_issuedtokens"/>  
+        </e:ReferenceList>  
+      </e:EncryptedKey>  
+      <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">  
+        <!-- signature over Addressing headers, Timestamp, and Body -->  
+      </Signature>  
+    </wsse:Security>  
+    <wsse11:EncryptedHeader >  
+     <!-- encrypted wscoor:CoordinationContext header containing CCi -->  
+    </wsse11:EncryptedHeader>  
+    <wsse11:EncryptedHeader   
+      <!-- encrypted wst:IssuedTokens header containing SCTi -->  
+      <!-- wst:IssuedTokens header is taken verbatim from message #2 above, omitted for brevity -->  
+    </wsse11:EncryptedHeader>  
+  </s:Header>  
+  <s:Body wssu:Id="body">  
+    <!-- encrypted content of the Body element of the application message -->      
+    <e:EncryptedData Id="encrypted_body"   
+           Type="http://www.w3.org/2001/04/xmlenc#Content"   
+           xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+...  
+    </e:EncryptedData>  
+  </s:Body>  
+</s:Envelope>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transaction-protocols.md b/docs/framework/wcf/feature-details/transaction-protocols.md
new file mode 100644
index 00000000000..0e5f056081c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transaction-protocols.md
@@ -0,0 +1,659 @@
+---
+title: "トランザクション プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2820b0ec-2f32-430c-b299-1f0e95e1f2dc
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# トランザクション プロトコル
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、WS\-Atomic Transaction プロトコルと WS\-Coordination プロトコルを実装しています。  
+  
+|仕様\/ドキュメント|バージョン|リンク|  
+|----------------|-----------|---------|  
+|WS\-Coordination|1.0<br /><br /> 1.1|[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96104](http://go.microsoft.com/fwlink/?LinkId=96104)<br /><br /> [http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96079](http://go.microsoft.com/fwlink/?LinkId=96079)|  
+|WS\-AtomicTransaction|1.0<br /><br /> 1.1|[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96080](http://go.microsoft.com/fwlink/?LinkId=96080)<br /><br /> http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96081|  
+  
+ これらのプロトコル仕様の相互運用性は、アプリケーション間とトランザクション マネージャー間の 2 つのレベルで必要です \(次の図を参照\)。仕様では、相互運用性の両方のレベルについて、メッセージ形式とメッセージ交換が詳細に説明されます。アプリケーション間での交換に必要な一定のセキュリティ、信頼性、およびエンコーディングは、通常のアプリケーションによる交換にも当てはまります。ただし、トランザクション マネージャー間で適切な相互運用性を実現するには、特定のバインディングを使用するという合意が必要となります。通常、バインディングはユーザーによって構成されないためです。  
+  
+ ここでは、WS\-AtomicTransaction \(WS\-AT\) 仕様のセキュリティに関する構成と、トランザクション マネージャー間の通信に使用されるセキュリティで保護されたバインディングについて説明します。このドキュメントで説明されているアプローチは、IBM、IONA、Sun Microsystems などを含む WS\-AT および WS\-Coordination の各種の実装でテスト済みのものです。  
+  
+ 次の図は、2 つのトランザクション マネージャー \(Transaction Manager 1 と Transaction Manager 2\)、および 2 つのアプリケーション \(Application 1 と Application 2\) 間の相互運用性を示しています。  
+  
+ ![トランザクション プロトコル](../../../../docs/framework/wcf/feature-details/media/transactionmanagers.gif "TransactionManagers")  
+  
+ 1 つのイニシエーター \(I\) と 1 つの参加要素 \(P\) を持つ、一般的な WS\-Coordination\/WS\-AtomicTransaction のシナリオを考えます。イニシエーターと参加要素の両方にトランザクション マネージャー \(それぞれ ITM および PTM と呼びます\) があります。2 フェーズ コミットは、このトピックでは 2PC と呼びます。  
+  
+|||  
+|-|-|  
+|1.CreateCoordinationContext|12.アプリケーション メッセージ応答|  
+|2.CreateCoordinationContextResponse|13.Commit \(完了\)|  
+|3.Register \(完了\)|14.Prepare \(2PC\)|  
+|4.RegisterResponse|15.Prepare \(2PC\)|  
+|5.アプリケーション メッセージ|16.Prepared \(2PC\)|  
+|6.CreateCoordinationContext with Context|17.Prepared \(2PC\)|  
+|7.Register \(永続的\)|18.Committed \(完了\)|  
+|8.RegisterResponse|19.Commit \(2PC\)|  
+|9.CreateCoordinationContextResponse|20.Commit \(2PC\)|  
+|10.Register \(永続的\)|21.Committed \(2PC\)|  
+|11.RegisterResponse|22.Committed \(2PC\)|  
+  
+ このドキュメントでは、WS\-AtomicTransaction 仕様のセキュリティに関する構成と、トランザクション マネージャー間の通信に使用されるセキュリティで保護されたバインディングについて説明します。このドキュメントで説明されているアプローチは、WS\-AT および WS\-Coordination の各種の実装でテスト済みのものです。  
+  
+ この図および表では、セキュリティの観点から見た次の 4 つのクラスのメッセージを示しています。  
+  
+-   アクティベーション メッセージ \(CreateCoordinationContext と CreateCoordinationContextResponse\)  
+  
+-   登録メッセージ \(Register と RegisterResponse\)  
+  
+-   プロトコル メッセージ \(Prepare、Rollback、Commit、Aborted など\)  
+  
+-   アプリケーション メッセージ  
+  
+ 最初の 3 つのメッセージ クラスはトランザクション マネージャーのメッセージと考えられます。これらのクラスのバインディング構成については、後の「アプリケーション メッセージ交換」で説明します。4 番目のメッセージ クラスは、アプリケーション間のメッセージであり、後の「メッセージの例」で説明します。ここでは、これらの各クラスで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって使用されるプロトコル バインディングについて説明します。  
+  
+ このドキュメントでは、次の XML 名前空間と関連付けられたプレフィックスが使用されます。  
+  
+|プレフィックス|Version|名前空間の URI|  
+|-------------|-------------|---------------|  
+|s11||[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96014](http://go.microsoft.com/fwlink/?LinkId=96014)|  
+|wsa|1.0 より前<br /><br /> 1.0|http:\/\/www.w3.org\/2004\/08\/addressing<br /><br /> [http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96022](http://go.microsoft.com/fwlink/?LinkId=96022)|  
+|wscoor|1.0<br /><br /> 1.1|[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96078](http://go.microsoft.com/fwlink/?LinkId=96078)<br /><br /> [http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96079](http://go.microsoft.com/fwlink/?LinkId=96079)|  
+|wsat|1.0<br /><br /> 1.1|[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96080](http://go.microsoft.com/fwlink/?LinkId=96080)<br /><br /> [http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96081](http://go.microsoft.com/fwlink/?LinkId=96081)|  
+|t|1.3 より前<br /><br /> 1.3|[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96082](http://go.microsoft.com/fwlink/?LinkId=96082)<br /><br /> [http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96100](http://go.microsoft.com/fwlink/?LinkId=96100)|  
+|o||[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96101](http://go.microsoft.com/fwlink/?LinkId=96101)|  
+|xsd||[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=96102](http://go.microsoft.com/fwlink/?LinkId=96102)|  
+  
+## トランザクション マネージャー バインディング  
+ R1001 : WS\-AT 1.0 トランザクションに参加するトランザクション マネージャーは、SOAP 1.1、WS\-Addressing 2004\/08 for WS\-Atomic Transaction、および WS\-Coordination メッセージ交換を使用する必要があります。  
+  
+ R1002 : WS\-AT 1.1 トランザクションに参加するトランザクション マネージャーは、SOAP 1.1、WS\-Addressing 2005\/08 for WS\-Atomic Transaction、および WS\-Coordination メッセージ交換を使用する必要があります。  
+  
+ アプリケーション メッセージは、後で説明するように、これらのバインディングに制限されません。  
+  
+### トランザクション マネージャー HTTPS バインディング  
+ トランザクション マネージャー HTTPS バインディングは、セキュリティを実現してトランザクション ツリー内の送信者と受信者の各ペア間で信頼を確立するトランスポート セキュリティにのみ依存します。  
+  
+#### HTTPS トランスポート構成  
+ トランザクション マネージャー ID を確立するために X.509 証明書が使用されます。クライアントおよびサーバーの承認が必要です。クライアントおよびサーバーの承認は、以下のような実装詳細の状態にしておきます。  
+  
+-   R1111 : ネットワーク経由で示された X.509 証明書は、発信元コンピューターの完全修飾ドメイン名 \(FQDN\) と一致するサブジェクト名を持っている必要があります。  
+  
+-   B1112 : X.509 のサブジェクト名のチェックが成功するには、システム内の送信者と受信者の各ペア間で、DNS が機能している必要があります。  
+  
+#### アクティベーションと登録のバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、HTTPS 上での関連付けにおいて要求\/応答の二重バインディングが必要です \(関連付けと要求\/応答メッセージ交換パターンの詳細については、WS\-AtomicTransaction 仕様のセクション 8 を参照してください\)。  
+  
+#### 2PC プロトコルのバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTPS 上の一方向 \(データグラム\) メッセージをサポートしています。メッセージ間の関連付けは、実装詳細の状態にしておきます。  
+  
+ B1131 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の 2PC メッセージの関連付けを行うには、WS\-Addressing に記載されているように、実装で `wsa:ReferenceParameters` をサポートする必要があります。  
+  
+### トランザクション マネージャーによる混合セキュリティ バインディング  
+ これは、ID を確立するために、トランスポート セキュリティを WS\-Coordination 発行済みトークン モデルと組み合わせて使用する代替の \(混合モードの\) バインディングです。2 つのバインディングを区別する要素は、アクティベーションと登録のみです。  
+  
+#### HTTPS トランスポート構成  
+ トランザクション マネージャー ID を確立するために X.509 証明書が使用されます。クライアントおよびサーバーの承認が必要です。クライアントおよびサーバーの承認は、以下のような実装詳細の状態にしておきます。  
+  
+#### アクティベーション メッセージのバインディング構成  
+ アクティベーション メッセージは通常、アプリケーションとローカルのトランザクション マネージャー間で発生するため、相互運用には参加しません。  
+  
+ B1221 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、アクティベーション メッセージに \(「[メッセージング プロトコル](../../../../docs/framework/wcf/feature-details/messaging-protocols.md)」で説明する\) HTTPS の二重バインディングを使用します。要求\/応答メッセージは、WS\-AT 1.0 の WS\-Addressing 2004\/08 と WS\-AT 1.1 の WS\-Addressing 2005\/08 を使用して関連付けられます。  
+  
+ WS\-AtomicTransaction 仕様のセクション 8 では、関連付けとメッセージ交換のパターンについて詳細に説明されています。  
+  
+-   R1222 : `CreateCoordinationContext` を受信すると、コーディネーターは、関連付けられている秘密の `STx` を使用して `SecurityContextToken` を発行します。このトークンは、WS\-Trust の仕様に従って、`t:IssuedTokens` ヘッダー内に返されます。  
+  
+-   R1223 : アクティベーションが既存のコーディネーション コンテキスト内で発生した場合、既存のコンテキストに関連付けられた `SecurityContextToken` がある `t:IssuedTokens` ヘッダーは、`CreateCoordinationContext` メッセージでフローする必要があります。  
+  
+ `wscoor:CreateCoordinationContextResponse`  送信メッセージに添付する新しい `t:IssuedTokens` ヘッダーが生成されます。  
+  
+#### 登録メッセージのバインディング構成  
+ B1231 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、\(「[メッセージング プロトコル](../../../../docs/framework/wcf/feature-details/messaging-protocols.md)」で説明する\) HTTPS の二重バインディングを使用します。要求\/応答メッセージは、WS\-AT 1.0 の WS\-Addressing 2004\/08 と WS\-AT 1.1 の WS\-Addressing 2005\/08 を使用して関連付けられます。  
+  
+ WS\-AtomicTransaction 仕様のセクション 8 では、関連付けとメッセージ交換のパターンについて詳細に説明されています。  
+  
+ R1232 : `wscoor:Register` 送信メッセージでは、「[セキュリティ プロトコル](../../../../docs/framework/wcf/feature-details/security-protocols.md)」で説明する `IssuedTokenOverTransport` 認証モードを使用する必要があります。  
+  
+ `wsse:Timestamp` 要素は、`STx` によって発行された `SecurityContextToken` を使用して署名される必要があります。この署名は特定のトランザクションに関連付けられたトークンを所有していることの証明であり、トランザクションに登録されている参加要素の認証で使用されます。RegistrationResponse メッセージは、HTTPS を使用して返信されます。  
+  
+#### 2PC プロトコルのバインディング構成  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、HTTPS 上の一方向 \(データグラム\) メッセージをサポートしています。メッセージ間の関連付けは、実装詳細の状態にしておきます。  
+  
+ B1241 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の 2PC メッセージの関連付けを行うには、WS\-Addressing に記載されているように、実装で `wsa:ReferenceParameters` がサポートされている必要があります。  
+  
+## アプリケーション メッセージ交換  
+ アプリケーションでは、バインディングが次のセキュリティ要件を満たしている限り、アプリケーション間メッセージに任意のバインディングを使用できます。  
+  
+-   R2001 : アプリケーション間メッセージでは、メッセージのヘッダーの `CoordinationContext` に加えて `t:IssuedTokens` ヘッダーをフローする必要があります。  
+  
+-   R2002 : `t:IssuedToken` の整合性と機密性が提供される必要があります。  
+  
+ `CoordinationContext` ヘッダーには `wscoor:Identifier` が含まれます。`xsd:AnyURI` の定義では、絶対 URI と相対 URI の両方の使用が許可されていますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では絶対 URI である `wscoor:Identifiers` のみがサポートされています。  
+  
+ B2003 : `wscoor:CoordinationContext` の `wscoor:Identifier` が相対 URI の場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランザクション サービスからエラーが返されます。  
+  
+## メッセージの例  
+  
+### CreateCoordinationContext 要求\/応答メッセージ  
+ 次のメッセージは、要求\/応答のパターンに従います。  
+  
+#### WSCoor 1.0 での CreateCoordinationContext  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://.../ws/2004/10/wscoor/CreateCoordinationContext</Action>  
+    <a:MessageID>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</MessageID>  
+    <a:ReplyTo>  
+      <Address>https://...</a:Address>  
+    </a:ReplyTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security>  
+      <u:Timestamp>  
+        <wsu:Created>2005-12-15T23:36:09.921Z</u:Created>  
+        <wsu:Expires>2005-12-15T23:41:09.921Z</u:Expires>  
+      </u:Timestamp>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:CreateCoordinationContext>  
+      <wscoor:CoordinationType>...</wscoor:CoordinationType>  
+    </wscoor:CreateCoordinationContext>  
+  </s:Body>  
+</s11:Envelope>  
+  
+```  
+  
+#### WSCoor 1.1 での CreateCoordinationContext  
+  
+```  
+<s:Envelope>   
+<s:Header>  
+<a:Action>http://docs.oasis-open.org/ws-tx/wscoor/2006/06/CreateCoordinationContext</Action>  
+<a:MessageID>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</MessageID>  
+<a:ReplyTo>   
+<Address>https://...</a:Address>   
+</a:ReplyTo>   
+<a:To>https://...</a:To>   
+<wsse:Security>  
+ <u:Timestamp>   
+<wsu:Created>2005-12-15T23:36:09.921Z</u:Created>  
+<wsu:Expires>2005-12-15T23:41:09.921Z</u:Expires>  
+</u:Timestamp>   
+</wsse:Security>   
+</s:Header>   
+<s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+<wscoor:CreateCoordinationContext>  
+<wscoor:CoordinationType>...</wscoor:CoordinationType>  
+</wscoor:CreateCoordinationContext>  
+ </s:Body>   
+</s11:Envelope>  
+  
+```  
+  
+#### Trust Pre\-1.3 および WSCoor 1.0 での CreateCoordinationContextResponse  
+  
+```  
+<s:Envelope>  
+  <!-- Data below is shown in the clear for  
+       illustration purposes only. -->  
+  <s:Header>  
+    <a:Action>./ws/2004/10/wscoor/CreateCoordinationContextResponse </a:Action>  
+    <a:RelatesTo>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</a:RelatesTo>  
+    <a:To s:mustUnderstand="1">https://... </a:To>  
+    <t:IssuedTokens>  
+ <wst:RequestSecurityTokenResponse     
+    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+    xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"   
+    xmlns:wst="http://schemas.xmlsoap.org/ws/2005/02/trust"  
+    xmlns:wsc="http://schemas.xmlsoap.org/ws/2005/02/sc"  
+    xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy">  
+    <wst:TokenType>http://schemas.xmlsoap.org/ws/2005/02/sc/sct</wst:TokenType>  
+    <wst:RequestedSecurityToken>  
+      <wsc:SecurityContextToken>  
+        <wssu:Identifier>  
+          http://fabrikam123.com/SCTi  
+        </wssu:Identifier>  
+      </wsc:SecurityContextToken>   
+    </wst:RequestedSecurityToken>  
+    <wsp:AppliesTo>  
+        http://fabrikam123.com/CCi  
+    </wsp:AppliesTo>    
+    <wst:RequestedAttachedReference>  
+      <wsse:SecurityTokenReference >  
+        <wsse:Reference   
+           ValueType="http://schemas.xmlsoap.org/ws/2005/02/sc/sct"  
+           URI="http://fabrikam123.com/SCTi"/>  
+      </wsse:SecurityTokenReference>  
+    </wst:RequestedAttachedReference>  
+    <wst:RequestedUnattachedReference>  
+      <wsse:SecurityTokenReference>  
+        <wsse:Reference   
+          ValueType="http://schemas.xmlsoap.org/ws/2005/02/sc/sct"  
+          URI="http://fabrikam123.com/SCTi"/>  
+      </wsse:SecurityTokenReference>  
+    </wst:RequestedUnattachedReference>  
+    <wst:RequestedProofToken>  
+      <wst:BinarySecret   
+        Type="http://schemas.xmlsoap.org/ws/2005/02/trust/SymmetricKey">  
+        <!-- base64 encoded value -->  
+      </wst:BinarySecret>  
+    </wst:RequestedProofToken>  
+    <wst:Lifetime>  
+      <wssu:Created>2005-10-24T20:19:26.526Z</wssu:Created>  
+      <wssu:Expires>2005-10-25T06:24:26.526Z</wssu:Expires>  
+    </wst:Lifetime>  
+    <wst:KeySize>256</wst:KeySize>  
+</wst:RequestSecurityTokenResponse>  
+    </t:IssuedTokens>  
+    <o:Security xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+      <u:Timestamp u:Id="_0">  
+        <u:Created>2005-12-15T23:36:12.015Z</u:Created>  
+        <u:Expires>2005-12-15T23:41:12.015Z</u:Expires>  
+      </u:Timestamp>  
+    </o:Security>  
+  </s:Header>  
+  <s:Body>  
+    <wscoor:CreateCoordinationContextResponse>  
+      <wscoor:CoordinationContext>  
+        <wscoor:Identifier>  
+     http://fabrikam123.com/CCi  
+      </wscoor:Identifier>  
+        <wscoor:Expires>...</wscoor:Expires>  
+        <wscoor:CoordinationType>...</wscoor:CoordinationType>  
+        <wscoor:RegistrationService>  
+          <a:Address>https://...</a:Address>  
+          <a:ReferenceParameters>  
+             ...  
+          </a:ReferenceParameters>  
+        </wscoor:RegistrationService>  
+      </wscoor:CoordinationContext>  
+    </wscoor:CreateCoordinationContextResponse>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+#### Trust 1.3 および WSCoor 1.1 での CreateCoordinationContextResponse  
+  
+```  
+<s:Envelope>  
+<!-- Data below is shown in the clear for illustration purposes only. -->   
+<s:Header>   
+<a:Action>http://docs.oasis-open.org/ws-tx/wscoor/2006/06/CreateCoordinationContextResponse </a:Action>  
+<a:RelatesTo>urn:uuid:069f5104-fd88-4264-9f99-60032a82854e</a:RelatesTo>  
+<a:To s:mustUnderstand="1">https://... </a:To>   
+<t:IssuedTokens>   
+<wst:RequestSecurityTokenResponse   
+xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"   
+xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-     wssecurity-utility-1.0.xsd"   
+xmlns:wst=http://docs.oasis-open.org/ws-sx/ws-trust/200512  
+xmlns:wsc=http://schemas.xmlsoap.org/ws/2005/02/sc  
+xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy">  
+<wst:TokenType>http://schemas.xmlsoap.org/ws/2005/02/sc/sct</wst:TokenType>  
+<wst:RequestedSecurityToken>   
+<wsc:SecurityContextToken>   
+<wssu:Identifier> http://fabrikam123.com/SCTi  
+</wssu:Identifier>   
+</wsc:SecurityContextToken>   
+</wst:RequestedSecurityToken>   
+<wsp:AppliesTo> http://fabrikam123.com/CCi </wsp:AppliesTo>  
+<wst:RequestedAttachedReference>   
+<wsse:SecurityTokenReference >   
+<wsse:Reference  
+  ValueType=http://schemas.xmlsoap.org/ws/2005/02/sc/sct  
+  URI="http://fabrikam123.com/SCTi"/>  
+</wsse:SecurityTokenReference>   
+</wst:RequestedAttachedReference>   
+<wst:RequestedUnattachedReference>   
+<wsse:SecurityTokenReference>   
+<wsse:Reference  
+ ValueType=http://schemas.xmlsoap.org/ws/2005/02/sc/sct  
+ URI="http://fabrikam123.com/SCTi"/>  
+</wsse:SecurityTokenReference>   
+</wst:RequestedUnattachedReference>   
+<wst:RequestedProofToken>   
+<wst:BinarySecret  
+  Type="http://docs.oasis-open.org/ws-sx/ws-trust/200512/SymmetricKey">  
+  <!-- base64 encoded value -->   
+</wst:BinarySecret>   
+</wst:RequestedProofToken>   
+<wst:Lifetime>   
+<wssu:Created>2005-10-24T20:19:26.526Z</wssu:Created>  
+<wssu:Expires>2005-10-25T06:24:26.526Z</wssu:Expires>  
+</wst:Lifetime>   
+<wst:KeySize>256</wst:KeySize>   
+</wst:RequestSecurityTokenResponse>   
+</t:IssuedTokens>   
+<o:Security xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">   
+<u:Timestamp u:Id="_0">   
+<u:Created>2005-12-15T23:36:12.015Z</u:Created>   
+<u:Expires>2005-12-15T23:41:12.015Z</u:Expires>   
+</u:Timestamp>   
+</o:Security>   
+</s:Header>   
+<s:Body>   
+<wscoor:CreateCoordinationContextResponse>   
+<wscoor:CoordinationContext>   
+<wscoor:Identifier> http://fabrikam123.com/CCi  
+</wscoor:Identifier>   
+<wscoor:Expires>...</wscoor:Expires>  
+<wscoor:CoordinationType>...</wscoor:CoordinationType>  
+<wscoor:RegistrationService>   
+<a:Address>https://...</a:Address>  
+<a:ReferenceParameters> ...  
+</a:ReferenceParameters>  
+</wscoor:RegistrationService>   
+</wscoor:CoordinationContext>   
+</wscoor:CreateCoordinationContextResponse>   
+</s:Body>   
+</s:Envelope>  
+  
+```  
+  
+### 登録メッセージ  
+ 次のメッセージは、登録メッセージです。  
+  
+#### WSCoor 1.0 での Register  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://schemas.xmlsoap.org/ws/2004/10/wscoor/Register</a:Action>  
+    <a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e</a:MessageID>  
+    <a:ReplyTo>  
+      <a:Address>https://...</a:Address>        
+    </a:ReplyTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp wssu:Id="_0" >  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+      <wsc:SecurityContextToken>  
+      <wssu:Identifier>  
+          http://fabrikam123.com/SCTi  
+      </wssu:Identifier>  
+      </wsc:SecurityContextToken>  
+      <!-- supporting signature over the timestamp -->  
+      <wsse:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">  
+        <ds:SignedInfo>  
+          <ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>  
+          <ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#hmac-sha1"/>  
+          <ds:Reference URI="#_0">  
+            <ds:Transforms>  
+              <ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>  
+            </ds:Transforms>  
+            <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>  
+            <ds:DigestValue>  
+              alRzyhjLgoUOYoh8cx4n75eTcUk=  
+            </ds:DigestValue>  
+          </ds:Reference>  
+        </ds:SignedInfo>  
+        <ds:SignatureValue>YZYjnVvSOVasAQqQxaaviTSWtqI=</ds:SignatureValue>  
+        <ds:KeyInfo>  
+          <wsse:SecurityTokenReference  
+            xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+            <wsse:Reference   
+              URI="http://fabrikam123.com/SCTi"/>  
+          </wsse:SecurityTokenReference>  
+        </ds:KeyInfo>  
+      </wsse:Signature>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:Register>  
+      <wscoor:ProtocolIdentifier>...</wscoor:ProtocolIdentifier>  
+      <wscoor:ParticipantProtocolService>  
+        <a:Address>https://... </a:Address>  
+      </wscoor:ParticipantProtocolService>  
+    </wscoor:Register>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+#### WSCoor 1.1 での Register  
+  
+```  
+<s:Envelope>  
+<s:Header>   
+<a:Action>http://docs.oasis-open.org/ws-tx/wscoor/2006/06/Register</a:Action>   
+<a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e</a:MessageID>  
+<a:ReplyTo>   
+<a:Address>https://...</a:Address>   
+</a:ReplyTo>  
+<a:To>https://...</a:To>   
+<wsse:Security   
+s:mustUnderstand="1"   
+xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"   
+xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+<wssu:Timestamp wssu:Id="_0" >   
+<wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+<wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+</wssu:Timestamp>   
+<wsc:SecurityContextToken>   
+<wssu:Identifier> http://fabrikam123.com/SCTi  
+</wssu:Identifier>   
+</wsc:SecurityContextToken>   
+<!-- supporting signature over the timestamp -->  
+<wsse:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">  
+<ds:SignedInfo>   
+<ds:CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>   
+<ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#hmac-sha1"/>   
+<ds:Reference URI="#_0">   
+<ds:Transforms>   
+<ds:Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/>   
+</ds:Transforms>   
+<ds:DigestMethod  
+Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>   
+<ds:DigestValue> alRzyhjLgoUOYoh8cx4n75eTcUk=  
+</ds:DigestValue>   
+</ds:Reference>   
+</ds:SignedInfo>  
+<ds:SignatureValue>YZYjnVvSOVasAQqQxaaviTSWtqI=  
+</ds:SignatureValue>  
+<ds:KeyInfo>   
+<wsse:SecurityTokenReference xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">  
+  <wsse:Reference URI="http://fabrikam123.com/SCTi"/>  
+</wsse:SecurityTokenReference>   
+</ds:KeyInfo>   
+</wsse:Signature>   
+</wsse:Security>   
+</s:Header>   
+<s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">   
+<wscoor:Register>   
+<wscoor:ProtocolIdentifier>...</wscoor:ProtocolIdentifier>  
+<wscoor:ParticipantProtocolService>   
+<a:Address>https://... </a:Address>  
+</wscoor:ParticipantProtocolService>   
+</wscoor:Register>   
+</s:Body>   
+</s:Envelope>  
+  
+```  
+  
+#### WSCoor 1.0 での Register Response  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>  
+      http://schemas.xmlsoap.org/ws/2004/10/wscoor/RegisterResponse  
+    </a:Action>  
+    <a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088d</a:MessageID>  
+    <a:RelatesTo>  
+      urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e        
+    </a:RelatesTo>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp>  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+    </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wscoor:RegisterResponse>  
+      <wscoor:CoordinatorProtocolService>  
+        <a:Address>https://...</a:Address>  
+        <a:ReferenceParameters>  
+          ...  
+        </a:ReferenceParameters>  
+      </wscoor:CoordinatorProtocolService>  
+    </wscoor:RegisterResponse>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+#### WSCoor 1.1 での Register Response  
+  
+```  
+<s:Envelope>  
+<s:Header>   
+<a:Action> http://docs.oasis-open.org/ws-tx/wscoor/2006/06/RegisterResponse  
+</a:Action>   
+<a:MessageID>urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088d</a:MessageID>  
+<a:RelatesTo> urn:uuid:ed418b86-a75e-4aea-9d4e-a5d0cb5c088e </a:RelatesTo>  
+<a:To>https://...</a:To>   
+<wsse:Security   
+s:mustUnderstand="1"   
+xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"   
+xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">   
+<wssu:Timestamp>   
+<wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+<wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+</wssu:Timestamp>   
+</wsse:Security>   
+</s:Header>   
+<s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">   
+<wscoor:RegisterResponse>   
+<wscoor:CoordinatorProtocolService>  
+<a:Address>https://...</a:Address>  
+<a:ReferenceParameters> ... </a:ReferenceParameters>  
+</wscoor:CoordinatorProtocolService>   
+</wscoor:RegisterResponse>   
+</s:Body>   
+</s:Envelope>  
+  
+```  
+  
+### 2 フェーズ コミット プロトコル メッセージ  
+ 次のメッセージは、2 フェーズ コミット \(2PC\) プロトコルに関連しています。  
+  
+#### WSAT 1.0 での Commit  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+    <a:Action>http://.../ws/2004/10/wsat/Commit</a:Action>  
+    <a:To>https://...</a:To>  
+    <wsse:Security   
+      s:mustUnderstand="1"   
+      xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"  
+      xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+      <wssu:Timestamp wssu:Id="_0" >  
+        <wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+        <wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+      </wssu:Timestamp>  
+   </wsse:Security>  
+  </s:Header>  
+  <s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+    <wsat:Commit />  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+#### WSAT 1.1 での Commit  
+  
+```  
+<s:Envelope>  
+<s:Header>   
+<a:Action>http://docs.oasis-open.org/ws-tx/wsat/2006/06</a:Action>  
+<a:To>https://...</a:To>   
+<wsse:Security   
+s:mustUnderstand="1"   
+xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"   
+xmlns:wssu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">   
+<wssu:Timestamp wssu:Id="_0" >   
+<wssu:Created>2005-12-15T23:36:13.827Z</wssu:Created>  
+<wssu:Expires>2005-12-15T23:41:13.827Z</wssu:Expires>  
+</wssu:Timestamp>   
+</wsse:Security>   
+</s:Header>   
+<s:Body xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">   
+<wsat:Commit />   
+</s:Body>   
+</s:Envelope>  
+  
+```  
+  
+### アプリケーション メッセージ  
+ 次のメッセージは、アプリケーション メッセージです。  
+  
+#### アプリケーション メッセージ \(要求\)  
+  
+```  
+<s:Envelope>  
+  <s:Header>  
+<!-- Addressing headers, all signed-->  
+    <wsse:Security s:mustUnderstand="1">  
+      <wssu:Timestamp wssu:Id="timestamp">   
+        <wssu:Created>2005-10-25T06:29:18.703Z</wssu:Created>  
+        <wssu:Expires>2005-10-25T06:34:18.703Z</wssu:Expires>  
+      </wssu:Timestamp>  
+      <wsse:BinarySecurityToken   
+          wssu:Id="IA_Certificate"   
+          ValueType="...#X509v3"   
+          EncodingType="...#Base64Binary">  
+        <!-- IA certificate -->  
+      </wsse:BinarySecurityToken>  
+      <e:EncryptedKey Id="encrypted_key">  
+            <!-- ephemeral key encrypted for PA certificate -->    
+        <e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+          <e:DataReference URI="#encrypted_body"/>  
+          <e:DataReference URI="#encrypted_CCi"/>  
+          <e:DataReference URI="#encrypted_issuedtokens"/>  
+        </e:ReferenceList>  
+      </e:EncryptedKey>  
+      <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">  
+        <!-- signature over Addressing headers, Timestamp, and Body -->  
+      </Signature>  
+    </wsse:Security>  
+    <wsse11:EncryptedHeader >  
+     <!-- encrypted wscoor:CoordinationContext header containing CCi -->  
+    </wsse11:EncryptedHeader>  
+    <wsse11:EncryptedHeader   
+      <!-- encrypted wst:IssuedTokens header containing SCTi -->  
+      <!-- wst:IssuedTokens header is taken verbatim from message #2 above, omitted for brevity -->  
+    </wsse11:EncryptedHeader>  
+  </s:Header>  
+  <s:Body wssu:Id="body">  
+    <!-- encrypted content of the Body element of the application message -->      
+    <e:EncryptedData Id="encrypted_body"   
+           Type="http://www.w3.org/2001/04/xmlenc#Content"   
+           xmlns:e="http://www.w3.org/2001/04/xmlenc#">  
+...  
+    </e:EncryptedData>  
+  </s:Body>  
+</s:Envelope>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transactional-support-in-system-servicemodel.md b/docs/framework/wcf/feature-details/transactional-support-in-system-servicemodel.md
new file mode 100644
index 00000000000..8b23d76e4a9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transactional-support-in-system-servicemodel.md
@@ -0,0 +1,42 @@
+---
+title: "System.ServiceModel でのトランザクション サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7e54ed3-d1e5-4aa7-a653-1300c6b304eb
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# System.ServiceModel でのトランザクション サポート
+このセクションのトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が提供するトランザクション機能について説明します。  
+  
+## このセクションの内容  
+ [ServiceModel トランザクションの属性](../../../../docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス用のトランザクションの動作を構成可能な 2 つの標準的な <xref:System.ServiceModel> 属性について説明します。  
+  
+ [ServiceModel トランザクションの構成](../../../../docs/framework/wcf/feature-details/servicemodel-transaction-configuration.md)  
+ サービスのトランザクションを有効にするために使用できるさまざまな構成設定について説明します。  
+  
+ [トランザクション フローの有効化](../../../../docs/framework/wcf/feature-details/enabling-transaction-flow.md)  
+ トランザクション フローを有効にする方法について説明します。  
+  
+ [方法 : トランザクション サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-transactional-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でトランザクション サービスを作成する実例を紹介します。  
+  
+ [トランザクション アプリケーションの診断](../../../../docs/framework/wcf/feature-details/diagnosing-transactional-applications.md)  
+ トランザクション アプリケーションをトラブルシューティングするために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されている管理機能および診断機能の使用方法について説明します。  
+  
+ [COM\+ と ServiceModel でのトランザクションの比較](../../../../docs/framework/wcf/feature-details/comparing-transactions-in-com-and-servicemodel.md)  
+ トランザクション COM\+ サービスの動作を、<xref:System.ServiceModel> 名前空間に定義されている属性を使用してシミュレートする方法について説明します。  
+  
+ [エンタープライズ サービスのトランザクション コンポーネントの統合](../../../../docs/framework/wcf/feature-details/integrating-enterprise-services-transactional-components.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスを、エンタープライズ サービスを使用するコードと統合する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transactions-in-wcf.md b/docs/framework/wcf/feature-details/transactions-in-wcf.md
new file mode 100644
index 00000000000..c28d8a12fac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transactions-in-wcf.md
@@ -0,0 +1,44 @@
+---
+title: "WCF でのトランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, 使用 (トランザクションを)"
+  - "Windows Communication Foundation, 使用 (トランザクションを)"
+ms.assetid: 1e8d04dd-b7cf-41e7-8560-54b4381beb0f
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WCF でのトランザクション
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランザクション機能では、複数のコンポーネントが同時に 1 つのデータ操作に参加できます。このセクションのトピックでは、この機能について詳しく説明します。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation のトランザクションの概要](../../../../docs/framework/wcf/feature-details/transactions-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供されるトランザクション機能の概要です。  
+  
+ [トランザクション モデル](../../../../docs/framework/wcf/feature-details/transaction-models.md)  
+ Microsoft が提供するさまざまなトランザクション プログラミング モデルを比較します。  
+  
+ [WS\-AtomicTransaction の使用](../../../../docs/framework/wcf/feature-details/using-ws-atomictransaction.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に実装されている相互運用可能なトランザクション伝達プロトコルである WS\-AT \(WS\-AtomicTransaction\) について説明します。  
+  
+ [System.ServiceModel でのトランザクション サポート](../../../../docs/framework/wcf/feature-details/transactional-support-in-system-servicemodel.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供するトランザクション機能について説明します。  
+  
+## 関連項目  
+  
+## 関連項目  
+ [基本的な WCF プログラミング](../../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+## 参照  
+ [信頼できるセッションの概要](../../../../docs/framework/wcf/feature-details/reliable-sessions-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transactions-overview.md b/docs/framework/wcf/feature-details/transactions-overview.md
new file mode 100644
index 00000000000..015b74cc671
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transactions-overview.md
@@ -0,0 +1,55 @@
+---
+title: "Windows Communication Foundation のトランザクションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "トランザクション [WCF]"
+  - "WCF, トランザクション"
+  - "Windows Communication Foundation, トランザクション"
+ms.assetid: c7757854-1207-4019-8b31-552578b7d570
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# Windows Communication Foundation のトランザクションの概要
+トランザクションを使用すると、一連の処理や操作を 1 つの不可分の実行単位にグループ化できます。  トランザクションとは、次の性質を持つ操作のコレクションです。  
+  
+-   原子性。  特定のトランザクションの下で完了したすべての更新は、コミットされて永続的に格納されるか、すべて中止されて前の状態にロールバックされるかのどちらかになります。  
+  
+-   一貫性。  トランザクション下で行う変更は、一貫性のある状態から別の一貫性のある状態への変換を表します。  たとえば、当座預金から普通預金への振り替えトランザクションでは、全体の預金残高は変更されません。  
+  
+-   分離  トランザクションが他の同時実行されているトランザクションに属するコミットされていない変更を監視することがなくなります。  分離により、同時実行の抽象概念が提供され、1 つのトランザクションが別のトランザクションの実行に予期しない影響を与える可能性がなくなります。  
+  
+-   持続性。  マネージ リソース \(データベース レコードなど\) に対して 1 度コミットされた更新は、障害に直面しても永続的に残ります。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、Web サービスアプリケーション内で分散トランザクションを作成できる一連の豊富な機能を提供します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、WS\-AtomicTransaction \(WS\-AT\) プロトコル サポートを実装します。このプロトコルにより [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、サードパーティ技術を使って作成された相互運用可能な Web サービスなど、相互運用可能アプリケーションにトランザクションをフローすることができます。  また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、OLE トランザクション プロトコル サポートも実装します。このプロトコルは、トランザクションのフローを有効にする相互運用可能な機能が必要とされないシナリオで使用することができます。  
+  
+ アプリケーション構成ファイルを使用してバインディングを構成し、トランザクション フローを有効にしたり無効にしたりできます。また、バインディングに目的のトランザクション プロトコルを設定できます。  さらに、構成ファイルを使用してサービス レベルでのトランザクションのタイムアウトを設定できます。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [トランザクション フローの有効化](../../../../docs/framework/wcf/feature-details/enabling-transaction-flow.md).  
+  
+ <xref:System.ServiceModel> 名前空間のトランザクション属性で次の設定が行えます。  
+  
+-   <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性を使用して、トランザクションのタイムアウトと分離レベルのフィルター処理を構成する。  
+  
+-   <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用して、トランザクション機能を有効にし、トランザクションの完了動作を構成する。  
+  
+-   コントラクト メソッドで <xref:System.ServiceModel.ServiceContractAttribute> 属性と <xref:System.ServiceModel.OperationContractAttribute> 属性を使用して、トランザクション フローの要求、許可、または拒否を行う。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [ServiceModel トランザクションの属性](../../../../docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md).  
+  
+## 参照  
+ [ServiceModel トランザクションの属性](../../../../docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md)   
+ [トランザクション フローの有効化](../../../../docs/framework/wcf/feature-details/enabling-transaction-flow.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-quotas.md b/docs/framework/wcf/feature-details/transport-quotas.md
new file mode 100644
index 00000000000..c5746023515
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-quotas.md
@@ -0,0 +1,123 @@
+---
+title: "トランスポート クォータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランスポート クォータ [WCF]"
+ms.assetid: 3e71dd3d-f981-4d9c-9c06-ff8abb61b717
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# トランスポート クォータ
+トランスポート クォータは、接続がリソースを過剰に消費している時期を特定するポリシー機構です。クォータとは、クォータ値を超えた場合に、それ以上のリソースの使用を禁止する確実な制限です。トランスポート クォータは、悪質な、または意図的でないサービス拒否攻撃を防ぎます。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] トランスポートのクォータの既定値は、控えめなリソース割り当てに基づいています。これらの既定値は開発環境、および小規模のインストール シナリオに適しています。インストールでリソースが不足している場合、または追加リソースが使用可能であるにもかかわらず接続が制限されている場合、サービス管理者は、トランスポート クォータを確認し、個別のクォータ値を調整する必要があります。  
+  
+## トランスポート クォータの種類  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランスポートには 3 種類のクォータがあります。  
+  
+-   *"タイムアウト"* は、長時間リソースを停滞させることによるサービス拒否攻撃を軽減します。  
+  
+-   *"メモリ割り当ての制限"* は、単一の接続によってシステム メモリが消耗され、他の接続へのサービス拒否が発生することを防止します。  
+  
+-   *"コレクション サイズの制限"* は、間接的に割り当てられるメモリ、または供給に制限のあるリソースの消費を抑制します。  
+  
+## トランスポート クォータの説明  
+ ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の標準トランスポートである、HTTP\(S\)、TCP\/IP、および名前つきパイプで利用できるトランスポート クォータについて説明します。カスタム トランスポートでは、このリストに含まれない独自の構成可能なクォータを公開できます。カスタム トランスポートのクォータについては、ドキュメントを参照してください。  
+  
+ 各クォータ設定では、種類、最小値、および既定値を設定します。クォータの最大値は、クォータの種類によって制限されます。コンピューターの制限により、クォータを最大値に設定できない場合もあります。  
+  
+|名前|型|最小<br /><br /> value|Default<br /><br /> value|説明|  
+|--------|-------|------------------|-----------------------|--------|  
+|`ChannelInitializationTimeout`|TimeSpan|1 目盛り|5 秒|最初の読み取り中に、接続が前文の送信を待機する最大時間。このデータは、認証が行われる前に受信されます。この設定は一般に、`ReceiveTimeout` クォータ値よりも大幅に小さな値になります。|  
+|`CloseTimeout`|TimeSpan|0|1 分|接続の終了を待機する最大時間。これを超えるとトランスポートで例外が発生します。|  
+|`ConnectionBufferSize`|整数|1|8 KB|基となるトランスポートの送信および受信バッファーのサイズ \(バイト単位\)。サイズの大きなメッセージを送信する場合、バッファー サイズを増やすとスループットを向上させることができます。|  
+|`IdleTimeout`|TimeSpan|0|2 分|プールされた接続が閉じられるまで、アイドル状態を維持できる最大時間。<br /><br /> この設定はプールされた接続にのみ適用されます。|  
+|`LeaseTimeout`|TimeSpan|0|5 分|プールされたアクティブな接続の最長有効期間。指定した期間が経過すると、現在の要求の処理後、接続は閉じられます。<br /><br /> この設定はプールされた接続にのみ適用されます。|  
+|`ListenBacklog`|整数|1|10|リスナーで未処理にできる接続の最大数。エンドポイントへの接続がこれ以上増加すると拒否されます。|  
+|`MaxBufferPoolSize`|Long|0|512 KB|トランスポートで再使用可能なメッセージ バッファーのプール専用にするメモリの最大値 \(バイト単位\)。プールがメッセージ バッファーを供給できない場合、新しいバッファーが一時的な使用のために割り当てられます。<br /><br /> 多数のチャネル ファクトリまたはリスナーを作成するインストールでは、バッファー プールに多くのメモリが割り当てられることがあります。このバッファー サイズを縮小すると、このシナリオにおけるメモリ使用量を大幅に削減できることがあります。|  
+|`MaxBufferSize`|整数|1|64 KB|ストリーミング データ用に使用されるバッファーの最大サイズ \(バイト単位\)。このトランスポート クォータが設定されていない、またはトランスポートがストリーミングを使用しない場合、このクォータ値は `MaxReceivedMessageSize` クォータ値と <xref:System.Int32.MaxValue> の小さい方と同じになります。|  
+|`MaxOutboundConnectionsPerEndpoint`|整数|1|10|特定のエンドポイントに関連付けることのできる送信接続の最大数。<br /><br /> この設定はプールされた接続にのみ適用されます。|  
+|`MaxOutputDelay`|TimeSpan|0|200 ミリ秒|送信操作後に 1 回の操作で追加メッセージをバッチ処理するために待機する最大時間。基になるトランスポートのバッファーがいっぱいになると、メッセージはより早い時期に送信されます。追加のメッセージの送信によって遅延時間がリセットされることはありません。|  
+|`MaxPendingAccepts`|整数|1|1|リスナーで待機状態にできるチャネルの受け入れの最大数。<br /><br /> 受け入れの完了と新しい受け入れの開始との間には、時間的な間隔があります。このコレクション サイズを大きくすると、この時間間隔内に接続するクライアントが切断されるのを防ぎます。|  
+|`MaxPendingConnections`|整数|1|10|アプリケーションによる受け入れをリスナーで待機できる最大接続数。このクォータ値を超過すると、新規の受信接続は受け入れられるのを待機せずに切断されます。<br /><br /> メッセージ セキュリティのような接続機能では、クライアントは複数の接続を開くことがあります。このクォータ値を設定する場合、サービス管理者はこのような追加の接続も考慮する必要があります。|  
+|`MaxReceivedMessageSize`|Long|1|64 KB|ヘッダーを含む、受信メッセージの最大サイズ \(バイト単位\)。これを超えるとトランスポートで例外が発生します。|  
+|`OpenTimeout`|TimeSpan|0|1 分|接続の確立を待機する最大時間。これを超えるとトランスポートで例外が発生します。|  
+|`ReceiveTimeout`|TimeSpan|0|10 分|読み取り操作の完了を待機する最大時間。これを超えるとトランスポートで例外が発生します。|  
+|`SendTimeout`|Timespan|0|1 分|書き込み操作の完了を待機する最大時間。これを超えるとトランスポートで例外が発生します。|  
+  
+ トランスポート クォータ `MaxPendingConnections` および `MaxOutboundConnectionsPerEndpoint` は、バインディングまたは構成を使用して設定される場合には、`MaxConnections` トランスポート クォータと呼ばれる単一のクォータに結合されます。これらのクォータ値を個別に設定できるのは、バインド要素に限られます。`MaxConnections` トランスポート クォータでは、最小値と既定値が同じになります。  
+  
+## トランスポート クォータの設定  
+ トランスポート クォータは、トランスポート バインド要素、トランスポート バンディング、アプリケーション構成、またはホスト ポリシーを介して設定されます。このドキュメントでは、ホスト ポリシーを介したトランスポートの設定については説明しません。ホスト ポリシー クォータの設定については、基になるトランスポートのドキュメントを参照してください。Http.sys ドライバーのクォータ設定については「[HTTP および HTTPS の構成](../../../../docs/framework/wcf/feature-details/configuring-http-and-https.md)」を参照してください。HTTP、TCP\/IP、および名前付きパイプの接続で Windows の制限を構成する詳細については、マイクロソフト サポート技術情報を検索してください。  
+  
+ 他の種類のクォータは、トランスポートへ間接的に適用されます。トランスポートがメッセージをバイトに変換するために使用するメッセージ エンコーダーには、独自のクォータ設定があります。ただし、これらのクォータは使用されているトランスポートの種類に依存しません。  
+  
+### バインド要素によるトランスポート クォータの制御  
+ バインド要素を介してトランスポート クォータを設定した場合、トランスポートの動作を最も柔軟に制御できます。閉じる、開く、受信、送信の各操作の既定のタイムアウトは、チャネルを構築したときにバインディングから設定されます。  
+  
+|名前|HTTP|TCP\/IP|名前付きパイプ|  
+|--------|----------|-------------|-------------|  
+|`ChannelInitializationTimeout`||X|X|  
+|`CloseTimeout`||||  
+|`ConnectionBufferSize`||X|X|  
+|`IdleTimeout`||X|X|  
+|`LeaseTimeout`||X||  
+|`ListenBacklog`||X||  
+|`MaxBufferPoolSize`|X|X|X|  
+|`MaxBufferSize`|X|X|X|  
+|`MaxOutboundConnectionsPerEndpoint`||X|X|  
+|`MaxOutputDelay`||X|X|  
+|`MaxPendingAccepts`||X|X|  
+|`MaxPendingConnections`||X|X|  
+|`MaxReceivedMessageSize`|X|X|X|  
+|`OpenTimeout`||||  
+|`ReceiveTimeout`||||  
+|`SendTimeout`||||  
+  
+### バインディングによるトランスポート クォータの制御  
+ バインディングによるトランスポート クォータの設定では、選択対象のクォータがセットにまとめられます。ただし、最も一般的に使用するクォータ値にはアクセスできます。  
+  
+|名前|HTTP|TCP\/IP|名前付きパイプ|  
+|--------|----------|-------------|-------------|  
+|`ChannelInitializationTimeout`||||  
+|`CloseTimeout`|X|X|X|  
+|`ConnectionBufferSize`||||  
+|`IdleTimeout`||||  
+|`LeaseTimeout`||||  
+|`ListenBacklog`||X||  
+|`MaxBufferPoolSize`|X|X|X|  
+|`MaxBufferSize`|1|X|X|  
+|`MaxOutboundConnectionsPerEndpoint`||2|2|  
+|`MaxOutputDelay`||||  
+|`MaxPendingAccepts`||||  
+|`MaxPendingConnections`||2|2|  
+|`MaxReceivedMessageSize`|X|X|X|  
+|`OpenTimeout`|X|X|X|  
+|`ReceiveTimeout`|X|X|X|  
+|`SendTimeout`|X|X|X|  
+  
+1.  `MaxBufferSize` トランスポート クォータは、`BasicHttp` バインディングでのみ使用可能です。`WSHttp` バインディングは、ストリーミング トランスポート モードがサポートされないシナリオに対応します。  
+  
+2.  トランスポート クォータ `MaxPendingConnections` および `MaxOutboundConnectionsPerEndpoint` は、`MaxConnections` トランスポート クォータと呼ばれる単一のクォータに結合されます。  
+  
+### 構成によるトランスポート クォータの制御  
+ アプリケーション構成からバインディング上のプロパティに直接アクセスして、同じトランスポート クォータを設定できます。構成ファイルでは、トランスポート クォータの名前は必ず小文字で始めます。たとえば、バインディングの `CloseTimeout` プロパティは構成では `closeTimeout` 設定に対応し、バインディングの `MaxConnections` プロパティは構成では `maxConnections` 設定に対応します。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement>   
+ <xref:System.ServiceModel.Channels.TransportBindingElement>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security-overview.md b/docs/framework/wcf/feature-details/transport-security-overview.md
new file mode 100644
index 00000000000..dc3ac567f65
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security-overview.md
@@ -0,0 +1,128 @@
+---
+title: "トランスポート セキュリティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00959326-aa9d-44d0-af61-54933d4adc7f
+caps.latest.revision: 23
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 23
+---
+# トランスポート セキュリティの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランスポート セキュリティ機構は、使用するバインディングとトランスポートによって異なります。 たとえばを使用する場合、 <xref:System.ServiceModel.WSHttpBinding>クラスで、トランスポートは HTTP であり、トランスポート セキュリティで保護するための主要機構 Secure Sockets Layer (SSL) over HTTP、HTTPS と呼ばします。 このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] システムに用意されたバインディングで使用する主要なトランスポート セキュリティ機構について説明します。  
+  
+> [!NOTE]
+>  SSL セキュリティを .NET Framework 3.5 以降と共に使用すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは、証明書ストア内の中間証明書と SSL ネゴシエーション中に受信した中間証明書の両方を使用して、サービスの証明書に対して証明書チェーンの検証を実行します。 .NET Framework 3.0 では、ローカルの証明書ストアにインストールされている中間証明書のみが使用されます。  
+  
+> [!WARNING]
+>  トランスポート セキュリティを使用すると、 <xref:System.Treading.Thread.CurrentPrincipal%2A>プロパティが上書きされる可能性があります。 設定しないように、 <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.PrincipalPermission%2A> "なし"にします。 <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>はサービスの説明で設定できるサービス動作です。  
+  
+## <a name="basichttpbinding"></a>BasicHttpBinding  
+ 既定では、 <xref:System.ServiceModel.BasicHttpBinding>クラスでは、セキュリティは提供されません。 このバインディングは、セキュリティを実装していない Web サービス プロバイダーとの相互運用性のためにデザインされています。 ただしを設定することでセキュリティに切り替えることができます、<xref:System.ServiceModel.BasicHttpSecurity.Mode%2A>プロパティ以外の値を<xref:System.ServiceModel.BasicHttpSecurityMode>します。 トランスポート セキュリティを有効にする、プロパティを設定<xref:System.ServiceModel.BasicHttpSecurityMode>します。  
+  
+### <a name="interoperation-with-iis"></a>IIS との相互運用性  
+ <xref:System.ServiceModel.BasicHttpBinding>クラスは、既存の Web サービスと相互運用する、主に使用され、それらのサービスの多くでインターネット インフォメーション サービス (IIS) によってをホストします。 そのため、このバインディングのトランスポート セキュリティは、IIS サイトとシームレスに相互運用できるようにデザインされています。 これは、セキュリティ モードを設定することで<xref:System.ServiceModel.BasicHttpSecurityMode>し、クライアント資格情報の種類を設定します。 資格情報の種類の値は、IIS ディレクトリのセキュリティ機構に対応しています。 モードを設定し、資格情報の種類を Windows に設定するコードを次に示します。 この構成は、クライアントとサーバーが同じ Windows ドメインに存在する場合に使用できます。  
+  
+ [!code-csharp[c_ProgrammingSecurity#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs#10)]
+ [!code-vb[c_ProgrammingSecurity#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb#10)]  
+  
+ または、次のように構成します。  
+  
+```xml  
+<bindings>  
+  <basicHttpBinding>  
+    <binding name="SecurityByTransport">  
+      <security mode="Transport">  
+        <transport clientCredentialType="Windows" />  
+       </security>  
+     </binding>  
+  </basicHttpBinding>  
+</bindings>  
+```  
+  
+ 以下のセクションでは、その他のクライアント資格情報の種類について説明します。  
+  
+#### <a name="basic"></a>基本  
+ これは、IIS の基本認証方法に対応しています。 このモードを使用する場合は、Windows ユーザー アカウントと、適切な NTFS ファイル システムのアクセス許可を使用して IIS サーバーを構成する必要があります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iis601](../../../../includes/iis601-md.md)]を参照してください[基本認証の有効化と領域名の構成](http://go.microsoft.com/fwlink/?LinkId=88592)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iisver](../../../../includes/iisver-md.md)]、を参照してください[IIS 7.0 Beta: Configure Basic Authentication](http://go.microsoft.com/fwlink/?LinkId=88593)します。  
+  
+#### <a name="certificate"></a>証明書  
+ IIS には、クライアントに証明書を使用してログオンすることを要求するオプションがあります。 この機能により、IIS はクライアント証明書を Windows アカウントにマップすることもできます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iis601](../../../../includes/iis601-md.md)]を参照してください[Enabling Client Certificates in IIS 6.0](http://go.microsoft.com/fwlink/?LinkId=88594)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iisver](../../../../includes/iisver-md.md)]を参照してください[IIS 7.0 Beta: Configuring Server Certificates in IIS 7.0](http://go.microsoft.com/fwlink/?LinkId=88595)します。  
+  
+#### <a name="digest"></a>Digest  
+ ダイジェスト認証は基本認証と似ていますが、資格情報をクリア テキストではなくハッシュとして送信できるという利点があります。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iis601](../../../../includes/iis601-md.md)]を参照してください[IIS 6.0 のダイジェスト認証](http://go.microsoft.com/fwlink/?LinkID=88443)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iisver](../../../../includes/iisver-md.md)]、を参照してください[IIS 7.0 Beta: Configure Digest Authentication](http://go.microsoft.com/fwlink/?LinkId=88596)します。  
+  
+#### <a name="windows"></a>Windows  
+ これは、IIS の統合 Windows 認証に対応しています。 この値に設定する場合、サーバーは、Kerberos プロトコルを使用する Windows ドメインにドメイン コントローラーとして存在することにもなっています。 サーバーが Kerberos ベースのドメインに存在しない場合、または Kerberos システムに障害が発生した場合は、次のセクションで説明する NTLM (NT LAN Manager) 値を使用できます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iis601](../../../../includes/iis601-md.md)]を参照してください[IIS 6.0 で統合 Windows 認証](http://go.microsoft.com/fwlink/?LinkId=88597)します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[iisver](../../../../includes/iisver-md.md)]を参照してください[IIS 7.0 Beta: Configuring Server Certificates in IIS 7.0](http://go.microsoft.com/fwlink/?LinkId=88595)します。  
+  
+#### <a name="ntlm"></a>NTLM  
+ この値を使用すると、Kerberos プロトコルが失敗した場合に、サーバーは、NTLM を使用して認証を実行できます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]IIS を構成して[!INCLUDE[iis601](../../../../includes/iis601-md.md)]を参照してください[強制的に NTLM 認証](http://go.microsoft.com/fwlink/?LinkId=88598)します。 [!INCLUDE[iisver](../../../../includes/iisver-md.md)] では、Windows 認証に NTLM 認証が含まれます。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][IIS 7.0 Beta: Configuring Server Certificates in IIS 7.0](http://go.microsoft.com/fwlink/?LinkID=88595)します。  
+  
+## <a name="wshttpbinding"></a>WsHttpBinding  
+ <xref:System.ServiceModel.WSHttpBinding>クラスが ws-を実装するサービスと相互運用のために設計されています * の仕様です。 このバインディングのトランスポート セキュリティは、SSL (Secure Sockets Layer) over HTTP または HTTPS です。 SSL を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションを作成するには、IIS を使用してアプリケーションをホストします。 自己ホスト型アプリケーションを作成する場合は、HttpCfg.exe ツールを使用して、X.509 証明書をコンピューターの特定のポートにバインドします。 ポート番号は、エンドポイント アドレスとして [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションの一部に指定されます。 トランスポート モードを使用する場合は、エンドポイント アドレスに HTTPS プロトコルを含める必要があります。そうしないと、実行時に例外が発生します。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md)します。  
+  
+ クライアントの認証設定、 <xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType%2A>のプロパティ、 <xref:System.ServiceModel.HttpTransportSecurity>クラスのいずれかに、 <xref:System.ServiceModel.HttpClientCredentialType>列挙値。 列挙値が同一のクライアント資格情報の種類を<xref:System.ServiceModel.BasicHttpBinding> IIS のサービスでホストされるように設計されています。  
+  
+ クライアント資格情報の種類が Windows の場合に使用するバインディングの例を次に示します。  
+  
+ [!code-csharp[c_ProgrammingSecurity#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs#11)]
+ [!code-vb[c_ProgrammingSecurity#11](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb#11)]  
+  
+## <a name="wsdualhttpbinding"></a>WSDualHttpBinding  
+ このバインディングが提供するのは、トランスポート レベルのセキュリティではなく、メッセージ レベルのセキュリティだけです。  
+  
+## <a name="nettcpbinding"></a>NetTcpBinding  
+ <xref:System.ServiceModel.NetTcpBinding>クラスは、メッセージ トランスポートに TCP を使用します。 トランスポート モードのセキュリティは、TLS (Transport Layer Security) over TCP を実装することによって実現されます。 TLS 実装は、オペレーティング システムによって提供されます。  
+  
+ 設定して、クライアントの資格情報の種類を指定することも、 <xref:System.ServiceModel.TcpTransportSecurity.ClientCredentialType%2A>のプロパティ、 <xref:System.ServiceModel.TcpTransportSecurity>クラスのいずれかに、 <xref:System.ServiceModel.TcpClientCredentialType>値は、次のコードに示すようにします。  
+  
+ [!code-csharp[c_ProgrammingSecurity#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs#12)]
+ [!code-vb[c_ProgrammingSecurity#12](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb#12)]  
+  
+#### <a name="client"></a>クライアント  
+ クライアントを使用して、証明書を指定する必要があります、 <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A>のメソッド、 <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential>クラスです。  
+  
+> [!NOTE]
+>  Windows セキュリティを使用している場合には、証明書は不要です。  
+  
+ 証明書の拇印を使用するコードを次に示します。拇印により、証明書が一意に識別されます。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]証明書を参照してください[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)します。  
+  
+ [!code-csharp[c_ProgrammingSecurity#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs#13)]
+ [!code-vb[c_ProgrammingSecurity#13](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb#13)]  
+  
+ または、証明書をクライアントの構成に指定を使用して、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)動作セクション内の要素。  
+  
+```xml  
+<behaviors>  
+  <behavior>  
+   <clientCredentials>  
+     <clientCertificate findValue= "101010101010101010101010101010000000000"   
+      storeLocation="LocalMachine" storeName="My"   
+      X509FindType="FindByThumbPrint"/>  
+     </clientCertificate>  
+   </clientCredentials>  
+ </behavior>  
+</behaviors>    
+```  
+  
+## <a name="netnamedpipebinding"></a>NetNamedPipeBinding  
+ <xref:System.ServiceModel.NetNamedPipeBinding>クラスが効率的なマシン間の通信用に設計されています。 つまり、プロセスの名前付きパイプ チャネルは、同じコンピューターで実行されている間に作成できる、同じネットワーク上の&2; 台のコンピューターです。 このバインディングが提供するのは、トランスポート レベルのセキュリティだけです。 このバインディングを使用してアプリケーションを作成する場合は、エンドポイント アドレスにプロトコルとして "net.pipe" を含める必要があります。  
+  
+## <a name="wsfederationhttpbinding"></a>WSFederationHttpBinding  
+ このバインディングが発行されたトークンを使用して、HTTPS と呼ばれる、HTTP 経由で SSL を使用するトランスポート セキュリティを使用する場合 (<xref:System.ServiceModel.WSFederationHttpSecurityMode>)。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]フェデレーション アプリケーションを参照してください[フェデレーションと発行されたトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md)します。  
+  
+## <a name="netpeertcpbinding"></a>NetPeerTcpBinding  
+ <xref:System.ServiceModel.NetPeerTcpBinding>クラスはセキュリティで保護されたトランスポートでは、ピア ツー ピア ネットワーク機能を使用して効率的に通信するためです。 クラスとバインディングの名前が示すように、プロトコルは TCP です。 セキュリティ モードが Transport に設定されている場合、このバインディングは TLS over TCP を実装します。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]ピア ツー ピア機能を参照してください[ピア ツー ピア ネットワーク](../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)します。  
+  
+## <a name="msmqintegrationbinding-and-netmsmqbinding"></a>MsmqIntegrationBinding と NetMsmqBinding  
+ トランスポートの詳細についてはセキュリティとメッセージ キュー (MSMQ と呼ばれていた) を参照してください[トランスポート セキュリティを使用してメッセージをセキュリティで保護する](../../../../docs/framework/wcf/feature-details/securing-messages-using-transport-security.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security-with-an-anonymous-client.md b/docs/framework/wcf/feature-details/transport-security-with-an-anonymous-client.md
new file mode 100644
index 00000000000..50ab9c34343
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security-with-an-anonymous-client.md
@@ -0,0 +1,125 @@
+---
+title: "トランスポート セキュリティと匿名クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 056653a5-384e-4a02-ae3c-1b0157d2ccb4
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# トランスポート セキュリティと匿名クライアント
+この [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] シナリオでは、トランスポート セキュリティ \(HTTPS\) を使用して機密性と整合性を確保します。サーバーは SSL \(Secure Sockets Layer\) 証明書で認証される必要があり、クライアントはサーバーの証明書を信頼する必要があります。クライアントを認証する機構はないため、匿名となります。  
+  
+ サンプル アプリケーションについては、「[WS トランスポート セキュリティ](../../../../docs/framework/wcf/samples/ws-transport-security.md)」を参照してください。トランスポート セキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)」を参照してください。  
+  
+ サービスでの証明書の使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」および「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。  
+  
+ ![匿名クライアントを使用する場合のトランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/media/8fa2e931-0cfb-4aaa-9272-91d652b85d8d.gif "8fa2e931\-0cfb\-4aaa\-9272\-91d652b85d8d")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|トランスポート|  
+|相互運用性|既存の Web サービスとクライアントを使用する|  
+|認証 \(サーバー\)<br /><br /> 認証 \(クライアント\)|○<br /><br /> アプリケーション レベル \([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサポートなし\)|  
+|整合性|○|  
+|機密性|○|  
+|トランスポート|HTTPS|  
+|バインディング|<xref:System.ServiceModel.WsHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、トランスポート セキュリティを使用してエンドポイントを作成する方法を示しています。  
+  
+ [!code-csharp[c_SecurityScenarios#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#5)]
+ [!code-vb[c_SecurityScenarios#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#5)]  
+  
+### 構成  
+ 次のコードは、次に示す構成を使用して同一のエンドポイントをセットアップします。クライアントを認証する機構はないため、匿名となります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="ServiceModel.Calculator">  
+        <endpoint address="http://localhost/Calculator"   
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="WSHttpBinding_ICalculator"   
+                  name="SecuredByTransportEndpoint"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator">  
+          <security mode="Transport">  
+            <transport clientCredentialType="None" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用します。例 :  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ [!code-csharp[c_SecurityScenarios#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#6)]
+ [!code-vb[c_SecurityScenarios#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#6)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用して、サービスをセットアップできます。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Transport">  
+            <transport clientCredentialType="None" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="https://machineName/Calculator"   
+                binding="wsHttpBinding"  
+                bindingConfiguration="WSHttpBinding_ICalculator"   
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator" />  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [WS トランスポート セキュリティ](../../../../docs/framework/wcf/samples/ws-transport-security.md)   
+ [トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security-with-basic-authentication.md b/docs/framework/wcf/feature-details/transport-security-with-basic-authentication.md
new file mode 100644
index 00000000000..9136e972b07
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security-with-basic-authentication.md
@@ -0,0 +1,124 @@
+---
+title: "基本認証でのトランスポート セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b54f491d-196b-4279-876c-76b83ec0442c
+caps.latest.revision: 18
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 18
+---
+# 基本認証でのトランスポート セキュリティ
+次の図は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のサービスとクライアントを示しています。  サーバーには、SSL \(Secure Sockets Layer\) に使用できる有効な X509 証明書が必要であり、クライアントはサーバーの証明書を信頼する必要があります。  さらに、Web サービスには使用可能な SSL が既に実装されています。  インターネット インフォメーション サービス \(IIS\) で基本認証を有効にする方法についての[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=83822](http://go.microsoft.com/fwlink/?LinkId=83822)」を参照してください。  
+  
+ ![基本認証を使用する場合のトランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/media/securedbyusername.gif "SecuredbyUsername")  
+  
+|特徴|説明|  
+|--------|--------|  
+|セキュリティ モード|Transport|  
+|相互運用性|既存の Web サービス クライアントとサービスを使用する|  
+|認証 \(サーバー\)<br /><br /> 認証 \(クライアント\)|○ \(HTTPS を使用\)<br /><br /> ○ \(ユーザー名とパスワードを使用\)|  
+|整合性|はい|  
+|機密性|はい|  
+|Transport|HTTPS|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。  次のいずれかの操作を行います。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードでは、転送セキュリティ用の Windows ドメイン ユーザー名とパスワードを使用するサービス エンドポイントを作成する方法を示します。  サービスには、クライアントに対する認証を行うための X 509 証明書が必要になります。  詳細については、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」および「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。  
+  
+ [!code-csharp[C_SecurityScenarios#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#1)]
+ [!code-vb[C_SecurityScenarios#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#1)]  
+  
+## 構成  
+ 次の例では、トランスポート レベルのセキュリティの基本認証を使用するサービスを構成します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+            <wsHttpBinding>  
+                <binding name="UsernameWithTransport">  
+                    <security mode="Transport">  
+                        <transport clientCredentialType="Basic" />  
+                    </security>  
+                </binding>  
+            </wsHttpBinding>  
+        </bindings>  
+        <services>  
+            <service name="BasicAuthentication.Calculator">  
+                <endpoint address="https://localhost/Calculator"  
+                          binding="wsHttpBinding"   
+                          bindingConfiguration="UsernameWithTransport"  
+                          name="BasicEndpoint"   
+                          contract="BasicAuthentication.ICalculator" />  
+            </service>  
+        </services>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+## Client  
+  
+### コード  
+ 次のコードは、ユーザー名とパスワードが含まれるクライアント コードを示しています。  ユーザーは、有効な Windows ユーザー名とパスワードを指定する必要があります。  ユーザー名とパスワードを返すコードは、ここに示されていません。  ダイアログボックスまたは他のインターフェースを使用して、ユーザーにこれらの情報を照会してください。  
+  
+> [!NOTE]
+>  ユーザー名とパスワードは、コードを使ってのみ設定できます。  
+  
+ [!code-csharp[C_SecurityScenarios#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#2)]
+ [!code-vb[C_SecurityScenarios#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#2)]  
+  
+### 構成  
+ 次のコードは、クライアントの構成を示しています。  
+  
+> [!NOTE]
+>  構成を使用してユーザー名とパスワードを設定することはできません。  ここに示した構成には、ユーザー名とパスワードを設定するためのコードを補う必要があります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="WSHttpBinding_ICalculator" >  
+          <security mode="Transport">  
+            <transport clientCredentialType="Basic" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="https://machineName/Calculator"   
+                binding="wsHttpBinding"  
+                bindingConfiguration="WSHttpBinding_ICalculator"   
+                contract="ICalculator"  
+                name="WSHttpBinding_ICalculator" />  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A>   
+ <xref:System.ServiceModel.Security.UserNamePasswordClientCredential>   
+ [証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)   
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [\<clientCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security-with-certificate-authentication.md b/docs/framework/wcf/feature-details/transport-security-with-certificate-authentication.md
new file mode 100644
index 00000000000..5527ebc8950
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security-with-certificate-authentication.md
@@ -0,0 +1,150 @@
+---
+title: "トランスポート セキュリティと証明書認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d726b71-4d8b-4581-a3bb-02b9af51d11b
+caps.latest.revision: 20
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 20
+---
+# トランスポート セキュリティと証明書認証
+このトピックでは、トランスポート セキュリティを使用する場合にサーバーとクライアントの認証に X.509 証明書を使用する方法について説明します。X.509 証明書の詳細については、「[X.509 公開キー証明書](http://msdn.microsoft.com/library/bb540819\(VS.85\).aspx)」を参照してください。証明書は、証明機関によって発行される必要があります。多くの場合、証明機関はサードパーティの証明書発行者です。Windows サーバー ドメインでは、そのドメインのクライアント コンピューターに対して証明書を発行する際に Active Directory 証明書サービスを使用できます。詳細については、「[Windows 2008 R2 証明書サービス](http://go.microsoft.com/fwlink/?LinkID=209949&clcid=0x409)」を参照してください。このシナリオでは、Secure Sockets Layer \(SSL\) を使用して構成されたインターネット インフォメーション サービス \(IIS\) でサービスをホストします。サービスは、クライアントがサーバーの ID を確認するための SSL \(X.509\) 証明書を使用して構成されます。クライアントも、サービスがクライアントの ID を確認するための X.509 証明書を使用して構成されます。サーバーの証明書はクライアントによって信頼されている必要があり、クライアントの証明書はサーバーによって信頼されている必要があります。サービスとクライアントが互いの ID を確認する方法の実際のしくみについては、このトピックでは説明しません。詳細については、Wikipedia の「[デジタル署名](http://go.microsoft.com/fwlink/?LinkId=253157)」を参照してください。  
+  
+ このシナリオでは、次の図に示すような要求\/応答のメッセージ パターンを実装します。  
+  
+ ![証明書を使用した、セキュリティで保護された転送](../../../../docs/framework/wcf/feature-details/media/8f7b8968-899f-4538-a9e8-0eaa872a291c.gif "8f7b8968\-899f\-4538\-a9e8\-0eaa872a291c")  
+  
+ サービスでの証明書の使用方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書の使用](../../../../docs/framework/wcf/feature-details/working-with-certificates.md)」および「[方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)」を参照してください。このシナリオのさまざまな特性を次の表に示します。  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|トランスポート|  
+|相互運用性|既存の Web サービス クライアントおよびサービスとの相互運用性|  
+|認証 \(サーバー\)<br /><br /> 認証 \(クライアント\)|○ \(SSL 証明書を使用\)<br /><br /> ○ \(X.509 証明書を使用\)|  
+|データの整合性|○|  
+|データの機密性|○|  
+|トランスポート|HTTPS|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding>|  
+  
+## サービスの構成  
+ このシナリオのサービスは IIS でホストされるので、web.config ファイルを使用して構成します。次の web.config は、トランスポート セキュリティと X.509 クライアント資格情報を使用するように <xref:System.ServiceModel.WSHttpBinding> を構成する方法を示しています。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <protocolMapping>  
+      <add scheme="https" binding="wsHttpBinding" />  
+    </protocolMapping>  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- configure wsHttp binding with Transport security mode and clientCredentialType as Certificate -->  
+        <binding>  
+          <security mode="Transport">  
+            <transport clientCredentialType="Certificate"/>              
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>            
+           <serviceDebug includeExceptionDetailInFaults="True" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## クライアントの構成  
+ クライアントはコードまたは app.config ファイルで構成できます。次の例は、クライアントをコードで構成する方法を示しています。  
+  
+```vb  
+// Create the binding.  
+WSHttpBinding myBinding = new WSHttpBinding();  
+myBinding.Security.Mode = SecurityMode.Transport;  
+myBinding.Security.Transport.ClientCredentialType =  
+   HttpClientCredentialType.Certificate;  
+  
+// Create the endpoint address. Note that the machine name   
+// must match the subject or DNS field of the X.509 certificate  
+// used to authenticate the service.   
+EndpointAddress ea = new  
+   EndpointAddress("https://localhost/CalculatorService/service.svc");  
+  
+// Create the client. The code for the calculator   
+// client is not shown here. See the sample applications  
+// for examples of the calculator code.  
+CalculatorClient cc =  
+   new CalculatorClient(myBinding, ea);  
+  
+// The client must specify a certificate trusted by the server.  
+cc.ClientCredentials.ClientCertificate.SetCertificate(  
+    StoreLocation.CurrentUser,  
+    StoreName.My,  
+    X509FindType.FindBySubjectName,  
+    "contoso.com");  
+  
+// Begin using the client.  
+Console.WriteLine(cc.Add(100, 1111));  
+//...  
+cc.Close();  
+  
+```  
+  
+ また、次の例のように App.config ファイルでクライアントを構成することもできます。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <!-- this endpoint has an https: address -->  
+      <endpoint address=" https://localhost/CalculatorService/service.svc "   
+                behaviorConfiguration="endpointCredentialBehavior"  
+                binding="wsHttpBinding"   
+                bindingConfiguration="Binding1"   
+                contract="Microsoft.Samples.TransportSecurity.ICalculator"/>  
+    </client>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="endpointCredentialBehavior">  
+          <clientCredentials>  
+            <clientCertificate findValue="contoso.com"  
+                               storeLocation="CurrentUser"  
+                               storeName="My"  
+                               x509FindType="FindBySubjectName" />  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- configure wsHttpbinding with Transport security mode  
+                   and clientCredentialType as Certificate -->  
+        <binding name="Binding1">  
+          <security mode="Transport">  
+            <transport clientCredentialType="Certificate"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  </system.serviceModel>  
+  
+<startup><supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/></startup></configuration>  
+  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security-with-windows-authentication.md b/docs/framework/wcf/feature-details/transport-security-with-windows-authentication.md
new file mode 100644
index 00000000000..d1d3c23a06e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security-with-windows-authentication.md
@@ -0,0 +1,127 @@
+---
+title: "トランスポート セキュリティと Windows 認証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96dd26e2-46e7-4de0-9a29-4fcb05bf187b
+caps.latest.revision: 17
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 17
+---
+# トランスポート セキュリティと Windows 認証
+次のシナリオでは、Windows セキュリティによって保護されている [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントおよびサービスを示します。プログラミング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : Windows 資格情報でサービスをセキュリティで保護する](../../../../docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md)」を参照してください。  
+  
+ イントラネットの Web サービスでは人事情報を表示しています。クライアントは Windows フォーム アプリケーションです。このアプリケーションは、Kerberos コントローラーで保護されたドメインに展開されています。  
+  
+ ![Windows 認証を使用する場合のトランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/media/securedbywindows.gif "SecuredByWindows")  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|トランスポート|  
+|相互運用性|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のみ|  
+|認証 \(サーバー\)<br /><br /> 認証 \(クライアント\)|○ \(Windows 統合認証を使用\)<br /><br /> ○ \(Windows 統合認証を使用\)|  
+|整合性|○|  
+|機密性|○|  
+|トランスポート|NET.TCP|  
+|バインディング|<xref:System.ServiceModel.NetTcpBinding>|  
+  
+## サービス  
+ 次のコードと構成は、別々に実行します。以下のいずれかを実行します。  
+  
+-   構成を使用せずに、コードを使用してスタンドアロン サービスを作成します。  
+  
+-   提供された構成を使用してサービスを作成しますが、エンドポイントを定義しません。  
+  
+### コード  
+ 次のコードは、Windows セキュリティを使用するサービス エンドポイントの作成方法を示します。  
+  
+ [!code-csharp[C_SecurityScenarios#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#3)]
+ [!code-vb[C_SecurityScenarios#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#3)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用して、サービス エンドポイントをセットアップできます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors />  
+    <services>  
+      <service behaviorConfiguration="" name="ServiceModel.Calculator">  
+        <endpoint address="net.tcp://localhost:8008/Calculator"   
+                  binding="netTcpBinding"  
+          bindingConfiguration="WindowsClientOverTcp"   
+                  name="WindowsClientOverTcp"  
+                  contract="ServiceModel.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="WindowsClientOverTcp">  
+          <security mode="Transport">  
+            <transport clientCredentialType="Windows" />  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client />  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+ 次のコードと構成は、別々に実行します。以下のいずれかの操作を行います。  
+  
+-   コード \(およびクライアント コード\) を使用してスタンドアロン クライアントを作成します。  
+  
+-   エンドポイント アドレスを定義しないクライアントを作成します。代わりに、引数として構成名を受け取るクライアント コンストラクターを使用する。次に例を示します。  
+  
+     [!code-csharp[C_SecurityScenarios#0](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#0)]
+     [!code-vb[C_SecurityScenarios#0](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#0)]  
+  
+### コード  
+ クライアントを作成する場合のコード例を次に示します。バインディングは、クライアントの資格情報の種類が Windows に設定された、TCP トランスポートによるトランスポート モード セキュリティを使用するように構成されます。  
+  
+ [!code-csharp[C_SecurityScenarios#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_securityscenarios/cs/source.cs#4)]
+ [!code-vb[C_SecurityScenarios#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securityscenarios/vb/source.vb#4)]  
+  
+### 構成  
+ コードの代わりに次の構成を使用して、クライアントを作成できます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+  <system.serviceModel>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="NetTcpBinding_ICalculator" >  
+          <security mode="Transport">  
+            <transport clientCredentialType="Windows" />  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+    <client>  
+      <endpoint address="net.tcp://localhost:8008/Calculator"   
+                binding="netTcpBinding"            
+                bindingConfiguration="NetTcpBinding_ICalculator"   
+                contract="ICalculator"  
+                name="NetTcpBinding_ICalculator">  
+      </endpoint>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [方法 : Windows 資格情報でサービスをセキュリティで保護する](../../../../docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transport-security.md b/docs/framework/wcf/feature-details/transport-security.md
new file mode 100644
index 00000000000..05b044bdd97
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transport-security.md
@@ -0,0 +1,49 @@
+---
+title: "トランスポート セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 86c94153-e48d-4539-b6cf-cd8060582e7f
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# トランスポート セキュリティ
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランスポート セキュリティは、選択したバインディングに依存します。バインディングが実装するトランスポートによって実際のセキュリティ機構が決まります。このセクションの各トピックでは、実装される機構とそのオプションについて説明します。  
+  
+## このセクションの内容  
+ [トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランスポート セキュリティの基本について説明します。  
+  
+ [HTTP トランスポート セキュリティ](../../../../docs/framework/wcf/feature-details/http-transport-security.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が SSL \(Secure Sockets Layer\)、つまり HTTPS を実装するしくみについて説明します。  
+  
+ [HTTP 認証の理解](../../../../docs/framework/wcf/feature-details/understanding-http-authentication.md)  
+ HTTP 認証方式 \(基本、ダイジェスト、NTLM \(NT LAN Manager\) など\) について説明します。  
+  
+ [トランスポート セキュリティでの偽装の使用](../../../../docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md)  
+ トランスポート セキュリティ モードで使用できる 5 つの偽装レベルについて説明します。  
+  
+ [方法 : SSL 証明書を使用してポートを構成する](../../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)  
+ SSL \(トランスポート\) セキュリティを実現するために、X.509 証明書を使用してコンピューターのポートを構成する際の基本事項について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.ServiceModel.Channels>  
+  
+ <xref:System.ServiceModel.Security>  
+  
+## 関連項目  
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)  
+  
+## 参照  
+ [WCF セキュリティのプログラミング](../../../../docs/framework/wcf/feature-details/programming-wcf-security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/transports.md b/docs/framework/wcf/feature-details/transports.md
new file mode 100644
index 00000000000..92e768bbda0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/transports.md
@@ -0,0 +1,65 @@
+---
+title: "Windows Communication Foundation のトランスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トランスポート [WCF]"
+  - "WCF, トランスポート"
+  - "Windows Communication Foundation, トランスポート"
+ms.assetid: 005c894b-af70-48aa-a1c1-c99338083c27
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# Windows Communication Foundation のトランスポート
+トランスポート層は、チャネル スタックの最も低いレベルにあります。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で使用される主なトランスポートは、HTTP、HTTPS、TCP、および名前付きパイプです。このセクションのトピックでは、このようなトランスポートの選択、トランスポートの構成、およびチューニング プロパティの設定について説明します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には追加のトランスポートが含まれています。メッセージ キュー \(MSMQ とも呼ばれます\) については、「[キューと信頼できるセッション](../../../../docs/framework/wcf/feature-details/queues-and-reliable-sessions.md)」を参照してください。ピアツーピア トランスポートについては、「[ピアツーピア ネットワーク](../../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+## このセクションの内容  
+ [トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)  
+ 3 つの主なトランスポートについて説明し、そのうちの 1 つを選択する際の考慮事項を示します。  
+  
+ [メッセージ エンコーダーを選択する](../../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)  
+ メッセージ エンコーディングのバインド要素を選択する際に考慮する必要のある要因について説明します。  
+  
+ [メッセージ転送ストリーミング](../../../../docs/framework/wcf/feature-details/streaming-message-transfer.md)  
+ ストリーミングが行われるようにトランスポート層を構成する方法について説明します。  
+  
+ [HTTP および HTTPS の構成](../../../../docs/framework/wcf/feature-details/configuring-http-and-https.md)  
+ HTTP および HTTPS トランスポート バインド要素の構成方法について説明します。  
+  
+ [方法: WCF URL 予約を制限付きの予約に置き換える](../../../../docs/framework/wcf/feature-details/how-to-replace-the-wcf-url-reservation-with-a-restricted-reservation.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の URL 制限付き予約の使用方法について説明します。  
+  
+ [トランスポート クォータ](../../../../docs/framework/wcf/feature-details/transport-quotas.md)  
+ トランスポート層で使用できるクォータを設定する際の考慮事項について説明します。  
+  
+ [NAT とファイアウォールの使用](../../../../docs/framework/wcf/feature-details/working-with-nats-and-firewalls.md)  
+ ファイアウォールを介してメッセージを送受信する場合や、ネットワーク アドレス交換 \(NAT\) が存在する場合にトランスポート層を構成する方法について説明します。  
+  
+ [Net.TCP ポート共有](../../../../docs/framework/wcf/feature-details/net-tcp-port-sharing.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の Net.TCP ポート共有コンポーネントの使用方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement>  
+  
+ <xref:System.ServiceModel.Channels.HttpsTransportBindingElement>  
+  
+ <xref:System.ServiceModel.Channels.TcpTransportBindingElement>  
+  
+ <xref:System.ServiceModel.Channels.NamedPipeTransportBindingElement>  
+  
+## 関連項目  
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)  
+  
+ [バインディングの拡張](../../../../docs/framework/wcf/extending/extending-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/troubleshooting-correlation.md b/docs/framework/wcf/feature-details/troubleshooting-correlation.md
new file mode 100644
index 00000000000..e5b92984898
--- /dev/null
+++ b/docs/framework/wcf/feature-details/troubleshooting-correlation.md
@@ -0,0 +1,266 @@
+---
+title: "相関関係のトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98003875-233d-4512-a688-4b2a1b0b5371
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 相関関係のトラブルシューティング
+相関関係は、ワークフロー サービス メッセージを互いに関連付けたり、正しいワークフロー インスタンスに関連付けたりするために使用されますが、正しく構成されていないと、メッセージが受信されず、アプリケーションが正しく機能しなくなります。ここでは、相関関係のトラブルシューティングのいくつかの方法の概要と、相関関係を使用するときに発生する一般的な問題について説明します。  
+  
+## UnknownMessageReceived イベントの処理  
+ <xref:System.ServiceModel.ServiceHostBase.UnknownMessageReceived> イベントは、サービスで不明なメッセージ \(既存のインスタンスに関連付けることができないメッセージなど\) が受信されたときに発生します。自己ホスト型サービスでは、このイベントをホスト アプリケーションで処理できます。  
+  
+```csharp  
+host.UnknownMessageReceived += delegate(object sender, UnknownMessageReceivedEventArgs e)  
+{  
+    Console.WriteLine("Unknown Message Received:");  
+    Console.WriteLine(e.Message);  
+};  
+```  
+  
+ Web ホスト サービスでこのイベントを処理するには、まず、<xref:System.ServiceModel.Activities.Activation.WorkflowServiceHostFactory> の派生クラスを作成し、<xref:System.ServiceModel.Activities.Activation.WorkflowServiceHostFactory.CreateWorkflowServiceHost%2A> をオーバーライドします。  
+  
+```csharp  
+class CustomFactory : WorkflowServiceHostFactory  
+{  
+    protected override WorkflowServiceHost CreateWorkflowServiceHost(Activity activity, Uri[] baseAddresses)  
+    {  
+        // Create the WorkflowServiceHost.  
+        WorkflowServiceHost host = new WorkflowServiceHost(activity, baseAddresses);  
+  
+        // Handle the UnknownMessageReceived event.  
+        host.UnknownMessageReceived += delegate(object sender, UnknownMessageReceivedEventArgs e)  
+        {  
+            Console.WriteLine("Unknown Message Received:");  
+            Console.WriteLine(e.Message);  
+        };  
+  
+        return host;  
+    }  
+}  
+```  
+  
+ 次に、そのカスタムの <xref:System.ServiceModel.Activities.Activation.WorkflowServiceHostFactory> をサービスの `svc` ファイルで指定します。  
+  
+```  
+<% @ServiceHost Language="C#" Service="OrderServiceWorkflow" Factory="CustomFactory" %>  
+```  
+  
+ このハンドラーが呼び出されると、<xref:System.ServiceModel.UnknownMessageReceivedEventArgs> の <xref:System.ServiceModel.UnknownMessageReceivedEventArgs.Message%2A> プロパティを使用して次のようなメッセージを取得できます。  
+  
+```Output  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+  <s:Header>  
+    <To s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://localhost:8080/OrderService</To>  
+    <Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tempuri.org/IService/AddItem</Action>  
+  </s:Header>  
+  <s:Body>  
+    <AddItem xmlns="http://tempuri.org/">  
+      <Item>Books</Item>  
+    </AddItem>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+ <xref:System.ServiceModel.ServiceHostBase.UnknownMessageReceived> ハンドラーにディスパッチされたメッセージを調べることで、メッセージがワークフロー サービスのインスタンスに関連付けられなかった理由の手がかりを得られる可能性があります。  
+  
+## 追跡によるワークフローの進行状況の監視  
+ 追跡を使用すると、ワークフローの進行状況を監視できます。既定では、ワークフローのライフサイクル イベント、アクティビティのライフサイクル イベント、エラー伝達、およびブックマーク再開に対して追跡レコードが出力されます。そのほかに、カスタム アクティビティでカスタム追跡レコードを出力することもできます。相関関係のトラブルシューティングでは、アクティビティ追跡レコード、ブックマーク再開レコード、およびエラー伝達レコードが最も役立ちます。アクティビティ追跡レコードを使用すると、ワークフローの現在の進行状況を確認したり、現在メッセージを待機しているメッセージング アクティビティを特定したりすることができます。ブックマーク再開レコードを使用すると、ワークフローでメッセージが受信されたかどうかを確認できます。エラー伝達レコードは、ワークフローで発生したエラーの記録を提供します。追跡を有効にするには、<xref:System.ServiceModel.Activities.WorkflowServiceHost> の <xref:System.ServiceModel.Activities.WorkflowServiceHost.WorkflowExtensions%2A> で目的の <xref:System.Activities.Tracking.TrackingParticipant> を指定します。次の例では、既定の追跡プロファイルを使用して `ConsoleTrackingParticipant` \(「[カスタム追跡](../../../../docs/framework/windows-workflow-foundation/samples/custom-tracking.md)」を参照\) を構成しています。  
+  
+```csharp  
+host.WorkflowExtensions.Add(new ConsoleTrackingParticipant());  
+```  
+  
+ ConsoleTrackingParticipant などの追跡参加要素は、コンソール ウィンドウを持つ自己ホスト型ワークフロー サービスで使用できます。Web ホスト サービスでは、追跡情報を永続ストアに記録する追跡参加要素 \(組み込みの <xref:System.Activities.Tracking.EtwTrackingParticipant> など\) か、情報をファイルに記録するカスタムの追跡参加要素 \(「[テキスト ファイルを使用した追跡](../../../../docs/framework/windows-workflow-foundation/samples/tracking-using-a-text-file.md)」の `TextWriterTrackingParticpant` など\) を使用する必要があります。  
+  
+ Web ホスト ワークフロー サービスの追跡および追跡の構成[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー追跡とトレース](../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」、「[ワークフローの追跡の構成](../../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」、および「[追跡 &#91;WF サンプル&#93;](../../../../docs/framework/windows-workflow-foundation/samples/tracking.md)」のサンプルを参照してください。  
+  
+## WCF トレースの使用  
+ WCF トレースは、ワークフロー サービスのメッセージ フローのトレースを提供します。このトレース情報は、相関関係 \(特にコンテンツ ベースの相関関係\) のトラブルシューティングに役立ちます。トレースを有効にするには、`web.config` ファイル \(Web ホスト ワークフロー サービスの場合\) または `app.config` ファイル \(自己ホスト型ワークフロー サービスの場合\) の `system.diagnostics` セクションで目的のトレース リスナーを指定します。トレース ファイルにメッセージの内容を含めるには、`system.serviceModel` の `diagnostics` セクションの `messageLogging` 要素で `logEntireMessage` に対して `true` を指定します。次の例では、メッセージの内容を含むトレース情報を `service.svclog` という名前のファイルに書き込むように構成しています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="System.ServiceModel" switchValue="Information" propagateActivity="true">  
+        <listeners>  
+          <add name="corr"/>  
+        </listeners>  
+      </source>  
+      <source name="System.ServiceModel.MessageLogging">  
+        <listeners>  
+          <add name="corr"/>  
+        </listeners>  
+      </source>  
+    </sources>  
+  
+    <sharedListeners>  
+      <add name="corr" type="System.Diagnostics.XmlWriterTraceListener" initializeData="c:\logs\service.svclog">  
+      </add>  
+    </sharedListeners>  
+  </system.diagnostics>  
+  
+  <system.serviceModel>  
+    <diagnostics>  
+      <messageLogging logEntireMessage="true" logMalformedMessages="false"  
+         logMessagesAtServiceLevel="false" logMessagesAtTransportLevel="true" maxSizeOfMessageToLog="2147483647">  
+      </messageLogging>  
+    </diagnostics>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ `service.svclog` に含まれているトレース情報を表示するには、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) を使用します。この方法を使用すると、渡されたメッセージの内容そのものを調べてコンテンツ ベースの相関関係の <xref:System.ServiceModel.CorrelationQuery> に一致するかどうかを確認できるため、コンテンツ ベースの相関関係のトラブルシューティングで特に便利です。WCF トレース[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)」、「[トレースの構成](../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」、および「[トレースを使用したアプリケーションのトラブルシューティング](../../../../docs/framework/wcf/diagnostics/tracing/using-tracing-to-troubleshoot-your-application.md)」を参照してください。  
+  
+## コンテキスト交換の相関関係の一般的な問題  
+ 相関関係の中には、特定の種類のバインドが使用されていないと正しく機能しないものがあります。たとえば、要求\/応答の相関関係には <xref:System.ServiceModel.BasicHttpBinding> などの双方向のバインドが、コンテキスト交換の相関関係には <xref:System.ServiceModel.BasicHttpContextBinding> などのコンテキスト ベースのバインドが必要です。双方向の操作はほとんどのバインドでサポートされているため、要求\/応答の相関関係ではあまり問題になりませんが、コンテキスト ベースのバインドはわずかしかなく \(<xref:System.ServiceModel.BasicHttpContextBinding>、<xref:System.ServiceModel.WSHttpContextBinding>、<xref:System.ServiceModel.NetTcpContextBinding> など\)、それらのいずれかが使用されていないと、ワークフロー サービスへの最初の呼び出しは成功しますが、その後の呼び出しが次の <xref:System.ServiceModel.FaultException> で失敗します。  
+  
+```Output  
+サービスの受信メッセージにコンテキストが関連付けられておらず、  
+現在の操作が "CanCreateInstance = true" でマークされていません。  
+このサービスと通信するには、受信したバインドでコンテキスト プロトコルが  
+サポートされているかどうか、有効なコンテキストが初期化されているかどうかを確認してください。  
+```  
+  
+ コンテキスト相関関係に使用されるコンテキスト情報は、双方向の操作が使用されている場合は <xref:System.ServiceModel.Activities.SendReply> から \(コンテキスト相関関係を初期化する\) <xref:System.ServiceModel.Activities.Receive> アクティビティに返され、操作が一方向の場合は呼び出し元によって指定されます。コンテキストが呼び出し元によって送信されず、ワークフロー サービスからも返されない場合は、後続の操作が呼び出されたときに上述の <xref:System.ServiceModel.FaultException> が返されます。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [コンテキスト交換](../../../../docs/framework/wcf/feature-details/context-exchange-correlation.md).  
+  
+## 要求\/応答の相関関係の一般的な問題  
+ 要求\/応答の相関関係は、<xref:System.ServiceModel.Activities.ReceiveReply> と <xref:System.ServiceModel.Activities.Send> のペアと使用すると、ワークフロー サービスに双方向の操作を実装でき、<xref:System.ServiceModel.Activities.SendReply> と <xref:System.ServiceModel.Activities.Receive> のペアと使用すると、別の Web サービスの双方向の操作を呼び出すことができます。WCF サービスの双方向の操作を呼び出す場合、このサービスには、従来の命令型のコード ベースの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを使用することも、ワークフロー サービスを使用することもできます。要求\/応答の相関関係を使用するには、<xref:System.ServiceModel.BasicHttpBinding> などの双方向のバインドを使用する必要があります。操作が双方向である必要もあります。  
+  
+ ワークフロー サービスで、並行または重複する <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアまたは <xref:System.ServiceModel.Activities.Send>\/<xref:System.ServiceModel.Activities.ReceiveReply> のペアに双方向の操作があると、<xref:System.ServiceModel.Activities.WorkflowServiceHost> によって提供される暗黙の関連付けハンドル管理が \(特に高負荷のシナリオで\) 不十分となり、メッセージが正しくルーティングされなくなる可能性があります。この問題が発生しないようにするために、要求\/応答の相関関係を使用する際には常に <xref:System.ServiceModel.Activities.CorrelationHandle> を明示的に指定することをお勧めします。ワークフロー デザイナーの **\[ツールボックス\]** の \[メッセージング\] セクションにある **SendAndReceiveReply** テンプレートと **ReceiveAndSendReply** テンプレートを使用すると、<xref:System.ServiceModel.Activities.CorrelationHandle> が既定で明示的に構成されます。コードを使用してワークフローを作成する場合は、ペアの最初のアクティビティの <xref:System.ServiceModel.Activities.Receive.CorrelationInitializers%2A> で <xref:System.ServiceModel.Activities.CorrelationHandle> を指定します。次の例では、<xref:System.ServiceModel.Activities.RequestReplyCorrelationInitializer> で <xref:System.ServiceModel.Activities.CorrelationInitializer.CorrelationHandle%2A> を明示的に指定して <xref:System.ServiceModel.Activities.Receive> アクティビティを構成しています。  
+  
+```csharp  
+Variable<CorrelationHandle> RRHandle = new Variable<CorrelationHandle>();  
+  
+Receive StartOrder = new Receive  
+{  
+    CanCreateInstance = true,  
+    ServiceContractName = OrderContractName,  
+    OperationName = "StartOrder",  
+    CorrelationInitializers =  
+    {  
+        new RequestReplyCorrelationInitializer  
+        {  
+            CorrelationHandle = RRHandle  
+        }  
+    }  
+};  
+  
+SendReply ReplyToStartOrder = new SendReply  
+{  
+    Request = StartOrder,  
+    Content = ... // Contains the return value, if any.  
+};  
+  
+// Construct a workflow using StartOrder and ReplyToStartOrder.  
+```  
+  
+ <xref:System.ServiceModel.Activities.Receive>\/<xref:System.ServiceModel.Activities.SendReply> のペアや <xref:System.ServiceModel.Activities.Send>\/<xref:System.ServiceModel.Activities.ReceiveReply> のペアの間で永続化を使用することはできません。両方のアクティビティが完了するまで存続する非永続化ゾーンが作成されます。遅延アクティビティなどのアクティビティがこの非永続化ゾーンにあって、ワークフローのアイドル状態を引き起こした場合、ホストでワークフローがアイドル状態になったときにワークフローを永続化するようにホストが構成されていても、ワークフローは永続化されません。Persist アクティビティなどのアクティビティが非永続化ゾーンで明示的に永続化を試みた場合、致命的な例外がスローされ、ワークフローが中止されて、<xref:System.ServiceModel.FaultException> が呼び出し元に返されます。次の致命的な例外メッセージが表示されます。"System.InvalidOperationException: 持続性のないブロックに Persist アクティビティを含めることはできません。"この例外は呼び出し元に返されませんが、追跡が有効になっている場合は確認できます。呼び出し元に返される <xref:System.ServiceModel.FaultException> のメッセージは、"WorkflowInstance '5836145b\-7da2\-49d0\-a052\-a49162adeab6' が完了しているため、操作を実行できませんでした" です。  
+  
+ 要求\/応答の相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[要求\/応答](../../../../docs/framework/wcf/feature-details/request-reply-correlation.md)」を参照してください。  
+  
+## コンテンツ ベースの相関関係の一般的な問題  
+ コンテンツ ベースの相関関係は、ワークフロー サービスが複数のメッセージを受信し、交換されるメッセージ内の一部のデータによって目的のインスタンスが識別される場合に使用されます。コンテンツ ベースの相関関係では、顧客番号や注文 ID などのメッセージ内のデータを使用して、適切なワークフロー インスタンスにメッセージをルーティングします。ここでは、コンテンツ ベースの相関関係を使用するときに発生するいくつかの一般的な問題について説明します。  
+  
+### 識別データが一意であることの確認  
+ インスタンスの識別に使用されるデータは、相関関係キーにハッシュされます。相関関係による関連付けで使用するデータは必ず、一意にする必要があります。一意でない場合は、ハッシュされたキーで競合が発生し、誤った場所にメッセージがルーティングされる可能性があります。たとえば、顧客名だけに基づいた関連付けでは、同じ名前の顧客が複数存在する場合があるため、競合が発生する可能性があります。メッセージの関連付けに使用するデータの一部として、コロン \(:\) を使用することはできません。コロンは、メッセージ クエリのキーと値の区切り文字として既に使用されており、後でハッシュされる文字列に含まれるためです。永続化を使用している場合は、現在の識別データが、以前に永続化されたインスタンスによって使用されていないかどうかを確認する必要があります。この問題は、永続化を一時的に無効にすることによって特定できます。WCF トレースを使用すると、計算された相関関係キーを表示できるため、この種の問題のデバッグに役立ちます。  
+  
+### 競合状態  
+ サービスがメッセージを受信してから実際に相関関係が初期化されるまでにはわずかな時間差があり、その間は後続のメッセージが無視されます。ワークフロー サービスで、クライアントから一方向の操作で渡されるデータを使用してコンテンツ ベースの相関関係が初期化される場合に、呼び出し元が後続のメッセージをすぐに送信すると、この時間差の間それらのメッセージが無視されます。この問題を回避するには、双方向の操作を使用して相関関係を初期化するか、<xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用します。  
+  
+### 関連付けクエリについての問題  
+ 関連付けクエリは、メッセージの関連付けに使用するメッセージ内のデータを指定するために使用されます。このデータは、XPath クエリを使用して指定します。特に問題がないように見えるにもかかわらず、サービスへのメッセージがディスパッチされない場合は、トラブルシューティングの手法として、メッセージ データの値に一致するリテラル値を XPath クエリの代わりに指定することができます。リテラル値を指定するには `string` 関数を使用します。次の例では、`OrderId` に対して `11445` というリテラル値を使用するように <xref:System.ServiceModel.MessageQuerySet> が構成されています。XPath クエリはコメント アウトされています。  
+  
+```csharp  
+MessageQuerySet = new MessageQuerySet  
+{  
+    {  
+        "OrderId",   
+        //new XPathMessageQuery("sm:body()/tempuri:StartOrderResponse/tempuri:OrderId")  
+        new XPathMessageQuery("string('11445')")  
+    }  
+}  
+```  
+  
+ 関連付けデータが取得されないなど、XPath クエリが正しく構成されていない場合、次のメッセージと共にエラーが返されます。"関連付けクエリで空の結果セットが生成されました。エンドポイントの関連付けクエリが正しく構成されていることを確認してください。"前のセクションで説明したとおり、XPath クエリをリテラル値と置換すると、すばやくトラブルシューティングすることができます。この問題は、**\[関連付け初期化子の追加\]** ダイアログ ボックスまたは **\[CorrelatesOn の定義\]** ダイアログ ボックスで XPath クエリ ビルダーを使用し、ワークフロー サービスでメッセージ コントラクトが使用された場合に発生する可能性があります。次の例では、メッセージ コントラクト クラスを定義します。  
+  
+```csharp  
+[MessageContract]  
+public class AddItemMessage  
+{  
+    [MessageHeader]  
+    public string CartId;  
+  
+    [MessageBodyMember]  
+    public string Item;  
+}  
+  
+```  
+  
+ このメッセージ コントラクトはワークフローの <xref:System.ServiceModel.Activities.Receive> アクティビティで使用されます。メッセージのヘッダーにある `CartId` は、メッセージを正しいインスタンスに関連付けるために使用されます。`CartId` を取得する XPath クエリがワークフロー デザイナーの関連付けダイアログを使用して作成される場合、次の正しくないクエリが生成されます。  
+  
+```  
+sm:body()/xg0:AddItemMessage/xg0:CartId  
+  
+```  
+  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティがデータのパラメーターを使用した場合、この XPath クエリは正しいですが、メッセージ コントラクトを使用しているため、誤りとなります。次の XPath クエリがヘッダーから `CartId` を取得するために正しい XPath クエリです。  
+  
+```  
+sm:header()/tempuri:CartId  
+  
+```  
+  
+ これはメッセージの本文を調べて確認することができます。  
+  
+```xml  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+  <s:Header>  
+    <Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tempuri.org/IService/AddItem</Action>  
+    <h:CartId xmlns:h="http://tempuri.org/">80c95b41-c98d-4660-a6c1-99412206e54c</h:CartId>  
+  </s:Header>  
+  <s:Body>  
+    <AddItemMessage xmlns="http://tempuri.org/">  
+      <Item>Books</Item>  
+    </AddItemMessage>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+ 次の例では、データを受信するために前のメッセージ コントラクトを使用する `AddItem` 操作のために構成された <xref:System.ServiceModel.Activities.Receive> アクティビティを示します。XPath クエリは正しく構成されています。  
+  
+```xaml  
+<Receive CorrelatesWith="[CCHandle] OperationName="AddItem" ServiceContractName="p:IService">  
+  <Receive.CorrelatesOn>  
+    <XPathMessageQuery x:Key="key1">  
+      <XPathMessageQuery.Namespaces>  
+        <ssx:XPathMessageContextMarkup>  
+          <x:String x:Key="xg0">http://schemas.datacontract.org/2004/07/MessageContractWFService</x:String>  
+        </ssx:XPathMessageContextMarkup>  
+      </XPathMessageQuery.Namespaces>sm:header()/tempuri:CartId</XPathMessageQuery>  
+  </Receive.CorrelatesOn>  
+  <ReceiveMessageContent DeclaredMessageType="m:AddItemMessage">  
+    <p1:OutArgument x:TypeArguments="m:AddItemMessage">[AddItemMessage]</p1:OutArgument>  
+  </ReceiveMessageContent>  
+</Receive>  
+  
+```  
+  
+ コンテンツ ベースの相関関係[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[コンテンツ ベース](../../../../docs/framework/wcf/feature-details/content-based-correlation.md)」および「[相関電卓](../../../../docs/framework/windows-workflow-foundation/samples/correlated-calculator.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/troubleshooting-queued-messaging.md b/docs/framework/wcf/feature-details/troubleshooting-queued-messaging.md
new file mode 100644
index 00000000000..cdb9155b8c0
--- /dev/null
+++ b/docs/framework/wcf/feature-details/troubleshooting-queued-messaging.md
@@ -0,0 +1,215 @@
+---
+title: "キューに置かれたメッセージングのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5f2836f-018d-42f5-a571-1e97e64ea5b0
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# キューに置かれたメッセージングのトラブルシューティング
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのキューの使用に関する一般的な質問とトラブルシューティング ヘルプについて説明します。  
+  
+## 一般的な質問  
+ **Q:** [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Beta 1 を使用しているときに MSMQ 修正プログラムをインストールしました。この修正プログラムを削除する必要がありますか。  
+  
+ **A:** 必要があります。この修正プログラムのサポートは終了しています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、現在、MSMQ で正常に動作し、修正プログラムは不要です。  
+  
+ **Q:** MSMQ 用のバインディングには、<xref:System.ServiceModel.NetMsmqBinding> と <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> の 2 つがあります。それぞれの用途を教えてください。  
+  
+ **A:** <xref:System.ServiceModel.NetMsmqBinding> を使用するのは、2 つの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション間でのキューを使用した通信にトランスポートとして MSMQ を使用する場合です。また、<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を使用するのは、既存の MSMQ アプリケーションを使用して、新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションと通信する場合です。  
+  
+ **Q:** <xref:System.ServiceModel.NetMsmqBinding> バインディングと `MsmqIntegration` バインディングを使用するには、MSMQ をアップグレードする必要がありますか。  
+  
+ **A:** 必要ありません。これらは共に [!INCLUDE[wxp](../../../../includes/wxp-md.md)] および [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] 上の MSMQ 3.0 で使用できます。[!INCLUDE[wv](../../../../includes/wv-md.md)] で MSMQ 4.0 にアップグレードすると、バインディングの特定の機能が使用可能になります。  
+  
+ **Q:** <xref:System.ServiceModel.NetMsmqBinding> バインディングと <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> バインディングの機能のうち、MSMQ 4.0 では使用できるが MSMQ 3.0 では使用できないのはどれですか。  
+  
+ **A:** MSMQ 4.0 では使用できても MSMQ 3.0 では使用できない機能は次のとおりです。  
+  
+-   カスタム配信不能キューは、MSMQ 4.0 でのみサポートされます。  
+  
+-   MSMQ 3.0 と 4.0 では、有害メッセージの処理方法が異なります。  
+  
+-   MSMQ 4.0 のみが、リモート トランザクション読み取りをサポートします。  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [Windows Vista、Windows Server 2003、および Windows XP におけるキュー機能の相違点](../../../../docs/framework/wcf/feature-details/diff-in-queue-in-vista-server-2003-windows-xp.md).  
+  
+ **Q:** キューを使用する通信の一方の側で MSMQ 3.0 を使用し、もう一方の側で MSMQ 4.0 を使用できますか。  
+  
+ **A:** 使用できます。  
+  
+ **Q:** 既存の MSMQ アプリケーションを新しい [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントまたはサーバーと統合しようと考えています。使用している MSMQ インフラストラクチャの両方の側をアップグレードする必要がありますか。  
+  
+ **A:** 必要ありません。どちら側も MSMQ 4.0 にアップグレードする必要はありません。  
+  
+## トラブルシューティング  
+ ここでは、一般的なトラブルシューティングの問題に対する解答を示します。既知の制限である一部の問題は、リリース ノートにも記載されています。  
+  
+ **Q:** プライベート キューを使用しようとすると、次の例外が表示されます。`System.InvalidOperationException` : この URL は無効です。キューの URL に '$' 文字を使用することはできません。net.msmq:\/\/machine\/private\/queueName の構文を使用して、プライベート キューをアドレス指定してください。  
+  
+ **A:** 構成とコードでキュー URI \(Uniform Resource Identifier\) を確認してください。URI では、"$" 文字を使用できません。たとえば、OrdersQueue という名前のプライベート キューのアドレスを指定する場合は、URI を net.msmq:\/\/localhost\/private\/ordersQueue と指定してください。  
+  
+ **Q:** キューに置かれたアプリケーションで `ServiceHost.Open()` を呼び出すと次の例外がスローされます。`System.ArgumentException` : ベース アドレスに URI クエリ文字列を含めることはできません。その理由を教えてください。  
+  
+ **A:** 構成とコードでキュー URI を確認してください。MSMQ のキューでは '?' 文字の使用がサポートされていますが、URI はこれを文字列クエリの開始と解釈します。この問題を回避するには、'?' 文字を含まないキュー名を使用してください。  
+  
+ **Q:** 送信は成功したのですが、受信側でサービス操作が呼び出されません。その理由を教えてください。  
+  
+ **A:** 理由を特定するには、次のチェック リストを検討してください。  
+  
+-   トランザクション キューの要件と指定済みの保証が適合することを確認します。次の原則に注意してください。  
+  
+    -   "1 回限りの" 配信の保証 \(<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> \= `true`\) 付きの永続的なメッセージ \(データグラムとセッション\) は、トランザクション キューにのみ送信できます。  
+  
+    -   "1 回限りの" 配信の保証付きのセッションのみを送信できます。  
+  
+    -   セッションでトランザクション キューからメッセージを受け取るには、1 つのトランザクションが必要です。  
+  
+    -   保証なし \(<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> \= `false`\) の一時的なメッセージまたは永続的なメッセージ \(ダイアグラムのみ\) は、非トランザクション キューにのみ送受信できます。  
+  
+-   配信不能キューを確認します。このキューにメッセージが置かれている場合は、メッセージが配信されなかった理由を特定してください。  
+  
+-   送信キューを確認して、接続性またはアドレス指定の問題を特定します。  
+  
+ **Q:** カスタム配信不能キューを指定したのですが、送信元アプリケーションを起動すると、カスタム配信不能キューが見つからない、または送信元アプリケーションにカスタム配信不能キューへのアクセス許可がないという例外が表示されます。なぜ、こうなるのでしょうか。  
+  
+ **A:** カスタム配信不能キューの URI には、先頭のセグメントに "localhost" またはコンピューター名を含める必要があります。たとえば、net.msmq:\/\/localhost\/private\/myAppdead\-letter queue のようにします。  
+  
+ **Q:** カスタム配信不能キューを常に定義する必要がありますか。それとも既定の配信不能キューがあるのですか。  
+  
+ **A:** 保証が "1 回限り" \(<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> \= `true`\) の場合、およびカスタム配信不能キューを指定していない場合は、システム全体のトランザクション配信不能キューが既定になります。  
+  
+ 保証なし \(<xref:System.ServiceModel.MsmqBindingBase.ExactlyOnce%2A> \= `false`\) の場合、既定は配信不能キュー機能なしです。  
+  
+ **Q:** サービスが、SvcHost.Open で "EndpointListener が ListenerFactory の要件を満たすことができません" という内容のメッセージをスローします。その理由を教えてください。  
+  
+ A.サービス コントラクトを確認してください。"IsOneWay\=`true`" をすべてのサービス操作に配置するのを忘れた可能性があります。キューは、一方向のサービス操作しかサポートしません。  
+  
+ **Q:** キューにメッセージが置かれているのにサービス操作が呼び出されません。何が問題なのでしょうか。  
+  
+ **A:** サービス ホストがエラーになっているかどうかを確認してください。確認するには、トレースを調べるか、`IErrorHandler` を実装します。既定では、有害メッセージが検出された場合、サービス ホストはエラーになります。  
+  
+ **Q:** キューにメッセージが格納されているのに、Web ホスト型のキューを使用するサービスがアクティブになりません。その理由を教えてください。  
+  
+ **A:** 最も一般的な理由はアクセス許可です。  
+  
+1.  `NetMsmqActivator` プロセスが実行され、そのキューで、`NetMsmqActivator` の ID に読み取りおよびシーク アクセス許可が割り当てられていることを確認してください。  
+  
+2.  `NetMsmqActivator` がリモート コンピューター上のキューを監視している場合は、`NetMsmqActivator` が制限付きトークンの下で実行されていないことを確認してください。無制限のトークンを使用して `NetMsmqActivator` を実行するには、以下を実行します。  
+  
+    ```  
+    sc sidtype NetMsmqActivator unrestricted  
+    ```  
+  
+ セキュリティ関連以外の Web ホストの問題については、「[キューに置かれたアプリケーションの Web ホスト](../../../../docs/framework/wcf/feature-details/web-hosting-a-queued-application.md)」を参照してください。  
+  
+ **Q:** 最も簡単にセッションにアクセスする方法を教えてください。  
+  
+ **A:** セッションの最後のメッセージに対応する操作で AutoComplete\=`true` を設定し、残りのすべてのサービス操作で AutoComplete\=`false` を設定します。  
+  
+ **Q:** MSMQ に関する一般的な質問の解答はどこで見つけられますか。  
+  
+ **A:** MSMQ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Microsoft Message Queuing](http://go.microsoft.com/fwlink/?LinkId=87810)」を参照してください。  
+  
+ **Q:** キューを使用するセッション メッセージとキューを使用するデータグラム メッセージの両方を格納するキューから読み取るときに、サービスが `ProtocolException` をスローするのはなぜですか。  
+  
+ **A:** キューを使用するセッション メッセージとキューを使用するデータグラム メッセージは、それぞれ構成する方法が基本的に異なります。このため、キューを使用するセッション メッセージを読み取ろうとするサービスは、キューを使用するデータグラム メッセージを受信できず、キューを使用するデータグラム メッセージを読み取ろうとするサービスは、セッション メッセージを受信できません。これら両方の種類のメッセージを同じキューから読み取ろうとすると、次の例外がスローされます。  
+  
+```  
+System.ServiceModel.MsmqPoisonMessageException: The transport channel detected a poison message. This occurred because the message exceeded the maximum number of delivery attempts or because the channel detected a fundamental problem with the message. The inner exception may contain additional information.   
+---> System.ServiceModel.ProtocolException: An incoming MSMQ message contained invalid or unexpected .NET Message Framing information in its body. The message cannot be received. Ensure that the sender is using a compatible service contract with a matching SessionMode.  
+```  
+  
+ アプリケーションが同じコンピューターからキューを使用するセッション メッセージとキューを使用するデータグラム メッセージの両方を送信する場合は、任意のカスタム配信不能キューだけでなくシステム配信不能キューで特にこの問題が発生する可能性があります。メッセージを正常に送信できない場合、メッセージは配信不能キューに移されます。このような場合は、セッション メッセージとデータグラム メッセージの両方が配信不能キューに置かれる可能性があります。実行時にキューから読み取るときに両方の種類のメッセージを分離することはできません。そのため、アプリケーションでは、キューを使用するセッション メッセージとキューを使用するデータグラム メッセージの両方を同じコンピューターから送信しないでください。  
+  
+### MSMQ 統合 : 固有のトラブルシューティング  
+ **Q:** メッセージを送信したり、サービス ホストを開いたりすると、スキームが不正であるというエラー メッセージが表示されます。その理由を教えてください。  
+  
+ **A:** MSMQ 統合バインディングを使用するときは、msmq.formatname スキームを使用する必要があります。たとえば、msmq.formatname:DIRECT\=OS:.\\private$\\OrdersQueue などです。ただし、カスタム配信不能キューを指定するときは、net.msmq スキームを使用する必要があります。  
+  
+ **Q:** 公開または専用の形式名を使用して、[!INCLUDE[wv](../../../../includes/wv-md.md)] 上のサービス ホストを開くと、エラーが発生します。その理由を教えてください。  
+  
+ **A:** [!INCLUDE[wv](../../../../includes/wv-md.md)] 上の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 統合チャネルは、メイン アプリケーション キューの有害メッセージ処理用のサブキューを開くことができるかどうかを確認します。サブキューの名前は、リスナーに渡される msmq.formatname URI から派生します。MSMQ でのサブキュー名は、直接形式名に限定されます。そのためにエラーが発生します。キュー URI を直接形式名に変更してください。  
+  
+ **Q:** MSMQ アプリケーションからメッセージを受信すると、メッセージはキューに置かれ、受信側の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションによって読み取られません。その理由を教えてください。  
+  
+ **A:** メッセージに本文があるかどうか確認してください。メッセージに本文がない場合、MSMQ 統合チャネルはメッセージを無視します。例外を通知する `IErrorHandler` を実装し、トレースを確認してください。  
+  
+### セキュリティ関連のトラブルシューティング  
+ **Q:** ワークグループ モードで既定のバインディングを使用するサンプルを実行すると、メッセージは送信されるように思われるのですが、受信側で受信されません。  
+  
+ **A:** 既定では、メッセージは、Active Directory ディレクトリ サービスを必要とする MSMQ の内部証明書を使用して署名されます。ワークグループ モードでは、Active Directory が使用できないため、メッセージに署名できません。そのため、メッセージは配信不能キューに置かれ、"署名が正しくありません" などのエラーの原因が示されます。  
+  
+ この問題を回避するには、セキュリティを無効にします。セキュリティを無効にするには、ワークグループ モードで動作するように <xref:System.ServiceModel.NetMsmqSecurity.Mode%2A> \= <xref:System.ServiceModel.NetMsmqSecurityMode> を設定します。  
+  
+ また、<xref:System.ServiceModel.NetMsmqSecurity.Transport%2A> プロパティから <xref:System.ServiceModel.MsmqTransportSecurity> を取得し、それを <xref:System.ServiceModel.MsmqAuthenticationMode> に設定して、クライアント証明書を設定する方法もあります。  
+  
+ さらに、MSMQ と Active Directory 統合をインストールして回避することもできます。  
+  
+ **Q:** Active Directory で既定のバインディング \(トランスポート セキュリティが有効\) を使用してメッセージをキューに送信すると、"内部証明書が見つからない" という内容のメッセージが表示されます。これを修復する方法を教えてください。  
+  
+ **A:** これは、送信側の Active Directory 内の証明書を更新する必要があることを意味します。証明書を更新するには、**\[コントロール パネル\]**、**\[管理ツール\]**、**\[コンピューターの管理\]** の順に開き、**\[MSMQ\]** を右クリックして **\[プロパティ\]** を選択します。**\[ユーザー証明書\]** タブをクリックし、**\[更新\]** をクリックします。  
+  
+ **Q:** <xref:System.ServiceModel.MsmqAuthenticationMode> を使用してメッセージを送信するときに、使用する証明書を指定すると、"無効な証明書" というメッセージが表示されます。これを修復する方法を教えてください。  
+  
+ **A:** 証明書モードでは、ローカル コンピューターの証明書ストアを使用できません。証明書スナップインを使用して、コンピューターの証明書ストアから現在のユーザー ストアに証明書をコピーする必要があります。証明書スナップインを開くには、以下を実行します。  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** を選択し、「`mmc`」と入力して、**\[OK\]** をクリックします。  
+  
+2.  **\[Microsoft 管理コンソール\]** の **\[ファイル\]** メニューを開き、**\[スナップインの追加と削除\]** を選択します。  
+  
+3.  **\[スナップインの追加と削除\]** ダイアログ ボックスで、**\[追加\]** をクリックします。  
+  
+4.  **\[スタンドアロン スナップインの追加\]** ダイアログ ボックスで証明書を選択し、**\[追加\]** をクリックします。  
+  
+5.  **\[証明書スナップイン\]** ダイアログ ボックスで、**\[ユーザー アカウント\]** を選択し、**\[完了\]** をクリックします。  
+  
+6.  次に、前の手順に従って 2 番目の証明書スナップインを追加しますが、今回は、**\[コンピューター アカウント\]** を選択して **\[次へ\]** をクリックします。  
+  
+7.  **\[ローカル コンピューター\]** を選択し、**\[完了\]** をクリックします。これで、コンピューターの証明書ストアから現在のユーザー ストアに証明書をドラッグ アンド ドロップできます。  
+  
+ **Q:** ワークグループモードで、サービスが別のコンピューター上のキューから読み取るときに "access denied" 例外が発生します。  
+  
+ **A:** ワークグループ モードでリモート アプリケーションがキューへのアクセスを取得するには、キューへのアクセス許可がアプリケーションに必要です。キューのアクセス制御リスト \(ACL\) に "匿名ログイン" を追加して、読み取りアクセス許可を割り当ててください。  
+  
+ **Q:** ネットワーク サービス クライアント \(またはドメイン アカウントを持たない任意のクライアント\) がキューを使用するメッセージを送信すると、証明書が無効であるというエラー メッセージが表示され、送信できません。これを修復する方法を教えてください。  
+  
+ **A:** バインディング構成を確認してください。既定のバインディングでは、メッセージに署名するために MSMQ トランスポート セキュリティを有効にしています。これを無効にしてください。  
+  
+### リモート トランザクション受信  
+ **Q:** コンピューター A にキューがあるときに、コンピューター B のキューからメッセージを読み取る [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実行すると \(リモート トランザクション受信シナリオ\)、キューからメッセージが読み取られません。トレース情報には、"Transaction cannot be imported." というメッセージが示され、受信に失敗したことがわかります。この問題を解決するには、どうすればいいですか。  
+  
+ **A:** これには、次の理由が考えられます。  
+  
+-   ドメイン モードの場合、リモート トランザクション受信には、Microsoft 分散トランザクション コーディネーター \(MSDTC\) ネットワーク アクセスが必要です。これは、**\[Windows コンポーネントの追加と削除\]** を使用して有効にできます。  
+  
+     ![ネットワーク DTC アクセスの有効化](../../../../docs/framework/wcf/feature-details/media/applicationserveraddcomps.jpg "ApplicationServerAddComps")  
+  
+-   トランザクション マネージャーと通信するための認証モードを確認します。ワークグループ モードの場合は、\[認証を必要としない\] を選択する必要があります。ドメイン モードの場合は、\[相互認証を必要とする\] を選択する必要があります。  
+  
+     ![XA トランザクションの有効化](../../../../docs/framework/wcf/feature-details/media/4f3695e0-fb0b-4c5b-afac-75f8860d2bb0.jpg "4f3695e0\-fb0b\-4c5b\-afac\-75f8860d2bb0")  
+  
+-   MSDTC が **\[インターネット接続ファイアウォール\]** 設定の例外の一覧に含まれていることを確認します。  
+  
+-   [!INCLUDE[wv](../../../../includes/wv-md.md)] を使用していることを確認します。[!INCLUDE[wv](../../../../includes/wv-md.md)] 上の MSMQ は、リモート トランザクション読み取りをサポートします。以前の Windows リリース上の MSMQ は、リモート トランザクション読み取りをサポートしません。  
+  
+ **Q:** キューから読み取るサービスが、Web ホストなどでのネットワーク サービスであるときにキューから読み取ると、アクセス拒否例外が発生するのはなぜですか。  
+  
+ **A:** ネットワーク サービス読み取りアクセスをキュー ACL に追加して、ネットワーク サービスがキューから読み取れるようにしてください。  
+  
+ **Q:** MSMQ アクティベーション サービスを使用して、リモート コンピューター上のキュー内のメッセージに基づいてアプリケーションをアクティブ化することは可能ですか。  
+  
+ **A:** 可能です。これには、ネットワーク サービスとして動作するように MSMQ アクティベーション サービスを構成し、リモート コンピューター上のキューへのネットワーク サービス アクセスを追加する必要があります。  
+  
+## ReceiveContext を有効にしたカスタム MSMQ バインディングの使用  
+ <xref:System.ServiceModel.Channels.ReceiveContext> を有効にしてカスタム MSMQ バインディングを使用すると、ネイティブの MSMQ が非同期の <xref:System.ServiceModel.Channels.ReceiveContext> 受信の I\/O 完了をサポートしないために、着信メッセージの処理にスレッド プール内のスレッドが使用されます。これは、このようなメッセージの処理に <xref:System.ServiceModel.Channels.ReceiveContext> の内部トランザクションが使用され、MSMQ が非同期処理をサポートしないためです。この問題を回避するには、<xref:System.ServiceModel.Description.SynchronousReceiveBehavior> をエンドポイントに追加して同期処理を強制するか、<xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior.MaxPendingReceives%2A> を 1 に設定します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/trusted-subsystem.md b/docs/framework/wcf/feature-details/trusted-subsystem.md
new file mode 100644
index 00000000000..cb61b674799
--- /dev/null
+++ b/docs/framework/wcf/feature-details/trusted-subsystem.md
@@ -0,0 +1,219 @@
+---
+title: "信頼できるサブシステム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f5ce46b-e259-4bc9-a0b9-89d06fc9341c
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 信頼できるサブシステム
+クライアントは、ネットワーク全体に分散している 1 つ以上の Web サービスにアクセスします。Web サービスは、追加のリソース \(データベースや他の Web サービスなど\) に対するアクセスが、Web サービスのビジネス ロジック内にカプセル化されるように設計されています。これらのリソースは、非承認のアクセスに対して保護する必要があります。信頼できるサブシステムの処理を次の図に示します。  
+  
+ ![信頼できるサブシステム](../../../../docs/framework/wcf/feature-details/media/wcfc-trustedsubsystemc.gif "wcfc\_TrustedSubsystemc")  
+  
+ 上図に示した信頼できるサブシステムの処理について、以下の手順で説明します。  
+  
+1.  クライアントが、信頼できるサブシステムに、資格情報と共に要求を送信します。  
+  
+2.  信頼できるサブシステムが、ユーザーの認証と承認を行います。  
+  
+3.  信頼できるサブシステムは、リモート リソースに要求メッセージを送信します。この要求には、信頼できるサブシステムの資格情報 \(または信頼できるサブシステムの処理を実行しているサービス アカウント\) が付属しています。  
+  
+4.  バックエンド リソースが、信頼できるサブシステムの認証と承認を行います。次にバックエンド リソースは要求を処理し、信頼できるサブシステムへの応答を発行します。  
+  
+5.  信頼できるサブシステムはこの応答を処理し、自身の応答をクライアントに発行します。  
+  
+|特性|説明|  
+|--------|--------|  
+|セキュリティ モード|メッセージ|  
+|相互運用性|[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のみ|  
+|認証 \(サービス\)|セキュリティ トークン サービスはクライアントの認証と承認を行います。|  
+|認証 \(クライアント\)|信頼できるサブシステムがクライアントを認証し、リソースが信頼できるサブシステム サービスを認証します。|  
+|整合性|○|  
+|機密性|○|  
+|トランスポート|クライアントと信頼できるサブシステム サービス間にある HTTP<br /><br /> 信頼できるサブシステム サービスとリソース \(バックエンド サービス\) の間にある NET.TCP|  
+|バインディング|<xref:System.ServiceModel.WSHttpBinding> および<xref:System.ServiceModel.NetTcpBinding>[\<wsFederationHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)|  
+  
+## リソース \(バックエンド サービス\)  
+  
+### コード  
+ 次のコードでは、TCP トランスポート プロトコル上でトランスポート セキュリティを使用するリソースのサービス エンドポイントを作成する方法を示します。  
+  
+ [!code-csharp[TrustedSubSystemsResource#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/trustedsubsystemsresource/cs/source.cs#1)]
+ [!code-vb[TrustedSubSystemsResource#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/trustedsubsystemsresource/vb/source.vb#1)]  
+  
+### 構成  
+ 次の構成では、構成を使用して同一のエンドポイントをセットアップします。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.BackendService"  
+               behaviorConfiguration="BackendServiceBehavior">  
+        <endpoint address="net.tcp://localhost.com:8001/BackendService"  
+                  binding="customBinding"  
+                  bindingConfiguration="Binding1"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator"/>  
+      </service>  
+    </services>  
+    <bindings>  
+      <customBinding>  
+        <binding name="Binding1">  
+          <security authenticationMode="UserNameOverTransport"/>  
+          <windowsStreamSecurity/>  
+          <tcpTransport/>  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="BackendServiceBehavior">  
+          <serviceCredentials>  
+            <userNameAuthentication userNamePasswordValidationMode="Custom"  
+                                    customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.MyUserNamePasswordValidator, BackendService"/>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 信頼できるサブシステム  
+  
+### コード  
+ 次のコードでは、HTTP プロトコル上のメッセージ セキュリティで認証にユーザー名とパスワードを使用する、信頼できるサブシステムのサービス エンドポイントを作成する方法を示します。  
+  
+ [!code-csharp[TrustedSubSystems#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/trustedsubsystems/cs/source.cs#1)]
+ [!code-vb[TrustedSubSystems#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/trustedsubsystems/vb/source.vb#1)]  
+  
+ 次のコードでは、TCP トランスポート プロトコル上でトランスポート セキュリティを使用してバックエンド サービスと通信を行う、信頼できるサブシステムのサービスを示します。  
+  
+ [!code-csharp[TrustedSubSystems#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/trustedsubsystems/cs/source.cs#2)]
+ [!code-vb[TrustedSubSystems#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/trustedsubsystems/vb/source.vb#2)]  
+  
+### 構成  
+ 次の構成では、構成を使用して同一のエンドポイントをセットアップします。2 つのバインディングがあることに注意してください。1 つは、信頼できるサブシステムでホストされるサービスをセキュリティで保護するバインディングで、もう 1 つは、信頼できるサブシステムとバックエンド サービスの間の通信のためのバインディングです。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.FacadeService"  
+               behaviorConfiguration="FacadeServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/FacadeService"/>  
+          </baseAddresses>  
+        </host>  
+        <endpoint address="http://localhost:8000/FacadeService"  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="Binding1"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator"/>  
+      </service>  
+    </services>  
+    <client>  
+      <endpoint name=""   
+                address="net.tcp://contoso.com:8001/BackendService"  
+                binding="customBinding"  
+                bindingConfiguration="ClientBinding"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator"/>  
+    </client>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+      <customBinding>  
+        <binding name="ClientBinding">  
+          <security authenticationMode="UserNameOverTransport"/>  
+          <windowsStreamSecurity/>  
+          <tcpTransport/>  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="FacadeServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceCredentials>  
+            <serviceCertificate findValue="Contoso.com"  
+                                storeLocation="LocalMachine"  
+                                storeName="My"  
+                                x509FindType="FindBySubjectName" />  
+            <userNameAuthentication userNamePasswordValidationMode="Custom"  
+                                    customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.MyUserNamePasswordValidator, FacadeService"/>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## クライアント  
+  
+### コード  
+ 次のコードでは、HTTP プロトコル上のメッセージ セキュリティで認証にユーザー名とパスワードを使用することで、信頼できるサブシステムと通信を行うクライアントを作成する方法を示します。  
+  
+ [!code-csharp[TrustedSubSystemsClient#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/trustedsubsystemsclient/cs/source.cs#1)]
+ [!code-vb[TrustedSubSystemsClient#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/trustedsubsystemsclient/vb/source.vb#1)]  
+  
+### 構成  
+ 次のコードでは、HTTP プロトコル上のメッセージ セキュリティ、および認証用のユーザー名とパスワードを使用するようにクライアントを構成します。ユーザー名とパスワードの指定はコードを使用する場合に限られます \(構成可能ではありません\)。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+        <endpoint name=""   
+                  address="http://www.cohowinery.com:8000/FacadeService"  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="Binding1"  
+                  behaviorConfiguration="ClientUserNameBehavior"  
+                  contract="Microsoft.ServiceModel.Samples.ICalculator"/>  
+    </client>  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientUserNameBehavior">  
+          <clientCredentials>  
+            <serviceCertificate>  
+              <authentication certificateValidationMode="PeerOrChainTrust"/>  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 参照  
+ [セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md b/docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md
new file mode 100644
index 00000000000..b25b7dc7d15
--- /dev/null
+++ b/docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md
@@ -0,0 +1,82 @@
+---
+title: "データ コントラクト シリアライザーでサポートされる型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "シリアル化 [WCF], サポートされている型"
+ms.assetid: 7381b200-437a-4506-9556-d77bf1bc3f34
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# データ コントラクト シリアライザーでサポートされる型
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、データを XML に変換し、変換された XML をデータへ戻すための既定のシリアル化エンジンとして <xref:System.Runtime.Serialization.DataContractSerializer> を使用します。<xref:System.Runtime.Serialization.DataContractSerializer> は、*データ コントラクト*型をシリアル化するように設計されています。 ただし、暗黙のデータ コントラクトを持つと考えられるその他の型も多数サポートされています。 以下は、シリアル化可能なすべての型です。  
+  
+-   パラメーターを持たないコンストラクターを持つ公開されている型すべて  
+  
+-   データ コントラクト型。<xref:System.Runtime.Serialization.DataContractAttribute> 属性が適用される型です。 ビジネス オブジェクトを表す新しいカスタム型は、通常、データ コントラクト型として作成されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)」および「[シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)」を参照してください。  
+  
+-   コレクション型。 データのリストを表す型です。 型の通常の配列、または <xref:System.Collections.ArrayList> や <xref:System.Collections.Generic.Dictionary%602> などのコレクション型です。<xref:System.Runtime.Serialization.CollectionDataContractAttribute> 属性を使用してこれらの型のシリアル化をカスタマイズすることもできますが、必須ではありません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクトのコレクション型](../../../../docs/framework/wcf/feature-details/collection-types-in-data-contracts.md)。  
+  
+-   列挙型。 フラグ列挙体などの列挙体はシリアル化できます。 列挙型は、必要に応じて、<xref:System.Runtime.Serialization.DataContractAttribute> 属性でマークできます。その場合は、シリアル化に参加するすべてのメンバーを <xref:System.Runtime.Serialization.EnumMemberAttribute> 属性でマークする必要があります。 マークされていないメンバーはシリアル化されません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクトの列挙型](../../../../docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md)。  
+  
+-   .NET Framework プリミティブ型。 .NET Framework に組み込まれている型 \(<xref:System.Byte>、<xref:System.SByte>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.UInt16>、<xref:System.UInt32>、<xref:System.UInt64>、<xref:System.Single>、<xref:System.Double>、<xref:System.Boolean>、<xref:System.Char>、<xref:System.Decimal>、<xref:System.Object>、および <xref:System.String>\) は、すべてシリアル化可能であり、プリミティブ型であると考えられます。  
+  
+-   その他のプリミティブ型。 これらの型は .NET Framework のプリミティブではないが、シリアル化された XML 形式ではプリミティブとして扱われます。 この型には、<xref:System.DateTime>、<xref:System.DateTimeOffset>、<xref:System.TimeSpan>、<xref:System.Guid>、<xref:System.Uri>、<xref:System.Xml.XmlQualifiedName>、および <xref:System.Byte> の配列が含まれます。  
+  
+    > [!NOTE]
+    >  他のプリミティブ型とは異なり、<xref:System.DateTimeOffset> は既定では既知の型ではありません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください\)。  
+  
+-   <xref:System.SerializableAttribute> 属性でマークされた型。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 基本クラス ライブラリに含まれる多くの型は、このカテゴリに分類されます。<xref:System.Runtime.Serialization.DataContractSerializer> は、.NET Framework リモート処理、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>、および <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> で使用されていたこのシリアル化プログラミング モデルを完全にサポートします。これは、<xref:System.Runtime.Serialization.ISerializable> インターフェイスのサポートを含みます。  
+  
+-   未処理の XML を表す型、または [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] のリレーショナル データを表す型。<xref:System.Xml.XmlElement> 型および <xref:System.Xml.XmlNode> 型の配列は、XML を直接表す方法としてサポートされています。 また、<xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装する型 \(関連する <xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性、および <xref:System.Xml.Linq.XDocument> 型と <xref:System.Xml.Linq.XElement> 型を含む\) もサポートされています。[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] の <xref:System.Data.DataTable> 型と <xref:System.Data.DataSet> 型 \(およびその型指定された派生クラス\) はすべて <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装するので、このカテゴリに属します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクトの XML および ADO.NET の種類](../../../../docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md)。  
+  
+## 部分信頼モードにおける特定の型の使用制限  
+ 部分信頼モードのシナリオで型を使用する場合、型によっては次の制限があります。  
+  
+-   部分信頼コードで <xref:System.Runtime.Serialization.ISerializable> を使用して <xref:System.Runtime.Serialization.DataContractSerializer> を実装する型のシリアル化または逆シリアル化を行うには、<xref:System.Security.Permissions.SecurityPermissionAttribute.SerializationFormatter%2A> アクセス許可および <xref:System.Security.Permissions.SecurityPermissionAttribute.UnmanagedCode%2A> アクセス許可が必要です。  
+  
+-   [部分信頼](../../../../docs/framework/wcf/feature-details/partial-trust.md)モードで [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コードを実行する場合、`readonly` フィールド \(`public` と `private` の両方\) のシリアル化と逆シリアル化がサポートされていません。 これは、生成された IL が検証不能であるため、より高いアクセス許可が必要になるためです。  
+  
+-   部分信頼環境では、<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Xml.Serialization.XmlSerializer> の両方がサポートされています。 ただし、<xref:System.Runtime.Serialization.DataContractSerializer> の使用は、次の条件に従う必要があります。  
+  
+    -   シリアル化可能なすべての `[DataContract]` 型はパブリックである必要があります。  
+  
+    -   `[DataMember]` 型にあるシリアル化可能なすべての `[DataContract]` フィールドまたはプロパティは、パブリックで読み書き可能である必要があります。`readonly` フィールドのシリアル化と逆シリアル化は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を部分信頼アプリケーションで実行する場合にはサポートされません。  
+  
+    -   部分信頼環境では、`[Serializable]`\/`ISerializable]` プログラミング モデルはサポートされていません。  
+  
+    -   既知の型はコード内、またはマシン レベルの構成 \(`Machine.config`\) で指定する必要があります。 既知の型はセキュリティ上の理由からアプリケーション レベルの構成では指定できません。  
+  
+-   <xref:System.Runtime.Serialization.IObjectReference> メソッドにはセキュリティ アクセス許可 <xref:System.Runtime.Serialization.IObjectReference.GetRealObject%2A> が必要であるため、`[SecurityPermission(SecurityAction.LinkDemand, Flags=SecurityPermissionFlag.SerializationFormatter)]` を実装した型は、部分信頼環境で例外をスローします。  
+  
+## シリアル化に関するその他のメモ  
+ 次の規則はデータ コントラクト シリアライザーによってサポートされる型にも適用されます。  
+  
+-   ジェネリック型は、データ コントラクト シリアライザーで完全にサポートされます。  
+  
+-   null 許容型は、データ コントラクト シリアライザーで完全にサポートされます。  
+  
+-   インターフェイス型は <xref:System.Object> \(コレクション インターフェイスの場合はコレクション型\) として扱われます。  
+  
+-   構造体とクラスの両方がサポートされています。  
+  
+-   <xref:System.Runtime.Serialization.DataContractSerializer> は、<xref:System.Xml.Serialization.XmlSerializer> と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスで使用されるプログラミング モデルをサポートしていません。 特に、<xref:System.Xml.Serialization.XmlElementAttribute> や <xref:System.Xml.Serialization.XmlAttributeAttribute> のような属性をサポートしていません。 このプログラミング モデルのサポートを有効にするには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ではなく <xref:System.Xml.Serialization.XmlSerializer> を使用するように <xref:System.Runtime.Serialization.DataContractSerializer> を切り替える必要があります。  
+  
+-   <xref:System.DBNull> 型は、特殊な方法で処理されます。 これは、シングルトン型です。デシリアライザーは、逆シリアル化後にシングルトン制約に従い、シングルトン インスタンスへのすべての `DBNull` 参照を指します。`DBNull` はシリアル化可能な型であるため、<xref:System.Security.Permissions.SecurityPermissionAttribute.SerializationFormatter%2A> アクセス許可が必要です。  
+  
+## 参照  
+ [データ コントラクトの XML および ADO.NET の種類](../../../../docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md)   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)   
+ [データ コントラクトのコレクション型](../../../../docs/framework/wcf/feature-details/collection-types-in-data-contracts.md)   
+ [データ コントラクトの列挙型](../../../../docs/framework/wcf/feature-details/enumeration-types-in-data-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/understanding-generated-client-code.md b/docs/framework/wcf/feature-details/understanding-generated-client-code.md
new file mode 100644
index 00000000000..679947f71c2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/understanding-generated-client-code.md
@@ -0,0 +1,88 @@
+---
+title: "生成されたクライアント コードの理解 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c3f6e4b0-1131-4c94-aa39-a197c5c2f2ca
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 生成されたクライアント コードの理解
+[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) は、クライアント アプリケーションの構築時に使用するクライアント コードとクライアント アプリケーション構成ファイルを生成します。 このトピックでは、標準サービス コントラクトのシナリオ向けに生成されたコード例について説明します。 生成されたコードを使用してクライアント アプリケーションを構築する方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)」を参照してください。  
+  
+## 概要  
+ プロジェクトで [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を使用して [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント型を生成する場合、通常、生成されたクライアント コードを調べる必要はありません。 同じサービスを実行する開発環境を使用していない場合は、Svcutil.exe のようなツールを使用してクライアント コードを生成し、そのコードでクライアント アプリケーションを開発します。  
+  
+ Svcutil.exe には、生成された型情報を変更する多くのオプションがあるため、ここですべてのシナリオを説明することはできません。 ここでは、生成されたコードの検索に関する標準的な作業の例を紹介します。  
+  
+-   サービス コントラクト インターフェイスの識別  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスの識別  
+  
+-   データ型の識別  
+  
+-   双方向サービスのコールバック コントラクトの識別  
+  
+-   ヘルパーのサービス コントラクトのチャネル インターフェイスの識別  
+  
+### サービス コントラクト インターフェイスの検索  
+ サービス コントラクトをモデル化するインターフェイスを検索するには、<xref:System.ServiceModel.ServiceContractAttribute?displayProperty=fullName> 属性でマークされたインターフェイスを検索します。 多くの場合、属性自体に設定された他の属性や明示的なプロパティが存在するため、この属性をすばやく読み取って見つけることは簡単ではありません。 サービス コントラクト インターフェイスとクライアント コントラクト インターフェイスは 2 つの別の種類だという点に注意してください。 次のコード例は、元のサービス コントラクトを示しています。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#22](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#22)]  
+  
+ 次のコード例は、Svcutil.exe で生成された同じサービス コントラクトを示しています。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#12](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#12)]  
+  
+ 生成されたサービス コントラクト インターフェイスと <xref:System.ServiceModel.ChannelFactory?displayProperty=fullName> クラスを使用して、サービス操作の呼び出しに使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル オブジェクトを作成できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [方法 : ChannelFactory を使用する](../../../../docs/framework/wcf/feature-details/how-to-use-the-channelfactory.md)。  
+  
+### WCF クライアント クラスの検索  
+ 使用するサービス コントラクトを実装する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスを検索するには、<xref:System.ServiceModel.ClientBase%601?displayProperty=fullName> の拡張を検索します。ここで、型パラメーターは、以前に検索され、自身を拡張するサービス コントラクト インターフェイスです。 次のコード例は、<xref:System.ServiceModel.ClientBase%601> 型の `ISampleService` クラスを示しています。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#14](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#14)]  
+  
+ この [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント クラスを使用するには、新しいインスタンスを作成し、このクラスに実装されているメソッドを呼び出します。 これらのメソッドは、対応しているサービス操作を呼び出し、やり取りを行うように構成されています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)。  
+  
+> [!NOTE]
+>  SvcUtil.exe で WCF クライアント クラスが生成されるとき、<xref:System.Diagnostics.DebuggerStepThroughAttribute> がクライアント クラスに追加されるため、デバッガーで WCF クライアント クラスをステップ実行できなくなります。  
+  
+### データ型の検索  
+ 生成されたコード内でデータ型を検索する最も基本的な方法は、コントラクトに指定された型名を識別し、その型宣言のコードを検索することです。 たとえば、次のコントラクトには、`SampleMethod` が型 `microsoft.wcf.documentation.SampleFault` の SOAP エラーを返せることが指定されています。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#11](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#11)]  
+  
+ `SampleFault` を検索すると、次の型宣言が見つかります。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#30](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#30)]  
+  
+ この場合、このデータ型は、クライアントの特定の例外 \(<xref:System.ServiceModel.FaultException%601>\) によりスローされる詳細な型です。詳細な型のパラメーターは、`microsoft.wcf.documentation.SampleFault` です。 データ型の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。 クライアントでの例外の処理の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[エラーの送受信](../../../../docs/framework/wcf/sending-and-receiving-faults.md)」を参照してください。  
+  
+### 双方向サービスのコールバック コントラクトの検索  
+ コントラクト インターフェイスにより <xref:System.ServiceModel.ServiceContractAttribute.CallbackContract%2A?displayProperty=fullName> プロパティの値が指定されているサービス コントラクトを検索すると、そのコントラクトには双方向コントラクトが指定されていることがわかります。 二重のコントラクトを使用した場合、クライアント アプリケーションは、コールバック コントラクトを実装するコールバック クラスを作成し、そのクラスのインスタンスを、サービスとの通信に使用する <xref:System.ServiceModel.DuplexClientBase%601?displayProperty=fullName> または <xref:System.ServiceModel.DuplexChannelFactory%601?displayProperty=fullName> に渡す必要があります。 双方向クライアントの[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)」を参照してください。  
+  
+ 次のコントラクトは、型 `SampleDuplexHelloCallback` のコールバック コントラクトを指定しています。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/duplexproxycode.cs#2)]
+ [!code-vb[C_GeneratedCodeFiles#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_generatedcodefiles/vb/duplexproxycode.vb#2)]  
+  
+ このコールバック コントラクトを検索すると、クライアント アプリケーションが実装する必要のある次のインターフェイスが見つかります。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/duplexproxycode.cs#4)]
+ [!code-vb[C_GeneratedCodeFiles#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_generatedcodefiles/vb/duplexproxycode.vb#4)]  
+  
+### サービス コントラクト チャネル インターフェイスの検索  
+ サービス コントラクト インターフェイスで <xref:System.ServiceModel.ChannelFactory> クラスを使用する場合、明示的にチャネルを開いたり、閉じたり、中止したりするには、<xref:System.ServiceModel.IClientChannel?displayProperty=fullName> インターフェイスにキャストする必要があります。 処理を容易にするために、Svcutil.exe ツールでは、サービス コントラクト インターフェイスと <xref:System.ServiceModel.IClientChannel> の両方を実装するヘルパー インターフェイスも生成されます。これにより、キャストを行わずにクライアント チャネル インフラストラクチャとのやりとりを実現できます。 上記のサービス コントラクトを実装するヘルパー クライアント チャネルの定義を、次のコード例に示します。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#13](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#13)]  
+  
+## 参照  
+ [WCF クライアントの概要](../../../../docs/framework/wcf/wcf-client-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/understanding-http-authentication.md b/docs/framework/wcf/feature-details/understanding-http-authentication.md
new file mode 100644
index 00000000000..0f89e4f510e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/understanding-http-authentication.md
@@ -0,0 +1,48 @@
+---
+title: "HTTP 認証の理解 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9376309a-39e3-4819-b47b-a73982b57620
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# HTTP 認証の理解
+認証は、リソースにアクセスする権限をクライアントが持つかどうかを確認するプロセスです。HTTP プロトコルは、セキュリティで保護されたリソースへのアクセスをネゴシエートする手段として、認証をサポートしています。  
+  
+ クライアントからの最初の要求は、通常、認証情報を含まない匿名要求です。HTTP サーバー アプリケーションは、認証が必要であることを示して匿名要求を拒否できます。その場合は、サポートされる認証方式を示す WWW 認証ヘッダーを送信します。ここでは、複数の HTTP 認証方式を示し、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での各 HTTP 認証方式のサポートについて説明します。  
+  
+## HTTP 認証方式  
+ サーバーは、クライアントが選択できる複数の認証方式を指定できます。Windows アプリケーションで一般的に使用される認証方式のいくつかを次の表に示します。  
+  
+|認証方式|説明|  
+|----------|--------|  
+|匿名|匿名要求は、認証情報を含みません。これは、リソースへのアクセス権をすべてのユーザーに付与することを意味します。|  
+|基本|基本認証では、クライアントのユーザー名とパスワードを含む Base64 エンコード文字列が送信されます。Base64 は暗号化の形式ではありません。クリア テキストでのユーザー名とパスワードの送信と同じであると考えてください。リソースを保護する必要がある場合は、基本認証以外の認証方式の使用を検討してください。|  
+|ダイジェスト|ダイジェスト認証は、基本認証の代わりに使用できるチャレンジ レスポンス方式の認証です。サーバーは、*nonce* と呼ばれるランダムな文字列データをチャレンジとしてクライアントに送信します。クライアントは、ユーザー名、パスワード、nonce およびその他の追加情報を含むハッシュを使用して応答します。この認証方式では、このようなデータの交換によってもたらされる複雑さとデータのハッシュにより、ユーザーの資格情報を盗んで再使用することがより困難になります。<br /><br /> ダイジェスト認証では、Windows ドメイン アカウントを使用する必要があります。ダイジェストの*レルム*は Windows ドメイン名です。したがって、Windows ドメインをサポートしていないオペレーティング システム \(Windows XP Home Edition など\) で実行されているサーバーでは、ダイジェスト認証を使用できません。逆に、Windows ドメインをサポートしていないオペレーティング システムでクライアントが実行されている場合は、認証時にドメイン アカウントを明示的に指定する必要があります。|  
+|NTLM|NTLM \(NT LAN Manager\) 認証もチャレンジ レスポンス方式の認証ですが、ダイジェスト認証よりもセキュリティが強化されています。NTLM 認証では、エンコードされていないユーザー名とパスワードではなく、Windows 資格情報を使用してチャレンジ データが変換されます。NTLM 認証では、クライアントとサーバー間で複数のメッセージ交換を行う必要があります。認証を正常に完了するため、サーバーおよび介在するすべてのプロキシが永続的な接続をサポートしている必要があります。|  
+|Negotiate|ネゴシエート認証では、可用性に応じて、Kerberos プロトコルと NTLM 認証のいずれかが自動的に選択されます。Kerberos プロトコルを使用できる場合は Kerberos プロトコルが使用され、それ以外の場合は NTLM が使用されます。Kerberos 認証は、NTLM 認証を大幅に強化した認証方式です。Kerberos 認証は NTLM 認証よりも高速であるだけでなく、相互認証およびリモート コンピューターへの資格情報の委任を使用できます。|  
+|Windows Live ID|基になる Windows HTTP サービスには、フェデレーション プロトコルを使用する認証が含まれます。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の標準 HTTP トランスポートは、Microsoft Windows Live ID などのフェデレーション認証方式をサポートしていません。現時点では、この機能をサポートするには、メッセージ セキュリティを使用する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][フェデレーションと発行済みトークン](../../../../docs/framework/wcf/feature-details/federation-and-issued-tokens.md).|  
+  
+## 認証方式の選択  
+ HTTP サーバーに使用できる認証方式を選択する際には、以下の項目について検討します。  
+  
+-   リソースを保護する必要があるかどうかを検討します。HTTP 認証では、より多くのデータを送信する必要があるため、クライアントとの相互運用性が制限される可能性があります。保護する必要のないリソースには、匿名アクセスを許可してください。  
+  
+-   リソースを保護する必要がある場合は、必要なレベルのセキュリティがどの認証方式によって提供されるかを検討します。ここで説明した中で最も弱い標準の認証方式は、基本認証です。基本認証では、ユーザーの資格情報が保護されません。最も強力な標準の認証方式は、ネゴシエート認証で選択される Kerberos プロトコルです。  
+  
+-   受け入れる準備ができていない認証方式、またはリソースを十分にセキュリティで保護できない認証方式をサーバーが \(WWW 認証ヘッダー内で\) 提示しないことを確認してください。クライアントは、サーバーによって提示された認証方式を自由に選択します。クライアントによっては、弱い認証方式、またはサーバーのリストにある最初の認証方式を既定で選択します。  
+  
+## 参照  
+ [トランスポート セキュリティの概要](../../../../docs/framework/wcf/feature-details/transport-security-overview.md)   
+ [トランスポート セキュリティでの偽装の使用](../../../../docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md)   
+ [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/unsupported-scenarios.md b/docs/framework/wcf/feature-details/unsupported-scenarios.md
new file mode 100644
index 00000000000..bb85b73f133
--- /dev/null
+++ b/docs/framework/wcf/feature-details/unsupported-scenarios.md
@@ -0,0 +1,124 @@
+---
+title: "サポートされていないシナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72027d0f-146d-40c5-9d72-e94392c8bb40
+caps.latest.revision: 43
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# サポートされていないシナリオ
+さまざまな理由から、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でサポートされていないセキュリティ シナリオがあります。 たとえば、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] Home Edition は SSPI または Kerberos 認証プロトコルを実装しないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、このプラットフォーム上での Windows 認証を使用するサービスの実行をサポートしません。 Windows XP Home Edition で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を実行している場合、ユーザー名\/パスワードや HTTP\/HTTPS 統合認証などの他の認証機構がサポートされます。  
+  
+## 偽装シナリオ  
+  
+### クライアントが非同期呼び出しを行うと、偽装 ID はフローしない場合がある  
+ WCF クライアントが、偽装で Windows 認証を使用して WCF サービスへの非同期呼び出しを行うと、偽装 ID ではなくクライアント プロセスの ID で認証が行われる場合があります。  
+  
+### Windows XP と有効化されたセキュリティ コンテキスト トークン クッキー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では偽装はサポートされず、以下の条件に該当する場合、<xref:System.InvalidOperationException> が発生します。  
+  
+-   オペレーティング システムが [!INCLUDE[wxp](../../../../includes/wxp-md.md)] である。  
+  
+-   認証モードで Windows ID が生成された。  
+  
+-   <xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> の <xref:System.ServiceModel.OperationBehaviorAttribute> プロパティが <xref:System.ServiceModel.ImpersonationOption> に設定されます。  
+  
+-   状態ベースのセキュリティ コンテキスト トークン \(SCT: Security Context Token\) が作成された \(既定では、作成は無効になっています\)。  
+  
+ 状態ベースの SCT はカスタム バインディングの使用によってのみ作成できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。\) コードでトークンを有効にするには、<xref:System.ServiceModel.Channels.SymmetricSecurityBindingElement> メソッドまたは <xref:System.ServiceModel.Channels.AsymmetricSecurityBindingElement> メソッドを使用して、セキュリティ バインディング要素 \(<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSspiNegotiationBindingElement%28System.Boolean%29?displayProperty=fullName> または <xref:System.ServiceModel.Channels.SecurityBindingElement.CreateSecureConversationBindingElement%28System.ServiceModel.Channels.SecurityBindingElement%2CSystem.Boolean%29?displayProperty=fullName>\) を作成し、`requireCancellation` パラメーターを `false` に設定します。 このパラメーターは、SCT のキャッシュを参照します。 値を `false` に設定することによって、状態ベースの SCT 機能が有効になります。  
+  
+ また、構成でトークンを有効にするには、\<`customBinding`\> を作成して、\<`security`\> 要素を追加し、`authenticationMode` 属性を SecureConversation に、`requireSecurityContextCancellation` 属性を `true` に設定します。  
+  
+> [!NOTE]
+>  上記の要件は限定的です。 たとえば、<xref:System.ServiceModel.Channels.SecurityBindingElement.CreateKerberosBindingElement%2A> は Windows ID を生成するバインド要素を作成しますが、SCT を確立しません。 したがって、`Required` で [!INCLUDE[wxp](../../../../includes/wxp-md.md)] オプションと共に使用できます。  
+  
+### 考えられる ASP.NET との競合  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] はいずれも、偽装を有効にすることも無効にすることもできます。 このため、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションをホストしている場合に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の構成設定の間で競合が発生する可能性があります。 競合が発生した場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の設定が優先されます。ただし、<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> プロパティを <xref:System.ServiceModel.ImpersonationOption> に設定している場合は、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の偽装設定が優先されます。  
+  
+### 偽装を有効にすると、アセンブリの読み込みに失敗する場合がある  
+ 偽装されたコンテキストにアセンブリを読み込むためのアクセス権がない場合、共通言語ランタイム \(CLR: Common Language Runtime\) が AppDomain のアセンブリを初めて読み込もうとしたときに、その <xref:System.AppDomain> はエラーをキャッシュします。 この場合、偽装を元に戻した後、元に戻されたコンテキストにアセンブリを読み込むためのアクセス権があったとしても、それ以降のアセンブリの読み込みは失敗します。 これは、ユーザー コンテキストの変更後に、CLR が読み込みを再試行しないためです。 このエラーから回復するには、アプリケーション ドメインを再起動する必要があります。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> クラスの <xref:System.ServiceModel.Security.WindowsClientCredential> プロパティの既定値は <xref:System.Security.Principal.TokenImpersonationLevel> です。 ほとんどの場合、ID レベルの偽装コンテキストには、追加のアセンブリを読み込むための権限がありません。 これは既定値であるため、非常に一般的な状態として認識しておく必要があります。 ID レベルの偽装は、偽装プロセスが `SeImpersonate` 権限を持たない場合にも発生します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)。  
+  
+### 委任には資格情報ネゴシエーションが必要  
+ 委任で Kerberos 認証プロトコルを使用するには、資格情報ネゴシエーションを使用する Kerberos プロトコル \("マルチレッグ" Kerberos または "マルチステップ" Kerberos とも呼ばれます\) を実装する必要があります。 資格情報ネゴシエーションを使用しない Kerberos 認証 \(ワンショット Kerberos またはシングルレッグ Kerberos とも呼ばれる\) を実装した場合は、例外がスローされます。 資格情報ネゴシエーションの実装方法の[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[Windows 認証エラーのデバッグ](../../../../docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md)」を参照してください。  
+  
+## 暗号  
+  
+### 対称キーを使用する場合にのみサポートされる SHA\-256  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、さまざまな暗号化アルゴリズムと署名ダイジェスト作成アルゴリズムをサポートしています。これらのアルゴリズムは、システム指定のバインディングでアルゴリズム スイートを使用して指定できます。 セキュリティを強化するため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、署名ダイジェスト ハッシュを作成するためにセキュア ハッシュ アルゴリズム \(SHA: Secure Hash Algorithm\) 2 \(具体的には SHA\-256\) をサポートしています。 このリリースは、Kerberos キーなどの対称キーを使用する場合、およびメッセージに署名するために X.509 証明書を使用しない場合に限り SHA\-256 をサポートします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が現時点で RSA\-SHA256 をサポートしていないため、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] では \(X.509 証明書で使用する\) RSA 署名に SHA\-256 ハッシュを使用できません。  
+  
+### サポートされていない FIPS 準拠の SHA\-256 ハッシュ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、FIPS 準拠の SHA\-256 ハッシュをサポートしていません。したがって、FIPS 準拠のアルゴリズムを使用する必要のあるシステムでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、SHA\-256 を使用するアルゴリズム スイートをサポートしません。  
+  
+### レジストリを編集すると、FIPS 準拠のアルゴリズムが失敗する場合がある  
+ 連邦情報処理規格 \(FIPS: Federal Information Processing Standards\) 準拠のアルゴリズムを有効または無効にするには、Microsoft 管理コンソール \(MMC: Microsoft Management Console\) のローカル セキュリティ設定スナップインを使用します。 レジストリでこの設定にアクセスすることもできます。 ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、レジストリを使用した設定のリセットをサポートしていません。 値を 1 または 0 以外に設定すると、CLR とオペレーティング システム間で不整合が発生する可能性があります。  
+  
+### FIPS 準拠の AES 暗号化の制限  
+ FIPS 準拠の AES 暗号化は、ID レベルの偽装での双方向コールバックでは機能しません。  
+  
+### Windows Server 2008 での CNG\/KSP 証明書  
+ *CNG \(Cryptography API: Next Generation\)* は、CryptoAPI に代わるものとして長期的な視野に立って開発されました。 この API は [!INCLUDE[wv](../../../../includes/wv-md.md)] および [!INCLUDE[lserver](../../../../includes/lserver-md.md)] のアンマネージ コードです。  
+  
+ 下位レベルのプラットフォーム \([!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] および [!INCLUDE[wxp](../../../../includes/wxp-md.md)]\) の .NET Framework 2.0 ではこのプロトコルは認識されません。代わりに旧来の *CryptoApi* が CNG\/KSP 証明書の処理に使用されます。[!INCLUDE[lserver](../../../../includes/lserver-md.md)] および [!INCLUDE[wv](../../../../includes/wv-md.md)] の .NET Framework 3.5 はこれらの証明書をサポートしません。使用すると例外が発生します。  
+  
+ 証明書に KSP が使用されているかどうかを知る方法は 2 つあります。  
+  
+-   `p/invoke` を `CertGetCertificateContextProperty` に対して実行し、返された `dwProvType` で `CertGetCertificateContextProperty` を調べる。  
+  
+-   コマンド ラインから `certutil` コマンドを使用して証明書を調べる。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][証明書のトラブルシューティングに関する Certutil のタスク](http://go.microsoft.com/fwlink/?LinkId=120056)」を参照してください。  
+  
+## ASP.NET の偽装と ASP.NET 互換を使用する必要がある場合にメッセージ セキュリティが失敗する  
+ 次の設定の組み合わせはクライアント認証の妨げとなる可能性があるため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はこの組み合わせをサポートしていません。  
+  
+-   [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の偽装を有効にしている。 これを行うには、Web.config ファイルで \<`identity`\> 要素の `impersonate` 属性を `true` に設定します。  
+  
+-   [\<serviceHostingEnvironment\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) の `aspNetCompatibilityEnabled` 属性を `true` に設定して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換モードを有効にしている。  
+  
+-   メッセージ モード セキュリティを使用している。  
+  
+ これを回避するには、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換モードを無効にします。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換モードが必要である場合は、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の偽装機能を無効にし、代わりに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供される偽装機能を使用します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)。  
+  
+## IPv6 リテラル アドレス エラー  
+ クライアントとサービスが同じコンピューター上に存在し、サービスに対して IPv6 リテラル アドレスが使用されている場合は、セキュリティ要求が失敗します。  
+  
+ IPv6 リテラル アドレスは、サービスとクライアントがそれぞれ異なるコンピューター上に存在する場合に機能します。  
+  
+## フェデレーション信頼での WSDL 取得エラー  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、フェデレーション信頼チェーンの各ノードに対してドキュメントが正確に 1 つだけ要求されます。 エンドポイントを指定するときにループにならないように注意する必要があります。 ループになる場合の例の 1 つは、フェデレーション信頼チェーンの WSDL ダウンロードの使用で、同じ WSDL ドキュメントの中に複数のリンクがある場合です。 この問題がよく発生するシナリオは、セキュリティ トークン サーバーとセキュリティ トークン サービスが同じ ServiceHost の中にあるフェデレーション サービスです。  
+  
+ そのような状況の例は次の 3 つのエンドポイント アドレスを使うサービスです。  
+  
+-   http:\/\/localhost\/CalculatorService\/service \(サービス\)  
+  
+-   http:\/\/localhost\/CalculatorService\/issue\_ticket \(セキュリティ トークン サービス\)  
+  
+-   http:\/\/localhost\/CalculatorService\/mex \(メタデータ エンドポイント\)  
+  
+ これによって例外がスローされます。  
+  
+ このシナリオでエラーを避けるには、`issue_ticket` エンドポイントを別のところに置きます。  
+  
+## WSDL インポート属性が失われる可能性  
+ WSDL インポートの際に、WCF は `<wst:Claims>` テンプレート内の `RST` 要素にあるインポート属性を追跡できなくなることがあります。 これは、クレームの種類のコレクションを直接使用する代わりに `<Claims>` を直接 `WSFederationHttpBinding.Security.Message.TokenRequestParameters` または `IssuedSecurityTokenRequestParameters.AdditionalRequestParameters` 内で指定した場合に、WSDL インポートの際に発生します。  インポートが属性を失うので、WSDL を介して正しいバインディングのラウンド トリップが行われません。したがって、クライアント側で不適切になります。  
+  
+ 解決策は、インポートを行った後、クライアント側で直接バインディングを変更することです。  
+  
+## 参照  
+ [セキュリティの考慮事項](../../../../docs/framework/wcf/feature-details/security-considerations-in-wcf.md)   
+ [情報の漏えい](../../../../docs/framework/wcf/feature-details/information-disclosure.md)   
+ [権限の昇格](../../../../docs/framework/wcf/feature-details/elevation-of-privilege.md)   
+ [サービス拒否](../../../../docs/framework/wcf/feature-details/denial-of-service.md)   
+ [改変](../../../../docs/framework/wcf/feature-details/tampering.md)   
+ [リプレイ攻撃](../../../../docs/framework/wcf/feature-details/replay-attacks.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md b/docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md
new file mode 100644
index 00000000000..a90460a922e
--- /dev/null
+++ b/docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md
@@ -0,0 +1,352 @@
+---
+title: "UriTemplate と UriTemplateTable | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5cbbe03f-4a9e-4d44-9e02-c5773239cf52
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# UriTemplate と UriTemplateTable
+Web 開発者は、サービスの応答先となる URI の形状とレイアウトを記述できる必要があります。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、開発者が URI を制御するための 2 つの新しいクラスが追加されています。<xref:System.UriTemplate> と <xref:System.UriTemplateTable> は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] における URI ベースのディスパッチ エンジンの基盤となります。これらのクラスは単独で使用することもできるため、開発者は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実装せずにテンプレートと URI マッピング機構を利用できます。  
+  
+## テンプレート  
+ テンプレートとは、一連の相対 URI を記述する方法です。次の表の URI テンプレートのセットは、各種気象情報を取得するシステムがどのように定義されているかを示しています。  
+  
+|データ|テンプレート|  
+|---------|------------|  
+|国の天気予報|weather\/national|  
+|州の天気予報|weather\/{state}|  
+|都市の天気予報|weather\/{state}\/{city}|  
+|アクティビティの天気予報|weather\/{state}\/{city}\/{activity}|  
+  
+ この表は、構造が似ている一連の URI を示しています。各エントリが URI テンプレートです。中かっこで囲まれたセグメントは変数を表します。中かっこで囲まれていないセグメントはリテラル文字を表します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のテンプレート クラスを使用すると、開発者は "\/weather\/wa\/seattle\/cycling" のような受信 URI を取得し、これを "\/weather\/{state}\/{city}\/{activity}" として説明するテンプレートと照合できます。  
+  
+## UriTemplate  
+ <xref:System.UriTemplate> は、URI テンプレートをカプセル化するクラスです。コンストラクターは、テンプレートを定義する文字列パラメーターを受け取ります。この文字列には、次のセクションで説明する形式のテンプレートが含まれます。<xref:System.UriTemplate> クラスには、受信 URI をテンプレートと照合するメソッド、テンプレートから URI を生成するメソッド、テンプレートで使用されている変数名のコレクションを取得するメソッド、2 つのテンプレートが等しいかどうかを判断するメソッド、およびテンプレートの文字列を返すメソッドが用意されています。  
+  
+ <xref:System.UriTemplate.Match%28System.Uri%2CSystem.Uri%29> は、ベース アドレスと候補となる URI を取得し、その URI をテンプレートと照合します。URI とテンプレートが一致した場合は、<xref:System.UriTemplateMatch> インスタンスが返されます。<xref:System.UriTemplateMatch> オブジェクトには、ベース URI、候補となる URI、クエリ パラメーターの名前\/値コレクション、相対パス セグメントの配列、一致した変数の名前\/値コレクション、照合を実行する際に使用する <xref:System.UriTemplate> インスタンス、候補となる URI の一致していない部分を含む文字列 \(テンプレートにワイルドカードが含まれているときに使用\)、およびテンプレートに関連付けられたオブジェクトが格納されます。  
+  
+> [!NOTE]
+>  <xref:System.UriTemplate> クラスは、候補となる URI をテンプレートと照合するときにスキームとポート番号を無視します。  
+  
+ テンプレートから URI を生成できるメソッドとして、<xref:System.UriTemplate.BindByName%28System.Uri%2CSystem.Collections.Specialized.NameValueCollection%29> と [BindByPosition\(Uri, String\<xref:System.UriTemplate.BindByPosition%28System.Uri%2CSystem.String%5B%5D%29> の 2 つのメソッドがあります。<xref:System.UriTemplate.BindByName%28System.Uri%2CSystem.Collections.Specialized.NameValueCollection%29> は、ベース アドレスおよびパラメーターの名前\/値コレクションを取得します。テンプレートのバインド時に、これらのパラメーターが変数に代入されます。[BindByPosition\(Uri, String\<xref:System.UriTemplate.BindByPosition%28System.Uri%2CSystem.String%5B%5D%29> は、名前と値のペアを取得し、これらのペアを左から右の順に代入します。  
+  
+ <xref:System.UriTemplate.ToString> は、テンプレート文字列を返します。  
+  
+ <xref:System.UriTemplate.PathSegmentVariableNames%2A> プロパティには、テンプレート文字列のパス セグメント内で使用される変数の名前のコレクションが格納されます。  
+  
+ <xref:System.UriTemplate.IsEquivalentTo%28System.UriTemplate%29> は <xref:System.UriTemplate> をパラメーターとして受け取り、2 つのテンプレートが等しいかどうかを示すブール値を返します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]このトピックで後述する「テンプレートの等価性」を参照してください。  
+  
+ <xref:System.UriTemplate> は、HTTP URI 文法に準じるすべての URI スキームで使用できるように設計されています。サポートされている URI スキームの例を次に示します。  
+  
+-   http:\/\/  
+  
+-   https:\/\/  
+  
+-   net.tcp:\/\/  
+  
+-   net.pipe:\/\/  
+  
+-   sb:\/\/  
+  
+ file:\/\/ や urn:\/\/ などのスキームは、HTTP URI 文法に準じていません。このため、URI テンプレートで使用すると予期せぬ結果が発生します。  
+  
+### テンプレート文字列の構文  
+ テンプレートには、パス、クエリ \(省略可能\)、およびフラグメント \(省略可能\) の 3 つの部分があります。テンプレートの一例を次に示します。  
+  
+```  
+"/weather/{state}/{city}?forecast={length)#frag1  
+```  
+  
+ パスは "\/weather\/{state}\/{city}"、クエリは "?forecast\={length}、フラグメントは "\#frag1" でそれぞれ構成されています。  
+  
+ パス式では、先頭と末尾のスラッシュは省略可能です。クエリ式とフラグメント式は、いずれも式全体を省略できます。パスは '\/' で区切られた一連のセグメントで構成され、各セグメントにはリテラル値、変数名 \(中かっこ \({}\) 内に記述\)、またはワイルドカード \('\*'\) を含めることができます。上記のテンプレートでは、"\/weather\/" セグメントがリテラル値で、"{state}" と "{city}" が変数です。変数は中かっこの内容から名前を取得し、後で具体的な値に置き換えることで*「完成した URI」*を作成できます。ワイルドカードは省略可能です。ただし、ワイルドカードは URI の末尾にのみ指定できます。これによって、"パスの残りの部分" と論理的に一致することを表現します。  
+  
+ クエリ式 \(存在する場合\) では、'&' で区切られた順序なしの一連の名前と値のペアを指定します。クエリ式の要素には、リテラル ペア \(x\=2\) または変数ペア \(x\={var}\) を指定できます。変数を指定できるのはクエリ式の右辺のみです。\({someName} \= {someValue}\) は指定できません。対になっていない値 \(?x\) は使用できません。空のクエリ式と、1 つの '?' だけで構成されたクエリ式は同じものです \(いずれも "任意のクエリ" を意味します\)。  
+  
+ フラグメント式はリテラル値で構成できます。変数は使用できません。  
+  
+ テンプレート文字列内のすべてのテンプレート変数名は、一意であることが必要です。テンプレート変数名では、大文字と小文字は区別されません。  
+  
+ 有効なテンプレート文字列の例を以下に示します。  
+  
+-   ""  
+  
+-   "\/shoe"  
+  
+-   "\/shoe\/\*"  
+  
+-   "{shoe}\/boat"  
+  
+-   "{shoe}\/{boat}\/bed\/{quilt}"  
+  
+-   "shoe\/{boat}"  
+  
+-   "shoe\/{boat}\/\*"  
+  
+-   "shoe\/boat?x\=2"  
+  
+-   "shoe\/{boat}?x\={bed}"  
+  
+-   "shoe\/{boat}?x\={bed}&y\=band"  
+  
+-   "?x\={shoe}"  
+  
+-   "shoe?x\=3&y\={var}  
+  
+ 無効なテンプレート文字列の例を以下に示します。  
+  
+-   "{shoe}\/{SHOE}\/x\=2" – 変数名が重複しています。  
+  
+-   "{shoe}\/boat\/?bed\={shoe}" – 変数名が重複しています。  
+  
+-   "?x\=2&x\=3" – クエリ文字列内の名前と値のペアは、リテラルである場合でも一意でなければなりません。  
+  
+-   "?x\=2&" – クエリ文字列の形式に誤りがあります。  
+  
+-   "?2&x\={shoe}" – クエリ文字列は、名前と値のペアである必要があります。  
+  
+-   "?y\=2&&X\=3" – クエリ文字列は、名前と値のペアである必要があります。名前を '&' で始めることはできません。  
+  
+### 複合パス セグメント  
+ 複合パス セグメントでは、単一の URI パス セグメントに複数の変数およびリテラルと組み合わせた変数を含むことができます。有効な複合パス セグメントの例を次に示します。  
+  
+-   \/filename.{ext}\/  
+  
+-   \/{filename}.jpg\/  
+  
+-   \/{filename}.{ext}\/  
+  
+-   \/{a}.{b}someLiteral{c}\({d}\)\/  
+  
+ 無効なパス セグメントの例を次に示します。  
+  
+-   \/{} – 変数には名前が付けられている必要があります。  
+  
+-   \/{shoe}{boat} – 変数はリテラルによって分割されている必要があります。  
+  
+### 照合と複合パス セグメント  
+ 複合パス セグメントを使用すると、1 つのパス セグメント内に複数の変数を含む UriTemplate を定義できます。たとえば、"Addresses\/{state}.{city}" というテンプレート文字列では、2 つの変数 \(state と city\) が同じセグメント内で定義されています。このテンプレートは、"http:\/\/example.com\/Washington.Redmond" などの URL と一致しますが、"http:\/\/example.com\/Washington.Redmond.Microsoft" のような URL とも一致します。後者の場合、state 変数には "Washington" が含まれ、city 変数には "Redmond.Microsoft" が含まれます。この場合、任意のテキスト \('\/' 以外\) が {city} 変数と一致することになります。テンプレートが "余分な" テキストと一致しないようにするには、"Addresses\/{state}\/{city}" のように、個別のテンプレート セグメントに変数を配置します。  
+  
+### 名前付きワイルドカード セグメント  
+ 名前付きワイルドカード セグメントは、ワイルドカード文字 '\*' で始まる変数名を持つ任意のパス変数セグメントです。次のテンプレート文字列には、"shoe" という名前付きワイルドカード セグメントが含まれています。  
+  
+```  
+"literal/{*shoe}"  
+```  
+  
+ ワイルドカード セグメントは、次の規則に従う必要があります。  
+  
+-   1 つのテンプレート文字列に含められる名前付きワイルドカード セグメントは 1 つのみです。  
+  
+-   名前付きワイルドカード セグメントは、パス内の右端のセグメントにある必要があります。  
+  
+-   名前付きワイルドカード セグメントは、匿名ワイルドカード セグメントのあるテンプレート文字列には使用できません。  
+  
+-   名前付きワイルドカード セグメントの名前は一意である必要があります。  
+  
+-   名前付きワイルドカード セグメントには既定値を指定できません。  
+  
+-   名前付きワイルドカード セグメントの末尾には "\/" は付けられません。  
+  
+### 既定変数値  
+ 既定変数値を使用すると、テンプレート内で変数に既定値を指定できます。既定変数は、変数を宣言する中かっこを使用して指定することも、UriTemplate コンストラクターに渡されるコレクションとして指定することもできます。次のテンプレートに、既定値のある変数を使用して <xref:System.UriTemplate> を指定する 2 つの方法を示します。  
+  
+```  
+UriTemplate t = new UriTemplate("/test/{a=1}/{b=5}");  
+```  
+  
+ このテンプレートでは、既定値が `1` で `a` という名前の変数と、既定値が `5` で `b` という名前の変数が宣言されています。  
+  
+> [!NOTE]
+>  パス セグメント変数のみが、既定値を持つことができます。クエリ文字列変数、複合セグメント変数、および名前付きワイルドカード変数には、既定値を指定することはできません。  
+  
+ 候補 URI との照合時に、既定値のある変数がどのように処理されるかを次のコードに示します。  
+  
+```  
+Uri baseAddress = new Uri("http://localhost:800   
+Dictionary<string,string> defVals = new Dictionary<string,string> {{"a","1"}, {"b", "5"}};  
+UriTemplate t = new UriTemplate("/test/{a}/{b}", defVals);0");  
+UriTemplate t = new UriTemplate("/{state=WA}/{city=Redmond}/", true);  
+Uri candidate = new Uri("http://localhost:8000/OR");  
+  
+UriTemplateMatch m1 = t.Match(baseAddress, candidate);  
+  
+// Display contents of BoundVariables  
+foreach (string key in m1.BoundVariables.AllKeys)  
+{  
+    Console.WriteLine("\t\t{0}={1}", key, m1.BoundVariables[key]);  
+}  
+// The output of the above code is  
+// Template: /{state=WA}/{city=Redmond}/  
+// Candidate URI: http://localhost:8000/OR  
+// BoundVariables:  
+//      STATE=OR  
+//       CITY=Redmond  
+  
+```  
+  
+> [!NOTE]
+>  http:\/\/localhost:8000\/\/\/ のような URI は、上記のコード内に一覧表示されるテンプレートには一致しません。一致するのは、http:\/\/localhost:8000\/ のような URI です。  
+  
+ テンプレートを使用して URI を作成する場合に、既定値のある変数がどのように処理されるかを次のコードに示します。  
+  
+```  
+Uri baseAddress = new Uri("http://localhost:8000/");  
+Dictionary<string,string> defVals = new Dictionary<string,string> {{"a","1"}, {"b", "5"}};  
+UriTemplate t = new UriTemplate("/test/{a}/{b}", defVals);  
+NameValueCollection vals = new NameValueCollection();  
+vals.Add("a", "10");  
+  
+Uri boundUri = t.BindByName(baseAddress, vals);  
+Console.WriteLine("BaseAddress: {0}", baseAddress);  
+Console.WriteLine("Template: {0}", t.ToString());  
+  
+Console.WriteLine("Values: ");  
+foreach (string key in vals.AllKeys)  
+{  
+    Console.WriteLine("\tKey = {0}, Value = {1}", key, vals[key]);  
+}  
+Console.WriteLine("Bound URI: {0}", boundUri);  
+  
+// The output of the preceding code is  
+// BaseAddress: http://localhost:8000/  
+// Template: /test/{a}/{b}  
+// Values:  
+//     Key = a, Value = 10  
+// Bound URI: http://localhost:8000/test/10/5  
+  
+```  
+  
+ 変数の既定値として `null` が指定されている場合、さらに追加の制約があります。テンプレート文字列の右端のセグメントに変数を含んでいるか、その変数の右側にあるすべてのセグメントが `null` を既定値としている変数のみに既定値として `null` を指定できます。既定値に `null` が指定されている有効なテンプレート文字列を次に示します。  
+  
+-   ```  
+    UriTemplate t = new UriTemplate("shoe/{boat=null}");  
+    ```  
+  
+-   ```  
+    UriTemplate t = new UriTemplate("{shoe=null}/{boat=null}");  
+    ```  
+  
+-   ```  
+    UriTemplate t = new UriTemplate("{shoe=1}/{boat=null}");  
+    ```  
+  
+ 既定値に `null` が指定されている無効なテンプレート文字列を次に示します。  
+  
+-   ```  
+    UriTemplate t = new UriTemplate("{shoe=null}/boat"); // null default must be in the right most path segment  
+    ```  
+  
+-   ```  
+    UriTemplate t = new UriTemplate("{shoe=null}/{boat=x}/{bed=null}"); // shoe cannot have a null default because boat does not have a default null value  
+    ```  
+  
+### 既定値と照合  
+ 候補 URI と既定値が指定されているテンプレートとの照合時に、候補 URI に値が指定されていない場合には、<xref:System.UriTemplateMatch.BoundVariables%2A> コレクションに既定値が配置されます。  
+  
+### テンプレートの等価性  
+ 2 つのテンプレートのすべてのリテラルが一致し、同じセグメントに変数が含まれる場合、その 2 つのテンプレートは "*構造的に等しい*" と言います。たとえば、次のテンプレートは構造的に等しいテンプレートです。  
+  
+-   \/a\/{var1}\/b b\/{var2}?x\=1&y\=2  
+  
+-   a\/{x}\/b%20b\/{var1}?y\=2&x\=1  
+  
+-   a\/{y}\/B%20B\/{z}\/?y\=2&x\=1  
+  
+ 次の点に注意してください。  
+  
+-   テンプレートに先頭のスラッシュが含まれている場合、最初の 1 つだけが無視されます。  
+  
+-   テンプレート文字列が構造的に等しいかどうかを比較する場合、変数名とパス セグメントでは大文字小文字は無視されますが、クエリ文字列では区別されます。  
+  
+-   クエリ文字列は順序なしです。  
+  
+## UriTemplateTable  
+ <xref:System.UriTemplateTable> クラスは、開発者が選択したオブジェクトにバインドされた <xref:System.UriTemplate> オブジェクトの結合テーブルを表します。<xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> を呼び出す前に、<xref:System.UriTemplateTable> に 1 つ以上の <xref:System.UriTemplate> を含めておく必要があります。<xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> が呼び出されるまでは、<xref:System.UriTemplateTable> の内容を変更できます。<xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> が呼び出されると、検証が実行されます。実行される検証の種類は、<xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> に対する `allowMultiple` パラメーターの値によって異なります。  
+  
+ `false` を渡して <xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> を呼び出した場合、<xref:System.UriTemplateTable> はテーブル内に複数のテンプレートが存在しないことを確認します。構造的に等しいテンプレートが見つかった場合は、例外がスローされます。これは、受信 URI と一致するテンプレートが 1 つだけであることを確認する場合に、<xref:System.UriTemplateTable.MatchSingle%28System.Uri%29> と組み合わせて使用します。  
+  
+ `true` を渡して <xref:System.UriTemplateTable.MakeReadOnly%28System.Boolean%29> を呼び出した場合、<xref:System.UriTemplateTable> は、構造的に等しい複数のテンプレートが <xref:System.UriTemplateTable> に含まれることを許可します。  
+  
+ <xref:System.UriTemplateTable> に追加された一連の <xref:System.UriTemplate> オブジェクトにクエリ文字列が含まれている場合、これらの文字列をあいまいにすることはできません。許可されるのは同一のクエリ文字列です。  
+  
+> [!NOTE]
+>  <xref:System.UriTemplateTable> では、HTTP 以外のスキームを使用したベース アドレスを使用できますが、候補 URI をテンプレートと照合する場合にスキームおよびポート番号は無視されます。  
+  
+### クエリ文字列のあいまいさ  
+ 複数のテンプレートと一致する URI が存在する場合、等しいパスを共有するテンプレートにあいまいなクエリ文字列が含まれています。  
+  
+ クエリ文字列の次のセットにはあいまいさはありません。  
+  
+-   ?x\=1  
+  
+-   ?x\=2  
+  
+-   ?x\=3  
+  
+-   ?x\=1&y\={var}  
+  
+-   ?x\=2&z\={var}  
+  
+-   ?x\=3  
+  
+-   ?x\=1  
+  
+-   ?  
+  
+-   ?x\={var}  
+  
+-   ?  
+  
+-   ?m\=get&c\=rss  
+  
+-   ?m\=put&c\=rss  
+  
+-   ?m\=get&c\=atom  
+  
+-   ?m\=put&c\=atom  
+  
+ クエリ文字列テンプレートの次のセットにはあいまいさがあります。  
+  
+-   ?x\=1  
+  
+-   ?x\={var}  
+  
+ "x\=1" \- 両方のテンプレートに一致します。  
+  
+-   ?x\=1  
+  
+-   ?y\=2  
+  
+ "x\=1&y\=2" は両方のテンプレートに一致します。これは、クエリ文字列に、一致するテンプレートよりも多くのクエリ文字列変数が含まれている可能性があるからです。  
+  
+-   ?x\=1  
+  
+-   ?x\=1&y\={var}  
+  
+ "x\=1&y\=3" は両方のテンプレートに一致します。  
+  
+-   ?x\=3&y\=4  
+  
+-   ?x\=3&z\=5  
+  
+> [!NOTE]
+>  文字 á と Á が URI パスまたは <xref:System.UriTemplate> のパス セグメントのリテラルの一部として出現した場合、これらは異なる文字と見なされます \(ただし、a と A は同じ文字と見なされます\)。文字 á と Á が <xref:System.UriTemplate> の {variableName} またはクエリ文字列の一部として出現した場合は、これらは同じ文字と見なされます \(a と A も同じ文字と見なされます\)。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)   
+ [WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)   
+ [UriTemplate](../../../../docs/framework/wcf/samples/uritemplate-sample.md)   
+ [UriTemplate テーブル](../../../../docs/framework/wcf/samples/uritemplate-table-sample.md)   
+ [UriTemplate テーブル ディスパッチャー](../../../../docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/use-the-wcf-service-moniker-without-registration.md b/docs/framework/wcf/feature-details/use-the-wcf-service-moniker-without-registration.md
new file mode 100644
index 00000000000..c8c085e2a9a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/use-the-wcf-service-moniker-without-registration.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : 未登録で Windows Communication Foundation のサービス モニカーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "COM [WCF], 登録を使用しないサービス モニカー"
+ms.assetid: ee3cf5c0-24f0-4ae7-81da-73a60de4a1a8
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 方法 : 未登録で Windows Communication Foundation のサービス モニカーを使用する
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに接続して通信するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションに、サービス アドレス、バインディング構成、およびサービス コントラクトの詳細が必要です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーは通常、必要な属性型の前の登録から必要なコントラクトを取得しますが、これが適切でない場合もあります。  登録の代わりに、モニカーは、`wsdl` パラメーターまたは Metadata Exchange を使用し、`mexAddress` パラメーターを使用することによって、WSDL \(Web Services Definition Language\) ドキュメントの形でコントラクトの定義を取得できます。  
+  
+ これによって、セルの値の一部が Web サービスとの対話によって計算される Excel ワークシートの配布などのシナリオが可能になります。  このシナリオでは、ドキュメントを開く可能性があるすべてのクライアントにサービス コントラクト アセンブリを登録することが実現できない可能性があります。  `wsdl` パラメーターまたは `mexAddress` パラメーターによって、自己完結型のソリューションが可能になります。  
+  
+> [!NOTE]
+>  要求と応答の改ざんまたはなりすましを防止するために、相互認証を使用する必要があります。  具体的には、応答している Metadata Exchange エンドポイントが目的の信頼されたパーティであることがクライアントに対して保証されることが重要です。  
+  
+## 例  
+ MEX コントラクトと共にサービス モニカーを使用する例を次に示します。  次のコントラクトが設定されたサービスは、wsHttpBinding で公開されます。  
+  
+```  
+using System.ServiceModel;  
+  
+...  
+  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Demo")]  
+public interface IAffiliate  
+{  
+    [OperationContract]  
+    bool NewAffiliate(string ID, string company, string fullname, string accountsCode);  
+    [OperationContract]  
+    bool RemoveAffiliate(string ID);  
+    [OperationContract]  
+    double RevenueCheckMonthly(ref string ID);  
+    [OperationContract]  
+    double RevenueCheckTotal(ref string ID);  
+}  
+```  
+  
+ リモート サービスに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成するとき、次の例に示すモニカーの文字列を使用できます。  
+  
+```  
+service4:mexAddress="http://servername/Affiliates/service.svc/mex",  
+address="http://servername/Affiliates/service.svc",  
+contract=IAffiliate, contractNamespace=http://Microsoft.ServiceModel.Demo,  
+binding=WSHttpBinding_IAffiliate, bindingNamespace=http://tempuri.org/  
+```  
+  
+ クライアント アプリケーションの実行中に、クライアントは、指定された `mexAddress` で `WS-MetadataExchange` を実行します。  これによって、複数のサービスのアドレス、バインディング、およびコントラクトの詳細が返される可能性があります。  `address`、`contract`、`contractNamespace`、`binding`、および `bindingNamespace` の各パラメーターは、目的のサービスを識別するために使用されます。  このパラメーターが一致した場合、モニカーは、適切なコントラクト定義を使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを作成します。これによって、型指定されたコントラクトと同様、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを使用して呼び出しを実行できるようになります。  
+  
+> [!NOTE]
+>  モニカーの形式が正しくないか、サービスを使用できない場合は、`GetObject` を呼び出すと、"構文が無効です" というエラーが返されます。  このエラーが発生した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。  
+  
+## 参照  
+ [方法 : サービス モニカーを登録および構成する](../../../../docs/framework/wcf/feature-details/how-to-register-and-configure-a-service-moniker.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-a-custom-binding-with-the-discovery-client-channel.md b/docs/framework/wcf/feature-details/using-a-custom-binding-with-the-discovery-client-channel.md
new file mode 100644
index 00000000000..607d8b08ad2
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-a-custom-binding-with-the-discovery-client-channel.md
@@ -0,0 +1,58 @@
+---
+title: "カスタム バインディングを探索クライアント チャネルと共に使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 36f95e75-04f7-44f3-a995-a0d623624d7f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# カスタム バインディングを探索クライアント チャネルと共に使用する
+カスタム バインディングを <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> と共に使用する場合は、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> インスタンスを作成する <xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider> を定義する必要があります。  
+  
+## DiscoveryEndpointProvider の作成  
+ <xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider> は、[T:System:ServiceModel.Discovery.DiscoveryEndpoints](assetId:///T:System:ServiceModel.Discovery.DiscoveryEndpoints?qualifyHint=False&amp;autoUpgrade=True) を必要に応じて作成します。探索エンドポイント プロバイダーを定義するには、<xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider> からクラスを派生させ、<xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider.GetDiscoveryEndpoint%2A> メソッドをオーバーライドし、新しい探索エンドポイントを返します。次の例は、探索エンドポイント プロバイダーを作成する方法を示しています。  
+  
+```  
+// Extend DiscoveryEndpointProvider class to change the default DiscoveryEndpoint  
+// to the DiscoveryClientBindingElement. The Discovery ClientChannel   
+// uses this endpoint to send Probe message.  
+public class UdpDiscoveryEndpointProvider : DiscoveryEndpointProvider  
+{  
+   public override DiscoveryEndpoint GetDiscoveryEndpoint()  
+   {  
+      return new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscoveryApril2005);  
+   }  
+}  
+```  
+  
+ 探索エンドポイント プロバイダーを定義したら、次の例に示すように、カスタム バインディングを作成し、その探索エンドポイント プロバイダーを参照する <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> を追加できます。  
+  
+```  
+DiscoveryClientBindingElement discoveryBindingElement = new DiscoveryClientBindingElement();  
+  
+// Provide the search criteria and the endpoint over which the probe is sent.  
+discoveryBindingElement.FindCriteria = new FindCriteria(typeof(ICalculatorService));  
+discoveryBindingElement.DiscoveryEndpointProvider = new UdpDiscoveryEndpointProvider();  
+  
+CustomBinding customBinding = new CustomBinding(new NetTcpBinding());  
+// Insert DiscoveryClientBindingElement at the top of the BindingElement stack.  
+// An exception is thrown if this binding element is not at the top.  
+customBinding.Elements.Insert(0, discoveryBindingElement);  
+```  
+  
+ 探索クライアント チャネルの使用[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[探索クライアント チャネルの使用](../../../../docs/framework/wcf/feature-details/using-the-discovery-client-channel.md)」を参照してください。コード例全体については、「[探索バインディング要素のサンプル](../../../../docs/framework/wcf/samples/discovery-binding-element-sample.md)」を参照してください。  
+  
+## 参照  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)   
+ [探索クライアント チャネルの使用](../../../../docs/framework/wcf/feature-details/using-the-discovery-client-channel.md)   
+ [探索バインディング要素のサンプル](../../../../docs/framework/wcf/samples/discovery-binding-element-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-a-data-contract-resolver.md b/docs/framework/wcf/feature-details/using-a-data-contract-resolver.md
new file mode 100644
index 00000000000..e1176efb259
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-a-data-contract-resolver.md
@@ -0,0 +1,102 @@
+---
+title: "データ コントラクト リゾルバーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e68a16c-36f0-4df4-b763-32021bff2b89
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# データ コントラクト リゾルバーの使用
+データ コントラクト リゾルバーでは、既知の型を動的に構成できます。データ コントラクトが予期しない型をシリアル化または逆シリアル化するときには、既知の型が必要です。既知の型[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)」を参照してください。通常、既知の型は静的に指定されます。これは、操作を実装する間に操作が受け取る可能性のあるすべての型を把握しておく必要があることを意味します。これが当てはまらず、既知の型を動的に指定できることが重要である場合もあります。  
+  
+## データ コントラクト リゾルバーの作成  
+ データ コントラクト リゾルバーを作成する際には、2 つのメソッド、<xref:System.Runtime.Serialization.DataContractResolver.TryResolveType%2A> および <xref:System.Runtime.Serialization.DataContractResolver.ResolveName%2A> を実装します。これらの 2 つのメソッドは、シリアル化および逆シリアル化の際に使用されるコールバックを実装します。<xref:System.Runtime.Serialization.DataContractResolver.TryResolveType%2A> メソッドはシリアル化の際に呼び出されて、データ コントラクト型を受け取り、それを `xsi:type` の名前および名前空間にマップします。<xref:System.Runtime.Serialization.DataContractResolver.ResolveName%2A> メソッドは逆シリアル化の際に呼び出されて、`xsi:type` の名前および名前空間を受け取り、それをデータ コントラクト型に解決します。これらのメソッドの両方には `knownTypeResolver` パラメーターがあり、これを使用して、既定の既知の型のリゾルバーを実装で使用できます。  
+  
+ 次の例は、<xref:System.Runtime.Serialization.DataContractResolver> を実装し、データ コントラクト型 `Person` から派生した `Customer` という名前のデータ コントラクト型との間でマッピングを行う方法を示しています。  
+  
+```csharp  
+public class MyCustomerResolver : DataContractResolver  
+{  
+    public override bool TryResolveType(Type dataContractType, Type declaredType, DataContractResolver knownTypeResolver, out XmlDictionaryString typeName, out XmlDictionaryString typeNamespace)  
+    {  
+        if (dataContractType == typeof(Customer))  
+        {  
+            XmlDictionary dictionary = new XmlDictionary();  
+            typeName = dictionary.Add("SomeCustomer");  
+            typeNamespace = dictionary.Add("http://tempuri.com");  
+            return true;  
+        }  
+        else  
+        {  
+            return knownTypeResolver.TryResolveType(dataContractType, declaredType, null, out typeName, out typeNamespace);  
+        }  
+    }  
+  
+    public override Type ResolveName(string typeName, string typeNamespace, DataContractResolver knownTypeResolver)  
+    {  
+        if (typeName == "SomeCustomer" && typeNamespace == "http://tempuri.com")  
+        {  
+            return typeof(Customer);  
+        }  
+        else  
+        {  
+            return knownTypeResolver.ResolveName(typeName, typeNamespace, null);  
+        }  
+    }  
+}  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractResolver> を定義したら、次の例に示すように、それを <xref:System.Runtime.Serialization.DataContractSerializer> コンストラクターに渡して使用できます。  
+  
+```  
+XmlObjectSerializer serializer = new DataContractSerializer(typeof(Customer), null, Int32.MaxValue, false, false, null, new MyCustomerResolver());  
+```  
+  
+ 次の例に示すように、<xref:System.Runtime.Serialization.DataContractSerializer> を、<xref:System.Runtime.Serialization.DataContractSerializer.ReadObject%2A> メソッドまたは <xref:System.Runtime.Serialization.DataContractSerializer.WriteObject%2A> メソッドへの呼び出しで指定できます。  
+  
+```  
+MemoryStream ms = new MemoryStream();  
+DataContractSerializer serializer = new DataContractSerializer(typeof(Customer));  
+XmlDictionaryWriter writer = XmlDictionaryWriter.CreateDictionaryWriter(XmlWriter.Create(ms));  
+serializer.WriteObject(writer, new Customer(), new MyCustomerResolver());  
+writer.Flush();  
+ms.Position = 0;  
+Console.WriteLine(((Customer)serializer.ReadObject(XmlDictionaryReader.CreateDictionaryReader(XmlReader.Create(ms)), false, new MyCustomerResolver()));  
+  
+```  
+  
+ また、次の例に示すように、<xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior> で設定することもできます。  
+  
+```  
+ServiceHost host = new ServiceHost(typeof(MyService));  
+  
+ContractDescription cd = host.Description.Endpoints[0].Contract;  
+OperationDescription myOperationDescription = cd.Operations.Find("Echo");  
+  
+DataContractSerializerOperationBehavior serializerBehavior = myOperationDescription.Behaviors.Find<DataContractSerializerOperationBehavior>();  
+if (serializerBehavior == null)  
+{  
+    serializerBehavior = new DataContractSerializerOperationBehavior(myOperationDescription);  
+    myOperationDescription.Behaviors.Add(serializerBehavior);  
+}  
+  
+SerializerBehavior.DataContractResolver = new MyCustomerResolver();  
+  
+```  
+  
+ サービスに適用できる属性を実装して、データ コントラクト リゾルバーを宣言によって指定できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[KnownAssemblyAttribute](../../../../docs/framework/wcf/samples/knownassemblyattribute.md)」のサンプルを参照してください。このサンプルでは "KnownAssembly" と呼ばれる属性を実装します。これはサービスの動作にカスタム データ コントラクト リゾルバーを追加します。  
+  
+## 参照  
+ [既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [DataContractSerializer サンプル](../../../../docs/framework/wcf/samples/datacontractserializer-sample.md)   
+ [KnownAssemblyAttribute](../../../../docs/framework/wcf/samples/knownassemblyattribute.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-contracts-in-workflow.md b/docs/framework/wcf/feature-details/using-contracts-in-workflow.md
new file mode 100644
index 00000000000..818070ee2ff
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-contracts-in-workflow.md
@@ -0,0 +1,49 @@
+---
+title: "ワークフロー内でのコントラクトの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 939c64e9-e7cc-4abc-b41e-27cfce1d7e50
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ワークフロー内でのコントラクトの使用
+サービスを実装するときは、サービスおよびサービスが送受信するデータを説明する一連のコントラクトを定義します。データは、データ コントラクトとメッセージ コントラクトで表されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスもワークフロー サービスも、サービスの説明の一環として、データ コントラクトとメッセージ コントラクトの定義を使用します。サービス自体は、\(WSDL の形で\) メタデータを公開して、サービスの操作を説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービス コントラクトと操作コントラクトによって、サービスとサービスがサポートする操作を定義します。ただし、ワークフロー サービスでは、これらのコントラクトはビジネス プロセス自体の一部になり、コントラクト推論と呼ばれるプロセスによってメタデータとして公開されます。  
+  
+## コントラクト推論  
+ ワークフロー サービスが <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされている場合は、ワークフローで見つかった一連のメッセージ アクティビティに基づいて、ワークフロー定義が確認され、コントラクトが生成されます。具体的には、次のアクティビティとプロパティが、コントラクトの生成に使用されます。  
+  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティ  
+  
+-   <xref:System.ServiceModel.Activities.Receive.ServiceContractName%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.OperationContractName%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.Action%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.ValueType%2A>  
+  
+ <xref:System.ServiceModel.Activities.SendReply> アクティビティ  
+  
+-   <xref:System.ServiceModel.Activities.SendReply.Action%2A>  
+  
+-   <xref:System.ServiceModel.Activities.SendReply.ValueType%2A>  
+  
+ <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティ  
+  
+ コントラクト推論の結果は、WCF サービスと操作コントラクトと同じデータ構造を使用するサービスの説明になります。この情報を使用して、ワークフロー サービス用に WSDL が公開されます。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)   
+ [方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)   
+ [既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](../../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-data-contracts.md b/docs/framework/wcf/feature-details/using-data-contracts.md
new file mode 100644
index 00000000000..c75191aa26d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-data-contracts.md
@@ -0,0 +1,89 @@
+---
+title: "データ コントラクトの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "DataContractAttribute クラス"
+  - "WCF, データ"
+  - "データ コントラクト [WCF]"
+ms.assetid: a3ae7b21-c15c-4c05-abd8-f483bcbf31af
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# データ コントラクトの使用
+*データ コントラクト*は、サービスとクライアントの間の正式な取り決めであり、交換されるデータが抽象的に記述されています。 つまり、クライアントとサービスが通信するために必要なのは同じデータ コントラクトだけで、同じ型を共有する必要はありません。 データ コントラクトは、パラメーターまたは戻り値の型ごとに、交換するためにシリアル化する \(XML に変換する\) 必要があるデータを正確に定義します。  
+  
+## データ コントラクトの基本  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、データ コントラクト シリアライザーと呼ばれるシリアル化エンジンを既定で使用して、データのシリアル化と逆シリアル化 \(データと XML の間の変換\) を行います。 すべての [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] プリミティブ型 \(整数や文字列など\) およびプリミティブ型として扱われる特定の型 \(<xref:System.DateTime> や <xref:System.Xml.XmlElement> など\) は、準備なしでシリアル化できるため、既定のデータ コントラクトを持つと見なされます。 多くの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型もまた、既存のデータ コントラクトを持ちます。 シリアル化できるすべての型の一覧については、「[データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)」を参照してください。  
+  
+ 新しい複合型を作成したら、シリアル化できるように、データ コントラクトを定義する必要があります。 既定では、<xref:System.Runtime.Serialization.DataContractSerializer> はデータ コントラクトを推測し、公開されている型をすべてシリアル化します。 その型の読み書き可能なパブリック プロパティおよびパブリック フィールドは、すべてシリアル化されます。<xref:System.Runtime.Serialization.IgnoreDataMemberAttribute> を使用することにより、メンバーがシリアル化されないようにすることができます。 また、<xref:System.Runtime.Serialization.DataContractAttribute> 属性および <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を使用して、データ コントラクトを明示的に作成することもできます。 これを行うには、通常、その型に <xref:System.Runtime.Serialization.DataContractAttribute> 属性を適用します。 この属性は、クラス、構造体、および列挙体に適用できます。 次に、データ コントラクト型の各メンバーに <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用して、それが*データ メンバー*であること、つまり、シリアル化する必要があることを示す必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)。  
+  
+### 例  
+ <xref:System.ServiceModel.ServiceContractAttribute> 属性と <xref:System.ServiceModel.OperationContractAttribute> 属性が明示的に適用されたサービス コントラクト \(インターフェイス\) の例を次に示します。 この例は、プリミティブ型はデータ コントラクトを必要としないのに対し、複合型は必要とすることを示しています。  
+  
+ [!code-csharp[C_DataContract#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#1)]
+ [!code-vb[C_DataContract#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#1)]  
+  
+ 次の例では、`MyTypes.PurchaseOrder` 型のデータ コントラクトが作成され、<xref:System.Runtime.Serialization.DataContractAttribute> と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性がクラスとそのメンバーに適用されるかを示します。  
+  
+ [!code-csharp[C_DataContract#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#2)]
+ [!code-vb[C_DataContract#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#2)]  
+  
+### ノート  
+ 以下に、データ コントラクトを作成する際に考慮する必要がある項目を示します。  
+  
+-   <xref:System.Runtime.Serialization.IgnoreDataMemberAttribute> 属性は、マークされていない型で使用した場合にのみ受け入れられます。 これには、<xref:System.Runtime.Serialization.DataContractAttribute>、<xref:System.SerializableAttribute>、<xref:System.Runtime.Serialization.CollectionDataContractAttribute>、<xref:System.Runtime.Serialization.EnumMemberAttribute> のいずれかの属性でマークされていない型、または他の方法 \(<xref:System.Xml.Serialization.IXmlSerializable> など\) でシリアル化可能としてマークされた型が含まれます。  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute> 属性は、フィールドおよびプロパティに適用できます。  
+  
+-   メンバーのアクセシビリティ レベル \(内部、プライベート、保護、またはパブリック\) は、データ コントラクトに影響しません。  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute> 属性が静的メンバーに適用されている場合は無視されます。  
+  
+-   シリアル化中には、プロパティのデータ メンバーがシリアル化対象のプロパティの値を取得できるように、プロパティ取得コードが呼び出されます。  
+  
+-   逆シリアル化中には、まず初期化されていないオブジェクトが、その型のコンストラクターを呼び出さずに作成されます。 次に、すべてのデータ メンバーが逆シリアル化されます。  
+  
+-   逆シリアル化中には、プロパティのデータ メンバーが、プロパティを逆シリアル化されている値に設定できるように、プロパティ設定コードが呼び出されます。  
+  
+-   データ コントラクトが有効であるためには、すべてのデータ メンバーをシリアル化できる必要があります。 シリアル化できるすべての型の一覧については、「[データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)」を参照してください。  
+  
+     ジェネリック型は、非ジェネリック型とまったく同じように処理されます。 ジェネリック パラメーターに対する特別な要件はありません。 たとえば、次の型について考えます。  
+  
+ [!code-csharp[C_DataContract#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#3)]
+ [!code-vb[C_DataContract#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#3)]  
+  
+ この型は、ジェネリック型パラメーター \(`T`\) に使用される型をシリアル化できるかどうかに関係なくシリアル化できます。 すべてのデータ メンバーをシリアル化できる必要があるため、次の型をシリアル化できるのは、ジェネリック型パラメーターもシリアル化できる場合だけです。次のコード例を参照してください。  
+  
+ [!code-csharp[C_DataContract#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#4)]
+ [!code-vb[C_DataContract#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#4)]  
+  
+ データ コントラクトを定義する WCF サービスのコード サンプル全体については、「[基本的なデータ コントラクト](../../../../docs/framework/wcf/samples/basic-data-contract.md)」のサンプルを参照してください。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ [シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)   
+ [データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)   
+ [データ コントラクトの等価性](../../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [データ メンバーの順序](../../../../docs/framework/wcf/feature-details/data-member-order.md)   
+ [既知のデータ コントラクト型](../../../../docs/framework/wcf/feature-details/data-contract-known-types.md)   
+ [上位互換性のあるデータ コントラクト](../../../../docs/framework/wcf/feature-details/forward-compatible-data-contracts.md)   
+ [データ コントラクトのバージョン管理](../../../../docs/framework/wcf/feature-details/data-contract-versioning.md)   
+ [バージョン トレラントなシリアル化コールバック](../../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)   
+ [データ メンバーの既定値](../../../../docs/framework/wcf/feature-details/data-member-default-values.md)   
+ [データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)   
+ [方法 : クラスまたは構造体に基本的なデータ コントラクトを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-data-contract-for-a-class-or-structure.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md b/docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md
new file mode 100644
index 00000000000..8b64df24a72
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-dead-letter-queues-to-handle-message-transfer-failures.md
@@ -0,0 +1,83 @@
+---
+title: "配信不能キューを使用したメッセージ転送エラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e891c6a-d960-45ea-904f-1a00e202d61a
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 配信不能キューを使用したメッセージ転送エラー処理
+キューに置かれたメッセージは、配信に失敗する可能性があります。 配信に失敗したメッセージは、配信不能キューに記録されます。 配信の失敗は、ネットワーク エラー、キューが削除されている、キューがいっぱいになっている、認証エラー、配信が時間どおりに行われなかったなど、さまざまな理由で生じる可能性があります。  
+  
+ キューに置かれたメッセージは、受信側のアプリケーションでタイムリーに読み取られないと、長時間キューに残ることがあります。 時間依存のメッセージでは、このような動作が適切でない場合があります。 時間依存のメッセージでは、メッセージをキューに格納しておくことができる期間を示す TTL (Time to Live) プロパティが、キューに置かれたバインディングに設定されおり、この期間を超えると、メッセージの有効期限が切れます。 期限切れのメッセージは、配信不能キューと呼ばれる特別なキューに送信されます。 また、キューのクォータの超過、認証エラーなどの理由で、メッセージが配信不能キューに置かれる場合もあります。  
+  
+ 一般に、アプリケーションには、配信不能キューのメッセージとエラーの理由を読み取るための補正ロジックが記述されています。 補正ロジックはエラーの原因に依存します。 たとえば、認証エラーの場合は、メッセージに添付された証明書を修正し、メッセージを再送信できます。 また、ターゲット キューのクォータに達したために配信が失敗した場合は、クォータの問題が解決されていることを期待して配信を再試行できます。  
+  
+ ほとんどのキュー システムには、そのシステムから配信できなかったすべてのメッセージを格納するための、システム全体の配信不能キューがあります。 メッセージ キュー (MSMQ) には、システム全体の配信不能キューが&2; 種類用意されています。1 つはトランザクション キューへの配信に失敗したメッセージを格納するトランザクション システム全体の配信不能キューで、もう&1; つは非トランザクション キューへの配信に失敗したメッセージを格納する非トランザクション システム全体の配信不能キューです。 2 つのクライアントが&2; つの異なるサービスにメッセージを送信しているために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の異なるキューで、送信に同じ MSMQ サービスを共有している場合は、システム配信不能キューでメッセージが混在する可能性があります。 これは、必ずしも最適であるとは言えません。 場合によっては (たとえば、セキュリティ上の理由で)、一方のクライアントが、もう一方のクライアントのメッセージを配信不能キューから読み取ることができないようにする必要があるからです。 また、共有された配信不能キューでは、クライアントがキューを参照して、送信したメッセージを検索する必要もありますが、配信不能キューに置かれているメッセージの数によっては、これは極めて大きな負荷になる可能性があります。 したがって、 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] `NetMsmqBinding`、`MsmqIntegrationBinding,`および MSMQ に[!INCLUDE[wv](../../../../includes/wv-md.md)](アプリケーション固有の配信不能キューとも呼ばれます)、カスタム配信不能キューが用意されています。  
+  
+ カスタム配信不能キューでは、同じ MSMQ サービスを共有してメッセージを送信するクライアントをそれぞれ分離できます。  
+  
+ [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] の場合、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] と [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、キューに置かれたすべてのクライアント アプリケーションに対して、システム全体で&1; つの配信不能キューが提供されます。 一方、[!INCLUDE[wv](../../../../includes/wv-md.md)] では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] により、キューに置かれたクライアント アプリケーションごとに配信不能キューが提供されます。  
+  
+## <a name="specifying-use-of-the-dead-letter-queue"></a>配信不能キューの使用の指定  
+ 配信不能キューは、送信元アプリケーションのキュー マネージャーに存在します。 ここには、有効期限が切れたメッセージと転送または配信に失敗したメッセージが格納されます。  
+  
+ バインディングには、次の配信不能キュー プロパティがあります。  
+  
+-   <xref:System.ServiceModel.MsmqBindingBase.DeadLetterQueue%2A>  
+  
+-   <xref:System.ServiceModel.MsmqBindingBase.CustomDeadLetterQueue%2A>  
+  
+## <a name="reading-messages-from-the-dead-letter-queue"></a>配信不能キューからのメッセージの読み取り  
+ 配信不能キューからメッセージを読み取るアプリケーションは、アプリケーション キューからメッセージを読み取る [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとよく似ていますが、次のようなわずかな違いがあります。  
+  
+-   トランザクション システムの配信不能キューからメッセージを読み取るには、URI (Uniform Resource Identifier) を net.msmq://localhost/system$;DeadXact という形式にする必要があります。  
+  
+-   非トランザクション システムの配信不能キューからメッセージを読み取る場合、URI は、net.msmq://localhost/system$;DeadLetter という形式にする必要があります。  
+  
+-   カスタム配信不能キューからメッセージの読み取り、URI は、フォーム: net.msmq://localhost/private/のする必要があります*カスタム「名*> 場所*カスタム「名*カスタム配信不能キューの名前を指定します。  
+  
+ [!INCLUDE[crabout](../../../../includes/crabout-md.md)]キューのアドレスを参照してください方法[サービスのエンドポイントとキューのアドレス指定](../../../../docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md)します。  
+  
+ 受信側の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] スタックは、サービスがリッスンしているアドレスとメッセージのアドレスを照合します。 アドレスが一致する場合、メッセージはディスパッチされますが、一致しない場合はディスパッチされません。 これにより、配信不能キューから読み取るときに問題が生じる可能性があります。一般に、配信不能キュー内のメッセージは該当サービスにアドレス指定され、配信不能キュー サービスにアドレス指定されないからです。 そのため、配信不能キューから読み取るサービスは、`ServiceBehavior` アドレス フィルターをインストールし、受信者とは無関係にキュー内のすべてのメッセージを一致させるようスタックに指示する必要があります。 具体的には、追加する必要があります、`ServiceBehavior`で、 <xref:System.ServiceModel.AddressFilterMode>配信不能キューからメッセージを読み取るサービスへのパラメーターです。  
+  
+## <a name="poison-message-handling-from-the-dead-letter-queue"></a>配信不能キューの有害メッセージの処理  
+ 配信不能キューでは、条件付きで有害メッセージを処理できます。 システム キューからサブキューを作成できないため、システム配信不能キューから読み取るときは、`ReceiveErrorHandling` を `Move` に設定できません。 カスタム配信不能キューから読み取る場合は、サブキューを使用できるので、`Move` が有害メッセージに対する有効な処置であることに注意してください。  
+  
+ `ReceiveErrorHandling` を `Reject` に設定しているときにカスタム配信不能キューから読み取った場合、有害メッセージはシステム配信不能キューに置かれます。 システム配信不能キューから読み取ると、有害メッセージは破棄 (削除) されます。 MSMQ のシステム配信不能キューから拒否すると、メッセージは破棄 (削除) されます。  
+  
+## <a name="example"></a>例  
+ 次の例は、配信不能キューを作成する方法と、配信不能キューを使用して期限切れのメッセージを処理する方法を示しています。 この例は例では、に基づいて[する方法: WCF エンドポイントでのキューに置かれたメッセージの交換](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)します。 この例では、アプリケーションごとの配信不能キューを使用する発注書処理サービスにクライアント コードを書き込む方法を示します。 また、配信不能キューのメッセージを処理する方法も示します。  
+  
+ 以下は、アプリケーションごとの配信不能キューを指定するクライアントのコードです。  
+  
+ [!code-csharp[S_DeadLetter#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_deadletter/cs/client.cs#1)]
+ [!code-vb[S_DeadLetter#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_deadletter/vb/client.vb#1)]  
+  
+ 以下は、クライアント構成ファイルのコードです。  
+  
+  
+  
+ 以下は、配信不能キューのメッセージを処理するサービスのコードです。  
+  
+ [!code-csharp[S_DeadLetter#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/s_deadletter/cs/dlservice.cs#3)]
+ [!code-vb[S_DeadLetter#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_deadletter/vb/dlservice.vb#3)]  
+  
+ 以下は、配信不能キュー サービス構成ファイルのコードです。  
+  
+  
+  
+## <a name="see-also"></a>関連項目  
+ [キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)   
+ [方法: キューの WCF エンドポイントとメッセージを交換](../../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)   
+ [有害メッセージの処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md b/docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md
new file mode 100644
index 00000000000..8fae62604e6
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-impersonation-with-transport-security.md
@@ -0,0 +1,68 @@
+---
+title: "トランスポート セキュリティでの偽装の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 426df8cb-6337-4262-b2c0-b96c2edf21a9
+caps.latest.revision: 12
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 12
+---
+# トランスポート セキュリティでの偽装の使用
+*偽装*とは、サーバー アプリケーションがクライアントの ID を獲得する機能です。リソースへのアクセスを検証するときに、サービスでは偽装が広く使用されます。サーバー アプリケーションはサービス アカウントを使用して実行されますが、クライアントの接続を受け入れたサーバーは、クライアントの資格情報を使用してアクセス チェックが実行できるようにクライアントを偽装します。トランスポート セキュリティは、資格情報を渡すこと、および渡された資格情報を使用して通信をセキュリティで保護することの 2 つの機構から成ります。このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランスポート セキュリティと共に偽装機能を使用する方法について説明します。メッセージ セキュリティを使用した偽装[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+## 5 つの偽装レベル  
+ トランスポート セキュリティでは、次の表で説明するように 5 つの偽装レベルを使用します。  
+  
+|偽装レベル|説明|  
+|-----------|--------|  
+|None|サーバー アプリケーションは、クライアントの偽装を試みません。|  
+|Anonymous|サーバー アプリケーションはクライアントの資格情報に対してアクセス チェックを実行できますが、クライアントの ID に関する情報は一切受け取りません。この偽装レベルは、名前付きパイプなど、コンピューター上での通信にのみ意味があります。リモート接続で `Anonymous` レベルを使用すると、Identify レベルの偽装に昇格されます。|  
+|Identify|サーバー アプリケーションは、クライアントの ID を認識し、クライアントの資格情報に対するアクセスの検証を実行できますが、クライアントを偽装することはできません。トークン プロバイダーによって別の偽装レベルが提供されない限り、Identify レベルは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の SSPI 資格情報で使用される既定の偽装レベルになります。|  
+|Impersonate|サーバー アプリケーションは、アクセス チェックを実行できるだけでなく、クライアントとしてサーバー コンピューターのリソースにアクセスできます。偽装されたトークンにはネットワーク資格情報が含まれないため、サーバー アプリケーションはクライアントの ID を使用してリモート コンピューター上のリソースにアクセスできません。|  
+|Delegate|`Impersonate` と同じ機能に加えて、Delegate レベルの偽装では、サーバー アプリケーションがクライアントの ID を使用してリモート コンピューターのリソースにアクセスし、この ID を他のアプリケーションに渡すことができます。<br /><br /> **重要** これらの追加の機能を使用するには、ドメイン コントローラー上でそのサーバーのドメイン アカウントが委任先として信頼できるものとしてマークされている必要があります。このレベルの偽装は、機密としてマークされているクライアント ドメイン アカウントでは使用できません。|  
+  
+ トランスポート セキュリティで最も多く使用されるレベルは、`Identify` および `Impersonate` です。`None` および `Anonymous` レベルは、通常の使用にはお勧めしません。トランスポートの多くでは認証でこのレベルの使用をサポートしていません。`Delegate` レベルの機能は強力であり、使用に際しては注意が必要です。資格情報を委任するアクセス許可は、信頼できるサーバー アプリケーションにのみ与える必要があります。  
+  
+ `Impersonate` または `Delegate` レベルで偽装を使用するには、サーバー アプリケーションが `SeImpersonatePrivilege` 特権を持っている必要があります。管理者グループのアカウントまたはサービス SID \(Network Service、Local Service、または Local System\) を持つアカウントでアプリケーションを実行している場合は、アプリケーションに既定でこの特権があります。偽装ではクライアントとサーバーの相互認証は必要ありません。NTLM など、偽装をサポートする認証方式の中には、相互認証を使用できないものもあります。  
+  
+## 偽装でのトランスポート固有の問題  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] におけるトランスポートの選択は、選択できる偽装のレベルに影響を与えます。ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の標準 HTTP トランスポートと名前付きパイプ トランスポートに影響する問題について説明します。カスタム トランスポートには、偽装のサポートに関して独自の制限があります。  
+  
+### 名前付きパイプ トランスポート  
+ 次の項目が名前付きパイプ トランスポートと共に使用されます。  
+  
+-   名前付きパイプ トランスポートはローカル コンピューター上のみで使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の名前付きパイプでは、コンピューター間の接続が明示的に禁止されています。  
+  
+-   名前付きパイプは、`Impersonate` または `Delegate` 偽装レベルでは使用できません。これらの偽装レベルでは、名前付きパイプはコンピューター上で保障されません。  
+  
+ 名前付きパイプ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)」を参照してください。  
+  
+### HTTP トランスポート  
+ HTTP トランスポートを使用するバインディング \(<xref:System.ServiceModel.WSHttpBinding> と <xref:System.ServiceModel.BasicHttpBinding>\) では、「[HTTP 認証の理解](../../../../docs/framework/wcf/feature-details/understanding-http-authentication.md)」で説明するように、いくつかの認証方式がサポートされます。サポートされる偽装レベルは、認証方式によって異なります。次の項目が HTTP トランスポートと共に使用されます。  
+  
+-   `Anonymous` 認証方式は偽装を無視します。  
+  
+-   `Basic` 認証方式は `Delegate` レベルのみをサポートします。これより低い偽装レベルは、アップグレードされます。  
+  
+-   `Digest` 認証方式では、`Impersonate` レベルと `Delegate` レベルのみをサポートします。  
+  
+-   `NTLM` 認証方式は、直接またはネゴシエーション経由で選択可能で、ローカル コンピューターで `Delegate` レベルのみをサポートします。  
+  
+-   Kerberos 認証方式は、ネゴシエーション経由でのみ選択可能で、サポートされるすべての偽装レベルで使用できます。  
+  
+ HTTP トランスポート[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[トランスポートの選択](../../../../docs/framework/wcf/feature-details/choosing-a-transport.md)」を参照してください。  
+  
+## 参照  
+ [委任と偽装](../../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)   
+ [承認](../../../../docs/framework/wcf/feature-details/authorization-in-wcf.md)   
+ [方法 : サービスでクライアントに偽装する](../../../../docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md)   
+ [HTTP 認証の理解](../../../../docs/framework/wcf/feature-details/understanding-http-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-jsonp.md b/docs/framework/wcf/feature-details/using-jsonp.md
new file mode 100644
index 00000000000..131e1900dc3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-jsonp.md
@@ -0,0 +1,97 @@
+---
+title: "JSONP の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f386718c-b4ba-4931-a610-40c27a46672a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# JSONP の使用
+JSONP \(JSON with Padding\) は、Web ブラウザーでクロスサイト スクリプトの利用を可能にするためのメカニズムです。  JSONP は、現在読み込まれているドキュメントを取得したサイトとは異なるサイトから、スクリプトを読み込むための Web ブラウザーの機能を軸に設計されています。  このメカニズムは、次の例に示すように、JSON ペイロードにユーザー定義のコールバック関数の名前を埋め込むことで機能します。  
+  
+```  
+callback({"a" = \"b\" });  
+```  
+  
+ 上記の例では、JSON ペイロード `{"a" = \"b\"}` が、関数呼び出し `callback` にラップされています。  コールバック関数は、現在の Web ページで定義済みである必要があります。  JSONP 応答のコンテンツの種類は application\/javascript です。  
+  
+## JSONP の使用  
+ JSONP は自動的には有効化されません。  有効にするには、次の例のように、HTTP の標準エンドポイントのいずれか \(<xref:System.ServiceModel.Description.WebHttpEndpoint> または <xref:System.ServiceModel.Description.WebScriptEndpoint>\) で、`javascriptCallbackEnabled` 属性を `true` に設定する必要があります。  
+  
+```xml  
+<system.serviceModel>  
+    <standardEndpoints>  
+      <webHttpEndpoint>  
+        <standardEndpoint name="" javascriptCallbackEnabled="true"/>  
+      </webHttpEndpoint>  
+    </standardEndpoints>     
+  </system.serviceModel>  
+```  
+  
+ コールバック関数名は、次の URL に示すように、callback というクエリ変数で指定できます。  
+  
+```  
+http://baseaddress/Service/RestService?callback=functionName  
+```  
+  
+ このサービスを呼び出すと、次のような応答が送信されます。  
+  
+```jscript  
+functionName({"root":"Something});  
+```  
+  
+ コールバック関数名は、次の例のように、サービス クラスに <xref:System.ServiceModel.Web.JavascriptCallbackBehaviorAttribute> を適用して指定することもできます。  
+  
+```csharp  
+[ServiceContract]  
+[JavascriptCallbackBehavior(ParameterName = "$callback")]  
+public class Service1  
+{  
+    [OperationContract]  
+    [WebGet(ResponseFormat=WebMessageFormat.Json)]  
+    public string GetData()  
+    {              
+    }  
+}  
+```  
+  
+ 上に示したサービスでは、要求は次のような形式になります。  
+  
+```  
+http://baseaddress/Service/RestService?$callback=anotherFunction  
+```  
+  
+ このサービスを呼び出すと、次のような応答が返されます。  
+  
+```  
+anotherFunction ({"root":"Something});  
+```  
+  
+## HTTP 状態コード  
+ HTTP 状態コードが 200 以外の JSONP 応答には、次の例のように、HTTP 状態コードの数値表現が 2 つ目のパラメーターとして付加されます。  
+  
+```  
+anotherFunction ({"root":"Something}, 201);  
+```  
+  
+## 検証  
+ JSONP が有効な場合、以下の検証が行われます。  
+  
+-   `javascriptCallback` が有効になっており、要求にコールバック クエリ文字列のパラメーターが含まれ、応答形式が JSON に設定されている場合は、WCF インフラストラクチャから例外がスローされます。  
+  
+-   要求にコールバック クエリ文字列のパラメーターが含まれているが、操作が HTTP GET ではない場合は、コールバック パラメーターが無視されます。  
+  
+-   コールバック名が `null` または空の文字列の場合は、応答の形式が JSONP に設定されません。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-message-contracts.md b/docs/framework/wcf/feature-details/using-message-contracts.md
new file mode 100644
index 00000000000..cf90efe3505
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-message-contracts.md
@@ -0,0 +1,464 @@
+---
+title: "メッセージ コントラクトの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "メッセージ コントラクト [WCF]"
+ms.assetid: 1e19c64a-ae84-4c2f-9155-91c54a77c249
+caps.latest.revision: 46
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 46
+---
+# メッセージ コントラクトの使用
+一般に、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションを構築するときには、開発者はデータ構造とシリアル化の問題には細心の注意を払いますが、データを送信するメッセージの構造について懸念する必要はありません。このようなアプリケーションでは、パラメーターまたは戻り値用にデータ コントラクトを作成するのは簡単です \([!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md).\)  
+  
+ ただし、SOAP メッセージの構造を完全に制御することがメッセージの内容の制御と同様に重要となる場合があります。これが特に当てはまるのは、相互運用性が重要である場合、具体的にはメッセージまたはメッセージ部分のレベルでセキュリティの問題を制御する場合です。このような場合、必要とされる正確な SOAP メッセージの構造を指定できる、*メッセージ コントラクト*を作成できます。  
+  
+ ここでは、メッセージ コントラクトの各種属性を使用して、ユーザー操作に専用のメッセージ コントラクトを作成する方法について説明します。  
+  
+## 処理におけるメッセージ コントラクトの使用  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、*"リモート プロシージャ コール \(RPC: Remote Procedure Call\) スタイル"*、または *"メッセージング スタイル"* でモデル化された操作をサポートします。RPC スタイルの操作では、シリアル化可能な任意の型を使用できます。複数のパラメーター、`ref` パラメーターと `out` パラメーターなど、ローカル呼び出しで使用できる機能が用意されています。このスタイルでは、選択したシリアル化の形式によって基になるメッセージのデータ構造が制御されますが、操作をサポートするために、メッセージは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムによって作成されます。これにより、SOAP や SOAP メッセージに不慣れな開発者でも、サービス アプリケーションを迅速かつ容易に作成し、使用できます。  
+  
+ RPC スタイルでモデル化されたサービス操作のコード例を次に示します。  
+  
+```csharp  
+[OperationContract]  
+public BankingTransactionResponse PostBankingTransaction(BankingTransaction bt);  
+```  
+  
+ 通常は、データ コントラクトだけでメッセージのスキーマを定義することができます。たとえば、前述の例では、`BankingTransaction` と `BankingTransactionResponse` にデータ コントラクトがあれば、ほとんどのアプリケーションで基になる SOAP メッセージの内容を定義できます。データ コントラクト[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)」を参照してください。  
+  
+ ただし、場合によっては、SOAP メッセージの構造がネットワーク経由でどのように転送されるかを厳密に制御する必要があります。最も一般的なシナリオは、カスタム SOAP ヘッダーの挿入です。もう 1 つの一般的なシナリオは、メッセージのヘッダーと本文のセキュリティ プロパティを定義すること、つまり、これらの要素にデジタル署名し、要素を暗号化するかどうかを決定することです。最後に、一部のサードパーティの SOAP スタックでは、メッセージが特定の形式である必要があります。この制御は、メッセージング スタイルの操作によって行うことができます。  
+  
+ メッセージング スタイルの操作には、最大で 1 つのパラメーターと 1 つの戻り値があります。これらはいずれもメッセージ型です。つまり、パラメーターと戻り値は、指定された SOAP メッセージ構造に直接シリアル化されます。これは、<xref:System.ServiceModel.MessageContractAttribute> 型、または <xref:System.ServiceModel.Channels.Message> 型としてマークされた任意の型を使用できます。次のコード例は前の RPC スタイルと同様の操作を示していますが、この例ではメッセージング スタイルを使用しています。  
+  
+ たとえば、`BankingTransaction` と `BankingTransactionResponse` がいずれもメッセージ コントラクトである型である場合、次の操作のコードは有効です。  
+  
+```csharp  
+[OperationContract]  
+BankingTransactionResponse Process(BankingTransaction bt);  
+[OperationContract]  
+void Store(BankingTransaction bt);  
+[OperationContract]  
+BankingTransactionResponse GetResponse();  
+```  
+  
+ ただし、次のコードは無効です。  
+  
+```csharp  
+[OperationContract]  
+bool Validate(BankingTransaction bt);  
+// Invalid, the return type is not a message contract.  
+[OperationContract]  
+void Reconcile(BankingTransaction bt1, BankingTransaction bt2);  
+// Invalid, there is more than one parameter.  
+```  
+  
+ メッセージ コントラクト型を含み、有効なパターンのいずれにも従わないすべての操作に対して例外がスローされます。もちろん、メッセージ コントラクト型を含まない処理にはこのような制限はありません。  
+  
+ 1 つの型にメッセージ コントラクトとデータ コントラクトの両方が含まれる場合は、処理でその型が使用されたときにはメッセージ コントラクトだけが考慮されます。  
+  
+## メッセージ コントラクトの定義  
+ 型のメッセージ コントラクトを定義する \(つまり、型と SOAP エンベロープ間のマッピングを定義する\) には、<xref:System.ServiceModel.MessageContractAttribute> を型に適用します。次に、SOAP ヘッダーにする型のメンバーに <xref:System.ServiceModel.MessageHeaderAttribute> を適用し、メッセージの SOAP 本文の一部にするメンバーに <xref:System.ServiceModel.MessageBodyMemberAttribute> を適用します。  
+  
+ メッセージ コントラクトの使用例を次のコードに示します。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public Operation operation;  
+  [MessageHeader] public DateTime transactionDate;  
+  [MessageBodyMember] private Account sourceAccount;  
+  [MessageBodyMember] private Account targetAccount;  
+  [MessageBodyMember] public int amount;  
+}  
+```  
+  
+ この型を操作パラメーターとして使用すると、次の SOAP エンベロープが生成されます。  
+  
+```xml  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+  <s:Header>  
+    <h:operation xmlns:h="http://tempuri.org/" xmlns="http://tempuri.org/">Deposit</h:operation>  
+    <h:transactionDate xmlns:h="http://tempuri.org/" xmlns="http://tempuri.org/">2012-02-16T16:10:00</h:transactionDate>  
+  </s:Header>  
+  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
+    <BankingTransaction xmlns="http://tempuri.org/">  
+      <amount>0</amount>  
+      <sourceAccount xsi:nil="true"/>  
+      <targetAccount xsi:nil="true"/>  
+    </BankingTransaction>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+ `operation` と `transactionDate` が SOAP ヘッダーとして表示され、SOAP 本体は `sourceAccount`、`targetAccount`、および `amount` を含むラッパー要素 `BankingTransaction` から成ることに注意してください。  
+  
+ パブリック、プライベート、保護、または内部のいずれであるかに関係なく、<xref:System.ServiceModel.MessageHeaderAttribute> と <xref:System.ServiceModel.MessageBodyMemberAttribute> は、すべてのフィールド、プロパティ、およびイベントに適用できます。  
+  
+ <xref:System.ServiceModel.MessageContractAttribute> を使用すると、SOAP メッセージの本文のラッパー要素の名前を制御する WrapperName および WrapperNamespace 属性を指定できます。既定では、メッセージ コントラクト型の名前はラッパー用に使用され、メッセージ コントラクトが定義されている名前空間 \(`http://tempuri.org/`\) は既定の名前空間として使用されます。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性は、メッセージ コントラクトでは無視されます。<xref:System.Runtime.Serialization.KnownTypeAttribute> が必要な場合は、対象のメッセージ コントラクトを使用している処理でそれを設定します。  
+  
+## ヘッダー名、本文名、および名前空間の制御  
+ メッセージ コントラクトの SOAP 表現では、各ヘッダーと本文の各部分が名前と名前空間を持つ XML 要素にマップされます。  
+  
+ 既定では、名前空間はメッセージが参加しているサービス コントラクトの名前空間と同じであり、その名前は <xref:System.ServiceModel.MessageHeaderAttribute> 属性または <xref:System.ServiceModel.MessageBodyMemberAttribute> 属性が割り当てられたメンバー名によって決定されます。  
+  
+ \(<xref:System.ServiceModel.MessageHeaderAttribute> 属性と <xref:System.ServiceModel.MessageBodyMemberAttribute> 属性の親クラスの\) <xref:System.ServiceModel.MessageContractMemberAttribute.Name%2A?displayProperty=fullName> および <xref:System.ServiceModel.MessageContractMemberAttribute.Namespace%2A?displayProperty=fullName> を操作することによって、これらの既定値を変更できます。  
+  
+ 次のコード例のクラスについて考えてみます。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public Operation operation;  
+  [MessageHeader(Namespace="http://schemas.contoso.com/auditing/2005")] public bool IsAudited;  
+  [MessageBodyMember(Name="transactionData")] public BankingTransactionData theData;  
+}  
+  
+```  
+  
+ この例では、`IsAudited` ヘッダーがコードで指定された名前空間に存在し、`theData` メンバーを表す本文が `transactionData` という名前の XML 要素によって表現されます。次に、このメッセージ コントラクト用に生成された XML を示します。  
+  
+```  
+<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">  
+  <s:Header>  
+    <h:IsAudited xmlns:h="http://schemas.contoso.com/auditing/2005" xmlns="http://schemas.contoso.com/auditing/2005">false</h:IsAudited>  
+    <h:operation xmlns:h="http://tempuri.org/" xmlns="http://tempuri.org/">Deposit</h:operation>  
+  </s:Header>  
+  <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
+    <AuditedBankingTransaction xmlns="http://tempuri.org/">  
+      <transactionData/>  
+    </AuditedBankingTransaction>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+## SOAP 本文の各部分のラップの制御  
+ SOAP 本文は、既定で、ラップされた要素内にシリアル化されます。たとえば、`HelloGreetingMessage` メッセージのメッセージ コントラクトに含まれる <xref:System.ServiceModel.MessageContractAttribute> 型の名前から生成される `HelloGreetingMessage` ラッパー要素を次のコードに示します。  
+  
+ [!code-csharp[MessageHeaderAttribute#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/messageheaderattribute/cs/services.cs#3)]
+ [!code-vb[MessageHeaderAttribute#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/messageheaderattribute/vb/services.vb#3)]  
+  
+ ラッパー要素を抑制するには、<xref:System.ServiceModel.MessageContractAttribute.IsWrapped%2A> プロパティを `false` に設定します。ラッパー要素の名前と名前空間を制御するには、<xref:System.ServiceModel.MessageContractAttribute.WrapperName%2A> プロパティと <xref:System.ServiceModel.MessageContractAttribute.WrapperNamespace%2A> プロパティを使用します。  
+  
+> [!NOTE]
+>  ラップされていないメッセージにメッセージ本文の複数の部分を含めることは、WS\-I Basic Profile 1.1 規格に反するため、新しいメッセージ コントラクトを設計する場合はお勧めできません。ただし、特定の相互運用シナリオでは、複数のラップされていないメッセージ本文が必要な場合もあります。1 つのメッセージ本文で複数のデータを転送する場合は、既定の \(ラップされた\) モードを使用することをお勧めします。ラップされていないメッセージで複数のメッセージ ヘッダーを使用しても、何の問題もありません。  
+  
+## メッセージ コントラクト内部でのカスタム型の使用  
+ メッセージが使用されるサービス コントラクト用に選択されたシリアル化エンジンを使用して、個々のメッセージ ヘッダーとメッセージ本文がシリアル化されます \(XML に変換されます\)。既定のシリアル化エンジンである `XmlFormatter` は、データ コントラクトを持つ任意の型を \(<xref:System.Runtime.Serialization.DataContractAttribute?displayProperty=fullName> を持つことによって\) 明示的に処理することも、\(プリミティブ型にしたり、<xref:System.SerializableAttribute?displayProperty=fullName> を持ったりすることなどによって\) 暗黙的に処理することもできます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md).  
+  
+ 前の例では、`Operation` 型と `BankingTransactionData` 型は、データ コントラクトを持つ必要があります。また、<xref:System.DateTime> がプリミティブである \(したがって、暗黙のデータ コントラクトを持つ\) ため、`transactionDate` はシリアル化可能です。  
+  
+ ただし、別のシリアル化エンジンである `XmlSerializer` に切り替えることができます。このような切り替えを行う場合は、メッセージ ヘッダーと本文の各部分に使用されているすべての型が `XmlSerializer` を使用してシリアル化可能であることを確認する必要があります。  
+  
+## メッセージ コントラクト内部での配列の使用  
+ メッセージ コントラクトでは、反復要素の配列を 2 とおりの方法で使用できます。  
+  
+ 最初の方法は、配列上で <xref:System.ServiceModel.MessageHeaderAttribute> または <xref:System.ServiceModel.MessageBodyMemberAttribute> を直接使用する方法です。この場合は、配列全体が複数の子要素を含む 1 つの要素 \(つまり、1 つのヘッダーまたは 1 つの本文\) としてシリアル化されます。次の例のクラスについて考えてみます。  
+  
+```csharp  
+[MessageContract]  
+public class BankingDepositLog  
+{  
+  [MessageHeader] public int numRecords;  
+  [MessageHeader] public DepositRecord[] records;  
+  [MessageHeader] public int branchID;  
+}  
+```  
+  
+ これは、次のような SOAP ヘッダーになります。  
+  
+```  
+<BankingDepositLog>  
+<numRecords>3</numRecords>  
+<records>  
+  <DepositRecord>Record1</DepositRecord>  
+  <DepositRecord>Record2</DepositRecord>  
+  <DepositRecord>Record3</DepositRecord>  
+</records>  
+<branchID>20643</branchID>  
+</BankingDepositLog>  
+```  
+  
+ もう 1 つの方法は、<xref:System.ServiceModel.MessageHeaderArrayAttribute> を使用する方法です。この場合、各配列要素が個別にシリアル化されるため、次のように配列要素ごとに 1 つのヘッダーが付加されます。  
+  
+```  
+  
+<numRecords>3</numRecords>  
+<records>Record1</records>  
+<records>Record2</records>  
+<records>Record3</records>  
+<branchID>20643</branchID>  
+```  
+  
+ 配列エントリの既定の名前は、<xref:System.ServiceModel.MessageHeaderArrayAttribute> 属性が適用されたメンバーの名前になります。  
+  
+ <xref:System.ServiceModel.MessageHeaderArrayAttribute> 属性は、<xref:System.ServiceModel.MessageHeaderAttribute> から継承されます。この属性は、非配列属性と同じ機能セットを持ちます。たとえば、単一のヘッダーに設定するのと同様に、ヘッダーの配列に順序、名前、および名前空間を設定できます。配列で `Order` プロパティを使用すると、その配列全体に適用されます。  
+  
+ <xref:System.ServiceModel.MessageHeaderArrayAttribute> を適用できるのは配列だけであり、コレクションには適用できません。  
+  
+## メッセージ コントラクトでのバイト配列の使用  
+ バイト配列を非配列属性 \(<xref:System.ServiceModel.MessageBodyMemberAttribute> と <xref:System.ServiceModel.MessageHeaderAttribute>\) で使用した場合は、配列としてではなく、生成された XML 内で Base64 でエンコードされたデータとして表現される特殊なプリミティブ型として扱われます。  
+  
+ <xref:System.ServiceModel.MessageHeaderArrayAttribute> 配列属性でバイト配列を使用した場合、結果は使用しているシリアライザーによって異なります。既定のシリアライザーでは、配列が個々のバイト エントリとして表されます。ただし、\(サービス コントラクトの <xref:System.ServiceModel.XmlSerializerFormatAttribute> を使用して\) `XmlSerializer` を選択した場合は、配列属性と非配列属性のどちらを使用しているかに関係なく、バイト配列は Base64 データとして扱われます。  
+  
+## メッセージの一部の署名と暗号化  
+ メッセージ コントラクトでは、メッセージのヘッダーまたは本文にデジタル署名し、暗号化するかどうかを示すことができます。  
+  
+ この操作は、<xref:System.ServiceModel.MessageHeaderAttribute> 属性と <xref:System.ServiceModel.MessageBodyMemberAttribute> 属性の <xref:System.ServiceModel.MessageContractMemberAttribute.ProtectionLevel%2A?displayProperty=fullName> プロパティを設定することによって実行されます。このプロパティは、<xref:System.Net.Security.ProtectionLevel?displayProperty=fullName> 型の列挙体であり、<xref:System.Net.Security.ProtectionLevel> \(暗号化と署名を行わない\)、<xref:System.Net.Security.ProtectionLevel> \(デジタル署名だけを行う\)、または <xref:System.Net.Security.ProtectionLevel> \(暗号化とデジタル署名の両方を行う\) に設定できます。既定値は <xref:System.Net.Security.ProtectionLevel> です。  
+  
+ これらのセキュリティ機能を使用するには、バインディングと動作を適切に構成する必要があります。適切な構成を行わずにこれらのセキュリティ機能を使用した場合 \(資格情報を指定せずにメッセージに署名しようとした場合など\)、検証時に例外がスローされます。  
+  
+ メッセージ ヘッダーの場合、ヘッダーごとに保護レベルが設定されます。  
+  
+ メッセージ本文の各部分の場合は、保護レベルを "最小保護レベル" と見なすことができます。本文には、その数に関係なく 1 つの保護レベルしか設定できません。本文の保護レベルは、本文の全部分の中の最も高い <xref:System.ServiceModel.MessageContractMemberAttribute.ProtectionLevel%2A> プロパティの設定によって決定されます。ただし、本文の各部分の保護レベルを必要最小限の保護レベルに設定することをお勧めします。  
+  
+ 次のコード例のクラスについて考えてみます。  
+  
+```csharp  
+[MessageContract]  
+public class PatientRecord  
+{  
+   [MessageHeader(ProtectionLevel=None)] public int recordID;  
+   [MessageHeader(ProtectionLevel=Sign)] public string patientName;  
+   [MessageHeader(ProtectionLevel=EncryptAndSign)] public string SSN;  
+   [MessageBodyMember(ProtectionLevel=None)] public string comments;  
+   [MessageBodyMember(ProtectionLevel=Sign)] public string diagnosis;  
+   [MessageBodyMember(ProtectionLevel=EncryptAndSign)] public string medicalHistory;  
+}  
+```  
+  
+ この例では、`recordID` ヘッダーは保護されず、`patientName` は署名され、`SSN` は暗号化および署名されます。本文の comments と diagnosis の各部分では低い保護レベルを指定していても、本文の少なくとも 1 つの部分 \(`medicalHistory`\) に <xref:System.Net.Security.ProtectionLevel> が適用されているため、メッセージ本文全体が暗号化され、署名されます。  
+  
+## SOAP アクション  
+ SOAP 標準と関連する Web サービス標準では、送信されるすべての SOAP メッセージに設定可能な `Action` という名前のプロパティが定義されます。このプロパティの値は、操作の <xref:System.ServiceModel.OperationContractAttribute.Action%2A?displayProperty=fullName> プロパティと <xref:System.ServiceModel.OperationContractAttribute.ReplyAction%2A?displayProperty=fullName> プロパティによって制御されます。  
+  
+## SOAP ヘッダーの属性  
+ SOAP 標準では、ヘッダーに設定可能な次の属性が定義されます。  
+  
+-   `Actor/Role` \(SOAP 1.1 では `Actor`、SOAP 1.2 では `Role`\)  
+  
+-   `MustUnderstand`  
+  
+-   `Relay`  
+  
+ `Actor` 属性または `Role` 属性は、指定のヘッダーが対象とするノードの URI \(Uniform Resource Identifier\) を指定します。`MustUnderstand` 属性は、ヘッダー処理ノードがヘッダーを認識する必要があるかどうかを指定します。`Relay` 属性は、ダウンストリーム ノードにヘッダーを中継する必要があるかどうかを指定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、`MustUnderstand` 属性を除いて \(このトピックの後の方の「メッセージ コントラクトのバージョン管理」セクションで指定\)、受信メッセージに対してこれらの属性の処理を実行しません。ただし、後述するように、必要に応じてこれらの属性を読み書きすることができます。  
+  
+ 既定では、メッセージの送信時にこれらの属性は出力されません。これは、2 とおりの方法で変更できます。1 つ目の方法として、次のコード例に示すように、<xref:System.ServiceModel.MessageHeaderAttribute.Actor%2A?displayProperty=fullName>、<xref:System.ServiceModel.MessageHeaderAttribute.MustUnderstand%2A?displayProperty=fullName>、および <xref:System.ServiceModel.MessageHeaderAttribute.Relay%2A?displayProperty=fullName> の各プロパティを変更することによって、属性を必要な値に静的に設定できます \(`Role` プロパティが存在しないことに注意してください。SOAP 1.2 を使用している場合は、<xref:System.ServiceModel.MessageHeaderAttribute.Actor%2A> プロパティを設定すると `Role` 属性が出力されます\)。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader(Actor="http://auditingservice.contoso.com", MustUnderstand=true)] public bool IsAudited;  
+  [MessageHeader] public Operation operation;  
+  [MessageBodyMember] public BankingTransactionData theData;  
+}  
+```  
+  
+ これらの属性を制御する 2 番目の方法は、コードを通して動的に行う方法です。これを行うには、必要なヘッダーの型を <xref:System.ServiceModel.MessageHeader%601> 型にラップし \(この型と非ジェネリック バージョンを混同しないようにしてください\)、その型を <xref:System.ServiceModel.MessageHeaderAttribute> と共に使用します。これで、次のコード例に示すように、<xref:System.ServiceModel.MessageHeader%601> のプロパティを使用して SOAP 属性を設定できるようになります。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public MessageHeader<bool> IsAudited;  
+  [MessageHeader] public Operation operation;  
+  [MessageBodyMember] public BankingTransactionData theData;  
+}  
+// application code:  
+BankingTransaction bt = new BankingTransaction();  
+bt.IsAudited = new MessageHeader<bool>();  
+bt.IsAudited.Content = false; // Set IsAudited header value to "false"  
+bt.IsAudited.Actor="http://auditingservice.contoso.com";  
+bt.IsAudited.MustUnderstand=true;  
+```  
+  
+ 動的制御機構と静的制御機構の両方を使用する場合、静的な設定が既定で使用されますが、次のコードに示すように、後で動的機構を使用して静的な設定をオーバーライドできます。  
+  
+```  
+[C#]  
+[MessageHeader(MustUnderstand=true)] public MessageHeader<Person> documentApprover;  
+// later on in the code:  
+BankingTransaction bt = new BankingTransaction();  
+bt.documentApprover = new MessageHeader<Person>();  
+bt.documentApprover.MustUnderstand = false; // override the static default of 'true'  
+```  
+  
+ 次のコードに示すように、属性を動的に制御して繰り返すヘッダーを作成できます。  
+  
+```csharp  
+[MessageHeaderArray] public MessageHeader<Person> documentApprovers[];  
+```  
+  
+ 受信側で、<xref:System.ServiceModel.MessageHeader%601> クラスがこの型のヘッダーで使用されている場合にのみ、これらの SOAP 属性の読み取りを実行できます。受信メッセージの属性設定を明らかにするために、<xref:System.ServiceModel.MessageHeader%601> 型のヘッダーの `Actor`、`Relay`、または `MustUnderstand` の各プロパティを調べます。  
+  
+ メッセージを受信して返信するときに、これらの SOAP 属性設定は <xref:System.ServiceModel.MessageHeader%601> 型のヘッダーとして往復するだけです。  
+  
+## SOAP 本文の順序  
+ 状況によっては、本文の各部分の順序を制御する必要があります。本文要素の既定の順序はアルファベット順ですが、<xref:System.ServiceModel.MessageBodyMemberAttribute.Order%2A?displayProperty=fullName> プロパティで制御できます。このプロパティのセマンティクスは、継承シナリオにおける動作を除き、<xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A?displayProperty=fullName> プロパティのセマンティクスと同じです \(メッセージ コントラクトでは、派生型の本文メンバーの前に基本データ型の本文メンバーが並べ替えられることはありません\)。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][データ メンバーの順序](../../../../docs/framework/wcf/feature-details/data-member-order.md).  
+  
+ 次の例では、通常はアルファベット順で最初である `amount` が先頭にきますが、<xref:System.ServiceModel.MessageBodyMemberAttribute.Order%2A> プロパティによって 3 番目の位置に挿入されます。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public Operation operation;  
+  [MessageBodyMember(Order=1)] public Account sourceAccount;  
+  [MessageBodyMember(Order=2)] public Account targetAccount;  
+  [MessageBodyMember(Order=3)] public int amount;  
+}  
+```  
+  
+## メッセージ コントラクトのバージョン管理  
+ 場合によっては、メッセージ コントラクトを変更する必要があります。たとえば、新しいバージョンのアプリケーションによってメッセージに余分なヘッダーが追加された場合です。この場合、新しいバージョンから古いバージョンに送信するときは、システムは余分なヘッダーを処理し、逆方向に送信するときは不足しているヘッダーを処理する必要があります。  
+  
+ ヘッダーのバージョン管理には、次のルールが適用されます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は不足しているヘッダーを問題にしません。対応するメンバーは既定値で残されます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、予期しない余分なヘッダーも無視します。このルールの 1 つの例外は、入力 SOAP メッセージ内の余分なヘッダーの `MustUnderstand` 属性が `true` に設定されている場合です。この場合、認識する必要のあるヘッダーを処理できないため、例外がスローされます。  
+  
+ メッセージ本文にも同様のバージョン管理ルールがあります。メッセージ本文の不足している部分と追加された部分はいずれも無視されます。  
+  
+## 継承に関する留意点  
+ メッセージ コントラクト型は、基本データ型がメッセージ コントラクトを持っている限り、他の型から継承することができます。  
+  
+ 他のメッセージ コントラクト型から継承したメッセージ コントラクト型を使用して、メッセージを作成したり、メッセージにアクセスしたりする場合、次のルールが適用されます。  
+  
+-   継承階層内のすべてのメッセージ ヘッダーが収集され、そのメッセージの完全なヘッダー セットが形成されます。  
+  
+-   継承階層内のすべてのメッセージ本文が収集され、完全なメッセージ本文が形成されます。本文の各部分は、継承階層内での位置に関係なく、通常の順序ルール \(<xref:System.ServiceModel.MessageBodyMemberAttribute.Order%2A?displayProperty=fullName> プロパティ順、続いてアルファベット順\) に従って並べられます。メッセージ本文が継承ツリーの複数レベルに存在するメッセージ コントラクト継承の使用は、あまりお勧めできません。基本クラスと派生クラスでヘッダーまたは本文に同じ名前が定義されている場合は、base\-most クラスからのメンバーがそのヘッダーまたは本文の値を保存するために使用されます。  
+  
+ 次のコード例のクラスについて考えてみます。  
+  
+```csharp  
+[MessageContract]  
+public class PersonRecord  
+{  
+  [MessageHeader(Name="ID")] public int personID;  
+  [MessageBodyMember] public string patientName;  
+}  
+  
+[MessageContract]  
+public class PatientRecord : PersonRecord  
+{  
+  [MessageHeader(Name="ID")] public int patientID;  
+  [MessageBodyMember] public string diagnosis;  
+}  
+```  
+  
+ `PatientRecord` クラスは、`ID` という名前の 1 つのヘッダーを持つメッセージを記述します。このヘッダーは、base\-most メンバーが選択されたことによって、`personID` メンバーには対応しますが、`patientID` メンバーには対応しません。そのため、この場合は `patientID` フィールドは使用されません。メッセージ本文には、アルファベット順で、`diagnosis` 要素の次に `patientName` 要素が含まれます。この例は、基本メッセージ コントラクトと派生メッセージ コントラクトの両方にメッセージ本文が含まれ、あまりお勧めできないパターンを示していることに注意してください。  
+  
+## WSDL に関する留意点  
+ メッセージ コントラクトを使用するサービスから Web サービス記述言語 \(WSDL: Web Services Description Language\) コントラクトを生成するときには、メッセージ コントラクトのすべての機能が結果の WSDL に反映されるわけではないことに留意してください。以下の点を考慮します。  
+  
+-   WSDL では、ヘッダー配列の概念を表現することができません。<xref:System.ServiceModel.MessageHeaderArrayAttribute> を使用してヘッダー配列を含むメッセージを作成した場合、結果の WSDL は配列ではなく 1 つのヘッダーだけに反映されます。  
+  
+-   結果の WSDL ドキュメントに一部の保護レベル情報が反映されない場合があります。  
+  
+-   WSDL で生成されたメッセージ型が、メッセージ コントラクト型のクラスと同じ名前になります。  
+  
+-   複数の処理で同じメッセージ コントラクトを使用すると、WSDL ドキュメント内に複数のメッセージ型が生成されます。以降も使用できるように、"2"、"3" などの番号を付加することで名前を一意にします。WSDL をインポートし直すと、名前以外は同一の複数のメッセージ コントラクト型が作成されます。  
+  
+## SOAP エンコードに関する留意点  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、XML のレガシー SOAP エンコード スタイルを使用できますが、このスタイルを使用することはお勧めしません。\(サービス コントラクトに適用されている <xref:System.ServiceModel.XmlSerializerFormatAttribute?displayProperty=fullName> で、`Use` プロパティを `Encoded` に設定して\) このスタイルを使用する場合、次の追加の考慮事項が適用されます。  
+  
+-   メッセージ ヘッダーはサポートされません。つまり、<xref:System.ServiceModel.MessageHeaderAttribute> 属性と <xref:System.ServiceModel.MessageHeaderArrayAttribute> 配列属性は、SOAP エンコーディングと互換性がありません。  
+  
+-   メッセージ コントラクトがラップされていない場合、つまり、<xref:System.ServiceModel.MessageContractAttribute.IsWrapped%2A> プロパティが `false` に設定されている場合は、メッセージ コントラクトが持つことのできる本文の部分は 1 つに限られます。  
+  
+-   要求メッセージ コントラクトのラッパー要素の名前は、操作の名前と一致する必要があります。この場合、メッセージ コントラクトの `WrapperName` プロパティを使用します。  
+  
+-   応答メッセージ コントラクトのラッパー要素の名前は、操作の名前にサフィックスとして "Response" を付けたものと同じである必要があります。この場合、メッセージ コントラクトの <xref:System.ServiceModel.MessageContractAttribute.WrapperName%2A> プロパティを使用します。  
+  
+-   SOAP エンコードはオブジェクト参照を保存します。たとえば、次のコードについて考えてみます。  
+  
+    ```csharp  
+    [MessageContract(WrapperName="updateChangeRecord")]  
+    public class ChangeRecordRequest  
+    {  
+      [MessageBodyMember] Person changedBy;  
+      [MessageBodyMember] Person changedFrom;  
+      [MessageBodyMember] Person changedTo;  
+    }  
+  
+    [MessageContract(WrapperName="updateChangeRecordResponse")]  
+    public class ChangeRecordResponse  
+    {  
+      [MessageBodyMember] Person changedBy;  
+      [MessageBodyMember] Person changedFrom;  
+      [MessageBodyMember] Person changedTo;  
+    }  
+  
+    // application code:  
+    ChangeRecordRequest cr = new ChangeRecordRequest();  
+    Person p = new Person("John Doe");  
+    cr.changedBy=p;  
+    cr.changedFrom=p;  
+    cr.changedTo=p;  
+    ```  
+  
+ SOAP エンコーディングを使用してメッセージをシリアル化した後、`changedFrom` と `changedTo` には `p` のコピーは保存されませんが、代わりに、`changedBy` 要素内部のコピーがポイントされます。  
+  
+## パフォーマンスに関する考慮事項  
+ すべてのメッセージ ヘッダーとメッセージ本文が個別にシリアル化されます。したがって、ヘッダーおよび本文ごとに同じ名前空間が繰り返し宣言される可能性があります。特に、回線上のメッセージ サイズに関して、パフォーマンスを向上させるには、複数のヘッダーと本文を単一のヘッダーまたは本文に統合します。たとえば、次のコードの代わりに  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public Operation operation;  
+  [MessageBodyMember] public Account sourceAccount;  
+  [MessageBodyMember] public Account targetAccount;  
+  [MessageBodyMember] public int amount;  
+}  
+```  
+  
+ 次のコードを使用します。  
+  
+```csharp  
+[MessageContract]  
+public class BankingTransaction  
+{  
+  [MessageHeader] public Operation operation;  
+  [MessageBodyMember] public OperationDetails details;  
+}  
+  
+[DataContract]  
+public class OperationDetails  
+{  
+  [DataMember] public Account sourceAccount;  
+  [DataMember] public Account targetAccount;  
+  [DataMember] public int amount;  
+}  
+```  
+  
+### イベント ベースの非同期とメッセージ コントラクト  
+ イベント ベースの非同期モデルのデザイン ガイドラインには、複数の値を返す場合に、1 つの値を `Result` プロパティとして返し、残りの値を <xref:System.EventArgs> オブジェクトのプロパティとして返すことが記載されています。この 1 つの結果として、クライアントがイベント ベースの非同期コマンド オプションを使用してメタデータをインポートし、操作から複数の値が返される場合、既定の <xref:System.EventArgs> オブジェクトは 1 つの値を `Result` プロパティとして返し、残りの値は <xref:System.EventArgs> オブジェクトのプロパティになります。  
+  
+ メッセージ オブジェクトを `Result` プロパティとして受け取り、返された値をそのオブジェクトのプロパティとして取得する場合は、`/messageContract` コマンド オプションを使用します。これにより、<xref:System.EventArgs> オブジェクトの `Result` プロパティとして応答メッセージを返すシグネチャが生成されます。すべての内部戻り値は、応答メッセージ オブジェクトのプロパティになります。  
+  
+## 参照  
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [サービスの設計と実装](../../../../docs/framework/wcf/designing-and-implementing-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-metadata.md b/docs/framework/wcf/feature-details/using-metadata.md
new file mode 100644
index 00000000000..415690b7584
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-metadata.md
@@ -0,0 +1,33 @@
+---
+title: "メタデータを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05cf53a1-b92d-4d8e-a87e-79f6e51c4a8d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# メタデータを使用する
+サービス メタデータには、コンピューターが読み取ることのできる、サービスに関する説明が含まれます。サービス メタデータには、サービス エンドポイント、バインディング、コントラクト、操作、およびメッセージに関する説明が含まれます。サービス メタデータは、サービスを利用するクライアントの自動生成、サービスに関する説明の実装、クライアントに対するバインディングの動的な更新など、さまざまな目的で使用できます。  
+  
+## このセクションの内容  
+ [生成されたクライアント コードの理解](../../../../docs/framework/wcf/feature-details/understanding-generated-client-code.md)  
+ Svcutil.exe ツールによって生成されるさまざまなクラスとインターフェイスについて説明します。  
+  
+ [方法 : メタデータの取得および準拠サービスの実装をする](../../../../docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md)  
+ Svcutil.exe を使用してメタデータを取得し、準拠サービスを実装する方法を示します。  
+  
+ [サービス メタデータからの WCF クライアントの生成](../../../../docs/framework/wcf/feature-details/generating-a-wcf-client-from-service-metadata.md)  
+ Svcutil.exe を使用してメタデータを取得し、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントを生成する方法を示します。  
+  
+## 参照  
+ [メタデータ](../../../../docs/framework/wcf/feature-details/metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-multiple-authentication-schemes-with-wcf.md b/docs/framework/wcf/feature-details/using-multiple-authentication-schemes-with-wcf.md
new file mode 100644
index 00000000000..2eb0978c945
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-multiple-authentication-schemes-with-wcf.md
@@ -0,0 +1,139 @@
+---
+title: "WCF での複数の認証方式の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f32a56a0-e2b2-46bf-a302-29e1275917f9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF での複数の認証方式の使用
+WCF では、単一のエンドポイントに複数の認証方式を指定できるようになりました。  さらに、Web ホスト サービスは、認証設定を IIS から直接継承できます。  自己ホスト型サービスは、使用可能な認証方式を指定できます。  IIS での認証設定の詳細については、「[IIS の認証](http://go.microsoft.com/fwlink/?LinkId=232458)」を参照してください。  
+  
+## IIS でホストされるサービス  
+ IIS でホストされるサービスでは、IIS で使用する認証方式を設定します。  その後、サービスの web.config ファイル内のバインディング構成で、次の XML スニペットで示すように clientCredential の種類を "InheritedFromHost" として指定します。  
+  
+```xml  
+<bindings>  
+      <basicHttpBinding>  
+        <binding name="secureBinding">  
+          <security mode="Transport">  
+            <transport clientCredentialType="InheritedFromHost" />  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+```  
+  
+ ServiceAuthenticationBehavior または \<serviceAuthenticationManager\> 要素を使用して、認証方式のサブセットのみをサービスで使用するよう指定できます。  これをコードで構成する場合は、次のコード スニペットに示すように ServiceAuthenticationBehavior を使用します。  
+  
+```csharp  
+// ...  
+ServiceAuthenticationBehavior sab = null;  
+sab = serviceHost.Description.Behaviors.Find<ServiceAuthenticationBehavior>();  
+  
+if (sab == null)  
+{  
+    sab = new ServiceAuthenticationBehavior();  
+    sab.AuthenticationSchemes = AuthenticationSchemes.Basic | AuthenticationSchemes.Negotiate | AuthenticationSchemes.Digest;  
+    serviceHost.Description.Behaviors.Add(sab);  
+}  
+else  
+{  
+     sab.AuthenticationSchemes = AuthenticationSchemes.Basic | AuthenticationSchemes.Negotiate | AuthenticationSchemes.Digest;  
+}  
+// ...  
+  
+```  
+  
+ config ファイルでこれを構成する場合は、次の XML スニペットに示すように \<serviceAuthenticationManager\> 要素を使用します。  
+  
+```xml  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior name="limitedAuthBehavior">  
+          <serviceAuthenticationManager authenticationSchemes="Negotiate, Digest, Basic"/>  
+          <!-- ... -->  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+```  
+  
+ この結果、IIS で選択した内容に応じて、ここに示されている認証方式のサブセットに限り、サービス エンドポイントへの適用が検討されます。  つまり、開発者は serviceAuthenticationManager の一覧から基本認証を省略することによって、リストから基本認証を除外することができます。IIS で有効になっている場合でも、サービス エンドポイントには適用されません。  
+  
+## 自己ホスト型サービス  
+ 自己ホスト型サービスは、設定を継承する IIS がないため、構成方法が少し異なります。  ここで、\<serviceAuthenticationManager\> 要素または ServiceAuthenticationBehavior を使用して、継承される認証設定を指定します。  コード例を次に示します。  
+  
+```csharp  
+// ...  
+ServiceAuthenticationBehavior sab = null;  
+sab = serviceHost.Description.Behaviors.Find<ServiceAuthenticationBehavior>();  
+  
+if (sab == null)  
+{  
+    sab = new ServiceAuthenticationBehavior();  
+    sab.AuthenticationSchemes = AuthenticationSchemes.Basic | AuthenticationSchemes.Negotiate | AuthenticationSchemes.Digest;  
+    serviceHost.Description.Behaviors.Add(sab);  
+}  
+else  
+{  
+     sab.AuthenticationSchemes = AuthenticationSchemes.Basic | AuthenticationSchemes.Negotiate | AuthenticationSchemes.Digest;  
+}  
+// ...  
+  
+```  
+  
+ config では、次のようになります。  
+  
+```xml  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior name="limitedAuthBehavior">  
+          <serviceAuthenticationManager authenticationSchemes="Negotiate, Digest, Basic"/>  
+          <!-- ... -->  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+```  
+  
+ その後、次の XML スニペットに示すように、バインディング設定で InheritFromHost を指定できます。  
+  
+```xml  
+<bindings>  
+      <basicHttpBinding>  
+        <binding name="secureBinding">  
+          <security mode="Transport">  
+            <transport clientCredentialType="InheritedFromHost" />  
+          </security>  
+        </binding>  
+      </basicHttpBinding>  
+    </bindings>  
+```  
+  
+ または、次の構成スニペットに示すように、HTTP トランスポート バインド要素で認証方式を設定することにより、カスタム バインディングで認証方式を指定することもできます。  
+  
+```xml  
+<binding name="multipleBinding">  
+      <textMessageEncoding/>  
+      <httpTransport authenticationScheme="Negotiate, Ntlm, Digest, Basic" />  
+    </binding>  
+  
+```  
+  
+## 参照  
+ [バインディングとセキュリティ](../../../../docs/framework/wcf/feature-details/bindings-and-security.md)   
+ [エンドポイント : アドレス、バインディング、およびコントラクト](../../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)   
+ [システムが提供するバインディングの構成](../../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [カスタム バインディングを使用したセキュリティ機能](../../../../docs/framework/wcf/feature-details/security-capabilities-with-custom-bindings.md)   
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)   
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)   
+ [カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-servicethrottlingbehavior-to-control-wcf-service-performance.md b/docs/framework/wcf/feature-details/using-servicethrottlingbehavior-to-control-wcf-service-performance.md
new file mode 100644
index 00000000000..9f49503e348
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-servicethrottlingbehavior-to-control-wcf-service-performance.md
@@ -0,0 +1,39 @@
+---
+title: "WCF サービス パフォーマンスを制御するための ServiceThrottlingBehavior の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービスのパフォーマンスの動作 [WCF]"
+ms.assetid: f9dc120c-dc24-49d5-930e-b22f5bc73423
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WCF サービス パフォーマンスを制御するための ServiceThrottlingBehavior の使用
+<xref:System.ServiceModel.Description.ServiceThrottlingBehavior>クラス インスタンスの数を制限するために使用できるか、セッションは、アプリケーション レベルで作成するプロパティを公開します。 この動作を使用して、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションのパフォーマンスを最適に調整できます。  
+  
+## <a name="controlling-service-instances-and-concurrent-calls"></a>サービス インスタンスと同時呼び出しの制御  
+ 使用して、 <xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentCalls%2A>でアクティブに処理されるメッセージの最大数を指定するプロパティ、 <xref:System.ServiceModel.ServiceHost>クラス、および<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentInstances%2A>の最大数を指定するプロパティ<xref:System.ServiceModel.InstanceContext>サービス内のオブジェクト。  
+  
+ 通常、これらのプロパティ設定の決定はに対してアプリケーションを実行している実際の動作後に行われるのための設定を読み込みます、 <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>プロパティは、通常、アプリケーション構成ファイルを使用して指定、 [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/servicethrottling.md)要素。  
+  
+ 次のコード例の使用を示しています、 <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>を設定するアプリケーション構成ファイルからクラスを<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentSessions%2A>、 <xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentCalls%2A>、および<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentInstances%2A>プロパティを 1 に簡単な例として。 特定のアプリケーションでの最適な設定については、実際の動作から判断します。  
+  
+ [!code-csharp[ServiceThrottlingBehavior#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/servicethrottlingbehavior/cs/hostapplication.exe.config#3)]  
+  
+ 値によって、実際の実行時動作、 <xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A>と<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A>プロパティは、メッセージの数が、操作内実行できる同時やサービスの有効期間<xref:System.ServiceModel.InstanceContext>受信チャネル セッションに関連、それぞれします。  
+  
+ 詳細については、「 <xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentCalls%2A>、および<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentInstances%2A>します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>   
+ <xref:System.ServiceModel.NetTcpBinding.MaxConnections%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-the-discovery-client-channel.md b/docs/framework/wcf/feature-details/using-the-discovery-client-channel.md
new file mode 100644
index 00000000000..e1640f1aaf4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-the-discovery-client-channel.md
@@ -0,0 +1,70 @@
+---
+title: "探索クライアント チャネルの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1494242a-1d64-4035-8ecd-eb4f06c8d2ba
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 探索クライアント チャネルの使用
+WCF クライアント アプリケーションを記述するときには、呼び出すサービスのエンドポイント アドレスを知っている必要があります。多くの場合、サービスのエンドポイント アドレスがわからなかったり、サービスのアドレスが時間の経過と共に変化したりします。探索クライアント チャネルでは、WCF クライアント アプリケーションを記述し、呼び出すサービスを示すと、クライアント チャネルが自動的にプローブ要求を送信します。サービスが応答すると、探索クライアント チャネルは、プローブ応答からサービスのエンドポイント アドレスを受け取り、それを使用してサービスを呼び出します。  
+  
+## 探索クライアント チャネルの使用  
+ 探索クライアント チャネルを使用するには、<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> のインスタンスをクライアント チャネル スタックに追加します。または、<xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用すると、まだ追加されていない場合は、<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> が自動的にバインディングに追加されます。  
+  
+> [!CAUTION]
+>  <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> は、クライアント チャネル スタックの最上位要素にすることをお勧めします。<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> の上に追加されたバインディング要素では、<xref:System.ServiceModel.ChannelFactory>、またはそれによって作成されるチャネルが、エンドポイント アドレスまたは `Via` アドレス \(`CreateChannel` メソッドに渡されたアドレス\) を使用しないようにする必要があります。これらには、正しいアドレスが格納されていない可能性があります。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> クラスには、2 つのパブリック プロパティが含まれています。  
+  
+1.  呼び出すサービスを示すのに使用する <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement.FindCriteria%2A>。  
+  
+2.  探索メッセージの送信先の探索エンドポイントを指定する <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement.DiscoveryEndpoint%2A>。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement.FindCriteria%2A> プロパティでは、探しているサービス コントラクト、必要なスコープ URI、およびチャネルを開く最大試行回数を指定できます。コントラクトの型は、コンストラクター <xref:System.ServiceModel.Discovery.FindCriteria%2A> の呼び出しによって指定されます。スコープ URI は <xref:System.ServiceModel.Discovery.FindCriteria.Scopes%2A> プロパティに追加できます。<xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> プロパティでは、クライアントが接続を試行する結果の最大数を指定できます。プローブ応答を受信すると、クライアントは、プローブ応答で取得したエンドポイント アドレスを使用してチャネルを開きます。例外が発生した場合、クライアントは次のプローブ応答に進み、必要に応じて、さらに応答の受信を待機します。チャネルが正常に開かれるか、または結果の最大数に達するまで、この処理が続行されます。これらの設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「<xref:System.ServiceModel.Discovery.FindCriteria%2A>」を参照してください。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement.DiscoveryEndpoint%2A> プロパティでは、使用する探索エンドポイントを指定できます。通常は <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> ですが、任意の有効なエンドポイントを指定できます。  
+  
+ サービスとの通信に使用するバインディングを作成するときには、サービスとまったく同じバインディングを使用するように注意する必要があります。唯一の相違点は、クライアント バインディングの場合は、<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> がスタックの一番上にあることです。サービスが、システムによって提供されるバインディングの 1 つを使用している場合は、新しい <xref:System.ServiceModel.Channels.CustomBinding> を作成し、システムによって提供されるバインディングを <xref:System.ServiceModel.CustomBinding.CustomBinding%2A> コンストラクターに渡します。次に、`Insert` を <xref:System.ServiceModel.Channels.Binding.Elements%2A> プロパティで呼び出して、<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> を追加できます。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> をバインディングに追加し、構成したら、WCF クライアント クラスのインスタンスを作成し、それを開いて、そのメソッドを呼び出すことができます。次の例では、探索クライアント チャネルを使用して、`ICalculator` クラス \(WCF の入門チュートリアルで使用するクラス\) を実装し、その `Add` メソッドを呼び出す、WCF サービスを探索します。  
+  
+```  
+// Create the DiscoveryClientBindingElement  
+DiscoveryClientBindingElement bindingElement = new DiscoveryClientBindingElement();  
+// Search for a service that implements the ICalculator interface, attempting to open  
+// the channel a maximum of 2 times  
+bindingElement.FindCriteria = new FindCriteria(typeof(ICalculator)) { MaxResults = 2 };  
+// Use the UdpDiscoveryEndpoint  
+bindingElement.DiscoveryEndpoint = new UdpDiscoveryEndpoint();  
+  
+// The service uses the BasicHttpBinding, so use that and insert the DiscoveryClientBindingElement at the   
+// top of the stack  
+CustomBinding binding = new CustomBinding(new BasicHttpBinding());  
+binding.Elements.Insert(0,bindingElement);  
+  
+try  
+{  
+    // Create the WCF client and call a method  
+    CalculatorClient client = new CalculatorClient(binding, new EndpointAddress("http://schemas.microsoft.com/dynamic"));  
+    client.Open();  
+    client.Add(1, 1);  
+}  
+catch (EndpointNotFoundException ex)  
+{  
+    Console.WriteLine("An exception occurred: " + ex.Message);  
+}  
+```  
+  
+## セキュリティおよび探索クライアント チャネル  
+ 探索クライアント チャネルの使用時には、2 つのエンドポイントが指定されます。1 つは探索メッセージ用に使用されるエンドポイント \(通常は <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>\) で、もう 1 つはアプリケーション エンドポイントです。セキュリティで保護されたサービスを実装するときには、両方のエンドポイントを保護するように注意する必要があります。セキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-the-message-class.md b/docs/framework/wcf/feature-details/using-the-message-class.md
new file mode 100644
index 00000000000..1291b73f011
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-the-message-class.md
@@ -0,0 +1,214 @@
+---
+title: "メッセージ クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d1d62bfb-2aa3-4170-b6f8-c93d3afdbbed
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# メッセージ クラスの使用
+<xref:System.ServiceModel.Channels.Message>クラスは基本となる[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]します。 クライアントとサービス間のすべての通信が最終的な結果に<xref:System.ServiceModel.Channels.Message>インスタンスが送受信されました。  
+  
+ 対話することはない通常の<xref:System.ServiceModel.Channels.Message>クラスを直接します。 その代わりに、データ コントラクト、メッセージ コントラクト、操作コントラクトなどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モデル コントラクトを使用して送受信メッセージを表します。 ただし、いくつか高度なシナリオを使用してプログラミングすることができます、<xref:System.ServiceModel.Channels.Message>クラスを直接します。 使用するなど、<xref:System.ServiceModel.Channels.Message>クラス。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトをシリアル化する以外の方法で送信メッセージの内容を作成する必要がある場合 (ディスク上のファイルからメッセージを直接作成する場合など)。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトに逆シリアル化する以外の方法で受信メッセージの内容を使用する必要がある場合 (XSLT 変換を XML の未処理コンテンツに適用する場合など)。  
+  
+-   メッセージ コンテンツに関係なく、一般的な方法でメッセージを処理する必要がある場合 (メッセージをルーティングまたは転送する場合や、ルーターシステム、負荷分散システム、または発行/定期受信システムを構築する場合など)。  
+  
+ 使用する前に、<xref:System.ServiceModel.Channels.Message>クラス、理解しておく、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]のデータ転送アーキテクチャ[データ転送のアーキテクチャ概要](../../../../docs/framework/wcf/feature-details/data-transfer-architectural-overview.md)します。  
+  
+ A<xref:System.ServiceModel.Channels.Message>は、データの汎用的なコンテナーですが、その設計は SOAP プロトコル メッセージのデザインとほとんど同じです。 SOAP と同様に、メッセージには本文とヘッダーの両方があります。 メッセージ本文には実際のペイロード データが格納され、ヘッダーには追加の名前付きデータ コンテナーが格納されます。 本文とヘッダーの読み書きルールは異なります。たとえば、ヘッダーは必ずメモリにバッファーされるので順序や回数に関係なくアクセスできますが、本文は&1; 度だけ読み取ってストリーミングできます。 通常 SOAP を使用する場合、メッセージ本文は SOAP 本文にマップされ、メッセージ ヘッダーは SOAP ヘッダーにマップされます。  
+  
+## <a name="using-the-message-class-in-operations"></a>処理におけるメッセージ クラスの使用  
+ 使用することができます、<xref:System.ServiceModel.Channels.Message>処理、操作のいずれかまたは両方の戻り値の入力パラメーターとしてクラスです。 場合<xref:System.ServiceModel.Channels.Message>使用は任意の場所演算では、次の制限を適用します。  
+  
+-   処理に `out` パラメーターまたは `ref` パラメーターを含めることはできません。  
+  
+-   複数の `input` パラメーターを指定できません。 パラメーターがある場合は、そのパラメーターを Message 型またはメッセージ コントラクト型にする必要があります。  
+  
+-   戻り値の型は、`void` 型、`Message` 型、またはメッセージ コントラクト型にする必要があります。  
+  
+ 有効な操作コントラクトを次のコード例に示します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#1)]
+ [!code-vb[C_UsingTheMessageClass#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#1)]  
+  
+## <a name="creating-basic-messages"></a>基本メッセージの作成  
+ <xref:System.ServiceModel.Channels.Message>クラスには静的`CreateMessage`ファクトリ メソッド基本的なメッセージを作成することができます。  
+  
+ すべて`CreateMessage`型のバージョン パラメーターを受け取るオーバー ロード<xref:System.ServiceModel.Channels.MessageVersion>メッセージで使用する SOAP と Ws-addressing のバージョンを示します。 受信メッセージと同じプロトコル バージョンを使用する場合は、使用、 <xref:System.ServiceModel.OperationContext.IncomingMessageVersion%2A>プロパティを<xref:System.ServiceModel.OperationContext>から取得したインスタンス、<xref:System.ServiceModel.OperationContext.Current%2A>プロパティです。 また、ほとんどの `CreateMessage` オーバーロードには、メッセージで使用する SOAP アクションを示す文字列パラメーターもあります。 バージョンを `None` に設定すると、SOAP エンベロープの生成を無効にできます。この場合、メッセージは本文のみで構成されます。  
+  
+## <a name="creating-messages-from-objects"></a>オブジェクトからのメッセージの作成  
+ 最も基本的な `CreateMessage` オーバーロードは、バージョンとアクションだけを受け取り、本文が空のメッセージを作成します。 別のオーバー ロードは、追加<xref:System.Object>パラメーターの場合、メッセージ本体を持つ指定したオブジェクトのシリアル化表現は、これが作成されます。 使用して、 <xref:System.Runtime.Serialization.DataContractSerializer>シリアル化の既定の設定にします。 異なるシリアライザーを使用する場合、または `DataContractSerializer` の構成を変更する場合は、`CreateMessage` パラメーターも受け取る `XmlObjectSerializer` オーバーロードを使用します。  
+  
+ たとえば、メッセージにオブジェクトを返す場合は、次のコードを使用できます。  
+  
+ [!code-csharp[C_UsingTheMessageClass#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#2)]
+ [!code-vb[C_UsingTheMessageClass#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#2)]  
+  
+## <a name="creating-messages-from-xml-readers"></a>XML リーダーからのメッセージの作成  
+ ある`CreateMessage`を受け取るオーバー ロード、 <xref:System.Xml.XmlReader>または<xref:System.Xml.XmlDictionaryReader>オブジェクトではなく、本文のです。 この場合、メッセージの本文には、渡された XML リーダーから読み取られた XML が格納されます。 たとえば、次のコードは、XML ファイルから読み取られた内容を本文に持つメッセージを返します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#3)]
+ [!code-vb[C_UsingTheMessageClass#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#3)]  
+  
+ さらに、ある`CreateMessage`を受け取るオーバー ロード、 <xref:System.Xml.XmlReader>または<xref:System.Xml.XmlDictionaryReader>メッセージ全体と、本文だけでなくを表します。 これらのオーバーロードは、整数の `maxSizeOfHeaders` パラメーターも受け取ります。 メッセージが作成されると直ちにヘッダーがメモリに必ずバッファーされます。このパラメーターは、発生するバッファーの量を制限します。 XML が信頼できないソースから取り込まれる場合は、このパラメーターを安全な値に設定してサービス拒否攻撃の可能性を軽減することが重要です。 XML リーダーが表す、メッセージの SOAP バージョンと WS-Addressing バージョンは、バージョン パラメーターを使用して示されるバージョンと一致する必要があります。  
+  
+## <a name="creating-messages-with-bodywriter"></a>BodyWriter によるメッセージの作成  
+ `CreateMessage` オーバーロードの&1; つには、メッセージ本文を記述するための `BodyWriter` インスタンスを受け取るものがあります。 `BodyWriter` は、メッセージ本文の作成方法をカスタマイズするために派生させることのできる抽象クラスです。 独自の `BodyWriter` 派生クラスを作成すると、カスタマイズした方法でメッセージ本文を記述できます。 オーバーライドする必要があります、`BodyWriter.OnWriteBodyContents`を受け取るメソッド、 <xref:System.Xml.XmlDictionaryWriter>; このメソッドは、本文の作成を担当します。  
+  
+ 本文ライターでは、バッファリングを行うことも、行わないようにする (ストリームする) こともできます。 バッファリングされる本文ライターでは、その内容を何度でも出力できますが、ストリームされる本文ライターの内容は&1; 度しか出力できません。 `IsBuffered` プロパティは、本文ライターがバッファリングされるかどうかを示します。 独自の本文ライターでこれを設定するには、ブール型の `BodyWriter` パラメーターを受け取る `isBuffered` プロテクト コンストラクターを呼び出します。 本文ライターでは、バッファリングされない本文ライターから、バッファリングされた本文ライターを作成することがサポートされています。 `OnCreateBufferedCopy` メソッドをオーバーライドすると、この処理をカスタマイズできます。 既定では、`OnWriteBodyContents` から返された XML が格納されているメモリ内のバッファーが使用されます。 `OnCreateBufferedCopy` は、整数の `maxBufferSize` パラメーターを受け取ります。このメソッドをオーバーライドする場合は、この最大サイズを超えるバッファーを作成しないようにする必要があります。  
+  
+ `BodyWriter` クラスには、`WriteBodyContents` メソッドと `CreateBufferedCopy` メソッドが用意されています。基本的にこれらは、それぞれ `OnWriteBodyContents` メソッドと `OnCreateBufferedCopy` メソッドの薄いラッパー (thin wrapper) です。 これらのメソッドは、バッファリングされない本文ライターが&2; 回以上アクセスされないように状態チェックを実行します。 これらのメソッドは、`Message` に基づいたカスタム `BodyWriters` 派生クラスを作成する場合にのみ直接呼び出されます。  
+  
+## <a name="creating-fault-messages"></a>エラー メッセージの作成  
+ 特定の `CreateMessage` オーバーロードを使用して SOAP エラー メッセージを作成できます。 これらはの最も基本的な<xref:System.ServiceModel.Channels.MessageFault>エラーを説明するオブジェクト。 他のオーバーロードは、利便性のために用意されています。 このようなオーバーロードの&1; つは、`FaultCode` と理由の文字列を受け取り、その情報を `MessageFault` で使用して `MessageFault.CreateFault` を作成します。 他のオーバーロードは、詳細オブジェクトを受け取り、そのオブジェクトをエラー コードと理由と共に `CreateFault` に渡します。 たとえば、次の操作はエラーを返します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#4)]
+ [!code-vb[C_UsingTheMessageClass#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#4)]  
+  
+## <a name="extracting-message-body-data"></a>メッセージ本文データの抽出  
+ `Message` クラスでは、その本文から情報を抽出する複数の方法がサポートされています。 方法は次のカテゴリに分類されます。  
+  
+-   XML ライターに&1; 度に書き込まれるメッセージ本文全体の取得。 これとして参照は*メッセージを書き込む*します。  
+  
+-   メッセージ本文での XML リーダーの取得。 これにより、必要に応じてメッセージ本文に後で少しずつアクセスできます。 これとして参照は*メッセージの読み取り*します。  
+  
+-   メモリ内のバッファーには、本文を含むメッセージ全体をコピーできます、 <xref:System.ServiceModel.Channels.MessageBuffer>型です。 これとして参照は*メッセージのコピー*します。  
+  
+ `Message` の本文には、アクセス方法に関係なく&1; 回しかアクセスできません。 メッセージ オブジェクトには `State` プロパティがあります。このプロパティは Created として初期化されます。 この状態は、前の&3; つのアクセス方法により、それぞれ Written、Read、Copied に設定されます。 また、メッセージ本文の内容が不要になったときは、`Close` メソッドによって状態が Closed に設定されます。 メッセージ本文には、状態が Created の場合にのみアクセスできます。状態が変更された後で Created に戻す方法はありません。  
+  
+## <a name="writing-messages"></a>メッセージの書き込み  
+ <xref:System.ServiceModel.Channels.Message.WriteBodyContents%28System.Xml.XmlDictionaryWriter%29>メソッドの本文の内容を指定された`Message`指定された XML ライターのインスタンス。 <xref:System.ServiceModel.Channels.Message.WriteBody%2A>メソッドは同じで、適切なラッパー要素に、本文の内容を囲む点が異なります (たとえば、 `soap:body`>)。 最後に、 <xref:System.ServiceModel.Channels.Message.WriteMessage%2A> SOAP エンベロープとヘッダーをラップする側を含むメッセージ全体を書き込みます。 SOAP が無効になっている場合 (バージョンが `MessageVersion.None`)、これらの&3; つのメソッドはすべて同じ処理を行います。つまり、メッセージ本文の内容を書き込みます。  
+  
+ たとえば、次のコードは、受信メッセージの本文をファイルに書き込みます。  
+  
+ [!code-csharp[C_UsingTheMessageClass#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#5)]
+ [!code-vb[C_UsingTheMessageClass#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#5)]  
+  
+ さらに、特定の SOAP 開始要素タグを書き込む&2; つのヘルパー メソッドがあります。 これらのメソッドはメッセージ本文にアクセスしないため、メッセージの状態は変わりません。 次の設定があります。  
+  
+-   <xref:System.ServiceModel.Channels.Message.WriteStartBody%2A>など、開始本文要素を書き込みます`<soap:Body>`します。  
+  
+-   <xref:System.ServiceModel.Channels.Message.WriteStartEnvelope%2A>など、開始エンベロープ要素を書き込みます`<soap:Envelope>`します。  
+  
+ 対応する終了要素タグを書き込むには、対応する XML ライターで `WriteEndElement` を呼び出します。 これらのメソッドが直接呼び出されることはほとんどありません。  
+  
+## <a name="reading-messages"></a>メッセージの読み取り  
+ メッセージ本体を読み取る主な方法は呼び出す<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A>します。 戻ります、 <xref:System.Xml.XmlDictionaryReader>メッセージ本文の読み取りに使用することできます。 注意してください、<xref:System.ServiceModel.Channels.Message>読み取り状態に遷移するとすぐに<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A>が呼び出されると、返された XML リーダーを使用する場合にないとします。  
+  
+ <xref:System.ServiceModel.Channels.Message.GetBody%2A>メソッドでは型指定されたオブジェクトとしてメッセージ本文にアクセスすることもできます。 このメソッドを使用して内部的には、`GetReaderAtBodyContents`にメッセージの状態を移行するため、<xref:System.ServiceModel.Channels.MessageState>状態 (を参照してください、<xref:System.ServiceModel.Channels.Message.State%2A>プロパティ)。  
+  
+ 確認することをお勧めは、 <xref:System.ServiceModel.Channels.Message.IsEmpty%2A>プロパティの場合、メッセージ本文は空と<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A>スロー、 <xref:System.InvalidOperationException>します。 また、受信したメッセージ (返信など) の場合、することも確認する<xref:System.ServiceModel.Channels.Message.IsFault%2A>メッセージにエラーが含まれるかどうかを示します。  
+  
+ 最も基本的なオーバー ロード<xref:System.ServiceModel.Channels.Message.GetBody%2A>型 (ジェネリック パラメーターで示されます) を使用して、インスタンスにメッセージ本文をシリアル化解除、 <xref:System.Runtime.Serialization.DataContractSerializer>と既定の設定で構成されて、 <xref:System.Runtime.Serialization.DataContractSerializer.MaxItemsInObjectGraph%2A>クォータが無効になっています。 別のシリアル化エンジンを使用するか、または構成するかどうか、`DataContractSerializer`既定以外の方法で使用して、 <xref:System.ServiceModel.Channels.Message.GetBody%2A>を受け取るオーバー ロード、 <xref:System.Runtime.Serialization.XmlObjectSerializer>します。  
+  
+ たとえば、次のコードは、シリアル化された `Person` オブジェクトを含むメッセージ本文からデータを抽出し、その人の名前を出力します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#6](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#6)]
+ [!code-vb[C_UsingTheMessageClass#6](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#6)]  
+  
+## <a name="copying-a-message-into-a-buffer"></a>バッファーへのメッセージのコピー  
+ 場合によっては、メッセージ本文に&2; 回以上アクセスする必要が生じます。たとえば、パブリッシャー/サブスクライバー システムの一部として、同じメッセージを複数の宛先に転送する場合です。 この場合、メッセージ全体 (本文を含む) をメモリ内にバッファーする必要があります。 呼び出すことによってこれを行う<xref:System.ServiceModel.Channels.Message.CreateBufferedCopy%28System.Int32%29>します。 このメソッドは、最大バッファー サイズを表す整数パラメーターを受け取り、このサイズ以下のバッファーを作成します。 信頼されていないソースからメッセージを受信する場合は、これを安全な値に設定することが重要です。  
+  
+ バッファーとして返される、 <xref:System.ServiceModel.Channels.MessageBuffer>インスタンス。 バッファー内のデータには、いくつかの方法でアクセスできます。 呼び出すことの主な方法です<xref:System.ServiceModel.Channels.Message.CreateMessage%2A>を作成する`Message`バッファーからのインスタンス。  
+  
+ 実装には、バッファー内のデータにアクセスする方法、 <xref:System.Xml.XPath.IXPathNavigable>インターフェイスが、 <xref:System.ServiceModel.Channels.MessageBuffer>クラスを基になる XML に直接アクセスを実装します。 いくつか<xref:System.ServiceModel.Channels.MessageBuffer.CreateNavigator%2A>を作成できるオーバー ロード<xref:System.Xml.XPath>ナビゲーター、ノード クォータで保護されたアクセス可能 XML ノードの数を制限します。 これにより、非常に長い処理時間によるサービス拒否攻撃を防止できます。 このクォータは、既定では無効です。 いくつか`CreateNavigator`XML 内の空白の処理方法を指定できるオーバー ロードを使用して、 <xref:System.Xml.XmlSpace>列挙型の既定値は、`XmlSpace.None`です。  
+  
+ メッセージ バッファーの内容にアクセスする最後の方法は、その内容を使用してストリームに書き出す<xref:System.ServiceModel.Channels.Message.WriteMessage%2A>します。  
+  
+ `MessageBuffer` を操作する手順を次の例に示します。受信メッセージを複数の受信者に転送してからファイルに記録します。 バッファリングを行わないと、メッセージの本文には&1; 回しかアクセスできないため、この処理は不可能になります。  
+  
+ [!code-csharp[C_UsingTheMessageClass#7](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#7)]
+ [!code-vb[C_UsingTheMessageClass#7](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#7)]  
+  
+ `MessageBuffer` クラスには、この他にも注目すべきメンバーがあります。 <xref:System.ServiceModel.Channels.MessageBuffer.Close%2A>バッファーの内容が必要な不要になった場合は、リソースを解放メソッドを呼び出すことができます。 <xref:System.ServiceModel.Channels.MessageBuffer.BufferSize%2A>プロパティが割り当てられたバッファーのサイズを返します。 <xref:System.ServiceModel.Channels.MessageBuffer.MessageContentType%2A>プロパティは、メッセージの MIME コンテンツ タイプを返します。  
+  
+## <a name="accessing-the-message-body-for-debugging"></a>デバッグのためのメッセージ本文へのアクセス  
+ 呼び出すことができます、デバッグのための<xref:System.ServiceModel.Channels.Message.ToString%2A>メソッドを文字列としてメッセージの表現を取得します。 一般に、メッセージがテキスト エンコーダーでエンコードされていれば、この表現はネットワーク上でのメッセージの表示形式と一致します。ただし、XML の場合は人間にとって読みやすいように書式設定されます。 1 つの例外はメッセージ本文です。 本文は&1; 度しか読み取ることができません。また、`ToString` はメッセージの状態を変更しません。 したがって、`ToString`メソッドを選択し、本文にアクセスできない可能性があります (たとえば、「...」プレース ホルダーを置き換えることがあります "...") で代用されることがあります。 したがって、メッセージ本文の内容が重要な場合は、`ToString` を使用してメッセージを記録しないでください。  
+  
+## <a name="accessing-other-message-parts"></a>メッセージの他の部分へのアクセス  
+ メッセージの本文以外の情報にアクセスするさまざまなプロパティが用意されています。 ただし、これらのプロパティは、メッセージを閉じると呼び出すことができなくなります。  
+  
+-   <xref:System.ServiceModel.Channels.Message.Headers%2A>プロパティは、メッセージ ヘッダーを表します。 このトピックの後の「ヘッダーの操作」を参照してください。  
+  
+-   <xref:System.ServiceModel.Channels.Message.Properties%2A>プロパティは、一般に送出されません、メッセージが送信されるときに、メッセージに添付された名前付きのデータの一部であるメッセージのプロパティを表します。 このトピックの後の「プロパティの操作」を参照してください。  
+  
+-   <xref:System.ServiceModel.Channels.Message.Version%2A>プロパティが、メッセージに関連付けられている SOAP と Ws-addressing のバージョンを示すまたは`None`SOAP が無効になっている場合。  
+  
+-   <xref:System.ServiceModel.Channels.Message.IsFault%2A>プロパティを返します。`true`メッセージが SOAP エラー メッセージである場合。  
+  
+-   <xref:System.ServiceModel.Channels.Message.IsEmpty%2A>プロパティを返します。`true`場合は、メッセージが空です。  
+  
+ 使用することができます、 <xref:System.ServiceModel.Channels.Message.GetBodyAttribute%28System.String%2CSystem.String%29>本文のラッパー要素の特定の属性にアクセスする方法 (たとえば、 `<soap:Body>`)、特定の名前と名前空間で識別されます。 このような属性が見つからない場合は、`null` が返されます。 このメソッドは、`Message` の状態が Created の場合 (メッセージ本文がまだアクセスされていない場合) にのみ呼び出すことができます。  
+  
+## <a name="working-with-headers"></a>ヘッダーの操作  
+ A`Message`と呼ばれる、名前付きの XML フラグメントの任意の数を含めることができます*ヘッダー*します。 通常、各フラグメントは SOAP ヘッダーにマップされます。 ヘッダーを使用してアクセスされる、`Headers`型のプロパティ<xref:System.ServiceModel.Channels.MessageHeaders>します。 <xref:System.ServiceModel.Channels.MessageHeaders>のコレクションは、 <xref:System.ServiceModel.Channels.MessageHeaderInfo>を通じてアクセスできるオブジェクト、および個々 のヘッダー、 <xref:System.Collections.IEnumerable>インターフェイスまたはインデクサーです。 たとえば、次のコードでは、`Message` のすべてのヘッダー名を表示します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#8](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#8)]
+ [!code-vb[C_UsingTheMessageClass#8](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#8)]  
+  
+#### <a name="adding-removing-finding-headers"></a>ヘッダーの追加、削除、検索  
+ 新しいヘッダーを追加するにを使用してすべての既存のヘッダーの最後に、<xref:System.ServiceModel.Channels.MessageHeaders.Add%2A>メソッドです。 使用することができます、<xref:System.ServiceModel.Channels.MessageHeaders.Insert%2A>メソッドを特定のインデックスに、ヘッダーを挿入します。 挿入されたアイテムに応じて既存のヘッダーは移動します。 ヘッダーは、インデックスに従って順序付けられ、使用できる最初のインデックスは 0 です。 ボリュームを使用して、さまざまな<xref:System.ServiceModel.Channels.MessageHeaders.CopyHeadersFrom%2A>を異なるヘッダーを追加するメソッドのオーバー ロード`Message`または`MessageHeaders`インスタンス。 一部のオーバーロードはヘッダーを&1; つだけコピーします。すべてのヘッダーをコピーする別のオーバーロードもあります。 <xref:System.ServiceModel.Channels.MessageHeaders.Clear%2A>メソッドは、すべてのヘッダーを削除します。 <xref:System.ServiceModel.Channels.MessageHeaders.RemoveAt%2A>メソッドは、(その後にすべてのヘッダーをシフト) 特定のインデックス位置にあるヘッダーを削除します。 <xref:System.ServiceModel.Channels.MessageHeaders.RemoveAll%2A>メソッドは、特定の名前と名前空間のすべてのヘッダーを削除します。  
+  
+ 特定のヘッダーを使用して、取得、 <xref:System.ServiceModel.Channels.MessageHeaders.FindHeader%2A>メソッドです。 このメソッドは、検索するヘッダーの名前と名前空間を受け取り、そのインデックスを返します。 複数のヘッダーが見つかった場合は、例外がスローされます。 ヘッダーが見つからなかい場合は、-1 が返されます。  
+  
+ SOAP ヘッダー モデルでは、ヘッダーに `Actor` 値を持たせ、ヘッダーの受信者を指定できます。 最も基本的な `FindHeader` オーバーロードでは、メッセージの最終受信者を表すヘッダーのみを検索します。 ただし、別のオーバーロードでは、検索に含める `Actor` 値を指定できます。 [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、SOAP 仕様を参照してください。  
+  
+ A [CopyTo (MessageHeaderInfo\<xref:System.ServiceModel.Channels.MessageHeaders.CopyTo%28System.ServiceModel.Channels.MessageHeaderInfo%5B%5D%2CSystem.Int32%29>からヘッダーをコピーする方法が提供される、 <xref:System.ServiceModel.Channels.MessageHeaders>の配列にコレクション<xref:System.ServiceModel.Channels.MessageHeaderInfo>オブジェクトです。  
+  
+ ヘッダー内の XML データにアクセスするに呼び出すことができます<xref:System.ServiceModel.Channels.MessageHeaders.GetReaderAtHeader%2A>し、特定のヘッダー インデックスの XML リーダーを返します。 ヘッダーの内容をオブジェクトに逆シリアル化する場合は、使用<xref:System.ServiceModel.Channels.MessageHeaders.GetHeader%60%601%28System.Int32%29>または他のオーバー ロードのいずれかです。 最も基本的なオーバー ロードを使用してヘッダーを逆シリアル化、 <xref:System.Runtime.Serialization.DataContractSerializer>既定値で構成されている方法です。 異なるシリアライザーを使用したり、異なる構成の `DataContractSerializer` を使用したりする場合は、`XmlObjectSerializer` を受け取るオーバーロードの&1; つを使用します。 インデックスの代わりに、ヘッダー名、名前空間、オプションとして `Actor` 値のリストを受け取るオーバーロードもあります。これは、`FindHeader` と `GetHeader` の組み合わせです。  
+  
+## <a name="working-with-properties"></a>プロパティの操作  
+ `Message` インスタンスには、任意の数の任意の型の名前付きオブジェクトを含めることができます。 このコレクションは、`Properties` 型の `MessageProperties` プロパティを使用してアクセスできます。 コレクションを実装、 <xref:System.Collections.Generic.IDictionary%602>インターフェイスし、のマッピングの役割を果たします<xref:System.String>に<xref:System.Object>\</TKey, TValue>。 通常、プロパティの値は、ネットワーク上のメッセージの一部に直接マップされないが、さまざまなメッセージ処理のヒントのさまざまなチャンネルを提供、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]チャネル スタックや、 [CopyTo (MessageHeaderInfo\<xref:System.ServiceModel.Channels.MessageHeaders.CopyTo%28System.ServiceModel.Channels.MessageHeaderInfo%5B%5D%2CSystem.Int32%29>サービス フレームワークです。 例については、次を参照してください。[データ転送のアーキテクチャ概要](../../../../docs/framework/wcf/feature-details/data-transfer-architectural-overview.md)します。  
+  
+## <a name="inheriting-from-the-message-class"></a>Message クラスからの継承  
+ `CreateMessage` を使用して作成された組み込みのメッセージ型がユーザーの要件を満たさない場合は、`Message` クラスから派生するクラスを作成します。  
+  
+### <a name="defining-the-message-body-contents"></a>メッセージ本文の内容の定義  
+ メッセージ本文内のデータにアクセスする主な手法は、書き込み、読み取り、バッファーへのコピーの&3; つです。 これらの操作は、最終的に、 <xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%2A>、 <xref:System.ServiceModel.Channels.Message.OnGetReaderAtBodyContents%2A>、および<xref:System.ServiceModel.Channels.Message.OnCreateBufferedCopy%2A>メソッドの呼び出しに、それぞれの派生クラスで`Message`します。 `Message` 基本クラスでは、これらのメソッドは `Message` インスタンスごとに&1; つしか呼び出されないようになっており、そのメソッドが&2; 回以上呼び出されることもありません。 また、この基本クラスは、閉じられているメッセージでメソッドが呼び出されないことも保証します。 実装の中でメッセージ状態を追跡する必要はありません。  
+  
+ <xref:System.ServiceModel.Channels.Message.OnWriteBodyContents%2A>抽象メソッドで、実装する必要があります。 メッセージの本文内容を定義する最も基本的な方法は、このメソッドを使用して書き込むことです。 たとえば、次のメッセージには 1 から 20 までの 100,000 個の乱数が含まれています。  
+  
+ [!code-csharp[C_UsingTheMessageClass#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#9)]
+ [!code-vb[C_UsingTheMessageClass#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#9)]  
+  
+ 
+          `OnGetReaderAtBodyContents` メソッドと `OnCreateBufferedCopy` メソッドには、ほとんどの場合に有効な既定の実装があります。 既定の実装は、`OnWriteBodyContents` を呼び出し、結果をバッファーに格納して、格納後のバッファーを操作します。 ただし、これが十分ではない場合もあります。 前の例では、メッセージを読み込むと 100,000 個の XML 要素がバッファーに格納されることになりますが、これは望ましくありません。 `OnGetReaderAtBodyContents` をオーバーライドすると、乱数を提供するカスタムの `XmlDictionaryReader` 派生クラスを返すことができます。 これで、`OnWriteBodyContents` をオーバーライドして、`OnGetReaderAtBodyContents` プロパティから返されたリーダーを使用できます。この例を次に示します。  
+  
+ [!code-csharp[C_UsingTheMessageClass#10](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_usingthemessageclass/cs/source.cs#10)]
+ [!code-vb[C_UsingTheMessageClass#10](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_usingthemessageclass/vb/source.vb#10)]  
+  
+ 同様に `OnCreateBufferedCopy` をオーバーライドして、独自の `MessageBuffer` 派生クラスを返すこともできます。  
+  
+ メッセージの派生クラスでは、メッセージ本文の内容を提供するだけでなく、`Version`、`Headers`、`Properties` の各プロパティをオーバーライドする必要もあります。  
+  
+ メッセージのコピーを作成した場合、作成したコピーでは、元のメッセージのメッセージ ヘッダーが使用されます。  
+  
+### <a name="other-members-that-can-be-overridden"></a>オーバーライド可能なその他のメンバー  
+ オーバーライドすることができます、 <xref:System.ServiceModel.Channels.Message.OnWriteStartEnvelope%2A>、 <xref:System.ServiceModel.Channels.Message.OnWriteStartHeaders%2A>、および<xref:System.ServiceModel.Channels.Message.OnWriteStartBody%2A> SOAP エンベロープ、SOAP ヘッダーと SOAP 本文要素のタグを起動する方法を指定する方法が書き込まれます。 通常、これらは、`<soap:Envelope>`、`<soap:Header>`、および `<soap:Body>` に対応します。 一般的に、`Version` プロパティで `MessageVersion.None` が返された場合、これらのメソッドで何も書き込まないでください。  
+  
+> [!NOTE]
+>  `OnGetReaderAtBodyContents` の既定の実装では、`OnWriteStartEnvelope` を呼び出して結果をバッファーに格納する前に、`OnWriteStartBody` と `OnWriteBodyContents` を呼び出します。 ヘッダーは書き込まれません。  
+  
+ オーバーライド、 <xref:System.ServiceModel.Channels.Message.OnWriteMessage%2A>メソッドで、さまざまな部分からメッセージ全体を構築する方法を変更します。 `OnWriteMessage`からメソッドを呼び出した<xref:System.ServiceModel.Channels.Message.WriteMessage%2A>や既定<xref:System.ServiceModel.Channels.Message.OnCreateBufferedCopy%2A>実装します。 オーバーライドすることに注意してください<xref:System.ServiceModel.Channels.Message.WriteMessage%2A>ベスト プラクティスではありません。 適切な上書きすることをお勧め`On`メソッド (たとえば、 <xref:System.ServiceModel.Channels.Message.OnWriteStartEnvelope%2A>、 <xref:System.ServiceModel.Channels.Message.OnWriteStartHeaders%2A>、および<xref:System.ServiceModel.Channels.BodyWriter.OnWriteBodyContents%2A>します。  
+  
+ オーバーライド<xref:System.ServiceModel.Channels.Message.OnBodyToString%2A>をデバッグ中のメッセージ本文の表現方法をオーバーライドします。 既定では、3 つのドット ("...") で表されます。 このメソッドは、メッセージの状態が Closed 以外のときに複数回呼び出すことができます。 このメソッドを実装すると、1 度だけ実行する必要のある処理 (転送のみのストリームからの読み取りなど) は発生しません。  
+  
+ オーバーライド、 <xref:System.ServiceModel.Channels.Message.OnGetBodyAttribute%2A>メソッド、SOAP 本文要素の属性へのアクセスを許可するようにします。 このメソッドは何度でも呼び出すことができますが、`Message` 基本型は、メッセージの状態が Created の時にのみ呼び出されることを保証します。 実装の中で状態をチェックする必要はありません。 既定の実装は、本文要素に属性がないことを示す `null` を常に返します。  
+  
+ 場合、`Message`オブジェクトでは、メッセージ本文が必要でなくなったときに特別なクリーンアップを実行する必要があります、オーバーライドする<xref:System.ServiceModel.Channels.Message.OnClose%2A>します。 既定の実装では、何も行われません。  
+  
+ `IsEmpty` プロパティと `IsFault` プロパティは、オーバーライド可能です。 既定では、両方とも `false` を返します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-the-nethttpbinding.md b/docs/framework/wcf/feature-details/using-the-nethttpbinding.md
new file mode 100644
index 00000000000..3c4c612beaa
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-the-nethttpbinding.md
@@ -0,0 +1,72 @@
+---
+title: "NetHttpBinding の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe134acf-ceca-49de-84a9-05a37e3841f1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# NetHttpBinding の使用
+<xref:System.ServiceModel.NetHttpBinding> は、HTTP や WebSocket のサービスを使用するために設計されたバインドで、既定ではバイナリ エンコードを使用します。  <xref:System.ServiceModel.NetHttpBinding> は、要求\-応答コントラクトと二重のコントラクトのどちらで使用されているかを検出し、一致するように動作を変更します。要求\-応答コントラクトには HTTP、二重のコントラクトには Websocket を使用します。  この動作は、<xref:System.ServiceModel.NetHttpBinding.WebSocketTransportUsage%2A> 設定を使用してオーバーライドできます。  
+  
+1.  Always \- 要求\-応答コントラクトでも Websocket が使用されるようにします。  
+  
+2.  Never \- Websocket が使用されないようにします。  この設定で二重のコントラクトを使用しようとすると、例外が発生します。  
+  
+3.  WhenDuplex \- これが既定値で、既に説明したように動作します。  
+  
+ <xref:System.ServiceModel.NetHttpBinding> は、HTTP モードと WebSocket モードの両方で信頼できるセッションをサポートします。  WebSocket モードでは、セッションがトランスポートによって提供されます。  
+  
+> [!WARNING]
+>  <xref:System.ServiceModel.NetHttpBinding> を使用していて、バインドの TransferMode が TransferMode.Streamed に設定されている場合、大きいストリームによってデッドロックが発生する可能性があり、呼び出しがタイムアウトします。  この問題を回避するには、小さいメッセージを送信するか、TransferMode.Buffered を使用してください。  
+  
+## NetHttpBinding を使用するサービスの構成  
+ <xref:System.ServiceModel.NetHttpBinding> は、他のバインドと同様に構成できます。  次の構成スニペットは、<xref:System.ServiceModel.NetHttpBinding> を使用して WCF サービスを構成する方法を示しています。  
+  
+```xml  
+<system.serviceModel>  
+    <services>  
+      <service name="WcfService1.Service1">  
+        <endpoint address=""  
+                  binding="netHttpBinding"  
+                  contract="WcfService1.IService1"/>  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange"/>  
+      </service>  
+    </services>  
+    <bindings>  
+      <netHttpBinding>  
+        <binding name="My_NetHttpBindingConfig">  
+          <webSocketSettings transportUsage="WhenDuplex"/>  
+        </binding>  
+      </netHttpBinding>  
+    </bindings>  
+    <!- ... -->   
+  </system.serviceModel>  
+```  
+  
+ 次のコード スニペットは、コードで <xref:System.ServiceModel.NetHtttpBinding> を追加する方法を示しています。  
+  
+```csharp  
+ServiceHost svchost = new ServiceHost(typeof(Service1), baseAddress);  
+            NetHttpBinding binding = new NetHttpBinding();  
+            svchost.AddServiceEndpoint(typeof(IService1), binding, address);   
+        }  
+```  
+  
+## 参照  
+ [サービスのバインディングの構成](../../../../docs/framework/wcf/configuring-bindings-for-wcf-services.md)   
+ [バインディング](../../../../docs/framework/wcf/feature-details/bindings.md)   
+ [システム標準のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [双方向サービス](../../../../docs/framework/wcf/feature-details/duplex-services.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-the-xmlserializer-class.md b/docs/framework/wcf/feature-details/using-the-xmlserializer-class.md
new file mode 100644
index 00000000000..3be6079f9bf
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-the-xmlserializer-class.md
@@ -0,0 +1,197 @@
+---
+title: "XmlSerializer クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XmlSerializer [WCF], 使用"
+ms.assetid: c680602d-39d3-44f1-bf22-8e6654ad5069
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# XmlSerializer クラスの使用
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、各種のシリアル化テクノロジを使用して、アプリケーション データをクライアントとサービス間で転送される XML に変換できます。この処理をシリアル化といいます。  
+  
+## 既定としての DataContractSerializer  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の既定では、データ型をシリアル化するのに <xref:System.Runtime.Serialization.DataContractSerializer> クラスが使用されます。 このシリアライザーは、次の型をサポートします。  
+  
+-   プリミティブ型 \(整数、文字列、バイト配列など\) や、プリミティブとして処理される <xref:System.Xml.XmlElement> や <xref:System.DateTime> などの特殊な型。  
+  
+-   データ コントラクト型 \(<xref:System.Runtime.Serialization.DataContractAttribute> 属性でマークされた型\)。  
+  
+-   <xref:System.SerializableAttribute> インターフェイスを実装する型など、<xref:System.Runtime.Serialization.ISerializable> 属性でマークされた型。  
+  
+-   <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装する型。  
+  
+-   多くのジェネリック コレクション型を含む多くの共通コレクション型。  
+  
+ 多くの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型は、上に記載した一覧のうち、下 2 つのカテゴリに分類され、したがってシリアル化可能です。 シリアル化可能な型の配列もシリアル化可能です。 完全な一覧については、「[サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。  
+  
+ 新しい <xref:System.Runtime.Serialization.DataContractSerializer> サービスを記述する方法としては、データ コントラクト型と共に使用される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が推奨されます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)。  
+  
+## XmlSerializer クラスを使用する場合  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は <xref:System.Xml.Serialization.XmlSerializer> クラスもサポートします。<xref:System.Xml.Serialization.XmlSerializer> クラスは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 独自のものではありません。 これは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスが使用するのと同じシリアル化エンジンです。<xref:System.Xml.Serialization.XmlSerializer> クラスでは、<xref:System.Runtime.Serialization.DataContractSerializer> クラスよりもサポートされる型の範囲がずっと狭くなりますが、結果の XML に対する制御の柔軟性に優れています。また、XML スキーマ定義言語 \(XSD\) 標準のサポート範囲が広く、 シリアル化可能な型で宣言型属性が要求されません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のドキュメントで XML シリアル化に関するトピックを参照してください。<xref:System.Xml.Serialization.XmlSerializer> クラスは、データ コントラクト型をサポートしません。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] の Svcutil.exe または **\[サービス参照の追加\]** 機能を使用して、サードパーティ サービス用のクライアント コードを生成したり、サードパーティ スキーマを利用する場合、適切なシリアライザーが自動的に選択されます。 スキーマに <xref:System.Runtime.Serialization.DataContractSerializer> との互換性がない場合は、<xref:System.Xml.Serialization.XmlSerializer> が選択されます。  
+  
+## XmlSerializer への手動切り替え  
+ <xref:System.Xml.Serialization.XmlSerializer> に手動で切り替える必要が生じる場合もあります。 たとえば、次のような場合です。  
+  
+-   アプリケーションを [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web サービスから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に移行するときに、新しいデータ コントラクト型を作成するのではなく、既存の <xref:System.Xml.Serialization.XmlSerializer> 互換の型を再利用する場合。  
+  
+-   メッセージに表示する XML に対する正確な制御が必要で、Web サービス記述言語 \(WSDL\) ドキュメントが利用できない場合。たとえば、DataContractSerializer と互換性がなく、標準化および公開されている特定のスキーマに従う必要のある型を使用して、サービスを作成する場合。  
+  
+-   従来の SOAP エンコード標準に従うサービスを作成する場合。  
+  
+ 上記を含めた多様な状況で、次のコードに示すように、<xref:System.Xml.Serialization.XmlSerializer> 属性をサービスに適用することにより、`XmlSerializerFormatAttribute` クラスに手動で切り替えることができます。  
+  
+ [!code-csharp[c_XmlSerializer#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_xmlserializer/cs/source.cs#1)]
+ [!code-vb[c_XmlSerializer#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_xmlserializer/vb/source.vb#1)]  
+  
+## セキュリティの考慮事項  
+  
+> [!NOTE]
+>  シリアル化エンジンを切り替える場合は注意が必要です。 同じ型でも、使用するシリアライザーによって XML へのシリアル化方法が異なる場合があります。 誤って、不適切なシリアライザーを使用すると、公開する意図のない型の情報が公開されるおそれがあります。  
+  
+ たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> クラスは、データ コントラクト型をシリアル化する場合、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性でマークされたメンバーのみをシリアル化します。<xref:System.Xml.Serialization.XmlSerializer> クラスは、すべてのパブリック メンバーをシリアル化します。 たとえば、次のコードの型を見てください。  
+  
+ [!code-csharp[c_XmlSerializer#2](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_xmlserializer/cs/source.cs#2)]
+ [!code-vb[c_XmlSerializer#2](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_xmlserializer/vb/source.vb#2)]  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスが選択されているサービス コントラクトでこの型が誤って使用された場合、意図したものではなくても `creditCardNumber` メンバーがシリアル化されます。  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> クラスが既定の場合でも、<xref:System.ServiceModel.DataContractFormatAttribute> 属性をサービス コントラクト型に適用することで、このクラスをサービスに対して明示的に選択できます \(ただし、この操作が必要になることはありません\)。  
+  
+ サービスで使用するシリアライザーはコントラクトにとって不可欠な部分です。別のバインディングを選択しても他の構成設定に変更しても、このシリアライザーを変更することはできません。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスについては、セキュリティに関する重要な考慮事項が他にもあります。 まず、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クラスを使用するすべての <xref:System.Xml.Serialization.XmlSerializer> アプリケーションには、情報の漏えいから保護されたキーを使って署名することを強くお勧めします。 このことは、<xref:System.Xml.Serialization.XmlSerializer> に手動で切り替える場合と、自動切り替えが行われる場合 \(Svcutil.exe やサービス参照の追加などのツールによる\) の両方でお勧めします。 これは、<xref:System.Xml.Serialization.XmlSerializer> シリアル化エンジンで*事前生成済みのシリアル化アセンブリ*の読み込みがサポートされており、これらがアプリケーションと同じキーで署名されるためです。 署名されていないアプリケーションは、アプリケーション フォルダーやグローバル アセンブリ キャッシュに配置される事前生成済みのシリアル化アセンブリで予想される名前に、悪意のあるアセンブリが一致するという危険性に対して完全に無防備になります。 もちろん、攻撃者がこのようなアクションを行うには、この 2 つの場所のいずれかに対する書き込みアクセスをまず取得する必要があります。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> を使用するときに必ず存在するもう 1 つの脅威は、システムの一時フォルダーへの書き込みアクセスに関連するものです。<xref:System.Xml.Serialization.XmlSerializer> シリアル化エンジンは、このフォルダー内に一時的な*シリアル化アセンブリ*を作成して使用します。 一時フォルダーへの書き込みアクセスのあるプロセスであれば、悪意のあるコードによってこれらのシリアル化アセンブリが上書きされるおそれがあることに注意してください。  
+  
+## XmlSerializer サポートのルール  
+ <xref:System.Xml.Serialization.XmlSerializer> 互換の属性は、コントラクト操作のパラメーターまたは戻り値に直接適用できません。 ただし、次のコードに示すように、型指定されたメッセージ \(メッセージ コントラクトの本文\) には適用できます。  
+  
+ [!code-csharp[c_XmlSerializer#3](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_xmlserializer/cs/source.cs#3)]
+ [!code-vb[c_XmlSerializer#3](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_xmlserializer/vb/source.vb#3)]  
+  
+ 型指定されたメッセージのメンバーに適用する場合、型指定されたメッセージ属性で競合するプロパティは、この属性によりオーバーライドされます。 たとえば、次のコードの `ElementName` は、`Name` をオーバーライドします。  
+  
+ [!code-csharp[c_XmlSerializer#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_xmlserializer/cs/source.cs#4)]
+ [!code-vb[c_XmlSerializer#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_xmlserializer/vb/source.vb#4)]  
+  
+ <xref:System.ServiceModel.MessageHeaderArrayAttribute> の使用時は、<xref:System.Xml.Serialization.XmlSerializer> 属性はサポートされません。  
+  
+> [!NOTE]
+>  この場合、<xref:System.Xml.Serialization.XmlSerializer> より前にリリースされた [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって、"スキーマのトップ レベルで宣言された要素に `maxOccurs` \> 1 の値を含めることはできません。`XmlArray` ではなく、`XmlArrayItem` または `XmlElementAttribute` を使うか、Wrapped パラメーター スタイルを使って 'more' のラッパー要素を指定してください。" という例外がスローされます。  
+>   
+>  この例外が出力された場合は、この状況が当てはまるかどうかを調査します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、メッセージ コントラクトおよび操作コントラクトでの <xref:System.Xml.Serialization.SoapIncludeAttribute> 属性および <xref:System.Xml.Serialization.XmlIncludeAttribute> 属性はサポートされていません。代わりに、<xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を使用してください。  
+  
+## IXmlSerializable インターフェイスを実装する型  
+ `IXmlSerializable` インターフェイスを実装する型は、`DataContractSerializer` で完全にサポートされます。 これらの型には、スキーマを制御するために必ず <xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性を適用する必要があります。  
+  
+> [!WARNING]
+>  ポリモーフィック型をシリアル化する場合、<xref:System.Xml.Serialization.XmlSchemaProviderAttribute> を型に適用して、正しい型がシリアル化されるようにする必要があります。  
+  
+ `IXmlSerializable` を実装する型には、任意のコンテンツを表す型、1 つの要素を表す型、および従来の <xref:System.Data.DataSet> 型の 3 種類があります。  
+  
+-   コンテンツ型では、`XmlSchemaProviderAttribute` 属性によって指定されたスキーマ プロバイダー メソッドが使用されます。 このメソッドから `null` が返されることはなく、属性の <xref:System.Xml.Serialization.XmlSchemaProviderAttribute.IsAny%2A> プロパティは既定値 `false` のままになります。 これは、`IXmlSerializable` 型の最も一般的な使用方法です。  
+  
+-   要素型は、`IXmlSerializable` 型が自身のルート要素名を制御する必要があるときに使用します。 型を要素型としてマークするには、<xref:System.Xml.Serialization.XmlSchemaProviderAttribute.IsAny%2A> 属性の <xref:System.Xml.Serialization.XmlSchemaProviderAttribute> プロパティを `true` に設定するか、スキーマ プロバイダー メソッドから `null` を返します。 スキーマ プロバイダー メソッドの使用は、要素型ではオプションです。`null` でメソッド名の代わりに `XmlSchemaProviderAttribute` を指定できます。 ただし、`IsAny` が `true` で、スキーマ プロバイダー メソッドが指定されている場合、メソッドは `null` を返す必要があります。  
+  
+-   従来の <xref:System.Data.DataSet> 型は、`IXmlSerializable` 属性でマークされていない `XmlSchemaProviderAttribute` 型です。 これらの型は、スキーマ生成に関して <xref:System.Xml.Serialization.IXmlSerializable.GetSchema%2A> メソッドに依存しています。 以前のバージョンの .NET Framework では、このパターンが `DataSet` 型に使用され、型指定されたデータセットからクラスが派生されます。ただし、現在、このパターンは使用されなくなっており、従来の型に対応することだけを目的としてサポートされています。 このパターンに依存せず、必ず `XmlSchemaProviderAttribute` を `IXmlSerializable` 型に適用してください。  
+  
+### IXmlSerializable コンテンツ型  
+ `IXmlSerializable` を実装しており、以前に定義したコンテンツ型である型のデータ メンバーをシリアル化すると、シリアライザーはそのデータ メンバーのラッパー要素を書き込み、<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> メソッドに制御を渡します。<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> 実装により、ラッパー要素に属性が追加されるなど、任意の XML が書き込まれることがあります。`WriteXml` の実行後、シリアライザーは要素を閉じます。  
+  
+ `IXmlSerializable` を実装しており、以前に定義したコンテンツ型である型のデータ メンバーを逆シリアル化すると、デシリアライザーはそのデータ メンバーのラッパー要素に XML リーダーを配置し、<xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> メソッドに制御を渡します。 このメソッドは、開始タグと終了タグを含む、要素全体を読み取る必要があります。`ReadXml` コードでは、要素が空の場合も忘れずに処理してください。 また、`ReadXml` の実装では、特定の方法で名前が付けられたラッパー要素に依存しないようにしてください。 シリアライザーによって選択される名前は、異なる場合があります。  
+  
+ `IXmlSerializable` コンテンツ型は、たとえば <xref:System.Object> 型のデータ メンバーなどに、ポリモーフィックに割り当てることができます。 また、型インスタンスを null にすることもできます。 さらに、`IXmlSerializable` 型は、オブジェクト グラフの保存を有効にして <xref:System.Runtime.Serialization.NetDataContractSerializer> で使用することも可能です。 これらのすべての機能を実現するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] シリアライザーが特定の属性 \(XML スキーマ インスタンス名前空間の "nil" と "type"、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 固有の名前空間の "Id"、"Ref"、"Type"、および "Assembly"\) をラッパー要素に追加する必要があります。  
+  
+#### ReadXml を実装するときに無視する属性  
+ `ReadXml` コードに制御を渡す前に、デシリアライザーは、XML 要素を調べ、前述の特別な XML 属性を検出し、その属性に従って動作します。 たとえば、"nil" が `true` の場合は、null 値が逆シリアル化され、`ReadXml` は呼び出されません。 ポリモーフィズムが検出された場合は、要素のコンテンツが別の型と同様に逆シリアル化されます。 ポリモーフィックに割り当てられた型の `ReadXml` 実装が呼び出されます。 どの場合も、これらの特別な属性がデシリアライザーによって処理されるため、`ReadXml` 実装ではこれらの属性を無視する必要があります。  
+  
+### IXmlSerializable コンテンツ型のスキーマに関する考慮事項  
+ スキーマと `IXmlSerializable` コンテンツ型をエクスポートすると、スキーマ プロバイダー メソッドが呼び出されます。 このスキーマ プロバイダー メソッドには、<xref:System.Xml.Schema.XmlSchemaSet> が渡されます。 このメソッドは、有効なスキーマをスキーマ セットに追加できます。 スキーマ セットには、スキーマをエクスポートした時点で既に認識されていたスキーマが格納されます。 スキーマ プロバイダー メソッドは、スキーマ セットに項目を追加する必要があるときに、適切な名前空間を持つ <xref:System.Xml.Schema.XmlSchema> がそのセットに既に存在するかどうかを確認する必要があります。 存在する場合、スキーマ プロバイダー メソッドは新しい項目を既存の `XmlSchema` に追加する必要があります。 存在しない場合、新しい `XmlSchema` インスタンスを作成する必要があります。 これは、`IXmlSerializable` 型の配列を使用する場合に重要です。 たとえば、`IXmlSerializable` 型を名前空間 "B" の "A" 型としてエクスポートする場合、スキーマ プロバイダー メソッドが呼び出される前に、"B" が "ArrayOfA" 型を保持するためのスキーマがスキーマ セットに既に存在している可能性があります。  
+  
+ 型を <xref:System.Xml.Schema.XmlSchemaSet> に追加する以外に、コンテンツ型のスキーマ プロバイダー メソッドは null 以外の値を返す必要があります。 このメソッドは、特定の <xref:System.Xml.XmlQualifiedName> 型で使用するスキーマ型の名前を指定する `IXmlSerializable` を返すことができます。 この修飾名は、その型のデータ コントラクト名および名前空間としても使用されます。 スキーマ プロバイダー メソッドは、スキーマ セットにまだ存在していない型であっても、復帰時に返すことができます。 ただし、関連するすべての型がエクスポートされる \(<xref:System.Runtime.Serialization.XsdDataContractExporter.Export%2A> の関連するすべての型に対して <xref:System.Runtime.Serialization.XsdDataContractExporter> メソッドが呼び出され、<xref:System.Runtime.Serialization.XsdDataContractExporter.Schemas%2A> プロパティにアクセスする\) までに、その型がスキーマ セットに存在している必要があります。 関連するすべての `Schemas` 呼び出しが実行される前に `Export` プロパティにアクセスすると、<xref:System.Xml.Schema.XmlSchemaException> が発生する可能性があります。 エクスポート プロセスの[!INCLUDE[crabout](../../../../includes/crabout-md.md)]については、「[クラスからのスキーマのエクスポート](../../../../docs/framework/wcf/feature-details/exporting-schemas-from-classes.md)」を参照してください。  
+  
+ スキーマ プロバイダー メソッドは、使用する <xref:System.Xml.Schema.XmlSchemaType> を返すこともできます。 その型は、匿名の場合とそうでない場合があります。 匿名の場合、`IXmlSerializable` 型のスキーマは、`IXmlSerializable` 型がデータ メンバーとして使用されるたびに匿名型としてエクスポートされます。`IXmlSerializable` 型には、データ コントラクト名と名前空間が引き続き保持されます  \(決定方法は、「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」で説明されているとおりです。ただし、<xref:System.Runtime.Serialization.DataContractAttribute> 属性を使用して名前をカスタマイズすることはできません\)。 匿名でない場合、型は `XmlSchemaSet` に含まれている型のいずれかである必要があります。 これは、型の `XmlQualifiedName` を返す場合と同じです。  
+  
+ さらに、型のグローバル要素宣言がエクスポートされます。 型に <xref:System.Xml.Serialization.XmlRootAttribute> 属性が適用されていない場合、その要素にはデータ コントラクトと同じ名前と名前空間が使用され、その "nillable" プロパティは `true` に設定されます。 ただし、スキーマ名前空間 \("http:\/\/www.w3.org\/2001\/XMLSchema"\) だけは例外です。型のデータ コントラクトがこの名前空間にある場合は、スキーマ名前空間に新しい要素を追加することが禁止されているため、対応するグローバル要素は、空白の名前空間に属することになります。 型に `XmlRootAttribute` 属性が適用されている場合、グローバル要素宣言は、<xref:System.Xml.Serialization.XmlRootAttribute.ElementName%2A>、<xref:System.Xml.Serialization.XmlRootAttribute.Namespace%2A>、および <xref:System.Xml.Serialization.XmlRootAttribute.IsNullable%2A> の各プロパティを使用してエクスポートされます。`XmlRootAttribute` が適用された場合の既定値は、データ コントラクト名、空白の名前空間、および `true` に設定された "nillable" です。  
+  
+ 同じグローバル要素宣言の規則が、従来のデータセット型に適用されます。`XmlRootAttribute` は、カスタム コードによって追加されたグローバル要素宣言をオーバーライドできません。これには、スキーマ プロバイダー メソッドを使用して `XmlSchemaSet` に追加された場合と、従来のデータセット型に対して `GetSchema` を使用して追加された場合があります。  
+  
+### IXmlSerializable 要素型  
+ `IXmlSerializable` 要素型には、`IsAny` に設定された `true` プロパティか、`null` を返すスキーマ プロバイダー メソッドのいずれかが含まれています。  
+  
+ 要素型のシリアル化と逆シリアル化は、コンテンツ型のシリアル化と逆シリアル化に非常に似ています。 ただし、重要な違いがいくつかあります。  
+  
+-   `WriteXml` の実装では、要素 \(これには複数の子要素が含まれている可能性もありますが\) を 1 つだけ出力することが想定されています。 この 1 つの要素の外側にある属性、複数の兄弟要素、またはこれらが混在したコンテンツを出力することはできません。 要素は空であってもかまいません。  
+  
+-   `ReadXml` の実装では、ラッパー要素の読み取りは想定されていません。 読み取ることが想定されているのは、`WriteXml` で生成される要素 1 つのみです。  
+  
+-   要素型を一様にシリアル化する場合 \(データ コントラクトのデータ メンバーとしてシリアル化する場合など\) は、コンテンツ型の場合と同様に、`WriteXml` を呼び出す前にラッパー要素が出力されます。 ただし、`WriteXml` コンストラクターまたは `DataContractSerializer` コンストラクターによるシリアライザーの構築時にルート名と名前空間を明示的に指定しない限り、トップ レベルで要素型をシリアル化しても、通常は `NetDataContractSerializer` で書き出される要素を囲むラッパー要素が出力されることはありません。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)。  
+  
+-   構築時にルート名と名前空間を指定せずにトップ レベルで要素型をシリアル化した場合、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject%2A> と <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject%2A> では基本的に何も実行されず、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObjectContent%2A> によって `WriteXml` が呼び出されます。 このモードでは、シリアル化されるオブジェクトは `null` にできず、ポリモーフィックに割り当てることができません。 また、オブジェクト グラフの保存を有効化できず、`NetDataContractSerializer` も使用できません。  
+  
+-   構築時にルート名と名前空間を指定せずにトップ レベルで要素型を逆シリアル化したときに、要素の先頭を検出できた場合は、<xref:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject%2A> が `true` を返します。<xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> パラメーターが `verifyObjectName` に設定されている `true` は、実際にオブジェクトを読み取る前の動作が `IsStartObject` と同様です。 その後、`ReadObject` は制御を `ReadXml` メソッドに渡します。  
+  
+ 要素型の場合も、エクスポートされるスキーマは、前のセクションで説明した `XmlElement` 型に対するスキーマと同じです。ただし、スキーマ プロバイダー メソッドは、コンテンツ型と同様、追加のスキーマを <xref:System.Xml.Schema.XmlSchemaSet> に追加できます。 要素型には `XmlRootAttribute` 属性を使用することはできないので、グローバル要素宣言は要素型に対して出力されません。  
+  
+### XmlSerializer との相違点  
+ `IXmlSerializable` インターフェイス、`XmlSchemaProviderAttribute` 属性、および `XmlRootAttribute` 属性は、<xref:System.Xml.Serialization.XmlSerializer> でも認識されます。 ただし、データ コントラクト モデルでの処理方法に違いがあります。 重要な違いを以下にまとめます。  
+  
+-   スキーマ プロバイダー メソッドは、`XmlSerializer` で使用できるようにするためにパブリックにする必要がありますが、データ コントラクト モデルで使用するためにパブリックにする必要はありません。  
+  
+-   スキーマ プロバイダー メソッドは、データ コントラクト モデルで `IsAny` が `true` の場合に呼び出されますが、`XmlSerializer` では呼び出されません。  
+  
+-   コンテンツ型または従来のデータセット型に `XmlRootAttribute` 属性がない場合、`XmlSerializer` は、グローバル要素宣言を空白の名前空間にエクスポートします。 データ コントラクト モデルで通常使用される名前空間は、前に説明したとおりデータ コントラクトの名前空間です。  
+  
+ 両方のシリアル化技術で使用する型を作成する場合には、これらの違いに注意してください。  
+  
+### IXmlSerializable スキーマのインポート  
+ `IXmlSerializable` 型から生成されたスキーマをインポートする場合、次のような状況が考えられます。  
+  
+-   生成されたスキーマが、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」で説明されている有効なデータ コントラクト スキーマである場合があります。 この場合は、スキーマを通常どおりにインポートでき、通常のデータ コントラクト型が生成されます。  
+  
+-   生成されたスキーマが、有効なデータ コントラクト スキーマではない場合があります。 たとえば、スキーマ プロバイダー メソッドによって、データ コントラクト モデルでサポートされていない XML 属性を含むスキーマが生成されることがあります。 この場合、スキーマを `IXmlSerializable` 型としてインポートできます。 このインポート モードは、既定では有効になっていませんが、たとえば、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) の `/importXmlTypes` コマンド ライン スイッチを使用して、簡単に有効にすることができます。 詳細については、「[クラスを作成するためのスキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)」を参照してください。 型インスタンスを処理するには、XML を直接操作する必要があります。`XmlSerializer` の使用方法に関するトピックを参照し、より広い範囲のスキーマをサポートする別のシリアル化技術を使用することを検討することもできます。  
+  
+-   新しい型を生成する代わりに、プロキシ内の既存の `IXmlSerializable` 型を再利用できます。 この場合、「型を作成するためのスキーマのインポート」で説明する参照型の機能を使用して、再利用する型を示すことができます。 これは、Svcutil.exe で `/reference` スイッチを使用して、再利用する型を含むアセンブリを指定することに相当します。  
+  
+### XmlSerializer の従来の動作  
+ .NET Framework 4.0 以前では、XmlSerializer が C\# コードをファイルに書き込むことによって、一時的なシリアル化アセンブリが生成されます。 さらに、このファイルがアセンブリとしてコンパイルされます。  この動作では、シリアライザーの起動時間が長くなるなど、望ましくない結果が生じることがあります。 .NET Framework 4.5 では、この動作が変更され、コンパイラを使用せずに、アセンブリが生成されるようになりました。 開発者によっては、生成された C\# コードを確認したい場合もあります。 次の構成によって、この従来の動作を使用するように指定できます。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.xml.serialization>  
+    <xmlSerializer tempFilesLocation='e:\temp\XmlSerializerBug' useLegacySerializerGeneration="true" />  
+  </system.xml.serialization>  
+  <system.diagnostics>  
+    <switches>  
+      <add name="XmlSerialization.Compilation" value="1" />  
+    </switches>  
+  </system.diagnostics>  
+</configuration>  
+  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.DataContractFormatAttribute>   
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ <xref:System.ServiceModel.MessageHeaderArrayAttribute>   
+ [サービス コントラクトでのデータ転送の指定](../../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/using-ws-atomictransaction.md b/docs/framework/wcf/feature-details/using-ws-atomictransaction.md
new file mode 100644
index 00000000000..526f5124ccf
--- /dev/null
+++ b/docs/framework/wcf/feature-details/using-ws-atomictransaction.md
@@ -0,0 +1,37 @@
+---
+title: "WS-AtomicTransaction の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WS-AT プロトコル [WCF]"
+ms.assetid: 04a4c200-0af0-4c5d-a3d9-87cb7339e054
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# WS-AtomicTransaction の使用
+WS\-AtomicTransaction \(WS\-AT\) は、相互運用が可能なトランザクション プロトコルです。Web サービス メッセージを使用して分散トランザクションをフローできるようにすると共に、異種のトランザクション インフラストラクチャ間で相互運用できるように調整します。WS\-AT では、2 フェーズ コミット プロトコルを使用して、分散アプリケーション、トランザクション マネージャー、およびリソース マネージャー間でアトミックな結果を実現します。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で提供される WS\-AT 実装には、Microsoft 分散トランザクション コーディネーター \(MSDTC\) トランザクション マネージャーに組み込まれたプロトコル サービスが含まれています。WS\-AT を使用することにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、サードパーティのテクノロジを使用して構築された相互運用可能な Web サービスを含む、他のアプリケーションにトランザクションをフローさせることができます。  
+  
+ クライアント アプリケーションとサーバー アプリケーション間でトランザクションをフローさせるときに使用されるトランザクション プロトコルは、クライアントが選択したエンドポイントでサーバーが公開するバインディングによって決定されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] システム指定のバインディングでは、トランザクションの伝達形式として既定で `OleTransactions` プロトコルを指定するものと、WS\-AT を指定するものがあります。特定のバインディング内部でのトランザクション プロトコルの選択は、プログラムによって変更することもできます。  
+  
+ プロトコルの選択は、次の内容に影響を与えます。  
+  
+-   トランザクションをクライアントからサーバーにフローさせるために使用されるメッセージ ヘッダーの形式。  
+  
+-   トランザクションの結果を解決するために、クライアントのトランザクション マネージャーとサーバーのトランザクション マネージャーの間で 2 フェーズ コミット プロトコルを実行するために使用されるネットワーク プロトコル。  
+  
+ サーバーとクライアントが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して記述されている場合、WS\-AT を使用する必要はありません。その代わりに、`OleTransactions` プロトコルを使用する `TransactionFlow` 属性を有効にして `NetTcpBinding` の既定の設定を使用できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][\<netTcpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md).ただし、サード パーティのテクノロジで構築された Web サービスにトランザクションをフローさせる場合は、WS\-AT を使用する必要があります。  
+  
+## 参照  
+ [WS\-AtomicTransaction サポートの構成](../../../../docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md b/docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md
new file mode 100644
index 00000000000..d9a4aa64c8c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md
@@ -0,0 +1,57 @@
+---
+title: "バージョン トレラントなシリアル化コールバック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "OnDeserializedAttribute [WCF]"
+  - "OnDeserializingAttribute [WCF]"
+  - "OnSerializedAttribute [WCF]"
+  - "OnSerializingAttribute [WCF]"
+  - "シリアル化 [WCF], 既定値の設定"
+ms.assetid: aa4a3a6f-05ec-4efd-bdbf-2181e13e6468
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# バージョン トレラントなシリアル化コールバック
+データ コントラクトのプログラミング モデルでは、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> クラスと <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter> クラスがサポートする、複数のバージョンに対応するシリアル化コールバック メソッドが完全にサポートされます。  
+  
+## 複数のバージョンに対応する属性  
+ 4 つのコールバック属性があります。各属性は、さまざまなタイミングでシリアル化エンジンまたは逆シリアル化エンジンが呼び出すメソッドに適用できます。次の表では、各属性を使用するタイミングについて説明します。  
+  
+|属性|対応するメソッドが呼び出されるタイミング|  
+|--------|--------------------------|  
+|<xref:System.Runtime.Serialization.OnSerializingAttribute>|型をシリアル化する前に呼び出されます。|  
+|<xref:System.Runtime.Serialization.OnSerializedAttribute>|型をシリアル化した後に呼び出されます。|  
+|<xref:System.Runtime.Serialization.OnDeserializingAttribute>|型を逆シリアル化する前に呼び出されます。|  
+|<xref:System.Runtime.Serialization.OnDeserializedAttribute>|型を逆シリアル化した後に呼び出されます。|  
+  
+ メソッドは、<xref:System.Runtime.Serialization.StreamingContext> パラメーターを受け入れる必要があります。  
+  
+ これらのメソッドは、主にバージョン管理と初期化に使用するためのものです。逆シリアル化時にコンストラクターは呼び出されません。このため、データ メンバーのデータが受信ストリームにない場合、たとえば、データの送信元が、一部のデータ メンバーが不足している前のバージョンの型である場合、そのデータ メンバーを目的の既定値に適切に初期化できないことがあります。これを修正するには、次の例で示すように、<xref:System.Runtime.Serialization.OnDeserializingAttribute> でマークされたコールバック メソッドを使用します。  
+  
+ 上記の各コールバック属性でマークできるのは、型ごとに 1 つのメソッドだけです。  
+  
+### 例  
+ [!code-csharp[C_DataContract#9](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_datacontract/cs/source.cs#9)]
+ [!code-vb[C_DataContract#9](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_datacontract/vb/source.vb#9)]  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.OnSerializingAttribute>   
+ <xref:System.Runtime.Serialization.OnSerializedAttribute>   
+ <xref:System.Runtime.Serialization.OnDeserializingAttribute>   
+ <xref:System.Runtime.Serialization.OnDeserializedAttribute>   
+ <xref:System.Runtime.Serialization.StreamingContext>   
+ [バージョン トレラントなシリアル化](../../../../docs/framework/serialization/version-tolerant-serialization.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/was-activation-architecture.md b/docs/framework/wcf/feature-details/was-activation-architecture.md
new file mode 100644
index 00000000000..532e73090ab
--- /dev/null
+++ b/docs/framework/wcf/feature-details/was-activation-architecture.md
@@ -0,0 +1,97 @@
+---
+title: "WAS アクティベーション アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58aeffb0-8f3f-4b40-80c8-15f3f1652fd3
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# WAS アクティベーション アーキテクチャ
+ここでは、Windows プロセス アクティブ化サービス \(WAS とも呼ばれます\) の各コンポーネントについて説明します。  
+  
+## アクティベーション コンポーネント  
+ WAS は、複数のアーキテクチャ コンポーネントで構成されます。  
+  
+-   リスナー アダプター : 特定のネットワーク プロトコルでメッセージを受信し、WAS と通信して、受信メッセージを適切なワーカー プロセスにルーティングする Windows サービス。  
+  
+-   WAS : ワーカー プロセスの作成と有効期間を管理する Windows サービス。  
+  
+-   汎用ワーカー プロセス実行可能ファイル \(w3wp.exe\)。  
+  
+-   アプリケーション マネージャー : ワーカー プロセス内のアプリケーションをホストするアプリケーション ドメインの作成と有効期間を管理します。  
+  
+-   プロトコル ハンドラー : ワーカー プロセスで実行され、ワーカー プロセスと個々のリスナー アダプター間の通信を管理するプロトコル固有のコンポーネント。プロトコル ハンドラーには、プロセス プロトコル ハンドラーと AppDomain プロトコル ハンドラーの 2 種類があります。  
+  
+ ワーカー プロセス インスタンスをアクティブ化する場合、WAS は必要なプロセス プロトコル ハンドラーをワーカー プロセスに読み込み、アプリケーション マネージャーを使用して、アプリケーションをホストするアプリケーション ドメインを作成します。アプリケーション ドメインは、アプリケーションのコードと、アプリケーションが使用するネットワーク プロトコルに必要な AppDomain プロトコル ハンドラーを読み込みます。  
+  
+ ![WAS アーキテクチャ](../../../../docs/framework/wcf/feature-details/media/wasarchitecture.gif "WASArchitecture")  
+  
+### リスナー アダプター  
+ リスナー アダプターは個別の Windows サービスであり、リッスンするネットワーク プロトコルを使用して、メッセージ受信に使用されるネットワーク通信ロジックを実装します。次の表は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] プロトコルのリスナー アダプターの一覧です。  
+  
+|リスナー アダプターのサービス名|プロトコル|メモ|  
+|----------------------|-----------|--------|  
+|W3SVC|http|IIS 7.0 と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の両方に HTTP アクティベーションを提供する共通コンポーネントです。|  
+|NetTcpActivator|net.tcp|NetTcpPortSharing サービスに依存します。|  
+|NetPipeActivator|net.pipe||  
+|NetMsmqActivator|net.msmq|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ベースのメッセージ キュー アプリケーションで使用します。|  
+|NetMsmqActivator|msmq.formatname|既存のメッセージ キュー アプリケーションとの下位互換性を提供します。|  
+  
+ 次の XML サンプルに示すように、特定プロトコルのリスナー アダプターは、インストール時に applicationHost.config ファイルに登録されます。  
+  
+```  
+<system.applicationHost>  
+    <listenerAdapters>  
+        <add name="http" />  
+        <add name="net.tcp"   
+          identity="S-1-5-80-3579033775-2824656752-1522793541-1960352512-462907086" />  
+         <add name="net.pipe"   
+           identity="S-1-5-80-2943419899-937267781-4189664001-1229628381-3982115073" />  
+          <add name="net.msmq"   
+            identity="S-1-5-80-89244771-1762554971-1007993102-348796144-2203111529" />  
+           <add name="msmq.formatname"   
+             identity="S-1-5-80-89244771-1762554971-1007993102-348796144-2203111529" />  
+    </listenerAdapters>  
+</system.applicationHost>  
+```  
+  
+### プロトコル ハンドラー  
+ 特定のプロトコルのプロセス プロトコル ハンドラーと AppDomain プロトコル ハンドラーは、コンピューター レベルの Web.config ファイルに登録されます。  
+  
+```  
+<system.web>  
+   <protocols>  
+      <add name="net.tcp"   
+        processHandlerType=  
+         "System.ServiceModel.WasHosting.TcpProcessProtocolHandler"  
+        appDomainHandlerType=  
+         "System.ServiceModel.WasHosting.TcpAppDomainProtocolHandler"  
+        validate="false" />  
+      <add name="net.pipe"   
+        processHandlerType=  
+         "System.ServiceModel.WasHosting.NamedPipeProcessProtocolHandler"  
+          appDomainHandlerType=  
+           "System.ServiceModel.WasHosting.NamedPipeAppDomainProtocolHandler”/>  
+      <add name="net.msmq"  
+        processHandlerType=  
+         "System.ServiceModel.WasHosting.MsmqProcessProtocolHandler"  
+        appDomainHandlerType=  
+         "System.ServiceModel.WasHosting.MsmqAppDomainProtocolHandler"  
+        validate="false" />  
+   </protocols>  
+</system.web>  
+```  
+  
+## 参照  
+ [WCF で使用するための WAS を設定する](../../../../docs/framework/wcf/feature-details/configuring-the-wpa--service-for-use-with-wcf.md)   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-and-internationalized-domain-names.md b/docs/framework/wcf/feature-details/wcf-and-internationalized-domain-names.md
new file mode 100644
index 00000000000..aa2d4c4cb7f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-and-internationalized-domain-names.md
@@ -0,0 +1,53 @@
+---
+title: "WCF と国際化ドメイン名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8a3e10a-8bc2-4a78-8d86-a562ba6e65fa
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF と国際化ドメイン名
+国際化ドメイン名 \(IDN\) を持つ WCF サービスを許可するためのサポートが追加されました。  国際化ドメイン名とは、非 ASCII 文字を含むドメイン名です。  このサポートには、IDN 名を持つ WCF サービスをホストする機能と、IDN 名を持つ Web サービスとの通信を行う WCF クライアントをホストする機能の両方が含まれます。  
+  
+## System.Uri と IDN  
+ <xref:System.Uri> には、<xref:System.Uri.Host%2A> および <xref:System.Uri.DnsSafeHost%2A> という 2 つのプロパティがあります。  これらのプロパティには、IDN 構成設定に応じて Unicode 値または Punycode 値が格納されます。  
+  
+ IDN をアプリケーションの構成ファイルで有効にするには、次の XML を使用します。  
+  
+```  
+<configuration>  
+  <uri>  
+    <idn enabled="All/AllExceptIntranet/None" />  
+  </uri>  
+</configuration>  
+  
+```  
+  
+ \<idn\> 要素の enabled 属性は、次のいずれかの値に設定できます。  
+  
+1.  "None"  
+  
+2.  "AllExceptIntranet"  
+  
+3.  "All"  
+  
+ IDN 設定を "None" に設定した場合、Uri.Host または Uri.DnsSafeHost による変換は実行されません。  IDN 設定を "All" に設定した場合、uri.Host は Unicode のまま、uri.DnsSafeHost が Punycode に変換されます。  IDN 設定を "AllExceptIntranet" に設定すると、インターネット アドレスについては uri.DnsSafeHost が Punycode に変換され、イントラネット アドレスについては Unicode のままとなります。  この設定は、正しい DNS 名解決にとって重要です。  Windows 8 以降のバージョンでは、この設定を構成する必要はありません。  
+  
+> [!WARNING]
+>  Punycode を使用してアドレスをハードコーディングしないようにしてください。  アドレスは、適用した構成設定に基づき、WCF によって自動的に変換されます。  
+  
+> [!WARNING]
+>  Unicode 文字を applicationHost.exe.config に追加する場合は、UTF\-8 エンコードを使用してファイルを保存してください。  
+  
+## 参照  
+ [System.Uri](http://msdn.microsoft.com/library/system.uri.aspx)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-and-websockets.md b/docs/framework/wcf/feature-details/wcf-and-websockets.md
new file mode 100644
index 00000000000..eb040dd7d0f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-and-websockets.md
@@ -0,0 +1,31 @@
+---
+title: "WCF と WebSocket | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e53b49e-022c-49c7-8984-4b21b53c05b3
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF と WebSocket
+.NET Framework 4.5 では、Windows Communication Foundation の WebSocket のサポートが導入されています。Websocket は、標準的な HTTP ポート 80 と 443 を介した双方向通信を有効にする効率的な標準ベース テクノロジです。標準 HTTP ポートを使用することで、Websocket は中継局を通じて Web 全体で通信できます。2 つの新しい標準バインディングが WebSocket トランスポート経由の通信をサポートするために追加されました。<xref:System.ServiceModel.NetHttpBinding> および <xref:System.ServiceModel.NetHttpsBinding>。WebSocket 固有の設定は、<xref:System.ServiceModel.Channels.HttpTransportBindingElement.WebSocketSettings%2A> プロパティにアクセスして、<xref:> System.ServiceModel.Channels.HttpTransportBinding?qualifyHint=False&autoUpgrade=True 要素で構成できます。  
+  
+## このセクションの内容  
+ [NetHttpBinding の使用](../../../../docs/framework/wcf/feature-details/using-the-nethttpbinding.md)  
+ <xref:System.ServiceModel.NetHttpBinding> とその構成方法について説明します。  
+  
+ [WebSockets 上で通信する WCF サービスを作成する用法](../../../../docs/framework/wcf/feature-details/how-to-create-a-wcf-service-that-communicates-over-websockets.md)  
+ Websocket 経由で通信する WCF サービスを作成する方法について説明します。  
+  
+## 関連項目  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-discovery-object-model.md b/docs/framework/wcf/feature-details/wcf-discovery-object-model.md
new file mode 100644
index 00000000000..8307bd65d2d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-discovery-object-model.md
@@ -0,0 +1,142 @@
+---
+title: "WCF Discovery オブジェクト モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8365a152-eacd-4779-9130-bbc48fa5c5d9
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# WCF Discovery オブジェクト モデル
+WCF Discovery は、実行時に探索可能なサービスと、これらのサービスを検索して使用するクライアントの作成を可能にする統合プログラミング モデルを提供する型のセットで構成されています。  
+  
+## 探索可能なサービスの作成とサービスの検索  
+ WCF サービスを探索可能にするには、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> をサービス ホストの <xref:System.ServiceModel.Description.ServiceDescription> に追加し、探索エンドポイントを追加します。サービスがアナウンス メッセージを送信するように構成されている \(<xref:System.ServiceModel.Discovery.AnnouncementEndpoint> を追加して\) 場合は、サービス ホストが開かれるとき、および閉じられるときにアナウンスが送信されます。  
+  
+ サービスのアナウンス メッセージをリッスンするクライアントは、アナウンス サービスをホストし、1 つ以上のアナウンス エンドポイントを追加します。アナウンス サービスは、アナウンス メッセージを受信し、アナウンス イベントを発生させます。  
+  
+ クライアントは、<xref:System.ServiceModel.Discovery.DiscoveryClient> クラスを使用して、利用可能なサービスを検索します。クライアント アプリケーションは <xref:System.ServiceModel.Discovery.DiscoveryClient> クラスをインスタンス化し、探索メッセージの送信元を指定する探索エンドポイントを渡します。クライアントは <xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> メソッドを呼び出し、`Probe` 要求を送ります。探索メッセージをリッスンしているサービスが、この `Probe` 要求を受信します。サービスが `Probe` に指定されている条件に一致している場合は、`ProbeMatch` メッセージがクライアントに返されます。  
+  
+## オブジェクト モデル  
+ WCF Discovery API は、次のクラスを定義します。  
+  
+-   <xref:System.ServiceModel.Discovery.AnnouncementClient>  
+  
+-   <xref:System.ServiceModel.Discovery.AnnouncementEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.AnnouncementService>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryClient>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryMessageSequenceGenerator>  
+  
+-   <xref:System.ServiceModel.Discovery.ServiceDiscoveryMode>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryProxy>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryService>  
+  
+-   <xref:System.ServiceModel.Discovery.DiscoveryVersion>  
+  
+-   <xref:System.ServiceModel.Discovery.DynamicEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior>  
+  
+-   <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata>  
+  
+-   <xref:System.ServiceModel.Discovery.FindCriteria>  
+  
+-   <xref:System.ServiceModel.Discovery.FindRequestContext>  
+  
+-   <xref:System.ServiceModel.Discovery.FindResponse>  
+  
+-   <xref:System.ServiceModel.Discovery.ResolveCriteria>  
+  
+-   <xref:System.ServiceModel.Discovery.ResolveResponse>  
+  
+-   <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior>  
+  
+-   <xref:System.ServiceModel.Discovery.ServiceDiscoveryExtension>  
+  
+-   <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint>  
+  
+-   <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint>  
+  
+## AnnouncementClient  
+ <xref:System.ServiceModel.Discovery.AnnouncementClient> クラスは、アナウンス メッセージを送信するための同期メソッドと非同期メソッドを提供します。アナウンス メッセージには Hello と Bye の 2 種類があります。Hello メッセージは、サービスが使用可能になったことを示すために送信され、Bye メッセージは、既存のサービスが使用不可になったことを示すために送信されます。開発者は、<xref:System.ServiceModel.Discovery.AnnouncementClient> インスタンスを作成して、<xref:System.ServiceModel.Discovery.AnnouncementEndpoint> のインスタンスをコンストラクター パラメーターとして渡します。  
+  
+## AnnouncementEndpoint  
+ <xref:System.ServiceModel.Discovery.AnnouncementEndpoint> は、固定アナウンス コントラクトが設定されている標準エンドポイントを表します。サービスまたはクライアントは、これを使用して、アナウンス メッセージの送受信を行います。既定では、<xref:System.ServiceModel.Discovery.AnnouncementEndpoint> クラスは、WS\_Discovery 11 プロトコル バージョンを使用するように設定されています。  
+  
+## AnnouncementService  
+ <xref:System.ServiceModel.Discovery.AnnouncementService> は、アナウンス メッセージを受信して処理するアナウンス サービスの実装で、システムによって提供されています。Hello または Bye メッセージが受信されると、<xref:System.ServiceModel.Discovery.AnnouncementService> のインスタンスが、適切な仮想メソッド <xref:System.ServiceModel.Discovery.AnnouncementService.OnBeginOnlineAnnouncement%2A> または <xref:System.ServiceModel.Discovery.AnnouncementService.OnBeginOfflineAnnouncement%2A> を呼び出し、アナウンス イベントを発生させます。  
+  
+## DiscoveryClient  
+ <xref:System.ServiceModel.Discovery.DiscoveryClient> クラスは、使用可能なサービスを検索および解決するために、クライアント アプリケーションによって使用されます。指定されている <xref:System.ServiceModel.Discovery.FindCriteria> を基にサービスを検索し、<xref:System.ServiceModel.Discovery.ResolveCriteria> を基にサービスを解決するための同期メソッドと非同期メソッドを提供します。開発者は、<xref:System.ServiceModel.Discovery.DiscoveryClient> インスタンスを作成して、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> のインスタンスをコンストラクター パラメーターとして提供します。  
+  
+ サービスを検索するには、同期または非同期の `Find` メソッドを呼び出し、使用する検索条件が設定された <xref:System.ServiceModel.Discription.FindCriteria> インスタンスを提供します。<xref:System.ServiceModel.Discovery.DiscoveryClient> は、適切なヘッダーを設定して `Probe` メッセージを作成し、検索要求を送信します。どの時点でも、未処理の `Find` 要求が 1 つ以上存在する可能性があるため、クライアントは、受信した応答を関連付けて、応答を検証します。その後、<xref:System.ServiceModel.Discovery.FindResponse> を使用して、結果を `Find` 操作の呼び出し元に渡します。  
+  
+ 既知のサービスを解決するには、既知のサービスの <xref:System.ServiceModel.EndpointAddress> が設定された <xref:System.ServiceModel.ResolveCriteria> のインスタンスを提供する同期または非同期の `Resolve` メソッドを呼び出します。<xref:System.ServiceModel.Discovery.DiscoveryClient> は、適切なヘッダーを設定して `Resolve` メッセージを作成し、解決要求を送信します。受信された応答が未処理の解決要求と関連付けられ、その結果が、<xref:System.ServiceModel.Discovery.ResolveResponse> を使用して、`Resolve` 操作の呼び出し元に渡されます。  
+  
+ ネットワークに探索プロキシが存在し、<xref:System.ServiceModel.Discover.DiscoveryClient> がマルチキャストで探索要求を送信する場合、探索プロキシは、マルチキャスト抑制 Hello メッセージを使用して応答できます。<xref:System.ServiceModel.Discover.DiscoveryClient> は、未処理の `Find` 要求または `Resolve` 要求に対する Hello 応答を受信すると、`ProxyAvailable` イベントを発生させます。`ProxyAvailable` イベントには、探索プロキシについての <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> が含まれています。管理者は、この情報を使用して、アドホック モードからマネージ モードに切り替えるかどうかを制御できます。  
+  
+## DiscoveryEndpoint  
+ <xref:System.ServiceModel.Discovery.DiscoveryEndpoint> は、固定探索コントラクトが設定されている標準エンドポイントを表します。サービスまたはクライアントによる探索メッセージの送受信に使用されます。既定では、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> が、<xref:System.ServiceModel.Discovery.DiscoveryMode.Managed> モードと WSDiscovery11 WS\-Discovery バージョンを使用するように設定されています。  
+  
+## DiscoveryMessageSequenceGenerator  
+ <xref:System.ServiceModel.Discovery.DiscoveryMessageSequenceGenerator> は、サービスが探索メッセージまたはアナウンス メッセージを送信するときに、<xref:System.ServiceModel.Discovery.DiscoveryMessageSequence> を生成するために使用されます。  
+  
+## DiscoveryService  
+ <xref:System.ServiceModel.Discovery.DiscoveryService> 抽象クラスは、`Probe` メッセージおよび `Resolve` メッセージの受信と処理のフレームワークを提供します。`Probe` メッセージが受信されると、<xref:System.ServiceModel.Discovery.DiscoveryService> は、受信メッセージに基づいて <xref:System.ServiceModel.Discovery.FindRequestContext> のインスタンスを作成し、<xref:System.ServiceModel.Discovery.DiscoveryService.OnBeginFind%2A> 仮想メソッドを呼び出します。`Resolve` メッセージが受信されると、<xref:System.ServiceModel.Discovery.DiscoveryService> は <xref:System.ServiceModel.Discovery.DiscoveryService.OnBeginResolve%2A> 仮想メソッドを呼び出します。このクラスから継承して、カスタムの探索サービス実装を提供できます。  
+  
+## DiscoveryProxy  
+ <xref:System.ServiceModel.Discovery.DiscoveryProxy> 抽象クラスは、探索メッセージおよびアナウンス メッセージの受信と処理のフレームワークを提供します。カスタムの探索プロキシを実装するときは、このクラスを継承します。`Probe` メッセージがマルチキャストで受信されると、<xref:System.ServiceModel.Discovery.DiscoveryProxy> クラスは `BeginShouldRedirectFind` 仮想メソッドを呼び出して、マルチキャスト抑制メッセージの送信が必要かどうかを決定します。開発者の判断により、マルチキャスト抑制メッセージを送信しない場合、または、`Probe` メッセージがユニキャストで受信された場合は、受信メッセージに基づいて <xref:System.ServiceModel.Discovery.FindRequestContext> クラスのインスタンスを作成し、`OnBeginFind` 仮想メソッドを呼び出します。`Resolve` メッセージがマルチキャストで受信されると、<xref:System.ServiceModel.Discovery.DiscoveryProxy> クラスは `ShouldRedirectResolve` 仮想メソッドを呼び出して、マルチキャスト抑制メッセージの送信が必要かどうかを決定します。開発者の判断により、マルチキャスト抑制メッセージを送信しない場合、または、`Resolve` メッセージがユニキャストで受信された場合は、受信メッセージに基づいて <xref:System.ServiceModel.Discovery.ResolveCriteria> クラスのインスタンスを作成し、`OnBeginResolve` 仮想メソッドを呼び出します。Hello または Bye メッセージが受信されると、<xref:System.ServiceModel.Discovery.DiscoveryProxy> のインスタンスが、適切な仮想メソッド \(`OnBeginOnlineAnnouncement` または `OnBeingOfflineAnnouncement`\) を呼び出し、アナウンス イベントを発生させます。  
+  
+## DiscoveryVersion  
+ <xref:System.ServiceModel.Discovery.DiscoveryVersion> クラスは、使用する探索プロトコルのバージョンを表します。  
+  
+## EndpointDiscoveryBehavior  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> クラスは、エンドポイントを探索可能にするかどうかの制御と、拡張機能、追加のコントラクト型の名前、およびそのエンドポイントに関連付けるスコープの指定に使用されます。この動作は、アプリケーション エンドポイントに追加されて、そのエンドポイントの <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> を構成します。<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> がサービス ホストに追加されると、既定では、そのサービス ホストがホストしているすべてのアプリケーション エンドポイントが探索可能になります。<xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior.Enable%2A> プロパティを `false` に設定すると、特定のエンドポイントの探索を無効化できます。  
+  
+## EndpointDiscoveryMetadata  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> クラスは、サービスによって公開されるエンドポイントのバージョンに依存しない表現を提供します。これには、サービスの開発者によって指定されたエンドポイントのアドレス、リッスン URI、コントラクト型名、スコープ、メタデータのバージョン、および拡張機能が含まれます。<xref:System.ServiceModel.Discovery.FindCriteria> は、`Probe` 操作と <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> との照合中に、クライアントによって送信されます。基準が一致した場合は、<xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> がクライアントに返されます。<xref:System.ServiceModel.Discovery.ResolveCriteria> 内のエンドポイント アドレスが、<xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のエンドポイント アドレスと照合されます。基準が一致した場合は、<xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> がクライアントに返されます。  
+  
+## FindCriteria  
+ <xref:System.ServiceModel.Discovery.FindCriteria> クラスは、サービスの検索時に使用される条件の指定に使用するバージョンに依存しないクラスです。サービスを照合するための WS\-Discovery 定義の条件を完全にサポートします。また、このクラスには、照合プロセス中に使用できるカスタム値を指定するために開発者が使用できる拡張機能もあります。開発者は、開発者が検索するサービスの合計数を指定する <xref:System.ServiceModel.Discovery.FindCriteria.MaxResult%2A>、またはクライアントが応答を待機する時間を指定する値である <xref:System.ServiceModel.Discovery.FindCriteria.Duration%2A> を指定して、`Find` 操作の終了条件を設定できます。  
+  
+## FindRequestContext  
+ <xref:System.ServiceModel.Discovery.FindRequestContext> クラスは、クライアントが `Find` 操作を開始するときに受信する `Probe` メッセージに基づいて、探索サービスによってインスタンス化されます。これには、クライアントによって指定された <xref:System.ServiceModel.Discovery.FindCriteria> のインスタンスが含まれます。  
+  
+## FindResponse  
+ <xref:System.ServiceModel.Discovery.FindResponse> クラスは、`Find` 操作の応答と共に、<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> の呼び出し元に返されます。これは、<xref:System.ServiceModel.Discovery.FindCompletedEventArgs> にも存在します。これには、探索されたエンドポイントのコレクションである <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のコレクションと、<xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> および <xref:System.ServiceModel.Discovery.DiscoveryMessageSequence> のディクショナリが含まれます。  
+  
+## ResolveCriteria  
+ <xref:System.ServiceModel.Discovery.ResolveCriteria> クラスは、既知のサービスの解決時に使用される条件の指定に使用するバージョンに依存しないクラスです。これには、既知のサービスのエンドポイント アドレスが含まれます。開発者は、クライアントが応答を待機する時間を指定する <xref:System.ServiceModel.Discovery.ResolveCriteria.Duration%2A> を指定して、解決操作の終了条件を提供できます。  
+  
+## ResolveResponse  
+ <xref:System.ServiceModel.Discovery.ResolveResponse> は、`Resolve` 操作の応答と共に、<xref:System.ServiceModel.Discovery.DiscoveryClient.Resolve%2A> メソッドの呼び出し元に返されます。これは、<xref:System.ServiceModel.Discovery.ResolveCompletedEventArgs> にも存在します。これには、探索されたエンドポイントである <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のインスタンスと、<xref:System.ServiceModel.Discovery.DiscoveryMessageSequence> のインスタンスが含まれます。  
+  
+## ServiceDiscoveryBehavior  
+ <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> クラスを使用すると、探索機能をサービスに追加できます。この動作は <xref:System.ServiceModel.ServiceHost> に追加します。<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> クラスは、サービス ホストに追加されているアプリケーション エンドポイントに対して反復処理され、探索可能なエンドポイントに基づいて <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のコレクションを作成します。既定では、すべてのエンドポイントが探索可能です。特定のエンドポイントが探索可能になるかどうかは、<xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> をその特定のエンドポイントに追加することで制御できます。アナウンス エンドポイントが <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> に追加されると、サービス ホストが開かれるときまたは閉じられるときに、すべての探索可能なエンドポイントのアナウンスが、各アナウンス エンドポイントから送られます。  
+  
+## ServiceDiscoveryExtension  
+ <xref:System.ServiceModel.Discovery.ServiceDiscoveryExtension> クラスは <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> クラスによって作成されます。探索可能にされているエンドポイントは、<xref:System.ServiceModel.Discovery.ServiceDiscoveryExtension> から取得できます。このクラスは、カスタムの探索サービス実装を指定する目的でも使用されます。  
+  
+## UdpAnnouncementEndpoint  
+ <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> クラスは、UDP マルチキャスト バインディングを使用するアナウンス用に事前に構成しておく標準のアナウンス エンドポイントです。既定では、<xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> が WSApril2005 WS\_Discovery バージョンを使用するように設定されています。  
+  
+## UdpDiscoveryEndpoint  
+ <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> クラスは、UDP マルチキャスト バインディングを使用する探索のために事前に構成された標準の探索エンドポイントです。既定では、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> が、WSDiscovery11 WS\-Discovery バージョンと <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint.Adhoc> モードを使用するように設定されています。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-discovery-overview.md b/docs/framework/wcf/feature-details/wcf-discovery-overview.md
new file mode 100644
index 00000000000..ecaa291cc9c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-discovery-overview.md
@@ -0,0 +1,163 @@
+---
+title: "WCF Discovery の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84fad0e4-23b1-45b5-a2d4-c9cdf90bbb22
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# WCF Discovery の概要
+Discovery API は、WS\-Discovery プロトコルを使用した Web サービスの動的公開と探索の統合プログラミング モデルを提供します。これらの API は、サービスがサービス自体を公開し、クライアントが公開されたサービスを発見できるようにします。サービスを探索可能にした後は、サービスでアナウンス メッセージを送信できるほか、探索要求のリッスンと応答もできるようになります。探索可能なサービスは、ネットワークに接続されたことをアナウンスする Hello メッセージ、およびネットワークから切断されたことをアナウンスする Bye メッセージを送信できます。サービスを検索するために、クライアントは、サービス コントラクト型、キーワード、ネットワークのスコープなど、特定の条件が設定された `Probe` 要求を送信します。サービスはこの `Probe` 要求を受信し、条件に一致するかどうかを判断します。サービスが条件に一致した場合は、サービスへの接続に必要な情報と併せて `ProbeMatch` メッセージをクライアントに送り返すことで応答します。クライアントは `Resolve` 要求を送信することもできます。この要求では、エンドポイント アドレスが変更されている可能性があるサービスを発見できます。条件に一致したサービスは、`ResolveMatch` メッセージをクライアントに送り返すことで、`Resolve` 要求に応答します。  
+  
+## アドホック モードとマネージ モード  
+ Discovery API は、マネージとアドホックという 2 種類のモードをサポートします。マネージ モードでは、使用可能なサービスについての情報を管理する探索プロキシと呼ばれる集中サーバーがあります。探索プロキシには、さまざまな方法でサービスについての情報を設定できます。たとえば、サービスから起動中にアナウンス メッセージを探索プロキシに送信することも、探索プロキシがデータベースや構成ファイルからデータを読み取って、使用可能なサービスを特定することもできます。探索プロキシへの情報の設定方法は、開発者が決定します。クライアントは、探索プロキシを使用して、使用可能なサービスについての情報を取得します。クライアントは、サービスを検索するときに `Probe` メッセージを探索プロキシに送信します。探索プロキシは、認識しているサービスのうち、クライアントが検索しているサービスに一致するものがあるかどうかを判断します。一致するものがあった場合、探索プロキシは `ProbeMatch` 応答をクライアントに返します。クライアントは、プロキシから返されたサービスの情報を使用して、直接サービスにアクセスします。マネージ モードの基盤である最大の原則は、探索要求がユニキャストで 1 つの機構、つまり、探索プロキシに送信されることです。.NET Framework には、開発者が独自のプロキシを作成できる主要コンポーネントがあります。クライアントとサービスは、次のような複数の方法でプロキシを見つけることができます。  
+  
+-   プロキシがアドホック メッセージに応答する。  
+  
+-   プロキシが起動中にアナウンス メッセージを送信する。  
+  
+-   特定の既知のエンドポイントを検索するように、クライアントとサービスを作成する。  
+  
+ アドホック モードには、集中サーバーはありません。サービス アナウンスやクライアント要求など、すべての探索メッセージは、マルチキャストで送信されます。既定では、.NET Framework に、UDP プロトコルを利用したアドホック探索のサポートが含まれています。たとえば、起動時に Hello アナウンスを送信するようにサービスが構成されている場合、サービスは、UDP プロトコルを使用して既知のマルチキャスト アドレスからアナウンスを送信します。クライアントは、これらのアナウンスをアクティブにリッスンし、適宜処理する必要があります。クライアントが、ある特定のサービスを検索するための `Probe` メッセージを送信すると、このメッセージは、マルチキャスト プロトコルを使用してネットワーク上で送信されます。要求を受信した各サービスは、`Probe` メッセージの条件に一致するかどうかを判断し、`Probe` メッセージに指定されている条件に一致する場合は、`ProbeMatch` メッセージを使用して直接クライアントに応答します。  
+  
+## WCF Discovery を使用する利点  
+ WCF Discovery は WS\-Discovery プロトコルを使用して実装されるため、WS\-Discovery を実装するその他のクライアント、サービス、およびプロキシと相互運用可能です。WCF Discovery は既存の WCF API を基盤にしているため、既存のサービスやクライアントに簡単に探索機能を追加できます。サービスは、アプリケーション構成設定を使用して、簡単に探索可能にできます。また、WCF Discovery では、ピア ネットワーク、名前付けオーバーレイ、HTTP など、その他のトランスポートでの探索プロトコルの使用もサポートされます。WCF Discovery は、探索プロキシが使用されるマネージ モードの運用をサポートします。これにより、ネットワーク全体にマルチキャスト メッセージが送信されずに、探索プロキシに直接メッセージが送信されるため、ネットワーク トラフィックが軽減されます。WCF Discovery では、Web サービスをより柔軟に操作することもできます。たとえば、クライアントやサービスを再構成することなく、サービスのアドレスを変更できます。クライアントがサービスにアクセスする必要がある場合、`Find` 要求により `Probe` メッセージを発行すると、サービスの現在のアドレスがサービスから返されます。WCF Discovery では、クライアントは、コントラクトの種類、バインド要素、名前空間、スコープ、キーワードやバージョン番号など、異なる条件を基に特定のサービスを検索できます。WCF Discovery では、実行時および設計時にも探索が可能です。アプリケーションに探索を追加することで、フォールト トレランスや自動構成など、その他のシナリオを実現することもできます。  
+  
+## サービスの公開  
+ サービスを探索可能にするには、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> をサービス ホストに追加し、探索エンドポイントを追加して探索メッセージをリッスンする場所を指定する必要があります。次のコード例は、自己ホスト型サービスを変更して探索可能にする方法を示しています。  
+  
+```  
+Uri baseAddress = new Uri(string.Format("http://{0}:8000/discovery/scenarios/calculatorservice/{1}/",  
+        System.Net.Dns.GetHostName(), Guid.NewGuid().ToString()));  
+  
+// Create a ServiceHost for the CalculatorService type.  
+using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+{  
+    // add calculator endpoint  
+    serviceHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), string.Empty);  
+  
+    // ** DISCOVERY ** //  
+    // make the service discoverable by adding the discovery behavior  
+    serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());  
+  
+    // ** DISCOVERY ** //  
+    // add the discovery endpoint that specifies where to publish the services  
+    serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());  
+  
+    // Open the ServiceHost to create listeners and start listening for messages.  
+    serviceHost.Open();  
+  
+    // The service can now be accessed.  
+    Console.WriteLine("Press <ENTER> to terminate service.");  
+    Console.ReadLine();  
+}  
+```  
+  
+ サービスを探索可能にするには、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> のインスタンスをサービスの説明に追加する必要があります。探索要求をリッスンするサービスを指定するには、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> のインスタンスをサービス ホストに追加する必要があります。この例では、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> \(<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> から派生した\) を追加して、サービスが UDP マルチキャスト トランスポートを利用して探索要求をリッスンするように指定しています。すべてのメッセージがマルチキャストで送信されるため、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> を使用してアドホック探索が実行されるようにしています。  
+  
+## アナウンス  
+ 既定では、サービスを公開しても、アナウンス メッセージは送信されません。アナウンス メッセージを送信するように、サービスを構成する必要があります。このため、探索メッセージのリッスンとは別に、サービスをアナウンスできるため、より柔軟にサービスを作成できます。サービス アナウンスは、探索プロキシまたはその他のサービス レジストリにサービスを登録するメカニズムとしても使用できます。次のコード例は、UDP バインドを利用してアナウンス メッセージを送信するようにサービスを構成する方法を示しています。  
+  
+```  
+Uri baseAddress = new Uri(string.Format("http://{0}:8000/discovery/scenarios/calculatorservice/{1}/",  
+        System.Net.Dns.GetHostName(), Guid.NewGuid().ToString()));  
+  
+// Create a ServiceHost for the CalculatorService type.  
+using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+{  
+    // add calculator endpoint  
+    serviceHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), string.Empty);  
+  
+    // ** DISCOVERY ** //  
+    // make the service discoverable by adding the discovery behavior  
+    ServiceDiscoveryBehavior discoveryBehavior = new ServiceDiscoveryBehavior();  
+    serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());  
+  
+    // send announcements on UDP multicast transport  
+    discoveryBehavior.AnnouncementEndpoints.Add(  
+      new UdpAnnouncementEndpoint());  
+  
+    // ** DISCOVERY ** //  
+    // add the discovery endpoint that specifies where to publish the services  
+    serviceHost.Description.Endpoints.Add(new UdpDiscoveryEndpoint());  
+  
+    // Open the ServiceHost to create listeners and start listening for messages.  
+    serviceHost.Open();  
+  
+    // The service can now be accessed.  
+    Console.WriteLine("Press <ENTER> to terminate service.");  
+    Console.ReadLine();  
+}  
+```  
+  
+## サービス探索  
+ クライアント アプリケーションは、<xref:System.ServiceModel.Discovery.DiscoveryClient> クラスを使用してサービスを検索できます。開発者は、`Probe` メッセージまたは `Resolve` メッセージの送信先を指定する探索エンドポイントに渡す <xref:System.ServiceModel.Discovery.DiscoveryClient> クラスのインスタンスを作成します。クライアントは、次に、<xref:System.ServiceModel.Discovery.FindCriteria> インスタンス内に検索条件を指定する <xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> を呼び出します。一致するサービスが見つかった場合、<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> は <xref:System.ServiceModel.Discovery.EndpointDiscoveryMetadata> のコレクションを返します。次のコードは、`Find` メソッドを呼び出して、検索されたサービスに接続する方法を示しています。  
+  
+```  
+class Client  
+{  
+    static EndpointAddress serviceAddress;  
+  
+    static void Main()  
+    {  
+        if (FindService()) InvokeService();  
+    }  
+  
+    // ** DISCOVERY ** //  
+    static bool FindService()  
+    {  
+        Console.WriteLine("\nFinding Calculator Service ..");  
+        DiscoveryClient discoveryClient =   
+            new DiscoveryClient(new UdpDiscoveryEndpoint());  
+  
+        Collection<EndpointDiscoveryMetadata> calculatorServices =   
+            discoveryClient.Find(new FindCriteria(typeof(ICalculator)));  
+  
+        discoveryClient.Close();  
+  
+        if (calculatorServices.Count == 0)  
+        {  
+            Console.WriteLine("\nNo services are found.");  
+            return false;  
+        }  
+        else  
+        {  
+            serviceAddress = calculatorServices[0].EndpointAddress;  
+            return true;  
+        }  
+    }  
+  
+    static void InvokeService()  
+    {  
+        Console.WriteLine("\nInvoking Calculator Service at {0}\n", serviceAddress);  
+  
+        // Create a client  
+        CalculatorClient client = new CalculatorClient();  
+        client.Endpoint.Address = serviceAddress;  
+        client.Add(10,3);  
+}  
+```  
+  
+## 探索およびメッセージ レベルのセキュリティ  
+ メッセージ レベルのセキュリティを使用する場合は、<xref:System.ServiceModel.EndpointIdentity> をサービスの探索エンドポイントに指定し、対応する <xref:System.ServiceModel.EndpointIdentity> をクライアントの探索エンドポイントに指定する必要があります。メッセージ レベルのセキュリティ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メッセージのセキュリティ](../../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)」を参照してください。  
+  
+## 探索および Web ホスト サービス  
+ WCF サービスが探索可能であるためには、このサービスが実行されている必要があります。IIS または WAS でホストされている WCF サービスは、IIS\/WAS がサービスにバインドされているメッセージを受信するまで実行されないため、既定では探索できません。Web ホスト サービスを探索可能にするには、次の 2 つのオプションがあります。  
+  
+1.  Windows Server AppFabric の自動開始機能の使用  
+  
+2.  サービスに代わって通信を行う探索プロキシの使用  
+  
+ Windows Server AppFabric には、メッセージを受信する前にサービスを開始できる自動開始機能が備わっています。この自動開始セットで、IIS\/WAS でホストされるサービスを探索できるように構成できます。自動開始機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server AppFabric 自動開始機能](http://go.microsoft.com/fwlink/?LinkId=205545)」を参照してください。自動開始機能をオンにすると共に、探索サービスを構成する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法](../../../../docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md)[構成ファイルにおける探索の構成](../../../../docs/framework/wcf/feature-details/configuring-discovery-in-a-configuration-file.md).  
+  
+ 探索プロキシはサービスが実行されていないときに WCF サービスの代わりに通信に使用できます。このプロキシはプローブをリッスンするか、メッセージを解決して、クライアントに応答できます。これで、クライアントはメッセージをサービスに直接送信できます。クライアントがサービスにメッセージを送信する場合、インスタンス化されてメッセージに応答します。探索プロキシの実装[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[探索プロキシの実装](../../../../docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-discovery.md b/docs/framework/wcf/feature-details/wcf-discovery.md
new file mode 100644
index 00000000000..18aac79953c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-discovery.md
@@ -0,0 +1,46 @@
+---
+title: "WCF Discovery | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "探索 [WCF]"
+  - "WCF [WCF], 探索"
+  - "Windows Communication Foundation [WCF], 探索"
+ms.assetid: 462c4913-f388-45a9-9042-28ae96a4e735
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WCF Discovery
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、WS\-Discovery プロトコルを使用して、相互運用可能な方法で実行時にサービスを探索可能にするためのサポートを提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、その可用性を、マルチキャスト メッセージを使用してネットワークにアナウンスするか、探索プロキシ サーバーにアナウンスすることができます。クライアント アプリケーションは、ネットワークまたは探索プロキシ サーバーを検索して、一連の基準を満たすサービスを見つけることができます。このセクションのトピックでは、この機能の概要を示し、そのプログラミング モデルについて説明します。  
+  
+## このセクションの内容  
+ [WCF Discovery の概要](../../../../docs/framework/wcf/feature-details/wcf-discovery-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が提供する WS\-Discovery サポートの概要を示します。  
+  
+ [WCF Discovery オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-discovery-object-model.md)  
+ オブジェクト モデルのクラスと WS\-Discovery サポートの拡張性について説明します。  
+  
+ [プログラムを使用して探索可能性に WCF サービスとクライアントを追加する方法](../../../../docs/framework/wcf/feature-details/how-to-programmatically-add-discoverability-to-a-wcf-service-and-client.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを探索可能にする方法を示します。  
+  
+ [探索プロキシの実装](../../../../docs/framework/wcf/feature-details/implementing-a-discovery-proxy.md)  
+ 探索プロキシを実装するのに必要な手順、探索プロキシで登録される探索可能なサービス、および探索プロキシを使用して探索可能なサービスを検索するクライアントについて説明します。  
+  
+ [探索機能のバージョン指定](../../../../docs/framework/wcf/feature-details/discovery-versioning.md)  
+ いくつかの新しい探索機能のプロトタイプ実装の概要を示します。使用する探索バージョンを選択する方法の概要も示します。  
+  
+ [構成ファイルにおける探索の構成](../../../../docs/framework/wcf/feature-details/configuring-discovery-in-a-configuration-file.md)  
+ 構成ファイルで探索を構成する方法を示します。  
+  
+ [探索クライアント チャネルの使用](../../../../docs/framework/wcf/feature-details/using-the-discovery-client-channel.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションを記述する際に探索クライアント チャネルを使用する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-security-terminology.md b/docs/framework/wcf/feature-details/wcf-security-terminology.md
new file mode 100644
index 00000000000..8ff57a1fbd3
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-security-terminology.md
@@ -0,0 +1,194 @@
+---
+title: "WCF セキュリティ用語 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ [WCF], 用語"
+  - "セキュリティ用語集 [WCF]"
+  - "セキュリティ用語 [WCF]"
+ms.assetid: 68dde024-8e51-40ba-804f-ec52d85e9ca9
+caps.latest.revision: 14
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 14
+---
+# WCF セキュリティ用語
+セキュリティについて説明するときに使用する用語の中には、だれもが知っているとは限らないものもあります。ここでは、セキュリティ用語の一部を簡単に説明します。このトピックは、すべての項目について詳細に説明することを目的としたものではありません。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のドキュメントで使用される用語[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Communication Foundation の基本概念](../../../../docs/framework/wcf/fundamental-concepts.md)」を参照してください。  
+  
+ アクセス制御リスト \(ACL: Access Control List\)  
+ オブジェクトに適用されるセキュリティ保護のリスト。オブジェクトには、ファイル、プロセス、イベント、またはセキュリティ記述子を持つすべてのものが含まれます。ACL 内のエントリは、アクセス制御エントリ \(ACE: Access Control Entry\) と呼ばれます。ACL には、随意 ACL とシステム ACL の 2 種類があります。  
+  
+ 認証  
+ ユーザー、コンピューター、サービス、またはプロセスが、それ自身のクレームどおりのものであることを確認するプロセス。  
+  
+ 承認  
+ リソースに対するアクセスと権限を制御する行為。たとえば、あるグループのメンバーにはファイルの読み取りを許可し、そのファイルの変更は別のグループのメンバーだけに許可することです。  
+  
+ 証明機関 \(CA: Certificate Authority\) の証明書。  
+ 証明書を要求したサーバーとクライアントにサーバー認証証明書およびクライアント認証証明書を発行した CA を識別します。CA 証明書にはデジタル署名に使用する公開キーが含まれるため、*"署名証明書"* とも呼ばれます。CA がルート証明機関の場合、CA 証明書は *"ルート証明書"* と呼ばれることもあります。また、場合によっては *"サイト証明書"* とも呼ばれます。  
+  
+ CA 階層  
+ CA 階層には、複数の CA が含まれます。CA 階層は、*"ルート証明機関"* とも呼ばれる階層の最上位に到達するまで、各 CA が階層の上位にある別の CA によって証明されるように編成されています。  
+  
+ certificate  
+ エンティティとそのエンティティの公開キーに関する情報が含まれたデジタル署名付き記述。これにより、この 2 つの情報が関連付けられます。証明機関と呼ばれる信頼された組織 \(またはエンティティ\) は、エンティティがそれ自身の主張どおりのものであることを検証した後に、証明書を発行します。  
+  
+ 証明書には、さまざまな種類のデータを含めることができます。たとえば、X.509 証明書には、証明書の書式、証明書のシリアル番号、証明書の署名に使用されているアルゴリズム、証明書を発行した CA の名前、証明書を要求したエンティティの名前と公開キー、および CA の署名が含まれます。  
+  
+ 証明書ストア  
+ 一般に、証明書、証明書失効リスト \(CRL\)、および証明書信頼リスト \(CTL\) を格納する永続ストレージ。ただし、永続ストレージに格納する必要のない証明書を使用する場合は、メモリ内に証明書ストアを単独で作成し、開くことができます。  
+  
+ クレーム  
+ 送信者の ID を確立するために使用する、エンティティ間で渡される情報。たとえば、ユーザー名\/パスワード トークンや X.509 証明書などがあります。  
+  
+ クライアント証明書  
+ クライアント認証 \(Web サーバーでの Web ブラウザーの認証など\) に使用する証明書。Web ブラウザー クライアントがセキュリティで保護された Web サーバーへのアクセスを試みたときに、クライアントは証明書をサーバーに送信して、サーバーがクライアントの ID を確認できるようにします。  
+  
+ 資格情報  
+ セキュリティ プリンシパルが自身の ID を確立するために使用する、既に認証済みのログオン データ \(パスワードなど\)、または Kerberos プロトコル チケット。資格情報は、リソースへのアクセスを制御するために使用されます。  
+  
+ ダイジェスト データ  
+ 公開キー暗号化規格 \(PKCS: Public Key Cryptography Standard\) \#7 で定義されたデータ コンテンツ タイプ。任意のデータ型とコンテンツのメッセージ ハッシュ \(ダイジェスト\) で構成されます。  
+  
+ デジタル署名  
+ 送信する情報に送信者の ID をバインドするデータ。デジタル署名は、メッセージ、ファイル、またはその他のデジタル エンコードされた情報にバンドルされる場合もあれば、別々に送信される場合もあります。デジタル署名は公開キー環境で使用され、認証サービスと整合性サービスを提供します。  
+  
+ エンコーディング  
+ データをビット ストリームに変換するプロセス。エンコーディングは、データを 1 と 0 のストリームに変換するシリアル化プロセスの一部です。  
+  
+ 交換キー ペア  
+ セッション キーを暗号化するために使用する公開キーと秘密キーのペア。セッション キーを安全に保管し、他のユーザーと交換できるようにするために使用します。  
+  
+ hash  
+ 数学関数 \(「ハッシュ アルゴリズム」を参照\) を任意の量のデータに適用することによって取得される固定サイズの数値。通常、このデータには *nonce* と呼ばれるランダムなデータが含まれます。結果をより複雑にするために、サービスとクライアントの両方が nonce の交換を支援します。この結果は、*"メッセージ ダイジェスト"* とも呼ばれます。パスワードなどの機密データが暗号化されている場合でも、機密データを送信するよりハッシュ値を送信する方が安全性が高くなります。ハッシュの送信者と受信者は、受信後にハッシュを検証できるように、ハッシュ アルゴリズムと nonce について合意する必要があります。  
+  
+ ハッシュ アルゴリズム  
+ データ \(メッセージやセッション キーなど\) のある部分のハッシュ値を生成するために使用するアルゴリズム。一般的なハッシュ アルゴリズムとして、MD2、MD4、MD5、SHA\-1 などがあります。  
+  
+ Kerberos プロトコル  
+ クライアントがネットワーク認証サービスとやり取りする方法を定義するプロトコル。クライアントは、Kerberos キー配布センター \(KDC\) からチケットを取得し、接続を確立する際にこれらのチケットをサーバーに提示します。Kerberos チケットは、クライアントのネットワーク資格情報を表します。  
+  
+ ローカル セキュリティ機関 \(LSA\)  
+ ユーザーを認証し、ローカル システムにログオンさせる保護されたサブシステム。LSA は、システムのローカル セキュリティのあらゆる側面に関する情報を保持します。この情報を総称して、システムのローカル セキュリティ ポリシーと呼びます。  
+  
+ Negotiate  
+ セキュリティ サポート プロバイダー インターフェイス \(SSPI: Security Support Provider Interface\) と他のセキュリティ サポート プロバイダー \(SSP: Security Support Provider\) との間で、アプリケーション層の役割を果たす SSP。アプリケーションは、SSPI を呼び出してネットワークにログオンするときに、要求を処理する SSP を指定できます。アプリケーションが `Negotiate` を指定した場合、`Negotiate` は要求を分析し、顧客が構成したセキュリティ ポリシーに基づいて要求を処理するのに最適な SSP を選択します。  
+  
+ nonce  
+ "リプレイ" 攻撃を阻止するために使用されるランダムに生成された値。  
+  
+ 否認防止  
+ 特定のアクションを実行したユーザーを識別することにより、そのユーザーが試みたアクションへの責任を否認できないようにする機能。たとえば、ファイルが削除されたときに、システムによってユーザーの ID が必ず記録されるようにしておきます。  
+  
+ 公開キー暗号化規格 \(PKCS\)  
+ 公開キー暗号化の普及を加速するために、世界各国のセキュリティ システムの開発者の協力を得て RSA Data Security, Inc. によって作成された仕様。  
+  
+ PKCS \#7  
+ Cryptographic Message Syntax Standard。暗号化を適用できるデータ \(デジタル署名など\) の一般的な構文。PKCS \#7 は、証明書または証明書失効リスト、およびその他のメッセージ属性 \(タイムスタンプなど\) を普及させるための構文も提供します。  
+  
+ プレーンテキスト  
+ 暗号化されていないメッセージ。プレーンテキスト メッセージは、*"クリア テキスト"* メッセージと呼ばれる場合もあります。  
+  
+ 特権  
+ システム関連のさまざまな操作 \(システムのシャットダウン、デバイス ドライバーの読み込み、システム時刻の変更など\) を実行するためのユーザー権限。ユーザーのアクセス トークンには、ユーザーまたはユーザーのグループが保持する特権のリストが含まれます。  
+  
+ 秘密キー  
+ 公開キー アルゴリズムで使用するキー ペアのうち、公開されない方のキー。通常、秘密キーは、対称セッション キーの暗号化、メッセージのデジタル署名、または対応する公開キーで暗号化されたメッセージの復号化に使用されます。「公開キー」も参照してください。  
+  
+ プロセス  
+ アプリケーションが実行されるセキュリティ コンテキスト。通常、セキュリティ コンテキストはユーザーに関連付けられています。したがって、特定のプロセスで実行されるすべてのアプリケーションに、所有するユーザーのアクセス許可と特権が適用されます。  
+  
+ 公開キーと秘密キーのペア  
+ 公開キー暗号化に使用される暗号化キーのセット。各ユーザーについて、暗号化サービス プロバイダー \(CSP: Cryptographic Service Provider\) は通常、公開キーと秘密キーの 2 つのペア \(交換キー ペアとデジタル署名キー ペア\) を保持しています。この 2 つのキー ペアは、セッション間で保持されます。  
+  
+ 公開キー  
+ セッション キーまたはデジタル署名を復号化するときに通常使用される暗号化キー。公開キーは、メッセージの暗号化にも使用できます。この場合、メッセージを復号化できるのは、対応する秘密キーを持つ個人だけであることが保証されます。  
+  
+ 公開キー暗号化  
+ キーのペアを使用する暗号化。一方のキーでデータを暗号化し、もう一方のキーでデータを復号化します。これに対して、対称暗号化アルゴリズムでは、暗号化と復号化の両方に同じキーを使用します。実際には、公開キー暗号化は、対称暗号化アルゴリズムで使用するセッション キーを保護するために使用するのが一般的です。この場合、何らかのデータの暗号化に使用されたセッション キーを暗号化するために公開キーが使用され、秘密キーが復号化に使用されます。セッション キーを保護するだけでなく、公開キー暗号化を使用してメッセージにデジタル署名し \(秘密キーを使用\)、その署名を検証する \(公開キーを使用\) こともできます。  
+  
+ 公開キー基盤 \(PKI\)  
+ 公開キー アプリケーションを作成、展開、および管理するためのサービスと管理ツールの統合セットを提供するインフラストラクチャ。  
+  
+ 否認  
+ ユーザーがあるアクションを実行したことを第三者が他の方法で証明できないため、ユーザーがその事実を偽って否定できること。たとえば、ファイルを削除したユーザーがその事実を否定することに成功した場合、そのユーザーは否認したことになります。  
+  
+ root authority  
+ CA 階層の最上位にある CA。ルート証明機関は、階層の次のレベルにある CA を証明します。  
+  
+ セキュア ハッシュ アルゴリズム \(SHA\)  
+ メッセージ ダイジェストを生成するハッシュ アルゴリズム。SHA は、DSS \(Digital Signature Standard\) の DSA \(Digital Signature Algorithm\) と共に使用されます。SHA には、SHA\-1、SHA\-256、SHA\-384、および SHA\-512 の 4 種類があります。SHA\-1 は、160 ビットのメッセージ ダイジェストを生成します。SHA\-256、SHA\-384、および SHA\-512 は、それぞれ 256 ビット、384 ビット、512 ビットのメッセージ ダイジェストを生成します。SHA は、NIST \(National Institute of Standards and Technology\) と NSA \(National Security Agency\) によって開発されました。  
+  
+ SSL \(Secure Sockets Layer\)  
+ 公開キー\/秘密キー テクノロジの組み合わせを使用して、安全なネットワーク通信を行うためのプロトコル。  
+  
+ セキュリティ コンテキスト  
+ 現在有効になっているセキュリティの属性またはルール。たとえば、コンピューターに現在ログオンしているユーザーや、スマート カード ユーザーが入力した個人 ID 番号などです。SSPI の場合、セキュリティ コンテキストは、接続に関連するセキュリティ データ \(セッション キーやセッションの存続を示す情報など\) が含まれた不透明なデータ構造です。  
+  
+ セキュリティ プリンシパル  
+ セキュリティ システムによって認識されるエンティティ。プリンシパルには、人間のユーザーと共に自律プロセスを含めることができます。  
+  
+ セキュリティ サポート プロバイダー \(SSP\)  
+ 1 つ以上のセキュリティ パッケージをアプリケーションで使用できるようにすることにより SSPI を実装するダイナミック リンク ライブラリ \(DLL\)。各セキュリティ パッケージは、アプリケーションの SSPI 関数呼び出しと実際のセキュリティ モデルの関数間のマッピングを提供します。セキュリティ パッケージは、Kerberos 認証や LanMan \(Microsoft LAN Manager\) などのセキュリティ プロトコルをサポートします。  
+  
+ セキュリティ サポート プロバイダー インターフェイス \(SSPI\)  
+ Microsoft リモート プロシージャ コール \(RPC: Remote Procedure Call\) などのトランスポート レベルのアプリケーションと、Windows 分散セキュリティなどのセキュリティ プロバイダー間の共通インターフェイス。SSPI により、トランスポート アプリケーションは、複数のセキュリティ プロバイダーの中の 1 つを呼び出して、認証済みの接続を取得できます。これらの呼び出しでは、セキュリティ プロトコルの詳細を広範囲にわたり認識しておく必要はありません。  
+  
+ セキュリティ トークン サービス  
+ マルチサービス シナリオで、カスタム セキュリティ トークンを発行し、発行済みトークンを管理するよう設計されたサービス。通常、カスタム トークンは、カスタム資格情報を含む SAML \(Security Assertions Markup Language\) トークンです。  
+  
+ サーバー証明書  
+ サーバー認証 \(Web ブラウザーに対する Web サーバーの認証など\) に使用する証明書。Web ブラウザー クライアントがセキュリティで保護された Web サーバーへのアクセスを試みたときに、サーバーは証明書をブラウザーに送信して、クライアントがサーバーの ID を確認できるようにします。  
+  
+ セッション  
+ 単一のキー マテリアルの保護の元でのメッセージ交換。たとえば、SSL セッションでは、単一のキーを使用し、そのキーの下で複数のメッセージをやり取りします。  
+  
+ セッション キー  
+ 1 回使用された後に破棄される、ランダムに生成されたキー。セッション キーは対称キーです \(暗号化と復号化の両方に使用されます\)。セッション キーはメッセージと共に送信され、対象の受信者の公開キーで暗号化することで保護されます。1 つのセッション キーは、約 40 ～ 2,000 ビットのランダムな数値で構成されます。  
+  
+ 補足の資格情報  
+ 外部のセキュリティ ドメインに対してセキュリティ プリンシパルを認証する際に使用する資格情報。  
+  
+ 対称暗号化  
+ 1 つのキーを暗号化と復号化の両方に使用する暗号化。大量のデータを暗号化する場合、対称暗号化が推奨されます。一般的な対称暗号化アルゴリズムとして、RC2、RC4、および DES \(Data Encryption Standard\) があります。  
+  
+ 「公開キー暗号化」も参照してください。  
+  
+ 対称キー  
+ 暗号化と復号化の両方に使用する単一のキー。通常、セッション キーは対称キーです。  
+  
+ トークン \(アクセス トークン\)  
+ アクセス トークンには、ログオン セッションのセキュリティ情報が含まれます。システムは、ユーザーのログオン時にアクセス トークンを作成し、そのユーザーのために実行されるすべてのプロセスがトークンのコピーを保持します。トークンにより、ユーザー、ユーザーのグループ、およびユーザーの特権が識別されます。システムはトークンを使用して、セキュリティ保護可能なオブジェクトへのアクセスを制御したり、ユーザーがローカル コンピューターで実行できるシステム関連のさまざまな操作を制御したりします。アクセス トークンには、プライマリ アクセス トークンと偽装アクセス トークンの 2 種類があります。  
+  
+ トランスポート層  
+ サービスの品質と情報の正確な配信の両方に対して責任を負うネットワーク層。この層で実行されるタスクには、エラーの検出と修正も含まれます。  
+  
+ 信頼リスト \(証明書信頼リスト \(CTL: Certificate Trust List\)\)  
+ 信頼されたエンティティによって署名されている項目の定義済みリスト。CTL は、証明書のハッシュのリストやファイル名のリストなど、どのようなものでもかまいません。リスト内のすべての項目は、署名エンティティによって認証 \(承認\) されます。  
+  
+ 信頼プロバイダー  
+ 指定されたファイルが信頼できるものかどうかを判断するソフトウェア。この判断は、そのファイルに関連付けられている証明書に基づいて行われます。  
+  
+ ユーザー プリンシパル名 \(UPN\)  
+ ユーザー アカウント名 \(*"ユーザー ログイン名"* と呼ばれることもある\) と、ユーザー アカウントの検索範囲のドメインを識別するドメイン名です。これは、Windows ドメインにログオンするための標準的使用方法です。形式は、someone@example.com です \(電子メールアドレスの場合\)。  
+  
+> [!NOTE]
+>  標準の UPN 形式に加え、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、cohowinery.com\\someone のような下位レベル形式の UPN も受け入れます。  
+  
+ X.509  
+ 国際的に認知されている証明書の規格。証明書の必須部分が定義されています。  
+  
+## 参照  
+ [Windows Communication Foundation の基本概念](../../../../docs/framework/wcf/fundamental-concepts.md)   
+ [セキュリティの概念](../../../../docs/framework/wcf/feature-details/security-concepts.md)   
+ [Windows Server AppFabric のセキュリティ モデル](http://go.microsoft.com/fwlink/?LinkID=201279&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-services-and-aspnet.md b/docs/framework/wcf/feature-details/wcf-services-and-aspnet.md
new file mode 100644
index 00000000000..be53820102a
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-services-and-aspnet.md
@@ -0,0 +1,112 @@
+---
+title: "WCF サービスと ASP.NET | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b980496a-f0b0-4319-8e55-a0f0fa32da70
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# WCF サービスと ASP.NET
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを ASP.NET とサイド バイ サイドでホストし、これらを ASP.NET 互換モードでホストする方法について解説します。  
+  
+## WCF を ASP.NET とサイド バイ サイドでホストする方法  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを Internet Information Services \(IIS\) 上で稼働させる場合、これを .ASPX ページや ASMX Web サービスと同じアプリケーション ドメイン内に置くことができます。  ASP.NET には、AppDomain の管理、動的コンパイルなどの共通インフラストラクチャ サービスが組み込まれており、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と ASP.NET HTTP ランタイムのどちらにも対応しています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の既定の構成は、ASP.NET とサイド バイ サイドになっています。  
+  
+ ![WCF サービスと ASP .NET: 共有状態](../../../../docs/framework/wcf/feature-details/media/hostingwcfwithaspnet.gif "HostingWCFwithASPNET")  
+  
+ ASP.NET の HTTP ランタイムは、ASP.NET 向けの要求を処理しますが、同じ AppDomain 上で稼働していても、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに対する要求の処理には関与しません。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス モデルは、個々の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに向けられたメッセージを途中受信し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランスポート\/チャネル スタックを介して転送します。  
+  
+ この結果、サイド バイ サイド モデルは次のようになります。  
+  
+-   ASP.NET と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、AppDomain の状態を共有できます。  どちらのフレームワークも同じ AppDomain に共存できるので、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は AppDomain の状態 \(静的変数、イベントなど\) も、ASP.NET と共有できます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、ホスティング環境や伝送方式にかかわらず、動作が一貫しています。  ASP.NET HTTP ランタイムは意図的に、IIS\/ASP.NET ホスティング環境や HTTP 通信と強く結合する形で設計されています。  一方 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ホスティング環境やトランスポートの種類に関係なく同じように動作します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作は IIS の内部でも外部でも同じであり、IIS 7.0 以降でホストされているサービスは、HTTP 以外のプロトコルを使用するエンドポイントを含め、すべてのエンドポイントで動作が同じです。  
+  
+-   HTTP ランタイムに実装された機能は、同じ AppDomain 内でも、ASP.NET のコンテンツには適用されますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には適用されません。  ASP.NET アプリケーション プラットフォームに含まれている HTTP 固有の機能の多くは、ASP.NET コンテンツが含まれている AppDomain 内でホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスには適用されません。  このような機能の例を次に示します。  
+  
+    -   HttpContext : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスからアクセスされた場合、<xref:System.Web.HttpContext.Current%2A> は常に `null` を返します。  代わりに、<xref:System.ServiceModel.OperationContext.Current.RequestContext> を使用してください。  
+  
+    -   ファイル ベースの承認 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ モデルでは、サービス要求が承認済みであるかどうかを判断する際、アクセス制御リスト \(ACL\) をサービスの .svc ファイルに適用することはできません。  
+  
+    -   構成ベースの URL 承認: 同様に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ モデルでは、System.Web の \<authorization\> 構成要素で指定された、URL ベースの承認規則が順守されません。  ASP.NET の URL 承認規則によって保護された URL 空間にサービスが存在する場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 要求に関しては、これらの設定が無視されます。  
+  
+    -   HttpModule の拡張機能 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスティング インフラストラクチャは、<xref:System.Web.HttpApplication.PostAuthenticateRequest> イベントが発生すると [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に対する要求を途中受信します。ASP.NET HTTP パイプラインには制御を返しません。  したがって、パイプラインのこれ以降の段階で要求を途中受信するよう設計されたモジュールは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に対する要求を途中受信できません。  
+  
+    -   ASP.NET の偽装: 既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に対する要求は常に IIS のプロセス ID で実行されます。ASP.NET で、System.Web の \<identity impersonate\=”true” \/\> という構成オプションにより偽装を有効にしていても同様です。  
+  
+ 以上の制約は、IIS アプリケーション上で稼働する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにのみ適用されます。  ASP.NET コンテンツの動作が、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の有無によって変わることはありません。  
+  
+ 従来 HTTP パイプラインにより提供されていた機能を必要とする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に組み込まれている、同等の機能の使用を検討します。これらは、特定のホストやトランスポートに依存しません。  
+  
+-   <xref:System.ServiceModel.OperationContext> \(<xref:System.Web.HttpContext> の代わり\)  
+  
+-   <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior> \(ASP.NET のファイル ベースまたは URL ベースの承認の代わり\)  
+  
+-   <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector> または独自の階層チャネル \(HTTP モジュールの代わり\)  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] による各操作の偽装 \(System.Web による偽装の代わり\)  
+  
+ また、サービスを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ASP.NET 互換モードで実行することも検討します。  
+  
+## WCF サービスを ASP.NET 互換モードで提供する方法  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] モデルはホスティング環境やトランスポートにかかわらず一貫した動作をするように設計されていますが、アプリケーションによっては、このレベルの柔軟性が必要とされない場合も少なくありません。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ASP.NET 互換モードはこのように、IIS 以外で動作したり、HTTP 以外のプロトコルで通信したりする必要がない代わりに、ASP.NET Web アプリケーション プラットフォームのあらゆる機能を活用したい場合に適しています。  
+  
+ 既定であるサイド バイド サイドの構成では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスティング インフラストラクチャが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージを途中受信し、HTTP パイプラインを使用せずに処理されました。これと異なり、ASP.NET 互換モードで実行される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、ASP.NET の HTTP 要求と同じライフサイクルになります。  互換モードでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、<xref:System.Web.IHttpHandler> を実装することにより HTTP パイプラインを使用します。これはASPX ページや ASMX Web サービスに対する要求を処理する方法と同じです。  したがって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、次に挙げるような ASP.NET の機能に関して、ASMX とまったく同じように動作します。  
+  
+-   ASP.NET 互換モードで動作する <xref:System.Web.HttpContext>: [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、<xref:System.Web.HttpContext.Current%2A> やこれに関連する状態にアクセスできます。  
+  
+-   ファイル ベースの承認 : ASP.NET 互換モードで稼動する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、ファイル システムのアクセス制御リスト \(ACL\) をサービスの .svc ファイルに関連付けることによって、セキュリティで保護されます。  
+  
+-   URL 承認の設定 : ASP.NET の URL 承認規則は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービスが ASP.NET 互換モードで動作していれば、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に対する要求にも適用されます。  
+  
+-   <xref:System.Web.HttpModuleCollection> の拡張機能 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを ASP.NET 互換モードで実行した場合は、ASP.NET の HTTP 要求と同じライフサイクルになるので、HTTP パイプラインに構成された HTTP モジュールはすべて、サービス起動の前後で、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に対する要求を処理できます。  
+  
+-   ASP.NET の偽装 : [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、ASP.NET の偽装されたスレッドの ID で動作します。アプリケーションで ASP.NET の偽装が有効になっている場合、これは IIS プロセスの ID とは異なります。  特定のサービス操作に対して ASP.NET と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の両方の偽装が有効になっている場合、サービスは最終的に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] から取得された ID で動作します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ASP.NET 互換モードは、アプリケーションごとに、その Web.config ファイルに次のような記述をすることにより有効になります。  
+  
+```  
+<system.serviceModel>  
+    <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />  
+</system.serviceModel>  
+```  
+  
+ 既定値は `true` です。  値が "`false`" に設定されている場合は、アプリケーションで動作する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスがすべて、ASP.NET 互換モードでは実行されないことを示します。  
+  
+ ASP.NET 互換モードでは、要求の処理方法が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の既定の構成とまったく異なるので、個々のサービス実装は、ASP.NET 互換モードが有効化されているアプリケーション内で動作するかどうかを制御できます。  各サービスは、ASP.NET 互換モードをサポートするかどうかを、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> で示すことができます。  この属性の既定値は <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> です。  
+  
+ `[AspNetCompatibilityRequirements(RequirementsMode = AspNetCompatibilityRequirementsMode.Allowed)]`  
+  
+ `public class CalculatorService : ICalculatorSession`  
+  
+ `{//Implement calculator service methods.}`  
+  
+ アプリケーション全体を互換モードにしたとき、個々のサービスのサポート レベルがどうなるかを表に示します。  
+  
+|アプリケーション全体の互換モード設定|AspNetCompatibilityRequirementsMode<br /><br /> 設定|実際の動作|  
+|------------------------|------------------------------------------------|-----------|  
+|aspNetCompatibilityEnabled \= “`true`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスは正常に動作します。|  
+|aspNetCompatibilityEnabled \= “`true`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスは正常に動作します。|  
+|aspNetCompatibilityEnabled \= “`true`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスがメッセージを受信した時点でアクティベーション エラーが発生します。|  
+|aspNetCompatibilityEnabled \= “`false`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスがメッセージを受信した時点でアクティベーション エラーが発生します。|  
+|aspNetCompatibilityEnabled \= “`false`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスは正常に動作します。|  
+|aspNetCompatibilityEnabled \= “`false`”|<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>|サービスは正常に動作します。|  
+  
+> [!NOTE]
+>  IIS 7.0 や WAS 上で稼働する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、HTTP 以外のプロトコルでも通信できます。  しかし [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが ASP.NET 互換モードのアプリケーション上で動作している場合、HTTP 以外のエンドポイントと通信することはできません。  最初のメッセージを受信した時点で、アクティベーション例外が発生します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの ASP.NET 互換モードの有効化の詳細については、「<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode>」と「[ASP.NET 互換性](../../../../docs/framework/wcf/samples/aspnet-compatibility.md)」のサンプルを参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute>   
+ [AppFabric のホスティング機能](http://go.microsoft.com/fwlink/?LinkId=201276)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-syndication-overview.md b/docs/framework/wcf/feature-details/wcf-syndication-overview.md
new file mode 100644
index 00000000000..d3e38b31bfe
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-syndication-overview.md
@@ -0,0 +1,32 @@
+---
+title: "WCF 配信の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: af6d4c39-e5e8-4099-aee6-5261feff9107
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# WCF 配信の概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスから配信フィードを公開することができます。配信は、サーバーがフィードと呼ばれる相互運用可能な形式でアプリケーション データの一部を公開するためのアプリケーション統合の機構です。フィードはアプリケーション データのコレクションであり、フィード レベルのメタデータ \(タイトル、作成者、URL、およびその他のメタデータ\) と一連のフィード アイテムから構成されます。フィード内で、フィード アイテムは通常、発生の逆順に並べられます。フィード アイテムは、アイテム レベルのメタデータの標準セット \(タイトル、URL、作成日時、カテゴリ、およびその他のアイテム レベルのメタデータ\) と任意の大きさのアプリケーション固有のデータから構成されます。最も一般的な配信フィードは、RSS \(Really Simple Syndication\) 2.0 と Atom 1.0 であり、どちらも [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でサポートされています。  
+  
+## オブジェクト モデル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.Syndication.SyndicationFeed>、<xref:System.ServiceModel.Syndication.SyndicationItem>、<xref:System.ServiceModel.Syndication.SyndicationPerson>、<xref:System.ServiceModel.Syndication.SyndicationLink> など、配信専用の一連のクラスが定義されており、フィード、フィード アイテム、および関連するメタデータを形式に依存しない方法で処理できます。また [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、<xref:System.ServiceModel.Syndication.Atom10FeedFormatter> や <xref:System.ServiceModel.Syndication.RSS20FeedFormatter> など、WCF REST プログラミング モデル上で配信をサポートするために構築されるインフラストラクチャ クラスも定義されています。フィード フォーマッタ クラスは、オブジェクト モデルの RSS 2.0 と Atom 1.0 に対する双方向のシリアル化をサポートしています。  
+  
+## シナリオ  
+ 現在、配信はブログで広く使用されています。ブログの作成者は、さまざまな種類の情報を定期的に公開します。たとえば、文字、画像、音声などの情報です。多くの新聞や雑誌でも、配信を使用してニュースや記事を公開しています。このようなフィードを定期受信することで、ユーザーはこれらのサイトから発信されるすべての最新情報を得ることができます。配信は一般的にブログや出版社で使用されますが、一連の情報を公開する任意のアプリケーションで使用することもできます。たとえば、配信フィードを使用したバグ データベースの公開が考えられます。この場合は、`CodeDefects` という操作を公開する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを作成できます。この操作では、調べたいバグを報告した人の電子メール アドレスを指定するパラメーターを使用できます。クライアントは、http:\/\/someserver\/bugDatabase\/CodeDefects?user\=johndoe という URL を使用して、この操作を呼び出すことができます。  
+  
+## 配信フォーマット  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の配信プラットフォームでは、RSS 2.0 と Atom 1.0 をサポートしています。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-syndication.md b/docs/framework/wcf/feature-details/wcf-syndication.md
new file mode 100644
index 00000000000..e37f634a077
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-syndication.md
@@ -0,0 +1,52 @@
+---
+title: "WCF 配信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配信 [WCF]"
+ms.assetid: ebf80384-0fc9-4919-a1e8-23ca2a13e300
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# WCF 配信
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、Atom、RSS、またはその他の独自の形式の配信フィードを簡単に扱うためのサポートが用意されています。これを利用して、配信フィードの読み取りや作成を行ったり、サービス エンドポイントで配信フィードを公開したりできます。  このセクションのトピックでは、配信用のこのプログラミング モデルについて詳細に説明します。  
+  
+## このセクションの内容  
+ [WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供される配信サポートの概要について説明します。  
+  
+ [配信のアーキテクチャ](../../../../docs/framework/wcf/feature-details/architecture-of-syndication.md)  
+ オブジェクト モデルのクラスと配信の拡張について説明します。  
+  
+ [WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法](../../../../docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md)  
+ WCF 配信オブジェクト モデルにおけるフィードの表現方法と RSS フィードおよび ATOM フィードへの変換方法について説明します。  
+  
+ [方法 : 基本的な RSS フィードを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-rss-feed.md)  
+ 基本的な RSS フィードを利用できるようにするサービスの作成方法について説明します。  
+  
+ [方法 : 基本的な ATOM フィードを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-atom-feed.md)  
+ 基本的な ATOM フィードを利用できるようにするサービスの作成方法について説明します。  
+  
+ [方法 : Atom および RSS の両方としてフィードを公開する](../../../../docs/framework/wcf/feature-details/how-to-expose-a-feed-as-both-atom-and-rss.md)  
+ ATOM と RSS で同じフィードを利用できるようにするサービスの作成方法について説明します。  
+  
+ [配信の拡張](../../../../docs/framework/wcf/feature-details/syndication-extensibility.md)  
+ カスタム要素と属性を配信フィードに追加するメソッドについて説明します。  
+  
+## 関連項目  
+  
+## 関連項目  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [部分信頼](../../../../docs/framework/wcf/feature-details/partial-trust.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-error-handling.md b/docs/framework/wcf/feature-details/wcf-web-http-error-handling.md
new file mode 100644
index 00000000000..77c6a017aa4
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-error-handling.md
@@ -0,0 +1,64 @@
+---
+title: "WCF Web HTTP エラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02891563-0fce-4c32-84dc-d794b1a5c040
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WCF Web HTTP エラー処理
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web HTTP エラー処理では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP サービスからエラーを返すことができます。このサービスは、HTTP 状態コードを指定し、操作と同じ形式 \(XML、JSON など\) を使用してエラーの詳細を返します。  
+  
+## WCF Web HTTP エラー処理  
+ <xref:System.ServiceModel.Web.WebFaultException> クラスは、HTTP 状態コードを指定できるようにするコンストラクターを定義します。この状態コードは、クライアントに返されます。<xref:System.ServiceModel.Web.WebFaultException> クラスのジェネリック バージョンである <xref:System.ServiceModel.Web.WebFaultException%601> を使用すると、発生したエラーに関する情報を格納しているユーザー定義型を返すことができます。このカスタム オブジェクトは、操作で定義された形式を使用してシリアル化され、クライアントに返されます。次の例は、HTTP 状態コードを返す方法を示しています。  
+  
+```  
+Public string Operation1()  
+{   // Operation logic  
+   // ...  
+   Throw new WebFaultException(HttpStatusCode.Forbidden);  
+}  
+```  
+  
+ 次の例は、HTTP 状態コードおよび追加情報をユーザー定義型で返す方法を示しています。`MyErrorDetail` は、発生したエラーに関する追加情報を格納しているユーザー定義型です。  
+  
+```  
+Public string Operation2()  
+   // Operation logic  
+   // ...   MyErrorDetail detail = new MyErrorDetail  
+   {  
+      Message = “Error Message”,  
+      ErrorCode = 123,  
+   }  
+   throw new WebFaultException<MyErrorDetail>(detail, HttpStatusCode.Forbidden);  
+}  
+```  
+  
+ このコードは、禁止されている状態コード、および `MyErrorDetails` オブジェクトのインスタンスを格納している本文と共に、HTTP 応答を返します。`MyErrorDetails` オブジェクトの形式は、次の値によって決まります。  
+  
+-   サービス操作で指定された <xref:System.ServiceModel.Web.WebGetAttribute> 属性または <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性の `ResponseFormat` パラメーターの値。  
+  
+-   <xref:System.ServiceModel.Description.WebHttpBehavior.AutomaticFormatSelectionEnabled%2A> の値。  
+  
+-   <xref:System.ServiceModel.Web.OutgoingWebResponseContext.Format%2A> プロパティの値 \(<xref:System.ServiceModel.Web.OutgoingWebResponseContext> にアクセスして取得\)。  
+  
+ これらの値が操作の形式にどのように影響するか [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF Web HTTP 形式](../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)」を参照してください。  
+  
+ <xref:System.ServiceModel.Web.WebFaultException> は <xref:System.ServiceModel.FaultException> であるため、SOAP エンドポイントと Web HTTP エンドポイントを公開するサービスのエラー例外プログラミング モデルとして使用できます。  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [WCF Web HTTP 形式](../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)   
+ [エラーの定義と指定](../../../../docs/framework/wcf/defining-and-specifying-faults.md)   
+ [例外とエラーの処理](../../../../docs/framework/wcf/extending/handling-exceptions-and-faults.md)   
+ [エラーの送受信](../../../../docs/framework/wcf/sending-and-receiving-faults.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-formatting.md b/docs/framework/wcf/feature-details/wcf-web-http-formatting.md
new file mode 100644
index 00000000000..ec7f124b8aa
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-formatting.md
@@ -0,0 +1,182 @@
+---
+title: "WCF Web HTTP 形式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2414896-5463-41cd-b0a6-026a713eac2c
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WCF Web HTTP 形式
+WCF Web HTTP プログラミング モデルでは、サービス操作で返す応答の最適な形式を動的に判断できます。  適切な形式を判断するための方法として、自動と明示的の 2 つがサポートされます。  
+  
+## 自動書式  
+ 有効にした場合は、応答を返す最適な形式が自動選択によって選択されます。  最適な形式の判断は、次の項目をこの順序で確認することで行われます。  
+  
+1.  要求メッセージの Accept ヘッダーのメディアの種類。  
+  
+2.  要求メッセージのコンテンツの種類。  
+  
+3.  その処理での既定の形式設定。  
+  
+4.  WebHttpBehavior での既定の形式設定。  
+  
+ 要求メッセージに Accept ヘッダーが含まれる場合は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] インフラストラクチャがサポートする種類がインフラストラクチャで検索されます。  `Accept` ヘッダーにメディアの種類のプロパティが指定されている場合は、それに従います。  適切な形式が `Accept` ヘッダーで見つからない場合は、要求メッセージのコンテンツの種類が使用されます。  適切なコンテンツの種類が指定されていない場合は、その操作の既定の形式設定が使用されます。  既定の形式は、<xref:System.ServiceModel.Web.WebGetAttribute> の `ResponseFormat` パラメーターおよび <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性で設定されます。  その操作に既定の形式が指定されていない場合は、<xref:System.ServiceModel.Description.WebHttpBehavior.DefaultOutgoingResponseFormat%2A> プロパティの値が使用されます。  形式の自動選択は、<xref:System.ServiceModel.Description.WebHttpBehavior.AutomaticFormatSelectionEnabled%2A> プロパティに依存します。  このプロパティが `true` に設定されている場合は、使用する最適な形式が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャで決定されます。  形式の自動選択は、既定で、下位互換性のために無効になっています。  形式の自動選択は、プログラムで有効にすることも、構成ファイルを使用して有効にすることもできます。  形式の自動選択をコードで有効にする方法を次の例に示します。  
+  
+```  
+// This code assumes the service name is MyService and the service contract is IMyContract     
+Uri baseAddress = new Uri("http://localhost:8000");  
+  
+WebServiceHost host = new WebServiceHost(typeof(MyService), baseAddress)  
+try  
+{  
+   ServiceEndpoint sep = host.AddServiceEndpoint(typeof(IMyContract), new WebHttpBinding(), "");  
+   // Check it see if the WebHttpBehavior already exists  
+   WebHttpBehavior whb = sep.Behaviors.Find<WebHttpBehavior>();  
+  
+   if (whb != null)  
+   {  
+      whb.AutomaticFormatSelectionEnabled = true;  
+   }  
+   else  
+   {  
+      WebHttpBehavior webBehavior = new WebHttpBehavior();  
+      webBehavior.AutomaticFormatSelectionEnabled = true;  
+      sep.Behaviors.Add(webBehavior);  
+   }  
+         // Open host to start listening for messages  
+   host.Open();        
+  
+  // ...  
+}  
+  catch(CommunicationException ex)  
+  {  
+     Console.WriteLine(“An exception occurred: “ + ex.Message());  
+  }  
+  
+```  
+  
+ 形式の自動選択は、構成ファイルを使用して有効にすることもできます。  <xref:System.ServiceModel.Description.WebHttpBehavior.AutomaticFormatSelectionEnabled%2A> プロパティは、<xref:System.ServiceModel.Description.WebHttpBehavior> で直接、または <xref:System.ServiceModel.Description.WebHttpEndpoint> を使用して設定できます。  形式の自動選択を <xref:System.ServiceModel.Description.WebHttpBehavior> で有効にする方法を次の例に示します。  
+  
+```  
+<system.serviceModel>  
+  <behaviors>  
+    <endpointBehaviors>  
+      <behavior>  
+        <webHttp automaticFormatSelectionEnabled="true" />  
+      </behavior>  
+    </endpointBehaviors>  
+  </behaviors>  
+  <standardEndpoints>  
+    <webHttpEndpoint>  
+      <!-- the "" standard endpoint is used by WebServiceHost for auto creating a web endpoint. -->  
+      <standardEndpoint name="" helpEnabled="true" />  
+    </webHttpEndpoint>  
+  </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+ 形式の自動選択を、<xref:System.ServiceModel.Description.WebHttpEndpoint> を使用して有効にする方法を次の例に示します。  
+  
+```  
+<system.serviceModel>  
+    <standardEndpoints>  
+      <webHttpEndpoint>  
+        <!-- the "" standard endpoint is used by WebServiceHost for auto creating a web endpoint. -->  
+        <standardEndpoint name="" helpEnabled="true" automaticFormatSelectionEnabled="true"  />  
+      </webHttpEndpoint>  
+    </standardEndpoints>  
+  </system.serviceModel>  
+```  
+  
+## 形式の明示的な選択  
+ 名前が示すように、形式の明示的な選択では、操作コード内に使用する最適な形式を開発者が判断します。  最適な形式が XML または JSON の場合は、開発者が <xref:System.ServiceModel.Web.OutgoingWebResponseContext.Format%2A> を <xref:System.ServiceModel.Web.WebMessageFormat> または <xref:System.ServiceModel.Web.WebMessageFormat> のいずれかに設定します。  <xref:System.ServiceModel.Web.OutgoingWebResponseContext.Format%2A> プロパティが明示的に設定されていない場合は、その操作の既定の形式が使用されます。  
+  
+ 次の例では、使用する形式に対する形式クエリ文字列パラメーターを確認します。  指定されている場合、その操作の形式は <xref:System.ServiceModel.Web.OutgoingWebResponseContext.Format%2A> を使用して設定されます。  
+  
+```  
+public class Service : IService  
+{  
+    [WebGet]  
+     public string EchoWithGet(string s)  
+    {  
+         // if a format query string parameter has been specified, set the response format to that. If no such  
+         // query string parameter exists the Accept header will be used  
+        string formatQueryStringValue = WebOperationContext.Current.IncomingRequest.UriTemplateMatch.QueryParameters["format"];  
+        if (!string.IsNullOrEmpty(formatQueryStringValue))  
+        {  
+             if (formatQueryStringValue.Equals("xml", System.StringComparison.OrdinalIgnoreCase))  
+             {  
+                  WebOperationContext.Current.OutgoingResponse.Format = WebMessageFormat.Xml;  
+             }  
+             else if (formatQueryStringValue.Equals("json", System.StringComparison.OrdinalIgnoreCase))  
+            {  
+                WebOperationContext.Current.OutgoingResponse.Format = WebMessageFormat.Json;  
+            }  
+            else  
+            {  
+                 throw new WebFaultException<string>(string.Format("Unsupported format '{0}'", formatQueryStringValue), HttpStatusCode.BadRequest);  
+            }  
+        }  
+        return "You said " + s;  
+    }  
+```  
+  
+ XML または JSON 以外の形式をサポートする必要がある場合は、操作に <xref:System.ServiceModel.Channels.Message> の戻り値の型があるように定義します。  操作コード内で、使用する適切な形式を決定し、次のメソッドのいずれかを使用して <xref:System.ServiceModel.Channels.Message> オブジェクトを作成します。  
+  
+-   `WebOperationContext.CreateAtom10Response`  
+  
+-   `WebOperationContext.CreateJsonResponse`  
+  
+-   `WebOperationContext.CreateStreamResponse`  
+  
+-   `WebOperationContext.CreateTextResponse`  
+  
+-   `WebOperationContext.CreateXmlResponse`  
+  
+ これらの各メソッドでは、この適切な形式でコンテンツを取得してメッセージを作成します。  `WebOperationContext.Current.IncomingRequest.GetAcceptHeaderElements` メソッドは、クライアントで優先される形式の一覧を優先度が高い順に取得するために使用できます。  次の例では、`WebOperationContext.Current.IncomingRequest.GetAcceptHeaderElements` を使用して使用形式を決定し、適切な作成応答メソッドを使用して応答メッセージを作成する方法を示します。  
+  
+```  
+  
+public class Service : IService  
+{  
+    public Message EchoListWithGet(string list)  
+    {  
+        List<string> returnList = new List<string>(list.Split(new char[] { ',' }, StringSplitOptions.RemoveEmptyEntries));  
+        IList<ContentType> acceptHeaderElements = WebOperationContext.Current.IncomingRequest.GetAcceptHeaderElements();  
+        for (int x = 0; x < acceptHeaderElements.Count; x++)  
+        {  
+            string normalizedMediaType = acceptHeaderElements[x].MediaType.ToLowerInvariant();  
+            switch (normalizedMediaType)  
+            {  
+                case "image/jpeg": return CreateJpegResponse(returnList);  
+                case "application/xhtml+xml": return CreateXhtmlResponse(returnList);  
+                case "application/atom+xml": return CreateAtom10Response(returnList);  
+                case "application/xml": return CreateXmlResponse(returnList);  
+                case "application/json": return CreateJsonResponse(returnList);  
+          }  
+    }  
+  
+    // Default response format is XML  
+    return CreateXmlResponse(returnList);  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ <xref:System.UriTemplate>   
+ <xref:System.UriTemplateMatch>   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [UriTemplate と UriTemplateTable](../../../../docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md)   
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)   
+ [WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md b/docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md
new file mode 100644
index 00000000000..cab09d29727
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md
@@ -0,0 +1,156 @@
+---
+title: "WCF Web HTTP プログラミング モデルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 381fdc3a-6e6c-4890-87fe-91cca6f4b476
+caps.latest.revision: 45
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 45
+---
+# WCF Web HTTP プログラミング モデルの概要
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] WEB HTTP プログラミング モデルは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での WEB HTTP サービスの構築に必要な基本的な要素を提供します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP サービスは、Web ブラウザーも含めて、最大限の幅広いクライアントからアクセスできるように設計されており、次の固有の要件があります。  
+  
+-   **URI および URI 処理** URI は、WEB HTTP サービスのデザインで中心的な役割を果たします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルでは、<xref:System.UriTemplate> クラスおよび <xref:System.UriTemplateTable> クラスを使用して、URI 処理機能を提供します。  
+  
+-   **GET 操作と POST 操作のサポート** WEB HTTP サービスは、データ変更やリモート呼び出しに必要なさまざまな起動用の動詞に加えて、データ取得用に GET 動詞を使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルは、<xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用して、サービス操作を GET 動詞や PUT、POST、DELETE などの他の HTTP 動詞に関連付けます。  
+  
+-   **複数のデータ形式** Web スタイル サービスは SOAP メッセージ以外にもさまざまな種類のデータを処理します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルは、<xref:System.ServiceModel.WebHttpBinding> および <xref:System.ServiceModel.Description.WebHttpBehavior> を使用して、XML ドキュメント、JSON データ オブジェクト、バイナリ コンテンツのストリーム \(イメージ、ビデオ ファイル、プレーンテキスト\) など、さまざまなデータ形式をサポートします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の扱う範囲を拡大し、WEB HTTP サービス、AJAX および JSON サービス、配信 \(ATOM および RSS\) フィードを使用する Web スタイルのシナリオも対象とします。AJAX および JSON サービス[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[AJAX の統合と JSON のサポート](../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)」を参照してください。配信[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)」を参照してください。  
+  
+ WEB HTTP サービスから返されるデータの種類に追加の制限はありません。WEB HTTP サービス操作からは任意のシリアル化可能な型を返すことができます。WEB HTTP サービス操作は Web ブラウザーによって呼び出すことができるため、URL に指定できるデータ型に制限があります。既定でサポートされる型の詳細については、以下の「**UriTemplate クエリ文字列パラメーターと URL**」を参照してください。既定の動作は、URL で指定されたパラメーターから実際のパラメーター型への変換方法を指定する独自の T:System.ServiceModel.Dispatcher.QueryStringConverter 実装を提供することで変更できます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Dispatcher.QueryStringConverter>  
+  
+> [!CAUTION]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルで記述されたサービスでは、SOAP メッセージは使用されません。SOAP が使用されないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって提供されるセキュリティ機能を使用することはできません。ただし、HTTPS でサービスをホストすることによってトランスポート ベースのセキュリティを使用できます。[!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ[セキュリティの概要](../../../../docs/framework/wcf/feature-details/security-overview.md)  
+  
+> [!WARNING]
+>  IIS の WebDAV 拡張をインストールすると、WebDAV 拡張がすべての PUT 要求を処理しようとしたときに Web HTTP サービスが HTTP 405 エラーを返すことがあります。この問題を解決するには、WebDAV 拡張をアンインストールするか、Web サイトの WebDAV 拡張を無効にします。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][IIS および WebDav](http://learn.iis.net/page.aspx/357/webdav-for-iis-70/)  
+  
+## UriTemplate および UriTemplateTable を使用した URI 処理  
+ URI テンプレートには、構造的に類似する URI の大規模なセットを効率的に表現するための構文が備わっています。たとえば、テンプレート a\/{segment}\/c は、中間のセグメントの値を問わず、"a" で始まり "c" で終了する 3 つのセグメントから成る URI のセットを表しています。  
+  
+ このテンプレートによって、次のような URI が記述されます。  
+  
+-   a\/x\/c  
+  
+-   a\/y\/c  
+  
+-   a\/z\/c  
+  
+-   など。  
+  
+ このテンプレートでは、中かっこによる表記 \("{segment}"\) で、リテラル値ではなく、変数のセグメントを示しています。  
+  
+ .NET Framework は <xref:System.UriTemplate> という URI テンプレートでの作業に使用できる新しい API を提供します。`UriTemplates` を使用すると、次のことができます。  
+  
+-   一連のパラメーターで `Bind` メソッドの 1 つを呼び出し、テンプレートに適合する*完全にクローズである URI* を生成できます。つまり、URI テンプレート内の変数がすべて、実際の値に置き換えられます。  
+  
+-   候補の URI を使用して `Match`\(\) を呼び出すことができます。このメソッドは、テンプレートを使用して候補の URI を構成要素に分解し、テンプレート内の変数に従って分類される URI のさまざまな要素を収めたディクショナリを返します。  
+  
+-   `Bind`\(\) と `Match`\(\) は逆のもので、`Match`\( `Bind`\( x \) \) を呼び出し、最初と同じ環境に戻ることができます。  
+  
+ 包含されたテンプレートを個別に扱うことができるデータ構造内の一連の <xref:System.UriTemplate> オブジェクトを追跡することが必要になる場合がよくあります \(特に、URI に基づいて要求をサービス操作にディスパッチすることが必要なサーバー上\)。<xref:System.UriTemplateTable> は、URI テンプレートのセットを表し、テンプレート セットと候補の URI が与えられると、最適の組み合わせを選択します。これは、特定のネットワーク スタックと結び付いていないので \([!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を含む\)、必要な場合はいつでも使用できます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モデルは、<xref:System.UriTemplate> および <xref:System.UriTemplateTable> を使用して、<xref:System.UriTemplate> によって記述された URI セットにサービス操作を関連付けます。サービス操作は、<xref:System.ServiceModel.Web.WebGetAttribute> または <xref:System.ServiceModel.Web.WebInvokeAttribute> によって <xref:System.UriTemplate> に関連付けられます。<xref:System.UriTemplate> および <xref:System.UriTemplateTable>[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[UriTemplate と UriTemplateTable](../../../../docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md)」を参照してください。  
+  
+## WebGet および WebInvoke 属性  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP サービスは、さまざまな呼び出し用の動詞 \(HTTP POST、PUT、DELETE など\) に加えて、データ取得のための動詞 \(HTTP GET など\) を使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルでは、サービスの開発者は <xref:System.ServiceModel.Web.WebGetAttribute> と <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用して、URI テンプレートと、各自のサービス操作に関連付けられた動詞を共に制御できます。<xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用すると、個々の操作を URI と、それらの URI に関連付けられている HTTP メソッドにバインドする方法を制御できます。たとえば、次のコードでは、<xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> を追加します。  
+  
+```  
+[ServiceContract]  
+interface ICustomer  
+{  
+  //"View It"  
+  
+  [WebGet]  
+  Customer GetCustomer():  
+  
+  //"Do It"  
+    [WebInvoke]  
+  Customer UpdateCustomerName( string id,   
+                               string newName );  
+}  
+```  
+  
+ 上記のコードを使用すると、次の HTTP 要求を行うことができます。  
+  
+ `GET /GetCustomer`  
+  
+ `POST /UpdateCustomerName`  
+  
+ <xref:System.ServiceModel.Web.WebInvokeAttribute> は、既定で POST に設定されていますが、他の動詞にも使用できます。  
+  
+```  
+[ServiceContract]  
+interface ICustomer  
+{  
+  //"View It" -> HTTP GET  
+    [WebGet( UriTemplate="customers/{id}" )]  
+  Customer GetCustomer( string id ):  
+  
+  //"Do It“ -> HTTP PUT  
+  [WebInvoke( UriTemplate="customers/{id}", Method="PUT" )]  
+  Customer UpdateCustomer( string id, Customer newCustomer );  
+}  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルを使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのサンプル全体を確認するには、「[方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md)」を参照してください。  
+  
+## UriTemplate クエリ文字列パラメーターと URL  
+ サービス操作に関連付けられた URL を入力することによって、Web ブラウザーから Web スタイルのサービスを呼び出すことができます。このようなサービス操作は、文字列形式で指定する必要があるクエリ文字列パラメーターを URL 内で受け取ることができます。次の表に、URL 内で渡すことができる型と、使用される形式を示します。  
+  
+|型|Format|  
+|-------|------------|  
+|<xref:System.Byte>|0 \- 255|  
+|<xref:System.SByte>|\-128 \- 127|  
+|<xref:System.Int16>|\-32768 \- 32767|  
+|<xref:System.Int32>|\-2,147,483,648 \- 2,147,483,647|  
+|<xref:System.Int64>|\-9,223,372,036,854,775,808 \- 9,223,372,036,854,775,807|  
+|<xref:System.UInt16>|0 \- 65535|  
+|<xref:System.UInt32>|0 \- 4,294,967,295|  
+|<xref:System.UInt64>|0 \- 18,446,744,073,709,551,615|  
+|<xref:System.Single>|\-3.402823e38 \- 3.402823e38 \(指数表記は要求されない\)|  
+|<xref:System.Double>|\-1.79769313486232e308 \- 1.79769313486232e308 \(指数表記は要求されない\)|  
+|<xref:System.Char>|任意の 1 文字|  
+|<xref:System.Decimal>|標準表記による任意の小数 \(指数なし\)|  
+|<xref:System.Boolean>|True または False \(大文字と小文字は区別されません\)|  
+|<xref:System.String>|任意の文字列 \(null 文字列はサポートされず、エスケープは行われない\)|  
+|<xref:System.DateTime>|MM\/DD\/YYYY<br /><br /> MM\/DD\/YYYY HH:MM:SS \[AM&#124;PM\]<br /><br /> 月 日 年<br /><br /> 月 日 年 HH:MM:SS \[AM&#124;PM\]|  
+|<xref:System.TimeSpan>|DD.HH:MM:SS<br /><br /> DD \= 日、HH \= 時、MM \= 分、SS \= 秒|  
+|<xref:System.Guid>|GUID。たとえば、次のようになります。<br /><br /> 936DA01F\-9ABD\-4d9d\-80C7\-02AF85C822A8|  
+|<xref:System.DateTimeOffset>|MM\/DD\/YYYY HH:MM:SS MM:SS<br /><br /> DD \= 日、HH \= 時、MM \= 分、SS \= 秒|  
+|列挙体|列挙値。たとえば、次のコードのように列挙体を定義します。<br /><br /> `public enum Days{ Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday };`<br /><br /> クエリ文字列に、任意の列挙値 \(またはそれぞれに対応する integer 値\) を指定できます。|  
+|型と文字列表現を双方向に変換できる `TypeConverterAttribute` を持つ型。|型コンバーターによって異なります。|  
+  
+## 形式と WCF WEB HTTP プログラミング モデル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルには、さまざまなデータ形式を扱うための新機能が備わっています。<xref:System.ServiceModel.WebHttpBinding> は、バインディング層で次のさまざまな種類のデータを読み書きできます。  
+  
+-   XML  
+  
+-   JSON  
+  
+-   不透明なバイナリ ストリーム  
+  
+ つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルではあらゆる種類のデータを処理できますが、<xref:System.IO.Stream> に対してプログラミングすることもできます。  
+  
+ [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] は、配信フィード \(ATOM および RSS\) だけでなく、JSON データ \(AJAX\) にも対応しています。このような機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[WCF Web HTTP 形式](../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)」、「[WCF 配信の概要](../../../../docs/framework/wcf/feature-details/wcf-syndication-overview.md)」、および「[AJAX の統合と JSON のサポート](../../../../docs/framework/wcf/feature-details/ajax-integration-and-json-support.md)」を参照してください。  
+  
+## WCF WEB HTTP プログラミング モデルとセキュリティ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルでは WS\-\* プロトコルがサポートされないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP サービスを保護するには、SSL を使用して HTTPS 全体でサービスを公開するしかありません。[!INCLUDE[iisver](../../../../includes/iisver-md.md)] を使用した SSL の設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[IIS での SSL の実装方法](http://go.microsoft.com/fwlink/?LinkId=131613)」を参照してください。  
+  
+## WCF WEB HTTP プログラミング モデルのトラブルシューティング  
+ <xref:System.ServiceModel.Channels.ChannelFactory%601> を使用してチャネルを作成するために WCF WEB HTTP サービスを呼び出すと、異なる <xref:System.ServiceModel.EndpointAddress> が <xref:System.ServiceModel.Channels.ChannelFactory%601> に渡されるとしても、<xref:System.ServiceModel.Description.WebHttpBehavior> は構成ファイルに設定されている <xref:System.ServiceModel.EndpointAddress> を使用します。  
+  
+## 参照  
+ [WCF 配信](../../../../docs/framework/wcf/feature-details/wcf-syndication.md)   
+ [WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)   
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-programming-model.md b/docs/framework/wcf/feature-details/wcf-web-http-programming-model.md
new file mode 100644
index 00000000000..85ec0d56800
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-programming-model.md
@@ -0,0 +1,52 @@
+---
+title: "WCF Web HTTP プログラミング モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "POX"
+  - "REST"
+  - "Web サービス プログラミング モデル [WCF]"
+ms.assetid: 2312a8d3-b66e-4623-ba42-978434300c7f
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# WCF Web HTTP プログラミング モデル
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web HTTP プログラミング モデルを使用すると、開発者は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス操作を SOAP 以外のエンドポイントに公開できます。このセクションのトピックでは、この機能について詳しく説明します。  
+  
+## このセクションの内容  
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web HTTP プログラミング モデルの概要を示します。  
+  
+ [WCF Web HTTP プログラミング オブジェクト モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web HTTP プログラミング モデルおよびその機能について説明します。  
+  
+ [方法 : 基本的な WCF Web HTTP サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-basic-wcf-web-http-service.md)  
+ SOAP 以外のエンドポイントを公開する基本的なサービスを作成する方法について説明します。  
+  
+ [方法 : コントラクトを SOAP クライアントおよび Web クライアントに公開する](../../../../docs/framework/wcf/feature-details/how-to-expose-a-contract-to-soap-and-web-clients.md)  
+ SOAP クライアントと SOAP 以外のクライアントの両方に同じコントラクトを公開する基本的なサービスを作成する方法について説明します。  
+  
+ [UriTemplate と UriTemplateTable](../../../../docs/framework/wcf/feature-details/uritemplate-and-uritemplatetable.md)  
+ <xref:System.UriTemplate> および <xref:System.UriTemplateTable> を使用して URI を制御する方法について説明します。  
+  
+ [WCF WEB HTTP サービスのキャッシュ サポート](../../../../docs/framework/wcf/feature-details/caching-support-for-wcf-web-http-services.md)  
+ WCF Web HTTP サービスのキャッシュ動作を指定する方法について説明します。  
+  
+ [WCF Web HTTP 形式](../../../../docs/framework/wcf/feature-details/wcf-web-http-formatting.md)  
+ WCF Web HTTP サービスからの応答の形式を指定する方法について説明します。  
+  
+ [WCF Web HTTP エラー処理](../../../../docs/framework/wcf/feature-details/wcf-web-http-error-handling.md)  
+ HTTP 状態コードやその他のユーザー定義のエラー データを含むエラーを WCF Web クライアントに返す方法について説明します。  
+  
+ [WCF サービスからの REST スタイル サービスの呼び出し](../../../../docs/framework/wcf/feature-details/calling-a-rest-style-service-from-a-wcf-service.md)  
+ WCF サービス内から REST スタイルのサービスを呼び出す方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md b/docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md
new file mode 100644
index 00000000000..81ca33ed4ef
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-programming-object-model.md
@@ -0,0 +1,115 @@
+---
+title: "WCF Web HTTP プログラミング オブジェクト モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed96b5fc-ca2c-4b0d-bdba-d06b77c3cb2a
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# WCF Web HTTP プログラミング オブジェクト モデル
+WCF Web HTTP プログラミング モデルを使用すると、開発者は基本 HTTP 要求を使用して [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] Web サービスを公開できるようになり、SOAP は必要ありません。  WCF WEB HTTP プログラミング モデルは、既存の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張モデルに基づいて構築されます。  Web HTTP プログラミング モデルでは、次のクラスが定義されます。  
+  
+ **プログラミング モデル**  
+  
+-   <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute>  
+  
+-   <xref:System.ServiceModel.Web.WebGetAttribute>  
+  
+-   <xref:System.ServiceModel.Web.WebInvokeAttribute>  
+  
+-   <xref:System.ServiceModel.Web.WebServiceHost>  
+  
+ **チャネルおよびディスパッチャー インフラストラクチャ**  
+  
+-   <xref:System.ServiceModel.WebHttpBinding>  
+  
+-   <xref:System.ServiceModel.Description.WebHttpBehavior>  
+  
+ **ユーティリティ クラスと機能拡張ポイント**  
+  
+-   <xref:System.UriTemplate>  
+  
+-   <xref:System.UriTemplateTable>  
+  
+-   <xref:System.ServiceModel.Dispatcher.QueryStringConverter>  
+  
+-   <xref:System.ServiceModel.Dispatcher.WebHttpDispatchOperationSelector>  
+  
+## AspNetCacheProfileAttribute  
+ <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> は、サービス操作に適用された場合に、構成ファイル内の ASP.NET 出力キャッシュ プロファイルを示します。この構成ファイルを使用して ASP .NET 出力キャッシュに操作の応答がキャッシュされます。  このプロパティが受け取るパラメーターは 1 つ \(構成ファイルでキャッシュ設定を指定するキャッシュ プロファイル名\) だけです。  
+  
+## WebGetAttribute  
+ <xref:System.ServiceModel.Web.WebGetAttribute> 属性は、サービス操作を HTTP GET 要求に応答する操作としてマークするために使用されます。  メタデータを操作の説明に追加する受信操作の動作です \(<xref:System.ServiceModel.Description.IOperationBehavior> メソッドは何の処理も行いません\)。  このメタデータを操作の説明で検索する動作 \(特に <xref:System.ServiceModel.Description.WebHttpBehavior>\) がサービスの動作コレクションに追加されていない場合は、<xref:System.ServiceModel.Web.WebGetAttribute> を適用しても機能しません。  <xref:System.ServiceModel.Web.WebGetAttribute> 属性には、次の表に示すパラメーターをオプションで指定できます。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|`BodyStyle`|属性が適用されているサービス操作との間で送受信される要求と応答をラップするかどうかを制御します。|  
+|`RequestFormat`|要求メッセージの書式設定方法を制御します。|  
+|`ResponseFormat`|応答メッセージの書式設定方法を制御します。|  
+|`UriTemplate`|属性が適用されているサービス操作にマップされた HTTP 要求を制御する URI テンプレートを指定します。|  
+  
+## WebHttpBinding  
+ <xref:System.ServiceModel.WebHttpBinding> クラスは、<xref:System.ServiceModel.Channels.WebMessageEncodingBindingElement> を使用して、XML、JSON、および生のバイナリ データのサポートを組み込みます。  これは、<xref:System.ServiceModel.Channels.HttpsTransportBindingElement>、<xref:System.ServiceModel.Channels.HttpTransportBindingElement>、および <xref:System.ServiceModel.WebHttpSecurity> オブジェクトから構成されています。  <xref:System.ServiceModel.WebHttpBinding> は、<xref:System.ServiceModel.Description.WebHttpBehavior> と組み合わせて使用するようにデザインされています。  
+  
+## WebInvokeAttribute  
+ <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性は <xref:System.ServiceModel.Web.WebGetAttribute> 属性によく似ていますが、サービス操作を GET 以外の HTTP 要求に応答する操作としてマークするために使用されます。  メタデータを操作の説明に追加する受信操作の動作です \(<xref:System.ServiceModel.Description.IOperationBehavior> メソッドは何の処理も行いません\)。  このメタデータを操作の説明で検索する動作 \(特に <xref:System.ServiceModel.Description.WebHttpBehavior>\) がサービスの動作コレクションに追加されていない場合は、<xref:System.ServiceModel.Web.WebInvokeAttribute> を適用しても機能しません。  
+  
+ <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性には、次の表に示すパラメーターをオプションで指定できます。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|`BodyStyle`|属性が適用されているサービス操作との間で送受信される要求と応答をラップするかどうかを制御します。|  
+|`Method`|サービス操作がマップされる HTTP メソッドを指定します。|  
+|`RequestFormat`|要求メッセージの書式設定方法を制御します。|  
+|`ResponseFormat`|応答メッセージの書式設定方法を制御します。|  
+|`UriTemplate`|属性が適用されているサービス操作にマップされた GET 要求を制御する URI テンプレートを指定します。|  
+  
+## UriTemplate  
+ <xref:System.UriTemplate> クラスでは、構造が似ている URI のセットを定義できます。  テンプレートは、パスとクエリの 2 つの部分から構成されています。  パスは、スラッシュ \(\/\) で区切られた一連のセグメントから構成されています。  各セグメントには、リテラル値、変数値 \(中かっこ \[{ }\] 内に記述。必ず 1 つのセグメントと一致するよう制約\)、またはワイルドカード \(アスタリスク \[\*\] で記述。"残りのパス" に一致する\) を指定することができます。ワイルドカードは、パスの最後に指定する必要があります。  クエリ式は、すべて省略することができます。  存在する場合、クエリ式は順序なしの一連の名前\/値ペアを指定します。  クエリ式の要素には、リテラル ペア \(?x\=2\) または変数ペア \(?x\={*value*}\) を指定できます。  対になっていない値は使用できません。  <xref:System.UriTemplate> は、特定の URI や URI のグループをサービス操作にマップするために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルによって内部的に使用されます。  
+  
+## UriTemplateTable  
+ <xref:System.UriTemplateTable> クラスは、開発者が選択したオブジェクトにバインドされた <xref:System.UriTemplate> オブジェクトの結合セットを表します。  これにより、セット内のテンプレートと候補 URI \(Uniform Resource Identifier\) を照合し、一致したテンプレートに関連付けられているデータを取得することができます。  <xref:System.UriTemplateTable> は、特定の URI や URI のグループをサービス操作にマップするために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルによって内部的に使用されます。  
+  
+## WebServiceHost  
+ <xref:System.ServiceModel.Web.WebServiceHost> は <xref:System.ServiceModel.ServiceHost> を拡張するため、SOAP 以外の Web スタイル サービスを容易にホストできます。  <xref:System.ServiceModel.Web.WebServiceHost> では、サービスの説明にエンドポイントが見つからない場合、サービスのベース アドレスに既定のエンドポイントを自動的に作成します。  既定の HTTP エンドポイントを作成するときに、<xref:System.ServiceModel.Web.WebServiceHost> は、HTTP ヘルプ ページと Web サービス記述言語 \(WSDL\) GET 機能を無効にして、メタデータ エンドポイントが既定の HTTP エンドポイントに干渉しないようにします。  また、<xref:System.ServiceModel.Web.WebServiceHost> は、<xref:System.ServiceModel.WebHttpBinding> を使用するすべてのエンドポイントに必要な <xref:System.ServiceModel.Description.WebHttpBehavior> がアタッチされるようにもします。  最後に、<xref:System.ServiceModel.Web.WebServiceHost> は、エンドポイントのバインディングを、安全な仮想ディレクトリで使用するときに、関連付けられたインターネット インフォメーション サービス \(IIS\) のセキュリティ設定と連携して動作するよう自動的に構成します。  
+  
+## WebServiceHostFactory  
+ <xref:System.ServiceModel.Activation.WebServiceHostFactory> クラスは、サービスがインターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) でホストされている場合に、<xref:System.ServiceModel.Web.WebServiceHost> を動的に作成するために使用されます。  ホスト アプリケーションが <xref:System.ServiceModel.Web.WebServiceHost> をインスタンス化する自己ホスト型サービスとは異なり、IIS または WAS でホストされているサービスは、このクラスを使用してサービスの <xref:System.ServiceModel.Web.WebServiceHost> を作成します。  [CreateServiceHost\(Type, Uri\<xref:System.ServiceModel.Activation.WebServiceHostFactory.CreateServiceHost%28System.Type%2CSystem.Uri%5B%5D%29> メソッドは、サービスの受信要求の受信時に呼び出されます。  
+  
+## WebHttpBehavior  
+ <xref:System.ServiceModel.Description.WebHttpBehavior> クラスは、必要なフォーマッタ、操作セレクターなど、サービス モデル レイヤーで Web スタイル サービスをサポートするために必要な内容を提供します。  このパラメーターは \(<xref:System.ServiceModel.WebHttpBinding> と共に使用される\) エンドポイントの動作として実装され、これにより、フォーマッタと操作セレクターを各エンドポイントに指定できるようになり、さらに、同じサービス実装で SOAP エンドポイントと POX エンドポイントの両方を公開できるようになります。  
+  
+### WebHttpBehavior の拡張  
+ <xref:System.ServiceModel.Description.WebHttpBehavior> は、仮想メソッド <xref:System.ServiceModel.Description.WebHttpBehavior.GetOperationSelector%28System.ServiceModel.Description.ServiceEndpoint%29>、<xref:System.ServiceModel.Description.WebHttpBehavior.GetReplyClientFormatter%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Description.ServiceEndpoint%29>、<xref:System.ServiceModel.Description.WebHttpBehavior.GetRequestClientFormatter%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Description.ServiceEndpoint%29>、<xref:System.ServiceModel.Description.WebHttpBehavior.GetReplyDispatchFormatter%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Description.ServiceEndpoint%29>、および <xref:System.ServiceModel.Description.WebHttpBehavior.GetRequestDispatchFormatter%28System.ServiceModel.Description.OperationDescription%2CSystem.ServiceModel.Description.ServiceEndpoint%29> を使用して拡張できます。  開発者は、<xref:System.ServiceModel.Description.WebHttpBehavior> から派生クラスを作成し、そのメソッドをオーバーライドして既定の動作をカスタマイズすることができます。  
+  
+ <xref:System.ServiceModel.Description.WebScriptEnablingBehavior> は、<xref:System.ServiceModel.Description.WebHttpBehavior> 拡張の一例です。  <xref:System.ServiceModel.Description.WebScriptEnablingBehavior> によって、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] エンドポイントでブラウザー ベースの ASP.NET AJAX クライアントから HTTP 要求を受信できるようになります。  「[HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)」はこの機能拡張ポイントの使用例です。  
+  
+> [!WARNING]
+>  <xref:System.ServiceModel.Description.WebScriptEnablingBehavior> を使用する場合、<xref:System.UriTemplate> は、<xref:System.ServiceModel.Web.WebGetAttribute> または <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性内でサポートされません。  
+  
+## WebHttpDispatchOperationSelector  
+ <xref:System.ServiceModel.Dispatcher.WebHttpDispatchOperationSelector> クラスは、<xref:System.UriTemplate> クラスおよび <xref:System.UriTemplateTable> クラスを使用して、サービス操作に対して呼び出しをディスパッチします。  
+  
+## 互換性  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルでは、SOAP ベースのメッセージを使用しないため、WS\-\* プロトコルをサポートしていません。  ただし、SOAP を使用するエンドポイントと SOAP を使用しないその他のエンドポイントの 2 つの異なるエンドポイントを使用して、同じコントラクトを公開できます。  例については、「[方法 : コントラクトを SOAP クライアントおよび Web クライアントに公開する](../../../../docs/framework/wcf/feature-details/how-to-expose-a-contract-to-soap-and-web-clients.md)」を参照してください。  
+  
+## セキュリティ  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルでは WS\-\* プロトコルがサポートされないため、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] WEB HTTP プログラミング モデルで構築された Web サービスを保護するには、SSL を使用してサービスを公開するしかありません。  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] を使用した SSL の設定の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[IIS で SSL を実装する方法](http://go.microsoft.com/fwlink/?LinkId=131613)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel.WebHttpBinding>   
+ <xref:System.ServiceModel.Web.WebGetAttribute>   
+ <xref:System.ServiceModel.Web.WebInvokeAttribute>   
+ <xref:System.ServiceModel.Description.WebHttpBehavior>   
+ <xref:System.ServiceModel.Dispatcher.WebHttpDispatchOperationSelector>   
+ [WCF Web HTTP プログラミング モデルの概要](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wcf-web-http-service-help-page.md b/docs/framework/wcf/feature-details/wcf-web-http-service-help-page.md
new file mode 100644
index 00000000000..b9d9ba95d96
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wcf-web-http-service-help-page.md
@@ -0,0 +1,251 @@
+---
+title: "WCF Web HTTP サービスのヘルプ ページ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63c7c695-44b6-4f31-bb9c-00f2763f525e
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# WCF Web HTTP サービスのヘルプ ページ
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] には、WCF WEB HTTP サービスの自動的なヘルプ ページが用意されています。このヘルプ ページには、各操作の説明、要求と応答の形式、およびスキーマが一覧表示されます。この機能は、既定では無効になっています。ユーザーが WCF WEB HTTP サービスを参照し、URL の最後に "\/Help" を追加する \(http:\/\/localhost:8000\/Customers\/Help など\) と、次のようなページが表示されます。  
+  
+ ![WCF REST ヘルプ ページ](../../../../docs/framework/wcf/feature-details/media/wcfresthelppagemain.png "WCFRESTHELPPAGEMAIN")  
+  
+ ヘルプ ページに一覧表示されているメソッドをユーザーがクリックすると、その操作の詳細を示すページが表示され、メッセージの形式や応答例など、そのメソッドの詳細が示されます。次の図は、メソッドのヘルプ ページの例です。  
+  
+ ![WCF REST ヘルプ ページの詳細](../../../../docs/framework/wcf/feature-details/media/wcfresthelppagedetail2.png "WCFRESTHELPPAGEDETAIL2")  
+  
+## WCF Web HTTP ヘルプ ページの使用  
+ <xref:System.ComponentModel.DescriptionAttribute> を使用して指定した場合は、WCF WEB HTTP ヘルプ ページに各操作の短い説明が表示されます。この属性は、適用される操作の短い説明を含む文字列を取得します。たとえば、次のコードでは、<xref:System.ComponentModel.DescriptionAttribute> を使用して短い説明を提供する方法を示しています。  
+  
+```  
+[OperationContract]  
+[WebGet(UriTemplate="/template1", BodyStyle = WebMessageBodyStyle.Bare)]  
+[Description("Description for GET /template1")]  
+SyndicationFeedFormatter GetTemplate1();  
+```  
+  
+ WCF WEB HTTP ヘルプ ページを有効にするには、サービスのエンドポイントにエンドポイント動作を追加する必要があります。これは、構成で追加することも、コードで追加することもできます。WCF WEB HTTP ヘルプ ページを構成で有効化するには、`<webHttp>` 要素を持つエンドポイント動作を追加し、`enableHelp` を `true` に設定し、エンドポイントを追加して、エンドポイント動作を使用するようにそれを構成します。次の構成コードは、この実行方法を示しています。  
+  
+```  
+<endpointBehaviors>  
+   <behavior name="RESTEndpointBehavior">  
+      <webHttp enableHelp="true"/>  
+   </behavior>  
+</endpointBehaviors>  
+<!-- ... -->  
+<services>  
+   <service behaviorConfiguration="RESTWebServiceBehavior" name="RESTWebService">      <endpoint address="" kind="webHttpEndpoint" behaviorConfiguration="RESTEndpointBehavior" contract="IHello" />  
+  
+      <!-- ... -->  
+   </service>  
+</services>  
+```  
+  
+ WCF Web HTTP ヘルプ ページをコードで有効化するには、サービス エンドポイントを追加し、<xref:System.ServiceModel.Description.WebHttpBehavior> をエンドポイントに追加し、<xref:System.ServiceModel.Description.WebHttpBehavior.EnableHelp%2A> を `true` に設定します。この方法を次のコードに示します。  
+  
+```  
+using (WebServiceHost host = new WebServiceHost(typeof(Service), new Uri("http://localhost:8000/Customers")))  
+{  
+   host.AddServiceEndpoint(typeof(ICustomerCollection), new WebHttpBinding(), "");               
+   host.Description.Endpoints[0].Behaviors.Add(new WebHttpBehavior { EnableHelp = true });  
+   // ...  
+}  
+```  
+  
+ ヘルプ ページは XHTML ベースで、ページの各部分を識別するマークアップがあります。これにより、クライアントは、<xref:System.Xml.Linq.XElement> またはその他の XLinq API を使用して、ページにプログラムでアクセスできます。  
+  
+## WCF Web HTTP サービスのヘルプ ページで使用されるスキーマ  
+ WCF Web HTTP サービスのヘルプ ページでは、次のスキーマが使用されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://schemas.microsoft.com/2003/10/Serialization/" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:element name="anyType" nillable="true" type="xs:anyType" />  
+  <xs:element name="anyURI" nillable="true" type="xs:anyURI" />  
+  <xs:element name="base64Binary" nillable="true" type="xs:base64Binary" />  
+  <xs:element name="boolean" nillable="true" type="xs:boolean" />  
+  <xs:element name="byte" nillable="true" type="xs:byte" />  
+  <xs:element name="dateTime" nillable="true" type="xs:dateTime" />  
+  <xs:element name="decimal" nillable="true" type="xs:decimal" />  
+  <xs:element name="double" nillable="true" type="xs:double" />  
+  <xs:element name="float" nillable="true" type="xs:float" />  
+  <xs:element name="int" nillable="true" type="xs:int" />  
+  <xs:element name="long" nillable="true" type="xs:long" />  
+  <xs:element name="QName" nillable="true" type="xs:QName" />  
+  <xs:element name="short" nillable="true" type="xs:short" />  
+  <xs:element name="string" nillable="true" type="xs:string" />  
+  <xs:element name="unsignedByte" nillable="true" type="xs:unsignedByte" />  
+  <xs:element name="unsignedInt" nillable="true" type="xs:unsignedInt" />  
+  <xs:element name="unsignedLong" nillable="true" type="xs:unsignedLong" />  
+  <xs:element name="unsignedShort" nillable="true" type="xs:unsignedShort" />  
+  <xs:element name="char" nillable="true" type="tns:char" />  
+  <xs:simpleType name="char">  
+    <xs:restriction base="xs:int" />  
+  </xs:simpleType>  
+  <xs:element name="duration" nillable="true" type="tns:duration" />  
+  <xs:simpleType name="duration">  
+    <xs:restriction base="xs:duration">  
+      <xs:pattern value="\-?P(\d*D)?(T(\d*H)?(\d*M)?(\d*(\.\d*)?S)?)?" />  
+      <xs:minInclusive value="-P10675199DT2H48M5.4775808S" />  
+      <xs:maxInclusive value="P10675199DT2H48M5.4775807S" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:element name="guid" nillable="true" type="tns:guid" />  
+  <xs:simpleType name="guid">  
+    <xs:restriction base="xs:string">  
+      <xs:pattern value="[\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12}" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:attribute name="FactoryType" type="xs:QName" />  
+  <xs:attribute name="Id" type="xs:ID" />  
+  <xs:attribute name="Ref" type="xs:IDREF" />  
+</xs:schema>  
+  
+<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:tns="http://microsoft.com/wsdl/types/" elementFormDefault="qualified" targetNamespace="http://microsoft.com/wsdl/types/" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:simpleType name="guid">  
+    <xs:restriction base="xs:string">  
+      <xs:pattern value="[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:simpleType name="char">  
+    <xs:restriction base="xs:unsignedShort" />  
+  </xs:simpleType>  
+</xs:schema>  
+  
+<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:tns="http://schemas.datacontract.org/2004/07/System" elementFormDefault="qualified" targetNamespace="http://schemas.datacontract.org/2004/07/System" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:import namespace="http://schemas.microsoft.com/2003/10/Serialization/" />  
+  <xs:complexType name="DateTimeOffset">  
+    <xs:annotation>  
+      <xs:appinfo>  
+        <IsValueType xmlns="http://schemas.microsoft.com/2003/10/Serialization/">true</IsValueType>  
+      </xs:appinfo>  
+    </xs:annotation>  
+    <xs:sequence>  
+      <xs:element name="DateTime" type="xs:dateTime" />  
+      <xs:element name="OffsetMinutes" type="xs:short" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="DateTimeOffset" nillable="true" type="tns:DateTimeOffset" />  
+  <xs:complexType name="DBNull">  
+    <xs:sequence />  
+  </xs:complexType>  
+  <xs:element name="DBNull" nillable="true" type="tns:DBNull" />  
+</xs:schema>  
+  
+<?xml version="1.0" encoding="utf-16"?>  
+<xs:schema xmlns:tns="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:ser="http://schemas.microsoft.com/2003/10/Serialization/" elementFormDefault="qualified" targetNamespace="http://schemas.microsoft.com/2003/10/Serialization/Arrays" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:import namespace="http://schemas.microsoft.com/2003/10/Serialization/" />  
+  <xs:complexType name="ArrayOfboolean">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="boolean" type="xs:boolean" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfboolean" nillable="true" type="tns:ArrayOfboolean" />  
+  <xs:complexType name="ArrayOfchar">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="char" type="ser:char" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfchar" nillable="true" type="tns:ArrayOfchar" />  
+  <xs:complexType name="ArrayOfdateTime">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="dateTime" type="xs:dateTime" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfdateTime" nillable="true" type="tns:ArrayOfdateTime" />  
+  <xs:complexType name="ArrayOfdecimal">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="decimal" type="xs:decimal" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfdecimal" nillable="true" type="tns:ArrayOfdecimal" />  
+  <xs:complexType name="ArrayOfdouble">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="double" type="xs:double" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfdouble" nillable="true" type="tns:ArrayOfdouble" />  
+  <xs:complexType name="ArrayOffloat">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="float" type="xs:float" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOffloat" nillable="true" type="tns:ArrayOffloat" />  
+  <xs:complexType name="ArrayOfguid">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="guid" type="ser:guid" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfguid" nillable="true" type="tns:ArrayOfguid" />  
+  <xs:complexType name="ArrayOfint">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="int" type="xs:int" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfint" nillable="true" type="tns:ArrayOfint" />  
+  <xs:complexType name="ArrayOflong">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="long" type="xs:long" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOflong" nillable="true" type="tns:ArrayOflong" />  
+  <xs:complexType name="ArrayOfshort">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="short" type="xs:short" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfshort" nillable="true" type="tns:ArrayOfshort" />  
+  <xs:complexType name="ArrayOfstring">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="string" nillable="true" type="xs:string" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfstring" nillable="true" type="tns:ArrayOfstring" />  
+  <xs:complexType name="ArrayOfduration">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="duration" type="ser:duration" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfduration" nillable="true" type="tns:ArrayOfduration" />  
+  <xs:complexType name="ArrayOfunsignedInt">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="unsignedInt" type="xs:unsignedInt" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfunsignedInt" nillable="true" type="tns:ArrayOfunsignedInt" />  
+  <xs:complexType name="ArrayOfunsignedLong">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="unsignedLong" type="xs:unsignedLong" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfunsignedLong" nillable="true" type="tns:ArrayOfunsignedLong" />  
+  <xs:complexType name="ArrayOfunsignedShort">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="unsignedShort" type="xs:unsignedShort" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfunsignedShort" nillable="true" type="tns:ArrayOfunsignedShort" />  
+  <xs:complexType name="ArrayOfQName">  
+    <xs:sequence>  
+      <xs:element minOccurs="0" maxOccurs="unbounded" name="QName" nillable="true" type="xs:QName" />  
+    </xs:sequence>  
+  </xs:complexType>  
+  <xs:element name="ArrayOfQName" nillable="true" type="tns:ArrayOfQName" />  
+</xs:schema>  
+  
+```  
+  
+ データ コントラクトのシリアル化スキーマ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/web-hosting-a-queued-application.md b/docs/framework/wcf/feature-details/web-hosting-a-queued-application.md
new file mode 100644
index 00000000000..631606ac148
--- /dev/null
+++ b/docs/framework/wcf/feature-details/web-hosting-a-queued-application.md
@@ -0,0 +1,53 @@
+---
+title: "キューに置かれたアプリケーションの Web ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c7a539fa-e442-4c08-a7f1-17b7f5a03e88
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# キューに置かれたアプリケーションの Web ホスト
+Windows プロセス アクティブ化サービス \(WAS\) は、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストするアプリケーションが含まれるワーカー プロセスのアクティベーションと有効期間を管理します。  WAS プロセス モデルは HTTP の依存関係を取り除くことにより、HTTP サーバーの [!INCLUDE[iis601](../../../../includes/iis601-md.md)] プロセス モデルを一般化します。  これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、メッセージ ベースのアクティブ化がサポートされ、特定のコンピューター上で多数のアプリケーションをホストできるホスト環境で、net.msmq や msmq.formatname などの HTTP プロトコルと非 HTTP プロトコルの両方を使用できるようになります。  
+  
+ WAS にはメッセージ キュー \(MSMQ\) アクティブ化サービスが含まれており、アプリケーションで使用されるキューのいずれかに 1 つ以上のメッセージが置かれると、キュー アプリケーションがアクティブ化されます。  MSMQ アクティブ化サービスは、既定で自動的に開始される NT サービスです。  
+  
+ WAS とその利点[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows プロセス アクティブ化サービスでのホスティング](../../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)」を参照してください。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] MSMQ については、「[キューの概要](../../../../docs/framework/wcf/feature-details/queues-overview.md)」を参照してください。  
+  
+## WAS でのキュー アドレス指定  
+ WAS アプリケーションには URI \(Uniform Resource Identifier\) アドレスがあります。  アプリケーション アドレスは、ベース URI プレフィックスとアプリケーション固有の相対アドレス \(パス\) の 2 つの部分に分かれます。  この 2 つの部分を結合すると、アプリケーションの外部アドレスになります。  ベース URI プレフィックスは、サイト バインディングで構築され、サイト内のすべてのアプリケーションで使用されます。たとえば、“net.msmq:\/\/localhost"、"msmq.formatname:\/\/localhost"、または"net.tcp:\/\/localhost” などです。  次に、アプリケーション固有のパス フラグメント \(“\/applicationOne” など\) が取得され、ベース URI プレフィックスに追加されてアプリケーション アドレスが構築されます。これでアプリケーションの完全 URI になります。たとえば、"net.msmq:\/\/localhost\/applicationOne" などです。  
+  
+ MSMQ アクティブ化サービスは、アプリケーション URI を使用して、MSMQ アクティブ化サービスでメッセージを監視する必要のあるキューを照会します。  MSMQ アクティブ化サービスを起動すると、受信するように設定したコンピューターのすべてのパブリック キューとプライベート キューが列挙され、そのキューのメッセージが監視されます。  MSMQ アクティブ化サービスは、10 分おきに監視対象のキュー リストを更新します。  キューでメッセージが検出されると、アクティブ化サービスは、キュー名を net.msmq バインディングで一致する最長のアプリケーション URI と一致させ、アプリケーションをアクティブ化します。  
+  
+> [!NOTE]
+>  アクティブ化するアプリケーションは、キュー名のプレフィックスに一致 \(最長一致\) する必要があります。  
+  
+ たとえば、msmqWebHost\/orderProcessing\/service.svc という名前のキューがあるとします。  アプリケーション 1 に仮想ディレクトリ \/msmqWebHost\/orderProcessing がありその下に service.svc が格納されており、アプリケーション 2 に仮想ディレクトリ \/msmqWebHost がありその下に orderProcessing.svc が格納されている場合、アプリケーション 1 がアクティブ化されます。  アプリケーション 1 が削除されると、アプリケーション 2 がアクティブ化されます。  
+  
+> [!NOTE]
+>  キューが作成され、メッセージがそのキューに送信されても、MSMQ アクティブ化サービスがそのキュー リストを更新するまで、アプリケーションはアクティブ化されません。キュー リストが更新されるまでの時間は、キューが作成されてから最大で 10 分です。  アクティブ化サービスを再起動した場合も、キュー リストは更新されます。  
+  
+### アドレスに対するプライベート キューとパブリック キューの影響  
+ MSMQ アクティブ化サービスでは、プライベート キューの監視とパブリック キューの監視が区別されません。  したがって、パブリック キューとプライベート キューを同じ名前にすることはできません。  同じ名前の場合、いずれかのキューを読み込んで、Web ホスト アプリケーションがアクティブ化される場合があります。  
+  
+### アクティブ化のためのキュー構成  
+ MSMQ アクティブ化サービスは、NETWORK SERVICE として動作します。  これは、アプリケーションをアクティブ化するキューを監視するサービスです。  キューからアプリケーションをアクティブ化するようにするには、アクセス制御リスト \(ACL\) に NETWORK SERVICE アクセス用のキューを指定し、メッセージをピークする必要があります。  
+  
+### 有害メッセージ処理  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での有害メッセージ処理は、チャネルによって行われます。チャネルは、有害メッセージを検出するだけでなく、ユーザーの構成に基づいて処置を選択します。  そのため、キューには 1 つのメッセージが存在します。  Web ホスト アプリケーションが連続的に中断されると、このメッセージは再試行キューに移動されます。  再試行サイクル遅延により指定された時点で、メッセージは再試行キューからメイン キューに移動されて再試行されます。  ただし、この場合、キューに置かれたチャネルがアクティブである必要があります。  アプリケーションが WAS により再利用される場合、メッセージは、別のメッセージがメイン キューに到着してキューに置かれたアプリケーションがアクティブ化されるまで再試行キューに残ります。  この場合の回避策は、メッセージを再試行キューからメイン キューに手動で戻し、アプリケーションを再アクティブ化することです。  
+  
+### サブキューとシステム キューに関する注意  
+ WAS によりホストされるアプリケーションを、システム キュー \(システム全体の配信不能キューなど\) 内や、サブキュー \(有害サブキューなど\) 内のメッセージに基づいてアクティブ化することはできません。  これはこのバージョンの製品の制限です。  
+  
+## 参照  
+ [有害メッセージ処理](../../../../docs/framework/wcf/feature-details/poison-message-handling.md)   
+ [サービス エンドポイントとキューのアドレス指定](../../../../docs/framework/wcf/feature-details/service-endpoints-and-queue-addressing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md b/docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md
new file mode 100644
index 00000000000..42dc5c6780d
--- /dev/null
+++ b/docs/framework/wcf/feature-details/web-services-protocols-interoperability-guide.md
@@ -0,0 +1,119 @@
+---
+title: "Web サービス プロトコルの相互運用性ガイド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2981678-ebdb-433d-899b-467f7df95fb2
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# Web サービス プロトコルの相互運用性ガイド
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、さまざまな Web サービス プロトコルを実装します。  これらのプロトコルの多くには、さまざまなオプションと拡張ポイントが用意されており、それらの実装は実装者の裁量に任されています。  このトピックでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が実装する Web サービス プロトコルの一覧を示します。  サポートされる各プロトコルの実装の詳細については、このセクションの他のトピックで説明します。  
+  
+## WCF が実装する Web サービス プロトコル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、チャネルを通じて Web サービス \(WS\) のインフラストラクチャ プロトコルをサポートし、コントラクト機能を通じて Web サービスのアプリケーション プロトコルをサポートします。  アプリケーション プロトコルの相互運用性は、XML スキーマ記述言語 \(XSD\) 1.0 と Web サービス記述言語 \(WSDL\) 1.1 を通じて実現されます。  
+  
+ インフラストラクチャ プロトコルの相互運用性は、WS\-\* 仕様によって提供されます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルには、さまざまな WS\-\* インフラストラクチャ プロトコルのサポートが用意されています。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネルは、バインド要素を使用して構成されます。  さまざまな [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] バインド要素によって実装される WS\-\* インフラストラクチャ プロトコルの完全な一覧を次の表に示します。  
+  
+ <xref:System.ServiceModel.Channels.HttpTransportBindingElement> は、次の表の仕様をサポートします。  
+  
+|仕様\/ドキュメント|Link|  
+|----------------|----------|  
+|HTTP 1.1|[RFC 2616](http://go.microsoft.com/fwlink/?LinkId=90372)|  
+|SOAP 1.1 HTTP バインディング|[簡易オブジェクト アクセス プロトコル \(SOAP\) 1.1](http://go.microsoft.com/fwlink/?LinkId=90520)、セクション 7|  
+|SOAP 1.2 HTTP バインディング|[SOAP バージョン 1.2 第 2 部: Adjuncts \(第 2 版\)](http://go.microsoft.com/fwlink/?LinkId=95329)、セクション 7|  
+  
+ <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> および <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> は、次の表の仕様をサポートします。  
+  
+|仕様\/ドキュメント|Link|  
+|----------------|----------|  
+|XML|[拡張マークアップ言語 \(XML\) 1.0 \(第 4 版\)](http://go.microsoft.com/fwlink/?LinkId=15139)|  
+|SOAP 1.1|[簡易オブジェクト アクセス プロトコル \(SOAP\) 1.1](http://go.microsoft.com/fwlink/?LinkId=96687)|  
+|SOAP 1.2 コア|[SOAP バージョン 1.2 第 1 部: Messaging Framework \(第 2 版\)](http://go.microsoft.com/fwlink/?LinkId=94664)|  
+|WS\-Addressing 2004\/08|[Web Services Addressing \(WS\-Addressing\)](http://go.microsoft.com/fwlink/?LinkId=81239)|  
+|W3C Web Services Addressing 1.0 \- コア|[Web Services Addressing 1.0 \- コア](http://go.microsoft.com/fwlink/?LinkId=96688)|  
+|W3C Web Services Addressing 1.0 \- SOAP バインディング|[Web Services Addressing 1.0 \- SOAP バインディング](http://go.microsoft.com/fwlink/?LinkId=96689)|  
+|W3C Web Services Addressing 1.0 \- WSDL バインディング\*|[Web Services Addressing 1.0 \- WSDL バインディング](http://go.microsoft.com/fwlink/?LinkId=96690)|  
+|W3C Web Services Addressing 1.0 \- メタデータ|[Web Services Addressing 1.0 \- メタデータ](http://www.w3.org/TR/ws-addr-metadata/)|  
+|WSDL SOAP1.1 バインディング|[Web サービス記述言語 \(WSDL\) 1.1](http://go.microsoft.com/fwlink/?LinkId=96160)|  
+|WSDL SOAP1.2 バインディング|[WSDL 1.1 Binding Extension for SOAP 1.2](http://go.microsoft.com/fwlink/?LinkId=96691)|  
+  
+ <xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement> は、次の表の仕様をサポートします。  
+  
+|仕様\/ドキュメント|Link|  
+|----------------|----------|  
+|XOP|[XML\-binary Optimized Packaging](http://go.microsoft.com/fwlink/?LinkId=96714)|  
+|MTOM \+ SOAP1.2 バインディング|[SOAP Message Transmission Optimization Mechanism](http://go.microsoft.com/fwlink/?LinkId=96713)|  
+|MTOM SOAP 1.1 バインディング|[SOAP 1.1 Binding for MTOM 1.0](http://go.microsoft.com/fwlink/?LinkId=96712)|  
+|MTOM WS\-Policy アサーション|未公開|  
+  
+ <xref:System.ServiceModel.Channels.SecurityBindingElement> は、次の表の仕様をサポートします。  
+  
+|仕様\/ドキュメント|Link|  
+|----------------|----------|  
+|WSS SOAP Message Security 1.0|[Web Services Security: SOAP Message Security 1.0](http://go.microsoft.com/fwlink/?LinkId=94684)|  
+|WSS: Username Token Profile 1.0|[Web Services Security UsernameToken Profile 1.0](http://go.microsoft.com/fwlink/?LinkId=95334)<br /><br /> Password\/@Type\=PasswordText \(既定\) が必要です。|  
+|WSS: X.509 Token Profile 1.0|[Web Services Security X.509 Certificate Token Profile](http://go.microsoft.com/fwlink/?LinkId=95335)|  
+|WSS: SAML 1.1 Token Profile 1.0|[Web Services Security: SAML Token Profile](http://go.microsoft.com/fwlink/?LinkId=96693)|  
+|WSS SOAP Message Security 1.1|[Web Services Security: SOAP Message Security 1.1](http://go.microsoft.com/fwlink/?LinkId=91240)|  
+|WSS Username Token Profile 1.1|[Web Services Security UsernameToken Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=95331)<br /><br /> パスワード ベースのキー派生は実装していません。<br /><br /> Password\/@Type\=PasswordText \(既定\) が必要です。|  
+|WSS: X509 Token Profile 1.1|[Web Services Security X.509 Certificate Token Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=95332)|  
+|WSS: Kerberos Token Profile 1.1|[Web Services Security Kerberos Token Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=95333)|  
+|WSS: SAML 1.1 Token Profile 1.1|[Web Services Security SAML Token Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=96694)|  
+|WS\-SecureConversation|[Web Services Secure Conversation Language](http://go.microsoft.com/fwlink/?LinkId=95317)|  
+|WS\-Trust 1.4|[Web Services Trust Language](http://go.microsoft.com/fwlink/?LinkId=169514)|  
+|WS\-SecurityPolicy 2005\/07|[Web Services Secure Conversation Language](http://go.microsoft.com/fwlink/?LinkId=95317)<br /><br /> OASIS WS\-SX 技術委員会に提出された正誤表で修正されています。<br /><br /> [ws\-sx message](http://go.microsoft.com/fwlink/?LinkId=96700)|  
+|WS\-ReliableMessaging 1.1|[リライアブル メッセージング プロトコル バージョン 1.1](../../../../docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-1.md)|  
+  
+ <xref:System.ServiceModel.Channels.TransactionFlowBindingElement> は、次の表の仕様をサポートします。  
+  
+|仕様\/ドキュメント|Link|  
+|----------------|----------|  
+|WS\-Coordination|[Web Services Coordination](http://go.microsoft.com/fwlink/?LinkId=95324)|  
+|WS\-AtomicTransaction|[Web Services Atomic Transaction](http://go.microsoft.com/fwlink/?LinkId=95323)|  
+  
+ <xref:System.ServiceModel.Description.MetadataExporter>、<xref:System.ServiceModel.Description.MetadataImporter>、<xref:System.ServiceModel.Description.WSDLExporter>、<xref:System.ServiceModel.Description.WSDLImporter>、および <xref:System.ServiceModel.Description.MetadataResolver> の各クラスは、次のメタデータ仕様をサポートします。  
+  
+-   [XML スキーマ第 1 部: 構造第 2 版](http://go.microsoft.com/fwlink/?LinkId=3536)  
+  
+-   [XML スキーマ第 2 部: データ型第 2 版](http://go.microsoft.com/fwlink/?LinkId=40138)  
+  
+-   [WSDL 1.1](http://go.microsoft.com/fwlink/?LinkId=96160)  
+  
+-   [WS\-Policy 1.2](http://go.microsoft.com/fwlink/?LinkId=96705)  
+  
+-   [WS\-Policy 1.5](http://go.microsoft.com/fwlink/?LinkId=96706)  
+  
+-   [WS\-PolicyAttachment 1.2](http://go.microsoft.com/fwlink/?LinkId=96707)  
+  
+-   [WS\-MetadataExchange 1.1](http://go.microsoft.com/fwlink/?LinkId=94868)  
+  
+-   [WS\-Transfer メタデータ取得のための Get](http://go.microsoft.com/fwlink/?LinkId=96708)  
+  
+ さらに、次の相互運用性プロファイルが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 間で実装されます。  
+  
+-   [Basic Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=69313)  
+  
+-   [Simple SOAP Binding 1.0](http://go.microsoft.com/fwlink/?LinkId=96710)  
+  
+-   [Basic Security Profile 1.0 草案](http://go.microsoft.com/fwlink/?LinkId=96711)  
+  
+## 参照  
+ [システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)   
+ [メッセージング プロトコル](../../../../docs/framework/wcf/feature-details/messaging-protocols.md)   
+ [データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)   
+ [WSDL とポリシー](../../../../docs/framework/wcf/feature-details/wsdl-and-policy.md)   
+ [セキュリティ プロトコル](../../../../docs/framework/wcf/feature-details/security-protocols.md)   
+ [信頼できるメッセージング プロトコル バージョン 1.0](../../../../docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-0.md)   
+ [リライアブル メッセージング プロトコル バージョン 1.1](../../../../docs/framework/wcf/feature-details/reliable-messaging-protocol-version-1-1.md)   
+ [トランザクション プロトコル](../../../../docs/framework/wcf/feature-details/transaction-protocols.md)   
+ [コンテキスト交換プロトコル](../../../../docs/framework/wcf/feature-details/context-exchange-protocol.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md b/docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md
new file mode 100644
index 00000000000..f0527563411
--- /dev/null
+++ b/docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md
@@ -0,0 +1,124 @@
+---
+title: "システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WS-プロトコル"
+  - "Web サービス プロトコル"
+  - "Windows Communication Foundation、Web サービス プロトコル"
+ms.assetid: 1f7fc4ff-30fe-4e46-adda-91caad3b06c6
+caps.latest.revision: 39
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、Web サービス仕様と呼ばれる一連の仕様をサポートする Web サービスと相互運用できるように構築されています。 相互運用性のベスト プラクティスについては、サービスの構成を簡略化する[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]3 つの相互運用可能なシステム指定のバインディングが導入されています: <xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName>、 <xref:System.ServiceModel.WSHttpBinding?displayProperty=fullName>、および<xref:System.ServiceModel.WSDualHttpBinding?displayProperty=fullName>します。 Advancement 構造化情報標準 (OASIS) 標準では、組織との相互運用性の[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]1 つの相互運用可能なシステム指定のバインディングが含まれています: <xref:System.ServiceModel.WS2007HttpBinding?displayProperty=fullName>します。 メタデータの公開の[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]2 つの相互運用可能なシステム指定のバインディングが含まれています: [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md)と[ <> \</> \>](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md)します。 このトピックでは、システム指定の相互運用可能なバインディングがサポートする仕様を示します。  
+  
+## <a name="web-services-protocols-supported-by-basichttpbinding-wshttpbinding-ws2007httpbinding-and-wsdualhttpbinding-bindings"></a>basicHttpBinding、wsHttpBinding、ws2007HttpBinding、および wsDualHttpBinding の各バインディングでサポートされる Web サービス プロトコル  
+  
+### <a name="all-bindings"></a>すべてのバインディング  
+ The [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md), [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md), and [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/ws2007httpbinding.md) bindings support the following protocols.  
+  
+> [!NOTE]
+>  メタデータの公開に使用するバインディングについては、このトピックで後述する「システム指定のメタデータ バインディング」を参照してください。  
+  
+|カテゴリ|プロトコル|仕様と用途|  
+|--------------|--------------|-----------------------------|  
+|Transport|HTTP 1.1|[HTTP 1.1](http://go.microsoft.com/fwlink/?LinkId=84048)<br /><br /> `BasicHttpBinding`、`WSHttpBinding`、および `WS2007HttpBinding` は、HTTP トランスポートおよび HTTPS トランスポートを使用します。|  
+|メッセージング|MTOM|[MTOM](http://go.microsoft.com/fwlink/?LinkId=95326)<br /><br /> `basicHttpBinding`、`wsHttpBinding`、および `ws2007HttpBinding` は、MTOM (Message Transmission Optimization Mechanism) をサポートしています。 既定では使用されません。 MTOM を使用するには、`messageEncoding` 属性を `"Mtom"` に設定します。<br /><br /> 例:<br /><br /> `<wsHttpBinding> <binding messageEncoding="Mtom"/> </wsHttpBinding>`|  
+|メタデータ|WSDL 1.1|[WSDL 1.1](http://go.microsoft.com/fwlink/?LinkId=94859)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービスの記述に Web サービス記述言語 (WSDL) を使用します。|  
+|メタデータ|WS-Policy|[Ws-policy](http://go.microsoft.com/fwlink/?LinkId=94864)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ドメイン固有のアサーションと共に WS-Policy 仕様を使用して、サービス要件と機能を記述します。|  
+|メタデータ|WS-Policy 1.5|[Ws-policy 1.5](http://go.microsoft.com/fwlink/?LinkId=95327)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ドメイン固有のアサーションと共に WS-Policy 仕様を使用して、サービス要件と機能を記述します。|  
+|メタデータ|WS-PolicyAttachment|[Ws-policyattachment](http://go.microsoft.com/fwlink/?LinkId=95328)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、Web サービス記述言語 (WSDL) のさまざまなスコープでポリシー式を関連付けるために、WS-PolicyAttachment を実装しています。|  
+|メタデータ|WS-MetadataExchange|[Ws-metadataexchange](http://go.microsoft.com/fwlink/?LinkId=94868)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、XML スキーマ、WSDL、WS-Policy を取得するために WS-MetadataExchange が実装されています。|  
+  
+### <a name="basichttpbinding"></a>basicHttpBinding  
+  
+|カテゴリ|プロトコル|仕様と用途|  
+|--------------|--------------|-----------------------------|  
+|メッセージング|SOAP 1.1|[SOAP 1.1](http://go.microsoft.com/fwlink/?LinkId=90520)<br /><br /> Basic Profile 1.1 に従って、`basicHttpBinding` 要素は SOAP 1.1 メッセージ プロトコルを実装しています。|  
+|セキュリティ|WSS SOAP Message Security 1.0|[WSS SOAP Message Security 1.0](http://go.microsoft.com/fwlink/?LinkId=94684)<br /><br /> Basic Security Profile に従って、`basicHttpBinding` 要素は、ユーザー名/パスワードおよび X.509 ベースのセキュリティを実現するために、WSS (Web Services Security) SOAP Message Security 1.0 仕様を実装しています。<br /><br /> `<basicHttpBinding> <binding name="Binding1"> <security mode="TransportWithMessageCredential &#124;                     "Message" .../> </binding> </basicHttpBinding>`|  
+|セキュリティ|WSS SOAP Message Security UsernameToken Profile 1.0|[WSS SOAP Message Security UsernameToken Profile 1.0](http://go.microsoft.com/fwlink/?LinkId=95334)<br /><br /> `<basicHttpBinding> <binding name="Binding1"> <security mode="TransportWithMessageCredential"> <transport clientCredentialType="Basic"/> </security> </basicHttpBinding>`|  
+|セキュリティ|WSS SOAP Message Security X.509 証明書 Token Profile 1.0|[WSS SOAP Message Security X.509 証明書 Token Profile 1.0](http://go.microsoft.com/fwlink/?LinkId=95335)<br /><br /> `<basicHttpBinding>   <security mode="Message"> <message clientCredentialType="Certificate"/> </security> </basicHttpBinding>`|  
+  
+### <a name="wshttpbinding-ws2007httpbinding-and-wsdualhttpbinding"></a>wsHttpBinding、ws2007HttpBinding、および wsDualHttpBinding  
+  
+|カテゴリ|プロトコル|仕様と用途|  
+|--------------|--------------|-----------------------------|  
+|メッセージング|SOAP 1.2|[入門](http://go.microsoft.com/fwlink/?LinkId=48282)<br /><br /> [メッセージング フレームワーク](http://go.microsoft.com/fwlink/?LinkId=94664)<br /><br /> [Adjuncts (HTTP バインディングを含む)](http://go.microsoft.com/fwlink/?LinkId=95329)|  
+|メッセージング|Ws-addressing 2005/08|[Web Services Addressing 1.0 - コア](http://go.microsoft.com/fwlink/?LinkId=90574)<br /><br /> [Web Services Addressing 1.0 - SOAP](http://go.microsoft.com/fwlink/?LinkId=95330)<br /><br /> `wsHttpBinding`、`ws2007HttpBinding`、および `wsDualHttpBinding` は、非同期メッセージング、メッセージ相関、およびトランスポート中立のアドレス指定機構を有効にするために、W3C (World Wide Web Consortium) WS-Addressing 勧告を実装しています。<br /><br /> WCF は WS-Addressing ヘッダーの暗号化をサポートしていませんが、これは WS-* 仕様によって許可されています。|  
+|メッセージング|WS-Addressing 1.0 - メタデータ|[Ws-addressing 1.0 メタデータ](http://www.w3.org/2007/05/addressing/metadata)1.2 (既定値) に設定されると ServiceMetadata 動作のポリシーのバージョンを設定してこのプロトコルのサポートが有効になっている、1.5 に設定されると、wsdl 記述は Ws-addressing の wsdl に準拠して、wsdl 記述は ws-addressing メタデータに準拠しています。<br /><br /> WCF は WS-Addressing ヘッダーの暗号化をサポートしていませんが、これは WS-* 仕様によって許可されています。|  
+|セキュリティ|WSS SOAP Message Security 1.0|[WSS SOAP Message Security 1.0](http://go.microsoft.com/fwlink/?LinkId=94684)<br /><br /> `securityMode` 属性が "wsSecurityOverHttp" (既定) に設定され、`wsSecurity` 子要素を使用してパラメーターが構成されている場合に使用します。<br /><br /> `<wsHttpBinding>   <binding name="myBinding">      <security mode="Message" .../>   </binding> </wsHttpBinding>`|  
+|セキュリティ|WSS SOAP Message Security UsernameToken Profile 1.1|[WSS SOAP Message Security UsernameToken Profile 1.0](http://go.microsoft.com/fwlink/?LinkId=95331)<br /><br /> `wsSecurity` 要素の `authenticationMode` 属性が "Username" に設定されている場合に使用します。<br /><br /> `<wsHttpBinding>   <binding name="MyBinding">     <security mode="Message>       <message           clientCredentialType="UserName        negotiateServiceCredential="false"        establishSecurityContext="false"/>     </security> </binding> </wsHttpBinding>`|  
+|セキュリティ|WSS SOAP Message Security X.509 Certificate Token Profile 1.1|[WSS SOAP Message Security X.509 証明書トークン Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=95332)<br /><br /> `wsSecurity` 要素の `authenticationMode` 属性が "Username"、"Certificate"、または "None" に設定されている場合に、メッセージを保護するために使用します。 また、`wsSecurity` 要素の `authenticationMode` 属性が "Certificate" に設定されている場合は、クライアント認証に使用します。<br /><br /> `<wsHttpBinding>   <binding name="MyBinding">     <security mode="Message>       <message           clientCredentialType="Certificate"        negotiateServiceCredential="false"        establishSecurityContext="false"/>     </security>   </binding> </wsHttpBinding>`|  
+|セキュリティ|WSS SOAP Message Security Kerberos Token Profile 1.1|[WSS SOAP Message Security Kerberos トークン Profile 1.1](http://go.microsoft.com/fwlink/?LinkId=95333)<br /><br /> `wsSecurity` 要素の `authenticationMode` 属性が "Windows" に設定されている場合に、認証とメッセージの保護に使用します。<br /><br /> `<wsHttpBinding>   <binding name="MyBinding">     <security mode="Message>       <message           clientCredentialType="Windows"        negotiateServiceCredential="false"        establishSecurityContext="false"/>     </security>   </binding> </wsHttpBinding>`|  
+|セキュリティ|WS-SecureConversation|[Ws-secureconversation](http://go.microsoft.com/fwlink/?LinkId=95317)<br /><br /> `security/@mode` 属性が "Message" に設定され、`message/@establishSecurityContext` 属性が "true" (既定値) に設定されている場合に、セッションをセキュリティで保護するために使用します。|  
+|セキュリティ|WS-Trust|[WS 信頼](http://go.microsoft.com/fwlink/?LinkId=95318)<br /><br /> WS-SecureConversation で使用されます (上記を参照)。|  
+|信頼できるメッセージ機能|WS-ReliableMessaging|[Ws-reliablemessaging](http://go.microsoft.com/fwlink/?LinkId=95322)<br /><br /> バインディングが `reliableSession` を使用するように構成されている場合に使用します。<br /><br /> `<wsHttpBinding>  <binding name="myBinding">    <reliableSession/>   </binding> </wsHttpBinding>`|  
+|トランザクション|WS-AtomicTransaction|[Ws-atomictransaction](http://go.microsoft.com/fwlink/?LinkId=95323)<br /><br /> トランザクション マネージャー間の通信に使用します。 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のクライアントとサービスは、常にローカル トランザクション マネージャーを使用します。|  
+|トランザクション|WS-Coordination|[Ws-coordination 仕様](http://go.microsoft.com/fwlink/?LinkId=95324)<br /><br /> `flowTransactions` 属性が "Allowed" または "Required" に設定されている場合に、トランザクション コンテキストをフローするために使用します。<br /><br /> `<wsHttpBinding>   <binding transactionFlow="true"/> </wsHttpBinding>`|  
+  
+## <a name="wsfederationhttpbinding-and-ws2007federationhttpbinding"></a>wsFederationHttpBinding および ws2007FederationHttpBinding  
+ [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)と[ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/ws2007federationhttpbinding.md)サード パーティがクライアントの認証に使用されるトークンを発行、フェデレーション シナリオをサポートする要素が導入されています。 `wsHttpBinding` で使用されるプロトコルに加えて、`wsFederationHttpBinding` では次のものを使用します。  
+  
+-   トークンを発行するための `WS-Trust`  
+  
+-   最も一般的に発行されるトークンの形式のための WSS SAML (Security Assertions Markup Language) Token Profile 1.0 および 1.1  
+  
+ 例:  
+  
+```  
+<wsFederationHttpBinding>  
+  <binding name="myBinding">  
+     <security mode="Message">  
+       <message issuedKeyType="Symmetric"   
+                issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1">  
+         <issuerMetadata address =   
+         'http://localhost/FederationSample/HomeRealmSTS/STS.svc/mex'>  
+       </message>  
+     </security>  
+  </binding>  
+</wsFederationHttpBinding>  
+```  
+  
+ [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)します。  
+  
+## <a name="system-provided-metadata-bindings"></a>システム指定のメタデータ バインディング  
+ 次の表に、によって公開されているシステム指定の相互運用可能なメタデータ バインディングによってサポートされるプロトコル、 <xref:System.ServiceModel.Description.MetadataExchangeBindings?displayProperty=fullName>クラスです。  
+  
+### <a name="mexhttpbinding"></a>mexHttpBinding  
+ [ <> \> ](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md)バインディングは、次のプロトコルをサポートします。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]このバインディングを使用して表示[メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)します。  
+  
+|カテゴリ|プロトコル|仕様と用途|  
+|--------------|--------------|-----------------------------|  
+|Transport|HTTP 1.1|[HTTP 1.1](http://go.microsoft.com/fwlink/?LinkId=84048)|  
+|メッセージング|SOAP 1.2|[入門](http://go.microsoft.com/fwlink/?LinkId=48282)<br /><br /> [メッセージング フレームワーク](http://go.microsoft.com/fwlink/?LinkId=94664)<br /><br /> [Adjuncts (HTTP バインディングを含む)](http://go.microsoft.com/fwlink/?LinkId=95329)|  
+|メッセージング|Ws-addressing 2005/08|[Web Services Addressing 1.0 - コア](http://go.microsoft.com/fwlink/?LinkId=90574)<br /><br /> [Web Services Addressing 1.0 - SOAP](http://go.microsoft.com/fwlink/?LinkId=95330)|  
+|メタデータ|WS-MetadataExchange|[Ws-metadataexchange](http://go.microsoft.com/fwlink/?LinkId=94868)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、XML スキーマ、WSDL、WS-Policy を取得するために WS-MetadataExchange が実装されています。|  
+  
+### <a name="mexhttpsbinding"></a>mexHttpsBinding  
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md)次のプロトコルをサポートしています。 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]このバインディングを使用して表示[メタデータの公開](../../../../docs/framework/wcf/feature-details/publishing-metadata.md)します。  
+  
+|カテゴリ|プロトコル|仕様と用途|  
+|--------------|--------------|-----------------------------|  
+|Transport|HTTP 1.1|[HTTP 1.1](http://go.microsoft.com/fwlink/?LinkId=84048)<br /><br /> トランスポート セキュリティは有効です。|  
+|メッセージング|SOAP 1.2|[入門](http://go.microsoft.com/fwlink/?LinkId=48282)<br /><br /> [メッセージング フレームワーク](http://go.microsoft.com/fwlink/?LinkId=94664)<br /><br /> [Adjuncts (HTTP バインディングを含む)](http://go.microsoft.com/fwlink/?LinkId=95329)|  
+|メッセージング|Ws-addressing 2005/08|[Web Services Addressing 1.0 - コア](http://go.microsoft.com/fwlink/?LinkId=90574)<br /><br /> [Web Services Addressing 1.0 - SOAP](http://go.microsoft.com/fwlink/?LinkId=95330)|  
+|メタデータ|WS-MetadataExchange|[Ws-metadataexchange](http://go.microsoft.com/fwlink/?LinkId=94868)<br /><br /> [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、XML スキーマ、WSDL、WS-Policy を取得するために WS-MetadataExchange が実装されています。|  
+  
+## <a name="see-also"></a>関連項目  
+ [システム指定のバインディング](../../../../docs/framework/wcf/system-provided-bindings.md)   
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)   
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)   
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)   
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpsbinding.md)   
+ [<>\>](../../../../docs/framework/configure-apps/file-schema/wcf/mexhttpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/workflow-control-endpoint.md b/docs/framework/wcf/feature-details/workflow-control-endpoint.md
new file mode 100644
index 00000000000..16c411328ff
--- /dev/null
+++ b/docs/framework/wcf/feature-details/workflow-control-endpoint.md
@@ -0,0 +1,62 @@
+---
+title: "ワークフロー コントロール エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b883334-1590-4fbb-b0d6-65197efe0700
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ワークフロー コントロール エンドポイント
+ワークフロー コントロール エンドポイントは、開発者が管理操作を呼び出して、<xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされているワークフロー インスタンスをリモート制御できるようにします。この機能を使用すると、一時停止、再開、終了などの管理操作をプログラムで実行することができます。  
+  
+> [!WARNING]
+>  トランザクション内でワークフロー コントロール エンドポイントを使用していて、コントロールされているワークフローに <xref:System.Activities.Statements.Persist> アクティビティが含まれている場合、ワークフロー インスタンスはトランザクションがタイムアウトするまでハングします。  
+  
+## ワークフロー インスタンスの管理  
+ [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] は、<xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> と呼ばれる新しいコントラクトを定義します。このコントラクトは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされるワークフロー インスタンスをリモート制御できるようにする一連の管理操作を定義します。<xref:System.ServiceModel.Activities.WorkflowControlEndpoint> は、<xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> コントラクトの実装を提供する標準のエンドポイントです。<xref:System.ServiceModel.Activities.WorkflowControlClient> は、管理操作を <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> に送信するために使用するクラスです。  
+  
+ ワークフロー インスタンスには、次の状態があります。  
+  
+ Active  
+ 完了した状態に達する前の、一時停止の状態でないときのワークフロー インスタンスの状態です。この状態にあるときのワークフロー インスタンスは、アプリケーション メッセージを実行し、処理します。  
+  
+ Suspended  
+ この状態にある間は、まだ実行が開始されていないアクティビティや、部分的に実行されているアクティビティがある場合でも、ワークフロー インスタンスは実行されません。  
+  
+ Completed  
+ ワークフロー インスタンスの最終的な状態です。この状態に達した後は、ワークフロー インスタンスは実行できません。  
+  
+## IWorkflowInstanceManagement  
+ <xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> インターフェイスでは、同期バージョンおよび非同期バージョンで、一連の管理操作が定義されます。トランザクション処理されたバージョンでは、トランザクションに対応するバインディングを使用する必要があります。次の表は、サポートされる管理操作の一覧を示します。  
+  
+|管理操作|説明|  
+|----------|--------|  
+|Abort|ワークフロー インスタンスの実行を強制的に停止します。|  
+|Cancel|ワークフロー インスタンスをアクティブ状態または一時停止状態から完了状態に移行します。|  
+|Run|ワークフロー インスタンスに実行する機会を提供します。|  
+|Suspend|ワークフロー インスタンスをアクティブ状態から一時停止状態に移行します。|  
+|Terminate|ワークフロー インスタンスをアクティブ状態または一時停止状態から完了状態に移行します。|  
+|Unsuspend|ワークフロー インスタンスを一時停止状態からアクティブ状態に移行します。|  
+|TransactedCancel|クライアントからフローされた、またはローカルに作成されたトランザクションの下で Cancel 操作を実行します。システムでワークフロー インスタンスの永続状態が維持される場合は、ワークフロー インスタンスが、この操作の実行中に持続している必要があります。|  
+|TransactedRun|クライアントからフローされた、またはローカルに作成されたトランザクションの下で Run 操作を実行します。システムでワークフロー インスタンスの永続状態が維持される場合は、ワークフロー インスタンスが、この操作の実行中に持続している必要があります。|  
+|TransactedSuspend|クライアントからフローされた、またはローカルに作成されたトランザクションの下で Suspend 操作を実行します。システムでワークフロー インスタンスの永続状態が維持される場合は、ワークフロー インスタンスが、この操作の実行中に持続している必要があります。|  
+|TransactedTerminate|クライアントからフローされた、またはローカルに作成されたトランザクションの下で Terminate 操作を実行します。システムでワークフロー インスタンスの永続状態が維持される場合は、ワークフロー インスタンスが、この操作の実行中に持続している必要があります。|  
+|TransactedUnsuspend|クライアントからフローされた、またはローカルに作成されたトランザクションの下で Unsuspend 操作を実行します。システムでワークフロー インスタンスの永続状態が維持される場合は、ワークフロー インスタンスが、この操作の実行中に持続している必要があります。|  
+  
+ <xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> コントラクトは、新しいワークフロー インスタンスを作成する手段を提供せず、既存のワークフロー インスタンスを管理する手段のみを提供します。新しいワークフロー インスタンスをリモートから作成する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー サービス ホストの拡張機能](../../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md)」を参照してください。  
+  
+## WorkflowControlEndpoint  
+ <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> は、固定コントラクト <xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> を持つ標準のエンドポイントです。<xref:System.ServiceModel.Activities.WorkflowServiceHost> インスタンスにこのエンドポイントが追加されると、このエンドポイントを使用して、ホスト インスタンスによってホストされる任意のワークフロー インスタンスにコマンド操作を送信できます。標準のエンドポイント[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[標準エンドポイント](../../../../docs/framework/wcf/feature-details/standard-endpoints.md)」を参照してください。  
+  
+## WorkflowControlClient  
+ <xref:System.ServiceModel.Activities.WorkflowControlClient> は、<xref:System.ServiceModel.Activities.WorkflowServiceHost> の <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> に制御メッセージを送信できるようにするクラスです。このクラスには、トランザクション処理された操作を除き、<xref:System.ServiceModel.Activities.IWorkflowInstanceManagement> コントラクトでサポートされる各操作用のメソッドが格納されています。<xref:System.ServiceModel.Activities.WorkflowControlClient> では、アンビエント トランザクションを使用して、トランザクション処理された操作を使用する必要があるかどうかが判断されます。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/workflow-service-host-extensibility.md b/docs/framework/wcf/feature-details/workflow-service-host-extensibility.md
new file mode 100644
index 00000000000..1351eddffac
--- /dev/null
+++ b/docs/framework/wcf/feature-details/workflow-service-host-extensibility.md
@@ -0,0 +1,62 @@
+---
+title: "ワークフロー サービス ホストの拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0e8f7bb-cb13-49ec-852f-b85d7c23972f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# ワークフロー サービス ホストの拡張機能
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] には、ワークフロー サービスをホストするための <xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスがあります。  このクラスは、マネージ アプリケーションまたは Windows サービスで、ワークフロー サービスを自己ホストするときに使用します。  また、このクラスは、インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) を使用してワークフロー サービスをホストするときにも使用します。  <xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスは、カスタムの拡張機能の追加、アイドル動作の変更、およびサービス以外のワークフロー \(メッセージング アクティビティを使用しないワークフロー\) のホストを可能にする拡張ポイントを提供します。  
+  
+## ワークフロー サービス ホストの拡張機能  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> には、<xref:System.ServiceModel.Activities.WorkflowServiceHost> に拡張機能を追加するメソッドを提供する、<xref:System.Activities.Hosting.WorkflowInstanceExtensionManager> 型の <xref:System.ServiceModel.Activities.WorkflowServiceHost.WorkflowExtensions%2A> プロパティがあります。  各ワークフロー サービス インスタンスに拡張機能を追加するには、<xref:System.Activities.Hosting.WorkflowInstanceExtensionManager.Add%2A> メソッドを使用します。  指定されたデリゲートは、ワークフロー サービス インスタンスが作成されるとき、または永続化ストアから読み込まれるときに、新しい拡張機能を作成するために呼び出されます。  各ワークフロー サービス ホストに拡張機能を追加するには、<xref:System.Activities.Hosting.WorkflowInstanceExtensionManager.Add%2A> メソッドを使用します。追加された拡張機能の 1 つのインスタンスが、すべてのワークフロー サービス インスタンスで共有されます。  
+  
+## ハンドルされない例外の処理  
+ <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> を使用すると、ワークフロー サービス内でハンドルされない例外が発生したときに実行されるアクションを指定できます。  <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior.Action%2A> プロパティには、次の <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> 値のいずれかを指定します。  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> – ワークフロー サービス インスタンスを中止します。  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> – 前回永続化された状態にロールバックし、ワークフロー サービス インスタンスを中断します。  これは、ワークフローが既に 1 回以上、永続化されている場合にのみ実行されます。  永続化されたことがない場合は、ワークフロー インスタンスが中止されます。  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> – インスタンスを取り消します。  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> – ワークフロー インスタンスを終了します。  
+  
+ この動作は、次の例に示すように、コードで構成できます。  
+  
+```csharp  
+host.Description.Behaviors.Add(new WorkflowUnhandledExceptionBehavior { Action = WorkflowUnhandledExceptionAction.Abandon });  
+  
+```  
+  
+ また、次の例のように、構成ファイルで構成することもできます。  
+  
+```vb-c#  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <workflowUnhandledExceptionBehavior action="Abandon" />        
+        </behavior>  
+      </serviceBehaviors>  
+  
+```  
+  
+## サービス以外のワークフローのホスティング  
+ <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用すると、サービス以外のワークフロー、つまり、<xref:System.ServiceModel.Activities.Receive> アクティビティで開始されないワークフロー、またはメッセージング アクティビティを使用しないワークフローをホストできます。  ワークフロー サービスは、通常、<xref:System.ServiceModel.Activities.Receive> アクティビティで開始されます。  <xref:System.ServiceModel.Activities.WorkflowServiceHost> がワークフロー サービスに対するメッセージを受信すると、ワークフロー サービスが実行 \(または永続化\) されていない場合は、新しいワークフロー サービス インスタンスが作成されます。  ワークフローが Receive アクティビティで開始されない場合は、メッセージを受信するアクティビティがないため、このワークフローは、メッセージを送信して開始することはできません。  サービス以外のワークフローをホストするには、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> から派生クラスを作成し、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetInstanceId%2A>、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetCreationContext%2A>、および <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnResolveBookmark%2A> をオーバーライドします。  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetInstanceId%2A> をオーバーライドすると、優先するインスタンスの ID を指定できます。  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnGetCreationContext%2A> をオーバーライドすると、カスタムのワークフロー作成コンテキストを作成したり、既存の <xref:System.ServiceModel.Activities.WorkflowCreationContext> インスタンスを設定したりできます。  <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint.OnResolveBookmark%2A> をオーバーライドすると、受信メッセージから手動でブックマークを抽出できます。  このメソッドをオーバーライドすると、WorkflowHostingEndpoint に送信されたメッセージに応答するために本文で <xref:System.ServiceModel.Activities.WorkflowHostingResponseContext.SendResponse%2A> を呼び出す必要があります。  これを呼び出さないと、<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentCalls%2A> の制限を最終的に超過する可能性があります。  双方向コントラクトでは、応答を受信するために発生したクライアントのエラーのために、<xref:System.ServiceModel.Activities.WorkflowHostingResponseContext.SendResponse%2A> の呼び出しで発生したエラーを検出できる可能性があります。  一方向コントラクトでは、<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentCalls%2A> スロットルの制限を超過するまで <xref:System.ServiceModel.Activities.WorkflowHostingResponseContext.SendResponse%2A> を呼び出していないというミスを認識しない可能性があります。  詳細については、「[WorkflowHostingEndpoint 再開ブックマーク](../../../../docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md)」を参照してください。サービス以外のワークフローの新しいインスタンスを作成するには、新しいインスタンスを作成する操作を定義するサービス コントラクトを宣言します。  作成操作は、必要なワークフロー パラメーターを渡すために、IDictionary\<string, object\> を受け取る必要があります。  このコントラクトは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> の派生クラスによって、暗黙で実装されます。  ワークフローをホストする場合は、<xref:System.ServiceModel.Activities.WorkflowServiceHost.AddServiceEndpoint%2A> を呼び出して <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> の派生クラスのインスタンスをホストに追加し、<xref:System.ServiceModel.Activities.WorkflowServiceHost.Open%2A> を呼び出します。  ワークフローのインスタンスを作成するには、使用するサービス コントラクト型の <xref:System.ServiceModel.ChannelFactory%601> を作成し、<xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A> を呼び出します。  これで、サービス コントラクトに定義されている作成操作を呼び出すことができます。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/workflow-service-host-internals.md b/docs/framework/wcf/feature-details/workflow-service-host-internals.md
new file mode 100644
index 00000000000..73babba804b
--- /dev/null
+++ b/docs/framework/wcf/feature-details/workflow-service-host-internals.md
@@ -0,0 +1,66 @@
+---
+title: "ワークフロー サービス ホストの内部 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: af44596f-bf6a-4149-9f04-08d8e8f45250
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ワークフロー サービス ホストの内部
+<xref:System.ServiceModel.WorkflowServiceHost> では、ワークフロー サービスのホストが提供されます。これにより、受信メッセージをリッスンして、該当するワークフロー サービス インスタンスにルーティングし、アイドル状態のワークフローのアンロードおよび永続化を制御できます。このトピックでは、WorkflowServiceHost がどのように受信メッセージを処理するかについて説明します。  
+  
+## WorkflowServiceHost の概要  
+ <xref:System.ServiceModel.WorkflowServiceHost> クラスは、ワークフロー サービスをホストするために使用されます。このクラスは、受信メッセージをリッスンして、該当するサービス インスタンスにルーティングし、必要に応じて、新しいインスタンスを作成するか、永続ストレージから既存のインスタンスを読み込みます。次の図は、<xref:System.ServiceModel.WorkflowServiceHost> の動作の概要を示しています。  
+  
+ ![WorkflowServiceHost の概要](../../../../docs/framework/wcf/feature-details/media/wfshhighlevel.gif "WFSHHighLevel")  
+  
+ この図では、<xref:System.ServiceModel.WorkflowServiceHost> は .xamlx ファイルからワークフロー サービス定義を読み込み、構成ファイルから構成情報を読み込みます。また、追跡プロファイルから追跡構成を読み込みます。<xref:System.ServiceModel.WorkflowServiceHost> によって、ワークフロー インスタンスへの制御操作の送信を可能にするワークフロー コントロール エンドポイントが公開されます。詳細については、「[ワークフロー コントロール エンドポイント](../../../../docs/framework/wcf/feature-details/workflow-control-endpoint.md)」および「[ワークフロー管理エンドポイントのサンプル](../../../../docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md)」を参照してください。  
+  
+ <xref:System.ServiceModel.WorkflowServiceHost> によって、受信アプリケーション メッセージをリッスンするアプリケーション エンドポイントも公開されます。受信メッセージが到着すると、該当するワークフロー サービス インスタンスに送られます \(現在読み込み中の場合\)。必要に応じて、新しいワークフロー インスタンスが作成されます。既存のインスタンスが永続化されている場合は、永続ストアから読み込まれます。  
+  
+## WorkflowServiceHost の詳細  
+ 次の図は、<xref:System.ServiceModel.WorkflowServiceHost> がメッセージを処理する方法をさらに詳細に示しています。  
+  
+ ![ワークフロー サービス ホストのメッセージ フロー](../../../../docs/framework/wcf/feature-details/media/wfshmessageflow.gif "WFSHMessageFlow")  
+  
+ この図には、3 つの異なるエンドポイント \(アプリケーション エンドポイント、ワークフロー コントロール エンドポイント、およびワークフローをホストするエンドポイント\) が示されています。アプリケーション エンドポイントは、特定のワークフロー インスタンスにバインドされたメッセージを受信します。ワークフロー コントロール エンドポイントは、制御操作をリッスンします。ワークフローをホストするエンドポイントは、<xref:System.ServiceModel.WorkflowServiceHost> がサービス以外のワークフローを読み込んで実行するためのメッセージをリッスンします。この図が示すように、すべてのメッセージは、WCF ランタイム中に処理されます。ワークフロー サービス インスタンスの調整は、<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentInstances%2A> プロパティを使用して実現されます。このプロパティは、同時ワークフロー サービス インスタンスの数を制限します。この調整を超過すると、新しいワークフロー サービス インスタンスの追加要求または永続化されたワークフロー インスタンスのアクティブ化の要求がキューに置かれます。キューに置かれた要求は、新規インスタンスと実行中の永続化されたインスタンスのどちらに対するものであるかにかかわらず、FIFO 順で処理されます。未処理の例外の処理方法およびアイドル状態のワークフロー サービスのアンロードおよび永続化方法を指定するホスト ポリシー情報が読み込まれます。これらのトピック[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー サービスの未処理の例外動作を構成する方法](../../../../docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md)」および「[WorkflowServiceHost を使用してアイドル動作を構成する方法](../../../../docs/framework/wcf/feature-details/how-to-configure-idle-behavior-with-workflowservicehost.md)」を参照してください。ワークフロー インスタンスは、ホスト ポリシーに従って永続化され、必要に応じて再度読み込まれます。ワークフロー永続化の詳細については、「[WorkflowServiceHost を使用して永続性を構成する方法](../../../../docs/framework/wcf/feature-details/how-to-configure-persistence-with-workflowservicehost.md)」、「[長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)」、および「[ワークフローの永続性](../../../../docs/framework/windows-workflow-foundation//workflow-persistence.md)」を参照してください。  
+  
+ 次の図は、WorkflowServiceHost.Open が呼び出されたときの動作を示しています。  
+  
+ ![WorkflowServiceHost.Open が呼び出された場合の処理](../../../../docs/framework/wcf/feature-details/media/wfhostopen.gif "WFHostOpen")  
+  
+ ワークフローが XAML から読み込まれ、アクティビティ ツリーが作成されます。<xref:System.ServiceModel.WorkflowServiceHost> は、アクティビティ ツリーに従い、サービスの記述を作成します。構成がホストに適用されます。最後に、ホストは受信メッセージのリッスンを開始します。  
+  
+ 次の図は、CanCreateInstance が `true` に設定された場合の Receive アクティビティにバインドされたメッセージを受信したときの <xref:System.ServiceModel.WorkflowServiceHost> の動作を示しています。  
+  
+ ![ワークフロー サービス ホストがメッセージを受信した場合の処理](../../../../docs/framework/wcf/feature-details/media/wfhreceivemessagecci.gif "WFHReceiveMessageCCI")  
+  
+ メッセージが到着し、WCF チャネル スタックによって処理されます。スロットルがチェックされ、関連付けクエリが実行されます。既存のインスタンスにバインドされているメッセージは配信されます。新しいインスタンスを作成する必要がある場合は、Receive アクティビティの CanCreateInstance プロパティが確認されます。true に設定されている場合、新しいインスタンスが作成され、メッセージが配信されます。  
+  
+ 次の図は、CanCreateInstance が false に設定された場合の Receive アクティビティにバインドされたメッセージを受信したときの <xref:System.ServiceModel.WorkflowServiceHost> の動作を示しています。  
+  
+ ![WorkflowServiceHost がメッセージを受信した場合の処理](../../../../docs/framework/wcf/feature-details/media/wfshreceivemessage.gif "WFSHReceiveMessage")  
+  
+ メッセージが到着し、WCF チャネル スタックによって処理されます。スロットルがチェックされ、関連付けクエリが実行されます。メッセージが既存のインスタンスにバインドされている場合は \(CanCreateInstance が false に設定されているため\) インスタンスが永続ストアから読み込まれ、ブックマークが再開され、ワークフローが実行されます。  
+  
+> [!WARNING]
+>  SQL Server が NamedPipe プロトコルでのみリッスンするように設定されている場合、ワークフロー サービス ホストは開きません。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [ワークフロー サービスのホスティング](../../../../docs/framework/wcf/feature-details/hosting-workflow-services.md)   
+ [ワークフロー コントロール エンドポイント](../../../../docs/framework/wcf/feature-details/workflow-control-endpoint.md)   
+ [ワークフロー管理エンドポイントのサンプル](../../../../docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md)   
+ [ワークフロー サービスの未処理の例外動作を構成する方法](../../../../docs/framework/wcf/feature-details/config-workflow-unhandled-exception-workflowservicehost.md)   
+ [長時間のワークフロー サービスの作成](../../../../docs/framework/wcf/feature-details/creating-a-long-running-workflow-service.md)   
+ [ワークフローの永続性](../../../../docs/framework/windows-workflow-foundation//workflow-persistence.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/workflow-services-overview.md b/docs/framework/wcf/feature-details/workflow-services-overview.md
new file mode 100644
index 00000000000..2c466262085
--- /dev/null
+++ b/docs/framework/wcf/feature-details/workflow-services-overview.md
@@ -0,0 +1,72 @@
+---
+title: "ワークフロー サービスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e536dda3-e286-441e-99a7-49ddc004b646
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# ワークフロー サービスの概要
+ワークフロー サービスは、ワークフローを使用して実装される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ベースのサービスです。  ワーク フロー サービスは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] メッセージを送受信するメッセージ アクティビティを使用するワークフローです。  .NET Framework 4.5 では、ワークフロー内からメッセージを送受信できるようにする多数のメッセージ アクティビティが導入されています。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] のメッセージング アクティビティ、およびさまざまなメッセージ交換パターンの実装にメッセージ アクティビティを使用できる方法については、「[メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)」を参照してください。  
+  
+## ワークフロー サービスを使用する利点  
+ アプリケーションが分散型になるにつれ、負荷を軽減させるために、個々のサービスが他のサービスを呼び出す役割を果たすようになっています。  これらの呼び出しを非同期操作として実装すると、コードがやや複雑になります。  エラー処理によって、例外処理と詳細な追跡情報の形式がさらに複雑になります。  一部のサービスには、長時間実行されることが多く、入力を待機する間に貴重なシステム リソースを占有するものがあります。  このような問題があるため、分散アプリケーションは、非常に複雑で、作成と保守が困難であることがよくあります。  ワークフローは、特に外部サービスへの呼び出しなど、非同期操作の連携を表す方法として最適です。  また、実行時間が長いビジネス プロセスを表す場合にも効率的です。  ワークフローが、分散環境でのサービス構築に役立つ資産となるのは、これらの特性があるためです。  
+  
+## ワークフロー サービスの実装  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実装するときは、サービスおよびサービスが送受信するデータを説明する一連のコントラクトを定義します。  データは、データ コントラクトとメッセージ コントラクトで表されます。  WCF サービスもワークフロー サービスも、サービスの説明の一環として、データ コントラクトとメッセージ コントラクトの定義を使用します。  サービス自体は、\(WSDL の形で\) メタデータを公開して、サービスの操作を説明します。  WCF では、サービス コントラクトと操作コントラクトによって、サービス、およびサービスがサポートする操作を定義します。  ただし、ワークフロー サービスでは、これらのコントラクトはビジネス プロセス自体の一部です。  これらは、コントラクト推論と呼ばれるプロセスによってメタデータとして公開されます。  ワークフロー サービスが <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされている場合は、ワークフローで見つかった一連のメッセージ アクティビティに基づいて、ワークフロー定義が確認され、コントラクトが生成されます。  具体的には、次のアクティビティとプロパティが、コントラクトの生成に使用されます。  
+  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティ  
+  
+-   <xref:System.ServiceModel.Activities.Receive.ServiceContractName%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.OperationContractName%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.Action%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Receive.ValueType%2A>  
+  
+ <xref:System.ServiceModel.Activities.SendReply> アクティビティ  
+  
+-   <xref:System.ServiceModel.Activities.SendReply.Action%2A>  
+  
+-   <xref:System.ServiceModel.Activities.SendReply.ValueType%2A>  
+  
+ <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティ  
+  
+ コントラクト推論の結果は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと操作コントラクトと同じデータ構造を使用するサービスの説明になります。  この情報を使用して、ワークフロー サービス用に WSDL が公開されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] では、ツール サポートを追加せずに、既存のコントラクト定義を使用してワークフロー サービスを記述することはできません。  ワークフロー サービスのコントラクトは、前述のコントラクト推論プロセスによって作成されます。  ただし、メッセージ コントラクトおよびデータ コントラクトは完全にサポートされます。  
+  
+## ワークフロー サービスと MSMQ ベースのバインディング  
+ WCF は、2 つの MSMQ ベースのバインディングである <xref:System.ServiceModel.NetMsmqBinding> と <xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を定義します。  MSMQ ベースのバインディングは、多くの場合、ワークフロー サービスと共に使用されます。これは、これらのサービスに、実行時間が長いという性質があるためです。  MSMQ ベースのバインディングには、MSMQ メッセージが有効と見なされる時間を指定する `ValidityDuration` プロパティがあります。  ワークフロー サービスは本質的に実行時間が長いため、ワークフロー サービスによるメッセージの処理が可能になる前に、MSMQ メッセージの有効期間が切れることがあります。  そのため、MSMQ バインディングの有効期間を適切な値に設定することが重要です。  この値は、ワークフローとそのメッセージの処理方法に基づいて選択する必要があります。  たとえば、<xref:System.ServiceModel.Activities.Receive> アクティビティがあり、これに続いて 10 分間実行されるカスタム アクティビティがあり、その後に別の <xref:System.ServiceModel.Activities.Receive> アクティビティがある場合、`ValidityDuration` の適切な値は 10 分を超えることになります。  
+  
+## ワークフロー サービスのホスティング  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様、ワークフロー サービスがホストされている必要があります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、<xref:System.ServiceModel.ServiceHost> クラスを使用してサービスをホストし、ワークフロー サービスは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してサービスをホストします。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様に、ワークフロー サービスはさまざまな方法でホストできます。次に例を示します。  
+  
+-   マネージ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーション。  
+  
+-   インターネット インフォメーション サービス \(IIS\)。  
+  
+-   Windows プロセス アクティブ化サービス \(WAS\)。  
+  
+-   マネージ Windows サービス。  
+  
+ マネージ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションまたはマネージ Windows サービスでホストされるワークフロー サービスは、<xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスのインスタンスを作成し、このインスタンスに、<xref:System.ServiceModel.Activities.WorkflowService> プロパティ内のワークフロー定義を含む <xref:System.ServiceModel.Activities.WorkflowService.Body%2A> のインスタンスを渡します。  メッセージ アクティビティを格納するワークフロー定義は、ワークフロー サービスとして公開されます。  
+  
+ ワークフロー サービスを IIS または WAS でホストするには、ワークフロー サービス定義を格納する .xamlx ファイルを仮想ディレクトリに配置します。  既定のエンドポイント \(<xref:System.ServiceModel.BasicHttpBinding> を使用\) は、[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] の[簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)で自動的に作成されます。  また、Web.config ファイルを仮想ディレクトリに配置し、独自のエンドポイントを指定することもできます。  ワークフロー定義がアセンブリ内にある場合は、.svc ファイルを仮想ディレクトリに配置し、ワークフロー アセンブリを App\_Code ディレクトリに配置できます。  この .svc ファイルには、サービス ホスト ファクトリと、ワークフロー サービスを実装するクラスを指定する必要があります。  次の例に、サービス ホスト ファクトリを指定し、ワークフロー サービスを実装するクラスを指定する方法を示します。  
+  
+```  
+<%@ServiceHost Factory=" System.ServiceModel.Activities.Activation.WorkflowServiceHostFactory  
+Service="EchoService"%>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/workflow-services.md b/docs/framework/wcf/feature-details/workflow-services.md
new file mode 100644
index 00000000000..e1a4b3c4cc9
--- /dev/null
+++ b/docs/framework/wcf/feature-details/workflow-services.md
@@ -0,0 +1,54 @@
+---
+title: "ワークフロー サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7b05c766-f181-425d-9a3d-2a5e150c85f7
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# ワークフロー サービス
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] では、ワークフロー ベースのサービスを XAML で宣言によって記述できます。サービスを実装するワークフローの定義、およびサービスが公開するエンドポイントの説明を、すべて XAML で実行できます。このセクションの各トピックでは、宣言によるサービスの記述をサポートするプログラミング モデルについて詳しく説明します。  
+  
+## このセクションの内容  
+ [ワークフロー サービスの概要](../../../../docs/framework/wcf/feature-details/workflow-services-overview.md)  
+ ワークフロー サービスの作成およびホストに関与するコンポーネントについて説明します。  
+  
+ [メッセージング アクティビティ](../../../../docs/framework/wcf/feature-details/messaging-activities.md)  
+ ワークフローがメッセージを送受信できるようにするアクティビティについて説明します。  
+  
+ [方法: メッセージング アクティビティを使用してワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-with-messaging-activities.md)  
+ メッセージング アクティビティを使用してワークフロー サービスを作成する方法について説明します。  
+  
+ [方法: ワークフロー アプリケーションからサービスにアクセスする](../../../../docs/framework/wcf/feature-details/how-to-access-a-service-from-a-workflow-application.md)  
+ ワークフロー アプリケーションからサービスを呼び出す方法について説明します。  
+  
+ [関連付け](../../../../docs/framework/wcf/feature-details/correlation.md)  
+ 相関関係によってメッセージを相互に、またはインスタンスにマップする方法について説明します。  
+  
+ [順番を無視したメッセージの処理](../../../../docs/framework/wcf/feature-details/out-of-order-message-processing.md)  
+ 順番を無視したメッセージを受け入れるようにサービスを構成する方法について説明します。  
+  
+ [方法: 別のワークフロー サービスを呼び出すワークフロー サービスを作成する](../../../../docs/framework/wcf/feature-details/how-to-create-a-workflow-service-that-calls-another-workflow-service.md)  
+ 別のワークフロー サービス内からワークフロー サービスを同期的に呼び出す方法について説明します。  
+  
+ [コントラクト優先ワークフロー サービスの開発](../../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md)  
+ 既存のサービス コントラクトに基づいてワークフロー サービスを作成する方法について説明します。  
+  
+ [既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](../../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)  
+ 既存のサービス コントラクトを使用してワークフロー サービスを作成する例を操作手順に従って説明します。  
+  
+ [ワークフロー サービスのホストの概要](../../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md)  
+ ワークフロー サービスのホストのさまざまな側面について説明します。  
+  
+ [ワークフロー内でのコントラクトの使用](../../../../docs/framework/wcf/feature-details/using-contracts-in-workflow.md)  
+ コントラクトおよびコントラクト推論のさまざまな種類について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/working-with-certificates.md b/docs/framework/wcf/feature-details/working-with-certificates.md
new file mode 100644
index 00000000000..60074898a4f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/working-with-certificates.md
@@ -0,0 +1,182 @@
+---
+title: "証明書の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "証明書 [WCF]"
+ms.assetid: 6ffb8682-8f07-4a45-afbb-8d2487e9dbc3
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 証明書の使用
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のセキュリティをプログラミングする場合、一般に X.509 デジタル証明書を使用して、クライアントとサーバーの認証、暗号化、およびメッセージのデジタル署名を行います。ここでは、X.509 デジタル証明書の機能および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのそれらの機能の使用方法について簡単に説明します。また、これらの概念の詳細を説明するトピックや、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と証明書を使用した一般的なタスクの実行方法が記載されたトピックへのリンクも示します。  
+  
+ 簡単に言うと、デジタル証明書は、*"公開キー基盤 \(PKI: Public Key Infrastructure\)"* の一部です。PKI は、デジタル証明書、証明機関、およびその他の登録機関から成るシステムです。登録機関では、公開キー暗号化を使用して、電子取引に関与する各当事者の有効性の検証と認証を行います。証明機関は証明書を発行します。各証明書には、*"サブジェクト"* \(証明書の発行先のエンティティ\)、有効期間 \(証明書が有効な場合\)、発行者 \(証明書を発行したエンティティ\)、公開キーなどのデータが含まれた一連のフィールドがあります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、これらの各プロパティは <xref:System.IdentityModel.Claims.Claim> \(クレーム\) として処理されます。各クレームは、さらに ID と権限の 2 種類に分けられます。X.509 証明書[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[X.509 公開キー証明書](http://go.microsoft.com/fwlink/?LinkId=209952)」を参照してください。WCF のクレームと承認[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ID モデルを使用したクレームと承認の管理](../../../../docs/framework/wcf/feature-details/managing-claims-and-authorization-with-the-identity-model.md)」を参照してください。PKI 実装[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Server 2008 R2 \- 証明書サービス](http://go.microsoft.com/fwlink/?LinkId=209949)」を参照してください。  
+  
+ 証明書の第一の機能は、他者に対して証明書の所有者の ID を認証することです。証明書は所有者の *"公開キー"* を含んでおり、所有者が秘密キーを保持しています。公開キーを使用して、証明書の所有者に送信されるメッセージを暗号化できます。秘密キーにアクセスできるのは所有者だけであるため、所有者だけが暗号化されたメッセージを復号化できます。  
+  
+ 証明書は、証明機関によって発行される必要があります。多くの場合、証明機関はサードパーティの証明書発行者です。Windows ドメインでは、そのドメインのコンピューターに対して証明書を発行する際に使用できる証明機関が含まれています。  
+  
+## 証明書の表示  
+ 証明書を使用するには、多くの場合、証明書を表示し、プロパティを確認する必要があります。Microsoft 管理コンソール \(MMC: Microsoft Management Console\) スナップイン ツールを使用すると、これを簡単に行うことができます。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md).  
+  
+## 証明書ストア  
+ 証明書はストアに格納されています。2 つの主要なストアがあり、さらにサブストアに分かれています。コンピューターの管理者は、MMC スナップイン ツールを使用して、両方の主要なストアを表示できます。管理者以外のユーザーは、現在のユーザー ストアだけを表示できます。  
+  
+-   **ローカル コンピューター ストア :** このストアには、コンピューター プロセス \([!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] など\) がアクセスする証明書が格納されます。クライアントに対してサーバーを認証するための証明書は、ここに格納します。  
+  
+-   **現在のユーザー ストア :** コンピューターの現在のユーザーの証明書は、通常、対話型アプリケーションによってここに配置されます。クライアント アプリケーションを作成する場合、サービスに対してユーザーを認証するための証明書は、通常、ここに配置します。  
+  
+ 上記の 2 つのストアは、さらにサブストアに分かれています。サブストアの中で、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でプログラミングするときに最も重要なものは次のとおりです。  
+  
+-   **信頼されたルート証明機関 :** このストア内の証明書を使用して、証明書チェーンを作成できます。証明書チェーンをさかのぼることで、このストア内の任意の証明機関証明書に到達できます。  
+  
+    > [!IMPORTANT]
+    >  証明書が信頼されたサードパーティ証明機関から発行されたものではない場合でも、ローカル コンピューターは、このストアに配置された証明書を暗黙で信頼します。したがって、発行者を完全に信頼し、かつ信頼することの結果を理解していない限り、このストアに証明書を配置しないでください。  
+  
+-   **個人 :** このストアは、コンピューターのユーザーに関連付けられた証明書に使用されます。通常、このストアは、信頼されたルート証明機関ストアにある証明機関証明書のいずれかによって発行された証明書に使用されます。また、自己発行され、アプリケーションから信頼された証明書が格納されている場合もあります。  
+  
+ 証明書ストア[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[証明書ストア](http://go.microsoft.com/fwlink/?LinkId=88912)」を参照してください。  
+  
+### ストアの選択  
+ 証明書を格納する場所の選択は、サービスまたはクライアントの実行方法や実行する状況によって異なります。次の一般規則が適用されます。  
+  
+-   WCF サービスが Windows サービスでホストされる場合は、**ローカル コンピューター** ストアを使用します。ローカル コンピューター ストアに証明書をインストールするには、管理特権が必要です。  
+  
+-   サービスまたはクライアントがユーザー アカウントで実行されるアプリケーションである場合は、**現在のユーザー** ストアを使用します。  
+  
+### ストアへのアクセス  
+ ストアは、コンピューター上の一種のフォルダーであり、アクセス制御リスト \(ACL: Access Control List\) によって保護されています。インターネット インフォメーション サービス \(IIS: Internet Information Services\) によってホストされたサービスを作成すると、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アカウントで [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] プロセスが実行されます。このアカウントは、サービスが使用する証明書を格納するストアにアクセス可能である必要があります。各主要ストアは既定のアクセス リストで保護されていますが、これらのリストは変更できます。ストアにアクセスする別のロールを作成した場合、そのロールにアクセス許可を付与する必要があります。WinHttpCertConfig.exe ツールを使用してアクセス リストを変更する方法については、「[方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)」を参照してください。IIS でクライアント証明書を使用する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ASP.NET Web アプリケーションで認証用のクライアント証明書を使用して Web サービスを呼び出す方法](http://go.microsoft.com/fwlink/?LinkId=88914)」を参照してください。  
+  
+## 信頼チェーンと証明機関  
+ 証明書は、各証明書がその発行元の CA にリンクされる階層構造で作成されます。このリンクは CA の証明書へのリンクになります。次に、CA の証明書は元の CA の証明書を発行した CA にリンクします。ルート CA の証明書に到達するまでこのプロセスが繰り返されます。ルート CA の証明書は本質的に信頼されています。  
+  
+ デジタル証明書を使用する場合、この階層 \(*"信頼チェーン"* とも呼ばれます\) に依存してエンティティを認証します。証明書のチェーンを表示するには、MMC スナップインを使用して、証明書をダブルクリックし、**\[証明書パス\]** タブをクリックします。証明機関の証明書チェーンをインポートする方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[方法 : 署名の検証に使用する証明機関の証明書チェーンを指定する](../../../../docs/framework/wcf/feature-details/specify-the-certificate-authority-chain-verify-signatures-wcf.md)」を参照してください。  
+  
+> [!NOTE]
+>  証明書を "信頼されたルート証明機関" 証明書ストアに配置することにより、その証明書の発行者を信頼されたルート証明機関として指定できます。  
+  
+### 信頼チェーンの無効化  
+ 新しいサービスの作成時には、信頼されたルート証明書によって発行されていない証明書を使用できます。また、発行する証明書が、信頼されたルート証明機関ストアになくてもかまいません。開発だけを目的としている場合は、証明書の信頼チェーンをチェックする機構を一時的に無効にできます。これを行うには、`CertificateValidationMode` プロパティを `PeerTrust` または `PeerOrChainTrust` に設定します。これらのモードにより、証明書を自己発行するか \(ピア信頼\)、信頼チェーンに含めるかを指定できます。このプロパティは、次のどのクラスでも設定できます。  
+  
+|クラス|プロパティ|  
+|---------|-----------|  
+|<xref:System.ServiceModel.Security.X509ClientCertificateAuthentication>|<xref:System.ServiceModel.Security.X509ClientCertificateAuthentication.CertificateValidationMode%2A?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>|<xref:System.ServiceModel.Security.X509PeerCertificateAuthentication.CertificateValidationMode%2A?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication>|<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CertificateValidationMode%2A?displayProperty=fullName>|  
+|<xref:System.ServiceModel.Security.IssuedTokenServiceCredential>|<xref:System.ServiceModel.Security.IssuedTokenServiceCredential.CertificateValidationMode%2A?displayProperty=fullName>|  
+  
+ 構成を使用して、このプロパティを設定することもできます。検証モードを指定するには、次の要素を使用します。  
+  
+-   [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md)  
+  
+-   [\<peerAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/peerauthentication-element.md)  
+  
+-   [\<messageSenderAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/messagesenderauthentication-element.md)  
+  
+## カスタム認証  
+ `CertificateValidationMode` プロパティを使用すると、証明書の認証方法をカスタマイズすることもできます。既定では、レベルは `ChainTrust` に設定されています。<xref:System.ServiceModel.Security.X509CertificateValidationMode> 値を使用するには、`CustomCertificateValidatorType` 属性を証明書の検証に使用するアセンブリと型に設定することも必要です。カスタム検証を作成するには、抽象 <xref:System.IdentityModel.Selectors.X509CertificateValidator> クラスから継承する必要があります。  
+  
+ カスタム認証システムを作成する場合、オーバーライドする最も重要なメソッドは <xref:System.IdentityModel.Selectors.X509CertificateValidator.Validate%2A> メソッドです。カスタム認証の例については、「[X.509 証明書検証](../../../../docs/framework/wcf/samples/x-509-certificate-validator.md)」のサンプルを参照してください。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][カスタム資格情報と資格情報の検証](../../../../docs/framework/wcf/extending/custom-credential-and-credential-validation.md).  
+  
+## Makecert.exe を使用した証明書チェーンの構築  
+ 証明書作成ツール \(Makecert.exe\) では、X.509 証明書および秘密キーと公開キーのペアを作成します。秘密キーをディスクに保存し、新しい証明書の発行と署名に使用できるため、チェーンになった証明書の階層をシミュレートできます。このツールは、サービスの開発時に支援ツールとして使用することだけを目的としています。実際の展開に使用する証明書の作成には使用しないでください。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの開発時に、Makecert.exe を使用して信頼チェーンを構築するには、次の手順に従います。  
+  
+#### Makecert.exe を使用して証明書チェーンを構築するには  
+  
+1.  MakeCert.exe ツールを使用して、\(自己発行された\) 一時的なルート証明機関証明書を作成します。秘密キーをディスクに保存します。  
+  
+2.  この新しい証明書を使用して、公開キーを含む別の証明書を発行します。  
+  
+3.  信頼されたルート証明機関ストアに、ルート証明機関証明書をインポートします。  
+  
+4.  手順の詳細については、「[方法 : 開発中に使用する一時的な証明書を作成する](../../../../docs/framework/wcf/feature-details/how-to-create-temporary-certificates-for-use-during-development.md)」を参照してください。  
+  
+## 使用する証明書の選択  
+ 証明書に関する一般的な質問は、どの証明書を使用するかということとその理由に関するものです。その答えは、クライアントとサービスのどちらをプログラミングするかによって異なります。以下に一般的なガイドラインを示します \(これらの質問に対する包括的な答えではありません\)。  
+  
+### サービス証明書  
+ サービス証明書の第一の目的は、クライアントに対してサーバーを認証することです。クライアントがサーバーを認証するときの最初のチェックの 1 つとして、**"サブジェクト"** フィールドの値とサービスへのアクセスに使用する URI \(Uniform Resource Identifier\) が比較されます。この場合、双方の DNS が一致する必要があります。たとえば、サービスの URI が "http:\/\/www.contoso.com\/endpoint\/" の場合、**"サブジェクト"** フィールドにも値 "www.contoso.com" が含まれている必要があります。  
+  
+ このフィールドには複数の値を含めることができますが、各値の先頭にはその値を示す初期化コードが付加されます。通常、初期化コードは共通名 \(Common Name\) を表す "CN" です。たとえば、"CN \= www.contoso.com" のようになります。**"サブジェクト"** フィールドを空白にすることもできます。この場合、**"サブジェクト代替名"** フィールドに値として **DNS 名**を含めることができます。  
+  
+ また、証明書の **"目的"** フィールドの値に、適切な値 \("サーバー認証" や "クライアント認証" など\) を含める必要があります。  
+  
+### クライアント証明書  
+ 通常、クライアント証明書はサードパーティ証明機関によって発行されません。通常は、"クライアント認証" という目的で、ルート証明機関によって、この証明書が現在のユーザー ストアの個人ストアに配置されます。クライアントは、相互認証が必要なときにこのような証明書を使用できます。  
+  
+## オンラインの失効とオフラインの失効  
+  
+### 証明書の有効期間  
+ すべての証明書は、*"有効期間"* と呼ばれる一定の期間にのみ有効です。有効期間は、X.509 証明書の **"Valid from"** フィールドと **"Valid to"** フィールドによって定義されています。認証時に、証明書がまだ有効期間内かどうかを確認するためのチェックが行われます。  
+  
+### 証明書失効リスト  
+ 有効期間中であっても、証明機関が証明書を失効させる場合があります。これは、証明書の秘密キーの侵害など、さまざまな理由によって行われます。  
+  
+ 証明書が失効した場合、失効した証明書から発生した下位のチェーンも無効になり、認証手順において信頼されなくなります。失効した証明書を検出するために、各発行者は日時が記された*"証明書失効リスト"* \(CRL\) を発行します。このリストは、オンラインの失効またはオフラインの失効を使用してチェックできます。これを使用するには、<xref:System.ServiceModel.Security.X509ClientCertificateAuthentication>、<xref:System.ServiceModel.Security.X509PeerCertificateAuthentication>、<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication>、および <xref:System.ServiceModel.Security.IssuedTokenServiceCredential> の各クラスの `RevocationMode` プロパティまたは `DefaultRevocationMode` プロパティを <xref:System.Security.Cryptography.X509Certificates.X509RevocationMode> 列挙値のいずれかに設定します。すべてのプロパティの既定値は、`Online` です。  
+  
+ \([\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md) の\) [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md) と \([\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md) の\) [\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-clientcertificate-element.md) の `revocationMode` 属性を使用することにより、構成でモードを設定することもできます。  
+  
+## SetCertificate メソッド  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、認証、暗号化、またはメッセージのデジタル署名を行うために、多くの場合、サービスまたはクライアントが使用する証明書または証明書のセットを指定する必要があります。これは、X.509 証明書を表すさまざまなクラスの `SetCertificate` メソッドを使用することで、プログラムによって実行できます。`SetCertificate` メソッドを使用して証明書を指定するクラスは次のとおりです。  
+  
+|クラス|メソッド|  
+|---------|----------|  
+|<xref:System.ServiceModel.Security.PeerCredential>|<xref:System.ServiceModel.Security.PeerCredential.SetCertificate%2A>|  
+|<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential>|<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A>|  
+|<xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential>|<xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A>|  
+|<xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential>|  
+|<xref:System.ServiceModel.Security.X509CertificateInitiatorServiceCredential.SetCertificate%2A>|  
+  
+ `SetCertificate` メソッドを使用するには、ストアの場所とストア、証明書のフィールドを指定する "検索" の種類 \(`x509FindType` パラメーター\)、および該当のフィールドで検索する値を指定します。たとえば、次のコードでは、<xref:System.ServiceModel.ServiceHost> インスタンスを作成し、`SetCertificate`  メソッドを使用して、クライアントに対してサービスを認証する際に使用するサービス証明書を設定しています。  
+  
+ [!code-csharp[c_WorkingWithCertificates#1](../../../../samples/snippets/csharp/VS_Snippets_CFX/c_workingwithcertificates/cs/source.cs#1)]
+ [!code-vb[c_WorkingWithCertificates#1](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_workingwithcertificates/vb/source.vb#1)]  
+  
+### 同じ値が含まれた複数の証明書  
+ ストアには、同じサブジェクト名が含まれた複数の証明書が格納されていることがあります。つまり、`x509FindType` に <xref:System.Security.Cryptography.X509Certificates.X509FindType> または <xref:System.Security.Cryptography.X509Certificates.X509FindType> を指定したときに、複数の証明書に同じ値が含まれていると、必要な証明書を区別することができないため、例外がスローされます。この状況は、`x509FindType` を <xref:System.Security.Cryptography.X509Certificates.X509FindType> に設定することによってある程度防ぐことができます。拇印フィールドには一意の値が含まれるため、このフィールドを使用することで、ストア内の特定の証明書を検索できます。ただし、この方法には欠点があります。証明書が失効したり、更新されたりした場合、拇印も失われてしまうため、`SetCertificate` メソッドは失敗します。また、証明書が有効でなくなると、認証が失敗します。このような状況が発生する可能性を軽減する方法として、`x590FindType` パラメーターを <xref:System.Security.Cryptography.X509Certificates.X509FindType> に設定し、発行者の名前を指定します。特定の発行者が必要ではない場合は、その他の <xref:System.Security.Cryptography.X509Certificates.X509FindType> 列挙値のいずれか \(<xref:System.Security.Cryptography.X509Certificates.X509FindType> など\) を設定することもできます。  
+  
+## 構成における証明書  
+ 証明書は、構成を使用して設定することもできます。サービスを作成する場合、[\<serviceBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicebehaviors.md)で証明書をはじめとする資格情報を指定します。クライアントをプログラミングする場合は、[\<endpointBehaviors\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md)で証明書を指定します。  
+  
+## ユーザー アカウントへの証明書のマッピング  
+ IIS と Active Directory には、証明書を Windows ユーザー アカウントにマップできる機能があります。この機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ユーザー アカウントへの証明書のマッピング](http://go.microsoft.com/fwlink/?LinkId=88917)」を参照してください。  
+  
+ Active Directory のマッピングを使用する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ディレクトリ サービス マッピングによるクライアント証明書のマッピング](http://go.microsoft.com/fwlink/?LinkId=88918)」を参照してください。  
+  
+ この機能が有効になっている場合、<xref:System.ServiceModel.Security.X509ClientCertificateAuthentication> クラスの <xref:System.ServiceModel.Security.X509ClientCertificateAuthentication.MapClientCertificateToWindowsAccount%2A> プロパティを `true` に設定できます。構成では、次のコードに示すように、[\<authentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/authentication-of-servicecertificate-element.md) 要素の `mapClientCertificateToWindowsAccount` 属性を `true` に設定できます。  
+  
+```  
+<serviceBehaviors>  
+ <behavior name="MappingBehavior">  
+  <serviceCredentials>  
+   <clientCertificate>  
+    <authentication certificateValidationMode="None" mapClientCertificateToWindowsAccount="true" />  
+   </clientCertificate>  
+  </serviceCredentials>  
+ </behavior>  
+</serviceBehaviors>  
+```  
+  
+ Windows ユーザー アカウントを表すトークンに X.509 証明書をマップすると、Windows トークンを使用して保護されたリソースにアクセスできるため、このマッピングが特権の昇格と見なされます。したがって、マッピングを行う前に、ドメイン ポリシーにそのポリシーに準拠する X.509 証明書が必要となります。この要件は、*"SChannel"* のセキュリティ パッケージによって適用されます。  
+  
+ [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] 以降を使用している場合は、Windows アカウントにマッピングされる前に、証明書がドメイン ポリシーに準拠していることが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって確認されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の最初のリリースでは、ドメイン ポリシーを参照せずにマッピングが実行されます。そのため、マッピングが有効になっており、X.509 証明書がドメイン ポリシーを満たしていない場合は、最初のリリースの下で実行しているときには動作していた古いアプリケーションが動作しなくなる可能性があります。  
+  
+## 参照  
+ <xref:System.ServiceModel.Channels>   
+ <xref:System.ServiceModel.Security>   
+ <xref:System.ServiceModel>   
+ <xref:System.Security.Cryptography.X509Certificates.X509FindType>   
+ [サービスおよびクライアントのセキュリティ保護](../../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/working-with-nats-and-firewalls.md b/docs/framework/wcf/feature-details/working-with-nats-and-firewalls.md
new file mode 100644
index 00000000000..e6772b5bd5c
--- /dev/null
+++ b/docs/framework/wcf/feature-details/working-with-nats-and-firewalls.md
@@ -0,0 +1,75 @@
+---
+title: "NAT とファイアウォールの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ファイアウォール [WCF]"
+  - "NAT [WCF]"
+ms.assetid: 74db0632-1bf0-428b-89c8-bd53b64332e7
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# NAT とファイアウォールの使用
+ネットワーク接続のクライアントとサーバーには、直接開いている通信用のパスが存在しないことがよくあります。パケットは、エンドポイント コンピューター上だけでなく、ネットワーク上の中間コンピューターによってもフィルター処理、ルーティング、分析、および変換されます。ネットワーク アドレス変換 \(NAT: Network Address Translation\) とファイアウォールは、ネットワーク通信に参加できる中間アプリケーションの一般的な例です。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトランスポートとメッセージ交換パターン \(MEP: Message Exchange Pattern\) では、NAT とファイアウォールに対する反応がそれぞれ異なります。ここでは、一般的なネットワーク トポロジで NAT とファイアウォールがどのように機能するかについて説明します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のトランスポートと MEP の特定の組み合わせに関する推奨事項は、ネットワーク上の NAT とファイアウォールに対するアプリケーションの堅牢性を向上させる上で役立ちます。  
+  
+## NAT が通信に及ぼす影響  
+ NAT は、複数のコンピューターで 1 つの外部 IP アドレスを共有できるようにするために作成されました。ポート再割り当て NAT は、新しいポート番号を使用して、接続する内部 IP アドレスとポートを外部 IP アドレスに割り当てます。新しいポート番号により、NAT は、リターン トラフィックを元の通信に関連付けることができます。現在、多くのホーム ユーザーがプライベートでのみルーティング可能な IP アドレスを持ち、パケットのグローバル ルーティングを実現するために NAT に依存しています。  
+  
+ NAT は、セキュリティの境界を提供しません。ただし、一般的な NAT 構成は、内部コンピューターが直接アドレス指定されないようにします。これにより、内部コンピューターが望ましくない接続から保護されると共に、データをクライアントに非同期的に送り返す必要があるサーバー アプリケーションの作成が困難になります。NAT はパケットのアドレスを書き換え、接続が NAT コンピューターで発生しているかのように見せます。このため、サーバーがクライアントへの接続を開こうとしても失敗します。サーバーが、明らかになっているクライアントのアドレスを使用しても、クライアントのアドレスをパブリックにルーティングできないため、失敗します。サーバーが NAT アドレスを使用した場合は、該当するコンピューターにリッスンしているアプリケーションが存在しないため、接続できません。  
+  
+ 一部の NAT は、転送ルールの構成をサポートし、外部コンピューターが特定の内部コンピューターに接続できるようにします。転送ルールの構成手順は NAT によってそれぞれ異なるため、ほとんどのアプリケーションについて、NAT 構成の変更をエンド ユーザーに求めることはお勧めしません。多くのエンド ユーザーが、特定のアプリケーションに対する NAT 構成を変更できないか、変更を望まないからです。  
+  
+## ファイアウォールが通信に及ぼす影響  
+ *"ファイアウォール"* とは、通過するトラフィックにルールを適用し、通過を許可するか、拒否するかを決定するソフトウェアまたはハードウェア デバイスです。ファイアウォールは、トラフィックの受信ストリームまたは送信ストリーム、あるいはこの両方を調べるように構成できます。ファイアウォールは、ネットワークの端またはエンドポイント ホストで、ネットワークのセキュリティ境界を提供します。ビジネス ユーザーは、悪質な攻撃を防ぐために従来からファイアウォールの内側にサーバーを保持しています。[!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] にパーソナル ファイアウォールが導入されて以降、ファイアウォールを使用するホーム ユーザーの数も大幅に増えています。このため、接続の一端または両端に、パケットを検査するファイアウォールが存在する場合が多くなっています。  
+  
+ ファイアウォールは、パケットを調べる際の複雑さと能力の点で千差万別です。簡単なファイアウォールは、パケット内の送信元および送信先のアドレスとポートに基づいてルールを適用します。また、インテリジェント ファイアウォールもパケットの内容を調べて判断を下すことができます。これらのファイアウォールはさまざまな構成で提供され、多くの場合、特別な用途に使用されます。  
+  
+ ホーム ユーザー用ファイアウォールの一般的な構成では、以前に送信接続したことがあるコンピューター以外からの受信接続を禁止します。ビジネス ユーザー用ファイアウォールの一般的な構成では、特別に指定したポート グループを除き、すべてのポートで受信接続を禁止します。この一例としては、HTTP サービスと HTTPS サービスを提供するポート 80 とポート 443 以外のすべてのポートで接続を禁止するファイアウォールが挙げられます。管理されたファイアウォールは、ホーム ユーザーとビジネス ユーザーの両者を対象にしており、コンピューター上の信頼済みユーザーやプロセスによるファイアウォール構成の変更を許可します。管理されたファイアウォールの対象は、ネットワークの使用状況を制御する企業ポリシーが存在しないホーム ユーザーであるのがより一般的です。  
+  
+## Teredo の使用  
+ Teredo は、NAT の内側にあるコンピューターの直接アドレス指定を可能にする IPv6 移行テクノロジです。Teredo は、パブリックにもグローバルにもルーティングが可能なサーバーを使用して考えられる接続をアドバタイズします。Teredo サーバーは、アプリケーション クライアントとサーバーに、接続情報を交換できる共通のミーティング ポイントを提供します。コンピューターは一時 Teredo アドレスを要求し、パケットが既存のネットワークをトンネリングされます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での Teredo のサポートには、オペレーティング システムの IPv6 と Teredo のサポートの有効化が必要です。[!INCLUDE[wxp](../../../../includes/wxp-md.md)] およびそれ以降のオペレーティング システムは Teredo をサポートします。[!INCLUDE[wv](../../../../includes/wv-md.md)] およびそれ以降のオペレーティング システムは、既定で IPv6 をサポートします。ユーザーが Teredo を有効にする必要があるだけです。[!INCLUDE[wxpsp2](../../../../includes/wxpsp2-md.md)] および [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では、ユーザーが IPv6 と Teredo の両方を有効にする必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[Teredo の概要](http://go.microsoft.com/fwlink/?LinkId=87571)」を参照してください。  
+  
+## トランスポートとメッセージ交換パターンの選択  
+ トランスポートと MEP の選択は、次の 3 つの手順から成るプロセスです。  
+  
+1.  エンドポイント コンピューターのアドレスの指定可能性を分析します。一般に、エンタープライズ サーバーは直接アドレス指定できますが、エンド ユーザーの場合は、NAT により、アドレス指定できないようになっています。エンド ユーザー間のピアツーピア シナリオなどで、両方のエンドポイントが NAT の内側にある場合は、アドレス指定を可能にする Teredo などのテクノロジが必要です。  
+  
+2.  エンドポイント コンピューターのプロトコルとポートの制限を分析します。一般にエンタープライズ サーバーは、多くのポートをブロックする強力なファイアウォールの内側にあります。ただし、多くの場合、ポート 80 \(HTTP トラフィックを許可するため\) とポート 443 \(HTTPS トラフィックを許可するため\) は開かれています。エンド ユーザーがポートを制限している可能性はほとんどありませんが、送信接続だけを許可するファイアウォールを使用している可能性があります。一部のファイアウォールでは、エンドポイントのアプリケーションによる管理が可能で、選択的に接続を開くことができます。  
+  
+3.  ネットワークのアドレス指定可能性とポートの制限によって許可されるトランスポートと MEP を計算します。  
+  
+ クライアント\/サーバー アプリケーションの一般的なトポロジでは、送信専用のファイアウォールを持ち、Teredo を使用しない NAT の内側にあるクライアントと、強力なファイアウォールを持つ直接アドレス指定が可能なサーバーを展開します。このシナリオでは、双方向 MEP を使用する TCP トランスポートと、要求\/応答 MEP を使用する HTTP トランスポートが適しています。ピアツーピア アプリケーションの一般的なトポロジでは、両方のエンドポイントを NAT とファイアウォールの内側に展開します。このシナリオと、ネットワーク トポロジが不明なシナリオでは、次の推奨事項を検討してください。  
+  
+-   双方向トランスポートは使用しません。双方向トランスポートはより多くの接続を開くため、正常に接続できる可能性が低下します。  
+  
+-   元の接続でのバック チャネルの確立をサポートします。双方向 TCP などでバック チャネルを使用すると、開かれる接続の数が少なくなるため、正常に接続できる可能性が向上します。  
+  
+-   エンドポイントの登録用、またはトラフィックの中継用に到達可能なサービスを使用します。Teredo サーバーなどの、グローバルに到達できる接続サービスを使用すると、ネットワーク トポロジの制限が厳しい場合やトポロジが不明な場合に正常に接続できる可能性が大幅に向上します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] における一方向、要求\/応答、双方向の各 MEP と、標準 TCP、Teredo を使用する TCP、および標準 HTTP と双方向 HTTP の各トランスポートについて次の表にまとめます。  
+  
+|アドレスの指定可能性|サーバー \(直接指定\)|サーバー \(NAT トラバースによる直接指定\)|サーバー \(NAT\)|サーバー \(NAT トラバースによる NAT\)|  
+|----------------|-------------------|-------------------------------|------------------|-------------------------------|  
+|クライアント \(直接指定\)|トランスポートおよび MEP。|トランスポートおよび MEP。|サポートされていません。|サポートなし。|  
+|クライアント \(NAT トラバースによる直接指定\)|トランスポートおよび MEP。|トランスポートおよび MEP。|サポートなし。|Teredo を使用する TCP および任意の MEP。[!INCLUDE[wv](../../../../includes/wv-md.md)] には Teredo を使用する HTTP の使用をサポートするためのコンピューター全体に関するオプションが用意されています。|  
+|クライアント \(NAT\)|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|サポートなし。|サポートなし。|  
+|クライアント \(NAT トラバースによる NAT\)|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|双方向 HTTP 以外のすべてと任意の MEP。双方向 MEP には TCP トランスポートが必要です。双方向 TCP トランスポートには Teredo が必要です。[!INCLUDE[wv](../../../../includes/wv-md.md)] には Teredo を使用する HTTP の使用をサポートするためのコンピューター全体に関するオプションが用意されています。|サポートなし。|Teredo を使用する TCP および 任意の MEP。[!INCLUDE[wv](../../../../includes/wv-md.md)] には Teredo を使用する HTTP の使用をサポートするためのコンピューター全体に関するオプションが用意されています。|  
+  
+|ファイアウォールの制限|ファイアウォールを使用しないサーバー|管理されたファイアウォールを使用するサーバー|HTTP 専用のファイアウォールを使用するサーバー|送信専用のファイアウォールを使用するサーバー|  
+|-----------------|------------------------|----------------------------|-------------------------------|----------------------------|  
+|ファイアウォールを使用しないクライアント|トランスポートおよび MEP。|トランスポートおよび MEP。|任意の HTTP トランスポートおよび MEP。|サポートなし。|  
+|管理されたファイアウォールを使用するクライアント|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|任意の HTTP トランスポートおよび MEP。|サポートなし。|  
+|HTTP 専用のファイアウォールを使用するクライアント|任意の HTTP トランスポートおよび MEP。|任意の HTTP トランスポートおよび MEP。|任意の HTTP トランスポートおよび MEP。|サポートなし。|  
+|送信専用のファイアウォールを使用するクライアント|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|任意の一方向トランスポートおよび MEP。双方向 MEP には TCP トランスポートが必要です。|任意の HTTP トランスポートおよび任意の非双方向 MEP。|サポートなし。|
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/wsdl-and-policy.md b/docs/framework/wcf/feature-details/wsdl-and-policy.md
new file mode 100644
index 00000000000..be3cc4a4aef
--- /dev/null
+++ b/docs/framework/wcf/feature-details/wsdl-and-policy.md
@@ -0,0 +1,85 @@
+---
+title: "WSDL とポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cea87440-3519-4640-8494-b8a2b0e88c84
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WSDL とポリシー
+ここでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] WSDL 1.1、WS\-Policy、および WS\-PolicyAttachment の実装の詳細、および [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって導入される追加の WS\-Policy アサーションと WSDL 1.1 拡張について説明します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ここで説明する制約と説明に基づいて、W3C に提出された WS\-Policy 仕様と WS\-PolicyAttachment 仕様を実装しています。  
+  
+ このドキュメントでは、次の表に示すプレフィックスと名前空間を使用します。  
+  
+|プレフィックス|Namespace|  
+|-------------|---------------|  
+|wsp \(WS\-Policy 1.2\)|http:\/\/schemas.xmlsoap.org\/ws\/2004\/09\/policy|  
+|wsp \(WS\-Policy 1.5\)|http:\/\/www.w3.org\/ns\/ws\-policy|  
+|http|http:\/\/schemas.microsoft.com\/ws\/06\/2004\/policy\/http|  
+|msmq|http:\/\/schemas.microsoft.com\/ws\/06\/2004\/mspolicy\/msmq|  
+|msf|http:\/\/schemas.microsoft.com\/ws\/2006\/05\/framing\/policy|  
+|mssp|http:\/\/schemas.microsoft.com\/ws\/2005\/07\/securitypolicy|  
+|msc|http:\/\/schemas.microsoft.com\/ws\/2005\/12\/wsdl\/contract|  
+|cdp|http:\/\/schemas.microsoft.com\/net\/2006\/06\/duplex|  
+  
+## WCF WSDL1.1 の拡張  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、次の WSDL1.1 拡張を使用して、コントラクト セッションの要件を表します。  
+  
+ wsdl:portType\/wsdl:operation\/@msc:isInitiating  
+ xs:boolean は、この操作が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションを開始するかどうかを示します。既定値は `false` です。  
+  
+ wsdl:portType\/wsdl:operation\/@msc:isTerminating  
+ xs:boolean は、この操作が [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションを終了するかどうかを示します。既定値は `false` です。  
+  
+ wsdl:portType\/wsdl:operation\/@msc:usingSession  
+ xs:boolean は、このコントラクトでセッションを確立する必要があるかどうかを示します。  
+  
+### SOAP 1.x HTTP バインディング トランスポートの URI  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、次の URI を使用して、WSDL 1.1、SOAP 1.1 および 1.2 のバインディング拡張要素に使用するトランスポートを示します。  
+  
+|Transport|URI|  
+|---------------|---------|  
+|HTTP|http:\/\/schemas.xmlsoap.org\/soap\/http|  
+|TCP|http:\/\/schemas.microsoft.com\/soap\/tcp|  
+|MSMQ|http:\/\/schemas.microsoft.com\/soap\/msmq|  
+|名前付きパイプ|http:\/\/schemas.microsoft.com\/soap\/named\-pipe|  
+  
+## WCF で実装されるポリシー アサーション  
+ Web サービス仕様 \(WS\-\*\) で導入されたポリシー アサーションとこのドキュメントの他のセクションに記載しているポリシー アサーションに加えて、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では次のポリシー アサーションを実装します。  
+  
+|ポリシー アサーション|ポリシー サブジェクト|説明|  
+|-----------------|-----------------|--------|  
+|http:HttpBasicAuthentication|エンドポイント|エンドポイントは、HTTP 基本認証を使用します。|  
+|http:HttpDigestAuthentication|エンドポイント|エンドポイントは、HTTP ダイジェスト認証を使用します。|  
+|http:HttpNegotiateAuthentication|エンドポイント|エンドポイントは、HTTP ネゴシエート認証を使用します。|  
+|http:HttpNtlmAuthentication|エンドポイント|エンドポイントは、HTTP NTLM 認証を使用します。|  
+|msf:Streamed|エンドポイント|エンドポイントは、ストリーミングされたメッセージ フレームを使用します。  このアサーションは、TCP、名前付きパイプのようなトランスポートに提供されるメッセージ フレーム プロトコルと共に使用されます。|  
+|msf:SslTransportSecurity|エンドポイント|エンドポイントは、トランスポート層セキュリティ \(TLS\) をメッセージ フレームと共に使用します。|  
+|msf:WindowsTransportSecurity|エンドポイント|エンドポイントは、Security Provider Negotiation \(SPNEGO\) をメッセージ フレームと共に使用します。|  
+|msmq:MsmqBestEffort|エンドポイント|MSMQ はベストエフォート保証を使用します。|  
+|msmq:MsmqSession|エンドポイント|MSMQ はセッション保証を使用します。|  
+|msmq:MsmqVolatile|エンドポイント|MSMQ は揮発性です。|  
+|msmq:Authenticated|エンドポイント|認証が、MSMQ トランスポートと共に使用されます。|  
+|msmq:WindowsDomain|エンドポイント|MSMQ は Windows ドメイン認証を使用します。|  
+|cdp:CompositeDuplex|エンドポイント|エンドポイントは、メッセージの送受信に 2 つの個別の逆方向トランスポート接続を使用します。|  
+|mssp:RsaToken|入れ子|RSA キー トークンのアサーションです。  通常、この要件を満たすのは、保証する署名内でキー情報の一部として直接シリアル化される RSA キーです。|  
+|mssp:SslContextToken|入れ子|WS\-Trust を使用するバイナリ TLS ハンドシェイクによって取得される SecurityContextToken の使用を要求します。  入れ子になったアサーションには、sp:RequireDerivedKeys、mssp:MustNotSendCancel、mssp:RequireClientCertificate があります。|  
+|mssp:MustNotSendCancel|入れ子|Cancel バインディング \[WS\-Trust、WS\-SC\] を使用するセキュリティ トークン要求 \(RST\) の要求メッセージ \[WS\-Trust\] を特定の SecurityContextToken の発行者に送信しないという要件を指定します。  このアサーションが存在する場合、このような要求メッセージを発行者に送信することはできません。  このアサーションが存在しない場合、このような要求メッセージを発行者に送信できます。|  
+|mssp:RequireClientCertificate|入れ子|このオプション要素では、TLSNEGO プロトコルの一部としてクライアント証明書を提供するという要件を指定します。  このアサーションが存在する場合、クライアント証明書を提供する必要があります。  このアサーションが存在しない場合、クライアント証明書を提供しないでください。  このアサーションは、mssp:SslContextToken の外側で使用することはできません。|  
+  
+## 参照  
+ [カスタム WSDL パブリケーション](../../../../docs/framework/wcf/samples/custom-wsdl-publication.md)   
+ [方法 : カスタム WSDL をエクスポートする](../../../../docs/framework/wcf/extending/how-to-export-custom-wsdl.md)   
+ [方法 : カスタム WSDL をインポートする](../../../../docs/framework/wcf/extending/how-to-import-custom-wsdl.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md b/docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md
new file mode 100644
index 00000000000..7aa0af4e53f
--- /dev/null
+++ b/docs/framework/wcf/feature-details/xml-and-ado-net-types-in-data-contracts.md
@@ -0,0 +1,213 @@
+---
+title: "データ コントラクトの XML および ADO.NET の種類 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2ce8461-3c15-4c41-8c81-1cb78f5b59a6
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# データ コントラクトの XML および ADO.NET の種類
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のデータ コントラクト モデルでは、XML を直接表す特定の型がサポートされています。  シリアライザーは、これらの型を XML にシリアル化するとき、型の XML コンテンツを書き出しますが、それ以上の処理は行いません。  サポートされている型は、<xref:System.Xml.XmlElement>、<xref:System.Xml.XmlNode> の配列 \(`XmlNode` 型自体はサポートされていません\)、および <xref:System.Xml.Serialization.IXmlSerializable> を実装した型です。  データベース プログラミングでは、<xref:System.Data.DataSet> 型、<xref:System.Data.DataTable> 型、および型指定されたデータセットが一般的に使用されます。  これらの型は `IXmlSerializable` インターフェイスを実装するので、データ コントラクト モデルでシリアル化可能です。  この型に関する考慮事項について、このトピックの最後に説明します。  
+  
+## XML 型  
+  
+### XmlElement  
+ `XmlElement` 型は、その XML コンテンツを使用してシリアル化されます。  たとえば、次の型を使用するとします。  
+  
+ [!code-csharp[DataContractAttribute#4](../../../../samples/snippets/csharp/VS_Snippets_CFX/datacontractattribute/cs/overview.cs#4)]
+ [!code-vb[DataContractAttribute#4](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/datacontractattribute/vb/overview.vb#4)]  
+  
+ これは、次のように XML にシリアル化されます。  
+  
+```  
+<MyDataContract xmlns="http://schemas.contoso.com">  
+    <myDataMember>  
+        <myElement xmlns="" myAttribute="myValue">  
+            myContents  
+        </myElement>  
+    </myDataMember>  
+</MyDataContract>  
+```  
+  
+ ラッパー データ メンバー要素 `<myDataMember>` が引き続き存在している点に注意してください。  データ コントラクト モデルにはこの要素を削除する方法がありません。  このモデルを処理するシリアライザー \(<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Runtime.Serialization.NetDataContractSerializer>\) では、このラッパー要素に特別な属性が出力されることがあります。  この特別な属性には、標準の XML スキーマ インスタンスの "nil" 属性 \(`XmlElement` を `null` に設定できるようにする属性\) や "type" 属性 \(`XmlElement` をポリモーフィックに使用できるようにする属性\) などがあります。  また、"Id"、"Ref"、"Type"、および "Assembly" は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に固有の XML 属性です。  これらの属性が出力されるのは、オブジェクト グラフの保存モードを有効にするか <xref:System.Runtime.Serialization.NetDataContractSerializer> を使用する場合に `XmlElement` をサポートするためです   \(オブジェクト グラフの保存モードの[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)」を参照してください\)。  
+  
+ `XmlElement` の配列またはコレクションを使用できます。これらは、他の配列またはコレクションとして処理されます。  つまり、コレクション全体のラッパー要素と、配列に含まれる `XmlElement` ごとに個別のラッパー要素 \(上記の例の `<myDataMember>` と同様\) が存在することになります。  
+  
+ 逆シリアル化時には、デシリアライザーによって受信 XML から `XmlElement` が作成されます。  有効な親 <xref:System.Xml.XmlDocument> は、デシリアライザーによって提供されます。  
+  
+ `XmlElement` に逆シリアル化される XML フラグメントでは、先祖要素のプレフィックス定義に依存するのではなく、使用するすべてのプレフィックスを定義しておく必要があります。  これは、`DataContractSerializer` を使用して、`DataContractSerializer` 以外の別のソースから XML にアクセスする場合にのみ考慮する必要があります。  
+  
+ `DataContractSerializer` を使用する場合、`XmlElement` の割り当てはポリモーフィックに行えますが、割り当てることができるのは <xref:System.Object> 型のデータ メンバーに対してのみです。  <xref:System.Collections.IEnumerable> が実装されていても、`XmlElement` をコレクション型として使用したり、<xref:System.Collections.IEnumerable> データ メンバーに割り当てることはできません。  すべてのポリモーフィックな割り当てと同様に、`DataContractSerializer` は、生成される XML にデータ コントラクト名を出力します。この場合、コントラクト名は "http:\/\/schemas.datacontract.org\/2004\/07\/System.Xml" 名前空間の "XmlElement" です。  
+  
+ `NetDataContractSerializer` を使用する場合、`XmlElement` の有効なポリモーフィック割り当て \(`Object` または `IEnumerable` への割り当て\) がすべてサポートされます。  
+  
+ `XmlElement` から派生した型がポリモーフィックに割り当てられているかどうかに関係なく、このような型と上記の 2 つのシリアライザーを一緒に使用しないでください。  
+  
+### XmlNode の配列  
+ <xref:System.Xml.XmlNode> の配列の使用は、`XmlElement` の使用に非常に似ています。  `XmlNode` の配列を使用すると、`XmlElement` を使用する場合よりも高い柔軟性が得られます。  たとえば、データ メンバーがラップする要素内に複数の要素を作成できます。  データ メンバーがラップする要素内には、XML コメントなどの要素以外のコンテンツを挿入することもできます。  さらに、ラップする側のデータ メンバー要素にも属性を挿入できます。  これらはすべて、`XmlNode` の配列に `XmlNode` の特定の派生クラス \(<xref:System.Xml.XmlAttribute>、`XmlElement`、<xref:System.Xml.XmlComment> など\) を追加することによって実現できます。  たとえば、次の型を使用するとします。  
+  
+ [!code-csharp[DataContractAttribute#5](../../../../samples/snippets/csharp/VS_Snippets_CFX/datacontractattribute/cs/overview.cs#5)]
+ [!code-vb[DataContractAttribute#5](../../../../samples/snippets/visualbasic/VS_Snippets_CFX/datacontractattribute/vb/overview.vb#5)]  
+  
+ シリアル化すると、生成される XML は次のコードのようになります。  
+  
+```  
+<MyDataContract xmlns="http://schemas.contoso.com">  
+  <myDataMember myAttribute="myValue">  
+     <!--myComment-->  
+     <myElement xmlns="" myAttribute="myValue">  
+ myContents  
+     </myElement>  
+     <myElement xmlns="" myAttribute="myValue">  
+       myContents  
+     </myElement>  
+  </myDataMember>  
+</MyDataContract>  
+```  
+  
+ データ メンバー ラッパー要素 `<myDataMember>` には、1 つの属性、1 つのコメント、および 2 つの要素が含まれています。  これらが、シリアル化された 4 つの `XmlNode` インスタンスです。  
+  
+ 結果的に無効な XML になる `XmlNode` の配列は、シリアル化できません。  たとえば、最初のインスタンスが `XmlElement` で、次のインスタンスが <xref:System.Xml.XmlAttribute> という 2 つの `XmlNode` インスタンスの配列は、無効です。このシーケンスは、有効な XML インスタンスに対応していません \(属性を関連付ける場所がありません\)。  
+  
+ `XmlNode` の配列の逆シリアル化時には、ノードが作成され、そのノードに受信 XML からの情報が追加されます。  有効な親 <xref:System.Xml.XmlDocument> は、デシリアライザーによって提供されます。  ラッパー データ メンバー要素にあるすべての属性を含めて、すべてのノードが逆シリアル化されます。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] シリアライザーによってその要素に配置される属性 \(ポリモーフィック割り当てを示すための属性など\) を除きます。  XML フラグメントですべての名前空間プレフィックスを定義するときの注意点は、`XmlElement` の逆シリアル化に適用されるのと同様に、`XmlNode` の配列の逆シリアル化にも適用されます。  
+  
+ オブジェクト グラフの保存を有効にしてシリアライザーを使用した場合、オブジェクトの等価性は、個別の `XmlNode` インスタンスではなく、`XmlNode` 配列のレベルでのみ保存されます。  
+  
+ 1 つ以上のノードが `null` に設定された `XmlNode` の配列をシリアル化しないようにしてください。  配列メンバー全体を `null` にすることはできますが、配列に格納された個々の `XmlNode` を null にすることはできません。  配列メンバー全体が null の場合、ラッパー データ メンバー要素には、配列メンバー全体が null であることを示す特別な属性が含まれます。  逆シリアル化時にも、配列メンバー全体が null になります。  
+  
+ `XmlNode` の正規の配列だけが、シリアライザーによって特別に処理されます。  `XmlNode` を含む他のコレクション型として宣言されたデータ メンバーや、`XmlNode` から派生した型の配列として宣言されたデータ メンバーには、特別な処理は行われません。  このため、これらのデータ メンバーは、シリアル化に関するその他の条件のいずれかを満たしている場合を除き、通常はシリアル化できません。  
+  
+ `XmlNode` の配列の配列またはコレクションを使用できます。  コレクション全体のラッパー要素と、外側の配列またはコレクションに含まれる `XmlNode` の配列ごとに個別のラッパー要素 \(上記の例の `<myDataMember>` と同様\) が存在することになります。  
+  
+ `IEnumerable` の `Object` または `Array` の <xref:System.Array> 型のデータ メンバーに `XmlNode` インスタンスを追加しても、そのデータ メンバーが `XmlNode` インスタンスの `Array` として扱われることはありません。  配列の各メンバーは個別にシリアル化されます。  
+  
+ `DataContractSerializer` を使用する場合、`XmlNode` の配列をポリモーフィックに割り当てることができますが、その対象は `Object` 型のデータ メンバーだけです。  `IEnumerable` が実装されていても、`XmlNode` の配列をコレクション型として使用したり、`IEnumerable` データ メンバーに割り当てることはできません。  すべてのポリモーフィックな割り当てと同様に、`DataContractSerializer` は、生成される XML にデータ コントラクト名を出力します。この場合、コントラクト名は "http:\/\/schemas.datacontract.org\/2004\/07\/System.Xml" 名前空間の "ArrayOfXmlNode" です。  `DataContractSerializer` を使用する場合は、`XmlNode` 配列の有効な割り当てがサポートされます。  
+  
+### スキーマの考慮事項  
+ XML 型のスキーマ マッピングの詳細については、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」を参照してください。  ここでは、重要な点の概要について説明します。  
+  
+ `XmlElement` 型のデータ メンバーは、次の匿名型を使用して定義された要素にマップされます。  
+  
+```  
+<xsd:complexType>  
+   <xsd:sequence>  
+      <xsd:any minOccurs="0" processContents="lax" />  
+   </xsd:sequence>  
+</xsd:complexType>  
+```  
+  
+ `XmlNode` の Array 型のデータ メンバーは、次の匿名型を使用して定義された要素にマップされます。  
+  
+```  
+<xsd:complexType mixed="true">  
+   <xsd:sequence>  
+      <xsd:any minOccurs="0" maxOccurs="unbounded" processContents="lax" />  
+   </xsd:sequence>  
+   <xsd:anyAttribute/>  
+</xsd:complexType>  
+```  
+  
+## IXmlSerializable インターフェイスを実装する型  
+ `IXmlSerializable` インターフェイスを実装する型は、`DataContractSerializer` で完全にサポートされます。  これらの型には、スキーマを制御するために必ず <xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性を適用する必要があります。  
+  
+ `IXmlSerializable` を実装する型には、任意のコンテンツを表す型、1 つの要素を表す型、および従来の <xref:System.Data.DataSet> 型の 3 種類があります。  
+  
+-   コンテンツ型では、`XmlSchemaProviderAttribute` 属性によって指定されたスキーマ プロバイダー メソッドが使用されます。  このメソッドから `null` が返されることはなく、属性の <xref:System.Xml.Serialization.XmlSchemaProviderAttribute.IsAny%2A> プロパティは既定値 `false` のままになります。  これは、`IXmlSerializable` 型の最も一般的な使用方法です。  
+  
+-   要素型は、`IXmlSerializable` 型が自身のルート要素名を制御する必要があるときに使用します。  型を要素型としてマークするには、<xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性の <xref:System.Xml.Serialization.XmlSchemaProviderAttribute.IsAny%2A> プロパティを `true` に設定するか、スキーマ プロバイダー メソッドから null を返します。  スキーマ プロバイダー メソッドの使用は、要素型ではオプションです。`XmlSchemaProviderAttribute` でメソッド名の代わりに null を指定できます。  ただし、`IsAny` が `true` で、スキーマ プロバイダー メソッドが指定されている場合、メソッドは null を返す必要があります。  
+  
+-   従来の <xref:System.Data.DataSet> 型は、`XmlSchemaProviderAttribute` 属性でマークされていない `IXmlSerializable` 型です。  これらの型は、スキーマ生成に関して <xref:System.Xml.Serialization.IXmlSerializable.GetSchema%2A> メソッドに依存しています。  以前のバージョンの .NET Framework では、このパターンが `DataSet` 型に使用され、型指定されたデータセットからクラスが派生されます。ただし、現在、このパターンは使用されなくなっており、従来の型に対応することだけを目的としてサポートされています。  このパターンに依存せず、必ず `XmlSchemaProviderAttribute` を `IXmlSerializable` 型に適用してください。  
+  
+### IXmlSerializable コンテンツ型  
+ `IXmlSerializable` を実装しており、以前に定義したコンテンツ型である型のデータ メンバーをシリアル化すると、シリアライザーはそのデータ メンバーのラッパー要素を書き込み、<xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> メソッドに制御を渡します。  <xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A> 実装により、ラッパー要素に属性が追加されるなど、任意の XML が書き込まれることがあります。  `WriteXml` の実行後、シリアライザーは要素を閉じます。  
+  
+ `IXmlSerializable` を実装しており、以前に定義したコンテンツ型である型のデータ メンバーを逆シリアル化すると、デシリアライザーはそのデータ メンバーのラッパー要素に XML リーダーを配置し、<xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> メソッドに制御を渡します。  このメソッドは、開始タグと終了タグを含む、要素全体を読み取る必要があります。  `ReadXml` コードでは、要素が空の場合も忘れずに処理してください。  また、`ReadXml` の実装では、特定の方法で名前が付けられたラッパー要素に依存しないようにしてください。  シリアライザーによって選択される名前は、異なる場合があります。  
+  
+ `IXmlSerializable` コンテンツ型は、たとえば <xref:System.Object> 型のデータ メンバーなどに、ポリモーフィックに割り当てることができます。  また、型インスタンスを null にすることもできます。  さらに、`IXmlSerializable` 型は、オブジェクト グラフの保存を有効にして <xref:System.Runtime.Serialization.NetDataContractSerializer> で使用することも可能です。  これらのすべての機能を実現するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] シリアライザーが特定の属性 \(XML スキーマ インスタンス名前空間の "nil" と "type"、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 固有の名前空間の "Id"、"Ref"、"Type"、および "Assembly"\) をラッパー要素に追加する必要があります。  
+  
+#### ReadXml を実装するときに無視する属性  
+ `ReadXml` コードに制御を渡す前に、デシリアライザーは、XML 要素を調べ、前述の特別な XML 属性を検出し、その属性に従って動作します。  たとえば、"nil" が `true` の場合は、null 値が逆シリアル化され、`ReadXml` は呼び出されません。  ポリモーフィズムが検出された場合は、要素のコンテンツが別の型と同様に逆シリアル化されます。  ポリモーフィックに割り当てられた型の `ReadXml` 実装が呼び出されます。  どの場合も、これらの特別な属性がデシリアライザーによって処理されるため、`ReadXml` 実装ではこれらの属性を無視する必要があります。  
+  
+### IXmlSerializable コンテンツ型のスキーマに関する考慮事項  
+ `IXmlSerializable` コンテンツ型のスキーマをエクスポートすると、スキーマ プロバイダー メソッドが呼び出されます。  このスキーマ プロバイダー メソッドには、<xref:System.Xml.Schema.XmlSchemaSet> が渡されます。  このメソッドは、有効なスキーマをスキーマ セットに追加できます。  スキーマ セットには、スキーマをエクスポートした時点で既に認識されていたスキーマが格納されます。  スキーマ プロバイダー メソッドは、スキーマ セットに項目を追加する必要があるときに、適切な名前空間を持つ <xref:System.Xml.Schema.XmlSchema> がそのセットに既に存在するかどうかを確認する必要があります。  存在する場合、スキーマ プロバイダー メソッドは新しい項目を既存の `XmlSchema` に追加する必要があります。  存在しない場合、新しい `XmlSchema` インスタンスを作成する必要があります。  これは、`IXmlSerializable` 型の配列を使用する場合に重要です。  たとえば、`IXmlSerializable` 型を名前空間 "B" の "A" 型としてエクスポートする場合、スキーマ プロバイダー メソッドが呼び出される前に、"B" が "ArrayOfA" 型を保持するためのスキーマがスキーマ セットに既に存在している可能性があります。  
+  
+ 型を <xref:System.Xml.Schema.XmlSchemaSet> に追加する以外に、コンテンツ型のスキーマ プロバイダー メソッドは null 以外の値を返す必要があります。  このメソッドは、特定の `IXmlSerializable` 型で使用するスキーマ型の名前を指定する <xref:System.Xml.XmlQualifiedName> を返すことができます。  この修飾名は、その型のデータ コントラクト名および名前空間としても使用されます。  スキーマ プロバイダー メソッドは、スキーマ セットにまだ存在していない型であっても、復帰時に返すことができます。  ただし、関連するすべての型がエクスポートされる \(<xref:System.Runtime.Serialization.XsdDataContractExporter> の関連するすべての型に対して <xref:System.Runtime.Serialization.XsdDataContractExporter.Export%2A> メソッドが呼び出され、<xref:System.Runtime.Serialization.XsdDataContractExporter.Schemas%2A> プロパティにアクセスする\) までに、その型がスキーマ セットに存在している必要があります。  関連するすべての `Export` 呼び出しが実行される前に `Schemas` プロパティにアクセスすると、<xref:System.Xml.Schema.XmlSchemaException> が発生する可能性があります。  エクスポート プロセス[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[クラスからのスキーマのエクスポート](../../../../docs/framework/wcf/feature-details/exporting-schemas-from-classes.md)」を参照してください。  
+  
+ スキーマ プロバイダー メソッドは、使用する <xref:System.Xml.Schema.XmlSchemaType> を返すこともできます。  その型は、匿名の場合とそうでない場合があります。  匿名の場合、`IXmlSerializable` 型のスキーマは、`IXmlSerializable` 型がデータ メンバーとして使用されるたびに匿名型としてエクスポートされます。  `IXmlSerializable` 型には、データ コントラクト名と名前空間が引き続き保持されます   \(決定方法は、「[データ コントラクト名](../../../../docs/framework/wcf/feature-details/data-contract-names.md)」で説明されているとおりです。ただし、<xref:System.Runtime.Serialization.DataContractAttribute> 属性を使用して名前をカスタマイズすることはできません\)。匿名でない場合、型は `XmlSchemaSet` に含まれている型のいずれかである必要があります。  これは、型の `XmlQualifiedName` を返す場合と同じです。  
+  
+ さらに、型のグローバル要素宣言がエクスポートされます。  型に <xref:System.Xml.Serialization.XmlRootAttribute> 属性が適用されていない場合、その要素にはデータ コントラクトと同じ名前と名前空間が使用され、その "nillable" プロパティは true に設定されます。  ただし、スキーマ名前空間 \("http:\/\/www.w3.org\/2001\/XMLSchema"\) だけは例外です。型のデータ コントラクトがこの名前空間にある場合は、スキーマ名前空間に新しい要素を追加することが禁止されているため、対応するグローバル要素は、空白の名前空間に属することになります。  型に `XmlRootAttribute` 属性が適用されている場合、グローバル要素宣言は、<xref:System.Xml.Serialization.XmlRootAttribute.ElementName%2A>、<xref:System.Xml.Serialization.XmlRootAttribute.Namespace%2A>、および <xref:System.Xml.Serialization.XmlRootAttribute.IsNullable%2A> の各プロパティを使用してエクスポートされます。  `XmlRootAttribute` が適用された場合の既定値は、データ コントラクト名、空白の名前空間、および true に設定された "nillable" です。  
+  
+ 同じグローバル要素宣言の規則が、従来のデータセット型に適用されます。  `XmlRootAttribute` は、カスタム コードによって追加されたグローバル要素宣言をオーバーライドできません。これには、スキーマ プロバイダー メソッドを使用して `XmlSchemaSet` に追加された場合と、従来のデータセット型に対して `GetSchema` を使用して追加された場合があります。  
+  
+### IXmlSerializable 要素型  
+ `IXmlSerializable` 要素型には、`true` に設定された `IsAny` プロパティか、`null` を返すスキーマ プロバイダー メソッドのいずれかが含まれています。  
+  
+ 要素型のシリアル化と逆シリアル化は、コンテンツ型のシリアル化と逆シリアル化に非常に似ています。  ただし、重要な違いがいくつかあります。  
+  
+-   `WriteXml` の実装では、要素 \(これには複数の子要素が含まれている可能性もありますが\) を 1 つだけ出力することが想定されています。  この 1 つの要素の外側にある属性、複数の兄弟要素、またはこれらが混在したコンテンツを出力することはできません。  要素は空であってもかまいません。  
+  
+-   `ReadXml` の実装では、ラッパー要素の読み取りは想定されていません。  読み取ることが想定されているのは、`WriteXml` で生成される要素 1 つのみです。  
+  
+-   要素型を一様にシリアル化する場合 \(データ コントラクトのデータ メンバーとしてシリアル化する場合など\) は、コンテンツ型の場合と同様に、`WriteXml` を呼び出す前にラッパー要素が出力されます。  ただし、`DataContractSerializer` コンストラクターまたは `NetDataContractSerializer` コンストラクターによるシリアライザーの構築時にルート名と名前空間が明示的に指定されていない限り、トップ レベルで要素型をシリアル化しても、通常は `WriteXml` で書き出される要素を囲むラッパー要素が出力されることはありません。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)] [シリアル化と逆シリアル化](../../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md).  
+  
+-   構築時にルート名と名前空間を指定せずにトップ レベルで要素型をシリアル化した場合、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteStartObject%2A> と <xref:System.Runtime.Serialization.XmlObjectSerializer.WriteEndObject%2A> では基本的に何も実行されず、<xref:System.Runtime.Serialization.XmlObjectSerializer.WriteObjectContent%2A> によって `WriteXml` が呼び出されます。  このモードでは、シリアル化されるオブジェクトは null にできず、ポリモーフィックに割り当てることができません。  また、オブジェクト グラフの保存を有効化できず、`NetDataContractSerializer` も使用できません。  
+  
+-   構築時にルート名と名前空間を指定せずにトップ レベルで要素型を逆シリアル化したときに、要素の先頭を検出できた場合は、<xref:System.Runtime.Serialization.XmlObjectSerializer.IsStartObject%2A> が `true` を返します。  `verifyObjectName` パラメーターが `true` に設定されている <xref:System.Runtime.Serialization.XmlObjectSerializer.ReadObject%2A> は、実際にオブジェクトを読み取る前の動作が `IsStartObject` と同様です。  その後、`ReadObject` は制御を `ReadXml` メソッドに渡します。  
+  
+ 要素型の場合も、エクスポートされるスキーマは、前のセクションで説明した `XmlElement` 型に対するスキーマと同じです。ただし、スキーマ プロバイダー メソッドは、コンテンツ型と同様、追加のスキーマを <xref:System.Xml.Schema.XmlSchemaSet> に追加できます。  要素型には `XmlRootAttribute` 属性を使用することはできないので、グローバル要素宣言は要素型に対して出力されません。  
+  
+### XmlSerializer との相違点  
+ `IXmlSerializable` インターフェイス、`XmlSchemaProviderAttribute` 属性、および `XmlRootAttribute` 属性は、<xref:System.Xml.Serialization.XmlSerializer> でも認識されます。  ただし、データ コントラクト モデルでの処理方法に違いがあります。  重要な違いを以下にまとめます。  
+  
+-   スキーマ プロバイダー メソッドは、`XmlSerializer` で使用できるようにするためにパブリックにする必要がありますが、データ コントラクト モデルで使用するためにパブリックにする必要はありません。  
+  
+-   スキーマ プロバイダー メソッドは、データ コントラクト モデルで `IsAny` が true の場合に呼び出されますが、`XmlSerializer` では呼び出されません。  
+  
+-   コンテンツ型または従来のデータセット型に `XmlRootAttribute` 属性がない場合、`XmlSerializer` は、グローバル要素宣言を空白の名前空間にエクスポートします。  データ コントラクト モデルで通常使用される名前空間は、前に説明したとおりデータ コントラクトの名前空間です。  
+  
+ 両方のシリアル化技術で使用する型を作成する場合には、これらの違いに注意してください。  
+  
+### IXmlSerializable スキーマのインポート  
+ `IXmlSerializable` 型から生成されたスキーマをインポートする場合、次のような状況が考えられます。  
+  
+-   生成されたスキーマが、「[データ コントラクト スキーマの参照](../../../../docs/framework/wcf/feature-details/data-contract-schema-reference.md)」に記載された有効なデータ コントラクト スキーマである場合があります。  この場合は、スキーマを通常どおりにインポートでき、通常のデータ コントラクト型が生成されます。  
+  
+-   生成されたスキーマが、有効なデータ コントラクト スキーマではない場合があります。  たとえば、スキーマ プロバイダー メソッドによって、データ コントラクト モデルでサポートされていない XML 属性を含むスキーマが生成されることがあります。  この場合、スキーマを `IXmlSerializable` 型としてインポートできます。  このインポート モードは、既定では有効化されていませんが、たとえば、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) の `/importXmlTypes` コマンド ライン スイッチを使用することによって、簡単に有効化できます。  詳細については、「[クラスを作成するためのスキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)」を参照してください。  型インスタンスを処理するには、XML を直接操作する必要があります。  `XmlSerializer` の使用方法に関するトピックを参照し、より広い範囲のスキーマをサポートする別のシリアル化技術を使用することを検討することもできます。  
+  
+-   新しい型を生成する代わりに、プロキシ内の既存の `IXmlSerializable` 型を再利用できます。  この場合、「型を作成するためのスキーマのインポート」で説明する参照型の機能を使用して、再利用する型を示すことができます。  これは、Svcutil.exe で `/reference` スイッチを使用して、再利用する型を含むアセンブリを指定することに相当します。  
+  
+## データ コントラクトでの任意の XML の表現  
+ `XmlElement` 型、`XmlNode` の配列、および `IXmlSerializable` 型を使用すると、任意の XML をデータ コントラクト モデルに挿入できます。  `DataContractSerializer` と `NetDataContractSerializer` は、プロセスには介入せずに、使用している XML ライターにこの XML コンテンツを渡します。  ただし、XML ライターは、出力する XML に対して特定の制限を適用することがあります。  次に重要な例を具体的に示します。  
+  
+-   通常、XML ライターでは、別のドキュメントの書き込み中の XML ドキュメントの宣言 \(\<?xml version\=’1.0’ ?\> など\) は許可されません。  完全な XML ドキュメントを取得して、それを `XmlNode` データ メンバーの `Array` としてシリアル化したりすることはできません。  これを実行するには、ドキュメントの宣言を取り除くか、独自のエンコード方法でこの宣言を表現する必要があります。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に用意されたすべての XML ライターは、XML 処理命令 \(\<?  … ?\>\)  と文書型定義 \(\<\!  … \>\) を SOAP メッセージで使用できないため、これらを拒否します。  この場合も、独自のエンコード機構を使用して、この制限に対処できます。  生成される XML に XML 処理命令と文書型定義を含める必要がある場合は、この 2 つをサポートする XML ライターを使用するカスタム エンコーダーを作成できます。  
+  
+-   `WriteXml` を実装するときは、XML ライターで <xref:System.Xml.XmlWriter.WriteRaw%2A> メソッドを呼び出さないようにします。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、バイナリを含むさまざまな XML エンコードを使用します。その結果をどのエンコードでも使用できるように `WriteRaw` を使用することは非常に困難か不可能です。  
+  
+-   `WriteXml` を実装するとき、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で提供される XML ライターでサポートされていない <xref:System.Xml.XmlWriter.WriteEntityRef%2A> メソッドと <xref:System.Xml.XmlWriter.WriteNmToken%2A> メソッドを使用しないようにします。  
+  
+## DataSet、Typed DataSet、および DataTable の使用  
+ データ コントラクト モデルでは、この 3 つの型の使用が完全にサポートされています。  これらの型を使用する場合は、次の点に注意してください。  
+  
+-   この 3 つの型 \(特に、<xref:System.Data.DataSet> と型指定された派生クラス\) のスキーマは、一部の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のプラットフォームと相互運用できない場合があります。また、このようなプラットフォームで使用しても、結果的に使いにくい場合もあります。  また、`DataSet` 型の使用はパフォーマンスに影響を与えることがあります。  さらに、将来的にアプリケーションのバージョン管理が通常より難しくなる可能性もあります。  コントラクトでは、`DataSet` 型の代わりに、明示的に定義されたデータ コントラクト型を使用することを検討してください。  
+  
+-   `DataSet` スキーマまたは `DataTable` スキーマをインポートする際には、これらの型を参照することが重要です。  Svcutil.exe コマンド ライン ツールを使用すると、System.Data.dll アセンブリ名を `/reference` スイッチに渡すことによって、この参照を実現できます。  型指定されたデータセット スキーマをインポートする場合、その型指定されたデータセットの型を参照する必要があります。  Svcutil.exe を使用して、型指定されたデータセットのアセンブリの場所を `/reference` スイッチに渡します。  型を参照する方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[クラスを作成するためのスキーマのインポート](../../../../docs/framework/wcf/feature-details/importing-schema-to-generate-classes.md)」を参照してください。  
+  
+ データ コントラクト モデルでは、型指定された DataSet のサポートが制限されています。  型指定された DataSet は、シリアル化と逆シリアル化が可能であり、スキーマをエクスポートすることもできます。  ただし、データ コントラクト スキーマのインポートでは、既存のスキーマの再利用のみが行われるため、型指定された新しい DataSet 型をスキーマから生成することはできません。  Svcutil.exe ツールで `/r` スイッチを使用して、型指定された既存の DataSet を指し示すことができます。  型指定されたデータセットを使用するサービスで、`/r` スイッチを指定せずに Svcutil.exe を使用しようとすると、代替のシリアライザー \(XmlSerializer\) が自動的に選択されます。  DataContractSerializer を使用することも、スキーマから DataSet を生成することも必要である場合は、\(サービスで `/d` スイッチを指定した Xsd.exe ツールを使用して\) 型指定された DataSet 型を生成し、型をコンパイルした後に、Svcutil.exe で `/r` スイッチを使用して、それらの型を指し示します。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Xml.Serialization.IXmlSerializable>   
+ [データ コントラクトの使用](../../../../docs/framework/wcf/feature-details/using-data-contracts.md)   
+ [データ コントラクト シリアライザーでサポートされる型](../../../../docs/framework/wcf/feature-details/types-supported-by-the-data-contract-serializer.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/feedback-and-community.md b/docs/framework/wcf/feedback-and-community.md
new file mode 100644
index 00000000000..18a03845f50
--- /dev/null
+++ b/docs/framework/wcf/feedback-and-community.md
@@ -0,0 +1,25 @@
+---
+title: "フィードバックとコミュニティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "顧客フィードバック [WCF]"
+  - "フィードバック [WCF]"
+ms.assetid: ba0fd32b-cbcb-4f5b-b913-d98514ab5650
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# フィードバックとコミュニティ
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] や [!INCLUDE[infocard](../../../includes/infocard-md.md)] のドキュメントに関するご意見をお待ちしております。  SDK の各ページの末尾には "このトピックに関するご意見をマイクロソフトまでお寄せください" という記述があります。リンクをクリックして、全般的なご意見や特定のトピックに関するご提案を書いてお送りください。  
+  
+ さらに詳しい情報を探している場合や、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に関するテクニックを他のユーザーにも知らせたい場合は、「[MSDN Windows Communication Foundation フォーラム](http://go.microsoft.com/fwlink/?LinkId=186463)」にアクセスしてください。
\ No newline at end of file
diff --git a/docs/framework/wcf/find-private-key-tool-findprivatekey-exe.md b/docs/framework/wcf/find-private-key-tool-findprivatekey-exe.md
new file mode 100644
index 00000000000..337087ec4ee
--- /dev/null
+++ b/docs/framework/wcf/find-private-key-tool-findprivatekey-exe.md
@@ -0,0 +1,61 @@
+---
+title: "秘密キー検索ツール (FindPrivateKey.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: b8846a95-3fcc-4e8c-b9c0-128d975a6307
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 秘密キー検索ツール (FindPrivateKey.exe)
+このコマンド ライン ツールを使用して、証明書ストアから秘密キーを取得できます。  たとえば、FindPrivateKey.exe を使用して、証明書ストア内の特定の X.509 証明書に関連付けられている秘密キー ファイルの場所と名前を見つけることができます。  
+  
+> [!IMPORTANT]
+>  FindPrivateKey ツールは、WCF のサンプルとして付属しています。  このサンプルの検索場所とビルド方法の詳細については、  
+  
+## 構文  
+  
+```  
+FindPrivateKey <storeName> <storeLocation> [{ {-n <subjectName>} | {-t <thumbprint>} } [-f | -d | -a]]  
+```  
+  
+## 解説  
+ 次の表では、秘密キー検索ツール \(FindPrivateKey.exe\) で使用できる引数とオプションについて説明します。  
+  
+|引数|説明|  
+|--------|--------|  
+|`storeName`|証明書ストアの名前。|  
+|`storeLocation`|証明書ストアの場所。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/n <` *subjectName* `>`|証明書のサブジェクト名を指定します。|  
+|`/t <` *thumbprint* `>`|証明書のサムプリントを指定します。  Certmgr.exe を使用して証明書のサムプリントを取得します。|  
+|`/f`|ファイル名だけを出力します。|  
+|`/d`|ディレクトリだけを出力します。|  
+|`/a`|絶対ファイル名を出力します。|  
+  
+## 例  
+ 次のコマンドは、John Doe の秘密キーを取得します。  
+  
+```  
+FindPrivateKey My CurrentUser -n "CN=John Doe"  
+```  
+  
+ 次のコマンドは、ローカル マシンの秘密キーを取得します。  
+  
+```  
+FindPrivateKey My LocalMachine -t "03 33 98 63 d0 47 e7 48 71 33 62 64 76 5c 4c 9d 42 1d 6b 52" –a  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/fundamental-concepts.md b/docs/framework/wcf/fundamental-concepts.md
new file mode 100644
index 00000000000..2f07995502b
--- /dev/null
+++ b/docs/framework/wcf/fundamental-concepts.md
@@ -0,0 +1,168 @@
+---
+title: "Windows Communication Foundation の基本概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "概念 [WCF]"
+  - "基本事項 [WCF]"
+  - "WCF [WCF], 概念"
+  - "Windows Communication Foundation [WCF], 概念"
+ms.assetid: 3e7e0afd-7913-499d-bafb-eac7caacbc7a
+caps.latest.revision: 39
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# Windows Communication Foundation の基本概念
+このトピックでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アーキテクチャの概要について説明します。ここでは、主要概念およびこれらの概念がどのように組み合わされているかについて説明します。最も単純な [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスおよびクライアントの作成のチュートリアルについては、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] プログラミングの詳細については、「[基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+## WCF の基礎  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、サービスとクライアント間でメッセージを送信するシステムを作成するためのランタイムおよび一連の API です。同じコンピューター システム上、または別の企業内にあり、インターネット経由でアクセスするシステム上の他のアプリケーションと通信するアプリケーションを作成する場合にも、同じインフラストラクチャと API が使用されます。  
+  
+### メッセージングとエンドポイント  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、メッセージ ベースの通信の概念に基づいています。メッセージとしてモデル化できるものであれば、HTTP 要求やメッセージ キュー \(MSMQ とも呼ばれる\) メッセージなど、プログラミング モデルにおいて同一の方法で表すことができます。これにより、さまざまなトランスポート機構にわたり統一された API が実現します。  
+  
+ モデルでは、*クライアント* \(通信を開始するアプリケーション\) と*サービス* \(クライアントからの通信を待機し、通信に応答するアプリケーション\) が区別されます。1 つのアプリケーションがクライアントとサービスの両方の役割を果たすことができます。例については、「[双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)」および「[ピアツーピア ネットワーク](../../../docs/framework/wcf/feature-details/peer-to-peer-networking.md)」を参照してください。  
+  
+ メッセージは、エンドポイント間で送信されます。*エンドポイント*は、メッセージを送信または受信 \(または送受信\) する場所であり、メッセージ交換に必要なすべての情報が定義されます。サービスは、1 つ以上のアプリケーション エンドポイント \(および 0 個以上のインフラストラクチャ エンドポイント\) を公開し、クライアントは、サービスのエンドポイントのいずれかと互換性のあるエンドポイントを作成します。  
+  
+ *エンドポイント*は、メッセージの送信先、メッセージの送信方法、およびメッセージの内容を標準ベースの方法で示します。サービスは、この情報をメタデータとして公開できます。クライアントは、このメタデータを処理することで、適切な [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントと通信*スタック*を作成できます。  
+  
+### 通信プロトコル  
+ 通信スタックの必須要素の 1 つは、*トランスポート プロトコル*です。一般的なトランスポート \(HTTP や TCP など\) を使用して、イントラネットおよびインターネット上でメッセージを送信できます。メッセージ キュー アプリケーションおよびピア ネットワーク メッシュのノードとの通信をサポートする他のトランスポートも含まれます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の組み込み拡張ポイントを使用すると、さらに多くのトランスポート機構を追加できます。  
+  
+ 通信スタックのもう 1 つの必須要素はエンコードです。エンコードは、特定のメッセージをどのように書式設定するかを指定します。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、次のエンコードを使用できます。  
+  
+-   テキスト エンコード。相互運用可能なエンコードです。  
+  
+-   MTOM \(Message Transmission Optimization Mechanism\) エンコード。これは、サービスとの間で構造化されていないバイナリ データを効率的に送信するための相互運用可能な方法です。  
+  
+-   バイナリ エンコード。このエンコードを使用すると、転送を効率的に行うことができます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の組み込み拡張ポイントを使用すると、さらに多くのエンコード機構 \(圧縮エンコードなど\) を追加できます。  
+  
+### メッセージ パターン  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、要求\/応答、一方向、双方向通信など、複数のメッセージング パターンをサポートしています。各種トランスポートがサポートするメッセージング パターンはそれぞれに異なるため、サポートされる対話の種類に影響します。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] API とランタイムを使用すると、メッセージを安全かつ確実に送信できます。  
+  
+## WCF の用語  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のドキュメントで使用されるその他の概念と用語を以下に示します。  
+  
+ message  
+ 独立したデータ単位は、本文やヘッダーなどの複数の部分で構成できます。  
+  
+ service  
+ 1 つ以上のエンドポイントを公開する構造体です。各エンドポイントは、1 つ以上のサービス操作を公開します。  
+  
+ endpoint  
+ メッセージを送信または受信 \(または送受信\) する場所となる構造体です。エンドポイントには、どこにメッセージを送信できるかを明確に示す場所 \(アドレス\)、メッセージの送信方法を記載した通信機構の仕様 \(バインディング\)、およびその場所で送信または受信 \(または送受信\) 可能な一連のメッセージの内容を示す定義 \(サービス コントラクト\) が含まれます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスは、エンドポイントの集まりとして外部に公開されます。  
+  
+ アプリケーション エンドポイント  
+ アプリケーションによって公開されるエンドポイントです。アプリケーション エンドポイントは、アプリケーションで実装されるサービス コントラクトに対応しています。  
+  
+ インフラストラクチャ エンドポイント  
+ サービス コントラクトに関連しないサービスで必要とされる機能または提供される機能を促進するために、インフラストラクチャによって公開されるエンドポイントです。たとえば、サービスは、メタデータ情報を提供するインフラストラクチャ エンドポイントを持つ場合があります。  
+  
+ address  
+ メッセージを受信する場所を指定します。アドレスは、URI \(Uniform Resource Identifier\) として指定されます。URI のスキーマ部分では、そのアドレスに到達するために使用するトランスポート機構 \(HTTP、TCP など\) を指定します。URI の階層部分には一意の場所が含まれ、その形式はトランスポート機構によって異なります。  
+  
+ エンドポイント アドレスにより、サービスのエンドポイントごとに一意のエンドポイント アドレスを作成できます。また、一定の条件下では、エンドポイント間でアドレスを共有することもできます。既定以外のポートで HTTPS プロトコルを使用するアドレスの例を次に示します。  
+  
+```  
+HTTPS://cohowinery:8005/ServiceModelSamples/CalculatorService  
+```  
+  
+ バインディング  
+ エンドポイントが外部と通信する方法を定義します。バインディングは、バインディング要素と呼ばれる一連のコンポーネントで構成されます。各バインディング要素を "積み重ねる" ことで、通信インフラストラクチャが作成されます。バインディングでは、少なくともトランスポート \(HTTP や TCP など\) と使用するエンコード \(テキストやバイナリなど\) が定義されます。バインディングには、メッセージをセキュリティで保護するために使用するセキュリティ機構や、エンドポイントが使用するメッセージ パターンなどの詳細を指定したバインディング要素を含めることができます。詳細については、「[サービスの構成](../../../docs/framework/wcf/configuring-services.md)」を参照してください。  
+  
+ バインディング要素  
+ バインディングの特定の部分 \(トランスポート、エンコード、インフラストラクチャ レベルのプロトコル \(WS\-ReliableMessaging など\) の実装、通信スタックのその他のコンポーネントなど\) を表します。  
+  
+ behaviors  
+ サービス、エンドポイント、特定の操作、またはクライアントの実行時のさまざまな状況を制御するコンポーネントです。動作はスコープに従ってグループ化されます。共通動作は、すべてのエンドポイントにグローバルに作用し、サービス動作は、サービスに関連する側面にのみ作用します。また、エンドポイントの動作は、エンドポイントに関連するプロパティにのみ作用し、操作レベルの動作は特定の操作に作用します。たとえば、サービス動作の 1 つである調整では、メッセージの数が多すぎて処理しきれないおそれがある場合に、サービスでどのように対処するかを指定します。一方、エンドポイントの動作は、セキュリティ資格情報の検索方法や検索場所など、エンドポイントに関連する側面だけを制御します。  
+  
+ システム指定のバインディング  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、システム指定の多数のバインディングが用意されています。これらは、特定のシナリオ用に最適化されたバインディング要素の集まりです。たとえば、<xref:System.ServiceModel.WSHttpBinding> は、さまざまな WS\-\* 仕様を実装するサービスと相互運用できるようにデザインされています。これらの定義済みバインディングでは、特定のシナリオに適切に適用できるオプションだけが提供されるため、時間を節約できます。定義済みバインディングが要件を満たさない場合は、独自のカスタム バインディングを作成できます。  
+  
+ 構成とコーディング  
+ アプリケーションは、コーディング、構成、またはこの 2 つの組み合わせによって制御できます。構成には、コードの作成後、再コンパイルを必要とせずに、開発者以外のユーザー \(ネットワーク管理者など\) がクライアントとサービスのパラメーターを設定できるという利点があります。構成では、エンドポイント アドレスなどの値を設定できるだけでなく、エンドポイント、バインディング、および動作の追加が可能であるため、制御を強化することもできます。コーディングの場合、開発者はサービスまたはクライアントのすべてのコンポーネントに対する厳密な制御を保持できます。構成によって行われた設定を検査し、必要に応じてコードによって無効にできます。  
+  
+ サービス操作  
+ 操作の機能を実装するためにサービスのコードに定義された手順です。この操作は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのメソッドとしてクライアントに公開されます。メソッドは、値を返すこともあれば、任意の数の引数を受け取ることもあります。また、引数を受け取らず、応答を返さないこともあります。たとえば、単純な "Hello" という機能を持つ操作をクライアントの存在の通知として使用したり、一連の操作を開始するために使用したりできます。  
+  
+ サービス コントラクト  
+ 関連する複数の操作を 1 つの機能単位に関連付けます。コントラクトでは、サービスの名前空間や対応するコールバック コントラクトなど、サービス レベルの設定を定義できます。ほとんどの場合、開発者が選択したプログラミング言語でインターフェイスを作成し、このインターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> 属性を適用することによって、コントラクトを定義します。実際のサービス コードは、インターフェイスを実装することによって作成されます。  
+  
+ 操作コントラクト  
+ 操作コントラクトとは、操作のパラメーターと戻り値の型を定義するものです。サービス コントラクトを定義するインターフェイスの作成時に、コントラクトに含まれる各メソッド定義に <xref:System.ServiceModel.OperationContractAttribute> 属性を適用することによって、操作コントラクトを表します。各操作は、単一のメッセージを取得し、単一のメッセージを返すようにモデル化することも、一連の型を取得し、型を返すようにモデル化することもできます。後者の場合、その操作用に交換する必要のあるメッセージの形式がシステムによって決定されます。  
+  
+ メッセージ コントラクト  
+ メッセージの形式を記述します。たとえば、メッセージ要素をヘッダーと本文のどちらに入れるか、メッセージのどの要素にどのレベルのセキュリティを適用するかなどを宣言します。  
+  
+ エラー コントラクト  
+ サービス操作に関連付けることにより、呼び出し元に返すことのできるエラーを示すことができます。操作には、0 個以上のエラーを関連付けることができます。これらのエラーは、プログラミング モデルで例外としてモデル化される SOAP エラーです。  
+  
+ データ コントラクト  
+ サービスが使用するデータ型のメタデータの記述。これにより、他のサービスをそのサービスと相互運用できます。このデータ型は、パラメーターや戻り値など、メッセージの任意の部分で使用することができます。サービスが単純型だけを使用している場合、データ コントラクトを明示的に使用する必要はありません。  
+  
+ ホスト  
+ サービスは、何らかのプロセス内でホストされている必要があります。*ホスト*とは、サービスの有効期間を制御するアプリケーションです。サービスは、自己ホスト型であっても、既存のホスティング プロセスによって管理されていてもかまいません。  
+  
+ 自己ホスト型サービス  
+ 開発者が作成したプロセス アプリケーション内で実行されるサービスです。開発者は、サービスの有効期間を制御し、サービスのプロパティを設定します。また、サービスを開き \(サービスをリッスン モードに設定する\)、サービスを閉じることも開発者が行います。  
+  
+ ホスティング プロセス  
+ サービスをホストするように設計されたアプリケーションです。ホスティング プロセスには、インターネット インフォメーション サービス \(IIS\)、Windows アクティブ化サービス \(WAS\)、Windows サービスなどがあります。これらのホスト シナリオでは、ホストがサービスの有効期間を制御します。たとえば、IIS を使用して、サービス アセンブリや構成ファイルを格納する仮想ディレクトリを設定できます。メッセージを受信すると、IIS はサービスを開始し、その有効期間を制御します。  
+  
+ インスタンス化  
+ サービスには、インスタンス化モデルが含まれます。インスタンス化モデルには、1 つの CLR オブジェクトがすべてのクライアントにサービスを提供する "単一モデル"、クライアント呼び出しを処理するために、呼び出しごとに新しい CLR オブジェクトが作成される "呼び出しモデル"、CLR オブジェクトのセットがセッションごとに 1 つ作成される "セッション モデル" の 3 つのモデルがあります。インスタンス化モデルの選択は、アプリケーション要件とサービスの予想される使用パターンによって異なります。  
+  
+ クライアント アプリケーション  
+ 1 つ以上のエンドポイントとメッセージを交換するプログラムです。クライアント アプリケーションは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのインスタンスを作成し、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのメソッドを呼び出すことによって開始されます。1 つのアプリケーションがクライアントとサービスの両方として機能できることに注意してください。  
+  
+ channel  
+ バインディング要素の具象実装です。バインディングは構成を表し、チャネルはその構成に関連付けられた実装です。したがって、各バインディング要素に関連付けられたチャネルが存在します。チャネルが積み重ねられて、バインディングの具象実装 \(チャネル スタック\) が作成されます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント  
+ サービス操作を \(Visual Basic や Visual C\# など、開発者が選択した [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] プログラミング言語の\) メソッドとして公開するクライアント アプリケーション構造体です。サービスをホストするアプリケーションも含め、すべてのアプリケーションが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントをホストできます。したがって、他のサービスの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを含むサービスを作成できます。  
+  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用し、メタデータを公開する実行中のサービスでメタデータを指定することによって、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを自動的に生成できます。  
+  
+ メタデータ  
+ サービスで、外部エンティティがそのサービスと通信するために認識しておく必要のあるサービスの特性を示します。[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) でメタデータを使用することにより、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントおよび付随する構成を生成できます。クライアント アプリケーションは、サービスとやり取りするためにこの構成を使用します。  
+  
+ サービスが公開するメタデータには、サービスのデータ コントラクトが定義された XML スキーマ ドキュメントと、サービスのメソッドが記載された WSDL ドキュメントが含まれます。  
+  
+ メタデータを有効にすると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によってサービスとそのエンドポイントが検査され、サービスのメタデータが自動的に生成されます。サービスからメタデータを公開するには、メタデータの動作を明示的に有効にする必要があります。  
+  
+ セキュリティ  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、機密性 \(盗聴を防ぐためのメッセージの暗号化\)、整合性 \(メッセージの改ざんを検出するための手段\)、認証 \(サーバーとクライアントを検証する方法\)、承認 \(リソースへのアクセスの制御\) が含まれます。これらの機能は、TLS over HTTP \(HTTPS とも呼ばれます\) などの既存のセキュリティ機構を利用するか、さまざまな WS\-\* セキュリティ仕様の中から 1 つ以上の仕様を実装することによって実現されます。  
+  
+ トランスポート セキュリティ モード  
+ トランスポート層の機構 \(HTTPS など\) によって、機密性、整合性、および認証を提供することを示します。HTTPS のようなトランスポートを使用する場合、このモードには、パフォーマンスの面で効率的であることと、インターネットで普及しているため、十分に認識されているという利点があります。欠点は、この種のセキュリティは通信パスの各ホップで個別に適用されるため、通信が "Man\-in\-the\-middle" 攻撃の影響を受けやすくなることです。  
+  
+ メッセージ セキュリティ モード  
+ セキュリティ仕様 \([Web Services Security: SOAP Message Security](http://go.microsoft.com/fwlink/?LinkId=94684) など\) を 1 つ以上実装することによってセキュリティを提供することを示します。各メッセージには、メッセージ送信中のセキュリティを確保し、受信側による改ざんの検出とメッセージの復号化を可能にするために必要な機構が含まれます。この意味で、セキュリティはすべてのメッセージ内にカプセル化されるため、複数のホップにわたるエンド ツー エンドのセキュリティが実現します。セキュリティ情報はメッセージの一部になるため、メッセージと共に複数の種類の資格情報を含めることもできます \(これらは*クレーム*と呼ばれます\)。この方法には、送信元と送信先の間の複数のトランスポートを含め、どのトランスポート上でもメッセージを安全に送信できるという利点もあります。この方法の欠点は、使用される暗号化機構が複雑であるため、パフォーマンスに影響することです。  
+  
+ メッセージ資格情報付きトランスポート セキュリティ モード  
+ トランスポート層を使用してメッセージの機密性、認証、および整合性を提供します。各メッセージには、メッセージの受信側で必要とされる複数の資格情報 \(クレーム\) を含めることができます。  
+  
+ WS\-\*  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に実装された一連の Web サービス \(WS\) 仕様 \(WS\-Security や WS\-ReliableMessaging など\) の略称です。  
+  
+## 参照  
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)   
+ [Windows Communication Foundation のアーキテクチャ](../../../docs/framework/wcf/architecture.md)   
+ [Security Architecture](http://msdn.microsoft.com/ja-jp/16593476-d36a-408d-808c-ae6fd483e28f)
\ No newline at end of file
diff --git a/docs/framework/wcf/general-reference.md b/docs/framework/wcf/general-reference.md
new file mode 100644
index 00000000000..80a1e902076
--- /dev/null
+++ b/docs/framework/wcf/general-reference.md
@@ -0,0 +1,24 @@
+---
+title: "一般的なリファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "一般的なリファレンス [WCF]"
+  - "WCF, 一般リファレンス"
+  - "Windows Communication Foundation, 一般リファレンス"
+ms.assetid: b1a21e93-4700-46e6-88ca-bd7a50e19a16
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 一般的なリファレンス
+「[\<system.serviceModel\>](../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)」では、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] クライアントとサービスの構成に使用する要素について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/generating-data-type-classes-from-xml.md b/docs/framework/wcf/generating-data-type-classes-from-xml.md
new file mode 100644
index 00000000000..37dafbce9a9
--- /dev/null
+++ b/docs/framework/wcf/generating-data-type-classes-from-xml.md
@@ -0,0 +1,52 @@
+---
+title: "XML からのデータ型クラスの生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4e5e4e8-527f-44d1-92fa-8904a08784ea
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# XML からのデータ型クラスの生成
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] には、XML からデータ型クラスを生成するための新しい機能があります。  このトピックでは、MSDN ライブラリの RSS フィードのデータ型を自動的に生成する方法について説明します。  
+  
+### MSDN ライブラリの RSS フィードからの XML の取得  
+  
+1.  Internet Explorer で、[MSDN RSS フィード](http://go.microsoft.com/fwlink/?LinkId=225209)に移動します。  
+  
+2.  ページを右クリックし、**\[ソースの表示\]** を選択します。  
+  
+3.  Ctrl キーを押しながら A キーを押してフィードのテキストをすべて選択し、Ctrl キーを押しながら C キーを押してコピーします。  
+  
+### データ型の作成  
+  
+1.  プロキシが使用されるコード ファイルを開きます。  このファイルは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] プロジェクトの一部である必要があります。  
+  
+2.  既存のクラスの外部にあるファイルの場所にカーソルを置きます。  
+  
+3.  **\[編集\]**、**\[形式を選択して貼り付け\]**、**\[XML をクラスとして貼り付ける\]** の順に選択します。  
+  
+4.  `rss`、`rssChannel`、`rssChannelImage`、および `rssChannelItem` というクラスは、RSS フィードの要素にアクセスするために必要なメンバーを使用して作成されます。  
+  
+### 生成されたクラスの使用  
+  
+1.  クラスが生成されると、他のクラスのコードなどで使用できます。  次のコード例では、`rssChannelImage` クラスの新しいインスタンスが返されます。  
+  
+    ```  
+    var channelImage = new rssChannelImage()   
+    {   
+        title = "MyImage",   
+        link = "http://www.contoso.com/images/channelImage.jpg",   
+        url = "http://www.contoso.com/entries/myEntry.html"   
+    };  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/getting-started-tutorial.md b/docs/framework/wcf/getting-started-tutorial.md
new file mode 100644
index 00000000000..f4c96366fed
--- /dev/null
+++ b/docs/framework/wcf/getting-started-tutorial.md
@@ -0,0 +1,75 @@
+---
+title: "チュートリアル入門 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "はじめに [WCF]"
+  - "WCF [WCF], はじめに"
+  - "Windows Communication Foundation [WCF], はじめに"
+ms.assetid: df939177-73cb-4440-bd95-092a421516a1
+caps.latest.revision: 47
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 47
+---
+# チュートリアル入門
+このセクションの各トピックで、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のプログラミング方法について簡単に説明します。  これらは、このトピックに記載されているリストの順番どおりに完了するように設計されています。  このチュートリアルを通じて [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスおよびクライアント アプリケーションの作成に必要な手順について理解することができます。  サービスは 1 つ以上のエンドポイントを公開し、それぞれのエンドポイントは 1 つ以上のサービス操作を公開します。  サービスの*エンドポイント*は、サービスの場所を示すアドレス、クライアントがサービスとどのように通信する必要があるかを示す情報を格納するバインディング、およびサービスがクライアントに提供する機能を定義するコントラクトを指定します。  
+  
+ このチュートリアルの一連のトピックを終了すると、サービスを実行し、クライアントからそのサービスを呼び出すことができるようになります。  最初の 3 つのトピックでは、サービス コントラクトを定義する方法、サービス コントラクトを実装する方法、およびサービスをホストする方法について説明します。  作成したサービスは、コンソール アプリケーション内で自己ホストされます。  また、サービスは、インターネット インフォメーション サービス \(IIS\) でホストすることもできます。  その方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]「[方法 : IIS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)」を参照してください。  サービスはコードで構成されますが、構成ファイル内で構成することもできます。  構成ファイル[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)」を参照してください。  
+  
+ 次の 3 つのトピックでは、クライアント プロキシを作成する方法、クライアント アプリケーションを構成する方法、およびサービスが公開するサービス操作をクライアント プロキシを使って呼び出す方法について説明します。  サービスは、クライアント アプリケーションがサービスと通信するために必要な情報を定義したメタデータを公開します。  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] は、このメタデータにアクセスするプロセスを自動化し、それを使って、サービスのクライアント アプリケーションを構築および構成します。  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を使用していない場合は、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、サービスのクライアント アプリケーションを構築および構成できます。  
+  
+ このセクションのすべてのトピックでは、開発環境として Visual Studio 2011 を使用することを前提としています。  他の開発環境を使用する場合は、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] に固有の指示については無視してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[wv](../../../includes/wv-md.md)] 以降のバージョンの Windows オペレーティング システムを実行している場合は、\[スタート\] メニューの \[Visual Studio 2011\] を右クリックし、**\[管理者として実行\]** をクリックして [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] を起動する必要があります。  Visual Studio 2011 を常に管理者として起動するには、ショートカットを作成して右クリックし、プロパティをクリックします。次に、**\[互換性\]** タブをクリックし、**\[管理者としてこのプログラムを実行する\]** チェック ボックスをオンにします。  このショートカットで Visual Studio 2011 を起動すると、常に管理者として実行されます。  
+  
+ ハード ディスクにダウンロードして実行できるサンプル アプリケーションについては、「[Windows Communication Foundation Samples](http://msdn.microsoft.com/ja-jp/8ec9d192-5d81-4f64-bfd3-90c5e5858c91)」のトピックを参照してください。  このトピックでは特に、「[概要](../../../docs/framework/wcf/samples/getting-started-sample.md)」を参照してください。  
+  
+ サービスとクライアントを作成する方法の詳細については、「[基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+## このセクションの内容  
+ [方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)  
+ ユーザー定義のインターフェイスを使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コントラクトを作成する方法について説明します。  コントラクトは、サービスが公開する機能を定義します。  
+  
+ [方法 : サービス コントラクトを実装する](../../../docs/framework/wcf/how-to-implement-a-wcf-contract.md)  
+ サービス コントラクトを実装する方法について説明します。  定義したコントラクトはサービスのクラスと共に実装する必要があります。  
+  
+ [方法 : 基本的なサービスをホストおよび実行する](../../../docs/framework/wcf/how-to-host-and-run-a-basic-wcf-service.md)  
+ サービスのエンドポイントをコードで構成する方法と、コンソール アプリケーションでサービスをホストする方法について説明します。  サービスをアクティブにするには、サービスをランタイム環境内で構成してホストする必要があります。  この環境によってサービスが作成され、サービスのコンテキストと有効期間が制御されます。  
+  
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスから [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを作成するために使用するメタデータを取得する方法について説明します。  このプロセスでは、Visual Studio 2011 の "サービス参照の追加" 機能を使用します。  
+  
+ [方法 : クライアントを構成する](../../../docs/framework/wcf/how-to-configure-a-basic-wcf-client.md)  
+ WCF クライアントの構成方法について説明します。クライアントを構成するには、クライアントがサービスへのアクセスに使用するエンドポイントを指定する必要があります。  
+  
+ [方法 : クライアントを使用する](../../../docs/framework/wcf/how-to-use-a-wcf-client.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを使用してサービス操作を呼び出す方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.ServiceContractAttribute>  
+  
+ <xref:System.ServiceModel.OperationContractAttribute>  
+  
+## 関連項目  
+ [Windows Communication Foundation Samples](http://msdn.microsoft.com/ja-jp/8ec9d192-5d81-4f64-bfd3-90c5e5858c91)  
+  
+ [基本的なプログラミング ライフサイクル](../../../docs/framework/wcf/basic-programming-lifecycle.md)  
+  
+## 参照  
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)   
+ [ドキュメントのガイド](../../../docs/framework/wcf/guide-to-the-documentation.md)   
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)   
+ [WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/glossary.md b/docs/framework/wcf/glossary.md
new file mode 100644
index 00000000000..8615cf2972a
--- /dev/null
+++ b/docs/framework/wcf/glossary.md
@@ -0,0 +1,68 @@
+---
+title: ".NET Framework 4.5 の Windows Communication Foundation 用語集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF [WCF], 用語集"
+  - "Windows Communication Foundation [WCF], 用語集"
+ms.assetid: 39cd36f4-8a28-4d0b-a830-98d55c9d30ae
+caps.latest.revision: 243
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 243
+---
+# .NET Framework 4.5 の Windows Communication Foundation 用語集
+次の表に、Windows Communication Foundation のドキュメントで使用する用語の定義を示します。  
+  
+## 用語  
+  
+|用語|定義|  
+|--------|--------|  
+|address|メッセージを受信する場所を指定します。  アドレスは、URI \(Uniform Resource Identifier\) として指定されます。  URI のスキーマ部分では、そのアドレスに到達するために使用するトランスポート機構 \(HTTP、TCP など\) を指定します。  URI の階層部分には一意の場所が含まれ、その形式はトランスポート機構によって異なります。|  
+|アプリケーション エンドポイント|アプリケーションによって公開されるエンドポイントです。アプリケーション エンドポイントは、アプリケーションで実装されるサービス コントラクトに対応しています。|  
+|動作|動作とは、サービス、エンドポイント、特定の操作、またはクライアントの実行時のさまざまな状況を制御するコンポーネントです。  動作はスコープに従ってグループ化されます。共通動作は、すべてのエンドポイントにグローバルに作用し、サービス動作は、サービスに関連する側面にのみ作用します。また、エンドポイントの動作は、エンドポイントに関連するプロパティにのみ作用し、操作レベルの動作は特定の操作に作用します。|  
+|バインド|WCF サービスとの通信に使用する通信プロトコルを指定します。  バインディングは、バインディング要素と呼ばれる一連のコンポーネントで構成されます。各バインディング要素を積み重ねることで、通信インフラストラクチャが作成されます。  「エンドポイント」を参照してください。|  
+|チャネル|バインディング要素の具象実装です。  バインディングは構成を表し、チャネルはその構成に関連付けられた実装です。  したがって、各バインディング要素に関連付けられたチャネルが存在します。  チャネルが積み重ねられて、バインディングの具象実装 \(チャネル スタック\) が作成されます。|  
+|クレーム ベース セキュリティ|クレームに基づいて、保護されているリソースへの承認されたアクセスを許可します。|  
+|クライアント アプリケーション|クライアント アプリケーションは、1 つ以上のエンドポイントとメッセージを交換するプログラムです。  クライアント アプリケーションは、WCF クライアントのインスタンスを作成し、WCF クライアントのメソッドを呼び出すことによって開始されます。  1 つのアプリケーションがクライアントとサービスの両方として機能できることに注意してください。|  
+|コーディング|開発者は、サービスまたはクライアントのすべてのコンポーネントに対する厳密な制御を保持できます。構成によって行われた設定を検査し、必要に応じてコードによって無効にできます。  アプリケーションは、コーディング、構成、またはこの 2 つの組み合わせによって制御できます。|  
+|構成|構成には、コードの作成後、再コンパイルを必要とせずに、開発者以外のユーザー \(ネットワーク管理者など\) がクライアントとサービスのパラメーターを設定できるという利点があります。  構成では、エンドポイント アドレスなどの値を設定できるだけでなく、エンドポイント、バインディング、および動作の追加が可能であるため、制御を強化することもできます。  アプリケーションは、構成、コーディング、またはこの 2 つの組み合わせによって制御できます。|  
+|コントラクト|コントラクトは、特定の種類のコントラクトに対するサポート仕様です。  たとえば、サービス コントラクトは、操作のグループに対する仕様です。  WCF では、コントラクトは階層構造を持ち、これは System.ServiceModel.Description 名前空間に存在する説明オブジェクトにミラー化されています。  サービス コントラクトは、WCF で最も大きなコントラクト スコープです。  サービス コントラクトの各サービス操作には、エラー メッセージを含め、操作により交換されるメッセージとその交換方向を規定した操作コントラクトがあります。  操作の各メッセージには、メッセージ コントラクト、つまり SOAP メッセージ エンベロープの構造仕様があり、個々のメッセージ コントラクトには、メッセージに含まれるデータ構造を規定したデータ コントラクトがあります。|  
+|データ コントラクト|サービスが使用するデータ型をメタデータに記述して、他のサービスがそのサービスと相互運用できるようにする必要があります。  データ型の記述は、データ コントラクトと呼ばれます。型は、メッセージの任意の部分で使用できます \(パラメーターや戻り値の型など\)。  サービスが単純型だけを使用している場合、データ コントラクトを明示的に使用する必要はありません。|  
+|宣言アプリケーション|命令を実行しなくても実行時に作成されるように記述されたアプリケーションです。|  
+|エンドポイント|WCF サービスとの通信に使用されるアドレス、バインディング、およびコントラクトで構成されます。|  
+|エンドポイント アドレス|サービスのエンドポイントごとに一意のエンドポイント アドレスを作成できます。また、一定の条件下では、エンドポイント間でアドレスを共有することもできます。|  
+|エラー コントラクト|エラー コントラクトをサービス操作に関連付けることにより、呼び出し元に返すことのできるエラーを示すことができます。  操作には、0 個以上のエラーを関連付けることができます。  これらのエラーは、プログラミング モデルで例外としてモデル化される SOAP エラーです。  例外は SOAP エラーに変換され、その後、クライアントに送信されます。|  
+|ホスティング|サービスは、何らかのプロセス内でホストされている必要があります。  ホストは、サービスの有効期間を制御するアプリケーションです。  サービスは、自己ホスト型であっても、既存のホスティング プロセスによって管理されていてもかまいません。|  
+|ホスト プロセス|ホスティング プロセスとは、サービスをホストするように設計されたアプリケーションです。  ホスティング プロセスには、インターネット インフォメーション サービス \(IIS\)、Windows アクティブ化サービス \(WAS\)、Windows サービスなどがあります。  これらのホスト シナリオでは、ホストがサービスの有効期間を制御します。  たとえば、IIS を使用して、サービス アセンブリや構成ファイルを格納する仮想ディレクトリを設定できます。  メッセージを受信すると、IIS はサービスを開始し、その有効期間を制御します。|  
+|開始操作|新しいセッションの最初の操作として呼び出される操作です。  開始操作以外の操作は、少なくとも 1 つの開始操作が呼び出された後にしか呼び出すことはできません。|  
+|インスタンス化モデル|サービスには、インスタンス化モデルが含まれます。  インスタンス化モデルには、1 つの CLR オブジェクトがすべてのクライアントにサービスを提供する &quot;単一モデル&quot、クライアント呼び出しを処理するために、呼び出しごとに新しい CLR オブジェクトが作成される &quot;呼び出しモデル&quot、CLR オブジェクトのセットがセッションごとに 1 つ作成される &quot;セッション モデル&quot の 3 つのモデルがあります。  インスタンス化モデルの選択は、アプリケーション要件とサービスの予想される使用パターンによって異なります。|  
+|message|メッセージとは、本文やヘッダーなどの複数の部分で構成できるデータの内部格納ユニットです。|  
+|メッセージ コントラクト|メッセージ コントラクトは、メッセージの形式を記述します。  たとえば、メッセージ要素をヘッダーと本文のどちらに入れるか、メッセージのどの要素にどのレベルのセキュリティを適用するかなどを宣言します。|  
+|メッセージ セキュリティ モード|メッセージ セキュリティ モードでは、セキュリティ仕様の 1 つまたは複数を実装することによりセキュリティが提供されます。  各メッセージには、メッセージ送信中のセキュリティを確保し、受信側による改ざんの検出とメッセージの復号化を可能にするために必要な機構が含まれます。  この意味で、セキュリティはすべてのメッセージ内にカプセル化されるため、複数のホップにわたるエンド ツー エンドのセキュリティが実現します。  セキュリティ情報はメッセージの一部になるため、メッセージと共に複数の種類の資格情報を含めることもできます \(これらはクレームと呼ばれます\)。  この方法には、送信元と送信先の間の複数のトランスポートを含め、どのトランスポート上でもメッセージを安全に送信できるという利点もあります。  この方法の欠点は、使用される暗号化機構が複雑であるため、パフォーマンスに影響することです。|  
+|メタデータ|サービスのメタデータは、外部エンティティがそのサービスと通信するために認識しておく必要のあるサービスの特性を示します。  ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\) でメタデータを使用することにより、クライアント アプリケーションがサービスとやり取りするために使用できる、WCF クライアントと付随する構成を生成できます。  サービスが公開するメタデータには、サービスのデータ コントラクトが定義された XML スキーマ ドキュメントと、サービスのメソッドが記載された WSDL ドキュメントが含まれます。  メタデータを有効にすると、WCF によってサービスとそのエンドポイントが検査され、サービスのメタデータが自動的に生成されます。  サービスからメタデータを公開するには、メタデータの動作を明示的に有効にする必要があります。|  
+|操作コントラクト|操作コントラクトは、操作のパラメーターと戻り値の型を定義します。  サービス コントラクトを定義するインターフェイスの作成時に、コントラクトに含まれる各メソッド定義に T:System.ServiceModel.OperationContractAttribute 属性を適用することによって、操作コントラクトを表します。  各操作は、単一のメッセージを取得し、単一のメッセージを返すようにモデル化することも、一連の型を取得し、型を返すようにモデル化することもできます。  後者の場合、その操作用に交換する必要のあるメッセージの形式がシステムによって決定されます。|  
+|射影|ネットワーク上でのデータの表現です。  たとえば、メッセージは、SOAP 射影では SOAP エンベロープとして送信され、Web 射影では JSON 形式で送信されます。|  
+|セキュリティ|WCF のセキュリティには、機密性 \(盗聴を防ぐためのメッセージの暗号化\)、整合性 \(メッセージの改ざんを検出するための手段\)、認証 \(サービスとクライアントを検証する方法\)、承認 \(リソースへのアクセスの制御\) が含まれます。  これらの機能は、TLS over HTTP \(HTTPS とも呼ばれます\) などの既存のセキュリティ機構を利用するか、さまざまな WS\-\* セキュリティ仕様の中から 1 つ以上の仕様を実装することによって実現されます。|  
+|自己ホスト サービス|自己ホスト型サービスとは、開発者が作成したプロセス アプリケーション内で実行されるサービスです。  開発者は、サービスの有効期間を制御し、サービスのプロパティを設定します。また、サービスを開き \(サービスをリッスン モードに設定する\)、サービスを閉じることも開発者が行います。|  
+|service|1 つ以上のエンドポイントを公開するプログラムまたはプロセスです。各エンドポイントは、1 つ以上の操作を公開します。|  
+|サービス コントラクト|サービス コントラクトは、関連する複数の操作を 1 つの機能単位に関連付けます。  コントラクトでは、サービスの名前空間や対応するコールバック コントラクトなど、サービス レベルの設定を定義できます。  ほとんどの場合、開発者は選択したプログラミング言語でインターフェイスを作成し、このインターフェイスに T:System.ServiceModel.ServiceContractAttribute 属性を適用することによって、コントラクトを定義します。  実際のサービス コードは、インターフェイスを実装することによって作成されます。|  
+|サービス操作|サービス操作とは、操作の機能を実装するためにサービスのコードに定義された手順です。  この操作は、WCF クライアントのメソッドとしてクライアントに公開されます。  メソッドは、値を返すこともあれば、任意の数の引数を受け取ることもあります。また、引数を受け取らず、応答を返さないこともあります。  たとえば、&quot;Hello&quot; という機能を持つ操作をクライアントの存在の通知として使用したり、一連の操作を開始するために使用したりできます。|  
+|システム指定のバインディング|WCF には、システム指定のバインディングが多数用意されています。  これらは、特定のシナリオ用に最適化されたバインディング要素の集まりです。  たとえば、T:System.ServiceModel.WSHttpBinding は、さまざまな WS\-\* 仕様を実装するサービスと相互運用できるようにデザインされています。  これらのバインディングでは、特定のシナリオに適切に適用できるオプションだけが提供されるため、時間を節約できます。  これらのバインディングでは要件が満たされない場合は、独自のカスタム バインディングを作成できます。|  
+|終了操作|既存セッションの最後のメッセージとして呼び出される操作です。  既定では、WCF は、サービスが関連付けられているセッションが閉じられた後に、サービス オブジェクトとそのコンテキストを再利用します。|  
+|トランスポート セキュリティ モード|セキュリティは、トランスポート モード、メッセージ セキュリティ モード、およびメッセージ資格情報付きトランスポート モードのいずれかによって提供できます。  トランスポート セキュリティ モードは、トランスポート層の機構 \(HTTPS など\) によって、機密性、整合性、および認証を提供することを示します。  HTTPS のようなトランスポートを使用する場合、このモードには、パフォーマンスの面で効率的であることと、インターネットで普及しているため、十分に認識されているという利点があります。  欠点は、この種のセキュリティは通信パスの各ホップで個別に適用されるため、通信が &quot;Man\-in\-the\-middle&quot; 攻撃の影響を受けやすくなることです。|  
+|メッセージ資格情報付きトランスポート セキュリティ モード|このモードは、トランスポート層を使用してメッセージの機密性、認証、および整合性を提供します。各メッセージには、メッセージの受信側で必要とされる複数の資格情報 \(クレーム\) を含めることができます。|  
+|型コンバーター|CLR 型は、CLR 型のインスタンスと他の型のインスタンスを変換する 1 つまたは複数の System.ComponentModel.TypeConverter 派生型に関連付けることができます。  型コンバーターは、System.ComponentModel.TypeConverterAttribute 属性を使用して、CLR 型に関連付けられています。  TypeConverterAttribute は、CLR 型またはプロパティで直接指定できます。  プロパティで指定された型コンバーターは、プロパティの CLR 型で指定された型コンバーターよりも常に優先されます。|  
+|WCF クライアント|WCF クライアントは、サービス操作を \(Visual Basic や Visual C\# など、開発者が選択した .NET Framework プログラミング言語の\) メソッドとして公開するクライアント アプリケーション構造体です。  サービスをホストするアプリケーションも含め、すべてのアプリケーションが WCF クライアントをホストできます。  したがって、他のサービスの WCF クライアントを含むサービスを作成できます。  ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\) を使用し、メタデータを公開する実行中のサービスでメタデータを指定することによって、WCF クライアントを自動的に生成できます。|  
+|ワークフロー サービス|ワークフロー サービスは、ワークフローとして実装される WCF サービスです。  ワークフローには、WCF メッセージを送受信するメッセージング アクティビティが含まれています。|  
+|WS\-\*|WCF に実装された一連の Web サービス \(WS\) 仕様 \(WS\-Security や WS\-ReliableMessaging など\) の略称です。|  
+|XAML|eXtensible Application Markup Language|  
+|XAML スキーマ|XAML でカスタム型を定義するために使用されるマークアップ スキーマです。|
\ No newline at end of file
diff --git a/docs/framework/wcf/guide-to-the-documentation.md b/docs/framework/wcf/guide-to-the-documentation.md
new file mode 100644
index 00000000000..23ce5134b8a
--- /dev/null
+++ b/docs/framework/wcf/guide-to-the-documentation.md
@@ -0,0 +1,78 @@
+---
+title: "ドキュメントのガイド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF [WCF], ドキュメント"
+  - "Windows Communication Foundation [WCF], ドキュメント"
+ms.assetid: 2aa18c85-a4fd-4bb9-986a-a8249e4f8e0e
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# ドキュメントのガイド
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] ドキュメントについて説明します。リンク先のドキュメントは、特定の目的と専門知識のレベルに応じて分類された、推奨される出発点となります。  
+  
+ スタンドアロン バージョンのドキュメントとヘルプ ビューアーをインストールするには、[Microsoft Windows SDK v 7.1](http://go.microsoft.com/fwlink/?LinkID=194146&clcid=0x409) をダウンロードしてください。  
+  
+## Windows Communication Foundation プログラミングの初心者向けドキュメント  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用したプログラミングの初心者であり、動作するアプリケーションのサンプルをまず確認する必要がある場合は、「[Windows Communication Foundation サンプル](../../../docs/framework/wcf/samples/index.md)」の一覧に示された各トピックを参照してください。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスおよびクライアントの基本的な作成方法を順を追って解説したチュートリアルが必要な場合は、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の背景にある概念に関心がある場合は、「[概念](../../../docs/framework/wcf/conceptual-overview.md)」の各トピックを参照してください。  
+  
+-   クライアントおよびサーバーのセキュリティ構成例の図については、「[一般的なセキュリティ シナリオ](../../../docs/framework/wcf/feature-details/common-security-scenarios.md)」を参照してください。  
+  
+## プログラミングの詳細  
+  
+-   アプリケーション開発を開始する準備が整っている場合は、「[基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)」を参照してください。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の特定の機能に関するガイダンスが必要な場合は、「[WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)」の各トピックを参照してください。  
+  
+-   要件に合わせて [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を拡張したり、カスタマイズしたりする場合は、「[WCF の拡張](../../../docs/framework/wcf/extending/extending-wcf.md)」を参照してください。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの作成やデバッグを支援するツールについては、「[Windows Communication Foundation ツール](../../../docs/framework/wcf/tools.md)」を参照してください。  
+  
+-   XML ファイルを使用した構成は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスおよびクライアントをプログラミングする主な方法の 1 つです。構成ファイルで使用する XML 要素のリファレンス ドキュメントが必要な場合は、「[WCF 構成スキーマ](../../../docs/framework/configure-apps/file-schema/wcf/index.md)」を参照してください。  
+  
+## トラブルシューティング  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の一般的な問題のトラブルシューティングについては、「[WCF トラブルシューティング クイックスタート](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md)」を参照してください。  
+  
+## Windows Communication Foundation の他のテクノロジの統合  
+  
+-   ASP.NET クライアントと通信するサービスを作成する場合は、「[方法 : WCF サービスおよび ASP.NET Web サービス クライアントを相互運用するために構成する](../../../docs/framework/wcf/feature-details/config-wcf-service-with-aspnet-web-service.md)」を参照してください。  
+  
+-   [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] リモート処理との統合については、「[.NET リモート処理アプリケーションの WCF への移行](../../../docs/framework/wcf/feature-details/migrating-net-remoting-applications-to-wcf.md)」を参照してください。  
+  
+-   既存の COM\+ アプリケーションを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスまたはクライアントと統合する場合は、「[COM\+ アプリケーションとの統合の概要](../../../docs/framework/wcf/feature-details/integrating-with-com-plus-applications-overview.md)」を参照してください。  
+  
+-   既存の COM アプリケーションを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスまたはクライアントと統合する場合は、「[COM アプリケーションとの統合](../../../docs/framework/wcf/feature-details/integrating-with-com-applications.md)」を参照してください。  
+  
+-   既存の MSMQ アプリケーションを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスまたはクライアントと統合する場合は、「[方法 : WCF エンドポイントを使用してキューに置かれたメッセージを交換する](../../../docs/framework/wcf/feature-details/how-to-exchange-queued-messages-with-wcf-endpoints.md)」および「[方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)」を参照してください。  
+  
+-   インターネット インフォメーション サービス \(IIS\) を使用してサービスをホストする場合は、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で Web サービス拡張 \(WSE: Web Services Extensions\) 3.0 サービスを使用する場合は、「[方法 : WSE 3.0 サービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-a-wse-3-0-service-with-a-wcf-client.md)」を参照してください。  
+  
+## Windows Communication Foundation でサポートされる WS\-\* プロトコル  
+ システム指定のバインディングでサポートされるプロトコルの一覧については、「[システム標準の相互運用性バインディングがサポートしている Web サービス プロトコル](../../../docs/framework/wcf/feature-details/web-services-protocols-supported-by-system-provided-interoperability-bindings.md)」を参照してください。システム指定のバインディングの一覧については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## 参照  
+ [Windows Communication Foundation サンプル](../../../docs/framework/wcf/samples/index.md)   
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)   
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)   
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/guidelines-and-best-practices.md b/docs/framework/wcf/guidelines-and-best-practices.md
new file mode 100644
index 00000000000..8e3a849c698
--- /dev/null
+++ b/docs/framework/wcf/guidelines-and-best-practices.md
@@ -0,0 +1,61 @@
+---
+title: "ガイドラインとベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "ベスト プラクティス [WCF], アプリケーション設計"
+  - "WCF, ベスト プラクティス"
+  - "WCF, ガイドライン"
+  - "Windows Communication Foundation, ベスト プラクティス"
+  - "Windows Communication Foundation, ガイドライン"
+ms.assetid: 5098ba46-6e8d-4e02-b0c5-d737f9fdad84
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# ガイドラインとベスト プラクティス
+このセクションには、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションを作成する際のガイドラインとなるトピックが含まれています。  
+  
+## このセクションの内容  
+ [ベスト プラクティス : データ コントラクトのバージョン管理](../../../docs/framework/wcf/best-practices-data-contract-versioning.md)  
+ 将来のバージョンが作成されても影響を受けることのないデータ コントラクトを作成する方法と、そのタイミングについて説明します。  
+  
+ [サービスのバージョン管理](../../../docs/framework/wcf/service-versioning.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] でのバージョン管理の考え方について説明します。たとえば、変化するビジネス要件や IT 要件を満たしたり、問題を修復したりするために、展開後にサービス \(およびサービスによって公開されるエンドポイント\) を変更しなければならない場合があります。変更が発生するたびに、新しいバージョンのサービスが導入されます。  
+  
+ [負荷分散](../../../docs/framework/wcf/load-balancing.md)  
+ Web ファームでの負荷分散のガイドラインを示します。  
+  
+ [リソース消費の制御とパフォーマンスの向上](../../../docs/framework/wcf/controlling-resource-consumption-and-improving-performance.md)  
+ 過度のリソース消費を抑え、セキュリティを向上するために用意されているプロパティについて説明し、その使用方法の詳細情報を示します。  
+  
+ [ClickOnce を使用して WCF アプリケーションを展開する](../../../docs/framework/wcf/deploying-wcf-applications-with-clickonce.md)  
+ ClickOnce 機能を使用する際の考慮事項について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel>  
+  
+ <xref:System.Runtime.Serialization>  
+  
+## 関連項目  
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)  
+  
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)  
+  
+## 参照  
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)   
+ [Windows Communication Foundation Samples](http://msdn.microsoft.com/ja-jp/8ec9d192-5d81-4f64-bfd3-90c5e5858c91)   
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)   
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/host-a-wcf-service-net-framework-3-5-iis--net-framework-4.md b/docs/framework/wcf/host-a-wcf-service-net-framework-3-5-iis--net-framework-4.md
new file mode 100644
index 00000000000..eafb4cd7486
--- /dev/null
+++ b/docs/framework/wcf/host-a-wcf-service-net-framework-3-5-iis--net-framework-4.md
@@ -0,0 +1,92 @@
+---
+title: ".NET Framework 4 で実行されている IIS 内の .NET Framework 3.5 で作成された WCF サービスをホストする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9aabc785-068d-4d32-8841-3ef39308d8d6
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# .NET Framework 4 で実行されている IIS 内の .NET Framework 3.5 で作成された WCF サービスをホストする方法
+[!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] を実行するコンピューターで [!INCLUDE[netfx35_long](../../../includes/netfx35-long-md.md)] を使用して作成された [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスをホストすると、次のテキストで <xref:System.ServiceModel.ProtocolException> が返される場合があります。  
+  
+```Output  
+ハンドルされていない例外: System.ServiceModel.ProtocolException: 応答メッセージのコンテンツの種類 text/html; charset=utf-8 が、バインド (application/soap+xml; charset=utf-8) のコンテンツの種類と一致しません。カスタム エンコーダーを使用している場合は、IsContentTypeSupported メソッドが正しく実装されていることを確認してください。応答の先頭の 1024 バイトは '<html>    <head>        <title>' でした。アプリケーション ドメインまたはアプリケーション プールは、現在、バージョン 4 以降の .NET Framework を実行しています。この Web アプリケーションの IIS 設定が 4.0 以降に設定されている場合、または ASP.NET Web 開発サーバーのバージョン 4.0 以降を使用している場合に、この状況が発生することがあります。この Web アプリケーションの Web.config ファイル内の <compilation> 要素に、このバージョンの .NET Framework に必要な targetFrameworkMoniker 属性が含まれていません (<compilation targetFrameworkMoniker=".NETFramework,Version=v4.0"&gt, など)。この属性を使用して Web.config ファイルを更新するか、別のバージョンの .NET Framework を使用するように Web アプリケーションを構成します。</title>...  
+```  
+  
+ または、サービスの .svc ファイルを参照する際に、次のテキストのエラー ページが表示される場合があります。  
+  
+```Output  
+アプリケーション ドメインまたはアプリケーション プールは、現在、.NET Framework のバージョン 4.0 以降を実行しています。この Web アプリケーションの IIS 設定が 4.0 以降に設定されている場合、または ASP.NET Web 開発サーバーのバージョン 4.0 以降を使用している場合に、この状況が発生することがあります。この Web アプリケーションの Web.config ファイル内の <compilation> 要素に、このバージョンの .NET Framework に必要な targetFrameworkMoniker 属性が含まれていません ('<compilation targetFrameworkMoniker=".NETFramework,Version=v4.0">' など)。この属性を使用して Web.config ファイルを更新するか、別のバージョンの .NET Framework を使用するように Web アプリケーションを構成します。  
+```  
+  
+ これらのエラーは、IIS が実行されているアプリケーション ドメインが [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] を実行していて、WCF サービスが [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] で実行されるように構成されている場合に発生します。このトピックでは、このサービスを実行するために必要な変更について説明します。  
+  
+ 次に、\<`compilers`\> 要素を検索し、CompilerVersion プロバイダー オプションの値を 4.0 に変更します。既定では、2 つの \<`compiler`\> 要素が \<`compilers`\> 要素にあります。次の例に示すように、両方の CompilerVersion プロバイダー オプションを更新する必要があります。  
+  
+```  
+<system.codedom>  
+      <compilers>  
+        <compiler language="c#;cs;csharp" extension=".cs" warningLevel="4"  
+                  type="Microsoft.CSharp.CSharpCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+          <providerOption name="CompilerVersion" value="v3.5"/>  
+          <providerOption name="WarnAsError" value="false"/>  
+        </compiler>  
+        <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" warningLevel="4"  
+                  type="Microsoft.VisualBasic.VBCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+          <providerOption name="CompilerVersion" value="v3.5"/>  
+          <providerOption name="OptionInfer" value="true"/>  
+          <providerOption name="WarnAsError" value="false"/>  
+        </compiler>  
+      </compilers>  
+    </system.codedom>  
+```  
+  
+### 必要な targetFramework 属性の追加  
+  
+1.  サービスの Web.config ファイルを開き、\<`compilation`\> 要素を探します。  
+  
+2.  次の例に示すように、`targetFramework` 属性を \<`compilation`\> 要素に追加します。  
+  
+    ```  
+    <compilation debug="false"  
+            targetFramework="4.0">  
+  
+            <assemblies>  
+              <add assembly="System.Core, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>  
+              <add assembly="System.Xml.Linq, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>  
+              <add assembly="System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"/>  
+              <add assembly="System.Data.DataSetExtensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"/>  
+            </assemblies>  
+  
+          </compilation>  
+    ```  
+  
+3.  \<`compilers`\> 要素を検索し、CompilerVersion プロバイダー オプションの値を 4.0 に変更します。既定では、2 つの \<`compiler`\> 要素が \<`compilers`\> 要素にあります。次の例に示すように、両方の CompilerVersion プロバイダー オプションを更新する必要があります。  
+  
+    ```  
+    <system.codedom>  
+          <compilers>  
+            <compiler language="c#;cs;csharp" extension=".cs" warningLevel="4"  
+                      type="Microsoft.CSharp.CSharpCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+              <providerOption name="CompilerVersion" value="v3.5"/>  
+              <providerOption name="WarnAsError" value="false"/>  
+            </compiler>  
+            <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" warningLevel="4"  
+                      type="Microsoft.VisualBasic.VBCodeProvider, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">  
+              <providerOption name="CompilerVersion" value="v3.5"/>  
+              <providerOption name="OptionInfer" value="true"/>  
+              <providerOption name="WarnAsError" value="false"/>  
+            </compiler>  
+          </compilers>  
+        </system.codedom>  
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/hosting-services.md b/docs/framework/wcf/hosting-services.md
new file mode 100644
index 00000000000..c353104a706
--- /dev/null
+++ b/docs/framework/wcf/hosting-services.md
@@ -0,0 +1,81 @@
+---
+title: "ホスティング サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "ホスティング サービス [WCF]"
+ms.assetid: 192be927-6be2-4fda-98f0-e513c4881acc
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# ホスティング サービス
+アクティブにするには、サービスを作成してそのコンテキストと有効期間を制御するランタイム環境内で、サービスをホストする必要があります。[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスは、マネージ コードをサポートする任意の Windows プロセスで実行されるように設計されています。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、サービス指向アプリケーションを構築するための統一されたプログラミング モデルを提供します。 このプログラミング モデルには一貫性があり、サービスが展開されるランタイム環境に影響されません。 これは実際には、ホスト オプションにかかわらず、サービスのコードがほぼ同じになることを意味しています。  
+  
+ これらのホスト オプションの範囲は、コンソール アプリケーション内部での実行から、Windows サービスのようなサーバー環境、インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) で管理されるワーカー プロセス内での実行までさまざまです。 開発者は、サービスの展開要件を満たすホスト環境を選択します。 このような要件は、アプリケーションを展開するプラットフォーム、メッセージの送受信を行うトランスポート、適切な可用性を保証するために必要なプロセスのリサイクルや管理、その他、管理上または信頼性上の要件から導き出されます。 ホスト オプションの情報とガイドラインについて、次のセクションで説明します。  
+  
+## ホスト オプション  
+  
+#### マネージ アプリケーションにおける自己ホスト  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスはすべてのマネージ アプリケーションでホストされます。 これは、展開に必要なインフラストラクチャが最小限になるため、最も柔軟なオプションです。 マネージ アプリケーション コード内にサービスのコードを埋め込み、続いて <xref:System.ServiceModel.ServiceHost> のインスタンスを作成して開き、サービスを有効にします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : マネージ アプリケーションで WCF サービスをホストする](../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)。  
+  
+ このオプションで可能になる一般的なシナリオには、コンソール アプリケーション内部で実行される [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと、[!INCLUDE[avalon1](../../../includes/avalon1-md.md)] または Windows フォーム \(WinForms\) に基づくリッチ クライアント アプリケーションの 2 つがあります。 コンソール アプリケーション内部の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストすることは、一般的にアプリケーションの開発フェーズで有用です。 コンソール アプリケーションにより、アプリケーション内部で起こっている状況を見極めるための情報のデバッグやトレースが容易になり、新しい場所にアプリケーションをコピーして移動することも簡単に行うことができます。 このホスト オプションを使用すると、[!INCLUDE[avalon2](../../../includes/avalon2-md.md)] や WinForms アプリケーションなど、外部と通信を行うリッチ クライアント アプリケーションの作成も容易になります。 たとえば、ユーザー インターフェイスに [!INCLUDE[avalon2](../../../includes/avalon2-md.md)] を使用しながら、他のクライアントからの接続を許容して情報を共有するために [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストするピア ツー ピア コラボレーションのクライアントなどです。  
+  
+#### マネージ Windows サービス  
+ このホスト オプションは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをマネージ Windows サービス \(従来 NT サービスと呼ばれていたもの\) としてホストするアプリケーション ドメイン \(AppDomain\) の登録から構成されているため、サービスのプロセス有効期間は Windows サービスのサービス コントロール マネージャー \(SCM\) によって制御されます。 自己ホスト オプションと同様、この種類のホスト環境では、ホスト コードをアプリケーションの一部として記述する必要があります。 サービスは、Windows サービスと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの両方として実装します。そのためには、<xref:System.ServiceProcess.ServiceBase> クラスから継承すると同時に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス コントラクト インターフェイスからも継承します。 次に <xref:System.ServiceModel.ServiceHost> を作成し、オーバーライドされた [OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> メソッドで開き、オーバーライドされた <xref:System.ServiceProcess.ServiceBase.OnStop> メソッドで閉じます。 また、<xref:System.Configuration.Install.Installer> から継承されるインストーラー クラスも実装し、プログラムが Installutil.exe ツールによって Windows サービスとしてインストールされるようにする必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : マネージ Windows サービスで WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md)。 マネージ Windows サービスのホスト オプションによって有効になるシナリオは、メッセージがアクティブ化されていない、セキュリティ保護された環境において、IIS の外部でホストされ、長時間実行される [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスです。 サービスの有効期限は代わりにオペレーティング システムによって制御されます。 このホスト オプションは Windows のすべてのバージョンで使用できます。  
+  
+#### インターネット インフォメーション サービス \(IIS\)  
+ IIS ホスト オプションは [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] と統合され、プロセスのリサイクル、アイドル シャットダウン、処理状況の監視、メッセージに基づくアクティベーションなど、このテクノロジによって提供される機能を使用します。[!INCLUDE[wxp](../../../includes/wxp-md.md)] および [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] オペレーティング システムでは、高可用性と高スケーラビリティが求められる Web サービス アプリケーションのホストには、このオプションが適切なソリューションとなります。 IIS では、顧客がエンタープライズ クラスのサーバー製品に求める統合された管理性も提供されます。 このホスト オプションでは、IIS が正しく構成されている必要がありますが、アプリケーションの一部としてホスト コードを書く必要はありません。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス用に IIS ホストを構成する方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : IIS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)」を参照してください。  
+  
+ IIS でホストされるサービスは HTTP トランスポートしか使用できません。 IIS 5.1 の実装では、[!INCLUDE[wxp](../../../includes/wxp-md.md)] にいくつかの制限がありました。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 上で IIS 5.1 によって提供される、[!INCLUDE[wxp](../../../includes/wxp-md.md)] サービス用のメッセージ ベースのアクティベーションでは、同じコンピューター上にあるそれ以外の自己ホスト型 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスによる、ポート 80 を使用した通信が妨げられます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 上で [!INCLUDE[iis601](../../../includes/iis601-md.md)] によってホストした場合は、[!INCLUDE[ws2003](../../../includes/ws2003-md.md)] サービスは他のアプリケーションと同じ AppDomain\/アプリケーション プール\/ワーカー プロセスで実行できます。 ただし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] と [!INCLUDE[iis601](../../../includes/iis601-md.md)] のどちらもカーネル モードの HTTP スタック \(HTTP.sys\) を使用するため、IIS 5.1 とは異なり、[!INCLUDE[iis601](../../../includes/iis601-md.md)] ではポート 80 を同じコンピューター上で実行される他の自己ホスト型 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと共有できます。  
+  
+#### Windows プロセス アクティブ化サービス \(WAS\)  
+ Windows プロセス アクティブ化サービス \(WAS\) とは、[!INCLUDE[lserver](../../../includes/lserver-md.md)] でも使用できる [!INCLUDE[wv](../../../includes/wv-md.md)] 用の新しいプロセス アクティブ化機構です。 よく知られている [!INCLUDE[iis601](../../../includes/iis601-md.md)] のプロセス モデル \(アプリケーション プールとメッセージ ベースのプロセス アクティベーション\) とホスト機能 \(迅速な障害保護、状態の監視、プロセスのリサイクルなど\) はそのままですが、HTTP に対する依存性がアクティベーション アーキテクチャから解消されています。[!INCLUDE[iisver](../../../includes/iisver-md.md)] では、WAS を使用して HTTP 経由でのメッセージ ベースのアクティベーションを実現しています。 ただし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] がサポートする他のプロトコル \(TCP、MSMQ、名前付きパイプなど\) を介してメッセージ ベースのアクティベーションを実現するために、WAS には追加の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コンポーネントもプラグインされています。 これにより、IIS のプロセスのリサイクル、迅速な障害保護、一般的な構成システムなど、これまで HTTP ベースのアプリケーションのみで利用可能だった IIS 機能を、通信プロトコルを使用するアプリケーションでも使用できるようになりました。  
+  
+ このホスト オプションでは、WAS が正しく構成されている必要がありますが、アプリケーションの一部としてホスト コードを書く必要はありません。 WAS ホストを構成する方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : WAS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)」を参照してください。  
+  
+## ホスト環境の選択  
+ 次の表に、各ホスト オプションに関連する主な利点とシナリオの要点をまとめます。  
+  
+|ホスト環境|一般的なシナリオ|主な利点と制限|  
+|-----------|--------------|-------------|  
+|マネージ アプリケーション \("自己ホスト"\)|-   開発時に使用されるコンソール アプリケーション。<br />-   サービスにアクセスするリッチな Winform と [!INCLUDE[avalon2](../../../includes/avalon2-md.md)] クライアント アプリケーション。|-   柔軟性。<br />-   展開の容易さ。<br />-   サービスのエンタープライズ ソリューションではない。|  
+|Windows サービス \(従来 NT サービスと呼ばれていたもの\)|-   IIS 外でホストされ長時間実行される [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス。|-   サービス プロセスの有効期間は、メッセージ ベースのアクティベーションではなくオペレーティング システムにより制御される。<br />-   すべてのバージョンの Windows でサポートされる。<br />-   セキュリティで保護された環境。|  
+|IIS 5.1、[!INCLUDE[iis601](../../../includes/iis601-md.md)]|-   HTTP プロトコルを使い、インターネット上で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] コンテンツと共に同時に実行する。|-   プロセスのリサイクル。<br />-   アイドル シャットダウン。<br />-   処理状況の監視。<br />-   メッセージ ベースのアクティベーション。<br />-   HTTP のみ。|  
+|Windows プロセス アクティブ化サービス \(WAS\)|-   インターネット上で IIS をインストールせずに、さまざまなトランスポート プロトコルを使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを実行する。|-   IIS は不要。<br />-   プロセスのリサイクル。<br />-   アイドル シャットダウン。<br />-   処理状況の監視。<br />-   メッセージ ベースのアクティベーション。<br />-   HTTP、TCP、名前付きパイプ、および MSMQ で動作する。|  
+|IIS 7.0|-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コンテンツと共に [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] サービスを実行する。<br />-   インターネット上で、さまざまなトランスポート プロトコルを使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを実行する。|-   WAS の利点。<br />-   [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] および IIS コンテンツと統合される。|  
+  
+ ホスト環境の選択は、その展開先の Windows のバージョン、メッセージの送信に必要なトランスポート、および必要となるプロセスとアプリケーション ドメインのリサイクルの種類に依存します。 次の表に、これらの要件に関連するデータをまとめます。  
+  
+|ホスト環境|プラットフォームの可用性|サポートされるトランスポート|プロセスと AppDomain のリサイクル|  
+|-----------|------------------|--------------------|----------------------------|  
+|マネージ アプリケーション \("自己ホスト"\)|[!INCLUDE[wxp](../../../includes/wxp-md.md)], [!INCLUDE[ws2003](../../../includes/ws2003-md.md)], [!INCLUDE[wv](../../../includes/wv-md.md)],<br /><br /> [!INCLUDE[lserver](../../../includes/lserver-md.md)]|HTTP、<br /><br /> net.tcp、<br /><br /> net.pipe、<br /><br /> net.msmq|いいえ|  
+|Windows サービス \(従来 NT サービスと呼ばれていたもの\)|[!INCLUDE[wxp](../../../includes/wxp-md.md)], [!INCLUDE[ws2003](../../../includes/ws2003-md.md)], [!INCLUDE[wv](../../../includes/wv-md.md)],<br /><br /> [!INCLUDE[lserver](../../../includes/lserver-md.md)]|HTTP、<br /><br /> net.tcp、<br /><br /> net.pipe、<br /><br /> net.msmq|いいえ|  
+|IIS 5.1|[!INCLUDE[wxp](../../../includes/wxp-md.md)]|HTTP|はい|  
+|[!INCLUDE[iis601](../../../includes/iis601-md.md)]|[!INCLUDE[ws2003](../../../includes/ws2003-md.md)]|HTTP|はい|  
+|Windows プロセス アクティブ化サービス \(WAS\)|[!INCLUDE[wv](../../../includes/wv-md.md)], [!INCLUDE[lserver](../../../includes/lserver-md.md)]|HTTP、<br /><br /> net.tcp、<br /><br /> net.pipe、<br /><br /> net.msmq|はい|  
+  
+ 信頼されていないホストからサービスや拡張機能を実行すると、セキュリティが損なわれるので注意してください。 また、偽装して <xref:System.ServiceModel.ServiceHost> を開くと、アプリケーションは、ユーザーの <xref:System.Security.Principal.WindowsIdentity> をキャッシュするなどして、ユーザーがログオフしていないことを確認する必要があります。  
+  
+## 参照  
+ [システム要件](../../../docs/framework/wcf/wcf-system-requirements.md)   
+ [基本的なプログラミング ライフサイクル](../../../docs/framework/wcf/basic-programming-lifecycle.md)   
+ [サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)   
+ [方法 : IIS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)   
+ [方法 : WAS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-was.md)   
+ [方法 : マネージ Windows サービスで WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-a-managed-windows-service.md)   
+ [方法 : マネージ アプリケーションで WCF サービスをホストする](../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-configure-a-basic-wcf-client.md b/docs/framework/wcf/how-to-configure-a-basic-wcf-client.md
new file mode 100644
index 00000000000..b14e2600673
--- /dev/null
+++ b/docs/framework/wcf/how-to-configure-a-basic-wcf-client.md
@@ -0,0 +1,93 @@
+---
+title: "方法 : 基本的な Windows Communication Foundation クライアントを構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF クライアント [WCF], 構成"
+ms.assetid: d067b86d-afb0-47bf-94f6-45180a3d8d78
+caps.latest.revision: 47
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 47
+---
+# 方法 : 基本的な Windows Communication Foundation クライアントを構成する
+これは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの作成に必要な 6 つのタスクのうち、5 番目のタスクです。  6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ ここでは、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の "サービス参照の追加" 機能、または[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して生成されたクライアント構成ファイルについて説明します。  クライアントを構成するには、クライアントがサービスにアクセスするために使用するエンドポイントを指定します。  エンドポイントには、アドレス、バインディング、およびコントラクトがあり、クライアントを構成する過程でそれぞれを指定する必要があります。  
+  
+### Windows Communication Foundation クライアントを構成するには  
+  
+1.  GettingStartedClient プロジェクトから生成された構成ファイル \(App.config\) を開きます。  生成された構成ファイルを次の例に示します。  [\<system.serviceModel\>](../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)[\<endpoint\> セクション内に](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素があるのがわかります。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+        <startup>   
+          <!-- specifies the version of WCF to use-->  
+            <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5,Profile=Client" />  
+        </startup>  
+        <system.serviceModel>  
+            <bindings>  
+                <!-- Uses wsHttpBinding-->  
+                <wsHttpBinding>  
+                    <binding name="WSHttpBinding_ICalculator" />  
+                </wsHttpBinding>  
+            </bindings>  
+            <client>  
+                <!-- specifies the endpoint to use when calling the service -->  
+                <endpoint address="http://localhost:8000/ServiceModelSamples/Service/CalculatorService"  
+                    binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"  
+                    contract="ServiceReference1.ICalculator" name="WSHttpBinding_ICalculator">  
+                    <identity>  
+                        <userPrincipalName value="migree@redmond.corp.microsoft.com" />  
+                    </identity>  
+                </endpoint>  
+            </client>  
+        </system.serviceModel>  
+    </configuration><?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+        <startup>   
+            <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5,Profile=Client" />  
+        </startup>  
+        <system.serviceModel>  
+            <bindings>  
+                <wsHttpBinding>  
+                    <binding name="WSHttpBinding_ICalculator" />  
+                </wsHttpBinding>  
+            </bindings>  
+            <client>  
+                <endpoint address="http://localhost:8000/ServiceModelSamples/Service/CalculatorService"  
+                    binding="wsHttpBinding" bindingConfiguration="WSHttpBinding_ICalculator"  
+                    contract="ServiceReference1.ICalculator" name="WSHttpBinding_ICalculator">  
+                    <identity>  
+                        <userPrincipalName value="migree@redmond.corp.microsoft.com" />  
+                    </identity>  
+                </endpoint>  
+            </client>  
+        </system.serviceModel>  
+    </configuration>   
+    ```  
+  
+     この例では、アドレス http:\/\/localhost:8000\/ServiceModelSamples\/Service\/CalculatorService に配置されたサービスにアクセスするために、クライアントが使用するエンドポイントを構成しています。  
+  
+     endpoint 要素は、`ServiceReference1.ICalculator` サービス コントラクトが、WCF クライアントと WCF サービス間の通信に使用されるように指定します。  WCF チャネルはシステム標準の <xref:System.ServiceModel.WsHttpBinding> で構成されます。  このコントラクトは、Visual Studio の "サービス参照の追加" を使用して生成されました。  基本的には、GettingStartedLib プロジェクトで定義されているコントラクトのコピーです。  <xref:System.ServiceModel.WsHttpBinding> バインディングは、トランスポートとして HTTP を指定し、相互運用可能なセキュリティ、およびその他の構成詳細を指定します。  
+  
+2.  この構成で生成されたクライアントを使用する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法 : クライアントを使用する](../../../docs/framework/wcf/how-to-use-a-wcf-client.md)」を参照してください。  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-create-a-wcf-client.md b/docs/framework/wcf/how-to-create-a-wcf-client.md
new file mode 100644
index 00000000000..30d4eb1ead6
--- /dev/null
+++ b/docs/framework/wcf/how-to-create-a-wcf-client.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : Windows Communication Foundation クライアントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "クライアント [WCF], 実行"
+  - "WCF クライアント [WCF], 実行"
+ms.assetid: a67884cc-1c4b-416b-8c96-5c954099f19f
+caps.latest.revision: 64
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 64
+---
+# 方法 : Windows Communication Foundation クライアントを作成する
+これは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの作成に必要な 6 つのタスクのうち、4 番目のタスクです。6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスからメタデータを取得し、このメタデータを使用して、サービスにアクセスできる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プロキシを作成する方法について説明します。このタスクは、Visual Studio によって提供される "サービス参照の追加" 機能を使用することで完了できます。このツールは、サービスの MEX エンドポイントからメタデータを取得し、ユーザーが選択した言語 \(既定では C\#\) でクライアント プロキシのマネージ ソース コード ファイルを生成します。このツールでは、クライアント プロキシの作成だけでなく、クライアントの構成ファイルの作成または更新も行います。この構成ファイルにより、クライアント アプリケーションはエンドポイントのいずれかにあるサービスに接続できるようになります。  
+  
+> [!NOTE]
+>  また、Visual Studio 内で "サービス参照の追加" を使用する代わりに、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールを使用して、プロキシ クラスおよび構成を生成することもできます。  
+  
+> [!WARNING]
+>  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] のクラス ライブラリ プロジェクトから [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを呼び出すときは、サービス参照の追加機能を使用して、プロキシおよび関連構成ファイルを自動的に生成できます。この構成ファイルはクラス ライブラリ プロジェクトで使用されません。クラス ライブラリを呼び出す実行可能ファイルの app.config ファイルに、生成された構成ファイル内の設定を追加する必要があります。  
+  
+ クライアント アプリケーションは生成されたプロキシ クラスを使用して、サービスと通信します。この手順については、「[方法 : クライアントを使用する](../../../docs/framework/wcf/how-to-use-a-wcf-client.md)」を参照してください。  
+  
+### Windows Communication Foundation クライアントを作成するには  
+  
+1.  新しいコンソール アプリケーション プロジェクトを作成します。入門ソリューションを右クリックし、**\[追加\]**、**\[新しいプロジェクト\]** の順にクリックします。**\[新しいプロジェクトの追加\]** ダイアログ ボックスの左側で、**\[C\#\]** または **\[VB\]** の **\[Windows\]** をクリックします。ダイアログ ボックスの中央のセクションで、**\[コンソール アプリケーション\]** を選択します。プロジェクトに `GettingStartedClient` という名前を付けます。  
+  
+2.  GettingStartedClient プロジェクトのターゲット フレームワークを .NET Framework 4.5 に設定します。ソリューション エクスプローラーで **\[GettingStartedClient\]** を右クリックし、**\[プロパティ\]** を選択します。**\[ターゲット フレームワーク\]** ボックスの一覧の **\[.NET Framework 4.5\]** をクリックします。VB プロジェクトのターゲット フレームワークを設定する方法は多少異なり、GettingStartedClient プロジェクトの \[プロパティ\] ダイアログ ボックスで、画面左側の **\[コンパイル\]** タブをクリックし、ダイアログ ボックスの左下隅にある **\[詳細コンパイル オプション\]** をクリックします。次に、**\[ターゲット フレームワーク\]** ボックスの一覧の **\[.NET Framework 4.5\]** をクリックします。  
+  
+     ターゲット フレームワークを設定すると、Visual Studio 2011 はソリューションを再読み込みします。ダイアログが表示されたら、**\[OK\]** をクリックします。  
+  
+3.  System.ServiceModel への参照を GettingStartedClient プロジェクトに追加します。ソリューション エクスプローラーで GettingStartedClient プロジェクトの **\[参照\]** フォルダーを右クリックし、**\[参照の追加\]** をクリックします。**\[参照の追加\]** ダイアログ ボックスの左側で、**\[フレームワーク\]** を選択します。\[アセンブリの検索\] ボックスに「`System.ServiceModel`」と入力します。ダイアログ ボックスの中央のセクションで、**\[System.ServiceModel\]** を選択し、**\[追加\]**、**\[閉じる\]** の順にクリックします。メイン メニューの **\[すべて保存\]** をクリックして、ソリューションを保存します。  
+  
+4.  次に、電卓サービスへのサービス参照を追加します。これを実行する前に、GettingStartedHost コンソール アプリケーションを起動する必要があります。ホストが実行中になったら、ソリューション エクスプローラーで GettingStartedClient プロジェクトの \[参照\] フォルダーを右クリックし、\[サービス参照の追加\] をクリックします。\[サービス参照の追加\] ダイアログ ボックスの \[アドレス\] ボックスに URL \(http:\/\/localhost:8000\/ServiceModelSamples\/Service\) を入力し、**\[移動\]** をクリックします。\[CalculatorService\] が \[サービス\] ボックスに表示されたら、\[CalculatorService\] をダブルクリックして、そのサービスによって実装されているサービス コントラクトを展開して表示します。既定の名前空間を変更せずに、**\[OK\]** をクリックします。  
+  
+     Visual Studio を使用してサービスへの参照を追加すると、新しい項目がソリューション エクスプローラーの GettingStartedClient プロジェクトの \[サービス参照\] フォルダーの下に表示されます。[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールを使用した場合、ソース コード ファイルおよび app.config ファイルが生成されます。  
+  
+     コマンド ライン ツールである [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を適切なスイッチと共に使用して、クライアント コードを作成することもできます。次の例では、サービスのコード ファイルと構成ファイルを生成しています。最初の例は VB でプロキシを生成する方法を示し、2 番目の例は C\# でプロキシを生成する方法を示しています。  
+  
+    ```  
+    svcutil.exe /language:vb /out:generatedProxy.vb /config:app.config http://localhost:8000/ServiceModelSamples/service  
+  
+    ```  
+  
+    ```csharp  
+    svcutil.exe /language:cs /out:generatedProxy.cs /config:app.config http://localhost:8000/ServiceModelSamples/service  
+  
+    ```  
+  
+ ここでは、クライアント アプリケーションが電卓サービスを呼び出すために使用するプロキシを作成しました。シリーズの次のトピックに進んでください: [方法 : クライアントを構成する](../../../docs/framework/wcf/how-to-configure-a-basic-wcf-client.md)  
+  
+## 参照  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)   
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)   
+ [方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする](../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-declare-faults-in-service-contracts.md b/docs/framework/wcf/how-to-declare-faults-in-service-contracts.md
new file mode 100644
index 00000000000..e5e5d9c8582
--- /dev/null
+++ b/docs/framework/wcf/how-to-declare-faults-in-service-contracts.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : サービス コントラクトでのエラーを宣言する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8da98e7-d22f-4f60-ac82-3fb0928a353f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 方法 : サービス コントラクトでのエラーを宣言する
+マネージ コードでは、エラー条件が発生すると例外がスローされます。  しかし [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでは、サービス コントラクトで SOAP エラーを宣言することにより、どのエラー情報をクライアントに通知するかを指定するようになっています。  例外とエラーの関係の概要については、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  
+  
+### SOAP エラーを指定するサービス コントラクトを作成する  
+  
+1.  サービス コントラクトを作成し、操作をいくつか定義します。  例については、「[方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)」を参照してください。  
+  
+2.  操作を選択します。これに対して指定したエラー条件が発生したとき、クライアント側に通知することになります。  どのようなエラー条件を SOAP エラーとしてクライアントに通知する必要があるかについては、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  
+  
+3.  選択した操作に対して <xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName> 属性を適用し、シリアル化可能なエラー型をコンストラクターに渡します。  シリアル化可能な型の作成方法および使用方法の詳細については、「[サービス コントラクトでのデータ転送の指定](../../../docs/framework/wcf/feature-details/specifying-data-transfer-in-service-contracts.md)」を参照してください。  `SampleMethod` 操作で `GreetingFault` を返せるように指定する例を次に示します。  
+  
+     [!code-csharp[FaultContractAttribute#4](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/services.cs#4)]
+     [!code-vb[FaultContractAttribute#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/services.vb#4)]  
+  
+4.  コントラクト内でクライアントへの通知が必要な操作すべてについて、手順 2. および 3. を繰り返します。  
+  
+## 指定した SOAP エラーを返す操作の実装  
+ エラー状態を呼び出し元アプリケーションに通知するために、前の手順で指定したような特定の SOAP エラーを操作中に返せるように指定したので、次に実際に通知処理を実装します。  
+  
+#### 指定した SOAP エラーを操作中に例外としてスローする  
+  
+1.  操作中に <xref:System.ServiceModel.FaultContractAttribute> で指定したエラー条件が発生したとき、<xref:System.ServiceModel.FaultException%601?displayProperty=fullName> 例外を生成してスローする、というコードを記述します。SOAP エラーは型パラメーターとして、生成する例外に渡します。  前の手順で示した `SampleMethod` 内で `GreetingFault` 例外をスローするコード例を次に示します。  
+  
+     [!code-csharp[FaultContractAttribute#5](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/services.cs#5)]
+     [!code-vb[FaultContractAttribute#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/services.vb#5)]  
+  
+## 使用例  
+ `SampleMethod` 操作内で `GreetingFault` エラーが発生した場合の処理を実装したコード例を次に示します。  
+  
+ [!code-csharp[FaultContractAttribute#1](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/services.cs#1)]
+ [!code-vb[FaultContractAttribute#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/services.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName>   
+ <xref:System.ServiceModel.FaultException%601?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-define-a-wcf-service-contract.md b/docs/framework/wcf/how-to-define-a-wcf-service-contract.md
new file mode 100644
index 00000000000..0db9acc0692
--- /dev/null
+++ b/docs/framework/wcf/how-to-define-a-wcf-service-contract.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : Windows Communication Foundation サービス コントラクトを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], 定義"
+ms.assetid: 67bf05b7-1d08-4911-83b7-a45d0b036fc3
+caps.latest.revision: 58
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 58
+---
+# 方法 : Windows Communication Foundation サービス コントラクトを定義する
+これは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの作成に必要な 6 つのタスクのうち、1 番目のタスクです。6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを作成する場合、まずサービス コントラクトを定義します。サービス コントラクトは、サービスがサポートする操作を指定します。操作は Web サービス メソッドと見なすことができます。コントラクトは C\+\+、C\#、または Visual Basic \(VB\) インターフェイスを定義することで作成します。インターフェイスの各メソッドは、特定のサービス操作に対応しています。各インターフェイスには <xref:System.ServiceModel.ServiceContractAttribute> が適用されており、各操作には <xref:System.ServiceModel.OperationContractAttribute> 属性が適用されている必要があります。<xref:System.ServiceModel.ServiceContractAttribute> 属性を持つインターフェイス内のメソッドに <xref:System.ServiceModel.OperationContractAttribute> 属性がない場合、そのメソッドはサービスによって公開されません。  
+  
+ 手順の後に、このタスクに使用するコード例を示します。  
+  
+### サービス コントラクトを定義するには  
+  
+1.  **\[スタート\]** メニューで [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を右クリックし、**\[管理者として実行\]** をクリックして、管理者としてプログラムを開きます。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントして **\[プロジェクト\]** をクリックすることにより、WCF サービス ライブラリ プロジェクトを作成します。**\[新しいプロジェクト\]** ダイアログで、左側の **\[Visual C\#\]** \(C\# プロジェクトの場合\) を展開するか、または **\[他の言語\]** を展開し、**\[Visual Basic\]** \(Visual Basic プロジェクトの場合\) を展開します。選択した言語の **\[WCF\]** を選択します。プロジェクト テンプレートの一覧がダイアログの中央部分に表示されます。**\[WCF サービス ライブラリ\]** を選択します。**\[名前\]** ボックスに「`GettingStartedLib`」と入力し、ダイアログの最下部の **\[ソリューション名\]** ボックスに「`GettingStarted`」と入力します。  
+  
+3.  Visual Studio により、IService1.cs \(または IService1.vb\)、Service1.cs \(または Service1.vb\)、App.config の 3 つのファイルを含むプロジェクトが作成されます。IService1 ファイルには、既定のサービス コントラクトが含まれています。Service1 ファイルには、サービス コントラクトの既定の実装が含まれています。App.config ファイルには、Visual Studio WCF サービス ホストに既定のサービスを読み込むために必要な構成が含まれています。WCF サービス ホスト ツールの詳細については、「[WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)」を参照してください。  
+  
+4.  IService1.cs または IService1.vb ファイルを開き、名前空間の宣言を残したまま、名前空間宣言内のコードを削除します。次のコードに示すように、名前空間宣言内に新しいインターフェイス `ICalculator` を定義します。  
+  
+    ```  
+    // IService.cs  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Linq;  
+    using System.Runtime.Serialization;  
+    using System.ServiceModel;  
+    using System.Text;  
+  
+    namespace GettingStartedLib  
+    {  
+            [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+            public interface ICalculator  
+            {  
+                [OperationContract]  
+                double Add(double n1, double n2);  
+                [OperationContract]  
+                double Subtract(double n1, double n2);  
+                [OperationContract]  
+                double Multiply(double n1, double n2);  
+                [OperationContract]  
+                double Divide(double n1, double n2);  
+            }  
+    }  
+  
+    ```  
+  
+    ```  
+    ‘IService.vb  
+    Imports System  
+    Imports System.ServiceModel  
+  
+    Namespace GettingStartedLib  
+  
+        <ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _  
+        Public Interface ICalculator  
+  
+            <OperationContract()> _  
+            Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double  
+            <OperationContract()> _  
+            Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double  
+            <OperationContract()> _  
+            Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double  
+            <OperationContract()> _  
+            Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        End Interface  
+    End Namespace  
+  
+    ```  
+  
+     このコントラクトは、オンライン電卓を定義します。`ICalculator` インターフェイスは <xref:System.ServiceModel.ServiceContractAttribute> 属性でマークされています。この属性は、コントラクト名を区別するために使用される名前空間を定義します。各電卓操作は <xref:System.ServiceModel.OperationContractAttribute> 属性でマークされています。  
+  
+    > [!NOTE]
+    >  属性を使用してインターフェイス、メンバー、またはクラスに注釈を付けるときは、属性名から "Attribute" 部分を削除できます。したがって、<xref:System.ServiceModel.ServiceContractAttribute> は、C\# では `[ServiceContract]`、Visual Basic では `<ServiceContract>` になります。  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ [方法 : サービス コントラクトを実装する](../../../docs/framework/wcf/how-to-implement-a-wcf-contract.md)   
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-examine-the-security-context.md b/docs/framework/wcf/how-to-examine-the-security-context.md
new file mode 100644
index 00000000000..5a52ffb3454
--- /dev/null
+++ b/docs/framework/wcf/how-to-examine-the-security-context.md
@@ -0,0 +1,63 @@
+---
+title: "方法 : セキュリティ コンテキストを調べる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Claimset クラス"
+  - "ServiceSecurityContext クラス"
+  - "WCF, セキュリティ"
+ms.assetid: 389b5a57-4175-4bc0-ada0-fc750d51149f
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# 方法 : セキュリティ コンテキストを調べる
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスのプログラミングを行う場合、サービス セキュリティ コンテキストを使用すると、サービスの認証で使用されるクライアントの資格情報とクレームの詳細を確認できます。これは、<xref:System.ServiceModel.ServiceSecurityContext> クラスのプロパティを使用することで可能になります。  
+  
+ たとえば、<xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> プロパティまたは <xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> プロパティを使用すると、現在のクライアントの ID を取得できます。クライアントが匿名であるかどうかを確認するには、<xref:System.ServiceModel.ServiceSecurityContext.IsAnonymous%2A> プロパティを使用します。  
+  
+ また、<xref:System.ServiceModel.ServiceSecurityContext.AuthorizationContext%2A> プロパティにあるクレームのコレクションを反復処理することによって、クライアントのためにどのようなクレームが作成されているのかを確認することもできます。  
+  
+### 現在のセキュリティ コンテキストを取得するには  
+  
+-   現在のセキュリティ コンテキストを取得するためには、静的プロパティ <xref:System.ServiceModel.ServiceSecurityContext.Current%2A> にアクセスします。参照から現在のコンテキストの任意のプロパティを調べます。  
+  
+### 呼び出し元の ID を確認するには  
+  
+1.  <xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> プロパティおよび <xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> プロパティの値を表示します。  
+  
+### 呼び出し元のクレームを解析するには  
+  
+1.  現在の <xref:System.IdentityModel.Policy.AuthorizationContext> クラスを返します。<xref:System.ServiceModel.ServiceSecurityContext.Current%2A> プロパティを使用して、現在のサービス セキュリティ コンテキストを返し、次に <xref:System.ServiceModel.ServiceSecurityContext.AuthorizationContext%2A> プロパティを使用して `AuthorizationContext` を返します。  
+  
+2.  <xref:System.IdentityModel.Policy.AuthorizationContext> クラスの <xref:System.IdentityModel.Policy.AuthorizationContext.ClaimSets%2A> プロパティによって返された <xref:System.IdentityModel.Claims.ClaimSet> オブジェクトのコレクションを解析します。  
+  
+## 使用例  
+ 次の例では、現在のセキュリティ コンテキストの <xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> プロパティおよび <xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> プロパティの値、<xref:System.IdentityModel.Claims.Claim.ClaimType%2A> プロパティの値、クレームのリソース値、および現在のセキュリティ コンテキストのすべてのクレームの <xref:System.IdentityModel.Claims.Claim.Right%2A> プロパティを表示します。  
+  
+ [!code-csharp[c_PrincipalPermissionAttribute#4](../../../samples/snippets/csharp/VS_Snippets_CFX/c_principalpermissionattribute/cs/source.cs#4)]
+ [!code-vb[c_PrincipalPermissionAttribute#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_principalpermissionattribute/vb/source.vb#4)]  
+  
+## コードのコンパイル  
+ コードでは、次の名前空間を使用します。  
+  
+-   <xref:System>  
+  
+-   <xref:System.ServiceModel>  
+  
+-   <xref:System.IdentityModel.Policy>  
+  
+-   <xref:System.IdentityModel.Claims>  
+  
+## 参照  
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)   
+ [サービス ID と認証](../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md b/docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md
new file mode 100644
index 00000000000..0ce675b3201
--- /dev/null
+++ b/docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md
@@ -0,0 +1,109 @@
+---
+title: "方法 : マネージ アプリケーションで WCF サービスをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 5eb29db0-b6dc-4e77-8c68-0a62f79d743b
+caps.latest.revision: 42
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 42
+---
+# 方法 : マネージ アプリケーションで WCF サービスをホストする
+マネージ アプリケーションでサービスをホストするには、マネージ アプリケーション コード内にサービスのコードを埋め込み、サービスのエンドポイントをコードで強制的に定義するか、構成を使用して宣言により定義してから、または既定のエンドポイントを使用して、<xref:System.ServiceModel.ServiceHost> のインスタンスを作成します。  
+  
+ メッセージの受信を開始するには、<xref:System.ServiceModel.ServiceHost> で <xref:System.ServiceModel.ICommunicationObject.Open%2A> を呼び出します。これにより、サービスのリスナーが作成されて開きます。この方法によるサービスのホストは、マネージ アプリケーション自体がホスト作業を行うため、"自己ホスト" と呼ばれることがあります。サービスを閉じるには、<xref:System.ServiceModel.ServiceHost> で <xref:System.ServiceModel.Channels.CommunicationObject.Close%2A?displayProperty=fullName> を呼び出します。  
+  
+ サービスは、マネージ Windows サービス、インターネット インフォメーション サービス \(IIS\)、または Windows プロセス アクティブ化サービス \(WAS\) でホストすることもできます。サービスのホスティング[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+ マネージ アプリケーションでのサービスのホストは、展開するインフラストラクチャが最小限で済むため、最も柔軟性があります。マネージ アプリケーションでのホスティング サービス[!INCLUDE[crabout](../../../includes/crabout-md.md)]、[マネージ アプリケーションのホスト](../../../docs/framework/wcf/feature-details/hosting-in-a-managed-application.md)」を参照してください。  
+  
+ 次の手順では、自己ホスト型サービスをコンソール アプリケーションに実装する方法を示します。  
+  
+### 自己ホスト型サービスを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を開き、**\[ファイル\]** メニューの **\[新規作成\]**、**\[プロジェクト\]** の順にクリックします。  
+  
+2.  **\[インストールされているテンプレート\]** ボックスで **\[Visual C\#\]**、**\[Windows\]** または **\[Visual Basic\]**、**\[Windows\]** を選択します。[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の設定に応じて、選択した内容の 1 つまたは両方が **\[インストールされているテンプレート\]** ボックスの **\[他の言語\]** ノードに表示されます。  
+  
+3.  **\[Windows\]**  ボックスから **\[コンソール アプリケーション\]** を選択します。**\[名前\]** ボックスに「`SelfHost`」と入力して **\[OK\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **\[SelfHost\]** を右クリックし、**\[参照の追加\]** をクリックします。**\[.NET\]** タブの **\[System.ServiceModel\]** をクリックし、**\[OK\]** をクリックします。  
+  
+    > [!TIP]
+    >  **ソリューション エクスプローラー** ウィンドウが表示されない場合は、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+5.  まだ開いていない場合は、**ソリューション エクスプローラー**で **\[Program.cs\]** または **\[Module1.vb\]** をダブルクリックして、コード ウィンドウで開きます。ファイルの先頭に次のステートメントを追加します。  
+  
+     [!code-csharp[CFX_SelfHost4#1](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_selfhost4/cs/program.cs#1)]
+     [!code-vb[CFX_SelfHost4#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_selfhost4/vb/module1.vb#1)]  
+  
+6.  サービス コントラクトを定義して実装します。この例では、サービスへの入力に基づいてメッセージを返す `HelloWorldService` を定義します。  
+  
+     [!code-csharp[CFX_SelfHost4#2](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_selfhost4/cs/program.cs#2)]
+     [!code-vb[CFX_SelfHost4#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_selfhost4/vb/module1.vb#2)]  
+  
+    > [!NOTE]
+    >  サービス インターフェイスを定義および実装する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)」および「[方法 : サービス コントラクトを実装する](../../../docs/framework/wcf/how-to-implement-a-wcf-contract.md)」を参照してください。  
+  
+7.  `Main` メソッドの上部で、サービスのベース アドレスで <xref:System.Uri> クラスのインスタンスを作成します。  
+  
+     [!code-csharp[CFX_SelfHost4#3](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_selfhost4/cs/program.cs#3)]
+     [!code-vb[CFX_SelfHost4#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_selfhost4/vb/module1.vb#3)]  
+  
+8.  <xref:System.ServiceModel.ServiceHost> クラスのインスタンスを作成して、サービス型を表す <xref:System.Type> とベース アドレス URI \(Uniform Resource Identifier\) を [ServiceHost\(Type, Uri\<xref:System.ServiceModel.ServiceHost.%23ctor%28System.Type%2CSystem.Uri%5B%5D%29> に渡します。メタデータ公開を有効にして、<xref:System.ServiceModel.ServiceHost> で <xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出し、サービスを初期化してメッセージを受信する準備をします。  
+  
+     [!code-csharp[CFX_SelfHost4#4](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_selfhost4/cs/program.cs#4)]
+     [!code-vb[CFX_SelfHost4#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_selfhost4/vb/module1.vb#4)]  
+  
+    > [!NOTE]
+    >  この例では、既定のエンドポイントを使用するので、このサービスには構成ファイルは必要ありません。エンドポイントが構成されていない場合、ランタイムは、サービスによって実装されたサービス コントラクトごとに 1 つのエンドポイントを各ベース アドレスに作成します。既定のエンドポイント[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+9. Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+### サービスをテストするには  
+  
+1.  Ctrl キーを押しながら F5 キーを押してサービスを実行します。  
+  
+2.  **\[WCF のテスト用クライアント\]** を開きます。  
+  
+    > [!TIP]
+    >  **\[WCF のテスト用クライアント\]** を開くには、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] コマンド プロンプトを開いて、**WcfTestClient.exe** を実行します。  
+  
+3.  **\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。  
+  
+4.  アドレス ボックスに「`http://localhost:8080/hello`」と入力し、**\[OK\]** をクリックします。  
+  
+    > [!TIP]
+    >  サービスが実行していることを確認してください。サービスが実行していない場合、この手順は失敗します。コードでベース アドレスを変更した場合は、この手順で、変更したアドレスを使用します。  
+  
+5.  **\[マイ サービス プロジェクト\]** ノードの **\[SayHello\]** をダブルクリックします。自分の名前を **\[要求\]** ボックスの **\[値\]** 列に入力して、**\[起動\]** をクリックします。応答メッセージが **\[応答\]** ボックスに表示されます。  
+  
+## 使用例  
+ `HelloWorldService` 型のサービスをホストする <xref:System.ServiceModel.ServiceHost> オブジェクトを作成し、<xref:System.ServiceModel.ServiceHost> で <xref:System.ServiceModel.ICommunicationObject.Open%2A> メソッドを呼び出す例を、次に示します。ベース アドレスがコードで指定され、メタデータ公開が有効化されていて、既定のエンドポイントが使用されています。  
+  
+ [!code-csharp[CFX_SelfHost4#5](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_selfhost4/cs/program.cs#5)]
+ [!code-vb[CFX_SelfHost4#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_selfhost4/vb/module1.vb#5)]  
+  
+## 参照  
+ <xref:System.Uri>   
+ <xref:System.Configuration.ConfigurationManager.AppSettings%2A>   
+ <xref:System.Configuration.ConfigurationManager>   
+ [方法 : IIS で WCF サービスをホストする](../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)   
+ [ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)   
+ [方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)   
+ [方法 : サービス コントラクトを実装する](../../../docs/framework/wcf/how-to-implement-a-wcf-contract.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-host-and-run-a-basic-wcf-service.md b/docs/framework/wcf/how-to-host-and-run-a-basic-wcf-service.md
new file mode 100644
index 00000000000..f180b43ceb1
--- /dev/null
+++ b/docs/framework/wcf/how-to-host-and-run-a-basic-wcf-service.md
@@ -0,0 +1,440 @@
+---
+title: "方法 : 基本的な Windows Communication Foundation サービスをホストおよび実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF サービス [WCF]"
+  - "WCF サービス [WCF], 実行"
+ms.assetid: 31774d36-923b-4e2d-812e-aa190127266f
+caps.latest.revision: 58
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 58
+---
+# 方法 : 基本的な Windows Communication Foundation サービスをホストおよび実行する
+これは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの作成に必要な 6 つのタスクのうち、3 番目のタスクです。6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ このトピックでは、コンソール アプリケーションで [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスをホストする方法について説明します。この操作は、次の手順から構成されます。  
+  
+-   コンソール アプリケーション プロジェクトを作成し、サービスをホストします。  
+  
+-   サービスのサービス ホストを作成します。  
+  
+-   メタデータ交換を有効にします。  
+  
+-   サービス ホストを開きます。  
+  
+ このタスクで書かれるコードの全容は手順に続いて提供されている例で見ることができます。  
+  
+### 新しいコンソール アプリケーションを作成し、サービスをホストするには  
+  
+1.  新しいコンソール アプリケーション プロジェクトを作成します。入門ソリューションを右クリックし、**\[追加\]**、**\[新しいプロジェクト\]** の順にクリックします。**\[新しいプロジェクトの追加\]** ダイアログ ボックスの左側で、**\[C\#\]** または **\[VB\]** の **\[Windows\]** をクリックします。ダイアログ ボックスの中央のセクションで、**\[コンソール アプリケーション\]** を選択します。プロジェクトに GettingStartedHost という名前を付けます。  
+  
+2.  GettingStartedHost プロジェクトのターゲット フレームワークを .NET Framework 4.5 に設定します。ソリューション エクスプローラーで **\[GettingStartedHost\]** を右クリックし、**\[プロパティ\]** を選択します。**\[ターゲット フレームワーク\]** ボックスの一覧の **\[.NET Framework 4.5\]** をクリックします。VB プロジェクトのターゲット フレームワークを設定する方法は多少異なり、GettingStartedHost プロジェクトの \[プロパティ\] ダイアログ ボックスで、画面左側の **\[コンパイル\]** タブをクリックし、ダイアログ ボックスの左下隅にある **\[詳細コンパイル オプション\]** をクリックします。次に、**\[ターゲット フレームワーク\]** ボックスの一覧の **\[.NET Framework 4.5\]** をクリックします。  
+  
+     ターゲット フレームワークを設定すると、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] はソリューションを再読み込みします。ダイアログが表示されたら、**\[OK\]** をクリックします。  
+  
+3.  GettingStartedLib プロジェクトへの参照を GettingStartedHost プロジェクトに追加します。ソリューション エクスプローラーで GettingStartedHost プロジェクトの **\[参照\]** フォルダーを右クリックし、**\[参照の追加\]** をクリックします。**\[参照の追加\]** ダイアログで、ダイアログの左側の **\[ソリューション\]** を選択します。ダイアログの中央セクションで \[GettingStartedLib\] を選択し、**\[追加\]** をクリックします。これにより、GettingStartedLib に定義されている型を GettingStartedHost プロジェクトで利用できるようになります。  
+  
+4.  System.ServiceModel への参照を GettingStartedHost プロジェクトに追加します。ソリューション エクスプローラーで GettingStartedHost プロジェクトの **\[参照\]** フォルダーを右クリックし、**\[参照の追加\]** をクリックします。**\[参照の追加\]** ダイアログ ボックスの左側で、**\[フレームワーク\]** を選択します。\[アセンブリの検索\] ボックスに「`System.ServiceModel`」と入力します。ダイアログ ボックスの中央のセクションで、**\[System.ServiceModel\]** を選択し、**\[追加\]**、**\[閉じる\]** の順にクリックします。メイン メニューの \[すべて保存\] をクリックして、ソリューションを保存します。  
+  
+### サービスをホストするには  
+  
+-   Program.cs ファイルまたは Module.vb ファイルを開き、次のコードを追加します。  
+  
+    ```  
+    // program.cs  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Linq;  
+    using System.Text;  
+    using System.ServiceModel;  
+    using GettingStartedLib;  
+    using System.ServiceModel.Description;   
+  
+    namespace GettingStartedHost  
+    {  
+        class Program  
+        {  
+            static void Main(string[] args)  
+            {  
+                // Step 1 Create a URI to serve as the base address.  
+                Uri baseAddress = new Uri("http://localhost:8000/GettingStarted/");  
+  
+                // Step 2 Create a ServiceHost instance  
+                ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);  
+  
+                try  
+                {  
+                    // Step 3 Add a service endpoint.  
+                    selfHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), "CalculatorService");  
+  
+                    // Step 4 Enable metadata exchange.  
+                    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();  
+                    smb.HttpGetEnabled = true;  
+                    selfHost.Description.Behaviors.Add(smb);  
+  
+                    // Step 5 Start the service.  
+                    selfHost.Open();  
+                    Console.WriteLine("The service is ready.");  
+                    Console.WriteLine("Press <ENTER> to terminate service.");  
+                    Console.WriteLine();  
+                    Console.ReadLine();  
+  
+                    // Close the ServiceHostBase to shutdown the service.  
+                    selfHost.Close();  
+                }  
+                catch (CommunicationException ce)  
+                {  
+                    Console.WriteLine("An exception occurred: {0}", ce.Message);  
+                    selfHost.Abort();  
+                }  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+    ```  
+    ‘Module1.vb  
+    Imports System  
+    Imports System.ServiceModel  
+    Imports System.ServiceModel.Description  
+    Imports GettingStartedLibVB.GettingStartedLib  
+  
+    Module Service  
+  
+        Class Program  
+            Shared Sub Main()  
+                ' Step 1 Create a URI to serve as the base address  
+                Dim baseAddress As New Uri("http://localhost:8000/ServiceModelSamples/Service")  
+  
+                ' Step 2 Create a ServiceHost instance  
+                Dim selfHost As New ServiceHost(GetType(CalculatorService), baseAddress)  
+                Try  
+  
+                    ' Step 3 Add a service endpoint  
+                    ' Add a service endpoint  
+                    selfHost.AddServiceEndpoint( _  
+                        GetType(ICalculator), _  
+                        New WSHttpBinding(), _  
+                        "CalculatorService")  
+  
+                    ' Step 4 Enable metadata exchange.  
+                    Dim smb As New ServiceMetadataBehavior()  
+                    smb.HttpGetEnabled = True  
+                    selfHost.Description.Behaviors.Add(smb)  
+  
+                    ' Step 5 Start the service  
+                    selfHost.Open()  
+                    Console.WriteLine("The service is ready.")  
+                    Console.WriteLine("Press <ENTER> to terminate service.")  
+                    Console.WriteLine()  
+                    Console.ReadLine()  
+  
+                    ' Close the ServiceHostBase to shutdown the service.  
+                    selfHost.Close()  
+                Catch ce As CommunicationException  
+                    Console.WriteLine("An exception occurred: {0}", ce.Message)  
+                    selfHost.Abort()  
+                End Try  
+            End Sub  
+        End Class  
+  
+    End Module  
+  
+    ```  
+  
+    1.  手順 1 \- サービスのベース アドレスを保持する Uri クラスのインスタンスを作成します。サービスは、ベース アドレスとオプションの URI を含む URL によって識別されます。ベース アドレスの書式は、\[トランスポート\]:\/\/\[コンピューター名またはドメイン\]\[:省略可能なポート \#\]\/\[省略可能な URI セグメント\] です。電卓サービスのベース アドレスは、電卓サービスのベース アドレスを使用して HTTP トランスポート、localhost、ポート 8000、および URI セグメント "GettingStarted" を使用します。  
+  
+    2.  手順 2 \- サービスをホストする <xref:System.ServiceModel.ServicHost> クラスのインスタンスを作成します。コンストラクターは、サービス コントラクトを実装するクラスの型と、サービスのベース アドレスの、2 つのパラメーターを受け取ります。  
+  
+    3.  手順 3 \- <xref:System.ServiceModel.ServiceEndpoint> インスタンスを作成します。サービス エンドポイントは、アドレス、バインディング、およびサービス コントラクトから構成されます。<xref:System.ServiceModel.ServiceEndpoint> コンストラクターは、サービス コントラクト インターフェイスの型、バインディング、およびアドレスを受け取ります。サービス コントラクトは、サービス型に定義および実装した `ICalculator` です。このサンプルで使用するバインディングは、WS\-\* 仕様に準拠するエンドポイントへの接続に使用される組み込みのバインディングである <xref:System.ServiceModel.WSHttpBinding> です。WCF バインディングの詳細については、「[WCF のバインディングの概要](../../../docs/framework/wcf/bindings-overview.md)」を参照してください。エンドポイントを識別するために、ベース アドレスにアドレスが追加されます。このコードで指定されるアドレスは、"Calculator" です。したがって、エンドポイントの完全修飾アドレスは `“http://localhost:8000/GettingStartedService/Calculator”` です。  
+  
+        > [!IMPORTANT]
+        >  サービス エンドポイントの追加は、.NET Framework 4 以降を使用する場合は省略可能です。これらのバージョンでは、エンドポイントがコードまたは構成で指定されていない場合、WCF は、サービスで実装されたベース アドレスとコントラクトの組み合わせごとに、1 つの既定のエンドポイントを追加します。既定のエンドポイントの詳細については、「[エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md)」を参照してください。既定のエンドポイント、バインディング、および動作[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+    4.  手順 4 \- メタデータ交換を有効にします。クライアントは、サービス操作を呼び出すために使用されるプロキシの生成にメタデータ交換を使用します。メタデータ交換を有効化するには、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> インスタンスを作成し、その <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A> プロパティを `true` に設定します。さらに、動作を <xref:System.ServiceModel.ServiceHost> インスタンスの <xref:System.ServiceModel.ServiceHost.Behaviors%2A> コレクションに追加します。  
+  
+    5.  手順 5 \- 受信メッセージをリッスンするために <xref:System.ServiceModel.ServiceHost> を開きます。コードでは、ユーザーによる Enter キーの押下を待機しています。この動作を行わない場合、アプリは直ちに終了し、サービスはシャットダウンします。また、try\/catch ブロックが使用されている点にも注意してください。<xref:System.ServiceModel.ServiceHost> がインスタンス化された後、他のコードはすべて try\/catch ブロックに配置されます。<xref:System.ServiceModel.ServiceHost> によってスローされた例外を安全にキャッチする方法の詳細については、「[Using ステートメントに関する問題の回避](../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)」を参照してください。  
+  
+### サービスが正常に機能していることを確認するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] 内から GettingStartedHost コンソール アプリケーションを実行します。[!INCLUDE[wv](../../../includes/wv-md.md)] 以降のオペレーティング システムでは、サービスを管理者権限で実行する必要があります。[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] は管理者権限で実行されているため、GettingStartedHost も管理者権限で実行される必要があります。新しいコマンド プロンプトを管理者権限で開いて、service.exe をその中で実行することもできます。  
+  
+2.  Internet Explorer を開き、サービスのデバッグ ページ \(`http://localhost:8000/GettingStarted/CalculatorService`\) に移動します。  
+  
+## 使用例  
+ 次の例では、チュートリアルの前の手順で作成したサービス コントラクトと実装を含め、コンソール アプリケーションでサービスをホストします。  
+  
+ コマンド ライン コンパイラでこれをコンパイルするには、`System.ServiceModel.dll` を参照するクラス ライブラリに IService1.cs と Service2.cs をコンパイルします。さらに、Program.cs をコンソール アプリケーションにコンパイルします。  
+  
+```  
+// IService1.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.Text;  
+  
+namespace GettingStartedLib  
+{  
+        [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+        public interface ICalculator  
+        {  
+            [OperationContract]  
+            double Add(double n1, double n2);  
+            [OperationContract]  
+            double Subtract(double n1, double n2);  
+            [OperationContract]  
+            double Multiply(double n1, double n2);  
+            [OperationContract]  
+            double Divide(double n1, double n2);  
+        }  
+}  
+  
+```  
+  
+```  
+// Service1.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.Text;  
+  
+namespace GettingStartedLib  
+{  
+    public class CalculatorService : ICalculator  
+    {  
+        public double Add(double n1, double n2)  
+        {  
+            double result = n1 + n2;  
+            Console.WriteLine("Received Add({0},{1})", n1, n2);  
+            // Code added to write output to the console window.  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Subtract(double n1, double n2)  
+        {  
+            double result = n1 - n2;  
+            Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Multiply(double n1, double n2)  
+        {  
+            double result = n1 * n2;  
+            Console.WriteLine("Received Multiply({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Divide(double n1, double n2)  
+        {  
+            double result = n1 / n2;  
+            Console.WriteLine("Received Divide({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+//Program.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.ServiceModel;  
+using GettingStartedLib;  
+using System.ServiceModel.Description;   
+  
+namespace GettingStartedHost  
+{  
+    class Program  
+    {  
+        static void Main(string[] args)  
+        {  
+            // Step 1 of the address configuration procedure: Create a URI to serve as the base address.  
+            Uri baseAddress = new Uri("http://localhost:8000/ServiceModelSamples/Service");  
+  
+            // Step 2 of the hosting procedure: Create ServiceHost  
+            ServiceHost selfHost = new ServiceHost(typeof(CalculatorService), baseAddress);  
+  
+            try  
+            {  
+                // Step 3 of the hosting procedure: Add a service endpoint.  
+                selfHost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(), "CalculatorService");  
+  
+                // Step 4 of the hosting procedure: Enable metadata exchange.  
+                ServiceMetadataBehavior smb = new ServiceMetadataBehavior();  
+                smb.HttpGetEnabled = true;  
+                selfHost.Description.Behaviors.Add(smb);  
+  
+                // Step 5 of the hosting procedure: Start (and then stop) the service.  
+                selfHost.Open();  
+                Console.WriteLine("The service is ready.");  
+                Console.WriteLine("Press <ENTER> to terminate service.");  
+                Console.WriteLine();  
+                Console.ReadLine();  
+  
+                // Close the ServiceHostBase to shutdown the service.  
+                selfHost.Close();  
+            }  
+            catch (CommunicationException ce)  
+            {  
+                Console.WriteLine("An exception occurred: {0}", ce.Message);  
+                selfHost.Abort();  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+‘IService1.vb  
+Imports System  
+Imports System.ServiceModel  
+  
+Namespace GettingStartedLib  
+  
+    <ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _  
+    Public Interface ICalculator  
+  
+        <OperationContract()> _  
+        Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double  
+    End Interface  
+End Namespace  
+  
+```  
+  
+```  
+‘Service1.vb  
+Imports System  
+Imports System.ServiceModel  
+  
+Namespace GettingStartedLib  
+  
+    Public Class CalculatorService  
+        Implements ICalculator  
+  
+        Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add  
+            Dim result As Double = n1 + n2  
+            ' Code added to write output to the console window.  
+            Console.WriteLine("Received Add({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+        End Function  
+  
+        Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract  
+            Dim result As Double = n1 - n2  
+            Console.WriteLine("Received Subtract({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+  
+        Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply  
+            Dim result As Double = n1 * n2  
+            Console.WriteLine("Received Multiply({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+  
+        Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide  
+            Dim result As Double = n1 / n2  
+            Console.WriteLine("Received Divide({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+    End Class  
+End Namespace  
+  
+```  
+  
+```  
+‘Module1.vb  
+Imports System  
+Imports System.ServiceModel  
+Imports System.ServiceModel.Description  
+Imports GettingStartedLibVB.GettingStartedLib  
+  
+Module Service  
+  
+    Class Program  
+        Shared Sub Main()  
+            ' Step 1 of the address configuration procedure: Create a URI to serve as the base address.  
+            Dim baseAddress As New Uri("http://localhost:8000/ServiceModelSamples/Service")  
+  
+            ' Step 2 of the hosting procedure: Create ServiceHost  
+            Dim selfHost As New ServiceHost(GetType(CalculatorService), baseAddress)  
+            Try  
+  
+                ' Step 3 of the hosting procedure: Add a service endpoint.  
+                ' Add a service endpoint  
+                selfHost.AddServiceEndpoint( _  
+                    GetType(ICalculator), _  
+                    New WSHttpBinding(), _  
+                    "CalculatorService")  
+  
+                ' Step 4 of the hosting procedure: Enable metadata exchange.  
+                ' Enable metadata exchange  
+                Dim smb As New ServiceMetadataBehavior()  
+                smb.HttpGetEnabled = True  
+                selfHost.Description.Behaviors.Add(smb)  
+  
+                ' Step 5 of the hosting procedure: Start (and then stop) the service.  
+                selfHost.Open()  
+                Console.WriteLine("The service is ready.")  
+                Console.WriteLine("Press <ENTER> to terminate service.")  
+                Console.WriteLine()  
+                Console.ReadLine()  
+  
+                ' Close the ServiceHostBase to shutdown the service.  
+                selfHost.Close()  
+            Catch ce As CommunicationException  
+                Console.WriteLine("An exception occurred: {0}", ce.Message)  
+                selfHost.Abort()  
+            End Try  
+        End Sub  
+    End Class  
+  
+End Module  
+  
+```  
+  
+> [!NOTE]
+>  このようなサービスには、リッスンを行うコンピューター上で HTTP アドレスを登録するためのアクセス許可が必要です。管理者アカウントにはこのアクセス許可がありますが、管理者以外のアカウントの場合は、HTTP 名前空間へのアクセス許可を付与する必要があります。名前空間予約の構成方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[HTTP および HTTPS の構成](../../../docs/framework/wcf/feature-details/configuring-http-and-https.md)」を参照してください。[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] での service.exe の実行には、管理者権限が必要です。  
+  
+ これでサービスが実行されていることが確認できました。「[方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)」に進んでください。トラブルシューティングの詳細については、「[チュートリアル入門のトラブルシューティング](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md)」を参照してください。  
+  
+## 参照  
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md b/docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md
new file mode 100644
index 00000000000..1c9e7f6c189
--- /dev/null
+++ b/docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : サービスでクライアントに偽装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, 偽装"
+  - "偽装"
+  - "WCF, セキュリティ"
+ms.assetid: 431db851-a75b-4009-9fe2-247243d810d3
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# 方法 : サービスでクライアントに偽装する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスでクライアントを偽装すると、サービスはクライアントの代理としてアクションを実行できます。 コンピューター上のディレクトリやファイルへのアクセス、または SQL Server データベースへのアクセスなど、アクセス制御リスト \(ACL\) のチェックを受けるアクションでは、ACL のチェックがクライアントのユーザー アカウントに対して行われます。 ここでは、Windows ドメインのクライアントで、クライアント偽装レベルを設定できるようにするために必要な基本的な手順について説明します。 このパターンの実施例については、「[クライアントの偽装](../../../docs/framework/wcf/samples/impersonating-the-client.md)」を参照してください。 クライアントの偽装の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[委任と偽装](../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+> [!NOTE]
+>  クライアントとサービスが同じコンピューター上で実行されており、クライアントがシステム アカウント \(`Local System` や `Network Service` など\) で実行されているときに、ステートレスなセキュリティ コンテキスト トークンを使用してセキュリティで保護されたセッションを確立した場合、クライアントを偽装することはできません。 通常、WinForms アプリケーションやコンソール アプリケーションは、現在ログインしているアカウントで実行されるため、既定でそのアカウントを偽装できます。 ただし、クライアントが [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] ページであり、そのページが [!INCLUDE[iis601](../../../includes/iis601-md.md)] または IIS 7.0 でホストされている場合、既定では、クライアントは `Network Service` アカウントで実行されます。 セキュリティで保護されたセッションをサポートするシステム提供のすべてのバインディングは、ステートフルなセキュリティ コンテキスト トークンを既定で使用します。 ただし、クライアントが [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] ページであり、ステートフルなセキュリティ コンテキスト トークンを使用する、セキュリティで保護されたセッションを使用している場合は、クライアントを偽装できません。 セキュリティで保護されたセッションでのステートフルなセキュリティ コンテキスト トークンの使用方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]のについては、「[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。  
+  
+### サービスにキャッシュされた Windows トークンでクライアントの偽装を有効にするには  
+  
+1.  サービスを作成します。 この基本的な手順のチュートリアルについては、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+2.  Windows 認証を使用してセッションを作成するバインディング \(<xref:System.ServiceModel.NetTcpBinding> や <xref:System.ServiceModel.WSHttpBinding> など\) を使用します。  
+  
+3.  サービスのインターフェイスの実装を作成するときには、クライアントの偽装を必要とするメソッドに <xref:System.ServiceModel.OperationBehaviorAttribute> クラスを適用します。<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A> プロパティを <xref:System.ServiceModel.ImpersonationOption> に設定します。  
+  
+     [!code-csharp[c_SimpleImpersonation#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_simpleimpersonation/cs/source.cs#2)]
+     [!code-vb[c_SimpleImpersonation#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_simpleimpersonation/vb/source.vb#2)]  
+  
+### クライアントに許可される偽装レベルを設定するには  
+  
+1.  [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して、サービス クライアント コードを作成します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)。  
+  
+2.  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントの作成後、<xref:System.ServiceModel.Security.WindowsClientCredential.AllowedImpersonationLevel%2A> クラスの <xref:System.ServiceModel.Security.WindowsClientCredential> プロパティを <xref:System.Security.Principal.TokenImpersonationLevel> 列挙値の 1 つに設定します。  
+  
+    > [!NOTE]
+    >  <xref:System.Security.Principal.TokenImpersonationLevel> を使用するには、ネゴシエート Kerberos 認証 \(*"マルチレッグ"* Kerberos または *"マルチステップ"* Kerberos と呼ぶこともあります\) を使用する必要があります。 これを実装する方法については、「[セキュリティのベスト プラクティス](../../../docs/framework/wcf/feature-details/best-practices-for-security-in-wcf.md)」を参照してください。  
+  
+     [!code-csharp[c_SimpleImpersonation#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_simpleimpersonation/cs/source.cs#1)]
+     [!code-vb[c_SimpleImpersonation#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_simpleimpersonation/vb/source.vb#1)]  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationBehaviorAttribute>   
+ <xref:System.Security.Principal.TokenImpersonationLevel>   
+ [クライアントの偽装](../../../docs/framework/wcf/samples/impersonating-the-client.md)   
+ [委任と偽装](../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-implement-a-wcf-contract.md b/docs/framework/wcf/how-to-implement-a-wcf-contract.md
new file mode 100644
index 00000000000..fa2a40a5879
--- /dev/null
+++ b/docs/framework/wcf/how-to-implement-a-wcf-contract.md
@@ -0,0 +1,283 @@
+---
+title: "方法 : Windows Communication Foundation サービス コントラクトを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], 実装"
+ms.assetid: d5ab51ba-61ae-403e-b3c8-e2669e326806
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# 方法 : Windows Communication Foundation サービス コントラクトを実装する
+これは、基本的な [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスとそのサービスを呼び出すことができるクライアントの作成に必要な 6 つのタスクのうち、2 番目のタスクです。  6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ WCF アプリケーションの作成における次の手順では、サービス インターフェイスを実装します。  これには、ユーザー定義の `ICalculator` インターフェイスを実装する `CalculatorService` というクラスの作成も含まれます。  
+  
+### WCF サービス コントラクトを実装するには  
+  
+1.  Service1.cs ファイルまたは Service1.vb ファイルを開き、次のコードを追加します。  
+  
+    ```csharp  
+    //Service1.cs  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Linq;  
+    using System.Runtime.Serialization;  
+    using System.ServiceModel;  
+    using System.Text;  
+  
+    namespace GettingStartedLib  
+    {  
+        public class CalculatorService : ICalculator  
+        {  
+            public double Add(double n1, double n2)  
+            {  
+                double result = n1 + n2;  
+                Console.WriteLine("Received Add({0},{1})", n1, n2);  
+                // Code added to write output to the console window.  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Subtract(double n1, double n2)  
+            {  
+                double result = n1 - n2;  
+                Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Multiply(double n1, double n2)  
+            {  
+                double result = n1 * n2;  
+                Console.WriteLine("Received Multiply({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+  
+            public double Divide(double n1, double n2)  
+            {  
+                double result = n1 / n2;  
+                Console.WriteLine("Received Divide({0},{1})", n1, n2);  
+                Console.WriteLine("Return: {0}", result);  
+                return result;  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+    ```  
+    ‘Service1.vb  
+    Imports System  
+    Imports System.ServiceModel  
+  
+    Namespace GettingStartedLib  
+  
+        Public Class CalculatorService  
+            Implements ICalculator  
+  
+            Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add  
+                Dim result As Double = n1 + n2  
+                ' Code added to write output to the console window.  
+                Console.WriteLine("Received Add({0},{1})", n1, n2)  
+                Console.WriteLine("Return: {0}", result)  
+                Return result  
+            End Function  
+  
+            Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract  
+                Dim result As Double = n1 - n2  
+                Console.WriteLine("Received Subtract({0},{1})", n1, n2)  
+                Console.WriteLine("Return: {0}", result)  
+                Return result  
+  
+            End Function  
+  
+            Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply  
+                Dim result As Double = n1 * n2  
+                Console.WriteLine("Received Multiply({0},{1})", n1, n2)  
+                Console.WriteLine("Return: {0}", result)  
+                Return result  
+  
+            End Function  
+  
+            Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide  
+                Dim result As Double = n1 / n2  
+                Console.WriteLine("Received Divide({0},{1})", n1, n2)  
+                Console.WriteLine("Return: {0}", result)  
+                Return result  
+  
+            End Function  
+        End Class  
+    End Namespace  
+    ```  
+  
+     各メソッドは、電卓操作を実装し、テストしやすいように、いくつかのテキストをコンソールに出力します。  
+  
+## 使用例  
+ コントラクトを定義するインターフェイスのコードとそのインターフェイスを実装するコードを次に示します。  
+  
+```  
+// IService1.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.Text;  
+  
+namespace GettingStartedLib  
+{  
+        [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+        public interface ICalculator  
+        {  
+            [OperationContract]  
+            double Add(double n1, double n2);  
+            [OperationContract]  
+            double Subtract(double n1, double n2);  
+            [OperationContract]  
+            double Multiply(double n1, double n2);  
+            [OperationContract]  
+            double Divide(double n1, double n2);  
+        }  
+}  
+  
+```  
+  
+```  
+// Service1.cs  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Runtime.Serialization;  
+using System.ServiceModel;  
+using System.Text;  
+  
+namespace GettingStartedLib  
+{  
+    public class CalculatorService : ICalculator  
+    {  
+        public double Add(double n1, double n2)  
+        {  
+            double result = n1 + n2;  
+            Console.WriteLine("Received Add({0},{1})", n1, n2);  
+            // Code added to write output to the console window.  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Subtract(double n1, double n2)  
+        {  
+            double result = n1 - n2;  
+            Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Multiply(double n1, double n2)  
+        {  
+            double result = n1 * n2;  
+            Console.WriteLine("Received Multiply({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+  
+        public double Divide(double n1, double n2)  
+        {  
+            double result = n1 / n2;  
+            Console.WriteLine("Received Divide({0},{1})", n1, n2);  
+            Console.WriteLine("Return: {0}", result);  
+            return result;  
+        }  
+    }  
+}  
+  
+```  
+  
+```  
+‘IService.vb  
+Imports System  
+Imports System.ServiceModel  
+  
+Namespace GettingStartedLib  
+  
+    <ServiceContract(Namespace:="http://Microsoft.ServiceModel.Samples")> _  
+    Public Interface ICalculator  
+  
+        <OperationContract()> _  
+        Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()> _  
+        Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double  
+    End Interface  
+End Namespace  
+```  
+  
+```  
+Imports System  
+Imports System.ServiceModel  
+  
+Namespace GettingStartedLib  
+  
+    Public Class CalculatorService  
+        Implements ICalculator  
+  
+        Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add  
+            Dim result As Double = n1 + n2  
+            ' Code added to write output to the console window.  
+            Console.WriteLine("Received Add({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+        End Function  
+  
+        Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract  
+            Dim result As Double = n1 - n2  
+            Console.WriteLine("Received Subtract({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+  
+        Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply  
+            Dim result As Double = n1 * n2  
+            Console.WriteLine("Received Multiply({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+  
+        Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide  
+            Dim result As Double = n1 / n2  
+            Console.WriteLine("Received Divide({0},{1})", n1, n2)  
+            Console.WriteLine("Return: {0}", result)  
+            Return result  
+  
+        End Function  
+    End Class  
+End Namespace  
+```  
+  
+ サービス コントラクトが作成されて実装されます。  ソリューションをビルドして、コンパイル エラーが発生しないことを確認します。次は、「[方法 : 基本的なサービスをホストおよび実行する](../../../docs/framework/wcf/how-to-host-and-run-a-basic-wcf-service.md)」に進んでサービスを実行します。  トラブルシューティングの詳細については、「[チュートリアル入門のトラブルシューティング](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md)」を参照してください。  
+  
+## コードのコンパイル  
+ Visual Studio を使用している場合、\[ビルド\] メニューの \[ソリューションのビルド\] をクリックします \(または Ctrl キーと Shift キーを押しながら B キーを押します\)。  
+  
+## 参照  
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md b/docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md
new file mode 100644
index 00000000000..0b60cd93ba3
--- /dev/null
+++ b/docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : 非同期サービス操作を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e5d2ea5-d8f8-4712-bd18-ea3c5461702c
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 方法 : 非同期サービス操作を実装する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでは、クライアントに呼び出し方法を指示することなく、サービス操作を非同期的または同期的に実装できます。たとえば、非同期サービス操作を同期的に呼び出すことも、同期サービス操作を非同期的に呼び出すことも可能です。クライアント アプリケーションから操作を非同期で呼び出す方法を示す例については、「[方法 : サービス操作を非同期に呼び出す](../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)」を参照してください。同期操作および非同期操作[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)」および「[同期操作と非同期操作](../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)」を参照してください。このトピックでは、非同期サービス操作の基本構造について説明します。コードは部分的なコードです。サービス側とクライアント側の両方の完全な例については、「[Asynchronous](http://msdn.microsoft.com/ja-jp/833db946-f511-4f64-a26f-2759a11217c7)」を参照してください。  
+  
+### 非同期サービス操作の実装  
+  
+1.  サービス コントラクトで、.NET 非同期デザイン ガイドラインに従って非同期メソッドのペアを宣言します。`Begin` メソッドは、パラメーター、コールバック オブジェクト、状態オブジェクトを受け取って <xref:System.IAsyncResult?displayProperty=fullName> を返し、組になる `End` メソッドは <xref:System.IAsyncResult?displayProperty=fullName> を受け取って戻り値を返します。非同期呼び出しの詳細については、「[非同期プログラミングのデザイン パターン](http://go.microsoft.com/fwlink/?LinkId=248221)」を参照してください。  
+  
+2.  非同期メソッド ペアの `Begin` メソッドを <xref:System.ServiceModel.OperationContractAttribute?displayProperty=fullName> 属性を使用してマークし、<xref:System.ServiceModel.OperationContractAttribute.AsyncPattern%2A?displayProperty=fullName> プロパティを `true` に設定します。たとえば、次のコード例では手順 1. と 2. を実行します。  
+  
+     [!code-csharp[C_SyncAsyncClient#6](../../../samples/snippets/csharp/VS_Snippets_CFX/c_syncasyncclient/cs/services.cs#6)]
+     [!code-vb[C_SyncAsyncClient#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_syncasyncclient/vb/services.vb#6)]  
+  
+3.  非同期デザインのガイドラインに従って、`Begin/End` メソッド ペアをサービス クラスに実装します。たとえば、次のコード例では、非同期サービス操作の `Begin` および `End` の両方の部分の文字列がコンソールに書き出され、`End` 操作の戻り値がクライアントに返される実装を示します。コード例全体については、「使用例」を参照してください。  
+  
+     [!code-csharp[C_SyncAsyncClient#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_syncasyncclient/cs/services.cs#3)]
+     [!code-vb[C_SyncAsyncClient#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_syncasyncclient/vb/services.vb#3)]  
+  
+## 使用例  
+ このコード例では次のものが示されます。  
+  
+1.  次の操作とのサービス コントラクト インターフェイス  
+  
+    1.  同期 `SampleMethod` 操作  
+  
+    2.  非同期 `BeginSampleMethod` 操作  
+  
+    3.  非同期 `BeginServiceAsyncMethod`\/`EndServiceAsyncMethod` 操作のペア  
+  
+2.  <xref:System.IAsyncResult?displayProperty=fullName> オブジェクトを使用したサービスの実装  
+  
+ [!code-csharp[C_SyncAsyncClient#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_syncasyncclient/cs/services.cs#1)]
+ [!code-vb[C_SyncAsyncClient#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_syncasyncclient/vb/services.vb#1)]  
+  
+## 参照  
+ [サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)   
+ [同期操作と非同期操作](../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md b/docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md
new file mode 100644
index 00000000000..2691df57a64
--- /dev/null
+++ b/docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : PrincipalPermissionAttribute クラスでアクセスを制限する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "PrincipalPermissionAttribute クラス"
+  - "WCF, 承認"
+  - "WCF, セキュリティ"
+ms.assetid: 5162f5c4-8781-4cc4-9425-bb7620eaeaf4
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 方法 : PrincipalPermissionAttribute クラスでアクセスを制限する
+Windows ドメイン コンピューターのリソースへのアクセスを制御することは、基本的なセキュリティ タスクです。たとえば、給与情報のような機密データは、特定のユーザーだけが表示できるようにする必要があります。ここでは、ユーザーが定義済みグループに属していることを要求することによって、メソッドへのアクセスを制限する方法について説明します。実際に動作するサンプルについては、「[サービス操作へのアクセスの承認](../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)」を参照してください。  
+  
+ タスクは、2 つの別個の手順で構成されます。最初の手順では、グループを作成してユーザーを追加します。2 番目の手順では、グループを指定するために <xref:System.Security.Permissions.PrincipalPermissionAttribute> クラスを適用します。  
+  
+### Windows グループを作成するには  
+  
+1.  **\[コンピューターの管理\]** コンソールを開きます。  
+  
+2.  左のパネルで、**\[ローカル ユーザーとグループ\]** をクリックします。  
+  
+3.  **\[グループ\]** を右クリックし、**\[新しいグループ\]** をクリックします。  
+  
+4.  **\[グループ名\]** ボックスに、新しいグループの名前を入力します。  
+  
+5.  **\[説明\]** ボックスに、新しいグループの説明を入力します。  
+  
+6.  **\[追加\]** をクリックして、グループに新しいメンバーを追加します。  
+  
+7.  自分自身をグループに追加した場合は、次のコードをテストする前に、コンピューターからいったんログオフし、再度ログオンして自分自身をグループに含める必要があります。  
+  
+### ユーザー メンバーシップを要求するには  
+  
+1.  実装されたサービス コントラクト コードを含む [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] コード ファイルを開きます。コントラクトの実装[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)」を参照してください。  
+  
+2.  特定のグループに制限される必要がある各メソッドに <xref:System.Security.Permissions.PrincipalPermissionAttribute> 属性を適用します。<xref:System.Security.Permissions.SecurityAttribute.Action%2A> プロパティを <xref:System.Security.Permissions.SecurityAction> に設定し、<xref:System.Security.Permissions.PrincipalPermissionAttribute.Role%2A> プロパティをグループの名前に設定します。次に例を示します。  
+  
+     [!code-csharp[c_PrincipalPermissionAttribute#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_principalpermissionattribute/cs/source.cs#1)]
+     [!code-vb[c_PrincipalPermissionAttribute#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_principalpermissionattribute/vb/source.vb#1)]  
+  
+    > [!NOTE]
+    >  <xref:System.Security.Permissions.PrincipalPermissionAttribute> 属性をコントラクトに適用すると、<xref:System.Security.SecurityException> がスローされます。この属性はメソッド レベルにのみ適用できます。  
+  
+## 証明書を使用したメソッドへのアクセスの制御  
+ クライアント資格情報の種類が "証明書" の場合は、`PrincipalPermissionAttribute` クラスを使用してメソッドへのアクセスを制御することもできます。そのためには、証明書のサブジェクトと拇印が必要になります。  
+  
+ 証明書のプロパティを確認する方法については、「[方法 : MMC スナップインを使用して証明書を参照する](../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)」を参照してください。拇印の値を検索する方法については、「[方法 : 証明書のサムプリントを取得する](../../../docs/framework/wcf/feature-details/how-to-retrieve-the-thumbprint-of-a-certificate.md)」を参照してください。  
+  
+#### 証明書を使用してアクセスを制御するには  
+  
+1.  アクセスを制限するメソッドに <xref:System.Security.Permissions.PrincipalPermissionAttribute> クラスを適用します。  
+  
+2.  属性のアクションを <xref:System.Security.Permissions.SecurityAction?displayProperty=fullName> に設定します。  
+  
+3.  `Name` プロパティを、サブジェクト名と証明書の拇印で構成される文字列に設定します。次の例に示すように、2 つの値をセミコロンと空白で区切ってください。  
+  
+     [!code-csharp[c_PrincipalPermissionAttribute#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_principalpermissionattribute/cs/source.cs#2)]
+     [!code-vb[c_PrincipalPermissionAttribute#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_principalpermissionattribute/vb/source.vb#2)]  
+  
+4.  次の構成例に示すように、<xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.PrincipalPermissionMode%2A> プロパティを <xref:System.ServiceModel.Description.PrincipalPermissionMode> に設定します。  
+  
+    ```  
+    <behaviors>  
+      <serviceBehaviors>  
+      <behavior name="SvcBehavior1">  
+      <serviceAuthorization principalPermissionMode="UseAspNetRoles" />  
+      </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    ```  
+  
+     この値を `UseAspNetRoles` に設定すると、`PrincipalPermissionAttribute` の `Name` プロパティを使用して文字列が比較されます。クライアント資格情報として証明書を使用している場合、既定では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は証明書の共通名と拇印をセミコロンで連結して、クライアントのプライマリ ID を表す一意の値が作成されます。`UseAspNetRoles` をサービスの `PrincipalPermissionMode` として設定している場合、このプライマリ ID の値と `Name` プロパティの値を比較してユーザーのアクセス権が決定されます。  
+  
+     また、自己ホスト型サービスを作成する場合は、次のコードに示すように、コードの <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior.PrincipalPermissionMode%2A> プロパティを設定します。  
+  
+     [!code-csharp[c_PrincipalPermissionAttribute#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_principalpermissionattribute/cs/source.cs#3)]
+     [!code-vb[c_PrincipalPermissionAttribute#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_principalpermissionattribute/vb/source.vb#3)]  
+  
+## 参照  
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>   
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute>   
+ <xref:System.Security.Permissions.SecurityAction>   
+ <xref:System.Security.Permissions.PrincipalPermissionAttribute.Role%2A>   
+ [サービス操作へのアクセスの承認](../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)   
+ [セキュリティの概要](../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md b/docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md
new file mode 100644
index 00000000000..deba0ff1bb1
--- /dev/null
+++ b/docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md
@@ -0,0 +1,159 @@
+---
+title: "方法 : Windows 資格情報でサービスをセキュリティで保護する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF, セキュリティ"
+ms.assetid: d171b5ca-96ef-47ff-800c-c138023cf76e
+caps.latest.revision: 26
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 26
+---
+# 方法 : Windows 資格情報でサービスをセキュリティで保護する
+ここでは、Windows ドメイン内に存在し、同じドメイン内のクライアントから呼び出される [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスで転送セキュリティを有効にする方法について説明します。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]このシナリオを参照してください[トランスポート セキュリティと Windows 認証](../../../docs/framework/wcf/feature-details/transport-security-with-windows-authentication.md)します。 サンプル アプリケーションについては、次を参照してください。、 [WSHttpBinding](../../../docs/framework/wcf/samples/wshttpbinding.md)サンプルです。  
+  
+ このトピックでは、定義済みのコントラクト インターフェイスと実装が既に存在するものとして、それに機能を追加していきます。 既存のサービスとクライアントを変更することもできます。  
+  
+ Windows 資格情報によるサービスのセキュリティ保護は、完全にコードで実現できます。 または、構成ファイルを使用して、一部のコードを省略することもできます。 このトピックでは両方の方法について説明します。 ただし、どちらか&1; つの方法だけを使うようにして、両方は使用しないでください。  
+  
+ 最初の&3; つの手順は、コードを使用してサービスをセキュリティで保護する方法について示しています。 4 番目と&5; 番目の手順は、構成ファイルを使用して同様の操作を行う方法について示しています。  
+  
+## <a name="using-code"></a>コードの使用  
+ サービスとクライアントの完全なコードは、このトピックの最後にある「使用例」のセクションに記載されています。  
+  
+ 作成して構成する最初の手順では、説明、 <xref:System.ServiceModel.WSHttpBinding>コード内のクラスです。 バインディングでは HTTP トランスポートを使用します。 同じバインディングがクライアント上で使用されます。  
+  
+#### <a name="to-create-a-wshttpbinding-that-uses-windows-credentials-and-message-security"></a>Windows 資格情報とメッセージ セキュリティを使用する WSHttpBinding を作成するには  
+  
+1.  この手順のコードは、「使用例」のセクションに記載されたサービス コードの `Run` クラスの `Test` メソッドの先頭に挿入されています。  
+  
+2.  インスタンスを作成、 <xref:System.ServiceModel.WSHttpBinding>クラスです。  
+  
+3.  設定、 <xref:System.ServiceModel.WsHttpSecurity.Mode%2A>のプロパティ、 <xref:System.ServiceModel.WsHttpSecurity>クラスを<xref:System.ServiceModel.SecurityMode>します。  
+  
+4.  設定、 <xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType%2A>のプロパティ、 <xref:System.ServiceModel.MessageSecurityOverHttp>クラスを<xref:System.ServiceModel.MessageCredentialType>します。  
+  
+5.  この手順で使用するコードは、次のようになります。  
+  
+     [!code-csharp[c_SecureWindowsService#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsservice/cs/secureservice.cs#1)]
+     [!code-vb[c_SecureWindowsService#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewindowsservice/vb/secureservice.vb#1)]  
+  
+### <a name="using-the-binding-in-a-service"></a>サービスでのバインディングの使用  
+ この&2; 番目の手順では、自己ホスト型サービスでバインディングを使用する方法を示します。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]ホスティング サービスを参照してください[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)します。  
+  
+##### <a name="to-use-a-binding-in-a-service"></a>サービスでバインディングを使用するには  
+  
+1.  前の手順のコードの後に、この手順のコードを挿入します。  
+  
+2.  作成、<xref:System.Type>という名前の変数`contractType`インターフェイスの型を割り当てると (`ICalculator`)。 [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] を使用している場合は、`GetType` 演算子を使用し、C# を使用している場合は、`typeof` キーワードを使用します。  
+  
+3.  `Type` という名前の&2; つ目の `serviceType` 変数を作成し、その変数に実装されたコントラクトの型 (`Calculator`) を割り当てます。  
+  
+4.  インスタンスを作成、 <xref:System.Uri>という名前のクラス`baseAddress`サービスのベース アドレスを使用します。 ベース アドレスには、トランスポートに一致するスキームを指定する必要があります。 この場合、トランスポート スキームは HTTP であり、アドレスは、特別な URI (Uniform Resource Identifier) の "localhost"、ポート番号 (8036)、およびベース エンドポイント アドレス ("serviceModelSamples/) で構成されます。つまり、http://localhost:8036/serviceModelSamples/ になります。  
+  
+5.  インスタンスを作成、 <xref:System.ServiceModel.ServiceHost>クラス、`serviceType`と`baseAddress`変数です。  
+  
+6.  `contractType`、バインディング、およびエンドポイント名 (secureCalculator) を使用して、サービスにエンドポイントを追加します。 クライアントは、サービスへの呼び出しを開始するときに、ベース アドレスとエンドポイント名を連結する必要があります。  
+  
+7.  呼び出す、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A>サービスを開始するメソッドです。 この手順で使用するコードは次のとおりです。  
+  
+     [!code-csharp[c_SecureWindowsService#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsservice/cs/secureservice.cs#2)]
+     [!code-vb[c_SecureWindowsService#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewindowsservice/vb/secureservice.vb#2)]  
+  
+### <a name="using-the-binding-in-a-client"></a>クライアントでのバインディングの使用  
+ この手順では、サービスと通信するプロキシの生成方法を示します。 プロキシが生成、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)サービス メタデータを使用してプロキシを作成します。  
+  
+ このプロシージャのインスタンスの作成も、 <xref:System.ServiceModel.WSHttpBinding>サービスと通信するクラスし、サービスが呼び出されます。  
+  
+ この例では、コードだけを使用してクライアントを作成します。 この手順の後のセクションに示す構成ファイルを使用することもできます。  
+  
+##### <a name="to-use-a-binding-in-a-client-with-code"></a>コードによってクライアントでバインディングを使用するには  
+  
+1.  SvcUtil.exe ツールを使用して、サービスのメタデータからプロキシ コードを生成します。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][方法: クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)です。 生成されたプロキシ コードが継承、 <xref:System.ServiceModel.ClientBase%601>クラスで、必要なコンス トラクター、メソッド、およびプロパティと通信するすべてのクライアントがあることを確認、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]サービスです。 この例では、生成されたコードに、`CalculatorClient` インターフェイスを実装した `ICalculator` クラスが追加されるので、サービス コードとの互換が可能になります。  
+  
+2.  この手順のコードは、クライアント プログラムの `Main` メソッドの先頭に挿入します。  
+  
+3.  インスタンスを作成、 <xref:System.ServiceModel.WSHttpBinding>クラスし、そのセキュリティ モードを設定`Message`とそのクライアントの資格情報の種類`Windows`します。 この例では、変数に `clientBinding` という名前を付けます。  
+  
+4.  インスタンスを作成、 <xref:System.ServiceModel.EndpointAddress>という名前のクラス`serviceAddress`します。 エンドポイント名が連結されたベース アドレスでインスタンスを初期化します。  
+  
+5.  `serviceAddress` 変数と `clientBinding` 変数を指定して、生成されたクライアント クラスのインスタンスを作成します。  
+  
+6.  呼び出す、<xref:System.ServiceModel.ClientBase%601.Open%2A>メソッドを次のコードに示すようにします。  
+  
+7.  サービスを呼び出し、結果を表示します。  
+  
+     [!code-csharp[c_secureWindowsClient#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsclient/cs/secureclient.cs#1)]
+     [!code-vb[c_secureWindowsClient#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewindowsclient/vb/secureclient.vb#1)]  
+  
+## <a name="using-the-configuration-file"></a>構成ファイルの使用  
+ 手順コードを使用してバインディングを作成する代わりに、構成ファイルのバインディング セクションに次のコードを記述することもできます。  
+  
+ 定義されているサービスがあるない場合は、次を参照してください。[を設計および実装するサービス](../../../docs/framework/wcf/designing-and-implementing-services.md)、および[サービスを構成する](../../../docs/framework/wcf/configuring-services.md)です。  
+  
+ **注**サービスとクライアントの両方の構成ファイルでこの構成コードを使用します。  
+  
+#### <a name="to-enable-transfer-security-on-a-service-in-a-windows-domain-using-configuration"></a>構成を使用して Windows ドメインのサービスで転送セキュリティを有効にするには  
+  
+1.  追加、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)要素を[ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)構成ファイルの要素のセクションです。  
+  
+2.  <`binding`> 要素に <`WSHttpBinding`> 要素を追加し、`configurationName` 属性をアプリケーションに適した値に設定します。  
+  
+3.  <`security`> 要素を追加し、`mode` 属性を Message に設定します。  
+  
+4.  <`message`> 要素を追加し、`clientCredentialType` 属性を Windows に設定します。  
+  
+5.  サービスの構成ファイルで、`<bindings>` セクションを次のコードに置き換えます。 サービス構成ファイルがあるない場合は、次を参照してください。[を使用してサービスを構成すると、クライアントのバインド](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)します。  
+  
+    ```  
+    <bindings>  
+      <wsHttpBinding>  
+       <binding name = "wsHttpBinding_Calculator">  
+         <security mode="Message">  
+           <message clientCredentialType="Windows"/>  
+         </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    ```  
+  
+### <a name="using-the-binding-in-a-client"></a>クライアントでのバインディングの使用  
+ この手順では、サービスと通信するプロキシと構成ファイルの&2; つのファイルの生成方法を示します。 また、クライアント上で使用される&3; つ目のファイルであるクライアント プログラムへの変更点についても説明します。  
+  
+##### <a name="to-use-a-binding-in-a-client-with-configuration"></a>構成によってクライアントでバインディングを使用するには  
+  
+1.  SvcUtil.exe ツールを使用して、サービスのメタデータからプロキシ コードと構成ファイルを生成します。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][方法: クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)です。  
+  
+2.  置き換える、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)の構成コードは、前のセクションを生成された構成ファイルのセクションです。  
+  
+3.  手順コードは、クライアント プログラムの `Main` メソッドの先頭に挿入します。  
+  
+4.  生成されたクライアント クラスのインスタンスを作成します。このとき、構成ファイルのバインディングの名前を入力パラメーターとして渡します。  
+  
+5.  呼び出す、<xref:System.ServiceModel.ClientBase%601.Open%2A>メソッドを次のコードに示すようにします。  
+  
+6.  サービスを呼び出し、結果を表示します。  
+  
+     [!code-csharp[c_secureWindowsClient#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsclient/cs/secureclient.cs#2)]  
+  
+## <a name="example"></a>例  
+ [!code-csharp[c_SecureWindowsService#0](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsservice/cs/secureservice.cs#0)]  
+  
+ [!code-csharp[c_SecureWindowsClient#0](../../../samples/snippets/csharp/VS_Snippets_CFX/c_securewindowsclient/cs/secureclient.cs#0)]
+ [!code-vb[c_SecureWindowsClient#0](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_securewindowsclient/vb/secureclient.vb#0)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.WSHttpBinding>   
+ [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [方法: クライアントを作成します。](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)   
+ [セキュリティの概要](../../../docs/framework/wcf/feature-details/security-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-set-the-protectionlevel-property.md b/docs/framework/wcf/how-to-set-the-protectionlevel-property.md
new file mode 100644
index 00000000000..caf90433bd7
--- /dev/null
+++ b/docs/framework/wcf/how-to-set-the-protectionlevel-property.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : ProtectionLevel プロパティを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ProtectionLevel プロパティ"
+  - "WCF, セキュリティ"
+ms.assetid: 3d4e8f80-0f9e-4a26-9899-beb6584e78df
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 方法 : ProtectionLevel プロパティを設定する
+適切な属性を適用してプロパティを設定することで、保護レベルを設定できます。サービス レベルですべてのメッセージのすべての部分に影響する保護を設定したり、メソッドからメッセージ部分まで、段階的にきめ細かなレベルで保護を設定したりできます。`ProtectionLevel` プロパティ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。  
+  
+> [!NOTE]
+>  保護レベルは構成ではなく、コードでのみ設定できます。  
+  
+### サービスのすべてのメッセージに署名するには  
+  
+1.  サービス用のインターフェイスを作成します。  
+  
+2.  次のコードに示すように、<xref:System.ServiceModel.ServiceContractAttribute> 属性をサービスに適用し、<xref:System.ServiceModel.ServiceContractAttribute.ProtectionLevel%2A> プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します \(既定のレベルは <xref:System.Net.Security.ProtectionLevel>\)。  
+  
+     [!code-csharp[C_ProtectionLevel#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#1)]
+     [!code-vb[C_ProtectionLevel#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#1)]  
+  
+### 操作のすべてのメッセージ部分に署名するには  
+  
+1.  サービスのインターフェイスを作成し、このインターフェイスに <xref:System.ServiceModel.ServiceContractAttribute> 属性を適用します。  
+  
+2.  インターフェイスにメソッド宣言を追加します。  
+  
+3.  次のコードに示すように、メソッドに <xref:System.ServiceModel.OperationContractAttribute> 属性を適用し、<xref:System.ServiceModel.ServiceContractAttribute.ProtectionLevel%2A> プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します。  
+  
+     [!code-csharp[C_ProtectionLevel#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#2)]
+     [!code-vb[C_ProtectionLevel#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#2)]  
+  
+## エラー メッセージの保護  
+ サービスでスローされた例外は、SOAP エラーとしてクライアントに送信できます。厳密に型指定されたエラーの作成[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」および「[方法 : サービス コントラクトでのエラーを宣言する](../../../docs/framework/wcf/how-to-declare-faults-in-service-contracts.md)」を参照してください。  
+  
+#### エラー メッセージを保護するには  
+  
+1.  エラー メッセージを表す型を作成します。次の例では、2 つのフィールドを持つ `MathFault` という名前のクラスを作成します。  
+  
+2.  次のコードに示すように、型に <xref:System.Runtime.Serialization.DataContractAttribute> 属性を適用し、シリアル化する必要のある各フィールドに <xref:System.Runtime.Serialization.DataMemberAttribute> 属性を適用します。  
+  
+     [!code-csharp[C_ProtectionLevel#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#3)]
+     [!code-vb[C_ProtectionLevel#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#3)]  
+  
+3.  エラーを返すインターフェイスで、エラーを返すメソッドに <xref:System.ServiceModel.FaultContractAttribute> 属性を適用し、エラー クラスの型に `detailType` パラメーターを設定します。  
+  
+4.  次のコードに示すように、コンストラクターでも、<xref:System.ServiceModel.FaultContractAttribute.ProtectionLevel%2A> プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します。  
+  
+     [!code-csharp[C_ProtectionLevel#4](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#4)]
+     [!code-vb[C_ProtectionLevel#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#4)]  
+  
+## メッセージ部分の保護  
+ メッセージ部分を保護するには、メッセージ コントラクトを使用します。メッセージ コントラクト[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[メッセージ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-message-contracts.md)」を参照してください。  
+  
+#### メッセージ本文を保護するには  
+  
+1.  メッセージを表す型を作成します。次の例では、`CompanyName` と `CompanyID` の 2 つのフィールドを持つ `Company` クラスを作成します。  
+  
+2.  このクラスに <xref:System.ServiceModel.MessageContractAttribute> 属性を適用し、<xref:System.ServiceModel.MessageContractAttribute.ProtectionLevel%2A> プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します。  
+  
+3.  メッセージ ヘッダーとして表現されるフィールドに <xref:System.ServiceModel.MessageHeaderAttribute> 属性を適用し、`ProtectionLevel` プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します。  
+  
+4.  次の例に示すように、メッセージ本文の一部として表現される任意のフィールドに <xref:System.ServiceModel.MessageBodyMemberAttribute> を適用し、`ProtectionLevel` プロパティを <xref:System.Net.Security.ProtectionLevel> に設定します。  
+  
+     [!code-csharp[C_ProtectionLevel#5](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#5)]
+     [!code-vb[C_ProtectionLevel#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#5)]  
+  
+## 使用例  
+ 次の例では、サービスのいろいろな場所で、いくつかの属性クラスの `ProtectionLevel` プロパティを設定します。  
+  
+ [!code-csharp[C_ProtectionLevel#6](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#6)]
+ [!code-vb[C_ProtectionLevel#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#6)]  
+  
+## コードのコンパイル  
+ コード例のコンパイルに必要な名前空間を、次のコードに示します。  
+  
+ [!code-csharp[C_ProtectionLevel#0](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#0)]
+ [!code-vb[C_ProtectionLevel#0](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#0)]  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ <xref:System.ServiceModel.FaultContractAttribute>   
+ <xref:System.ServiceModel.MessageContractAttribute>   
+ <xref:System.ServiceModel.MessageBodyMemberAttribute>   
+ [保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-set-the-security-mode.md b/docs/framework/wcf/how-to-set-the-security-mode.md
new file mode 100644
index 00000000000..dcdff80c0bf
--- /dev/null
+++ b/docs/framework/wcf/how-to-set-the-security-mode.md
@@ -0,0 +1,129 @@
+---
+title: "方法 : セキュリティ モードを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Mode プロパティ"
+  - "WCF, セキュリティ"
+  - "WCF, セキュリティ モード"
+ms.assetid: 6e01dd9f-b5dd-4474-b24c-06e124de4ff7
+caps.latest.revision: 22
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 22
+---
+# 方法 : セキュリティ モードを設定する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] セキュリティには、"トランスポート"、"メッセージ"、および "メッセージ資格情報付きトランスポート" という 3 つの共通のセキュリティ モードがあり、ほとんどの定義済みバインディングでサポートされます。これ以外に、2 つのバインディングに固有の 2 つのモードがあります。<xref:System.ServiceModel.BasicHttpBinding> の "トランスポート資格情報専用" モードと、<xref:System.ServiceModel.NetMsmqBinding> の "両方" モードです。ここでは、3 つの共通のセキュリティモードである <xref:System.ServiceModel.SecurityMode>、<xref:System.ServiceModel.SecurityMode>、および <xref:System.ServiceModel.SecurityMode> に重点を置いて説明します。  
+  
+ ただし、これらのモードがすべての定義済みバインディングでサポートされるわけではありません。ここでは、<xref:System.ServiceModel.WSHttpBinding> クラスと <xref:System.ServiceModel.NetTcpBinding> クラスでモードを設定し、プログラムと構成の両方を使用してモードを設定する方法を示します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のセキュリティ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[セキュリティの概要](../../../docs/framework/wcf/feature-details/security-overview.md)」、「[サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)」、および「[サービスおよびクライアントのセキュリティ保護](../../../docs/framework/wcf/feature-details/securing-services-and-clients.md)」を参照してください。トランスポート モードとメッセージ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[トランスポート セキュリティ](../../../docs/framework/wcf/feature-details/transport-security.md)」および「[メッセージのセキュリティ](../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)」を参照してください。  
+  
+### コードでセキュリティ モードを設定するには  
+  
+1.  使用しているバインディング クラスのインスタンスを作成します。定義済みバインディングの一覧については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。この例では、<xref:System.ServiceModel.WSHttpBinding> クラスのインスタンスを作成します。  
+  
+2.  `Security` プロパティから返されるオブジェクトの `Mode` プロパティを設定します。  
+  
+     [!code-csharp[c_SettingSecurityMode#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#1)]
+     [!code-vb[c_SettingSecurityMode#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#1)]  
+  
+     または、モードを Message \(メッセージ\) に設定します。コードは次のようになります。  
+  
+     [!code-csharp[c_SettingSecurityMode#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#2)]
+     [!code-vb[c_SettingSecurityMode#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#2)]  
+  
+     または、モードを TransportWithMessageCredential \(メッセージ資格情報付きトランスポート\) に設定します。コードは次のようになります。  
+  
+     [!code-csharp[c_SettingSecurityMode#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#3)]
+     [!code-vb[c_SettingSecurityMode#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#3)]  
+  
+3.  次のコードに示すように、バインディングのコンストラクターでモードを設定することもできます。  
+  
+     [!code-csharp[c_SettingSecurityMode#4](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#4)]
+     [!code-vb[c_SettingSecurityMode#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#4)]  
+  
+## ClientCredentialType プロパティの設定  
+ モードを上記の 3 つの値のいずれかに設定すると、`ClientCredentialType` プロパティの設定方法が決まります。たとえば、<xref:System.ServiceModel.WSHttpBinding> クラスを使用し、モードを `Transport` に設定した場合、<xref:System.ServiceModel.HttpTransportSecurity> クラスの <xref:System.ServiceModel.HttpTransportSecurity.ClientCredentialType%2A> プロパティを適切な値に設定する必要があります。  
+  
+#### トランスポート モードの ClientCredentialType プロパティを設定するには  
+  
+1.  バインディングのインスタンスを作成します。  
+  
+2.  `Mode` プロパティを `Transport` に設定します。  
+  
+3.  `ClientCredential` プロパティに適切な値を設定します。プロパティを `Windows` に設定するコードを次に示します。  
+  
+     [!code-csharp[c_SettingSecurityMode#5](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#5)]
+     [!code-vb[c_SettingSecurityMode#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#5)]  
+  
+#### メッセージ モードの ClientCredentialType プロパティを設定するには  
+  
+1.  バインディングのインスタンスを作成します。  
+  
+2.  `Mode` プロパティを `Message` に設定します。  
+  
+3.  `ClientCredential` プロパティに適切な値を設定します。プロパティを `Certificate` に設定するコードを次に示します。  
+  
+     [!code-csharp[c_SettingSecurityMode#6](../../../samples/snippets/csharp/VS_Snippets_CFX/c_settingsecuritymode/cs/source.cs#6)]
+     [!code-vb[c_SettingSecurityMode#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_settingsecuritymode/vb/source.vb#6)]  
+  
+#### 構成でモードと ClientCredentialType プロパティを設定するには  
+  
+1.  構成ファイルの [\<bindings\>](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素に、適切なバインド要素を追加します。次の例では [\<wsHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素を追加しています。  
+  
+2.  `<binding>` 要素を追加し、`name` 属性に適切な値を設定します。  
+  
+3.  `<security>` 要素を追加し、`mode` 属性を `Message`、`Transport`、または `TransportWithMessageCredential` に設定します。  
+  
+4.  モードを `Transport` に設定した場合は、`<transport>` 要素を追加し、`clientCredential` 属性を適切な値に設定します。  
+  
+     モードを "`Transport"` に設定し、`<transport>` 要素の `clientCredentialType` 属性を "`Windows"` に設定する例を次に示します。  
+  
+    ```  
+    <wsHttpBinding>  
+    <binding name="TransportSecurity">  
+        <security mode="Transport" />  
+           <transport clientCredentialType = "Windows" />  
+        </security>  
+    </binding>  
+    </wsHttpBinding >  
+    ```  
+  
+     または、`security mode` を "`Message"` に設定し、その後に `<"message">` 要素を指定します。この例では、`clientCredentialType` を "`Certificate"` に設定しています。  
+  
+    ```  
+    <wsHttpBinding>  
+    <binding name="MessageSecurity">  
+        <security mode="Message" />  
+           <message clientCredentialType = "Certificate" />  
+        </security>  
+    </binding>  
+    </wsHttpBinding >  
+    ```  
+  
+     次に説明する <xref:System.ServiceModel.BasicHttpSecurityMode> 値は、特殊なケースで使用されます。  
+  
+### TransportWithMessageCredential の使用  
+ セキュリティ モードを `TransportWithMessageCredential` に設定した場合、トランスポート レベルのセキュリティを提供する実際の機構はトランスポートによって決まります。たとえば、HTTP プロトコルでは SSL \(Secure Sockets Layer\) over HTTP \(HTTPS\) を使用します。このため、トランスポート セキュリティ オブジェクト \(<xref:System.ServiceModel.HttpTransportSecurity> など\) の `ClientCredentialType` プロパティを設定しても無視されます。つまり、メッセージ セキュリティ オブジェクト \(`WSHttpBinding` バインディングの場合は <xref:System.ServiceModel.NonDualMessageSecurityOverHttp> オブジェクト\) の `ClientCredentialType` だけを設定できます。  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : トランスポート セキュリティとメッセージ資格情報を使用する](../../../docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md).  
+  
+## 参照  
+ [方法 : SSL 証明書を使用してポートを構成する](../../../docs/framework/wcf/feature-details/how-to-configure-a-port-with-an-ssl-certificate.md)   
+ [方法 : トランスポート セキュリティとメッセージ資格情報を使用する](../../../docs/framework/wcf/feature-details/how-to-use-transport-security-and-message-credentials.md)   
+ [トランスポート セキュリティ](../../../docs/framework/wcf/feature-details/transport-security.md)   
+ [メッセージのセキュリティ](../../../docs/framework/wcf/feature-details/message-security-in-wcf.md)   
+ [セキュリティの概要](../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)   
+ [\<security\>](../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)   
+ [\<security\>](../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)   
+ [\<security\>](../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-a-client-binding-in-code.md b/docs/framework/wcf/how-to-specify-a-client-binding-in-code.md
new file mode 100644
index 00000000000..b70b8aa5f91
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-a-client-binding-in-code.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : コード内でクライアント バインディングを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6bee5da4-adf7-42e6-8f78-63a9e5c6dbad
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : コード内でクライアント バインディングを指定する
+この例では、電卓サービスを使用するためのクライアントを作成し、そのクライアントのバインディングを強制的にコードで指定します。クライアントは `CalculatorService` にアクセスします。これにより、`ICalculator` インターフェイスが実装され、サービスとクライアントの両方で <xref:System.ServiceModel.BasicHttpBinding> クラスが使用されます。  
+  
+ ここで説明する手順では、電卓サービスが実行されていることを前提としています。サービスの構築については、「[方法 : 構成でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。クライアント コンポーネントを自動的に生成するために、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] に付属する [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) も使用します。このツールでは、サービスにアクセスするためのクライアント コードが生成されます。  
+  
+ クライアントは 2 つの部分で構成されます。Svcutil.exe によって、`ICalculator` インターフェイスを実装する `ClientCalculator` が生成されます。次に、`ClientCalculator` のインスタンスを作成し、サービスのバインディングとアドレスをコードで指定して、このクライアント アプリケーションを作成します。  
+  
+ この例のソースのコピーについては、「[BasicBinding](../../../docs/framework/wcf/samples/basicbinding.md)」のサンプルを参照してください。  
+  
+### コード内でカスタム バインディングを指定するには  
+  
+1.  コマンド ラインから Svcutil.exe を実行して、サービス メタデータからコードを生成します。  
+  
+    ```  
+    Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+    ```  
+  
+2.  生成されたクライアントには、クライアントの実装時に満たされなければならないサービス コントラクトを定義する `ICalculator` インターフェイスが含まれます。  
+  
+     [!code-csharp[C_HowTo_CodeClientBinding#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeclientbinding/cs/client.cs#1)]
+     [!code-vb[C_HowTo_CodeClientBinding#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeclientbinding/vb/client.vb#1)]  
+  
+3.  生成されたクライアントは `ClientCalculator` も実装します。  
+  
+     [!code-csharp[C_HowTo_CodeClientBinding#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeclientbinding/cs/client.cs#2)]
+     [!code-vb[C_HowTo_CodeClientBinding#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeclientbinding/vb/client.vb#2)]  
+  
+4.  クライアント アプリケーション内で <xref:System.ServiceModel.BasicHttpBinding> クラスを使用する `ClientCalculator` のインスタンスを作成し、指定したアドレスのサービス操作を呼び出します。  
+  
+     [!code-csharp[C_HowTo_CodeClientBinding#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeclientbinding/cs/client.cs#3)]
+     [!code-vb[C_HowTo_CodeClientBinding#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeclientbinding/vb/client.vb#3)]  
+  
+5.  クライアントをコンパイルして実行します。  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md b/docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md
new file mode 100644
index 00000000000..54316290cbd
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : 構成でクライアント バインディングを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4a7c79aa-50ee-4991-891e-adc0599323a7
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 方法 : 構成でクライアント バインディングを指定する
+この例では、電卓サービスを使用するためのクライアント コンソール アプリケーションを作成し、そのクライアントのバインディングを構成で宣言によって指定します。 クライアントがアクセスする、`CalculatorService`を実装する、`ICalculator`インターフェイス、およびサービスとを使用してクライアントの両方、 <xref:System.ServiceModel.BasicHttpBinding>クラスです。  
+  
+ ここで説明する手順は、電卓サービスが実行されていることを前提とします。 サービスを構築する方法については、次を参照してください。[方法: 構成では、サービス バインドを指定](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)します。 使用して、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)を[!INCLUDE[indigo1](../../../includes/indigo1-md.md)]クライアント コンポーネントを自動的に生成を提供します。 このツールにより、サービスにアクセスするためのクライアント コードと構成が生成されます。  
+  
+ クライアントは&2; つの部分で構成されます。 Svcutil.exe によって、`ClientCalculator` インターフェイスを実装する `ICalculator` が生成されます。 次に、`ClientCalculator` のインスタンスを作成することで、クライアント アプリケーションを作成します。  
+  
+ 通常、ベスト プラクティスは、コードで命令として記述するよりも、構成でバインディングを指定して情報を明示的にアドレス指定することです。 設置済みサービスのバインドおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。 一般的に、バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+ 次の構成手順のすべてを実行するにを使用して、[構成エディター ツール (SvcConfigEditor.exe)](../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)します。  
+  
+ この例のソースのコピー、表示、 [BasicBinding](../../../docs/framework/wcf/samples/basicbinding.md)サンプルです。  
+  
+### <a name="specifying-a-client-binding-in-configuration"></a>構成を使用したクライアント バインディングの指定  
+  
+1.  コマンド ラインから Svcutil.exe を実行して、サービス メタデータからコードを生成します。  
+  
+    ```  
+    Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>   
+    ```  
+  
+2.  生成されたクライアントには、クライアントの実装時に満たされなければならないサービス コントラクトを定義する `ICalculator` インターフェイスが含まれます。  
+  
+     [!code-csharp[C_HowTo_ConfigureClientBinding#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureclientbinding/cs/generatedclient.cs#1)]
+     [!code-csharp[C_HowTo_ConfigureClientBinding#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureclientbinding/cs/source.cs#1)]  
+  
+3.  生成されたクライアントは `ClientCalculator` も実装します。  
+  
+     [!code-csharp[C_HowTo_ConfigureClientBinding#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureclientbinding/cs/generatedclient.cs#2)]
+     [!code-csharp[C_HowTo_ConfigureClientBinding#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureclientbinding/cs/source.cs#2)]  
+  
+4.  Svcutil.exe を使用するクライアントの構成を生成も、 <xref:System.ServiceModel.BasicHttpBinding>クラスです。 [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用する場合、このファイルに App.config という名前を付けます。 このサービスの実装では、アドレス情報とバインディング情報が指定されないことに注意してください。 同様に、コードは構成ファイルから情報を取得する必要はありません。  
+  
+     [!code[C_HowTo_ConfigureClientBinding#100](../../../samples/snippets/common/VS_Snippets_CFX/c_howto_configureclientbinding/common/client.exe.config#100)]  
+  
+5.  アプリケーションで `ClientCalculator` のインスタンスを作成し、サービス操作を呼び出します。  
+  
+     [!code-csharp[C_HowTo_ConfigureClientBinding#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureclientbinding/cs/client.cs#3)]  
+  
+6.  クライアントをコンパイルして実行します。  
+  
+## <a name="see-also"></a>関連項目  
+ [バインドを使用してサービスとクライアントを構成するには](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-a-service-binding-in-code.md b/docs/framework/wcf/how-to-specify-a-service-binding-in-code.md
new file mode 100644
index 00000000000..1d9a3484479
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-a-service-binding-in-code.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : コード内でサービス バインディングを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67ab5dd8-79c1-4e62-aa75-828ea918a53a
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法 : コード内でサービス バインディングを指定する
+この例では、電卓サービスに `ICalculator` コントラクトを定義し、そのサービスを `CalculatorService` クラスに実装し、コード内でサービス エンドポイントを定義します。このエンドポイントでは、サービスが <xref:System.ServiceModel.BasicHttpBinding> クラスを使用するように指定します。  
+  
+ 通常、ベスト プラクティスは、コードで命令として記述するよりも、構成でバインディングを指定して情報を明示的にアドレス指定することです。展開済みサービスのバインディングおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。一般的に、バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+ コードの代わりに構成要素を使用してこのサービスを構成する方法については、「[方法 : 構成でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)」を参照してください。  
+  
+### サービスで BasicHttpBinding が使用されるようにコードで指定するには  
+  
+1.  サービスの種類にサービス コントラクトを定義します。  
+  
+     [!code-csharp[C_HowTo_CodeServiceBinding#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#1)]
+     [!code-vb[C_HowTo_CodeServiceBinding#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#1)]  
+  
+2.  サービス クラスにサービス コントラクトを実装します。  
+  
+     [!code-csharp[C_HowTo_CodeServiceBinding#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#2)]
+     [!code-vb[C_HowTo_CodeServiceBinding#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#2)]  
+  
+3.  ホスト アプリケーションで、サービスのベース アドレスとサービスで使用するバインディングを作成します。  
+  
+     [!code-csharp[C_HowTo_CodeServiceBinding#3](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#3)]
+     [!code-vb[C_HowTo_CodeServiceBinding#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#3)]  
+  
+4.  サービスのホストを作成し、エンドポイントを追加して、ホストを開きます。  
+  
+     [!code-csharp[C_HowTo_CodeServiceBinding#4](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#4)]
+     [!code-vb[C_HowTo_CodeServiceBinding#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#4)]  
+  
+### バインディング プロパティの既定値を変更するには  
+  
+1.  <xref:System.ServiceModel.BasicHttpBinding> クラスの既定のプロパティ値を変更するには、ホストを作成する前に、バインディングのプロパティ値を新しい値に設定します。たとえば、開くおよび閉じる操作の既定のタイムアウト値を 1 分から 2 分に変更するには、次のようにします。  
+  
+     [!code-csharp[C_HowTo_CodeServiceBinding#5](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_codeservicebinding/cs/source.cs#5)]
+     [!code-vb[C_HowTo_CodeServiceBinding#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_codeservicebinding/vb/source.vb#5)]  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md b/docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md
new file mode 100644
index 00000000000..ac0064c3f21
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md
@@ -0,0 +1,102 @@
+---
+title: "方法 : 構成でサービス バインディングを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 885037f7-1c2b-4d7a-90d9-06b89be172f2
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 方法 : 構成でサービス バインディングを指定する
+この例では、簡単な電卓サービス用に `ICalculator` コントラクトを定義し、そのサービスを `CalculatorService` クラスで実装し、そのエンドポイントを Web.config ファイルで構成します。このファイルでは、サービスが <xref:System.ServiceModel.BasicHttpBinding> を使用するように指定します。構成の代わりにコードを使用してこのサービスを構成する方法については、「[方法 : コード内でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-code.md)」を参照してください。  
+  
+ 通常、ベスト プラクティスは、コードで命令として記述するよりも、構成でバインディングを指定して情報を明示的にアドレス指定することです。展開済みサービスのバインディングおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。一般的に、バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。  
+  
+ 以下のすべての構成手順は、[構成エディター ツール \(SvcConfigEditor.exe\)](../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) を使用して実行できます。  
+  
+ この例のソースのコピーについては、「[BasicBinding](../../../docs/framework/wcf/samples/basicbinding.md)」を参照してください。  
+  
+### サービスの構成で BasicHttpBinding が使用されるように指定するには  
+  
+1.  サービスの種類にサービス コントラクトを定義します。  
+  
+     [!code-csharp[C_HowTo_ConfigureServiceBinding#1](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureservicebinding/cs/source.cs#1)]
+     [!code-vb[C_HowTo_ConfigureServiceBinding#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_configureservicebinding/vb/source.vb#1)]  
+  
+2.  サービス クラスにサービス コントラクトを実装します。  
+  
+     [!code-csharp[C_HowTo_ConfigureServiceBinding#2](../../../samples/snippets/csharp/VS_Snippets_CFX/c_howto_configureservicebinding/cs/source.cs#2)]
+     [!code-vb[C_HowTo_ConfigureServiceBinding#2](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_howto_configureservicebinding/vb/source.vb#2)]  
+  
+    > [!NOTE]
+    >  アドレス情報とバインディング情報は、サービスの実装内では指定されません。また、構成ファイルからこの情報を取得するためのコードを記述する必要もありません。  
+  
+3.  <xref:System.ServiceModel.WSHttpBinding> を使用する `CalculatorService` のエンドポイントを構成する Web.config ファイルを作成します。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <system.serviceModel>  
+        <services>  
+          <service name=" CalculatorService" >  
+            <endpoint   
+            <-- Leave the address blank to be populated by default-->  
+            <--from the hosting environment,in this case IIS, so -->  
+            <-- the address will just be that of the IIS Virtual -->  
+            <--Directory.-->  
+                address=""   
+            <--Specify the binding type -->  
+                binding="wsHttpBinding"  
+            <--Specify the binding configuration name for that -->  
+            <--binding type. This is optional but useful if you  -->  
+            <--want to modify the properties of the binding. -->  
+            <--The bindingConfiguration name Binding1 is defined  -->  
+            <--below in the bindings element.  -->  
+                bindingConfiguration="Binding1"  
+                contract="ICalculator" />  
+          </service>  
+        </services>  
+        <bindings>  
+          <wsHttpBinding>  
+            <binding name="Binding1">  
+              <-- Binding property values can be modified here. -->  
+              <--See the next procedure. -->  
+            </binding>  
+          </wsHttpBinding>  
+       </bindings>  
+      </system.serviceModel>  
+    </configuration>  
+  
+    ```  
+  
+4.  次の行を含む Service.svc ファイルを作成し、インターネット インフォメーション サービス \(IIS: Internet Information Services\) 仮想ディレクトリに配置します。  
+  
+    ```  
+    <%@ServiceHost language=c# Service="CalculatorService" %>   
+    ```  
+  
+### バインディング プロパティの既定値を変更するには  
+  
+1.  <xref:System.ServiceModel.WSHttpBinding> の既定のプロパティ値を変更するには、[\<wsHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素内に `<binding name="Binding1">` という新しいバインディング構成名を作成し、このバインド要素のバインディングの属性に新しい値を設定します。たとえば、開く操作と閉じる操作の既定のタイムアウト値を 1 分から 2 分に変更するには、構成ファイルに以下を追加します。  
+  
+    ```  
+    <wsHttpBinding>  
+      <binding name="Binding1"  
+               closeTimeout="00:02:00"  
+               openTimeout="00:02:00">  
+      </binding>  
+    </wsHttpBinding>  
+    ```  
+  
+## 参照  
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [エンドポイント アドレスの指定](../../../docs/framework/wcf/specifying-an-endpoint-address.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-client-credential-values.md b/docs/framework/wcf/how-to-specify-client-credential-values.md
new file mode 100644
index 00000000000..909a669fb7d
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-client-credential-values.md
@@ -0,0 +1,115 @@
+---
+title: "方法 : クライアントの資格情報の値を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82293d7f-471a-4549-8f19-0be890e7b074
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 方法 : クライアントの資格情報の値を指定する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、サービスに対するクライアントの認証方法を指定できます。  たとえば、証明書を使用してクライアントを認証するように指定できます。  
+  
+### クライアント資格情報の種類を特定するには  
+  
+1.  サービスのメタデータ エンドポイントからメタデータを取得します。  一般的に、メタデータは、選択したプログラミング言語 \(既定は Visual C\#\) のクライアント コードおよび XML 構成ファイルという 2 つのファイルで構成されています。  メタデータは、クライアント コードおよびクライアント構成を返す Svcutil.exe ツールを使用して取得できます。  詳細については、「[メタデータを取得する](../../../docs/framework/wcf/feature-details/retrieving-metadata.md)」および「[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)」を参照してください。  
+  
+2.  XML 構成ファイルを開きます。  Svcutil.exe ツールを使用する場合、ファイルの既定の名前は、Output.config です。  
+  
+3.  **mode** 属性のある **\<security\>** 要素 \(**\<security mode \=** `MessageOrTransport`**\>**\) を見つけます。ここで、`MessageOrTransport` は、セキュリティ モードの 1 つに設定されています。  
+  
+4.  mode 値に一致する子要素を見つけます。  たとえば、mode が **Message** に設定されている場合、**\<security\>** 要素に含まれる **\<message\>** 要素を見つけます。  
+  
+5.  **clientCredentialType** 属性に割り当てられている値に注意します。  実際の値は、使用されているモード \(トランスポートまたはメッセージ\) に依存します。  
+  
+ 次の XML コードは、メッセージ セキュリティを使用し、クライアントの認証に証明書を要求するクライアントの構成を示します。  
+  
+```  
+<security mode="Message">  
+    <transport clientCredentialType="Windows" proxyCredentialType="None"  
+        realm="" />  
+     <message clientCredentialType="Certificate" negotiateServiceCredential="true"  
+    algorithmSuite="Default" establishSecurityContext="true" />  
+</security>  
+```  
+  
+## 例: クライアント資格情報としての証明書による TCP トランスポート モード  
+ この例では、セキュリティ モードを "Transport \(トランスポート\)" モードに設定し、クライアント資格情報の値を X.509 証明書に設定します。  次の手順では、クライアントでクライアント資格情報の値をコードと構成を使用して設定する方法を示します。  ここでは、サービスからメタデータ \(コードと構成\) を返すために [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用していることを前提としています。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)。  
+  
+#### クライアントでクライアント資格情報の値をコードによって指定するには  
+  
+1.  サービスからコードと構成を生成するために [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用します。  
+  
+2.  生成されたコードを使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントのインスタンスを作成します。  
+  
+3.  クライアント クラスで、<xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> クラスの <xref:System.ServiceModel.ClientBase%601> プロパティを適切な値に設定します。  この例では、<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> クラスの <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential> メソッドを使用して、このプロパティを X.509 証明書に設定します。  
+  
+     [!code-csharp[c_TcpService#4](../../../samples/snippets/csharp/VS_Snippets_CFX/c_tcpservice/cs/source.cs#4)]
+     [!code-vb[c_TcpService#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_tcpservice/vb/source.vb#4)]  
+  
+     <xref:System.Security.Cryptography.X509Certificates.X509FindType> クラスの任意の列挙体を使用できます。  ここでは、有効期限が切れて証明書が変更された場合に備えて、サブジェクト名を使用しています。  サブジェクト名を使用することにより、インフラストラクチャは証明書を再検索できます。  
+  
+#### クライアントでクライアント資格情報の値を構成によって指定するには  
+  
+1.  [\<behavior\>](../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md) 要素を [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素に追加します。  
+  
+2.  [\<clientCredentials\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素を [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) 要素に追加します。  `name` 属性 \(必須\) を適切な値に必ず設定してください。  
+  
+3.  [\<clientCertificate\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md) 要素を [\<clientCredentials\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素に追加します。  
+  
+4.  次のコードに示すように、`storeLocation`、`storeName`、`x509FindType`、および `findValue` の各属性を適切な値に設定します。  証明書の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[証明書の使用](../../../docs/framework/wcf/feature-details/working-with-certificates.md)」を参照してください。  
+  
+    ```  
+    <behaviors>  
+       <endpointBehaviors>  
+          <behavior name="endpointCredentialBehavior">  
+            <clientCredentials>  
+              <clientCertificate findValue="Contoso.com"   
+                                 storeLocation="LocalMachine"  
+                                 storeName="TrustedPeople"  
+                                 x509FindType="FindBySubjectName" />  
+            </clientCredentials>  
+          </behavior>  
+       </endpointBehaviors>  
+    </behaviors>  
+    ```  
+  
+5.  クライアントを構成するときは、次のコードに示すように、`behaviorConfiguration` 要素の `<endpoint>` 属性を設定して動作を指定します。  エンドポイント要素は [\<client\>](../../../docs/framework/configure-apps/file-schema/wcf/client.md) 要素の子です。  また、`bindingConfiguration` 属性をクライアントのバインディングに設定することにより、バインディング構成の名前を指定します。  生成された構成ファイルを使用している場合は、バインディングの名前は自動的に生成されます。  この例では、名前は `"tcpBindingWithCredential"` です。  
+  
+    ```  
+    <client>  
+      <endpoint name =""  
+                address="net.tcp://contoso.com:8036/aloha"  
+                binding="netTcpBinding"  
+                bindingConfiguration="tcpBindingWithCredential"  
+                behaviorConfiguration="endpointCredentialBehavior" />  
+    </client>  
+    ```  
+  
+## 参照  
+ <xref:System.ServiceModel.NetTcpBinding>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential.SetCertificate%2A>   
+ <xref:System.ServiceModel.Security.X509CertificateRecipientServiceCredential>   
+ <xref:System.ServiceModel.ClientBase%601>   
+ <xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential>   
+ [WCF セキュリティのプログラミング](../../../docs/framework/wcf/feature-details/programming-wcf-security.md)   
+ [資格情報の種類の選択](../../../docs/framework/wcf/feature-details/selecting-a-credential-type.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [証明書の使用](../../../docs/framework/wcf/feature-details/working-with-certificates.md)   
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [\<netTcpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)   
+ [\<security\>](../../../docs/framework/configure-apps/file-schema/wcf/security-of-nettcpbinding.md)   
+ [\<message\>](../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-nettcpbinding.md)   
+ [\<behavior\>](../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)   
+ [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md)   
+ [\<clientCertificate\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-servicecredentials.md)   
+ [\<clientCredentials\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-specify-the-client-credential-type.md b/docs/framework/wcf/how-to-specify-the-client-credential-type.md
new file mode 100644
index 00000000000..da5c56403af
--- /dev/null
+++ b/docs/framework/wcf/how-to-specify-the-client-credential-type.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : クライアントの資格情報の種類を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セキュリティ資格情報, SOAP メッセージへの追加"
+  - "WCF, セキュリティ"
+ms.assetid: 10f51bee-5f92-4c1a-9126-fa5418535d8f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 方法 : クライアントの資格情報の種類を指定する
+セキュリティ モード \(トランスポートまたはメッセージ\) を設定してから、クライアント資格情報の種類を指定することができます。このプロパティでは、クライアントが認証時にサービスに提供する必要のある資格情報の種類を指定します。セキュリティ モードの設定 \(クライアントの資格情報の種類を設定する前に必要な手順\) [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法 : セキュリティ モードを設定する](../../../docs/framework/wcf/how-to-set-the-security-mode.md)」を参照してください。  
+  
+### コードでクライアント資格情報の種類を設定するには  
+  
+1.  サービスで使用されるバインドのインスタンスを作成します。この例では、<xref:System.ServiceModel.WSHttpBinding> バインドを使用します。  
+  
+2.  <xref:System.ServiceModel.WSHttpSecurity.Mode%2A> プロパティに適切な値を設定します。この例では、メッセージ モードを使用します。  
+  
+3.  <xref:System.ServiceModel.MessageSecurityOverHttp.ClientCredentialType%2A> プロパティに適切な値を設定します。この例では、Windows 認証 \(<xref:System.ServiceModel.MessageCredentialType>\) を使用するように設定します。  
+  
+     [!code-csharp[c_ProgrammingSecurity#14](../../../samples/snippets/csharp/VS_Snippets_CFX/c_programmingsecurity/cs/source.cs#14)]
+     [!code-vb[c_ProgrammingSecurity#14](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_programmingsecurity/vb/source.vb#14)]  
+  
+### 構成でクライアント資格情報の種類を設定するには  
+  
+1.  [\<system.serviceModel\>](../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素を構成ファイルに追加します。  
+  
+2.  子要素として [\<bindings\>](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) 要素を追加します。  
+  
+3.  適切なバインドを追加します。この例では、[\<wsHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素を使用します。  
+  
+4.  [\<binding\>](../../../docs/framework/misc/binding.md) 要素を追加し、`name` 属性に適切な値を設定します。この例では、"SecureBinding" という名前を使用します。  
+  
+5.  `<security>` バインドを追加します。`mode` 属性を適切な値に設定します。この例では、`"Message"` に設定します。  
+  
+6.  セキュリティ モードによって、`<message>` 要素と `<transport>` 要素のどちらかを追加します。`clientCredentialType` 属性を適切な値に設定します。この例では、`"Windows"` を使用します。  
+  
+    ```  
+    <system.serviceModel>  
+      <bindings>  
+        <wsHttpBinding>  
+          <binding name="SecureBinding">  
+            <security mode="Message">  
+                 <message clientCredentialType="Windows" />  
+             </security>  
+          </binding>  
+        </wsHttpBinding>  
+      </bindings>  
+    </system.serviceModel>  
+    ```  
+  
+## 参照  
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)   
+ [方法 : セキュリティ モードを設定する](../../../docs/framework/wcf/how-to-set-the-security-mode.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/how-to-use-a-wcf-client.md b/docs/framework/wcf/how-to-use-a-wcf-client.md
new file mode 100644
index 00000000000..0a70b472bc5
--- /dev/null
+++ b/docs/framework/wcf/how-to-use-a-wcf-client.md
@@ -0,0 +1,176 @@
+---
+title: "方法 : Windows Communication Foundation クライアントを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF クライアント [WCF], 使用"
+ms.assetid: 190349fc-0573-49c7-bb85-8e316df7f31f
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# 方法 : Windows Communication Foundation クライアントを使用する
+これは、基本的な [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの作成に必要な 6 つのタスクのうち、最後のタスクです。  6 つのすべてのタスクの概要については、「[チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)」を参照してください。  
+  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] プロキシを作成して構成したら、クライアント インスタンスを作成できます。また、クライアント アプリケーションをコンパイルし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとの通信に使用できます。  このトピックでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントをインスタンス化し、使用する手順について説明します。  この手順は、次の 3 つの手順で構成されます。  
+  
+1.  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントをインスタンス化します。  
+  
+2.  生成されたプロキシからサービス操作を呼び出します。  
+  
+3.  操作の呼び出しが完了したらクライアントを閉じます。  
+  
+### Windows Communication Foundation クライアントを使用するには  
+  
+1.  GettingStartedClient プロジェクトの Program.cs ファイルまたは Program.vb ファイルを開き、既存のコードを次のコードで置き換えます。  
+  
+    ```  
+    using System;  
+    using System.Collections.Generic;  
+    using System.Linq;  
+    using System.Text;  
+    using GettingStartedClient.ServiceReference1;  
+  
+    namespace GettingStartedClient  
+    {  
+        class Program  
+        {  
+            static void Main(string[] args)  
+            {  
+                //Step 1: Create an instance of the WCF proxy.  
+                CalculatorClient client = new CalculatorClient();  
+  
+                // Step 2: Call the service operations.  
+                // Call the Add service operation.  
+                double value1 = 100.00D;  
+                double value2 = 15.99D;  
+                double result = client.Add(value1, value2);  
+                Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Subtract service operation.  
+                value1 = 145.00D;  
+                value2 = 76.54D;  
+                result = client.Subtract(value1, value2);  
+                Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Multiply service operation.  
+                value1 = 9.00D;  
+                value2 = 81.25D;  
+                result = client.Multiply(value1, value2);  
+                Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+                // Call the Divide service operation.  
+                value1 = 22.00D;  
+                value2 = 7.00D;  
+                result = client.Divide(value1, value2);  
+                Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+                //Step 3: Closing the client gracefully closes the connection and cleans up resources.  
+                client.Close();  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+    ```  
+    Imports System  
+    Imports System.Collections.Generic  
+    Imports System.Text  
+    Imports System.ServiceModel  
+    Imports GettingStartedClientVB2.ServiceReference1  
+  
+    Module Module1  
+  
+        Sub Main()  
+            ' Step 1: Create an instance of the WCF proxy  
+            Dim Client As New CalculatorClient()  
+  
+            'Step 2: Call the service operations.  
+            'Call the Add service operation.  
+            Dim value1 As Double = 100D  
+            Dim value2 As Double = 15.99D  
+            Dim result As Double = Client.Add(value1, value2)  
+            Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)  
+  
+            'Call the Subtract service operation.  
+            value1 = 145D  
+            value2 = 76.54D  
+            result = Client.Subtract(value1, value2)  
+            Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)  
+  
+            'Call the Multiply service operation.  
+            value1 = 9D  
+            value2 = 81.25D  
+            result = Client.Multiply(value1, value2)  
+            Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)  
+  
+            'Call the Divide service operation.  
+            value1 = 22D  
+            value2 = 7D  
+            result = Client.Divide(value1, value2)  
+            Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)  
+  
+            ' Step 3: Closing the client gracefully closes the connection and cleans up resources.  
+            Client.Close()  
+  
+            Console.WriteLine()  
+            Console.WriteLine("Press <ENTER> to terminate client.")  
+            Console.ReadLine()  
+  
+        End Sub  
+  
+    End Module  
+  
+    ```  
+  
+     GettingStartedClient.ServiceReference1 をインポートする using または imports ステートメントに注意してください。  これによって、Visual Studio の "サービス参照の追加" によって生成されたコードがインポートされます。  そのコードは WCF プロキシをインスタンス化してから、電卓サービスによって公開されている各サービス操作を呼び出し、プロキシを閉じて終了します。  
+  
+ これで、チュートリアルは終了です。  サービス コントラクトの定義、サービス コントラクトの実装、WCF プロキシの生成、WCF クライアント アプリケーションの構成、そしてプロキシの使用によるサービス操作の呼び出しを行いました。  アプリケーションをテストするには、まず GettingStartedHost を実行してサービスを開始し、次に GettingStartedClient を実行します。  GettingStartedHost からの出力は、次のようになります。  
+  
+```Output  
+  
+            サービスの準備は整っています。  サービスを終了するには、<Enter> キーを押します。  Received Add(100,15.99)  
+Return: 115.99  
+Received Subtract(145,76.54)  
+Return: 68.46  
+Received Multiply(9,81.25)  
+Return: 731.25  
+Received Divide(22,7)  
+Return: 3.14285714285714    
+```  
+  
+ GettingStartedClient からの出力は、次のようになります。  
+  
+```Output  
+  
+            Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+クライアントを終了するには、<Enter> キーを押します。  
+  
+```  
+  
+## 参照  
+ [クライアントを構築する](../../../docs/framework/wcf/building-clients.md)   
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)   
+ [チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)   
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [方法 : 双方向コントラクトを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-duplex-contract.md)   
+ [方法 : 双方向コントラクトを使用してサービスにアクセスする](../../../docs/framework/wcf/feature-details/how-to-access-services-with-a-duplex-contract.md)   
+ [概要](../../../docs/framework/wcf/samples/getting-started-sample.md)   
+ [自己ホスト](../../../docs/framework/wcf/samples/self-host.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/implementing-service-contracts.md b/docs/framework/wcf/implementing-service-contracts.md
new file mode 100644
index 00000000000..3e514c3ff93
--- /dev/null
+++ b/docs/framework/wcf/implementing-service-contracts.md
@@ -0,0 +1,74 @@
+---
+title: "サービス コントラクトの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "サービス コントラクトの実装 [WCF]"
+ms.assetid: aefb6f56-47e3-4f24-ab0a-9bc07bf9885f
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# サービス コントラクトの実装
+サービスは、1 つ以上のエンドポイントでクライアントが使用できる機能を公開するクラスです。サービスを作成するには、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] コントラクトを実装するクラスを記述します。2 つの方法のいずれかでこれを行うことができます。コントラクトを個別にインターフェイスとして定義し、そのインターフェイスを実装するクラスを作成できます。または、クラスに <xref:System.ServiceModel.ServiceContractAttribute> 属性を配置し、サービスのクライアントが使用できるメソッドに <xref:System.ServiceModel.OperationContractAttribute> 属性を配置することによって、クラスとコントラクトを直接作成することもできます。  
+  
+## サービス クラスの作成  
+ 個別に定義された `IMath` コントラクトを実装するサービスの例を次に示します。  
+  
+```csharp  
+// Define the IMath contract.  
+[ServiceContract]  
+public interface IMath  
+{  
+    [OperationContract]   
+    double Add(double A, double B);  
+  
+    [OperationContract]  
+    double Multiply (double A, double B);  
+}  
+  
+// Implement the IMath contract in the MathService class.  
+public class MathService : IMath  
+{  
+    public double Add (double A, double B) { return A + B; }  
+    public double Multiply (double A, double B) { return A * B; }  
+}  
+```  
+  
+ また、サービスは直接コントラクトを公開できます。`MathService` コントラクトを定義し、実装するサービス クラスの例を次に示します。  
+  
+```csharp  
+// Define the MathService contract directly on the service class.  
+[ServiceContract]  
+class MathService  
+{  
+    [OperationContract]  
+    public double Add(double A, double B) { return A + B; }  
+    [OperationContract]  
+    private double Multiply (double A, double B) { return A * B; }  
+}  
+```  
+  
+ コントラクト名が異なるので、上記の 2 つのサービスが公開するコントラクトはそれぞれ異なります。最初の例では、公開されるコントラクトの名前が "`IMath`" であるのに対し、2 番目の例では、コントラクトの名前は "`MathService`" です。  
+  
+ 同時実行やインスタンス化など、いくつかの項目は、サービス実装レベルと操作実装レベルで設定できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md).  
+  
+ サービス コントラクトを実装したら、そのサービスに 1 つ以上のエンドポイントを作成する必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md).サービスの実行方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+## 参照  
+ [サービスの設計と実装](../../../docs/framework/wcf/designing-and-implementing-services.md)   
+ [方法 : コントラクト クラスを使用してサービスを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-wcf-contract-with-a-class.md)   
+ [方法 : コントラクト インターフェイスを使用してサービスを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-with-a-contract-interface.md)   
+ [サービスのランタイム動作の指定](../../../docs/framework/wcf/specifying-service-run-time-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/index.md b/docs/framework/wcf/index.md
new file mode 100644
index 00000000000..71105316342
--- /dev/null
+++ b/docs/framework/wcf/index.md
@@ -0,0 +1,91 @@
+---
+title: "Windows Communication Foundation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF [WCF]"
+  - "Windows Communication Foundation [WCF]"
+ms.assetid: 96aad289-58bc-4389-89d0-b09dfc4d5c58
+caps.latest.revision: 2
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows Communication Foundation
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は、サービス指向のアプリケーションを構築するための Microsoft の統一プログラミング モデルです。  これを使用して開発者は、プラットフォーム間を統合し、既存のコンポーネントと相互運用する、セキュリティで保護された信頼性の高いトランザクション型のソリューションを構築できます。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation 4.5 の新機能](../../../docs/framework/wcf/whats-new.md)  
+ Windows Communication Foundation の新機能について説明します。  
+  
+ [WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md)  
+ WCF アプリケーションの作成を容易にする新しい機能について説明します。  
+  
+ [ドキュメントのガイド](../../../docs/framework/wcf/guide-to-the-documentation.md)  
+ WCF ドキュメントの説明があります。  
+  
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)  
+ Windows Communication Foundation \(WCF\) メッセージング システムおよびその使用をサポートしているクラスの概要について説明します。  
+  
+ [チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)  
+ WCF サービスとクライアントを作成する手順のチュートリアルです。  
+  
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)  
+ Windows Communication Foundation アプリケーションを作成するための基礎について説明します。  
+  
+ [WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)  
+ 必要な [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 機能を選択するためのトピックを示します。  
+  
+ [WCF の拡張](../../../docs/framework/wcf/extending/extending-wcf.md)  
+ WCF ランタイム コンポーネントを変更および拡張する方法について説明します。  
+  
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)  
+ Windows Communication Foundation \(WCF\) アプリケーションの作成のガイドラインを提供します。  
+  
+ [管理と診断](../../../docs/framework/wcf/diagnostics/index.md)  
+ WCF の診断機能について説明します。  
+  
+ [システム要件](../../../docs/framework/wcf/wcf-system-requirements.md)  
+ WCF の実行に必要なシステム要件について説明します。  
+  
+ [WCF に必要なオペレーティング システム リソース](../../../docs/framework/wcf/operating-system-resources-required-by-wcf.md)  
+ WCF に必要なオペレーティング システム リソースについて説明します。  
+  
+ [セットアップ問題のトラブルシューティング](../../../docs/framework/wcf/troubleshooting-setup-issues.md)  
+ WCF のセットアップの問題に対処するためのガイダンスを示します。  
+  
+ [.NET リモート処理から WCF への移行](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md)  
+ .NET リモート処理と WCF を比較し、一般的なシナリオ用の移行のガイダンスを提供します。  
+  
+ [WCF 開発ツールの使用](../../../docs/framework/wcf/using-the-wcf-development-tools.md)  
+ WCFservice の開発に役立つ Visual Studio Windows Communication Foundation 開発ツールについて説明します。  
+  
+ [Windows Communication Foundation ツール](../../../docs/framework/wcf/tools.md)  
+ WCF アプリケーションの作成、展開、および管理を簡単に行えるように設計されている WCF ツールについて説明します。  
+  
+ [Windows Communication Foundation サンプル](../../../docs/framework/wcf/samples/index.md)  
+ Windows Communication Foundation のさまざまな特性について説明するサンプルがあります。  
+  
+ [Windows Communication Foundation 用語集](../../../docs/framework/wcf/glossary.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に固有の用語の一覧を示します。  
+  
+ [一般的なリファレンス](../../../docs/framework/wcf/general-reference.md)  
+ このセクションでは、Windows Communication Foundation のクライアントおよびサービスの設定に使用される要素について説明します。  
+  
+ [フィードバックとコミュニティ](../../../docs/framework/wcf/feedback-and-community.md)  
+ Windows Communication Foundation に関するフィードバックを提供する方法についての情報です。  
+  
+ [プライバシー情報](../../../docs/framework/wcf/privacy-information.md)  
+ WCF とプライバシーに関する情報があります。  
+  
+## 関連項目  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wcf/interpreting-error-codes-returned-by-wsatconfig-exe.md b/docs/framework/wcf/interpreting-error-codes-returned-by-wsatconfig-exe.md
new file mode 100644
index 00000000000..425a1e8b439
--- /dev/null
+++ b/docs/framework/wcf/interpreting-error-codes-returned-by-wsatconfig-exe.md
@@ -0,0 +1,78 @@
+---
+title: "wsatConfig.exe によって返されたエラー コードの解釈 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab65f22b-0d69-4c21-9aaf-74acef0ca102
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# wsatConfig.exe によって返されたエラー コードの解釈
+ここでは、WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\) によって生成されるすべてのエラー コードと、実行する必要のある推奨アクションを示します。  
+  
+## エラー コードの一覧  
+  
+|エラー コード|説明|実行する必要のある推奨アクション|  
+|-------------|--------|----------------------|  
+|0|操作は成功しました。|なし|  
+|1|予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+|2|MSDTC に問い合わせて、セキュリティ設定を取得しようとしたときに、予期しないエラーが発生しました。|MSDTC サービスが無効になっていないことを確認し、返された例外に示されているすべての問題を解決します。|  
+|3|WsatConfig.exe が実行されていたアカウントに、ネットワーク セキュリティ設定を読み取るために必要なアクセス許可がありませんでした。|管理者ユーザー アカウントで WsatConfig.exe を実行します。|  
+|4|WS\-AT サポートの有効化を試みる前に、MSDTC の "ネットワーク DTC アクセス" を有効にします。|MSDTC の "ネットワーク DTC アクセス" を有効にして、ユーティリティを再実行します。|  
+|5|入力したポートが有効範囲にありません。値は 1 ～ 65535 の範囲になければなりません。|`-port:<portNum>`<br /><br /> コマンド ライン オプションを、エラー メッセージの指示に従って修正します。|  
+|6|コマンド ラインで、無効なエンドポイント証明書が指定されました。証明書が見つからなかったか、または検証を通過しませんでした。|`-endpointCert` コマンド ライン オプションを修正します。証明書に秘密キーがあること、ClientAuthentication および ServerAuthentication の両方での使用を目的としていること、LocalMachine\\MY 証明書ストアにインストールされていること、および完全に信頼されていることを確認します。|  
+|7|コマンド ラインで、無効なアカウント証明書が指定されました。|`-accountsCerts` コマンド ライン オプションを修正します。証明書が正しく指定されていないか、または見つかりませんでした。|  
+|8|既定のタイムアウトが、1 ～ 3600 秒の範囲内にありません。|指示のとおり、適切なタイムアウト値を入力します。|  
+|10|レジストリにアクセスしようとしたときに、予期しないエラーが発生しました。|エラー メッセージとエラー コードを調べて、アクション可能な項目を見つけます。|  
+|11|レジストリに書き込めません。|エラー メッセージに示されているキーが、WsatConfig.exe が実行されているアカウントからのレジストリへのアクセスをサポートしていることを確認してください。|  
+|12|証明書ストアにアクセスしようとしたときに、予期しないエラーが発生しました。|返されたエラー コードを使用して、適切なシステム エラーにマップします。|  
+|13|http.sys の構成に失敗しました。MSDTC 用の新しい HTTPS ポートを予約できません。|返されたエラー コードを使用して、適切なシステム エラーにマップします。|  
+|14|http.sys の構成に失敗しました。MSDTC 用の HTTPS ポートの予約を解除できません。|返されたエラー コードを使用して、適切なシステム エラーにマップします。|  
+|15|http.sys の構成に失敗しました。指定したポートに、以前の HTTPS ポートの予約が既に存在します。|別のアプリケーションが既に特定のポートを所有しています。別のポートへの変更、アンインストール、または現在のアプリケーションの再構成を行います。|  
+|16|http.sys の構成に失敗しました。指定した証明書をポートにバインドできません。|エラー メッセージで返されたエラー コードを使用して、適切なシステム エラーにマップします。|  
+|17|http.sys の構成に失敗しました。以前のポートから SSL 証明書をバインド解除できません。|エラー メッセージで返されたエラー コードを使用して、適切なシステム エラーにマップします。必要に応じて、httpcfg.exe または netsh.exe を使用して、誤ったポートの予約を解除します。|  
+|18|http.sys の構成に失敗しました。以前の SSL バインディングが既に存在するため、指定した証明書をポートにバインドできません。|別のアプリケーションが既に特定のポートを所有しています。別のポートへの変更、アンインストール、または現在のアプリケーションの再構成を行います。|  
+|19|MSDTC の再起動に失敗しました。|必要に応じて、MSDTC を手動で再起動します。問題が解決されない場合は、マイクロソフトにお問い合わせください。|  
+|20|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] がリモート コンピューターにインストールされていないか、または正しくインストールされていません。|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] をコンピューターにインストールします。|  
+|21|操作タイムアウトにより、リモート構成が失敗しました。|リモート コンピューターの WS\-AT を構成するための呼び出しにかかる時間は、90 秒を超えます。|  
+|22|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] がリモート コンピューターにインストールされていないか、または正しくインストールされていません。|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] をコンピューターにインストールします。|  
+|23|リモート コンピューターでの例外により、リモート構成が失敗しました。|エラー メッセージを調べて、アクション可能な項目を見つけます。|  
+|26|WsatConfig.exe に渡された引数が無効です。|コマンド ラインを調べてエラーを見つけます。|  
+|27|`-accounts` コマンド ライン オプションが無効です。|\-`accounts` コマンド ライン オプションを修正して、ユーザー アカウントを正しく指定します。|  
+|28|`-network` コマンド ライン オプションが無効です。|`-network` コマンド ライン オプションを修正して、"enable" または "disable" を正しく指定します。|  
+|29|`-maxTimeout` コマンド ライン オプションが無効です。|`-maxTimeout` コマンド ライン オプションを指示のとおり修正します。|  
+|30|`-timeout` コマンド ライン オプションが無効です。|`-timeout` コマンド ライン オプションを指示のとおり修正します。|  
+|31|`-traceLevel` コマンド ライン オプションが無効です。|`-traceLevel` コマンド ライン オプションを修正して、以下から有効な値を指定します。<br /><br /> -   Off<br />-   Error<br />-   Critical<br />-   警告<br />-   情報<br />-   Verbose<br />-   すべて|  
+|32|`-traceActivity` コマンド ライン オプションが無効です。|"enable" または "disable" を指定して、`-traceActivity` コマンド ライン オプションを修正します。|  
+|33|`-traceProp` コマンド ライン オプションが無効です。|"enable" または "disable" を指定して、`-traceProp` コマンド ライン オプションを修正します。|  
+|34|`-tracePII` コマンド ライン オプションが無効です。|"enable" または "disable" を指定して、`-tracePII` コマンド ライン オプションを修正します。|  
+|37|WsatConfig.exe が、正確なコンピューターの証明書を特定できませんでした。このエラーは、複数の候補が存在するか、または候補が存在しない場合に発生する可能性があります。|証明書のサムプリントまたは Issuer\\SubjectName ペアを指定して、構成のための正確な証明書を正しく特定します。|  
+|38|プロセスまたはユーザーに、ファイアウォール構成を変更するために必要なアクセス許可がありません。|管理者ユーザー アカウントで WsatConfig.exe を実行します。|  
+|39|ファイアウォール構成の更新中に、WsatConfig.exe でエラーが発生しました。|エラー メッセージを調べて、アクション可能な項目を見つけます。|  
+|40|WsatConfig.exe が、MSDTC に、証明書の秘密キー ファイルの読み取りアクセス許可を付与できません。|管理者ユーザー アカウントで WsatConfig.exe を実行します。|  
+|41|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] のインストールが見つからないか、見つかったバージョンが、ツールで構成できるバージョンと一致しません。|[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] が正しくインストールされていて、そのバージョンの [!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] に付属の WsatConfig.exe ツールのみを使用して WS\-AT を構成していることを確認します。|  
+|42|引数がコマンド ラインで複数回指定されました。|WsatConfig.exe を実行する際は、各引数は一度だけ指定します。|  
+|43|WS\-AT が有効になっていない場合、WsatConfig.exe は WS\-AT 設定を更新できません。|追加のコマンド ライン引数として `-network:enable` を指定します。|  
+|44|必要な修正プログラムが見つかりません。修正プログラムがインストールされるまで、WS\-AT を構成できません。|必要な修正プログラムをインストールするための手順については、[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] のリリース ノートを参照してください。|  
+|45|`-virtualServer` コマンド ライン オプションが無効です。|構成するクラスター リソースのネットワーク名を指定して、`-virtualServer` コマンド ライン オプションを修正します。|  
+|46|ETW トレース セッションを開始しようとしたときに、予期しないエラーが発生しました。|返されたエラー コードを使用して、適切なシステム エラーにマップします。|  
+|47|プロセスまたはユーザーに、ETW トレース セッションを有効にするために必要なアクセス許可がありません。|管理者ユーザー アカウントで WsatConfig.exe を実行します。|  
+|48|ETW トレース セッションの開始中に、予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+|49|%systemdrive% の容量不足が原因で、新しいログ ファイルを作成できません。|%systemdrive% に、ログ ファイル用に必要な容量があることを確認します。|  
+|51|ETW トレース セッションの開始中に、予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+|52|ETW トレース セッションの開始中に、予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+|53|以前の ETW セッションのログ ファイルのバックアップに失敗しました。|%systemdrive% に、ログ ファイル用、および以前のログ ファイル \(ある場合\) のバックアップ用に必要な容量があることを確認します。必要に応じて、以前のログ ファイルを手動で削除します。|  
+|55|ETW トレース セッションの開始中に、予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+|56|ETW トレース セッションの開始中に、予期しないエラーが発生しました。|マイクロソフトにお問い合わせください。|  
+  
+## 参照  
+ [WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/introduction-to-extensibility.md b/docs/framework/wcf/introduction-to-extensibility.md
new file mode 100644
index 00000000000..a19780b9385
--- /dev/null
+++ b/docs/framework/wcf/introduction-to-extensibility.md
@@ -0,0 +1,63 @@
+---
+title: "拡張機能の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "機能拡張 [WCF]"
+  - "WCF [WCF], 機能拡張"
+  - "Windows Communication Foundation [WCF], 機能拡張"
+ms.assetid: ef56c251-d63c-4b3f-944f-b0c67bfb0f68
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 拡張機能の概要
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のアプリケーション モデルは、分散アプリケーションの大部分の通信要件に対応するように設計されています。  ただし、既定のアプリケーション モデルとシステム提供の実装でサポートされないシナリオが必ず存在します。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の拡張モデルでは、アプリケーション モデル全体の置き換えに至るまでのすべてのレベルでシステム動作を変更できるようにすることによって、カスタム シナリオをサポートします。  ここでは、拡張のさまざまな領域を提示し、各領域の詳細について説明します。  
+  
+## 拡張する領域  
+ 次の領域を拡張できます。  
+  
+-   アプリケーション ランタイム。  ここでは、アプリケーションについて、メッセージのディスパッチと処理を拡張します。  この領域には、セキュリティ システム、メタデータ システム、シリアル化システム、およびアプリケーションを基になるチャネル システムに接続するためのバインディングとバインド要素も含まれます。  
+  
+-   チャネルとチャネル ランタイム。  ここでは、メッセージ レベルで機能するシステムを拡張し、プロトコル、トランスポート、およびエンコーディングのサポートを提供します。  
+  
+-   ホスト ランタイム。  ここでは、チャネルおよびアプリケーション ランタイムとのホスト アプリケーション ドメインの関係を拡張します。  
+  
+### アプリケーション ランタイムの拡張  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションでは、対応するチャネル宛てのメッセージとアプリケーション宛てのメッセージを区別します。  チャネル メッセージは、セキュリティで保護されたメッセージ交換の確立や、信頼できるセッションの確立など、特定のチャネル関連の機能をサポートします。  このメッセージは、アプリケーション ランタイムでは使用できません。このメッセージは、アプリケーション層が関係する前に処理されます。  
+  
+ アプリケーション メッセージは、ユーザーまたはユーザーの顧客が作成したクライアントまたはサービスの操作向けのデータを含んでいます。  このメッセージは、必要に応じて、メッセージまたはオブジェクトの形でアプリケーション レベルの拡張システムで使用できます。  
+  
+ すべてのメッセージはチャネル システムを通過しますが、アプリケーション メッセージだけがチャネル システムからアプリケーションに渡されます。  新しいチャネル レベルの機能を作成するには、チャネル システムを拡張する必要があります。  新しいアプリケーション レベルの機能を作成するには、サービスまたはクライアントのランタイム \(それぞれディスパッチャーとチャネル ファクトリ\) を拡張する必要があります。  アプリケーション ランタイムの拡張[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ServiceHost とサービス モデル レイヤーの拡張](../../../docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md)」を参照してください。  
+  
+#### セキュリティの拡張  
+ トークンや資格情報などのカスタム セキュリティ機構を作成するには、セキュリティ システムを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [セキュリティの拡張](../../../docs/framework/wcf/extending/extending-security.md).  
+  
+#### メタデータの拡張  
+ メタデータを既定以外の方法で公開するには、メタデータ システムを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [メタデータ システムの拡張](../../../docs/framework/wcf/extending/extending-the-metadata-system.md).  
+  
+#### シリアル化の拡張  
+ カスタム エンコーダーの作成、データ サロゲートの提供、または転送されるデータのカスタマイズに関するその他の作業を行うには、シリアル化システムを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [エンコーダーとシリアライザーの拡張](../../../docs/framework/wcf/extending/extending-encoders-and-serializers.md).  
+  
+#### バインディングの拡張  
+ トランスポート チャネルまたはプロトコル チャネルをアプリケーション層に関連付けるには、バインディング システムを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [バインディングの拡張](../../../docs/framework/wcf/extending/extending-bindings.md).  
+  
+### チャネル システムの拡張  
+ カスタム トランスポートまたはプロトコル機能をサポートするチャネルを作成するには、「[チャネル レイヤーの拡張](../../../docs/framework/wcf/extending/extending-the-channel-layer.md)」を参照してください。  
+  
+### サービス ホスト システムの拡張  
+ サービス全体のアプリケーション モデルを変更するには、<xref:System.ServiceModel.ServiceHostBase?displayProperty=fullName> クラスを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [ServiceHost とサービス モデル レイヤーの拡張](../../../docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md).  
+  
+ ホスト アプリケーション ドメインとサービス ホストとの関係を変更するには、<xref:System.ServiceModel.Activation.ServiceHostFactory?displayProperty=fullName> クラスを拡張する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [ServiceHostFactory を使用したホストの拡張](../../../docs/framework/wcf/extending/extending-hosting-using-servicehostfactory.md).  
+  
+## 参照  
+ [WCF の拡張](../../../docs/framework/wcf/extending/extending-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/load-balancing.md b/docs/framework/wcf/load-balancing.md
new file mode 100644
index 00000000000..c4ffd1855ce
--- /dev/null
+++ b/docs/framework/wcf/load-balancing.md
@@ -0,0 +1,103 @@
+---
+title: "負荷分散 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "負荷分散 [WCF]"
+ms.assetid: 148e0168-c08d-4886-8769-776d0953b80f
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 負荷分散
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションの処理能力を増加する方法の 1 つは、アプリケーションを負荷分散されたサーバー ファームに配置することでスケール アウトすることです。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションは、ハードウェア ベースの負荷分散アプリケーションの他に Windows Network Load Balancing のようなソフトウェアによる負荷分散も含む、標準的な負荷分散手法を使用して負荷分散することが可能です。  
+  
+ 以下のセクションでは、システム提供の各種のバインディングを使用して構築された [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションを負荷分散するときの考慮事項について説明します。  
+  
+## 基本 HTTP バインディングによる負荷分散  
+ 負荷分散の面から見た場合、<xref:System.ServiceModel.BasicHttpBinding> を使用して通信を行う [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションと、他の一般的なタイプの HTTP ネットワーク トラフィック \(静的な HTML コンテンツ、ASP.NET ページ、ASMX Web サービス\) との相違はありません。このバインディングを使用する [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] チャネルは本質的に状態がなく、チャネルが閉じると接続を終了します。したがって、<xref:System.ServiceModel.BasicHttpBinding> には既存の HTTP 負荷分散の手法で十分に対応できます。  
+  
+ 既定では、<xref:System.ServiceModel.BasicHttpBinding> は、メッセージの接続 HTTP ヘッダーで `Keep-Alive` 値を送信することで、サポートするサービスにクライアントが永続的な接続を確立できるようにします。この構成では、以前に確立した接続を再使用して同じサーバーへの後続するメッセージを送信できるため、スループットが向上します。ただし、接続を再使用すると、クライアントが負荷分散ファーム内の特定サーバーと強く関連付けられてしまうため、ラウンドロビン方式の負荷分散の効果を損ねることがあります。これを回避するには、<xref:System.ServiceModel.Channels.CustomBinding> またはユーザー定義の <xref:System.ServiceModel.Channels.Binding> で <xref:System.ServiceModel.Channels.HttpTransportBindingElement.KeepAliveEnabled%2A> プロパティを使用して、サーバーの HTTP `Keep-Alive` を無効にできます。構成を使用してこれを行う例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  
+ <system.serviceModel>  
+  <services>  
+   <service   
+     name="Microsoft.ServiceModel.Samples.CalculatorService"  
+     behaviorConfiguration="CalculatorServiceBehavior">  
+     <host>  
+      <baseAddresses>  
+       <add baseAddress="http://localhost:8000/servicemodelsamples/service"/>  
+      </baseAddresses>  
+     </host>  
+    <!-- configure http endpoint, use base address provided by host  
+         And the customBinding -->  
+     <endpoint address=""  
+           binding="customBinding"  
+           bindingConfiguration="HttpBinding"   
+           contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+   </service>  
+  </services>  
+  
+  <bindings>  
+    <customBinding>  
+  
+    <!-- Configure a CustomBinding that disables keepAliveEnabled-->  
+      <binding name="HttpBinding" keepAliveEnabled="False"/>  
+  
+    </customBinding>  
+  </bindings>  
+ </system.serviceModel>  
+</configuration>  
+```  
+  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] で導入された簡略化された構成を使用すると、次の簡略化された構成で同じ動作を実現できます。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+ <system.serviceModel>  
+    <protocolMapping>  
+      <add scheme=”http” binding=”customBinding” />  
+    </protocolMapping>  
+    <bindings>  
+      <customBinding>  
+  
+      <!-- Configure a CustomBinding that disables keepAliveEnabled-->  
+        <binding keepAliveEnabled="False"/>  
+  
+      </customBinding>  
+    </bindings>  
+ </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ 既定のエンドポイント、バインディング、および動作[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)」および「[WCF サービスの簡略化された構成](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)」を参照してください。  
+  
+## WSHttp バインディングおよび WSDualHttp バインディングによる負荷分散  
+ <xref:System.ServiceModel.WSHttpBinding> と <xref:System.ServiceModel.WSDualHttpBinding> はどちらも、既定のバインディング構成をいくつか変更すれば、HTTP の負荷分散手法を使用して負荷分散できます。  
+  
+-   セキュリティ コンテキストの確立を無効にします。これは、<xref:System.ServiceModel.WSHttpBinding> の <xref:System.ServiceModel.NonDualMessageSecurityOverHttp.EstablishSecurityContext%2A> プロパティを `false` に設定することで実現されます。あるいは、セキュリティ セッションが必要な場合は、「[セキュリティで保護されたセッション](../../../docs/framework/wcf/feature-details/secure-sessions.md)」のトピックで説明しているステートフルなセキュリティ セッションを使用することも可能です。ステートフルなセキュリティ セッションは、セキュリティ セッションのすべての状態 \(ステート\) を保護セキュリティ トークンの一部として要求ごとに転送するため、サービスをステートレスな状態に保つことができます。ステートフルなセキュリティ セッションを有効にする場合、システムによって提供される <xref:System.ServiceModel.WSHttpBinding> と <xref:System.ServiceModel.WSDualHttpBinding> では、必要な構成設定が公開されないため、<xref:System.ServiceModel.Channels.CustomBinding> またはユーザー定義の <xref:System.ServiceModel.Channels.Binding> を使用する必要があります。  
+  
+-   信頼できるセッションを使用しないでください。この機能は既定で無効になっています。  
+  
+## Net.TCP バインディングの負荷分散  
+ <xref:System.ServiceModel.NetTcpBinding> は、IP レイヤー負荷分散の手法を使用して負荷分散できます。ただし、<xref:System.ServiceModel.NetTcpBinding> は接続の待ち時間を減らすために、既定で TCP 接続のプールを作成します。この最適化は、負荷分散の基本的なメカニズムに干渉します。<xref:System.ServiceModel.NetTcpBinding> を最適化するための主な構成値はリース タイムアウトで、これは接続プール設定の一部です。接続プールによって、クライアントの接続がファーム内の特定サーバーと関連付けられます。このような接続の有効期間 \(これはリース タイムアウトの設定で制御される要素です\) が長くなるにつれて、ファーム内の各サーバーの負荷分散がうまくいかなくなります。その結果、平均呼び出し時間が増加します。したがって、<xref:System.ServiceModel.NetTcpBinding> を負荷分散シナリオで使用する場合は、バインディングによって使用される既定のリース タイムアウトを少なくすることを検討してください。負荷分散のシナリオでは、30 秒のリース タイムアウトから始めるのが合理的ですが、最適値はアプリケーションによって異なります。チャネルのリース タイムアウトおよびその他のトランスポート クォータの詳細については、「[トランスポート クォータ](../../../docs/framework/wcf/feature-details/transport-quotas.md)」を参照してください。  
+  
+ 負荷分散のシナリオで最適なパフォーマンスを実現するには、<xref:System.ServiceModel.NetTcpSecurity> \(<xref:System.ServiceModel.SecurityMode> または <xref:System.ServiceModel.SecurityMode>\) を使用することを検討してください。  
+  
+## 参照  
+ [インターネット インフォメーション サービス ホスティングのベスト プラクティス](../../../docs/framework/wcf/feature-details/internet-information-services-hosting-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/media/1060d9d2-c9c8-4e0a-9988-cdc2f7030f17.gif b/docs/framework/wcf/media/1060d9d2-c9c8-4e0a-9988-cdc2f7030f17.gif
new file mode 100644
index 00000000000..84ee210b68a
Binary files /dev/null and b/docs/framework/wcf/media/1060d9d2-c9c8-4e0a-9988-cdc2f7030f17.gif differ
diff --git a/docs/framework/wcf/media/1df215cb-b344-4f36-a20d-195999bda741.gif b/docs/framework/wcf/media/1df215cb-b344-4f36-a20d-195999bda741.gif
new file mode 100644
index 00000000000..d8472cf4500
Binary files /dev/null and b/docs/framework/wcf/media/1df215cb-b344-4f36-a20d-195999bda741.gif differ
diff --git a/docs/framework/wcf/media/29fa00ac-cf78-46e5-822d-56222fff61d1.gif b/docs/framework/wcf/media/29fa00ac-cf78-46e5-822d-56222fff61d1.gif
new file mode 100644
index 00000000000..65cf4e962aa
Binary files /dev/null and b/docs/framework/wcf/media/29fa00ac-cf78-46e5-822d-56222fff61d1.gif differ
diff --git a/docs/framework/wcf/media/2f628580-b80f-45a7-925b-616c96426c0e.gif b/docs/framework/wcf/media/2f628580-b80f-45a7-925b-616c96426c0e.gif
new file mode 100644
index 00000000000..d8d1f8cb4d4
Binary files /dev/null and b/docs/framework/wcf/media/2f628580-b80f-45a7-925b-616c96426c0e.gif differ
diff --git a/docs/framework/wcf/media/558943c4-17cf-4c12-9405-677e995ac387.gif b/docs/framework/wcf/media/558943c4-17cf-4c12-9405-677e995ac387.gif
new file mode 100644
index 00000000000..8c2d71eaa18
Binary files /dev/null and b/docs/framework/wcf/media/558943c4-17cf-4c12-9405-677e995ac387.gif differ
diff --git a/docs/framework/wcf/media/5dc8e0eb-1c32-4076-8c66-594935beaee9.gif b/docs/framework/wcf/media/5dc8e0eb-1c32-4076-8c66-594935beaee9.gif
new file mode 100644
index 00000000000..0e88acb0323
Binary files /dev/null and b/docs/framework/wcf/media/5dc8e0eb-1c32-4076-8c66-594935beaee9.gif differ
diff --git a/docs/framework/wcf/media/6f7f4191-df2b-4592-8998-8379769e2d32.gif b/docs/framework/wcf/media/6f7f4191-df2b-4592-8998-8379769e2d32.gif
new file mode 100644
index 00000000000..177794d8e2a
Binary files /dev/null and b/docs/framework/wcf/media/6f7f4191-df2b-4592-8998-8379769e2d32.gif differ
diff --git a/docs/framework/wcf/media/74255b6e-7c47-46ef-8e53-870c76b04c3f.gif b/docs/framework/wcf/media/74255b6e-7c47-46ef-8e53-870c76b04c3f.gif
new file mode 100644
index 00000000000..bc6bb159b36
Binary files /dev/null and b/docs/framework/wcf/media/74255b6e-7c47-46ef-8e53-870c76b04c3f.gif differ
diff --git a/docs/framework/wcf/media/7457c4ed-8383-4ac7-bada-bcb27409da58.gif b/docs/framework/wcf/media/7457c4ed-8383-4ac7-bada-bcb27409da58.gif
new file mode 100644
index 00000000000..ce35c31f847
Binary files /dev/null and b/docs/framework/wcf/media/7457c4ed-8383-4ac7-bada-bcb27409da58.gif differ
diff --git a/docs/framework/wcf/media/7c66e994-2476-4260-a0db-98948b9af197.gif b/docs/framework/wcf/media/7c66e994-2476-4260-a0db-98948b9af197.gif
new file mode 100644
index 00000000000..25172c33554
Binary files /dev/null and b/docs/framework/wcf/media/7c66e994-2476-4260-a0db-98948b9af197.gif differ
diff --git a/docs/framework/wcf/media/7d908807-4967-4f6d-9226-d52125db69ca.gif b/docs/framework/wcf/media/7d908807-4967-4f6d-9226-d52125db69ca.gif
new file mode 100644
index 00000000000..be822587342
Binary files /dev/null and b/docs/framework/wcf/media/7d908807-4967-4f6d-9226-d52125db69ca.gif differ
diff --git a/docs/framework/wcf/media/8a728f91-5f80-4a95-afe8-0b6acd6e0317.gif b/docs/framework/wcf/media/8a728f91-5f80-4a95-afe8-0b6acd6e0317.gif
new file mode 100644
index 00000000000..f848a30ae45
Binary files /dev/null and b/docs/framework/wcf/media/8a728f91-5f80-4a95-afe8-0b6acd6e0317.gif differ
diff --git a/docs/framework/wcf/media/a0493e95-653e-4af8-84a4-4d09a400bc31.gif b/docs/framework/wcf/media/a0493e95-653e-4af8-84a4-4d09a400bc31.gif
new file mode 100644
index 00000000000..baba3f88e0e
Binary files /dev/null and b/docs/framework/wcf/media/a0493e95-653e-4af8-84a4-4d09a400bc31.gif differ
diff --git a/docs/framework/wcf/media/b2d9850e-f362-4ae5-bb8d-9f6f3ca036a5.gif b/docs/framework/wcf/media/b2d9850e-f362-4ae5-bb8d-9f6f3ca036a5.gif
new file mode 100644
index 00000000000..6fb232912ab
Binary files /dev/null and b/docs/framework/wcf/media/b2d9850e-f362-4ae5-bb8d-9f6f3ca036a5.gif differ
diff --git a/docs/framework/wcf/media/contractfirstadvanced.png b/docs/framework/wcf/media/contractfirstadvanced.png
new file mode 100644
index 00000000000..18ad73f5906
Binary files /dev/null and b/docs/framework/wcf/media/contractfirstadvanced.png differ
diff --git a/docs/framework/wcf/media/contractfirstoptions.png b/docs/framework/wcf/media/contractfirstoptions.png
new file mode 100644
index 00000000000..d4738517e09
Binary files /dev/null and b/docs/framework/wcf/media/contractfirstoptions.png differ
diff --git a/docs/framework/wcf/media/contractfirsttypes.png b/docs/framework/wcf/media/contractfirsttypes.png
new file mode 100644
index 00000000000..db548647194
Binary files /dev/null and b/docs/framework/wcf/media/contractfirsttypes.png differ
diff --git a/docs/framework/wcf/media/d7b135f6-ec7d-45d7-9913-037ab30e4c26.gif b/docs/framework/wcf/media/d7b135f6-ec7d-45d7-9913-037ab30e4c26.gif
new file mode 100644
index 00000000000..d9619cc2fc5
Binary files /dev/null and b/docs/framework/wcf/media/d7b135f6-ec7d-45d7-9913-037ab30e4c26.gif differ
diff --git a/docs/framework/wcf/media/de4f586c-c5dd-41ec-b1c3-ac56b4dfa35c.gif b/docs/framework/wcf/media/de4f586c-c5dd-41ec-b1c3-ac56b4dfa35c.gif
new file mode 100644
index 00000000000..09a6ca51988
Binary files /dev/null and b/docs/framework/wcf/media/de4f586c-c5dd-41ec-b1c3-ac56b4dfa35c.gif differ
diff --git a/docs/framework/wcf/media/wcf-architecture.gif b/docs/framework/wcf/media/wcf-architecture.gif
new file mode 100644
index 00000000000..d70e883bce4
Binary files /dev/null and b/docs/framework/wcf/media/wcf-architecture.gif differ
diff --git a/docs/framework/wcf/media/wcfc-defaultactivityc.gif b/docs/framework/wcf/media/wcfc-defaultactivityc.gif
new file mode 100644
index 00000000000..e3634135900
Binary files /dev/null and b/docs/framework/wcf/media/wcfc-defaultactivityc.gif differ
diff --git a/docs/framework/wcf/media/wcfc-executionactivityiconc.GIF b/docs/framework/wcf/media/wcfc-executionactivityiconc.GIF
new file mode 100644
index 00000000000..c98c3a9c241
Binary files /dev/null and b/docs/framework/wcf/media/wcfc-executionactivityiconc.GIF differ
diff --git a/docs/framework/wcf/migrating-from-net-remoting-to-wcf.md b/docs/framework/wcf/migrating-from-net-remoting-to-wcf.md
new file mode 100644
index 00000000000..07adb6c0a83
--- /dev/null
+++ b/docs/framework/wcf/migrating-from-net-remoting-to-wcf.md
@@ -0,0 +1,717 @@
+---
+title: ".NET リモート処理から WCF への移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16902a42-ef80-40e9-8c4c-90e61ddfdfe5
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# .NET リモート処理から WCF への移行
+この記事では、.NET リモート処理を使用するアプリケーションを、Windows Communication Foundation \(WCF\) を使用するように移行する方法について説明します。  これらの製品間で類似する概念を比較した後、WCF で一般的なリモート処理のシナリオを実現する方法を説明します。  
+  
+ .NET リモート処理は、旧バージョンとの互換性のためだけにサポートされているレガシー製品です。  これは、クライアントとサーバーの間で個々の信頼レベルを維持できないため、信頼レベルが混在する環境において安全ではありません。  たとえば、インターネットまたは信頼できないクライアントには、.NET リモート処理のエンドポイントを非公開にする必要があります。  既存のリモート処理アプリケーションを、より新しく安全なテクノロジに移行することをお勧めします。  そのアプリケーションの設計に HTTP のみが使用されていて、かつ RESTful である場合、ASP.NET Web API をお勧めします。  詳細については、ASP.NET Web API を参照してください。  アプリケーションが SOAP ベースの場合や、TCP などの非 HTTP プロトコルを必要とする場合は、WCF をお勧めします。  
+  
+-   [.NET リモート処理と WCF の比較](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Compare_Top)  
+  
+    -   [サーバー実装の比較](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Server_Comp)  
+  
+    -   [クライアント実装の比較](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Client_Comp)  
+  
+    -   [シリアル化の使用方法](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Serialization_Usage)  
+  
+    -   [例外処理の機能](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Exception_Handling)  
+  
+    -   [セキュリティの考慮事項](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Security_Considerations)  
+  
+-   [WCF への移行](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Migrating_Top)  
+  
+    -   [リモート処理から WCF に移行する理由](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Why_Migrate)  
+  
+    -   [移行の推奨事項](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Migration_Recommendations)  
+  
+    -   [移行のシナリオ](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Migration_Scenarios)  
+  
+-   [概要](../../../docs/framework/wcf/migrating-from-net-remoting-to-wcf.md#Summary)  
+  
+<a name="Compare_Top"></a>   
+## .NET リモート処理と WCF の比較  
+ このセクションでは、.NET リモート処理の基本的な構成要素と、それに相当する WCF の構成要素を比較します。  これらの構成要素は、後ほど WCF で一般的なクライアントとサーバーのシナリオを作成するために使用します。次の表では、.NET リモート処理と WCF の主な類似点と相違点を示しています。  
+  
+||.NET リモート処理|WCF|  
+|-|-----------------|---------|  
+|サーバーの型|サブクラス MarshalByRefObject|\[ServiceContract\] 属性でマーク|  
+|サービス操作|サーバーの型のパブリック メソッド|\[OperationContract\] 属性でマーク|  
+|シリアル化|ISerializable または \[Serializable\]|DataContractSerializer または XmlSerializer|  
+|渡されるオブジェクト|値渡しまたは参照渡し|値渡しのみ|  
+|エラーと例外|すべてのシリアル化可能な例外|FaultContract\<TDetail\>|  
+|クライアント プロキシ オブジェクト|厳密に型指定された透過的プロキシが MarshalByRefObjects から自動的に作成されます|ChannelFactory\<TChannel\> を使用し、厳密に型指定されたプロキシを必要に応じて生成します|  
+|必要なプラットフォーム|クライアントとサーバーの両方で Microsoft OS と .NET を使用する必要があります|クロスプラットフォーム|  
+|メッセージ形式|プライベート|業界標準 \(SOAP、WS\-\* など\)|  
+  
+<a name="Server_Comp"></a>   
+### サーバー実装の比較  
+  
+#### .NET リモート処理でサーバーを作成する  
+ .NET リモート処理のサーバーの型は MarshalByRefObject から派生させて、次のようにクライアントから呼び出せるメソッドを定義する必要があります。  
+  
+```  
+public class RemotingServer : MarshalByRefObject  
+{  
+    public Customer GetCustomer(int customerId) { … }  
+}  
+```  
+  
+ このサーバーの型のパブリック メソッドは、クライアントから使用できるパブリック コントラクトになります。  サーバーのパブリック インターフェイスとその実装の間には境界がありません。1 つの型によって両方を処理します。  
+  
+ サーバーの型を定義した後は、次の例のように、クライアントから使用可能な状態にできます。  
+  
+```  
+TcpChannel channel = new TcpChannel(8080);  
+ChannelServices.RegisterChannel(channel, ensureSecurity : true);  
+RemotingConfiguration.RegisterWellKnownServiceType(  
+    typeof(RemotingServer),   
+    "RemotingServer",   
+    WellKnownObjectMode.Singleton);  
+Console.WriteLine("RemotingServer is running.  Press ENTER to terminate...");  
+Console.ReadLine();  
+  
+```  
+  
+ リモート処理の型をサーバーとして使用できるようにするには、構成ファイルを使用するなど、さまざまな方法があります。  この方法はほんの一例です。  
+  
+#### WCF でサーバーを作成する  
+ WCF で同等の手順を実行する場合は、パブリック "サービス コントラクト" と具象実装という 2 つの型を作成します。  1 つ目の型は、\[ServiceContract\] でマークされたインターフェイスとして宣言します。  クライアントから使用できるメソッドは、\[OperationContract\] でマークします。  
+  
+```  
+[ServiceContract]  
+public interface IWCFServer  
+{  
+    [OperationContract]  
+    Customer GetCustomer(int customerId);  
+}  
+  
+```  
+  
+ サーバーの実装は、次の例のように、別の具象クラスで定義します。  
+  
+```  
+public class WCFServer : IWCFServer  
+{  
+    public Customer GetCustomer(int customerId) { … }  
+}  
+```  
+  
+ これらの型を定義した後は、次の例のように、WCF サーバーをクライアントから使用可能な状態にできます。  
+  
+```  
+NetTcpBinding binding = new NetTcpBinding();  
+Uri baseAddress = new Uri("net.tcp://localhost:8000/wcfserver");  
+  
+using (ServiceHost serviceHost = new ServiceHost(typeof(WCFServer), baseAddress))  
+{  
+    serviceHost.AddServiceEndpoint(typeof(IWCFServer), binding, baseAddress);  
+    serviceHost.Open();  
+  
+    Console.WriteLine(String.Format("The WCF server is ready at {0}.",  
+                                    baseAddress));  
+    Console.WriteLine("Press <ENTER> to terminate service...");  
+    Console.WriteLine();  
+    Console.ReadLine();  
+}  
+  
+```  
+  
+> [!NOTE]
+>  両方の例をできる限り似たものにするため、どちらの例でも TCP を使用します。  HTTP を使用する例については、このトピックで後述するシナリオのチュートリアルを参照してください。  
+  
+ WCF サービスの構成方法やホスト方法には、さまざまなものがあります。  これは、"自己ホスト型" と呼ばれる一例にすぎません。  詳細については、次のトピックを参照してください。  
+  
+-   [方法 : サービス コントラクトを定義する](../../../docs/framework/wcf/how-to-define-a-wcf-service-contract.md)  
+  
+-   [構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)  
+  
+-   [ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)  
+  
+<a name="Client_Comp"></a>   
+### クライアント実装の比較  
+  
+#### .NET リモート処理でクライアントを作成する  
+ .NET リモート処理サーバー オブジェクトが使用可能になると、次の例のように、クライアントによって使用することができます。  
+  
+```  
+TcpChannel channel = new TcpChannel();  
+ChannelServices.RegisterChannel(channel, ensureSecurity : true);  
+RemotingServer server = (RemotingServer)Activator.GetObject(  
+                            typeof(RemotingServer),   
+                            "tcp://localhost:8080/RemotingServer");  
+  
+RemotingCustomer customer = server.GetCustomer(42);  
+Console.WriteLine(String.Format("Customer {0} {1} received.",   
+                                 customer.FirstName, customer.LastName));  
+```  
+  
+ Activator.GetObject\(\) から返される RemotingServer インスタンスは、"透過的プロキシ" と呼ばれています。 これによって RemotingServer 型のパブリック API がクライアントに実装されますが、すべてのメソッドは別のプロセスまたはコンピューターで実行中のサーバー オブジェクトを呼び出します。  
+  
+#### WCF でクライアントを作成する  
+ WCF で同等の手順を実行する場合は、チャネル ファクトリを使用してプロキシを明示的に作成します。  リモート処理と同様、プロキシ オブジェクトは、次の例のように、サーバーでの操作の呼び出しに使用できます。  
+  
+```  
+NetTcpBinding binding = new NetTcpBinding();  
+String url = "net.tcp://localhost:8000/wcfserver";  
+EndpointAddress address = new EndpointAddress(url);  
+ChannelFactory<IWCFServer> channelFactory =   
+    new ChannelFactory<IWCFServer>(binding, address);  
+IWCFServer server = channelFactory.CreateChannel();  
+  
+Customer customer = server.GetCustomer(42);  
+Console.WriteLine(String.Format("  Customer {0} {1} received.",  
+                    customer.FirstName, customer.LastName));  
+```  
+  
+ この例では、リモート処理の例に最も近いことから、チャネル レベルでのプログラミングを示しています。  また、Visual Studio の **\[サービス参照の追加\]** によってコードを生成し、クライアントのプログラミングを簡略化する方法も利用できます。  詳細については、次のトピックを参照してください。  
+  
+-   [クライアントのチャネル レベルのプログラミング](../../../docs/framework/wcf/extending/client-channel-level-programming.md)  
+  
+-   [How to: Add, Update, or Remove a Service Reference](../Topic/How%20to:%20Add,%20Update,%20or%20Remove%20a%20Service%20Reference.md)  
+  
+<a name="Serialization_Usage"></a>   
+### シリアル化の使用方法  
+ .NET リモート処理と WCF は、どちらもクライアントとサーバーの間のオブジェクト送信にシリアル化を使用しますが、次の重要な点が異なります。  
+  
+1.  シリアル化の対象を示すために異なるシリアライザーと規則を使用します。  
+  
+2.  .NET リモート処理では、"参照渡し" のシリアル化をサポートしています。これによって、1 つの階層でメソッドまたはプロパティへのアクセスを行い、セキュリティ境界をまたいだ別の階層でコードを実行できます。  この機能によってセキュリティの脆弱性が露呈することが、信頼できないクライアントにはリモート処理のエンドポイントを決して公開できない、主な理由の 1 つです。  
+  
+3.  リモート処理で使用されるシリアル化はオプトアウト \(シリアル化しないものを明示的に除外する\) で、WCF でのシリアル化はオプトイン \(どのメンバーをシリアル化するのかを明示的にマークする\) です。  
+  
+#### .NET リモート処理でのシリアル化  
+ .NET リモート処理では、クライアントとサーバーの間でオブジェクトをシリアル化および逆シリアル化するために次の 2 つの方法をサポートしています。  
+  
+-   *値渡し* – オブジェクトの値は階層の境界をまたいでシリアル化され、そのオブジェクトの新しいインスタンスが、他の階層で作成されます。  この新しいインスタンスのメソッドまたはプロパティへの呼び出しはいずれもローカルに実行され、元のオブジェクトまたは階層には影響しません。  
+  
+-   *参照渡し* – 特別な "オブジェクト参照" は階層の境界をまたいでシリアル化されます。  1 つの階層がそのオブジェクトのメソッドまたはプロパティとやり取りをする場合、元の階層の元のオブジェクトに対して通信を行います。  参照渡しのオブジェクトは、いずれかの方向、つまりサーバーからクライアント、またはクライアントからサーバーにフローできます。  
+  
+ リモート処理での値渡し型は、次の例のように、\[Serializable\] 属性でマークされるか、ISerializable を実装します。  
+  
+```  
+[Serializable]  
+public class RemotingCustomer  
+{  
+    public string FirstName { get; set; }  
+    public string LastName { get; set; }  
+    public int CustomerId { get; set; }  
+}  
+```  
+  
+ 参照渡し型は、次の例のように、MarshalByRefObject クラスから派生します。  
+  
+```  
+public class RemotingCustomerReference : MarshalByRefObject  
+{  
+    public string FirstName { get; set; }  
+    public string LastName { get; set; }  
+    public int CustomerId { get; set; }  
+}  
+```  
+  
+ リモート処理の参照渡しのオブジェクトによる影響を理解することは、非常に重要です。  どちらかの階層 \(クライアントまたはサーバー\) が参照渡しのオブジェクトをもう一方の階層に送信する場合、すべてのメソッド呼び出しは、オブジェクトを持つ元の階層で実行されます。  たとえば、サーバーから返される参照渡しのオブジェクトでクライアントが呼び出すメソッドは、サーバーでコードを実行します。  同様に、クライアントから提供される参照渡しのオブジェクトでサーバーが呼び出すメソッドは、クライアントでコードを実行します。  このため、.NET リモート処理は、完全に信頼できる環境内でのみ使用することが推奨されます。  パブリック .NET リモート処理のエンドポイントを信頼できないクライアントに公開すると、リモート処理サーバーが攻撃に対して無防備な状態になります。  
+  
+#### WCF でのシリアル化  
+ WCF では、値渡しのシリアル化のみをサポートしています。  クライアントとサーバーの間で交換する型を定義するための最も一般的な方法は、次の例のようになります。  
+  
+```  
+[DataContract]  
+public class WCFCustomer  
+{  
+    [DataMember]  
+    public string FirstName { get; set; }  
+  
+    [DataMember]  
+    public string LastName { get; set; }  
+  
+    [DataMember]  
+    public int CustomerId { get; set; }  
+}  
+```  
+  
+ \[DataContract\] 属性は、この型をクライアントとサーバーの間でシリアル化および逆シリアル化ができる型として識別します。  \[DataMember\] 属性は、シリアル化する個々のプロパティまたはフィールドを識別します。  
+  
+ WCF が階層をまたいでオブジェクトを送信する場合は、値のみをシリアル化し、もう一方の階層でオブジェクトの新しいインスタンスを作成します。  オブジェクトの値とのやり取りはローカルでのみ発生し、.NET リモート処理の参照渡しのオブジェクトのような方法でもう一方の階層と通信することはありません。  詳細については、次のトピックを参照してください。  
+  
+-   [シリアル化と逆シリアル化](../../../docs/framework/wcf/feature-details/serialization-and-deserialization.md)  
+  
+-   [Windows Communication Foundation でのシリアル化](http://msdn.microsoft.com/magazine/cc163569.aspx)  
+  
+<a name="Exception_Handling"></a>   
+### 例外処理の機能  
+  
+#### .NET リモート処理での例外  
+ リモート処理サーバーによってスローされた例外は、シリアル化され、クライアントに送信されて、その他すべての例外と同様に、クライアントでローカルにスローされます。  カスタムの例外は、Exception 型をサブクラス化して \[Serializable\] でマークすることによって作成できます。  フレームワークの例外の大部分は既にこの方法でマークされているため、サーバーによるスロー、シリアル化、およびクライアントでの再スローが可能です。  この設計は開発中には便利ですが、サーバー側の情報が誤ってクライアントに公開されてしまう可能性があります。  リモート処理の使用を完全に信頼できる環境に限定する必要がある理由はさまざまですが、これもその 1 つです。  
+  
+#### WCF での例外とエラー  
+ WCF では、不注意による情報の漏洩につながる可能性があるため、サーバーからクライアントに任意の例外型を返すことはできません。  サービス操作によって予期しない例外がスローされた場合、汎用の FaultException がクライアントでスローされます。  この例外には、問題の発生原因や発生場所の情報は含まれませんが、これらは一部のアプリケーションにとっては必要ありません。  より豊富なエラー情報をクライアントに伝える必要があるアプリケーションは、エラー コントラクトを定義することによってこれを実行します。  
+  
+ 方法としては、まずエラー情報を伝送するための \[DataContract\] 型を作成します。  
+  
+```  
+[DataContract]  
+public class CustomerServiceFault  
+{  
+    [DataMember]  
+    public string ErrorMessage { get; set; }  
+  
+    [DataMember]  
+    public int CustomerId {get;set;}  
+}  
+```  
+  
+ 各サービス操作に使用するエラー コントラクトを指定します。  
+  
+```  
+[ServiceContract]  
+public interface IWCFServer  
+{  
+    [OperationContract]  
+    [FaultContract(typeof(CustomerServiceFault))]  
+    Customer GetCustomer(int customerId);  
+}  
+```  
+  
+ サーバーは、FaultException のスローによってエラー状態を報告します。  
+  
+```  
+throw new FaultException<CustomerServiceFault>(  
+    new CustomerServiceFault() {   
+        CustomerId = customerId,   
+        ErrorMessage = "Illegal customer Id"   
+    });  
+```  
+  
+ また、クライアントがサーバーに要求を行う場合は、常にエラーを通常の例外としてキャッチできます。  
+  
+```  
+try  
+{  
+    Customer customer = server.GetCustomer(-1);  
+}  
+catch (FaultException<CustomerServiceFault> fault)  
+{  
+    Console.WriteLine(String.Format("Fault received: {0}",  
+    fault.Detail.ErrorMessage));  
+}  
+  
+```  
+  
+ エラー コントラクトの詳細については、「<xref:System.ServiceModel.FaultException>」を参照してください。  
+  
+<a name="Security_Considerations"></a>   
+### セキュリティの考慮事項  
+  
+#### .NET リモート処理でのセキュリティ  
+ 一部の .NET リモート処理チャネルでは、チャネル層 \(IPC と TCP\) での認証および暗号化などのセキュリティ機能をサポートしています。  HTTP チャネルでは、認証と暗号化の両方にインターネット インフォメーション サービス \(IIS\) を利用しています。  こういったサポートがあっても、.NET リモート処理を安全性が低い通信プロトコルと見なし、完全に信頼できる環境内に使用を制限する必要があります。  パブリック リモート処理のエンドポイントをインターネットや信頼できないクライアントに公開することは絶対に避けてください。  
+  
+#### WCF でのセキュリティ  
+ WCF は、.NET リモート処理で見つかった種類の脆弱性に対処する必要性などがあったため、セキュリティを考慮して設計されています。  WCF では、トランスポートとメッセージの両方のレベルでセキュリティが提供され、認証、承認、暗号化などのために、数多くのオプションが利用できます。  詳細については、次のトピックを参照してください。  
+  
+-   [セキュリティ](../../../docs/framework/wcf/feature-details/security.md)  
+  
+-   [WCF セキュリティ ガイダンス](http://wcfsecurity.codeplex.com/)  
+  
+<a name="Migrating_Top"></a>   
+## WCF への移行  
+  
+<a name="Why_Migrate"></a>   
+### リモート処理から WCF に移行する理由  
+  
+-   **.NET リモート処理はレガシー製品です。** 「[.NET リモート処理](http://msdn.microsoft.com/library/vstudio/72x4h507\(v=vs.100\).aspx)」で説明されているように、これはレガシー製品と見なされており、新規開発の用途にはお勧めしません。  新規および既存のアプリケーションには、WCF または ASP.NET Web API をお勧めします。  
+  
+-   **WCF では、クロスプラットフォーム標準を使用しています。** WCF は、クロスプラットフォームの相互運用性を考慮して設計されており、さまざまな業界標準 \(SOAP、WS\-Security、WS\-Trust など\) をサポートしています。  WCF サービスでは、Windows 以外のオペレーション システムで動作中のクライアントとの相互運用ができます。  リモート処理は、主に、サーバーおよびクライアント アプリケーションの両方が Windows オペレーティング システムで .NET Framework を使用して実行される環境向けに設計されました。  
+  
+-   **WCF にはセキュリティが組み込まれています。** WCF は、セキュリティを考慮して設計されており、認証、トランスポート レベルのセキュリティ、メッセージ レベルのセキュリティなどのために、数多くのオプションが用意されています。  リモート処理は、アプリケーションの相互運用を容易にするように設計されましたが、信頼できない環境で安全性を確保できるようには設計されていません。  WCF は信頼できる環境と信頼できない環境の両方で動作するよう設計されました。  
+  
+<a name="Migration_Recommendations"></a>   
+### 移行の推奨事項  
+ .NET リモート処理から WCF に移行するための推奨手順を次に示します。  
+  
+-   **サービス コントラクトを作成する。** サービス インターフェイスの型を定義し、\[ServiceContract\] 属性でマークします。クライアントからの呼び出しを可能にするすべてのメソッドを \[OperationContract\] でマークします。  
+  
+-   **データ コントラクトを作成する。** サーバーとクライアントの間で交換されるデータ型を定義し、\[DataContract\] 属性でマークします。  クライアントから使用できるようにするすべてのフィールドとプロパティを \[DataMember\] でマークします。  
+  
+-   **エラー コントラクトを作成する \(省略可能\)。** エラーが検出されたときにサーバーとクライアントの間で交換される型を作成します。  これらの型を \[DataContract\] と \[DataMember\] でマークしてシリアル化できるようにします。  \[OperationContract\] でマークしたすべてのサービス操作について、どのエラーが返されるのかを示すために \[FaultContract\] でも同様にマークします。  
+  
+-   **サービスを構成し、ホストする。** サービス コントラクトの作成後の手順としては、エンドポイントでサービスを公開するためにバインドを構成します。  詳細については、「[エンドポイント : アドレス、バインディング、およびコントラクト](../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md)」を参照してください。  
+  
+ リモート処理アプリケーションの WCF への移行が完了した後は、.NET リモート処理で依存関係を削除する必要があります。  これにより、リモート処理の脆弱性がアプリケーションから確実に取り除かれます。  実行する必要がある手順は、次のとおりです。  
+  
+-   **MarshalByRefObject の使用を中止する。** MarshalByRefObject 型は、リモート処理のためだけに存在する型で、WCF では使用されません。  MarshalByRefObject をサブクラスに持つアプリケーション型は、削除するか変更する必要があります。  MarshalByRefObject 型は、リモート処理のためだけに存在する型で、WCF では使用されません。  MarshalByRefObject をサブクラスに持つアプリケーション型は、削除するか変更する必要があります。  
+  
+-   **\[Serializable\] と ISerializable の使用を中止する。** \[Serializable\] 属性と ISerializable インターフェイスは、信頼できる環境内の型をシリアル化するように設計されたものであり、これらはリモート処理によって使用されます。  WCF のシリアル化では、\[DataContract\] と \[DataMember\] でマークされている型を使用します。  アプリケーションで使用されるデータ型は、ISerializable や \[Serializable\] を使用せずに \[DataContract\] を使用するように変更する必要があります。  \[Serializable\] 属性と ISerializable インターフェイスは、信頼できる環境内の型をシリアル化するように設計されたものであり、これらはリモート処理によって使用されます。  WCF のシリアル化では、\[DataContract\] と \[DataMember\] でマークされている型を使用します。  アプリケーションで使用されるデータ型は、ISerializable や \[Serializable\] を使用せずに \[DataContract\] を使用するように変更する必要があります。  
+  
+<a name="Migration_Scenarios"></a>   
+### 移行のシナリオ  
+ WCF で次の一般的なリモート処理のシナリオを実現する方法を見てみましょう。  
+  
+1.  サーバーからクライアントに値渡しでオブジェクトを返す  
+  
+2.  サーバーからクライアントに参照渡しでオブジェクトを返す  
+  
+3.  クライアントからサーバーに値渡しでオブジェクトを送信する  
+  
+> [!NOTE]
+>  WCF では、クライアントからサーバーに参照渡しでオブジェクを送信することはできません。  
+  
+ これらのシナリオを読み進める際は、.NET リモート処理のベースライン インターフェイスが次の例のようになると想定してください。  ここでは、.NET リモート処理の実装は重要ではありません。その理由は、ここで説明するのは WCF を使用して同等の機能を実装する方法のみであるためです。  
+  
+```  
+public class RemotingServer : MarshalByRefObject  
+{  
+    // Demonstrates server returning object by-value  
+    public Customer GetCustomer(int customerId) {…}  
+  
+    // Demonstrates server returning object by-reference  
+    public CustomerReference GetCustomerReference(int customerId) {…}  
+  
+    // Demonstrates client passing object to server by-value  
+    public bool UpdateCustomer(Customer customer) {…}  
+}  
+  
+```  
+  
+#### シナリオ 1: サービスが値渡しでオブジェクトを返す  
+ このシナリオでは、値渡しでクライアントにオブジェクトを返すサーバーについて説明します。  WCF は常にサーバーから値渡しでオブジェクトを返すため、次の各手順では、単に通常の WCF サービスを構築する方法について説明します。  
+  
+1.  まずは、WCF サービスのパブリック インターフェイスを定義し、\[ServiceContract\] 属性でマークします。  クライアントが呼び出すサーバー側のメソッドを識別するために \[OperationContract\] を使用します。  
+  
+    ```  
+    [ServiceContract]  
+    public interface ICustomerService  
+    {  
+        [OperationContract]  
+        Customer GetCustomer(int customerId);  
+  
+        [OperationContract]  
+        bool UpdateCustomer(Customer customer);  
+    }  
+    ```  
+  
+2.  次の手順は、このサービスのデータ コントラクトの作成です。  これを行うには、\[DataContract\] 属性でマークされたクラス \(インターフェイスではない\) を作成します。  クライアントとサーバーの両方に対して表示する個々のプロパティやフィールドは、\[DataMember\] でマークします。  派生型を許可する場合は、それを識別するために \[KnownType\] 属性を使用する必要があります。  WCF がこのサービス用にシリアル化または逆シリアル化を許可する型は、サービス インターフェイス内の型と、これらの "既知の型" のみです。  この一覧にないその他の型を交換しようとすると、拒否されます。  
+  
+    ```  
+    [DataContract]  
+    [KnownType(typeof(PremiumCustomer))]  
+    public class Customer  
+    {  
+        [DataMember]  
+        public string FirstName { get; set; }  
+  
+        [DataMember]  
+        public string LastName { get; set; }  
+  
+        [DataMember]  
+        public int CustomerId { get; set; }  
+    }  
+  
+    [DataContract]  
+    public class PremiumCustomer : Customer   
+    {  
+        [DataMember]  
+        public int AccountId { get; set; }  
+    }  
+    ```  
+  
+3.  次に、サービス インターフェイスの実装を提供します。  
+  
+    ```  
+    public class CustomerService : ICustomerService  
+    {  
+        public Customer GetCustomer(int customerId)  
+        {  
+            // read from database  
+        }  
+  
+        public bool UpdateCustomer(Customer customer)  
+        {  
+            // write to database  
+        }  
+    }  
+    ```  
+  
+4.  WCF サービスを実行するには、特定の WCF バインドを使用して特定の URL で上記のサービス インターフェイスを公開するエンドポイントを宣言する必要があります。  通常、これを行うには、サーバー プロジェクトの web.config ファイルに次のセクションを追加します。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <services>  
+          <service name="Server.CustomerService">  
+            <endpoint address="http://localhost:8083/CustomerService"  
+                      binding="basicHttpBinding"  
+                      contract="Shared.ICustomerService" />  
+          </service>  
+        </services>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+5.  WCF サービスは次のコードで開始できます。  
+  
+    ```  
+    ServiceHost customerServiceHost = new ServiceHost(typeof(CustomerService));  
+        customerServiceHost.Open();  
+    ```  
+  
+     この ServiceHost は、開始されると web.config ファイルを使用して適切なコントラクト、バインド、エンドポイントを確立します。  構成ファイルの詳細については、「[構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)」を参照してください。  このようなサーバーの開始方法は、自己ホストと呼ばれています。  WCF サービスのホストに関する他の選択肢の詳細については、「[ホスティング サービス](../../../docs/framework/wcf/hosting-services.md)」を参照してください。  
+  
+6.  クライアント プロジェクトの app.config では、サービスのエンドポイントの対応するバインド情報を宣言する必要があります。  これを Visual Studio で行う最も簡単な方法は、**\[サービス参照の追加\]** を使用することで、これにより app.config ファイルが自動的に更新されます。  また、これと同じ変更を手動で加えることもできます。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <client>  
+          <endpoint name="customerservice"  
+                    address="http://localhost:8083/CustomerService"  
+                    binding="basicHttpBinding"  
+                    contract="Shared.ICustomerService"/>  
+        </client>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     **\[サービス参照の追加\]** の使用に関する詳細については、「[How to: Add, Update, or Remove a Service Reference](../Topic/How%20to:%20Add,%20Update,%20or%20Remove%20a%20Service%20Reference.md)」を参照してください。  
+  
+7.  これで、クライアントから WCF サービスを呼び出すことができます。  WCF サービスを呼び出すには、そのサービスのチャネル ファクトリを作成し、チャネルを要求して、そのチャネルで必要なメソッドを直接呼び出します。  この方法が可能なのは、チャネルがサービスのインターフェイスを実装し、基になる要求\/応答のロジックを処理するためです。  このメソッドの呼び出しからの戻り値は、サーバーの応答の逆シリアル化されたコピーです。  
+  
+    ```  
+    ChannelFactory<ICustomerService> factory =  
+        new ChannelFactory<ICustomerService>("customerservice");  
+    ICustomerService service = factory.CreateChannel();  
+    Customer customer = service.GetCustomer(42);  
+    Console.WriteLine(String.Format("  Customer {0} {1} received.",  
+            customer.FirstName, customer.LastName));  
+    ```  
+  
+ WCF によってサーバーからクライアントに返されるオブジェクトは、常に値渡しです。  オブジェクトは、サーバーから送信されたデータの逆シリアル化されたコピーです。  クライアントは、コールバックによってサーバー コードを呼び出すリスクを冒すことなく、これらのローカル コピーでメソッドを呼び出すことができます。  
+  
+#### シナリオ 2: サーバーから参照渡しでオブジェクトを返す  
+ このシナリオでは、参照渡しでクライアントにオブジェクトを提供するサーバーについて説明します。  .NET リモート処理では、参照渡しでシリアル化された MarshalByRefObject から派生したすべての型に対してこの処理が自動的に行われます。  このシナリオの例としては、たとえば複数のクライアントが、独立したセッションフルなサーバー側オブジェクトを持てるようにします。  前述したように、WCF サービスによって返されるオブジェクトは常に値渡しであるため、参照渡しのオブジェクトに直接相当するものはありませんが、<xref:System.ServiceModel.EndpointAddress10> オブジェクトを使用して参照渡しセマンティクスに類似するものを実現することは可能です。  これは、サーバー上のセッションフルな参照渡しのオブジェクトを取得するためにクライアントが使用できる、シリアル化可能な値渡しのオブジェクトです。  これによって、独立したセッションフルなサーバー側オブジェクトを持つ複数のクライアントを用意するというシナリオが可能になります。  
+  
+1.  まずは、セッションフル オブジェクト自体に対応する WCF サービス コントラクトを定義する必要があります。  
+  
+    ```  
+    [ServiceContract(SessionMode = SessionMode.Allowed)]  
+        public interface ISessionBoundObject  
+        {  
+            [OperationContract]  
+            string GetCurrentValue();  
+  
+            [OperationContract]  
+            void SetCurrentValue(string value);  
+        }  
+    ```  
+  
+    > [!TIP]
+    >  セッションフル オブジェクトは \[ServiceContract\] でマークされ、通常の WCF サービス インターフェイスになっていることに注意してください。  SessionMode プロパティを設定することは、それがセッションフル サービスになることを意味します。  WCF では、セッションは 2 つのエンドポイント間で送信される複数のメッセージを関連付ける方法です。  つまり、クライアントがこのサービスへの接続を確保すると、クライアントとサーバーの間でセッションが確立されます。  クライアントは、サーバー側オブジェクトの単一で一意のインスタンスを、この 1 つのセッション内でのすべてのやり取りに使用することになります。  
+  
+2.  次に、このサービス インターフェイスの実装を提供する必要があります。  \[ServiceBehavior\] でこれを示し、InstanceContextMode を設定することによって、この型の一意のインスタンスを各セッションに使用することを WCF に伝えます。  
+  
+    ```  
+    [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]  
+        public class MySessionBoundObject : ISessionBoundObject  
+        {  
+            private string _value;  
+  
+            public string GetCurrentValue()  
+            {  
+                return _value;  
+            }  
+  
+            public void SetCurrentValue(string val)  
+            {  
+                _value = val;  
+            }  
+  
+        }  
+    ```  
+  
+3.  ここで、このセッションフル オブジェクトのインスタンスを入手する方法が必要です。  これは、EndpointAddress10 オブジェクトを返すもう 1 つの WCF サービス インターフェイスを作成することによって行います。  これはクライアントがセッションフル オブジェクトの作成に使用できる、エンドポイントのシリアル化可能な形式です。  
+  
+    ```  
+    [ServiceContract]  
+        public interface ISessionBoundFactory  
+        {  
+            [OperationContract]  
+            EndpointAddress10 GetInstanceAddress();  
+        }  
+    ```  
+  
+     さらに、この WCF サービスを実装します。  
+  
+    ```  
+    public class SessionBoundFactory : ISessionBoundFactory  
+        {  
+            public static ChannelFactory<ISessionBoundObject> _factory =   
+                new ChannelFactory<ISessionBoundObject>("sessionbound");  
+  
+            public SessionBoundFactory()  
+            {  
+            }  
+  
+            public EndpointAddress10 GetInstanceAddress()  
+            {  
+                IClientChannel channel = (IClientChannel)_factory.CreateChannel();  
+                return EndpointAddress10.FromEndpointAddress(channel.RemoteAddress);  
+            }  
+        }  
+    ```  
+  
+     この実装では、セッションフル オブジェクトを作成するためにシングルトン チャネル ファクトリを保持しています。  チャネル ファクトリは、GetInstanceAddress\(\) が呼び出されるとチャネルを作成し、このチャネルに関連付けられているリモート アドレスを効率的にポイントする EndpointAddress10 オブジェクトを作成します。  EndpointAddress10 は、単に値渡しでクライアントに返すことのできるデータ型です。  
+  
+4.  以下の例に示すように、次の 2 つの処理を実行して、サーバーの構成ファイルを変更する必要があります。  
+  
+    1.  セッションフル オブジェクトのエンドポイントを示す \<client\> セクションを宣言する。  この処理が必要な理由は、この状況ではサーバーがクライアントとしても機能するためです。  
+  
+    2.  ファクトリおよびセッションフル オブジェクトのエンドポイントを宣言します。  この処理は、クライアントがサービス エンドポイントと通信して EndpointAddress10 の取得とセッションフル チャネルの作成を実行できるようにするために必要です。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+         <client>  
+          <endpoint name="sessionbound"  
+                    address="net.tcp://localhost:8081/SessionBoundObject"  
+                    binding="netTcpBinding"  
+                    contract="Shared.ISessionBoundObject"/>  
+        </client>  
+  
+        <services>  
+          <service name="Server.CustomerService">  
+            <endpoint address="http://localhost:8083/CustomerService"  
+                      binding="basicHttpBinding"  
+                      contract="Shared.ICustomerService" />  
+          </service>  
+          <service name="Server.MySessionBoundObject">  
+            <endpoint address="net.tcp://localhost:8081/SessionBoundObject"  
+                      binding="netTcpBinding"  
+                      contract="Shared.ISessionBoundObject" />  
+          </service>  
+          <service name="Server.SessionBoundFactory">  
+            <endpoint address="net.tcp://localhost:8081/SessionBoundFactory"  
+                      binding="netTcpBinding"  
+                      contract="Shared.ISessionBoundFactory" />  
+          </service>  
+        </services>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+     これで、次のサービスを開始できます。  
+  
+    ```  
+    ServiceHost factoryHost = new ServiceHost(typeof(SessionBoundFactory));  
+    factoryHost.Open();  
+  
+    ServiceHost sessionHost = new ServiceHost(typeof(MySessionBoundObject));  
+    sessionHost.Open();  
+    ```  
+  
+5.  クライアントの構成は、そのプロジェクトの app.config ファイル内でこれらの同じエンドポイントを宣言することによって行います。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <client>  
+          <endpoint name="customerservice"  
+                    address="http://localhost:8083/CustomerService"  
+                    binding="basicHttpBinding"  
+                    contract="Shared.ICustomerService"/>  
+          <endpoint name="sessionbound"  
+                    address="net.tcp://localhost:8081/SessionBoundObject"  
+                    binding="netTcpBinding"  
+                    contract="Shared.ISessionBoundObject"/>  
+          <endpoint name="factory"  
+                    address="net.tcp://localhost:8081/SessionBoundFactory"  
+                    binding="netTcpBinding"  
+                    contract="Shared.ISessionBoundFactory"/>  
+        </client>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+6.  セッションフル オブジェクトを作成して使用するために、クライアントでは、次の手順を実行する必要があります。  
+  
+    1.  ISessionBoundFactory サービスへのチャネルを作成する。  
+  
+    2.  このチャネルを使用してサービスを呼び出し、EndpointAddress10 を取得する。  
+  
+    3.  EndpointAddress10 を使用してチャネルを作成し、セッションフル オブジェクトを取得する。  
+  
+    4.  セッションフル オブジェクトと対話し、複数の呼び出し間でインスタンスが同じであることを示す。  
+  
+    ```  
+    ChannelFactory<ISessionBoundFactory> channelFactory =   
+        new ChannelFactory<ISessionBoundFactory>("factory");  
+    ISessionBoundFactory sessionFactory = channelFactory.CreateChannel();  
+  
+    EndpointAddress10 address1 = sessionFactory.GetInstanceAddress();  
+    EndpointAddress10 address2 = sessionFactory.GetInstanceAddress();  
+  
+    ChannelFactory<ISessionBoundObject> sessionObjectFactory1 =   
+        new ChannelFactory<ISessionBoundObject>(new NetTcpBinding(),   
+                                                address1.ToEndpointAddress());  
+    ChannelFactory<ISessionBoundObject> sessionObjectFactory2 =   
+        new ChannelFactory<ISessionBoundObject>(new NetTcpBinding(),   
+                                                address2.ToEndpointAddress());  
+  
+    ISessionBoundObject sessionInstance1 = sessionObjectFactory1.CreateChannel();  
+    ISessionBoundObject sessionInstance2 = sessionObjectFactory2.CreateChannel();  
+  
+    sessionInstance1.SetCurrentValue("Hello");  
+    sessionInstance2.SetCurrentValue("World");  
+  
+    if (sessionInstance1.GetCurrentValue() == "Hello" &&  
+        sessionInstance2.GetCurrentValue() == "World")  
+    {  
+        Console.WriteLine("sessionful server object works as expected");  
+    }  
+    ```  
+  
+ WCF は常に値渡しでオブジェクトを返しますが、EndpointAddress10 を使用することで、参照渡しのセマンティクスに相当するものをサポートすることは可能です。  これによって、クライアントからセッションフル WCF サービス インスタンスを要求できるようになり、要求後は他のすべての WCF サービスのように対話ができます。  
+  
+#### シナリオ 3: クライアントから値渡しのインスタンスをサーバーに送信する  
+ このシナリオでは、サーバーに値渡しで非プリミティブ オブジェクト インスタンスを送信するクライアントについて説明します。  WCF は値渡しでのみオブジェクトを送信するため、このシナリオでは通常の WCF の使用方法を示します。  
+  
+1.  シナリオ 1 と同じ WCF サービスを使用します。  
+  
+2.  クライアントを使用して新しい値渡しのオブジェクト \(Customer\) を作成し、チャネルを作成して ICustomerService サービスと通信し、それにオブジェクトを送信します。  
+  
+    ```  
+    ChannelFactory<ICustomerService> factory =  
+        new ChannelFactory<ICustomerService>("customerservice");  
+    ICustomerService service = factory.CreateChannel();  
+    PremiumCustomer customer = new PremiumCustomer {   
+    FirstName = "Bob",   
+    LastName = "Jones",   
+    CustomerId = 43,   
+    AccountId = 99};  
+    bool success = service.UpdateCustomer(customer);  
+    Console.WriteLine(String.Format("  Server returned {0}.", success));  
+    ```  
+  
+     Customer オブジェクトはシリアル化され、サーバーに送信されて、そのオブジェクトの新しいコピーへと逆シリアル化されます。  
+  
+    > [!NOTE]
+    >  このコードでは、派生型 \(PremiumCustomer\) の送信についても示しています。  サービス インターフェイスは Customer オブジェクトを要求していますが、Customer クラスの \[KnownType\] 属性は、PremiumCustomer も同様に許可されていることを示していました。  このサービス インターフェイスによって他の型をシリアル化または逆シリアル化しようとしても、WCF は必ず失敗します。  
+  
+ WCF での通常のデータ交換は、値渡しで行われます。  これにより、こういったデータ オブジェクトの 1 つでのメソッド呼び出しはローカルでのみ実行され、他の階層ではコードが呼び出されないことが保証されています。  *サーバーから*返される参照渡しのオブジェクトのようなものを実現することは可能ですが、*クライアントからサーバー*に参照渡しのオブジェクトを渡すことはできません。  クライアントとサーバーの間で対話を必要とするシナリオは、WCF で双方向サービスを使用することによって実現できます。  詳細については、「[双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)」を参照してください。  
+  
+<a name="Summary"></a>   
+## 概要  
+ .NET リモート処理は、完全に信頼できる環境内のみでの使用を意図した通信フレームワークです。  これはレガシー製品であり、旧バージョンとの互換性のためだけにサポートされています。  新しいアプリケーションの構築には使用できません。  反対に、WCF はセキュリティを考慮して設計されており、新規および既存のアプリケーション向けに推奨されています。  既存のリモート処理アプリケーションから、WCF または ASP.NET Web API を使用したアプリケーションに移行することをお勧めします。
\ No newline at end of file
diff --git a/docs/framework/wcf/operating-system-resources-required-by-wcf.md b/docs/framework/wcf/operating-system-resources-required-by-wcf.md
new file mode 100644
index 00000000000..ac0775bc745
--- /dev/null
+++ b/docs/framework/wcf/operating-system-resources-required-by-wcf.md
@@ -0,0 +1,29 @@
+---
+title: "WCF に必要なオペレーティング システム リソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cdd9a331-53fe-4e0d-bdfe-782264aec5c9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WCF に必要なオペレーティング システム リソース
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は、オペレーティング システムで提供される複数のリソースに基づいて機能します。  このリソースを次の表に示します。  
+  
+|リソース|説明|  
+|----------|--------|  
+|Microsoft 分散トランザクション コーディネーター \(MSDTC\)|OleTx トランザクションをサポートするために必要です。|  
+|インターネット インフォメーション サービス \(IIS\)|IIS を使用してアプリケーションをホストする場合に必要です。|  
+|Windows プロセス アクティブ化サービス \(WAS\)|WAS を使用してアプリケーションをホストする場合に必要です。|  
+  
+## 参照  
+ [システム要件](../../../docs/framework/wcf/wcf-system-requirements.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/privacy-information.md b/docs/framework/wcf/privacy-information.md
new file mode 100644
index 00000000000..bf80bd8e52b
--- /dev/null
+++ b/docs/framework/wcf/privacy-information.md
@@ -0,0 +1,413 @@
+---
+title: "Windows Communication Foundation のプライバシー情報 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プライバシー情報 [WCF]"
+  - "WCF, プライバシー情報"
+  - "Windows Communication Foundation, プライバシー情報"
+ms.assetid: c9553724-f3e7-45cb-9ea5-450a22d309d9
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# Windows Communication Foundation のプライバシー情報
+マイクロソフトは、エンド ユーザーのプライバシー保護に力を入れています。  [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] \(バージョン 3.0\) を使用してアプリケーションを作成した場合、アプリケーションがエンド ユーザーのプライバシーに影響する可能性があります。  たとえば、アプリケーションが明示的にユーザーの連絡先情報を収集することがあります。つまり、アプリケーションがインターネットを経由して Web サイトに情報を要求したり、情報を送信したりすることがあります。  マイクロソフトの技術をアプリケーションに組み込んでいる場合、その技術にプライバシーに影響を与える可能性がある独自の動作が存在することがあります。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、アプリケーションの作成者またはエンド ユーザーが選択しない限り、アプリケーションからマイクロソフトに情報を送信することはありません。  
+  
+## WCF の概要  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] とは、Microsoft .NET Framework を使用した分散メッセージング フレームワークで、これによって開発者は、分散アプリケーションを作成できます。  2 つのアプリケーション間で交換されるメッセージには、ヘッダーと本文情報が入ります。  
+  
+ ヘッダーには、アプリケーションが使用するサービスに応じて、メッセージ ルーティング、セキュリティ情報、トランザクションなどの情報が追加されます。  メッセージは、通常、既定で暗号化されます。  ただし、`BasicHttpBinding` を使用する場合は例外です。このバインディングは、セキュリティで保護されていない従来の Web サービスで使用するために設計されています。  アプリケーションの設計者であるユーザーには最終設計に対する責任があります。  SOAP 本文のメッセージには、アプリケーション固有のデータが入りますが、アプリケーション定義の個人情報などのデータは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の暗号化機能または機密性保護機能を使用してセキュリティで保護できます。  次のセクションでは、プライバシーに影響を与える可能性がある機能について説明します。  
+  
+## メッセージング  
+ 各 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージには、メッセージの送信先と応答の返信先を指定するアドレス ヘッダーがあります。  
+  
+ エンドポイント アドレスのアドレス構成要素は、エンドポイントを識別する URI \(Uniform Resource Identifier\) です。  このアドレスは、ネットワーク アドレスまたは論理アドレスのいずれかです。  アドレスには、コンピューター名 \(ホスト名、完全修飾ドメイン名\) と IP アドレスを指定できます。  また、エンドポイント アドレスには、グローバル一意識別子 \(GUID\)、または各アドレスを識別するために使用される一時アドレス指定用に GUID のコレクションを入れることもできます。  各メッセージには、GUID 形式のメッセージ ID があります。  この機能は、WS\-Addressing 参照仕様に準拠します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージング レイヤーは個人情報をローカル コンピューターに書き込みません。  ただし、サービスの開発者が個人情報を公開するサービスを作成した場合は、ネットワーク レベルで個人情報を公開することがあります。このような例として、エンドポイント名に個人名を使用している場合や、エンドポイントの Web サービス記述言語に個人情報を追加しても、https を使用して WSDL にアクセスすることをクライアントに要求しない場合などがあります。  また、個人情報を公開するエンドポイントに対して [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を実行すると、そのツールの出力に個人情報が追加される可能性があります。その出力ファイルは、ローカルのハード ディスクに書き込まれます。  
+  
+## ホスト  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のホスト機能によって、アプリケーションを必要に応じて開始したり、複数のアプリケーション間でポートを共有したりできます。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のアプリケーションは、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] 同様、インターネット インフォメーション サービス \(IIS\) でホストできます。  
+  
+ ホストでは、特定の情報をネットワークに公開せず、コンピューター上にデータを格納しません。  
+  
+## メッセージのセキュリティ  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のセキュリティは、メッセージング アプリケーションにセキュリティ機能を提供します。  提供するセキュリティ機能には、認証と承認があります。  
+  
+ 認証は、クライアントとサービスとの間で資格情報を交換することによって実行されます。  認証は、次のように、トランスポート レベルのセキュリティまたは SOAP メッセージ レベルのセキュリティで実行できます。  
+  
+-   SOAP メッセージ セキュリティでは、発行者に応じて、ユーザー名とパスワード、X.509 証明書、Kerberos チケット、SAML トークンのような資格情報を使用して認証が実行されます。このすべての資格情報は、個人情報を含んでいる可能性があります。  
+  
+-   トランスポート セキュリティでは、HTTP 認証方式 \(Basic、Digest、Negotiate、Integrated Windows Authorization、NTLM、None、および Anonymous\) のような従来のトランスポート認証機構によって認証が実行されます。  
+  
+ 認証によって、通信するエンドポイント間にセキュリティで保護されたセッションを確立できます。  このセッションは、セキュリティ セッションの有効期間が切れるまで有効な GUID によって識別されます。  格納されるデータと格納場所を次の表に示します。  
+  
+|データ|ストレージ|  
+|---------|-----------|  
+|ユーザー名、X.509 証明書、Kerberos トークンなどのプレゼンテーション資格情報、および資格情報への参照|Windows 証明書ストアなど、標準の Windows 資格情報管理機構|  
+|ユーザー名とパスワードなど、ユーザーのメンバーシップ情報|[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] メンバーシップ プロバイダー|  
+|クライアントに対するサービスの認証に使用されるサービスの ID 情報|サービスのエンドポイント アドレス|  
+|呼び出し元情報|監査ログ|  
+  
+## 監査  
+ 監査では、認証イベントと承認イベントの成功と失敗を記録します。  監査レコードには、サービス URI、アクション URI、および呼び出し元の ID が入ります。  
+  
+ また、監査では、管理者がメッセージ ログの設定 \(オンまたはオフ\) を変更した時刻を記録します。その理由は、メッセージ ログが、ヘッダーと本文のアプリケーション固有のデータをログに記録する可能性があるためです。  [!INCLUDE[wxp](../../../includes/wxp-md.md)] の場合、レコードはアプリケーション イベント ログに記録されます。  [!INCLUDE[wv](../../../includes/wv-md.md)] と [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] の場合、レコードは、セキュリティ イベント ログに記録されます。  
+  
+## トランザクション  
+ トランザクション機能は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のアプリケーションにトランザクション サービスを提供します。  
+  
+ トランザクションの伝達で使用されるトランザクション ヘッダーには、GUID 形式のトランザクション ID または登録リスト ID を追加できます。  
+  
+ トランザクション機能では、Microsoft 分散トランザクション コーディネーター \(MSDTC\) トランザクション マネージャー \(Windows コンポーネントの 1 つ\) を使用して、トランザクション状態を管理します。  既定では、トランザクション マネージャー間の通信は暗号化されます。  トランザクション マネージャーは、エンドポイント参照、トランザクション ID、および登録リスト ID を永続状態の一部としてログに記録できます。  この状態の有効期間は、トランザクション マネージャーのログ ファイルの有効期間によって決まります。  MSDTC サービスがこのログを所有し、管理します。  
+  
+ トランザクション機能は、WS\-Coordination 仕様と WS\-AtomicTransaction 仕様を実装します。  
+  
+## 信頼できるセッション  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の信頼できるセッションは、トランスポートまたは中継局のエラーが発生した場合でもメッセージの転送を実現します。  信頼できるセッションは、基になるトランスポート \(たとえば、ワイヤレス ネットワーク上の TCP 接続\) が切断している場合やメッセージを紛失した場合 \(HTTP プロキシでの送受信メッセージの破棄\) でも、正確に 1 回のメッセージ転送を実行します。  また、メッセージが送信された順序を維持するので、メッセージの並べ替え \(マルチパス ルーティングの場合に発生する可能性がある\) を回復できます。  
+  
+ 信頼できるセッションは、WS\-ReliableMessaging \(WS\-RM\) プロトコルを使用して実装されています。  これによって追加される WS\-RM ヘッダーには、特定の信頼できるセッションに関連付けられたすべてのメッセージの識別に使用されるセッション情報が含まれています。  各 WS\-RM セッションには、GUID 形式の識別子があります。  
+  
+ エンド ユーザーのコンピューターに保持される個人情報はありません。  
+  
+## キューに置かれたチャネル  
+ キューは、送信元アプリケーションが送ったメッセージを受信側アプリケーションに代わって保存しておき、後で受信側アプリケーションに転送します。  受信側アプリケーションが一時的な場合なども、キューによって、送信元アプリケーションから受信側アプリケーションへのメッセージの転送を確実に実行できます。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、トランスポートとして Microsoft メッセージ キュー \(MSMQ\) を使用することによってキューをサポートします。  
+  
+ キューに置かれたチャネル機能では、ヘッダーをメッセージに追加しません。  代わりに、適切なメッセージ キューのメッセージ プロパティ セットを備えたメッセージ キューのメッセージを作成し、メッセージ キューのメソッドを呼び出して、メッセージ キューのキューにメッセージを追加します。  メッセージ キューは、Windows に付属しているオプション コンポーネントです。  
+  
+ キューに置かれたチャネル機能では、キュー インフラストラクチャとしてメッセージ キューを使用するので、この機能によってエンド ユーザーのコンピューターに保持される情報はありません。  
+  
+## COM\+ 統合  
+ この機能は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のサービスと互換性のあるサービスを作成するために既存の COM 機能と COM\+ 機能をラップします。  この機能は、特定のヘッダーを使用せず、エンド ユーザーのコンピューターにデータを保持しません。  
+  
+## COM サービス モニカー  
+ この機能は、標準の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントにアンマネージ ラッパーを提供します。  この機能は、ネットワーク上で特定のヘッダーを使用せず、コンピューターにデータを保持しません。  
+  
+## ピア チャネル  
+ ピア チャネルによって、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用したマルチパーティ アプリケーションの展開が可能になります。  マルチパーティ メッセージングはメッシュのコンテキストで実行されます。  メッシュは、ノードが参加できる名前によって識別されます。  ピア チャネル内の各ノードは、ユーザー指定のポートで TCP リスナーを作成し、メッシュ内の他のノードとの接続を確立することによって、回復力を確保します。  メッシュ内の他のノードに接続するため、ノードは、リスナー アドレスやコンピューターの IP アドレスなど一部のデータをメッシュ内の他のノードと交換します。  メッシュ内で送信されるメッセージに送信者に関するセキュリティ情報を入れ、メッセージのなりすましと改ざんを防止することができます。  
+  
+ エンド ユーザーのコンピューターに個人情報は格納されません。  
+  
+## IT 専門家向けの機能  
+  
+### トレース  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インフラストラクチャの診断機能は、トランスポート レイヤーとサービス モデル レイヤーを経由するメッセージ、およびこのメッセージに関連付けられたアクティビティとイベントをログに記録します。  この機能は既定で無効になっています。  この機能はアプリケーションの構成ファイルを使用して有効にし、トレース動作は、実行時に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] WMI プロバイダーを使用して変更できます。  有効にすると、トレース インフラストラクチャは、メッセージ、アクティビティ、および処理イベントを含んだ診断トレースを構成済みリスナーに出力します。  出力の形式と場所は、管理者が選択するリスナー構成によって決まりますが、通常は XML 形式のファイルです。  管理者は、トレース ファイルでアクセス制御リスト \(ACL\) を設定する必要があります。  特に、Windows アクティベーション システム \(WAS\) でホストするとき、管理者は、ファイルがパブリック仮想ルート ディレクトリから提供されていないことを確認する必要があります \(提供されることを望まない場合\)。  
+  
+ トレースには、メッセージ ログとサービス モデル診断トレースの 2 種類があります。この 2 種類のトレースについて次のセクションで説明します。  この 2 つのトレースは、それぞれ <xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A> と <xref:System.ServiceModel> というトレース ソースから構成されます。  このログ トレース ソースは両方とも、アプリケーションにローカルなデータを取り込みます。  
+  
+### メッセージ ログ  
+ メッセージ ログのトレース ソース \(<xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A>\) によって管理者は、システムを通過するメッセージをログに記録できます。  ユーザーは構成によって、メッセージ全体またはメッセージ ヘッダーだけをログに記録するかどうか、トランスポート レイヤーまたはサービス モデル レイヤーでログに記録するかどうか、および形式が正しくないメッセージをログに記録するかどうかを設定できます。  また、ユーザーは、フィルター処理を設定して、ログに記録するメッセージを制限できます。  
+  
+ 既定では、メッセージ ログは無効になっています。  ローカル コンピューターの管理者は、アプリケーション レベルの管理者がメッセージ ログを有効にするのを防止できます。  
+  
+#### 暗号化および復号化されるメッセージ ログ  
+ メッセージは、以下に説明するようにログに記録され、暗号化および復号化されます。  
+  
+ トランスポート ログ  
+ トランスポート レベルで送受信されるメッセージをログに記録します。  このメッセージは、すべてのヘッダーを含んでいて、ネットワーク上に送信される前と受信されるときに暗号化できます。  
+  
+ メッセージがネットワーク上に送信される前と受信されるときに暗号化される場合、そのメッセージは暗号化されたままログに記録されます。  例外は、セキュリティ プロトコル \(https\) を使用する場合です。メッセージは、ネットワーク上で暗号化されている場合でも、送信前と受信後は復号化された状態でログに記録されます。  
+  
+ サービス ログ  
+ チャネル ヘッダー処理が実行された後、ユーザー コードを入力する直前と直後に、サービス モデル レベルで送受信されるメッセージをログに記録します。  
+  
+ このレベルでログに記録されるメッセージは、ネットワーク上でセキュリティ保護され、暗号化されている場合でも復号化されます。  
+  
+ 形式が正しくないメッセージのログ  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インフラストラクチャが認識できないまたは処理できないメッセージをログに記録します。  
+  
+ メッセージは、暗号化の有無を問わず、そのままの状態でログに記録されます。  
+  
+ メッセージが復号化された状態または暗号化されていない状態でログに記録される場合、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では既定で、メッセージをログに記録する前にセキュリティ キーと個人情報の可能性がある情報をメッセージから削除します。  次のセクションでは、削除される情報と削除が実行される状況について説明します。  キーと個人情報の可能性がある情報をログに記録するには、コンピューターの管理者とアプリケーションを配置するユーザーの両方が、所定の構成操作を実行して既定の動作を変更する必要があります。  
+  
+#### 復号化されたまたは暗号化されていないメッセージをログに記録するときにメッセージ ヘッダーから削除される情報  
+ メッセージが復号化された状態または暗号化されていない状態でログに記録される場合、既定ではメッセージがログに記録される前に、セキュリティ キーと個人情報の可能性がある情報がメッセージ ヘッダーとメッセージ本文から削除されます。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によってキーおよび個人情報の可能性がある情報と見なされる部分を次のリストに示します。  
+  
+ 削除されるキー :  
+  
+ \- xmlns:wst\="http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/trust" および xmlns:wst\="http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust" の場合  
+  
+ wst:BinarySecret  
+  
+ wst:Entropy  
+  
+ \- xmlns:wsse\="http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-wssecurity\-secext\-1.1.xsd" および xmlns:wsse\="http:\/\/docs.oasis\-open.org\/wss\/2005\/xx\/oasis\-2005xx\-wss\-wssecurity\-secext\-1.1.xsd" の場合  
+  
+ wsse:Password  
+  
+ wsse:Nonce  
+  
+ 削除される個人情報の可能性がある情報 :  
+  
+ \- xmlns:wsse\="http:\/\/docs.oasis\-open.org\/wss\/2004\/01\/oasis\-200401\-wss\-wssecurity\-secext\-1.1.xsd" および xmlns:wsse\="http:\/\/docs.oasis\-open.org\/wss\/2005\/xx\/oasis\-2005xx\-wss\-wssecurity\-secext\-1.1.xsd" の場合  
+  
+ wsse:Username  
+  
+ wsse:BinarySecurityToken  
+  
+ \- xmlns:saml\="urn:oasis:names:tc:SAML:1.0:assertion" の場合、下記の太字の項目が削除されます。  
+  
+ \<Assertion  
+  
+ MajorVersion\="1"  
+  
+ MinorVersion\="1"  
+  
+ AssertionId\="\[ID\]"  
+  
+ Issuer\="\[string\]"  
+  
+ IssueInstant\="\[dateTime\]"  
+  
+ \>  
+  
+ \<Conditions NotBefore\="\[dateTime\]" NotOnOrAfter\="\[dateTime\]"\>  
+  
+ \<AudienceRestrictionCondition\>  
+  
+ \<Audience\>\[uri\]\<\/Audience\>\+  
+  
+ \<\/AudienceRestrictionCondition\>\*  
+  
+ \<DoNotCacheCondition \/\>\*  
+  
+ \<\!\-\- abstract base type  
+  
+ \<Condition \/\>\*  
+  
+ \-\-\>  
+  
+ \<\/Conditions\>?  
+  
+ \<Advice\>  
+  
+ \<AssertionIDReference\>\[ID\]\<\/AssertionIDReference\>\*  
+  
+ \<Assertion\>\[assertion\]\<\/Assertion\>\*  
+  
+ \[any\]\*  
+  
+ \<\/Advice\>?  
+  
+ \<\!\-\- Abstract base types  
+  
+ \<Statement \/\>\*  
+  
+ \<SubjectStatement\>  
+  
+ \<Subject\>  
+  
+ `<NameIdentifier`  
+  
+ `NameQualifier="[string]"?`  
+  
+ `Format="[uri]"?`  
+  
+ `>`  
+  
+ `[string]`  
+  
+ `</NameIdentifier>?`  
+  
+ \<SubjectConfirmation\>  
+  
+ \<ConfirmationMethod\>\[anyUri\]\<\/ConfirmationMethod\>\+  
+  
+ \<SubjectConfirmationData\>\[any\]\<\/SubjectConfirmationData\>?  
+  
+ \<ds:KeyInfo\>...\<\/ds:KeyInfo\>?  
+  
+ \<\/SubjectConfirmation\>?  
+  
+ \<\/Subject\>  
+  
+ \<\/SubjectStatement\>\*  
+  
+ \-\-\>  
+  
+ \<AuthenticationStatement  
+  
+ AuthenticationMethod\="\[uri\]"  
+  
+ AuthenticationInstant\="\[dateTime\]"  
+  
+ \>  
+  
+ \[Subject\]  
+  
+ `<SubjectLocality`  
+  
+ `IPAddress="[string]"?`  
+  
+ `DNSAddress="[string]"?`  
+  
+ `/>?`  
+  
+ \<AuthorityBinding  
+  
+ AuthorityKind\="\[QName\]"  
+  
+ Location\="\[uri\]"  
+  
+ Binding\="\[uri\]"  
+  
+ \/\>\*  
+  
+ \<\/AuthenticationStatement\>\*  
+  
+ \<AttributeStatement\>  
+  
+ \[Subject\]  
+  
+ \<Attribute  
+  
+ AttributeName\="\[string\]"  
+  
+ AttributeNamespace\="\[uri\]"  
+  
+ \>  
+  
+ `<AttributeValue>[any]</AttributeValue>+`  
+  
+ \<\/Attribute\>\+  
+  
+ \<\/AttributeStatement\>\*  
+  
+ \<AuthorizationDecisionStatement  
+  
+ Resource\="\[uri\]"  
+  
+ Decision\="\[Permit&#124;Deny&#124;Indeterminate\]"  
+  
+ \>  
+  
+ \[Subject\]  
+  
+ \<Action Namespace\="\[uri\]"\>\[string\]\<\/Action\>\+  
+  
+ \<Evidence\>  
+  
+ \<AssertionIDReference\>\[ID\]\<\/AssertionIDReference\>\+  
+  
+ \<Assertion\>\[assertion\]\<\/Assertion\>\+  
+  
+ \<\/Evidence\>?  
+  
+ \<\/AuthorizationDecisionStatement\>\*  
+  
+ \<\/Assertion\>  
+  
+#### 復号化されたまたは暗号化されていないメッセージをログに記録するときにメッセージ本文から削除される情報  
+ 前述のとおり、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、復号化されたまたは暗号化されていないメッセージをログに記録する場合、キーと既知の可能性がある個人情報をメッセージ ヘッダーから削除します。  それに加えて、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、次のリストに示す、キー交換に関係するセキュリティ メッセージを記述する本文要素とアクションについて、キーと既知の可能性がある個人情報をメッセージ本文から削除します。  
+  
+ 次の名前空間の場合 :  
+  
+ xmlns:wst\="http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/trust" と xmlns:wst\="http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust" \(有効なアクションがない場合など\)  
+  
+ キー交換を伴うこの本文要素について情報が削除されます。  
+  
+ wst:RequestSecurityToken  
+  
+ wst:RequestSecurityTokenResponse  
+  
+ wst:RequestSecurityTokenResponseCollection  
+  
+ 次の各アクションについても情報が削除されます。  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/Issue  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/Issue  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/Renew  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/Renew  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/Cancel  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/Cancel  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/Validate  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/Validate  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/SCT  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/SCT  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/SCT\/Amend  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/SCT\/Amend  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/SCT\/Renew  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/SCT\/Renew  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RST\/SCT\/Cancel  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2005\/02\/trust\/RSTR\/SCT\/Cancel  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/security\/trust\/RST\/SCT  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/security\/trust\/RSTR\/SCT  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/security\/trust\/RST\/SCT\-Amend  
+  
+ http:\/\/schemas.xmlsoap.org\/ws\/2004\/04\/security\/trust\/RSTR\/SCT\-Amend  
+  
+#### 情報が削除されないアプリケーション固有のヘッダーと本文データ  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、アプリケーション固有のヘッダー \(クエリ文字列など\) と本文データ \(クレジット カード番号など\) にある個人情報を追跡しません。  
+  
+ メッセージ ログが有効な場合、アプリケーション固有のヘッダーと本文情報にある個人情報はログに表示される可能性があります。  そのため、この場合もアプリケーションを配置するユーザーが、構成ファイルとログ ファイルに対する ACL を設定する必要があります。  また、この情報を表示しない場合にログを無効にすることや、情報がログに記録された後で、この情報をログ ファイルからフィルターで除外することもできます。  
+  
+### サービス モデル トレース  
+ サービス モデルのトレース ソース \(<xref:System.ServiceModel>\) によって、メッセージ処理に関するアクティビティとイベントのトレースを実行できます。  この機能では、<xref:System.Diagnostics> から .NET Framework 診断機能を使用します。  <xref:System.ServiceModel.Configuration.DiagnosticSection.MessageLogging%2A> プロパティと同様、場所とその ACL は、.NET Framework アプリケーションの構成ファイルを使用してユーザーが設定できます。  メッセージ ログと同様、管理者がトレースを有効にするときに必ずファイルの場所が設定されるので、管理者は ACL を制御できます。  
+  
+ スコープ内のメッセージに含まれるメッセージ ヘッダーをトレースします。  前のセクションで説明した、メッセージ ヘッダーに含まれる個人情報の可能性がある情報を非表示にする場合と同じ規則が適用されます。既定では、先に示した個人情報はトレース時にヘッダーから削除されます。  個人情報の可能性がある情報をログに記録するには、コンピューターの管理者とアプリケーションを配置するユーザーの両方が構成を変更する必要があります。  ただし、アプリケーション固有のヘッダーにある個人情報はトレース時にログに記録されます。  アプリケーションを配置するユーザーは、構成ファイルとトレース ファイルに対する ACL を設定する必要があります。  また、この情報を表示しない場合にトレースを無効にすることや、情報がログに記録された後で、この情報をトレース ファイルからフィルターで除外することもできます。  
+  
+ ServiceModel トレースの一部として、一意な ID \(呼び出されたアクティビティ ID、通常は GUID\) は、インフラストラクチャのさまざまな部分を通過するメッセージとして、異なる複数のアクティビティを結合します。  
+  
+#### カスタム トレース リスナー  
+ メッセージ ログとトレースの両方で、カスタム トレース リスナーを構成できます。このリスナーは、ネットワーク上で、リモート データベースなどにトレースとメッセージを送信できます。  アプリケーションを配置するユーザーは、カスタム リスナーを構成するか、ユーザーがリスナーを構成できるようにする必要があります。  また、遠隔地で公開される個人情報に対しても責任があり、この遠隔地に ACL を適切に適用する必要があります。  
+  
+### IT 専門家向けのその他の機能  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、Windows に付属の WMI から [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インフラストラクチャ構成情報を公開する WMI プロバイダーが用意されています。  既定では、WMI インターフェイスは管理者が利用できます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成では、.NET Framework 構成のしくみを使用します。  構成ファイルはコンピューターに保存されます。  アプリケーション開発者と管理者が、アプリケーションの要件に応じて構成ファイルと ACL を作成します。  構成ファイルには、エンドポイント アドレスと証明書ストア内の証明書へのリンクを入れることができます。  証明書を使用してアプリケーション データを提供し、アプリケーションによって使用される機能の各プロパティを構成することができます。  
+  
+ また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、<xref:System.Environment.FailFast%2A> メソッドを呼び出すことによって、.NET Framework のプロセス ダンプ機能を使用します。  
+  
+### IT 専門家のツール  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、次の IT 専門家向けのツールも用意されており、Windows SDK に同梱されています。  
+  
+#### SvcTraceViewer.exe  
+ このビューアーは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレース ファイルを表示します。  このビューアーは、トレースに含まれているすべての情報を表示します。  
+  
+#### SvcConfigEditor.exe  
+ このエディターでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成ファイルを作成し、編集できます。  このエディターは、構成ファイルに含まれているすべての情報を表示します。  テキスト エディターでも同じ操作を実行できます。  
+  
+#### ServiceModel\_Reg  
+ このツールでは、コンピューター上の ServiceModel のインストールを管理できます。  このツールは、実行時にコンソール ウィンドウにステータス メッセージを表示し、処理中に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インストールの構成に関する情報を表示できます。  
+  
+#### WSATConfig.exe と WSATUI.dll  
+ このツールによって、IT 専門家は [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で相互運用可能な WS\-AtomicTransaction ネットワーク サポートを構成できます。  このツールは、レジストリに格納された最も一般的に使用される WS\-AtomicTransaction 設定の値を表示し、ユーザーはこのツールを使用してその値を変更できます。  
+  
+## 広範囲に使用できる機能  
+ 次の機能は広範囲に使用できます。  つまり、前述の任意の機能と共に構成できます。  
+  
+### サービス フレームワーク  
+ ヘッダーには、インスタンス ID を入れることができます。このインスタンス ID は、メッセージを CLR クラスのインスタンスに関連付ける GUID です。  
+  
+ Web サービス記述言語 \(WSDL\) には、ポートの定義が入ります。  各ポートには、エンドポイント アドレス、およびアプリケーションが使用するサービスを表すバインディングがあります。  WSDL の公開は、構成を使用して無効にできます。  コンピューターに保持される情報はありません。  
+  
+## 参照  
+ [Windows Communication Foundation](http://msdn.microsoft.com/ja-jp/fd327ade-0260-4c40-adbe-b74645ba3277)   
+ [セキュリティ](../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/publishing-metadata-endpoints.md b/docs/framework/wcf/publishing-metadata-endpoints.md
new file mode 100644
index 00000000000..8d1aa2b3ceb
--- /dev/null
+++ b/docs/framework/wcf/publishing-metadata-endpoints.md
@@ -0,0 +1,30 @@
+---
+title: "メタデータ エンドポイントを公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 29cd8a60-dfb7-460c-bf5a-c2b31b782671
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# メタデータ エンドポイントを公開する
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスは 1 つ以上のメタデータ エンドポイントを公開することにより、メタデータを公開します。サービス メタデータを公開すると、そのメタデータで WS\-MetadataExchange \(MEX\) や HTTP\/GET 要求などの標準化プロトコルを使用できるようになります。メタデータのエンドポイントは、アドレス、バインディング、およびコントラクトを持つ他のサービス エンドポイントに似ており、構成またはコードを使用してサービス ホストに追加できます。メタデータ エンドポイントの公開を有効にするには、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> サービス動作をサービスに追加する必要があります。  
+  
+## このセクションの内容  
+ [方法 : 構成ファイルを使用してサービスのメタデータを公開する](../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-a-configuration-file.md)  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを構成してメタデータを公開し、クライアントが `?wsdl` クエリ文字列を使用した WS\-MetadataExchange または HTTP\/GET 要求によりメタデータを取得できるようにする方法を示します。  
+  
+ [方法 : コードを使用してサービスのメタデータを公開する](../../../docs/framework/wcf/feature-details/how-to-publish-metadata-for-a-service-using-code.md)  
+ コードを使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスのメタデータの公開を有効にして、`?wsdl` クエリ文字列を使用した WS\-MetadataExchange または HTTP\/GET 要求によりメタデータをクライアントが取得できるようにする方法を示します。  
+  
+## 参照  
+ [メタデータの公開](../../../docs/framework/wcf/feature-details/publishing-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/reliable-services.md b/docs/framework/wcf/reliable-services.md
new file mode 100644
index 00000000000..ba06bd59f24
--- /dev/null
+++ b/docs/framework/wcf/reliable-services.md
@@ -0,0 +1,56 @@
+---
+title: "信頼できるサービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], 信頼できるサービス"
+  - "WCF [WCF], 信頼できるメッセージング"
+  - "WCF [WCF], 信頼できるセッション"
+  - "Windows Communication Foundation [WCF], 信頼できるメッセージング"
+  - "Windows Communication Foundation [WCF], 信頼できるセッション"
+ms.assetid: 07814ed0-0775-47f2-987b-d8134fdd5099
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 信頼できるサービス
+キューおよび信頼できるセッションは、信頼できるメッセージングを実装する [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] の機能です。このトピックでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の信頼できるメッセージング機能について説明します。  
+  
+ *信頼できるメッセージング*とは、信頼できるメッセージング送信元 \(*送信元* と呼ぶ\) から信頼できるメッセージング送信先 \(*送信先*と呼ぶ\) にメッセージを確実に転送することを指します。  
+  
+ 信頼できるメッセージングは、次の機能を実行します。  
+  
+-   メッセージ転送エラーまたはトランスポート エラーに関係なく、送信元から送信先に送られるメッセージの転送が保証されること。  
+  
+-   送信元と送信先を互いに分離すること。これにより、送信元または送信先が利用できない場合でも、送信元と送信先でのそれぞれ独立したエラーと回復が可能になると共に、信頼できるメッセージの転送と配信が実現されます。  
+  
+ 信頼できるメッセージングを実現すると、待ち時間が長くなることがよくあります。*待ち時間*とは、メッセージが送信元から送信先に到達するまでにかかる時間です。そこで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、信頼できるメッセージングとして、次の 2 種類を提供します。  
+  
+-   [信頼できるセッション](../../../docs/framework/wcf/feature-details/reliable-sessions.md) : 長い待ち時間という代償を伴わずに、信頼できる転送を実現します。  
+  
+-   [WCF のキュー](../../../docs/framework/wcf/feature-details/queues-in-wcf.md) : 信頼できる転送、および送信元と送信先の分離を共に実現します。  
+  
+## 信頼できるセッション  
+ 信頼できるセッションでは、メッセージング \(送信元および送信先\) エンドポイントを分離する中継局の数や種類に関係なく、WS\-ReliableMessaging プロトコルを使用して、送信元から送信先へのエンドツーエンドの信頼できるメッセージ転送を実現します。これには SOAP を使用しないトランスポート手段 \(HTTP プロキシなど\)、またはエンドポイント間でメッセージをやりとりする場合に必要となる SOAP を使用する手段 \(SOAP ベースのルーターやブリッジなど\) が含まれます。信頼できるセッションでは、メモリ内転送ウィンドウを使用して、トランスポート エラーが発生した場合に SOAP メッセージ レベル エラーをマスクし、接続を再確立します。  
+  
+ 信頼できるセッションは、待ち時間の短い、信頼できるメッセージ転送を実現します。これらは、TCP が IP ブリッジ経由のパケットで実現するものと同等の転送を、プロキシや中継局経由の SOAP メッセージで実現します。信頼できるセッション[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[信頼できるセッション](../../../docs/framework/wcf/feature-details/reliable-sessions.md)」を参照してください。  
+  
+### キュー  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のキューでは、待ち時間は長くなりますが、信頼できるメッセージの転送と共に送信元および送信先の分離が実現されます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のキュー通信は、Microsoft Message Queuing \(MSMQ\) に基づいています。  
+  
+ MSMQ は Windows のオプション コンポーネントとして付属します。MSMQ サービスは Windows サービスの 1 つとして実行されます。MSMQ サービスは、送信元の代わりに転送キューで転送用のメッセージを取得し、ターゲット キューに配信します。ターゲット キューは、送信先の代わりにメッセージを受け取り、後で送信先がメッセージを要求したときに配信します。MSMQ マネージャーは信頼できるメッセージ転送プロトコルを実装するため、転送中にメッセージが失われることはありません。このプロトコルは、ネイティブまたは SOAP リライアブル メッセージ プロトコル \(SRMP\) と呼ばれる SOAP ベースのプロトコルです。  
+  
+ キュー間でのメッセージの信頼できる転送に加え、送信元と送信先の分離により、疎結合されたアプリケーションで信頼できる通信を実現できます。信頼できるセッションとは異なり、送信元と送信先が同時に実行されている必要はありません。このため、送信元によるメッセージの生成レートと送信先によるメッセージの消費レートが一致しないときに、キューが実質上、負荷平準化機構として使用されるというシナリオが可能になります。キュー[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WCF のキュー](../../../docs/framework/wcf/feature-details/queues-in-wcf.md)」を参照してください。  
+  
+## 参照  
+ [信頼できるセッションの概要](../../../docs/framework/wcf/feature-details/reliable-sessions-overview.md)   
+ [WCF でのキュー](../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/renaming-a-wcf-service.md b/docs/framework/wcf/renaming-a-wcf-service.md
new file mode 100644
index 00000000000..e3352b23d4b
--- /dev/null
+++ b/docs/framework/wcf/renaming-a-wcf-service.md
@@ -0,0 +1,60 @@
+---
+title: "WCF サービス名の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14235a65-b1c5-409d-b6cc-a979acd54bbd
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# WCF サービス名の変更
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスの名前を変更する方法について説明します。  
+  
+## WCF サービス名の変更  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] テンプレートでサービスの名前を変更するには、次の手順を実行します。  
+  
+-   サービスを実装するクラスの名前を変更します。  
+  
+-   次の例に示すように、このサービスの構成ファイルで、サービスの名前を新しい名前に変更します。構成ファイルは、ホスト モデルに応じて、app.config または web.config ファイルのどちらかです。  
+  
+```  
+<system.servicemodel>  
+   <services>  
+      <service name=”WcfService.NewName”>  
+      </service>  
+   </services>  
+</system.servicemodel>  
+```  
+  
+-   サービスが Web ホストである場合、\*.svc ファイルが使用されます。この svc ファイルを開き、次の例に示すように、サービスの名前を変更します。自己ホスト アプリケーションには svc ファイルがないので、この手順は必要ありません。  
+  
+```  
+<%@ ServiceHost Service=”WcfService.NewName”>  
+```  
+  
+## WCF サービス コントラクト名の変更  
+  
+-   サービス コントラクトの名前を変更するには、次の手順を実行します。  
+  
+-   サービス コントラクトの名前を変更します。  
+  
+-   次の例に示すように、このサービスの構成ファイルで、サービス コントラクトの名前を新しい名前に変更します。構成ファイルは、ホスト モデルに応じて、app.config または web.config ファイルのどちらかです。  
+  
+```  
+<system.servicemodel>  
+   <services>  
+      <service>  
+         <endpoint contract=”WcfService.NewContractName” />  
+      </service>  
+   </services>  
+</system.servicemodel>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/TOC.md b/docs/framework/wcf/samples/TOC.md
new file mode 100644
index 00000000000..f1a61dbe5a7
--- /dev/null
+++ b/docs/framework/wcf/samples/TOC.md
@@ -0,0 +1,260 @@
+# [配信不能キュー](dead-letter-queues.md)
+# [ネット MSMQ バインディング](net-msmq-binding.md)
+# [カスタム サービス ホスト](custom-service-host.md)
+# [カスタム Demux](custom-demux.md)
+# [双方向通信](two-way-communication.md)
+# [クライアント](client.md)
+# [フォーム ポスト](form-post.md)
+# [ローカル チャネル](local-channel.md)
+# [フィード フォーマッタ (JSON)](feed-formatter-json.md)
+# [メタデータ拡張](metadata-extensibility.md)
+# [WS トランザクション フロー](ws-transaction-flow.md)
+# [同時実行](concurrency.md)
+# [本文要素別のディスパッチ](dispatch-by-body-element.md)
+# [ASP.NET キャッシュ統合](aspnet-caching-integration.md)
+# [トランスポート セキュリティ付き BasicBinding](basicbinding-with-transport-security.md)
+# [デザイン パターン : リストに基づく公開/定期受信](design-patterns-list-based-publish-subscribe.md)
+# [NamedPipe アクティベーション](namedpipe-activation.md)
+# [SystemWebRouting 統合サンプル](systemwebrouting-integration-sample.md)
+# [クライアント検証](client-validation.md)
+# [CustomChannelTester](customchannelstester.md)
+# [WCF サービスと Event Tracing for Windows](wcf-services-and-event-tracing-for-windows.md)
+# [高度なエラー処理](advanced-error-handling.md)
+# [標準エンドポイントの使用](usage-of-standard-endpoints.md)
+# [トランザクション バッチ](transacted-batching.md)
+# [MSMQ 4.0 での有害メッセージ処理](poison-message-handling-in-msmq-4-0.md)
+# [SAML トークン プロバイダー](saml-token-provider.md)
+# [メタデータの抽出](retrieve-metadata.md)
+# [クライアント相互運用性](client-interoperability.md)
+# [既定の NetTcpBinding](default-nettcpbinding.md)
+# [カスタム トークン](custom-token.md)
+# [NetNamedPipeBinding](netnamedpipebinding.md)
+# [構成を使用しない AJAX サービス](ajax-service-without-configuration.md)
+# [バイトストリーム エンコーダー](bytestream-encoder.md)
+# [チャネルのチャンキング](chunking-channel.md)
+# [メッセージ コントラクト](message-contracts.md)
+# [SOAP エンドポイントおよび HTTP エンドポイント](soap-and-http-endpoints.md)
+# [MSMQ アクティベーション](msmq-activation.md)
+# [WCF モニカーの COM クライアントと組み合わせての使用](using-the-wcf-moniker-with-com-clients.md)
+# [拡張保護ポリシー](extended-protection-policy.md)
+# [DataContractSerializer サンプル](datacontractserializer-sample.md)
+# [高度な形式選択](advanced-format-selection.md)
+# [サービス操作へのアクセスの承認](authorizing-access-to-service-operations.md)
+# [Windows Communication Foundation サンプルの実行](running-the-samples.md)
+# [形式の自動選択](automatic-format-selection.md)
+# [ReceiveContext 製品ジェネレーター](receivecontext-enabled-wcf-channels.md)
+# [基本的な AJAX サービス](basic-ajax-service.md)
+# [アドレス指定](addressing.md)
+# [スタンドアロン診断フィード](stand-alone-diagnostics-feed-sample.md)
+# [メッセージ セキュリティ Windows](message-security-windows.md)
+# [SRMP](srmp.md)
+# [機能拡張](extensibility.md)
+# [ツール サンプル](tool-samples.md)
+# [バインディング拡張](binding-extensibility.md)
+# [ASP.NET 互換性](aspnet-compatibility.md)
+# [XmlSerializer エラー](xmlserializer-faults.md)
+# [メッセージ セキュリティ ユーザー名](message-security-user-name.md)
+# [カスタム バインディングの信頼できるセッション](custom-binding-reliable-session.md)
+# [PII セキュリティ ロックダウン](pii-security-lockdown.md)
+# [CustomDiscoveryMetadata](customdiscoverymetadata.md)
+# [信頼されたファサード サービス](trusted-facade-service.md)
+# [メッセージ セキュリティ匿名](message-security-anonymous.md)
+# [WCF セキュリティの暗号化方式の指定](cryptographic-agility-in-wcf-security.md)
+# [インスタンス化](instancing.md)
+# [Basic](basic-sample.md)
+# [JSONP](jsonp.md)
+# [Use および Style プロパティの設定](setting-the-use-and-style-properties.md)
+# [TCP アクティベーション](tcp-activation.md)
+# [二重](duplex.md)
+# [サービス セキュリティ](service-security.md)
+# [Windows Presentation Foundation クライアントでのデータ バインディング](data-binding-in-a-wpf-client.md)
+# [探索のセキュリティのサンプル](discovery-security-sample.md)
+# [KnownAssemblyAttribute](knownassemblyattribute.md)
+# [エラー コントラクト](fault-contract.md)
+# [配信の拡張のサンプル](syndication-extensibility-samples.md)
+# [カスタム検索基準](custom-find-criteria.md)
+# [動的再構成](dynamic-reconfiguration.md)
+# [ConcurrencyMode.Reentrant](concurrencymode-reentrant.md)
+# [基本的なデータ コントラクト](basic-data-contract.md)
+# [アドレス ヘッダー](address-headers.md)
+# [動作](behaviors.md)
+# [DataContract サロゲート](datacontract-surrogate.md)
+# [Using ステートメントに関する問題の回避](avoiding-problems-with-the-using-statement.md)
+# [探索バインディング要素のサンプル](discovery-binding-element-sample.md)
+# [ETW トレース](etw-tracing.md)
+# [シリアル化バインダーの使用](usage-of-serialization-binder.md)
+# [ファイアウォール手順](firewall-instructions.md)
+# [ASMX Web サービスとの相互運用性](interoperating-with-asmx-web-services.md)
+# [カスタム バインディング セキュリティ](custom-binding-security.md)
+# [Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](one-time-setup-procedure-for-the-wcf-samples.md)
+# [WebContentTypeMapper](webcontenttypemapper-sample.md)
+# [トレースとメッセージ ログ](tracing-and-message-logging.md)
+# [メッセージ セキュリティ バインディング](message-security-binding.md)
+# [データ バインドのシナリオ](data-binding-scenarios.md)
+# [Windows フォーム クライアントのデータ バインディング](data-binding-in-a-windows-forms-client.md)
+# [カスタム セキュア メタデータ エンドポイント](custom-secure-metadata-endpoint.md)
+# [サービス コントラクト](service-contracts.md)
+# [AJAX](ajax.md)
+# [サービス デバッグ動作](service-debug-behavior.md)
+# [メッセージ インスペクター](message-inspectors.md)
+# [一意の ListenUri モードのサンプルを使用したサービスの探索](discover-a-service-with-unique-listen-uri-mode-sample.md)
+# [ルーティング サービス](routing-services.md)
+# [WS デュアル Http](ws-dual-http.md)
+# [カスタム メッセージ フィルター](custom-message-filter.md)
+# [WSStreamedHttpBinding](wsstreamedhttpbinding.md)
+# [永続性インスタンス コンテキスト](durable-instance-context.md)
+# [概要](getting-started-sample.md)
+# [インターネット インフォメーション サービスのホスティング手順](internet-information-service-hosting-instructions.md)
+# [アナウンス](announcements-sample.md)
+# [トークン プロバイダー](token-provider.md)
+# [データ コントラクト](data-contracts.md)
+# [Reliable Secure Profile](reliable-secure-profile.md)
+# [WS 2007 フェデレーション HTTP バインディング](ws-2007-federation-http-binding.md)
+# [単一 ListenUri に対する複数のエンドポイント](multiple-endpoints-at-a-single-listenuri.md)
+# [メッセージ セキュリティ証明書](message-security-certificate.md)
+# [複数のエンドポイント](multiple-endpoints.md)
+# [JSON および XML 形式の AJAX サービス](ajax-service-with-json-and-xml-sample.md)
+# [高度なフィルター](advanced-filters.md)
+# [メッセージ キュー統合](message-queueing-integration.md)
+# [クライアントの偽装](impersonating-the-client.md)
+# [ホスト](hosting.md)
+# [Windows Communication Foundation サンプル](index.md)
+# [既知の型](known-types.md)
+# [Web](web.md)
+# [複合型を使用した AJAX サービス](ajax-service-using-complex-types-sample.md)
+# [BasicBinding](basicbinding.md)
+# [WS 信頼できるセッション](ws-reliable-session.md)
+# [トークン認証システム](token-authenticator.md)
+# [メッセージ エンコーダー拡張](message-encoder-extensibility.md)
+# [ワークフローの探索のサンプル](workflow-discovery-sample.md)
+# [メッセージ セキュリティ サンプル](message-security-sample.md)
+# [MTOM エンコーディング](mtom-encoding.md)
+# [シナリオ](scenario.md)
+# [カスタム チャネル ディスパッチャー](custom-channel-dispatcher.md)
+# [フェデレーション サンプル](federation-sample.md)
+# [メッセージ キュー (MSMQ) のインストール](installing-message-queuing-msmq.md)
+# [XMLSerializer サンプル](xmlserializer-sample.md)
+# [オブジェクト参照](object-references.md)
+# [非同期検索](asynchronous-find-sample.md)
+# [インスタンス化拡張](instancing-extensibility.md)
+# [サービス ID サンプル](service-identity-sample.md)
+# [Windows Communication Foundation でのメッセージ キュー](wcf-to-message-queuing.md)
+# [メタデータ公開動作](metadata-publishing-behavior.md)
+# [永続性発行済みトークン プロバイダー](durable-issued-token-provider.md)
+# [構成](configuration-sample.md)
+# [一方向](one-way.md)
+# [カスタム メッセージ インターセプター](custom-message-interceptor.md)
+# [トランスポート: UDP](transport-udp.md)
+# [トランザクション MSMQ バインディング](transacted-msmq-binding.md)
+# [サービスの説明](service-description.md)
+# [カスタム バインディング強制](custom-binding-imperative.md)
+# [Windows Communication Foundation へのメッセージ キュー](message-queuing-to-wcf.md)
+# [トランスポート : UDP 経由のカスタム トランザクション](transport-custom-transactions-over-udp-sample.md)
+# [DataContractResolver](datacontractresolver.md)
+# [探索の機能拡張](discovery-extensibility.md)
+# [カスタム バインディングのトランスポートとエンコード](custom-binding-transport-and-encoding.md)
+# [スコープを使用した探索](discovery-with-scopes-sample.md)
+# [カスタム メッセージ エンコーダー : カスタム テキスト エンコーダー](custom-message-encoder-custom-text-encoder.md)
+# [ASP.NET クライアントでのデータ バインディング](data-binding-in-an-aspnet-client.md)
+# [プール](pooling.md)
+# [トークンのサポート](supporting-tokens.md)
+# [型指定のあるクライアント](typed-client.md)
+# [WS バインディング](ws-binding.md)
+# [XmlReader サンプル](xmlreader-sample.md)
+# [WCF 分析トレース](wcf-analytic-tracing.md)
+# [循環トレース](circular-tracing.md)
+# [トランスポート : WSE 3.0 TCP 相互運用性](transport-wse-3-0-tcp-interoperability.md)
+# [UriTemplate テーブル](uritemplate-table-sample.md)
+# [既定のメッセージ コントラクト](default-message-contract.md)
+# [サービス監査動作](service-auditing-behavior.md)
+# [ストリーム](stream.md)
+# [カスタム メッセージ エンコーダー : 圧縮エンコーダー](custom-message-encoder-compression-encoder.md)
+# [インライン コードを使用した IIS ホスティング](iis-hosting-using-inline-code.md)
+# [弱く型指定された拡張](loosely-typed-extensions-sample.md)
+# [管理](management.md)
+# [カスタム有効期間](custom-lifetime.md)
+# [探索](discovery-samples.md)
+# [配信](syndication.md)
+# [強制](imperative.md)
+# [ネット バインディング](net-binding.md)
+# [チャネル拡張](channels-extensibility.md)
+# [UDP アクティベーション](udp-activation.md)
+# [ブリッジとエラー処理](bridging-and-error-handling.md)
+# [セキュリティ検証](security-validation.md)
+# [セッションとキュー](sessions-and-queues.md)
+# [HTTP 受信確認チャネル](http-acknowledgement-channel.md)
+# [WMI プロバイダー](wmi-provider.md)
+# [サービス](services.md)
+# [エラー処理およびレポートに対する制御の拡張](extending-control-over-error-handling-and-reporting.md)
+# [既定のサービスの動作](default-service-behavior.md)
+# [基本的なリソース サービス](basic-resource-service.md)
+# [ユーザー名パスワード検証](user-name-password-validator.md)
+# [調整](throttling.md)
+# [メッセージ相関](message-correlation.md)
+# [WCF サービス付き ASMX クライアント](asmx-client-with-a-wcf-service.md)
+# [探索ルーター サービス](discovery-router-service.md)
+# [条件付きの Get と Put](conditional-get-and-put.md)
+# [カスタム バインディング](custom-binding.md)
+# [トランスポート拡張](transport-extensibility.md)
+# [仮想ディレクトリのセットアップ手順](virtual-directory-setup-instructions.md)
+# [JSON シリアル化](json-serialization.md)
+# [構成チャネル ファクトリ](configuration-channel-factory.md)
+# [カスタム WSDL パブリケーション](custom-wsdl-publication.md)
+# [UriTemplate テーブル ディスパッチャー](uritemplate-table-dispatcher-sample.md)
+# [X.509 証明書検証](x-509-certificate-validator.md)
+# [ConfigurationCodeGenerator](configurationcodegenerator.md)
+# [相互運用性の拡張](interop-extensibility.md)
+# [POCO サポート](poco-support.md)
+# [Windows プロセス アクティブ化](windows-process-activation.md)
+# [セッション](session.md)
+# [サービス相互運用性](service-interoperability.md)
+# [WS トランスポート セキュリティ](ws-transport-security.md)
+# [メッセージ キューを介したメッセージ セキュリティ](message-security-over-message-queuing.md)
+# [バインド](binding.md)
+# [コントラクト](contract.md)
+# [複数のコントラクト](multiple-contracts.md)
+# [トレースの拡張](extending-tracing.md)
+# [セキュリティ拡張](security-extensibility.md)
+# [基本的なバインディング](basic-binding.md)
+# [予期される例外](expected-exceptions.md)
+# [階層的な構成モデル](hierarchical-configuration-model.md)
+# [Windows Communication Foundation サンプルのビルド](building-the-samples.md)
+# [基本的な HTTP サービス](basic-http-service.md)
+# [WSHttpBinding](wshttpbinding.md)
+# [構成ベースのアクティブ化](configuration-based-activation.md)
+# [ストリーミング フィード](streaming-feeds-sample.md)
+# [WCF サービスの簡略化された構成](simplified-configuration-for-wcf-services.md)
+# [探索プロキシのサンプル](discovery-proxy-sample.md)
+# [承認ポリシー](authorization-policy.md)
+# [操作フォーマッタと操作セレクター](operation-formatter-and-operation-selector.md)
+# [Windows サービス ホスト](windows-service-host.md)
+# [HTTP POST を使用する AJAX サービス](ajax-service-using-http-post.md)
+# [サービス トランザクションの動作](service-transaction-behavior.md)
+# [動作のセキュリティ](behavior-security.md)
+# [FindPrivateKey](findprivatekey.md)
+# [HTTPS を介したカスタム バインディングの信頼できるセッション](custom-binding-reliable-session-over-https.md)
+# [NetTCPBinding](nettcpbinding.md)
+# [初期化のインスタンス化](instancing-initialization.md)
+# [DataContractSerializer と DataContractResolver を使用した NetDataContractSerializer 機能の提供](datacontractserializer-datacontractresolver-netdatacontractserializer.md)
+# [OperationContextScope](operationcontextscope.md)
+# [インターネット インフォメーション サービス (IIS) サーバー証明書インストール手順](iis-server-certificate-installation-instructions.md)
+# [Web 拡張](web-extensibility.md)
+# [HttpCookieSession](httpcookiesession.md)
+# [ルーティング サービスを使用した Hello World](hello-world-with-the-routing-service.md)
+# [メンバーシップとロール プロバイダー](membership-and-role-provider.md)
+# [メッセージ資格情報付き WS トランスポート](ws-transport-with-message-credential.md)
+# [揮発性キューによる通信](volatile-queued-communication.md)
+# [型指定のない要求/応答](untyped-request-reply.md)
+# [セットアップ手順](set-up-instructions.md)
+# [弱い型指定の JSON のシリアル化 (AJAX)](weakly-typed-json-serialization-sample.md)
+# [UriTemplate](uritemplate-sample.md)
+# [チャネル ファクトリ](channel-factory.md)
+# [本文別のルーティング](route-by-body.md)
+# [AspNetRouteIntegration](aspnetrouteintegration.md)
+# [自己ホスト](self-host.md)
+# [セキュリティ](security-in-wcf.md)
+# [Basic](basic.md)
+# [Net.TCP ポート共有のサンプル](net-tcp-port-sharing-sample.md)
+# [厳密に型指定された拡張](strongly-typed-extensions-sample.md)
+# [ラップされていないメッセージ](unwrapped-messages.md)
+# [パフォーマンス カウンターの使用](using-performance-counters.md)
diff --git a/docs/framework/wcf/samples/address-headers.md b/docs/framework/wcf/samples/address-headers.md
new file mode 100644
index 00000000000..e6b0500e7fb
--- /dev/null
+++ b/docs/framework/wcf/samples/address-headers.md
@@ -0,0 +1,95 @@
+---
+title: "アドレス ヘッダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0c94d4a-3bde-4b4d-bb6d-9f12bc3a6940
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# アドレス ヘッダー
+アドレス ヘッダーのサンプルでは、クライアントが [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、サービスに参照パラメータを渡す方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ WS\-Addressing 仕様では、特定の Web サービスのエンドポイントのアドレスを指定するための方法として、エンドポイント参照の概念が定義されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、エンドポイント参照は `EndpointAddress` クラスを通じてモデル化されます。`EndpointAddress` は、`ServiceEndpoint` クラスの Address フィールドの型です。  
+  
+ エンドポイント参照モデルの一部では、各参照は、追加の識別情報を追加する複数の参照パラメータを伝達できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、これらの参照パラメータは `AddressHeader` クラスのインスタンスとしてモデル化されます。  
+  
+ このサンプルでは、クライアントはクライアント エンドポイントの `EndpointAddress` に参照パラメータを追加します。サービスはこの参照パラメータを検索し、その値を "Hello" サービス操作のロジックに使用します。  
+  
+## クライアント  
+ クライアントから参照パラメータを送信するには、`ServiceEndpoint` の `EndpointAddress` に `AddressHeader` を追加する必要があります。`EndpointAddress` クラスは不変なので、EndpointAddress の変更は `EndpointAddressBuilder` クラスを通じて行う必要があります。参照パラメータをメッセージの一部として送信するためにクライアントを初期化するコードを、次に示します。  
+  
+```  
+HelloClient client = new HelloClient();  
+EndpointAddressBuilder builder =   
+    new EndpointAddressBuilder(client.Endpoint.Address);  
+AddressHeader header =   
+    AddressHeader.CreateAddressHeader(IDName, IDNamespace, "John");  
+builder.Headers.Add(header);  
+client.Endpoint.Address = builder.ToEndpointAddress();  
+```  
+  
+ このコードは、元の `EndpointAddress` を初期値として使用して `EndpointAddressBuilder` を作成します。次に、新しく作成されたアドレス ヘッダーを追加します。つまり `CreateAddressHeadercreates` を呼び出して、特定の名前、名前空間、および値を持つヘッダーを作成します。ここでの値は "John" です。ヘッダーがビルダに追加されると、`ToEndpointAddress()` メソッドが \(不変の\) ビルダを \(不変の\) エンドポイント アドレスに変換し直し、これをクライアント エンドポイントの Address フィールドに再度割り当てます。  
+  
+ ここで、クライアントは `Console.WriteLine(client.Hello());` サービスを呼び出します。このサービスは、このアドレス パラメータの値を取得できます。結果として得られるクライアントの出力は次のとおりです。  
+  
+ `Hello, John`  
+  
+## サーバー  
+ サービス操作 `Hello()` の実装では、現在の `OperationContext` を使用して、入力メッセージのヘッダーの値を検査します。  
+  
+```  
+string id = null;  
+// look at headers on incoming message  
+for (int i = 0;   
+     i < OperationContext.Current.IncomingMessageHeaders.Count;   
+     ++i)  
+{  
+    MessageHeaderInfo h =   
+        OperationContext.Current.IncomingMessageHeaders[i];  
+    // for any reference parameters with the correct name & namespace  
+    if (h.IsReferenceParameter &&   
+        h.Name == IDName &&   
+        h.Namespace == IDNamespace)  
+    {  
+        // read the value of that header  
+        XmlReader xr =   
+OperationContext.Current.IncomingMessageHeaders.GetReaderAtHeader(i);  
+        id = xr.ReadElementContentAsString();  
+    }  
+}  
+return "Hello, " + id;  
+```  
+  
+ このコードでは、入力メッセージのすべてのヘッダーを反復処理して、特定の名前を持つ参照パラメーターを検索します。パラメーターが見つかると、そのパラメーター値を読み取って "id" 変数に格納します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\AddressHeaders`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/addressing.md b/docs/framework/wcf/samples/addressing.md
new file mode 100644
index 00000000000..0c73a35b9f0
--- /dev/null
+++ b/docs/framework/wcf/samples/addressing.md
@@ -0,0 +1,149 @@
+---
+title: "アドレス指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d438e6f2-d0f3-43aa-b259-b51b5bda2e64
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# アドレス指定
+アドレス指定のサンプルでは、エンドポイント アドレスのさまざまな特性と機能を示します。  このサンプルは、[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)に基づいています。  このサンプルでは、サービスは自己ホスト型です。  サービスとクライアントは両方ともコンソール アプリケーションです。  サービスでは、エンドポイントの相対アドレスと絶対アドレスを組み合わせて複数のエンドポイントを定義します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス構成ファイルでは、1 つのベース アドレスと 4 つのエンドポイントを指定します。  ベース アドレスは、次のサンプル構成のように add 要素を使用して service\/host\/baseAddresses の下に指定します。  
+  
+```  
+<service   
+    name="Microsoft.ServiceModel.Samples.CalculatorService"  
+    behaviorConfiguration="CalculatorServiceBehavior">  
+  <host>  
+    <baseAddresses>  
+      <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+    </baseAddresses>  
+  </host>  
+  ...  
+</service>  
+```  
+  
+ 次のサンプル構成の 1 番目のエンドポイント定義では、相対アドレスを指定します。つまり、エンドポイント アドレスは、ベース アドレスと URI 構造の規則に従った相対アドレスの組み合わせということを意味します。  
+  
+```  
+<!-- Empty relative address specified:   
+     use the base address provided by the host. -->  
+<!-- The endpoint address is  
+     http://localhost:8000/ServiceModelSamples/service. -->  
+<endpoint address=""  
+          binding="wsHttpBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ この場合、相対アドレスが空 \(""\) のため、エンドポイント アドレスはベース アドレスと同じになります。  具体的には http:\/\/localhost:8000\/servicemodelsamples\/service です。  
+  
+ 2 番目のエンドポイント定義でも、相対アドレスを指定します。次のサンプル構成を参照してください。  
+  
+```  
+<!-- The relative address specified: use the base address -->  
+<!-- provided by the host + path. The endpoint address is -->  
+<!-- http://localhost:8000/servicemodelsamples/service/test. -->  
+<endpoint address="/test"  
+          binding="wsHttpBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ 相対アドレス "test" がベース アドレスの末尾に追加されています。  具体的には http:\/\/localhost:8000\/servicemodelsamples\/service\/test です。  
+  
+ 3 番目のエンドポイント定義では、絶対アドレスを指定します。次のサンプル構成を参照してください。  
+  
+```  
+<endpoint address="http://localhost:8001/hello/servicemodelsamples"  
+          binding="wsHttpBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ このアドレスでは、ベース アドレスは使用されていません。  具体的には http:\/\/localhost:8001\/hello\/servicemodelsamples です。  
+  
+ 4 番目のエンドポイント アドレスは、絶対アドレスと別のトランスポート \(ここでは TCP\) を指定しています。  このアドレスでは、ベース アドレスは使用されていません。  具体的には net.tcp:\/\/localhost:9000\/servicemodelsamples\/service です。  
+  
+```  
+<!-- The absolute address specified, different transport: -->  
+<!-- use the specified address, and ignore the base address. -->  
+<!-- The endpoint address is -->  
+<!-- net.tcp://localhost:9000/servicemodelsamples/service. -->  
+<endpoint address=  
+          "net.tcp://localhost:9000/servicemodelsamples/service"  
+          binding="netTcpBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+</service>  
+```  
+  
+ クライアントがアクセスするのは、4 つのサービス エンドポイントのうちの 1 つだけですが、4 つすべてのエンドポイントがこの構成ファイルに定義されています。  クライアントは `CalculatorProxy` オブジェクトの作成時にエンドポイントを選択します。  `CalculatorEndpoint1` から `CalculatorEndpoint4` までの構成名を変更することにより、それぞれのエンドポイントを実行できます。  
+  
+ このサンプルを実行する際、サービスはそれぞれのエンドポイントのアドレス、バインディング名、およびコントラクト名を列挙します。  ServiceHost から見た場合、メタデータ交換 \(MEX\) エンドポイントは他と同じエンドポイントにすぎません。したがって、このエンドポイントもこの一覧に表示されます。  
+  
+```  
+Service endpoints:  
+Endpoint - address:  http://localhost:8000/ServiceModelSamples/service  
+           binding:  WSHttpBinding  
+           contract: ICalculator  
+Endpoint - address:  http://localhost:8000/ServiceModelSamples/service/test  
+           binding:  WSHttpBinding  
+           contract: ICalculator  
+Endpoint - address:  http://localhost:8001/hello/servicemodelsamples  
+           binding:  WSHttpBinding  
+           contract: ICalculator  
+Endpoint - address:  net.tcp://localhost:9000/servicemodelsamples/service  
+           binding:  NetTcpBinding  
+           contract: ICalculator  
+Endpoint - address:  http://localhost:8000/ServiceModelSamples/service/mex  
+           binding:  MetadataExchangeHttpBinding  
+           contract: IMetadataExchange  
+  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+```  
+  
+ このクライアントを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。  どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Addressing`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/advanced-error-handling.md b/docs/framework/wcf/samples/advanced-error-handling.md
new file mode 100644
index 00000000000..7e914ec9e34
--- /dev/null
+++ b/docs/framework/wcf/samples/advanced-error-handling.md
@@ -0,0 +1,135 @@
+---
+title: "高度なエラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed54b687-78af-4eda-8507-9fd081bdea1a
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 高度なエラー処理
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーティング サービスを示します。  ルーティング サービスは、コンテンツ ベースのルーターをアプリケーションに簡単に追加できるようにする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントです。  このサンプルでは、トランザクションやその他のより複雑なメッセージ概念 \(マルチキャストなど\) を使用して、ルーティング サービスをエラーから自動的に回復する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\RoutingServices\AdvancedErrorHandling`  
+  
+## サンプルの詳細  
+ このサンプルのルーティング サービスは、MSMQ キューからメッセージを読み取り、そのメッセージを 2 つのキュー リストにマルチキャストするように構成されています。  サービス キューに使用されるリストとログ キューに使用されるリストです。  
+  
+ 既定では、ルーティング サービスで使用するように構成された MSMQ バインディングによってトランザクションの使用がサポートされるため、メッセージはトランザクション メッセージとなり、それぞれのリストの少なくとも 1 つのキューで受信されないと、ルーティング サービスから受信キュー \(`InQ`\) に、メッセージが正常にルーティングされたとは報告されません。  しがたって、両方のサービス キューまたは両方のログ キューが使用できない場合は、メッセージをルーティングできなかったこと、および受信キューで何らかの処理が必要であることが報告されます。  この処理には、メッセージをシステム配信不能キューに移動することが含まれます。  
+  
+#### このサンプルを使用するには  
+  
+1.  > [!IMPORTANT]
+    >  このサンプルを実行する前に、MSMQ をインストールしてください。  MSMQ がインストールされていないと、サンプルの実行中に例外メッセージが返されます。  MSMQ のインストール手順については、「[メッセージ キュー \(MSMQ\) のインストール](http://go.microsoft.com/fwlink/?LinkId=166437)」を参照してください。  
+  
+     [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して AdvancedErrorHandling.sln を開きます。  
+  
+2.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で F5 キーを押すか、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+    1.  Ctrl キーと Shift キーを押しながら B キーを押してアプリケーションをビルドする場合は、.\/RoutingService\/bin\/debug\/RoutingService.exe にあるアプリケーションを開始する必要があります。  
+  
+3.  コンソール ウィンドウで、Enter キーを押してクライアントを起動します。  
+  
+4.  クライアントから、ケースごとに、キューに関するさまざまな統計情報が返されます。  
+  
+    1.  ケース 1 \(エラーなし\) の場合は、次の出力が返されます。  
+  
+        ```Output  
+  
+                            受信キューに 0 個のメッセージがあります。  
+  
+        プライマリ サービス キューに 1 個のメッセージがあります。  
+  
+        バックアップ サービス キューに 0 個のメッセージがあります。  
+  
+        プライマリ ログ キューに 1 個のメッセージがあります。  
+  
+        バックアップ ログ キューに 0 個のメッセージがあります。  
+  
+        続行するには <Enter> キーを押してください。  
+  
+        ```  
+  
+    2.  ケース 3 \(プライマリ サービス キューとプライマリ ログ キューのエラー\) の場合は、次の出力が返されます。  
+  
+        ```Output  
+  
+        受信キューに 0 個のメッセージがあります。  
+  
+        プライマリ サービス キューが存在しません。  
+  
+        バックアップ サービス キューに 1 個のメッセージがあります。  
+  
+        プライマリ ログ キューが存在しません。  
+  
+        バックアップ ログ キューに 1 個のメッセージがあります。  
+  
+        続行するには <ENTER> キーを押してください。  
+  
+        ```  
+  
+    3.  ケース 4 \(プライマリ サービス キューとプライマリおよびバックアップ ログ キューのエラー\) の場合は、次の出力が返されます。  
+  
+        ```Output  
+  
+                            受信キューに 0 個のメッセージがあります。  
+  
+        プライマリ サービス キューが存在しません。  
+  
+        バックアップ サービス キューに 0 個のメッセージがあります。  
+  
+        プライマリ ログ キューが存在しません。  
+  
+        バックアップ ログ キューが存在しません。  
+  
+        システム配信不能キューに 1 個のメッセージがあります。  
+  
+        終了するには、<ENTER> キーを押してください。  
+  
+        ```  
+  
+    4.  ケース 2 \(プライマリ サービス キューのエラー\) の場合は、次の出力が返されます。  
+  
+        ```Output  
+  
+                            受信キューに 0 個のメッセージがあります。  
+  
+        プライマリ サービス キューが存在しません。  
+  
+        バックアップ サービス キューに 1 個のメッセージがあります。  
+  
+        プライマリ ログ キューに 1 個のメッセージがあります。  
+  
+        バックアップ ログ キューに 0 個のメッセージがあります。  
+  
+        続行するには <ENTER> キーを押してください。  
+  
+        ```  
+  
+## コードまたは App.config で構成可能  
+ サンプルは、提供された時点では、App.config ファイルを使用してルーターの動作を定義するように構成されています。  RoutingService\\App.config ファイルの名前を別の名前に変更して認識されないようにし、RoutingService\\Program.cs の `configDriven` フィールドの値を `false` に変更して、コードで定義された構成を使用することもできます。  どちらの方法でも、ルーターの動作は同じになります。  
+  
+### シナリオ  
+ このサンプルは、ルーティング サービスで高度なメッセージング機能 \(トランザクションや受信コンテキストなど\) を処理できること、およびそれらの機能を適切なエラー処理シナリオの一部として利用できることを示しています。  
+  
+### 実際のシナリオ  
+ Contoso では、ルーティング サービスを介したトランザクションの受信を利用して、エラー状態のときでも、必要なすべてのサービスで情報を受信できるようにしたいと考えています。  さらに、エラーを自動的に適切に処理し、エラー処理ロジックを利用してもメッセージを配信できない場合にはエラーが報告されるようにしたいと考えています。  そのために、計画的に特定のエンドポイントにフェールオーバーするようにルーティング サービスを構成し、必要に応じてトランザクションや受信コンテキストの作成、完了、ロールバック、中止などを行うことで、エラー状態をルーティング サービスで処理するようにしています。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/advanced-filters.md b/docs/framework/wcf/samples/advanced-filters.md
new file mode 100644
index 00000000000..aa62013f220
--- /dev/null
+++ b/docs/framework/wcf/samples/advanced-filters.md
@@ -0,0 +1,172 @@
+---
+title: "高度なフィルター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d81590f-e036-4f96-824a-4a187f462764
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 高度なフィルター
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーティング サービスを示します。ルーティング サービスは、コンテンツ ベースのルーターをアプリケーションに簡単に追加できるようにする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントです。このサンプルでは、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 電卓のサンプルを改良し、ルーティング サービスを使用して通信するようにします。そして、メッセージ フィルターとメッセージ フィルター テーブルを使用してコンテンツ ベースのルーティング ロジックを定義する方法を説明します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\RoutingServices\AdvancedFilters`  
+  
+## サンプルの詳細  
+ 次の表は、ルーティング サービスのメッセージ フィルター テーブルに追加されるメッセージ フィルターを示しています。  
+  
+|フィルター|規則|優先順位|  
+|-----------|--------|----------|  
+|If \(has header\)|Rounding|2|  
+|If \(showed up on Ep2\)|Regular|1|  
+|If \(showed up with Address2\)|Rounding|1|  
+|If \(RoundRobin1\)|Regular|0|  
+|If \(RoundRobin2\)|Rounding|0|  
+  
+ メッセージ フィルターとメッセージ フィルター テーブルは、コードまたはアプリケーション構成ファイルで作成および構成できます。このサンプルのメッセージ フィルターとメッセージ フィルター テーブルは、コードで定義されたものが RoutingService\\routing.cs ファイルに、アプリケーション構成ファイルで定義されたものが RoutingService\\App.config ファイルにあります。以降では、このサンプルのメッセージ フィルターとメッセージ フィルター テーブルをコードで作成する方法を説明します。  
+  
+ まず最初に、<xref:System.ServiceModel.Dispatcher.XPathMessageFilter> でカスタム ヘッダーを探します。<xref:System.ServiceModel.WSHttpBinding> の結果のエンベロープ バージョンでは SOAP 1.2 が使用されるため、SOAP 1.2 名前空間を使用するように XPath ステートメントを定義します。<xref:System.ServiceModel.Dispatcher.XPathMessageFilter> の既定の名前空間マネージャーでは SOAP 1.2 名前空間のプレフィックス \/s12 が既に定義されているため、このプレフィックスを使用できます。一方、クライアントが実際のヘッダー値を定義するために使用するカスタムの名前空間は含まれていないため、そのプレフィックスを定義する必要があります。このヘッダーを持つすべてのメッセージがこのフィルターに一致します。  
+  
+```  
+XPathMessageContext namespaceManager = new XPathMessageContext();  
+namespaceManager.AddNamespace("custom", "http://my.custom.namespace/");  
+  
+XPathMessageFilter xpathFilter = new XPathMessageFilter("/s12:Envelope/s12:Header/custom:RoundingCalculator = 1", namespaceManager);  
+  
+```  
+  
+ 2 番目のフィルターは、`calculatorEndpoint` で受信されたメッセージに一致する <xref:System.ServiceModel.Dispatcher.EndpointNameMessageFilter> です。エンドポイント名は、サービス エンドポイント オブジェクトの作成時に定義されます。  
+  
+```  
+EndpointNameMessageFilter endpointNameFilter = new EndpointNameMessageFilter("calculatorEndpoint");  
+  
+```  
+  
+ 3 番目のフィルターは、<xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter> です。このフィルターは、指定したアドレス プレフィックス \(アドレスの前半部分\) に一致するアドレスを持つエンドポイントで受信されたメッセージに一致します。この例のアドレス プレフィックスは "http:\/\/localhost\/routingservice\/router\/rounding\/" として定義されています。この場合、"http:\/\/localhost\/routingservice\/router\/rounding\/\*" 宛ての受信メッセージがこのフィルターに一致します。この例では、丸め処理を行う電卓のエンドポイントのアドレスが "http:\/\/localhost\/routingservice\/router\/rounding\/calculator" なので、このエンドポイントで受信されたメッセージがこのフィルターに一致することになります。  
+  
+```  
+PrefixEndpointAddressMessageFilter prefixAddressFilter = new PrefixEndpointAddressMessageFilter(new EndpointAddress("http://localhost/routingservice/router/rounding/"));  
+  
+```  
+  
+ 最後の 2 種類のメッセージ フィルターは、カスタムの <xref:System.ServiceModel.Dispatcher.MessageFilter> です。この例では、"RoundRobin" メッセージ フィルターが使用されています。このメッセージ フィルターは、付属の RoutingService\\RoundRobinMessageFilter.cs ファイルに作成されています。これらのフィルターを同じグループに設定すると、両方のフィルターが同時に `true` を返さないように、メッセージに一致したという報告と一致しないという報告を交互に行うようになります。  
+  
+```  
+RoundRobinMessageFilter roundRobinFilter1 = new RoundRobinMessageFilter("group1");  
+  
+RoundRobinMessageFilter roundRobinFilter2 = new RoundRobinMessageFilter("group1");  
+  
+```  
+  
+ 次に、これらすべてのメッセージ フィルターを <xref:System.ServiceModel.Dispatcher.MessageFilterTable%601> に追加します。その際に、メッセージ フィルター テーブルでフィルターが実行される順番を左右する優先度を指定します。優先度の高いフィルターが先に実行され、優先度の低いフィルターは後に実行されます。したがって、優先度が 2 のフィルターは優先度が 1 のフィルターより先に実行されます。優先度が指定されていない場合の既定の優先度は 0 です。メッセージ フィルター テーブルは、特定の優先度のフィルターをすべて実行してから次の優先度に移ります。特定の優先度で一致が検出された場合、それより低い優先度のフィルターでの検出は省略されます。  
+  
+> [!NOTE]
+>  ここではメッセージ フィルターの優先度の使い方を説明していますが、一般的には、優先度を設定しなくても正しく機能するようにフィルターを設計および構成するのがパフォーマンスの観点からも設計の観点からも理想的です。  
+  
+ 最初に追加するフィルターは、優先度が 2 に設定された XPath フィルターです。これが、最初に実行されるメッセージ フィルターです。このフィルターによってカスタム ヘッダーが検出されると、他のフィルターの結果に関係なく、メッセージは丸め処理を行う電卓のエンドポイントにルーティングされます。  
+  
+ 優先度 1 では 2 つのフィルターを追加します。これらのフィルターは、メッセージが優先度 2 の XPath フィルターに一致しなかった場合にのみ実行されます。この 2 つのフィルターは、受信したメッセージの宛先を特定する 2 とおりの方法を示しており、それぞれが、2 つのエンドポイントの一方でメッセージが受信されたかどうかを確認します。したがって、両方が同時に `true` を返すことはないため、同じ優先度で実行できます。  
+  
+ 最後に、優先度 0 \(最も低い優先度\) で RoundRobin メッセージ フィルターが実行されます。これらのフィルターは同じグループ名で構成されているため、一度に 1 つのフィルターのみが一致します。カスタム ヘッダーを持つメッセージと特定の仮想エンドポイント宛てのメッセージはすべて既にルーティングされているため、RoundRobin メッセージ フィルターによって処理されるメッセージは、カスタム ヘッダーを持たない、既定のルーターのエンドポイント宛てのメッセージだけです。これらのメッセージは呼び出しのたびに切り替えられるため、操作の半分は通常の電卓のエンドポイントに送られ、もう半分は丸め処理を行う電卓のエンドポイントに送られます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して AdvancedFilters.sln を開きます。  
+  
+2.  **ソリューション エクスプローラー**を開くには、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+3.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で F5 キーを押すか、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+    1.  F5 キーを押したときに必要なプロジェクトが自動的に起動されるようにする場合は、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。左ペインの **\[共通プロパティ\]** で **\[スタートアップ プロジェクト\]** をクリックします。**\[マルチ スタートアップ プロジェクト\]** をクリックし、すべてのプロジェクトに**開始**アクションを設定します。  
+  
+    2.  Ctrl キーと Shift キーを押しながら B キーを押してプロジェクトをビルドする場合は、次のアプリケーションを開始する必要があります。  
+  
+        1.  電卓クライアント \(.\/CalculatorClient\/bin\/client.exe\)  
+  
+        2.  電卓サービス \(.\/CalculatorService\/bin\/service.exe\)  
+  
+        3.  丸め処理を行う電卓サービス \(.\/RoundingCalcService\/bin\/service.exe\)  
+  
+        4.  ルーティング サービス \(.\/RoutingService\/bin\/RoutingService.exe\)  
+  
+4.  電卓クライアントのコンソール ウィンドウで、Enter キーを押してクライアントを起動します。選択可能な送信先エンドポイントの一覧が返されます。  
+  
+5.  対応する文字を入力して送信先エンドポイントを選択し、Enter キーを押します。  
+  
+6.  次に、カスタム ヘッダーを追加するかどうかを確認するメッセージが表示されます。追加する場合は Y \(Yes\) キーを、追加しない場合は N \(No\) キーを押して、Enter キーを押します。  
+  
+7.  選択に応じて異なる出力が表示されます。  
+  
+    1.  メッセージにカスタム ヘッダーを追加した場合は、次の出力が返されます。  
+  
+        ```Output  
+        Add(100,15.99) = 116  
+        Subtract(145,76.54) = 68.5  
+        Multiply(9,81.25) = 731.3  
+        Divide(22,7) = 3.1  
+  
+        ```  
+  
+    2.  カスタム ヘッダーを使用せずに丸め処理を行う電卓のエンドポイントを選択した場合は、次の出力が返されます。  
+  
+        ```Output  
+        Add(100,15.99) = 116  
+        Subtract(145,76.54) = 68.5  
+        Multiply(9,81.25) = 731.3  
+        Divide(22,7) = 3.1  
+  
+        ```  
+  
+    3.  カスタム ヘッダーを使用せずに通常の電卓のエンドポイントを選択した場合は、次の出力が返されます。  
+  
+        ```Output  
+        Add(100,15.99) = 115.99  
+        Subtract(145,76.54) = 6846  
+        Multiply(9,81.25) = 731.25  
+        Divide(22,7) = 3.14285714285714  
+  
+        ```  
+  
+    4.  カスタム ヘッダーを使用せずに既定のルーターのエンドポイントを選択した場合は、次の出力が返されます。  
+  
+        ```Output  
+        Add(100,15.99) = 116  
+        Subtract(145,76.54) = 68.46  
+        Multiply(9,81.25) = 731.3  
+        Divide(22,7) = 3.14285714285714  
+  
+        ```  
+  
+8.  また、電卓サービスと丸め処理を行う電卓サービスは、呼び出された操作のログをそれぞれのコンソール ウィンドウに出力します。  
+  
+9. 終了するには、クライアント コンソール ウィンドウで「`quit`」と入力するか、Enter キーを押します。  
+  
+10. サービスを終了するには、サービス コンソール ウィンドウで Enter キーを押します。  
+  
+## コードまたは App.config で構成可能  
+ サンプルは、提供された時点では、App.config ファイルを使用してルーターの動作を定義するように構成されています。RoutingService\\App.config ファイルの名前を別の名前に変更して認識されないようにし、RoutingService\\routing.cs の `ConfigureRouterViaCode()` に対するメソッド呼び出しのコメントを解除することもできます。どちらの方法でも、ルーターの動作は同じになります。  
+  
+### シナリオ  
+ このサンプルでは、1 つのエンドポイントを介して複数の種類または実装のサービスを公開することを可能にするコンテンツ ベースのルーターとして機能するルーターを示します。  
+  
+### 実際のシナリオ  
+ Contoso では、すべてのサービスを仮想化して 1 つのエンドポイントのみを公開し、そのエンドポイントを通じて複数の異なる種類のサービスへのアクセスを提供したいと考えています。この場合は、ルーティング サービスのコンテンツ ベースのルーティング機能を使用して受信要求の送信先を決定します。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/advanced-format-selection.md b/docs/framework/wcf/samples/advanced-format-selection.md
new file mode 100644
index 00000000000..e346ba7a4d7
--- /dev/null
+++ b/docs/framework/wcf/samples/advanced-format-selection.md
@@ -0,0 +1,56 @@
+---
+title: "高度な形式選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e02d9082-4d55-41d8-9329-98f6d1c77f06
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 高度な形式選択
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] REST プログラミング モデルを拡張して新しい送信応答形式をサポートする方法を示します。  また、このサンプルでは T4 テンプレートを使用して応答を XHTML ページとして返し、ビュースタイル プログラミング モデルの実装方法も示します。  
+  
+## サンプルの詳細  
+ このサンプルは、単純なサービスと、サービスに要求を発行するクライアント コードで構成されます。  サービスは、単一の \[WebGet\] 操作をサポートします。この操作には、`Message EchoListWithGet(string list);` のメソッド シグネチャがあります。  
+  
+ クライアントでサービスに対する要求が発行されると、`list` クエリ文字列パラメーターの項目のコンマで区切られた一覧が示され、サービスからは、XML、JSON、Atom、XHTML、または jpeg のいずれかの形式で同じ一覧が返されます。  
+  
+ サービスから返される応答の形式は、最初は `format` クエリ文字列パラメーターで決定され、2 回目は要求で指定された HTTP Accept ヘッダーで決定されます。  `format` クエリ文字列パラメーターの値が前に示した形式のいずれかである場合、応答はその形式で返されます。  `format` クエリ文字列が存在しない場合、サービスは要求からの Accept ヘッダー要素を反復処理し、サービスがサポートする最初のコンテンツ タイプの形式を返します。  
+  
+ 操作の戻り値の型については注意が必要です。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST プログラミング モデルは、操作で  <xref:System.ServiceModel.Channels.Message> 以外の型が返される場合にのみ XML 応答形式と JSON 応答形式をネイティブでサポートします。  ただし、戻り値の型として <xref:System.ServiceModel.Channels.Message> が使用されている場合、メッセージの内容の形式の設定は、開発者によって完全に制御されています。  
+  
+ このサンプルでは、<xref:System.ServiceModel.Web.WebOperationContext.CreateXmlResponse%2A> メソッド、<xref:System.ServiceModel.Web.WebOperationContext.CreateJsonResponse%2A> メソッドおよび <xref:System.ServiceModel.Web.WebOperationContext.CreateAtom10Response%2A> メソッドを使用して、文字列の一覧を XML、JSON、および ATOM のメッセージにそれぞれシリアル化しています。  jpeg 応答形式の場合は、<xref:System.ServiceModel.Web.WebOperationContext.CreateStreamResponse%2A> メソッドが使用され、画像はストリームに保存されます。  XHTML 応答の場合、<xref:System.ServiceModel.Web.WebOperationContext.CreateTextResponse%2A> が事前に処理された T4 テンプレートと共に使用されます。この T4 テンプレートは .tt ファイルと自動生成された .cs ファイルで構成されます。  開発者は、.tt ファイルを使用して変数と制御構造を含むテンプレート フォームで応答を作成できます。  T4 の[!INCLUDE[crabout](../../../../includes/crabout-md.md)] 「[テキスト テンプレートを使用した成果物の生成](http://go.microsoft.com/fwlink/?LinkId=166023)」を参照してください。  
+  
+ このサンプルは、コンソール アプリケーション内で実行される自己ホスト型サービスとクライアントで構成されています。  コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### このサンプルを実行するには  
+  
+1.  高度な形式選択サンプルのソリューションを開きます。  サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。  管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの **\[管理者として実行\]** をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーションの AdvancedFormatSelection プロジェクトを、デバッグを行わずに実行します。  コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  
+  
+3.  サンプルが実行されると、クライアントは要求をサービスに送信し、応答をコンソール ウィンドウに書き込みます。  応答の形式は、XML、JSON、Atom、および XHTML のいずれかになります。  
+  
+4.  .jpeg 形式の応答を要求できる URI を参照するよう要求されます。  ブラウザーを開き、指定された URI を参照します。  
+  
+5.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\AdvancedFormatSelection`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ajax-service-using-complex-types-sample.md b/docs/framework/wcf/samples/ajax-service-using-complex-types-sample.md
new file mode 100644
index 00000000000..5d40ee3da6f
--- /dev/null
+++ b/docs/framework/wcf/samples/ajax-service-using-complex-types-sample.md
@@ -0,0 +1,78 @@
+---
+title: "複合型を使用した AJAX サービスのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88242b99-4811-4cbe-8201-52ddf48fb174
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 複合型を使用した AJAX サービスのサンプル
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、複合型のインスタンスを作成し、そのインスタンスをサービスとクライアント間で JSON \(JavaScript Object Notation\) として送信する ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。AJAX サービスには、Web ブラウザー クライアントから JavaScript コードを使用してアクセスできます。このサンプルは、「[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)」のサンプルに基づいています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での AJAX サポートは、<xref:System.Web.UI.ScriptManager> コントロールを介して ASP.NET AJAX と共に使用できるように最適化されています。ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する例については、「[AJAX Samples](http://msdn.microsoft.com/ja-jp/f3fa45b3-44d5-4926-8cc4-a13c30a3bf3e)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 次に示すサンプルのサービスは、AJAX 固有のコードを持たない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。<xref:System.ServiceModel.Web.WebGetAttribute> 属性は適用されないため、既定の HTTP 動詞 \("POST"\) が使用されます。サービスには 1 つの `DoMath` 操作があります。この操作は、`MathResult` という名前の複合型を返します。複合型は標準のデータ コントラクト型で、AJAX 固有のコードも含まれていません。  
+  
+```  
+[DataContract]  
+    public class MathResult  
+    {  
+        [DataMember]  
+        public double sum;  
+        [DataMember]  
+        public double difference;  
+        [DataMember]  
+        public double product;  
+        [DataMember]  
+        public double quotient;  
+    }  
+```  
+  
+ 基本的な AJAX サービスのサンプルの場合と同様に、<xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> を使用してサービスに AJAX エンドポイントを作成します。  
+  
+ クライアント Web ページ ComplexTypeClientPage.aspx には、ユーザーがページの **\[Perform calculation\]** ボタンをクリックしたときにサービスを呼び出す ASP.NET および JavaScript コードが含まれています。サービスを呼び出すコードは、JSON 本文を作成し、HTTP POST を使用して送信します。これは、[HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md) サンプルと同様です。  
+  
+ サービス呼び出しに成功したら、生成された JavaScript オブジェクトのそれぞれのデータ メンバー \(`sum`、`difference`、`product`、および `quotient`\) にアクセスできます。  
+  
+```  
+function onSuccess(mathResult){  
+     document.getElementById("sum").value = mathResult.sum;  
+     document.getElementById("difference").value = mathResult.difference;  
+     document.getElementById("product").value = mathResult.product;  
+     document.getElementById("quotient").value = mathResult.quotient;  
+}  
+  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」で説明されているように、ソリューション ComplexTypeAjaxService.sln をビルドします。  
+  
+3.  http:\/\/localhost\/ServiceModelSamples\/ComplexTypeClientPage.aspx に移動します \(プロジェクト ディレクトリからブラウザーで ComplexTypeClientPage.aspx を開かないでください\)。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Ajax\ComplexTypeAjaxService`  
+  
+## 参照  
+ [基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ajax-service-using-http-post.md b/docs/framework/wcf/samples/ajax-service-using-http-post.md
new file mode 100644
index 00000000000..ad4a13eb944
--- /dev/null
+++ b/docs/framework/wcf/samples/ajax-service-using-http-post.md
@@ -0,0 +1,64 @@
+---
+title: "HTTP POST を使用する AJAX サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1ac80f20-ac1c-4ed1-9850-7e49569ff44e
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# HTTP POST を使用する AJAX サービス
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、HTTP POST を使用する [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Asynchronous JavaScript and XML \(AJAX\) サービスを作成する方法を示します。 AJAX サービスには、Web ブラウザー クライアントから基本的な JavaScript コードを使用してアクセスできます。 このサンプルは、[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md) のサンプルに基づいていますが、HTTP GET の代わりに HTTP POST を使用する点が異なります。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での AJAX サポートは、`ScriptManager` コントロールを介して ASP.NET AJAX と共に使用できるように最適化されています。 ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する例については、「[Ajax Samples](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 次に示すサンプルのサービスは、AJAX 固有のコードを持たない [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。  
+  
+ <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性が操作に適用されているか、または <xref:System.ServiceModel.Web.WebGetAttribute> 属性が適用されていない場合、既定の HTTP 動詞 \(“POST”\) が使用されます。 POST 要求は、GET 要求よりも作成が困難ですが、キャッシュされません。キャッシュが不適切な操作に対しては、POST 要求を使用します。  
+  
+```  
+[ServiceContract(Namespace = "PostAjaxService")]  
+    public interface ICalculator  
+    {        [WebInvoke]  
+        double Add(double n1, double n2);  
+        //Other operations omitted…  
+    }  
+  
+```  
+  
+ 基本的な AJAX サービスのサンプルの場合と同様に、<xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> を使用してサービスに AJAX エンドポイントを作成します。  
+  
+ GET 要求とは異なり、POST サービスはブラウザーから呼び出すことができません。 たとえば、http:\/\/localhost\/ServiceModelSamples\/service.svc\/Add?n1\=100&n2\=200 に移動すると、エラーになります。これは、URL ではなく、JSON 形式で `n1` パラメーターと `n2` パラメーターがメッセージ本文で送信されることを POST サービスが想定しているためです。  
+  
+ クライアントの Web ページの PostAjaxClientPage.aspx には、ユーザーがページ上のいずれかの操作ボタンをクリックするとサービスを呼び出す ASP.NET コードが含まれています。 サービスは、GET 要求で、[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md) のサンプルと同じように応答します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。 続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[Windows Communication Foundation \(WCF\) and Windows Workflow Foundation \(WF\) Samples for .NET Framework 4](http://go.microsoft.com/fwlink/?LinkId=150780)」\(.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル\) にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。 このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Ajax\PostAjaxService`  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」のセットアップ手順を実行します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の説明に従って、ソリューション PostAjaxService.sln をビルドします。  
+  
+3.  http:\/\/localhost\/ServiceModelSamples\/PostAjaxClientPage.aspx に移動します \(プロジェクト ディレクトリからブラウザーで PostAjaxClientPage.aspx を開かないでください\)。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md b/docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md
new file mode 100644
index 00000000000..8342b49478e
--- /dev/null
+++ b/docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md
@@ -0,0 +1,124 @@
+---
+title: "JSON および XML 形式の AJAX サービスのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ea5860d-0c42-4ae9-941a-e07efdd8e29c
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# JSON および XML 形式の AJAX サービスのサンプル
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、JSON \(JavaScript Object Notation\) または XML データのいずれかを返す AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法について説明します。AJAX サービスには、Web ブラウザー クライアントから JavaScript コードを使用してアクセスできます。このサンプルは、「[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)」のサンプルに基づいています。  
+  
+ 他の AJAX サンプルとは異なり、このサンプルでは ASP.NET AJAX および <xref:System.Web.UI.ScriptManager> コントロールを使用しません。追加の構成を行うと、JavaScript を使用して HTML ページから [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] AJAX サービスにアクセスできます。このシナリオを次に示します。ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する例については、「[AJAX Samples](http://msdn.microsoft.com/ja-jp/f3fa45b3-44d5-4926-8cc4-a13c30a3bf3e)」を参照してください。  
+  
+ このサンプルでは、JSON と XML 間で操作の応答のタイプを切り替える方法を示します。この機能は、サービスが ASP.NET AJAX または HTML\/JavaScript クライアント ページでアクセスできるように構成されているかどうかにかかわらず使用できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ ASP.NET AJAX 以外のクライアントを使用するには、.svc ファイルで <xref:System.ServiceModel.Activation.WebServiceHostFactory> \(<xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> ではありません\) を使用します。<xref:System.ServiceModel.Activation.WebServiceHostFactory> によって、<xref:System.ServiceModel.Description.WebHttpEndpoint> 標準エンドポイントがサービスに追加されます。エンドポイントは .svc ファイルに相対する空のアドレス位置に作成されます。つまり、サービスのアドレスは、操作名以外の追加のサフィックスのない http:\/\/localhost\/ServiceModelSamples\/service.svc になります。  
+  
+```html  
+<%@ServiceHost language="c#" Debug="true" Service="Microsoft.Samples.XmlAjaxService.CalculatorService" Factory="System.ServiceModel.Activation.WebServiceHostFactory" %>  
+  
+```  
+  
+ Web.config 内の次のセクションを使用して、エンドポイントに対する構成変更を追加できます。追加の変更が不要な場合は、このセクションを削除できます。  
+  
+```xml  
+<system.serviceModel>  
+  <standardEndpoints>  
+    <webHttpEndpoint>  
+      <!-- Use this element to configure the endpoint -->  
+      <standardEndpoint name="" />  
+    </webHttpEndpoint>  
+  </standardEndpoints>  
+</system.serviceModel>  
+  
+```  
+  
+ <xref:System.ServiceModel.Description.WebHttpEndpoint> の既定のデータ形式は XML であるのに対し、<xref:System.ServiceModel.Description.WebScriptEndpoint> の既定のデータ形式は JSON です。詳細については、「[ASP.NET を使用せずに WCF AJAX サービスを作成する方法](../../../../docs/framework/wcf/feature-details/creating-wcf-ajax-services-without-aspnet.md)」を参照してください。  
+  
+ 次に示すサンプル内のサービスは、2 つの操作が設定された標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。どちらの操作でも <xref:System.ServiceModel.Web.WebGetAttribute> または <xref:System.ServiceModel.Web.WebInvokeAttribute> 属性に <xref:System.ServiceModel.Web.WebMessageBodyStyle> の本文スタイルが必要です。この本文スタイルは、`webHttp` 動作に固有で、JSON\/XML データ形式の切り替えに影響しません。  
+  
+```  
+[OperationContract]  
+[WebInvoke(ResponseFormat = WebMessageFormat.Xml, BodyStyle = WebMessageBodyStyle.Wrapped)]  
+MathResult DoMathXml(double n1, double n2);  
+```  
+  
+ この操作の応答形式は、XML として指定されています。これは、[\<webHttp\>](../../../../docs/framework/configure-apps/file-schema/wcf/webhttp.md) 動作の既定の設定です。ただし、応答形式を明示的に指定することをお勧めします。  
+  
+ その他の操作では `WebInvokeAttribute` 属性を使用し、応答に XML ではなく JSON を明示的に指定します。  
+  
+```  
+[OperationContract]  
+[WebInvoke(ResponseFormat = WebMessageFormat.Json, BodyStyle = WebMessageBodyStyle.Wrapped)]  
+MathResult DoMathJson(double n1, double n2);  
+```  
+  
+ どちらの場合でも、操作により、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] データ コントラクト型である複合型 `MathResult` が返されます。  
+  
+ クライアント Web ページ XmlAjaxClientPage.htm には、ページ上の **\[Perform calculation \(return JSON\)\]** または **\[Perform calculation \(return XML\)\]** ボタンをクリックすると上記の 2 つの操作のどちらかを呼び出す JavaScript コードが含まれています。サービスを呼び出すコードによって JSON 本文が作成され、HTTP POST を使用して送信されます。「[基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)」のサンプルや、ASP.NET AJAX を使用するその他のサンプルとは異なり、要求は JavaScript で手動で作成します。  
+  
+```  
+// Create HTTP request  
+var xmlHttp;  
+// Request instantiation code omitted…  
+// Result handler code omitted…  
+  
+// Build the operation URL  
+var url = "service.svc/ajaxEndpoint/";  
+url = url + operation;  
+  
+// Build the body of the JSON message  
+var body = '{"n1":';  
+body = body + document.getElementById("num1").value + ',"n2":';  
+body = body + document.getElementById("num2").value + '}';  
+  
+// Send the HTTP request  
+xmlHttp.open("POST", url, true);  
+xmlHttp.setRequestHeader("Content-type", "application/json");  
+xmlHttp.send(body);  
+```  
+  
+ サービスが応答すると、応答はこれ以上の処理を行わずにページ上のテキスト ボックスに表示されます。これは、使用される XML および JSON データ形式を直接確認できるように、デモンストレーションの目的で実装されています。  
+  
+```  
+// Create result handler   
+xmlHttp.onreadystatechange=function(){  
+     if(xmlHttp.readyState == 4){  
+          document.getElementById("result").value = xmlHttp.responseText;  
+     }  
+}  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\AJAX\XmlAjaxService`  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従って、ソリューション XmlAjaxService.sln をビルドします。  
+  
+3.  http:\/\/localhost\/ServiceModelSamples\/XmlAjaxClientPage.htm に移動します \(プロジェクト ディレクトリからブラウザで XmlAjaxClientPage.htm を開かないでください\)。  
+  
+## 参照  
+ [HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ajax-service-without-configuration.md b/docs/framework/wcf/samples/ajax-service-without-configuration.md
new file mode 100644
index 00000000000..e5b8a0b61ed
--- /dev/null
+++ b/docs/framework/wcf/samples/ajax-service-without-configuration.md
@@ -0,0 +1,62 @@
+---
+title: "構成を使用しない AJAX サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e6db7acd-5679-45d4-b98a-8449c6873838
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 構成を使用しない AJAX サービス
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、構成設定を使用せずに基本的な ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービス \(Web ブラウザー クライアントから JavaScript コードを使用してアクセスできるサービス\) を作成する方法を示します。  このサービスは .svc ファイルの特殊な構文を使用して AJAX エンドポイントを自動的に有効にします。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での AJAX サポートは、`ScriptManager` コントロールを介して ASP.NET AJAX と共に使用できるように最適化されています。  ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する例については、「[Ajax Samples](http://msdn.microsoft.com/ja-jp/f3fa45b3-44d5-4926-8cc4-a13c30a3bf3e)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、HTTP POST を使用した AJAX サービスに基づいています。  [基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md) サンプルで説明したように、<xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> を使用してサービスをホストします。  
+  
+```  
+<%ServiceHost  
+    language=c#  
+    Debug="true"  
+    Service="Microsoft.Ajax.Samples.CalculatorService  
+    Factory="System.ServiceModel.Activation.WebScriptServiceHostFactory"  
+%>  
+  
+```  
+  
+ <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> は、<xref:System.ServiceModel.Description.WebScriptEndpoint> をサービスに自動的に追加します。  エンドポイントに対する構成変更が不要な場合、\<system.ServiceModel\> セクションはサービスの Web.config ファイルから完全に削除できます。  Web.config ファイルには、ConfigFreeClientPage.aspx で使用される ASP.NET 設定がいくつか含まれます。  そうでない場合は、Web.config ファイル全体を削除できます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Ajax\ConfigFreeAjaxService`  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」のセットアップ手順を実行します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従って、ソリューション ConfigFreeAjaxService.sln をビルドします。  
+  
+3.  http:\/\/localhost\/ServiceModelSamples\/ConfigFreeClientPage.aspx に移動します \(プロジェクト ディレクトリからブラウザーで ConfigFreeClientPage.aspx を開かないでください\)。  
+  
+> [!NOTE]
+>  このサンプルを実行する場合、IIS の ServiceModelSamples フォルダーで匿名認証と Windows 認証が同時に有効になっていないことを確認してください。  有効になっている場合は、Windows 認証を無効にしてください。  サンプルの実行が終了したら、Windows 認証を有効にし、"iisreset" を実行します。  
+  
+## 参照  
+ [基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ajax.md b/docs/framework/wcf/samples/ajax.md
new file mode 100644
index 00000000000..d87223c19e4
--- /dev/null
+++ b/docs/framework/wcf/samples/ajax.md
@@ -0,0 +1,42 @@
+---
+title: "AJAX | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e0eb40a-69ef-4821-bdc3-45a9b71a58c3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# AJAX
+このセクションには、AJAX \(Asynchronous JavaScript and XML\) の機能を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [JSONP](../../../../docs/framework/wcf/samples/jsonp.md)  
+ WCF REST サービスの JSONP \(JSON with Padding\) をサポートする方法を示します。  
+  
+ [JSON シリアル化](../../../../docs/framework/wcf/samples/json-serialization.md)  
+ <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用して JSON \(JavaScript Object Notation\) 形式のデータをシリアル化および逆シリアル化する方法を示します。  
+  
+ [基本的な AJAX サービス](../../../../docs/framework/wcf/samples/basic-ajax-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、基本的な ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。  
+  
+ [HTTP POST を使用する AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-http-post.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、HTTP POST を使用する [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。  
+  
+ [構成を使用しない AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-without-configuration.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、基本的な ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。  
+  
+ [複合型を使用した AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-using-complex-types-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、複合型のインスタンスを作成する ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。  
+  
+ [JSON および XML 形式の AJAX サービス](../../../../docs/framework/wcf/samples/ajax-service-with-json-and-xml-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、JSON \(JavaScript Object Notation\) データまたは XML データを返す AJAX \(Asynchronous JavaScript and XML\) サービスを作成する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/announcements-sample.md b/docs/framework/wcf/samples/announcements-sample.md
new file mode 100644
index 00000000000..7713e31c588
--- /dev/null
+++ b/docs/framework/wcf/samples/announcements-sample.md
@@ -0,0 +1,97 @@
+---
+title: "アナウンスのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 954a75e4-9a97-41d6-94fc-43765d4205a9
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# アナウンスのサンプル
+このサンプルでは、探索機能のアナウンス機能を使用する方法を示します。アナウンス機能を使用すると、サービスに関するメタデータを含むアナウンス メッセージをサービスから送信できます。既定では、サービスが開始されたときに Hello アナウンスが送信され、サービスがシャットダウンされたときに Bye アナウンスが送信されます。これらのアナウンスは、マルチキャストすることも、Point\-to\-Point 送信することもできます。このサンプルは、2 つのプロジェクト \(サービスとクライアント\) で構成されます。  
+  
+## サービス  
+ このプロジェクトには、自己ホスト型の電卓サービスが含まれています。`Main` メソッドでは、サービス ホストが作成され、それにサービス エンドポイントが追加されます。次に、<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> が作成されます。アナウンスを有効にする場合は、アナウンス エンドポイントを <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> に追加する必要があります。この場合、UDP マルチキャストを使用して、標準エンドポイントをアナウンス エンドポイントとして追加します。これにより、既知の UDP アドレスからアナウンスがブロードキャストされます。  
+  
+```  
+Uri baseAddress = new Uri("http://localhost:8000/" + Guid.NewGuid().ToString());  
+  
+// Create a ServiceHost for the CalculatorService type.  
+using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+{  
+     serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new WSHttpBinding(), String.Empty);  
+  
+     ServiceDiscoveryBehavior serviceDiscoveryBehavior = new ServiceDiscoveryBehavior();  
+  
+     // Announce the availability of the service over UDP multicast  
+    serviceDiscoveryBehavior.AnnouncementEndpoints.Add(new UdpAnnouncementEndpoint());  
+  
+    // Make the service discoverable over UDP multicast.  
+    serviceHost.Description.Behaviors.Add(serviceDiscoveryBehavior);                  
+    serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());  
+    serviceHost.Open();  
+    // ...  
+}  
+```  
+  
+## クライアント  
+ このプロジェクトでは、クライアントが <xref:System.ServiceModel.Discovery.AnnouncementService> をホストすることに注意してください。また、2 つのデリゲートがイベントに登録されます。これらのイベントにより、オンラインおよびオフラインのアナウンスを受信したときのクライアントの処理が決定されます。  
+  
+```  
+// Create an AnnouncementService instance  
+AnnouncementService announcementService = new AnnouncementService();  
+  
+// Subscribe the announcement events  
+announcementService.OnlineAnnouncementReceived += OnOnlineEvent;  
+announcementService.OfflineAnnouncementReceived += OnOfflineEvent;  
+```  
+  
+ `OnOnlineEvent` メソッドと `OnOfflineEvent` メソッドはそれぞれ、Hello アナウンス メッセージと Bye アナウンス メッセージを処理します。  
+  
+```  
+static void OnOnlineEvent(object sender, AnnouncementEventArgs e)  
+{  
+    Console.WriteLine();              
+    Console.WriteLine("Received an online announcement from {0}:", e.AnnouncementMessage.EndpointDiscoveryMetadata.Address);  
+PrintEndpointDiscoveryMetadata(e.AnnouncementMessage.EndpointDiscoveryMetadata);  
+}  
+  
+static void OnOfflineEvent(object sender, AnnouncementEventArgs e)  
+{  
+    Console.WriteLine();  
+    Console.WriteLine("Received an offline announcement from {0}:", e.AnnouncementMessage.EndpointDiscoveryMetadata.Address);  
+            PrintEndpointDiscoveryMetadata(e.AnnouncementMessage.EndpointDiscoveryMetadata);  
+}  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  このサンプルでは HTTP エンドポイントを使用します。このサンプルを実行するには、適切な URL ACL を追加する必要があります \(詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照してください\)。管理特権で次のコマンドを実行すると、適切な ACL が追加されます。そのままではコマンドが動作しない場合は、代わりに、ドメインとユーザー名を引数に指定して実行してみてください。`netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%`  
+  
+2.  ソリューションをビルドします。  
+  
+3.  client.exe アプリケーションを実行します。  
+  
+4.  service.exe アプリケーションを実行します。クライアントは、オンライン アナウンスを受信します。  
+  
+5.  service.exe アプリケーションを終了します。クライアントは、オフライン アナウンスを受信します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\Announcements`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/asmx-client-with-a-wcf-service.md b/docs/framework/wcf/samples/asmx-client-with-a-wcf-service.md
new file mode 100644
index 00000000000..474156cf117
--- /dev/null
+++ b/docs/framework/wcf/samples/asmx-client-with-a-wcf-service.md
@@ -0,0 +1,166 @@
+---
+title: "WCF サービス付き ASMX クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3ea381ee-ac7d-4d62-8c6c-12dc3650879f
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# WCF サービス付き ASMX クライアント
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用してサービスを作成し、ASMX クライアントなどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のクライアントからこのサービスにアクセスする方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、クライアント コンソール プログラム \(.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(.dll\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(`Add`、`Subtract`、`Multiply`、`Divide`\) を公開しています。ASMX クライアントは算術演算を同期要求し、サービスは結果を添えて応答します。  
+  
+ サービスは、次に示すコードで定義される `ICalculator` コントラクトを実装します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Xml.Serialization.XmlSerializer> は、CLR 型を XML 表現にマップします。<xref:System.Runtime.Serialization.DataContractSerializer> は一部の XML 表現を、XmlSerializer とは異なる方法で解釈します。XmlSerializer を使用する場合、Wsdl.exe などの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のプロキシ ジェネレータでは、より使いやすいインターフェイスが生成されます。<xref:System.ServiceModel.XmlSerializerFormatAttribute> が `ICalculator` インターフェイスに適用され、CLR 型を XML へマップする際に確実に XmlSerializer を使用します。このサービス実装は、計算を行い、結果を返します。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル \(Web.config\) で定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。サービスは、インターネット インフォメーション サービス \(IIS\) ホストから提供されるベース アドレスで、エンドポイントを公開します。`binding` 属性は basicHttpBinding に設定されます。これにより、WS\-I Basic Profile 1.1 に準拠した SOAP 1.1 を使用する HTTP 通信を実現します。次のサンプル構成を参照してください。  
+  
+```  
+<services>  
+   <service   
+       name="Microsoft.ServiceModel.Samples.CalculatorService"  
+       behaviorConfiguration="CalculatorServiceBehavior">  
+       <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc.  -->  
+      <endpoint address=""  
+               binding="basicHttpBinding"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+   </service>  
+</services>  
+  
+```  
+  
+ ASMX クライアントは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとの通信に、Web サービス記述言語 \(WSDL\) ユーティリティ \(Wsdl.exe\) によって生成された、型指定のあるプロキシを使用します。型指定のあるプロキシは、ファイル generatedClient.cs に含まれています。WSDL ユーティリティは、指定されたサービスが使用するメタデータを取得し、クライアントが通信に使用する型指定のあるプロキシを生成します。既定では、フレームワークはメタデータを公開しません。プロキシの生成に必要なメタデータを公開するには、[\<serviceMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicemetadata.md)を追加し、その `httpGetEnabled` 属性を `True` に設定する必要があります。次の構成を参照してください。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <!-- Setting httpGetEnabled to True on the serviceMetadata  
+           behavior exposes the service's wsdl at <base address>?wsdl :  
+           http://localhost/servicemodelsamples/service.svc?wsdl -->  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ 次のコマンドをクライアント ディレクトリでコマンド プロンプトから実行して、型指定のあるプロキシを生成します。  
+  
+```  
+wsdl /n:Microsoft.ServiceModel.Samples /o:generatedClient.cs /urlkey:CalculatorServiceAddress http://localhost/servicemodelsamples/service.svc?wsdl  
+  
+```  
+  
+ 生成された型指定のあるプロキシを使用することにより、クライアントは適切なアドレスを構成して、指定のサービス エンドポイントにアクセスできます。クライアントは構成ファイル \(App.config\) を使用して、通信するエンドポイントを指定します。  
+  
+```  
+<appSettings>  
+      <add key="CalculatorServiceAddress"   
+      value="http://localhost/ServiceModelSamples/service.svc"/>  
+</appSettings>  
+  
+```  
+  
+ クライアント実装は型指定のあるプロキシのインスタンスを構築し、サービスとの通信を開始します。  
+  
+```  
+// Create a client to the CalculatorService.  
+using (CalculatorService client = new CalculatorService())  
+{  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = client.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Subtract service operation.  
+    value1 = 145.00D;  
+    value2 = 76.54D;  
+    result = client.Subtract(value1, value2);  
+    Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Multiply service operation.  
+    value1 = 9.00D;  
+    value2 = 81.25D;  
+    result = client.Multiply(value1, value2);  
+    Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Divide service operation.  
+    value1 = 22.00D;  
+    value2 = 7.00D;  
+    result = client.Divide(value1, value2);  
+    Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+}  
+  
+Console.WriteLine();  
+Console.WriteLine("Press <ENTER> to terminate client.");  
+Console.ReadLine();  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  複合データ型の受け渡しおよび返却[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows フォーム クライアントのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-a-windows-forms-client.md)」、「[Windows Presentation Foundation クライアントでのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-a-wpf-client.md)」、および「[ASP.NET クライアントでのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Interop\ASMX`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/aspnet-caching-integration.md b/docs/framework/wcf/samples/aspnet-caching-integration.md
new file mode 100644
index 00000000000..a609607feb9
--- /dev/null
+++ b/docs/framework/wcf/samples/aspnet-caching-integration.md
@@ -0,0 +1,72 @@
+---
+title: "ASP.NET キャッシュ統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f581923a-8a72-42fc-bd6a-46de2aaeecc1
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ASP.NET キャッシュ統合
+このサンプルでは、WCF WEB HTTP プログラミング モデルで ASP.NET 出力キャッシュを利用する方法を示します。  このシナリオの自己ホスト バージョンについては、「[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)」のサンプルを参照してください。サービスの実装について詳しく説明されています。  ここでは、ASP.NET 出力キャッシュ統合機能について集中的に説明します。  
+  
+## 使用例  
+ ASP.NET 出力キャッシュとの統合  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\AspNetCachingIntegration`  
+  
+## 説明  
+ このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスで ASP.NET 出力キャッシュを利用するために、<xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> を使用します。  <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> は、サービス操作に適用される属性で、特定の操作からの応答に適用する構成ファイル内のキャッシュ プロファイルの名前を指定します。  
+  
+ このサンプルの Service プロジェクトの Service.cs ファイルでは、`GetCustomer` 操作と `GetCustomers` 操作がどちらも <xref:System.ServiceModel.Web.AspNetCacheProfileAttribute> でマークされ、キャッシュ プロファイル名として "CacheFor60Seconds" が指定されています。  キャッシュ プロファイル "CacheFor60Seconds" は、Service プロジェクトの Web.config ファイルで、\<`system.web`\> の \<`caching`\> 要素の下で定義されています。  このキャッシュ プロファイルの `duration` 属性の値は "60" であるため、このプロファイルに関連付けられた応答は、ASP.NET 出力キャッシュに 60 秒間キャッシュされます。  また、このキャッシュ プロファイルの `varmByParam` 属性が "format" に設定されているため、`format` クエリ文字列パラメーターの値が異なる要求の応答は別々にキャッシュされます。  さらに、キャッシュ プロファイルの `varyByHeader` 属性が "Accept" に設定されているため、Accept ヘッダーの値が異なる要求の応答は別々にキャッシュされます。  
+  
+ Client プロジェクトの Program.cs では、<xref:System.Net.HttpWebRequest> を使用してこのようなクライアントを作成する方法を示します。  これは、WCF サービスにアクセスする 1 つの方法にすぎません。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル ファクトリや <xref:System.Net.WebClient> などの他の .NET Framework クラスを使用して、サービスにアクセスすることも可能です。  SDK 内の他のサンプル \(「[基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)」のサンプルや「[形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)」のサンプルなど\) では、これらのクラスを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信する方法を示します。  
+  
+## サンプルを実行するには  
+ このサンプルは、3 つのプロジェクトで構成されます。  
+  
+-   **Service**: ASP.NET でホストされる WCF HTTP サービスを含む Web アプリケーション プロジェクト。  
+  
+-   **Client**: サービスを呼び出すコンソール アプリケーション プロジェクト。  
+  
+-   **Common**: クライアントとサービスによって使用される Customer 型を含む共有ライブラリ。  
+  
+ クライアント コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### サンプルを実行するには  
+  
+1.  ASP.NET キャッシュ統合サンプルのソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  **ソリューション エクスプローラー** ウィンドウがまだ開いていない場合は、Ctrl キーを押しながら W キーと S キーを押します。  
+  
+4.  **ソリューション エクスプローラー** ウィンドウで、**Service** プロジェクトを右クリックし、**\[新しいインスタンスを開始\]** をクリックします。  これで、サービスをホストする ASP.NET 開発サーバーが起動します。  
+  
+5.  **ソリューション エクスプローラー** ウィンドウで、**Client** プロジェクトを右クリックし、**\[新しいインスタンスを開始\]** をクリックします。  
+  
+6.  クライアント コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  ブラウザーでヘルプ ページの URI を入力することで、いつでも HTML ヘルプ ページを表示することができます。  
+  
+7.  サンプルが実行されると、クライアントは現在のアクティビティのステータスを書き込みます。  
+  
+8.  クライアント コンソール アプリケーションを終了するには、任意のキーを押します。  
+  
+9. サービスのデバッグを停止するには、Shift キーを押しながら F5 キーを押します。  
+  
+10. Windows の通知領域で、ASP.NET 開発サーバーのアイコンを右クリックし、**\[停止\]** を選択します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/aspnet-compatibility.md b/docs/framework/wcf/samples/aspnet-compatibility.md
new file mode 100644
index 00000000000..bcb4356f8bf
--- /dev/null
+++ b/docs/framework/wcf/samples/aspnet-compatibility.md
@@ -0,0 +1,139 @@
+---
+title: "ASP.NET 互換性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c8b51f1e-c096-4c42-ad99-0519887bbbc5
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# ASP.NET 互換性
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換性モードを有効にする方法を示します。  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換性モードで実行されるサービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーション パイプラインに完全に組み込まれるので、ファイルや URL の承認、セッション状態、<xref:System.Web.HttpContext> クラスなどの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] の機能を使用できるようになります。  <xref:System.Web.HttpContext> クラスを使用すると、クッキー、セッション、およびその他の [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 機能にアクセスできます。  このモードでは、バインディングは HTTP トランスポートを使用し、サービス自体は IIS でホストされる必要があります。  
+  
+ このサンプルでは、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!NOTE]
+>  このサンプルを実行するには、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] アプリケーション プールが必要です。  新しいアプリケーション プールの作成または既定のアプリケーション プールの変更を行うには、次の手順に従います。  
+>   
+>  1.  **コントロール パネル**を開きます。  **\[システムとセキュリティ\]** 見出しの下にある **\[管理ツール\]** アプレットを開きます。  **\[インターネット インフォメーション サービス \(IIS\) マネージャー\]** アプレットを開きます。  
+> 2.  **\[接続\]** ペインのツリー ビューを展開します。  **\[アプリケーション プール\]** ノードをクリックします。  
+> 3.  既定のアプリケーション プールで [!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] を使用するように設定する \(既存のサイトとの非互換性の問題が発生する可能性があります\) には、**DefaultAppPool** リスト項目を右クリックして **\[基本設定\]** をクリックします。  **\[.Net Framework バージョン\]** プルダウンを **\[.Net Framework v4.0.30128\]** \(またはそれ以降\) に設定します。  
+> 4.  [!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] を使用する新しいアプリケーション プールを作成する \(他のアプリケーションの互換性を保持する\) には、**\[アプリケーション プール\]** ノードを右クリックして **\[アプリケーション プールの追加\]** をクリックします。  新しいアプリケーション プールに名前を付けて、**\[.Net Framework バージョン\]** プルダウンを **\[.Net Framework v4.0.30128\]** \(またはそれ以降\) に設定します。  以下のセットアップ手順を実行した後で、**ServiceModelSamples** アプリケーションを右クリックし、**\[アプリケーションの管理\]**、**\[詳細設定…\]** の順にクリックします。  **\[アプリケーション プール\]** を新しいアプリケーション プールに設定します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WebHost\ASPNetCompatibility`  
+  
+ このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  `ICalculator` コントラクトは、一連の算術演算を実行して実行結果を保持できるように `ICalculatorSession` コントラクトに変更されました。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculatorSession  
+{  
+    [OperationContract]  
+    void Clear();  
+    [OperationContract]  
+    void AddTo(double n);  
+    [OperationContract]  
+    void SubtractFrom(double n);  
+    [OperationContract]  
+    void MultiplyBy(double n);  
+    [OperationContract]  
+    void DivideBy(double n);  
+    [OperationContract]  
+    double Result();  
+}  
+  
+```  
+  
+ サービスはこの機能を使用して、複数のサービス操作が呼び出されて計算を実行する際に、各クライアントの状態を保持します。  クライアントは `Result` を呼び出して現在の結果を取得したり、`Clear` を呼び出してその結果をクリアし、0 にすることができます。  
+  
+ このサービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッションを使用して、各クライアント セッションの結果を保持します。  これにより、サービスは、サービスへの複数の呼び出しによる各クライアントの実行結果を保持できます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッション状態と [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションとでは、大きく異なります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セッションの詳細については、「[セッション](../../../../docs/framework/wcf/samples/session.md)」を参照してください。  
+  
+ サービスは [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] セッション状態と密接な依存関係にあるので、正常に機能させるには [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換性モードが必要です。  これらの要件は、`AspNetCompatibilityRequirements` 属性を適用することにより宣言によって表されます。  
+  
+```  
+[AspNetCompatibilityRequirements(RequirementsMode =  
+                       AspNetCompatibilityRequirementsMode.Required)]  
+public class CalculatorService : ICalculatorSession  
+{  
+    double Result  
+    {  // store result in AspNet Session  
+       get {  
+          if (HttpContext.Current.Session["Result"] != null)  
+             return (double)HttpContext.Current.Session["Result"];  
+          return 0.0D;  
+       }  
+       set  
+       {  
+          HttpContext.Current.Session["Result"] = value;  
+       }  
+    }  
+    public void Clear()  
+    {  
+        Result = 0.0D;  
+    }  
+    public void AddTo(double n)  
+    {  
+        Result += n;  
+    }  
+    public void SubtractFrom(double n)  
+    {  
+        Result -= n;  
+    }  
+    public void MultiplyBy(double n)  
+    {  
+        Result *= n;  
+    }  
+    public void DivideBy(double n)  
+    {  
+        Result /= n;  
+    }  
+    public double Result()  
+    {  
+        return Result;  
+    }  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+0, + 100, - 50, * 17.65, / 2 = 441.25  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  ソリューションがビルドされたら、Setup.bat を実行し、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] で ServiceModelSamples アプリケーションを設定します。  ServiceModelSamples ディレクトリは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] アプリケーションとして表示されます。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/aspnetrouteintegration.md b/docs/framework/wcf/samples/aspnetrouteintegration.md
new file mode 100644
index 00000000000..e8d8358a185
--- /dev/null
+++ b/docs/framework/wcf/samples/aspnetrouteintegration.md
@@ -0,0 +1,71 @@
+---
+title: "AspNetRouteIntegration | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0638ce0e-d053-47df-a447-688e447a03fb
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# AspNetRouteIntegration
+このサンプルでは、ASP.NET ルートを使用して [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] REST サービスをホストする方法を示します。「[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)」のサンプルでは、このシナリオの自己ホスト バージョンを示し、サービスの実装について詳しく説明しています。ここでは、ASP.NET 統合機能について集中的に説明します。ASP.NET ルーティング[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「<xref:System.Web.Routing>」を参照してください。  
+  
+## サンプルの詳細  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、リソース指向の REST 方式で顧客のコレクションが公開されます。このサービスは、SOAP ベースの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様に、.svc ファイルを使用して ASP.NET でホストできます。ただし、多くの場合、これは HTTP シナリオには適していません。サービスの URL に .svc を含める必要があるためです。また、サービス ライブラリと共に .svc ファイルを配置することも必要です。これらの制限事項を回避するには、このサンプルで示すように、ASP.NET ルートを使用してサービスをホストします。  
+  
+ このサンプルでは、<xref:System.ServiceModel.Activation.ServiceRoute> を Global.asax ファイルに追加して ASP.NET でサービスをホストします。<xref:System.ServiceModel.Activation.ServiceRoute> は、サービスの型 \(この場合は "Service"\)、サービスに使用するサービス ホスト ファクトリの型 \(この場合は <xref:System.ServiceModel.Activation.WebServiceHostFactory>\)、およびサービスの HTTP ベース アドレス \(この場合は "~\/Customers"\) を指定します。  
+  
+ さらに、このサンプルには、<xref:System.Web.Routing.UrlRoutingModule> \(ASP.NET ルートを有効にする\) を追加してサービスの構成を行う Web.config が含まれています。具体的には、<xref:System.ServiceModel.Description.WebHttpEndpoint.HelpEnabled%2A> が `true` に設定されている既定の <xref:System.ServiceModel.Description.WebHttpEndpoint> を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成します。その結果、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャによって、自動的な HTML ベースのヘルプ ページが `http://localhost/Customers/help` に作成されます。このページでは、サービスに対する HTTP 要求の作成方法とサービスの HTTP 応答へのアクセス方法に関する情報 \(顧客の詳細を XML と JSON で表す方法の例など\) が提供されます。  
+  
+ 顧客のコレクション \(一般的には、任意のリソース\) をこの方法で公開すると、クライアントは、URI と HTTP の `GET`、`PUT`、`DELETE`、および `POST` を使用して一貫した方法でサービスと対話することができます。  
+  
+ Client プロジェクトの Program.cs では、<xref:System.Net.HttpWebRequest> を使用してこのようなクライアントを作成する方法を示します。これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにアクセスする 1 つの方法にすぎません。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル ファクトリや <xref:System.Net.WebClient> などの他の .NET Framework クラスを使用して、サービスにアクセスすることも可能です。SDK 内の他のサンプル \(「[基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)」のサンプルや「[形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)」のサンプルなど\) では、これらのクラスを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信する方法を示します。  
+  
+ このサンプルは、3 つのプロジェクトで構成されます。  
+  
+ Service  
+ ASP.NET でホストされる WCF HTTP サービスを含む Web アプリケーション プロジェクト。  
+  
+ Client  
+ サービスを呼び出すコンソール アプリケーション プロジェクト。  
+  
+ Common  
+ クライアントとサービスによって使用される `Customer` 型を含む共有ライブラリ。クライアント コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で、ASP.NET ルート統合サンプルのソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  まだ開いていない場合は、Ctrl キーを押しながら W キーと S キーを押して、**ソリューション エクスプローラー** ウィンドウを開きます。  
+  
+4.  **ソリューション エクスプローラー** ウィンドウで **Service** プロジェクトを右クリックして **\[デバッグ\]** コンテキスト メニュー オプションの上にカーソルを置き、**\[新しいインスタンスを開始\]** コンテキスト メニューを表示します。**\[新しいインスタンスを開始\]** をクリックします。これで、サービスをホストする ASP.NET 開発サーバーが起動します。  
+  
+5.  **ソリューション エクスプローラー** ウィンドウで **Client** プロジェクトを右クリックして **\[デバッグ\]** コンテキスト メニュー オプションの上にカーソルを置き、**\[新しいインスタンスを開始\]** コンテキスト メニューを表示します。**\[新しいインスタンスを開始\]** をクリックします。  
+  
+6.  クライアント コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。ブラウザーでヘルプ ページの URI を入力することで、いつでも HTML ヘルプ ページを表示することができます。サンプルが実行されると、クライアントは現在のアクティビティのステータスを書き込みます。  
+  
+7.  クライアント コンソール アプリケーションを終了するには、任意のキーを押します。  
+  
+8.  サービスのデバッグを停止するには、Shift キーを押しながら F5 キーを押します。Windows の通知領域で、ASP.NET 開発サーバーのアイコンを右クリックし、コンテキスト メニューの **\[停止\]** を選択します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\AspNetRouteIntegration`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/asynchronous-find-sample.md b/docs/framework/wcf/samples/asynchronous-find-sample.md
new file mode 100644
index 00000000000..cc335d8e0ab
--- /dev/null
+++ b/docs/framework/wcf/samples/asynchronous-find-sample.md
@@ -0,0 +1,49 @@
+---
+title: "非同期検索のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a713a25-c1f4-42e1-8c4a-93d64ca45a3b
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 非同期検索のサンプル
+このサンプルでは、クライアント アプリケーションで非同期の検索操作を使用する方法を示します。  
+  
+## サンプルの詳細  
+ 次のデザイン パターンの利点は、検索要求の結果として配置されたエンドポイントがクライアントに対して非同期に通知されることです。このしくみを確認するには、Client.cs ファイルを開いてください。<xref:System.ServiceModel.Discovery.DiscoveryClient> オブジェクトには、そのイベント ハンドラーにアタッチされるデリゲートが 2 つあることに注意してください。1 つは <xref:System.ServiceModel.Discovery.DiscoveryClient.FindCompleted> イベントの発生時に呼び出され、もう 1 つは <xref:System.ServiceModel.Discovery.DiscoveryClient.FindProgressChanged> イベントが発生するたびに呼び出されます。このサンプルでは、アプリケーションでこのパターンを使用する方法について説明します。  
+  
+> [!NOTE]
+>  このサンプルでは HTTP エンドポイントを使用します。サンプルを実行するには、適切な URL ACL を追加する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][HTTP および HTTPS の構成](../../../../docs/framework/wcf/feature-details/configuring-http-and-https.md).管理特権で次のコマンドを実行すると、適切な ACL が追加されます。そのままではコマンドが動作しない場合は、代わりに、ドメインとユーザー名を引数に指定して実行してみてください。`netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%`  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で、AsyncFind.sln を開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、\\WCF\\Basic\\Discovery\\AsyncFind\\CS\\service\\bin\\Debug ディレクトリまたは \\WCF\\Basic\\Discovery\\AsyncFind\\VB\\service\\bin\\Debug ディレクトリに移動して、Service.exe を実行します。  
+  
+4.  サービスが開始したら、\\WCF\\Basic\\Discovery\\AsyncFind\\CS\\client\\bin\\Debug ディレクトリまたは WCF\\Basic\\Discovery\\AsyncFind\\VB\\client\\bin\\Debug ディレクトリに移動して、Client.exe を実行します。  
+  
+5.  クライアントでサービスを検索して呼び出せることを確認します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\AsyncFind`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/authorization-policy.md b/docs/framework/wcf/samples/authorization-policy.md
new file mode 100644
index 00000000000..1367aac07cd
--- /dev/null
+++ b/docs/framework/wcf/samples/authorization-policy.md
@@ -0,0 +1,519 @@
+---
+title: "承認ポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1db325ec-85be-47d0-8b6e-3ba2fdf3dda0
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# 承認ポリシー
+このサンプルでは、カスタム クレーム承認ポリシーと、関連するカスタム サービス承認マネージャーを実装する方法を示します。この方法は、サービスがクレームに基づくアクセス チェックをサービス操作に行う場合や、アクセス チェックを行う前に呼び出し元に特定の権限を与える場合に便利です。このサンプルでは、クレームの追加プロセスと、完了したクレーム セットに対してアクセス チェックを行うプロセスの両方を示します。クライアント\/サーバー間のすべてのアプリケーション メッセージは署名され、暗号化されます。`wsHttpBinding` バインディングを使用する際の既定では、クライアントによって提供されるユーザー名とパスワードが、有効な Windows NT アカウントへのログオンに使用されます。このサンプルでは、カスタム <xref:System.IdentityModel.Selectors.UsernamePasswordValidator> を使用してクライアントを認証する方法を示します。さらにこのサンプルでは、クライアントが X.509 証明書を使用してサービスを認証する方法を示します。また、<xref:System.IdentityModel.Policy.IAuthorizationPolicy> と <xref:System.ServiceModel.ServiceAuthorizationManager> の実装も示します。これらの間では、特定のユーザーに対するサービスの特定のメソッドへのアクセスが許可されます。このサンプルは、「[メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)」に基づいていますが、<xref:System.ServiceModel.ServiceAuthorizationManager> が呼び出される前にクレームの変換を実行する方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルで示す処理の概要は次のとおりです。  
+  
+-   クライアントはユーザー名とパスワードを使用して認証される。  
+  
+-   クライアントは X.509 証明書を使用して認証される。  
+  
+-   サーバーはクライアント資格情報をカスタム `UsernamePassword` 検証と照合する。  
+  
+-   サーバーがそのサーバーの X.509 証明書を使用して認証される。  
+  
+-   サーバーが <xref:System.ServiceModel.ServiceAuthorizationManager> を使用して、サービス内の特定メソッドへのアクセスを制御する。  
+  
+-   <xref:System.IdentityModel.Policy.IAuthorizationPolicy> の実装方法。  
+  
+ サービスは、そのサービスとの通信に使用する 2 つのエンドポイントを公開します。エンドポイントは構成ファイル App.config で定義します。各エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。1 つのバインディングの構成には、WS\-Security とクライアントのユーザー名認証を使用する、標準の `wsHttpBinding` バインディングが使用されます。もう 1 つのバインディングの構成には、WS\-Security とクライアント証明書による認証を使用する、標準の `wsHttpBinding` バインディングが使用されます。[\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)により、サービス認証にユーザーの資格情報を使用することが指定されます。サーバー証明書の `SubjectName` プロパティには、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) の `findValue` 属性と同じ値が指定されている必要があります。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+      <host>  
+        <baseAddresses>  
+          <!-- configure base address provided by host -->  
+          <add baseAddress ="http://localhost:8001/servicemodelsamples/service"/>  
+        </baseAddresses>  
+      </host>  
+      <!-- use base address provided by host, provide two endpoints -->  
+      <endpoint address="username"  
+                binding="wsHttpBinding"  
+                bindingConfiguration="Binding1"   
+                contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      <endpoint address="certificate"  
+                binding="wsHttpBinding"  
+                bindingConfiguration="Binding2"   
+                contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!-- Username binding -->  
+      <binding name="Binding1">  
+        <security mode="Message">  
+    <message clientCredentialType="UserName" />  
+        </security>  
+      </binding>  
+      <!-- X509 certificate binding -->  
+      <binding name="Binding2">  
+        <security mode="Message">  
+          <message clientCredentialType="Certificate" />  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior" >  
+        <serviceDebug includeExceptionDetailInFaults ="true" />  
+        <serviceCredentials>  
+          <!--   
+          The serviceCredentials behavior allows one to specify a custom validator for username/password combinations.    
+          -->  
+          <userNameAuthentication userNamePasswordValidationMode="Custom" customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.MyCustomUserNameValidator, service" />  
+          <!--   
+          The serviceCredentials behavior allows one to specify authentication constraints on client certificates.  
+          -->  
+          <clientCertificate>  
+            <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+            <authentication certificateValidationMode="PeerOrChainTrust" />  
+          </clientCertificate>  
+          <!--   
+          The serviceCredentials behavior allows one to define a service certificate.  
+          A service certificate is used by a client to authenticate the service and provide message protection.  
+          This configuration references the "localhost" certificate installed during the setup instructions.  
+          -->  
+          <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+        </serviceCredentials>  
+        <serviceAuthorization serviceAuthorizationManagerType="Microsoft.ServiceModel.Samples.MyServiceAuthorizationManager, service">  
+          <!--   
+          The serviceAuthorization behavior allows one to specify custom authorization policies.  
+          -->  
+          <authorizationPolicies>  
+            <add policyType="Microsoft.ServiceModel.Samples.CustomAuthorizationPolicy.MyAuthorizationPolicy, PolicyLibrary" />  
+          </authorizationPolicies>  
+        </serviceAuthorization>  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+  
+</system.serviceModel>  
+  
+```  
+  
+ 各クライアント エンドポイント構成は、構成名、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、この場合に [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)で指定されている適切なセキュリティ モードと、[\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md)で指定されている `clientCredentialType` で構成されます。  
+  
+```  
+<system.serviceModel>  
+  
+    <client>  
+      <!-- Username based endpoint -->  
+      <endpoint name="Username"  
+            address="http://localhost:8001/servicemodelsamples/service/username"   
+    binding="wsHttpBinding"   
+    bindingConfiguration="Binding1"   
+                behaviorConfiguration="ClientCertificateBehavior"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator" >  
+      </endpoint>  
+      <!-- X509 certificate based endpoint -->  
+      <endpoint name="Certificate"  
+                        address="http://localhost:8001/servicemodelsamples/service/certificate"   
+                binding="wsHttpBinding"   
+            bindingConfiguration="Binding2"   
+                behaviorConfiguration="ClientCertificateBehavior"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator">  
+      </endpoint>  
+    </client>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- Username binding -->  
+      <binding name="Binding1">  
+        <security mode="Message">  
+          <message clientCredentialType="UserName" />  
+        </security>  
+      </binding>  
+        <!-- X509 certificate binding -->  
+        <binding name="Binding2">  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+    </wsHttpBinding>  
+    </bindings>  
+  
+    <behaviors>  
+      <behavior name="ClientCertificateBehavior">  
+        <clientCredentials>  
+          <serviceCertificate>  
+            <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust  
+            means that if the certificate   
+            is in the user's Trusted People store, then it will be   
+            trusted without performing a  
+            validation of the certificate's issuer chain. This setting   
+            is used here for convenience so that the   
+            sample can be run without having to have certificates   
+            issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust.   
+            The security implications of this   
+            setting should be carefully considered before using   
+            PeerOrChainTrust in production code.   
+            -->  
+            <authentication certificateValidationMode = "PeerOrChainTrust" />  
+          </serviceCertificate>  
+        </clientCredentials>  
+      </behavior>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+ ユーザー名に基づくエンドポイントには、使用するユーザー名とパスワードがクライアント実装で設定されます。  
+  
+```  
+// Create a client with Username endpoint configuration  
+CalculatorClient client1 = new CalculatorClient("Username");  
+  
+client1.ClientCredentials.UserName.UserName = "test1";  
+client1.ClientCredentials.UserName.Password = "1tset";  
+  
+try  
+{  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = client1.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+    ...  
+}  
+catch (Exception e)  
+{  
+    Console.WriteLine("Call failed : {0}", e.Message);  
+}  
+  
+client1.Close();  
+  
+```  
+  
+ 証明書に基づくエンドポイントには、使用するクライアント証明書がクライアント実装で設定されます。  
+  
+```  
+// Create a client with Certificate endpoint configuration  
+CalculatorClient client2 = new CalculatorClient("Certificate");  
+  
+client2.ClientCredentials.ClientCertificate.SetCertificate(StoreLocation.CurrentUser, StoreName.My, X509FindType.FindBySubjectName, "test1");  
+  
+try  
+{  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = client2.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+    ...  
+}  
+catch (Exception e)  
+{  
+    Console.WriteLine("Call failed : {0}", e.Message);  
+}  
+  
+client2.Close();  
+  
+```  
+  
+ このサンプルでは、カスタム <xref:System.IdentityModel.Selectors.UsernamePasswordValidator> を使用してユーザー名とパスワードを検証します。サンプルは、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator> から派生する `MyCustomUserNamePasswordValidator` を実装しています。<xref:System.IdentityModel.Selectors.UsernamePasswordValidator> の詳細については、ドキュメントを参照してください。<xref:System.IdentityModel.Selectors.UsernamePasswordValidator> との統合を示すため、カスタム検証のこのサンプルでは次のコード例に示すように、<xref:System.IdentityModel.Selectors.UsernamePasswordValidator.Validate%2A> メソッドを実装して、ユーザー名がパスワードと一致するユーザー名とパスワードの組み合わせを許可します。  
+  
+```  
+public class MyCustomUserNamePasswordValidator : UserNamePasswordValidator  
+{  
+  // This method validates users. It allows in two users,   
+  // test1 and test2 with passwords 1tset and 2tset respectively.  
+  // This code is for illustration purposes only and   
+  // MUST NOT be used in a production environment because it   
+  // is NOT secure.      
+  public override void Validate(string userName, string password)  
+  {  
+    if (null == userName || null == password)  
+    {  
+      throw new ArgumentNullException();  
+    }  
+  
+    if (!(userName == "test1" && password == "1tset") && !(userName == "test2" && password == "2tset"))  
+    {  
+      throw new SecurityTokenException("Unknown Username or Password");  
+    }  
+  }  
+}  
+  
+```  
+  
+ サービス コードに検証を実装した場合、使用する検証インスタンスをサービス ホストに通知する必要があります。これは次のコードで実行されます。  
+  
+```  
+Servicehost.Credentials.UserNameAuthentication.UserNamePasswordValidationMode = UserNamePasswordValidationMode.Custom;  
+serviceHost.Credentials.UserNameAuthentication.CustomUserNamePasswordValidator = new MyCustomUserNamePasswordValidatorProvider();  
+```  
+  
+ または、構成で同じことを実現できます。  
+  
+```  
+<behavior ...>  
+    <serviceCredentials>  
+      <!--   
+      The serviceCredentials behavior allows one to specify a custom validator for username/password combinations.    
+      -->  
+      <userNameAuthentication userNamePasswordValidationMode="Custom" customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.MyCustomUserNameValidator, service" />  
+    ...  
+    </serviceCredentials>  
+</behavior>  
+```  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、アクセス チェックの実行を目的とした、クレームに基づく豊富なモデルがあります。<xref:System.ServiceModel.ServiceAuthorizationManager> オブジェクトを使用するとアクセス チェックが実行され、クライアントに関連付けられたクレームがサービス メソッドへのアクセスに必要な要件を満たすかどうかが判断されます。  
+  
+ このサンプルでは、デモンストレーションの目的で <xref:System.ServiceModel.ServiceAuthorizationManager> の実装を示します。この実装は <xref:System.ServiceModel.ServiceAuthorizationManager.CheckAccessCore%2A> メソッドを実装し、呼び出しが許可されている操作のアクション URI を値として持つ種類のクレーム \(http:\/\/example.com\/claims\/allowedoperation\) に基づいて、メソッドへのユーザーのアクセスを許可します。  
+  
+```  
+public class MyServiceAuthorizationManager : ServiceAuthorizationManager  
+{  
+  protected override bool CheckAccessCore(OperationContext operationContext)  
+  {                  
+    string action = operationContext.RequestContext.RequestMessage.Headers.Action;  
+    Console.WriteLine("action: {0}", action);  
+    foreach(ClaimSet cs in operationContext.ServiceSecurityContext.AuthorizationContext.ClaimSets)  
+    {  
+      if ( cs.Issuer == ClaimSet.System )  
+      {  
+        foreach (Claim c in cs.FindClaims("http://example.com/claims/allowedoperation", Rights.PossessProperty))  
+        {  
+          Console.WriteLine("resource: {0}", c.Resource.ToString());  
+          if (action == c.Resource.ToString())  
+            return true;  
+        }  
+      }  
+    }  
+    return false;                   
+  }  
+}  
+  
+```  
+  
+ カスタム <xref:System.ServiceModel.ServiceAuthorizationManager> を実装した場合、使用する <xref:System.ServiceModel.ServiceAuthorizationManager> をサービス ホストに通知する必要があります。これを行うコードは次のようになります。  
+  
+```  
+<behavior ...>  
+    ...  
+    <serviceAuthorization serviceAuthorizationManagerType="Microsoft.ServiceModel.Samples.MyServiceAuthorizationManager, service">  
+        ...  
+    </serviceAuthorization>  
+</behavior>  
+  
+```  
+  
+ 実装する主要な <xref:System.IdentityModel.Policy.IAuthorizationPolicy> メソッドは、<xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%28System.IdentityModel.Policy.EvaluationContext%2CSystem.Object%40%29> メソッドです。  
+  
+```  
+public class MyAuthorizationPolicy : IAuthorizationPolicy  
+{  
+    string id;  
+  
+    public MyAuthorizationPolicy()  
+    {  
+    id =  Guid.NewGuid().ToString();  
+    }  
+  
+    public bool Evaluate(EvaluationContext evaluationContext,   
+                                            ref object state)  
+    {  
+        bool bRet = false;  
+        CustomAuthState customstate = null;  
+  
+        if (state == null)  
+        {  
+            customstate = new CustomAuthState();  
+            state = customstate;  
+        }  
+        else  
+            customstate = (CustomAuthState)state;  
+        Console.WriteLine("In Evaluate");  
+        if (!customstate.ClaimsAdded)  
+        {  
+           IList<Claim> claims = new List<Claim>();  
+  
+           foreach (ClaimSet cs in evaluationContext.ClaimSets)  
+              foreach (Claim c in cs.FindClaims(ClaimTypes.Name,   
+                                         Rights.PossessProperty))  
+                  foreach (string s in   
+                        GetAllowedOpList(c.Resource.ToString()))  
+                  {  
+                       claims.Add(new  
+               Claim("http://example.com/claims/allowedoperation",   
+                                    s, Rights.PossessProperty));  
+                            Console.WriteLine("Claim added {0}", s);  
+                      }  
+                   evaluationContext.AddClaimSet(this,   
+                           new DefaultClaimSet(this.Issuer,claims));  
+                   customstate.ClaimsAdded = true;  
+                   bRet = true;  
+                }  
+         else  
+         {  
+              bRet = true;  
+         }  
+         return bRet;  
+     }  
+...  
+}  
+```  
+  
+ 前のコードでは、<xref:System.IdentityModel.Policy.IAuthorizationPolicy.Evaluate%28System.IdentityModel.Policy.EvaluationContext%2CSystem.Object%40%29> メソッドが、処理に影響を与える新しいクレームが追加されていないことをチェックして特定のクレームを追加する方法を示しています。許可されるクレームは `GetAllowedOpList` メソッドから取得されます。このメソッドが実装されると、ユーザーによる実行が許可されている特定の操作リストが返されます。承認ポリシーは、特定の操作にアクセスするためのクレームを追加します。このポリシーは、アクセス チェックの決定を実行する <xref:System.ServiceModel.ServiceAuthorizationManager> によって後で使用されます。  
+  
+ カスタム <xref:System.IdentityModel.Policy.IAuthorizationPolicy> を実装した場合、使用する承認ポリシーをサービス ホストに通知する必要があります。  
+  
+```  
+<serviceAuthorization ...>  
+       <authorizationPolicies>   
+            <add policyType='Microsoft.ServiceModel.Samples.CustomAuthorizationPolicy.MyAuthorizationPolicy, PolicyLibrary' />  
+       </authorizationPolicies>   
+</serviceAuthorization>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントでは Add、Subtract、および Multiple メソッドは正常に呼び出されますが、Divide メソッドを呼び出そうとすると、"アクセスが拒否されました" のメッセージが発生します。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。%SERVER\_NAME% 変数はサーバー名を指定します。この変数を変更して、使用するサーバー名を指定します。既定値は、localhost です。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+-   クライアント証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するクライアント証明書を作成します。%USER\_NAME% 変数はユーザー名を指定します。この値は "test1" に設定されます。`IAuthorizationPolicy` によってこの名前が検索されたためです。%USER\_NAME% の値を変更した場合は、`IAuthorizationPolicy.Evaluate` メソッド内の対応する値を変更する必要があります。  
+  
+     証明書は、CurrentUser ストアの場所の My \(Personal\) ストアに保存されます。  
+  
+    ```  
+    echo ************  
+    echo making client cert  
+    echo ************  
+    makecert.exe -sr CurrentUser -ss MY -a sha1 -n CN=%CLIENT_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   クライアント証明書のサーバーの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、クライアント証明書を信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がサーバー システムにより暗黙には信頼されないからです。マイクロソフト発行の証明書など、信頼されたルート証明書に基づく証明書が既にある場合は、サーバー証明書ストアにクライアント証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r CurrentUser -s My -c -n %CLIENT_NAME% -r LocalMachine -s TrustedPeople  
+    ```  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  サンプルを単一コンピューター構成で実行するか、複数コンピューター構成で実行するかに応じて、次の手順に従います。  
+  
+> [!NOTE]
+>  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト ウィンドウを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  管理特権を使用して Visual Studio コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+3.  Service.exe を service\\bin で起動します。  
+  
+4.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+5.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。  
+  
+2.  \\service\\bin のサービス プログラム ファイルを、サービス コンピューターのディレクトリにコピーします。Setup.bat、Cleanup.bat、GetComputerName.vbs、ImportClientCert.bat の各ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Service.exe.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。さらに、\<service\>\/\<baseAddresses\> 要素で、コンピューター名を localhost からサービス コンピューターの完全修飾名に変更します。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat client` を実行します。`setup.bat` に `client` 引数を指定して実行すると、test1 というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+9. クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。  
+  
+10. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+11. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+12. サーバー上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportClientCert.bat を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+13. サーバー コンピューターで、コマンド プロンプト ウィンドウから Service.exe を起動します。  
+  
+14. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。これにより、証明書ストアからサーバー証明書とクライアント証明書が削除されます。  
+  
+> [!NOTE]
+>  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/authorizing-access-to-service-operations.md b/docs/framework/wcf/samples/authorizing-access-to-service-operations.md
new file mode 100644
index 00000000000..e68f14d6c0c
--- /dev/null
+++ b/docs/framework/wcf/samples/authorizing-access-to-service-operations.md
@@ -0,0 +1,74 @@
+---
+title: "サービス操作へのアクセスの承認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "承認, Windows Communication Foundation サンプル"
+  - "サービス操作へのアクセスの承認のサンプル [Windows Communication Foundation]"
+  - "サービスの動作, アクセスの承認のサンプル"
+ms.assetid: ddcfdaa5-8b2e-4e13-bd85-887209dc6328
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# サービス操作へのアクセスの承認
+このサンプルでは、<xref:System.Security.Permissions.PrincipalPermissionAttribute> 属性を使用できるようにする [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)を使用して、サービス操作へのアクセスを承認する方法を示します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」のサンプルに基づいています。  サービスとクライアントは、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を使用して構成されています。  [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)の `mode` 属性は `Message` に、`clientCredentialType` は `Windows` に設定されています。  <xref:System.Security.Permissions.PrincipalPermissionAttribute> は各サービス メソッドに適用され、各操作へのアクセスを制限するために使用されます。  呼び出し元は、各操作にアクセスできる Windows 管理者である必要があります。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) であり、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス構成ファイルは、次のように [\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)を使用して `principalPermissionMode`  属性を設定します。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior>  
+      ...  
+      <!-- The serviceAuthorization behavior sets the  
+           principalPermissionMode to UseWindowsGroups.  
+           This puts a WindowsPrincipal on the current thread when a   
+           service is invoked. -->  
+      <serviceAuthorization principalPermissionMode="UseWindowsGroups" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ `principalPermissionMode` を `UseWindowsGroups` に設定すると、Windows グループ名に基づいて <xref:System.Security.Permissions.PrincipalPermissionAttribute> を使用できるようになります。  
+  
+ 呼び出し元が Windows 管理者グループのメンバーであることを要求するため、<xref:System.Security.Permissions.PrincipalPermissionAttribute> が各操作に適用されます。次のサンプル コードを参照してください。  
+  
+```  
+[PrincipalPermission(SecurityAction.Demand,   
+                             Role = "Builtin\\Administrators")]  
+public double Add(double n1, double n2)  
+{  
+    double result = n1 + n2;  
+    return result;  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントが管理者グループのメンバーであるアカウントで実行される場合、クライアントは各操作と正常に通信できます。それ以外のアカウントで実行される場合、アクセスは拒否されます。  承認エラーを試すには、管理グループのメンバーではないアカウントでクライアントを実行します。  クライアントをシャットダウンするには、コンソール ウィンドウで Enter キーを押します。  
+  
+ <xref:System.ServiceModel.Dispatcher.IErrorHandler> を実装すると、サービスに承認エラーを通知することができます。  `IErrorHandler` の実装方法については、「[エラー処理およびレポートに対する制御の拡張](../../../../docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md)」を参照してください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/automatic-format-selection.md b/docs/framework/wcf/samples/automatic-format-selection.md
new file mode 100644
index 00000000000..d166d9a206d
--- /dev/null
+++ b/docs/framework/wcf/samples/automatic-format-selection.md
@@ -0,0 +1,50 @@
+---
+title: "形式の自動選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dab51e56-8517-4a6a-bb54-b55b15ab37bb
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 形式の自動選択
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] REST プログラミング モデルで形式の自動選択 \(XML または JSON\) を有効にする方法と、操作コードで形式を明示的に設定する方法を示します。  
+  
+## サンプルの詳細  
+ このサンプルは、サービスと、サービスに要求を発行するクライアント コードで構成されます。  サービスは、単一の HTTP `GET` 操作 \(`EchoWithGet`\) と単一の HTTP `POST` 操作 \(`EchoWithPost`\) をサポートします。  どちらの操作でも文字列を要求し、応答で文字列を返します。  `GET` 操作では、文字列は URI クエリ文字列パラメーターで示されます。  `POST` 操作では、文字列は XML でシリアル化された要求の本文で示されます。  サービスは、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] の新機能である形式の自動選択と形式の強制選択を利用して、XML または JSON 形式のいずれかで応答を返すことができます。  
+  
+ このサンプルでは、App.config ファイルを使用して形式の自動選択を有効にしています。  既定の Web HTTP エンドポイントでは、`automaticFormatSelectionEnabled` 属性に `true` の値が指定されています。  形式の自動選択が有効な場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは、要求の HTTP Accept ヘッダーまたは Content\-Type ヘッダーを指定して最適な応答形式 \(XML または JSON\) を選択します。  開発者は、`automaticFormatSelectionEnabled` 属性を `true` に設定する以外、この新しい機能を使用するためにコードまたは構成を追加する必要はありません。  Program.cs のクライアント コードでは、要求は、“application\/xml” または “application\/json” として指定された HTTP Accept ヘッダーを使用してサービスの `GET` 操作と `POST` 操作の両方に送信され、サービスはそれぞれの形式で応答を返します。  
+  
+ また、`GET` 操作では、形式の強制選択が使用されます。  `GET` 操作では、オプションの `format` クエリ文字列パラメーターがあるかどうかをチェックし、ある場合は、<xref:System.ServiceModel.Web.WebOperationContext.OutgoingResponse%2A> プロパティで応答形式を設定します。  この方法で応答形式を強制的に設定すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャで実行された形式の自動選択がオーバーライドされます。  
+  
+ このサンプルは、コンソール アプリケーション内で実行される自己ホスト型サービスとクライアントで構成されています。  コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### このサンプルを使用するには  
+  
+1.  形式の自動選択サンプルのソリューションを開きます。  サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。  管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの **\[管理者として実行\]** をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーションの AutomaticFormatSelection プロジェクトを実行します。  コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  
+  
+3.  サンプルが実行されると、クライアントは要求をサービスに送信し、応答をコンソール ウィンドウに書き込みます。  応答の形式は XML または JSON になります。  
+  
+4.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\AutomaticFormatSelection`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md b/docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md
new file mode 100644
index 00000000000..3aace8b4ab9
--- /dev/null
+++ b/docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md
@@ -0,0 +1,129 @@
+---
+title: "Using ステートメントに関する問題の回避 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aff82a8d-933d-4bdc-b0c2-c2f7527204fb
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# Using ステートメントに関する問題の回避
+このサンプルでは、型指定のあるクライアントを使用する際に C\# の "using" ステートメントを使用せずに、リソースを自動的にクリーンアップする方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、C\# の "using" ステートメントを型指定のあるクライアントと共に使用する際に発生する 2 つの一般的な問題と、例外が発生した後に正しくクリーンアップするコードを示します。  
+  
+ C\# の "using" ステートメントにより `Dispose`\(\) が呼び出されます。これは `Close`\(\) と同じで、ネットワーク エラーが発生したときに例外をスローする場合があります。`Dispose`\(\) への呼び出しは、"using" ブロックの閉じかっこで暗黙的に発生するので、コードを記述するユーザーとコードを読み取るユーザーの両者が、これを例外の発生元と気付かない可能性があります。これは、アプリケーション エラーの潜在的な原因となります。  
+  
+ 最初の問題は、次の `DemonstrateProblemUsingCanThrow` メソッドに示すように、閉じかっこで例外がスローされるとその後のコードが実行されないことです。  
+  
+```  
+using (CalculatorClient client = new CalculatorClient())  
+{  
+    ...  
+} // <-- this line might throw  
+Console.WriteLine("Hope this code wasn't important, because it might not happen.");  
+```  
+  
+ using ブロック内部からスローされる例外がない場合、または using ブロック内のすべての例外がキャッチされた場合でも、`Console.Writeline` は発生しません。閉じかっこでの `Dispose`\(\) の暗黙の呼び出しによって例外がスローされるためです。  
+  
+ 2 番目の問題は、次の `DemonstrateProblemUsingCanThrowAndMask` メソッドで示すように、閉じかっこで別の例外が暗黙的にスローされる点です。  
+  
+```  
+using (CalculatorClient client = new CalculatorClient())  
+{  
+    ...  
+    throw new ApplicationException("Hope this exception was not important, because "+  
+                                   "it might be masked by the Close exception.");  
+} // <-- this line might throw an exception.  
+```  
+  
+ `Dispose`\(\) は "最後の" ブロック内で発生するので、`Dispose`\(\) が失敗した場合、`ApplicationException` は using ブロックの外側には表示されません。外側のコードで、`ApplicationException` の発生時期を認識できるよう考慮されている場合は、この例外をマスクすると、"using" コンストラクトが問題の原因となる場合があります。  
+  
+ 最後に、このサンプルでは、`DemonstrateCleanupWithExceptions` で例外が発生した場合に正しくクリーンアップする方法を示します。ここでは、try\/catch ブロックを使用してエラーを報告し、`Abort` を呼び出します。クライアントの呼び出しから例外をキャッチする方法の詳細については、「[予期される例外](../../../../docs/framework/wcf/samples/expected-exceptions.md)」のサンプルを参照してください。  
+  
+```  
+try  
+{  
+    ...  
+    client.Close();  
+}  
+catch (CommunicationException e)  
+{  
+    ...  
+    client.Abort();  
+}  
+catch (TimeoutException e)  
+{  
+    ...  
+    client.Abort();  
+}  
+catch (Exception e)  
+{  
+    ...  
+    client.Abort();  
+    throw;  
+}  
+```  
+  
+> [!NOTE]
+>  using ステートメントと ServiceHost: 多くの自己ホスト アプリケーションでは、サービスをホストする以外の処理はほとんど行われず、ServiceHost.Close から例外がスローされることはほとんどありません。したがって、このようなアプリケーションでは、using ステートメントを ServiceHost と共に使用しても安全です。ただし、ServiceHost.Close では `CommunicationException` がスローされる場合があることに注意してください。したがって、ServiceHost を閉じた後でアプリケーションを続行する場合は、using ステートメントを使用せずに前のパターンに従う必要があります。  
+  
+ このサンプルを実行すると、操作応答と例外がクライアントのコンソール ウィンドウに表示されます。  
+  
+ クライアント プロセスでは 3 つのシナリオが実行されます。各シナリオでは `Divide` の呼び出しが試行されます。最初のシナリオでは、`Dispose`\(\) からの例外のためにスキップされるコードを示します。2 番目のシナリオでは、`Dispose`\(\) からの例外のためにマスクされる重要な例外を示します。3 番目のシナリオでは、正しいクリーンアップを示します。  
+  
+ クライアント プロセスから予期される出力は次のとおりです。  
+  
+```  
+=  
+= Demonstrating problem:  closing brace of using statement can throw.  
+=  
+Got System.ServiceModel.CommunicationException from Divide.  
+Got System.ServiceModel.Security.MessageSecurityException  
+=  
+= Demonstrating problem:  closing brace of using statement can mask other Exceptions.  
+=  
+Got System.ServiceModel.CommunicationException from Divide.  
+Got System.ServiceModel.Security.MessageSecurityException  
+=  
+= Demonstrating cleanup with Exceptions.  
+=  
+Calling client.Add(0.0, 0.0);  
+        client.Add(0.0, 0.0); returned 0  
+Calling client.Divide(0.0, 0.0);  
+Got System.ServiceModel.CommunicationException from Divide.  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\UsingUsing`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-ajax-service.md b/docs/framework/wcf/samples/basic-ajax-service.md
new file mode 100644
index 00000000000..250afec3f86
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-ajax-service.md
@@ -0,0 +1,103 @@
+---
+title: "基本的な AJAX サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d66d0c91-0109-45a0-a901-f3e4667c2465
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# 基本的な AJAX サービス
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して基本的な ASP.NET AJAX \(Asynchronous JavaScript and XML\) サービス \(Web ブラウザー クライアントから JavaScript コードを使用してアクセスできるサービス\) を作成する方法を示します。  このサービスは、<xref:System.ServiceModel.Web.WebGetAttribute> 属性を使用してサービスが HTTP GET 要求に応答し、JSON \(JavaScript Object Notation\) データ形式を使用して応答するように構成されていることを確認します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での AJAX サポートは、`ScriptManager` コントロールを介して ASP.NET AJAX と共に使用できるように最適化されています。  ASP.NET AJAX と共に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用する例については、「[AJAX Samples](http://msdn.microsoft.com/ja-jp/f3fa45b3-44d5-4926-8cc4-a13c30a3bf3e)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 次のコードでは、サービスが確実に HTTP GET 要求に応答するように <xref:System.ServiceModel.Web.WebGetAttribute> 属性が `Add` 操作に適用されています。  このコードでは、簡単にするために GET を使用します \(すべての Web ブラウザーから HTTP GET 要求を構築できます\)。  また、GET を使用してキャッシングを有効にすることもできます。  HTTP POST は `WebGetAttribute` 属性を使用しない場合の既定です。  
+  
+```  
+[ServiceContract(Namespace = "SimpleAjaxService")]  
+public interface ICalculator  
+{  
+  
+    [WebGet]  
+    double Add(double n1, double n2);  
+    //Other operations omitted…  
+}  
+  
+```  
+  
+ サンプルの .svc ファイルでは <xref:System.ServiceModel.Activation.WebScriptServiceHostFactory> が使用され、それによって <xref:System.ServiceModel.Description.WebScriptEndpoint> 標準エンドポイントがサービスに追加されます。  エンドポイントは、.svc ファイルに相対する空のアドレス位置に設定されます。  つまり、サービスのアドレスは、操作名以外の追加のサフィックスのない http:\/\/localhost\/ServiceModelSamples\/service.svc になります。  
+  
+```  
+<%@ServiceHost language="C#" Debug="true" Service="Microsoft.Samples.SimpleAjaxService.CalculatorService" Factory="System.ServiceModel.Activation.WebScriptServiceHostFactory" %>  
+```  
+  
+ <xref:System.ServiceModel.Description.WebScriptEndpoint> は、ASP.NET AJAX クライアント ページからサービスにアクセスできるように事前に構成されています。  Web.config 内の次のセクションを使用して、エンドポイントに対する構成変更を追加できます。  追加の変更が不要な場合は、このセクションを削除できます。  
+  
+```xml  
+<system.serviceModel>  
+  <standardEndpoints>  
+    <webScriptEndpoint>  
+      <!-- Use this element to configure the endpoint -->  
+      <standardEndpoint name=""  />  
+    </webScriptEndpoint>  
+  </standardEndpoints>  
+</system.serviceModel>  
+  
+```  
+  
+ <xref:System.ServiceModel.Description.WebScriptEndpoint> は、サービスの既定のデータ形式を XML ではなく JSON に設定します。  サービスを呼び出すには、このトピックで後述するように、セットアップ手順とビルド手順を完了してから、http:\/\/localhost\/ServiceModelSamples\/service.svc\/Add?  n1\=100&n2\=200 に移動します。  このテスト機能は、HTTP GET 要求を使用することによって有効になります。  
+  
+ クライアントの Web ページの SimpleAjaxClientPage.aspx には、ユーザーがページ上のいずれかの操作ボタンをクリックするとサービスを呼び出す ASP.NET コードが含まれています。  `ScriptManager` コントロールは、JavaScript を使用してサービスからプロキシにアクセスできるようにする場合に使用します。  
+  
+```  
+<asp:ScriptManager ID="ScriptManager" runat="server">  
+     <Services>  
+          <asp:ServiceReference Path="service.svc" />  
+     </Services>  
+</asp:ScriptManager>  
+  
+```  
+  
+ 次の JavaScript コードを使用してローカル プロキシをインスタンス化し、操作を呼び出します。  
+  
+```  
+// Code for extracting arguments n1 and n2 omitted…  
+// Instantiate a service proxy  
+var proxy = new SimpleAjaxService.ICalculator();  
+// Code for selecting operation omitted…  
+proxy.Add(parseFloat(n1), parseFloat(n2), onSuccess, onFail, null);  
+  
+```  
+  
+ サービス呼び出しが成功すると、コードは `onSuccess` ハンドラーを呼び出し、操作の結果がテキスト ボックスに表示されます。  
+  
+```  
+function onSuccess(mathResult){  
+     document.getElementById("result").value = mathResult;  
+}  
+  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Ajax\SimpleAjaxService`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-binding.md b/docs/framework/wcf/samples/basic-binding.md
new file mode 100644
index 00000000000..82a75b0bad1
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-binding.md
@@ -0,0 +1,30 @@
+---
+title: "基本的なバインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2a0e8ac4-23e7-45ef-98dc-40691aac530a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 基本的なバインディング
+このセクションには、エンドポイント要素のバインディング属性の使用方法を示す基本的なサンプルが含まれています。  
+  
+## このセクションの内容  
+ [メッセージ セキュリティ サンプル](../../../../docs/framework/wcf/samples/message-security-sample.md)  
+ `basicHttpBinding` およびメッセージ セキュリティを使用するアプリケーションを実装する方法を示します。  
+  
+ [トランスポート セキュリティ付き BasicBinding](../../../../docs/framework/wcf/samples/basicbinding-with-transport-security.md)  
+ 基本的なバインディングを使用した SSL トランスポート セキュリティを示します。  
+  
+ [BasicBinding](../../../../docs/framework/wcf/samples/basicbinding.md)  
+ 第 1 世代と第 2 世代の Web サービスで HTTP 通信と最大限の相互運用性を実現する、`basicHttpBinding` の使用方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-data-contract.md b/docs/framework/wcf/samples/basic-data-contract.md
new file mode 100644
index 00000000000..6241ff74928
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-data-contract.md
@@ -0,0 +1,161 @@
+---
+title: "基本的なデータ コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "データ コントラクト"
+ms.assetid: b124e9e0-cb73-4ae0-b9c3-e6cdf5eced98
+caps.latest.revision: 37
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 37
+---
+# 基本的なデータ コントラクト
+このサンプルでは、データ コントラクトを実装する方法を示します。データ コントラクトを使用すると、サービスと構造化データをやり取りできます。このサンプルは「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいていますが、基本的な数値型ではなく複素数を使用します。  
+  
+ この例では、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされています。クライアントはコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサービスのサービス コントラクトでは複素数を使用します。次のサンプル コードを参照してください。  
+  
+```  
+// Define a service contract.  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性は `ComplexNumber` クラスの定義に適用され、クラスのどのフィールドがクライアントとサービス間のネットワーク経由で渡されるかを示します。次のサンプル コードを参照してください。  
+  
+```  
+[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public class ComplexNumber  
+{  
+    [DataMember]  
+    public double Real = 0.0D;  
+    [DataMember]  
+    public double Imaginary = 0.0D;  
+  
+    public ComplexNumber(double real, double imaginary)  
+    {  
+        this.Real = real;  
+        this.Imaginary = imaginary;  
+    }  
+}  
+  
+```  
+  
+ サービス実装は計算を行い、結果を返します。つまり、`ComplexNumber` 型の数値を受け入れて返します。  
+  
+```  
+// This is the service class that implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        return new ComplexNumber(n1.Real + n2.Real, n1.Imaginary +  
+                                                      n2.Imaginary);  
+    }  
+  
+    public ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        return new ComplexNumber(n1.Real - n2.Real, n1.Imaginary -   
+                                                     n2.Imaginary);  
+    }  
+    public ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        double real1 = n1.Real * n2.Real;  
+        double imaginary1 = n1.Real * n2.Imaginary;  
+        double imaginary2 = n2.Real * n1.Imaginary;  
+        double real2 = n1.Imaginary * n2.Imaginary * -1;  
+        return new ComplexNumber(real1 + real2, imaginary1 +   
+                                                 imaginary2);  
+    }  
+  
+    public ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2)  
+    {  
+         ComplexNumber conjugate =   
+              new ComplexNumber(n2.Real, -1*n2.Imaginary);  
+         ComplexNumber numerator = Multiply(n1, conjugate);  
+         ComplexNumber denominator = Multiply(n2, conjugate);  
+         return new ComplexNumber(numerator.Real / denominator.Real,  
+                                               numerator.Imaginary);  
+    }  
+}  
+  
+```  
+  
+ クライアント実装でも複素数を使用します。サービス コントラクトとデータ コントラクトは、どちらも generatedClient.cs ソース ファイルで定義されます。このソース ファイルは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によってサービス メタデータから生成されます。  
+  
+```  
+// Create a client.  
+DataContractCalculatorClient client = new DataContractCalculatorClient();  
+// Call the Add service operation.  
+ComplexNumber value1 = new ComplexNumber();   
+value1.Real = 1;   
+value1.Imaginary = 2;  
+ComplexNumber value2 = new ComplexNumber();   
+value2.Real = 3;  
+value2.Imaginary = 4;  
+ComplexNumber result = proxy.Add(value1, value2);  
+Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+      value1.Real, value1.Imaginary, value2.Real, value2.Imaginary,   
+      result.Real, result.Imaginary);   
+    …  
+}  
+  
+```  
+  
+ このサンプルを実行する場合は、操作の要求や応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(1 + 2i, 3 + 4i) = 4 + 6i  
+Subtract(1 + 2i, 3 + 4i) = -2 + -2i  
+Multiply(2 + 3i, 4 + 7i) = -13 + 26i  
+Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 41i  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\Basic`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-http-service.md b/docs/framework/wcf/samples/basic-http-service.md
new file mode 100644
index 00000000000..920db5f4a1b
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-http-service.md
@@ -0,0 +1,54 @@
+---
+title: "基本的な HTTP サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27048b43-8a54-4f2a-9952-594bbfab10ad
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 基本的な HTTP サービス
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] REST プログラミング モデルを使用して、一般に "POX" \(Plain Old XML\) サービスと呼ばれる、HTTP ベース、RPC ベースのサービスを実装する方法を示します。このサンプルは、自己ホスト型 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] HTTP サービス \(Service.cs\) と、サービスの作成およびサービスへの呼び出しを行うコンソール アプリケーション \(Program.cs\) の 2 つのコンポーネントで構成されています。  
+  
+## サンプルの詳細  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、入力として渡された文字列を返す、`EchoWithGet` と `EchoWithPost` の 2 つの操作を公開します。  
+  
+ `EchoWithGet` 操作には、この操作で HTTP `GET` 要求が処理されることを示す、<xref:System.ServiceModel.Web.WebGetAttribute> という注釈が付いています。<xref:System.ServiceModel.Web.WebGetAttribute> では明示的に <xref:System.UriTemplate> を指定しないため、操作には `s` という名前のクエリ文字列パラメーターを使用して渡される入力文字列が必要です。サービスが要求する URI の形式は、<xref:System.ServiceModel.Web.WebGetAttribute.UriTemplate%2A> プロパティを使用してカスタマイズすることができます。  
+  
+ `EchoWithPost` 操作には、これが `GET` 操作ではなく、副作用があることを示す、<xref:System.ServiceModel.Web.WebInvokeAttribute> という注釈が付いています。<xref:System.ServiceModel.Web.WebInvokeAttribute> では明示的に `Method` を指定しないため、この操作は、要求本文に文字列が含まれる HTTP `POST` 要求を処理します \(XML 形式など\)。HTTP メソッド、要求の URI の形式は、それぞれ <xref:System.ServiceModel.Web.WebInvokeAttribute.Method%2A> プロパティ、<xref:System.ServiceModel.Web.WebInvokeAttribute.UriTemplate> プロパティを使用して、カスタマイズすることができます。  
+  
+ App.config ファイルでは、`true` に設定されている <xref:System.ServiceModel.Description.WebHttpEndpoint.HelpEnabled%2A> プロパティを持つ既定の <xref:System.ServiceModel.Description.WebHttpEndpoint> を使用して、WCF サービスを構成します。その結果、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャによって、自動的な HTML ベースのヘルプ ページが `http://localhost:8000/Customers/help` に作成されます。このページでは、サービスに対する HTTP 要求の作成方法とサービスの HTTP 応答の使用方法に関する情報が提供されます。  
+  
+ Program.cs では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル ファクトリを使用してサービスへの呼び出しを実行し、応答を処理する方法を示します。これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにアクセスする 1 つの方法にすぎません。<xref:System.Net.HttpWebRequest> や <xref:System.Net.WebClient> などの他の .NET Framework クラスを使用して、サービスにアクセスすることも可能です。SDK 内の他のサンプル \(「[形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)」のサンプルや「[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)」のサンプルなど\) では、これらのクラスを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信する方法を示します。  
+  
+ このサンプルは、コンソール アプリケーション内で実行される自己ホスト型サービスとクライアントで構成されています。コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### このサンプルを使用するには  
+  
+1.  基本的な HTTP サービス サンプルのソリューションを開きます。サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの **\[管理者として実行\]** をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーションを、デバッグを行わずに実行します。コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。ブラウザーでヘルプ ページの URI を入力することで、いつでも HTML ヘルプ ページを表示することができます。サンプルが実行されると、クライアントは現在のアクティビティのステータスを書き込みます。  
+  
+3.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\BasicHttpService`  
+  
+## 参照  
+ [形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)   
+ [基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-resource-service.md b/docs/framework/wcf/samples/basic-resource-service.md
new file mode 100644
index 00000000000..4199a3f6be9
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-resource-service.md
@@ -0,0 +1,50 @@
+---
+title: "基本的なリソース サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4360063e-cc8c-4648-846e-c05a5af51a7a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 基本的なリソース サービス
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] REST プログラミング モデルを使用して HTTP ベースのサービスを実装する方法を示します。このモデルでは、取得、追加、削除、および置換の各操作をサポートする顧客のコレクションが公開されます。このサンプルは、自己ホスト型 [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] HTTP サービス \(Service.cs\) と、サービスの作成およびサービスへの呼び出しを行うコンソール アプリケーション \(program.cs\) の 2 つのコンポーネントで構成されています。  
+  
+## サンプルの詳細  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスでは、リソース指向の REST 方式で顧客のコレクションが公開されます。つまり、顧客のコレクションには一意の URI があり、コレクションにはすべての顧客が含まれます。このサービスは、コレクション全体を取得するための、コレクションの URI への HTTP `GET` の送信と、新しい顧客をコレクションに追加するための、コレクションの URI への HTTP `POST` の送信をサポートしています。また、個々の顧客の URI では、顧客の詳細を取得する HTTP `GET`、顧客の詳細を置換する HTTP `PUT`、コレクションから顧客を削除する HTTP `DELETE` をサポートしています。新しい顧客がコレクションに追加されると、サービスはその顧客に一意の URI を割り当て、顧客の詳細の一部として URI を格納します。また、応答の Location HTTP ヘッダーを使用して、クライアントの URI と通信します。  
+  
+ App.config ファイルでは、`true` に設定されている <xref:System.ServiceModel.Description.WebHttpEndpoint.HelpEnabled%2A> プロパティを持つ既定の <xref:System.ServiceModel.Description.WebHttpEndpoint> を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを構成します。その結果、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって、自動的な HTML ベースのヘルプ ページが `http://localhost:8000/Customers/help` に作成されます。このページでは、サービスに対する HTTP 要求の作成方法とサービスの HTTP 応答へのアクセス方法に関する情報 \(顧客の詳細を XML と JSON で表す方法の例など\) が提供されます。  
+  
+ 顧客のコレクション \(一般的には、任意のリソース\) をこの方法で公開すると、クライアントは、URI と HTTP の `GET`、`PUT`、`DELETE`、および `POST` を使用して一貫した方法でサービスと対話することができます。Program.cs では、<xref:System.Net.HttpWebRequest> を使用してこのようなクライアントを作成する方法を示します。これは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] REST サービスにアクセスする 1 つの方法にすぎません。<xref:System.ServiceModel.ChannelFactory> や <xref:System.Net.WebClient> などの他の .NET Framework クラスを使用して、サービスにアクセスすることも可能です。SDK 内の他のサンプル \(「[基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)」のサンプルや「[形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)」のサンプルなど\) では、これらのクラスを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信する方法を示します。  
+  
+ このサンプルは、コンソール アプリケーション内で実行される自己ホスト型サービスとクライアントで構成されています。コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### このサンプルを使用するには  
+  
+1.  基本的なリソース サービス サンプルのソリューションを開きます。サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの **\[管理者として実行\]** をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーションを実行します。コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。ブラウザーでヘルプ ページの URI を入力することで、いつでも HTML ヘルプ ページを表示することができます。サンプルが実行されると、クライアントは現在のアクティビティのステータスを書き込みます。  
+  
+3.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\BasicResourceService`  
+  
+## 参照  
+ [基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)   
+ [形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic-sample.md b/docs/framework/wcf/samples/basic-sample.md
new file mode 100644
index 00000000000..59beb200a5b
--- /dev/null
+++ b/docs/framework/wcf/samples/basic-sample.md
@@ -0,0 +1,112 @@
+---
+title: "基本的なサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1910bc1-3d0a-4fa6-b12a-4ed6fe759620
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 基本的なサンプル
+このサンプルでは、サービスを探索可能にする方法と、探索可能なサービスの検索方法および呼び出し方法を示します。  このサンプルは、2 つのプロジェクト \(サービスとクライアント\) で構成されます。  
+  
+> [!NOTE]
+>  このサンプルでは、探索をコードで実装しています。  探索を構成で実装するサンプルについては、「[構成](../../../../docs/framework/wcf/samples/configuration-sample.md)」を参照してください。  
+  
+## サービス  
+ これは簡単な電卓サービスの実装です。  探索関連のコードは `Main` にあります。ここでは、次のコードに示すように、 <xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> がサービス ホストに追加され、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> が追加されます。  
+  
+```  
+using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+{  
+    serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new   
+      WSHttpBinding(), String.Empty);  
+  
+    // Make the service discoverable over UDP multicast  
+    serviceHost.Description.Behaviors.Add(new ServiceDiscoveryBehavior());                  
+    serviceHost.AddServiceEndpoint(new UdpDiscoveryEndpoint());  
+  
+    serviceHost.Open();  
+    // ...  
+}  
+```  
+  
+## Client  
+ クライアントは、<xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用してサービスを検索します。  <xref:System.ServiceModel.Discovery.DynamicEndpoint> は標準エンドポイントで、クライアントが開いたときにサービスのエンドポイントを解決します。  この場合、<xref:System.ServiceModel.Discovery.DynamicEndpoint> は、サービス コントラクトに基づいてサービスを検索します。  <xref:System.ServiceModel.Discovery.DynamicEndpoint> は、既定で <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> を検索します。  サービス エンドポイントが見つかると、クライアントは指定されたバインディングを介してそのサービスに接続します。  
+  
+```csharp  
+public static void Main()  
+{  
+   DynamicEndpoint dynamicEndpoint = new DynamicEndpoint( ContractDescription.GetContract(typeof(ICalculatorService)), new WSHttpBinding());  
+   // ...  
+}              
+```  
+  
+ クライアントは、<xref:System.ServiceModel.Discovery.DiscoveryClient> クラスを使用してサービスを検索する `InvokeCalculatorService` という名前のメソッドを定義します。  <xref:System.ServiceModel.Discovery.DynamicEndpoint> は <xref:System.ServiceModel.Description.ServiceEndpoint> を継承しているため、`InvokeCalculatorService` メソッドに渡すことができます。  この例では、次に <xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用して `CalculatorServiceClient` インスタンスを作成し、電卓サービスのさまざまな操作を呼び出します。  
+  
+```csharp  
+static void InvokeCalculatorService(ServiceEndpoint serviceEndpoint)  
+{  
+   // Create a client  
+   CalculatorServiceClient client = new CalculatorServiceClient(serviceEndpoint);  
+  
+   Console.WriteLine("Invoking CalculatorService");  
+   Console.WriteLine();  
+  
+   double value1 = 100.00D;  
+   double value2 = 15.99D;  
+  
+   // Call the Add service operation.  
+   double result = client.Add(value1, value2);  
+   Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+   // Call the Subtract service operation.  
+   result = client.Subtract(value1, value2);  
+   Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+   // Call the Multiply service operation.  
+   result = client.Multiply(value1, value2);  
+   Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+   // Call the Divide service operation.  
+   result = client.Divide(value1, value2);  
+   Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+   Console.WriteLine();  
+  
+   //Closing the client gracefully closes the connection and cleans up resources  
+   client.Close();  
+}  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  このサンプルでは HTTP エンドポイントを使用します。このサンプルを実行するには、適切な URL ACL を追加する必要があります。  [!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」。  管理特権で次のコマンドを実行すると、適切な ACL が追加されます。  そのままではコマンドが動作しない場合は、代わりに、ドメインとユーザー名を引数に指定して実行してみてください。  `netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%`  
+  
+2.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して Basic.sln を開き、サンプルをビルドします。  
+  
+3.  service.exe アプリケーションを実行します。  
+  
+4.  サービスが開始したら、client.exe を実行します。  
+  
+5.  クライアントがサービスのアドレスを知ることなくサービスを検索できたことを確認します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\Basic`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basic.md b/docs/framework/wcf/samples/basic.md
new file mode 100644
index 00000000000..a7e71dd1030
--- /dev/null
+++ b/docs/framework/wcf/samples/basic.md
@@ -0,0 +1,57 @@
+---
+title: "Basic | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04e4d3bd-ab89-4b50-8f42-2a4430751a9c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Basic
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の基本的な機能を示すサンプルのセクションが含まれています。  
+  
+## このセクションの内容  
+ [概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、一般的なサービスと一般的なクライアントを実装する方法を示します。  
+  
+ [AJAX](../../../../docs/framework/wcf/samples/ajax.md)  
+ Asynchronous JavaScript and XML を示します。  
+  
+ [バインド](../../../../docs/framework/wcf/samples/binding.md)  
+ エンドポイント要素のバインディング属性の使用方法を示します。  
+  
+ [クライアント](../../../../docs/framework/wcf/samples/client.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションを示します。  
+  
+ [コントラクト](../../../../docs/framework/wcf/samples/contract.md)  
+ データ コントラクトを示します。  
+  
+ [探索](../../../../docs/framework/wcf/samples/discovery-samples.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 探索を示します。  
+  
+ [管理](../../../../docs/framework/wcf/samples/management.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 管理を示します。  
+  
+ [ルーティング サービス](../../../../docs/framework/wcf/samples/routing-services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ルーティング サービスを示します。  
+  
+ [セキュリティ](../../../../docs/framework/wcf/samples/security-in-wcf.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティを示します。  
+  
+ [サービス](../../../../docs/framework/wcf/samples/services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを示します。  
+  
+ [配信](../../../../docs/framework/wcf/samples/syndication.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 配信を示します。  
+  
+ [Web](../../../../docs/framework/wcf/samples/web.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での Web ホスティングを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basicbinding-with-transport-security.md b/docs/framework/wcf/samples/basicbinding-with-transport-security.md
new file mode 100644
index 00000000000..0200a1b3889
--- /dev/null
+++ b/docs/framework/wcf/samples/basicbinding-with-transport-security.md
@@ -0,0 +1,104 @@
+---
+title: "トランスポート セキュリティ付き BasicBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f49b1de6-0254-4362-8ef2-fccd8ff9688b
+caps.latest.revision: 26
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 26
+---
+# トランスポート セキュリティ付き BasicBinding
+このサンプルでは、基本的なバインディングを使用した SSL トランスポート セキュリティを示します。  このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Basic\TransportSecurity`  
+  
+## サンプルの詳細  
+ 既定で、基本的なバインディングは HTTP 通信をサポートします。  このサンプルでは、基本的なバインディングのトランスポート セキュリティを有効にする方法を示します。  このサンプルを実行する前に、証明書を作成し、Web サーバー証明書ウィザードを使用してあらかじめ割り当てておく必要があります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サンプル内のプログラム コードは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」サービスのプログラム コードと同じです。  次に示すサンプル構成のように、構成ファイル設定でエンドポイントとバインディングを定義すると、通信のセキュリティ保護が有効になるように変更されます。  
+  
+```  
+<system.serviceModel>  
+   <services>  
+      <service   
+          type="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+         <endpoint address=""  
+               binding="basicHttpBinding"  
+               bindingConfiguration="Binding1"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+   </services>  
+    <bindings>  
+        <basicHttpBinding>  
+        <!-- Configure basicHttpBinding with Transport security -- >  
+        <!-- mode and clientCredentialType set to None.-->  
+           <binding name="Binding1">  
+               <security mode="Transport">  
+                   <transport clientCredentialType="None"/>  
+               </security>  
+           </binding>  
+        </basicHttpBinding>  
+    </bindings>  
+    ...  
+</system.serviceModel>  
+```  
+  
+ このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザで https:\/\/localhost\/servicemodelsamples\/service.svc のような HTTPS: アドレスにアクセスしようとするとセキュリティ警告が表示されます。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントがテスト証明書に対して動作するようにするには、クライアントにコードを追加して、セキュリティ警告を非表示にする必要があります。  そのためのコードとそれに必要なクラスは、実際の証明書を使用するときには不要です。  
+  
+```  
+// This code is required only for test certificates such as those   
+// created by Makecert.exe.  
+PermissiveCertificatePolicy.Enact(  
+                           "CN=ServiceModelSamples-HTTPS-Server");  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」が実行済みであることを確認します。  
+  
+4.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/basicbinding.md b/docs/framework/wcf/samples/basicbinding.md
new file mode 100644
index 00000000000..62eddacd2cf
--- /dev/null
+++ b/docs/framework/wcf/samples/basicbinding.md
@@ -0,0 +1,108 @@
+---
+title: "BasicBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 86fbeb87-4d89-4b61-9577-867e0ac12945
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# BasicBinding
+このサンプルでは、第 1 世代と第 2 世代の Web サービスで HTTP 通信と最大限の相互運用性を実現する、`basicHttpBinding` の使用方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Basic\Http`  
+  
+## サンプルの詳細  
+ このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+ 既定の動作で基本的なバインディングを使用する場合、必要なものはバインディング セクション名だけです。基本的なバインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。名前によってバインディング構成を参照するには、\<`endpoint`\> 要素の `bindingConfiguration` 属性を使用する必要があります。次のサンプル コードを参照してください。  
+  
+```  
+<services>  
+    <service   
+        type="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+       <endpoint address=""  
+             binding="basicHttpBinding"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+</services>  
+  
+```  
+  
+ このサンプルでは、バインディング構成の名前は `"Binding1"` です。これは次のコード例のように定義されます。  
+  
+```  
+<bindings>  
+   <basicHttpBinding>  
+      <binding name="Binding1"   
+               hostNameComparisonMode="StrongWildcard"   
+               receiveTimeout="00:10:00"  
+               sendTimeout="00:10:00"  
+               openTimeout="00:10:00"  
+               closeTimeout="00:10:00"  
+               maxMessageSize="65536"   
+               maxBufferSize="65536"   
+               maxBufferPoolSize="524288"   
+               transferMode="Buffered"   
+               messageEncoding="Text"   
+               textEncoding="utf-8"  
+               bypassProxyOnLocal="false"  
+               useDefaultWebProxy="true" >  
+         <security mode="None" />  
+      </binding>  
+   </basicHttpBinding>  
+</bindings>  
+  
+```  
+  
+ バインディング要素には、ホスト名比較モード、最大メッセージ サイズ、プロキシ オプション、タイムアウト、メッセージ エンコーディングなど、さまざまなオプションを設定するための属性が用意されています。  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/behavior-security.md b/docs/framework/wcf/samples/behavior-security.md
new file mode 100644
index 00000000000..dc78a870b32
--- /dev/null
+++ b/docs/framework/wcf/samples/behavior-security.md
@@ -0,0 +1,33 @@
+---
+title: "動作のセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19710ae3-f197-4d28-ba9d-52e465006819
+caps.latest.revision: 5
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 5
+---
+# 動作のセキュリティ
+このセクションには、サービスの動作に対するセキュリティの構成を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [サービス監査動作](../../../../docs/framework/wcf/samples/service-auditing-behavior.md)  
+ このサンプルでは、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> を使用して、サービス操作中にセキュリティ イベントの監査を有効にする方法を示します。  
+  
+ [メンバーシップとロール プロバイダー](../../../../docs/framework/wcf/samples/membership-and-role-provider.md)  
+ このサンプルでは、サービスが [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップとロール プロバイダーを使用してクライアントを認証および承認するための方法を示します。  
+  
+ [サービス操作へのアクセスの承認](../../../../docs/framework/wcf/samples/authorizing-access-to-service-operations.md)  
+ このサンプルでは、[\<serviceAuthorization\>](../../../../docs/framework/configure-apps/file-schema/wcf/serviceauthorization-element.md)を使用して、サービス操作へのアクセスを承認する <xref:System.Security.Permissions.PrincipalPermissionAttribute> 属性を使用できるようにする方法を示します。  
+  
+ [クライアントの偽装](../../../../docs/framework/wcf/samples/impersonating-the-client.md)  
+ サービスで呼び出し元のアプリケーションを偽装し、サービスが呼び出し元の代わりにシステム リソースにアクセスできるようにする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/behaviors.md b/docs/framework/wcf/samples/behaviors.md
new file mode 100644
index 00000000000..457fc61ea76
--- /dev/null
+++ b/docs/framework/wcf/samples/behaviors.md
@@ -0,0 +1,45 @@
+---
+title: "動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0885b65-4e74-4bc9-bbf0-eb7ebe566da1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 動作
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの動作を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [同時実行](../../../../docs/framework/wcf/samples/concurrency.md)  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> を <xref:System.ServiceModel.ConcurrencyMode> 列挙体と共に使用する方法を示します。この列挙体は、サービスのインスタンスがメッセージを順番に処理するか、または同時に処理するかを制御します。  
+  
+ [既定のサービスの動作](../../../../docs/framework/wcf/samples/default-service-behavior.md)  
+ サービスの動作設定を構成する方法を示します。  
+  
+ [インスタンス化](../../../../docs/framework/wcf/samples/instancing.md)  
+ インスタンス化動作の設定を示します。この設定は、クライアント要求への応答として作成される、サービス クラスのインスタンスの作成方法を制御します。  
+  
+ [メタデータ公開動作](../../../../docs/framework/wcf/samples/metadata-publishing-behavior.md)  
+ サービスのメタデータ公開機能を制御する方法を示します。  
+  
+ [サービス トランザクションの動作](../../../../docs/framework/wcf/samples/service-transaction-behavior.md)  
+ クライアント調整トランザクションの使用方法と、サービス トランザクションの動作を制御する <xref:System.ServiceModel.ServiceBehaviorAttribute> と <xref:System.ServiceModel.OperationBehaviorAttribute> の設定方法を示します。  
+  
+ [サービス デバッグ動作](../../../../docs/framework/wcf/samples/service-debug-behavior.md)  
+ サービス デバッグ動作の設定を構成する方法を示します。  
+  
+ [調整](../../../../docs/framework/wcf/samples/throttling.md)  
+ 調整コントロールの使用方法を示します。  
+  
+ [動作のセキュリティ](../../../../docs/framework/wcf/samples/behavior-security.md)  
+ サービスの動作セキュリティを構成する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/binding-extensibility.md b/docs/framework/wcf/samples/binding-extensibility.md
new file mode 100644
index 00000000000..099483990d1
--- /dev/null
+++ b/docs/framework/wcf/samples/binding-extensibility.md
@@ -0,0 +1,27 @@
+---
+title: "バインディング拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cabdd583-ddf5-493e-9dba-c6c31cde8f65
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# バインディング拡張
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのカスタム バインディングを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ <xref:System.ServiceModel.NetHttpBinding>  
+ <xref:System.ServiceModel.Channels.BinaryMessageEncodingBindingElement> 上に <xref:System.ServiceModel.Channels.HttpTransportBindingElement> または <xref:System.ServiceModel.Channels.HttpsTransportBindingElement> をスタックするバインディングを実装する方法を示します。  
+  
+ <xref:System.ServiceModel.WSStreamedHttpBinding>  
+ HTTP トランスポート使用時にストリーミングをサポートする目的でデザインされたバインドを作成する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/binding.md b/docs/framework/wcf/samples/binding.md
new file mode 100644
index 00000000000..b10389e61d4
--- /dev/null
+++ b/docs/framework/wcf/samples/binding.md
@@ -0,0 +1,36 @@
+---
+title: "バインド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 324fa627-d012-465a-b266-95594a09dac2
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# バインド
+このセクションには、エンドポイント要素のバインディング属性の使用方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [バイトストリーム エンコーダー](../../../../docs/framework/wcf/samples/bytestream-encoder.md)  
+ バイト ストリーム エンコーダーの機能を示す <xref:System.ServiceModel.Channels.Binding> である `ByteStreamHttpBinding` を作成する方法を示します。  
+  
+ [基本的なバインディング](../../../../docs/framework/wcf/samples/basic-binding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での基本的なバインディングを示します。  
+  
+ [カスタム バインディング](../../../../docs/framework/wcf/samples/custom-binding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのカスタム バインディングを示します。  
+  
+ [ネット バインディング](../../../../docs/framework/wcf/samples/net-binding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのネットワーク バインディングを示します。  
+  
+ [WS バインディング](../../../../docs/framework/wcf/samples/ws-binding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での Windows サービスのバインディングを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/bridging-and-error-handling.md b/docs/framework/wcf/samples/bridging-and-error-handling.md
new file mode 100644
index 00000000000..909a2be0cfc
--- /dev/null
+++ b/docs/framework/wcf/samples/bridging-and-error-handling.md
@@ -0,0 +1,81 @@
+---
+title: "ブリッジとエラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ae87d1a-b615-4014-a494-a53f63ff0137
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# ブリッジとエラー処理
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーティング サービスを、各種のバインディングを使用するクライアントとサービス間の通信をブリッジするために使用する方法を示します。また、バックアップ サービスを使用してフェールオーバーのシナリオに対処する方法も示します。ルーティング サービスは、コンテンツ ベースのルーターをアプリケーションに簡単に追加できるようにする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントです。このサンプルでは、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 電卓のサンプルを改良し、ルーティング サービスを使用して通信するようにします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\RoutingServices\ErrorHandlingAndBridging`  
+  
+## サンプルの詳細  
+ このサンプルの電卓クライアントは、ルーターによって公開されるエンドポイントにメッセージを送信するように構成されています。ルーティング サービスは、送信されてきたすべてのメッセージを受け入れ、電卓サービスに対応するエンドポイントに転送するように構成されています。プライマリ電卓サービス、バックアップ電卓サービス、および電卓クライアントの構成と、ルーティング サービスによるクライアントとサービス間の通信の処理方法を次に示します。  
+  
+-   電卓クライアントは BasicHttpBinding を使用するように構成され、電卓サービスは NetTcpBinding を使用するように構成されています。ルーティング サービスは、電卓サービスに送信する前に、必要に応じて自動的にメッセージを変換します。また、電卓クライアントがアクセスできるように応答も変換します。  
+  
+-   ルーティング サービスは、プライマリ電卓サービスとバックアップ電卓サービスの 2 つの電卓サービスを認識します。まず、ルーティング サービスは、プライマリ電卓サービスのエンドポイントとの通信を試みます。エンドポイントがダウンしているためにこの試行が失敗すると、次に、バックアップ電卓サービスのエンドポイントとの通信を試みます。  
+  
+ したがって、クライアントから送信されたメッセージはルーターで受信され、実際の電卓サービスに再ルーティングされます。電卓サービスのエンドポイントがダウンしている場合、ルーティング サービスは、バックアップ電卓サービスのエンドポイントにメッセージをルーティングします。バックアップ電卓サービスからのメッセージはサービス ルーターに送り返され、ルーターから電卓クライアントに渡されます。  
+  
+> [!NOTE]
+>  バックアップのリストには、複数のエンドポイントを定義しておくことができます。その場合、バックアップ サービスのエンドポイントがダウンしていると、ルーティング サービスはリスト内の次のバックアップ エンドポイントへの接続を試み、接続が成功するまで試行を続けます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、RouterBridgingAndErrorHandling.sln を開きます。  
+  
+2.  Visual Studio で F5 キーを押すか、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+    1.  F5 キーを押したときに必要なプロジェクトが自動的に起動されるようにする場合は、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。**\[共通プロパティ\]** の **\[スタートアップ プロジェクト\]** ノードで、**\[マルチ スタートアップ プロジェクト\]** をクリックし、すべてのプロジェクトを **\[開始\]** に設定します。  
+  
+    2.  Ctrl キーと Shift キーを押しながら B キーを押してプロジェクトをビルドすると、次のアプリケーションが開始します。  
+  
+        1.  電卓クライアント \(.\/CalculatorClient\/bin\/client.exe\)  
+  
+        2.  電卓サービス \(.\/CalculatorService\/bin\/service.exe\)  
+  
+        3.  ルーティング サービス \(.\/RoutingService\/bin\/RoutingService.exe\)  
+  
+3.  電卓クライアントで、Enter キーを押してクライアントを起動します。  
+  
+     次の出力が表示されます。  
+  
+    ```Output  
+    Add(100,15.99) = 115.99  
+    Subtract(145,76.54) = 68.46  
+    Multiply(9,81.25) = 731.25  
+    Divide(22,7) = 3.14285714285714  
+  
+    ```  
+  
+## コードまたは App.config で構成可能  
+ サンプルは、提供された時点では、App.config ファイルを使用してルーターの動作を定義するように構成されています。App.config ファイルの名前を別の名前に変更して認識されないようにし、`ConfigureRouterViaCode()` に対するメソッド呼び出しのコメントを解除することもできます。どちらの方法でも、ルーターの動作は同じになります。  
+  
+### シナリオ  
+ このサンプルでは、プロトコル ブリッジおよびエラー ハンドラーとして機能するサービス ルーターを示します。このシナリオでは、コンテンツ ベースのルーティングは発生しません。ルーティング サービスは、構成済みの一連の送信先エンドポイントに直接メッセージを渡すように構成された透過的なプロキシ ノードとして機能します。さらに、通信するように構成されたエンドポイントへの送信の試行時にエラーが発生した場合に、そのエラーを透過的に処理する追加の手順も実行します。ルーティング サービスをプロトコル ブリッジとして使用することで、外部の通信と内部の通信に対して別々のプロトコルを定義することができます。  
+  
+### 実際のシナリオ  
+ Contoso では、外部には相互運用可能なサービスのエンドポイントを公開し、内部ではパフォーマンスを最適化したいと考えています。そのため、外部には BasicHttpBinding を使用するエンドポイントを通じてサービスを公開し、内部ではルーティング サービスを使用して、そのサービスの NetTcpBinding を使用するエンドポイントにその接続をブリッジしています。さらに、Contoso では、運用サービスのいずれかが一時的に停止した場合でも、サービスの提供を継続できるようにしたいと考えています。そのため、ルーター サービスの背後で複数のエンドポイントを仮想化し、必要に応じて、エラー処理機能を使用して自動的にバックアップ エンドポイントにフェールオーバーされるようにしています。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/building-the-samples.md b/docs/framework/wcf/samples/building-the-samples.md
new file mode 100644
index 00000000000..6ecce372592
--- /dev/null
+++ b/docs/framework/wcf/samples/building-the-samples.md
@@ -0,0 +1,93 @@
+---
+title: "Windows Communication Foundation サンプルのビルド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2899e7a5-9cb2-4e8d-b8d2-f31391549198
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# Windows Communication Foundation サンプルのビルド
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルは、Visual Studio 2010 を使用したり、コマンド ラインで **msbuild** コマンドを使用したりしてビルドできます。ここでは、両方の手順について説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルをビルドまたは実行する前に、「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」に記述されている手順が完了していることを確認してください。  
+  
+### コマンド プロンプトを使用してサンプルをビルドするには  
+  
+1.  管理特権を使用して [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、サンプルのインストール ディレクトリに存在する言語固有のサブディレクトリに移動します。  
+  
+2.  コマンド プロンプトで `msbuild` と入力します。クライアント プログラムが client\\bin にビルドされ、サービス プログラムが service\\bin にビルドされます。サービスがインターネット インフォメーション サービス \(IIS\) によってホストされている場合は、サービス プログラム ファイルがさらに servicemodelsamples ディレクトリと、その \\bin サブディレクトリにコピーされます。  
+  
+> [!NOTE]
+>  %systemdrive%\\inetpub\\wwwroot 上の ACL を、実行中のアカウントに変更権限を付与するように設定する必要があります。このように設定しない場合、ビルド後のイベントが失敗する場合があります。代わりに、ACL の設定はそのままにして、SDK コマンド プロンプトを管理者として実行することもできます。  
+  
+### Visual Studio を使用してサンプルをビルドするには  
+  
+1.  [!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[lserver](../../../../includes/lserver-md.md)]、Windows 7、または Windows Server 2008 R2 を使用し、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を実行する場合は、より高いレベルのアクセス許可を使用して [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を実行する必要があります。これを行うには、\[スタート\] メニューのアイコンを右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+2.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で、**\[ファイル\]** メニューの **\[開く\]** をクリックし、**\[プロジェクト\/ソリューション\]** をクリックします。サンプルをインストールしたディレクトリの下の言語固有のサブディレクトリに移動し、.sln ファイルのアイコンをダブルクリックして、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でソリューションを開きます。  
+  
+3.  **\[ビルド\]** メニューの **\[ソリューションのリビルド\]** をクリックします。クライアント プログラムが client\\bin にビルドされ、サービス プログラムが service\\bin にビルドされます。サービスが IIS によってホストされている場合は、サービス プログラム ファイルがさらに servicemodelsamples ディレクトリと、その \\bin サブディレクトリにコピーされます。  
+  
+> [!NOTE]
+>  %systemdrive%\\inetpub\\wwwroot 上の ACL を、実行中のアカウントに変更権限を付与するように設定する必要があります。このように設定しない場合、ビルド後のイベントが失敗する場合があります。代わりに、ACL の設定はそのままにして、SDK コマンド プロンプトまたは Visual Studio を管理者として実行することもできます。Visual Studio の一部のアクション \(デバッガを ASP.Net ワーカー プロセスにアタッチするアクションなど\) では、さらに管理特権が必要です。  
+  
+## セットアップ バッチ ファイルとスクリプト  
+ Setup.exe バッチ ファイル、Cleanup.exe バッチ ファイル、およびスクリプトは、Visual Studio コマンド プロンプトから実行する必要があります。いくつかのセットアップ ファイルとクリーンアップ ファイルは、管理特権が必要なタスクを実行します。したがって、これらのファイルは管理特権で起動する必要があります。  
+  
+## メタデータ エンドポイントに関する重要なセキュリティ情報  
+ サービスのメタデータには機密情報が含まれる可能性がありますが、意図的ではない開示を回避するために、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの既定の構成では、メタデータは公開されないように設定されています。この動作は、既定の設定ではセキュリティで保護されますが、同時に、サービスの構成の中でメタデータ公開の動作が明示的に有効化されない限り、サービスの呼び出しに必要なクライアント コードをメタデータ インポート ツール \(Svcutil.exe など\) を使用して生成できないことも意味します。サンプルでの試みを容易にするため、ほとんどすべてのサンプルでは、セキュリティ保護されていないメタデータ公開エンドポイントを公開しています。このようなエンドポイントを利用するコンシューマーは、匿名で、認証を受けていない可能性もあります。したがって、エンドポイントを配置する前には注意を払い、サービスのメタデータをパブリックに開示することが適切であることを確認する必要があります。サービス メタデータの公開[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[メタデータ公開動作](../../../../docs/framework/wcf/samples/metadata-publishing-behavior.md)」のサンプルを参照してください。メタデータ エンドポイントをセキュリティ保護するサンプルについては、「[カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)」のサンプルを参照してください。  
+  
+## 例外処理  
+ 通常、コードではサンプルの主題を重視するので、これらのサンプルに例外処理は含まれていません。例外処理[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[予期される例外](../../../../docs/framework/wcf/samples/expected-exceptions.md)」のサンプルを参照してください。  
+  
+## Svcutil を使用したクライアントと構成の再生成  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用すると、ほとんどのサンプルのクライアント コードと構成を生成できます。一部のサンプルでは、構成を手動で編集する必要があります。たとえば、Svcutil.exe を使用して、クライアント証明書の資格情報を使用するサンプルの構成を再生成する場合は、以前に構成された資格情報を手動で指定する必要があります。一部のサンプルでは、生成コードに影響を与える、Svcutil.exe の特定のオプションを使用します。これらのオプションは、そうした特定のサンプルのトピックで指定されます。  
+  
+#### クライアントと構成ファイルを再生成するには  
+  
+1.  SDK コマンド プロンプトを開き、サンプルのインストール ディレクトリに存在する言語固有のサブディレクトリに移動します。  
+  
+2.  サービスが Web ホスト型の場合は、次のコマンドを使用します。  
+  
+    ```  
+    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs  
+    ```  
+  
+     サービスが自己ホスト型の場合は、次のコマンドを使用します。  
+  
+    ```  
+    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs  
+    ```  
+  
+     http:\/\/localhost:8000\/ServiceModelSamples\/service.svc\/mex を、自己ホスト型サービスの MEX エンドポイントのアドレスに置き換えます。  
+  
+     Visual Basic の型でクライアントを生成するには、次のコマンドを使用します。  
+  
+    ```  
+    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb  
+  
+    ```  
+  
+     サービスが自己ホスト型の場合は、次のコマンドを使用します。  
+  
+    ```  
+    svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb  
+    ```  
+  
+    > [!NOTE]
+    >  クライアント構成の生成をスキップするには、**\/noConfig** オプションを追加します。  
+  
+## 参照  
+ [Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/bytestream-encoder.md b/docs/framework/wcf/samples/bytestream-encoder.md
new file mode 100644
index 00000000000..664a1658319
--- /dev/null
+++ b/docs/framework/wcf/samples/bytestream-encoder.md
@@ -0,0 +1,43 @@
+---
+title: "バイトストリーム エンコーダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e674a8ab-f79a-4a93-b984-54b34392dafc
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# バイトストリーム エンコーダー
+このサンプルでは、バイト ストリーム エンコーダーの機能を示す <xref:System.ServiceModel.Channels.Binding> である `ByteStreamHttpBinding` を作成する方法を示します。  
+  
+## 説明  
+ このサンプルでは、標準のバインディング要素 <xref:System.ServiceModel.Channels.ByteStreamMessageEncodingBindingElement> および <xref:System.ServiceModel.Channels.HttpTransportBindingElement> を使用して、標準の <xref:System.ServiceModel.Channels.Binding> を作成する方法を示します。  このサンプルでは、バイト ストリーム エンコーダーを使用して、画像をアップロードおよびダウンロードする方法を示します。  バイト ストリーム エンコーダーの機能は、HTTP トランスポートのみサポートし、信頼できるメッセージングやセキュリティなどの機能はサポートしません。  唯一サポートされる <xref:System.ServiceModel.Channels.MessageVersion> は <xref:System.ServiceModel.Channels.MessageVersion.None%2A> です。  
+  
+> [!IMPORTANT]
+>  このサンプルを [!INCLUDE[windowsver](../../../../includes/windowsver-md.md)] または [!INCLUDE[win7_client_firstref](../../../../includes/win7-client-firstref-md.md)] で実行している場合は、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] をシステム特権で実行していることを確認してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Binding\ByteStreamEncoder`  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で ByteStreamHttpBinding.sln ファイルを開きます。  
+  
+2.  ソリューション エクスプローラーで ByteStreamHttpBindingServer プロジェクトを右クリックし、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックして、プロジェクトの新しいインスタンスを開始します。  
+  
+3.  ソリューション エクスプローラーで ByteStreamHttpBindingClient プロジェクトを右クリックし、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックして、プロジェクトの新しいインスタンスを開始します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/channel-factory.md b/docs/framework/wcf/samples/channel-factory.md
new file mode 100644
index 00000000000..5a1d57d493c
--- /dev/null
+++ b/docs/framework/wcf/samples/channel-factory.md
@@ -0,0 +1,93 @@
+---
+title: "チャネル ファクトリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09b53aa1-b13c-476c-a461-e82fcacd2a8b
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# チャネル ファクトリ
+このサンプルでは、クライアント アプリケーションが、生成されたクライアントではなく <xref:System.ServiceModel.ChannelFactory> クラスを含むチャネルを作成できる方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、<xref:System.ServiceModel.ChannelFactory%601> クラスを使用して、サービス エンドポイントにチャネルを作成します。通常、サービス エンドポイントへのチャネルを作成するには、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してクライアント型を生成し、生成された型のインスタンスを作成します。また、<xref:System.ServiceModel.ChannelFactory%601> クラスを使用してチャネルを作成することもできます。サンプルを参照してください。次のサンプル コードで作成されるサービスは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」内のサービスと同じものです。  
+  
+```  
+EndpointAddress address = new EndpointAddress("http://localhost/servicemodelsamples/service.svc");  
+WSHttpBinding binding = new WSHttpBinding();  
+ChannelFactory<ICalculator> factory = new   
+                    ChannelFactory<ICalculator>(binding, address);  
+ICalculator channel = factory.CreateChannel();  
+```  
+  
+> [!IMPORTANT]
+>  このサンプルを複数コンピュータのシナリオで実行している場合は、前述のコードの "localhost" を、サービスを実行中のコンピュータの完全修飾名に置き換える必要があります。このサンプルは、エンドポイント アドレスを設定する構成を使用していません。したがって、コード内でアドレスを設定する必要があります。  
+  
+ チャネルが作成されたら、生成されたクライアントと同様にサービス操作を呼び出すことができます。  
+  
+```  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = channel.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+```  
+  
+ チャネルを閉じるには、最初にチャネルを <xref:System.ServiceModel.IClientChannel> インターフェイスにキャストする必要があります。これは、生成されたチャネルが `ICalculator` インターフェイスによってクライアント アプリケーション内で宣言されているからです。このインターフェイスには `Add` および `Subtract` などのメソッドは含まれていますが、`Close` は含まれていません。`Close` メソッドは、<xref:System.ServiceModel.ICommunicationObject> インターフェイスで発生します。  
+  
+```  
+// Close the channel.  
+ ((IClientChannel)client).Close();  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアント アプリケーションをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。このサンプルではメタデータの公開は有効化されないことに注意してください。最初にこのサンプルのメタデータ公開を有効にして、クライアント型を再生成する必要があります。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを複数コンピュータで実行するには  
+  
+1.  次のコードの "localhost" を、サービスを実行中のコンピューターの完全修飾名に置き換えます。  
+  
+    ```  
+    EndpointAddress address = new EndpointAddress("http://localhost/servicemodelsamples/service.svc");  
+    ```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\ChannelFactory`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/channels-extensibility.md b/docs/framework/wcf/samples/channels-extensibility.md
new file mode 100644
index 00000000000..fa681a322f8
--- /dev/null
+++ b/docs/framework/wcf/samples/channels-extensibility.md
@@ -0,0 +1,42 @@
+---
+title: "チャネル拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4cc3b20b-778a-4ae8-b58c-a3822fb13065
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# チャネル拡張
+このセクションには、カスタム チャネルを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ローカル チャネル](../../../../docs/framework/wcf/samples/local-channel.md)  
+ 同じアプリケーション ドメイン内の通信に使用される [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランスポート チャネルであるローカル チャネルを示します。  
+  
+ [Reliable Secure Profile](../../../../docs/framework/wcf/samples/reliable-secure-profile.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と Reliable Secure Profile \(RSP\) を作成する方法を示します。  
+  
+ [カスタム チャネル ディスパッチャー](../../../../docs/framework/wcf/samples/custom-channel-dispatcher.md)  
+ <xref:System.ServiceModel.ServiceHostBase> を直接実装することによって、カスタマイズした方法でチャネル スタックを作成する方法と、Web ホスト環境でカスタム チャネル ディスパッチャーを作成する方法を示します。  
+  
+ [チャネルのチャンキング](../../../../docs/framework/wcf/samples/chunking-channel.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して送信されたサイズの大きいメッセージのバッファーに使用するメモリ容量を制限する方法を示します。  
+  
+ [HTTP 受信確認チャネル](../../../../docs/framework/wcf/samples/http-acknowledgement-channel.md)  
+ 一方向メッセージング パターンを変える階層チャネルを示します。  
+  
+ [HttpCookieSession](../../../../docs/framework/wcf/samples/httpcookiesession.md)  
+ カスタム プロトコル チャネルを作成し、セッション管理用の HTTP クッキーを使用する方法を示します。  
+  
+ [カスタム メッセージ インターセプター](../../../../docs/framework/wcf/samples/custom-message-interceptor.md)  
+ チャネル ファクトリとチャネル リスナーを作成するカスタム バインディング要素を実装して、ランタイム スタックの特定のポイントですべての送受信メッセージを中断する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/chunking-channel.md b/docs/framework/wcf/samples/chunking-channel.md
new file mode 100644
index 00000000000..ac503dafc52
--- /dev/null
+++ b/docs/framework/wcf/samples/chunking-channel.md
@@ -0,0 +1,391 @@
+---
+title: "チャネルのチャンキング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4d53379-b37c-4b19-8726-9cc914d5d39f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# チャネルのチャンキング
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用してサイズの大きいメッセージを送信する場合、一般的にはそうしたメッセージのバッファに使用するメモリ容量を制限することが望まれます。  解決策の 1 つとして、メッセージ本文のストリーミングが考えられます \(データの大部分が本文にある場合\)。  ただし、一部のプロトコルではメッセージ全体のバッファが必要です。  たとえば、信頼できるメッセージとセキュリティの 2 つがこの例として挙げられます。  そこで別の解決策として、サイズの大きいメッセージをチャンクと呼ばれるサイズの小さいメッセージに分割し、そうしたチャンクを 1 つずつ送信し、受信側でサイズの大きいメッセージに再構成するという方法が考えられます。  アプリケーション自体でこうしたチャンキングおよびチャンキング解除を行うことができるほか、カスタム チャネルを使用して行うこともできます。  チャネルのチャンキングのサンプルでは、カスタム プロトコル チャネルまたはカスタム階層チャネルを使用して、サイズの大きい任意のメッセージのチャンキングおよびチャンキング解除を行う方法を示します。  
+  
+ チャンキングは常に、送信されるメッセージ全体が構築された後にのみ使用する必要があります。  チャネルのチャンキングは常に、セキュリティ チャネルおよび信頼できるセッション チャネルの下位の階層に置く必要があります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\ChunkingChannel`  
+  
+## チャネルのチャンキングにおける前提と制限  
+  
+### メッセージ構造  
+ チャネルのチャンキングでは、チャンク対象のメッセージについて、次のメッセージ構造を想定しています。  
+  
+```  
+<soap:Envelope ...>  
+  <!-- headers -->  
+  <soap:Body>  
+    <operationElement>  
+      <paramElement>data to be chunked</paramElement>  
+    </operationElement>  
+  </soap:Body>  
+</soap:Envelope>  
+```  
+  
+ ServiceModel を使用する場合、1 つの入力パラメータを持つコントラクト操作は、入力メッセージについてこのメッセージ形式に準拠します。  同様に、1 つの出力パラメータまたは 1 つの戻り値を持つコントラクト操作は、出力メッセージについてこのメッセージ形式に準拠します。  このような操作の例を次に示します。  
+  
+```  
+[ServiceContract]  
+interface ITestService  
+{  
+    [OperationContract]  
+    Stream EchoStream(Stream stream);  
+  
+    [OperationContract]  
+    Stream DownloadStream();  
+  
+    [OperationContract(IsOneWay = true)]  
+    void UploadStream(Stream stream);  
+}  
+```  
+  
+### セッション  
+ チャネルのチャンキングでは、メッセージ \(チャンク\) の順序付き配信でメッセージが正確に 1 回だけ配信される必要があります。  つまり、基になるチャネル スタックはセッションフルであることが必要です。  セッションは、トランスポート \(TCP トランスポートなど\) またはセッションフル プロトコル チャネル \(信頼できるセッション チャネルなど\) によって提供されます。  
+  
+### 非同期の送受信  
+ 非同期の送受信方法は、このバージョンのチャネルのチャンキング サンプルには実装されていません。  
+  
+## プロトコルのチャンキング  
+ チャネルのチャンキングでは、一連のチャンクの開始と終了、および各チャンクのシーケンス番号を示すプロトコルを定義します。  次の 3 つのメッセージ例では、開始メッセージ、チャンク メッセージ、および終了メッセージを、それぞれの主要な特徴を説明するコメントと共に示します。  
+  
+### 開始メッセージ  
+  
+```  
+<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing"   
+            xmlns:s="http://www.w3.org/2003/05/soap-envelope">  
+  <s:Header>  
+<!—Original message action is replaced with a chunking-specific action. -->  
+    <a:Action s:mustUnderstand="1">http://samples.microsoft.com/chunkingAction</a:Action>  
+<!--  
+Original message is assigned a unique id that is transmitted   
+in a MessageId header. Note that this is different from the WS-Addressing MessageId header.  
+-->  
+    <MessageId s:mustUnderstand="1" xmlns="http://samples.microsoft.com/chunking">  
+53f183ee-04aa-44a0-b8d3-e45224563109  
+</MessageId>  
+<!--  
+ChunkingStart header signals the start of a chunked message.  
+-->  
+    <ChunkingStart s:mustUnderstand="1" i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://samples.microsoft.com/chunking" />  
+<!--  
+Original message action is transmitted in OriginalAction.  
+This is required to re-create the original message on the other side.  
+-->  
+    <OriginalAction xmlns="http://samples.microsoft.com/chunking">  
+http://tempuri.org/ITestService/EchoStream  
+    </OriginalAction>  
+   <!--  
+    All original message headers are included here.  
+   -->  
+  </s:Header>  
+  <s:Body>  
+<!--  
+Chunking assumes this structure of Body content:  
+<element>  
+  <childelement>large data to be chunked<childelement>  
+</element>  
+The start message contains just <element> and <childelement> without  
+the data to be chunked.  
+-->  
+    <EchoStream xmlns="http://tempuri.org/">  
+      <stream />  
+    </EchoStream>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+### チャンク メッセージ  
+  
+```  
+<s:Envelope   
+  xmlns:a="http://www.w3.org/2005/08/addressing"   
+  xmlns:s="http://www.w3.org/2003/05/soap-envelope">  
+  <s:Header>  
+   <!--  
+    All chunking protocol messages have this action.  
+   -->  
+    <a:Action s:mustUnderstand="1">  
+      http://samples.microsoft.com/chunkingAction  
+    </a:Action>  
+<!--  
+Same as MessageId in the start message. The GUID indicates which original message this chunk belongs to.  
+-->  
+    <MessageId s:mustUnderstand="1"   
+               xmlns="http://samples.microsoft.com/chunking">  
+      53f183ee-04aa-44a0-b8d3-e45224563109  
+    </MessageId>  
+<!--  
+The sequence number of the chunk.  
+This number restarts at 1 with each new sequence of chunks.  
+-->  
+    <ChunkNumber s:mustUnderstand="1"   
+                 xmlns="http://samples.microsoft.com/chunking">  
+      1096  
+    </ChunkNumber>  
+  </s:Header>  
+  <s:Body>  
+<!--  
+The chunked data is wrapped in a chunk element.  
+The encoding of this data (and the entire message)   
+depends on the encoder used. The chunking channel does not mandate an encoding.  
+-->  
+    <chunk xmlns="http://samples.microsoft.com/chunking">  
+kfSr2QcBlkHTvQ==  
+    </chunk>  
+  </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+### 終了メッセージ  
+  
+```  
+<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing"   
+            xmlns:s="http://www.w3.org/2003/05/soap-envelope">  
+  <s:Header>  
+    <a:Action s:mustUnderstand="1">  
+      http://samples.microsoft.com/chunkingAction  
+    </a:Action>  
+<!--  
+Same as MessageId in the start message. The GUID indicates which original message this chunk belongs to.  
+-->  
+    <MessageId s:mustUnderstand="1"   
+               xmlns="http://samples.microsoft.com/chunking">  
+      53f183ee-04aa-44a0-b8d3-e45224563109  
+    </MessageId>  
+<!--  
+ChunkingEnd header signals the end of a chunk sequence.  
+-->  
+    <ChunkingEnd s:mustUnderstand="1" i:nil="true"   
+                 xmlns:i="http://www.w3.org/2001/XMLSchema-instance"   
+                 xmlns="http://samples.microsoft.com/chunking" />  
+<!--  
+ChunkingEnd messages have a sequence number.  
+-->  
+    <ChunkNumber s:mustUnderstand="1"   
+                 xmlns="http://samples.microsoft.com/chunking">  
+      79  
+    </ChunkNumber>  
+  </s:Header>  
+  <s:Body>  
+<!--  
+The ChunkingEnd message has the same <element><childelement> structure  
+as the ChunkingStart message.  
+-->  
+    <EchoStream xmlns="http://tempuri.org/">  
+      <stream />  
+    </EchoStream>  
+  </s:Body>  
+</s:Envelope>  
+```  
+  
+## チャネルのチャンキングのアーキテクチャ  
+ チャンキングを行うチャネルは `IDuplexSessionChannel` で、高レベルで通常のチャネル アーキテクチャに従います。  `ChunkingChannelFactory` と `ChunkingChannelListener` を作成できる `ChunkingBindingElement` があります。  `ChunkingChannelFactory` は、作成を要求されたときに `ChunkingChannel` のインスタンスを作成します。  `ChunkingChannelListener` は、新しい内部チャネルが受け入れられると `ChunkingChannel` のインスタンスを作成します。  メッセージの送受信は `ChunkingChannel` 自体が行います。  
+  
+ 1 つ下のレベルでは、`ChunkingChannel` がいくつかのコンポーネントに依存して、チャンキングを行うプロトコルを実装します。  送信側では、このチャネルは、実際にチャンキングを行う `ChunkingWriter` というカスタム `XmlDictionaryWriter` を使用します。  `ChunkingWriter` は内部チャネルを使用して直接チャンクを送信します。  カスタム `XmlDictionaryWriter` を使用すると、本文のサイズが大きい元のメッセージの書き込みと同時にチャンクを送信できます。  つまり、元のメッセージ全体はバッファされません。  
+  
+ ![チャネルのチャンキング](../../../../docs/framework/wcf/samples/media/chunkingchannel1.gif "ChunkingChannel1")  
+  
+ 受信側では、`ChunkingChannel` は内部チャネルからメッセージをプルし、`ChunkingReader` というカスタム `XmlDictionaryReader` に渡します。これにより、受信チャンクから元のメッセージが再構成されます。  `ChunkingChannel` は、この `ChunkingReader` を `ChunkingMessage` というカスタム `Message` 実装でラップし、このメッセージを上の層に戻します。  `ChunkingReader` と `ChunkingMessage` を組み合わせて使用すると、元のメッセージ本文全体をバッファーする代わりに、元のメッセージ本文が上の層によって読み取られるのと同時にメッセージのチャンキング解除を行うことができます。  `ChunkingReader` には、バッファー対象のチャンクの構成可能な最大数を上限として受信チャンクをバッファーするキューがあります。  この上限に達すると、リーダーは、上の層によってメッセージがキューから出される \(つまり元のメッセージ本文の読み取りだけが行われる\) まで待機するか、または受信タイムアウトの上限に達するまで待機します。  
+  
+ ![チャネルのチャンキング](../../../../docs/framework/wcf/samples/media/chunkingchannel2.gif "ChunkingChannel2")  
+  
+## プログラミング モデルのチャンキング  
+ サービス開発者は `ChunkingBehavior` 属性をコントラクト内の操作に適用することにより、チャンク対象のメッセージを指定できます。  この属性は `AppliesTo` プロパティを公開します。このプロパティを使用すると、開発者は、入力メッセージと出力メッセージのどちらか、またはその両方にチャンキングを適用するように指定できます。  `ChunkingBehavior` 属性の使用方法を次の例に示します。  
+  
+```  
+[ServiceContract]  
+interface ITestService  
+{  
+    [OperationContract]  
+    [ChunkingBehavior(ChunkingAppliesTo.Both)]  
+    Stream EchoStream(Stream stream);  
+  
+    [OperationContract]  
+    [ChunkingBehavior(ChunkingAppliesTo.OutMessage)]  
+    Stream DownloadStream();  
+  
+    [OperationContract(IsOneWay=true)]  
+    [ChunkingBehavior(ChunkingAppliesTo.InMessage)]  
+    void UploadStream(Stream stream);  
+  
+}  
+  
+```  
+  
+ このプログラミング モデルから、`ChunkingBindingElement` は、チャンク対象のメッセージを識別するアクション URI のリストをコンパイルします。  各送信メッセージのアクションはこのリストと比較され、そのメッセージはチャンク対象なのか、または直接送信する必要があるのかが判断されます。  
+  
+## Send 操作の実装  
+ 高レベルの Send 操作では、送信メッセージをチャンクする必要があるかどうかを最初にチェックし、その必要がない場合は内部チャネルを使用して直接メッセージを送信します。  
+  
+ メッセージのチャンキングが必要な場合、Send は新しい `ChunkingWriter` を作成して、この `ChunkingWriter` を渡す送信メッセージで `WriteBodyContents` を呼び出します。  次に、`ChunkingWriter` はメッセージのチャンキング \(およびチャンク開始メッセージへの元のメッセージ ヘッダーのコピー\) を行い、内部チャネルを使用してチャンクを送信します。  
+  
+ いくつかの細かい点に注意してください。  
+  
+-   Send は最初に `ThrowIfDisposedOrNotOpened` を呼び出し、`CommunicationState` が開かれた状態にします。  
+  
+-   Send は、セッションごとに一度に 1 つのメッセージだけを送信できるように同期されます。  `sendingDone` という `ManualResetEvent` があり、これはチャンキングが行われたメッセージが送信されたときにリセットされます。  チャンク終了メッセージが送信されると、このイベントが設定されます。  Send メソッドは、このイベントが設定されるのを待機した後でメッセージの送信を試行します。  
+  
+-   Send は `CommunicationObject.ThisLock` をロックし、送信中に同期状態が変更されないようにします。  <xref:System.ServiceModel.Channels.CommunicationObject> の状態とステート マシンの詳細については、<xref:System.ServiceModel.Channels.CommunicationObject> のドキュメントを参照してください。  
+  
+-   Send に渡されるタイムアウトは、すべてのチャンクの送信を含む送信操作全体のタイムアウトとして使用されます。  
+  
+-   元のメッセージ本文全体がバッファされないように、カスタムの `XmlDictionaryWriter` デザインが選択されています。  `message.GetReaderAtBodyContents` を使用して本文の `XmlDictionaryReader` を取得する場合、本文全体がバッファされます。  この場合は、代わりに、`message.WriteBodyContents` に渡されるカスタムの `XmlDictionaryWriter` があります。  メッセージがライタの WriteBase64 を呼び出すと、ライタはチャンクをパッケージ化してメッセージを作成し、内部チャンネルを使用して送信します。  WriteBase64 は、チャンクが送信されるまでブロックされます。  
+  
+## Receive 操作の実装  
+ 高レベルの Receive 操作では、最初に受信メッセージが `null` でないことをチェックすると共に、アクションが `ChunkingAction` であることをチェックします。  どちらかの条件が満たされていない場合、メッセージは Receive によって変更されないまま返されます。  それ以外の場合、Receive は新しい `ChunkingReader` と、それを \(`GetNewChunkingMessage` を呼び出して\) ラップする新しい `ChunkingMessage` を作成します。  Receive は、新しい `ChunkingMessage` を返す前に、スレッド プールのスレッドを使用して `ReceiveChunkLoop` を実行します。これによってループ内に `innerChannel.Receive` が呼び出され、チャンク終了メッセージを受信するか、または受信タイムアウトに達するまで、チャンクが `ChunkingReader` に渡されます。  
+  
+ いくつかの細かい点に注意してください。  
+  
+-   Send と同様、Receive は最初に `ThrowIfDisposedOrNotOepned` を呼び出して、`CommunicationState` が開かれた状態にします。  
+  
+-   また Receive も、セッションから一度に 1 つのメッセージだけを受信できるように同期されます。  これは特に重要です。チャンク開始メッセージが受信されると、それ以降受信されるすべてのメッセージは、チャンク終了メッセージが受信されるまで、この新しいチャンク シーケンス内のチャンクであると想定されるためです。  Receive は、現在チャンキングを解除中のメッセージに属するすべてのチャンクが受信されるまでは、内部チャネルからメッセージをプルできません。  これを実現するため、Receive は `currentMessageCompleted` という `ManualResetEvent` を使用します。これはチャンク終了メッセージが受信されたときに設定され、新しいチャンク開始メッセージが受信されたときにリセットされます。  
+  
+-   Receive は Send と異なり、受信中に同期状態の遷移を妨げません。  たとえば、受信中に Close を呼び出して、保留中の元のメッセージの受信が完了するか、または指定されたタイムアウト値に達するまで待機できます。  
+  
+-   Receive に渡されるタイムアウトは、すべてのチャンクの受信を含む受信操作全体のタイムアウトとして使用されます。  
+  
+-   メッセージを処理するレイヤでメッセージ本文を処理する速度が、チャンク メッセージを受信する速度より遅い場合、`ChunkingReader` は、`ChunkingBindingElement.MaxBufferedChunks` で指定された上限に達するまでこうした受信チャンクをバッファします。  この上限に達すると、バッファされたチャンクが処理されるか、または受信タイムアウトに達するまで、チャンクは下位層からプルされなくなります。  
+  
+## CommunicationObject のオーバーライド  
+  
+### OnOpen  
+ `OnOpen` は `innerChannel.Open` を呼び出して内部チャネルを開きます。  
+  
+### OnClose  
+ `OnClose` は、保留状態の `ReceiveChunkLoop` が停止したことを通知するため、最初に `stopReceive` を `true` に設定します。  次に `receiveStopped` `ManualResetEvent` を待機します。これは、`ReceiveChunkLoop` が停止したときに設定されます。  `ReceiveChunkLoop` が指定されたタイムアウト内で停止した場合、`OnClose` はタイムアウトの残り時間で `innerChannel.Close` を呼び出します。  
+  
+### OnAbort  
+ `OnAbort` は、`innerChannel.Abort` を呼び出して内部チャネルを中止します。  保留中の `ReceiveChunkLoop` がある場合は、保留中の `innerChannel.Receive` 呼び出しから例外を受け取ります。  
+  
+### OnFaulted  
+ チャネルでエラーが発生した場合、`ChunkingChannel` では特別な動作は必要ありません。したがって、`OnFaulted` はオーバーライドされません。  
+  
+## チャネル ファクトリの実装  
+ `ChunkingChannelFactory` は `ChunkingDuplexSessionChannel` のインスタンスを作成し、遷移した状態を内部チャネル ファクトリに転送します。  
+  
+ `OnCreateChannel` は内部チャネル ファクトリを使用して、`IDuplexSessionChannel` 内部チャネルを作成します。  次に、新しい `ChunkingDuplexSessionChannel` を作成し、それに内部チャネル、チャンク対象のメッセージ アクションのリスト、および受信時にバッファするチャンクの最大数を渡します。  チャンク対象のメッセージ アクションのリストと、バッファするチャンクの最大数の 2 つは、パラメータとしてコンストラクタの `ChunkingChannelFactory` に渡されます。  `ChunkingBindingElement` に関するセクションでは、これらの値の発生元について説明します。  
+  
+ `OnOpen`、`OnClose`、`OnAbort`、およびそれぞれと同等の非同期のメソッドは、対応する状態遷移メソッドを内部チャネル ファクトリで呼び出します。  
+  
+## チャネル リスナの実装  
+ `ChunkingChannelListener` は、内部チャネル リスナのラッパーです。  この主な機能は、内部チャネル リスナへの呼び出しを代行するほか、内部チャネル リスナから受け入れられたチャネルを新しい `ChunkingDuplexSessionChannels` でラップすることです。  これは、`OnAcceptChannel` と `OnEndAcceptChannel` で行われます。  新しく作成された `ChunkingDuplexSessionChannel` は、以前説明した他のパラメータと共に内部チャネルに渡されます。  
+  
+## バインディング要素とバインディングの実装  
+ `ChunkingBindingElement` は、`ChunkingChannelFactory` および `ChunkingChannelListener` を作成します。  `ChunkingBindingElement` は `CanBuildChannelFactory`\<T\> と `CanBuildChannelListener`\<T\> の T が `IDuplexSessionChannel` \(チャネルのチャンキングでサポートされる唯一のチャネル\) の型であるかどうかをチェックし、バインディング内の他のバインディング要素がこのチャネル型をサポートすることを確認します。  
+  
+ `BuildChannelFactory`\<T\> は、要求されたチャネル型を構築できることをまず確認し、次にチャンク対象のメッセージ アクションのリストを取得します。  詳細については、次のセクションを参照してください。  次に、新しい `ChunkingChannelFactory` を作成し、それに内部チャネル ファクトリ \(`context.BuildInnerChannelFactory<IDuplexSessionChannel>` から返されたままの状態での\)、メッセージ アクションのリスト、およびバッファするチャンクの最大数を渡します。  チャンクの最大数は、`ChunkingBindingElement` によって公開される `MaxBufferedChunks` というプロパティによって指定されます。  
+  
+ `BuildChannelListener<T>` には、`ChunkingChannelListener` を作成してこれに内部チャネル リスナーを渡す同様の実装があります。  
+  
+ このサンプルには、`TcpChunkingBinding` というバインディング例が含まれています。  このバインディングは、`TcpTransportBindingElement` と `ChunkingBindingElement` の 2 つのバインディング要素で構成されています。  このバインディングは、`MaxBufferedChunks` プロパティを公開する他にも、`TcpTransportBindingElement` プロパティの一部を設定します。たとえば、ヘッダーについて、`MaxReceivedMessageSize` を `ChunkingUtils.ChunkSize` \+ 100 KB に設定します。  
+  
+ また、`TcpChunkingBinding` は、`IBindingRuntimePreferences` を実装し、`ReceiveSynchronously` メソッドに対して true を返すことで、同期 Receive 呼び出しのみが実装されていることを示します。  
+  
+### チャンク対象のメッセージの判断  
+ チャネルのチャンキングによってチャンクされるメッセージは、`ChunkingBehavior` 属性を介して識別されるメッセージのみです。  `ChunkingBehavior` クラスは `IOperationBehavior` を実装し、`AddBindingParameter` メソッドの呼び出しによって実装されます。  このメソッドでは、`ChunkingBehavior` が `AppliesTo` プロパティの値 \(`InMessage` または`OutMessage` のいずれか、またはその両方\) を調べ、どのメッセージがチャンク対象かを判断します。  次に、チャンク対象の各メッセージのアクションを \(`OperationDescription` の Messages コレクションから\) 取得し、これを `ChunkingBindingParameter` のインスタンス内に含まれている文字列コレクションに追加します。  そして、この `ChunkingBindingParameter` を指定された `BindingParameterCollection` に追加します。  
+  
+ この `BindingParameterCollection` は、バインディング要素がチャネル ファクトリまたはチャネル リスナを作成するときに、`BindingContext` 内でバインディングの各バインディング要素に渡されます。  `ChunkingBindingElement` が `BuildChannelFactory<T>` と `BuildChannelListener<T>` を実装すると、この `ChunkingBindingParameter` が `BindingContext’` の `BindingParameterCollection` からプルされます。  次に、`ChunkingBindingParameter` に含まれているアクションのコレクションが `ChunkingChannelFactory` または `ChunkingChannelListener` に渡され、その後 `ChunkingDuplexSessionChannel` に渡されます。  
+  
+## サンプルの実行  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+5.  最初に Service.exe を実行して次に Client.exe を実行し、両方のコンソール ウィンドウで出力を表示します。  
+  
+ このサンプルを実行すると、次の出力が予測されます。  
+  
+ クライアント:  
+  
+```  
+Press enter when service is available  
+  
+ > Sent chunk 1 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 2 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 3 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 4 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 5 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 6 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 7 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 8 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 9 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 10 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 1 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 2 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 3 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 4 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 5 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 6 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 7 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 8 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 9 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ < Received chunk 10 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+```  
+  
+ サーバー  
+  
+```  
+Service started, press enter to exit  
+ < Received chunk 1 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 2 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 3 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 4 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 5 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 6 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 7 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 8 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 9 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ < Received chunk 10 of message 867c1fd1-d39e-4be1-bc7b-32066d7ced10  
+ > Sent chunk 1 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 2 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 3 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 4 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 5 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 6 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 7 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 8 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 9 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+ > Sent chunk 10 of message 5b226ad5-c088-4988-b737-6a565e0563dd  
+```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/circular-tracing.md b/docs/framework/wcf/samples/circular-tracing.md
new file mode 100644
index 00000000000..028198105cb
--- /dev/null
+++ b/docs/framework/wcf/samples/circular-tracing.md
@@ -0,0 +1,71 @@
+---
+title: "循環トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5ff139f9-8806-47bc-8f33-47fe6c436b92
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 循環トレース
+このサンプルでは、循環バッファ トレース リスナの実装を示します。製品版サービスの一般的なシナリオは、長期間使用できるサービスを持つことと、トレース ログを低レベルで有効にすることです。こうしたサービスは、大量のディスク領域を消費します。サービスのトラブルシューティングを行う場合、問題の解決に関連するのはトレース ログの最新データです。このサンプルで示す循環バッファ トレース リスナの実装では、設定可能なデータ量を上限とする最新のトレースのみがディスク上に保持されます。このサンプルは「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいており、カスタム トレース リスナを含んでいます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、「[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)」サンプルを理解し、「[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)」サンプルで取り上げられているドキュメントを読んでいることを前提にしています。  
+  
+## 循環バッファ トレース リスナ  
+ 循環バッファ トレース リスナの実装の概念とは、2 つのファイルを使って、必要なトレース ログ データの全体量の半分を上限としたデータをそれぞれに保存することです。リスナは 1 つのファイルを作成して、データ サイズの半分という限界に到達するまでデータを書き込みます。この限界に到達した時点で、2 番目のファイルに切り替わります。2 番目のファイルの限界に到達したら、リスナは最初のファイルを新しいトレースで上書きします。  
+  
+ このリスナは `XmlWriteTraceListener` から派生し、ログを[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) で表示できるようにします。ログの表示を試みる際に、サービス トレース ビューア ツールで 2 つのログ ファイルを両方同時に開くと、これらのファイルを簡単に再結合することができます。サービス トレース ビューア ツールは、トレースが正しい順序で表示されるように自動的にトレースの並べ替えを管理します。  
+  
+## 構成  
+ サービスは、リスナとソースの要素に対して次のコードを追加することによって、循環バッファ トレース リスナを使用するように構成できます。ファイルの最大サイズは、循環トレース リスナの構成の `maxFileSizeKB` 属性を設定することによって指定します。このコードを次に示します。  
+  
+```  
+<system.diagnostics>  
+  <sources>  
+    <source name="System.ServiceModel" switchValue="Information,ActivityTracing" propagateActivity="true">  
+      <listeners>  
+        <add name="CircularTraceListener" />  
+      </listeners>  
+    </source>  
+  </sources>  
+  <sharedListeners>  
+    <add name="CircularTraceListener" type="Microsoft. Samples.ServiceModel.CircularTraceListener,CircularTraceListener"   
+         initializeData="c:\logs\CircularTracing-service.svclog" maxFileSizeKB="100" />  
+  </sharedListeners>  
+  <trace autoflush="true" />  
+</system.diagnostics>  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\CircularTracing`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/client-interoperability.md b/docs/framework/wcf/samples/client-interoperability.md
new file mode 100644
index 00000000000..6325e2f83c3
--- /dev/null
+++ b/docs/framework/wcf/samples/client-interoperability.md
@@ -0,0 +1,27 @@
+---
+title: "クライアント相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e890e40a-b76a-48c4-9e5b-a4b385fac847
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# クライアント相互運用性
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] と他のテクノロジとの相互運用性を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ASMX Web サービスとの相互運用性](../../../../docs/framework/wcf/samples/interoperating-with-asmx-web-services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーションを既存の ASMX Web サービスと統合する方法を示します。  
+  
+ [XMLSerializer サンプル](../../../../docs/framework/wcf/samples/xmlserializer-sample.md)  
+ <xref:System.Xml.Serialization.XmlSerializer> と互換性のある型をシリアル化および逆シリアル化する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/client-validation.md b/docs/framework/wcf/samples/client-validation.md
new file mode 100644
index 00000000000..8c6f0660b89
--- /dev/null
+++ b/docs/framework/wcf/samples/client-validation.md
@@ -0,0 +1,74 @@
+---
+title: "クライアント検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f0c1f805-1a81-4d0d-a112-bf5e2e87a631
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# クライアント検証
+サービスは頻繁にメタデータを公開し、クライアント プロキシの型を自動的に生成して構成できるようにします。  サービスが信頼できない場合、クライアント アプリケーションでは、セキュリティ、トランザクション、サービス コントラクトの型などに関して、メタデータがクライアント アプリケーションのポリシーに合致しているかどうか検証する必要があります。  次のサンプルでは、サービス エンドポイントを検証するクライアント エンドポイントの動作を記述して、サービス エンドポイントを安全に使用できることを確認する方法を示します。  
+  
+ サービスは 4 つのサービス エンドポイントを公開します。  1 つ目は WSDualHttpBinding を使用するエンドポイント、2 つ目は NTLM 認証を使用するエンドポイント、3 つ目はトランザクション フローを有効にするエンドポイント、4 つ目は証明書ベースの認証を使用するエンドポイントです。  
+  
+ クライアントは <xref:System.ServiceModel.Description.MetadataResolver> クラスを使用してサービスのメタデータを取得します。  クライアントは検証動作を使用して、二重バインディング、NTLM 認証、およびトランザクション フローを禁止するポリシーを適用します。  クライアント アプリケーションは、サービスのメタデータからインポートされた <xref:System.ServiceModel.Description.ServiceEndpoint> インスタンスごとに `InternetClientValidatorBehavior` エンドポイント動作のインスタンスを <xref:System.ServiceModel.Description.ServiceEndpoint> に追加し、その後 [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントを使用してエンドポイントへの接続を試行します。  動作の `Validate` メソッドはサービスで操作が呼び出される前に実行され、`InvalidOperationExceptions` をスローすることによってクライアントのポリシーを適用します。  
+  
+### サンプルをビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権を使用して Visual Studio コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+2.  サービス アプリケーションを \\service\\bin\\Debug で実行します。  
+  
+3.  クライアント アプリケーションを \\client\\bin\\Debug で実行します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+5.  サンプルの使用が終わったら、Cleanup.bat を実行して証明書を削除してください。  他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サーバー上で、管理特権を使用して Visual Studio コマンド プロンプトを実行し、「`setup.bat service`」と入力します。  `setup.bat` `` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+2.  サーバーで、App.config を編集して新しい証明書の名前を反映します。  つまり、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md) 要素の `findValue` 属性をコンピューターの完全修飾ドメイン名に変更します。  
+  
+3.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+4.  クライアント上で、管理者特権を使用して Visual Studio コマンド プロンプトを開き、「`setup.bat client`」と入力します。  `setup.bat` `` に `client` 引数を指定して実行すると、Client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+5.  client.cs ファイルで、MEX エンドポイントと、既定のサーバー証明書を設定するための `findValue` のアドレス値を、サービスの新しいアドレスに合わせて変更します。  そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。  再ビルドします。  
+  
+6.  Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+7.  クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。  これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+8.  サーバー上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportClientCert.bat を実行します。  これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+9. サービス コンピューターの Visual Studio でサービス プロジェクトをビルドし、service.exe を実行します。  
+  
+10. クライアント コンピューターで、client.exe を実行します。  
+  
+    1.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。  複数のコンピューターで証明書を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。  削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <サーバー コンピューターの完全修飾名>`を実行します。たとえば、"certmgr \-del \-r CurrentUser \-s TrustedPeople \-c \-n server1.contoso.com" となります。  
+  
+## 参照  
+ [メタデータを使用する](../../../../docs/framework/wcf/feature-details/using-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/client.md b/docs/framework/wcf/samples/client.md
new file mode 100644
index 00000000000..58c31b7c44b
--- /dev/null
+++ b/docs/framework/wcf/samples/client.md
@@ -0,0 +1,42 @@
+---
+title: "クライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fabb0c70-b79b-4e58-a5d3-9705de85ee5b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# クライアント
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [クライアント相互運用性](../../../../docs/framework/wcf/samples/client-interoperability.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と他の技術間の相互運用性を示します。  
+  
+ [アドレス ヘッダー](../../../../docs/framework/wcf/samples/address-headers.md)  
+ クライアントが [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、サービスに参照パラメーターを渡す方法を示します。  
+  
+ [チャネル ファクトリ](../../../../docs/framework/wcf/samples/channel-factory.md)  
+ クライアント アプリケーションが、生成されたクライアントではなく <xref:System.ServiceModel.ChannelFactory> クラスを含むチャネルを作成できる方法を示します。  
+  
+ [予期される例外](../../../../docs/framework/wcf/samples/expected-exceptions.md)  
+ 型指定のあるクライアントを使用する際に、予期される例外をキャッチする方法を示します。  
+  
+ [メタデータの抽出](../../../../docs/framework/wcf/samples/retrieve-metadata.md)  
+ サービスからメタデータを動的に取得し、通信に使用するエンドポイントを選択するクライアントを実装する方法を示します。  
+  
+ [Using ステートメントに関する問題の回避](../../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)  
+ 型指定のあるクライアントを使用する際に C\# の "using" ステートメントを使用せずに、リソースを自動的にクリーンアップする方法を示します。  
+  
+ [型指定のあるクライアント](../../../../docs/framework/wcf/samples/typed-client.md)  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で生成された型指定のあるクライアントから情報を取得する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/concurrency.md b/docs/framework/wcf/samples/concurrency.md
new file mode 100644
index 00000000000..3cdf7a34441
--- /dev/null
+++ b/docs/framework/wcf/samples/concurrency.md
@@ -0,0 +1,122 @@
+---
+title: "同時実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "同時実行のサンプル [Windows Communication Foundation]"
+  - "サービスの動作, 同時実行のサンプル"
+ms.assetid: f8dbdfb3-6858-4f95-abe3-3a1db7878926
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# 同時実行
+同時実行のサンプルでは、<xref:System.ServiceModel.ServiceBehaviorAttribute> を <xref:System.ServiceModel.ConcurrencyMode> 列挙体と共に使用する方法を示します。この列挙体は、サービスのインスタンスがメッセージを順番に処理するか、または同時に処理するかを制御します。  このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  このサンプルでは、`ICalculator` から継承される新しいコントラクト `ICalculatorConcurrency` を定義します。これによって、サービスの同時実行の状態を検査するための 2 つの操作が追加されます。  同時実行設定を変更してから、クライアントを実行して動作の変更を確認します。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) であり、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 選択可能な同時実行モードは次の 3 つです。  
+  
+-   `Single`: 各サービス インスタンスは、一度に 1 つのメッセージを処理します。  これが既定の同時実行モードです。  
+  
+-   `Multiple`: 各サービス インスタンスは、同時に複数のメッセージを処理します。  この同時実行モードを使用するには、サービスの実装がスレッドセーフである必要があります。  
+  
+-   `Reentrant`: 各サービス インスタンスは、一度に 1 つのメッセージを処理しますが、再入可能呼び出しを受け入れます。  サービスがこの呼び出しを受け入れるのは、コール アウトするときだけです。  再入は「[ConcurrencyMode.Reentrant](../../../../docs/framework/wcf/samples/concurrencymode-reentrant.md)」サンプルで説明されています。  
+  
+ 同時実行の使用は、インスタンス化モードに関連します。  <xref:System.ServiceModel.InstanceContextMode> インスタンス化では、各メッセージが新しいサービス インスタンスによって処理されるため、同時実行は関係しません。  <xref:System.ServiceModel.InstanceContextMode> インスタンス化では、<xref:System.ServiceModel.ConcurrencyMode> と <xref:System.ServiceModel.ConcurrencyMode> のいずれかの同時実行が関係します。これは 1 つのインスタンスがメッセージを順番に処理するか、同時に処理するかによって決まります。  <xref:System.ServiceModel.InstanceContextMode> インスタンス化では、どの同時実行モードも関係する可能性があります。  
+  
+ サービス クラスは、`[ServiceBehavior(ConcurrencyMode=<setting>)]` 属性を使用して同時実行動作を指定します。次のサンプル コードを参照してください。  行のコメント化を変更して、`Single` および `Multiple` の同時実行モードをそれぞれ試してみてください。  同時実行モードを変更したら、サービスを再ビルドする必要があります。  
+  
+```  
+// Single allows a single message to be processed sequentially by each service instance.  
+//[ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Single, InstanceContextMode = InstanceContextMode.Single)]  
+  
+// Multiple allows concurrent processing of multiple messages by a service instance.  
+// The service implementation should be thread-safe. This can be used to increase throughput.  
+[ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Multiple, InstanceContextMode = InstanceContextMode.Single)]  
+  
+// Uses Thread.Sleep to vary the execution time of each operation.  
+public class CalculatorService : ICalculatorConcurrency  
+{  
+    int operationCount;  
+  
+    public double Add(double n1, double n2)  
+    {  
+        operationCount++;  
+        System.Threading.Thread.Sleep(180);  
+        return n1 + n2;  
+    }  
+  
+    public double Subtract(double n1, double n2)  
+    {  
+        operationCount++;  
+        System.Threading.Thread.Sleep(100);  
+        return n1 - n2;  
+    }  
+  
+    public double Multiply(double n1, double n2)  
+    {  
+        operationCount++;  
+        System.Threading.Thread.Sleep(150);  
+        return n1 * n2;  
+    }  
+  
+    public double Divide(double n1, double n2)  
+    {  
+        operationCount++;  
+        System.Threading.Thread.Sleep(120);  
+        return n1 / n2;  
+    }  
+  
+    public string GetConcurrencyMode()  
+    {     
+        // Return the ConcurrencyMode of the service.  
+        ServiceHost host = (ServiceHost)OperationContext.Current.Host;  
+        ServiceBehaviorAttribute behavior = host.Description.Behaviors.Find<ServiceBehaviorAttribute>();  
+        return behavior.ConcurrencyMode.ToString();  
+    }  
+  
+    public int GetOperationCount()  
+    {     
+        // Return the number of operations.  
+        return operationCount;  
+    }  
+}  
+```  
+  
+ サンプルの既定の設定では、<xref:System.ServiceModel.InstanceContextMode> インスタンス化と <xref:System.ServiceModel.ConcurrencyMode> 同時実行が使用されます。  クライアント コードは、非同期プロキシを使用するように変更されています。  これにより、クライアントはサービスを呼び出した後に、応答を待たずに次の呼び出しを行うことができます。  サービスの同時実行モードの動作の違いを観察してください。  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  実行中のサービスの同時実行モードが表示され、各操作が呼び出され、その後で操作数が表示されます。  同時実行モードが `Multiple` の場合、結果が返される順序は呼び出された順序とは異なります。サービスは複数のメッセージを同時に実行するからです。  同時実行モードを `Single` に変更すると、結果は呼び出された順序どおりに返されます。サービスは各メッセージを順次処理するからです。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  Svcutil.exe を使用してプロキシ クライアントを生成する場合は、`/async` オプションを指定します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Concurrency`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/concurrencymode-reentrant.md b/docs/framework/wcf/samples/concurrencymode-reentrant.md
new file mode 100644
index 00000000000..5e0e45a2935
--- /dev/null
+++ b/docs/framework/wcf/samples/concurrencymode-reentrant.md
@@ -0,0 +1,98 @@
+---
+title: "ConcurrencyMode 再入 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2046c38-53d8-4a6c-a084-d6c7091d92b1
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ConcurrencyMode 再入
+このサンプルでは、サービス実装で ConcurrencyMode.Reentrant を使用する必要性と影響を示します。ConcurrencyMode.Reentrant は、サービス \(またはコールバック\) が指定された時間で処理するメッセージが 1 つだけであることを示します \(`ConcurencyMode.Single` に似ています\)。スレッド セーフを確保するには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はメッセージを処理する `InstanceContext` をロックして、他のメッセージが処理されないようにします。再入モードの場合、サービスが呼び出しの送信を行う直前に `InstanceContext` のロックが解除されます。これによりその後の呼び出しが可能になり \(サンプルに示すように再入可能になり\)、次回サービスに呼び出しが届いたときにロックされます。この動作を示すために、サンプルでは、クライアントとサービスが双方向コントラクトを使用してメッセージを相互に送信する方法を示します。  
+  
+ 定義されているコントラクトは双方向コントラクトで、サービスによって実装される `Ping` メソッドと、クライアントによって実装されるコールバック メソッド `Pong` を含みます。クライアントは、サーバーの `Ping` メソッドを呼び出します。このメソッドには、呼び出しを初期化するチック カウントが含まれています。サービスはチック カウントが 0 でないことを確認し、チック カウントをデクリメントしながらコールバックの `Pong` メソッドを呼び出します。これは、サンプルの次のコードによって行います。  
+  
+```  
+  
+public void Ping(int ticks)  
+{  
+     Console.WriteLine("Ping: Ticks = " + ticks);  
+     //Keep pinging back and forth till Ticks reaches 0.  
+     if (ticks != 0)  
+     {  
+         OperationContext.Current.GetCallbackChannel<IPingPongCallback>().Pong((ticks - 1));  
+     }  
+}  
+  
+```  
+  
+ コールバックの `Pong` 実装のロジックは、`Ping` 実装のロジックと同じです。つまり、このメソッドはチック カウントが 0 でないことを確認し、その後コールバック チャネル \(この場合は、元の `Ping` メッセージの送信に使用されたチャネル\) の `Ping` メソッドを呼び出し、チック カウントを 1 だけデクリメントします。チック カウントが 0 になると、このメソッドは返されます。これによってすべての応答のラップが解除され、クライアントが呼び出して初期化した最初の呼び出しに戻されます。これを、コールバック実装で示します。  
+  
+```  
+  
+public void Pong(int ticks)  
+{  
+    Console.WriteLine("Pong: Ticks = " + ticks);  
+    if (ticks != 0)  
+    {  
+        //Retrieve the Callback  Channel (in this case the Channel which was used to send the  
+        //original message) and make an outgoing call until ticks reaches 0.  
+        IPingPong channel = OperationContext.Current.GetCallbackChannel<IPingPong>();  
+        channel.Ping((ticks - 1));  
+    }  
+}  
+  
+```  
+  
+ `Ping` メソッドと `Pong` メソッドはどちらも要求\/応答です。つまり、`Ping` の最初の呼び出しは、`CallbackChannel<T>.Pong()` の呼び出しが返される以前には返されません。クライアントでは、`Pong` メソッドは、このメソッドを返す次の `Ping` 呼び出しが返される以前には返されません。コールバックとサービスはどちらも、保留中の要求に対して応答できるように、あらかじめ要求\/応答の呼び出しを送信する必要があるので、どちらの実装も ConcurrencyMode.Reentrant 動作でマークする必要があります。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピュータ構成または複数コンピュータ構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 使用例  
+ サンプルを実行するには、クライアント プロジェクトとサーバー プロジェクトをビルドします。次に 2 つのコマンド ウィンドウを開き、ディレクトリを \<sample\>\\CS\\Service\\bin\\debug と \<sample\>\\CS\\Client\\bin\\debug に変更します。次に、「`service.exe`」と入力してサービスを開始し、チックの初期値が入力パラメーターとして渡された Client.exe を呼び出します。サンプルでは、チックとして 10 が出力されます。  
+  
+```  
+  
+Prompt>Service.exe  
+ServiceHost Started. Press Enter to terminate service.  
+Ping: Ticks = 10  
+Ping: Ticks = 8  
+Ping: Ticks = 6  
+Ping: Ticks = 4  
+Ping: Ticks = 2  
+Ping: Ticks = 0  
+  
+Prompt>Client.exe 10  
+Pong: Ticks = 9  
+Pong: Ticks = 7  
+Pong: Ticks = 5  
+Pong: Ticks = 3  
+Pong: Ticks = 1  
+  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Reentrant`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/conditional-get-and-put.md b/docs/framework/wcf/samples/conditional-get-and-put.md
new file mode 100644
index 00000000000..6ab3774644e
--- /dev/null
+++ b/docs/framework/wcf/samples/conditional-get-and-put.md
@@ -0,0 +1,55 @@
+---
+title: "条件付きの Get と Put | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d22067f-57b8-4e0f-a571-a694512187ae
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 条件付きの Get と Put
+このサンプルでは、新しい条件付きの取得 API と更新 API を WCF REST プログラミング モデルで使用する方法を示します。条件付きの取得と更新はリソース指向の REST サービスに最も適しているため、このサンプルでは[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)のサンプルを拡張します。ここでは、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] で導入された新しい API を使用して、条件付きの取得と更新のサポートを[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)のサンプルに追加する方法について説明します。  
+  
+## 使用例  
+ 条件付きの取得と更新  
+  
+## 説明  
+ このサンプルの WCF サービスでは、リソース指向の REST 方式で顧客のコレクションが公開されます。サービスの実装の詳細については、「[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)」のサンプルを参照してください。  
+  
+ このサンプルでは、条件付きの取得機能と更新機能を[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)のサンプルに追加します。条件付きの取得と更新では、HTTP のエンティティ タグと HTTP の If\-None\-Match ヘッダーおよび If\-Match ヘッダーを使用して、指定されたリソースの最新のエンティティがクライアントにあるかどうかを検証します。しかし、HTTP の If\-None\-Match ヘッダーと If\-Match ヘッダーを正しく解析するコードを実装することは、面倒であるだけでなく間違いの元にもなります。そのため、<xref:System.ServiceModel.Web.IncomingWebRequestContext> に <xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドと <xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> メソッドが追加され、<xref:System.ServiceModel.Web.WebOperationContext> の現在のインスタンスを使用してアクセスできるようになっています。さらに、<xref:System.ServiceModel.Web.OutgoingWebRequestContext> に `SetETag` メソッドが追加されているため、有効なエンティティ タグを返すのも簡単になります。  
+  
+ <xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドは、\[WebGet\] 操作で使用されることを想定しています。このメソッドは、指定されたリソースの現在のエンティティ タグを `entityTag` パラメーターとして取得します。これは、`string`、`int`、`long`、または `Guid` のいずれかになります。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドは、エンティティ タグを要求の HTTP If\-None\-Match ヘッダーと照合してチェックします。エンティティ タグが HTTP If\-None\-Match ヘッダーにある場合、ステータス コード 304 \(変更なし\) が設定された <xref:System.ServiceModel.Web.WebFaultException> がスローされます。それ以外の場合は、メソッドから制御が戻ります。条件付きの取得メカニズムでは、クライアントからサーバーにそのエンティティを持っていることを通知し、クライアントがまだ現在のエンティティを持っていない場合にのみエンティティを送信することができます。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドの使用例は、サービスの `GetCustomer` 操作および `GetCustomers` 操作で確認できます。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> の呼び出しは戻らない場合があることに注意してください。そのため、操作を実装するときは、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> の呼び出しの実行前に、要求が成功することがわかるようにする必要があります。そうすることで、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> の呼び出しがなかった場合でも、成功を示すステータス コードが設定された応答がサービスから送信されます。  
+  
+ <xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> メソッドは、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> メソッドに似ています。このメソッドも、指定されたリソースの現在のエンティティ タグを取得します。ただし、このメソッドは、メソッドが "PUT" または "DELETE" に設定された \[WebInvoke\] 操作で使用されることを想定しています。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> メソッドは、エンティティ タグを要求の HTTP If\-Match ヘッダーと照合してチェックします。エンティティ タグが HTTP If\-Match ヘッダーにない場合、ステータス コード 412 \(必須条件に失敗しました\) が設定された <xref:System.ServiceModel.Web.WebFaultException> がスローされます。条件付きの更新メカニズムでは、クライアントからサーバーにリソースのそのエンティティを持っていることを通知し、クライアントが現在のエンティティを持っている場合にのみリソースの変更を許可することができます。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> メソッドの使用例は、サービスの `UpdateCustomer` 操作および `DeleteCustomer` 操作で確認できます。<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalRetrieve%2A> と同様に、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> の呼び出しは戻らない場合があることに注意してください。そのため、操作を実装するときは、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> の呼び出しの実行前に、要求が成功することがわかるようにする必要があります。そうすることで、<xref:System.ServiceModel.Web.IncomingWebRequestContext.CheckConditionalUpdate%2A> の呼び出しがなかった場合でも、成功を示すステータス コードがサービスから返されます。  
+  
+ このサンプルは、コンソール アプリケーション内で実行される自己ホスト型サービスとクライアントで構成されています。コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### サンプルを実行するには  
+  
+1.  条件付きの Get と Put のサンプルのソリューションを開きます。サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの **\[管理者として実行\]** をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーション プロジェクトを実行します。デバッグを有効にしてこのプロジェクトを実行する場合 \(Ctrl キーと F5 キーではなく F5 キーだけを押した場合\) は、条件付きの GET および PUT のチェックで例外がスローされるとデバッガーが停止します。停止した場合、サンプルの実行を続けるには F5 キーを押してください。  
+  
+3.  コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  
+  
+4.  サンプルが実行されると、クライアントは要求をサービスに送信し、応答をコンソール ウィンドウに書き込みます。  
+  
+5.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\ConditionalGetAndPut`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/configuration-based-activation.md b/docs/framework/wcf/samples/configuration-based-activation.md
new file mode 100644
index 00000000000..129f669457f
--- /dev/null
+++ b/docs/framework/wcf/samples/configuration-based-activation.md
@@ -0,0 +1,90 @@
+---
+title: "構成ベースのアクティブ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21bb762e-c43e-4b0c-887b-5e434d665838
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 構成ベースのアクティブ化
+このサンプルでは、.svc ファイルを使用せずに [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをアクティブ化する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\ConfigBasedActivation`  
+  
+## サンプルの詳細  
+ このサンプルでは、クライアントは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアントで、サービスは IIS によってホストされています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+### .svc ファイルを必要としない、サービスのアクティブ化  
+ [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] では、サービスをアクティブ化するために .svc ファイルが必要でした。アプリケーションと共に追加ファイルを配置して管理する必要があったため、このことは管理のオーバーヘッドを増やす原因となりました。[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] リリースでは、アプリケーション構成ファイルを使用してアクティブ化コンポーネントを構成することができます。  
+  
+ [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] では、アプリケーション構成ファイルの <xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection> に、新しい構成要素 <xref:System.ServiceModel.Configuration.ServiceActivationElement> が導入されています。<xref:System.ServiceModel.Configuration.ServiceHostingEnvironmentSection> コレクションは、次のコード例に示すように、サービスのコレクションを受け取ってアクティブ化を行います。  
+  
+```xml  
+<serviceActivations>  
+   <add relativeAddress="Calculator.svc" service="Microsoft.ServiceModel.Samples.CalculatorService" />  
+  
+<serviceActivations>  
+  
+```  
+  
+ 注目すべき点は、構成が .svc ファイルの構成に非常に似ていることです。導入された追加の属性は、サービスのアドレスを提供する `relativeAddress` です。相対アドレスは、サービスの仮想パスでもあります。ホストは、ファイルの Web.config ファイルが存在する場合に、そのファイルを `virtualPath` の場所から取得します。ファイルが存在しない場合、ホストはその親フォルダーを再帰的に検索します。  
+  
+> [!NOTE]
+>  このサンプルを機能させるには、IIS でホストする必要があります。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、Service.csproj ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  WCFTestClient.exe を実行してサービスをテストします。  
+  
+4.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を使用して、%SystemDrive%\\Program Files\\Microsoft Visual Studio 10.0\\Common7\\IDE フォルダーに移動します。  
+  
+5.  WcfTestClient.exe を実行します。  
+  
+6.  サービスの MEX アドレスを設定します。  
+  
+7.  Ctrl と Shift キーを押しながら A キーを押して、サービス アドレスを設定します。  
+  
+8.  アドレスを http:\/\/localhost\/ServiceModelSamples\/Calculator.svc に設定します。  
+  
+9. `Add` 操作を実行します。`n1` パラメーターの値を 10 に、`n2` パラメーターの値を 15 に設定します。  
+  
+10. **\[起動\]** をクリックします。  
+  
+     予期される結果は 25 です。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  ソリューションがビルドされたら、Setup.bat を実行し、IIS で ServiceModelSamples アプリケーションを設定します。ServiceModelSamples ディレクトリは、IIS アプリケーションとして表示されます。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/configuration-channel-factory.md b/docs/framework/wcf/samples/configuration-channel-factory.md
new file mode 100644
index 00000000000..a465d8c8e2e
--- /dev/null
+++ b/docs/framework/wcf/samples/configuration-channel-factory.md
@@ -0,0 +1,61 @@
+---
+title: "構成チャネル ファクトリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b749493-bd8a-4ccb-893e-5948901a1486
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 構成チャネル ファクトリ
+このサンプルでは、<xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> の使用方法を示します。<xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> により、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント構成の集中管理が可能になります。これは、アプリケーション ドメインによる読み込みの後に構成が選択または変更される場合にも役立ちます。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601>  
+  
+## 説明  
+ このサンプルでは、既定のアプリケーション構成ファイルを使用することなく、<xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> を使用して、クライアント アプリケーションに特定の構成ファイルを追加する方法を示します。  
+  
+ このサンプルは、2 つのプロジェクトで構成されます。最初のプロジェクトは、クライアントから送信されるメッセージに応答するために実行される単純なサービスです。2 番目のプロジェクトは、Test.config 構成ファイルの <xref:System.Configuration.ExeConfigurationFileMap> を使用して、2 つの <xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> オブジェクトを作成し、サービスとの通信にそれらのオブジェクトを使用するクライアント アプリケーションです。どちらのクライアントも Test.config で指定された構成を使用してサービスと通信します。  
+  
+ 次のコードでは、カスタム構成ファイルをクライアント アプリケーションに追加します。  
+  
+```  
+ExeConfigurationFileMap fileMap = new ExeConfigurationFileMap();  
+fileMap.ExeConfigFilename = "Test.config";  
+Configuration newConfiguration = ConfigurationManager.OpenMappedExeConfiguration(fileMap, ConfigurationUserLevel.None);  
+  
+ConfigurationChannelFactory<ICalculatorChannel> factory1 = new ConfigurationChannelFactory<ICalculatorChannel>("endpoint1", newConfiguration, new EndpointAddress("http://localhost:8000/servicemodelsamples/service"));  
+ICalculatorChannel client1 = factory1.CreateChannel();  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を管理者権限で開きます。  
+  
+2.  ConfigurationChannelFactory ソリューション \(2 つのプロジェクト\) を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+3.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[マルチ スタートアップ プロジェクト\]** をクリックします。  
+  
+4.  **Service** プロジェクトを一覧の先頭に移動し、**\[アクション\]** を \[開始\] に設定します。次に、**Client** プロジェクトを **Service** プロジェクトの後ろに移動し、同様に **\[アクション\]** を \[開始\] に設定して、**Client** プロジェクトが **Service** プロジェクトの後に実行されるようにします。  
+  
+5.  **\[OK\]** をクリックし、F5 キーを押して \(または Ctrl キーを押しながら F5 キーを押して\) サンプルを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\ConfigurationChannelFactory`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/configuration-sample.md b/docs/framework/wcf/samples/configuration-sample.md
new file mode 100644
index 00000000000..07b95c52a40
--- /dev/null
+++ b/docs/framework/wcf/samples/configuration-sample.md
@@ -0,0 +1,290 @@
+---
+title: "構成サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75515b4a-8d70-44c8-99e0-7423df41380e
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 構成サンプル
+このサンプルでは、構成ファイルを使用してサービスを探索可能にする方法を示します。  
+  
+> [!NOTE]
+>  このサンプルでは、探索を構成ファイルで実装しています。探索をコードで実装するサンプルについては、「[Basic](../../../../docs/framework/wcf/samples/basic-sample.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\Configuration`  
+  
+## サービス構成  
+ このサンプルの構成ファイルでは、次の 2 つの機能を示します。  
+  
+-   標準の <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> を介してサービスを探索できるようにします。  
+  
+-   サービスのアプリケーション エンドポイントに対する探索関連の情報を調整し、標準エンドポイントに対する探索関連の設定を調整します。  
+  
+ 探索を有効にするには、サービスのアプリケーション構成ファイルで次の変更を行う必要があります。  
+  
+-   探索エンドポイントを `<service>` 要素に追加する必要があります。これは標準の <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> エンドポイントです。このエンドポイントが、ランタイムによって探索サービスに関連付けられるシステム エンドポイントになります。探索サービスは、このエンドポイント上でメッセージをリッスンします。  
+  
+-   `<serviceDiscovery>` 動作を `<serviceBehaviors>` セクションに追加します。これにより、サービスが実行時に探索されるようになり、前述の探索エンドポイントを使用して探索の `Probe` メッセージおよび `Resolve` メッセージをリッスンするようになります。この 2 つの追加により、指定した探索エンドポイントでサービスが探索可能になります。  
+  
+ 次の構成スニペットでは、アプリケーション エンドポイントのサービスと定義された探索エンドポイントが示されています。  
+  
+```vb  
+<services>  
+        <service name="Microsoft.Samples.Discovery.CalculatorService"  
+                 behaviorConfiguration="calculatorServiceBehavior">  
+          <endpoint address=""  
+                    binding="wsHttpBinding"  
+                    contract="Microsoft.Samples.Discovery.ICalculatorService"  
+                    behaviorConfiguration="endpointBehaviorConfiguration" />  
+          <endpoint name="udpDiscovery"   
+                    kind="udpDiscoveryEndpoint"   
+                endpointConfiguration="adhocDiscoveryEndpointConfiguration"/>        </service>  
+      </services>  
+  
+```  
+  
+ アナウンスを活用するために、アナウンス エンドポイントを追加する必要があります。これを実行するために、次のコードに示すように構成ファイルを変更します。  
+  
+```  
+  
+<serviceDiscovery>  
+            <announcementEndpoints>  
+              <endpoint kind="udpAnnouncementEndpoint"/>  
+            </announcementEndpoints>  
+          </serviceDiscovery>  
+  
+```  
+  
+ アナウンス エンドポイントを探索サービス動作に追加することにより、サービスの既定のアナウンス クライアントが作成されます。これによって、サービスは、サービスが開いたときおよび閉じたときにそれぞれオンラインおよびオフラインのアナウンスを送信することが保証されます。  
+  
+ この構成ファイルは、さらに動作を変更することによって、より高度な機能を提供できます。特定のエンドポイントを使用することで、探索関連の情報を制御できます。つまり、ユーザーは、エンドポイントを探索できるかどうかを制御できるだけでなく、そのエンドポイントを <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior.Scopes%2A> およびカスタム XML メタデータでマークすることもできます。これを行うには、`behaviorConfiguration` プロパティをアプリケーション エンドポイントに追加する必要があります。この場合、次のプロパティをアプリケーション エンドポイントに追加します。  
+  
+```  
+behaviorConfiguration="endpointBehaviorConfiguration"  
+```  
+  
+ これで、この動作構成要素を通じて、探索関連の属性を制御できます。この場合、2 つのスコープがアプリケーション エンドポイントに追加されます。  
+  
+```xml  
+<endpointBehaviors>  
+          <behavior name="endpointBehaviorConfiguration">  
+            <endpointDiscovery>  
+              <scopes>  
+                <add scope="http://www.example.com/calculator"/>  
+                <add scope="ldap:///ou=engineering,o=examplecom,c=us"/>  
+              </scopes>  
+            </endpointDiscovery>  
+  
+          </behavior>            
+        </endpointBehaviors>  
+  
+```  
+  
+ スコープ[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[探索検索と FindCriteria](../../../../docs/framework/wcf/feature-details/discovery-find-and-findcriteria.md)」を参照してください。  
+  
+ 探索エンドポイントに固有の詳細を制御することもできます。この制御には <xref:System.ServiceModel.Configuration.StandardEndpointsSection> を使用します。このサンプルでは、次のコード例に示すように、使用するプロトコルのバージョンを変更し、`maxResponseDelay` 属性を追加します。  
+  
+```  
+<standardEndpoints>  
+   <udpDiscoveryEndpoint>  
+      <standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11" maxResponseDelay="00:00:00.600" />    
+   </udpDiscoveryEndpoint>  
+</standardEndpoints>  
+  
+```  
+  
+ この例で使用されている構成ファイルの全体を次に示します。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+  
+      <services>  
+        <service name="Microsoft.Samples.Discovery.CalculatorService"  
+                 behaviorConfiguration="calculatorServiceBehavior">  
+          <endpoint address=""  
+                    binding="wsHttpBinding"  
+                    contract="Microsoft.Samples.Discovery.ICalculatorService"  
+                    behaviorConfiguration="endpointBehaviorConfiguration" />  
+         <!-- Define the discovery endpoint -->            
+<endpoint name="udpDiscovery" kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration"/>        </service>  
+      </services>  
+  
+      <behaviors>  
+  
+        <serviceBehaviors>  
+          <behavior name="calculatorServiceBehavior">  
+  
+            <!-- Add an announcement endpoint -->  
+            <serviceDiscovery>  
+              <announcementEndpoints>  
+                <endpoint kind="udpAnnouncementEndpoint"/>  
+              </announcementEndpoints>  
+            </serviceDiscovery>  
+          </behavior>  
+        </serviceBehaviors>  
+  
+        <endpointBehaviors>  
+          <behavior name="endpointBehaviorConfiguration">  
+            <!-- Add scopes used to identify the service -->  
+            <endpointDiscovery>  
+              <scopes>  
+                <add scope="http://www.example.com/calculator"/>  
+                <add scope="ldap:///ou=engineering,o=examplecom,c=us"/>  
+              </scopes>  
+            </endpointDiscovery>  
+  
+          </behavior>            
+        </endpointBehaviors>  
+  
+      </behaviors>  
+  
+      <standardEndpoints>  
+        <udpDiscoveryEndpoint>  
+         <!-- Configure the UDP discovery endpoint -->  
+          <standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11" maxResponseDelay="00:00:00.600" />    
+        </udpDiscoveryEndpoint>  
+      </standardEndpoints>  
+  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## クライアント構成  
+ クライアントのアプリケーション構成ファイルでは、`dynamicEndpoint` 型の `standardEndpoint` を使用して次の構成スニペットに示すように探索を利用します。  
+  
+```xml  
+<client>  
+   <!--  Create an endpoint, make kind="dynamicEndpoint" and use the endpointConfiguration to change settings of DynamicEndpoint -->  
+   <endpoint name="calculatorEndpoint"  
+             binding="wsHttpBinding"  
+             contract="ICalculatorService"  
+             kind ="dynamicEndpoint"  
+             endpointConfiguration="dynamicEndpointConfiguration">  
+   </endpoint>  
+</client>  
+  
+```  
+  
+ クライアントで `dynamicEndpoint` を使用する場合、探索は自動的に実行されます。探索時にはさまざまな設定が使用されます。たとえば、使用する探索エンドポイントの型を指定する、`discoveryClientSettings` セクションで定義される設定などがあります。  
+  
+```xml  
+<endpoint kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration" />  
+  
+```  
+  
+ サービスの検索に使用する検索基準。  
+  
+```xml  
+<!-- Add Scopes, ScopeMatchBy, Extensions and termination criteria in FindCriteria -->  
+<findCriteria scopeMatchBy="http://schemas.microsoft.com/ws/2008/06/discovery/rfc" duration="00:00:10" maxResults="1">  
+   <scopes>  
+      <add scope="http://www.microsoft.com/building42/floor1"/>  
+   </scopes>  
+   <!-- These extensions are sent from the client to the service as part of the probe message -->  
+   <extensions>  
+      <CustomMetadata>This is custom metadata that is sent to the service along with the client's find request.</CustomMetadata>  
+   </extensions>  
+</findCriteria>  
+  
+```  
+  
+ このサンプルでは、この機能を拡張し、クライアントで使用される <xref:System.ServiceModel.Discovery.FindCriteria>、および探索に使用される標準の `updDiscoveryEndpoint` の一部のプロパティを変更します。<xref:System.ServiceModel.Discovery.FindCriteria> は、スコープと特定の `scopeMatchBy` アルゴリズム、およびカスタムの終了条件を使用するように変更します。さらに、このサンプルでは、クライアントで `Probe` メッセージを使用して XML 要素を送信する方法も示します。最後に、次の構成ファイルに示すように、使用するプロトコルのバージョンや UDP 固有の設定など、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> の変更をいくつか行います。  
+  
+```xml  
+<udpDiscoveryEndpoint>    
+        <!-- Specify the discovery protocol version and UDP transport settings. -->   
+        <standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11">  
+          <transportSettings duplicateMessageHistoryLength="2048"  
+                             maxPendingMessageCount="5"  
+                             maxReceivedMessageSize="8192"  
+                             maxBufferPoolSize="262144"/>  
+        </standardEndpoint>        
+      </udpDiscoveryEndpoint>  
+  
+```  
+  
+ サンプルで使用されているクライアント構成の全体を次に示します。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+  
+    <client>  
+      <!--  Create an endpoint, make kind="dynamicEndpoint" and use the endpointConfiguration to change settings of DynamicEndpoint -->  
+      <endpoint name="calculatorEndpoint"  
+                binding="wsHttpBinding"  
+                contract="ICalculatorService"  
+                kind ="dynamicEndpoint"  
+                endpointConfiguration="dynamicEndpointConfiguration">  
+      </endpoint>  
+    </client>  
+  
+    <standardEndpoints>  
+  
+      <dynamicEndpoint>        
+        <standardEndpoint name="dynamicEndpointConfiguration">  
+          <discoveryClientSettings>  
+            <!-- Controls where the discovery happens. In this case, Probe message is sent over UdpDiscoveryEndpoint. -->  
+            <endpoint kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration" />  
+  
+            <!-- Add Scopes, ScopeMatchBy, Extensions and termination criteria in FindCriteria -->  
+            <findCriteria scopeMatchBy="http://schemas.microsoft.com/ws/2008/06/discovery/rfc" duration="00:00:10" maxResults="1">  
+              <scopes>  
+                <add scope="http://www.microsoft.com/building42/floor1"/>  
+              </scopes>  
+              <!-- These extensions are sent from the client to the service as part of the probe message -->  
+              <extensions>  
+                <CustomMetadata>This is custom metadata that is sent to the service along with the client's find request.</CustomMetadata>  
+              </extensions>  
+            </findCriteria>  
+          </discoveryClientSettings>  
+        </standardEndpoint>     
+      </dynamicEndpoint>  
+  
+      <udpDiscoveryEndpoint>    
+        <!-- Specify the discovery protocol version and UDP transport settings. -->   
+        <standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11">  
+          <transportSettings duplicateMessageHistoryLength="2048"  
+                             maxPendingMessageCount="5"  
+                             maxReceivedMessageSize="8192"  
+                             maxBufferPoolSize="262144"/>  
+        </standardEndpoint>        
+      </udpDiscoveryEndpoint>  
+  
+    </standardEndpoints>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  このサンプルでは HTTP エンドポイントを使用します。このサンプルを実行するには、適切な URL ACL を追加する必要があります \(詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照してください\)。管理特権で次のコマンドを実行すると、適切な ACL が追加されます。そのままではコマンドが動作しない場合は、代わりに、ドメインとユーザー名を引数に指定して実行してみてください。`netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%`  
+  
+2.  ソリューションをビルドします。  
+  
+3.  ビルド ディレクトリからサービス実行可能ファイルを実行します。  
+  
+4.  クライアント実行可能ファイルを実行します。クライアントでサービスを検索できることに注意してください。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/configurationcodegenerator.md b/docs/framework/wcf/samples/configurationcodegenerator.md
new file mode 100644
index 00000000000..f6ebc9d7f77
--- /dev/null
+++ b/docs/framework/wcf/samples/configurationcodegenerator.md
@@ -0,0 +1,63 @@
+---
+title: "ConfigurationCodeGenerator | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3913aae8-165f-4014-9262-7fe426f90cb2
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ConfigurationCodeGenerator
+ConfigurationCodeGenerator は、カスタム チャネルの実装を構成システムに公開する際に使用できるツールです。カスタム チャネルのユーザーは、このツールを使用することによって、`NetTcpBinding` などのシステム指定のバインディングやカスタム バインディングを `TcpTransportBindingElement` で構成するのと同じように、.config ファイルを使用してカスタム チャネルを構成できます。  
+  
+ 新しい `BindingElement` または `Binding` を使用してカスタム チャネルを記述し、プログラミング モデルに公開する場合は、.config ファイルを使用して、`BindingElement` または `Binding` を構成可能にするためのクラスのセットを作成する必要があります。ConfigurationCodeGenerator ツールを使用すると、こうしたクラスを生成してユーザーの操作性を向上させることができます。  
+  
+### ツールをビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  ソリューションをビルドすると、ConfigurationCodeGenerator.exe ファイルが生成されます。SampleRun.cmd ファイルにはサンプルのコマンド ラインが含まれています。このコマンド ラインは、このツールを使用して「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」サンプル用のクラスを生成する方法を示します。  
+  
+### ツールを実行するには  
+  
+1.  `BindingElement` のカスタム型と `Binding` のカスタム型の両方がある場合は、コマンド プロンプトで次のように入力します。  
+  
+    ```  
+    ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereTheseTypesAreDefined  
+  
+    ```  
+  
+     `BindingElement` のカスタム型のみがある場合は、次のように入力します。  
+  
+    ```  
+    ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined  
+  
+    ```  
+  
+     `Binding` のカスタム型のみがある場合は、次のように入力します。  
+  
+    ```  
+    ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined  
+  
+    ```  
+  
+     このコマンドにより、`BindingElement` 用の 3 つの .cs ファイル \(\/be: オプションを指定した場合\)、標準の `Binding` 用の 5 つの .cs ファイル \(\/sb: オプションを指定した場合\)、および 1 つの .xml ファイルが生成されます。  
+  
+    1.  \/be オプションを使用した場合、いずれかの .cs ファイルに、バインディング要素用の `BindingElementExtensionSection` が実装されます。このコードにより、`BindingElement` が構成システムに公開されます。したがって他のカスタム バインディングも、このバインディング要素を使用できます。他のファイルには、既定と定数を示すクラスがあります。ファイルでは、既定値を更新する必要があることが `//TODO` コメントで示されています。  
+  
+    2.  \/sb オプションを指定した場合、2 つの .cs ファイルにそれぞれ `StandardBindingElement` と `StandardBindingCollectionElement` が実装されます。これによって、標準バインディングが構成システムに公開されます。他のファイルには、既定値と定数を示すクラスがあります。ファイルでは、既定値を更新する必要があることが `//TODO` コメントで示されています。  
+  
+         \/sb: オプションを指定した場合、CodeToAddTo\<*YourStdBinding*\>.cs には、標準バインディングを実装するクラスに手動で追加する必要のあるコードが設定されます。  
+  
+     SampleConfig.xml ファイルには、構成コードが含まれます。このコードは、前の手順 1. または 2. で定義されたハンドラーを登録する構成ファイルに追加する必要があります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/contract.md b/docs/framework/wcf/samples/contract.md
new file mode 100644
index 00000000000..16f77494cf6
--- /dev/null
+++ b/docs/framework/wcf/samples/contract.md
@@ -0,0 +1,39 @@
+---
+title: "コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 305eeb65-a52f-459e-9aa8-0ef071eade16
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# コントラクト
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のコントラクトを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [データ コントラクト](../../../../docs/framework/wcf/samples/data-contracts.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のデータ コントラクトを示します。  
+  
+ [メッセージ コントラクト](../../../../docs/framework/wcf/samples/message-contracts.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ コントラクトを示します。  
+  
+ [サービス コントラクト](../../../../docs/framework/wcf/samples/service-contracts.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のサービス コントラクトを示します。  
+  
+ [DataContractResolver](../../../../docs/framework/wcf/samples/datacontractresolver.md)  
+ <xref:System.Runtime.Serialization.DataContractResolver> クラスを使用して、シリアル化プロセスおよび逆シリアル化プロセスをカスタマイズする方法を示します。  
+  
+ [KnownAssemblyAttribute](../../../../docs/framework/wcf/samples/knownassemblyattribute.md)  
+ シリアル化および逆シリアル化時に既知の型を動的に追加する方法を示します。  
+  
+ [DataContractSerializer と DataContractResolver を使用した NetDataContractSerializer 機能の提供](../../../../docs/framework/wcf/samples/datacontractserializer-datacontractresolver-netdatacontractserializer.md)  
+ <xref:System.Runtime.Serialization.DataContractSerializer> を適切な <xref:System.Runtime.Serialization.DataContractResolver> と共に使用して、<xref:System.Runtime.Serialization.NetDataContractSerializer> と同じ機能を提供する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/cryptographic-agility-in-wcf-security.md b/docs/framework/wcf/samples/cryptographic-agility-in-wcf-security.md
new file mode 100644
index 00000000000..afb0544c452
--- /dev/null
+++ b/docs/framework/wcf/samples/cryptographic-agility-in-wcf-security.md
@@ -0,0 +1,48 @@
+---
+title: "WCF セキュリティの暗号化方式の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c2c549e5-ac19-40c5-b686-8f67f52b6dbf
+caps.latest.revision: 9
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 9
+---
+# WCF セキュリティの暗号化方式の指定
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントおよびサービスで迅速な暗号化実装を提供するために標準またはカスタム アルゴリズムで指定する方法を示します。  サンプルは、以下のプロジェクトで構成されます。  
+  
+ サービス  
+ これは自己ホスト型の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで、`ICalculator` インターフェイスを実装し、セキュリティで保護されたセッションと信頼できるセッションが無効に設定された <xref:System.ServiceModel.WsHttpBinding> を使用してエンドポイントをセキュリティで保護します。  このサービスは、カスタム `SecurityAlgorithmSuite` クラスを定義し、メッセージのセキュリティを確保するために使用される暗号化アルゴリズムを指定します。  
+  
+ Client  
+ これは、認証が成功した後にサービスにアクセスする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントです。  このクライアントは、`ICalculator` インターフェイスによって公開され、サービスによって実装される操作を呼び出します。  このクライアントも、同じカスタム `SecurityAlgorithmSuite` クラスを定義し、メッセージのセキュリティを確保するために使用される暗号化アルゴリズムを指定します。  
+  
+### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で CryptoAgility.sln ソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)]を開き、\\WCF\\Basic\\Security\\CryptoAgility\\Service\\bin ディレクトリに移動して、service.exe ファイルを管理者権限で実行します。これを行うには、service.exe を右クリックして **\[管理者として実行\]** をクリックします。  
+  
+4.  \\WCF\\Basic\\Security\\CryptoAgility\\Client\\bin ディレクトリに移動して、client.exe ファイルを通常の方法で実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Security\CryptoAgility`  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wcf/feature-details/security.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding-imperative.md b/docs/framework/wcf/samples/custom-binding-imperative.md
new file mode 100644
index 00000000000..48c18ec7a1c
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding-imperative.md
@@ -0,0 +1,96 @@
+---
+title: "カスタム バインディング強制 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6e13bf96-5de0-4476-b646-5f150774418d
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# カスタム バインディング強制
+このサンプルでは、強制コードを書き込むことにより、構成ファイルや生成された [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントを使用せずにカスタム バインディングを定義して使用する方法を示します。このサンプルでは、HTTP トランスポートと信頼できるセッション チャネルによって提供される機能を組み合わせて、HTTP ベースの信頼できるバインディングを作成します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ カスタム バインディングはクライアントとサービスの両方で作成されます。カスタム バインディングは、次のように 2 つのバインディング要素 \(信頼できるセッションと HTTP\) が含まれます。  
+  
+```  
+  
+ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();  
+reliableSession.Ordered = true;  
+  
+HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();  
+httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;  
+httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;  
+  
+CustomBinding binding = new CustomBinding(reliableSession, httpTransport);  
+  
+```  
+  
+ サービスでは、次のようにエンドポイントを ServiceHost に追加することによってバインディングを使用します。  
+  
+```  
+serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");  
+```  
+  
+ クライアントでは、バインドは次のように <xref:System.ServiceModel.ChannelFactory> によって使用され、サービスにチャネルが作成されます。  
+  
+```  
+EndpointAddress address = new EndpointAddress("http://localhost:8000/servicemodelsamples/service");  
+ChannelFactory<ICalculator> channelFactory = new ChannelFactory<ICalculator>(binding, address);  
+ICalculator channel = channelFactory.CreateChannel();  
+```  
+  
+ その後、このチャネルは次のようにサービスとのやり取りに使用されます。  
+  
+```  
+  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = channel.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Binding\Custom\Imperative`  
+  
+## 参照  
+ [Custom Binding](http://msdn.microsoft.com/ja-jp/657e8143-beb0-472d-9cfe-ed1a19c2ab08)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding-reliable-session-over-https.md b/docs/framework/wcf/samples/custom-binding-reliable-session-over-https.md
new file mode 100644
index 00000000000..269b230cd18
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding-reliable-session-over-https.md
@@ -0,0 +1,149 @@
+---
+title: "HTTPS を介したカスタム バインディングの信頼できるセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 16aaa80d-3ffe-47c4-8b16-ec65c4d25f8d
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# HTTPS を介したカスタム バインディングの信頼できるセッション
+このサンプルでは、信頼できるセッションを使用した SSL トランスポート セキュリティを示します。信頼できるセッションは、WS\-ReliableMessaging プロトコルを実装しています。信頼できるセッションを介して WS\-Security を構築することにより、セキュリティで保護された信頼できるセッションを持つことができます。ただし、SSL による HTTP トランスポート セキュリティの使用を選択できる場合もあります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Custom\ReliableSessionOverHttps`  
+  
+## サンプルの詳細  
+ SSL では、パケット自体のセキュリティが保護されます。WS\-SecureConversation を使用して、信頼できるセッションのセキュリティを保護する場合とは異なることに注意してください。  
+  
+ HTTPS を介して信頼できるセッションを使用するには、カスタム バインディングを作成する必要があります。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。カスタム バインディングは、信頼できるセッションのバインディング要素と [\<httpsTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/httpstransport.md)を使用して作成されます。カスタム バインディングの構成を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- use base address provided by host -->  
+        <endpoint address=""  
+                  binding="customBinding"  
+                  bindingConfiguration="reliableSessionOverHttps"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is exposed as http://localhost/servicemodelsamples/service.svc/mex-->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange"/>  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <customBinding>  
+        <binding name="reliableSessionOverHttps">  
+          <reliableSession />  
+          <httpsTransport />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="true" />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+```  
+  
+ サンプル内のプログラム コードは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」サービスのプログラム コードと同じです。このサンプルをビルドして実行する前に、証明書を作成し、Web サーバー証明書ウィザードを使用してあらかじめ割り当てておく必要があります。次に示すクライアント用構成の例のように、構成ファイル設定でエンドポイントとバインディングを定義すると、カスタム バインディングの使用が有効になります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+  
+    <client>  
+      <!-- this endpoint has an https: address -->  
+      <endpoint name=""  
+                address="https://localhost/servicemodelsamples/service.svc"   
+                binding="customBinding"   
+                bindingConfiguration="reliableSessionOverHttps"   
+                contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </client>  
+  
+      <bindings>  
+        <customBinding>  
+          <binding name="reliableSessionOverHttps">  
+            <reliableSession />  
+            <httpsTransport />  
+          </binding>  
+        </customBinding>        
+    </bindings>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+  
+```  
+  
+ アドレス指定では https:\/\/ スキームを使用しています。  
+  
+ このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザで https:\/\/localhost\/servicemodelsamples\/service.svc のような https: アドレスにアクセスしようとするとセキュリティ警告が表示されます。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントがテスト証明書に対して問題なく動作するようにするには、クライアントにコードを追加して、セキュリティ警告を非表示にする必要があります。そのためのコードとそれに必要なクラスは、本運用の証明書を使用するときには不要です。  
+  
+```  
+// This code is required only for test certificates like those created by Makecert.exe.  
+PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」が実行済みであることを確認します。  
+  
+4.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding-reliable-session.md b/docs/framework/wcf/samples/custom-binding-reliable-session.md
new file mode 100644
index 00000000000..f0b26ad4613
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding-reliable-session.md
@@ -0,0 +1,135 @@
+---
+title: "カスタム バインディングの信頼できるセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c5fcd409-246f-4f3e-b3f1-629506ca4c04
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# カスタム バインディングの信頼できるセッション
+カスタム バインディングは、個々のバインディング要素の順序付きリストとして定義されます。  このサンプルでは、さまざまなトランスポートとメッセージ エンコーディング要素を使用し、特に信頼できるセッションを有効化することによって、カスタム バインディングを構成する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Custom\ReliableSession`  
+  
+## サンプルの詳細  
+ 信頼できるセッションは、信頼できるメッセージとセッションに関する機能を提供します。  信頼できるメッセージは、エラー時に通信を再試行するほか、メッセージの順次到着などの配信の保証を指定できるようにします。  セッションでは、呼び出し間でクライアントの状態が保持されます。  サンプルでは、クライアントの状態を保持するセッションを実装し、配信順序を保証することを指定します。  このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  信頼できるセッション機能は、クライアントとサービスのアプリケーション構成ファイルで有効化され、構成されています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ カスタム バインディングを定義するうえで、バインディング要素の順序は重要です。各バインディング要素は、チャネル スタック内のレイヤーを表すためです \(「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください\)。  
+  
+ サンプルのサービス構成は、次のコード例のように定義されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- This endpoint is exposed at the base address provided by host: http://localhost/servicemodelsamples/service.svc  -->  
+        <!-- specify customBinding binding and a binding configuration to use -->  
+        <endpoint address=""  
+                  binding="customBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <!-- custom binding configuration - configures HTTP transport, reliable sessions -->  
+    <bindings>  
+      <customBinding>  
+        <binding name="Binding1">  
+          <reliableSession />  
+          <security authenticationMode="SecureConversation"  
+                     requireSecurityContextCancellation="true">  
+          </security>  
+          <compositeDuplex />  
+          <oneWay />  
+          <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8" />  
+          <httpTransport authenticationScheme="Anonymous" bypassProxyOnLocal="false"  
+                        hostNameComparisonMode="StrongWildcard"   
+                        proxyAuthenticationScheme="Anonymous" realm=""   
+                        useDefaultWebProxy="true" />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+```  
+  
+ 複数コンピュータのシナリオで実行する場合は、クライアントのエンドポイント アドレスをサービスのホスト名に合わせて変更する必要があります。  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!IMPORTANT]
+    >  複数コンピュータ構成でクライアントを実行する場合は、[\<endpoint\>](../../../../docs/framework/configure-apps/file-schema/wcf/endpoint-element.md) 要素の `address` 属性と、[\<compositeDuplex\>](../../../../docs/framework/configure-apps/file-schema/wcf/compositeduplex.md)の `clientBaseAddress` 属性の両方に含まれる "localhost" を、適切なコンピュータの名前で置き換える必要があります。次の例を参照してください。  
+  
+    ```  
+    <endpoint name = ""  
+    address="http://service_machine_name/servicemodelsamples/service.svc"  
+    ... />  
+    <compositeDuplex clientBaseAddress="http://client_machine_name:8000/myClient/" />  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding-security.md b/docs/framework/wcf/samples/custom-binding-security.md
new file mode 100644
index 00000000000..bdcb0c3386d
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding-security.md
@@ -0,0 +1,200 @@
+---
+title: "カスタム バインディング セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a6383dff-4308-46d2-bc6d-acd4e18b4b8d
+caps.latest.revision: 30
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 30
+---
+# カスタム バインディング セキュリティ
+このサンプルでは、カスタム バインディングを使用してセキュリティを構成する方法を示します。カスタム バインディングを使用して、セキュリティで保護されたトランスポートと共にメッセージ レベルのセキュリティを有効にする方法を示します。これは、クライアントとサービス間でメッセージを転送する際にセキュリティで保護されたトランスポートが必要であると同時に、そのメッセージをメッセージ レベルでセキュリティ保護する必要がある場合に便利です。この構成は、システム指定のバインディングではサポートされていません。  
+  
+ このサンプルは、クライアント コンソール プログラム \(EXE\) とサービス コンソール プログラム \(EXE\) で構成されています。サービスは、双方向コントラクトを実装します。このコントラクトは `ICalculatorDuplex` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および 除算\) を公開しています。`ICalculatorDuplex` インターフェイスを使用することにより、クライアントは算術演算を実行し、セッション経由で実行結果を計算できます。サービスは、`ICalculatorDuplexCallback` インターフェイスで結果を個別に返すことができます。コンテキストを確立して、クライアントとサービスの間で送信される一連のメッセージを相互に関連付ける必要があるため、二重のコントラクトにはセッションが必要です。カスタム バインディングは、双方向通信をサポートしてセキュリティで保護されるよう定義されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス構成では、次をサポートするカスタム バインディングが定義されます。  
+  
+-   TLS\/SSL プロトコルを使用して保護される TCP 通信。  
+  
+-   Windows メッセージ セキュリティ。  
+  
+ カスタム バインディングの構成により、トランスポートのセキュリティ保護が有効になると同時に、メッセージ レベルのセキュリティも有効になります。カスタム バインディングを定義するうえで、バインディング要素の順序は重要です。各バインディング要素は、チャネル スタック内のレイヤーを表すためです \(「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください\)。カスタム バインディングはサービスとクライアントの構成ファイルで定義されます。次のサンプル構成を参照してください。  
+  
+```  
+<bindings>  
+  <!-- Configure a custom binding. -->  
+  <customBinding>  
+    <binding name="Binding1">  
+      <security authenticationMode="SecureConversation"  
+                 requireSecurityContextCancellation="true">  
+      </security>  
+      <textMessageEncoding messageVersion="Soap12WSAddressing10" writeEncoding="utf-8"/>  
+      <sslStreamSecurity requireClientCertificate="false"/>  
+      <tcpTransport/>  
+    </binding>  
+  </customBinding>  
+</bindings>  
+```  
+  
+ カスタム バインディングはサービス証明書を使用して、トランスポート レベルでサービスを認証し、クライアントとサービス間で転送中のメッセージを保護します。これは `sslStreamSecurity` バインディング要素によって実現されます。サービスの証明書は、サービス動作を使用して構成されます。次のサンプル構成を参照してください。  
+  
+```  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName"/>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+```  
+  
+ さらに、カスタム バインディングは Windows 資格情報の種類 \(既定の資格情報の種類\) によるメッセージ セキュリティを使用します。これは `security` バインディング要素によって実現されます。Kerberos 認証機構が利用できる場合は、クライアントとサービスはどちらもメッセージ レベルのセキュリティを使用して認証されます。サンプルを Active Directory 環境で実行する場合、この認証が行われます。Kerberos 認証機構が利用できない場合は、NTLM 認証が使用されます。NTLM はサービスに対してクライアントを認証しますが、クライアントに対するサービスの認証は行いません。`security` バインディング要素は `SecureConversation` と`authenticationType` を使用するように構成されます。この結果、クライアントとサービスの両方でセキュリティ セッションが作成されます。これは、サービスの双方向コントラクトを動作させるために必要です。  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Press <ENTER> to terminate client.  
+Result(100)  
+Result(50)  
+Result(882.5)  
+Result(441.25)  
+Equation(0 + 100 - 50 * 17.65 / 2 = 441.25)  
+  
+```  
+  
+ サンプルを実行すると、クライアントに戻ってきたメッセージがサービスから送信されたコールバック インターフェイスに表示されます。それぞれの中間結果が表示され、その後にすべての操作が完了したときの数式全体が表示されます。Enter キーを押してクライアントをシャットダウンします。  
+  
+ サンプルに用意されている Setup.bat ファイルを使用すると、適切なサービス証明書を使用してクライアントとサーバーを構成し、証明書ベースのセキュリティを必要とするホスト アプリケーションを実行できるようになります。このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、このサンプルに適用されるバッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat ファイルの次の行は、使用するサーバー証明書を作成します。`%SERVER_NAME%` 変数はサーバー名です。この変数を変更して、使用するサーバー名を指定します。このバッチ ファイルでのサーバー名の既定は localhost です。  
+  
+     Web ホスト サービスの場合、証明書は CurrentUser ストアに格納されます。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     Setup.bat ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、Visual Studio 2010 コマンド プロンプトから実行します。MSSDK 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Visual Studio 2010 コマンド プロンプトで自動設定されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権を使用して Visual Studio コマンド プロンプト ウィンドウを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  Service.exe を \\service\\bin で起動します。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューター上で次の手順を実行します。  
+  
+    1.  サービス コンピューターで、servicemodelsamples という仮想ディレクトリを作成します。  
+  
+    2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。ファイルのコピー先が \\bin サブディレクトリであることを確認します。  
+  
+    3.  Setup.bat ファイルと Cleanup.bat ファイルをサービス コンピューターにコピーします。  
+  
+    4.  管理特権を使用して Visual Studio コマンド プロンプトを開き、`Setup.bat service` を実行します。これにより、バッチ ファイルが実行されたコンピューターの名前と一致するサブジェクト名を持つ、サービス証明書が作成されます。  
+  
+        > [!NOTE]
+        >  Setup.bat バッチ ファイルは、Visual Studio 2010 コマンド プロンプトから実行します。path 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Visual Studio 2010 コマンド プロンプトで自動設定されます。  
+  
+    5.  Service.exe.config ファイル内の [\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)を変更し、前の手順で生成された証明書のサブジェクト名を反映します。  
+  
+    6.  コマンド プロンプトから Service.exe を起動します。  
+  
+2.  クライアント コンピューター上で次の手順を実行します。  
+  
+    1.  クライアント プログラム ファイルを、\\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。Cleanup.bat ファイルもコピーします。  
+  
+    2.  Cleanup.bat を実行して、前のサンプルから古い証明書を削除します。  
+  
+    3.  サービス コンピューターで、管理特権を使用して Visual Studio コマンド プロンプトを開き、次のコマンドを実行して、サービスの証明書をエクスポートします \(`%SERVER_NAME%` は、サービスが実行されているコンピューターの完全修飾名に置き換えてください\)。  
+  
+        ```  
+        certmgr -put -r LocalMachine -s My -c -n %SERVER_NAME% %SERVER_NAME%.cer  
+        ```  
+  
+    4.  %SERVER\_NAME%.cer をクライアント コンピューターにコピーします \(%SERVER\_NAME% は、サービスが実行されているコンピューターの完全修飾名に置き換えてください\)。  
+  
+    5.  クライアント コンピューターで、管理特権を使用して Visual Studio コマンド プロンプトを開き、次のコマンドを実行して、サービスの証明書をインポートします \(%SERVER\_NAME% は、サービスが実行されているコンピューターの完全修飾名に置き換えてください\)。  
+  
+        ```  
+        certmgr.exe -add -c %SERVER_NAME%.cer -s -r CurrentUser TrustedPeople  
+        ```  
+  
+         証明書が信頼できる発行元から発行されている場合は、手順 c.、d.、および e. は不要です。  
+  
+    6.  次のようにクライアントの App.config ファイルを変更します。  
+  
+        ```  
+        <client>  
+            <endpoint name="default"  
+                address="net.tcp://ReplaceThisWithServiceMachineName:8000/ServiceModelSamples/Service"   
+                binding="customBinding"   
+                bindingConfiguration="Binding1"   
+                contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex"  
+        behaviorConfiguration="CalculatorClientBehavior" />  
+        </client>  
+  
+        ```  
+  
+    7.  ドメイン環境でサービスが NetworkService または LocalSystem 以外のアカウントで実行されている場合は、クライアントの App.config ファイル内のサービス エンドポイントのエンドポイント ID を変更し、サービスの実行に使用されているアカウントに基づいて、適切な UPN または SPN を設定する必要がある場合があります。エンドポイント ID の詳細については、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」のトピックを参照してください。  
+  
+    8.  コマンド プロンプトから Client.exe を起動します。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding-transport-and-encoding.md b/docs/framework/wcf/samples/custom-binding-transport-and-encoding.md
new file mode 100644
index 00000000000..dbad73ac113
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding-transport-and-encoding.md
@@ -0,0 +1,94 @@
+---
+title: "カスタム バインディングのトランスポートとエンコード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c0b353d-79ee-4e61-b348-be49ad0e9a16
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# カスタム バインディングのトランスポートとエンコード
+カスタム バインディングは、個々のバインディング要素の順序付きリストとして定義されます。このサンプルでは、さまざまなトランスポートとメッセージ エンコーディング要素を使用してカスタム バインディングを構成する方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」に基づいており、HTTP、TCP、NamedPipe の各トランスポートがカスタム バインディングでサポートされるように、3 つのエンドポイントの構成が変更されています。クライアント構成も同様に変更され、クライアント コードは 3 つのエンドポイントそれぞれと通信するように変更されています。  
+  
+ このサンプルでは、特定のトランスポートとメッセージ エンコーディング要素をサポートするカスタム バインディングを構成する方法を示します。これを行うには、`binding` 要素のトランスポートとメッセージ エンコーディングを構成します。カスタム バインディングを定義するうえで、バインディング要素の順序は重要です。各バインディング要素は、チャネル スタック内のレイヤを表すからです \(「[カスタム バインディング](../../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください\)。このサンプルでは、テキスト エンコーディングによる HTTP トランスポート、テキスト エンコーディングによる TCP トランスポート、およびバイナリ エンコーディングによる NamedPipe トランスポートの 3 つのカスタム バインディングを構成します。  
+  
+ サービス構成では、次のようにカスタム バインディングが定義されます。  
+  
+```  
+<bindings>  
+    <customBinding>  
+        <binding name="HttpBinding" >  
+            <textMessageEncoding   
+                messageVersion="Soap12Addressing10"/>  
+            <httpTransport />  
+        </binding>  
+        <binding name="TcpBinding" >  
+            <textMessageEncoding />  
+            <tcpTransport />  
+        </binding>  
+        <binding name="NamedPipeBinding" >  
+            <binaryMessageEncoding />  
+            <namedPipeTransport />  
+        </binding>  
+    </customBinding>  
+</bindings>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。クライアントは、3 つのエンドポイントのそれぞれと通信します。最初に HTTP、次に TCP、最後に NamedPipe にアクセスします。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+ `namedPipeTransport` バインディングは、複数のコンピュータ間の操作をサポートしません。同じコンピュータの通信だけに使用されます。したがって、このサンプルを複数コンピュータのシナリオで実行する場合は、クライアント コード ファイル内の次の行をコメント化してください。  
+  
+```csharp  
+CalculatorClient client = new CalculatorClient("default");  
+Console.WriteLine("Communicate with named pipe endpoint.");  
+// Call operations.  
+DoCalculations(client);  
+//Closing the client gracefully closes the connection and cleans up resources  
+client.Close();  
+```  
+  
+```vb  
+Dim client As New CalculatorClient("default")  
+Console.WriteLine("Communicate with named pipe endpoint.")  
+' call operations  
+DoCalculations(client)  
+'Closing the client gracefully closes the connection and cleans up resources  
+client.Close()  
+```  
+  
+> [!NOTE]
+>  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版、C\+\+ 版、または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Custom\Transport`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-binding.md b/docs/framework/wcf/samples/custom-binding.md
new file mode 100644
index 00000000000..35ce62aaecb
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-binding.md
@@ -0,0 +1,33 @@
+---
+title: "カスタム バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3c9537ea-9708-4ebc-b861-219f2e2db53d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# カスタム バインディング
+このセクションには、エンドポイント要素のカスタム バインディング属性の使用方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [カスタム バインディング強制](../../../../docs/framework/wcf/samples/custom-binding-imperative.md)  
+ 強制コードを書き込むことにより、構成ファイルや生成された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを使用せずにカスタム バインディングを定義して使用する方法を示します。  
+  
+ [カスタム バインディングのトランスポートとエンコード](../../../../docs/framework/wcf/samples/custom-binding-transport-and-encoding.md)  
+ さまざまなトランスポートとメッセージ エンコーディング要素を使用してカスタム バインディングを構成する方法を示します。  
+  
+ [カスタム バインディングの信頼できるセッション](../../../../docs/framework/wcf/samples/custom-binding-reliable-session.md)  
+ さまざまなトランスポートとメッセージ エンコーディング要素を使用し、特に信頼できるセッションを有効化することによって、カスタム バインディングを構成する方法を示します。  
+  
+ [HTTPS を介したカスタム バインディングの信頼できるセッション](../../../../docs/framework/wcf/samples/custom-binding-reliable-session-over-https.md)  
+ 信頼できるセッションを使用した SSL トランスポート セキュリティの使用方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-channel-dispatcher.md b/docs/framework/wcf/samples/custom-channel-dispatcher.md
new file mode 100644
index 00000000000..58bf1a83022
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-channel-dispatcher.md
@@ -0,0 +1,64 @@
+---
+title: "カスタム チャネル ディスパッチャー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 813acf03-9661-4d57-a3c7-eeab497321c6
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# カスタム チャネル ディスパッチャー
+このサンプルでは、<xref:System.ServiceModel.ServiceHostBase> を直接実装することによって、カスタマイズした方法でチャネル スタックを作成する方法と、Web ホスト環境でカスタム チャネル ディスパッチャーを作成する方法を示します。チャネル ディスパッチャーは、<xref:System.ServiceModel.Channels.IChannelListener> と対話してチャネルを受け入れ、チャネル スタックからメッセージを取得します。このサンプルには、<xref:System.ServiceModel.Activation.VirtualPathExtension> を使用して Web ホスト環境でチャネル スタックを作成する方法を示す基本的なサンプルも用意されています。  
+  
+## カスタム ServiceHostBase  
+ このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] スタック実装をチャネル スタック上のカスタム メッセージ処理層で置き換える方法を示すために、基本型として <xref:System.ServiceModel.ServiceHost> の代わりに <xref:System.ServiceModel.ServiceHostBase> を実装します。仮想メソッド <xref:System.ServiceModel.ServiceHostBase.InitializeRuntime%2A> をオーバーライドして、チャネル リスナーとチャネル ディスパッチャーを作成します。  
+  
+ Web ホスト サービスを実装するには、サービス拡張 <xref:System.ServiceModel.Activation.VirtualPathExtension> を <xref:System.ServiceModel.ServiceHostBase.Extensions%2A> コレクションから取得し、<xref:System.ServiceModel.Channels.BindingParameterCollection> に追加します。これにより、トランスポート層で、ホスト環境の設定 \(つまり、インターネット インフォメーション サービス \(IIS\) および Windows プロセス アクティブ化サービス \(WAS\) の設定\) に基づいてチャネル リスナーを構成する方法を認識できるようになります。  
+  
+## カスタム チャネル ディスパッチャー  
+ カスタム チャネル ディスパッチャーは型 <xref:System.ServiceModel.Dispatcher.ChannelDispatcherBase> を拡張します。この型はチャネル層のプログラミング ロジックを実装します。このサンプルでは、要求\/応答メッセージ交換パターンでサポートされるのは <xref:System.ServiceModel.Channels.IReplyChannel> だけですが、カスタム チャネル ディスパッチャーは他の種類のチャネルに簡単に拡張できます。  
+  
+ ディスパッチャーは、まずチャネル リスナーを開き、次にシングルトン応答チャネルを受け入れます。このチャネルを使用して、無限ループでメッセージ \(応答\) の送信を開始します。要求ごとに、応答メッセージを作成し、クライアントに返信します。  
+  
+## 応答メッセージの作成  
+ メッセージ処理は型 `MyServiceManager` で実装されます。`HandleRequest` メソッドでは、要求がサポートされているかどうか確認するために、メッセージの `Action` ヘッダーが最初にチェックされます。メッセージ フィルター処理を提供するために、定義済みの SOAP アクション "http:\/\/tempuri.org\/HelloWorld\/Hello" が定義されています。これは、<xref:System.ServiceModel.ServiceHost> の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 実装におけるサービス コントラクトの概念と似ています。  
+  
+ 正しい SOAP アクションの場合、サンプルでは、<xref:System.ServiceModel.ServiceHost> の場合と同じように、要求されたメッセージ データを取得し、要求に対して対応する応答を生成します。  
+  
+ 特に、この場合、正しくコンパイルされていることを確認するためにブラウザーからサービスを参照できるように、カスタム HTML メッセージを返して HTTP\-GET 動詞を処理します。SOAP アクションが一致しない場合は、エラー メッセージを返信して、要求がサポートされていないことを示します。  
+  
+ このサンプルのクライアントは、サービスから何も引き受けない標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントです。そのため、サービスは、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]<xref:System.ServiceModel.ServiceHost> 実装から取得した内容と一致するように特別に設計されています。したがって、クライアントに必要なのはサービス コントラクトだけです。  
+  
+## サンプルの使用  
+ クライアント アプリケーションを直接実行すると、次の出力が生成されます。  
+  
+```Output  
+クライアントは要求/応答 WCF サービスと通信しています。  
+サーバーに送信する内容を入力してください: Howdy  
+サーバーからの応答: 送信内容: Howdy。メッセージ ID: 1  
+サーバーからの応答: 送信内容: Howdy。メッセージ ID: 2  
+サーバーからの応答: 送信内容: Howdy。メッセージ ID: 3  
+サーバーからの応答: 送信内容: Howdy。メッセージ ID: 4  
+サーバーからの応答: 送信内容: Howdy。メッセージ ID: 5  
+  
+```  
+  
+ HTTP\-GET メッセージがサーバーで処理されるように、ブラウザーからサービスを参照することもできます。この場合、適切に書式設定された HTML テキストが返信されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\CustomChannelDispatcher`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-demux.md b/docs/framework/wcf/samples/custom-demux.md
new file mode 100644
index 00000000000..9f5aa3c40d2
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-demux.md
@@ -0,0 +1,206 @@
+---
+title: "カスタム Demux | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc54065c-518e-4146-b24a-0fe00038bfa7
+caps.latest.revision: 41
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 41
+---
+# カスタム Demux
+このサンプルでは、MSMQ メッセージ ヘッダーをさまざまなサービス操作にマッピングする方法を通して、<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスで複数のサービス操作を使用できることを示します \(「[Windows Communication Foundation へのメッセージ キュー](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)」と「[Windows Communication Foundation でのメッセージ キュー](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)」のサンプルでは 1 つだけ使用しています\)。  
+  
+ このサンプルのサービスは自己ホスト型コンソール アプリケーションであるので、サービスを実行すると、キューに置かれたメッセージを受信するようすを観察できます。  
+  
+ サービス コントラクトは `IOrderProcessor` です。これは、キューでの使用に適した一方向サービスを定義します。  
+  
+```  
+[ServiceContract]  
+[KnownType(typeof(PurchaseOrder))]  
+[KnownType(typeof(String))]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true, Name = "SubmitPurchaseOrder")]  
+    void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg);  
+  
+    [OperationContract(IsOneWay = true, Name = "CancelPurchaseOrder")]  
+    void CancelPurchaseOrder(MsmqMessage<string> ponumber);  
+}  
+```  
+  
+ MSMQ メッセージには Action ヘッダーがないので、  さまざまな MSMQ メッセージを操作コントラクトに自動的にマッピングすることはできません。  したがって、存在する操作コントラクトは 1 つだけです。  この制限を克服するために、サービスは <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> インターフェイスの <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector.SelectOperation%2A> メソッドを実装します。  <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector.SelectOperation%2A> メソッドによって、メッセージの特定のヘッダーを特定のサービス操作にマッピングできるようになります。  このサンプルでは、メッセージのラベル ヘッダーをサービス操作にマッピングします。  操作コントラクトの `Name` パラメータは、特定のメッセージ ラベルに対してどのサービス操作をディスパッチするかを示します。  たとえば、メッセージのラベル ヘッダーに "SubmitPurchaseOrder" が含まれている場合に、"SubmitPurchaseOrder" サービス操作を呼び出します。  
+  
+```  
+public class OperationSelector : IDispatchOperationSelector  
+{  
+    public string SelectOperation(ref System.ServiceModel.Channels.Message message)  
+    {  
+        MsmqIntegrationMessageProperty property = MsmqIntegrationMessageProperty.Get(message);  
+        return property.Label;  
+    }  
+}  
+```  
+  
+ サービスは <xref:System.ServiceModel.Description.IContractBehavior> インターフェイスの <xref:System.ServiceModel.Description.IContractBehavior.ApplyDispatchBehavior%28System.ServiceModel.Description.ContractDescription%2CSystem.ServiceModel.Description.ServiceEndpoint%2CSystem.ServiceModel.Dispatcher.DispatchRuntime%29> メソッドを実装する必要があります。次のサンプル コードを参照してください。  これによって、カスタムの `OperationSelector` がサービス フレームワークのディスパッチ ランタイムに適用されます。  
+  
+```  
+void IContractBehavior.ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, DispatchRuntime dispatch)  
+{  
+    dispatch.OperationSelector = new OperationSelector();  
+}  
+```  
+  
+ メッセージが OperationSelector に到達するには、ディスパッチャの <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter%2A> を通過する必要があります。  既定の設定では、メッセージのアクションが、サービスによって実装されているどのコントラクトにも見つからない場合に、メッセージが拒否されます。  この検査を回避するために、`MatchAllFilterBehavior` という名前の <xref:System.ServiceModel.Description.IEndpointBehavior> を実装します。これは、次に示すように <xref:System.ServiceModel.Dispatcher.MatchAllMessageFilter> を適用して、どのメッセージも `ContractFilter` を通過できるようにするものです。  
+  
+```  
+public void ApplyDispatchBehavior(ServiceEndpoint serviceEndpoint, EndpointDispatcher endpointDispatcher)  
+{  
+    endpointDispatcher.ContractFilter = new MatchAllMessageFilter();  
+}  
+```  
+  
+ メッセージをサービスが受信すると、ラベル ヘッダーからの情報を使用して該当するサービス操作がディスパッチされます。  メッセージの本文が逆シリアル化されて `PurchaseOrder` オブジェクトが作成されます。次のサンプル コードを参照してください。  
+  
+```  
+[OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+public void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg)  
+{  
+    PurchaseOrder po = (PurchaseOrder)msg.Body;  
+    Random statusIndexer = new Random();  
+    po.Status = (OrderStates)statusIndexer.Next(3);  
+    Console.WriteLine("Processing {0} ", po);  
+}  
+```  
+  
+ サービスは自己ホスト型です。  MSMQ を使用するときは、使用するキューをあらかじめ作成しておく必要があります。  手動で作成することもコードで作成することもできます。  このサンプルでは、サービスのコードの中でキューの存在を確認し、存在しない場合は作成します。  キュー名は構成ファイルから読み込まれます。  
+  
+```  
+public static void Main()  
+{  
+    // Get MSMQ queue name from app settings in configuration  
+    string queueName = ConfigurationManager.AppSettings["orderQueueName"];  
+  
+    // Create the transacted MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName, true);  
+  
+    // Create a ServiceHost for the CalculatorService type.  
+    using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))  
+    {                 
+        ServiceEndpoint endpoint = serviceHost.Description.Endpoints[0];  
+        endpoint.Behaviors.Add(new MatchAllFilterBehavior());  
+  
+        //Open the ServiceHost to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.ReadLine();  
+  
+        // Close the ServiceHost to shutdown the service.  
+        serviceHost.Close();  
+    }  
+}  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションで指定されます。  
+  
+> [!NOTE]
+>  キュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイント アドレスでは msmq.formatname スキームが指定され、ローカル コンピューターを表す localhost が使用されます。  このスキームの後には、MSMQ 形式名のアドレス指定ガイドラインに沿って正しく書式設定されたキューのアドレスが続きます。  
+  
+```  
+<appSettings>  
+    <!-- Use appSetting to configure the MSMQ queue name. -->  
+    <add key="queueName" value=".\private$\Orders" />  
+</appSettings>  
+  
+```  
+  
+> [!NOTE]
+>  このサンプルを実行するには、[メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=95143)がインストールされている必要があります。  
+  
+ サービスを開始してクライアントを実行します。  
+  
+ クライアントには、次の出力が表示されます。  
+  
+```  
+Placed the order:Purchase Order: 28fc457a-1a56-4fe0-9dde-156965c21ed6  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+Canceled the Order: 28fc457a-1a56-4fe0-9dde-156965c21ed6  
+Press <ENTER> to terminate client.  
+```  
+  
+ サービスには、次の出力が表示されます。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+Processing Purchase Order: 28fc457a-1a56-4fe0-9dde-156965c21ed6  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Shipped  
+Purchase Order 28fc457a-1a56-4fe0-9dde-156965c21ed6 is canceled  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。  キューが存在しない場合、サービスによってキューが作成されます。  最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。  Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、`「ServiceModelSamplesTransacted」`と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービスのプログラム ファイルを、言語固有のフォルダーにある \\service\\bin\\ フォルダーからサービス コンピューターにコピーします。  
+  
+2.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+3.  Client.exe.config ファイルを開き、orderQueueName を変更して "." の代わりにサービス コンピューター名を指定します。  
+  
+4.  サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+5.  クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\MSMQIntegration\CustomDemux`  
+  
+## 参照  
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=95143)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-find-criteria.md b/docs/framework/wcf/samples/custom-find-criteria.md
new file mode 100644
index 00000000000..10fc7859ba0
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-find-criteria.md
@@ -0,0 +1,78 @@
+---
+title: "カスタム検索基準 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2723929-8829-424d-8015-a37ba2ab4f68
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# カスタム検索基準
+このサンプルでは、ロジックを使用するカスタム スコープ一致の作成方法とカスタム探索サービスの実装方法を示します。クライアントは、カスタム スコープ一致機能を使用して、システムによって提供される WCF Discovery の検索機能を改良および拡張します。このサンプルでは次のシナリオを扱います。  
+  
+1.  クライアントは電卓サービスを検索します。  
+  
+2.  検索を絞り込むために、クライアントはカスタム スコープ一致ルールを使用する必要があります。  
+  
+3.  このルールに従って、サービスは、エンドポイントがクライアントによって指定されたスコープのいずれかと一致した場合、クライアントに応答を送り返します。  
+  
+## 使用例  
+  
+-   カスタム探索サービスの作成。  
+  
+-   アルゴリズムに基づくカスタム スコープ一致の実装  
+  
+## 説明  
+ クライアントは "OR" 一致条件を検索します。サービスは、エンドポイントのスコープがクライアントによって指定されたスコープのいずれかと一致した場合、応答を送り返します。この場合、クライアントは、次のいずれかのスコープを含む電卓サービスを検索します。  
+  
+1.  `net.tcp://Microsoft.Samples.Discovery/RedmondLocation`  
+  
+2.  `net.tcp://Microsoft.Samples.Discovery/SeattleLocation`  
+  
+3.  `net.tcp://Microsoft.Samples.Discovery/PortlandLocation`  
+  
+ これを行うために、クライアントはカスタム スコープ一致を URI で渡すことで、カスタム スコープ一致を使用するようにサービスに指示します。サービスは、カスタム スコープ一致を容易にするために、カスタム スコープ一致ルールを理解し、関連する一致ロジックを実装するカスタム探索サービスを使用する必要があります。  
+  
+ クライアント プロジェクトで Program.cs ファイルを開きます。`FindCriteria` オブジェクトの `ScopeMatchBy` フィールドが特定の URI に設定されていることに注意してください。この識別子はサービスに送信されます。サービスがこのルールを理解できない場合、クライアントの検索要求は無視されます。  
+  
+ サービス プロジェクトを開きます。カスタム探索サービスの実装には、次の 3 つのファイルを使用します。  
+  
+1.  **AsyncResult.cs**: これは Discovery メソッドに必要な `AsyncResult` の実装です。  
+  
+2.  **CustomDiscoveryService.cs**: このファイルはカスタム探索サービスを実装します。この実装では、<xref:System.ServiceModel.Discovery.DiscoveryService> クラスを拡張し、必要なメソッドをオーバーライドします。<xref:System.ServiceModel.Discovery.DiscoveryService.OnBeginFind%2A> メソッドの実装に注意してください。このメソッドは、ルールに基づくカスタム スコープ一致がクライアントによって指定されているかどうかをチェックします。これはクライアントが前に指定したカスタム URI です。カスタム ルールが指定されている場合は、その後に "OR" 一致ロジックを実装するコード パスが続きます。  
+  
+     このカスタム ロジックでは、サービスに含まれている各エンドポイントのスコープがすべてチェックされます。エンドポイントのスコープのいずれかがクライアントによって指定されたスコープのいずれかに一致した場合、探索サービスはクライアントに送り返す応答にそのエンドポイントを追加します。  
+  
+3.  **CustomDiscoveryExtension.cs**: 探索サービスの実装の最後の手順は、このカスタム探索サービスの実装をサービス ホストに関連付けることです。ここで使用するヘルパー クラスは `CustomDiscoveryExtension` クラスです。このクラスは <xref:System.ServiceModel.Discovery.DiscoveryServiceExtension> クラスを拡張します。ユーザーは <xref:System.ServiceModel.Discovery.DiscoveryServiceExtension.GetDiscoveryService%2A> メソッドをオーバーライドする必要があります。この場合、このメソッドは、前に作成されたカスタム探索サービスのインスタンスを返します。`PublishedEndpoints` は、<xref:System.ServiceModel.ServiceHost> に追加されたすべてのアプリケーション エンドポイントを含む <xref:System.Collections.ObjectModel.ReadOnlyCollection> です。カスタム探索サービスは、これを使用して内部リストを設定します。ユーザーは、その他のエンドポイント メタデータも追加できます。  
+  
+ 最後に、Program.cs を開きます。<xref:System.ServiceModel.Discovery.ServiceDiscoveryBehavior> と `CustomDiscoveryExtension` の両方がホストに追加されていることに注意してください。これが完了し、探索メッセージの受信に使用されるエンドポイントがホストに追加されると、アプリケーションがカスタム探索サービスを使用できるようになります。  
+  
+ クライアントがサービスのアドレスを知ることなくサービスを検索できることを確認します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  プロジェクトを含むソリューションを開きます。  
+  
+2.  プロジェクトをビルドします。  
+  
+3.  サービス アプリケーションを実行します。  
+  
+4.  クライアント アプリケーションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\CustomFindCriteria`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-lifetime.md b/docs/framework/wcf/samples/custom-lifetime.md
new file mode 100644
index 00000000000..8943d44fe85
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-lifetime.md
@@ -0,0 +1,240 @@
+---
+title: "カスタム有効期間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52806c07-b91c-48fe-b992-88a41924f51f
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# カスタム有効期間
+このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の共有サービス インスタンスにカスタムの有効期間サービスを提供する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 拡張機能の作成方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## 共有インスタンス化  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、サービス インスタンス用にいくつかのインスタンス化モードが用意されています。このトピックで説明する共有インスタンス化モードでは、サービス インスタンスを複数のチャネルで共有できます。クライアントは、インスタンスのエンドポイント アドレスをローカルで解決するか、サービスのファクトリ メソッドと通信して実行中のインスタンスのエンドポイント アドレスを取得することができます。エンドポイント アドレスを取得したら、新しいチャネルを作成して通信を開始することができます。次のコード例は、クライアント アプリケーションが既存のサービス インスタンスへの新しいチャネルを作成する方法を示しています。  
+  
+```  
+// Create the first channel.  
+IEchoService proxy = channelFactory.CreateChannel();  
+  
+// Resolve the instance.  
+EndpointAddress epa = ((IClientChannel)proxy).ResolveInstance();  
+  
+// Create new channel factory with the endpoint address resolved by   
+// previous statement.  
+ChannelFactory<IEchoService> channelFactory2 =  
+                new ChannelFactory<IEchoService>("echoservice",  
+                epa);  
+  
+// Create the second channel to the same instance.  
+IEchoService proxy2 = channelFactory2.CreateChannel();  
+  
+```  
+  
+ 他のインスタンス化モードとは異なり、共有インスタンス化モードでは、独特の方法でサービス インスタンスを解放します。インスタンスのすべてのチャネルが閉じると、サービスの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムによってタイマーが開始されます。タイムアウトになるまでに誰も接続しなかった場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] はインスタンスを解放してリソースを要求します。切り離し手順の一環として、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、インスタンスを解放する前にすべての <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装の <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドを呼び出します。そのすべてが `true` を返す場合は、インスタンスが解放されます。それ以外の場合、<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装は、コールバック メソッドを使用してアイドル状態であることを`Dispatcher`に通知します。  
+  
+ 既定では、<xref:System.ServiceModel.InstanceContext> のアイドル タイムアウト値は 1 分です。ただし、このサンプルでは、カスタム拡張機能を使用してこれを延長する方法を示します。  
+  
+## InstanceContext の拡張  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の <xref:System.ServiceModel.InstanceContext> は、サービス インスタンスと`Dispatcher`の間のリンクです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、拡張可能オブジェクト パターンを使用して新しい状態または動作を追加することで、このランタイム コンポーネントを拡張できます。拡張可能オブジェクト パターンは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、既存のランタイム クラスに新しい機能を付け加えて拡張するため、またはオブジェクトに新しい状態の機能を追加するために使用されます。拡張可能オブジェクト パターンには、`IExtensibleObject<T>`、`IExtension<T>`、および `IExtensionCollection<T>` の 3 つのインターフェイスがあります。  
+  
+ `IExtensibleObject<T>` インターフェイスは、機能をカスタマイズするための拡張が可能なオブジェクトによって実装されます。  
+  
+ `IExtension<T>` インターフェイスは、`T` 型のクラスの拡張が可能なオブジェクトによって実装されます。  
+  
+ 最後に、`IExtensionCollection<T>` インターフェイスは `IExtensions` のコレクションで、型ごとに `IExtensions` を取得できます。  
+  
+ したがって、<xref:System.ServiceModel.InstanceContext> を拡張するには、`IExtension` インターフェイスを実装する必要があります。このサンプル プロジェクトでは、`CustomLeaseExtension` クラスにこの実装が含まれています。  
+  
+```  
+class CustomLeaseExtension : IExtension<InstanceContext>  
+{  
+}  
+  
+```  
+  
+ `IExtension` インターフェイスには、`Attach` と `Detach` の 2 つのメソッドが含まれています。名前が示すように、これらの 2 つのメソッドは、ランタイムが <xref:System.ServiceModel.InstanceContext> クラスのインスタンスに拡張機能を関連付けるときと関連付けを解除するときに呼び出されます。このサンプルでは、`Attach` メソッドを使用して、拡張機能の現在のインスタンスに属する <xref:System.ServiceModel.InstanceContext> オブジェクトを追跡します。  
+  
+```  
+InstanceContext owner;  
+  
+public void Attach(InstanceContext owner)  
+{  
+  this.owner = owner;   
+}  
+```  
+  
+ また、有効期間の延長をサポートするには、必要な実装を拡張機能に追加する必要があります。したがって、`ICustomLease` インターフェイスを目的のメソッドで宣言し、`CustomLeaseExtension` クラスに実装します。  
+  
+```  
+interface ICustomLease  
+{  
+    bool IsIdle { get; }          
+    InstanceContextIdleCallback Callback { get; set; }  
+}  
+  
+class CustomLeaseExtension : IExtension<InstanceContext>, ICustomLease  
+{  
+}  
+  
+```  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装で <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドを呼び出すと、この呼び出しは `CustomLeaseExtension` の <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドにルーティングされます。次に、`CustomLeaseExtension` はそのプライベート状態をチェックし、<xref:System.ServiceModel.InstanceContext> がアイドル状態かどうかを確認します。アイドル状態の場合は、`true` を返します。それ以外の場合は、延長された指定の有効期間のタイマーが開始されます。  
+  
+```  
+public bool IsIdle  
+{  
+  get  
+  {  
+    lock (thisLock)  
+    {  
+      if (isIdle)  
+      {  
+        return true;  
+      }  
+      else  
+      {  
+        StartTimer();  
+        return false;  
+      }  
+    }  
+  }  
+}  
+  
+```  
+  
+ タイマーの `Elapsed` イベントで、別のクリーンアップ サイクルを開始するためにディスパッチャーのコールバック関数が呼び出されます。  
+  
+```  
+void idleTimer_Elapsed(object sender, ElapsedEventArgs args)  
+{  
+    idleTimer.Stop();  
+    isIdle = true;    
+    callback(owner);  
+}  
+  
+```  
+  
+ アイドル状態に移行中のインスタンスに新しいメッセージが届いたときに、実行中のタイマーを更新する方法はありません。  
+  
+ このサンプルでは、<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドの呼び出しを受け取って `CustomLeaseExtension` にルーティングするために <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> を実装します。<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装は、`CustomLifetimeLease` クラスに含まれています。<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] がサービス インスタンスを解放するときに呼び出されます。ただし、ServiceBehavior の <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceContextLifetimes%2A> コレクションに存在する特定の `ISharedSessionInstance` 実装のインスタンスは 1 つだけです。つまり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドをチェックする時点で閉じられている <xref:System.ServiceModel.InstanceContext> を知る方法はありません。したがって、このサンプルでは、スレッド ロックを使用して <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.IsIdle%2A> メソッドへの要求をシリアル化します。  
+  
+> [!IMPORTANT]
+>  シリアル化はアプリケーションのパフォーマンスに大きな影響を及ぼす可能性があるので、スレッド ロックは使用しないことをお勧めします。  
+  
+ `CustomLeaseExtension` クラスでプライベート メンバー変数を使用して、`IsIdle` の値を追跡します。<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> の値が取得されるたびに、`IsIdle` プライベート メンバーが返されて `false` にリセットされます。ディスパッチャーが <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime.NotifyIdle%2A> メソッドを呼び出すようにするには、この値を `false` に設定する必要があります。  
+  
+```  
+public bool IsIdle  
+{  
+    get   
+    {  
+       lock (thisLock)  
+       {  
+           bool idleCopy = isIdle;  
+           isIdle = false;  
+           return idleCopy;  
+       }  
+    }  
+}  
+  
+```  
+  
+ `ISharedSessionLifetime.IsIdle` プロパティが `false` を返す場合、ディスパッチャーは `NotifyIdle` メソッドを使用してコールバック関数を登録します。このメソッドは、解放される <xref:System.ServiceModel.InstanceContext> への参照を受け取ります。したがって、このサンプル コードでは、`ICustomLease` 型拡張に対してクエリを実行し、拡張状態の `ICustomLease.IsIdle` プロパティをチェックすることができます。  
+  
+```  
+public void NotifyIdle(InstanceContextIdleCallback callback,   
+            InstanceContext instanceContext)  
+{  
+    lock (thisLock)  
+    {  
+       ICustomLease customLease =  
+           instanceContext.Extensions.Find<ICustomLease>();  
+       customLease.Callback = callback;   
+       isIdle = customLease.IsIdle;  
+       if (isIdle)  
+       {  
+             callback(instanceContext);  
+       }  
+    }   
+}  
+  
+```  
+  
+ `ICustomLease.IsIdle` プロパティをチェックする前に、Callback プロパティを設定する必要があります。これは、アイドル状態になったときに `CustomLeaseExtension` がディスパッチャーに通知するために不可欠です。`ICustomLease.IsIdle` が `true` を返す場合は、`isIdle` プライベート メンバーが `CustomLifetimeLease` で単に `true` に設定され、コールバック メソッドが呼び出されます。このコードではロックが使用されているので、他のスレッドではこのプライベート メンバーの値を変更できません。次にディスパッチャーが `ISharedSessionLifetime.IsIdle` をチェックするときに `true` が返されて、ディスパッチャーがインスタンスを解放できるようになります。  
+  
+ これでカスタム拡張機能の基礎が完成したので、この拡張機能をサービス モデルにフックする必要があります。`CustomLeaseExtension` 実装を <xref:System.ServiceModel.InstanceContext> にフックするために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、<xref:System.ServiceModel.InstanceContext> のブートストラップを実行する <xref:System.ServiceModel.Dispatcher.IInstanceContextInitializer> インターフェイスが用意されています。このサンプルでは、`CustomLeaseInitializer` クラスでこのインターフェイスを実装し、`CustomLeaseExtension` のインスタンスを唯一のメソッドの初期化から得られる <xref:System.ServiceModel.InstanceContext.Extensions%2A> コレクションに追加します。このメソッドは、<xref:System.ServiceModel.InstanceContext> の初期化中にディスパッチャーによって呼び出されます。  
+  
+```  
+public void Initialize(InstanceContext instanceContext, Message message)  
+{  
+  IExtension<InstanceContext> customLeaseExtension =  
+    new CustomLeaseExtension(timeout);  
+  instanceContext.Extensions.Add(customLeaseExtension);  
+}  
+```  
+  
+ 最後に、<xref:System.ServiceModel.Description.IServiceBehavior> 実装を使用して、<xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装と <xref:System.ServiceModel.Dispatcher.IInstanceContextInitializer> 実装がサービス モデルにフックされます。この実装は、`CustomLeaseTimeAttribute` クラスに配置されています。また、`Attribute` 基本クラスから派生してこの動作を属性として公開します。`IServiceBehavior.ApplyBehavior` メソッドで、<xref:System.ServiceModel.Dispatcher.IInstanceContextInitializer> 実装と <xref:System.ServiceModel.Dispatcher.IShareableInstanceContextLifetime> 実装のインスタンスがそれぞれ <xref:System.ServiceModel.Dispatcher> の <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceContextLifetimes%2A> コレクションと <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceContextInitializers%2A> コレクションに追加されます。  
+  
+```  
+public void ApplyBehavior(ServiceDescription description,   
+           ServiceHostBase serviceHostBase,   
+           Collection<DispatchBehavior> behaviors,  
+           Collection<BindingParameterCollection> parameters)  
+{  
+    CustomLifetimeLease customLease = new CustomLifetimeLease();  
+    CustomLeaseInitializer initializer =   
+                new CustomLeaseInitializer(timeout);  
+  
+    foreach (DispatchBehavior dispatchBehavior in behaviors)  
+    {  
+        dispatchBehavior.InstanceContextLifetimes.Add(customLease);  
+        dispatchBehavior.InstanceContextInitializers.Add(initializer);  
+    }  
+}  
+  
+```  
+  
+ この動作は、`CustomLeaseTime` 属性を使用して注釈を付けることにより、サンプル サービス クラスに追加できます。  
+  
+```  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.Shareable)]  
+[CustomLeaseTime(Timeout = 20000)]  
+public class EchoService : IEchoService  
+{  
+  //…  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Instancing\Lifetime`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-message-encoder-compression-encoder.md b/docs/framework/wcf/samples/custom-message-encoder-compression-encoder.md
new file mode 100644
index 00000000000..fe39c1598f1
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-message-encoder-compression-encoder.md
@@ -0,0 +1,376 @@
+---
+title: "カスタム メッセージ エンコーダー : 圧縮エンコーダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57450b6c-89fe-4b8a-8376-3d794857bfd7
+caps.latest.revision: 37
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 37
+---
+# カスタム メッセージ エンコーダー : 圧縮エンコーダー
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] プラットフォームを使用するカスタム エンコーダーを実装する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\MessageEncoder\Compression`  
+  
+## サンプルの詳細  
+ このサンプルは、クライアント コンソール プログラム \(.exe\)、自己ホスト型サービス コンソール プログラム \(.exe\)、および圧縮メッセージ エンコーダー ライブラリ \(.dll\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。コントラクトは `ISampleServer` インターフェイスによって定義されます。このインターフェイスでは、基本的な文字列のエコー操作 \(`Echo` と `BigEcho`\) が公開されます。クライアントは指定された操作を同期要求し、サービスはクライアントにメッセージをそのまま戻すことによって応答します。クライアント アクティビティとサービス アクティビティは、コンソール ウィンドウに表示されます。このサンプルの目的は、カスタム エンコーダを記述する方法と、ネットワーク上でメッセージを圧縮したときの影響を示すことです。圧縮メッセージ エンコーダーにインストルメンテーションを追加すると、メッセージのサイズ、処理時間、またはその両方を計算することができます。  
+  
+> [!NOTE]
+>  .NET Framework 4 では、サーバーが \(GZip や Deflate などのアルゴリズムで作成された\) 圧縮された応答を送信する場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントで自動展開が有効になっています。このサービスがインターネット インフォメーション サービス \(IIS\) で Web ホストされる場合は、サービスが圧縮された応答を送信するように IIS を構成することができます。このサンプルは、クライアントとサービスの両方で圧縮および展開を行うという要件がある場合、またはサービスが自己ホスト型である場合に使用できます。  
+  
+ サンプルでは、カスタム メッセージ エンコーダーをビルドして、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションに統合する方法を示します。GZipEncoder.dll ライブラリは、クライアントとサービスの両方で配置されます。また、このサンプルではメッセージを圧縮したときの影響も示します。GZipEncoder.dll のコードでは、次が示されます。  
+  
+-   カスタム エンコーダおよびエンコーダ ファクトリの作成。  
+  
+-   カスタム エンコーダのバインディング要素の開発。  
+  
+-   カスタム バインディング要素を統合するためのカスタム バインディング構成の使用。  
+  
+-   カスタム バインディング要素のファイル構成を可能にするカスタム構成ハンドラの開発。  
+  
+ 前に示したように、カスタム エンコーダにはいくつかのレイヤが実装されています。こうした各レイヤ間の関係をわかりやすく説明するために、サービス起動のイベントの順序を簡略化した一覧を次に示します。  
+  
+1.  サーバーが起動します。  
+  
+2.  構成情報が読み取られます。  
+  
+    1.  サービス構成がカスタム構成ハンドラを登録します。  
+  
+    2.  サービス ホストが作成されて開かれます。  
+  
+    3.  カスタム構成要素がカスタム バインディング要素を作成して返します。  
+  
+    4.  カスタム バインディング要素がメッセージ エンコーダ ファクトリを作成して返します。  
+  
+3.  メッセージが受信されます。  
+  
+4.  メッセージ エンコーダ ファクトリは、メッセージを読み込んで応答を出力するためのメッセージ エンコーダを返します。  
+  
+5.  エンコーダ レイヤはクラス ファクトリとして実装されます。カスタム エンコーダ用にパブリックに公開する必要があるのはエンコーダのクラス ファクトリだけです。<xref:System.ServiceModel.ServiceHost> オブジェクトまたは <xref:System.ServiceModel.ChannelFactory%601> オブジェクトが作成されると、ファクトリ オブジェクトがバインディング要素によって返されます。メッセージ エンコーダは、バッファ モードまたはストリーミング モードで動作できます。このサンプルでは、バッファ モードとストリーミング モードの両方を示します。  
+  
+ 各モードの `MessageEncoder` 抽象クラスには、関連する `ReadMessage` メソッドと `WriteMessage` メソッドがあります。エンコード処理の大部分はこれらのメソッドで行われます。サンプルでは、既存のテキスト エンコーダとバイナリ メッセージ エンコーダをラップします。これにより、内部のエンコーダがネットワーク上でのメッセージの表現の読み取りと書き込みを代行し、圧縮エンコーダがその結果を圧縮または解凍できます。メッセージ エンコード用にはパイプラインがないので、これは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で複数のエンコーダを使用する唯一のモデルです。メッセージが解凍されると、結果として得られたメッセージは、処理対象のチャネル スタックの上にスタックとして渡されます。圧縮中は、結果として得られる圧縮メッセージは指定されたストリームに直接書き込まれます。  
+  
+ このサンプルは、ヘルパー メソッド \(`CompressBuffer` と `DecompressBuffer`\) を使用して、バッファを、`GZipStream` クラスを使用するストリームに変換します。  
+  
+ バッファ内の `ReadMessage` クラスと `WriteMessage` クラスは、`BufferManager` クラスを使用します。エンコーダにはエンコーダ ファクトリを通じてのみアクセスできます。`MessageEncoderFactory` 抽象クラスは、現在のエンコーダにアクセスするための `Encoder` という名前のプロパティと、セッションをサポートするエンコーダを作成するための `CreateSessionEncoder` という名前のメソッドを提供します。チャネルがセッションをサポートし、順序付けされて信頼できるシナリオでは、このようなエンコーダを使用できます。このシナリオでは、ネットワークに書き込まれるデータの各セッションを最適化できます。これが必要でない場合は、基本メソッドをオーバーロードしないでください。`Encoder` プロパティは、セッションのないエンコーダにアクセスする機構を備えており、`CreateSessionEncoder` メソッドの既定の実装では、このプロパティの値が返されます。サンプルでは既存のエンコーダをラップして圧縮を行うので、`MessageEncoderFactory` の実装では、内部のエンコーダ ファクトリを表す `MessageEncoderFactory` が受け入れられます。  
+  
+ エンコーダおよびエンコーダ ファクトリが定義されたら、これを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントとサービスで使用できるようになります。ただし、これらのエンコーダをチャネル スタックに追加する必要があります。<xref:System.ServiceModel.ServiceHost> クラスと <xref:System.ServiceModel.ChannelFactory%601> クラスの派生クラスを作成して `OnInitialize` メソッドをオーバーライドすると、このエンコーダ ファクトリを手動で追加することができます。また、カスタム バインディング要素を介してエンコーダ ファクトリを公開することもできます。  
+  
+ 新しいカスタム バインディング要素を作成するには、<xref:System.ServiceModel.Channels.BindingElement> クラスの派生クラスを作成します。ただし、バインディング要素には複数の型があります。カスタム バインディング要素がメッセージ エンコード バインディング要素として認識されるには、さらに <xref:System.ServiceModel.Channels.MessageEncodingBindingElement> も実装する必要があります。<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> は、新しいメッセージ エンコーダ ファクトリ \(`CreateMessageEncoderFactory`\) を作成するためのメソッドを公開します。このメソッドを実装すると、一致するメッセージ エンコーダ ファクトリのインスタンスが返されます。また、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> にはアドレス バージョンを示すプロパティがあります。このサンプルでは既存のエンコーダをラップするので、サンプルの実装では既存のエンコーダ バインディング要素もラップし、内部のエンコーダ バインディング要素をコンストラクタへのパラメータとして設定して、プロパティを介して公開します。`GZipMessageEncodingBindingElement` クラスを実装する方法を次のサンプル コードに示します。  
+  
+```  
+public sealed class GZipMessageEncodingBindingElement   
+                        : MessageEncodingBindingElement //BindingElement  
+                        , IPolicyExportExtension  
+{  
+  
+    //We use an inner binding element to store information   
+    //required for the inner encoder.  
+    MessageEncodingBindingElement innerBindingElement;  
+  
+        //By default, use the default text encoder as the inner encoder.  
+        public GZipMessageEncodingBindingElement()  
+            : this(new TextMessageEncodingBindingElement()) { }  
+  
+    public GZipMessageEncodingBindingElement(MessageEncodingBindingElement messageEncoderBindingElement)  
+    {  
+        this.innerBindingElement = messageEncoderBindingElement;  
+    }  
+  
+    public MessageEncodingBindingElement InnerMessageEncodingBindingElement  
+    {  
+        get { return innerBindingElement; }  
+        set { innerBindingElement = value; }  
+    }  
+  
+    //Main entry point into the encoder binding element.   
+    // Called by WCF to get the factory that creates the  
+    //message encoder.  
+    public override MessageEncoderFactory CreateMessageEncoderFactory()  
+    {  
+        return new   
+GZipMessageEncoderFactory(innerBindingElement.CreateMessageEncoderFactory());  
+    }  
+  
+    public override MessageVersion MessageVersion  
+    {  
+        get { return innerBindingElement.MessageVersion; }  
+        set { innerBindingElement.MessageVersion = value; }  
+    }  
+  
+    public override BindingElement Clone()  
+    {  
+        return new   
+        GZipMessageEncodingBindingElement(this.innerBindingElement);  
+    }  
+  
+    public override T GetProperty<T>(BindingContext context)  
+    {  
+        if (typeof(T) == typeof(XmlDictionaryReaderQuotas))  
+        {  
+            return innerBindingElement.GetProperty<T>(context);  
+        }  
+        else   
+        {  
+            return base.GetProperty<T>(context);  
+        }  
+    }  
+  
+    public override IChannelFactory<TChannel> BuildChannelFactory<TChannel>(BindingContext context)  
+    {  
+        if (context == null)  
+            throw new ArgumentNullException("context");  
+  
+        context.BindingParameters.Add(this);  
+        return context.BuildInnerChannelFactory<TChannel>();  
+    }  
+  
+    public override IChannelListener<TChannel> BuildChannelListener<TChannel>(BindingContext context)  
+    {  
+        if (context == null)  
+            throw new ArgumentNullException("context");  
+  
+        context.BindingParameters.Add(this);  
+        return context.BuildInnerChannelListener<TChannel>();  
+    }  
+  
+    public override bool CanBuildChannelListener<TChannel>(BindingContext context)  
+    {  
+        if (context == null)  
+            throw new ArgumentNullException("context");  
+  
+        context.BindingParameters.Add(this);  
+        return context.CanBuildInnerChannelListener<TChannel>();  
+    }  
+  
+    void IPolicyExportExtension.ExportPolicy(MetadataExporter exporter, PolicyConversionContext policyContext)  
+    {  
+        if (policyContext == null)  
+        {  
+            throw new ArgumentNullException("policyContext");  
+        }  
+       XmlDocument document = new XmlDocument();  
+       policyContext.GetBindingAssertions().Add(document.CreateElement(  
+            GZipMessageEncodingPolicyConstants.GZipEncodingPrefix,  
+            GZipMessageEncodingPolicyConstants.GZipEncodingName,  
+            GZipMessageEncodingPolicyConstants.GZipEncodingNamespace));  
+    }  
+}  
+```  
+  
+ `GZipMessageEncodingBindingElement` クラスは `IPolicyExportExtension` インターフェイスを実装しているので、次の例に示すように、このバインディング要素はメタデータ内のポリシーとしてエクスポートできます。  
+  
+```  
+<wsp:Policy wsu:Id="BufferedHttpSampleServer_ISampleServer_policy">  
+    <wsp:ExactlyOne>  
+      <wsp:All>  
+        <gzip:text xmlns:gzip=  
+        "http://schemas.microsoft.com/ws/06/2004/mspolicy/netgzip1" />   
+       <wsaw:UsingAddressing />   
+     </wsp:All>  
+   </wsp:ExactlyOne>  
+</wsp:Policy>  
+  
+```  
+  
+ `GZipMessageEncodingBindingElementImporter` クラスは `IPolicyImportExtension` インターフェイスを実装しています。このクラスは `GZipMessageEncodingBindingElement` のポリシーをインポートします。Svcutil.exe ツールを使用すると、ポリシーを構成ファイルにインポートして `GZipMessageEncodingBindingElement` を処理できます。これを行うには、Svcutil.exe.config に次のコードを追加する必要があります。  
+  
+```  
+  
+<configuration>  
+  <system.serviceModel>  
+    <extensions>  
+      <bindingElementExtensions>  
+        <add name="gzipMessageEncoding"   
+          type=  
+            "Microsoft.ServiceModel.Samples.GZipMessageEncodingElement, GZipEncoder, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+      </bindingElementExtensions>  
+    </extensions>  
+    <client>  
+      <metadata>  
+        <policyImporters>  
+          <remove type=  
+"System.ServiceModel.Channels.MessageEncodingBindingElementImporter, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+          <extension type=  
+"Microsoft.ServiceModel.Samples.GZipMessageEncodingBindingElementImporter, GZipEncoder, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+        </policyImporters>  
+      </metadata>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ これで、一致する圧縮エンコーダのバインディング要素ができるので、新しいカスタム バインディング オブジェクトを作成してそのカスタム バインディング要素を追加すると、プログラムによって圧縮エンコーダのバインディング要素をサービスまたはクライアントにフックできます。次のサンプル コードを参照してください。  
+  
+```  
+ICollection<BindingElement> bindingElements = new List<BindingElement>();  
+HttpTransportBindingElement httpBindingElement = new HttpTransportBindingElement();  
+GZipMessageEncodingBindingElement compBindingElement = new GZipMessageEncodingBindingElement ();  
+bindingElements.Add(compBindingElement);  
+bindingElements.Add(httpBindingElement);  
+CustomBinding binding = new CustomBinding(bindingElements);  
+binding.Name = "SampleBinding";  
+binding.Namespace = "http://tempuri.org/bindings";  
+  
+```  
+  
+ ほとんどのユーザー シナリオではこのコードで十分ですが、サービスが Web ホストの場合はファイル構成のサポートが重要になります。Web ホストのシナリオをサポートするには、カスタム構成ハンドラを開発して、カスタム バインディング要素をファイル内で構成できるようにする必要があります。  
+  
+ バインディング要素の構成ハンドラーを、[!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] によって用意された構成システム上にビルドできます。バインディング要素の構成ハンドラーは、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement> クラスから派生する必要があります。`BindingElementType` プロパティを使用して、このセクション用に作成するバインディング要素の型を構成システムに通知します。設定可能な `BindingElement` のすべての側面を、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement> 派生クラスのプロパティとして公開する必要があります。<xref:System.Configuration.ConfigurationPropertyAttribute> を使用して、構成要素の属性をプロパティにマップしたり、属性がない場合は既定値を設定する際に役立てます。構成から値が読み込まれてプロパティに適用されると、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement.CreateBindingElement%2A> メソッドが呼び出されます。このメソッドは、プロパティをバインディング要素の具体的なインスタンスに変換します。<xref:System.ServiceModel.Configuration.BindingElementExtensionElement.ApplyConfiguration%2A> メソッドを使用して、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement> 派生クラスのプロパティを、新しく作成されたバインディング要素の設定対象の値に変換します。  
+  
+ `GZipMessageEncodingElement` を実装するサンプル コードを次に示します。  
+  
+```  
+public class GZipMessageEncodingElement : BindingElementExtensionElement  
+{  
+    public GZipMessageEncodingElement()  
+    {  
+    }  
+  
+//Called by the WCF to discover the type of binding element this   
+//config section enables  
+    public override Type BindingElementType  
+    {  
+        get { return typeof(GZipMessageEncodingBindingElement); }  
+    }  
+  
+    //The only property we need to configure for our binding element is   
+    //the type of inner encoder to use. Here, we support text and  
+    //binary.  
+    [ConfigurationProperty("innerMessageEncoding",   
+                         DefaultValue = "textMessageEncoding")]  
+    public string InnerMessageEncoding  
+    {  
+        get { return (string)base["innerMessageEncoding"]; }  
+        set { base["innerMessageEncoding"] = value; }  
+    }  
+  
+    //Called by the WCF to apply the configuration settings (the   
+    //property above) to the binding element  
+    public override void ApplyConfiguration(BindingElement bindingElement)  
+    {  
+        GZipMessageEncodingBindingElement binding =   
+                (GZipMessageEncodingBindingElement)bindingElement;  
+        PropertyInformationCollection propertyInfo =   
+                    this.ElementInformation.Properties;  
+        if (propertyInfo["innerMessageEncoding"].ValueOrigin !=   
+                                     PropertyValueOrigin.Default)  
+        {  
+            switch (this.InnerMessageEncoding)  
+            {  
+                case "textMessageEncoding":  
+                    binding.InnerMessageEncodingBindingElement =   
+                      new TextMessageEncodingBindingElement();  
+                    break;  
+                case "binaryMessageEncoding":  
+                    binding.InnerMessageEncodingBindingElement =   
+                         new BinaryMessageEncodingBindingElement();  
+                    break;  
+            }  
+        }  
+    }  
+  
+    //Called by the WCF to create the binding element  
+    protected override BindingElement CreateBindingElement()  
+    {  
+        GZipMessageEncodingBindingElement bindingElement =   
+                new GZipMessageEncodingBindingElement();  
+        this.ApplyConfiguration(bindingElement);  
+        return bindingElement;  
+    }  
+}   
+```  
+  
+ この構成ハンドラーは、サービスまたはクライアントの App.config または Web.config の次の表現にマップされます。  
+  
+```  
+<gzipMessageEncoding innerMessageEncoding="textMessageEncoding" />  
+  
+```  
+  
+ この構成ハンドラーを使用するには、次のサンプル構成に示すように、[\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md) 要素内に登録する必要があります。  
+  
+```  
+<extensions>  
+    <bindingElementExtensions>  
+       <add   
+           name="gzipMessageEncoding"   
+           type=  
+           "Microsoft.ServiceModel.Samples.GZipMessageEncodingElement,  
+           GZipEncoder, Version=1.0.0.0, Culture=neutral,   
+           PublicKeyToken=null" />  
+      </bindingElementExtensions>  
+</extensions>  
+  
+```  
+  
+ このサーバーを実行する場合は、操作要求および応答はコンソール ウィンドウに表示されます。サーバーをシャットダウンするには、ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Press Enter key to Exit.  
+  
+        Server Echo(string input) called:  
+        Client message: Simple hello  
+  
+        Server BigEcho(string[] input) called:  
+        64 client messages  
+  
+```  
+  
+ このクライアントを実行する場合は、操作要求および応答はコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Calling Echo(string):  
+Server responds: Simple hello Simple hello  
+  
+Calling BigEcho(string[]):  
+Server responds: Hello 0  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\MessageEncoder\Compression`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-message-encoder-custom-text-encoder.md b/docs/framework/wcf/samples/custom-message-encoder-custom-text-encoder.md
new file mode 100644
index 00000000000..daa9d7211bb
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-message-encoder-custom-text-encoder.md
@@ -0,0 +1,252 @@
+---
+title: "カスタム メッセージ エンコーダー : カスタム テキスト エンコーダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 68ff5c74-3d33-4b44-bcae-e1d2f5dea0de
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# カスタム メッセージ エンコーダー : カスタム テキスト エンコーダー
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用してカスタム テキスト メッセージ エンコーダーを実装する方法を示します。  
+  
+> [!WARNING]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\MessageEncoder\Text`  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> でサポートされているエンコーディングは、UTF\-8、UTF\-16、および Big Endean Unicode のみです。このサンプルのカスタム テキスト メッセージ エンコーダーでは、すべてのプラットフォームでサポートされ、相互運用に必要とされる可能性のある文字エンコーディングがサポートされます。このサンプルは、クライアント コンソール プログラム \(.exe\)、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(.dll\)、およびテキスト メッセージ エンコーダー ライブラリ \(.dll\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および除算\) を公開しています。クライアントは指定された算術演算を同期要求し、サービスは結果と共に応答します。クライアントとサービスはどちらも、既定の <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> の代わりに `CustomTextMessageEncoder` を使用します。  
+  
+ カスタム エンコーダーの実装は、メッセージ エンコーダー ファクトリ、メッセージ エンコーダー、メッセージ エンコーディング バインディング要素、および構成ハンドラーで構成され、次が示されます。  
+  
+-   カスタム エンコーダーおよびエンコーダー ファクトリの作成。  
+  
+-   カスタム エンコーダーのバインディング要素の作成。  
+  
+-   カスタム バインディング要素を統合するためのカスタム バインディング構成の使用。  
+  
+-   カスタム バインディング要素のファイル構成を可能にするカスタム構成ハンドラーの開発。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## メッセージ エンコーダー ファクトリとメッセージ エンコーダー  
+ <xref:System.ServiceModel.ServiceHost> またはクライアント チャネルが開かれると、デザイン時コンポーネント `CustomTextMessageBindingElement` は `CustomTextMessageEncoderFactory` を作成します。このファクトリは、`CustomTextMessageEncoder` を作成します。メッセージ エンコーダーは、ストリーミング モードとバッファー モードの両方で動作し、<xref:System.Xml.XmlReader> と <xref:System.Xml.XmlWriter> を使用してメッセージの読み取りと書き込みを行います。UTF\-8、UTF\-16、および Big\-Endean Unicode だけをサポートするように最適化された [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の XML リーダーとライターとは異なり、これらのリーダーとライターはプラットフォームでサポートされるすべてのエンコーディングをサポートします。  
+  
+ カスタム テキスト メッセージ エンコーダーのコード例を次に示します。  
+  
+```csharp  
+  
+public class CustomTextMessageEncoder : MessageEncoder  
+{  
+    private CustomTextMessageEncoderFactory factory;  
+    private XmlWriterSettings writerSettings;  
+    private string contentType;  
+  
+    public CustomTextMessageEncoder(CustomTextMessageEncoderFactory factory)  
+    {  
+        this.factory = factory;  
+  
+        this.writerSettings = new XmlWriterSettings();  
+        this.writerSettings.Encoding = Encoding.GetEncoding(factory.CharSet);  
+        this.contentType = string.Format("{0}; charset={1}",   
+            this.factory.MediaType, this.writerSettings.Encoding.HeaderName);  
+    }  
+  
+    public override string ContentType  
+    {  
+        get  
+        {  
+            return this.contentType;  
+        }  
+    }  
+  
+    public override string MediaType  
+    {  
+        get   
+        {  
+            return factory.MediaType;  
+        }  
+    }  
+  
+    public override MessageVersion MessageVersion  
+    {  
+        get   
+        {  
+            return this.factory.MessageVersion;  
+        }  
+    }  
+  
+    public override Message ReadMessage(ArraySegment<byte> buffer, BufferManager bufferManager, string contentType)  
+    {     
+        byte[] msgContents = new byte[buffer.Count];  
+        Array.Copy(buffer.Array, buffer.Offset, msgContents, 0, msgContents.Length);  
+        bufferManager.ReturnBuffer(buffer.Array);  
+  
+        MemoryStream stream = new MemoryStream(msgContents);  
+        return ReadMessage(stream, int.MaxValue);  
+    }  
+  
+    public override Message ReadMessage(Stream stream, int maxSizeOfHeaders, string contentType)  
+    {  
+        XmlReader reader = XmlReader.Create(stream);  
+        return Message.CreateMessage(reader, maxSizeOfHeaders, this.MessageVersion);  
+    }  
+  
+    public override ArraySegment<byte> WriteMessage(Message message, int maxMessageSize, BufferManager bufferManager, int messageOffset)  
+    {  
+        MemoryStream stream = new MemoryStream();  
+        XmlWriter writer = XmlWriter.Create(stream, this.writerSettings);  
+        message.WriteMessage(writer);  
+        writer.Close();  
+  
+        byte[] messageBytes = stream.GetBuffer();  
+        int messageLength = (int)stream.Position;  
+        stream.Close();  
+  
+        int totalLength = messageLength + messageOffset;  
+        byte[] totalBytes = bufferManager.TakeBuffer(totalLength);  
+        Array.Copy(messageBytes, 0, totalBytes, messageOffset, messageLength);  
+  
+        ArraySegment<byte> byteArray = new ArraySegment<byte>(totalBytes, messageOffset, messageLength);  
+        return byteArray;  
+    }  
+  
+    public override void WriteMessage(Message message, Stream stream)  
+    {  
+        XmlWriter writer = XmlWriter.Create(stream, this.writerSettings);  
+        message.WriteMessage(writer);  
+        writer.Close();  
+    }  
+}  
+```  
+  
+ メッセージ エンコーダー ファクトリを作成する方法を次のコード例に示します。  
+  
+```csharp  
+public class CustomTextMessageEncoderFactory : MessageEncoderFactory  
+{  
+    private MessageEncoder encoder;  
+    private MessageVersion version;  
+    private string mediaType;  
+    private string charSet;  
+  
+    internal CustomTextMessageEncoderFactory(string mediaType, string charSet,  
+        MessageVersion version)  
+    {  
+        this.version = version;  
+        this.mediaType = mediaType;  
+        this.charSet = charSet;  
+        this.encoder = new CustomTextMessageEncoder(this);  
+    }  
+  
+    public override MessageEncoder Encoder  
+    {  
+        get   
+        {   
+            return this.encoder;  
+        }  
+    }  
+  
+    public override MessageVersion MessageVersion  
+    {  
+        get   
+        {   
+            return this.version;  
+        }  
+    }  
+  
+    internal string MediaType  
+    {  
+        get  
+        {  
+            return this.mediaType;  
+        }  
+    }  
+  
+    internal string CharSet  
+    {  
+        get  
+        {  
+            return this.charSet;  
+        }  
+    }  
+}  
+```  
+  
+## メッセージ エンコーディング バインディング要素  
+ このバインディング要素により、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイム スタックの構成が可能になります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーション内でカスタム メッセージ エンコーダーを使用するには、ランタイム スタックの適切なレベルで適切な設定を使用してメッセージ エンコーダー ファクトリを作成する、バインディング要素が必要です。  
+  
+ `CustomTextMessageBindingElement` は <xref:System.ServiceModel.Channels.BindingElement> 基本クラスから派生し、<xref:System.ServiceModel.Channels.MessageEncodingBindingElement> クラスを継承します。これによって、他の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントは、このバインディング要素をメッセージ エンコーディング バインディング要素として認識できます。<xref:System.ServiceModel.Channels.MessageEncodingBindingElement.CreateMessageEncoderFactory%2A> を実装すると、一致するメッセージ エンコーダー ファクトリのインスタンスが適切に設定されて返されます。  
+  
+ `CustomTextMessageBindingElement` は、プロパティを介して `MessageVersion`、`ContentType`、および `Encoding` の設定を公開します。エンコーダーは、Soap11Addressing と Soap12Addressing1 の両方のバージョンをサポートします。既定値は Soap11Addressing1 です。また、`ContentType` の既定値は "text\/xml" です。`Encoding` プロパティでは、必要な文字エンコーディングの値を設定できます。サンプルのクライアントとサービスでは、ISO\-8859\-1 \(Latin1\) 文字エンコーディングを使用します。この規格は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> ではサポートされません。  
+  
+ カスタム テキスト メッセージ エンコーダーを使用してプログラムでバインディングを作成する方法を次のコードに示します。  
+  
+```  
+ICollection<BindingElement> bindingElements = new List<BindingElement>();  
+HttpTransportBindingElement httpBindingElement = new HttpTransportBindingElement();  
+CustomTextMessageBindingElement textBindingElement = new CustomTextMessageBindingElement();  
+bindingElements.Add(textBindingElement);  
+bindingElements.Add(httpBindingElement);  
+CustomBinding binding = new CustomBinding(bindingElements);  
+```  
+  
+## メッセージ エンコーディング バインディング要素へのメタデータのサポートの追加  
+ <xref:System.ServiceModel.Channels.MessageEncodingBindingElement> から派生するすべての型は、サービスに対して生成される WSDL ドキュメント内の SOAP バインドのバージョンを更新します。これを行うには、<xref:System.ServiceModel.Description.IWsdlExportExtension> インターフェイス上に `ExportEndpoint` メソッドを実装し、生成された WSDL を変更します。このサンプルでは、`CustomTextMessageBindingElement` は `TextMessageEncodingBinidngElement` からの WSDL エクスポート ロジックを使用します。  
+  
+ このサンプルの場合、クライアント構成は手動構成です。Svcutil.exe を使用してクライアント構成を生成することはできません。`CustomTextMessageBindingElement` では、動作を記述するポリシー アサーションがエクスポートされないからです。通常は、カスタム バインディング要素上に <xref:System.ServiceModel.Description.IPolicyExportExtension> インターフェイスを実装して、バインディング要素によって実装される動作または機能を記述するカスタム ポリシー アサーションをエクスポートする必要があります。カスタム バインディング要素のポリシー アサーションをエクスポートする方法の例については、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」サンプルを参照してください。  
+  
+## メッセージ エンコーディング バインディング構成ハンドラー  
+ 前のセクションでは、カスタム テキスト メッセージ エンコーダーをプログラムによって使用する方法を示しました。`CustomTextMessageEncodingBindingSection` は構成ハンドラーを実装します。この構成ハンドラーにより、カスタム テキスト メッセージ エンコーダーを構成ファイル内で使用することを指定できます。`CustomTextMessageEncodingBindingSection` クラスは <xref:System.ServiceModel.Configuration.BindingElementExtensionElement> クラスから派生します。`BindingElementType` プロパティでは、このセクション用に作成するバインディング要素の型が構成システムに通知されます。  
+  
+ `CustomTextMessageBindingElement` によって定義されたすべての設定は、`CustomTextMessageEncodingBindingSection` のプロパティとして公開されます。<xref:System.Configuration.ConfigurationPropertyAttribute> は、構成要素の属性をプロパティにマップしたり、属性がない場合は既定値を設定する際に役立ちます。構成から値が読み込まれて型のプロパティに適用されると、<xref:System.ServiceModel.Configuration.BindingElementExtensionElement.CreateBindingElement%2A> メソッドが呼び出されます。このメソッドは、プロパティをバインディング要素の具体的なインスタンスに変換します。  
+  
+ この構成ハンドラーは、サービスまたはクライアントの App.config または Web.config の次の表現にマップされます。  
+  
+```  
+<customTextMessageEncoding encoding="utf-8" contentType="text/xml" messageVersion="Soap11Addressing1" />  
+  
+```  
+  
+ このサンプルでは、ISO\-8859\-1 エンコーディングを使用します。  
+  
+ この構成ハンドラーを使用するには、次の構成要素を使用して登録する必要があります。  
+  
+```  
+<extensions>  
+    <bindingElementExtensions>  
+        <add name="customTextMessageEncoding" type="   
+Microsoft.ServiceModel.Samples.CustomTextMessageEncodingBindingSection,   
+                  CustomTextMessageEncoder" />  
+    </bindingElementExtensions>  
+</extensions>  
+  
+```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-message-filter.md b/docs/framework/wcf/samples/custom-message-filter.md
new file mode 100644
index 00000000000..94c11c2a7e6
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-message-filter.md
@@ -0,0 +1,150 @@
+---
+title: "カスタム メッセージ フィルター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98dd0af8-fce6-4255-ac32-42eb547eea67
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# カスタム メッセージ フィルター
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が使用するメッセージ フィルタを置き換えて、メッセージをエンドポイントにディスパッチする方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ チャネルでの最初のメッセージがサーバーに到着すると、サーバーは、URI に関連付けられているエンドポイントがある場合に、どのエンドポイントがメッセージを受信する必要があるかを判断する必要があります。この処理は、<xref:System.ServiceModel.Dispatcher.EndpointDispatcher> に関連付けられている <xref:System.ServiceModel.Dispatcher.MessageFilter> オブジェクトで制御されます。  
+  
+ サービスの各エンドポイントには、単一の <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> があります。<xref:System.ServiceModel.Dispatcher.EndpointDispatcher> には、<xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter%2A> と <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter%2A> の両方があります。これら 2 つのフィルタを結合したものが、このエンドポイントに使用されるメッセージ フィルタです。  
+  
+ エンドポイントの <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter%2A> の既定では、アドレス指定されているメッセージと、サービス エンドポイントの <xref:System.ServiceModel.EndpointAddress> に一致するアドレスを照合します。エンドポイントの <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter%2A> の既定では、受信メッセージのアクションを検査して、サービス エンドポイントのコントラクトの操作のいずれかのアクション \(対象になるのは `IsInitiating`\=`true` のアクションだけです\) に対応するアクションが含まれるメッセージを照合します。その結果、エンドポイントのフィルタの既定で一致と見なされるのは、メッセージの To ヘッダーがエンドポイントの <xref:System.ServiceModel.EndpointAddress> に一致し、メッセージのアクションがエンドポイントの操作のいずれかのアクションと一致するという、2 つの条件がどちらも満たされる場合だけです。  
+  
+ これらのフィルタは、動作を使用して変更できます。サンプルのサービスは、次のように <xref:System.ServiceModel.Description.IEndpointBehavior> を作成して、<xref:System.ServiceModel.Dispatcher.EndpointDispatcher> の <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter%2A> と <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.ContractFilter%2A> を置き換えます。  
+  
+```  
+class FilteringEndpointBehavior : IEndpointBehavior …  
+```  
+  
+ 2 つのアドレス フィルタは、次のように定義されます。  
+  
+```  
+// Matches any message whose To address contains the letter 'e'  
+class MatchEAddressFilter : MessageFilter …  
+// Matches any message whose To address does not contain the letter 'e'  
+class MatchNoEAddressFilter : MessageFilter  
+```  
+  
+ `FilteringEndpointBehavior` は構成可能になり、2 つの異なるバリエーションを設定できます。  
+  
+```  
+public class FilteringEndpointBehaviorExtension : BehaviorExtensionElement  
+  
+```  
+  
+ バリエーション 1 では 'e' が含まれる \(ただし任意のアクションを含む\) アドレスのみを照合します。これに対して、バリエーション 2 では 'e' が含まれないアドレスのみを照合します。  
+  
+```  
+if (Variation == 1)  
+    return new FilteringEndpointBehavior(  
+        new MatchEAddressFilter(), new MatchAllMessageFilter());  
+else  
+    return new FilteringEndpointBehavior(  
+        new MatchNoEAddressFilter(), new MatchAllMessageFilter());  
+  
+```  
+  
+ 構成ファイルでは、サービスは次のように新しい動作を登録します。  
+  
+```  
+<extensions>  
+    <behaviorExtensions>  
+        <add name="filteringEndpointBehavior" type="Microsoft.ServiceModel.Samples.FilteringEndpointBehaviorExtension, service" />  
+    </behaviorExtensions>  
+</extensions>      
+```  
+  
+ 次に、各バリエーションの `endpointBehavior` 構成を次のように作成します。  
+  
+```  
+<endpointBehaviors>  
+    <behavior name="endpoint1">  
+        <filteringEndpointBehavior variation="1" />  
+    </behavior>  
+    <behavior name="endpoint2">  
+        <filteringEndpointBehavior variation="2" />  
+    </behavior>  
+</endpointBehaviors>  
+  
+```  
+  
+ 最後に、サービスのエンドポイントは、`behaviorConfigurations` の 1 つを次のように参照します。  
+  
+```  
+<endpoint address=""  
+        bindingConfiguration="ws"  
+        listenUri=""   
+        binding="wsHttpBinding"  
+        contract="Microsoft.ServiceModel.Samples.IHello"   
+        behaviorConfiguration="endpoint2" />  
+  
+```  
+  
+ クライアント アプリケーションの実装は単純で、URI の値を 2 番目の \(`via`\) パラメータとして <xref:System.ServiceModel.Channels.IChannelFactory%601.CreateChannel%28System.ServiceModel.EndpointAddress%29> に渡すことによって、2 つのチャネルをサービスの URI に作成し、各チャネルに 1 つのメッセージを送信します。ただし、チャネルごとに異なるエンドポイント アドレスが使用されます。この結果、次のクライアントの出力に示すように、クライアントからの送信メッセージにはそれぞれ異なる宛先が指定され、サーバーはこれに応じて応答します。  
+  
+```  
+Sending message to urn:e...  
+Exception: The message with To 'urn:e' cannot be processed at the receiver, due to an AddressFilter mismatch at the EndpointDispatcher.  Check that the sender and receiver's EndpointAddresses agree.  
+  
+Sending message to urn:a...  
+Hello  
+```  
+  
+ サーバーの構成ファイルのバリエーションを切り替えると、フィルターが入れ替わり、クライアントには逆の動作が表示されます \(`urn:e` へのメッセージは正常に送信されますが、`urn:a` へのメッセージはエラーになります\)。  
+  
+```  
+<endpoint address=""  
+          bindingConfiguration="ws"  
+          listenUri=""   
+          binding="wsHttpBinding"  
+          contract="Microsoft.ServiceModel.Samples.IHello"   
+          behaviorConfiguration="endpoint1" />  
+  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\MessageFilter`  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  単一コンピュータ構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+3.  複数コンピュータ構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従い、Client.cs の次の行を変更します。  
+  
+    ```  
+    Uri serviceVia = new Uri("http://localhost/ServiceModelSamples/service.svc");  
+    ```  
+  
+     つまり、localhost をサーバー名に置き換えます。  
+  
+    ```  
+    Uri serviceVia = new Uri("http://servermachinename/ServiceModelSamples/service.svc");  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-message-interceptor.md b/docs/framework/wcf/samples/custom-message-interceptor.md
new file mode 100644
index 00000000000..f144251d503
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-message-interceptor.md
@@ -0,0 +1,178 @@
+---
+title: "カスタム メッセージ インターセプター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 73f20972-53f8-475a-8bfe-c133bfa225b0
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# カスタム メッセージ インターセプター
+このサンプルでは、チャネル拡張モデルの使用方法を示します。特に、チャネル ファクトリとチャネル リスナを作成するカスタム バインディング要素を実装して、ランタイム スタックの特定のポイントですべての送受信メッセージを中断する方法を示します。また、このサンプルには、こうしたカスタム ファクトリの使用方法を示すクライアントとサーバーも含まれます。  
+  
+ このサンプルでは、クライアントとサービスは両方ともコンソール プログラム \(.exe\) です。そして、これらのクライアントとサービスの両方で、カスタム バインディング要素およびこれに関連付けられたランタイム オブジェクトを含む共通ライブラリ \(.dll\) を使用します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\MessageInterceptor`  
+  
+ このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でカスタム階層チャネルを作成するための推奨手順について説明します。作成時には、チャネル フレームワークと次に示す [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のベスト プラクティスを使用します。カスタム階層チャネルを作成する手順は、次のとおりです。  
+  
+1.  どのチャネル形状をチャネル ファクトリおよびチャネル リスナがサポートするかを決定します。  
+  
+2.  チャネル形状をサポートするチャネル ファクトリおよびチャネル リスナを作成します。  
+  
+3.  チャネル スタックにカスタム階層チャネルを追加するバインド要素を追加します。  
+  
+4.  バインド要素拡張セクションを追加して、新しいバインド要素を構成システムに公開します。  
+  
+## チャネル形状  
+ カスタム階層チャネルを記述する最初の手順として、どの形状がチャネルに必要かを判断します。メッセージ インスペクタの場合、下のレイヤでサポートされる任意の形状をサポートします \(たとえば、下のレイヤで <xref:System.ServiceModel.Channels.IOutputChannel> と <xref:System.ServiceModel.Channels.IDuplexSessionChannel> が作成できる場合は、<xref:System.ServiceModel.Channels.IOutputChannel> と <xref:System.ServiceModel.Channels.IDuplexSessionChannel> を公開します\)。  
+  
+## チャネル ファクトリとリスナ ファクトリ  
+ カスタム階層チャネルを記述する次の手順では、クライアント チャネルでの <xref:System.ServiceModel.Channels.IChannelFactory> の実装とサービス チャネルでの <xref:System.ServiceModel.Channels.IChannelListener> の実装を作成します。  
+  
+ これらのクラスでは、内部ファクトリとリスナが取得され、この内部ファクトリとリスナが `OnCreateChannel` と `OnAcceptChannel` 以外のすべての呼び出しを代行します。  
+  
+```  
+class InterceptingChannelFactory<TChannel> : ChannelFactoryBase<TChannel>  
+{ ... }  
+class InterceptingChannelListener<TChannel> : ListenerFactoryBase<TChannel>  
+{ ... }  
+```  
+  
+## バインド要素の追加  
+ このサンプルでは、`InterceptingBindingElement` というカスタム バインディング要素を定義します。`InterceptingBindingElement` は、`ChannelMessageInterceptor` を入力として受け取り、この `ChannelMessageInterceptor`  を使用して、通過するメッセージを操作します。公開する必要があるクラスはこれだけです。ファクトリ、リスナ、およびチャネルはすべて、ランタイム パブリック インターフェイスの内部実装として設定できます。  
+  
+```  
+public class InterceptingBindingElement : BindingElement  
+```  
+  
+## 構成サポートの追加  
+ バインディング構成と統合するには、ライブラリで、構成セクション ハンドラをバインディング要素拡張セクションとして定義します。クライアントとサーバーの構成ファイルでは、バインディング要素拡張を構成システムに登録する必要があります。バインディング要素を構成システムに公開する実装は、このクラスから派生できます。  
+  
+```  
+public abstract class InterceptingElement : BindingElementExtensionElement { ... }  
+  
+```  
+  
+## ポリシーの追加  
+ ポリシー システムと統合するには、`InterceptingBindingElement` に IPolicyExportExtension を実装し、ポリシーの生成に参加する必要があることを通知します。生成されたクライアント上でポリシーのインポートをサポートするには、`InterceptingBindingElementImporter` の派生クラスを登録し、`CreateMessageInterceptor`\(\) をオーバーライドして、ポリシーが有効なそれらの `ChannelMessageInterceptor` クラスを生成します。  
+  
+## 例 : 破棄可能なメッセージ インスペクタ  
+ このサンプルには、メッセージを破棄する `ChannelMessageInspector` の実装例が含まれています。  
+  
+```  
+  
+class DroppingServerElement : InterceptingElement  
+{  
+    protected override ChannelMessageInterceptor CreateMessageInterceptor()  
+    {  
+        return new DroppingServerInterceptor();  
+    }  
+}  
+```  
+  
+ この例には、次のように構成からアクセスできます。  
+  
+```  
+<configuration>  
+    ...  
+    <system.serviceModel>  
+        ...  
+        <extensions>  
+            <bindingElementExtensions>  
+                <add name="droppingInterceptor"   
+                   type=  
+          "Microsoft.ServiceModel.Samples.DroppingServerElement, library"/>  
+            </bindingElementExtensions>  
+        </extensions>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ クライアントとサーバーでは、両方ともこの新しく作成された構成セクションを使用して、カスタム ファクトリをランタイム チャネル スタックの最低レベル \(トランスポート レベルの上\) に挿入します。  
+  
+```  
+<customBinding>  
+  <binding name="sampleBinding">  
+    <droppingInterceptor/>  
+    <httpTransport/>  
+  </binding>  
+</customBinding>  
+  
+```  
+  
+ クライアントでは `MessageInterceptor` ライブラリを使用して、カスタム ヘッダーを偶数番号付きメッセージに追加します。一方、サービスでは `MessageInterceptor` ライブラリを使用して、この特殊なヘッダーを持たないメッセージを削除します。  
+  
+ サービスを実行し、次にクライアントを実行すると、次のクライアント出力が表示されます。  
+  
+```  
+Reporting the next 10 wind speed  
+100 kph  
+Server dropped a message.  
+90 kph  
+80 kph  
+Server dropped a message.  
+70 kph  
+60 kph  
+Server dropped a message.  
+50 kph  
+40 kph  
+Server dropped a message.  
+30 kph  
+20 kph  
+Server dropped a message.  
+10 kph  
+Press ENTER to shut down client  
+  
+```  
+  
+ クライアントからは 10 種類の異なる風速がサービスに報告されますが、特殊なヘッダーがあるのはそれらのタグの半分だけです。  
+  
+ サービスには、次の出力が表示されます。  
+  
+```  
+Press ENTER to exit.  
+Dangerous wind detected! Reported speed (90) is greater than 64 kph.  
+Dangerous wind detected! Reported speed (70) is greater than 64 kph.  
+5 wind speed reports have been received.  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+5.  最初に Service.exe を実行して次に Client.exe を実行し、両方のコンソール ウィンドウで出力を表示します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-secure-metadata-endpoint.md b/docs/framework/wcf/samples/custom-secure-metadata-endpoint.md
new file mode 100644
index 00000000000..13d1370b929
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-secure-metadata-endpoint.md
@@ -0,0 +1,197 @@
+---
+title: "カスタム セキュア メタデータ エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e369e99-ea4a-49ff-aed2-9fdf61091a48
+caps.latest.revision: 19
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 19
+---
+# カスタム セキュア メタデータ エンドポイント
+このサンプルでは、メタデータ交換バインディング以外のバインディングが使用されているセキュア メタデータ エンドポイントが含まれるサービスを実装する方法と、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) またはクライアントを構成して、そのようなメタデータ エンドポイントからメタデータを取得する方法を示します。メタデータ エンドポイントを公開する場合に使用できるシステム指定のバインディングには、mexHttpBinding と mexHttpsBinding の 2 つがあります。mexHttpBinding は、メタデータ エンドポイントをセキュリティ保護されない HTTP で公開する場合に使用します。mexHttpsBinding は、メタデータ エンドポイントをセキュリティ保護される HTTPS で公開する場合に使用します。このサンプルでは、<xref:System.ServiceModel.WSHttpBinding> を使用してセキュア メタデータ エンドポイントを公開する方法を示します。この方法は、HTTPS を使用せずにバインディングのセキュリティ設定を変更する場合に使用します。mexHttpsBinding を使用すると、メタデータ エンドポイントがセキュリティ保護されますが、バインディング設定を変更できなくなります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## サービス  
+ このサンプルのサービスには 2 つのエンドポイントがあります。アプリケーション エンドポイントは、`ReliableSession` が有効で証明書による `Message` セキュリティを使用する `WSHttpBinding` に、`ICalculator` コントラクトを提供します。メタデータ エンドポイントでも、同じセキュリティが設定されている `WSHttpBinding` を使用しますが、`ReliableSession` は無効です。関連する構成は次のとおりです。  
+  
+```  
+<services>  
+    …  
+    <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+            behaviorConfiguration="CalculatorServiceBehavior">  
+     <!-- use base address provided by host -->  
+     <endpoint address=""  
+       binding="wsHttpBinding"  
+       bindingConfiguration="Binding2"  
+       contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+     <endpoint address="mex"  
+       binding="wsHttpBinding"  
+       bindingConfiguration="Binding1"  
+       contract="IMetadataExchange" />  
+     </service>  
+ </services>  
+ <bindings>  
+   <wsHttpBinding>  
+     <binding name="Binding1">  
+       <security mode="Message">  
+         <message clientCredentialType="Certificate" />  
+       </security>  
+     </binding>  
+     <binding name="Binding2">  
+       <reliableSession inactivityTimeout="00:01:00" enabled="true" />  
+       <security mode="Message">  
+         <message clientCredentialType="Certificate" />  
+       </security>  
+     </binding>  
+   </wsHttpBinding>  
+ </bindings>  
+```  
+  
+ 他の多くのサンプルでは、メタデータ エンドポイントには、セキュリティ保護されていない既定の `mexHttpBinding` が使用されます。このサンプルのメタデータは、`Message` セキュリティが設定されている `WSHttpBinding` を使用してセキュリティ保護されます。メタデータ クライアントがこのメタデータを取得するには、照合バインディングを使用して構成する必要があります。このサンプルでは、こうした 2 つのクライアントを示します。  
+  
+ 最初のクライアントでは Svcutil.exe を使用し、デザイン時にメタデータを取得してクライアント コードと構成を生成します。サービスはメタデータの既定以外のバインディングを使用するので、Svcutil.exe ツールはこのバインディングを使用してサービスからメタデータを取得できるよう、特に構成される必要があります。  
+  
+ 2 番目のクライアントでは `MetadataResolver` を使用し、既知のコントラクトのメタデータを動的に取得して、動的に生成されたクライアントでの操作を呼び出します。  
+  
+## Svcutil クライアント  
+ 既定のバインディングを使用して `IMetadataExchange` エンドポイントをホストする場合、このエンドポイントのアドレスを使用して次のように Svcutil.exe を実行できます。  
+  
+```  
+svcutil http://localhost/servicemodelsamples/service.svc/mex  
+```  
+  
+ これでツールが動作します。ただしこのサンプルのサーバーでは、メタデータをホストするときに既定以外のエンドポイントを使用しています。そのため、正しいバインディングが使用されるように Svcutil.exe を指定する必要があります。これは、Svcutil.exe.config ファイルを使用して実行できます。  
+  
+ Svcutil.exe.config ファイルは、通常のクライアント構成ファイルに似ています。異なる点は、次に示すようにクライアントのエンドポイント名とエンドポイント コントラクトだけです。  
+  
+```  
+<endpoint name="http"  
+          binding="wsHttpBinding"  
+          bindingConfiguration="Binding1"  
+          behaviorConfiguration="ClientCertificateBehavior"  
+          contract="IMetadataExchange" />  
+```  
+  
+ エンドポイント名は、メタデータがホストされるアドレスのスキーマの名前である必要があります。また、エンドポイント コントラクトは `IMetadataExchange` であることが必要です。したがって、Svcutil.exe をコマンド ラインで実行する場合は次のようになります。  
+  
+```  
+svcutil http://localhost/servicemodelsamples/service.svc/mex  
+```  
+  
+ ここでは、"http" という名前のエンドポイントと、このメタデータ エンドポイントとの通信交換のバインディングと動作を構成するコントラクト `IMetadataExchange` が検索されます。このサンプルでは、Svcutil.exe.config ファイルの残りの部分でバインディング構成と動作の資格情報を指定して、サーバーのメタデータ エンドポイントの構成と照合します。  
+  
+ Svcutil.exe が Svcutil.exe.config の構成を使用するには、Svcutil.exe がこの構成ファイルと同じディレクトリにある必要があります。したがって、Svcutil.exe をインストール場所から Svcutil.exe.config ファイルが含まれるディレクトリにコピーする必要があります。その後、そのディレクトリで次のコマンドを実行します。  
+  
+```  
+.\svcutil.exe http://localhost/servicemodelsamples/service.svc/mex  
+```  
+  
+ 先頭の ".\\" により、現在のディレクトリ \(対応する Svcutil.exe.config のあるディレクトリ\) 内の Svcutil.exe のコピーが実行されることになります。  
+  
+## MetadataResolver クライアント  
+ クライアントで、コントラクトおよびメタデータと対話する方法がデザイン時に認識されている場合、クライアントは `MetadataResolver` を使用してアプリケーション エンドポイントのバインディングとアドレスを動的に検索することができます。その例として、このクライアントのサンプルでは、`MetadataExchangeClient` を作成して構成することにより、`MetadataResolver` で使用されるバインディングと資格情報を構成する方法を示します。  
+  
+ Svcutil.exe.config には、同じバインディングと資格情報についての情報が示されており、`MetadataExchangeClient` でこれを次のように強制的に使用できます。  
+  
+```  
+// Specify the Metadata Exchange binding and its security mode  
+WSHttpBinding mexBinding = new WSHttpBinding(SecurityMode.Message);  
+mexBinding.Security.Message.ClientCredentialType = MessageCredentialType.Certificate;  
+  
+// Create a MetadataExchangeClient for retrieving metadata, and set the // certificate details  
+MetadataExchangeClient mexClient = new MetadataExchangeClient(mexBinding);  
+mexClient.SoapCredentials.ClientCertificate.SetCertificate(    StoreLocation.CurrentUser, StoreName.My,  
+    X509FindType.FindBySubjectName, "client.com");  
+mexClient.SoapCredentials.ServiceCertificate.Authentication.    CertificateValidationMode =    X509CertificateValidationMode.PeerOrChainTrust;  
+mexClient.SoapCredentials.ServiceCertificate.SetDefaultCertificate(    StoreLocation.CurrentUser, StoreName.TrustedPeople,  
+    X509FindType.FindBySubjectName, "localhost");  
+```  
+  
+ `mexClient` が構成されている場合、次のように必要なコントラクトを列挙し、`MetadataResolver` を使用してこれらのコントラクトが含まれるエンドポイントの一覧を取得できます。  
+  
+```  
+// The contract we want to fetch metadata for  
+Collection<ContractDescription> contracts =    new Collection<ContractDescription>();  
+ContractDescription contract =    ContractDescription.GetContract(typeof(ICalculator));  
+contracts.Add(contract);  
+// Find endpoints for that contract  
+EndpointAddress mexAddress = new    EndpointAddress(ConfigurationManager.AppSettings["mexAddress"]);  
+ServiceEndpointCollection endpoints =    MetadataResolver.Resolve(contracts, mexAddress, mexClient);  
+```  
+  
+ 最後に、こうしたエンドポイントからの情報を使用して、アプリケーション エンドポイントと通信するチャネルの作成に使用される、`ChannelFactory` のバインディングとアドレスを初期化できます。  
+  
+```  
+ChannelFactory<ICalculator> cf = new    ChannelFactory<ICalculator>(endpoint.Binding, endpoint.Address);  
+```  
+  
+ このクライアント サンプルで重要な点は、`MetadataResolver` を使用しているときにメタデータ交換通信用のカスタム バインディングまたはカスタム動作を指定する必要がある場合に、`MetadataExchangeClient` を使用すればこうしたカスタム設定を指定できるということです。  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  Setup.bat をサンプルのインストール フォルダーで実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。Setup.bat は、「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」から setupCertTool.bat を実行してインストールされる FindPrivateKey.exe ツールを使用します。  
+  
+2.  \\MetadataResolverClient\\bin または \\SvcutilClient\\bin でクライアント アプリケーションを実行します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+3.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+4.  サンプルの使用が終わったら、Cleanup.bat を実行して証明書を削除してください。他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+#### サンプルを別のコンピューターで実行するには  
+  
+1.  サーバーで `setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+2.  サーバーで、Web.config を編集して新しい証明書の名前を反映します。つまり、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-clientcredentials-element.md) 要素の `findValue` 属性をコンピューターの完全修飾ドメイン名に変更します。  
+  
+3.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+4.  クライアントで `setup.bat client` を実行します。`setup.bat` に `client` 引数を指定して実行すると、Client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+5.  クライアント コンピューターにある `MetadataResolverClient` の App.config ファイルで、MEX エンドポイントのアドレス値をサービスの新しいアドレスに合わせて変更します。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。さらに、metadataResolverClient.cs ファイルに記述されている "localhost" を、新しいサービス証明書の名前 \(サーバーの完全修飾ドメイン名\) に変更します。SvcutilClient プロジェクトの App.config に対して、同様の手順を行います。  
+  
+6.  Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+7.  クライアントで `ImportServiceCert.bat` を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+8.  サーバーで `ImportClientCert.bat` を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+9. サービス コンピューターで、Visual Studio でサービス プロジェクトをビルドし、それが実行されていることを Web ブラウザーでヘルプ ページを選択することにより検証します。  
+  
+10. クライアント コンピューター上の VS で、MetadataResolverClient または SvcutilClient を実行します。  
+  
+    1.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを別のマシンで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。別のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` のようにします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Metadata\CustomMexEndpoint`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-service-host.md b/docs/framework/wcf/samples/custom-service-host.md
new file mode 100644
index 00000000000..1d80c02521a
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-service-host.md
@@ -0,0 +1,186 @@
+---
+title: "カスタム サービス ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe16ff50-7156-4499-9c32-13d8a79dc100
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# カスタム サービス ホスト
+このサンプルでは、<xref:System.ServiceModel.ServiceHost> クラスから派生したカスタムのサービス ホストを使用して、サービスの実行時動作を変更する方法を示します。  この方法は、多数のサービスを共通方式で構成するという方法の代わりに使用でき、再利用可能です。  このサンプルでは、<xref:System.ServiceModel.Activation.ServiceHostFactory> クラスを使用して、カスタムの ServiceHost を、インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) でホストされる環境で使用する方法も示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Hosting\CustomServiceHost`  
+  
+## シナリオについて  
+ サービスのメタデータには機密情報が含まれる可能性がありますが、意図的ではない開示を回避するために、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの既定の構成では、メタデータは公開されないようになっています。  この動作は、既定の設定ではセキュリティで保護されますが、同時に、サービスの構成の中でメタデータ公開の動作が明示的に有効化されない限り、サービスの呼び出しに必要なクライアント コードをメタデータ インポート ツール \(Svcutil.exe など\) を使用して生成できないことも意味します。  
+  
+ 多数のサービスのメタデータ公開を有効にすると、同一の構成要素が各サービスに追加されます。この結果、本質的に同じ構成情報が大量に発生することになります。  各サービスを個別に構成する代わりに、メタデータ公開を有効化する命令型コードを一度だけプログラミングして、そのコードを複数のサービスで再利用するという方法もあります。  この方法を使用するには、<xref:System.ServiceModel.ServiceHost> から派生する新しいクラスを作成し、`ApplyConfiguration`\(\) メソッドをオーバーライドして命令型コードでメタデータ公開動作を追加します。  
+  
+> [!IMPORTANT]
+>  このサンプルでは、わかりやすくするために、セキュリティで保護されていないメタデータ公開エンドポイントを作成する方法を示します。  このようなエンドポイントを利用するコンシューマーは、匿名で、認証を受けていない可能性もあります。したがって、エンドポイントを配置する前には注意を払い、サービスのメタデータをパブリックに開示することが適切であることを確認する必要があります。  
+  
+## カスタム ServiceHost の実装  
+ <xref:System.ServiceModel.ServiceHost> クラスは、便利な仮想メソッドを多数公開しています。継承側でこの仮想メソッドをオーバーライドして、サービスの実行時動作を変更することができます。  たとえば、`ApplyConfiguration`\(\) メソッドはサービスの構成情報を構成ストアから読み取り、それに応じてホストの <xref:System.ServiceModel.Description.ServiceDescription> を変更します。  既定の実装は構成をアプリケーションの構成ファイルから読み取りますが、  カスタム実装では、`ApplyConfiguration`\(\) をオーバーライドすれば、命令型コードを使用して <xref:System.ServiceModel.Description.ServiceDescription> にさらに変更を加えることや、既定の構成ストア全体を置き換えることも可能です \(  たとえば、サービスのエンドポイント構成を、アプリケーションの構成ファイルではなくデータベースから読み取るようにする場合\)。  
+  
+ このサンプルでは、ServiceMetadataBehavior \(メタデータ公開を有効にする動作\) がサービスの構成ファイルに明示的に追加されていない場合でもこの動作を追加する、カスタムの ServiceHost を構築します。  これを実現するには、<xref:System.ServiceModel.ServiceHost> から継承する新しいクラスを作成して `ApplyConfiguration`\(\) をオーバーライドします。  
+  
+```  
+class SelfDescribingServiceHost : ServiceHost  
+{  
+    public SelfDescribingServiceHost(Type serviceType, params Uri[] baseAddresses)  
+        : base(serviceType, baseAddresses) { }  
+  
+    //Overriding ApplyConfiguration() allows us to   
+    //alter the ServiceDescription prior to opening  
+    //the service host.   
+    protected override void ApplyConfiguration()  
+    {  
+        //First, we call base.ApplyConfiguration()  
+        //to read any configuration that was provided for  
+        //the service we're hosting. After this call,  
+        //this.Description describes the service  
+        //as it was configured.  
+        base.ApplyConfiguration();       
+  
+        //(rest of implementation elided for clarity)  
+    }  
+}  
+```  
+  
+ アプリケーションの構成ファイルで指定されている構成が無視されないようにしたいので、`ApplyConfiguration`\(\) のオーバーライドで最初に行うことは、基本実装の呼び出しです。  このメソッドが完了した後で、次の命令型コードを使用して、サービス記述に <xref:System.ServiceModel.Description.ServiceMetadataBehavior> を追加します。  
+  
+```  
+ServiceMetadataBehavior mexBehavior = this.Description.Behaviors.Find<ServiceMetadataBehavior>();  
+if (mexBehavior == null)  
+{  
+    mexBehavior = new ServiceMetadataBehavior();  
+    this.Description.Behaviors.Add(mexBehavior);  
+}  
+else  
+{  
+    //Metadata behavior has already been configured,   
+    //so we do not have any work to do.  
+    return;  
+}  
+```  
+  
+ `ApplyConfiguration`\(\) のオーバーライドでの最後の処理は、既定のメタデータ エンドポイントの追加です。  通常は、サービス ホストの BaseAddresses コレクション内の各 URI に対して 1 つずつメタデータ エンドポイントを作成します。  
+  
+```  
+//Add a metadata endpoint at each base address  
+//using the "/mex" addressing convention  
+foreach (Uri baseAddress in this.BaseAddresses)  
+{  
+    if (baseAddress.Scheme == Uri.UriSchemeHttp)  
+    {  
+        mexBehavior.HttpGetEnabled = true;  
+        this.AddServiceEndpoint(ServiceMetadataBehavior.MexContractName,  
+                                MetadataExchangeBindings.CreateMexHttpBinding(),  
+                                "mex");  
+    }  
+    else if (baseAddress.Scheme == Uri.UriSchemeHttps)  
+    {  
+        mexBehavior.HttpsGetEnabled = true;  
+        this.AddServiceEndpoint(ServiceMetadataBehavior.MexContractName,  
+                                MetadataExchangeBindings.CreateMexHttpsBinding(),  
+                                "mex");  
+    }  
+    else if (baseAddress.Scheme == Uri.UriSchemeNetPipe)  
+    {  
+        this.AddServiceEndpoint(ServiceMetadataBehavior.MexContractName,  
+                                MetadataExchangeBindings.CreateMexNamedPipeBinding(),  
+                                "mex");  
+    }  
+    else if (baseAddress.Scheme == Uri.UriSchemeNetTcp)  
+    {  
+        this.AddServiceEndpoint(ServiceMetadataBehavior.MexContractName,  
+                                MetadataExchangeBindings.CreateMexTcpBinding(),  
+                                "mex");  
+    }  
+}  
+  
+```  
+  
+## 自己ホストでのカスタム ServiceHost の使用  
+ カスタム ServiceHost の実装が完成したので、これを使用して任意のサービスにメタデータ公開動作を追加できるようになりました。追加するには、`SelfDescribingServiceHost` のインスタンス内でサービスをホストします。  カスタム ServiceHost を自己ホストのシナリオで使用する方法を次のコードに示します。  
+  
+```  
+SelfDescribingServiceHost host =   
+         new SelfDescribingServiceHost( typeof( Calculator ) );  
+host.Open();  
+```  
+  
+ 既定の <xref:System.ServiceModel.ServiceHost> クラスを使用してサービスをホストする場合と同様に、このカスタム ServiceHost も、サービスのエンドポイント構成をアプリケーションの構成ファイルから読み取ります。  ただし、カスタム ホストの内部でメタデータ公開を有効にするというロジックを追加したので、構成の中でメタデータ公開動作を明示的に有効化することは不要になりました。  この方法のメリットがはっきりと現れるのは、開発するアプリケーションに複数のサービスがあり、同じ構成要素を繰り返し記述することなく各サービスでメタデータ公開を有効化できるようにする場合です。  
+  
+## IIS または WAS でのカスタム ServiceHost の使用  
+ カスタム サービス ホストを自己ホストのシナリオで使用することは簡単です。サービス ホストのインスタンスを作成して開くことは、アプリケーションのコードで行うからです。  ただし、IIS または WAS がホストする環境では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のインフラストラクチャが、受信メッセージに応答してサービスのホストを動的にインスタンス化します。  このホスト環境でもカスタム サービス ホストを使用できますが、ServiceHostFactory の形式でコードを追加する必要があります。  次に示すコードは、カスタム `SelfDescribingServiceHost` のインスタンスを返す、<xref:System.ServiceModel.Activation.ServiceHostFactory> の派生クラスの例です。  
+  
+```  
+public class SelfDescribingServiceHostFactory : ServiceHostFactory  
+{  
+    protected override ServiceHost CreateServiceHost(Type serviceType,   
+     Uri[] baseAddresses)  
+    {  
+        //All the custom factory does is return a new instance  
+        //of our custom host class. The bulk of the custom logic should  
+        //live in the custom host (as opposed to the factory)   
+        //for maximum  
+        //reuse value outside of the IIS/WAS hosting environment.  
+        return new SelfDescribingServiceHost(serviceType,     
+                                             baseAddresses);  
+    }  
+}  
+```  
+  
+ 上のコードでわかるように、カスタム ServiceHostFactory の実装は非常に簡単です。  すべてのカスタム ロジックは ServiceHost 実装内部にあり、このファクトリによって派生クラスのインスタンスが返されます。  
+  
+ サービス実装と共にカスタム ファクトリを使用するには、いくつかのメタデータをサービスの .svc ファイルに追加する必要があります。  
+  
+```  
+<%@ServiceHost Service="Microsoft.ServiceModel.Samples.CalculatorService"  
+               Factory="Microsoft.ServiceModel.Samples.SelfDescribingServiceHostFactory"  
+               language=c# Debug="true" %>  
+```  
+  
+ ここでは、`Factory` 属性を `@ServiceHost` ディレクティブに追加し、カスタム ファクトリの CLR 型の名前を属性値として渡しました。  IIS または WAS がこのサービスのメッセージを受信すると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ホスト インフラストラクチャによって最初に ServiceHostFactory のインスタンスが作成され、次に `ServiceHostFactory.CreateServiceHost()` が呼び出されてサービス ホスト自体のインスタンスが作成されます。  
+  
+## サンプルの実行  
+ このサンプルには完全な機能を持つクライアントとサービスの実装が用意されていますが、ここでの目的は、カスタム ホストを使用してサービスのランタイム動作を変更する方法を示すことです。次の手順を実行します。  
+  
+#### カスタム ホストの影響を確認するには  
+  
+1.  サービスの Web.config ファイルを開き、その構成ではサービスのメタデータが明示的には有効にされていないことを確認します。  
+  
+2.  サービスの .svc ファイルを開き、@ServiceHost ディレクティブに Factory 属性があることと、カスタム ServiceHostFactory の名前が指定されていることを確認します。  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  ソリューションがビルドされたら、Setup.bat を実行し、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] で ServiceModelSamples アプリケーションを設定します。  ServiceModelSamples ディレクトリは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] アプリケーションとして表示されます。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+5.  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] アプリケーションを削除するには、Cleanup.bat を実行します。  
+  
+## 参照  
+ [方法 : IIS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-token.md b/docs/framework/wcf/samples/custom-token.md
new file mode 100644
index 00000000000..541c4507dc7
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-token.md
@@ -0,0 +1,651 @@
+---
+title: "カスタム トークン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7fd8b38-c370-454f-ba3e-19759019f03d
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# カスタム トークン
+このサンプルでは、カスタム トークンの実装を [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションに追加する方法を示します。  この例では、`CreditCardToken` を使用して、クライアントのクレジット カードに関する情報をサーバーに安全に渡します。  このトークンは、WS\-Security メッセージ ヘッダー内で渡され、対称セキュリティ バインディング要素を使用してメッセージ本文と他のメッセージ ヘッダーと共に署名および暗号化されます。  これは、組み込みのトークンでは不十分な場合に役立ちます。  このサンプルでは、組み込みのトークンのいずれかを使用する代わりに、カスタム セキュリティ トークンをサービスに提供する方法を示します。  サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルに示されている手順の概要は次のとおりです。  
+  
+-   クライアントがカスタム セキュリティ トークンをサービスに渡す方法。  
+  
+-   サービスがカスタム セキュリティ トークンを使用および検証する方法。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス コードが、カスタム セキュリティ トークンを含む、受信したセキュリティ トークンに関する情報を取得する方法。  
+  
+-   サーバーの X.509 証明書を使用して、メッセージの暗号化や署名に使用する対称キーを保護する方法。  
+  
+## カスタム セキュリティ トークンを使用したクライアント認証  
+ サービスは単一エンドポイントを公開します。エンドポイントは、`BindingHelper` クラスと `EchoServiceHost` クラスを使用してプログラムによって作成されます。  エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。  バインディングは、`SymmetricSecurityBindingElement` と `HttpTransportBindingElement` を使用して、カスタム バインディングとして構成されます。  このサンプルでは、`SymmetricSecurityBindingElement` を設定してサービスの X.509 証明書を使用し、送信中の対称キーを保護して、WS\-Security メッセージ ヘッダー内でカスタム `CreditCardToken` を署名および暗号化されたセキュリティ トークンとして渡します。  この動作により、クライアント認証に使用されるサービス資格情報と、サービス X.509 証明書に関する情報が指定されます。  
+  
+```  
+public static class BindingHelper  
+{  
+    public static Binding CreateCreditCardBinding()  
+    {  
+        HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();  
+  
+        // The message security binding element will be configured to require a credit card.  
+        // The token that is encrypted with the service's certificate.   
+        SymmetricSecurityBindingElement messageSecurity = new SymmetricSecurityBindingElement();  
+        messageSecurity.EndpointSupportingTokenParameters.SignedEncrypted.Add(new CreditCardTokenParameters());  
+        X509SecurityTokenParameters x509ProtectionParameters = new X509SecurityTokenParameters();  
+        x509ProtectionParameters.InclusionMode = SecurityTokenInclusionMode.Never;  
+        messageSecurity.ProtectionTokenParameters = x509ProtectionParameters;  
+        return new CustomBinding(messageSecurity, httpTransport);  
+    }  
+}  
+```  
+  
+ メッセージ内のクレジット カード トークンを使用するため、このサンプルではカスタム サービス資格情報を使用してこの機能を実現します。  サービス資格情報クラスは `CreditCardServiceCredentials` クラス内にあり、`EchoServiceHost.InitializeRuntime` メソッド内のサービス ホストの動作コレクションに追加されます。  
+  
+```  
+class EchoServiceHost : ServiceHost  
+{  
+    string creditCardFile;  
+  
+    public EchoServiceHost(parameters Uri[] addresses)  
+        : base(typeof(EchoService), addresses)  
+    {  
+        creditCardFile = ConfigurationManager.AppSettings["creditCardFile"];  
+        if (string.IsNullOrEmpty(creditCardFile))  
+        {  
+            throw new ConfigurationErrorsException("creditCardFile not specified in service config");  
+        }  
+  
+        creditCardFile = String.Format("{0}\\{1}", System.Web.Hosting.HostingEnvironment.ApplicationPhysicalPath, creditCardFile);  
+  
+    }  
+  
+    override protected void InitializeRuntime()  
+    {  
+        // Create a credit card service credentials and add it to the behaviors.  
+        CreditCardServiceCredentials serviceCredentials = new CreditCardServiceCredentials(this.creditCardFile);  
+        serviceCredentials.ServiceCertificate.SetCertificate("CN=localhost", StoreLocation.LocalMachine, StoreName.My);  
+        this.Description.Behaviors.Remove((typeof(ServiceCredentials)));  
+        this.Description.Behaviors.Add(serviceCredentials);  
+  
+        // Register a credit card binding for the endpoint.  
+        Binding creditCardBinding = BindingHelper.CreateCreditCardBinding();  
+        this.AddServiceEndpoint(typeof(IEchoService), creditCardBinding, string.Empty);  
+  
+        base.InitializeRuntime();  
+    }  
+}  
+  
+```  
+  
+ クライアント エンドポイントは、サービス エンドポイントと同様の方法で構成されます。  クライアントは、同じ `BindingHelper` クラスを使用してバインディングを作成します。  セットアップの残りの部分は、`Client` クラスにあります。  クライアントはさらに、`CreditCardClientCredentials` インスタンスを適切なデータと共にクライアント エンドポイントの動作コレクションに追加することによって、`CreditCardToken` に含まれる情報とサービス X.509 証明書に関する情報をセットアップ コード内に設定します。  サンプルでは、サービス証明書として、サブジェクト名が `CN=localhost` に設定された X.509 証明書を使用しています。  
+  
+```  
+Binding creditCardBinding = BindingHelper.CreateCreditCardBinding();  
+EndpointAddress serviceAddress = new EndpointAddress("http://localhost/servicemodelsamples/service.svc");  
+  
+// Create a client with given client endpoint configuration  
+channelFactory =   
+new ChannelFactory<IEchoService>(creditCardBinding, serviceAddress);  
+  
+// configure the credit card credentials on the channel factory   
+CreditCardClientCredentials credentials =   
+      new CreditCardClientCredentials(  
+      new CreditCardInfo(creditCardNumber, issuer, expirationTime));  
+// configure the service certificate on the credentials  
+credentials.ServiceCertificate.SetDefaultCertificate(  
+      "CN=localhost", StoreLocation.LocalMachine, StoreName.My);  
+  
+// replace ClientCredentials with CreditCardClientCredentials  
+channelFactory.Endpoint.Behaviors.Remove(typeof(ClientCredentials));  
+channelFactory.Endpoint.Behaviors.Add(credentials);  
+  
+client = channelFactory.CreateChannel();  
+  
+Console.WriteLine("Echo service returned: {0}", client.Echo());  
+  
+((IChannel)client).Close();  
+channelFactory.Close();  
+```  
+  
+## カスタム セキュリティ トークンの実装  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でカスタム セキュリティ トークンを有効にするには、カスタム セキュリティ トークンのオブジェクト表現を作成します。  サンプルのこの表現は、`CreditCardToken` クラスにあります。  このオブジェクト表現は、セキュリティ トークンのすべての関連情報を保持し、セキュリティ トークンに含まれるセキュリティ キーのリストを提供します。  この場合、クレジット カード セキュリティ トークンにはセキュリティ キーが含まれません。  
+  
+ 次のセクションでは、カスタム トークンを有効にして通信回線を介して送信し、さらに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイントで使用するために必要な手順について説明します。  
+  
+```  
+class CreditCardToken : SecurityToken  
+{  
+    CreditCardInfo cardInfo;  
+    DateTime effectiveTime = DateTime.UtcNow;  
+    string id;  
+    ReadOnlyCollection<SecurityKey> securityKeys;  
+  
+    public CreditCardToken(CreditCardInfo cardInfo) : this(cardInfo, Guid.NewGuid().ToString()) { }  
+  
+    public CreditCardToken(CreditCardInfo cardInfo, string id)  
+    {  
+        if (cardInfo == null)  
+            throw new ArgumentNullException("cardInfo");  
+  
+        if (id == null)  
+            throw new ArgumentNullException("id");  
+  
+        this.cardInfo = cardInfo;  
+        this.id = id;  
+  
+        // The credit card token is not capable of any cryptography.  
+        this.securityKeys = new ReadOnlyCollection<SecurityKey>(new List<SecurityKey>());  
+    }  
+  
+    public CreditCardInfo CardInfo { get { return this.cardInfo; } }  
+  
+    public override ReadOnlyCollection<SecurityKey> SecurityKeys { get { return this.securityKeys; } }  
+  
+    public override DateTime ValidFrom { get { return this.effectiveTime; } }  
+    public override DateTime ValidTo { get { return this.cardInfo.ExpirationDate; } }  
+    public override string Id { get { return this.id; } }  
+}  
+  
+```  
+  
+## カスタム クレジット カード トークンのメッセージへの提供とメッセージからの取得  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ トークン シリアライザーは、セキュリティ トークンのオブジェクト表現をメッセージの XML から作成するほか、XML 形式のセキュリティ トークンを作成します。  また、セキュリティ トークンを指すキー識別子の読み取りと書き込みなど、他の機能も備えていますが、この例ではセキュリティ トークン関連の機能だけを使用します。  カスタム トークンを有効にするには、独自のセキュリティ トークン シリアライザーを実装する必要があります。  このサンプルでは、この目的のために `CreditCardSecurityTokenSerializer` クラスを使用します。  
+  
+ サービス側では、カスタム シリアライザーは XML 形式のカスタム トークンを読み取り、そこからカスタム トークンのオブジェクト表現を作成します。  
+  
+ クライアント側では、`CreditCardSecurityTokenSerializer` クラスが、セキュリティ トークンのオブジェクト表現に含まれる情報を XML ライターに書き込みます。  
+  
+```  
+public class CreditCardSecurityTokenSerializer : WSSecurityTokenSerializer  
+{  
+    public CreditCardSecurityTokenSerializer(SecurityTokenVersion version) : base() { }  
+  
+    protected override bool CanReadTokenCore(XmlReader reader)  
+    {  
+        XmlDictionaryReader localReader = XmlDictionaryReader.CreateDictionaryReader(reader);  
+  
+        if (reader == null) throw new ArgumentNullException("reader");  
+  
+        if (reader.IsStartElement(Constants.CreditCardTokenName, Constants.CreditCardTokenNamespace))  
+            return true;  
+  
+        return base.CanReadTokenCore(reader);  
+    }  
+  
+    protected override SecurityToken ReadTokenCore(XmlReader reader, SecurityTokenResolver tokenResolver)  
+    {  
+        if (reader == null) throw new ArgumentNullException("reader");  
+  
+        if (reader.IsStartElement(Constants.CreditCardTokenName, Constants.CreditCardTokenNamespace))  
+        {  
+            string id = reader.GetAttribute(Constants.Id, Constants.WsUtilityNamespace);  
+  
+            reader.ReadStartElement();  
+  
+            // Read the credit card number.  
+            string creditCardNumber = reader.ReadElementString(Constants.CreditCardNumberElementName, Constants.CreditCardTokenNamespace);  
+  
+            // Read the expiration date.  
+            string expirationTimeString = reader.ReadElementString(Constants.CreditCardExpirationElementName, Constants.CreditCardTokenNamespace);  
+            DateTime expirationTime = XmlConvert.ToDateTime(expirationTimeString, XmlDateTimeSerializationMode.Utc);  
+  
+            // Read the issuer of the credit card.  
+            string creditCardIssuer = reader.ReadElementString(Constants.CreditCardIssuerElementName, Constants.CreditCardTokenNamespace);  
+            reader.ReadEndElement();  
+  
+            CreditCardInfo cardInfo = new CreditCardInfo(creditCardNumber, creditCardIssuer, expirationTime);  
+  
+            return new CreditCardToken(cardInfo, id);  
+        }  
+        else  
+        {  
+            return WSSecurityTokenSerializer.DefaultInstance.ReadToken(reader, tokenResolver);  
+        }  
+    }  
+  
+    protected override bool CanWriteTokenCore(SecurityToken token)  
+    {  
+        if (token is CreditCardToken)  
+            return true;  
+  
+        else  
+            return base.CanWriteTokenCore(token);  
+    }  
+  
+    protected override void WriteTokenCore(XmlWriter writer, SecurityToken token)  
+    {  
+        if (writer == null) { throw new ArgumentNullException("writer"); }  
+        if (token == null) { throw new ArgumentNullException("token"); }  
+  
+        CreditCardToken c = token as CreditCardToken;  
+        if (c != null)  
+        {  
+            writer.WriteStartElement(Constants.CreditCardTokenPrefix, Constants.CreditCardTokenName, Constants.CreditCardTokenNamespace);  
+            writer.WriteAttributeString(Constants.WsUtilityPrefix, Constants.Id, Constants.WsUtilityNamespace, token.Id);  
+            writer.WriteElementString(Constants.CreditCardNumberElementName, Constants.CreditCardTokenNamespace, c.CardInfo.CardNumber);  
+            writer.WriteElementString(Constants.CreditCardExpirationElementName, Constants.CreditCardTokenNamespace, XmlConvert.ToString(c.CardInfo.ExpirationDate, XmlDateTimeSerializationMode.Utc));  
+            writer.WriteElementString(Constants.CreditCardIssuerElementName, Constants.CreditCardTokenNamespace, c.CardInfo.CardIssuer);  
+            writer.WriteEndElement();  
+            writer.Flush();  
+        }  
+        else  
+        {  
+            base.WriteTokenCore(writer, token);  
+        }  
+    }  
+}  
+```  
+  
+## トークン プロバイダー クラスとトークン認証システム クラスの作成方法  
+ クライアントとサービスの資格情報は、セキュリティ トークン マネージャーのインスタンスを提供します。  セキュリティ トークン マネージャーのインスタンスを使用すると、トークン プロバイダー、トークン認証システム、およびトークン シリアライザーを取得できます。  
+  
+ トークン プロバイダーは、クライアントまたはサービスの資格情報に含まれる情報に基づいて、トークンのオブジェクト表現を作成します。  次に、トークンのオブジェクト表現は、\(前のセクションで説明したとおり\) トークン シリアライザーを使用してメッセージに書き込まれます。  
+  
+ トークン認証システムは、到着したメッセージ内のトークンを検証します。  受信トークンのオブジェクト表現は、トークン シリアライザーによって作成されます。  このオブジェクト表現は、次に、検証のためトークン認証システムに渡されます。  トークンが正常に検証されたら、トークン認証システムは `IAuthorizationPolicy` オブジェクトのコレクションを返します。このオブジェクトはトークンに含まれる情報を表します。  この情報は、承認に関する決定を行ったり、アプリケーションに対するクレームを提供したりするために、後でメッセージ処理中に使用されます。  この例では、クレジット カード トークンの認証システムはこの目的のために `CreditCardTokenAuthorizationPolicy` を使用します。  
+  
+ トークン シリアライザーは、トークンのオブジェクト表現を通信回線に送り、通信回線からトークンのオブジェクト表現を受け取ります。  これについては、前のセクションで説明したとおりです。  
+  
+ このサンプルでは、トークン プロバイダーはクライアントでのみ使用し、トークン認証システムはサービスでのみ使用します。これは、クレジット カード トークンの送信はクライアントからサービスへの方向でのみ行うためです。  
+  
+ クライアント側の機能は `CreditCardClientCrendentials`、`CreditCardClientCredentialsSecurityTokenManager`、および `CreditCardTokenProvider` クラスにあります。  
+  
+ サービス側の機能は `CreditCardServiceCredentials`、`CreditCardServiceCredentialsSecurityTokenManager`、`CreditCardTokenAuthenticator`、および `CreditCardTokenAuthorizationPolicy` クラスにあります。  
+  
+```  
+    public class CreditCardClientCredentials : ClientCredentials  
+    {  
+        CreditCardInfo creditCardInfo;  
+  
+        public CreditCardClientCredentials(CreditCardInfo creditCardInfo)  
+            : base()  
+        {  
+            if (creditCardInfo == null)  
+                throw new ArgumentNullException("creditCardInfo");  
+  
+            this.creditCardInfo = creditCardInfo;  
+        }  
+  
+        public CreditCardInfo CreditCardInfo  
+        {  
+            get { return this.creditCardInfo; }  
+        }  
+  
+        protected override ClientCredentials CloneCore()  
+        {  
+            return new CreditCardClientCredentials(this.creditCardInfo);  
+        }  
+  
+        public override SecurityTokenManager CreateSecurityTokenManager()  
+        {  
+            return new CreditCardClientCredentialsSecurityTokenManager(this);  
+        }  
+    }  
+  
+public class CreditCardClientCredentialsSecurityTokenManager : ClientCredentialsSecurityTokenManager  
+    {  
+        CreditCardClientCredentials creditCardClientCredentials;  
+  
+        public CreditCardClientCredentialsSecurityTokenManager(CreditCardClientCredentials creditCardClientCredentials)  
+            : base (creditCardClientCredentials)  
+        {  
+            this.creditCardClientCredentials = creditCardClientCredentials;  
+        }  
+  
+        public override SecurityTokenProvider CreateSecurityTokenProvider(SecurityTokenRequirement tokenRequirement)  
+        {  
+            // handle this token for Custom  
+            if (tokenRequirement.TokenType == Constants.CreditCardTokenType)  
+                return new CreditCardTokenProvider(this.creditCardClientCredentials.CreditCardInfo);  
+            // return server cert  
+            else if (tokenRequirement is InitiatorServiceModelSecurityTokenRequirement)  
+            {  
+                if (tokenRequirement.TokenType == SecurityTokenTypes.X509Certificate)  
+                {  
+                    return new X509SecurityTokenProvider(creditCardClientCredentials.ServiceCertificate.DefaultCertificate);  
+                }  
+            }  
+  
+            return base.CreateSecurityTokenProvider(tokenRequirement);  
+        }  
+  
+        public override SecurityTokenSerializer CreateSecurityTokenSerializer(SecurityTokenVersion version)  
+        {  
+  
+            return new CreditCardSecurityTokenSerializer(version);  
+        }  
+  
+    }  
+  
+    class CreditCardTokenProvider : SecurityTokenProvider  
+    {  
+        CreditCardInfo creditCardInfo;  
+  
+        public CreditCardTokenProvider(CreditCardInfo creditCardInfo) : base()  
+        {  
+            if (creditCardInfo == null)  
+            {  
+                throw new ArgumentNullException("creditCardInfo");  
+            }  
+            this.creditCardInfo = creditCardInfo;  
+        }  
+  
+        protected override SecurityToken GetTokenCore(TimeSpan timeout)  
+        {  
+            SecurityToken result = new CreditCardToken(this.creditCardInfo);  
+            return result;  
+        }  
+    }  
+  
+public class CreditCardServiceCredentials : ServiceCredentials  
+    {  
+        string creditCardFile;  
+  
+        public CreditCardServiceCredentials(string creditCardFile)  
+            : base()  
+        {   
+            if (creditCardFile == null)  
+                throw new ArgumentNullException("creditCardFile");  
+  
+            this.creditCardFile = creditCardFile;  
+        }  
+  
+        public string CreditCardDataFile  
+        {  
+            get { return this.creditCardFile; }  
+        }  
+  
+        protected override ServiceCredentials CloneCore()  
+        {  
+            return new CreditCardServiceCredentials(this.creditCardFile);  
+        }  
+  
+        public override SecurityTokenManager CreateSecurityTokenManager()  
+        {  
+            return new CreditCardServiceCredentialsSecurityTokenManager(this);  
+        }  
+    }  
+  
+public class CreditCardServiceCredentialsSecurityTokenManager : ServiceCredentialsSecurityTokenManager  
+{  
+        CreditCardServiceCredentials creditCardServiceCredentials;  
+  
+        public CreditCardServiceCredentialsSecurityTokenManager(CreditCardServiceCredentials creditCardServiceCredentials)  
+            : base(creditCardServiceCredentials)  
+        {  
+            this.creditCardServiceCredentials = creditCardServiceCredentials;  
+        }  
+  
+        public override SecurityTokenAuthenticator CreateSecurityTokenAuthenticator(SecurityTokenRequirement tokenRequirement, out SecurityTokenResolver outOfBandTokenResolver)  
+        {  
+            if (tokenRequirement.TokenType == Constants.CreditCardTokenType)  
+            {  
+                outOfBandTokenResolver = null;  
+                return new CreditCardTokenAuthenticator(creditCardServiceCredentials.CreditCardDataFile);  
+            }  
+  
+            return base.CreateSecurityTokenAuthenticator(tokenRequirement, out outOfBandTokenResolver);  
+        }  
+  
+        public override SecurityTokenSerializer CreateSecurityTokenSerializer(SecurityTokenVersion version)  
+        {  
+            return new CreditCardSecurityTokenSerializer(version);  
+        }  
+    }  
+  
+    class CreditCardTokenAuthenticator : SecurityTokenAuthenticator  
+    {  
+        string creditCardsFile;  
+        public CreditCardTokenAuthenticator(string creditCardsFile)  
+        {  
+            this.creditCardsFile = creditCardsFile;  
+        }  
+  
+        protected override bool CanValidateTokenCore(SecurityToken token)  
+        {  
+            return (token is CreditCardToken);  
+        }  
+  
+        protected override ReadOnlyCollection<IAuthorizationPolicy> ValidateTokenCore(SecurityToken token)  
+        {  
+            CreditCardToken creditCardToken = token as CreditCardToken;  
+  
+            if (creditCardToken.CardInfo.ExpirationDate < DateTime.UtcNow)  
+                throw new SecurityTokenValidationException("The credit card has expired");  
+            if (!IsCardNumberAndExpirationValid(creditCardToken.CardInfo))  
+                throw new SecurityTokenValidationException("Unknown or invalid credit card");  
+  
+            // the credit card token has only 1 claim - the card number. The issuer for the claim is the  
+            // credit card issuer  
+  
+            DefaultClaimSet cardIssuerClaimSet = new DefaultClaimSet(new Claim(ClaimTypes.Name, creditCardToken.CardInfo.CardIssuer, Rights.PossessProperty));  
+            DefaultClaimSet cardClaimSet = new DefaultClaimSet(cardIssuerClaimSet, new Claim(Constants.CreditCardNumberClaim, creditCardToken.CardInfo.CardNumber, Rights.PossessProperty));  
+            List<IAuthorizationPolicy> policies = new List<IAuthorizationPolicy>(1);  
+            policies.Add(new CreditCardTokenAuthorizationPolicy(cardClaimSet));  
+            return policies.AsReadOnly();  
+        }  
+  
+        /// <summary>  
+        /// Helper method to check if a given credit card entry is present in the User DB  
+        /// </summary>  
+        private bool IsCardNumberAndExpirationValid(CreditCardInfo cardInfo)  
+        {  
+            try  
+            {  
+                using (StreamReader myStreamReader = new StreamReader(this.creditCardsFile))  
+                {  
+                    string line = "";  
+                    while ((line = myStreamReader.ReadLine()) != null)  
+                    {  
+                        string[] splitEntry = line.Split('#');  
+                        if (splitEntry[0] == cardInfo.CardNumber)  
+                        {  
+                            string expirationDateString = splitEntry[1].Trim();  
+                            DateTime expirationDateOnFile = DateTime.Parse(expirationDateString, System.Globalization.DateTimeFormatInfo.InvariantInfo, System.Globalization.DateTimeStyles.AdjustToUniversal);  
+                            if (cardInfo.ExpirationDate == expirationDateOnFile)  
+                            {  
+                                string issuer = splitEntry[2];  
+                                return issuer.Equals(cardInfo.CardIssuer, StringComparison.InvariantCultureIgnoreCase);  
+                            }  
+                            else  
+                            {  
+                                return false;  
+                            }  
+                        }  
+                    }  
+                    return false;  
+                }  
+            }  
+            catch (Exception e)  
+            {  
+                throw new Exception("BookStoreService: Error while retrieving credit card information from User DB " + e.ToString());  
+            }  
+        }  
+    }  
+  
+    public class CreditCardTokenAuthorizationPolicy : IAuthorizationPolicy  
+    {  
+        string id;  
+        ClaimSet issuer;  
+        IEnumerable<ClaimSet> issuedClaimSets;  
+  
+        public CreditCardTokenAuthorizationPolicy(ClaimSet issuedClaims)  
+        {  
+            if (issuedClaims == null)  
+                throw new ArgumentNullException("issuedClaims");  
+            this.issuer = issuedClaims.Issuer;  
+            this.issuedClaimSets = new ClaimSet[] { issuedClaims };  
+            this.id = Guid.NewGuid().ToString();  
+        }  
+  
+        public ClaimSet Issuer { get { return this.issuer; } }  
+  
+        public string Id { get { return this.id; } }  
+  
+        public bool Evaluate(EvaluationContext context, ref object state)  
+        {  
+            foreach (ClaimSet issuance in this.issuedClaimSets)  
+            {  
+                context.AddClaimSet(this, issuance);  
+            }  
+  
+            return true;  
+        }  
+    }  
+  
+```  
+  
+## 呼び出し元の情報の表示  
+ 呼び出し元の情報を表示するには、次のサンプル コードに示すように `ServiceSecurityContext.Current.AuthorizationContext.ClaimSets` を使用します。  `ServiceSecurityContext.Current.AuthorizationContext.ClaimSets` には、現在の呼び出し元に関連付けられている承認クレームが含まれています。  クレームは、`AuthorizationPolicies` コレクションの `CreditCardToken` クラスによって提供されます。  
+  
+```  
+bool TryGetStringClaimValue(ClaimSet claimSet, string claimType, out string claimValue)  
+{  
+    claimValue = null;  
+    IEnumerable<Claim> matchingClaims = claimSet.FindClaims(claimType,  
+        Rights.PossessProperty);  
+    if (matchingClaims == null)  
+        return false;  
+    IEnumerator<Claim> enumerator = matchingClaims.GetEnumerator();  
+    enumerator.MoveNext();  
+    claimValue = (enumerator.Current.Resource == null) ? null :   
+        enumerator.Current.Resource.ToString();  
+    return true;  
+}  
+  
+string GetCallerCreditCardNumber()  
+{  
+     foreach (ClaimSet claimSet in   
+         ServiceSecurityContext.Current.AuthorizationContext.ClaimSets)  
+     {  
+         string creditCardNumber = null;  
+         if (TryGetStringClaimValue(claimSet,   
+             Constants.CreditCardNumberClaim, out creditCardNumber))  
+             {  
+                 string issuer;  
+                 if (!TryGetStringClaimValue(claimSet.Issuer,  
+                        ClaimTypes.Name, out issuer))  
+                 {  
+                     issuer = "Unknown";  
+                 }  
+                 return String.Format(  
+                   "Credit card '{0}' issued by '{1}'",   
+                   creditCardNumber, issuer);  
+        }  
+    }  
+    return "Credit card is not known";  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする、IIS でホストされるアプリケーションを実行できるようになります。  このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成 :  
+  
+     `Setup.bat` バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  `%SERVER_NAME%`  変数はサーバー名です。  この変数を変更して、使用するサーバー名を指定します。  このバッチ ファイルでの既定は localhost です。  `%SERVER_NAME%` 変数を変更する場合は、Client.cs ファイルと Service.cs ファイル全体を参照して、localhost のすべてのインスタンスを Setup.bat スクリプトで使用するサーバー名に置き換える必要があります。  
+  
+     証明書は、`LocalMachine` ストアの場所の My \(Personal\) ストアに保存されます。  証明書は、IIS でホストされるサービスの LocalMachine ストアに保存されます。  自己ホスト型サービスの場合、バッチ ファイルで文字列 LocalMachine を CurrentUser に置き換えて、クライアント証明書を CurrentUser ストアの場所に保存します。  
+  
+    ```  
+  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+  
+    echo ************  
+    echo copying server cert to client's TrustedPeople store  
+    echo ************  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+  
+    ```  
+  
+-   IIS でホストされるサービスから証明書の秘密キーへのアクセスを有効にするには、IIS でホストされる処理が実行されているユーザー アカウントに、秘密キーへの適切なアクセス許可を付与する必要があります。  これは、Setup.bat スクリプトの最後の手順によって実現されます。  
+  
+    ```  
+    echo ************  
+    echo setting privileges on server certificates  
+    echo ************  
+    for /F "delims=" %%i in ('"%ProgramFiles%\ServiceModelSampleTools\FindPrivateKey.exe" My LocalMachine -n CN^=%SERVER_NAME% -a') do set PRIVATE_KEY_FILE=%%i  
+    set WP_ACCOUNT=NT AUTHORITY\NETWORK SERVICE  
+    (ver | findstr /C:"5.1") && set WP_ACCOUNT=%COMPUTERNAME%\ASPNET  
+    echo Y|cacls.exe "%PRIVATE_KEY_FILE%" /E /G "%WP_ACCOUNT%":R  
+    iisreset  
+    ```  
+  
+> [!NOTE]
+>  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト ウィンドウを開き、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。Makecert.exe が存在するフォルダーがパスに含まれていることを確認します。  
+  
+> [!NOTE]
+>  サンプルの使用が終わったら、Cleanup.bat を実行して証明書を削除してください。  他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+1.  Client.exe を client\\bin ディレクトリで起動します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+2.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サービス コンピューターのサービス ディレクトリにコピーします。  必ず CreditCardFile.txt をコピーしてください。これを行わない場合、クレジット カードの認証システムはクライアントから送信されたクレジット カード情報を検証できません。  Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  コンピューターの完全修飾ドメイン名を含むサブジェクト名を持つサーバー証明書が必要です。  `%SERVER_NAME%` 変数を、サービスがホストされるコンピューターの完全修飾名に変更すると、Setup.bat を使用してこの証明書を作成できます。  Setup.bat ファイルは、管理特権を使用して開いた Visual Studio コマンド プロンプトで実行する必要があります。  
+  
+4.  サーバー証明書をクライアントの CurrentUser\-TrustedPeople ストアにコピーします。  このようにする必要があるのは、サーバー証明書が信頼できる発行元から発行されていない場合のみです。  
+  
+5.  EchoServiceHost.cs ファイルで、証明書のサブジェクト名の値を localhost から完全修飾コンピューター名に変更します。  
+  
+6.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+7.  Client.cs ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+8.  Client.cs ファイルで、サービス X.509 証明書のサブジェクト名を localhost からリモート ホストの完全修飾コンピューター名に変更します。  
+  
+9. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。  
+  
+10. クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/custom-wsdl-publication.md b/docs/framework/wcf/samples/custom-wsdl-publication.md
new file mode 100644
index 00000000000..4a15f73c839
--- /dev/null
+++ b/docs/framework/wcf/samples/custom-wsdl-publication.md
@@ -0,0 +1,320 @@
+---
+title: "カスタム WSDL パブリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b3e8103-2c95-4db3-a05b-46aa8e9d4d29
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# カスタム WSDL パブリケーション
+このサンプルでは、次の方法を示します。  
+  
+-   カスタム <xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName> 属性に <xref:System.ServiceModel.Description.IWsdlExportExtension?displayProperty=fullName> を実装し、属性プロパティを WSDL 注釈としてエクスポートします。  
+  
+-   <xref:System.ServiceModel.Description.IWsdlImportExtension?displayProperty=fullName> を実装し、カスタム WSDL 注釈をインポートします。  
+  
+-   カスタム コントラクトの動作とカスタム操作の動作に、それぞれ <xref:System.ServiceModel.Description.IServiceContractGenerationExtension?displayProperty=fullName> と <xref:System.ServiceModel.Description.IOperationContractGenerationExtension?displayProperty=fullName> を実装し、インポートされたコントラクトと操作の CodeDOM に、インポートされた注釈をコメントとして書き込みます。  
+  
+-   <xref:System.ServiceModel.Description.MetadataExchangeClient?displayProperty=fullName> を使用して WSDL をダウンロードし、<xref:System.ServiceModel.Description.WsdlImporter?displayProperty=fullName> を使用してカスタム WSDL インポータによって WSDL をインポートします。さらに、<xref:System.ServiceModel.Description.ServiceContractGenerator?displayProperty=fullName> を使用して、C\# では \/\/\/、Visual Basic では ''' のコメントとして WSDL 注釈を含む [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント コードを生成します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## サービス  
+ このサンプルのサービスは、2 つのカスタム属性でマークされています。1 つ目の属性は `WsdlDocumentationAttribute` で、この属性を使用するとコントラクタ内で文字列を使用でき、用途を説明する文字列をコントラクト インターフェイスまたは操作に提供するために適用できます。2 つ目は `WsdlParamOrReturnDocumentationAttribute` で、この属性は、操作内で値またはその値を表すパラメータを返すために適用できます。これらの属性を使用して表されたサービス コントラクト `ICalculator` を、次の例に示します。  
+  
+```  
+// Define a service contract.      
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+// Document it.  
+[WsdlDocumentation("The ICalculator contract performs basic calculation services.")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    [WsdlDocumentation("The Add operation adds two numbers and returns the result.")]  
+    [return:WsdlParamOrReturnDocumentation("The result of adding the two arguments together.")]  
+    double Add(  
+      [WsdlParamOrReturnDocumentation("The first value to add.")]double n1,   
+      [WsdlParamOrReturnDocumentation("The second value to add.")]double n2  
+    );  
+  
+    [OperationContract]  
+    [WsdlDocumentation("The Subtract operation subtracts the second argument from the first.")]  
+    [return:WsdlParamOrReturnDocumentation("The result of the second argument subtracted from the first.")]  
+    double Subtract(  
+      [WsdlParamOrReturnDocumentation("The value from which the second is subtracted.")]double n1,   
+      [WsdlParamOrReturnDocumentation("The value that is subtracted from the first.")]double n2  
+    );  
+  
+    [OperationContract]  
+    [WsdlDocumentation("The Multiply operation multiplies two values.")]  
+    [return:WsdlParamOrReturnDocumentation("The result of multiplying the first and second arguments.")]  
+    double Multiply(  
+      [WsdlParamOrReturnDocumentation("The first value to multiply.")]double n1,   
+      [WsdlParamOrReturnDocumentation("The second value to multiply.")]double n2  
+    );  
+  
+    [OperationContract]  
+    [WsdlDocumentation("The Divide operation returns the value of the first argument divided by the second argument.")]  
+    [return:WsdlParamOrReturnDocumentation("The result of dividing the first argument by the second.")]  
+    double Divide(  
+      [WsdlParamOrReturnDocumentation("The numerator.")]double n1,   
+      [WsdlParamOrReturnDocumentation("The denominator.")]double n2  
+    );  
+}  
+  
+```  
+  
+ `WsdlDocumentationAttribute` は <xref:System.ServiceModel.Description.IContractBehavior> と <xref:System.ServiceModel.Description.IOperationBehavior> を実装しています。したがってサービスが開かれている場合は、この属性のインスタンスを、対応する <xref:System.ServiceModel.Description.ContractDescription> または <xref:System.ServiceModel.Description.OperationDescription> に追加できます。この属性は、さらに <xref:System.ServiceModel.Description.IWsdlExportExtension> を実装しています。<xref:System.ServiceModel.Description.IWsdlExportExtension.ExportContract%28System.ServiceModel.Description.WsdlExporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> が呼び出されると、メタデータのエクスポートに使用される <xref:System.ServiceModel.Description.WsdlExporter> と、サービス説明オブジェクトを含む <xref:System.ServiceModel.Description.WsdlContractConversionContext> が、エクスポートされたメタデータの変更を有効にするパラメータとして渡されます。  
+  
+ このサンプルでは、次のコードに示すように、エクスポート コンテキスト オブジェクトに <xref:System.ServiceModel.Description.ContractDescription> または <xref:System.ServiceModel.Description.OperationDescription> のどちらが含まれているかに応じて、そのテキスト プロパティを使用して属性からコメントが抽出され、WSDL 注釈の要素に追加されます。  
+  
+```  
+public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)  
+{  
+    if (contractDescription != null)  
+    {  
+        // Inside this block it is the contract-level comment attribute.  
+        // This.Text returns the string for the contract attribute.  
+        // Set the doc element; if this isn't done first, there is no XmlElement in the   
+        // DocumentElement property.  
+        context.WsdlPortType.Documentation = string.Empty;  
+        // Contract comments.  
+        XmlDocument owner = context.WsdlPortType.DocumentationElement.OwnerDocument;  
+        XmlElement summaryElement = owner.CreateElement("summary");  
+        summaryElement.InnerText = this.Text;  
+        context.WsdlPortType.DocumentationElement.AppendChild(summaryElement);  
+    }  
+    else  
+    {  
+        Operation operation = context.GetOperation(operationDescription);  
+        if (operation != null)  
+        {  
+            // We are dealing strictly with the operation here.  
+            // This.Text returns the string for the operation-level attributes.  
+            // Set the doc element; if this isn't done first, there is no XmlElement in the   
+            // DocumentElement property.  
+            operation.Documentation = String.Empty;  
+  
+            // Operation C# triple comments.  
+            XmlDocument owner = operation.DocumentationElement.OwnerDocument;  
+            XmlElement newSummaryElement = owner.CreateElement("summary");  
+            newSummaryElement.InnerText = this.Text;  
+            operation.DocumentationElement.AppendChild(newSummaryElement);  
+```  
+  
+ 操作がエクスポートされる場合、このサンプルでは次に示すように、リフレクションを使用してパラメータの `WsdlParamOrReturnDocumentationAttribute` 値を取得して返し、次にそれらの値を操作の WSDL 注釈の要素に追加します。  
+  
+```  
+// Get returns information  
+ParameterInfo returnValue = operationDescription.SyncMethod.ReturnParameter;  
+object[] returnAttrs = returnValue.GetCustomAttributes(typeof(WsdlParamOrReturnDocumentationAttribute), false);  
+if (returnAttrs.Length != 0)  
+{  
+    // <returns>text.</returns>  
+    XmlElement returnsElement = owner.CreateElement("returns");  
+    returnsElement.InnerText = ((WsdlParamOrReturnDocumentationAttribute)returnAttrs[0]).ParamComment;  
+    operation.DocumentationElement.AppendChild(returnsElement);  
+}  
+  
+// Get parameter information.  
+ParameterInfo[] args = operationDescription.SyncMethod.GetParameters();  
+for (int i = 0; i < args.Length; i++)  
+{  
+    object[] docAttrs = args[i].GetCustomAttributes(typeof(WsdlParamOrReturnDocumentationAttribute), false);  
+    if (docAttrs.Length == 1)  
+    {  
+        // <param name="Int1">Text.</param>  
+        XmlElement newParamElement = owner.CreateElement("param");  
+        XmlAttribute paramName = owner.CreateAttribute("name");  
+        paramName.Value = args[i].Name;  
+        newParamElement.InnerText = ((WsdlParamOrReturnDocumentationAttribute)docAttrs[0]).ParamComment;  
+        newParamElement.Attributes.Append(paramName);  
+        operation.DocumentationElement.AppendChild(newParamElement);  
+    }  
+}  
+  
+```  
+  
+ その後、サンプルでは次の構成ファイルを使用して、メタデータを標準的な方法で公開します。  
+  
+```  
+<services>  
+  <service   
+      name="Microsoft.ServiceModel.Samples.CalculatorService"  
+      behaviorConfiguration="CalculatorServiceBehavior">  
+    <!-- ICalculator is exposed at the base address provided by host: http://localhost/servicemodelsamples/service.svc  -->  
+    <endpoint address=""  
+              binding="wsHttpBinding"  
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    <!-- the mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex -->  
+    <endpoint address="mex"  
+              binding="mexHttpBinding"  
+              contract="IMetadataExchange" />  
+  </service>  
+</services>  
+  
+<!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+## Svcutil クライアント  
+ このサンプルでは、Svcutil.exe を使用しません。コントラクトは generatedClient.cs ファイルで提供されます。したがって、サンプルでカスタム WSDL のインポートとコードの生成を確認した後で、サービスを呼び出すことができます。次のカスタム WSDL インポータをこのサンプルで使用するには、Svcutil.exe を実行して `/svcutilConfig` オプションを指定します。このオプションは、このサンプルで使用されているクライアント構成ファイルへのパスを示します。また、Svcutil.exe は `WsdlDocumentation.dll` ライブラリを参照します。ただし、`WsdlDocumentationImporter` を読み込むには、Svuctil.exe が `WsdlDocumentation.dll` ライブラリの場所を特定し、これを読み込むことができる必要があります。つまり、このライブラリがグローバル アセンブリ キャッシュに登録されているか、パスに含まれているか、または Svcutil.exe と同じディレクトリにあることが必要です。このサンプルのような基本的なサンプルにおいてこれを行う最も簡単な方法は、Svcutil.exe とクライアント構成ファイルを `WsdlDocumentation.dll` と同じディレクトリにコピーして、そのディレクトリで実行することです。  
+  
+## カスタム WSDL インポータ  
+ カスタム <xref:System.ServiceModel.Description.IWsdlImportExtension> オブジェクトの `WsdlDocumentationImporter` は、<xref:System.ServiceModel.Description.IContractBehavior> と <xref:System.ServiceModel.Description.IOperationBehavior> も実装しています。これらはインポートされた ServiceEndpoints、<xref:System.ServiceModel.Description.IServiceContractGenerationExtension>、および <xref:System.ServiceModel.Description.IOperationContractGenerationExtension> に追加され、コントラクトまたは操作コードが作成されるときにコード生成を変更するために呼び出されます。  
+  
+ サンプルでは、最初に <xref:System.ServiceModel.Description.IWsdlImportExtension.ImportContract%28System.ServiceModel.Description.WsdlImporter%2CSystem.ServiceModel.Description.WsdlContractConversionContext%29> メソッドで、WSDL 注釈がコントラクト レベルまたは操作レベルのどちらにあるかを判断し、適切なスコープで WDSL 注釈自体を動作として追加します。その際、インポートされた注釈テキストをコンストラクタに渡します。  
+  
+```  
+public void ImportContract(WsdlImporter importer, WsdlContractConversionContext context)  
+{  
+    // Contract Documentation  
+    if (context.WsdlPortType.Documentation != null)  
+    {  
+        // System examines the contract behaviors to see whether any implement IWsdlImportExtension.  
+        context.Contract.Behaviors.Add(new WsdlDocumentationImporter(context.WsdlPortType.Documentation));  
+    }  
+    // Operation Documentation  
+    foreach (Operation operation in context.WsdlPortType.Operations)  
+    {  
+        if (operation.Documentation != null)  
+        {  
+            OperationDescription operationDescription = context.Contract.Operations.Find(operation.Name);  
+            if (operationDescription != null)  
+            {  
+                // System examines the operation behaviors to see whether any implement IWsdlImportExtension.  
+                operationDescription.Behaviors.Add(new WsdlDocumentationImporter(operation.Documentation));  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+ その後、コードが生成される際に、システムは <xref:System.ServiceModel.Description.IServiceContractGenerationExtension.GenerateContract%28System.ServiceModel.Description.ServiceContractGenerationContext%29> メソッドと <xref:System.ServiceModel.Description.IOperationContractGenerationExtension.GenerateOperation%28System.ServiceModel.Description.OperationContractGenerationContext%29> メソッドを呼び出し、適切なコンテキスト情報を渡します。サンプルでは、カスタム WSDL 注釈の書式を設定し、コメントとして CodeDom に挿入します。  
+  
+```  
+public void GenerateContract(ServiceContractGenerationContext context)  
+{  
+    Debug.WriteLine("In generate contract.");  
+    context.ContractType.Comments.AddRange(FormatComments(text));  
+}  
+  
+public void GenerateOperation(OperationContractGenerationContext context)  
+{  
+    context.SyncMethod.Comments.AddRange(FormatComments(text));  
+    Debug.WriteLine("In generate operation.");  
+}  
+  
+```  
+  
+## クライアント アプリケーション  
+ クライアント アプリケーションは、アプリケーション構成ファイルにカスタム WSDL インポータを指定することにより、このインポータを読み込みます。  
+  
+```  
+<client>  
+  <endpoint address="http://localhost/servicemodelsamples/service.svc"   
+  binding="wsHttpBinding"   
+  contract="ICalculator" />  
+  <metadata>  
+    <wsdlImporters>  
+      <extension type="Microsoft.ServiceModel.Samples.WsdlDocumentationImporter, WsdlDocumentation"/>  
+    </wsdlImporters>  
+  </metadata>  
+</client>  
+  
+```  
+  
+ カスタム インポータが指定されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メタデータ システムはカスタム インポータを、この目的のために作成された <xref:System.ServiceModel.Description.WsdlImporter> に読み込みます。このサンプルでは、<xref:System.ServiceModel.Description.MetadataExchangeClient> を使用してメタデータをダウンロードし、適切に構成された <xref:System.ServiceModel.Description.WsdlImporter> を使用してサンプルで作成されたカスタム インポータによってメタデータをインポートします。さらに、<xref:System.ServiceModel.Description.ServiceContractGenerator> を使用して、変更されたコントラクト情報を Visual Basic および C\# のクライアント コードにコンパイルします。このコードは Intellisense をサポートする Visual Studio で使用するか、または XML ドキュメントにコンパイルできます。  
+  
+```  
+/// From WSDL Documentation:  
+///   
+/// <summary>The ICalculator contract performs basic calculation   
+/// services.</summary>   
+///   
+[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "3.0.0.0")]  
+[System.ServiceModel.ServiceContractAttribute(Namespace="http://Microsoft.ServiceModel.Samples", ConfigurationName="ICalculator")]  
+public interface ICalculator  
+{  
+  
+    /// From WSDL Documentation:  
+    ///   
+    /// <summary>The Add operation adds two numbers and returns the   
+    /// result.</summary><returns>The result of adding the two arguments   
+    /// together.</returns><param name="n1">The first value to add.</param><param   
+    /// name="n2">The second value to add.</param>   
+    ///   
+    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Add", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/AddResponse")]  
+    double Add(double n1, double n2);  
+  
+    /// From WSDL Documentation:  
+    ///   
+    /// <summary>The Subtract operation subtracts the second argument from the   
+    /// first.</summary><returns>The result of the second argument subtracted from the   
+    /// first.</returns><param name="n1">The value from which the second is   
+    /// subtracted.</param><param name="n2">The value that is subtracted from the   
+    /// first.</param>   
+    ///   
+    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Subtract", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/SubtractResponse")]  
+    double Subtract(double n1, double n2);  
+  
+    /// From WSDL Documentation:  
+    ///   
+    /// <summary>The Multiply operation multiplies two values.</summary><returns>The   
+    /// result of multiplying the first and second arguments.</returns><param   
+    /// name="n1">The first value to multiply.</param><param name="n2">The second value   
+    /// to multiply.</param>   
+    ///   
+    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Multiply", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/MultiplyResponse")]  
+    double Multiply(double n1, double n2);  
+  
+    /// From WSDL Documentation:  
+    ///   
+    /// <summary>The Divide operation returns the value of the first argument divided   
+    /// by the second argument.</summary><returns>The result of dividing the first   
+    /// argument by the second.</returns><param name="n1">The numerator.</param><param   
+    /// name="n2">The denominator.</param>   
+    ///   
+    [System.ServiceModel.OperationContractAttribute(Action="http://Microsoft.ServiceModel.Samples/ICalculator/Divide", ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/DivideResponse")]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Metadata\WsdlDocumentation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/customchannelstester.md b/docs/framework/wcf/samples/customchannelstester.md
new file mode 100644
index 00000000000..7022b5e9923
--- /dev/null
+++ b/docs/framework/wcf/samples/customchannelstester.md
@@ -0,0 +1,79 @@
+---
+title: "CustomChannelTester | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ee1fa307-98b1-4647-8860-2e9217ba6082
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# CustomChannelTester
+`CustomChannelsTester` は、カスタム チャネルの実装を、定義済みのサービス コントラクト セットに対してテストする際に使用できるツールです。  サービス コントラクト セットを選択し、XML ファイルを使用してこのツールに渡すことができます。  これを受け取ったツールは、メッセージ交換中にカスタム チャネル実装をテストするサービスとクライアントを生成します。  
+  
+### ツールをビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  ソリューションをビルドすると、CustomChannelsTester.exe、TestSpec.xml、および SampleRun.cmd の 3 つのファイルが生成されます。  SampleRun.cmd ファイルにはサンプルのコマンド ラインが含まれています。このコマンド ラインでは、このツールを使用して「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルをテストする方法を示します。  
+  
+### ツールを実行するには  
+  
+-   コマンド プロンプトに次のコマンドを入力します。  
+  
+    ```  
+    CustomChannelsTester.exe /binding:YourCustomBindngName /dll:TheAssemblyWhereThisTypeisDefined /testspec:XmlFileNameWhichContainsTestOptions  
+    ```  
+  
+     `/binding` オプションを使用する必要があります。  
+  
+     "binding" が [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] で用意されているシステム指定のバインディングでない場合は、`/dll` が必要です。  
+  
+     `/testspec` は省略可能です。  
+  
+     これにより、テストの仕様とバインディングに基づくサーバーとクライアントが作成されます。  
+  
+     クライアントとサーバーを実行し、結果が返されます。  
+  
+     テストの仕様を説明する XML のサンプルを次に示します \(testspec.xml\)。  
+  
+    ```  
+    <TestSpec xmlns="http://WCF/TestSpec" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata"   
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >  
+    <ServiceContract>  
+    <!-- Test a contract which has oneway / twoway operations. If you set ExpandAll = true, both types of contracts are tested -->    <IsOneWay ExpandAll="true">true</IsOneWay>  
+    <!-- Test a contract with Asynchronous / Synchronous Operations-->  
+        <IsAsync>false</IsAsync>   
+    <!-- Test a sessionful / sessionless contract-->      
+        <IsSession ExpandAll="true">true</IsSession>  
+    <!-- If the Service Contract includes a CallBack Contract-->      
+        <IsCallBack ExpandAll="true">true</IsCallBack>  
+    </ServiceContract>  
+    <TestDetails>  
+    <!-- Name of the machine that runs the server - required if you want to run the test crossmachine-->  
+        <ServerName>ReplaceThisWithTheServerMachineName</ServerName>  
+    <!-- Port Number - Optional-->  
+        <Port>8000</Port>  
+    <!--URI for the callBack address for the CLient. The client will receive the messages from the server on this address in case of a CallBack Contract-->  
+        <ClientCallBackAddress/>      
+    <!-- Duration (in sec) after the server has started, it times out - optional(default = 300sec) -->  
+        <ServerTimeout>300</ServerTimeout>  
+    <!-- Duration (in sec) before the Client initializes -optional(default = 60sec) -->  
+        <ClientTimeout>60</ClientTimeout>  
+    <!-- Number of clients for each service - optional(default = 1) -->  
+        <NumberOfClients>1</NumberOfClients>  
+    <!-- Number of messages each client sends to the service - optional(default = 1) -->  
+        <MessagesPerClient>1</MessagesPerClient>  
+    </TestDetails>  
+    </TestSpec>  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/customdiscoverymetadata.md b/docs/framework/wcf/samples/customdiscoverymetadata.md
new file mode 100644
index 00000000000..a2ca7fc206c
--- /dev/null
+++ b/docs/framework/wcf/samples/customdiscoverymetadata.md
@@ -0,0 +1,45 @@
+---
+title: "CustomDiscoveryMetadata | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c42455fd-3652-4b7e-b698-ab3a2bb52e48
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# CustomDiscoveryMetadata
+このサンプルでは、サービスによって公開される探索可能なエンドポイントの探索メタデータにカスタム XML メタデータを挿入する方法を説明します。  次に、クライアントがサービスを検索してこのカスタム データを抽出する方法を示します。  このサンプルは、2 つのプロジェクト \(サービスとクライアント\) で構成されます。  
+  
+## サービス  
+ サンプルの `main` メソッドでは、<xref:System.Xml.Linq.XElement> 型のオブジェクトに必要なフィールドが設定され、このオブジェクトが <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> に追加されます。  この <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> が特定のエンドポイントに追加されます。  この特定のエンドポイントが探索されると、ここで追加されたカスタム データが探索メタデータに格納されます。  
+  
+## Client  
+ サンプルでは、<xref:System.ServiceModel.Discovery.DiscoveryClient> で <xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> メソッドが呼び出されます。  次に、生成された <xref:System.ServiceModel.Discovery.FindResponse> に対して適切かつ必要な XML 要素が照会されます。  その後、これらの要素がコンソールに出力されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  まず、\[ソリューションの基本ディレクトリ\]\\service\\bin\\debug に生成されたサービス アプリケーションを実行します。次に、\[ソリューションの基本ディレクトリ\]\\Client\\bin\\debug に生成されたクライアント アプリケーションを実行します。  
+  
+3.  サービスがオンラインになると、クライアントはサービスを検索し、エンドポイントで公開されているメタデータを出力します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\DiscoveryExtensibility\CustomDiscoveryMetadata`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/data-binding-in-a-windows-forms-client.md b/docs/framework/wcf/samples/data-binding-in-a-windows-forms-client.md
new file mode 100644
index 00000000000..32e8258d0b8
--- /dev/null
+++ b/docs/framework/wcf/samples/data-binding-in-a-windows-forms-client.md
@@ -0,0 +1,48 @@
+---
+title: "Windows フォーム クライアントのデータ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2a30b37-d6e2-4552-820e-e60b2bbe8829
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# Windows フォーム クライアントのデータ バインディング
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスによって返されたデータを Windows フォーム アプリケーションでバインドする方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、この記事の最後を参照してください。  
+  
+ このサンプルでは、要求\/応答通信パターンを定義するコントラクトを実装するサービスを示します。このサンプルは、クライアントの Windows フォーム アプリケーション \(.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で構成されています。  
+  
+ コントラクトは `IWeatherService` インターフェイスによって定義されます。このインターフェイスでは、`GetWeatherData` という名前の操作が公開されます。この操作は都市名の配列を受け付け、各都市の予想最高気温と最低気温を表す `WeatherData` オブジェクトの配列を返します。  
+  
+ データ バインディングは、Windows フォーム アプリケーションのクライアントで発生します。`DataGridView` は Windows フォーム デザイナで定義し、データをグラフィック表示します。さらに、`BindingSource` という中継局も作成されます。`BindingSource` のデータ ソースは、サービスによって返されるデータ配列に設定されます。`BindingSource` の目的は、データとデータ ビュー間を間接化するレイヤを提供することです。データとの対話 \(移動、並べ替え、フィルタ処理、更新など\) はすべて、`BindingSource` コンポーネントを呼び出すことによって実行します。`DataGridView` へのデータ バインディングを行うには、`DataGridView` の `datasource` を `BindingSource` オブジェクトに設定します。これで、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスから返されるすべてのデータがユーザーに対してグラフィック表示されます。ユーザーがボタンをクリックするたびに、返されたデータはデータ バインドされた `DataGridView` で自動的に更新されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DataBinding\WindowsForms`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/data-binding-in-a-wpf-client.md b/docs/framework/wcf/samples/data-binding-in-a-wpf-client.md
new file mode 100644
index 00000000000..2c65960d5b5
--- /dev/null
+++ b/docs/framework/wcf/samples/data-binding-in-a-wpf-client.md
@@ -0,0 +1,96 @@
+---
+title: "Windows Presentation Foundation クライアントでのデータ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb8c8293-5973-4aef-9b07-afeff5d3293c
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# Windows Presentation Foundation クライアントでのデータ バインディング
+このサンプルでは、Windows Presentation Foundation \(WPF\) クライアントでのデータ バインディングの使用方法を示します。  このサンプルでは、アルバムの配列をランダムに生成してクライアントに返す [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを使用します。  各アルバムには、名前、価格、およびアルバム トラックの一覧が含まれます。  アルバム トラックには、名前と継続時間が含まれます。  サービスによって返される情報は、[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] クライアントが提供するユーザー インターフェイス \(UI\) に自動的にバインドされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ データ バインディングでは、データ ソースを自動的に UI にバインドすることができます。  これによってプログラミング モデルが簡素化されます。プログラムを使って、各 UI 要素をデータ オブジェクトまたはデータ オブジェクトの配列からのデータで更新する必要がないためです。  単一の UI 要素にオブジェクトをバインドしたり、複数の入力情報を取得する `ListBox` などのコントロールに配列をバインドしたりできます。  データを UI 要素の `DataContext` にバインドする方法を次のコードに示します。  
+  
+```  
+// Event handler executed when call is complete  
+void client_GetAlbumListCompleted(object sender, GetAlbumListCompletedEventArgs e)  
+{  
+    // This is on the UI thread, myPanel can be accessed directly  
+    myPanel.DataContext = e.Result;   
+}  
+  
+```  
+  
+ 前のサンプルでは、`myPanel` という `grid` レイアウト要素の `DataContext` が、`GetAlbumList` メソッドによって返されるデータに設定されます。  `DataContext` では、バインディングに使用されるデータ ソースやその他のバインディング特性 \(パスなど\) に関する情報を、要素が親要素から継承できます。  このコード行は、サーバー上のデータが更新されるたびに実行する必要があります。  たとえば、ウィンドウが初期化されたり新しいアルバムが追加されたりするときに実行します。  
+  
+ 次の XAML サンプル コードでは、`ListBox` に `ItemsSource="{Binding }"` を指定します。  
+  
+```  
+<ListBox   
+          ItemTemplate="{StaticResource AlbumStyle}"  
+          ItemsSource="{Binding }"   
+          IsSynchronizedWithCurrentItem="true" />  
+  
+```  
+  
+ これは、最上位の UI 要素にバインドされるデータは、このコントロール \(アルバムの配列\) にもバインドされることを示します。  また、`ItemTemplate="{StaticResource AlbumStyle}"` では、データ テンプレートが `ListBox` の各項目で使用されるように指定されます。  データの書式設定方法を指定するデータ テンプレートを定義することもできます。  こうしたデータ テンプレートは、アプリケーション内の他の UI 要素で再使用できます。この利点は、データ テンプレートを 1 つの場所で定義および維持できることです。  
+  
+ `AlbumStyle` データ テンプレートでは、2 つの並列の `TextBlock` を伴ってグリッドが配置されます。  このうちの 1 つはアルバムの名前を指定し、もう 1 つはアルバムのトラック数を指定します。  
+  
+```  
+<DataTemplate x:Key="AlbumStyle">  
+    <Grid>  
+        <Grid.ColumnDefinitions>  
+            <ColumnDefinition Width="260" />  
+            <ColumnDefinition Width="60" />  
+        </Grid.ColumnDefinitions>  
+        <TextBlock Grid.Column="0" TextContent="{Binding Path=Title}" />  
+        <TextBlock Grid.Column="1" TextContent="{Binding Path=Tracks#.Count}" HorizontalAlignment="Right" />  
+    </Grid>  
+</DataTemplate>  
+  
+```  
+  
+ 2 つ目の `ListBox` を作成する XAML コードを次に示します。  
+  
+```  
+<ListBox Grid.Row="2"   
+            Grid.ColumnSpan="2"   
+            ItemTemplate="{StaticResource TrackStyle}"  
+            ItemsSource="{Binding Path=Tracks}" />  
+  
+```  
+  
+ このコードは、`ItemsSource` のパスを指定します。  これは、このコントロールにバインドされるデータは最上位のデータではなく、`Tracks` という最上位データのプロパティであることを示します。  このプロパティは、アルバムに含まれるトラックの配列を表します。  さらに、`TrackStyle` という別の `DataTemplate` が指定されています。  `TrackStyle` テンプレートのレイアウトは `AlbumStyle` テンプレートのレイアウトに似ていますが、`TextBlock` は別々のプロパティにバインドされます。  これは、2 つのテンプレートが異なるデータ オブジェクトで使用されるためです。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DataBinding\WPFDataBinding`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md b/docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md
new file mode 100644
index 00000000000..f9c58295a94
--- /dev/null
+++ b/docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md
@@ -0,0 +1,48 @@
+---
+title: "ASP.NET クライアントでのデータ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 68b49fa6-94e7-4d4c-a34e-902a2b3770b6
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# ASP.NET クライアントでのデータ バインディング
+このサンプルでは、一般的な [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスによって返されたデータを Web フォーム アプリケーションにバインドする方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、要求\/応答通信パターンを定義するコントラクトを実装するサービスを示します。このサンプルは、ブラウザからアクセスできるクライアントの Web フォーム アプリケーションと、インターネット インフォメーション サービス \(IIS\) によってホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスとで構成されています。  
+  
+ サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。コントラクトは `IWeatherService` インターフェイスによって定義されます。このインターフェイスでは、`GetWeatherData` という名前の操作が公開されます。この操作は都市名の配列を受け付け、各都市の予想最高気温と最低気温を表す `WeatherData` オブジェクトの配列を返します。  
+  
+ [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] クライアントの .aspx ページには DataGrid Web コントロールが定義されています。このコントロールには、サービスによって返されるデータのグラフィック表示が含まれます。.aspx ページのコードによって気象データ用の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが呼び出され、そのデータは `WeatherData` オブジェクトの配列に返されます。DataGrid の `DataSource` プロパティをこの配列に設定することにより、データを取得する場所を指定します。データ バインディングは、DataGrid の `DataBind` メソッドが呼び出されたときに発生します。このすべてのコードは .`aspx` ページの `Page_Load` メソッドに格納されています。したがって、ブラウザのページが更新されるたびに DataGrid 内のデータも更新されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  このサンプルのクライアントは、開発用 Web サーバーで実行される Web サイトです。開発用 Web サーバーを起動するには、コマンド プロンプトで「`%SystemDrive%\Program Files\Common Files\Microsoft Shared\DevServer\9.0\WebDev.WebServer.EXE" /port:8000 /path:<WebFormsSamplePath>\CS\client /vpath:/client`」と入力します。次に、http:\/\/localhost:8000\/client に移動します。このサンプルを複数のコンピューターで実行するには、クライアントの Web.config ファイル内の `localhost` へのすべての参照をサーバーのコンピューター名に置き換えます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DataBinding\WebForms`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/data-binding-scenarios.md b/docs/framework/wcf/samples/data-binding-scenarios.md
new file mode 100644
index 00000000000..c7130516ece
--- /dev/null
+++ b/docs/framework/wcf/samples/data-binding-scenarios.md
@@ -0,0 +1,30 @@
+---
+title: "データ バインドのシナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a2c10dc4-84af-4dab-baee-e9c84ca26ebf
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# データ バインドのシナリオ
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のデータ バインドのシナリオを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [Windows フォーム クライアントのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-a-windows-forms-client.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスによって返されたデータを Windows フォーム アプリケーションでバインドする方法を示します。  
+  
+ [ASP.NET クライアントでのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-an-aspnet-client.md)  
+ 一般的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスによって返されたデータを Web フォーム アプリケーションでバインドする方法を示します。  
+  
+ [Windows Presentation Foundation クライアントでのデータ バインディング](../../../../docs/framework/wcf/samples/data-binding-in-a-wpf-client.md)  
+ [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] クライアントでのデータ バインディングの使用方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/data-contracts.md b/docs/framework/wcf/samples/data-contracts.md
new file mode 100644
index 00000000000..b6fc3254d95
--- /dev/null
+++ b/docs/framework/wcf/samples/data-contracts.md
@@ -0,0 +1,39 @@
+---
+title: "データ コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 941049b6-8e98-497f-ab3f-19848241699f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# データ コントラクト
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のデータ コントラクトを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [基本的なデータ コントラクト](../../../../docs/framework/wcf/samples/basic-data-contract.md)  
+ データ コントラクトを実装する方法を示します。  
+  
+ [DataContractSerializer サンプル](../../../../docs/framework/wcf/samples/datacontractserializer-sample.md)  
+ データ コントラクト クラスに対して一般的なシリアル化および逆シリアル化のサービスを実行する、<xref:System.Runtime.Serialization.DataContractSerializer> を示します。  
+  
+ [既知の型](../../../../docs/framework/wcf/samples/known-types.md)  
+ データ コントラクト内の派生型に関する情報を指定する方法を示します。  
+  
+ [オブジェクト参照](../../../../docs/framework/wcf/samples/object-references.md)  
+ サーバーとクライアント間でオブジェクトを参照渡しする方法を示します。  
+  
+ [POCO サポート](../../../../docs/framework/wcf/samples/poco-support.md)  
+ マークされていない型 \(シリアル化属性が適用されていない型で、POCO \(Plain Old CLR Object\) 型と呼ばれる場合もあります\) のシリアル化のサポートについて説明します。  
+  
+ [シリアル化バインダーの使用](../../../../docs/framework/wcf/samples/usage-of-serialization-binder.md)  
+ このサンプルでは、<xref:System.Runtime.Serialization.SerializationBinder> を使用して、ジェネリック型のバージョンをシリアル化する際に変更する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/datacontract-surrogate.md b/docs/framework/wcf/samples/datacontract-surrogate.md
new file mode 100644
index 00000000000..aec73edee4e
--- /dev/null
+++ b/docs/framework/wcf/samples/datacontract-surrogate.md
@@ -0,0 +1,286 @@
+---
+title: "DataContract サロゲート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0188f3c-00a9-4cf0-a887-a2284c8fb014
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# DataContract サロゲート
+このサンプルでは、シリアル化、逆シリアル化、スキーマのエクスポート、スキーマのインポートなどのプロセスを、データ コントラクト サロゲート クラスを使用してカスタマイズする方法を示します。このサンプルでは、クライアントとサーバーのシナリオ内でサロゲートを使用する方法を示します。このシナリオでは、データがシリアル化され、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントとサービス間で転送が行われます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、次のサービス コントラクトを使用します。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+[AllowNonSerializableTypes]  
+public interface IPersonnelDataService  
+{  
+    [OperationContract]  
+    void AddEmployee(Employee employee);  
+  
+    [OperationContract]  
+    Employee GetEmployee(string name);  
+}  
+```  
+  
+ `AddEmployee` 操作は、ユーザーが新しい従業員に関するデータを追加できるようにし、`GetEmployee` 操作は名前に基づく従業員の検索をサポートします。  
+  
+ これらの操作では、次のデータ型を使用します。  
+  
+```  
+[DataContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+class Employee  
+{  
+    [DataMember]  
+    public DateTime dateHired;  
+  
+    [DataMember]  
+    public Decimal salary;  
+  
+    [DataMember]  
+    public Person person;  
+}  
+  
+```  
+  
+ `Employee` 型では、`Person` クラス \(次のサンプル コードを参照\) は有効なデータ コントラクト クラスではないので、<xref:System.Runtime.Serialization.DataContractSerializer> によってシリアル化できません。  
+  
+```  
+public class Person  
+{  
+    public string firstName;  
+  
+    public string lastName;  
+  
+    public int age;  
+  
+    public Person() { }  
+}  
+```  
+  
+ `DataContract` 属性は `Person` クラスに適用できますが、適用できない場合もあります。たとえば、`Person` クラスは、ユーザーが制御できない別のアセンブリで定義することができます。  
+  
+ このような制限がある場合、`Person` クラスをシリアル化するには、このクラスを `DataContractAttribute` でマークされた別のクラスに置き換え、必要なデータをこの新しいクラスにコピーするという方法があります。この目的は、`Person` クラスを DataContract として <xref:System.Runtime.Serialization.DataContractSerializer> に表示することです。これは、データ コントラクト クラス以外のクラスをシリアル化する 1 つの方法です。  
+  
+ このサンプルでは、 `Person` クラスを `PersonSurrogated` という別のクラスに論理的に置き換えます。  
+  
+```  
+[DataContract(Name="Person", Namespace = "http://Microsoft.ServiceModel.Samples")]  
+public class PersonSurrogated  
+{  
+    [DataMember]  
+    public string FirstName;  
+  
+    [DataMember]  
+    public string LastName;  
+  
+    [DataMember]  
+    public int Age;  
+}  
+  
+```  
+  
+ データ コントラクト サロゲートは、この置き換えを実現するために使用されます。データ コントラクト サロゲートは、<xref:System.Runtime.Serialization.IDataContractSurrogate> を実装するクラスです。このサンプルでは、`AllowNonSerializableTypesSurrogate` クラスがこのインターフェイスを実装しています。  
+  
+ このインターフェイスの実装での最初のタスクは、`Person` から `PersonSurrogated` への型のマップを確立することです。これは、シリアル化の時点およびスキーマをエクスポートする時点の両方で使用されます。このマッピングは、<xref:System.Runtime.Serialization.IDataContractSurrogate.GetDataContractType%28System.Type%29> メソッドを実装することによって実現されます。  
+  
+```  
+public Type GetDataContractType(Type type)  
+{  
+    if (typeof(Person).IsAssignableFrom(type))  
+    {  
+        return typeof(PersonSurrogated);  
+    }  
+    return type;  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetObjectToSerialize%28System.Object%2CSystem.Type%29> メソッドは、シリアル化中に `Person` インスタンスを `PersonSurrogated` インスタンスにマップします。次のサンプル コードを参照してください。  
+  
+```  
+public object GetObjectToSerialize(object obj, Type targetType)  
+{  
+    if (obj is Person)  
+    {  
+        Person person = (Person)obj;  
+        PersonSurrogated personSurrogated = new PersonSurrogated();  
+        personSurrogated.FirstName = person.firstName;  
+        personSurrogated.LastName = person.lastName;  
+        personSurrogated.Age = person.age;  
+        return personSurrogated;  
+    }  
+    return obj;  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate.GetDeserializedObject%28System.Object%2CSystem.Type%29> メソッドは、逆シリアル化のための逆マップを実現します。次のサンプル コードを参照してください。  
+  
+```  
+public object GetDeserializedObject(object obj,   
+Type targetType)  
+{  
+    if (obj is PersonSurrogated)  
+    {  
+        PersonSurrogated personSurrogated = (PersonSurrogated)obj;  
+        Person person = new Person();  
+        person.firstName = personSurrogated.FirstName;  
+        person.lastName = personSurrogated.LastName;  
+        person.age = personSurrogated.Age;  
+        return person;  
+    }  
+    return obj;  
+}  
+  
+```  
+  
+ スキーマのインポート中に `PersonSurrogated` データ コントラクトを既存の `Person` クラスにマップするため、このサンプルでは <xref:System.Runtime.Serialization.IDataContractSurrogate.GetReferencedTypeOnImport%28System.String%2CSystem.String%2CSystem.Object%29> メソッドを実装しています。次のサンプル コードを参照してください。  
+  
+```  
+public Type GetReferencedTypeOnImport(string typeName,   
+               string typeNamespace, object customData)  
+{  
+if (  
+typeNamespace.Equals("http://schemas.datacontract.org/2004/07/DCSurrogateSample")  
+)  
+    {  
+         if (typeName.Equals("PersonSurrogated"))  
+        {  
+             return typeof(Person);  
+        }  
+     }  
+     return null;  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.IDataContractSurrogate> インターフェイスの実装を完了するサンプル コードを次に示します。  
+  
+```  
+public System.CodeDom.CodeTypeDeclaration ProcessImportedType(  
+          System.CodeDom.CodeTypeDeclaration typeDeclaration,   
+          System.CodeDom.CodeCompileUnit compileUnit)  
+{  
+    return typeDeclaration;  
+}  
+public object GetCustomDataToExport(Type clrType,   
+                               Type dataContractType)  
+{  
+    return null;  
+}  
+  
+public object GetCustomDataToExport(  
+System.Reflection.MemberInfo memberInfo, Type dataContractType)  
+{  
+    return null;  
+}  
+public void GetKnownCustomDataTypes(  
+        KnownTypeCollection customDataTypes)  
+{  
+    // It does not matter what we do here.  
+    throw new NotImplementedException();  
+}  
+  
+```  
+  
+ このサンプルでは、`AllowNonSerializableTypesAttribute` という属性により、ServiceModel でサロゲートが有効になります。開発の際には、この属性をサービス コントラクトに適用する必要があります。上の `IPersonnelDataService` サービス コントラクトを参照してください。この属性は `IContractBehavior` を実装し、`ApplyClientBehavior` メソッドと `ApplyDispatchBehavior` メソッドでの操作にサロゲートを設定します。  
+  
+ この場合、この属性は必要ありません。このサンプルでのデモンストレーション用にのみ使用されます。これ以外の方法として、コードまたは構成を使用して同様の `IContractBehavior`、`IEndpointBehavior`、または `IOperationBehavior` を手動で追加することにより、サロゲートを有効にすることもできます。  
+  
+ `IContractBehavior` の実装は、操作に `DataContractSerializerOperationBehavior` が登録されているかどうかをチェックすることにより、DataContract を使用する操作を検索します。登録されている場合は、その動作に `DataContractSurrogate` プロパティが設定されます。この処理を行うサンプル コードを次に示します。この操作にサロゲートが設定されると、シリアル化および逆シリアル化のために動作でサロゲートが有効化されます。  
+  
+```  
+public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.ClientRuntime proxy)  
+{  
+    foreach (OperationDescription opDesc in description.Operations)  
+    {  
+        ApplyDataContractSurrogate(opDesc);  
+    }  
+}  
+  
+public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.DispatchRuntime dispatch)  
+{  
+    foreach (OperationDescription opDesc in description.Operations)  
+    {  
+        ApplyDataContractSurrogate(opDesc);  
+    }  
+}  
+  
+private static void ApplyDataContractSurrogate(OperationDescription description)  
+{  
+    DataContractSerializerOperationBehavior dcsOperationBehavior = description.Behaviors.Find<DataContractSerializerOperationBehavior>();  
+    if (dcsOperationBehavior != null)  
+    {  
+        if (dcsOperationBehavior.DataContractSurrogate == null)  
+            dcsOperationBehavior.DataContractSurrogate = new AllowNonSerializableTypesSurrogate();  
+    }  
+}  
+```  
+  
+ メタデータの生成中にサロゲートをプラグインとして使用するには、追加手順が必要です。これを行うための機構として、このサンプルで示す `IWsdlExportExtension` が用意されています。さらに、`WsdlExporter` を直接変更するという方法もあります。  
+  
+ `AllowNonSerializableTypesAttribute` 属性は `IWsdlExportExtension` と `IContractBehavior` を実装しています。この場合、拡張機能として `IContractBehavior` または `IEndpointBehavior` を使用できます。`IWsdlExportExtension.ExportContract` メソッドの実装は、DataContract のスキーマ生成中に使用される`XsdDataContractExporter` にサロゲートを追加することによって、サロゲートを有効にします。これを行う方法を次のコード スニペットに示します。  
+  
+```  
+public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)  
+{  
+    if (exporter == null)  
+        throw new ArgumentNullException("exporter");  
+  
+    object dataContractExporter;  
+    XsdDataContractExporter xsdDCExporter;  
+    if (!exporter.State.TryGetValue(typeof(XsdDataContractExporter), out dataContractExporter))  
+    {  
+        xsdDCExporter = new XsdDataContractExporter(exporter.GeneratedXmlSchemas);  
+        exporter.State.Add(typeof(XsdDataContractExporter), xsdDCExporter);  
+    }  
+    else  
+    {  
+        xsdDCExporter = (XsdDataContractExporter)dataContractExporter;  
+    }  
+    if (xsdDCExporter.Options == null)  
+        xsdDCExporter.Options = new ExportOptions();  
+  
+    if (xsdDCExporter.Options.DataContractSurrogate == null)  
+        xsdDCExporter.Options.DataContractSurrogate = new AllowNonSerializableTypesSurrogate();  
+}  
+```  
+  
+ サンプルを実行すると、クライアントは AddEmployee の呼び出しに続いて、最初の呼び出しが正常に行われたかどうかをチェックする GetEmployee を呼び出します。GetEmployee の操作要求の結果は、クライアント コンソール ウィンドウに表示されます。GetEmployee 操作では、従業員の検索が正常に行われ、"found" と出力される必要があります。  
+  
+> [!NOTE]
+>  このサンプルでは、シリアル化、逆シリアル化、およびメタデータの生成で、サロゲートをプラグインとして使用する方法を示します。メタデータからコードを生成するためにサロゲートをプラグインとして使用する方法を示すものではありません。クライアント コードの生成にプラグインとしてサロゲートを使用するサンプルについては、「[カスタム WSDL パブリケーション](../../../../docs/framework/wcf/samples/custom-wsdl-publication.md)」のサンプルを参照してください。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\DataContract`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/datacontractresolver.md b/docs/framework/wcf/samples/datacontractresolver.md
new file mode 100644
index 00000000000..7c49b402440
--- /dev/null
+++ b/docs/framework/wcf/samples/datacontractresolver.md
@@ -0,0 +1,181 @@
+---
+title: "DataContractResolver | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c200c02-bc14-4b8d-bbab-9da31185b805
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# DataContractResolver
+このサンプルでは、<xref:System.Runtime.Serialization.DataContractResolver> クラスを使用して、シリアル化プロセスおよび逆シリアル化プロセスをカスタマイズする方法を示します。このサンプルでは、シリアル化および逆シリアル化の際に CLR 型と xsi:type 表現との間にマッピングを行うために DataContractResolver を使用する方法を示します。  
+  
+## サンプルの詳細  
+ サンプルでは、次の CLR 型を定義します。  
+  
+```csharp  
+using System;  
+using System.Runtime.Serialization;  
+  
+namespace Types  
+{  
+    [DataContract]  
+    public class Customer  
+    {  
+        [DataMember]  
+        public string Name { get; set; }  
+    }  
+  
+    [DataContract]  
+    public class VIPCustomer : Customer  
+    {  
+        [DataMember]  
+        public string VipInfo { get; set; }  
+    }  
+  
+    [DataContract]  
+    public class RegularCustomer : Customer  
+    {  
+    }  
+  
+    [DataContract]  
+    public class PreferredVIPCustomer : VIPCustomer  
+    {  
+    }  
+}  
+  
+```  
+  
+ サンプルでは、このアセンブリを読み込み、これらの各型を抽出して、型をシリアル化および逆シリアル化します。次の例で示すように、<xref:System.Runtime.Serialization.DataContractResolver> は <xref:System.Runtime.Serialization.DataContractResolver> 派生クラスのインスタンスを <xref:System.Runtime.Serialization.DataContractSerializer> コンストラクターに渡すことによってシリアル化プロセスに追加されます。  
+  
+```csharp  
+this.serializer = new DataContractSerializer(typeof(Object), null, int.MaxValue, false, true, null, new MyDataContractResolver(assembly));  
+  
+```  
+  
+ 次のコード例に示すように、サンプルでは CLR 型をシリアル化しています。  
+  
+```csharp  
+Assembly assembly = Assembly.Load(new AssemblyName("Types"));  
+  
+public void serialize(Type type)  
+{  
+    Object instance = Activator.CreateInstance(type);  
+  
+    Console.WriteLine("----------------------------------------");  
+    Console.WriteLine();  
+    Console.WriteLine("Serializing type: {0}", type.Name);  
+    Console.WriteLine();  
+    this.buffer = new StringBuilder();  
+    using (XmlWriter xmlWriter = XmlWriter.Create(this.buffer))  
+    {  
+        try  
+        {  
+            this.serializer.WriteObject(xmlWriter, instance);  
+        }  
+        catch (SerializationException error)  
+        {  
+            Console.WriteLine(error.ToString());  
+        }  
+    }  
+    Console.WriteLine(this.buffer.ToString());  
+}  
+  
+```  
+  
+ 次のコード例に示すように、サンプルでは xsi:types を逆シリアル化しています。  
+  
+```csharp  
+public void deserialize(Type type)  
+{  
+    Console.WriteLine();  
+    Console.WriteLine("Deserializing type: {0}", type.Name);  
+    Console.WriteLine();  
+    using (XmlReader xmlReader = XmlReader.Create(new StringReader(this.buffer.ToString())))  
+    {  
+        Object obj = this.serializer.ReadObject(xmlReader);  
+    }  
+}  
+  
+```  
+  
+ カスタム <xref:System.Runtime.Serialization.DataContractResolver> は <xref:System.Runtime.Serialization.DataContractSerializer> コンストラクターに渡されるため、CLR 型を同等の `xsi:type` にマッピングするためのシリアル化時に <xref:System.Runtime.Serialization.DataContractResolver.TryResolveType%2A> が呼び出されます。同様に、`xsi:type` を同等の CLR 型にマッピングするための逆シリアル化時に <xref:System.Runtime.Serialization.DataContractResolver.ResolveName%2A> が呼び出されます。このサンプルでは、<xref:System.Runtime.Serialization.DataContractResolver> は、次の例のように定義されます。  
+  
+ <xref:System.Runtime.Serialization.DataContractResolver> から派生するクラスのコード例を次に示します。  
+  
+```  
+class MyDataContractResolver : DataContractResolver  
+{  
+    private Dictionary<string, XmlDictionaryString> dictionary = new Dictionary<string, XmlDictionaryString>();  
+    Assembly assembly;  
+  
+    public MyDataContractResolver(Assembly assembly)  
+    {  
+        this.assembly = assembly;  
+    }  
+  
+    // Used at deserialization  
+    // Allows users to map xsi:type name to any Type   
+    public override Type ResolveName(string typeName, string typeNamespace, DataContractResolver knownTypeResolver)  
+    {  
+        XmlDictionaryString tName;  
+        XmlDictionaryString tNamespace;  
+        if (dictionary.TryGetValue(typeName, out tName) && dictionary.TryGetValue(typeNamespace, out tNamespace))  
+        {  
+            return this.assembly.GetType(tNamespace.Value + "." + tName.Value);  
+        }  
+        else  
+        {  
+            return null;  
+        }  
+    }  
+  
+    // Used at serialization  
+    // Maps any Type to a new xsi:type representation  
+    public override void ResolveType(Type dataContractType, DataContractResolver knownTypeResolver, out XmlDictionaryString typeName, out XmlDictionaryString typeNamespace)  
+    {  
+        string name = dataContractType.Name;  
+        string namesp = dataContractType.Namespace;  
+        typeName = new XmlDictionaryString(XmlDictionary.Empty, name, 0);   
+        typeNamespace = new XmlDictionaryString(XmlDictionary.Empty, namesp, 0);  
+        if (!dictionary.ContainsKey(dataContractType.Name))  
+        {  
+            dictionary.Add(name, typeName);  
+        }  
+        if (!dictionary.ContainsKey(dataContractType.Namespace))  
+        {  
+            dictionary.Add(namesp, typeNamespace);  
+        }  
+    }  
+}  
+  
+```  
+  
+ サンプルの一部として、Types プロジェクトでは、このサンプルで使用するすべての型を含むアセンブリが生成されます。このプロジェクトは、シリアル化される型を追加、削除、または変更するために使用します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、DCRSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\DataContractResolver`  
+  
+## 参照  
+ [データ コントラクト リゾルバーの使用](../../../../docs/framework/wcf/feature-details/using-a-data-contract-resolver.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/datacontractserializer-datacontractresolver-netdatacontractserializer.md b/docs/framework/wcf/samples/datacontractserializer-datacontractresolver-netdatacontractserializer.md
new file mode 100644
index 00000000000..ef18eb14dec
--- /dev/null
+++ b/docs/framework/wcf/samples/datacontractserializer-datacontractresolver-netdatacontractserializer.md
@@ -0,0 +1,93 @@
+---
+title: "DataContractSerializer と DataContractResolver を使用した NetDataContractSerializer 機能の提供 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1376658f-f695-45f7-a7e0-94664e9619ff
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# DataContractSerializer と DataContractResolver を使用した NetDataContractSerializer 機能の提供
+このサンプルでは、<xref:System.Runtime.Serialization.DataContractSerializer> を適切な <xref:System.Runtime.Serialization.DataContractResolver> と共に使用して、<xref:System.Runtime.Serialization.NetDataContractSerializer> と同じ機能を提供する方法を示します。このサンプルで示すのは、<xref:System.Runtime.Serialization.DataContractResolver> を作成して <xref:System.Runtime.Serialization.DataContractSerializer> に追加する方法です。  
+  
+## サンプルの詳細  
+ <xref:System.Runtime.Serialization.NetDataContractSerializer> は、1 つの重要な点で <xref:System.Runtime.Serialization.DataContractSerializer> とは異なります。<xref:System.Runtime.Serialization.NetDataContractSerializer> はシリアル化された XML の中に CLR 型情報を含みますが、<xref:System.Runtime.Serialization.DataContractSerializer> にはこの情報は含まれません。したがって、<xref:System.Runtime.Serialization.NetDataContractSerializer> は、シリアル化と逆シリアル化の両方で、同一の CLR 型を共有する結果になる場合のみ使用できます。ただし、<xref:System.Runtime.Serialization.NetDataContractSerializer> よりも優れたパフォーマンスが得られるため、<xref:System.Runtime.Serialization.DataContractSerializer> を使用することをお勧めします。<xref:System.Runtime.Serialization.DataContractResolver> を追加することによって、<xref:System.Runtime.Serialization.DataContractSerializer> でシリアル化される情報を変更することができます。  
+  
+ このサンプルは、2 つのプロジェクトで構成されます。最初のプロジェクトでは、<xref:System.Runtime.Serialization.NetDataContractSerializer> を使用してオブジェクトをシリアル化します。2 番目のプロジェクトでは、<xref:System.Runtime.Serialization.DataContractSerializer> を <xref:System.Runtime.Serialization.DataContractResolver> と共に使用して、最初のプロジェクトと同じ機能を提供します。  
+  
+ 次のコード例では、DCSwithDCR プロジェクトの <xref:System.Runtime.Serialization.DataContractSerializer> に追加される `MyDataContractResolver` という名前のカスタム <xref:System.Runtime.Serialization.DataContractResolver> の実装を示します。  
+  
+```  
+class MyDataContractResolver : DataContractResolver  
+{  
+    private XmlDictionary dictionary = new XmlDictionary();  
+  
+    public MyDataContractResolver()  
+    {  
+    }  
+  
+    // Used at deserialization  
+    // Allows users to map xsi:type name to any Type   
+    public override Type ResolveName(string typeName, string typeNamespace, DataContractResolver knownTypeResolver)  
+    {  
+        Type type = knownTypeResolver.ResolveName(typeName, typeNamespace, null);  
+        if (type == null)  
+        {  
+            type = Type.GetType(typeName + ", " + typeNamespace);  
+        }  
+        return type;  
+    }  
+  
+    // Used at serialization  
+    // Maps any Type to a new xsi:type representation  
+    public override void ResolveType(Type dataContractType, DataContractResolver knownTypeResolver, out XmlDictionaryString typeName, out XmlDictionaryString typeNamespace)  
+    {  
+        knownTypeResolver.ResolveType(dataContractType, null, out typeName, out typeNamespace);  
+        if (typeName == null || typeNamespace == null)  
+        {  
+            XmlDictionary dictionary = new XmlDictionary();  
+            typeName = dictionary.Add(dataContractType.FullName);  
+            typeNamespace = dictionary.Add(dataContractType.Assembly.FullName);  
+        }  
+    }  
+}  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、DCRSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューション ファイルを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+3.  **\[ソリューション プロパティ ページ\]** ダイアログ ボックスの **\[共通プロパティ\]** の **\[スタートアップ プロジェクト\]** で、**\[マルチ スタートアップ プロジェクト\]** を選択します。  
+  
+4.  **DCSwithDCR** プロジェクトの横にある **\[アクション\]** ボックスの一覧から **\[開始\]** を選択します。  
+  
+5.  **NetDCS** プロジェクトの横にある **\[アクション\]** ボックスの一覧の **\[開始\]** をクリックします。  
+  
+6.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+7.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+8.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\NetDcSasDcSwithDCR`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/datacontractserializer-sample.md b/docs/framework/wcf/samples/datacontractserializer-sample.md
new file mode 100644
index 00000000000..67af776176a
--- /dev/null
+++ b/docs/framework/wcf/samples/datacontractserializer-sample.md
@@ -0,0 +1,158 @@
+---
+title: "DataContractSerializer サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "XML フォーマッタ"
+ms.assetid: e0a2fe89-3534-48c8-aa3c-819862224571
+caps.latest.revision: 37
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 37
+---
+# DataContractSerializer サンプル
+DataContractSerializer サンプルでは、<xref:System.Runtime.Serialization.DataContractSerializer> を示して、データ コントラクト クラスに対応した一般的なシリアル化および逆シリアル化の各サービスを実行します。  このサンプルでは <xref:System.Runtime.Serialization.DataContractSerializer> の使用方法を示すため、`Record` オブジェクトを作成してメモリ ストリームにシリアル化し、次にそのメモリ ストリームを別の `Record` オブジェクトに逆シリアル化します。  サンプルではその後、バイナリ ライタを使用して `Record` オブジェクトをシリアル化し、バイナリ ライタがシリアル化にどのように影響するかを示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ `Record` のデータ コントラクトを次のサンプル コードに示します。  
+  
+```  
+[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+internal class Record  
+{  
+    private double n1;  
+    private double n2;  
+    private string operation;  
+    private double result;  
+  
+    internal Record(double n1, double n2, string operation, double result)  
+    {  
+        this.n1 = n1;  
+        this.n2 = n2;  
+        this.operation = operation;  
+        this.result = result;  
+    }  
+  
+    [DataMember]  
+    internal double OperandNumberOne  
+    {  
+        get { return n1; }  
+        set { n1 = value; }  
+    }  
+  
+    [DataMember]  
+    internal double OperandNumberTwo  
+    {  
+        get { return n2; }  
+        set { n2 = value; }  
+    }  
+  
+    [DataMember]  
+    internal string Operation  
+    {  
+        get { return operation; }  
+        set { operation = value; }  
+    }  
+  
+    [DataMember]  
+    internal double Result  
+    {  
+        get { return result; }  
+        set { result = value; }  
+    }  
+  
+    public override string ToString()  
+    {  
+        return string.Format("Record: {0} {1} {2} = {3}", n1,  
+            operation, n2, result);  
+    }  
+}  
+```  
+  
+ このサンプル コードは `record1` という `Record` オブジェクトを作成し、これを表示します。  
+  
+```  
+Record record1 = new Record(1, 2, "+", 3);  
+Console.WriteLine("Original record: {0}", record1.ToString());  
+  
+```  
+  
+ 次に、<xref:System.Runtime.Serialization.DataContractSerializer> を使用して `record1` をメモリ ストリームにシリアル化します。  
+  
+```  
+MemoryStream stream1 = new MemoryStream();  
+  
+//Serialize the Record object to a memory stream using DataContractSerializer.  
+DataContractSerializer serializer = new DataContractSerializer(typeof(Record));  
+serializer.WriteObject(stream1, record1);  
+  
+```  
+  
+ さらに、<xref:System.Runtime.Serialization.DataContractSerializer> を使用してメモリ ストリームを新しい `Record` オブジェクトに逆シリアル化し、これを表示します。  
+  
+```  
+stream1.Position = 0;  
+  
+//Deserialize the Record object back into a new record object.  
+Record record2 = (Record)serializer.ReadObject(stream1);  
+  
+Console.WriteLine("Deserialized record: {0}", record2.ToString());  
+  
+```  
+  
+ 既定では、`DataContractSerializer` は XML のテキスト表現を使用して、オブジェクトをストリームにエンコードします。  ただし、別のライタを渡すことによって XML のエンコーディングを制御できます。  このサンプルでは、<xref:System.Xml.XmlDictionaryWriter.CreateBinaryWriter%2A> を呼び出してバイナリ ライタを作成します。  その後、<xref:System.Runtime.Serialization.DataContractSerializer.WriteObjectContent%2A> を呼び出す際に、このライタと Record オブジェクトをシリアライザに渡します。  最後に、ライタをフラッシュしてストリームの長さを報告します。  
+  
+```  
+MemoryStream stream2 = new MemoryStream();  
+  
+XmlDictionaryWriter binaryDictionaryWriter = XmlDictionaryWriter.CreateBinaryWriter(stream2);  
+serializer.WriteObject(binaryDictionaryWriter, record1);  
+binaryDictionaryWriter.Flush();  
+  
+//report the length of the streams  
+Console.WriteLine("Text Stream is {0} bytes long", stream1.Length);  
+Console.WriteLine("Binary Stream is {0} bytes long", stream2.Length);  
+```  
+  
+ このサンプルを実行すると、元の Record オブジェクトと逆シリアル化された Record オブジェクトが表示され、続いてテキスト エンコーディングの長さとバイナリ エンコーディングの長さとが比較されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Original record: Record: 1 + 2 = 3  
+Deserialized record: Record: 1 + 2 = 3  
+Text Stream is 233 bytes long  
+Binary Stream is 156 bytes long  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  このサンプルを実行するには、コマンド プロンプトで「client\\bin\\client.exe」と入力してクライアントを開始します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\DataContractSerializer`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/dead-letter-queues.md b/docs/framework/wcf/samples/dead-letter-queues.md
new file mode 100644
index 00000000000..a8e555d37c1
--- /dev/null
+++ b/docs/framework/wcf/samples/dead-letter-queues.md
@@ -0,0 +1,378 @@
+---
+title: "配信不能キュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ff664f33-ad02-422c-9041-bab6d993f9cc
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# 配信不能キュー
+このサンプルでは、配信できなかったメッセージの処理方法を示します。  これは、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」のサンプルに基づいています。  このサンプルでは、`netMsmqBinding` バインディングを使用します。  サービスは自己ホスト型コンソール アプリケーションであるので、キューに置かれたメッセージをサービスが受信するようすを観察できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!NOTE]
+>  このサンプルで示す各アプリケーションの配信不能キューは、[!INCLUDE[wv](../../../../includes/wv-md.md)] でのみ使用が可能です。  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] と [!INCLUDE[wxp](../../../../includes/wxp-md.md)] では、MSMQ 3.0 の既定のシステム全体用のキューを使用するようにサンプルを変更してください。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。  厳密には、クライアントはメッセージをキューに送信します。  サービスは、メッセージをキューから受信します。  したがって、キューを使用する通信では、サービスとクライアントが同時に実行されていなくてもかまいません。  
+  
+ キューを使用する通信では一定の活動停止状態が生じるので、メッセージの有効期間を設定して、有効期間経過後はメッセージをアプリケーションに配信しないようにすることが必要になる場合があります。  また、アプリケーションによっては、メッセージの配信が失敗したかどうかを通知する必要があります。  このような場合に、メッセージの有効期間が経過すると、あるいはメッセージの配信に失敗すると、メッセージは配信不能キューに置かれます。  このとき、送信元のアプリケーションは、配信不能キューに置かれたメッセージを読み取って修正処理を行います。修正処理とは、何も行わない場合から、配信失敗の原因を解消してメッセージを再送信する場合までさまざまです。  
+  
+ `NetMsmqBinding` バインディングの配信不能キューは、次のプロパティとして表されます。  
+  
+-   <xref:System.ServiceModel.MsmqBindingBase.DeadLetterQueue%2A> プロパティは、クライアントが必要とする配信不能キューの種類を表します。  この列挙体には、次の値があります。  
+  
+-   `None` : クライアントは配信不能キューを必要としません。  
+  
+-   `System`: システムの配信不能キューを使用して配信不能メッセージを保存します。  システムの配信不能キューは、そのコンピューターで実行されているすべてのアプリケーションで共有されます。  
+  
+-   `Custom`: <xref:System.ServiceModel.MsmqBindingBase.CustomDeadLetterQueue%2A> プロパティで指定されるカスタムの配信不能キューを使用して配信不能メッセージを保存します。  この機能は、[!INCLUDE[wv](../../../../includes/wv-md.md)] でのみ使用できます。  同じコンピューターで実行されている他のアプリケーションとキューを共有するのではなく、そのアプリケーション専用の配信不能キューが必要な場合に、この値を使用します。  
+  
+-   <xref:System.ServiceModel.MsmqBindingBase.CustomDeadLetterQueue%2A> プロパティは、配信不能キューとして使用される特定のキューを表します。  このプロパティは [!INCLUDE[wv](../../../../includes/wv-md.md)] でのみ使用できます。  
+  
+ このサンプルでは、クライアントがトランザクションのスコープ内からメッセージをまとめてサービスに送信しますが、メッセージの "有効期間" には意図的に小さい値 \(約 2 秒\) を指定しています。  さらに、有効期限切れのメッセージを入れるために使用するカスタムの配信不能キューを指定します。  
+  
+ クライアント アプリケーションは、配信不能キューからメッセージを読み取った後で、そのメッセージの再送信を試みるか、元のメッセージが配信不能となった原因のエラーを解消してメッセージを送信します。  このサンプルでは、クライアントはエラー メッセージを表示します。  
+  
+ サービス コントラクトは `IOrderProcessor` です。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void SubmitPurchaseOrder(PurchaseOrder po);  
+}  
+  
+```  
+  
+ サンプルのサービス コードは「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」のコードです。  
+  
+ サービスとの通信はトランザクションのスコープ内で実行されます。  サービスはキューからメッセージを読み取って操作を実行し、操作の結果を表示します。  このアプリケーションでは、配信不能メッセージ用の配信不能キューも作成します。  
+  
+```  
+//The service contract is defined in generatedClient.cs, generated from the service by the svcutil tool.  
+  
+//Client implementation code.  
+class Client  
+{  
+    static void Main()  
+    {  
+        // Get MSMQ queue name from app settings in configuration  
+        string deadLetterQueueName = ConfigurationManager.AppSettings["deadLetterQueueName"];  
+  
+        // Create the transacted MSMQ queue for storing dead message if necessary.  
+        if (!MessageQueue.Exists(deadLetterQueueName))  
+            MessageQueue.Create(deadLetterQueueName, true);  
+  
+        // Create a proxy with given client endpoint configuration  
+        OrderProcessorClient client = new OrderProcessorClient("OrderProcessorEndpoint");  
+  
+        // Create the purchase order  
+        PurchaseOrder po = new PurchaseOrder();  
+        po.CustomerId = "somecustomer.com";  
+        po.PONumber = Guid.NewGuid().ToString();  
+  
+        PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+        lineItem1.ProductId = "Blue Widget";  
+        lineItem1.Quantity = 54;  
+        lineItem1.UnitCost = 29.99F;  
+  
+        PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+        lineItem2.ProductId = "Red Widget";  
+        lineItem2.Quantity = 890;  
+        lineItem2.UnitCost = 45.89F;  
+  
+        po.orderLineItems = new PurchaseOrderLineItem[2];  
+        po.orderLineItems[0] = lineItem1;  
+        po.orderLineItems[1] = lineItem2;  
+  
+        //Create a transaction scope.  
+        using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+        {  
+            // Make a queued call to submit the purchase order  
+            client.SubmitPurchaseOrder(po);  
+            // Complete the transaction.  
+            scope.Complete();  
+        }  
+  
+        client.Close();  
+  
+        Console.WriteLine();  
+        Console.WriteLine("Press <ENTER> to terminate client.");  
+        Console.ReadLine();  
+    }  
+}  
+```  
+  
+ クライアントの構成では、メッセージがサービスに到達するまでの時間が短く設定されています。  指定された時間内にメッセージを送信できなかった場合は、メッセージが有効期限切れとなり、配信不能キューに移動します。  
+  
+> [!NOTE]
+>  クライアントがメッセージを指定時間内にサービス キューに配信できる場合もあります。  配信不能サービスが動作していることを確認するには、サービスを開始する前にクライアントを実行してみてください。  メッセージはタイムアウトして、配信不能サービスに配信されます。  
+  
+ アプリケーションでは、どのキューを配信不能キューとして使用するかを定義する必要があります。  キューが指定されていない場合は、既定のシステム全体のトランザクション配信不能キューが使用されます。  この例のクライアント アプリケーションは、アプリケーション専用の配信不能キューを指定します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <appSettings>  
+    <!-- use appSetting to configure MSMQ Dead Letter queue name -->  
+    <add key="deadLetterQueueName" value=".\private$\ServiceModelSamplesOrdersAppDLQ"/>  
+  </appSettings>  
+  
+  <system.serviceModel>  
+    <client>  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint name="OrderProcessorEndpoint"  
+                address="net.msmq://localhost/private/ServiceModelSamplesDeadLetter"   
+                binding="netMsmqBinding"   
+                bindingConfiguration="PerAppDLQBinding"   
+                contract="IOrderProcessor" />  
+    </client>  
+  
+    <bindings>  
+      <netMsmqBinding>  
+        <binding name="PerAppDLQBinding"  
+                 deadLetterQueue="Custom"  
+                 customDeadLetterQueue="net.msmq://localhost/private/ServiceModelSamplesOrdersAppDLQ"   
+                 timeToLive="00:00:02"/>  
+      </netMsmqBinding>  
+    </bindings>  
+  </system.serviceModel>  
+  
+</configuration>  
+  
+```  
+  
+ 配信不能メッセージ サービスは、メッセージを配信不能キューから読み取ります。  この配信不能メッセージ サービスは、`IOrderProcessor` コントラクトを実装します。  ただし、この実装は注文を処理するためのものではありません。  配信不能メッセージ サービスはクライアント サービスの 1 つで、注文処理機能は含まれていません。  
+  
+> [!NOTE]
+>  配信不能キューはクライアント キューであり、クライアントのキュー マネージャに対してローカルです。  
+  
+ 配信不能メッセージ サービスの実装の中で、メッセージの配信に失敗した原因を調べて修正処理を実行します。  メッセージ配信失敗の原因は、<xref:System.ServiceModel.Channels.MsmqMessageProperty.DeliveryFailure%2A> と <xref:System.ServiceModel.Channels.MsmqMessageProperty.DeliveryStatus%2A> の 2 つの列挙体に記録されます。  <xref:System.ServiceModel.Channels.MsmqMessageProperty> は <xref:System.ServiceModel.OperationContext> から取得できます。次のサンプル コードを参照してください。  
+  
+```  
+public void SubmitPurchaseOrder(PurchaseOrder po)  
+{  
+    Console.WriteLine("Submitting purchase order did not succed ", po);  
+    MsmqMessageProperty mqProp =   
+                  OperationContext.Current.IncomingMessageProperties[  
+                  MsmqMessageProperty.Name] as MsmqMessageProperty;  
+    Console.WriteLine("Message Delivery Status: {0} ",   
+                                                mqProp.DeliveryStatus);  
+    Console.WriteLine("Message Delivery Failure: {0}",   
+                                               mqProp.DeliveryFailure);  
+    Console.WriteLine();  
+    ….  
+}  
+  
+```  
+  
+ 配信不能キューの中のメッセージは、メッセージを処理するサービス宛てのメッセージです。  そのため、配信不能メッセージ サービスがキューからメッセージを読み取ったときに、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のチャネル レイヤによってエンドポイントの不一致が検出され、メッセージはディスパッチされません。  この場合、メッセージの宛先は注文処理サービスですが、受信するのは配信不能メッセージ サービスです。  別のエンドポイント宛てのメッセージを受信するには、どのアドレスにも一致するアドレス フィルタを `ServiceBehavior` で指定します。  これは、配信不能キューから読み取ったメッセージを正常に処理するために必要です。  
+  
+ このサンプルでは、配信失敗の原因がメッセージのタイムアウトならば、配信不能メッセージ サービスはメッセージを再送信します。  他の原因の場合は、配信エラーを表示します。次のサンプル コードを参照してください。  
+  
+```  
+// Service class that implements the service contract.  
+// Added code to write output to the console window.  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.Single, ConcurrencyMode=ConcurrencyMode.Single, AddressFilterMode=AddressFilterMode.Any)]  
+public class PurchaseOrderDLQService : IOrderProcessor  
+{  
+    OrderProcessorClient orderProcessorService;  
+    public PurchaseOrderDLQService()  
+    {  
+        orderProcessorService = new OrderProcessorClient("OrderProcessorEndpoint");  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public void SubmitPurchaseOrder(PurchaseOrder po)  
+    {  
+        Console.WriteLine("Submitting purchase order did not succeed ", po);  
+        MsmqMessageProperty mqProp = OperationContext.Current.IncomingMessageProperties[MsmqMessageProperty.Name] as MsmqMessageProperty;  
+  
+        Console.WriteLine("Message Delivery Status: {0} ", mqProp.DeliveryStatus);  
+        Console.WriteLine("Message Delivery Failure: {0}", mqProp.DeliveryFailure);  
+        Console.WriteLine();  
+  
+        // resend the message if timed out  
+        if (mqProp.DeliveryFailure == DeliveryFailure.ReachQueueTimeout ||  
+            mqProp.DeliveryFailure == DeliveryFailure.ReceiveTimeout)  
+        {  
+            // re-send  
+            Console.WriteLine("Purchase order Time To Live expired");  
+            Console.WriteLine("Trying to resend the message");  
+  
+            // reuse the same transaction used to read the message from dlq to enqueue the message to app. queue  
+            orderProcessorService.SubmitPurchaseOrder(po);  
+            Console.WriteLine("Purchase order resent");  
+        }  
+    }  
+  
+    // Host the service within this EXE console application.  
+    public static void Main()  
+    {  
+        // Create a ServiceHost for the PurchaseOrderDLQService type.  
+        using (ServiceHost serviceHost = new ServiceHost(typeof(PurchaseOrderDLQService)))  
+        {  
+            // Open the ServiceHostBase to create listeners and start listening for messages.  
+            serviceHost.Open();  
+  
+            // The service can now be accessed.  
+            Console.WriteLine("The dead letter service is ready.");  
+            Console.WriteLine("Press <ENTER> to terminate service.");  
+            Console.WriteLine();  
+            Console.ReadLine();  
+        }  
+    }  
+}   
+```  
+  
+ 配信不能メッセージ用の構成を次のサンプルに示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.PurchaseOrderDLQService">  
+        <!-- Define NetMsmqEndpoint in this case, DLQ end point to read messages-->  
+        <endpoint address="net.msmq://localhost/private/ServiceModelSamplesOrdersAppDLQ"  
+                  binding="netMsmqBinding"  
+                  bindingConfiguration="DefaultBinding"   
+                  contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+      </service>  
+    </services>  
+  
+    <client>  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint name="OrderProcessorEndpoint"  
+                 address="net.msmq://localhost/private/ServiceModelSamplesDeadLetter"   
+                 binding="netMsmqBinding"   
+                 bindingConfiguration="SystemDLQBinding"   
+                 contract="IOrderProcessor" />  
+    </client>  
+  
+    <bindings>  
+      <netMsmqBinding>  
+        <binding name="DefaultBinding" />  
+        <binding name="SystemDLQBinding"  
+                 deadLetterQueue="System"/>  
+      </netMsmqBinding>  
+    </bindings>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ このサンプルを実行するときは、3 つの実行可能ファイル \(クライアント、サービス、および各アプリケーションの配信不能キューを読み取ってメッセージをサービスに再送信する配信不能サービス\) が実行され、各アプリケーションに対して配信不能キューがどのように機能するかがわかります。  これらはすべてコンソール アプリケーションで、コンソール ウィンドウに出力が表示されます。  
+  
+> [!NOTE]
+>  キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。  クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  キューが作成されるように、サービスを起動してシャットダウンする必要があります。  
+  
+ クライアントを実行すると、次のメッセージが表示されます。  
+  
+```  
+Press <ENTER> to terminate client.  
+```  
+  
+ クライアントはメッセージの送信を試みますが、タイムアウトまでの時間が短いのでメッセージは期限切れとなり、メッセージが各アプリケーションの配信不能キューに置かれます。  
+  
+ 次に、配信不能サービスを実行すると、メッセージが読み取られてエラー コードが表示され、メッセージがサービスに再送信されます。  
+  
+```  
+The dead letter service is ready.  
+Press <ENTER> to terminate service.  
+  
+Submitting purchase order did not succeed  
+Message Delivery Status: InDoubt  
+Message Delivery Failure: ReachQueueTimeout  
+  
+Purchase order Time To Live expired  
+Trying to resend the message  
+Purchase order resent  
+  
+```  
+  
+ サービスを起動すると、再送信されたメッセージが読み取られて処理されます。  
+  
+```  
+  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Processing Purchase Order: 97897eff-f926-4057-a32b-af8fb11b9bf9  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。  キューが存在しない場合、サービスによってキューが作成されます。  最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。  Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、`「ServiceModelSamplesTransacted」`と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、キュー名を localhost からコンピューターの完全名に変更し、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### ワークグループに参加しているコンピューターでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピューターを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードとセキュリティ レベルを `None` に設定します。サンプル構成を次に示します。  
+  
+    ```  
+    <bindings>  
+        <netMsmqBinding>  
+            <binding name="TransactedBinding">  
+                <security mode="None"/>  
+            </binding>  
+        </netMsmqBinding>  
+    </bindings>  
+    ```  
+  
+     エンドポイントの `bindingConfiguration` 属性が設定されて、エンドポイントとバインディングとが関連付けられていることを確認します。  
+  
+2.  DeadLetterService、サーバー、およびクライアントの構成を変更したことを確認してから、サンプルを実行します。  
+  
+    > [!NOTE]
+    >  `security mode` を `None` に設定することは、`MsmqAuthenticationMode`、`MsmqProtectionLevel`、および `Message` のセキュリティを `None` に設定することに相当します。  
+  
+## コメント  
+ `netMsmqBinding` バインディング トランスポートを使用する場合の既定では、セキュリティが有効です。  トランスポート セキュリティの種類は、`MsmqAuthenticationMode` と `MsmqProtectionLevel` の 2 つのプロパティで決まります。  既定の設定では、認証モードは `Windows`、保護レベルは `Sign` です。  MSMQ の認証および署名の機能を利用するには、ドメインに属している必要があります。  ドメインに属していないコンピューターでこのサンプルを実行すると、"User's internal message queuing certificate does not exist" というエラーが表示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\DeadLetter`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/default-message-contract.md b/docs/framework/wcf/samples/default-message-contract.md
new file mode 100644
index 00000000000..8e04977bd11
--- /dev/null
+++ b/docs/framework/wcf/samples/default-message-contract.md
@@ -0,0 +1,199 @@
+---
+title: "既定のメッセージ コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "メッセージ コントラクト"
+ms.assetid: 5a200b78-1a46-4104-b7fb-da6dbab33893
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# 既定のメッセージ コントラクト
+既定のメッセージ コントラクトのサンプルでは、ユーザー定義のカスタム メッセージをサービス操作に渡したり、サービス操作から渡されたりするサービスを示します。このサンプルは、電卓インターフェイスを型指定のあるサービスとして実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。このサンプルでは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」で使用される加算、減算、乗算、および除算の個別のサービス操作ではなく、オペランドと演算子の両方を含むカスタム メッセージを渡し、その算術計算の結果を返します。  
+  
+ クライアントはコンソール プログラム \(.exe\) であり、サービス ライブラリはインターネット インフォメーション サービス \(IIS\) によってホストされます。クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサービスでは、型 `MyMessage` のカスタム メッセージを受け入れて返す、1 つのサービス操作が定義されます。このサンプルでは要求および応答のメッセージの型は同じですが、もちろん、メッセージ コントラクトは必要に応じて変えることができます。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract(Action="http://test/MyMessage_action",  
+                  ReplyAction="http://test/MyMessage_action")]  
+    MyMessage Calculate(MyMessage request);  
+}  
+  
+```  
+  
+ カスタム メッセージ `MyMessage` は、<xref:System.ServiceModel.MessageContractAttribute>、<xref:System.ServiceModel.MessageHeaderAttribute>、および <xref:System.ServiceModel.MessageBodyMemberAttribute> 属性が付いたクラスで定義されます。このサンプルで使用するのは 3 番目のコンストラクタだけです。メッセージ コントラクトを使用すると、SOAP メッセージを完全に制御できます。このサンプルでは、<xref:System.ServiceModel.MessageHeaderAttribute> 属性を使用して SOAP ヘッダーに `Operation` を格納します。オペランド `N1`、`N2`、および `Result` は SOAP 本文内に示されます。これらのオペランドには <xref:System.ServiceModel.MessageBodyMemberAttribute> 属性が適用されているためです。  
+  
+```  
+[MessageContract]  
+public class MyMessage  
+{  
+    private string operation;  
+    private double n1;  
+    private double n2;  
+    private double result;  
+  
+    //Constructor - create an empty message.  
+  
+    public MyMessage() {}  
+  
+    //Constructor - create a message and populate its members.  
+  
+    public MyMessage(double n1, double n2, string operation,   
+                     double result)  
+    {  
+        this.n1 = n1;  
+        this.n2 = n2;  
+        this.operation = operation;  
+        this.result = result;  
+    }  
+  
+    //Constructor - create a message from another message.  
+  
+    public MyMessage(MyMessage message)  
+    {  
+        this.n1 = message.n1;  
+        this.n2 = message.n2;  
+        this.operation = message.operation;  
+        this.result = message.result;  
+    }  
+  
+    [MessageHeader]  
+    public string Operation  
+    {  
+        get { return operation; }  
+        set { operation = value; }  
+    }  
+  
+    [MessageBodyMember]  
+    public double N1  
+    {  
+        get { return n1; }  
+        set { n1 = value; }  
+    }  
+  
+    [MessageBodyMember]  
+    public double N2  
+    {  
+        get { return n2; }  
+        set { n2 = value; }  
+    }  
+  
+    [MessageBodyMember]  
+    public double Result  
+    {  
+        get { return result; }  
+        set { result = value; }  
+    }  
+}  
+```  
+  
+ 実装クラスには、`Calculate` サービス処理用のコードが含まれています。`CalculateService` クラスは、オペランドと演算子を要求メッセージから取得し、要求された計算結果が含まれる応答メッセージを作成します。次のサンプル コードを参照してください。  
+  
+```  
+// Service class which implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    // Perform a calculation.  
+  
+    public MyMessage Calculate(MyMessage request)  
+    {  
+        MyMessage response = new MyMessage(request);  
+        switch (request.Operation)  
+        {  
+            case "+":  
+                response.Result = request.N1 + request.N2;  
+                break;  
+            case "-":  
+                response.Result = request.N1 - request.N2;  
+                break;  
+            case "*":  
+                response.Result = request.N1 * request.N2;  
+                break;  
+            case "/":  
+                response.Result = request.N1 / request.N2;  
+                break;  
+            default:  
+                response.Result = 0.0D;  
+                break;  
+        }  
+        return response;  
+    }  
+}  
+```  
+  
+ クライアント用に生成されるクライアント コードは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用して作成されました。このツールでは、必要に応じて、生成済みのクライアント コード内にメッセージ コントラクト型が自動的に作成されます。`/messageContract` コマンド オプションを指定すると、メッセージ コントラクトを強制的に生成できます。  
+  
+```  
+svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" /o:client\generatedClient.cs http://localhost/servicemodelsamples/service.svc/mex  
+```  
+  
+ `MyMessage` メッセージを使用するクライアントを次のサンプル コードに示します。  
+  
+```  
+// Create a client with given client endpoint configuration  
+CalculatorClient client = new CalculatorClient();  
+  
+// Perform addition using a typed message.  
+  
+MyMessage request = new MyMessage();  
+request.N1 = 100D;  
+request.N2 = 15.99D;  
+request.Operation = "+";  
+MyMessage response = ((ICalculator)client).Calculate(request);  
+Console.WriteLine("Add({0},{1}) = {2}", request.N1, request.N2, response.Result);  
+```  
+  
+ サンプルを実行すると、クライアント コンソール ウィンドウに計算が表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ この時点で、ユーザー定義のカスタム メッセージがクライアントとサービスの操作間で渡されます。メッセージ コントラクトでは、オペランドと結果はメッセージ本文内にあり、演算子はメッセージ ヘッダー内にあることが定義されました。このメッセージ構造を監視するために、メッセージ ログ記録を設定できます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Message\Default`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/default-nettcpbinding.md b/docs/framework/wcf/samples/default-nettcpbinding.md
new file mode 100644
index 00000000000..25a0c5f5adc
--- /dev/null
+++ b/docs/framework/wcf/samples/default-nettcpbinding.md
@@ -0,0 +1,136 @@
+---
+title: "既定の NetTcpBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "Net プロファイル TCP"
+ms.assetid: e8475fe6-0ecd-407a-8e7e-45860561bb74
+caps.latest.revision: 39
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# 既定の NetTcpBinding
+このサンプルは、<xref:System.ServiceModel.NetTcpBinding> バインディングの使用方法を示します。  このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  このサンプルでは、サービスは自己ホスト型です。  クライアントとサービスは両方ともコンソール アプリケーションです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\TCP\Default`  
+  
+ バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の `binding` 属性で指定します。次のサンプル構成を参照してください。  
+  
+```  
+<endpoint address=""  
+          binding="netTcpBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ 前のサンプルでは、`netTcpBinding` バインディングを既定の設定で使用するようエンドポイントを構成する手順を示しました。  `netTcpBinding` バインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、バインディング構成を `bindingConfiguration` 属性を使用して名前で参照します。  このサンプルでは、バインディング構成の名前は `Binding1` です。これは次のサンプル構成のように定義されます。  
+  
+```  
+<services>  
+  <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+    ...  
+    <endpoint address=""  
+              binding="netTcpBinding"  
+              bindingConfiguration="Binding1"   
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    ...  
+  </service>  
+</services>  
+  
+<bindings>  
+  <netTcpBinding>  
+    <binding name="Binding1"   
+             closeTimeout="00:01:00"  
+             openTimeout="00:01:00"   
+             receiveTimeout="00:10:00"   
+             sendTimeout="00:01:00"  
+             transactionFlow="false"   
+             transferMode="Buffered"   
+             transactionProtocol="OleTransactions"  
+             hostNameComparisonMode="StrongWildcard"   
+             listenBacklog="10"  
+             maxBufferPoolSize="524288"   
+             maxBufferSize="65536"   
+             maxConnections="10"  
+             maxReceivedMessageSize="65536">  
+      <readerQuotas maxDepth="32"   
+                    maxStringContentLength="8192"   
+                    maxArrayLength="16384"  
+                    maxBytesPerRead="4096"   
+                    maxNameTableCharCount="16384" />  
+      <reliableSession ordered="true"   
+                       inactivityTimeout="00:10:00"  
+                       enabled="false" />  
+      <security mode="Transport">  
+        <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign" />  
+      </security>  
+    </binding>  
+  </netTcpBinding>  
+</bindings>  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press ENTER to terminate client.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  サーバーは自己ホスト型なので、このサンプルを複数コンピューター構成で実行する場合は、次のようにクライアントの App.config ファイルで ID を指定する必要があります。  
+  
+    ```  
+    <client>  
+      <endpoint name=""  
+          address="net.tcp://servername:9000/servicemodelsamples/service"   
+          binding="netTcpBinding"   
+          contract="Microsoft.ServiceModel.Samples.ICalculator">  
+            <identity>  
+              <userPrincipalName value = "user_name@service_domain"/>  
+            </identity>  
+      </endpoint>  
+    </client>  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/default-service-behavior.md b/docs/framework/wcf/samples/default-service-behavior.md
new file mode 100644
index 00000000000..fc5dd2402d2
--- /dev/null
+++ b/docs/framework/wcf/samples/default-service-behavior.md
@@ -0,0 +1,105 @@
+---
+title: "既定のサービスの動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "既定のサービス動作のサンプル [Windows Communication Foundation]"
+  - "サービスの動作, 既定"
+ms.assetid: 442d4f71-c64e-4c62-816a-a66c38e7d3ec
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 既定のサービスの動作
+このサンプルでは、サービスの動作設定を構成する方法を示します。このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。このサンプルは、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性と <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用して、サービスの動作と操作の動作を明示的に定義しています。動作の構成は、このサンプルに示すように、構成ファイルで行うことも、コード内で強制的に行うこともできます。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス クラスは、<xref:System.ServiceModel.ServiceBehaviorAttribute> と <xref:System.ServiceModel.OperationBehaviorAttribute> を使用して動作を指定します。次のサンプル コードを参照してください。指定されたすべての値は、既定値です。  
+  
+```  
+[ServiceBehavior(  
+    AutomaticSessionShutdown=true,  
+    ConcurrencyMode=ConcurrencyMode.Single,  
+    InstanceContextMode=InstanceContextMode.PerSession,  
+    IncludeExceptionDetailInFaults=false,  
+    UseSynchronizationContext=true,  
+    ValidateMustUnderstand=true)]  
+public class CalculatorService : ICalculator  
+{  
+    [OperationBehavior(  
+        TransactionAutoComplete=true,  
+        TransactionScopeRequired=false,  
+        Impersonation=ImpersonationOption.NotAllowed)]  
+    public double Add(double n1, double n2)  
+    {  
+        System.Threading.Thread.Sleep(1600);  
+        return n1 + n2;  
+    }  
+    ...  
+}  
+  
+```  
+  
+ サービスの動作は、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性で指定されます。これらの動作のいくつかを次の表に示します。  
+  
+|サービスの動作|説明|  
+|-------------|--------|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.AutomaticSessionShutdown%2A>|セッションをクライアントの要求で自動的にシャットダウンします。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A>|各サービス インスタンスの同時実行モードを指定します。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A>|インスタンス コンテキスト モードを指定します。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.UseSynchronizationContext%2A>|同期コンテキストが設定されている場合、その同期コンテキストを使用するかどうかを判断します。Windows フォーム アプリケーションで `WindowsFormsSynchronizationContext` を使用するかどうかを制御する場合に、これを使用します。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A>|一般的な未処理の実行例外を `Fault<string>` に変換してエラー メッセージとして送信するかどうかを判断します。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionIsolationLevel%2A>|トランザクションの分離レベルを指定します。|  
+|<xref:System.ServiceModel.ServiceBehaviorAttribute.ValidateMustUnderstand%2A>|予期しないメッセージのヘッダーがエラーの原因であるかどうかを判断します。|  
+  
+ 操作の動作は <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用して指定されます。これらの動作のいくつかを次の表に示します。  
+  
+|操作の動作|説明|  
+|-----------|--------|  
+|<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A>|現在のトランザクションがサービス操作の完了によってコミットされるかどうかを判断します。|  
+|<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A>|サービス操作がクライアントからフローされたトランザクションに参加するかどうかを判断します。|  
+|<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A>|サービス操作が呼び出し元の ID を偽装するかどうかを判断します。|  
+|<xref:System.ServiceModel.OperationBehaviorAttribute.ReleaseInstanceMode%2A>|サービス操作の呼び出しの開始時または終了時に、サービス インスタンスが再利用されるかどうかを判断します。|  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。呼び出し間の遅延は、サービス操作で `System.Threading.Thread.Sleep()` が呼び出されることによるものです。以降の動作サンプルでは、これらの動作の詳細について説明します。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Default`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/design-patterns-list-based-publish-subscribe.md b/docs/framework/wcf/samples/design-patterns-list-based-publish-subscribe.md
new file mode 100644
index 00000000000..5d76103a19e
--- /dev/null
+++ b/docs/framework/wcf/samples/design-patterns-list-based-publish-subscribe.md
@@ -0,0 +1,172 @@
+---
+title: "デザイン パターン : リストに基づく公開/定期受信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4257abc-12df-4736-a03b-0731becf0fd4
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# デザイン パターン : リストに基づく公開/定期受信
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] プログラムとして実装された、リストに基づく公開\/定期受信パターンを示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ リストに基づく公開\/定期受信のデザイン パターンは、「Microsoft Patterns & Practices」の「[統合パターン](http://go.microsoft.com/fwlink/?LinkId=95894)」で説明されています。  公開\/定期受信パターンは、情報トピックを定期受信する受信者のコレクションに情報を渡します。  リストに基づく公開\/定期受信では、サブスクライバのリストが保持されます。  共有情報が存在する場合は、コピーがリスト上の各サブスクライバに送信されます。  このサンプルでは、動的なリストに基づく公開\/定期受信パターンを示します。これにより、クライアントは必要に応じて何度でも定期受信または定期受信の解除ができます。  
+  
+ リストに基づく公開\/定期受信のサンプルは、クライアント、サービス、およびデータ ソース プログラムで構成されています。  クライアントとデータ ソース プログラムは、複数を実行できます。  クライアントはサービスを定期受信し、通知を受信して、定期受信を解除します。  データ ソース プログラムはサービスに情報を送信し、現在のすべてのサブスクライバでその情報が共有されるようにします。  
+  
+ このサンプルでは、クライアントとデータ ソースはコンソール プログラム \(.exe ファイル\) で、サービスはインターネット インフォメーション サービス \(IIS\) でホストされるライブラリ \(.dll\) です。  クライアントとデータ ソースのアクティビティは、デスクトップに表示されます。  
+  
+ サービスは、双方向通信を使用します。  `ISampleContract` サービス コントラクトは `ISampleClientCallback` コールバック コントラクトと対になっています。  サービスは Subscribe および Unsubscribe サービス操作を実装します。クライアントはこれらのサービス操作を使用してサブスクライバのリストに参加またはリストへの参加を解除します。  サービスは、さらに `PublishPriceChange` サービス操作も実装します。データ ソース プログラムはこれを呼び出して、新しい情報をサービスに提供します。  クライアント プログラムは `PriceChange` サービス操作を実装します。サービスはこれを呼び出して、すべてのサブスクライバに価格の変更を通知します。  
+  
+```  
+// Create a service contract and define the service operations.  
+// NOTE: The service operations must be declared explicitly.  
+[ServiceContract(SessionMode=SessionMode.Required,  
+      CallbackContract=typeof(ISampleClientContract))]  
+public interface ISampleContract  
+{  
+    [OperationContract(IsOneWay = false, IsInitiating=true)]  
+    void Subscribe();  
+    [OperationContract(IsOneWay = false, IsTerminating=true)]  
+    void Unsubscribe();  
+    [OperationContract(IsOneWay = true)]  
+    void PublishPriceChange(string item, double price,   
+                                     double change);  
+}  
+  
+public interface ISampleClientContract  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void PriceChange(string item, double price, double change);  
+}  
+```  
+  
+ サービスは、すべてのサブスクライバに新しい情報を通知する機構として、.NET Framework イベントを使用します。  クライアントが Subscribe を呼び出してサービスに参加すると、イベント ハンドラが提供されます。  クライアントがサービスへの参加を解除すると、イベントからイベント ハンドラの定期受信が解除されます。  データ ソースが価格の変更を報告するサービスを呼び出すと、サービスはイベントを発生させます。  これにより、サービスの各インスタンスが呼び出されます。このサービスは定期受信した各クライアントのサービスで、この呼び出しによって各インスタンスのイベント ハンドラが実行されます。  各イベント ハンドラは、コールバック関数を使用してクライアントに情報を渡します。  
+  
+```  
+public class PriceChangeEventArgs : EventArgs  
+    {  
+        public string Item;  
+        public double Price;  
+        public double Change;  
+    }  
+  
+    // The Service implementation implements your service contract.  
+    [ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+    public class SampleService : ISampleContract  
+    {  
+        public static event PriceChangeEventHandler PriceChangeEvent;  
+        public delegate void PriceChangeEventHandler(object sender, PriceChangeEventArgs e);  
+  
+        ISampleClientContract callback = null;  
+  
+        PriceChangeEventHandler priceChangeHandler = null;  
+  
+        //Clients call this service operation to subscribe.  
+        //A price change event handler is registered for this client instance.  
+  
+        public void Subscribe()  
+        {  
+            callback = OperationContext.Current.GetCallbackChannel<ISampleClientContract>();  
+            priceChangeHandler = new PriceChangeEventHandler(PriceChangeHandler);  
+            PriceChangeEvent += priceChangeHandler;  
+        }  
+  
+        //Clients call this service operation to unsubscribe.  
+        //The previous price change event handler is deregistered.  
+  
+        public void Unsubscribe()  
+        {  
+            PriceChangeEvent -= priceChangeHandler;  
+        }  
+  
+        //Information source clients call this service operation to report a price change.  
+        //A price change event is raised. The price change event handlers for each subscriber will execute.  
+  
+        public void PublishPriceChange(string item, double price, double change)  
+        {  
+            PriceChangeEventArgs e = new PriceChangeEventArgs();  
+            e.Item = item;  
+            e.Price = price;  
+            e.Change = change;  
+            PriceChangeEvent(this, e);  
+        }  
+  
+        //This event handler runs when a PriceChange event is raised.  
+        //The client's PriceChange service operation is invoked to provide notification about the price change.  
+  
+        public void PriceChangeHandler(object sender, PriceChangeEventArgs e)  
+        {  
+            callback.PriceChange(e.Item, e.Price, e.Change);  
+        }  
+  
+    }  
+  
+```  
+  
+ このサンプルを実行すると、複数のクライアントが起動されます。  クライアントはサービスを定期受信します。  次にデータ ソース プログラムが実行され、サービスに情報が送信されます。  サービスは、すべてのサブスクライバに情報を渡します。  各クライアント コンソールでアクティビティを表示し、情報が受信されたことを確認できます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  ブラウザにアドレス「http:\/\/localhost\/servicemodelsamples\/service.svc」を入力して、サービスにアクセスできるかどうかをテストします。  これに応答して、確認ページが表示されます。  
+  
+2.  言語固有のフォルダーの下の \\client\\bin\\ にある Client.exe を実行します。  クライアント アクティビティがクライアント コンソール ウィンドウに表示されます。  複数のクライアントを起動します。  
+  
+3.  言語固有のフォルダの下の \\datasource\\bin\\ にある Datasource.exe を実行します。  データ ソース アクティビティがコンソール ウィンドウに表示されます。  データ ソースがサービスに情報を送信すると、その情報は各クライアントに渡されます。  
+  
+4.  クライアント、データ ソース、およびサービス プログラムが通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数コンピューターで実行するには  
+  
+1.  サービス コンピュータを設定します。  
+  
+    1.  サービス コンピューターで、ServiceModelSamples という仮想ディレクトリを作成します。  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」でバッチ ファイル Setupvroot.bat ファイルを使用すると、ディスク ディレクトリと仮想ディレクトリを作成できます。  
+  
+    2.  サービス プログラム ファイルを %SystemDrive%\\Inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの ServiceModelSamples 仮想ディレクトリにコピーします。  \\bin ディレクトリのファイルが含まれていることを確認してください。  
+  
+    3.  ブラウザーを使用して、サービスにクライアント コンピューターからアクセスできるかどうかをテストします。  
+  
+2.  クライアント コンピュータを設定します。  
+  
+    1.  クライアント プログラム ファイルを、言語固有のフォルダにある \\client\\bin\\ フォルダからクライアント コンピュータにコピーします。  
+  
+    2.  各クライアントの構成ファイルで、エンドポイント定義のアドレス値をサービスの新しいアドレスに合わせて変更します。  アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+3.  データ ソース コンピュータを設定します。  
+  
+    1.  データ ソース プログラム ファイルを、言語固有のフォルダにある \\datasource\\bin\\ フォルダからデータ ソース コンピュータにコピーします。  
+  
+    2.  データ ソースの構成ファイルで、エンドポイント定義のアドレス値をサービスの新しいアドレスに合わせて変更します。  アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+4.  クライアント コンピュータで、コマンド プロンプトから Client.exe を起動します。  
+  
+5.  データ ソース コンピューターで、コマンド プロンプトから Datasource.exe を起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DesignPatterns/ListBasedPublishSubscribe`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discover-a-service-with-unique-listen-uri-mode-sample.md b/docs/framework/wcf/samples/discover-a-service-with-unique-listen-uri-mode-sample.md
new file mode 100644
index 00000000000..afb7d85d74e
--- /dev/null
+++ b/docs/framework/wcf/samples/discover-a-service-with-unique-listen-uri-mode-sample.md
@@ -0,0 +1,49 @@
+---
+title: "一意の ListenUri モードのサンプルを使用したサービスの探索 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a6d35b2-0469-43c8-a0c9-63623e3d2733
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 一意の ListenUri モードのサンプルを使用したサービスの探索
+このサンプルでは、<xref:System.ServiceModel.Channels.BindingContext.ListenUriMode%2A> プロパティが <xref:System.ServiceModel.Description.ListenUriMode> に設定されているサービスを探索する方法を示します。<xref:System.ServiceModel.Channels.BindingContext.ListenUriMode%2A> プロパティが <xref:System.ServiceModel.Description.ListenUriMode> に設定されている場合は、ポートを一意に設定するか、GUID を付加することによってパスを一意に設定して、ListenUri を一意にする必要があります。  
+  
+### サービスの機能  
+ TCP エンドポイントの <xref:System.ServiceModel.Channels.BindingContext.ListenUriMode%2A> プロパティは、<xref:System.ServiceModel.Description.ListenUriMode> に設定されます。これにより、<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> エンドポイントを介してサービスを探索できるようになります。  
+  
+### クライアントの機能  
+ このクライアントは、適切な `Via.Uri` を使用してサービスに接続します。この際、<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> メソッドが使用されます。このメソッドから返された <xref:System.ServiceModel.Discovery.FindResponse> は、有効な <xref:System.ServiceModel.Endpoint.ListenUri%2A> を含んでいるかどうか、および `Address.Uri` とは異なるかどうかについて照会されます。適切な情報は `InvokeCalculatorService` メソッドに渡されます。`InvokeCalculatorService` メソッドでは、呼び出し元から <xref:System.ServiceModel.Endpoint.ListenUri%2A> が渡され、適切な `Via.Uri` が設定された `ClientViaBehavior` がクライアントのエンドポイントに追加されます。  
+  
+##### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で、UniqueListenUriMode.sln を開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  \[ソリューションの基本ディレクトリ\]\\service\\bin\\debug フォルダーに生成されたサービス アプリケーションを実行します。  
+  
+4.  \[ソリューションの基本ディレクトリ\]\\Client\\bin\\debug フォルダーに生成されたクライアント アプリケーションを実行します。  
+  
+     クライアントは実行中のサービスを検索し、サービスのエンドポイントで公開されているメタデータをコンソールに書き込みます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\UniqueListenUriMode`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-binding-element-sample.md b/docs/framework/wcf/samples/discovery-binding-element-sample.md
new file mode 100644
index 00000000000..870a6f86eae
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-binding-element-sample.md
@@ -0,0 +1,130 @@
+---
+title: "探索バインディング要素のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: af513015-85bf-417b-8729-1bdff77ff6d6
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 探索バインディング要素のサンプル
+このサンプルでは、探索クライアント バインディング要素を使用してサービスを探索する方法を示します。この機能を使用すると、開発者は、探索クライアント チャネルを既存のクライアント チャネル スタックに追加することにより、プログラミング モデルをきわめて直感的にすることができます。関連付けられたチャネルが開いている場合、サービスのアドレスは探索を使用して解決されます。このサンプルは、次のプロジェクトで構成されています。  
+  
+-   **CalculatorService**: 探索可能な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス。  
+  
+-   **CalculatorClient**: 探索クライアント チャネルを使用して CalculatorService の検索と呼び出しを行う [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーション。  
+  
+-   **DynamicCalculatorClient**: 動的エンドポイントを使用して CalculatorService の検索と呼び出しを行う [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント アプリケーション。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\DiscoveryBindingElement`  
+  
+## CalculatorService  
+ このプロジェクトには、`ICalculatorService` コントラクトを実装する簡単な電卓サービスが含まれています。  
+  
+ 次の App.config ファイルは、サービスの動作と探索エンドポイントに `<serviceDiscovery>` 動作を追加するために使用されています。  
+  
+```  
+<system.serviceModel>  
+    <services>  
+      <service behaviorConfiguration="CalculatorBehavior" name="Microsoft.Samples.Discovery.CalculatorService">  
+        <endpoint name="udpDiscoveryEpt" kind="udpDiscoveryEndpoint" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <!--Enable discovery through configuration.-->  
+      <serviceBehaviors>  
+        <behavior name="CalculatorBehavior">  
+          <serviceDiscovery>  
+          </serviceDiscovery>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+```  
+  
+ これにより、サービスとそのエンドポイントが探索可能になります。CalculatorService は、NetTcpBinding バインディングを使用してエンドポイントを 1 つ追加する、自己ホスト型サービスです。また、次のコードに示すように、`EndpointDiscoveryBehavior` のエンドポイントへの追加と、スコープの指定も行います。  
+  
+```  
+// Add a NET.TCP endpoint and add a scope to that endpoint.  
+ServiceEndpoint netTcpEndpoint = serviceHost.AddServiceEndpoint(typeof(ICalculatorService), new NetTcpBinding(), netTcpAddress);  
+EndpointDiscoveryBehavior netTctEndpointBehavior = new EndpointDiscoveryBehavior();  
+netTctEndpointBehavior.Scopes.Add(new Uri("ldap:///ou=engineering,o=exampleorg,c=us"));  
+netTcpEndpoint.Behaviors.Add(netTctEndpointBehavior);  
+serviceHost.Open();  
+```  
+  
+## CalculatorClient  
+ このプロジェクトには、メッセージを CalculatorService に送信するクライアント実装が含まれています。このプログラムは、`CreateCustomBindingWithDiscoveryElement()` メソッドを使用して、探索クライアント チャネルを使用するカスタム バインディングを作成します。  
+  
+```  
+static CustomBinding CreateCustomBindingWithDiscoveryElement()  
+ {  
+      DiscoveryClientBindingElement discoveryBindingElement = new DiscoveryClientBindingElement();  
+  
+            // Provide the search criteria and the endpoint over which the probe is sent  
+            discoveryBindingElement.FindCriteria = new FindCriteria(typeof(ICalculatorService));  
+            discoveryBindingElement.DiscoveryEndpointProvider = new UdpDiscoveryEndpointProvider();  
+  
+            CustomBinding customBinding = new CustomBinding(new NetTcpBinding());  
+            // Insert DiscoveryClientBindingElement at the top of the BindingElement stack.  
+            // An exception is thrown if this binding element is not at the top  
+            customBinding.Elements.Insert(0, discoveryBindingElement);  
+  
+            return customBinding; }  
+```  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> をインスタンス化した後、サービスの検索時に使用する条件を指定します。この場合の探索検索条件は `ICalculatorService` 型です。さらに、<xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider> を指定します。これにより、サービスの検索場所を示す <xref:System.ServiceModel.Discovery.DiscoveryEndpoint> が返されます。<xref:System.ServiceModel.Discovery.DiscoveryEndpointProvider> は、新しい <xref:System.ServiceModel.Discovery.DiscoveryEndpoint> インスタンスを返します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][カスタム バインディングを探索クライアント チャネルと共に使用する](../../../../docs/framework/wcf/feature-details/using-a-custom-binding-with-the-discovery-client-channel.md).  
+  
+```  
+// Extend DiscoveryEndpointProvider class to change the default DiscoveryEndpoint  
+    // to the DiscoveryClientBindingElement. The Discovery ClientChannel   
+    // uses this endpoint to send Probe message.  
+    public class UdpDiscoveryEndpointProvider : DiscoveryEndpointProvider  
+    {  
+        public override DiscoveryEndpoint GetDiscoveryEndpoint()  
+        {  
+            return new UdpDiscoveryEndpoint(DiscoveryVersion.WSDiscoveryApril2005);  
+        }  
+    }  
+```  
+  
+ この場合、クライアントは、探索プロトコルによって定義された UDP マルチキャスト メカニズムを使用して、ローカル サブネット上のサービスを検索します。残りのメソッドは、カスタム バインディングを作成し、探索バインディング要素をスタックの一番上に挿入します。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> は、バインディング スタックの一番上に配置する必要があります。<xref:System.ServiceModel.Discovery.DiscoveryClientBindingElement> の一番上に配置された <xref:System.ServiceModel.Channels.BindingElement> によって作成されたチャネル ファクトリまたはチャネルでは、`EndpointAddress` プロパティまたは `Via` プロパティを使用しないようにする必要があります。これは、実際のアドレスが探索クライアント チャネルでしか見つからないからです。  
+  
+ 次に、`CalculatorClient` をインスタンス化するために、このカスタム バインディングとエンドポイント アドレスを渡します。  
+  
+```  
+CalculatorServiceClient client = new CalculatorServiceClient(CreateCustomBindingWithDiscoveryElement(), DiscoveryClientBindingElement.DiscoveryEndpointAddress);  
+```  
+  
+ 探索クライアント チャネルを使用している場合、以前に指定された定数のエンドポイント アドレスが渡されます。実行時には、探索クライアント チャネルは、検索条件で指定されたサービスを検索し、見つかったサービスに接続します。サービスとクライアントの接続を確立するには、基になるバインディング スタックも同じにする必要があります。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] で、ソリューションを開きます。  
+  
+2.  ソリューションをビルドします。  
+  
+3.  サービス アプリケーションと各クライアント アプリケーションを実行します。  
+  
+4.  クライアントがサービスのアドレスを知ることなくサービスを検索できたことを確認します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-extensibility.md b/docs/framework/wcf/samples/discovery-extensibility.md
new file mode 100644
index 00000000000..9e4163c5316
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-extensibility.md
@@ -0,0 +1,29 @@
+---
+title: "探索の機能拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c1bca31-c143-468a-8ddd-32f87998a5ff
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 探索の機能拡張
+このセクションのサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の探索機能を拡張する方法について説明します。  
+  
+## このセクションの内容  
+ [CustomDiscoveryMetadata](../../../../docs/framework/wcf/samples/customdiscoverymetadata.md)  
+ サービスによって公開される探索可能なエンドポイントの探索メタデータにカスタム XML メタデータを挿入する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> <xref:System.ServiceModel.Discovery.DiscoveryClient> <xref:System.ServiceModel.Discovery.FindResponse>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-proxy-sample.md b/docs/framework/wcf/samples/discovery-proxy-sample.md
new file mode 100644
index 00000000000..4d3c3931657
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-proxy-sample.md
@@ -0,0 +1,65 @@
+---
+title: "探索プロキシのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1dfa02df-15b1-4e97-9c8e-f5f2772711b0
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 探索プロキシのサンプル
+このサンプルでは、既存のサービスに関する情報を格納するために探索プロキシの実装を作成する方法、およびクライアントからそのプロキシに情報のクエリを行う方法を示します。このサンプルは、3 つのプロジェクトで構成されます。  
+  
+-   **Service**: 探索プロキシに自らを登録する単純な [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 電卓サービス。  
+  
+-   **Discovery Proxy**: 探索プロキシ サービスの実装。  
+  
+-   **Client**: 探索プロキシを呼び出してサービスを検索する WCF クライアント アプリケーション。  
+  
+## 使用例  
+ 探索プロキシの実装  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\DiscoveryProxy`  
+  
+## DiscoveryProxy  
+ このサンプルでは、Program.cs ファイルの `Main` メソッドで、<xref:System.ServiceModel.Discovery.DiscoveryProxy> 型のサービスをホストする方法を示します。このメソッドによって、<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> 型と <xref:System.ServiceModel.Discovery.AnnouncementEndpoint> 型の 2 つのエンドポイントが公開されます。どちらのエンドポイントも、TCP をトランスポートとして使用します。<xref:System.ServiceModel.Discovery.DiscoveryEndpoint> は、`probeEndpointAddress` パラメーターで指定された URI をリッスンします。クライアントは、ここにプローブ メッセージを送信して、プロキシに対するデータのクエリを行うことができます。<xref:System.ServiceModel.Discovery.AnnouncementEndpoint> は、`announcementEndpointAddress` パラメーターで指定された URI をリッスンします。これは、プロキシがアナウンスをリッスンする場所です。プロキシは、オンライン アナウンスを受け取るとサービスをキャッシュに追加し、オフライン アナウンスを受け取るとサービスをキャッシュから削除します。  
+  
+ <xref:System.ServiceModel.Discovery.DiscoveryProxy> の実装は DiscoveryProxy.cs に含まれています。プロキシは <xref:System.ServiceModel.Discovery.DiscoveryProxyBase> クラスから継承する必要があり、<xref:System.Runtime.Remoting.Messaging.AsyncResult> の実装を必要とします。インスタンス化すると、プロキシは新しい <xref:Systems.Collections.Generic.Dictionary%601> を作成し、それを使用して認識している要素を格納します。  
+  
+ ファイルは、Proxy Cache Methods および Discovery Proxy Implementation という 2 つの領域に分かれています。Proxy Cache Methods 領域には、<xref:Systems.Collections.Generic.Dictionary%601> の更新、<xref:Systems.Collections.Generic.Dictionary%601> に対するクエリの実行、およびユーザーへのデータの出力に使用するメソッドが含まれています。Discovery Proxy Implementation 領域には、アナウンスおよびプローブ機能に必要なオーバーライドされたメソッドが含まれています。これらによって、オンライン アナウンス、オフライン アナウンス、またはプローブ メッセージを受け取った後にプロキシで実行されるアクションが定義されます。  
+  
+## Service  
+ Service プロジェクトの Program.cs ファイルでは、探索プロキシと同じ URI がアナウンス エンドポイントに使用されています。これは、サービスがこのエンドポイントを使用して送信したアナウンスを、プロキシが同じエンドポイントを使用して受け取るためです。サービスは、<xref:System.ServiceModel.Discovery.DiscoveryBehavior> を使用し、それにアナウンス エンドポイントを追加します。  
+  
+## Client  
+ Client プロジェクトは、プロキシと同じ URI をプローブ エンドポイントに使用します。これは、このシナリオのプローブも、プロキシで使用できるエンドポイントに明確にユニキャストされるからです。クライアントは、この既知のアドレスに接続してサービスのクエリを実行し、サービスを見つけるとそれに接続します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  最初に、\[ソリューションの基本ディレクトリ\]\\DiscoveryProxy\\bin\\debug に生成された探索プロキシ アプリケーションを実行します。探索プロキシを最初に実行しなければならないのは、サービスでアナウンスを送信するために TCP アナウンス エンドポイントを起動しておく必要があるからです。  
+  
+3.  2 番目に、\[ソリューションの基本ディレクトリ\]\\Service\\bin\\debug に生成されたサービス アプリケーションを実行します。起動時に、サービスから探索プロキシのアナウンス エンドポイントにアナウンスが送信され、サービスがプロキシのキャッシュに登録されます。  
+  
+4.  次に、\[ソリューションの基本ディレクトリ\]\\Client\\bin\\debug に生成されたクライアント アプリケーションを実行します。クライアントは、プロキシに対してクエリを実行してサービスのアドレスを取得し、サービスに接続します。  
+  
+5.  最後に、クライアント、サービス、プロキシの順に終了します。プロキシは、サービスのオフライン アナウンスを受け取るまでは実行されている必要があります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-router-service.md b/docs/framework/wcf/samples/discovery-router-service.md
new file mode 100644
index 00000000000..355b3d321d0
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-router-service.md
@@ -0,0 +1,47 @@
+---
+title: "探索ルーター サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3d30af47-b24f-40e5-833a-24d77125c9e6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 探索ルーター サービス
+このサンプルでは、探索メッセージを別のエンドポイントに転送する方法を示します。  
+  
+## 使用例  
+ 探索ルーティング  
+  
+## 説明  
+ 探索ルーティングは、プロキシがサービスを認識しないが、別のプロキシのことは認識する場合に、クライアントがプロキシを使用してそのようなサービスを検索するシナリオで役に立ちます。このプロキシは、探索パケットをこのクライアントから 2 番目のプロキシに転送できます。2 番目のプロキシはサービスを検索し、応答を元のクライアントに返します。  
+  
+ このサンプルでは、クライアントはメッセージを探索ルーティング コンポーネントに送信します。このメッセージは、探索ルーター上の特定のエンドポイントに送信されます。その後、このルーターはメッセージを UDP マルチキャスト エンドポイントに転送します。プローブ メッセージはマルチキャスト エンドポイントに送信され、UDP マルチキャスト アドレスをリッスンするサービスは、その探索ルーターに応答します。探索ルーターは応答を収集し、クライアントにその応答を返します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルをビルドします。  
+  
+2.  DiscoveryRouter 実行可能ファイルを実行します。  
+  
+3.  ビルド ディレクトリからサービス実行可能ファイルを実行します。  
+  
+4.  クライアント実行可能ファイルを実行します。クライアントでサービスが検索されることに注意してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\DiscoveryRouter`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-samples.md b/docs/framework/wcf/samples/discovery-samples.md
new file mode 100644
index 00000000000..e34173dc86c
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-samples.md
@@ -0,0 +1,54 @@
+---
+title: "探索 (サンプル) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 522a00b4-a789-4e8c-b8d7-a4c3d863a182
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 探索 (サンプル)
+このセクションには、探索機能関連のサンプルが含まれています。  
+  
+## このセクションの内容  
+ [アナウンス](../../../../docs/framework/wcf/samples/announcements-sample.md)  
+ 探索機能を使用したアナウンスを使用する方法を示します。  
+  
+ [非同期検索](../../../../docs/framework/wcf/samples/asynchronous-find-sample.md)  
+ すべての電卓サービスを検索する非同期検索を実行する方法を示します。  
+  
+ [Basic](../../../../docs/framework/wcf/samples/basic-sample.md)  
+ プログラムでサービスを探索可能にする方法と、<xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用してそのサービスを検索する方法を示します。  
+  
+ [構成](../../../../docs/framework/wcf/samples/configuration-sample.md)  
+ 構成ファイルを使用してサービスを探索可能にする方法と、構成によって <xref:System.ServiceModel.Discovery.DynamicEndpoint> を使用してそのサービスを検索する方法を示します。  
+  
+ [探索バインディング要素のサンプル](../../../../docs/framework/wcf/samples/discovery-binding-element-sample.md)  
+ 探索バインディング要素をカスタム バインディングに追加する方法を示します。これにより、チャネルが開いている場合にクライアントでサービスを探索できるようになります。  
+  
+ [探索プロキシのサンプル](../../../../docs/framework/wcf/samples/discovery-proxy-sample.md)  
+ 既存のサービスに関する情報を格納するために探索プロキシの実装を作成する方法と、クライアントからそのプロキシに情報のクエリを行う方法を示します。  
+  
+ [一意の ListenUri モードのサンプルを使用したサービスの探索](../../../../docs/framework/wcf/samples/discover-a-service-with-unique-listen-uri-mode-sample.md)  
+ <xref:System.ServiceModel.Channels.BindingContext.ListenUriMode%2A> プロパティが <xref:System.ServiceModel.Description.ListenUriMode> に設定されているサービスを探索する方法を示します。  
+  
+ [スコープを使用した探索](../../../../docs/framework/wcf/samples/discovery-with-scopes-sample.md)  
+ スコープを使用して探索可能なエンドポイントを分類する方法と、<xref:System.ServiceModel.Discovery.DiscoveryClient> を使用してエンドポイントの非同期検索を実行する方法を示します。  
+  
+ [カスタム検索基準](../../../../docs/framework/wcf/samples/custom-find-criteria.md)  
+ ロジックを使用するカスタム スコープ一致の作成方法とカスタム探索サービスの実装方法を示します。  
+  
+ [ワークフローの探索のサンプル](../../../../docs/framework/wcf/samples/workflow-discovery-sample.md)  
+ ワークフロー サービスを探索可能にする方法と、特定のサービスを検索するカスタム コード アクティビティを作成する方法を示します。  
+  
+ [探索ルーター サービス](../../../../docs/framework/wcf/samples/discovery-router-service.md)  
+ 探索メッセージを別のエンドポイントに転送する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-security-sample.md b/docs/framework/wcf/samples/discovery-security-sample.md
new file mode 100644
index 00000000000..f8683c8050d
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-security-sample.md
@@ -0,0 +1,86 @@
+---
+title: "探索のセキュリティのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8db01f4-b4a1-43fe-8e31-26d4e9304a65
+caps.latest.revision: 13
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 13
+---
+# 探索のセキュリティのサンプル
+Discovery 仕様では、探索プロセスに参加するエンドポイントをセキュリティで保護する必要はありません。  探索メッセージをセキュリティで強化することで、さまざまな種類の攻撃 \(メッセージの改ざん、サービス拒否、リプレイ、なりすまし\) が軽減されます。  このサンプルでは、コンパクトな署名形式 \(WS\-Discovery 仕様のセクション 8.2 を参照\) を使用してメッセージ署名の計算と検証を行うカスタム チャネルの実装方法を示します。  このサンプルは、[2005 年版](http://go.microsoft.com/fwlink/?LinkId=177912)と[バージョン 1.1](http://go.microsoft.com/fwlink/?LinkId=179677) の両方の Discovery の仕様に対応しています。  
+  
+ カスタム チャネルは、探索エンドポイントおよびアナウンス エンドポイントの既存のチャネル スタックの上に適用されます。  これにより、署名ヘッダーがすべての送信メッセージに適用されます。  署名は受信メッセージで検証され、署名が一致しない場合やメッセージに署名がない場合、そのメッセージは破棄されます。  このサンプルでは、メッセージの署名と検証を行うために証明書を使用します。  
+  
+## 説明  
+ WCF は拡張性が非常に高く、ユーザーは必要に応じてチャネルをカスタマイズできます。  このサンプルでは、セキュリティで保護されたチャネルを作成する、探索のセキュリティ保護されたバインディング要素を実装します。  セキュリティで保護されたチャネルは、メッセージ署名を適用および検証します。このチャネルは現在のスタックの上に適用されます。  
+  
+ セキュリティ保護されたバインディング要素は、セキュリティで保護されたチャネル ファクトリとチャネル リスナーを作成します。  
+  
+## セキュリティで保護されたチャネル ファクトリ  
+ セキュリティで保護されたチャネル ファクトリは、メッセージ ヘッダーにコンパクトな署名を追加する出力チャネルまたは双方向チャネルを作成します。  メッセージをできるだけ小さくするために、コンパクトな署名形式が使用されます。  コンパクトな署名の構造の例を次に示します。  
+  
+```  
+<d:Security ... >   
+  [<d:Sig Scheme="xs:anyURI"   
+         [KeyId="xs:base64Binary"]?  
+          Refs="..."  
+         [PrefixList]=”xs:NMTOKENS”   
+          Sig="xs:base64Binary"   
+          ... />]?  
+  ...   
+</d:Security>  
+  
+```  
+  
+> [!NOTE]
+>  `PrefixList` は、Discovery プロトコルの 2008 バージョンで追加されました。  
+  
+ このサンプルでは、署名を計算するために、展開される署名のアイテムを特定します。  WS\-Discovery 仕様の規定のとおり、XML 署名 \(`SignedInfo`\) が `ds` 名前空間プレフィックスを使用して作成されます。  探索の本文とすべてのヘッダーおよびアドレス名前空間は署名で参照されるため、改ざんされることはありません。  参照される各要素が排他的正規化 \(http:\/\/www.w3.org\/2001\/10\/xml\-exc\-c14n\#\) を使用して変換され、SHA\-1 ダイジェスト \(http:\/\/www.w3.org\/2000\/09\/xmldsig\#sha1\) の値が計算されます。  参照されるすべての要素とそのダイジェストの値に基づいて、RSA アルゴリズム \(http:\/\/www.w3.org\/2000\/09\/xmldsig\#rsa\-sha1\) を使用して署名の値が計算されます。  
+  
+ メッセージは、クライアントが指定した証明書を使用して署名されます。  バインディング要素の作成時に、ストアの場所、名前、および証明書のサブジェクト名を指定する必要があります。  コンパクトな署名の `KeyId` は、署名トークンのキー識別子を表します。これは、署名トークンのサブジェクト キー識別子 \(SKI\) か、署名トークンの公開キーの SHA\-1 ハッシュ \(SKI が存在しない場合\) です。  
+  
+## セキュリティで保護されたチャネル リスナー  
+ セキュリティで保護されたチャネル リスナーは、受信メッセージのコンパクトな署名を検証する入力チャネルまたは双方向チャネルを作成します。  署名を検証するために、メッセージに結び付けられているコンパクトな署名で指定された `KeyId` を使用して、指定されたストアから証明書が選択されます。  メッセージに署名がない場合や署名のチェックに失敗した場合、そのメッセージは破棄されます。  このサンプルでは、セキュリティで保護されたバインディングを使用するために、探索のセキュリティ保護されたバインディング要素が追加されたカスタムの <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> と <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint> を作成するファクトリを定義します。  これらのセキュリティで保護されたエンドポイントは、探索アナウンス リスナーや探索サービスで使用できます。  
+  
+## サンプルの詳細  
+ このサンプルには、1 つのライブラリと 4 つのコンソール アプリケーションが含まれています。  
+  
+-   **DiscoverySecurityChannels**: セキュリティで保護されたバインディングを公開するライブラリ。  このライブラリは、送信\/受信メッセージのコンパクトな署名の計算と検証を行います。  
+  
+-   **Service**: ICalculatorService コントラクトを公開するサービス \(自己ホスト型\)。  このサービスは、Discoverable としてマークされます。  メッセージの署名に使用する証明書の詳細はユーザーが指定します。ストアの場所と名前、証明書のサブジェクト名またはその他の一意の識別子、およびクライアント証明書 \(受信メッセージの署名のチェックに使用する証明書\) の保存場所を指定します。  これらの詳細に基づいて、セキュリティが追加された UdpDiscoveryEndpoint が作成されて使用されます。  
+  
+-   **Client**: このクラスは、ICalculatorService の探索と、サービスに対するメソッドの呼び出しを試行します。  ここでも、メッセージの署名と検証を行うために、セキュリティが追加された <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint> が作成されて使用されます。  
+  
+-   **AnnouncementListener**: オンラインおよびオフラインのアナウンスをリッスンし、セキュリティで保護されたアナウンス エンドポイントを使用する自己ホスト型のサービス。  
+  
+> [!NOTE]
+>  Setup.bat を複数回実行すると、証明書が重複し、証明書マネージャーから、追加する証明書を選択するように求められます。  その場合は、既に重複が作成されているため、Setup.bat を中止して Cleanup.bat を呼び出します。  Cleanup.bat でも、削除する証明書を選択するように求められます。  一覧から証明書を選択し、残っている証明書がなくなるまで Cleanup.bat を実行します。  
+  
+#### このサンプルを使用するには  
+  
+1.  Visual Studio コマンド プロンプトから Setup.bat スクリプトを実行します。  このサンプルでは、証明書を使用してメッセージの署名と検証を行います。  スクリプトによって、証明書が Makecert.exe を使用して作成され、Certmgr.exe を使用してインストールされます。  このスクリプトは、管理者権限で実行する必要があります。  
+  
+2.  サンプルをビルドして実行するには、Visual Studio で Security.sln ファイルを開き、**\[すべてリビルド\]** を選択します。  複数のプロジェクトを起動するようにソリューションのプロパティを更新します。ここでは、DiscoverySecureChannels を除くすべてのプロジェクトで **\[開始\]** を選択します。  通常どおりソリューションを実行します。  
+  
+3.  サンプルの作業が終了したら、このサンプルで作成した証明書を削除する Cleanup.bat スクリプトを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\DiscoveryScenario`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/discovery-with-scopes-sample.md b/docs/framework/wcf/samples/discovery-with-scopes-sample.md
new file mode 100644
index 00000000000..09e9f7c8f76
--- /dev/null
+++ b/docs/framework/wcf/samples/discovery-with-scopes-sample.md
@@ -0,0 +1,47 @@
+---
+title: "スコープを使用した探索のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a37a754-6b8c-4ebe-bdf2-d4f0520271d5
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# スコープを使用した探索のサンプル
+このサンプルでは、スコープを使用して、探索可能なエンドポイントを分類する方法、および <xref:System.ServiceModel.Discovery.DiscoveryClient> を使用して、エンドポイントの非同期検索を実行する方法を示します。サービスに関しては、エンドポイント探索動作を追加し、その動作を使用してエンドポイントにスコープを追加し、さらにエンドポイントの探索可能性を制御することによって、各エンドポイントの探索をカスタマイズする方法を示します。クライアントに関しては、<xref:System.ServiceModel.Discovery.DiscoveryClient> を作成し、<xref:System.ServiceModel.Discovery.FindCriteria> にスコープを追加してスコープが条件となるように検索パラメーターを最適に調整する方法を示します。また、終了条件を追加することによってクライアントで応答を制限する方法も示します。  
+  
+## サービス機能  
+ このプロジェクトでは、<xref:System.ServiceModel.ServiceHost> に 2 つのサービス エンドポイントを追加します。各エンドポイントには <xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior> が関連付けられます。この動作は、両方のエンドポイントの URI スコープを追加するために使用します。スコープは、クライアントが検索を最適に調整できるように、これらのエンドポイントを区別するために使用します。2 番目のエンドポイントについては、<xref:System.ServiceModel.Discovery.EndpointDiscoveryBehavior.Enabled%2A> プロパティを `false` に設定して探索可能性を無効にすることができます。これにより、このエンドポイントに関連付けられている探索メタデータが探索メッセージの一部として送信されなくなります。  
+  
+## クライアント機能  
+ `FindCalculatorServiceAddress()` メソッドは、<xref:System.ServiceModel.Discovery.DiscoveryClient> を使用し、2 つの制限が設定された <xref:System.ServiceModel.Discovery.FindCriteria> を渡す方法を示します。スコープを条件に追加し、<xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> プロパティを 1 に設定します。このスコープにより、同じスコープを公開するサービスのみに結果が限定されます。<xref:System.ServiceModel.Discovery.FindCriteria.MaxResults%2A> を 1 に設定すると、<xref:System.ServiceModel.Discovery.DiscoveryClient> が待機する応答が最大で 1 つのエンドポイントに制限されます。<xref:System.ServiceModel.Discovery.DiscoveryClient.Find%2A> の呼び出しは、タイムアウトになるかエンドポイントが 1 つ見つかるまでスレッドをブロックする同期操作です。  
+  
+#### このサンプルを使用するには  
+  
+1.  このサンプルでは HTTP エンドポイントを使用します。このサンプルを実行するには、適切な URL ACL を追加する必要があります。詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照してください。管理特権で次のコマンドを実行すると、適切な ACL が追加されます。そのままではコマンドが動作しない場合は、代わりに、お使いのドメインとユーザー名を引数に指定して実行してみてください。`netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%`  
+  
+2.  ソリューションをビルドします。  
+  
+3.  ビルド ディレクトリからサービス実行可能ファイルを実行します。  
+  
+4.  クライアント実行可能ファイルを実行します。クライアントでサービスを検索できることに注意してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\DiscoveryWithScopes`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/dispatch-by-body-element.md b/docs/framework/wcf/samples/dispatch-by-body-element.md
new file mode 100644
index 00000000000..061038d93e1
--- /dev/null
+++ b/docs/framework/wcf/samples/dispatch-by-body-element.md
@@ -0,0 +1,191 @@
+---
+title: "本文要素別のディスパッチ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f64a3c04-62b4-47b2-91d9-747a3af1659f
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 本文要素別のディスパッチ
+このサンプルでは、入力メッセージを操作に割り当てるための代替アルゴリズムを実装する方法を示します。  
+  
+ 既定では、サービス モデル ディスパッチャは、メッセージの WS\-Addressing の "Action" ヘッダーまたは HTTP SOAP 要求でのこれと同等の情報に基づいて、入力メッセージの適切な処理メソッドを選択します。  
+  
+ WS\-I Basic Profile 1.1 のガイドラインに従っていない SOAP 1.1 Web サービス スタックの一部では、Action URI に基づくのではなく、SOAP 本文内にある最初の要素の XML 修飾名に基づいてメッセージをディスパッチします。  同様に、クライアント側のこうしたスタックでは、空または任意の HTTP SoapAction ヘッダーが含まれるメッセージを送信する場合があります。これは SOAP 1.1 の仕様で許可されていました。  
+  
+ メッセージをメソッドにディスパッチする方法を変更するために、このサンプルでは <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> 拡張インターフェイスを `DispatchByBodyElementOperationSelector` に実装します。  このクラスは、メッセージ本文の最初の要素に基づいて操作を選択します。  
+  
+ クラス コンストラクタには、`XmlQualifiedName` と文字列のペアが記録されたディクショナリが必要です。この修飾名は SOAP 本文の最初の子の名前を示し、文字列は該当する操作名を示します。  `defaultOperationName` は、このディクショナリで照合できないすべてのメッセージを受信する操作の名前です。  
+  
+```  
+class DispatchByBodyElementOperationSelector : IDispatchOperationSelector  
+{  
+    Dictionary<XmlQualifiedName, string> dispatchDictionary;  
+    string defaultOperationName;  
+  
+    public DispatchByBodyElementOperationSelector(Dictionary<XmlQualifiedName,string> dispatchDictionary, string defaultOperationName)  
+    {  
+        this.dispatchDictionary = dispatchDictionary;  
+        this.defaultOperationName = defaultOperationName;  
+    }  
+```  
+  
+ <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector.SelectOperation%2A> インターフェイスにはメソッドが 1 つしかないので、<xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> を実装すると、ビルドが非常に簡単です。  このメソッドでの処理は、入力メッセージを検査し、現在のエンドポイントのサービス コントラクトでのメソッド名と同じ文字列を返すことです。  
+  
+ このサンプルでは、操作セレクタは <xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A> を通じて、入力メッセージの本文の <xref:System.Xml.XmlDictionaryReader> を取得します。  このメソッドは既にリーダーをメッセージ本文の最初の子に配置しています。そのため、現在の要素の名前と名前空間の URI を取得して、それらを `XmlQualifiedName` に結合することは簡単です。その後、これは操作セレクタによって保持されているディクショナリから対応する操作を検索する際に使用されます。  
+  
+```  
+public string SelectOperation(ref System.ServiceModel.Channels.Message message)  
+{  
+    XmlDictionaryReader bodyReader = message.GetReaderAtBodyContents();  
+    XmlQualifiedName lookupQName = new  
+       XmlQualifiedName(bodyReader.LocalName, bodyReader.NamespaceURI);  
+    message = CreateMessageCopy(message,bodyReader);  
+    if (dispatchDictionary.ContainsKey(lookupQName))  
+    {  
+         return dispatchDictionary[lookupQName];  
+    }  
+    else  
+    {  
+        return defaultOperationName;  
+    }  
+}  
+```  
+  
+ <xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A>、またはメッセージ本文のコンテンツへのアクセスを提供する他のメソッドを使用してメッセージ本文にアクセスすると、そのメッセージは "read" とマークされます。つまり、メッセージは以降の処理に対して無効になります。  したがって、操作セレクタは次のコードに示すメソッドを使用して入力メッセージのコピーを作成します。  リーダーの位置は検査中には変更されていないので、新しく作成されたメッセージはこれを参照できます。入力メッセージのプロパティとヘッダーもこの新しいメッセージにコピーされるので、その結果、元のメッセージの完全な複製ができあがります。  
+  
+```  
+  
+private Message CreateMessageCopy(Message message,   
+                                     XmlDictionaryReader body)  
+{  
+    Message copy = Message.CreateMessage(message.Version,message.Headers.Action,body);  
+    copy.Headers.CopyHeaderFrom(message,0);  
+    copy.Properties.CopyProperties(message.Properties);  
+    return copy;  
+}  
+  
+```  
+  
+## サービスへの操作セレクタの追加  
+ サービス ディスパッチ操作セレクタは [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ディスパッチャに対する拡張機能です。  二重のコントラクトのコールバック チャネルでメソッドを選択する場合、クライアントの操作セレクタも存在します。この操作セレクタはここで説明するディスパッチ操作セレクタと非常によく似ていますが、このサンプルでは明示的には説明しません。  
+  
+ ディスパッチ操作セレクタはほとんどのサービス モデル拡張と同様、動作を使用してディスパッチャに追加されます。  *動作*とは構成オブジェクトのことで、1 つまたは複数の拡張機能をディスパッチ ランタイム \(またはクライアント ランタイム\) に追加します。追加しない場合は、そのランタイムの設定を変更します。  
+  
+ 操作セレクタにはコントラクトのスコープがあるので、ここで実装する適切な動作は <xref:System.ServiceModel.Description.IContractBehavior> です。  このインターフェイスは、次のコードに示すように <xref:System.Attribute> 派生クラスに実装されているため、この動作は任意のサービス コントラクトに宣言として追加できます。  <xref:System.ServiceModel.ServiceHost> が開いてディスパッチ ランタイムがビルドされるたびに、コントラクト、操作、およびサービス実装の属性の形をとるか、またはサービス構成内の要素の形をとるすべての動作が自動的に追加され、その後拡張機能の支援または既定の構成の変更を求められます。  
+  
+ 次のコードの抜粋では、簡略化のため、メソッド <xref:System.ServiceModel.Description.IContractBehavior.ApplyDispatchBehavior%2A> の実装のみを示します。これは、このサンプルのディスパッチャの構成変更に影響します。  他のメソッドが表示されていないのは、何の処理も行わずに呼び出し元に返されるためです。  
+  
+```  
+[AttributeUsage(AttributeTargets.Class|AttributeTargets.Interface)]  
+class DispatchByBodyElementBehaviorAttribute : Attribute, IContractBehavior  
+{  
+    // public void AddBindingParameters(...)   
+    // public void ApplyClientBehavior(...)  
+    // public void Validate(...)  
+```  
+  
+ 最初に、<xref:System.ServiceModel.Description.IContractBehavior.ApplyDispatchBehavior%2A> を実装し、サービス エンドポイントの <xref:System.ServiceModel.Description.ContractDescription> の <xref:System.ServiceModel.Description.OperationDescription> 要素を反復処理することによって、操作セレクタの検索ディクショナリを設定します。  次に、各操作の記述に `DispatchBodyElementAttribute` 動作が存在するかどうかが検査されます。この動作は、このサンプルでも定義されている <xref:System.ServiceModel.Description.IOperationBehavior> の実装です。  このクラスも動作の 1 つですが、パッシブな動作です。ディスパッチ ランタイムに対して構成変更をアクティブに支援することはありません。  このすべてのメソッドは、アクションを起こすことなく呼び出し元に返されます。  この操作の動作は、新しいディスパッチ機構に必要なメタデータ、つまり見つかった場合に操作で選択される本文要素の修飾名を、該当する操作に関連付ける目的でのみ存在します。  
+  
+ このような動作が見つかると、XML 修飾名 \(`QName` プロパティ\) と操作名 \(`Name` プロパティ\) から作成された値のペアがディクショナリに追加されます。  
+  
+ ディクショナリが設定されると、新しい `DispatchByBodyElementOperationSelector` がこの情報で構築され、ディスパッチ ランタイムの操作セレクタとして設定されます。  
+  
+```  
+public void ApplyDispatchBehavior(ContractDescription contractDescription, ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.DispatchRuntime dispatchRuntime)  
+{  
+    Dictionary<XmlQualifiedName,string> dispatchDictionary =   
+                     new Dictionary<XmlQualifiedName,string>();  
+    foreach( OperationDescription operationDescription in   
+                              contractDescription.Operations )  
+    {  
+        DispatchBodyElementAttribute dispatchBodyElement =   
+   operationDescription.Behaviors.Find<DispatchBodyElementAttribute>();  
+        if ( dispatchBodyElement != null )  
+        {  
+             dispatchDictionary.Add(dispatchBodyElement.QName,   
+                              operationDescription.Name);  
+        }  
+    }  
+    dispatchRuntime.OperationSelector =   
+            new DispatchByBodyElementOperationSelector(  
+               dispatchDictionary,   
+               dispatchRuntime.UnhandledDispatchOperation.Name);  
+    }  
+}  
+```  
+  
+## サービスの実装  
+ このサンプルに実装されている動作は、通信回線からのメッセージの解釈方法とディスパッチ方法に直接影響します。これはサービス コントラクトの機能です。  そのため、この動作を使用することを選択したサービス実装では、この動作をサービス コントラクト レベルで宣言する必要があります。  
+  
+ サンプル プロジェクト service は `DispatchByBodyElementBehaviorAttribute` コントラクトの動作を `IDispatchedByBody` サービス コントラクトに適用し、2 つの操作 `OperationForBodyA()` と `OperationForBodyB()` のそれぞれに `DispatchBodyElementAttribute` 操作の動作のラベルを付けます。  このコントラクトを実装しているサービスのサービス ホストが開かれると、このメタデータは前で説明したようにディスパッチャ ビルダによって取得されます。  
+  
+ 操作セレクタはメッセージ本文の要素のみに基づいてディスパッチし、"Action" を無視するので、返された応答の "Action" ヘッダーをチェックしないようランタイムに通知する必要があります。これを行うには、ワイルドカード "\*" を <xref:System.ServiceModel.OperationContractAttribute> の `ReplyAction` プロパティに割り当てます。  さらに、"Action" プロパティを持つ既定の操作をワイルドカード "\*" に設定する必要があります。  既定の操作は、ディスパッチできず、`DispatchBodyElementAttribute` を持たないすべてのメッセージを受信します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"),  
+                            DispatchByBodyElementBehavior]  
+public interface IDispatchedByBody  
+{  
+    [OperationContract(ReplyAction="*"),   
+     DispatchBodyElement("bodyA","http://tempuri.org")]  
+    Message OperationForBodyA(Message msg);  
+    [OperationContract(ReplyAction = "*"),   
+     DispatchBodyElement("bodyB", "http://tempuri.org")]  
+    Message OperationForBodyB(Message msg);  
+    [OperationContract(Action="*", ReplyAction="*")]  
+    Message DefaultOperation(Message msg);  
+}  
+```  
+  
+ このサンプルのサービス実装は簡単です。  どのメソッドも受信メッセージを応答メッセージにラップし、クライアントに再度エコーします。  
+  
+## サンプルの実行とビルド  
+ このサンプルを実行すると、次に示す \(書式設定された\) 出力と同様の、操作応答の内容がクライアントのコンソール ウィンドウに表示されます。  
+  
+ クライアントは 3 つのメッセージをサービスに送信します。このメッセージ本文のコンテンツ要素の名前は、それぞれ `bodyA`、`bodyB`、および `bodyX` です。  以上の説明とサービス コントラクトからわかるように、`bodyA` 要素が含まれる受信メッセージは、`OperationForBodyA()` メソッドにディスパッチされます。  `bodyX` 本文要素が含まれるメッセージについては、明示的なディスパッチ対象がないので、このメッセージは `DefaultOperation()` にディスパッチされます。  各サービス操作は、受信されたメッセージ本文をメソッド固有の要素にラップして返します。このサンプルでは、入力メッセージと出力メッセージを明確に関連付けるためにこの操作を行います。  
+  
+```  
+<?xml version="1.0" encoding="IBM437"?>  
+<replyBodyA xmlns="http://tempuri.org">  
+   <q:bodyA xmlns:q="http://tempuri.org">test</q:bodyA>  
+</replyBodyA>  
+<?xml version="1.0" encoding="IBM437"?>  
+<replyBodyB xmlns="http://tempuri.org">  
+  <q:bodyB xmlns:q="http://tempuri.org">test</q:bodyB>  
+</replyBodyB>  
+<?xml version="1.0" encoding="IBM437"?>  
+<replyDefault xmlns="http://tempuri.org">  
+   <q:bodyX xmlns:q="http://tempuri.org">test</q:bodyX>  
+</replyDefault>  
+  
+```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Interop\AdvancedDispatchByBody`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/duplex.md b/docs/framework/wcf/samples/duplex.md
new file mode 100644
index 00000000000..af18c355a5b
--- /dev/null
+++ b/docs/framework/wcf/samples/duplex.md
@@ -0,0 +1,209 @@
+---
+title: "二重 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "二重のサービス コントラクト"
+ms.assetid: bc5de6b6-1a63-42a3-919a-67d21bae24e0
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# 二重
+双方向サンプルでは、双方向コントラクトを定義して実装する方法を示します。  双方向通信は、クライアントがサービスとのセッションを確立し、サービスからクライアントにメッセージを返信できるチャネルがサービスに提供されると発生します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  双方向コントラクトは、クライアントからサービスへのプライマリ インターフェイスとサービスからクライアントへのコールバック インターフェイスという 2 つのインターフェイスのペアとして定義されます。  このサンプルでは、`ICalculatorDuplex` インターフェイスを使用することにより、クライアントは算術演算を実行し、セッション経由で結果を計算できます。  サービスは、`ICalculatorDuplexCallback` インターフェイスで結果を返します。  コンテキストを確立して、クライアントとサービスの間で送信される一連のメッセージを相互に関連付ける必要があるため、二重のコントラクトにはセッションが必要です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) であり、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  双方向コントラクトは、次のように定義されます。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required,  
+                 CallbackContract=typeof(ICalculatorDuplexCallback))]  
+public interface ICalculatorDuplex  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void Clear();  
+    [OperationContract(IsOneWay = true)]  
+    void AddTo(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void SubtractFrom(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void MultiplyBy(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void DivideBy(double n);  
+}  
+  
+public interface ICalculatorDuplexCallback  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void Result(double result);  
+    [OperationContract(IsOneWay = true)]  
+    void Equation(string eqn);  
+}  
+  
+```  
+  
+ `CalculatorService` クラスは、プライマリ `ICalculatorDuplex` インターフェイスを実装します。  このサービスは <xref:System.ServiceModel.InstanceContextMode> インスタンス モードを使用して、各セッションの結果を保持します。  クライアントへのコールバック チャネルへのアクセスには、`Callback` というプライベート プロパティを使用します。  サービスはこのコールバックを使用し、コールバック インターフェイスを介してメッセージをクライアントに返信します。  
+  
+```  
+[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]  
+public class CalculatorService : ICalculatorDuplex  
+{  
+    double result = 0.0D;  
+    string equation;  
+  
+    public CalculatorService()  
+    {  
+        equation = result.ToString();  
+    }  
+  
+    public void Clear()  
+    {  
+        Callback.Equation(equation + " = " + result.ToString());  
+        equation = result.ToString();  
+    }  
+  
+    public void AddTo(double n)  
+    {  
+        result += n;  
+        equation += " + " + n.ToString();  
+        Callback.Result(result);  
+    }  
+    ...  
+    ICalculatorDuplexCallback Callback  
+    {  
+        get  
+        {  
+            return OperationContext.Current.GetCallbackChannel<ICalculatorDuplexCallback>();  
+        }  
+    }  
+}  
+```  
+  
+ クライアントは、サービスからのメッセージを受信するために、双方向コントラクトのコールバック インターフェイスを実装するクラスを提供する必要があります。  このサンプルでは、`CallbackHandler` クラスは `ICalculatorDuplexCallback` インターフェイスを実装するように定義されています。  
+  
+```  
+public class CallbackHandler : ICalculatorDuplexCallback  
+{  
+   public void Result(double result)  
+   {  
+      Console.WriteLine("Result({0})", result);  
+   }  
+  
+   public void Equation(string equation)  
+   {  
+      Console.WriteLine("Equation({0}", equation);  
+   }  
+}  
+  
+```  
+  
+ 双方向コントラクト用に生成されるプロキシは、コンストラクト時に <xref:System.ServiceModel.InstanceContext> が提供される必要があります。  この <xref:System.ServiceModel.InstanceContext> がコールバック インターフェイスを実装するオブジェクトのサイトとして使用され、サービスから返信されるメッセージを処理します。  <xref:System.ServiceModel.InstanceContext> は、`CallbackHandler` クラスのインスタンスを使用して構築されます。  このオブジェクトは、コールバック インターフェイスでサービスからクライアントに送信されるメッセージを処理します。  
+  
+```  
+// Construct InstanceContext to handle messages on callback interface.  
+InstanceContext instanceContext = new InstanceContext(new CallbackHandler());  
+  
+// Create a client.  
+CalculatorDuplexClient client = new CalculatorDuplexClient(instanceContext);  
+  
+Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.");  
+Console.WriteLine();  
+  
+// Call the AddTo service operation.  
+double value = 100.00D;  
+client.AddTo(value);  
+  
+// Call the SubtractFrom service operation.  
+value = 50.00D;  
+client.SubtractFrom(value);  
+  
+// Call the MultiplyBy service operation.  
+value = 17.65D;  
+client.MultiplyBy(value);  
+  
+// Call the DivideBy service operation.  
+value = 2.00D;  
+client.DivideBy(value);  
+  
+// Complete equation.  
+client.Clear();  
+  
+Console.ReadLine();  
+  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+```  
+  
+ この構成は、セッション通信と双方向通信の両方をサポートするバインディングを提供するように変更されています。  `wsDualHttpBinding` はセッション通信をサポートし、どちらの方向にも HTTP 接続が 1 つ用意される双方向 HTTP 接続を提供して双方向通信を実現します。  サービスでの構成の唯一の違いは、使用されるバインディングです。  クライアントで、サーバーがクライアントへの接続に使用するアドレスを構成する必要があります。次のサンプル構成を参照してください。  
+  
+```  
+<client>  
+  <endpoint name=""  
+            address="http://localhost/servicemodelsamples/service.svc"   
+            binding="wsDualHttpBinding"   
+            bindingConfiguration="DuplexBinding"   
+            contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />  
+</client>  
+  
+<bindings>  
+  <!-- Configure a binding that support duplex communication. -->  
+  <wsDualHttpBinding>  
+    <binding name="DuplexBinding"   
+             clientBaseAddress="http://localhost:8000/myClient/">  
+    </binding>  
+  </wsDualHttpBinding>  
+</bindings>  
+  
+```  
+  
+ サンプルを実行すると、クライアントに戻ってきたメッセージがサービスから送信されたコールバック インターフェイスに表示されます。  それぞれの中間結果が表示され、その後にすべての操作が完了したときの数式全体が表示されます。  Enter キーを押してクライアントをシャットダウンします。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版、C\+\+ 版、または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!IMPORTANT]
+    >  複数コンピューター構成でクライアントを実行する場合は、[\<wsDualHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md) 要素内の [endpoint](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の `address` 属性と、[\<binding\>](../../../../docs/framework/misc/binding.md) 要素の `clientBaseAddress` 属性の両方に含まれる "localhost" を、適切なコンピューターの名前で置き換える必要があります。次を参照してください。  
+  
+    ```  
+    <client>  
+    <endpoint name = ""  
+    address="http://service_machine_name/servicemodelsamples/service.svc"  
+    ... />  
+    </client>  
+    ...  
+    <wsDualHttpBinding>  
+    <binding name="DuplexBinding" clientBaseAddress="http://client_machine_name:8000/myClient/">  
+    </binding>  
+    </wsDualHttpBinding>  
+    ```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Duplex`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/durable-instance-context.md b/docs/framework/wcf/samples/durable-instance-context.md
new file mode 100644
index 00000000000..5807765487f
--- /dev/null
+++ b/docs/framework/wcf/samples/durable-instance-context.md
@@ -0,0 +1,470 @@
+---
+title: "永続性インスタンス コンテキスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97bc2994-5a2c-47c7-927a-c4cd273153df
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 永続性インスタンス コンテキスト
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ランタイムをカスタマイズして、永続性インスタンス コンテキストを有効にする方法を示します。バッキング ストアとして、SQL Server 2005 \(この場合は SQL Server 2005 Express\) を使用します。ただし、カスタム ストレージ機構にアクセスする方法も示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のチャネル レイヤとサービス モデル レイヤの両方の拡張が含まれています。したがって、実装の詳細に進む前に基になる概念を理解する必要があります。  
+  
+ 永続性インスタンス コンテキストは、現実のケースでも頻繁に起こりうるものです。たとえば、ショッピング カート アプリケーションには、買い物を中断しても別の日に再開できる機能が用意されています。そのため、ショッピング カートに翌日アクセスすると、元のコンテキストが復元されます。接続が切断されている間、ショッピング カート アプリケーション \(サーバー上\) はショッピング カートのインスタンスを保持しないことに注意してください。その代わり、状態を永続的なストレージ メディアに保持し、復元されたコンテキストの新しいインスタンスを構築するときにこの状態を使用します。したがって、同じコンテキストに対してサービスを提供できるサービス インスタンスは、以前のインスタンスと同じではありません \(つまり、メモリ アドレスが同じではありません\)。  
+  
+ 永続性インスタンス コンテキストは、コンテキスト ID をクライアントとサービス間で交換するための簡単なプロトコルによって可能になります。このコンテキスト ID はクライアント上で作成され、サービスに転送されます。サービス インスタンスが作成されると、サービス上のランタイムは、永続ストレージ \(既定では SQL Server 2005 のデータベース\) 上で永続化されている、このコンテキスト ID に対応する状態を読み込もうとします。利用できる状態がない場合は、新しいインスタンスに既定の状態が設定されます。サービス実装は、カスタム属性を使用してサービス実装の状態を変更する操作の詳細を指定し、ランタイムがその操作を呼び出した後にサービス インスタンスを保存できるようにします。  
+  
+ 前の説明から、目標を達成するための手順は大きく次の 2 つに分けられます。  
+  
+1.  ネットワークに出力されるメッセージを、コンテキスト ID が含まれるように変更します。  
+  
+2.  サービス側のローカル動作を変更して、カスタムのインスタンス化ロジックを実装します。  
+  
+ この一覧の前者の手順は、カスタム チャネルとして実装され、チャネル レイヤにフックされる、ネットワーク上のメッセージに影響します。後者の手順が影響を及ぼすのは、サービスのローカル動作だけです。したがって、いくつかのサービス拡張ポイントを拡張することによって実装できます。以降のセクションでは、こうしたそれぞれの拡張について説明します。  
+  
+## 永続的な InstanceContext チャネル  
+ 最初に、チャネル レイヤの拡張について考えます。カスタム チャネルを記述する最初の手順として、チャネルの通信構造を決定します。新しいワイヤ プロトコルを導入する際には、チャネルはチャネル スタック内の他のほとんどすべてのチャネルに対応する必要があります。そのため、すべてのメッセージ交換パターンをサポートする必要があります。ただし、チャネルの中心的な機能は通信構造に関係なく同じです。具体的には、コンテキスト ID をクライアント側からメッセージに書き込み、サービス側からこのメッセージのコンテキスト ID を読み取って上位レベルに渡します。そのため、すべての永続性インスタンス コンテキスト チャネルの実装に対して抽象基本クラスとして動作する、`DurableInstanceContextChannelBase` クラスが作成されます。このクラスには、共通ステート マシンの管理機能と保護された 2 つのメンバが含まれ、これによってコンテキスト情報をメッセージに適用したり、メッセージからコンテキスト情報を読み取ったりします。  
+  
+```  
+class DurableInstanceContextChannelBase  
+{  
+  //…  
+  protected void ApplyContext(Message message)  
+  {  
+    //…              
+  }  
+  protected string ReadContextId(Message message)  
+  {  
+    //…              
+  }  
+}  
+```  
+  
+ これら 2 つのメソッドは、`IContextManager` 実装を使用して、メッセージへのコンテキスト ID の書き込みと、メッセージからのコンテキスト ID の読み取りを行います \(`IContextManager` は、すべてのコンテキスト マネージャのコントラクトの定義に使用されるカスタム インターフェイスです\)。チャネルは、このコンテキスト ID を、カスタム SOAP ヘッダーか HTTP クッキー ヘッダーのどちらかに含めることができます。各コンテキスト マネージャの実装は、`ContextManagerBase` クラスを継承します。このクラスには、すべてのコンテキスト マネージャについての共通機能が含まれています。このクラスの `GetContextId` メソッドは、コンテキスト ID をクライアント側で生成する際に使用されます。コンテキスト ID が最初に生成されると、このメソッドはこれをテキスト ファイルに保存します。テキスト ファイルの名前は、リモート エンドポイント アドレスによって作成されます \(通常の URI に含まれる、ファイル名として無効な文字は、@ 文字に置き換えられます\)。  
+  
+ コンテキスト ID が後で同じリモート エンドポイントで必要になると、このメソッドは適切なファイルが存在するかどうかをチェックします。ファイルが存在する場合は、コンテキスト ID を読み取って返します。存在しない場合は、新しく生成されたコンテキスト ID を返してこれをファイルに保存します。既定の構成では、これらのファイルは現在のユーザーの一時ディレクトリ内にある ContextStore ディレクトリにあります。ただし、この場所はバインディング要素を使用して構成できます。  
+  
+ コンテキスト ID の転送に使用される機構は構成可能です。HTTP クッキー ヘッダーか、またはカスタム SOAP ヘッダーのどちらかに記述できます。カスタム SOAP ヘッダーに記述する場合は、このプロトコルを HTTP 以外のプロトコル \(TCP や NamedPipes など\) で使用できます。これらの 2 つのオプションは、`MessageHeaderContextManager` と `HttpCookieContextManager` という名前の 2 つのクラスに実装されます。  
+  
+ これらのクラスはどちらも、コンテキスト ID をメッセージに適切に書き込みます。たとえば `MessageHeaderContextManager` クラスでは、`WriteContext` メソッドにより SOAP ヘッダーにコンテキスト ID が書き込まれます。  
+  
+```  
+public override void WriteContext(Message message)  
+{  
+  string contextId = this.GetContextId();  
+  
+  MessageHeader contextHeader =  
+    MessageHeader.CreateHeader(DurableInstanceContextUtility.HeaderName,  
+      DurableInstanceContextUtility.HeaderNamespace,  
+      contextId,   
+      true);  
+  
+  message.Headers.Add(contextHeader);  
+}   
+```  
+  
+ `DurableInstanceContextChannelBase` クラス内の `ApplyContext` メソッドと `ReadContextId` メソッドは、それぞれ `IContextManager.ReadContext` と `IContextManager.WriteContext` を呼び出します。ただし、これらのコンテキスト マネージャは `DurableInstanceContextChannelBase` クラスによって直接作成されるわけではありません。代わりに `ContextManagerFactory` クラスを使用してこの処理が行われます。  
+  
+```  
+IContextManager contextManager =  
+                ContextManagerFactory.CreateContextManager(contextType,   
+                this.contextStoreLocation,   
+                this.endpointAddress);  
+```  
+  
+ `ApplyContext` メソッドは送信チャネルによって呼び出されます。このメソッドは、コンテキスト ID を送信メッセージに挿入します。`ReadContextId` メソッドは受信チャネルによって呼び出されます。このメソッドは、受信メッセージ内でコンテキスト ID を使用できることを確認し、`Message` クラスの `Properties` コレクションにコンテキスト ID を追加します。さらに、コンテキスト ID の読み取りでエラーが発生した場合は `CommunicationException` をスローし、チャネルを中止します。  
+  
+```  
+message.Properties.Add(DurableInstanceContextUtility.ContextIdProperty, contextId);  
+```  
+  
+ 次に進む前に、`Message` クラスの `Properties` コレクションの使用方法について理解することが重要です。通常、この `Properties` コレクションは、チャネル レイヤのデータを下位レベルから上位レベルに渡すときに使用されます。この方法により、必要なデータを、プロトコルの詳細に関係なく一貫した方法で上位レベルに渡すことができます。つまり、チャネル レイヤはコンテキスト ID を、SOAP ヘッダーとしても HTTP クッキー ヘッダーとしても送受信できます。しかし、上位レベルではこうした詳細を認識する必要はありません。チャネル レイヤにより、この情報が `Properties` コレクションで使用できるためです。  
+  
+ `DurableInstanceContextChannelBase` クラスを配備したら、必要な 10 のインターフェイス \(IOutputChannel、IInputChannel、IOutputSessionChannel、IInputSessionChannel、IRequestChannel、IReplyChannel、IRequestSessionChannel、IReplySessionChannel、IDuplexChannel、および IDuplexSessionChannel\) のすべてを実装する必要があります。これらは、使用可能なすべてのメッセージ交換パターン \(データグラム、一方向、双方向、およびセッションフル バリエーション\) と似ています。これらの各実装は前記の基本クラスを継承し、`ApplyContext` と `ReadContexId` を適切に呼び出します。たとえば、IOutputChannel インターフェイスを実装する `DurableInstanceContextOutputChannel` は、メッセージを送信する各メソッドから `ApplyContext` メソッドを呼び出します。  
+  
+```  
+public void Send(Message message, TimeSpan timeout)  
+{  
+    // Apply the context information before sending the message.  
+    this.ApplyContext(message);  
+    //…  
+}   
+```  
+  
+ これに対し、`IInputChannel` インターフェイスを実装する `DurableInstanceContextInputChannel` は、メッセージを受信する各メソッドで `ReadContextId` メソッドを呼び出します。  
+  
+```  
+public Message Receive(TimeSpan timeout)  
+{  
+    //…  
+      ReadContextId(message);  
+      return message;  
+}  
+```  
+  
+ これらのチャネル実装は、これ以外には、チャネル スタック内でチャネル実装の下にあるチャネルへのメソッド呼び出しを代行します。ただし、セッションフル バリエーションには、セッション作成の基になる最初のメッセージに対してのみコンテキスト ID の送信と読み取りを許可する、基本的なロジックがあります。  
+  
+```  
+if (isFirstMessage)  
+{  
+//…  
+    this.ApplyContext(message);  
+    isFirstMessage = false;  
+}  
+```  
+  
+ 次にこうしたチャネル実装は、`DurableInstanceContextBindingElement` クラスと `DurableInstanceContextBindingElementSection` クラスによって [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] チャネル ランタイムに適切に追加されます。バインディング要素とバインディング要素セクションの詳細については、[HttpCookieSession](../../../../docs/framework/wcf/samples/httpcookiesession.md) チャネルのサンプルに関するドキュメントを参照してください。  
+  
+## サービス モデル レイヤの拡張  
+ コンテキスト ID がチャネル レイヤを通過すると、インスタンス化をカスタマイズするようにサービス側の動作を実装できます。このサンプルでは、記憶域マネージャを使用して永続ストアからの状態の読み込みと、永続ストアへの状態の保存が行われます。前述のように、このサンプルにはバッキング ストアとして SQL Server 2005 を使用する記憶域マネージャが用意されています。ただし、この拡張に対してカスタム ストレージ機構を追加することもできます。これを行うには、すべての記憶域マネージャが実装する必要のあるパブリック インターフェイスを宣言します。  
+  
+```  
+public interface IStorageManager  
+{  
+    object GetInstance(string contextId, Type type);  
+    void SaveInstance(string contextId, object state);  
+}  
+```  
+  
+ `SqlServerStorageManager` クラスには、既定の `IStorageManager` 実装が含まれます。`SaveInstance` メソッドでは、指定されたオブジェクトは XmlSerializer を使用してシリアル化され、SQL Server データベースに保存されます。  
+  
+```  
+XmlSerializer serializer = new XmlSerializer(state.GetType());  
+string data;  
+  
+using (StringWriter writer = new StringWriter(CultureInfo.InvariantCulture))  
+{  
+    serializer.Serialize(writer, state);  
+    data = writer.ToString();  
+}  
+  
+using (SqlConnection connection = new SqlConnection(GetConnectionString()))  
+{  
+    connection.Open();  
+  
+    string update = @"UPDATE Instances SET Instance = @instance WHERE ContextId = @contextId";  
+  
+    using (SqlCommand command = new SqlCommand(update, connection))  
+    {  
+        command.Parameters.Add("@instance", SqlDbType.VarChar, 2147483647).Value = data;  
+        command.Parameters.Add("@contextId", SqlDbType.VarChar, 256).Value = contextId;  
+  
+        int rows = command.ExecuteNonQuery();  
+  
+        if (rows == 0)  
+        {  
+            string insert = @"INSERT INTO Instances(ContextId, Instance) VALUES(@contextId, @instance)";  
+            command.CommandText = insert;  
+            command.ExecuteNonQuery();  
+        }  
+    }  
+}  
+```  
+  
+ `GetInstance` メソッドでは、シリアル化されたデータが特定のコンテキスト ID 用に読み取られ、そこから作成されたオブジェクトが呼び出し元に返されます。  
+  
+```  
+object data;  
+using (SqlConnection connection = new SqlConnection(GetConnectionString()))  
+{  
+    connection.Open();  
+  
+    string select = "SELECT Instance FROM Instances WHERE ContextId = @contextId";  
+    using (SqlCommand command = new SqlCommand(select, connection))  
+    {  
+        command.Parameters.Add("@contextId", SqlDbType.VarChar, 256).Value = contextId;  
+        data = command.ExecuteScalar();  
+    }  
+}  
+  
+if (data != null)  
+{  
+    XmlSerializer serializer = new XmlSerializer(type);  
+    using (StringReader reader = new StringReader((string)data))  
+    {  
+        object instance = serializer.Deserialize(reader);  
+        return instance;  
+    }  
+}  
+```  
+  
+ この記憶域マネージャを直接インスタンス化することはできません。その代わりに、`StorageManagerFactory` クラスを使用して、記憶域マネージャの作成に関する詳細から抽出します。このクラスには、指定された型の記憶域マネージャのインスタンスを作成する、1 つの静的メンバ `GetStorageManager` があります。型パラメータが `null` の場合、このメソッドは既定の `SqlServerStorageManager` クラスのインスタンスを作成して返します。さらに指定された型を検証して、それが `IStorageManager` インターフェイスを実装していることを確認します。  
+  
+```  
+public static IStorageManager GetStorageManager(Type storageManagerType)  
+{  
+IStorageManager storageManager = null;  
+  
+if (storageManagerType == null)  
+{  
+    return new SqlServerStorageManager();  
+}  
+else  
+{  
+    object obj = Activator.CreateInstance(storageManagerType);  
+  
+    // Throw if the specified storage manager type does not  
+    // implement IStorageManager.  
+    if (obj is IStorageManager)  
+    {  
+        storageManager = (IStorageManager)obj;  
+    }  
+    else  
+    {  
+        throw new InvalidOperationException(  
+                  ResourceHelper.GetString("ExInvalidStorageManager"));  
+    }  
+  
+    return storageManager;  
+}                  
+}   
+```  
+  
+ 永続ストレージのインスタンスの読み取りや書き込みに必要なインフラストラクチャを実装します。ここで、サービス側の動作を変更するために必要な手順を行う必要があります。  
+  
+ この処理の最初の手順として、チャネル レイヤを通過したコンテキスト ID を現在の InstanceContext に保存する必要があります。InstanceContext とは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ディスパッチャとサービス インスタンス間のリンクとして動作するランタイム コンポーネントです。これを使用すると、追加の状態と動作をサービス インスタンスに提供できます。セッションの多い通信では、コンテキスト ID は最初のメッセージだけに含まれて送信されるので、これが重要になります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、拡張可能オブジェクト パターンを使用して、新しい状態および動作を追加することにより、InstanceContext ランタイム コンポーネントを拡張できます。拡張可能オブジェクト パターンは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、既存のランタイム クラスに新しい機能を付け加えて拡張するため、またはオブジェクトに新しい状態の機能を追加するために使用されます。拡張オブジェクト パターンには、IExtensibleObject\<T\>、IExtension\<T\>、および IExtensionCollection\<T\> の 3 つのインターフェイスがあります。  
+  
+-   ExtensibleObject\<T\> インターフェイスは、機能をカスタマイズするための拡張が可能なオブジェクトによって実装されます。  
+  
+-   IExtension\<T\> インターフェイスは、T 型のクラスの拡張であるオブジェクトによって実装されます。  
+  
+-   IExtensionCollection\<T\> インターフェイスは IExtensions のコレクションで、型ごとに IExtensions を取得できます。  
+  
+ このため、IExtension インターフェイスを実装して、コンテキスト ID を保存するために必要な状態を定義する、InstanceContextExtension クラスを作成する必要があります。このクラスではさらに、使用される記憶域マネージャを保持する状態も提供されます。新しい状態が保存された後では、その状態を変更できません。したがって、インスタンスが作成される際、読み取り専用のプロパティを使用してのみアクセス可能になった時点で、状態がインスタンスに提供され、保存されます。  
+  
+```  
+// Constructor  
+public DurableInstanceContextExtension(string contextId,   
+            IStorageManager storageManager)  
+{  
+    this.contextId = contextId;  
+    this.storageManager = storageManager;              
+}  
+  
+// Read only properties  
+public string ContextId  
+{  
+    get { return this.contextId; }  
+}  
+  
+public IStorageManager StorageManager  
+{  
+    get { return this.storageManager; }              
+}   
+```  
+  
+ InstanceContextInitializer クラスは IInstanceContextInitializer インターフェイスを実装し、作成された InstanceContext の Extensions コレクションにインスタンス コンテキスト拡張を追加します。  
+  
+```  
+public void Initialize(InstanceContext instanceContext, Message message)  
+{  
+    string contextId =   
+  (string)message.Properties[DurableInstanceContextUtility.ContextIdProperty];  
+  
+    DurableInstanceContextExtension extension =  
+                new DurableInstanceContextExtension(contextId,   
+                     storageManager);  
+    instanceContext.Extensions.Add(extension);  
+}  
+```  
+  
+ 既に説明したように、コンテキスト ID は `Message` クラスの `Properties` コレクションから読み取られ、拡張クラスのコンストラクタに渡されます。これによって、レイヤ間で情報を交換する場合の一貫性のある方法が示されます。  
+  
+ 次の重要な手順は、サービス インスタンスの作成手順をオーバーライドすることです。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用すると、カスタマイズされたインスタンス化動作を実装し、IInstanceProvider インターフェイスを使用してこれをランタイムにフックできます。新しい `InstanceProvider` クラスがこの処理を行うために実装されます。コンストラクタでは、インスタンス プロバイダから予期されるサービス型が受け入れられます。これは、後で新しいインスタンスの作成に使用されます。`GetInstance` 実装では、永続するインスタンスを検索する記憶域マネージャのインスタンスが作成されます。`null` が返された場合、サービス型の新しいインスタンスがインスタンス化され、呼び出し元に返されます。  
+  
+```  
+public object GetInstance(InstanceContext instanceContext, Message message)  
+{  
+    object instance = null;  
+  
+    DurableInstanceContextExtension extension =  
+    instanceContext.Extensions.Find<DurableInstanceContextExtension>();  
+  
+    string contextId = extension.ContextId;  
+    IStorageManager storageManager = extension.StorageManager;              
+  
+    instance = storageManager.GetInstance(contextId, serviceType);          
+  
+    if (instance == null)  
+    {  
+        instance = Activator.CreateInstance(serviceType);  
+    }  
+  
+    return instance;  
+}  
+```  
+  
+ 次の重要な手順は、`InstanceContextExtension` クラス、`InstanceContextInitializer` クラス、および `InstanceProvider` クラスをサービス モデル ランタイムにインストールすることです。カスタム属性を使用すると、サービス実装クラスの詳細を指定して、動作をインストールできます。`DurableInstanceContextAttribute` にはこの属性の実装が含まれ、サービス側のランタイム全体を拡張できるようにするために `IServiceBehavior` インターフェイスを実装します。  
+  
+ このクラスには、使用される記憶域マネージャの型を受け入れるプロパティがあります。このようにして実装を行うことにより、ユーザー独自の `IStorageManager` 実装を、この属性のパラメータとして指定できます。  
+  
+ `ApplyDispatchBehavior` 実装では、現在の `ServiceBehavior` 属性の `InstanceContextMode` が検証されます。このプロパティが Singleton に設定されている場合、永続性インスタンスを有効化できず、`InvalidOperationException` がスローされてホストに通知されます。  
+  
+```  
+ServiceBehaviorAttribute serviceBehavior =  
+    serviceDescription.Behaviors.Find<ServiceBehaviorAttribute>();  
+  
+if (serviceBehavior != null &&  
+     serviceBehavior.InstanceContextMode == InstanceContextMode.Single)  
+{  
+    throw new InvalidOperationException(  
+       ResourceHelper.GetString("ExSingeltonInstancingNotSupported"));  
+}  
+```  
+  
+ この後、記憶域マネージャのインスタンス、インスタンス コンテキストの初期化子、およびインスタンス プロバイダが作成され、各エンドポイント用に作成された `DispatchRuntime` にインストールされます。  
+  
+```  
+IStorageManager storageManager =   
+    StorageManagerFactory.GetStorageManager(storageManagerType);  
+  
+InstanceContextInitializer contextInitializer =  
+    new InstanceContextInitializer(storageManager);  
+  
+InstanceProvider instanceProvider =  
+    new InstanceProvider(description.ServiceType);  
+  
+foreach (ChannelDispatcherBase cdb in serviceHostBase.ChannelDispatchers)  
+{  
+    ChannelDispatcher cd = cdb as ChannelDispatcher;  
+  
+    if (cd != null)  
+    {  
+        foreach (EndpointDispatcher ed in cd.Endpoints)  
+        {  
+            ed.DispatchRuntime.InstanceContextInitializers.Add(contextInitializer);  
+            ed.DispatchRuntime.InstanceProvider = instanceProvider;  
+        }  
+    }  
+}  
+```  
+  
+ ここまでを要約すると、このサンプルでは、カスタム コンテキスト ID を交換するためにカスタム ワイヤ プロトコルを有効化するチャネルを作成しました。また、永続ストレージのインスタンスを読み込むように、既定のインスタンス化動作を上書きしました。  
+  
+ 残りの手順は、サービス インスタンスを永続ストレージに保存することです。既に説明したとおり、`IStorageManager` 実装に状態を保存するには、あらかじめ必要な機能があります。次に、この機能を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムと統合する必要があります。これを行うには、サービス実装クラスのメソッドに適用可能な別の属性が必要です。つまりこの属性は、サービス インスタンスの状態を変更するメソッドに適用できることが必要です。  
+  
+ この機能は、`SaveStateAttribute` クラスに実装されています。このクラスには、各操作の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムを変更する `IOperationBehavior` クラスも実装されています。メソッドの詳細がこの属性で指定されると、適切な `DispatchOperation` が作成される際に、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムが `ApplyBehavior` メソッドを呼び出します。このメソッドの実装のコードは 1 行です。  
+  
+```  
+dispatch.Invoker = new OperationInvoker(dispatch.Invoker);  
+```  
+  
+ この手順により `OperationInvoker` 型のインスタンスが作成され、作成される `DispatchOperation` の `Invoker` プロパティに割り当てられます。`OperationInvoker` クラスは、`DispatchOperation` 用に作成された既定の操作呼び出しのラッパーです。このクラスは、`IOperationInvoker` インターフェイスを実装します。`Invoke` メソッドの実装では、実際のメソッド呼び出しは内部の操作呼び出しで代行されます。ただし、この結果が返される前に `InstanceContext` の記憶域マネージャが使用され、サービス インスタンスが保存されます。  
+  
+```  
+object result = innerOperationInvoker.Invoke(instance,  
+    inputs, out outputs);  
+  
+// Save the instance using the storage manager saved in the   
+// current InstanceContext.  
+InstanceContextExtension extension =  
+    OperationContext.Current.InstanceContext.Extensions.Find<InstanceContextExtension>();  
+  
+extension.StorageManager.SaveInstance(extension.ContextId, instance);  
+return result;  
+```  
+  
+## 拡張機能の使用  
+ チャネル レイヤとサービス モデル レイヤの拡張を完了すると、どちらも [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションで使用できるようになります。サービスでは、カスタム バインディングを使用してチャネルをチャネル スタックに追加し、サービス実装クラスの詳細を適切な属性で指定する必要があります。  
+  
+```  
+[DurableInstanceContext]  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+public class ShoppingCart : IShoppingCart  
+{  
+//…  
+     [SaveState]  
+     public int AddItem(string item)  
+     {  
+         //…  
+     }  
+//…  
+ }  
+```  
+  
+ クライアント アプリケーションは、カスタム バインディングを使用して DurableInstanceContextChannel をチャネル スタックに追加する必要があります。構成ファイル内でチャネルを宣言して構成するには、バインディング要素セクションをバインディング要素拡張のコレクションに追加する必要があります。  
+  
+```  
+<system.serviceModel>  
+ <extensions>  
+   <bindingElementExtensions>  
+     <add name="durableInstanceContext"  
+type="Microsoft.ServiceModel.Samples.DurableInstanceContextBindingElementSection, DurableInstanceContextExtension, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"/>  
+   </bindingElementExtensions>  
+ </extensions>  
+```  
+  
+ これで、他の基本的なバインディング要素と同様、このバインディング要素をカスタム バインディングで使用できるようになりました。  
+  
+```  
+<bindings>  
+ <customBinding>  
+   <binding name="TextOverHttp">  
+     <durableInstanceContext contextType="HttpCookie"/>             
+     <reliableSession />  
+     <textMessageEncoding />  
+     <httpTransport />  
+   </binding>  
+ </customBinding>  
+</bindings>  
+```  
+  
+## 結論  
+ このサンプルでは、カスタム プロトコル チャネルを作成する方法と、これを有効にするためにサービス動作をカスタマイズする方法を示しました。  
+  
+ 構成セクションを使用して `IStorageManager` 実装を指定することで、この拡張機能をさらに強化することができます。これにより、サービス コードを再コンパイルせずにバッキング ストアを変更できます。  
+  
+ さらに、インスタンスの状態をカプセル化するクラス \(`StateBag` など\) を実装できます。このクラスにより、変更されるたびに状態が保持されます。この方法により、`SaveState` 属性の使用を回避しながら、永続する処理をより正確に実行できます \(たとえば、`SaveState` 属性を含むメソッドを呼び出すたびに状態を保存するのではなく、状態が実際に変更されたときに保持できます\)。  
+  
+ このサンプルを実行すると、次の出力が表示されます。クライアントは、2 つの商品をショッピング カートに追加し、その後ショッピング カートにある商品の一覧をサービスから取得します。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+```  
+Enter the name of the product: apples  
+Enter the name of the product: bananas  
+  
+Shopping cart currently contains the following items.  
+apples  
+bananas  
+Press ENTER to shut down client  
+```  
+  
+> [!NOTE]
+>  サービスを再ビルドすると、データベース ファイルが上書きされます。サンプルを複数回実行する間に状態が保持されていることを確認するには、実行のたびにサンプルを再ビルドしないようにしてください。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピュータ構成または複数コンピュータ構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  このサンプルを実行するには、SQL Server 2005 または SQL Express 2005 を実行している必要があります。SQL Server 2005 を実行している場合は、サービスの接続文字列の構成を変更する必要があります 複数コンピューターで実行している場合、SQL Server が必要なのはサーバー コンピューターだけです。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Instancing\Durable`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/durable-issued-token-provider.md b/docs/framework/wcf/samples/durable-issued-token-provider.md
new file mode 100644
index 00000000000..876b1f55f3c
--- /dev/null
+++ b/docs/framework/wcf/samples/durable-issued-token-provider.md
@@ -0,0 +1,217 @@
+---
+title: "永続性発行済みトークン プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 76fb27f5-8787-4b6a-bf4c-99b4be1d2e8b
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 永続性発行済みトークン プロバイダー
+このサンプルでは、カスタム クライアントの発行済みトークン プロバイダーを実装する方法を示します。  
+  
+## 説明  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトークン プロバイダーは、資格情報をセキュリティ インフラストラクチャに提供するために使用します。一般的に、トークン プロバイダーは、ターゲットをチェックし、適切な証明書を発行して、セキュリティ インフラストラクチャがメッセージのセキュリティを保護できるようにします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] にはトークン プロバイダー [!INCLUDE[infocard](../../../../includes/infocard-md.md)] が付属しています。カスタム トークン プロバイダは、次の場合に便利です。  
+  
+-   組み込みのトークン プロバイダが連係動作できない資格情報ストアがある場合。  
+  
+-   資格情報をユーザーが詳細を提供した時点から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが資格情報を使用した時点に変換するための、独自のカスタム メカニズムを提供する場合。  
+  
+-   カスタム トークンを構築している場合。  
+  
+ このサンプルでは、セキュリティ トークン サービス \(STS\) によって発行されたトークンをキャッシュする、カスタム トークン プロバイダーを構築する方法を示します。  
+  
+ このサンプルに示されている手順の概要は次のとおりです。  
+  
+-   クライアントをカスタム トークン プロバイダーを使用して構成する手順。  
+  
+-   発行済みトークンをキャッシュして [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントに提供する手順。  
+  
+-   サーバーがクライアントによってサーバーの X.509 証明書を使用して認証される手順。  
+  
+ このサンプルは、クライアント コンソール プログラム \(Client.exe\)、セキュリティ トークン サービス コンソール プログラム \(Securitytokenservice.exe\)、およびサービス コンソール プログラム \(Service.exe\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および 除算\) を公開しています。クライアントは、セキュリティ トークンをセキュリティ トークン サービス \(STS\) から取得し、指定された算術演算を実行する同期要求をサービスに対して行います。サービスは、結果を添えて応答します。クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を使用して ICalculator コントラクトを公開します。このバインディングのクライアント側の構成は、次のコードに示すとおりです。  
+  
+```  
+<bindings>  <wsFederationHttpBinding>    <binding name="ServiceFed" >      <security mode ="Message">        <message issuedKeyType ="SymmetricKey" issuedTokenType ="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1" >          <issuer address ="http://localhost:8000/sts/windows" binding ="wsHttpBinding" />        </message>      </security>    </binding>  </wsFederationHttpBinding></bindings>  
+```  
+  
+ `wsFederationHttpBinding` の `security` 要素では、使用するセキュリティ モードは `mode` 値で構成されます。このサンプルでは、メッセージ セキュリティが使用されています。このため、`wsFederationHttpBinding` の `message` 要素が `wsFederationHttpBinding` の `security` 要素の内側で指定されています。`wsFederationHttpBinding` の `message` 要素の内側にある `wsFederationHttpBinding` の `issuer` 要素は、セキュリティ トークンをクライアントに発行するセキュリティ トークン サービスのアドレスとバインディングを指定します。これにより、クライアントが Calculator サービスに認証されるようになります。  
+  
+ このバインディングのサービス側の構成は、次のコードに示すとおりです。  
+  
+```  
+<bindings>  <wsFederationHttpBinding>    <binding name="ServiceFed" >      <security mode ="Message">        <message issuedKeyType ="SymmetricKey" issuedTokenType ="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1" >          <issuerMetadata address ="http://localhost:8000/sts/mex" >            <identity>              <certificateReference storeLocation ="CurrentUser"                                     storeName="TrustedPeople"                                     x509FindType ="FindBySubjectDistinguishedName"                                     findValue ="CN=STS" />            </identity>          </issuerMetadata>        </message>      </security>    </binding>  </wsFederationHttpBinding></bindings>  
+```  
+  
+ `wsFederationHttpBinding` の `security` 要素では、使用するセキュリティ モードは `mode` 値で構成されます。このサンプルでは、メッセージ セキュリティが使用されています。このため、`wsFederationHttpBinding` の `message` 要素が `wsFederationHttpBinding` の `security` 要素の内側で指定されています。`wsFederationHttpBinding` の `message` 要素の内側にある `wsFederationHttpBinding` の `issuerMetadata` 要素は、セキュリティ トークン サービスのメタデータ取得に使用できるエンドポイントのアドレスと ID を指定します。  
+  
+ このサービスの動作を次のコードに示します。  
+  
+```  
+<behavior name ="ServiceBehavior" >  <serviceDebug includeExceptionDetailInFaults ="true"/>  <serviceMetadata httpGetEnabled ="true"/>  <serviceCredentials>    <issuedTokenAuthentication>      <knownCertificates>        <add storeLocation ="LocalMachine"             storeName="TrustedPeople"             x509FindType="FindBySubjectDistinguishedName"             findValue="CN=STS" />      </knownCertificates>    </issuedTokenAuthentication>    <serviceCertificate storeLocation ="LocalMachine"                        storeName ="My"                        x509FindType ="FindBySubjectDistinguishedName"                        findValue ="CN=localhost"/>  </serviceCredentials></behavior>  
+```  
+  
+ `serviceCredentials` 要素の内側にある `issuedTokenAuthentication` 要素を使用すると、サービスは、認証時にクライアントが提示できるトークンに関する制約を指定できます。この構成の指定では、サブジェクト名が CN\=STS である証明書によって署名されたトークンがサービスによって受け入れられます。  
+  
+ セキュリティ トークン サービスは、標準の wsHttpBinding を使用して、単一のエンドポイントを公開します。セキュリティ トークン サービスは、クライアントからのトークンの要求に応答し、クライアントが Windows アカウントを使用して認証していることを前提として、クライアントのユーザー名がクレームとして含まれているトークンを発行します。セキュリティ トークン サービスは、トークン作成の一環として、CN\=STS 証明書に関連付けられている秘密キーを使用して、トークンに署名します。また、対称キーを作成し、CN\=localhost 証明書に関連付けられている秘密キーを使用して暗号化します。セキュリティ トークン サービスは、トークンをクライアントに返すときに、対称キーも返します。クライアントは、発行されたトークンを Calculator サービスに提示し、対称キーを使用してメッセージに署名することで対称キーを認識していることを証明します。  
+  
+## カスタム クライアント資格情報とトークン プロバイダ  
+ 発行済みトークンをキャッシュするカスタム トークン プロバイダーを開発して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティに統合する方法を、次の手順に示します。  
+  
+#### カスタム トークン プロバイダーを開発するには  
+  
+1.  カスタム トークン プロバイダーを作成します。  
+  
+     サンプルでは、キャッシュから取得したセキュリティ トークンを返すカスタム トークン プロバイダーを実装します。  
+  
+     このタスクを実行するため、カスタム トークン プロバイダは <xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスを派生し、<xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%2A> メソッドをオーバーライドします。このメソッドは、キャッシュ内のトークンの取得を試行します。キャッシュ内にトークンが見つからない場合は、基になるプロバイダからトークンを取得してキャッシュします。どちらの場合も、メソッドは `SecurityToken` を返します。  
+  
+    ```  
+    protected override SecurityToken GetTokenCore(TimeSpan timeout)  
+    {  
+      GenericXmlSecurityToken token;  
+      if (!this.cache.TryGetToken(target, issuer, out token))  
+      {  
+        token = (GenericXmlSecurityToken) this.innerTokenProvider.GetToken(timeout);  
+        this.cache.AddToken(token, target, issuer);  
+      }  
+      return token;  
+    }  
+    ```  
+  
+2.  カスタム セキュリティ トークン マネージャーを作成します。  
+  
+     <xref:System.IdentityModel.Selectors.SecurityTokenManager> は、`CreateSecurityTokenProvider` メソッド内で渡される特定の <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> の <xref:System.IdentityModel.Selectors.SecurityTokenProvider> の作成に使用されます。セキュリティ トークン マネージャーは、トークン認証システムとトークン シリアライザーの作成にも使用されますが、このサンプルでは扱っていません。このサンプルでは、カスタム セキュリティ トークン マネージャーは <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスを継承し、`CreateSecurityTokenProvider` メソッドをオーバーライドして、渡されたトークンの要件で発行済みトークンが必要であることが示されている場合にはカスタム トークン プロバイダーを返します。  
+  
+    ```  
+    class DurableIssuedTokenClientCredentialsTokenManager :  
+     ClientCredentialsSecurityTokenManager  
+    {  
+      IssuedTokenCache cache;  
+  
+      public DurableIssuedTokenClientCredentialsTokenManager ( DurableIssuedTokenClientCredentials creds ): base(creds)  
+      {  
+        this.cache = creds.IssuedTokenCache;  
+      }  
+  
+      public override SecurityTokenProvider CreateSecurityTokenProvider ( SecurityTokenRequirement tokenRequirement )  
+      {  
+        if (IsIssuedSecurityTokenRequirement(tokenRequirement))  
+        {  
+          return new DurableIssuedSecurityTokenProvider ((IssuedSecurityTokenProvider)base.CreateSecurityTokenProvider( tokenRequirement), this.cache);  
+        }  
+        Else  
+        {  
+          return base.CreateSecurityTokenProvider(tokenRequirement);  
+        }  
+      }  
+    }  
+    ```  
+  
+3.  カスタム クライアント資格情報を作成します。  
+  
+     クライアント資格情報クラスは、クライアント プロキシ用に構成された資格情報を表すために使用され、トークン認証システム、トークン プロバイダ、およびトークン シリアライザの取得に使用されるセキュリティ トークン マネージャを作成します。  
+  
+    ```  
+    public class DurableIssuedTokenClientCredentials : ClientCredentials  
+    {  
+      IssuedTokenCache cache;  
+  
+      public DurableIssuedTokenClientCredentials() : base()  
+      {  
+      }  
+  
+      DurableIssuedTokenClientCredentials ( DurableIssuedTokenClientCredentials other) : base(other)  
+      {  
+        this.cache = other.cache;  
+      }  
+  
+      public IssuedTokenCache IssuedTokenCache  
+      {  
+        Get  
+        {  
+          return this.cache;  
+        }  
+        Set  
+        {  
+          this.cache = value;  
+        }  
+      }  
+  
+      protected override ClientCredentials CloneCore()  
+      {  
+        return new DurableIssuedTokenClientCredentials(this);  
+      }  
+  
+      public override SecurityTokenManager CreateSecurityTokenManager()  
+      {  
+        return new DurableIssuedTokenClientCredentialsTokenManager ((DurableIssuedTokenClientCredentials)this.Clone());  
+      }  
+    }  
+    ```  
+  
+4.  トークン キャッシュを実装します。サンプルの実装では抽象基本クラスを使用し、トークン キャッシュの利用先ではこのクラスを通じてキャッシュとやり取りします。  
+  
+    ```  
+    public abstract class IssuedTokenCache  
+    {  
+      public abstract void AddToken ( GenericXmlSecurityToken token, EndpointAddress target, EndpointAddress issuer);  
+      public abstract bool TryGetToken(EndpointAddress target, EndpointAddress issuer, out GenericXmlSecurityToken cachedToken);  
+    }  
+    Configure the client to use the custom client credential.  
+    ```  
+  
+     クライアントがカスタム クライアント資格情報を使用するため、サンプルでは既定のクライアント資格情報を削除し、新しいクライアント資格情報クラスを提供しています。  
+  
+    ```  
+    clientFactory.Endpoint.Behaviors.Remove<ClientCredentials>();  
+    DurableIssuedTokenClientCredentials durableCreds = new DurableIssuedTokenClientCredentials();  
+    durableCreds.IssuedTokenCache = cache;  
+    durableCreds.ServiceCertificate.Authentication.CertificateValidationMode = X509CertificateValidationMode.PeerOrChainTrust;  
+    clientFactory.Endpoint.Behaviors.Add(durableCreds);  
+    ```  
+  
+## サンプルの実行  
+ サンプルの実行方法を次の手順に示します。サンプルを実行すると、セキュリティ トークン要求がセキュリティ トークン サービスのコンソール ウィンドウに表示されます。操作要求と応答は、クライアントとサービスのコンソール ウィンドウに表示されます。いずれかのコンソール ウィンドウで Enter キーを押すと、アプリケーションがシャットダウンします。  
+  
+## Setup.cmd バッチ ファイル  
+ このサンプルに用意されている Setup.cmd バッチ ファイルを使用すると、適切な証明書を使用してサーバーとセキュリティ トークン サービスを構成し、自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルにより、CurrentUser\/TrustedPeople 証明書ストアのどちらにも 2 つの証明書が作成されます。片方の証明書は CN\=STS のサブジェクト名を持ち、クライアントに発行するセキュリティ トークンを署名するためにセキュリティ トークン サービスが使用します。もう片方の証明書は CN\=localhost のサブジェクト名を持ち、サービスが暗号化を解除できるようにシークレットを暗号化するためにセキュリティ トークン サービスが使用します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  Setup.cmd ファイルを実行して、必要な証明書を作成します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。ソリューション内のすべてのプロジェクトがビルドされていることを確認します \(Shared、RSTRSTR、Service、SecurityTokenService、Client\)。  
+  
+3.  Service.exe と SecurityTokenService.exe がどちらも管理者権限で実行されていることを確認します。  
+  
+4.  Client.exe を実行します。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Security\DurableIssuedTokenProvider`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/dynamic-reconfiguration.md b/docs/framework/wcf/samples/dynamic-reconfiguration.md
new file mode 100644
index 00000000000..9a6fb9d0fd8
--- /dev/null
+++ b/docs/framework/wcf/samples/dynamic-reconfiguration.md
@@ -0,0 +1,95 @@
+---
+title: "動的再構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b20786ae-cce6-4f91-b6cb-9cae116faf8b
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# 動的再構成
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーティング サービスを示します。ルーティング サービスは、コンテンツ ベースのルーターをアプリケーションに簡単に追加できるようにする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントです。このサンプルでは、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 電卓のサンプルを改良し、ルーティング サービスを使用して通信するようにします。このサンプルでは、実行時にルーティング サービスを動的に再構成する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\RoutingServices\DynamicReconfiguration`  
+  
+## サンプルの詳細  
+ このサンプルでは、実行時にルーティング サービスを動的に再構成するために、5 秒ごとにタイマーを作動させ、新しい <xref:System.ServiceModel.Routing.RoutingConfiguration> オブジェクトを作成して適用します。この構成は、通常の電卓のエンドポイントまたは丸め処理を行う電卓のエンドポイントのいずれかを示しています。電卓クライアント アプリケーションは、ルーティング サービスがその時点でどちらのサービスにルーティングするように構成されているかに応じて、いずれか一方のサービスからメッセージを受け取ります。  
+  
+ ルーティング サービスのカスタム動作を介した動的再構成機能が使用されます。このカスタム動作は、5 秒ごとに作動する単純なスレッド タイマーを含むサービス拡張をアタッチします。このスレッド タイマーにより、`UpdateRules` メソッドへのコールバックが発生し、新しいルーティング構成が作成および適用されます。実際の配置では、このコールバックは、別の種類のイベント \(SQL\-Event 通知や WS\-Discovery アナウンスなど\) の結果として行われる可能性があります。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して DynamicReconfiguration.sln を開きます。  
+  
+2.  **ソリューション エクスプローラー**を開くには、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+3.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で F5 キーを押すか、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+    1.  **F5** キーを押したときに必要なプロジェクトが自動的に起動されるようにする場合は、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。左ペインの **\[共通プロパティ\]** で **\[スタートアップ プロジェクト\]** をクリックします。**\[マルチ スタートアップ プロジェクト\]** をクリックし、すべてのプロジェクトに**開始**アクションを設定します。  
+  
+    2.  Ctrl キーと Shift キーを押しながら B キーを押してプロジェクトをビルドする場合は、次のアプリケーションを開始する必要があります。  
+  
+        1.  電卓クライアント \(.\/CalculatorClient\/bin\/client.exe\)  
+  
+        2.  電卓サービス \(.\/CalculatorService\/bin\/service.exe\)  
+  
+        3.  丸め処理を行う電卓サービス \(.\/RoundingCalcService\/bin\/service.exe\)  
+  
+        4.  ルーティング サービス \(.\/RoutingService\/bin\/RoutingService.exe\)  
+  
+4.  電卓クライアントのコンソール ウィンドウで、Enter キーを押してクライアントを開始し、電卓サービス操作を呼び出します。  
+  
+     ルーティング サービスは、丸め処理を行う電卓と通常の電卓に交互にメッセージをルーティングします。これはルーティング構成が 5 秒ごとに動的に変化するためです。ルーティング サービスがどちらのエンドポイントにメッセージを送信するように構成されているかに応じて、異なる出力がクライアント コンソールに表示されます。  
+  
+5.  Enter キーを 5 秒以上にわたって繰り返し押して、サービスから返される結果が変化することを確認します。  
+  
+    1.  次に、ルーター サービスが丸め処理を行う電卓サービスにメッセージをルーティングするように構成されている場合に返される出力を示します。  
+  
+        ```Output  
+        Add(100,15.99) = 116  
+        Subtract(145,76.54) = 68.5  
+        Multiply(9,81.25) = 731.2  
+        Divide(22,7) = 3.1  
+  
+        ```  
+  
+    2.  次に、ルーティング サービスが通常の電卓サービスにメッセージをルーティングするように構成されている場合に返される出力を示します。  
+  
+        ```Output  
+        Add(100,15.99) = 115.99  
+        Subtract(145,76.54) = 68.46  
+        Multiply(9,81.25) = 731.25  
+        Divide(22,7) = 3.14285714285714  
+  
+        ```  
+  
+6.  また、電卓サービスと丸め処理を行う電卓サービスは、呼び出された操作のログをそれぞれのコンソール ウィンドウに出力します。  
+  
+7.  終了するには、クライアント コンソール ウィンドウで「quit」と入力するか、Enter キーを押します。  
+  
+8.  サービスを終了するには、サービス コンソール ウィンドウで Enter キーを押します。  
+  
+## シナリオ  
+ このサンプルでは、1 つのエンドポイントを介して複数の種類または実装のサービスを公開することを可能にするコンテンツ ベースのルーターとして機能するルーターを示します。  
+  
+### 実際のシナリオ  
+ Contoso では、すべてのサービスを仮想化して 1 つのエンドポイントのみを公開し、そのエンドポイントを通じて複数の異なる種類のサービスへのアクセスを提供したいと考えています。この場合は、ルーティング サービスのコンテンツ ベースのルーティング機能を使用して受信要求の送信先を決定します。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/etw-tracing.md b/docs/framework/wcf/samples/etw-tracing.md
new file mode 100644
index 00000000000..68061c3b5d1
--- /dev/null
+++ b/docs/framework/wcf/samples/etw-tracing.md
@@ -0,0 +1,120 @@
+---
+title: "ETW トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ac99a063-e2d2-40cc-b659-d23c2f783f92
+caps.latest.revision: 42
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 42
+---
+# ETW トレース
+このサンプルでは、Event Tracing for Windows \(ETW\) と、このサンプルに用意されている `ETWTraceListener` を使用して、エンドツーエンド \(E2E\) のトレースを実装する方法を示します。このサンプルは「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいており、ETW トレースが含まれています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、「[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)」について理解していることを前提としています。  
+  
+ <xref:System.Diagnostics> トレース モデル内の各トレース ソースでは、データのトレース場所とトレース方法を決定するトレース リスナーを複数設定できます。リスナの種類では、トレース データの記録形式が定義されます。リスナを構成に追加する方法を、次のコード サンプルに示します。  
+  
+```  
+  
+<system.diagnostics>  
+    <sources>  
+        <source name="System.ServiceModel"   
+             switchValue="Verbose,ActivityTracing"  
+             propagateActivity="true">  
+            <listeners>  
+                <add type=  
+                   "System.Diagnostics.DefaultTraceListener"  
+                   name="Default">  
+                   <filter type="" />  
+                </add>  
+                <add name="ETW">  
+                    <filter type="" />  
+                </add>  
+            </listeners>  
+        </source>  
+    </sources>  
+    <sharedListeners>  
+        <add type=  
+            "Microsoft.ServiceModel.Samples.EtwTraceListener, ETWTraceListener"  
+            name="ETW" traceOutputOptions="Timestamp">  
+            <filter type="" />  
+       </add>  
+    </sharedListeners>  
+</system.diagnostics>  
+  
+```  
+  
+ このリスナを使用する前に、ETW トレース セッションを開始する必要があります。このセッションは、Logman.exe または Tracelog.exe を使用して開始できます。このサンプルには、ETW トレース セッションをセットアップするための SetupETW.bat ファイルと、セッションを閉じてログ ファイルを完了するための CleanupETW.bat ファイルが含まれています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。これらのツールの詳細については、「[http:\/\/go.microsoft.com\/fwlink\/?LinkId\=56580](http://go.microsoft.com/fwlink/?LinkId=56580)」を参照してください。  
+  
+ ETWTraceListener を使用する場合、トレースはバイナリの .etl ファイルにログ記録されます。ServiceModel トレースが有効な場合、生成されるすべてのトレースは同じファイルに表示されます。.etl および .svclog ログ ファイルを表示するには、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)を使用します。このビューアでは、メッセージを送信側から受信側や使用地点までトレースできる、システムのエンドツーエンドのビューが作成されます。  
+  
+ ETW トレース リスナは、循環ログをサポートします。この機能を有効にするには、**\[スタート\]** メニューの **\[ファイル名を指定して実行\]** をクリックし、「`cmd`」と入力してコマンド コンソールを起動します。次のコマンドでは、`<logfilename>` パラメータを使用するログ ファイル名に置き換えます。  
+  
+```  
+logman create trace Wcf -o <logfilename> -p "{411a0819-c24b-428c-83e2-26b41091702e}" -f bincirc -max 1000  
+```  
+  
+ `-f` スイッチと `-max` スイッチは省略できます。これらのスイッチでは、それぞれバイナリの循環形式と 1000 MB の最大ログ サイズが指定されます。`-p` スイッチは、トレース プロバイダーを指定する際に使用します。この例では、`"{411a0819-c24b-428c-83e2-26b41091702e}"` は "XML ETW サンプル プロバイダー" の GUID です。  
+  
+ セッションを開始するには、次のコマンドを入力します。  
+  
+```  
+Logman start Wcf  
+  
+```  
+  
+ ログ記録を完了したら、次のコマンドを使用してセッションを停止できます。  
+  
+```  
+Logman stop Wcf  
+```  
+  
+ この処理によってバイナリの循環ログが生成されます。このログは、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)や Tracerpt など、ユーザーが選択したツールを使用して処理できます。  
+  
+ また、循環ログ記録を実行する代替リスナの詳細については、「[循環トレース](../../../../docs/framework/wcf/samples/circular-tracing.md)」でも確認できます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  RegisterProvider.bat、SetupETW.bat、および CleanupETW.bat コマンドを使用するには、ローカル管理者アカウントで実行する必要があります。[!INCLUDE[wv](../../../../includes/wv-md.md)] 以降を使用している場合は、コマンド プロンプトも管理者権限で実行する必要があります。これを行うには、コマンド プロンプトのアイコンを右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+3.  サンプルを実行する前に、クライアントとサーバーで RegisterProvider.bat を実行します。この結果、トレースを生成する ETWTracingSampleLog.etl ファイルがセットアップされます。このトレースはサービス トレース ビューアで読み取ることができます。このファイルは、C:\\logs フォルダにあります。このフォルダーが存在しない場合はフォルダーを作成する必要があります。作成しない場合、トレースは生成されません。次に、クライアント コンピューターとサーバー コンピューターで SetupETW.bat を実行し、ETW トレース セッションを開始します。SetupETW.bat ファイルは、CS\\Client フォルダーの下にあります。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+5.  サンプルの使用が終わったら、CleanupETW.bat を実行して ETWTracingSampleLog.etl ファイルの作成を完了します。  
+  
+6.  サービス トレース ビューア内で ETWTracingSampleLog.etl ファイルを開きます。このバイナリ形式のファイルを .svclog ファイルとして保存するかどうかを尋ねるメッセージが表示されます。  
+  
+7.  新しく作成された .svclog ファイルをサービス トレース ビューアー内で開き、ETW トレースと ServiceModel トレースを表示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\AnalyticTrace`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/expected-exceptions.md b/docs/framework/wcf/samples/expected-exceptions.md
new file mode 100644
index 00000000000..1759fec76dc
--- /dev/null
+++ b/docs/framework/wcf/samples/expected-exceptions.md
@@ -0,0 +1,90 @@
+---
+title: "予期される例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 299a6987-ae6b-43c6-987f-12b034b583ae
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 予期される例外
+このサンプルでは、型指定のあるクライアントを使用する際に、予期される例外をキャッチする方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、正しいプログラムが処理する必要のある `TimeoutException` および `CommunicationException` という 2 種類の予期される例外を、キャッチして処理する方法を示します。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントの通信メソッドからスローされる例外には、予期される例外と予期しない例外があります。予期しない例外には、`OutOfMemoryException` などの致命的なエラーや、`ArgumentNullException` や `InvalidOperationException` などのプログラミング エラーが含まれます。一般に、予期しないエラーを処理する有効な方法はありません。したがって [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの通信メソッドを呼び出す際、通常は、予期しないエラーをキャッチしないでください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントの通信メソッドからの予期される例外には、`TimeoutException`、`CommunicationException`、および `CommunicationException` の任意の派生クラスが含まれます。これらの例外は通信中の問題を示しますが、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを中止して通信エラーを報告することによって安全に処理できます。どのアプリケーションでも外部要因によってこうしたエラーが発生する可能性があるので、正しいアプリケーションはこのようなエラーをキャッチし、発生した場合には回復させる必要があります。  
+  
+ `CommunicationException` の派生クラスには、クライアントがスローできるものがいくつかあります。状況によっては、アプリケーションでこれらのサブクラスをキャッチして特別な処理を行うこともできます。しかし、それ以外の場合は `CommunicationException` として処理する必要があります。この処理は、より具体的な例外の種類を最初にキャッチし、後の catch 句で `CommunicationException` をキャッチすることによって実現できます。  
+  
+ クライアントの通信メソッドを呼び出すコードでは、`TimeoutException` と `CommunicationException` をキャッチする必要があります。こうしたエラーの処理方法の 1 つに、クライアントを中止して通信エラーを報告するという方法があります。  
+  
+```  
+try  
+{  
+    ...  
+    double result = client.Add(value1, value2);  
+    ...  
+    client.Close();  
+}  
+catch (TimeoutException exception)  
+{  
+    Console.WriteLine("Got {0}", exception.GetType());  
+    client.Abort();  
+}  
+catch (CommunicationException exception)  
+{  
+    Console.WriteLine("Got {0}", exception.GetType());  
+    client.Abort();  
+}  
+```  
+  
+ 予期される例外が発生した場合、それ以降、クライアントを使用できる場合もできない場合もあります。クライアントがそのまま使用可能かどうかを確認するには、`State` プロパティが `CommunicationState`.Opened であることを確認してください。Opened の場合は、そのまま使用できます。それ以外の場合は、クライアントを中止してすべての参照を解放する必要があります。  
+  
+> [!CAUTION]
+>  一般に、セッションを持つクライアントは、例外発生後に使用できなくなり、セッションを持たないクライアントは、例外発生後も使用可能なままです。ただし、どちらも必ずそうなるとは限りません。したがって、例外発生後も引き続きクライアントを使用する場合は、アプリケーションで `State` プロパティをチェックし、クライアントが Opened 状態のままであることを検証する必要があります。  
+  
+ このサンプルを実行すると、操作応答と例外がクライアントのコンソール ウィンドウに表示されます。  
+  
+ クライアント プロセスでは 2 つのシナリオが実行されます。各シナリオでは、`Add`、`Divide` の順に呼び出しが試行されます。最初のシナリオでは、`Divide` を呼び出す前にクライアントを中止することによってネットワーク問題をシミュレートします。2 番目のシナリオでは、メソッドを完了できないようにタイムアウト値をごく短く設定することによって、タイムアウトを発生させます。クライアント プロセスから予期される出力は次のとおりです。  
+  
+```  
+Add(100,15.99) = 115.99  
+Simulated network problem occurs...  
+Got System.ServiceModel.CommunicationObjectAbortedException  
+Add(100,15.99) = 115.99  
+Set timeout too short for method to complete...  
+Got System.TimeoutException  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\ExpectedExceptions`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/extended-protection-policy.md b/docs/framework/wcf/samples/extended-protection-policy.md
new file mode 100644
index 00000000000..841063aef36
--- /dev/null
+++ b/docs/framework/wcf/samples/extended-protection-policy.md
@@ -0,0 +1,71 @@
+---
+title: "拡張保護ポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2616a10-317e-4c34-8023-0c015a80a82f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 拡張保護ポリシー
+拡張保護は、man\-in\-the\-middle \(MITM\) 攻撃に対するセキュリティ イニシアチブです。  MITM 攻撃はセキュリティの脅威です。MITM は、クライアントの資格情報を取得し、その資格情報をサーバーに転送します。  
+  
+## 使用例  
+ 拡張保護  
+  
+## 説明  
+ アプリケーションが HTTPS で Kerberos、Digest または NTLM を使用して認証を実行する場合、最初にトランスポート レベルのセキュリティ \(TLS\) チャネルが構築され、その後セキュリティ チャネルを使用して認証が行われます。  しかし、SSL によって生成されるセッション キーと認証時に生成されるセッション キーはバインドされていません。  サーバーはセキュリティ チャネルがクライアントまたは MITM のどちらで確立されたものであるか知ることができないため、トランスポート チャネルそのものはセキュリティで保護されていても、MITM がクライアントとサーバーの間に自身を構築し、クライアントからの要求の転送を開始する可能性があります。  このシナリオの解決策として、外部の TLS チャネルを内部の認証チャネルにバインドする方法があります。この方法により、サーバーは、MITM が存在するかどうかを検出できます。  
+  
+> [!NOTE]
+>  このサンプルは、IIS でホストされている場合にのみ機能します。Cassini \(Visual Studio Development Server\) は HTTPS をサポートしないため、Cassini 上では機能しません。  
+  
+> [!NOTE]
+>  この機能は現在 Windows 7 でのみ使用できます。  次の手順は、Windows 7 でのみ実行できます。  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  **\[コントロール パネル\]**、**\[プログラムの追加と削除\]**、**\[Windows 機能\]** の順にクリックして、インターネット インフォメーション サービスをインストールします。  
+  
+2.  **\[Windows 機能\]**、**\[インターネット インフォメーション サービス\]**、**\[World Wide Web サービス\]**、**\[セキュリティ\]**、**\[Windows 認証\]** の順にクリックして、**Windows 認証**をインストールします。  
+  
+3.  **\[Windows 機能\]**、**\[Microsoft .NET Framework 3.5.1\]**、**\[Windows Communication Foundation HTTP Activation\]** の順にクリックして、**Windows Communication Foundation HTTP Activation** をインストールします。  
+  
+4.  このサンプルを実行するには、サーバーとの安全なチャネルを確立する必要のあるクライアントが必要なので、インターネット インフォメーション サービス \(IIS\) マネージャーからインストールすることのできるサーバー証明書が存在する必要があります。  
+  
+    1.  IIS マネージャーを開きます。  **\[サーバー証明書\]** を開きます。これは、ルート ノード \(コンピューター名\) を選択すると、**\[機能表示\]** タブに表示されます。  
+  
+    2.  このサンプルをテストする目的で、自己署名証明書を作成します。  インターネット エクスプローラーで証明書の安全性に関するプロンプトが表示されないようにする場合は、信頼されたルート証明機関ストアに証明書をインストールします。  
+  
+5.  既定の Web サイトの**操作**ウィンドウを開きます。  **\[サイトの編集\]**、**\[バインド\]** の順にクリックします。  HTTPS が存在しない場合は、ポート番号を 443 に指定して HTTPS を追加します。  前の手順で作成した SSL 証明書を割り当てます。  
+  
+6.  サービスをビルドします。  これにより、仮想ディレクトリが IIS に作成され、サービスを Web ホストにするために必要な .dll ファイル、.svc ファイルおよび .config ファイルがコピーされます。  
+  
+7.  IIS マネージャーを開きます。  前の手順で作成した仮想ディレクトリ \(**ExtendedProtection**\) を右クリックします。  **\[アプリケーションへの変換\]** を選択します。  
+  
+8.  この仮想ディレクトリの**認証**モジュールを IIS マネージャーで開き、**Windows 認証**を有効にします。  
+  
+9. 仮想ディレクトリの **\[Windows 認証\]** の下にある **\[詳細設定\]** を開き、**\[必須\]** に設定します。  
+  
+10. ブラウザー ウィンドウから HTTPS URL にアクセスして \(完全修飾ドメイン名を指定します\) サービスをテストできます。  リモート コンピューターからこの URL にアクセスする場合は、すべての受信 HTTP および HTTPS 通信に対してファイアウォールが開かれていることを確認してください。  
+  
+11. クライアント構成ファイルを開き、クライアントの完全修飾ドメイン名、または `<<full_machine_name>>` を置き換えるエンドポイント アドレス属性を指定します。  
+  
+12. クライアントを実行します。  クライアントはサービスと通信します。これで、安全なチャネルが確立され、拡張保護が使用されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Security\ExtendedProtection`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md b/docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md
new file mode 100644
index 00000000000..53414cacd3c
--- /dev/null
+++ b/docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md
@@ -0,0 +1,168 @@
+---
+title: "エラー処理およびレポートに対する制御の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 45f996a7-fa00-45cb-9d6f-b368f5778aaa
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# エラー処理およびレポートに対する制御の拡張
+このサンプルでは、<xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを使用して、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスのエラー処理およびエラー報告に対する制御を拡張する方法を示します。サンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づき、エラー処理を行ういくつかの追加コードをサービスに追加しています。クライアントは、強制的にエラーが発生する状態にされます。サービスはエラーを途中受信して、ファイルに記録します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスは <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを使用して、エラーを途中受信して処理を実行し、エラーを報告する方法を制御できます。このインターフェイスには、<xref:System.ServiceModel.Dispatcher.IErrorHandler.ProvideFault%28System.Exception%2CSystem.ServiceModel.Channels.MessageVersion%2CSystem.ServiceModel.Channels.Message%40%29> と <xref:System.ServiceModel.Dispatcher.IErrorHandler.HandleError%2A> の 2 つのメソッドを実装できます。<xref:System.ServiceModel.Dispatcher.IErrorHandler.ProvideFault%28System.Exception%2CSystem.ServiceModel.Channels.MessageVersion%2CSystem.ServiceModel.Channels.Message%40%29> メソッドを使用すると、例外に対して生成されるエラー メッセージを追加または変更したり、非表示にすることができます。<xref:System.ServiceModel.Dispatcher.IErrorHandler.HandleError%2A> メソッドを使用すると、エラーの発生時にエラー処理を実行することができます。またこのメソッドは追加のエラー処理を実行するかどうかを制御します。  
+  
+ このサンプルでは、`CalculatorErrorHandler` 型は <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを実装します。  
+  
+ <xref:System.ServiceModel.Dispatcher.IErrorHandler.HandleError%2A> メソッドでは、`CalculatorErrorHandler` がエラーのログを c:\\logs の Error.txt テキスト ファイルに書き込みます。このサンプルではエラーを記録して表示します。このエラーの報告は、クライアントに返されます。  
+  
+```  
+public class CalculatorErrorHandler : IErrorHandler  
+{  
+        // Provide a fault. The Message fault parameter can be replaced, or set to  
+        // null to suppress reporting a fault.  
+  
+        public void ProvideFault(Exception error, MessageVersion version, ref Message fault)  
+        {  
+        }  
+  
+        // HandleError. Log an error, then allow the error to be handled as usual.  
+        // Return true if the error is considered as already handled  
+  
+        public bool HandleError(Exception error)  
+        {  
+            using (TextWriter tw = File.AppendText(@"c:\logs\error.txt"))  
+            {  
+                if (error != null)  
+                {  
+                    tw.WriteLine("Exception: " + error.GetType().Name + " - " + error.Message);  
+                }  
+                tw.Close();  
+            }  
+            return true;  
+        }  
+    }  
+```  
+  
+ `ErrorBehaviorAttribute` は、エラー ハンドラをサービスに登録する機構として存在します。この属性は、単一の型のパラメータを受け取ります。この型は <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを実装し、空のパブリック コンストラクタを含む必要があります。この属性は、そのエラー ハンドラの型のインスタンスをインスタンス化し、サービスにインストールします。これを行うには <xref:System.ServiceModel.Description.IServiceBehavior> インターフェイスを実装し、次に <xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A> メソッドを使用してエラー ハンドラのインスタンスをサービスに追加します。  
+  
+```  
+// This attribute can be used to install a custom error handler for a service.  
+public class ErrorBehaviorAttribute : Attribute, IServiceBehavior  
+{  
+    Type errorHandlerType;  
+  
+    public ErrorBehaviorAttribute(Type errorHandlerType)  
+    {  
+        this.errorHandlerType = errorHandlerType;  
+    }  
+  
+    void IServiceBehavior.Validate(ServiceDescription description, ServiceHostBase serviceHostBase)  
+    {  
+    }  
+  
+    void IServiceBehavior.AddBindingParameters(ServiceDescription description, ServiceHostBase serviceHostBase, System.Collections.ObjectModel.Collection<ServiceEndpoint> endpoints, BindingParameterCollection parameters)  
+    {  
+    }  
+  
+    void IServiceBehavior.ApplyDispatchBehavior(ServiceDescription description, ServiceHostBase serviceHostBase)  
+    {  
+        IErrorHandler errorHandler;  
+  
+        try  
+        {  
+            errorHandler = (IErrorHandler)Activator.CreateInstance(errorHandlerType);  
+        }  
+        catch (MissingMethodException e)  
+        {  
+            throw new ArgumentException("The errorHandlerType specified in the ErrorBehaviorAttribute constructor must have a public empty constructor.", e);  
+        }  
+        catch (InvalidCastException e)  
+        {  
+            throw new ArgumentException("The errorHandlerType specified in the ErrorBehaviorAttribute constructor must implement System.ServiceModel.Dispatcher.IErrorHandler.", e);  
+        }  
+  
+        foreach (ChannelDispatcherBase channelDispatcherBase in serviceHostBase.ChannelDispatchers)  
+        {  
+            ChannelDispatcher channelDispatcher = channelDispatcherBase as ChannelDispatcher;  
+            channelDispatcher.ErrorHandlers.Add(errorHandler);  
+        }                                                  
+    }  
+}  
+```  
+  
+ このサンプルは、電卓サービスを実装しています。クライアントは、パラメータに無効な値を渡すことによって、サービスで意図的に 2 つのエラーを発生させます。`CalculatorErrorHandler` は <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを使用して、エラーをローカル ファイルに記録します。エラーの記録はその後、クライアントに報告されます。クライアントは強制的に 0 による除算を行い、引数を範囲外の状態にします。  
+  
+```  
+try  
+{  
+    Console.WriteLine("Forcing an error in Divide");  
+    // Call the Divide service operation - trigger a divide by 0 error.  
+    value1 = 22;  
+    value2 = 0;  
+    result = proxy.Divide(value1, value2);  
+    Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+}  
+catch (FaultException e)  
+{  
+    Console.WriteLine("FaultException: " + e.GetType().Name + " - " + e.Message);  
+}  
+catch (Exception e)  
+{  
+    Console.WriteLine("Exception: " + e.GetType().Name + " - " + e.Message);  
+}  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。0 による除算が行われたことと引数が範囲外の状態であることが、エラーとして報告されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(15,3) = 18  
+Subtract(145,76) = 69  
+Multiply(9,81) = 729  
+Forcing an error in Divide  
+FaultException: FaultException - Invalid Argument: The second argument must not be zero.  
+Forcing an error in Factorial  
+FaultException: FaultException - Invalid Argument: The argument must be greater than zero.  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+ ファイル c:\\logs\\errors.txt には、サービスによって記録されたエラーに関する情報が格納されます。サービスがこのディレクトリに対して書き込み処理を実行できるように、サービスが実行されているプロセス \(通常は ASP.NET または Network Service\) が、このディレクトリに対する書き込み権限を持っていることを確認する必要があります。  
+  
+```  
+Fault: Reason = Invalid Argument: The second argument must not be zero.  
+Fault: Reason = Invalid Argument: The argument must be greater than zero.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  error.txt ファイル用に c:\\logs ディレクトリを作成したことを確認します。または、`CalculatorErrorHandler.HandleError` で使用されるファイル名を変更します。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\ErrorHandling`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/extending-tracing.md b/docs/framework/wcf/samples/extending-tracing.md
new file mode 100644
index 00000000000..82853a81304
--- /dev/null
+++ b/docs/framework/wcf/samples/extending-tracing.md
@@ -0,0 +1,107 @@
+---
+title: "トレースの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b971a99-16ec-4949-ad2e-b0c8731a873f
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# トレースの拡張
+このサンプルでは、ユーザー定義のアクティビティ トレースをクライアントとサービス コードに記述することにより、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] トレース機能を拡張する方法を示します。これにより、ユーザーはトレース アクティビティを作成し、トレースを作業の論理単位ごとにグループ化することができます。さらに、転送 \(同じエンドポイント内\) や伝達 \(異なるエンドポイント間\) を経由してアクティビティを相互に関連付けることもできます。このサンプルでは、トレースはクライアントとサービスの両方で有効です。クライアントとサービスの構成ファイル内でトレースを有効にする方法の詳細については、「[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)」を参照してください。  
+  
+ このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\ExtendingTracing`  
+  
+## トレースとアクティビティの伝達  
+ ユーザー定義のアクティビティ トレースにより、ユーザー自身のトレース アクティビティを作成できます。これによって、複数のトレースを作業の論理単位ごとにグループ化したり、転送や伝達を経由してアクティビティを相互に関連付けたり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トレースのパフォーマンスの負荷 \(ログ ファイルによるディスク領域の負荷など\) を軽減できます。  
+  
+### カスタム ソースの追加  
+ ユーザー定義のトレースは、クライアントとサービス コードの両方に追加できます。トレース ソースをクライアントまたはサービスの構成ファイルに追加すると、カスタム トレースを[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)に記録および表示できます。次のコードは、`ServerCalculatorTraceSource` というユーザー定義のトレース ソースを構成ファイルに追加する方法を示します。  
+  
+```  
+<system.diagnostics>  
+    <sources>  
+        <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">  
+            <listeners>  
+                <add type="System.Diagnostics.DefaultTraceListener" name="Default">  
+                    <filter type="" />  
+                </add>  
+                <add name="xml">  
+                    <filter type="" />  
+                </add>  
+            </listeners>  
+        </source>  
+        <source name="ServerCalculatorTraceSource" switchValue="Information,ActivityTracing">  
+            <listeners>  
+                <add type="System.Diagnostics.DefaultTraceListener" name="Default">  
+                    <filter type="" />  
+                </add>  
+                <add name="xml">  
+                    <filter type="" />  
+                </add>  
+            </listeners>  
+        </source>  
+    </sources>  
+    <sharedListeners>  
+       <add initializeData="C:\logs\ServerTraces.svclog" type="System.Diagnostics.XmlWriterTraceListener"  
+        name="xml" traceOutputOptions="Callstack">  
+            <filter type="" />  
+        </add>  
+    </sharedListeners>  
+    <trace autoflush="true" />  
+</system.diagnostics>....  
+....  
+```  
+  
+### アクティビティの相互関連付け  
+ エンドポイント間でアクティビティを直接関連付けるには、`System.ServiceModel` トレース ソースの `propagateActivity` 属性を `true` に設定する必要があります。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティビティを経由せずにトレースを伝達するには、ServiceModel アクティビティ トレースをオフにする必要があります。次のコード サンプルを参照してください。  
+  
+> [!NOTE]
+>  ServiceModel アクティビティ トレースをオフにすることは、`switchValue` プロパティが表すトレース レベルをオフにすることとは異なります。  
+  
+```  
+<system.diagnostics>  
+    <sources>  
+      <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">  
+  
+    ...  
+  
+       </source>  
+    </sources>  
+</system.diagnostics>  
+```  
+  
+### パフォーマンスの負荷の軽減  
+ `System.ServiceModel` トレース ソースの `ActivityTracing` をオフに設定すると、ユーザー定義のアクティビティ トレースのみを含み、ServiceModel アクティビティ トレースは含まないトレース ファイルが生成されます。これによって、ログ ファイルのサイズがはるかに小さくなります。ただし、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 処理トレースを関連付けることはできなくなります。  
+  
+##### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/extensibility.md b/docs/framework/wcf/samples/extensibility.md
new file mode 100644
index 00000000000..6577d2b075a
--- /dev/null
+++ b/docs/framework/wcf/samples/extensibility.md
@@ -0,0 +1,72 @@
+---
+title: "機能拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd7ddffc-a261-44aa-bd50-33c1c74f0df0
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 機能拡張
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のカスタムの機能拡張およびその他の機能に関するサンプルが含まれています。  
+  
+## このセクションの内容  
+ [チャネル拡張](../../../../docs/framework/wcf/samples/channels-extensibility.md)  
+ カスタム チャネルの例を示します。  
+  
+ [探索の機能拡張](../../../../docs/framework/wcf/samples/discovery-extensibility.md)  
+ カスタム探索の例を示します。  
+  
+ [インスタンス化拡張](../../../../docs/framework/wcf/samples/instancing-extensibility.md)  
+ カスタムの機能拡張の例を示します。  
+  
+ [相互運用性の拡張](../../../../docs/framework/wcf/samples/interop-extensibility.md)  
+ カスタムの相互運用性の例を示します。  
+  
+ [メッセージ エンコーダー拡張](../../../../docs/framework/wcf/samples/message-encoder-extensibility.md)  
+ カスタムのメッセージ エンコーディングの例を示します。  
+  
+ [メタデータ拡張](../../../../docs/framework/wcf/samples/metadata-extensibility.md)  
+ カスタム メタデータの例を示します。  
+  
+ [セキュリティ拡張](../../../../docs/framework/wcf/samples/security-extensibility.md)  
+ カスタム セキュリティの例を示します。  
+  
+ [配信の拡張のサンプル](../../../../docs/framework/wcf/samples/syndication-extensibility-samples.md)  
+ カスタム配信の例を示します。  
+  
+ [トランスポート拡張](../../../../docs/framework/wcf/samples/transport-extensibility.md)  
+ カスタム トランスポートの例を示します。  
+  
+ [Web 拡張](../../../../docs/framework/wcf/samples/web-extensibility.md)  
+ カスタム Web 機能の例を示します。  
+  
+ [操作フォーマッタと操作セレクター](../../../../docs/framework/wcf/samples/operation-formatter-and-operation-selector.md)  
+ 拡張ポイントでカスタムのメッセージのデータ形式を使用する方法を示します。  
+  
+ [カスタム メッセージ フィルター](../../../../docs/framework/wcf/samples/custom-message-filter.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が使用するメッセージ フィルターを置き換えて、メッセージをエンドポイントにディスパッチする方法を示します。  
+  
+ [カスタム サービス ホスト](../../../../docs/framework/wcf/samples/custom-service-host.md)  
+ <xref:System.ServiceModel.ServiceHost> クラスから派生したカスタムのサービス ホストを使用して、サービスの実行時動作を変更する方法を示します。  
+  
+ [DataContract サロゲート](../../../../docs/framework/wcf/samples/datacontract-surrogate.md)  
+ シリアル化、逆シリアル化、スキーマのエクスポート、スキーマのインポートなどのプロセスを、データ コントラクト サロゲート クラスを使用してカスタマイズする方法を示します。  
+  
+ [エラー処理およびレポートに対する制御の拡張](../../../../docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md)  
+ <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのエラー処理およびエラー報告に対する制御を拡張する方法を示します。  
+  
+ [メッセージ インスペクター](../../../../docs/framework/wcf/samples/message-inspectors.md)  
+ クライアントとサービスのメッセージ インスペクターを実装して構成する方法を示します。  
+  
+ [WebContentTypeMapper](../../../../docs/framework/wcf/samples/webcontenttypemapper-sample.md)  
+ 新しいコンテンツ タイプを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージの本文の書式に割り当てる方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/fault-contract.md b/docs/framework/wcf/samples/fault-contract.md
new file mode 100644
index 00000000000..cbfd3093ced
--- /dev/null
+++ b/docs/framework/wcf/samples/fault-contract.md
@@ -0,0 +1,147 @@
+---
+title: "エラー コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b31b140e-dc3b-408b-b3c7-10b6fe769725
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# エラー コントラクト
+エラー コントラクトのサンプルでは、エラー情報をサービスからクライアントに通信する方法を示します。  サンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づき、内部例外をエラーに変換するいくつかの追加コードをサービスに追加しています。  クライアントは 0 による除算を試行し、サービスを強制的にエラー状態にします。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 電卓コントラクトは、<xref:System.ServiceModel.FaultContractAttribute> が含まれるように変更されています。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    int Add(int n1, int n2);  
+    [OperationContract]  
+    int Subtract(int n1, int n2);  
+    [OperationContract]  
+    int Multiply(int n1, int n2);  
+    [OperationContract]  
+    [FaultContract(typeof(MathFault))]  
+    int Divide(int n1, int n2);  
+}  
+```  
+  
+ <xref:System.ServiceModel.FaultContractAttribute> 属性は、`Divide` 操作が型 `MathFault` のエラーを返すことができることを示します。  シリアル化可能な任意の型のエラーが発生します。  この場合、`MathFault` は次のようなデータ コントラクトになります。  
+  
+```  
+[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public class MathFault  
+{      
+    private string operation;  
+    private string problemType;  
+  
+    [DataMember]  
+    public string Operation  
+    {  
+        get { return operation; }  
+        set { operation = value; }  
+    }  
+  
+    [DataMember]          
+    public string ProblemType  
+    {  
+        get { return problemType; }  
+        set { problemType = value; }  
+    }  
+}  
+  
+```  
+  
+ 0 による除算の例外が発生すると、`Divide` メソッドは <xref:System.ServiceModel.FaultException%601> 例外をスローします。次のサンプル コードを参照してください。  この例外により、クライアントにエラーが送信されます。  
+  
+```  
+public int Divide(int n1, int n2)  
+{  
+    try  
+    {  
+        return n1 / n2;  
+    }  
+    catch (DivideByZeroException)  
+    {  
+        MathFault mf = new MathFault();  
+        mf.operation = "division";  
+        mf.problemType = "divide by zero";  
+        throw new FaultException<MathFault>(mf);  
+    }  
+}  
+```  
+  
+ クライアント コードは、0 による除算を要求することで強制的にエラーを発生させます。  このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  0 による除算がエラーとして報告されたことが示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(15,3) = 18  
+Subtract(145,76) = 69  
+Multiply(9,81) = 729  
+FaultException<MathFault>: Math fault while doing division. Problem: divide by zero  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+ クライアントでこれを行うには、適切な `FaultException<MathFault>` 例外を次のようにキャッチします。  
+  
+```  
+catch (FaultException<MathFault> e)  
+{  
+    Console.WriteLine("FaultException<MathFault>: Math fault while doing " + e.Detail.operation + ". Problem: " + e.Detail.problemType);  
+    client.Abort();  
+}  
+```  
+  
+ 既定では、サービス実装の詳細がサービスのセキュリティの境界から漏えいするのを回避するため、予期しない例外の詳細はクライアントに送信されません。  `FaultContract` では、コントラクトでエラーを説明し、例外の特定の型がクライアントへの転送に適しているとマークできます。  `FaultException<T>` には、エラーをコンシューマーに送信するためのランタイム機構が用意されています。  
+  
+ ただし、デバッグ時にはサービス エラーの内部詳細を確認することが役立ちます。  前に説明したセキュリティ動作を無効にするには、サーバーで未処理のすべての例外の詳細を、クライアントに送信するエラーに含めるように指定できます。  これは、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A> を `true` に設定することによって行います。  次の例に示すように、コードまたは構成のどちらを使用しても設定できます。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="True" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ さらに、サービスの `behaviorConfiguration` 属性を構成ファイルで “CalculatorServiceBehavior” に設定し、動作をサービスに関連付ける必要があります。  
+  
+ こうしたエラーをクライアントでキャッチするには、非ジェネリックの <xref:System.ServiceModel.FaultException> をキャッチする必要があります。  
+  
+ この動作はデバッグ目的でのみ使用し、製品版では有効にしないでください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Faults`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/federation-sample.md b/docs/framework/wcf/samples/federation-sample.md
new file mode 100644
index 00000000000..11dfed3220e
--- /dev/null
+++ b/docs/framework/wcf/samples/federation-sample.md
@@ -0,0 +1,127 @@
+---
+title: "フェデレーション サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7e9da0ca-e925-4644-aa96-8bfaf649d4bb
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# フェデレーション サンプル
+このサンプルではフェデレーション セキュリティを示します。  
+  
+## サンプルの詳細  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] は、`wsFederationHttpBinding` を使用して、フェデレーション セキュリティ アーキテクチャの展開をサポートします。`wsFederationHttpBinding` は、セキュリティで保護された、信頼できる、相互運用が可能なバインディングを提供します。このバインディングでは、要求\/応答の通信のための基になるトランスポート機構として HTTP を使用でき、エンコーディングのためのワイヤ形式として Text\/XML を使用できます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でのフェデレーション[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[フェデレーション](../../../../docs/framework/wcf/feature-details/federation.md)」を参照してください。  
+  
+ シナリオは、次の 4 つの部分から構成されます。  
+  
+-   BookStore サービス  
+  
+-   BookStore STS  
+  
+-   HomeRealm STS  
+  
+-   BookStore クライアント  
+  
+ BookStore サービスは、`BrowseBooks` と `BuyBook` の 2 つの操作をサポートします。サービスでは、`BrowseBooks` 操作には匿名アクセスできますが、`BuyBooks` 操作にアクセスするには認証済みのアクセス権限が必要です。認証は、BookStore STS によって発行されたトークンの形式を取ります。BookStore サービス用の構成ファイルは、次のように `wsFederationHttpBinding` を使用して、クライアントを BookStore STS にポイントします。  
+  
+```  
+<wsFederationHttpBinding>  
+<!-- This is the Service binding for the BuyBooks endpoint. It redirects clients to the BookStore STS -->  
+    <binding name='BuyBookBinding'>  
+        <security mode="Message">  
+            <message>  
+                <issuerMetadata  
+  address='http://localhost/FederationSample/BookStoreSTS/STS.svc/mex' >  
+                    <identity>  
+                        <dns value ='BookStoreSTS.com'/>  
+                    </identity>  
+                </issuerMetadata>  
+            </message>  
+        </security>  
+    </binding>  
+</wsFederationHttpBinding>  
+```  
+  
+ 次に BookStore STS は、HomeRealm STS によって発行されたトークンを使用した、クライアントの認証を要求します。ここでも、BookStore STS 用の構成ファイルは、`wsFederationHttpBinding` を使用して、クライアントを HomeRealm STS にポイントします。  
+  
+```  
+<wsFederationHttpBinding>  
+ <!-- This is the binding for the clients requesting tokens from this STS. It redirects clients to the HomeRealm STS -->  
+    <binding name='BookStoreSTSBinding'>  
+        <security mode='Message'>  
+            <message>  
+                <issuerMetadata  
+ address='http://localhost/FederationSample/HomeRealmSTS/STS.svc/mex' >  
+                    <identity>  
+                        <dns value ='HomeRealmSTS.com' />  
+                    </identity>  
+                </issuerMetadata>  
+            </message>  
+        </security>  
+    </binding>  
+</wsFederationHttpBinding>  
+```  
+  
+ `BuyBook` 操作にアクセスするときに発生するイベントの順序は、次のとおりです。  
+  
+1.  クライアントは、Windows 資格情報を使用して HomeRealm STS に対する認証を行います。  
+  
+2.  HomeRealm STS は、BookStore STS に対する認証に使用できるトークンを発行します。  
+  
+3.  クライアントは、HomeRealm STS によって発行されたトークンを使用して BookStore STS に対する認証を行います。  
+  
+4.  BookStore STS は、BookStore サービスに対する認証に使用できるトークンを発行します。  
+  
+5.  クライアントは、BookStore STS によって発行されたトークンを使用して BookStore サービスに対する認証を行います。  
+  
+6.  クライアントは `BuyBook` 操作にアクセスします。  
+  
+ このサンプルの設定および実行方法については、次の手順を参照してください。  
+  
+> [!NOTE]
+>  このサンプルを実行するには、**wwwroot** ディレクトリに対する書き込み権限が必要です。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  SDK コマンド ウィンドウを開きます。Setup.bat をサンプルのパスで実行します。これにより、サンプルに必要な仮想ディレクトリが作成され、必要な証明書が適切な権限を付与されてインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、Windows SDK コマンド プロンプトから実行します。MSSDK 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Windows SDK コマンド プロンプトで自動設定されます。セットアップで IIS 管理者スクリプトが使用されるため、[!INCLUDE[wv](../../../../includes/wv-md.md)] で IIS 6.0 管理互換がインストールされていることを確認する必要があります。[!INCLUDE[wv](../../../../includes/wv-md.md)] でセットアップ スクリプトを実行するには、管理者権限が必要です。  
+  
+2.  Visual Studio で FederationSample.sln を開き、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。これによって共通のプロジェクト ファイル、Bookstore サービス、Bookstore STS、および HomeRealm STS が作成され、IIS に展開されます。さらに Bookstore クライアント アプリケーションがビルドされ、FederationSample\\BookStoreClient\\bin\\Debug フォルダに実行可能ファイル BookStoreClient.exe が配置されます。  
+  
+3.  BookStoreClient.exe をダブルクリックします。BookStoreClient ウィンドウが表示されます。  
+  
+4.  **\[Browse Books\]** をクリックすると、この書店で利用できる本を参照できます。  
+  
+5.  特定の本を購入するには、一覧で本を選択して **\[Buy Book\]** をクリックします。アプリケーションが起動し、HomeRealm セキュリティ トークン サービスを使用した Windows 認証によって認証を行います。  
+  
+     サンプルは、ユーザーが 15 ドル以下の本を購入できるように構成されています。15 ドルを超える本を購入しようとすると、クライアントは、BookStore サービスからアクセス拒否のメッセージを受け取ります。  
+  
+    > [!NOTE]
+    >  サンプルでは、購入後にユーザーの与信限度額を更新しません。ユーザーは、\(固定の\) 与信限度額以内なら何度でも本を購入できます。  
+  
+#### クリーンアップするには  
+  
+1.  Cleanup.bat を実行します。これによって、設定中に作成された仮想ディレクトリが削除されます。同時に、設定中にインストールされた証明書も削除されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\Federation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/feed-formatter-json.md b/docs/framework/wcf/samples/feed-formatter-json.md
new file mode 100644
index 00000000000..c0a7a58def6
--- /dev/null
+++ b/docs/framework/wcf/samples/feed-formatter-json.md
@@ -0,0 +1,72 @@
+---
+title: "フィード フォーマッタ (JSON) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f9c0b295-55e7-48ea-b308-ba51c7d31143
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# フィード フォーマッタ (JSON)
+このサンプルでは、カスタムの <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> および <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用することにより JSON \(JavaScript Object Notation\) 形式の <xref:System.ServiceModel.Syndication.SyndicationFeed> クラスのインスタンスをシリアル化する方法を示します。  
+  
+## サンプルのアーキテクチャ  
+ このサンプルは <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> を継承する `JsonFeedFormatter` という名前のクラスを実行します。  `JsonFeedFormatter` クラスは <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> に依存し、JSON 形式でデータの読み取りと書き込みを行います。  内部的には、フォーマッタは `JsonSyndicationFeed` および `JsonSyndicationItem` という名前のデータ コントラクト型のカスタム セットを使用し、シリアライザによって生成される JSON データの形式を制御します。  これらの実装の詳細はエンド ユーザーには表示されず、標準的な <xref:System.ServiceModel.Syndication.SyndicationFeed> および <xref:System.ServiceModel.Syndication.SyndicationItem> クラスに対する呼び出しを行うことができます。  
+  
+## JSON フィードの書き込み  
+ 次のコード例に示すように、JSON フィードの書き込みは `JsonFeedFormatter` \(このサンプルで実装\) を <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> と共に使用して実行できます。  
+  
+```  
+//Basic feed with sample data  
+SyndicationFeed feed = new SyndicationFeed("Custom JSON feed", "A Syndication extensibility sample", null);  
+feed.LastUpdatedTime = DateTime.Now;  
+feed.Items = from s in new string[] { "hello", "world" }  
+select new SyndicationItem()  
+{  
+    Summary = SyndicationContent.CreatePlaintextContent(s)  
+};  
+  
+//Write the feed out to a MemoryStream in JSON format  
+DataContractJsonSerializer writeSerializer = new DataContractJsonSerializer(typeof(JsonFeedFormatter));  
+writeSerializer.WriteObject(stream, new JsonFeedFormatter(feed));  
+  
+```  
+  
+## JSON フィードの読み取り  
+ 次のコードに示すように、JSON 形式のデータのストリームからの <xref:System.ServiceModel.Syndication.SyndicationFeed> の取得は `JsonFeedFormatter` を使用して実行できます。  
+  
+ `//Read in the feed using the DataContractJsonSerializer`  
+  
+ `DataContractJsonSerializer readSerializer = new DataContractJsonSerializer(typeof(JsonFeedFormatter));`  
+  
+ `JsonFeedFormatter formatter = readSerializer.ReadObject(stream) as JsonFeedFormatter;`  
+  
+ `SyndicationFeed feedRead = formatter.Feed;`  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Syndication\JsonFeeds`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/findprivatekey.md b/docs/framework/wcf/samples/findprivatekey.md
new file mode 100644
index 00000000000..8352a6cfe31
--- /dev/null
+++ b/docs/framework/wcf/samples/findprivatekey.md
@@ -0,0 +1,106 @@
+---
+title: "FindPrivateKey | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "FindPrivateKey"
+ms.assetid: 16b54116-0ceb-4413-af0c-753bb2a785a6
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# FindPrivateKey
+証明書ストア内の特定の X.509 証明書に関連付けられている秘密キー ファイルの場所と名前を見つけることが困難な場合があります。FindPrivateKey.exe ツールを使用すると、この処理を容易に実行できます。  
+  
+> [!IMPORTANT]
+>  FindPrivateKey は、使用する前にコンパイルする必要があるサンプルです。FindPrivateKey ツールをビルドする手順については、この後の「FindPrivateKey プロジェクトをビルドするには」のセクションを参照してください。  
+  
+ X.509 証明書は、コンピューターの管理者または任意のユーザーによってインストールされます。ただし、証明書は別のアカウント \([!INCLUDE[wxp](../../../../includes/wxp-md.md)] の ASPNET、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] の NETWORK SERVICE アカウントなど\) で実行されているサービスからアクセスすることができます。  
+  
+ 別のアカウントでは、秘密キー ファイルへアクセスできない場合があります。これは、証明書が最初にこのアカウントによってインストールされていないからです。FindPrivateKey ツールでは、指定された X.509 証明書の秘密キー ファイルの場所を検索できます。特定の X.509 証明書の秘密キー ファイルの場所がわかれば、このファイルに対するアクセス許可の追加または削除を実行できます。  
+  
+ セキュリティ用の証明書を使用するこのサンプルでは、Setup.bat ファイル内の FindPrivateKey ツールを使用します。秘密キー ファイルが見つかったら、Cacls.exe などの別のツールを使用して、このファイルに対する適切なアクセス権を設定できます。  
+  
+ 自己ホスト型の実行可能ファイルなどの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをユーザー アカウントで実行している場合は、そのユーザー アカウントがそのファイルへの読み取り専用のアクセス権限を持っていることを確認します。インターネット インフォメーション サービス \(IIS\) で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを実行している場合、サービスが実行されている既定のアカウントは、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] では ASPNET、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では NETWORK SERVICE です。これらのアカウントには、既定では秘密キー ファイルへのアクセス権限がありません。  
+  
+## 例  
+ 証明書にアクセスする際、プロセスにその証明書に対する読み取り権限がない場合、次の例のような例外メッセージが表示されます。  
+  
+```  
+System.ArgumentException was unhandled  
+Message="The certificate 'CN=localhost' must have a private key that is capable of key exchange.  The process must have access rights for the private key."  
+Source="System.ServiceModel"  
+```  
+  
+ この例外が発生したら、FindPrivateKey ツールを使用して秘密キー ファイルを検索し、サービスが実行されているプロセスにアクセス権を設定します。たとえば、次の例に示すように、Cacls.exe ツールを使用して処理できます。  
+  
+```  
+cacls.exe "C:\Documents and Settings\All Users\Application Data\Microsoft\Crypto\RSA\MachineKeys\8aeda5eb81555f14f8f9960745b5a40d_38f7de48-5ee9-452d-8a5a-92789d7110b1" /E /G "NETWORK SERVICE":R  
+```  
+  
+#### FindPrivateKey プロジェクトをビルドするには  
+  
+1.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を開き、サンプルのインストール ディレクトリに存在する言語固有のサブディレクトリに移動します。  
+  
+2.  .sln ファイルのアイコンをダブルクリックして、このファイルを Visual Studio で開きます。  
+  
+3.  **\[ビルド\]** メニューの **\[ソリューションのリビルド\]** をクリックします。クライアント プログラムが client\\bin にビルドされ、サービス プログラムが service\\bin にビルドされます。  
+  
+4.  ソリューションをビルドすると、FindPrivateKey.exe ファイルが生成されます。  
+  
+## 規約 \- コマンド ラインのエントリ  
+ "\[*option*\]" は省略可能なパラメーターのセットを表します。  
+  
+ "{*option*}" は必須パラメーターのセットを表します。  
+  
+ "*option1* &#124;*option2*" はオプションのセットから選択することを表します。  
+  
+ "\<*value*\>" は入力されるパラメーター値を表します。  
+  
+## 使用法  
+  
+```  
+FindPrivateKey <storeName> <storeLocation> [{ {-n <subjectName>} | {-t <thumbprint>} } [-f | -d | -a]]  
+```  
+  
+ 指定する項目は次のとおりです。  
+  
+```  
+       <subjectName> The subject name of the certificate  
+       <thumbprint>  The thumbprint of the certificate (You can use the Certmgr.exe tool to find this)  
+       -f            output file name only  
+       -d            output directory only  
+       -a            output absolute file name  
+```  
+  
+ コマンド プロンプトでパラメーターを指定しない場合、このヘルプ テキストが表示されます。  
+  
+## 例  
+ この例では、現在のユーザーの Personal ストアで、"CN\=localhost" というサブジェクト名を持つ証明書のファイル名を検索します \(FindPrivateKey My CurrentUser \-n "CN\=localhost"\)。  
+  
+ この例では、現在のユーザーの Personal ストアで、"CN\=localhost" というサブジェクト名を持つ証明書のファイル名を検索し、ディレクトリの完全パスを出力します。  
+  
+```  
+User.FindPrivateKey My CurrentUser -n "CN=localhost" -a  
+  
+```  
+  
+ この例では、ローカル コンピューターの Personal ストアで、"03 33 98 63 d0 47 e7 48 71 33 62 64 76 5c 4c 9d 42 1d 6b 52" というサムプリントを持つ証明書のファイル名を検索します。  
+  
+```  
+FindPrivateKey My LocalMachine -t "03 33 98 63 d0 47 e7 48 71 33 62 64 76 5c 4c 9d 42 1d 6b 52" –c  
+```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/firewall-instructions.md b/docs/framework/wcf/samples/firewall-instructions.md
new file mode 100644
index 00000000000..5d237b5e9fb
--- /dev/null
+++ b/docs/framework/wcf/samples/firewall-instructions.md
@@ -0,0 +1,100 @@
+---
+title: "ファイアウォール手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: a7dc429f-65ac-4faf-974a-77d5fb977fe1
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# ファイアウォール手順
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルが機能するように、ファイアウォール内でいくつかのポートまたはプログラムを有効にする必要があります。サンプルの多くは、通信する際に 8000 ～ 8003 の範囲のポートと 9000 のポートを使用します。既定ではファイアウォールが有効なので、こうしたポートにはアクセスできません。サンプル用にファイアウォールを有効にするには、要件とセキュリティ環境に応じて次のいずれかの手順を完了する必要があります。  
+  
+-   オプション 1: 実行中のサンプルを対話形式で有効にします。ファイアウォールの構成をあらかじめ変更することなく、サンプルのビルドおよび実行の開始に進みます。サンプルが実行されると、**\[Windows セキュリティの緊急警告\]** ダイアログ ボックスが表示されます。対象のプログラムを、ブロック解除の一覧に対話形式で追加できます。この手順では、この後サンプルを再起動する必要があります。  
+  
+-   オプション 2: サンプル プログラムをあらかじめ有効にしておきます。**Windows ファイアウォールのコントロール パネル** アプレットを開始し、実行するサンプル プログラムを有効にします。実行可能ファイルが存在するように、プログラムを最初にビルドする必要があります。手順の詳細については、後述を参照してください。  
+  
+-   オプション 3: ポート範囲をあらかじめ有効にしておきます。**Windows ファイアウォール**の**コントロール パネル** アプレットを開始し、サンプルで使用するポート 80、443、8000 ～ 8003、および 9000 を有効にします。手順の詳細については、後述を参照してください。このオプションは他の手順よりも安全性が低くなります。サンプルだけでなく、任意のプログラムでこれらのポートを使用できるようになるからです。  
+  
+ どの手順を使用するか判断に迷う場合は、最初のオプションを選択してください。他のベンダのファイアウォールを実行している場合も、同様の変更が必要になる場合があります。  
+  
+> [!IMPORTANT]
+>  ファイアウォールの構成を変更すると、セキュリティに影響します。変更内容は記録し、サンプルの使用が終わったらそれらの変更点を削除することをお勧めします。  
+  
+### サンプル プログラムをあらかじめ有効にしておくには  
+  
+1.  このサンプルをビルドします。  
+  
+2.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして、「`firewall.cpl`」と入力します。これにより、**Windows ファイアウォールのコントロール パネル** アプレットが開きます。  
+  
+    > [!NOTE]
+    >  Windows ファイアウォールを介して通信する機能が必要なサンプルを実行するには、ファイアウォール設定を変更するための権限が必要です。一部のファイウォール設定を変更できず、コンピューターがドメインに接続される場合は、システム管理者がグループ ポリシーを使用してファイアウォール設定を管理している可能性があります。  
+  
+3.  Windows ファイアウォールを介したプログラムを許可するには、次のいずれかの手順を実行します。  
+  
+    -   Windows 7 または Windows Server 2008 R2 の場合は、**\[Windows ファイアウォールを介したプログラムまたは機能を許可する\]** をクリックします。**\[設定の変更\]**、**\[別のプログラムの許可...\]** の順にクリックします。  
+  
+    -   [!INCLUDE[wv](../../../../includes/wv-md.md)] または [!INCLUDE[lserver](../../../../includes/lserver-md.md)] の場合は、**\[Windows ファイアウォールによるプログラムの許可\]** をクリックします。  
+  
+4.  **\[例外\]** タブの **\[プログラムの追加\]** をクリックします。  
+  
+5.  **\[参照\]** ボタンをクリックして、実行するサンプルの実行可能ファイルを選択します。  
+  
+6.  手順 4. と 5. を繰り返して、実行するすべてのサンプルの実行可能ファイルを追加します。  
+  
+7.  **\[OK\]** をクリックして、ファイアウォール アプレットを閉じます。  
+  
+### ポート範囲をあらかじめ有効にしておくには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして、「`firewall.cpl`」と入力します。これにより、**Windows ファイアウォールのコントロール パネル** アプレットが開きます。  
+  
+2.  Windows 7 または Windows Server 2008 R2 の場合は、次の手順を実行します。  
+  
+    1.  \[Windows ファイアウォール\] ウィンドウの左の列で、**\[詳細設定\]** をクリックします。  
+  
+    2.  左の列で、**\[受信の規則\]** をクリックします。  
+  
+    3.  右の列で、**\[新しい規則\]** をクリックします。  
+  
+    4.  **\[ポート\]** を選択して **\[次へ\]** をクリックします。  
+  
+    5.  **\[TCP\]** を選択し、**\[特定のローカル ポート\]** フィールドに「`8000, 8001, 8002, 8003, 9000, 80, 443`」と入力します。  
+  
+    6.  **\[次へ\]** をクリックします。  
+  
+    7.  **\[接続を許可する\]** を選択して **\[次へ\]** をクリックします。  
+  
+    8.  **\[ドメイン\]** と **\[プライベート\]** を選択して **\[次へ\]** をクリックします。  
+  
+    9. この規則の名前を「`WCF-WF 4.0 サンプル`」に設定し、**\[完了\]** をクリックします。  
+  
+    10. **\[送信の規則\]** をクリックし、手順 c ～ h を繰り返します。  
+  
+3.  [!INCLUDE[wv](../../../../includes/wv-md.md)] または [!INCLUDE[lserver](../../../../includes/lserver-md.md)] の場合は、次の手順を実行します。  
+  
+    1.  **\[Windows ファイアウォールによるプログラムの許可\]** をクリックします。  
+  
+    2.  **\[例外\]** タブの **\[ポートの追加\]** をクリックします。  
+  
+    3.  ポートの名前とポート番号 8000 を入力して、**\[TCP\]** オプションをクリックします。  
+  
+    4.  **\[スコープの変更\]** をクリックして **\[ユーザーのネットワーク \(サブネット\) のみ\]** オプションをクリックし、**\[OK\]** をクリックします。  
+  
+    5.  手順 b ～ d を繰り返して、ポート 8001、8002、8003、9000、80、および 443 を設定します。  
+  
+4.  **\[OK\]** をクリックして、ファイアウォール アプレットを閉じます。  
+  
+> [!NOTE]
+>  サンプルの実行が終わったら、ファイアウォールのすべての例外を削除します。これを行うには、**Windows ファイアウォールのコントロール パネル** アプレットを開き、前の手順で追加したすべてのプログラムまたはポートのエントリを削除します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/form-post.md b/docs/framework/wcf/samples/form-post.md
new file mode 100644
index 00000000000..33a1974e5f9
--- /dev/null
+++ b/docs/framework/wcf/samples/form-post.md
@@ -0,0 +1,64 @@
+---
+title: "フォーム ポスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa6f84f9-2e07-4e3c-92d0-a245308b7dff
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# フォーム ポスト
+このサンプルでは、WCF REST プログラミング モデルを拡張して新しい受信要求形式をサポートする方法を示します。  このサンプルには、要求を HTML フォーム ポストから [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型に逆シリアル化できるフォーマッタの実装も含まれています。  また、このサンプルでは T4 テンプレートを使用して、ユーザーが WCF REST サービスにポストバックできる HTML フォームを提供する HTML ページを返します。  
+  
+## 使用例  
+  
+-   受信要求形式のサポートの拡張。  
+  
+-   T4 テンプレートの統合。  
+  
+## 説明  
+ このサンプルは、2 つのプロジェクトで構成されます。  1 つ目のプロジェクトは、HTML フォーム ポストを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型に逆シリアル化できるカスタム要求フォーマッタを含む HtmlFormProcessing ライブラリです。  2 つ目のプロジェクトは、HtmlFormProcessing ライブラリのカスタム要求フォーマッタを使用するように基本的なリソース サービス サンプルを拡張するコンソール アプリケーションです。  
+  
+ HTML フォーム ポストを逆シリアル化できるカスタム フォーマッタ \(HtmlFormRequestDispatchFormatter\) は、<xref:System.ServiceModel.Dispatcher.QueryStringConverter> を使用して文字列から変換できる [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型と、QueryStringConverter を使用して文字列から変換できるメンバーのみを持つ <xref:System.Runtime.Serialization.DataContractAttribute> でマークされた型の両方を受け入れます。  
+  
+ HtmlFormProcessing ライブラリ プロジェクトには、他のカスタム要求フォーマッタを作成するために使用できる抽象基本クラス `RequestBodyDispatchFormatter` も含まれています。  `RequestBodyDispatchFormatter` から派生させると、開発者は、基本クラスで URI テンプレート パラメーターを操作のメソッド パラメーターにマップできるようにする要求本文の逆シリアル化ロジックに集中できます。  また、HtmlFormProcessing ライブラリ プロジェクトには、<xref:System.ServiceModel.Description.WebHttpBehavior> から派生させて既定の要求フォーマッタをカスタム要求フォーマッタに置き換える方法を示す `HtmlFormProcessingBehavior` クラスもあります。  
+  
+ このコンソール アプリケーション プロジェクトでは、「[基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)」のサンプルを拡張します。  基本的なリソース サービス サンプルは、WCF REST プログラミング モデルを使用してリソースを公開する方法を示しています。  基本的なリソース サービス サンプルでは、コレクション内の顧客を作成、取得、更新、および削除できるように、顧客コレクション リソースが公開されています。  基本的なリソース サービス サンプルでは、ネイティブでサポートされる XML と JSON の 2 つの受信要求形式のみが使用されます。  
+  
+ このフォーム ポスト サンプルのコンソール アプリケーションでは、HtmlFormProcessing ライブラリのカスタム フォーマッタが使用されるので、ユーザーはブラウザーを使用して HTML フォーム ポストから要求を送信することで顧客を作成できます。  また、このサンプルでは、サービスにポストバックされるフォームを含む HTML ページを返す操作も追加します。  この HTML ページは、事前に処理された T4 テンプレートを使用して生成されます。この T4 テンプレートは .tt ファイルと自動生成された .cs ファイルで構成されます。  開発者は、.tt ファイルを使用して変数と制御構造を含むテンプレート フォームで応答を作成できます。  [!INCLUDE[crabout](../../../../includes/crabout-md.md)] T4、「[コード生成と T4 テキスト テンプレート](http://go.microsoft.com/fwlink/?LinkId=178139)」を参照してください。  
+  
+#### サンプルを実行するには  
+  
+1.  フォーム ポスト サンプルのソリューションを開きます。  サンプルを正しく実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を起動するときに、管理者として実行する必要があります。  管理者として実行するには、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] アイコンを右クリックし、コンテキスト メニューの \[管理者として実行\] をクリックします。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押してコンソール アプリケーションの FormPost プロジェクトを実行します。  
+  
+3.  コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  
+  
+4.  サンプルが実行されると、クライアントは現在のアクティビティのステータス \(顧客を追加しているのか、顧客を更新しているのか、顧客を削除しているのか、または現在の顧客の一覧をサービスから取得しているのか\) をコンソール ウィンドウに書き込みます。  
+  
+5.  顧客フォームの URI を参照するように求められます。  ブラウザーを開き、指定された URI を参照します。  顧客の名前と住所を入力し、**\[送信\]** ボタンをクリックします。  
+  
+6.  コンソール ウィンドウでサンプルの実行を続けるには、任意のキーを押します。  
+  
+7.  サンプルが完了すると、ブラウザーを使用して作成した顧客が最終的な顧客の一覧に追加されたことがわかります。  
+  
+8.  任意のキーを押して、サンプルを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Web\FormPost`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/getting-started-sample.md b/docs/framework/wcf/samples/getting-started-sample.md
new file mode 100644
index 00000000000..bc34edce242
--- /dev/null
+++ b/docs/framework/wcf/samples/getting-started-sample.md
@@ -0,0 +1,303 @@
+---
+title: "入門サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "基本的なサンプル [WCF], 概要"
+ms.assetid: 967a3d94-0261-49ff-b85a-20bb07f1af20
+caps.latest.revision: 60
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 60
+---
+# 入門サンプル
+この入門サンプルでは、一般的なサービスと一般的なクライアントを、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して実装する方法を示します。このサンプルは、他のすべての基本的な技術サンプルの基礎になります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\GettingStarted\GettingStarted`  
+  
+ サービスが実行する操作は、メタデータとしてパブリックに公開するサービス コントラクト内に表されています。また、サービスにはその操作を実装するためのコードが含まれています。  
+  
+ クライアントには、サービス コントラクトの定義と、サービスにアクセスするためのプロキシ クラスが含まれています。プロキシ コードは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してサービス メタデータから生成されます。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] では、サービスは Windows アクティベーション サービス \(WAS\) 内でホストされます。[!INCLUDE[wxp](../../../../includes/wxp-md.md)] と [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では、インターネット インフォメーション サービス \(IIS\) と ASP.NET によってホストされます。サービスを IIS または WAS でホストすることにより、サービスに初めてアクセスしたときにそのサービスを自動的にアクティブ化できます。  
+  
+> [!NOTE]
+>  IIS ではなくコンソール アプリケーションでサービスをホストするサンプルから始める場合は、「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」サンプルを参照してください。  
+  
+ サービスとクライアントは、アクセスの詳細を構成ファイルの設定により指定します。この方法によって展開時の柔軟性が得られます。この設定には、アドレス、バインディング、およびコントラクトを指定するエンドポイント定義が含まれます。バインディングは、サービスへのアクセス方法を示すためのトランスポートとセキュリティの詳細を指定します。  
+  
+ サービスは、メタデータを公開するようにランタイムの動作を構成します。  
+  
+ サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および 除算\) を公開しています。クライアントは指定された算術演算を要求し、サービスは結果と共に応答します。サービスは、次に示すコードで定義される `ICalculator` コントラクトを実装します。  
+  
+```vb  
+' Define a service contract.  
+    <ServiceContract(Namespace:="http://Microsoft.Samples.GettingStarted")>  
+     Public Interface ICalculator  
+        <OperationContract()>  
+        Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()>  
+        Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()>  
+        Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double  
+        <OperationContract()>  
+        Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double  
+    End Interface  
+  
+```  
+  
+```csharp  
+// Define a service contract.  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+  
+```  
+  
+ サービス実装は計算を行い、結果を返します。次のコード例を参照してください。  
+  
+```vb  
+' Service class which implements the service contract.  
+Public Class CalculatorService  
+Implements ICalculator  
+Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add  
+Return n1 + n2  
+End Function  
+  
+Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract  
+Return n1 - n2  
+End Function  
+  
+Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply  
+Return n1 * n2  
+End Function  
+  
+Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide  
+Return n1 / n2  
+End Function  
+End Class  
+  
+```  
+  
+```csharp  
+// Service class that implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    public double Add(double n1, double n2)  
+    {  
+        return n1 + n2;  
+    }  
+    public double Subtract(double n1, double n2)  
+    {  
+        return n1 - n2;  
+    }  
+    public double Multiply(double n1, double n2)  
+    {  
+        return n1 * n2;  
+    }  
+    public double Divide(double n1, double n2)  
+    {  
+        return n1 / n2;  
+    }  
+}  
+  
+```  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル \(Web.config\) を使用して定義します。次のサンプル構成を参照してください。  
+  
+```xaml  
+<services>  
+    <service   
+        name="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- ICalculator is exposed at the base address provided by  
+         host: http://localhost/servicemodelsamples/service.svc.  -->  
+       <endpoint address=""  
+              binding="wsHttpBinding"  
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+       ...  
+    </service>  
+</services>  
+  
+```  
+  
+ サービスは、IIS ホストまたは WAS ホストから提供されるベース アドレスで、エンドポイントを公開します。バインディングの構成には、標準の <xref:System.ServiceModel.WSHttpBinding> を使用します。これは HTTP 通信と Web サービスの標準プロトコルを提供し、アドレス指定とセキュリティをサポートします。コントラクトは、サービスによって実装される `ICalculator` です。  
+  
+ 上記の構成では、サービスと同じコンピューター上にあるクライアントは、http:\/\/localhost\/servicemodelsamples\/service.svc でサービスにアクセスできます。リモート コンピューター上のクライアントがサービスにアクセスするには、localhost の代わりに完全修飾ドメイン名を指定する必要があります。  
+  
+ 既定では、フレームワークはメタデータを公開しません。そのため、サービスは <xref:System.ServiceModel.Description.ServiceMetadataBehavior> を有効にし、Metadata Exchange \(MEX\) エンドポイントを http:\/\/localhost\/servicemodelsamples\/service.svc\/mex で公開します。これを設定する構成を次に示します。  
+  
+```xaml  
+<system.serviceModel>  
+  <services>  
+    <service   
+        name="Microsoft.ServiceModel.Samples.CalculatorService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+      ...  
+      <!-- the mex endpoint is explosed at  
+       http://localhost/servicemodelsamples/service.svc/mex -->  
+      <endpoint address="mex"  
+                binding="mexHttpBinding"  
+                contract="IMetadataExchange" />  
+    </service>  
+  </services>  
+  
+  <!--For debugging purposes set the includeExceptionDetailInFaults  
+   attribute to true-->  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior">  
+        <serviceMetadata httpGetEnabled="True"/>  
+        <serviceDebug includeExceptionDetailInFaults="False" />  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+ クライアントは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成されたクライアント クラスを使用することによって、特定のコントラクト型を使用して通信を行います。このように生成されたクライアントは、ファイル generatedClient.cs または generatedClient.vb に含まれています。このユーティリティは、特定のサービス用のメタデータを取得し、特定のコントラクト型を使用して通信するクライアント アプリケーションによって使用されるクライアントを生成します。クライアント コードを生成するには、ホストされるサービスを利用できる必要があります。このサービスは、更新されたメタデータの取得に使用されるためです。  
+  
+ 次のコマンドをクライアント ディレクトリで SDK コマンド プロンプトから実行して、型指定のあるプロキシを生成します。  
+  
+```  
+svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs  
+```  
+  
+ Visual Basic でクライアントを生成するには、次のコマンドを SDK コマンド プロンプトから入力します。  
+  
+ `Svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb`  
+  
+ 生成されたクライアントを使用することにより、クライアントは適切なアドレスとバインディングを構成して、指定のサービス エンドポイントにアクセスできます。サービスと同様、クライアントは構成ファイル \(App.config\) を使用して、通信するエンドポイントを指定します。クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。次の例を参照してください。  
+  
+```xaml  
+<client>  
+     <endpoint  
+         address="http://localhost/servicemodelsamples/service.svc"   
+         binding="wsHttpBinding"   
+         contract=" Microsoft.ServiceModel.Samples.ICalculator" />  
+</client>  
+  
+```  
+  
+ クライアント実装はクライアントをインスタンス化し、型指定のあるインターフェイスを使用してサービスとの通信を開始します。次のコード例を参照してください。  
+  
+```vb  
+' Create a client  
+Dim client As New CalculatorClient()  
+  
+' Call the Add service operation.  
+            Dim value1 = 100.0R  
+            Dim value2 = 15.99R  
+            Dim result = client.Add(value1, value2)  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)  
+  
+' Call the Subtract service operation.  
+value1 = 145.00R  
+value2 = 76.54R  
+result = client.Subtract(value1, value2)  
+Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)  
+  
+' Call the Multiply service operation.  
+value1 = 9.00R  
+value2 = 81.25R  
+result = client.Multiply(value1, value2)  
+Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)  
+  
+' Call the Divide service operation.  
+value1 = 22.00R  
+value2 = 7.00R  
+result = client.Divide(value1, value2)  
+Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)  
+  
+'Closing the client gracefully closes the connection and cleans up resources  
+  
+```  
+  
+```csharp  
+// Create a client.  
+CalculatorClient client = new CalculatorClient();  
+  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = client.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Subtract service operation.  
+value1 = 145.00D;  
+value2 = 76.54D;  
+result = client.Subtract(value1, value2);  
+Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Multiply service operation.  
+value1 = 9.00D;  
+value2 = 81.25D;  
+result = client.Multiply(value1, value2);  
+Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Divide service operation.  
+value1 = 22.00D;  
+value2 = 7.00D;  
+result = client.Divide(value1, value2);  
+Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+//Closing the client releases all communication resources.  
+client.Close();  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ この入門サンプルでは、サービスとクライアントの標準的な作成方法を示します。その他の[Basic](../../../../docs/framework/wcf/samples/basic-sample.md)では、このサンプルに基づいて、具体的な製品機能の例を示します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [方法 : マネージ アプリケーションで WCF サービスをホストする](../../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)   
+ [方法 : IIS で WCF サービスをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-wcf-service-in-iis.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/hello-world-with-the-routing-service.md b/docs/framework/wcf/samples/hello-world-with-the-routing-service.md
new file mode 100644
index 00000000000..f29abf0195e
--- /dev/null
+++ b/docs/framework/wcf/samples/hello-world-with-the-routing-service.md
@@ -0,0 +1,66 @@
+---
+title: "ルーティング サービスを使用した Hello World | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0f4b0d5b-6522-4ad5-9f3a-baa78316d7d1
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# ルーティング サービスを使用した Hello World
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーティング サービスを示します。ルーティング サービスは、コンテンツ ベースのルーターをアプリケーションに簡単に追加できるようにする [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] コンポーネントです。このサンプルでは、標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 電卓のサンプルを改良し、ルーティング サービスを使用して通信するようにします。このサンプルの電卓クライアントは、ルーターによって公開されるエンドポイントにメッセージを送信するように構成されています。ルーティング サービスは、送信されてきたすべてのメッセージを受け入れ、電卓サービスに対応するエンドポイントに転送するように構成されています。したがって、クライアントから送信されたメッセージはルーターで受信され、実際の電卓サービスに再ルーティングされます。電卓サービスからのメッセージはルーターに送り返され、ルーターから電卓クライアントに渡されます。  
+  
+### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、HelloRoutingService.sln を開きます。  
+  
+2.  F5 キーを押すか、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+    > [!NOTE]
+    >  F5 キーを押した場合は、電卓クライアントが自動的に起動します。Ctrl キーと Shift キーを押しながら B キーを押した \(ビルドする\) 場合は、次のアプリケーションを手動で開始する必要があります。  
+    >   
+    >  1.  電卓クライアント \(.\/CalculatorClient\/bin\/client.exe\)  
+    > 2.  電卓サービス \(.\/CalculatorService\/bin\/service.exe\)  
+    > 3.  ルーティング サービス \(.\/RoutingService\/bin\/RoutingService.exe\)  
+  
+3.  Enter キーを押してクライアントを起動します。  
+  
+     次の出力が表示されます。  
+  
+     Add\(100,15.99\) \= 115.99  
+  
+     Subtract\(145,76.54\) \= 68.46  
+  
+     Multiply\(9,81.25\) \= 731.25  
+  
+     Divide\(22,7\) \= 3.14285714285714  
+  
+## コードまたは App.Config で構成可能  
+ サンプルは、提供された時点では、App.config ファイルを使用してルーターの動作を定義するように構成されています。App.config ファイルの名前を別の名前に変更して認識されないようにし、ConfigureRouterViaCode\(\) に対するメソッド呼び出しのコメントを解除することもできます。どちらの方法でも、ルーターの動作は同じになります。  
+  
+### シナリオ  
+ このサンプルでは、基本的なメッセージ ポンプとして機能するルーターを示します。ルーティング サービスは、構成済みの一連の送信先エンドポイントに直接メッセージを渡すように構成された透過的なプロキシ ノードとして機能します。  
+  
+### 実際のシナリオ  
+ Contoso では、サービスの名前指定、アドレス指定、構成、およびセキュリティに関する柔軟性を高めるために、基本的なメッセージ ポンプをサービスの前に配置して、それをエンドポイントとして公開しています。これにより、実際のサービスの前にセキュリティが追加され、スケールアウトされたソリューションやサービスのバージョン管理を後で簡単に実装できるようになります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\RoutingServices\HelloRoutingService`  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/hierarchical-configuration-model.md b/docs/framework/wcf/samples/hierarchical-configuration-model.md
new file mode 100644
index 00000000000..ccd6bc411a8
--- /dev/null
+++ b/docs/framework/wcf/samples/hierarchical-configuration-model.md
@@ -0,0 +1,85 @@
+---
+title: "階層的な構成モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 28dcc698-226c-4b77-9e51-8bf45a36216c
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 階層的な構成モデル
+このサンプルでは、サービスの構成ファイルの階層を実装する方法を示します。また、バインド、サービス動作、およびエンドポイント動作を階層の上位レベルから継承する方法も示します。  
+  
+## サンプルの詳細  
+ [!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 用に開発された機能の 1 つとして、階層的な構成モデルの強化があります。階層的な構成モデルは、たとえば、Machine.config \-\> Rootweb.config \-\> Web.config のように定義されます。[!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] では、構成階層の上位レベルで定義されるこれらのバインドおよび動作が、明示的な構成なしにサービスに追加されます。このサンプルでは、コンピューター レベルまたはアプリケーション レベルで定義された構成要素に依存することによって簡単なサービス構成を実現する方法を示します。  
+  
+ このサンプルは、階層の 3 つのレベルで定義された 9 個のサービスから構成されます。`Service1` はルートになります。`Service2` と `Service3` は `Service1` から既定の要素を継承します。`Service4`、`Service5`、`Service6`、および `Service7` は、階層の第 3 レベルで定義され、`Service3` から既定の要素を継承します。最後に、`Service10` および `Service11` は階層の第 4 レベルに置かれます。  
+  
+ すべてのサービスは `IDesc` コントラクトを実装します。`IDesc` インターフェイスの定義を次に示します。この定義は、このインターフェイスで公開されるメソッドを示しています。`IDesc` インターフェイスは Service1.cs で定義されます。  
+  
+```  
+// Define a service contract  
+[ServiceContract(Namespace="http://Microsoft.Samples.ConfigHierarchicalModel")]  
+public interface IDesc  
+{  
+    [OperationContract]  
+    List<string> ListEndpoints();  
+    [OperationContract]  
+    List<string> ListServiceBehaviors();  
+    [OperationContract]  
+    List<string> ListEndpointBehaviors();  
+}  
+  
+```  
+  
+ サービスによるこれらのメソッドの実装は単純です。`ListEndpoints` は、すべてのサービス エンドポイントを反復処理し、サービスにあるすべてのエンドポイントのリストを返します。`ListServiceBehaviors` は、サービスに追加されたすべての動作を反復処理し、サービスに関連付けられているすべてのサービス動作のリストを返します。`ListEndpointBehaviors` は、`ListServiceBehaviors` と同様に動作しますが、サービス動作ではなくエンドポイント動作のリストを返します。  
+  
+ この実装により、クライアントは、サービスで公開されているエンドポイントの数、およびサービスに追加されたサービス動作とエンドポイント動作を認識できます。サンプルの一部として実装されているクライアントは、ソリューションのすべてのサービスにサービス参照を追加し、サービスごとにこれらの要素を示します。  
+  
+## このサンプルを使用するには  
+  
+#### クライアントを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、ConfigHierarchicalModel.sln ファイルを開きます。  
+  
+2.  クライアント プロジェクトはまだスタートアップ プロジェクトに設定されていないので、次の手順で設定します。  
+  
+    1.  **ソリューション エクスプローラー**で、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    2.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[シングル スタートアップ プロジェクト\]** をクリックします。  
+  
+    3.  **\[シングル スタートアップ プロジェクト\]** ボックスの一覧で、**\[クライアント\]** をクリックします。  
+  
+    4.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+3.  サンプルをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+4.  クライアントを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!NOTE]
+>  この手順が機能しない場合は、次の手順を使用して、環境設定が適切であることを確認してください。  
+>   
+>  1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+> 2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+> 3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\ConfigHierarchicalModel`  
+  
+## 参照  
+ [AppFabric の管理のサンプル](http://go.microsoft.com/fwlink/?LinkId=193960)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/hosting.md b/docs/framework/wcf/samples/hosting.md
new file mode 100644
index 00000000000..b3dbd624abb
--- /dev/null
+++ b/docs/framework/wcf/samples/hosting.md
@@ -0,0 +1,42 @@
+---
+title: "ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8a6ec5d4-d191-49cc-bb0f-a07639dc60d4
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ホスト
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスをホストする方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [Windows プロセス アクティブ化](../../../../docs/framework/wcf/samples/windows-process-activation.md)  
+ ネットワーク プロトコルを使用したサービスのアクティブ化について説明します。  
+  
+ [構成ベースのアクティブ化](../../../../docs/framework/wcf/samples/configuration-based-activation.md)  
+ .svc ファイルを使用せずに [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをアクティブ化する方法を示します。  
+  
+ [SystemWebRouting 統合サンプル](../../../../docs/framework/wcf/samples/systemwebrouting-integration-sample.md)  
+ <xref:System.Web.Routing> 名前空間内のクラスを使用してレイヤーの統合をホストする方法を示します。  
+  
+ [ASP.NET 互換性](../../../../docs/framework/wcf/samples/aspnet-compatibility.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 互換性モードを有効にする方法を示します。  
+  
+ [インライン コードを使用した IIS ホスティング](../../../../docs/framework/wcf/samples/iis-hosting-using-inline-code.md)  
+ インターネット インフォメーション サービス \(IIS\) によってホストされるサービスを実装する方法を示します。サービス コードは .svc ファイルにインラインで含まれており、必要に応じてコンパイルされます。  
+  
+ [Windows サービス ホスト](../../../../docs/framework/wcf/samples/windows-service-host.md)  
+ マネージ Windows サービスでホストされる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを示します。  
+  
+ [自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)  
+ 自己ホスト型サービスをコンソール アプリケーションに実装する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/http-acknowledgement-channel.md b/docs/framework/wcf/samples/http-acknowledgement-channel.md
new file mode 100644
index 00000000000..e260dcf7ed0
--- /dev/null
+++ b/docs/framework/wcf/samples/http-acknowledgement-channel.md
@@ -0,0 +1,55 @@
+---
+title: "HTTP 受信確認チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 469f3056-5ef2-4753-8acf-b574d23d83cf
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# HTTP 受信確認チャネル
+HTTP 受信確認チャネルは、一方向メッセージング パターンを変える階層チャネルの例です。これにより、サービスでは、受信確認を自動的に送信するのではなく受信メッセージを承認または拒否できるようになります。また、HTTP 受信確認チャネルにより、サービスでは、メッセージが処理されるというビジネス レベルの保証がなされるまで受信確認を遅らせることができます。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Channels.ReceiveContext>、階層チャネルの例 \(HTTP 受信確認チャネル\)。  
+  
+## 説明  
+ HTTP 受信確認チャネルでは、<xref:System.ServiceModel.Channels.ReceiveContext> を実装して、HTTP 要求\/応答メッセージング パターンを、受信確認の遅延が可能な一方向のパターンに変えます。この新しいパターンを使用すると、サービスでは、OK を示す HTTP ステータス コード 200 の形式で受信確認を送信することによって、メッセージ処理が完了するまでクライアントをブロックすることなく、メッセージ処理を保証できます。または、内部サーバー エラーを示す HTTP ステータス コード 500 の形式でエラー メッセージをクライアントに送信できます。たとえば、サービスでは、メッセージをキューに書き込んだ後に受信確認を送信し、その後で、非同期にメッセージの処理を継続することもできます。このシナリオでは、クライアントは、サービスから受信確認を受け取るまで各メッセージを再送信する場合に、サービスによってメッセージが少なくとも一度は処理されたことを確認できます。ただし、サービスで、メッセージ処理の保証なしに、HTTP を介した非同期の高速なメッセージ処理を行う必要がある場合は、<xref:System.ServiceModel.Channels.OneWayBindingElement> の方が適しています。  
+  
+ <xref:System.ServiceModel.Channels.ReceiveContext> を使用すると、サービスでメッセージを処理できるかどうか判断している間、メッセージをそのままの状態にしておくことができます。サービスでメッセージを正常に処理できることは、HTTP OK ステータス コードを送信する <xref:System.ServiceModel.Channels.ReceiveContext> オブジェクトで Complete を呼び出すことによって示されます。また、サービスでメッセージを処理できるかどうかは、HTTP 内部サーバー エラー ステータス コードを送信する <xref:System.ServiceModel.Channels.ReceiveContext> オブジェクトで <xref:System.ServiceModel.Channels.ReceiveContext> の `Abandon` メソッドを呼び出すことによって示されます。  
+  
+ この例では、クライアントは従業員 ID を送信して処理情報を要求します。サービス側では、受信した従業員 ID が 50 を超える場合は、HTTP ステータス コード 500 \(内部サーバー エラー\) をクライアントに送信します。それ以外の場合は、処理を正常に実行できると想定し、HTTP ステータス コード 200 \(成功\) をクライアントに送信します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を管理者権限で開きます。  
+  
+2.  **HttpAckChannel** ソリューションを開きます。  
+  
+3.  **ソリューション エクスプローラー**で **Service** プロジェクトを右クリックしてプロジェクトの新しいインスタンスを開始し、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **Client** プロジェクトを右クリックしてプロジェクトの新しいインスタンスを開始し、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックします。  
+  
+5.  サービスが開始されたら、クライアント ウィンドウで Enter キーを押して、クライアントからサービスにメッセージを送信します。  
+  
+6.  最初のメッセージがサービスで処理され、サービスからクライアントに HTTP OK ステータス コードが送信されます。  
+  
+7.  2 番目のメッセージは失敗し、サービスからクライアントに HTTP 内部サーバー エラー ステータス コードが送信されます。これにより、<xref:System.ServiceModel.CommunicationException> がクライアントで発生します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\HttpAckChannel`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/httpcookiesession.md b/docs/framework/wcf/samples/httpcookiesession.md
new file mode 100644
index 00000000000..8f34dd0bb36
--- /dev/null
+++ b/docs/framework/wcf/samples/httpcookiesession.md
@@ -0,0 +1,181 @@
+---
+title: "HttpCookieSession | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 101cb624-8303-448a-a3af-933247c1e109
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# HttpCookieSession
+このサンプルでは、カスタム プロトコル チャネルを作成し、セッション管理用の HTTP クッキーを使用する方法を示します。このチャネルは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスと ASMX クライアント間の通信、または [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと ASMX サービス間の通信を有効にします。  
+  
+ クライアントがセッション ベースの ASMX Web サービス内で Web メソッドを呼び出すと、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] エンジンは次の処理を行います。  
+  
+-   一意の ID \(セッション ID\) を生成します。  
+  
+-   セッション オブジェクトを生成し、一意の ID に関連付けます。  
+  
+-   一意の IDを Set\-Cookie HTTP 応答ヘッダーに追加し、クライアントに送信します。  
+  
+-   送信されるセッション ID に基づき、以降の呼び出しでクライアントを識別します。  
+  
+ クライアントは、サーバーに対する以降の要求にこのセッション ID を含めます。サーバーはクライアントのセッション ID を使用して、現在の HTTP コンテキストに適切なセッション オブジェクトを読み込みます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\HttpCookieSession`  
+  
+## HttpCookieSession チャネルのメッセージ交換パターン  
+ このサンプルでは、ASMX などのシナリオのセッションを有効にします。チャネル スタックの一番下には、<xref:System.ServiceModel.Channels.IRequestChannel> と <xref:System.ServiceModel.Channels.IReplyChannel> をサポートする HTTP トランスポートがあります。これはチャネルのジョブで、より高いレベルのチャネル スタックにセッションを提供します。このサンプルでは、セッションをサポートする 2 つのチャネル \(<xref:System.ServiceModel.Channels.IRequestSessionChannel> および <xref:System.ServiceModel.Channels.IReplySessionChannel>\) を実装します。  
+  
+## サービス チャネル  
+ このサンプルでは、`HttpCookieReplySessionChannelListener` クラスでサービス チャネルを提供します。このクラスは <xref:System.ServiceModel.Channels.IChannelListener> インターフェイスを実装し、チャネル スタックの低いレベルにある <xref:System.ServiceModel.Channels.IReplyChannel> チャネルを <xref:System.ServiceModel.Channels.IReplySessionChannel> に変換します。このプロセスは、次の部分に分かれています。  
+  
+-   チャネル リスナが開かれると、チャネル リスナは内部リスナの内部チャネルを受け入れます。内部リスナはデータグラム リスナであり、受け入れられたチャネルの有効期間は内部リスナの有効期間から切り離されるため、次のように、内部リスナを閉じて内部チャネルの保持のみを行うことができます。  
+  
+    ```  
+                this.innerChannelListener.Open(timeoutHelper.RemainingTime());  
+    this.innerChannel = this.innerChannelListener.AcceptChannel(timeoutHelper.RemainingTime());  
+    this.innerChannel.Open(timeoutHelper.RemainingTime());  
+    this.innerChannelListener.Close(timeoutHelper.RemainingTime());  
+    ```  
+  
+-   チャネル リスナを開くプロセスが完了したら、次のようにメッセージ ループをセットアップし、内部チャネルからメッセージを受信します。  
+  
+    ```  
+    IAsyncResult result = BeginInnerReceiveRequest();  
+    if (result != null && result.CompletedSynchronously)  
+    {  
+       // do not block the user thread  
+       if (this.completeReceiveCallback == null)  
+       {  
+          this.completeReceiveCallback = new WaitCallback(CompleteReceiveCallback);  
+       }  
+       ThreadPool.QueueUserWorkItem(this.completeReceiveCallback, result);  
+    }  
+    ```  
+  
+-   メッセージが到着したら、サービス チャネルはセッション識別子を調べ、非多重化を行って適切なセッション チャネルに変換します。このチャネル リスナは、セッション識別子をセッション チャネル インスタンスにマップするディクショナリを保持します。  
+  
+    ```  
+    Dictionary<string, IReplySessionChannel> channelMapping;  
+    ```  
+  
+ `HttpCookieReplySessionChannel` クラスは、<xref:System.ServiceModel.Channels.IReplySessionChannel> を実装しています。より高いレベルのチャネル スタックは <xref:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest%2A> メソッドを呼び出し、このセッションの要求を読み込みます。各セッション チャネルにはプライベート メッセージ キューがあり、サービス チャネルによって設定されます。  
+  
+```  
+InputQueue<RequestContext> requestQueue;  
+```  
+  
+ ユーザーが <xref:System.ServiceModel.Channels.IReplyChannel.ReceiveRequest%2A> メソッドを呼び出したときに、このメッセージ キューにメッセージがない場合は、チャネルは指定された時間分待機した後にシャットダウンします。これにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のクライアント用に作成されたセッション チャネルがクリーンアップされます。  
+  
+ `channelMapping` を使用して `ReplySessionChannels` を追跡します。受け入れられたすべてのチャネルが閉じられた後で、基になる `innerChannel` を閉じます。この方法により、`HttpCookieReplySessionChannel` は `HttpCookieReplySessionChannelListener` の有効期間を過ぎても存在できます。また、リスナのガベージ コレクトは気にする必要はありません。受け入れられたチャネルは、`OnClosed` コールバックを介してそのチャネルのリスナへの参照を保持するためです。  
+  
+## クライアント チャネル  
+ 対応するクライアント チャネルは、`HttpCookieSessionChannelFactory` クラスにあります。チャネルの作成中、チャネル ファクトリは内部要求チャネルを `HttpCookieRequestSessionChannel` でラップします。`HttpCookieRequestSessionChannel` クラスは、基になる要求チャネルへの呼び出しを転送します。クライアントがプロキシを閉じると、`HttpCookieRequestSessionChannel` はチャネルが閉じられようとしていることを示すメッセージをサービスに送信します。そのため、サービス チャネル スタックは、使用中のセッション チャネルを正常にシャットダウンできます。  
+  
+## バインディングとバインディング要素  
+ サービス チャネルおよびクライアント チャネルを作成した後の次の手順は、それらのチャネルを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムに統合することです。チャネルは、バインディングとバインディング要素を介して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に公開されます。バインディングは、1 つまたは複数のバインディング要素で構成されています。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、いくつかのシステム定義バインディングが用意されています。たとえば、BasicHttpBinding や WSHttpBinding などがあります。`HttpCookieSessionBindingElement` クラスには、バインディング要素の実装が含まれています。この実装によってチャネル リスナとチャネル ファクトリの作成メソッドがオーバーライドされ、必要なチャネル リスナまたはチャネル ファクトリがインスタンス化されます。  
+  
+ このサンプルでは、サービスの説明のポリシー アサーションを使用します。これにより、サンプルのチャネルの要件を、そのサービスを利用できる他のクライアントに公開できます。たとえば、このバインディング要素はポリシー アサーションを公開し、セッションがサポートされていることを潜在的なクライアントに通知します。このサンプルでは、バインディング要素の構成で `ExchangeTerminateMessage` プロパティが有効になっています。そのため、サービスで余分なメッセージ交換アクションがサポートされ、セッションでのメッセージ交換が終了されることを示すために必要なアサーションが追加されます。その後、クライアントはこのアクションを使用できます。`HttpCookieSessionBindingElement` から作成されたポリシー アサーションを、次の WSDL コードに示します。  
+  
+```  
+<wsp:Policy wsu:Id="HttpCookieSessionBinding_IWcfCookieSessionService_policy" xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">  
+<wsp:ExactlyOne>  
+<wsp:All>  
+<wspe:Utf816FFFECharacterEncoding xmlns:wspe="http://schemas.xmlsoap.org/ws/2004/09/policy/encoding"/>  
+<mhsc:httpSessionCookie xmlns:mhsc="http://samples.microsoft.com/wcf/mhsc/policy"/>  
+</wsp:All>  
+</wsp:ExactlyOne>  
+</wsp:Policy>  
+```  
+  
+ `HttpCookieSessionBinding` クラスは、システム指定のバインディング要素を使用する定義済みバインディングです。  
+  
+## 構成システムへのチャネルの追加  
+ このサンプルでは、構成を使用してサンプル チャネルを公開する 2 つのクラスを提供します。1 つ目のクラスは、`HttpCookieSessionBindingElement` の <xref:System.ServiceModel.Configuration.BindingElementExtensionElement> です。実装の大部分は `HttpCookieSessionBindingConfigurationElement` で代行されます。これは <xref:System.ServiceModel.Configuration.StandardBindingElement> の派生です。`HttpCookieSessionBindingConfigurationElement` には、`HttpCookieSessionBindingElement` のプロパティに対応するプロパティがあります。  
+  
+### 要素拡張セクションのバインディング  
+ セクション `HttpCookieSessionBindingElementSection` は <xref:System.ServiceModel.Configuration.BindingElementExtensionElement> で、`HttpCookieSessionBindingElement` を構成システムに公開します。構成セクション名をいくつかオーバーライドして、バインディング要素の種類とバインディング要素の作成方法が定義されます。その後、次のようにして拡張セクションを構成ファイルに登録できます。  
+  
+```  
+<configuration>        
+    <system.serviceModel>        
+      <extensions>          
+        <bindingElementExtensions>            
+          <add name="httpCookieSession"   
+               type=  
+"Microsoft.ServiceModel.Samples.HttpCookieSessionBindingElementElement,   
+                    HttpCookieSessionExtension, Version=1.0.0.0,   
+                    Culture=neutral, PublicKeyToken=null"/>  
+        </bindingElementExtensions >  
+      </extensions>  
+  
+      <bindings>  
+      <customBinding>  
+        <binding name="allowCookiesBinding">  
+          <textMessageEncoding messageVersion="Soap11WSAddressing10" />  
+          <httpCookieSession sessionTimeout="10" exchangeTerminateMessage="true" />  
+          <httpTransport allowCookies="true" />  
+        </binding>  
+      </customBinding>  
+      </bindings>        
+    </system.serviceModel>    
+</configuration>  
+```  
+  
+## テスト コード  
+ このサンプルのトランスポートを使用するテスト コードは、クライアント ディレクトリとサービス ディレクトリで使用できます。テスト コードは 2 つのテストで構成されます。1 つ目のテストは、`allowCookies` がクライアントで `true` に設定されているバインディングを使用します。2 つ目のテストは、バインディングで明示的なシャットダウン \(メッセージ交換の終了\) を有効にします。  
+  
+ このサンプルを実行すると、次の出力が表示されます。  
+  
+```  
+Simple binding:  
+AddItem(10000,2): ItemCount=2  
+AddItem(10550,5): ItemCount=7  
+RemoveItem(10550,2): ItemCount=5  
+Items  
+10000, 2  
+10550, 3  
+Smart binding:  
+AddItem(10000,2): ItemCount=2  
+AddItem(10550,5): ItemCount=7  
+RemoveItem(10550,2): ItemCount=5  
+Items  
+10000, 2  
+10550, 3  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/iis-hosting-using-inline-code.md b/docs/framework/wcf/samples/iis-hosting-using-inline-code.md
new file mode 100644
index 00000000000..c4b089ea726
--- /dev/null
+++ b/docs/framework/wcf/samples/iis-hosting-using-inline-code.md
@@ -0,0 +1,108 @@
+---
+title: "インライン コードを使用した IIS ホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "インライン コードを使用した IIS ホスティング サンプル [Windows Communication Foundation]"
+  - "Web ホスト サービス"
+ms.assetid: 56fe3687-a34b-4661-8e30-b33770f413fa
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# インライン コードを使用した IIS ホスティング
+このサンプルでは、インターネット インフォメーション サービス \(IIS\) によってホストされるサービスを実装する方法を示します。サービス コードは .svc ファイルにインラインで含まれており、必要に応じてコンパイルされます。サービス コードは、アプリケーションの \\App\_Code ディレクトリにあるソース コード ファイルに直接実装するか、または \\bin に配置されるアセンブリにコンパイルすることもできます。ただし、このサンプルではこれらの手法は示しません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WebHost\InlineCode`  
+  
+ このサンプルでは、要求\/応答通信パターンを定義するコントラクトを実装する一般的なサービスを示します。このサービスは IIS によってホストされ、サービス コードは Service.svc ファイルに完全に含まれています。サービスはホストによってアクティブ化され、このサービスに最初に送信されるメッセージによって必要に応じてコンパイルされます。あらかじめコンパイルしておく必要はありません。サービスは、次に示すコードで定義される `ICalculator` コントラクトを実装します。  
+  
+```  
+// Define a service contract.  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+    public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+ このサービス実装は、計算を行い、結果を返します。  
+  
+```  
+<%@ServiceHost language=c# Debug="true" Service="Microsoft.ServiceModel.Samples.CalculatorService" %>   
+…  
+// Service class that implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    public double Add(double n1, double n2)  
+    {  
+        return n1 + n2;  
+    }  
+    public double Subtract(double n1, double n2)  
+    {  
+        return n1 - n2;  
+    }  
+    public double Multiply(double n1, double n2)  
+    {  
+        return n1 * n2;  
+    }  
+    public double Divide(double n1, double n2)  
+    {  
+        return n1 / n2;  
+    }  
+}  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  ソリューションがビルドされたら、setup.bat を実行し、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] で ServiceModelSamples アプリケーションを設定します。ServiceModelSamples ディレクトリは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] アプリケーションとして表示されます。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。このサービスを呼び出すことができるクライアント アプリケーションを作成する方法の例については、「[方法 : クライアントを作成する](../../../../docs/framework/wcf/how-to-create-a-wcf-client.md)」を参照してください。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md b/docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md
new file mode 100644
index 00000000000..0f8ef9264a3
--- /dev/null
+++ b/docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md
@@ -0,0 +1,88 @@
+---
+title: "インターネット インフォメーション サービス (IIS) サーバー証明書インストール手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11281490-d2ac-4324-8f33-e7714611a34b
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# インターネット インフォメーション サービス (IIS) サーバー証明書インストール手順
+インターネット インフォメーション サービス \(IIS\) と安全に通信するこのサンプルを実行するには、サーバー証明書を作成してインストールする必要があります。  
+  
+## 手順 1.証明書の作成  
+ 使用しているコンピューター用の証明書を作成するには、管理特権を使用して Visual Studio コマンド プロンプトを開き、Setup.bat を実行します。Setup.bat は IIS と安全に通信する各サンプルに含まれています。このバッチ ファイルを実行する前に、Makecert.exe を含むフォルダがパスに含まれていることを確認します。Setup.bat で証明書の作成に使用されるコマンドは、次のとおりです。  
+  
+```  
+makecert -sr LocalMachine -ss My -n CN=ServiceModelSamples-HTTPS-Server -sky exchange -sk ServiceModelSamples-HTTPS-Key  
+```  
+  
+## 手順 2.証明書のインストール  
+ 先ほど作成した証明書をインストールするために必要な手順は、使用している IIS のバージョンによって異なります。  
+  
+#### IIS 5.1 \(Windows XP\) および IIS 6.0 \(Windows Server 2003\) に証明書をインストールするには  
+  
+1.  インターネット インフォメーション サービス マネージャ MMC スナップインを開きます。  
+  
+2.  \[既定の Web サイト\] を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+3.  **\[ディレクトリ セキュリティ\]** タブをクリックします。  
+  
+4.  **\[サーバー証明書\]** ボタンをクリックします。Web サーバー証明書ウィザードが起動します。  
+  
+5.  ウィザードの指示に従います。証明書を割り当てるオプションを選択します。表示される証明書の一覧から ServiceModelSamples\-HTTPS\-Server 証明書を選択します。  
+  
+     ![IIS 証明書ウィザード](../../../../docs/framework/wcf/samples/media/iiscertificate-wizard.GIF "IISCertificate\_Wizard")  
+  
+6.  サービスへのアクセスをテストします。ブラウザに HTTPS アドレス「https:\/\/localhost\/servicemodelsamples\/service.svc」を入力します。  
+  
+#### Httpcfg.exe であらかじめ SSL が構成されている場合  
+  
+1.  Makecert.exe を使用 \(または Setup.bat を実行\) して、サーバー証明書を作成します。  
+  
+2.  IIS マネージャを実行し、前の手順に従って証明書をインストールします。  
+  
+3.  クライアント プログラムに次のコード行を追加します。  
+  
+> [!IMPORTANT]
+>  このコードが必要になるのは、Makecert.exe によって作成された証明書などをテストする場合のみです。製品版のコードには、お勧めしません。  
+  
+```  
+PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");  
+```  
+  
+#### IIS 7.0 \(Windows Vista および Windows Server 2008\) に証明書をインストールするには  
+  
+1.  **\[スタート\]** メニューの **\[ファイル名を指定して実行\]** をクリックし、「**inetmgr**」と入力してインターネット インフォメーション サービス \(IIS\) MMC スナップインを開きます。  
+  
+2.  **\[既定の Web サイト\]** を右クリックし、**\[バインディングの編集...\]** をクリックします。  
+  
+3.  **\[Web サイト バインド\]** ダイアログ ボックスで、**\[追加\]** をクリックします。  
+  
+4.  **\[種類\]** ボックスの一覧から **\[HTTPS\]** を選択します。  
+  
+5.  **\[SSL 証明書\]** ボックスの一覧から **\[ServiceModelSamples\-HTTPS\-Server\]** を選択して、**\[OK\]** をクリックします。  
+  
+6.  サービスへのアクセスをテストします。ブラウザに HTTPS アドレス「https:\/\/localhost\/servicemodelsamples\/service.svc」を入力します。  
+  
+> [!NOTE]
+>  先ほどインストールしたテスト証明書は信頼された証明書ではないので、この証明書でセキュリティ保護されたローカル Web アドレスを参照した場合、Internet Explorer のセキュリティ警告がさらに発生する場合があります。  
+  
+## 証明書の削除  
+  
+-   前に説明したようにインターネット インフォメーション サービス マネージャーを使用しますが、証明書またはバインディングを追加するのではなく削除します。  
+  
+-   次のコマンドを使用して、コンピューターの証明書を削除します。  
+  
+    ```  
+    httpcfg delete ssl -i 0.0.0.0:443  
+    ```
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/imperative.md b/docs/framework/wcf/samples/imperative.md
new file mode 100644
index 00000000000..25c3131fa30
--- /dev/null
+++ b/docs/framework/wcf/samples/imperative.md
@@ -0,0 +1,107 @@
+---
+title: "強制 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4f7ce807-c0e4-407a-92a6-22abafb40b51
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 強制
+このサンプルでは、コードを使用するサービスについて、構成で `wsHttpBinding` バインディングを定義する代わりに <xref:System.ServiceModel.WsHttpBinding> を定義する方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 次のコードは、バインディングをコードで強制的に定義する方法を示します。  
+  
+```  
+public static void Main()  
+{  
+    WSHttpBinding binding = new WSHttpBinding();  
+    binding.Name = "binding1";  
+    binding.HostNameComparisonMode =  
+        HostNameComparisonMode.StrongWildcard;  
+    binding.Security.Mode = SecurityMode.Message;  
+    binding.ReliableSession.Enabled = false;  
+    binding.TransactionFlow = false;  
+  
+    Uri baseAddress =   
+        new Uri("http://localhost:8000/servicemodelsamples/service");  
+  
+    // Create a ServiceHost for the CalculatorService type and provide the base address.  
+    using(ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))  
+    {  
+        serviceHost.AddServiceEndpoint(typeof(ICalculator),   
+                                       binding, baseAddress);  
+        // Open the ServiceHostBase to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+        // Close the ServiceHostBase to shutdown the service.  
+        serviceHost.Close();                        
+    }             
+}  
+  
+```  
+  
+ クライアントは、チャネルを作成してサービスと通信します。次のサンプル コードを参照してください。  
+  
+```  
+WSHttpBinding binding = new WSHttpBinding();  
+binding.Name = "binding1";  
+binding.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;  
+binding.Security.Mode = SecurityMode.Message;  
+binding.ReliableSession.Enabled = false;  
+binding.TransactionFlow = false;  
+  
+String url = "http://localhost:8000/servicemodelsamples/service";  
+EndpointAddress address = new EndpointAddress(url);  
+ChannelFactory<ICalculator> channelFactory = new ChannelFactory<ICalculator>(binding,address);  
+ICalculator channel = channelFactory.CreateChannel();  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Imperative`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/impersonating-the-client.md b/docs/framework/wcf/samples/impersonating-the-client.md
new file mode 100644
index 00000000000..52f3dbc0b5e
--- /dev/null
+++ b/docs/framework/wcf/samples/impersonating-the-client.md
@@ -0,0 +1,137 @@
+---
+title: "クライアントの偽装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアントの偽装のサンプル [Windows Communication Foundation]"
+  - "偽装, Windows Communication Foundation サンプル"
+  - "サービスの動作, 偽装のサンプル"
+ms.assetid: 8bd974e1-90db-4152-95a3-1d4b1a7734f8
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# クライアントの偽装
+偽装のサンプルでは、サービスで呼び出し元のアプリケーションを偽装し、サービスが呼び出し元の代わりにシステム リソースにアクセスできるようにする方法を示します。  
+  
+ このサンプルは、「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」のサンプルに基づいています。サービスとクライアントの構成ファイルは、「[自己ホスト](../../../../docs/framework/wcf/samples/self-host.md)」サンプルの構成ファイルと同じです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス コードは、サービスの `Add` メソッドが <xref:System.ServiceModel.OperationBehaviorAttribute> を使用して呼び出し元を偽装するように変更されています。次のサンプル コードを参照してください。  
+  
+```  
+[OperationBehavior(Impersonation = ImpersonationOption.Required)]  
+public double Add(double n1, double n2)  
+{  
+    double result = n1 + n2;  
+    Console.WriteLine("Received Add({0},{1})", n1, n2);  
+    Console.WriteLine("Return: {0}", result);  
+    DisplayIdentityInformation();  
+    return result;  
+}  
+  
+```  
+  
+ この結果、実行中のスレッドのセキュリティ コンテキストは呼び出し元を偽装するように切り替えられ、その後 `Add` メソッドが入力されて、このメソッドが終了すると元に戻ります。  
+  
+ 次のサンプル コードに示す `DisplayIdentityInformation` メソッドは、呼び出し元の ID を表示するユーティリティ関数です。  
+  
+```  
+static void DisplayIdentityInformation()  
+{  
+    Console.WriteLine("\t\tThread Identity            :{0}",  
+         WindowsIdentity.GetCurrent().Name);  
+    Console.WriteLine("\t\tThread Identity level  :{0}",   
+         WindowsIdentity.GetCurrent().ImpersonationLevel);  
+    Console.WriteLine("\t\thToken                     :{0}",  
+         WindowsIdentity.GetCurrent().Token.ToString());  
+    return;  
+}  
+  
+```  
+  
+ サービスの `Subtract` メソッドは、強制呼び出しを使用して呼び出し元を偽装します。次のサンプル コードを参照してください。  
+  
+```  
+public double Subtract(double n1, double n2)  
+{  
+    double result = n1 - n2;  
+    Console.WriteLine("Received Subtract({0},{1})", n1, n2);  
+    Console.WriteLine("Return: {0}", result);  
+Console.WriteLine("Before impersonating");  
+DisplayIdentityInformation();  
+  
+    if (ServiceSecurityContext.Current.WindowsIdentity.ImpersonationLevel == TokenImpersonationLevel.Impersonation ||  
+        ServiceSecurityContext.Current.WindowsIdentity.ImpersonationLevel == TokenImpersonationLevel.Delegation)  
+    {  
+        // Impersonate.  
+        using (ServiceSecurityContext.Current.WindowsIdentity.Impersonate())  
+        {  
+            // Make a system call in the caller's context and ACLs   
+            // on the system resource are enforced in the caller's context.   
+            Console.WriteLine("Impersonating the caller imperatively");  
+            DisplayIdentityInformation();  
+        }  
+    }  
+    else  
+    {  
+        Console.WriteLine("ImpersonationLevel is not high enough to perform this operation.");  
+    }  
+  
+Console.WriteLine("After reverting");  
+DisplayIdentityInformation();  
+    return result;  
+}  
+```  
+  
+ この場合、呼び出し元は呼び出し全体に対して偽装されるのではなく、呼び出しの一部に対してのみ偽装されます。通常、操作全体の偽装を行うよりも、最小限の範囲での偽装をお勧めします。  
+  
+ 他のメソッドは呼び出し元を偽装しません。  
+  
+ クライアント コードは、偽装レベルを <xref:System.Security.Principal.TokenImpersonationLevel> に設定するように変更されています。クライアントは <xref:System.Security.Principal.TokenImpersonationLevel> 列挙体を使用して、サービスで使用される偽装レベルを指定します。この列挙体は、<xref:System.Security.Principal.TokenImpersonationLevel>、<xref:System.Security.Principal.TokenImpersonationLevel>、<xref:System.Security.Principal.TokenImpersonationLevel>、<xref:System.Security.Principal.TokenImpersonationLevel>、および <xref:System.Security.Principal.TokenImpersonationLevel> の値をサポートします。Windows ACL を使用して保護されているローカル コンピューターのシステム リソースにアクセスする場合、アクセス チェックを実行するには、偽装レベルを <xref:System.Security.Principal.TokenImpersonationLevel> に設定する必要があります。次のサンプル コードを参照してください。  
+  
+```  
+// Create a client with given client endpoint configuration  
+CalculatorClient client = new CalculatorClient();  
+  
+client.ClientCredentials.Windows.AllowedImpersonationLevel = TokenImpersonationLevel.Impersonation;  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+> [!NOTE]
+>  サービスを管理アカウントで実行するか、またはサービスを実行するアカウントに http:\/\/localhost:8000\/ServiceModelSamples の URI を HTTP レイヤーに登録する権限を付与する必要があります。このような権限を付与するには、[Httpcfg.exe ツール](http://go.microsoft.com/fwlink/?LinkId=95010)を使用して[名前空間予約](http://go.microsoft.com/fwlink/?LinkId=95012)を設定します。  
+  
+> [!NOTE]
+>  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] を実行しているコンピューターでは、Host.exe アプリケーションに偽装特権がある場合にのみ偽装がサポートされます \(既定では、管理者のみがこれを許可できます\)。この特権をサービスが実行されているアカウントに追加するには、**\[管理ツール\]** の **\[ローカル セキュリティ ポリシー\]** を開き、**\[ローカル ポリシー\]** を開きます。次に、**\[ユーザー権利の割り当て\]** をクリックして **\[認証後にクライアントを偽装\]** をクリックし、ユーザーまたはグループを追加する **\[プロパティ\]** をダブルクリックします。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+4.  サービスが呼び出し元を偽装していることを示すため、サービスが実行されているアカウントとは異なるアカウントでクライアントを実行します。これを行うには、コマンド プロンプトに次のコマンドを入力します。  
+  
+    ```  
+    runas /user:<machine-name>\<user-name> client.exe  
+    ```  
+  
+     次に、パスワードの入力が求められます。先ほど指定したアカウントのパスワードを入力します。  
+  
+5.  クライアントを実行する際、クライアントを実行する前と後で ID の資格情報が異なることに注意してください。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/index.md b/docs/framework/wcf/samples/index.md
new file mode 100644
index 00000000000..d9475d55cbc
--- /dev/null
+++ b/docs/framework/wcf/samples/index.md
@@ -0,0 +1,38 @@
+---
+title: "Windows Communication Foundation (WCF) サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89d4efce-7832-4dd5-82a8-0e574b3302f9
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# Windows Communication Foundation (WCF) サンプル
+これらのサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のさまざまな特性について説明します。  
+  
+-   C# バージョンのサンプルについてを参照してください[Windows Communication Foundation (WCF) および .NET Framework 4 向けの Windows Workflow Foundation (WF) サンプル](http://go.microsoft.com/fwlink/?LinkId=150780)します。  
+  
+-   Visual Basic バージョンのサンプルを参照してください[Visual Basic 2010 サンプル](http://go.microsoft.com/fwlink/?LinkID=193373) をクリック**WF HYPERLINK"javascript:__doPostBack('ctl00$ctl00$Content$TabContentPanel$Content$ReleaseFiles$FileList$ctl02$FileNameLink','')"_WCF_Samples.zip**します。  
+  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] [アプリケーション](../../../../docs/framework/windows-workflow-foundation/samples/application.md)もサンプルではいくつか[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]機能します。  
+  
+ ドキュメントとヘルプ ビューアーのスタンドアロン バージョンをインストールするには、ダウンロード、 [Microsoft Windows SDK v 7.1](http://go.microsoft.com/fwlink/?LinkID=194146)します。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [基本的な](../../../../docs/framework/wcf/samples/basic.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の基本的な機能を示すサンプルを紹介します。  
+  
+ 機能拡張  
+ 探索機能関連のサンプルを紹介します。  
+  
+ [シナリオ](../../../../docs/framework/wcf/samples/scenario.md)  
+ WCF シナリオを例を使用して説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/installing-message-queuing-msmq.md b/docs/framework/wcf/samples/installing-message-queuing-msmq.md
new file mode 100644
index 00000000000..fa14cc3d21e
--- /dev/null
+++ b/docs/framework/wcf/samples/installing-message-queuing-msmq.md
@@ -0,0 +1,73 @@
+---
+title: "メッセージ キュー (MSMQ) のインストール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7ddcd497-3e04-427e-bc04-3610ad98b01e
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# メッセージ キュー (MSMQ) のインストール
+メッセージ キュー 4.0 およびメッセージ キュー 3.0 をインストールする方法を次の手順に示します。  
+  
+> [!NOTE]
+>  メッセージ キュー 4.0 は、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] および [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では使用できません。  
+  
+#### Windows Server 2008 または Windows Server 2008 R2 にメッセージ キュー 4.0 をインストールするには  
+  
+1.  サーバー マネージャーで **\[機能\]** をクリックします。  
+  
+2.  **\[機能の概要\]** の右側のペインで、**\[機能の追加\]** をクリックします。  
+  
+3.  表示されたウィンドウで **\[メッセージ キュー\]** を展開します。  
+  
+4.  **\[メッセージ キュー サービス\]** を展開します。  
+  
+5.  **\[ディレクトリ サービス統合\]** を \(ドメインに参加するコンピューターの場合\) クリックし、**\[HTTP サポート\]** をクリックします。  
+  
+6.  **\[次へ\]** をクリックし、**\[インストール\]** をクリックします。  
+  
+#### Windows 7 または Windows Vista にメッセージ キュー 4.0 をインストールするには  
+  
+1.  **コントロール パネル**を開きます。  
+  
+2.  **\[プログラム\]** をクリックし、**\[プログラムと機能\]** の **\[Windows の機能の有効化または無効化\]** をクリックします。  
+  
+3.  \[Microsoft Message Queue \(MSMQ\) Server\]、\[Microsoft Message Queue \(MSMQ\) Server Core\] の順に展開して、インストールする次のメッセージ キュー機能のチェック ボックスをオンにします。  
+  
+    -   \[MSMQ Active Directory Domain Services Integration\] \(ドメインに参加するコンピューターの場合\)  
+  
+    -   \[MSMQ HTTP サポート\]  
+  
+4.  **\[OK\]** をクリックします。  
+  
+5.  コンピューターを再起動するかどうかを確認するメッセージが表示されたら、**\[OK\]** をクリックしてインストールを完了します。  
+  
+#### Windows XP および Windows Server 2003 にメッセージ キュー 3.0 をインストールするには  
+  
+1.  **コントロール パネル**を開きます。  
+  
+2.  **\[プログラムの追加と削除\]**、**\[Windows コンポーネントの追加と削除\]** の順にクリックします。  
+  
+3.  メッセージ キューを選択し、**\[詳細\]** をクリックします。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] を実行している場合は、メッセージ キューにアクセスするアプリケーション サーバーを選択します。  
+  
+4.  詳細ページで、\[MSMQ HTTP サポート\] オプションが選択されていることを確認します。  
+  
+5.  **\[OK\]** をクリックして詳細ページを閉じ、**\[次へ\]** をクリックします。インストールを完了します。  
+  
+6.  コンピューターを再起動するかどうかを確認するメッセージが表示されたら、**\[OK\]** をクリックしてインストールを完了します。  
+  
+## 参照  
+ [セットアップ手順](../../../../docs/framework/wcf/samples/set-up-instructions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/instancing-extensibility.md b/docs/framework/wcf/samples/instancing-extensibility.md
new file mode 100644
index 00000000000..67fc708a8d4
--- /dev/null
+++ b/docs/framework/wcf/samples/instancing-extensibility.md
@@ -0,0 +1,33 @@
+---
+title: "インスタンス化拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a2f8b51-472b-4b71-8602-d3dbc6e1cb07
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# インスタンス化拡張
+このセクションには、カスタムのインスタンス化を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [永続性インスタンス コンテキスト](../../../../docs/framework/wcf/samples/durable-instance-context.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ランタイムをカスタマイズして、永続性インスタンス コンテキストを有効にする方法を示します。  
+  
+ [カスタム有効期間](../../../../docs/framework/wcf/samples/custom-lifetime.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の共有サービス インスタンスにカスタムの有効期間サービスを提供する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張機能の作成方法を示します。  
+  
+ [初期化のインスタンス化](../../../../docs/framework/wcf/samples/instancing-initialization.md)  
+ オブジェクトの初期化をカスタマイズする方法を示します。  
+  
+ [プール](../../../../docs/framework/wcf/samples/pooling.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を拡張してオブジェクト プールをサポートする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/instancing-initialization.md b/docs/framework/wcf/samples/instancing-initialization.md
new file mode 100644
index 00000000000..44228a74196
--- /dev/null
+++ b/docs/framework/wcf/samples/instancing-initialization.md
@@ -0,0 +1,280 @@
+---
+title: "初期化のインスタンス化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 154d049f-2140-4696-b494-c7e53f6775ef
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# 初期化のインスタンス化
+このサンプルでは、インターフェイス `IObjectControl` を定義して、「[プール](../../../../docs/framework/wcf/samples/pooling.md)」サンプルを拡張します。このインターフェイスでは、オブジェクトのアクティブ化\/非アクティブ化を切り替えることによって、そのオブジェクトの初期化をカスタマイズできます。クライアントは、オブジェクトをプールに返すメソッドや、プールに返さないメソッドを呼び出します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## 拡張ポイント  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 拡張機能作成の最初の手順は、使用する機能拡張ポイントの決定です。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での用語 *EndpointDispatcher* は、受信メッセージをユーザーのサービス上のメソッド呼び出しに変換したり、メソッドからの戻り値を送信メッセージに変換する実行時コンポーネントを表します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、各エンドポイントの EndpointDispatcher を作成します。  
+  
+ EndpointDispatcher は <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> クラスを使用して、\(サービスによって送受信されるすべてのメッセージの\) エンドポイント スコープ拡張を提供します。このクラスにより、EndpointDispatcher の動作を制御するさまざまなプロパティをカスタマイズできます。このサンプルでは、サービス クラスのインスタンスを提供するオブジェクトをポイントする <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> プロパティに焦点を当てています。  
+  
+## IInstanceProvider  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、EndpointDispatcher は <xref:System.ServiceModel.Dispatcher.IInstanceProvider> インターフェイスを実装しているインスタンス プロバイダを使用して、サービス クラスのインスタンスを作成します。このインターフェイスに含まれるメソッドは、次の 2 つのみです。  
+  
+-   <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%2A>: メッセージが到着すると、このディスパッチャは <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%2A> メソッドを呼び出し、メッセージを処理するためのサービス クラスのインスタンスを作成します。このメソッドの呼び出し頻度は <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティで決まります。たとえば <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティが <xref:System.ServiceModel.InstanceContextMode?displayProperty=fullName> に設定されている場合、サービス クラスの新しいインスタンスが作成され、到着する各メッセージが処理されます。したがって、<xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%2A> はメッセージが到着するたびに呼び出されます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.IInstanceProvider.ReleaseInstance%2A>: サービス インスタンスがメッセージの処理を完了すると、EndpointDispatcher は <xref:System.ServiceModel.Dispatcher.IInstanceProvider.ReleaseInstance%2A> メソッドを呼び出します。<xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%2A> メソッドと同様、このメソッドへの呼び出し頻度は <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティで決まります。  
+  
+## オブジェクト プール  
+ `ObjectPoolInstanceProvider` クラスには、オブジェクト プールの実装が含まれています。このクラスは、サービス モデルのレイヤと対話する <xref:System.ServiceModel.Dispatcher.IInstanceProvider> インターフェイスを実装しています。EndpointDispatcher が、新しいインスタンスを作成する代わりに <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%2A> メソッドを呼び出すと、カスタム実装はメモリ内プールで既存のオブジェクトを検索します。検索されたオブジェクトが使用可能な場合は、そのオブジェクトが返されます。使用可能なオブジェクトがない場合、`ObjectPoolInstanceProvider` は `ActiveObjectsCount` プロパティ \(プールから返されるオブジェクト数\) が最大プール サイズに達しているかどうかをチェックします。最大サイズに達していない場合は、新しいインスタンスが作成されて呼び出し元に返され、その後 `ActiveObjectsCount` がインクリメントされます。最大サイズに達していると、構成期間中、オブジェクト作成要求がキューに置かれます。`GetObjectFromThePool` の実装を次のサンプル コードに示します。  
+  
+```  
+  
+private object GetObjectFromThePool()  
+{  
+    bool didNotTimeout =   
+       availableCount.WaitOne(creationTimeout, true);  
+    if(didNotTimeout)  
+    {  
+         object obj = null;  
+         lock (poolLock)  
+        {  
+             if (pool.Count != 0)  
+             {  
+                   obj = pool.Pop();  
+                   activeObjectsCount++;  
+             }  
+             else if (pool.Count == 0)  
+             {  
+                   if (activeObjectsCount < maxPoolSize)  
+                   {  
+                        obj = CreateNewPoolObject();  
+                        activeObjectsCount++;  
+  
+                        #if (DEBUG)  
+                        WritePoolMessage(  
+                             ResourceHelper.GetString("MsgNewObject"));  
+                       #endif  
+                   }                          
+            }  
+           idleTimer.Stop();  
+      }  
+     // Call the Activate method if possible.  
+    if (obj is IObjectControl)  
+   {  
+         ((IObjectControl)obj).Activate();  
+   }  
+   return obj;  
+}  
+throw new TimeoutException(  
+ResourceHelper.GetString("ExObjectCreationTimeout"));  
+}  
+```  
+  
+ カスタム `ReleaseInstance` 実装は、解放されたインスタンスをプールに戻し、`ActiveObjectsCount` 値をデクリメントします。EndpointDispatcher はこれらのメソッドをさまざまなスレッドから呼び出すので、`ObjectPoolInstanceProvider` クラスのクラス レベル メンバへの同期アクセスが必要となります。  
+  
+```  
+public void ReleaseInstance(InstanceContext instanceContext, object instance)  
+{  
+    lock (poolLock)  
+    {  
+        // Check whether the object can be pooled.   
+        // Call the Deactivate method if possible.  
+        if (instance is IObjectControl)  
+        {  
+            IObjectControl objectControl = (IObjectControl)instance;  
+            objectControl.Deactivate();  
+  
+            if (objectControl.CanBePooled)  
+            {  
+                pool.Push(instance);  
+  
+                #if(DEBUG)  
+                WritePoolMessage(  
+                    ResourceHelper.GetString("MsgObjectPooled"));  
+                #endif                          
+            }  
+            else  
+            {  
+                #if(DEBUG)  
+                WritePoolMessage(  
+                    ResourceHelper.GetString("MsgObjectWasNotPooled"));  
+                #endif  
+            }  
+        }  
+        else  
+        {  
+            pool.Push(instance);  
+  
+            #if(DEBUG)  
+            WritePoolMessage(  
+                ResourceHelper.GetString("MsgObjectPooled"));  
+            #endif   
+        }  
+  
+        activeObjectsCount--;  
+  
+        if (activeObjectsCount == 0)  
+        {  
+            idleTimer.Start();                       
+        }  
+    }  
+  
+    availableCount.Release(1);  
+}  
+  
+```  
+  
+ `ReleaseInstance` メソッドには、*初期化のクリーンアップ*機能があります。通常は、プールにはその有効期間中に最小限の数のオブジェクトが保持されます。ただし、使用率が非常に高くなり、プールでオブジェクトを追加作成する必要が生じて、その数が構成に指定されている上限に達する可能性があります。プールが最終的にアクティブでなくなると、そうした過剰なオブジェクトは余分なオーバーヘッドになります。したがって、`activeObjectsCount` がゼロに達すると、アイドル タイマが起動し、クリーンアップ サイクルがトリガされて実行されます。  
+  
+```  
+if (activeObjectsCount == 0)  
+{  
+    idleTimer.Start();   
+}  
+  
+```  
+  
+ ServiceModel のレイヤ拡張は、次の動作を使用してフックされます。  
+  
+-   サービスの動作 : サービス ランタイム全体のカスタマイズを実現します。  
+  
+-   エンドポイントの動作 : EndpointDispatcher を含む、特定のサービス エンドポイントのカスタマイズを実現します。  
+  
+-   コントラクトの動作 : クライアント上またはサービス上で、それぞれ <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスまたは <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスのカスタマイズを実現します。  
+  
+-   操作の動作 : クライアント上またはサービス上のいずれかで、それぞれ <xref:System.ServiceModel.Dispatcher.ClientOperation> クラスまたは <xref:System.ServiceModel.Dispatcher.DispatchOperation> クラスのカスタマイズを実現します。  
+  
+ オブジェクト プール拡張を行うには、エンドポイントの動作またはサービスの動作のどちらかを作成します。この例ではサービスの動作を使用します。この動作では、オブジェクト プール機能がサービスの各エンドポイントに適用されます。サービス動作を作成するには、<xref:System.ServiceModel.Description.IServiceBehavior> インターフェイスを実装します。ServiceModel にカスタム動作を認識させるには、次のようにいくつかの方法があります。  
+  
+-   カスタム属性を使用する。  
+  
+-   カスタム動作をサービス説明の動作コレクションに強制的に追加する。  
+  
+-   構成ファイルを拡張する。  
+  
+ このサンプルではカスタム属性を使用します。<xref:System.ServiceModel.ServiceHost> が構築されると、サービスの種類の定義で使用されている属性が調べられ、使用可能な動作がサービス説明の動作コレクションに追加されます。  
+  
+ <xref:System.ServiceModel.Description.IServiceBehavior> インターフェイスには、<xref:System.ServiceModel.Description.IServiceBehavior.Validate%2A>、<xref:System.ServiceModel.Description.IServiceBehavior.AddBindingParameters%2A>、および <xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A> の 3 つのメソッドがあります。これらのメソッドは、<xref:System.ServiceModel.ServiceHost> の初期化中に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって呼び出されます。最初に、<xref:System.ServiceModel.Description.IServiceBehavior.Validate%2A?displayProperty=fullName> が呼び出されます。このメソッドによってサービスの不整合性を検査できます。次に、<xref:System.ServiceModel.Description.IServiceBehavior.AddBindingParameters%2A?displayProperty=fullName> が呼び出されます。このメソッドは、非常に高度なシナリオでのみ必要です。最後に、<xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A?displayProperty=fullName> が呼び出されます。このメソッドはランタイムを構成します。次のパラメータは、<xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A?displayProperty=fullName> に渡されます。  
+  
+-   `Description` : このパラメータは、サービス全体のサービスの説明を提供します。これを使用すると、サービスのエンドポイント、コントラクト、バインディング、およびサービスに関連するその他のデータに関する説明データを検査できます。  
+  
+-   `ServiceHostBase` : このパラメータは、現在初期化中の <xref:System.ServiceModel.ServiceHostBase> を提供します。  
+  
+ カスタム <xref:System.ServiceModel.Description.IServiceBehavior> 実装では、`ObjectPoolInstanceProvider` の新しいインスタンスがインスタンス化され、<xref:System.ServiceModel.ServiceHostBase> に関連付けられた各 <xref:System.ServiceModel.Dispatcher.EndpointDispatcher> 内の <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> プロパティに割り当てられます。  
+  
+```  
+public void ApplyDispatchBehavior(ServiceDescription description, ServiceHostBase serviceHostBase)  
+{  
+    if (enabled)  
+    {  
+        // Create an instance of the ObjectPoolInstanceProvider.  
+        instanceProvider = new ObjectPoolInstanceProvider(description.ServiceType,  
+        maxPoolSize, minPoolSize, creationTimeout);  
+  
+        // Assign our instance provider to Dispatch behavior in each   
+        // endpoint.  
+        foreach (ChannelDispatcherBase cdb in serviceHostBase.ChannelDispatchers)  
+        {  
+             ChannelDispatcher cd = cdb as ChannelDispatcher;  
+             if (cd != null)  
+             {  
+                 foreach (EndpointDispatcher ed in cd.Endpoints)  
+                 {  
+                        ed.DispatchRuntime.InstanceProvider = instanceProvider;  
+                 }  
+             }  
+         }  
+     }  
+}   
+```  
+  
+ <xref:System.ServiceModel.Description.IServiceBehavior> 実装のほかにも、`ObjectPoolingAttribute` クラスには属性引数を使用してオブジェクト プールをカスタマイズするいくつかのメンバがあります。こうしたメンバには `MaxSize`、`MinSize`、`Enabled`、`CreationTimeout` などがあり、.NET Enterprise Services で提供されるオブジェクト プール機能のセットに一致します。  
+  
+ オブジェクト プールの動作は、新しく作成されたカスタム `ObjectPooling` 属性を使用してサービス実装に注釈を付けることにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに追加できるようになりました。  
+  
+```  
+[ObjectPooling(MaxSize=1024, MinSize=10, CreationTimeout=30000]      
+public class PoolService : IPoolService  
+{  
+  // …  
+}  
+```  
+  
+## アクティブ化と非アクティブ化のフック  
+ オブジェクト プールの主な目的は、比較的負荷のかかる作成および初期化を伴う有効期間の短いオブジェクトを最適化することです。そのため、オブジェクト プールが適切に使用された場合は、アプリケーションのパフォーマンスを大幅に向上させることができます。オブジェクトはプールから返されるので、コンストラクタが呼び出されるのは 1 回だけです。ただし一部のアプリケーションでは、単一のコンテキスト内で使用されるリソースを初期化してクリーンアップできるようにするために、ある一定のレベルの制御が必要になります。たとえば、一連の計算に使用されているオブジェクトは、次の計算を実行する前に、そのオブジェクトのプライベート フィールドをリセットできます。Enterprise Services では、オブジェクト開発者が <xref:System.EnterpriseServices.ServicedComponent> ベース クラスの `Activate` メソッドおよび `Deactivate` メソッドをオーバーライドすることにより、コンテキスト固有のこの種の初期化が実現されます。  
+  
+ オブジェクト プールは、オブジェクトがプールから返される直前に `Activate` メソッドを呼び出します。オブジェクトがプールに返される際には `Deactivate` メソッドが呼び出されます。<xref:System.EnterpriseServices.ServicedComponent> ベース クラスには、`CanBePooled` という `boolean` プロパティもあります。このプロパティを使用すると、オブジェクトをさらにプールできるかどうかをプールに通知できます。  
+  
+ このサンプルではこの機能に似た動作が行われるように、前述のメンバを持つパブリック インターフェイス \(`IObjectControl`\) を宣言しています。このインターフェイスは、コンテキスト固有の初期化を提供するためのサービス クラスによって実装されます。<xref:System.ServiceModel.Dispatcher.IInstanceProvider> の実装は、これらの要件を満たすように変更する必要があります。ここで、`GetInstance` メソッドを呼び出してオブジェクトを取得するたびに、オブジェクトが `IObjectControl` を実装しているかどうかをチェックする必要があります。実装されている場合は、`Activate` メソッドを正しく呼び出す必要があります。  
+  
+```  
+if (obj is IObjectControl)  
+{  
+    ((IObjectControl)obj).Activate();  
+}  
+  
+```  
+  
+ オブジェクトをプールに返すときには、そのオブジェクトをプールに追加し直す前に、`CanBePooled` プロパティのチェックが必要です。  
+  
+```  
+if (instance is IObjectControl)  
+{  
+    IObjectControl objectControl = (IObjectControl)instance;  
+    objectControl.Deactivate();  
+    if (objectControl.CanBePooled)  
+    {  
+       pool.Push(instance);  
+    }  
+}  
+  
+```  
+  
+ オブジェクトをプールできるかどうかはサービス開発者が決定できるので、指定時間におけるプール内のオブジェクト数は、最低サイズ未満になる場合があります。したがって、オブジェクト数が最低レベル未満になっているかどうかをチェックし、クリーンアップ手順において必要な初期化を実行する必要があります。  
+  
+```  
+// Remove the surplus objects.  
+if (pool.Count > minPoolSize)  
+{  
+  // Clean the surplus objects.  
+}                      
+else if (pool.Count < minPoolSize)  
+{  
+  // Reinitialize the missing objects.  
+  while(pool.Count != minPoolSize)  
+  {  
+    pool.Push(CreateNewPoolObject());  
+  }  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Instancing\Initialization`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/instancing.md b/docs/framework/wcf/samples/instancing.md
new file mode 100644
index 00000000000..0232c268cb3
--- /dev/null
+++ b/docs/framework/wcf/samples/instancing.md
@@ -0,0 +1,152 @@
+---
+title: "インスタンス化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "インスタンス化のサンプル [Windows Communication Foundation]"
+  - "サービスの動作, インスタンス化のサンプル"
+ms.assetid: c290fa54-f6ae-45a1-9186-d9504ebc6ee6
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# インスタンス化
+インスタンス化のサンプルでは、インスタンス化動作の設定を示します。この設定は、クライアント要求への応答として作成される、サービス クラスのインスタンスの作成方法を制御します。  このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  このサンプルでは、`ICalculator` から継承される新しいコントラクト `ICalculatorInstance` を定義します。  `ICalculatorInstance` によって指定されるコントラクトにより、サービス インスタンスの状態を検査するための 3 つの操作が追加されます。  インスタンス化設定を変更することにより、クライアントを実行して動作の変更を確認できます。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) であり、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 次のインスタンス化モードを使用できます。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : 新しいサービス インスタンスがクライアント要求ごとに作成されます。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : 新しいインスタンスが新しいクライアント セッションごとに作成され、そのセッションの有効期間中保持されます \(セッションをサポートするバインディングが必要です\)。  
+  
+-   <xref:System.ServiceModel.InstanceContextMode> : アプリケーションの有効期間中、サービス クラスの単一のインスタンスがすべてのクライアント要求を処理します。  
+  
+ サービス クラスは、`[ServiceBehavior(InstanceContextMode=<setting>)]` 属性を使用してインスタンス化動作を指定します。次のサンプル コードを参照してください。  コメント化されている行を変更すると、各インスタンス モードの動作を確認できます。  インスタンス モードを変更したら、サービスを再ビルドする必要があります。  クライアントでは、インスタンス化に関連する設定は行いません。  
+  
+```  
+// Enable one of the following instance modes to compare instancing behaviors.  
+ [ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+  
+// PerCall creates a new instance for each operation.  
+//[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)]  
+  
+// Singleton creates a single instance for application lifetime.  
+//[ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)]  
+public class CalculatorService : ICalculatorInstance  
+{  
+    static Object syncObject = new object();  
+    static int instanceCount;  
+    int instanceId;  
+    int operationCount;  
+  
+    public CalculatorService()  
+    {  
+        lock (syncObject)  
+        {  
+            instanceCount++;  
+            instanceId = instanceCount;  
+        }  
+    }  
+  
+    public double Add(double n1, double n2)  
+    {  
+        operationCount++;  
+        return n1 + n2;  
+    }  
+  
+    public double Subtract(double n1, double n2)  
+    {  
+        Interlocked.Increment(ref operationCount);  
+        return n1 - n2;  
+    }  
+  
+    public double Multiply(double n1, double n2)  
+    {  
+        Interlocked.Increment(ref operationCount);  
+        return n1 * n2;  
+    }  
+  
+    public double Divide(double n1, double n2)  
+    {  
+        Interlocked.Increment(ref operationCount);  
+        return n1 / n2;  
+    }  
+  
+    public string GetInstanceContextMode()  
+    {   // Return the InstanceContextMode of the service  
+        ServiceHost host = (ServiceHost)OperationContext.Current.Host;  
+        ServiceBehaviorAttribute behavior = host.Description.Behaviors.Find<ServiceBehaviorAttribute>();  
+        return behavior.InstanceContextMode.ToString();  
+    }  
+  
+    public int GetInstanceId()  
+    {   // Return the id for this instance  
+        return instanceId;  
+    }  
+  
+    public int GetOperationCount()  
+    {   // Return the number of ICalculator operations performed   
+        // on this instance  
+        lock (syncObject)  
+        {  
+            return operationCount;  
+        }  
+    }  
+}  
+  
+static void Main()  
+{  
+    // Create a client.  
+    CalculatorInstanceClient client = new CalculatorInstanceClient();  
+    string instanceMode = client.GetInstanceContextMode();  
+    Console.WriteLine("InstanceContextMode: {0}", instanceMode);  
+    DoCalculations(client);  
+  
+    // Create a second client.  
+    CalculatorInstanceClient client2 = new CalculatorInstanceClient();  
+  
+    DoCalculations(client2);  
+  
+    Console.WriteLine();  
+    Console.WriteLine("Press <ENTER> to terminate client.");  
+    Console.ReadLine();  
+}  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  サービスで実行されているインスタンス モードが表示されます。  各操作後に、インスタンス モードの動作が反映されたインスタンス ID と操作数が表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Instancing`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/internet-information-service-hosting-instructions.md b/docs/framework/wcf/samples/internet-information-service-hosting-instructions.md
new file mode 100644
index 00000000000..49e41cef3ec
--- /dev/null
+++ b/docs/framework/wcf/samples/internet-information-service-hosting-instructions.md
@@ -0,0 +1,189 @@
+---
+title: "インターネット インフォメーション サービスのホスティング手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 959a21c8-9d9d-4757-b255-4e57793ae9d6
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# インターネット インフォメーション サービスのホスティング手順
+インターネット インフォメーション サービス \(IIS\) によってホストされているこのサンプルを実行するには、IIS が適切にインストールされて実行されていることを確認する必要があります。  
+  
+### Windows Server 2008 R2 に IIS バージョン 7.5 をインストールするには  
+  
+1.  **サーバー マネージャー**で **\[役割\]** をクリックし、 **\[役割の概要\]** の下の **\[役割の追加\]** をクリックします。  
+  
+2.  **\[次へ\]** をクリックして **\[サーバーの役割の選択\]** ダイアログを表示します。  
+  
+3.  **\[役割\]** 一覧の **\[アプリケーション サーバー\]** を選択し、**\[次へ\]** を 2 回クリックして、アプリケーション サーバーの役割を選択するための **\[役割の選択\]** ダイアログを表示します。  
+  
+4.  **\[Web サーバー \(IIS\)\]** チェック ボックスをオンにします。  追加した役割サービスと機能をインストールするかどうかを確認するメッセージが表示されたら、**\[必要な機能を追加\]** をクリックします。  **\[次へ\]** を 2 回クリックして、Web サーバー \(IIS\) の役割を選択するための **\[役割サービスの選択\]** ダイアログ ボックスを表示します。  
+  
+5.  **\[管理ツール\]**、**\[IIS 6 と互換性のある管理\]** の順に展開します。  **\[IIS 6 スクリプト ツール\]** を選択します。  追加した役割サービスと機能をインストールするかどうかを確認するメッセージが表示されたら、**\[必要な役割サービスを追加\]** をクリックします。  **\[次へ\]** をクリックします。  
+  
+6.  選択内容が正しい場合は、**\[インストール\]** をクリックします。  
+  
+7.  インストールが完了したら、**\[閉じる\]** をクリックします。  
+  
+### Windows 7 に IIS バージョン 7.5 をインストールするには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]** をクリックします。  
+  
+2.  **\[プログラム\]** グループを開きます。  
+  
+3.  **\[プログラムと機能\]** で **\[Windows の機能の有効化または無効化\]** をクリックします。  
+  
+4.  **\[ユーザー アカウント制御\]** ダイアログが表示されます。  **\[続行\]** をクリックします。  
+  
+5.  **\[Windows の機能\]** ダイアログ ボックスが表示されます。  **\[インターネット インフォメーション サービス\]** というラベルが付いている項目を展開します。  
+  
+6.  **\[World Wide Web サービス\]** というラベルが付いている項目を展開します。  
+  
+7.  **\[アプリケーション開発機能\]** というラベルが付いている項目を展開します。  
+  
+8.  次の項目が選択されていることを確認します。  
+  
+    1.  **.NET 拡張機能**  
+  
+    2.  **ASP.NET**  
+  
+    3.  **ISAPI 拡張機能**  
+  
+    4.  **ISAPI フィルター**  
+  
+9. **\[World Wide Web サービス\]** というラベルが付いている項目で、**\[HTTP 共通機能\]** を展開します。  
+  
+10. **\[静的コンテンツ\]** が選択されていることを確認します。  
+  
+11. **\[World Wide Web サービス\]** というラベルが付いている項目で、**\[セキュリティ\]** を展開します。  
+  
+12. **\[Windows 認証\]** が選択されていることを確認します。  
+  
+13. **\[インターネット インフォメーション サービス\]** ディレクトリで、**\[Web 管理ツール\]** というラベルが付いている項目を展開し、**\[IIS 管理コンソール\]** を選択します。  
+  
+14. **\[IIS 6 と互換性のある管理\]** というラベルが付いている項目を展開し、**\[IIS 6 スクリプト ツール\]** を選択します。  
+  
+15. **\[インターネット インフォメーション サービス\]** ディレクトリで、**\[Microsoft .NET Framework 3.5.1\]** というラベルが付いている項目を展開し、**\[Windows Communication Foundation Http Activation\]** を選択します。  
+  
+16. **\[OK\]** をクリックします。  
+  
+### Windows Server 2008 に IIS バージョン 7.0 をインストールするには  
+  
+1.  **サーバー マネージャー**で **\[役割\]** をクリックし、  **\[役割の概要\]** の下の **\[役割の追加\]** をクリックします。  
+  
+2.  **\[次へ\]** をクリックして **\[サーバーの役割の選択\]** ダイアログを表示します。  
+  
+3.  **\[役割\]** 一覧の **\[アプリケーション サーバー\]** を選択し、**\[次へ\]** を 2 回クリックして、アプリケーション サーバーの役割を選択するための **\[役割の選択\]** ダイアログを表示します。  
+  
+4.  **\[Web サーバー \(IIS\)\]** チェック ボックスをオンにします。  追加した役割サービスと機能をインストールするかどうかを確認するメッセージが表示されたら、**\[必要な機能を追加\]** をクリックします。  **\[次へ\]** を 2 回クリックして、Web サーバー \(IIS\) の役割を選択するための **\[役割サービスの選択\]** ダイアログ ボックスを表示します。  
+  
+5.  **\[管理ツール\]**、**\[IIS 6 と互換性のある管理\]** の順に展開します。  **\[IIS 6 スクリプト ツール\]** を選択します。  追加した役割サービスと機能をインストールするかどうかを確認するメッセージが表示されたら、**\[必要な役割サービスを追加\]** をクリックします。  **\[次へ\]** をクリックします。  
+  
+6.  選択内容が正しい場合は、**\[インストール\]** をクリックします。  
+  
+7.  インストールが完了したら、**\[閉じる\]** をクリックします。  
+  
+### Windows Vista に IIS バージョン 7.0 をインストールするには  
+  
+1.  \[スタート\] ボタンをクリックし、\[コントロール パネル\] をクリックします。  
+  
+2.  **\[プログラム\]** グループを選択します。  
+  
+3.  **\[プログラムと機能\]** で **\[Windows の機能の有効化または無効化\]** をクリックします。  
+  
+4.  **\[ユーザー アカウント制御\]** ダイアログが表示されます。  **\[続行\]** をクリックします。  
+  
+5.  **\[Windows の機能\]** ダイアログ ボックスが表示されます。  **\[インターネット インフォメーション サービス\]** というラベルが付いている項目を展開します。  
+  
+6.  **\[World Wide Web サービス\]** というラベルが付いている項目を展開します。  
+  
+7.  **\[アプリケーション開発機能\]** というラベルが付いている項目を展開します。  
+  
+8.  次の項目が選択されていることを確認します。  
+  
+    1.  **.NET 拡張機能**  
+  
+    2.  **ASP.NET**  
+  
+    3.  **ISAPI 拡張機能**  
+  
+    4.  **ISAPI フィルター**  
+  
+9. **\[Web 管理ツール\]** というラベルが付いている項目を展開し、**\[IIS 管理コンソール\]** を選択します。  
+  
+10. **\[World Wide Web サービス\]** というラベルが付いている項目で、**\[HTTP 共通機能\]** を展開します。  
+  
+11. **\[静的コンテンツ\]** が選択されていることを確認します。  
+  
+12. **\[World Wide Web サービス\]** というラベルが付いている項目で、**\[セキュリティ\]** を展開します。  
+  
+13. **\[Windows 認証\]** が選択されていることを確認します。  
+  
+14. **\[IIS 6 と互換性のある管理\]** というラベルが付いている項目を展開し、**\[IIS 6 スクリプト ツール\]** を選択します。  
+  
+15. **\[Microsoft .NET Framework 3.0\]** というラベルが付いている項目を展開し、**\[Windows Communication Foundation Http Activation\]** をクリックします。  
+  
+16. **\[OK\]** をクリックします。  
+  
+### Windows Server 2003 に IIS バージョン 6.0 をインストールするには  
+  
+1.  **\[サーバーの役割管理\]** で **\[役割を追加または削除する\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+2.  **\[サーバーの役割\]** ボックスの一覧の **\[アプリケーション サーバー \(IIS、ASP.NET\)\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+3.  **\[ASP.NET の有効化\]** チェック ボックスをオンにして、**\[次へ\]** をクリックします。  
+  
+4.  選択内容が正しい場合は、\[次へ\] をクリックします。  
+  
+### Service Pack 2 および Service Pack 3 がインストールされている Windows XP に IIS バージョン 5.1 をインストールするには  
+  
+1.  \[コントロール パネル\] の **\[プログラムの追加と削除\]** をクリックします。  
+  
+2.  **\[プログラムの追加と削除\]** ダイアログ ボックスで **\[Windows コンポーネントの追加と削除\]** をクリックします。  
+  
+3.  **\[Windows コンポーネント ウィザード\]** の **\[インターネット インフォメーション サービス \(IIS\)\]** チェック ボックスをオンにし、**\[次へ\]** をクリックします。  
+  
+4.  **\[ファイルが必要\]** ダイアログ ボックスが表示された場合は、オペレーティング システムのインストール ディスクを挿入し、i386 フォルダーに移動して、**\[OK\]** をクリックします。  
+  
+5.  インストールが完了したら、**\[完了\]** をクリックします。  
+  
+6.  **\[プログラムの追加と削除\]** ダイアログ ボックスを閉じて、**\[コントロール パネル\]** を閉じます。  
+  
+### IIS と ASP.NET がインストールされていることを確認するには  
+  
+1.  このトピックの最後に示す HTML ファイルを \\InetPub\\wwwroot のルート ディレクトリに保存し、Default.aspx という名前を付けます。  
+  
+2.  ブラウザー ウィンドウを開きます。  
+  
+3.  アドレス ボックスに「`http://localhost/Default.aspx`」と入力して Enter キーを押します。  
+  
+4.  Web ページに、テキスト "Hello World" が表示されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の新しいバージョンをインストールするたびに、IIS の Web サービス拡張として aspnet\_isapi を再登録する必要があります。  これを行うには、`aspnet_regiis –I –enable` コマンドを実行します。  
+  
+## サンプル コード  
+  
+```  
+<html>  
+   <body>  
+       <form >  
+           <h3> Hello World  
+           </h3>  
+       </form>  
+   </body>  
+</html>  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/interop-extensibility.md b/docs/framework/wcf/samples/interop-extensibility.md
new file mode 100644
index 00000000000..750e9f26e75
--- /dev/null
+++ b/docs/framework/wcf/samples/interop-extensibility.md
@@ -0,0 +1,27 @@
+---
+title: "相互運用性の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 384a012a-d92d-40d1-b1a5-9c18ca932fcc
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 相互運用性の拡張
+このセクションには、カスタムの相互運用性の例を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [本文要素別のディスパッチ](../../../../docs/framework/wcf/samples/dispatch-by-body-element.md)  
+ 入力メッセージを操作に割り当てるための代替アルゴリズムを実装する方法を示します。  
+  
+ [本文別のルーティング](../../../../docs/framework/wcf/samples/route-by-body.md)  
+ 任意の SOAP アクションでメッセージ オブジェクトを受け入れるサービスを実装する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/interoperating-with-asmx-web-services.md b/docs/framework/wcf/samples/interoperating-with-asmx-web-services.md
new file mode 100644
index 00000000000..e52be8ce17f
--- /dev/null
+++ b/docs/framework/wcf/samples/interoperating-with-asmx-web-services.md
@@ -0,0 +1,144 @@
+---
+title: "ASMX Web サービスとの相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a7c11f0a-9e68-4f03-a6b1-39cf478d1a89
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# ASMX Web サービスとの相互運用性
+このサンプルは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションを既存の ASMX Web サービスと統合する手順を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、クライアント コンソール プログラム \(.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(.dll\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装する ASMX Web サービスです。このサービスは算術演算 \(`Add`、`Subtract`、`Multiply`、および `Divide`\) を公開しています。クライアントは算術演算を同期要求し、サービスは応答して結果を返します。クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+ 次のサンプル コードで示す ASMX Web サービス実装では、計算を行い、結果を返します。  
+  
+```  
+[WebService(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public class CalculatorService : System.Web.Services.WebService  
+    {  
+        [WebMethod]  
+        public double Add(double n1, double n2)  
+        {  
+            return n1 + n2;  
+        }  
+        [WebMethod]  
+        public double Subtract(double n1, double n2)  
+        {  
+            return n1 - n2;  
+        }  
+        [WebMethod]  
+        public double Multiply(double n1, double n2)  
+        {  
+            return n1 * n2;  
+        }  
+        [WebMethod]  
+        public double Divide(double n1, double n2)  
+        {  
+            return n1 / n2;  
+        }  
+    }  
+  
+```  
+  
+ 上記の構成では、サービスと同じコンピュータ上にあるクライアントは、http:\/\/localhost\/servicemodelsamples\/service.asmx でサービスにアクセスできます。リモート コンピュータ上のクライアントがサービスにアクセスするには、localhost の代わりに修飾ドメイン名を指定する必要があります。  
+  
+ 通信は、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成されたクライアントを通じて行われます。このクライアントは、ファイル generatedClient.cs に含まれています。プロキシ コードを生成するには、ASMX サービスを利用できる必要があります。このサービスは、更新されたメタデータの取得に使用されるためです。次のコマンドをクライアント ディレクトリでコマンド プロンプトから実行して、型指定のあるプロキシを生成します。  
+  
+```  
+svcutil.exe /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost/servicemodelsamples/service.svc?wsdl /out:generatedClient.cs  
+```  
+  
+ 生成されたクライアントを使用することにより、適切なアドレスとバインディングを構成して、サービス エンドポイントにアクセスできます。サービスと同様、クライアントは構成ファイル \(App.config\) を使用して、通信するエンドポイントを指定します。クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。次のサンプル構成を参照してください。  
+  
+```  
+<client>  
+   <endpoint   
+      address="http://localhost/ServiceModelSamples/service.asmx"   
+      binding="basicHttpBinding"   
+      contract="Microsoft.ServiceModel.Samples.CalculatorServiceSoap" />  
+</client>  
+  
+```  
+  
+ クライアント実装は、生成されたクライアントのインスタンスをコンストラクトします。生成されたクライアントは、サービスとの通信に使用できます。  
+  
+```  
+// Create a client.  
+CalculatorServiceSoapClient client = new CalculatorServiceSoapClient();  
+  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = client.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Subtract service operation.  
+value1 = 145.00D;  
+value2 = 76.54D;  
+result = client.Subtract(value1, value2);  
+Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Multiply service operation.  
+value1 = 9.00D;  
+value2 = 81.25D;  
+result = client.Multiply(value1, value2);  
+Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+// Call the Divide service operation.  
+value1 = 22.00D;  
+value2 = 7.00D;  
+result = client.Divide(value1, value2);  
+Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+Console.WriteLine();  
+Console.WriteLine("Press <ENTER> to terminate client.");  
+Console.ReadLine();  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\Interop\ASMX`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/json-serialization.md b/docs/framework/wcf/samples/json-serialization.md
new file mode 100644
index 00000000000..dccc2066646
--- /dev/null
+++ b/docs/framework/wcf/samples/json-serialization.md
@@ -0,0 +1,81 @@
+---
+title: "JSON シリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3c2c4747-7510-4bdf-b4fe-64f98428ef4a
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# JSON シリアル化
+このサンプルでは、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用して、JavaScript Object Notation \(JSON\) 形式のデータをシリアル化および逆シリアル化する方法を示します。このシリアル化エンジンによって、JSON データを [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 型のインスタンスに変換したり、また JSON データに戻したりできます。<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> では、<xref:System.Runtime.Serialization.DataContractSerializer> と同じ型をサポートしています。JSON データ形式は、特に Asynchronous JavaScript and XML \(AJAX\) スタイルの Web アプリケーションを作成するときに便利です。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での AJAX サポートは、ScriptManager コントロールを介して ASP.NET AJAX と共に使用できるように最適化されています。ASP.NET AJAX と共に [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用する例については、「[AJAX Samples](http://msdn.microsoft.com/ja-jp/f3fa45b3-44d5-4926-8cc4-a13c30a3bf3e)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、シリアル化および逆シリアル化を示すために、`Person` データ コントラクトを使用しています。  
+  
+```  
+[DataContract]  
+    class Person  
+    {  
+        [DataMember]  
+        internal string name;  
+  
+        [DataMember]  
+        internal int age;  
+    }  
+  
+```  
+  
+ `Person` 型のインスタンスを JSON にシリアル化するには、最初に <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を作成し、次に `WriteObject` メソッドを使用して JSON データをストリームに書き込みます。  
+  
+```  
+Person p = new Person();  
+//Set up Person object...  
+MemoryStream stream1 = new MemoryStream();  
+DataContractJsonSerializer ser = new DataContractJsonSerializer(typeof(Person));  
+ser.WriteObject(stream1, p);  
+  
+```  
+  
+ メモリ ストリームには有効な JSON データが含まれています。  
+  
+```  
+{“age”:42,”name”:”John”}  
+  
+```  
+  
+ このサンプルでは、JSON データからオブジェクトへの逆シリアル化を示します。次に、ストリームを巻き戻し、`ReadObject` を呼び出します。  
+  
+```  
+Person p2 = (Person)ser.ReadObject(stream1);  
+```  
+  
+ `p2` オブジェクトを調べることで、JSON データが正しく逆シリアル化されていることがわかります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Ajax\JsonSerialization`  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の説明に従って、ソリューション JsonSerialization.sln をビルドします。  
+  
+2.  作成されたコンソール アプリケーションを実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/jsonp.md b/docs/framework/wcf/samples/jsonp.md
new file mode 100644
index 00000000000..95762cf16e9
--- /dev/null
+++ b/docs/framework/wcf/samples/jsonp.md
@@ -0,0 +1,81 @@
+---
+title: "JSONP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c13b4d7b-dac7-4ffd-9f84-765c903511e1
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# JSONP
+このサンプルでは、WCF REST サービスの JSONP \(JSON with Padding\) をサポートする方法を示します。  JSONP とは、現在のドキュメントでスクリプト タグを生成してドメイン間スクリプトを呼び出す際に使用される変換です。  結果は、指定したコールバック関数で返されます。  JSONP は、\<script src\=”http:\/\/...” \> などのタグで任意のドメインからのスクリプトを評価でき、このようなタグによって取得されたスクリプトを既に他の関数が定義されている範囲で評価するという考えに基づいています。  
+  
+## 使用例  
+ JSONP によるドメイン間スクリプト。  
+  
+## 説明  
+ このサンプルには、ブラウザーで表示された後にスクリプト ブロックを動的に追加する Web ページが含まれています。  このスクリプト ブロックは、`GetCustomer` 操作を 1 つ持つ WCF REST サービスを呼び出します。  WCF REST サービスは、コールバック関数名でラップされた顧客の名前とアドレスを返します。  WCF REST サービスが応答を返すと、顧客データを使用して Web ページ上のコールバック関数が呼び出され、このコールバック関数によって Web ページ上に顧客データが表示されます。  スクリプト タグの挿入とコールバック関数の実行は、ASP.NET AJAX ScriptManager コントロールによって自動的に処理されます。  次のコードに示すように、使用パターンはすべての ASP.NET AJAX プロキシと同じで、JSONP を有効にするための行が 1 つ追加されます。  
+  
+```csharp  
+var proxy = new JsonpAjaxService.CustomerService();  
+proxy.set_enableJsonp(true);  
+proxy.GetCustomer(onSuccess, onFail, null);  
+  
+```  
+  
+ Web ページでは、WCF REST サービスを呼び出すことができます。これは、WCF REST サービスが、`crossDomainScriptAccessEnabled` が `true` に設定された <xref:System.ServiceModel.Description.WebScriptEndpoint> を使用しているからです。  これらの構成は、Web.config ファイルの \<system.serviceModel\> 要素で行います。  
+  
+```  
+<system.serviceModel>  
+  <serviceHostingEnvironment aspNetCompatibilityEnabled="true"/>  
+  <standardEndpoints>  
+    <webScriptEndpoint>  
+      <standardEndpoint name="" crossDomainScriptAccessEnabled="true"/>  
+    </webScriptEndpoint>  
+  </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+ ScriptManager はサービスとのやり取りを管理し、JSONP アクセスの手動実装の複雑さを隠蔽します。  `crossDomainScriptAccessEnabled` が `true` に設定されていて、操作の応答形式が JSON である場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャは要求の URI からコールバック クエリ文字列パラメーターを検出し、そのコールバック クエリ文字列パラメーターの値で JSON 応答をラップします。  このサンプルでは、Web ページは次の URI を使用して WCF REST サービスを呼び出します。  
+  
+```  
+http://localhost:33695/CustomerService/GetCustomer?callback=Sys._json0  
+  
+```  
+  
+ コールバック クエリ文字列パラメーターには `JsonPCallback` の値が含まれているため、WCF サービスは次の例に示す JSONP 応答を返します。  
+  
+```  
+Sys._json0({"__type":"Customer:#Microsoft.Samples.Jsonp","Address":"1 Example Way","Name":"Bob"});  
+  
+```  
+  
+ JSONP 応答には、JSON として書式設定され、Web ページが要求したコールバック関数名でラップされた顧客データが含まれています。  ScriptManager は、ドメイン間要求を実現するスクリプト タグを使用してこのコールバックを実行し、ASP.NET AJAX プロキシの GetCustomer 操作に渡された onSuccess ハンドラーに結果を渡します。  
+  
+ このサンプルは 2 つの ASP.NET Web アプリケーションで構成されます。1 つは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのみを含み、もう 1 つはサービスを呼び出す .aspx Web ページを含みます。  ソリューションの実行中、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] は 2 つの Web サイトを別々のポート上にホストします。これにより、サービスとクライアントが別々のドメインに存在する環境が作成されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\AJAX\JSONP`  
+  
+#### サンプルを実行するには  
+  
+1.  JSONP サンプルのソリューションを開きます。  
+  
+2.  F5 キーを押して、http:\/\/localhost:26648\/JSONPClientPage.aspx をブラウザーで開きます。  
+  
+3.  ページが読み込まれた後、"Name" および "Address" のテキスト入力に値が設定されます。  これらの値は、ブラウザーがページを表示した後に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの呼び出しから提供されたものです。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/known-types.md b/docs/framework/wcf/samples/known-types.md
new file mode 100644
index 00000000000..7bfe923af43
--- /dev/null
+++ b/docs/framework/wcf/samples/known-types.md
@@ -0,0 +1,185 @@
+---
+title: "既知の型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88d83720-ca38-4b2c-86a6-f149ed1d89ec
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# 既知の型
+このサンプルでは、データ コントラクト内の派生型に関する情報を指定する方法を示します。データ コントラクトを使用すると、サービスと構造化データをやり取りできます。オブジェクト指向プログラミングでは、別の型から継承される型を元の型の代わりに使用できます。サービス指向プログラミングでは、型ではなくスキーマが伝達されるので、型と型との関係は保持されません。<xref:System.Runtime.Serialization.KnownTypeAttribute> 属性を使用すると、派生型に関する情報をデータ コントラクトに含めることができます。この機構を使用しない場合は、基本型が予期される箇所では派生型を送受信できません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスのサービス コントラクトでは複素数を使用します。次のサンプル コードを参照してください。  
+  
+```  
+// Define a service contract.  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);  
+}  
+  
+```  
+  
+ <xref:System.Runtime.Serialization.DataContractAttribute> と <xref:System.Runtime.Serialization.DataMemberAttribute> は `ComplexNumber` クラスに適用され、クライアントとサービスの間で渡されるクラスのフィールドを示します。`ComplexNumberWithMagnitude` 派生クラスは、`ComplexNumber` の代わりに使用できます。これは、`ComplexNumber` 型の <xref:System.Runtime.Serialization.KnownTypeAttribute> 属性で指定します。  
+  
+```  
+[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+[KnownType(typeof(ComplexNumberWithMagnitude))]  
+public class ComplexNumber  
+{  
+    [DataMember]  
+    public double Real = 0.0D;  
+    [DataMember]  
+    public double Imaginary = 0.0D;  
+  
+    public ComplexNumber(double real, double imaginary)  
+    {  
+        this.Real = real;  
+        this.Imaginary = imaginary;  
+    }  
+}  
+  
+```  
+  
+ `ComplexNumberWithMagnitude` 型は `ComplexNumber` から派生しますが、追加のデータ メンバ `Magnitude` が追加されます。  
+  
+```  
+  
+[DataContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public class ComplexNumberWithMagnitude : ComplexNumber  
+{  
+    public ComplexNumberWithMagnitude(double real, double imaginary) :  
+        base(real, imaginary) { }  
+  
+    [DataMember]  
+    public double Magnitude  
+    {  
+        get { return Math.Sqrt(Imaginary*Imaginary  + Real*Real); }  
+        set { throw new NotImplementedException(); }  
+    }  
+}  
+```  
+  
+ 既知の型の機能を示すため、サービスは、加算と減算に対してのみ `ComplexNumberWithMagnitude` を返すという方法で実装されています \(コントラクトで `ComplexNumber` を指定している場合でも、コントラクトの `KnownTypeAttribute` 属性によりこの実装は許可されます\)。乗算と除算では、そのまま基本の `ComplexNumber`  型が返されます。  
+  
+```  
+public class DataContractCalculatorService : IDataContractCalculator  
+{  
+    public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        //Return the derived type.  
+        return new ComplexNumberWithMagnitude(n1.Real + n2.Real,  
+                                      n1.Imaginary + n2.Imaginary);  
+    }  
+  
+    public ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        //Return the derived type.  
+        return new ComplexNumberWithMagnitude(n1.Real - n2.Real,   
+                                 n1.Imaginary - n2.Imaginary);  
+    }  
+  
+    public ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        double real1 = n1.Real * n2.Real;  
+        double imaginary1 = n1.Real * n2.Imaginary;  
+        double imaginary2 = n2.Real * n1.Imaginary;  
+        double real2 = n1.Imaginary * n2.Imaginary * -1;  
+        //Return the base type.  
+        return new ComplexNumber(real1 + real2, imaginary1 +   
+                                                  imaginary2);  
+    }  
+  
+    public ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        ComplexNumber conjugate = new ComplexNumber(n2.Real,   
+                                     -1*n2.Imaginary);  
+        ComplexNumber numerator = Multiply(n1, conjugate);  
+        ComplexNumber denominator = Multiply(n2, conjugate);  
+        //Return the base type.  
+        return new ComplexNumber(numerator.Real / denominator.Real,  
+                                             numerator.Imaginary);  
+    }  
+}  
+```  
+  
+ クライアントでは、サービス コントラクトとデータ コントラクトは、どちらもソース ファイル generatedClient.cs で定義されます。このソース ファイルは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によってサービス メタデータから生成されます。<xref:System.Runtime.Serialization.KnownTypeAttribute> 属性はサービスのデータ コントラクト内で指定されるので、クライアントはサービスを使用する際に `ComplexNumber` クラスと `ComplexNumberWithMagnitude` クラスの両方を受け取ることができます。クライアントは、`ComplexNumberWithMagnitude` を取得したかどうかを検出し、適切な出力を生成します。  
+  
+```  
+// Create a client  
+DataContractCalculatorClient client =   
+    new DataContractCalculatorClient();  
+  
+// Call the Add service operation.  
+ComplexNumber value1 = new ComplexNumber(); value1.real = 1; value1.imaginary = 2;  
+ComplexNumber value2 = new ComplexNumber(); value2.real = 3; value2.imaginary = 4;  
+ComplexNumber result = client.Add(value1, value2);  
+Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+    value1.real, value1.imaginary, value2.real, value2.imaginary,  
+    result.real, result.imaginary);  
+if (result is ComplexNumberWithMagnitude)  
+{  
+    Console.WriteLine("Magnitude: {0}",   
+        ((ComplexNumberWithMagnitude)result).Magnitude);  
+}  
+else  
+{  
+    Console.WriteLine("No magnitude was sent from the service");  
+}  
+  
+```  
+  
+ このサンプルを実行する場合は、操作の要求や応答はクライアントのコンソール ウィンドウに表示されます。サービスの実装方法により、加算と減算に対しては大きさが出力されますが、乗算と除算に対しては出力されません。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(1 + 2i, 3 + 4i) = 4 + 6i  
+Magnitude: 7.21110255092798  
+Subtract(1 + 2i, 3 + 4i) = -2 + -2i  
+Magnitude: 2.82842712474619  
+Multiply(2 + 3i, 4 + 7i) = -13 + 26i  
+No magnitude was sent from the service  
+Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 41i  
+No magnitude was sent from the service  
+  
+    Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\KnownTypes`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/knownassemblyattribute.md b/docs/framework/wcf/samples/knownassemblyattribute.md
new file mode 100644
index 00000000000..4b4213c4727
--- /dev/null
+++ b/docs/framework/wcf/samples/knownassemblyattribute.md
@@ -0,0 +1,387 @@
+---
+title: "KnownAssemblyAttribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b3bc7f31-95ff-46e1-8308-d206ec426f6e
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# KnownAssemblyAttribute
+このサンプルでは、<xref:System.Runtime.Serialization.DataContractResolver> クラスを使用して、シリアル化プロセスおよび逆シリアル化プロセスをカスタマイズする方法を示します。  このサンプルで示すのは、シリアル化および逆シリアル化時に既知の型を動的に追加する方法です。  
+  
+## サンプルの詳細  
+ このサンプルは、4 つのプロジェクトで構成されます。  そのうちの 1 つは、IIS でホストされ、次のサービス コントラクトを定義するサービスに対応します。  
+  
+```  
+// Definition of a service contract.  
+[ServiceContract(Namespace = "http://Microsoft.Samples.KAA")]  
+[KnownAssembly("Types")]  
+public interface IDataContractCalculator  
+ {  
+    [OperationContract]  
+    ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);  
+  
+    [OperationContract]  
+    ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);  
+  
+    [OperationContract]  
+    ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);  
+  
+    [OperationContract]  
+    ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);  
+  
+    [OperationContract]  
+    List<ComplexNumber> CombineLists(List<ComplexNumber> list1, List<ComplexNumber> list2);  
+}  
+  
+```  
+  
+ サービス コントラクトの実装を次の例に示します。  
+  
+```  
+// Service class that implements the service contract.  
+ public class DataContractCalculatorService : IDataContractCalculator  
+ {  
+    public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        return new ComplexNumberWithMagnitude(n1.Real + n2.Real, n1.Imaginary + n2.Imaginary);  
+    }  
+  
+    public ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        return new ComplexNumberWithMagnitude(n1.Real - n2.Real, n1.Imaginary - n2.Imaginary);  
+    }  
+  
+    public ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        double real1 = n1.Real * n2.Real;  
+        double imaginary1 = n1.Real * n2.Imaginary;  
+        double imaginary2 = n2.Real * n1.Imaginary;  
+        double real2 = n1.Imaginary * n2.Imaginary * -1;  
+  
+        return new ComplexNumber(real1 + real2, imaginary1 + imaginary2);  
+    }  
+  
+    public ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        ComplexNumber conjugate = new ComplexNumber(n2.Real, -1 * n2.Imaginary);  
+        ComplexNumber numerator = Multiply(n1, conjugate);  
+        ComplexNumber denominator = Multiply(n2, conjugate);  
+  
+        return new ComplexNumber(numerator.Real / denominator.Real, numerator.Imaginary);  
+    }  
+  
+    public List<ComplexNumber> CombineLists(List<ComplexNumber> list1, List<ComplexNumber> list2)  
+    {  
+        List<ComplexNumber> result  = new List<ComplexNumber>();  
+        result.AddRange(list1);  
+        result.AddRange(list2);  
+  
+        return result;  
+    }  
+}  
+  
+```  
+  
+ もう 1 つのプロジェクトは、サーバーと通信し、サーバーが公開しているメソッドを呼び出すクライアントに対応します。  クライアントの定義を次の例に示します。  
+  
+```  
+ // Client implementation code.  
+ class Client  
+ {  
+    static void Main()  
+    {  
+        // Create a channel.  
+         EndpointAddress address = new EndpointAddress("http://localhost/servicemodelsamples/service.svc/IDataContractCalculator");  
+        BasicHttpBinding binding = new BasicHttpBinding();  
+        ChannelFactory<IDataContractCalculator> factory = new ChannelFactory<IDataContractCalculator>(binding, address);  
+        IDataContractCalculator channel = factory.CreateChannel();  
+  
+        // Call the Add service operation.  
+         ComplexNumber value1 = new ComplexNumber(1, 2);  
+        ComplexNumber value2 = new ComplexNumberWithMagnitude(3, 4);  
+        ComplexNumber result = channel.Add(value1, value2);  
+        Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+            value1.Real, value1.Imaginary, value2.Real, value2.Imaginary, result.Real, result.Imaginary);  
+        if (result is ComplexNumberWithMagnitude)  
+        {  
+            Console.WriteLine("Magnitude: {0}", ((ComplexNumberWithMagnitude)result).Magnitude);  
+        }  
+        else  
+         {  
+            Console.WriteLine("No magnitude was sent from the service");  
+        }  
+        Console.WriteLine();  
+  
+        // Call the Subtract service operation.  
+         value1 = new ComplexNumber(1, 2);  
+        value2 = new ComplexNumber(3, 4);  
+        result = channel.Subtract(value1, value2);  
+        Console.WriteLine("Subtract({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+            value1.Real, value1.Imaginary, value2.Real, value2.Imaginary, result.Real, result.Imaginary);  
+        if (result is ComplexNumberWithMagnitude)  
+        {  
+            Console.WriteLine("Magnitude: {0}", ((ComplexNumberWithMagnitude)result).Magnitude);  
+        }  
+        else  
+         {  
+            Console.WriteLine("No magnitude was sent from the service");  
+        }  
+        Console.WriteLine();  
+  
+        // Call the Multiply service operation.  
+         value1 = new ComplexNumber(2, 3);  
+        value2 = new ComplexNumber(4, 7);  
+        result = channel.Multiply(value1, value2);  
+        Console.WriteLine("Multiply({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+            value1.Real, value1.Imaginary, value2.Real, value2.Imaginary, result.Real, result.Imaginary);  
+        if (result is ComplexNumberWithMagnitude)  
+        {  
+            Console.WriteLine("Magnitude: {0}", ((ComplexNumberWithMagnitude)result).Magnitude);  
+        }  
+        else  
+         {  
+            Console.WriteLine("No magnitude was sent from the service");  
+        }  
+        Console.WriteLine();  
+  
+        // Call the Divide service operation.  
+         value1 = new ComplexNumber(3, 7);  
+        value2 = new ComplexNumber(5, -2);  
+        result = channel.Divide(value1, value2);  
+        Console.WriteLine("Divide({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+            value1.Real, value1.Imaginary, value2.Real, value2.Imaginary, result.Real, result.Imaginary);  
+        if (result is ComplexNumberWithMagnitude)  
+        {  
+            Console.WriteLine("Magnitude: {0}", ((ComplexNumberWithMagnitude)result).Magnitude);  
+        }  
+        else  
+         {  
+            Console.WriteLine("No magnitude was sent from the service");  
+        }  
+        Console.WriteLine();  
+  
+        // Call the CombineLists service operation.  
+         List<ComplexNumber> list1 = new List<ComplexNumber>();  
+        List<ComplexNumber> list2 = new List<ComplexNumber>();  
+        list1.Add(new ComplexNumber(1, 1));  
+        list1.Add(new ComplexNumber(2, 2));  
+        list1.Add(new ComplexNumberWithMagnitude(3, 3));  
+        list1.Add(new ComplexNumberWithMagnitude(4, 4));  
+        List<ComplexNumber> listResult = channel.CombineLists(list1, list2);  
+        Console.WriteLine("Lists combined:");  
+        foreach (ComplexNumber n in listResult)  
+        {  
+            Console.WriteLine("{0} + {1}i", n.Real, n.Imaginary);  
+        }  
+        Console.WriteLine();  
+  
+        // Close the channel  
+         ((IChannel)channel).Close();  
+  
+        Console.WriteLine();  
+        Console.WriteLine("Press <ENTER> to terminate client.");  
+        Console.ReadLine();  
+    }  
+}  
+  
+```  
+  
+ サービス コントラクトの定義は、`KnownAssembly` 属性でマークされます。  この属性には型のライブラリの名前が含まれています。これらの型はすべて、実行時にサービスとクライアントの両方で既知となります。  
+  
+ `KnownAssembly` 属性は、操作の各動作に対して定義される `DataContractResolver` を使用して `DataContractSerializer` を定義するために `IContractBehavior` を実装します。  `DataContractResolver` は、作成時にアセンブリを十分に調べて、型と名前のマッピングを含むディクショナリを作成します。このディクショナリは、さまざまな型をシリアル化および逆シリアル化するときに使用されます。  このように、`ResolveType` 型および `ResolveName` 型は、必要なデータをディクショナリから検索する必要があります。  
+  
+ このサンプルでの `DataContractResolver` の定義を次の例に示します。  
+  
+```  
+public class MyDataContractResolver : DataContractResolver  
+    {  
+       Dictionary<string, XmlDictionaryString> dictionary = new Dictionary<string, XmlDictionaryString>();  
+       Assembly assembly;  
+  
+       public MyDataContractResolver(string assemblyName)  
+       {  
+           this.KnownTypes = new List<Type>();  
+  
+           assembly = Assembly.Load(new AssemblyName(assemblyName));  
+           foreach (Type type in assembly.GetTypes())  
+           {  
+               bool knownTypeFound = false;  
+               System.Attribute[] attrs = System.Attribute.GetCustomAttributes(type);  
+               if (attrs.Length != 0)  
+               {  
+                   foreach (System.Attribute attr in attrs)  
+                   {  
+                       if (attr is KnownTypeAttribute)  
+                       {  
+                           Type t = ((KnownTypeAttribute)attr).Type;  
+                           if (this.KnownTypes.IndexOf(t) < 0)  
+                           {  
+                               this.KnownTypes.Add(t);  
+                           }  
+                           knownTypeFound = true;  
+                       }  
+                   }  
+               }  
+               if (!knownTypeFound)  
+               {  
+                   string name = type.Name;  
+                   string namesp = type.Namespace;  
+                   if (!dictionary.ContainsKey(name))  
+                   {  
+                       dictionary.Add(name, new XmlDictionaryString(XmlDictionary.Empty, name, 0));  
+                   }  
+                   if (!dictionary.ContainsKey(namesp))  
+                   {  
+                       dictionary.Add(namesp, new XmlDictionaryString(XmlDictionary.Empty, namesp, 0));  
+                   }  
+               }  
+           }  
+       }  
+  
+       public IList<Type> KnownTypes  
+       {  
+           get; set;  
+       }  
+  
+       // Used at deserialization  
+        // Allows users to map xsi:type name to any Type   
+        public override Type ResolveName(string typeName, string typeNamespace, DataContractResolver knownTypeResolver)  
+       {  
+           XmlDictionaryString tName;  
+           XmlDictionaryString tNamespace;  
+  
+           if (dictionary.TryGetValue(typeName, out tName) && dictionary.TryGetValue(typeNamespace, out tNamespace))  
+           {  
+               return this.assembly.GetType(tNamespace.Value + "." + tName.Value);  
+           }  
+           else  
+            {  
+               return knownTypeResolver.ResolveName(typeName, typeNamespace, null);  
+           }  
+       }  
+  
+       // Used at serialization  
+        // Maps any Type to a new xsi:type representation  
+        public override void ResolveType(Type dataContractType, DataContractResolver knownTypeResolver, out XmlDictionaryString typeName, out XmlDictionaryString typeNamespace)  
+       {  
+           knownTypeResolver.ResolveType(dataContractType, null, out typeName, out typeNamespace);  
+           if (typeName == null || typeNamespace == null)  
+           {  
+               typeName = new XmlDictionaryString(XmlDictionary.Empty, dataContractType.Name, 0);  
+               typeNamespace = new XmlDictionaryString(XmlDictionary.Empty, dataContractType.Namespace, 0);  
+           }  
+       }  
+   }  
+  
+```  
+  
+ このサンプルで使用する型のライブラリを次の例に示します。  
+  
+```  
+ [DataContract]  
+ public class ComplexNumber  
+ {  
+    [DataMember]  
+    private double real;  
+  
+    [DataMember]  
+    private double imaginary;  
+  
+    public ComplexNumber(double r1, double i1)  
+    {  
+        this.Real = r1;  
+        this.Imaginary = i1;  
+    }  
+  
+    public double Real  
+    {  
+        get { return real; }  
+        set { real = value; }  
+    }  
+  
+    public double Imaginary  
+    {  
+        get { return imaginary; }  
+        set { imaginary = value; }  
+    }  
+}  
+  
+[DataContract]  
+public class ComplexNumberWithMagnitude : ComplexNumber  
+ {  
+    public ComplexNumberWithMagnitude(double real, double imaginary) : base(real, imaginary) { }  
+  
+    [DataMember]  
+    public double Magnitude  
+    {  
+        get { return Math.Sqrt(Imaginary * Imaginary + Real * Real); }  
+        set { }  
+    }  
+}  
+  
+```  
+  
+ `ComplexNumber` は、`ComplexNumberWithMagnitude` 型を静的に知る必要はありません。この型は実行時に既知となるためです。  
+  
+ このサンプルをビルドして実行した場合、クライアントでは次のような出力が取得されます。  
+  
+```  
+Add(1 + 2i, 3 + 4i) = 4 + 6i  
+Magnitude: 7.21110255092798  
+  
+Subtract(1 + 2i, 3 + 4i) = -2 + -2i  
+Magnitude: 2.82842712474619  
+  
+Multiply(2 + 3i, 4 + 7i) = -13 + 26i  
+No magnitude was sent from the service  
+  
+Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 41i  
+No magnitude was sent from the service  
+  
+Lists combined:  
+1 + 1i  
+2 + 2i  
+3 + 3i  
+4 + 4i  
+  
+```  
+  
+#### サンプルを設定、実行、およびビルドするには  
+  
+1.  ソリューションの **KnownAssemblyAttribute** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[マルチ スタートアップ プロジェクト\]** をクリックします。  
+  
+3.  **サービス** プロジェクトと **クライアント** プロジェクトに **\[開始\]** アクションを追加します。  
+  
+4.  **\[OK\]** をクリックし、**F5** キーを押してサンプルを実行します。  
+  
+5.  アプリケーションが正しく動作しない場合は、次の手順に従って環境設定が適切であることを確認してください。  
+  
+6.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](http://go.microsoft.com/fwlink/?LinkId=150774)」が実行済みであることを確認します。  
+  
+7.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](http://go.microsoft.com/fwlink/?LinkId=150775)」の手順に従います。  
+  
+8.  単一のコンピュータの構成または複数のコンピュータの構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](http://go.microsoft.com/fwlink/?LinkId=150776)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\KnownAssemblyAttribute`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/local-channel.md b/docs/framework/wcf/samples/local-channel.md
new file mode 100644
index 00000000000..814ca09a358
--- /dev/null
+++ b/docs/framework/wcf/samples/local-channel.md
@@ -0,0 +1,47 @@
+---
+title: "ローカル チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fa1917a4-f701-4e82-a439-14a16282c7cc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ローカル チャネル
+ローカル チャネルは、同じアプリケーション ドメイン内の通信に使用される [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] トランスポート チャネルです。  これは、クライアントとサービスが同じアプリケーション ドメイン内で実行されており、通常の WCF チャネル スタックのオーバーヘッド \(メッセージのシリアル化と逆シリアル化\) を回避する必要がある場合に役に立ちます。  
+  
+## 使用例  
+ ローカル チャネル  
+  
+## 説明  
+ このサンプルは、2 つのプロジェクト ファイルで構成されます。  
+  
+-   **LocalChannel**: 現在のアプリケーション ドメイン内のローカル チャネルのプログラム表現。  このプロジェクトでは、送信側コンポーネントがメッセージをメモリ内キューに入れて、受信側コンポーネントがメッセージをキューから削除して受信します。  
+  
+-   **ClientAndService**: このプロジェクトは、サービスをコンソール アプリケーションでホストし、クライアントを実行して同じアプリケーション ドメイン内からサービスを呼び出します。  
+  
+ ローカル チャネルのデザインでは、速度を上げるためにチャネル スタックとシリアル化プロセスの両方がスキップされます。  ローカル トランスポート チャネルは、キューを使用してサービス呼び出しをクライアントからサービスに転送し、値をクライアントに返すことによって実装されます。  このサンプルでは、パラメーターと戻り値をシリアル化するのではなく、オブジェクトをコピーします。  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  LocalChannel ソリューションをビルドして実行します。  
+  
+2.  サービス ホストが起動し、クライアントがローカル チャネルを使用してサービスを呼び出します。  コンソール ウィンドウが表示され、サービス呼び出しの結果が示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\LocalChannel`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/loosely-typed-extensions-sample.md b/docs/framework/wcf/samples/loosely-typed-extensions-sample.md
new file mode 100644
index 00000000000..6d35fc1f191
--- /dev/null
+++ b/docs/framework/wcf/samples/loosely-typed-extensions-sample.md
@@ -0,0 +1,176 @@
+---
+title: "弱く型指定された拡張のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56ce265b-8163-4b85-98e7-7692a12c4357
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 弱く型指定された拡張のサンプル
+配信オブジェクト モデルでは、拡張データをさまざまな方法で処理できます。拡張データとは、配信フィードの XML 表現に含まれているが、<xref:System.ServiceModel.Syndication.SyndicationFeed> や <xref:System.ServiceModel.Syndication.SyndicationItem> などのクラスによって明示的に公開されない情報のことです。このサンプルでは、拡張データを処理する基本的な方法を示します。  
+  
+ このサンプルでは、例を示す目的で <xref:System.ServiceModel.Syndication.SyndicationFeed> クラスを使用します。ただし、このサンプルで示すパターンは、拡張データをサポートするすべての配信クラスで使用できます。  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationFeed>  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationItem>  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationCategory>  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationPerson>  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationLink>  
+  
+## サンプル XML  
+ このサンプルで使用される XML ドキュメントは次のとおりです。  
+  
+```  
+<?xml version="1.0" encoding="IBM437"?>  
+<feed myAttribute="someValue" xmlns="http://www.w3.org/2005/Atom">  
+  <title type="text"></title>  
+  <id>uuid:8f60c7b3-a3c0-4de7-a642-2165d77ce3c1;id=1</id>  
+  <updated>2007-09-07T22:15:34Z</updated>  
+  <simpleString xmlns="">hello, world!</simpleString>  
+  <simpleString xmlns="">another simple string</simpleString>  
+  <DataContractExtension xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.d  
+atacontract.org/2004/07/Microsoft.Syndication.Samples">  
+    <Key>X</Key>  
+    <Value>4</Value>  
+  </DataContractExtension>  
+  <XmlSerializerExtension xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://ww  
+w.w3.org/2001/XMLSchema" xmlns="">  
+    <Key>Y</Key>  
+    <Value>8</Value>  
+  </XmlSerializerExtension>  
+  <xElementExtension xmlns="">  
+    <Key attr1="someValue">Z</Key>  
+    <Value attr1="someValue">15</Value>  
+  </xElementExtension>  
+</feed>  
+  
+```  
+  
+ このドキュメントには、次の拡張データが含まれています。  
+  
+-   `<feed>` 要素の `myAttribute` 属性。  
+  
+-   `<simpleString>` 要素。  
+  
+-   `<DataContractExtension>` 要素。  
+  
+-   `<XmlSerializerExtension>` 要素。  
+  
+-   `<xElementExtension>` 要素。  
+  
+## 拡張データの書き込み  
+ 属性の拡張は、次のサンプル コードに示すように、エントリを <xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> コレクションに追加することによって作成されます。  
+  
+```  
+//Attribute extensions are stored in a dictionary indexed by   
+// XmlQualifiedName  
+feed.AttributeExtensions.Add(new XmlQualifiedName("myAttribute", ""), "someValue");  
+  
+```  
+  
+ 要素拡張は、エントリを <xref:System.ServiceModel.Syndication.SyndicationFeed.ElementExtensions%2A> コレクションに追加することによって作成されます。これらの拡張には、文字列などの基本的な値、.NET Framework オブジェクトの XML シリアル化、および手動で入力された XML ノードを指定できます。  
+  
+ 次のサンプル コードでは、`simpleString` という拡張要素が作成されます。  
+  
+```  
+feed.ElementExtensions.Add("simpleString", "", "hello, world!");  
+  
+```  
+  
+ この要素の XML 名前空間は、空の名前空間 \(""\) であり、その値は、"hello, world\!" という文字列が含まれたテキスト ノードになります。  
+  
+ 入れ子になった多数の要素で構成される複雑な要素拡張を作成する方法の 1 つに、次の例に示すように、.NET Framework API をシリアル化に使用する方法があります \(<xref:System.Runtime.Serialization.DataContractSerializer> と <xref:System.Xml.Serialization.XmlSerializer> の両方がサポートされています\)。  
+  
+```  
+feed.ElementExtensions.Add( new DataContractExtension() { Key = "X", Value = 4 } );  
+feed.ElementExtensions.Add( new XmlSerializerExtension { Key = "Y", Value = 8 }, new XmlSerializer( typeof( XmlSerializerExtension ) ) );  
+  
+```  
+  
+ この例の `DataContractExtension` と `XmlSerializerExtension` は、シリアライザで使用するために記述されたカスタム型です。  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationElementExtensionCollection> クラスを使用すると、<xref:System.Xml.XmlReader> インスタンスから要素拡張を作成することもできます。これによって、次のサンプル コードに示すように、<xref:System.Xml.Linq.XElement> などの XML 処理 API と簡単に統合できるようになります。  
+  
+```  
+feed.ElementExtensions.Add(new XElement("xElementExtension",  
+        new XElement("Key", new XAttribute("attr1", "someValue"), "Z"),  
+        new XElement("Value", new XAttribute("attr1", "someValue"),   
+        "15")).CreateReader());  
+  
+```  
+  
+## 拡張データの読み取り  
+ 属性の拡張の値は、次のサンプル コードに示すように、<xref:System.Xml.XmlQualifiedName> を使用して <xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> コレクションの属性を検索することによって取得できます。  
+  
+```  
+Console.WriteLine( feed.AttributeExtensions[ new XmlQualifiedName( "myAttribute", "" )]);  
+  
+```  
+  
+ 要素拡張には、`ReadElementExtensions<T>` メソッドを使用してアクセスします。  
+  
+```  
+foreach( string s in feed2.ElementExtensions.ReadElementExtensions<string>("simpleString", ""))  
+{  
+    Console.WriteLine(s);  
+}  
+  
+foreach (DataContractExtension dce in feed2.ElementExtensions.ReadElementExtensions<DataContractExtension>("DataContractExtension",  
+"http://schemas.datacontract.org/2004/07/SyndicationExtensions"))  
+{  
+    Console.WriteLine(dce.ToString());  
+}  
+  
+foreach (XmlSerializerExtension xse in feed2.ElementExtensions.ReadElementExtensions<XmlSerializerExtension>("XmlSerializerExtension", "", new XmlSerializer(typeof(XmlSerializerExtension))))  
+{  
+    Console.WriteLine(xse.ToString());  
+}  
+  
+```  
+  
+ <xref:System.ServiceModel.Syndication.SyndicationElementExtension.GetReader> メソッドを使用して、個々の要素拡張で `XmlReader` を取得することも可能です。  
+  
+```  
+  
+foreach (SyndicationElementExtension extension in feed2.ElementExtensions.Where<SyndicationElementExtension>(x => x.OuterName == "xElementExtension"))  
+{  
+    XNode xelement = XElement.ReadFrom(extension.GetReader());  
+    Console.WriteLine(xelement.ToString());  
+}  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Syndication\LooselyTypedExtensions`  
+  
+## 参照  
+ [厳密に型指定された拡張](../../../../docs/framework/wcf/samples/strongly-typed-extensions-sample.md)   
+ [WCF 配信](../../../../docs/framework/wcf/feature-details/wcf-syndication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/management.md b/docs/framework/wcf/samples/management.md
new file mode 100644
index 00000000000..1e1940e72ed
--- /dev/null
+++ b/docs/framework/wcf/samples/management.md
@@ -0,0 +1,51 @@
+---
+title: "管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52f4825b-91a2-4f23-94f4-cfd76a7980cf
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 管理
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 管理を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [WCF サービスと Event Tracing for Windows](../../../../docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の分析トレースを使用して、Event Tracing for Windows \(ETW\) でイベントを出力する方法を示します。  
+  
+ [WCF 分析トレース](../../../../docs/framework/wcf/samples/wcf-analytic-tracing.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] の ETW に書き込む分析トレースのストリームに独自のトレース イベントを追加する方法を示します。  
+  
+ [循環トレース](../../../../docs/framework/wcf/samples/circular-tracing.md)  
+ 循環バッファー トレース リスナーの実装を示します。  
+  
+ [ETW トレース](../../../../docs/framework/wcf/samples/etw-tracing.md)  
+ Event Tracing for Windows \(ETW\) を使用してエンドツーエンド \(E2E\) のトレースを実装する方法を示します。  
+  
+ [トレースの拡張](../../../../docs/framework/wcf/samples/extending-tracing.md)  
+ ユーザー定義のアクティビティ トレースをクライアントとサービス コードに記述することにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トレース機能を拡張する方法を示します。  
+  
+ [PII セキュリティ ロックダウン](../../../../docs/framework/wcf/samples/pii-security-lockdown.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの複数のセキュリティ関連機能を制御する方法を示します。  
+  
+ [パフォーマンス カウンターの使用](../../../../docs/framework/wcf/samples/using-performance-counters.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] パフォーマンス カウンターにアクセスする方法と、ユーザー定義のパフォーマンス カウンターを作成する方法を示します。  
+  
+ [トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)  
+ トレースとメッセージ ログを有効にする方法を示します。  
+  
+ [セキュリティ検証](../../../../docs/framework/wcf/samples/security-validation.md)  
+ サービスが特定の条件を満たしていることを確認するカスタム動作を使用して、コンピューター上のサービスを検証する方法を示します。  
+  
+ [WMI プロバイダー](../../../../docs/framework/wcf/samples/wmi-provider.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に組み込まれている Windows Management Instrumentation \(WMI\) プロバイダーを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのデータを実行時に収集する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/media/chunkingchannel1.gif b/docs/framework/wcf/samples/media/chunkingchannel1.gif
new file mode 100644
index 00000000000..da68da02658
Binary files /dev/null and b/docs/framework/wcf/samples/media/chunkingchannel1.gif differ
diff --git a/docs/framework/wcf/samples/media/chunkingchannel2.gif b/docs/framework/wcf/samples/media/chunkingchannel2.gif
new file mode 100644
index 00000000000..eaaaab6db1f
Binary files /dev/null and b/docs/framework/wcf/samples/media/chunkingchannel2.gif differ
diff --git a/docs/framework/wcf/samples/media/iiscertificate-wizard.GIF b/docs/framework/wcf/samples/media/iiscertificate-wizard.GIF
new file mode 100644
index 00000000000..e7810875148
Binary files /dev/null and b/docs/framework/wcf/samples/media/iiscertificate-wizard.GIF differ
diff --git a/docs/framework/wcf/samples/membership-and-role-provider.md b/docs/framework/wcf/samples/membership-and-role-provider.md
new file mode 100644
index 00000000000..f68b4fef6f5
--- /dev/null
+++ b/docs/framework/wcf/samples/membership-and-role-provider.md
@@ -0,0 +1,208 @@
+---
+title: "メンバーシップとロール プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d11a31c-e75f-4fcf-9cf4-b7f26e056bcd
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# メンバーシップとロール プロバイダー
+メンバーシップとロール プロバイダーのサンプルでは、サービスが [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップとロール プロバイダーを使用してクライアントを認証および承認するための方法を示します。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、次の方法を示します。  
+  
+-   クライアントがユーザー名とパスワードの組み合わせを使用して認証する。  
+  
+-   サーバーがクライアント資格情報を [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップ プロバイダーと照合する。  
+  
+-   サーバーがそのサーバーの X.509 証明書を使用して認証される。  
+  
+-   サーバーが [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーを使用して、認証されたクライアントをロールにマップする。  
+  
+-   サーバーが `PrincipalPermissionAttribute` を使用して、サービスによって公開される特定メソッドへのアクセスを制御する。  
+  
+ メンバーシップとロール プロバイダーは、SQL Server によってサポートされるストアを使用するように構成されます。接続文字列と各種オプションは、サービス構成ファイルで指定されます。メンバーシップ プロバイダーの名前は `SqlMembershipProvider` と指定され、ロール プロバイダーの名前は `SqlRoleProvider` と指定されます。  
+  
+```  
+<!-- Set the connection string for SQL Server -->  
+<connectionStrings>  
+  <add name="SqlConn"   
+       connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
+</connectionStrings>  
+  
+<system.web>  
+  <!-- Configure the Sql Membership Provider -->  
+  <membership defaultProvider="SqlMembershipProvider" userIsOnlineTimeWindow="15">  
+    <providers>  
+      <clear />  
+      <add   
+        name="SqlMembershipProvider"   
+        type="System.Web.Security.SqlMembershipProvider"   
+        connectionStringName="SqlConn"  
+        applicationName="MembershipAndRoleProviderSample"  
+        enablePasswordRetrieval="false"  
+        enablePasswordReset="false"  
+        requiresQuestionAndAnswer="false"  
+        requiresUniqueEmail="true"  
+        passwordFormat="Hashed" />  
+    </providers>  
+  </membership>  
+  
+  <!-- Configure the Sql Role Provider -->  
+  <roleManager enabled ="true"   
+               defaultProvider ="SqlRoleProvider" >  
+    <providers>  
+      <add name ="SqlRoleProvider"   
+           type="System.Web.Security.SqlRoleProvider"   
+           connectionStringName="SqlConn"   
+           applicationName="MembershipAndRoleProviderSample"/>  
+    </providers>  
+  </roleManager>  
+</system.web>  
+```  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは Web.config 構成ファイルで定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングの構成には、標準の `wsHttpBinding` が使用されます。既定では、Windows 認証が使用されます。このサンプルは、標準の `wsHttpBinding` を設定してユーザー名認証を使用します。この動作により、サービス認証でサーバー証明書が使用されることが指定されます。サーバー証明書の `SubjectName` には、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) 構成要素の `findValue` 属性と同じ値が指定されている必要があります。さらに、メンバーシップとロール プロバイダーで定義されている名前を指定することにより、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] メンバーシップ プロバイダーによってユーザー名とパスワードの組み合わせによる認証が実行され、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ロール プロバイダーによってロール マップが実行されることが、この動作によって指定されます。  
+  
+```  
+<system.serviceModel>  
+  
+  <protocolMapping>  
+    <add scheme="http" binding="wsHttpBinding" />  
+  </protocolMapping>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!-- Set up a binding that uses Username as the client credential type -->  
+      <binding>  
+        <security mode ="Message">  
+          <message clientCredentialType ="UserName"/>  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior>  
+        <!-- Configure role based authorization to use the Role Provider -->  
+        <serviceAuthorization principalPermissionMode ="UseAspNetRoles"  
+                              roleProviderName ="SqlRoleProvider" />  
+        <serviceCredentials>  
+          <!-- Configure user name authentication to use the Membership Provider -->  
+          <userNameAuthentication userNamePasswordValidationMode ="MembershipProvider"   
+                                  membershipProviderName ="SqlMembershipProvider"/>  
+          <!-- Configure the service certificate -->  
+          <serviceCertificate storeLocation ="LocalMachine"   
+                              storeName ="My"   
+                              x509FindType ="FindBySubjectName"  
+                              findValue ="localhost" />  
+        </serviceCredentials>  
+        <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+        <serviceDebug includeExceptionDetailInFaults="false" />  
+        <serviceMetadata httpGetEnabled="true"/>  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+ このサンプルを実行すると、クライアントは、Alice、Bob、および Charlie の 3 人のユーザー アカウントによる各種サービス操作を呼び出します。操作要求と応答は、クライアントのコンソール ウィンドウに表示されます。ユーザー "Alice" として行われた 4 つの呼び出しはすべて正常に終了します。ユーザー "Bob" には、Divide メソッドの呼び出しを試行したときにアクセス拒否エラーが通知されます。ユーザー "Charlie" には、Multiply メソッドの呼び出しを試行したときにアクセス拒否エラーが通知されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+2.  [ASP.NET アプリケーション サービス データベース](http://go.microsoft.com/fwlink/?LinkId=94997)を構成したことを確認します。  
+  
+    > [!NOTE]
+    >  SQL Server Express Edition を実行している場合、サーバー名は .\\SQLEXPRESS になります。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーション サービス データベースの構成および Web.config ファイルの接続文字列では、このサーバーを使用する必要があります。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ワーカー プロセス アカウントには、この手順で作成されるデータベースに対するアクセス許可が必要です。これを実行するには、sqlcmd ユーティリティまたは SQL Server Management Studio を使用します。  
+  
+3.  サンプルを単一コンピューター構成で実行するか、複数コンピューター構成で実行するかに応じて、次の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  Makecert.exe が存在するフォルダーがパスに含まれていることを確認します。  
+  
+2.  管理特権で実行した Visual Studio コマンド プロンプトで、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なサービス証明書がインストールされます。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。インターネット インフォメーション サービス \(IIS\) 管理ツールを使用して、このディレクトリ用に servicemodelsamples という仮想アプリケーションを作成します。  
+  
+2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。ファイルのコピー先が \\bin サブディレクトリであることを確認します。Setup.bat、GetComputerName.vbs、Cleanup.bat の各ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Web.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+10. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+> [!NOTE]
+>  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。%SERVER\_NAME% 変数はサーバー名を指定します。この変数を変更して、使用するサーバー名を指定します。このバッチ ファイルでの既定は localhost です。  
+  
+     証明書は、LocalMachine ストアの場所の My \(Personal\) ストアに保存されます。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-contracts.md b/docs/framework/wcf/samples/message-contracts.md
new file mode 100644
index 00000000000..92592604d26
--- /dev/null
+++ b/docs/framework/wcf/samples/message-contracts.md
@@ -0,0 +1,36 @@
+---
+title: "メッセージ コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3df7c11-c653-4796-be47-26b09c35b691
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# メッセージ コントラクト
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のメッセージ コントラクトを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [既定のメッセージ コントラクト](../../../../docs/framework/wcf/samples/default-message-contract.md)  
+ ユーザー定義のカスタム メッセージをサービス操作に渡したり、サービス操作から渡されたりするサービスを示します。  
+  
+ [型指定のない要求\/応答](../../../../docs/framework/wcf/samples/untyped-request-reply.md)  
+ Message クラスを使用する操作コントラクトを定義する方法を示します。  
+  
+ [ラップされていないメッセージ](../../../../docs/framework/wcf/samples/unwrapped-messages.md)  
+ ラップされていないメッセージを示します。  既定では、メッセージの本文は、サービス操作に渡されるパラメーターがラップされるように書式設定されます。  
+  
+ [Use および Style プロパティの設定](../../../../docs/framework/wcf/samples/setting-the-use-and-style-properties.md)  
+ <xref:System.ServiceModel.XmlSerializerFormatAttribute> と <xref:System.ServiceModel.DataContractFormatAttribute> で Use および Style プロパティを使用する方法を示します。  
+  
+ [XmlReader サンプル](../../../../docs/framework/wcf/samples/xmlreader-sample.md)  
+ <xref:System.Xml.XmlReader> を使用してメッセージの本文を処理する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-correlation.md b/docs/framework/wcf/samples/message-correlation.md
new file mode 100644
index 00000000000..964c35c89a5
--- /dev/null
+++ b/docs/framework/wcf/samples/message-correlation.md
@@ -0,0 +1,332 @@
+---
+title: "メッセージ相関 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3f62babd-c991-421f-bcd8-391655c82a1f
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# メッセージ相関
+このサンプルでは、メッセージ キュー \(MSMQ\) アプリケーションで MSMQ メッセージを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに送信する方法と、要求または応答のシナリオで、メッセージを送信側のアプリケーションと受信側のアプリケーション間で相互に関連付ける方法を示します。このサンプルでは、msmqIntegrationBinding バインディングを使用します。この場合、サービスは自己ホスト型コンソール アプリケーションで、サービスがキュー内のメッセージを受信したかどうかを監視できます。k  
+  
+ サービスは、送信側からの受信メッセージを処理し、送信側に応答メッセージを返信します。送信側は、受信した応答を、最初に送信した要求に関連付けます。メッセージの `MessageID` プロパティと `CorrelationID` プロパティを使用すると、要求メッセージと応答メッセージが関連付けられます。  
+  
+ `IOrderProcessor` サービス コントラクトは、キューでの使用に適した一方向サービス操作を定義します。MSMQ メッセージには Action ヘッダーがないので、さまざまな MSMQ メッセージを操作コントラクトに自動的にマッピングすることはできません。したがってこの場合、存在する操作コントラクトは 1 つだけです。サービス内に複数の操作コントラクトを定義する場合は、ディスパッチする操作コントラクトを決定するために使用できる、MSMQ メッセージ内のヘッダー \(ラベルや correlationID など\) に関する情報をアプリケーションで提供する必要があります。これについては、「[カスタム Demux](../../../../docs/framework/wcf/samples/custom-demux.md)」を参照してください。  
+  
+ さらに、MSMQ メッセージには、操作コントラクトの別のパラメータにマッピングされるヘッダーに関する情報は含まれません。したがって、操作コントラクトに存在するパラメータは 1 つだけです。パラメータは <xref:System.ServiceModel.MSMQIntegration.MsmqMessage%601> 型の `MsmqMessage<T>` です。これには、基になる MSMQ メッセージが含まれます。`MsmqMessage<T>` クラスの型 "T" は、シリアル化されて MSMQ メッセージ本文に含まれているデータを表します。このサンプルでは、`PurchaseOrder` 型がシリアル化されて MSMQ メッセージ本文になっています。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+[ServiceKnownType(typeof(PurchaseOrder))]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true, Action = "*")]  
+    void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg);  
+}  
+  
+```  
+  
+ このサービス操作は発注書を処理し、サービス コンソール ウィンドウにその発注書の内容と状態を表示します。<xref:System.ServiceModel.OperationBehaviorAttribute> はこの操作を構成してキューを伴うトランザクションに登録し、操作が返されたときにトランザクションに完了とマークします。`PurchaseOrder` には、サービスで処理する必要のある発注の詳細が含まれています。  
+  
+```  
+// Service class that implements the service contract.  
+public class OrderProcessorService : IOrderProcessor  
+{  
+   [OperationBehavior(TransactionScopeRequired = true,   
+          TransactionAutoComplete = true)]  
+   public void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> ordermsg)  
+   {  
+       PurchaseOrder po = (PurchaseOrder)ordermsg.Body;  
+       Random statusIndexer = new Random();  
+       po.Status = PurchaseOrder.OrderStates[statusIndexer.Next(3)];  
+       Console.WriteLine("Processing {0} ", po);  
+       //Send a response to the client that the order has been received   
+         and is pending fullfillment.   
+       SendResponse(ordermsg);  
+    }  
+  
+    private void SendResponse(MsmqMessage<PurchaseOrder> ordermsg)  
+    {  
+        OrderResponseClient client = new OrderResponseClient("OrderResponseEndpoint");  
+  
+        //Set the correlation ID such that the client can correlate the response to the order.  
+        MsmqMessage<PurchaseOrder> orderResponsemsg = new MsmqMessage<PurchaseOrder>(ordermsg.Body);  
+        orderResponsemsg.CorrelationId = ordermsg.Id;  
+        using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+        {  
+            client.SendOrderResponse(orderResponsemsg);  
+            scope.Complete();  
+        }  
+  
+        client.Close();  
+    }  
+}  
+  
+```  
+  
+ サービスは、MSMQ メッセージをキューに送信するためにカスタム クライアント `OrderResponseClient` を使用します。メッセージを受信して処理するアプリケーションが MSMQ アプリケーションであり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションではないので、2 つのアプリケーション間に暗黙のサービス コントラクトはありません。したがって、このシナリオでは Svcutil.exe ツールを使用してプロキシを作成することはできません。  
+  
+ カスタム プロキシは基本的に、`msmqIntegrationBinding` バインディングを使用してメッセージを送信するすべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションで同じです。他のプロキシと異なり、サービス操作の範囲は含まれません。メッセージ送信操作のみです。  
+  
+```  
+  
+[System.ServiceModel.ServiceContractAttribute(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderResponse  
+{  
+  
+    [System.ServiceModel.OperationContractAttribute(IsOneWay = true, Action = "*")]  
+    void SendOrderResponse(MsmqMessage<PurchaseOrder> msg);  
+}  
+  
+public partial class OrderResponseClient : System.ServiceModel.ClientBase<IOrderResponse>, IOrderResponse  
+{  
+  
+    public OrderResponseClient()  
+    { }  
+  
+    public OrderResponseClient(string configurationName)  
+        : base(configurationName)  
+    { }  
+  
+    public OrderResponseClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress address)  
+        : base(binding, address)  
+    { }  
+  
+    public void SendOrderResponse(MsmqMessage<PurchaseOrder> msg)  
+    {  
+        base.Channel.SendOrderResponse(msg);  
+    }  
+}  
+  
+```  
+  
+ サービスは自己ホスト型です。MSMQ 統合トランスポートを使用する場合、使用するキューをあらかじめ作成しておく必要があります。手動で作成することもコードで作成することもできます。このサンプルでは、キューの存在を確認して、必要な場合は作成するための <xref:System.Messaging> コードがサービスに含まれています。キュー名は構成ファイルから読み込まれます。  
+  
+```  
+public static void Main()  
+{  
+       // Get the MSMQ queue name from application settings in configuration.  
+      string queueName =   
+                ConfigurationManager.AppSettings["orderQueueName"];  
+      // Create the transacted MSMQ queue if necessary.  
+      if (!MessageQueue.Exists(queueName))  
+                MessageQueue.Create(queueName, true);  
+     // Create a ServiceHost for the OrderProcessorService type.  
+     using (ServiceHost serviceHost = new   
+                   ServiceHost(typeof(OrderProcessorService)))  
+     {  
+            serviceHost.Open();  
+            // The service can now be accessed.  
+            Console.WriteLine("The service is ready.");  
+            Console.WriteLine("Press <ENTER> to terminate service.");  
+            Console.ReadLine();  
+            // Close the ServiceHost to shutdown the service.  
+            serviceHost.Close();  
+      }  
+}  
+  
+```  
+  
+ 発注要求が送信される MSMQ キューは、構成ファイルの appSettings セクションで指定されます。クライアントおよびサービスのエンドポイントは、構成ファイルの system.serviceModel セクションで定義されます。どちらも `msmqIntegrationbinding` バインディングを指定します。  
+  
+```  
+<appSettings>  
+  <add key="orderQueueName" value=".\private$\Orders" />  
+</appSettings>  
+  
+<system.serviceModel>  
+  <client>  
+    <endpoint    name="OrderResponseEndpoint"   
+              address="msmq.formatname:DIRECT=OS:.\private$\OrderResponse"  
+              binding="msmqIntegrationBinding"  
+              bindingConfiguration="OrderProcessorBinding"   
+              contract="Microsoft.ServiceModel.Samples.IOrderResponse">  
+    </endpoint>  
+  </client>  
+  
+  <services>  
+    <service   
+      name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+      <endpoint address="msmq.formatname:DIRECT=OS:.\private$\Orders"  
+                            binding="msmqIntegrationBinding"  
+                bindingConfiguration="OrderProcessorBinding"   
+                contract="Microsoft.ServiceModel.Samples.IOrderProcessor">  
+      </endpoint>  
+    </service>  
+  </services>  
+  
+  <bindings>  
+    <msmqIntegrationBinding>  
+      <binding name="OrderProcessorBinding" >  
+        <security mode="None" />  
+      </binding>  
+    </msmqIntegrationBinding>  
+  </bindings>  
+  
+</system.serviceModel>  
+  
+```  
+  
+ クライアント アプリケーションは <xref:System.Messaging> を使用して、非揮発性メッセージとトランザクション メッセージをキューに送信します。メッセージの本文には発注書が含まれます。  
+  
+```  
+static void PlaceOrder()  
+{  
+    //Connect to the queue  
+    MessageQueue orderQueue =   
+            new MessageQueue(  
+                    ConfigurationManager.AppSettings["orderQueueName"])   
+    // Create the purchase order.  
+    PurchaseOrder po = new PurchaseOrder();  
+    po.CustomerId = "somecustomer.com";  
+    po.PONumber = Guid.NewGuid().ToString();  
+    PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+    lineItem1.ProductId = "Blue Widget";  
+    lineItem1.Quantity = 54;  
+    lineItem1.UnitCost = 29.99F;  
+  
+    PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+    lineItem2.ProductId = "Red Widget";  
+    lineItem2.Quantity = 890;  
+    lineItem2.UnitCost = 45.89F;  
+  
+    po.orderLineItems = new PurchaseOrderLineItem[2];  
+    po.orderLineItems[0] = lineItem1;  
+    po.orderLineItems[1] = lineItem2;  
+  
+    Message msg = new Message();  
+    msg.UseDeadLetterQueue = true;  
+    msg.Body = po;  
+  
+    //Create a transaction scope.  
+    using (TransactionScope scope = new      
+     TransactionScope(TransactionScopeOption.Required))  
+    {  
+        // Submit the purchase order.  
+        orderQueue.Send(msg, MessageQueueTransactionType.Automatic);  
+        // Complete the transaction.  
+        scope.Complete();  
+    }  
+    //Save the messageID for order response correlation.  
+    orderMessageID = msg.Id;  
+    Console.WriteLine("Placed the order, waiting for response...");  
+}  
+  
+```  
+  
+ 発注の応答を受信する MSMQ キューは、構成ファイルの appSettings セクションで指定されます。次のサンプル構成を参照してください。  
+  
+> [!NOTE]
+>  キュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイント アドレスでは msmq.formatname スキームが指定され、ローカル コンピューターを表す "localhost" が使用されます。URI の msmq.formatname の後には、MSMQ ガイドラインに沿って正しく書式設定された形式名が続きます。  
+  
+```  
+<appSettings>  
+    <add key=" orderResponseQueueName" value=".\private$\Orders" />  
+</appSettings>  
+```  
+  
+ クライアント アプリケーションは、サービスに送信する発注要求メッセージの `messageID` を保存し、サービスからの応答を待機します。応答がキューに到着すると、クライアントは発注メッセージの `correlationID` プロパティを使用して、送信した発注メッセージと応答を関連付けます。このプロパティには、クライアントが最初にサービスに送信した発注メッセージの `messageID` が含まれています。  
+  
+```  
+static void DisplayOrderStatus()  
+{  
+    MessageQueue orderResponseQueue = new   
+     MessageQueue(ConfigurationManager.AppSettings              
+                  ["orderResponseQueueName"]);  
+    //Create a transaction scope.  
+    bool responseReceived = false;  
+    orderResponseQueue.MessageReadPropertyFilter.CorrelationId = true;  
+    while (!responseReceived)  
+    {  
+       Message responseMsg;  
+       using (TransactionScope scope2 = new    
+         TransactionScope(TransactionScopeOption.Required))  
+       {  
+          //Receive the Order Response message.  
+          responseMsg =   
+              orderResponseQueue.Receive  
+                   (MessageQueueTransactionType.Automatic);  
+          scope2.Complete();  
+     }  
+     responseMsg.Formatter = new   
+     System.Messaging.XmlMessageFormatter(new Type[] {   
+         typeof(PurchaseOrder) });  
+     PurchaseOrder responsepo = (PurchaseOrder)responseMsg.Body;  
+    //Check if the response is for the order placed.  
+    if (orderMessageID == responseMsg.CorrelationId)  
+    {  
+       responseReceived = true;  
+       Console.WriteLine("Status of current Order: OrderID-{0},Order   
+            Status-{1}", responsepo.PONumber, responsepo.Status);  
+    }  
+    else  
+    {  
+       Console.WriteLine("Status of previous Order: OrderID-{0},Order    
+            Status-{1}", responsepo.PONumber, responsepo.Status);  
+    }  
+  }  
+}  
+  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信し、クライアントに応答を返信するアクティビティを参照できます。クライアントでは、サービスから受信した応答が表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+> [!NOTE]
+>  このサンプルを実行するには、メッセージ キュー \(MSMQ\) がインストールされている必要があります。インストールの手順については、「参照」セクションを参照してください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。キューが存在しない場合、サービスによってキューが作成されます。最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、「`ServiceModelSamplesTransacted`」と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービスのプログラム ファイルを、言語固有のフォルダーにある \\service\\bin\\ フォルダーからサービス コンピューターにコピーします。  
+  
+2.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+3.  Client.exe.config ファイルを開き、orderQueueName を変更して "." の代わりにサービス コンピューター名を指定します。  
+  
+4.  Service.exe.config ファイルで、クライアント エンドポイントのアドレスを変更して "." の代わりにクライアント コンピューター名を指定します。  
+  
+5.  サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+6.  クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\MSMQIntegration\MessageCorrelation`  
+  
+## 参照  
+ [WCF でのキュー](../../../../docs/framework/wcf/feature-details/queuing-in-wcf.md)   
+ [メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=94968)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-encoder-extensibility.md b/docs/framework/wcf/samples/message-encoder-extensibility.md
new file mode 100644
index 00000000000..1d3eee8cee9
--- /dev/null
+++ b/docs/framework/wcf/samples/message-encoder-extensibility.md
@@ -0,0 +1,27 @@
+---
+title: "メッセージ エンコーダー拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 842cccc5-4e6b-4c69-a28b-a827c6918df5
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# メッセージ エンコーダー拡張
+このセクションには、カスタム メッセージ エンコーディングを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [カスタム メッセージ エンコーダー : カスタム テキスト エンコーダー](../../../../docs/framework/wcf/samples/custom-message-encoder-custom-text-encoder.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用してカスタム テキスト メッセージ エンコーダーを実装する方法を示します。  
+  
+ [カスタム メッセージ エンコーダー : 圧縮エンコーダー](../../../../docs/framework/wcf/samples/custom-message-encoder-compression-encoder.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] プラットフォームを使用するカスタム エンコーダを実装する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-inspectors.md b/docs/framework/wcf/samples/message-inspectors.md
new file mode 100644
index 00000000000..90f2f7cbc4b
--- /dev/null
+++ b/docs/framework/wcf/samples/message-inspectors.md
@@ -0,0 +1,427 @@
+---
+title: "メッセージ インスペクター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9bd1f305-ad03-4dd7-971f-fa1014b97c9b
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# メッセージ インスペクター
+このサンプルでは、クライアントとサービスのメッセージ インスペクタを実装して構成する方法を示します。  
+  
+ メッセージ インスペクタは拡張オブジェクトで、サービス モデルのクライアント ランタイムで使用し、プログラムまたは構成を使用してランタイムをディスパッチします。それにより、受信後または送信前にメッセージの検査および変更を行うことができます。  
+  
+ このサンプルでは、クライアントとサービスの基本的なメッセージ検証機構を実装します。この機構は、構成可能な XML スキーマ ドキュメント セットに照らして受信メッセージを検証します。このサンプルでのメッセージ検証は、操作ごとに行われません。これは意図的に単純化されたサンプルであるためです。  
+  
+## メッセージ インスペクタ  
+ クライアント メッセージ インスペクタには、<xref:System.ServiceModel.Dispatcher.IClientMessageInspector> インターフェイスが実装され、サービス メッセージ インスペクタには <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector> インターフェイスが実装されます。こうした実装を 1 つのクラスに結合すると、クライアントとサービスの両方で使用できるメッセージ インスペクタとして設定できます。このサンプルでは、このように結合されたメッセージ インスペクタを実装します。このインスペクタは、受信メッセージと送信メッセージが検証されるスキーマ セットを渡すように構築されます。開発者はインスペクタを使用して、受信メッセージまたは送信メッセージを検証するかどうか、およびインスペクタをディスパッチ モードとクライアント モードのどちらにするかを指定できます。この指定内容は、このトピックで後述するようにエラー処理に影響します。  
+  
+```  
+  
+public class SchemaValidationMessageInspector : IClientMessageInspector, IDispatchMessageInspector  
+{  
+    XmlSchemaSet schemaSet;  
+    bool validateRequest;  
+    bool validateReply;  
+    bool isClientSide;  
+    [ThreadStatic]  
+    bool isRequest;  
+  
+    public SchemaValidationMessageInspector(XmlSchemaSet schemaSet,  
+         bool validateRequest, bool validateReply, bool isClientSide)  
+    {  
+        this.schemaSet = schemaSet;  
+        this.validateReply = validateReply;  
+        this.validateRequest = validateRequest;  
+        this.isClientSide = isClientSide;  
+    }  
+```  
+  
+ サービス \(ディスパッチャ\) メッセージ インスペクタには、<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.AfterReceiveRequest%2A> と <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.BeforeSendReply%28System.ServiceModel.Channels.Message%40%2CSystem.Object%29> の、2 つの <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector> メソッドを実装する必要があります。  
+  
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.AfterReceiveRequest%2A> がディスパッチャによって呼び出されるのは、メッセージが到着してチャネル スタックで処理され、サービスに割り当てられたときですが、メッセージが逆シリアル化されて操作にディスパッチされる前です。受信メッセージが暗号化されていた場合、そのメッセージはメッセージ インスペクタに到着するときには既に復号化されています。このメソッドは、参照パラメータとして渡された `request` メッセージを取得します。これにより、必要に応じてメッセージを調査、操作または置き換えることができます。戻り値は任意のオブジェクトで、サービスが現在のメッセージに応答を返すときに <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.BeforeSendReply%2A> に渡される相関状態オブジェクトとして使用されます。サンプルでは、<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.AfterReceiveRequest%2A> はメッセージの検査 \(検証\) をプライベートでローカルのメソッド `ValidateMessageBody` に代行させ、相関状態オブジェクトを返しません。このメソッドは、無効なメッセージがサービスに渡されないようにします。  
+  
+```  
+object IDispatchMessageInspector.AfterReceiveRequest(ref System.ServiceModel.Channels.Message request, System.ServiceModel.IClientChannel channel, System.ServiceModel.InstanceContext instanceContext)  
+{  
+    if (validateRequest)  
+    {  
+        // inspect the message. If a validation error occurs,  
+        // the thrown fault exception bubbles up.  
+        ValidateMessageBody(ref request, true);  
+    }  
+    return null;  
+}  
+```  
+  
+ <xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.BeforeSendReply%28System.ServiceModel.Channels.Message%40%2CSystem.Object%29> は、応答がクライアントに返送される準備が完了するたびに呼び出されます。一方向メッセージの場合は、受信メッセージが処理されるときに呼び出されます。これにより、この拡張機能は MEP に関係なく対称的に呼び出されるものと想定できます。<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.AfterReceiveRequest%2A> と同様に、メッセージは参照パラメータとして渡され、検査、変更、または置き換えを行うことができます。このサンプルで実行されるメッセージの検証も、同様に `ValidMessageBody` メソッドで代行されますが、この場合、検証エラーの処理は若干異なります。  
+  
+ サービスで検証エラーが発生すると、`ValidateMessageBody` メソッドは <xref:System.ServiceModel.FaultException> から派生した例外をスローします。<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.AfterReceiveRequest%2A> では、これらの例外をサービス モデル インフラストラクチャに格納できます。例外はここで自動的に SOAP エラーに変換され、クライアントに転送されます。<xref:System.ServiceModel.Dispatcher.IDispatchMessageInspector.BeforeSendReply%2A> では、<xref:System.ServiceModel.FaultException> 例外はインフラストラクチャに格納できません。メッセージ インスペクタが呼び出される前に、サービスによってスローされたエラー例外が変換されるためです。したがって、次の実装では、既知の `ReplyValidationFault` 例外がキャッチされ、応答メッセージが明示的なエラー メッセージに置き換えられます。このメソッドは、無効なメッセージがサービス実装によって返されないようにします。  
+  
+```  
+  
+void IDispatchMessageInspector.BeforeSendReply(ref System.ServiceModel.Channels.Message reply, object correlationState)  
+{  
+    if (validateReply)  
+    {  
+        // Inspect the reply, catch a possible validation error   
+        try  
+        {  
+            ValidateMessageBody(ref reply, false);  
+        }  
+        catch (ReplyValidationFault fault)  
+        {  
+            // if a validation error occurred, the message is replaced  
+            // with the validation fault.  
+            reply = Message.CreateMessage(reply.Version,   
+                    fault.CreateMessageFault(), reply.Headers.Action);  
+        }  
+    }  
+```  
+  
+ クライアント メッセージ インスペクタも、これとよく似ています。<xref:System.ServiceModel.Dispatcher.IClientMessageInspector> からは、<xref:System.ServiceModel.Dispatcher.IClientMessageInspector.AfterReceiveReply%2A> および <xref:System.ServiceModel.Dispatcher.IClientMessageInspector.BeforeSendRequest%2A> の 2 つのメソッドが実装される必要があります。  
+  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageInspector.BeforeSendRequest%2A> は、クライアント アプリケーションまたは操作フォーマッタのどちらかでメッセージが作成されたときに呼び出されます。ディスパッチャ メッセージ インスペクタと同様、メッセージを検査することも、または完全に置き換えることもできます。このサンプルのインスペクタは、ディスパッチ メッセージ インスペクタにも使用されている、同じローカルの `ValidateMessageBody` ヘルパー メソッドに代行させます。  
+  
+ \(コンストラクタで指定される\) クライアント検証とサービス検証間の動作上の違いは、クライアント検証はユーザー コードに格納するローカル例外をスローする点です。この例外はローカルに発生するもので、サービス エラーではないためです。通常のルールでは、サービス ディスパッチャ インスペクタがエラーをスローするのに対し、クライアント インスペクタは例外をスローします。  
+  
+ この <xref:System.ServiceModel.Dispatcher.IClientMessageInspector.BeforeSendRequest%2A> の実装は、無効なメッセージがサービスに送信されないようにします。  
+  
+```  
+object IClientMessageInspector.BeforeSendRequest(ref System.ServiceModel.Channels.Message request, System.ServiceModel.IClientChannel channel)  
+{  
+    if (validateRequest)  
+    {  
+        ValidateMessageBody(ref request, true);  
+    }  
+    return null;  
+}  
+```  
+  
+ `AfterReceiveReply` の実装は、サービスから受信された無効なメッセージがクライアント ユーザー コードに転送されないようにします。  
+  
+```  
+void IClientMessageInspector.AfterReceiveReply(ref System.ServiceModel.Channels.Message reply, object correlationState)  
+{  
+    if (validateReply)  
+    {  
+        ValidateMessageBody(ref reply, false);  
+    }  
+}  
+```  
+  
+ この特定のメッセージ インスペクタの中心となるのが `ValidateMessageBody` メソッドです。この動作を実行するには、渡されるメッセージ本文のコンテンツのサブツリーを、<xref:System.Xml.XmlReader> 検証でラップします。リーダーには、メッセージ インスペクタが保持するスキーマ セットが設定され、検証コールバックは、このメソッドと共に定義される `InspectionValidationHandler` を参照するデリゲートに設定されます。この検証を実行するためにメッセージが読み取られ、メモリ ストリームを基にする <xref:System.Xml.XmlDictionaryWriter> にスプールされます。この処理中に検証エラーまたは警告が発生した場合は、コールバック メソッドが呼び出されます。  
+  
+ エラーが発生しない場合、プロパティとヘッダーが元のメッセージからコピーされた、新しいメッセージが作成されます。このメッセージにはメモリ ストリーム内の現在検証した Infoset が使用され、<xref:System.Xml.XmlDictionaryReader> でラップされて置換メッセージに追加されます。  
+  
+```  
+  
+void ValidateMessageBody(ref System.ServiceModel.Channels.Message message, bool isRequest)  
+{  
+    if (!message.IsFault)  
+    {  
+        XmlDictionaryReaderQuotas quotas =   
+                new XmlDictionaryReaderQuotas();  
+        XmlReader bodyReader =   
+            message.GetReaderAtBodyContents().ReadSubtree();  
+        XmlReaderSettings wrapperSettings =   
+                              new XmlReaderSettings();  
+        wrapperSettings.CloseInput = true;  
+        wrapperSettings.Schemas = schemaSet;  
+        wrapperSettings.ValidationFlags =   
+                                XmlSchemaValidationFlags.None;  
+        wrapperSettings.ValidationType = ValidationType.Schema;  
+        wrapperSettings.ValidationEventHandler += new   
+           ValidationEventHandler(InspectionValidationHandler);  
+        XmlReader wrappedReader = XmlReader.Create(bodyReader,   
+                                            wrapperSettings);  
+  
+        // pull body into a memory backed writer to validate  
+        this.isRequest = isRequest;  
+        MemoryStream memStream = new MemoryStream();  
+        XmlDictionaryWriter xdw =  
+              XmlDictionaryWriter.CreateBinaryWriter(memStream);  
+        xdw.WriteNode(wrappedReader, false);  
+        xdw.Flush(); memStream.Position = 0;  
+        XmlDictionaryReader xdr =   
+        XmlDictionaryReader.CreateBinaryReader(memStream, quotas);  
+  
+        // reconstruct the message with the validated body  
+        Message replacedMessage =   
+            Message.CreateMessage(message.Version, null, xdr);  
+        replacedMessage.Headers.CopyHeadersFrom(message.Headers);  
+        replacedMessage.Properties.CopyProperties(message.Properties);  
+        message = replacedMessage;  
+    }  
+}  
+```  
+  
+ `InspectionValidationHandler` メソッドは、スキーマの検証エラーまたは警告が発生するたびに、<xref:System.Xml.XmlReader> 検証によって呼び出されます。次の実装はエラーにのみ対応し、すべての警告を無視します。  
+  
+ 最初は、<xref:System.Xml.XmlReader> 検証をメッセージ インスペクタを使用してメッセージに挿入し、メッセージの処理時にメッセージをバッファ処理することなく検証できるように思えます。ただし、この場合、このコールバックがサービス モデル インフラストラクチャの任意の場所に検証例外をスローするか、またはユーザー コードが無効な XML ノードとして検出され、その結果、予測不可能な動作になります。バッファ処理の方法により、ユーザー コードは無効なメッセージから完全にシールドされます。  
+  
+ これまでに説明したように、ハンドラによってスローされる例外は、クライアントとサービスとでは異なります。サービスでの例外は <xref:System.ServiceModel.FaultException> から派生し、クライアントでの例外は標準のカスタム例外です。  
+  
+```  
+        void InspectionValidationHandler(object sender, ValidationEventArgs e)  
+{  
+    if (e.Severity == XmlSeverityType.Error)  
+    {  
+        // We are treating client and service side validation errors  
+        // differently here. Client side errors cause exceptions  
+        // and are thrown straight up to the user code. Service side  
+        // validations cause faults.  
+        if (isClientSide)  
+        {  
+            if (isRequest)  
+            {  
+                throw new RequestClientValidationException(e.Message);  
+            }  
+            else  
+            {  
+                throw new ReplyClientValidationException(e.Message);  
+            }  
+        }  
+        else  
+        {  
+            if (isRequest)  
+            {  
+                // this fault is caught by the ServiceModel   
+                // infrastructure and turned into a fault reply.  
+                throw new RequestValidationFault(e.Message);  
+             }  
+             else  
+             {  
+                // this fault is caught and turned into a fault message  
+                // in BeforeSendReply in this class  
+                throw new ReplyValidationFault(e.Message);  
+              }  
+          }  
+      }  
+    }  
+```  
+  
+## 動作  
+ メッセージ インスペクタは、クライアント ランタイムまたはディスパッチ ランタイムに対する拡張機能です。こうした拡張機能は、*動作*を使用して構成されます。動作はサービス モデル ランタイムの動作を変更するクラスです。この変更は、既定の構成を変更するか、または拡張機能 \(メッセージ インスペクタなど\) を追加したりすることによって行われます。  
+  
+ 次の `SchemaValidationBehavior` クラスは、このサンプルのメッセージ インスペクタをクライアント ランタイムまたはディスパッチ ランタイムに追加するときに使用される動作です。この実装は、どちらの場合でも基本的な実装です。<xref:System.ServiceModel.Description.IEndpointBehavior.ApplyClientBehavior%2A> と <xref:System.ServiceModel.Description.IEndpointBehavior.ApplyDispatchBehavior%2A> ではメッセージ インスペクタが作成され、それぞれのランタイムの <xref:System.ServiceModel.Dispatcher.ClientRuntime.MessageInspectors%2A> コレクションに追加されます。  
+  
+```  
+public class SchemaValidationBehavior : IEndpointBehavior  
+{  
+    XmlSchemaSet schemaSet;   
+    bool validateRequest;   
+    bool validateReply;  
+  
+    public SchemaValidationBehavior(XmlSchemaSet schemaSet, bool   
+                           inspectRequest, bool inspectReply)  
+    {  
+        this.schemaSet = schemaSet;  
+        this.validateReply = inspectReply;  
+        this.validateRequest = inspectRequest;  
+    }  
+    #region IEndpointBehavior Members  
+  
+    public void AddBindingParameters(ServiceEndpoint endpoint,   
+       System.ServiceModel.Channels.BindingParameterCollection   
+                                            bindingParameters)  
+    {  
+    }  
+  
+    public void ApplyClientBehavior(ServiceEndpoint endpoint,   
+            System.ServiceModel.Dispatcher.ClientRuntime clientRuntime)  
+    {  
+        SchemaValidationMessageInspector inspector =   
+           new SchemaValidationMessageInspector(schemaSet,   
+                      validateRequest, validateReply, true);  
+            clientRuntime.MessageInspectors.Add(inspector);  
+    }  
+  
+    public void ApplyDispatchBehavior(ServiceEndpoint endpoint,   
+         System.ServiceModel.Dispatcher.EndpointDispatcher   
+                                          endpointDispatcher)  
+    {  
+        SchemaValidationMessageInspector inspector =   
+           new SchemaValidationMessageInspector(schemaSet,   
+                        validateRequest, validateReply, false);  
+   endpointDispatcher.DispatchRuntime.MessageInspectors.Add(inspector);  
+    }  
+  
+   public void Validate(ServiceEndpoint endpoint)  
+   {  
+   }  
+  
+    #endregion  
+}  
+```  
+  
+> [!NOTE]
+>  この特定の動作は属性の代わりにはなりません。したがって、サービス型のコントラクト型に宣言して追加することはできません。これは設計上の判断です。スキーマ コレクションを属性の宣言で読み込むことはできず、この属性で他の構成場所 \(アプリケーション設定など\) を参照することによって、残りのサービス モデル構成と一貫性を持たない構成要素が作成されるからです。したがって、この動作は、強制的にコードおよびサービス モデル構成の拡張を使用してのみ追加できます。  
+  
+## 構成を使用したメッセージ インスペクタの追加  
+ アプリケーション構成ファイルでエンドポイントでのカスタム動作を構成するには、<xref:System.ServiceModel.Configuration.BehaviorExtensionElement> から派生するクラスによって表される構成の*拡張要素*を、サービス モデルに作成するための実装オブジェクトが必要です。次に、この拡張機能を拡張用のサービス モデルの構成セクションに追加する必要があります。このセクションで説明する拡張機能を参照してください。  
+  
+```  
+<system.serviceModel>  
+…  
+   <extensions>  
+      <behaviorExtensions>  
+        <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null"/>  
+      </behaviorExtensions>  
+    </extensions>  
+…  
+</system.serviceModel>  
+```  
+  
+ 拡張機能は、アプリケーションまたは ASP.NET の構成ファイルに追加できます。これが最も一般的な選択肢ですが、コンピュータ上の構成ファイルに追加することもできます。  
+  
+ 拡張機能を構成範囲に追加すると、次のコードに示すように、動作を動作の構成に追加できるようになります。動作の構成は再使用可能な要素で、必要に応じて複数のエンドポイントに適用できます。ここで構成される特定の動作は <xref:System.ServiceModel.Description.IEndpointBehavior> を実装するので、構成ファイルの各構成セクションでのみ有効です。  
+  
+```  
+<system.serviceModel>  
+   <behaviors>  
+      …  
+     <endpointBehaviors>  
+        <behavior name="HelloServiceEndpointBehavior">  
+          <schemaValidator validateRequest="True" validateReply="True">  
+            <schemas>  
+              <add location="messages.xsd" />    
+            </schemas>  
+          </schemaValidator>  
+        </behavior>  
+      </endpointBehaviors>  
+      …  
+    </behaviors>  
+</system.serviceModel>  
+```  
+  
+ メッセージ インスペクタを構成する `<schemaValidator>` 要素は、`SchemaValidationBehaviorExtensionElement` クラスによってサポートされます。このクラスは、`ValidateRequest` と `ValidateReply` という 2 つのブール型パブリック プロパティを公開します。これらのプロパティは、どちらも <xref:System.Configuration.ConfigurationPropertyAttribute> でマークされます。この属性は、コードのプロパティと XML 属性との間のリンクを構成するもので、前の XML 構成要素に含まれています。このクラスには、追加で <xref:System.Configuration.ConfigurationCollectionAttribute> でマークされる、`SchemaCollection` 型のプロパティ `Schemas` もあります。これもこのサンプルに含まれていますが、このドキュメントでは簡略化のために省略されています。このプロパティは、コレクションおよびコレクション要素クラス `SchemaConfigElement` と共に、前の構成スニペット内の `<schemas>` 要素を補足し、スキーマのコレクションを検証セットに追加できるようにします。  
+  
+ ランタイムがクライアントまたはエンドポイントを構築するときにその構成データを評価する場合、オーバーライドされた `CreateBehavior` メソッドにより、構成データは動作オブジェクトになります。  
+  
+```  
+public class SchemaValidationBehaviorExtensionElement : BehaviorExtensionElement  
+{  
+    public SchemaValidationBehaviorExtensionElement()  
+    {  
+    }  
+  
+    public override Type BehaviorType   
+    {   
+        get  
+        {  
+            return typeof(SchemaValidationBehavior);  
+        }   
+    }  
+  
+    protected override object CreateBehavior()  
+    {  
+        XmlSchemaSet schemaSet = new XmlSchemaSet();  
+        foreach (SchemaConfigElement schemaCfg in this.Schemas)  
+        {  
+            Uri baseSchema = new   
+                Uri(AppDomain.CurrentDomain.BaseDirectory);  
+            string location = new   
+                Uri(baseSchema,schemaCfg.Location).ToString();  
+            XmlSchema schema =   
+                XmlSchema.Read(new XmlTextReader(location), null);  
+            schemaSet.Add(schema);  
+        }  
+     return new   
+     SchemaValidationBehavior(schemaSet,ValidateRequest,ValidateReply);  
+    }  
+  
+[ConfigurationProperty("validateRequest",DefaultValue=false,IsRequired=false)]  
+public bool ValidateRequest  
+{  
+    get { return (bool)base["validateRequest"]; }  
+    set { base["validateRequest"] = value; }  
+}  
+  
+[ConfigurationProperty("validateReply", DefaultValue = false, IsRequired = false)]  
+        public bool ValidateReply  
+        {  
+            get { return (bool)base["validateReply"]; }  
+            set { base["validateReply"] = value; }  
+        }  
+  
+     //Declare the Schema collection property.  
+     //Note: the "IsDefaultCollection = false" instructs   
+     //.NET Framework to build a nested section of   
+     //the kind <Schema> ...</Schema>.  
+    [ConfigurationProperty("schemas", IsDefaultCollection = true)]  
+    [ConfigurationCollection(typeof(SchemasCollection),  
+        AddItemName = "add",  
+        ClearItemsName = "clear",  
+        RemoveItemName = "remove")]  
+    public SchemasCollection Schemas  
+    {  
+        get  
+        {  
+            SchemasCollection SchemasCollection =  
+            (SchemasCollection)base["schemas"];  
+            return SchemasCollection;  
+        }  
+    }  
+}  
+```  
+  
+## メッセージ インスペクタの強制的な追加  
+ 属性 \(このサンプルでは前の理由により未サポート\) と構成を使用せず、極力簡単に動作をクライアント ランタイムとサービス ランタイムに追加するには、強制コードを使用できます。このサンプルでは、クライアント アプリケーションで強制コードを使用して、クライアント メッセージ インスペクタをテストします。`GenericClient` クラスは、エンドポイント構成をユーザー コードに対して公開する <xref:System.ServiceModel.ClientBase%601> から派生しています。クライアントが暗黙に開かれる前に、エンドポイント構成は変更できます。たとえば、次のコードで示すように動作を追加します。サービスに動作を追加する方法は、ここで示すクライアントの手法と非常に似ており、サービス ホストが開かれる前に実行する必要があります。  
+  
+```  
+try  
+{  
+    Console.WriteLine("*** Call 'Hello' with generic client, with client behavior");  
+    GenericClient client = new GenericClient();  
+  
+    // Configure client programmatically, adding behavior  
+    XmlSchema schema = XmlSchema.Read(new StreamReader("messages.xsd"),   
+                                                          null);  
+    XmlSchemaSet schemaSet = new XmlSchemaSet();  
+    schemaSet.Add(schema);  
+    client.Endpoint.Behaviors.Add(new   
+                SchemaValidationBehavior(schemaSet, true, true));  
+  
+    Console.WriteLine("--- Sending valid client request:");  
+    GenericCallValid(client, helloAction);  
+    Console.WriteLine("--- Sending invalid client request:");  
+    GenericCallInvalid(client, helloAction);  
+  
+    client.Close();  
+}  
+catch (Exception e)  
+{  
+    DumpException(e);  
+}  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\MessageInspectors`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-queueing-integration.md b/docs/framework/wcf/samples/message-queueing-integration.md
new file mode 100644
index 00000000000..59140bca251
--- /dev/null
+++ b/docs/framework/wcf/samples/message-queueing-integration.md
@@ -0,0 +1,33 @@
+---
+title: "メッセージ キュー統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8d2b47a0-5d51-45b5-9633-b62e064e8ea4
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# メッセージ キュー統合
+このセクションには、メッセージ キューと [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の間の統合を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation へのメッセージ キュー](../../../../docs/framework/wcf/samples/message-queuing-to-wcf.md)  
+ メッセージ キュー \(MSMQ\) アプリケーションで MSMQ メッセージを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに送信する方法を示します。  
+  
+ [カスタム Demux](../../../../docs/framework/wcf/samples/custom-demux.md)  
+ MSMQ メッセージ ヘッダーをさまざまなサービス操作にマッピングする方法を通して、<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding> を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスで複数のサービス操作を使用できることを示します。  
+  
+ [Windows Communication Foundation でのメッセージ キュー](../../../../docs/framework/wcf/samples/wcf-to-message-queuing.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションでメッセージをメッセージ キュー \(MSMQ\) アプリケーションに送信する方法を示します。  
+  
+ [メッセージ相関](../../../../docs/framework/wcf/samples/message-correlation.md)  
+ メッセージ キュー \(MSMQ\) アプリケーションで MSMQ メッセージを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに送信する方法と、要求または応答のシナリオで、メッセージを送信側のアプリケーションと受信側のアプリケーション間で相互に関連付ける方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-queuing-to-wcf.md b/docs/framework/wcf/samples/message-queuing-to-wcf.md
new file mode 100644
index 00000000000..18415ea6b6c
--- /dev/null
+++ b/docs/framework/wcf/samples/message-queuing-to-wcf.md
@@ -0,0 +1,171 @@
+---
+title: "Windows Communication Foundation へのメッセージ キュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d718eb0-9f61-4653-8a75-d2dac8fb3520
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# Windows Communication Foundation へのメッセージ キュー
+このサンプルでは、メッセージ キュー \(MSMQ\) アプリケーションで MSMQ メッセージを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに送信する方法について説明します。サービスは、自己ホスト型コンソール アプリケーションで、サービスがキュー内のメッセージを受信したかどうかを監視できます。  
+  
+ サービス コントラクトは `IOrderProcessor` です。これは、キューでの使用に適した一方向サービスを定義します。MSMQ メッセージには Action ヘッダーがないので、さまざまな MSMQ メッセージを操作コントラクトに自動的にマッピングすることはできません。したがって、存在する操作コントラクトは 1 つだけです。サービスに対して複数の操作コントラクトを定義する場合は、ディスパッチする操作コントラクトを決定するために使用できる、MSMQ メッセージ内のヘッダー \(ラベルや correlationID など\) に関する情報をアプリケーションで提供する必要があります。これについては、「[カスタム Demux](../../../../docs/framework/wcf/samples/custom-demux.md)」を参照してください。  
+  
+ MSMQ メッセージには、操作コントラクトの別のパラメータにマッピングされるヘッダーに関する情報は含まれません。パラメータは <xref:System.ServiceModel.MsmqIntegration.MsmqMessage%601> 型の `MsmqMessage<T>` です。これには、基になる MSMQ メッセージが含まれます。<xref:System.ServiceModel.MsmqIntegration.MsmqMessage%601> \(`MsmqMessage<T>`\) クラスの型 "T" は、シリアル化されて MSMQ メッセージ本文に含まれているデータを表します。このサンプルでは、`PurchaseOrder` 型がシリアル化されて MSMQ メッセージ本文になっています。  
+  
+ 発注書処理サービスのサービス コントラクトを次のサンプル コードに示します。  
+  
+```  
+// Define a service contract.  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+[ServiceKnownType(typeof(PurchaseOrder))]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true, Action = "*")]  
+    void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg);  
+}  
+  
+```  
+  
+ サービスは自己ホスト型です。MSMQ を使用する場合、使用するキューをあらかじめ作成しておく必要があります。手動で作成することもコードで作成することもできます。このサンプルでは、サービスはキューの存在を確認し、必要な場合はキューを作成します。キュー名は構成ファイルから読み込まれます。  
+  
+```  
+public static void Main()  
+{  
+    // Get the MSMQ queue name from the application settings in   
+    // configuration.  
+    string queueName = ConfigurationManager.AppSettings["queueName"];  
+    // Create the MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName, true);  
+    …  
+}  
+  
+```  
+  
+ サービスは、`OrderProcessorService` の <xref:System.ServiceModel.ServiceHost> を作成して開きます。次のサンプル コードを参照してください。  
+  
+```  
+using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))  
+{  
+    serviceHost.Open();  
+    Console.WriteLine("The service is ready.");  
+    Console.WriteLine("Press <ENTER> to terminate service.");  
+    Console.ReadLine();  
+    serviceHost.Close();  
+}  
+  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションに指定されます。次のサンプル構成を参照してください。  
+  
+> [!NOTE]
+>  キュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイント アドレスでは msmq.formatname スキームが指定され、ローカル コンピューターを表す localhost が使用されます。それぞれの MSMQ 形式名のアドレス指定ガイドラインに対するキューのアドレスが msmq.formatname スキームの後に続きます。  
+  
+```  
+<appSettings>  
+    <add key="orderQueueName" value=".\private$\Orders" />  
+</appSettings>  
+  
+```  
+  
+ クライアント アプリケーションは MSMQ アプリケーションです。このアプリケーションでは <xref:System.Messaging.MessageQueue.Send%2A> メソッドを使用して、非揮発性メッセージとトランザクション メッセージをキューに送信します。次のサンプル コードを参照してください。  
+  
+```  
+//Connect to the queue.  
+MessageQueue orderQueue = new MessageQueue(ConfigurationManager.AppSettings["orderQueueName"]);  
+  
+// Create the purchase order.  
+PurchaseOrder po = new PurchaseOrder();  
+po.CustomerId = "somecustomer.com";  
+po.PONumber = Guid.NewGuid().ToString();  
+  
+PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+lineItem1.ProductId = "Blue Widget";  
+lineItem1.Quantity = 54;  
+lineItem1.UnitCost = 29.99F;  
+  
+PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+lineItem2.ProductId = "Red Widget";  
+lineItem2.Quantity = 890;  
+lineItem2.UnitCost = 45.89F;  
+  
+po.orderLineItems = new PurchaseOrderLineItem[2];  
+po.orderLineItems[0] = lineItem1;  
+po.orderLineItems[1] = lineItem2;  
+  
+// Submit the purchase order.  
+Message msg = new Message();  
+msg.Body = po;  
+//Create a transaction scope.  
+using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+{  
+  
+    orderQueue.Send(msg, MessageQueueTransactionType.Automatic);  
+    // Complete the transaction.  
+    scope.Complete();  
+  
+}  
+Console.WriteLine("Placed the order:{0}", po);  
+Console.WriteLine("Press <ENTER> to terminate client.");  
+Console.ReadLine();  
+  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信するようすがわかります。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。たとえば、クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。キューが存在しない場合、サービスによってキューが作成されます。最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、「`ServiceModelSamplesTransacted`」と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービスのプログラム ファイルを、言語固有のフォルダーにある \\service\\bin\\ フォルダーからサービス コンピューターにコピーします。  
+  
+2.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+3.  Client.exe.config ファイルを開き、orderQueueName を変更して "." の代わりにサービス コンピューター名を指定します。  
+  
+4.  サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+5.  クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\MSMQIntegration\MsmqToWcf`  
+  
+## 参照  
+ [WCF のキュー](../../../../docs/framework/wcf/feature-details/queues-in-wcf.md)   
+ [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)   
+ [メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=94968)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-anonymous.md b/docs/framework/wcf/samples/message-security-anonymous.md
new file mode 100644
index 00000000000..1224f13eddc
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-anonymous.md
@@ -0,0 +1,259 @@
+---
+title: "メッセージ セキュリティ匿名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WS セキュリティ"
+ms.assetid: c321cbf9-8c05-4cce-b5a5-4bf7b230ee03
+caps.latest.revision: 52
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 52
+---
+# メッセージ セキュリティ匿名
+メッセージ セキュリティ匿名のサンプルでは、クライアント認証を行わないでメッセージ レベルのセキュリティを使用するが、サーバーの X.509 証明書を使用したサーバー認証を必要とする [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションを実装する方法を示します。  クライアント\/サーバー間のすべてのアプリケーション メッセージは署名され、暗号化されます。  このサンプルは、「[WSHttpBinding](../../../../docs/framework/wcf/samples/wshttpbinding.md)」のサンプルに基づいています。  このサンプルは、クライアント コンソール プログラム \(.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(.dll\) で構成されています。  サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、電卓インターフェイスに、クライアントが認証されなかった場合に `True` を返す新しい操作を追加します。  
+  
+```  
+public class CalculatorService : ICalculator  
+{  
+    public bool IsCallerAnonymous()  
+    {  
+        // ServiceSecurityContext.IsAnonymous returns true if the caller is not authenticated.  
+        return ServiceSecurityContext.Current.IsAnonymous;  
+    }  
+    ...  
+}  
+  
+```  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル \(Web.config\) で定義します。  エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。  このバインディングの構成には `wsHttpBinding` バインディングを使用します。  `wsHttpBinding` バインディングの既定のセキュリティ モードは `Message` です。  `clientCredentialType` 属性が `None` に設定されています。  
+  
+```  
+<system.serviceModel>  
+  
+  <protocolMapping>  
+    <add scheme="http" binding="wsHttpBinding" />  
+  </protocolMapping>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+     <!--   
+     <!--This configuration defines the security mode as Message and-->  
+     <!--the clientCredentialType as None. This mode provides -- >  
+     <!--server authentication only using the service certificate.-->  
+  
+     <binding>  
+       <security mode="Message">  
+         <message clientCredentialType="None" />  
+       </security>  
+     </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  ...  
+</system.serviceModel>  
+```  
+  
+ サービス認証で使用される資格情報は、[\<behavior\>](../../../../docs/framework/configure-apps/file-schema/wcf/behavior-of-endpointbehaviors.md)で指定されます。  サーバー証明書の `SubjectName` には、`findValue` 属性に指定されている値と同じ値が指定されている必要があります。次のサンプル コードを参照してください。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior>  
+      <!--   
+    The serviceCredentials behavior allows you to define a service certificate.  
+    A service certificate is used by a client to authenticate the service and provide message protection.  
+    This configuration references the "localhost" certificate installed during the setup instructions.  
+    -->  
+      <serviceCredentials>  
+        <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+      </serviceCredentials>  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。  `wsHttpBinding` バインディングのクライアント セキュリティ モードは `Message` です。  `clientCredentialType` 属性が `None` に設定されています。  
+  
+```  
+<system.serviceModel>  
+  <client>  
+    <endpoint name=""  
+             address="http://localhost/servicemodelsamples/service.svc"   
+             binding="wsHttpBinding"   
+             behaviorConfiguration="ClientCredentialsBehavior"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  </client>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!--This configuration defines the security mode as -->  
+      <!--Message and the clientCredentialType as None. -->  
+      <binding name="Binding1">  
+        <security mode = "Message">  
+          <message clientCredentialType="None"/>  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>   
+  ...  
+</system.serviceModel>  
+```  
+  
+ このサンプルでは、サービスの証明書を認証するために、<xref:System.ServiceModel.Security.X509ServiceCertificateAuthentication.CertificateValidationMode%2A> を <xref:System.ServiceModel.Security.X509CertificateValidationMode> に設定します。  これは、`behaviors` セクションのクライアントの App.config ファイルで行われます。  つまり、証明書がユーザーの Trusted People ストア内に存在している場合、その証明書は発行者のチェーンが検証されることなく信頼されます。  証明機関 \(CA\) から発行された証明書を要求しなくともサンプルを実行できるようにするため、ここでは便宜上この設定が使用されます。  この設定は、既定の ChainTrust よりも安全性が低くなります。  `PeerOrChainTrust` を製品版のコードで使用する前に、この設定のセキュリティへの影響について慎重に考慮する必要があります。  
+  
+ クライアント実装によって `IsCallerAnonymous` メソッドの呼び出しが追加されます。それ以外に、[WSHttpBinding](../../../../docs/framework/wcf/samples/wshttpbinding.md) サンプルとの違いはありません。  
+  
+```  
+// Create a client with a client endpoint configuration.  
+CalculatorClient client = new CalculatorClient();  
+  
+// Call the GetCallerIdentity operation.  
+Console.WriteLine("IsCallerAnonymous returned: {0}", client.IsCallerAnonymous());  
+  
+// Call the Add service operation.  
+double value1 = 100.00D;  
+double value2 = 15.99D;  
+double result = client.Add(value1, value2);  
+Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+...  
+  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+Console.WriteLine();  
+Console.WriteLine("Press <ENTER> to terminate client.");  
+Console.ReadLine();  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+IsCallerAnonymous returned: True  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ メッセージ セキュリティ匿名サンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、証明書ベースのセキュリティを必要とするホスト アプリケーションを実行できるようになります。  バッチ ファイルの実行には 2 つのモードを使用できます。  バッチ ファイルを単一コンピューター モードで実行するには、コマンド ラインに「`setup.bat`」と入力します。  サービス モードで実行するには、「`setup.bat service`」と入力します。  このサンプルを複数のコンピューターで実行している場合は、このモードを使用します。  詳細については、このトピック末尾のセットアップ手順を参照してください。  
+  
+ 次に、バッチ ファイルの各セクションの概要を簡単に説明します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+     %SERVER\_NAME% 変数はサーバー名を指定します。  証明書は LocalMachine ストアに保存されます。  セットアップ バッチ ファイルの実行にサービスの引数 \(`setup.bat service` など\) が使用された場合、%SERVER\_NAME% にはコンピューターの完全修飾ドメイン名が含まれます。  それ以外の場合、既定値は localhost です。  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+  
+    ```  
+  
+-   証明書の秘密キーに関する権限の付与。  
+  
+     Setup.bat バッチ ファイルの次の行は、LocalMachine ストアに保存されたサーバー証明書を [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ワーカー プロセス アカウントでアクセスできるようにします。  
+  
+    ```  
+    echo ************  
+    echo setting privileges on server certificates  
+    echo ************  
+    for /F "delims=" %%i in ('"%MSSDK%\bin\FindPrivateKey.exe" My LocalMachine -n CN^=%SERVER_NAME% -a') do set PRIVATE_KEY_FILE=%%i set WP_ACCOUNT=NT AUTHORITY\NETWORK SERVICE  
+    (ver | findstr "5.1") && set WP_ACCOUNT=%COMPUTERNAME%\ASPNET  
+    echo Y|cacls.exe "%PRIVATE_KEY_FILE%" /E /G "%WP_ACCOUNT%":R  
+    iisreset  
+  
+    ```  
+  
+> [!NOTE]
+>  英語 \(米国\) 以外の  言語で Windows を使用している場合は、Setup.bat ファイルを編集し、`NT AUTHORITY\NETWORK SERVICE` アカウント名を現在の地域に適した名前に変更してください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  Makecert.exe と FindPrivateKey.exe が含まれているフォルダーがパスに含まれていることを確認します。  
+  
+2.  管理特権で実行した Visual Studio コマンド プロンプトで、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  セットアップ バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。  path 環境変数が SDK のインストール ディレクトリを指している必要があります。  この環境変数は、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトで自動設定されます。  
+  
+3.  サービスへのアクセスを検証します。ブラウザーにアドレス「http:\/\/localhost\/servicemodelsamples\/service.svc」を入力します。  
+  
+4.  Client.exe を \\client\\bin で起動します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+5.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。  インターネット インフォメーション サービス \(IIS\) 管理ツールを使用して、このディレクトリ用に servicemodelsamples という仮想アプリケーションを作成します。  
+  
+2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。  ファイルのコピー先が \\bin サブディレクトリであることを確認します。  Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。  Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。  `setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Web.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。  これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+10. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+> [!NOTE]
+>  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。  複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。  削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com.` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-binding.md b/docs/framework/wcf/samples/message-security-binding.md
new file mode 100644
index 00000000000..2ef16c966e5
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-binding.md
@@ -0,0 +1,33 @@
+---
+title: "メッセージ セキュリティ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4570ce7-864e-461b-85d8-0f7bcc53c2c8
+caps.latest.revision: 4
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 4
+---
+# メッセージ セキュリティ バインディング
+このセクションには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の Windows サービスのメッセージ セキュリティ バインディングを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [メッセージ セキュリティ匿名](../../../../docs/framework/wcf/samples/message-security-anonymous.md)  
+ このサンプルでは、クライアント認証を行わないでメッセージ レベルのセキュリティを使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509 証明書を使用するサーバー認証が必要です。  
+  
+ [メッセージ セキュリティ証明書](../../../../docs/framework/wcf/samples/message-security-certificate.md)  
+ このサンプルでは、クライアントの認証で X.509 v3 証明書による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509 v3 証明書を使用するサーバー認証が必要です。  
+  
+ [メッセージ セキュリティ ユーザー名](../../../../docs/framework/wcf/samples/message-security-user-name.md)  
+ このサンプルでは、クライアントのユーザー名認証による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509v3 証明書を使用するサーバー認証が必要です。  
+  
+ [メッセージ セキュリティ Windows](../../../../docs/framework/wcf/samples/message-security-windows.md)  
+ このサンプルでは、Windows 認証によるメッセージ レベルのセキュリティを使用するよう <xref:System.ServiceModel.WSHttpBinding> バインディングを構成する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-certificate.md b/docs/framework/wcf/samples/message-security-certificate.md
new file mode 100644
index 00000000000..887b9cdd2b7
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-certificate.md
@@ -0,0 +1,351 @@
+---
+title: "メッセージ セキュリティ証明書 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WS セキュリティ"
+ms.assetid: 909333b3-35ec-48f0-baff-9a50161896f6
+caps.latest.revision: 51
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 51
+---
+# メッセージ セキュリティ証明書
+このサンプルでは、クライアントの認証で X.509 v3 証明書による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509 v3 証明書を使用するサーバー認証が必要です。このサンプルでは、クライアント\/サーバー間のすべてのアプリケーション メッセージが署名されて暗号化される、既定の設定を使用します。このサンプルは、「[WSHttpBinding](../../../../docs/framework/wcf/samples/wshttpbinding.md)」に基づいており、クライアント コンソール プログラムと、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリで構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、構成を使用した認証の制御、およびセキュリティ コンテキストから呼び出し側の ID を取得する方法を示しています。次のサンプル コードを参照してください。  
+  
+```  
+public class CalculatorService : ICalculator  
+{  
+    public string GetCallerIdentity()  
+    {  
+        // The client certificate is not mapped to a Windows identity by default.  
+        // ServiceSecurityContext.PrimaryIdentity is populated based on the information  
+        // in the certificate that the client used to authenticate itself to the service.  
+        return ServiceSecurityContext.Current.PrimaryIdentity.Name;  
+    }  
+    ...  
+}  
+```  
+  
+ サービスは、そのサービスとの通信に使用する 1 つのエンドポイントと、WS\-MetadataExchange プロトコルを使用してサービスの WSDL ドキュメントを公開する 1 つのエンドポイントを公開します。これらのエンドポイントは構成ファイル \(Web.config\) で定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングは、標準の [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) 要素で構成されます。既定では、メッセージ セキュリティが使用されます。このサンプルでは、クライアント認証が必要な証明書に `clientCredentialType` 属性を設定します。  
+  
+```  
+<system.serviceModel>  
+    <protocolMapping>  
+      <add scheme="http" binding="wsHttpBinding"/>  
+    </protocolMapping>  
+    <bindings>  
+      <wsHttpBinding>  
+        <!--   
+        This configuration defines the security mode as Message and   
+        the clientCredentialType as Certificate.  
+        -->  
+        <binding>  
+          <security mode ="Message">  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--   
+        The serviceCredentials behavior allows one to define a service certificate.  
+        A service certificate is used by the service to authenticate itself to its clients and to provide message protection.  
+        This configuration references the "localhost" certificate installed during the setup instructions.  
+        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+            <clientCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </clientCertificate>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+  
+```  
+  
+ この動作により、クライアントがサービスを認証する際に使用される、サービスの資格情報が指定されます。サーバー証明書のサブジェクト名は、[\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md) 要素の `findValue` 属性で指定されます。  
+  
+```  
+<!--For debugging purposes, set the includeExceptionDetailInFaults attribute to true.-->  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--   
+        The serviceCredentials behavior allows one to define a service certificate.  
+        A service certificate is used by the service to authenticate itself to its clients and to provide message protection.  
+        This configuration references the "localhost" certificate installed during the setup instructions.  
+        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+            <clientCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </clientCertificate>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+```  
+  
+ クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、適切なセキュリティ モードおよび認証モードで構成されます。複数コンピューターのシナリオで実行する場合は、サービスのエンドポイント アドレスが適切に変更されていることを確認してください。  
+  
+```  
+<system.serviceModel>  
+    <client>  
+      <!-- Use a behavior to configure the client certificate to present to the service. -->  
+      <endpoint address="http://localhost/servicemodelsamples/service.svc" binding="wsHttpBinding" bindingConfiguration="Binding1" behaviorConfiguration="ClientCertificateBehavior" contract="Microsoft.Samples.Certificate.ICalculator"/>  
+    </client>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <!--   
+        This configuration defines the security mode as Message and   
+        the clientCredentialType as Certificate.  
+        -->  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+...  
+</system.serviceModel>  
+  
+```  
+  
+ クライアントの実装により、構成ファイルまたコードを使用して、使用する証明書が設定されます。次のサンプルでは、使用する証明書を構成ファイルで設定する方法を示します。  
+  
+```  
+<system.serviceModel>  
+  ...  
+  
+<behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientCertificateBehavior">  
+          <!--   
+        The clientCredentials behavior allows one to define a certificate to present to a service.  
+        A certificate is used by a client to authenticate itself to the service and provide message integrity.  
+        This configuration references the "client.com" certificate installed during the setup instructions.  
+        -->  
+          <clientCredentials>  
+            <clientCertificate findValue="client.com" storeLocation="CurrentUser" storeName="My" x509FindType="FindBySubjectName"/>  
+            <serviceCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certificate authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust"/>  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  
+</system.serviceModel>  
+  
+```  
+  
+ 次のサンプルでは、プログラムでサービスを呼び出す方法を示します。  
+  
+```  
+// Create a client.  
+CalculatorClient client = new CalculatorClient();  
+  
+// Call the GetCallerIdentity service operation.  
+Console.WriteLine(client.GetCallerIdentity());  
+...  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+CN=client.com  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Press <ENTER> to terminate client.  
+```  
+  
+ メッセージ セキュリティ サンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してクライアントとサーバーを構成し、証明書ベースのセキュリティを必要とするホスト アプリケーションを実行できるようになります。バッチ ファイルの実行には 3 つのモードを使用できます。単一コンピューター モードで実行するには、Visual Studio コマンド プロンプトで「**setup.bat**」と入力します。同様に、サービス モードの場合は「**setup.bat service**」と入力し、クライアント モードの場合は「**setup.bat client**」と入力します。このサンプルを複数のコンピューターで実行している場合は、クライアントおよびサーバー モードを使用します。詳細については、このトピック末尾のセットアップ手順を参照してください。次に、バッチ ファイルのセクションのうち、適切な構成で実行するために変更が必要となる部分を示します。  
+  
+-   クライアント証明書の作成。  
+  
+     バッチ ファイルの次の行では、クライアント証明書を作成します。指定されたクライアント名が、作成される証明書のサブジェクト名に使用されます。証明書は、`CurrentUser` ストアの場所の `My` ストアに格納されます。  
+  
+    ```  
+    echo ************  
+    echo making client cert  
+    echo ************  
+    makecert.exe -sr CurrentUser -ss MY -a sha1 -n CN=%CLIENT_NAME% -sky exchange -pe  
+    ```  
+  
+-   サーバーの信頼された証明書ストアへのクライアント証明書のインストール。  
+  
+     バッチ ファイルの次の行では、クライアント証明書をサーバーの TrustedPeople ストアにコピーし、サーバーが信頼\/非信頼を判断できるようにします。TrustedPeople ストアにインストールされた証明書が [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに信頼されるには、クライアント証明書の検証モードを `PeerOrChainTrust` または `PeerTrust` に設定する必要があります。前のサービス構成サンプルを参照して、構成ファイルを使用してこれを行う手順を確認してください。  
+  
+    ```  
+    echo ************  
+    echo copying client cert to server's LocalMachine store  
+    echo ************  
+    certmgr.exe -add -r CurrentUser -s My -c -n %CLIENT_NAME% -r LocalMachine -s TrustedPeople   
+    ```  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+     %SERVER\_NAME% 変数はサーバー名を指定します。証明書は LocalMachine ストアに保存されます。Setup.bat バッチ ファイルの実行にサービスの引数 \(**setup.bat service** など\) が使用された場合、%SERVER\_NAME% にはコンピューターの完全修飾ドメイン名が含まれます。それ以外の場合、既定値は localhost です。  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+-   証明書の秘密キーに関する権限の付与。  
+  
+     Setup.bat ファイルの次の行は、LocalMachine ストアに保存されたサーバー証明書を [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ワーカー プロセス アカウントでアクセスできるようにします。  
+  
+    ```  
+    echo ************  
+    echo setting privileges on server certificates  
+    echo ************  
+    for /F "delims=" %%i in ('"%ProgramFiles%\ServiceModelSampleTools\FindPrivateKey.exe" My LocalMachine -n CN^=%SERVER_NAME% -a') do set PRIVATE_KEY_FILE=%%i  
+    set WP_ACCOUNT=NT AUTHORITY\NETWORK SERVICE  
+    (ver | findstr /C:"5.1") && set WP_ACCOUNT=%COMPUTERNAME%\ASPNET  
+    echo Y|cacls.exe "%PRIVATE_KEY_FILE%" /E /G "%WP_ACCOUNT%":R  
+    iisreset  
+    ```  
+  
+    > [!NOTE]
+    >  英語 \(米国\) 以外の言語で Windows を使用している場合は、Setup.bat ファイルを編集し、"NT AUTHORITY\\NETWORK SERVICE" アカウント名を現在の地域に適した名前に変更してください。  
+  
+> [!NOTE]
+>  このバッチ ファイルで使用されるツールは、C:\\Program Files\\Microsoft Visual Studio 8\\Common7\\tools または C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\bin にあります。これらのディレクトリのうちいずれか 1 つは、システム パスにする必要があります。Visual Studio がインストールされている場合は、Visual Studio コマンド プロンプトを開いて、このディレクトリを簡単にパスに配置できます。**\[スタート\]**をクリックし、**\[すべてのプログラム\]**、**\[Visual Studio 2012\]**、**\[ツール\]** の順にクリックします。このコマンド プロンプトには、適切なパスが既に設定されています。設定されていない場合は、適切なディレクトリをパスに手動で追加する必要があります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\MessageSecurity`  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権を使用して Visual Studio コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、Visual Studio コマンド プロンプトから実行します。path 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Visual Studio コマンド プロンプト \(2010\) で自動設定されます。  
+  
+2.  サービスへのアクセスを検証します。ブラウザーにアドレス「`http://localhost/servicemodelsamples/service.svc`」を入力します。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。インターネット インフォメーション サービス \(IIS\) 管理ツールを使用して、このディレクトリ用に servicemodelsamples という仮想アプリケーションを作成します。  
+  
+2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。ファイルのコピー先が \\bin サブディレクトリであることを確認します。また Setup.bat、Cleanup.bat、ImportClientCert.bat の各ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、**setup.bat service** を実行します。**setup.bat** に **service** 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Web.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、**setup.bat client** を実行します。**setup.bat** に **client** 引数を指定して実行すると、client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+9. クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。  
+  
+10. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+11. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+12. サーバー上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportClientCert.bat を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+13. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-over-message-queuing.md b/docs/framework/wcf/samples/message-security-over-message-queuing.md
new file mode 100644
index 00000000000..df4fcc95546
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-over-message-queuing.md
@@ -0,0 +1,359 @@
+---
+title: "メッセージ キューを介したメッセージ セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 329aea9c-fa80-45c0-b2b9-e37fd7b85b38
+caps.latest.revision: 22
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 22
+---
+# メッセージ キューを介したメッセージ セキュリティ
+このサンプルでは、クライアントの認証で X.509v3 証明書による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509v3 証明書を MSMQ 経由で使用するサーバー認証が必要です。MSMQ ストア内のメッセージの暗号化を保持したり、アプリケーションで独自のメッセージ認証を実行できるようにするには、メッセージ セキュリティの使用が望ましい場合があります。  
+  
+ このサンプルは、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」のサンプルに基づいています。メッセージは暗号化されて署名されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。キューが存在しない場合、サービスによってキューが作成されます。最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、「`ServiceModelSamplesTransacted`」と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  Makecert.exe と FindPrivateKey.exe を格納するフォルダーがパスに含まれていることを確認します。  
+  
+2.  Setup.bat をサンプルのインストール フォルダで実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  サンプルの実行後は、Cleanup.bat を実行して証明書を削除してください。他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+3.  Service.exe を \\service\\bin で起動します。  
+  
+4.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+5.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  Setup.bat、Cleanup.bat、ImportClientCert.bat の各ファイルをサービス コンピューターにコピーします。  
+  
+2.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+3.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+4.  サーバーで `setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+5.  サービスの service.exe.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+6.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+7.  クライアントで `setup.bat client` を実行します。`setup.bat` に `client` 引数を指定して実行すると、client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。さらに、サービス証明書の名前を、サービス コンピューターの完全修飾ドメイン名 \(`clientCredentials` の下にある `serviceCertificate` の `defaultCertificate` 要素の `findValue` 属性\) と同じ名前に変更する必要があります。  
+  
+9. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+10. クライアントで `ImportServiceCert.bat` を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+11. サーバーで `ImportClientCert.bat` を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+12. サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+13. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 必要条件  
+ このサンプルでは、MSMQ がインストールされて実行中であることが必要です。  
+  
+## 使用例  
+ クライアントは、サービスの公開キーを使用してメッセージを暗号化し、独自の証明書を使用してメッセージ署名を行います。キューからのメッセージを読み込むサービスは、信頼されたユーザーのストア内の証明書を使用して、クライアント証明書を認証します。次にメッセージを復号化し、サービス操作にディスパッチします。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] メッセージは MSMQ メッセージの本文のペイロードとして送信されるので、メッセージ本文は MSMQ ストアで暗号化されたまま残ります。これによりメッセージは、望ましくない公開から保護されます。MSMQ 自体では、送信されるメッセージが暗号化されているかどうかは認識されません。  
+  
+ このサンプルは、MSMQ でメッセージ レベルの相互認証を使用する方法を示します。証明書は、帯域外で交換されます。サービスとクライアントは同時に実行される必要がないため、キューに置かれたアプリケーションでは常にその状態です。  
+  
+## 説明  
+ クライアントとサービス コードのこのサンプルは、1 つの違いを除き、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」と同じです。操作コントラクトには、メッセージの署名および暗号化が必要であることを示す注釈が保護レベルで付けられます。  
+  
+```  
+// Define a service contract.   
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true, ProtectionLevel=ProtectionLevel.EncryptAndSign)]  
+    void SubmitPurchaseOrder(PurchaseOrder po);  
+}  
+```  
+  
+ メッセージが、サービスとクライアントの識別に必要なトークンを使用してセキュリティ保護されるには、App.config に資格情報を格納する必要があります。  
+  
+ クライアント構成では、サービスを認証するサービス証明書を指定します。また、LocalMachine のストアを信頼されるストアとして使用し、サービスの有効性を信頼します。さらに、クライアントのサービス認証用として、メッセージに関連付けられたクライアント証明書を指定します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  
+  <system.serviceModel>  
+  
+    <client>  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint address="net.msmq://localhost/private/ServiceModelSamplesMessageSecurity"   
+                binding="netMsmqBinding"   
+                bindingConfiguration="messageSecurityBinding"  
+                contract="Microsoft.ServiceModel.Samples.IOrderProcessor"  
+                behaviorConfiguration="ClientCertificateBehavior" />  
+    </client>  
+  
+    <bindings>  
+        <netMsmqBinding>  
+            <binding name="messageSecurityBinding">  
+                <security mode="Message">  
+                    <message clientCredentialType="Certificate"/>  
+                </security>  
+            </binding>  
+        </netMsmqBinding>  
+    </bindings>  
+  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientCertificateBehavior">  
+          <!--   
+        The clientCredentials behavior allows one to define a certificate to present to a service.  
+        A certificate is used by a client to authenticate itself to the service and provide message integrity.  
+        This configuration references the "client.com" certificate installed during the setup instructions.  
+        -->  
+          <clientCredentials>  
+            <clientCertificate findValue="client.com" storeLocation="CurrentUser" storeName="My" x509FindType="FindBySubjectName" />  
+            <serviceCertificate>  
+                <defaultCertificate findValue="localhost" storeLocation="CurrentUser" storeName="TrustedPeople" x509FindType="FindBySubjectName"/>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it is trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ セキュリティ モードが Message に設定されている場合は、ClientCredentialType は Certificate に設定されることに注意してください。  
+  
+ サービス構成には、サービスの資格情報を指定するサービス動作が含まれます。この資格情報は、クライアントがサービスを認証する際に使用されます。サーバー証明書のサブジェクト名は、[\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md)の `findValue` 属性で指定されています。  
+  
+```  
+  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  
+  <appSettings>  
+    <!-- Use appSetting to configure MSMQ queue name. -->  
+    <add key="queueName" value=".\private$\ServiceModelSamplesMessageSecurity" />  
+  </appSettings>  
+  
+  <system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.OrderProcessorService"  
+          behaviorConfiguration="PurchaseOrderServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- Define NetMsmqEndpoint -->  
+        <endpoint address="net.msmq://localhost/private/ServiceModelSamplesMessageSecurity"  
+                  binding="netMsmqBinding"  
+                  bindingConfiguration="messageSecurityBinding"  
+                  contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+        <!-- The mex endpoint is exposed at http://localhost:8000/ServiceModelSamples/service/mex. -->  
+        <endpoint address="mex"  
+                  binding="mexHttpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+        <netMsmqBinding>  
+            <binding name="messageSecurityBinding">  
+                <security mode="Message">  
+                    <message clientCredentialType="Certificate" />  
+                </security>  
+            </binding>  
+        </netMsmqBinding>  
+    </bindings>  
+  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="PurchaseOrderServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <!--   
+               The serviceCredentials behavior allows one to define a service certificate.  
+               A service certificate is used by the service to authenticate itself to its clients and to provide message protection.  
+               This configuration references the "localhost" certificate installed during the setup instructions.  
+          -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+            <clientCertificate>  
+                <certificate findValue="client.com" storeLocation="LocalMachine" storeName="TrustedPeople" x509FindType="FindBySubjectName"/>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it is trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </clientCertificate>  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+</configuration>  
+  
+```  
+  
+ このサンプルは、構成を使用した認証の制御、およびセキュリティ コンテキストから呼び出し側の ID を取得する方法を示しています。次のサンプル コードを参照してください。  
+  
+```  
+    // Service class which implements the service contract.  
+    // Added code to write output to the console window.  
+    public class OrderProcessorService : IOrderProcessor  
+    {  
+        private string GetCallerIdentity()  
+        {  
+            // The client certificate is not mapped to a Windows identity by default.  
+            // ServiceSecurityContext.PrimaryIdentity is populated based on the information  
+            // in the certificate that the client used to authenticate itself to the service.  
+            return ServiceSecurityContext.Current.PrimaryIdentity.Name;  
+        }  
+  
+        [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+        public void SubmitPurchaseOrder(PurchaseOrder po)  
+        {  
+            Console.WriteLine("Client's Identity {0} ", GetCallerIdentity());  
+            Orders.Add(po);  
+            Console.WriteLine("Processing {0} ", po);  
+        }  
+  //…  
+}  
+```  
+  
+ 実行時、サービス コードにはクライアント ID が表示されます。サービス コードからの出力サンプルを次に示します。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Client's Identity CN=client.com; ECA6629A3C695D01832D77EEE836E04891DE9D3C  
+Processing Purchase Order: 6536e097-da96-4773-9da3-77bab4345b5d  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+```  
+  
+## 説明  
+  
+-   クライアント証明書の作成。  
+  
+     バッチ ファイルの次の行では、クライアント証明書を作成します。指定されたクライアント名が、作成される証明書のサブジェクト名に使用されます。証明書は、`CurrentUser` ストアの場所の `My` ストアに格納されます。  
+  
+    ```  
+    echo ************  
+    echo making client cert  
+    echo ************  
+    makecert.exe -sr CurrentUser -ss MY -a sha1 -n CN=%CLIENT_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   クライアント証明書のサーバーの信頼された証明書ストアへのインストール。  
+  
+     バッチ ファイルの次の行では、クライアント証明書をサーバーの TrustedPeople ストアにコピーし、サーバーが信頼\/非信頼を判断できるようにします。TrustedPeople ストアにインストールされた証明書が [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスに信頼されるには、クライアント証明書の検証モードの値を `PeerOrChainTrust` または `PeerTrust` に設定する必要があります。前のサービス構成サンプルを参照して、構成ファイルを使用してこれを行う手順を確認してください。  
+  
+    ```  
+    echo ************  
+    echo copying client cert to server's LocalMachine store  
+    echo ************  
+    certmgr.exe -add -r CurrentUser -s My -c -n %CLIENT_NAME% -r LocalMachine -s TrustedPeople  
+  
+    ```  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+     %SERVER\_NAME% 変数はサーバー名を指定します。証明書は LocalMachine ストアに保存されます。セットアップ バッチ ファイルの実行にサービスの引数 \(`setup.bat service` など\) が使用された場合、%SERVER\_NAME% にはコンピューターの完全修飾ドメイン名が含まれます。それ以外の場合、既定値は localhost です。  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+    > [!NOTE]
+    >  英語 \(米国\) 以外の言語で Microsoft Windows を使用している場合は、Setup.bat ファイルを編集し、"NT AUTHORITY\\NETWORK SERVICE" アカウント名を現在の地域に適した名前に変更してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\MessageSecurity`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-sample.md b/docs/framework/wcf/samples/message-security-sample.md
new file mode 100644
index 00000000000..212fbe867ae
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-sample.md
@@ -0,0 +1,188 @@
+---
+title: "メッセージ セキュリティ サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82444166-6288-493a-85d4-85f43f134d19
+caps.latest.revision: 33
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 33
+---
+# メッセージ セキュリティ サンプル
+このサンプルでは、`basicHttpBinding` とメッセージ セキュリティを使用するアプリケーションを実装する方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ `basicHttpBinding` のセキュリティ モードの値は、`Message`、`Transport`、`TransportWithMessageCredential`、`TransportCredentialOnly`、および `None` に設定できます。サービスのサンプルの App.config ファイルでは、エンドポイント定義によって `basicHttpBinding` が指定され、`Binding1` という名前のバインディング構成が参照されます。次のサンプル構成を参照してください。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+     <!-- This endpoint is exposed at the base address provided by -->  
+     <!-- host: http://localhost:8000/ServiceModelSamples/service.-->  
+     <endpoint address=""  
+               binding="basicHttpBinding"  
+               bindingConfiguration="Binding1"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>   …  
+</system.serviceModel>  
+```  
+  
+ このバインディング構成では、[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-basichttpbinding.md)の `mode` 属性を `Message` に設定し、[\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-of-basichttpbinding.md)の `clientCredentialType` 属性を `Certificate` に設定します。次のサンプル構成を参照してください。  
+  
+```  
+<bindings>  
+  <basicHttpBinding>  
+    <!--   
+        This configuration defines the SecurityMode as Message and   
+        the clientCredentialType as Certificate.  
+        -->  
+    <binding name="Binding1" >  
+      <security mode = "Message">  
+        <message clientCredentialType="Certificate"/>  
+      </security>  
+    </binding>  
+  </basicHttpBinding>  
+</bindings>  
+```  
+  
+ サービスがクライアントに対してサービス自体を認証するために使用する証明書は、`serviceCredentials` 要素の下にある構成ファイルの behaviors セクションで設定されます。クライアントがサービスに対してクライアント自体を認証するために使用する証明書に適用される検証モードも、`clientCertificate` 要素の下にある behaviors セクションで設定されます。  
+  
+```  
+<!--For debugging purposes, set the includeExceptionDetailInFaults attribute to true.-->  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+      <!--The serviceCredentials behavior allows one to define a -->  
+      <!--service certificate. A service certificate is used by a -->  
+      <!--client to authenticate the service and provide message -->  
+      <!-- protection. This configuration references the "localhost"-->  
+      <!--certificate installed during the setup instructions. -->  
+      <serviceCredentials>  
+        <serviceCertificate findValue="localhost"  
+               storeLocation="LocalMachine"   
+               storeName="My" x509FindType="FindBySubjectName" />  
+        <clientCertificate>  
+          <!-- Setting the certificateValidationMode to -->  
+          <!-- PeerOrChainTrust means that if the certificate -->  
+          <!--is in the user's Trusted People store, then it is -->  
+          <!-- trusted without performing a validation of the -->  
+          <!-- certificate's issuer chain. This setting is used -->  
+          <!-- here for convenience so that the sample can be run -->  
+          <!-- without having to have certificates issued by a -->  
+          <!-- certification authority (CA). -->  
+          <!-- This setting is less secure than the default, -->  
+          <!-- ChainTrust. The security implications of this -->  
+          <!-- setting should be carefully considered before using -->  
+          <!-- PeerOrChainTrust in production code. -->  
+          <authentication   
+                       certificateValidationMode="PeerOrChainTrust" />  
+        </clientCertificate>  
+      </serviceCredentials>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ 同じバインディングとセキュリティの詳細が、クライアントの構成ファイルで指定されます。  
+  
+ 次のコードを使用すると、呼び出し元の ID がサービス コンソール ウィンドウに表示されます。  
+  
+```  
+Console.WriteLine("Called by {0}", ServiceSecurityContext.Current.PrimaryIdentity.Name);  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピュータで実行するには  
+  
+1.  Setup.bat をサンプルのインストール フォルダーで実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、Windows SDK コマンド プロンプトから実行します。MSSDK 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Windows SDK コマンド プロンプトで自動設定されます。  
+  
+2.  サービス アプリケーションを \\service\\bin で実行します。  
+  
+3.  クライアント アプリケーションを \\client\\bin で実行します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+5.  サンプルの使用が終わったら、Cleanup.bat を実行して証明書を削除してください。他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+### サンプルを別のコンピュータで実行するには  
+  
+1.  サービス コンピュータにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サーバーのサービス ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportClientCert.bat の各ファイルもサーバーにコピーします。  
+  
+3.  クライアント コンピュータにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピュータに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバーで `setup.bat service` を実行します。`setup.bat`  に `service` 引数を指定して実行すると、コンピュータの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Service.exe.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) 要素の `findValue` 属性\) を反映します。これは、コンピュータの完全修飾ドメイン名と同じです。さらに、ベース アドレスの値を `localhost` から完全修飾コンピュータ名に変更します。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピュータのクライアント ディレクトリにコピーします。  
+  
+8.  クライアントで `setup.bat client` を実行します。`setup.bat`  に `client` 引数を指定して実行すると、client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+9. クライアント コンピュータの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。さらに、[\<defaultCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/defaultcertificate-element.md)の `findValue` 属性を、サーバーの完全修飾ドメイン名になる、新しいサービス証明書の名前に変更します。  
+  
+10. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+11. クライアントで ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+12. サーバーで ImportClientCert.bat を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+13. サービス コンピュータで、コマンド プロンプトから Service.exe を起動します。  
+  
+14. クライアント コンピュータで、コマンド プロンプト ウィンドウから Client.exe を起動します。  
+  
+    1.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを別のマシンで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。別のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Basic\MessageSecurity`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-user-name.md b/docs/framework/wcf/samples/message-security-user-name.md
new file mode 100644
index 00000000000..62ade5e6ff2
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-user-name.md
@@ -0,0 +1,255 @@
+---
+title: "メッセージ セキュリティ ユーザー名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WS セキュリティ"
+ms.assetid: c63cfc87-6b20-4949-93b3-bcd4b732b0a2
+caps.latest.revision: 57
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 57
+---
+# メッセージ セキュリティ ユーザー名
+このサンプルでは、クライアントのユーザー名認証による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、サーバーの X.509v3 証明書を使用するサーバー認証が必要です。  クライアント\/サーバー間のすべてのアプリケーション メッセージは署名され、暗号化されます。  既定では、クライアントによって提供されるユーザー名とパスワードが、有効な Windows アカウントへのログオンに使用されます。  このサンプルは、「[WSHttpBinding](../../../../docs/framework/wcf/samples/wshttpbinding.md)」に基づいています。  このサンプルは、クライアント コンソール プログラム \(Client.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(Service.dll\) で構成されています。  サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、さらに次の方法も示します。  
+  
+-   追加の承認を実行できるようにするための、Windows アカウントへの既定のマッピング。  
+  
+-   サービス コードから呼び出し元の ID 情報にアクセスする方法。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル Web.config で定義します。  エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。  バインディングは、標準の [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)で構成されます。既定では、メッセージ セキュリティが使用されます。  このサンプルは、クライアント ユーザー名認証を使用するように標準の [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を設定します。  この動作により、サービス認証でユーザーの資格情報が使用されることが指定されます。  サーバー証明書のサブジェクト名には、[\<serviceCredentials\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecredentials.md) の `findValue` 属性と同じ値が指定されている必要があります。  
+  
+```  
+<system.serviceModel>  
+  <protocolMapping>  
+    <add scheme="http" binding="wsHttpBinding" />  
+  </protocolMapping>  
+  <bindings>  
+    <wsHttpBinding>  
+      <!--   
+      This configuration defines the security mode as Message and   
+      the clientCredentialType as Username.  
+      By default, Username authentication attempts to authenticate the provided  
+      username as a Windows computer or domain account.  
+      -->  
+      <binding>  
+        <security mode="Message">  
+          <message clientCredentialType="UserName"/>  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  
+  <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true.-->  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior>  
+        <!--   
+      The serviceCredentials behavior allows one to define a service certificate.  
+      A service certificate is used by the service to authenticate itself to the client and to provide message protection.  
+      This configuration references the "localhost" certificate installed during the setup instructions.  
+      -->  
+        <serviceCredentials>  
+          <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+        </serviceCredentials>  
+        <serviceMetadata httpGetEnabled="True"/>  
+        <serviceDebug includeExceptionDetailInFaults="False" />  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+ クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。  クライアント バインディングは、適切な `securityMode` と `authenticationMode` で構成されます。  複数コンピューターのシナリオで実行する場合は、サービスのエンドポイント アドレスを適切に変更する必要があります。  
+  
+```  
+<system.serviceModel>  
+  <client>  
+    <endpoint address="http://localhost/servicemodelsamples/service.svc"   
+              binding="wsHttpBinding"   
+              bindingConfiguration="Binding1"   
+              behaviorConfiguration="ClientCredentialsBehavior"  
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  </client>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!--   
+      This configuration defines the security mode as Message and   
+      the clientCredentialType as Username.  
+      -->  
+      <binding name="Binding1">  
+        <security mode="Message">  
+          <message clientCredentialType="UserName"/>  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  
+  <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true.-->  
+  <behaviors>  
+    <endpointBehaviors>  
+      <behavior name="ClientCredentialsBehavior">  
+        <!--   
+      Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+      is in the user's Trusted People store, then it is trusted without performing a  
+      validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+      sample can be run without having to have certificates issued by a certification authority (CA).  
+      This setting is less secure than the default, ChainTrust. The security implications of this   
+      setting should be carefully considered before using PeerOrChainTrust in production code.   
+      -->  
+        <clientCredentials>  
+          <serviceCertificate>  
+            <authentication certificateValidationMode="PeerOrChainTrust" />  
+          </serviceCertificate>  
+        </clientCredentials>  
+      </behavior>  
+    </endpointBehaviors>  
+  </behaviors>  
+</system.serviceModel>  
+```  
+  
+ クライアント実装では、使用するユーザー名とパスワードが設定されます。  
+  
+```  
+// Create a client.  
+CalculatorClient client = new CalculatorClient();  
+  
+// Configure client with valid computer or domain account (username,password).  
+client.ClientCredentials.UserName.UserName = username;  
+client.ClientCredentials.UserName.Password = password.ToString();  
+  
+// Call GetCallerIdentity service operation.  
+Console.WriteLine(client.GetCallerIdentity());  
+...  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+MyMachine\TestAccount  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ MessageSecurity サンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、証明書ベースのセキュリティを必要とするホスト アプリケーションを実行できるようになります。  バッチ ファイルの実行には 2 つのモードを使用できます。  バッチ ファイルを単一コンピューター モードで実行するには、コマンド ラインに「`setup.bat`」と入力します。  サービス モードで実行するには、「`setup.bat service`」と入力します。  このサンプルを複数のコンピューターで実行している場合は、このモードを使用します。  詳細については、このトピック末尾のセットアップ手順を参照してください。  
+  
+ 次に、バッチ ファイルの各セクションの概要を簡単に説明します。  
+  
+-   サーバー証明書の作成  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+     %SERVER\_NAME% 変数はサーバー名を指定します。  証明書は LocalMachine ストアに保存されます。  Setup.bat バッチ ファイルの実行にサービスの引数 \(`setup.bat service` など\) が使用された場合、%SERVER\_NAME% にはコンピューターの完全修飾ドメイン名が含まれます。  それ以外の場合、既定値は localhost です。  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール  
+  
+     次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+  
+    ```  
+  
+-   証明書の秘密キーに関する権限の付与  
+  
+     Setup.bat バッチ ファイルの次の行は、LocalMachine ストアに保存されたサーバー証明書を [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] ワーカー プロセス アカウントでアクセスできるようにします。  
+  
+    ```  
+    echo ************  
+    echo setting privileges on server certificates  
+    echo ************  
+    for /F "delims=" %%i in ('"%ProgramFiles%\ServiceModelSampleTools\FindPrivateKey.exe" My LocalMachine -n CN^=%SERVER_NAME% -a') do set PRIVATE_KEY_FILE=%%i  
+    set WP_ACCOUNT=NT AUTHORITY\NETWORK SERVICE  
+    (ver | findstr /C:"5.1") && set WP_ACCOUNT=%COMPUTERNAME%\ASPNET  
+    echo Y|cacls.exe "%PRIVATE_KEY_FILE%" /E /G "%WP_ACCOUNT%":R  
+    iisreset  
+    ```  
+  
+    > [!NOTE]
+    >  英語 \(米国\) 以外の  言語で Windows を使用している場合は、Setup.bat ファイルを編集し、`NT AUTHORITY\NETWORK SERVICE` アカウント名を現在の地域に適した名前に変更してください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  Makecert.exe と FindPrivateKey.exe が含まれているフォルダーがパスに含まれていることを確認します。  
+  
+2.  管理特権を使用して Visual Studio コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、Visual Studio コマンド プロンプトから実行します。  path 環境変数が SDK のインストール ディレクトリを指している必要があります。  この環境変数は、Visual Studio コマンド プロンプトで自動設定されます。  
+  
+3.  サービスへのアクセスを検証します。ブラウザーにアドレス「http:\/\/localhost\/servicemodelsamples\/service.svc」を入力します。  
+  
+4.  Client.exe を \\client\\bin で起動します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+5.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。  インターネット インフォメーション サービス管理ツールを使用して、このディレクトリ用に servicemodelsamples という仮想アプリケーションを作成します。  
+  
+2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。  ファイルのコピー先が \\bin サブディレクトリであることを確認します。  Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。  Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。  `setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Web.config を編集して、新しい証明書名 \(serviceCertificate 要素の findValue 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。  これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+10. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。  複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。  削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/message-security-windows.md b/docs/framework/wcf/samples/message-security-windows.md
new file mode 100644
index 00000000000..19093f88fdf
--- /dev/null
+++ b/docs/framework/wcf/samples/message-security-windows.md
@@ -0,0 +1,97 @@
+---
+title: "メッセージ セキュリティ Windows | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WS セキュリティ"
+ms.assetid: d2221d1c-c9cb-48d1-b044-a3b4445c7f05
+caps.latest.revision: 34
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 34
+---
+# メッセージ セキュリティ Windows
+このサンプルでは、Windows 認証によるメッセージ レベルのセキュリティを使用するよう <xref:System.ServiceModel.WSHttpBinding> バインディングを構成する方法を示します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  このサンプルでは、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされており、クライアントはコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)の既定のセキュリティは、Windows 認証を使用するメッセージ セキュリティです。  このサンプルの構成ファイルでは、[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md) の `mode` 属性を `Message` に、`clientCredentialType` 属性を `Windows` にそれぞれ明示的に設定します。  これらの値はこのバインディングの既定値ですが、明示的に構成されています。これらの使用例を示すサンプル構成を次に示します。  
+  
+```  
+<bindings>  
+    <wsHttpBinding>  
+        <binding>  
+            <security mode="Message">  
+                <message clientCredentialType="Windows"/>  
+            </security>  
+        </binding>  
+    </wsHttpBinding>  
+</bindings>  
+```  
+  
+ クライアント エンドポイント構成は、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。  クライアント バインディングは、適切な `securityMode` と `authenticationMode` で構成されます。  
+  
+```  
+  
+<system.serviceModel>  
+  <client>  
+    <endpoint address=  
+            "http://localhost/servicemodelsamples/service.svc"   
+            binding="wsHttpBinding"   
+            bindingConfiguration="Binding1"   
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  </client>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!--   
+      <!--The default security for the WSHttpBinding is-->  
+      <!--Message security using Windows authentication. -->  
+      <!--This configuration explicitly defines the security mode -->  
+      <!--as Message and the clientCredentialType as Windows  -->  
+      <!--for demonstration purposes. -->  
+      <binding name="Binding1">  
+        <security mode="Message">  
+          <message clientCredentialType="Windows"/>  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+  
+```  
+  
+ サービス ソース コードは、<xref:System.ServiceModel.OperationContext.ServiceSecurityContext%2A> を使用して呼び出し元の ID へのアクセスを可能にする方法を示すように変更されています。  
+  
+```  
+public string GetCallerIdentity()  
+{  
+    // The Windows identity of the caller can be accessed on the ServiceSecurityContext.WindowsIdentity.  
+    return OperationContext.Current.ServiceSecurityContext.WindowsIdentity.Name;  
+}  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  最初に呼び出されるメソッド `GetCallerIdentity` は、呼び出し元の ID の名前をクライアントに返します。  クライアントをシャットダウンするには、コンソール ウィンドウで Enter キーを押します。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/metadata-extensibility.md b/docs/framework/wcf/samples/metadata-extensibility.md
new file mode 100644
index 00000000000..b8ac0212eca
--- /dev/null
+++ b/docs/framework/wcf/samples/metadata-extensibility.md
@@ -0,0 +1,27 @@
+---
+title: "メタデータ拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f92fcc76-0806-4c84-9d63-7aae0d3899de
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# メタデータ拡張
+このセクションには、カスタム メタデータを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)  
+ メタデータ交換バインディング以外のバインディングが使用されているセキュア メタデータ エンドポイントが含まれるサービスを実装する方法と、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) またはクライアントを構成して、そのようなメタデータ エンドポイントからメタデータを取得する方法を示します。  
+  
+ [カスタム WSDL パブリケーション](../../../../docs/framework/wcf/samples/custom-wsdl-publication.md)  
+ カスタム <xref:System.ServiceModel.Description.IContractBehavior?displayProperty=fullName> 属性に <xref:System.ServiceModel.Description.IWsdlExportExtension?displayProperty=fullName> を実装し、属性プロパティを WSDL 注釈などの機能としてエクスポートする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/metadata-publishing-behavior.md b/docs/framework/wcf/samples/metadata-publishing-behavior.md
new file mode 100644
index 00000000000..a08ae46bf2e
--- /dev/null
+++ b/docs/framework/wcf/samples/metadata-publishing-behavior.md
@@ -0,0 +1,96 @@
+---
+title: "メタデータ公開動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メタデータ公開動作のサンプル [Windows Communication Foundation]"
+  - "サービスの動作, メタデータ公開のサンプル"
+ms.assetid: 78c13633-d026-4814-910e-1c801cffdac7
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# メタデータ公開動作
+メタデータ公開動作のサンプルでは、サービスのメタデータ公開機能を制御する方法を示します。サービスのメタデータには機密情報が含まれる可能性がありますが、意図的ではない開示を回避するために、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの既定の構成では、メタデータは公開されないように設定されています。この動作は、既定の設定ではセキュリティで保護されますが、同時に、サービスの構成の中でメタデータ公開の動作が明示的に有効化されない限り、サービスの呼び出しに必要なクライアント コードをメタデータ インポート ツール \(Svcutil.exe など\) を使用して生成できないことも意味します。  
+  
+> [!IMPORTANT]
+>  このサンプルではわかりやすくするために、セキュリティで保護されていないメタデータ公開エンドポイントを作成する方法を示します。こうしたエンドポイントは、認証されていない匿名の利用者が利用できる可能性があります。これらのエンドポイントを配置する前には注意を払い、サービスのメタデータをパブリックに公開することが適切かどうか確認する必要があります。メタデータ エンドポイントをセキュリティ保護するサンプルについては、「[カスタム セキュア メタデータ エンドポイント](../../../../docs/framework/wcf/samples/custom-secure-metadata-endpoint.md)」のサンプルを参照してください。  
+  
+ このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスでメタデータを公開するには、サービス上に <xref:System.ServiceModel.Description.ServiceMetadataBehavior> を構成する必要があります。この動作が存在する場合は、エンドポイントを構成してメタデータを公開し、<xref:System.ServiceModel.Description.IMetadataExchange> コントラクトを WS\-MetadataExchange \(MEX\) プロトコルの実装として公開できます。便宜上、このコントラクトには、構成名を略した "IMetadataExchange" という名前が付けられています。このサンプルでは、`mexHttpBinding` を使用します。これは使いやすい標準バインディングで、セキュリティ モードが `None` に設定されている `wsHttpBinding` と同等です。エンドポイントには、相対アドレスの "mex" が使用されています。このアドレスがサービスのベース アドレスに対して解決されると、エンドポイントのアドレスは http:\/\/localhost\/servicemodelsamples\/service.svc\/mex になります。この動作の構成を次に示します。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <!-- The serviceMetadata behavior publishes metadata through   
+           the IMetadataExchange contract. When this behavior is   
+           present, you can expose this contract through an endpoint   
+           as shown below. Setting httpGetEnabled to true publishes   
+           the service's WSDL at the <baseaddress>?wsdl, for example,  
+           http://localhost/servicemodelsamples/service.svc?wsdl -->  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ MEX エンドポイントを次に示します。  
+  
+```  
+<!-- the MEX endpoint is exposed at   
+     http://localhost/servicemodelsamples/service.svc/mex   
+     To expose the IMetadataExchange contract, you   
+     must enable the serviceMetadata behavior as demonstrated                           
+     previously. -->  
+<endpoint address="mex"  
+          binding="mexHttpBinding"  
+          contract="IMetadataExchange" />  
+```  
+  
+ このサンプルでは、<xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpGetEnabled%2A> プロパティを `true` に設定します。これにより、HTTP GET を使用してサービスのメタデータも公開されます。HTTP GET メタデータのエンドポイントを有効にするには、サービスに HTTP ベース アドレスが設定されている必要があります。クエリ文字列 `?wsdl` は、メタデータにアクセスするサービスのベース アドレスで使用されます。たとえば、Web ブラウザでサービスの WSDL を表示するには、アドレス http:\/\/localhost\/servicemodelsamples\/service.svc?wsdl を使用します。または、<xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A> を `true` に設定してこの動作を使用することにより、HTTPS を通じてメタデータを公開することもできます。これには、HTTPS ベース アドレスが必要です。  
+  
+ サービスの MEX エンドポイントにアクセスするには、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用します。  
+  
+ `svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs`  
+  
+ これにより、サービスのメタデータに基づくクライアントが生成されます。  
+  
+ HTTP GET を使用してサービスのメタデータにアクセスするには、ブラウザで http:\/\/localhost\/servicemodelsamples\/service.svc?wsdl を指定します。  
+  
+ この動作を削除してサービスを開こうとすると、例外が発生します。動作がない場合にこのエラーが発生するのは、`IMetadataExchange` コントラクトを使用して構成されたエンドポイントに実装が存在しないからです。  
+  
+ `HttpGetEnabled` を `false` に設定すると、サービスのメタデータが表示される代わりに CalculatorService ヘルプ ページが表示されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Metadata`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/msmq-activation.md b/docs/framework/wcf/samples/msmq-activation.md
new file mode 100644
index 00000000000..609d8080356
--- /dev/null
+++ b/docs/framework/wcf/samples/msmq-activation.md
@@ -0,0 +1,371 @@
+---
+title: "MSMQ アクティベーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3834149-7b8c-4a54-806b-b4296720f31d
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# MSMQ アクティベーション
+このサンプルでは、メッセージ キューから読み取ったアプリケーションを、Windows プロセス アクティブ化サービス \(WAS\) でホストする方法を示します。  このサンプルは `netMsmqBinding` を使用しており、「[双方向通信](../../../../docs/framework/wcf/samples/two-way-communication.md)」のサンプルに基づいています。  この場合、サービスは Web ホスト アプリケーションの 1 つであり、クライアントは自己ホスト型です。クライアントはコンソールに出力して、送信された発注書のステータスを確認します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!NOTE]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  \<InstallDrive\>:\\WF\_WCF\_Samples  
+>   
+>  Windows Communication Foundation \(WCF\) および Windows Workflow Foundation このディレクトリが存在しない場合は、「[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] 向けの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf](../../../../includes/wf-md.md)] のサンプル」に移動して、すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  \<InstallDrive\>:\\Samples\\WCFWFCardSpace\\WCF\\Basic\\Services\\Hosting\\WASHost\\MsmqActivation  
+  
+ Windows プロセス アクティブ化サービス \(WAS\) は [!INCLUDE[lserver](../../../../includes/lserver-md.md)] の新しいプロセス アクティブ化機構です。WAS は、以前は HTTP ベースのアプリケーションでのみ使用できた IIS のような機能を、HTTP 以外のプロトコルを使用するアプリケーションに提供します。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] はリスナー アダプター インターフェイスを使用し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によってサポートされる HTTP 以外のプロトコル \(TCP、名前付きパイプ、MSMQ など\) を介して受信されるアクティブ化要求を伝達します。  HTTP 以外のプロトコルを介して要求を受信する機能は、SMSvcHost.exe で実行されるマネージ Windows サービスによってホストされます。  
+  
+ Net.Msmq リスナ アダプタ サービス \(NetMsmqActivator\) は、キュー内のメッセージに基づいてキューに置かれたアプリケーションをアクティブ化します。  
+  
+ クライアントはトランザクションのスコープ内から発注書をサービスに送信します。  サービスはトランザクション内で注文を受信して、処理します。  その後、サービスは注文ステータスをクライアントに返信します。  双方向通信を使用するには、クライアントとサービスの両方がキューを使用して、発注書や注文ステータスをキューに追加する必要があります。  
+  
+ `IOrderProcessor` サービス コントラクトは、キューを使用する一方向サービス操作を定義します。  サービス操作は、注文ステータスをクライアントに送信するために応答エンドポイントを使用します。  応答エンドポイントのアドレスは、注文ステータスをクライアントに返信する際に使用されるキューの URI です。  注文処理アプリケーションは、このコントラクトを実装します。  
+  
+```csharp  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void SubmitPurchaseOrder(PurchaseOrder po,   
+                                           string reportOrderStatusTo);  
+}  
+  
+```  
+  
+ 注文ステータスを送信する応答コントラクトは、クライアントが指定します。  クライアントは注文ステータス コントラクトを実装します。  サービスは、このコントラクトについて生成されたクライアントを使用して、注文ステータスをクライアントに返信します。  
+  
+```csharp  
+[ServiceContract]  
+public interface IOrderStatus  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void OrderStatus(string poNumber, string status);  
+}  
+  
+```  
+  
+ サービス操作は、送信された発注書を処理します。  <xref:System.ServiceModel.OperationBehaviorAttribute> はサービス操作に適用され、キューからのメッセージの受信に使用されるトランザクション内で登録リストを自動で作成し、サービス操作が完了したときにトランザクションを自動で完了するように指定します。  `Orders` クラスは、注文処理機能をカプセル化します。  この例では、発注書をディクショナリに追加します。  このサービス操作が帰属するしているトランザクションは、`Orders` クラス内の操作で使用できます。  
+  
+ サービス操作は、送信された発注書を処理するだけでなく、注文ステータスをクライアントに戻します。  
+  
+```csharp  
+public class OrderProcessorService : IOrderProcessor  
+{  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public void SubmitPurchaseOrder(PurchaseOrder po, string reportOrderStatusTo)  
+    {  
+        Orders.Add(po);  
+        Console.WriteLine("Processing {0} ", po);  
+        Console.WriteLine("Sending back order status information");  
+        NetMsmqBinding msmqCallbackBinding = new NetMsmqBinding();  
+        msmqCallbackBinding.Security.Mode = NetMsmqSecurityMode.None;  
+        OrderStatusClient client = new OrderStatusClient(msmqCallbackBinding, new EndpointAddress(reportOrderStatusTo));  
+        // please note that the same transaction that is used to dequeue purchase order is used  
+        // to send back order status  
+        using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+        {  
+            client.OrderStatus(po.PONumber, po.Status);  
+            scope.Complete();  
+        }  
+    }  
+  
+```  
+  
+ 使用するクライアント バインディングの指定には、構成ファイルを使用します。  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションで指定されます。  サービスのエンドポイントは、構成ファイルの System.serviceModel セクションで定義されます。  
+  
+> [!NOTE]
+>  MSMQ のキュー名とエンドポイント アドレスでは、若干異なるアドレス表記が使用されています。  MSMQ のキュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] エンドポイント アドレスでは net.msmq: スキームを指定します。ローカル コンピューターを表すのに "localhost" を使用し、パスの区切りにはスラッシュを使用します。  リモート コンピューターでホストされているキューからの読み出しを行うには、"." や "localhost" をリモート コンピューター名に置き換えます。  
+  
+ クラスの名前が付いた .svc ファイルは、WAS でのサービス コードのホストに使用されます。  
+  
+ Service.svc ファイル自体には、`OrderProcessorService` を作成するディレクティブが含まれます。  
+  
+```xml  
+<%@ServiceHost language="c#" Debug="true" Service="Microsoft.ServiceModel.Samples.OrderProcessorService"%>  
+  
+```  
+  
+ さらに、Service.svc ファイルには、System.Transactions.dll を読み込むためのアセンブリ ディレクティブも含まれます。  
+  
+```xml  
+<%@Assembly name="System.Transactions, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"%>  
+```  
+  
+ クライアントはトランザクション スコープを作成します。  サービスとの通信はトランザクションのスコープ内で実行され、すべてのメッセージが成功か失敗かを示すアトミックな単位として扱われます。  トランザクションは、トランザクション スコープで `Complete` を呼び出すことでコミットされます。  
+  
+```csharp  
+using (ServiceHost serviceHost = new ServiceHost(typeof(OrderStatusService)))  
+{  
+    // Open the ServiceHostBase to create listeners and start listening   
+    // for order status messages.  
+    serviceHost.Open();  
+  
+    // Create a proxy with given client endpoint configuration  
+    OrderProcessorClient client = new OrderProcessorClient();  
+  
+    // Create the purchase order  
+    PurchaseOrder po = new PurchaseOrder();  
+    po.CustomerId = "somecustomer.com";  
+    po.PONumber = Guid.NewGuid().ToString();  
+  
+    PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+    lineItem1.ProductId = "Blue Widget";  
+    lineItem1.Quantity = 54;  
+    lineItem1.UnitCost = 29.99F;  
+  
+    PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+    lineItem2.ProductId = "Red Widget";  
+    lineItem2.Quantity = 890;  
+    lineItem2.UnitCost = 45.89F;  
+  
+    po.orderLineItems = new PurchaseOrderLineItem[2];  
+    po.orderLineItems[0] = lineItem1;  
+    po.orderLineItems[1] = lineItem2;  
+  
+    //Create a transaction scope.  
+    using (TransactionScope scope = new   
+        TransactionScope(TransactionScopeOption.Required))  
+    {  
+        // Make a queued call to submit the purchase order  
+        client.SubmitPurchaseOrder(po,   
+       "net.msmq://localhost/private/ServiceModelSamplesOrder/OrderStatus");  
+        // Complete the transaction.  
+        scope.Complete();  
+    }  
+  
+    //Closing the client gracefully closes the connection and cleans up   
+    //resources  
+    client.Close();  
+  
+    Console.WriteLine();  
+    Console.WriteLine("Press <ENTER> to terminate client.");  
+    Console.ReadLine();  
+  
+    // Close the ServiceHostBase to shutdown the service.  
+    serviceHost.Close();  
+    }  
+  
+```  
+  
+ クライアント コードは `IOrderStatus` コントラクトを実装して、サービスからの注文ステータスを受信します。  この場合は、注文ステータスを出力します。  
+  
+```csharp  
+[ServiceBehavior]  
+public class OrderStatusService : IOrderStatus  
+{  
+    [OperationBehavior(TransactionAutoComplete = true,   
+                        TransactionScopeRequired = true)]  
+    public void OrderStatus(string poNumber, string status)  
+    {  
+        Console.WriteLine("Status of order {0}:{1} ",   
+                                         poNumber , status);  
+    }  
+}  
+```  
+  
+ 注文ステータス キューは `Main` メソッド内で作成します。  クライアント構成には、注文ステータス サービスをホストするための注文ステータス サービス構成が含まれています。次のサンプル構成を参照してください。  
+  
+```csharp  
+<appSettings>  
+    <!-- use appSetting to configure MSMQ queue name -->  
+    <add key="targetQueueName" value=".\private$\ServiceModelSamples/service.svc" />  
+    <add key="responseQueueName" value=".\private$\ServiceModelSamples/OrderStatus" />  
+  </appSettings>  
+  
+<system.serviceModel>  
+  
+    <services>  
+      <service   
+         name="Microsoft.ServiceModel.Samples.OrderStatusService">  
+        <!-- Define NetMsmqEndpoint -->  
+        <endpoint address="net.msmq://localhost/private/ServiceModelSamples/OrderStatus"  
+                  binding="netMsmqBinding"  
+                  contract="Microsoft.ServiceModel.Samples.IOrderStatus" />  
+      </service>  
+    </services>  
+  
+    <client>  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint name="OrderProcessorEndpoint"  
+                address="net.msmq://localhost/private/ServiceModelSamples/service.svc"   
+                binding="netMsmqBinding"   
+                contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+    </client>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサーバーとクライアントの両方のコンソール ウィンドウに表示されます。  サーバーがクライアントから受信したメッセージを表示できます。  どちらかのコンソールで Enter キーを押すと、サーバーとクライアントがどちらもシャットダウンされます。  
+  
+ クライアントには、サーバーから送信された注文ステータス情報が表示されます。  
+  
+```Output  
+  
+クライアントを終了するには、<Enter> キーを押します。  注文 70cf9d63-3dfa-4e69-81c2-23aa4478ebed のステータス: 保留    
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  WAS のアクティブ化に必要な [!INCLUDE[iisver](../../../../includes/iisver-md.md)] がインストールされていることを確認します。  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  さらに、HTTP 以外の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティベーション コンポーネントをインストールする必要があります。  
+  
+    1.  **\[スタート\]** メニューの **\[コントロール パネル\]** をクリックします。  
+  
+    2.  **\[プログラムと機能\]** をクリックします。  
+  
+    3.  **\[Windows 機能の有効化または無効化\]** をクリックします。  
+  
+    4.  **\[機能の概要\]** で、**\[機能の追加\]** をクリックします。  
+  
+    5.  **\[Microsoft .NET Framework 3.0\]** ノードを展開し、**\[Windows Communication Foundation Non\-HTTP Activation\]** 機能をオンにします。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  コマンド ウィンドウで client.exe を実行することにより、クライアントを実行します。  これによってキューが作成され、メッセージがそのキューに送信されます。  クライアントを実行しながら、メッセージを読み取るサービスの結果を表示します。  
+  
+5.  MSMQ アクティベーション サービスは、既定では NETWORK SERVICE として動作します。  そのため、アプリケーションのアクティブ化に使用されるキューには、NETWORK SERVICE アカウントによる受信およびピーク権限が必要です。  この権限は、メッセージ キュー MMC を使用して追加できます。  
+  
+    1.  **\[スタート\]** メニューから **\[ファイル名を指定して実行\]** をクリックし、「`Compmgmt.msc`」と入力して Enter キーを押します。  
+  
+    2.  **\[サービスとアプリケーション\]** で **\[メッセージ キュー\]** を展開します。  
+  
+    3.  **\[プライベート キュー\]** をクリックします。  
+  
+    4.  キュー \(servicemodelsamples\/Service.svc\) を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    5.  **\[セキュリティ\]** タブの **\[追加\]** をクリックし、NETWORK SERVICE にピークと受信のアクセス許可を付与します。  
+  
+6.  MSMQ アクティブ化をサポートするよう Windows プロセス アクティブ化サービス \(WAS\) を設定します。  
+  
+     便宜上次の 2 つの手順が、サンプル ディレクトリにある AddMsmqSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  net.msmq アクティベーションをサポートするには、既定の Web サイトをあらかじめ net.msmq プロトコルにバインドしておく必要があります。  これは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] 管理ツール セットと共にインストールされる appcmd.exe を使用して行います。  権限のレベルが高い \(管理者の\) コマンド プロンプトで、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"   
+        -+bindings.[protocol='net.msmq',bindingInformation='localhost']  
+  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+         このコマンドによって、既定の Web サイトに net.msmq サイト バインディングを追加します。  
+  
+    2.  サイト内のすべてのアプリケーションが同じ net.msmq バインディングを共有しますが、net.msmq サポートの有効化はアプリケーションごとに指定できます。  \/servicemodelsamples アプリケーションで net.msmq を有効にするには、権限のレベルが高いコマンド プロンプトから、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http,net.msmq  
+  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+         このコマンドにより、\/servicemodelsamples アプリケーションに http:\/\/localhost\/servicemodelsamples と net.msmq:\/\/localhost\/servicemodelsamples のどちらを使用してもアクセスできるようになります。  
+  
+7.  まだ確認していない場合は、MSMQ アクティベーション サービスが有効になっていることを確認します。  **\[スタート\]** メニューの **\[ファイル名を指定して実行\]** をクリックし、`「Services.msc」`と入力します。  **Net.Msmq リスナ アダプタ**のサービスのリストを検索します。  右クリックし、**\[プロパティ\]** をクリックします。  **\[スタートアップの種類\]** を **\[自動\]** に設定し、**\[適用\]** をクリックして **\[開始\]** ボタンをクリックします。  この手順は、Net.Msmq リスナー アダプター サービスを初めて使用する前に 1 回だけ実行する必要があります。  
+  
+8.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  さらに、発注書を送信するときのキューの URI 内のコンピューター名を反映するように、発注書を送信するクライアントのコードを変更します。  次のコードを使用します。  
+  
+    ```  
+    client.SubmitPurchaseOrder(po, "net.msmq://localhost/private/ServiceModelSamples/OrderStatus");  
+    ```  
+  
+9. このサンプル用に追加した net.msmq サイト バインディングを削除します。  
+  
+     便宜上次の 2 つの手順が、サンプル ディレクトリにある RemoveMsmqSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  権限のレベルが高いコマンド プロンプトから次のコマンドを実行して、有効なプロトコルの一覧から net.msmq を削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http  
+  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+    2.  権限のレベルが高いコマンド プロンプトから次のコマンドを実行して、net.msmq サイト バインディングを削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" --bindings.[protocol='net.msmq',bindingInformation='localhost']  
+  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+    > [!WARNING]
+    >  バッチ ファイルを実行すると、DefaultAppPool がリセットされて .NET Framework Version 2.0 で実行されます。  
+  
+ `netMsmqBinding` バインディング トランスポートを使用する場合の既定では、セキュリティが有効です。  トランスポート セキュリティの種類は、`MsmqAuthenticationMode` と `MsmqProtectionLevel` の 2 つのプロパティで決まります。  既定の設定では、認証モードは `Windows`、保護レベルは `Sign` です。  MSMQ の認証および署名の機能を利用するには、ドメインに属している必要があります。  このサンプルをドメインに属していないコンピューターで実行すると、"ユーザーの内部メッセージ キュー認証情報は存在しません" というエラーが表示されます。  
+  
+### ワークグループに参加しているコンピューターでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピューターを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを "none" に設定します。サンプル構成を次に示します。  
+  
+    ```xml  
+    <bindings>  
+        <netMsmqBinding>  
+            <binding configurationName="TransactedBinding">  
+                <security mode="None"/>  
+            </binding>  
+        </netMsmqBinding>  
+    </bindings>  
+  
+    ```  
+  
+2.  サンプルを実行する前に、サーバーとクライアントの両方の構成を変更します。  
+  
+    > [!NOTE]
+    >  `security mode` を `None` に設定することは、`MsmqAuthenticationMode`、`MsmqProtectionLevel`、および `Message` のセキュリティを `None` に設定することに相当します。  
+  
+3.  ワークグループに参加しているコンピューターでアクティブ化を有効にするには、アクティベーション サービスとワーカー プロセスの両方を特定のユーザー アカウントで実行する必要があります \(どちらも同じアカウントを使用する必要があります\)。さらに、キューはその特定のユーザー アカウントの ACL に設定されている必要があります。  
+  
+     ワーカー プロセスが実行される ID を変更するには  
+  
+    1.  Inetmgr.exe を実行します。  
+  
+    2.  **\[アプリケーション プール\]** で、**\[AppPool\]** \(通常は **\[DefaultAppPool\]**\) を右クリックし、**\[アプリケーション プールの既定値の設定...\]** をクリックします。  
+  
+    3.  特定のユーザー アカウントを使用するように、\[ID\] プロパティを変更します。  
+  
+     アクティブ化サービスが実行される ID を変更するには  
+  
+    1.  Services.msc を実行します。  
+  
+    2.  **\[Net.Msmq リスナ アダプタ\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+4.  **\[ログオン\]** タブでアカウントを変更します。  
+  
+5.  ワークグループでは、無制限のトークンを使用してサービスを実行する必要もあります。  この操作を行うには、コマンド ウィンドウから次のコマンドを実行します。  
+  
+    ```  
+    sc sidtype netmsmqactivator unrestricted  
+    ```  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/mtom-encoding.md b/docs/framework/wcf/samples/mtom-encoding.md
new file mode 100644
index 00000000000..84dcea1240d
--- /dev/null
+++ b/docs/framework/wcf/samples/mtom-encoding.md
@@ -0,0 +1,91 @@
+---
+title: "MTOM エンコーディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 820e316f-4ee1-4eb5-ae38-b6a536e8a14f
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# MTOM エンコーディング
+このサンプルでは、WSHttpBinding で Message Transmission Optimization Mechanism \(MTOM\) メッセージ エンコーディングを使用する方法を示します。MTOM は、大きなサイズのバイナリ添付データを、SOAP メッセージを使用して未処理のバイトとして転送するための機構です。これにより、メッセージのサイズを縮小できます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\MTOM`  
+  
+ 既定では、WSHttpBinding はメッセージを標準のテキスト XML として送受信します。MTOM メッセージの送受信を有効にするには、バインディングの構成で `messageEncoding` 属性を設定するか \(次のコード サンプルを参照\)、または `MessageEncoding` プロパティを使用して、バインディング上で直接有効にします。これにより、サービスまたはクライアントで MTOM メッセージを送受信できるようになります。  
+  
+```  
+<wsHttpBinding>  
+    <binding name="WSHttpBinding_IUpload" messageEncoding="Mtom"/>  
+</wsHttpBinding>  
+```  
+  
+ MTOM エンコーダでは、バイト配列とストリームを最適化できます。このサンプルでは、操作に `Stream` パラメータを使用して、最適化できるようにします。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+  public interface IUpload  
+  {  
+      [OperationContract]  
+      int Upload(Stream data);  
+  }  
+```  
+  
+ このサンプル用に選択されたコントラクトは、バイナリ データをサービスに転送し、アップロードされたバイト数を戻り値として受け取ります。サービスをインストールしてクライアントを実行すると、数字の 1000 が出力されます。これは、合計 1,000 バイトのデータが受信されたことを示します。出力の残りの部分には、さまざまなペイロードの最適化されたメッセージのサイズと最適化されなかったメッセージのサイズが表示されます。  
+  
+```  
+Output:  
+1000  
+  
+Text encoding with a 100 byte payload: 433  
+MTOM encoding with a 100 byte payload: 912  
+  
+Text encoding with a 1000 byte payload: 1633  
+MTOM encoding with a 1000 byte payload: 2080  
+  
+Text encoding with a 10000 byte payload: 13633  
+MTOM encoding with a 10000 byte payload: 11080  
+  
+Text encoding with a 100000 byte payload: 133633  
+MTOM encoding with a 100000 byte payload: 101080  
+  
+Text encoding with a 1000000 byte payload: 1333633  
+MTOM encoding with a 1000000 byte payload: 1001080  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+ MTOM を使用する目的は、大きいサイズのバイナリ ペイロードの転送を最適化することです。MTOM を使用して SOAP メッセージを送信すると、小さなサイズのバイナリ ペイロードでオーバーヘッドが顕著に表れますが、数千バイトを越すようになるとオーバーヘッドは大きく減少します。この理由は、標準のテキスト XML が Base64 を使用してバイナリ データをエンコードするためです。このエンコードには 3 バイトごとに 4 文字が必要で、データのサイズは 3 分の 1 増加します。MTOM はバイナリ データを未処理のバイトとして転送できます。これによりエンコードとデコードの時間が節約でき、その結果メッセージのサイズが小さくなります。数千バイトというしきい値は、現在のビジネス ドキュメントやデジタル写真のサイズを考えると小さい値です。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/multiple-contracts.md b/docs/framework/wcf/samples/multiple-contracts.md
new file mode 100644
index 00000000000..e5b57ddc923
--- /dev/null
+++ b/docs/framework/wcf/samples/multiple-contracts.md
@@ -0,0 +1,74 @@
+---
+title: "複数のコントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2bef319b-fe9c-4d49-ac6c-dfb23eb35099
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 複数のコントラクト
+この複数のコントラクトのサンプルでは、複数のコントラクトを 1 つのサービスに実装する方法と、実装された各コントラクトと通信を行うためにエンドポイントを構成する方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。サービスは、`ICalculator` コントラクトおよび `ICalculatorSession` コントラクトという、2 つのコントラクトを定義するように変更されています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス クラスは、`ICalculator` と `ICalculatorSession` コントラクトの両方を実装しています。いずれかのコントラクトでセッションが必要なので、サービスは <xref:System.ServiceModel.InstanceContextMode> インスタンス モードを使用して、セッションの有効期間中、状態を保持します。  
+  
+ サービス構成は、各コントラクトを公開する 2 つのエンドポイントを定義するように変更されています。`ICalculator` エンドポイントは、`basicHttpBinding` を使用してベース アドレスで公開されます。`ICalculatorSession` エンドポイントは、`bindingConfiguration` 属性が `BindingWithSession` に設定された `wsHttpBinding` を使用して、ベース アドレスまたはセッションで公開されます。次のサンプル構成を参照してください。  
+  
+```  
+<service   
+    name="Microsoft.ServiceModel.Samples.CalculatorService"  
+    behaviorConfiguration="CalculatorServiceBehavior">  
+  <!-- ICalculator endpoint is exposed using BasicBinding at the base  
+       address provided by host:   
+       http://localhost/servicemodelsamples/service.svc  -->  
+  <endpoint address=""  
+            binding="basicHttpBinding"  
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  <!-- ICalculatorSession endpoint is exposed using BindingWithSession  
+       at {baseaddress}/session:  
+       http://localhost/servicemodelsamples/service.svc/session -->  
+  <endpoint address="session"  
+            binding="wsHttpBinding"  
+            bindingConfiguration="BindingWithSession"   
+           contract="Microsoft.ServiceModel.Samples.ICalculatorSession" />  
+  ...  
+</service>  
+  
+```  
+  
+ 生成されたクライアント コードには、元の `ICalculator` コントラクトと新しい `ICalculatorSession` コントラクトの両方のクライアント クラスが含まれます。クライアント構成とコードは、適切なサービス エンドポイントで各コントラクトと通信するように変更されています。  
+  
+ クライアントは Windows コンソール アプリケーション \(.exe\) です。サービスは、インターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+ クライアント コンソール ウィンドウには、最初に基本のエンドポイント、次にセキュリティで保護されたエンドポイントの順に、各エンドポイントに送信された操作が表示されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\MultipleContracts`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/multiple-endpoints-at-a-single-listenuri.md b/docs/framework/wcf/samples/multiple-endpoints-at-a-single-listenuri.md
new file mode 100644
index 00000000000..22bbf0c271c
--- /dev/null
+++ b/docs/framework/wcf/samples/multiple-endpoints-at-a-single-listenuri.md
@@ -0,0 +1,89 @@
+---
+title: "単一 ListenUri に対する複数のエンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 911ffad4-4d47-4430-b7c2-79192ce6bcbd
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 単一 ListenUri に対する複数のエンドポイント
+このサンプルでは、単一 `ListenUri` で複数のエンドポイントをホストするサービスを示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 「[複数のエンドポイント](../../../../docs/framework/wcf/samples/multiple-endpoints.md)」サンプルで示すように、サービスでは、異なるアドレスを持ち、場合によってはバインディングも異なる複数のエンドポイントをホストできます。このサンプルは、同じアドレスで複数のエンドポイントをホストできることを示しています。さらに、サービス エンドポイントが持つ、`EndpointAddress` と `ListenUri` の 2 種類のアドレスの違いも示します。  
+  
+ `EndpointAddress` とは、サービスの論理アドレスです。これは、SOAP メッセージの宛先となるアドレスです。`ListenUri` とはサービスの物理アドレスです。これには、サービス エンドポイントが現在のコンピュータで実際にメッセージをリッスンする、ポートとアドレスの情報が含まれます。ほとんどの場合、これらのアドレスが異なっている必要はありません。`ListenUri` が明示的に指定されていない場合は、エンドポイントの `EndpointAddress` の URI が既定値になります。ただし、複数の異なるサービス宛てのメッセージを受け入れることができるルーターを構成する場合など、2 つのアドレスを区別すると便利な場合もあります。  
+  
+## サービス  
+ このサンプルのサービスには、`ICalculator` と `IEcho` という 2 つのコントラクトがあります。また、一般的な `IMetadataExchange` エンドポイントに加え、次のコードに示すように 3 つのアプリケーション エンドポイントがあります。  
+  
+```  
+<endpoint address="urn:Stuff"  
+        binding="wsHttpBinding"  
+        contract="Microsoft.ServiceModel.Samples.ICalculator"   
+        listenUri="http://localhost/servicemodelsamples/service.svc" />  
+<endpoint address="urn:Stuff"  
+        binding="wsHttpBinding"  
+        contract="Microsoft.ServiceModel.Samples.IEcho"   
+        listenUri="http://localhost/servicemodelsamples/service.svc" />  
+<endpoint address="urn:OtherEcho"  
+        binding="wsHttpBinding"  
+        contract="Microsoft.ServiceModel.Samples.IEcho"   
+        listenUri="http://localhost/servicemodelsamples/service.svc" />  
+```  
+  
+ 3 つすべてのエンドポイントは、同じ `ListenUri` でホストされ、同じ `binding` を使用します。`ListenUri` が同じエンドポイントは、コンピュータの物理アドレスでメッセージをリッスンする 1 つのチャネル スタックを共有するので、同じバインディングを使用する必要があります。各エンドポイントの `address` は URN です。通常、アドレスは物理的な場所を表し、実際は任意の種類の URI を設定できますが、サンプルで示すようにこのアドレスは照合とフィルタ処理を行う目的で使用されるので、このように設定されています。  
+  
+ 3 つすべてのエンドポイントは同じ `ListenUri` を共有するので、メッセージがそこに到着すると、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ではメッセージの宛先のエンドポイントを決定する必要があります。各エンドポイントにはメッセージ フィルタがあり、これはアドレス フィルタとコントラクト フィルタの 2 つの部分で構成されます。アドレス フィルタは、SOAP メッセージの `To` とサービス エンドポイントのアドレスを照合します。たとえば、`To "Urn:OtherEcho"` 宛てのメッセージだけが、このサービスの 3 つ目のエンドポイントの対象となります。コントラクト フィルタは、特定のコントラクトの操作に関連付けられたアクションを照合します。たとえば、`IEcho` のアクションが含まれるメッセージを照合します。`Echo` は、このサービスの 2 つ目と 3 つ目の、両方のエンドポイントのコントラクト フィルターと照合します。これらのエンドポイントは、どちらも `IEcho` コントラクトをホストするからです。  
+  
+ このように、アドレス フィルタとコントラクト フィルタを組み合わせることによって、このサービスの `ListenUri` に到着する各メッセージを、正しいエンドポイントにルーティングすることができます。3 つ目のエンドポイントは、他の 2 つのエンドポイントと区別されます。このエンドポイントは、他のエンドポイントとは異なるアドレスに送信されるメッセージを受け入れるからです。1 つ目のエンドポイントと 2 つ目のエンドポイントは、コントラクト \(受信メッセージのアクション\) に基づいて相互に区別されます。  
+  
+## クライアント  
+ サーバー上のエンドポイントに 2 つの異なるアドレスがあるのと同様に、クライアント エンドポイントにも 2 つのアドレスがあります。サーバーとクライアントのどちらでも、論理アドレスは `EndpointAddress` と呼ばれます。ただし、サーバーの物理アドレスは `ListenUri` と呼ばれるのに対し、クライアントの物理アドレスは `Via` と呼ばれます。  
+  
+ これら 2 つのアドレスがサーバー上にある場合、既定では同じアドレスを示します。クライアントで、エンドポイントのアドレスとは異なる `Via` を指定するには、次のように `ClientViaBehavior` を使用します。  
+  
+```  
+Uri via = new Uri("http://localhost/ServiceModelSamples/service.svc");  
+CalculatorClient calcClient = new CalculatorClient();  
+calcClient.ChannelFactory.Endpoint.Behaviors.Add(  
+        new ClientViaBehavior(via));  
+```  
+  
+ このアドレスは、通常どおりクライアントの構成ファイルで指定します。この構成ファイルは Svcutil.exe によって生成されたものです。`Via` \(サービスの `ListenUri` に相当\) は、サービスのメタデータ内では示されません。したがってこの情報は、\(サービスのメタデータ アドレスと同様に\) クライアントに帯域外で伝達する必要があります。  
+  
+ このサンプルでは、クライアントはサーバーの 3 つの各アプリケーション エンドポイントにメッセージを送信し、3 つすべてのエンドポイントと通信できる \(さらにそれらのエンドポイントを区別できる\) ことを示します。これらすべてのエンドポイントが同じ `Via` を持つ場合でも同様です。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  複数コンピューターの場合は、Client.cs ファイルで、localhost をサービス コンピューターの名前に置き換える必要があります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\MultipleEndpointsSingleUri`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/multiple-endpoints.md b/docs/framework/wcf/samples/multiple-endpoints.md
new file mode 100644
index 00000000000..0c6bee1eb5e
--- /dev/null
+++ b/docs/framework/wcf/samples/multiple-endpoints.md
@@ -0,0 +1,134 @@
+---
+title: "複数のエンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "複数のエンドポイント"
+ms.assetid: 8f0c2e1f-9aee-41c2-8301-c72b7f664412
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# 複数のエンドポイント
+この複数のエンドポイントのサンプルでは、複数のエンドポイントを 1 つのサービスに構成する方法と、クライアントから各エンドポイントと通信を行う方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。サービス構成は、`ICalculator` コントラクトをサポートする 2 つのエンドポイントを定義するように変更されていますが、各エンドポイントは異なるアドレスで異なるバインディングを使用します。クライアント構成とコードは、両方のサービス エンドポイントと通信するように変更されています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスの Web.config ファイルは、2 つのエンドポイントを定義するように変更されています。各エンドポイントは同じ `ICalculator` コントラクトをサポートしますが、異なるアドレスで異なるバインディングを使用します。1 つ目のエンドポイントは、`basicHttpBinding` バインディングを使用して基本アドレスで定義されます。このエンドポイントではセキュリティは有効ではありません。2 つ目のエンドポイントは、`wsHttpBinding` バインディングを使用して {baseaddress}\/secure で定義されます。このエンドポイントは既定で、Windows 認証による WS\-Security を使用してセキュリティ保護されています。  
+  
+```  
+<service   
+    name="Microsoft.ServiceModel.Samples.CalculatorService"  
+    behaviorConfiguration="CalculatorServiceBehavior">  
+  <!-- This endpoint is exposed at the base address provided by host:  
+       http://localhost/servicemodelsamples/service.svc  -->  
+  <endpoint address=""  
+            binding="basicHttpBinding"  
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  <!-- secure endpoint exposed at {base address}/secure:  
+       http://localhost/servicemodelsamples/service.svc/secure -->  
+  <endpoint address="secure"  
+            binding="wsHttpBinding"  
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  ...  
+</service>  
+  
+```  
+  
+ 両方のエンドポイントは、さらにクライアントでも構成されます。呼び出し元が必要なエンドポイント名をクライアントのコンストラクタに渡せるように、これらのエンドポイントには名前が付けられます。  
+  
+```  
+<client>  
+  <!-- Passing "basic" into the constructor of the CalculatorClient  
+       class selects this endpoint.-->  
+  <endpoint name="basic"  
+            address="http://localhost/servicemodelsamples/service.svc"   
+            binding="basicHttpBinding"   
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  <!-- Passing "secure" into the constructor of the CalculatorClient  
+       class selects this endpoint.-->  
+  <endpoint name="secure"  
+address="http://localhost/servicemodelsamples/service.svc/secure"   
+            binding="wsHttpBinding"   
+            contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+</client>  
+```  
+  
+ 次のコードに示すように、クライアントは両方のエンドポイントを使用します。  
+  
+```  
+static void Main()  
+{  
+    // Create a client to the basic endpoint configuration.  
+    CalculatorClient client = new CalculatorClient("basic");  
+    Console.WriteLine("Communicate with basic endpoint.");  
+    // call operations  
+    DoCalculations(client);  
+  
+    // Close the client and release resources.  
+    client.Close();  
+  
+    // Create a client to the secure endpoint configuration.  
+    client = new CalculatorClient("secure");  
+    Console.WriteLine("Communicate with secure endpoint.");  
+    // Call operations.  
+    DoCalculations(client);  
+  
+    // Close the client and release resources.  
+    client.Close();  
+  
+    Console.WriteLine();  
+    Console.WriteLine("Press <ENTER> to terminate client.");  
+    Console.ReadLine();  
+}  
+  
+```  
+  
+ クライアントを実行すると、両方のエンドポイントとのやり取りが表示されます。  
+  
+```  
+Communicate with basic endpoint.  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Communicate with secure endpoint.  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\MultipleEndpoints`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/namedpipe-activation.md b/docs/framework/wcf/samples/namedpipe-activation.md
new file mode 100644
index 00000000000..85f2ffc9644
--- /dev/null
+++ b/docs/framework/wcf/samples/namedpipe-activation.md
@@ -0,0 +1,234 @@
+---
+title: "NamedPipe アクティベーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f3c0437d-006c-442e-bfb0-6b29216e4e29
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# NamedPipe アクティベーション
+このサンプルでは、名前付きパイプを介して通信するサービスをアクティブ化するために、Windows プロセス アクティブ化サービス \(WAS: Windows Process Activation Service\) を使用してサービスをホストする方法を示します。  このサンプルは「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいており、[!INCLUDE[wv](../../../../includes/wv-md.md)] を実行する必要があります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WASHost\NamedPipeActivation`  
+  
+## サンプルの詳細  
+ このサンプルは、クライアント コンソール プログラム \(.exe\) と、Windows プロセス アクティブ化サービス \(WAS\) によってアクティブ化されるワーカー プロセス内でホストされるサービス ライブラリ \(.dll\) で構成されています。  クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+ サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  コントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(Add、Subtract、Multiply、および Divide\) を公開しています。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+ クライアントは指定された算術演算を同期要求し、サービスの実装は計算を行って結果を返します。  
+  
+```  
+// Service class that implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    public double Add(double n1, double n2)  
+    {  
+        return n1 + n2;  
+    }  
+    public double Subtract(double n1, double n2)  
+    {  
+        return n1 - n2;  
+    }  
+    public double Multiply(double n1, double n2)  
+    {  
+        return n1 * n2;  
+    }  
+    public double Divide(double n1, double n2)  
+    {  
+        return n1 / n2;  
+    }  
+}  
+  
+```  
+  
+ このサンプルでは、セキュリティ保護を行わないように変更された `netNamedPipeBinding` バインディングを使用します。  バインディングは、クライアントとサービスの構成ファイルに指定されます。  サービスのバインディングの種類は、エンドポイント要素の `binding` 属性に指定されます。次のサンプル構成を参照してください。  
+  
+ セキュリティ保護された名前付きパイプ バインディングを使用する場合は、サーバーのセキュリティ モードを必要なセキュリティ設定に変更し、クライアントで svcutil.exe を再実行して更新されたクライアントの構成ファイルを取得します。  
+  
+```  
+<system.serviceModel>  
+        <services>  
+            <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+  
+        <!-- This endpoint is exposed at the base address provided by host: net.pipe://localhost/servicemodelsamples/service.svc  -->  
+        <endpoint address=""   
+                  binding="netNamedPipeBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is explosed at net.pipe://localhost/servicemodelsamples/service.svc/mex -->  
+        <endpoint address="mex"  
+                  binding="mexNamedPipeBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+        </services>      
+        <bindings>  
+            <netNamedPipeBinding>  
+                <binding name="Binding1" >  
+                    <security mode = "None">  
+                    </security>  
+                </binding >  
+            </netNamedPipeBinding>  
+        </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+```  
+  
+ クライアントのエンドポイント情報が構成されます。次のサンプル コードを参照してください。  
+  
+```  
+<system.serviceModel>  
+  
+    <client>  
+      <endpoint name=""  
+                          address="net.pipe://localhost/servicemodelsamples/service.svc"   
+                          binding="netNamedPipeBinding"   
+                          bindingConfiguration="Binding1"   
+                          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </client>  
+  
+    <bindings>  
+  
+      <!--  Following is the expanded configuration section for a NetNamedPipeBinding.  
+            Each property is configured with the default value.   -->  
+  
+      <netNamedPipeBinding>  
+        <binding name="Binding1"   
+                         maxBufferSize="65536"  
+                         maxConnections="10">  
+          <security mode = "None">  
+          </security>  
+        </binding >  
+  
+      </netNamedPipeBinding>  
+    </bindings>  
+  
+  </system.serviceModel>  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] がインストールされていることを確認します。  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] は WAS のアクティブ化に必要です。  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+     さらに、HTTP 以外の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティベーション コンポーネントをインストールする必要があります。  
+  
+    1.  **\[スタート\]** メニューの **\[コントロール パネル\]** をクリックします。  
+  
+    2.  **\[プログラムと機能\]** をクリックします。  
+  
+    3.  **\[Turn Windows Components on or Off\]** をクリックします。  
+  
+    4.  **\[Microsoft .NET Framework 3.0\]** ノードを展開し、**\[Windows Communication Foundation Non\-HTTP Activation\]** 機能をオンにします。  
+  
+3.  名前付きパイプのアクティブ化をサポートするように Windows プロセス アクティブ化サービス \(WAS\) を構成します。  
+  
+     便宜上、次の 2 つの手順が、サンプル ディレクトリにある AddNetPipeSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  net.pipe のアクティブ化をサポートするには、既定の Web サイトをあらかじめ net.pipe プロトコルにバインドしておく必要があります。  これは、IIS7.0 管理ツール セットと共にインストールされる appcmd.exe を使用して行います。  権限のレベルが高い \(管理者の\) コマンド プロンプトで、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"   
+        -+bindings.[protocol='net.pipe',bindingInformation='*']  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+         このコマンドによって、既定の Web サイトに net.pipe サイト バインディングを追加します。  
+  
+    2.  サイト内のすべてのアプリケーションが同じ net.pipe バインディングを共有しますが、net.pipe サポートの有効化はアプリケーションごとに指定できます。  \/servicemodelsamples アプリケーションで net.pipe を有効にするには、権限のレベルが高いコマンド プロンプトから、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http,net.pipe  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  
+  
+         このコマンドにより、\/servicemodelsamples アプリケーションに http:\/\/localhost\/servicemodelsamples と net.tcp:\/\/localhost\/servicemodelsamples のどちらを使用してもアクセスできるようになります。  
+  
+4.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  このサンプル用に追加した net.pipe サイト バインディングを削除します。  
+  
+     便宜上、次の 2 つの手順が、サンプル ディレクトリにある RemoveNetPipeSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  権限のレベルが高いコマンド プロンプトから次のコマンドを実行して、有効なプロトコルの一覧から net.tcp を削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app "Default Web Site/servicemodelsamples" /enabledProtocols:http  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。  
+  
+    2.  権限のレベルが高いコマンド プロンプトから次のコマンドを実行して、net.tcp サイト バインディングを削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" --bindings.[protocol='net.pipe',bindingInformation='*']  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。  
+  
+## 参照  
+ [AppFabric ホスティングと永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/net-binding.md b/docs/framework/wcf/samples/net-binding.md
new file mode 100644
index 00000000000..1ba103a0634
--- /dev/null
+++ b/docs/framework/wcf/samples/net-binding.md
@@ -0,0 +1,33 @@
+---
+title: "ネット バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d10072a-ae0a-486a-b713-49703e26d9bf
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ネット バインディング
+このセクションには、エンドポイント要素のネットワーク バインディング属性の使用方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ネット MSMQ バインディング](../../../../docs/framework/wcf/samples/net-msmq-binding.md)  
+ エンドポイント要素の MSMQ バインディング属性の使用方法を示します。  
+  
+ [メッセージ キュー統合](../../../../docs/framework/wcf/samples/message-queueing-integration.md)  
+ メッセージ キューと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の間の統合を示します。  
+  
+ [NetTCPBinding](../../../../docs/framework/wcf/samples/nettcpbinding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での TCP バインディングの使用方法を示します。  
+  
+ [NetNamedPipeBinding](../../../../docs/framework/wcf/samples/netnamedpipebinding.md)  
+ 同じコンピューター上でのプロセス間通信を実現する `netNamedPipeBinding` バインディングを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/net-msmq-binding.md b/docs/framework/wcf/samples/net-msmq-binding.md
new file mode 100644
index 00000000000..792710d9952
--- /dev/null
+++ b/docs/framework/wcf/samples/net-msmq-binding.md
@@ -0,0 +1,51 @@
+---
+title: "ネット MSMQ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe4bb696-f57c-4cb3-9b7e-9d95fe6b8323
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ネット MSMQ バインディング
+このセクションには、エンドポイント要素の MSMQ バインディング属性の使用方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)  
+ メッセージ キュー \(MSMQ\) を使用して、トランザクション キューによる通信を実行する方法を示します。  
+  
+ [揮発性キューによる通信](../../../../docs/framework/wcf/samples/volatile-queued-communication.md)  
+ メッセージ キュー \(MSMQ\) トランスポートで揮発性キューによる通信を実行する方法を示します。  
+  
+ [配信不能キュー](../../../../docs/framework/wcf/samples/dead-letter-queues.md)  
+ 配信できなかったメッセージの処理方法を示します。  
+  
+ [MSMQ 4.0 での有害メッセージ処理](../../../../docs/framework/wcf/samples/poison-message-handling-in-msmq-4-0.md)  
+ MSMQ 4.0 を使用して、サービスで有害メッセージの処理を実行する方法を示します。  
+  
+ [セッションとキュー](../../../../docs/framework/wcf/samples/sessions-and-queues.md)  
+ メッセージ キュー \(MSMQ\) トランスポートを介して、キュー通信で一連の関連メッセージを送受信する方法を示します。  
+  
+ [双方向通信](../../../../docs/framework/wcf/samples/two-way-communication.md)  
+ MSMQ を介して、トランザクション キューによる双方向通信を実行する方法を示します。  
+  
+ [トランザクション バッチ](../../../../docs/framework/wcf/samples/transacted-batching.md)  
+ メッセージ キュー \(MSMQ\) を使用して、トランザクション読み取りをバッチ処理する方法を示します。  
+  
+ [SRMP](../../../../docs/framework/wcf/samples/srmp.md)  
+ HTTP 経由でメッセージ キュー \(MSMQ\) を使用して、トランザクション キューによる通信を実行する方法を示します。  
+  
+ [メッセージ キューを介したメッセージ セキュリティ](../../../../docs/framework/wcf/samples/message-security-over-message-queuing.md)  
+ クライアントの認証で X.509v3 証明書による WS\-Security を使用するアプリケーションを実装する方法を示します。このアプリケーションでは、MSMQ 経由でサーバーの X.509v3 証明書を使用するサーバー認証が必要です。  
+  
+ [ReceiveContext 製品ジェネレーター](../../../../docs/framework/wcf/samples/receivecontext-enabled-wcf-channels.md)  
+ <xref:System.ServiceModel.Channels.ReceiveContext> を有効にした WCF チャネルの有用性を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/net-tcp-port-sharing-sample.md b/docs/framework/wcf/samples/net-tcp-port-sharing-sample.md
new file mode 100644
index 00000000000..2fb79dd6d43
--- /dev/null
+++ b/docs/framework/wcf/samples/net-tcp-port-sharing-sample.md
@@ -0,0 +1,151 @@
+---
+title: "Net.TCP ポート共有のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03da5959-0574-4e91-8a53-05854b6c55dc
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# Net.TCP ポート共有のサンプル
+TCP\/IP プロトコルはポートと呼ばれる 16 ビットの番号を使用して、同じコンピュータ上で実行されている複数のネットワーク アプリケーションへの接続を区別します。アプリケーションがポートをリッスンすると、そのポートのすべての TCP トラフィックがそのアプリケーションに送られます。他のアプリケーションは、そのポートを同時にリッスンできません。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\TCP\PortSharing`  
+  
+ 多くのプロトコルは、使用する標準または既定のポート番号を持っています。たとえば、HTTP プロトコルは一般的に TCP ポート 80 を使用します。インターネット インフォメーション サービス \(IIS\) には、複数の HTTP アプリケーション間でポートを共有するためのリスナーがあります。IIS はポートを直接リッスンし、メッセージ ストリーム内の情報に基づいて、そのメッセージを適切なアプリケーションに転送します。これにより、複数の HTTP アプリケーションで、メッセージ受信用のポートの予約が競合することなく同じポート番号を使用できます。  
+  
+ NetTcp ポート共有は [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)]の機能で、同様に複数のネットワーク アプリケーションで 1 つのポートを共有させることができます。NetTcp ポート共有サービスは net.tcp プロトコルを使用して接続を受け入れ、メッセージの送信先アドレスに基づいてメッセージを転送します。  
+  
+ 既定では、NetTcp ポート共有サービスは有効ではありません。このサンプルを実行する前に、手動でサービスを有効にする必要があります。詳細については、「[方法 : Net.TCP ポート共有サービスを有効にする](../../../../docs/framework/wcf/feature-details/how-to-enable-the-net-tcp-port-sharing-service.md)」を参照してください。サービスが無効な場合は、サーバー アプリケーションの開始時に例外がスローされます。  
+  
+```  
+Unhandled Exception: System.ServiceModel.CommunicationException: The TransportManager failed to listen on the supplied URI using the NetTcpPortSharing service: failed to start the service because it is disabled. An administrator can enable it by running 'sc.exe config NetTcpPortSharing start= demand'.. ---> System.InvalidOperationException: Cannot start service NetTcpPortSharing on computer '.'. ---> System.ComponentModel.Win32Exception: The service cannot be started, either because it is disabled or because it has no enabled devices associated with it  
+```  
+  
+ ポート共有をサーバー上で有効にするには、<xref:System.ServiceModel.NetTcpBinding> バインディングまたは <xref:System.ServiceModel.Channels.TcpTransportBindingElement> バインディング要素の <xref:System.ServiceModel.NetTcpBinding.PortSharingEnabled%2A> プロパティを設定します。クライアントは、サーバー上で使用されるポート共有の構成内容を知る必要はありません。  
+  
+## ポート共有の有効化  
+ 次のコードでは、サーバー上でのポート共有の有効化を示します。ランダムな URI パスが含まれる固定ポートで、`ICalculator` サービスのインスタンスを開始します。2 つのサービスは同じポートを共有できますが、NetTcp ポート共有サービスが正しいアプリケーションにメッセージをルーティングできるように、これらのエンドポイント アドレスは全体で一意であることが必要です。  
+  
+```  
+// Configure a binding with TCP port sharing enabled  
+NetTcpBinding binding = new NetTcpBinding();  
+binding.PortSharingEnabled = true;  
+  
+// Start a service on a fixed TCP port  
+ServiceHost host = new ServiceHost(typeof(CalculatorService));  
+ushort salt = (ushort)new Random().Next();  
+string address =  
+   String.Format("net.tcp://localhost:9000/calculator/{0}", salt);  
+host.AddServiceEndpoint(typeof(ICalculator), binding, address);  
+host.Open();  
+```  
+  
+ ポート共有を有効にすると、ポート番号の競合を起こすことなく、何度もサービスを実行できます。コードを変更してポート共有を無効にした場合、サービスを 2 つ開始すると 2 つ目のサービスが失敗し、<xref:System.ServiceModel.AddressAlreadyInUseException> が発生します。  
+  
+```  
+Unhandled Exception: System.ServiceModel.AddressAlreadyInUseException: There is already a listener on IP endpoint 0.0.0.0:9000.  Make sure that you are not trying to use this endpoint multiple times in your application and that there are no other applications listening on this endpoint. ---> System.Net.Sockets.SocketException: Only one usage of each socket address (protocol/network address/port) is normally permitted  
+```  
+  
+## サンプルの実行  
+ テスト クライアントを使用して、ポートを共有しているサービスにメッセージが正しくルーティングされていることを確認できます。  
+  
+```  
+class client  
+{  
+   static void Main(string[] args)  
+   {  
+      Console.Write("Enter the service number to test: ");  
+      ushort salt = ushort.Parse(Console.ReadLine());  
+      string address = String.Format("net.tcp://localhost:9000/calculator/{0}", salt);  
+      ChannelFactory<ICalculator> factory = new ChannelFactory<ICalculator>(new NetTcpBinding());  
+      ICalculator proxy = factory.CreateChannel(new EndpointAddress(address));  
+  
+      // Call the Add service operation.  
+      double value1 = 100.00D;  
+      double value2 = 15.99D;  
+      double result = proxy.Add(value1, value2);  
+      Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+      // Call the Subtract service operation.  
+      value1 = 145.00D;  
+      value2 = 76.54D;  
+      result = proxy.Subtract(value1, value2);  
+      Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+      // Call the Multiply service operation.  
+      value1 = 9.00D;  
+      value2 = 81.25D;  
+      result = proxy.Multiply(value1, value2);  
+      Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+      // Call the Divide service operation.  
+      value1 = 22.00D;  
+      value2 = 7.00D;  
+      result = proxy.Divide(value1, value2);  
+      Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+  
+      Console.WriteLine();  
+      Console.WriteLine("Press <ENTER> to terminate client.");  
+      Console.ReadLine();  
+  
+      factory.Close();  
+   }  
+}  
+```  
+  
+ サービスの各インスタンスは、一意の番号とアドレスを出力します。たとえば、service.exe を実行すると、次のテキストが表示されます。  
+  
+```  
+Service #4381 listening on net.tcp://localhost:9000/calculator/4381.  
+Press <ENTER> to terminate service.  
+```  
+  
+ client.exe を実行する際に、ここに表示されるサービス番号を入力します。  
+  
+```  
+Enter the service number to test: 4381  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+ このサンプルは、クライアントが使用する生成アドレスを変更することにより、複数コンピュータの構成で実行できます。Client.cs で、エンドポイント アドレスの書式文字列をサービスの新しいアドレスに合わせます。"localhost" への参照をすべてサーバー コンピュータの IP アドレスに置き換えます。この変更を行った後に、サンプルを再コンパイルする必要があります。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  概要セクションに示したように、NetTcp ポート共有サービスを有効にします。  
+  
+4.  ソリューションの C\# 版 または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順を参照してください。  
+  
+5.  サンプルを単一コンピュータ構成または複数コンピュータ構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順を参照してください。このサンプルを実行するための詳細情報については、前述の「サンプルの実行」を参照してください。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/netnamedpipebinding.md b/docs/framework/wcf/samples/netnamedpipebinding.md
new file mode 100644
index 00000000000..13e397fc632
--- /dev/null
+++ b/docs/framework/wcf/samples/netnamedpipebinding.md
@@ -0,0 +1,109 @@
+---
+title: "NetNamedPipeBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "Net プロファイル名前付きパイプ"
+ms.assetid: e78e845f-c325-46e2-927d-81616f97f7d5
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# NetNamedPipeBinding
+このサンプルでは `netNamedPipeBinding` バインディングについて説明します。このバインディングは、同一コンピュータでのプロセス間通信を実現します。  名前付きパイプは、異なるコンピューター間では動作しません。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」の電卓サービスに基づいています。  
+  
+ このサンプルでは、サービスは自己ホスト型です。  クライアントとサービスは両方ともコンソール アプリケーションです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ バインディングは、クライアントとサービスの構成ファイルに指定されます。  バインディングの種類は、[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の `binding` 属性で指定します。次のサンプル構成を参照してください。  
+  
+```  
+<endpoint address="net.pipe://localhost/ServiceModelSamples/service"  
+          binding="netNamedPipeBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ 前のサンプルでは、`netNamedPipeBinding` バインディングを既定の設定で使用するようエンドポイントを構成する手順を示しました。  `netNamedPipeBinding` バインディングを構成してその設定の一部を変更する場合は、バインディング構成を定義する必要があります。  エンドポイントは、バインディング構成を `bindingConfiguration` 属性を使用して名前で参照します。  
+  
+```  
+<endpoint address="net.pipe://localhost/ServiceModelSamples/service"  
+          binding="netNamedPipeBinding"  
+          bindingConfiguration="Binding1"   
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+```  
+  
+ このサンプルでは、バインディング構成の名前は `Binding1` です。これは次のように定義されます。  
+  
+```  
+<bindings>  
+  <!--   
+        Following is the expanded configuration section for a NetNamedPipeBinding.  
+        Each property is configured with the default value.  
+     -->  
+  <netNamedPipeBinding>  
+    <binding name="Binding1"   
+             closeTimeout="00:01:00"  
+             openTimeout="00:01:00"   
+             receiveTimeout="00:10:00"   
+             sendTimeout="00:01:00"  
+             transactionFlow="false"   
+             transferMode="Buffered"   
+             transactionProtocol="OleTransactions"  
+             hostNameComparisonMode="StrongWildcard"   
+             maxBufferPoolSize="524288"  
+             maxBufferSize="65536"   
+             maxConnections="10"   
+             maxReceivedMessageSize="65536">  
+      <security mode="Transport">  
+        <transport protectionLevel="EncryptAndSign" />  
+      </security>  
+    </binding>  
+  </netNamedPipeBinding>  
+</bindings>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\NamedPipe`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/nettcpbinding.md b/docs/framework/wcf/samples/nettcpbinding.md
new file mode 100644
index 00000000000..3e12d31cd75
--- /dev/null
+++ b/docs/framework/wcf/samples/nettcpbinding.md
@@ -0,0 +1,27 @@
+---
+title: "NetTCPBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1690b42f-acfd-4bb3-8f0d-0b17cd5ca36c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# NetTCPBinding
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での TCP バインディングの使用方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [既定の NetTcpBinding](../../../../docs/framework/wcf/samples/default-nettcpbinding.md)  
+ <xref:System.ServiceModel.NetTcpBinding> バインディングの使用方法を示します。  
+  
+ [Net.TCP ポート共有のサンプル](../../../../docs/framework/wcf/samples/net-tcp-port-sharing-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での TCP ポート共有を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/object-references.md b/docs/framework/wcf/samples/object-references.md
new file mode 100644
index 00000000000..a925665303f
--- /dev/null
+++ b/docs/framework/wcf/samples/object-references.md
@@ -0,0 +1,125 @@
+---
+title: "オブジェクト参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a93d260-91c3-4448-8f7a-a66fb562fc23
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# オブジェクト参照
+このサンプルでは、サーバーとクライアント間でオブジェクトを参照渡しする方法を示します。このサンプルでは、シミュレートされた*ソーシャル ネットワーク*を使用します。ソーシャル ネットワークは、友人のリストを含んでいる `Person` クラスで構成され、このリストの各友人は、それぞれ独自の友人のリストを持つ `Person` クラスのインスタンスです。これにより、オブジェクトのグラフが作成されます。このようなソーシャル ネットワークに対する操作は、サービスによって公開されます。  
+  
+ この例では、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされています。クライアントはコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## サービス  
+ `Person` クラスに <xref:System.Runtime.Serialization.DataContractAttribute> 属性が適用され、参照型であることを宣言するため <xref:System.Runtime.Serialization.DataContractAttribute.IsReference%2A> フィールドが `true` に設定されます。すべてのプロパティに <xref:System.Runtime.Serialization.DataMemberAttribute> 属性が適用されます。  
+  
+```  
+[DataContract(IsReference=true)]  
+public class Person  
+{  
+    string name;  
+    string location;  
+    string gender;  
+    int age;  
+    List<Person> friends;  
+    [DataMember()]  
+    public string Name  
+    {  
+        get { return name; }  
+        set { name = value; }  
+    }  
+    [DataMember()]  
+    public string Location  
+    {  
+        get { return location; }  
+        set { location = value; }  
+    }  
+    [DataMember()]  
+    public string Gender  
+    {  
+        get { return gender; }  
+        set { gender = value; }  
+    }  
+…  
+}  
+```  
+  
+ `GetPeopleInNetwork` 操作では、`Person` 型のパラメータを受け取り、ネットワーク内のすべてのユーザー \(`friends` リストに含まれるすべてのユーザー、友人の友人など\) を重複することなく返します。  
+  
+```  
+public List<Person> GetPeopleInNetwork(Person p)  
+{  
+    List<Person> people = new List<Person>();  
+    ListPeopleInNetwork(p, people);  
+    return people;  
+  
+}  
+```  
+  
+ `GetMutualFriends` 操作では、`Person` 型のパラメータを受け取り、自分の `friends` リストにこの人物も存在するリスト内のすべての友人を返します。  
+  
+```  
+public List<Person> GetMutualFriends(Person p)  
+{  
+    List<Person> mutual = new List<Person>();  
+    foreach (Person friend in p.Friends)  
+    {  
+        if (friend.Friends.Contains(p))  
+            mutual.Add(friend);  
+    }  
+    return mutual;  
+}  
+```  
+  
+ `GetCommonFriends` 操作では、`Person` 型のリストを受け取ります。このリストには、2 つの `Person` オブジェクトが存在します。この操作では、入力リストの両方の `Person` オブジェクトの `friends` リスト内にある `Person` オブジェクトのリストを返します。  
+  
+```  
+public List<Person> GetCommonFriends(List<Person> people)  
+{  
+    List<Person> common = new List<Person>();  
+    foreach (Person friend in people[0].Friends)  
+        if (people[1].Friends.Contains(friend))  
+            common.Add(friend);  
+    return common;  
+}  
+```  
+  
+## クライアント  
+ クライアント プロキシは、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の**サービス参照の追加**機能を使用して作成されます。  
+  
+ 5 つの `Person` オブジェクトで構成されるソーシャル ネットワークが作成されます。クライアントは、サービスの 3 つのメソッドをそれぞれ呼び出します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\ObjectReferences`  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute.IsReference%2A>   
+ [相互運用可能なオブジェクト参照](../../../../docs/framework/wcf/feature-details/interoperable-object-references.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md b/docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md
new file mode 100644
index 00000000000..406cf7d3aeb
--- /dev/null
+++ b/docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md
@@ -0,0 +1,96 @@
+---
+title: "Windows Communication Foundation サンプルの 1 回限りのセットアップの手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5848ffd-3eb5-432d-812e-bd948ccb6bca
+caps.latest.revision: 83
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 83
+---
+# Windows Communication Foundation サンプルの 1 回限りのセットアップの手順
+ほとんどの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルは、インターネット インフォメーション サービス \(IIS\) でホストされ、共通の仮想ディレクトリから実行されます。この 1 回限りのセットアップの手順では、ディスク上にフォルダーを作成します。また、**ServiceModelSamples** という名前の仮想ディレクトリを IIS に追加します。  
+  
+ **ServiceModelSamples** 仮想ディレクトリは、IIS でホストされるサービスを使用するすべてのサンプルのビルドと実行に使用されます。サンプルの実行に必要な仮想ディレクトリはこれだけです。サンプルをビルドすると、この仮想ディレクトリにある、以前に配置されたサービスがすべて置き換えられます。この仮想ディレクトリには最近ビルドされたサンプルだけが配置されるため、そのサンプルしか使用できません。  
+  
+> [!NOTE]
+>  すべてのコマンドは、ローカル管理者アカウントで実行する必要があります。Windows 7、[!INCLUDE[windowsver](../../../../includes/windowsver-md.md)]、または Windows Server 2008 R2 を使用している場合は、コマンド プロンプトも管理者権限で実行する必要があります。これには、コマンド プロンプトのアイコンを右クリックし、**\[管理者として実行\]** をクリックします。このトピックで使用するすべてのコマンドは、適切なパスが設定されているコマンド プロンプトで実行する必要があります。このようにするための最も簡単な方法は、Visual Studio コマンド プロンプトを使用する方法です。Visual Studio コマンド プロンプトを開くには、**\[スタート\]** ボタンをクリックして **\[すべてのプログラム\]** をポイントし、下方向へスクロールして **\[Visual Studio 2010\]**、**\[Visual Studio Tools\]** の順にクリックします。次に、**\[Visual Studio コマンド プロンプト \(2010\)\]** を右クリックして、**\[管理者として実行\]** をクリックします。Visual Studio Express Editions のいずれかがインストールされている場合は、このコマンド プロンプトを使用できません。この場合、システム パスに "C:\\Windows\\Microsoft.Net\\Framework\\v4.0" を追加する必要があります。  
+  
+### WCF サンプルの 1 回限りのセットアップの手順  
+  
+1.  [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] がセットアップされていることを確認します。[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] のセットアップ方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[インターネット インフォメーション サービスのホスティング手順](../../../../docs/framework/wcf/samples/internet-information-service-hosting-instructions.md)」を参照してください。  
+  
+2.  [!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] がインストールされていることを確認します。**\\Windows\\Microsoft.NET\\Framework** ディレクトリに、v4.0 以降があることを確認します。  
+  
+3.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] がインストールされておらず、オペレーティング システムが Windows Server 2008 SP2 以降でない場合は、[修正プログラム 251798](http://go.microsoft.com/fwlink/?LinkId=184693) をインストールします。  
+  
+4.  次のコマンドを実行します。これらのコマンドを実行しなければならない理由については、「[IIS Hosted Service Fails](http://msdn.microsoft.com/ja-jp/ee5499fc-1b10-4cda-a9b1-13dba70f05f8)」を参照してください。  
+  
+    > [!WARNING]
+    >  IIS を再インストールした場合は、次のコマンドを再実行します。  
+  
+    ```  
+    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable  
+    "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -r  
+    ```  
+  
+    > [!WARNING]
+    >  コマンド `aspnet_regiis –i –enable` を実行すると、[!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] を使用して、既定のアプリケーション プールが実行されます。このとき、同じコンピューター上の他のアプリケーションで非互換性の問題が発生することがあります。  
+  
+5.  「[ファイアウォール手順](../../../../docs/framework/wcf/samples/firewall-instructions.md)」に従って、サンプルで使用するポートを有効にします。  
+  
+6.  既定のディレクトリ \(**\<InstallDrive\>InstallDrive:\\WF\_WCF\_Samples**\) を確認してください。サンプルが既にインストールされている場合は、これが既定のディレクトリです。  
+  
+7.  サンプルがインストールされていない場合は、[Visual C\#](http://go.microsoft.com/fwlink/?LinkId=190939) または [Visual Basic](http://go.microsoft.com/fwlink/?LinkID=193373) のサンプルのダウンロード場所からインストールします。  
+  
+8.  サンプルをインストールした後、\<InstallDrive\>:**\\WF\_WCF\_Samples\\WCF\\Setup\\** に移動します。  
+  
+9. **Setupvroot.bat** バッチ ファイルを実行します。次の手順が実行されます。  
+  
+    -   ServiceModelSamples という名前の仮想ディレクトリが IIS に作成されます。  
+  
+    -   %SystemDrive%\\Inetpub\\wwwroot\\ServiceModelSamples and %SystemDrive%\\Inetpub\\wwwroot\\ServiceModelSamples\\bin という名前の新しいディスク ディレクトリが作成されます。  
+  
+     これらのディレクトリを手動でセットアップする場合は、「[仮想ディレクトリのセットアップ手順](../../../../docs/framework/wcf/samples/virtual-directory-setup-instructions.md)」を参照してください。この手順で行ったすべての変更を元に戻すには、サンプルの使用が終わった後で cleanupvroot.bat を実行します。  
+  
+    > [!NOTE]
+    >  cleanupvroot.bat を実行しない限り、この手順を実行するのは、1 台のコンピューターで 1 回だけです。  
+  
+10. サンプルおよび Network Service ユーザーのビルドに使用するアカウントに対し、%SystemDrive%\\inetpub\\wwwroot の変更権限を付与する必要があります。ビルドの実行時に、Web ホストの一部のサンプルがコンパイル済みバイナリを前述の場所にコピーしようとする場合があり、適切な権限が設定されていないと、ビルドは破損します。代わりに、アクセス許可の設定はそのままにして、SDK コマンド プロンプトまたは Visual Studio コマンド プロンプト \(2012\) を管理者として実行するか、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を管理者として実行し、サンプルをビルドすることもできます。  
+  
+    > [!NOTE]
+    >  この手順を完了していない場合は、ビルドの実行時に IIS でホストされているすべてのサンプルでエラーが発生します。アクセス許可が正しく設定されていることを確認するか、SDK コマンド プロンプトと Visual Studio コマンド プロンプト \(2012\) を管理者として実行してください。  
+  
+11. コンピューター上に C:\\logs ディレクトリを作成します \(一部のサンプルで必要になることがあります\)。このフォルダーに対する書き込みアクセスが適切なアカウントに付与されていることを確認してください。このアカウントは、Windows 7、[!INCLUDE[wv](../../../../includes/wv-md.md)]、Windows Server 2008 R2 では **Network Service**、[!INCLUDE[lserver](../../../../includes/lserver-md.md)] では NT Authority\\Network Service、[!INCLUDE[wxp](../../../../includes/wxp-md.md)] および [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では ASPNET です。  
+  
+12. Setupcerttool.bat ファイルを実行します。このファイルは、\<InstallPath\>\\WF\_WCF\_Samples\\WCF\\Setup\\ フォルダーにあります。このスクリプトでは、次のタスクが実行されます。  
+  
+    -   FindPrivateKey ツールをビルドします。  
+  
+    -   %ProgramFiles%\\ServiceModelSampleTools という名前のディレクトリを作成します。  
+  
+    -   新しい FindPrivateKey ツールをこのディレクトリにコピーします。  
+  
+     このツールは、証明書を使用して IIS でホストされるサンプルで必要です。  
+  
+    > [!NOTE]
+    >  セキュリティの目的で、サンプルの使用が終わったら、このセットアップ手順で付与された仮想ディレクトリの定義とアクセス許可を必ず削除してください。削除するには、Cleanupvroot.bat という名前のバッチ ファイルを実行します。  
+  
+13. 自己ホスト型の \(IIS でホストされていない\) サンプルでは、リッスンを行うコンピューター上で HTTP アドレスを登録するためのアクセス許可が必要です。HTTP 名前空間予約のアクセス許可は、サンプルの実行に使用されるユーザー アカウントから提供されます。既定では、管理者アカウントには、任意の HTTP アドレスを登録するためのアクセス許可があります。管理者以外のアカウントの場合は、サンプルで使用される HTTP 名前空間へのアクセス許可が付与される必要があります。名前空間予約の構成方法[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[HTTP および HTTPS の構成](../../../../docs/framework/wcf/feature-details/configuring-http-and-https.md)」を参照してください。  
+  
+14. 一部のサンプルにはメッセージ キューが必要です。インストールの処理手順については、「[メッセージ キュー \(MSMQ\) のインストール](../../../../docs/framework/wcf/samples/installing-message-queuing-msmq.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  メッセージ キューが必要なサンプルを実行する場合は、MSMQ サービスを事前に開始しておいてください。  
+  
+15. 一部のサンプルには証明書が必要です。「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」を参照してください。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/one-way.md b/docs/framework/wcf/samples/one-way.md
new file mode 100644
index 00000000000..0725606c209
--- /dev/null
+++ b/docs/framework/wcf/samples/one-way.md
@@ -0,0 +1,120 @@
+---
+title: "一方向 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74e3e03d-cd15-4191-a6a5-1efa2dcb9e73
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 一方向
+このサンプルでは、一方向サービス操作へのサービスのアクセスを示します。クライアントは、双方向サービス操作の場合と同様、サービス操作の完了を待機しません。このサンプルは「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づき、`wsHttpBinding` バインディングを使用しています。このサンプルでは、サービスは自己ホスト型コンソール アプリケーションであり、サービスが要求を受信して処理するかどうかを監視できます。また、クライアントもコンソール アプリケーションです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 一方向サービス コントラクトを作成するには、サービス コントラクトを定義し、<xref:System.ServiceModel.OperationContractAttribute> クラスを各操作に適用し、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> を `true` に設定します。次のコードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOneWayCalculator  
+{  
+    [OperationContract(IsOneWay=true)]  
+    void Add(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Subtract(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Multiply(double n1, double n2);  
+    [OperationContract(IsOneWay = true)]  
+    void Divide(double n1, double n2);  
+}  
+  
+```  
+  
+ クライアントがサービス操作の完了を待機しないことを示すため、このサンプルではサービス コードに 5 秒の遅延を実装します。次のサンプル コードを参照してください。  
+  
+```  
+/ This service class implements the service contract.  
+// This code writes output to the console window.  
+ [ServiceBehavior(ConcurrencyMode = ConcurrencyMode.Multiple,  
+    InstanceContextMode = InstanceContextMode.PerCall)]  
+public class CalculatorService : IOneWayCalculator  
+{  
+    public void Add(double n1, double n2)  
+    {  
+        Console.WriteLine("Received Add({0},{1}) - sleeping", n1, n2);  
+        System.Threading.Thread.Sleep(1000 * 5);  
+        double result = n1 + n2;  
+        Console.WriteLine("Processing Add({0},{1}) - result: {2}", n1, n2, result);  
+    }  
+    ...  
+}  
+  
+```  
+  
+ クライアントがサービスを呼び出すと、サービス操作の完了を待たずに呼び出しが返されます。  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントから受信したメッセージを表示できます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+ 先にクライアントが完了してその次にサービスが完了し、クライアントが一方向サービス操作の完了を待たないことが示されます。クライアントからの出力を次に示します。  
+  
+```  
+Add(100,15.99)  
+Subtract(145,76.54)  
+Multiply(9,81.25)  
+Divide(22,7)  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ サービスからの出力が次のように表示されます。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Received Add(100,15.99) - sleeping  
+Received Subtract(145,76.54) - sleeping  
+Received Multiply(9,81.25) - sleeping  
+Received Divide(22,7) - sleeping  
+Processing Add(100,15.99) - result: 115.99  
+Processing Subtract(145,76.54) - result: 68.46  
+Processing Multiply(9,81.25) - result: 731.25  
+Processing Divide(22,7) - result: 3.14285714285714  
+  
+```  
+  
+> [!NOTE]
+>  HTTP は本来、要求\/応答プロトコルです。つまり、要求が行われると応答が返されます。これは、HTTP を介して公開される一方向サービス操作にも当てはまります。この操作が呼び出されると、サービスは HTTP ステータス コード 202 を返し、その後サービス操作が実行されます。このステータス コードは、要求は処理用に受け入れられたが、処理はまだ完了していないことを示します。操作を呼び出したクライアントは、サービスから 202 応答を受信するまでブロックします。これにより、セッションを使用するように構成されているバインディングを使用して複数の一方向メッセージが送信されたときに、いくつかの予期しない動作が発生する場合があります。このサンプルで使用されている `wsHttpBinding` バインディングは、既定ではセッションを使用してセキュリティ コンテキストを確立するように構成されています。既定では、セッション内のメッセージは、送信される順序で到着することが保証されています。このため、セッション内の 2 番目のメッセージが送信されても、最初のメッセージが処理されるまでは処理されません。この結果、クライアントは、前のメッセージの処理が完了するまではメッセージの 202 応答を受信しません。このため、クライアントは以降のそれぞれの操作呼び出しでブロックしているように見えます。この動作を回避するため、サンプルでは、メッセージを処理用の各インスタンスに同時にディスパッチするようにランタイムを構成します。サンプルでは、各メッセージが異なるインスタンスによって処理できるように <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> を `PerCall` に設定します。複数のスレッドがメッセージを同時にディスパッチするように、<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A> が `Multiple` に設定されています。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  サービスを先に実行してからクライアントを実行してください。また、クライアントをシャットダウンした後でサービスをシャットダウンしてください。これにより、サービスが終了したことによりクライアントでセキュリティ セッションが正常に終了できない場合に発生する、クライアント側の例外が回避できます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Oneway`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/operation-formatter-and-operation-selector.md b/docs/framework/wcf/samples/operation-formatter-and-operation-selector.md
new file mode 100644
index 00000000000..6dd1ce83629
--- /dev/null
+++ b/docs/framework/wcf/samples/operation-formatter-and-operation-selector.md
@@ -0,0 +1,188 @@
+---
+title: "操作フォーマッタと操作セレクター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c27e9fe-11f8-4377-8140-828207b98a0e
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# 操作フォーマッタと操作セレクター
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 拡張ポイントを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] で想定されている形式と異なる形式のメッセージ データを許可する方法を示します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] フォーマッタの既定では、メソッド パラメータが `soap:body` 要素の下に格納されることが想定されています。このサンプルでは、代わりに HTTP GET クエリ文字列のパラメータ データを解析するカスタム操作フォーマッタを実装し、そのデータを使用してメソッドを呼び出す方法を示します。  
+  
+ このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。加算、減算、乗算、および除算のメッセージを変更して、クライアントからサーバーへの要求を行うための HTTP GET と、サーバーからクライアントへの要求を行うための POX メッセージ付きの HTTP POST を使用する方法を示します。  
+  
+ これを行うために、サンプルには次の機能が用意されています。  
+  
+-   `QueryStringFormatter`。クライアントとサーバー用に、それぞれ <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> と <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> を実装し、クエリ文字列内のデータを処理します。  
+  
+-   `UriOperationSelector`。サーバー上に、GET 要求内の操作名に基づいて操作ディスパッチを実行する <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> を実装します。  
+  
+-   `EnableHttpGetRequestsBehavior` エンドポイント動作 \(および対応する構成\)。必要な操作セレクタをランタイムに追加します。  
+  
+-   新しい操作フォーマッタをランタイムに挿入する方法を示します。  
+  
+-   このサンプルでは、クライアントとサービスは両方ともコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## 重要な概念  
+ `QueryStringFormatter` \- この操作フォーマッタは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 内のコンポーネントで、メッセージをパラメータ オブジェクトの配列に変換したり、逆にパラメータ オブジェクトの配列をメッセージに変換したりします。この操作は、クライアント上では <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> インターフェイスを使用して、サーバー上では <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> インターフェイスを使用して行われます。これらのインターフェイスを使用すると、ユーザーは `Serialize` メソッドと `Deserialize` メソッドから要求メッセージと応答メッセージを取得できます。  
+  
+ このサンプルでは、`QueryStringFormatter` にこれら両方のインターフェイスが実装され、クライアントとサーバーで実装されます。  
+  
+ 要求 :  
+  
+-   このサンプルでは、<xref:System.ComponentModel.TypeConverter> クラスを使用して要求メッセージ内のパラメータ データを文字列に変換したり、その逆の処理を行ったりします。<xref:System.ComponentModel.TypeConverter> が特定の型で使用できない場合は、サンプルのフォーマッタから例外がスローされます。  
+  
+-   クライアントの `IClientMessageFormatter.SerializeRequest` メソッドでは、フォーマッタは適切な宛先アドレスを使用して URI を作成し、操作名をサフィックスとして追加します。この操作名は、サーバー上の適切な操作へのディスパッチに使用されます。次にパラメータ名と <xref:System.ComponentModel.TypeConverter> によって変換された値を使用して、パラメータ オブジェクトの配列を取得し、そのパラメータ データを URI クエリ文字列にシリアル化します。<xref:System.ServiceModel.Channels.MessageHeaders.To%2A> プロパティおよび <xref:System.ServiceModel.Channels.MessageProperties.Via%2A> プロパティは、この URI に設定されます。<xref:System.ServiceModel.Channels.MessageProperties> にアクセスするには、<xref:System.ServiceModel.Channels.Message.Properties%2A> プロパティを使用します。  
+  
+-   サーバーの `IDispatchMessageFormatter.DeserializeRequest` メソッドでは、フォーマッタは受信要求メッセージ プロパティ内で`Via` URI を検索します。次に URI クエリ文字列内にある名前と値の組み合わせを解析してパラメータ名と値に分け、そのパラメータ名と値を使用してこのメソッドに渡されるパラメータの配列を設定します。操作ディスパッチは既に発生しているので、このメソッドでは操作名のサフィックスは無視されます。  
+  
+ 応答 :  
+  
+-   このサンプルでは、HTTP GET は要求のみに使用されます。応答を送信するには、フォーマッタを XML メッセージの生成時に使用できたはずの最初のフォーマッタに代行させます。このサンプルの目的の 1 つは、このような代行フォーマッタの実装方法を示すことです。  
+  
+### UriPathSuffixOperationSelector クラス  
+ <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> インターフェイスを使用すると、特定のメッセージをディスパッチする必要がある操作で、ユーザー独自のロジックを実装できます。  
+  
+ このサンプルでは、操作名がメッセージのアクション ヘッダーではなく、HTTP GET URI に含まれているため、適切な操作を選択するには、`UriPathSuffixOperationSelector` がサーバーに実装されている必要があります。サンプルは、大文字小文字が区別されない操作名のみを許可するようにセットアップされています。  
+  
+ `SelectOperation` メソッドは、受信メッセージを取得し、メッセージ プロパティ内の `Via` URI を検索します。次に、この URI から操作名のサフィックスを抽出し、内部テーブルを検索してメッセージをディスパッチする必要がある操作名を取得して、その操作名を返します。  
+  
+### EnableHttpGetRequestsBehavior クラス  
+ `UriPathSuffixOperationSelector` コンポーネントは、プログラムまたはエンドポイント動作を使用してセットアップできます。サンプルでは、サービスのアプリケーション構成ファイルで指定された `EnableHttpGetRequestsBehavior` の動作を実装します。  
+  
+ サーバー側 :  
+  
+ <xref:System.ServiceModel.Dispatcher.DispatchRuntime.OperationSelector%2A> は <xref:System.ServiceModel.Dispatcher.IDispatchOperationSelector> 実装に設定されます。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、既定では完全一致のアドレス フィルタを使用します。受信メッセージ上の URI には、操作名のサフィックスと、その後にパラメータ データを格納するクエリ文字列が含まれています。したがって、アドレス フィルタは、エンドポイントの動作によっても、プレフィックスが一致するフィルタに変更されます。このために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]<xref:System.ServiceModel.Dispatcher.PrefixEndpointAddressMessageFilter> が使用されます。  
+  
+### 操作フォーマッタのインストール  
+ フォーマッタを指定する操作の動作は一意です。このような動作は、常に既定で操作ごとに実装され、必要な操作フォーマッタを作成します。ただし、これらの動作は他の操作動作と同様に見えるため、他の属性では識別できません。置換動作をインストールするには、この実装で、既定で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 型ローダーによってインストールされる特定のフォーマッタの動作を検索し、その動作に置き換えるか、または互換性のある動作を追加して既定の動作後に実行する必要があります。  
+  
+ これらの操作フォーマッタの動作は、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A?displayProperty=fullName> を呼び出す前にプログラムでセットアップするか、または既定のフォーマッタ動作後に実行される操作動作を指定することによってセットアップすることができます。ただし、エンドポイント動作を介したセットアップ \(および構成を介したセットアップ\) は容易ではありません。この動作モデルでは、動作によって別の動作を置き換えることはできず、他の方法で説明ツリーを変更することもできないためです。  
+  
+ クライアント側 :  
+  
+ <xref:System.ServiceModel.Dispatcher.IClientMessageFormatter> の実装を行って、要求を HTTP GET 要求に変換し、応答を元のフォーマッタに代行させる必要があります。これを行うには、`EnableHttpGetRequestsBehavior.ReplaceFormatterBehavior` ヘルパー メソッドを呼び出します。  
+  
+ この手順は、`CreateChannel` を呼び出す前に行う必要があります。  
+  
+```  
+void ReplaceFormatterBehavior(OperationDescription operationDescription, EndpointAddress address)  
+{  
+    // Remove the DataContract behavior if it is present.  
+    IOperationBehavior formatterBehavior = operationDescription.Behaviors.Remove<DataContractSerializerOperationBehavior>();  
+    if (formatterBehavior == null)  
+    {  
+        // Remove the XmlSerializer behavior if it is present.  
+        formatterBehavior = operationDescription.Behaviors.Remove<XmlSerializerOperationBehavior>();  
+        ...  
+    }  
+  
+    // Remember what the innerFormatterBehavior was.  
+    DelegatingFormatterBehavior delegatingFormatterBehavior = new DelegatingFormatterBehavior(address);  
+    delegatingFormatterBehavior.InnerFormatterBehavior = formatterBehavior;  
+   operationDescription.Behaviors.Add(delegatingFormatterBehavior);  
+}  
+```  
+  
+ サーバー側 :  
+  
+-   <xref:System.ServiceModel.Dispatcher.IDispatchMessageFormatter> インターフェイスを実装して、HTTP GET 要求を読み込み、応答の書き出しを元のフォーマッタに代行させる必要があります。これを行うには、クライアントと同じ`EnableHttpGetRequestsBehavior.ReplaceFormatterBehavior` ヘルパー メソッドを呼び出します \(前述のコード サンプルを参照\)。  
+  
+-   この手順は、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> を呼び出す前に行う必要があります。このサンプルでは、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> を呼び出す前にこのフォーマッタを手動で変更する方法を示します。同じ結果を得るための別の方法としては、オープン操作の前に `EnableHttpGetRequestsBehavior.ReplaceFormatterBehavior` を呼び出す <xref:System.ServiceModel.ServiceHost> からクラスを派生します \(ホスティングのドキュメントおよびサンプル例を参照してください\)。  
+  
+### ユーザー エクスペリエンス  
+ サーバー側 :  
+  
+-   サーバーの `ICalculator` 実装は、変更する必要はありません。  
+  
+-   サービス用の App.config では、`textMessageEncoding` 要素の `messageVersion` 属性を `None` に設定するカスタムの POX バインディングを使用する必要があります。  
+  
+    ```  
+    <bindings>  
+      <customBinding>  
+        <binding name="poxBinding">  
+          <textMessageEncoding messageVersion="None" />  
+          <httpTransport />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    ```  
+  
+-   サービス用の App.config ではさらに、カスタムの `EnableHttpGetRequestsBehavior` を動作の拡張セクションに追加して使用することによって、これを指定する必要があります。  
+  
+    ```  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="enableHttpGetRequestsBehavior">  
+          <enableHttpGetRequests />  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  
+    <extensions>  
+      <behaviorExtensions>  
+        <!-- Enabling HTTP GET requests: Behavior Extension -->  
+        <add   
+          name="enableHttpGetRequests"           type="Microsoft.ServiceModel.Samples.EnableHttpGetRequestsBehaviorElement, QueryStringFormatter, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+      </behaviorExtensions>  
+    </extensions>  
+    ```  
+  
+-   <xref:System.ServiceModel.Channels.CommunicationObject.Open%2A> を呼び出す前に操作フォーマッタを追加します。  
+  
+ クライアント側 :  
+  
+-   クライアントの実装は、変更する必要はありません。  
+  
+-   クライアント用の App.config では、`textMessageEncoding` 要素の `messageVersion` 属性を `None` に設定するカスタムの POX バインディングを使用する必要があります。サービスとの違いは、クライアントでは送信先アドレスを変更できるように手動アドレス指定を有効にする必要があるという点です。  
+  
+    ```  
+    <bindings>  
+      <customBinding>  
+        <binding name="poxBinding">  
+          <textMessageEncoding messageVersion="None" />  
+          <httpTransport manualAddressing="True" />  
+        </binding>  
+      </customBinding>  
+    </bindings>  
+    ```  
+  
+-   クライアント用の App.config では、サーバーと同じカスタムの `EnableHttpGetRequestsBehavior` を指定する必要があります。  
+  
+-   <xref:System.ServiceModel.ChannelFactory%601.CreateChannel> を呼び出す前に操作フォーマッタを追加します。  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。4 つすべての操作 \(加算、減算、乗算、および除算\) が正常に行われる必要があります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Formatters\QuieryStringFormatter`  
+  
+##### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/operationcontextscope.md b/docs/framework/wcf/samples/operationcontextscope.md
new file mode 100644
index 00000000000..6c7ddf6483d
--- /dev/null
+++ b/docs/framework/wcf/samples/operationcontextscope.md
@@ -0,0 +1,141 @@
+---
+title: "OperationContextScope | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11c11108-8eb4-4d49-95a0-83285a812262
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# OperationContextScope
+OperationContextScope サンプルでは、ヘッダーを使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 呼び出しに追加情報を送信する方法を示します。このサンプルでは、サーバーとクライアントは両方ともコンソール アプリケーションです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、<xref:System.ServiceModel.OperationContextScope> を使用して、クライアントが <xref:System.ServiceModel.Channels.MessageHeader> として追加情報を送信する方法を示します。<xref:System.ServiceModel.OperationContextScope> オブジェクトのスコープをチャネルに指定することにより、このオブジェクトが作成されます。リモート サービスに変換される必要があるヘッダーは、<xref:System.ServiceModel.OperationContext.OutgoingMessageHeaders%2A> コレクションに追加できます。このコレクションに追加されたヘッダーは、<xref:System.ServiceModel.OperationContext.IncomingMessageHeaders%2A> にアクセスすることによってサービス上で取得できます。このヘッダー呼び出しは複数のチャネル上で行われ、クライアントに追加されたヘッダーは、<xref:System.ServiceModel.OperationContextScope> の作成に使用されたチャネルのみに適用されます。  
+  
+## MessageHeaderReader  
+ このサンプルは、クライアントからメッセージを受信し、<xref:System.ServiceModel.OperationContext.IncomingMessageHeaders%2A> コレクション内のヘッダーの検索を試行するサービスです。クライアントは送信した GUID をヘッダー内に渡し、サービスはカスタム ヘッダーを取得します。カスタム ヘッダーがある場合は、引数としてクライアントによって渡された GUID と比較します。  
+  
+```  
+public bool RetrieveHeader(string guid)  
+{  
+     MessageHeaders messageHeaderCollection =   
+             OperationContext.Current.IncomingMessageHeaders;  
+     String guidHeader = null;  
+  
+     Console.WriteLine("Trying to check if IncomingMessageHeader " +  
+               " collection contains header with value {0}", guid);  
+     if (messageHeaderCollection.FindHeader(  
+                       CustomHeader.HeaderName,   
+                       CustomHeader.HeaderNamespace) != -1)  
+     {  
+          guidHeader = messageHeaderCollection.GetHeader<String>(  
+           CustomHeader.HeaderName, CustomHeader.HeaderNamespace);  
+     }  
+     else  
+     {  
+          Console.WriteLine("No header was found");  
+     }  
+     if (guidHeader != null)  
+     {  
+          Console.WriteLine("Found header with value {0}. "+   
+         "Does it match with GUID sent as parameter: {1}",   
+          guidHeader, guidHeader.Equals(guid));  
+      }  
+  
+      Console.WriteLine();  
+      //Return true if header is present and equals the guid sent by  
+      // client as argument  
+      return (guidHeader != null && guidHeader.Equals(guid));  
+}  
+```  
+  
+## MessageHeaderClient  
+ これは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成されたプロキシを使用してリモート サービスと通信するクライアント実装です。`MessageHeaderReaderClient` の 2 つのプロキシ オブジェクトが最初に作成されます。  
+  
+```  
+//Create two clients to the remote service.  
+MessageHeaderReaderClient client1 = new MessageHeaderReaderClient();  
+MessageHeaderReaderClient client2 = new MessageHeaderReaderClient();  
+```  
+  
+ 次に、クライアントは OperationContextScope を作成し、スコープを `client1` に指定します。<xref:System.ServiceModel.Channels.MessageHeader> が <xref:System.ServiceModel.OperationContext.OutgoingMessageHeaders%2A> に追加され、両方のクライアントで 1 つの呼び出しが行われます。そのため、`RetrieveHeader` 呼び出しからの戻り値をチェックすることによって、ヘッダーは `client1` のみに送信され、`client2` には送信されません。  
+  
+```  
+using (new OperationContextScope(client1.InnerChannel))  
+{  
+    //Create a new GUID that is sent as the header.  
+    String guid = Guid.NewGuid().ToString();  
+  
+    //Create a MessageHeader for the GUID we just created.  
+    MessageHeader customHeader = MessageHeader.CreateHeader(CustomHeader.HeaderName, CustomHeader.HeaderNamespace, guid);  
+  
+    //Add the header to the OutgoingMessageHeader collection.  
+    OperationContext.Current.OutgoingMessageHeaders.Add(customHeader);  
+  
+    //Now call RetreieveHeader on both the proxies. Since the OperationContextScope is tied to   
+    //client1's InnerChannel, the header should only be added to calls made on that client.  
+    //Calls made on client2 should not be sending the header across even though the call  
+    //is made in the same OperationContextScope.  
+    Console.WriteLine("Using client1 to send message");  
+    Console.WriteLine("Did server retrieve the header? : Actual: {0}, Expected: True", client1.RetrieveHeader(guid));  
+  
+    Console.WriteLine();  
+    Console.WriteLine("Using client2 to send message");  
+    Console.WriteLine("Did server retrieve the header? : Actual: {0}, Expected: False", client2.RetrieveHeader(guid));  
+}  
+```  
+  
+ このサンプルは自己ホスト型です。実行中のサンプルから、次のようなサンプル出力が提供されます。  
+  
+```  
+Prompt> Service.exe  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Trying to check if IncomingMessageHeader collection contains header with value 2239da67-546f-42d4-89dc-8eb3c06215d8  
+Found header with value 2239da67-546f-42d4-89dc-8eb3c06215d8. Does it match with GUID sent as parameter: True  
+  
+Trying to check if IncomingMessageHeader collection contains header with value 2239da67-546f-42d4-89dc-8eb3c06215d8  
+No header was found  
+  
+Prompt>Client.exe  
+Using client1 to send message  
+Did server retrieve the header? : Actual: True, Expected: True  
+  
+Using client2 to send message  
+Did server retrieve the header? : Actual: False, Expected: False  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\OperationContextScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/pii-security-lockdown.md b/docs/framework/wcf/samples/pii-security-lockdown.md
new file mode 100644
index 00000000000..24264d6aa44
--- /dev/null
+++ b/docs/framework/wcf/samples/pii-security-lockdown.md
@@ -0,0 +1,153 @@
+---
+title: "PII セキュリティ ロックダウン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c44fb338-9527-4dd0-8607-b8787d15acb4
+caps.latest.revision: 25
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 25
+---
+# PII セキュリティ ロックダウン
+このサンプルでは、次の機能を使用して、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの複数のセキュリティ関連機能を制御する方法を示します。  
+  
+-   サービスの構成ファイル内の機密情報を暗号化します。  
+  
+-   入れ子になったサービス サブディレクトリが設定をオーバーライドできないように、構成ファイル内の要素をロックします。  
+  
+-   トレースおよびメッセージ ログで、個人を特定できる情報 \(PII\) のログ記録を制御します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\SecurityLockdown`  
+  
+## 説明  
+ これらの各機能を単独または組み合わせて使用することにより、サービスのさまざまなセキュリティを制御できます。  ただし、ここでの記述は [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのセキュリティ保護について完全に説明するものではありません。  
+  
+ .NET Framework の構成ファイルには、データベースに接続するための接続文字列などの機密情報を格納できます。  共有の Web ホストのシナリオでは、この情報をサービスの構成ファイル内で暗号化して、構成ファイル内に含まれるデータを偶発的に表示されないようにすることが望ましい場合があります。  .NET Framework 2.0 以降のバージョンでは、Windows データ保護アプリケーション プログラミング インターフェイス \(DPAPI\) または RSA 暗号化プロバイダを使用して、構成ファイルの一部を暗号化できます。  DPAPI または RSA を使用して aspnet\_regiis.exe を実行すると、構成ファイルの選択部分を暗号化できます。  
+  
+ Web ホストのシナリオでは、他のサービスのサブディレクトリにサービスを設定できます。  構成値を決定する既定の意味的方法によると、入れ子になったディレクトリ内の構成ファイルで親ディレクトリの構成値をオーバーライドできます。  特定の状況では、さまざまな理由でこれが望ましくない場合があります。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス構成では、オーバーライドされた構成値を使用して入れ子になったサービスを実行する場合、入れ子になった構成が例外を生成できるように、構成値をロックすることができます。  
+  
+ このサンプルでは、トレースおよびメッセージ ログによる、ユーザー名やパスワードなどの個人を特定できる既知の情報 \(PII\) のログ記録を制御する方法を示します。  既定では、既知の PII のログ記録は無効です。ただし特定の状況では、PII のログ記録はアプリケーションをデバック処理する際に重要になる場合があります。  このサンプルは、[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)に基づいています。  さらに、このサンプルではトレースとメッセージ ログを使用します。  詳細については、[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)のサンプルを参照してください。  
+  
+## 構成ファイルの要素の暗号化  
+ 共有 Web ホストの環境をセキュリティ保護するには、機密情報が含まれる可能性のあるデータベース接続文字列など、特定の構成要素を暗号化することが望ましい場合があります。  構成要素は、.NET Framework フォルダー \(%WINDIR%\\Microsoft.NET\\Framework\\v4.0.20728 など\) にある aspnet\_regiis.exe ツールを使用して暗号化できます。  
+  
+#### サンプルの Web.config で appSettings セクションの値を暗号化するには  
+  
+1.  \[スタート\] \> \[ファイル名を指定して実行…\] を使用してコマンド プロンプトを開き、  「`cmd`」と入力して **\[OK\]** をクリックします。  
+  
+2.  コマンド「`cd %WINDIR%\Microsoft.NET\Framework\v4.0.20728`」を実行して、現在の .NET Framework ディレクトリに移動します。  
+  
+3.  コマンド「`aspnet_regiis -pe "appSettings" -app "/servicemodelsamples" -prov "DataProtectionConfigurationProvider"`」を実行して、Web.config フォルダの appSettings 構成設定を暗号化します。  
+  
+ 構成ファイルのセクションを暗号化する方法の詳細については、ASP.NET 構成での DPAPI の使用方法 \(「[セキュリティで保護された ASP.NET アプリケーションの構築 : 認証、承認、セキュリティで保護された通信](http://go.microsoft.com/fwlink/?LinkId=95137)」\) および ASP.NET 構成での RSA の使用方法 \(「[方法 : RSA を使用して ASP.NET 2.0 で構成セクションを暗号化する](http://go.microsoft.com/fwlink/?LinkId=95138)」\) を参照してください。  
+  
+## 構成ファイルの要素のロック  
+ Web ホストのシナリオでは、サービスのサブディレクトリにサービスを設定できます。  こうした状況で、サブディレクトリ内のサービスの構成値を計算するには、Machine.config 内の値を調べ、続いて親ディレクトリの任意の Web.config ファイルとマージしてディレクトリ ツリーの下層に移動します。そして最後に、サービスが含まれるディレクトリ内の Web.config ファイルをマージします。  ほとんどの構成要素での既定の動作は、サブディレクトリ内の構成ファイルが、親ディレクトリに設定されている値をオーバーライドできるようにすることです。  特定の状況では、サブディレクトリ内の構成ファイルが、親ディレクトリの構成に設定されている値をオーバーライドしないようにするのが望ましい場合があります。  
+  
+ .NET Framework では、構成ファイルの要素をロックして、ロックされた構成要素をオーバーライドする構成が実行時例外をスローするように設定できます。  
+  
+ 構成要素をロックするには、構成ファイルのノードに対して `lockItem` 属性を指定します。たとえば、入れ子になった構成ファイル内の電卓サービスが動作を変更できないように構成ファイルの CalculatorServiceBehavior ノードをロックするには、次の構成を使用できます。  
+  
+```  
+<configuration>  
+   <system.serviceModel>  
+      <behaviors>   
+          <serviceBehaviors>   
+             <behavior name="CalculatorServiceBehavior" lockItem="true">   
+               <serviceMetadata httpGetEnabled="True"/>   
+               <serviceDebug includeExceptionDetailInFaults="False" />   
+             </behavior>   
+          </serviceBehaviors>   
+       </behaviors>   
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+ 構成要素はより詳細な単位でロックできます。  要素の一覧は、サブ要素のコレクション内にある一連の要素をロックするための `lockElements` に対する値として指定できます。  属性の一覧は、要素内にある一連の属性をロックするための `lockAttributes` に対する値として指定できます。  要素または属性のコレクション全体をロックすることもできます。ただし、ノードで `lockAllElementsExcept` 属性または `lockAllAttributesExcept` 属性が指定されている一覧は除きます。  
+  
+## PII ログの構成  
+ PII のログ記録は 2 つのスイッチで制御されます。1 つは Machine.config にあるコンピューター全体の設定で、コンピューターの管理者がこれを使用することにより、PII のログ記録を許可または拒否できます。もう 1 つはアプリケーション設定で、アプリケーションの管理者がこれを使用することにより、Web.config または App.config ファイル内の各ソースで PII のログ記録の有効\/無効を切り替えることができます。  
+  
+ コンピューター全体の設定は、Machine.config の `enableLoggingKnownPii` 要素で、`true` を `false` または `machineSettings` に設定することによって制御されます。  たとえば、次の例ではアプリケーションで PII のログ記録が有効になります。  
+  
+```  
+<configuration>  
+    <system.serviceModel>  
+        <machineSettings enableLoggingKnownPii="true" />  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+> [!NOTE]
+>  Machine.config ファイルの既定の場所は %WINDIR%\\Microsoft.NET\\Framework\\v2.0.50727\\CONFIG です。  
+  
+ `enableLoggingKnownPii` 属性が Machine.config にない場合、PII のログ記録は許可されません。  
+  
+ アプリケーションで PII のログ記録を有効にするには、Web.config または App.config ファイルで、ソース要素の `logKnownPii` 属性を `true` または `false` に設定します。  たとえば次の例では、メッセージ ログとトレース ログの両方に対して PII のログ記録が有効になります。  
+  
+```  
+<configuration>  
+    <system.diagnostics>  
+        <sources>  
+            <source name="System.ServiceModel.MessageLogging" logKnownPii="true">  
+                <listeners>   
+                ...   
+                </listeners>  
+            </source>  
+            <source name="System.ServiceModel" switchValue="Verbose, ActivityTracing">  
+            <listeners>  
+        ...   
+            </listeners>  
+            </source>  
+        </sources>  
+    </system.diagnostics>  
+</configuration>  
+```  
+  
+ `logKnownPii` 属性が指定されていない場合は、PII はログ記録されません。  
+  
+ PII がログ記録されるのは、`enableLoggingKnownPii` が `true` に設定されていると共に、`logKnownPii` が `true` に設定されている場合だけです。  
+  
+> [!NOTE]
+>  System.Diagnostics は、構成ファイルの最初に表示されているソース以外の、すべてのソースのすべての属性を無視します。  `logKnownPii` 属性を構成ファイル内の 2 番目のソースに追加しても、結果は変わりません。  
+  
+> [!IMPORTANT]
+>  このサンプルを実行する際には、Machine.config を手動で変更します。  Machine.config を変更する際は注意してください。値または構文が正しくない場合、すべての .NET Framework アプリケーションが実行できなくなる可能性があります。  
+  
+ また、DPAPI や RSA を使用して構成ファイルの要素を暗号化することもできます。  詳細については、次のリンクを参照してください。  
+  
+-   [セキュリティで保護された ASP.NET アプリケーションの構築 : 認証、承認、セキュリティで保護された通信](http://go.microsoft.com/fwlink/?LinkId=95137)  
+  
+-   [方法 : RSA を使用して ASP.NET 2.0 で構成セクションを暗号化する](http://go.microsoft.com/fwlink/?LinkId=95138)  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」を実行したことを確認してください。  
+  
+2.  Machine.config を編集して `enableLoggingKnownPii` 属性を `true` に設定し、必要に応じて親ノードを追加します。  
+  
+3.  C\# 版または Visual Basic .NET 版のソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成または複数コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+#### サンプルをクリーンアップするには  
+  
+1.  Machine.config を編集して `enableLoggingKnownPii` 属性を `false` に設定します。  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/poco-support.md b/docs/framework/wcf/samples/poco-support.md
new file mode 100644
index 00000000000..6caf77f8fc2
--- /dev/null
+++ b/docs/framework/wcf/samples/poco-support.md
@@ -0,0 +1,68 @@
+---
+title: "POCO サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3846ca73-2819-4ca2-8367-dc739dde5a5b
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# POCO サポート
+このサンプルでは、マークされていない型 \(シリアル化属性が適用されていない型で、POCO \(Plain Old CLR Object\) 型と呼ばれる場合もあります\) のシリアル化のサポートについて説明します。<xref:System.Runtime.Serialization.DataContractSerializer> では、既定のコンストラクタを持つすべてのマークされていないパブリック型について、データ コントラクトを推測します。データ コントラクトを使用すると、サービスと構造化データをやり取りできます。マークされていない型[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)」を参照してください。  
+  
+ このサンプルは[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)に基づいていますが、プリミティブ数値型ではなく複素数を使用します。また、<xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性が使用されない点を除いて、[基本的なデータ コントラクト](../../../../docs/framework/wcf/samples/basic-data-contract.md)のサンプルにも類似しています。  
+  
+ サービスはインターネット インフォメーション サービス \(IIS\) によってホストされています。クライアントはコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ `ComplexNumber` クラスは、`ServiceContract` で使用されます。次のサンプル コードに示すように、`ComplexNumber` 型には、<xref:System.Runtime.Serialization.DataContractAttribute> 属性と <xref:System.Runtime.Serialization.DataMemberAttribute> 属性がありません。既定では、パブリック プロパティとパブリック フィールドはすべてシリアル化されます。  
+  
+```  
+public class ComplexNumber  
+{  
+    public double Real;  
+    public double Imaginary;  
+    public ComplexNumber()  
+    {  
+        Real = double.MinValue;  
+        Imaginary = double.MinValue;  
+    }  
+    public ComplexNumber(double real, double imaginary)  
+    {  
+        this.Real = real;  
+        this.Imaginary = imaginary;  
+    }  
+}  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Data\POCO`  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.IgnoreDataMemberAttribute>   
+ [シリアル化可能な型](../../../../docs/framework/wcf/feature-details/serializable-types.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/poison-message-handling-in-msmq-4-0.md b/docs/framework/wcf/samples/poison-message-handling-in-msmq-4-0.md
new file mode 100644
index 00000000000..7b358dba384
--- /dev/null
+++ b/docs/framework/wcf/samples/poison-message-handling-in-msmq-4-0.md
@@ -0,0 +1,342 @@
+---
+title: "MSMQ 4.0 での有害メッセージ処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ec8d59e3-9937-4391-bb8c-fdaaf2cbb73e
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# MSMQ 4.0 での有害メッセージ処理
+このサンプルでは、サービスで有害メッセージの処理を実行する方法を示します。  このサンプルは、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」のサンプルに基づいています。  このサンプルでは、`netMsmqBinding` を使用しています。  サービスは自己ホスト型コンソール アプリケーションであるので、キューに置かれたメッセージをサービスが受信するようすを観察できます。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。  厳密には、クライアントはメッセージをキューに送信します。  サービスは、メッセージをキューから受信します。  したがって、キューを使用する通信では、サービスとクライアントが同時に実行されていなくてもかまいません。  
+  
+ 有害メッセージとは、メッセージを読み取るサービスがメッセージを処理できないためメッセージの読み取りが行われるトランザクションを終了する場合に、キューから繰り返し読み取られるメッセージのことです。  そのような場合、メッセージは再試行されます。  メッセージに問題がある場合、この再試行は理論上、永久に継続します。  これは、キューから読み取って、サービス操作を起動するトランザクションを使用する場合にのみ発生することがある点に注意してください。  
+  
+ MSMQ のバージョンによって、NetMsmqBinding がサポートする有害メッセージの検出が制限されている場合と、制限されていない場合があります。  メッセージが有害として検出されたら、いくつかの方法で処理できます。  また、MSMQ のバージョンによって、NetMsmqBinding がサポートする有害メッセージの処理が制限されている場合と、制限されていない場合があります。  
+  
+ このサンプルでは、[!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] プラットフォームと [!INCLUDE[wxp](../../../../includes/wxp-md.md)] プラットフォームに用意されている制限された有害メッセージ機能と、[!INCLUDE[wv](../../../../includes/wv-md.md)] に用意されている制限されていない有害メッセージ機能を示します。  どちらのサンプルでも、目的はキューの外にある有害メッセージを、有害メッセージ サービスによりサービスを提供可能な別のキューに移動することです。  
+  
+## MSMQ v4.0 の有害メッセージ処理サンプル  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] では、有害メッセージの格納に使用可能な有害メッセージ サブキュー機能が MSMQ に用意されています。  このサンプルは、[!INCLUDE[wv](../../../../includes/wv-md.md)] を使用して有害メッセージを処理するベスト プラクティスを示しています。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] の有害メッセージの検出は、かなり高度な機能です。  検出に役立つ 3 つのプロパティがあります。  <xref:System.ServiceModel.MsmqBindingBase.ReceiveRetryCount%2A> は、指定したメッセージをキューから再度読み取り、処理するためにアプリケーションにディスパッチする回数です。  メッセージをアプリケーションにディスパッチできないか、またはアプリケーションがサービス操作内のトランザクションをロールバックしたため、メッセージはキューに戻ったときにキューから再度読み取られます。  <xref:System.ServiceModel.MsmqBindingBase.MaxRetryCycles%2A> は、メッセージが再試行キューに移動する回数です。  <xref:System.ServiceModel.MsmqBindingBase.ReceiveRetryCount%2A> に達すると、メッセージは再試行キューに移動されます。  メッセージが再試行キューからメイン キューに移動されると、<xref:System.ServiceModel.MsmqBindingBase.RetryCycleDelay%2A> プロパティは時間遅延となります。  <xref:System.ServiceModel.MsmqBindingBase.ReceiveRetryCount%2A> が 0 にリセットされます。  メッセージは再試行されます。  メッセージを読み取るすべての試行に失敗すると、メッセージが有害としてマークされます。  
+  
+ メッセージが有害としてマークされると、メッセージは <xref:System.ServiceModel.MsmqBindingBase.ReceiveErrorHandling%2A> 列挙体の設定に従って処理されます。  次にもう一度、使用可能な値を示します。  
+  
+-   Fault \(既定値\): リスナーとサービス ホストをエラーにします。  
+  
+-   Drop: メッセージを破棄します。  
+  
+-   Move: メッセージを有害メッセージ サブキューに移動します。  この値は、[!INCLUDE[wv](../../../../includes/wv-md.md)] でのみ使用できます。  
+  
+-   Reject: メッセージを送信者の配信不能キューに戻すことにより、メッセージを拒否します。  この値は、[!INCLUDE[wv](../../../../includes/wv-md.md)] でのみ使用できます。  
+  
+ このサンプルは有害なメッセージに対する `Move` 処置の使用法を示します。  `Move` を指定すると、メッセージが有害メッセージ サブキューに移動されます。  
+  
+ サービス コントラクトは `IOrderProcessor` です。これは、キューでの使用に適した一方向サービスを定義します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void SubmitPurchaseOrder(PurchaseOrder po);  
+}  
+  
+```  
+  
+ サービス操作により、注文を処理していることを示すメッセージが表示されます。  有害メッセージ機能を示すため、`SubmitPurchaseOrder` サービス操作は例外をスローして、サービスのランダム起動に基づきトランザクションをロールバックします。  これにより、メッセージがキューに戻ります。  最終的に、メッセージは有害とマークされます。  構成は、有害メッセージ サブキューへのメッセージの移動に設定されています。  
+  
+```  
+  
+// Service class that implements the service contract.  
+// Added code to write output to the console window.  
+public class OrderProcessorService : IOrderProcessor  
+{  
+    static Random r = new Random(137);  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public void SubmitPurchaseOrder(PurchaseOrder po)  
+    {  
+  
+        int randomNumber = r.Next(10);  
+  
+        if (randomNumber % 2 == 0)  
+        {  
+            Orders.Add(po);  
+            Console.WriteLine("Processing {0} ", po);  
+        }  
+        else  
+        {  
+            Console.WriteLine("Aborting transaction, cannot process purchase order: " + po.PONumber);  
+            Console.WriteLine();  
+            throw new Exception("Cannot process purchase order: " + po.PONumber);  
+        }  
+    }  
+  
+    public static void OnServiceFaulted(object sender, EventArgs e)   
+    {  
+        Console.WriteLine("Service Faulted");  
+    }  
+  
+    // Host the service within this EXE console application.  
+    public static void Main()  
+    {  
+        // Get MSMQ queue name from app settings in configuration.  
+        string queueName = ConfigurationManager.AppSettings["queueName"];  
+  
+        // Create the transacted MSMQ queue if necessary.  
+        if (!System.Messaging.MessageQueue.Exists(queueName))  
+            System.Messaging.MessageQueue.Create(queueName, true);  
+  
+        // Get the base address that is used to listen for WS-MetaDataExchange requests.  
+        // This is useful to generate a proxy for the client.  
+        string baseAddress = ConfigurationManager.AppSettings["baseAddress"];  
+  
+        // Create a ServiceHost for the OrderProcessorService type.  
+        ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService), new Uri(baseAddress));  
+  
+        // Hook on to the service host faulted events.  
+        serviceHost.Faulted += new EventHandler(OnServiceFaulted);  
+  
+        // Open the ServiceHostBase to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+  
+        if(serviceHost.State != CommunicationState.Faulted) {  
+            serviceHost.Close();  
+        }  
+  
+    }  
+}  
+```  
+  
+ サービス構成には、`receiveRetryCount`、`maxRetryCycles`、`retryCycleDelay`、および `receiveErrorHandling` という有害メッセージ プロパティが含まれています。次の構成ファイルを参照してください。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <appSettings>  
+    <!-- Use appSetting to configure MSMQ queue name. -->  
+    <add key="queueName" value=".\private$\ServiceModelSamplesPoison" />  
+    <add key="baseAddress" value="http://localhost:8000/orderProcessor/poisonSample"/>  
+  </appSettings>  
+  <system.serviceModel>  
+    <services>  
+      <service   
+              name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+        <!-- Define NetMsmqEndpoint -->  
+        <endpoint address="net.msmq://localhost/private/ServiceModelSamplesPoison"  
+                  binding="netMsmqBinding"  
+                  bindingConfiguration="PoisonBinding"   
+                  contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <netMsmqBinding>  
+        <binding name="PoisonBinding"   
+                 receiveRetryCount="0"  
+                 maxRetryCycles="1"  
+                 retryCycleDelay="00:00:05"                        
+                 receiveErrorHandling="Move">  
+        </binding>  
+      </netMsmqBinding>  
+    </bindings>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+## 有害メッセージ キューのメッセージの処理  
+ 有害メッセージ サービスは、最終的な有害メッセージ キューからメッセージを読み取って、それを処理します。  
+  
+ 有害メッセージ キューのメッセージは、メッセージを処理するサービスに対応付けられたメッセージで、有害メッセージ サービスのエンドポイントとは異なる場合があります。  そのため、有害メッセージ サービスがキューからメッセージを読み取ると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のチャネル レイヤはエンドポイントで不一致を検出し、メッセージをディスパッチしません。  この場合、メッセージは注文処理サービス宛てになりますが、有害メッセージ サービスが受信します。  別のエンドポイント宛のメッセージも含めてメッセージの受信を続けるには、`ServiceBehavior` を追加して、メッセージの任意の宛先サービス エンドポイントを一致条件としてアドレスをフィルタする必要があります。  これは、有害メッセージ キューから読み込んだメッセージを正常に処理するために必要です。  
+  
+ 有害メッセージ サービス実装そのものは、サービス実装と非常によく似ています。  コントラクトを実装し、注文を処理します。  コード例を次に示します。  
+  
+```  
+// Service class that implements the service contract.  
+// Added code to write output to the console window.  
+[ServiceBehavior(AddressFilterMode=AddressFilterMode.Any)]  
+public class OrderProcessorService : IOrderProcessor  
+{  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public void SubmitPurchaseOrder(PurchaseOrder po)  
+    {  
+        Orders.Add(po);  
+        Console.WriteLine("Processing {0} ", po);  
+    }  
+  
+    public static void OnServiceFaulted(object sender, EventArgs e)   
+    {  
+        Console.WriteLine("Service Faulted...exiting app");  
+        Environment.Exit(1);  
+    }  
+  
+    // Host the service within this EXE console application.  
+    public static void Main()  
+    {  
+  
+        // Create a ServiceHost for the OrderProcessorService type.  
+        ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService));  
+  
+        // Hook on to the service host faulted events.  
+        serviceHost.Faulted += new EventHandler(OnServiceFaulted);  
+  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The poison message service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+  
+        // Close the ServiceHostBase to shutdown the service.  
+        if(serviceHost.State != CommunicationState.Faulted)  
+        {  
+            serviceHost.Close();  
+        }  
+    }  
+  
+```  
+  
+ 注文処理サービスはメッセージを注文キューから読み込みますが、有害メッセージ サービスはメッセージを有害サブキューから読み込みます。  有害キューはメイン キューのサブキューであり、名前は "poison" で、MSMQ により自動生成されます。  アクセスするには、メイン キュー名の後ろに ";" を追加し、その後ろにサブキュー名 \(この場合は "poison"\) を指定します。次のサンプル構成を参照してください。  
+  
+> [!NOTE]
+>  MSMQ v3.0 用のサンプルでは、有害キュー名はサブキューではなく、メッセージの移動先キューになります。  
+  
+```  
+  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+        <!-- Define NetMsmqEndpoint -->  
+        <endpoint address="net.msmq://localhost/private/ServiceModelSamplesPoison;poison"  
+                  binding="netMsmqBinding"  
+                  contract="Microsoft.ServiceModel.Samples.IOrderProcessor" >  
+        </endpoint>  
+      </service>  
+    </services>  
+  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ サンプルを実行すると、クライアント、サービス、および有害メッセージ サービスのアクティビティがコンソール ウィンドウに表示されます。  サービスがクライアントから受信したメッセージを表示できます。  いずれかのコンソール ウィンドウで Enter キーを押すと、サービスがシャットダウンされます。  
+  
+ サービスが実行を開始し、注文を処理し、処理の終了をランダムに開始します。  メッセージに注文処理の完了が示されていた場合、クライアントをもう一度実行して、サービスが実際にメッセージを終了したことを確認するまで別のメッセージを送信できます。  構成されている有害設定に基づき、メッセージは 1 度処理を試行されてから、最後の有害キューに移されます。  
+  
+```  
+  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Processing Purchase Order: 0f063b71-93e0-42a1-aa3b-bca6c7a89546  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+Processing Purchase Order: 5ef9a4fa-5a30-4175-b455-2fb1396095fa  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+Aborting transaction, cannot process purchase order: 23e0b991-fbf9-4438-a0e2-20adf93a4f89  
+```  
+  
+ 有害メッセージ サービスを起動して、有害メッセージを有害キューから読み込みます。  この例では、有害メッセージ サービスはメッセージを読み込んで処理します。  終了され有害指定された発注書が有害メッセージ サービスによって読み込まれるのを確認できます。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Processing Purchase Order: 23e0b991-fbf9-4438-a0e2-20adf93a4f89  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。  キューが存在しない場合、サービスによってキューが作成されます。  最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。  Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、`「ServiceModelSamplesTransacted」`と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、キュー名を localhost から実際のホスト名に変更し、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+ `netMsmqBinding` バインディング トランスポートを使用する場合の既定では、セキュリティが有効です。  トランスポート セキュリティの種類は、`MsmqAuthenticationMode` と `MsmqProtectionLevel` の 2 つのプロパティで決まります。  既定では、認証モードは `Windows` に、保護レベルは `Sign` に、それぞれ設定されます。  MSMQ の認証および署名の機能を利用するには、ドメインに属している必要があります。  ドメインに属していないコンピューターでこのサンプルを実行すると、"User's internal message queuing certificate does not exist" というエラーが表示されます。  
+  
+#### ワークグループに参加しているコンピューターでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピューターを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードとセキュリティ レベルを `None` に設定します。サンプル構成を次に示します。  
+  
+    ```  
+    <bindings>  
+        <netMsmqBinding>  
+            <binding name="TransactedBinding">  
+                <security mode="None"/>  
+            </binding>  
+        </netMsmqBinding>  
+    </bindings>  
+    ```  
+  
+     エンドポイントの bindingConfiguration 属性を設定して、エンドポイントがこのバインディングに関連付けられるようにします。  
+  
+2.  サンプルを実行する前に、PoisonMessageServer、サーバー、およびクライアントの構成を変更してください。  
+  
+    > [!NOTE]
+    >  `security mode` を `None` に設定することは、`MsmqAuthenticationMode`、`MsmqProtectionLevel`、および `Message` のセキュリティを `None` に設定することに相当します。  
+  
+3.  Metadata Exchange を機能させるため、URL を HTTP バインディングに登録します。  これを行うには、サービスが権限の高いコマンド ウィンドウで実行されている必要があります。  それ以外の場合、"未処理の例外 : System.ServiceModel.AddressAccessDeniedException: HTTP は URL http:\/\/\+:8000\/ServiceModelSamples\/service\/ を登録できません。  プロセスにこの名前空間へのアクセス権がありません \(詳細については、http:\/\/go.microsoft.com\/fwlink\/?LinkId\=70353 を参照してください\)。  \-\-\-\> "System.Net.HttpListenerException: アクセスが拒否されました。" のような例外が発生します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\Poison\MSMQ4`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/pooling.md b/docs/framework/wcf/samples/pooling.md
new file mode 100644
index 00000000000..b99eee32ee6
--- /dev/null
+++ b/docs/framework/wcf/samples/pooling.md
@@ -0,0 +1,267 @@
+---
+title: "プール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 688dfb30-b79a-4cad-a687-8302f8a9ad6a
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# プール
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を拡張してオブジェクト プールをサポートする方法を示します。サンプルでは、エンタープライズ サービスの`ObjectPoolingAttribute` 属性機能と、構文および意味が同じ属性を作成する方法を示します。オブジェクト プールにより、アプリケーションのパフォーマンスが大幅に向上します。ただし、適切に使用しないと逆効果になる場合があります。オブジェクト プールは、負荷のかかる初期化が要求される、使用頻度の高いオブジェクトの再作成によるオーバーヘッドを減少させます。ただし、プールされたオブジェクト上のメソッドへの呼び出しが完了するのに非常に時間がかかる場合、オブジェクト プールは、最大プール サイズに達するとすぐに追加要求をキューに置きます。そのため、タイムアウト例外がスローされることによって、いくつかのオブジェクトの作成要求が失敗する場合があります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 拡張機能作成の最初の手順は、使用する機能拡張ポイントの決定です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] での用語、*ディスパッチャ*は、受信メッセージをユーザーのサービス上のメソッド呼び出しに変換したり、メソッドからの戻り値を送信メッセージに変換する実行時コンポーネントを表します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、各エンドポイントのディスパッチャを作成します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントに関連付けられたコントラクトが双方向コントラクトであるとき、このクライアントではディスパッチャを使用する必要があります。  
+  
+ チャネル ディスパッチャとエンドポイント ディスパッチャでは、ディスパッチャの動作を制御するさまざまなプロパティが公開されているため、チャネル全体の拡張とコントラクト全体の拡張を行うことができます。さらに <xref:System.ServiceModel.Dispatcher.EndpointDispatcher.DispatchRuntime%2A> プロパティにより、ディスパッチ処理を検査、変更、またはカスタマイズすることもできます。このサンプルでは、サービス クラスのインスタンスを提供するオブジェクトをポイントする <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> プロパティに焦点を当てています。  
+  
+## IInstanceProvider  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] では、ディスパッチャは <xref:System.ServiceModel.Dispatcher.IInstanceProvider> インターフェイスを実装している <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> を使用して、サービス クラスのインスタンスを作成します。このインターフェイスには、次の 3 つのメソッドが含まれています。  
+  
+-   <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%2CSystem.ServiceModel.Channels.Message%29>: メッセージが到着すると、このディスパッチャは <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%2CSystem.ServiceModel.Channels.Message%29> メソッドを呼び出し、メッセージを処理するためのサービス クラスのインスタンスを作成します。このメソッドの呼び出し頻度は <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティで決まります。たとえば <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティが <xref:System.ServiceModel.InstanceContextMode> に設定されている場合、サービス クラスの新しいインスタンスが作成され、到着する各メッセージが処理されます。したがって、<xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%2CSystem.ServiceModel.Channels.Message%29> はメッセージが到着するたびに呼び出されます。  
+  
+-   <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%29>: 前のメソッドと同じです。ただし、このメソッドが呼び出されるのは Message 引数がない場合です。  
+  
+-   <xref:System.ServiceModel.Dispatcher.IInstanceProvider.ReleaseInstance%28System.ServiceModel.InstanceContext%2CSystem.Object%29>: サービス インスタンスの有効期間が経過すると、ディスパッチャは <xref:System.ServiceModel.Dispatcher.IInstanceProvider.ReleaseInstance%28System.ServiceModel.InstanceContext%2CSystem.Object%29> メソッドを呼び出します。<xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%2CSystem.ServiceModel.Channels.Message%29> メソッドと同様、このメソッドへの呼び出し頻度は <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A> プロパティで決まります。  
+  
+## オブジェクト プール  
+ カスタム <xref:System.ServiceModel.Dispatcher.IInstanceProvider> の実装により、サービスに必要なオブジェクト プールの意味が提供されます。したがって、このサンプルにはプール用の <xref:System.ServiceModel.Dispatcher.IInstanceProvider> のカスタム実装を提供する `ObjectPoolingInstanceProvider` 型が用意されています。`Dispatcher` が、新しいインスタンスを作成する代わりに <xref:System.ServiceModel.Dispatcher.IInstanceProvider.GetInstance%28System.ServiceModel.InstanceContext%2CSystem.ServiceModel.Channels.Message%29> メソッドを呼び出すと、カスタム実装はメモリ内プールで既存のオブジェクトを検索します。検索されたオブジェクトが使用可能な場合は、そのオブジェクトが返されます。それ以外の場合は、新しいオブジェクトが作成されます。`GetInstance` の実装を次のサンプル コードに示します。  
+  
+```  
+object IInstanceProvider.GetInstance(InstanceContext instanceContext, Message message)  
+{  
+    object obj = null;  
+  
+    lock (poolLock)  
+    {  
+        if (pool.Count > 0)  
+        {  
+            obj = pool.Pop();  
+        }  
+        else  
+        {  
+            obj = CreateNewPoolObject();  
+        }  
+        activeObjectsCount++;  
+    }  
+  
+    WritePoolMessage(ResourceHelper.GetString("MsgNewObject"));  
+  
+    idleTimer.Stop();  
+  
+    return obj;            
+}  
+  
+```  
+  
+ カスタム `ReleaseInstance` 実装は、解放されたインスタンスをプールに戻し、`ActiveObjectsCount` 値をデクリメントします。`Dispatcher` はこれらのメソッドをさまざまなスレッドから呼び出すので、`ObjectPoolingInstanceProvider` クラスのクラス レベル メンバーへの同期アクセスが必要となります。  
+  
+```  
+void IInstanceProvider.ReleaseInstance(InstanceContext instanceContext, object instance)  
+{  
+    lock (poolLock)  
+    {  
+        pool.Push(instance);  
+        activeObjectsCount--;  
+  
+        WritePoolMessage(  
+        ResourceHelper.GetString("MsgObjectPooled"));  
+  
+        // When the service goes completely idle (no requests   
+        // are being processed), the idle timer is started  
+        if (activeObjectsCount == 0)  
+            idleTimer.Start();                       
+    }  
+}  
+  
+```  
+  
+ `ReleaseInstance` メソッドには、"初期化のクリーンアップ" 機能があります。通常は、プールにはその有効期間中に最小限の数のオブジェクトが保持されます。ただし、使用率が非常に高くなり、プールでオブジェクトを追加作成する必要が生じて、その数が構成に指定されている上限に達する可能性があります。プールが最終的にアクティブでなくなると、そうした過剰なオブジェクトは余分なオーバーヘッドになります。したがって、`activeObjectsCount` がゼロに達すると、アイドル タイマが起動し、クリーンアップ サイクルがトリガされて実行されます。  
+  
+## 動作の追加  
+ ディスパッチャのレイヤ拡張は、次の動作を使用してフックされます。  
+  
+-   サービスの動作。サービス ランタイム全体のカスタマイズを実現します。  
+  
+-   エンドポイントの動作。サービス エンドポイントのカスタマイズ、特にチャネル ディスパッチャとエンドポイント ディスパッチャのカスタマイズを実現します。  
+  
+-   コントラクトの動作。クライアント上およびサービス上で、それぞれ <xref:System.ServiceModel.Dispatcher.ClientRuntime> クラスと <xref:System.ServiceModel.Dispatcher.DispatchRuntime> クラスのカスタマイズを実現します。  
+  
+ オブジェクト プール拡張を行うには、サービスの動作を作成する必要があります。サービス動作を作成するには、<xref:System.ServiceModel.Description.IServiceBehavior> インターフェイスを実装します。サービス モデルにカスタム動作を認識させるには、次のようないくつかの方法があります。  
+  
+-   カスタム属性を使用する。  
+  
+-   カスタム動作をサービス説明の動作コレクションに強制的に追加する。  
+  
+-   構成ファイルを拡張する。  
+  
+ このサンプルではカスタム属性を使用します。<xref:System.ServiceModel.ServiceHost> が構築されると、サービスの種類の定義で使用されている属性が調べられ、使用可能な動作がサービス説明の動作コレクションに追加されます。  
+  
+ インターフェイス <xref:System.ServiceModel.Description.IServiceBehavior> には、<xref:System.ServiceModel.Description.IServiceBehavior.Validate%2A>、<xref:System.ServiceModel.Description.IServiceBehavior.AddBindingParameters%2A>、および <xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A> の 3 つのメソッドがあります。<xref:System.ServiceModel.Description.IServiceBehavior.Validate%2A> メソッドを使用すると、確実に動作をサービスに適用できます。このサンプルでは、これを実装することによって、サービスが <xref:System.ServiceModel.InstanceContextMode> を使用して構成されないようにします。<xref:System.ServiceModel.Description.IServiceBehavior.AddBindingParameters%2A> メソッドは、サービスのバインディングの構成に使用されます。このシナリオでは、このメソッドは必要ありません。<xref:System.ServiceModel.Description.IServiceBehavior.ApplyDispatchBehavior%2A> はサービスのディスパッチャの構成に使用されます。このメソッドは、<xref:System.ServiceModel.ServiceHost> の初期化中に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] によって呼び出されます。このメソッドには次のパラメータが渡されます。  
+  
+-   `Description` : この引数は、サービス全体のサービスの説明を提供します。これを使用すると、サービスのエンドポイント、コントラクト、バインディング、およびその他のデータに関する説明データを検査できます。  
+  
+-   `ServiceHostBase` : この引数は、現在初期化中の <xref:System.ServiceModel.ServiceHostBase> を提供します。  
+  
+ カスタム <xref:System.ServiceModel.Description.IServiceBehavior> 実装では、`ObjectPoolingInstanceProvider` の新しいインスタンスがインスタンス化され、ServiceHostBase の各 <xref:System.ServiceModel.Dispatcher.DispatchRuntime> 内の <xref:System.ServiceModel.Dispatcher.DispatchRuntime.InstanceProvider%2A> プロパティに割り当てられます。  
+  
+```  
+void IServiceBehavior.ApplyDispatchBehavior(ServiceDescription description, ServiceHostBase serviceHostBase)  
+{  
+    // Create an instance of the ObjectPoolInstanceProvider.  
+    ObjectPoolingInstanceProvider instanceProvider = new  
+           ObjectPoolingInstanceProvider(description.ServiceType,   
+                                                    minPoolSize);  
+  
+    // Forward the call if we created a ServiceThrottlingBehavior.  
+    if (this.throttlingBehavior != null)  
+    {  
+        ((IServiceBehavior)this.throttlingBehavior).ApplyDispatchBehavior(description, serviceHostBase);  
+    }  
+  
+    // In case there was already a ServiceThrottlingBehavior   
+    // (this.throttlingBehavior==null), it should have initialized   
+    // a single ServiceThrottle on all ChannelDispatchers.    
+    // As we loop through the ChannelDispatchers, we verify that   
+    // and modify the ServiceThrottle to guard MaxPoolSize.  
+    ServiceThrottle throttle = null;  
+  
+    foreach (ChannelDispatcherBase cdb in   
+            serviceHostBase.ChannelDispatchers)  
+    {  
+        ChannelDispatcher cd = cdb as ChannelDispatcher;  
+        if (cd != null)  
+        {  
+            // Make sure there is exactly one throttle used by all   
+            // endpoints. If there were others, we could not enforce   
+            // MaxPoolSize.  
+            if ((this.throttlingBehavior == null) &&   
+                        (this.maxPoolSize != Int32.MaxValue))  
+            {  
+                if (throttle == null)  
+                {  
+                    throttle = cd.ServiceThrottle;  
+                }  
+                if (cd.ServiceThrottle == null)  
+                {  
+                    throw new   
+InvalidOperationException(ResourceHelper.GetString("ExNullThrottle"));  
+                }  
+                if (throttle != cd.ServiceThrottle)  
+                {  
+                    throw new InvalidOperationException(ResourceHelper.GetString("ExDifferentThrottle"));  
+                }  
+             }  
+  
+             foreach (EndpointDispatcher ed in cd.Endpoints)  
+             {  
+                 // Assign it to DispatchBehavior in each endpoint.  
+                 ed.DispatchRuntime.InstanceProvider =   
+                                      instanceProvider;  
+             }  
+         }  
+     }  
+  
+     // Set the MaxConcurrentInstances to limit the number of items   
+     // that will ever be requested from the pool.  
+     if ((throttle != null) && (throttle.MaxConcurrentInstances >   
+                                      this.maxPoolSize))  
+     {  
+         throttle.MaxConcurrentInstances = this.maxPoolSize;  
+     }  
+}  
+```  
+  
+ <xref:System.ServiceModel.Description.IServiceBehavior> 実装のほかにも、<xref:System.EnterpriseServices.ObjectPoolingAttribute> クラスには属性引数を使用してオブジェクト プールをカスタマイズするいくつかのメンバがあります。こうしたメンバには <xref:System.EnterpriseServices.ObjectPoolingAttribute.MaxPoolSize%2A>、<xref:System.EnterpriseServices.ObjectPoolingAttribute.MinPoolSize%2A>、<xref:System.EnterpriseServices.ObjectPoolingAttribute.CreationTimeout%2A> などがあり、.NET Enterprise Services で提供されるオブジェクト プール機能のセットに一致します。  
+  
+ オブジェクト プールの動作は、新しく作成されたカスタム `ObjectPooling` 属性を使用してサービス実装に注釈を付けることにより、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスに追加できるようになりました。  
+  
+```  
+[ObjectPooling(MaxPoolSize=1024, MinPoolSize=10, CreationTimeout=30000)]      
+public class PoolService : IPoolService  
+{  
+  // …  
+}  
+```  
+  
+## サンプルの実行  
+ このサンプルでは、特定のシナリオでオブジェクト プールを使用することによって得られるパフォーマンス上の利点を示します。  
+  
+ サービス アプリケーションは、`WorkService` と `ObjectPooledWorkService` の 2 つのサービスを実装します。どちらのサービスも同じ実装を共有し、負荷のかかる初期化を必要とします。さらに、比較的負荷の少ない `DoWork()` メソッドを公開します。両者の唯一の違いは、`ObjectPooledWorkService` ではオブジェクト プールが次のように構成されるという点です。  
+  
+```  
+[ObjectPooling(MinPoolSize = 0, MaxPoolSize = 5)]  
+public class ObjectPooledWorkService : IDoWork  
+{  
+    public ObjectPooledWorkService()  
+    {  
+        Thread.Sleep(5000);  
+        ColorConsole.WriteLine(ConsoleColor.Blue, "ObjectPooledWorkService instance created.");  
+    }  
+  
+    public void DoWork()  
+    {  
+        ColorConsole.WriteLine(ConsoleColor.Blue, "ObjectPooledWorkService.GetData() completed.");  
+    }          
+}  
+```  
+  
+ クライアントを実行すると、`WorkService` への呼び出し時間が 5 回計算されます。次に、`ObjectPooledWorkService` への呼び出し時間が 5 回計算されます。その後、時間の違いが次のように表示されます。  
+  
+```  
+Press <ENTER> to start the client.  
+  
+Calling WorkService:  
+1 - DoWork() Done  
+2 - DoWork() Done  
+3 - DoWork() Done  
+4 - DoWork() Done  
+5 - DoWork() Done  
+Calling WorkService took: 26722 ms.  
+Calling ObjectPooledWorkService:  
+1 - DoWork() Done  
+2 - DoWork() Done  
+3 - DoWork() Done  
+4 - DoWork() Done  
+5 - DoWork() Done  
+Calling ObjectPooledWorkService took: 5323 ms.  
+Press <ENTER> to exit.  
+```  
+  
+> [!NOTE]
+>  クライアントを最初に実行したときには、両方のサービスにかかった時間は同じように見えます。サンプルを再実行すると、`ObjectPooledWorkService` の戻り時間の方が早いことがわかります。オブジェクトのインスタンスが既にプール内に存在しているからです。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Instancing\Pooling`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/receivecontext-enabled-wcf-channels.md b/docs/framework/wcf/samples/receivecontext-enabled-wcf-channels.md
new file mode 100644
index 00000000000..01f64afb657
--- /dev/null
+++ b/docs/framework/wcf/samples/receivecontext-enabled-wcf-channels.md
@@ -0,0 +1,75 @@
+---
+title: "ReceiveContext が有効な WCF チャネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d990d119-7321-4b8c-852b-10256f59f9b0
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ReceiveContext が有効な WCF チャネル
+このサンプルでは、<xref:System.ServiceModel.Channels.ReceiveContext> を有効にした WCF チャネルの有用性を示します。  このサンプルでは、NetMSMQ チャネルを使用して 2 つの数値の積を見つけるサービスを実装します。  
+  
+ <xref:System.ServiceModel.Channels.ReceiveContext> クラスを使用すると、メッセージの内容を検査した後でも、メッセージにアクセスするか、メッセージをキューに残してさらに処理するかをアプリケーションで指定できます。  このサンプルでは、クライアントがランダムな整数をトランザクション キューに送信します。  `ProductCalculator` サービスはメッセージを受信し、そのメッセージの内容 \(整数\) を検索して、積が計算できるかどうかを確認します。  サービス操作で積が計算されない場合、メッセージはキューに戻されます。このメッセージはキューをリッスンするサービスでもう一度受信できます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\ReceiveContextProductGenerator`  
+  
+#### このサンプルを使用するには  
+  
+1.  Microsoft Message Queuing \(MSMQ\) がインストールされていることを確認します。  
+  
+    1.  MSMQ を [!INCLUDE[lserver](../../../../includes/lserver-md.md)] にインストールするには  
+  
+        1.  **サーバー マネージャー**で **\[機能\]** をクリックします。  
+  
+        2.  **\[機能の概要\]** の右側のペインで、**\[機能の追加\]** をクリックします。  
+  
+        3.  表示されたウィンドウで **\[メッセージ キュー\]** を展開します。  
+  
+        4.  **\[メッセージ キュー サービス\]** を展開します。  
+  
+        5.  **\[ディレクトリ サービス統合\]** を \(ドメインに参加するコンピューターの場合\) クリックし、**\[HTTP サポート\]** をクリックします。  
+  
+        6.  **\[次へ\]** をクリックし、**\[インストール\]** をクリックします。  
+  
+    2.  MSMQ を [!INCLUDE[wv](../../../../includes/wv-md.md)] にインストールするには  
+  
+        1.  **コントロール パネル**を開きます。  
+  
+        2.  **\[プログラム\]** をクリックし、**\[プログラムと機能\]** の **\[Windows の機能の有効化または無効化\]** をクリックします。  
+  
+        3.  **\[Microsoft Message Queue \(MSMQ\) Server\]**、**\[Microsoft Message Queue \(MSMQ\) Server Core\]** の順に展開して、インストールする次のメッセージ キュー機能のチェック ボックスをオンにします。  
+  
+            -   \[メッセージ キュー サーバー\]  
+  
+            -   \[MSMQ Active Directory Domain Services Integration\] \(ドメインに参加するコンピューターの場合\)  
+  
+            -   \[MSMQ HTTP サポート\]  
+  
+        4.  **\[OK\]** をクリックします。  
+  
+        5.  コンピューターを再起動するかどうかを確認するメッセージが表示されたら、**\[OK\]** をクリックしてインストールを完了します。  
+  
+2.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] がコンピューターにインストールされていることを確認します。  
+  
+3.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、ReceiveContextProductGenerator.sln ソリューション ファイルを開きます。  
+  
+4.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+5.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/reliable-secure-profile.md b/docs/framework/wcf/samples/reliable-secure-profile.md
new file mode 100644
index 00000000000..827320687bb
--- /dev/null
+++ b/docs/framework/wcf/samples/reliable-secure-profile.md
@@ -0,0 +1,48 @@
+---
+title: "Reliable Secure Profile | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 921edc41-e91b-40f9-bde9-b6148b633e61
+caps.latest.revision: 8
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 8
+---
+# Reliable Secure Profile
+このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と [Reliable Secure Profile](http://go.microsoft.com/fwlink/?LinkId=178140) \(RSP\) を作成する方法を示します。このサンプルでは、信頼できるメッセージ機能と共に作成できる [Make Connection](http://go.microsoft.com/fwlink/?LinkId=178141) チャネルの実装と、オプションとして、RSP 仕様に基づいて信頼できるセキュリティで保護されたバインドを作成するためのセキュリティで保護されたチャネルの実装を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Channels\ReliableSecureProfile`  
+  
+## 説明  
+ このサンプルでは、信頼できる非同期の双方向メッセージ交換シナリオを示します。サービスには双方向コントラクトがあり、クライアントには双方向コールバック コントラクトが実装されます。クライアントからサービスに対して要求が開始され、要求に対しては個別の接続で応答する必要があります。要求メッセージは信頼できる方法で送信されます。クライアントでは、終端にある待機エンドポイントを開きません。したがって、クライアントは "Make Connection" 要求を使用してサービスをポーリングし、サービスはこの "Make Connection" 要求のバック チャネルで応答を返信します。このサンプルでは、クライアントで待機エンドポイントを公開せずに \(また、ファイアウォールの例外を設けずに\)、HTTP を介してセキュリティで保護された信頼できる双方向通信を実現する方法を示します。  
+  
+## サンプルを設定、ビルド、および実行するには  
+  
+1.  **ReliableSecureProfile** ソリューションを開きます。  
+  
+2.  **ソリューション エクスプローラー**で **Service** プロジェクトを右クリックし、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックします。サービス ホストが開始されます。  
+  
+3.  **ソリューション エクスプローラー**で **Client** プロジェクトを右クリックし、コンテキスト メニューから **\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックします。クライアントが開始されます。  
+  
+4.  クライアント コンソール ウィンドウのプロンプトに任意の文字列を入力し、Enter キーを押します。入力文字列がサービスに送信され、この文字列のハッシュが計算されます。  
+  
+5.  クライアント コンソール ウィンドウに結果を表示するためにサービスから双方向コールバック コントラクト操作がコールバックされたら、クライアント ウィンドウで結果を確認します。実行に時間のかかるデータ処理操作を再現するために、サービスからの応答は意図的に遅延されます。  
+  
+6.  HTTP トラフィックの監視 \(ネットワーク モニター、Fiddler などのオンライン ネットワーク監視ツールを使用\) により、Reliable Secure Profile で規定されているように通信のシーケンスがクライアントとサービスの間で確立されていること、およびどのようにクライアントが "Make Connection" 要求を使用してサービスをポーリングしているかが示されます。サービスでは、処理した応答を返信できる状態になると、最後の "Make Connection" 要求のバック チャネルを使用して、結果を返信します。  
+  
+7.  サービス コンソール ウィンドウで Enter キーを押してサービスを終了します。クライアント コンソール ウィンドウで Enter キーを押してクライアントを終了します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/retrieve-metadata.md b/docs/framework/wcf/samples/retrieve-metadata.md
new file mode 100644
index 00000000000..01f8cc6f9c1
--- /dev/null
+++ b/docs/framework/wcf/samples/retrieve-metadata.md
@@ -0,0 +1,80 @@
+---
+title: "メタデータの抽出 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8a6ef8c-a195-495a-a15e-7d92bdf0b28c
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# メタデータの抽出
+このサンプルでは、サービスからメタデータを動的に取得し、通信に使用するエンドポイントを選択するクライアントを実装する方法を示します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  サービスは、2 つのエンドポイントを公開するように変更されています。1 つは `basicHttpBinding` バインディングを使用してベース アドレスで公開するエンドポイント、もう 1 つは `wsHttpBinding` バインディングを使用して {*baseaddress*}\/secure で公開するセキュリティ保護されたエンドポイントです。  これらのエンドポイント アドレスとバインディングを使用してクライアントを構成する代わりに、クライアントでは <xref:System.ServiceModel.Description.MetadataExchangeClient> クラスを使用してサービスのメタデータを動的に取得し、<xref:System.ServiceModel.Description.WsdlImporter> クラスを使用してこのメタデータを <xref:System.ServiceModel.Description.ServiceEndpointCollection> としてインポートします。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ クライアント アプリケーションはインポートされた <xref:System.ServiceModel.Description.ServiceEndpointCollection> を使用して、サービスとの通信に使用するクライアントを作成します。  クライアント アプリケーションは、取得した各エンドポイントを反復処理し、`ICalculator` コントラクトを実装した各エンドポイントと通信を行います。  適切なアドレスとバインディングは取得したエンドポイントで提供されます。これによって、クライアントは各エンドポイントと通信するように構成されます。次のサンプル コードを参照してください。  
+  
+```  
+// Create a MetadataExchangeClient for retrieving metadata.  
+EndpointAddress mexAddress = new EndpointAddress(ConfigurationManager.AppSettings["mexAddress"]);  
+MetadataExchangeClient mexClient = new MetadataExchangeClient(mexAddress);  
+  
+// Retrieve the metadata for all endpoints using metadata exchange protocol (mex).  
+MetadataSet metadataSet = mexClient.GetMetadata();  
+  
+//Convert the metadata into endpoints.  
+WsdlImporter importer = new WsdlImporter(metadataSet);  
+ServiceEndpointCollection endpoints = importer.ImportAllEndpoints();  
+  
+CalculatorClient client = null;  
+ContractDescription contract = ContractDescription.GetContract(typeof(ICalculator));  
+// Communicate with each endpoint that supports the ICalculator contract.  
+foreach (ServiceEndpoint ep in endpoints)  
+{  
+    if (ep.Contract.Namespace.Equals(contract.Namespace) && ep.Contract.Name.Equals(contract.Name))  
+    {  
+        // Create a client using the endpoint address and binding.  
+        client = new CalculatorClient(ep.Binding, new EndpointAddress(ep.Address.Uri));  
+        Console.WriteLine("Communicate with endpoint: ");  
+        Console.WriteLine("   AddressPath={0}", ep.Address.Uri.PathAndQuery);  
+        Console.WriteLine("   Binding={0}", ep.Binding.Name);  
+        // Call operations.  
+        DoCalculations(client);  
+  
+        //Closing the client gracefully closes the connection and cleans up resources.  
+        client.Close();  
+    }  
+}  
+  
+```  
+  
+ クライアント コンソール ウィンドウには、各エンドポイントに送信された操作が、そのエンドポイントのアドレス パスとバインディング名と共に表示されます。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版、C\+\+ 版、または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\RetrieveMetadata`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/route-by-body.md b/docs/framework/wcf/samples/route-by-body.md
new file mode 100644
index 00000000000..2c4c7d312e2
--- /dev/null
+++ b/docs/framework/wcf/samples/route-by-body.md
@@ -0,0 +1,85 @@
+---
+title: "本文別のルーティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 07a6fc3b-c360-42e0-b663-3d0f22cf4502
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 本文別のルーティング
+このサンプルでは、任意の SOAP アクションでメッセージ オブジェクトを受け入れるサービスを実装する方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。このサービスは、<xref:System.ServiceModel.Channels.Message> 要求パラメータを受け入れる 1 つの `Calculate` 操作を実装して、<xref:System.ServiceModel.Channels.Message> 応答を返します。  
+  
+ このサンプルでは、クライアントはコンソール アプリケーション \(.exe\) で、サービスは IIS によってホストされています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、本文の内容に基づくメッセージ ディスパッチを示します。組み込みの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス モデルのメッセージ ディスパッチ メカニズムは、メッセージの Action に基づいています。ただし既存の多くの Web サービスでは、すべての操作が Action\="" で定義されています。アクション情報に基づいてディスパッチ要求メッセージを保持する WSDL を基準として、サービスを構築することはできません。このサンプルでは、WSDL に基づくサービス コントラクトを示します \(WSDL はこのサンプルに含まれる Service.wsdl 内に格納されています\)。このサービス コンストラクトは電卓で、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」で使用されているものと同様です。ただし、`[OperationContract]` は、すべての操作に対して `Action=""` を指定します。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples"),    
+                 XmlSerializerFormat, DispatchByBodyBehavior]  
+    public interface ICalculator  
+    {  
+        [OperationContract(Action="")]  
+        double Add(double n1, double n2);  
+        [OperationContract(Action = "")]  
+        double Subtract(double n1, double n2);  
+        [OperationContract(Action = "")]  
+        double Multiply(double n1, double n2);  
+        [OperationContract(Action = "")]  
+        double Divide(double n1, double n2);  
+    }  
+  
+```  
+  
+ コントラクトが指定されている場合、サービスはカスタムのディスパッチ動作 `DispatchByBodyBehavior` に対して、複数の操作間でメッセージをディスパッチするように要求します。このディスパッチ動作は、カスタムの `DispatchByBodyElementOperationSelector`  操作セレクターを、それぞれのラッパー要素の QName をキーとする操作名のテーブルを使用して初期化します。`DispatchByBodyElementOperationSelector` は本文の最初の子の開始タグを参照し、前述のテーブルを使用して操作を選択します。  
+  
+ クライアントは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用するサービスによってエクスポートされた WSDL から自動生成された、プロキシを使用します。  
+  
+```  
+svcutil.exe  /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples /uxs http://localhost/servicemodelsamples/service.svc?wsdl /out:generatedProxy.cs  
+```  
+  
+ すべての操作のアクションが空であっても、クライアント コードには影響ありません。ただし、自動生成されたプロキシ内の Action パラメータは例外です。  
+  
+ クライアント コードは、複数の計算を実行します。このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100, 15.99) = 115.99  
+Subtract(145, 76.54) = 68.46  
+Multiply(9, 81.25) = 731.25  
+Divide(22, 7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Interop\RouteByBody`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/routing-services.md b/docs/framework/wcf/samples/routing-services.md
new file mode 100644
index 00000000000..09f7aaf0c83
--- /dev/null
+++ b/docs/framework/wcf/samples/routing-services.md
@@ -0,0 +1,36 @@
+---
+title: "ルーティング サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a430b4c-46eb-4d15-afbc-8834f0e985ab
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ルーティング サービス
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ルーターを使用する方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ルーティング サービスを使用した Hello World](../../../../docs/framework/wcf/samples/hello-world-with-the-routing-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ルーターを使用する方法を示します。  
+  
+ [ブリッジとエラー処理](../../../../docs/framework/wcf/samples/bridging-and-error-handling.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] ルーティング サービスを、各種のバインディングを使用するクライアントとサービス間の通信をブリッジするために使用する方法を示します。  
+  
+ [高度なフィルター](../../../../docs/framework/wcf/samples/advanced-filters.md)  
+ 標準の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 電卓のサンプルを改良し、ルーティング サービスを使用して通信する方法を示します。  
+  
+ [動的再構成](../../../../docs/framework/wcf/samples/dynamic-reconfiguration.md)  
+ 実行時にルーティング サービスを動的に再構成する方法を示します。  
+  
+ [高度なエラー処理](../../../../docs/framework/wcf/samples/advanced-error-handling.md)  
+ トランザクションやその他のより複雑なメッセージ概念 \(マルチキャストなど\) を使用して、ルーティング サービスをエラーから自動的に回復する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/running-the-samples.md b/docs/framework/wcf/samples/running-the-samples.md
new file mode 100644
index 00000000000..ecb947627f6
--- /dev/null
+++ b/docs/framework/wcf/samples/running-the-samples.md
@@ -0,0 +1,92 @@
+---
+title: "Windows Communication Foundation サンプルの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: db8a83da-95c1-4a21-a9d2-48caeb6398ea
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# Windows Communication Foundation サンプルの実行
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルは、単一コンピューター構成または複数コンピューター構成で実行できます。  サンプルは、単一コンピューターでそのまま実行できます。  複数コンピューター構成で実行するには、サンプルの構成ファイルの設定を変更する必要があります。  単一コンピューターおよび複数コンピューターの構成でサンプルを実行する手順を、次に示します。  インターネット インフォメーション サービス \(IIS\) でホストされるサービスと自己ホスト型のサービスのサンプルとでは、手順が異なります。  ほとんどのサンプルは IIS でホストされます。サンプルのホスト方法を判断するには、サンプルの Readme 情報を参照してください。  
+  
+ [!INCLUDE[wv](../../../../includes/wv-md.md)] では、IIS でホストされていないサンプルには、リスナーを Http.sys に登録するための管理特権が必要です。  Httpcfg.exe を使用して、サービスのリッスン アドレスをサービスが実行されているアカウントに登録するか、管理者権限で実行されているコマンド プロンプトでサービスを起動します。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルをビルドまたは実行する前に、「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」に記述されている手順が完了していることを確認してください。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  サービスが IIS でホストされている場合は、ブラウザーにアドレス http:\/\/localhost\/servicemodelsamples\/service.svc を入力して、サービスにアクセスできることを確認します。  これに応答して、確認ページが表示されます。  確認ページが表示されない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+2.  サービスが自己ホスト型の場合は、言語固有のフォルダーの下の \\service\\bin にある Service.exe を実行します。  サービス アクティビティがサービス コンソール ウィンドウに表示されます。  
+  
+3.  言語固有のフォルダーの下の \\client\\bin\\ にある Client.exe を実行します。  クライアント アクティビティがクライアント コンソール ウィンドウに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数コンピューターで実行するには  
+  
+1.  サービスが IIS でホストされている場合 :  
+  
+    1.  サービス コンピューターで、ServiceModelSamples という仮想ディレクトリを作成します。  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」に含まれている Setupvroot.bat バッチ ファイルを使用して、ディスク ディレクトリと仮想ディレクトリを作成できます。  
+  
+    2.  サービス プログラム ファイルを %SystemDrive%\\Inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの ServiceModelSamples 仮想ディレクトリにコピーします。  このファイルが \\bin ディレクトリにあることを確認します。  
+  
+    3.  ブラウザーを使用して、サービスにクライアント コンピューターからアクセスできるかどうかをテストします。  
+  
+     サービスが自己ホスト型の場合、次の手順を実行します。  
+  
+    1.  サービス コンピューターで、サービス ファイルを保持するディレクトリを作成します。  
+  
+    2.  サービス プログラム ファイルを、言語固有のフォルダーにある \\service\\bin\\ フォルダーからサービス コンピューターにコピーします。  
+  
+    3.  サービスの構成ファイルで、エンドポイント定義のアドレス値をサービスの新しいアドレスに変更します。  アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+    4.  コマンド プロンプトから Service.exe を起動します。  
+  
+2.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+3.  エンドポイント アドレスを設定します。  
+  
+    1.  サービスの実行に使用されているのがドメイン アカウントではない場合、クライアント構成ファイルを開き、エンドポイント定義のアドレス値をサービスの新しいアドレスに変更します。  アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+    2.  サービスの実行に使用されているのがドメイン アカウントの場合、サービスに対して Svcutil.exe を実行し、クライアントの構成を再生成します。  Svcutil.exe の実行[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」を参照してください。  サンプルの構成ファイルではなく、生成されたファイルを使用します。  生成された構成ファイルには、追加の ID 情報があります \(また、サービス エンドポイントへの接続に必要なすべての設定が、既定の設定であるにもかかわらず含まれています\)。  ID [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[サービス ID と認証](../../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)」および「[\<identity\>](../../../../docs/framework/configure-apps/file-schema/wcf/identity.md)」を参照してください。  
+  
+4.  クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+### サービスをデバッグするには  
+  
+1.  \(クライアントとサービスの両方で\) **\[Build\]** メニューを使用するか、または Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+2.  サービスが IIS でホストされている場合 :  
+  
+    1.  サービスをアクティブ化します。ブラウザーにアドレス http:\/\/localhost\/servicemodelsamples\/service.svc を入力します。  
+  
+    2.  ソリューションで、**\[Debug\]** メニューの **\[Attach to Process\]** をクリックします。  
+  
+    3.  **\[Show processes from all users\]** チェック ボックスをオンにします。  
+  
+    4.  デバッグ対象のホスト ワーカー プロセス W3wp.exe を選択します \(Windows XP では ASPNet\_wp.exe を選択します\)。  
+  
+3.  これで、サービス内にブレークポイントを設定し、例外に対してブレークポイントを有効にできます。  
+  
+4.  クライアントのプロジェクト項目を右クリックし、**\[デバッグ\]**、**\[新しいインスタンスを開始\]** の順にクリックします。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サービスがセキュリティの目的で IIS でホストされている場合、サンプルの使用が終わったら、このセットアップで付与された仮想ディレクトリの定義とアクセス許可を削除してください。  
+  
+## 参照  
+ [Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)   
+ [Running the Samples in a Workgroup and Across Machines](http://msdn.microsoft.com/ja-jp/a451a525-e7ce-452d-9da9-620221260113)   
+ [Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/saml-token-provider.md b/docs/framework/wcf/samples/saml-token-provider.md
new file mode 100644
index 00000000000..54a8c057767
--- /dev/null
+++ b/docs/framework/wcf/samples/saml-token-provider.md
@@ -0,0 +1,411 @@
+---
+title: "SAML トークン プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eb16e5e2-4c8d-4f61-a479-9c965fcec80c
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# SAML トークン プロバイダー
+このサンプルでは、カスタム クライアントの SAML トークン プロバイダーを実装する方法を示します。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトークン プロバイダーは、資格情報をセキュリティ インフラストラクチャに提供するために使用します。  一般的に、トークン プロバイダーは、ターゲットをチェックし、適切な証明書を発行して、セキュリティ インフラストラクチャがメッセージのセキュリティを保護できるようにします。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、既定の Credential Manager Token Provider が付属しています。  また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、[!INCLUDE[infocard](../../../../includes/infocard-md.md)] トークン プロバイダーも付属しています。  カスタム トークン プロバイダーは、次の場合に便利です。  
+  
+-   トークン プロバイダーが連携動作できない資格情報ストアがある場合。  
+  
+-   資格情報をユーザーが詳細を提供した時点から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント フレームワークが資格情報を使用した時点に変換するための、独自のカスタム メカニズムを提供する場合。  
+  
+-   カスタム トークンを構築している場合。  
+  
+ このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント フレームワーク以外から取得した SAML トークンを使用できるようにする、カスタム トークン プロバイダーを構築する方法を示します。  
+  
+ このサンプルに示されている手順の概要は次のとおりです。  
+  
+-   クライアントをカスタム トークン プロバイダーを使用して構成する手順。  
+  
+-   SAML トークンをカスタム クライアント資格情報に渡す手順。  
+  
+-   SAML トークンを [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント フレームワークに提供する手順。  
+  
+-   サーバーがクライアントによってサーバーの X.509 証明書を使用して認証される手順。  
+  
+ サービスは、そのサービスとの通信に使用する 2 つのエンドポイントを公開します。エンドポイントは構成ファイル App.config で定義します。  各エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。  バインディングの構成には、標準の `wsFederationHttpBinding` が使用されます。これはメッセージ セキュリティを使用します。  1 つのエンドポイントは、クライアントが対称証明キーを使用する SAML トークンで認証を行うことを想定しています。これに対してもう 1 つのエンドポイントでは、クライアントが非対称証明キーを使用する SAML トークンで認証を行うことを想定しています。  また、サービスは `serviceCredentials` 動作を使用してサービス証明書の構成も行います。  `serviceCredentials` 動作を使用すると、サービス証明書を構成できます。  クライアントはサービス証明書を使用して、サービスを認証し、メッセージを保護します。  次の構成では、このトピックの最後のセットアップ手順で説明しているサンプル セットアップでインストールされる "localhost" 証明書を参照しています。  `serviceCredentials` 動作を使用すると、SAML トークンに署名する信頼できる証明書を構成することもできます。  次の構成では、サンプルでインストールされる 'Alice' 証明書を参照しています。  
+  
+```  
+<system.serviceModel>  
+ <services>  
+  <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+   <host>  
+    <baseAddresses>  
+     <!-- configure base address provided by host -->  
+     <add    
+  baseAddress="http://localhost:8000/servicemodelsamples/service/" />  
+    </baseAddresses>  
+   </host>  
+   <!-- use base address provided by host -->  
+   <!-- Endpoint that expect SAML tokens with Symmetric proof keys -->  
+   <endpoint address="calc/symm"  
+             binding="wsFederationHttpBinding"  
+             bindingConfiguration="Binding1"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+   <!-- Endpoint that expect SAML tokens with Asymmetric proof keys -->  
+   <endpoint address="calc/asymm"  
+             binding="wsFederationHttpBinding"  
+             bindingConfiguration="Binding2"   
+             contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  </service>  
+ </services>  
+  
+ <bindings>  
+  <wsFederationHttpBinding>  
+   <!-- Binding that expect SAML tokens with Symmetric proof keys -->  
+   <binding name="Binding1">  
+    <security mode="Message">  
+     <message negotiateServiceCredential ="false"   
+              issuedKeyType="SymmetricKey"   
+              issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1"  />  
+    </security>  
+   </binding>  
+   <!-- Binding that expect SAML tokens with Asymmetric proof keys -->  
+   <binding name="Binding2">  
+    <security mode="Message">  
+     <message negotiateServiceCredential ="false"  
+              issuedKeyType="AsymmetricKey"   
+              issuedTokenType="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1"  />  
+    </security>  
+   </binding>          
+  </wsFederationHttpBinding>  
+ </bindings>  
+  
+ <behaviors>  
+  <serviceBehaviors>  
+   <behavior name="CalculatorServiceBehavior">  
+    <!--   
+    The serviceCredentials behavior allows one to define a service certificate.  
+    A service certificate is used by a client to authenticate the service and provide message protection.  
+    This configuration references the "localhost" certificate installed during the setup instructions.  
+    -->  
+    <serviceCredentials>  
+     <!-- Set allowUntrustedRsaIssuers to true to allow self-signed, asymmetric key based SAML tokens -->  
+     <issuedTokenAuthentication allowUntrustedRsaIssuers ="true" >  
+      <!-- Add Alice to the list of certs trusted to issue SAML tokens -->  
+      <knownCertificates>  
+       <add storeLocation="LocalMachine"   
+            storeName="TrustedPeople"   
+            x509FindType="FindBySubjectName"   
+            findValue="Alice"/>  
+      </knownCertificates>  
+     </issuedTokenAuthentication>  
+     <serviceCertificate storeLocation="LocalMachine"  
+                         storeName="My"  
+                         x509FindType="FindBySubjectName"  
+                         findValue="localhost"  />  
+    </serviceCredentials>  
+   </behavior>  
+  </serviceBehaviors>  
+ </behaviors>  
+  
+</system.serviceModel>  
+```  
+  
+ カスタムの SAML トークン プロバイダーを開発して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークに統合する方法を、次の手順に示します。  
+  
+1.  カスタムの SAML トークン プロバイダーを作成します。  
+  
+     サンプルでは、構築時に提供される SAML アサーションに基づいてセキュリティ トークンを返す、カスタムの SAML トークン プロバイダーを実装します。  
+  
+     このタスクを実行するため、カスタム トークン プロバイダーは <xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスから派生し、<xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%2A> メソッドをオーバーライドします。  このメソッドは、新しい `SecurityToken` を作成して返します。  
+  
+    ```  
+    protected override SecurityToken GetTokenCore(TimeSpan timeout)  
+    {  
+     // Create a SamlSecurityToken from the provided assertion  
+     SamlSecurityToken samlToken = new SamlSecurityToken(assertion);  
+  
+     // Create a SecurityTokenSerializer that will be used to   
+     // serialize the SamlSecurityToken  
+     WSSecurityTokenSerializer ser = new WSSecurityTokenSerializer();  
+     // Create a memory stream to write the serialized token into  
+     // Use an initial size of 64Kb  
+     MemoryStream s = new MemoryStream(UInt16.MaxValue);  
+  
+     // Create an XmlWriter over the stream  
+     XmlWriter xw = XmlWriter.Create(s);  
+  
+     // Write the SamlSecurityToken into the stream  
+     ser.WriteToken(xw, samlToken);  
+  
+     // Seek back to the beginning of the stream  
+     s.Seek(0, SeekOrigin.Begin);  
+  
+     // Load the serialized token into a DOM  
+     XmlDocument dom = new XmlDocument();  
+     dom.Load(s);  
+  
+     // Create a KeyIdentifierClause for the SamlSecurityToken  
+     SamlAssertionKeyIdentifierClause samlKeyIdentifierClause = samlToken.CreateKeyIdentifierClause<SamlAssertionKeyIdentifierClause>();  
+  
+    // Return a GenericXmlToken from the XML for the   
+    // SamlSecurityToken, the proof token, the valid from and valid  
+    // until times from the assertion and the key identifier clause  
+    // created above  
+    return new GenericXmlSecurityToken(dom.DocumentElement, proofToken, assertion.Conditions.NotBefore, assertion.Conditions.NotOnOrAfter, samlKeyIdentifierClause, samlKeyIdentifierClause, null);  
+    }  
+    ```  
+  
+2.  カスタム セキュリティ トークン マネージャーを作成します。  
+  
+     <xref:System.IdentityModel.Selectors.SecurityTokenManager> クラスは、`CreateSecurityTokenProvider` メソッド内で渡される特定の <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> の <xref:System.IdentityModel.Selectors.SecurityTokenProvider> の作成に使用されます。  セキュリティ トークン マネージャーは、トークン認証システムとトークン シリアライザーの作成にも使用されますが、このサンプルでは扱っていません。  このサンプルでは、カスタム セキュリティ トークン マネージャーは <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスを継承し、渡されたトークンの要件で SAML トークンが必要であることが示されている場合に、`CreateSecurityTokenProvider` メソッドをオーバーライドしてカスタムの SAML トークン プロバイダーを返します。  クライアント資格情報クラス \(手順 3. を参照\) がアサーションを指定していない場合、セキュリティ トークン マネージャーは適切なインスタンスを作成します。  
+  
+    ```  
+    public class SamlSecurityTokenManager :  
+     ClientCredentialsSecurityTokenManager  
+    {  
+     SamlClientCredentials samlClientCredentials;  
+  
+     public SamlSecurityTokenManager ( SamlClientCredentials samlClientCredentials)  
+      : base(samlClientCredentials)  
+     {  
+      // Store the creating client credentials  
+      this.samlClientCredentials = samlClientCredentials;  
+     }  
+  
+     public override SecurityTokenProvider CreateSecurityTokenProvider ( SecurityTokenRequirement tokenRequirement )  
+     {  
+      // If token requirement matches SAML token return the   
+      // custom SAML token provider  
+      if (tokenRequirement.TokenType == SecurityTokenTypes.Saml ||  
+          tokenRequirement.TokenType == "http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1")  
+      {  
+       // Retrieve the SAML assertion and proof token from the   
+       // client credentials  
+       SamlAssertion assertion = this.samlClientCredentials.Assertion;  
+       SecurityToken prooftoken = this.samlClientCredentials.ProofToken;  
+  
+       // If either the assertion of proof token is null...  
+       if (assertion == null || prooftoken == null)  
+       {  
+        // ...get the SecurityBindingElement and then the   
+        // specified algorithm suite  
+        SecurityBindingElement sbe = null;  
+        SecurityAlgorithmSuite sas = null;  
+  
+        if ( tokenRequirement.TryGetProperty<SecurityBindingElement> ( "http://schemas.microsoft.com/ws/2006/05/servicemodel/securitytokenrequirement/SecurityBindingElement", out sbe))  
+        {  
+         sas = sbe.DefaultAlgorithmSuite;  
+        }  
+  
+        // If the token requirement is for a SymmetricKey based token..  
+        if (tokenRequirement.KeyType == SecurityKeyType.SymmetricKey)  
+        {  
+         // Create a symmetric proof token  
+         prooftoken = SamlUtilities.CreateSymmetricProofToken ( tokenRequirement.KeySize );  
+         // and a corresponding assertion based on the claims specified in the client credentials  
+         assertion = SamlUtilities.CreateSymmetricKeyBasedAssertion ( this.samlClientCredentials.Claims, new X509SecurityToken ( samlClientCredentials.ClientCertificate.Certificate ), new X509SecurityToken ( samlClientCredentials.ServiceCertificate.DefaultCertificate ), (BinarySecretSecurityToken)prooftoken, sas);  
+        }  
+        // otherwise...  
+        else  
+        {  
+         // Create an asymmetric proof token  
+         prooftoken = SamlUtilities.CreateAsymmetricProofToken();  
+         // and a corresponding assertion based on the claims   
+         // specified in the client credentials  
+         assertion = SamlUtilities.CreateAsymmetricKeyBasedAssertion ( this.samlClientCredentials.Claims, prooftoken, sas );  
+        }  
+       }  
+  
+       // Create a SamlSecurityTokenProvider based on the assertion and proof token  
+       return new SamlSecurityTokenProvider(assertion, prooftoken);  
+      }  
+      // otherwise use base implementation  
+      else  
+      {  
+       return base.CreateSecurityTokenProvider(tokenRequirement);  
+      }  
+    }  
+  
+    ```  
+  
+3.  カスタム クライアント資格情報を作成します。  
+  
+     クライアント資格情報クラスは、クライアント プロキシ用に構成された資格情報を表すために使用され、トークン認証システム、トークン プロバイダー、およびトークン シリアライザーの取得に使用されるセキュリティ トークン マネージャーを作成します。  
+  
+    ```  
+    public class SamlClientCredentials : ClientCredentials  
+    {  
+     ClaimSet claims;  
+     SamlAssertion assertion;  
+     SecurityToken proofToken;  
+  
+     public SamlClientCredentials() : base()  
+     {  
+      // Set SupportInteractive to false to suppress Cardspace UI  
+      base.SupportInteractive = false;  
+     }  
+  
+     protected SamlClientCredentials(SamlClientCredentials other) : base ( other )  
+     {  
+      // Just do reference copy given sample nature  
+      this.assertion = other.assertion;  
+      this.claims = other.claims;  
+      this.proofToken = other.proofToken;  
+     }  
+  
+     public SamlAssertion Assertion { get { return assertion; } set { assertion = value; } }  
+  
+     public SecurityToken ProofToken { get { return proofToken; } set { proofToken = value; } }  
+     public ClaimSet Claims { get { return claims; } set { claims = value; } }  
+  
+     protected override ClientCredentials CloneCore()  
+     {  
+      return new SamlClientCredentials(this);  
+     }  
+  
+     public override SecurityTokenManager CreateSecurityTokenManager()  
+     {  
+      // return custom security token manager  
+      return new SamlSecurityTokenManager(this);  
+     }  
+    }  
+    ```  
+  
+4.  カスタム クライアント資格情報を使用するようクライアントを構成します。  
+  
+     サンプルでは既定のクライアント資格情報を削除し、新しいクライアント資格情報クラスを提供して、クライアントがカスタム クライアント資格情報を使用できるようにします。  
+  
+    ```  
+    // Create new credentials class  
+    SamlClientCredentials samlCC = new SamlClientCredentials();  
+  
+    // Set the client certificate. This is the cert that will be used to sign the SAML token in the symmetric proof key case  
+    samlCC.ClientCertificate.SetCertificate(StoreLocation.CurrentUser, StoreName.My, X509FindType.FindBySubjectName, "Alice");  
+  
+    // Set the service certificate. This is the cert that will be used to encrypt the proof key in the symmetric proof key case  
+    samlCC.ServiceCertificate.SetDefaultCertificate(StoreLocation.CurrentUser, StoreName.TrustedPeople, X509FindType.FindBySubjectName, "localhost");  
+  
+    // Create some claims to put in the SAML assertion  
+    IList<Claim> claims = new List<Claim>();  
+    claims.Add(Claim.CreateNameClaim(samlCC.ClientCertificate.Certificate.Subject));  
+    ClaimSet claimset = new DefaultClaimSet(claims);  
+    samlCC.Claims = claimset;  
+  
+    // set new credentials  
+    client.ChannelFactory.Endpoint.Behaviors.Remove(typeof(ClientCredentials));  
+    client.ChannelFactory.Endpoint.Behaviors.Add(samlCC);  
+    ```  
+  
+ サービスでは、呼び出し元に関連するクレームが表示されます。  このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。  このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成 :  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  `%SERVER_NAME%` 変数はサーバー名です。  この変数を変更して、使用するサーバー名を指定します。  このバッチ ファイルでの既定値は localhost です。  
+  
+     証明書は、LocalMachine ストアの場所の My \(Personal\) ストアに保存されます。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss My -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r LocalMachine -s TrustedPeople  
+    ```  
+  
+-   発行元の証明書の作成  
+  
+     Setup.bat バッチ ファイルの次の行は、使用する発行元の証明書を作成します。  `%USER_NAME%` 変数は発行元の名前です。  この変数を変更して、使用する発行元の名前を指定します。  このバッチ ファイルでの既定値は Alice です。  
+  
+     証明書は、CurrentUser 保存場所の My ストアに保存されます。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr CurrentUser -ss My -a sha1 -n CN=%USER_NAME% -sky exchange -pe  
+    ```  
+  
+-   サーバーの信頼された証明書ストアへの発行元証明書のインストール  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、サーバー証明書ストアに発行元証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r CurrentUser -s My -c -n %USER_NAME% -r LocalMachine -s TrustedPeople  
+  
+    ```  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを実行し、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  Service.exe を service\\bin で起動します。  
+  
+3.  Client.exe を \\client\\bin で起動します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サービス コンピューターのサービス ディレクトリにコピーします。  Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  コンピューターの完全修飾ドメイン名を含むサブジェクト名を持つサーバー証明書が必要です。  新しい証明書名を反映するには、Service.exe.config ファイルを更新する必要があります。  サーバー証明書を作成するには、Setup.bat バッチ ファイルを変更します。  setup.bat ファイルは、管理特権を使用して開いた Visual Studio コマンド プロンプト ウィンドウで実行する必要があります。  `%SERVER_NAME%` 変数には、サービスをホストするコンピューターの完全修飾ホスト名を設定する必要があります。  
+  
+4.  サーバー証明書をクライアントの CurrentUser\-TrustedPeople ストアにコピーします。  この手順は、サーバー証明書の発行元をクライアントが信頼できる場合は不要です。  
+  
+5.  サービス コンピューターの Service.exe.config ファイルで、ベース アドレスの値を localhost から完全修飾コンピューター名に変更します。  
+  
+6.  サービス コンピューターで、コマンド プロンプトから Service.exe を実行します。  
+  
+7.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント コンピューターで、コマンド プロンプト ウィンドウから `Client.exe` を起動します。  
+  
+10. クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/scenario.md b/docs/framework/wcf/samples/scenario.md
new file mode 100644
index 00000000000..0975df7d9cb
--- /dev/null
+++ b/docs/framework/wcf/samples/scenario.md
@@ -0,0 +1,39 @@
+---
+title: "シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 816557e0-f676-4731-95c5-b02cbef3d8d7
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# シナリオ
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] シナリオを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [データ バインドのシナリオ](../../../../docs/framework/wcf/samples/data-binding-scenarios.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のデータ バインドのシナリオを示します。  
+  
+ [探索のセキュリティのサンプル](../../../../docs/framework/wcf/samples/discovery-security-sample.md)  
+ コンパクトな署名形式 \(WS\-Discovery 仕様のセクション 8.2 を参照\) を使用してメッセージ署名の計算と検証を行うカスタム チャネルの実装方法を示します。  
+  
+ [フェデレーション サンプル](../../../../docs/framework/wcf/samples/federation-sample.md)  
+ フェデレーション セキュリティを示します。  
+  
+ [弱い型指定の JSON のシリアル化 \(AJAX\)](../../../../docs/framework/wcf/samples/weakly-typed-json-serialization-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 開発者がユーザー定義型を作成せずに、逆シリアル化された任意の JSON オブジェクトを使用する方法を示します。  
+  
+ [信頼されたファサード サービス](../../../../docs/framework/wcf/samples/trusted-facade-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャを使用して、呼び出し元の ID 情報をあるサービスから別のサービスにフローする方法を示します。  
+  
+ [デザイン パターン : リストに基づく公開\/定期受信](../../../../docs/framework/wcf/samples/design-patterns-list-based-publish-subscribe.md)  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] プログラムとして実装された、リストに基づく公開\/定期受信パターンを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/security-extensibility.md b/docs/framework/wcf/samples/security-extensibility.md
new file mode 100644
index 00000000000..1554393f599
--- /dev/null
+++ b/docs/framework/wcf/samples/security-extensibility.md
@@ -0,0 +1,51 @@
+---
+title: "セキュリティ拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2afe044d-df4a-49a4-9865-38700474c3dd
+caps.latest.revision: 7
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 7
+---
+# セキュリティ拡張
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのカスタム セキュリティを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [永続性発行済みトークン プロバイダー](../../../../docs/framework/wcf/samples/durable-issued-token-provider.md)  
+ カスタム クライアントの発行済みトークン プロバイダーを実装する方法を示します。  
+  
+ [SAML トークン プロバイダー](../../../../docs/framework/wcf/samples/saml-token-provider.md)  
+ カスタム クライアントの SAML トークン プロバイダーを実装する方法を示します。  
+  
+ [トークンのサポート](../../../../docs/framework/wcf/samples/supporting-tokens.md)  
+ WS\-Security を使用するメッセージに追加トークンを追加する方法を示します。  
+  
+ [トークン認証システム](../../../../docs/framework/wcf/samples/token-authenticator.md)  
+ カスタム トークンの認証システムを実装する方法を示します。  
+  
+ [トークン プロバイダー](../../../../docs/framework/wcf/samples/token-provider.md)  
+ カスタム トークン プロバイダーを実装する方法を示します。  
+  
+ [ユーザー名パスワード検証](../../../../docs/framework/wcf/samples/user-name-password-validator.md)  
+ カスタム UserNamePassword 検証を実装する方法を示します。  
+  
+ [X.509 証明書検証](../../../../docs/framework/wcf/samples/x-509-certificate-validator.md)  
+ カスタム X.509 証明書検証を実装する方法を示します。  
+  
+ [承認ポリシー](../../../../docs/framework/wcf/samples/authorization-policy.md)  
+ カスタム クレーム承認ポリシーと、関連するカスタム サービス承認マネージャーを実装する方法を示します。  
+  
+ [カスタム トークン](../../../../docs/framework/wcf/samples/custom-token.md)  
+ カスタム トークンの実装を [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションに追加する方法を示します。  
+  
+ [クライアント検証](../../../../docs/framework/wcf/samples/client-validation.md)  
+ サービス エンドポイントを検証するクライアント エンドポイントの動作を記述して、サービス エンドポイントを安全に使用できることを確認する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/security-in-wcf.md b/docs/framework/wcf/samples/security-in-wcf.md
new file mode 100644
index 00000000000..5a20f4603b3
--- /dev/null
+++ b/docs/framework/wcf/samples/security-in-wcf.md
@@ -0,0 +1,24 @@
+---
+title: "WCF でのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 05d73638-30a9-43b4-8c86-f27f57b6eef1
+caps.latest.revision: 3
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 3
+---
+# WCF でのセキュリティ
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティに関連するサンプルが含まれています。  
+  
+## このセクションの内容  
+ [WCF セキュリティの暗号化方式の指定](../../../../docs/framework/wcf/samples/cryptographic-agility-in-wcf-security.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントおよびサービスで迅速な暗号化実装を提供するために標準またはカスタム アルゴリズムで指定する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/security-validation.md b/docs/framework/wcf/samples/security-validation.md
new file mode 100644
index 00000000000..ecfd4c1b056
--- /dev/null
+++ b/docs/framework/wcf/samples/security-validation.md
@@ -0,0 +1,117 @@
+---
+title: "セキュリティ検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 48dcd496-0c4f-48ce-8b9b-0e25b77ffa58
+caps.latest.revision: 35
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 35
+---
+# セキュリティ検証
+このサンプルでは、サービスが特定の条件を満たしていることを確認するカスタム動作を使用して、コンピューター上のサービスを検証する方法を示します。このサンプルでは、サービス上の各エンドポイントをスキャンし、セキュリティ保護されたバインディング要素が含まれているかどうかを確認するカスタム動作を使用して、サービスを検証します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## エンドポイント検証のカスタム動作  
+ <xref:System.ServiceModel.Description.IServiceBehavior> インターフェイスに含まれる `Validate` メソッドにユーザー コードを追加することによって、サービスまたはエンドポイントにカスタム動作を与え、ユーザー定義のアクションを実行することができます。次のコードを使用すると、サービスに含まれる各エンドポイントをループし、バインディング コレクションからセキュリティ保護されたバインディングが検索されます。  
+  
+```  
+public void Validate(ServiceDescription serviceDescription,   
+                                       ServiceHostBase serviceHostBase)  
+{  
+    // Loop through each endpoint individually gathering their    
+       binding elements.  
+    foreach (ServiceEndpoint endpoint in serviceDescription.Endpoints)  
+    {  
+        secureElementFound = false;  
+  
+        // Retrieve the endpoint's binding element collection.  
+        BindingElementCollection bindingElements =   
+            endpoint.Binding.CreateBindingElements();  
+  
+        // Look to see if the binding elements collection contains any   
+        // secure binding elements. Transport, Asymmetric, and Symmetric      
+        // binding elements are all derived from SecurityBindingElement.  
+        if ((bindingElements.Find<SecurityBindingElement>() != null) || (bindingElements.Find<HttpsTransportBindingElement>() != null) || (bindingElements.Find<WindowsStreamSecurityBindingElement>() != null) || (bindingElements.Find<SslStreamSecurityBindingElement>() != null))  
+        {  
+            secureElementFound = true;  
+        }  
+  
+    // Send a message to the system event viewer when an endpoint is deemed insecure.  
+    if (!secureElementFound)  
+        throw new Exception(System.DateTime.Now.ToString() + ": The endpoint \"" + endpoint.Name + "\" has no secure bindings.");  
+    }  
+}  
+```  
+  
+ 次のコードを Web.config ファイルに追加すると、サービスで識別される `serviceValidate` 動作の拡張が追加されます。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+        <behaviorExtensions>  
+            <add name="endpointValidate" type="Microsoft.ServiceModel.Samples.EndpointValidateElement, endpointValidate, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+        </behaviorExtensions>  
+    </extensions>  
+...  
+```  
+  
+ 動作の拡張がサービスに追加されると、`endpointValidate` の動作を Web.config ファイルの動作リストに追加でき、さらにはサービスに追加できるようになります。  
+  
+```  
+<behaviors>  
+    <serviceBehaviors>  
+        <behavior name="CalcServiceSEB1">  
+            <serviceMetadata httpGetEnabled="true" />  
+            <endpointValidate />  
+        </behavior>  
+    </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ 動作とその拡張が Web.config ファイルに追加されると、動作は個別のサービスに適用されます。一方で Machine.config ファイルに追加された場合は、動作はコンピューター上でアクティブなすべてのサービスに適用されます。  
+  
+> [!NOTE]
+>  動作をすべてのサービスに追加する場合、Machine.config ファイルの変更を行う前に、このファイルのバックアップを推奨するメッセージが表示されます。  
+  
+ ここで、このサンプルの client\\bin ディレクトリに用意されたクライアントを実行します。例外が発生して、"要求されたサービス、'http:\/\/localhost\/servicemodelsamples\/service.svc' を起動できませんでした。" というメッセージが表示されます。これは予期される例外です。エンドポイント検証の動作により、エンドポイントがセキュリティで保護されていないと見なされ、サービスが開始されないためです。さらにこの動作によって、エンドポイントがセキュリティ保護されていないという内部例外がスローされ、システム イベント ビューアで "WebHost" カテゴリの "System.ServiceModel 4.0.0.0" ソースの下にメッセージが書き込まれます。さらにこのサンプルでは、サービスのトレースを有効にできます。これによって、サービス トレース ビューア ツールを使用してサービス トレースの結果を開き、エンドポイント検証の動作からスローされた例外を表示することができます。  
+  
+#### エンドポイント検証エラーの例外メッセージをイベント ビューアーで表示するには  
+  
+1.  **\[スタート\]** メニューをクリックし、**\[ファイル名を指定して実行\]** をクリックします。  
+  
+2.  「`eventvwr`」と入力して **\[OK\]** をクリックします。  
+  
+3.  \[イベント ビューアー\] ウィンドウの **\[アプリケーション\]** をクリックします。  
+  
+4.  **\[アプリケーション\]** ウィンドウで、"WebHost" カテゴリの下に最近追加された "System.ServiceModel 4.0.0.0" イベントをダブルクリックし、セキュリティ保護されていないエンドポイントのメッセージを表示します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\ServiceValidation`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/self-host.md b/docs/framework/wcf/samples/self-host.md
new file mode 100644
index 00000000000..81d7ea19c3a
--- /dev/null
+++ b/docs/framework/wcf/samples/self-host.md
@@ -0,0 +1,90 @@
+---
+title: "自己ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "自己ホストのサンプル [Windows Communication Foundation]"
+  - "自己ホスト型サービス"
+ms.assetid: 05e68661-1ddf-4abf-a899-9bb1b8272a5b
+caps.latest.revision: 38
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# 自己ホスト
+このサンプルでは、自己ホスト型サービスをコンソール アプリケーションに実装する方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。サービス構成ファイルは、名前が Web.config から App.config に変更され、ホストが使用するベース アドレスを構成するように変更されました。サービス ソース コードは、構成されたベース アドレスを提供するサービス ホストを作成して開く、静的な `Main` 関数を実装するように変更されました。サービス実装は、操作ごとにコンソールに出力を書き込むように変更されました。クライアントは、サービスのエンドポイント アドレスが正しく構成されたことを除き、変更されていません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、静的な main 関数を実装し、指定された `CalculatorService` 型の <xref:System.ServiceModel.ServiceHost> を作成します。次のサンプル コードを参照してください。  
+  
+```  
+// Host the service within this EXE console application.  
+public static void Main()  
+{  
+    // Create a ServiceHost for the CalculatorService type.  
+    using (ServiceHost serviceHost =   
+           new ServiceHost(typeof(CalculatorService)))  
+    {  
+        // Open the ServiceHost to create listeners   
+        // and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+    }  
+}  
+  
+```  
+  
+ サービスがインターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) にホストされている場合、サービスのベース アドレスはホスト環境から提供されます。自己ホスト型の場合は、ベース アドレスを手動で指定する必要があります。この操作は、`add` 要素、[\<baseAddresses\>](../../../../docs/framework/configure-apps/file-schema/wcf/baseaddresses.md) の子、[\<host\>](../../../../docs/framework/configure-apps/file-schema/wcf/host.md) の子、および [\<service\>](../../../../docs/framework/configure-apps/file-schema/wcf/service.md) の子を使用することによって実行されます。次のサンプル構成を参照してください。  
+  
+```  
+<service   
+    name="Microsoft.ServiceModel.Samples.CalculatorService"  
+    behaviorConfiguration="CalculatorServiceBehavior">  
+  <host>  
+    <baseAddresses>  
+      <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+    </baseAddresses>  
+  </host>  
+  ...  
+</service>  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\SelfHost`  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-auditing-behavior.md b/docs/framework/wcf/samples/service-auditing-behavior.md
new file mode 100644
index 00000000000..bf50bd7c215
--- /dev/null
+++ b/docs/framework/wcf/samples/service-auditing-behavior.md
@@ -0,0 +1,62 @@
+---
+title: "サービス監査動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 59bf0cda-e496-4418-a3a1-2f0f6e85f8ce
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス監査動作
+このサンプルでは、<xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior> を使用して、サービス操作中にセキュリティ イベントの監査を有効にする方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。サービスとクライアントは、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を使用して構成されています。[\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md)の `mode` 属性は `Message` に、`clientCredentialType` は `Windows` に設定されています。この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス構成ファイルは、次のように `serviceSecurityAudit` 要素を使用して監査を構成します。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      ...  
+<!-- serviceSecurityAudit allows specification of audit location   
+     and whether to audit success, failure or both. This service   
+     logs success and failure of messageAuthentication   
+     to the default location -->  
+     <serviceSecurityAudit auditLogLocation ="Default" messageAuthenticationAuditLevel = "SuccessOrFailure" />  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、コンソール ウィンドウで Enter キーを押します。  
+  
+ 結果として得られる監査ログは、イベント ビューアーを実行して表示できます。監査イベントは既定で、Windows XP の場合はアプリケーション ログに、Windows Server 2003 と Windows Vista の場合はセキュリティ ログに表示されます。Windows Server 2008 と Windows 7 では、監査イベントをアプリケーション ログとサービス ログに表示できます。監査イベントの場所は、`auditLogLocation` 属性を "Application" または "Security" に設定することによって指定できます。詳細については、「[方法 : セキュリティ イベントを監査する](../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)」を参照してください。イベントをセキュリティ ログに書き込む場合は、\[ローカル セキュリティ ポリシー\] の \[オブジェクト アクセスの監査\] で、\[成功\] と \[失敗\] のチェック ボックスをオンにする必要があります。  
+  
+ イベント ログを調べる場合、監査イベントのソースは "ServiceModel Audit 3.0.0.0" です。メッセージ認証監査レコードには "MessageAuthentication" のカテゴリ、サービス承認監査レコードには "ServiceAuthorization" のカテゴリが設定されます。  
+  
+ メッセージ認証監査イベントは、メッセージの改ざんや期限切れの有無、クライアントによるサービス認証の成否などに適用されます。このイベントでは、認証の成功または失敗に関する情報とクライアント ID、およびメッセージ送信先のエンドポイントとそのメッセージに関連付けられたアクションに関する情報が提供されます。  
+  
+ サービス承認監査イベントは、サービス承認マネージャーによって決定される承認に適用されます。このイベントでは、承認の成功または失敗に関する情報とクライアント ID、メッセージ送信先のエンドポイント、そのメッセージに関連付けられたアクション、受信メッセージから生成された承認コンテキストの ID、およびアクセス決定を行った承認マネージャーの種類に関する情報が提供されます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [監査](../../../../docs/framework/wcf/feature-details/auditing-security-events.md)   
+ [方法 : セキュリティ イベントを監査する](../../../../docs/framework/wcf/feature-details/how-to-audit-wcf-security-events.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-contracts.md b/docs/framework/wcf/samples/service-contracts.md
new file mode 100644
index 00000000000..509e1edc520
--- /dev/null
+++ b/docs/framework/wcf/samples/service-contracts.md
@@ -0,0 +1,42 @@
+---
+title: "サービス コントラクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e34b694-aa56-45b3-8dd1-2616705b4fc5
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービス コントラクト
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のサービス コントラクトを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [二重](../../../../docs/framework/wcf/samples/duplex.md)  
+ 双方向コントラクトを定義して実装する方法を示します。  
+  
+ [エラー コントラクト](../../../../docs/framework/wcf/samples/fault-contract.md)  
+ エラー情報をサービスからクライアントに通信する方法を示します。  
+  
+ [一方向](../../../../docs/framework/wcf/samples/one-way.md)  
+ 一方向サービス操作へのサービスのアクセスを示します。  
+  
+ [セッション](../../../../docs/framework/wcf/samples/session.md)  
+ セッションを必要とするコントラクトを実装する方法を示します。  
+  
+ [ストリーム](../../../../docs/framework/wcf/samples/stream.md)  
+ ストリーミング転送モードの通信を使用する方法を示します。  
+  
+ [Asynchronous](http://msdn.microsoft.com/ja-jp/833db946-f511-4f64-a26f-2759a11217c7)  
+ クライアントからサービス操作に非同期的にアクセスする方法と、サービスがその操作を非同期的に実装する方法について説明します。  
+  
+ [XmlSerializer エラー](../../../../docs/framework/wcf/samples/xmlserializer-faults.md)  
+ <xref:System.Xml.Serialization.XmlSerializer> を使用して、エラー情報をサービスからクライアントに通信する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-debug-behavior.md b/docs/framework/wcf/samples/service-debug-behavior.md
new file mode 100644
index 00000000000..963564a71fe
--- /dev/null
+++ b/docs/framework/wcf/samples/service-debug-behavior.md
@@ -0,0 +1,71 @@
+---
+title: "サービス デバッグ動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d8fd3fb-dc39-427a-8235-336a7e7162ba
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# サービス デバッグ動作
+このサンプルでは、サービス デバッグ動作の設定を構成する方法を示します。このサンプルは、`ICalculator` サービス コントラクトを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。このサンプルは、サービス デバッグ動作を構成ファイルで明示的に定義します。コードで強制的に定義することもできます。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サーバーの Web.config ファイルでは、次のサンプルに示すように、ヘルプ ページと例外処理を有効にするサービス デバッグ動作を定義します。  
+  
+```  
+  
+<behaviors>  
+     <serviceBehaviors>  
+         <behavior name="CalculatorServiceBehavior">  
+         <!-- WARNING: Setting includeExceptionDetailInFaults = "True" could result in leaking secured server information to the client.-->  
+         <!-- Please set this to false when deploying -->  
+             <serviceDebug includeExceptionDetailInFaults="True" httpHelpPageEnabled="True"/>  
+         </behavior>  
+     </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ [\<serviceDebug\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicedebug.md) は、サービス デバッグ動作のプロパティを変更可能にする構成要素です。ユーザーはこの動作を変更して、次を実現することができます。  
+  
+-   例外が <xref:System.ServiceModel.FaultContractAttribute> を使用して宣言されていない場合でも、サービスでは、アプリケーション コードによってスローされる例外を返すことができます。これを行うには、`includeExceptionDetailInFaults` を `true` に設定します。この設定は、サーバーが予期しない例外をスローしている場合のデバッグ時に役立ちます。  
+  
+    > [!IMPORTANT]
+    >  この設定を本運用環境で有効にすると、セキュリティが不十分になります。サーバーの予期しない例外には、クライアントを対象としていない情報が含まれる場合があるため、`includeExceptionDetailsInFaults` を `true` に設定すると、情報の漏えいが発生する可能性があります。  
+  
+-   また、[\<serviceDebug\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicedebug.md) を使用することにより、ユーザーがヘルプ ページを有効または無効にできます。各サービスは、サービスの WSDL を取得するエンドポイントなど、サービスに関する情報が含まれるヘルプ ページをオプションで公開できます。これを有効にするには、`httpHelpPageEnabled` プロパティを `true` に設定します。これにより、サービスのベース アドレスへの GET 要求に対して、ヘルプ ページを返すことができます。このアドレスは、別の属性 `httpHelpPageUrl` を設定して変更できます。HTTP の代わりに HTTPS を使用すると、このアドレスをセキュリティ保護できます。これを行うには、`httpsHelpPageEnabled` と `httpsHelpPageUrl` を設定します。  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。最初の 3 つの操作 \(加算、減算、乗算\) が正常に行われる必要があります。最後の操作 \(除算\) は、0 による除算の例外によってエラーとなります。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\ServiceDebug`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-description.md b/docs/framework/wcf/samples/service-description.md
new file mode 100644
index 00000000000..cfa7746c99d
--- /dev/null
+++ b/docs/framework/wcf/samples/service-description.md
@@ -0,0 +1,114 @@
+---
+title: "サービスの説明 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7034b5d6-d608-45f3-b57d-ec135f83ff24
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# サービスの説明
+サービスの説明のサンプルでは、サービスが実行時にそのサービスの説明情報を取得する方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいており、サービスに関する説明情報を返す追加サービス操作が定義されています。返される情報には、サービスのベース アドレスとエンドポイントが示されます。サービスは、<xref:System.ServiceModel.OperationContext>、<xref:System.ServiceModel.ServiceHost>、および <xref:System.ServiceModel.Description.ServiceDescription> クラスを使用してこの情報を提供します。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルには、`IServiceDescriptionCalculator` という電卓コントラクトの修正バージョンがあります。このコントラクトでは、`GetServiceDescriptionInfo` という名前の追加サービス操作が定義されています。このサービス操作は、サービスのベース アドレス \(1 つまたは複数\) とサービス エンドポイント \(1 つまたは複数\) を説明する、複数行の文字列をクライアントに返します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IServiceDescriptionCalculator  
+{  
+    [OperationContract]  
+    int Add(int n1, int n2);  
+    [OperationContract]  
+    int Subtract(int n1, int n2);  
+    [OperationContract]  
+    int Multiply(int n1, int n2);  
+    [OperationContract]  
+    int Divide(int n1, int n2);  
+    [OperationContract]  
+    string GetServiceDescriptionInfo();  
+}  
+  
+```  
+  
+ `GetServiceDescriptionInfo` の実装コードには、サービス エンドポイントを示す <xref:System.ServiceModel.Description.ServiceDescription> が使用されています。サービス エンドポイントには相対アドレスを指定できるので、最初にサービスのベース アドレスが示されます。この情報をすべて取得するには、コードで <xref:System.ServiceModel.OperationContext.Current%2A> を使用して操作コンテキストを取得します。その操作コンテキストから、<xref:System.ServiceModel.ServiceHost> とその <xref:System.ServiceModel.Description.ServiceDescription> オブジェクトが取得されます。サービスのベース エンドポイント一覧を示すには、コードにより、サービス ホストの <xref:System.ServiceModel.ServiceHostBase.BaseAddresses%2A> コレクションを反復処理します。サービスのサービス エンドポイント一覧を示すには、コードにより、サービス説明のエンドポイント コレクションを反復処理します。  
+  
+```  
+public string GetServiceDescriptionInfo()  
+{  
+    string info = "";  
+    OperationContext operationContext = OperationContext.Current;  
+    ServiceHost host = (ServiceHost)operationContext.Host;  
+    ServiceDescription desc = host.Description;  
+    // Enumerate the base addresses in the service host.  
+    info += "Base addresses:\n";  
+    foreach (Uri uri in host.BaseAddresses)  
+    {  
+        info += "    " + uri + "\n";  
+    }  
+    // Enumerate the service endpoints in the service description.  
+    info += "Service endpoints:\n";  
+    foreach (ServiceEndpoint endpoint in desc.Endpoints)  
+    {  
+        info += "    Address:  " + endpoint.Address + "\n";  
+        info += "    Binding:  " + endpoint.Binding.Name + "\n";  
+        info += "    Contract: " + endpoint.Contract.Name + "\n";  
+    }  
+     return info;  
+}  
+  
+```  
+  
+ サンプルを実行すると、電卓操作が表示され、次に `GetServiceDescriptionInfo` 操作によって返されたサービス情報が表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(15,3) = 18  
+Subtract(145,76) = 69  
+Multiply(9,81) = 729  
+Divide(22,7) = 3  
+GetServiceDescriptionInfo  
+Base addresses:  
+    http://<machine-name>/ServiceModelSamples/service.svc  
+    https://<machine-name>/ServiceModelSamples/service.svc  
+Service endpoints:  
+    Address:  http://<machine-name>/ServiceModelSamples/service.svc  
+    Binding:  WSHttpBinding  
+    Contract: IServiceDescriptionCalculator  
+    Address:  http://<machine-name>/ServiceModelSamples/service.svc/mex  
+    Binding:  MetadataExchangeHttpBinding  
+    Contract: IMetadataExchange  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\ServiceDescription`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-identity-sample.md b/docs/framework/wcf/samples/service-identity-sample.md
new file mode 100644
index 00000000000..09bb09305d9
--- /dev/null
+++ b/docs/framework/wcf/samples/service-identity-sample.md
@@ -0,0 +1,172 @@
+---
+title: "サービス ID サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79fa8c1c-85bb-4b67-bc67-bfaf721303f8
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# サービス ID サンプル
+このサービス ID サンプルでは、サービスの ID を設定する方法を示します。クライアントは、デザイン時にサービスのメタデータを使用して ID を取得し、実行時にそのサービス ID を認証することができます。サービス ID の概念は、クライアントがサービス操作を呼び出す前にそのサービスを認証できるようにし、それによって認証されていない呼び出しからクライアントを保護することにあります。セキュリティ保護されている接続では、サービスがクライアントの資格情報を認証した後にクライアントのアクセスを許可できますが、このサンプルではこのことを主眼とはしていません。サーバー認証のサンプルについては、「[クライアント](../../../../docs/framework/wcf/samples/client.md)」を参照してください。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは次の機能を示します。  
+  
+-   サービスのさまざまなエンドポイントにある、さまざまな種類の ID を設定する方法。ID の種類によって機能も異なります。使用する ID の種類は、エンドポイントのバインディングで使用するセキュリティ資格情報の種類によって決まります。  
+  
+-   ID は、構成内での宣言によって設定できるほか、コードで強制的に設定することもできます。通常、クライアントとサービスのどちらの場合も、ID の設定には構成を使用します。  
+  
+-   クライアントのカスタム ID を設定する方法。カスタム ID は通常、既存の種類の ID をカスタマイズしたもので、クライアントがサービスの資格情報で提供される他のクレーム情報を調べ、サービスを呼び出す前に承認決定を行うようにします。  
+  
+    > [!NOTE]
+    >  このサンプルでは、identity.com という特定の証明書の ID と、この証明書内に含まれる RSA キーをチェックします。クライアントの構成で、証明書と RSA 型の ID を使用する場合、これらの値を取得する簡単な方法は、これらの値がシリアル化されて表されるサービスの WSDL を検査することです。  
+  
+ 次のサンプル コードでは、WSHttpBinding を使用して、証明書のドメイン ネーム サーバー \(DNS\) によってサービス エンドポイントの ID を構成する方法を示します。  
+  
+```  
+//Create a service endpoint and set its identity to the certificate's DNS                 
+WSHttpBinding wsAnonbinding = new WSHttpBinding (SecurityMode.Message);  
+// Client are Anonymous to the service  
+wsAnonbinding.Security.Message.ClientCredentialType = MessageCredentialType.None;  
+WServiceEndpoint ep = serviceHost.AddServiceEndpoint(typeof(ICalculator),wsAnonbinding, String.Empty);  
+EndpointAddress epa = new EndpointAddress(dnsrelativeAddress,EndpointIdentity.CreateDnsIdentity("identity.com"));  
+ep.Address = epa;  
+  
+```  
+  
+ ID は、App.config ファイルの構成内でも指定できます。サービス エンドポイントの UPN \(ユーザー プリンシパル名\) ID を設定する方法を次の例に示します。  
+  
+```  
+<endpoint address="upnidentity"  
+        behaviorConfiguration=""  
+        binding="wsHttpBinding"  
+        bindingConfiguration="WSHttpBinding_Windows"  
+        name="WSHttpBinding_ICalculator_Windows"  
+        contract="Microsoft.ServiceModel.Samples.ICalculator">  
+  <!-- Set the UPN identity for this endpoint -->  
+  <identity>  
+      <userPrincipalName value="host\myservice.com" />  
+  </identity >  
+</endpoint>  
+  
+```  
+  
+ カスタム ID は、<xref:System.ServiceModel.EndpointIdentity> クラスと <xref:System.ServiceModel.Security.IdentityVerifier> クラスから派生させることによって、クライアント上で設定できます。概念上、<xref:System.ServiceModel.Security.IdentityVerifier> クラスは、サービスの `AuthorizationManager` クラスと同等のクライアントと見なすことができます。`OrgEndpointIdentity` の実装のコード例を次に示します。この実装では、サーバーの証明書のサブジェクト名と一致する組織名が格納されます。この組織名の承認チェックは、`CustomIdentityVerifier` クラスの `CheckAccess` メソッドで発生します。  
+  
+```  
+  
+// This custom EndpointIdentity stores an organization name   
+public class OrgEndpointIdentity : EndpointIdentity  
+{  
+    private string orgClaim;  
+    public OrgEndpointIdentity(string orgName)  
+    {  
+        orgClaim = orgName;  
+    }  
+    public string OrganizationClaim  
+    {  
+        get { return orgClaim; }  
+        set { orgClaim = value; }  
+    }  
+}  
+  
+//This custom IdentityVerifier uses the supplied OrgEndpointIdentity to  
+//check that X.509 certificate's distinguished name claim contains  
+//the organization name e.g. the string value "O=Contoso"   
+class CustomIdentityVerifier : IdentityVerifier  
+{  
+    public override bool CheckAccess(EndpointIdentity identity, AuthorizationContext authContext)  
+    {  
+        bool returnvalue = false;  
+        foreach (ClaimSet claimset in authContext.ClaimSets)  
+        {  
+            foreach (Claim claim in claimset)  
+            {  
+                if (claim.ClaimType == "http://schemas.microsoft.com/ws/2005/05/identity/claims/x500distinguishedname")  
+                {  
+                    X500DistinguishedName name = (X500DistinguishedName)claim.Resource;  
+                    if (name.Name.Contains(((OrgEndpointIdentity)identity).OrganizationClaim))  
+                    {  
+                        Console.WriteLine("Claim Type: {0}",claim.ClaimType);  
+                        Console.WriteLine("Right: {0}", claim.Right);  
+                        Console.WriteLine("Resource: {0}",claim.Resource);  
+                        Console.WriteLine();  
+                        returnvalue = true;  
+                    }  
+                }  
+            }  
+        }  
+        return returnvalue;  
+    }  
+}  
+```  
+  
+ このサンプルでは identity.com という証明書を使用します。この証明書は、言語固有の ID ソリューション フォルダーにあります。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを同じコンピューターで実行するには  
+  
+1.  [!INCLUDE[wxp](../../../../includes/wxp-md.md)] または [!INCLUDE[wv](../../../../includes/wv-md.md)] では、MMC スナップイン ツールを使用して、ID ソリューション フォルダーの Identity.pfx 証明書ファイルを LocalMachine\/My \(Personal\) 証明書ストアにインポートします。このファイルは、パスワードで保護されています。インポート中に、パスワードの入力を求められます。\[password\] ボックスに「`xyz`」と入力します。詳細については、「[方法 : MMC スナップインを使用して証明書を参照する](../../../../docs/framework/wcf/feature-details/how-to-view-certificates-with-the-mmc-snap-in.md)」を参照してください。これが完了したら、管理特権を使用して開いた Visual Studio コマンド プロンプトで Setup.bat を実行します。クライアントで使用する CurrentUser\/Trusted People ストアにこの証明書がコピーされます。  
+  
+2.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] で、管理特権を使用して [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを実行し、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。サンプルの実行後は、Cleanup.bat を実行して証明書を削除してください。他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+3.  Service.exe を \\service\\bin ディレクトリで起動します。サービスの準備が整っていることが示され、サービスを終了するには Enter キーを押すように求めるメッセージが表示されていることを確認します。  
+  
+4.  Client.exe を \\client\\bin ディレクトリで起動するか、または Visual Studio で F5 を押して起動し、ビルドして実行します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+5.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サンプルのクライアント部分をビルドする前に、`CallServiceCustomClientIdentity` メソッドで、Client.cs ファイルのサービスのエンドポイント アドレスの値を変更してください。その後、サンプルをビルドします。  
+  
+2.  サービス コンピューターにディレクトリを作成します。  
+  
+3.  service\\bin のサービス プログラム ファイルを、サービス コンピューターのディレクトリにコピーします。Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+4.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+5.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+6.  サービス上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。複数のインスタンスを変更する必要があります。  
+  
+9. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+10. サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+11. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+    > [!NOTE]
+    >  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-interoperability.md b/docs/framework/wcf/samples/service-interoperability.md
new file mode 100644
index 00000000000..008bff6f57b
--- /dev/null
+++ b/docs/framework/wcf/samples/service-interoperability.md
@@ -0,0 +1,27 @@
+---
+title: "サービス相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3628557f-b8b3-47fc-8fdc-0c7d2e4268bd
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# サービス相互運用性
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] と他のサービス技術間の対話を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [WCF モニカーの COM クライアントと組み合わせての使用](../../../../docs/framework/wcf/samples/using-the-wcf-moniker-with-com-clients.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス モニカーを使用して、COM ベースの開発環境 \(Microsoft Office Visual Basic for Applications \(Office VBA\) や Visual Basic 6.0 など\) に Web サービスを統合する方法を示します。  
+  
+ [WCF サービス付き ASMX クライアント](../../../../docs/framework/wcf/samples/asmx-client-with-a-wcf-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用してサービスを作成し、ASMX クライアントなどの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のクライアントからこのサービスにアクセスする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-security.md b/docs/framework/wcf/samples/service-security.md
new file mode 100644
index 00000000000..79f70367d85
--- /dev/null
+++ b/docs/framework/wcf/samples/service-security.md
@@ -0,0 +1,24 @@
+---
+title: "サービス セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bb8eea87-4c87-437a-b70f-697dd5e1c21e
+caps.latest.revision: 2
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 2
+---
+# サービス セキュリティ
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスのセキュリティを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [サービス ID サンプル](../../../../docs/framework/wcf/samples/service-identity-sample.md)  
+ このサンプルでは、サービスの ID を設定する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/service-transaction-behavior.md b/docs/framework/wcf/samples/service-transaction-behavior.md
new file mode 100644
index 00000000000..3cc2ed23625
--- /dev/null
+++ b/docs/framework/wcf/samples/service-transaction-behavior.md
@@ -0,0 +1,277 @@
+---
+title: "サービス トランザクションの動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス トランザクションの動作サンプル [Windows Communication Foundation]"
+ms.assetid: 1a9842a3-e84d-427c-b6ac-6999cbbc2612
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# サービス トランザクションの動作
+このサンプルでは、クライアント調整トランザクションの使用方法と、サービス トランザクションの動作を制御する ServiceBehaviorAttribute と OperationBehaviorAttribute の設定方法について説明します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。ただし、データベース テーブル内で実行された操作のサーバー ログと計算操作のステートフルな現在高を保持するように拡張されています。サーバー ログ テーブルへの書き込みを保存するかどうかは、クライアント調整トランザクションの結果によって異なります。クライアント トランザクションが完了しない場合は、Web サービス トランザクションにより、データベースへの更新はコミットされません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスのコントラクトでは、すべての操作でトランザクションを要求に応じてフローする必要があることを、次のように定義します。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples",  
+                    SessionMode = SessionMode.Required)]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Mandatory)]  
+    double Add(double n);  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Mandatory)]  
+    double Subtract(double n);  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Mandatory)]  
+    double Multiply(double n);  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Mandatory)]  
+    double Divide(double n);  
+}  
+  
+```  
+  
+ 受信トランザクション フローを有効にするには、transactionFlow 属性が `true` に設定されているシステム指定の wsHttpBinding を使用して、サービスを構成します。このバインディングは、相互操作可能な WSAtomicTransactionOctober2004 プロトコルを使用します。  
+  
+```  
+<bindings>  
+  <wsHttpBinding>  
+    <binding name="transactionalBinding" transactionFlow="true" />  
+  </wsHttpBinding>  
+</bindings>  
+  
+```  
+  
+ サービスへの接続とトランザクションの起動後、クライアントは次のようにそのトランザクションのスコープに含まれるいくつかのサービス処理にアクセスして、そのトランザクションを完了して接続を終了します。  
+  
+```  
+// Create a client  
+CalculatorClient client = new CalculatorClient();  
+  
+// Create a transaction scope with the default isolation level of Serializable  
+using (TransactionScope tx = new TransactionScope())  
+{  
+    Console.WriteLine("Starting transaction");  
+  
+    // Call the Add service operation.  
+    double value = 100.00D;  
+    Console.WriteLine("  Adding {0}, running total={1}",  
+                                        value, client.Add(value));  
+  
+    // Call the Subtract service operation.  
+    value = 45.00D;  
+    Console.WriteLine("  Subtracting {0}, running total={1}",  
+                                        value, client.Subtract(value));  
+  
+    // Call the Multiply service operation.  
+    value = 9.00D;  
+    Console.WriteLine("  Multiplying by {0}, running total={1}",  
+                                        value, client.Multiply(value));  
+  
+    // Call the Divide service operation.  
+    value = 15.00D;  
+    Console.WriteLine("  Dividing by {0}, running total={1}",  
+                                        value, client.Divide(value));  
+  
+    Console.WriteLine("  Completing transaction");  
+    tx.Complete();  
+}  
+  
+Console.WriteLine("Transaction committed");  
+  
+// Closing the client gracefully closes the connection and cleans up resources  
+client.Close();  
+```  
+  
+ サービス側には、次のようにサービス トランザクションの動作に影響を及ぼす 3 つの属性があります。  
+  
+-   `ServiceBehaviorAttribute` :  
+  
+    -   `TransactionTimeout` プロパティは、トランザクションが完了する必要のある期間を指定します。このサンプルでは、30 秒に設定されています。  
+  
+    -   `TransactionIsolationLevel` プロパティは、サービスがサポートする分離レベルを指定します。クライアントの分離レベルと一致する必要があります。  
+  
+    -   `ReleaseServiceInstanceOnTransactionComplete` プロパティは、トランザクションが完了したときにサービス インスタンスを再利用するかどうかを指定します。`false` に設定すると、サービスは操作要求全体で同じサービス インスタンスを保持します。この設定は、現在高を保持するために必要です。`true` に設定すると、各アクションが完了するたびに新しいインスタンスが生成されます。  
+  
+    -   `TransactionAutoCompleteOnSessionClose` プロパティは、セッションの終了時に未解決のトランザクションを完了するかどうかを指定します。`false` に設定すると、個別の操作で `OperationBehaviorAttribute``TransactionAutoComplete` プロパティを `true` に設定するか、または `SetTransactionComplete` メソッドを明示的に呼び出して、トランザクションを完了する必要があります。このサンプルでは、両方の方法を示します。  
+  
+-   `ServiceContractAttribute` :  
+  
+    -   `SessionMode` プロパティは、適切な要求を相互に関連付けて論理セッションに格納するかどうかを指定します。このサービスには、OperationBehaviorAttribute TransactionAutoComplete プロパティが `false` に設定されている操作 \(乗算および除算\) が含まれているため、`SessionMode.Required` を指定する必要があります。たとえば、乗算操作ではトランザクションは完了せず、後で呼び出される除算操作により、`SetTransactionComplete` メソッドを使用して完了します。したがってこのサービスでは、これらの操作が同じセッション内で発生するかどうかを決定できる必要があります。  
+  
+-   `OperationBehaviorAttribute` :  
+  
+    -   `TransactionScopeRequired` プロパティは、操作のアクションをトランザクション スコープ内で実行する必要があるかどうかを指定します。このプロパティは、このサンプルのすべての操作で `true` に設定されています。クライアントはそのトランザクションをすべての操作にフローするため、アクションはクライアント トランザクションのスコープ内で発生します。  
+  
+    -   `TransactionAutoComplete` プロパティは、未処理の例外が発生しなかった場合にメソッドが実行中のトランザクションが自動的に完了するかどうかを指定します。前述のように、このプロパティは加算操作および減算操作では `true` に設定されていますが、乗算操作および除算操作では `false` に設定されています。加算操作と減算操作は、これらのアクションを自動的に完了し、除算操作は、`SetTransactionComplete` メソッドを明示的に呼び出すことによってアクションを完了します。乗算操作はアクションを完了せず、アクションを完了するために除算などを後で呼び出す必要があり、この呼び出しに依存しています。  
+  
+ 属性サービスの実装は、次のとおりです。  
+  
+```  
+[ServiceBehavior(  
+    TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable,  
+    TransactionTimeout = "00:00:30",  
+    ReleaseServiceInstanceOnTransactionComplete = false,  
+    TransactionAutoCompleteOnSessionClose = false)]  
+public class CalculatorService : ICalculator  
+{  
+    double runningTotal;  
+  
+    public CalculatorService()  
+    {  
+        Console.WriteLine("Creating new service instance...");  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public double Add(double n)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Adding {0} to {1}", n, runningTotal));  
+        runningTotal = runningTotal + n;  
+        return runningTotal;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+    public double Subtract(double n)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Subtracting {0} from {1}", n, runningTotal));  
+        runningTotal = runningTotal - n;  
+        return runningTotal;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = false)]  
+    public double Multiply(double n)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Multiplying {0} by {1}", runningTotal, n));  
+        runningTotal = runningTotal * n;  
+        return runningTotal;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = false)]  
+    public double Divide(double n)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Dividing {0} by {1}", runningTotal, n));  
+        runningTotal = runningTotal / n;  
+        OperationContext.Current.SetTransactionComplete();  
+        return runningTotal;  
+    }  
+  
+    // Logging method ommitted for brevity  
+}   
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Starting transaction  
+Performing calculations...  
+  Adding 100, running total=100  
+  Subtracting 45, running total=55  
+  Multiplying by 9, running total=495  
+  Dividing by 15, running total=33  
+  Completing transaction  
+Transaction committed  
+Press <ENTER> to terminate client.  
+```  
+  
+ サービス操作要求のログ記録は、サービスのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Press <ENTER> to terminate service.  
+Creating new service instance...  
+  Writing row 1 to database: Adding 100 to 0  
+  Writing row 2 to database: Subtracting 45 from 100  
+  Writing row 3 to database: Multiplying 55 by 9  
+  Writing row 4 to database: Dividing 495 by 15  
+```  
+  
+ サービスは計算の現在高を保持することに加え、インスタンス \(このサンプルでは 1 つのインスタンス\) の作成を報告し、データベースのログに操作要求を記録します。すべての要求はクライアント トランザクションをフローするため、トランザクションの完了に失敗した場合、すべてのデータベース操作がロールバックされます。これについては、次のようないくつかの方法で示すことができます。  
+  
+-   クライアントの `tx.Complete`\(\) への呼び出しをコメント化して再実行します。これによってクライアントは、トランザクションを完了せずにトランザクション スコープを終了します。  
+  
+-   除算サービス操作への呼び出しをコメント化します。これによって、乗算操作により初期化されたアクションの完了が回避され、したがって、クライアントのトランザクションの完了も最終的に失敗します。  
+  
+-   未処理の例外を、クライアントのトランザクション スコープ内の任意の場所にスローします。これによってクライアントのトランザクションの完了が同様に回避されます。  
+  
+ これらの結果、スコープ内で実行される操作はコミットされず、データベースに保持されている行数はインクリメントしません。  
+  
+> [!NOTE]
+>  ビルド プロセスの一貫として、データベース ファイルが bin フォルダにコピーされます。このデータベース ファイルのコピーを調べ、Visual Studio プロジェクトに格納されているファイルではなく、ログに保存されている行を監視する必要があります。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  SQL Server 2005 Express Edition または SQL Server 2005 がインストールされていることを確認してください。サービスの App.config ファイルでは、データベース接続文字列が `connectionString` に指定されているか、または `false` に設定された appSettings `usingSql` 値によりデータベースとの対話が無効になっています。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+ サンプルを別のコンピュータで実行する場合は、Microsoft 分散トランザクション コーディネータ \(MSDTC\) を構成してネットワーク トランザクション フローを有効にし、WsatConfig.exe ツールを使用して [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] トランザクション ネットワーク サポートを有効にする必要があります。  
+  
+### 分散トランザクション コーディネータ \(MSDTC\) を構成してサンプルを別のコンピュータで実行できるようにするには  
+  
+1.  サービス コンピュータで、受信ネットワーク トランザクションを許可するよう MSDTC を構成します。  
+  
+    1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]**、**\[管理ツール\]** の順にポイントして **\[コンポーネント サービス\]** をクリックします。  
+  
+    2.  **\[マイ コンピューター\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    3.  **\[MSDTC\]** タブの **\[セキュリティの構成\]** をクリックします。  
+  
+    4.  **\[ネットワーク DTC アクセス\]** および **\[受信を許可する\]** チェック ボックスをオンにします。  
+  
+    5.  **\[はい\]** をクリックして MS DTC サービスを再起動し、**\[OK\]** をクリックします。  
+  
+    6.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+2.  サービス コンピュータおよびクライアント コンピュータで、Windows ファイアウォールを構成し、想定されるアプリケーションのリストに Microsoft 分散トランザクション コーディネータ \(MSDTC\) を追加します。  
+  
+    1.  Windows ファイアウォール アプリケーションをコントロール パネルから実行します。  
+  
+    2.  **\[例外\]** タブの **\[プログラムの追加\]** をクリックします。  
+  
+    3.  フォルダ C:\\WINDOWS\\System32 に移動します。  
+  
+    4.  Msdtc.exe を選択して、**\[開く\]** をクリックします。  
+  
+    5.  **\[OK\]** をクリックして **\[プログラムの追加\]** ダイアログ ボックスを閉じ、**\[OK\]** をもう一度クリックして Windows ファイアウォール アプレットを閉じます。  
+  
+3.  クライアント コンピュータで、送信ネットワーク トランザクションを許可するよう MSDTC を構成します。  
+  
+    1.  **\[スタート\]** メニューから、**\[コントロール パネル\]**、**\[管理ツール\]**、**\[コンポーネント サービス\]** の順に選択します。  
+  
+    2.  **\[マイ コンピューター\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    3.  **\[MSDTC\]** タブの **\[セキュリティの構成\]** をクリックします。  
+  
+    4.  **\[ネットワーク DTC アクセス\]** および **\[送信を許可する\]** チェック ボックスをオンにします。  
+  
+    5.  **\[はい\]** をクリックして MS DTC サービスを再起動し、**\[OK\]** をクリックします。  
+  
+    6.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Transactions`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/services.md b/docs/framework/wcf/samples/services.md
new file mode 100644
index 00000000000..22062c65228
--- /dev/null
+++ b/docs/framework/wcf/samples/services.md
@@ -0,0 +1,72 @@
+---
+title: "サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 462a2218-f8c6-4fb7-95bc-64765459c429
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# サービス
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ホスト](../../../../docs/framework/wcf/feature-details/hosting.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスをホストする方法を示します。  
+  
+ [サービス相互運用性](../../../../docs/framework/wcf/samples/service-interoperability.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] と他のサービス技術間の対話を示します。  
+  
+ [動作](../../../../docs/framework/wcf/samples/behaviors.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの動作を示します。  
+  
+ [サービス セキュリティ](../../../../docs/framework/wcf/samples/service-security.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス セキュリティを示します。  
+  
+ [WCF サービスの簡略化された構成](../../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、一般的なサービスおよびクライアントを実装して構成する方法を示します。  
+  
+ [標準エンドポイントの使用](../../../../docs/framework/wcf/samples/usage-of-standard-endpoints.md)  
+ サービスの構成ファイルでの標準エンドポイントの使用方法を示します。  
+  
+ [階層的な構成モデル](../../../../docs/framework/wcf/samples/hierarchical-configuration-model.md)  
+ サービスの構成ファイルの階層を実装する方法を示します。  
+  
+ [拡張保護ポリシー](../../../../docs/framework/wcf/samples/extended-protection-policy.md)  
+ man\-in\-the\-middle \(MITM\) 攻撃に対するセキュリティ イニシアチブである、拡張保護を示します。  
+  
+ [構成チャネル ファクトリ](../../../../docs/framework/wcf/samples/configuration-channel-factory.md)  
+ <xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> の使用方法を示します。  
+  
+ [アドレス指定](../../../../docs/framework/wcf/samples/addressing.md)  
+ エンドポイント アドレスのさまざまな特性と機能を示します。  
+  
+ [強制](../../../../docs/framework/wcf/samples/imperative.md)  
+ コードを使用するサービスについて、構成で `wsHttpBinding` バインディングを定義する代わりに <xref:System.ServiceModel.WsHttpBinding> を定義する方法を示します。  
+  
+ [複数のコントラクト](../../../../docs/framework/wcf/samples/multiple-contracts.md)  
+ 複数のコントラクトを 1 つのサービスに実装する方法と、実装された各コントラクトと通信を行うためにエンドポイントを構成する方法を示します。  
+  
+ [複数のエンドポイント](../../../../docs/framework/wcf/samples/multiple-endpoints.md)  
+ 複数のエンドポイントを 1 つのサービスに構成する方法と、クライアントから各エンドポイントと通信を行う方法を示します。  
+  
+ [単一 ListenUri に対する複数のエンドポイント](../../../../docs/framework/wcf/samples/multiple-endpoints-at-a-single-listenuri.md)  
+ 単一 `ListenUri` で複数のエンドポイントをホストするサービスを示します。  
+  
+ [OperationContextScope](../../../../docs/framework/wcf/samples/operationcontextscope.md)  
+ ヘッダーを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 呼び出しに関する追加情報を送信する方法を示します。  
+  
+ [サービスの説明](../../../../docs/framework/wcf/samples/service-description.md)  
+ サービスが実行時にそのサービスの説明情報を取得する方法を示します。  
+  
+ [ConcurrencyMode.Reentrant](../../../../docs/framework/wcf/samples/concurrencymode-reentrant.md)  
+ サービス実装で Reentrant 同時実行モードを使用する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/session.md b/docs/framework/wcf/samples/session.md
new file mode 100644
index 00000000000..137a0edf9e6
--- /dev/null
+++ b/docs/framework/wcf/samples/session.md
@@ -0,0 +1,107 @@
+---
+title: "セッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "セッション"
+ms.assetid: 36e1db50-008c-4b32-8d09-b56e790b8417
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# セッション
+このセッションのサンプルでは、セッションを必要とするコントラクトを実装する方法を示します。セッションは、複数の操作を実行するためのコンテキストを提供します。これにより、サービスは特定のセッションに状態を関連付けることができ、後続の操作はその前の操作の状態を使用できます。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。`ICalculator` コントラクトは、一連の算術演算を実行して実行結果を保持できるように変更されました。この機能は `ICalculatorSession` コントラクトによって定義されます。サービスは、複数のサービス操作が呼び出されて計算を実行する際に、クライアントの状態を保持します。クライアントは `Result()` を呼び出して現在の結果を取得したり、`Clear()` を呼び出してその結果をクリアし、0 にすることができます。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ コントラクトの <xref:System.ServiceModel.SessionMode> を `Required` に設定すると、コントラクトが特定のバインディングを介して公開される場合に、そのバインディングはセッションをサポートします。バインディングがセッションをサポートしない場合は、例外がスローされます。`ICalculatorSession` インターフェイスは、1 つまたは複数の操作が呼び出されるように定義されており、これによって実行結果が変更されます。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required)]  
+public interface ICalculatorSession  
+{  
+    [OperationContract(IsOneWay=true)]  
+    void Clear();  
+    [OperationContract(IsOneWay = true)]  
+    void AddTo(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void SubtractFrom(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void MultiplyBy(double n);  
+    [OperationContract(IsOneWay = true)]  
+    void DivideBy(double n);  
+    [OperationContract]  
+    double Result();  
+}  
+  
+```  
+  
+ サービスは、<xref:System.ServiceModel.InstanceContextMode> の <xref:System.ServiceModel.InstanceContextMode> を使用して、指定されたサービス インスタンスのコンテキストを各入力セッションにバインドします。これにより、サービスは、ローカルのメンバ変数内に各セッションの実行結果を保持できます。  
+  
+```  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+public class CalculatorService : ICalculatorSession  
+{  
+    double result = 0.0D;  
+  
+    public void Clear()  
+    {  result = 0.0D; }  
+  
+    public void AddTo(double n)  
+    {  result += n;   }  
+  
+    public void SubtractFrom(double n)  
+    {  result -= n;   }  
+  
+    public void MultiplyBy(double n)  
+    {  result *= n;   }  
+  
+    public void DivideBy(double n)  
+    {  result /= n;   }  
+  
+    public double Result()  
+    {  return result; }  
+}  
+  
+```  
+  
+ このサンプルを実行すると、クライアントはサーバーに対していくつかの要求を行い、その後、その要求がクライアント コンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+(((0 + 100) - 50) * 17.65) / 2 = 441.25  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Session`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/sessions-and-queues.md b/docs/framework/wcf/samples/sessions-and-queues.md
new file mode 100644
index 00000000000..c74ae1e7ff7
--- /dev/null
+++ b/docs/framework/wcf/samples/sessions-and-queues.md
@@ -0,0 +1,282 @@
+---
+title: "セッションとキュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 47d7c5c2-1e6f-4619-8003-a0ff67dcfbd6
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# セッションとキュー
+このサンプルでは、メッセージ キュー \(MSMQ\) トランスポートを介して、キュー通信で一連の関連メッセージを送受信する方法を示します。このサンプルでは、`netMsmqBinding` バインディングを使用します。サービスは、自己ホスト型コンソール アプリケーションで、サービスがキュー内のメッセージを受信したかどうかを監視できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\Session`  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。厳密には、クライアントはメッセージをキューに送信します。サービスは、メッセージをキューから受信します。このため、キューを使用する通信では、サービスとクライアントは同時に実行されていなくてもかまいません。  
+  
+ クライアントは、グループ内で相互に関連する一連のメッセージを送信する場合があります。メッセージを一緒に処理するか、または特定の順序で処理する必要がある場合は、キューを使用すると、単一の受信側アプリケーションでの処理に対応するためにメッセージをグループ化できます。このことは、サーバーのグループに複数の受信側アプリケーションが存在する場合、メッセージのグループを同一の受信側アプリケーションで確実に処理する必要があるときに特に重要です。キューに置かれたセッションは、同時処理を行う必要がある一連の関連メッセージを送受信する目的で使用される機構です。キューに置かれたセッションには、このパターンを表すトランザクションが必要です。  
+  
+ このサンプルでは、クライアントは、複数のメッセージを単一トランザクションのスコープ内にあるセッションの一部として、サービスに送信します。  
+  
+ サービス コントラクトは `IOrderTaker` です。これは、キューでの使用に適した一方向サービスを定義します。このコントラクトに使用される <xref:System.ServiceModel.SessionMode> は、次のサンプル コードで示すように、メッセージがセッションの一部であることを示します。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required)]  
+public interface IOrderTaker  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void OpenPurchaseOrder(string customerId);  
+  
+    [OperationContract(IsOneWay = true)]  
+    void AddProductLineItem(string productId, int quantity);  
+  
+    [OperationContract(IsOneWay = true)]  
+    void EndPurchaseOrder();  
+}  
+  
+```  
+  
+ このサービスは、最初の操作をトランザクションに参加させ、トランザクションを自動的に完了しないように、サービス操作を定義します。後続の操作も同じトランザクションに参加しますが、同様に自動的に完了しません。セッションの最後の操作は、トランザクションを自動的に完了します。つまりサービス コントラクトでは、複数の操作呼び出しで同じトランザクションが使用されます。任意の操作で例外がスローされた場合は、トランザクションはロールバックされてセッションはキューに戻ります。最後の操作が正常に完了すると、トランザクションはコミットされます。このサービスでは <xref:System.ServiceModel.InstanceContextMode> として `PerSession` を使用します。セッション内のすべてのメッセージをサービスの同じインスタンスで受信するためです。  
+  
+```  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]  
+public class OrderTakerService : IOrderTaker  
+{  
+    PurchaseOrder po;  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                                 TransactionAutoComplete = false)]  
+    public void OpenPurchaseOrder(string customerId)  
+    {  
+        Console.WriteLine("Creating purchase order");  
+        po = new PurchaseOrder(customerId);  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                                  TransactionAutoComplete = false)]  
+    public void AddProductLineItem(string productId, int quantity)  
+    {  
+        po.AddProductLineItem(productId, quantity);  
+        Console.WriteLine("Product " + productId + " quantity " +   
+                            quantity + " added to purchase order");  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                                  TransactionAutoComplete = true)]  
+    public void EndPurchaseOrder()  
+    {  
+       Console.WriteLine("Purchase Order Completed");  
+       Console.WriteLine();  
+       Console.WriteLine(po.ToString());  
+    }  
+}  
+```  
+  
+ サービスは自己ホスト型です。MSMQ トランスポートを使用する場合、使用するキューをあらかじめ作成しておく必要があります。手動で作成することもコードで作成することもできます。このサンプルでは、キューの存在を確認して、必要な場合は作成するための <xref:System.Messaging> コードがサービスに含まれています。キュー名は、<xref:System.Configuration.ConfigurationManager.AppSettings%2A> クラスを使用して構成ファイルから読み込まれます。  
+  
+```  
+// Host the service within this EXE console application.  
+public static void Main()  
+{  
+    // Get MSMQ queue name from app settings in configuration.  
+    string queueName = ConfigurationManager.AppSettings["queueName"];  
+  
+    // Create the transacted MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName, true);  
+  
+    // Create a ServiceHost for the OrderTakerService type.  
+    using (ServiceHost serviceHost = new ServiceHost(typeof(OrderTakerService)))  
+    {  
+        // Open the ServiceHost to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+  
+        // Close the ServiceHost to shutdown the service.  
+        serviceHost.Close();   
+    }  
+}  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションで指定されます。サービスのエンドポイントは、構成ファイルの system.serviceModel セクションで定義されます。このエンドポイントは `netMsmqBinding` バインディングを指定します。  
+  
+```  
+<appSettings>  
+  <!-- Use appSetting to configure MSMQ queue name. -->  
+  <add key="queueName" value=".\private$\ServiceModelSamplesSession" />  
+</appSettings>  
+  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.OrderTakerService"  
+        behaviorConfiguration="CalculatorServiceBehavior">  
+      ...  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint address="net.msmq://localhost/private/ServiceModelSamplesSession"  
+                binding="netMsmqBinding"  
+                contract="Microsoft.ServiceModel.Samples.IOrderTaker" />  
+      ...  
+    </service>  
+  </services>  
+  ...  
+<system.serviceModel>  
+  
+```  
+  
+ クライアントはトランザクション スコープを作成します。セッション内のすべてのメッセージは、トランザクション スコープ内のキューに送信され、すべてのメッセージが成功か失敗かを示すアトミックな単位として扱われます。トランザクションは <xref:System.Transactions.TransactionScope.Complete%2A> を呼び出してコミットされます。  
+  
+```  
+//Create a transaction scope.  
+using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+{  
+    // Create a client with given client endpoint configuration.  
+    OrderTakerClient client = new OrderTakerClient("OrderTakerEndpoint");  
+    // Open a purchase order.  
+    client.OpenPurchaseOrder("somecustomer.com");  
+    Console.WriteLine("Purchase Order created");  
+  
+    // Add product line items.  
+    Console.WriteLine("Adding 10 quantities of blue widget");  
+    client.AddProductLineItem("Blue Widget", 10);  
+  
+    Console.WriteLine("Adding 23 quantities of red widget");  
+    client.AddProductLineItem("Red Widget", 23);  
+  
+    // Close the purchase order.  
+    Console.WriteLine("Closing the purchase order");  
+    client.EndPurchaseOrder();  
+  
+    //Closing the client gracefully closes the connection and cleans up resources.  
+    client.Close();                  
+  
+    // Complete the transaction.  
+    scope.Complete();  
+}  
+  
+```  
+  
+> [!NOTE]
+>  セッション内のすべてのメッセージに対して使用できるトランザクションは 1 つだけです。さらに、トランザクションをコミットする前にセッション内のすべてのメッセージを送信する必要があります。クライアントを閉じると、セッションも閉じられます。したがって、トランザクションが完了する前にクライアントを閉じ、セッション内のすべてのメッセージをキューに送信する必要があります。  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信するようすがわかります。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  
+  
+ クライアント側  
+  
+```  
+Purchase Order created  
+Adding 10 quantities of blue widget  
+Adding 23 quantities of red widget  
+Closing the purchase order  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+ サービス側  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Creating purchase order  
+Product Blue Widget quantity 10 added to purchase order  
+Product Red Widget quantity 23 added to purchase order  
+Purchase Order Completed  
+  
+Purchase Order: 7c86fef0-2306-4c51-80e6-bcabcc1a6e5e  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 10 of Blue Widget @unit price: $2985  
+                Order LineItem: 23 of Red Widget @unit price: $156  
+        Total cost of this order: $33438  
+        Order status: Pending  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版、C\+\+ 版、または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+ <xref:System.ServiceModel.NetMsmqBinding> を使用する場合の既定では、トランスポート セキュリティが有効です。MSMQ トランスポート セキュリティには、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> および <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> という名前の 2 つの関連プロパティがあります。既定では、認証モードは `Windows` に設定され、保護レベルは `Sign` に設定されます。MSMQ の認証機能と署名機能を利用するには、ドメインに MSMQ があることと、MSMQ に関する Active Directory の統合オプションがインストールされていることが必要です。この条件を満たしていないコンピュータでこのサンプルを実行すると、エラーが発生します。  
+  
+### ワークグループに属しているコンピュータまたは Active Directory 統合のないコンピュータでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピューター、または Active Directory 統合がインストールされていないコンピューターを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを `None` にします。この構成の例を次に示します。  
+  
+    ```  
+    <system.serviceModel>  
+      <services>  
+        <service name="Microsoft.ServiceModel.Samples.OrderTakerService"  
+                 behaviorConfiguration="OrderTakerServiceBehavior">  
+          <host>  
+            <baseAddresses>  
+              <add baseAddress=  
+             "http://localhost:8000/ServiceModelSamples/service"/>  
+            </baseAddresses>  
+          </host>  
+          <!-- Define NetMsmqEndpoint -->  
+          <endpoint  
+              address=  
+            "net.msmq://localhost/private/ServiceModelSamplesSession"  
+              binding="netMsmqBinding"  
+              bindingConfiguration="Binding1"  
+           contract="Microsoft.ServiceModel.Samples.IOrderTaker" />  
+          <!-- The mex endpoint is exposed at-->      
+          <!--http://localhost:8000/ServiceModelSamples/service/mex. -->  
+          <endpoint address="mex"  
+                    binding="mexHttpBinding"  
+                    contract="IMetadataExchange" />  
+        </service>  
+      </services>  
+  
+      <bindings>  
+        <netMsmqBinding>  
+          <binding name="Binding1">  
+            <security mode="None" />  
+          </binding>  
+        </netMsmqBinding>  
+      </bindings>  
+  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="OrderTakerServiceBehavior">  
+              <serviceMetadata httpGetEnabled="True"/>  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+  
+      </system.serviceModel>  
+    ```  
+  
+2.  サンプルを実行する前に、サーバーとクライアントの両方の構成を変更してください。  
+  
+    > [!NOTE]
+    >  セキュリティ モードを `None` に設定することは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A>、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A>、および `Message` のセキュリティを `None` に設定することと同じです。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/set-up-instructions.md b/docs/framework/wcf/samples/set-up-instructions.md
new file mode 100644
index 00000000000..92d8c9e8dc6
--- /dev/null
+++ b/docs/framework/wcf/samples/set-up-instructions.md
@@ -0,0 +1,54 @@
+---
+title: "セットアップ手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF サンプル [WCF], セットアップ"
+  - "Windows Communication Foundation サンプル [WCF], セットアップ"
+ms.assetid: 0be7d232-485b-4f6d-9ed0-b4243c907376
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# セットアップ手順
+このトピックでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスの実行に必要なサービスをセットアップする方法について説明します。  
+  
+## このセクションの内容  
+ [Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルのセットアップ手順について説明します。  
+  
+ [ファイアウォール手順](../../../../docs/framework/wcf/samples/firewall-instructions.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを機能させる Windows ファイアウォールをセットアップするために必要な手順について説明します。  
+  
+ [インターネット インフォメーション サービスのホスティング手順](../../../../docs/framework/wcf/samples/internet-information-service-hosting-instructions.md)  
+ IIS のセットアップに必要な手順について説明します。  
+  
+ [インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)  
+ IIS のサーバー証明書のインストール処理について説明します。  
+  
+ [仮想ディレクトリのセットアップ手順](../../../../docs/framework/wcf/samples/virtual-directory-setup-instructions.md)  
+ 仮想ディレクトリの作成に必要な手順について説明します。  
+  
+ [Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルをビルドする手順について説明します。  
+  
+ [Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルを同じコンピュータで実行する手順、および複数のコンピュータで実行する手順について説明します。  
+  
+ [ピア ツー ピア サービスの有効化](../Topic/Enabling%20Peer%20to%20Peer%20Services.md)  
+ ピアツーピアのメッセージ サービス用の組み込みリゾルバである Windows ピアツーピア コンポーネントのインストール手順について説明します。  
+  
+ [メッセージ キュー \(MSMQ\) のインストール](../../../../docs/framework/wcf/samples/installing-message-queuing-msmq.md)  
+ メッセージ キューのインストール手順について説明します。  
+  
+## 関連項目  
+ [Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/setting-the-use-and-style-properties.md b/docs/framework/wcf/samples/setting-the-use-and-style-properties.md
new file mode 100644
index 00000000000..4f3866fc9f3
--- /dev/null
+++ b/docs/framework/wcf/samples/setting-the-use-and-style-properties.md
@@ -0,0 +1,104 @@
+---
+title: "Use および Style プロパティの設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c09a0600-116f-41cf-900a-1b7e4ea4e300
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# Use および Style プロパティの設定
+このサンプルでは、<xref:System.ServiceModel.XmlSerializerFormatAttribute> と <xref:System.ServiceModel.DataContractFormatAttribute> で Use および Style プロパティを使用する方法を示します。  これらのプロパティは、メッセージの書式設定の方法を制御します。  既定では、メッセージの本文は、<xref:System.ServiceModel.OperationFormatStyle> に設定されたスタイルを使用して書式設定されます。  こうした設定は、サービス コントラクト レベルと操作コントラクト レベルのどちらのレベルでも指定できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ <xref:System.ServiceModel.DataContractFormatAttribute.Style%2A> スタイル プロパティは、サービスの WSDL メタデータの書式設定を決定します。  使用可能な値は <xref:System.ServiceModel.OperationFormatStyle> と <xref:System.ServiceModel.OperationFormatStyle> です。  RPC は、操作で交換されるメッセージの WSDL 表現がリモート プロシージャ コールである場合と同様のパラメータを含むことを意味します。  次に例を示します。  
+  
+```  
+<wsdl:message name="IUseAndStyleCalculator_Add_InputMessage">  
+    <wsdl:part name="n1" type="xsd:double"/>  
+    <wsdl:part name="n2" type="xsd:double"/>  
+</wsdl:message>  
+```  
+  
+ スタイルに対する <xref:System.ServiceModel.OperationFormatStyle> への設定は、WSDL 表現には操作で交換されるドキュメントを表す単一の要素が含まれることを意味します。この例を次に示します。  
+  
+```  
+<wsdl:message name="IUseAndStyleCalculator_Add_InputMessage">  
+    <wsdl:part name="parameters" element="tns:Add"/>  
+</wsdl:message>  
+```  
+  
+ <xref:System.ServiceModel.XmlSerializerFormatAttribute.Use%2A> プロパティは、メッセージの書式を決定します。  使用可能な値は <xref:System.ServiceModel.OperationFormatUse> と <xref:System.ServiceModel.OperationFormatUse> で、既定値は <xref:System.ServiceModel.OperationFormatUse> です。  Literal は、メッセージが WSDL 内のスキーマのリテラル インスタンスであることを意味します。Document\/Literal の例を次に示します。  
+  
+```  
+<Add xmlns="http://Microsoft.ServiceModel.Samples">  
+    <n1>100</n1>  
+    <n2>15.99</n2>  
+</Add>  
+```  
+  
+ Encoded は、WSDL 内のスキーマが、SOAP 1.1 のセクション 5 に規定されているルールに従ってエンコードされる抽象仕様であることを意味します。  RPC\/Encoded の例を次に示します。  
+  
+```  
+<q1:Add xmlns:q1="http://Microsoft.ServiceModel.Samples">  
+    <n1 xsi:type="xsd:double" xmlns="">100</n1>  
+    <n2 xsi:type="xsd:double" xmlns="">15.99</n2>  
+</q1:Add>  
+```  
+  
+ WS\-I Basic Profile 1.0 では <xref:System.ServiceModel.OperationFormatUse> の使用が禁止されています。したがって、これを使用するのは従来のサービスで必要な場合に限ります。  `Encoded` メッセージ形式は、XmlSerializer を使用する場合にのみ利用可能です。  
+  
+ 送受信されたメッセージを表示できるようにするため、このサンプルは「[トレースとメッセージ ログ](../../../../docs/framework/wcf/samples/tracing-and-message-logging.md)」に基づいています。  サービス構成とソース コードは、トレースとメッセージ ログを有効化して利用できるように変更されています。  さらに、<xref:System.ServiceModel.WsHttpBinding> はセキュリティを無効にして構成されているので、ログに記録されたメッセージは暗号化されていない状態で表示できます。  結果のトレース ログ \(System.ServiceModel.e2e および Message.log\) は、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)を使用して表示されます。  トレースは、C:\\LOGS フォルダに作成されるように構成されています。  サンプルを実行する前に、このフォルダを作成します。  トレース ビューア ツールでメッセージの内容を表示するには、ツールの左右両方のウィンドウで **\[Messages\]** を選択します。  
+  
+ 次のコードでは、サービス コントラクトの <xref:System.ServiceModel.XmlSerializerFormatAttribute.Use%2A> プロパティが <xref:System.ServiceModel.OperationFormatUse> に設定され、メッセージ本文の形式が既定の <xref:System.ServiceModel.OperationFormatStyle> から <xref:System.ServiceModel.OperationFormatStyle> に変更されています。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"),  
+XmlSerializerFormat(Style = OperationFormatStyle.Rpc,   
+                                 Use = OperationFormatUse.Encoded)]  
+public interface IUseAndStyleCalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+ それぞれの <xref:System.ServiceModel.XmlSerializerFormatAttribute.Use%2A> 設定と <xref:System.ServiceModel.XmlSerializerFormatAttribute.Style%2A> 設定との違いを示すには、これらの設定をサービス内で変更してクライアントを再生成し、サンプルを実行します。その後、サービス ビューア ツールを使用して c:\\logs\\message.logs ファイルを調べます。  また、メタデータへの影響を確認するには、http:\/\/localhost\/ServiceModelSamples\/service.svc?wsdl を表示します。  通常、サービスのメタデータは複数のページに分割されます。  メインの WSDL ページには WSDL バインディングが含まれていますが、メッセージの定義を確認するには http:\/\/localhost\/ServiceModelSamples\/service.svc?wsdl\=wsdl0 を表示します。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  メッセージのログ記録用に C:\\LOGS ディレクトリを作成します。  ユーザー Network Service にそのディレクトリの書き込み権限を与えます。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Message\UseAndStyle`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md b/docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md
new file mode 100644
index 00000000000..7bdf9360e4e
--- /dev/null
+++ b/docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md
@@ -0,0 +1,92 @@
+---
+title: "WCF サービスの簡略化された構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e39ec25-18a3-4fdc-b6a3-9dfafbd60112
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# WCF サービスの簡略化された構成
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して、一般的なサービスおよびクライアントを実装して構成する方法を示します。このサンプルは、他のすべての基本的な技術サンプルの基礎になります。  
+  
+ このサービスは、サービスとの通信に使用する単一エンドポイントを公開しており、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] の簡略化された構成を使用しています。[!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] 以前は、次の構成コード例に示すように、エンドポイントは通常、構成ファイル \(Web.config\) で定義されています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright ©) Microsoft Corporation.  All Rights Reserved. -->  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata httpGetEnabled="True"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <services>  
+      <service name="Microsoft.Samples.GettingStarted.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <endpoint address="" binding="basicHttpBinding" contract="ICalculator"/>  
+        <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"/>  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] では、`<service>` 要素は省略可能です。サービスでエンドポイントが定義されていない場合、各ベース アドレスのエンドポイントと実装されたコントラクトがサービスに追加されます。このベース アドレスがコントラクト名に追加されてエンドポイントが決定され、バインドがアドレス スキームで決定されます。次のコード例は、簡略化された構成ファイルを示しています。前の構成では、サービスと同じコンピューター上にあるクライアントは、http:\/\/localhost\/servicemodelsamples\/service.svc でサービスにアクセスできます。リモート コンピューター上のクライアントがサービスにアクセスするには、localhost の代わりに完全修飾ドメイン名を指定する必要があります。既定では、サービスはメタデータを公開しません。そのため、サービスは <xref:System.ServiceModel.Description.ServiceMetadataBehavior> 動作を有効にします。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<!-- Copyright © Microsoft Corporation.  All Rights Reserved. -->  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="">  
+          <serviceMetadata httpGetEnabled="True"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### このサンプルを使用するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  次の手順に従ってサンプルを実行します。  
+  
+    1.  **Service** プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** をクリックし、**Ctrl** キーを押しながら F5 キーを押します。  
+  
+    2.  コンソール出力でサービスが動作していることが確認されるまで待機します。  
+  
+    3.  **Client** プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** をクリックし、**Ctrl** キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\ConfigSimplificationIn40`  
+  
+## 参照  
+ [AppFabric の管理のサンプル](http://go.microsoft.com/fwlink/?LinkId=193960)   
+ [簡略化された構成](../../../../docs/framework/wcf/simplified-configuration.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/soap-and-http-endpoints.md b/docs/framework/wcf/samples/soap-and-http-endpoints.md
new file mode 100644
index 00000000000..4cbbd41bbd7
--- /dev/null
+++ b/docs/framework/wcf/samples/soap-and-http-endpoints.md
@@ -0,0 +1,73 @@
+---
+title: "SOAP エンドポイントおよび HTTP エンドポイント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e3c8be75-9dda-4afa-89b6-a82cb3b73cf8
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# SOAP エンドポイントおよび HTTP エンドポイント
+このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web プログラミング モデルを使用して、RPC ベースのサービスを実装し、SOAP 形式 および "Plain Old XML" \(POX\) 形式でサービスを公開する方法を示します。  サービスの HTTP バインディングの詳細については、「[基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)」のサンプルを参照してください。  このサンプルでは、さまざまなバインドを使用して SOAP および HTTP で RPC ベースのサービスを公開する方法について詳しく示します。  
+  
+## 使用例  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用した SOAP および HTTP での RPC サービスの公開。  
+  
+## 説明  
+ このサンプルは、2 つのコンポーネントで構成されています。1 つは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを含む Web アプリケーション プロジェクト \(Service\) で、もう 1 つは SOAP バインドと HTTP バインドを使用してサービス操作を呼び出すコンソール アプリケーション \(Client\) です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、入力として渡された文字列をエコーする、`GetData` と `PutData` の 2 つの操作を公開します。  サービス操作には、<xref:System.ServiceModel.Web.WebGetAttribute> および <xref:System.ServiceModel.Web.WebInvokeAttribute> を使用して注釈が付けられます。  これらの属性は、これらの操作の HTTP 投影を制御します。  また、サービス操作には、<xref:System.ServiceModel.OperationContractAttribute> を使用して注釈が付けられます。この属性では、サービス操作を SOAP バインディングで公開できます。  サービスの `PutData` メソッドは <xref:System.ServiceModel.Web.WebFaultException> をスローします。この例外は、HTTP では HTTP ステータス コードを使用して返送され、SOAP では SOAP エラーとして返送されます。  
+  
+ Web.config ファイルは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスを次の 3 つのエンドポイントで設定します。  
+  
+-   SOAP ベースのクライアントからアクセスするためのサービス メタデータを公開する ~\/service.svc\/mex エンドポイント  
+  
+-   クライアントが HTTP バインディングを使用してサービスにアクセスできる ~\/service.svc\/http エンドポイント  
+  
+-   クライアントが HTTP バインディングで SOAP を使用してサービスにアクセスできる ~\/service.svc\/soap endpoint エンドポイント  
+  
+ HTTP エンドポイントは、`helpEnabled` が `true` に設定されている \<`webHttp`\> 標準エンドポイントで設定されます。  その結果、サービスは、HTTP ベースのクライアントがサービスにアクセスするために使用できる、XHTML ベースのヘルプ ページ \(~\/service.svc\/http\/help\) を公開します。  
+  
+ クライアント プロジェクトは、\(**\[サービス参照の追加\]** で生成された\) SOAP プロキシを使用したサービスのアクセスと、<xref:System.Net.WebClient> を使用したサービスのアクセスを示します。  
+  
+ サンプルは、1 つの Web ホスト サービスと 1 つのコンソール アプリケーションで構成されています。  コンソール アプリケーションが実行されると、クライアントはサービスに要求を発行し、応答からの適切な情報をコンソール ウィンドウに書き込みます。  
+  
+#### サンプルを実行するには  
+  
+1.  SOAP および HTTP エンドポイント サンプルのソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  まだ開いていない場合は、Ctrl キーを押しながら W キーと S キーを押して、**ソリューション エクスプローラー** ウィンドウを開きます。  
+  
+4.  **ソリューション エクスプローラー** ウィンドウで **Service** プロジェクトを右クリックして **\[デバッグ\]** コンテキスト メニュー オプションの上にカーソルを置き、**\[新しいインスタンスを開始\]** コンテキスト メニューを表示します。  **\[新しいインスタンスを開始\]** をクリックします。  これで、サービスをホストする ASP.NET 開発サーバーが起動します。  
+  
+5.  ソリューション エクスプローラー ウィンドウで Client プロジェクトを右クリックして **\[デバッグ\]** コンテキスト メニュー オプションの上にカーソルを置き、**\[新しいインスタンスを開始\]** コンテキスト メニューを表示します。  **\[新しいインスタンスを開始\]** をクリックします。  
+  
+6.  クライアント コンソール ウィンドウが表示されて、実行中のサービスの URI および実行中のサービスの HTML ヘルプ ページの URI が示されます。  ブラウザーでヘルプ ページの URI を入力することで、いつでも HTML ヘルプ ページを表示することができます。  
+  
+7.  サンプルが実行されると、クライアントは現在のアクティビティのステータスを書き込みます。  
+  
+8.  クライアント コンソール アプリケーションを終了するには、任意のキーを押します。  
+  
+9. サービスのデバッグを停止するには、Shift キーを押しながら F5 キーを押します。  
+  
+10. Windows の通知領域で、ASP.NET 開発サーバーのアイコンを右クリックし、コンテキスト メニューの **\[停止\]** を選択します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\SoapAndHttpEndpoints`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/srmp.md b/docs/framework/wcf/samples/srmp.md
new file mode 100644
index 00000000000..b8ac0af9fb6
--- /dev/null
+++ b/docs/framework/wcf/samples/srmp.md
@@ -0,0 +1,106 @@
+---
+title: "SRMP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cf37078c-dcb4-45e0-acaf-2f196521b226
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# SRMP
+このサンプルでは、HTTP 経由でメッセージ キュー \(MSMQ\) を使用して、トランザクション キューによる通信を実行する方法を示します。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。  厳密には、クライアントはメッセージをキューに送信します。  サービスは、メッセージをキューから受信します。  したがって、キューを使用する通信では、サービスとクライアントが同時に実行されていなくてもかまいません。  
+  
+ MSMQ は HTTP \(HTTPS を含む\) を使用できるようにして、メッセージをキューに送信します。  このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でキューによる通信を使用する方法と、HTTP を介してメッセージを送信する方法を示します。  MSMQ では SRMP というプロトコルを使用します。これは、HTTP 経由の通信に使用する SOAP ベースのプロトコルです。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+4.  **\[Windows コンポーネントの追加と削除\]** でサンプルを実行する前に、MSMQ が HTTP サポートと共にインストールされていることを確認してください。  HTTP サポートをインストールすると、インターネット インフォメーション サービス \(IIS\) が自動的にインストールされ、MSMQ 用のプロトコル サポートが IIS に追加されます。  
+  
+5.  HTTP が通信に使用されていることを確認するには、MSMQ を強化モードで実行します。  これにより、HTTP 以外のトランスポートを使用した場合は、コンピュータ上でホストされているすべてのキューにメッセージが到着できないようになります。  
+  
+6.  [!INCLUDE[ws2003](../../../../includes/ws2003-md.md)] では、MSMQ を強化モードで実行するように選択した後でコンピュータを再起動する必要があります。  
+  
+7.  サービスを実行します。  
+  
+8.  クライアントを実行します。  エンドポイント アドレスは、localhost ではなくコンピュータ名または IP アドレスを指定するように変更してください。  クライアントはメッセージを送信して終了します。  
+  
+## 必要条件  
+ このサンプルを実行するには、MSMQ に加え、IIS をサービス コンピュータとクライアント コンピュータの両方にインストールする必要があります。  
+  
+## 使用例  
+ このサンプルでは、HTTP 経由で MSMQ を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] キューに置かれたメッセージを送信する方法を示します。  これは、SRMP メッセージングとも呼ばれます。  キューに置かれたメッセージが送信されると、送信元コンピュータの MSMQ は、このメッセージを TCP または HTTP トランスポート経由で受信キュー マネージャに転送します。  SRMP を選択すると、HTTP をキュー転送用のトランスポートとして選択したことになります。  SRMP Secure を選択すると、HTTPS を使用できます。  
+  
+## 例  
+ このサンプル コードはトランザクションのサンプルに基づいています。  SRMP を使用してキューにメッセージを送信したり、キューからメッセージを受信したりする方法は、ネイティブ プロトコルを使用してメッセージを送受信する方法と同じです。  
+  
+ クライアントの構成は、キュー転送プロトコルの選択を示すように変更されます。  キュー転送プロトコルには、ネイティブ、SRMP、または SRMP Secure のいずれか 1 つを選択できます。  既定の転送プロトコルはネイティブです。  この例では、クライアントとサービスの構成で SRMP を使用するように指定されます。  
+  
+ セキュリティの関係で、SRMP には制限があります。  既定の MSMQ トランスポート セキュリティには Active Directory が必要です。Active Directory では、送信キュー マネージャと受信キュー マネージャが同じ Windows ドメインに存在する必要があります。  HTTP 境界を越えてメッセージを送信する場合、これは不可能です。  このため、既定のトランスポート セキュリティは機能しません。  トランスポート セキュリティが必要な場合は、トランスポート セキュリティを Certificate に設定する必要があります。  また、メッセージのセキュリティ保護にメッセージ セキュリティを使用することもできます。  このサンプルでは SRMP メッセージングを説明するために、トランスポート セキュリティとメッセージ セキュリティはどちらも無効になっています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  
+  <system.serviceModel>  
+  
+    <client>  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint name="OrderProcessorEndpoint"  
+           address=  
+          "net.msmq://localhost/private/ServiceModelSamplesSrmp"   
+           bindingConfiguration="srmpBinding"   
+           binding="netMsmqBinding"   
+           contract="IOrderProcessor" />  
+    </client>  
+    <bindings>  
+      <netMsmqBinding>  
+        <binding name="srmpBinding"  
+                 queueTransferProtocol="Srmp">  
+          <security mode="None"></security>  
+        </binding>  
+      </netMsmqBinding>  
+    </bindings>  
+  </system.serviceModel>  
+  
+</configuration>  
+```  
+  
+ このサンプルを実行すると、次の出力が生成されます。  
+  
+```  
+Processing Purchase Order: 556b70be-31ee-4a3b-8df4-ed5e538015a4   
+Customer: somecustomer.com   
+OrderDetails   
+    Order LineItem: 54 of Blue Widget @unit price: $29.99   
+    Order LineItem: 890 of Red Widget @unit price: $45.89   
+    Total cost of this order: $42461.56   
+    Order status: Pending  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\SRMP`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/stand-alone-diagnostics-feed-sample.md b/docs/framework/wcf/samples/stand-alone-diagnostics-feed-sample.md
new file mode 100644
index 00000000000..a7f8a19cff5
--- /dev/null
+++ b/docs/framework/wcf/samples/stand-alone-diagnostics-feed-sample.md
@@ -0,0 +1,105 @@
+---
+title: "スタンドアロン診断フィードのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d31c6c1f-292c-4d95-8e23-ed8565970ea5
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# スタンドアロン診断フィードのサンプル
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して配信用の RSS フィードおよび Atom フィードを作成する方法を示します。  このサンプルは基本の "Hello World" プログラムであり、オブジェクト モデルの基本とオブジェクト モデルを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスにセットアップする方法を示しています。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、特殊なデータ型 \(<xref:System.ServiceModel.Syndication.SyndicationFeedFormatter>\) を返すサービス操作として配信フィードをモデル化します。  <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> のインスタンスは、フィードを RSS 2.0 形式および Atom 1.0 形式の両方にシリアル化できます。  使用するコントラクトを次のサンプル コードに示します。  
+  
+```  
+[ServiceContract(Namespace = "")]  
+    interface IDiagnosticsService  
+    {  
+        [OperationContract]  
+        //The [WebGet] attribute controls how WCF dispatches  
+        //HTTP requests to service operations based on a URI suffix  
+        //(the part of the request URI after the endpoint address)  
+        //using the HTTP GET method. The UriTemplate specifies a relative  
+        //path of 'feed', and specifies that the format is  
+        //supplied using a query string.   
+        [WebGet(UriTemplate="feed?format={format}")]  
+        [ServiceKnownType(typeof(Atom10FeedFormatter))]  
+        [ServiceKnownType(typeof(Rss20FeedFormatter))]  
+        SyndicationFeedFormatter GetProcesses(string format);  
+    }  
+```  
+  
+ `GetProcesses` 操作には、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] が HTTP GET 要求をサービス操作にディスパッチする方法を制御し、送信されるメッセージの形式を指定できるようにする <xref:System.ServiceModel.Web.WebGetAttribute> 属性で注釈が付けられています。  
+  
+ あらゆる [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様に、配信フィードは、任意のマネージ アプリケーション内での自己ホストが可能です。  配信サービスが適切に機能するには、特定のバインディング \(<xref:System.ServiceModel.WebHttpBinding>\) と、特定のエンドポイント動作 \(<xref:System.ServiceModel.Description.WebHttpBehavior>\) が必要です。  新しい <xref:System.ServiceModel.Web.WebServiceHost> クラスには、特定の構成を使用せずにこのようなエンドポイントを作成する際に便利な API が用意されています。  
+  
+```  
+WebServiceHost host = new WebServiceHost(typeof(ProcessService), new Uri("http://localhost:8000/diagnostics"));  
+  
+            //The WebServiceHost will automatically provide a default endpoint at the base address  
+            //using the proper binding (the WebHttpBinding) and endpoint behavior (the WebHttpBehavior)  
+```  
+  
+ または、IIS でホストされる .svc ファイルから <xref:System.ServiceModel.Activation.WebServiceHostFactory> を使用して、同等の機能を用意することもできます \(この手法は、このサンプル コードでは示されません\)。  
+  
+```  
+<%@ ServiceHost Language="C#|VB" Debug="true" Service="ProcessService" %>  
+```  
+  
+ このサービスは標準の HTTP GET を使用して要求を受け取るので、サービスへのアクセスには、RSS または ATOM に対応している任意のクライアントを使用できます。  たとえば、Internet Explorer 7 などの RSS 対応のブラウザで、http:\/\/localhost:8000\/diagnostics\/feed\/?format\=atom または http:\/\/localhost:8000\/diagnostics\/feed\/?format\=rss に移動することで、このサービスの出力を表示できます。  
+  
+ 命令型コードを使用して、配信データの読み取りと処理に[WCF 配信オブジェクト モデルを Atom や RSS に割り当てる方法](../../../../docs/framework/wcf/feature-details/how-the-wcf-syndication-object-model-maps-to-atom-and-rss.md)を使用することもできます。  
+  
+```  
+XmlReader reader = XmlReader.Create( "http://localhost:8000/diagnostics/feed/?format=rss",  
+new XmlReaderSettings()  
+{  
+//MaxCharactersInDocument can be used to control the maximum amount of data   
+//read from the reader and helps prevent OutOfMemoryException  
+MaxCharactersInDocument = 1024 * 64  
+} );  
+  
+SyndicationFeed feed = SyndicationFeed.Load( reader );  
+  
+foreach (SyndicationItem i in feed.Items)  
+{  
+        XmlSyndicationContent content = i.Content as XmlSyndicationContent;  
+        ProcessData pd = content.ReadContent<ProcessData>();  
+  
+        Console.WriteLine(i.Title.Text);  
+        Console.WriteLine(pd.ToString());  
+}  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」のセットアップ手順の説明に従って、コンピュータ上で HTTP および HTTPS の正しいアドレス登録アクセス許可があることを確認します。  
+  
+2.  ソリューションをビルドします。  
+  
+3.  コンソール アプリケーションを実行します。  
+  
+4.  コンソール アプリケーションの実行中に、RSS 対応のブラウザーを使用して http:\/\/localhost:8000\/diagnostics\/feed\/?format\=atom または http:\/\/localhost:8000\/diagnostics\/feed\/?format\=rss に移動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Syndication\DiagnosticsFeed`  
+  
+## 参照  
+ [WCF Web HTTP プログラミング モデル](../../../../docs/framework/wcf/feature-details/wcf-web-http-programming-model.md)   
+ [WCF 配信](../../../../docs/framework/wcf/feature-details/wcf-syndication.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/stream.md b/docs/framework/wcf/samples/stream.md
new file mode 100644
index 00000000000..0721643fcaf
--- /dev/null
+++ b/docs/framework/wcf/samples/stream.md
@@ -0,0 +1,196 @@
+---
+title: "ストリーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58a3db81-20ab-4627-bf31-39d30b70b4fe
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# ストリーム
+このストリーム サンプルでは、ストリーミング転送モードの通信を使用する方法を示します。サービスは、ストリームを送受信する複数の操作を公開します。このサンプルは自己ホスト型です。クライアントとサービスはどちらもコンソール プログラムです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、2 つの転送モード \(バッファまたはストリーミング\) で通信できます。既定のバッファー転送モードでは、受信側がメッセージを読むためにはメッセージを完全に送信する必要があります。ストリーミング転送モードでは、メッセージを完全に送信しなくても、受信側がメッセージの処理を開始できます。ストリーミング モードは、渡される情報が長い場合、または連続的に処理する場合に役立ちます。ストリーミング モードは、メッセージが大きすぎてすべてをバッファーできない場合にも役立ちます。  
+  
+## ストリーミングとサービス コントラクト  
+ サービス コントラクトを設計する際は、ストリーミングを考慮します。操作により大量のデータが受信されたり返されたりする場合、このデータをストリーミングして、入力または出力メッセージのバッファによりメモリの使用率が高くなるのを回避することを検討してください。データをストリーミングするには、メッセージ内のパラメータが、データを保持するパラメータだけになるようにします。たとえば、入力メッセージをストリーミングする場合、厳密に 1 つの入力パラメーターが操作に含まれている必要があります。同様に、出力メッセージをストリーミングする場合、厳密に 1 つの出力パラメーターまたは戻り値が操作に含まれている必要があります。いずれの場合も、パラメータまたは戻り値の型は `Stream`、`Message`、または `IXmlSerializable` のいずれかである必要があります。このストリーミングのサンプルに使用されているサービス コントラクトを次に示します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IStreamingSample  
+{  
+    [OperationContract]  
+    Stream GetStream(string data);  
+    [OperationContract]  
+    bool UploadStream(Stream stream);  
+    [OperationContract]  
+    Stream EchoStream(Stream stream);  
+    [OperationContract]  
+    Stream GetReversedStream();  
+  
+}  
+```  
+  
+ `GetStream` 操作は、一部の入力データを文字列として受信 \(バッファ\) し、`Stream` \(ストリーミング\) を返します。逆に言えば、`UploadStream` は `Stream` \(ストリーミング\) を取り込んで、`bool` \(バッファー\) を返します。`EchoStream` は `Stream` を出し入れします。これは、入力および出力メッセージがどちらもストリーミングされる操作の例です。最後に、`GetReversedStream` は入力を行わずに `Stream` \(ストリーミング\) を返します。  
+  
+## ストリーミング転送の有効化  
+ 前述のように操作コントラクトを定義することにより、プログラミング モデル レベルでのストリーミングが実現します。ここで作業を終えても、トランスポートはメッセージ全体の内容をバッファします。トランスポートのストリーミングを有効にするには、トランスポートのバインディング要素で転送モードを選択します。バインディング要素には、`TransferMode` プロパティがあり、`Buffered`、`Streamed`、`StreamedRequest`、または `StreamedResponse` に設定できます。転送モードを `Streamed` に設定すると、両方向のストリーミング通信が可能になります。転送モードを `StreamedRequest` または `StreamedResponse` に設定すると、それぞれ要求または応答のみでのストリーミング通信が可能になります。  
+  
+ `basicHttpBinding` は、`NetTcpBinding` および `NetNamedPipeBinding` と同様に、バインディングで `TransferMode` プロパティを開示します。他のトランスポートの場合、転送モードを設定するにはカスタム バインディングを作成する必要があります。  
+  
+ 次のサンプルの構成コードでは、`basicHttpBinding` とカスタム HTTP バインディングで、`TransferMode` プロパティをストリーミングに設定しています。  
+  
+```  
+<!-- An example basicHttpBinding using streaming. -->  
+<basicHttpBinding>  
+  <binding name="HttpStreaming" maxReceivedMessageSize="67108864"  
+           transferMode="Streamed"/>  
+</basicHttpBinding>  
+<!-- An example customBinding using HTTP and streaming.-->  
+<customBinding>  
+  <binding name="Soap12">  
+    <textMessageEncoding messageVersion="Soap12WSAddressing10" />  
+    <httpTransport transferMode="Streamed"  
+                   maxReceivedMessageSize="67108864"/>  
+  </binding>  
+</customBinding>  
+  
+```  
+  
+ 上の構成コードでは、`transferMode` を `Streamed` に設定することに加え、`maxReceivedMessageSize` を 64 MB に設定しています。防御機構として、`maxReceivedMessageSize` では受信可能なメッセージの最大サイズが決められます。既定の `maxReceivedMessageSize` は 64 KB です。これは、多くの場合ストリーミングを行うには小さすぎます。  
+  
+## ストリーミングされる際のデータの処理  
+ `GetStream`、`UploadStream`、および `EchoStream` の各操作はすべて、ファイルからデータを直接送信したり、データをファイルに直接受信したりします。ただし場合によっては、大量のデータを送信または受信し、データの送受信時に一部の処理をデータのチャンク上で実行する必要があります。このようなシナリオに対応する 1 つの方法は、データの読み取りまたは書き込み時にデータを処理するカスタム ストリーム \(<xref:System.IO.Stream> から派生するクラス\) を記述することです。`GetReversedStream` 操作と `ReverseStream` クラスがこの例です。  
+  
+ `GetReversedStream` では、`ReverseStream` の新しいインスタンスを作成して返します。実際の処理は、システムが `ReverseStream` オブジェクトの読み取りを行うときに発生します。`ReverseStream.Read` の実装により、基になるファイルからバイトのチャンクが読み取られ、バイトが反転され、その反転されたバイトが返されます。この処理ではファイル全体の内容は反転されません。一度に 1 つのバイトのチャンクが反転されます。これは、ストリームの内容を読み取ったりストリームに内容を書き込んだりするときに、ストリーミング処理を実行する方法を示す例です。  
+  
+```  
+class ReverseStream : Stream  
+{  
+  
+    FileStream inStream;  
+    internal ReverseStream(string filePath)  
+    {  
+        //Opens the file and places a StreamReader around it.  
+        inStream = File.OpenRead(filePath);  
+    }  
+  
+    // Other methods removed for brevity.  
+  
+    public override int Read(byte[] buffer, int offset, int count)  
+    {  
+        int countRead=inStream.Read(buffer, offset,count);  
+        ReverseBuffer(buffer, offset, countRead);  
+        return countRead;  
+    }  
+  
+    public override void Close()  
+    {  
+        inStream.Close();  
+        base.Close();  
+    }  
+    protected override void Dispose(bool disposing)  
+    {  
+        inStream.Dispose();  
+        base.Dispose(disposing);  
+    }  
+    void ReverseBuffer(byte[] buffer, int offset, int count)  
+    {  
+        int i, j;  
+        for (i = offset, j = offset + count - 1; i < j; i++, j--)  
+        {  
+            byte currenti = buffer[i];  
+            buffer[i] = buffer[j];  
+            buffer[j] = currenti;  
+        }  
+  
+    }  
+}  
+```  
+  
+## サンプルの実行  
+ サンプルを実行するには、最初に、このドキュメントの最後にある指示に従ってサービスとクライアントの両方をビルドします。次に、サービスとクライアントを 2 つの異なるコンソール ウィンドウで開始します。クライアントが開始したら待機状態になるので、サービスの準備ができたら Enter キーを押します。その後、クライアントはまず HTTP を経由し、次に TCP を経由して、メソッド `GetStream()`、`UploadStream()`、および `GetReversedStream()` を呼び出します。サービスからの出力例、続いてクライアントからの出力例を次に示します。  
+  
+ サービスからの出力 :  
+  
+```  
+The streaming service is ready.  
+Press <ENTER> to terminate service.  
+  
+Saving to file D:\...\uploadedfile  
+......................  
+File D:\...\uploadedfile saved  
+Saving to file D:\...\uploadedfile  
+...............  
+File D:\...\uploadedfile saved  
+```  
+  
+ クライアントからの出力 :  
+  
+```  
+Press <ENTER> when service is ready  
+------ Using HTTP ------   
+Calling GetStream()  
+Saving to file D:\...\clientfile  
+......................  
+Wrote 33405 bytes to stream  
+  
+File D:\...\clientfile saved  
+Calling UploadStream()  
+Calling GetReversedStream()  
+Saving to file D:\...\clientfile  
+......................  
+Wrote 33405 bytes to stream  
+  
+File D:\...\clientfile saved  
+------ Using Custom HTTP ------  
+Calling GetStream()  
+Saving to file D:\...\clientfile  
+...............  
+Wrote 33405 bytes to stream  
+  
+File D:\...\clientfile saved  
+Calling UploadStream()  
+Calling GetReversedStream()  
+Saving to file D:\...\clientfile  
+...............  
+Wrote 33405 bytes to stream  
+  
+File D:\...\clientfile saved  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!NOTE]
+>  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\Stream`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/streaming-feeds-sample.md b/docs/framework/wcf/samples/streaming-feeds-sample.md
new file mode 100644
index 00000000000..e9dc85412ea
--- /dev/null
+++ b/docs/framework/wcf/samples/streaming-feeds-sample.md
@@ -0,0 +1,134 @@
+---
+title: "ストリーミング フィードのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f1228c0-daaa-45f0-b93e-c4a158113744
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# ストリーミング フィードのサンプル
+このサンプルでは、多数の項目が含まれた配信フィードを管理する方法を示します。サーバー側のサンプルは、フィード内での個々の <xref:System.ServiceModel.Syndication.SyndicationItem> オブジェクトの作成を、項目がネットワーク ストリームに書き込まれる直前まで遅らせる方法を示しています。  
+  
+ クライアント側のサンプルは、カスタム配信フィード フォーマッタを使用して個々の項目をネットワーク ストリームから読み取り、読み取られたフィードがメモリに完全にバッファーされないようにする方法を示しています。  
+  
+ 配信 API のストリーミング機能を十分に示すため、このサンプルでは、無数の項目を含むフィードがサーバーによって公開されるという多少通常とは異なるシナリオを使用しています。この場合、サーバーは、クライアントがフィードから特定の数 \(既定では 10\) の項目を読み取ったと判断するまで、新しい項目をフィードに対して生成し続けます。処理を簡単にするために、クライアントとサーバーは両方とも同じプロセスで実装され、共有 `ItemCounter` オブジェクトを使用して、クライアントによって生成された項目の数を追跡します。`ItemCounter` 型は、サンプル シナリオを正常に終了するためにのみ存在し、示されるパターンの重要な要素ではありません。  
+  
+ このサンプルでは、[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] 反復子を使用します \(`yield``return` キーワード コンストラクトを使用\)。反復子[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、MSDN の「反復子の使用」を参照してください。  
+  
+## サービス  
+ 次のコードに示すように、サービスは、1 つの操作で構成される基本的な <xref:System.ServiceModel.Web.WebGetAttribute> コントラクトを実装します。  
+  
+```  
+[ServiceContract]  
+interface IStreamingFeedService  
+{  
+    [WebGet]  
+    [OperationContract]  
+    Atom10FeedFormatter StreamedFeed();  
+}  
+  
+```  
+  
+ 次のコードに示すように、サービスは、`ItemGenerator` クラスを使用してこのコントラクトを実装し、反復子を使用する <xref:System.ServiceModel.Syndication.SyndicationItem> インスタンスの無数のストリームを作成します。  
+  
+```  
+class ItemGenerator  
+{  
+    public IEnumerable<SyndicationItem> GenerateItems()  
+    {  
+        while (counter.GetCount() < maxItemsRead)  
+        {  
+            itemsReturned++;  
+            yield return CreateNextItem();  
+        }  
+  
+    }  
+    ...  
+}  
+  
+```  
+  
+ サービスの実装によってフィードが作成されると、項目のバッファされたコレクションの代わりに `ItemGenerator.GenerateItems()` の出力が使用されます。  
+  
+```  
+public Atom10FeedFormatter StreamedFeed()  
+{  
+    SyndicationFeed feed = new SyndicationFeed("Streamed feed", "Feed to test streaming", null);  
+    //Generate an infinite stream of items. Both the client and the service share  
+    //a reference to the ItemCounter, which allows the sample to terminate  
+    //execution after the client has read 10 items from the stream  
+    ItemGenerator itemGenerator = new ItemGenerator(this.counter, 10);  
+  
+    feed.Items = itemGenerator.GenerateItems();  
+    return feed.GetAtom10Formatter();  
+}  
+  
+```  
+  
+ その結果、項目のストリームはメモリに完全にはバッファされません。`ItemGenerator.GenerateItems()` メソッド内の `yield``return` ステートメントでブレークポイントを設定し、サービスによって `StreamedFeed()` メソッドの結果が返されてからこのブレークポイントが検出されることに注意して、この動作を確認します。  
+  
+## クライアント  
+ このサンプルのクライアントでは、フィードの項目をメモリにバッファする代わりに、個々の項目の実体化を遅延させるカスタム <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> 実装を使用します。カスタム `StreamedAtom10FeedFormatter` インスタンスの使用方法は次のとおりです。  
+  
+```  
+XmlReader reader = XmlReader.Create("http://localhost:8000/Service/Feeds/StreamedFeed");  
+StreamedAtom10FeedFormatter formatter = new StreamedAtom10FeedFormatter(counter);  
+  
+SyndicationFeed feed = formatter.ReadFrom(reader);  
+  
+```  
+  
+ 通常、<xref:System.ServiceModel.Syndication.SyndicationFeedFormatter.ReadFrom%28System.Xml.XmlReader%29> の呼び出しは、フィードのコンテンツ全体がネットワークから読み取られ、メモリにバッファされるまで返されません。ただし、次のコードに示すように、`StreamedAtom10FeedFormatter` オブジェクトによって <xref:System.ServiceModel.Syndication.Atom10FeedFormatter.ReadItems%28System.Xml.XmlReader%2CSystem.ServiceModel.Syndication.SyndicationFeed%2CSystem.Boolean%40%29> がオーバーライドされ、バッファ内のコレクションの代わりに反復子が返されます。  
+  
+```  
+protected override IEnumerable<SyndicationItem> ReadItems(XmlReader reader, SyndicationFeed feed, out bool areAllItemsRead)  
+{  
+    areAllItemsRead = false;  
+    return DelayReadItems(reader, feed);  
+}  
+  
+private IEnumerable<SyndicationItem> DelayReadItems(XmlReader reader, SyndicationFeed feed)  
+{  
+    while (reader.IsStartElement("entry", "http://www.w3.org/2005/Atom"))  
+    {  
+        yield return this.ReadItem(reader, feed);  
+    }  
+  
+    reader.ReadEndElement();  
+}  
+  
+```  
+  
+ その結果、各項目は、`ReadItems()` の結果を走査するクライアント アプリケーションで使用可能な状態になるまで、ネットワークから読み取られません。`StreamedAtom10FeedFormatter.DelayReadItems()` 内の `yield``return` ステートメントでブレークポイントを設定し、`ReadFrom()` の呼び出しが完了してからこのブレークポイントが検出されることに注意して、この動作を確認します。  
+  
+ 次の手順は、サンプルをビルドして実行する方法を示しています。クライアントが 10 個の項目を読み取った後にサーバーによる項目の生成が停止されると、クライアントが読み取った項目数は 10 個より非常に多く出力されます。これは、サンプルで使用されたネットワーキング バインディングによってデータが 4 キロバイト \(KB\) セグメントで転送されることが原因です。このような場合、クライアントは、項目を 1 つでも読み取る前に 4 KB の項目データを受信します。これは通常の動作です \(適切にサイズが調整されたセグメントでストリーミングされた HTTP データを送信すると、パフォーマンスが向上します\)。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Syndication\StreamingFeeds`  
+  
+## 参照  
+ [スタンドアロン診断フィード](../../../../docs/framework/wcf/samples/stand-alone-diagnostics-feed-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/strongly-typed-extensions-sample.md b/docs/framework/wcf/samples/strongly-typed-extensions-sample.md
new file mode 100644
index 00000000000..23baa0453e1
--- /dev/null
+++ b/docs/framework/wcf/samples/strongly-typed-extensions-sample.md
@@ -0,0 +1,303 @@
+---
+title: "厳密に型指定された拡張のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 02220f11-1a83-441c-9e5a-85f9a9367572
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 厳密に型指定された拡張のサンプル
+このサンプルでは、例を示す目的で <xref:System.ServiceModel.Syndication.SyndicationFeed> クラスを使用します。ただし、このサンプルで示すパターンは、拡張データをサポートするすべての配信クラスで使用できます。  
+  
+ 配信オブジェクト モデル \(<xref:System.ServiceModel.Syndication.SyndicationFeed>、<xref:System.ServiceModel.Syndication.SyndicationItem>、および関連クラス\) は、<xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> プロパティおよび <xref:System.ServiceModel.Syndication.SyndicationFeed.ElementExtensions%2A> プロパティを使用することにより、拡張データへの弱い型定義によるアクセスをサポートします。このサンプルでは、特定のアプリケーション固有の拡張を厳密に型指定されたプロパティとして使用できるようにする <xref:System.ServiceModel.Syndication.SyndicationFeed> および <xref:System.ServiceModel.Syndication.SyndicationItem> のカスタム派生クラスを実装することにより、拡張データへの厳密に型指定されたアクセスを提供する方法を示します。  
+  
+ 例として、このサンプルでは Atom Threading Extensions の RFC 案で定義された拡張要素を実装する方法を示しています。このサンプルは、使い方を示すために用意されたものであり、仕様案を完全に実装するためのものではありません。  
+  
+## サンプル XML  
+ 次の XML の例は、`<in-reply-to>` 拡張要素が追加された Atom 1.0 エントリを示しています。  
+  
+```  
+<entry>  
+    <id>tag:example.org,2005:1,2</id>  
+    <title type="text">Another response to the original</title>  
+    <summary type="text">  
+         This is a response to the original entry</summary>  
+    <updated>2006-03-01T12:12:13Z</updated>  
+    <link href="http://www.example.org/entries/1/2" />  
+    <in-reply-to p3:ref="tag:example.org,2005:1"   
+                 p3:href="http://www.example.org/entries/1"   
+                 p3:type="application/xhtml+xml"   
+                 xmlns:p3="http://contoso.org/syndication/thread/1.0"   
+                 xmlns="http://contoso.org/syndication/thread/1.0">  
+      <anotherElement xmlns="http://www.w3.org/2005/Atom">  
+                     Some more data</anotherElement>  
+      <aDifferentElement xmlns="http://www.w3.org/2005/Atom">  
+                     Even more data</aDifferentElement>  
+    </in-reply-to>  
+</entry>  
+  
+```  
+  
+ `<in-reply-to>` 要素は、3 つの必須の属性 \(`ref`、`type`、および `href`\) を指定しますが、拡張属性および拡張要素も追加できます。  
+  
+## In\-Reply\-To 要素のモデル化  
+ このサンプルでは、`<in-reply-to>` 要素は <xref:System.Xml.Serialization.IXmlSerializable> を実装する CLR としてモデル化されており、<xref:System.Runtime.Serialization.DataContractSerializer> と共に使用できます。さらに、次のサンプル コードに示すように、要素のデータにアクセスするメソッドおよびプロパティも実装しています。  
+  
+```  
+[XmlRoot(ElementName = "in-reply-to", Namespace = "http://contoso.org/syndication/thread/1.0")]  
+public class InReplyToElement : IXmlSerializable  
+{  
+    internal const string ElementName = "in-reply-to";  
+    internal const string NsUri =   
+                  "http://contoso.org/syndication/thread/1.0";  
+    private Dictionary<XmlQualifiedName, string> extensionAttributes;  
+    private Collection<XElement> extensionElements;  
+  
+    public InReplyToElement()  
+    {  
+        this.extensionElements = new Collection<XElement>();  
+        this.extensionAttributes = new Dictionary<XmlQualifiedName,   
+                                                          string>();  
+    }  
+  
+    public Dictionary<XmlQualifiedName, string> AttributeExtensions  
+    {  
+        get { return this.extensionAttributes; }  
+    }  
+  
+    public Collection<XElement> ElementExtensions  
+    {  
+        get { return this.extensionElements; }  
+    }  
+  
+    public Uri Href  
+    { get; set; }  
+  
+    public string MediaType  
+    { get; set; }  
+  
+    public string Ref  
+    { get; set; }  
+  
+    public Uri Source  
+    { get; set; }  
+}  
+  
+```  
+  
+ `InReplyToElement` クラスは、必須の属性 \(`HRef`、`MediaType`、および `Source`\) のプロパティと共に、<xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> および <xref:System.ServiceModel.Syndication.SyndicationFeed.ElementExtensions%2A> を保持するコレクションを実装します。  
+  
+ `InReplyToElement` クラスは、<xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装します。このインターフェイスは、オブジェクト インスタンスを XML から読み取る、または書き込む方法の直接制御を可能にします。`ReadXml` メソッドは、渡された <xref:System.Xml.XmlReader> から `Ref`、`HRef`、`Source`、および `MediaType` の各プロパティを最初に読み取ります。不明な属性は<xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> コレクションに格納されます。すべての属性が読み取られると、<xref:System.Xml.XmlReader.ReadStartElement> が呼び出されて、リーダーが次の要素に進みます。次のコードに示すように、このクラスによりモデル化された要素には必須の子がないので、子要素は `XElement` インスタンスにバッファされ、<xref:System.ServiceModel.Syndication.SyndicationFeed.ElementExtensions%2A> コレクションに格納されます。  
+  
+```  
+public void ReadXml(System.Xml.XmlReader reader)  
+{  
+    bool isEmpty = reader.IsEmptyElement;  
+  
+    if (reader.HasAttributes)  
+    {  
+        for (int i = 0; i < reader.AttributeCount; i++)  
+        {  
+            reader.MoveToNextAttribute();  
+  
+            if (reader.NamespaceURI == "")  
+            {  
+                if (reader.LocalName == "ref")  
+                {  
+                    this.Ref = reader.Value;  
+                }  
+                else if (reader.LocalName == "href")  
+                {  
+                    this.Href = new Uri(reader.Value);  
+                }  
+                else if (reader.LocalName == "source")  
+                {  
+                    this.Source = new Uri(reader.Value);  
+                }  
+                else if (reader.LocalName == "type")  
+                {  
+                    this.MediaType = reader.Value;  
+                }  
+                else  
+                {  
+                    this.AttributeExtensions.Add(new   
+                                 XmlQualifiedName(reader.LocalName,   
+                                 reader.NamespaceURI),   
+                                 reader.Value);  
+                }  
+            }  
+        }  
+    }  
+  
+    reader.ReadStartElement();  
+  
+    if (!isEmpty)  
+    {  
+        while (reader.IsStartElement())  
+        {  
+            ElementExtensions.Add(  
+                  (XElement) XElement.ReadFrom(reader));  
+        }  
+        reader.ReadEndElement();  
+    }  
+}  
+  
+```  
+  
+ `WriteXml` では、`InReplyToElement` メソッドは最初に `Ref`、`HRef`、`Source`、および `MediaType` の各プロパティの値を XML 属性として書き込みます \(`WriteXml` は、実際の外側の要素自体は書き込みません。`WriteXml` により行われるためです\)。また、次のコードに示すように、<xref:System.ServiceModel.Syndication.SyndicationFeed.AttributeExtensions%2A> および <xref:System.ServiceModel.Syndication.SyndicationFeed.ElementExtensions%2A> の内容をライタに書き込みます。  
+  
+```  
+public void WriteXml(System.Xml.XmlWriter writer)  
+{  
+    if (this.Ref != null)  
+    {  
+        writer.WriteAttributeString("ref", InReplyToElement.NsUri,   
+                                            this.Ref);  
+    }  
+    if (this.Href != null)  
+    {  
+        writer.WriteAttributeString("href", InReplyToElement.NsUri,   
+                                                this.Href.ToString());  
+    }  
+    if (this.Source != null)  
+    {  
+        writer.WriteAttributeString("source", InReplyToElement.NsUri,   
+                                              this.Source.ToString());  
+    }  
+    if (this.MediaType != null)  
+    {  
+        writer.WriteAttributeString("type", InReplyToElement.NsUri,   
+                                                    this.MediaType);  
+    }  
+  
+    foreach (KeyValuePair<XmlQualifiedName, string> kvp in   
+                                             this.AttributeExtensions)  
+    {  
+        writer.WriteAttributeString(kvp.Key.Name, kvp.Key.Namespace,   
+                                                   kvp.Value);  
+    }  
+  
+    foreach (XElement element in this.ElementExtensions)  
+    {  
+        element.WriteTo(writer);  
+    }  
+}  
+  
+```  
+  
+## ThreadedFeed および ThreadedItem  
+ このサンプルでは、`InReplyTo` 拡張が存在する `SyndicationItems` が `ThreadedItem` クラスによりモデル化されます。同様に、`ThreadedFeed` クラスは、項目が `ThreadedItem` のすべてのインスタンスである `SyndicationFeed` です。  
+  
+ `ThreadedFeed` クラスは、`SyndicationFeed` から継承され、`OnCreateItem` をオーバーライドして `ThreadedItem` を返します。また、次のコードに示すように、`Items` コレクションにアクセスするメソッドを `ThreadedItems` として実装します。  
+  
+```  
+public class ThreadedFeed : SyndicationFeed  
+{  
+    public ThreadedFeed()  
+    {  
+    }  
+  
+    public IEnumerable<ThreadedItem> ThreadedItems  
+    {  
+        get  
+        {  
+            return this.Items.Cast<ThreadedItem>();  
+        }  
+    }  
+  
+    protected override SyndicationItem CreateItem()  
+    {  
+        return new ThreadedItem();  
+    }  
+}  
+  
+```  
+  
+ `ThreadedItem` クラスは `SyndicationItem` から継承され、`InReplyToElement` を厳密に型指定されたプロパティとします。これにより、`InReplyTo` 拡張データにプログラムによって簡単にアクセスできます。また、次のコードに示すように、その拡張データの読み取り\/書き込みを行う `TryParseElement` および `WriteElementExtensions` も実装します。  
+  
+```  
+public class ThreadedItem : SyndicationItem  
+{  
+    private InReplyToElement inReplyTo;  
+    // Constructors  
+        public ThreadedItem()  
+        {  
+            inReplyTo = new InReplyToElement();  
+        }  
+  
+        public ThreadedItem(string title, string content, Uri itemAlternateLink, string id, DateTimeOffset lastUpdatedTime) : base(title, content, itemAlternateLink, id, lastUpdatedTime)  
+        {  
+            inReplyTo = new InReplyToElement();  
+        }  
+  
+    public InReplyToElement InReplyTo  
+    {  
+        get { return this.inReplyTo; }  
+    }  
+  
+    protected override bool TryParseElement(  
+                        System.Xml.XmlReader reader,   
+                        string version)  
+    {  
+        if (version == SyndicationVersions.Atom10 &&  
+            reader.NamespaceURI == InReplyToElement.NsUri &&  
+            reader.LocalName == InReplyToElement.ElementName)  
+        {  
+            this.inReplyTo = new InReplyToElement();  
+  
+            this.InReplyTo.ReadXml(reader);  
+  
+            return true;  
+        }  
+        else  
+        {  
+            return base.TryParseElement(reader, version);  
+        }  
+    }  
+  
+    protected override void WriteElementExtensions(XmlWriter writer,   
+                                                 string version)  
+    {  
+        if (this.InReplyTo != null &&   
+                     version == SyndicationVersions.Atom10)  
+        {  
+            writer.WriteStartElement(InReplyToElement.ElementName,   
+                                           InReplyToElement.NsUri);  
+            this.InReplyTo.WriteXml(writer);  
+            writer.WriteEndElement();  
+        }  
+  
+        base.WriteElementExtensions(writer, version);  
+    }  
+}  
+  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Syndication\StronglyTypedExtensions`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/supporting-tokens.md b/docs/framework/wcf/samples/supporting-tokens.md
new file mode 100644
index 00000000000..ce2191564eb
--- /dev/null
+++ b/docs/framework/wcf/samples/supporting-tokens.md
@@ -0,0 +1,478 @@
+---
+title: "トークンのサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 65a8905d-92cc-4ab0-b6ed-1f710e40784e
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# トークンのサポート
+このトークンのサポート サンプルでは、WS\-Security を使用するメッセージに追加トークンを追加する方法を示します。  この例では、ユーザー名セキュリティ トークンに加え、X.509 バイナリ セキュリティ トークンを追加します。  トークンは、WS\-Security メッセージ ヘッダーでクライアントからサービスに渡されます。そのメッセージの一部は X.509 証明書を所有していることを受信側に証明するため、X.509 セキュリティ トークンに関連付けられた秘密キーで署名されます。  これは、複数のクレームをメッセージに関連付けて送信側を認証または承認する必要がある場合に便利です。  サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  
+  
+## 使用例  
+ このサンプルでは、次の方法を示します。  
+  
+-   クライアントが追加セキュリティ トークンをサービスに渡す方法。  
+  
+-   サーバーが、追加セキュリティ トークンに関連付けられたクレームにアクセスする方法。  
+  
+-   サーバーの X.509 証明書を使用して、メッセージの暗号化や署名に使用する対称キーを保護する方法。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## クライアントによる、ユーザー名トークンと X.509 サポート セキュリティ トークンを使用した認証  
+ サービスは、通信に使用する単一エンドポイントを公開します。エンドポイントは、`BindingHelper` クラスと `EchoServiceHost` クラスを使用してプログラムによって作成されます。  エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。  バインディングは、`SymmetricSecurityBindingElement` と `HttpTransportBindingElement` を使用して、カスタム バインディングとして構成されます。  このサンプルでは、`SymmetricSecurityBindingElement` を設定してサービス X.509 証明書を使用し、送信中の対称キーを保護して、WS\-Security メッセージ ヘッダー内で `UserNameToken` とサポート `X509SecurityToken` を渡します。  対称キーは、メッセージ本文とユーザー名セキュリティ トークンの暗号化に使用されます。  サポート トークンは、追加バイナリ セキュリティ トークンとして WS\-Security メッセージ ヘッダー内で渡されます。  サポート トークンの信頼性は、サポート X.509 セキュリティ トークンに関連付けられている秘密キーを使用してメッセージに署名することによって証明されます。  
+  
+```  
+public static Binding CreateMultiFactorAuthenticationBinding()  
+{  
+    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();  
+  
+    // the message security binding element will be configured to require 2 tokens:  
+    // 1) A username-password encrypted with the service token  
+    // 2) A client certificate used to sign the message  
+  
+    // Instantiate a binding element that will require the username/password token in the message (encrypted with the server cert)  
+    SymmetricSecurityBindingElement messageSecurity = SecurityBindingElement.CreateUserNameForCertificateBindingElement();  
+  
+    // Create supporting token parameters for the client X509 certificate.  
+    X509SecurityTokenParameters clientX509SupportingTokenParameters = new X509SecurityTokenParameters();  
+    // Specify that the supporting token is passed in message send by the client to the service  
+    clientX509SupportingTokenParameters.InclusionMode = SecurityTokenInclusionMode.AlwaysToRecipient;  
+    // Turn off derived keys  
+    clientX509SupportingTokenParameters.RequireDerivedKeys = false;  
+    // Augment the binding element to require the client's X509 certificate as an endorsing token in the message  
+    messageSecurity.EndpointSupportingTokenParameters.Endorsing.Add(clientX509SupportingTokenParameters);  
+  
+    // Create a CustomBinding based on the constructed security binding element.  
+    return new CustomBinding(messageSecurity, httpTransport);  
+}  
+  
+```  
+  
+ この動作により、クライアント認証に使用されるサービス資格情報と、サービス X.509 証明書に関する情報が指定されます。  サンプルでは、サービス X.509 証明書内のサブジェクト名として `CN=localhost` を使用しています。  
+  
+```  
+override protected void InitializeRuntime()  
+{  
+    // Extract the ServiceCredentials behavior or create one.  
+    ServiceCredentials serviceCredentials =   
+        this.Description.Behaviors.Find<ServiceCredentials>();  
+    if (serviceCredentials == null)  
+    {  
+        serviceCredentials = new ServiceCredentials();  
+        this.Description.Behaviors.Add(serviceCredentials);  
+    }  
+  
+    // Set the service certificate  
+    serviceCredentials.ServiceCertificate.SetCertificate(  
+                                       "CN=localhost");  
+  
+/*  
+Setting the CertificateValidationMode to PeerOrChainTrust means that if the certificate is in the Trusted People store, then it will be trusted without performing a validation of the certificate's issuer chain. This setting is used here for convenience so that the sample can be run without having to have certificates issued by a certification authority (CA).  
+This setting is less secure than the default, ChainTrust. The security implications of this setting should be carefully considered before using PeerOrChainTrust in production code.  
+*/  
+    serviceCredentials.ClientCertificate.Authentication.CertificateValidationMode = X509CertificateValidationMode.PeerOrChainTrust;  
+  
+    // Create the custom binding and add an endpoint to the service.  
+    Binding multipleTokensBinding =  
+         BindingHelper.CreateMultiFactorAuthenticationBinding();  
+    this.AddServiceEndpoint(typeof(IEchoService),   
+                          multipleTokensBinding, string.Empty);  
+    base.InitializeRuntime();  
+}  
+```  
+  
+ サービス コード :  
+  
+```  
+[ServiceBehavior(IncludeExceptionDetailInFaults = true)]  
+public class EchoService : IEchoService  
+{  
+    public string Echo()  
+    {  
+        string userName;  
+        string certificateSubjectName;  
+        GetCallerIdentities(  
+            OperationContext.Current.ServiceSecurityContext,   
+            out userName,   
+            out certificateSubjectName);  
+            return String.Format("Hello {0}, {1}",   
+                    userName, certificateSubjectName);  
+    }  
+  
+    public void Dispose()  
+    {  
+    }  
+  
+    bool TryGetClaimValue<TClaimResource>(ClaimSet claimSet,   
+            string claimType, out TClaimResource resourceValue)  
+            where TClaimResource : class  
+    {  
+        resourceValue = default(TClaimResource);  
+        IEnumerable<Claim> matchingClaims =   
+            claimSet.FindClaims(claimType, Rights.PossessProperty);  
+        if(matchingClaims == null)  
+            return false;  
+        IEnumerator<Claim> enumerator = matchingClaims.GetEnumerator();  
+        if (enumerator.MoveNext())  
+        {  
+            resourceValue =   
+              (enumerator.Current.Resource == null) ? null :   
+              (enumerator.Current.Resource as TClaimResource);  
+            return true;  
+        }  
+        else  
+        {  
+            return false;  
+        }  
+    }  
+  
+    // Returns the username and certificate subject name provided by   
+    //the client  
+    void GetCallerIdentities(ServiceSecurityContext   
+        callerSecurityContext,   
+        out string userName, out string certificateSubjectName)  
+    {  
+        userName = null;  
+        certificateSubjectName = null;  
+  
+       // Look in all the claimsets in the authorization context  
+       foreach (ClaimSet claimSet in   
+               callerSecurityContext.AuthorizationContext.ClaimSets)  
+       {  
+            if (claimSet is WindowsClaimSet)  
+            {  
+                // Try to find a Name claim. This will have been   
+                // generated from the windows username.  
+                string tmpName;  
+                if (TryGetClaimValue<string>(claimSet, ClaimTypes.Name,   
+                                                      out tmpName))  
+                {  
+                    userName = tmpName;  
+                }  
+            }  
+            else if (claimSet is X509CertificateClaimSet)  
+            {  
+                // Try to find an X500DisinguishedName claim. This will   
+                // have been generated from the client certificate.  
+                X500DistinguishedName tmpDistinguishedName;  
+                if (TryGetClaimValue<X500DistinguishedName>(claimSet,   
+                               ClaimTypes.X500DistinguishedName,   
+                               out tmpDistinguishedName))  
+                {  
+                    certificateSubjectName = tmpDistinguishedName.Name;  
+                }  
+            }  
+        }  
+    }  
+}   
+```  
+  
+ クライアント エンドポイントは、サービス エンドポイントと同様の方法で構成されます。  クライアントは、同じ `BindingHelper` クラスを使用してバインディングを作成します。  セットアップの残りの部分は、`Client` クラスにあります。  クライアントはクライアント エンドポイントの動作コレクションに対するセットアップ コード内に、ユーザー名セキュリティ トークンに関する情報、サポート X.509 セキュリティ トークン、およびサービス X.509 証明書に関する情報を設定します。  
+  
+```  
+ static void Main()  
+ {  
+     // Create the custom binding and an endpoint address for   
+     // the service.  
+     Binding multipleTokensBinding =   
+         BindingHelper.CreateMultiFactorAuthenticationBinding();  
+         EndpointAddress serviceAddress = new EndpointAddress(  
+         "http://localhost/servicemodelsamples/service.svc");  
+       ChannelFactory<IEchoService> channelFactory = null;  
+       IEchoService client = null;  
+  
+       Console.WriteLine("Username authentication required.");  
+       Console.WriteLine(  
+         "Provide a valid machine or domain account. [domain\\user]");  
+       Console.WriteLine("   Enter username:");  
+       string username = Console.ReadLine();  
+       Console.WriteLine("   Enter password:");  
+       string password = "";  
+       ConsoleKeyInfo info = Console.ReadKey(true);  
+       while (info.Key != ConsoleKey.Enter)  
+       {  
+           if (info.Key != ConsoleKey.Backspace)  
+           {  
+               if (info.KeyChar != '\0')  
+               {  
+                   password += info.KeyChar;  
+                }  
+                info = Console.ReadKey(true);  
+            }  
+            else if (info.Key == ConsoleKey.Backspace)  
+            {  
+                if (password != "")  
+                {  
+                    password =   
+                       password.Substring(0, password.Length - 1);  
+                }  
+                info = Console.ReadKey(true);  
+            }  
+         }  
+         for (int i = 0; i < password.Length; i++)  
+            Console.Write("*");  
+         Console.WriteLine();  
+         try  
+         {  
+           // Create a proxy with the previously create binding and   
+           // endpoint address  
+              channelFactory =   
+                 new ChannelFactory<IEchoService>(  
+                     multipleTokensBinding, serviceAddress);  
+           // configure the username credentials, the client   
+           // certificate and the server certificate on the channel   
+           // factory   
+           channelFactory.Credentials.UserName.UserName = username;  
+           channelFactory.Credentials.UserName.Password = password;  
+           channelFactory.Credentials.ClientCertificate.SetCertificate(  
+           "CN=client.com", StoreLocation.CurrentUser, StoreName.My);  
+              channelFactory.Credentials.ServiceCertificate.SetDefaultCertificate(  
+           "CN=localhost", StoreLocation.LocalMachine, StoreName.My);  
+           client = channelFactory.CreateChannel();  
+           Console.WriteLine("Echo service returned: {0}",   
+                                           client.Echo());  
+  
+           ((IChannel)client).Close();  
+           channelFactory.Close();  
+        }  
+        catch (CommunicationException e)  
+        {  
+         Abort((IChannel)client, channelFactory);  
+         // if there is a fault then print it out  
+         FaultException fe = null;  
+         Exception tmp = e;  
+         while (tmp != null)  
+         {  
+            fe = tmp as FaultException;  
+            if (fe != null)  
+            {  
+                break;  
+            }  
+            tmp = tmp.InnerException;  
+        }  
+        if (fe != null)  
+        {  
+           Console.WriteLine("The server sent back a fault: {0}",   
+         fe.CreateMessageFault().Reason.GetMatchingTranslation().Text);  
+        }  
+        else  
+        {  
+         Console.WriteLine("The request failed with exception: {0}",e);  
+        }  
+    }  
+    catch (TimeoutException)  
+    {  
+        Abort((IChannel)client, channelFactory);  
+        Console.WriteLine("The request timed out");  
+    }  
+    catch (Exception e)  
+    {  
+         Abort((IChannel)client, channelFactory);  
+          Console.WriteLine(  
+          "The request failed with unexpected exception: {0}", e);  
+    }  
+    Console.WriteLine();  
+    Console.WriteLine("Press <ENTER> to terminate client.");  
+    Console.ReadLine();  
+}  
+```  
+  
+## 呼び出し元の情報の表示  
+ 呼び出し元の情報を表示するには、次のコードに示すように `ServiceSecurityContext.Current.AuthorizationContext.ClaimSets` を使用できます。  `ServiceSecurityContext.Current.AuthorizationContext.ClaimSets` には、現在の呼び出し元に関連付けられている承認クレームが含まれています。  こうしたクレームは、メッセージ内で受信した各トークンの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] によって自動的に提供されます。  
+  
+```  
+bool TryGetClaimValue<TClaimResource>(ClaimSet claimSet, string   
+                         claimType, out TClaimResource resourceValue)  
+    where TClaimResource : class  
+{  
+    resourceValue = default(TClaimResource);  
+    IEnumerable<Claim> matchingClaims =   
+    claimSet.FindClaims(claimType, Rights.PossessProperty);  
+    if (matchingClaims == null)  
+          return false;  
+    IEnumerator<Claim> enumerator = matchingClaims.GetEnumerator();  
+    if (enumerator.MoveNext())  
+    {  
+        resourceValue = (enumerator.Current.Resource == null) ? null : (enumerator.Current.Resource as TClaimResource);  
+        return true;  
+    }  
+    else  
+    {  
+         return false;  
+    }  
+}  
+  
+// Returns the username and certificate subject name provided by the client  
+void GetCallerIdentities(ServiceSecurityContext callerSecurityContext, out string userName, out string certificateSubjectName)  
+{  
+    userName = null;  
+    certificateSubjectName = null;  
+  
+    // Look in all the claimsets in the authorization context  
+    foreach (ClaimSet claimSet in   
+      callerSecurityContext.AuthorizationContext.ClaimSets)  
+    {  
+        if (claimSet is WindowsClaimSet)  
+        {  
+            // Try to find a Name claim. This will have been generated   
+            //from the windows username.  
+            string tmpName;  
+            if (TryGetClaimValue<string>(claimSet, ClaimTypes.Name,   
+                                                     out tmpName))  
+            {  
+                userName = tmpName;  
+            }  
+        }  
+        else if (claimSet is X509CertificateClaimSet)  
+         {  
+            //Try to find an X500DisinguishedName claim.   
+            //This will have been generated from the client   
+            //certificate.  
+            X500DistinguishedName tmpDistinguishedName;  
+            if (TryGetClaimValue<X500DistinguishedName>(claimSet,   
+               ClaimTypes.X500DistinguishedName,   
+               out tmpDistinguishedName))  
+            {  
+                    certificateSubjectName = tmpDistinguishedName.Name;  
+            }  
+        }  
+    }  
+}  
+```  
+  
+## サンプルの実行  
+ このサンプルを実行すると、最初にクライアントから、ユーザー名トークンのユーザー名とパスワードを入力するように求められます。  サービス上の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、ユーザー名トークンで提供された値をシステムによって提供される ID にマップするので、必ずシステム アカウントの正しい値を入力してください。  その後、クライアントではサービスからの応答が表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、インターネット インフォメーション サービス \(IIS\) でホストされるアプリケーションを実行できるようになります。このアプリケーションは、サーバー証明書ベースのセキュリティを必要とします。  このバッチ ファイルは、別のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、適切な構成で実行するために変更が必要となる部分を示します。  
+  
+### クライアント証明書の作成  
+ Setup.bat バッチ ファイルの次の行は、使用するクライアント証明書を作成します。  `%CLIENT_NAME%` 変数は、クライアント証明書のサブジェクトを指定します。  このサンプルでは、サブジェクト名として "client.com" を使用します。  
+  
+ 証明書は、`CurrentUser` ストアの場所の My \(Personal\) ストアに保存されます。  
+  
+```  
+echo ************  
+echo making client cert  
+echo ************  
+makecert.exe -sr CurrentUser -ss MY -a sha1 -n CN=%CLIENT_NAME% -sky exchange -pe  
+```  
+  
+### クライアント証明書のサーバーの信頼されたストアへのインストール  
+ Setup.bat バッチ ファイルの次の行は、クライアント証明書をサーバーの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がサーバーのシステムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+```  
+echo ************  
+echo copying client cert to server's CurrentUserstore  
+echo ************  
+certmgr.exe -add -r CurrentUser -s My -c -n %CLIENT_NAME% -r LocalMachine -s TrustedPeople  
+```  
+  
+### サーバー証明書の作成  
+ Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  `%SERVER_NAME%`  変数はサーバー名です。  この変数を変更して、使用するサーバー名を指定します。  このバッチ ファイルでの既定は localhost です。  
+  
+ 証明書は、LocalMachine ストアの場所の My \(Personal\) ストアに保存されます。  証明書は、IIS でホストされるサービスの LocalMachine ストアに保存されます。  自己ホスト型サービスの場合、バッチ ファイルで文字列 LocalMachine を CurrentUser に置き換えて、サーバー証明書を CurrentUser ストアの場所に保存します。  
+  
+```  
+echo ************  
+echo Server cert setup starting  
+echo %SERVER_NAME%  
+echo ************  
+echo making server cert  
+echo ************  
+makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+```  
+  
+### サーバー証明書のクライアントの信頼された証明書ストアへのインストール  
+ Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。  この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。  マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+```  
+echo ************  
+echo copying server cert to client's TrustedPeople store  
+echo ************certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+```  
+  
+### 証明書の秘密キーへのアクセスの有効化  
+ IIS でホストされるサービスから証明書の秘密キーへのアクセスを有効にするには、IIS でホストされる処理が実行されているユーザー アカウントに、秘密キーへの適切なアクセス許可を付与する必要があります。  これは、Setup.bat スクリプトの最後の手順によって実現されます。  
+  
+```  
+echo ************  
+echo setting privileges on server certificates  
+echo ************  
+for /F "delims=" %%i in ('"%ProgramFiles%\ServiceModelSampleTools\FindPrivateKey.exe" My LocalMachine -n CN^=%SERVER_NAME% -a') do set PRIVATE_KEY_FILE=%%i  
+set WP_ACCOUNT=NT AUTHORITY\NETWORK SERVICE  
+(ver | findstr /C:"5.1") && set WP_ACCOUNT=%COMPUTERNAME%\ASPNET  
+echo Y|cacls.exe "%PRIVATE_KEY_FILE%" /E /G "%WP_ACCOUNT%":R  
+iisreset  
+```  
+  
+##### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」を実行したことを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成で実行するか、複数コンピューター構成で実行するかに応じて、次の手順に従います。  
+  
+##### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを実行し、サンプルのインストール フォルダーから Setup.bat を実行します。  これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  サンプルの使用が終わったら、Cleanup.bat を実行して証明書を削除してください。  他のセキュリティ サンプルでも同じ証明書を使用します。  
+  
+2.  Client.exe を \\client\\bin で起動します。  クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+3.  クライアントとサービス間で通信できない場合は、「[トラブルシューティングのヒント](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+##### サンプルを複数コンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。  インターネット インフォメーション サービス \(IIS\) 管理ツールを使用して、このディレクトリ用に servicemodelsamples という仮想アプリケーションを作成します。  
+  
+2.  サービス プログラム ファイルを \\inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの仮想ディレクトリにコピーします。  ファイルのコピー先が \\bin サブディレクトリであることを確認します。  Setup.bat、Cleanup.bat、ImportClientCert.bat の各ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピュータに作成したクライアント ディレクトリにコピーします。  Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。  `setup.bat` に `` `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Web.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat client` を実行します。  `setup.bat`に `client` 引数を指定して実行すると、client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+9. クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。  
+  
+10. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+11. クライアントで ImportServiceCert.bat を実行します。  これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+12. サーバーで ImportClientCert.bat を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+13. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。  クライアントとサービス間で通信できない場合は、「[トラブルシューティングのヒント](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+##### サンプルの実行後にクリーンアップするには  
+  
+-   サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+> [!NOTE]
+>  このサンプルを別のマシンで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。  別のコンピューターで証明書を使用する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。  削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/syndication-extensibility-samples.md b/docs/framework/wcf/samples/syndication-extensibility-samples.md
new file mode 100644
index 00000000000..30fd22c0881
--- /dev/null
+++ b/docs/framework/wcf/samples/syndication-extensibility-samples.md
@@ -0,0 +1,30 @@
+---
+title: "配信の拡張のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b2c34ae5-62ed-4c2d-b2fa-2d4d0802099c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 配信の拡張のサンプル
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のカスタム配信を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [厳密に型指定された拡張](../../../../docs/framework/wcf/samples/strongly-typed-extensions-sample.md)  
+ Atom Threading Extensions の RFC 案で定義された拡張要素を実装する方法を示します。  
+  
+ [フィード フォーマッタ \(JSON\)](../../../../docs/framework/wcf/samples/feed-formatter-json.md)  
+ カスタムの <xref:System.ServiceModel.Syndication.SyndicationFeedFormatter> および <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> を使用することにより JSON \(JavaScript Object Notation\) 形式の <xref:System.ServiceModel.Syndication.SyndicationFeed> クラスのインスタンスをシリアル化する方法を示します。  
+  
+ [ストリーミング フィード](../../../../docs/framework/wcf/samples/streaming-feeds-sample.md)  
+ 多数の項目が含まれた配信フィードを管理する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/syndication.md b/docs/framework/wcf/samples/syndication.md
new file mode 100644
index 00000000000..f8f7aa0e434
--- /dev/null
+++ b/docs/framework/wcf/samples/syndication.md
@@ -0,0 +1,27 @@
+---
+title: "配信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 502c50b2-9982-46af-ac92-53ad9f61d486
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 配信
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 配信を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [スタンドアロン診断フィード](../../../../docs/framework/wcf/samples/stand-alone-diagnostics-feed-sample.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して配信用の RSS フィードおよび Atom フィードを作成する方法を示します。  
+  
+ [弱く型指定された拡張](../../../../docs/framework/wcf/samples/loosely-typed-extensions-sample.md)  
+ 拡張データを処理する基本的な方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/systemwebrouting-integration-sample.md b/docs/framework/wcf/samples/systemwebrouting-integration-sample.md
new file mode 100644
index 00000000000..76a97468c90
--- /dev/null
+++ b/docs/framework/wcf/samples/systemwebrouting-integration-sample.md
@@ -0,0 +1,91 @@
+---
+title: "SystemWebRouting 統合サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f1c94802-95c4-49e4-b1e2-ee9dd126ff93
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# SystemWebRouting 統合サンプル
+このサンプルでは、<xref:System.Web.Routing> 名前空間のクラスとのホスト層の統合を示します。  <xref:System.Web.Routing> 名前空間のクラスを使用すると、物理リソースに直接対応しない URL をアプリケーションで使用できます。  開発者は Web ルーティングを使用することで、後で実際の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにマップされる HTTP の仮想アドレスを作成できます。  これは、物理ファイルやリソースを配置せずに WCF サービスをホストする必要がある場合、または .html や .aspx などのファイルがない URL を使用してサービスにアクセスする必要がある場合に役立ちます。  このサンプルでは、<xref:System.Web.Routing.RouteTable> クラスを使用して、global.asax で定義された実行中のサービスにマップされる仮想 URI を作成する方法を示します。  この例では、`movies` フィードと `channels` フィードという、WCF を使用して作成された 2 つの RSS フィードを使用します。  サービスをアクティブ化する URL に拡張子がなく、<xref:System.Web.HttpApplication.Application_Start%2A> メソッドで登録されています。  
+  
+> [!NOTE]
+>  <xref:System.Web.Routing> 名前空間のクラスは、HTTP でホストされるサービスに対してのみ機能します。  
+  
+> [!NOTE]
+>  このサンプルは、[!INCLUDE[iisver](../../../../includes/iisver-md.md)] でのみ機能します。[!INCLUDE[iis60](../../../../includes/iis60-md.md)] では、拡張子がない URL を別の方法でサポートしています。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WebRoutingIntegration`  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、WebRoutingIntegration.sln ファイルを開きます。  
+  
+2.  ソリューションを実行して Web 開発サーバーを起動するには、F5 キーを押します。  
+  
+     サンプルのディレクトリの一覧が表示されます。  ファイル拡張子が .svc のファイルがないことに注意してください。  
+  
+3.  アドレス バーで、URL が http:\/\/localhost:\[port\]\/movies の形式になるように `movies` を追加し、Enter キーを押します。  
+  
+     movies フィードがブラウザーに表示されます。  
+  
+4.  アドレス バーで、URL が http:\/\/localhost:\[port\]\/channels の形式になるように `channels` を追加し、Enter キーを押します。  
+  
+     channels フィードがブラウザーに表示されます。  
+  
+5.  Alt キーを押しながら F4 キーを押して Web ブラウザーを閉じます。  
+  
+     開発サーバーが終了しない場合は、通知領域アイコンを右クリックし、**\[停止\]** をクリックします。  
+  
+#### このサンプルを使用するには \(IIS でホストする場合\)  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、WebRoutingIntegration.sln ファイルを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、プロジェクトをビルドします。  
+  
+3.  インターネット インフォメーション サービス \(IIS\) マネージャーで Web アプリケーションを作成します。  
+  
+    1.  IIS マネージャーで、**\[既定の Web サイト\]** を右クリックし、**\[アプリケーションの追加\]** をクリックします。  
+  
+    2.  **\[エイリアス\]** に「`WebRoutingIntegration`」と入力します。  
+  
+    3.  **\[物理パス\]** で、プロジェクト内の Service フォルダーを選択します。  
+  
+    4.  **\[OK\]** をクリックします。  
+  
+4.  Web アプリケーションを右クリックし、**\[アプリケーションの管理\]**、**\[参照\]** の順にクリックして、アプリケーションを開始します。  
+  
+5.  アドレス バーで、URL が http:\/\/localhost:\[port\]\/movies の形式になるように `movies` を追加し、Enter キーを押します。  
+  
+     movies フィードがブラウザーに表示されます。  
+  
+6.  アドレス バーで、URL が http:\/\/localhost:\[port\]\/channels の形式になるように `channels` を追加し、Enter キーを押します。  
+  
+     channels フィードがブラウザーに表示されます。  
+  
+7.  Alt キーを押しながら F4 キーを押して Web ブラウザーを閉じます。  
+  
+ このサンプルは、HTTP でホストされたサービスの要求をルーティングするために、<xref:System.Web.Routing> 名前空間のクラスを使用してホスト層を構成できることを示しています。  
+  
+> [!NOTE]
+>  既定のアプリケーション プールのバージョンが 2 に設定されている場合は、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] に更新してください。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/tcp-activation.md b/docs/framework/wcf/samples/tcp-activation.md
new file mode 100644
index 00000000000..6ed46a0f005
--- /dev/null
+++ b/docs/framework/wcf/samples/tcp-activation.md
@@ -0,0 +1,216 @@
+---
+title: "TCP アクティベーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf8c215c-0228-4f4f-85c2-e33794ec09a7
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# TCP アクティベーション
+このサンプルでは、net.tcp プロトコルで通信するサービスをアクティブ化するために、Windows プロセス アクティブ化サービス \(WAS\) を使用してサービスをホストする方法について示します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WASHost\TCPActivation`  
+  
+ このサンプルは、クライアント コンソール プログラム \(.exe\) と、WAS によってアクティブ化されるワーカー プロセス内でホストされるサービス ライブラリ \(.dll\) で構成されています。  クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+ サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。  コントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(Add、Subtract、Multiply、および Divide\) を公開しています。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+ このサービス実装は、計算を行い、結果を返します。  
+  
+```  
+// Service class that implements the service contract.  
+public class CalculatorService : ICalculator  
+{  
+    public double Add(double n1, double n2)  
+    {  
+        return n1 + n2;  
+    }  
+    public double Subtract(double n1, double n2)  
+    {  
+        return n1 - n2;  
+    }  
+    public double Multiply(double n1, double n2)  
+    {  
+        return n1 * n2;  
+    }  
+    public double Divide(double n1, double n2)  
+    {  
+        return n1 / n2;  
+    }  
+}  
+```  
+  
+ このサンプルでは、TCP ポート共有が有効でセキュリティが無効になっている net.tcp バインディングの変化形を使用します。  セキュリティ保護された TCP バインディングを使用する場合は、サーバーのセキュリティ モードを必要な設定に変更し、クライアントで Svcutil.exe を再実行して更新クライアントの構成ファイルを生成します。  
+  
+ サービスの構成を次のサンプルに示します。  
+  
+```  
+<system.serviceModel>  
+  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- This endpoint is exposed at the base address provided by host: net.tcp://localhost/servicemodelsamples/service.svc  -->  
+        <endpoint binding="netTcpBinding" bindingConfiguration="PortSharingBinding"  
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+        <!-- the mex endpoint is explosed at net.tcp://localhost/servicemodelsamples/service.svc/mex -->  
+        <endpoint address="mex"  
+                  binding="mexTcpBinding"  
+                  contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <netTcpBinding>  
+        <binding name="PortSharingBinding" portSharingEnabled="true">  
+          <security mode="None" />  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+  
+    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceMetadata />  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+```  
+  
+ クライアントのエンドポイントが構成されます。次のサンプル コードを参照してください。  
+  
+```  
+<system.serviceModel>  
+    <bindings>  
+        <netTcpBinding>  
+          <binding name="NetTcpBinding_ICalculator">  
+            <security mode="None"/>  
+          </binding>  
+        </netTcpBinding>  
+    </bindings>  
+    <client>  
+        <endpoint address="net.tcp://localhost/servicemodelsamples/service.svc"  
+            binding="netTcpBinding" bindingConfiguration="NetTcpBinding_ICalculator"  
+            contract="Microsoft.ServiceModel.Samples.ICalculator" name="NetTcpBinding_ICalculator" />  
+    </client>  
+</system.serviceModel>  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] がインストールされていることを確認します。  [!INCLUDE[iisver](../../../../includes/iisver-md.md)] は WAS のアクティブ化に必要です。  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+     さらに、HTTP 以外の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アクティベーション コンポーネントをインストールする必要があります。  
+  
+    1.  **\[スタート\]** メニューの **\[コントロール パネル\]** をクリックします。  
+  
+    2.  **\[プログラムと機能\]** をクリックします。  
+  
+    3.  **\[Turn Windows Components on or Off\]** をクリックします。  
+  
+    4.  **\[Microsoft .NET Framework 3.0\]** ノードを展開し、**\[Windows Communication Foundation Non\-HTTP Activation\]** 機能をオンにします。  
+  
+3.  TCP アクティベーションをサポートするよう WAS を構成します。  
+  
+     便宜上次の 2 つの手順が、サンプル ディレクトリにある AddNetTcpSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  net.tcp アクティベーションをサポートするには、既定の Web サイトをあらかじめ net.tcp ポートにバインドしておく必要があります。  これは、インターネット インフォメーション サービス 7.0 \(IIS\) 管理ツール セットと共にインストールされる Appcmd.exe を使用して行います。  管理者レベルのコマンド プロンプトから、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']  
+        ```  
+  
+        > [!TIP]
+        >  このコマンドはテキスト 1 行です。  このコマンドは、net.tcp サイト バインディングを、TCP ポート 808 で任意のホスト名をリッスンする既定の Web サイトに追加します。  
+  
+    2.  サイト内のすべてのアプリケーションが同じ net.tcp バインディングを共有しますが、net.tcp サポートの有効化はアプリケーションごとに指定できます。  \/servicemodelsamples アプリケーションで net.tcp を有効にするには、管理者レベルのコマンド プロンプトから、次のコマンドを実行します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app   
+        "Default Web Site/servicemodelsamples" /enabledProtocols:http,net.tcp  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドはテキスト 1 行です。  このコマンドにより、\/servicemodelsamples アプリケーションに http:\/\/localhost\/servicemodelsamples と net.tcp:\/\/localhost\/servicemodelsamples のどちらを使用してもアクセスできるようになります。  
+  
+4.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+     このサンプル用に追加した net.tcp サイト バインディングを削除します。  
+  
+     便宜上次の 2 つの手順が、サンプル ディレクトリにある RemoveNetTcpSiteBinding.cmd というバッチ ファイルに実装されています。  
+  
+    1.  管理者レベルのコマンド プロンプトから次のコマンドを実行して、有効なプロトコルの一覧から net.tcp を削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set app   
+        "Default Web Site/servicemodelsamples" /enabledProtocols:http  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。  
+  
+    2.  管理者レベルのコマンド プロンプトから次のコマンドを実行して、net.tcp サイト バインディングを削除します。  
+  
+        ```  
+        %windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"   
+        --bindings.[protocol='net.tcp',bindingInformation='808:*']  
+        ```  
+  
+        > [!NOTE]
+        >  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/throttling.md b/docs/framework/wcf/samples/throttling.md
new file mode 100644
index 00000000000..1482fe4ce93
--- /dev/null
+++ b/docs/framework/wcf/samples/throttling.md
@@ -0,0 +1,94 @@
+---
+title: "調整 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービスの動作, 調整のサンプル"
+  - "調整のサンプル [Windows Communication Foundation]"
+ms.assetid: 40bb3582-8ae9-4410-96f0-6c515bfaf47c
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# 調整
+調整のサンプルでは、調整コントロールの使用方法を示します。調整コントロールは、同時呼び出し、同時インスタンス、または同時セッションの数を制限して、リソースの過剰消費を防ぎます。調整の動作は、サービス構成ファイルの設定で指定されます。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービス構成ファイルでは、[\<serviceThrottling\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicethrottling.md)内で調整コントロールを指定します。次のサンプル構成を参照してください。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="CalculatorServiceBehavior">  
+      <serviceDebug includeExceptionDetailInFaults="False" />  
+      <serviceMetadata httpGetEnabled="True"/>  
+      <!-- Specify throttling behavior -->  
+    <serviceThrottling maxConcurrentCalls="2"  
+                       maxConcurrentInstances="10"/>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ 上記の構成では、サービスは同時呼び出しの最大数を 2 に、同時インスタンスの最大数を 10 に制限しています。  
+  
+ 調整の例を示すため、サービス メソッド上でスリープ時間を次のように定義しています。  
+  
+```  
+public double Add(double n1, double n2)  
+{  
+    System.Threading.Thread.Sleep(2000);  
+    return n1 + n2;  
+}  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。Add メソッドと Subtract メソッドは同時に実行され、Multiply メソッドと Divide メソッドは同時に実行されます。このようにして、同時実行できるメソッドは 2 つ以下であることが証明され、調整の例が示されます。  
+  
+```  
+  
+Press <ENTER> to terminate client.  
+Add(100,15.99)  
+Subtract(145,76.54)  
+Multiply(9,81.25)  
+Divide(22,7)  
+  
+Add Result: 115.99  
+Subtract Result: 68.46  
+Multiply Result: 731.25  
+Divide Result: 3.14285714285714  
+  
+Press any key to continue . . .  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Behaviors\Throttling`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/token-authenticator.md b/docs/framework/wcf/samples/token-authenticator.md
new file mode 100644
index 00000000000..29fb5ac0c4f
--- /dev/null
+++ b/docs/framework/wcf/samples/token-authenticator.md
@@ -0,0 +1,381 @@
+---
+title: "トークン認証システム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84382f2c-f6b1-4c32-82fa-aebc8f6064db
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# トークン認証システム
+このサンプルでは、カスタム トークンの認証システムを実装する方法を示します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトークン認証システムは、メッセージと共に使用されるトークンの検証、このトークンに自己矛盾がないことの確認、およびこのトークンに関連付けられている ID の認証に使用されます。  
+  
+ カスタム トークン認証システムは次のようなさまざまな場合に役立ちます。  
+  
+-   トークンに関連付けられた既定の認証機構をオーバーライドする場合。  
+  
+-   カスタム トークンを構築している場合。  
+  
+ このサンプルでは、次の方法を示します。  
+  
+-   クライアントがユーザー名\/パスワードの組み合わせを使用して認証する方法。  
+  
+-   サーバーがカスタム トークン認証システムを使用してクライアント資格情報を検証する方法。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス コードとカスタム トークン認証システムを結び付ける方法。  
+  
+-   サーバーの X.509 証明書を使用してそのサーバーを認証する方法。  
+  
+ さらにこのサンプルでは、カスタム トークン認証システムの処理後に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] から呼び出し元の ID にアクセスするための方法も示します。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは App.config 構成ファイルで定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングの構成には、標準の `wsHttpBinding` が使用されます。このセキュリティ モードは、`wsHttpBinding` の既定モードであるメッセージに設定されます。このサンプルは、標準の `wsHttpBinding` を設定してクライアントのユーザー名認証を使用します。また、サービスは `serviceCredentials` 動作を使用してサービス証明書の構成も行います。`securityCredentials` 動作を使用すると、サービス証明書を指定できます。クライアントはサービス証明書を使用して、サービスを認証し、メッセージを保護します。次の構成では、次のセットアップ手順で説明しているサンプル セットアップでインストールされる localhost 証明書を参照しています。  
+  
+```  
+<system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <!-- configure base address provided by host -->  
+            <add baseAddress ="http://localhost:8000/servicemodelsamples/service" />  
+          </baseAddresses>  
+        </host>  
+        <!-- use base address provided by host -->  
+        <endpoint address=""  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--   
+          The serviceCredentials behavior allows one to define a service certificate.  
+          A service certificate is used by a client to authenticate the service and provide message protection.  
+          This configuration references the "localhost" certificate installed during the setup instructions.  
+....        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+ クライアント エンドポイント構成は、構成名、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、適切な `Mode` と `clientCredentialType` で構成されます。  
+  
+```  
+<system.serviceModel>  
+    <client>  
+      <endpoint name=""  
+                address="http://localhost:8000/servicemodelsamples/service"   
+                binding="wsHttpBinding"   
+                bindingConfiguration="Binding1"   
+                contract="Microsoft.ServiceModel.Samples.ICalculator">  
+      </endpoint>  
+    </client>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  </system.serviceModel>  
+```  
+  
+ クライアント実装では、使用するユーザー名とパスワードが設定されます。  
+  
+```  
+static void Main()  
+{  
+     ...  
+     client.ClientCredentials.UserNamePassword.UserName = username;  
+     client.ClientCredentials.UserNamePassword.Password = password;  
+     ...  
+}  
+```  
+  
+## カスタム トークン認証システム  
+ カスタム トークン認証システムを作成するには、次の手順に従います。  
+  
+1.  カスタム トークン認証システムを作成します。  
+  
+     このサンプルは、ユーザー名が有効な電子メール形式であることを検証するカスタム トークン認証システムを実装しています。この実装は <xref:System.IdentityModel.Selectors.UserNameSecurityTokenAuthenticator> から派生します。このクラスで最も重要なメソッドは <xref:System.IdentityModel.Selectors.UserNameSecurityTokenAuthenticator.ValidateUserNamePasswordCore%28System.String%2CSystem.String%29> です。このメソッドで、認証システムはユーザー名の形式を検証し、さらに、ホスト名が非承認のドメインのものでないことを検証します。どちらの条件も満たされる場合は、<xref:System.IdentityModel.Policy.IAuthorizationPolicy> インスタンスの読み取り専用のコレクションを返します。次にこれを使用して、ユーザー名トークン内に格納されている情報を表すクレームを指定します。  
+  
+    ```  
+    protected override ReadOnlyCollection<IAuthorizationPolicy> ValidateUserNamePasswordCore(string userName, string password)  
+    {  
+        if (!ValidateUserNameFormat(userName))  
+            throw new SecurityTokenValidationException("Incorrect UserName format");  
+  
+        ClaimSet claimSet = new DefaultClaimSet(ClaimSet.System, new Claim(ClaimTypes.Name, userName, Rights.PossessProperty));  
+        List<IIdentity> identities = new List<IIdentity>(1);  
+        identities.Add(new GenericIdentity(userName));  
+        List<IAuthorizationPolicy> policies = new List<IAuthorizationPolicy>(1);  
+        policies.Add(new UnconditionalPolicy(ClaimSet.System, claimSet, DateTime.MaxValue.ToUniversalTime(), identities));  
+        return policies.AsReadOnly();  
+    }  
+    ```  
+  
+2.  カスタム トークン認証システムによって返された承認ポリシーを指定します。  
+  
+     このサンプルでは、`UnconditionalPolicy` という名前の <xref:System.IdentityModel.Policy.IAuthorizationPolicy> の独自の実装を示します。これにより、コンストラクター内でこのポリシーに渡されたクレームと ID のセットが返されます。  
+  
+    ```  
+    class UnconditionalPolicy : IAuthorizationPolicy  
+    {  
+        String id = Guid.NewGuid().ToString();  
+        ClaimSet issuer;  
+        ClaimSet issuance;  
+        DateTime expirationTime;  
+        IList<IIdentity> identities;  
+  
+        public UnconditionalPolicy(ClaimSet issuer, ClaimSet issuance, DateTime expirationTime, IList<IIdentity> identities)  
+        {  
+            if (issuer == null)  
+                throw new ArgumentNullException("issuer");  
+            if (issuance == null)  
+                throw new ArgumentNullException("issuance");  
+  
+            this.issuer = issuer;  
+            this.issuance = issuance;  
+            this.identities = identities;  
+            this.expirationTime = expirationTime;  
+        }  
+  
+        public string Id  
+        {  
+            get { return this.id; }  
+        }  
+  
+        public ClaimSet Issuer  
+        {  
+            get { return this.issuer; }  
+        }  
+  
+        public DateTime ExpirationTime  
+        {  
+            get { return this.expirationTime; }  
+        }  
+  
+        public bool Evaluate(EvaluationContext evaluationContext, ref object state)  
+        {  
+            evaluationContext.AddToTarget(this, this.issuance);  
+  
+            if (this.identities != null)  
+            {  
+                object value;  
+                IList<IIdentity> contextIdentities;  
+                if (!evaluationContext.Properties.TryGetValue("Identities", out value))  
+                {  
+                    contextIdentities = new List<IIdentity>(this.identities.Count);  
+                    evaluationContext.Properties.Add("Identities", contextIdentities);  
+                }  
+                else  
+                {  
+                    contextIdentities = value as IList<IIdentity>;  
+                }  
+                foreach (IIdentity identity in this.identities)  
+                {  
+                    contextIdentities.Add(identity);  
+                }  
+            }  
+  
+            evaluationContext.RecordExpirationTime(this.expirationTime);  
+            return true;  
+        }  
+    }  
+    ```  
+  
+3.  カスタム セキュリティ トークン マネージャーを作成します。  
+  
+     <xref:System.IdentityModel.Selectors.SecurityTokenManager> は、`CreateSecurityTokenAuthenticator` メソッド内でカスタム セキュリティ トークン マネージャーに渡される特定の <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> オブジェクトを対象とした <xref:System.IdentityModel.Selectors.SecurityTokenAuthenticator> の作成に使用されます。セキュリティ トークン マネージャーは、トークン プロバイダーとトークン シリアライザーの作成にも使用されますが、このサンプルでは扱っていません。このサンプルでは、カスタム セキュリティ トークン マネージャーは <xref:System.ServiceModel.Security.ServiceCredentialsSecurityTokenManager> クラスを継承し、渡されたトークンの要件でユーザー名認証システムが必要であることが示されている場合に、`CreateSecurityTokenAuthenticator` メソッドをオーバーライドしてユーザー名トークンのカスタム認証システムを返します。  
+  
+    ```  
+  
+    public class MySecurityTokenManager : ServiceCredentialsSecurityTokenManager  
+    {  
+        MyUserNameCredential myUserNameCredential;  
+  
+        public MySecurityTokenManager(MyUserNameCredential myUserNameCredential)  
+            : base(myUserNameCredential)  
+        {  
+            this.myUserNameCredential = myUserNameCredential;  
+        }  
+  
+        public override SecurityTokenAuthenticator CreateSecurityTokenAuthenticator(SecurityTokenRequirement tokenRequirement, out SecurityTokenResolver outOfBandTokenResolver)  
+        {  
+            if (tokenRequirement.TokenType ==  SecurityTokenTypes.UserName)  
+            {  
+                outOfBandTokenResolver = null;  
+                return new MyTokenAuthenticator();  
+            }  
+            else  
+            {  
+                return base.CreateSecurityTokenAuthenticator(tokenRequirement, out outOfBandTokenResolver);  
+            }  
+        }  
+    }  
+    ```  
+  
+4.  カスタム サービス資格情報を作成します。  
+  
+     サービス資格情報クラスは、サービス用に構成された資格情報を表すために使用され、トークン認証システム、トークン プロバイダー、およびトークン シリアライザーの取得に使用されるセキュリティ トークン マネージャーを作成します。  
+  
+    ```  
+    public class MyUserNameCredential : ServiceCredentials  
+    {  
+  
+        public MyUserNameCredential()  
+            : base()  
+        {  
+        }  
+  
+        protected override ServiceCredentials CloneCore()  
+        {  
+            return new MyUserNameCredential();  
+        }  
+  
+        public override SecurityTokenManager CreateSecurityTokenManager()  
+        {  
+            return new MySecurityTokenManager(this);  
+        }  
+  
+    }  
+    ```  
+  
+5.  カスタム サービス資格情報を使用するようサービスを構成します。  
+  
+     サービスでカスタム サービス資格情報を使用するには、既定のサービス資格情報に事前構成されているサービス証明書をキャプチャした後で既定のサービス資格情報クラスを削除し、事前構成されているサービス証明書を使用するよう新しいサービス資格情報のインスタンスを構成します。さらに、この新しいサービス資格情報のインスタンスをサービス動作に追加します。  
+  
+    ```  
+    ServiceCredentials sc = serviceHost.Credentials;  
+    X509Certificate2 cert = sc.ServiceCertificate.Certificate;  
+    MyUserNameCredential serviceCredential = new MyUserNameCredential();  
+    serviceCredential.ServiceCertificate.Certificate = cert;  
+    serviceHost.Description.Behaviors.Remove((typeof(ServiceCredentials)));  
+    serviceHost.Description.Behaviors.Add(serviceCredential);  
+    ```  
+  
+ 呼び出し元の情報を表示するには、次のコードに示すように <xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> を使用できます。<xref:System.ServiceModel.ServiceSecurityContext.Current%2A> には、現在のユーザーに関するクレーム情報が保持されています。  
+  
+```  
+static void DisplayIdentityInformation()  
+{  
+    Console.WriteLine("\t\tSecurity context identity  :  {0}",   
+            ServiceSecurityContext.Current.PrimaryIdentity.Name);  
+     return;  
+}  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、適切な構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。`%SERVER_NAME%` 変数はユーザー名を指定します。この変数を変更して、使用するサーバー名を指定します。このバッチ ファイルでの既定は localhost です。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+    > [!NOTE]
+    >  セットアップ バッチ ファイルは、Windows SDK コマンド プロンプトから実行します。MSSDK 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Windows SDK コマンド プロンプトで自動設定されます。  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  service.exe を \\service\\bin で起動します。  
+  
+3.  client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サービス コンピューターのサービス ディレクトリにコピーします。Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  コンピューターの完全修飾ドメイン名を含むサブジェクト名を持つサーバー証明書が必要です。新しい証明書名を反映するには、サービスの App.config ファイルを更新する必要があります。`%SERVER_NAME%` 変数を、サービスを実行するコンピューターの完全修飾ホスト名に設定している場合は、Setup.bat を使用してこの証明書を作成できます。setup.bat ファイルは、管理特権を使用して開いた Visual Studio コマンド プロンプトから実行する必要があります。  
+  
+4.  サーバー証明書をクライアントの CurrentUser\-TrustedPeople ストアにコピーします。サーバー証明書の発行元をクライアントが信頼できる場合を除き、この操作は不要です。  
+  
+5.  サービス コンピューターの App.config ファイルで、ベース アドレスの値を localhost から完全修飾コンピューター名に変更します。  
+  
+6.  サービス コンピューターで、コマンド プロンプトから service.exe を実行します。  
+  
+7.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+10. クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/token-provider.md b/docs/framework/wcf/samples/token-provider.md
new file mode 100644
index 00000000000..2c6b376bea5
--- /dev/null
+++ b/docs/framework/wcf/samples/token-provider.md
@@ -0,0 +1,308 @@
+---
+title: "トークン プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 947986cf-9946-4987-84e5-a14678d96edb
+caps.latest.revision: 22
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 22
+---
+# トークン プロバイダー
+このサンプルでは、カスタム トークン プロバイダーを実装する方法を示します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のトークン プロバイダーは、資格情報をセキュリティ インフラストラクチャに提供するために使用します。一般的に、トークン プロバイダーは、ターゲットをチェックし、適切な証明書を発行して、セキュリティ インフラストラクチャがメッセージのセキュリティを保護できるようにします。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、既定の Credential Manager Token Provider が付属しています。また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、[!INCLUDE[infocard](../../../../includes/infocard-md.md)] トークン プロバイダーも付属しています。カスタム トークン プロバイダーは、次の場合に便利です。  
+  
+-   トークン プロバイダーが連携動作できない資格情報ストアがある場合。  
+  
+-   資格情報をユーザーが詳細を提供した時点から [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアント フレームワークが資格情報を使用した時点に変換するための、独自のカスタム メカニズムを提供する場合。  
+  
+-   カスタム トークンを構築している場合。  
+  
+ このサンプルでは、ユーザーの入力を別の形式に変換するカスタム トークン プロバイダーを構築する方法を示します。  
+  
+ このサンプルに示されている手順の概要は次のとおりです。  
+  
+-   クライアントがユーザー名\/パスワードの組み合わせを使用して認証する方法。  
+  
+-   クライアントをカスタム トークン プロバイダーを使用して構成する手順。  
+  
+-   サーバーが、ユーザー名とパスワードが一致していることを検証するカスタム <xref:System.IdentityModel.Selectors.UserNamePasswordValidator> とパスワードを使用して、クライアント資格情報を検証する手順。  
+  
+-   サーバーがクライアントによってサーバーの X.509 証明書を使用して認証される手順。  
+  
+ さらにこのサンプルでは、カスタム トークン認証システムの処理後に、呼び出し元の ID にアクセスするための方法も示します。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは App.config 構成ファイルで定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングの構成には、標準の `wsHttpBinding` が使用されます。これは既定でメッセージ セキュリティを使用します。このサンプルは、標準の `wsHttpBinding` を設定してクライアントのユーザー名認証を使用します。また、サービスは serviceCredentials 動作を使用してサービス証明書の構成も行います。serviceCredentials 動作を使用すると、サービス証明書を構成できます。クライアントはサービス証明書を使用して、サービスを認証し、メッセージを保護します。次の構成では、次のセットアップ手順で説明しているサンプル セットアップでインストールされる localhost 証明書を参照しています。  
+  
+```  
+<system.serviceModel>  
+    <services>  
+      <service   
+          name="Microsoft.ServiceModel.Samples.CalculatorService"  
+          behaviorConfiguration="CalculatorServiceBehavior">  
+        <host>  
+          <baseAddresses>  
+            <!-- configure base address provided by host -->  
+            <add baseAddress ="http://localhost:8000/servicemodelsamples/service"/>  
+          </baseAddresses>  
+        </host>  
+        <!-- use base address provided by host -->  
+        <endpoint address=""  
+                  binding="wsHttpBinding"  
+                  bindingConfiguration="Binding1"   
+                  contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+    </services>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <binding name="Binding1">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceDebug includeExceptionDetailInFaults="False" />  
+          <!--   
+        The serviceCredentials behavior allows one to define a service certificate.  
+        A service certificate is used by a client to authenticate the service and provide message protection.  
+        This configuration references the "localhost" certificate installed during the setup instructions.  
+        -->  
+          <serviceCredentials>  
+            <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+  
+```  
+  
+ クライアント エンドポイント構成は、構成名、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、適切な `Mode` およびメッセージ `clientCredentialType` で構成されます。  
+  
+```  
+<system.serviceModel>  
+  <client>  
+    <endpoint name=""  
+              address="http://localhost:8000/servicemodelsamples/service"   
+              binding="wsHttpBinding"   
+              bindingConfiguration="Binding1"   
+              contract="Microsoft.ServiceModel.Samples.ICalculator">  
+    </endpoint>  
+  </client>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <binding name="Binding1">  
+        <security mode="Message">  
+          <message clientCredentialType="UserName" />  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+ カスタム トークン プロバイダーを開発して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のセキュリティ フレームワークに統合する方法を、次の手順に示します。  
+  
+1.  カスタム トークン プロバイダーを作成します。  
+  
+     サンプルでは、ユーザー名とパスワードを取得するカスタム トークン プロバイダーを実装します。パスワードは、このユーザー名と一致する必要があります。このカスタム トークン プロバイダーは、デモンストレーション用にのみ作成されたものです。実環境に展開することは推奨されません。  
+  
+     このタスクを実行するため、カスタム トークン プロバイダーは <xref:System.IdentityModel.Selectors.SecurityTokenProvider> クラスを派生し、<xref:System.IdentityModel.Selectors.SecurityTokenProvider.GetTokenCore%28System.TimeSpan%29> メソッドをオーバーライドします。このメソッドは、新しい `UserNameSecurityToken` を作成して返します。  
+  
+    ```  
+    protected override SecurityToken GetTokenCore(TimeSpan timeout)  
+    {  
+        // obtain username and password from the user using console window  
+        string username = GetUserName();  
+        string password = GetPassword();  
+        Console.WriteLine("username: {0}", username);  
+  
+        // return new UserNameSecurityToken containing information obtained from user  
+        return new UserNameSecurityToken(username, password);  
+    }  
+  
+    ```  
+  
+2.  カスタム セキュリティ トークン マネージャーを作成します。  
+  
+     <xref:System.IdentityModel.Selectors.SecurityTokenManager> は、特定の <xref:System.IdentityModel.Selectors.SecurityTokenRequirement> \(`CreateSecurityTokenProvider` メソッドで渡されます\) に対する <xref:System.IdentityModel.Selectors.SecurityTokenProvider> を作成するために使用されます。セキュリティ トークン マネージャーは、トークン認証システムとトークン シリアライザーの作成にも使用されますが、このサンプルでは扱っていません。このサンプルでは、カスタム セキュリティ トークン マネージャーは <xref:System.ServiceModel.ClientCredentialsSecurityTokenManager> クラスを継承し、渡されたトークンの要件でユーザー名プロバイダーが必要であることが示されている場合に、`CreateSecurityTokenProvider` メソッドをオーバーライドして、カスタムのユーザー名トークン プロバイダーを返します。  
+  
+    ```  
+    public class MyUserNameSecurityTokenManager : ClientCredentialsSecurityTokenManager  
+    {  
+        MyUserNameClientCredentials myUserNameClientCredentials;  
+  
+        public MyUserNameSecurityTokenManager(MyUserNameClientCredentials myUserNameClientCredentials)  
+            : base(myUserNameClientCredentials)  
+        {  
+            this.myUserNameClientCredentials = myUserNameClientCredentials;  
+        }  
+  
+        public override SecurityTokenProvider CreateSecurityTokenProvider(SecurityTokenRequirement tokenRequirement)  
+        {  
+            // if token requirement matches username token return custom username token provider  
+            // otherwise use base implementation  
+            if (tokenRequirement.TokenType == SecurityTokenTypes.UserName)  
+            {  
+                return new MyUserNameTokenProvider();  
+            }  
+            else  
+            {  
+                return base.CreateSecurityTokenProvider(tokenRequirement);  
+            }  
+        }  
+    }  
+    ```  
+  
+3.  カスタム クライアント資格情報を作成します。  
+  
+     クライアント資格情報クラスは、クライアント プロキシ用に構成された資格情報を表すために使用され、トークン認証システム、トークン プロバイダー、およびトークン シリアライザーの取得に使用されるセキュリティ トークン マネージャーを作成します。  
+  
+    ```  
+    public class MyUserNameClientCredentials : ClientCredentials  
+    {  
+        public MyUserNameClientCredentials()  
+            : base()  
+        {  
+        }  
+  
+        protected override ClientCredentials CloneCore()  
+        {  
+            return new MyUserNameClientCredentials();  
+        }  
+  
+        public override SecurityTokenManager CreateSecurityTokenManager()  
+        {  
+            // return custom security token manager  
+            return new MyUserNameSecurityTokenManager(this);  
+        }  
+    }  
+    ```  
+  
+4.  カスタム クライアント資格情報を使用するようクライアントを構成します。  
+  
+     クライアントがカスタム クライアント資格情報を使用するため、サンプルでは既定のクライアント資格情報を削除し、新しいクライアント資格情報クラスを提供しています。  
+  
+    ```  
+    static void Main()  
+    {  
+        // ...  
+           // Create a client with given client endpoint configuration  
+          CalculatorClient client = new CalculatorClient();  
+  
+          // set new credentials  
+           client.ChannelFactory.Endpoint.Behaviors.Remove(typeof(ClientCredentials));  
+         client.ChannelFactory.Endpoint.Behaviors.Add(new MyUserNameClientCredentials());  
+       // ...  
+    }  
+  
+    ```  
+  
+ サービス側で呼び出し元の情報を表示するには、次のコード例に示すように <xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> を使用します。<xref:System.ServiceModel.ServiceSecurityContext.Current%2A> には、現在のユーザーに関する情報が保持されています。  
+  
+```  
+static void DisplayIdentityInformation()  
+{  
+    Console.WriteLine("\t\tSecurity context identity  :  {0}",   
+        ServiceSecurityContext.Current.PrimaryIdentity.Name);  
+}  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。`%SERVER_NAME%` 変数はユーザー名を指定します。この変数を変更して、使用するサーバー名を指定します。このバッチ ファイルでの既定値は localhost です。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+-   クライアントの信頼された証明書ストアへのサーバー証明書のインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+  
+    ```  
+  
+> [!NOTE]
+>  Setup.bat バッチ ファイルは、Windows SDK コマンド プロンプトから実行します。MSSDK 環境変数が SDK のインストール ディレクトリを指している必要があります。この環境変数は、Windows SDK コマンド プロンプトで自動設定されます。  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  service.exe を \\service\\bin で起動します。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  username プロンプトに対してユーザー名を入力します。  
+  
+5.  password プロンプトに対して、username プロンプトで入力したものと同じ文字列を入力します。  
+  
+6.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サービス コンピューターのサービス ディレクトリにコピーします。Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  コンピューターの完全修飾ドメイン名を含むサブジェクト名を持つサーバー証明書が必要です。新しい証明書名を反映するには、Service.exe.config ファイルを更新する必要があります。サーバー証明書を作成するには、Setup.bat バッチ ファイルを変更します。setup.bat ファイルは、管理特権を使用して開いた Visual Studio コマンド プロンプトから実行する必要があります。`%SERVER_NAME%` 変数には、サービスをホストするコンピューターの完全修飾ホスト名を設定する必要があります。  
+  
+4.  サーバー証明書をクライアントの CurrentUser\-TrustedPeople ストアにコピーします。この操作は、サーバー証明書の発行元をクライアントが信頼できる場合は不要です。  
+  
+5.  サービス コンピューターの Service.exe.config ファイルで、ベース アドレスの値を localhost から完全修飾コンピューター名に変更します。  
+  
+6.  サービス コンピューターで、コマンド プロンプトから service.exe を実行します。  
+  
+7.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント コンピューターで、コマンド プロンプト ウィンドウから `Client.exe` を起動します。  
+  
+10. クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/tool-samples.md b/docs/framework/wcf/samples/tool-samples.md
new file mode 100644
index 00000000000..ab219400de7
--- /dev/null
+++ b/docs/framework/wcf/samples/tool-samples.md
@@ -0,0 +1,30 @@
+---
+title: "ツール サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ccf90c64-31de-4a18-9208-28887735ce80
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ツール サンプル
+このセクションでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] ツールについて説明します。  
+  
+## このセクションの内容  
+ [ConfigurationCodeGenerator](../../../../docs/framework/wcf/samples/configurationcodegenerator.md)  
+ ConfigurationCodeGenerator.exe ツールを使用して、カスタム チャネルの実装を構成システムに公開する方法について説明します。  
+  
+ [CustomChannelTester](../../../../docs/framework/wcf/samples/customchannelstester.md)  
+ CustomChannelsTester.exe ツールを使用して、カスタム チャネルの実装を、定義済みのサービス コントラクト セットに対してテストする方法について説明します。  
+  
+ [FindPrivateKey](../../../../docs/framework/wcf/samples/findprivatekey.md)  
+ FindPrivateKey.exe ツールを使用して、証明書ストア内の特定の X.509 証明書に関連付けられている秘密キー ファイルの場所と名前を見つけるプロセスを容易にする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/tracing-and-message-logging.md b/docs/framework/wcf/samples/tracing-and-message-logging.md
new file mode 100644
index 00000000000..4de2f00d031
--- /dev/null
+++ b/docs/framework/wcf/samples/tracing-and-message-logging.md
@@ -0,0 +1,147 @@
+---
+title: "トレースとメッセージ ログ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "トレースとログ"
+ms.assetid: a4f39bfc-3c5e-4d51-a312-71c5c3ce0afd
+caps.latest.revision: 53
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 53
+---
+# トレースとメッセージ ログ
+このサンプルでは、トレースとメッセージ ログを有効にする方法を示します。結果のトレースとメッセージ ログは、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md) を使用することによって表示されます。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+## トレース  
+ [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] では、<xref:System.Diagnostics> 名前空間で定義されたトレース機構が使用されます。このトレース モデルのトレース データは、アプリケーションが実装するトレース ソースによって作成されます。各ソースは、名前によって識別されます。トレース コンシューマでは、情報を取得するトレース ソースのトレース リスナが作成されます。トレース データを受け取るには、トレース ソースのリスナを作成する必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でこれを行うには、サービス モデルのトレース ソース `switchValue` を設定することにより、次のコードをサービスまたはクライアントのどちらかの構成ファイルに追加します。  
+  
+```  
+<system.diagnostics>  
+    <sources>  
+      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"  
+        propagateActivity="true">  
+        <listeners>  
+          <add name="xml" />  
+        </listeners>  
+      </source>  
+      <source name="System.ServiceModel.MessageLogging">  
+        <listeners>  
+          <add name="xml" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add initializeData="C:\logs\TracingAndLogging-service.svclog" type="System.Diagnostics.XmlWriterTraceListener"  
+        name="xml" />  
+    </sharedListeners>  
+    <trace autoflush="true" />  
+</system.diagnostics>  
+```  
+  
+ トレース ソースの詳細については、「[トレースの構成](../../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」トピックの「トレース ソース」セクションを参照してください。  
+  
+## アクティビティのトレースと伝達  
+ クライアントとサービスの両方の `system.ServiceModel` トレース ソースで `ActivityTracing` を有効にして `propagateActivity` を `true` に設定することにより、処理の論理単位 \(アクティビティ\) 内や、エンドポイント内のアクティビティ間 \(アクティビティ転送を使用\)、および複数のエンドポイントにわたるアクティビティ間 \(アクティビティ ID の伝達を使用\) で、トレースを相互に関連付けることができます。  
+  
+ 3 つの機構 \(アクティビティ、転送、および伝達\) により、サービス トレース ビューア ツールを使用してエラーの根本原因をより迅速に見つけることができます。詳細については、「[サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)」を参照してください。  
+  
+ ユーザー定義のアクティビティ トレースを作成することにより、サービス モデルによって提供されるトレースを拡張することができます。ユーザー定義のアクティビティ トレースによって、次の操作を可能にするトレース アクティビティを作成できます。  
+  
+-   複数のトレースを作業の論理単位ごとにグループ化します。  
+  
+-   転送や伝達を利用してアクティビティを相互に関連付けます。  
+  
+-   [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トレースのパフォーマンスの負荷 \(ログ ファイルによるディスク領域の負荷など\) を軽減します。  
+  
+ ユーザー定義のアクティビティ トレースの詳細については、「[トレースの拡張](../../../../docs/framework/wcf/samples/extending-tracing.md)」のサンプルを参照してください。  
+  
+## メッセージ ログ  
+ メッセージ ログは、任意の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションのクライアントとサービスの両方で有効にできます。メッセージ ログを有効にするには、クライアントとサービスのどちらかに次のコードを追加する必要があります。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <diagnostics>  
+      <!-- Enable Message Logging here. -->  
+      <!-- log all messages received or sent at the transport or service model levels >  
+      <messageLogging logEntireMessage="true"  
+                      maxMessagesToLog="300"  
+                      logMessagesAtServiceLevel="true"  
+                      logMalformedMessages="true"  
+                      logMessagesAtTransportLevel="true" />  
+    </diagnostics>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ メッセージが記録されるときのトレースの種類は、そのメッセージがクライアントでトレースされるか、またはサーバーでトレースされるかによって異なります。たとえば、クライアントに送信される "Add" メッセージは、クライアントでは "TransportWrite" カテゴリの下でトレースされるのに対し、サービスでは同じメッセージが "TransportRead" カテゴリの下でトレースされます。  
+  
+ クライアントの App.config ファイルまたはサービスの Web.config ファイルの <xref:System.Diagnostics> セクションに次のコードを追加して、トレース リスナを構成します。  
+  
+```  
+<system.diagnostics>  
+    <sources>  
+      <source name="System.ServiceModel" switchValue="Information,ActivityTracing"  
+        propagateActivity="true">  
+        <listeners>  
+          <add name="xml" />  
+        </listeners>  
+      </source>  
+      <source name="System.ServiceModel.MessageLogging">  
+        <listeners>  
+          <add name="xml" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add initializeData="C:\logs\TracingAndLogging-client.svclog" type="System.Diagnostics.XmlWriterTraceListener"  
+        name="xml" />  
+    </sharedListeners>  
+    <trace autoflush="true" />  
+  </system.diagnostics>  
+```  
+  
+ メッセージは、構成ファイルで指定された対象ディレクトリ内に XML 形式で記録されます。  
+  
+> [!NOTE]
+>  最初にログ ディレクトリが作成されていないと、トレース ファイルは作成されません。ディレクトリ C:\\logs\\ が存在することを確認するか、またはリスナの構成でログ記録用の代替ディレクトリを指定します。詳細については、このドキュメントの最後にある初期セットアップ手順を参照してください。  
+  
+ メッセージ ログの詳細については、トピック「[メッセージ ログの構成](../../../../docs/framework/wcf/diagnostics/configuring-message-logging.md)」を参照してください。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  トレースとメッセージ ログのサンプルを実行する前に、サービスによって .svclog ファイルが書き込まれるディレクトリ C:\\logs\\ を作成します。このディレクトリ名は、トレースとメッセージがログ記録されるパスとして、構成ファイル内で定義されます。この名前は変更可能です。ユーザー Network Service に、そのログ ディレクトリへの書き込みアクセスを与えます。  
+  
+3.  ソリューションの C\# 版、C\+\+ 版、または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\TracingAndLogging`  
+  
+## 参照  
+ [トレース](../../../../docs/framework/wcf/diagnostics/tracing/index.md)   
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transacted-batching.md b/docs/framework/wcf/samples/transacted-batching.md
new file mode 100644
index 00000000000..971ad6e3762
--- /dev/null
+++ b/docs/framework/wcf/samples/transacted-batching.md
@@ -0,0 +1,386 @@
+---
+title: "トランザクション バッチ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ecd328ed-332e-479c-a894-489609bcddd2
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# トランザクション バッチ
+このサンプルでは、メッセージ キュー \(MSMQ\) を使用して、トランザクション読み取りをバッチ処理する方法を示します。  トランザクション バッチは、キューを使用する通信でトランザクション読み取りのパフォーマンスを最適化するための機能です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。  厳密には、クライアントはメッセージをキューに送信します。  サービスは、メッセージをキューから受信します。  したがって、キューを使用する通信では、サービスとクライアントが同時に実行されていなくてもかまいません。  
+  
+ このサンプルでは、トランザクション バッチを示します。  トランザクション バッチの動作では、キューに置かれた多数のメッセージを読み取ってそれを処理するために使用するトランザクションが 1 つで済みます。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。  キューが存在しない場合、サービスによってキューが作成されます。  最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。  Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、`「ServiceModelSamplesTransacted」`と入力します。  
+  
+    > [!NOTE]
+    >  このサンプルでは、クライアントは多数のメッセージをバッチの一部として送信します。  通常、サービス アプリケーションがこれらを処理するのに多少の時間がかかります。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### ワークグループに属しているコンピューターまたは Active Directory 統合のないコンピューターでこのサンプルを実行するには  
+  
+1.  <xref:System.ServiceModel.NetMsmqBinding> を使用する場合の既定では、トランスポート セキュリティが有効です。  MSMQ トランスポート セキュリティに関係するプロパティには、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> と <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> の 2 つがあります。既定の設定では、認証モードは `Windows`、保護レベルは `Sign` です。  MSMQ の認証機能と署名機能を利用するには、ドメインに MSMQ があることと、MSMQ に関する Active Directory の統合オプションがインストールされていることが必要です。  この条件を満たしていないコンピューターでこのサンプルを実行すると、エラーになります。  
+  
+2.  ドメインに属していないコンピュータ、または Active Directory 統合がインストールされていないコンピュータを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを `None` にします。この構成の例を次に示します。  
+  
+    ```  
+    <system.serviceModel>  
+      <behaviors>  
+        <serviceBehaviors>  
+          <behavior name="ThrottlingBehavior">  
+            <serviceMetadata httpGetEnabled="true"/>  
+            <serviceThrottling maxConcurrentCalls="5"/>  
+          </behavior>  
+        </serviceBehaviors>  
+  
+        <endpointBehaviors>  
+          <behavior name="BatchingBehavior">  
+            <transactedBatching maxBatchSize="100"/>  
+          </behavior>  
+        </endpointBehaviors>  
+      </behaviors>  
+      <services>  
+        <service   
+            behaviorConfiguration="ThrottlingBehavior"   
+            name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+          <host>  
+            <baseAddresses>  
+              <add baseAddress="http://localhost:8000/orderProcessor/transactedBatchingSample"/>  
+            </baseAddresses>  
+          </host>  
+          <!-- Define NetMsmqEndpoint -->  
+          <endpoint address="net.msmq://localhost/private/ServiceModelSamplesTransactedBatching"  
+                    binding="netMsmqBinding"  
+                    bindingConfiguration="Binding1"   
+                    behaviorConfiguration="BatchingBehavior"   
+                    contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+          <endpoint address="mex"  
+                    binding="mexHttpBinding"  
+                    contract="IMetadataExchange" />  
+        </service>  
+      </services>  
+  
+      <bindings>  
+        <netMsmqBinding>  
+          <binding name="Binding1">  
+            <security mode="None" />  
+          </binding>  
+        </netMsmqBinding>  
+      </bindings>  
+  
+    </system.serviceModel>  
+  
+    ```  
+  
+3.  サーバーとクライアントの両方の構成を変更したことを確認してから、サンプルを実行します。  
+  
+    > [!NOTE]
+    >  `security` `mode` を `None` に設定することは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A>、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A>、および `Message` のセキュリティを `None` に設定することと同じです。  
+  
+4.  データベースをリモート コンピューターで実行するには、接続文字列をデータベースが存在するコンピューターを指すように変更します。  
+  
+## 必要条件  
+ このサンプルを実行するには、MSMQ をインストールする必要があります。さらに、SQL または SQL Express が必要です。  
+  
+## 使用例  
+ このサンプルはトランザクション バッチ動作を示します。  トランザクション バッチは、MSMQ キューを使用したトランスポートで提供されるパフォーマンス最適化機能です。  
+  
+ メッセージの送受信にトランザクションが使用されている場合、実際には 2 つの別個のトランザクションが存在しています。  クライアントがトランザクションのスコープ内でメッセージを送信する場合、トランザクションはクライアントおよびクライアント キュー マネージャにとってローカルとなります。  サービスがトランザクションのスコープ内でメッセージを受信する場合、トランザクションはサービスおよび受信キュー マネージャにとってローカルとなります。  クライアントとサービスは同じトランザクションに参加していません。むしろ、キューに対して操作 \(送信や受信など\) を実行する場合は異なるトランザクションを使用することに注意してください。  
+  
+ このサンプルでは、複数のサービス操作を実行する際に単一のトランザクションを使用します。  これはパフォーマンス最適化機能としてのみ使用されるもので、アプリケーションのセマンティクスには影響しません。  このサンプルは、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」に基づいています。  
+  
+## コメント  
+ このサンプルでは、クライアントはトランザクションのスコープ内からメッセージのバッチをサービスに送信します。  パフォーマンスの最適化を示すために、この例では最大 2,500 という多数のメッセージを送信します。  
+  
+ キューに送信されたメッセージは、サービスによって定義されたトランザクション スコープ内のサービスによって受信されます。  バッチ処理が行われない場合、2,500 のトランザクションが実行され、そのたびにサービス操作が呼び出されます。  これはシステムのパフォーマンスに影響します。  MSMQ キューと `Orders` データベースという 2 つのリソース マネージャが含まれているので、このようなトランザクションはそれぞれ DTC トランザクションです。  これを最適化するには、単一のトランザクション内でメッセージとサービス操作の呼び出しのバッチを発生させることによって、使用するトランザクション数を大幅に減らします。  
+  
+ 次の手順により、バッチ機能を使用します。  
+  
+-   トランザクション バッチ動作を構成で指定します。  
+  
+-   単一のトランザクションを使用していくつのメッセージを読み取るかという観点から、バッチ サイズを指定します。  
+  
+-   同時に実行するバッチの最大数を指定します。  
+  
+ この例では、100 のサービス操作を単一のトランザクションで呼び出してからトランザクションをコミットするという方法でトランザクションの数を減らすことにより、パフォーマンスの向上を示します。  
+  
+ サービス動作は、`TransactionScopeRequired` が `true` に設定された操作動作を定義します。  これにより、キューからのメッセージの取得に使用されるものと同じトランザクション スコープが、このメソッドによってアクセスされる任意のリソース マネージャにより使用されます。  この例では、基本的なデータベースを使用してメッセージに含まれる発注書情報を保存します。  さらにトランザクション スコープでは、メソッドから例外がスローされた場合にメッセージがキューに返されることも保証されます。  このサービス動作を設定しない場合、キューに置かれたチャネルはトランザクションを作成して、キューからのメッセージを読み取り、操作が失敗した場合には、ディスパッチによってメッセージが失われる前に、自動的にそのメッセージをコミットします。  最もよく見られるシナリオは、キューからのメッセージの読み込みに使用するトランザクションにサービス操作を登録することです。次のコードを参照してください。  
+  
+ `ReleaseServiceInstanceOnTransactionComplete` が `false` に設定されていることに注意してください。  これはバッチ処理の重要な要件です。  `ServiceBehaviorAttribute` のプロパティ `ReleaseServiceInstanceOnTransactionComplete` は、トランザクションが完了した後のサービス インスタンスの処理方法を示します。  既定では、トランザクションが完了するとサービス インスタンスは解放されます。  バッチ処理の主な特徴は、キューに置かれた多数のメッセージを読み取ってディスパッチするために単一のトランザクションを使用する点です。  そのため、サービス インスタンスが解放されると、実際にバッチ処理が行われる前にトランザクションが完了することになります。  このプロパティが `true` に設定され、トランザクション バッチ動作がエンドポイントに追加された場合、このバッチ処理の検証動作は例外をスローします。  
+  
+```  
+// Service class that implements the service contract.  
+// Added code to write output to the console window.  
+[ServiceBehavior(ReleaseServiceInstanceOnTransactionComplete=false,   
+TransactionIsolationLevel=  
+System.Transactions.IsolationLevel.Serializable, ConcurrencyMode=ConcurrencyMode.Multiple)]  
+public class OrderProcessorService : IOrderProcessor  
+{  
+    [OperationBehavior(TransactionScopeRequired = true,  
+                       TransactionAutoComplete = true)]  
+    public void SubmitPurchaseOrder(PurchaseOrder po)  
+    {  
+        Orders.Add(po);  
+        Console.WriteLine("Processing {0} ", po);  
+    }  
+    …  
+}  
+  
+```  
+  
+ `Orders` クラスは、注文処理機能をカプセル化します。  サンプルでは、このクラスは発注書情報を使用してデータベースを更新します。  
+  
+```  
+// Order Processing Logic  
+public class Orders  
+{  
+    public static void Add(PurchaseOrder po)  
+    {  
+        // Insert purchase order.  
+        SqlCommand insertPurchaseOrderCommand =   
+        new SqlCommand(  
+        "insert into PurchaseOrders(poNumber, customerId)   
+                               values(@poNumber, @customerId)");  
+        insertPurchaseOrderCommand.Parameters.Add("@poNumber",   
+                                           SqlDbType.VarChar, 50);  
+        insertPurchaseOrderCommand.Parameters.Add("@customerId",   
+                                         SqlDbType.VarChar, 50);  
+  
+        // Insert product line item.  
+        SqlCommand insertProductLineItemCommand =   
+             new SqlCommand("insert into ProductLineItems(productId,   
+                    unitCost, quantity, poNumber) values(@productId,   
+                    @unitCost, @quantity, @poNumber)");  
+        insertProductLineItemCommand.Parameters.Add("@productId",   
+                                           SqlDbType.VarChar, 50);  
+        insertProductLineItemCommand.Parameters.Add("@unitCost",   
+                                                  SqlDbType.Float);  
+        insertProductLineItemCommand.Parameters.Add("@quantity",   
+                                                     SqlDbType.Int);  
+        insertProductLineItemCommand.Parameters.Add("@poNumber",   
+                                           SqlDbType.VarChar, 50);  
+        int rowsAffected = 0;  
+        using (TransactionScope scope =   
+              new TransactionScope(TransactionScopeOption.Required))  
+        {  
+             using (SqlConnection conn = new   
+                 SqlConnection(  
+                 ConfigurationManager.AppSettings["connectionString"]))  
+             {  
+                 conn.Open();  
+  
+                // Insert into purchase order table.  
+               insertPurchaseOrderCommand.Connection = conn;  
+               insertPurchaseOrderCommand.Parameters["@poNumber"].Value   
+                                                       = po.PONumber;  
+             insertPurchaseOrderCommand.Parameters["@customerId"].Value   
+                                                    =po.CustomerId;  
+             insertPurchaseOrderCommand.ExecuteNonQuery();  
+  
+            // Insert into product line item table.  
+            insertProductLineItemCommand.Connection = conn;  
+            foreach (PurchaseOrderLineItem orderLineItem in   
+                                        po.orderLineItems) {  
+            insertProductLineItemCommand.Parameters["@poNumber"].Value   
+                                                          =po.PONumber;  
+            insertProductLineItemCommand.Parameters["@productId"].Value   
+                                             = orderLineItem.ProductId;  
+            insertProductLineItemCommand.Parameters["@unitCost"].Value   
+                                             = orderLineItem.UnitCost;  
+            insertProductLineItemCommand.Parameters["@quantity"].Value   
+                                             = orderLineItem.Quantity;  
+            rowsAffected +=   
+            insertProductLineItemCommand.ExecuteNonQuery();  
+            }  
+            scope.Complete();  
+        }  
+     }  
+     Console.WriteLine(  
+     "Updated database with {0} product line items  for purchase order   
+                                     {1} ", rowsAffected, po.PONumber);  
+    }  
+}  
+```  
+  
+ バッチ動作とその構成は、サービス アプリケーションの構成で指定されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <appSettings>  
+    <!-- Use appSetting to configure MSMQ queue name. -->  
+    <add key="queueName"   
+     value=".\private$\ServiceModelSamplesTransactedBatching" />  
+    <add key="baseAddress"   
+     value=  
+     "http://localhost:8000/orderProcessor/transactedBatchingSample"/>  
+    <add key="connectionString" value="Data Source=.\SQLEXPRESS;AttachDbFilename=|DataDirectory|orders.mdf;Integrated Security=True;User Instance=True;" />  
+  </appSettings>  
+  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="ThrottlingBehavior">  
+          <serviceThrottling maxConcurrentCalls="5"/>  
+        </behavior>  
+      </serviceBehaviors>  
+  
+      <endpointBehaviors>  
+        <behavior name="BatchingBehavior">  
+          <transactedBatching maxBatchSize="100"/>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+    <services>  
+      <service   
+          behaviorConfiguration="ThrottlingBehavior"   
+          name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+        <!-- Define NetMsmqEndpoint -->  
+        <endpoint address=  
+"net.msmq://localhost/private/ServiceModelSamplesTransactedBatching"  
+                  binding="netMsmqBinding"  
+                  behaviorConfiguration="BatchingBehavior"   
+                  contract=  
+                    "Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+      </service>  
+    </services>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+> [!NOTE]
+>  バッチ サイズにより、システムの動作が決まります。  たとえば、バッチ サイズを 20 に指定した場合、20 のメッセージが単一トランザクションを使用して読み取られてディスパッチされ、その後トランザクションがコミットされます。  しかし、そのバッチ サイズに達する前にトランザクションがバッチをコミットする場合もあります。  
+>   
+>  各トランザクションにはタイムアウトが関連付けられています。これはトランザクションが作成された後に時間刻みを開始します。  このタイムアウト時間が経過すると、トランザクションは中止されます。  バッチ サイズに達していなくてもタイムアウト時間が経過する可能性があります。  中止された後でバッチを再動作させないようにするため、`TransactedBatchingBehavior` はトランザクションの残り時間を確認します。  トランザクションのタイムアウトが 80% 経過すると、トランザクションはコミットされます。  
+>   
+>  キューのメッセージがなくなると、<xref:System.ServiceModel.Description.TransactedBatchingBehavior> はバッチ サイズに達するまで待機する代わりに、トランザクションをコミットします。  
+>   
+>  バッチ サイズの選択は、アプリケーションに依存します。  バッチ サイズが小さすぎると、必要なパフォーマンスを実現できません。  逆にバッチ サイズが大きすぎると、パフォーマンスが低下する場合があります。  たとえば、トランザクションが長期間有効でデータベースのロックを保持したり、またはトランザクションがデッドロック状態になる場合があります。この場合、バッチはロール バックされて作業がやり直しになる可能性があります。  
+  
+ クライアントはトランザクション スコープを作成します。  キューとの通信はトランザクションのスコープ内で実行されるため、すべてのメッセージがキューに送信されるか、またはメッセージがキューにまったく送信されないかを示す、アトミック単位として扱われます。  トランザクションは、トランザクション スコープで <xref:System.Transactions.TransactionScope.Complete%2A> を呼び出すことでコミットされます。  
+  
+```  
+//Client implementation code.  
+class Client  
+{  
+    static void Main()  
+    {  
+        Random randomGen = new Random();  
+        for (int i = 0; i < 2500; i++)  
+        {  
+            // Create a client with given client endpoint configuration.  
+            OrderProcessorClient client = new OrderProcessorClient("OrderProcessorEndpoint");  
+  
+            // Create the purchase order.  
+            PurchaseOrder po = new PurchaseOrder();  
+            po.CustomerId = "somecustomer" + i + ".com";  
+            po.PONumber = Guid.NewGuid().ToString();  
+  
+            PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+            lineItem1.ProductId = "Blue Widget";  
+            lineItem1.Quantity = randomGen.Next(1, 100);  
+            lineItem1.UnitCost = (float)randomGen.NextDouble() * 10;  
+  
+            PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+            lineItem2.ProductId = "Red Widget";  
+            lineItem2.Quantity = 890;  
+            lineItem2.UnitCost = 45.89F;  
+  
+            po.orderLineItems = new PurchaseOrderLineItem[2];  
+            po.orderLineItems[0] = lineItem1;  
+            po.orderLineItems[1] = lineItem2;  
+  
+            //Create a transaction scope.  
+            using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+            {  
+                // Make a queued call to submit the purchase order.  
+                client.SubmitPurchaseOrder(po);  
+                // Complete the transaction.  
+                scope.Complete();  
+            }  
+  
+            client.Close();  
+        }  
+        Console.WriteLine();  
+        Console.WriteLine("Press <ENTER> to terminate client.");  
+        Console.ReadLine();  
+    }  
+}  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。  サービスがクライアントから受信したメッセージを表示できます。  どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。  クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  メッセージがバッチ内で読み取られて処理された際には、ロール出力を表示できます。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Updated database with 2 product line items for purchase order 493ac832-d216-4e94-b2a5-d7f492fb5e39  
+Processing Purchase Order: 8b567f5b-0661-4662-aae2-6cef1bd6d278  
+        Customer: somecustomer849.com  
+        OrderDetails  
+               Order LineItem: 80 of Blue Widget @unit price: $9.751623  
+               Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $41622.23  
+        Order status: Pending  
+  
+Updated database with 2 product line items for purchase order 41130b95-4ea8-40a9-91c3-2e129117fcb8  
+Processing Purchase Order: 5ce2699d-9a31-4cc2-a8c5-64cda614b3c7  
+        Customer: somecustomer850.com  
+        OrderDetails  
+               Order LineItem: 89 of Blue Widget @unit price: $6.369128  
+               Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $41408.95  
+        Order status: Pending  
+  
+Updated database with 2 product line items for purchase order 8b567f5b-0661-4662-aae2-6cef1bd6d278  
+Processing Purchase Order: ea94486b-7c86-4309-a42d-2f06c00656cd  
+        Customer: somecustomer851.com  
+        OrderDetails  
+             Order LineItem: 47 of Blue Widget @unit price: $0.9391424  
+             Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $40886.24  
+        Order status: Pending  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\Batching`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transacted-msmq-binding.md b/docs/framework/wcf/samples/transacted-msmq-binding.md
new file mode 100644
index 00000000000..2ac0f49cbfa
--- /dev/null
+++ b/docs/framework/wcf/samples/transacted-msmq-binding.md
@@ -0,0 +1,253 @@
+---
+title: "トランザクション MSMQ バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 71f5cb8d-f1df-4e1e-b8a2-98e734a75c37
+caps.latest.revision: 50
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 50
+---
+# トランザクション MSMQ バインディング
+このサンプルでは、メッセージ キュー \(MSMQ\) を使用して、トランザクション キューによる通信を実行する方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。厳密には、クライアントはメッセージをキューに送信します。サービスは、メッセージをキューから受信します。このため、キューを使用する通信では、サービスとクライアントは同時に実行されていなくてもかまいません。  
+  
+ メッセージの送受信にトランザクションが使用されている場合、実際には 2 つの別個のトランザクションが存在しています。クライアントがトランザクションのスコープ内でメッセージを送信する場合、トランザクションはクライアントおよびクライアント キュー マネージャにとってローカルとなります。サービスがトランザクションのスコープ内でメッセージを受信する場合、トランザクションはサービスおよび受信キュー マネージャにとってローカルとなります。クライアントとサービスは同じトランザクションに参加していません。むしろ、キューに対して操作 \(送信や受信など\) を実行する場合は異なるトランザクションを使用するので、注意してください。  
+  
+ このサンプルでは、クライアントはトランザクションのスコープ内からメッセージのバッチをサービスに送信します。キューに送信されたメッセージは、サービスによって定義されたトランザクション スコープ内のサービスによって受信されます。  
+  
+ サービス コントラクトは `IOrderProcessor` です。次のサンプル コードを参照してください。インターフェイスは、キューでの使用に適した一方向サービスを定義します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void SubmitPurchaseOrder(PurchaseOrder po);  
+}  
+```  
+  
+ サービス動作は、`TransactionScopeRequired` が `true` に設定された操作動作を定義します。これにより、キューからのメッセージの取得に使用されるものと同じトランザクション スコープが、このメソッドによってアクセスされる任意のリソース マネージャにより使用されます。さらに、メソッドから例外がスローされた場合にメッセージがキューに返されることも保証されます。このサービス動作を設定しない場合、キューに置かれたチャネルはトランザクションを作成して、キューからのメッセージを読み取り、操作が失敗した場合には、ディスパッチによってメッセージが失われる前に、自動的にそのメッセージをコミットします。最もよく見られるシナリオは、キューからのメッセージの読み込みに使用するトランザクションにサービス操作をリストすることです。次のコードを参照してください。  
+  
+```  
+  
+ // This service class that implements the service contract.  
+ // This added code writes output to the console window.  
+ public class OrderProcessorService : IOrderProcessor  
+ {  
+     [OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+     public void SubmitPurchaseOrder(PurchaseOrder po)  
+     {  
+         Orders.Add(po);  
+         Console.WriteLine("Processing {0} ", po);  
+     }  
+  …  
+}  
+  
+```  
+  
+ サービスは自己ホスト型です。MSMQ トランスポートを使用する場合、使用するキューをあらかじめ作成しておく必要があります。手動で作成することもコードで作成することもできます。このサンプルでは、キューの存在を確認して、存在しない場合は作成するためのコードがサービスに含まれています。キュー名は構成ファイルから読み込まれます。ベース アドレスは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で使用され、サービスにプロキシが生成されます。  
+  
+```  
+// Host the service within this EXE console application.  
+public static void Main()  
+{  
+    // Get the MSMQ queue name from appSettings in configuration.  
+    string queueName = ConfigurationManager.AppSettings["queueName"];  
+  
+    // Create the transacted MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName, true);  
+  
+    // Create a ServiceHost for the OrderProcessorService type.  
+    using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))  
+    {  
+        // Open the ServiceHost to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+  
+        // Close the ServiceHost to shut down the service.  
+        serviceHost.Close();  
+    }  
+}  
+  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションに指定されます。次のサンプル構成を参照してください。  
+  
+```  
+<appSettings>  
+    <add key="queueName" value=".\private$\ServiceModelSamplesTransacted" />  
+</appSettings>  
+```  
+  
+> [!NOTE]
+>  <xref:System.Messaging> を使用してキューを作成する場合、キュー名では、ローカル コンピューターを表すのにドット \(.\) を使用し、パスの区切りにはバックスラッシュを使用します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] エンドポイントでは net.msmq スキームが含まれるキュー アドレスを使用します。ローカル コンピューターを表すのに "localhost" を使用し、パスの区切りにはスラッシュを使用します。  
+  
+ クライアントはトランザクション スコープを作成します。キューとの通信はトランザクションのスコープ内で実行され、すべてのメッセージがキューに送信されるか、またはメッセージがキューにまったく送信されないかを示す、atomic 単位として扱われます。トランザクションは、トランザクション スコープで <xref:System.Transactions.TransactionScope.Complete%2A> を呼び出すことでコミットされます。  
+  
+```  
+// Create a client.  
+OrderProcessorClient client = new OrderProcessorClient();  
+  
+// Create the purchase order.  
+PurchaseOrder po = new PurchaseOrder();  
+po.CustomerId = "somecustomer.com";  
+po.PONumber = Guid.NewGuid().ToString();  
+  
+PurchaseOrderLineItem lineItem1 = new PurchaseOrderLineItem();  
+lineItem1.ProductId = "Blue Widget";  
+lineItem1.Quantity = 54;  
+lineItem1.UnitCost = 29.99F;  
+  
+PurchaseOrderLineItem lineItem2 = new PurchaseOrderLineItem();  
+lineItem2.ProductId = "Red Widget";  
+lineItem2.Quantity = 890;  
+lineItem2.UnitCost = 45.89F;  
+  
+po.orderLineItems = new PurchaseOrderLineItem[2];  
+po.orderLineItems[0] = lineItem1;  
+po.orderLineItems[1] = lineItem2;  
+  
+// Create a transaction scope.  
+using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+{  
+    // Make a queued call to submit the purchase order.  
+    client.SubmitPurchaseOrder(po);  
+    // Complete the transaction.  
+    scope.Complete();  
+}  
+  
+// Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+Console.WriteLine();  
+Console.WriteLine("Press <ENTER> to terminate client.");  
+Console.ReadLine();  
+```  
+  
+ トランザクションが動作していることを確認するには、次のサンプル コードで示すようにトランザクション スコープをコメント化してクライアントを変更し、ソリューションを再ビルドしてクライアントを実行します。  
+  
+```  
+//scope.Complete();  
+```  
+  
+ トランザクションは完了していないので、メッセージはキューに送信されません。  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信するようすがわかります。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Processing Purchase Order: 7b31ce51-ae7c-4def-9b8b-617e4288eafd  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。キューが存在しない場合、サービスによってキューが作成されます。最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、「`ServiceModelSamplesTransacted`」と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+ <xref:System.ServiceModel.NetMsmqBinding> を使用する場合の既定では、トランスポート セキュリティが有効です。MSMQ トランスポート セキュリティには、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> および <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> という 2 つの関連プロパティがあります。既定では、認証モードは `Windows` に、保護レベルは `Sign` に、それぞれ設定されます。MSMQ で認証機能と署名機能を実現するには、MSMQ をドメインに含め、MSMQ の Active Directory 統合オプションをインストールする必要があります。この条件を満たしていないコンピューターでこのサンプルを実行すると、エラーになります。  
+  
+### ワークグループに属しているコンピューターまたは Active Directory 統合のないコンピューターでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピューター、または Active Directory 統合がインストールされていないコンピューターを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを `None` にします。この構成コードの例を次に示します。  
+  
+    ```  
+    <system.serviceModel>  
+      <services>  
+        <service name="Microsoft.ServiceModel.Samples.OrderProcessorService"  
+                 behaviorConfiguration="OrderProcessorServiceBehavior">  
+          <host>  
+            <baseAddresses>  
+              <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+            </baseAddresses>  
+          </host>  
+          <!-- Define NetMsmqEndpoint. -->  
+          <endpoint  
+              address="net.msmq://localhost/private/ServiceModelSamplesTransacted"  
+              binding="netMsmqBinding"  
+              bindingConfiguration="Binding1"  
+           contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+          <!-- The mex endpoint is explosed at http://localhost:8000/ServiceModelSamples/service/mex. -->  
+          <endpoint address="mex"  
+                    binding="mexHttpBinding"  
+                    contract="IMetadataExchange" />  
+        </service>  
+      </services>  
+  
+      <bindings>  
+        <netMsmqBinding>  
+          <binding name="Binding1">  
+            <security mode="None" />  
+          </binding>  
+        </netMsmqBinding>  
+      </bindings>  
+  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="OrderProcessorServiceBehavior">  
+              <serviceMetadata httpGetEnabled="True"/>  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+  
+      </system.serviceModel>  
+  
+    ```  
+  
+2.  サーバーとクライアントの両方の構成を変更したことを確認してから、サンプルを実行します。  
+  
+    > [!NOTE]
+    >  `security` `mode` を `None` に設定することは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A>、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A>、および `Message` のセキュリティを `None` に設定することと同じです。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\Transacted`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transport-custom-transactions-over-udp-sample.md b/docs/framework/wcf/samples/transport-custom-transactions-over-udp-sample.md
new file mode 100644
index 00000000000..0a21a666aed
--- /dev/null
+++ b/docs/framework/wcf/samples/transport-custom-transactions-over-udp-sample.md
@@ -0,0 +1,274 @@
+---
+title: "トランスポート : UDP 経由のカスタム トランザクションのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6cebf975-41bd-443e-9540-fd2463c3eb23
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# トランスポート : UDP 経由のカスタム トランザクションのサンプル
+このサンプルは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の「[トランスポート拡張](../../../../docs/framework/wcf/samples/transport-extensibility.md)」にある「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」サンプルに基づいています。ここでは、カスタム トランザクション フローをサポートするように UDP トランスポートのサンプルを拡張し、<xref:System.ServiceModel.Channels.TransactionMessageProperty> プロパティの使用方法について説明します。  
+  
+## UDP トランスポート サンプルのコードの変更  
+ トランザクション フローを示すため、サンプルでは、`ICalculatorContract` のサービス コントラクトが `CalculatorService.Add()` のトランザクション スコープを要求するように変更されています。また、サンプルでは、別の `System.Guid` パラメータを `Add` 操作のコントラクトに追加します。このパラメータは、クライアント トランザクションの識別子をサービスに渡すために使用されます。  
+  
+```  
+class CalculatorService : IDatagramContract, ICalculatorContract  
+{  
+    [OperationBehavior(TransactionScopeRequired=true)]  
+    public int Add(int x, int y, Guid clientTransactionId)  
+    {  
+        if(Transaction.Current.TransactionInformation.DistributedIdentifier == clientTransactionId)  
+    {  
+        Console.WriteLine("The client transaction has flowed to the service");  
+    }  
+    else  
+    {  
+     Console.WriteLine("The client transaction has NOT flowed to the service");  
+    }  
+  
+    Console.WriteLine("   adding {0} + {1}", x, y);              
+    return (x + y);  
+    }  
+  
+    [...]  
+}  
+```  
+  
+ 「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルでは、UDP パケットを使用してクライアントとサービス間でメッセージを渡します。「[Transport: Custom Transport Sample](../../../../docs/framework/wcf/samples/transport-custom-transactions-over-udp-sample.md)」でも同じメッセージ トランスポート機構を使用しますが、トランザクションはフローされるときに、エンコードされたメッセージと共に UDP パケットに挿入されます。  
+  
+```  
+byte[] txmsgBuffer =                TransactionMessageBuffer.WriteTransactionMessageBuffer(txPropToken, messageBuffer);  
+  
+int bytesSent = this.socket.SendTo(txmsgBuffer, 0, txmsgBuffer.Length, SocketFlags.None, this.remoteEndPoint);  
+```  
+  
+ `TransactionMessageBuffer.WriteTransactionMessageBuffer` は、メッセージ エンティティを使用して現在のトランザクションの反映トークンをマージし、それをバッファに配置する新しい機能を持つヘルパー メソッドです。  
+  
+ カスタム トランザクション フローのトランスポートの場合、クライアント実装では、トランザクション フローが必要なサービス操作と、この情報を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に渡す必要があるサービス操作を把握している必要があります。また、ユーザー トランザクションをトランスポート層に転送するための機構もあります。このサンプルでは、"[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ インスペクタ" を使用して、この情報を取得します。ここで実装されるクライアント メッセージ インスペクタは `TransactionFlowInspector` と呼ばれ、次のタスクを実行します。  
+  
+-   指定されたメッセージ アクションに対してトランザクションをフローする必要があるかどうかを判断します \(これは `IsTxFlowRequiredForThisOperation()` で行われます\)。  
+  
+-   トランザクションをフローする必要がある場合、`TransactionFlowProperty` を使用して現在のアンビエント トランザクションをメッセージにアタッチします \(これは `BeforeSendRequest()` で行われます\)。  
+  
+```  
+public class TransactionFlowInspector : IClientMessageInspector  
+{  
+   void IClientMessageInspector.AfterReceiveReply(ref           System.ServiceModel.Channels.Message reply, object correlationState)  
+  {  
+  }  
+  
+   public object BeforeSendRequest(ref System.ServiceModel.Channels.Message request, System.ServiceModel.IClientChannel channel)  
+   {  
+       // obtain the tx propagation token  
+       byte[] propToken = null;             
+       if (Transaction.Current != null && IsTxFlowRequiredForThisOperation(request.Headers.Action))  
+       {  
+           try  
+           {  
+               propToken = TransactionInterop.GetTransmitterPropagationToken(Transaction.Current);  
+           }  
+           catch (TransactionException e)  
+           {  
+              throw new CommunicationException("TransactionInterop.GetTransmitterPropagationToken failed.", e);  
+           }  
+       }  
+  
+      // set the propToken on the message in a TransactionFlowProperty  
+       TransactionFlowProperty.Set(propToken, request);  
+  
+       return null;              
+    }  
+  }  
+  
+  static bool IsTxFlowRequiredForThisOperation(String action)  
+ {  
+       // In general, this should contain logic to identify which operations (actions)      require transaction flow.  
+      [...]  
+ }  
+}  
+  
+```  
+  
+ `TransactionFlowInspector` 自体は、カスタム動作 `TransactionFlowBehavior` を使用してフレームワークに渡されます。  
+  
+```  
+public class TransactionFlowBehavior : IEndpointBehavior  
+{  
+       public void AddBindingParameters(ServiceEndpoint endpoint,            System.ServiceModel.Channels.BindingParameterCollection bindingParameters)  
+      {  
+      }  
+  
+       public void ApplyClientBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.ClientRuntime clientRuntime)  
+      {  
+            TransactionFlowInspector inspector = new TransactionFlowInspector();  
+            clientRuntime.MessageInspectors.Add(inspector);  
+      }  
+  
+      public void ApplyDispatchBehavior(ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.EndpointDispatcher endpointDispatcher)  
+     {  
+     }  
+  
+      public void Validate(ServiceEndpoint endpoint)  
+      {  
+      }  
+}  
+```  
+  
+ 上記の機構を使用して、ユーザー コードは、サービス操作を呼び出す前に `TransactionScope` を作成します。メッセージ インスペクタは、トランザクションをサービス操作にフローする必要がある場合に、トランザクションがトランスポートに渡されるようにします。  
+  
+```  
+CalculatorContractClient calculatorClient = new CalculatorContractClient("SampleProfileUdpBinding_ICalculatorContract");  
+calculatorClient.Endpoint.Behaviors.Add(new TransactionFlowBehavior());               
+  
+try  
+{  
+       for (int i = 0; i < 5; ++i)  
+      {  
+              // call the 'Add' service operation under a transaction scope  
+             using (TransactionScope ts = new TransactionScope())  
+             {  
+        [...]  
+        Console.WriteLine(calculatorClient.Add(i, i * 2));  
+         }  
+      }               
+       calculatorClient.Close();  
+}  
+catch (TimeoutException)  
+{  
+    calculatorClient.Abort();  
+}  
+catch (CommunicationException)  
+{  
+    calculatorClient.Abort();  
+}  
+catch (Exception)  
+{  
+    calculatorClient.Abort();  
+    throw;  
+}  
+```  
+  
+ クライアントから UDP パケットを受け取ると、サービスはこれを逆シリアル化して、メッセージとトランザクション \(可能な場合\) を抽出します。  
+  
+```  
+count = listenSocket.EndReceiveFrom(result, ref dummy);  
+  
+// read the transaction and message                       TransactionMessageBuffer.ReadTransactionMessageBuffer(buffer, count, out transaction, out msg);  
+```  
+  
+ `TransactionMessageBuffer.ReadTransactionMessageBuffer()` は、`TransactionMessageBuffer.WriteTransactionMessageBuffer()` によって行われたシリアル化プロセスを元に戻すヘルパー メソッドです。  
+  
+ トランザクションがフローされた場合、トランザクションは `TransactionMessageProperty` のメッセージに追加されます。  
+  
+```  
+message = MessageEncoderFactory.Encoder.ReadMessage(msg, bufferManager);  
+  
+if (transaction != null)  
+{  
+       TransactionMessageProperty.Set(transaction, message);  
+}  
+```  
+  
+ これにより、ディスパッチャはディスパッチ時にトランザクションを取得し、メッセージによってアドレス指定されたサービス操作を呼び出すときにそのトランザクションを使用します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順を参照してください。  
+  
+2.  現在のサンプルは、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルと同様に実行する必要があります。実行するには、UdpTestService.exe を使用してサービスを開始します。[!INCLUDE[windowsver](../../../../includes/windowsver-md.md)] を実行している場合は、サービスをシステム特権で開始する必要があります。これを行うには、[!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] で UdpTestService.exe を右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+3.  これによって次の文字列が出力されます。  
+  
+    ```  
+    Testing Udp From Code.  
+    Service is started from code...  
+    Press <ENTER> to terminate the service and start service from config...  
+    ```  
+  
+4.  この時点で、UdpTestClient.exe を実行してクライアントを開始できます。クライアントによって生成される出力を次に示します。  
+  
+    ```  
+    0  
+    3  
+    6  
+    9  
+    12  
+    Press <ENTER> to complete test.  
+    ```  
+  
+5.  サービスの出力は、次のようになります。  
+  
+    ```  
+    Hello, world!  
+    Hello, world!  
+    Hello, world!  
+    Hello, world!  
+    Hello, world!  
+    The client transaction has flowed to the service  
+       adding 0 + 0  
+    The client transaction has flowed to the service  
+       adding 1 + 2  
+    The client transaction has flowed to the service  
+       adding 2 + 4  
+    The client transaction has flowed to the service  
+       adding 3 + 6  
+    The client transaction has flowed to the service  
+       adding 4 + 8  
+    ```  
+  
+6.  `CalculatorService.Add()` 操作の `clientTransactionId` パラメータで、クライアントによって送信されたトランザクション識別子がサービス トランザクションの識別子と一致する場合、サービス アプリケーションには、"`The client transaction has flowed to the service`" というメッセージが表示されます。クライアント トランザクションがサービスにフローされた場合にのみ、一致が取得されます。  
+  
+7.  構成を使用して公開されたエンドポイントに対してクライアント アプリケーションを実行するには、サービス側のアプリケーション ウィンドウで Enter キーを押して、テスト クライアントを再実行します。サービスには、次の出力が表示されます。  
+  
+    ```  
+    Testing Udp From Config.  
+    Service is started from config...  
+    Press <ENTER> to terminate the service and exit...  
+    ```  
+  
+8.  サービスに対してクライアントを実行すると、前の出力と同様の出力が生成されます。  
+  
+9. Svcutil.exe を使用してクライアント コードと構成を再生成するには、サービス アプリケーションを開始し、次にサンプルのルート ディレクトリで次のように Svcutil.exe コマンドを実行します。  
+  
+    ```  
+    svcutil http://localhost:8000/udpsample/ /reference:UdpTranport\bin\UdpTransport.dll /svcutilConfig:svcutil.exe.config  
+    ```  
+  
+10. Svcutil.exe を実行しても `sampleProfileUdpBinding` のバインディング拡張構成は生成されません。したがって、次のコードを手動で追加する必要があります。  
+  
+    ```  
+    <configuration>  
+        <system.serviceModel>      
+            …  
+            <extensions>  
+                <!-- This was added manually because svcutil.exe does not add this extension to the file -->  
+                <bindingExtensions>  
+                    <add name="sampleProfileUdpBinding" type="Microsoft.ServiceModel.Samples.SampleProfileUdpBindingCollectionElement, UdpTransport" />  
+                </bindingExtensions>  
+            </extensions>  
+        </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Transactions\TransactionMessagePropertyUDPTransport`  
+  
+## 参照  
+ [トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transport-extensibility.md b/docs/framework/wcf/samples/transport-extensibility.md
new file mode 100644
index 00000000000..a8f6f076074
--- /dev/null
+++ b/docs/framework/wcf/samples/transport-extensibility.md
@@ -0,0 +1,30 @@
+---
+title: "トランスポート拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3c9108be-f60f-4035-9f57-1da58c325420
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# トランスポート拡張
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] でのカスタム トランスポートを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [UDP アクティベーション](../../../../docs/framework/wcf/samples/udp-activation.md)  
+ 「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルを拡張し、Windows プロセス アクティブ化サービス \(WAS\) を使用してプロセスのアクティベーションをサポートする方法を示します。  
+  
+ [トランスポート : UDP 経由のカスタム トランザクション](../../../../docs/framework/wcf/samples/transport-custom-transactions-over-udp-sample.md)  
+ カスタム トランザクション フローをサポートするように UDP トランスポートのサンプルを拡張する方法と <xref:System.ServiceModel.Channels.TransactionMessageProperty> プロパティの使用方法を示します。  
+  
+ [トランスポート : WSE 3.0 TCP 相互運用性](../../../../docs/framework/wcf/samples/transport-wse-3-0-tcp-interoperability.md)  
+ このサンプルでは、TCP 二重セッションをカスタム [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] トランスポートとして実装する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transport-udp.md b/docs/framework/wcf/samples/transport-udp.md
new file mode 100644
index 00000000000..57d7f2e68d8
--- /dev/null
+++ b/docs/framework/wcf/samples/transport-udp.md
@@ -0,0 +1,496 @@
+---
+title: "トランスポート: UDP | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 738705de-ad3e-40e0-b363-90305bddb140
+caps.latest.revision: 48
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 48
+---
+# トランスポート: UDP
+UDP トランスポートのサンプルでは、UDP ユニキャストとマルチキャストを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] カスタム トランスポートとして実装する方法を示します。このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] でカスタム トランスポートを作成するための推奨手順について説明します。作成時には、チャネル フレームワークと次に示す [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のベスト プラクティスを使用します。カスタム トランスポートを作成する手順は、次のとおりです。  
+  
+1.  ChannelFactory と ChannelListener でサポートする、チャネルの[メッセージ交換パターン](#MessageExchangePatterns) \(IOutputChannel、IInputChannel、IDuplexChannel、IRequestChannel、または IReplyChannel\) を決定します。次に、こうしたインターフェイスのセッションフル バリエーションをサポートするかどうかを決定します。  
+  
+2.  メッセージ交換パターンをサポートするチャネル ファクトリおよびリスナーを作成します。  
+  
+3.  ネットワーク固有の例外が、<xref:System.ServiceModel.CommunicationException> の適切な派生クラスに標準化されていることを確認します。  
+  
+4.  チャネル スタックにカスタム トランスポートを追加する [\<binding\>](../../../../docs/framework/misc/binding.md) 要素を追加します。詳細については、「[バインド要素の追加](#AddingABindingElement)」を参照してください。  
+  
+5.  バインド要素拡張セクションを追加して、新しいバインド要素を構成システムに公開します。  
+  
+6.  他のエンドポイントに機能を伝達するメタデータ拡張を追加します。  
+  
+7.  適切に定義されたプロファイルに従って、バインド要素のスタックを事前構成するバインディングを追加します。詳細については、「[標準バインディング要素の追加](#AddingAStandardBinding)」を参照してください。  
+  
+8.  構成システムにバインディングを開示する、バインディング セクションおよびバインディング構成要素を追加します。詳細については、「[構成サポートの追加](#AddingConfigurationSupport)」を参照してください。  
+  
+<a name="MessageExchangePatterns"></a>   
+## メッセージ交換パターン  
+ カスタム トランスポートを記述する最初の手順として、どのメッセージ交換パターン \(MEP\) がトランスポートに必要かを判断します。次の 3 つの MEP から選択できます。  
+  
+-   データグラム \(IInputChannel\/IOutputChannel\)  
+  
+     データグラム MEP を使用している場合、クライアントは "ファイア アンド フォーゲット \(撃ち放し\)" の交換を使用してメッセージを送信します。このような交換では、配信の成否について帯域外での確認が必要になります。メッセージが移動中に失われて、サービスに到達しない可能性があります。クライアントで送信操作が正常に完了したとしても、リモート エンドポイントでメッセージが受信されたとは限りません。データグラムはメッセージングの基礎となるビルド ブロックであり、その上に信頼できるプロトコルや安全なプロトコルなどの独自のプロトコルを構築できます。クライアント データグラム チャネルには、<xref:System.ServiceModel.Channels.IOutputChannel> インターフェイスが実装され、サービス データグラム チャネルには <xref:System.ServiceModel.Channels.IInputChannel> インターフェイスが実装されます。  
+  
+-   要求 \- 応答 \(IRequestChannel\/IReplyChannel\)  
+  
+     この MEP では、メッセージが送信されて、応答が受信されます。パターンは、要求 \- 応答のペアで構成されます。要求 \- 応答呼び出しの例には、リモート プロシージャ コール \(RPC\) やブラウザ GET などがあります。このパターンは、半二重とも呼ばれます。この MEP では、クライアント チャネルには <xref:System.ServiceModel.Channels.IRequestChannel> が実装され、サービス チャネルには <xref:System.ServiceModel.Channels.IReplyChannel> が実装されます。  
+  
+-   二重 \(IDuplexChannel\)  
+  
+     二重 MEP では、クライアントにより任意の数のメッセージを送信して、任意の順序で受信できます。二重 MEP は、話される語の 1 つずつがメッセージである電話の会話に似ています。この MEP ではどちらの側も送信および受信できるので、クライアントおよびサービス チャネルによって実装されるインターフェイスは <xref:System.ServiceModel.Channels.IDuplexChannel> になります。  
+  
+ これらの MEP では、それぞれセッションをサポートすることもできます。セッション対応チャネルにより追加される機能として、チャネルで送信および受信されるすべてのメッセージが関連付けられます。要求\/応答パターンはスタンドアロンの 2 メッセージ セッションで、要求と応答が相互に関連付けられています。一方、セッションをサポートする要求 \- 応答パターンは、そのチャネルのすべての要求\/応答ペアが互いに関連付けられることを意味しています。これにより、合計で 6 つの MEP \(データグラム、要求 \- 応答、二重、セッション対応データグラム、セッション対応要求 \- 応答、およびセッション対応二重\) を選択できます。  
+  
+> [!NOTE]
+>  UDP トランスポートでは、サポートされている MEP はデータグラムだけです。これは、UDP が "ファイア アンド フォーゲット \(撃ち放し\)" のプロトコルだからです。  
+  
+### ICommunicationObject および WCF オブジェクトのライフサイクル  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、通信に使用される <xref:System.ServiceModel.Channels.IChannel>、<xref:System.ServiceModel.Channels.IChannelFactory>、および <xref:System.ServiceModel.Channels.IChannelListener> などのオブジェクトのライフサイクルの管理に使用される共通ステート マシンです。これらの通信オブジェクトには、5 つの状態があります。これらの状態は、<xref:System.ServiceModel.CommunicationState> 列挙値で表され、次のようになります。  
+  
+-   Created: <xref:System.ServiceModel.ICommunicationObject> が初めてインスタンス化されたときの状態です。この状態では、入出力 \(I\/O\) は行われません。  
+  
+-   Opening: <xref:System.ServiceModel.ICommunicationObject.Open%2A> が呼び出されると、オブジェクトはこの状態に移行します。この時点では、プロパティは不変であり、入出力を開始できます。この移行は、Created 状態からのみ有効です。  
+  
+-   Opened: オープン処理が完了すると、オブジェクトはこの状態に移行します。この移行は、Opening 状態からのみ有効です。この時点では、オブジェクトは完全に転送に使用可能です。  
+  
+-   Closing: 正常なシャットダウンを行うために <xref:System.ServiceModel.ICommunicationObject.Close%2A> が呼び出されると、オブジェクトはこの状態に移行します。この移行は、Opened 状態からのみ有効です。  
+  
+-   Closed: Closed 状態では、オブジェクトは使用できません。通常、ほとんどの構成には検査中もアクセスできますが、通信が発生することはありません。この状態は、破棄されるのと同じです。  
+  
+-   Faulted: Faulted 状態では、オブジェクトにアクセスして検査できますが、使用することはできません。回復不可能なエラーが発生した場合、オブジェクトはこの状態に移行します。この状態からは、`Closed` 状態にのみ移行できます。  
+  
+ 各状態移行には、発生するイベントがあります。<xref:System.ServiceModel.ICommunicationObject.Abort%2A> メソッドはいつでも呼び出すことができます。このメソッドを呼び出すことにより、オブジェクトは現在の状態から直ちに Closed 状態に移行します。<xref:System.ServiceModel.ICommunicationObject.Abort%2A> を呼び出すと、完了していない作業が終了します。  
+  
+<a name="ChannelAndChannelListener"></a>   
+## チャネル ファクトリとチャネル リスナー  
+ カスタム トランスポートを記述する次の手順では、クライアント チャネルでの <xref:System.ServiceModel.Channels.IChannelFactory> の実装とサービス チャネルでの <xref:System.ServiceModel.Channels.IChannelListener> の実装を作成します。チャネル レイヤーでは、チャネルの構築にファクトリ パターンが使用されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、このプロセスに対する基本クラス ヘルパーが用意されています。  
+  
+-   <xref:System.ServiceModel.Channels.CommunicationObject> クラスには <xref:System.ServiceModel.ICommunicationObject> が実装され、前述の手順 2. で説明したステート マシンが強制実行されます。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelManagerBase> クラスには <xref:System.ServiceModel.Channels.CommunicationObject> が実装され、<xref:System.ServiceModel.Channels.ChannelFactoryBase> と <xref:System.ServiceModel.Channels.ChannelListenerBase> の統合基本クラスが提供されます。<xref:System.ServiceModel.Channels.ChannelManagerBase> クラスは、<xref:System.ServiceModel.Channels.IChannel> を実装する基本クラスである <xref:System.ServiceModel.Channels.ChannelBase> との組み合わせによって動作します。  
+  
+-   ``  <xref:System.ServiceModel.Channels.ChannelFactoryBase> クラスでは、<xref:System.ServiceModel.Channels.ChannelManagerBase> および <xref:System.ServiceModel.Channels.IChannelFactory> が実装され、`CreateChannel` オーバーロードが `OnCreateChannel` 抽象メソッドに統合されます。  
+  
+-   <xref:System.ServiceModel.Channels.ChannelListenerBase> クラスは、<xref:System.ServiceModel.Channels.IChannelListener> を実装しています。基本状態管理を行います。  
+  
+ このサンプルのファクトリの実装は UdpChannelFactory.cs に、リスナーの実装は UdpChannelListener.cs に含まれています。<xref:System.ServiceModel.Channels.IChannel> 実装は、UdpOutputChannel.cs と UdpInputChannel.cs に含まれています。  
+  
+### UDP チャネル ファクトリ  
+ `UdpChannelFactory` は <xref:System.ServiceModel.Channels.ChannelFactoryBase> から派生します。サンプルでは、<xref:System.ServiceModel.Channels.ChannelFactoryBase.GetProperty%2A> をオーバーライドして、メッセージ エンコーダーのメッセージ バージョンにアクセスできるようにします。さらに、<xref:System.ServiceModel.Channels.ChannelFactoryBase.OnClose%2A> をオーバーライドして、ステート マシンの移行時に <xref:System.ServiceModel.Channels.BufferManager> のインスタンスを破棄できるようにします。  
+  
+#### UDP 出力チャネル  
+ `UdpOutputChannel` では、<xref:System.ServiceModel.Channels.IOutputChannel> が実装されます。このコンストラクターは、引数を検証し、渡される <xref:System.ServiceModel.EndpointAddress> に基づいて出力先の <xref:System.Net.EndPoint> オブジェクトを構築します。  
+  
+```  
+this.socket = new Socket(this.remoteEndPoint.AddressFamily, SocketType.Dgram, ProtocolType.Udp);  
+  
+```  
+  
+ チャネルが閉じる際には、正常終了することも異常終了することもあります。チャネルが正常に閉じた場合はソケットも終了し、基本クラスの `OnClose` メソッドが呼び出されます。このときに例外がスローされると、インフラストラクチャによって `Abort` が呼び出され、チャネルがクリーンアップされます。  
+  
+```  
+this.socket.Close(0);  
+  
+```  
+  
+ 次に、`Send()` と `BeginSend()`\/`EndSend()` を実装します。この実装は、2 つの主要セクションに分かれます。最初に、メッセージを次のようにシリアル化してバイト配列で表します。  
+  
+```  
+ArraySegment<byte> messageBuffer = EncodeMessage(message);  
+  
+```  
+  
+ 次に、結果として生成されたデータを次のようにネットワークに送信します。  
+  
+```  
+this.socket.SendTo(messageBuffer.Array, messageBuffer.Offset, messageBuffer.Count, SocketFlags.None, this.remoteEndPoint);  
+```  
+  
+### UdpChannelListener  
+ サンプルに実装されている ``UdpChannelListener は、<xref:System.ServiceModel.Channels.ChannelListenerBase> クラスから派生します。単一の UDP ソケットを使用して、データグラムを受信します。`OnOpen` メソッドは、非同期ループ内で UDP ソケットを使用してデータを受信します。その後、メッセージ エンコーディング フレームワークを使用して、データを次のようにメッセージに変換します。  
+  
+```  
+message = MessageEncoderFactory.Encoder.ReadMessage(new ArraySegment<byte>(buffer, 0, count), bufferManager);  
+```  
+  
+ 複数のソースから到着するメッセージが同じデータグラム チャネルで表されるので、`UdpChannelListener` はシングルトン リスナーです。このリスナーに同時に関連付けられるアクティブな <xref:System.ServiceModel.Channels.IChannel>`` は、最大 1 つです。このサンプルでは、`AcceptChannel` メソッドによって返されるチャネルがその後破棄される場合のみ、もう 1 つ生成されます。メッセージが受信されると、このシングルトン チャネルのキューに置かれます。  
+  
+#### UdpInputChannel  
+ `UdpInputChannel` クラスは、`IInputChannel` を実装しています。このクラスは `UdpChannelListener` のソケットによって設定される受信メッセージのキューで構成されています。これらのメッセージは、`IInputChannel.Receive``` メソッドによってキューから削除されます。  
+  
+<a name="AddingABindingElement"></a>   
+## バインド要素の追加  
+ ファクトリおよびチャネルを作成したので、バインディングを使用してそれらを ServiceModel ランタイムに開示する必要があります。バインディングは、サービス アドレスに関連する通信スタックを表すバインディング要素のコレクションです。スタックの各要素は、[\<binding\>](../../../../docs/framework/misc/binding.md) 要素によって表されます。  
+  
+ このサンプルでは、バインド要素は `UdpTransportBindingElement` で、<xref:System.ServiceModel.Channels.TransportBindingElement> から派生しています。バインディングに関連したファクトリを作成すると、次のメソッドが無効になります。  
+  
+```  
+public IChannelFactory<TChannel> BuildChannelFactory<TChannel>(BindingContext context)  
+{  
+            return (IChannelFactory<TChannel>)(object)new UdpChannelFactory(this, context);  
+}  
+  
+public IChannelListener<TChannel> BuildChannelListener<TChannel>(BindingContext context)  
+{  
+            return (IChannelListener<TChannel>)(object)new UdpChannelListener(this, context);  
+}  
+```  
+  
+ また、この要素には、`BindingElement` を複製したり、スキーム \(soap.udp\) を返したりするためのメンバーも含まれます。  
+  
+## トランスポート バインディング要素のメタデータ サポートの追加  
+ トランスポートをメタデータ システムに統合するには、ポリシーのインポートとエクスポートの両方をサポートする必要があります。これにより、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してバインディングのクライアントを生成できます。  
+  
+### WSDL サポートの追加  
+ バインディングのトランスポート バインド要素は、メタデータのアドレス指定情報のインポートとエクスポートを行います。SOAP バインディングを使用する場合は、トランスポート バインド要素によっても、メタデータの正しいトランスポート URI がエクスポートされます。  
+  
+#### WSDL エクスポート  
+ アドレス指定情報をエクスポートするには、`UdpTransportBindingElement` に `IWsdlExportExtension` インターフェイスを実装します。`ExportEndpoint` メソッドにより、正しいアドレス指定情報が WSDL ポートに追加されます。  
+  
+```  
+if (context.WsdlPort != null)  
+{  
+    AddAddressToWsdlPort(context.WsdlPort, context.Endpoint.Address, encodingBindingElement.MessageVersion.Addressing);  
+}  
+```  
+  
+ エンドポイントが SOAP バインディングを使用する場合、`ExportEndpoint` メソッドの `UdpTransportBindingElement` の実装でも、次のようにトランスポート URI がエクスポートされます。  
+  
+```  
+WsdlNS.SoapBinding soapBinding = GetSoapBinding(context, exporter);  
+if (soapBinding != null)  
+{  
+    soapBinding.Transport = UdpPolicyStrings.UdpNamespace;  
+}  
+```  
+  
+#### WSDL インポート  
+ WSDL インポート システムを拡張してアドレスのインポートを処理するには、次の構成を Svcutil.exe の構成ファイルに追加する必要があります。Svcutil.exe.config ファイルの次の例を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <metadata>  
+        <wsdlImporters>  
+          <extension type=" Microsoft.ServiceModel.Samples.UdpBindingElementImporter, UdpTransport" />  
+        </policyImporters>  
+      </metadata>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ Svcutil.exe を実行する場合、Svcutil.exe に WSDL インポートの拡張を読み込ませるために次の 2 つのオプションがあります。  
+  
+1.  \/SvcutilConfig:\<ファイル名\> を使用して、Svcutil.exe に構成ファイルを指定します。  
+  
+2.  Svcutil.exe と同じディレクトリにある Svcutil.exe.config に構成セクションを追加します。  
+  
+ `UdpBindingElementImporter` 型は、`IWsdlImportExtension` インターフェイスを実装します。`ImportEndpoint` メソッドは、次のようにして WSDL ポートからアドレスをインポートします。  
+  
+```  
+BindingElementCollection bindingElements = context.Endpoint.Binding.CreateBindingElements();  
+TransportBindingElement transportBindingElement = bindingElements.Find<TransportBindingElement>();  
+if (transportBindingElement is UdpTransportBindingElement)  
+{  
+    ImportAddress(context);  
+}  
+```  
+  
+### ポリシー サポートの追加  
+ カスタム バインド要素では、WSDL バインディング内のポリシー アサーションをエクスポートして、サービス エンドポイントでそのバインド要素の機能を表現します。  
+  
+#### ポリシーのエクスポート  
+ `UdpTransportBindingElement` 型はポリシーのエクスポートをサポートするために ```IPolicyExportExtension` を実装します。その結果、`System.ServiceModel.MetadataExporter` には、これを含む任意のバインディングでのポリシーの生成時に `UdpTransportBindingElement` が含まれます。  
+  
+ マルチキャスト モードの場合、`IPolicyExportExtension.ExportPolicy` には UDP のアサーションや他のアサーションが追加されます。これは、マルチキャスト モードは通信スタックの構築方法に影響を与えるため、両方の側において調整される必要があるためです。  
+  
+```  
+ICollection<XmlElement> bindingAssertions = context.GetBindingAssertions();  
+XmlDocument xmlDocument = new XmlDocument();  
+bindingAssertions.Add(xmlDocument.CreateElement(  
+UdpPolicyStrings.Prefix, UdpPolicyStrings.TransportAssertion, UdpPolicyStrings.UdpNamespace));  
+if (Multicast)  
+{  
+    bindingAssertions.Add(xmlDocument.CreateElement(  
+UdpPolicyStrings.Prefix, UdpPolicyStrings.MulticastAssertion,     UdpPolicyStrings.UdpNamespace));  
+}  
+```  
+  
+ カスタム トランスポート バインド要素はアドレス指定の処理を実行するため、`UdpTransportBindingElement` への `IPolicyExportExtension` の実装でも、WS\-Addressing ポリシー アサーションのエクスポートが処理されて、使用されている WS\-Addressing のバージョンが示されます。  
+  
+```  
+AddWSAddressingAssertion(context, encodingBindingElement.MessageVersion.Addressing);  
+```  
+  
+#### ポリシーのインポート  
+ ポリシー インポート システムを拡張するには、次の構成を Svcutil.exe の構成ファイルに追加する必要があります。Svcutil.exe.config ファイルの次の例を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <client>  
+      <metadata>  
+        <policyImporters>  
+          <extension type=" Microsoft.ServiceModel.Samples.UdpBindingElementImporter, UdpTransport" />  
+        </policyImporters>  
+      </metadata>  
+    </client>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ 次に、登録されたクラス \(`UdpBindingElementImporter`\) から `IPolicyImporterExtension` を実装します。`ImportPolicy()` で、名前空間内のアサーションを調べ、そのアサーションを処理してトランスポートを生成し、マルチキャストであるかどうかをチェックします。さらに、処理したアサーションをバインディング アサーションの一覧から削除する必要もあります。Svcutil.exe を実行する場合、ここでも、統合用に次の 2 つのオプションがあります。  
+  
+1.  \/SvcutilConfig:\<ファイル名\> を使用して、Svcutil.exe に構成ファイルを指定します。  
+  
+2.  Svcutil.exe と同じディレクトリにある Svcutil.exe.config に構成セクションを追加します。  
+  
+<a name="AddingAStandardBinding"></a>   
+## 標準バインディング要素の追加  
+ バインディング要素は、次の 2 つの方法で使用できます。  
+  
+-   カスタム バインディングの使用 : カスタム バインディングを使用すれば、バインディング要素の任意のセットに基づいて独自のバインディングを作成できます。  
+  
+-   バインディング要素が含まれるシステム指定のバインディングを使用することによって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は `BasicHttpBinding`、`NetTcpBinding`、`WsHttpBinding` など、これらのシステム定義バインディングの数々を提供します。これらの各バインドは、適切に定義されたプロファイルに関連付けられます。  
+  
+ このサンプルでは、プロファイル バインディングを、<xref:System.ServiceModel.Channels.Binding> から派生した `SampleProfileUdpBinding` に実装します。`SampleProfileUdpBinding` は、`UdpTransportBindingElement`、`TextMessageEncodingBindingElement CompositeDuplexBindingElement`、および `ReliableSessionBindingElement` の、最大 4 つのバインディング要素を格納します。  
+  
+```  
+public override BindingElementCollection CreateBindingElements()  
+{     
+    BindingElementCollection bindingElements = new BindingElementCollection();  
+    if (ReliableSessionEnabled)  
+    {  
+        bindingElements.Add(session);  
+        bindingElements.Add(compositeDuplex);  
+    }  
+    bindingElements.Add(encoding);  
+    bindingElements.Add(transport);  
+    return bindingElements.Clone();  
+}  
+```  
+  
+### カスタムの標準バインディング インポーターの追加  
+ Svcutil.exe と `WsdlImporter` 型は、既定でシステム定義のバインディングを識別してインポートします。これ以外の場合、バインディングは、`CustomBinding` インスタンスとしてインポートされます。Svcutil.exe と `WsdlImporter` を有効にして `SampleProfileUdpBinding` をインポートする場合、`UdpBindingElementImporter` もカスタムの標準バインディング インポーターとして機能します。  
+  
+ カスタムの標準バインディング インポーターは、`IWsdlImportExtension` インターフェイスの `ImportEndpoint` メソッドを実装しており、メタデータからインポートされた `CustomBinding` インスタンスを調べて、これが特定の標準バインディングによって生成されたものであるかどうかを判別できます。  
+  
+```  
+if (context.Endpoint.Binding is CustomBinding)  
+{  
+    Binding binding;  
+    if (transportBindingElement is UdpTransportBindingElement)  
+    {  
+        //if TryCreate is true, the CustomBinding will be replace by a SampleProfileUdpBinding in the  
+        //generated config file for better typed generation.  
+        if (SampleProfileUdpBinding.TryCreate(bindingElements, out binding))  
+        {  
+            binding.Name = context.Endpoint.Binding.Name;  
+            binding.Namespace = context.Endpoint.Binding.Namespace;  
+            context.Endpoint.Binding = binding;  
+        }  
+    }  
+}  
+```  
+  
+ 一般に、カスタムの標準バインディング インポーターを実装すると、インポートしたバインド要素のプロパティを調べて、標準バインディングによって設定されたプロパティのみが変更され、その他のすべてのプロパティは既定のままであることが検証されます。標準バインディング インポーターを実装する場合の基本的な方法は、標準バインディングのインスタンスを作成し、標準バインディングがサポートするバインド要素のプロパティを標準バインディング インスタンスに反映し、標準バインディングのバインド要素とインポートしたバインド要素とを比較します。  
+  
+<a name="AddingConfigurationSupport"></a>   
+## 構成サポートの追加  
+ 構成を通じてトランスポートを公開するには、2 つの構成セクションを実装する必要があります。1 つ目のクラスは、`UdpTransportBindingElement` の `BindingElementExtensionElement` です。これは、`CustomBinding` の実装がバインディング要素を参照するためのものです。2 つ目のクラスは、`SampleProfileUdpBinding` の `Configuration` です。  
+  
+### バインディング要素の拡張要素  
+ セクション `````UdpTransportElement` は、`UdpTransportBindingElement` を構成システムに公開する `BindingElementExtensionElement` です。いくつかの基本的なオーバーライドを行うことで、構成セクションの名前、バインディング要素の種類とバインディング要素の作成方法を定義します。その後、次のコードに示すように、拡張セクションを構成ファイルに登録できます。  
+  
+```  
+<configuration>  
+  \<system.serviceModel>  
+    <extensions>  
+      <bindingElementExtensions>  
+      \<add name="udpTransport" type="Microsoft.ServiceModel.Samples.UdpTransportElement, UdpTransport />  
+      </bindingElementExtensions>  
+    </extensions>  
+  \</system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ この拡張は、UDP をトランスポートとして使用するためにカスタム バインディングから参照されます。  
+  
+```  
+<configuration>  
+  \<system.serviceModel>  
+    <bindings>  
+      <customBinding>  
+       <binding configurationName="UdpCustomBinding">  
+         <udpTransport/>  
+       </binding>  
+      </customBinding>  
+    </bindings>  
+  \</system.serviceModel>  
+</configuration>  
+  
+```  
+  
+### バインディング セクション  
+ セクション `SampleProfileUdpBindingCollectionElement` は `StandardBindingCollectionElement` で、`SampleProfileUdpBinding` を構成システムに公開します。実装の大部分は `SampleProfileUdpBindingConfigurationElement` で代行されます。これは `StandardBindingElement` の派生です。`SampleProfileUdpBindingConfigurationElement` には `SampleProfileUdpBinding` にあるプロパティに対応するプロパティがあり、`ConfigurationElement` バインディングからマップする関数があります。最後に、`SampleProfileUdpBinding` 内で `OnApplyConfiguration` メソッドをオーバーライドします。次のサンプル コードを参照してください。  
+  
+```  
+protected override void OnApplyConfiguration(string configurationName)  
+{  
+            if (binding == null)  
+                throw new ArgumentNullException("binding");  
+  
+            if (binding.GetType() != typeof(SampleProfileUdpBinding))  
+            {  
+                throw new ArgumentException(string.Format(CultureInfo.CurrentCulture,  
+                    "Invalid type for binding. Expected type: {0}. Type passed in: {1}.",  
+                    typeof(SampleProfileUdpBinding).AssemblyQualifiedName,  
+                    binding.GetType().AssemblyQualifiedName));  
+            }  
+            SampleProfileUdpBinding udpBinding = (SampleProfileUdpBinding)binding;  
+  
+            udpBinding.OrderedSession = this.OrderedSession;  
+            udpBinding.ReliableSessionEnabled = this.ReliableSessionEnabled;  
+            udpBinding.SessionInactivityTimeout = this.SessionInactivityTimeout;  
+            if (this.ClientBaseAddress != null)  
+                   udpBinding.ClientBaseAddress = ClientBaseAddress;  
+}  
+  
+```  
+  
+ このハンドラを構成システムに登録するには、次のセクションを関連する構成ファイルに追加します。  
+  
+```  
+<configuration>  
+  <configSections>  
+     <sectionGroup name="system.serviceModel">  
+         <sectionGroup name="bindings">  
+                 \<section name="sampleProfileUdpBinding" type="Microsoft.ServiceModel.Samples.SampleProfileUdpBindingCollectionElement, UdpTransport />  
+         </sectionGroup>  
+     </sectionGroup>  
+  </configSections>  
+</configuration>  
+```  
+  
+ これは serviceModel 構成セクションから参照できます。  
+  
+```  
+<configuration>  
+  \<system.serviceModel>  
+    <client>  
+      <endpoint configurationName="calculator"  
+                address="soap.udp://localhost:8001/"   
+                bindingConfiguration="CalculatorServer"  
+                binding="sampleProfileUdpBinding"   
+                contract= "Microsoft.ServiceModel.Samples.ICalculatorContract">  
+      </endpoint>  
+    </client>  
+  \</system.serviceModel>  
+</configuration>  
+```  
+  
+## UDP テスト サービスとクライアント  
+ このサンプルのトランスポートを使用するテスト コードは、UdpTestService ディレクトリと UdpTestClient ディレクトリで使用できます。サービス コードは 2 つのテストで構成されています。1 つ目はコードからバインディングとエンドポイントをセットアップするテストで、2 つ目は構成を使用してバインディングとエンドポイントをセットアップするテストです。両方のテストで、2 つのエンドポイントを使用します。1 つ目のエンドポイントでは、[\<reliableSession\>](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b) を `true` に設定した `SampleUdpProfileBinding` を使用します。もう 1 つのエンドポイントでは、 `UdpTransportBindingElement` が含まれるカスタム バインディングを使用します。これは、[\<reliableSession\>](http://msdn.microsoft.com/ja-jp/9c93818a-7dfa-43d5-b3a1-1aafccf3a00b) を `false` に設定して `SampleUdpProfileBinding` を使用することと同じです。両方のテストでサービスが作成され、各バインドのエンドポイントが追加されてサービスが開きます。その後 Enter キーを押すと、サービスが閉じます。  
+  
+ このサービス テスト アプリケーションを開始すると、次の出力が表示されます。  
+  
+```  
+Testing Udp From Code.  
+Service is started from code...  
+Press <ENTER> to terminate the service and start service from config...  
+```  
+  
+ 次に、公開されたエンドポイントに対してクライアント テスト アプリケーションを実行できます。このクライアント テスト アプリケーションでは、各エンドポイントに対してクライアントが作成され、5 つのメッセージが各エンドポイントに送信されます。クライアントでの出力を次に示します。  
+  
+```  
+Testing Udp From Imported Files Generated By SvcUtil.  
+0  
+3  
+6  
+9  
+12  
+Press <ENTER> to complete test.  
+```  
+  
+ サービスでのすべての出力を次に示します。  
+  
+```  
+Service is started from code...  
+Press <ENTER> to terminate the service and start service from config...  
+Hello, world!  
+Hello, world!  
+Hello, world!  
+Hello, world!  
+Hello, world!  
+   adding 0 + 0  
+   adding 1 + 2  
+   adding 2 + 4  
+   adding 3 + 6  
+   adding 4 + 8  
+```  
+  
+ 構成を使用して公開されたエンドポイントに対してクライアント アプリケーションを実行するには、サービス側で Enter キーを押してテスト クライアントを再実行します。サービスには、次の出力が表示されます。  
+  
+```  
+Testing Udp From Config.  
+Service is started from config...  
+Press <ENTER> to terminate the service and exit...  
+```  
+  
+ クライアントを再実行すると、前と同じ結果が表示されます。  
+  
+ Svcutil.exe を使用してクライアント コードと構成を再生成するには、サービス アプリケーションを開始し、その後、サンプルのルート ディレクトリで次のように Svcutil.exe を実行します。  
+  
+```  
+svcutil http://localhost:8000/udpsample/ /reference:UdpTranport\bin\UdpTransport.dll /svcutilConfig:svcutil.exe.config  
+```  
+  
+ Svcutil.exe を実行しても `SampleProfileUdpBinding` のバインディング拡張構成は生成されません。したがって、手動で追加する必要があります。  
+  
+```  
+<configuration>  
+    \<system.serviceModel>      
+        …  
+        <extensions>  
+            \<!-- This was added manually because svcutil.exe does not add this extension to the file -->  
+            <bindingExtensions>  
+                <add name="sampleProfileUdpBinding" type="Microsoft.ServiceModel.Samples.SampleProfileUdpBindingCollectionElement, UdpTransport" />  
+            </bindingExtensions>  
+        </extensions>  
+    \</system.serviceModel>  
+</configuration>  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+3.  前の「UDP テスト サービスとクライアント」セクションを参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Transport\Udp`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/transport-wse-3-0-tcp-interoperability.md b/docs/framework/wcf/samples/transport-wse-3-0-tcp-interoperability.md
new file mode 100644
index 00000000000..340f5c1643e
--- /dev/null
+++ b/docs/framework/wcf/samples/transport-wse-3-0-tcp-interoperability.md
@@ -0,0 +1,205 @@
+---
+title: "トランスポート : WSE 3.0 TCP 相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f7c3708-acad-4eb3-acb9-d232c77d1486
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# トランスポート : WSE 3.0 TCP 相互運用性
+WSE 3.0 TCP 相互運用性トランスポートのサンプルでは、TCP 二重セッションを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] カスタム トランスポートとして実装する方法を示します。さらに、チャネル レイヤーの拡張機能を使用して、ネットワーク経由で既存の配置システムと連結する方法も示します。この [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] カスタム トランスポートを作成する方法を、次の手順に示します。  
+  
+1.  まず TCP ソケットを使用して、DIME フレームを使用する <xref:System.ServiceModel.Channels.IDuplexSessionChannel> のクライアント実装とサーバー実装を作成し、メッセージ境界を決定します。  
+  
+2.  WSE TCP サービスに接続してクライアント <xref:System.ServiceModel.Channels.IDuplexSessionChannel> 経由でフレーム メッセージを送信する、チャネル ファクトリを作成します。  
+  
+3.  受信 TCP 接続を受け入れて対応するチャネルを作成するチャネル リスナーを作成します。  
+  
+4.  ネットワーク固有の例外が、<xref:System.ServiceModel.CommunicationException> の適切な派生クラスに標準化されていることを確認します。  
+  
+5.  チャネル スタックにカスタム トランスポートを追加するバインド要素を追加します。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]「[バインド要素の追加](#AddingABindingElement)」を参照してください。  
+  
+## IDuplexSessionChannel の作成  
+ WSE 3.0 TCP 相互運用性トランスポートを作成するには、まず、<xref:System.Net.Sockets.Socket> 上に <xref:System.ServiceModel.Channels.IDuplexSessionChannel> の実装を作成します。`WseTcpDuplexSessionChannel` は、<xref:System.ServiceModel.Channels.ChannelBase> から派生します。メッセージ送信のロジックは、\(1\) メッセージをバイトにエンコードし、\(2\) それらのバイトをフレーム化してネットワーク上に送信するという、2 つの主要部分で構成されます。  
+  
+ `ArraySegment<byte> encodedBytes = EncodeMessage(message);`  
+  
+ `WriteData(encodedBytes);`  
+  
+ さらに、Send\(\) 呼び出しが IDuplexSessionChannel の順序の保証を保持し、基になるソケットに対する呼び出しが正しく同期されるように、ロックを取得します。  
+  
+ `WseTcpDuplexSessionChannel` は、<xref:System.ServiceModel.Channels.Message> と byte\[\] を相互に変換するために、<xref:System.ServiceModel.Channels.MessageEncoder> を使用します。`WseTcpDuplexSessionChannel` はトランスポートであるため、チャネルが構成されたリモート アドレスの適用も行います。`EncodeMessage` は、この変換ロジックをカプセル化します。  
+  
+ `this.RemoteAddress.ApplyTo(message);`  
+  
+ `return encoder.WriteMessage(message, maxBufferSize, bufferManager);`  
+  
+ <xref:System.ServiceModel.Channels.Message> がバイトにエンコードされたら、ネットワーク上に送信する必要があります。これを行うには、メッセージ境界を定義するシステムが必要です。WSE 3.0 は [DIME](http://go.microsoft.com/fwlink/?LinkId=94999) のバージョンをフレーム プロトコルとして使用します。`WriteData` はこのフレーム ロジックをカプセル化して、byte\[\] を一連の DIME レコードにラップします。  
+  
+ メッセージ受信用のロジックは、上記のロジックとほぼ同じです。複雑な点は、主に、読み取られたソケットによって返されるバイトが、要求されたバイトよりも少ない場合があることに関する処理です。メッセージを受信するには、`WseTcpDuplexSessionChannel` がネットワーク経由でないバイトを読み取って DIME フレームを復号化し、その後<xref:System.ServiceModel.Channels.MessageEncoder> を使用して byte\[\] を <xref:System.ServiceModel.Channels.Message> に変換します。  
+  
+ 基本の `WseTcpDuplexSessionChannel` は、接続されたソケットを受信することを前提とします。この基本クラスでは、ソケットのシャットダウンが処理されます。ソケットの終了と連動する場所は、次の 3 つです。  
+  
+-   OnAbort \-\- ソケットを異常終了します \(強制終了\)。  
+  
+-   On\[Begin\]Close \-\- ソケットを正常に終了します \(正常終了\)。  
+  
+-   session.CloseOutputSession \-\-  送信データ ストリームをシャットダウンします \(半終了\)。  
+  
+## チャネル ファクトリ  
+ TCP トランスポートを記述する次の手順では、クライアント チャネルでの <xref:System.ServiceModel.Channels.IChannelFactory> の実装を作成します。  
+  
+-   `WseTcpChannelFactory` は <xref:System.ServiceModel.Channels.ChannelFactoryBase>\<IDuplexSessionChannel\> から派生します。このファクトリは、`OnCreateChannel` をオーバーライドして、クライアント チャネルを作成します。  
+  
+ `protected override IDuplexSessionChannel OnCreateChannel(EndpointAddress remoteAddress, Uri via)`  
+  
+ `{`  
+  
+ `return new ClientWseTcpDuplexSessionChannel(encoderFactory, bufferManager, remoteAddress, via, this);`  
+  
+ `}`  
+  
+-   `ClientWseTcpDuplexSessionChannel` は基本 `WseTcpDuplexSessionChannel`にロジックを追加して、`channel.Open` のときに TCP サーバーに接続します。まず、次のコードに示すようにホスト名を解決して IP アドレスに変換します。  
+  
+ `hostEntry = Dns.GetHostEntry(Via.Host);`  
+  
+-   次のコードに示すように、ホスト名はループ内で最初に利用可能な IP アドレスに接続されます。  
+  
+ `IPAddress address = hostEntry.AddressList[i];`  
+  
+ `socket = new Socket(address.AddressFamily, SocketType.Stream, ProtocolType.Tcp);`  
+  
+ `socket.Connect(new IPEndPoint(address, port));`  
+  
+-   チャネル コントラクトの一部として、<xref:System.ServiceModel.CommunicationException> の `SocketException` など、ドメイン固有の任意の例外をラップします。  
+  
+## チャネル リスナー  
+ TCP トランスポートを記述する次の手順では、サーバー チャネルを受け入れるための <xref:System.ServiceModel.Channels.IChannelListener> の実装を作成します。  
+  
+-   `WseTcpChannelListener` は <xref:System.ServiceModel.Channels.ChannelListenerBase>\<IDuplexSessionChannel\> から派生し、On\[Begin\]Open と On\[Begin\]Close をオーバーライドしてリッスン ソケットの有効期間を制御します。OnOpen で、IP\_ANY でリッスンするソケットを作成します。より高度な実装では、同様に IPv6 でリッスンする 2 つ目のソケットを作成できます。そのような実装では、IP アドレスをホスト名で指定することもできます。  
+  
+ `IPEndPoint localEndpoint = new IPEndPoint(IPAddress.Any, uri.Port);`  
+  
+ `this.listenSocket = new Socket(localEndpoint.AddressFamily, SocketType.Stream, ProtocolType.Tcp);`  
+  
+ `this.listenSocket.Bind(localEndpoint);`  
+  
+ `this.listenSocket.Listen(10);`  
+  
+ 新しいソケットが受け入れられると、サーバー チャネルがこのソケットで初期化されます。すべての入出力は既に基本クラスに実装されているので、このチャネルでソケットの初期化に対応します。  
+  
+## バインディング要素の追加  
+ ファクトリおよびチャネルを作成したら、バインディングを使用してそれらを ServiceModel ランタイムに開示する必要があります。バインディングは、サービス アドレスに関連する通信スタックを表すバインディング要素のコレクションです。スタックの各要素は、バインディング要素によって表されます。  
+  
+ このサンプルでは、バインディング要素は `WseTcpTransportBindingElement` で、<xref:System.ServiceModel.Channels.TransportBindingElement> から派生しています。<xref:System.ServiceModel.Channels.IDuplexSessionChannel> がサポートされており、次のメソッドをオーバーライドして、バインディングに関連したファクトリを作成します。  
+  
+ `public IChannelFactory<TChannel> BuildChannelFactory<TChannel>(BindingContext context)`  
+  
+ `{`  
+  
+ `return (IChannelFactory<TChannel>)(object)new WseTcpChannelFactory(this, context);`  
+  
+ `}`  
+  
+ `public IChannelListener<TChannel> BuildChannelListener<TChannel>(BindingContext context)`  
+  
+ `{`  
+  
+ `return (IChannelListener<TChannel>)(object)new WseTcpChannelListener(this, context);`  
+  
+ `}`  
+  
+ また、この要素には、`BindingElement` を複製したり、スキーム \(wse.tcp\) を返したりするためのメンバーも含まれます。  
+  
+## WSE TCP テスト コンソール  
+ このサンプルのトランスポートを使用するテスト コードは、TestCode.cs で使用できます。WSE `TcpSyncStockService` サンプルの設定方法を次の手順に示します。  
+  
+ このテスト コードでは、MTOM をエンコーディングとして使用し、`WseTcpTransport` をトランスポートとして使用するカスタム バインディングを作成します。さらに、AddressingVersion を、次のコードに示すように WSE 3.0 に準拠するように設定します。  
+  
+ `CustomBinding binding = new CustomBinding();`  
+  
+ `MtomMessageEncodingBindingElement mtomBindingElement = new MtomMessageEncodingBindingElement();`  
+  
+ `mtomBindingElement.MessageVersion = MessageVersion.Soap11WSAddressingAugust2004;`  
+  
+ `binding.Elements.Add(mtomBindingElement);`  
+  
+ `binding.Elements.Add(new WseTcpTransportBindingElement());`  
+  
+ テスト コードは 2 つのテストで構成されます。1 つ目のテストは、WSE 3.0 WSDL から生成されたコードを使用して型指定のあるクライアントを設定します。2 つ目のテストは、メッセージを直接チャネル API 上に送信することによって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をクライアントとサーバーの両方として使用します。  
+  
+ このサンプルを実行すると、次の出力が予測されます。  
+  
+ クライアント:  
+  
+```  
+Calling soap://stockservice.contoso.com/wse/samples/2003/06/TcpSyncStockService  
+  
+Symbol: FABRIKAM  
+        Name: Fabrikam, Inc.  
+        Last Price: 120  
+  
+Symbol: CONTOSO  
+        Name: Contoso Corp.  
+        Last Price: 50.07  
+Press enter.  
+  
+Received Action: http://SayHello  
+Received Body: to you.  
+Hello to you.  
+Press enter.  
+  
+Received Action: http://NotHello  
+Received Body: to me.  
+Press enter.  
+```  
+  
+ サーバー  
+  
+```  
+Listening for messages at soap://stockservice.contoso.com/wse/samples/2003/06/TcpSyncStockService  
+  
+Press any key to exit when done...  
+  
+Request received.  
+Symbols:  
+        FABRIKAM  
+        CONTOSO  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルを実行するには、WSE 3.0 と WSE `TcpSyncStockService` サンプルがインストールされている必要があります。WSE 3.0 は、[MSDN](http://go.microsoft.com/fwlink/?LinkId=95000) からダウンロードできます。  
+  
+> [!NOTE]
+>  [!INCLUDE[lserver](../../../../includes/lserver-md.md)] では WSE 3.0 がサポートされていないので、このオペレーティング システムでは `TcpSyncStockService` サンプルをインストールすることも、実行することもできません。  
+  
+1.  `TcpSyncStockService` サンプルをインストールしたら、次の手順を実行します。  
+  
+    1.  Visual Studio で `TcpSyncStockService` を開きます \(TcpSyncStockService サンプルは WSE 3.0 と共にインストールされます。このサンプル コードの一部ではありません\)。  
+  
+    2.  StockService プロジェクトをスタートアップ プロジェクトに設定します。  
+  
+    3.  StockService プロジェクトの StockService.cs を開き、`StockService` クラスの \[Policy\] 属性をコメント化します。これにより、サンプルのセキュリティが無効になります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は WSE 3.0 のセキュリティで保護されたエンドポイントと相互運用できますが、このサンプルではカスタム TCP トランスポートに重点を置くため、セキュリティを無効にします。  
+  
+    4.  F5 キーを押して、`TcpSyncStockService` を開始します。サービスが新しいコンソール ウィンドウで開始します。  
+  
+    5.  Visual Studio で、この TCP トランスポートのサンプルを開きます。  
+  
+    6.  TestCode.cs 内の hostname 変数の値を、`TcpSyncStockService` が実行されているコンピューター名に一致するように更新します。  
+  
+    7.  F5 キーを押して、TCP トランスポートのサンプルを開始します。  
+  
+    8.  TCP トランスポートのテスト クライアントが、新しいコンソールで開始します。クライアントはサービスに株価情報を要求し、その結果がコンソール ウィンドウに表示されます。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/trusted-facade-service.md b/docs/framework/wcf/samples/trusted-facade-service.md
new file mode 100644
index 00000000000..72fea5d1fd6
--- /dev/null
+++ b/docs/framework/wcf/samples/trusted-facade-service.md
@@ -0,0 +1,302 @@
+---
+title: "信頼されたファサード サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c34d1a8f-e45e-440b-a201-d143abdbac38
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 信頼されたファサード サービス
+このシナリオのサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] セキュリティ インフラストラクチャを使用して、呼び出し元の ID 情報をあるサービスから別のサービスにフローする方法を示します。  
+  
+ ファサード サービスを使用してサービスから提供される機能をパブリック ネットワークに公開するのは、一般的なデザイン パターンです。 ファサード サービスは、通常は境界ネットワーク \(DMZ、非武装地帯、およびスクリーン サブネットとも呼ばれます\) 内に存在し、ビジネス ロジックを実装して内部データにアクセスする、バックエンド サービスと通信します。 ファサード サービスとバックエンド サービス間の通信チャネルはファイアウォールを通過し、通常は 1 つの目的のみに限定されます。  
+  
+ このサンプルは、次のコンポーネントで構成されています。  
+  
+-   電卓クライアント  
+  
+-   電卓ファサード サービス  
+  
+-   電卓バックエンド サービス  
+  
+ ファサード サービスは、要求を検証して呼び出し元を認証します。 認証と検証が正常に完了すると、ファサード サービスは、境界ネットワークから内部ネットワークへの制御された通信チャネルを使用して、バックエンド サービスに要求を転送します。 ファサード サービスは、転送される要求の一部として呼び出し元の ID に関する情報を格納し、バックエンド サービスがプロセスでこの情報を使用できるようにします。 呼び出し元の ID は、メッセージの `Username` ヘッダー内部にある `Security` セキュリティ トークンを使用して送信されます。 このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャを使用し、この情報を送信して `Security` ヘッダーから抽出します。  
+  
+> [!IMPORTANT]
+>  バックエンド サービスは、ファサード サービスを信頼して呼び出し元を認証します。 このため、バックエンド サービスは呼び出し元の再認証を行いません。つまり、ファサード サービスから転送された要求内の ID 情報を使用します。 こうした信頼関係があるので、バックエンド サービスでは、転送メッセージが信頼されたソース \(この場合はファサード サービス\) から送信されことを確認するために、ファサード サービスを認証する必要があります。  
+  
+## 実装  
+ このサンプルには、通信パスが 2 つあります。 1 つはクライアントとファサード サービス間のパスで、もう 1 つはファサード サービスとバックエンド サービス間のパスです。  
+  
+### クライアントとファサード サービス間の通信パス  
+ クライアントとファサード サービスとの通信パスでは、`wsHttpBinding` 型のクライアント資格情報が設定された `UserName` を使用します。 つまり、クライアントはユーザー名とパスワードを使用してファサード サービスに対する認証を行い、ファサード サービスは X.509 証明書を使用してクライアントに対する認証を行います。 バインディング構成は次の例のようになります。  
+  
+```  
+<bindings>  
+  <wsHttpBinding>  
+    <binding name="Binding1">  
+      <security mode="Message">  
+        <message clientCredentialType="UserName"/>  
+      </security>  
+    </binding>  
+  </wsHttpBinding>  
+</bindings>  
+```  
+  
+ ファサード サービスはカスタム `UserNamePasswordValidator` 実装を使用して、呼び出し元を認証します。 この認証では、デモンストレーション用に、呼び出し元のユーザー名と指定されたパスワードが一致していることだけを確認します。 実環境では多くの場合、Active Directory またはカスタムの ASP.NET メンバシップ プロバイダを使用して認証が行われます。 検証の実装は `FacadeService.cs` ファイルにあります。  
+  
+```  
+public class MyUserNamePasswordValidator : UserNamePasswordValidator  
+{  
+    public override void Validate(string userName, string password)  
+    {  
+        // check that username matches password  
+        if (null == userName || userName != password)  
+        {  
+            Console.WriteLine("Invalid username or password");  
+            throw new SecurityTokenValidationException(  
+                       "Invalid username or password");  
+        }  
+    }  
+}  
+```  
+  
+ カスタム検証が、ファサード サービス構成ファイルの `serviceCredentials` 動作の内側で使用されるよう構成されます。 この動作は、サービスの X.509 証明書の構成にも使用されます。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="FacadeServiceBehavior">  
+      <!--The serviceCredentials behavior allows you to define -->  
+      <!--a service certificate. -->  
+      <!--A service certificate is used by the service to  -->  
+      <!--authenticate itself to its clients and to provide  -->  
+      <!--message protection. -->  
+      <!--This configuration references the "localhost"  -->  
+      <!--certificate installed during the setup instructions. -->  
+      <serviceCredentials>  
+        <serviceCertificate   
+               findValue="localhost"   
+               storeLocation="LocalMachine"   
+               storeName="My"   
+               x509FindType="FindBySubjectName" />  
+        <userNameAuthentication userNamePasswordValidationMode="Custom"  
+            customUserNamePasswordValidatorType=  
+           "Microsoft.ServiceModel.Samples.MyUserNamePasswordValidator,  
+            FacadeService"/>  
+      </serviceCredentials>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+### ファサード サービスと バックエンド サービス間の通信パス  
+ ファサード サービスとバックエンド サービスとの通信パスでは、複数のバインディング要素で構成される `customBinding` を使用します。 このバインディングにより、次の 2 つが実現されます。 まず、ファサード サービスとバックエンド サービスが認証され、通信がセキュリティで保護されていることと、信頼されたソースからのものであることが確認されます。 次に、`Username` セキュリティ トークン内にある、最初の呼び出し元の ID が送信されます。 この場合、最初の呼び出し元のユーザー名だけがバックエンド サービスに送信されます。パスワードはメッセージには含まれません。 これは、バックエンド サービスがファサード サービスに要求を転送する前に、ファサード サービスを信頼して呼び出し元を認証するためです。 ファサード サービスはバックエンド サービスに対して自己認証を行うので、バックエンド サービスは転送された要求に含まれる情報を信頼できます。  
+  
+ この通信パスのバインディング構成は次のようになります。  
+  
+```  
+<bindings>  
+  <customBinding>  
+    <binding name="ClientBinding">  
+      <security authenticationMode="UserNameOverTransport"/>  
+      <windowsStreamSecurity/>  
+      <tcpTransport/>  
+    </binding>  
+  </customBinding>  
+</bindings>  
+```  
+  
+ [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-custombinding.md) バインディング要素により、最初の呼び出し元のユーザー名の送信および抽出が行われます。[\<windowsStreamSecurity\>](../../../../docs/framework/configure-apps/file-schema/wcf/windowsstreamsecurity.md) と [\<tcpTransport\>](../../../../docs/framework/configure-apps/file-schema/wcf/tcptransport.md) により、ファサード サービスおよびバックエンド サービスの認証と、メッセージの保護が行われます。  
+  
+ 要求を転送するには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャが、転送するメッセージに最初の呼び出し元のユーザー名を格納できるように、ファサード サービスの実装でこのユーザー名を提供する必要があります。 最初の呼び出し元のユーザー名をファサード サービスの実装で提供するには、ファサード サービスがバックエンド サービスとの通信に使用するクライアント プロキシ インスタンスの `ClientCredentials` プロパティに、このユーザー名を設定します。  
+  
+ `GetCallerIdentity` メソッドをファサード サービスに実装する方法を次のコードに示します。 他のメソッドも同じパターンを使用します。  
+  
+```  
+public string GetCallerIdentity()  
+{  
+    CalculatorClient client = new CalculatorClient();  
+    client.ClientCredentials.UserName.UserName = ServiceSecurityContext.Current.PrimaryIdentity.Name;  
+    string result = client.GetCallerIdentity();  
+    client.Close();  
+    return result;  
+}  
+```  
+  
+ 前のコードに示すように、`ClientCredentials` プロパティではパスワードは設定されず、ユーザー名のみが設定されています。 この場合、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャではユーザー名セキュリティ トークンが作成されますが、パスワードは指定されません。このシナリオで実際に必要となるのは、この設定です。  
+  
+ バックエンド サービスでは、ユーザー名セキュリティ トークンに含まれる情報が認証される必要があります。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティの既定では、指定されたパスワードを使用してユーザーを Windows アカウントに割り当てようとします。 この場合、パスワードは指定されず、バックエンド サービスはユーザー名を認証する必要がありません。ファサード サービスで既に認証が行われているからです。 この機能を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] に実装するには、強制的にユーザー名をトークンで指定するだけでその他の認証を実行しない、カスタム `UserNamePasswordValidator` を指定します。  
+  
+```  
+public class MyUserNamePasswordValidator : UserNamePasswordValidator  
+{  
+    public override void Validate(string userName, string password)  
+    {  
+        // Ignore the password because it is empty,   
+        // we trust the facade service to authenticate the client.  
+        // Accept the username information here so that the   
+        // application gets access to it.  
+        if (null == userName)  
+        {  
+            Console.WriteLine("Invalid username");  
+            throw new   
+             SecurityTokenValidationException("Invalid username");  
+        }  
+    }  
+}  
+```  
+  
+ カスタム検証が、ファサード サービス構成ファイルの `serviceCredentials` 動作の内側で使用されるよう構成されます。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name="BackendServiceBehavior">  
+      <serviceCredentials>  
+        <userNameAuthentication userNamePasswordValidationMode="Custom"  
+           customUserNamePasswordValidatorType=  
+          "Microsoft.ServiceModel.Samples.MyUserNamePasswordValidator,   
+           BackendService"/>  
+      </serviceCredentials>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+```  
+  
+ ユーザー名の情報と信頼されたファサード サービス アカウントに関する情報を抽出するには、バックエンド サービスの実装で `ServiceSecurityContext` クラスを使用します。`GetCallerIdentity` メソッドを実装する方法を次のコードに示します。  
+  
+```  
+public string GetCallerIdentity()  
+{  
+    // Facade service is authenticated using Windows authentication.  
+    //Its identity is accessible.  
+    // On ServiceSecurityContext.Current.WindowsIdentity.  
+    string facadeServiceIdentityName =   
+          ServiceSecurityContext.Current.WindowsIdentity.Name;  
+  
+    // The client name is transmitted using Username authentication on   
+    //the message level without the password  
+    // using a supporting encrypted UserNameToken.  
+    // Claims extracted from this supporting token are available in   
+    // ServiceSecurityContext.Current.AuthorizationContext.ClaimSets   
+    // collection.  
+    string clientName = null;  
+    foreach (ClaimSet claimSet in   
+        ServiceSecurityContext.Current.AuthorizationContext.ClaimSets)  
+    {  
+        foreach (Claim claim in claimSet)  
+        {  
+            if (claim.ClaimType == ClaimTypes.Name &&   
+                                   claim.Right == Rights.Identity)  
+            {  
+                clientName = (string)claim.Resource;  
+                break;  
+            }  
+        }  
+    }  
+    if (clientName == null)  
+    {  
+        // In case there was no UserNameToken attached to the request.  
+        // In the real world implementation the service should reject   
+        // this request.  
+        return "Anonymous caller via " + facadeServiceIdentityName;  
+    }  
+  
+    return clientName + " via " + facadeServiceIdentityName;  
+}  
+```  
+  
+ ファサード サービス アカウント情報は、`ServiceSecurityContext.Current.WindowsIdentity` プロパティを使用して抽出されます。 最初の呼び出し元に関する情報にアクセスするには、バックエンド サービスで `ServiceSecurityContext.Current.AuthorizationContext.ClaimSets` プロパティを使用します。 そして、型 `Identity` を含む `Name` クレームを検索します。 このクレームは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャによって、`Username` セキュリティ トークンに含まれる情報から自動的に生成されます。  
+  
+## サンプルの実行  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。 クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。 ファサード サービスまたはバックエンド サービスのコンソール ウィンドウで Enter キーを押すと、サービスがシャットダウンされます。  
+  
+```  
+Username authentication required.  
+Provide a valid machine or domain ac  
+   Enter username:  
+user  
+   Enter password:  
+****  
+user via MyMachine\testaccount  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ 信頼されたファサード シナリオのサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーが構成され、クライアントに対して自己認証を行う証明書ベースのセキュリティが必要なファサード サービスを実行できるようになります。 詳細については、このトピック末尾のセットアップ手順を参照してください。  
+  
+ 次に、バッチ ファイルの各セクションの概要を簡単に説明します。  
+  
+-   サーバー証明書の作成。  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+    ```  
+  
+     `%SERVER_NAME%` 変数はサーバー名を指定します。既定値は localhost です。 証明書は LocalMachine ストアに保存されます。  
+  
+-   クライアントの信頼された証明書ストアへのファサード サービスの証明書のインストール。  
+  
+     次の行は、ファサード サービスの証明書をクライアントの信頼されたユーザーのストアにコピーします。 この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。 マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  Makecert.exe が存在するフォルダがパスに含まれていることを確認します。  
+  
+2.  Setup.bat をサンプルのインストール フォルダーで実行します。 これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+3.  別のコンソール ウィンドウで、\\BackendService\\bin ディレクトリの BackendService.exe を起動します。  
+  
+4.  別のコンソール ウィンドウで、\\FacadeService\\bin ディレクトリの FacadeService.exe を起動します。  
+  
+5.  Client.exe を \\client\\bin で起動します。 クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+6.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。 続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。 このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\TrustedFacade`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/two-way-communication.md b/docs/framework/wcf/samples/two-way-communication.md
new file mode 100644
index 00000000000..9fdf52fd971
--- /dev/null
+++ b/docs/framework/wcf/samples/two-way-communication.md
@@ -0,0 +1,347 @@
+---
+title: "双方向通信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb64192d-b3ea-4e02-9fb3-46a508d26c60
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 双方向通信
+このサンプルでは、双方向のトランザクション化キューを MSMQ を介して実行する方法を示します。  このサンプルでは、`netMsmqBinding` バインディングを使用します。  このサンプルのサービスは自己ホスト型コンソール アプリケーションであるので、サンプルを実行すると、キューに置かれたメッセージをサービスが受信するようすを観察できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、「[トランザクション MSMQ バインディング](../../../../docs/framework/wcf/samples/transacted-msmq-binding.md)」に基づいています。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。  クライアントはメッセージをキューに送信し、サービスはメッセージをキューから受信します。  したがって、キューを使用する通信では、サービスとクライアントが同時に実行されていなくてもかまいません。  
+  
+ このサンプルでは、キューを使用する双方向通信の例を示します。  クライアントは、トランザクションのスコープ内から発注書をキューに送信します。  サービスは、注文を受信して処理し、注文ステータスをキューからクライアントに返信します。これらの処理を、トランザクションのスコープ内で実行します。  双方向通信を使用するには、クライアントとサービスの両方がキューを使用して、発注書や注文ステータスをキューに追加する必要があります。  
+  
+ サービス コントラクト `IOrderProcessor` は、キューの使用に合わせた一方向サービス操作を定義します。  サービス操作には、注文ステータスの送信に使用される応答エンドポイントが含まれます。  応答エンドポイントは、注文ステータスをクライアントに返信するためのキューの URI です。  注文処理アプリケーションは、このコントラクトを実装します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void SubmitPurchaseOrder(PurchaseOrder po, string   
+                                  reportOrderStatusTo);  
+}  
+  
+```  
+  
+ 注文ステータスを送信する応答コントラクトは、クライアントが指定します。  クライアントは注文ステータス コントラクトを実装します。  サービスは、このコントラクトについて生成されたプロキシを使用して、注文ステータスをクライアントに返信します。  
+  
+```  
+[ServiceContract]  
+public interface IOrderStatus  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void OrderStatus(string poNumber, string status);  
+}  
+```  
+  
+ サービス操作は、送信された発注書を処理します。  サービス操作に適用される <xref:System.ServiceModel.OperationBehaviorAttribute> では、キューからのメッセージ受信に使用されるトランザクションに自動的に帰属することと、サービス操作の完了時にトランザクションを自動的に完了させることが指定されています。  `Orders` クラスは、注文処理機能をカプセル化します。  この例では、発注書をディクショナリに追加します。  このサービス操作が帰属するしているトランザクションは、`Orders` クラス内の操作で使用できます。  
+  
+ サービス操作は、送信された発注書を処理するだけでなく、注文ステータスをクライアントに戻します。  
+  
+```  
+[OperationBehavior(TransactionScopeRequired = true, TransactionAutoComplete = true)]  
+public void SubmitPurchaseOrder(PurchaseOrder po, string reportOrderStatusTo)  
+{  
+    Orders.Add(po);  
+    Console.WriteLine("Processing {0} ", po);  
+    Console.WriteLine("Sending back order status information");  
+    NetMsmqBinding msmqCallbackBinding = new NetMsmqBinding("ClientCallbackBinding");  
+    OrderStatusClient client = new OrderStatusClient(msmqCallbackBinding, new EndpointAddress(reportOrderStatusTo));  
+  
+    // Please note that the same transaction that is used to dequeue the purchase order is used  
+    // to send back order status.  
+    using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+    {  
+        client.OrderStatus(po.PONumber, po.Status);  
+        scope.Complete();  
+    }  
+    //Close the client.  
+    client.Close();  
+}  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションで指定されます。  サービスのエンドポイントは、構成ファイルの System.ServiceModel セクションで定義されます。  
+  
+> [!NOTE]
+>  MSMQ のキュー名とエンドポイント アドレスでは、若干異なるアドレス表記が使用されています。  MSMQ のキュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。  [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のエンドポイント アドレスでは、net.msmq: スキームを使用します。"localhost" を使用してローカル コンピュータを表し、スラッシュを使用してパスを区切ります。  リモート コンピューターでホストされているキューからの読み出しを行うには、"." や "localhost" をリモート コンピューター名に置き換えます。  
+  
+ サービスは自己ホスト型です。  MSMQ トランスポートを使用する場合、使用するキューをあらかじめ作成しておく必要があります。  手動で作成することもコードで作成することもできます。  このサンプルでは、サービスがキューの存在を確認し、必要な場合はキューを作成します。  キュー名は構成ファイルから読み込まれます。  ベース アドレスは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で使用され、サービスにプロキシが生成されます。  
+  
+```  
+// Host the service within this EXE console application.  
+public static void Main()  
+{  
+    // Get MSMQ queue name from appSettings in configuration.  
+    string queueName = ConfigurationManager.AppSettings["queueName"];  
+  
+    // Create the transacted MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName, true);  
+  
+    // Create a ServiceHost for the OrderProcessorService type.  
+    using (ServiceHost serviceHost = new ServiceHost(typeof(OrderProcessorService)))  
+    {  
+        // Open the ServiceHost to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+    }  
+}  
+```  
+  
+ クライアントはトランザクションを作成します。  キューとの通信はトランザクションのスコープ内で実行されるので、全体が 1 つのアトミックな単位として扱われ、すべてのメッセージが成功するか、すべてのメッセージが失敗するかのいずれかになります。  
+  
+```  
+// Create a ServiceHost for the OrderStatus service type.  
+using (ServiceHost serviceHost = new ServiceHost(typeof(OrderStatusService)))  
+{  
+  
+    // Open the ServiceHostBase to create listeners and start listening for order status messages.  
+    serviceHost.Open();  
+  
+    // Create the purchase order.  
+    ...  
+  
+    // Create a client with given client endpoint configuration.  
+    OrderProcessorClient client = new OrderProcessorClient("OrderProcessorEndpoint");  
+  
+    //Create a transaction scope.  
+    using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+    {  
+        string hostName = Dns.GetHostName();  
+  
+        // Make a queued call to submit the purchase order.  
+        client.SubmitPurchaseOrder(po, "net.msmq://" + hostName + "/private/ServiceModelSamplesTwo-way/OrderStatus");  
+  
+        // Complete the transaction.  
+        scope.Complete();  
+    }  
+  
+    //Close down the client.  
+    client.Close();  
+  
+    Console.WriteLine();  
+    Console.WriteLine("Press <ENTER> to terminate client.");  
+    Console.ReadLine();  
+  
+    // Close the ServiceHost to shutdown the service.  
+    serviceHost.Close();  
+}  
+  
+```  
+  
+ クライアント コードは `IOrderStatus` コントラクトを実装して、サービスからの注文ステータスを受信します。  この場合は、注文ステータスを出力します。  
+  
+```  
+[ServiceBehavior]  
+public class OrderStatusService : IOrderStatus  
+{  
+    [OperationBehavior(TransactionAutoComplete = true,   
+                        TransactionScopeRequired = true)]  
+    public void OrderStatus(string poNumber, string status)  
+    {  
+        Console.WriteLine("Status of order {0}:{1} ", poNumber ,   
+                                                           status);  
+    }  
+}  
+  
+```  
+  
+ 注文ステータス キューは `Main` メソッド内で作成します。  クライアント構成には、注文ステータス サービスをホストするための注文ステータス サービス構成が含まれています。次のサンプル構成を参照してください。  
+  
+```  
+<appSettings>  
+  <!-- Use appSetting to configure MSMQ queue name. -->  
+  <add key="queueName" value=".\private$\ServiceModelSamplesTwo-way/OrderStatus" />  
+</appSettings>  
+  
+<system.serviceModel>  
+  
+  <services>  
+    <service   
+       name="Microsoft.ServiceModel.Samples.OrderStatusService">  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint address="net.msmq://localhost/private/ServiceModelSamplesTwo-way/OrderStatus"  
+                binding="netMsmqBinding"  
+                contract="Microsoft.ServiceModel.Samples.IOrderStatus" />  
+    </service>  
+  </services>  
+  
+  <client>  
+    <!-- Define NetMsmqEndpoint -->  
+    <endpoint name="OrderProcessorEndpoint"  
+              address="net.msmq://localhost/private/ServiceModelSamplesTwo-way/OrderProcessor"   
+              binding="netMsmqBinding"   
+              contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+  </client>  
+  
+</system.serviceModel>  
+  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。  サービスがクライアントから受信したメッセージを表示できます。  どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+ サービスによって発注書の情報が表示され、注文ステータスがサービスから注文ステータス キューに返信されることも表示されます。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Processing Purchase Order: 124a1f69-3699-4b16-9bcc-43147a8756fc  
+        Customer: somecustomer.com  
+        OrderDetails  
+                Order LineItem: 54 of Blue Widget @unit price: $29.99  
+                Order LineItem: 890 of Red Widget @unit price: $45.89  
+        Total cost of this order: $42461.56  
+        Order status: Pending  
+  
+Sending back order status information  
+```  
+  
+ クライアントには、サービスから送信された注文ステータス情報が表示されます。  
+  
+```  
+Press <ENTER> to terminate client.  
+Status of order 124a1f69-3699-4b16-9bcc-43147a8756fc:Pending  
+  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  Svcutil.exe を使用してこのサンプルの構成を再生成した場合は、クライアント コードに一致するように、クライアント構成内のエンドポイント名を変更してください。  
+  
+ <xref:System.ServiceModel.NetMsmqBinding> を使用する場合の既定では、トランスポート セキュリティが有効です。  MSMQ トランスポート セキュリティに関係するプロパティには、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> と <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> の 2 つがあります。既定の設定では、認証モードは `Windows`、保護レベルは `Sign` です。  MSMQ の認証機能と署名機能を利用するには、ドメインに MSMQ があることと、MSMQ に関する Active Directory の統合オプションがインストールされていることが必要です。  この条件を満たしていないコンピューターでこのサンプルを実行すると、エラーになります。  
+  
+### ワークグループに属しているコンピューターまたは Active Directory 統合のないコンピューターでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピュータ、または Active Directory 統合がインストールされていないコンピュータを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを `None` にします。この構成の例を次に示します。  
+  
+    ```  
+    <configuration>  
+  
+      <appSettings>  
+        <!-- Use appSetting to configure MSMQ queue name. -->  
+        <add key="queueName" value=".\private$\ServiceModelSamplesTwo-way/OrderProcessor" />  
+      </appSettings>  
+  
+      <system.serviceModel>  
+        <services>  
+          <service   
+              name="Microsoft.ServiceModel.Samples.OrderProcessorService">  
+            <!-- Define NetMsmqEndpoint -->  
+            <endpoint address="net.msmq://localhost/private/ServiceModelSamplesTwo-way/OrderProcessor"  
+                      binding="netMsmqBinding"  
+                      bindingConfiguration="TransactedBinding"   
+                      contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+          </service>  
+        </services>  
+  
+        <bindings>  
+          <netMsmqBinding>  
+            <binding name="TransactedBinding" >  
+             <security mode="None" />  
+            </binding>  
+          </netMsmqBinding>  
+        </bindings>  
+  
+      </system.serviceModel>  
+  
+    </configuration>  
+  
+    ```  
+  
+2.  クライアント構成のセキュリティをオフにすると、次のコードが生成されます。  
+  
+    ```  
+    <?xml version="1.0" encoding="utf-8" ?>  
+    <configuration>  
+      <appSettings>  
+        <!-- Use appSetting to configure MSMQ queue name. -->  
+        <add key="queueName" value=".\private$\ServiceModelSamplesTwo-way/OrderStatus" />  
+      </appSettings>  
+  
+      <system.serviceModel>  
+  
+        <services>  
+          <service   
+             name="Microsoft.ServiceModel.Samples.OrderStatusService">  
+            <!-- Define NetMsmqEndpoint -->  
+            <endpoint address="net.msmq://localhost/private/ServiceModelSamplesTwo-way/OrderStatus"  
+                      binding="netMsmqBinding"  
+                      bindingConfiguration="TransactedBinding" contract="Microsoft.ServiceModel.Samples.IOrderStatus" />  
+          </service>  
+        </services>  
+  
+        <client>  
+          <!-- Define NetMsmqEndpoint -->  
+          <endpoint name="OrderProcessorEndpoint"  
+                    address="net.msmq://localhost/private/ServiceModelSamplesTwo-way/OrderProcessor"   
+                    binding="netMsmqBinding"   
+                    bindingConfiguration="TransactedBinding"  
+                    contract="Microsoft.ServiceModel.Samples.IOrderProcessor" />  
+        </client>  
+  
+        <bindings>  
+          <netMsmqBinding>  
+            <binding name="TransactedBinding" >  
+             <security mode="None" />  
+            </binding>  
+          </netMsmqBinding>  
+        </bindings>  
+  
+      </system.serviceModel>  
+  
+    </configuration>  
+    ```  
+  
+3.  このサンプルのサービスは、`OrderProcessorService` でバインディングを作成します。  このバインディングをインスタンス化した後に、コード行を 1 行追加して、セキュリティ モードを `None` に設定します。  
+  
+    ```  
+    NetMsmqBinding msmqCallbackBinding = new NetMsmqBinding();  
+    msmqCallbackBinding.Security.Mode = NetMsmqSecurityMode.None;  
+    ```  
+  
+4.  サーバーとクライアントの両方の構成を変更したことを確認してから、サンプルを実行します。  
+  
+    > [!NOTE]
+    >  `security mode` を `None` に設定することは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A>、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A>、または `Message` のセキュリティを `None` に設定することに相当します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Binding\Net\MSMQ\Two-Way`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/typed-client.md b/docs/framework/wcf/samples/typed-client.md
new file mode 100644
index 00000000000..41a047368a9
--- /dev/null
+++ b/docs/framework/wcf/samples/typed-client.md
@@ -0,0 +1,79 @@
+---
+title: "型指定のあるクライアント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 62c40e8f-e9b4-4b1a-939a-93c37393d343
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# 型指定のあるクライアント
+このサンプルでは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で生成された型指定のあるクライアントから情報を取得する方法を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ クライアントの `Endpoint` プロパティを使用すると、アドレス、バインディング、およびコントラクトの情報など、クライアントが通信しているサービス エンドポイントに関する情報にアクセスできます。クライアントの `InnerChannel` プロパティは、<xref:System.ServiceModel.IClientChannel> のインスタンスです。このプロパティにより、状態やセッション識別子などの、基になるチャネルに関する情報にアクセスできます。  
+  
+```  
+// Create a client.  
+CalculatorClient client = new CalculatorClient();  
+...  
+Console.WriteLine("Client - endpoint:  " + client.Endpoint.Address);  
+Console.WriteLine("Client - binding:  " + client.Endpoint.Binding.Name);  
+Console.WriteLine("Client - contract: " + client.Endpoint.Contract.Name);  
+  
+IClientChannel channel = client.InnerChannel;  
+Console.WriteLine("Client channel - state: " + channel.State);  
+Console.WriteLine("Client channel - session identifier: " + channel.SessionId);  
+  
+//Closing the client gracefully closes the connection and cleans up resources.  
+client.Close();  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Client - endpoint:  http://localhost/servicemodelsamples/service.svc  
+Client - binding:  WSHttpBinding  
+Client - contract: ICalculator  
+Client channel - state: Opened  
+Client channel - session identifier: urn:uuid:ae16fbc4-2964-4e87-9fb1-c5aa78fc567e  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\TypedClient`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/udp-activation.md b/docs/framework/wcf/samples/udp-activation.md
new file mode 100644
index 00000000000..40e6809acdb
--- /dev/null
+++ b/docs/framework/wcf/samples/udp-activation.md
@@ -0,0 +1,173 @@
+---
+title: "UDP アクティベーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4b0ccd10-0dfb-4603-93f9-f0857c581cb7
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# UDP アクティベーション
+このサンプルは、「[トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md)」のサンプルに基づいています。ここでは [トランスポート: UDP](../../../../docs/framework/wcf/samples/transport-udp.md) のサンプルを拡張し、Windows プロセス アクティブ化サービス \(WAS\) を使用してプロセスのアクティベーションをサポートするようにします。  
+  
+ サンプルは、次の 3 つの主要素で構成されます。  
+  
+-   UDP プロトコル アクティベータ。アクティベーション対象のアプリケーションの代わりに UDP メッセージを受信するスタンドアロンのプロセスです。  
+  
+-   UDP カスタム トランスポートを使用してメッセージを送信するクライアント。  
+  
+-   UDP カスタム トランスポート経由でメッセージを受信するサービス。WAS によってアクティブ化されるワーカー プロセス内でホストされています。  
+  
+## UDP プロトコル アクティベータ  
+ UDP プロトコル アクティベータは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントと [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス間のブリッジです。トランスポート層で UDP プロトコルを介するデータ通信を実現します。主な機能は、次の 2 つです。  
+  
+-   WAS リスナ アダプタ \(LA\)。WAS と連携し、受信メッセージに応答してプロセスをアクティブ化します。  
+  
+-   UDP プロトコル リスナ。アクティベーション対象のアプリケーションの代わりに UDP メッセージを受け入れます。  
+  
+ このアクティベータは、サーバー コンピュータ上でスタンドアロン プログラムとして実行される必要があります。通常、WAS リスナ アダプタ \(NetTcpActivator や NetPipeActivator など\) は、長時間にわたって実行される Windows サービスに実装されます。ただしこのサンプルでは、単純化してわかりやすくするために、このプロトコル アクティベータをスタンドアロン アプリケーションとして実装しています。  
+  
+### WAS リスナ アダプタ  
+ UDP の WAS リスナ アダプタは `UdpListenerAdapter` クラスに実装されています。これは WAS とやり取りするモジュールで、UDP プロトコル用アプリケーションのアクティベーションを実行します。これは、次の Webhost API を呼び出すことによって実行されます。  
+  
+-   `WebhostRegisterProtocol`  
+  
+-   `WebhostUnregisterProtocol`  
+  
+-   `WebhostOpenListenerChannelInstance`  
+  
+-   `WebhostCloseAllListenerChannelInstances`  
+  
+ このリスナ アダプタは、`WebhostRegisterProtocol` を最初に呼び出した後、applicationHost.config \(%windir%\\system32\\inetsrv 内にあります\) に登録されているすべてのアプリケーションの WAS からコールバック `ApplicationCreated` を受信します。このサンプルで処理するのは、\(プロトコル ID が "net.udp" の\) UDP プロトコルが有効なアプリケーションだけです。他の実装でこのアプリケーションへの動的な構成変更 \(アプリケーションを無効から有効に移行する場合など\) に応答する場合、そうした実装では異なる方法でアプリケーションを処理することがあります。  
+  
+ コールバック `ConfigManagerInitializationCompleted` が受信される場合、WAS により、プロトコルの初期化に関するすべての通知が完了したことを示します。その時点で、リスナ アダプタはアクティベーション要求を処理する準備ができています。  
+  
+ アプリケーションに初めて新しい要求が届くと、このリスナ アダプタは `WebhostOpenListenerChannelInstance` を WAS に呼び出します。ワーカー プロセスがまだ開始されていない場合は、これにより開始されます。次に、プロトコル ハンドラが読み込まれ、リスナ アダプタと仮想アプリケーション間の通信を開始できるようになります。  
+  
+ このリスナ アダプタは、次のように \<`listenerAdapters`\> セクションの %SystemRoot%\\System32\\inetsrv\\ApplicationHost.config に登録されています。  
+  
+```  
+<add name="net.udp" identity="S-1-5-21-2127521184-1604012920-1887927527-387045" />  
+```  
+  
+### プロトコル リスナ  
+ UDP プロトコル リスナはプロトコル アクティベータ内部のモジュールで、仮想アプリケーションの代わりに UDP エンドポイントでリッスンします。これは `UdpSocketListener` クラスに実装されています。エンドポイントは `IPEndpoint` として表され、このポート番号はサイトのプロトコルのバインディングから抽出されます。  
+  
+### サービスの制御  
+ このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用してアクティベータと WAS ワーカー プロセス間で通信を行います。アクティベータに存在するサービスは、コントロール サービスと呼ばれます。  
+  
+## プロトコル ハンドラー  
+ リスナ アダプタが `WebhostOpenListenerChannelInstance` を呼び出した後、ワーカー プロセスが開始されていない場合は WAS プロセス マネージャによって開始されます。ワーカー プロセス内部のアプリケーション マネージャは、UDP プロセス プロトコル ハンドラ \(PPH\) を読み込み、`ListenerChannelId` を要求します。次に、PPH は `IAdphManager`.`StartAppDomainProtocolListenerChannel` を呼び出して、UDP AppDomain プロトコル ハンドラ \(ADPH\) を開始します。  
+  
+## HostedUDPTransportConfiguration  
+ この情報は、Web.config で次のように登録されます。  
+  
+```  
+<serviceHostingEnvironment>  
+<add name="net.udp" transportConfigurationType="Microsoft.ServiceModel.Samples.Hosting.HostedUdpTransportConfiguration, UdpActivation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6fa904d2da1848d6" />  
+</serviceHostingEnvironment>  
+```  
+  
+## このサンプルの特殊なセットアップ  
+ このサンプルは、Windows Vista、Windows Server 2008、または Windows 7 でのみビルドおよび実行可能です。サンプルを実行するには、最初にすべてのコンポーネントを正しくセットアップする必要があります。サンプルをインストールするには、次の手順に従います。  
+  
+#### このサンプルをセットアップするには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  Windows Vista でプロジェクトをビルドします。コンパイル後、ビルド後のフェーズで次の操作を実行します。  
+  
+    -   UDP バインディングを \[既定の Web サイト\] のサイトにインストールします。  
+  
+    -   物理パス "%SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples" をポイントする、仮想アプリケーション "ServiceModelSamples" を作成します。  
+  
+    -   さらに、この仮想アプリケーションの "net.udp" プロトコルを有効にします。  
+  
+3.  ユーザー インターフェイス アプリケーション "WasNetActivator.exe" を起動します。**\[セットアップ\]** タブをクリックして次のチェック ボックスをオンにし、**\[インストール\]** をクリックしてこれらをインストールします。  
+  
+    -   UDP リスナ アダプタ  
+  
+    -   UDP プロトコル ハンドラ  
+  
+4.  ユーザー インターフェイス アプリケーション "WasNetActivator.exe" の **\[アクティブ化\]** タブをクリックします。**\[開始\]** をクリックして、リスナ アダプタを開始します。これで、プログラムを実行する準備ができました。  
+  
+    > [!NOTE]
+    >  このサンプルの実行後は、Cleanup.bat を実行して、\[既定の Web サイト\] から net.udp バインディングを削除する必要があります。  
+  
+## サンプルの使用方法  
+ コンパイル後、次の 4 つの異なるバイナリが生成されます。  
+  
+-   Client.exe: クライアント コード。App.config は、クライアント構成ファイルの Client.exe.config にコンパイルされます。  
+  
+-   UDPActivation.dll: 主要なすべての UDP 実装を含むライブラリ。  
+  
+-   Service.dll: サービス コード。これは、ServiceModelSamples 仮想アプリケーションの \\bin ディレクトリにコピーされます。このサービス ファイルは Service.svc で、構成ファイルは Web.config です。これらをコンパイルすると、%SystemDrive%\\Inetpub\\wwwroot\\ServiceModelSamples にコピーされます。  
+  
+-   WasNetActivator: UDP アクティベータ プログラム。  
+  
+-   必要なすべての要素が正しくインストールされていることを確認します。サンプルを実行する方法を、次の手順に示します。  
+  
+1.  次の Windows サービスが開始されていることを確認します。  
+  
+    -   Windows プロセス アクティブ化サービス \(WAS\)。  
+  
+    -   インターネット インフォメーション サービス \(IIS\): W3SVC。  
+  
+2.  次に、アクティベータ WasNetActivator.exe を起動します。**\[アクティブ化\]** タブのボックスの一覧から、唯一のプロトコルである **\[UDP\]** を選択します。**\[開始\]** をクリックして、アクティベータを開始します。  
+  
+3.  アクティベータが開始されると、コマンド ウィンドウで Client.exe を実行することにより、クライアント コードを実行できます。このサンプルの出力は、次のようになります。  
+  
+    ```  
+    Testing Udp Activation.  
+    Start the status service.  
+    Sending UDP datagrams.  
+    Type a word that you want to say to the server: Hello, world!  
+        Sending datagram: Hello, world![0]  
+        Sending datagram: Hello, world![1]  
+        Sending datagram: Hello, world![2]  
+        Sending datagram: Hello, world![3]  
+        Sending datagram: Hello, world![4]  
+    Calling UDP duplex contract (ICalculatorContract).  
+        0 + 0 = 0  
+        1 + 2 = 3  
+        2 + 4 = 6  
+        3 + 6 = 9  
+        4 + 8 = 12  
+    Getting status and dump server traces:  
+        Operation 'Hello' is called: Hello, world![0]  
+        Operation 'Hello' is called: Hello, world![1]  
+        Operation 'Hello' is called: Hello, world![2]  
+        Operation 'Hello' is called: Hello, world![3]  
+        Operation 'Hello' is called: Hello, world![4]  
+        Operation 'Add' is called: 0 + 0  
+        Operation 'Add' is called: 1 + 2  
+        Operation 'Add' is called: 2 + 4  
+        Operation 'Add' is called: 3 + 6  
+        Operation 'Add' is called: 4 + 8  
+    Press <ENTER> to complete test.  
+    ```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Transport\UdpActivation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/untyped-request-reply.md b/docs/framework/wcf/samples/untyped-request-reply.md
new file mode 100644
index 00000000000..d9e571c897c
--- /dev/null
+++ b/docs/framework/wcf/samples/untyped-request-reply.md
@@ -0,0 +1,107 @@
+---
+title: "型指定のない要求/応答 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0bf0f9d9-7caf-4d3d-8c9e-2d468cca16a5
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 型指定のない要求/応答
+このサンプルは、Message クラスを使用する操作コントラクトを定義する方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。サービス コントラクトは、メッセージの種類を引数として取得してメッセージを返すという 1 つの操作を定義します。この操作は、合計の計算に必要なすべてのデータをメッセージ本文から収集し、その合計を返信メッセージの本文に格納して返送します。  
+  
+```  
+  
+[OperationContract(Action = CalculatorService.RequestAction, ReplyAction = CalculatorService.ReplyAction)]  
+Message ComputeSum(Message request);  
+  
+```  
+  
+ サービスでは、操作によって入力メッセージ内で渡された整数の配列が取得され、その合計が計算されます。応答メッセージの送信では、サンプルは適切なメッセージ バージョンと Action を含む新しいメッセージを作成し、計算された合計をメッセージ本文に追加します。これを実行するサンプル コードを次に示します。  
+  
+```  
+  
+public Message ComputeSum(Message request)  
+{  
+    //The body of the message contains a list of numbers which will be   
+    //read as a int[] using GetBody<T>  
+    int result = 0;  
+  
+    int[] inputs = request.GetBody<int[]>();  
+    foreach (int i in inputs)  
+    {  
+        result += i;  
+    }  
+  
+    Message response = Message.CreateMessage(request.Version,   
+                                      ReplyAction, result);  
+    return response;  
+}  
+  
+```  
+  
+ クライアントは [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成されるコードを使用して、リモート サービスにプロキシを作成します。要求メッセージを送信するには、クライアントにメッセージ バージョンが存在する必要があります。これは基になるチャネルによって異なります。したがって、クライアントは、作成済みのプロキシ チャネルに適用される新しい <xref:System.ServiceModel.OperationContextScope> を作成し、これが、`OutgoingMessageHeaders.MessageVersion` プロパティで設定されている正しいメッセージ バージョンにより、<xref:System.ServiceModel.OperationContext> を作成します。クライアントは入力配列を本文として要求メッセージに渡し、プロキシの `ComputeSum` を呼び出します。次にクライアントは、応答メッセージの `GetBody<T>` メソッドにアクセスし、渡した入力の合計を取得します。これを実行するサンプル コードを次に示します。  
+  
+```  
+  
+using (new OperationContextScope(client.InnerChannel))  
+{  
+    // Call the Sum service operation.  
+    int[] values = { 1, 2, 3, 4, 5 };  
+    Message request = Message.CreateMessage(  
+        OperationContext.Current.OutgoingMessageHeaders.MessageVersion,   
+        RequestAction, values);  
+    Message reply = client.ComputeSum(request);  
+    int response = reply.GetBody<int>();  
+  
+    Console.WriteLine("Sum of numbers passed (1,2,3,4,5) = {0}",   
+                                                       response);  
+}  
+  
+```  
+  
+ このサンプルは Web ホストのサンプルです。したがって、クライアント実行可能ファイルのみを実行する必要があります。クライアントでの出力のサンプルを次に示します。  
+  
+```  
+  
+Prompt>Client.exe  
+Sum of numbers passed (1,2,3,4,5) = 15  
+  
+Press <ENTER> to terminate client.  
+  
+```  
+  
+ このサンプルは Web ホストのサンプルです。したがって、手順 3. で示したリンクを確認し、サンプルのビルド方法と実行方法を確認してください。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Message\Untyped`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/unwrapped-messages.md b/docs/framework/wcf/samples/unwrapped-messages.md
new file mode 100644
index 00000000000..591f6645513
--- /dev/null
+++ b/docs/framework/wcf/samples/unwrapped-messages.md
@@ -0,0 +1,124 @@
+---
+title: "ラップされていないメッセージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 019657bd-1f9b-4315-ad74-eaa4e7551ff6
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# ラップされていないメッセージ
+このサンプルでは、ラップされていないメッセージを示します。既定では、メッセージの本文は、サービス操作に渡されるパラメータがラップされるように書式設定されます。ラップされたモードでの `ICalculator` サービスへの `Add` 要求メッセージのサンプルを次に示します。  
+  
+```  
+<s:Envelope   
+    xmlns:s=http://www.w3.org/2003/05/soap-envelope  
+    xmlns:a="http://schemas.xmlsoap.org/ws/2005/08/addressing">  
+    <s:Header>  
+        …  
+    </s:Header>  
+    <s:Body>  
+      <Add xmlns="http://Microsoft.ServiceModel.Samples">  
+        <n1>100</n1>  
+        <n2>15.99</n2>  
+      </Add>  
+    </s:Body>  
+</s:Envelope>  
+  
+```  
+  
+ メッセージ本文の `<Add>` 要素は、`n1` パラメータおよび `n2` パラメータをラップします。これに対して、ラップされていないモードでの同様のメッセージのサンプルを次に示します。  
+  
+```  
+<s:Envelope   
+    xmlns:s="http://www.w3.org/2003/05/soap-envelope"   
+    xmlns:a="http://schemas.xmlsoap.org/ws/2005/08/addressing">  
+    <s:Header>  
+        ….  
+    </s:Header>  
+    <s:Body>  
+      <n1 xmlns="http://Microsoft.ServiceModel.Samples">100</n1>  
+      <n2 xmlns="http://Microsoft.ServiceModel.Samples">15.99</n2>  
+    </s:Body>  
+  </s:Envelope>  
+</MessageLogTraceRecord>  
+  
+```  
+  
+ ラップされていないメッセージは、格納要素内の `n1` パラメータおよび `n2` パラメータをラップしません。これらのパラメータは、SOAP 本文要素の直接の子になります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、ラップされていないメッセージは、サービス操作のパラメータ型に <xref:System.ServiceModel.MessageContractAttribute> を適用して値型を返すことによって作成されます。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    ResponseMessage Add(RequestMessage request);  
+    [OperationContract]  
+    ResponseMessage Subtract(RequestMessage request);  
+    [OperationContract]  
+    ResponseMessage Multiply(RequestMessage request);  
+    [OperationContract]  
+    ResponseMessage Divide(RequestMessage request);  
+}  
+  
+//setting IsWrapped to false means the n1 and n2  
+//members will be direct children of the soap body element  
+[MessageContract(IsWrapped = false)]  
+public class RequestMessage  
+{  
+    [MessageBodyMember]  
+    private double n1;  
+    [MessageBodyMember]  
+    private double n2;  
+    //…  
+}  
+  
+//setting IsWrapped to false means the result  
+//member will be a direct child of the soap body element  
+[MessageContract(IsWrapped = false)]  
+public class ResponseMessage  
+{  
+    [MessageBodyMember]  
+    private double result;  
+    //…  
+}  
+```  
+  
+ 送受信されたメッセージを表示できるようにするため、このサンプルではトレースを使用します。さらに、<xref:System.ServiceModel.WSHttpBinding> は、記録されるメッセージ数を減らす目的で、セキュリティを無効にして構成されています。  
+  
+ 結果のトレース ログ \(c:\\logs\\Message.log\) は、[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)を使用することによって表示できます。メッセージの内容を表示するには、サービス トレース ビューア ツールの左右両方のウィンドウで **\[メッセージ\]** を選択します。このサンプルのトレース ログは、C:\\LOGS フォルダに生成されるように構成されています。サンプルの実行前にこのフォルダを作成し、ユーザー Network Service にそのディレクトリへの書き込み権限を与えます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」を実行したことを確認します。  
+  
+2.  メッセージのログ記録用に C:\\LOGS ディレクトリを作成します。ユーザー Network Service にそのディレクトリの書き込み権限を与えます。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Message\Unwrapped`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/uritemplate-sample.md b/docs/framework/wcf/samples/uritemplate-sample.md
new file mode 100644
index 00000000000..34997bb42e4
--- /dev/null
+++ b/docs/framework/wcf/samples/uritemplate-sample.md
@@ -0,0 +1,45 @@
+---
+title: "UriTemplate サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0aaf91d0-ce18-468d-8006-bc9bc2e48231
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# UriTemplate サンプル
+<xref:System.UriTemplate> クラスには、共通構造を共有する URI のセットを使用するためのメソッドが用意されています。このサンプルでは、次の `UriTemplate` に関連する重要な概念を示します。  
+  
+-   テンプレートを作成するための構文  
+  
+-   <xref:System.UriTemplate.BindByName%2A> および <xref:System.UriTemplate.BindByPosition%2A> を使用した、`UriTemplate` からの URI のインスタンス化  
+  
+-   `BindByName` および `BindByPosition` の逆の操作である <xref:System.UriTemplateTable.Match%2A>  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\UriTemplate`  
+  
+## 参照  
+ [UriTemplate テーブル](../../../../docs/framework/wcf/samples/uritemplate-table-sample.md)   
+ [UriTemplate テーブル ディスパッチャー](../../../../docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md b/docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md
new file mode 100644
index 00000000000..76be095eb6c
--- /dev/null
+++ b/docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md
@@ -0,0 +1,47 @@
+---
+title: "UriTemplate テーブル ディスパッチャーのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b32975d-ba90-4c5c-83bc-2fbb48f11c0c
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# UriTemplate テーブル ディスパッチャーのサンプル
+<xref:System.UriTemplateTable> クラスには、<xref:System.UriTemplate> インスタンスのセットを使用するための、ディクショナリに似た結合テーブル構造が用意されています。このサンプルでは、`UriTemplateTable` クラスの一般的な使用シナリオとして、`UriTemplateTable` を使用してビルドされた基本的なディスパッチ エンジンを示します。  
+  
+ このサンプルでは、次の `UriTemplateTable` クラスに関連する重要な概念を示します。  
+  
+-   `UriTemplateTable` の `UriTemplates` とのデリゲートの関連付け。  
+  
+-   <xref:System.UriTemplateTable.MatchSingle%2A> を使用した特定の URI の正しいハンドラ デリゲートの取得。  
+  
+-   要求を処理するためのハンドラー デリゲートの呼び出し。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\UriTemplateDispatcher`  
+  
+## 参照  
+ [UriTemplate テーブル](../../../../docs/framework/wcf/samples/uritemplate-table-sample.md)   
+ [UriTemplate](../../../../docs/framework/wcf/samples/uritemplate-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/uritemplate-table-sample.md b/docs/framework/wcf/samples/uritemplate-table-sample.md
new file mode 100644
index 00000000000..56ffbd16cfa
--- /dev/null
+++ b/docs/framework/wcf/samples/uritemplate-table-sample.md
@@ -0,0 +1,47 @@
+---
+title: "UriTemplate テーブル サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5dd1d38f-1989-4c64-820d-821f5a02216a
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# UriTemplate テーブル サンプル
+<xref:System.UriTemplateTable> クラスには、`UriTemplate` インスタンスのセットを使用するための、ディクショナリに似た結合テーブル構造が用意されています。特定の URI \(Uniform Resource Identifier\) をテーブル内のすべてのテンプレートと効率よく照合でき、照合されたテンプレートに関連付けられたデータを取得できます。  
+  
+ このサンプルでは、次の `UriTemplateTable` クラスに関連する重要な概念を示します。  
+  
+-   `UriTemplateTable` をインスタンス化する構文  
+  
+-   `UriTemplateTable` へのキー\/値ペアのセットの追加  
+  
+-   <xref:System.UriTemplateTable.MatchSingle%2A> を使用した候補 URI とテーブルの照合  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Web\UriTemplateTable`  
+  
+## 参照  
+ [UriTemplate テーブル ディスパッチャー](../../../../docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md)   
+ [UriTemplate](../../../../docs/framework/wcf/samples/uritemplate-sample.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/usage-of-serialization-binder.md b/docs/framework/wcf/samples/usage-of-serialization-binder.md
new file mode 100644
index 00000000000..7c244e9d33b
--- /dev/null
+++ b/docs/framework/wcf/samples/usage-of-serialization-binder.md
@@ -0,0 +1,40 @@
+---
+title: "シリアル化バインダーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab46c087-200c-45bf-9c95-5a6cda6e8b98
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# シリアル化バインダーの使用
+このサンプルでは、<xref:System.Runtime.Serialization.SerializationBinder> を使用して、ジェネリック型のバージョンをシリアル化する際に変更する方法を示します。  
+  
+## 使用例  
+ <xref:System.Runtime.Serialization.SerializationBinder>,<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter>  
+  
+## 説明  
+ このサンプルでは、さまざまなバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] を対象とする 2 つのエンティティで、バイナリ フォーマッタとシリアル化バインダーを使用して通信する方法を示します。  
+  
+ このサンプルの開発は、.NET リモート処理を使用して行われました。このサンプルは、[!INCLUDE[netfx40_long](../../../../includes/netfx40-long-md.md)] を対象とするサーバー \(ジェネリック型を含むコントラクトを実装しています\) と、2 つの異なるクライアント \(1 つは [!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] を対象とし、もう 1 つは [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] を対象としています\) で構成されています。  
+  
+ このサーバーは、シリアル化の際に型のバージョンを相応に変更できるようにするために、<xref:System.Runtime.Serialization.SerializationBinder> をバイナリ フォーマッタにアタッチします。これにより、両方のクライアントで、これらの型を適切に逆シリアル化できるようになります。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  クライアントを実行するには、SBGenericsVTS ソリューション \(6 つのプロジェクト\) を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[マルチ スタートアップ プロジェクト\]** をクリックします。  
+  
+3.  **\[Server\]**、**\[Client20\]**、**\[Client40\]** の順に選択します。これら 3 つのプロジェクトのアクションとして **\[開始\]** を選択し、その他のプロジェクトの設定は **\[なし\]** のままにしておきます。  
+  
+4.  **\[OK\]** をクリックし、F5 キーを押してサンプルを実行します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/usage-of-standard-endpoints.md b/docs/framework/wcf/samples/usage-of-standard-endpoints.md
new file mode 100644
index 00000000000..4c4a4dfef52
--- /dev/null
+++ b/docs/framework/wcf/samples/usage-of-standard-endpoints.md
@@ -0,0 +1,182 @@
+---
+title: "標準エンドポイントの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ecd6a62f-9619-4778-a497-6f888087a9ea
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 標準エンドポイントの使用
+このサンプルでは、サービスの構成ファイルでの標準エンドポイントの使用方法を示します。  標準エンドポイントでは、単一のプロパティを使用してアドレス、バインディング、およびコントラクトの組み合わせをそのエンドポイントに関連付けられている追加のプロパティで記述することで、エンドポイントの定義を簡単に行うことができます。  このサンプルでは、カスタムの標準エンドポイントを定義して実装する方法、およびエンドポイントの特定のプロパティを定義する方法を示します。  
+  
+## サンプルの詳細  
+ サービス エンドポイントは、アドレス、バインディング、およびコントラクトの 3 つのパラメーターを指定して指定できます。  指定できるその他のパラメーターには、動作構成、ヘッダー、リッスン URI などがあります。  アドレス、バインディング、およびコントラクトのいずれかまたはすべてに、変更できない値が含まれている場合があります。  このような理由から、標準エンドポイントを使用できます。  このようなエンドポイントの例として、メタデータ交換エンドポイントや探索エンドポイントがあります。  また、標準エンドポイントでは、固定された性質の情報を提供したり、独自の標準エンドポイントを作成したりしなくても、サービス エンドポイントを構成できるため、ユーザビリティが向上します。たとえば、適切な既定の値のセットを指定し、構成ファイルの詳細を削減してユーザビリティを向上させることができます。  
+  
+ このサンプルは、2 つの標準エンドポイントを定義するサービスおよびサービスと通信するクライアントの 2 つのプロジェクトで構成されています。  構成ファイルでサービスの標準エンドポイントを定義する方法を次の例に示します。  
+  
+```xml  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+  <system.serviceModel>  
+    <extensions>  
+      <endpointExtensions>  
+        <add name="customEndpoint" type="Microsoft.Samples.StandardEndpoints.CustomEndpointCollectionElement, service" />  
+      </endpointExtensions>  
+    </extensions>  
+    <services>  
+      <service name="Microsoft.Samples.StandardEndpoints.CalculatorService">  
+        <endpoint address="http://localhost:8000/Samples/Service.svc/customEndpoint" contract="Microsoft.Samples.StandardEndpoints.ICalculator" kind="customEndpoint" />  
+        <endpoint kind="mexEndpoint" />  
+      </service>  
+    </services>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+    <standardEndpoints>  
+      <customEndpoint>  
+        <standardEndpoint property="True" />  
+      </customEndpoint>  
+    </standardEndpoints>  
+  </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ サービスに定義されている最初のエンドポイントは、`customEndpoint` の一種で、その定義については、`<standardEndpoints>` セクションで確認できます。このセクションでは、プロパティ `property` に `true` の値が指定されています。  これは、新しいプロパティでカスタマイズされたエンドポイントの例です。  2 つ目のエンドポイントはメタデータ エンドポイントを表します。このエンドポイントでは、アドレス、バインディング、およびコントラクトの値が固定されています。  
+  
+ 標準エンドポイント要素を定義するには、`StandardEndpointElement` から派生するクラスを作成する必要があります。  このサンプルでは、`CustomEndpointElement` クラスは、次の例のように定義されています。  
+  
+```csharp  
+public class CustomEndpointElement : StandardEndpointElement  
+{  
+    public bool Property  
+    {  
+        get { return (bool)base["property"]; }  
+        set { base["property"] = value; }  
+    }  
+  
+    protected override ConfigurationPropertyCollection Properties  
+    {  
+        get  
+        {  
+            ConfigurationPropertyCollection properties = base.Properties;  
+            properties.Add(new ConfigurationProperty("property", typeof(bool), false, ConfigurationPropertyOptions.None));  
+            return properties;  
+        }  
+    }  
+  
+    protected override Type EndpointType  
+    {  
+        get { return typeof(CustomEndpoint); }  
+    }  
+  
+    protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contract)  
+    {  
+        return new CustomEndpoint();  
+    }  
+  
+    protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)  
+    {  
+        CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;  
+        customEndpoint.Property = this.Property;  
+    }  
+  
+    protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)  
+    {  
+        CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;  
+        customEndpoint.Property = this.Property;  
+    }  
+  
+    protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)  
+    {  
+    }  
+  
+    protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)  
+    {  
+    }  
+}  
+  
+```  
+  
+ `CreateServiceEndpoint` 関数で、`CustomEndpoint` オブジェクトが作成されます。  その定義については、以下の例を参照してください。  
+  
+```  
+public class CustomEndpoint : ServiceEndpoint  
+    {  
+        public CustomEndpoint()  
+            : this(string.Empty)  
+        {  
+        }  
+  
+        public CustomEndpoint(string address)  
+            : this(address, ContractDescription.GetContract(typeof(ICalculator)))  
+        {  
+        }  
+  
+        public CustomEndpoint(string address, ContractDescription contract)  
+            : base(contract)  
+        {  
+            this.Binding = new BasicHttpBinding();  
+            this.IsSystemEndpoint = false;  
+        }  
+  
+        public bool Property  
+        {  
+            get;  
+            set;  
+        }  
+    }  
+  
+```  
+  
+ サービスとクライアントとの間で通信を実行するために、クライアントでサービスに対するサービス参照が作成されます。  このサンプルをビルドして実行した場合、サービスが実行されて、クライアントはそのサービスと通信します。  サービスが変更されるたびに、サービス参照を更新する必要があります。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、StandardEndpoints.sln ファイルを開きます。  
+  
+2.  複数のプロジェクトを起動できるようにします。  
+  
+    1.  **ソリューション エクスプローラー**で、標準エンドポイント ソリューションを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    2.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[マルチ スタートアップ プロジェクト\]** をクリックします。  
+  
+    3.  Service プロジェクトを一覧の先頭に移動し、**\[アクション\]** を **\[開始\]** に設定します。  
+  
+    4.  Client プロジェクトを Service プロジェクトの後ろに移動し、この場合も **\[アクション\]** を **\[開始\]** に設定します。  
+  
+         これで、Client プロジェクトは Service プロジェクトの後に実行されます。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!NOTE]
+>  この手順が機能しない場合は、次の手順を使用して、環境設定が適切であることを確認してください。  
+>   
+>  1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+> 2.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+> 3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\StandardEndpoints`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/user-name-password-validator.md b/docs/framework/wcf/samples/user-name-password-validator.md
new file mode 100644
index 00000000000..33275e032ae
--- /dev/null
+++ b/docs/framework/wcf/samples/user-name-password-validator.md
@@ -0,0 +1,336 @@
+---
+title: "ユーザー名パスワード検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 42f03841-286b-42d8-ba58-18c75422bc8e
+caps.latest.revision: 18
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 18
+---
+# ユーザー名パスワード検証
+このサンプルでは、カスタム UserNamePassword 検証を実装する方法を示します。これは、アプリケーションの要件に適した組み込みの UserNamePassword 検証モードがない場合に便利です。たとえば、ユーザー名とパスワードの組み合わせがデータベースなどの外部ストアに保存されている場合などです。このサンプルでは、2 つの特定のユーザー名とパスワードの組み合わせをチェックする、カスタム検証を備えたサービスを示します。クライアントはそのようなユーザー名とパスワードの組み合わせを使用して、サービスに対する認証を行います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Security\UserNamePasswordValidator`  
+  
+> [!NOTE]
+>  カスタム検証が許可するユーザー名とパスワードの組み合わせを使用する UserName 資格情報は、どのユーザーでも作成できるので、このサービスは、標準の UserNamePassword 検証によって提供される既定の動作よりも安全性が低くなります。標準の UserNamePassword 検証は、指定されたユーザー名とパスワードの組み合わせを Windows アカウントにマップするよう試みます。マップできなかった場合は、認証が失敗します。このサンプルのカスタム UserNamePassword 検証は、製品版のコードでは使用しないでください。このサンプルは、デモンストレーションのためだけに作成されています。  
+  
+ このサンプルで示す処理の概要は次のとおりです。  
+  
+-   クライアントはユーザー名トークンを使用して認証される。  
+  
+-   サーバーはクライアント資格情報をカスタム UserNamePassword 検証と照合し、カスタム エラーをユーザー名とパスワードの検証ロジックからクライアントに伝達する。  
+  
+-   サーバーがそのサーバーの X.509 証明書を使用して認証される。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル \(App.config\) で定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングの構成には、既定で WS\-Securityとユーザー名認証を使用する、標準の `wsHttpBinding` が使用されます。サービス動作では、クライアントのユーザー名とパスワードの組み合わせを検証するための `Custom` モード、および検証クラスの型を指定します。さらに、`serviceCertificate` 要素を使用しているサーバー証明書も指定します。サーバー証明書の `SubjectName` には、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性と同じ値が指定されている必要があります。  
+  
+```  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+      <!-- use host/baseAddresses to configure base address provided by host -->  
+      <host>  
+        <baseAddresses>  
+          <add baseAddress ="http://localhost:8001/servicemodelsamples/service" />  
+        </baseAddresses>  
+      </host>  
+      <!-- use base address specified above, provide one endpoint -->  
+      <endpoint address="username"  
+                binding="wsHttpBinding"  
+                bindingConfiguration="Binding"   
+                contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    </service>  
+  </services>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!-- username binding -->  
+      <binding name="Binding">  
+        <security mode="Message">  
+          <message clientCredentialType="UserName" />  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior name="CalculatorServiceBehavior">  
+        <serviceDebug includeExceptionDetailInFaults ="true"/>  
+        <serviceCredentials>  
+          <!--   
+          The serviceCredentials behavior allows one to   
+          specify a custom validator for username/password  
+          combinations.  
+          -->  
+          <userNameAuthentication userNamePasswordValidationMode="Custom"  
+                                  customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.CalculatorService+MyCustomUserNameValidator, service" />  
+          <!--   
+          The serviceCredentials behavior allows one to define a service certificate. A service certificate is used by a client to authenticate the service and provide message protection. You must specify a server certificate when passing username/passwords to encrypt the information as it is sent on the wire. Otherwise the username and password information would be sent as clear text. This configuration references the "localhost" certificate installed during the setup instructions.  
+          -->  
+          <serviceCertificate findValue="localhost" storeLocation="LocalMachine" storeName="My" x509FindType="FindBySubjectName" />  
+        </serviceCredentials>  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+  
+</system.serviceModel>  
+  
+```  
+  
+ クライアント エンドポイント構成は、構成名、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、適切なモードおよびメッセージ `clientCredentialType` で構成されます。  
+  
+```  
+<system.serviceModel>  
+  
+    <client>  
+      <!-- Username based endpoint -->  
+      <endpoint name="Username"  
+address="http://localhost:8001/servicemodelsamples/service/username"   
+                binding="wsHttpBinding"   
+                bindingConfiguration="Binding"   
+                behaviorConfiguration="ClientCertificateBehavior"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator">  
+      </endpoint>  
+    </client>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- Username binding -->  
+        <binding name="Binding">  
+          <security mode="Message">  
+            <message clientCredentialType="UserName" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientCertificateBehavior">  
+          <clientCredentials>  
+            <serviceCertificate>  
+              <!--   
+            Setting the certificateValidationMode to PeerOrChainTrust means that if the certificate   
+            is in the user's Trusted People store, then it will be trusted without performing a  
+            validation of the certificate's issuer chain. This setting is used here for convenience so that the   
+            sample can be run without having to have certificates issued by a certification authority (CA).  
+            This setting is less secure than the default, ChainTrust. The security implications of this   
+            setting should be carefully considered before using PeerOrChainTrust in production code.   
+            -->  
+              <authentication certificateValidationMode="PeerOrChainTrust" />  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+ クライアント実装では、ユーザー名とパスワードの入力がユーザーに対して求められます。  
+  
+```  
+// Get the username and password  
+Console.WriteLine("Username authentication required.");  
+Console.WriteLine("Provide a username.");  
+Console.WriteLine("   Enter username: (test1)");  
+string username = Console.ReadLine();  
+Console.WriteLine("   Enter password:");  
+string password = "";  
+ConsoleKeyInfo info = Console.ReadKey(true);  
+while (info.Key != ConsoleKey.Enter)  
+{  
+    if (info.Key != ConsoleKey.Backspace)  
+    {  
+        if (info.KeyChar != '\0')  
+        {  
+            password += info.KeyChar;  
+        }  
+        info = Console.ReadKey(true);  
+    }  
+    else if (info.Key == ConsoleKey.Backspace)  
+    {  
+        if (password != "")  
+        {  
+            password = password.Substring(0, password.Length - 1);  
+        }  
+        info = Console.ReadKey(true);  
+    }  
+}  
+for (int i = 0; i < password.Length; i++)  
+{  
+    Console.Write("*");  
+}  
+Console.WriteLine();  
+// Create a proxy with Certificate endpoint configuration  
+CalculatorProxy proxy = new CalculatorProxy("Username")  
+try  
+{  
+  proxy.ClientCredentials.Username.Username = username;  
+  proxy.ClientCredentials.Username.Password = password;  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = proxy.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  }  
+  catch (Exception e)  
+  {  
+      Console.WriteLine("Call failed:");  
+      while (e != null)  
+      {  
+          Console.WriteLine("\t{0}", e.Message);  
+          e = e.InnerException;  
+      }  
+      proxy.Abort();  
+  }  
+}  
+  
+```  
+  
+ このサンプルではカスタム UserNamePassword 検証を使用して、ユーザー名とパスワードの組み合わせを検証します。サンプルは、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator> から派生する `CustomUserNamePasswordValidator` を実装しています。詳細については、<xref:System.IdentityModel.Selectors.UserNamePasswordValidator> のドキュメントを参照してください。特定のカスタム検証を使用しているこのサンプルは、2 つの特定のユーザー名とパスワードの組み合わせを許可する `Validate` メソッドを実装しています。次のコードを参照してください。  
+  
+```  
+public class CustomUserNameValidator : UserNamePasswordValidator  
+{  
+ // This method validates users. It allows in two users,   
+ // test1 and test2 with passwords 1tset and 2tset respectively.  
+ // This code is for illustration purposes only and   
+ // MUST NOT be used in a production environment because it   
+ // is NOT secure.  
+ public override void Validate(string userName, string password)  
+ {  
+  if (null == userName || null == password)  
+  {  
+   throw new ArgumentNullException();  
+  }  
+  
+  if (!(userName == "test1" && password == "1tset") && !(userName == "test2" && password == "2tset"))  
+  {  
+   throw new FaultException("Unknown Username or Incorrect Password");  
+   }  
+  }  
+ }  
+```  
+  
+ サービス コードに検証を実装した場合、使用する検証インスタンスをサービス ホストに通知する必要があります。これは次のコードで実行されます。  
+  
+```  
+serviceHost.Credentials.UserNameAuthentication.UserNamePasswordValidationMode = UserNamePasswordValidationMode.Custom;  
+serviceHost.Credentials. UserNameAuthentication.CustomUserNamePasswordValidator = new CustomUserNamePasswordValidator();  
+```  
+  
+ または、構成で次のように指定することで、同じことを実現できます。  
+  
+```  
+<behaviors>  
+ <serviceBehaviors>  
+  <behavior name="CalculatorServiceBehavior">  
+  ...  
+   <serviceCredentials>  
+    <!--   
+    The serviceCredentials behavior allows one to specify authentication constraints on username / password combinations.  
+    -->  
+    <userNameAuthentication userNamePasswordValidationMode="Custom" customUserNamePasswordValidatorType="Microsoft.ServiceModel.Samples.CalculatorService+CustomUserNameValidator, service" />  
+   ...  
+  </behavior>  
+ </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントはすべてのメソッドを問題なく呼び出すことができるようになります。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルは、別のコンピューターを使用する場合または自己ホスト型の場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成 :  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。%SERVER\_NAME% 変数はサーバー名を指定します。この変数を変更して、使用するサーバー名を指定します。既定値は、localhost です。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないためです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  サンプルを単一コンピューター構成で実行するか、複数コンピューター構成で実行するかに応じて、次の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!NOTE]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  Service.exe を service\\bin で起動します。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを別のコンピューターで実行するには  
+  
+1.  サービス コンピューターにサービス バイナリ用のディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを、サービス コンピューターのサービス ディレクトリにコピーします。Setup.bat ファイルと Cleanup.bat ファイルもサービス コンピューターにコピーします。  
+  
+3.  コンピューターの完全修飾ドメイン名を含むサブジェクト名を持つサーバー証明書が必要です。新しい証明書名を反映するには、サーバーの構成ファイルを更新する必要があります。  
+  
+4.  サーバー証明書をクライアントの CurrentUser\-TrustedPeople ストアにコピーします。このようにする必要があるのは、サーバー証明書が信頼できる発行元から発行されていない場合のみです。  
+  
+5.  サービス コンピューターの App.config ファイルで、ベース アドレスの値を localhost から完全修飾コンピューター名に変更します。  
+  
+6.  サービス コンピューターで、コマンド プロンプト ウィンドウから Service.exe を起動します。  
+  
+7.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+8.  クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。  
+  
+9. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。  
+  
+10. クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。これにより、証明書ストアからサーバー証明書が削除されます。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/using-performance-counters.md b/docs/framework/wcf/samples/using-performance-counters.md
new file mode 100644
index 00000000000..d0bf832dd1c
--- /dev/null
+++ b/docs/framework/wcf/samples/using-performance-counters.md
@@ -0,0 +1,87 @@
+---
+title: "パフォーマンス カウンターの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 00a787af-1876-473c-a48d-f52b51e28a3f
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# パフォーマンス カウンターの使用
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] パフォーマンス カウンタにアクセスする方法と、ユーザー定義のパフォーマンス カウンタを作成する方法を示します。このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、クライアントが `ICalculator` サービスの 4 つのメソッドを呼び出します。この処理は、ユーザーが中断するまで継続して行われます。サービスは変更されません。  
+  
+ パフォーマンス カウンタは、サービスの Web.config ファイルの診断セクションで有効にします。次のサンプル構成を参照してください。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <diagnostics performanceCounters="All" />   
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ このタスクは、[構成エディター ツール \(SvcConfigEditor.exe\)](../../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md) を使用して実行することもできます。  
+  
+ パフォーマンス カウンタが有効な場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] パフォーマンス カウンタのスイート全体がサービスについて有効です。.NET Framework は、`ServiceModelService`、`ServiceModelEndpoint`、および `ServiceModelOperation` の 3 つのレベルで、パフォーマンス データを自動的に保持します。これらの各レベルには、"呼び出し"、"1 秒あたりの呼び出し回数"、"承認されていないセキュリティ呼び出し" などのパフォーマンス カウンタがあります。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### パフォーマンス データを表示するには  
+  
+1.  **\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして「`perfmon`」と入力してから **\[OK\]** をクリックするか、または、\[コントロール パネル\] の **\[管理ツール\]** を開き、**\[パフォーマンス\]** をダブルクリックして、パフォーマンス モニタ ツールを開始します。  
+  
+    > [!NOTE]
+    >  サンプル コードが実行されるまでは、カウンタを追加することはできません。  
+  
+2.  一覧表示されているパフォーマンス カウンタを削除するには、削除するパフォーマンス カウンタを選択して Del キーを押します。  
+  
+3.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] カウンタを追加するには、グラフ ウィンドウを右クリックし、**\[カウンタの追加\]** をクリックします。**\[カウンタの追加\]** ダイアログ ボックスで、\[パフォーマンス オブジェクト\] ボックスの一覧から **\[ServiceModelOperation 3.0.0.0\]、\[ServiceModelEndpoint 3.0.0.0\]、または \[ServiceModelService 3.0.0.0\]** を選択します。表示するカウンタを一覧から選択します。  
+  
+    > [!NOTE]
+    >  コンピューター上で [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが実行されていない場合は、サービスの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] パフォーマンス カウンターは存在しません。  
+  
+### 構成エディターを使用してカウンターを有効にするには  
+  
+1.  SvcConfigEditor.exe のインスタンスを開きます。  
+  
+2.  \[ファイル\] メニューの **\[開く\]** をクリックし、**\[構成ファイル...\]** をクリックします。  
+  
+3.  サンプル アプリケーションの service フォルダーに移動し、Web.config ファイルを開きます。  
+  
+4.  構成ツリーの **\[診断\]** をクリックします。  
+  
+5.  **\[診断\]** ウィンドウの  **\[パフォーマンス カウンター\]** の表示を "すべて" に切り替えます。  
+  
+6.  構成ファイルを保存し、エディターを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\PerfCounters`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/using-the-wcf-moniker-with-com-clients.md b/docs/framework/wcf/samples/using-the-wcf-moniker-with-com-clients.md
new file mode 100644
index 00000000000..a18bae9b4ca
--- /dev/null
+++ b/docs/framework/wcf/samples/using-the-wcf-moniker-with-com-clients.md
@@ -0,0 +1,252 @@
+---
+title: "WCF モニカーの COM クライアントと組み合わせての使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e2799bfe-88bd-49d7-9d6d-ac16a9b16b04
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# WCF モニカーの COM クライアントと組み合わせての使用
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービス モニカーを使用して、COM ベースの開発環境 \(Microsoft Office Visual Basic for Applications \(Office VBA\) や Visual Basic 6.0 など\) に Web サービスを統合する方法を示します。  このサンプルは、Windows スクリプト ホストのクライアント \(.vbs\)、サポート クライアント ライブラリ \(.dll\)、およびインターネット インフォメーション サービス \(IIS\) でホストされるサービス ライブラリ \(.dll\) で構成されています。  このサービスは電卓サービスの 1 つであり、COM クライアントはサービスの算術演算 \(Add、Subtract、Multiply、および Divide\) を呼び出します。  クライアント アクティビティは、メッセージ ボックス ウィンドウに表示されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Interop\COM`  
+  
+ サービスは、次に示すコード例で定義される `ICalculator` コントラクトを実装します。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+}  
+```  
+  
+ このサンプルでは、モニカーを使用するための次の 3 つの代替方法を示します。  
+  
+-   型指定のあるコントラクト \- クライアント コンピューターで COM から参照できる型として登録されます。  
+  
+-   WSDL コントラクト \- WSDL ドキュメントという形で供給されます。  
+  
+-   Metadata Exchange コントラクト – 実行時に Metadata Exchange \(MEX\) エンドポイントから取得されます。  
+  
+## 型指定のあるコントラクト  
+ 型指定のあるコントラクトと共にモニカーを使用するには、属性が適切に設定されているサービス コントラクトの型を COM に登録する必要があります。  最初に、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してクライアントを生成する必要があります  次のコマンドをクライアント ディレクトリでコマンド プロンプトから実行して、型指定のあるプロキシを生成します。  
+  
+```  
+svcutil.exe /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples http://localhost/servicemodelsamples/service.svc /out:generatedClient.cs  
+  
+```  
+  
+ このクラスはプロジェクトに含まれている必要があり、そのプロジェクトは、COM から参照できる署名付きのアセンブリをコンパイル時に生成するように構成されている必要があります。  AssemblyInfo.cs ファイルには次の属性を含める必要があります。  
+  
+```  
+[assembly: ComVisible(true)]  
+  
+```  
+  
+ プロジェクトをビルドしたら、次の例で示すように `regasm` を使用して、COM から参照できる型を登録します。  
+  
+```  
+regasm.exe /tlb:CalcProxy.tlb client.dll  
+```  
+  
+ 作成されたアセンブリは、グローバル アセンブリ キャッシュに追加する必要があります。  必要性は強くありませんが、これによってアセンブリを検索するランタイムのプロセスが簡略化されます。  グローバル アセンブリ キャッシュにアセンブリを追加するコマンドを次に示します。  
+  
+```  
+gacutil.exe /i client.dll  
+```  
+  
+> [!NOTE]
+>  サービス モニカーで必要なのは型の登録だけであり、サービスと通信するためのプロキシは使用されません。  
+  
+ ComCalcClient.vbs クライアント アプリケーションは、サービス モニカーの構文を使用してサービスのアドレス、バインディング、およびコントラクトを指定し、`GetObject` 関数を使用してサービスのプロキシを構築します。  
+  
+```  
+Set typedServiceMoniker = GetObject(  
+"service4:address=http://localhost/ServiceModelSamples/service.svc, binding=wsHttpBinding,   
+contractType={9213C6D2-5A6F-3D26-839B-3BA9B82228D3}")  
+```  
+  
+ モニカーが使用するパラメーターでの指定:  
+  
+-   サービス エンドポイントのアドレス。  
+  
+-   エンドポイントとの接続にクライアントが使用する必要のあるバインディング。  クライアントの構成ファイルにはカスタム バインディングを定義できますが、この場合はシステム定義の wsHttpBinding を使用します。  Windows スクリプト ホストで使用する場合、カスタム バインディングは、Cscript.exe と同じディレクトリにある Cscript.exe.config で定義されます。  
+  
+-   エンドポイントでサポートされるコントラクトの型。  これは上の手順で生成され、登録された型です。  Visual Basic スクリプトには厳密に型指定された COM 環境がないので、コントラクトの識別子を指定する必要があります。  この GUID は CalcProxy.tlb からの `interfaceID` で、OLE\/COM オブジェクト ビューアー \(OleView.exe\) などの COM ツールを使用して表示できます。  Office VBA や Visual Basic 6.0 などの厳密に型指定された環境では、コントラクト パラメーターを使用する代わりに、タイプ ライブラリへの明示的な参照を追加してプロキシ オブジェクトの型を宣言することができます。  これにより、クライアント アプリケーションの開発中に IntelliSense のサポートも提供されます。  
+  
+ サービス モニカーを使用してプロキシ インスタンスを構築しておくと、クライアント アプリケーションはプロキシでメソッドを呼び出すことができます。これにより、対応するサービス操作を呼び出すサービス モニカー インフラストラクチャは次のようになります。  
+  
+```  
+' Call the service operations using the moniker object  
+WScript.Echo "Typed service moniker: 100 + 15.99 = " & typedServiceMoniker.Add(100, 15.99)  
+  
+```  
+  
+ サンプルを実行すると、操作の応答が Windows スクリプト ホストのメッセージ ボックス ウィンドウに表示されます。  ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信する型指定のあるモニカーを使用して、COM の呼び出しを行う COM クライアントを示します。  クライアント アプリケーションでは COM が使用されますが、サービスとの通信は Web サービス呼び出しのみで構成されます。  
+  
+## WSDL コントラクト  
+ WSDL コントラクトと共にモニカーを使用するには、クライアント ライブラリを登録する必要はありません。ただし、ブラウサを使用してサービスの WSDL エンドポイントにアクセスするなど、帯域外機構を通じてサービスの WSDL コントラクトを取得する必要があります。  これにより、モニカーは実行時にそのコントラクトにアクセスできるようになります。  
+  
+ ComCalcClient.vbs クライアント アプリケーションは、次のように `FileSystemObject` を使用してローカルに保存されている WSDL ファイルにアクセスし、その後 `GetObject` 関数を再度使用してサービスのプロキシを構築します。  
+  
+```  
+' Open the WSDL contract file and read it all into the wsdlContract string  
+Const ForReading = 1  
+Set objFSO = CreateObject("Scripting.FileSystemObject")  
+Set objFile = objFSO.OpenTextFile("serviceWsdl.xml", ForReading)  
+wsdlContract = objFile.ReadAll  
+objFile.Close  
+  
+' Create a string for the service moniker including the content of the WSDL contract file  
+wsdlMonikerString = "service4:address='http://localhost/ServiceModelSamples/service.svc'"  
+wsdlMonikerString = wsdlMonikerString + ", binding=WSHttpBinding_ICalculator, bindingNamespace='http://Microsoft.ServiceModel.Samples'"  
+wsdlMonikerString = wsdlMonikerString + ", wsdl='" & wsdlContract & "'"  
+wsdlMonikerString = wsdlMonikerString + ", contract=ICalculator, contractNamespace='http://Microsoft.ServiceModel.Samples'"  
+  
+' Create the service moniker object  
+Set wsdlServiceMoniker = GetObject(wsdlMonikerString)  
+```  
+  
+ モニカーが使用するパラメーターでの指定:  
+  
+-   サービス エンドポイントのアドレス。  
+  
+-   そのエンドポイントと接続するためにクライアントが使用する必要があるバインディングと、そのバインディングが定義されている名前空間。  この場合、`wsHttpBinding_ICalculator` が使用されます。  
+  
+-   コントラクトを定義する WSDL。  この場合は、サービスの Wsdl.xml ファイルから読み取られた文字列です。  
+  
+-   コントラクトの名前と名前空間。  WSDL に複数のコントラクトが含まれている場合があるので、識別情報が必要です。  
+  
+    > [!NOTE]
+    >  既定では、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、使用される名前空間ごとに異なる WSDL ファイルを生成します。  これらのファイルは、WSDL インポート コンストラクターを使用してリンクされます。  モニカーでは単一の WSDL 定義が想定されているので、サービスはこのサンプルで示すように単一の名前空間を使用するか、または別のファイルを手動でマージする必要があります。  
+  
+ サービス モニカーを使用してプロキシ インスタンスを構築しておくと、クライアント アプリケーションはプロキシでメソッドを呼び出すことができます。これにより、対応するサービス操作を呼び出すサービス モニカー インフラストラクチャは次のようになります。  
+  
+```  
+' Call the service operations using the moniker object  
+WScript.Echo "WSDL service moniker: 145 - 76.54 = " & wsdlServiceMoniker.Subtract(145, 76.54)  
+  
+```  
+  
+ サンプルを実行すると、操作の応答が Windows スクリプト ホストのメッセージ ボックス ウィンドウに表示されます。  ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信するモニカーを WSDL コントラクトと共に使用して、COM の呼び出しを行う COM クライアントを示します。  
+  
+## Metadata Exchange コントラクト  
+ MEX コントラクトと共にモニカーを使用するには、WSDL コントラクトと同様、クライアント登録は必要ありません。  サービスのコントラクトは、実行時に Metadata Exchange を内部使用して取得されます。  
+  
+ ComCalcClient.vbs クライアント アプリケーションは次のように `GetObject` 関数を再度使用して、サービスのプロキシを構築します。  
+  
+```  
+' Create a string for the service moniker specifying the address to retrieve the service metadata from  
+mexMonikerString = "service4:mexAddress='http://localhost/servicemodelsamples/service.svc/mex'"  
+mexMonikerString = mexMonikerString + ", address='http://localhost/ServiceModelSamples/service.svc'"  
+mexMonikerString = mexMonikerString + ", binding=WSHttpBinding_ICalculator, bindingNamespace='http://Microsoft.ServiceModel.Samples'"  
+mexMonikerString = mexMonikerString + ", contract=ICalculator, contractNamespace='http://Microsoft.ServiceModel.Samples'"  
+  
+' Create the service moniker object  
+Set mexServiceMoniker = GetObject(mexMonikerString)  
+```  
+  
+ モニカーが使用するパラメーターでの指定:  
+  
+-   サービスの Metadata Exchange エンドポイントのアドレス。  
+  
+-   サービス エンドポイントのアドレス。  
+  
+-   そのエンドポイントと接続するためにクライアントが使用する必要があるバインディングと、そのバインディングが定義されている名前空間。  この場合、`wsHttpBinding_ICalculator` が使用されます。  
+  
+-   コントラクトの名前と名前空間。  WSDL に複数のコントラクトが含まれている場合があるので、識別情報が必要です。  
+  
+ サービス モニカーを使用してプロキシ インスタンスを構築しておくと、クライアント アプリケーションはプロキシでメソッドを呼び出すことができます。これにより、対応するサービス操作を呼び出すサービス モニカー インフラストラクチャは次のようになります。  
+  
+```  
+' Call the service operations using the moniker object  
+WScript.Echo "MEX service moniker: 9 * 81.25 = " & mexServiceMoniker.Multiply(9, 81.25)  
+  
+```  
+  
+ サンプルを実行すると、操作の応答が Windows スクリプト ホストのメッセージ ボックス ウィンドウに表示されます。  ここでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと通信するモニカーを MEX コントラクトと共に使用して、COM の呼び出しを行う COM クライアントを示します。  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] コマンド プロンプトで、言語固有のフォルダーにある \\client\\bin\\ フォルダーを開きます。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[lserver](../../../../includes/lserver-md.md)]、Windows 7、または Windows Server 2008 R2 を使用している場合は、コマンド プロンプトを管理者権限で実行する必要があります。  
+  
+4.  「`tlbexp.exe client.dll /out:CalcProxy.tlb`」と入力して、dll を tlb ファイルにエクスポートします。  "タイプ ライブラリ エクスポーターの警告" が表示されることが予想されますが、ジェネリック型は不要なので問題にはなりません。  
+  
+5.  「`regasm.exe /tlb:CalcProxy.tlb client.dll`」と入力して、型を COM に登録します。  "タイプ ライブラリ エクスポーターの警告" が表示されることが予想されますが、ジェネリック型は不要なので問題にはなりません。  
+  
+6.  「`gacutil.exe /i client.dll`」と入力して、アセンブリをグローバル アセンブリ キャッシュに追加します。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  ブラウザーにアドレス「`http://localhost/servicemodelsamples/service.svc`」を入力して、サービスにアクセスできるかどうかをテストします。  これに応答して、確認ページが表示されます。  
+  
+2.  言語固有のフォルダーの下の \\client にある ComCalcClient.vbs を実行します。  クライアント アクティビティがメッセージ ボックス ウィンドウに表示されます。  
+  
+3.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターで、ServiceModelSamples という仮想ディレクトリを作成します。  サンプルに含まれている Setupvroot.bat スクリプトを使用して、ディスク ディレクトリと仮想ディレクトリを作成できます。  
+  
+2.  サービス プログラム ファイルを %SystemDrive%\\Inetpub\\wwwroot\\servicemodelsamples からサービス コンピューターの ServiceModelSamples 仮想ディレクトリにコピーします。  \\bin ディレクトリのファイルが含まれていることを確認してください。  
+  
+3.  クライアント スクリプト ファイルを、言語固有のフォルダーにある \\client フォルダーからクライアント コンピューターにコピーします。  
+  
+4.  このスクリプト ファイルで、エンドポイント定義のアドレス値をサービスの新しいアドレスに変更します。  アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+5.  WSDL ファイルをクライアント コンピューターにコピーします。  WSDL ファイルのサービスの Wsdl.xml で、アドレスの "localhost" への参照をすべて完全修飾ドメイン名に置き換えます。  
+  
+6.  Client.dll ライブラリを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターのディレクトリにコピーします。  
+  
+7.  コマンド プロンプトで、クライアント コンピューターのコピー先ディレクトリに移動します。  [!INCLUDE[wv](../../../../includes/wv-md.md)] または [!INCLUDE[lserver](../../../../includes/lserver-md.md)] を使用する場合は、コマンド プロンプトを管理者として実行してください。  
+  
+8.  「`tlbexp.exe client.dll /out:CalcProxy.tlb`」と入力して、dll を tlb ファイルにエクスポートします。  "タイプ ライブラリ エクスポーターの警告" が表示されることが予想されますが、ジェネリック型は不要なので問題にはなりません。  
+  
+9. 「`regasm.exe /tlb:CalcProxy.tlb client.dll`」と入力して、型を COM に登録します。  このコマンドを実行する前に、パスが `regasm.exe` が含まれるフォルダーに設定されていることを確認します。  
+  
+10. 「`gacutil.exe /i client.dll`」と入力して、アセンブリをグローバル アセンブリ キャッシュに追加します。  このコマンドを実行する前に、パスが `gacutil.exe` が含まれるフォルダーに設定されていることを確認します。  
+  
+11. ブラウザーを使用して、サービスにクライアント コンピューターからアクセスできるかどうかをテストします。  
+  
+12. クライアント コンピューターで ComCalcClient.vbs を起動します。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+-   セキュリティの目的で、サンプルの使用が終わったら、このセットアップで付与された仮想ディレクトリの定義とアクセス許可を削除してください。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/virtual-directory-setup-instructions.md b/docs/framework/wcf/samples/virtual-directory-setup-instructions.md
new file mode 100644
index 00000000000..fc3cdb42e12
--- /dev/null
+++ b/docs/framework/wcf/samples/virtual-directory-setup-instructions.md
@@ -0,0 +1,204 @@
+---
+title: "仮想ディレクトリのセットアップ手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 3c62cab5-81a4-48b6-ac8c-9ce33a85a157
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# 仮想ディレクトリのセットアップ手順
+[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルは、servicemodelsamples という共通の仮想ディレクトリの共有を想定しています。この仮想ディレクトリは %SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples フォルダーにマップされています。  
+  
+> [!NOTE]
+>  %SystemDrive% は、インターネット インフォメーション サービス \(IIS\) がインストールされているドライブの場所に応じて、通常は C: または D: になります。  
+  
+ 「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」で Setupvroot.bat ファイルと Cleanupvroot.bat ファイルを使用すると、仮想ディレクトリを作成できます。この仮想ディレクトリを手動で作成する場合は、次の手順に従います。  
+  
+## 手順  
+  
+#### 仮想ディレクトリを IIS 7.0 または 7.5 で作成するには  
+  
+1.  **\[スタート\]** メニューの **\[ファイル名を指定して実行\]** をクリックし、「**inetmgr**」と入力してインターネット インフォメーション サービス \(IIS\) MMC スナップインを開きます。  
+  
+2.  左のペインで、コンピューター名のノードを展開し、**\[サイト\]** ノードを展開します。  
+  
+3.  **\[既定の Web サイト\]** を右クリックして **\[アプリケーションの追加\]** をクリックし、**\[アプリケーションの追加\]** ウィンドウを開きます。  
+  
+4.  このウィンドウで、作成する仮想ディレクトリのエイリアスとして「`servicemodelsamples`」と入力します。  
+  
+5.  次のディレクトリを作成します。%SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples  
+  
+6.  物理パスを %SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples に設定します。WCF サンプルの多くは、ビルド時にサービス実行可能ファイルをこの場所にコピーします。  
+  
+7.  **\[OK\]** をクリックします。Web アプリケーションが、WCF サンプル用に作成されました。  
+  
+    > [!NOTE]
+    >  すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルで同じ servicemodelsamples Web アプリケーションを使用するため、この作業は 1 回だけ実行してください。  
+  
+    > [!NOTE]
+    >  このドキュメントでは、`virtual directory`という用語は `Web application`と同じ意味で使用しています。  
+  
+     仮想ディレクトリの作成に加えて、さらに仮想ディレクトリのプロパティを設定し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実行を有効にする必要があります。詳細については、以下を参照してください。  
+  
+#### 仮想ディレクトリを IIS 5.1 または 6.0 で作成するには  
+  
+1.  コマンド プロンプト ウィンドウを開き、「`start inetmgr`」と入力して、インターネット インフォメーション サービス \(IIS\) MMC スナップインを開きます。  
+  
+2.  左のペインで、コンピュータ名のノード、**\[Web サイト\]** ノードの順に展開します。  
+  
+3.  **\[既定の Web サイト\]** を右クリックして **\[新規作成\]、\[仮想ディレクトリ\]** の順にクリックし、仮想ディレクトリの作成ウィザードを開きます。  
+  
+4.  このウィザードで、作成する仮想ディレクトリのエイリアスとして「`servicemodelsamples`」と入力します。  
+  
+5.  パスを %SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples に設定します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルの多くは、ビルド時にサービス実行可能ファイルをこの場所にコピーします。  
+  
+6.  **\[次へ\]** をクリックします。  
+  
+7.  既定では、次のチェック ボックスがオンになっています。  
+  
+    -   **\[読み取り\]**  
+  
+    -   **\[ASP などのスクリプトを実行する\]**  
+  
+8.  **\[次へ\]** をクリックし、**\[完了\]** をクリックしてウィザードを完了します。  
+  
+    > [!NOTE]
+    >  すべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルで同じ servicemodelsamples 仮想ディレクトリを使用するため、この作業は 1 回だけ実行してください。  
+  
+#### 仮想ディレクトリの追加プロパティを IIS 7.0 または 7.5 で設定するには  
+  
+1.  servicemodelsamples ノードをクリックします。ウィンドウの下端に沿って 2 つのビューが表示されます。**\[機能ビュー\]** が選択されていない場合は、選択します。  
+  
+2.  **\[ディレクトリの参照\]** のエントリをダブルクリックします。  
+  
+3.  操作ウィンドウで、**\[有効\]** をクリックします。これにより、Internet Explorer でディレクトリにアクセスできるようになり、サービスのデバッグに役立ちます。  
+  
+ 最後に、servicemodelsamples フォルダーのセキュリティ プロパティを、他のユーザーがアクセスできるように設定する必要があります。詳細については、以下を参照してください。  
+  
+#### 仮想ディレクトリの追加プロパティを IIS 5.1 または 6.0 で設定するには  
+  
+1.  servicemodelsamples ノードを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  既定では、次のチェック ボックスがオンになっています。  
+  
+    -   **\[読み取り\]**  
+  
+    -   **\[ログ アクセス\]**  
+  
+    -   **\[このリソースにインデックスを付ける\]**  
+  
+3.  **\[ディレクトリの参照\]** チェック ボックスをオンにします。これにより、Internet Explorer でディレクトリにアクセスできるようになり、サービスのデバッグに役立ちます。  
+  
+#### フォルダーのセキュリティ プロパティを IIS 7.0 または 7.5 で設定するには  
+  
+1.  %SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples に移動します。  
+  
+2.  servicemodelsamples フォルダーを右クリックして、**\[共有\]** または **\[共有する相手\]** をクリックします。  
+  
+3.  **\[追加\]** ボタンの左側にある下矢印をクリックします。  
+  
+4.  **\[検索\]** エントリを選択します。**\[ユーザーまたはグループの選択\]** ウィンドウが開きます。  
+  
+5.  **\[次へ\]** をクリックします。  
+  
+6.  **\[場所\]** をクリックします。**\[場所\]** ウィンドウが開きます。  
+  
+7.  使用するコンピューターのエントリを選択します。一覧表示されているドメインやネットワークのエントリではなく、ローカル コンピューターを選択してください。コンピューターの指定が終わったら、**\[OK\]** をクリックします。  
+  
+8.  **\[検索開始\]** をクリックします。これで、ローカル コンピューターに関連付けられたオブジェクトが検索結果に表示されます。  
+  
+9. **\[名前 \(相対識別名\)\]** 列で、**\[IIS\_IUSRS\]** エントリを検索します。そのエントリを選択して **\[OK\]** をクリックし、検索結果ウィンドウを閉じます。  
+  
+10. **\[OK\]** をクリックして **\[ユーザーまたはグループの選択\]** ウィンドウを閉じます。  
+  
+11. **\[共有\]** をクリックして変更内容を保存します。  
+  
+12. 共有を有効にするための変更が完了したら、**\[完了\]** をクリックして **\[ファイルの共有\]** ウィンドウを閉じます。  
+  
+#### フォルダーのセキュリティ プロパティを IIS 5.1 または 6.0 で設定するには  
+  
+1.  %SystemDrive%\\inetpub\\wwwroot\\servicemodelsamples に移動します。  
+  
+2.  **servicemodelsamples** フォルダーを右クリックして、**\[共有とセキュリティ\]** をクリックします。  
+  
+3.  **\[セキュリティ\]** タブをクリックします。  
+  
+4.  IIS 6.0 を使用している場合は、**\[グループ名またはユーザー名\]** ボックスで **\[インターネット ゲスト アカウント\]** が表示されていることを確認します。  
+  
+     表示されていない場合:  
+  
+    1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]** をクリックします。  
+  
+    2.  **\[ユーザー アカウント\]** アイコンが表示されない場合は、**\[カテゴリの表示に切り替える\]** をクリックします。  
+  
+    3.  **\[ユーザー アカウント\]** アイコンをクリックします。  
+  
+    4.  \[コントロール パネルを選んで実行します\] の下の **\[ユーザー アカウント\]** をクリックします。  
+  
+    5.  **\[ユーザー アカウント\]** ダイアログ ボックスの **\[詳細\]** タブをクリックします。  
+  
+    6.  **\[次へ\]** をクリックします。  
+  
+    7.  **\[ローカル ユーザーとグループ\]** ダイアログ ボックスで、**\[ユーザー\]** フォルダーをクリックして展開します。  
+  
+    8.  右側のウィンドウで、**\[インターネット ゲスト アカウント\]** をダブルクリックします。  
+  
+    9. **\[プロパティ\]** ダイアログ ボックスで、インターネット ゲスト アカウントとして使用されている名前をコピーします。既定では、その名前は "USR\_" で始まり、その次にコンピューターの名前が続きます。  
+  
+    10. **\[プロパティ\]** ダイアログ ボックスを閉じます。  
+  
+    11. **\[ローカル ユーザーとグループ\]** ダイアログ ボックスを閉じます。  
+  
+    12. **\[ユーザー アカウント\]** ダイアログ ボックスを閉じます。  
+  
+    13. その他の **\[ユーザー アカウント\]** ダイアログ ボックスを閉じます。  
+  
+    14. **\[servicemodelsamples のプロパティ\]** ダイアログ ボックスの **\[セキュリティ\]** タブで、**\[追加\]** ボタンをクリックします。  
+  
+    15. コンピューター名、バックスラッシュの順に入力し、続いてインターネット ユーザー アカウントの名前を貼り付けます。たとえば、myMachineName\\%InternetGuestAccountName% のようになります。  
+  
+    16. **\[名前の確認\]** をクリックして、追加した名前を検証します。名前が有効な場合は、すべての文字が下線付きの大文字になります。  
+  
+5.  IIS 6.0 の場合はさらに、**\[グループ名またはユーザー名\]** ボックスに NETWORK SERVICE が表示されていることを確認します。  
+  
+     NETWORK SERVICE が表示されていない場合:  
+  
+    1.  **\[追加\]** をクリックします。  
+  
+    2.  **\[ユーザーまたはグループの選択\]** ダイアログ ボックスに、コンピューター名、バックスラッシュの順に入力します。  
+  
+    3.  バックスラッシュの後に、スペースを入れずに「service」と入力します。  
+  
+    4.  **\[名前の確認\]** をクリックします。  
+  
+    5.  複数の名前が表示された場合は、**\[NETWORK SERVICE\]** をクリックして **\[OK\]** をクリックします。  
+  
+    6.  **\[OK\]** をクリックして **\[ユーザーまたはグループの選択\]** ダイアログ ボックスを閉じます。  
+  
+6.  Windows XP SP2 で IIS 5.1 を使用している場合は、**\[グループ名またはユーザー名\]** ボックスに "インターネット ゲスト アカウント" と "ASPNET" の両方が表示されていることを確認します。  
+  
+     ASPNET ユーザーは、組み込みの **\[ユーザー\]** セキュリティ グループのメンバになることができます。この場合、**\[ユーザー\]** グループがこのダイアログ ボックスに表示されていれば、許可されたユーザーの名前の一覧に別個の項目として ASPNET を追加する必要はありません。  
+  
+     ASPNET が **\[ユーザー\]** セキュリティ グループのメンバであるかどうかを確認するには :  
+  
+    1.  **\[スタート\]** メニューの **\[コントロール パネル\]** をクリックします。  
+  
+    2.  **\[ユーザー アカウント\]** アイコンをクリックします。  
+  
+    3.  **\[グループ\]** 列で、**\[ASPNET\]** の値が "Users" であることを確認します。  
+  
+## 参照  
+ [インターネット インフォメーション サービスのホスティング手順](../../../../docs/framework/wcf/samples/internet-information-service-hosting-instructions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/volatile-queued-communication.md b/docs/framework/wcf/samples/volatile-queued-communication.md
new file mode 100644
index 00000000000..4ff302ed161
--- /dev/null
+++ b/docs/framework/wcf/samples/volatile-queued-communication.md
@@ -0,0 +1,243 @@
+---
+title: "揮発性キューによる通信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d012f64-51c7-41d0-8e18-c756f658ee3d
+caps.latest.revision: 28
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 28
+---
+# 揮発性キューによる通信
+このサンプルでは、メッセージ キュー \(MSMQ\) トランスポートで揮発性キューによる通信を実行する方法を示します。このサンプルでは、<xref:System.ServiceModel.NetMsmqBinding> を使用しています。この場合、サービスは自己ホスト型コンソール アプリケーションで、サービスがキュー内のメッセージを受信したかどうかを監視できます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ キュー通信では、クライアントはサービスとの通信にキューを使用します。厳密には、クライアントはメッセージをキューに送信します。サービスは、メッセージをキューから受信します。このため、キューを使用する通信では、サービスとクライアントは同時に実行されていなくてもかまいません。  
+  
+ メッセージを保証なしで送信する場合、MSMQ ではメッセージ配信のみをベスト エフォートで実行します。これとは異なり、正確に 1 回の保証がある場合は、MSMQ はメッセージの配信を確認し、配信できない場合にはメッセージが配信できないことをユーザーに通知します。  
+  
+ 一部のシナリオでは、保証なしの揮発性メッセージをキューに送信する場合があります。この場合は、メッセージの損失より適切な時間での配信が重要です。揮発性メッセージは、キュー マネージャがクラッシュすると失われます。したがって、キュー マネージャがクラッシュした場合は、揮発性メッセージの保存に使用される非トランザクション キューは残りますが、メッセージそのものは失われます。メッセージはディスク上に保存されないためです。  
+  
+> [!NOTE]
+>  MSMQ を使用するトランザクションのスコープ内では、保証なしの揮発性メッセージを送信することはできません。また、揮発性メッセージを送信するには非トランザクション キューを作成する必要があります。  
+  
+ このサンプルのサービス コントラクトは `IStockTicker` です。これは、キューでの使用に最適な一方向サービスを定義します。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+public interface IStockTicker  
+{  
+    [OperationContract(IsOneWay = true)]  
+    void StockTick(string symbol, float price);  
+}  
+  
+```  
+  
+ このサービス操作は、株価情報のシンボルと価格を表示します。次のサンプル コードを参照してください。  
+  
+```  
+public class StockTickerService : IStockTicker  
+{  
+    public void StockTick(string symbol, float price)  
+    {  
+        Console.WriteLine("Stock Tick {0}:{1} ", symbol, price);  
+     }  
+     …  
+}  
+  
+```  
+  
+ サービスは自己ホスト型です。MSMQ トランスポートを使用する場合、使用するキューをあらかじめ作成しておく必要があります。手動で作成することもコードで作成することもできます。このサンプルでは、キューの存在を確認して、必要な場合は作成するためのコードがサービスに含まれています。キュー名は構成ファイルから読み込まれます。ベース アドレスは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で使用され、サービスにプロキシが生成されます。  
+  
+```  
+// Host the service within this EXE console application.  
+public static void Main()  
+{  
+    // Get MSMQ queue name from app settings in configuration.  
+    string queueName = ConfigurationManager.AppSettings["queueName"];  
+  
+    // Create the transacted MSMQ queue if necessary.  
+    if (!MessageQueue.Exists(queueName))  
+        MessageQueue.Create(queueName);  
+  
+    // Create a ServiceHost for the StockTickerService type.  
+    using (ServiceHost serviceHost = new ServiceHost(typeof(StockTickerService)))  
+    {  
+        // Open the ServiceHost to create listeners and start listening for messages.  
+        serviceHost.Open();  
+  
+        // The service can now be accessed.  
+        Console.WriteLine("The service is ready.");  
+        Console.WriteLine("Press <ENTER> to terminate service.");  
+        Console.WriteLine();  
+        Console.ReadLine();  
+  
+        // Close the ServiceHost to shutdown the service.  
+        serviceHost.Close();  
+    }  
+}  
+  
+```  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションに指定されます。サービスのエンドポイントは、構成ファイルの system.serviceModel セクションで定義されます。このエンドポイントは `netMsmqBinding` バインディングを指定します。  
+  
+> [!NOTE]
+>  <xref:System.Messaging> を使用してキューを作成する場合、キュー名では、ローカル コンピューターを表すのにドット \(.\) を使用し、パスの区切りにはバックスラッシュを使用します。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] エンドポイント アドレスでは net.msmq: スキームが指定されます。ローカル コンピュータには "localhost" が使用され、そのパスにはスラッシュが先行します。  
+  
+ メッセージの保証および持続性または揮発性についても、構成ファイルで指定します。  
+  
+```  
+<appSettings>  
+  <!-- use appSetting to configure MSMQ queue name -->  
+  <add key="queueName" value=".\private$\ServiceModelSamplesVolatile" />  
+</appSettings>  
+  
+<system.serviceModel>  
+  <services>  
+    <service name="Microsoft.ServiceModel.Samples.StockTickerService"  
+             behaviorConfiguration="CalculatorServiceBehavior">  
+    ...  
+      <!-- Define NetMsmqEndpoint -->  
+      <endpoint address="net.msmq://localhost/private/ServiceModelSamplesVolatile"  
+                binding="netMsmqBinding"  
+                bindingConfiguration="volatileBinding"   
+                contract="Microsoft.ServiceModel.Samples.IStockTicker" />  
+    ...  
+          </service>  
+  </services>  
+  
+  <bindings>  
+    <netMsmqBinding>  
+      <binding name="volatileBinding"   
+             durable="false"  
+           exactlyOnce="false"/>  
+    </netMsmqBinding>  
+  </bindings>  
+  ...  
+</system.serviceModel>  
+  
+```  
+  
+ サンプルでは非トランザクション キューを使用してキューに置かれたメッセージを送信するので、トランザクション メッセージをキューに送信することはできません。  
+  
+```  
+// Create a client.  
+Random r = new Random(137);  
+  
+StockTickerClient client = new StockTickerClient();  
+  
+float price = 43.23F;  
+for (int i = 0; i < 10; i++)  
+{  
+    float increment = 0.01f * (r.Next(10));  
+    client.StockTick("zzz" + i, price + increment);  
+}  
+  
+//Closing the client gracefully cleans up resources.  
+client.Close();  
+  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信するようすがわかります。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  
+  
+```  
+The service is ready.  
+Press <ENTER> to terminate service.  
+  
+Stock Tick zzz0:43.25  
+Stock Tick zzz1:43.23  
+Stock Tick zzz2:43.28  
+Stock Tick zzz3:43.3  
+Stock Tick zzz4:43.23  
+Stock Tick zzz5:43.25  
+Stock Tick zzz6:43.25  
+Stock Tick zzz7:43.24  
+Stock Tick zzz8:43.32  
+Stock Tick zzz9:43.3  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+ <xref:System.ServiceModel.NetMsmqBinding> を使用する場合の既定では、トランスポート セキュリティが有効です。MSMQ トランスポート セキュリティには、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A> および <xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A> という 2 つの永続プロパティがあります。既定では、認証モードは `Windows` に設定され、保護レベルは `Sign` に設定されます。MSMQ の認証機能と署名機能を利用するには、ドメインに MSMQ があることと、MSMQ に関する Active Directory の統合オプションがインストールされていることが必要です。この条件を満たしていないコンピュータでこのサンプルを実行すると、エラーが発生します。  
+  
+### ワークグループに属しているコンピュータまたは Active Directory 統合のないコンピュータでこのサンプルを実行するには  
+  
+1.  ドメインに属していないコンピュータ、または Active Directory 統合がインストールされていないコンピュータを使用する場合は、トランスポート セキュリティをオフにします。オフにするには、認証モードと保護レベルを `None` にします。この構成コードの例を次に示します。  
+  
+    ```  
+    <system.serviceModel>  
+        <services>  
+          <service name="Microsoft.ServiceModel.Samples.StockTickerService"  
+                   behaviorConfiguration="StockTickerServiceBehavior">  
+            <host>  
+              <baseAddresses>  
+                <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+              </baseAddresses>  
+            </host>  
+  
+            <!-- Define NetMsmqEndpoint -->  
+            <endpoint address="net.msmq://localhost/private/ServiceModelSamplesVolatile"  
+                      binding="netMsmqBinding"  
+                      bindingConfiguration="volatileBinding"   
+                      contract="Microsoft.ServiceModel.Samples.IStockTicker" />  
+            <!-- the mex endpoint is explosed at http://localhost:8000/ServiceModelSamples/service/mex -->  
+            <endpoint address="mex"  
+                      binding="mexHttpBinding"  
+                      contract="IMetadataExchange" />  
+  
+          </service>  
+        </services>  
+  
+        <bindings>  
+          <netMsmqBinding>  
+            <binding name="volatileBinding"   
+                  durable="false"  
+                  exactlyOnce="false">  
+              <security mode="None" />  
+            </binding>  
+          </netMsmqBinding>  
+        </bindings>  
+  
+        <behaviors>  
+          <serviceBehaviors>  
+            <behavior name="StockTickerServiceBehavior">  
+              <serviceMetadata httpGetEnabled="True"/>  
+            </behavior>  
+          </serviceBehaviors>  
+        </behaviors>  
+  
+      </system.serviceModel>  
+  
+    ```  
+  
+2.  サーバーとクライアントの両方の構成を変更したことを確認してから、サンプルを実行します。  
+  
+    > [!NOTE]
+    >  `security mode` を `None` に設定することは、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqAuthenticationMode%2A>、<xref:System.ServiceModel.MsmqTransportSecurity.MsmqProtectionLevel%2A>、および `Message` のセキュリティを  `None` に設定することと同じです。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\Net\MSMQ\Volatile`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wcf-analytic-tracing.md b/docs/framework/wcf/samples/wcf-analytic-tracing.md
new file mode 100644
index 00000000000..0b3f7592422
--- /dev/null
+++ b/docs/framework/wcf/samples/wcf-analytic-tracing.md
@@ -0,0 +1,128 @@
+---
+title: "WCF 分析トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6029c7c7-3515-4d36-9d43-13e8f4971790
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# WCF 分析トレース
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] が [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] の ETW に書き込む分析トレースのストリームに独自のトレース イベントを追加する方法を示します。分析トレースは、パフォーマンスを低下させずに簡単にサービスを確認できるようにするためのものです。このサンプルでは、<xref:System.Diagnostics.Eventing?displayProperty=fullName> API を使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと統合されるイベントを記述する方法を示します。  
+  
+ <xref:System.Diagnostics.Eventing?displayProperty=fullName> API [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「<xref:System.Diagnostics.Eventing?displayProperty=fullName>」を参照してください。  
+  
+ Windows でのイベントのトレースの詳細については、「[ETW によりデバッグおよびパフォーマンス調整を改善する](http://go.microsoft.com/fwlink/?LinkId=166488)」を参照してください。  
+  
+## EventProvider の破棄  
+ このサンプルでは、<xref:System.IDisposable?displayProperty=fullName> を実装した <xref:System.Diagnostics.Eventing.EventProvider?displayProperty=fullName> クラスを使用します。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのトレースを実装する場合、サービスの有効期間に <xref:System.Diagnostics.Eventing.EventProvider> のリソースを使用することがあります。そのため、読みやすくするためにも、このサンプルでは、ラップされた <xref:System.Diagnostics.Eventing.EventProvider> を破棄しません。何かの理由で、サービスに対して別のトレースの要件を設定し、このリソースを破棄しなければならない場合は、アンマネージ リソースの破棄に関するベスト プラクティスに従ってこのサンプルを変更してください。アンマネージ リソースの破棄[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Dispose メソッドの実装](http://go.microsoft.com/fwlink/?LinkId=166436)」を参照してください。  
+  
+## 自己ホスト型と Web ホスト型  
+ Web ホスト型サービスの場合は、WCF の分析トレースで "HostReference" というフィールドが設定され、そのフィールドを使用してトレースの生成元のサービスを識別します。拡張可能なユーザー トレースをこのモデルに加えることができます。このサンプルで、そのためのベスト プラクティスを示します。結果の文字列にパイプ文字 '&#124;' が実際に表示さるときには、Web ホストの参照の形式は次のいずれかになります。  
+  
+-   アプリケーションがルート以外にある場合  
+  
+     \<サイト名\>\<アプリケーション仮想パス\>&#124;\<サービス仮想パス\>&#124;\<サービス名\>  
+  
+-   アプリケーションがルートにある場合  
+  
+     \<サイト名\>&#124;\<サービス仮想パス\>&#124;\<サービス名\>  
+  
+ 自己ホスト型サービスの場合は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の分析トレースで "HostReference" フィールドが設定されません。このサンプルの `WCFUserEventProvider` クラスは、自己ホスト型サービスで使用した場合も同じように動作します。  
+  
+## カスタム イベントの詳細  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の ETW イベント プロバイダー マニフェストには、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの作成者がサービス コード内から生成できるように設計された 3 つのイベントが定義されています。次の表に、その 3 つのイベントの概要を示します。  
+  
+|イベント|説明|イベント ID|  
+|----------|--------|-------------|  
+|UserDefinedInformationEventOccurred|このイベントは、問題以外の通知すべき処理がサービスで発生した場合に生成します。たとえば、データベースの呼び出しに成功した後にイベントを生成します。|301|  
+|UserDefinedWarningOccurred|このイベントは、後続の処理でエラーになる可能性がある問題が発生した場合に生成します。たとえば、データベースの呼び出しが失敗したものの、冗長なデータ ストアを使用して回復できた場合に警告イベントを生成します。|302|  
+|UserDefinedErrorOccurred|このイベントは、サービスが想定どおりに動作しなかった場合に生成します。たとえば、データベースの呼び出しが失敗し、別の場所からもデータを取得できなかった場合にイベントを生成します。|303|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、WCFAnalyticTracingExtensibility.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+     Web ブラウザーで、**\[Calculator.svc\]** をクリックします。サービスの WSDL ドキュメントの URI がブラウザーに表示されます。その URI をコピーします。  
+  
+4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアント \(WcfTestClient.exe\) を実行します。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアント \(WcfTestClient.exe\) は \<[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] のインストール ディレクトリ\>\\Common7\\IDE\\WcfTestClient.exe にあります \([!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] の既定のインストール ディレクトリは C:\\Program Files\\Microsoft Visual Studio 10.0 です\)。  
+  
+5.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックしてサービスを追加します。  
+  
+     入力ボックスにエンドポイントのアドレスを追加します。  
+  
+6.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+     ICalculator サービスが、左ペインの **\[マイ サービス プロジェクト\]** の下に追加されます。  
+  
+7.  イベント ビューアー アプリケーションを開きます。  
+  
+     サービスを呼び出す前に、イベント ビューアーを起動し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスから生成された追跡イベントをイベント ログでリッスンしていることを確認します。  
+  
+8.  **\[スタート\]** メニューから、**\[管理ツール\]**、**\[イベント ビューアー\]** の順に選択します。**\[分析\]** ログと **\[デバッグ\]** ログを有効にします。  
+  
+9. イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[アプリケーション サーバー \- アプリケーション\]** を右クリックし、**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。  
+  
+     **\[分析およびデバッグ ログの表示\]** オプションがオンになっていることを確認します。**\[分析\]** ログを有効にします。  
+  
+     イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に選択して **\[分析\]** に移動します。**\[分析\]** を右クリックし、**\[ログを有効にする\]** を選択します。  
+  
+10. WCF テスト クライアントを使用してサービスをテストします。  
+  
+    1.  WCF テスト クライアントで、ICalculator サービス ノードの下の **\[Add\(\)\]** をダブルクリックします。  
+  
+         **Add\(\)** メソッドが、2 つのパラメーターと共に右ペインに表示されます。  
+  
+    2.  最初のパラメーターに「2」と入力し、2 番目のパラメーターに「3」と入力します。  
+  
+    3.  **\[呼び出し\]** をクリックしてメソッドを呼び出します。  
+  
+11. 既に開いている **\[イベント ビューアー\]** ウィンドウに移動します。**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  
+  
+12. **\[分析\]** ノードを右クリックし、**\[最新の情報に更新\]** をクリックします。  
+  
+     右ペインにイベントが表示されます。  
+  
+13. ID が 303 のイベントを探してダブルクリックして開き、内容を確認します。  
+  
+     このイベントは、ICalculator サービスの `Add()` メソッドによって生成されたもので、ペイロードは "2\+3\=5" になります。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  **イベント ビューアー**を開きます。  
+  
+2.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログの無効化\]** を選択します。  
+  
+3.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に選択して **\[分析\]** に移動します。**\[分析\]** を右クリックし、**\[ログのクリア\]** を選択します。  
+  
+4.  **\[クリア\]** をクリックしてログをクリアします。  
+  
+## 既知の問題  
+ **イベント ビューアー**の既知の問題により、ETW イベントをデコードできない場合があります。その場合、"ソース "Microsoft\-Windows\-Application Server\-Applications" からのイベント ID \<id\> の説明が見つかりません。このイベントを発生させるコンポーネントがローカル コンピューターにインストールされていないか、インストールが壊れています。ローカル コンピューターにコンポーネントをインストールするか、コンポーネントを修復してください。" というエラー メッセージが表示されます。このエラーが発生した場合は、**\[操作\]** メニューの **\[最新の情報に更新\]** をクリックしてください。これにより、イベントが正常にデコードされます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\ETWTrace`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md b/docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md
new file mode 100644
index 00000000000..171da2db3e0
--- /dev/null
+++ b/docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md
@@ -0,0 +1,98 @@
+---
+title: "WCF サービスと Event Tracing for Windows | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eda4355d-0bd0-4dc9-80a2-d2c832152272
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# WCF サービスと Event Tracing for Windows
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の分析トレースを使用して、Event Tracing for Windows \(ETW\) でイベントを出力する方法を示します。  分析トレースは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] スタック内のキー ポイントで出力されるイベントです。これにより、運用環境での [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのトラブルシューティングが可能になります。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの分析トレースは、有効にしてもパフォーマンスに最小限の影響しか及ぼさないため、運用環境で使用することができます。  これらのトレースは、ETW セッションにイベントとして出力されます。  
+  
+ このサンプルには、サービスのイベントをイベント ログに出力する基本的な [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが含まれています。イベント ログは、イベント ビューアーを使用して表示できます。  また、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのイベントをリッスンする専用の ETW セッションを開始することもできます。  サンプルには、バイナリ ファイルにイベントを格納する専用の ETW セッションを作成するためのスクリプトが含まれています。このバイナリ ファイルもイベント ビューアーを使用して読み取ることができます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、EtwAnalyticTraceSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+     Web ブラウザーで、**\[Calculator.svc\]** をクリックします。  サービスの WSDL ドキュメントの URI がブラウザーに表示されます。  その URI をコピーします。  
+  
+     既定では、ポート 1378 \(http:\/\/localhost:1378\/Calculator.svc\) で要求のリッスンが開始されます。  
+  
+4.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアント \(WcfTestClient.exe\) を実行します。  
+  
+     [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアント \(WcfTestClient.exe\) は \<[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] のインストール ディレクトリ\>\\Common7\\IDE\\WcfTestClient.exe にあります \([!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] の既定のインストール ディレクトリは C:\\Program Files\\Microsoft Visual Studio 10.0 です\)。  
+  
+5.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックしてサービスを追加します。  
+  
+     入力ボックスにエンドポイントのアドレスを追加します。  既定値は http:\/\/localhost:1378\/Calculator.svc です。  
+  
+6.  イベント ビューアー アプリケーションを開きます。  
+  
+     サービスを呼び出す前に、イベント ビューアーを起動し、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスから生成された追跡イベントをイベント ログでリッスンしていることを確認します。  
+  
+7.  **\[スタート\]** メニューから、**\[管理ツール\]**、**\[イベント ビューアー\]** の順に選択します。  **\[分析\]** ログと **\[デバッグ\]** ログを有効にします。  
+  
+8.  イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  **\[アプリケーション サーバー \- アプリケーション\]** を右クリックし、**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。  
+  
+     **\[分析およびデバッグ ログの表示\]** オプションがオンになっていることを確認します。  
+  
+9. **\[分析\]** ログを有効にします。  
+  
+     イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  **\[分析\]** を右クリックし、**\[ログを有効にする\]** をクリックします。  
+  
+#### サービスをテストするには  
+  
+1.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] テスト クライアントに戻り、\[`Divide`\] をダブルクリックします。既定値のまま、分母を 0 にしておきます。  
+  
+     分母が 0 の場合、サービスからエラーがスローされます。  
+  
+2.  サービスから出力されたイベントを確認します。  
+  
+     イベント ビューアーに戻り、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  **\[分析\]** を右クリックし、**\[更新\]** をクリックします。  
+  
+     WCF 分析トレースのイベントがイベント ビューアーに表示されます。  サービスからエラーがスローされたため、イベント ビューアーにエラー トレース イベントが表示されていることに注意してください。  
+  
+3.  手順 1. と 2. を繰り返します。ただし、今度は有効な入力値を指定します。  `N2` パラメーターの値は、0 以外であれば任意の数字でかまいません。  
+  
+     分析チャネルを更新して、WCF イベントにエラー イベントが含まれていないことを確認します。  
+  
+ このサンプルでは、WCF サービスから出力される分析トレース イベントを示します。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  イベント ビューアーを開きます。  
+  
+2.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  **\[分析\]** を右クリックし、**\[ログの無効化\]** を選択します。  
+  
+3.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。  **\[分析\]** を右クリックし、**\[ログのクリア\]** を選択します。  
+  
+4.  **\[クリア\]** をクリックしてイベントをクリアします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\ETWTracing`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wcf-to-message-queuing.md b/docs/framework/wcf/samples/wcf-to-message-queuing.md
new file mode 100644
index 00000000000..eba01d25d9f
--- /dev/null
+++ b/docs/framework/wcf/samples/wcf-to-message-queuing.md
@@ -0,0 +1,190 @@
+---
+title: "Windows Communication Foundation でのメッセージ キュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 78d0d0c9-648e-4d4a-8f0a-14d9cafeead9
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# Windows Communication Foundation でのメッセージ キュー
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] アプリケーションでメッセージをメッセージ キュー \(MSMQ\) アプリケーションに送信する方法について説明します。サービスは、自己ホスト型コンソール アプリケーションで、サービスがキュー内のメッセージを受信したかどうかを監視できます。サービスとクライアントは同時に実行されていなくてもかまいません。  
+  
+ サービスは、メッセージをキューから受信して注文を処理します。サービスはトランザクション キューを作成し、メッセージがメッセージ ハンドラによって受信されるように設定します。次のサンプル コードを参照してください。  
+  
+```  
+static void Main(string[] args)  
+{  
+    if (!MessageQueue.Exists(  
+              ConfigurationManager.AppSettings["queueName"]))  
+       MessageQueue.Create(  
+           ConfigurationManager.AppSettings["queueName"], true);  
+        //Connect to the queue  
+        MessageQueue Queue = new   
+    MessageQueue(ConfigurationManager.AppSettings["queueName"]);  
+    Queue.ReceiveCompleted +=   
+                 new ReceiveCompletedEventHandler(ProcessOrder);  
+    Queue.BeginReceive();  
+    Console.WriteLine("Order Service is running");  
+    Console.ReadLine();  
+}  
+  
+```  
+  
+ メッセージがキュー内で受信されると、メッセージ ハンドラ `ProcessOrder` が呼び出されます。  
+  
+```  
+public static void ProcessOrder(Object source,  
+    ReceiveCompletedEventArgs asyncResult)  
+{  
+    try  
+    {  
+        // Connect to the queue.  
+        MessageQueue Queue = (MessageQueue)source;  
+        // End the asynchronous receive operation.  
+        System.Messaging.Message msg =   
+                     Queue.EndReceive(asyncResult.AsyncResult);  
+        msg.Formatter = new System.Messaging.XmlMessageFormatter(  
+                                new Type[] { typeof(PurchaseOrder) });  
+        PurchaseOrder po = (PurchaseOrder) msg.Body;  
+        Random statusIndexer = new Random();  
+        po.Status = PurchaseOrder.OrderStates[statusIndexer.Next(3)];  
+        Console.WriteLine("Processing {0} ", po);  
+        Queue.BeginReceive();  
+    }  
+    catch (System.Exception ex)  
+    {  
+        Console.WriteLine(ex.Message);  
+    }  
+  
+}  
+  
+```  
+  
+ サービスは MSMQ メッセージ本文から `ProcessOrder` を抽出し、注文を処理します。  
+  
+ MSMQ キュー名は、構成ファイルの appSettings セクションに指定されます。次のサンプル構成を参照してください。  
+  
+```  
+<appSettings>  
+    <add key="orderQueueName" value=".\private$\Orders" />  
+</appSettings>  
+  
+```  
+  
+> [!NOTE]
+>  キュー名では、ドット \(.\) を使用してローカル コンピューターを表し、バックスラッシュを使用してパスを区切ります。  
+  
+ クライアントは発注書を作成してトランザクションのスコープ内に送信します。次のサンプル コードを参照してください。  
+  
+```  
+// Create the purchase order  
+PurchaseOrder po = new PurchaseOrder();  
+// Fill in the details  
+...  
+  
+OrderProcessorClient client = new OrderProcessorClient("OrderResponseEndpoint");  
+  
+MsmqMessage<PurchaseOrder> ordermsg = new MsmqMessage<PurchaseOrder>(po);  
+using (TransactionScope scope = new TransactionScope(TransactionScopeOption.Required))  
+{  
+    client.SubmitPurchaseOrder(ordermsg);  
+    scope.Complete();  
+}  
+Console.WriteLine("Order has been submitted:{0}", po);  
+  
+//Closing the client gracefully closes the connection and cleans up resources  
+client.Close();  
+  
+```  
+  
+ クライアントは、MSMQ メッセージをキューに送信するためにカスタム クライアントを順に使用します。メッセージを受信して処理するアプリケーションが MSMQ アプリケーションであり、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションではないので、2 つのアプリケーション間で暗黙のサービス コントラクトはありません。したがって、このシナリオでは Svcutil.exe ツールを使用してプロキシを作成することはできません。  
+  
+ カスタム クライアントは基本的に、`MsmqIntegration` バインディングを使用してメッセージを送信するすべての [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] アプリケーションで同じです。他のクライアントと異なり、サービス操作の範囲は含まれません。メッセージ送信操作のみです。  
+  
+```  
+  
+[System.ServiceModel.ServiceContractAttribute(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+public interface IOrderProcessor  
+{  
+    [OperationContract(IsOneWay = true, Action = "*")]  
+    void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg);  
+}  
+  
+public partial class OrderProcessorClient : System.ServiceModel.ClientBase<IOrderProcessor>, IOrderProcessor  
+{  
+    public OrderProcessorClient(){}  
+  
+    public OrderProcessorClient(string configurationName)  
+        : base(configurationName)  
+    { }  
+  
+    public OrderProcessorClient(System.ServiceModel.Channels.Binding binding, System.ServiceModel.EndpointAddress address)  
+        : base(binding, address)  
+    { }  
+  
+    public void SubmitPurchaseOrder(MsmqMessage<PurchaseOrder> msg)  
+    {  
+        base.Channel.SubmitPurchaseOrder(msg);  
+    }  
+}  
+```  
+  
+ サンプルを実行すると、クライアントとサービスのアクティビティがサービスとクライアントの両方のコンソール ウィンドウに表示されます。サービスがクライアントからメッセージを受信するようすがわかります。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。キューが使用されているので、クライアントとサービスが同時に実行されている必要はありません。たとえば、クライアントを実行してシャットダウンした後にサービスを起動しても、サービスはメッセージを受信します。  
+  
+> [!NOTE]
+>  このサンプルを実行するには、メッセージ キューがインストールされている必要があります。インストールの手順については、「[メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=94968)」を参照してください。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  サービスを最初に実行すると、サービスはキューが存在するかどうかを確認します。キューが存在しない場合、サービスによってキューが作成されます。最初にサービスを実行してキューを作成することも、MSMQ キュー マネージャーでキューを作成することもできます。Windows 2008 でキューを作成するには、次の手順に従います。  
+  
+    1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でサーバー マネージャーを開きます。  
+  
+    2.  **\[機能\]** タブを展開します。  
+  
+    3.  **\[プライベート メッセージ キュー\]** を右クリックし、**\[新規作成\]**、**\[専用キュー\]** の順にクリックします。  
+  
+    4.  **\[トランザクション\]** ボックスをオンにします。  
+  
+    5.  新しいキューの名前として、「`ServiceModelSamplesTransacted`」と入力します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービスのプログラム ファイルを、言語固有のフォルダーにある \\service\\bin\\ フォルダーからサービス コンピューターにコピーします。  
+  
+2.  クライアント プログラム ファイルを、言語固有のフォルダーにある \\client\\bin\\ フォルダーからクライアント コンピューターにコピーします。  
+  
+3.  Client.exe.config ファイルで、クライアント エンドポイントのアドレスを変更して "." の代わりにサービス コンピューター名を指定します。  
+  
+4.  サービス コンピューターで、コマンド プロンプトから Service.exe を起動します。  
+  
+5.  クライアント コンピューターで、コマンド プロンプトから Client.exe を起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\MSMQIntegration\WcfToMsmq`  
+  
+## 参照  
+ [方法 : WCF エンドポイントとメッセージ キュー アプリケーションを使用してメッセージを交換する](../../../../docs/framework/wcf/feature-details/how-to-exchange-messages-with-wcf-endpoints-and-message-queuing-applications.md)   
+ [メッセージ キュー](http://go.microsoft.com/fwlink/?LinkId=94968)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/weakly-typed-json-serialization-sample.md b/docs/framework/wcf/samples/weakly-typed-json-serialization-sample.md
new file mode 100644
index 00000000000..bff6295bb4f
--- /dev/null
+++ b/docs/framework/wcf/samples/weakly-typed-json-serialization-sample.md
@@ -0,0 +1,153 @@
+---
+title: "弱い型指定の JSON のシリアル化のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0b30e501-4ef5-474d-9fad-a9d559cf9c52
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 弱い型指定の JSON のシリアル化のサンプル
+特定のワイヤ形式にユーザー定義型をシリアル化するときや、ユーザー定義型にワイヤ形式を逆シリアル化するときは、そのユーザー定義型がサービスとクライアントの両方で使用可能である必要があります。 通常、これを実現するために、<xref:System.Runtime.Serialization.DataContractAttribute> 属性がこのユーザー定義型に適用され、<xref:System.Runtime.Serialization.DataMemberAttribute> 属性がそのメンバに適用されます。 この機構は、「[方法 : JSON データをシリアル化および逆シリアル化する](../../../../docs/framework/wcf/feature-details/how-to-serialize-and-deserialize-json-data.md)」トピックで説明されているように、JavaScript Object Notation \(JSON\) オブジェクトを使用する場合にも適用されます。  
+  
+ 場合によっては、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスまたはクライアントが、開発者の管理外にあるサービスまたはクライアントによって生成された JSON オブジェクトにアクセスする必要があります。 より多くの Web サービスによって JSON API がパブリックとして公開されると、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 開発者がローカルのユーザー定義型を構築し、任意の JSON オブジェクトを逆シリアル化することが実用的でなくなる可能性があります。 このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 開発者がユーザー定義型を作成せずに、逆シリアル化された任意の JSON オブジェクトを使用できる機構を示します。 このしくみは、JSON オブジェクトが逆シリアル化される型がコンパイル時に不明なため、JSON オブジェクトの*弱い型指定のシリアル化*と呼ばれます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ たとえば、パブリック Web サービスの API によって、このサービスのユーザーに関する情報の一部を記述した次の JSON オブジェクトが返されるとします。  
+  
+```  
+{"personal": {"name": "Paul", "age": 23, "height": 1.7, "isSingle": true, "luckyNumbers": [5,17,21]}, "favoriteBands": ["Band ABC", "Band XYZ"]}  
+```  
+  
+ このオブジェクトを逆シリアル化するために、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントは次のユーザー定義型を実装する必要があります。  
+  
+```  
+[DataContract]  
+ public class MemberProfile  
+ {  
+     [DataMember]  
+     public PersonalInfo personal;  
+  
+     [DataMember]  
+     public string[] favoriteBands;  
+ }  
+  
+ [DataContract]  
+ public class PersonalInfo  
+ {  
+     [DataMember]  
+     public string name;  
+  
+     [DataMember]  
+     public int age;  
+  
+     [DataMember]  
+     public double height;  
+  
+     [DataMember]  
+     public bool isSingle;  
+  
+     [DataMember]  
+     public int[] luckyNumbers;  
+ }  
+  
+```  
+  
+ この手順は、特にクライアントが複数の型の JSON オブジェクトを処理する必要がある場合に、複雑になる可能性があります。  
+  
+ このサンプルで示す `JsonObject` 型では、逆シリアル化された JSON オブジェクトの弱い型指定の表現を使用します。`JsonObject` は、JSON オブジェクトと [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ディクショナリ間の自然な割り当て、および JSON 配列と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 配列間の割り当てに依存しています。`JsonObject` 型のコードを次に示します。  
+  
+```  
+// Instantiation of JsonObject json omitted  
+  
+string name = json["root"]["personal"]["name"];  
+int age = json["root"]["personal"]["age"];  
+double height = json["root"]["personal"]["height"];  
+bool isSingle = json["root"]["personal"]["isSingle"];  
+int[] luckyNumbers = {  
+                                     json["root"]["personal"]["luckyNumbers"][0],  
+                                     json["root"]["personal"]["luckyNumbers"][1],  
+                                     json["root"]["personal"]["luckyNumbers"][2]   
+                                 };  
+string[] favoriteBands = {  
+                                        json["root"]["favoriteBands"][0],  
+                                        json["root"]["favoriteBands"][1]  
+                                    };  
+```  
+  
+ コンパイル時に型を宣言せずに、JSON オブジェクトと配列を "参照" できます。 トップレベルの `["root"]` オブジェクトの詳細については、「[JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)」を参照してください。  
+  
+> [!NOTE]
+>  `JsonObject` クラスは、例としてのみ提供されています。 テストが完全には行われていないため、運用環境では使用しないでください。 弱い型指定の JSON のシリアル化の明確な影響の 1 つは、`JsonObject` の使用時にタイプ セーフがなくなることです。  
+  
+ `JsonObject` 型を使用するには、クライアント操作コントラクトで <xref:System.ServiceModel.Channels.Message> を戻り値の型として使用する必要があります。  
+  
+```  
+[ServiceContract]  
+    interface IClientSideProfileService  
+    {  
+        // There is no need to write a DataContract for the complex type returned by the service.  
+        // The client will use a JsonObject to browse the JSON in the received message.  
+  
+        [OperationContract]  
+        [WebGet(ResponseFormat = WebMessageFormat.Json)]  
+        Message GetMemberProfile();  
+    }  
+  
+```  
+  
+ 次のコードに示すように、`JsonObject` がインスタンス化されます。  
+  
+```  
+// Code to instantiate IClientSideProfileService channel omitted…  
+  
+// Make a request to the service and obtain the Json response  
+XmlDictionaryReader reader = channel.GetMemberProfile().GetReaderAtBodyContents();  
+  
+// Go through the Json as though it is a dictionary. There is no need to map it to a .NET CLR type.  
+JsonObject json = new JsonObject(reader);  
+  
+```  
+  
+ `JsonObject` コンストラクタは、<xref:System.Xml.XmlDictionaryReader> メソッドを使用して取得される <xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A> を受け取ります。 リーダーには、クライアントによって受信された JSON メッセージの XML 表現が含まれています。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)][JSON と XML 間のマッピング](../../../../docs/framework/wcf/feature-details/mapping-between-json-and-xml.md)」のトピックを参照してください。  
+  
+ このプログラムの出力は、次のようになります。  
+  
+```  
+Service listening at http://localhost:8000/.  
+To view the JSON output from the sample, navigate to http://localhost:8000/GetMemberProfile  
+This is Paul's page. I am 23 years old and I am 1.7 meters tall.  
+I am single.  
+My lucky numbers are 5, 17, and 21.  
+My favorite bands are Band ABC and Band XYZ.  
+```  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の説明に従って、ソリューション WeaklyTypedJson.sln をビルドします。  
+  
+3.  ソリューションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。 続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。 このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Scenario\Ajax\WeaklyTypedJson`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/web-extensibility.md b/docs/framework/wcf/samples/web-extensibility.md
new file mode 100644
index 00000000000..d91e5d43cf2
--- /dev/null
+++ b/docs/framework/wcf/samples/web-extensibility.md
@@ -0,0 +1,24 @@
+---
+title: "Web 拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 10d2aa64-a954-407e-a9cf-42bb2f0fd04a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Web 拡張
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のカスタム Web 機能を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [フォーム ポスト](../../../../docs/framework/wcf/samples/form-post.md)  
+ WCF Web HTTP プログラミング モデルを拡張して新しい受信要求形式をサポートする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/web.md b/docs/framework/wcf/samples/web.md
new file mode 100644
index 00000000000..9c31dde05a3
--- /dev/null
+++ b/docs/framework/wcf/samples/web.md
@@ -0,0 +1,54 @@
+---
+title: "Web | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88794df1-8e2d-431e-b377-2fd3dc7942ab
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# Web
+このセクションには、Web ホストのサンプルが含まれています。  
+  
+## このセクションの内容  
+ [高度な形式選択](../../../../docs/framework/wcf/samples/advanced-format-selection.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルを拡張して新しい送信応答形式をサポートする方法を示します。  
+  
+ [形式の自動選択](../../../../docs/framework/wcf/samples/automatic-format-selection.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルで形式の自動選択 \(XML または JSON\) を有効にする方法と、操作コードで形式を明示的に設定する方法を示します。  
+  
+ [基本的な HTTP サービス](../../../../docs/framework/wcf/samples/basic-http-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルを使用して、一般に "POX" \(Plain Old XML\) サービスと呼ばれる、HTTP ベース、RPC ベースのサービスを実装する方法を示します。  
+  
+ [基本的なリソース サービス](../../../../docs/framework/wcf/samples/basic-resource-service.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルを使用して HTTP ベースのサービスを実装する方法を示します。このモデルでは、取得、追加、削除、および置換の各操作をサポートするカスタマーのコレクションが公開されます。  
+  
+ [AspNetRouteIntegration](../../../../docs/framework/wcf/samples/aspnetrouteintegration.md)  
+ ASP.NET ルートを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP サービスをホストする方法を示します。  
+  
+ [条件付きの Get と Put](../../../../docs/framework/wcf/samples/conditional-get-and-put.md)  
+ 新しい条件付きの取得 API と更新 API を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルで使用する方法を示します。  
+  
+ [SOAP エンドポイントおよび HTTP エンドポイント](../../../../docs/framework/wcf/samples/soap-and-http-endpoints.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルを使用して、RPC ベースのサービスを実装し、SOAP 形式および "Plain Old XML" \(POX\) 形式でサービスを公開する方法を示します。  
+  
+ [ASP.NET キャッシュ統合](../../../../docs/framework/wcf/samples/aspnet-caching-integration.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] Web HTTP プログラミング モデルで ASP.NET 出力キャッシュを利用する方法を示します。  
+  
+ [UriTemplate](../../../../docs/framework/wcf/samples/uritemplate-sample.md)  
+ <xref:System.UriTemplate> に関連する重要な概念を示します。  
+  
+ [UriTemplate テーブル](../../../../docs/framework/wcf/samples/uritemplate-table-sample.md)  
+ <xref:System.UriTemplateTable> クラスで、<xref:System.UriTemplate> インスタンスのセットを使用するための、ディクショナリに似た結合テーブル構造を提供する方法を示します。  
+  
+ [UriTemplate テーブル ディスパッチャー](../../../../docs/framework/wcf/samples/uritemplate-table-dispatcher-sample.md)  
+ <xref:System.UriTemplateTable> クラスの一般的な使用シナリオとして、<xref:System.UriTemplateTable> を使用してビルドされた基本的なディスパッチ エンジンを示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/webcontenttypemapper-sample.md b/docs/framework/wcf/samples/webcontenttypemapper-sample.md
new file mode 100644
index 00000000000..1a246217a4d
--- /dev/null
+++ b/docs/framework/wcf/samples/webcontenttypemapper-sample.md
@@ -0,0 +1,80 @@
+---
+title: "WebContentTypeMapper のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4fe59e7-44d8-43c6-a1f8-40c45223adca
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# WebContentTypeMapper のサンプル
+このサンプルでは、新しいコンテンツ タイプを [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] メッセージの本文の書式に割り当てる方法を示します。  
+  
+ <xref:System.ServiceModel.Description.WebHttpEndpoint> 要素は、Web メッセージ エンコーダーをプラグインします。これによって、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、JSON、XML、または生のバイナリ メッセージを同じエンドポイントで受信できるようになります。このエンコーダは、要求の HTTP コンテンツ タイプを調べて、メッセージ本文の書式を決定します。このサンプルでは、コンテンツ タイプと本文書式との間の割り当てを制御するための <xref:System.ServiceModel.Channels.WebContentTypeMapper> クラスを示します。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] には、各コンテンツ タイプの既定の割り当てが用意されています。たとえば、`application/json` は JSON に割り当てられ、`text/xml` は XML に割り当てられています。JSON または XML に割り当てられていないコンテンツ タイプは、生のバイナリ形式に割り当てられます。  
+  
+ 場合によっては \(プッシュ スタイルの API など\)、クライアントによって返されるコンテンツ タイプがサービス開発者によって制御されないことがあります。たとえば、クライアントは `application/json` としてではなく `text/javascript` として JSON を返す場合があります。この場合、サービス開発者は、特定のコンテンツ タイプを正しく処理できるように、次のサンプル コードに示すような <xref:System.ServiceModel.Channels.WebContentTypeMapper> の派生型を指定する必要があります。  
+  
+```  
+public class JsonContentTypeMapper : WebContentTypeMapper  
+{  
+    public override WebContentFormat  
+               GetMessageFormatForContentType(string contentType)  
+    {  
+        if (contentType == "text/javascript")  
+        {  
+            return WebContentFormat.Json;  
+        }  
+        else  
+        {  
+            return WebContentFormat.Default;  
+        }  
+    }  
+}  
+  
+```  
+  
+ この派生型は、<xref:System.ServiceModel.Channels.WebContentTypeMapper.GetMessageFormatForContentType%28System.String%29> メソッドをオーバーライドする必要があります。このメソッドは、`contentType` 引数を評価して、<xref:System.ServiceModel.Channels.WebContentFormat>、<xref:System.ServiceModel.Channels.WebContentFormat>、<xref:System.ServiceModel.Channels.WebContentFormat>、または <xref:System.ServiceModel.Channels.WebContentFormat> のいずれかの値を返す必要があります。<xref:System.ServiceModel.Channels.WebContentFormat> の戻り値は、Web メッセージ エンコーダの既定の割り当てによって決まります。前のサンプル コードでは、`text/javascript` コンテンツ タイプが JSON に割り当てられ、その他のすべての割り当ては変わりません。  
+  
+ `JsonContentTypeMapper` クラスを使用するには、Web.config 内で次のコードを使用します。  
+  
+```  
+<system.serviceModel>  
+  <standardEndpoints>  
+    <webHttpEndpoint>  
+      <standardEndpoint name="" contentTypeMapper="Microsoft.Samples.WebContentTypeMapper.JsonContentTypeMapper, JsonContentTypeMapper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+    </webHttpEndpoint>  
+  </standardEndpoints>  
+</system.serviceModel>  
+```  
+  
+ JsonContentTypeMapper の使用要件を検証するには、Web.config ファイルから contentTypeMapper 属性を削除します。`text/javascript` を使用して JSON コンテンツを送信しようとすると、クライアント ページの読み込みに失敗します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従って、ソリューション WebContentTypeMapperSample.sln をビルドします。  
+  
+3.  http:\/\/localhost\/ServiceModelSamples\/JCTMClientPage.htm に移動します \(プロジェクト ディレクトリ内からブラウザーで JCTMClientPage.htm を開かないでください\)。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Ajax\WebContentTypeMapper`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/windows-process-activation.md b/docs/framework/wcf/samples/windows-process-activation.md
new file mode 100644
index 00000000000..961486d330f
--- /dev/null
+++ b/docs/framework/wcf/samples/windows-process-activation.md
@@ -0,0 +1,27 @@
+---
+title: "Windows プロセス アクティブ化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37b79642-1e6f-44b3-9777-98af57443bfa
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# Windows プロセス アクティブ化
+このセクションには、ネットワーク プロトコルを使用したサービスのアクティブ化について説明するサンプルが含まれています。  
+  
+## このセクションの内容  
+ [NamedPipe アクティベーション](../../../../docs/framework/wcf/samples/namedpipe-activation.md)  
+ 名前付きパイプを介して通信するサービスをアクティブ化するために、Windows プロセス アクティブ化サービス \(WAS: Windows Process Activation Service\) を使用してサービスをホストする方法を示します。  
+  
+ [TCP アクティベーション](../../../../docs/framework/wcf/samples/tcp-activation.md)  
+ net.tcp プロトコルで通信するサービスをアクティブ化するために、Windows プロセス アクティブ化サービス \(WAS\) を使用してサービスをホストする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/windows-service-host.md b/docs/framework/wcf/samples/windows-service-host.md
new file mode 100644
index 00000000000..6a9440836ca
--- /dev/null
+++ b/docs/framework/wcf/samples/windows-service-host.md
@@ -0,0 +1,78 @@
+---
+title: "Windows サービス ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "NT サービス"
+  - "NT サービス ホスト サンプル [Windows Communication Foundation]"
+ms.assetid: 1b2f45c5-2bed-4979-b0ee-8f9efcfec028
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# Windows サービス ホスト
+このサンプルでは、マネージ Windows サービスでホストされる [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを示します。Windows サービスは、**\[コントロール パネル\]** のサービス アプレットを使用して制御されます。また、システムの再起動後に自動的に開始するように構成できます。このサンプルは、クライアント プログラムと Windows サービス プログラムで構成されています。サービスは .exe プログラムとして実装され、独自のホスティング コードが指定されます。Windows プロセス アクティブ化サービス \(WAS\) やインターネット インフォメーション サービス \(IIS\) などの他のホスト環境では、ホスティング コードを記述する必要はありません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Services\Hosting\WindowsService`  
+  
+ このサービスをビルドしたら、他の Windows サービスと同様、Installutil.exe ユーティリティを使用してインストールする必要があります。サービスを変更する場合は、`installutil /u` を使用して、まずそのサービスをアンインストールする必要があります。このサンプルに含まれている Setup.bat ファイルは Windows Service をインストールして起動するコマンド ファイルです。同様にこのサンプルに含まれている Cleanup.bat ファイルは、Windows サービスをシャットダウンしてアンインストールするコマンド ファイルです。Windows サービスが実行されている場合、クライアントに応答できるサービスは [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのみです。**\[コントロール パネル\]** のサービス アプレットを使用して Windows サービスを停止し、クライアントを実行した場合、クライアントがこのサービスにアクセスしようとすると、<xref:System.ServiceModel.EndpointNotFoundException> 例外が発生します。Windows サービスを再起動してクライアントを再実行した場合は、通信が正常に行われます。  
+  
+ サービス コードにはインストーラー クラス、ICalculator コントラクトを実装する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービス実装クラス、およびランタイム ホストとして機能する Windows サービス クラスが含まれています。インストーラー クラスは <xref:System.Configuration.Install.Installer> を継承します。このクラスを使用すると、Installutil.exe ツールにより、プログラムを NT サービスとしてインストールできます。サービス実装クラス `WcfCalculatorService` は、基本的なサービス コントラクトを実装する [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスです。この [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスは、`WindowsCalculatorService` と呼ばれる Windows サービス クラス内でホストされます。Windows サービスとして限定するため、このクラスは <xref:System.ServiceProcess.ServiceBase> を継承し、[OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> メソッドと <xref:System.ServiceProcess.ServiceBase.OnStop> メソッドを実装しています。[OnStart\(String\<xref:System.ServiceProcess.ServiceBase.OnStart%28System.String%5B%5D%29> では、`WcfCalculatorService` 型の <xref:System.ServiceModel.ServiceHost> オブジェクトが作成され、開かれます。<xref:System.ServiceProcess.ServiceBase.OnStop> では、<xref:System.ServiceModel.ServiceHost> オブジェクトの <xref:System.ServiceModel.Channels.CommunicationObject.Close%28System.TimeSpan%29> メソッドが呼び出されて ServiceHost が閉じられます。このホストのベース アドレスは、[\<add\>](../../../../docs/framework/configure-apps/file-schema/wcf/add-of-baseaddresses.md) 要素を使用して構成されます。この要素は [\<baseAddresses\>](../../../../docs/framework/configure-apps/file-schema/wcf/baseaddresses.md) の子で、これは [\<host\>](../../../../docs/framework/configure-apps/file-schema/wcf/host.md) 要素の子です。さらに、その親は [\<service\>](../../../../docs/framework/configure-apps/file-schema/wcf/service.md) 要素です。  
+  
+ 定義されるエンドポイントは、ベース アドレスおよび [\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) を使用します。ベース アドレスの構成と CalculatorService を公開するエンドポイントのサンプルを次に示します。  
+  
+```  
+<services>  
+  <service name="Microsoft.ServiceModel.Samples.WcfCalculatorService"  
+           behaviorConfiguration="CalculatorServiceBehavior">  
+    <host>  
+      <baseAddresses>  
+        <add baseAddress="http://localhost:8000/ServiceModelSamples/service"/>  
+      </baseAddresses>  
+    </host>  
+    <!-- This endpoint is exposed at the base address provided by host: http://localhost:8000/ServiceModelSamples/service.  -->  
+    <endpoint address=""  
+              binding="wsHttpBinding"  
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+    ...  
+  </service>  
+</services>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求と応答がサービスとクライアントの両方のコンソール ウィンドウに表示されます。どちらかのコンソールで Enter キーを押すと、サービスとクライアントがどちらもシャットダウンされます。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  ソリューションがビルドされたら、権限のレベルが高い [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから Setup.bat を実行し、Installutil.exe ツールを使用して Windows サービスをインストールしてください。このサービスは、\[サービス\] に表示されます。  
+  
+4.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wmi-provider.md b/docs/framework/wcf/samples/wmi-provider.md
new file mode 100644
index 00000000000..2c1eb1d72bf
--- /dev/null
+++ b/docs/framework/wcf/samples/wmi-provider.md
@@ -0,0 +1,158 @@
+---
+title: "WMI プロバイダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 462f0db3-f4a4-4a4b-ac26-41fc25c670a4
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# WMI プロバイダー
+このサンプルでは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] に組み込まれている Windows Management Instrumentation \(WMI\) プロバイダーを使用して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスのデータを実行時に収集する方法を示します。  また、このサンプルでは、ユーザー定義の WMI オブジェクトをサービスに追加する方法も示します。  このサンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」用に WMI プロバイダーをアクティブにし、`ICalculator` サービスのデータを実行時に収集する方法を示します。  
+  
+ WMI は、Web ベースのエンタープライズ管理 \(WBEM\) 標準をマイクロソフトが実装したものです。  WMI SDK の詳細については、MSDN ライブラリを参照してください。  \(http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/wmisdk\/wmi\/wmi\_start\_page.asp\)  WBEM は、アプリケーションが Management Instrumentation を外部管理ツールに開示する業界標準の方法です。  
+  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は WMI プロバイダーを実装しています。これは、WBEAM と互換性のあるインターフェイスを通して実行時にインストルメンテーションを公開するコンポーネントです。  管理ツールは、実行時にインターフェイスを介してサービスに接続できます。  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] は、アドレス、バインディング、動作、リスナーなどのサービスの属性を公開します。  
+  
+ 組み込みの WMI プロバイダーは、アプリケーションの構成ファイルでアクティブにされます。  次のサンプル構成に示すように、これは [\<system.serviceModel\>](../../../../docs/framework/configure-apps/file-schema/wcf/system-servicemodel.md)セクションにある [\<diagnostics\>](../../../../docs/framework/configure-apps/file-schema/wcf/diagnostics.md)の `wmiProviderEnabled` 属性を介して実行されます。  
+  
+```  
+<system.serviceModel>  
+    ...  
+    <diagnostics wmiProviderEnabled="true" />  
+    ...  
+</system.serviceModel>  
+  
+```  
+  
+ この構成エントリには、WMI インターフェイスが開示されます。  管理アプリケーションはこのインターフェイスを通して接続し、アプリケーションの Management Instrumentation にアクセスできるようになります。  
+  
+## カスタム WMI オブジェクト  
+ WMI オブジェクトをサービスに追加すると、組み込みの WMI プロバイダーの情報と共にユーザー定義の情報を開示できます。  これは、Installutil.exe アプリケーションを使用してサービスのスキーマを WMI に公開することによって実現されます。  これを行うための手順および詳細情報は、このトピックの最後のセットアップ手順で示します。  
+  
+## WMI 情報へのアクセス  
+ WMI データには、複数の異なる方法でアクセスできます。  マイクロソフトは、スクリプト用、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] アプリケーション用、C\+\+ アプリケーション用、および [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 用の WMI API を提供しています \(http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/wmisdk\/wmi\/using\_wmi.asp\)。  
+  
+ このサンプルでは、2 つの Java スクリプトを使用します。1 つ目は、コンピューター上で実行されているサービスとその一部のプロパティを列挙するスクリプトで、2 つ目はユーザー定義の WMI データを表示するスクリプトです。  スクリプトは、WMI プロバイダーへの接続を開き、データを解析し、収集されたデータを表示します。  
+  
+ サンプルを開始して、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスの実行中インスタンスを作成します。  サービスの実行中は、コマンド プロンプトで次のコマンドを入力することによって、それぞれの Java スクリプトを実行してください。  
+  
+```  
+cscript EnumerateServices.js  
+  
+```  
+  
+ スクリプトは、サービスに含まれているインストルメンテーションにアクセスし、次の出力を生成します。  
+  
+```  
+Microsoft (R) Windows Script Host Version 5.6  
+Copyright © Microsoft Corporation 1996-2001. All rights reserved.  
+  
+1 service(s) found.  
+|-PID:           5776  
+|-DistinguishedName:  CalculatorService@http://localhost/ServiceModelSamples/service.svc  
+|-Endpoints:     1 endpoints  
+  |-CalculatorService.ICalculator@http://localhost/ServiceModelSamples/service.svc  
+    |-Address:                        http://localhost/ServiceModelSamples/service.svc  
+    |-CounterInstanceName:  
+    |-AddressHeaders:                 0  
+    |-ContractType:                   Contract.Name='ICalculator'  
+    |-BindingElements:                4 bindings  
+      |-BindingElements[0]  
+        |-Type:                       TransactionFlowBindingElement  
+      |-BindingElements[1]  
+        |-Type:                       SymmetricSecurityBindingElement  
+      |-BindingElements[2]  
+        |-Type:                       TextMessageEncodingBindingElement  
+        |-MaxReadPoolSize:            64  
+        |-MaxWritePoolSize:           16  
+      |-BindingElements[3]  
+        |-Type:                       HttpTransportBindingElement  
+        |-ManualAddressing:           false  
+        |-MaxBufferSize:              65536  
+        |-AllowCookies:               false  
+        |-AuthenticationScheme:       Anonymous  
+        |-BypassProxyOnLocal:         false  
+        |-HostNameComparisonMode:     StrongWildcard  
+        |-ProxyAddress:               null  
+        |-ProxyAuthenticationScheme:  Anonymous  
+        |-Realm:  
+        |-TransferMode:               Buffered  
+        |-UseDefaultWebProxy:         true  
+|-Behaviors:     5 behaviors  
+      |-Behavior[0]  
+      |-Type:                       ServiceBehaviorAttribute  
+        |-AddressFilterMode:               Exact  
+        |-AutomaticSessionShutdown:        true  
+        |-ConcurrencyMode:                 Single  
+        |-IncludeExceptionDetailInFaults:  false  
+        |-InstanceContextMode:             PerSession  
+        |-TransactionIsolationLevel:       Unspecified  
+        |-TransactionTimeout:              null  
+        |-ValidateMustUnderstand:          true  
+      |-Behavior[1]  
+      |-Type:                       AspNetCompatibilityRequirementsAttribute  
+      |-Behavior[2]  
+      |-Type:                       ServiceDebugBehavior  
+      |-Behavior[3]  
+      |-Type:                       ServiceAuthorizationBehavior  
+      |-Behavior[4]  
+      |-Type:                       Behavior  
+```  
+  
+ 次に、2 つ目の Java スクリプトを実行して、ユーザー定義の WMI データを表示します。  
+  
+```  
+cscript EnumerateCustomObjects.js  
+```  
+  
+ スクリプトは、サービスに含まれているユーザー定義のインストルメンテーションにアクセスし、次の出力を生成します。  
+  
+```  
+  
+1 WMIObject(s) found.  
+|-PID:           30285bfd-9d66-4c4e-9be2-310499c5cef5  
+|-InstanceId:    3839  
+|-WMIInfo:       User Defined WMI Information.  
+  
+```  
+  
+ この出力は、コンピューター上で 1 つのサービスが実行中であることを示しています。  サービスは、`ICalculator` コントラクトを実装する 1 つのエンドポイントを公開します。  このエンドポイントによって実装されている動作とバインディングの設定は、メッセージ スタックの個々の要素の合計として表示されます。  
+  
+ WMI は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] インフラストラクチャの Management Instrumentation を公開するだけではありません。  独自のドメイン固有のデータ アイテムを、同じ機構を使用して公開できます。  WMI は、Web サービスの検査と制御のための統一された機構です。  
+  
+#### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」を実行したことを確認します。  
+  
+2.  C\# や Visual Basic .NET バージョンのソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  サービス スキーマを WMI に公開します。これを行うには、ホスト ディレクトリ内の service.dll ファイルに対して、InstallUtil.exe \(既定の場所は "%WINDIR%\\Microsoft.NET\\Framework\\v4.0.30319"\) を実行します。  この手順を実行する必要があるのは、service.dll ファイルを変更した場合のみです。  詳細については、「アプリケーションのインストルメント化による管理情報の提供」\(http:\/\/msdn2.microsoft.com\/library\/ms186147.aspx\) の「方法 : インストルメント化されたアプリケーションの WMI にスキーマを公開する」セクションを参照してください。  
+  
+4.  単一コンピューター構成または複数コンピューター構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  ASP.NET のインストール後に [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] をインストールした場合は、"%WINDIR%\\Microsoft.Net\\Framework\\v3.0\\Windows Communication Foundation\\servicemodelreg.exe " \-r \-x を実行し、ASPNET アカウントに WMI オブジェクトを公開する権限を付与する必要がある場合があります。  
+  
+5.  コマンド `cscript EnumerateServices.js` または `cscript EnumerateCustomObjects.js` を使用して、WMI を通じて示されるサンプルのデータを表示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Management\WMIProvider`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/workflow-discovery-sample.md b/docs/framework/wcf/samples/workflow-discovery-sample.md
new file mode 100644
index 00000000000..aacfd5dafda
--- /dev/null
+++ b/docs/framework/wcf/samples/workflow-discovery-sample.md
@@ -0,0 +1,41 @@
+---
+title: "ワークフローの探索のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82cc43f1-3c8f-4771-ac19-a75ac936e2c3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ワークフローの探索のサンプル
+このサンプルでは、ワークフロー サービスを探索可能にする方法と、特定のサービスを検索するカスタム コード アクティビティを作成する方法を示します。  
+  
+## 使用例  
+ 探索検索アクティビティとワークフローの使用方法  
+  
+## 説明  
+ サンプルの最初の部分では、構成を使用してワークフロー サービスを探索可能にしています。また、カスタム メタデータ \(スコープなど\) と共に構成を使用すると、サービスを適切に適用することができます。このサンプルは、クライアントでカスタム コード アクティビティを使用します。カスタム コード アクティビティは、探索を使用して、特定のコントラクトに一致するサービスを検索します。コード アクティビティは URI を出力します。この URI は、後で送信アクティビティで使用されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルでは HTTP エンドポイントを使用します。サンプルを実行するには、HTTP エンドポイントに適切な URL ACL が設定されている必要があります \(詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照してください\)。権限のレベルが高いコマンド プロンプトで次のコマンドを実行すると、適切な ACL が追加されます。使用中のシェルで変数の形式を使用できない場合は、代わりに、ドメインとユーザー名を引数に指定してください。  
+  
+     **netsh http add urlacl url\=http:\/\/\+:8000\/ user\=%DOMAIN%\\%UserName%**  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\WorkflowDiscovery`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-2007-federation-http-binding.md b/docs/framework/wcf/samples/ws-2007-federation-http-binding.md
new file mode 100644
index 00000000000..dd7bdad2c97
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-2007-federation-http-binding.md
@@ -0,0 +1,144 @@
+---
+title: "WS 2007 フェデレーション HTTP バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 91c1b477-a96e-4bf5-9330-5e9312113371
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# WS 2007 フェデレーション HTTP バインディング
+このサンプルでは、<xref:System.ServiceModel.WS2007FederationHttpBinding> の使用例を示します。これは、WS\-Trust 仕様のバージョン 1.3 に対応したフェデレーション シナリオを構築するための標準のバインディングです。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、コンソール ベースのプログラム \(Client.exe\)、コンソール ベースのセキュリティ トークン サービス プログラム \(Securitytokenservice.exe\)、およびコンソール ベースのサービス プログラム \(Service.exe\) で構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(`Add`、`Subtract`、`Multiply`、`Divide`\) を公開しています。クライアントは、セキュリティ トークンをセキュリティ トークン サービス \(STS\) から取得し、指定された算術演算を実行する同期要求をサービスに対して行います。サービスが応答し、結果を返します。クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+ このサンプルは、`ws2007FederationHttpBinding` 要素を使用して `ICalculator` コントラクトを利用できるようにします。このバインディングのクライアント側の構成は、次のコードに示すとおりです。  
+  
+```  
+<bindings>  
+  <ws2007FederationHttpBinding>  
+    <binding name="ServiceFed" >  
+      <security mode ="Message">  
+        <message issuedKeyType ="SymmetricKey"  
+                 issuedTokenType ="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1" >  
+          <!-- Endpoint address and binding for Security Token Service -->  
+          <issuer address ="http://localhost:8000/sts/windows"   
+                  binding ="ws2007HttpBinding" />                
+        </message>  
+      </security>  
+    </binding>  
+  </ws2007FederationHttpBinding>  
+</bindings>  
+  
+```  
+  
+ [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md)では、使用するセキュリティ モードが `security` 値によって指定されます。このサンプルでは、`message` セキュリティが使用されており、このため [\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md)が [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md)の内側で指定されています。[\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md)の内側にある [\<issuer\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuer.md) 要素は、セキュリティ トークンをクライアントに発行する STS のアドレスとバインディングを指定します。これにより、クライアントが `ICalculator` サービスに認証されるようになります。  
+  
+ このバインディングのサービス側の構成は、次のコードに示すとおりです。  
+  
+```  
+<bindings>  
+  <ws2007FederationHttpBinding>  
+    <binding name="ServiceFed" >  
+      <security mode ="Message">  
+        <message issuedKeyType ="SymmetricKey"  
+                 issuedTokenType ="http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1" >  
+          <!-- Metadata address for Security Token Service -->  
+          <issuerMetadata address ="http://localhost:8000/sts/mex" >  
+            <identity>  
+              <certificateReference storeLocation ="CurrentUser"   
+                                    storeName="TrustedPeople"   
+                                    x509FindType ="FindBySubjectDistinguishedName"   
+                                    findValue ="CN=STS" />  
+            </identity>  
+          </issuerMetadata>  
+        </message>  
+      </security>  
+    </binding>  
+  </ws2007FederationHttpBinding>  
+</bindings>  
+  
+```  
+  
+ [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md)では、使用するセキュリティ モードが `security` 値によって指定されます。このサンプルでは、`message` セキュリティが使用されており、このため [\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md)が [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-element-of-ws2007federationhttpbinding.md)の内側で指定されています。[\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-element-of-ws2007federationhttpbinding.md)の内側にある `ws2007FederationHttpBinding` の [\<issuerMetadata\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuermetadata.md) 要素は、STS のメタデータ取得に使用できるエンドポイントのアドレスと ID を指定します。  
+  
+ このサービスの動作を次のコードに示します。  
+  
+```  
+<behaviors>  
+  <serviceBehaviors>  
+    <behavior name ="ServiceBehaviour" >  
+      <serviceDebug includeExceptionDetailInFaults ="true"/>  
+      <serviceMetadata httpGetEnabled ="true"/>  
+      <serviceCredentials>  
+        <issuedTokenAuthentication>  
+          <knownCertificates>  
+            <add storeLocation ="LocalMachine"  
+                 storeName="TrustedPeople"  
+                 x509FindType="FindBySubjectDistinguishedName"  
+                 findValue="CN=STS" />  
+          </knownCertificates>  
+        </issuedTokenAuthentication>  
+        <serviceCertificate storeLocation ="LocalMachine"  
+                            storeName ="My"  
+                            x509FindType ="FindBySubjectDistinguishedName"  
+                            findValue ="CN=localhost"/>  
+      </serviceCredentials>  
+    </behavior>  
+  </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ [\<issuedTokenAuthentication\>](../../../../docs/framework/configure-apps/file-schema/wcf/issuedtokenauthentication-of-servicecredentials.md)\> を使用すると、サービスは、認証時にクライアントが提示できるトークンに関する制約を指定できます。この構成の指定では、サブジェクト名が CN\=STS である証明書によって署名されたトークンがサービスによって受け入れられます。  
+  
+ STS は、標準の <xref:System.ServiceModel.WS2007HttpBinding> を使用して、単一のエンドポイントを利用できるようにします。このサービスは、クライアントからのトークンの要求に応答し、クライアントが Windows アカウントを使用して認証されている場合は、クライアントのユーザー名がクレームとして含まれているトークンを発行します。STS は、トークン作成の一環として、CN\=STS 証明書に関連付けられている秘密キーを使用して、トークンに署名します。また、対称キーを作成し、CN\=localhost 証明書に関連付けられている秘密キーを使用して暗号化します。STS は、トークンをクライアントに返すときに、対称キーも返します。クライアントは、発行されたトークンを `ICalculator` サービスに提示し、対称キーを使用してメッセージに署名することで対称キーを認識していることを証明します。  
+  
+ サンプルを実行すると、セキュリティ トークン要求が STS のコンソール ウィンドウに表示されます。操作要求と応答は、クライアントとサービスのコンソール ウィンドウに表示されます。いずれかのコンソール ウィンドウで Enter キーを押すと、アプリケーションがシャットダウンします。  
+  
+ `Add(100,15.99) = 115.99`  
+  
+ `Subtract(145,76.54) = 68.46`  
+  
+ `Multiply(9,81.25) = 731.25`  
+  
+ `Divide(22,7) = 3.14285714285714`  
+  
+ `Press <ENTER> to terminate client.`  
+  
+ このサンプルに用意されている Setup.bat ファイルを使用すると、適切な証明書を使用してサーバーと STS を構成し、自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルにより、LocalMachine\/TrustedPeople 証明書ストアに 2 つの証明書が作成されます。片方の証明書は CN\=STS のサブジェクト名を持ち、クライアントに発行するセキュリティ トークンを署名するために STS が使用します。もう片方の証明書は CN\=localhost のサブジェクト名を持ち、サービスが暗号化を解除できるようにシークレットを暗号化するために STS が使用します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  管理特権を使用して Visual Studio コマンド プロンプトを開き、Setup.bat ファイルを実行して必要な証明書を作成します。  
+  
+ このバッチ ファイルでは、Windows SDK と共に配布される Certmgr.exe および Makecert.exe が使用されます。ただし、スクリプトでこれらのツールを見つけるには、Visual Studio のコマンド プロンプト内から Setup.bat を実行する必要があります。  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  サンプルを単一コンピューター構成または複数コンピューター構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。[!INCLUDE[windowsver](../../../../includes/windowsver-md.md)] を使用している場合は、Service.exe、Client.exe、および SecurityTokenService.exe をシステム特権で実行する必要があります \(ファイルを右クリックして、**\[管理者として実行\]** をクリックします\)。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\WS2007FederationHttp`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-binding.md b/docs/framework/wcf/samples/ws-binding.md
new file mode 100644
index 00000000000..7eaa822efd2
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-binding.md
@@ -0,0 +1,48 @@
+---
+title: "WS バインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 629945b2-d771-46d7-a87b-5df3b2e460da
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WS バインディング
+このセクションには、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] での Windows サービスのバインディングを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [WS トランザクション フロー](../../../../docs/framework/wcf/samples/ws-transaction-flow.md)  
+ クライアントによって調整されるトランザクションの使用方法と、WS\-AtomicTransaction プロトコルまたは OleTransactions プロトコルを使用するトランザクション フローに関するクライアントとサーバーのオプションの使用方法を示します。  
+  
+ [WS 2007 フェデレーション HTTP バインディング](../../../../docs/framework/wcf/samples/ws-2007-federation-http-binding.md)  
+ <xref:System.ServiceModel.WS2007FederationHttpBinding> の使用方法を示します。  
+  
+ [WS デュアル Http](../../../../docs/framework/wcf/samples/ws-dual-http.md)  
+ `WSDualHttpBinding` バインディングを構成する方法を示します。  
+  
+ [MTOM エンコーディング](../../../../docs/framework/wcf/samples/mtom-encoding.md)  
+ WSHttpBinding で Message Transmission Optimization Mechanism \(MTOM\) メッセージ エンコーディングを使用する方法を示します。  
+  
+ [WSHttpBinding](../../../../docs/framework/wcf/samples/wshttpbinding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] を使用して、一般的なサービスと一般的なクライアントを実装する方法を示します。  
+  
+ [WS 信頼できるセッション](../../../../docs/framework/wcf/samples/ws-reliable-session.md)  
+ 信頼できるセッションの使用方法を示します。  
+  
+ [WS トランスポート セキュリティ](../../../../docs/framework/wcf/samples/ws-transport-security.md)  
+ <xref:System.ServiceModel.WSHttpBinding> バインディングを使用した SSL トランスポート セキュリティの使用方法を示します。  
+  
+ [メッセージ セキュリティ バインディング](../../../../docs/framework/wcf/samples/message-security-binding.md)  
+ [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] のメッセージ セキュリティを使用して示します。  
+  
+ [メッセージ資格情報付き WS トランスポート](../../../../docs/framework/wcf/samples/ws-transport-with-message-credential.md)  
+ このサンプルでは、メッセージに含まれるクライアント資格情報と組み合わせて SSL トランスポート セキュリティを使用する例を示します。
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-dual-http.md b/docs/framework/wcf/samples/ws-dual-http.md
new file mode 100644
index 00000000000..893f93123f7
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-dual-http.md
@@ -0,0 +1,116 @@
+---
+title: "WS デュアル Http | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9997eba5-29ec-48db-86f3-fa77b241fb1a
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# WS デュアル Http
+デュアル Http サンプルでは、`WSDualHttpBinding` バインディングを構成する方法を示します。このサンプルは、クライアント コンソール プログラム \(.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリ \(.dll\) で構成されています。サービスは、双方向コントラクトを実装します。このコントラクトは `ICalculatorDuplex` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および 除算\) を公開しています。このサンプルでは、`ICalculatorDuplex` インターフェイスを使用することにより、クライアントは算術演算を実行し、セッション経由で実行結果を計算できます。サービスは、`ICalculatorDuplexCallback` インターフェイスで結果を個別に返します。コンテキストを確立して、クライアントとサービスの間で送信される一連のメッセージを相互に関連付ける必要があるため、双方向コントラクトにはセッションが必要です。`WSDualHttpBinding` バインディングは双方向通信をサポートしています。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\DualHttp`  
+  
+ `WSDualHttpBinding` を使用してサービス エンドポイントを構成するには、次に示すように、エンドポイント構成でバインディングを指定します。  
+  
+```  
+<endpoint address=""  
+         binding="wsDualHttpBinding"  
+         contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />  
+```  
+  
+ クライアントで、サーバーがクライアントへの接続に使用するアドレスを構成する必要があります。次のサンプル構成を参照してください。  
+  
+```  
+<system.serviceModel>  
+  <client>  
+    <endpoint address=  
+         "http://localhost/servicemodelsamples/service.svc"   
+         binding="wsDualHttpBinding"   
+         bindingConfiguration="Binding1"   
+         contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />  
+  </client>  
+  
+  <bindings>  
+    <!-- Configure a WSDualHttpBinding that supports duplex -->  
+    <!-- communication. -->  
+    <wsDualHttpBinding>  
+      <binding name="Binding1"  
+               clientBaseAddress="http://localhost:8000/myClient/"  
+               useDefaultWebProxy="true"  
+               bypassProxyOnLocal="false">  
+      </binding>  
+    </wsDualHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Press <ENTER> to terminate client once the output is displayed.  
+  
+Result(100)  
+Result(50)  
+Result(882.5)  
+Result(441.25)  
+Equation(0 + 100 - 50 * 17.65 / 2 = 441.25)  
+  
+```  
+  
+ サンプルを実行すると、クライアントに戻ってきたメッセージがサービスから送信されたコールバック インターフェイスに表示されます。それぞれの中間結果が表示され、その後にすべての操作が完了したときの数式全体が表示されます。Enter キーを押してクライアントをシャットダウンします。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  サンプルを単一コンピュータ構成または複数コンピュータ構成で実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!IMPORTANT]
+    >  複数コンピュータ構成でクライアントを実行する場合は、[\<wsDualHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md) 要素で、[endpoint](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017)要素の `address` 属性と、[\<binding\>](../../../../docs/framework/misc/binding.md)要素の `clientBaseAddress` 属性の両方に含まれる localhost を、アプリケーション コンピュータの名前に置き換える必要があります。次を参照してください。  
+  
+    ```  
+    <client>  
+        <endpoint name = ""  
+          address=  
+         "http://service_machine_name/servicemodelsamples/service.svc"  
+        />  
+    </client>  
+    ...  
+    <wsDualHttpBinding>  
+        <binding name="DuplexBinding" clientBaseAddress=  
+            "http://client_machine_name:8000/myClient/">  
+        </binding>  
+    </wsDualHttpBinding>  
+    ```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-reliable-session.md b/docs/framework/wcf/samples/ws-reliable-session.md
new file mode 100644
index 00000000000..5eaec00c69a
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-reliable-session.md
@@ -0,0 +1,102 @@
+---
+title: "WS 信頼できるセッション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "信頼できるセッション"
+ms.assetid: 86e914f2-060b-432b-bd17-333695317745
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# WS 信頼できるセッション
+このサンプルでは、信頼できるセッションの使用方法を示します。信頼できるセッションは、信頼できるメッセージとセッションをサポートします。信頼できるメッセージは、エラー時に通信を再試行するほか、メッセージの順次到着などの配信の保証を指定できるようにします。セッションでは、呼び出し間でクライアントの状態が保持されます。サンプルでは、クライアントの状態を保持するセッションを実装し、配信順序を保証することを指定します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\wsReliableSession`  
+  
+ このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。信頼できるセッション機能は、クライアントとサービスのアプリケーション構成ファイルで有効化され、構成されています。  
+  
+ このサンプルでは、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされており、クライアントはコンソール アプリケーション \(.exe\) です。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルでは、`wsHttpBinding` を使用しています。バインディングは、クライアントとサービスの両方の構成ファイルに指定されます。バインディングの種類はエンドポイント要素の `binding` 属性に指定します。次のサンプル構成を参照してください。  
+  
+```  
+<endpoint address=""  
+          binding="wsHttpBinding"  
+          bindingConfiguration="Binding1"   
+          contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  
+```  
+  
+ エンドポイントには、"Binding1" という名前のバインディング構成を参照する `bindingConfiguration` 属性が含まれます。このバインディング構成は、[\<reliableSession\>](../../../../docs/framework/configure-apps/file-schema/wcf/reliablesession.md)の `enabled` 属性を `true` に設定することによって、信頼できるセッションを有効にします。順序付きセッションの配信の保証は、ordered 属性を `true` または `false` に設定することによって制御されます。既定値は `true` です。  
+  
+```  
+<bindings>  
+    <wsHttpBinding>  
+        <binding name="Binding1">  
+            <reliableSession enabled="true" />  
+        </binding>  
+    </wsHttpBinding>  
+</bindings>  
+  
+```  
+  
+ サービス実装クラスは、クライアントごとに個別のクラスのインスタンスをインスタンス化して保持する <xref:System.ServiceModel.InstanceContextMode> を実装します。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)] public class CalculatorService : ICalculator  
+{  
+    ...  
+}  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-transaction-flow.md b/docs/framework/wcf/samples/ws-transaction-flow.md
new file mode 100644
index 00000000000..0b422685261
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-transaction-flow.md
@@ -0,0 +1,303 @@
+---
+title: "WS トランザクション フロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "トランザクション"
+ms.assetid: f8eecbcf-990a-4dbb-b29b-c3f9e3b396bd
+caps.latest.revision: 43
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 43
+---
+# WS トランザクション フロー
+このサンプルでは、クライアントによって調整されるトランザクションの使用方法と、WS\-AtomicTransaction プロトコルまたは OleTransactions プロトコルを使用するトランザクション フローに関するクライアントとサーバーのオプションの使用方法を示します。  このサンプルは、電卓サービスを実装する[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)に基づいていますが、これらの操作は、どの程度のトランザクション フローが可能かを `TransactionFlowAttribute` および **TransactionFlowOption** 列挙体を使用して設定する方法を示すためのものです。  フローされたトランザクションのスコープ内では、要求された操作のログがデータベースに書き込まれ、クライアント調整トランザクションが完了するまで保持されます。クライアント トランザクションが完了しない場合は、データベースに対する該当する更新はコミットされません。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サービスとトランザクションへの接続を開始した後で、クライアントは複数のサービス操作にアクセスします。  サービスのコントラクトは次のように定義されています。操作はそれぞれ、`TransactionFlowOption` の設定が異なります。  
+  
+```  
+[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Mandatory)]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.Allowed)]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    [TransactionFlow(TransactionFlowOption.NotAllowed)]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);   
+}  
+  
+```  
+  
+ 操作は、処理される順に次のように定義されています。  
+  
+-   `Add` \(加算\) 操作要求には、フローされたトランザクションが含まれている必要があります。  
+  
+-   `Subtract` \(減算\) 操作要求には、フローされたトランザクションが含まれていてもかまいません。  
+  
+-   `Multiply` \(乗算\) 操作要求には、フローされたトランザクションが含まれてはならないことが、明示的な NotAllowed 設定で指定されています。  
+  
+-   `Divide` \(除算\) 操作要求には、フローされたトランザクションが含まれてはならないことが、`TransactionFlow` 属性の省略によって指定されています。  
+  
+ トランザクション フローを有効にするには、適切な操作の属性に加えて、使用するバインディングで [\<transactionFlow\>](../../../../docs/framework/configure-apps/file-schema/wcf/transactionflow.md) プロパティが有効化されている必要があります。  このサンプルでは、サービスの構成は Metadata Exchange エンドポイントのほかに TCP エンドポイントと HTTP エンドポイントを公開します。  TCP エンドポイントと HTTP エンドポイントは、次のバインディングを使用します。どちらのバインディングでも [\<transactionFlow\>](../../../../docs/framework/configure-apps/file-schema/wcf/transactionflow.md) プロパティは有効です。  
+  
+```  
+<bindings>  
+  <netTcpBinding>  
+    <binding name="transactionalOleTransactionsTcpBinding"  
+             transactionFlow="true"  
+             transactionProtocol="OleTransactions"/>  
+  </netTcpBinding>  
+  <wsHttpBinding>  
+    <binding name="transactionalWsatHttpBinding"  
+             transactionFlow="true" />  
+  </wsHttpBinding>  
+</bindings>  
+```  
+  
+> [!NOTE]
+>  システムで提供される netTcpBinding では transactionProtocol を指定できるのに対し、システムで提供される wsHttpBinding では、相互運用性に優れた WSAtomicTransactionOctober2004 プロトコルのみが使用されます。  OleTransactions プロトコルは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントで使用する場合にのみ利用できます。  
+  
+ `ICalculator` インターフェイスを実装するクラスでは、すべてのメソッドの属性で <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> プロパティが `true` に設定されています。  この設定は、メソッド内で実行されるすべてのアクションがトランザクションのスコープ内で実行されることを宣言するものです。  この場合、実行されるアクションには、ログ データベースへの記録が含まれます。  操作要求の中に、フローされたトランザクションが含まれている場合は、受信トランザクションのスコープ内でアクションが実行されるか、新しいトランザクションが自動生成されます。  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> プロパティは、サービス メソッド実装固有の動作を定義しますが、トランザクションをフローさせるためのクライアントの機能や要件は定義しません。  
+  
+```  
+// Service class that implements the service contract.  
+[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]  
+public class CalculatorService : ICalculator  
+{  
+    [OperationBehavior(TransactionScopeRequired = true)]  
+    public double Add(double n1, double n2)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Adding {0} to {1}", n1, n2));  
+        return n1 + n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true)]  
+    public double Subtract(double n1, double n2)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Subtracting {0} from {1}", n2, n1));  
+        return n1 - n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true)]  
+    public double Multiply(double n1, double n2)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Multiplying {0} by {1}", n1, n2));  
+        return n1 * n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true)]  
+    public double Divide(double n1, double n2)  
+    {  
+        RecordToLog(String.Format(CultureInfo.CurrentCulture, "Dividing {0} by {1}", n1, n2));  
+        return n1 / n2;  
+    }  
+  
+    // Logging method omitted for brevity  
+}  
+```  
+  
+ クライアントでは、操作に対するサービスの `TransactionFlowOption` 設定が、クライアントで生成される `ICalculator` インターフェイスの定義に反映されます。  さらに、サービスの `transactionFlow` プロパティの設定はクライアントのアプリケーション構成に反映されます。  クライアントでは、適切な `endpointConfigurationName` を選択することによってトランスポートとプロトコルを選択できます。  
+  
+```  
+// Create a client using either wsat or oletx endpoint configurations  
+CalculatorClient client = new CalculatorClient("WSAtomicTransaction_endpoint");  
+// CalculatorClient client = new CalculatorClient("OleTransactions_endpoint");  
+  
+```  
+  
+> [!NOTE]
+>  このサンプルを実行したときの動作は、選択したプロトコルとトランスポートの種類にかかわらず同一です。  
+  
+ サービスへの接続を開始した後で、クライアントは次のように、サービス操作の呼び出しを囲む新しい `TransactionScope` を作成します。  
+  
+```  
+// Start a transaction scope  
+using (TransactionScope tx =  
+            new TransactionScope(TransactionScopeOption.RequiresNew))  
+{  
+    Console.WriteLine("Starting transaction");  
+  
+    // Call the Add service operation  
+    //  - generatedClient will flow the required active transaction  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = client.Add(value1, value2);  
+    Console.WriteLine("  Add({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Subtract service operation  
+    //  - generatedClient will flow the allowed active transaction  
+    value1 = 145.00D;  
+    value2 = 76.54D;  
+    result = client.Subtract(value1, value2);  
+    Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+    // Start a transaction scope that suppresses the current transaction  
+    using (TransactionScope txSuppress =  
+                new TransactionScope(TransactionScopeOption.Suppress))  
+    {  
+        // Call the Subtract service operation  
+        //  - the active transaction is suppressed from the generatedClient  
+        //    and no transaction will flow  
+        value1 = 21.05D;  
+        value2 = 42.16D;  
+        result = client.Subtract(value1, value2);  
+        Console.WriteLine("  Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+        // Complete the suppressed scope  
+        txSuppress.Complete();  
+    }  
+  
+    // Call the Multiply service operation  
+    // - generatedClient will not flow the active transaction  
+    value1 = 9.00D;  
+    value2 = 81.25D;  
+    result = client.Multiply(value1, value2);  
+    Console.WriteLine("  Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Divide service operation.  
+    // - generatedClient will not flow the active transaction  
+    value1 = 22.00D;  
+    value2 = 7.00D;  
+    result = client.Divide(value1, value2);  
+    Console.WriteLine("  Divide({0},{1}) = {2}", value1, value2, result);  
+  
+    // Complete the transaction scope  
+    Console.WriteLine("  Completing transaction");  
+    tx.Complete();  
+}  
+  
+Console.WriteLine("Transaction committed");  
+  
+```  
+  
+ 操作の呼び出しは次のとおりです。  
+  
+-   `Add` 要求によって、必須のトランザクションがサービスにフローされ、サービスのアクションはクライアントのトランザクション スコープ内で実行されます。  
+  
+-   最初の `Subtract` 要求も、許可されたトランザクションをサービスにフローするので、このときもサービスのアクションはクライアントのトランザクション スコープ内で実行されます。  
+  
+-   2 番目の `Subtract` 要求は、`TransactionScopeOption.Suppress` オプションと共に宣言された新しいトランザクション スコープ内で実行されます。  これによって、クライアントの最初の外側トランザクションが抑制されます。また、新しいトランザクションがサービスにフローされることはありません。  この方法を使用すると、クライアントは、トランザクションをサービスにフローすることが必要ない場合に、このことを行わないように明示的に指定できます。  サービスのアクションは、新しい独立したトランザクションのスコープ内で発生します。  
+  
+-   `Multiply` 要求はトランザクションをサービスにフローしません。クライアントで生成された `ICalculator` インターフェイスの定義には <xref:System.ServiceModel.TransactionFlowOption> `NotAllowed` に設定された <xref:System.ServiceModel.TransactionFlowAttribute> が含まれているためです。  
+  
+-   `Divide` 要求は、トランザクションをサービスにフローしません。同様に、クライアントで生成された `ICalculator` インターフェイスの定義には `TransactionFlowAttribute` が含まれていないためです。  このときも、サービスのアクションは別の新しい独立したトランザクションのスコープ内で実行されます。  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Starting transaction  
+  Add(100,15.99) = 115.99  
+  Subtract(145,76.54) = 68.46  
+  Subtract(21.05,42.16) = -21.11  
+  Multiply(9,81.25) = 731.25  
+  Divide(22,7) = 3.14285714285714  
+  Completing transaction  
+Transaction committed  
+Press <ENTER> to terminate client.  
+```  
+  
+ サービス操作要求のログ記録は、サービスのコンソール ウィンドウに表示されます。  クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Press <ENTER> to terminate the service.  
+  Writing row to database: Adding 100 to 15.99  
+  Writing row to database: Subtracting 76.54 from 145  
+  Writing row to database: Subtracting 42.16 from 21.05  
+  Writing row to database: Multiplying 9 by 81.25  
+  Writing row to database: Dividing 22 by 7  
+```  
+  
+ 実行が正常に終了すると、クライアントのトランザクション スコープが完了し、そのスコープ内で実行されたすべてのアクションがコミットされます。  具体的には、ここに示した 5 レコードがサービスのデータベースに保存されます。  最初の 2 レコードは、クライアントのトランザクションのスコープ内で発生しています。  
+  
+ クライアントの `TransactionScope` 内の場所で例外が発生した場合、トランザクションは完了しません。  その結果、そのスコープ内でログに記録されたレコードはデータベースにコミットされなくなります。  この影響を確認するには、外側の `TransactionScope` を完了させる呼び出しをコメント化した後にサンプルをもう一度実行します。  この実行では、最後の 3 つのアクション \(2 番目の `Subtract` 要求、`Multiply` 要求、`Divide` 要求\) だけがログに記録されます。クライアント トランザクションはこれらのアクションにフローしないためです。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  SQL Server Express Edition または SQL Server がインストールされ、接続文字列が、サービスのアプリケーション構成ファイルで正しく設定されていることを確認します。  データベースを使用せずにサンプルを実行するには、サービスのアプリケーション構成ファイルで `usingSql` の値を `false` に設定します。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+    > [!NOTE]
+    >  複数コンピューター構成の場合は、次の説明に従って分散トランザクション コーディネーターを有効にし、Windows SDK の WsatConfig.exe ツールを使用して WCF トランザクション ネットワークのサポートを有効にします。  WsatConfig.exe のセットアップの詳細については、「[WS\-AtomicTransaction サポートの構成](http://go.microsoft.com/fwlink/?LinkId=190370)」を参照してください。  
+  
+ サンプルを同じコンピューターまたは複数のコンピューターのどちらで実行する場合も、Microsoft 分散トランザクション コーディネーター \(MSDTC\) を構成してネットワーク トランザクション フローを有効にし、WsatConfig.exe ツールを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] トランザクション ネットワーク サポートを有効にする必要があります。  
+  
+### Microsoft 分散トランザクション コーディネーター \(MSDTC\) を構成してサンプルを実行できるようにするには  
+  
+1.  Windows Server 2003 または Windows XP が動作するサービス コンピューターで、次の説明に従い、受信ネットワーク トランザクションを許可するよう MSDTC を構成します。  
+  
+    1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]**、**\[管理ツール\]** の順にポイントして **\[コンポーネント サービス\]** をクリックします。  
+  
+    2.  **\[コンポーネント サービス\]** を展開します。  **\[コンピューター\]** フォルダーを開きます。  
+  
+    3.  **\[マイ コンピューター\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    4.  **\[MSDTC\]** タブの **\[セキュリティの構成\]** をクリックします。  
+  
+    5.  **\[ネットワーク DTC アクセス\]** および **\[受信を許可する\]** のチェック ボックスをオンにします。  
+  
+    6.  **\[OK\]** をクリックし、**\[はい\]** をクリックして、MSDTC サービスを再起動します。  
+  
+    7.  **\[OK\]** をクリックし、ダイアログ ボックスを閉じます。  
+  
+2.  Windows Server 2008 または Windows Vista が動作するサービス コンピューターで、次の説明に従い、受信ネットワーク トランザクションを許可するよう MSDTC を構成します。  
+  
+    1.  **\[スタート\]** ボタンをクリックし、**\[コントロール パネル\]**、**\[管理ツール\]** の順にポイントして **\[コンポーネント サービス\]** をクリックします。  
+  
+    2.  **\[コンポーネント サービス\]** を展開します。  **\[コンピューター\]** フォルダーを開きます。  **\[分散トランザクション コーディネーター\]** をクリックします。  
+  
+    3.  **\[DTC コーディネーター\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    4.  **\[セキュリティ\]** タブで、**\[ネットワーク DTC アクセス\]** チェックボックスと **\[受信を許可する\]** チェック ボックスをオンにします。  
+  
+    5.  **\[OK\]** をクリックし、**\[はい\]** をクリックして、MSDTC サービスを再起動します。  
+  
+    6.  **\[OK\]** をクリックし、ダイアログ ボックスを閉じます。  
+  
+3.  クライアント コンピューターで、送信ネットワーク トランザクションを許可するよう MSDTC を構成します。  
+  
+    1.  **\[スタート\]** メニューから`Control Panel`に移動し、**\[管理ツール\]**、**\[コンポーネント サービス\]** の順に選択します。  
+  
+    2.  **\[マイ コンピューター\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    3.  **\[MSDTC\]** タブの **\[セキュリティの構成\]** をクリックします。  
+  
+    4.  **\[ネットワーク DTC アクセス\]** および **\[送信を許可する\]** のチェック ボックスをオンにします。  
+  
+    5.  **\[OK\]** をクリックし、**\[はい\]** をクリックして、MSDTC サービスを再起動します。  
+  
+    6.  **\[OK\]** をクリックし、ダイアログ ボックスを閉じます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\TransactionFlow`
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-transport-security.md b/docs/framework/wcf/samples/ws-transport-security.md
new file mode 100644
index 00000000000..81959b78ef7
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-transport-security.md
@@ -0,0 +1,98 @@
+---
+title: "WS トランスポート セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 33a20358-5e1b-458a-a6a9-15753bc7b99b
+caps.latest.revision: 22
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 22
+---
+# WS トランスポート セキュリティ
+このサンプルでは、<xref:System.ServiceModel.WSHttpBinding> バインディングを使用した SSL トランスポート セキュリティを示します。既定で、`wsHttpBinding` バインディングは HTTP 通信を実現します。トランスポート セキュリティ用に構成すると、バインディングは HTTPS 通信をサポートします。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。`wsHttpBinding` は、クライアントとサービスのアプリケーション構成ファイルに指定され、構成されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\wsTransportSecurity`  
+  
+ サンプル内のプログラム コードは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」サービスのプログラム コードと同じです。このサンプルをビルドして実行する前に、証明書を作成し、Web サーバー証明書ウィザードを使用してあらかじめ割り当てておく必要があります。次に示すクライアント用構成の例のように、構成ファイル設定でエンドポイントとバインディングを定義すると、`Transport` セキュリティ モードが有効になります。  
+  
+```  
+<system.serviceModel>  
+  
+    <client>  
+      <!-- this endpoint has an https: address -->  
+      <endpoint address="https://localhost/servicemodelsamples/service.svc" binding="wsHttpBinding" bindingConfiguration="Binding1" contract="Microsoft.Samples.TransportSecurity.ICalculator"/>  
+    </client>  
+  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- configure wsHttpbinding with Transport security mode  
+                   and clientCredentialType as None -->  
+        <binding name="Binding1">  
+          <security mode="Transport">  
+            <transport clientCredentialType="None"/>  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+  
+  </system.serviceModel>  
+  
+```  
+  
+ アドレス指定では https:\/\/ スキームを使用しています。このバインディング構成により、セキュリティ モードが `Transport` に設定されます。同じセキュリティ モードが、サービスの Web.config ファイルで指定される必要があります。  
+  
+ このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザで https:\/\/localhost\/servicemodelsamples\/service.svc のような https: アドレスにアクセスしようとするとセキュリティ警告が表示されます。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアントがテスト証明書に対して問題なく動作するようにするには、クライアントにコードを追加して、セキュリティ警告を非表示にする必要があります。そのためのコードとそれに必要なクラスは、本運用の証明書を使用するときには不要です。  
+  
+```  
+// This code is required only for test certificates like those created by Makecert.exe.  
+PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」が実行済みであることを確認します。  
+  
+4.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/ws-transport-with-message-credential.md b/docs/framework/wcf/samples/ws-transport-with-message-credential.md
new file mode 100644
index 00000000000..be9b7f696a3
--- /dev/null
+++ b/docs/framework/wcf/samples/ws-transport-with-message-credential.md
@@ -0,0 +1,108 @@
+---
+title: "メッセージ資格情報付き WS トランスポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d092f3a-b309-439b-920b-66d8f46a0e3c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# メッセージ資格情報付き WS トランスポート
+このサンプルでは、メッセージに含まれるクライアント資格情報と組み合わせて SSL トランスポート セキュリティを使用する例を示します。このサンプルでは、`wsHttpBinding` バインディングを使用します。  
+  
+ 既定で、`wsHttpBinding` バインディングは HTTP 通信を実現します。トランスポート セキュリティ用に構成すると、バインディングは HTTPS 通信をサポートします。HTTPS により、通信回線を介して送信されるメッセージについての機密性および整合性の保護が実現します。ただし、サービスに対するクライアントの認証に使用できる一連の認証機構は、HTTPS トランスポートのサポート範囲に限定されます。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] には、この制限を克服するためにデザインされた、`TransportWithMessageCredential` セキュリティ モードが用意されています。このセキュリティ モードが構成されると、送信メッセージの機密性および整合性を実現してサービス認証を実行する、トランスポート セキュリティが使用されます。ただし、クライアント認証は、クライアント資格情報をメッセージに直接格納することによって実行されます。これにより、トランスポート セキュリティ モードでのパフォーマンス上の利点を保持しながら、クライアント認証のメッセージ セキュリティ モードでサポートされる、任意の資格情報の種類を使用できます。  
+  
+ このサンプルでは、サービスに対するクライアントの認証に `UserName` 資格情報が使用されます。  
+  
+ このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。`wsHttpBinding` バインディングは、クライアントとサービスのアプリケーション構成ファイルに指定され、構成されます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ サンプル内のプログラム コードは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」サービスのプログラム コードとほとんど同じです。`GetCallerIdentity` サービス コントラクトによって追加された操作が 1 つあります。この操作は、呼び出し元の ID の名前を呼び出し元に返します。  
+  
+```  
+public string GetCallerIdentity()  
+{  
+    // Use ServiceSecurityContext.WindowsIdentity to get the name of the caller.  
+    return ServiceSecurityContext.Current.WindowsIdentity.Name;  
+}  
+```  
+  
+ このサンプルをビルドして実行する前に、証明書を作成し、Web サーバー証明書ウィザードを使用してあらかじめ割り当てておく必要があります。次に示すクライアント用構成の例のように、構成ファイル設定でエンドポイントとバインディングを定義すると、`TransportWithMessageCredential` セキュリティ モードが有効になります。  
+  
+```  
+<system.serviceModel>  
+  <client>  
+    <endpoint name=""  
+              address="https://localhost/servicemodelsamples/service.svc"   
+              binding="wsHttpBinding"   
+              bindingConfiguration="Binding1"   
+              contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+  </client>  
+  
+  <bindings>  
+    <wsHttpBinding>  
+      <!--   
+        This configuration defines the security mode as TransportWithMessageCredential.  
+        and the clientCredentialType as UserName.  
+        -->  
+      <binding name="Binding1">  
+        <security mode ="TransportWithMessageCredential">  
+          <message clientCredentialType="UserName" />  
+        </security>  
+      </binding>  
+    </wsHttpBinding>  
+  </bindings>  
+</system.serviceModel>  
+```  
+  
+ アドレス指定では https:\/\/ スキームを使用しています。このバインディング構成により、セキュリティ モードが `TransportWithMessageCredential` に設定されます。同じセキュリティ モードが、サービスの Web.config ファイルで指定される必要があります。  
+  
+ このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザで https:\/\/localhost\/servicemodelsamples\/service.svc のような https: アドレスにアクセスしようとするとセキュリティ警告が表示されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントがテスト証明書に対して問題なく動作するようにするには、クライアントにコードを追加して、セキュリティ警告を非表示にする必要があります。そのためのコードとそれに必要なクラスは、本運用の証明書を使用するときには不要です。  
+  
+```  
+// WARNING: This code is only needed for test certificates such as those created by makecert. It is   
+// not recommended for production code.  
+PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Username authentication required.  
+Provide a valid machine or domain account. [domain\\user]  
+   Enter username:   
+YourDomainName\YourAccountName  
+   Enter password:   
+********  
+YourDomainName\YourAccountName  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルをセットアップしてビルドし、実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wshttpbinding.md b/docs/framework/wcf/samples/wshttpbinding.md
new file mode 100644
index 00000000000..731c6d056ae
--- /dev/null
+++ b/docs/framework/wcf/samples/wshttpbinding.md
@@ -0,0 +1,106 @@
+---
+title: "WSHttpBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WS プロファイル バインディング"
+ms.assetid: 22d85b19-0135-4141-9179-a0e9c343ad73
+caps.latest.revision: 39
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# WSHttpBinding
+このサンプルでは、一般的なサービスと一般的なクライアントを、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] を使用して実装する方法を示します。このサンプルは、クライアント コンソール プログラム \(client.exe\) と、インターネット インフォメーション サービス \(IIS\) によってホストされるサービス ライブラリで構成されています。サービスは、要求\/応答通信パターンを定義するコントラクトを実装します。このコントラクトは `ICalculator` インターフェイスによって定義されており、算術演算 \(加算、減算、乗算、および除算\) を公開しています。クライアントは指定された算術演算を同期要求し、サービスは結果と共に応答します。クライアント アクティビティは、コンソール ウィンドウに表示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Binding\WS\wsHttp`  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ このサンプルは、[\<wsHttpBinding\>](../../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)を使用して `ICalculator` コントラクトを公開します。このバインディングの構成は、次のように Web.config ファイルで展開されています。  
+  
+```  
+<bindings>  
+  <wsHttpBinding>  
+    <!--The following is the expanded configuration section for a-->  
+    <!--WSHttpBinding. Each property is configured with the default-->   
+    <!--value. See the ReliableSession, TransactionFlow, -->  
+    <!--TransportSecurity, and MessageSecurity samples in the WS -->  
+    <!--directory to learn how to configure these features. -->  
+    <binding name="Binding1"  
+              bypassProxyOnLocal="false"   
+              transactionFlow="false"   
+              hostNameComparisonMode="StrongWildcard"  
+              maxBufferPoolSize="524288"   
+              maxReceivedMessageSize="65536"  
+              messageEncoding="Text"   
+              textEncoding="utf-8"   
+              useDefaultWebProxy="true"  
+              allowCookies="false">  
+      <reliableSession ordered="true"   
+                       inactivityTimeout="00:10:00"  
+                       enabled="false" />  
+      <security mode="Message">  
+        <message clientCredentialType="Windows"   
+                 negotiateServiceCredential="true"  
+                 algorithmSuite="Default"   
+                 establishSecurityContext="true" />  
+      </security>  
+    </binding>  
+  </wsHttpBinding>  
+</bindings>  
+```  
+  
+ ベース `binding` 要素で `maxReceivedMessageSize` 値を使用すると、受信メッセージの最大サイズ \(バイト単位\) を構成できます。`hostNameComparisonMode` 値を使用すると、メッセージの非多重化を行ってサービスに変換する際にホスト名を考慮するかどうかを構成できます。`messageEncoding` 値を使用すると、メッセージのテキスト エンコーディングまたは MTOM エンコーディングを使用するかどうかを構成できます。`textEncoding` 値を使用すると、メッセージの文字エンコーディングを構成できます。`bypassProxyOnLocal` 値を使用すると、ローカル通信に HTTP プロキシを使用するかどうかを構成できます。現在のトランザクションをフローするかどうかは、`transactionFlow` 値で構成されます \(操作がトランザクション フロー用に構成されている場合\)。  
+  
+ [\<reliableSession\>](../../../../docs/framework/configure-apps/file-schema/wcf/reliablesession.md) 要素では、信頼できるセッションが有効かどうかは、ブール値 enabled で構成されます。メッセージの順序が保持されるかどうかは、`ordered` 値で構成されます。エラーになる前の、セッションのアイドル状態の期間は、`inactivityTimeout` 値で構成されます。  
+  
+ [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)では、使用するセキュリティ モードは `mode` 値で構成されます。このサンプルでは、メッセージ セキュリティが使用されており、このため [\<message\>](../../../../docs/framework/configure-apps/file-schema/wcf/message-of-wshttpbinding.md)が [\<security\>](../../../../docs/framework/configure-apps/file-schema/wcf/security-of-wshttpbinding.md)の内側で指定されています。  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+3.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+4.  単一コンピュータ構成か複数コンピュータ構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/wsstreamedhttpbinding.md b/docs/framework/wcf/samples/wsstreamedhttpbinding.md
new file mode 100644
index 00000000000..c101a2ffa76
--- /dev/null
+++ b/docs/framework/wcf/samples/wsstreamedhttpbinding.md
@@ -0,0 +1,157 @@
+---
+title: "WSStreamedHttpBinding | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97ce4d3d-ca6f-45fa-b33b-2429bb84e65b
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# WSStreamedHttpBinding
+このサンプルでは、HTTP トランスポート使用時にストリーミングをサポートする目的でデザインされたバインディングを作成する方法を示します。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Extensibility\Binding\WSStreamedHttpBinding`  
+  
+ 新しい標準バインディングを作成して構成する手順は、次のとおりです。  
+  
+1.  新しい標準バインディングを作成する  
+  
+     basicHttpBinding や netTcpBinding などの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] の標準バインディングは、特定の要件に合わせて、基になるトランスポートとチャネル スタックを構成します。このサンプルでは、`WSStreamedHttpBinding` は、ストリーミングをサポートするようチャネル スタックを構成します。既定では、WS\-Security と信頼できるメッセージ機能はチャネル スタックに追加されません。どちらの機能もストリーミングではサポートされないためです。新しいバインディングは、<xref:System.ServiceModel.Channels.Binding> から派生するクラス `WSStreamedHttpBinding` に実装されます。`WSStreamedHttpBinding` には、<xref:System.ServiceModel.Channels.HttpTransportBindingElement>、<xref:System.ServiceModel.Channels.HttpsTransportBindingElement>、<xref:System.ServiceModel.Channels.TransactionFlowBindingElement>、および <xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement> のバインディング要素が含まれます。このクラスは、作成されるバインディング スタックを構成する `CreateBindingElements()` メソッドを提供します。次のサンプル コードを参照してください。  
+  
+    ```  
+    public override BindingElementCollection CreateBindingElements()  
+    {  
+         // return collection of BindingElements  
+         BindingElementCollection bindingElements = new BindingElementCollection();  
+  
+        // the order of binding elements within the collection is important: layered channels are applied in the order included, followed by  
+        // the message encoder, and finally the transport at the end  
+        if (flowTransactions)  
+        {  
+            bindingElements.Add(transactionFlow);  
+        }  
+        bindingElements.Add(textEncoding);  
+  
+        // add transport (http or https)  
+        bindingElements.Add(transport);  
+        return bindingElements.Clone();  
+    }  
+  
+    ```  
+  
+2.  構成サポートを追加する  
+  
+     構成を使用してトランスポートを公開するため、サンプルではさらに、`WSStreamedHttpBindingConfigurationElement` クラスと `WSStreamedHttpBindingSection` クラスという 2 つのクラスを実装します。クラス `WSStreamedHttpBindingSection` は <xref:System.ServiceModel.Configuration.StandardBindingCollectionElement%602> で、`WSStreamedHttpBinding` を [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の構成システムに公開します。実装の大部分は `WSStreamedHttpBindingConfigurationElement` で代行されます。これは <xref:System.ServiceModel.Configuration.StandardBindingElement> の派生です。クラス `WSStreamedHttpBindingConfigurationElement` には `WSStreamedHttpBinding` のプロパティに対応するプロパティがあり、各構成要素をバインディングにマップする関数があります。  
+  
+     次のセクションをサービスの構成ファイルに追加することにより、ハンドラを構成システムに登録します。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <extensions>  
+          <bindingExtensions>  
+            <add name="wsStreamedHttpBinding" type="Microsoft.ServiceModel.Samples.WSStreamedHttpBindingCollectionElement, WSStreamedHttpBinding, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+          </bindingExtensions>  
+        </extensions>  
+      </system.serviceModel>  
+    </configuration>  
+  
+    ```  
+  
+     ハンドラーは serviceModel 構成セクションから参照できます。  
+  
+    ```  
+    <configuration>  
+      <system.serviceModel>  
+        <client>  
+          <endpoint  
+                    address="https://localhost/servicemodelsamples/service.svc"  
+                    bindingConfiguration="Binding"  
+                    binding="wsStreamedHttpBinding"  
+                    contract="Microsoft.ServiceModel.Samples.IStreamedEchoService"/>  
+        </client>  
+      </system.serviceModel>  
+    </configuration>  
+    ```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  次のコマンドを使用して、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] 4.0 をインストールします。  
+  
+    ```  
+    %windir%\Microsoft.NET\Framework\v4.0.XXXXX\aspnet_regiis.exe /i /enable  
+  
+    ```  
+  
+2.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」の手順が実行済みであることを確認します。  
+  
+3.  「[インターネット インフォメーション サービス \(IIS\) サーバー証明書インストール手順](../../../../docs/framework/wcf/samples/iis-server-certificate-installation-instructions.md)」が実行済みであることを確認します。  
+  
+4.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+5.  複数コンピュータ構成でサンプルを実行するには、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+6.  クライアント ウィンドウが表示されたら、「Sample.txt」と入力します。ディレクトリで "Sample.txt のコピー" を検索する必要があります。  
+  
+## WSStreamedHttpBinding サービスのサンプル  
+ `WSStreamedHttpBinding` を使用するサービスのサンプルは、サービス サブディレクトリにあります。`OperationContract` の実装は `MemoryStream` を使用して、最初に受信ストリームからすべてのデータを取得し、その後 `MemoryStream` を返します。このサンプル サービスは、インターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+```  
+[ServiceContract]  
+public interface IStreamedEchoService  
+{  
+    [OperationContract]  
+    Stream Echo(Stream data);  
+}  
+  
+public class StreamedEchoService : IStreamedEchoService  
+{  
+    public Stream Echo(Stream data)  
+    {  
+        MemoryStream dataStorage = new MemoryStream();  
+        byte[] byteArray = new byte[8192];  
+        int bytesRead = data.Read(byteArray, 0, 8192);  
+        while (bytesRead > 0)  
+        {  
+            dataStorage.Write(byteArray, 0, bytesRead);  
+            bytesRead = data.Read(byteArray, 0, 8192);  
+        }  
+        data.Close();  
+        dataStorage.Seek(0, SeekOrigin.Begin);  
+  
+        return dataStorage;  
+    }  
+}  
+  
+```  
+  
+## WSStreamedHttpBinding クライアントのサンプル  
+ `WSStreamedHttpBinding` を使用してサービスとやり取りするクライアントは、クライアント サブディレクトリにあります。このサンプルで使用する証明書は Makecert.exe で作成されたテスト証明書なので、ブラウザで https:\/\/localhost\/servicemodelsamples\/service.svc のような HTTPS アドレスにアクセスしようとするとセキュリティ警告が表示されます。[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントがテスト証明書に対して問題なく動作するようにするには、クライアントにコードを追加して、セキュリティ警告を非表示にする必要があります。そのためのコードとそれに必要なクラスは、本運用の証明書を使用するときには不要です。  
+  
+```  
+// WARNING: This code is only required for test certificates such as those created by makecert. It is   
+// not recommended for production code.  
+PermissiveCertificatePolicy.Enact("CN=ServiceModelSamples-HTTPS-Server");  
+  
+```  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/x-509-certificate-validator.md b/docs/framework/wcf/samples/x-509-certificate-validator.md
new file mode 100644
index 00000000000..683e554b74e
--- /dev/null
+++ b/docs/framework/wcf/samples/x-509-certificate-validator.md
@@ -0,0 +1,372 @@
+---
+title: "X.509 証明書検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b042379-02c4-4395-b927-e57c842fd3e0
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# X.509 証明書検証
+このサンプルでは、カスタム X.509 証明書検証を実装する方法を示します。これは、アプリケーションの要件に適した組み込みの X.509 証明書検証モードがない場合に便利です。このサンプルでは、自己発行の証明書を許可するカスタム検証を備えたサービスを示します。クライアントはこのような証明書を使用して、このサービスに認証されます。  
+  
+ メモ : 任意のユーザーが自己発行の証明書を作成できる場合、このサービスで使用されるカスタム検証は、ChainTrust X509CertificateValidationMode によって提供される既定の動作よりも安全性が低くなります。この検証ロジックを製品版のコードで使用する前に、こうしたセキュリティへの影響について慎重に考慮する必要があります。  
+  
+ このサンプルで示す処理の概要は次のとおりです。  
+  
+-   クライアントは X.509 証明書を使用して認証される。  
+  
+-   サーバーはクライアント資格情報をカスタム X509Certificate 検証と照合する。  
+  
+-   サーバーがそのサーバーの X.509 証明書を使用して認証される。  
+  
+ サービスは、そのサービスとの通信に使用する単一エンドポイントを公開します。エンドポイントは構成ファイル \(App.config\) で定義します。エンドポイントは、アドレス、バインディング、およびコントラクトがそれぞれ 1 つずつで構成されます。バインディングの構成には、標準の `wsHttpBinding` が使用されます。既定では、`WSSecurity` とクライアント証明書による認証が使用されます。サービス動作では、クライアントの X.509 証明書を検証するためのカスタム モード、および検証クラスの型を指定します。さらに、serviceCertificate 要素を使用しているサーバー証明書も指定します。サーバー証明書の `SubjectName` には、[\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md)の `findValue` 属性と同じ値が指定されている必要があります。  
+  
+```  
+  <system.serviceModel>  
+    <services>  
+      <service name="Microsoft.ServiceModel.Samples.CalculatorService"  
+               behaviorConfiguration="CalculatorServiceBehavior">  
+        <!-- use host/baseAddresses to configure base address -->  
+        <!-- provided by host -->  
+        <host>  
+          <baseAddresses>  
+            <add baseAddress =  
+                "http://localhost:8001/servicemodelsamples/service" />  
+          </baseAddresses>  
+        </host>  
+        <!-- use base address specified above, provide one endpoint -->  
+        <endpoint address="certificate"  
+               binding="wsHttpBinding"  
+               bindingConfiguration="Binding"   
+               contract="Microsoft.ServiceModel.Samples.ICalculator" />  
+      </service>  
+    </services>  
+    <bindings>  
+      <wsHttpBinding>  
+        <!-- X509 certificate binding -->  
+        <binding name="Binding">  
+          <security mode="Message">  
+            <message clientCredentialType="Certificate" />  
+          </security>  
+        </binding>  
+      </wsHttpBinding>  
+    </bindings>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name="CalculatorServiceBehavior">  
+          <serviceDebug includeExceptionDetailInFaults ="true"/>  
+          <serviceCredentials>  
+            <!--The serviceCredentials behavior allows one -->  
+            <!-- to specify authentication constraints on -->  
+            <!-- client certificates. -->  
+            <clientCertificate>  
+              <!-- Setting the certificateValidationMode to -->  
+              <!-- Custom means that if the custom -->  
+              <!-- X509CertificateValidator does NOT throw -->  
+              <!-- an exception, then the provided certificate -- >  
+              <!-- will be trusted without performing any -->  
+              <!-- validation beyond that performed by the custom-->  
+              <!-- validator. The security implications of this -->  
+              <!-- setting should be carefully considered before -->  
+              <!-- using Custom in production code. -->  
+              <authentication   
+                 certificateValidationMode="Custom"   
+                 customCertificateValidatorType =  
+"Microsoft.ServiceModel.Samples.CustomX509CertificateValidator, service" />  
+            </clientCertificate>  
+            <!-- The serviceCredentials behavior allows one to -- >  
+            <!--define a service certificate. -->  
+            <!--A service certificate is used by a client to  -->  
+            <!--authenticate the service and provide message  -->  
+            <!--protection. This configuration references the  -->  
+            <!--"localhost" certificate installed during the setup  -->  
+            <!--instructions. -->  
+            <serviceCertificate findValue="localhost"   
+                 storeLocation="LocalMachine"   
+                 storeName="My" x509FindType="FindBySubjectName" />  
+          </serviceCredentials>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+      </system.serviceModel>  
+  
+```  
+  
+ クライアント エンドポイント構成は、構成名、サービス エンドポイントの絶対アドレス、バインディング、およびコントラクトで構成されます。クライアント バインディングは、適切なモードおよびメッセージ `clientCredentialType` で構成されます。  
+  
+```  
+<system.serviceModel>  
+    <client>  
+      <!-- X509 certificate based endpoint -->  
+      <endpoint name="Certificate"  
+        address=  
+        "http://localhost:8001/servicemodelsamples/service/certificate"   
+                binding="wsHttpBinding"   
+                bindingConfiguration="Binding"   
+                behaviorConfiguration="ClientCertificateBehavior"  
+                contract="Microsoft.ServiceModel.Samples.ICalculator">  
+      </endpoint>  
+    </client>  
+    <bindings>  
+        <wsHttpBinding>  
+            <!-- X509 certificate binding -->  
+            <binding name="Binding">  
+                <security mode="Message">  
+                    <message clientCredentialType="Certificate" />  
+               </security>  
+            </binding>  
+       </wsHttpBinding>  
+    </bindings>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="ClientCertificateBehavior">  
+          <clientCredentials>  
+            <serviceCertificate>  
+              <!-- Setting the certificateValidationMode to -->  
+              <!-- PeerOrChainTrust means that if the certificate -->  
+              <!-- is in the user's Trusted People store, then it -->  
+              <!-- is trusted without performing a validation of -->  
+              <!-- the certificate's issuer chain. -->  
+              <!-- This setting is used here for convenience so -->  
+              <!-- that the sample can be run without having to -->  
+              <!-- have certificates issued by a certification -->  
+              <!-- authority (CA). This setting is less secure -->  
+              <!-- than the default, ChainTrust. The security -->  
+              <!-- implications of this setting should be -->  
+              <!-- carefully considered before using -->  
+              <!-- PeerOrChainTrust in production code.-->  
+              <authentication   
+                  certificateValidationMode="PeerOrChainTrust" />  
+            </serviceCertificate>  
+          </clientCredentials>  
+        </behavior>  
+      </endpointBehaviors>  
+    </behaviors>  
+  </system.serviceModel>  
+  
+```  
+  
+ クライアントの実装では、使用するクライアント証明書を設定します。  
+  
+```  
+// Create a client with Certificate endpoint configuration  
+CalculatorClient client = new CalculatorClient("Certificate");  
+try  
+{  
+    client.ClientCredentials.ClientCertificate.SetCertificate(StoreLocation.CurrentUser, StoreName.My, X509FindType.FindBySubjectName, "test1");  
+  
+    // Call the Add service operation.  
+    double value1 = 100.00D;  
+    double value2 = 15.99D;  
+    double result = client.Add(value1, value2);  
+    Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Subtract service operation.  
+    value1 = 145.00D;  
+    value2 = 76.54D;  
+    result = client.Subtract(value1, value2);  
+    Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Multiply service operation.  
+    value1 = 9.00D;  
+    value2 = 81.25D;  
+    result = client.Multiply(value1, value2);  
+    Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);  
+  
+    // Call the Divide service operation.  
+    value1 = 22.00D;  
+    value2 = 7.00D;  
+    result = client.Divide(value1, value2);  
+    Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);  
+    client.Close();  
+}  
+catch (TimeoutException e)  
+{  
+    Console.WriteLine("Call timed out : {0}", e.Message);  
+    client.Abort();  
+}  
+catch (CommunicationException e)  
+{  
+    Console.WriteLine("Call failed : {0}", e.Message);  
+    client.Abort();  
+}  
+catch (Exception e)  
+{  
+    Console.WriteLine("Call failed : {0}", e.Message);  
+    client.Abort();  
+}  
+```  
+  
+ このサンプルでは、カスタム X509Certificate 検証を使用して証明書を検証します。サンプルは、<xref:System.IdentityModel.Selectors.X509CertificateValidator> から派生するカスタム X509Certificate 検証を実装します。詳細については、<xref:System.IdentityModel.Selectors.X509CertificateValidator> に関する説明を参照してください。特定のカスタム検証を使用しているこのサンプルは、自己発行の任意の X.509 証明書を許可する Validate メソッドを実装しています。次のコードを参照してください。  
+  
+```  
+public class CustomX509CertificateValidator : X509CertificateValidator  
+{  
+  public override void Validate ( X509Certificate2 certificate )  
+  {  
+   // Only accept self-issued certificates  
+   if (certificate.Subject != certificate.Issuer)  
+     throw new Exception("Certificate is not self-issued");  
+   }  
+}  
+  
+```  
+  
+ サービス コードに検証を実装した場合、使用する検証インスタンスをサービス ホストに通知する必要があります。これは次のコードで実行されます。  
+  
+```  
+serviceHost.Credentials.ClientCertificate.Authentication.CertificateValidationMode = X509CertificateValidationMode.Custom;  
+serviceHost.Credentials.ClientCertificate.Authentication.CustomCertificateValidator = new CustomX509CertificateValidator();  
+```  
+  
+ または、構成で次のように指定することで、同じことを実現できます。  
+  
+```  
+<behaviors>  
+    <serviceBehaviors>  
+     <behavior name="CalculatorServiceBehavior">  
+       ...  
+   <serviceCredentials>  
+    <!--The serviceCredentials behavior allows one to specify -->   
+    <!--authentication constraints on client certificates.-->  
+    <clientCertificate>  
+    <!-- Setting the certificateValidationMode to Custom means -->   
+    <!--that if the custom X509CertificateValidator does NOT -->   
+    <!--throw an exception, then the provided certificate will-- >   
+    <!-- be trusted without performing any validation beyond that-- >  
+    <!-- performed by the custom validator. The security -- >   
+    <!--implications of this setting should be carefully -- >  
+    <!--considered before using Custom in production code. -->  
+    <authentication certificateValidationMode="Custom"  
+       customCertificateValidatorType =  
+"Microsoft.ServiceModel.Samples. CustomX509CertificateValidator, service" />  
+   </clientCertificate>  
+   ...  
+  </behavior>  
+ </serviceBehaviors>  
+</behaviors>  
+  
+```  
+  
+ このサンプルを実行すると、操作要求および応答がクライアントのコンソール ウィンドウに表示されます。クライアントはすべてのメソッドを問題なく呼び出すことができるようになります。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+## セットアップ バッチ ファイル  
+ このサンプルに用意されている Setup.bat バッチ ファイルを使用すると、適切な証明書を使用してサーバーを構成し、サーバー証明書ベースのセキュリティを必要とする自己ホスト型アプリケーションを実行できるようになります。このバッチ ファイルは、複数のコンピューターを使用する場合またはホストなしの場合に応じて変更する必要があります。  
+  
+ 次に、バッチ ファイルのセクションのうち、該当する構成で実行するために変更が必要となる部分を示します。  
+  
+-   サーバー証明書の作成 :  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するサーバー証明書を作成します。%SERVER\_NAME% 変数はサーバー名を指定します。この変数を変更して、使用するサーバー名を指定します。既定値は、localhost です。  
+  
+    ```  
+    echo ************  
+    echo Server cert setup starting  
+    echo %SERVER_NAME%  
+    echo ************  
+    echo making server cert  
+    echo ************  
+    makecert.exe -sr LocalMachine -ss MY -a sha1 -n CN=%SERVER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   サーバー証明書のクライアントの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、サーバー証明書をクライアントの信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がクライアント システムにより暗黙には信頼されないからです。マイクロソフト発行の証明書など、クライアントの信頼されたルート証明書に基づいた証明書が既にある場合は、クライアント証明書ストアにサーバー証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r LocalMachine -s My -c -n %SERVER_NAME% -r CurrentUser -s TrustedPeople  
+    ```  
+  
+-   クライアント証明書の作成 :  
+  
+     Setup.bat バッチ ファイルの次の行は、使用するクライアント証明書を作成します。%USER\_NAME% 変数はクライアント名を指定します。この値は "test1" に設定されます。クライアント コードによってこの名前が検索されるためです。%USER\_NAME% の値を変更した場合は、Client.cs ソース ファイル内の対応する値を変更して、クライアントを再構築する必要があります。  
+  
+     証明書は、CurrentUser ストアの場所の My \(Personal\) ストアに保存されます。  
+  
+    ```  
+    echo ************  
+    echo Client cert setup starting  
+    echo %USER_NAME%  
+    echo ************  
+    echo making client cert  
+    echo ************  
+    makecert.exe -sr CurrentUser -ss MY -a sha1 -n CN=%USER_NAME% -sky exchange -pe  
+  
+    ```  
+  
+-   クライアント証明書のサーバーの信頼された証明書ストアへのインストール。  
+  
+     Setup.bat バッチ ファイルの次の行は、クライアント証明書を信頼されたユーザーのストアにコピーします。この手順が必要なのは、Makecert.exe によって生成される証明書がサーバー システムにより暗黙には信頼されないからです。マイクロソフト発行の証明書など、信頼されたルート証明書に基づく証明書が既にある場合は、サーバー証明書ストアにクライアント証明書を配置するこの手順は不要です。  
+  
+    ```  
+    certmgr.exe -add -r CurrentUser -s My -c -n %USER_NAME% -r LocalMachine -s TrustedPeople  
+    ```  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  ソリューションをビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+2.  サンプルを単一コンピューター構成で実行するか、複数コンピューター構成で実行するかに応じて、次の手順に従います。  
+  
+#### サンプルを同じコンピューターで実行するには  
+  
+1.  管理特権で [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトを開き、サンプルのインストール フォルダーから Setup.bat を実行します。これにより、サンプルの実行に必要なすべての証明書がインストールされます。  
+  
+    > [!IMPORTANT]
+    >  Setup.bat バッチ ファイルは、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプトから実行します。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] コマンド プロンプト内で設定された PATH 環境変数は、Setup.bat スクリプトで必要な実行可能ファイルが格納されているディレクトリを指しています。  
+  
+2.  Service.exe を service\\bin で起動します。  
+  
+3.  Client.exe を \\client\\bin で起動します。クライアント アクティビティがクライアントのコンソール アプリケーションに表示されます。  
+  
+4.  クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルを複数のコンピューターで実行するには  
+  
+1.  サービス コンピューターにディレクトリを作成します。  
+  
+2.  サービス プログラム ファイルを \\service\\bin からサービス コンピューターの仮想ディレクトリにコピーします。Setup.bat、Cleanup.bat、GetComputerName.vbs、ImportClientCert.bat の各ファイルもサービス コンピューターにコピーします。  
+  
+3.  クライアント コンピューターにクライアント バイナリ用のディレクトリを作成します。  
+  
+4.  クライアント プログラム ファイルを、クライアント コンピューターに作成したクライアント ディレクトリにコピーします。Setup.bat、Cleanup.bat、ImportServiceCert.bat の各ファイルもクライアントにコピーします。  
+  
+5.  サーバー上で管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat service` を実行します。`setup.bat` に `service` 引数を指定して実行すると、コンピューターの完全修飾ドメイン名を使用してサービス証明書が作成され、Service.cer というファイルにエクスポートされます。  
+  
+6.  Service.exe.config を編集して、新しい証明書名 \([\<serviceCertificate\>](../../../../docs/framework/configure-apps/file-schema/wcf/servicecertificate-of-servicecredentials.md) の `findValue` 属性\) を反映します。これは、コンピューターの完全修飾ドメイン名と同じです。さらに、\<service\>\/\<baseAddresses\> 要素で、コンピューター名を localhost からサービス コンピューターの完全修飾名に変更します。  
+  
+7.  Service.cer ファイルを、サービス ディレクトリからクライアント コンピューターのクライアント ディレクトリにコピーします。  
+  
+8.  クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、`setup.bat client` を実行します。`setup.bat` に `client` 引数を指定して実行すると、client.com というクライアント証明書が作成され、Client.cer というファイルにエクスポートされます。  
+  
+9. クライアント コンピューターの Client.exe.config ファイルで、エンドポイントのアドレス値をサービスの新しいアドレスに合わせます。そのためには、localhost をサーバーの完全修飾ドメイン名に置き換えます。  
+  
+10. Client.cer ファイルを、クライアント ディレクトリからサーバーのサービス ディレクトリにコピーします。  
+  
+11. クライアント上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportServiceCert.bat を実行します。これにより、サービス証明書が Service.cer ファイルから CurrentUser \- TrustedPeople ストアにインポートされます。  
+  
+12. サーバー上で、管理特権を使用して Visual Studio コマンド プロンプトを開き、ImportClientCert.bat を実行します。これにより、クライアント証明書が Client.cer ファイルから LocalMachine \- TrustedPeople ストアにインポートされます。  
+  
+13. サーバー コンピューターで、コマンド プロンプト ウィンドウから Service.exe を起動します。  
+  
+14. クライアント コンピューターで、コマンド プロンプト ウィンドウから Client.exe を起動します。クライアントとサービス間で通信できない場合は、「[Troubleshooting Tips](http://msdn.microsoft.com/ja-jp/8787c877-5e96-42da-8214-fa737a38f10b)」を参照してください。  
+  
+#### サンプルの実行後にクリーンアップするには  
+  
+1.  サンプルの実行が終わったら、サンプル フォルダーにある Cleanup.bat を実行します。これにより、証明書ストアからサーバー証明書とクライアント証明書が削除されます。  
+  
+> [!NOTE]
+>  このサンプルを複数のコンピューターで実行している場合、このスクリプトはサービス証明書をクライアントから削除しません。複数のコンピューターで証明書を使用する [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルを実行した場合は、CurrentUser \- TrustedPeople ストアにインストールされたサービス証明書を忘れずに削除してください。削除するには、コマンド `certmgr -del -r CurrentUser -s TrustedPeople -c -n <Fully Qualified Server Machine Name>` を実行します。たとえば、`certmgr -del -r CurrentUser -s TrustedPeople -c -n server1.contoso.com` となります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/xmlreader-sample.md b/docs/framework/wcf/samples/xmlreader-sample.md
new file mode 100644
index 00000000000..a78cfd235b6
--- /dev/null
+++ b/docs/framework/wcf/samples/xmlreader-sample.md
@@ -0,0 +1,125 @@
+---
+title: "XmlReader サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "XML リーダー"
+ms.assetid: 60e5848d-7d9c-4ea5-bed9-22758c9ac16c
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# XmlReader サンプル
+XmlReader サンプルでは、<xref:System.Xml.XmlReader> を使用したメッセージ本文の処理を示します。このサンプルは、電卓サービスを実装する「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づいています。`Sum` という 1 つのサービス操作が追加され、このサービス操作は、合計する値の配列を含むメッセージを受け入れます。サービスは、<xref:System.Xml.XmlReader> を使用してメッセージを読み取ります。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 電卓インターフェイスには、<xref:System.ServiceModel.Channels.Message> パラメータを受け取る `Sum` という名前のサービス操作が含まれます。次のサンプル コードを参照してください。  
+  
+```  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    double Add(double n1, double n2);  
+    [OperationContract]  
+    double Subtract(double n1, double n2);  
+    [OperationContract]  
+    double Multiply(double n1, double n2);  
+    [OperationContract]  
+    double Divide(double n1, double n2);  
+    [OperationContract]  
+    Message Sum(Message message);  
+}  
+  
+```  
+  
+ クライアントは、最初に整数値の配列を作成してこの配列からメッセージを作成し、次に作成されたメッセージを使用して `Sum` メソッドを呼び出すことによって、`Sum` にアクセスします。次のサンプル コードを参照してください。  
+  
+```  
+CalculatorClient client = new CalculatorClient();  
+...  
+// Call the Sum service operation.  
+int[] values = { 1, 2, 3, 4, 5 };  
+using (new OperationContextScope(client.InnerChannel))  
+{  
+    Message request = Message.CreateMessage(OperationContext.Current.OutgoingMessageHeaders.MessageVersion, "http://Microsoft.ServiceModel.Samples/ICalculator/Sum", values);  
+    Message reply = client.Sum(request);  
+    int sum = reply.GetBody<int>();  
+  
+    Console.WriteLine("Sum(1,2,3,4,5) = {0}", sum);  
+}  
+  
+```  
+  
+ このサービスでは、サービス操作 `Sum` を実装し、<xref:System.Xml.XmlReader> オブジェクトを使用してメッセージ本文にアクセスすることによって、値を反復処理して合計します。<xref:System.ServiceModel.Channels.Message.GetReaderAtBodyContents%2A> メソッドが呼び出されると、メッセージ本文へのアクセスが行われます。次のサンプル コードを参照してください。  
+  
+```  
+public int Sum(Message message)  
+{  
+    int sum = 0;  
+    string text = "";  
+  
+    //The body of the message contains a list of numbers that are read  
+    //directly using an XmlReader.  
+    XmlReader body = message.GetReaderAtBodyContents ();  
+    while (body.Read())  
+    {  
+        text = body.ReadString().Trim();  
+        if (text.Length>0)  
+        {  
+            sum += Convert.ToInt32(text);  
+        }  
+    }  
+    body.Close();  
+    Message response = Message.CreateMessage(  
+       "http://Microsoft.ServiceModel.Samples/ICalculator/SumResponse",  
+       sum);  
+    return response;  
+}  
+  
+```  
+  
+ このサンプルを実行する場合は、操作の要求や応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+  
+Add(100,15.99) = 115.99  
+Subtract(145,76.54) = 68.46  
+Multiply(9,81.25) = 731.25  
+Divide(22,7) = 3.14285714285714  
+Sum(1,2,3,4,5) = 15  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Message\XmlReader`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/xmlserializer-faults.md b/docs/framework/wcf/samples/xmlserializer-faults.md
new file mode 100644
index 00000000000..da7006cf8c3
--- /dev/null
+++ b/docs/framework/wcf/samples/xmlserializer-faults.md
@@ -0,0 +1,68 @@
+---
+title: "XmlSerializer エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c6b80f14-64f4-4162-ae76-71664cf42fd3
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# XmlSerializer エラー
+<xref:System.Xml.Serialization.XmlSerializer> のエラー コントラクトのサンプルでは、<xref:System.Xml.Serialization.XmlSerializer> を使用して、エラー情報をサービスからクライアントに通信する方法を示します。  サンプルは、「[概要](../../../../docs/framework/wcf/samples/getting-started-sample.md)」に基づき、内部例外をエラーに変換するいくつかの追加コードをサービスに追加しています。  クライアントは 0 による除算を試行し、サービスを強制的にエラー状態にします。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ 電卓コントラクトは、<xref:System.ServiceModel.FaultContractAttribute> が含まれるように変更されています。次のサンプル コードを参照してください。  また、<xref:System.ServiceModel.XmlSerializerFormatAttribute> は、<xref:System.Xml.Serialization.XmlSerializer> を使用したシリアル化を有効にするために使用されます。  <xref:System.ServiceModel.XmlSerializerFormatAttribute.SupportFaults%2A> プロパティは、この属性で `true` に設定され、エラーの読み取りと書き込みに <xref:System.Xml.Serialization.XmlSerializer> を使用することをシリアライザーに指示します。  
+  
+```  
+[XmlSerializerFormat(SupportFaults=true)]  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]  
+public interface ICalculator  
+{  
+    [OperationContract]  
+    int Add(int n1, int n2);  
+  
+    [OperationContract]  
+    int Subtract(int n1, int n2);  
+  
+    [OperationContract]  
+    int Multiply(int n1, int n2);  
+  
+    [OperationContract]  
+    [FaultContract(typeof(MathFault))]  
+    int Divide(int n1, int n2);  
+}  
+```  
+  
+ クライアント プロキシのコードを生成する場合、**\/UseSerializerForFaults** フラグを [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) に適用する必要があります。  
+  
+### サンプルをセットアップ、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」に移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Contract\Service\XmlSerializerFaults`  
+  
+## 参照  
+ <xref:System.ServiceModel.XmlSerializerFormatAttribute>   
+ <xref:System.ServiceModel.XmlSerializerFormatAttribute.SupportFaults%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/samples/xmlserializer-sample.md b/docs/framework/wcf/samples/xmlserializer-sample.md
new file mode 100644
index 00000000000..20e50c10b1f
--- /dev/null
+++ b/docs/framework/wcf/samples/xmlserializer-sample.md
@@ -0,0 +1,147 @@
+---
+title: "XMLSerializer サンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7d134453-9a35-4202-ba77-9ca3a65babc3
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# XMLSerializer サンプル
+このサンプルでは、<xref:System.Xml.Serialization.XmlSerializer> と互換性のある型をシリアル化および逆シリアル化する方法を示します。既定の [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] フォーマッタは <xref:System.Runtime.Serialization.DataContractSerializer> クラスです。<xref:System.Xml.Serialization.XmlSerializer> クラスを使用すると、<xref:System.Runtime.Serialization.DataContractSerializer> クラスを使用できない場合に、型をシリアル化および逆シリアル化できます。これは、XML を厳密に制御する必要がある場合、たとえば、データの一部が XML 属性であるが XML 要素ではない、などと制御する必要がある場合に多く該当します。さらに、<xref:System.Xml.Serialization.XmlSerializer> は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] 以外のサービスに対してクライアントを作成する場合に自動的に選択されることがよくあります。  
+  
+ この例では、クライアントはコンソール アプリケーション \(.exe\) で、サービスはインターネット インフォメーション サービス \(IIS\) によってホストされます。  
+  
+> [!NOTE]
+>  このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。  
+  
+ <xref:System.ServiceModel.ServiceContractAttribute> と <xref:System.ServiceModel.XmlSerializerFormatAttribute> をインターフェイスに適用する必要があります。次のサンプル コードを参照してください。  
+  
+```  
+[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples"), XmlSerializerFormat]  
+public interface IXmlSerializerCalculator  
+{  
+    [OperationContract]  
+    ComplexNumber Add(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Subtract(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Multiply(ComplexNumber n1, ComplexNumber n2);  
+    [OperationContract]  
+    ComplexNumber Divide(ComplexNumber n1, ComplexNumber n2);  
+}  
+  
+```  
+  
+ `ComplexNumber` クラスのパブリック メンバは、<xref:System.Xml.Serialization.XmlSerializer> によって XML 属性としてシリアル化されます。<xref:System.Runtime.Serialization.DataContractSerializer> は、この種の XML インスタンスの作成には使用できません。  
+  
+```  
+public class ComplexNumber  
+{  
+    private double real;  
+    private double imaginary;  
+  
+    [XmlAttribute]  
+    public double Real  
+    {  
+        get { return real; }  
+        set { real = value; }  
+    }  
+  
+    [XmlAttribute]  
+    public double Imaginary  
+    {  
+        get { return imaginary; }  
+        set { imaginary = value; }  
+    }  
+  
+    public ComplexNumber(double real, double imaginary)  
+    {  
+        this.Real = real;  
+        this.Imaginary = imaginary;  
+    }  
+    public ComplexNumber()  
+    {  
+        this.Real = 0;  
+        this.Imaginary = 0;  
+    }  
+  
+}  
+```  
+  
+ サービス実装は計算を行い、結果を返します。つまり、`ComplexNumber` 型の値を受け入れて返します。  
+  
+```  
+public class XmlSerializerCalculatorService : IXmlSerializerCalculator  
+{  
+    public ComplexNumber Add(ComplexNumber n1, ComplexNumber n2)  
+    {  
+        return new ComplexNumber(n1.Real + n2.Real, n1.Imaginary +  
+                                                      n2.Imaginary);  
+    }  
+    …  
+}  
+  
+```  
+  
+ クライアント実装でも複素数を使用します。サービス コントラクトとデータ型は、どちらも generatedClient.cs ソース ファイルで定義されます。このソース ファイルは、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によってサービス メタデータから生成されたものです。コントラクトが <xref:System.Runtime.Serialization.DataContractSerializer> でシリアル化されずにこの場合の送出元の `XmlSerializable` 型に戻る場合、Svcutil.exe で検出することができます。<xref:System.Xml.Serialization.XmlSerializer> を強制的に使用する場合は、\/serializer:XmlSerializer \(XmlSerializer を使用\) コマンド オプションを Svcutil.exe ツールに渡します。  
+  
+```  
+// Create a client.  
+XmlSerializerCalculatorClient client = new  
+                         XmlSerializerCalculatorClient();  
+  
+// Call the Add service operation.  
+ComplexNumber value1 = new ComplexNumber();  
+value1.Real = 1;  
+value1.Imaginary = 2;  
+ComplexNumber value2 = new ComplexNumber();  
+value2.Real = 3;  
+value2.Imaginary = 4;  
+ComplexNumber result = client.Add(value1, value2);  
+Console.WriteLine("Add({0} + {1}i, {2} + {3}i) = {4} + {5}i",  
+    value1.Real, value1.Imaginary, value2.Real, value2.Imaginary,   
+    result.Real, result.Imaginary);  
+    …  
+}  
+  
+```  
+  
+ このサンプルを実行する場合は、操作要求および応答はクライアントのコンソール ウィンドウに表示されます。クライアントをシャットダウンするには、クライアント ウィンドウで Enter キーを押します。  
+  
+```  
+Add(1 + 2i, 3 + 4i) = 4 + 6i  
+Subtract(1 + 2i, 3 + 4i) = -2 + -2i  
+Multiply(2 + 3i, 4 + 7i) = -13 + 26i  
+Divide(3 + 7i, 5 + -2i) = 0.0344827586206897 + 1.41379310344828i  
+  
+Press <ENTER> to terminate client.  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  「[Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)」が実行済みであることを確認します。  
+  
+2.  ソリューションの C\# 版または Visual Basic .NET 版をビルドするには、「[Windows Communication Foundation サンプルのビルド](../../../../docs/framework/wcf/samples/building-the-samples.md)」の手順に従います。  
+  
+3.  単一コンピューター構成か複数コンピューター構成かに応じて、「[Windows Communication Foundation サンプルの実行](../../../../docs/framework/wcf/samples/running-the-samples.md)」の手順に従います。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WCF\Basic\Client\Interop\XmlSerializer`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/wcf/securing-clients.md b/docs/framework/wcf/securing-clients.md
new file mode 100644
index 00000000000..2fc0b0d125e
--- /dev/null
+++ b/docs/framework/wcf/securing-clients.md
@@ -0,0 +1,174 @@
+---
+title: "クライアントのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント [WCF], セキュリティの考慮事項"
+ms.assetid: 44c8578c-9a5b-4acd-8168-1c30a027c4c5
+caps.latest.revision: 22
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 22
+---
+# クライアントのセキュリティ保護
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、サービスがクライアントのセキュリティ要件を決定します。つまり、使用するセキュリティ モード、およびクライアントが資格情報を提供するかどうかは、サービスによって指定されます。そのため、クライアントをセキュリティで保護するプロセスは、サービスから取得したメタデータ \(公開されている場合\) を使用してクライアントを構築するという簡単なものになります。クライアントを構成する方法は、メタデータによって指定されます。クライアントが資格情報を提供することをサービスが要求する場合、要件に適した資格情報を取得する必要があります。ここでは、このプロセスについて詳しく説明します。セキュリティで保護されたサービスを作成する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)」を参照してください。  
+  
+## サービスによるセキュリティの指定  
+ 既定では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] バインディングのセキュリティ機能は有効になっています \(<xref:System.ServiceModel.BasicHttpBinding> を除く\)。そのため、サービスが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用して作成されている場合、認証、機密性、および整合性を確実にするセキュリティが実装される可能性が高くなります。この場合、サービスが提供するメタデータによって、セキュリティで保護された通信チャネルの確立に必要なものが示されます。サービス メタデータにセキュリティ要件がまったく含まれていない場合には、サービスでセキュリティ スキーム \(SSL \(Secure Sockets Layer\) over HTTP など\) を強制する方法はありません。ただし、サービスがクライアントに資格情報の提供を求める場合は、クライアントの開発者、展開担当者、または管理者は、クライアントがサービスに対して認証を受けるときに実際に使用する資格情報を提供する必要があります。  
+  
+## メタデータの取得  
+ クライアントを作成する場合、最初の手順はクライアントが通信を行うサービスからメタデータを取得することです。これは、次の 2 つの方法で行うことができます。サービスにより MEX \(Metadata Exchange\) エンドポイントが公開されているか、HTTP または HTTPS 上でメタデータが使用可能になっている場合は、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してメタデータをダウンロードできます。このツールは、クライアントのコード ファイルと構成ファイルの両方を生成します \(このツールの使い方[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)」を参照してください\)。サービスにより MEX エンドポイントが公開されておらず、かつ HTTP または HTTPS 上でメタデータが使用可能になっていない場合は、サービス作成者に連絡して、セキュリティ要件とメタデータについて記述したドキュメントを入手する必要があります。  
+  
+> [!IMPORTANT]
+>  メタデータが信頼されたソースのものであり、改ざんされていないことを確認することをお勧めします。HTTP プロトコルを使用して取得したメタデータはクリア テキストで送信されるため、改ざんされるおそれがあります。サービスで <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A> プロパティおよび <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetUrl%2A> プロパティを使用している場合は、サービス作成者から提供された URL で、HTTPS プロトコルを使用してデータをダウンロードします。  
+  
+## セキュリティの検証  
+ メタデータのソースは、信頼されたソースと信頼関係のないソースの 2 つに大きく分けられます。ソースを信頼しており、そのソースのセキュリティで保護された MEX エンドポイントからクライアント コードとその他のメタデータをダウンロードしている場合、何の懸念もなく、クライアントをビルドし、適切な資格情報を提供して実行できます。  
+  
+ ただし、ほとんど未知のソースからクライアントとメタデータをダウンロードする場合は、コードで使用しているセキュリティ対策を検証する必要があります。たとえば、サービスにより \(最低でも\) 機密性と整合性とが要求されていない場合は、個人情報や財務情報を送信するクライアントを作成するようなことは絶対に避けてください。この種の情報はサービスの所有者から見ることが可能なので、この種の情報の開示を行ってもよいと判断できる程度にはサービスの所有者を信頼できる必要があります。  
+  
+ したがって、信頼できないソースから受け取ったコードとメタデータを使用する場合には、それがこちらの必要とするセキュリティ レベルを満たしていることを確認する必要があります。  
+  
+## クライアント資格情報の設定  
+ クライアントへの資格情報の設定には、次の 2 つの手順があります。  
+  
+1.  サービスが要求する *"クライアント資格情報の種類"* を確認します。これは、2 つある方法のどちらかによって行います。1 つ目の方法として、サービス作成者からドキュメントを入手している場合は、このドキュメントにサービスが要求するクライアント資格情報の種類が示されています \(クライアント資格情報の種類が指定されている場合\)。2 番目の方法は Svcutil.exe ツールによって作成された構成ファイルしかない場合で、個々のバインディングを調べることで必要な資格情報の種類を特定できます。  
+  
+2.  実際のクライアント資格情報を指定します。実際のクライアント資格情報は、資格情報の種類と区別するために、*クライアント資格情報の値*と呼ばれます。たとえば、クライアント資格情報の種類として証明書が指定されている場合、サービスが信頼する証明機関によって発行された X.509 証明書を指定する必要があります。  
+  
+### クライアント資格情報の種類の特定  
+ Svcutil.exe ツールによって生成された構成ファイルがある場合は、[\<bindings\>](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md) セクションを調べて、必要とされるクライアント資格情報の種類を確認します。このセクション内には、セキュリティ要件を指定するバインド要素があります。具体的には、各バインディングの \<security\> 要素を調べます。この要素には `mode` 属性が含まれており、3 つの値のいずれか \(`Message`、`Transport`、または `TransportWithMessageCredential`\) に設定できます。この属性の値によってモードが決定され、このモードによってどの子要素が有効なのかが決定されます。  
+  
+ `<security>` 要素には、`<transport>` 要素または `<message>`  要素、あるいはその両方を含めることができます。セキュリティ モードと一致する要素が有効な要素です。たとえば、次のコードでは、セキュリティ モードを `"Message"`、`<message>` 要素のクライアント資格情報の種類を `"Certificate"` に指定しています。この場合、`<transport>` 要素は無視できます。ただし、`<message>` 要素で X.509 証明書を提示する必要があることが指定されています。  
+  
+```  
+<wsHttpBinding>  
+    <binding name="WSHttpBinding_ICalculator">  
+       <security mode="Message">  
+           <transport clientCredentialType="Windows"   
+                      realm="" />  
+           <message clientCredentialType="Certificate"   
+                    negotiateServiceCredential="true"  
+                    algorithmSuite="Default"   
+                    establishSecurityContext="true" />  
+       </security>  
+    </binding>  
+</wsHttpBinding>  
+```  
+  
+ 次の例に示すように、`clientCredentialType` 属性が `"Windows"` に設定されている場合は、実際の資格情報の値を指定する必要はありません。これは、Windows 統合セキュリティでは、クライアントを実行しているユーザーの実際の資格情報 \(Kerberos トークン\) が提供されるためです。  
+  
+```  
+<security mode="Message">  
+    <transport clientCredentialType="Windows "   
+        realm="" />  
+</security>  
+```  
+  
+### クライアント資格情報の値の設定  
+ クライアントが資格情報を提供する必要があると特定された場合は、クライアントを構成する適切なメソッドを使用します。たとえば、クライアント証明書を設定するには、<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential.SetCertificate%2A> メソッドを使用します。  
+  
+ X.509 証明書は広く使用されている資格情報の形式です。資格情報は次の 2 つの方法で提供できます。  
+  
+-   クライアント コードで \(`SetCertificate` メソッドを使用して\) プログラミングする方法。  
+  
+ クライアントの構成ファイルに [\<behaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/behaviors.md) セクションを追加し、`clientCredentials` 要素を使用する方法 \(以下に示します\)。  
+  
+#### コードでの \<clientCredentials\> 値の設定  
+ コードで [\<clientCredentials\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 値を設定するには、<xref:System.ServiceModel.ClientBase%601> クラスの <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A> プロパティにアクセスする必要があります。このプロパティは、次の表に示すように、各種の資格情報の種類にアクセスできる <xref:System.ServiceModel.Description.ClientCredentials> オブジェクトを返します。  
+  
+|ClientCredential プロパティ|説明|注記|  
+|----------------------------|--------|--------|  
+|<xref:System.ServiceModel.Description.ClientCredentials.ClientCertificate%2A>|<xref:System.ServiceModel.Security.X509CertificateInitiatorClientCredential> を返します|クライアントがサービスに対して自身を認証するために提供する X.509 証明書を表します。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.HttpDigest%2A>|<xref:System.ServiceModel.Security.HttpDigestClientCredential> を返します|HTTP ダイジェスト資格情報を表します。この資格情報は、ユーザー名とパスワードのハッシュです。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.IssuedToken%2A>|<xref:System.ServiceModel.Security.IssuedTokenClientCredential> を返します|フェデレーション シナリオで通常使用される、セキュリティ トークン サービスによって発行されるカスタム セキュリティ トークンを表します。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.Peer%2A>|<xref:System.ServiceModel.Security.PeerCredential> を返します|Windows ドメインのピア メッシュに参加するためのピア資格情報を表します。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.ServiceCertificate%2A>|<xref:System.ServiceModel.Security.X509CertificateRecipientClientCredential> を返します|帯域外ネゴシエーションでサービスによって提供される X.509 証明書を表します。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.UserName%2A>|<xref:System.ServiceModel.Security.UserNamePasswordClientCredential> を返します|ユーザー名とパスワードのペアを表します。|  
+|<xref:System.ServiceModel.Description.ClientCredentials.Windows%2A>|<xref:System.ServiceModel.Security.WindowsClientCredential> を返します|Windows クライアントの資格情報 \(Kerberos 資格情報\) を表します。このクラスのプロパティは読み取り専用です。|  
+  
+#### 構成での \<clientCredentials\> 値の設定  
+ エンドポイントの動作を使用して、[\<clientCredentials\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcredentials.md) 要素の子要素として資格情報の値を指定します。使用される要素は、クライアントの資格情報の種類によって異なります。たとえば、次の例は、\<[\<clientCertificate\>](../../../docs/framework/configure-apps/file-schema/wcf/clientcertificate-of-clientcredentials-element.md) 要素を使用して X.509 証明書を設定する構成を示しています。  
+  
+```  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <endpointBehaviors>  
+        <behavior name="myEndpointBehavior">  
+          <clientCredentials>  
+            <clientCertificate findvalue="myMachineName"   
+            storeLocation="Current" X509FindType="FindBySubjectName" />  
+          </clientCredentials>  
+        </behavior>              
+    </behaviors>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+ 構成でクライアント資格情報を設定するには、構成ファイルに [\<endpointBehaviors\>](../../../docs/framework/configure-apps/file-schema/wcf/endpointbehaviors.md) 要素を追加します。さらに、次の例に示すように、[\<endpoint\>](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017) 要素の `behaviorConfiguration` 属性を使用して、追加した動作要素をサービスのエンドポイントにリンクする必要があります。`behaviorConfiguration` 属性の値は、動作の `name` 属性の値と一致する必要があります。  
+  
+ `<configuration>`  
+  
+ `<system.serviceModel>`  
+  
+ `<client>`  
+  
+ `<endpoint address="http://localhost/servicemodelsamples/service.svc"`  
+  
+ `binding="wsHttpBinding"`  
+  
+ `bindingConfiguration="Binding1"`  
+  
+ `behaviorConfiguration="myEndpointBehavior"`  
+  
+ `contract="Microsoft.ServiceModel.Samples.ICalculator" />`  
+  
+ `</client>`  
+  
+ `</system.serviceModel>`  
+  
+ `</configuration>`  
+  
+> [!NOTE]
+>  クライアント資格情報の値の中には、アプリケーション構成ファイルを使用して設定できないものがあります \(ユーザー名とパスワードや、Windows ユーザーとパスワードの値など\)。このような資格情報の値は、コードでのみ指定できます。  
+  
+ クライアント資格情報を設定する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法 : クライアントの資格情報の値を指定する](../../../docs/framework/wcf/how-to-specify-client-credential-values.md)」を参照してください。  
+  
+> [!NOTE]
+>  次の構成例に示すように、`SecurityMode` が `"TransportWithMessageCredential"` に設定されている場合、`ClientCredentialType` は無視されます。  
+  
+```  
+<wsHttpBinding>  
+    <binding name="PingBinding">  
+        <security mode="TransportWithMessageCredential"  >  
+           <message  clientCredentialType="UserName"   
+               establishSecurityContext="false"    
+               negotiateServiceCredential="false" />  
+           <transport clientCredentialType="Certificate"  />  
+         </security>  
+    </binding>  
+</wsHttpBinding>  
+```  
+  
+## 参照  
+ <xref:System.ServiceModel.ClientBase%601.ClientCredentials%2A>   
+ <xref:System.ServiceModel.ClientBase%601>   
+ <xref:System.ServiceModel.Description.ClientCredentials>   
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetEnabled%2A>   
+ <xref:System.ServiceModel.Description.ServiceMetadataBehavior.HttpsGetUrl%2A>   
+ [\<bindings\>](../../../docs/framework/configure-apps/file-schema/wcf/bindings.md)   
+ [構成エディター ツール \(SvcConfigEditor.exe\)](../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)   
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)   
+ [WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/accessing-services-using-a-wcf-client.md)   
+ [方法 : クライアントの資格情報の値を指定する](../../../docs/framework/wcf/how-to-specify-client-credential-values.md)   
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)   
+ [方法 : クライアントの資格情報の種類を指定する](../../../docs/framework/wcf/how-to-specify-the-client-credential-type.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/securing-services.md b/docs/framework/wcf/securing-services.md
new file mode 100644
index 00000000000..b4d2090cb83
--- /dev/null
+++ b/docs/framework/wcf/securing-services.md
@@ -0,0 +1,125 @@
+---
+title: "サービスのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "構成 [WCF], サービスのセキュリティ保護"
+  - "WCF セキュリティ"
+  - "WCF, セキュリティ"
+ms.assetid: f0ecc6f7-f4b5-42a4-9cb1-b02e28e26620
+caps.latest.revision: 28
+author: "BrucePerlerMS"
+ms.author: "bruceper"
+manager: "mbaldwin"
+caps.handback.revision: 28
+---
+# サービスのセキュリティ保護
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスのセキュリティは、転送セキュリティと承認という 2 つの主要要件で構成されます \(3 番目の要件であるセキュリティ イベントの監査については、「[監査](../../../docs/framework/wcf/feature-details/auditing-security-events.md)」を参照してください\)。 簡単に説明すると、転送セキュリティは、認証 \(サーバーとクライアント両方の ID の検証\)、機密性 \(メッセージの暗号化\)、および整合性 \(改ざんを検出するためのデジタル署名\) で構成されます。 承認は、たとえば、特権のあるユーザーだけがファイルを読み取ることができるなど、リソースへのアクセスを制御することです。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の機能を使用すれば、この 2 つの主要要件を簡単に実装できます。  
+  
+ <xref:System.ServiceModel.BasicHttpBinding> クラス \(または構成の [\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素\) を除き、すべての定義済みバインディングでは既定で転送セキュリティが有効になっています。 このセクションのトピックでは、2 つの基本的なシナリオ、インターネット インフォメーション サービス \(IIS\) でホストされるイントラネット サービス上で転送セキュリティと承認を実装するシナリオと、IIS でホストされるサービス上で転送セキュリティと承認を実装するシナリオについて説明します。  
+  
+> [!NOTE]
+>  Windows XP Home では、Windows 認証をサポートしていません。 このため、このシステムではサービスを実行しないでください。  
+  
+## セキュリティの基礎  
+ セキュリティは、*資格情報*に依存します。 資格情報は、エンティティが本物であることを証明します \(*エンティティ*には、個人、ソフトウェア プロセス、会社、および承認できるものすべてが当てはまります\)。 たとえば、サービスのクライアントが *ID* の*クレーム*を作成し、資格情報によってそのクレームを何らかの方法で証明します。 通常のシナリオでは、資格情報の交換が行われます。 最初に、サービスがその ID のクレームを作成し、資格情報を使用してクライアントにそのクレームを証明します。 次に、クライアントが ID のクレームを作成し、サービスに資格情報を提示します。 両方がお互いの資格情報を信頼した場合、*セキュリティで保護されたコンテキスト*を確立できます。このコンテキストでは、すべてのメッセージは機密性が保護された状態で交換され、すべてのメッセージはその整合性を保護するために署名されます。 サービスはクライアントの ID を確立した後で、クライアントの資格情報のクレームをグループの*ロール*または*メンバーシップ*に適合できます。 いずれの場合も、クライアントが属するロールまたはグループを使用して、サービスは、そのクライアントがロール特権またはグループ特権に基づいて限られた操作を実行することを*承認*します。  
+  
+## Windows セキュリティ機構  
+ クライアントとサービスのコンピューターが、両方がネットワークにログオンする必要がある Windows ドメインに存在する場合、資格情報は Windows インフラストラクチャによって提供されます。 この場合、コンピューターのユーザーがネットワークにログオンすると資格情報が確立されます。 ネットワーク上の各ユーザーおよび各コンピューターは、信頼されたユーザーおよびコンピューターの集合に属することを検証される必要があります。 Windows システムでは、このようなユーザーとコンピューターは、*セキュリティ プリンシパル*とも呼ばれます。  
+  
+ *Kerberos* コントローラーによるサポートがある Windows ドメインでは、Kerberos コントローラーは、チケットを各セキュリティ プリンシパルに付与することをベースにしたスキームを使用します。 コントローラーによって付与されたチケットは、システムの他のチケット付与システムによって信頼されます。 エンティティが何らかの操作を実行しようとしたり、コンピューター上のファイルやディレクトリなどの*リソース*にアクセスしようとしたりすると、その都度チケットの有効性が検査され、検査に合格した場合、プリンシパルに操作用の別のチケットが付与されます。 このチケットの付与方法は、操作ごとにプリンシパルを検証する方法よりも効率的です。  
+  
+ Windows ドメインで従来より使用されている安全性が低い機構に、NT LAN Manager \(NTLM\) があります。 Kerberos を使用できない場合 \(通常、ワークグループなどの Windows ドメインの外部\)、代わりに NTLM を使用できます。 NTLM は、IIS のセキュリティ オプションとしても使用できます。  
+  
+ Windows システムでは、各コンピューターとユーザーにロールとグループのセットを割り当てることによって承認が機能します。 たとえば、各 Windows コンピューターは、*管理者*のロールに属するユーザー \(またはユーザー グループ\) がセットアップし、管理する必要があります。 もう 1 つのロールは、*ユーザー*のロールです。このロールのアクセス許可は、管理者ロールより制限されます。 ロール以外に、ユーザーはグループにも割り当てられます。 グループによって、複数のユーザーが同じロールで動作できます。 このため、実際 Windows コンピューターは、ユーザーをグループに割り当てることによって管理されます。 たとえば、複数のユーザーをコンピューターのユーザー グループに割り当て、限られた人数のユーザーを管理者グループに割り当てることができます。 ローカル コンピューターでは、管理者は新しいグループを作成して、他のユーザー \(または他のグループ\) をそのグループに割り当てることもできます。  
+  
+ Windows を実行しているコンピューターでは、ディレクトリの各フォルダーを保護できます。 つまり、フォルダーを選択して、そのフォルダーのファイルにアクセスできるユーザー、およびそのユーザーがファイルのコピー、ファイルの変更 \(最大限の特権が与えられている場合\)、ファイルの削除、またはフォルダーへのファイルの追加を実行できるかどうかを制御できます。 これは、アクセス制御と呼ばれ、その機構はアクセス制御リスト \(ACL\) と呼ばれます。 ACL を作成するとき、アクセス権を 1 つまたは複数のグループおよびドメインの個別のメンバーに割り当てることができます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] インフラストラクチャは、この Windows セキュリティ機構を使用するように設計されています。 したがって、イントラネットに展開するサービスを作成していて、そのクライアントを Windows ドメインのメンバーに限定する場合、セキュリティを簡単に実装できます。 有効なユーザーだけがドメインにログオンできます。 ログオン後、Kerberos コントローラーによって、各ユーザーは他のコンピューターまたはアプリケーションとの間にセキュリティで保護されたコンテキストを確立できます。 ローカル コンピューターでは、グループを簡単に作成でき、特定のフォルダーを保護する場合、そのグループを使用してローカル コンピューター上でアクセス権を割り当てることができます。  
+  
+## イントラネット サービスでの Windows セキュリティの実装  
+ Windows ドメインでのみ実行するアプリケーションをセキュリティで保護するには、<xref:System.ServiceModel.WSHttpBinding> または <xref:System.ServiceModel.NetTcpBinding> バインディングの既定のセキュリティ設定を使用できます。 既定では、同じ Windows ドメインに存在するすべてのユーザーが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスにアクセスできます。 ドメイン内にいるユーザーは、ネットワークにログオン済みなので信頼できます。 サービスとクライアントの間で交換されるメッセージは、機密性を保護するために暗号化され、整合性を保護するために署名されます。 Windows セキュリティを使用するサービスの作成方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : Windows 資格情報でサービスをセキュリティで保護する](../../../docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md)」を参照してください。  
+  
+### PrincipalPermissionAttribute クラスを使用した承認  
+ コンピューター上のリソースへのアクセスを制限する必要がある場合、最も簡単な方法は <xref:System.Security.Permissions.PrincipalPermissionAttribute> クラスを使用することです。 この属性を使用すると、ユーザーが指定の Windows グループまたはロールに属しているか、特定のユーザーであることを要求して、サービス操作の呼び出しを制限できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)。  
+  
+### 偽装  
+ 偽装は、リソース アクセスの制御に使用できるもう 1 つの機構です。 既定では、IIS でホストされるサービスは、ASPNET アカウントの ID で実行されます。 ASPNET アカウントは、アクセス許可のあるリソースにだけアクセスできます。 ただし、ASPNET サービス アカウントを除外し、他の特定の ID によるフォルダーへのアクセスを許可するように ACL を設定できます。 ここで問題となるのが、ASPNET アカウントがフォルダーにアクセスできない場合に、他のユーザーがフォルダーにアクセスできるようにする方法です。 これは、偽装を使用することで解決できます。偽装によって、サービスは特定のリソースにアクセスするためにクライアントの資格情報を使用できます。 もう 1 つの例は、特定のユーザーだけがアクセス許可を持つ SQL Server データベースにアクセスする場合です。 偽装の使用の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : サービスでクライアントに偽装する](../../../docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md)」および「[委任と偽装](../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)」を参照してください。  
+  
+## インターネット上のセキュリティ  
+ インターネット上のセキュリティは、イントラネット上のセキュリティと同じ要件で構成されます。 サービスは、信頼性を証明するために資格情報を提示する必要があり、クライアントは、サービスに対して ID を証明する必要があります。 クライアントの ID が証明されると、サービスは、クライアントによるリソースへのアクセスを制御できます。 ただし、インターネットではさまざまな種類が混在しているので、提示される資格情報は、Windows ドメインで使用される資格情報とは異なります。 Kerberos コントローラーが資格情報のチケットを使用して、ドメインでユーザーの認証を処理するのに対し、インターネットでは、サービスとクライアントは、資格情報を提示するための複数の異なる方法のいずれかに依存します。 なお、このトピックの目的は、インターネット上でアクセスできる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを作成するための一般的な方法を示すことです。  
+  
+### IIS と ASP.NET の使用  
+ インターネット セキュリティの要件、およびその問題を解決するための機構は、新しいものではありません。 IIS は、マイクロソフトのインターネット用 Web サーバーですが、この問題に対応するためのセキュリティ機能が多数用意されています。さらに、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] には、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスが使用できるセキュリティ機能が用意されています。 これらのセキュリティ機能を活用するには、IIS で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストします。  
+  
+#### ASP.NET メンバーシップとロール プロバイダーの使用  
+ ASP.NET には、メンバーシップとロール プロバイダーが用意されています。 プロバイダーは、呼び出し元を認証するためのユーザー名とパスワードの組み合わせのデータベースであり、これによって、各呼び出し元のアクセス特権を指定することもできます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、構成を通して既存のメンバーシップとロール プロバイダーを容易に使用することができます。 この機能を示すサンプル アプリケーションについては、「[メンバーシップとロール プロバイダー](../../../docs/framework/wcf/samples/membership-and-role-provider.md)」のサンプルを参照してください。  
+  
+### IIS で使用する資格情報  
+ Kerberos コントローラーによるサポートがある Windows ドメインとは異なり、インターネットには、随時ログオンしている多数のユーザーを管理するための共通のコントローラーがありません。 代わりに、インターネットの資格情報は、ほとんどの場合、X.509 証明書 \(SSL \(Secure Sockets Layer\) 証明書とも呼ばれる\) の形で提示されます。 この証明書は、通常、*証明機関*によって発行されます。この証明機関は、証明書の信頼性を保証するサードパーティの企業および証明書が発行された個人です。 インターネット上にサービスを公開するには、このような信頼された証明書を提供して、サービスを認証する必要があります。  
+  
+ それでは、どのように信頼された証明書を取得するのでしょうか。 その方法の 1 つは、サービスを展開する準備とそのサービスの証明書を購入する準備ができたら、Authenticode、VeriSign などのサードパーティ証明機関に連絡する方法です。 ただし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の開発フェーズにおいて証明書を購入する準備ができていなくても、稼働環境への展開のシミュレーションに使用できる X.509 証明書を作成するためのツールと方法が用意されています。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [証明書の使用](../../../docs/framework/wcf/feature-details/working-with-certificates.md)。  
+  
+## セキュリティ モード  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のセキュリティをプログラムする際には、いくつか重要な決定を行う必要があります。 最も基本的な決定の 1 つは、*セキュリティ モード*を選択することです。 2 つの主要なセキュリティ モードとして、*トランスポート モード*と*メッセージ モード*があります。  
+  
+ 3 番目のモードは、2 つの主要モードのセマンティクスを組み合わせたもので、*メッセージ資格情報付きトランスポート モード*です。  
+  
+ セキュリティ モードによって、メッセージをセキュリティで保護する方法が決まります。それぞれのモードには、次に示す利点と欠点があります。 セキュリティ モードの設定の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : セキュリティ モードを設定する](../../../docs/framework/wcf/how-to-set-the-security-mode.md)」を参照してください。  
+  
+#### トランスポート モード  
+ ネットワークとアプリケーションの間には複数の層があります。 この層の 1 つが*トランスポート*層で、エンドポイント間のメッセージ転送を管理します。 現時点では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は複数のトランスポート プロトコルを使用し、各プロトコルによってメッセージの転送をセキュリティで保護できるということをだけを理解しておいてください  \(トランスポートの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[トランスポート](../../../docs/framework/wcf/feature-details/transports.md)」を参照してください\)。  
+  
+ 一般的に使用されるプロトコルは HTTP ですが、その他にも TCP があります。 この各プロトコルは、プロトコルに固有の機構によってメッセージ転送をセキュリティで保護できます。 たとえば、HTTP プロトコルは SSL over HTTP \(一般的に "HTTPS" と省略される\) を使用してセキュリティで保護されます。 そのため、セキュリティのトランスポート モードを選択するときは、同時に、プロトコルによって指定された機構の使用を選択することになります。 たとえば、<xref:System.ServiceModel.WSHttpBinding> クラスを選択し、そのセキュリティ モードをトランスポートに設定した場合、セキュリティ機構として SSL over HTTP \(HTTPS\) を選択することになります。 トランスポート モードの利点は、セキュリティが比較的低いレベルで統合されるので、メッセージ モードよりも効率的であるという点です。 トランスポート モードを使用するとき、トランスポートの仕様に基づいてセキュリティ機構を実装する必要があります。これによって、トランスポートを経由した Point\-to\-Point からのみメッセージを安全にフローできます。  
+  
+#### メッセージ モード  
+ 一方、メッセージ モードでは、セキュリティ データを各メッセージの一部として追加することによってセキュリティを提供します。 XML および SOAP のセキュリティ ヘッダーを使用して、メッセージの整合性と機密性を確保するために必要な資格情報とその他のデータを各メッセージに追加します。 各メッセージにはセキュリティ データが追加され、各メッセージを個別に処理する必要があるので、パフォーマンスが犠牲になります  \(トランスポート モードでは、トランスポート層がセキュリティで保護されると、すべてのメッセージが自由にフローします\)。 ただし、メッセージ セキュリティには、トランスポート セキュリティに勝る利点が 1 つあります。それは、より柔軟であるという点です。 つまり、セキュリティ要件はトランスポートによって決定されません。 メッセージをセキュリティで保護するために、任意の種類のクライアント資格情報を使用できます  \(トランスポート モードでは、トランスポート プロトコルによって、使用できるクライアント資格情報の種類が決まります\)。  
+  
+#### メッセージ資格情報付きトランスポート  
+ 3 番目のモードは、トランスポート セキュリティとメッセージ セキュリティの利点を組み合わせています。 このモードでは、トランスポート セキュリティを使用して、各メッセージの機密性と整合性を効率的に確保できます。 同時に、各メッセージには、その資格情報データが追加されるので、メッセージを認証できます。 認証と共に、承認も実装できます。 送信者を認証することによって、送信者の ID に応じてリソースへのアクセスが許可または拒否されます。  
+  
+## クライアント資格情報の種類と資格情報の値の指定  
+ セキュリティ モードを選択した後で、必要に応じて、クライアント資格情報の種類を指定することもできます。 クライアント資格情報の種類では、サービスでの認証時にクライアントが使用する必要がある種類を指定します。  
+  
+ ただし、すべてのシナリオにクライアント資格情報の種類が必要とは限りません。 SSL over HTTP \(HTTPS\) を使用して、サービスはクライアントに対して認証を行います。 この認証の一部として、*ネゴシエーション*と呼ばれるプロセスで、サービスの証明書がクライアントに送信されます。 SSL によってセキュリティで保護されたトランスポートによって、すべてのメッセージの機密性が確保されます。  
+  
+ クライアントの認証が必要なサービスを作成している場合、クライアント資格情報の種類の選択肢は、選択したトランスポートとモードによって異なります。 たとえば、HTTP トランスポートを使用して、トランスポート モードを選択する場合、基本、ダイジェストなどのいくつかの選択肢があります \(これらの資格情報の種類の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[HTTP 認証の理解](../../../docs/framework/wcf/feature-details/understanding-http-authentication.md)」を参照してください\)。  
+  
+ Windows ドメインで、そのネットワークの他のユーザーだけが利用できるサービスを作成している場合、最も使いやすいのは、Windows クライアント資格情報の種類です。 ただし、場合によっては、サービスにも証明書を提供する必要があります。 詳細については、「[方法 : クライアントの資格情報の値を指定する](../../../docs/framework/wcf/how-to-specify-client-credential-values.md)」を参照してください。  
+  
+#### 資格情報の値  
+ *資格情報の値*とは、サービスが使用する実際の資格情報です。 資格情報の種類を指定したら、サービスを実際の資格情報で構成する必要があります。 Windows を選択し、サービスを Windows ドメインで実行する場合は、実際の資格情報の値を指定しません。  
+  
+## 同一。  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、*ID* という用語はサーバーとクライアントで意味が異なります。 つまり、サービスを実行しているとき、ID は認証後にセキュリティ コンテキストに割り当てられます。 実際の ID を表示するには、<xref:System.ServiceModel.ServiceSecurityContext.WindowsIdentity%2A> クラスの <xref:System.ServiceModel.ServiceSecurityContext.PrimaryIdentity%2A> プロパティと <xref:System.ServiceModel.ServiceSecurityContext> プロパティを確認します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : セキュリティ コンテキストを調べる](../../../docs/framework/wcf/how-to-examine-the-security-context.md)。  
+  
+ 反対に、クライアントでは、ID はサービスを検証するために使用されます。 設計時に、クライアント開発者は [\<identity\>](../../../docs/framework/configure-apps/file-schema/wcf/identity.md) 要素をサービスから取得した値に設定できます。 実行時に、クライアントは、要素の値をサービスの実際の ID と照合してチェックします。 チェックが失敗した場合、クライアントは通信を終了します。 特定のユーザー ID でサービスを実行している場合の値はユーザー プリンシパル名 \(UPN\) で、コンピューター アカウントでサービスを実行している場合の値はサービス プリンシパル名 \(SPN\) です。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [サービス ID と認証](../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)。 資格情報には、証明書、つまり証明書を識別する証明書内のフィールドも使用できます。  
+  
+## 保護レベル  
+ `ProtectionLevel` プロパティは、<xref:System.ServiceModel.ServiceContractAttribute> クラス、<xref:System.ServiceModel.OperationContractAttribute> クラスなどのいくつかの属性クラスで使用します。 保護レベルは、サービスをサポートするメッセージ \(またはメッセージ部分\) が署名されるのか、署名および暗号化されるのか、または署名と暗号化なしで送信されるのかを指定する値です。 プロパティの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。プログラミング例については、「[方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)」を参照してください。 コンテキストで `ProtectionLevel` を使用してサービス コントラクトを設計する方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ServiceModel>   
+ <xref:System.ServiceModel.Description.ServiceCredentials>   
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ [サービス ID と認証](../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)   
+ [委任と偽装](../../../docs/framework/wcf/feature-details/delegation-and-impersonation-with-wcf.md)   
+ [サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)   
+ [セキュリティ](../../../docs/framework/wcf/feature-details/security.md)   
+ [セキュリティの概要](../../../docs/framework/wcf/feature-details/security-overview.md)   
+ [方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)   
+ [方法 : Windows 資格情報でサービスをセキュリティで保護する](../../../docs/framework/wcf/how-to-secure-a-service-with-windows-credentials.md)   
+ [方法 : セキュリティ モードを設定する](../../../docs/framework/wcf/how-to-set-the-security-mode.md)   
+ [方法 : クライアントの資格情報の種類を指定する](../../../docs/framework/wcf/how-to-specify-the-client-credential-type.md)   
+ [方法 : PrincipalPermissionAttribute クラスでアクセスを制限する](../../../docs/framework/wcf/how-to-restrict-access-with-the-principalpermissionattribute-class.md)   
+ [方法 : サービスでクライアントに偽装する](../../../docs/framework/wcf/how-to-impersonate-a-client-on-a-service.md)   
+ [方法 : セキュリティ コンテキストを調べる](../../../docs/framework/wcf/how-to-examine-the-security-context.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/sending-and-receiving-faults.md b/docs/framework/wcf/sending-and-receiving-faults.md
new file mode 100644
index 00000000000..f361b36a604
--- /dev/null
+++ b/docs/framework/wcf/sending-and-receiving-faults.md
@@ -0,0 +1,116 @@
+---
+title: "エラーの送受信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エラーの処理 [WCF], 送信"
+ms.assetid: 7be6fb96-ce2a-450b-aebe-f932c6a4bc5d
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# エラーの送受信
+SOAP エラーは、エラー状態情報をサービスからクライアントに伝達します。双方向通信の場合は、相互運用可能な方法でクライアントからサービスにも伝達します。通常、サービスは、カスタムのエラー コンテンツを定義し、そのエラー コンテンツを返すことができる操作を指定します \(詳細については、「[エラーの定義と指定](../../../docs/framework/wcf/defining-and-specifying-faults.md)」を参照してください\)。ここでは、対応するエラー状態が発生したときにサービスまたは双方向クライアントがエラーを送信する方法、およびクライアントまたはサービス アプリケーションがエラーを処理する方法について説明します。[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでのエラー処理の概要については、「[コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)」を参照してください。  
+  
+## SOAP エラーの送信  
+ 宣言された SOAP エラーは、カスタム SOAP エラーの種類を指定する <xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName> を含む操作で発生します。宣言されていない SOAP エラーとは、操作のコントラクトに指定されていないエラーです。  
+  
+### 宣言されたエラーの送信  
+ 宣言された SOAP エラーを送信するには、SOAP エラーに該当するエラー状態を検出し、新しい <xref:System.ServiceModel.FaultException%601?displayProperty=fullName> をスローします。この場合、型パラメーターは、その操作の <xref:System.ServiceModel.FaultContractAttribute> に指定されている型の新しいオブジェクトです。次のコード例は、`SampleMethod` 操作で `GreetingFault` の詳細な型と共に SOAP エラーを返すことができることを指定するために、<xref:System.ServiceModel.FaultContractAttribute> を使用しています。  
+  
+ [!code-csharp[FaultContractAttribute#4](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/services.cs#4)]
+ [!code-vb[FaultContractAttribute#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/services.vb#4)]  
+  
+ `GreetingFault` エラー情報をクライアントに伝達するには、適切なエラー状態をキャッチし、次のコード例に示すように、新しい `GreetingFault` オブジェクトを引数として使用して `GreetingFault` 型の新しい <xref:System.ServiceModel.FaultException%601?displayProperty=fullName> をスローします。クライアントが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント アプリケーションの場合、これはマネージ例外として認識されます。この場合の型は、`GreetingFault` 型の <xref:System.ServiceModel.FaultException%601?displayProperty=fullName> です。  
+  
+ [!code-csharp[FaultContractAttribute#5](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/services.cs#5)]
+ [!code-vb[FaultContractAttribute#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/services.vb#5)]  
+  
+### 宣言されていないエラーの送信  
+ 宣言されていないエラーを送信すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの問題をすばやく診断してデバッグできます。これは非常に便利ですが、デバッグ ツールとしての有用性は制限されています。一般的に、デバッグ時には <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティを使用することをお勧めします。この値を true に設定すると、クライアントはこのエラーを <xref:System.ServiceModel.ExceptionDetail> 型の <xref:System.ServiceModel.FaultException%601> 例外として認識します。  
+  
+> [!IMPORTANT]
+>  マネージ例外が内部アプリケーション情報を開示する可能性があるので、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> または <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> を `true` に設定すると、個人の身元を確認できる情報またはその他の機密情報を含む内部サービス操作例外に関する情報を [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントで取得できます。  
+>   
+>  したがって、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> または <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> を `true` に設定することは、サービス アプリケーションを一時的にデバッグする方法としてのみお勧めできます。さらに、このようにして未処理のマネージ例外を返すメソッドの WSDL には、<xref:System.ServiceModel.ExceptionDetail> 型の <xref:System.ServiceModel.FaultException%601> のコントラクトが含まれません。クライアントは、デバッグ情報を適切に取得するために、\(<xref:System.ServiceModel.FaultException?displayProperty=fullName> オブジェクトとして [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントに返される\) 不明な SOAP エラーの可能性について想定しておく必要があります。  
+  
+ 宣言されていない SOAP エラーを送信するには、<xref:System.ServiceModel.FaultException?displayProperty=fullName> \(つまり、ジェネリック型の <xref:System.ServiceModel.FaultException%601> でない\) オブジェクトをスローし、文字列をコンストラクターに渡します。これは、スローされた <xref:System.ServiceModel.FaultException?displayProperty=fullName> 例外として [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント アプリケーションに公開されるため、<xref:System.ServiceModel.FaultException%601.ToString%2A?displayProperty=fullName> メソッドを呼び出して文字列を使用できます。  
+  
+> [!NOTE]
+>  文字列型の SOAP エラーを宣言し、これを型パラメーターが <xref:System.String?displayProperty=fullName> の <xref:System.ServiceModel.FaultException%601> としてサービス内でスローすると、文字列値が <xref:System.ServiceModel.FaultException%601.Detail%2A?displayProperty=fullName> プロパティに割り当てられるため、<xref:System.ServiceModel.FaultException%601.ToString%2A?displayProperty=fullName> から使用できません。  
+  
+## エラーの処理  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントでは、クライアント アプリケーションに関係する通信中の SOAP エラーは、マネージ例外として発生します。プログラムの実行中にはさまざまな例外が発生する可能性がありますが、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント プログラミング モデルを使用するアプリケーションは、通信の結果として、次の 2 種類の例外を処理できます。  
+  
+-   <xref:System.TimeoutException>  
+  
+-   <xref:System.ServiceModel.CommunicationException>  
+  
+ <xref:System.TimeoutException> オブジェクトは、操作が、指定されたタイムアウト期間を超えた場合にスローされます。  
+  
+ <xref:System.ServiceModel.CommunicationException> オブジェクトは、回復可能な通信エラー状態がサービスまたはクライアントで発生した場合にスローされます。  
+  
+ <xref:System.ServiceModel.CommunicationException> クラスには、<xref:System.ServiceModel.FaultException> および一般的な <xref:System.ServiceModel.FaultException%601> 型という 2 つの重要な派生型があります。  
+  
+ <xref:System.ServiceModel.FaultException> 例外は、予期しないエラーまたは操作コントラクト内に指定されていないエラーをリスナーが受信した場合にスローされます。この例外は、通常、サービスの <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティを `true` に設定してアプリケーションをデバッグしている場合に発生します。  
+  
+ <xref:System.ServiceModel.FaultException%601> 例外は、操作コントラクト内に指定されたエラーが、双方向操作 \(つまり、<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A> に `false` が設定されている <xref:System.ServiceModel.OperationContractAttribute> 属性を持つメソッド\) への応答で受信された場合に、クライアントでスローされます。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの <xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティまたは <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティが `true` に設定されている場合、クライアントは、この例外を <xref:System.ServiceModel.ExceptionDetail> 型の宣言されていない <xref:System.ServiceModel.FaultException%601> として認識します。クライアントは、この特定のエラーをキャッチするか、<xref:System.ServiceModel.FaultException> の catch ブロックで処理できます。  
+  
+ 通常、クライアントとサービスには、<xref:System.ServiceModel.FaultException%601>、<xref:System.TimeoutException>、および <xref:System.ServiceModel.CommunicationException> の各例外だけが関係します。  
+  
+> [!NOTE]
+>  上記以外の例外も発生します。予期しない例外には <xref:System.OutOfMemoryException?displayProperty=fullName> のような致命的なエラーも含まれますが、通常、アプリケーションでは、このようなメソッドをキャッチしません。  
+  
+### 正しい順序でエラー例外をキャッチする  
+ <xref:System.ServiceModel.FaultException%601> は <xref:System.ServiceModel.FaultException> から派生します。また、<xref:System.ServiceModel.FaultException> は <xref:System.ServiceModel.CommunicationException> からも派生します。したがって、これらの例外を正しい順序でキャッチすることが重要になります。たとえば、try\/catch ブロックで最初に <xref:System.ServiceModel.CommunicationException> がキャッチされたとします。その場合、すべての SOAP エラー \(指定されている SOAP エラーおよび指定されていない SOAP エラー\) はそこで処理され、カスタムの <xref:System.ServiceModel.FaultException%601> 例外を処理する後続の catch ブロックは呼び出されません。  
+  
+ 指定した例外が 1 つの操作から複数返される場合があることに注意してください。その場合は、エラーごとに型が異なるため、個別に処理する必要があります。  
+  
+### チャネルを閉じるときに例外を処理する  
+ これまでの説明のほとんどは、アプリケーション メッセージの処理の過程で送信されるエラー \(つまり、クライアント アプリケーションが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトの操作を呼び出す際に、クライアントによって明示的に送信されるメッセージ\) に関するものでした。  
+  
+ ローカル オブジェクトでも、オブジェクトを破棄すると、リサイクル プロセスで起こる例外が発生したり、マスクされたりする場合があります。同様のことは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを使用する際にも発生します。操作を呼び出すと、既に確立されている接続を通じてメッセージが送信されます。また、チャネルを閉じると、すべての操作が正常に返されたとしても、接続を完全に閉じることができなかったり、接続が既に閉じたりしている場合には、例外がスローされる可能性があります。  
+  
+ 通常、クライアント オブジェクトのチャネルは、次のいずれかが発生すると閉じられます。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトがリサイクルされるとき。  
+  
+-   クライアント アプリケーションが <xref:System.ServiceModel.ClientBase%601.Close%2A?displayProperty=fullName> を呼び出すとき。  
+  
+-   クライアント アプリケーションが <xref:System.ServiceModel.ICommunicationObject.Close%2A?displayProperty=fullName> を呼び出すとき。  
+  
+-   クライアント アプリケーションが、セッションの終了操作となる操作を呼び出すとき。  
+  
+ いずれの場合でも、チャネルを閉じると、アプリケーション レベルで複雑な機能をサポートするためにメッセージを送信している可能性がある基になるチャネルをすべて閉じる操作を開始するように、チャネルに通知されます。たとえば、コントラクトがセッションを要求している場合、バインディングは、セッションが確立されるまでサービス チャネルとメッセージを交換してセッションを確立しようとします。チャネルが閉じられると、基になるセッション チャネルは、セッションが終了したことをサービスに通知します。この場合、チャネルが既に中止されたり閉じられたりしている、または使用できない \(たとえば、ネットワーク ケーブルが外れている\) ときには、クライアント チャネルはサービス チャネルに対し、セッションが終了し例外が発生する可能性があることを通知できません。  
+  
+### 必要に応じてチャネルを中止する  
+ チャネルを閉じると例外がスローされる可能性があるため、正しい順序でエラー状態をキャッチするだけでなく、呼び出しに使用されたチャネルを catch ブロックで中止することが重要です。  
+  
+ エラーによって操作に固有のエラー情報が伝えられた場合、他のユーザーがそのエラー情報を使用できるときはチャネルを中止する必要はありません \(ただし、このような状況は非常にまれです\)。それ以外の場合は、チャネルを中止することをお勧めします。これらの点をすべて示すサンプルについては、「[予期される例外](../../../docs/framework/wcf/samples/expected-exceptions.md)」を参照してください。  
+  
+ 次のコード例は、基本的なクライアント アプリケーションで、宣言されたエラーと宣言されていないエラーを含む SOAP エラー例外を処理する方法を示しています。  
+  
+> [!NOTE]
+>  このサンプル コードは、`using` コンストラクトを使用していません。チャネルを閉じると例外が発生する可能性があるため、まず [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントをアプリケーションで作成し、その [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を同じ try ブロックで開いて使用してから、閉じることをお勧めします。詳細については、「[WCF クライアントの概要](../../../docs/framework/wcf/wcf-client-overview.md)」および「[Using ステートメントに関する問題の回避](../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)」を参照してください。  
+  
+ [!code-csharp[FaultContractAttribute#3](../../../samples/snippets/csharp/VS_Snippets_CFX/faultcontractattribute/cs/client.cs#3)]
+ [!code-vb[FaultContractAttribute#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/faultcontractattribute/vb/client.vb#3)]  
+  
+## 参照  
+ <xref:System.ServiceModel.FaultException>   
+ <xref:System.ServiceModel.FaultException%601>   
+ <xref:System.ServiceModel.CommunicationException?displayProperty=fullName>   
+ [予期される例外](../../../docs/framework/wcf/samples/expected-exceptions.md)   
+ [Using ステートメントに関する問題の回避](../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md b/docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md
new file mode 100644
index 00000000000..28f2f6a8188
--- /dev/null
+++ b/docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md
@@ -0,0 +1,466 @@
+---
+title: "サービス トレース ビューアー ツール (SvcTraceViewer.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 9027efd3-df8d-47ed-8bcd-f53d55ed803c
+caps.latest.revision: 55
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 55
+---
+# サービス トレース ビューアー ツール (SvcTraceViewer.exe)
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のサービス トレース ビューアー ツールは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によって生成される診断トレースの分析に役立ちます。サービス トレース ビューアーを使用すると、ログのトレース メッセージを容易にマージ、表示、およびフィルター処理できるため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの問題を診断、修復、および検証できます。  
+  
+## トレースの構成  
+ 診断トレースは、アプリケーションの操作で発生している内容を示す情報を提供します。名前が示すように、操作を開始点から中間点を通過して終了点まで追跡できます。  
+  
+ アプリケーションの構成ファイル \(Web ホスト型アプリケーションの場合は Web.config、自己ホスト型アプリケーションの場合は *Appname*.config\) を使用してトレースを構成できます。例を次に示します。  
+  
+```  
+<system.diagnostics>  
+    <trace autoflush="true" />  
+    <sources>  
+            <source name="System.ServiceModel"   
+                    switchValue="Information, ActivityTracing"  
+                    propagateActivity="true">  
+            <listeners>  
+               <add name="sdt"   
+                   type="System.Diagnostics.XmlWriterTraceListener"   
+                   initializeData= "SdrConfigExample.e2e" />  
+            </listeners>  
+         </source>  
+    </sources>  
+</system.diagnostics>  
+  
+```  
+  
+ この例では、トレース リスナーの名前と種類が指定されています。リスナーに `sdt` という名前を付け、使用する種類として標準の .NET Framework トレース リスナー \(System.Diagnostics.XmlWriterTraceListener\) を追加しています。このリスナーのログ ファイルの名前を `SdrConfigExample.e2e` に設定するために、`initializeData` 属性が使用されています。ログ ファイルは、単純なファイル名と完全修飾パスを置き換えることができます。  
+  
+ この例では、SdrConfigExample.e2e という名前のルート ディレクトリにファイルが作成されています。「WCF トレース ファイルを開いて表示する」セクションの説明に従いトレース ビューアーを使用してファイルを開くと、送信済みのメッセージがすべて表示されます。  
+  
+ トレース レベルは `switchValue` 設定で制御します。使用できるトレース レベルを次の表に示します。  
+  
+|トレース レベル|説明|  
+|--------------|--------|  
+|Critical|-   フェイルファースト、イベント ログ エントリ、およびトレース相関情報をログに記録します。Critical レベルを使用する可能性が高い場合の例を次に示します。<br />-   AppDomain が未処理の例外のためにダウンする。<br />-   アプリケーションが開始に失敗する。<br />-   エラーを示すメッセージが MyApp.exe プロセスから発生する。|  
+|Error|-   すべての例外をログに記録します。Error レベルは、次のような場合に使用できます。<br />-   無効なキャスト例外のために、コードがクラッシュする。<br />-   "エンドポイントの作成に失敗しました" という例外によって、アプリケーションが起動時に失敗する。|  
+|Warning|-   後続の処理でエラーまたは重大なエラーが起こる可能性のある状態が存在します。このレベルは次のような場合に使用できます。<br />-   アプリケーションが、調整設定の範囲を超えた要求数を受信している。<br />-   受信側キューが、構成された容量の 98% である。|  
+|Information|-   システム ステータスの監視と診断、パフォーマンスの計測、またはプロファイリングに有用なメッセージが生成されます。キャパシティ プランニングやパフォーマンス管理のためにこの情報を利用できます。このレベルは次のような場合に使用できます。<br />-   メッセージが AppDomain に到達して逆シリアル化された後に発生するエラー。<br />-   HTTP バインディングの作成中に発生するエラー。|  
+|Verbose|-   ユーザー コードとサービスの両方に対するデバッグレベルのトレース。このレベルは次のような場合に設定します。<br />-   エラーの発生時に呼び出されたコード中のメソッドを特定できない。<br />-   不正なエンドポイントが構成されているために、予約ストアのエントリがロックされて、サービスの開始が失敗する。|  
+|ActivityTracing|処理アクティビティとコンポーネント間のフロー イベント。<br /><br /> このレベルを使用すると、管理者と開発者は同じアプリケーション ドメイン内のアプリケーションの相関関係を示すことができます。<br /><br /> -   アクティビティ境界のトレース : start\/stop。<br />-   転送のトレース。|  
+  
+ `add` を使用して、使用するトレース リスナーの名前と種類を指定できます。この例の構成では、リスナーに `sdt` という名前を付け、使用する種類として標準の .NET Framework トレース リスナー \(`System.Diagnostics.XmlWriterTraceListener`\) を追加しています。`initializeData` を使用して、そのリスナーのログ ファイルの名前を設定します。さらに、単純なファイル名の代わりに完全修飾パスを使用できます。  
+  
+## サービス トレース ビューアー ツールの使用  
+  
+### WCF トレース ファイルを開いて表示する  
+ サービス トレース ビューアーは、次の 3 種類のファイルをサポートします。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレース ファイル \(.svcLog\)  
+  
+-   イベント トレース ファイル \(.etl\)  
+  
+-   Crimson トレース ファイル  
+  
+ サービス トレース ビューアーを使用すると、サポートするトレース ファイルを開いたり、トレース ファイルを追加して統合したり、トレース ファイルのグループを同時に開いてマージすることができます。  
+  
+##### トレース ファイルを開くには  
+  
+1.  サービス トレース ビューアーを起動するには、コマンド ウィンドウで [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のインストール場所 \(C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\Bin\) に移動し、「`SvcTraceViewer.exe`」と入力します。  
+  
+> [!NOTE]
+>  サービス トレース ビューアー ツールは、2 種類のファイル .svclog と .stvproj を関連付けることができます。コマンド ラインで 2 つのパラメーターを使用して、ファイル拡張子を登録および登録解除することができます。  
+>   
+>  \/register: SvcTraceViewer.exe がファイル拡張 ".svclog" と ".stvproj" の関連付けを登録します。  
+>   
+>  \/unregister: SvcTraceViewer.exe への ".svclog" と ".stvproj" の関連付けの登録を解除します。  
+  
+1.  サービス トレース ビューアーを開始したら、**\[File\]** をクリックし、**\[Open\]** をポイントします。トレース ファイルが格納されている場所に移動します。  
+  
+2.  開くトレース ファイルをダブルクリックします。  
+  
+    > [!NOTE]
+    >  複数のトレース ファイルを同時に選択して開くには、Shift キーを押しながら、複数のトレース ファイルをクリックします。サービス トレース ビューアーは、すべてのファイルの内容をマージし、1 つのビューで表示します。たとえば、クライアントとサービスの両方のトレース ファイルを開くことができます。これは、構成でメッセージ ログとアクティビティ伝達を有効にしている場合に役立ちます。この方法では、クライアントとサービスのメッセージ交換を調べることができます。また、ビューアーに複数のファイルをドラッグしたり、**\[Project\]** タブを使用することもできます。詳細については、「プロジェクトの管理」を参照してください。  
+  
+3.  開いているコレクションに追加のトレース ファイルを追加するには、**\[File\]** をクリックし、**\[Add\]** をポイントします。開いているウィンドウで、トレース ファイルの場所に移動し、追加するファイルをダブルクリックします。  
+  
+> [!CAUTION]
+>  200 MB を超えるトレース ログ ファイルを読み込むことはお勧めできません。この制限を超えるファイルを読み込もうとすると、使用するコンピューター リソースによっては読み込みプロセスに時間がかかる場合があります。サービス トレース ビューアー ツールが長時間応答しない場合や、コンピューターのメモリを使い果たしてしまう場合があります。これを回避するには、部分読み込みを構成することをお勧めします。部分読み込みの方法の詳細については、「規模の大きいトレース ファイルの読み込み」セクションを参照してください。  
+  
+#### イベント トレースと Crimson トレース  
+ ビューアーのネイティブ形式は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] が出力するアクティビティ トレース形式です。別の形式で出力されるトレースは、ビューアーが表示する前に変換される必要があります。現在では、ビューアーはアクティビティ トレース形式の他に、イベント トレースと Crimson トレースをサポートします。  
+  
+ アクティビティ トレースを含まないファイルを開くと、ビューアーはそのファイルを変換しようとします。変換されるトレース データを含むファイルの名前と場所を指定する必要があります。データが変換されたら、ビューアーは新しいファイルの内容を表示します。  
+  
+> [!NOTE]
+>  変換には、変換後のトレース データを格納するためのディスク領域が必要です。変換を開始する前にデータを格納するための十分な空きディスク領域を確保してください。そうでない場合、変換は失敗します。  
+  
+### プロジェクトの管理  
+ ビューアーは、複数のトレース ファイルの表示を容易にするためにプロジェクトをサポートします。たとえば、クライアントとサービスの両方のトレース ファイルがある場合は、それらをプロジェクトに追加できます。追加したら、プロジェクトを開くたびに、プロジェクト内のすべてのトレース ファイルが同時に読み込まれます。  
+  
+ プロジェクトの管理には、次の 2 つの方法があります。  
+  
+-   **\[File\]** メニューで、プロジェクトを開いたり、保存したり、閉じたりできます。  
+  
+-   **\[Project\]** タグで、プロジェクトにファイルを追加できます。  
+  
+### WCF トレースの表示  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、アクティビティ トレース形式を使用してトレースを出力します。アクティビティ トレース モデルでは、各トレースはそれぞれの目的に従ってアクティビティにグループ化されます。論理制御フローは、アクティビティ間に転送されます。たとえば、アプリケーションの有効期間の間、多くの "メッセージ送信アクティビティ" が出現したり消えたりします。トレースとアクティビティの表示およびサービス トレース ビューアーのユーザー インターフェイスの詳細については、「[サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)」を参照してください。  
+  
+#### 別のビューへの切り替え  
+ サービス トレース ビューアーは、次の別のビューを提供します。これらのビューは、ビューアーの左ペインにタブとして表示され、**\[View\]** メニューからもアクセスできます。  
+  
+-   アクティビティ ビュー  
+  
+-   プロジェクト ビュー  
+  
+-   メッセージ ビュー  
+  
+-   グラフ ビュー  
+  
+##### アクティビティ ビュー  
+ トレース ファイルを開いたら、アクティビティにグループ化されたトレースと表示されたトレースを左ペインの **\[Activity\]** ビューで確認できます。  
+  
+ **\[Activity\]** ビューは、アクティビティ名、アクティビティ内のトレース数、期間、開始時刻と終了時刻を表示します。  
+  
+ 表示されたアクティビティのいずれかをクリックすると、そのアクティビティ内のトレースが右側のトレース ペインに表示されます。その詳細を表示するトレースを選択できます。  
+  
+ 複数のアクティビティを選択するには、**Ctrl** キーまたは **Shift** キーを押しながら、目的のアクティビティをクリックします。トレース ペインは、選択されたアクティビティのすべてのトレースを表示します。  
+  
+ アクティビティをダブルクリックすると、**\[Graph\]** ビューに表示されます。別の方法では、アクティビティを選択して **\[Graph\]** ビューに切り替えます。  
+  
+> [!NOTE]
+>  アクティビティ "000000000000" は、グラフ ビューに表示できない特別なアクティビティです。他のすべてのアクティビティがこの特別なアクティビティにリンクされているため、このアクティビティを表示すると、パフォーマンスに深刻な影響が生じます。  
+  
+ 列のタイトルをクリックすると、アクティビティ一覧が並べ替えられます。警告トレースを含むアクティビティは黄色の背景を持ち、エラー トレースを含むアクティビティは赤色の背景を持ちます。  
+  
+ さまざまな種類のアクティビティがあり、それぞれの種類は各アクティビティの左側にあるアイコンに対応します。それぞれのアイコンの意味については、「トレース アイコンの理解」セクションを参照してください。  
+  
+##### プロジェクト ビュー  
+ このビューを使用すると、現在のプロジェクトのトレース ファイルを管理できます。詳細については、「プロジェクトの管理」を参照してください。  
+  
+##### グラフ ビュー  
+ サービス トレース ビューアーの最も強力な機能の 1 つは、指定されたアクティビティのトレース データをグラフ形式で表示する **\[Graph\]** ビューです。グラフ形式を使用すると、イベントのステップ実行やデータが複数のアクティビティ間を移動するときのそれらの相互関係を確認できます。  
+  
+ **\[Graph\]** ビューに切り替えるには、**\[Activity\]** ビューでアクティビティを選択して **\[Activity\]** タブをクリックするか、**\[Message\]** ビューでメッセージ ログ トレースを選択します。複数のトレース ファイルが読み込まれ、アクティビティが複数のファイルのトレースに関係している場合は、関連するすべてのトレースがグラフ ビューに表示されます。アクティビティやメッセージ ログ トレースをダブルクリックすることでも、**\[Graph\]** ビューが表示されます。  
+  
+ **\[Graph\]** ビューでは、各垂直列はアクティビティを表し、列内の各ブロックはトレースを表します。アクティビティは、プロセス \(またはスレッド\) によってグループ化されます。アクティビティ間の小さな矢印は、転送を表します。プロセス間の大きな矢印は、メッセージ交換を表します。選択範囲のアクティビティは、常に黄色です。  
+  
+###### グラフでのトレースの選択  
+  
+1.  グラフ内のブロックをクリックします。  
+  
+2.  上方向キーや下方向キーを使用して、隣接するトレースを選択します。  
+  
+3.  トレース ペインや詳細ペインでトレース情報を確認します。  
+  
+###### アクティビティ転送の展開または折りたたみ  
+ 選択範囲のアクティビティが別のアクティビティに転送されるとき、アクティビティ転送を展開できます。展開によって、転送を追跡できます。  
+  
+ アクティビティ転送を展開または折りたたむには  
+  
+1.  転送アイコンの左側に "\+" 符号の付いた転送トレースを見つけます。  
+  
+2.  \[\+\] をクリックするか、キーボードの **Ctrl** \+ 正符号 \(\+\) キーを押します。  
+  
+3.  次のアクティビティが、グラフに表示されます。  
+  
+4.  転送アイコンの左側に "\-" 符号が表示されます。\[\-\] をクリックするか、キーボードの Ctrl \+ マイナス記号 \(\-\) キーを押すと、アクティビティ転送が折りたたまれます。  
+  
+> [!NOTE]
+>  アクティビティに複数の転送があるとき、転送の 1 つを展開すると、ルート アクティビティから新しいアクティビティまでのアクティビティが表示されます。これらの新しいアクティビティは、折りたたまれた形式で表示されます。これらのアクティビティの詳細を確認する場合は、グラフのヘッダーにある展開アイコンをクリックすると、これらのアクティビティが垂直方向に展開されます。  
+  
+###### 垂直方向へのアクティビティの展開または折りたたみ  
+ アクティビティを折りたたむと、ビューアーは、アクティビティ グラフで不要な詳細を非表示にします。折りたたまれたアクティビティでは、個々のトレースは表示されません。転送トレースだけが表示されます。アクティビティのすべてのトレースを表示する場合は、グラフのヘッダーにあるアクティビティの展開記号をクリックすると、アクティビティが垂直方向に展開されます。  
+  
+ アクティビティを垂直方向に展開または折りたたむには  
+  
+1.  アクティビティ ヘッダーの \[\+\] アイコンをクリックすると、アクティビティが垂直方向に展開されます。  
+  
+2.  すべてのトレースがグラフに表示されます。  
+  
+3.  アクティビティ ヘッダーの \[\-\] アイコンをクリックすると、アクティビティが垂直方向に折りたたまれます。  
+  
+4.  重要な転送、メッセージ ログ、警告トレース、および例外トレースだけがアクティビティに表示されます。  
+  
+###### オプション  
+ グラフ ビューの **\[Option\]** メニューから 2 つのオプションを選択できます。  
+  
+-   \[Show Activity Boundary Traces\] は、オフにすると、グラフでアクティビティ境界トレースが無視されます。  
+  
+-   \[Show Non\-message Verbose Traces\] は、オフにすると、メッセージ トレース以外の Verbose レベルのトレースが無視されます。ほとんどの場合、Verbose レベルのトレースは分析には重要ではありません。このオプションは、Verbose レベルのトレースを分析しないで、重要なトレースだけに絞る場合に役立ちます。  
+  
+###### レイアウト モード  
+ ビューアーには、**Process** と **Thread** の 2 つのレイアウト モードがあります。この設定は、組織の最も大きな単位を定義します。既定のレイアウト モードは、**Process** です。このモードは、アクティビティがグラフではプロセスによってグループ化されることを示します。  
+  
+###### 実行リスト  
+ グラフで表示されるプロセスまたはスレッドをこのドロップダウン リストから選択できます。たとえば、2 つ \(A と B\) のクライアントと 1 つのサービスのトレース ファイルが開いているときに、サービスとクライアント A だけをグラフに表示する場合は、リストからクライアント B の選択を解除します。  
+  
+#### トレース詳細の表示  
+ トレース詳細を表示するには、トレース ペインでトレースを選択します。詳細が、詳細ペインに表示されます。  
+  
+##### トレース ペイン  
+ サービス トレース ビューアーの右上のペインがトレース ペインです。トレース ペインは、選択されたアクティビティのすべてのトレースを、トレース レベル、スレッド ID、プロセス名などの情報と共に表示します。  
+  
+ トレースの未処理の XML をクリップボードにコピーするには、トレースを右クリックし、**\[Copy Trace to Clipboard\]** を選択します。  
+  
+##### 詳細ペイン  
+ サービス トレース ビューアーの左下のペインが詳細ペインです。詳細ペインには、トレース詳細を表示するために 3 つのタブがあります。  
+  
+ **\[Formatted\]** ビューは、情報を整えて表示します。このビューは、テーブルとツリーの既知のすべての XML 要素の情報を判読しやすいように表示します。  
+  
+ **\[XML\]** ビューは、選択されたトレースに対応する XML を表示します。このビューは、強調表示と構文色をサポートします。**\[Find\]** を使用して文字列を検索する場合は、検索結果が強調表示されます。  
+  
+ **\[Message\]** ビューは、メッセージ ログ トレースの XML のメッセージ部分を表示します。メッセージ以外のトレースを選択すると、このビューは非表示になります。  
+  
+### WCF トレースのフィルター処理  
+ トレースの分析を容易に行うために、次の方法でフィルター処理します。  
+  
+-   フィルター ツール バーから定義済みのフィルターとカスタム フィルターにアクセスできます。フィルター ツール バーを有効にするには、**\[View\]** メニューを使用します。  
+  
+-   ビューアーの定義済みフィルターを使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレースの部分を選択的にフィルター処理できます。既定では、すべてのインフラストラクチャ トレースが通過できるように設定されます。このフィルターの設定は、**\[View\]** メニューの **\[Filter Options\]** に定義されています。  
+  
+-   カスタム XPath フィルターを使用すると、ユーザーはフィルター処理を完全に制御できます。カスタム XPath フィルターは、**\[View\]** メニューの **\[Custom Filter\]** で定義できます。  
+  
+ すべてのフィルターを通過するトレースだけが表示されます。  
+  
+#### フィルター ツール バーの使用  
+ フィルター ツール バーは、ツールの上部に表示されます。このサブメニューがない場合は、**\[View\]** メニューで有効にできます。バーには、3 つのコンポーネントがあります。  
+  
+-   Look for: **\[Look for\]** では、フィルター操作で検索するサブジェクトを定義します。たとえば、プロセス X のコンテキストで出力されたすべてのトレースを検索する場合は、このフィールドを X に設定し、**\[Search In\]** フィールドを ‘プロセス名’ に設定します。時間ベースのフィルターを選択すると、このフィールドは、DateTime セレクター コントロールに変更されます。  
+  
+-   Search in: このフィールドは、適用するフィルターの種類を定義します。  
+  
+-   Level: レベル設定では、フィルターが許容する最小トレース レベルを定義します。たとえば、レベルが Error と Up に設定されている場合は、Error レベルと Critical レベルのトレースだけが表示されます。このフィルターは、検索対象と検索場所で指定された検索条件と組み合わせます。  
+  
+ **\[Filter Now\]** ボタンは、フィルター操作を開始します。一部のフィルターは、特に大規模なデータ セットに適用される場合は完了に長時間かかります。フィルター操作をキャンセルするには、**\[Operations\]** メニューのステータス バーに表示される **\[Stop\]** ボタンを押します。  
+  
+ **\[Clear\]** ボタンは、定義済みフィルターとカスタム フィルターをリセットして、すべてのトレースの通過を許可します。  
+  
+#### フィルター オプション  
+ ビューアーは、ビューから [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレースを自動的に削除できます。トランザクション関連のトレースをビューから削除するなど、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の特定の領域から出力されるトレースを選択的に削除できます。  
+  
+ このフィルターの設定は、**\[View\]** メニューの **\[Filter Options\]** に定義されています。  
+  
+#### カスタム フィルター  
+ XML パス言語 \(XPath\) に慣れている場合は、その言語でカスタム フィルターを構築して、トレース データから関係する任意の XML 要素を検索できます。フィルターには、フィルター ツール バーからアクセスできます。  
+  
+ カスタム フィルターは、パラメーターを含むことができます。既存のカスタム フィルターをインポートすることもできます。  
+  
+##### カスタム フィルターの作成  
+ フィルターは、次の 2 つの方法で作成できます。  
+  
+###### テンプレート ウィザードを使用したカスタム フィルターの作成  
+ 既存のトレースをクリックし、トレースの構造に基づいてフィルターを作成できます。この例では、スレッド ID に基づいてカスタム フィルターを作成します。  
+  
+1.  ビューアーの右上にあるトレース ペインで、フィルター処理する要素を含むトレースを選択します。  
+  
+2.  トレース ペインの上部にある **\[Create Custom Filter\]** ボタンをクリックします。  
+  
+3.  表示されるダイアログ ボックスにフィルターの名前を入力します。この例では、「`Thread ID`」と入力します。また、フィルターの説明も提供できます。  
+  
+4.  左側のツリー ビューは、手順 1. で選択したトレース レコードの構造を表示します。検索条件の作成対象となる要素を参照します。この例では、XPath: \/E2ETraceEvent\/System\/Execution\/@ThreadID ノードに存在する ThreadID を参照します。ツリー ビューで ThreadID 属性をダブルクリックします。これにより、ダイアログの右側に属性の式が作成されます。  
+  
+5.  ThreadID 条件のパラメーター フィールドを None から ‘{0}’ に変更します。この手順によって、フィルターの適用時に ThreadID 値を構成できます。\(「フィルターの適用方法」セクションを参照してください\)。パラメーターは 4 つまで定義できます。条件は、OR 演算子を使用して結合されます。  
+  
+6.  **\[OK\]** をクリックして、フィルターを作成します。  
+  
+> [!NOTE]
+>  テンプレート ウィザードを使用してフィルターを作成したら、編集を手動でのみ行うことができます。以前に作成されたフィルターのウィザードをアクティブにすることはできません。また、テンプレート ウィザードで作成された XPath フィルターの条件は、OR 演算子を使用して結合されます。AND 演算子が必要な場合は、フィルター式の作成後に編集できます。  
+  
+###### 手動によるカスタム フィルターの作成  
+ カスタム フィルター メニューを使用すると、XPath フィルターを手動で入力できます。  
+  
+1.  \[View\] メニューの **\[Custom Filters\]** メニュー項目をクリックします。  
+  
+2.  表示されるダイアログで、**\[New\]** をクリックします。  
+  
+3.  少なくともフィルター名と XPath 式を指定します。  
+  
+4.  **\[OK\]** をクリックします。  
+  
+###### カスタム フィルターの適用  
+ カスタム フィルターを作成したら、フィルター ツール バーからアクセスできます。フィルター ツール バーの **\[Search In\]** フィールドで、適用するフィルターを選択します。前の例では、「Thread ID」を選択します。  
+  
+1.  **\[Find What\]** フィールドに検索する値を指定します。例では、検索するスレッドの ID を入力します。  
+  
+2.  **\[Filter Now\]** をクリックし、操作結果を確認します。  
+  
+ フィルターが複数のパラメーターを使用する場合は、区切り記号として ‘;’ を使用して、**\[Find What\]** フィールドにパラメーターを入力します。たとえば、‘1;findValue;text’ という文字列は、3 つのパラメーターを定義します。ビューアーは、フィルターの {0} パラメーターに ‘1’ を適用します。‘findValue’ と ‘text’ はそれぞれ、{1} と {2} に適用されます。  
+  
+###### カスタム フィルターの共有  
+ カスタム フィルターは、異なるセッション間や異なるユーザー間で共有できます。フィルターを定義ファイルにエクスポートしたり、このファイルを別の場所にインポートすることができます。  
+  
+ カスタム フィルターをインポートするには  
+  
+1.  **\[View\]** メニューの **\[Custom Filters\]** をクリックします。  
+  
+2.  開いているダイアログ ボックスで、**\[Import\]** ボタンをクリックします。  
+  
+3.  カスタム フィルター ファイル \(.stvcf\) に移動し、そのファイルをクリックし、**\[Open\]** ボタンをクリックします。  
+  
+ カスタム フィルターをエクスポートするには  
+  
+1.  \[View\] メニューの **\[Custom Filters\]** をクリックします。  
+  
+2.  開いているダイアログ ボックスで、エクスポートするフィルターを選択します。  
+  
+3.  **\[Export\]** ボタンをクリックします。  
+  
+4.  カスタム フィルター定義ファイル \(.stvcf\) の名前と場所を指定し、**\[Save\]** ボタンをクリックします。  
+  
+> [!NOTE]
+>  これらのカスタム フィルターは、サービス トレース ビューアーだけからインポートとエクスポートを実行できます。他のツールで読み取ることはできません。  
+  
+### データの検索  
+ ビューアーは、データを検索する次の方法を提供します。  
+  
+-   検索ツール バーを使用すると、最も一般的な検索オプションにすばやくアクセスできます。  
+  
+-   検索ダイアログは、詳細な検索オプションを提供します。検索ダイアログには、**\[Edit\]** メニューやショートカットの Ctrl \+ F キーを使用してアクセスできます。  
+  
+ 検索ツール バーは、ビューアーの上部に表示されます。このサブメニューがない場合は、**\[View\]** メニューで有効にできます。バーには、2 つのコンポーネントがあります。  
+  
+-   Find What: 検索キーワードを入力できます。  
+  
+-   Look In: 検索範囲を入力できます。すべてのアクティビティを検索するか、現在のアクティビティだけを検索するかを選択できます。  
+  
+ 検索ダイアログは、2 つの追加オプションを提供します。  
+  
+-   Find target:  
+  
+    -   "Raw log data" オプションは、すべての未処理データからキーワードを検索します。  
+  
+    -   "XML Text" オプションと "XML Attribute" オプションは、XML 要素だけを検索します。  
+  
+    -   "Logged Message" オプションは、メッセージだけからキーワードを検索します。  
+  
+-   Ignore root activity: 検索が "000000000000" アクティビティでのトレースを無視します。ルート アクティビティに数千のトレースがあり、その大部分が転送である場合は、これにより、規模の大きいトレース ファイルのパフォーマンスが強化されます。  
+  
+### トレースの移動  
+ アプリケーションのランタイム時にトレースはステップごとに記録されるため、トレースを移動すると、アプリケーションのデバッグに役立ちます。サービス トレース ビューアーは、トレースを移動するさまざまな方法を提供します。  
+  
+#### ステップ前進またはステップ後退  
+ それぞれのトレースをプログラムのコード行と見なすと、ステップ前進は、Visual Studio 統合開発環境 \(IDE\) の "ステップ オーバー" とほぼ同じです。違いは、トレースではステップ後退もできることです。ステップ前進は、アクティビティの次のトレースに移動することを意味します。  
+  
+-   ステップ前進 : **\[Activity\]** メニューを使用するか、F10 キーを押します。トレース ペインで下方向キーも使用できます。  
+  
+-   ステップ後退 : **\[Activity\]** メニューを使用するか、F9 キーを押します。トレース ペインで上方向キーも使用できます。  
+  
+> [!NOTE]
+>  これを使用すると、別のプロセスで発生するアクティビティに移動したり、コンピューター間で有効なアクティビティ ID を [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージが別のコンピューターに移動できるため、別のコンピューターで発生するアクティビティにも移動できます。  
+  
+#### 転送の追跡  
+ 転送トレースは、トレース ファイルの特別なトレースです。アクティビティは、転送トレースによって別のアクティビティに転送できます。たとえば、"アクティビティ A" を "アクティビティ B" に転送できるとします。この場合、"アクティビティ A" には、"To: Activity" という名前の転送トレースと転送アイコンがあります。この転送トレースは、2 つのトレース間のリンクです。"アクティビティ B" のアクティビティの最後には、"アクティビティ A" に転送を返すための転送トレースもあります。これは、A が B を呼び出した後に B が返すプログラムの関数呼び出しに類似しています。  
+  
+ "Follow transfer" は、デバッガーの "ステップ イン" に類似しています。転送の追跡では、転送を A から B にまで追跡します。他のトレースにはまったく影響ありません。  
+  
+ 転送を追跡するには、マウスを使用する場合とキーボードを使用する場合の 2 つの方法があります。  
+  
+-   マウスの使用 : トレース ペインで転送トレースをダブルクリックします。  
+  
+-   キーボードの使用 : 転送トレースを選択し、**\[Activity\]** メニューの \[Follow Transfer\] を使用するか、F11 キーを押します。  
+  
+> [!NOTE]
+>  多くの場合、アクティビティ A がアクティビティ B に転送すると、アクティビティ A は、アクティビティ B がアクティビティ A に転送を返すまで待機します。これは、アクティビティ B がアクティブにトレースしている間、アクティビティ A はトレースのログを記録しないことを意味します。ただし、アクティビティ A が待機しないでトレースのログ記録を続行することも可能です。また、アクティビティ B がアクティビティ A に転送を返さないことも可能です。したがって、アクティビティ転送は、この意味では関数呼び出しとは異なります。グラフ ビューでアクティビティ転送をさらに理解することができます。  
+  
+#### 次の転送または前の転送へのジャンプ  
+ 現在のアクティビティを分析する場合や複数のアクティビティが選択されている場合に選択されたアクティビティを分析する場合は、転送先のアクティビティをすばやく検索する必要があります。"Jump to next transfer" を使用すると、アクティビティで次の転送トレースを見つけることができます。転送トレースを見つけたら、"Follow transfer" を使用して次のアクティビティにステップ インすることができます。  
+  
+-   Jump to Next Transfer: **\[Activity\]** メニューを使用するか、Ctrl \+ F10 キーを押します。  
+  
+-   Jump to Previous Transfer: **\[Activity\]** メニューを使用するか、Ctrl \+ F9 キーを押します。  
+  
+#### グラフ ビュー内の移動  
+ アクティビティ ペインやトレース ペイン内の移動はデバッグと同じですが、**\[Graph\]** ビューを使用すると、ナビゲーションの豊富な機能を体験できます。詳細については、「グラフ ビュー」セクションを参照してください。  
+  
+### 規模の大きいトレース ファイルの読み込み  
+ トレース ファイルは、非常に大きくなる可能性があります。たとえば、"Verbose" レベルのトレースをオンにすると、数分の実行で生成されるトレース ファイルは、ネットワーク速度や通信パターンによって異なりますが、すぐに数百メガバイトやそれ以上に膨張します。  
+  
+ 非常に大きなトレース ファイルをサービス トレース ビューアーで開くと、システムのパフォーマンスに悪影響を及ぼす可能性があります。読み込み速度と読み込み後の応答時間が低下する可能性があります。実速度は、ハードウェア構成によって異なる場合があります。ほとんどの PC では、200 MB を超えるトレース ファイルを読み込むと、パフォーマンスに深刻な影響が生じます。1 GB を超えるトレース ファイルの場合、ツールが、使用可能なすべてのメモリを使い果たし、非常に長い時間応答が停止する可能性があります。  
+  
+ 規模の大きいトレース ファイルの分析で読み込みや応答時間の低下を回避するために、サービス トレース ビューアーは、"部分読み込み" という機能を提供します。この機能は、トレースの小さな部分だけを一度に読み込みます。たとえば、サーバー上で数日間実行して 1 GB を超えたトレース ファイルがあるとします。エラーが発生してトレースを分析するとき、トレース ファイル全体を開く必要がありません。代わりに、エラーが発生したと考えられる特定期間内のトレースを読み込むことができます。範囲が狭いので、サービス トレース ビューアー ツールはファイルを高速に読み込み、ユーザーは狭い範囲のデータからエラーを特定することができます。  
+  
+#### 部分読み込みの有効化  
+ 部分読み込みを手動で有効にする必要はありません。読み込もうとするトレース ファイルのサイズ全体が 40 MB を超えると、読み込む部分を選択させるために、サービス トレース ビューアーは自動的に、部分読み込みのダイアログを表示します。  
+  
+> [!NOTE]
+>  トレースは期間を通して均等に分散していない可能性があるため、部分読み込みのツール バーで指定する期間の長さは、示される読み込みサイズに比例していない可能性があります。実際の読み込みサイズは、部分読み込みのダイアログで示される推定サイズよりも小さい可能性があります。  
+  
+#### 部分読み込みの調整  
+ トレース ファイルを部分的に読み込んだ後に、読み込むデータ セットを変更したい場合があります。これを行うには、ビューアーの上部にある部分読み込みのツール バーを調整します。  
+  
+1.  マウスでツール バーを移動するか、開始時刻と終了時刻を入力します。  
+  
+2.  **\[Adjust\]** ボタンをクリックします。  
+  
+## トレース アイコンの理解  
+ 次に示すのは、サービス トレース ビューアー ツールがさまざまな項目を表すために、**\[Activity\]** ビュー、**\[Graph\]** ビュー、および **\[Trace\]** ペインで使用するアイコンの一覧です。  
+  
+> [!NOTE]
+>  分類されていない一部のトレース \("メッセージが閉じている" など\) にはアイコンがありません。  
+  
+### アクティビティ トレースのトレース  
+  
+|アイコン|説明|  
+|----------|--------|  
+|![Warning トレース](../../../docs/framework/wcf/media/7457c4ed-8383-4ac7-bada-bcb27409da58.gif "7457c4ed\-8383\-4ac7\-bada\-bcb27409da58")|Warning トレース : Warning レベルで出力されるトレース|  
+|![Error トレース](../../../docs/framework/wcf/media/7d908807-4967-4f6d-9226-d52125db69ca.gif "7d908807\-4967\-4f6d\-9226\-d52125db69ca")|Error トレース : Error レベルで出力されるトレース|  
+|![アクティビティ Start トレース:](../../../docs/framework/wcf/media/8a728f91-5f80-4a95-afe8-0b6acd6e0317.gif "8a728f91\-5f80\-4a95\-afe8\-0b6acd6e0317")|アクティビティ Start トレース : アクティビティの開始をマークするトレース。ここにはアクティビティの名前が指定されています。アプリケーションのデザイナーや開発者として、プロセスまたはスレッドごとにアクティビティ ID につき 1 つのアクティビティ Start トレースを定義する必要があります。<br /><br /> アクティビティ ID がトレース相関対象のトレース ソースに反映されている場合、同じアクティビティ ID に対して Start \(トレース ソースにつき 1 つ\) が複数存在することがあります。Start トレースは、ActivityTracing がトレース ソースで有効な場合に出力されます。|  
+|![アクティビティ Stop トレース](../../../docs/framework/wcf/media/a0493e95-653e-4af8-84a4-4d09a400bc31.gif "a0493e95\-653e\-4af8\-84a4\-4d09a400bc31")|アクティビティ Stop トレース : アクティビティの終了をマークするトレース。.ここにはアクティビティの名前が指定されています。アプリケーションのデザイナーや開発者として、トレース ソースごとにアクティビティ ID につき 1 つのアクティビティ Stop トレースを定義する必要があります。トレース時間の単位が十分に小さくない場合を除き、指定したトレース ソースからのトレースは、そのトレース ソースからアクティビティ Stop が出力された後には何も表示されません。これが起こると、同じ時刻の 2 つのトレース \(Stop を含む\) が、交互に表示される場合があります。アクティビティ ID がトレース相関対象のトレース ソースに反映されている場合、同じアクティビティ ID に対して Stop \(トレース ソースにつき 1 つ\) が複数存在することがあります。Stop トレースは、ActivityTracing がトレース ソースで有効な場合に出力されます。|  
+|![アクティビティ Suspend トレース](../../../docs/framework/wcf/media/6f7f4191-df2b-4592-8998-8379769e2d32.gif "6f7f4191\-df2b\-4592\-8998\-8379769e2d32")|アクティビティ Suspend トレース : アクティビティが中断した時刻をマークするトレース。アクティビティが再開されるまで、中断したアクティビティではトレースは出力されません。アクティビティの中断とは、トレース ソースのスコープにおいてそのアクティビティで何も処理が行われていないことです。トレースの中断\/再開は、プロファイリングに便利です。Suspend トレースは、ActivityTracing がトレース ソースで有効な場合に出力されます。|  
+|![アクティビティ Resume トレース](../../../docs/framework/wcf/media/1060d9d2-c9c8-4e0a-9988-cdc2f7030f17.gif "1060d9d2\-c9c8\-4e0a\-9988\-cdc2f7030f17")|アクティビティ Resume トレース : アクティビティが中断した後に再開した時刻をマークするトレース。アクティビティでトレースを再度出力できます。トレースの中断\/再開は、プロファイリングに便利です。Resume トレースは、ActivityTracing がトレース ソースで有効な場合に出力されます。|  
+|![転送](../../../docs/framework/wcf/media/b2d9850e-f362-4ae5-bb8d-9f6f3ca036a5.gif "b2d9850e\-f362\-4ae5\-bb8d\-9f6f3ca036a5")|Transfer : 論理制御フローがあるアクティビティから別のアクティビティに転送されるときに出力されるトレース。転送の発生元のアクティビティは、転送の移動先のアクティビティと並行して作業を続行できます。Transfer トレースは、ActivityTracing がトレース ソースで有効な場合に出力されます。|  
+|![移動元](../../../docs/framework/wcf/media/1df215cb-b344-4f36-a20d-195999bda741.gif "1df215cb\-b344\-4f36\-a20d\-195999bda741")|Transfer From: 別のアクティビティから現在のアクティビティへの転送を定義するトレース。|  
+|![移動先](../../../docs/framework/wcf/media/74255b6e-7c47-46ef-8e53-870c76b04c3f.gif "74255b6e\-7c47\-46ef\-8e53\-870c76b04c3f")|Transfer To: 現在のアクティビティから別のアクティビティへの論理制御フローの転送を定義するトレース。|  
+  
+### WCF トレース  
+  
+|アイコン|説明|  
+|----------|--------|  
+|![Message Log トレース](../../../docs/framework/wcf/media/7c66e994-2476-4260-a0db-98948b9af197.gif "7c66e994\-2476\-4260\-a0db\-98948b9af197")|Message Log トレース : `System.ServiceModel.MessageLogging` トレース ソースが有効な場合に、メッセージ ログ機能によって [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージがログに記録されるときに出力されるトレース。このトレースをクリックすると、メッセージが表示されます。メッセージには、構成可能なログ ポイントが 4 つ \(ServiceLevelSendRequest、TransportSend、TransportReceive、および ServiceLevelReceiveRequest\) あり、これらは、メッセージ ログ トレースの `messageSource` 属性でも指定できます。|  
+|![Message Received トレース](../../../docs/framework/wcf/media/de4f586c-c5dd-41ec-b1c3-ac56b4dfa35c.gif "de4f586c\-c5dd\-41ec\-b1c3\-ac56b4dfa35c")|Message Received トレース : `System.ServiceModel` トレース ソースが Information レベルか Verbose レベルで有効な場合に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージが受信されるときに出力されるトレース。このトレースは、アクティビティの **\[Graph\]** ビューでメッセージ相関矢印を表示するために重要です。|  
+|![Message Sent トレース](../../../docs/framework/wcf/media/558943c4-17cf-4c12-9405-677e995ac387.gif "558943c4\-17cf\-4c12\-9405\-677e995ac387")|Message Sent トレース : `System.ServiceModel` トレース ソースが Information レベルか Verbose レベルで有効な場合に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージが送信されるときに出力されるトレース。このトレースは、アクティビティの **\[Graph\]** ビューでメッセージ相関矢印を表示するために重要です。|  
+  
+### アクティビティ  
+  
+|アイコン|説明|  
+|----------|--------|  
+|![アクティビティ](../../../docs/framework/wcf/media/wcfc-defaultactivityc.gif "wcfc\_defaultActivityc")|Activity: 現在のアクティビティが一般的なアクティビティであることを示します。|  
+|![Root アクティビティ](../../../docs/framework/wcf/media/5dc8e0eb-1c32-4076-8c66-594935beaee9.gif "5dc8e0eb\-1c32\-4076\-8c66\-594935beaee9")|Root アクティビティ : プロセスのルート アクティビティを示します。|  
+  
+### WCF アクティビティ  
+  
+|アイコン|説明|  
+|----------|--------|  
+|![環境アクティビティ](../../../docs/framework/wcf/media/29fa00ac-cf78-46e5-822d-56222fff61d1.gif "29fa00ac\-cf78\-46e5\-822d\-56222fff61d1")|Environment アクティビティ : [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ホストまたはクライアントを作成したり、開いたり、閉じたりするアクティビティ。これらの段階で発生したエラーは、このアクティビティで表示されます。|  
+|![Listen アクティビティ](../../../docs/framework/wcf/media/d7b135f6-ec7d-45d7-9913-037ab30e4c26.gif "d7b135f6\-ec7d\-45d7\-9913\-037ab30e4c26")|Listen アクティビティ : リスナーに関連するトレースをログに記録するアクティビティ。このアクティビティ内で、リスナー情報と接続要求を表示できます。|  
+|![Receive Bytes アクティビティ](../../../docs/framework/wcf/media/2f628580-b80f-45a7-925b-616c96426c0e.gif "2f628580\-b80f\-45a7\-925b\-616c96426c0e")|Receive Bytes アクティビティ : 2 つのエンドポイント間の接続上で受信バイトに関連するすべてのトレースをグループ化するアクティビティ。このアクティビティは、http.sys などのアクティビティを伝達する転送アクティビティと相関させる場合に必要です。中止などの接続エラーが、このアクティビティで表示されます。|  
+|![Process Message アクティビティ](../../../docs/framework/wcf/media/wcfc-executionactivityiconc.GIF "wcfc\_ExecutionActivityIconc")|Process Message アクティビティ : [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージの作成に関連するトレースをグループ化するアクティビティ。不正なエンベロープや誤った形式のメッセージが原因のエラーが、このアクティビティで表示されます。このアクティビティ内で、メッセージ ヘッダーを調べて、アクティビティ ID が呼び出し元から伝達されたかどうかを確認できます。これが可能であれば、読み出し元と呼び出し先のトレース間を相関するために、Process Action アクティビティ \(次のアイコン\) に転送するときに、伝達されたアクティビティ ID をそのアクティビティに割り当てることもできます。|  
+|![Message Log トレース](../../../docs/framework/wcf/media/7c66e994-2476-4260-a0db-98948b9af197.gif "7c66e994\-2476\-4260\-a0db\-98948b9af197")|Process Action アクティビティ : 2 つのエンドポイント間の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 要求に関連するすべてのトレースをグループ化するアクティビティ。両方のエンドポイントの構成で、`propagateActivity` が `true` に設定されている場合は、両方のエンドポイントのすべてのトレースが、直接相関関係を示すために 1 つのアクティビティにマージされます。このアクティビティは、転送やセキュリティの処理、ユーザー コード境界への拡張、および戻り \(応答が存在する場合\) で発生するエラーを含みます。|  
+|![Process Message アクティビティ](../../../docs/framework/wcf/media/wcfc-executionactivityiconc.GIF "wcfc\_ExecutionActivityIconc")|Execute User Code アクティビティ : 要求を処理するユーザー コードのトレースをグループ化するアクティビティ。|  
+  
+## トラブルシューティング  
+ レジストリに書き込むためのアクセス許可がない場合に、"`svctraceviewer /register`" コマンドを使用してツールを登録しようとすると、エラー メッセージ "Microsoft サービス トレース ビューアーがシステムに登録されていません" が表示されます。このエラーが発生したら、レジストリの書き込みアクセスを持つアカウントを使用してログインする必要があります。  
+  
+ また、サービス トレース ビューアー ツールは、アセンブリ フォルダー内の SvcTraceViewer.exe.settings ファイルに設定 \(カスタム フィルターやフィルター オプションなど\) を書き込みます。ファイルの読み取りアクセス許可がない場合、ツールの起動は可能ですが、設定を読み込むことはできません。  
+  
+ .etl ファイルを開くときに、エラー メッセージ "トレースの処理中に不明なエラーが発生しました" が表示される場合は、.etl ファイルの形式が無効であることを示します。  
+  
+ アラビア語のオペレーティング システムを使用して作成されたトレース ログを開く場合に、時間ベースのフィルターが機能しません。たとえば、2005 年がアラビア カレンダーの 1427 年に対応します。ただし、サービス トレース ビューアー ツールのフィルターがサポートする時間の範囲は、1752 年より前の日付を含みません。このことは、フィルターで正しい日付を選択できないことを示します。この問題を解決するには、特定の時間範囲を含むために XPath 式を使用して、カスタム フィルター \(**\[View\]** メニューの **\[Custom Filters\]**\) を作成します。  
+  
+## 参照  
+ [サービス トレース ビューアーを使用した相関トレースの表示とトラブルシューティング](../../../docs/framework/wcf/diagnostics/tracing/using-service-trace-viewer-for-viewing-correlated-traces-and-troubleshooting.md)   
+ [トレースの構成](../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)   
+ [Activity Tracing and Propagation for End\-To\-End Trace Correlation](http://msdn.microsoft.com/ja-jp/2c11a905-64f8-47b5-bae5-a74fc666137e)
\ No newline at end of file
diff --git a/docs/framework/wcf/service-versioning.md b/docs/framework/wcf/service-versioning.md
new file mode 100644
index 00000000000..c40f40e7597
--- /dev/null
+++ b/docs/framework/wcf/service-versioning.md
@@ -0,0 +1,196 @@
+---
+title: "サービスのバージョン管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37575ead-d820-4a67-8059-da11a2ab48e2
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# サービスのバージョン管理
+ビジネス ニーズの変化、情報テクノロジの要件、その他の問題への対処などのさまざまな理由により、サービスの初期導入後と、場合によっては有効期間中に数回、サービス \(およびサービスが公開するエンドポイント\) を変更することが必要になる場合があります。変更が発生するたびに、新しいバージョンのサービスが導入されます。ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] でのバージョン管理の考え方について説明します。  
+  
+## サービス変更の 4 つのカテゴリ  
+ 必要となるサービスの変更は、次の 4 つのカテゴリに分類できます。  
+  
+-   コントラクトの変更 : 操作を追加する場合や、メッセージ内のデータ要素を追加または変更する場合など。  
+  
+-   アドレスの変更 : エンドポイントが新しいアドレスを持つ別の場所にサービスを移動する場合など。  
+  
+-   バインディングの変更 : セキュリティ機構の変更や、その設定の変更など。  
+  
+-   実装の変更 : 内部メソッド実装を変更する場合など。  
+  
+ これらの変更の中には "互換性に影響する" ものとそうでないものとがあります。*互換性に影響しない*変更では、以前のバージョンで正常に処理されたメッセージは新しいバージョンでも正常に処理されます。この条件を満たさない変更はすべて、*互換性に影響する*変更です。  
+  
+## サービス指向とバージョン管理  
+ サービス指向の基本思想の 1 つは、サービスとクライアントが自律 \(または独立\) しているということです。これは、サービス開発者が、すべてのサービス クライアントを制御または把握するということを想定できないことを意味します。これにより、サービスのバージョンが変更されたときに、すべてのクライアントを再構築し、再展開するという選択肢はなくなります。このトピックでは、この基本思想に従ってサービスを想定しているため、クライアントから独立して、サービスを変更または "バージョン管理" する必要があります。  
+  
+ 互換性に影響する変更が想定外であり、回避できない場合、アプリケーションはこの基本思想を無視し、新しいバージョンのサービスでクライアントを再構築し、再展開することを要求できます。  
+  
+## コントラクトのバージョン管理  
+ クライアントが使用するコントラクトは、サービスが使用するコントラクトと同じである必要はありません。これらのコントラクトに必要なのは互換性だけです。  
+  
+ サービス コントラクトの場合、互換性は、サービスが公開する新しい操作は追加できても、既存の操作をセマンティックに削除または変更することはできないことを意味します。  
+  
+ データ コントラクトの場合、互換性は、新しいスキーマの種類の定義は追加できても、既存のスキーマの種類の定義を互換性に影響する方法では変更できないことを意味します。互換性に影響する変更として、データ メンバーの削除や、データ型の互換性のない変更などがあります。この特徴により、クライアントの互換性に影響しなければ、サービスはコントラクトのバージョンをある程度自由に変更できます。次の 2 つのセクションでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のデータ コントラクトとサービス コントラクトに対して行うことができる、互換性に影響しない変更と互換性に影響する変更について説明します。  
+  
+## データ コントラクトのバージョン管理  
+ ここでは、<xref:System.Runtime.Serialization.DataContractSerializer> クラスと <xref:System.Runtime.Serialization.DataContractAttribute> クラスを使用する場合のデータのバージョン管理について説明します。  
+  
+### 厳密なバージョン管理  
+ バージョンの変更が問題となる多くのシナリオでは、サービス開発者はクライアントを制御できないため、メッセージの XML やスキーマの変更に対処する方法を想定できません。このような場合、次の 2 つの理由から、新しいメッセージが古いスキーマに対して有効であることを保証する必要があります。  
+  
+-   スキーマが変更されることはないという前提で旧クライアントが開発されている場合、クライアントは、その設計で対象としていないメッセージを処理できない可能性があるため。  
+  
+-   旧クライアントがメッセージの処理を試みる前に、実際のスキーマ検証を古いスキーマに対して実行する可能性があるため。  
+  
+ このようなシナリオでは、既存のデータ コントラクトを変更不可として扱い、一意の XML 修飾名を持つ新しいデータ コントラクトを作成することをお勧めします。この場合、サービス開発者は、既存のサービス コントラクトに新しいメソッドを追加するか、新しいデータ コントラクトを使用するメソッドを含む新しいサービス コントラクトを作成します。  
+  
+ 多くの場合、サービス開発者は、データ コントラクトのすべてのバージョン内で実行するビジネス ロジックと、データ コントラクトの各バージョンに固有のビジネス コードを作成することが必要になります。インターフェイスを使用してこの要件を満たす方法について、このトピックの最後にある付録で説明します。  
+  
+### 厳密でないバージョン管理  
+ 他の多くのシナリオでは、サービス開発者は、新しい任意のメンバーをデータ コントラクトに追加しても、既存のクライアントの互換性には影響しないという想定を行うことができます。この場合、サービス開発者は、既存のクライアントがスキーマ検証を実行しないかどうか、また、未知のデータ メンバーを無視するかどうかを調べる必要があります。このようなシナリオでは、互換性に影響しない方法で新しいメンバーを追加するためのデータ コントラクト機能を利用できます。サービスの最初のバージョンで、バージョン管理のためのデータ コントラクト機能が既に使用されている場合には、サービス開発者は確信を持ってこの想定を行うことができます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]、ASP.NET Web サービス、および他の多くの Web サービス スタックは、*厳密でないバージョン管理*をサポートしています。つまり、受信したデータに新しい未知のデータ メンバーが含まれていても例外をスローすることはありません。  
+  
+ 新しいデータ メンバーを追加しても、既存のクライアントの互換性に影響することはないと誤解しがちです。すべてのクライアントが厳密でないバージョン管理に対処できるという確信がない場合は、厳密なバージョン管理のガイドラインに従い、データ コントラクトを変更不可として扱うことをお勧めします。  
+  
+ データ コントラクトの厳密でないバージョン管理、および厳密なバージョン管理の詳細なガイドラインについては、「[ベスト プラクティス : データ コントラクトのバージョン管理](../../../docs/framework/wcf/best-practices-data-contract-versioning.md)」を参照してください。  
+  
+### データ コントラクトと .NET 型の区別  
+ .NET クラスまたは構造体は、<xref:System.Runtime.Serialization.DataContractAttribute> 属性をクラスに適用することにより、データ コントラクトとして投影できます。.NET 型とそのデータ コントラクト投影は、2 つの異なる要素です。同じデータ コントラクトが投影された複数の .NET 型を使用できます。この区別は、投影されたデータ コントラクトを維持することによって、厳密な意味で既存のクライアントとの互換性を保ちながら、.NET 型を変更できるという点で特に有用です。.NET 型とデータ コントラクトのこの区別を維持するには、次の 2 つのことを必ず行う必要があります。  
+  
+-   <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A> と <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A> を指定します。コントラクトに .NET 型の名前と名前空間が公開されないように、データ コントラクトの名前と名前空間を必ず指定する必要があります。これにより、後で .NET の名前空間や型名を変更することにした場合でも、データ コントラクトの変更はありません。  
+  
+-   <xref:System.Runtime.Serialization.DataMemberAttribute.Name%2A> を指定します。コントラクトに .NET メンバー名が公開されないように、データ メンバーの名前を必ず指定する必要があります。これにより、後でメンバーの .NET 名を変更することにした場合でも、データ コントラクトの変更はありません。  
+  
+### メンバーの変更または削除  
+ 厳密でないバージョン管理が許可されている場合でも、メンバーの名前またはデータ型の変更や、データ メンバーの削除は、互換性に影響する変更です。このような変更が必要な場合は、新しいデータ コントラクトを作成します。  
+  
+ サービスの互換性が非常に重要である場合は、コードで使用していないデータ メンバーを無視するよう考慮し、これらのメンバーをそのまま残しておきます。データ メンバーを複数のメンバーに分割する場合は、必要な分割と下位レベル クライアント \(最新のバージョンにアップグレードされていないクライアント\) の再集約を実行できるプロパティとして、既存のメンバーをそのまま残すよう考慮します。  
+  
+ 同様に、データ コントラクトの名前または名前空間の変更も互換性に影響する変更です。  
+  
+### 未知のデータのラウンド トリップ  
+ 一部のシナリオでは、新しいバージョンで追加されたメンバーによって生じる未知のデータを "ラウンド トリップ" する必要があります。たとえば、新しく追加された複数のメンバーを含むデータを、"versionNew" サービスから "versionOld" クライアントに送信するとします。クライアントは、メッセージを処理するときに新しく追加されたメンバーを無視しますが、新しく追加されたメンバーを含む同じデータを versionNew サービスに再送信します。この一般的なシナリオとして、サービスから取得したデータを変更して返すデータ更新があります。  
+  
+ 特定の型のラウンド トリップを有効にするには、この型に <xref:System.Runtime.Serialization.IExtensibleDataObject> インターフェイスを実装する必要があります。このインターフェイスには、<xref:System.Runtime.Serialization.ExtensionDataObject> 型を返す <xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティが含まれます。プロパティは現在のバージョンでは未知の、今後使用されるデータ コントラクトの任意のデータを格納するために使用されます。このデータはクライアントに対して不透明ですが、インスタンスをシリアル化すると、<xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A> プロパティの内容がデータ コントラクト メンバーのその他のデータと共に書き込まれます。  
+  
+ 今後の新しい未知のメンバーを格納するために、すべての型でこのインターフェイスを実装することをお勧めします。  
+  
+### データ コントラクト ライブラリ  
+ コントラクトを中央のリポジトリに公開するデータ コントラクトのライブラリを用意できます。サービスおよび型の実装側は、このリポジトリからデータ コントラクトを実装し、公開します。この場合、データ コントラクトをリポジトリに公開すると、そのコントラクトを実装する型の作成者を制御することはできません。したがって、コントラクトを一度公開すると、変更することができないため、そのコントラクトは実質的に変更不可となります。  
+  
+### XmlSerializer を使用する場合  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスを使用する場合にも、バージョン管理の同じ原則が適用されます。厳密なバージョン管理が必要な場合は、データ コントラクトを変更不可として扱い、新しいバージョンの一意の修飾名を持つ新しいデータ コントラクトを作成します。厳密でないバージョン管理を使用できることが確実である場合は、新しいバージョンでシリアル化可能な新しいメンバーを追加できますが、既存のメンバーを変更または削除することはできません。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Serialization.XmlSerializer> は、<xref:System.Xml.Serialization.XmlAnyElementAttribute> 属性と <xref:System.Xml.Serialization.XmlAnyAttributeAttribute> 属性を使用して、未知のデータのラウンド トリップをサポートします。  
+  
+## メッセージ コントラクトのバージョン管理  
+ メッセージ コントラクトのバージョン管理に関するガイドラインは、データ コントラクトのバージョン管理とよく似ています。厳密なバージョン管理が必要な場合、メッセージ本文を変更するのではなく、一意の修飾名を持つ新しいメッセージ コントラクトを作成します。厳密でないバージョン管理を使用できることがわかっている場合は、メッセージ本文の新しい部分を追加できますが、既存の部分を変更または削除することはできません。このガイドラインは、ベア メッセージ コントラクトとラップ メッセージ コントラクトの両方に適用されます。  
+  
+ 厳密なバージョン管理を使用している場合でも、メッセージ ヘッダーはいつでも追加できます。MustUnderstand フラグは、バージョン管理に影響を及ぼすことがあります。一般に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] におけるヘッダーのバージョン管理モデルは、SOAP 仕様に記載されています。  
+  
+## サービス コントラクトのバージョン管理  
+ データ コントラクトのバージョン管理と同様に、サービス コントラクトのバージョン管理にも、操作の追加、変更、および削除が含まれます。  
+  
+### 名前、名前空間、およびアクションの指定  
+ 既定では、サービス コントラクトの名前はインターフェイスの名前です。既定の名前空間は "http:\/\/tempuri.org" で、各操作のアクションは "http:\/\/tempuri.org\/contractname\/methodname" です。サービス コントラクトの名前と名前空間、および各操作のアクションを明示的に指定して、"http:\/\/tempuri.org" を使用しないようにし、サービスのコントラクトにインターフェイス名とメソッド名が公開されないようにすることをお勧めします。  
+  
+### パラメーターと操作の追加  
+ サービスが公開するサービス操作の追加は互換性に影響しない変更です。既存のクライアントは、追加された新しい操作を考慮する必要がないからです。  
+  
+> [!NOTE]
+>  双方向コールバック コントラクトへの操作の追加は、互換性に影響する変更です。  
+  
+### 操作パラメーターまたは戻り値の型の変更  
+ 新しい型が古い型と同じデータ コントラクトを実装している場合を除き、パラメーターまたは戻り値の型の変更は、一般に互換性に影響する変更です。このような変更を行う場合は、新しい操作をサービス コントラクトに追加するか、新しいサービス コントラクトを定義します。  
+  
+### 操作の削除  
+ 操作の削除も互換性に影響する変更です。このような変更を行う場合は、新しいサービス コントラクトを定義し、新しいエンドポイントで公開します。  
+  
+### エラー コントラクト  
+ <xref:System.ServiceModel.FaultContractAttribute> 属性を使用すると、サービス コントラクト開発者は、コントラクトの操作から返すことのできるエラーに関する情報を指定できます。  
+  
+ サービスのコントラクトに記載されたエラーのリストは、完全なリストとは見なされません。操作がコントラクトに記載されていないエラーを返す可能性は常にあります。したがって、コントラクトに記載されたエラーのセットの変更は、互換性に影響しないものと見なされます。たとえば、<xref:System.ServiceModel.FaultContractAttribute> を使用して新しいエラーをコントラクトに追加する場合や、コントラクトから既存のエラーを削除する場合などです。  
+  
+### サービス コントラクト ライブラリ  
+ 組織では、コントラクトを中央のリポジトリに公開する、コントラクトのライブラリを用意できます。サービス実装側は、このリポジトリからコントラクトを実装します。この場合、サービス コントラクトをリポジトリに公開すると、そのコントラクトを実装するサービスの作成者を制御することはできません。したがって、サービス コントラクトを一度公開すると、変更することができないため、実質的にそのコントラクトは変更不可になります。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、コントラクトの継承をサポートしています。継承を使用することにより、既存のコントラクトを拡張した新しいコントラクトを作成できます。この機能を使用するには、古いサービス コントラクト インターフェイスから継承した新しいサービス コントラクト インターフェイスを定義し、この新しいインターフェイスにメソッドを追加します。次に、古いコントラクトを実装するサービスを変更して新しいコントラクトを実装し、新しいコントラクトを使用するように "versionOld" エンドポイントの定義を変更します。"versionOld" クライアントには、エンドポイントが "versionOld" コントラクトを引き続き公開しているように見えます。"versionNew" クライアントには、エンドポイントが "versionNew" コントラクトを公開しているように見えます。  
+  
+## アドレスとバインディングのバージョン管理  
+ クライアントが新しいエンドポイント アドレスまたはバインディングを動的に検出できない場合、エンドポイント アドレスとバインディングの変更は互換性に影響する変更です。新しいエンドポイントまたはバインディングを動的に検出する機能を実装する 1 つの方法として、クライアントがエンドポイントとの通信を試みるときに、UDDI \(Universal Discovery Description and Integration\) レジストリと UDDI 呼び出しパターンを使用します。エラーが発生した場合、現在のエンドポイントのメタデータについて既知の UDDI レジストリに照会します。クライアントは、このメタデータからアドレスとバインディングを使用して、エンドポイントと通信を行います。この通信が成功した場合、クライアントは今後使用できるように、そのアドレスとバインディングをキャッシュします。  
+  
+## ルーティング サービスとバージョン管理  
+ サービスに対して行った変更が互換性に影響するもので、複数の異なるバージョンのサービスを同時に実行する必要がある場合、WCF ルーティング サービスを使用して、メッセージを適切なサービス インスタンスにルーティングすることができます。WCF ルーティング サービスは、メッセージの内容に基づくルーティングを使用します。つまり、メッセージ内に含まれる情報に応じて、そのメッセージのルーティング先が特定されます。WCF ルーティング サービス[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ルーティング サービス](../../../docs/framework/wcf/feature-details/routing-service.md)」を参照してください。WCF ルーティング サービスを使用したサービスのバージョン管理の例については、「[サービスのバージョンを管理する方法](../../../docs/framework/wcf/feature-details/how-to-service-versioning.md)」を参照してください。  
+  
+## 付録  
+ 厳密なバージョン管理が必要な場合、データ コントラクトのバージョン管理の一般的なガイダンスは、データ コントラクトを変更不可として扱い、変更が必要な場合は新しいデータ コントラクトを作成することです。新しいデータ コントラクトごとに新しいクラスを作成する必要があります。したがって、古いデータ コントラクト クラスの観点で作成された既存のコードを取得し、新しいデータ コントラクト クラスの観点でコードを書き換える必要がないようにするための方法が必要となります。  
+  
+ このような方法の 1 つとして、インターフェイスを使用して各データ コントラクトのメンバーを定義し、インターフェイスを実装するデータ コントラクト クラスではなく、インターフェイスの観点で内部実装コードを作成します。サービスのバージョン 1 の次のコードは、`IPurchaseOrderV1` インターフェイスと `PurchaseOrderV1` を示しています。  
+  
+```  
+public interface IPurchaseOrderV1  
+{  
+    string OrderId { get; set; }  
+    string CustomerId { get; set; }  
+}  
+  
+[DataContract(  
+Name = "PurchaseOrder",  
+Namespace = "http://examples.microsoft.com/WCF/2005/10/PurchaseOrder")]  
+public class PurchaseOrderV1 : IPurchaseOrderV1  
+{  
+    [DataMember(...)]  
+    public string OrderId {...}  
+    [DataMember(...)]  
+    public string CustomerId {...}  
+}  
+```  
+  
+ サービス コントラクトの操作は、`PurchaseOrderV1` の観点で作成されますが、実際のビジネス ロジックは、`IPurchaseOrderV1` の観点です。次のコードに示すように、バージョン 2 には、新しい `IPurchaseOrderV2` インターフェイスと `PurchaseOrderV2` クラスが含まれています。  
+  
+```  
+public interface IPurchaseOrderV2  
+{  
+    DateTime OrderDate { get; set; }  
+}  
+[DataContract(   
+Name = "PurchaseOrder ",  
+Namespace = "http://examples.microsoft.com/WCF/2006/02/PurchaseOrder")]  
+public class PurchaseOrderV2 : IPurchaseOrderV1, IPurchaseOrderV2  
+{  
+    [DataMember(...)]  
+    public DateTime OrderId {...}  
+    [DataMember(...)]  
+    public string CustomerId {...}  
+    [DataMember(...)]  
+    public DateTime OrderDate { ... }  
+}  
+```  
+  
+ `PurchaseOrderV2` の観点で作成された新しい操作を含めるために、サービス コントラクトが更新されます。`IPurchaseOrderV1` の観点で作成された既存のビジネス ロジックは、`PurchaseOrderV2` で引き続き機能し、`OrderDate` プロパティを必要とする新しいビジネス ロジックが `IPurchaseOrderV2` の観点で作成されます。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractSerializer>   
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataContractAttribute.Name%2A>   
+ <xref:System.Runtime.Serialization.DataContractAttribute.Namespace%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.Order%2A>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute.IsRequired%2A>   
+ <xref:System.Runtime.Serialization.IExtensibleDataObject>   
+ <xref:System.Runtime.Serialization.ExtensionDataObject>   
+ <xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A>   
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ [データ コントラクトの等価性](../../../docs/framework/wcf/feature-details/data-contract-equivalence.md)   
+ [バージョン トレラントなシリアル化コールバック](../../../docs/framework/wcf/feature-details/version-tolerant-serialization-callbacks.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md b/docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md
new file mode 100644
index 00000000000..7a322a699c7
--- /dev/null
+++ b/docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md
@@ -0,0 +1,274 @@
+---
+title: "ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント [WCF], ビルド"
+  - "エンドポイント [WCF]"
+  - "Svcutil.exe"
+  - "クライアント [WCF], サービスの利用"
+ms.assetid: 1abf3d9f-b420-46f1-b628-df238751f308
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 38
+---
+# ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)
+ServiceModel メタデータ ユーティリティ ツールを使用して、メタデータ ドキュメントからサービス モデル コードを生成したり、サービス モデル コードからメタデータ ドキュメントを生成します。  
+  
+## SvcUtil.exe  
+ ServiceModel メタデータ ユーティリティ ツールは、Windows SDK のインストール場所である C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\Bin にあります。  
+  
+### 機能  
+ 次の表は、このツールによって提供されるさまざまな機能とその使用方法を説明する対応トピックを示します。  
+  
+|タスク|トピック|  
+|---------|----------|  
+|実行中のサービスまたは静的なメタデータ ドキュメントからコードを生成します。|[サービス メタデータからの WCF クライアントの生成](../../../docs/framework/wcf/feature-details/generating-a-wcf-client-from-service-metadata.md)|  
+|コンパイル済みのコードからメタデータ ドキュメントをエクスポートします。|[方法 : Svcutil.exe を使用してコンパイル済みのサービス コードからメタデータをエクスポートする](../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-export-metadata-from-compiled-service-code.md)|  
+|コンパイル済みサービス コードを検証します。|[方法 : Svcutil.exe を使用してコンパイル済みサービス コードを検証する](../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-validate-compiled-service-code.md)|  
+|実行中のサービスからメタデータ ドキュメントをダウンロードします。|[方法 : Svcutil.exe を使用してメタデータ ドキュメントをダウンロードする](../../../docs/framework/wcf/feature-details/how-to-use-svcutil-exe-to-download-metadata-documents.md)|  
+|シリアル化コードを生成します。|[方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)|  
+  
+> [!CAUTION]
+>  パラメーターに指定された名前が同じ場合、Svcutil はディスク上の既存のファイルを上書きします。 これには、コード ファイル、構成ファイル、またはメタデータ ファイルが含まれます。 コード ファイルや構成ファイルの生成時にこれを回避するには、`/mergeConfig` スイッチを使用します。  
+>   
+>  また、データ コントラクト生成には、型参照用の `/r` スイッチと `/ct`  スイッチがあります。 XmlSerializer の使用時には、これらのスイッチは機能しません。  
+  
+### Timeout  
+ メタデータを取得する場合、ツールには、5 分間のタイムアウトがあります。  このタイムアウトは、ネットワーク経由でメタデータを取得する場合にのみ適用されます。 タイムアウトは、そのメタデータの処理には適用されません。  
+  
+### 複数バージョン対応  
+ このツールは複数バージョン対応機能をサポートしていません。 svcutil.exe を使用して .NET 4 成果物を生成する場合、.NET 4 SDK から svcutil.exe を実行する必要があります。 .NET 3.5 成果物を生成するには、.NET 3.5 SDK から実行可能ファイルを実行します。  
+  
+### WSDL ドキュメントへのアクセス  
+ Svcutil を使用して、セキュリティ トークン サービス \(STS\) への参照がある WSDL ドキュメントにアクセスする場合、Svcutil は WS\-MetadataExchange を使用して STS を呼び出します。 ただし、サービスは、WS\-MetadataExchange または HTTP GET を使用して WSDL ドキュメントを公開できます。 そのため、STS が HTTP GET のみを使用して WSDL ドキュメントを公開している場合、[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] で作成されたクライアントは失敗します。[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] で作成されたクライアントの場合は、Svcutil が WS\-MetadataExchange と HTTP GET の両方を使用して、STS WSDL の取得を試みます。  
+  
+## SvcUtil.exe の使用  
+  
+### 一般的な使用  
+ 次の表は、このツールで一般的に使用されるオプションを示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\/directory:\<directory\>|ファイルを作成するためのディレクトリ。<br /><br /> 既定 : 現在のディレクトリ<br /><br /> 短縮形 : `/d`|  
+|\/help|このツールのコマンド構文とオプションを表示します。<br /><br /> 短縮形 : `/?`|  
+|\/noLogo|著作権やバナー メッセージを表示しません。|  
+|\/svcutilConfig:\<configFile\>|App.config ファイルの代わりに使用するカスタム構成ファイルを指定します。 これは、ツールの構成ファイルを変更せずに system.serviceModel 拡張を登録するために使用できます。|  
+|\/target:\<output type\>|ツールによって生成される出力を指定します。<br /><br /> 有効な値は、コード、メタデータ、または xmlSerializer です。<br /><br /> 短縮形 : `/t`|  
+  
+### コード生成  
+ Svcutil.exe は、メタデータ ドキュメントからサービス コントラクト、クライアント、およびデータ型のコードを生成できます。 これらのメタデータ ドキュメントは、永続ストレージにあるか、オンラインで取得できます。 オンライン取得は、WS\-Metadata Exchange プロトコルまたは DISCO プロトコルに従います \(詳細については、「メタデータのダウンロード」セクションを参照してください\)。  
+  
+ 定義済みの WSDL ドキュメントに基づいてサービスとデータ コントラクトを生成するために SvcUtil.exe ツールを使用できます。 \/serviceContract スイッチを使用し、WSDL ドキュメントをダウンロードできるか見つけることができる URL またはファイルの場所を指定します。 こうすると、WSDL ドキュメントで定義されているサービスとデータ コントラクトが生成され、苦情サービスの実装に使用できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [方法 : メタデータの取得および準拠サービスの実装をする](../../../docs/framework/wcf/feature-details/how-to-retrieve-metadata-and-implement-a-compliant-service.md)。  
+  
+ BasicHttpContextbinding エンドポイントを使用するサービスの場合は代わりに、Svcutil.exe が、`allowCookies` 属性を `true` に設定した BasicHttpBinding を生成します。 クッキーはサーバー側でのコンテキスト用に使用されます。 サービスでクッキーを使用するときにクライアント側でコンテキストを管理する場合は、コンテキスト バインディングを使用するように構成を手動で変更できます。  
+  
+> [!CAUTION]
+>  Svcutil.exe は、WSDL またはサービスから受け取るポリシー ファイルに基づいてクライアントを生成します。 ユーザー プリンシパル名 \(UPN\) は、ユーザー名、"@"、および完全修飾ドメイン名 \(FQDN\) を連結して生成されます。 ただし、Active Directory に登録されているユーザーの場合、この形式は無効であり、ツールが生成する UPN を使用すると、Kerberos 認証でエラーが発生し、エラー メッセージ "ログインに失敗しました" が表示されます。 この問題を解決するには、このツールが生成するクライアント ファイルを手動で修正する必要があります。  
+  
+ `svcutil.exe [/t:code]  <metadataDocumentPath>* | <url>* | <epr>`  
+  
+|引数|説明|  
+|--------|--------|  
+|`epr`|WS\-Metadata Exchange をサポートするサービス エンドポイントの WS\-Addressing EndpointReference を含む XML ファイルへのパスです。 詳細については、「メタデータのダウンロード」セクションを参照してください。|  
+|`metadataDocumentPath`|コード \(.wsdl、.xsd、.wspolicy、または .wsmex\) にインポートするためのコントラクトを含むメタデータ ドキュメント \(wsdl または xsd\) へのパス。<br /><br /> Svcutil は、メタデータにリモート URL を指定するときのインポートとインクルードに従います。 ただし、ローカル ファイル システムでメタデータ ファイルを処理する場合は、この引数にすべてのファイルを指定する必要があります。 この方法では Svcutil を、ネットワークの依存関係を持つことができないビルド環境で使用できます。 この引数には、ワイルドカード \(\*.xsd、\*.wsdl\) を使用できます。|  
+|`url`|メタデータを提供するサービス エンドポイントの URL またはオンラインになっているメタデータ ドキュメントの URL。 これらのドキュメントの取得方法の詳細については、「メタデータのダウンロード」セクションを参照してください。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\/async|同期と非同期の両方のメソッド署名を生成します。<br /><br /> 既定 : 同期メソッド署名のみを生成します。<br /><br /> 短縮形: `/a`|  
+|\/collectionType:\<type\>|同期と非同期の両方のメソッド署名を生成します。<br /><br /> 既定 : 同期メソッド署名のみを生成します。<br /><br /> 短縮形: `/a`|  
+|\/config:\<configFile\>|生成される構成ファイルの名前を指定します。<br /><br /> 既定値: output.config|  
+|\/dataContractOnly|データ コントラクト型に対してのみコードを生成します。 サービス コントラクト型は生成されません。<br /><br /> このオプションにはローカル メタデータ ファイルだけを指定する必要があります。<br /><br /> 短縮形: `/dconly`|  
+|\/enableDataBinding|データ バインディングを有効にするために、すべてのデータ コントラクト型に <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装します。<br /><br /> 短縮形: `/edb`|  
+|\/excludeType:\<type\>|参照されるコントラクト型から除外する完全修飾またはアセンブリ修飾の型名を指定します。<br /><br /> このスイッチを個別の DLL から `/r` と共に使用する場合は、XSD クラスの完全名を参照します。<br /><br /> 短縮形: `/et`|  
+|\/importXmlTypes|非データ コントラクト型を IXmlSerializable 型としてインポートするようにデータ コントラクト シリアライザーを構成します。|  
+|\/internal|内部としてマークされるクラスを生成します。 既定 : パブリック クラスのみを生成します。<br /><br /> 短縮形: `/i`|  
+|\/language:\<language\>|コード生成に使用するプログラミング言語を指定します。 Machine.config ファイルに登録された言語名か、<xref:System.CodeDom.Compiler.CodeDomProvider> から継承するクラスの完全修飾名のいずれかを指定する必要があります。<br /><br /> 値 : c\#、cs、csharp、vb、visualbasic、c\+\+、cpp<br /><br /> 既定値: csharp<br /><br /> 短縮形 : `/l` **Note:**  スイッチは、Visual Studio 2005 SP1 に付属するコード プロバイダーの C\+\+ だけをサポートします。|  
+|\/mergeConfig|既存のファイルを上書きする代わりに、生成される構成ファイルを既存のファイルにマージします。|  
+|\/messageContract|メッセージ コントラクト型を生成します。<br /><br /> 短縮形: `/mc`|  
+|\/namespace:\<string,string\>|WSDL または XML スキーマの targetNamespace から CLR 名前空間へのマッピングを指定します。 targetNamespace に '\*' を使用すると、マッピングを明示的に指定せずにすべての targetNamespace をその CLR 名前空間にマップします。<br /><br /> メッセージ コントラクト名が操作名と競合しないようにするには、型参照を `::` で修飾するか、名前を一意にする必要があります。<br /><br /> 既定 : データ コントラクトのスキーマ ドキュメントのターゲット名前空間から派生します。 既定の名前空間は、生成される他のすべての型に使用されます。<br /><br /> 短縮形: `/n`|  
+|\/noConfig|構成ファイルを生成しません。|  
+|\/noStdLib|標準ライブラリを参照しません。<br /><br /> 既定 : Mscorlib.dll と System.servicemodel.dll を参照します。|  
+|\/out:\<file\>|生成されるコードのファイル名を指定します。<br /><br /> 既定 : WSDL 定義名、WSDL サービス名、またはスキーマの 1 つのターゲット名前空間から派生します。<br /><br /> 短縮形 : `/o`|  
+|\/reference:\<file path\>|指定されたアセンブリの型を参照します。 クライアントの生成時に、このオプションを使用して、インポートするメタデータを表す型を含むアセンブリを指定します。<br /><br /> このスイッチを使用して、メッセージ コントラクト型と <xref:System.Xml.Serialization.XmlSerializer> 型は指定できません。<br /><br /> <xref:System.DateTimeOffset> が参照されている場合、新しい型を生成する代わりにこの型が使用されます。 アプリケーションが [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] を使用して記述されている場合、SvcUtil.exe は、自動的に <xref:System.DateTimeOffset> を参照します。<br /><br /> 短縮形: `/r`|  
+|\/serializable|シリアル化可能属性でマークされたクラスを生成します。<br /><br /> 短縮形: `/s`|  
+|\/serviceContract|サービス コントラクトのコードのみを生成します。 クライアント クラスと構成は生成されません。<br /><br /> 短縮形: `/sc`|  
+|\/serializer:Auto|シリアル化可能属性でマークされたクラスを生成します。<br /><br /> 短縮形: `/s`|  
+|\/serializer:DataContractSerializer|シリアル化と逆シリアル化にデータ コントラクト シリアライザーを使用するデータ型を生成します。<br /><br /> 短縮形: `/ser:DataContractSerializer`|  
+|\/serializer:XmlSerializer|シリアル化と逆シリアル化に <xref:System.Xml.Serialization.XmlSerializer> を使用するデータ型を生成します。<br /><br /> 短縮形: `/ser:XmlSerializer`|  
+|\/targetClientVersion|アプリケーションが対象としている [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のバージョンを指定します。 有効値は `Version30` または `Version35` です。 既定値は `Version30` です。<br /><br /> 短縮形: `/tcv`<br /><br /> `Version30`: `/tcv:Version30` を使用するクライアントのコードを生成している場合は、[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] を使用します。<br /><br /> `Version35`: `/tcv:Version35` を使用するクライアントのコードを生成している場合は、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] を使用します。`/tcv:Version35` スイッチを指定して `/async` を使用している場合は、イベントベースおよびコールバック\/デリゲートベースの非同期メソッドが生成されます。 また、LINQ 対応のデータセットおよび <xref:System.DateTimeOffset> のサポートが有効になっています。|  
+|\/wrapped|ラップされたパラメーターを含んでいるドキュメント リテラル スタイルのドキュメントに特別な大文字と小文字の規則が使用されるかどうかを制御します。 通常の大文字と小文字の規則を指定するには、[Service Model Metadata Utility Tool \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) ツールで **\/wrapped** スイッチを使用します。|  
+  
+> [!NOTE]
+>  サービス バインディングがシステム指定のバインディング \(「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照\) のいずれかであり、<xref:System.ServiceModel.ServiceContractAttribute.ProtectionLevel%2A> プロパティが `None` または `Sign` のどちらかに設定されている場合、Svcutil は、予期されるシステム指定の要素の代わりに [\<customBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) 要素を使用して構成ファイルを生成します。 たとえば、サービスが、`<wsHttpBinding>` が `ProtectionLevel` に設定された `Sign` 要素を使用する場合、生成される構成には、バインディング セクションに `<customBinding>` の代わりに `<wsHttpBinding>` があります。 保護レベルの詳細については、「[保護レベルの理解](../../../docs/framework/wcf/understanding-protection-level.md)」を参照してください。  
+  
+### メタデータのエクスポート  
+ Svcutil.exe は、コンパイル済みアセンブリのサービス、コントラクト、およびデータ型のメタデータをエクスポートできます。 サービスのメタデータをエクスポートするには、`/serviceName` オプションを使用して、エクスポートするサービスを指定する必要があります。 アセンブリ内のすべてのデータ コントラクト型をエクスポートするには、`/dataContractOnly` オプションを使用する必要があります。 既定では、入力アセンブリのすべてのサービス コントラクトのメタデータがエクスポートされます。  
+  
+ `svcutil.exe [/t:metadata] [/serviceName:<serviceConfigName>] [/dataContractOnly] <assemblyPath>*`  
+  
+|引数|説明|  
+|--------|--------|  
+|`assemblyPath`|エクスポートされるサービス、コントラクト、またはデータ コントラクト型を格納するアセンブリへのパスを指定します。 標準のコマンド ライン ワイルドカードを使用して、複数のファイルを入力として指定できます。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\/serviceName:\<serviceConfigName\>|エクスポートされるサービスの構成名を指定します。 このオプションを使用した場合、関連構成ファイルが存在する実行可能アセンブリを入力として渡す必要があります。 Svcutil.exe は、すべての関連構成ファイルからサービス構成を検索します。 構成ファイルが拡張型を含む場合、これらの型を含むアセンブリは GAC に存在するか、`/reference` オプションを使用して明示的に指定される必要があります。|  
+|\/reference:\<file path\>|指定したアセンブリを、型参照の解決に使用するアセンブリの集合に追加します。 サービスのエクスポートまたは検証に、構成に登録されているサードパーティ製拡張機能 \(Behaviors、Bindings、および BindingElements\) を使用している場合は、このオプションを使用して GAC に含まれていない拡張機能アセンブリを指定します。<br /><br /> 短縮形: `/r`|  
+|\/dataContractOnly|データ コントラクト型に対してのみ機能します。 サービス コントラクトは処理されません。<br /><br /> このオプションにはローカル メタデータ ファイルだけを指定する必要があります。<br /><br /> 短縮形: `/dconly`|  
+|\/excludeType:\<type\>|エクスポートから除外する完全修飾またはアセンブリ修飾の型名を指定します。 このオプションは、エクスポートから型を除外するために、サービスのメタデータまたはサービス コントラクトのセットをエクスポートするときに使用できます。 このオプションは `/dconly` オプションとは併用できません。<br /><br /> 複数のサービスを含む単一のアセンブリが存在し、それぞれのサービスが同じ XSD 名の別のクラスを使用している場合は、このスイッチに XSD クラス名の代わりにサービス名を指定する必要があります。<br /><br /> XSD またはデータ コントラクト型はサポートされていません。<br /><br /> 短縮形: `/et`|  
+  
+### サービスの検証  
+ 検証は、サービスをホストせずにサービス実装でエラーを検出するために使用できます。`/serviceName` オプションを使用して、検証するサービスを指定する必要があります。  
+  
+ `svcutil.exe /validate /serviceName:<serviceConfigName>  <assemblyPath>*`  
+  
+|引数|説明|  
+|--------|--------|  
+|`assemblyPath`|検証するサービス型を格納するアセンブリへのパスを指定します。 アセンブリに、サービス構成を提供する関連構成ファイルが存在している必要があります。 標準のコマンド ライン ワイルドカードを使用して、複数のアセンブリを指定できます。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\/validate|`/serviceName` オプションによって指定されたサービス実装を検証します。 このオプションを使用した場合、関連構成ファイルが存在する実行可能アセンブリを入力として渡す必要があります。<br /><br /> 短縮形: `/v`|  
+|\/serviceName:\<serviceConfigName\>|検証するサービスの構成名を指定します。 Svcutil.exe は、すべての入力アセンブリのすべての関連構成ファイルからサービス構成を検索します。 構成ファイルが拡張型を含む場合、これらの型を含むアセンブリは GAC に存在するか、`/reference` オプションを使用して明示的に指定される必要があります。|  
+|\/reference:\<file path\>|指定したアセンブリを、型参照の解決に使用するアセンブリの集合に追加します。 サービスのエクスポートまたは検証に、構成に登録されているサードパーティ製拡張機能 \(Behaviors、Bindings、および BindingElements\) を使用している場合は、このオプションを使用して GAC に含まれていない拡張機能アセンブリを指定します。<br /><br /> 短縮形: `/r`|  
+|\/dataContractOnly|データ コントラクト型に対してのみ機能します。 サービス コントラクトは処理されません。<br /><br /> このオプションにはローカル メタデータ ファイルだけを指定する必要があります。<br /><br /> 短縮形: `/dconly`|  
+|\/excludeType:\<type\>|検証から除外する完全修飾のまたはアセンブリ修飾の型名を指定します。<br /><br /> 短縮形: `/et`|  
+  
+### メタデータのダウンロード  
+ Svcutil.exe を使用すると、実行中のサービスからメタデータをダウンロードして、ローカル ファイルに保存できます。 メタデータをダウンロードするには、`/t:metadata` オプションを指定する必要があります。 それ以外の場合は、クライアント コードが生成されます。 URL スキームが HTTP および HTTPS の場合、Svcutil.exe はメタデータの抽出に WS\-Metadata Exchange および DISCO を使用します。 その他の URL スキームの場合、Svcutil.exe は WS\-Metadata Exchange のみを使用します。  
+  
+ Svcutil は、メタデータを取得するために次のメタデータ要求を同時に発行します。  
+  
+-   指定されたアドレスへの MEX \(WS\-Transfer\) 要求  
+  
+-   指定されたアドレスへの \/mex 付きの MEX 要求  
+  
+-   指定されたアドレスへの \(ASMX から DiscoveryClientProtocol を使用した\) DISCO 要求  
+  
+ 既定では、Svcutil.exe は <xref:System.ServiceModel.Description.MetadataExchangeBindings> クラスに定義されているバインディングを使用して、MEX 要求を行います。 WS\-Metadata Exchange で使用するバインディングを構成するには、IMetadataExchange コントラクトを使用するクライアント エンドポイントを構成に定義する必要があります。 これを定義できる場所は、Svcutil.exe の構成ファイルか、`/svcutilConfig` オプションを使用して指定された別の構成ファイルです。  
+  
+ `svcutil.exe /t:metadata  <url>* | <epr>`  
+  
+|引数|説明|  
+|--------|--------|  
+|`url`|メタデータを提供するサービス エンドポイントの URL またはオンラインになっているメタデータ ドキュメントの URL。|  
+|`epr`|WS\-Metadata Exchange をサポートするサービス エンドポイントの WS\-Addressing EndpointReference を含む XML ファイルへのパスです。|  
+  
+### XmlSerializer 型の生成  
+ <xref:System.Xml.Serialization.XmlSerializer> を使用してシリアル化できるデータ型を使用するサービスおよびクライアント アプリケーションは、実行時にこのようなデータ型のシリアル化コードを生成およびコンパイルします。このため、起動時のパフォーマンスが低下することがあります。  
+  
+> [!NOTE]
+>  事前生成済みシリアル化コードはクライアント アプリケーションでのみ使用できます。サービスでは使用できません。  
+  
+ Svcutil.exe は、必要な C\# シリアル化コードをアプリケーションのコンパイル済みアセンブリから生成できるため、このようなアプリケーションの起動時のパフォーマンスが改善されます。 詳細については、「[方法 : XmlSerializer を使用する WCF クライアント アプリケーションの起動時間を短縮する](../../../docs/framework/wcf/feature-details/startup-time-of-wcf-client-applications-using-the-xmlserializer.md)」を参照してください。  
+  
+> [!NOTE]
+>  Svcutil.exe は、入力アセンブリに存在するサービス コントラクトによって使用される型用のコードを生成します。  
+  
+ `svcutil.exe /t:xmlSerializer  <assemblyPath>*`  
+  
+|引数|説明|  
+|--------|--------|  
+|`assemblyPath`|サービス コントラクト型を格納するアセンブリへのパスを指定します。 シリアル化型は、各コントラクトのすべての Xml シリアル化可能型に対して生成されます。|  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\/reference:\<file path\>|指定したアセンブリを、型参照の解決に使用するアセンブリの集合に追加します。<br /><br /> 短縮形: `/r`|  
+|\/excludeType:\<type\>|エクスポートや検証から除外する完全修飾のまたはアセンブリ修飾の型名を指定します。<br /><br /> 短縮形: `/et`|  
+|\/out:\<file\>|生成されるコードのファイル名を指定します。 このオプションは、複数のアセンブリが入力としてツールに渡される場合は無視されます。<br /><br /> 既定 : アセンブリ名から派生します。<br /><br /> 短縮形: `/o`|  
+|\/UseSerializerForFaults|既定の <xref:System.Xml.XmlSerializer> ではなく、<xref:System.Runtime.Serialization.DataContractSerializer> をエラーの読み書きに使用する必要があることを指定します。|  
+  
+## 例  
+ 次のコマンドにより、実行中のサービスまたはオンラインのメタデータ ドキュメントからクライアント コードが生成されます。  
+  
+ `svcutil http://service/metadataEndpoint`  
+  
+ 次のコマンドにより、ローカルのメタデータ ドキュメントからクライアント コードが生成されます。  
+  
+ `svcutil *.wsdl *.xsd /language:C#`  
+  
+ 次のコマンドにより、ローカルのスキーマ ドキュメントからデータ コントラクト型が Visual Basic で生成されます。  
+  
+ `svcutil /dconly *.xsd /language:VB`  
+  
+ 次のコマンドにより、実行中のサービスからメタデータ ドキュメントがダウンロードされます。  
+  
+ `svcutil /t:metadata http://service/metadataEndpoint`  
+  
+ 次のコマンドにより、アセンブリに含まれるサービス コントラクトと関連する型のメタデータ ドキュメントが生成されます。  
+  
+ `svcutil myAssembly.dll`  
+  
+ 次のコマンドにより、アセンブリに含まれるサービス、すべての関連するサービス コントラクト、およびデータ型のメタデータ ドキュメントが生成されます。  
+  
+ `svcutil myServiceHost.exe /serviceName:myServiceName`  
+  
+ 次のコマンドにより、アセンブリに含まれるデータ型のメタデータ ドキュメントが生成されます。  
+  
+ `svcutil myServiceHost.exe /dconly`  
+  
+ 次のコマンドにより、サービス ホスティングが検証されます。  
+  
+ `svcutil /validate /serviceName:myServiceName myServiceHost.exe`  
+  
+ 次のコマンドにより、アセンブリに含まれているサービス コントラクトによって使用される <xref:System.Xml.Serialization.XmlSerializer> 型用のシリアル化型を生成します。  
+  
+ `svcutil /t:xmlserializer myContractLibrary.exe`  
+  
+## 最大 Nametable 文字数のクォータ  
+ svcutil を使用してサービスのメタデータを生成する場合、次のメッセージが表示されます。  
+  
+ エラー: http:\/\/localhost:8000\/somesservice\/mex からメタデータを取得できません。XML データの読み取り中に、最大 nametable 文字数のクォータ \(16384\) を超えました。 nametable は、XML 処理時に検出された文字列を格納するためのデータ構造です。反復されない要素名、属性名、および属性値が含まれた長い XML ドキュメントによってこのクォータがトリガーされることがあります。 このクォータを増やすには、XML リーダーの作成時に使用される XmlDictionaryReaderQuotas オブジェクトの MaxNameTableCharCount プロパティを変更してください。  
+  
+ このエラーの原因は、メタデータの要求時に大きな WSDL ファイルを返すサービスである可能性があります。 その結果、svcutil.exe ツールの文字のクォータを超えることになります。 この値は、サービス拒否 \(dos\) 攻撃を防止するために設定されています。 このクォータは、次の svcutil の構成ファイルを指定して増やすことができます。  
+  
+ 次の構成ファイルは、svcutil のリーダーのクォータの設定方法を示しています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+            <customBinding>  
+                <binding name="MyBinding">  
+                    <textMessageEncoding>  
+                        <readerQuotas maxDepth="2147483647" maxStringContentLength="2147483647"  
+                            maxArrayLength="2147483647" maxBytesPerRead="2147483647" maxNameTableCharCount="2147483647" />  
+                    </textMessageEncoding>  
+                    <httpTransport maxReceivedMessageSize="2147483647" maxBufferSize="2147483647" />  
+                </binding>  
+            </customBinding>  
+        </bindings>  
+        <client>  
+            <endpoint binding="customBinding" bindingConfiguration="MyBinding"  
+                contract="IMetadataExchange"  
+                name="http" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+```  
+  
+ svcutil.exe.config という名前の新しいファイルを作成し、XML のコード例をこのファイルにコピーします。 svcutil.exe と同じディレクトリにファイルを配置します。 次回 svcutil.exe が実行されると、新しい設定が適用されます。  
+  
+## セキュリティに関する注意事項  
+ 適切なアクセス制御リスト \(ACL\) を使用して、Svcutil.exe のインストール フォルダー、Svcutil.config、および `/svcutilConfig` によって示されるファイルを保護する必要があります。 これによって、悪質な拡張機能が登録されて実行されるのを防ぐことができます。  
+  
+ さらに、セキュリティの侵害を最小限に抑えるために、信頼できない拡張機能をシステムの一部として追加したり、信頼できないコード プロバイダーを Svcutil.exe で使用しないようにする必要があります。  
+  
+ また、現在のプロセスにサービス拒否を引き起こす可能性があるため、アプリケーションの中間層でツールを使用しないようにする必要があります。  
+  
+## 参照  
+ <xref:System.Runtime.Serialization.DataContractAttribute>   
+ <xref:System.Runtime.Serialization.DataMemberAttribute>   
+ [方法 : クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/servicemodelreg-exe.md b/docs/framework/wcf/servicemodelreg-exe.md
new file mode 100644
index 00000000000..39eff950cc1
--- /dev/null
+++ b/docs/framework/wcf/servicemodelreg-exe.md
@@ -0,0 +1,93 @@
+---
+title: "ServiceModel 登録ツール (ServiceModelReg.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+ms.assetid: 396ec5ae-e34f-4c64-a164-fcf50e86b6ac
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# ServiceModel 登録ツール (ServiceModelReg.exe)
+このコマンド ライン ツールは、単一コンピューター上で WCF および WF コンポーネントの登録を管理するための機能を提供します。WCF および WF コンポーネントはインストール時に構成されるため、通常の状況ではこのツールを使用する必要はありません。しかし、サービスのアクティブ化に関する問題が発生する場合は、このツールを使用してコンポーネントを登録できます。  
+  
+## 構文  
+  
+```  
+  
+ServiceModelReg.exe[(-ia|-ua|-r)|((-i|-u) -c:<command>)] [-v|-q] [-nologo] [-?]  
+```  
+  
+## 解説  
+ ツールは次の場所にあります。  
+  
+ %SystemRoot%\\Microsoft.Net\\Framework\\v3.0\\Windows Communication Foundation\\  
+  
+> [!NOTE]
+>  [!INCLUDE[wv](../../../includes/wv-md.md)] で ServiceModel 登録ツールを実行している場合は、**\[Windows の機能\]** ダイアログ ボックスに、**\[Microsoft .NET Framework 3.0\]** の下にある **\[Windows Communication Foundation HTTP Activation\]** オプションが有効であることが反映されない場合があります。**\[Windows の機能\]** ダイアログ ボックスには、**\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** をクリックして、「**OptionalFeatures**」と入力することでアクセスできます。  
+  
+ 次の表は、ServiceModelReg.exe で使用できるオプションを示します。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`-ia`|WCF および WF のすべてのコンポーネントをインストールします。|  
+|`-ua`|WCF および WF のすべてのコンポーネントをアンインストールします。|  
+|`-r`|WCF および WF のすべてのコンポーネントを修復します。|  
+|`-i`|\-c で指定された WCF および WF のコンポーネントをインストールします。|  
+|`-u`|\-c で指定された WCF および WF のコンポーネントをアンインストールします。|  
+|`-c`|コンポーネントをインストールまたはアンインストールします。<br /><br /> -   httpnamespace \- HTTP 名前空間の予約<br />-   tcpportsharing –TCP ポート共有サービス<br />-   tcpactivation \- TCP アクティベーション サービス \(.NET 4 クライアント プロファイルでは非サポート\)<br />-   namedpipeactivation \- 名前付きパイプ アクティベーション サービス \(.NET 4 クライアント プロファイルでは非サポート\)<br />-   msmqactivation \- MSMQ アクティベーション サービス \(.NET 4 クライアント プロファイルでは非サポート\)<br />-   etw \- ETW イベント トレース マニフェスト \(Windows Vista またはそれ以降\)|  
+|`-q`|Quiet モード \(エラー ログのみ表示\)|  
+|`-v`|Verbose モード|  
+|`-nologo`|著作権やバナー メッセージを表示しません。|  
+|`-?`|ヘルプ テキストを表示します。|  
+  
+## FileLoadException エラーの修正  
+ コンピューターに以前のバージョンの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] をインストールしている場合は、ServiceModelReg ツールを実行して新しいインストールを登録するときに、`FileLoadFoundException` エラーが発生することがあります。旧バージョンのインストールから手動でファイルを削除しても、machine.config 設定が元のままである限り、このエラーが発生する可能性があります。  
+  
+ エラー メッセージは、次のようになります。  
+  
+```  
+Error: System.IO.FileLoadException: Could not load file or assembly 'System.ServiceModel, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040)  
+File name: 'System.ServiceModel, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089'  
+```  
+  
+ System.ServiceModel Version 2.0.0.0 アセンブリが旧 CTP \(Customer Technology Preview\) リリースによってインストールされていたというエラー メッセージに注目する必要があります。最新バージョンの System.ServiceModel アセンブリは、2.0.0.0 ではなく 3.0.0.0 です。したがって、旧 CTP リリースの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] がインストールされたままで、完全にはアンインストールされていないコンピューターに正式の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] リリースをインストールすると、この問題が発生します。  
+  
+ ServiceModelReg.exe は、旧バージョンのエントリをクリーンアップすることも、新しいバージョンのエントリを登録することもできません。唯一の回避策は、machine.config を手動で編集することです。このファイルは次の場所にあります。  
+  
+```  
+%windir%\Microsoft.NET\Framework\v2.0.50727\config\machine.config   
+```  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を 64 ビット コンピューターで実行している場合は、次の場所にある同じファイルも編集する必要があります。  
+  
+```  
+%windir%\Microsoft.NET\Framework64\v2.0.50727\config\machine.config   
+```  
+  
+ "System.ServiceModel, Version\=2.0.0.0" を参照しているこのファイル内の XML ノードを見つけ、それらのノードと子ノードを削除します。ファイルを保存し ServiceModelReg.exe を再実行すると、この問題は解決します。  
+  
+## 例  
+ 次の例に、ServiceModelReg.exe ツールの最も一般的なオプションの使用方法を示します。  
+  
+```  
+ServiceModelReg.exe -ia  
+  Installs all components  
+ServiceModelReg.exe -i -c:httpnamespace -c:etw  
+  Installs HTTP namespace reservation and ETW manifests  
+ServiceModelReg.exe -u -c:etw  
+  Uninstalls ETW manifests  
+ServiceModelReg.exe -r  
+  Repairs an extended install  
+```
\ No newline at end of file
diff --git a/docs/framework/wcf/services-and-transactions.md b/docs/framework/wcf/services-and-transactions.md
new file mode 100644
index 00000000000..5e5677c5699
--- /dev/null
+++ b/docs/framework/wcf/services-and-transactions.md
@@ -0,0 +1,101 @@
+---
+title: "サービスとトランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], サービスとトランザクションの設計"
+ms.assetid: 864813ff-2709-4376-912d-f5c8d318c460
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# サービスとトランザクション
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでは、クライアントからトランザクションを開始し、そのトランザクションをサービス操作内で調整できます。クライアントはトランザクションを開始し、複数のサービス操作を呼び出す可能性があります。サービス操作が、1 つの単位としてコミットまたはロールバックされます。  
+  
+ サービス コントラクトでトランザクション動作を有効にするには、<xref:System.ServiceModel.ServiceBehaviorAttribute> を指定し、クライアント トランザクションを必要とするサービス操作について <xref:System.ServiceModel.ServiceBehaviorAttribute.TransactionIsolationLevel%2A> プロパティと <xref:System.ServiceModel.OperationBehaviorAttribute.TransactionScopeRequired%2A> プロパティを設定します。<xref:System.ServiceModel.OperationBehaviorAttribute.TransactionAutoComplete%2A> パラメーターは、未処理の例外がスローされなかった場合に、メソッドが実行されているトランザクションが自動的に完了されるかどうかを指定します。ここに挙げた属性[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ServiceModel トランザクションの属性](../../../docs/framework/wcf/feature-details/servicemodel-transaction-attributes.md)」を参照してください。  
+  
+ データベース更新の記録など、サービス操作で実行され、リソース マネージャーで管理される作業は、クライアント トランザクションの一部です。  
+  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性と <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用して、サービス側のトランザクション動作を制御する方法を次の例に示します。  
+  
+```  
+[ServiceBehavior(TransactionIsolationLevel = System.Transactions.IsolationLevel.Serializable)]  
+public class CalculatorService: ICalculatorLog  
+{  
+    [OperationBehavior(TransactionScopeRequired = true,  
+                           TransactionAutoComplete = true)]  
+    public double Add(double n1, double n2)  
+    {  
+        recordToLog(String.Format("Added {0} to {1}", n1, n2));  
+        return n1 + n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                               TransactionAutoComplete = true)]  
+    public double Subtract(double n1, double n2)  
+    {  
+        recordToLog(String.Format("Subtracted {0} from {1}", n1, n2));  
+        return n1 - n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                                       TransactionAutoComplete = true)]  
+    public double Multiply(double n1, double n2)  
+    {  
+        recordToLog(String.Format("Multiplied {0} by {1}", n1, n2));  
+        return n1 * n2;  
+    }  
+  
+    [OperationBehavior(TransactionScopeRequired = true,   
+                                       TransactionAutoComplete = true)]  
+    public double Divide(double n1, double n2)  
+    {  
+        recordToLog(String.Format("Divided {0} by {1}", n1, n2));  
+        return n1 / n2;  
+    }  
+  
+}  
+```  
+  
+ 次のサンプル構成に示すように、WS\-AtomicTransaction プロトコルを使用するようにクライアントとサービスのバインディングを構成し、[\<transactionFlow\>](../../../docs/framework/configure-apps/file-schema/wcf/transactionflow.md) 要素を `true` に設定することで、トランザクションとトランザクション フローを有効にできます。  
+  
+```  
+<client>  
+    <endpoint address="net.tcp://localhost/ServiceModelSamples/service"   
+          binding="netTcpBinding"   
+          bindingConfiguration="netTcpBindingWSAT"   
+          contract="Microsoft.ServiceModel.Samples.ICalculatorLog" />  
+</client>  
+  
+<bindings>  
+    <netTcpBinding>  
+        <binding name="netTcpBindingWSAT"  
+                transactionFlow="true"  
+                transactionProtocol="WSAtomicTransactionOctober2004" />  
+     </netTcpBinding>  
+</bindings>  
+```  
+  
+ クライアントは、<xref:System.Transactions.TransactionScope> を作成し、トランザクションのスコープ内でサービス操作を呼び出すことにより、トランザクションを開始できます。  
+  
+```  
+using (TransactionScope ts = new TransactionScope(TransactionScopeOption.RequiresNew))  
+{  
+    //Do work here  
+    ts.Complete();  
+}  
+```  
+  
+## 参照  
+ [System.ServiceModel でのトランザクション サポート](../../../docs/framework/wcf/feature-details/transactional-support-in-system-servicemodel.md)   
+ [トランザクション モデル](../../../docs/framework/wcf/feature-details/transaction-models.md)   
+ [WS トランザクション フロー](../../../docs/framework/wcf/samples/ws-transaction-flow.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/simplified-configuration.md b/docs/framework/wcf/simplified-configuration.md
new file mode 100644
index 00000000000..a620f2cc985
--- /dev/null
+++ b/docs/framework/wcf/simplified-configuration.md
@@ -0,0 +1,128 @@
+---
+title: "簡略化された構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dcbe1f84-437c-495f-9324-2bc09fd79ea9
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 簡略化された構成
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスの構成は複雑な作業になることがあります。  さまざまなオプションがあり、どの設定が必要であるかをいつでも簡単に判断できるとは限りません。  構成ファイルを使用することで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの柔軟性は高まりますが、構成ファイルは、発見しにくい問題の多くの根源でもあります。  [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] では、このような問題に対応し、サービス構成の規模と複雑さを軽減する手段を提供しています。  
+  
+## 簡略化された構成  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のサービス構成ファイルでは、\<`system.serviceModel`\> セクションに、ホストされる各サービスの \<`service`\> 要素が含まれます。  \<`service`\> 要素には、各サービスに対して公開されるエンドポイントと、必要に応じて一連のサービス動作を指定する \<`endpoint`\> 要素が含まれます。  \<`endpoint`\> 要素は、エンドポイントが公開するアドレス、バインド、およびコントラクトと、必要に応じてバインド構成およびエンドポイントの動作を指定します。  \<`system.serviceModel`\> セクションには、サービスまたはエンドポイントの動作を指定できる \<`behaviors`\> 要素も含まれます。  構成ファイルの \<`system.serviceModel`\> セクションの例を次に示します。  
+  
+```  
+system.serviceModel>  
+  <behaviors>  
+    <serviceBehaviors>  
+      <behavior name="MyServiceBehavior">  
+        <serviceMetadata httpGetEnabled="true">  
+        <serviceDebug includeExceptionDetailInFaults="false">  
+      </behavior>  
+    </serviceBehaviors>  
+  </behaviors>  
+  <bindings>  
+   <basicHttpBinding>  
+      <binding name=MyBindingConfig"  
+               maxBufferSize="100"  
+               maxReceiveBufferSize="100" />  
+   </basicHttpBinding>  
+   </bindings>   <services>  
+    <service behaviorConfiguration="MyServiceBehavior"  
+             name="MyService">  
+      <endpoint address=""  
+                binding="basicHttpBinding"  
+                contract="ICalculator"  
+                bindingConfiguration="MyBindingConfig" />  
+      <endpoint address="mex"  
+                binding="mexHttpBinding"  
+                contract="IMetadataExchange"/>  
+    </service>  
+  </services>  
+</system.serviceModel>  
+  
+```  
+  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] では、\<`service`\> 要素の要件を廃止することで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの構成を簡略化しています。  \<`service`\> セクションを追加したり、\<`service`\> セクションにエンドポイントを追加したりせず、サービスがプログラムを使用してエンドポイントを定義しない場合は、一連の既定のエンドポイントが自動的にサービスに追加されます。この場合、各サービスのベース アドレスに対して 1 つ、サービスによって実装される各コントラクトに対して 1 つのエンドポイントが追加されます。  これらの各エンドポイントでは、エンドポイント アドレスがベース アドレスに対応し、バインドがベース アドレス スキームで決定されます。また、コントラクトは、サービスによって実装されるコントラクトになります。  エンドポイントまたはサービスの動作を指定する必要も、バインド設定を変更する必要もない場合、サービス構成ファイルを指定する必要はありません。  サービスが 2 つのコントラクトを実装し、ホストが HTTP トランスポートと TCP トランスポートの両方を有効にしている場合、サービス ホストは、それぞれのトランスポートを使用する各コントラクトに対して 1 つずつ、合計 4 つの既定のエンドポイントを作成します。  既定のエンドポイントを作成するには、使用するバインドをサービス ホストに伝える必要があります。  これらの設定は、\<`system.serviceModel`\> セクション内の \<`protocolMappings`\> セクションに指定します。  \<`protocolMappings`\> セクションには、バインドの型にマップされたトランスポート プロトコル スキームの一覧が設定されます。  サービス ホストは、渡されたベース アドレスを使用して、使用するバインドを決定します。  次の例では、\<`protocolMappings`\> 要素を使用しています。  
+  
+> [!WARNING]
+>  バインディングまたは動作のような既定の構成要素を変更すると、構成階層の下のレベルで定義されたサービスはこれらの既定のバインディングおよび動作を使用している可能性があるため、影響を受けることがあります。  したがって、既定のバインディングおよび動作を変更する場合は、これらの変更が階層の他のサービスに影響を与える可能性があることに注意する必要があります。  
+  
+> [!NOTE]
+>  インターネット インフォメーション サービス \(IIS\) または Windows プロセス アクティブ化サービス \(WAS\) にホストされるサービスは、仮想ディレクトリをベース アドレスとして使用します。  
+  
+```  
+<protocolMapping>  
+  <add scheme="http"     binding="basicHttpBinding" bindingConfiguration="MyBindingConfiguration"/>  
+  <add scheme="net.tcp"  binding="netTcpBinding"/>  
+  <add scheme="net.pipe" binding="netNamedPipeBinding"/>  
+  <add scheme="net.msmq" binding="netMSMQBinding"/>  
+</protocolMapping>  
+  
+```  
+  
+ 前の例では、"http" スキームで始まるベース アドレスのエンドポイントは、<xref:System.ServiceModel.BasicHttpBinding> を使用します。  "net.tcp" スキームで始まるベース アドレスのエンドポイントは、<xref:System.ServiceModel.NetTcpBinding> を使用します。  ローカルの App.config または Web.config ファイルの設定はオーバーライドできます。  
+  
+ \<`protocolMappings`\> セクション内の各要素は、スキームとバインドを指定する必要があります。  必要に応じて、構成ファイルの \<`bindings`\> セクション内で、バインド構成を指定する `bindingConfiguration` 属性を指定できます。  `bindingConfiguration` が指定されていない場合は、適切なバインド型の匿名バインド構成が使用されます。  
+  
+ 既定のエンドポイントでは、\<`serviceBehaviors`\> セクション内の匿名の \<`behavior`\> セクションを使用して、サービスの動作が構成されます。  サービスの動作の構成には、\<`serviceBehaviors`\> 内の、名前が付けられていない \<`behavior`\> 要素が使用されます。  たとえば、次の構成ファイルでは、ホスト内のすべてのサービスで、サービス メタデータの公開が有効になります。  
+  
+```  
+<system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>    <!-- No <service> tag is necessary. Default endpoints are added to the service -->  
+    <!-- The service behavior with name="" is picked up by the service -->  
+ </system.serviceModel>  
+```  
+  
+ エンドポイントの動作は、\<`serviceBehaviors`\> セクション内の匿名の \<`behavior`\> セクションを使用して構成されます。  
+  
+ 以下は、このトピックの最初にある例と同じ内容ですが、簡略化された構成モデルを使用している構成ファイルの例です。  
+  
+```  
+<system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <serviceMetadata httpGetEnabled="True"/>  
+          <serviceDebug includeExceptionDetailInFaults="false"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>    <bindings>  
+       <basicHttpBinding>  
+          <binding maxBufferSize="100"  
+                   maxReceiveBufferSize="100" />  
+       </basicHttpBinding>  
+    </bindings>    <!-- No <service> tag is necessary. Default endpoints will be added to the service -->  
+    <!-- The service behavior with name="" will be picked up by the service -->  
+    <protocolMapping>  
+      <add scheme="http"     binding="basicHttpBinding" / </protocolMapping>  
+  </system.serviceModel>  
+```  
+  
+> [!IMPORTANT]
+>  この機能は、WCF サービス構成にのみ適用され、クライアント構成には適用されません。  ほとんどの場合、WCF クライアント構成は、svcutil.exe などのツールを使用したり、Visual Studio からサービス参照を追加したりすることで生成されます。  手動で WCF クライアントを構成する場合は、構成に \<client\> 要素を追加し、呼び出すエンドポイントを指定する必要があります。  
+  
+## 参照  
+ [構成ファイルを使用してサービスを構成する方法](../../../docs/framework/wcf/configuring-services-using-configuration-files.md)   
+ [サービスのバインディングの構成](../../../docs/framework/wcf/configuring-bindings-for-wcf-services.md)   
+ [システムが提供するバインディングの構成](../../../docs/framework/wcf/feature-details/configuring-system-provided-bindings.md)   
+ [サービスの構成](../../../docs/framework/wcf/configuring-services.md)   
+ [Configuring Windows Communication Foundation Applications](http://msdn.microsoft.com/ja-jp/13cb368e-88d4-4c61-8eed-2af0361c6d7a)   
+ [コード内での WCF サービスの構成](../../../docs/framework/wcf/configuring-wcf-services-in-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/specifying-an-endpoint-address.md b/docs/framework/wcf/specifying-an-endpoint-address.md
new file mode 100644
index 00000000000..173a6a55354
--- /dev/null
+++ b/docs/framework/wcf/specifying-an-endpoint-address.md
@@ -0,0 +1,96 @@
+---
+title: "エンドポイント アドレスの指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "アドレス指定のエンドポイント [WCF]"
+ms.assetid: ac24f5ad-9558-4298-b168-c473c68e819b
+caps.latest.revision: 41
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 41
+---
+# エンドポイント アドレスの指定
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスを使用して行われるすべての通信では、エンドポイントが使用されます。 各<xref:System.ServiceModel.Description.ServiceEndpoint>が含まれています、<xref:System.ServiceModel.Description.ServiceEndpoint.Address%2A>、<xref:System.ServiceModel.Description.ServiceEndpoint.Binding%2A>、および<xref:System.ServiceModel.Description.ServiceEndpoint.Contract%2A>します。 コントラクトでは、使用できる操作を指定します。 バインディングでは、サービスとの通信方法を指定し、アドレスでは、サービスの場所を指定します。 各エンドポイントには、一意のアドレスを設定する必要があります。 エンドポイント アドレスがによって表される、 <xref:System.ServiceModel.EndpointAddress> 、識別子 URI (Uniform Resource) を表すサービスのアドレスを保持しているクラス、 <xref:System.ServiceModel.EndpointAddress.Identity%2A>、サービスのセキュリティ id とオプションのコレクションを表します<xref:System.ServiceModel.EndpointAddress.Headers%2A>します。 オプション ヘッダーは、エンドポイントの識別または対話のために、より詳細なアドレス指定情報を提供します。 たとえば、ヘッダーを使用して、受信メッセージの処理方法や、エンドポイントからの応答メッセージの送信先を指定できるほか、複数のサービス インスタンスが使用できる場合に、特定ユーザーからの受信メッセージの処理に使用するインスタンスを指定できます。  
+  
+## <a name="definition-of-an-endpoint-address"></a>エンドポイント アドレスの定義  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]、 <xref:System.ServiceModel.EndpointAddress> Ws-addressing 仕様で定義されているエンドポイント参照 (EPR) をモデル化します。  
+  
+ ほとんどのトランスポートの URI アドレスは、4 つの部分から構成されます。 たとえば、"http://www.fabrikam.com:322/mathservice.svc/secureEndpoint" という URI は、次の&4; つの部分から構成されます。  
+  
+-   スキーム : http:  
+  
+-   コンピューター : www.fabrikam.com  
+  
+-   (省略可能) ポート: 322  
+  
+-   パス : /mathservice.svc/secureEndpoint  
+  
+ EPR モデルの一部では、各エンドポイント参照は、追加の識別情報を追加する複数の参照パラメーターを伝達できます。 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]、これらの参照パラメーターは、のインスタンスとしてモデル化、 <xref:System.ServiceModel.Channels.AddressHeader>クラスです。  
+  
+ サービスのエンドポイント アドレスはコードを使用して強制的に指定するか、構成を介して宣言として指定できます。 設置済みサービスのバインドおよびアドレスは一般的に、サービスの開発中に使用されるものとは異なるので、コード内でエンドポイントを定義することは通常、実用的ではありません。 一般に、サービス エンドポイントの定義にはコードではなく、構成を使用する方がより実用的です。 バインディング情報とアドレス情報をコードに含めないことで、変更時にアプリケーションの再コンパイルや再展開を行う必要がなくなります。 エンドポイントがコードまたは構成で指定されていない場合、ランタイムは、サービスで実装されたコントラクトごとに、1 つの既定のエンドポイントを各ベース アドレスに追加します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] でサービスのエンドポイント アドレスを指定するには&2; つの方法があります。 サービスに関連付けられている各エンドポイントの絶対アドレスを指定することものベース アドレスを指定することができます、 <xref:System.ServiceModel.ServiceHost>サービスのこのベース アドレスに対して相対的に定義されているこのサービスに関連付けられた各エンドポイントのアドレスを指定します。 サービスのエンドポイント アドレスを指定するには、構成とコードのいずれかで、これらの各方法を使用します。 相対アドレスを指定しない場合、サービスはベース アドレスを使用します。 サービスに対して複数のベース アドレスを設定することもできますが、サービスが各トランスポートに対して設定できるベース アドレスは&1; つに限られます。 複数のエンドポイントがある場合、各エンドポイントには異なるバインディングで構成されるため、それぞれのアドレスは一意になります。 異なるコントラクトで同じバインディングを使用するエンドポイントは同じアドレスを使用できます。  
+  
+ IIS でホストする場合を管理しないと、 <xref:System.ServiceModel.ServiceHost>自分をインスタンス化します。 IIS でホストしているサービスでは、サービスの .svc ファイルで指定されているアドレスが常にベース アドレスになります。 そのため、IIS でホストされるサービスのエンドポイントでは、相対エンドポイント アドレスを使用する必要があります。 完全修飾されたエンドポイント アドレスを指定すると、サービスの展開時にエラーとなる可能性があります。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][インターネット インフォメーション サービスでホストされる WCF サービスの配置](../../../docs/framework/wcf/feature-details/deploying-an-internet-information-services-hosted-wcf-service.md)します。  
+  
+## <a name="defining-endpoint-addresses-in-configuration"></a>構成によるエンドポイント アドレスの定義  
+ 構成ファイルでエンドポイントを定義するには、使用、 [ <> \> ](http://msdn.microsoft.com/ja-jp/13aa23b7-2f08-4add-8dbf-a99f8127c017)要素。  
+  
+ [!code[S_UEHelloWorld#5](../../../samples/snippets/common/VS_Snippets_CFX/s_uehelloworld/common/serviceapp2.config#5)]  
+  
+ ときに、<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A>メソッドが呼び出されます (つまり、ホスト アプリケーションでは、サービスを開始しようとして)、システムは、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/service.md) "UE を指定する name 属性を持つ要素。Samples.HelloService"です。 場合、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/service.md)要素が見つかると、システムが、指定したクラスに読み込んで、構成ファイルで提供されるエンドポイントの定義を使用してエンドポイントを作成します。 このしくみによって、2 行のコードでサービスを読み込んで開始でき、バインディングとアドレス指定情報をコード外に維持することができます。 この方法の利点は、アプリケーションを再度コンパイルしたり、展開したりすることなく、この&2; つの情報を変更できる点です。  
+  
+ 省略可能なヘッダーがで宣言されている、 [ <> \</> \>](../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)します。 次に示す例では、構成ファイルでサービスのエンドポイントを指定するための要素で、2 つのヘッダー (http://tempuri1.org/ からの "Gold" クライアントと http://tempuri2.org/ からの "Standard" クライアント) を識別しています。 このサービスを呼び出すクライアントが、適切な必要[ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/headers-element.md)構成ファイルにします。  
+  
+ [!code[S_UEHelloWorld#1](../../../samples/snippets/common/VS_Snippets_CFX/s_uehelloworld/common/serviceapp.config#1)]  
+  
+ ヘッダーは、(上記のように) エンドポイントのすべてのメッセージに対してではなく、個別のメッセージに設定できます。 使用してこれは、 <xref:System.ServiceModel.OperationContextScope>を次の例で示すように、送信メッセージにカスタム ヘッダーを追加するクライアント アプリケーションで新しいコンテキストを作成します。  
+  
+ [!code-csharp[OperationContextScope#4](../../../samples/snippets/csharp/VS_Snippets_CFX/operationcontextscope/cs/client.cs#4)]
+ [!code-vb[OperationContextScope#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/operationcontextscope/vb/client.vb#4)]  
+  
+## <a name="endpoint-address-in-metadata"></a>メタデータ内のエンドポイント アドレス  
+ Web サービス記述言語 (WSDL) では、エンドポイント アドレスは、対応するエンドポイントの `EndpointReference` 要素内で WS-Addressing の `wsdl:port` (EPR) 要素として表されます。 EPR には、エンドポイントのアドレスのほかに、アドレスのすべてのプロパティが含まれます。 `wsdl:port` 内にある EPR では、次の例に示すように `soap:Address` を置き換えるので注意してください。  
+  
+  
+  
+## <a name="defining-endpoint-addresses-in-code"></a>コードによるエンドポイント アドレスの定義  
+ コードで作成できるエンドポイント アドレス、 <xref:System.ServiceModel.EndpointAddress>クラスです。 エンドポイント アドレスに指定する URI は、完全修飾パスまたはサービスのベース アドレスを基準にしたパスです。 次のコード例のインスタンスを作成する方法、 <xref:System.ServiceModel.EndpointAddress>し、クラスに追加、 <xref:System.ServiceModel.ServiceHost>サービスをホストしているインスタンス。  
+  
+ 次の例は、コードで完全なエンドポイント アドレスを指定する方法を示しています。  
+  
+ [!code-csharp[S_UEHelloWorld#2](../../../samples/snippets/csharp/VS_Snippets_CFX/s_uehelloworld/cs/snippet.cs#2)]  
+  
+ 次の例は、サービス ホストのベース アドレスに相対アドレス ("MyService") を追加する方法を示しています。  
+  
+ [!code-csharp[S_UEHelloWorld#3](../../../samples/snippets/csharp/VS_Snippets_CFX/s_uehelloworld/cs/snippet.cs#3)]  
+  
+> [!NOTE]
+>  プロパティ、 <xref:System.ServiceModel.Description.ServiceDescription>サービスでアプリケーションを変更しないでください以降に、 <xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A>メソッドを<xref:System.ServiceModel.ServiceHostBase>します。 一部のメンバーなど、<xref:System.ServiceModel.ServiceHostBase.Credentials%2A>プロパティおよび`AddServiceEndpoint`メソッド<xref:System.ServiceModel.ServiceHostBase>と<xref:System.ServiceModel.ServiceHost>、その時点以降後に変更された場合に例外をスローします。 変更を許可するメンバーもありますが、結果は未定義の状態になります。  
+>   
+>  同様に、クライアントで、 <xref:System.ServiceModel.Description.ServiceEndpoint>呼び出しの後に、値を変更しないでください<xref:System.ServiceModel.Channels.CommunicationObject.OnOpening%2A>上、 <xref:System.ServiceModel.ChannelFactory>します。 <xref:System.ServiceModel.ChannelFactory.Credentials%2A>プロパティは、その時点以降後に変更された場合に例外をスローします。 その他のクライアント記述値は、エラーを発生させずに変更できますが、結果は未定義の状態になります。  
+>   
+>  かどうか、サービスまたはクライアントは勧め呼び出しの前に説明を変更すること<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A>します。  
+  
+## <a name="using-default-endpoints"></a>既定のエンドポイントの使用  
+ エンドポイントがコードまたは構成で指定されていない場合、ランタイムは、サービスで実装されたサービス コントラクトごとに、1 つの既定のエンドポイントを各ベース アドレスに追加することで、既定のエンドポイントを提供します。 コードまたは構成では、ベース アドレスを指定することができ、既定のエンドポイントが追加されたときに<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A>で呼び出される、 <xref:System.ServiceModel.ServiceHost>します。  
+  
+ 既定のエンドポイントは呼び出すことによって引き続き追加できますエンドポイントを明示的に指定しない場合<xref:System.ServiceModel.ServiceHostBase.AddDefaultEndpoints%2A>上、 <xref:System.ServiceModel.ServiceHost>呼び出す前に<xref:System.ServiceModel.Channels.CommunicationObject.Open%2A>します。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]既定のエンドポイント、バインディング、および動作を参照してください[簡略化された構成](../../../docs/framework/wcf/simplified-configuration.md)と[WCF サービスの構成を簡略化](../../../docs/framework/wcf/samples/simplified-configuration-for-wcf-services.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.EndpointAddress>   
+ [サービス Id と認証](../../../docs/framework/wcf/feature-details/service-identity-and-authentication.md)   
+ [エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [ホストしています。](../../../docs/framework/wcf/feature-details/hosting.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md b/docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md
new file mode 100644
index 00000000000..99e6941958b
--- /dev/null
+++ b/docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md
@@ -0,0 +1,78 @@
+---
+title: "コントラクトおよびサービスのエラーの指定と処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エラーの処理 [WCF]"
+ms.assetid: a9696563-d404-4905-942d-1e0834c26dea
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# コントラクトおよびサービスのエラーの指定と処理
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションは、マネージ例外オブジェクトを SOAP エラー オブジェクトにマップし、SOAP エラー オブジェクトをマネージ例外オブジェクトにマップすることによって、エラー状態を処理します。ここでは、エラー状態がカスタムの SOAP エラーとして公開されるようにコントラクトを設計する方法、そのエラーをサービス実装の一部として返す方法、およびクライアントがそのエラーをキャッチする方法を説明します。  
+  
+## エラー処理の概要  
+ すべてのマネージ アプリケーションで、操作エラーは <xref:System.Exception> オブジェクトにより表されます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションなどの SOAP に基づくアプリケーションでは、サービス メソッドは SOAP エラー メッセージを使用して操作エラー情報を通知します。SOAP エラーは、サービス操作のメタデータに含まれるメッセージ型です。これにより、クライアントが操作を堅牢かつインタラクティブにするために使用できるエラー コントラクトを作成できます。また、SOAP エラーは XML 形式でクライアントに伝達されるので、この型システムは相互運用性が高く、あらゆる SOAP プラットフォーム上のクライアントが使用できます。これによって、ユーザーの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの適用範囲が拡大します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションは、両方の型のエラー システムで実行されるので、クライアントに送信されるマネージ例外情報は、サービス上で例外から SOAP エラーに変換し、送信後、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントで SOAP エラーからエラー例外に変換する必要があります。双方向クライアントの場合は、クライアント コントラクトによって SOAP エラーがサービスに返送されることもあります。いずれの場合も、開発者は、既定のサービス例外の動作を使用することも、例外をエラー メッセージにマップするかどうかを制御することも \(その場合はどのようにマップするかを指定することも\) できます。  
+  
+ 送信できる SOAP エラーには、*宣言された* SOAP エラーと*宣言されていない* SOAP エラーの 2 種類があります。宣言された SOAP エラーは、カスタム SOAP エラーの種類を指定する <xref:System.ServiceModel.FaultContractAttribute?displayProperty=fullName> 属性を含む操作で発生します。*宣言されていない* SOAP エラーは、操作のコントラクトに指定されていないエラーです。  
+  
+ <xref:System.ServiceModel.FaultContractAttribute> 属性を使用して、通常の操作中に受信することをクライアントが予期できるすべての SOAP エラーを正式に指定することによって、サービス操作でそのエラーを宣言することを強くお勧めします。また、SOAP エラーでは、情報の漏えいを最小限に抑えるために、クライアントが知る必要がある情報だけを返すことをお勧めします。  
+  
+ 通常、サービス \(および双方向クライアント\) は、次の手順に従ってエラー処理をアプリケーションに統合します。  
+  
+-   例外状態をカスタム SOAP エラーにマップします。  
+  
+-   クライアントとサービスは、SOAP エラーを例外として送受信します。  
+  
+ また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のクライアントとサービスは、デバッグの目的で非宣言 SOAP エラーを使用でき、既定のエラー動作を拡張できます。以下のセクションで、これらの手順と概念について説明します。  
+  
+## SOAP エラーへの例外のマッピング  
+ エラー状態の処理操作を作成するための最初の手順は、クライアント アプリケーションにエラーを通知する状態を決定することです。一部の操作には、その機能に固有のエラー状態があります。たとえば、`PurchaseOrder` 操作では、発注書の作成が禁止になっている顧客に特定の情報を返すことができます。また、`Calculator` サービスなどでは、より一般的な `MathFault` SOAP エラーを使用してサービス全体のすべてのエラー状態を記述できます。サービスのクライアントのエラー状態を特定したら、カスタム SOAP エラーを作成し、エラー状態が発生したときに SOAP エラーを返す操作として、対応する操作をマークします。  
+  
+ サービスまたはクライアントを開発するための手順[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[エラーの定義と指定](../../../docs/framework/wcf/defining-and-specifying-faults.md)」を参照してください。  
+  
+## クライアントとサービスによる例外としての SOAP エラーの処理  
+ 操作エラー状態を特定し、カスタム SOAP エラーを定義し、そのようなエラーを返す操作にマークすることは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションで正常にエラーを処理するための最初の手順です。次の手順では、このエラーの送受信を適切に実装します。通常は、サービスがエラーを送信してクライアント アプリケーションにエラー状態を通知しますが、双方向クライアントが SOAP エラーをサービスに送信することもできます。  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [エラーの送受信](../../../docs/framework/wcf/sending-and-receiving-faults.md).  
+  
+## 非宣言 SOAP エラーとデバッグ  
+ 宣言 SOAP エラーは、堅牢で相互運用可能な分散アプリケーションを構築するうえで便利です。ただし、サービス \(または双方向クライアント\) が非宣言 SOAP エラーを送信することが役立つ場合があります。非宣言 SOAP エラーとは、その操作について Web サービス記述言語 \(WSDL\) で宣言されていないエラーです。たとえば、サービスの開発時に予期しない状況が発生する可能性があります。この場合、デバッグのために情報をクライアントに送信することが役立ちます。また、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティまたは <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> プロパティを `true` に設定して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントが内部のサービス操作例外に関する情報を取得できるようにすることができます。個別のエラー送信とデバッグ動作プロパティの設定については、「[エラーの送受信](../../../docs/framework/wcf/sending-and-receiving-faults.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  マネージ例外が内部アプリケーション情報を開示する可能性があるので、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> または <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> を `true` に設定すると、個人の身元を確認できる情報またはその他の機密情報を含む内部サービス操作例外に関する情報を [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントで取得できます。  
+>   
+>  したがって、<xref:System.ServiceModel.ServiceBehaviorAttribute.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> または <xref:System.ServiceModel.Description.ServiceDebugBehavior.IncludeExceptionDetailInFaults%2A?displayProperty=fullName> を `true` に設定することは、サービス アプリケーションを一時的にデバッグする方法としてのみお勧めできます。さらに、このようにして未処理のマネージ例外を返すメソッドの WSDL には、<xref:System.ServiceModel.ExceptionDetail> 型の <xref:System.ServiceModel.FaultException%601> のコントラクトが含まれません。クライアントは、デバッグ情報を適切に取得するために、\(<xref:System.ServiceModel.FaultException?displayProperty=fullName> オブジェクトとして [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントに返される\) 不明な SOAP エラーの可能性について想定しておく必要があります。  
+  
+## IErrorHandler によるエラー処理のカスタマイズ  
+ アプリケーション レベルの例外が発生した場合にクライアントへの応答メッセージをカスタマイズする、または応答メッセージが返された後に何らかのカスタム処理を実行するという特別な要件がある場合は、<xref:System.ServiceModel.Dispatcher.IErrorHandler?displayProperty=fullName> インターフェイスを実装します。  
+  
+## エラーのシリアル化の問題  
+ WCF では、エラー コントラクトを逆シリアル化する場合、最初に SOAP メッセージのエラー コントラクト名とエラー コントラクトの型を一致させようとします。正しく一致しない場合、使用可能なエラー コントラクトのアルファベット順のリストで互換性のある型を検索します。2 つのエラー コントラクトが互換性のある型である場合 \(たとえば、一方のコントラクトが別のコントラクトのサブクラスである場合\)、エラーを逆シリアル化するときに間違った型が使用される場合があります。このような問題は、エラー コントラクトで名前、名前空間、およびアクションが指定されていない場合に発生します。このような問題が発生しないようにするには、常に名前、名前空間、およびアクションの属性を指定して、エラー コントラクトを完全修飾するようにしてください。また、共有基本クラスから派生した関連エラー コントラクトを定義している場合は、新しいメンバーを `[DataMember(IsRequired=true)]` でマークしてください。この `IsRequired` 属性の詳細については、「<xref:System.Runtime.Serialization.DataMemberAttribute>」を参照してください。この結果、基本クラスに互換性のある型が指定されなくなり、正しい派生型にエラーが逆シリアル化されます。  
+  
+## 参照  
+ <xref:System.ServiceModel.FaultException>   
+ <xref:System.ServiceModel.FaultContractAttribute>   
+ <xref:System.ServiceModel.FaultException>   
+ <xref:System.Xml.Serialization.XmlSerializer>   
+ <xref:System.ServiceModel.XmlSerializerFormatAttribute>   
+ <xref:System.ServiceModel.FaultContractAttribute>   
+ <xref:System.ServiceModel.CommunicationException>   
+ <xref:System.ServiceModel.FaultContractAttribute.Action%2A>   
+ <xref:System.ServiceModel.FaultException.Code%2A>   
+ <xref:System.ServiceModel.FaultException.Reason%2A>   
+ <xref:System.ServiceModel.FaultCode.SubCode%2A>   
+ <xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A>   
+ [エラーの定義と指定](../../../docs/framework/wcf/defining-and-specifying-faults.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/specifying-client-run-time-behavior.md b/docs/framework/wcf/specifying-client-run-time-behavior.md
new file mode 100644
index 00000000000..08c58859202
--- /dev/null
+++ b/docs/framework/wcf/specifying-client-run-time-behavior.md
@@ -0,0 +1,54 @@
+---
+title: "クライアントのランタイム動作の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "システム指定のクライアントの動作 [WCF]"
+ms.assetid: d16d3405-be70-4edb-8f62-b5f614ddeca5
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# クライアントのランタイム動作の指定
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] クライアントは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスと同様に、クライアント アプリケーションに合わせてランタイム動作を変更するように構成できます。 クライアントのランタイム動作を指定する際には、3 つの属性を使用できます。 双方向クライアント コールバック オブジェクトを使用して、 <xref:System.ServiceModel.CallbackBehaviorAttribute>と<xref:System.ServiceModel.Description.CallbackDebugBehavior>実行時の動作を変更する属性です。 その他の属性<xref:System.ServiceModel.Description.ClientViaBehavior>、論理送信先を直接のネットワーク送信先と区別するために使用できます。 さらに、双方向クライアントのコールバック型では、サービス側の動作の一部を使用できます。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][サービスの実行時の動作を指定する](../../../docs/framework/wcf/specifying-service-run-time-behavior.md)です。  
+  
+## <a name="using-the-callbackbehaviorattribute"></a>CallbackBehaviorAttribute の使用  
+ 構成するかを使用して、クライアント アプリケーションでコールバック コントラクト実装の実行動作を拡張、 <xref:System.ServiceModel.CallbackBehaviorAttribute>クラスです。 この属性としてコールバック クラスに対して同様の機能を実行する、 <xref:System.ServiceModel.ServiceBehaviorAttribute>動作とトランザクションの設定をインスタンス化を除き、クラスです。  
+  
+ <xref:System.ServiceModel.CallbackBehaviorAttribute>クラスは、コールバック コントラクトを実装するクラスに適用する必要があります。 双方向コントラクトの実装に適用されている場合、 <xref:System.InvalidOperationException>実行時に例外がスローされます。 次のコード例は、 <xref:System.ServiceModel.CallbackBehaviorAttribute>クラスを使用するコールバック オブジェクト、 <xref:System.Threading.SynchronizationContext>マーシャ リングするスレッドを決定する、 <xref:System.ServiceModel.CallbackBehaviorAttribute.ValidateMustUnderstand%2A>メッセージ検証を実施するプロパティと<xref:System.ServiceModel.CallbackBehaviorAttribute.IncludeExceptionDetailInFaults%2A>として例外を返すプロパティ<xref:System.ServiceModel.FaultException>デバッグ用のサービス オブジェクト。  
+  
+ [!code-csharp[CallbackBehaviorAttribute#3](../../../samples/snippets/csharp/VS_Snippets_CFX/callbackbehaviorattribute/cs/client.cs#3)]
+ [!code-vb[CallbackBehaviorAttribute#3](../../../samples/snippets/visualbasic/VS_Snippets_CFX/callbackbehaviorattribute/vb/client.vb#3)]  
+  
+## <a name="using-callbackdebugbehavior-to-enable-the-flow-of-managed-exception-information"></a>CallbackDebugBehavior を使用したマネージ例外情報のフローの有効化  
+ マネージ例外情報を設定してデバッグ用のサービスにクライアント コールバック オブジェクト内のフローを有効にすることができます、 <xref:System.ServiceModel.Description.CallbackDebugBehavior.IncludeExceptionDetailInFaults%2A>プロパティを`true`プログラムまたはアプリケーション構成ファイルします。  
+  
+ マネージ例外情報をサービスに戻すのは、セキュリティ リスクになる可能性があります。これは、例外の詳細により、非承認のサービスで使用可能な内部クライアントの実装についての情報が公開されるからです。 さらに、ですが、 <xref:System.ServiceModel.Description.CallbackDebugBehavior>プロパティをプログラムで設定することも、無効にすることを忘れがちになります<xref:System.ServiceModel.Description.CallbackDebugBehavior.IncludeExceptionDetailInFaults%2A>を展開する場合。  
+  
+ セキュリティの問題にかかわるので、以下を強くお勧めします。  
+  
+-   値を設定、アプリケーション構成ファイルを使用して、 <xref:System.ServiceModel.Description.CallbackDebugBehavior.IncludeExceptionDetailInFaults%2A>プロパティを`true`します。  
+  
+-   これは、制御されたデバッグ シナリオの場合に限って行います。  
+  
+ 
+          [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に、SOAP メッセージのクライアント コールバック オブジェクトからマネージ例外情報を返すように指示するクライアント構成ファイルを次のコード例に示します。  
+  
+ [!code[SCA.CallbackContract#4](../../../samples/snippets/common/VS_Snippets_CFX/sca.callbackcontract/common/client.exe.config#4)]
+ [!code-csharp[SCA.CallbackContract#4](../../../samples/snippets/csharp/VS_Snippets_CFX/sca.callbackcontract/cs/client.exe.config#4)]
+ [!code-vb[SCA.CallbackContract#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/sca.callbackcontract/vb/client.exe.config#4)]  
+  
+## <a name="using-the-clientviabehavior-behavior"></a>ClientViaBehavior 動作の使用  
+ 使用することができます、 <xref:System.ServiceModel.Description.ClientViaBehavior>トランスポート チャネルの作成対象となる統一リソース識別子を指定する動作。 この動作は、直接のネットワーク送信先が、メッセージの処理先と異なる場合に使用します。 これにより、呼び出し側のアプリケーションが最終的な送信先を知っているとは限らないとき、または送信先の `Via` ヘッダーがアドレスでないときに、複数のホップを経由するメッセージ交換が可能になります。  
+  
+## <a name="see-also"></a>関連項目  
+ [サービスの実行時の動作を指定します。](../../../docs/framework/wcf/specifying-service-run-time-behavior.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/specifying-service-run-time-behavior.md b/docs/framework/wcf/specifying-service-run-time-behavior.md
new file mode 100644
index 00000000000..45b8064a2aa
--- /dev/null
+++ b/docs/framework/wcf/specifying-service-run-time-behavior.md
@@ -0,0 +1,129 @@
+---
+title: "サービスのランタイム動作の指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5c5450ea-6af1-4b75-a267-613d0ac54707
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# サービスのランタイム動作の指定
+サービス コントラクトを設計して \([サービス コントラクトの設計](../../../docs/framework/wcf/designing-service-contracts.md)\)、実装 \([サービス コントラクトの実装](../../../docs/framework/wcf/implementing-service-contracts.md)\) が終わると、サービス ランタイムの実行動作を構成できます。 ここでは、システム指定のサービスと操作の動作について説明し、新しい動作を作成するための詳細情報の参照先を示します。 一部の動作は属性として適用されますが、多くの動作はアプリケーション構成ファイルまたはプログラムを使用して適用されます。 サービス アプリケーションの構成[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[サービスの構成](../../../docs/framework/wcf/configuring-services.md)」を参照してください。  
+  
+## 概要  
+ コントラクトは、その種類のサービスの入力、出力、データ型、および機能を定義します。 サービス コントラクトを実装すると、クラスが 1 つ作成されます。このクラスを任意のアドレスのバインディングで構成すると、実装されたコントラクトが満たされます。 コントラクト、バインディング、およびアドレスはすべて、クライアントにとって既知の情報です。これらの情報がないと、クライアントはサービスを利用できません。  
+  
+ ただし、実行の詳細 \(スレッド処理の問題点やインスタンスの管理など\) は、クライアントには見えません。 サービス コントラクトを実装したら、*動作*を使用してさまざまな操作特性を構成できます。 動作は、ランタイム プロパティを設定するか、またはカスタマイズ種類をランタイムに挿入して、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] ランタイムを変更するオブジェクトです。 ユーザー定義動作を作成してランタイムを変更する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ServiceHost とサービス モデル レイヤーの拡張](../../../docs/framework/wcf/extending/extending-servicehost-and-the-service-model-layer.md)」を参照してください。  
+  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute?displayProperty=fullName> と <xref:System.ServiceModel.OperationBehaviorAttribute?displayProperty=fullName> 属性は、最も広範に使用できる動作であり、最も一般的に要求される操作機能を公開します。 これらは属性であるため、サービス実装または操作実装に適用します。 その他の動作 \(<xref:System.ServiceModel.Description.ServiceMetadataBehavior?displayProperty=fullName> や <xref:System.ServiceModel.Description.ServiceDebugBehavior?displayProperty=fullName> など\) は、通常、アプリケーション構成ファイルを使用して適用されますが、プログラムにより使用することもできます。  
+  
+ ここでは、<xref:System.ServiceModel.ServiceBehaviorAttribute> 属性と <xref:System.ServiceModel.OperationBehaviorAttribute> 属性の概要を示し、動作が影響するさまざまなスコープについて説明します。また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の開発者にとって興味深いと思われる、さまざまなスコープにおける多くのシステム指定の動作についても簡単に説明します。  
+  
+## ServiceBehaviorAttribute と OperationBehaviorAttribute  
+ 最も重要な動作は <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性と <xref:System.ServiceModel.OperationBehaviorAttribute> 属性です。これらの属性を使用すると、以下を制御できます。  
+  
+-   インスタンスの有効期間  
+  
+-   同時実行と同期のサポート  
+  
+-   構成の動作  
+  
+-   トランザクションの動作  
+  
+-   シリアル化の動作  
+  
+-   メタデータの変換  
+  
+-   セッションの有効期間  
+  
+-   アドレス フィルターとヘッダー処理  
+  
+-   偽装  
+  
+-   これらの属性を使用するには、サービス実装または操作実装をそのスコープに適切な属性でマークし、プロパティを設定します。 たとえば、次のコード例は、<xref:System.ServiceModel.OperationBehaviorAttribute.Impersonation%2A?displayProperty=fullName> プロパティを使用した操作実装を示しています。この実装では、この操作の呼び出し元が偽装をサポートするように要求します。  
+  
+ [!code-csharp[OperationBehaviorAttribute_Impersonation#1](../../../samples/snippets/csharp/VS_Snippets_CFX/operationbehaviorattribute_impersonation/cs/services.cs#1)]
+ [!code-vb[OperationBehaviorAttribute_Impersonation#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/operationbehaviorattribute_impersonation/vb/services.vb#1)]  
+  
+ これらのプロパティの多くは、バインディングによる追加のサポートを必要とします。 たとえば、クライアントからのトランザクションを要求する操作は、フロー トランザクションをサポートするバインディングを使用するように構成される必要があります。  
+  
+### 既知のシングルトン サービス  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性と <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用すると、特定の有効期間 \(<xref:System.ServiceModel.InstanceContext> の有効期間と操作を実装するサービス オブジェクトの有効期間の両方\) を制御できます。  
+  
+ たとえば、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティは <xref:System.ServiceModel.InstanceContext> の解放頻度を制御し、<xref:System.ServiceModel.OperationBehaviorAttribute.ReleaseInstanceMode%2A?displayProperty=fullName> プロパティと <xref:System.ServiceModel.ServiceBehaviorAttribute.ReleaseServiceInstanceOnTransactionComplete%2A?displayProperty=fullName> プロパティはサービス オブジェクトを解放するタイミングを制御します。  
+  
+ ただし、サービス オブジェクトを独自に作成し、そのオブジェクトを使用するサービス ホストを作成することもできます。 そのためには、<xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.InstanceContextMode> に設定するか、サービス ホストが開かれたときに例外をスローする必要があります。  
+  
+ このようなサービスを作成するには、[ServiceHost.ServiceHost\(Object, Uri\<xref:System.ServiceModel.ServiceHost.%23ctor%28System.Object%2CSystem.Uri%5B%5D%29?displayProperty=fullName> コンストラクターを使用します。 この方法は、シングルトン サービスが使用する特定のオブジェクト インスタンスを提供する場合に、カスタムの <xref:System.ServiceModel.Dispatcher.IInstanceContextInitializer?displayProperty=fullName> を実装する代わりに使用できます。 サービス実装の型を作成することが困難な場合 \(たとえば、パラメーターがない既定のコンストラクターが作成されない場合\) は、このオーバーロードを使用できます。  
+  
+ オブジェクトをこのコンストラクターに指定すると、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のインスタンス化動作に関するいくつかの機能が異なる動作をすることに注意してください。 たとえば、既知のオブジェクト インスタンスを指定した場合、<xref:System.ServiceModel.InstanceContext.ReleaseServiceInstance%2A?displayProperty=fullName> を呼び出しても効果はありません。 他のインスタンス解放機構も、同様に無視されます。<xref:System.ServiceModel.ServiceHost> クラスは常に、すべての操作について <xref:System.ServiceModel.OperationBehaviorAttribute.ReleaseInstanceMode%2A?displayProperty=fullName> プロパティが <xref:System.ServiceModel.ReleaseInstanceMode?displayProperty=fullName> に設定されているかのように動作します。  
+  
+## その他のサービス、エンドポイント、コントラクト、および操作の動作  
+ <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性などのサービスの動作は、サービス全体に影響します。 たとえば、<xref:System.ServiceModel.ServiceBehaviorAttribute.ConcurrencyMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.ConcurrencyMode?displayProperty=fullName> に設定すると、そのサービスの各操作で発生するスレッドの同期の問題を自分で処理する必要があります。 エンドポイントの動作はエンドポイント全体に影響し、システム指定のエンドポイントの動作はクライアント機能に対して影響します。 また、コントラクトの動作はコントラクト レベルで影響し、操作の動作は操作の実行を変更します。  
+  
+ これらの動作の多くは属性に実装され、適切なサービス クラスまたは操作実装に適用することによって <xref:System.ServiceModel.ServiceBehaviorAttribute> 属性および <xref:System.ServiceModel.OperationBehaviorAttribute> 属性を使用するときにこれらの動作を利用できます。 その他の動作 \(<xref:System.ServiceModel.Description.ServiceMetadataBehavior> オブジェクトや <xref:System.ServiceModel.Description.ServiceDebugBehavior> オブジェクトなど\) は、通常、アプリケーション構成ファイルを使用して適用されますが、プログラムにより使用することもできます。  
+  
+ たとえば、メタデータの公開は、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> オブジェクトを使用して構成されます。 次のアプリケーション構成ファイルは、最も一般的な使用方法を示しています。  
+  
+ [!code-csharp[ServiceMetadataBehavior#1](../../../samples/snippets/csharp/VS_Snippets_CFX/servicemetadatabehavior/cs/hostapplication.cs#1)]  
+  
+ 以下のセクションでは、サービスまたはクライアントのランタイム実行を変更する際に最も役立つ、さまざまなシステム指定の動作について説明します。 リファレンス トピックを参照して、各動作の使用方法を確認してください。  
+  
+### サービスの動作  
+ 次の動作は、サービスに影響します。  
+  
+-   <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute>。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスに適用され、そのサービスが [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] 互換モードで実行できるかどうかを示します。  
+  
+-   <xref:System.ServiceModel.Description.ServiceAuthorizationBehavior>。 サービスがクライアントのクレームを承認する方法を制御します。  
+  
+-   <xref:System.ServiceModel.Description.ServiceCredentials>。 サービス資格情報を構成します。 このクラスを使用して、X.509 証明書などのサービスの資格情報を指定します。  
+  
+-   <xref:System.ServiceModel.Description.ServiceDebugBehavior>。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスのデバッグ機能とヘルプ情報機能を有効にします。  
+  
+-   <xref:System.ServiceModel.Description.ServiceMetadataBehavior>。 サービス メタデータと関連情報の公開を制御します。  
+  
+-   <xref:System.ServiceModel.Description.ServiceSecurityAuditBehavior>。 セキュリティ イベントの監査動作を指定します。  
+  
+-   <xref:System.ServiceModel.Description.ServiceThrottlingBehavior>。 サービス パフォーマンスを調整できるようにするランタイム スループット設定を構成します。  
+  
+### エンドポイントの動作  
+ 以下の動作は、エンドポイントに影響します。 これらの動作の多くは、クライアント アプリケーションで使用されます。  
+  
+-   <xref:System.ServiceModel.CallbackBehaviorAttribute>。 双方向クライアント アプリケーションのコールバック サービス実装を構成します。  
+  
+-   <xref:System.ServiceModel.Description.CallbackDebugBehavior>。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] コールバック オブジェクトのサービス デバッグを実行できるようにします。  
+  
+-   <xref:System.ServiceModel.Description.ClientCredentials>。 クライアントとサービスの資格情報、およびクライアントで使用するサービス資格情報の認証設定をユーザーが構成できるようにします。  
+  
+-   <xref:System.ServiceModel.Description.ClientViaBehavior>。 トランスポート チャネルを作成する対象の URI \(Uniform Resource Identifier\) を指定するために、クライアントが使用します。  
+  
+-   <xref:System.ServiceModel.Description.MustUnderstandBehavior>。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 処理を無効にするように `MustUnderstand` に指示します。  
+  
+-   <xref:System.ServiceModel.Description.SynchronousReceiveBehavior>。 チャネルの同期受信プロセスを使用するようにランタイムに指示します。  
+  
+-   <xref:System.ServiceModel.Description.TransactedBatchingBehavior>。 トランザクションの受信をサポートするトランスポートの受信操作を最適化します。  
+  
+### コントラクトの動作  
+ <xref:System.ServiceModel.DeliveryRequirementsAttribute>。 バインディングがサービスまたはクライアントの実装に対して提供する必要がある機能要件を指定します。  
+  
+### 操作の動作  
+ 以下の操作の動作は、操作のシリアル化制御およびトランザクション制御を指定します。  
+  
+-   <xref:System.ServiceModel.Description.DataContractSerializerOperationBehavior>。<xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=fullName> のランタイム動作を表します。  
+  
+-   <xref:System.ServiceModel.Description.XmlSerializerOperationBehavior>。`XmlSerializer` のランタイム動作を制御し、操作に関連付けます。  
+  
+-   <xref:System.ServiceModel.TransactionFlowAttribute>。 サービス操作がトランザクション ヘッダーを受け入れるレベルを指定します。  
+  
+## 参照  
+ [サービスの構成](../../../docs/framework/wcf/configuring-services.md)   
+ [方法 : サービスのインスタンス化を制御する](../../../docs/framework/wcf/feature-details/how-to-control-service-instancing.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/synchronous-and-asynchronous-operations.md b/docs/framework/wcf/synchronous-and-asynchronous-operations.md
new file mode 100644
index 00000000000..df33e03777b
--- /dev/null
+++ b/docs/framework/wcf/synchronous-and-asynchronous-operations.md
@@ -0,0 +1,198 @@
+---
+title: "同期操作と非同期操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス コントラクト [WCF], 非同期操作"
+  - "サービス コントラクト [WCF], 同期操作"
+ms.assetid: db8a51cb-67e6-411b-9035-e5821ed350c9
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 同期操作と非同期操作
+ここでは、非同期サービス操作の実装と呼び出しについて説明します。  
+  
+ 多くのアプリケーションは、メソッド呼び出しの実行中に有用な処理を続行できるように、メソッドを非同期的に呼び出します。  [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のサービスとクライアントは、アプリケーションの異なる 2 つのレベルで操作の非同期呼び出しに参加できます。これにより、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの柔軟性がさらに高まり、対話機能とのバランスの取れたスループットを最大限に高めることができます。  
+  
+## 非同期操作の種類  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のすべてのサービス コントラクトでは、パラメーターの型と戻り値に関係なく、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の属性を使用して、クライアントとサービス間の特定のメッセージ交換パターンを指定します。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、適切なサービス操作または実行元のクライアント コードに送受信メッセージを自動的にルーティングします。  
+  
+ クライアントが所有するのは、特定操作のメッセージ交換パターンが指定されたサービス コントラクトのみです。  基盤となるメッセージ交換パターンに従っている限り、クライアントは選択する任意のプログラミング モデルを開発者に提供できます。  同様に、サービスも、指定されたメッセージ パターンに従っている限り、任意の方法で操作を実装できます。  
+  
+ サービス コントラクトがサービスとクライアントの両方の実装から独立していることで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションでは次の形式の非同期実行が可能になります。  
+  
+-   クライアントは、同期メッセージ交換を使用して要求\/応答操作を非同期に呼び出すことができます。  
+  
+-   サービスは、同期メッセージ交換を使用して要求\/応答操作を非同期に実装できます。  
+  
+-   クライアントまたはサービスの実装に関係なく、一方向のメッセージ交換が可能です。  
+  
+### 推奨される非同期シナリオ  
+ 操作のサービス実装でブロッキング呼び出し \(I\/O 処理の実行など\) を作成する場合は、サービス操作の実装で非同期手法を使用します。  非同期操作を実装している場合、非同期の操作とメソッドを呼び出して、できるだけ非同期呼び出しパスを拡張するようにします。  たとえば、`BeginOperationOne()` 内から `BeginOperationTwo()` を呼び出します。  
+  
+-   次のような場合には、クライアントまたは呼び出し元アプリケーションで非同期手法を使用します。  
+  
+-   中間層アプリケーションから操作を呼び出す場合   \(このようなシナリオの[!INCLUDE[crabout](../../../includes/crabout-md.md)] 「[中間層クライアント アプリケーション](../../../docs/framework/wcf/feature-details/middle-tier-client-applications.md)」を参照してください\)。  
+  
+-   ASP.NET ページ内で操作を呼び出す場合、非同期ページを使用します。  
+  
+-   シングル スレッドのアプリケーション \(Windows フォームや [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] など\) から操作を呼び出す場合。  イベント ベースの非同期呼び出しモデルを使用すると、結果イベントが UI スレッドで発生するので複数のスレッドを独自に処理する必要がなく、アプリケーションの応答性が向上します。  
+  
+-   一般に、同期呼び出しと非同期呼び出しのいずれかを選択する場合は、非同期呼び出しを選択します。  
+  
+### 非同期サービス操作の実装  
+ 非同期操作は、次の 3 つの方法のいずれかを使用して実装できます。  
+  
+1.  タスク ベースの非同期パターン  
+  
+2.  イベント ベースの非同期パターン  
+  
+3.  IAsyncResult 非同期パターン  
+  
+#### タスク ベースの非同期パターン  
+ 非同期操作を実装する方法としては、最も直接的でわかりやすいタスク ベースの非同期パターンが推奨されます。  この方法を使用するには、単にサービス操作を実装し、戻り値の型 Task\<T\> \(T は論理操作によって返される型\) を指定します。  次に例を示します。  
+  
+```csharp  
+public class SampleService:ISampleService   
+{   
+   // ...  
+   public async Task<string> SampleMethodTaskAsync(string msg)   
+   {   
+      return Task<string>.Factory.StartNew(() =>   
+      {   
+         return msg;   
+      });   
+   }  
+   // ...  
+}  
+  
+```  
+  
+ SampleMethodTaskAsync 操作は、論理操作によって文字列が返されるため、Task\<string\> を返します。  タスク ベースの非同期パターンの詳細については、「[タスク ベースの非同期パターン](http://go.microsoft.com/fwlink/?LinkId=232504)」を参照してください。  
+  
+> [!WARNING]
+>  タスク ベースの非同期パターンを使用している場合、操作の完了を待機している間に例外が発生すると T:System.AggregateException がスローされる場合があります。  この例外は、クライアントまたはサービスで発生することがあります。  
+  
+#### イベント ベースの非同期パターン  
+ イベント ベースの非同期パターンをサポートするサービスには、MethodNameAsync という名前の操作が 1 つ以上含まれます。  これらのメソッドは、同期バージョンに対応するもので、現在のスレッドで同じ操作を行います。  クラスには、MethodNameCompleted イベントや MethodNameAsyncCancel メソッド \(または単に CancelAsync メソッド\) が含まれる場合もあります。  操作の呼び出し元のクライアントは、操作の完了時に呼び出されるイベント ハンドラーを定義します。  
+  
+ 次のコードは、イベント ベースの非同期パターンを使用して非同期操作を宣言する方法を示します。  
+  
+```csharp  
+public class AsyncExample  
+{  
+    // Synchronous methods.  
+    public int Method1(string param);  
+    public void Method2(double param);  
+  
+    // Asynchronous methods.  
+    public void Method1Async(string param);  
+    public void Method1Async(string param, object userState);  
+    public event Method1CompletedEventHandler Method1Completed;  
+  
+    public void Method2Async(double param);  
+    public void Method2Async(double param, object userState);  
+    public event Method2CompletedEventHandler Method2Completed;  
+  
+    public void CancelAsync(object userState);  
+  
+    public bool IsBusy { get; }  
+  
+    // Class implementation not shown.  
+}  
+  
+```  
+  
+ イベント ベースの非同期パターンの詳細については、「[イベント ベースの非同期パターンの概要](http://go.microsoft.com/fwlink/?LinkId=232515)」を参照してください。  
+  
+#### IAsyncResult 非同期パターン  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] 非同期プログラミング パターンを使用し、<xref:System.ServiceModel.OperationContractAttribute.AsyncPattern%2A> プロパティが `true` に設定されている `<Begin>` メソッドを使用することで、サービス操作を非同期に実装できます。  この場合の非同期操作は、同期操作と同じ形式でメタデータに公開されます。つまり、要求メッセージとそれに関連する応答メッセージを伴う単独操作として公開されます。  このとき、クライアント プログラミング モデルは選択が可能です。  サービスが呼び出されたときに要求\/応答メッセージ交換が行われていれば、クライアント プログラミング モデルは、このパターンを同期操作または非同期操作として表すことができます。  
+  
+ 一般に、システムの非同期の性質を考えると、スレッドへの依存は避ける必要があります。  操作のディスパッチ処理のさまざまな段階にデータを渡す最も信頼性の高い方法は、拡張機能を使用する方法です。  
+  
+ 例については、「[方法 : 非同期サービス操作を実装する](../../../docs/framework/wcf/how-to-implement-an-asynchronous-service-operation.md)」を参照してください。  
+  
+ クライアント アプリケーションでの呼び出し方法に関係なく、非同期に実行するコントラクト操作 `X` を定義するには次の処理を実行します。  
+  
+-   パターン `BeginOperation` と `EndOperation` を使用する 2 つのメソッドを定義します。  
+  
+-   `BeginOperation` メソッドには操作のための `in` パラメーターと `ref` パラメーターがあり、<xref:System.IAsyncResult> 型を返します。  
+  
+-   `EndOperation` メソッドには <xref:System.IAsyncResult> パラメーター、`out` パラメーター、および `ref` パラメーターがあり、操作の戻り値の型を返します。  
+  
+ たとえば、次のメソッドを参照してください。  
+  
+```csharp  
+int DoWork(string data, ref string inout, out string outonly)  
+  
+```  
+  
+```vb  
+Function DoWork(ByVal data As String, ByRef inout As String, _out outonly As out) As Integer  
+  
+```  
+  
+ 非同期操作を作成するには、2 つのメソッドを次のように記述します。  
+  
+```csharp  
+[OperationContract(AsyncPattern=true)]IAsyncResult BeginDoWork(string data,                           ref string inout,                           AsyncCallback callback,                           object state);int EndDoWork(ref string inout, out string outonly, IAsyncResult result);  
+  
+```  
+  
+```vb  
+<OperationContract(AsyncPattern := True)>  _Function BeginDoWork(ByVal data As String, _                 ByRef inout As String, _                 ByVal callback As AsyncCallback, _                 ByVal state As Object) _As IAsyncResult Function EndDoWork(ByRef inout As String, _        ByRef outonly As String, _        ByVal result As IAsyncResult) _As Integer  
+  
+```  
+  
+> [!NOTE]
+>  <xref:System.ServiceModel.OperationContractAttribute> 属性は、`BeginDoWork` のメソッドにのみ適用されます。  生成されるコントラクトには、`DoWork` という名前の WSDL 操作が 1 つ含まれます。  
+  
+### クライアント側の非同期呼び出し  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント アプリケーションでは、既に説明した 3 つの非同期呼び出しモデルをどれでも使用できます。  
+  
+ タスク ベースのモデルを使用する場合は、次のコードに示すように、await キーワードを使用して操作を呼び出すだけです。  
+  
+```  
+await simpleServiceClient.SampleMethodTaskAsync(“hello, world”);  
+  
+```  
+  
+ イベント ベースの非同期パターンを使用する場合は、応答の通知を受信するイベント ハンドラーを追加するだけで済み、結果イベントはユーザー インターフェイス スレッドで自動的に発生します。  この手法を使用するには、次の例に示すように、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で **\/async** コマンド オプションと **\/tcv:Version35** コマンド オプションの両方を指定します。  
+  
+```  
+svcutil http://localhost:8000/servicemodelsamples/service/mex /async /tcv:Version35  
+```  
+  
+ これらのオプションを指定すると、Svcutil.exe によって、イベント インフラストラクチャを持つ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント クラスが生成されます。このインフラストラクチャにより、呼び出し元アプリケーションは、応答を受信して適切なアクションを実行するイベント ハンドラーを実装し、割り当てることができます。  コード例全体については、「[方法 : サービス操作を非同期に呼び出す](../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)」を参照してください。  
+  
+ イベント ベースの非同期モデルは、[!INCLUDE[netfx35_long](../../../includes/netfx35-long-md.md)] でのみ使用できます。  また、<xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName> を使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント チャネルを作成した場合は、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] でもサポートされません。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント チャネル オブジェクトを使用する場合、<xref:System.IAsyncResult?displayProperty=fullName> オブジェクトを使用して操作を非同期に呼び出す必要があります。  この手法を使用するには、次の例に示すように、[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) で **\/async** コマンド オプションを指定します。  
+  
+```  
+svcutil http://localhost:8000/servicemodelsamples/service/mex /async   
+```  
+  
+ これにより、対応する `<End>` メソッドを持ち、<xref:System.ServiceModel.OperationContractAttribute.AsyncPattern%2A> プロパティが `true` に設定された `<Begin>` メソッドとして各操作がモデル化されたサービス コントラクトが生成されます。  <xref:System.ServiceModel.ChannelFactory%601> の詳細な使用例については、「[方法 : チャネル ファクトリを使用して、非同期的に操作を呼び出す](../../../docs/framework/wcf/feature-details/how-to-call-operations-asynchronously-using-a-channel-factory.md)」を参照してください。  
+  
+ いずれの場合も、サービスが同期的に実装されていても、アプリケーションは操作を非同期に呼び出すことができます。これは、アプリケーションで同じパターンを使用してローカルの同期メソッドを非同期に呼び出す場合と同様です。  クライアントにとって操作がどのように実装されているかは重要ではありません。応答メッセージが到着すると、その内容がクライアントの非同期 \<`End`\> メソッドにディスパッチされ、クライアントは情報を取得します。  
+  
+### 一方向メッセージ交換パターン  
+ クライアントまたはサービスが単独で一方向操作 \(<xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A?displayProperty=fullName> が `true` に設定されている操作には相関する応答がない\) を相手側に送信できる、非同期メッセージ交換パターンを作成することもできます   \(双方向メッセージ交換パターンを一方向メッセージで使用します\)。この場合、サービス コントラクトは、両側が非同期呼び出しまたは非同期実装として実装できる一方向メッセージ交換を指定します。また、状況によっては指定しません。  一般的に、コントラクトが一方向メッセージ交換の場合、メッセージが送信されるとアプリケーションは応答を待機することなく他の作業を継続できるため、多くの場合、実装が非同期になります。  
+  
+### イベント ベースの非同期クライアントとメッセージ コントラクト  
+ イベント ベースの非同期モデルのデザイン ガイドラインには、複数の値を返す場合に、1 つの値を `Result` プロパティとして返し、残りの値を <xref:System.EventArgs> オブジェクトのプロパティとして返すことが記載されています。  この 1 つの結果として、クライアントがイベント ベースの非同期コマンド オプションを使用してメタデータをインポートし、操作から複数の値が返される場合、既定の <xref:System.EventArgs> オブジェクトは 1 つの値を `Result` プロパティとして返し、残りの値は <xref:System.EventArgs> オブジェクトのプロパティになります。  
+  
+ メッセージ オブジェクトを `Result` プロパティとして受け取り、返された値をそのオブジェクトのプロパティとして取得する場合は、**\/messageContract** コマンド オプションを使用します。  これにより、<xref:System.EventArgs> オブジェクトの `Result` プロパティとして応答メッセージを返すシグネチャが生成されます。  すべての内部戻り値は、応答メッセージ オブジェクトのプロパティになります。  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationContractAttribute.IsOneWay%2A>   
+ <xref:System.ServiceModel.OperationContractAttribute.AsyncPattern%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/system-provided-bindings.md b/docs/framework/wcf/system-provided-bindings.md
new file mode 100644
index 00000000000..0d8b08f948a
--- /dev/null
+++ b/docs/framework/wcf/system-provided-bindings.md
@@ -0,0 +1,103 @@
+---
+title: "システム標準のバインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "バインディング [WCF], システム標準"
+ms.assetid: 2c243746-45ce-4588-995e-c17126a579a6
+caps.latest.revision: 60
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 60
+---
+# システム標準のバインディング
+バインディングにより、エンドポイントとの通信で使用する通信メカニズムが指定され、エンドポイントへの接続方法が示されます。バインディングには次の要素が含まれます。  
+  
+-   プロトコル スタックは、エンドポイントに送信されるメッセージで使用するセキュリティ、信頼性、およびコンテキスト フローの設定を決定します。  
+  
+-   トランスポートは、エンドポイントにメッセージを送信するときに使用する基礎トランスポート プロトコル \(TCP または HTTP など\) を決定します。  
+  
+-   エンコードは、エンドポイントに送信されるメッセージに使用するネットワーク エンコード \(text\/XML、バイナリ、MTOM \(Message Transmission Optimization Mechanism\) など\) を決定します。  
+  
+ ここでは、システム指定の [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] バインディングをすべて示します。このバインディングがいずれもアプリケーションの条件に適合しない場合は、カスタム バインディングを作成できます。カスタム バインディングの作成[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+ WS\-Federation プロトコルをサポートする、セキュリティで保護された相互操作可能なバインディングを使用すると、フェデレーションに属す組織のユーザーを効率的に認証および承認できます。  
+  
+> [!IMPORTANT]
+>  常にセキュリティを備えたバインディングを選択します。既定では、[\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素以外のバインディングでセキュリティが有効になっています。セキュリティで保護されたバインディングを選択しない場合、またはセキュリティを無効にする場合は、セキュリティで保護されたデータ センターや隔離されたネットワークにデータを保存するなど、他の方法でデータを保護してください。  
+  
+> [!IMPORTANT]
+>  他の方法によってデータをセキュリティ保護している場合を除き、セキュリティをサポートしないバインディングやセキュリティが無効になっているバインディングでは、双方向コントラクトを使用しないでください。  
+  
+## システム指定のバインディング  
+ 次のバインディングは [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に付属します。  
+  
+|バインディング|構成要素|説明|  
+|-------------|----------|--------|  
+|<xref:System.ServiceModel.BasicHttpBinding>|[\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md)|ASP.NET Web サービス \(ASMX\) ベースのサービスなど、WS\-Basic Profile に適合する Web サービスとの通信に適したバインディング。このバインディングはトランスポートとして HTTP を、既定のメッセージ エンコーディングとして text\/XML を使用します。|  
+|<xref:System.ServiceModel.WSHttpBinding>|[\<wsHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md)|二重のサービス コントラクト以外に適した、セキュリティで保護された相互操作可能なバインディング。|  
+|<xref:System.ServiceModel.WSDualHttpBinding>|[\<wsDualHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wsdualhttpbinding.md)|双方向サービス コントラクト、または SOAP 中継局を介しての通信に適した、セキュリティで保護された相互操作可能なバインディング。|  
+|<xref:System.ServiceModel.WSFederationHttpBinding>|[\<wsFederationHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wsfederationhttpbinding.md)|フェデレーションに属す組織のユーザーを効率的に認証および承認できる WS\-Federation プロトコルをサポートする、セキュリティで保護された相互操作可能なバインディング。|  
+|<xref:System.ServiceModel.NetHttpBinding>|\<netHttpBinding\>|HTTP や WebSocket のサービスを使用するために設計され、既定でバイナリ エンコーディングを使用するバインディング。|  
+|<xref:System.ServiceModel.NetHttpsBinding>|\<netHttpsBinding\>|HTTP や WebSocket のサービスを使用するために設計され、既定でバイナリ エンコーディングを使用するセキュリティで保護されたバインディング。|  
+|<xref:System.ServiceModel.NetTcpBinding>|[\<netTcpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md)|[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーション間での複数コンピューターの通信に適した、セキュリティで保護された最適バインディング。|  
+|<xref:System.ServiceModel.NetNamedPipeBinding>|[\<netNamedPipeBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/netnamedpipebinding.md)|[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーション間でのコンピューター通信に適した、セキュリティで保護された信頼できる最適バインディング。|  
+|<xref:System.ServiceModel.NetMsmqBinding>|[\<netMsmqBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/netmsmqbinding.md)|[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーション間での複数コンピューターの通信に適した、キューに置かれたバインディング。|  
+|<xref:System.ServiceModel.NetPeerTcpBinding>|[\<netPeerTcpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/netpeertcpbinding.md)|セキュリティで保護された、複数のコンピューター通信を可能にするバインディング。|  
+|<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>|[\<msmqIntegrationBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/msmqintegrationbinding.md)|[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションとメッセージ キュー \(MSMQ: Message Queuing\) アプリケーション間のコンピューター間通信に適したバインディング。|  
+|<xref:System.ServiceModel.BasicHttpContextBinding>|[\<basicHttpContextBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpcontextbinding.md)|WS\-Basic Profile に適合する Web サービスとの通信に適したバインディング。このバインディングでは、HTTP クッキーを使用してコンテキストを交換できるようになります。|  
+|<xref:System.ServiceModel.NetTcpContextBinding>|[\<netTcpContextBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/nettcpcontextbinding.md)|[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーション間での複数コンピューターの通信に適した、セキュリティで保護された最適バインディング。このバインディングでは、SOAP ヘッダーを使用してコンテキストを交換できるようになります。|  
+|<xref:System.ServiceModel.WebHttpBinding>|[\<webHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/webhttpbinding.md)|SOAP メッセージではなく、HTTP 要求を介して公開される [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サービスのエンドポイントを構成するために使用されるバインディング。|  
+|<xref:System.ServiceModel.WSHttpContextBinding>|[\<wsHttpContextBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpcontextbinding.md)|非双方向サービス コントラクトに適した、セキュリティで保護された相互操作可能なバインディング。このバインディングでは、SOAP ヘッダーを使用してコンテキストを交換できるようになります。|  
+|<xref:System.ServiceModel.Channels.UdpBinding>|\<udpBinding\>|単純なメッセージを複数のクライアントに同時に送信するために使用されるバインディング。|  
+  
+ 各システム指定のバインディングの機能を次の表に示します。各バインディングをこの表の列に示します。機能とその説明は 2 番目の表の行に示します。次の表に、使用されるバインディングの省略形のキーを示します。バインディングを選択するには、必要な行の機能がすべて含まれる列を調べます。  
+  
+|バインディング|相互運用性|セキュリティ \(既定\)|セッション<br /><br /> \(既定\)|トランザクション|双方向|エンコード \(かっこ内は既定値\)|ストリーム<br /><br /> \(かっこ内は既定値\)|  
+|-------------|-----------|-------------------|----------------------|--------------|---------|------------------------|----------------------------|  
+|<xref:System.ServiceModel.BasicHttpBinding>|Basic Profile 1.1|\(なし\)、トランスポート、メッセージ、混在|\(なし\)|\(なし\)|n\/a|テキスト、\(MTOM\)|○<br /><br /> \(buffered\)|  
+|<xref:System.ServiceModel.WSHttpBinding>|WS|トランスポート、\(メッセージ\)、混在|\(なし\)、信頼できるセッション、セキュリティ保護されたセッション|\(なし\)、あり|適用なし|\(テキスト\)、MTOM|×|  
+|<xref:System.ServiceModel.WSDualHttpBinding>|WS|\(メッセージ\)、なし|\(信頼できるセッション\)、セキュリティ保護されたセッション|\(なし\)、あり|○|\(テキスト\)、MTOM|×|  
+|<xref:System.ServiceModel.WSFederationHttpBinding>|WS\-Federation|\(メッセージ\)、混在、なし|\(なし\)、信頼できるセッション、セキュリティ保護されたセッション|\(なし\)、あり|×|\(テキスト\)、MTOM|×|  
+|<xref:System.ServiceModel.NetHttpBinding>|.NET|\(なし\)、トランスポート、メッセージ、TransportWithMessageCredential、TransportCredentialOnly|下記のメモを参照|なし|下記のメモを参照|\(バイナリ\)、テキスト、MTOM|○ \(buffered\)|  
+|T:System.ServiceModel.NetHttpsBinding|.NET|\(トランスポート\)、TransportWithMessageCredential|下記のメモを参照|なし|下記のメモを参照|\(バイナリ\)、テキスト、MTOM|○ \(buffered\)|  
+|<xref:System.ServiceModel.NetTcpBinding>|.NET|\(トランスポート\)、メッセージ、なし、混在|\(トランスポート\)、信頼できるセッション、セキュリティ保護されたセッション|\(なし\)、あり|○|Binary|○<br /><br /> \(buffered\)|  
+|<xref:System.ServiceModel.NetNamedPipeBinding>|.NET|\(トランスポート\)、なし|なし、\(トランスポート\)|\(なし\)、あり|○|Binary|○<br /><br /> \(buffered\)|  
+|<xref:System.ServiceModel.NetMsmqBinding>|.NET|メッセージ、\(トランスポート\)、なし|\(なし\)、トランスポート|なし、\(あり\)|×|Binary|×|  
+|<xref:System.ServiceModel.NetPeerTcpBinding>|Peer|\(トランスポート\)|\(なし\)|\(なし\)|○||×|  
+|<xref:System.ServiceModel.MsmqIntegration.MsmqIntegrationBinding>|MSMQ|\(トランスポート\)|\(なし\)|なし、\(あり\)|適用なし|適用なし|×|  
+|<xref:System.ServiceModel.BasicHttpContextBinding>|Basic Profile 1.1|\(なし\)、トランスポート、メッセージ、混在|\(なし\)|\(なし\)|n\/a|テキスト、\(MTOM\)|○<br /><br /> \(buffered\)|  
+|<xref:System.ServiceModel.NetTcpContextBinding>|.NET|\(トランスポート\)、メッセージ、なし、混在|\(トランスポート\)、信頼できるセッション、セキュリティ保護されたセッション|\(なし\)、あり|○|Binary|○<br /><br /> \(buffered\)|  
+|<xref:System.ServiceModel.WSHttpContextBinding>|WS|トランスポート、\(メッセージ\)、混在|\(なし\)、信頼できるセッション、セキュリティ保護されたセッション|\(なし\)、あり|適用なし|テキスト、\(MTOM\)|×|  
+|<xref:System.ServiceModel.Channels.UdpBinding>|.NET **Note:**  相互運用性は、このバインディングが実装する標準の UDP 上の SOAP 仕様を実装することによって実現できます。|\(なし\)|\(なし\)|\(なし\)|適用なし|\(テキスト\)|×|  
+  
+> [!IMPORTANT]
+>  <xref:System.ServiceModel.NetHttpBinding> は、HTTP や WebSocket のサービスを使用するために設計されたバインディングで、既定でバイナリ エンコーディングを使用します。<xref:System.ServiceModel.NetHttpBinding> は、要求\/応答コントラクトまたは双方向コントラクトで使用されるかどうかを検出し、一致する動作を変更します。要求\/応答用の HTTP と双方向用の Websocket を使用します。この動作は、<xref:System.ServiceModel.NetHttpBinding.WebSocketTransportUsage%2A> バインディング構成を使用してオーバーライドできます。Allowed: 既定値で、上で説明したように動作します。NotAllowed: Websocket の使用を抑止します。この設定を使用した双方向コントラクトを使用しようとすると、例外が発生します。Required: 要求\/応答コントラクトでも Websocket が使用されるようにします。NetHttpBinding は、HTTP モードと WebSocket モードの両方で信頼できるセッションをサポートします。WebSocket モードでは、セッションはトランスポートによって提供されます。  
+  
+ 次の表では、前の表に示された機能について説明します。  
+  
+|機能|説明|  
+|--------|--------|  
+|相互運用性の種類|バインディングによる相互操作を可能にするプロトコルまたはテクノロジに名前を付けます。|  
+|セキュリティ|チャネルをセキュリティで保護する方法を指定します。<br /><br /> -   なし : SOAP のメッセージはセキュリティで保護されず、クライアントは認証されません。<br />-   トランスポート : セキュリティ要件はトランスポート層で満たされます。<br />-   メッセージ : セキュリティ要件はメッセージ層で満たされます。<br />-   混在 : メッセージ形式でクレームに含まれ、整合性と機密性の要件がトランスポート層で満たされます。|  
+|セッション|このバインディングでセッション コントラクトをサポートするかどうかを指定します。|  
+|トランザクション|トランザクションが有効かどうかを指定します。|  
+|双方向|双方向コントラクトがサポートされているかどうかを指定します。この機能はバインディングでセッションをサポートする必要があることに注意してください。|  
+|エンコード|メッセージのネットワーク上での形式を指定します。次の値を使用できます。<br /><br /> -   テキスト : UTF\-8 など<br />-   Binary<br />-   MTOM: SOAP エンベロープのコンテキストの中でバイナリ XML 要素を効率的にエンコードするためのメソッドです。|  
+|ストリーム|受信メッセージおよび送信メッセージに対してストリーミングをサポートするかどうかを指定します。バインディングで `TransferMode` プロパティを使用して値を設定します。次の値を使用できます。<br /><br /> -   <xref:System.ServiceModel.TransferMode>: 要求メッセージと応答メッセージを共にバッファリングします。<br />-   <xref:System.ServiceModel.TransferMode>: 要求メッセージと応答メッセージを共にストリーミングします。<br />-   <xref:System.ServiceModel.TransferMode>: 要求メッセージをストリーミングし、応答メッセージをバッファリングします。<br />-   <xref:System.ServiceModel.TransferMode>: 要求メッセージをバッファリングし、応答メッセージをストリーミングします。|  
+  
+## 参照  
+ [エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [サービスとクライアントを構成するためのバインディングの使用](../../../docs/framework/wcf/using-bindings-to-configure-services-and-clients.md)   
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/tools.md b/docs/framework/wcf/tools.md
new file mode 100644
index 00000000000..62a1698ef4e
--- /dev/null
+++ b/docs/framework/wcf/tools.md
@@ -0,0 +1,47 @@
+---
+title: "Windows Communication Foundation ツール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "WCF, ツール"
+  - "Windows Communication Foundation, ツール"
+ms.assetid: 399a47b4-bfea-434b-8e83-f76b5063d79d
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# Windows Communication Foundation ツール
+Microsoft [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] ツールは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの作成、展開、および管理を簡単に行うために設計されています。  このセクションには、これらのツールに関する詳細な情報があります。  ツールはサポートされていません。  
+  
+ すべてのツールは、コマンド ラインから実行できます。  
+  
+ 次の表は、ツールの一覧と簡単な説明を示します。  
+  
+|ツール|説明|  
+|---------|--------|  
+|[ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)|メタデータ ドキュメントからサービス モデル コードを生成し、サービス モデル コードからメタデータ ドキュメントを生成します。|  
+|[秘密キー検索ツール \(FindPrivateKey.exe\)](../../../docs/framework/wcf/find-private-key-tool-findprivatekey-exe.md)|指定されたストアから秘密キーを取得します。|  
+|[ServiceModel 登録ツール \(ServiceModelReg.exe\)](../../../docs/framework/wcf/servicemodelreg-exe.md)|単一コンピューター上で ServiceModel の登録と登録解除を管理します。|  
+|[COM\+ サービス モデル構成ツール \(ComSvcConfig.exe\)](../../../docs/framework/wcf/com-service-model-configuration-tool-comsvcconfig-exe.md)|COM\+ インターフェイスを Web サービスとして公開されるように構成します。|  
+|[構成エディター ツール \(SvcConfigEditor.exe\)](../../../docs/framework/wcf/configuration-editor-tool-svcconfigeditor-exe.md)|WCF サービスの構成設定を作成および変更します。|  
+|[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)|WCF サービスの問題を診断、修復、および検証できるように、トレース メッセージの表示、グループ化、およびフィルター処理を容易にします。|  
+|[WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)|コマンド ライン ツールを使用して、基本的な WS\-AtomicTransaction サポート設定を構成します。|  
+|[WS\-AtomicTransaction 構成 MMC スナップイン](../../../docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md)|MMC スナップインを使用して、基本的な WS\-AtomicTransaction サポート設定を構成します。|  
+|[ワークフロー サービス登録ツール \(WFServicesReg.exe\)](../../../docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md)|Windows ワークフロー サービスを登録します。|  
+|[WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)|ライブラリ \(\*.dll\) ファイルに含まれている [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストします。|  
+|[WCF のテスト用クライアント \(WcfTestClient.exe\)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)|任意の型のパラメーターを入力し、その入力をサービスに送信して、サービスから返される応答を表示するために使用される GUI ツールです。|  
+|[コントラクト優先ツール](../../../docs/framework/wcf/contract-first-tool.md)|XSD データ コントラクトからコード クラスを作成する Visual Studio のビルド タスク。|  
+  
+ ServiceModelReg.exe、WsatConfig.exe、および ComSvcConfig.exe を除き、これらすべてのツールは Windows SDK に付属しており、C:\\Program Files\\Microsoft SDKs\\Windows\\v6.0\\Bin フォルダーにあります。  上記の 3 つのツールは、C:\\Windows\\Microsoft.NET\\Framework\\v3.0\\Windows Communication Foundation にあります。
\ No newline at end of file
diff --git a/docs/framework/wcf/troubleshooting-setup-issues.md b/docs/framework/wcf/troubleshooting-setup-issues.md
new file mode 100644
index 00000000000..b9b5e7d87f1
--- /dev/null
+++ b/docs/framework/wcf/troubleshooting-setup-issues.md
@@ -0,0 +1,84 @@
+---
+title: "セットアップ問題のトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1644f885-c408-4d5f-a5c7-a1a907bc8acd
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# セットアップ問題のトラブルシューティング
+ここでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] セットアップ問題のトラブルシューティングの方法について説明します。  
+  
+## .NET Framework 3.0 の MSI 修復操作の実行では修復されない一部の Windows Communication Foundation レジストリ キー  
+ 次のいずれかのレジストリ キーを削除した場合  
+  
+-   HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\ServiceModelService 3.0.0.0  
+  
+-   HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\ServiceModelOperation 3.0.0.0  
+  
+-   HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\ServiceModelEndpoint 3.0.0.0  
+  
+-   HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\SMSvcHost 3.0.0.0  
+  
+-   HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Services\\MSDTC Bridge 3.0.0.0  
+  
+ **\[コントロール パネル\]** の **\[プログラムの追加と削除\]** から起動した .NET Framework 3.0 インストーラーを使用して修復を実行しても、上記のキーは再作成されません。これらのキーを正しく再作成するには、.NET Framework 3.0 をアンインストール後、再インストールする必要があります。  
+  
+## WMI サービスの破損により .NET Framework 3.0 パッケージのインストール中に Windows Communication Foundation WMI プロバイダーのインストールがブロックされる  
+ WMI サービスの破損により、Windows Communication Foundation WMI プロバイダーのインストールがブロックされることがあります。インストール中、Windows Communication Foundation インストーラーは mofcomp.exe コンポーネントを使用して WCF .mof ファイルを登録できません。発生する現象を次に示します。  
+  
+1.  .NET Framework 3.0 のインストールは正常に完了するのに、WCF WMI プロバイダーが登録されない。  
+  
+2.  アプリケーション イベント ログに、WCF の WMI プロバイダーの登録、または mofcomp.exe の実行に関する問題を示すエラー イベントが表示される。  
+  
+3.  ユーザーの %temp% ディレクトリの dd\_wcf\_retCA\* という名前のセットアップ ログ ファイルに、WCF WMI プロバイダーの登録に失敗したことが示される。  
+  
+4.  イベント ログまたはセットアップ トレース ログ ファイルに、次の例外のいずれかが記録される。  
+  
+     ServiceModelReg \[11:09:59:046\]: System.ApplicationException : "E:\\WINDOWS\\Microsoft.NET\\Framework\\v3.0\\Windows Communication Foundation\\ServiceModel.mof" で E:\\WINDOWS\\system32\\wbem\\mofcomp.exe を実行している間に予期しない結果 3 が発生しました  
+  
+     または、  
+  
+     ServiceModelReg \[07:19:33:843\]: System.TypeInitializationException : 'System.Management.ManagementPath' の型初期化子が例外をスローしました。\-\-\-\> System.Runtime.InteropServices.COMException \(0x80040154\) : CLSID {CF4CC405\-E2C5\-4DDD\-B3CE\-5E7582D8C9FA} を含むコンポーネントの COM クラス ファクトリを取得中に、次のエラーが発生しました: 80040154。  
+  
+     または、  
+  
+     ServiceModelReg \[07:19:32:750\]: System.IO.FileNotFoundException : ファイルまたはアセンブリ 'C:\\WINDOWS\\system32\\wbem\\mofcomp.exe'、またはその依存関係の 1 つが読み込めませんでした。指定されたファイルが見つかりません。  
+  
+     ファイル名 : C:\\WINDOWS\\system32\\wbem\\mofcomp.exe  
+  
+ 上で説明した問題を解決するためには、次の手順を実行する必要があります。  
+  
+1.  [WMI 診断ユーティリティ バージョン 2.0](http://go.microsoft.com/fwlink/?LinkId=94685) を実行して WMI サービスを修復します。このツールの使い方[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WMI 診断ユーティリティ](http://go.microsoft.com/fwlink/?LinkId=94686)」を参照してください。  
+  
+ **\[コントロール パネル\]** にある **\[プログラムの追加と削除\]** アプレットを使用して、.NET Framework 3.0 のインストールを修復するか、.NET Framework 3.0 をアンインストール後に再インストールします。  
+  
+## .NET Framework 3.5 のインストール後に .NET Framework 3.0 を修復すると、.NET Framework 3.5 によって導入された machine.config 内の構成要素が削除される  
+ [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] をインストールした後に .NET Framework 3.0 を修復すると、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] によって導入された machine.config 内の構成要素が削除されます。ただし、web.config は元の状態のままになります。この問題に対処するには、ARP 経由でこの作業を行った後に [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] を修復するか、`/c` スイッチを指定した [ワークフロー サービス登録ツール \(WFServicesReg.exe\)](../../../docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md) を使用します。  
+  
+ [ワークフロー サービス登録ツール \(WFServicesReg.exe\)](../../../docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md) は、%windir%\\Microsoft.NET\\framework\\v3.5\\ または %windir%\\Microsoft.NET\\framework64\\v3.5\\ にあります。  
+  
+## .NET Framework 3.5 のインストール後に WCF\/WF Webhost に対して IIS を適切に構成する  
+ [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] のインストールでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に関連する追加の IIS 構成設定の構成に失敗すると、インストール ログにエラーが記録され、インストールが続行されます。WorkflowServices アプリケーションを実行しようとしても、必要な構成設定がないため、実行することはできません。たとえば、xoml やルール サービスの読み込みに失敗する可能性があります。  
+  
+ この問題に対処するには、`/c` スイッチを指定した [ワークフロー サービス登録ツール \(WFServicesReg.exe\)](../../../docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md) を使用して、コンピューター上の IIS スクリプト マップを適切に構成します。[ワークフロー サービス登録ツール \(WFServicesReg.exe\)](../../../docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md) は、%windir%\\Microsoft.NET\\framework\\v3.5\\ または %windir%\\Microsoft.NET\\framework64\\v3.5\\ にあります。  
+  
+## アセンブリ 'System.ServiceModel, Version 3.0.0.0, Culture\=neutral, PublicKeyToken\=b77a5c561934e089' から型 'System.ServiceModel.Activation.HttpModule' を読み込むことができない  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] がインストールされている場合に、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)][!INCLUDE[indigo2](../../../includes/indigo2-md.md)] HTTP Activation を有効にすると、このエラーが発生します。この問題を解決するには、[!INCLUDE[vs2010](../../../includes/vs2010-md.md)] コマンド プロンプト内から次のコマンドを実行します。  
+  
+```Output  
+aspnet_regiis.exe -i -enable  
+```  
+  
+## 参照  
+ [セットアップ手順](../../../docs/framework/wcf/samples/set-up-instructions.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md b/docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md
new file mode 100644
index 00000000000..bc40d956337
--- /dev/null
+++ b/docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md
@@ -0,0 +1,83 @@
+---
+title: "チュートリアル入門のトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 69a21511-0871-4c41-9a53-93110e84d7fd
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# チュートリアル入門のトラブルシューティング
+このトピックでは、チュートリアル入門の作業中に遭遇する最も一般的な問題とその解決方法の一覧を示します。  
+  
+1.  [ハード ドライブ上のプロジェクト ファイルが見つからない。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q1)  
+  
+2.  [サービス アプリケーションを実行しようとすると次のエラーが発生する: HTTP が URL http://+:8000/ServiceModelSamples/Service/ を登録できませんでした。プロセスにこの名前空間へのアクセス権がありません。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q2)  
+  
+3.  [Svcutil.exe ツールを使用しようとすると次のエラーが発生する: 'svcutil' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q3)  
+  
+4.  [Svcutil.exe によって生成された App.config ファイルが見つからない。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q4)  
+  
+5.  [クライアント アプリケーションのコンパイル中に次の構文エラーが発生する: 'CalculatorClient' に '&lt;メソッド名&gt;' の定義が含まれておらず、型 'CalculatorClient' の最初の引数を受け付ける拡張メソッド '&lt;メソッド名&gt;' が見つかりませんでした。using ディレクティブまたはアセンブリ参照が不足しています。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q5)  
+  
+6.  [クライアント アプリケーションのコンパイル中に次のエラーが発生する: 型または名前空間名 'CalculatorClient' が見つかりませんでした。using ディレクティブまたはアセンブリ参照が不足しています。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q6)  
+  
+7.  [クライアントを実行すると次のエラーが発生する: 未処理の例外 : System.ServiceModel.EndpointNotFoundException: http://localhost:8000/ServiceModelSamples/Service/CalculatorService に接続できませんでした。TCP エラー コード 10061: 対象のコンピューターによって拒否されたため、接続できませんでした。](../../../docs/framework/wcf/troubleshooting-the-getting-started-tutorial.md#BKMK_q7)  
+  
+<a name="BKMK_q1"></a>   
+## ハード ドライブ上のプロジェクト ファイルが見つからない。  
+ [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] ではプロジェクト ファイルを [!INCLUDE[wv](../../../includes/wv-md.md)] および [!INCLUDE[win7_client_secondref](../../../includes/win7-client-secondref-md.md)] の c:\\users\\\<ユーザー名\\Documents\\\<Visual Studio version\>\\Projects に保存し、以前のバージョンの Windows では c:\\Documents and Settings\\\<ユーザー名\>\\My Documents\\\<Visual Studio バージョン\>\\Projects に保存します。  
+  
+<a name="BKMK_q2"></a>   
+## サービス アプリケーションを実行しようとすると次のエラーが発生する: HTTP が URL http:\/\/\+:8000\/ServiceModelSamples\/Service\/ を登録できませんでした。プロセスにこの名前空間へのアクセス権がありません。  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスをホストするプロセスは、管理特権で実行する必要があります。サービスを [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の内部から実行する場合は、管理者として [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を実行する必要があります。これを行うには、**\[スタート\]** ボタンをクリックし、\[[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)]\] を右クリックし、**\[管理者として実行\]** をクリックします。サービスをコマンド ライン プロンプトから実行する場合は、同様の方法で管理者としてコマンド ライン プロンプトを開始する必要があります。**\[スタート\]** ボタンをクリックし、**\[コマンド プロンプト\]** を右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+<a name="BKMK_q3"></a>   
+## Svcutil.exe ツールを使用しようとすると次のエラーが発生する: 'svcutil' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。  
+ Svcutil.exe がシステム パスに存在する必要があります。最も簡単な解決方法は、コマンド プロンプトを使用する方法です。**\[スタート\]** をクリックし、**\[すべてのプログラム\]**、\[[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)]\]、**\[Visual Studio ツール\]**、\[[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] コマンド プロンプト**\]** の順にクリックします。このコマンド プロンプトにより、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の一部として提供されているすべてのツールの正しい場所のシステム パスが設定されます。  
+  
+<a name="BKMK_q4"></a>   
+## Svcutil.exe によって生成された App.config ファイルが見つからない。  
+ **\[既存項目の追加\]** ダイアログ ボックスには、既定では .cs、.resx、.settings、.xsd、.wsdl の拡張子を持つファイルのみが表示されます。**\[既存項目の追加\]** ダイアログ ボックスの右下にあるドロップダウン リスト ボックスで \[**すべてのファイル \(\*.\*\)**\] をクリックすると、すべてのファイルの種類が表示されるように指定できます。  
+  
+<a name="BKMK_q5"></a>   
+## クライアント アプリケーションのコンパイル中に次の構文エラーが発生する: 'CalculatorClient' に '\<メソッド名\>' の定義が含まれておらず、型 'CalculatorClient' の最初の引数を受け付ける拡張メソッド '\<メソッド名\>' が見つかりませんでした。using ディレクティブまたはアセンブリ参照が不足しています。  
+ 外部に公開されるのは、`ServiceOperationAttribute` でマークされたメソッドのみです。`ICalculator` インターフェイスのメソッドのいずれかで `ServiceOperationAttribute` 属性を省略した場合、その属性が欠けている操作を呼び出すクライアント アプリケーションをコンパイルしたときにこのエラー メッセージが表示されます。  
+  
+<a name="BKMK_q6"></a>   
+## クライアント アプリケーションのコンパイル中に次のエラーが発生する: 型または名前空間名 'CalculatorClient' が見つかりませんでした。using ディレクティブまたはアセンブリ参照が不足しています。  
+ Proxy.cs または Proxy.vb ファイルをクライアント プロジェクトに追加しなかった場合にこのエラーが発生します。  
+  
+<a name="BKMK_q7"></a>   
+## クライアントを実行すると次のエラーが発生する: 未処理の例外 : System.ServiceModel.EndpointNotFoundException: http:\/\/localhost:8000\/ServiceModelSamples\/Service\/CalculatorService に接続できませんでした。TCP エラー コード 10061: 対象のコンピューターによって拒否されたため、接続できませんでした。  
+ サービスを実行せずにクライアント アプリケーションを実行した場合にこのエラーが発生します。  
+  
+<a name="BKMK_q8"></a>   
+## 未処理の例外: System.ServiceModel.Security.SecurityNegotiationException: ターゲット 'http:\/\/localhost:8000\/ServiceModelSamples\/Service\/CalculatorService' への 'http:\/\/localhost:8000\/ServiceModelSamples\/Service\/CalculatorService' との SOAP セキュリティ ネゴシエーションが失敗しました。  
+ ドメインに参加しているコンピューターにネットワーク接続がない場合にこのエラーが発生します。コンピューターをネットワークに接続するか、クライアントとサービスの両方のセキュリティをオフにします。サービスの場合は、WSHttpBinding を作成するコードを次のように変更します。  
+  
+```  
+// Step 3 of the hosting procedure: Add a service endpoint  
+selfhost.AddServiceEndpoint(typeof(ICalculator), new WSHttpBinding(SecurityMode.None), "CalculatorService");  
+  
+```  
+  
+ クライアントの場合、**\<binding\>** 要素の下にある **\<security\>** 要素を次のように変更します。  
+  
+```  
+<security mode="Node" />  
+```  
+  
+## 参照  
+ [チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)   
+ [WCF トラブルシューティング クイックスタート](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md)   
+ [セットアップ問題のトラブルシューティング](../../../docs/framework/wcf/troubleshooting-setup-issues.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/understanding-protection-level.md b/docs/framework/wcf/understanding-protection-level.md
new file mode 100644
index 00000000000..070990c6280
--- /dev/null
+++ b/docs/framework/wcf/understanding-protection-level.md
@@ -0,0 +1,112 @@
+---
+title: "保護レベルの理解 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ProtectionLevel プロパティ"
+  - "WCF, セキュリティ"
+ms.assetid: 0c034608-a1ac-4007-8287-b1382eaa8bf2
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# 保護レベルの理解
+`ProtectionLevel` プロパティは、<xref:System.ServiceModel.ServiceContractAttribute> クラス、<xref:System.ServiceModel.OperationContractAttribute> クラスなど、多くのクラスで使用されています。このプロパティは、メッセージの一部または全体を保護する方法を制御します。このトピックでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] の機能と動作について説明します。  
+  
+ 保護レベルの設定手順については、「[方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)」を参照してください。  
+  
+> [!NOTE]
+>  保護レベルは構成ではなく、コードでのみ設定できます。  
+  
+## 基本  
+ 保護レベル機能には、次の基本的な原則が適用されます。  
+  
+-   メッセージのどの部分の保護にも、3 つの基本レベルがあります。このプロパティは、必ず、<xref:System.Net.Security.ProtectionLevel> 列挙値の 1 つに設定されます。以下に、これらの値を保護の弱いものから順に示します。  
+  
+    -   `None`.  
+  
+    -   `Sign`.保護された部分はデジタル署名されます。これによって、保護されたメッセージ部分に対する改ざんが確実に検出されます。  
+  
+    -   `EncryptAndSign`.メッセージ部分は、署名される前に機密性を保証するために暗号化されます。  
+  
+-   この機能を使用して、*アプリケーション データ*専用の保護要件を設定することができます。たとえば、WS\-Addressing ヘッダーは、インフラストラクチャ データであるため、`ProtectionLevel` の影響を受けません。  
+  
+-   セキュリティ モードが `Transport` に設定されている場合は、メッセージ全体がトランスポート メカニズムで保護されます。したがって、メッセージの異なる部分に別々の保護レベルを設定しても効果はありません。  
+  
+-   `ProtectionLevel` を使用すると、開発者は、バインドで順守する必要のある*最低レベル*を設定できます。サービスの展開時に、構成内で指定されている実際のバインドは、最低レベルをサポートしている場合もあれば、サポートしていない場合もあります。たとえば、<xref:System.ServiceModel.BasicHttpBinding> クラスは既定の設定ではセキュリティを提供しません \(提供するように設定することもできます\)。そのため、`None` 以外に設定したコントラクトとこのバインドを使用すると、例外がスローされます。  
+  
+-   サービスで、すべてのメッセージに対して最低限の `ProtectionLevel` を `Sign` に設定することが求められる場合、\([!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 以外の手法で作成された可能性のある\) クライアントでは、すべてのメッセージを暗号化し、署名することができます \(要求された最低レベルを満たします\)。この場合、クライアントが最低レベル以上の処理を実行するため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は例外をスローしません。ただし、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーション \(サービスまたはクライアント\) では、可能な場合でもメッセージ部分を過剰に保護することはなく、最低レベルが順守されることに注意してください。また、セキュリティ モードとして `Transport` を使用すると、トランスポートをより詳細なレベルで保護できないため、メッセージ ストリームを過剰に保護する可能性があることに注意してください。  
+  
+-   `ProtectionLevel` を明示的に `Sign` と `EncryptAndSign` のいずれかに設定する場合、セキュリティを有効にしたバインドを使用する必要があります。使用しない場合は、例外がスローされます。  
+  
+-   セキュリティを有効にしたバインドを選択し、コントラクト上のどこにも `ProtectionLevel` プロパティを設定しない場合は、すべてのアプリケーション データが暗号化および署名されます。  
+  
+-   セキュリティを無効にしたバインド \(たとえば、`BasicHttpBinding` クラスは既定でセキュリティが無効に設定されています\) を選択し、`ProtectionLevel` を明示的に設定しない場合は、どのアプリケーション データも保護されません。  
+  
+-   トランスポート レベルでセキュリティを適用するバインドを使用している場合、すべてのアプリケーション データは、トランスポートの機能に準じてセキュリティ保護されます。  
+  
+-   メッセージ レベルでセキュリティを適用するバインドを使用している場合、アプリケーション データは、コントラクトに設定された保護レベルに準じてセキュリティ保護されます。保護レベルを指定しない場合、メッセージ内のすべてのアプリケーション データが暗号化および署名されます。  
+  
+-   `ProtectionLevel` は、異なるスコープ レベルに設定することができます。スコープが関連付けられている階層構造については、次のセクションで説明します。  
+  
+## スコープ  
+ `ProtectionLevel` を最上位の API に設定すると、その下位のすべての階層がそのレベルに設定されます。より下位の階層で `ProtectionLevel` を別の値に設定すると、それ以下の階層のすべての API が新しいレベルにリセットされます \(それより上位の階層の API は、引き続き最上位での設定に従います\)。階層を次に示します。同じレベルの属性は、同等です。  
+  
+ <xref:System.ServiceModel.ServiceContractAttribute>  
+  
+ <xref:System.ServiceModel.OperationContractAttribute>  
+  
+ <xref:System.ServiceModel.FaultContractAttribute>  
+  
+ <xref:System.ServiceModel.MessageContractAttribute>  
+  
+ <xref:System.ServiceModel.MessageHeaderAttribute>  
+  
+ <xref:System.ServiceModel.MessageBodyMemberAttribute>  
+  
+## ProtectionLevel のプログラミング  
+ 階層内のいずれかの位置で `ProtectionLevel` をプログラムするには、属性の適用時にこのプロパティを適切な値に設定します。例については、「[方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)」を参照してください。  
+  
+> [!NOTE]
+>  フォールトおよびメッセージ コントラクトにプロパティを設定するには、これらの機能を理解する必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)」および「[メッセージ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-message-contracts.md)」を参照してください。  
+  
+## WS\-Addressing の依存関係  
+ [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) を使用してクライアントを生成すると、ほとんどの場合、クライアント コントラクトとサービス コントラクトが同じになります。ただし、同じように見えるコントラクトによって、クライアントから例外がスローされる場合があります。これが発生するのは、バインディングが WS\-Addressing 仕様をサポートせず、コントラクトで複数レベルの保護が指定されている場合です。たとえば、<xref:System.ServiceModel.BasicHttpBinding> クラスはこの仕様をサポートしておらず、また WS\-Addressing をサポートしないカスタム バインディングが作成されている場合もあります。`ProtectionLevel` 機能は、WS\-Addressing 仕様に依存して 1 つのコントラクトでさまざまな保護レベルを有効にします。バインディングが WS\-Addressing 仕様をサポートしない場合は、すべてのレベルが同一の保護レベルに設定されます。コントラクトのすべてのスコープに対して有効な保護レベルは、コントラクトで使用されている最も強力な保護レベルに設定されます。  
+  
+ これにより、一見するとデバッグが困難な問題が発生する場合があります。複数のサービスに適合するメソッドを含むクライアント コントラクト \(インターフェイス\) を作成できます。つまり、同一のインターフェイスを使用して、多くのサービスと通信するクライアントを作成し、この 1 つのインターフェイスに、すべてのサービスに適合するメソッドを格納します。このまれなシナリオでは、特定のサービスに適合するメソッドだけを呼び出すように注意する必要があります。バインディングが <xref:System.ServiceModel.BasicHttpBinding> クラスの場合は、複数の保護レベルはサポートされません。ただし、クライアントに応答するサービスは、必要な保護レベルよりも低い保護レベルを使用してクライアントに応答する場合もあります。この場合、クライアントは、より高い保護レベルを求めているため例外をスローします。  
+  
+ この問題をコード例で示します。次の例は、サービスとクライアント コントラクトを示しています。バインディングが [\<basicHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/basichttpbinding.md) 要素であると想定します。したがって、コントラクトでのすべての操作に同一の保護レベルが割り当てられます。この同一の保護レベルは、すべての操作での最大保護レベルとして決定されます。  
+  
+ サービス コントラクトは次のとおりです。  
+  
+ [!code-csharp[c_ProtectionLevel#7](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#7)]
+ [!code-vb[c_ProtectionLevel#7](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#7)]  
+  
+ 次のコードは、クライアント コントラクト インターフェイスを示しています。このコードには、別のサービスで使用するための `Tax` メソッドが含まれることに注意してください。  
+  
+ [!code-csharp[c_ProtectionLevel#8](../../../samples/snippets/csharp/VS_Snippets_CFX/c_protectionlevel/cs/source.cs#8)]
+ [!code-vb[c_ProtectionLevel#8](../../../samples/snippets/visualbasic/VS_Snippets_CFX/c_protectionlevel/vb/source.vb#8)]  
+  
+ クライアントが `Price` メソッドを呼び出し、サービスから応答を受け取ると、例外をスローします。例外をスローするのは、クライアントが `ServiceContractAttribute` で `ProtectionLevel` を指定していないため、`Price` メソッドを含むすべてのメソッドに既定値 \(<xref:System.Net.Security.ProtectionLevel>\) を使用するからです。ただし、保護レベルが <xref:System.Net.Security.ProtectionLevel> に設定された 1 つのメソッドがサービス コントラクトで定義されているため、サービスは、<xref:System.Net.Security.ProtectionLevel> レベルを使用して値を返します。この場合、クライアントは、サービスからの応答を検証するときにエラーをスローします。  
+  
+## 参照  
+ <xref:System.ServiceModel.ServiceContractAttribute>   
+ <xref:System.ServiceModel.OperationContractAttribute>   
+ <xref:System.ServiceModel.FaultContractAttribute>   
+ <xref:System.ServiceModel.MessageContractAttribute>   
+ <xref:System.ServiceModel.MessageHeaderAttribute>   
+ <xref:System.ServiceModel.MessageBodyMemberAttribute>   
+ <xref:System.Net.Security.ProtectionLevel>   
+ [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)   
+ [方法 : ProtectionLevel プロパティを設定する](../../../docs/framework/wcf/how-to-set-the-protectionlevel-property.md)   
+ [コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md)   
+ [メッセージ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-message-contracts.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/using-bindings-to-configure-services-and-clients.md b/docs/framework/wcf/using-bindings-to-configure-services-and-clients.md
new file mode 100644
index 00000000000..3d3fbd99253
--- /dev/null
+++ b/docs/framework/wcf/using-bindings-to-configure-services-and-clients.md
@@ -0,0 +1,74 @@
+---
+title: "サービスとクライアントを構成するためのバインディングの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "バインディング [WCF], 使用"
+ms.assetid: c39479c3-0766-4a17-ba4c-97a74607f392
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# サービスとクライアントを構成するためのバインディングの使用
+バインディングとは、エンドポイントへの接続に必要な通信の詳細設定を指定するオブジェクトです。  具体的には、バインディングには構成情報が含まれており、この情報を使用してそれぞれのエンドポイントまたはクライアント チャネルで使用されるトランスポート仕様、ワイヤ形式 \(メッセージ エンコード\) 仕様、プロトコル仕様が定義され、クライアントまたはサービスのランタイムが作成されます。  機能する [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスを作成するには、サービスの各エンドポイントにバインディングが必要です。  ここでは、エンドポイントにおけるバインディングの概要と定義方法、特定のバインディングの指定方法を説明します。  
+  
+## バインディングの定義内容  
+ バインディングの情報は、非常に基本的な情報にすることも複雑なものにすることもできます。  最も基本的なバインディングはトランスポート プロトコル \(HTTP など\) のみを指定したもので、これはエンドポイントへの接続に必ず使用します。  一般的に、バインディングに含まれるエンドポイントへの接続方法を示す情報は、次のカテゴリのいずれかに当てはまります。  
+  
+ プロトコル  
+ 使用されているセキュリティ機構 \(信頼性の高いメッセージング機能またはトランザクション コンテキストのフロー設定のいずれか\) を決定します。  
+  
+ Transport  
+ 使用する基本のトランスポート プロトコル \(TCP や HTTP など\) を決定します。  
+  
+ エンコーディング  
+ メッセージ エンコード \(Text\/XML、バイナリ、MTOM \(Message Transmission Optimization Mechanism\) など\) を決定します。これは、メッセージをネットワーク上のバイト ストリームとしてどのように表現するかを決定します。  
+  
+## システム標準のバインディング  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に用意されているシステム指定の一連のバインディングは、一般的なアプリケーションの要件とシナリオに対応するように設計されています。  システム指定のバインディングの例のいくつかを次のクラスで示します。  
+  
+-   <xref:System.ServiceModel.BasicHttpBinding> : WS\-I Basic Profile 1.1 仕様に準拠する Web サービス \(ASP.NET Web サービス \(ASMX\) ベースのサービスなど\) への接続に適した HTTP プロトコル バインディング。  
+  
+-   <xref:System.ServiceModel.WsHttpBinding> : Web サービス仕様のプロトコルに準拠するエンドポイントへの接続に適した HTTP プロトコル バインディング。  
+  
+-   <xref:System.ServiceModel.NetNamedPipeBinding> : .NET Binary エンコードとフレーム技術を Windows 名前付きパイプ トランスポートと組み合わせて使用し、同じコンピューター上の他の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] エンドポイントに接続します。  
+  
+-   <xref:System.ServiceModel.NetMsmqBinding> : .NET Binary エンコードとフレーム技術を Microsoft Message Queue \(MSMQ\) と組み合わせて使用し、キューに置かれたメッセージと他の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] エンドポイントとの接続を作成します。  
+  
+ システム指定のバインディングの完全な一覧と説明については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## カスタム バインディング  
+ システム指定のバインディング コレクションに、サービス アプリケーションに必要な機能の適切な組み合わせが含まれていない場合は、<xref:System.ServiceModel.Channels.CustomBinding> バインディングを作成できます。  <xref:System.ServiceModel.Channels.CustomBinding> バインディングの要素[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[\<customBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md)」および「[カスタム バインディング](../../../docs/framework/wcf/extending/custom-bindings.md)」を参照してください。  
+  
+## バインディングの使用  
+ バインディングを使用する際には、次の 2 つの基本手順があります。  
+  
+1.  バインディングを選択、または定義します。  最も簡単な方法は、システム指定のバインディングを 1 つ選択し、それを既定の設定で使用することです。  また、システム指定のバインディングを選択し、そのプロパティを要件に適した値に再設定することもできます。  さらに、カスタム バインディングを作成し、すべてのプロパティを必要に応じて設定することもできます。  
+  
+2.  このバインディングを使用するエンドポイントを作成します。  
+  
+## コードおよび構成  
+ バインディングは、コードまたは構成を使用して定義または構成できます。  この 2 つの方法は使用するバインディングの種類に依存しません。たとえば、システム指定のバインディングまたは <xref:System.ServiceModel.Channels.CustomBinding> バインディングのどちらを使用していても関係ありません。  一般に、コードを使用すると、コンパイル時に開発者がバインディングの定義を完全に制御できます。  一方、構成を使用する場合は、システム管理者、または [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスまたはクライアントのユーザーが、バインディングのパラメーターを変更できます。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションの展開先の具体的なコンピューター要件やネットワーク条件を予測する方法はないため、この柔軟性が望ましい場合が少なくありません。  バインディング \(およびアドレス\) 情報がコードから分離されているため、管理者はアプリケーションの再コンパイルや再配置を行わずにバインディングの詳細を変更できます。  バインディングをコードに定義した場合、構成ファイルに記述されている構成ベースの定義はすべて上書きされます。  この方法についての例は、以下のトピックを参照してください。  
+  
+-   「[方法 : マネージ アプリケーションで WCF サービスをホストする](../../../docs/framework/wcf/how-to-host-a-wcf-service-in-a-managed-application.md)」では、コードでのバインディングの作成例を紹介しています。  
+  
+-   「[方法 : クライアントを構成する](../../../docs/framework/wcf/how-to-configure-a-basic-wcf-client.md)」では、構成を使ったクライアントの作成例を紹介しています。  
+  
+## 参照  
+ [エンドポイントの作成の概要](../../../docs/framework/wcf/endpoint-creation-overview.md)   
+ [方法 : 構成でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-configuration.md)   
+ [方法 : コード内でサービス バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-service-binding-in-code.md)   
+ [方法 : 構成でクライアント バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-client-binding-in-configuration.md)   
+ [方法 : コード内でクライアント バインディングを指定する](../../../docs/framework/wcf/how-to-specify-a-client-binding-in-code.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/using-sessions.md b/docs/framework/wcf/using-sessions.md
new file mode 100644
index 00000000000..788efa40cd5
--- /dev/null
+++ b/docs/framework/wcf/using-sessions.md
@@ -0,0 +1,154 @@
+---
+title: "セッションの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "セッション [WCF]"
+ms.assetid: 864ba12f-3331-4359-a359-6d6d387f1035
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# セッションの使用
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] アプリケーションでは、*"セッション"* がメッセージのグループを相互に関連付けて通信を行います。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] セッションは、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] アプリケーションで使用できるセッション オブジェクトとは異なるものであり、サポートされる動作と制御する方法が異なります。 ここでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アプリケーションのセッションで有効になる諸機能とそれらの使用方法について説明します。  
+  
+## Windows Communication Foundation アプリケーションのセッション  
+ サービス コントラクトでセッションが必要であると指定されている場合、すべての呼び出し \(つまり、呼び出しをサポートする基本的なメッセージ交換\) を同じメッセージ交換の一部にする必要があります。 セッションが許可されるが必須ではないコントラクトの場合、クライアントは、接続した後にセッションを確立できます。また、セッションを確立しないままにしておくこともできます。 セッションが終了したのに、同じチャネルでメッセージが送信されると、例外がスローされます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] セッションには、主に次のような概念的特徴があります。  
+  
+-   呼び出し側アプリケーション \(WCF クライアント\) によって明示的に開始および終了される。  
+  
+-   セッション中に配信されたメッセージは、受信された順に処理される。  
+  
+-   セッションはメッセージのグループを相互に関連付けて通信を行う。 関連付けにはさまざまな種類があります。 たとえば、あるセッション ベースのチャネルでは、共有ネットワーク接続に基づいてメッセージが相互に関連付けられる一方、別のセッション ベースのチャネルでは、メッセージ本文にある共有タグに基づいてメッセージが相互に関連付けられます。 セッションから派生可能な機能は、相互関連付けの性質によって異なります。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] セッションに関連付けられた一般的なデータ ストアはありません。  
+  
+ <xref:System.Web.SessionState.HttpSessionState?displayProperty=fullName> アプリケーションの [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] クラスに精通している場合は、この種のセッションと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] セッションの間に次のような相違があることがわかります。  
+  
+-   [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] セッションは、常にサーバーによって開始される。  
+  
+-   [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] セッションは、暗黙的に順序付けされない。  
+  
+-   [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] セッションは、要求全体について一般的なデータ ストレージ機構を提供する。  
+  
+ このトピックでは、次の項目について説明します。  
+  
+-   サービス モデル レイヤーにおいてセッション ベースのバインディングを使用する場合の既定の実行動作。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のセッション ベースのシステム提供バインディングが提供する機能の種類。  
+  
+-   セッションの要件を宣言するコントラクトの作成方法。  
+  
+-   セッションの作成と終了、およびセッションとサービス インスタンスの関係を理解し、制御する方法。  
+  
+## セッションを使用した既定の実行動作  
+ セッションの開始を試みるバインディングは、*セッション ベース*のバインディングと呼ばれます。 サービス コントラクトで、セッション ベースのバインディングを要求、許可、または拒否するように指定するときは、サービス コントラクト インターフェイス \(またはクラス\) の <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.SessionMode?displayProperty=fullName> 列挙値に設定します。 このプロパティの既定値は <xref:System.ServiceModel.SessionMode> であり、その場合、クライアントが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス実装でセッション ベースのバインディングを使用すると、サービスは、提供されるセッションを確立して使用します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスがクライアント セッションを受け入れると、既定で次の機能が有効になります。  
+  
+1.  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクト間のすべての呼び出しは、同一のサービス インスタンスによって処理されます。  
+  
+2.  さまざまなセッション ベースのバインディングによって追加機能が提供されます。  
+  
+## システム指定のセッションの種類  
+ セッション ベースのバインディングは、サービス インスタンスと特定のセッションとの既定の関連付けをサポートします。 ただし、前のセッション ベースのインスタンス化制御を有効にすることに加えて、セッション ベースのバインディングごとにサポートされる機能も異なります。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、次の種類のセッション ベースのアプリケーション動作が用意されています。  
+  
+-   2 者間の通信で特定のセキュリティ保護されたメッセージ交換について両者の合意が成立している場合、<xref:System.ServiceModel.Channels.SecurityBindingElement?displayProperty=fullName> は、セキュリティ ベースのセッションをサポートします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [サービスのセキュリティ保護](../../../docs/framework/wcf/securing-services.md)。 たとえば、セキュリティ セッションと信頼できるセッションの両方のサポートを含む <xref:System.ServiceModel.WSHttpBinding?displayProperty=fullName> バインディングは、既定では、メッセージを暗号化してデジタル署名を行うセキュリティで保護されたセッションのみを使用します。  
+  
+-   <xref:System.ServiceModel.NetTcpBinding?displayProperty=fullName> バインディングは、TCP\/IP ベースのセッションをサポートしており、すべてのメッセージがソケット レベルの接続によって関連付けられます。  
+  
+-   WS\-ReliableMessaging 仕様を実装する <xref:System.ServiceModel.Channels.ReliableSessionBindingElement?displayProperty=fullName> 要素は、メッセージを順番に 1 回だけ配信するように構成できる、信頼できるセッションをサポートします。これにより、メッセージ交換時にメッセージが複数のノードを通過する場合でもメッセージが受信されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [信頼できるセッション](../../../docs/framework/wcf/feature-details/reliable-sessions.md)。  
+  
+-   <xref:System.ServiceModel.NetMsmqBinding?displayProperty=fullName> バインディングは、MSMQ データグラム セッションを提供します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [WCF のキュー](../../../docs/framework/wcf/feature-details/queues-in-wcf.md)。  
+  
+ <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A> プロパティを設定しても、コントラクトが必要とするセッションの種類は指定されず、コントラクトがセッションを必要とすることだけが指定されます。  
+  
+## セッションを必要とするコントラクトの作成  
+ セッションを必要とするコントラクトを作成するのは、サービス コントラクトで宣言する操作のグループをすべて同じセッション内で実行し、メッセージを順番に配信する必要がある場合です。 サービス コントラクトが必要とするセッションのサポート レベルをアサートするには、サービス コントラクト インターフェイスまたはクラスの <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A?displayProperty=fullName> プロパティを <xref:System.ServiceModel.SessionMode?displayProperty=fullName> 列挙値に設定して以下を指定します。  
+  
+-   コントラクトがセッションを必要とするかどうか。  
+  
+-   コントラクトで、クライアントによるセッションの確立を許可するかどうか。  
+  
+-   コントラクトでセッションを禁止するかどうか。  
+  
+ ただし、<xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A> プロパティを設定しても、コントラクトが必要とするセッション ベースの動作の種類は指定されません。 このプロパティは、サービスの \(通信チャネルを作成する\) 構成済みバインディングが、サービスの実装時にセッションを確立する、確立しない、または確立できるかを実行時に確認するよう [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] に指示します。 ここでもバインディングは、選択する任意の種類のセッション ベースの動作 \(セキュリティ セッション、トランスポート セッション、信頼できるセッション、またはこれらの一定の組み合わせ\) によってこの要件を満たすことができます。 正確な動作は、選択した <xref:System.ServiceModel.SessionMode?displayProperty=fullName> 値によって決まります。 サービスの構成済みバインディングが <xref:System.ServiceModel.ServiceContractAttribute.SessionMode%2A> の値に一致しない場合は、例外がスローされます。 セッションをサポートするバインディングと、それが作成するチャネルは、セッション ベースのバインディングまたはチャネルと呼ばれます。  
+  
+ 次のサービス コントラクトは、`ICalculatorSession` のすべての操作をセッション内で交換する必要があることを指定しています。`Equals` メソッドを除き、どの操作も呼び出し元に値を返しません。 ただし、`Equals` メソッドはパラメーターを受け取らないため、データが既に他の操作に渡されているセッション内では、ゼロ以外の値しか返すことができません。 このコントラクトでは、セッションが正常に機能する必要があります。 特定のクライアントに関連付けられているセッションがないと、サービス インスタンスは、そのクライアントが以前に送信したデータを知ることができません。  
+  
+ [!code-csharp[S_Service_Session#1](../../../samples/snippets/csharp/VS_Snippets_CFX/s_service_session/cs/service.cs#1)]
+ [!code-vb[S_Service_Session#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_service_session/vb/service.vb#1)]  
+  
+ サービスがセッションを許可した場合は、クライアントがセッションを開始するとセッションが確立され、使用されますが、許可しない場合は、セッションが確立されません。  
+  
+## セッションとサービス インスタンス  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で既定のインスタンス化動作を使用した場合は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクト間のすべての呼び出しが同じサービス インスタンスによって処理されます。 そのため、アプリケーション レベルでは、セッションは、ローカル呼び出し動作と同様のアプリケーション動作を有効にすると考えることができます。 たとえば、ローカル オブジェクトを作成するときは、次のような流れになります。  
+  
+-   コンストラクターが呼び出されます。  
+  
+-   この後に、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクト参照に対して行われる呼び出しは、すべて同じオブジェクト インスタンスによって処理されます。  
+  
+-   オブジェクト参照が破棄されると、デストラクターが呼び出されます。  
+  
+ 既定のサービス インスタンス動作を使用している限り、セッションでは、クライアントとサービス間で同様の動作が有効になります。 サービス コントラクトがセッションを必要としたり、サポートしたりする場合は、<xref:System.ServiceModel.OperationContractAttribute.IsInitiating%2A> プロパティと <xref:System.ServiceModel.OperationContractAttribute.IsTerminating%2A> プロパティを設定することで、1 つ以上のコントラクト操作をセッションの開始または終了としてマークできます。  
+  
+ *開始操作*は、新しいセッションの最初の操作として呼び出す必要がある操作です。 開始操作以外の操作は、少なくとも 1 つの開始操作が呼び出された後にしか呼び出すことはできません。 そのため、サービス インスタンスの開始に適した入力をクライアントから取得するように設計された開始操作を宣言することで、サービスに対する一種のセッション コンストラクターを作成できます  \(ただし、状態はセッションに関連付けられ、サービス オブジェクトに関連付けられません\)。  
+  
+ *終了操作*は、開始操作とは逆に、既存のセッションの最終メッセージとして呼び出す必要がある操作です。 既定では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、サービスが関連付けられているセッションが閉じられた後に、サービス オブジェクトとそのコンテキストを再利用します。 そのため、サービス インスタンスの終了に適した関数を実行するように設計された終了操作を宣言することで、一種のデストラクターを作成できます。  
+  
+> [!NOTE]
+>  既定の動作は、ローカルのコンストラクターとデストラクターに似ていますが、あくまで似ているだけです。 任意の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス操作を開始操作または終了操作として使用できます。また、両方を同時に兼ねることもできます。 さらに既定では、開始操作は、任意の順序で何回でも呼び出すことができます。そのため、<xref:System.ServiceModel.InstanceContext?displayProperty=fullName> オブジェクトを操作することでサービス インスタンスの有効期間を明示的に制御しない限り、セッションが確立されインスタンスに関連付けられた後に、追加セッションは作成されません。 また、状態はセッションに関連付けられ、サービス オブジェクトには関連付けられません。  
+  
+ たとえば、前の例で使用した `ICalculatorSession` コントラクトで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトが、他の操作に先立って最初に `Clear` 操作を呼び出す必要があり、さらにこの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトとのセッションが、`Equals` 操作を呼び出したときに終了する必要があるとします。 次のコード例は、この要件を強制的に適用するコントラクトを示しています。 セッションを開始するにはまず `Clear` を呼び出す必要があります。`Equals` を呼び出すとセッションが終了します。  
+  
+ [!code-csharp[SCA.IsInitiatingIsTerminating#1](../../../samples/snippets/csharp/VS_Snippets_CFX/sca.isinitiatingisterminating/cs/service.cs#1)]
+ [!code-vb[SCA.IsInitiatingIsTerminating#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/sca.isinitiatingisterminating/vb/service.vb#1)]  
+  
+ サービスは、クライアントとのセッションを開始しません。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント アプリケーションでは、セッション ベースのチャネルの有効期間とセッション自体の有効期間の間には直接的な関係があります。 そのため、クライアントは、新しいセッション ベースのチャネルを作成することによって新しいセッションを作成し、セッション ベースのチャネルを正常に閉じることによって、既存のセッションを破棄します。 クライアントは、次のいずれかを呼び出してサービス エンドポイントとのセッションを開始します。  
+  
+-   <xref:System.ServiceModel.ICommunicationObject.Open%2A?displayProperty=fullName> の呼び出しによって返されるチャネルの <xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A?displayProperty=fullName>。  
+  
+-   [ServiceModel メタデータ ユーティリティ ツール \(Svcutil.exe\)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) によって生成される [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトの <xref:System.ServiceModel.ClientBase%601.Open%2A?displayProperty=fullName>。  
+  
+-   いずれかの型の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトの開始操作 \(既定では、すべての操作が開始操作です\)。 最初の操作が呼び出されると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトが自動的にチャネルを開き、セッションを開始します。  
+  
+ 通常は、クライアントが次のいずれかを呼び出して、サービス エンドポイントとのセッションを終了します。  
+  
+-   <xref:System.ServiceModel.ICommunicationObject.Close%2A?displayProperty=fullName> の呼び出しによって返されるチャネルの <xref:System.ServiceModel.ChannelFactory%601.CreateChannel%2A?displayProperty=fullName>。  
+  
+-   Svcutil.exe によって生成された <xref:System.ServiceModel.ClientBase%601.Close%2A?displayProperty=fullName> クライアント オブジェクトの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]。  
+  
+-   いずれかの型の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトの終了操作 \(既定では、終了操作はありません。コントラクトで終了操作を明示的に指定する必要があります\)。 最初の操作が呼び出されると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトが自動的にチャネルを開き、セッションを開始します。  
+  
+ 例については、「[方法 : セッションを必要とするサービスを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-service-that-requires-sessions.md)」、および「[既定のサービスの動作](../../../docs/framework/wcf/samples/default-service-behavior.md)」や「[インスタンス化](../../../docs/framework/wcf/samples/instancing.md)」のサンプルを参照してください。  
+  
+ クライアントとセッションの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)」を参照してください。  
+  
+## InstanceContext 設定と対話するセッション  
+ コントラクト内の <xref:System.ServiceModel.SessionMode> 列挙と、チャネルと特定のサービス オブジェクト間の関連付けを制御する <xref:System.ServiceModel.ServiceBehaviorAttribute.InstanceContextMode%2A?displayProperty=fullName> プロパティの間には相互作用があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [セッション、インスタンス化、および同時実行](../../../docs/framework/wcf/feature-details/sessions-instancing-and-concurrency.md)。  
+  
+### InstanceContext オブジェクトの共有  
+ ユーザーが自ら関連付けを行うことにより、どの <xref:System.ServiceModel.InstanceContext> オブジェクトに、どのセッション ベースのチャネルまたは呼び出しを関連付けるかを制御することもできます。 コード例全体については、「[InstanceContextSharing](http://msdn.microsoft.com/ja-jp/4a6a46d7-b7d7-4bb5-a0dd-03ffa3cbc230)」を参照してください。  
+  
+## セッションとストリーミング  
+ 大量のデータを転送する場合、メッセージ全体をメモリ内でバッファー化および処理するという既定動作の代わりに、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のストリーミング転送モードを使用することができます。 セッション ベースのバインディングでストリーミングを呼び出すと、予期しない動作を引き起こすことがあります。 すべてのストリーミング呼び出しは単一のチャネル \(データグラム チャネル\) を通じて行われますが、このチャネルは使用されるバインディングがセッションを使用するように構成されている場合であっても、セッションをサポートしません。 セッション ベースのバインディングによって複数のクライアントが同一のサービス オブジェクトに対してストリーミング呼び出しを行う場合、このサービス オブジェクトの同時実行モードが単一に設定され、インスタンス コンテキスト モードが `PerSession` に設定されていると、すべての呼び出しがこのデータグラム チャネルを通過する必要があるため、同時に処理される呼び出しは 1 つに限られることになります。 そのため、1 つ以上のクライアントがタイムアウトとなる可能性があります。 サービス オブジェクトの `InstanceContextMode` を `PerCall` に設定するか、または同時実行モードを複数に設定することで、この問題を回避できます。  
+  
+> [!NOTE]
+>  この場合、利用可能になる "セッション" は 1 つしかないため、MaxConcurrentSessions は効力を失います。  
+  
+## 参照  
+ <xref:System.ServiceModel.OperationContractAttribute.IsInitiating%2A>   
+ <xref:System.ServiceModel.OperationContractAttribute.IsTerminating%2A>
\ No newline at end of file
diff --git a/docs/framework/wcf/using-the-wcf-development-tools.md b/docs/framework/wcf/using-the-wcf-development-tools.md
new file mode 100644
index 00000000000..f4dfd2fad42
--- /dev/null
+++ b/docs/framework/wcf/using-the-wcf-development-tools.md
@@ -0,0 +1,55 @@
+---
+title: "WCF 開発ツールの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 054adb87-c244-4d5a-83d1-0b2b44bd454b
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# WCF 開発ツールの使用
+ここでは、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] サービスの開発に役立つ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 開発ツールについて説明します。  
+  
+ 基盤となる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] テンプレートを使用して独自のサービスをすばやく構築し、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホストと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントを使用してサービスをデバッグおよびテストすることができます。  これらのツールによって、高速でシームレスなデバッグとテストのサイクルが実現し、初期の段階でホスト モデルにコミットする必要がなくなります。  
+  
+## WCF の開発者用ツール  
+ [WCF Visual Studio テンプレート](../../../docs/framework/wcf/wcf-vs-templates.md)  
+  
+ 定義済みの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] プロジェクト テンプレートと項目テンプレートを [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で使用すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスや周辺アプリケーションをすばやく構築できます。  
+  
+ [WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホスト \(WcfSvcHost.exe\) を使用すると、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] デバッガーを起動して \(F5 キーを押します\)、実装しているサービスを自動的にホストおよびテストすることができます。  その後、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアント \(wcfTestClient.exe\) または独自のクライアントを使用してサービスをテストし、潜在的なエラーを見つけて修正できます。  
+  
+ [WCF のテスト用クライアント \(WcfTestClient.exe\)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアント \(WcfTestClient.exe\) は GUI ツールです。このツールを使用すると、任意の型のパラメーターを入力し、その入力をサービスに送信して、サービスから返される応答を表示できます。  このツールを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホストと組み合わせて使用すると、シームレスにサービスをテストできるようになります。  
+  
+ [XML からのデータ型クラスの生成](../../../docs/framework/wcf/generating-data-type-classes-from-xml.md)  
+  
+ クリップボードに格納されている XML データは、コード ページに貼り付けることができます。  データで定義されているクラスは、コード型に変換されます。  
+  
+## 管理特権を必要としないツールの使用  
+ 管理特権のないユーザーが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを開発できるようにするために、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のインストール時には、名前空間 "http:\/\/\+:8731\/Design\_Time\_Addresses" に対してアクセス制御リスト \(ACL: Access Control List\) が作成されます。  この ACL は \(UI\) に設定され、コンピューターにログオンしているすべての対話ユーザーが含まれます。  管理者は、この ACL にユーザーを追加または削除したり、追加のポートを開いたりできます。この ACL によって、既定の構成で、WCF テンプレートまたは WF テンプレートでデータを送受信できるようになります。  また、ユーザーは、管理特権が付与されていなくても、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホスト \(wcfSvcHost.exe\) を使用できるようになります。  
+  
+ システム特権のある管理者アカウントで [!INCLUDE[wv](../../../includes/wv-md.md)] の Netsh.exe ツールを使用すると、アクセスを変更できます。  Netsh.exe の使用例を次に示します。  
+  
+```  
+netsh http add urlacl url=http://+:8001/MyService user=<domain>\<user>  
+```  
+  
+ Netsh.exe [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[Netsh.exe ツールとコマンド ライン スイッチの使用方法](http://go.microsoft.com/fwlink/?LinkId=97877)」を参照してください。  
+  
+## 参照  
+ [WCF Visual Studio テンプレート](../../../docs/framework/wcf/wcf-vs-templates.md)   
+ [WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)   
+ [WCF のテスト用クライアント \(WcfTestClient.exe\)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-and-aspnet-web-api.md b/docs/framework/wcf/wcf-and-aspnet-web-api.md
new file mode 100644
index 00000000000..c8a1f27646a
--- /dev/null
+++ b/docs/framework/wcf/wcf-and-aspnet-web-api.md
@@ -0,0 +1,39 @@
+---
+title: "WCF と ASP.NET Web API | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 08ceded3-fd9a-4467-9715-c4cbd9c7228e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF と ASP.NET Web API
+WCF は、サービス指向のアプリケーションを構築するための Microsoft の統一プログラミング モデルです。これを使用して開発者は、プラットフォーム間を統合し、既存のコンポーネントと相互運用する、セキュリティで保護された信頼性の高いトランザクション型のソリューションを構築できます。[ASP.NET Web API](http://www.asp.net/web-api) は、ブラウザーやモバイル デバイスなど、さまざまなクライアントに提供される HTTP サービスを簡単に構築できるフレームワークです。ASP.NET Web API は、.NET Framework に基づいて RESTful アプリケーションを構築するのに最適なプラットフォームです。このトピックでは、ニーズに最適なテクノロジを決定するのに役立つガイドラインを示します。  
+  
+## 使用するテクノロジの選択  
+ 各テクノロジの主な機能を次の表に示します。  
+  
+|WCF|ASP.NET Web API|  
+|---------|---------------------|  
+|複数のトランスポート プロトコル \(HTTP、TCP、UDP、およびカスタム トランスポート\) をサポートするサービスを構築し、構築したサービスを切り替えることができます。|HTTP のみ。HTTP 用のファーストクラスのプログラミング モデルです。広範囲のアクセスを実現できるさまざまなブラウザーやモバイル デバイスなどからのアクセスにより適しています。|  
+|メッセージの種類が同じ複数のエンコーディング \(テキスト、MTOM、およびバイナリ\) をサポートするサービスを構築し、構築したサービスを切り替えることができます。|XML や JSON などのさまざまなメディアの種類をサポートする Web API を構築できます。|  
+|Reliable Messaging、Transactions、Message Security などの WS\-\* 標準を使用してサービスを構築できます。|HTTP、WebSocket、SSL、JQuery、JSON、XML など、基本的なプロトコルと形式を使用します。Reliable Messaging や Transactions などの高レベルのプロトコルはサポートされません。|  
+|要求\/応答、一方向、および双方向の各メッセージ交換パターンをサポートしています。|HTTP は要求\/応答ですが、[SignalR](https://github.com/SignalR/SignalR) と WebSocket の統合を通じて追加のパターンをサポートできます。|  
+|WCF SOAP サービスは WSDL で記述でき、スキーマが複雑なサービスの場合でも自動化ツールを使用してクライアント プロキシを生成できます。|スニペットを記述する自動生成された HTML ヘルプ ページから OData で統合された API 用に構造化されたメタデータまで、Web API を記述するためのさまざまな方法があります。|  
+|.NET Framework に付属しています。|.NET Framework に付属していますが、オープン ソースであるため、個別のダウンロードとして帯域外でも使用できます。|  
+  
+ WCF を使用すると、さまざまなトランスポートを経由してアクセスできる、信頼性が高くセキュリティで保護された Web サービスを作成できます。ASP.NET Web API を使用すると、さまざまなクライアントからアクセスできる HTTP ベースのサービスを作成できます。ASP.NET Web API は、新しい REST スタイルのサービスを作成および設計する場合に使用します。WCF では REST スタイルのサービスの作成を一部サポートしていますが、ASP.NET Web API の REST のサポートはより詳細で、以降の REST 機能の強化は ASP.NET Web API で行われる予定です。既存の WCF サービスがあり、追加の REST エンドポイントを公開する場合は、WCF および <xref:System.ServiceModel.WebHttpBinding> を使用してください。  
+  
+## 参照  
+ [Windows Communication Foundation とは](../../../docs/framework/wcf/whats-wcf.md)   
+ [Windows Communication Foundation の基本概念](../../../docs/framework/wcf/fundamental-concepts.md)   
+ [WCF and ASP.NET Web API](../../../docs/framework/wcf/wcf-and-aspnet-web-api.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-and-net-framework-client-profile.md b/docs/framework/wcf/wcf-and-net-framework-client-profile.md
new file mode 100644
index 00000000000..92c590920ec
--- /dev/null
+++ b/docs/framework/wcf/wcf-and-net-framework-client-profile.md
@@ -0,0 +1,29 @@
+---
+title: "WCF および .NET Framework のクライアント プロファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9f836a7-68f4-4e7e-a3cc-a1bae5d775d6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# WCF および .NET Framework のクライアント プロファイル
+[!INCLUDE[arrowhead](../../../includes/arrowhead-md.md)] は、完全版の .Net Framework の軽量バージョンで、フレームワーク全体を必要としないクライアント向けに設計されています。  クライアント フレームワークでは、Windows Communication Foundation のすべてがサポートされるわけではありません。  
+  
+## .Net Framework クライアント プロファイルでサポートされる WCF 機能  
+ [!INCLUDE[arrowhead](../../../includes/arrowhead-md.md)] でサポートされる Windows Communication Foundation の機能は次のとおりです。  
+  
+-   Cardspace と Web ホスティングを除くすべての WCF がサポートされます。  
+  
+-   TCP\/IP チャネルのリモート処理がサポートされます。  
+  
+-   Asmx \(Web サービス\) はサポートされません。
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-client-overview.md b/docs/framework/wcf/wcf-client-overview.md
new file mode 100644
index 00000000000..008fe52627b
--- /dev/null
+++ b/docs/framework/wcf/wcf-client-overview.md
@@ -0,0 +1,180 @@
+---
+title: "WCF クライアントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クライアント [WCF], アーキテクチャ"
+ms.assetid: f60d9bc5-8ade-4471-8ecf-5a07a936c82d
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# WCF クライアントの概要
+このセクションでは、クライアント アプリケーションの処理、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] クライアントの構成方法、作成方法、使用方法、およびクライアント アプリケーションをセキュリティで保護する方法について説明します。  
+  
+## <a name="using-wcf-client-objects"></a>WCF クライアント オブジェクトの使用  
+ クライアント アプリケーションは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを使用して別のアプリケーションと通信するマネージ アプリケーションです。 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスのクライアント アプリケーションを作成するには、次の手順に従います。  
+  
+1.  サービス エンドポイントのサービス コントラクト、バインディング、およびアドレス情報を取得します。  
+  
+2.  その情報を使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを作成します。  
+  
+3.  操作を呼び出します。  
+  
+4.  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを閉じます。  
+  
+ この後の各セクションでは、これらの手順について詳しく説明します。また、次の内容についても簡単に説明します。  
+  
+-   エラー処理  
+  
+-   クライアントの構成とセキュリティ保護  
+  
+-   双方向サービスのコールバック オブジェクトの作成  
+  
+-   サービスの非同期呼び出し  
+  
+-   クライアント チャネルを使用したサービスの呼び出し  
+  
+## <a name="obtain-the-service-contract-bindings-and-addresses"></a>サービス コントラクト、バインディング、およびアドレスを取得する  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、サービスとクライアントは、マネージ属性、マネージ インターフェイス、およびマネージ メソッドを使用してコントラクトをモデル化します。 クライアント アプリケーションからサービスに接続するには、そのサービス コントラクトの型情報を取得する必要があります。 通常、これを行うを使用して、 [ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe)](../../../docs/framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md)、サービスからメタデータをダウンロード、変換のファイルは、任意の言語でマネージ ソース コードに、クライアント アプリケーションの構成ファイルを作成し、構成する使用することができます、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]クライアント オブジェクトです。 たとえば、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を呼び出す `MyCalculatorService` クライアント オブジェクトを作成するときに、そのサービスのメタデータが `http://computerName/MyCalculatorService/Service.svc?wsdl` で公開されていることがわかっている場合に、Svcutil.exe を使用してマネージ コードにサービス コントラクトが含まれている `ClientCode.vb` ファイルを取得するコード例を次に示します。  
+  
+```  
+svcutil /language:vb /out:ClientCode.vb /config:app.config http://computerName/MyCalculatorService/Service.svc?wsdl  
+```  
+  
+ このコントラクト コードをクライアント アプリケーションまたは別のアセンブリにコンパイルし、クライアント アプリケーションでそれを使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを作成できます。 構成ファイルを使用してサービスに正しく接続するクライアント オブジェクトを構成できます。  
+  
+ このプロセスの例は、次を参照してください。[方法: クライアントを作成する](../../../docs/framework/wcf/how-to-create-a-wcf-client.md)です。 コントラクトの詳細については、次を参照してください。[コントラクト](../../../docs/framework/wcf/feature-details/contracts.md)します。  
+  
+## <a name="create-a-wcf-client-object"></a>WCF クライアント オブジェクトを作成する  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントとは、クライアントがリモート サービスとの通信に使用できる形式で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを表すローカル オブジェクトです。 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント型は、ターゲットのサービス コントラクトを実装します。そのため、サービス コントラクトを作成して構成すると、クライアント オブジェクトを直接使用して、サービス操作を呼び出すことができます。 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]ランタイムは、メソッド呼び出しをメッセージに、サービスに送信、応答をリッスンおよびそれらの値を返します変換、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]戻り値としてクライアント オブジェクトまたは`out`または`ref`パラメーター。  
+  
+ また、サービスとの通信やサービスの使用に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント チャネル オブジェクトも使用できます。 詳細については、「 [WCF クライアント アーキテクチャ](../../../docs/framework/wcf/feature-details/client-architecture.md)します。  
+  
+#### <a name="creating-a-new-wcf-object"></a>新しい WCF オブジェクトの作成  
+ 使用方法を示す、 <xref:System.ServiceModel.ClientBase%601>クラス、サービス アプリケーションから次の単純なサービス コントラクトが生成されていると仮定します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントを作成する場合、サービス参照をプロジェクトに追加すると、オブジェクトはオブジェクト ブラウザーに自動的に読み込まれます。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#12](../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#12)]  
+  
+ 使用していない場合[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)]、拡張する型を検索する生成されるコントラクト コードを調べる<xref:System.ServiceModel.ClientBase%601>とサービス コントラクト インターフェイス`ISampleService`します。 この場合、この型は次のようなコードになります。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#14](../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#14)]  
+  
+ このクラスを、コンストラクターの&1; つを使用してローカル オブジェクトとして作成し、構成して、型 `ISampleService` のサービスへの接続に使用できます。  
+  
+ まず [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを作成し、それを&1; つの try/catch ブロック内で使用して閉じることをお勧めします。 特定のエラー モードで例外をマスクする場合があるため、`using` ステートメント (`Using` では [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]) を使用しないでください。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]以降のセクションでも、[を使用してステートメントを使用して問題を回避する](../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)です。  
+  
+### <a name="contracts-bindings-and-addresses"></a>コントラクト、バインディング、およびアドレス  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを作成するには、クライアント オブジェクトを構成する必要があります。 具体的には、サービスが必要*エンドポイント*を使用します。 エンドポイントは、サービス コントラクト、バインディング、およびアドレスの組み合わせです  ([!INCLUDE[crabout](../../../includes/crabout-md.md)]エンドポイントは、[エンドポイント: アドレス、バインディング、およびコントラクト](../../../docs/framework/wcf/feature-details/endpoints-addresses-bindings-and-contracts.md))。通常、この情報に記載されて、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/wcf/endpoint-of-client.md) Svcutil.exe ツールによって生成されると、クライアント オブジェクトを作成するときに自動的に読み込まれますのものなど、クライアントのアプリケーション構成ファイル内の要素。 両方の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント型には、この情報をプログラムで指定できるオーバーロードもあります。  
+  
+ たとえば、上記の例で使用した `ISampleService` 用に生成された構成ファイルには、次のエンドポイント情報が含まれます。  
+  
+ [!code[C_GeneratedCodeFiles#19](../../../samples/snippets/common/VS_Snippets_CFX/c_generatedcodefiles/common/client.exe.config#19)]  
+  
+ この構成ファイルの `<client>` 要素には、ターゲット エンドポイントが指定されます。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]複数のターゲット エンドポイントを使用して表示、 <xref:System.ServiceModel.ClientBase%601.%23ctor%2A?displayProperty=fullName>または<xref:System.ServiceModel.ChannelFactory%601.%23ctor%2A?displayProperty=fullName>コンス トラクターです。  
+  
+## <a name="calling-operations"></a>操作の呼び出し  
+ クライアント オブジェクトを作成し構成したら、try/catch ブロックを作成し、ローカルのオブジェクトの場合と同じ方法で操作を呼び出して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを閉じます。 クライアント アプリケーションが最初の操作を呼び出すときに、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、基になるチャネルを自動的に開きます。基になるチャネルはオブジェクトが再利用されるときに閉じられます  (また、他の操作を呼び出す前後にチャネルを明示的に開いたり閉じたりすることもできます)。  
+  
+ たとえば、次のようなサービス コントラクトを使用する場合があります。  
+  
+```csharp  
+namespace Microsoft.ServiceModel.Samples  
+{  
+    using System;  
+    using System.ServiceModel;  
+  
+    [ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]  
+    public interface ICalculator  
+   {  
+        [OperationContract]  
+        double Add(double n1, double n2);  
+        [OperationContract]  
+        double Subtract(double n1, double n2);  
+        [OperationContract]  
+        double Multiply(double n1, double n2);  
+        [OperationContract]  
+        double Divide(double n1, double n2);  
+    }  
+}  
+```  
+  
+```vb  
+Namespace Microsoft.ServiceModel.Samples  
+  
+    Imports System  
+    Imports System.ServiceModel  
+  
+    <ServiceContract(Namespace:= _  
+    "http://Microsoft.ServiceModel.Samples")> _   
+   Public Interface ICalculator  
+        <OperationContract> _   
+        Function Add(n1 As Double, n2 As Double) As Double  
+        <OperationContract> _   
+        Function Subtract(n1 As Double, n2 As Double) As Double  
+        <OperationContract> _   
+        Function Multiply(n1 As Double, n2 As Double) As Double  
+        <OperationContract> _   
+     Function Divide(n1 As Double, n2 As Double) As Double  
+End Interface  
+```  
+  
+ 次のコード例で示すように、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトを作成し、そのメソッドを呼び出すことで操作を呼び出すことができます。 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント オブジェクトのオープン、呼び出し、クローズは、1 つの try/catch ブロック内で行われます。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF クライアントを使用してサービスにアクセスする](../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)と[Using ステートメントに関する問題を回避する](../../../docs/framework/wcf/samples/avoiding-problems-with-the-using-statement.md)です。  
+  
+ [!code-csharp[C_GeneratedCodeFiles#20](../../../samples/snippets/csharp/VS_Snippets_CFX/c_generatedcodefiles/cs/proxycode.cs#20)]  
+  
+## <a name="handling-errors"></a>エラー処理  
+ 基になるクライアント チャネルを開いたとき (明示的に開いた場合、または操作を呼び出すことによって自動的に開いた場合)、クライアントまたはチャネル オブジェクトを使用して操作を呼び出したとき、基になるクライアント チャネルを閉じたときときに、クライアント アプリケーションで例外が発生する可能性があります。 お勧め最低限のアプリケーションが可能な限りの処理を想定している<xref:System.TimeoutException?displayProperty=fullName>と<xref:System.ServiceModel.CommunicationException?displayProperty=fullName>他にも、例外<xref:System.ServiceModel.FaultException?displayProperty=fullName>操作によって返される SOAP エラーの結果としてスローされるオブジェクト。 としてクライアント アプリケーションに、操作コントラクトで指定された SOAP エラーが発生した、 <xref:System.ServiceModel.FaultException%601?displayProperty=fullName>型パラメーターが SOAP エラーの詳細型であります。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]クライアント アプリケーションでのエラー状況を処理するを参照してください[送信と受信エラー](../../../docs/framework/wcf/sending-and-receiving-faults.md)します。 完全なサンプルに示すクライアントでのエラーを処理する方法を参照してください[予想例外](../../../docs/framework/wcf/samples/expected-exceptions.md)します。  
+  
+## <a name="configuring-and-securing-clients"></a>クライアントの構成とセキュリティ保護  
+ クライアントを構成するには、まず、そのクライアントまたはチャネル オブジェクトに必要なターゲット エンドポイント情報を読み込みます。通常は構成ファイルから読み込みますが、クライアント コンストラクターとプロパティを使用してプログラムで読み込むこともできます。 ただし、特定のクライアントの動作を有効にし、多くのセキュリティ シナリオに対応するには、追加の構成手順が必要です。  
+  
+ たとえば、サービス コントラクトのセキュリティ要件はサービス コントラクト インターフェイスに宣言します。Svcutil.exe で構成ファイルを作成した場合、通常そのファイルにはサービスのセキュリティ要件に対応できるバインディングが含まれています。 ただし、クライアント資格情報の構成など、さらに多くのセキュリティ構成が必要な場合もあります。 詳細については、セキュリティ構成の[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]クライアントを参照してください[クライアントのセキュリティで保護する](../../../docs/framework/wcf/securing-clients.md)です。  
+  
+ また、カスタム ランタイム動作など、クライアント アプリケーションでいくつかのカスタム変更を有効にすることもできます。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]カスタム クライアント動作を構成する方法[クライアントの動作の構成](../../../docs/framework/wcf/configuring-client-behaviors.md)します。  
+  
+## <a name="creating-callback-objects-for-duplex-services"></a>双方向サービスのコールバック オブジェクトの作成  
+ 双方向サービスには、コントラクトの要件に従って呼び出すサービスのコールバック オブジェクトを提供するために、クライアント アプリケーションが実装する必要のあるコールバック コントラクトを指定します。 コールバック オブジェクトは完全なサービスではありません (たとえば、コールバック オブジェクトを使用してチャネルを初期化できません) が、実装と構成という目的においては、一種のサービスとして考えることができます。  
+  
+ 双方向サービスのクライアントでは、以下の処理を行う必要があります。  
+  
+-   コールバック コントラクト クラスを実装します。  
+  
+-   コールバック コントラクト実装クラスのインスタンスを作成し、使用して作成する、 <xref:System.ServiceModel.InstanceContext?displayProperty=fullName>に渡されたオブジェクト、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)]クライアント コンス トラクターです。  
+  
+-   操作を呼び出し、操作のコールバックを処理します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の双方向クライアント オブジェクトは、対応する非双方向クライアント オブジェクトと同じように機能します。ただし、双方向クライアント オブジェクトは、コールバック サービスの構成など、コールバックのサポートに必要な機能を公開します。  
+  
+ たとえば、コールバック オブジェクトのランタイム動作のさまざまな側面を制御のプロパティを使用して、 <xref:System.ServiceModel.CallbackBehaviorAttribute?displayProperty=fullName>コールバック クラスの属性です。 別の例は、の使用、 <xref:System.ServiceModel.Description.CallbackDebugBehavior?displayProperty=fullName>コールバック オブジェクトを呼び出したサービスに例外情報を返すようにするクラス。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][双方向サービス](../../../docs/framework/wcf/feature-details/duplex-services.md)します。 完全なサンプルを参照してください。[双方向](../../../docs/framework/wcf/samples/duplex.md)します。  
+  
+ クライアントのベース アドレスを使用して、Windows XP コンピューターのインターネット インフォメーション サービス (IIS) 5.1 を実行している場合に双方向クライアントが指定する必要があります、 <xref:System.ServiceModel.WSDualHttpBinding?displayProperty=fullName>クラス、または例外がスローされます。 次のコード例は、コードでこれを指定する方法を示します。  
+  
+ [!code-csharp[S_DualHttp#8](../../../samples/snippets/csharp/VS_Snippets_CFX/s_dualhttp/cs/program.cs#8)]
+ [!code-vb[S_DualHttp#8](../../../samples/snippets/visualbasic/VS_Snippets_CFX/s_dualhttp/vb/module1.vb#8)]  
+  
+ 次のコードは、構成ファイルでこれを指定する方法を示します。  
+  
+ [!code-csharp[S_DualHttp#134](../../../samples/snippets/csharp/VS_Snippets_CFX/s_dualhttp/cs/program.cs#134)]  
+  
+## <a name="calling-services-asynchronously"></a>サービスの非同期呼び出し  
+ 操作の呼び出し方法は、クライアント開発者に完全に依存します。 これは、操作を構成するメッセージは、マネージ コードで表現するときに同期メソッドまたは非同期メソッドのどちらかにマップできるためです。 したがって、操作を非同期に呼び出すクライアントを作成する場合、Svcutil.exe の `/async` オプションを使用して非同期クライアント コードを生成できます。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][方法: サービス操作を非同期的に呼び出す](../../../docs/framework/wcf/feature-details/how-to-call-wcf-service-operations-asynchronously.md)します。  
+  
+## <a name="calling-services-using-wcf-client-channels"></a>WCF クライアント チャネルを使用したサービスの呼び出し  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]クライアント型を拡張する<xref:System.ServiceModel.ClientBase%601>から派生した<xref:System.ServiceModel.IClientChannel?displayProperty=fullName>基になるチャネル システムを公開するインターフェイスです。 サービスを起動するには、ターゲット サービス コントラクトを使用して、 <xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName>クラスです。 詳細については、「 [WCF クライアント アーキテクチャ](../../../docs/framework/wcf/feature-details/client-architecture.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ServiceModel.ClientBase%601?displayProperty=fullName>   
+ <xref:System.ServiceModel.ChannelFactory%601?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-error-handling.md b/docs/framework/wcf/wcf-error-handling.md
new file mode 100644
index 00000000000..80cf4a88ed5
--- /dev/null
+++ b/docs/framework/wcf/wcf-error-handling.md
@@ -0,0 +1,57 @@
+---
+title: "WCF エラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e4b1e0f-9598-449d-9d73-90bda62305b8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# WCF エラー処理
+WCF アプリケーションで発生したエラーは次の 3 つのグループのいずれかに属します。  
+  
+1.  通信エラー  
+  
+2.  プロキシ\/チャネル エラー  
+  
+3.  アプリケーション エラー  
+  
+ 通信エラーは、ネットワークが利用できない場合、クライアントが無効なアドレスを使用している場合、またはサービス ホストが受信メッセージをリッスンしていない場合に発生します。この種類のエラーは、クライアントに <xref:System.ServiceModel.CommunicationException> または <xref:System.ServiceModel.CommunicationException> 派生クラスとして返されます。  
+  
+ プロキシ\/チャネル エラーは、チャネルまたはプロキシ自体に発生するエラーです。この種類のエラーには、閉じられているプロキシまたはチャネルを使用しようとした、クライアントとサービス間にコントラクトの不一致が存在する、またはクライアントの資格情報がサービスによって拒否されたなどがあります。このカテゴリには、ここに一覧を示せないほど多くのさまざまなエラーの種類があります。この種類のエラーは、クライアントにそのままの状態で返されます \(例外オブジェクトに対して変換は実行されません\)。  
+  
+ アプリケーション エラーは、サービス操作の実行中に発生します。この種類のエラーは、クライアントに <xref:System.ServiceModel.FaultException> または <xref:System.ServiceModel.FaultException%601> として送信されます。  
+  
+ WCF でのエラー処理は、次の 1 つ以上によって実行されます。  
+  
+-   スローされた例外の直接処理。これは、通信エラーとプロキシ\/チャネル エラーに対してのみ行われます。  
+  
+-   エラー コントラクトの使用  
+  
+-   <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスの実装  
+  
+-   <xref:System.ServiceModel.ServiceHost> イベントの処理  
+  
+## エラー コントラクト  
+ エラー コントラクトでは、プラットフォームに依存しない方法で、サービス操作中に発生する可能性のあるエラーを定義できます。既定では、サービス操作内からスローされたすべての例外はクライアントに <xref:System.ServiceModel.FaultException> オブジェクトとして返されます。<xref:System.ServiceModel.FaultException> オブジェクトには、情報がほとんど含まれません。エラー コントラクトを定義し、エラーを <xref:System.ServiceModel.FaultException%601> として返すことにより、クライアントに送信される情報を制御できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md).  
+  
+## IErrorHandler  
+ <xref:System.ServiceModel.Dispatcher.IErrorHandler> インターフェイスでは、WCF アプリケーションがエラーに応答する方法を詳細に制御できます。クライアントに返されるエラー メッセージを完全に制御し、ログ記録などのカスタム エラー処理を実行できるようにします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Dispatcher.IErrorHandler> および[エラー処理およびレポートに対する制御の拡張](../../../docs/framework/wcf/samples/extending-control-over-error-handling-and-reporting.md)  
+  
+## ServiceHost イベント  
+ <xref:System.ServiceModel.ServiceHost> クラスはサービスをホストし、エラー処理に必要になる可能性のあるいくつかのイベントを定義します。次に例を示します。  
+  
+1.  <xref:System.ServiceModel.ServiceHost.Faulted>  
+  
+2.  <xref:System.ServiceModel.ServiceHost.UnknownMessageReceived>  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] <xref:System.ServiceModel.ServiceHost>
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md b/docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md
new file mode 100644
index 00000000000..9d19b9b1024
--- /dev/null
+++ b/docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md
@@ -0,0 +1,121 @@
+---
+title: "WCF サービス ホスト (WcfSvcHost.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8643a63d-a357-4c39-bd6c-cdfdf71e370e
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# WCF サービス ホスト (WcfSvcHost.exe)
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス ホスト \(WcfSvcHost.exe\) を使用すると、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] デバッガーを起動して \(F5 キーを押します\)、実装しているサービスを自動的にホストおよびテストすることができます。その後、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアント \(WcfTestClient.exe\) または独自のクライアントを使用してサービスをテストし、潜在的なエラーを見つけて修正できます。  
+  
+## WCF サービス ホスト  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス プロジェクト内のサービスを列挙し、プロジェクトの構成を読み込んで、検出された各サービスのためのホストをインスタンス化します。このツールは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス テンプレートによって [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] に統合され、プロジェクトのデバッグを開始すると呼び出されます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストを使用すると、追加のコードを記述したり、開発時に特定のホストにしばられたりすることなく、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス \([!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクト内の WCF サービス\) をホストできます。  
+  
+> [!NOTE]
+>  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストは、部分信頼をサポートしません。部分信頼において [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用する場合は、サービスをビルドするために [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] にある [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクト テンプレートを使用しないでください。代わりに、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 部分信頼がサポートされている Web サーバーでサービスをホストできる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス Web サイト テンプレートを選択して、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] に新しい Web サイトを作成します。  
+  
+## WCF サービス ホストでホストされるプロジェクトの種類  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストでホストできる [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ プロジェクトの種類は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ、シーケンシャル ワークフロー サービス ライブラリ、ステート マシン ワークフロー サービス ライブラリ、および配信サービス ライブラリです。その他に、**\[項目の追加\]** 機能を使用してサービス ライブラリ プロジェクトに追加できるサービスをホストすることもできます。これには、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス、WF ステート マシン サービス、WF シーケンシャル サービス、XAML WF ステート マシン サービス、および XAML WF シーケンシャル サービスが含まれます。  
+  
+ ただし、このツールでホストを構成することはできません。ホストを構成するには、App.config ファイルを手動で編集する必要があります。また、このツールでユーザー定義の構成ファイルを検証することはできません。  
+  
+> [!CAUTION]
+>  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストを使用して運用環境のサービスをホストしないでください。このツールはそのような目的で作られていないため、そうした環境で要求される信頼性、セキュリティ、および管理性をサポートしていません。代わりに IIS を使用してください。IIS は、より高度な信頼性機能や監視機能を備えており、サービスをホストするのに適しています。サービスの開発が完了したら、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストから IIS にサービスを移行してください。  
+  
+## Visual Studio 内で WCF サービス ホストを使用するシナリオ  
+ 次の表は、**\[コマンド ライン引数\]** ダイアログ ボックスのすべてのパラメーターの一覧です。このダイアログ ボックスを表示するには、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[プロパティ\]** をクリックします。次に、**\[デバッグ\]** タブをクリックし、**\[スタート プロジェクト\]** をクリックします。これらのパラメーターは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストを構成する際に役立ちます。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|`/client`|サービスのホストが開始された後に実行する実行可能ファイルへのパスを指定するオプション パラメーターです。これにより、ホストが開始された後に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントが起動します。|  
+|`/clientArg`|カスタム クライアント アプリケーションに渡す引数として文字列を指定します。|  
+|`/?`|ヘルプ テキストを表示します。|  
+  
+#### WCF のテスト用クライアントの使用  
+ 新しい [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス プロジェクトを作成し、F5 キーを押してデバッガーを起動すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストが、プロジェクトで検出されたすべてのサービスのホストを開始します。その後、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントが自動的に開き、構成ファイルに定義されているサービス エンドポイントの一覧が表示されます。メイン ウィンドウでパラメーターをテストしたり、サービスを呼び出したりできます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントが使用されていることを確認するには、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[デバッグ\]** タブをクリックします。**\[スタート プロジェクト\]** をクリックして、**\[コマンド ライン引数\]** ダイアログ ボックスに次のように表示されていることを確認します。  
+  
+ `/client:WcfTestClient.exe`  
+  
+#### カスタム クライアントの使用  
+ カスタム クライアントを使用するには、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[デバッグ\]** タブをクリックします。**\[スタート プロジェクト\]** をクリックし、**\[コマンド ライン引数\]** ダイアログ ボックスで `/client` パラメーターを編集して、使用するカスタム クライアントを指定します。以下に例を示します。  
+  
+ `/client:"path/CustomClient.exe"`  
+  
+ F5 キーを押して再びサービスを開始し、デバッガーを起動すると、指定したカスタム クライアントが自動的に起動します。  
+  
+ `/clientArg:` パラメーターを使用して、カスタム クライアント アプリケーションに渡す引数として文字列を指定することもできます。以下に例を示します。  
+  
+ `/client:"path/CustomClient.exe" /clientArg:"arguments that are passed to Client"`  
+  
+ たとえば、配信サービス ライブラリ テンプレートを使用している場合は、次のコマンド ライン引数を使用できます。  
+  
+ `/client:iexplore.exe /clientArgs:http://localhost:8731/Design_Time_Addresses/Feed1/`  
+  
+#### クライアントを指定しない場合  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストがサービスのホストを開始した後にクライアントを使用しないように指定するには、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[デバッグ\]** タブをクリックします。**\[スタート プロジェクト\]** をクリックし、**\[コマンド ライン引数\]** ダイアログ ボックスを空白のままにします。  
+  
+#### カスタム ホストの使用  
+ カスタム ホストを使用するには、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[プロパティ\]** をクリックして、**\[デバッグ\]** タブをクリックします。**\[外部プログラムの開始\]** をクリックし、カスタム ホストへの完全パスを入力します。**\[コマンド ライン引数\]** ダイアログ ボックスを使用して、そのホストに渡す引数を指定することもできます。  
+  
+## WCF サービス ホストのユーザー インターフェイス  
+ 最初に \([!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] 内で F5 キーを押して\) [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストを呼び出したときには、**\[WCF サービス ホスト\]** ウィンドウが自動的に開きます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストが実行されている場合は、通知領域にプログラムのアイコンが表示されます。このアイコンをダブルクリックすると、**\[WCF サービス ホスト\]** ウィンドウが開きます。  
+  
+ サービスのホスト中にエラーが発生すると、\[[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホスト\] ダイアログ ボックスが開いて関連情報が表示されます。  
+  
+ メインの **\[WCF サービス ホスト\]** ウィンドウには、次の 2 つのメニューがあります。  
+  
+-   **\[ファイル\]**: **\[閉じる\]** コマンドと **\[終了\]** コマンドが含まれています。**\[閉じる\]** をクリックすると、**\[WCF サービス ホスト\]** ダイアログ ボックスが閉じますが、サービスは引き続きホストされます。**\[終了\]** をクリックすると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストがシャットダウンして、ホストされているサービスもすべて停止します。  
+  
+-   **\[ヘルプ\]**: バージョン情報を表示する **\[バージョン情報\]** コマンドと、ヘルプ ファイルを開く **\[ヘルプ\]** コマンドが含まれています。  
+  
+ メインの **\[WCF サービス ホスト\]** ウィンドウには、次の 2 つの領域があります。  
+  
+-   1 つ目の領域は、**\[サービス\]** です。この領域には、すべてのサービスの基本情報が一覧表示されます。具体的には、次の情報が含まれています。  
+  
+    -   **\[サービス\]**: すべてのサービスが表示されます。  
+  
+    -   **\[状態\]**: サービスの状態が表示されます。有効な値は "開始"、"停止"、および "エラー" です。  
+  
+    -   **\[メタデータ アドレス\]**: サービスのメタデータ アドレスが表示されます。  
+  
+-   2 つ目の領域は、**\[追加情報\]** です。**\[サービス\]** 領域で特定のサービスの行を選択すると、ここにサービスの状態の詳細な説明が表示されます。状態が "エラー" の場合は、完全なエラー メッセージを画面上で確認できます。  
+  
+## WCF サービス ホストの停止  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストは、次の 4 つの方法でシャットダウンできます。  
+  
+-   [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のデバッグ セッションを停止します。  
+  
+-   **\[WCF サービス ホスト\]** ウィンドウで、**\[ファイル\]** メニューの **\[終了\]** をクリックします。  
+  
+-   通知領域の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストのトレイ アイコンを右クリックし、**\[終了\]** をクリックします。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントを使用している場合は、それを終了します。  
+  
+## 管理特権を必要としないサービス ホストの使用  
+ 管理特権のないユーザーが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを開発できるようにするために、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のインストール時には、名前空間 "http:\/\/\+:8731\/Design\_Time\_Addresses" に対してアクセス制御リスト \(ACL: Access Control List\) が作成されます。この ACL は \(UI\) に設定され、コンピューターにログオンしているすべての対話ユーザーが含まれます。管理者は、この ACL にユーザーを追加または削除したり、追加のポートを開いたりできます。この ACL によって、管理特権が与えられていないユーザーでも、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホスト \(wcfSvcHost.exe\) を使用できるようになります。  
+  
+ システム特権のある管理者アカウントで [!INCLUDE[wv](../../../includes/wv-md.md)] の netsh.exe ツールを使用すると、アクセスを変更できます。netsh.exe の使用例を次に示します。  
+  
+```  
+netsh http add urlacl url=http://+:8001/MyService user=<domain>\<user>  
+```  
+  
+ netsh.exe の詳細については、「[Netsh.exe ツールとコマンド ライン スイッチの使用方法](http://go.microsoft.com/fwlink/?LinkId=97877)」を参照してください。  
+  
+## 参照  
+ [WCF のテスト用クライアント \(WcfTestClient.exe\)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-service-publishing.md b/docs/framework/wcf/wcf-service-publishing.md
new file mode 100644
index 00000000000..90709188a2a
--- /dev/null
+++ b/docs/framework/wcf/wcf-service-publishing.md
@@ -0,0 +1,89 @@
+---
+title: "WCF サービス発行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c806b253-cd47-4b96-b831-e73cbf08808f
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# WCF サービス発行
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス発行は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントで構成される初期の開発環境から、テストの目的でアプリケーションを実際に実稼働環境に配置する場合に役立ちます。  最終的な配置計画を確定する前に、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス発行を使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスが正しく動作し、発行の準備ができていることを確認できます。  また、テスト用のさまざまなターゲットの場所に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリを配置することもできます。  
+  
+## サポートされているサービスとターゲットの場所  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス発行は、一連の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ テンプレートと、それらに対応する項目テンプレートから作成された、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの発行をサポートしています。これには以下が含まれます。  
+  
+-   [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリ テンプレートと項目テンプレート  
+  
+-   シーケンシャル ワークフロー サービス ライブラリ テンプレートと項目テンプレート  
+  
+-   ステート マシン ワークフロー サービス ライブラリ テンプレートと項目テンプレート  
+  
+-   配信サービス ライブラリ  
+  
+ これらのサービス テンプレートを見つけるには、**\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックし、**\[Visual Basic\]** または **\[Visual C\#\]** を展開して、**\[WCF\]** をクリックします。  
+  
+ サービスは、次のターゲットの場所に発行できます。  
+  
+-   ローカル IIS  
+  
+-   ファイル システム  
+  
+-   FTP サイト  
+  
+-   リモート サイト  
+  
+## WCF サービス発行の使用  
+ サービス実装を配置するには、次の手順を実行します。  
+  
+1.  昇格された特権で Visual Studio を開きます \(実行可能ファイルを右クリックし、\[管理者として実行\] を使用して起動します\)。  IIS 7.0 以降を使用している場合は、コントロール パネルの \[Windows の機能の有効化または無効化\] を使用して、\[IIS メタベースおよび IIS6 構成との互換性\] コンポーネントがインストールされていることを確認します。  
+  
+2.  サービス プロジェクトを開き、メイン メニューから **\[ビルド\]**、**\[\<Project Name\> の発行\]** と選択するか、**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[発行\]** をクリックします。  
+  
+3.  **\[発行\]** ウィンドウが表示されます。  **\[...\]** ボタンをクリックして、  サービスの配置先にするターゲットの場所を指定します。  アプリケーションの配置先には、ローカル IIS、ファイル システム、FTP サイト、またはリモート サイトを指定できます。  ローカルの IIS にアプリケーションを配置する場合、使用している Web サイトを選択し、右上の **\[新しい Web アプリケーションの作成\]** アイコンをクリックして、その Web サイトの下に Web アプリケーションを作成できます。  
+  
+4.  メイン ウィンドウの **\[発行\]** をクリックすると、指定したターゲットの場所にアプリケーションが配置され、Web.config ファイル、.svc ファイル、およびアセンブリ ファイルがターゲット ディレクトリにコピーされます。  .  .svc ファイルの名前は、"ProjectName.ServiceName.svc" になります。  サービスが正常に発行されると、Visual Studio の \[出力\] ウィンドウに、\[http:\/\/localhost\/WebApplicationFolderName に接続しています\] などのホットリンクが表示されます。  Ctrl キーを押しながらリンクをクリックすると、Visual Studio の内側にブラウザー ページが開き、サービス ディレクトリ構造が表示されます。  
+  
+     サイトを参照できない場合、IIS でディレクトリ ブラウザーが有効になっていない可能性があります。  \[対処方法\] のセクションのヒントに従って有効にしてください。  代わりに、「http:\/\/localhost\/WebApplicationFolderName\/ProjectName.ServiceName.svc」と直接入力してサービス ページを表示することもできます。  
+  
+ **\[発行\]** を使用すると、プロジェクトで定義されているすべてのサービスのアセンブリ、構成、および .svc ファイルをターゲットの場所にコピーするかどうかを指定したり、コピー先にある既存のファイルを上書きするかどうかを指定したりできます。  
+  
+ ローカルの IIS にアプリケーションを配置すると、IIS セットアップに関連するエラーが発生することがあります。  IIS が正しくインストールされていることを確認してください。  ブラウザーに「http:\/\/localhost」と入力し、IIS の既定のページが表示されるかどうかを確認します。  ASP.NET または [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] が IIS に適切に登録されていないために問題が発生する場合もあります。  Visual Studio コマンド プロンプトを開き、"aspnet\_regiis.exe \-ir" コマンドを実行して ASP.NET 登録に関する問題を解決したり、"ServiceModelReg.exe –ia" コマンドを実行して WCF の登録に関する問題を解決することができます。  
+  
+## 発行用に生成されるファイル  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリを Web でホストできるようになる前に、アセンブリ ファイル、Web.config ファイル、および .svc ファイルがツールによって生成されます。  生成されたファイルは、すべてターゲットの場所にコピーされます。  その後でサービスが発行されます。  
+  
+### アセンブリ ファイル  
+ このツールを使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを発行すると、まずサービスが自動的にビルドされ、サービス プロジェクトでアセンブリ ファイルが生成されます。  
+  
+### .SVC ファイル  
+ 発行操作を行うと、\*.svc ファイルが存在するかどうかにかかわらず、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスごとに \*.svc ファイルが生成され、バージョンの有効性が確認されます。  svc ファイルには、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリおよび配信サービス ライブラリ用と、シーケンシャル ワークフロー サービス ライブラリおよびステート マシン ワークフロー サービス ライブラリ用の 2 種類があります。  生成された \*.svc ファイルは、ターゲットの場所のルート フォルダーにコピーされます。  
+  
+### Web.config ファイル  
+ サービス プロジェクトが特定のターゲットの場所に発行されるたびに、Web.config ファイルが作成されます。  
+  
+ 生成された Web.config ファイルには、Web ホストに役立つ Web セクションと、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ライブラリの App.config の内容に次の変更を加えたものが含まれています。  
+  
+-   ベース アドレスが除外されています。  
+  
+-   ターゲット プラットフォームのトレース設定を保持するために、`<diagnostics>` 要素の設定が除外されています。  
+  
+## IIS への非 HTTP バインドを使用した WCF サービスの公開  
+ IIS7.0 以降を使用している場合、非 HTTP バインドを使用した [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを IIS に公開することができます。  事前の構成を行う必要があります。  詳細については、「[Windows プロセス アクティブ化サービスでのホスティング](../../../docs/framework/wcf/feature-details/hosting-in-windows-process-activation-service.md)」のトピックを参照してください。  
+  
+## セキュリティ  
+ IIS は管理者アカウントで実行する必要があるため、ローカル IIS に発行するには、管理特権が必要です。  管理特権のないユーザーが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス発行を開いた場合、IIS はターゲットの場所として使用できません。  ファイル システム、FTP サイト、またはリモート サイトへの発行は、管理特権がなくても行うことができます。  
+  
+## 参照  
+ [WCF Visual Studio テンプレート](../../../docs/framework/wcf/wcf-vs-templates.md)   
+ [WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)   
+ [WCF のテスト用クライアント \(WcfTestClient.exe\)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-simplification-features.md b/docs/framework/wcf/wcf-simplification-features.md
new file mode 100644
index 00000000000..f74bea76448
--- /dev/null
+++ b/docs/framework/wcf/wcf-simplification-features.md
@@ -0,0 +1,139 @@
+---
+title: "WCF の単純化機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4535a511-6064-4da0-b361-80262a891663
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WCF の単純化機能
+ここでは、WCF アプリケーションの作成を容易にする新機能について説明します。  
+  
+## 生成された構成ファイルの簡略化  
+ Visual Studio でサービス参照を追加したり、SvcUtil.exe ツールを使用したりすると、クライアント構成ファイルが生成されます。以前のバージョンの WCF では、このような構成ファイルには、各バインド プロパティの値が既定値であっても、その値が含まれていました。WCF 4.5 では、生成された構成ファイルには、既定値以外の値に設定されているバインド プロパティのみが含まれます。  
+  
+ WCF 3.0 で生成された構成ファイルの例を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+            <basicHttpBinding>  
+                <binding name="BasicHttpBinding_IService1" closeTimeout="00:01:00"  
+                    openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"  
+                    allowCookies="false" bypassProxyOnLocal="false"   
+                    hostNameComparisonMode="StrongWildcard" maxBufferSize="65536"   
+                    maxBufferPoolSize="524288" maxReceivedMessageSize="65536"  
+                    messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered"  
+                    useDefaultWebProxy="true">  
+                    <readerQuotas maxDepth="32" maxStringContentLength="8192"   
+                        maxArrayLength="16384" maxBytesPerRead="4096"  
+                        maxNameTableCharCount="16384" />  
+                    <security mode="None">  
+                        <transport clientCredentialType="None" proxyCredentialType="None"  
+                            realm="" />  
+                        <message clientCredentialType="UserName" algorithmSuite="Default" />  
+                    </security>  
+                </binding>  
+            </basicHttpBinding>  
+        </bindings>  
+        <client>  
+            <endpoint address="http://localhost:36906/Service1.svc" binding="basicHttpBinding"  
+                bindingConfiguration="BasicHttpBinding_IService1" contract="IService1"  
+                name="BasicHttpBinding_IService1" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ WCF 4.5 で生成された同じ構成ファイルの例を次に示します。  
+  
+```  
+  
+<?xml version="1.0" encoding="utf-8"?>  
+<configuration>  
+    <system.serviceModel>  
+        <bindings>  
+            <basicHttpBinding>  
+                <binding name="BasicHttpBinding_IService1" />  
+            </basicHttpBinding>  
+        </bindings>  
+        <client>  
+            <endpoint address="http://localhost:36906/Service1.svc" binding="basicHttpBinding"  
+                bindingConfiguration="BasicHttpBinding_IService1" contract="IService1"  
+                name="BasicHttpBinding_IService1" />  
+        </client>  
+    </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## コントラクト優先の開発  
+ WCF では、コントラクト優先の開発がサポートされるようになりました。svcutl.exe ツールには、WSDL ドキュメントからサービス コントラクトとデータ コントラクトを生成できるようにする \/serviceContract スイッチがあります。  
+  
+## ポータブル サブセット プロジェクトからのサービス参照の追加  
+ ポータブル サブセット プロジェクトにより、.NET アセンブリ プログラマは 1 つのソース ツリーを保持しつつ、システムを構築できるようになります。また、ポータブル サブセット プロジェクトは、複数の .NET プラットフォーム \(デスクトップ、Silverlight、Windows Phone、および XBOX\) をサポートしています。ポータブル サブセット プロジェクトは、コア .NET プラットフォームで使用できる .NET Framework アセンブリである .NET ポータブル ライブラリのみを参照します。開発者から見れば、他の WCF クライアント アプリケーション内でサービス参照を追加するのと同じです。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ポータブル サブセット プロジェクトでサービス参照を追加する](../../../docs/framework/wcf/add-service-reference-in-a-portable-subset-project.md).  
+  
+## ASP.NET 互換性モードの既定値の変更  
+ WCF には ASP.NET 互換性モードが用意されています。これにより、開発者は WCF サービスを作成する際に ASP.NET HTTP パイプラインの機能へのフル アクセスが付与されます。このモードを使用するには、web.config の [\<serviceHostingEnvironment\>](../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) セクションで `aspNetCompatibilityEnabled` 属性を true に設定する必要があります。さらに、この appDomain 内のサービスでは、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> の `RequirementsMode` プロパティを <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> または <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> に設定しておく必要があります。既定では、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> は <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> に設定され、既定の WCF サービス アプリケーション テンプレートでは、`aspNetCompatibilityEnabled` 属性が `true` に設定されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[Windows Communication Foundation 4.5 の新機能](../../../docs/framework/wcf/whats-new.md)」および「[WCF サービスと ASP.NET](../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」を参照してください。  
+  
+## ストリーミングの強化  
+  
+-   非同期ストリーミングに対する新しいサポートが WCF に追加されました。非同期ストリーミングを有効にするには、エンドポイントの <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior> 動作をサービス ホストに追加し、その <xref:System.ServiceModel.Description.DispatcherSynchronizationBehavior.AsynchronousSendEnabled%2A> プロパティを `true` に設定します。これにより、読み取りに時間のかかる複数のクライアントに対してサービスがストリーム メッセージを送信するときにスケーラビリティが得られます。WCF では、クライアントごとに 1 つのスレッドがブロックされなくなり、別のクライアントにサービスを提供するためにスレッドを解放します。  
+  
+-   サービスが IIS でホストされるときのメッセージのバッファー処理に関する制限がなくなりました。以前のバージョンの WCF では、ストリーム メッセージ転送を使用する IIS でホストされるサービスに対するメッセージを受信すると、ASP.NET はメッセージ全体を WCF に送信する前にバッファー処理しました。これにより、メモリの大量消費が発生しました。このバッファー処理は .NET 4.5 で削除されました。現在は、IIS でホストされる WCF サービスが、メッセージ全体が受信される前に着信ストリームの処理を開始できるため、実際のストリーミングが可能になります。これにより、WCF は、メッセージにすぐに応答できるようになり、パフォーマンスは向上します。さらに、着信要求に対する ASP.NET のサイズ制限である `maxRequestLength` の値を指定する必要がなくなりました。このプロパティを設定した場合、このプロパティは無視されます。`maxRequestLength`[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[\<httpRuntime\> 要素](http://go.microsoft.com/fwlink/?LinkId=223344)」を参照してください。maxAllowedContentLength はまだ構成する必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]、「[requestFiltering の requestLimits 要素](http://go.microsoft.com/fwlink/?LinkId=225908)」を参照してください。  
+  
+## トランスポートの新しい既定値  
+ 次の表は、変更された設定と追加情報の場所を示しています。  
+  
+|プロパティ|場所|新しい既定値|詳細情報|  
+|-----------|--------|------------|----------|  
+|channelInitializationTimeout|<xref:System.ServiceModel.NetTcpBinding>|30 秒|このプロパティは、.Net Framing プロトコルを使用して TCP 接続がそれ自体の認証にかかる時間を決定します。クライアントは、サーバーが認証を実行するための十分な情報を得る前に初期データを送信する必要があります。このタイムアウトは意図的に ReceiveTimeout \(10 分\) よりも小さい値に設定されます。これにより、悪意のある認証されていないクライアントは、長時間にわたってサーバーへの接続を保持できません。既定値は 30 秒です。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.ChannelInitializationTimeout%2A>|  
+|listenBacklog|<xref:System.ServiceModel.NetTcpBinding>|16 \* プロセッサの数|このソケット レベルのプロパティは、キューに入れられる "受入保留中の" 要求の数を示します。リッスン バックログ キューがいっぱいになると、新しいソケット要求は拒否されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.ServiceModel.NetTcpBinding.ListenBacklog%2A>|  
+|maxPendingAccepts|ConnectionOrientedTransportBindingElement<br /><br /> SMSvcHost.exe|2 \* トランスポート用のプロセッサの数<br /><br /> 4 \* SMSvcHost.exe 用のプロセッサの数|このプロパティは、サーバーがリスナーで待機できるチャネルの数を制限します。MaxPendingAccepts が小さすぎると、待機しているすべてのチャネルが接続のサービスを開始する間隔が小さくなりますが、新しいチャネルがリッスンを開始できなくなります。接続がこの間に到着した場合、サーバー上でこの接続を待機しているものがないため、接続は失敗します。このプロパティは、<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.MaxPendingConnections%2A> プロパティを大きな値に設定することで構成できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)].<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.MaxPendingAccepts%2A> および[Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0)|  
+|maxPendingConnections|ConnectionOrientedTransportBindingElement|12 \* プロセッサの数|このプロパティは、トランスポートが受け入れたにもかかわらず ServiceModel ディスパッチャーによって取得されていない接続の数を制御します。この値を設定するには、バインドの `MaxConnections` を使用するか、またはバインド要素の `maxOutboundConnectionsPerEndpoint` を使用してください。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.MaxPendingConnections%2A>|  
+|receiveTimeout|SMSvcHost.exe|30 秒|このプロパティは、TCP フレーム データを読み取り、基になる接続からディスパッチする接続を実行するためのタイムアウトを指定します。これは、SMSvcHost.exe サービスで受信接続からの前文データの読み取り操作を行う時間に制限を設定するために使用されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0).|  
+  
+> [!NOTE]
+>  これらの新しい既定値は、.NET Framework 4.5 がインストールされているコンピューターに WCF サービスを配置する場合のみ使用されます。.NET Framework 4.0 がインストールされているコンピューターに同じサービスを配置すると、.NET Framework 4.0 の既定値が使用されます。このような場合は、これらの設定を明示的に構成することをお勧めします。  
+  
+## XmlDictionaryReaderQuotas  
+ <xref:System.Xml.XmlDictionaryReaderQuotas> には、メッセージの作成中にエンコーダーで使用されるメモリの量を制限する XML ディクショナリ リーダーの構成可能なクォータ値が格納されます。これらのクォータは構成可能ですが、開発者がこのクォータを明示的に設定する必要性を低くするために既定値が変更されました。`MaxReceivedMessageSize` クォータは変更されていないため、メモリ使用量を引き続き制限して、<xref:System.Xml.XmlDictionaryReaderQuotas> の複雑さを処理する必要性を回避できます。次の表に、クォータ、クォータの新しい既定値、および各クォータの用途の簡単な説明を示します。  
+  
+|クォータの名前|既定値|説明|  
+|-------------|---------|--------|  
+|<xref:System.Xml.XmlDictionaryReaderQuotas.MaxArrayLength%2A>|Int32.MaxValue|許容される最大配列長を取得または設定します。このクォータは、XML リーダーが返すプリミティブ配列 \(バイト配列など\) の最大サイズを制限します。このクォータは、XML リーダー自体のメモリ消費は制限しませんが、このリーダーを使用するコンポーネントのメモリ消費を制限します。たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> が <xref:System.Xml.XmlDictionaryReaderQuotas.MaxArrayLength%2A> でセキュリティ保護されたリーダーを使用するときは、このクォータを超えるバイト配列を逆シリアル化することはありません。|  
+|<xref:System.Xml.XmlDictionaryReaderQuotas.MaxBytesPerRead%2A>|Int32.MaxValue|1 回の読み取りで返すことができる最大バイト数を取得または設定します。このクォータは、要素の開始タグとその属性を読み取るときに、1 回の読み取り操作で読み取るバイト数を制限します \(ストリーミングを使用しない場合、要素名自体がクォータに照らし合わせてカウントされることはありません\)。XML 属性が多すぎると、属性名は一意かどうかを確認する必要があるため、処理時間が大幅に増加する可能性があります。<xref:System.Xml.XmlDictionaryReaderQuotas.MaxBytesPerRead%2A> によってこの脅威を軽減できます。|  
+|<xref:System.Xml.XmlDictionaryReaderQuotas.MaxDepth%2A>|128 ノードの深さ|このクォータは、XML 要素の入れ子の深さの最大値を制限します。<xref:System.Xml.XmlDictionaryReaderQuotas.MaxDepth%2A> は <xref:System.Xml.XmlDictionaryReaderQuotas.MaxBytesPerRead%2A> と相互に関係しています。リーダーは常に、現在の要素とそのすべての先祖に関するデータをメモリ内に維持します。このため、リーダーのメモリ消費の最大値は、この 2 つの設定値の積に比例します。深く入れ子になったオブジェクト グラフを逆シリアル化する場合、デシリアライザーはスタック全体にアクセスし、回復不可能な <xref:System.StackOverflowException> をスローするしかありません。<xref:System.Runtime.Serialization.DataContractSerializer> の場合も <xref:System.Runtime.Serialization.XmlSerializer> の場合も、XML の入れ子構造とオブジェクトの入れ子構造との間に直接的な相関関係が存在します。この脅威を軽減するには、<xref:System.Xml.XmlDictionaryReaderQuotas.MaxDepth%2A> を使用します。|  
+|<xref:System.Xml.XmlDictionaryReaderQuotas.MaxNameTableCharCount%2A>|Int32.MaxValue|このクォータは、nametable で使用できる最大文字数を制限します。nametable には、XML ドキュメントを処理するときに出現する特定の文字列 \(名前空間やプレフィックスなど\) が入っています。これらの文字列はメモリ内でバッファー化されるので、ストリーミングが予想されるときは、このクォータを使用して過度のバッファーを防止します。|  
+|<xref:System.Xml.XmlDictionaryReaderQuotas.MaxStringContentLength%2A>|Int32.MaxValue|このクォータは、XML リーダーが返す文字列の最大サイズを制限します。このクォータは、XML リーダー自体のメモリ消費は制限しませんが、このリーダーを使用するコンポーネントのメモリ消費を制限します。たとえば、<xref:System.Runtime.Serialization.DataContractSerializer> が <xref:System.Xml.XmlDictionaryReaderQuotas.MaxStringContentLength%2A> でセキュリティ保護されたリーダーを使用するときは、このクォータを超える文字列を逆シリアル化することはありません。|  
+  
+> [!IMPORTANT]
+>  データのセキュリティ保護の詳細については、「[セキュリティに関するデータの考慮事項](../../../docs/framework/wcf/feature-details/security-considerations-for-data.md)」の「XML の安全な使用」を参照してください。  
+  
+> [!NOTE]
+>  これらの新しい既定値は、.NET Framework 4.5 がインストールされているコンピューターに WCF サービスを配置する場合のみ使用されます。.NET Framework 4.0 がインストールされているコンピューターに同じサービスを配置すると、.NET Framework 4.0 の既定値が使用されます。このような場合は、これらの設定を明示的に構成することをお勧めします。  
+  
+## WCF 構成検証  
+ Visual Studio 内でのビルド プロセスの一環として、WCF 構成ファイルが検証されるようになりました。検証に失敗すると、Visual Studio では検証エラーと警告の一覧が表示されます。  
+  
+## XML エディターのツールヒント  
+ 新規および既存の WCF サービスの開発者がサービスを構成するうえで役立つよう、Visual Studio の XML エディターでは、サービス構成ファイルに含まれる各構成要素とそのプロパティにツールヒントが表示されるようになりました。  
+  
+## BasicHttpBinding の機能強化  
+  
+1.  単一の WCF エンドポイントでさまざまな認証モードに応答できます。  
+  
+2.  WCF サービスのセキュリティ設定を IIS で制御できます。
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-system-requirements.md b/docs/framework/wcf/wcf-system-requirements.md
new file mode 100644
index 00000000000..a507e19d4cc
--- /dev/null
+++ b/docs/framework/wcf/wcf-system-requirements.md
@@ -0,0 +1,38 @@
+---
+title: "WCF システム要件 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "Windows Communication Foundation, 要件"
+ms.assetid: c43918db-9a36-426c-9e8a-e1bd6688a5b7
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# WCF システム要件
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は、分散アプリケーションの作成に使用される通信インフラストラクチャです。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の実行を可能にするための要件を次に示します。  
+  
+## システム要件  
+ [!INCLUDE[wv](../../../includes/wv-md.md)] には、既定で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] がインストールされています。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、[!INCLUDE[wxpsp2](../../../includes/wxpsp2-md.md)]、[!INCLUDE[ws2003r2](../../../includes/ws2003r2-md.md)]、または [!INCLUDE[ws2003sp1](../../../includes/ws2003sp1-md.md)] にもインストールできます。  
+  
+ **メモ** [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のメッセージ キュー \(MSMQ\) 機能は、[!INCLUDE[wv](../../../includes/wv-md.md)]、[!INCLUDE[ws2003r2](../../../includes/ws2003r2-md.md)]、[!INCLUDE[ws2003sp1](../../../includes/ws2003sp1-md.md)]、および [!INCLUDE[wxppro](../../../includes/wxppro-md.md)] でのみサポートされます。  
+  
+## 参照  
+ [概念](../../../docs/framework/wcf/conceptual-overview.md)   
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)   
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-test-client-wcftestclient-exe.md b/docs/framework/wcf/wcf-test-client-wcftestclient-exe.md
new file mode 100644
index 00000000000..2cf409e8861
--- /dev/null
+++ b/docs/framework/wcf/wcf-test-client-wcftestclient-exe.md
@@ -0,0 +1,176 @@
+---
+title: "WCF のテスト用クライアント (WcfTestClient.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4302855-677f-4640-aa90-c5d785d72fb7
+caps.latest.revision: 45
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 45
+---
+# WCF のテスト用クライアント (WcfTestClient.exe)
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] テスト クライアント \(WcfTestClient.exe\) は、テスト パラメーターを入力し、その入力をサービスに送信して、サービスから返される応答を確認できる GUI ツールです。  このツールを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストと組み合わせて使用すると、シームレスにサービスをテストできるようになります。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Test Client \(WcfTestClient.exe\) は、C:\\Program Files\\Microsoft Visual Studio 9.0\\Common7\\IDE\\ にあります。  
+  
+## テスト用クライアントを使用するシナリオ  
+ 以下のセクションで、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントを使用して開発プロセスを効率化できる最も一般的なシナリオについて説明します。  
+  
+### Visual Studio 内  
+  
+#### WCF サービス ホストが、1 つのサービスを使用する WCF のテスト用クライアントを開始する  
+ 新しい [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス プロジェクトを作成し、F5 キーを押してデバッガーを起動すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストがプロジェクトのサービスのホストを開始します。  その後、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントが開き、構成ファイルに定義されているサービス エンドポイントの一覧が表示されます。  ユーザーは、パラメーターをテストしてサービスを呼び出すことができ、このプロセスを繰り返して、サービスのテストおよび検証を継続的に行うことができます。  
+  
+#### WCF サービス ホストが、複数のサービスを使用する WCF のテスト用クライアントを開始する  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントは、複数のサービスを含むサービス プロジェクトをデバッグするためにも使用できます。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントは、開始されると、自動的にプロジェクトのサービスのリストを反復処理し、テストするためにそれらを開きます。  
+  
+### Visual Studio の外部  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアント \(WcfTestClient.exe\) を Visual Studio の外部で呼び出して、インターネット上の任意のサービスをテストすることもできます。  このツールを見つけるには、次の場所に移動します。  
+  
+ C:\\Program Files\\Microsoft Visual Studio 9.0\\Common7\\IDE\\  
+  
+ ツールを使用するには、ファイル名をダブルクリックしてこの場所からツールを開くか、コマンド ラインからツールを起動します。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントは、任意の数の URI をコマンド ライン引数として受け取ります。  これらの引数には、テストできるサービスの URI を指定します。  
+  
+ `wcfTestClient.exe URI1 URI2 …`  
+  
+ \[[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアント\] ウィンドウが開いたら、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックし、開くサービスのエンドポイント アドレスを入力します。  
+  
+## WCF のテスト用クライアントのユーザー インターフェイス  
+ 1 つのサービスまたは複数のサービスを使用する [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントを使用できます。  
+  
+### サービス操作  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントのメイン ウィンドウの左ペインには、使用できるすべてのサービスが、それぞれのエンドポイントおよび操作と共に表示されます。  
+  
+ 操作をダブルクリックすると、その操作の名前が付いた新しいタブ内の右ペインで、操作の内容を表示できます。  
+  
+ 左ペインには、クライアントの構成ファイルも表示されます。  いずれかの項目をダブルクリックすると、右ペインの新しいタブ付きウィンドウにファイルの内容が表示されます。  
+  
+### テスト パラメーターの入力  
+ テスト パラメーターを表示するには、右ペインで操作をダブルクリックして開きます。  既定では、パラメーターは **\[書式付き\]** ビューで表示されます。サービスをテストするためのパラメーターに任意の値を入力できます。  
+  
+ メッセージの XML を表示するには、**\[XML\]** をクリックします。  入力した値をサービスに送信するには、**\[起動\]** をクリックします。  
+  
+ DataSet パラメーターの場合、**\[編集…\]** の横にある **\[…\]** ボタンをクリックして、DataGrid が表示されている新しいウィンドウで編集します。  **\[DataSet のコピー\]** ボタンおよび **\[DataSet の貼り付け\]** ボタンが表示されます。  最初の編集時に DataSet オブジェクトのスキーマが不明の場合、DataGrid は空になります。  スキーマが同じ DataSet オブジェクトを DataGrid の現在のオブジェクトに貼り付ける必要があります   \(スキーマは、貼り付け操作の前に別の場所からコピーする必要があります\)。**\[DataSet のコピー\]** ボタンをクリックしても、将来使用するデータセット オブジェクトをコピーできます。  
+  
+ サービスの応答がテスト パラメーターの下に表示されます。  
+  
+> [!NOTE]
+>  想定される戻り値が文字列の場合、入力が引用符で囲まれていなくても、結果は引用符で囲まれた文字列として表示されます。  
+  
+ サービスのコントラクトの作成時に特定の操作を一方向として指定した場合は、サービスの応答は表示されません。  メッセージが配信のキューに置かれると、メッセージが正常に送信されたことを通知するダイアログ ボックスがすぐに表示されます。  
+  
+### セッション サポート  
+ サービス操作のタブにある **\[新しいプロキシを開始する\]** チェック ボックスを使用すると、セッション サポートを切り替えることができます。  既定では、このチェック ボックスはオフになります。  
+  
+ 特定の操作 \(または同じサービス エンドポイントの別の操作\) に対するテスト パラメーターを入力し、チェック ボックスがオフの状態で **\[起動\]** を 2 回以上クリックした場合、これらの操作は単一のプロキシを共有し、サービスの状態は複数の操作にわたって保持されます。  
+  
+ **\[新しいプロキシを開始する\]** チェック ボックスをオンにした場合は、**\[起動\]** をクリックするたびに新しいプロキシが開始され、前のセッション シナリオが終了し、サービスの状態がリセットされます。  
+  
+### クライアント構成の編集  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントのメイン ウィンドウの左ペインには、クライアントの構成ファイルが表示されます。  いずれかの項目をダブルクリックすると、右ペインにファイルの内容が表示されます。  
+  
+#### サービス構成エディターを使用した編集  
+ 左ペインで **\[構成ファイル\]** を右クリックし、コンテキスト メニューの **\[SvcConfigEditor での編集\]** をクリックします。  サービス構成エディターが起動し、クライアント構成の内容が表示されます。  このツール内で構成を編集して保存できます。  
+  
+ サービス構成エディターでファイルを保存すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントでは、ファイルが外部で変更されたことを通知する警告メッセージが表示され、ファイルを再度読み込むかどうかをたずねられます。  
+  
+ **\[はい\]** を選択すると、\[Client.dll.config\] タブの構成の内容に、エディターで行った変更が反映されます。  
+  
+ **\[いいえ\]** を選択すると、\[Client.dll.config\] タブの構成の内容は変更されず、変更内容は自動的にソース ファイルに保存されます。  
+  
+#### 既定の構成への復元  
+ すべての変更をキャンセルし、既定のクライアント構成に戻すには、左ペインで **\[構成ファイル\]** を右クリックし、コンテキスト メニューの **\[既定の構成に復元\]** をクリックします。  既定の構成値が読み込まれ、\[Client.dll.config\] タブの内容が復元されます。  
+  
+#### 変更の検証  
+ 保存した変更が [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントに読み込まれると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] スキーマに対して構成の有効性のチェックが行われます。  エラーが見つかった場合は、エラーの詳細を示すダイアログ ボックスが表示されます。  
+  
+ プロキシの生成中、バイナリのコンパイル中、またはサービスの呼び出し中は、編集をサポートするメニュー項目 \(\[...の編集\]、\[...の復元\] など\) が無効になります。  更新された構成が [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントに読み込まれるときは、サービスの呼び出しも無効になります。  
+  
+#### クライアント構成の保持  
+ **\[ツール\]** メニューの **\[オプション\]** で表示される **\[クライアント構成\]** タブには、**\[サービスの起動時に常に構成を再生成する\]** チェック ボックスがあり、既定でオンになっています。  このチェック ボックスがオンの場合は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントによってサービスが読み込まれるたびに、最新のサービス コントラクトとサービスの App.config ファイルに基づいて構成ファイルが再生成されます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスのクライアント構成を編集した場合、その更新されたファイルを常に使用してサービスをデバッグするには、**\[サービスの起動時に常に構成を再生成する\]** チェック ボックスをオフにします。  このようにすると、サービスを更新して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントを再び開いた場合でも、Client.dll.config ファイルとして使用されるのは、更新されたサービスに基づいて再生成されたファイルではなく、以前に更新したファイルになります。  
+  
+ ただし、再生成されたプロキシとの一貫性を保つために、構成ファイルの編集が必要になる場合があります。  サービスを更新したことが原因で、再生成されたプロキシと構成ファイルが一致しなくなると、サービスを呼び出したときにエラーが発生します。  
+  
+> [!CAUTION]
+>  変更したクライアント構成ファイルを後で再利用することにした場合、該当するファイルは次の場所で見つけることができます。  
+>   
+>  \\Documents and Settings\\\[ユーザー アカウント\]\\My Documents\\Test Client Projects  
+>   
+>  クライアント構成ファイルに格納されている更新された資格情報は、このフォルダーのアクセス制御リスト \(ACL\) によって保護されています。  
+  
+### サービスの追加、削除、および更新  
+  
+#### サービスの追加  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントにサービスを追加するには、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。  次に、追加するサービスの URI \(エンドポイント アドレス\) を入力する必要があります。  サービスのアドレスには、MEX アドレスまたは WSDL アドレスを指定できます。  
+  
+ **\[最近のサービス\]** サブメニューには、最近追加されたサービスのエンドポイントが 10 個まで一覧表示されます。  いずれかをクリックすると、選択したサービスが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントに追加されます。  
+  
+ サービスのツリーで、ルートの **\[マイ サービス プロジェクト\]** を右クリックし、**\[サービスの追加\]** をクリックする方法でも、同じ結果を得ることができます。  
+  
+ プロキシの生成中、バイナリのコンパイル中、またはサービスの呼び出し中は、サービスの追加をサポートするメニュー項目が無効になります。  また、サービスの呼び出しも無効になります。  
+  
+#### サービスの削除  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントからサービスを削除するには、削除するサービスのサービス ルートを右クリックし、**\[サービスの削除\]** をクリックします。  
+  
+ プロキシの生成中、バイナリのコンパイル中、またはサービスの呼び出し中は、サービスの削除をサポートするメニュー項目が無効になります。  また、サービスの呼び出しも無効になります。  
+  
+#### サービスの更新  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントの実行中にサービスに変更を加えた場合、そのサービスに対する [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントの実装を最新の状態に保つには、サービスのサービス ルートを右クリックし、**\[サービスを最新の情報に更新\]** をクリックします。  更新後、サービスの状態はリセットされます。  
+  
+ プロキシの生成中、バイナリのコンパイル中、またはサービスの呼び出し中は、サービスの更新をサポートするメニュー項目が無効になります。  また、サービスの呼び出しも無効になります。  
+  
+## テスト クライアントが生成するファイルの場所  
+ 既定では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントによって生成されたクライアント コードと構成ファイルは "%appdata%\\Local\\temp\\Test Client Projects" フォルダーに格納されます。  このフォルダーは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントの終了後に削除されます。  構成ファイルが [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントで変更された場合、**\[サービスの起動時に常に構成を再生成する\]** チェック ボックスがオフになっていると、変更されたファイルは、マッピング \(メタデータ アドレスとファイル名のマッピング\) XML ファイルをインデックスとして、"My Documents\\Test Client Projects Documents\\Test Client Projects" の "Cached Config" フォルダーにコピーされます。  
+  
+ コマンド ラインから [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントを起動し、`/ProjectPath` スイッチを使用して、生成されたファイルを格納する新しいパスを指定することもできます。また、`/RestoreProjectPath` スイッチを使用して、既定の場所を復元することもできます。  構文は次のとおりです。  
+  
+ `wcfTestClient.exe /ProjectPath [desired location]`  
+  
+ このコマンドを実行しても、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントは開きません。  フォルダーの場所が変更されるだけです。  このコマンドは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントが実行されているかどうかにかかわらず実行できます。  新しい場所は、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントが再起動したときに適用されます。  場所に関する情報は、レジストリか、"%appdata%\\Local\\temp\\Test Client Projects" フォルダーの WcfTestClient.exe.option ファイルに保存できます。  
+  
+## WCF のテスト用クライアントでサポートされる機能  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントがサポートする機能を次に示します。  
+  
+-   サービスの呼び出し : 要求\/応答メッセージおよび一方向メッセージ  
+  
+-   バインディング : Svcutil.exe でサポートされるすべてのバインディング  
+  
+-   セッションの制御  
+  
+-   メッセージ コントラクト  
+  
+-   XML シリアル化  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントでサポートされない機能を次に示します。  
+  
+-   型: <xref:System.IO.Stream>、<xref:System.ServiceModel.Channels.Message>、<xref:System.Xml.XmlElement>、<xref:System.Xml.XmlAttribute>、<xref:System.Xml.XmlNode>、<xref:System.Xml.Serialization.IXmlSerializable> インターフェイスを実装する型 \(関連する <xref:System.Xml.Serialization.XmlSchemaProviderAttribute> 属性を含む\)、<xref:System.Xml.Linq.XDocument> 型と <xref:System.Xml.Linq.XElement> 型、および ADO.NET <xref:System.Data.DataTable> 型。  
+  
+-   双方向コントラクト  
+  
+-   トランザクション  
+  
+-   セキュリティ : [!INCLUDE[infocard](../../../includes/infocard-md.md)]、証明書、およびユーザー名\/パスワード  
+  
+-   バインディング : WSFederationBinding、任意のコンテキスト バインディングおよび HTTPS バインディング、WebHttpBinding \(JSON 応答メッセージ サポート\)  
+  
+## WCF のテスト用クライアントの終了  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントは、次の方法で閉じることができます。  
+  
+-   **\[ファイル\]** メニューの **\[レジストリ エディターの終了\]** をクリックします。  または、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントのメイン ウィンドウで、**\[閉じる\]** をクリックします。  [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] テスト クライアントが [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] によって起動された場合は、どちらの手順でも [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホストがシャットダウンし、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のデバッグ処理が停止します。  
+  
+-   通知領域の **\[WCF サービス ホスト\]** アイコンを右クリックし、**\[終了\]** をクリックします。これにより、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの自動ホストと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] のテスト用クライアントの両方がシャットダウンし、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のデバッグ処理が停止します。  
+  
+## 参照  
+ [WCF サービス ホスト \(WcfSvcHost.exe\)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-troubleshooting-quickstart.md b/docs/framework/wcf/wcf-troubleshooting-quickstart.md
new file mode 100644
index 00000000000..fb3f4e7c459
--- /dev/null
+++ b/docs/framework/wcf/wcf-troubleshooting-quickstart.md
@@ -0,0 +1,260 @@
+---
+title: "WCF トラブルシューティング クイックスタート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF [WCF], トラブルシューティング"
+  - "Windows Communication Foundation [WCF], トラブルシューティング"
+ms.assetid: a9ea7a53-f31a-46eb-806e-898e465a4992
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# WCF トラブルシューティング クイックスタート
+このトピックでは、WCF クライアントと WCF サービスの開発時に生じるさまざまな既知の問題の一覧を示します。 発生している問題がこの一覧にない場合は、サービスに対してトレースを構成することをお勧めします。 これにより、トレース ファイル ビューアーで表示し、サービス内で発生することがある例外に関する詳細情報を取得できるトレース ファイルが生成されます。 トレースの構成の詳細については、「[トレースの構成](../../../docs/framework/wcf/diagnostics/tracing/configuring-tracing.md)」を参照してください。 トレース ファイル ビューアーの詳細については、「[サービス トレース ビューアー ツール \(SvcTraceViewer.exe\)](../../../docs/framework/wcf/service-trace-viewer-tool-svctraceviewer-exe.md)」を参照してください。  
+  
+1.  [Windows 7 と IIS のインストール後に WCF サービスを参照しようとすると、"HTTP エラー 404.3 \- Not Found" というエラー メッセージが表示されます](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#bkmk_0)  
+  
+     HTTP エラー 404.3 \- Not Found 拡張構成により、要求しているページは使用できません。 ページがスクリプトの場合は、ハンドラーを追加します。 ファイルをダウンロードする場合は、MIME マップを追加します。 エラーの詳細: InformationModule StaticFileModule。  
+  
+2.  [最初の要求の後でクライアントがしばらくアイドル状態になった場合、2 番目の要求で MessageSecurityException を受け取ることがあります。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q1)  
+  
+3.  [サービスと対話しているクライアントの数が約 10 個になると、サービスが新しいクライアントを拒否し始めます。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q2)  
+  
+4.  [WCF アプリケーションの構成ファイル以外の場所からサービス構成を読み込むことはできますか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q3)  
+  
+5.  [サービスとクライアントの動作に問題はないのですが、クライアントが別のコンピューター上にあるときにサービスとクライアントがうまく動作しません。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q4)  
+  
+6.  [型が例外である場合に FaultException\<Exception\> をスローすると、必ずクライアントで、ジェネリック型ではなく一般的な FaultException 型を受け取ります。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q5)  
+  
+7.  [応答にデータがない場合、一方向操作と要求\/応答操作が戻る速度がほぼ同じになるようです。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q6)  
+  
+8.  [サービスで X.509 証明書を使用していますが、System.Security.Cryptography.CryptographicException を受け取ります。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q77)  
+  
+9. [操作の最初のパラメーターを大文字から小文字に変更したら、クライアントが例外をスローするようになりました。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q88)  
+  
+10. [トレース ツールの 1 つを使用していますが、EndpointNotFoundException を受け取りました。 どうしてでしょうか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q99)  
+  
+11. [WCF SOAP アプリケーションから WCF Web HTTP アプリケーションを呼び出すと、サービスから "405 メソッドは許可されていません" というエラーが返されます](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BK_MK99)  
+  
+ [ベース アドレスについて教えてください。 エンドポイント アドレスとどのように関連していますか。](../../../docs/framework/wcf/wcf-troubleshooting-quickstart.md#BKMK_q10)  
+  
+<a name="bkmk_0"></a>   
+## Windows 7 と IIS のインストール後に WCF サービスを参照しようとすると、"HTTP エラー 404.3 \- Not Found" というエラー メッセージが表示されます  
+ エラー メッセージの全文は次のとおりです。  
+  
+ HTTP エラー 404.3 \- Not Found 拡張構成により、要求しているページは使用できません。 ページがスクリプトの場合は、ハンドラーを追加します。 ファイルをダウンロードする場合は、MIME マップを追加します。 エラーの詳細: InformationModule StaticFileModule。  
+  
+ このエラー メッセージは、\[Windows Communication Foundation HTTP Activation\] がコントロール パネルで明示的に設定されていない場合に表示されます。 これを設定するには、コントロール パネルに移動し、ウィンドウの左下にある \[プログラム\] をクリックします。 \[Windows の機能の有効化または無効化\] をクリックします。 \[Microsoft .NET Framework 3.5.1\] を展開し、\[Windows Communication Foundation HTTP Activation\] をクリックします。  
+  
+<a name="BKMK_q1"></a>   
+## 最初の要求の後でクライアントがしばらくアイドル状態になった場合、2 番目の要求で MessageSecurityException を受け取ることがあります。 どうしてでしょうか。  
+ 2 番目の要求は、主に次の 2 つの理由から失敗する可能性があります。\(1\) セッションがタイムアウトした。\(2\) サービスをホストしている Web サーバーがリサイクルされている。 最初の理由の場合、セッションはサービスがタイムアウトするまで有効です。 サービスは、サービスのバインディング \(<xref:System.ServiceModel.Channels.Binding.ReceiveTimeout%2A>\) で指定された期間内にクライアントから要求を受信しなかった場合、セキュリティ セッションを終了します。 それ以降のクライアント メッセージでは、<xref:System.ServiceModel.Security.MessageSecurityException> が発生します。 クライアントは、セキュリティで保護されたセッションをサービスとの間に再度確立して、後続のメッセージを送信するか、ステートフルなセキュリティ コンテキスト トークンを使用する必要があります。 また、ステートフルなセキュリティ コンテキスト トークンによって、セキュリティで保護されたセッションは、再利用される Web サーバーで存続することができます。 セキュリティで保護されたセッションでのステートフルなセキュリティ コンテキスト トークンの使用方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : セキュリティで保護されたセッションに対しセキュリティ コンテキスト トークンを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-security-context-token-for-a-secure-session.md)」を参照してください。 また、セキュリティで保護されたセッションは無効にできます。[\<wsHttpBinding\>](../../../docs/framework/configure-apps/file-schema/wcf/wshttpbinding.md) バインディングを使用する場合は、`establishSecurityContext` プロパティを `false` に設定して、セキュリティで保護されたセッションを無効にできます。 その他のバインディングでセキュリティで保護されたセッションを無効にするには、カスタム バインディングを作成する必要があります。 カスタム バインディングの作成の詳細については、「[方法 : SecurityBindingElement を使用してカスタム バインディングを作成する](../../../docs/framework/wcf/feature-details/how-to-create-a-custom-binding-using-the-securitybindingelement.md)」を参照してください。 このオプションを適用する前に、アプリケーションのセキュリティ要件を確認する必要があります。  
+  
+<a name="BKMK_q2"></a>   
+## サービスと対話しているクライアントの数が約 10 個になると、サービスが新しいクライアントを拒否し始めます。 どうしてでしょうか。  
+ 既定では、サービスは、10 個の同時セッションだけをサポートできます。 したがって、サービス バインディングでセッションを使用する場合、サービスは 10 個に到達するまで新しいクライアント接続を受け入れますが、その数に到達した後は、現在実行中のセッションの 1 つが終了するまで新しいクライアント接続を拒否します。 いくつかの方法で、より多くのクライアントをサポートできます。 サービスにセッションが必要ない場合、セッションの多いバインディングを使用しないでください  \([!INCLUDE[crdefault](../../../includes/crdefault-md.md)][セッションの使用](../../../docs/framework/wcf/using-sessions.md).\) 他には、<xref:System.ServiceModel.Description.ServiceThrottlingBehavior.MaxConcurrentSessions%2A> プロパティの値をユーザーの環境に適した数値に変更することによって、セッションの制限値を増やす方法があります。  
+  
+<a name="BKMK_q3"></a>   
+## WCF アプリケーションの構成ファイル以外の場所からサービス構成を読み込むことはできますか。  
+ できます。ただし、<xref:System.ServiceModel.ServiceHost> メソッドをオーバーライドするカスタムの <xref:System.ServiceModel.ServiceHostBase.ApplyConfiguration%2A> クラスを作成する必要があります。 そのメソッドでは、ベースを呼び出して最初に構成を読み込むことができますが \(標準の構成情報も読み込む場合\)、構成読み込みシステム全体を置き換えることもできます。 アプリケーションの構成ファイルとは異なる構成ファイルから構成を読み込む場合は、構成ファイルを自分で解析して構成を読み込む必要があります。  
+  
+ <xref:System.ServiceModel.ServiceHostBase.ApplyConfiguration%2A> メソッドをオーバーライドし、エンドポイントを直接構成する方法を次のコード例に示します。  
+  
+```  
+public class MyServiceHost : ServiceHost  
+{  
+  public MyServiceHost(Type serviceType, params Uri[] baseAddresses)    
+    : base(serviceType, baseAddresses)  
+  { Console.WriteLine("MyServiceHost Constructor"); }  
+  
+  protected override void ApplyConfiguration()  
+  {  
+    string straddress = GetAddress();  
+    Uri address = new Uri(straddress);  
+    Binding binding = GetBinding();  
+    base.AddServiceEndpoint(typeof(IData), binding, address);  
+  }  
+  
+  string GetAddress()  
+  { return "http://MyMachine:7777/MyEndpointAddress/"; }  
+  
+  Binding GetBinding()  
+  {  
+    WSHttpBinding binding = new WSHttpBinding();  
+    binding.Security.Mode = SecurityMode.None;  
+    return binding;  
+  }  
+}  
+```  
+  
+<a name="BKMK_q4"></a>   
+## サービスとクライアントの動作に問題はないのですが、クライアントが別のコンピューター上にあるときにサービスとクライアントがうまく動作しません。 どうしてでしょうか。  
+ 例外によっては、次のようないくつかの問題が存在する可能性があります。  
+  
+-   場合によっては、クライアントのエンドポイント アドレスを "localhost" ではなくホスト名に変更する必要があります。  
+  
+-   場合によっては、アプリケーションに対してポートを開く必要があります。 詳細については、SDK サンプルから「[ファイアウォール手順](../../../docs/framework/wcf/samples/firewall-instructions.md)」を参照してください。  
+  
+-   考えられる他の問題については、サンプル トピックの「[Running the Samples in a Workgroup and Across Machines](http://msdn.microsoft.com/ja-jp/a451a525-e7ce-452d-9da9-620221260113)」を参照してください。  
+  
+-   クライアントが Windows 資格情報を使用し、例外が <xref:System.ServiceModel.Security.SecurityNegotiationException> の場合、次のように Kerberos を設定します。  
+  
+    1.  クライアントの App.config ファイルのエンドポイント要素に ID 資格情報を追加します。  
+  
+        ```  
+        <endpoint   
+          address="http://MyServer:8000/MyService/"   
+          binding="wsHttpBinding"   
+          bindingConfiguration="WSHttpBinding_IServiceExample"   
+          contract="IServiceExample"   
+          behaviorConfiguration="ClientCredBehavior"   
+          name="WSHttpBinding_IServiceExample">  
+          <identity>  
+            <userPrincipalName value="name@corp.contoso.com"/>  
+          </identity>  
+        </endpoint>  
+        ```  
+  
+    2.  System または NetworkService アカウントで自己ホスト型サービスを実行します。 次のコマンドを実行すると、System アカウントでコマンド ウィンドウを作成できます。  
+  
+        ```  
+        at 12:36  /interactive "cmd.exe"  
+        ```  
+  
+    3.  既定でサービス プリンシパル名 \(SPN\) アカウントを使用するインターネット インフォメーション サービス \(IIS\) でのサービスをホストします。  
+  
+    4.  SetSPN を使用してドメインに新しい SPN を登録します。 この操作を行えるのは、ドメイン管理者のみです。  
+  
+ Kerberos プロトコルの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[WCF で使用されるセキュリティの概要](../../../docs/framework/wcf/feature-details/security-concepts-used-in-wcf.md)」および以下を参照してください。  
+  
+-   [Windows 認証エラーのデバッグ](../../../docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md)  
+  
+-   [Http.sys を使用した Kerberos サービス プリンシパル名の登録](http://go.microsoft.com/fwlink/?LinkId=86943)  
+  
+-   [Kerberos の説明](http://go.microsoft.com/fwlink/?LinkId=86946)  
+  
+<a name="BKMK_q5"></a>   
+## 型が例外である場合に FaultException\<Exception\> をスローすると、必ずクライアントで、ジェネリック型ではなく一般的な FaultException 型を受け取ります。 どうしてでしょうか。  
+ 独自のカスタム エラー データ型を作成し、エラー コントラクトで詳細な型としてその型を宣言することをお勧めします。 その理由は、システム指定の例外型を使用すると、次のような状況が起こるためです。  
+  
+-   サービス指向アプリケーションの長所の 1 つを排除する型依存関係が作成されます。  
+  
+-   標準的な方法でシリアル化している例外に依存できません。<xref:System.Security.SecurityException> のような例外はまったくシリアル化できない可能性があります。  
+  
+-   クライアントに内部実装の詳細が公開されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][コントラクトおよびサービスのエラーの指定と処理](../../../docs/framework/wcf/specifying-and-handling-faults-in-contracts-and-services.md).  
+  
+ ただし、アプリケーションをデバッグしている場合、<xref:System.ServiceModel.Description.ServiceDebugBehavior> クラスを使用することによって例外情報をシリアル化して、その情報をクライアントに返すことができます。  
+  
+<a name="BKMK_q6"></a>   
+## 応答にデータがない場合、一方向操作と要求\/応答操作が戻る速度がほぼ同じになるようです。 どうしてでしょうか。  
+ 操作を一方向に指定すると、操作コントラクトは入力メッセージを受け入れるだけで、出力メッセージを返しません。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、送信データがネットワークに書き込まれるか、例外がスローされたとき、すべてのクライアント呼び出しが戻ります。 一方向操作は同様に動作し、この操作では、サービスが見つからない場合は例外をスローし、サービスがネットワークからのデータの受け入れ準備を完了していない場合はブロックできます。 このため、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では通常、一方向呼び出しは要求\/応答よりも速くクライアントに戻りますが、ネットワーク上でデータの送信速度が遅くなると、一方向操作の速度も要求\/応答操作の速度と同様に遅くなります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][一方向サービス](../../../docs/framework/wcf/feature-details/one-way-services.md) および [WCF クライアントを使用したサービスへのアクセス](../../../docs/framework/wcf/feature-details/accessing-services-using-a-client.md)。  
+  
+<a name="BKMK_q77"></a>   
+## サービスで X.509 証明書を使用していますが、System.Security.Cryptography.CryptographicException を受け取ります。 どうしてでしょうか。  
+ この例外は通常、IIS ワーカー プロセスの実行に使用しているユーザー アカウントを変更すると発生します。 たとえば、[!INCLUDE[wxp](../../../includes/wxp-md.md)] で、既定のユーザー アカウントを使用して Aspnet\_wp.exe を実行しているときにそのアカウントを ASPNET からカスタムのユーザー アカウントに変更した場合、このエラーが発生します。 秘密キーを使用している場合、そのキーを使用するプロセスには、そのキーを格納しているファイルにアクセスするためのアクセス許可が必要になります。  
+  
+ この場合、秘密キーを格納しているファイルについて、プロセスのアカウントに読み取りアクセス権を与える必要があります。 たとえば、IIS ワーカー プロセスを Bob というアカウントで実行している場合、秘密キーを格納しているファイルへの読み取りアクセス権を Bob に与える必要があります。  
+  
+ 特定の X.509 証明書について、秘密キーを格納しているファイルへのアクセス権を適切なユーザー アカウントに与える方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[方法 : X.509 証明書を WCF からアクセス可能にする](../../../docs/framework/wcf/feature-details/how-to-make-x-509-certificates-accessible-to-wcf.md)」を参照してください。  
+  
+<a name="BKMK_q88"></a>   
+## 操作の最初のパラメーターを大文字から小文字に変更したら、クライアントが例外をスローするようになりました。 どうしてでしょうか。  
+ 操作シグネチャのパラメーター名の値はコントラクトに含まれ、大文字と小文字が区別されます。 ローカル パラメーター名と、クライアント アプリケーションの操作を記述するメタデータを区別する必要がある場合は、<xref:System.ServiceModel.MessageParameterAttribute?displayProperty=fullName> 属性を使用します。  
+  
+<a name="BKMK_q99"></a>   
+## トレース ツールの 1 つを使用していますが、EndpointNotFoundException を受け取りました。 どうしてでしょうか。  
+ 使用しているトレース ツールが、システム指定の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] トレース機構でなく、アドレス フィルターの不一致があることを示す <xref:System.ServiceModel.EndpointNotFoundException> を受け取った場合は、<xref:System.ServiceModel.Description.ClientViaBehavior> クラスを使用してメッセージをトレース ユーティリティに送信し、そのユーティリティがそのメッセージをサービス アドレスにリダイレクトするようにする必要があります。<xref:System.ServiceModel.Description.ClientViaBehavior> クラスは、 `Via` アドレス指定ヘッダーを変更して、`To` アドレス指定ヘッダーで示されている最終受信者とは別に、次のネットワーク アドレスを指定します。 ただし、このとき、エンドポイント アドレスは `To` 値の設定に使用されるので変更しないでください。  
+  
+ 次のコード例は、クライアント構成ファイルの例を示しています。  
+  
+```  
+<endpoint   
+  address=http://localhost:8000/MyServer/  
+  binding="wsHttpBinding"  
+  bindingConfiguration="WSHttpBinding_IMyContract"  
+  behaviorConfiguration="MyClient"   
+  contract="IMyContract"   
+  name="WSHttpBinding_IMyContract">  
+</endpoint>  
+<behaviors>  
+  <endpointBehaviors>  
+    <behavior name="MyClient">  
+      <clientVia viaUri="http://localhost:8001/MyServer/"/>  
+    </behavior>  
+  </endpointBehaviors>  
+</behaviors>  
+```  
+  
+<a name="BKMK_q10"></a>   
+## ベース アドレスについて教えてください。 エンドポイント アドレスとどのように関連していますか。  
+ ベース アドレスとは、<xref:System.ServiceModel.ServiceHost> クラスのルート アドレスです。 既定では、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> クラスをサービス構成に追加する場合、ホストが発行するすべてのエンドポイントの Web サービス記述言語 \(WSDL\) は、HTTP ベース アドレスから取得され、それにメタデータ動作に提供される相対アドレスと "?wsdl" が追加されます。[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] と IIS では、ベース アドレスは仮想ディレクトリに相当します。  
+  
+## NetTcpBinding を使用したサービス エンドポイントと MEX エンドポイント間でのポートの共有  
+ サービスのベース アドレスとして net.tcp:\/\/MyServer:8080\/MyService を指定して次のエンドポイントを追加します。  
+  
+```xml  
+<services>  
+      <service name="Microsoft.Samples.NetTcp.CalculatorService">  
+        <endpoint address="calcsvc" binding ="netTcpBinding" contract="Microsoft.Samples.NetTcp.ICalculator"/>  
+        <endpoint address="mex" binding="mexTcpBinding" contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+```  
+  
+ 次の構成スニペットに示すように、NetTcpBinding 設定の 1 つを変更するとします。  
+  
+```xml  
+<bindings>  
+      <netTcpBinding>  
+        <binding closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00" transactionFlow="false" transferMode="Buffered" transactionProtocol="OleTransactions" hostNameComparisonMode="StrongWildcard" listenBacklog="10" maxBufferPoolSize="524288" maxBufferSize="65536" maxConnections="11" maxReceivedMessageSize="65536">  
+          <readerQuotas maxDepth="32" maxStringContentLength="8192" maxArrayLength="16384" maxBytesPerRead="4096" maxNameTableCharCount="16384"/>  
+          <reliableSession ordered="true" inactivityTimeout="00:10:00" enabled="false"/>  
+          <security mode="Transport">  
+            <transport clientCredentialType="Windows" protectionLevel="EncryptAndSign"/>  
+          </security>  
+        </binding>  
+      </netTcpBinding>  
+    </bindings>  
+  
+```  
+  
+ "ハンドルされない例外: System.ServiceModel.AddressAlreadyInUseException: IP エンドポイント 0.0.0.0:9000 には既にリスナーがあります。" というエラーが表示されます。このエラーは、次の構成スニペットに示すように、ポートが異なる完全修飾 URL を MEX エンドポイントに対して指定することで回避できます。  
+  
+```  
+<services>  
+      <service name="Microsoft.Samples.NetTcp.CalculatorService">  
+        <endpoint address="calcsvc" binding ="netTcpBinding" contract="Microsoft.Samples.NetTcp.ICalculator"/>  
+        <endpoint address="net.tcp://localhost:9001/servicemodelsamples/mex" binding="mexTcpBinding" contract="IMetadataExchange" />  
+      </service>  
+    </services>  
+  
+```  
+  
+<a name="BK_MK99"></a>   
+## WCF SOAP アプリケーションから WCF Web HTTP アプリケーションを呼び出すと、サービスから "405 メソッドは許可されていません" というエラーが返されます  
+ WCF サービスから WCF Web HTTP アプリケーション \(<xref:System.ServiceModel.WebHttpBinding> および <xref:System.ServiceModel.Description.WebHttpBehavior> を使用するサービス\) を呼び出すと、"`ハンドルされていない例外: System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]: リモート サーバーから予期しない応答が返されました: (405) メソッドが許可されていません。`" という例外が発生する場合があります。この例外が発生するのは、WCF が送信 <xref:System.ServiceModel.OperationContext> を受信 <xref:System.ServiceModel.OperationContext> で上書きするためです。 この問題を解決するには、WCF Web HTTP サービス操作内で <xref:System.ServiceModel.OperationContextScope> を作成します。 例:  
+  
+```ecmascript  
+public string Echo(string input)  
+        {  
+            using (new OperationContextScope(this.InnerChannel))  
+            {  
+                return base.Channel.Echo(input);  
+            }  
+        }  
+  
+```  
+  
+## 参照  
+ [Windows 認証エラーのデバッグ](../../../docs/framework/wcf/feature-details/debugging-windows-authentication-errors.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/wcf-vs-templates.md b/docs/framework/wcf/wcf-vs-templates.md
new file mode 100644
index 00000000000..1c498c50938
--- /dev/null
+++ b/docs/framework/wcf/wcf-vs-templates.md
@@ -0,0 +1,94 @@
+---
+title: "WCF Visual Studio テンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a608575-3535-4190-89da-911e24c8374f
+caps.latest.revision: 31
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 31
+---
+# WCF Visual Studio テンプレート
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] テンプレートは、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] サービスや周辺アプリケーションをすばやく構築するために [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で使用できる、定義済みのプロジェクト テンプレートと項目テンプレートです。  
+  
+## <a name="using-the-wcf-templates"></a>WCF テンプレートの使用  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] テンプレートには、サービス開発のための基本クラス構造が含まれています。 これには、サービス コントラクト、データ コントラクト、サービス実装、および構成の基本的な定義が含まれます。 これらのテンプレートを使用すると、最小限のコードを使用した単純なサービスや、より高度なサービスのビルド ブロックを作成できます。  
+  
+### <a name="wcf-service-library-project-template"></a>WCF サービス ライブラリ プロジェクト テンプレート  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]サービス ライブラリ プロジェクト テンプレートは [新しいプロジェクト] ダイアログ ボックス **Visual C# \WCF**と**Visual Basic\WCF**します。  
+  
+ 使用して新しいプロジェクトを作成する場合、 **WCF サービス**テンプレート、新しいプロジェクトには、次の&3; つのファイルに自動的に含まれています。  
+  
+-   サービス コントラクト ファイル (IService1.cs または IService1.vb)。 サービス コントラクト ファイルは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスの属性が適用されたインターフェイスです。 このファイルには、サービスの定義方法を示す単純なサービスの定義が含まれています。その他に、パラメーター ベースの操作や、単純なデータ コントラクトのサンプルも含まれています。 このファイルは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス プロジェクトの作成後にコード エディターに表示される既定のファイルです。  
+  
+-   サービス実装ファイル (Service1.cs または Service1.vb)。 サービス実装ファイルは、サービス コントラクト ファイルに定義されているコントラクトを実装します。  
+  
+-   アプリケーション構成ファイル (App.config)。 この構成ファイルには、セキュリティで保護された HTTP バインディングを含む [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス モデルの基本要素が含まれます。 サービスのエンドポイントも含まれており、メタデータの交換も可能です。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)]使用して実行した場合に、App.config ファイルをプロジェクトの構成ファイルとして認識するように構成、 [WCF サービス ホスト (WcfSvcHost.exe)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)、これは、既定の構成。 サービス ライブラリを実行可能ファイルでホストする場合は、DLL の構成ファイルは無効になるため、その実行可能ファイルの構成ファイルに構成コードを移動する必要があります。  
+  
+### <a name="wcf-service-application-template"></a>WCF サービス アプリケーション テンプレート  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)]サービス アプリケーション テンプレートは、[新しいプロジェクト] ダイアログ ボックスの下にある **Visual C# \WCF**と**Visual Basic\WCF**します。  
+  
+ 使用して新しいプロジェクトを作成する場合、 **WCF Web アプリケーション サービス**テンプレート プロジェクトにはには、次の&4; つのファイルが含まれています。  
+  
+-   サービス ホスト ファイル (service1.svc)。  
+  
+-   サービス コントラクト ファイル (IService1.cs または IService1.vb)。  
+  
+-   サービス実装ファイル (Service1.svc.cs または Service1.svc.vb)。  
+  
+-   Web 構成ファイル (Web.config)。  
+  
+ このテンプレートでは、自動的に Web サイトが作成されて (仮想ディレクトリに配置されます)、サービスがホストされます。  
+  
+### <a name="wcf-web-site-template"></a>WCF Web サイト テンプレート  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サイト テンプレートは、[新しいプロジェクト] ダイアログ ボックスの下にある **Visual C \Web Site\WCF サービス**と**Visual Basic\Web wcf サービス**します。 これによって、WCF サービス アプリケーションのテンプレートと同じファイルが作成されますが、ASP.NET Web サイトであるかのように編成されます。 App_Code フォルダーと App_Data フォルダーが作成されます。  
+  
+### <a name="wcf-service-item-template"></a>WCF サービス項目テンプレート  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス項目テンプレートは、既存の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] プロジェクトに [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] サービスをすばやく追加できるカスタム テンプレートです。  
+  
+ このテンプレートを使用するには、**ソリューション エクスプ ローラー** ウィンドウで、プロジェクト名を右クリックし、順にポイント**追加**、クリックして**[新しい項目の**を起動する、**新しい項目の追加**] ダイアログ ボックス。  
+  
+ サービス インターフェイス ファイルとサービス実装ファイルがルート プロジェクト フォルダーに配置されます。  
+  
+ このテンプレートでは、新しいサービスの構成セクションが既存の構成ファイルと互換性がある場合にそれらがマージされます。  
+  
+ 既存のプロジェクトが Web プロジェクトの場合は、サービス ホスト ファイル (service1.svc) も作成されます。  
+  
+### <a name="wcf-wf-service-project-and-item-template"></a>WCF WF サービス プロジェクト/項目テンプレート  
+ これらのテンプレートは、ワークフロー サービスをホストする [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを作成します。ワークフロー サービスは、Web サービスのようにアクセスできるワークフローです。 この他に、XAML プログラミング モデルや命令型プログラミング モデルのテンプレートも用意されています。 これらのテンプレートを使用すると、シーケンシャル ワークフローやステート マシン ワークフローを作成できます。 これらのワークフローの種類の詳細については、次を参照してください。 [Windows Workflow Foundation チュートリアル](http://msdn.microsoft.com/ja-jp/e9705654-bd96-4b56-8d98-f1f118112d97)します。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]ワークフロー プロジェクトを作成するを参照してください[従来のワークフロー プロジェクトを作成する](../Topic/Creating%20Legacy%20Workflow%20Projects.md)です。  
+  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] デザイナーでは、コード ベースのワークフローではなく XOML 型のワークフローを使用すると応答性が向上します。 XOML ワークフローは、既定で作成されるワークフロー型です。  
+  
+### <a name="wcf-syndication-service-library-template"></a>WCF 配信サービス ライブラリ テンプレート  
+ このテンプレートを使用すると、RSS フィードや ATOM フィードを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとして公開できます。 詳細については、次を参照してください。 [WCF 配信](../../../docs/framework/wcf/feature-details/wcf-syndication.md)します。  
+  
+#### <a name="changing-the-address-of-the-feed"></a>フィードのアドレスの変更  
+ 配信テンプレートは、実行中に Internet Explorer を使用します。 プロジェクトを右クリックしたとき**ソリューション エクスプ ローラー**で[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)][**プロパティ**選択してから、**デバッグ**] タブをクリックして、テンプレートの既定のアドレスを確認できます。 Internet Explorer は、このアドレスにあるフィードを開きます。  
+  
+ 内のアドレスを変更する必要がありますもフィードのアドレスを変更する場合、**デバッグ** タブをクリックします。 これを変更しないと、Internet Explorer が既定のアドレスにあるフィードを開こうとして、エラーになります。  
+  
+### <a name="ajax-enabled-wcf-service-item-template"></a>AJAX 対応 WCF サービス項目テンプレート  
+ このテンプレートは、AJAX コントロールを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとして公開します。 AJAX コントロールの詳細については、次を参照してください。、 [AJAX コントロールに関するドキュメント](http://go.microsoft.com/fwlink/?LinkId=96717)します。  
+  
+### <a name="silverlight-enabled-wcf-service-item-template"></a>Silverlight 対応 WCF サービス項目テンプレート  
+ このテンプレートは、Silverlight クライアントまたはフロントエンドにデータを提供する Web サービスを作成します。 このテンプレートを Web サイトまたは Web アプリケーションのプロジェクトに追加すると、Silverlight クライアントとの通信をサポートするサービス コードと構成が含まれた [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスを作成できます。 使用することができますし、**サービス参照の追加**クライアントにサービスのクライアント プロキシを追加し、Silverlight クライアントと Silverlight 対応 WCF サービスの間のデータを交換します。  
+  
+ このテンプレートにアクセスするで Web サイトまたは Web アプリケーション プロジェクトを右クリックし**ソリューション エクスプ ローラー**、クリックして**新しい項目の追加**、 をクリック**Silverlight 対応 WCF サービス**します。  
+  
+> [!NOTE]
+>  Silverlight 対応 WCF サービスは、セキュリティ設定を一切有効にせずに `basicHttpBinding` エンドポイントを公開します。 したがって、サービスに接続しているすべてのクライアントが、このサービスに関する情報を取得できることになります。 また、サービスとクライアント間で交換されるメッセージの署名と暗号化も行われません。 エンドポイントを正しくセキュリティで保護するには、ASP.NET 認証や HTTPS などのメカニズムを使用する必要があります。  
+  
+## <a name="see-also"></a>関連項目  
+ [WCF サービス ホスト (WcfSvcHost.exe)](../../../docs/framework/wcf/wcf-service-host-wcfsvchost-exe.md)   
+ [WCF テスト クライアント (WcfTestClient.exe)](../../../docs/framework/wcf/wcf-test-client-wcftestclient-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/whats-new.md b/docs/framework/wcf/whats-new.md
new file mode 100644
index 00000000000..7b1690630af
--- /dev/null
+++ b/docs/framework/wcf/whats-new.md
@@ -0,0 +1,142 @@
+---
+title: "Windows Communication Foundation 4.5 の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WCF [WCF], 新機能"
+  - "Windows Communication Foundation [WCF], 新機能"
+ms.assetid: 7e93fe73-af93-46b5-9f63-32f761ee40cf
+caps.latest.revision: 35
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 35
+---
+# Windows Communication Foundation 4.5 の新機能
+このトピックでは、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] の新しい機能について説明します。  
+  
+## WCF の単純化機能  
+ WCF 4.5 アプリケーションの開発および保守を容易にするために多大な労力が費やされてきました。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md).  
+  
+### タスク ベースの非同期のサポート  
+ 既定では、サービス参照の追加によって、タスクを返す非同期サービス操作メソッドが生成されます。この処理は、同期メソッドと非同期メソッドの両方に対して行われます。これにより、新しいタスク ベースの非同期プログラミング モデルを使用して、サービス操作を非同期に呼び出すことができます。生成されたプロキシ メソッドを呼び出すと、WCF によって非同期操作を表すタスク オブジェクトが構築され、そのタスクが返されます。タスクは操作の完了時に完了します。非同期操作を実装する場合は、その操作をタスク ベースの非同期操作として実装できます。詳細については、「[同期操作と非同期操作](../../../docs/framework/wcf/synchronous-and-asynchronous-operations.md)」を参照してください。  
+  
+### 生成された構成ファイルの簡略化  
+ Visual Studio でサービス参照を追加したり、SvcUtil.exe ツールを使用したりすると、クライアント構成ファイルが生成されます。以前のバージョンの WCF では、このような構成ファイルには、各バインド プロパティの値が既定値であっても、その値が含まれていました。WCF 4.5 では、生成された構成ファイルには、既定値以外の値に設定されているバインド プロパティのみが含まれます。  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md)  
+  
+### コントラクト優先の開発  
+ WCF では、コントラクト優先の開発がサポートされるようになりました。svcutl.exe には、WSDL ドキュメントからサービス コントラクトとデータ コントラクトを生成できるようにする \/serviceContract スイッチがあります。  
+  
+### ポータブル サブセット プロジェクトからのサービス参照の追加  
+ ポータブル サブセット プロジェクトにより、.NET アセンブリ プログラマは 1 つのソース ツリーを保持しつつ、システムを構築できるようになります。また、ポータブル サブセット プロジェクトは、複数の .NET プラットフォーム \(デスクトップ、Silverlight、Windows Phone、および XBOX\) をサポートしています。ポータブル サブセット プロジェクトは、コア .NET プラットフォームで使用できる .NET Framework アセンブリである .NET ポータブル ライブラリのみを参照します。開発者から見れば、他の WCF クライアント アプリケーション内でサービス参照を追加するのと同じです。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ポータブル サブセット プロジェクトでサービス参照を追加する](../../../docs/framework/wcf/add-service-reference-in-a-portable-subset-project.md).  
+  
+### ASP.NET 互換性モードの既定値の変更  
+ WCF には ASP.NET 互換性モードが用意されています。これにより、開発者は WCF サービスを作成する際に ASP.NET HTTP パイプラインの機能へのフル アクセスが付与されます。このモードを使用するには、web.config の [\<serviceHostingEnvironment\>](../../../docs/framework/configure-apps/file-schema/wcf/servicehostingenvironment.md) セクションで `aspNetCompatibilityEnabled` 属性を true に設定する必要があります。さらに、この appDomain 内のサービスでは、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> の `RequirementsMode` プロパティを <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> または <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> に設定しておく必要があります。既定では、<xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsAttribute> は <xref:System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode> に設定されています。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[What's New in Windows Communication Foundation](../../../docs/framework/wcf/whats-new.md)」および「[WCF サービスと ASP.NET](../../../docs/framework/wcf/feature-details/wcf-services-and-aspnet.md)」を参照してください。  
+  
+### トランスポートの新しい既定値  
+ 構成を簡略化するため、多くのトランスポート プロパティの既定値が変更されました。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md).  
+  
+### XmlDictionaryReaderQuotas  
+ <xref:System.Xml.XmlDictionaryReaderQuotas> には、メッセージの作成中にエンコーダーで使用されるメモリの量を制限する XML ディクショナリ リーダーの構成可能なクォータ値が格納されます。これらのクォータは構成可能ですが、開発者がこのクォータを明示的に設定する必要性を低くするために既定値が変更されました。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md).  
+  
+### WCF 構成検証  
+ Visual Studio 内のビルド プロセスの一環として、プロジェクト内で定義された属性について WCF 構成ファイルが検証されるようになりました。検証に失敗すると、Visual Studio では検証エラーと警告の一覧が表示されます。  
+  
+### XML エディターのツールヒント  
+ 新規および既存の WCF サービスの開発者がサービスを構成するうえで役立つよう、Visual Studio の XML エディターでは、サービス構成ファイルに含まれる各構成要素とそのプロパティにツールヒントが表示されるようになりました。  
+  
+## ストリーミングの強化  
+ 非同期ストリーミングのサポートが追加されました。これにより、受信側が読み取らない場合または読み取り速度が遅い場合に送信側がスレッドをブロックすることはなくなったため、スケーラビリティが向上します。IIS でホストされる WCF サービスにクライアントがストリーム メッセージを送信する際のメッセージ バッファーの制限を解除しました。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF の単純化機能](../../../docs/framework/wcf/wcf-simplification-features.md).  
+  
+## IIS での HTTPS 上のエンドポイントの公開の簡略化  
+ HTTPS 上のエンドポイントの公開を簡単にするため、HTTPS のプロトコル マッピングが追加されました。HTTPS のエンドポイントを有効にするには、Web サイトで HTTPS バインドと SSL 証明書が構成されていることを確認した後、サービスをホストする仮想ディレクトリに対して HTTPS を有効にするだけです。サービスのメタデータが有効になっている場合は、それも HTTPS を介して公開されます。  
+  
+## 単一の WSDL ドキュメントの生成  
+ サード パーティの WSDL の処理スタックには、xsd:import を使用して他のドキュメントに依存している WSDL ドキュメントを処理できないものもあります。WCF により、すべての WSDL 情報が 1 つのドキュメントで返されるように指定できるようになりました。単一の WSDL ドキュメントを要求するには、サービスからメタデータを要求するときに URI に "?singleWSDL" を追加してください。  
+  
+## WebSocket のサポート  
+ Websocket は、TCP と同様のパフォーマンス特性を持つポート 80 と 443 で真の双方向通信を実現するテクノロジです。WebSocket トランスポート経由の通信をサポートするために 2 つの新しいバインドが追加されました。<xref:System.ServiceModel.NetHttpBinding> および <xref:System.ServiceModel.NetHttpsBinding>。詳細については、「[システム標準のバインディング](../../../docs/framework/wcf/system-provided-bindings.md)」を参照してください。  
+  
+## トランスポートの新しい既定値  
+ 次の表は、変更された設定と追加情報の場所を示しています。  
+  
+|プロパティ|場所|新しい既定値|参照先|  
+|-----------|--------|------------|---------|  
+|channelInitializationTimeout|<xref:System.ServiceModel.NetTcpBinding>|30 秒|<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.ChannelInitializationTimeout%2A>|  
+|listenBacklog|<xref:System.ServiceModel.NetTcpBinding>|12 \* プロセッサの数|<xref:System.ServiceModel.NetTcpBinding.ListenBacklog%2A>|  
+|maxPendingAccepts|ConnectionOrientedTransportBindingElement<br /><br /> SMSvcHost.exe|2 \* トランスポート用のプロセッサの数<br /><br /> 4 \* SMSvcHost.exe 用のプロセッサの数|<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.MaxPendingAccepts%2A> [Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0)|  
+|maxPendingConnections|ConnectionOrientedTransportBindingElement|12 \* プロセッサの数|<xref:System.ServiceModel.Channels.ConnectionOrientedTransportBindingElement.MaxPendingConnections%2A>|  
+|receiveTimeout|SMSvcHost.exe|30 秒|[Configuring the Net.TCP Port Sharing Service](http://msdn.microsoft.com/ja-jp/b6dd81fa-68b7-4e1b-868e-88e5901b7ea0)|  
+  
+## XML エディターのツールヒント  
+ 新規および既存の WCF サービスの開発者がサービスを構成するうえで役立つよう、Visual Studio の XML エディターでは、サービス構成ファイルに含まれる各構成要素とそのプロパティにツールヒントが表示されるようになりました。  
+  
+## コード内での WCF サービスの構成  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] では、開発者が構成ファイルまたはコードを使用してサービスを構成できます。構成ファイルは、サービスを配置した後に構成する必要がある場合に便利です。構成ファイルを使用する場合、IT 専門家は構成ファイルを更新するだけで、再コンパイルの必要はありません。ただし、構成ファイルの管理は複雑で難しくなる場合があります。構成ファイルのデバッグはサポートされていません。また、構成要素は名前で参照されるため、構成ファイルの作成時にエラーが発生しやすく、構成ファイルの作成が困難になります。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、コードでサービスを構成することもできます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の以前のバージョン \(4.0 以前\) では、自己ホスト型のシナリオであれば、コードで簡単にサービスを構成できました。また、<xref:System.ServiceModel.ServiceHost> クラスを使用すると、ServiceHost.Open を呼び出す前にエンドポイントと動作を構成できました。ただし、Web ホストのシナリオでは、<xref:System.ServiceModel.ServiceHost> クラスにアクセスできません。Web ホスト サービスを構成するには、<xref:System.ServiceModel.ServiceHost> を作成して必要な構成を実行する <xref:System.ServiceModel.ServiceHostFactory> を作成する必要がありました。.NET 4.5 以降では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用すると、自己ホスト型サービスと Web ホスト サービスの両方をコードで簡単に構成できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][コード内での WCF サービスの構成](../../../docs/framework/wcf/configuring-wcf-services-in-code.md).  
+  
+## ChannelFactory のキャッシュ  
+ WCF クライアント アプリケーションでは、<xref:System.ServiceModel.ChannelFactory%601> クラスを使用して WCF サービスとの通信チャネルを作成します。<xref:System.ServiceModel.ChannelFactory%601> インスタンスを作成する場合は、次の操作が必要になるため、オーバーヘッドが生じます。  
+  
+1.  <xref:System.ServiceModel.Description.ContractDescription> ツリーの構築  
+  
+2.  必要なすべての CLR 型の反映  
+  
+3.  チャネル スタックの構築  
+  
+4.  リソースの破棄  
+  
+ このオーバーヘッドを最小限に抑えるために、WCF では、WCF クライアント プロキシの使用時にチャネル ファクトリをキャッシュできます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][チャネル ファクトリとキャッシュ](../../../docs/framework/wcf/feature-details/channel-factory-and-caching.md).  
+  
+## 圧縮およびバイナリ エンコーダー  
+ WCF 4.5 以降の WCF バイナリ エンコーダーでは、圧縮がサポートされます。圧縮の種類は <xref:System.ServiceModel.Channels.BinaryMessageEncodingElement.CompressionFormat%2A> プロパティで構成されます。クライアントとサービスの両方で <xref:System.ServiceModel.Channels.BinaryMessageEncodingElement.CompressionFormat%2A> のプロパティを構成する必要があります。圧縮は、HTTP、HTTPS、および TCP の各プロトコルに対して有効です。クライアントが圧縮を使用するよう指定しても、サービスで圧縮がサポートされていない場合は、プロトコルの不一致を示すプロトコルの例外がスローされます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][メッセージ エンコーダーを選択する](../../../docs/framework/wcf/feature-details/choosing-a-message-encoder.md)  
+  
+## UDP  
+ UDP トランスポートのサポートが追加されたため、開発者は "ファイア アンド フォーゲット \(撃ち放し\)" メッセージングを使用するサービスを作成できるようになります。クライアントは、サービスにメッセージを送信しますが、サービスからの応答を期待しません。  
+  
+## 複数認証のサポート  
+ HTTP トランスポートとトランスポート セキュリティを使用する際に、IIS でサポートされている複数の認証モードを単一の WCF エンドポイントで使用できるようになりました。IIS では仮想ディレクトリで複数の認証モードを有効にできます。この機能によって、単一の WCF エンドポイントでは、WCF サービスがホストされている仮想ディレクトリで有効になっている複数の認証モードをサポートできます。  
+  
+## IDN サポート  
+ 国際化ドメイン名を持つ WCF サービスのためのサポートが追加されました。詳細については、「[WCF と国際化ドメイン名](../../../docs/framework/wcf/feature-details/wcf-and-internationalized-domain-names.md)」を参照してください。  
+  
+## HttpClient  
+ HTTP 要求の処理が容易になるように <xref:System.Net.Http.HttpClient> という新しいクラスが追加されました。詳細については、「[ソーシャル アプリの開発と HTTP サービスへの接続](http://go.microsoft.com/fwlink/?LinkId=231886)」および「[HttpClient サンプル](http://code.msdn.microsoft.com/windowsapps/HttpClient-sample-55700664)」を参照してください。  
+  
+## 構成の Intellisense  
+ プロジェクトで定義されるカスタム属性の構成ファイル内の属性値では、構成の迅速で正確な操作を簡単にするために Intellisense がサポートされています。  
+  
+## 構成のツールヒント  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の要素と属性のツールヒントが XML エディターで表示され、要素または属性の目的をより簡単かつ正確に特定できるようになりました。  
+  
+## クラスとしてのデータの貼り付け  
+ WCF プロジェクトでは、XML で定義されたデータ型 \(サービスで公開されるデータ型など\) をコード ページに直接貼り付けることができます。XML 型は CLR 型として貼り付けられます。詳細については、「[XML からのデータ型クラスの生成](../../../docs/framework/wcf/generating-data-type-classes-from-xml.md)」を参照してください。  
+  
+## WebServiceHost と既定のエンドポイント  
+ Visual Studio 2010 では、明示的にエンドポイントを指定したかどうかにかかわらず、WebServiceHost によって自動的に既定のエンドポイントが作成されました。Visual Studio 2012 では、エンドポイントが明示的に追加されていない場合にのみ、WebServiceHost によって既定のエンドポイントが作成されます。クライアントが既定のエンドポイントを必要としている場合は、明示的にエンドポイントを追加し、クライアントで参照することができます。または、アプリケーションの構成ファイルに次の設定を追加することで、以前の動作に戻すように WCF に指定することもできます。  
+  
+```xml  
+<appSettings>  
+    <add key="wcf:webservicehost:enableautomaticendpointscompatability" value="true"/>  
+  </appSettings>  
+  
+```  
+  
+## IHttpCookieContainerManager  
+ このインターフェイスは、<xref:System.ServiceModel.Channels.HttpChannelFactory> によって公開されます。これにより、クライアント側でのクッキーの操作がさらに容易になります。AllowCookies がバインドで true に設定されている場合は、次のコードを使用してクッキーにアクセスできます。  
+  
+```csharp  
+IHttpCookieContainerManager cookieManager = factory.GetProperty<IHttpCookieContainerManager>();   
+System.Net.CookieContainer container = cookieManager.CookieContainer;  
+  
+```  
+  
+ その後、<xref:System.Net.CookieContainer> からクッキーを取得または設定できます。AllowCookies が false に設定されている場合は、<xref:System.ServiceModel.OperationContext> を使用して手動でクッキーを取得し、別の <xref:System.ServiceModel.OperationContext> またはメッセージ インスペクターを使用して他の要求でそのクッキーを送信できます。IHttpCookieContainerManager インターフェイスを使用すると、サービスを使用してユーザーを認証し、そのサービスから返される認証クッキーを使用して他のサービスで認証することができます。
\ No newline at end of file
diff --git a/docs/framework/wcf/whats-wcf.md b/docs/framework/wcf/whats-wcf.md
new file mode 100644
index 00000000000..c91809b0e6f
--- /dev/null
+++ b/docs/framework/wcf/whats-wcf.md
@@ -0,0 +1,113 @@
+---
+title: "Windows Communication Foundation とは | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+helpviewer_keywords: 
+  - "Windows Communication Foundation [WCF], テクノロジの概要"
+  - "テクノロジの概要 [WCF]"
+  - "WCF [WCF], テクノロジの概要"
+ms.assetid: 40e1009d-ef15-450b-9848-62eabe5e5738
+caps.latest.revision: 51
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 49
+---
+# Windows Communication Foundation とは
+[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は、サービス指向アプリケーションを構築するためのフレームワークです。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用すると、1 つのサービス エンドポイントから別のサービス エンドポイントに非同期メッセージとしてデータを送信できます。 サービス エンドポイントには、IIS でホストされている、継続的に使用可能なサービスの一部を使用したり、アプリケーションでホストされているサービスを使用できます。 エンドポイントには、サービス エンドポイントからデータを要求するサービスのクライアントを使用できます。 メッセージは XML として送信された 1 文字または 1 語の簡単なものでも、バイナリ データのストリームのような複雑なものでも構いません。 サンプル シナリオをいくつか挙げます。  
+  
+-   ビジネス トランザクションを処理するセキュリティ保護サービス。  
+  
+-   トラフィック レポートやその他のモニタリング サービスなど、現在のデータを他のサービスに提供するサービス。  
+  
+-   2 人のユーザーがリアル タイムで通信したりデータを交換したりできるチャット サービス。  
+  
+-   データの 1 つ以上のサービスをポーリングし、論理プレゼンテーションで表示するダッシュボード アプリケーション。  
+  
+-   Windows Workflow Foundation を WCF サービスに使用した、実装されたワークフローの公開。  
+  
+-   最新のデータ フィードのサービスをポーリングする Silverlight アプリケーション。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] が登場する前もそのようなアプリケーションの作成は可能でしたが、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] によってエンドポイントの開発が一段と簡単になりました。 要約すると、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は Web サービスと Web サービス クライアントを作成するための管理しやすいアプローチを提供するように設計されています。  
+  
+## WCF の機能  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には次の機能セットがあります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [WCF 機能の詳細](../../../docs/framework/wcf/feature-details/index.md)。  
+  
+-   **サービス指向**  
+  
+     WS 標準を使用する結果として、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用して*サービス指向*アプリケーションを作成できます。 サービス指向アーキテクチャ \(SOA\) は、データの送受信に Web サービスを使用します。 このサービスを使用する一般的な長所は、1 つのアプリケーションから別のアプリケーションへハードコーディングせずに、疎結合にできるということです。 疎結合リレーションシップでは、必須のコントラクトが一致していれば、任意のプラットフォームで作成した任意のクライアントを任意のサービスに接続できます。  
+  
+-   **相互運用性**  
+  
+     [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は、Web サービスの相互運用性を図るために、最新の業界標準を実装しています。 サポートされている標準の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[相互運用性と統合](../../../docs/framework/wcf/feature-details/interoperability-and-integration.md)」を参照してください。  
+  
+-   **複数のメッセージ パターン**  
+  
+     メッセージは複数のパターンの 1 つを使用して交換されます。 最も一般的なパターンは要求\/応答パターンです。このパターンでは 1 つのエンドポイントが 2 番目のエンドポイントからデータを要求し、 2 番目のエンドポイントが応答します。 その他にも一方向のメッセージなどのパターンがあります。一方向のメッセージでは、1 つのエンドポイントが応答を期待せずにメッセージを送信します。 より複雑なパターンとして、2 つのエンドポイントが接続を確立し、インスタント メッセージング プログラムのようにデータをやり取りする双方向交換パターンがあります。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を使用した異なるメッセージ交換パターンの実装方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[コントラクト](../../../docs/framework/wcf/feature-details/contracts.md)」を参照してください。  
+  
+-   **サービス メタデータ**  
+  
+     [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、WSDL、XML スキーマ、WS\-Policy などの業界標準で指定された形式を使用するサービス メタデータの公開をサポートしています。 このメタデータを使用して、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスにアクセスするためのクライアントを自動生成および構成できます。 メタデータは HTTP や HTTPS 上で、または Web サービス メタデータ交換標準を使用して公開できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [メタデータ](../../../docs/framework/wcf/feature-details/metadata.md)。  
+  
+-   **データ コントラクト**  
+  
+     [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用して作成されているため、適用するコントラクトを提供するコードフレンドリなメソッドが含まれています。 汎用的な型のコントラクトの 1 つにデータ コントラクトがあります。 本質的に、Visual C\# または Visual Basic を使用してサービスをコード化した場合、データを処理する最も簡単な方法は、データ エンティティを表すクラスにデータ エンティティに属するプロパティを作成する方法です。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] には、このような簡単な方法でデータを使用する包括的なシステムがあります。 データを表すクラスを作成すると、設計したデータ型にクライアントが準拠できるメタデータがサービスによって自動生成されます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [データ コントラクトの使用](../../../docs/framework/wcf/feature-details/using-data-contracts.md)  
+  
+-   **セキュリティ**  
+  
+     メッセージを暗号化してプライバシーを保護し、メッセージを受信する前にユーザーが自身を認証することを必須化することができます。 SSL や WS\-SecureConversation などよく知られた標準を使用してセキュリティを実装できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [セキュリティ](../../../docs/framework/wcf/feature-details/security.md)。  
+  
+-   **複数のトランスポートとエンコーディング**  
+  
+     メッセージは複数の組み込みトランスポート プロトコルおよびエンコーディングのいずれかを使用して送信できます。 最も一般的なプロトコルとエンコーディングは、World Wide Web で HTTP \(ハイパーテキスト転送プロトコル\) を使用して、テキスト エンコードされた SOAP メッセージを送信するものです。 また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、TCP、名前付きパイプ、MSMQ でメッセージを送信することもできます。 これらのメッセージはテキストとしてエンコードするか、最適化されたバイナリ形式を使用することができます。  バイナリ データは MTOM 標準を使用することで効率的に送信できます。 提供されているトランスポートまたはエンコーディングのいずれもニーズを満たさない場合は、独自のカスタム トランスポートまたはエンコーディングを作成できます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] でサポートされているトランスポートとエンコーディングの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[トランスポート](../../../docs/framework/wcf/feature-details/transports.md)」を参照してください。  
+  
+-   **キューに置かれた信頼性のあるメッセージ**  
+  
+     [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] では、WS\-Reliable Messaging 経由で MSMQ を使用して実装された、信頼性の高いセッションで信頼性の高いメッセージ交換をサポートしています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] でサポートされている、キューに置かれた信頼性の高いメッセージングの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[キューと信頼できるセッション](../../../docs/framework/wcf/feature-details/queues-and-reliable-sessions.md)」を参照してください。  
+  
+-   **非揮発性メッセージ**  
+  
+     非揮発性メッセージは、通信の中断によって失われることがないメッセージです。 非揮発性メッセージ パターンのメッセージは常にデータベースに保存されます。 中断が発生した場合、接続復旧時にデータベースでメッセージの交換を再開できます。[!INCLUDE[wf](../../../includes/wf-md.md)] を使用して非揮発性メッセージを作成することもできます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [ワークフロー サービス](../../../docs/framework/wcf/feature-details/workflow-services.md)。  
+  
+-   **トランザクション**  
+  
+     WCF では、WS\-AtomicTtransactions、<xref:System.Transactions> 名前空間の API、および Microsoft 分散トランザクション コーディネーターの 3 つのトランザクション モデルの 1 つを使用したトランザクションもサポートしています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] でサポートされているトランザクションの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[トランザクション](../../../docs/framework/wcf/feature-details/transactions-in-wcf.md)」を参照してください。  
+  
+-   **AJAX および REST サポート**  
+  
+     REST は、進化し続ける Web 2.0 テクノロジの一例です。 SOAP エンベロープにラップされていない "書式なし" XML データを処理するように [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を構成できます。 また、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を拡張して、ATOM \(一般的な RSS 標準\) などの特定の XML 形式や、JSON \(JavaScript Object Notation\) などの XML 以外の形式をサポートすることもできます。  
+  
+-   **機能拡張**  
+  
+     [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] アーキテクチャーには多数の機能拡張ポイントがあります。 追加の機能が必要になった場合、サービスの動作をカスタマイズできる多数のエントリ ポイントがあります。 使用可能な拡張機能ポイントの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[WCF の拡張](../../../docs/framework/wcf/extending/extending-wcf.md)」を参照してください。  
+  
+## WCF と他のマイクロソフト テクノロジと統合  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は柔軟性の高いプラットフォームです。 この柔軟性を活かして、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は他のいくつかの Microsoft 製品でも使用されています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の基本を理解することで、これらの製品を使用するときにもすぐにこの利点を活用できます。  
+  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] とペアを組んでいる最初のテクノロジは、Windows Workflow Foundation \(WF\) です。 ワークフローではワークフローの手順を "アクティビティ" としてカプセル化することで、アプリケーション開発を簡単にできます。[!INCLUDE[wf2](../../../includes/wf2-md.md)] の最初のバージョンでは、開発者がワークフローのホストを作成する必要がありました。 次のバージョンの [!INCLUDE[wf2](../../../includes/wf2-md.md)] は [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] と統合されました。 これにより、任意のワークフローを簡単に [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスでホストできるようになりました。これは [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で WF\/WCF のプロジェクトの種類を自動的に選択して実行できます。  
+  
+ Microsoft BizTalk Server R2 も [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を通信テクノロジに使用しています。 BizTalk は、1 つの標準化形式のデータを受け取り、別の形式に変換するように設計されています。 メッセージは、厳密なマッピングか、またはワークフロー エンジンなどの BizTalk 機能の 1 つを使用してメッセージを変換できる、中央管理のメッセージ ボックスに配信する必要があります。 BizTalk では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 業務基幹 \(LOB\) アダプターを使用してメッセージをメッセージ ボックスに配信できます。  
+  
+ Microsoft Silverlight は開発者がストリーミング ビデオなどメディアを多用する Web サイトを作成できる、相互運用が可能で充実した Web アプリケーションを作成するためのプラットフォームです。 バージョン 2 以降、Silverlight は [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を通信テクノロジに組み込み、Silverlight アプリケーションを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] エンドポイントに接続するようになりました。  
+  
+ [!INCLUDE[dublin](../../../includes/dublin-md.md)] アプリケーション サーバーは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] を通信に使用するアプリケーションを配置および管理するために特別に構築されています。[!INCLUDE[dublin2](../../../includes/dublin2-md.md)] には、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 対応アプリケーションに合わせて特別に設計された豊富なツールおよび構成オプションが揃っています。  
+  
+## 参照  
+ <xref:System.ServiceModel>   
+ [Windows Communication Foundation の基本概念](../../../docs/framework/wcf/fundamental-concepts.md)   
+ [Windows Communication Foundation のアーキテクチャ](../../../docs/framework/wcf/architecture.md)   
+ [ガイドラインとベスト プラクティス](../../../docs/framework/wcf/guidelines-and-best-practices.md)   
+ [チュートリアル入門](../../../docs/framework/wcf/getting-started-tutorial.md)   
+ [ドキュメントのガイド](../../../docs/framework/wcf/guide-to-the-documentation.md)   
+ [基本的な WCF プログラミング](../../../docs/framework/wcf/basic-wcf-programming.md)   
+ [Windows Communication Foundation Samples](http://msdn.microsoft.com/ja-jp/8ec9d192-5d81-4f64-bfd3-90c5e5858c91)
\ No newline at end of file
diff --git a/docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md b/docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md
new file mode 100644
index 00000000000..109fd105ca1
--- /dev/null
+++ b/docs/framework/wcf/workflow-service-registration-tool-wfservicesreg-exe.md
@@ -0,0 +1,96 @@
+---
+title: "ワークフロー サービス登録ツール (WFServicesReg.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9e92c87b-99c5-4e8d-9d53-7944cc2b47d3
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# ワークフロー サービス登録ツール (WFServicesReg.exe)
+ワークフロー サービス登録ツール \(WFServicesReg.exe\) は、Windows Workflow Foundation \(WF\) サービスの構成要素の追加、削除、または修復に使用できるスタンドアロン ツールです。  
+  
+## 構文  
+  
+```  
+  
+WFServicesReg.exe [-c | -r | -v | -m | -i]  
+```  
+  
+## 解説  
+ このツールは、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] のインストール場所である %windir%\\Microsoft.NET\\Framework\\v3.5、または %windir%\\Microsoft.NET\\Framework64\\v3.5 \(64 ビット コンピューターの場合\) にあります。  
+  
+ 次の表は、ワークフロー サービス登録ツール \(WFServicesReg.exe\) で使用できるオプションです。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/c`|Windows ワークフロー サービスを構成します。インストールおよび修復を行う場合に使用します。|  
+|`/r`|Windows ワークフロー サービスの構成を削除します。|  
+|`/v`|構成または削除に関する詳細情報を印刷します。|  
+|`/m`|MSI ログ形式を有効にします。|  
+|`/i`|アプリケーションの実行時にウィンドウを最小化します。|  
+  
+## 登録  
+ このツールは Web.config ファイルを調べ、次の項目を登録します。  
+  
+-   [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] 参照アセンブリ  
+  
+-   .xoml ファイルのビルド プロバイダー  
+  
+-   .xoml ファイルおよび .rules ファイルの HTTP ハンドラー  
+  
+ このツールは Machine.config ファイルを調べ、次の拡張機能を登録します。  
+  
+-   behaviorExtensions  
+  
+-   bindingElementExtensions  
+  
+-   bindingExtensions  
+  
+ さらに、次のクライアント メタデータ インポーターも登録します。  
+  
+-   policyImporters  
+  
+-   wsdlImporters  
+  
+ このツールでは、IIS メタベース内の .xoml および .rules のスクリプトマップおよびハンドラーの登録も行われます。  
+  
+ [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] コンピューターと [!INCLUDE[wxp](../../../includes/wxp-md.md)] コンピューター \(IIS 5.1 および [!INCLUDE[iis601](../../../includes/iis601-md.md)]\) では、.xoml スクリプトマップと .rules スクリプトマップのセットが 1 つ登録されます。  
+  
+ 64 ビット コンピューターでは、`Enable32BitAppOnWin64` スイッチが有効な場合は WOW モードのスクリプトマップが登録され、`Enable32BitAppOnWin64` スイッチが無効な場合はネイティブの 64 ビット スクリプトマップが登録されます。  
+  
+ [!INCLUDE[wv](../../../includes/wv-md.md)] コンピューターと Windows Server 2008 \(IIS 7.0 以上\) コンピューターでは、.xoml ハンドラーと .rules ハンドラーのセットが 2 つ登録されます。そのうち 1 つは統合モード用で、もう 1 つはクラシック モード用です。  
+  
+ 64 ビット コンピューターでは、`Enable32BitAppOnWin64` スイッチの状態にかかわらず、統合モード用、WOW クラシック モード用、およびネイティブ 64 ビット クラシック モード用の 3 セットのハンドラーが登録されます。  
+  
+> [!NOTE]
+>  ServiceModelreg.exe とは異なり、WFServicesReg.exe では、特定の Web サイトのスクリプトマップまたはハンドラーの追加、削除、修復を行うことはできません。この問題の回避策については、「スクリプトマップの修復」セクションを参照してください。  
+  
+## 使用シナリオ  
+  
+### .NET Framework 3.5 インストール後の IIS のインストール  
+ [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] コンピューターでは、IIS をインストールする前に [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] がインストールされます。IIS メタベースを使用できないため、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] のインストールは、.xoml スクリプトマップと .rules スクリプトマップをインストールせずに正常に終了します。  
+  
+ IIS をインストールした後、`/c` スイッチを指定して WFServicesReg.exe ツールを使用することで、特定のスクリプトマップをインストールできます。  
+  
+### スクリプトマップの修復  
+  
+#### \[Web サイト\] ノードでスクリプトマップが削除される  
+ [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] コンピューターでは、\[Web サイト\] ノードから .xoml または .rules が誤って削除されます。これは、`/c` スイッチを指定して WFServicesReg.exe ツールを実行することにより、修復できます。  
+  
+#### 特定の Web サイトでスクリプトマップが削除される  
+ [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] コンピューターでは、\[Web サイト\] ノードではなく、特定の Web サイト \(\[既定の Web サイト\] など\) から .xoml または .rules が誤って削除されます。  
+  
+ 特定の Web サイトの削除されたハンドラーを修復するには、"WFServicesReg.exe \/r" を実行して、すべての Web サイトからハンドラーを削除した後、"WFServicesReg.exe \/c" を実行して、すべての Web サイトについて適切なハンドラーを作成します。  
+  
+### IIS モードの切り替え後のハンドラーの構成  
+ IIS が共有構成モードであり、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] がインストールされている場合、IIS メタベースは共有された場所で構成されます。IIS を非共有構成モードに切り替えると、ローカル メタベースには必要なハンドラーが格納されません。ローカル メタベースを正しく構成するには、共有メタベースをローカル メタベースにインポートするか、"WFServicesReg.exe \/c" を実行してローカル メタベースを構成してください。
\ No newline at end of file
diff --git a/docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md b/docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md
new file mode 100644
index 00000000000..94ff46c87bd
--- /dev/null
+++ b/docs/framework/wcf/ws-atomictransaction-configuration-mmc-snap-in.md
@@ -0,0 +1,99 @@
+---
+title: "WS-AtomicTransaction 構成 MMC スナップイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23592973-1d51-44cc-b887-bf8b0d801e9e
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# WS-AtomicTransaction 構成 MMC スナップイン
+WS\-AtomicTransaction 構成 MMC スナップインは、WS\-AtomicTransaction 設定の一部をローカル マシンとリモート マシンの両方で構成するために使用されます。  
+  
+## 解説  
+ [!INCLUDE[wxp](../../../includes/wxp-md.md)] または [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] を実行している場合に、MMC スナップインにアクセスするには、**\[コントロール パネル\]、\[管理ツール\]、\[コンポーネント サービス\]** の順にクリックし、**\[マイ コンピューター\]** を右クリックして、**\[プロパティ\]** をクリックします。これは MSDTC を構成する場合と同じ場所です。構成で使用できるオプションは、**\[WS\-AT\]** タブにグループ化されています。  
+  
+ Windows Vista または [!INCLUDE[lserver](../../../includes/lserver-md.md)] を実行している場合に、MMC スナップインにアクセスするには、**\[スタート\]** ボタンをクリックし、**\[検索\]** ボックスに「`dcomcnfg.exe`」と入力します。MMC が開いている場合は、**\[マイ コンピューター\]、\[分散トランザクション コーディネーター\]** ノードの順にクリックし、\[ローカル DTC\] ノードを右クリックして、**\[プロパティ\]** をクリックします。構成で使用できるオプションは、**\[WS\-AT\]** タブにグループ化されています。  
+  
+ 前の手順は、ローカル マシンを構成するためのスナップインを起動するために使用します。[!INCLUDE[wxp](../../../includes/wxp-md.md)] または [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] を実行している場合、リモート コンピューターを構成するには、**\[コントロール パネル\]、\[管理ツール\]、\[コンポーネント サービス\]** の順にクリックし、リモート コンピューターの名前にアクセスします。Windows Vista または [!INCLUDE[lserver](../../../includes/lserver-md.md)] を実行している場合は、前の Vista と [!INCLUDE[lserver](../../../includes/lserver-md.md)] 向けの手順に従います。ただし、リモート コンピューターのノードの **\[分散トランザクション コーディネーター\]\\\[ローカル DTC\]** ノードを使用します。  
+  
+ ツールのユーザー インターフェイスを使用するには、WsatUI.dll ファイルを登録する必要があります。このファイルのパスは次のとおりです。  
+  
+ **%PROGRAMFILES%\\Microsoft SDKs\\Windows\\v6.0\\Bin\\WsatUI.dll**  
+  
+ 登録するには、次のコマンドを実行します。  
+  
+```Output  
+regasm.exe /codebase WsatUI.dll  
+```  
+  
+ このツールを使用すると、WS\-AtomicTransaction の基本設定を変更できます。たとえば、WS\-AtomicTransaction プロトコル サポートの有効\/無効の切り替え、WS\-AT で使用する HTTP ポートの構成、SSL 証明書の HTTP ポートへのバインド、証明書のサブジェクト名指定による証明書の構成、トレース モードの選択とタイムアウトの既定および上限の設定を行うことができます。  
+  
+ WS\-AtomicTransaction サポートをローカル マシン上にのみ構成する必要がある場合は、このツールのコマンド ライン バージョンを使用できます。コマンド ライン ツール[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)」を参照してください。  
+  
+ MMC スナップインとコマンド ライン ツールはいずれも、すべての WS\-AT 設定を構成できるわけではありません。これらの設定は、レジストリを直接変更することによってのみ編集できます。これらのレジストリ設定[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WS\-AtomicTransaction サポートの構成](../../../docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md)」を参照してください。  
+  
+### ユーザー インターフェイスの説明  
+ **Enable WS\-Atomic Transaction Network Support** :  
+  
+ このチェック ボックスをオンまたはオフに切り替えると、このスナップインのすべての GUI コンポーネントが有効または無効になります。  
+  
+ このチェック ボックスをオンにする前に、受信か送信の通信、またはその両方で \[ネットワーク DTC アクセス\] が有効であることを確認する必要があります。この値は、MSDTC スナップインの **\[セキュリティ\]** タブで確認できます。  
+  
+#### Network グループ ボックス  
+ Network グループでは、HTTPS ポートや追加のセキュリティ設定 \(SSL 暗号化など\) を指定できます。DTC ネットワーク トランザクションが有効でない場合、このグループは無効 \(灰色表示\) です。  
+  
+ **HTTPS Port**  
+  
+ これは WS\-AT に使用される HTTPS ポートの値です。有効なポートを表す値は、1 ～ 65535 の範囲内であることが必要です。HTTP ポートを変更すると、HTTP サービス構成が変更されます。つまり、前に使用していた WS\-AT サービス アドレスが解放され、新しいポートに基づいて新しい WS\-AT サービス アドレスが登録されます。さらに、新しく選択したポートは、現在選択している SSL 証明書で暗号化されます。  
+  
+> [!NOTE]
+>  このツールを実行する前にファイアウォールが既に有効な場合、ポートは例外の一覧に自動的に登録されます。このツールを実行する前にファイアウォールが無効な場合、ファイアウォールに関する追加の構成はありません。  
+  
+ WS\-AT の構成後にファイアウォールを有効にする場合は、このツールを再度実行し、このパラメーターを使用してポート番号を指定する必要があります。WS\-AT の構成後にファイアウォールを無効にする場合は、入力を追加しないで WS\-AT の動作を続行します。  
+  
+ **エンドポイント証明書**  
+  
+ **\[Select\]** ボタンをクリックすると、ローカル マシン上で現在有効な証明書が一覧表示されます。ユーザーは、SSL 暗号化に使用できる証明書を選択できます。証明書には、秘密キーが必要です。秘密キーがない場合は、エラー メッセージが表示されます。  
+  
+> [!NOTE]
+>  選択したポートに SSL 証明書を設定すると、そのポートに関連付けられたオリジナルの SSL 証明書が上書きされます。  
+  
+ **Authorized Accounts**  
+  
+ **\[Select\]** ボタンをクリックすると、Windows アクセス制御リスト エディターが呼び出されます。このエディターでは、WS\-AtomicTransaction に参加できるユーザーまたはグループを指定できます。指定するには、**\[Participate\]** アクセス許可グループの **\[Allow\]** または **\[Deny\]** ボックスをオンにします。  
+  
+ **Authorized Certificates**  
+  
+ **\[Select\]** ボタンをクリックすると、ローカル マシン上で現在有効な証明書が一覧表示されます。WS\-AtomicTransaction への参加が許可される証明書 ID を選択できます。  
+  
+#### Timeout グループ ボックス  
+ **\[Timeout\]** グループ ボックスでは、WS\-AtomicTransaction の既定のタイムアウトと最大のタイムアウトを指定できます。送信のタイムアウトの有効値は 1 ～ 3600 の範囲です。受信のタイムアウトの有効値は 0 ～ 3600 の範囲です。  
+  
+#### グループ ボックスのトレースとログ記録  
+ **\[Tracing and Logging\]** グループ ボックスでは、トレースとログ記録の必要なレベルを構成できます。  
+  
+ **\[Options\]** ボタンをクリックすると、追加の設定を指定できるページが呼び出されます。  
+  
+ **\[Trace Level\]** コンボ ボックスでは、<xref:System.Diagnostics.TraceLevel> 列挙体から有効値を選択できます。また、チェック ボックスを使用して、アクティビティ トレースやアクティビティ伝達を実行するかどうかを指定したり、個人を特定する情報を収集するかどうかを指定することもできます。  
+  
+ **\[Logging Session\]** グループ ボックスでログ セッションを指定することもできます。  
+  
+> [!NOTE]
+>  別のトレース コンシューマーが WS\-AT トレース プロバイダーを使用している場合は、トレース イベントの新しいログ セッションを作成できません。このときにログ記録を構成しようとすると、エラー メッセージ "プロバイダーを有効にできませんでした。エラー コード: 1" が表示されます。  
+  
+ トレースとログ記録[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[管理と診断](../../../docs/framework/wcf/diagnostics/index.md)」を参照してください。  
+  
+## 参照  
+ [WS\-AtomicTransaction サポートの構成](../../../docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md)   
+ [WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\)](../../../docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md)   
+ [管理と診断](../../../docs/framework/wcf/diagnostics/index.md)
\ No newline at end of file
diff --git a/docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md b/docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md
new file mode 100644
index 00000000000..e862df3268a
--- /dev/null
+++ b/docs/framework/wcf/ws-atomictransaction-configuration-utility-wsatconfig-exe.md
@@ -0,0 +1,62 @@
+---
+title: "WS-AtomicTransaction 構成ユーティリティ (wsatConfig.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c56cf98-3963-46d5-a4e1-482deae58c58
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# WS-AtomicTransaction 構成ユーティリティ (wsatConfig.exe)
+WS\-AtomicTransaction 構成ユーティリティは、基本的な WS\-AtomicTransaction サポート設定を構成するために使用されます。  
+  
+## 構文  
+  
+```  
+  
+wsatConfig [Options]  
+```  
+  
+## 解説  
+ このコマンド ライン ツールを使用して、基本的な WS\-AtomicTransaction 設定をローカル マシンでのみ構成できます。設定をローカル コンピューターとリモート コンピューターの両方で構成する必要がある場合は、「[WS\-AtomicTransaction サポートの構成](../../../docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md)」で説明されている手順に従って、MMC スナップインを使用する必要があります。  
+  
+ コマンド ライン ツールは、Windows SDK の次のインストール場所にあります。  
+  
+ %SystemRoot%\\Microsoft.Net\\Framework\\v3.0\\Windows Communication Foundation\\wsatConfig.exe  
+  
+ [!INCLUDE[wxp](../../../includes/wxp-md.md)] または [!INCLUDE[ws2003](../../../includes/ws2003-md.md)] を実行している場合は、更新プログラムをダウンロードしてから、WsatConfig.exe を実行する必要があります。この更新プログラムの詳細については、「[Commerce Server 2007 用の更新プログラム \(KB912817\)](http://go.microsoft.com/fwlink/?LinkId=95340)」および「[Availability of Windows XP COM\+ Hotfix Rollup Package 13](http://go.microsoft.com/fwlink/?LinkId=95341)」を参照してください。  
+  
+ 次の表は、WS\-AtomicTransaction 構成ユーティリティ \(wsatConfig.exe\) で使用できるオプションを示します。  
+  
+> [!NOTE]
+>  選択したポートに SSL 証明書を設定すると、そのポートに関連付けられたオリジナルの SSL 証明書が上書きされます。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|\-accounts:\<account,\>|WS\-AtomicTransaction に追加できるアカウントをコンマで区切って指定します。これらのアカウントの有効性の確認は行われません。|  
+|\-accountsCerts:\<thumb\>&#124;"Issuer\\SubjectName",\>|WS\-AtomicTransaction に追加できる証明書をコンマで区切って指定します。証明書は、サムプリントまたは Issuer\\SubjectName ペアで示されます。空の場合は、サブジェクト名に {EMPTY} を使用します。|  
+|\-endpointCert:\<machine&#124;\<thumb\>&#124;"Issuer\\SubjectName"\>|コンピューターの証明書を使用するか、サムプリントまたは Issuer\\SubjectName ペアで指定される別のローカル エンドポイントの証明書を使用します。空の場合は、サブジェクト名に {EMPTY} を使用します。|  
+|\-maxTimeout:\<sec\>|最大タイムアウトを秒単位で指定します。有効な値は 0 ～ 3600 の範囲です。|  
+|\-network:\<enable&#124;disable\>|WS\-AtomicTransaction ネットワーク サポートを有効または無効にします。|  
+|\-port:\<portNum\>|WS\-AtomicTransaction の HTTPS ポートを設定します。<br /><br /> このツールを実行する前にファイアウォールが既に有効な場合、ポートは例外の一覧に自動的に登録されます。このツールを実行する前にファイアウォールが無効な場合は、ファイアウォールに関する追加の構成はありません。<br /><br /> WS\-AT の構成後にファイアウォールを有効にする場合は、このツールを再度実行し、このパラメーターを使用してポート番号を指定する必要があります。WS\-AT の構成後にファイアウォールを無効にする場合は、入力を追加しないで WS\-AT の動作を続行します。|  
+|\-timeout:\<sec\>|既定のタイムアウトを秒単位で指定します。有効な値は 1 ～ 3600 の範囲です。|  
+|\-traceActivity:\<enable&#124;disable\>|アクティビティ イベントのトレースを有効または無効にします。|  
+|\-traceLevel:\<Off&#124;Error&#124;Critical&#124;Warning&#124;Information&#124;Verbose&#124;All\>}|トレース レベルを指定します。|  
+|\-tracePII:\<enable&#124;disable\>|個人を特定できる情報のトレースを有効または無効にします。|  
+|\-traceProp:\<enable&#124;disable\>|伝達イベントのトレースを有効または無効にします。|  
+|\-restart|MSDTC を再起動して変更を直ちに反映します。これが指定されていない場合、変更は、MSDTC が再起動されたときに有効になります。|  
+|\-show|現在の WS\-AtomicTransaction プロトコル設定を表示します。|  
+|\-virtualServer:\<virtualServer\>|DTC リソース クラスター名を指定します。|  
+  
+## 参照  
+ [WS\-AtomicTransaction の使用](../../../docs/framework/wcf/feature-details/using-ws-atomictransaction.md)   
+ [WS\-AtomicTransaction サポートの構成](../../../docs/framework/wcf/feature-details/configuring-ws-atomic-transaction-support.md)
\ No newline at end of file
diff --git a/docs/framework/whats-new/TOC.md b/docs/framework/whats-new/TOC.md
new file mode 100644
index 00000000000..a230092d6bd
--- /dev/null
+++ b/docs/framework/whats-new/TOC.md
@@ -0,0 +1,4 @@
+# [Obsolete Types (互換性のために残されている型)](obsolete-types.md)
+# [クラス ライブラリの互換性のために残されている機能](whats-obsolete.md)
+# [新機能](index.md)
+# [互換性のために残されているメンバー](obsolete-members.md)
diff --git a/docs/framework/whats-new/index.md b/docs/framework/whats-new/index.md
new file mode 100644
index 00000000000..c7002bf42ec
--- /dev/null
+++ b/docs/framework/whats-new/index.md
@@ -0,0 +1,1369 @@
+---
+title: ".NET Framework の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "新機能 [.NET Framework]"
+ms.assetid: 1d971dd7-10fc-4692-8dac-30ca308fc0fa
+caps.latest.revision: 292
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 287
+---
+# .NET Framework の新機能
+<a name="introduction"></a>この記事では、主な新機能や強化された次のバージョン、.NET Framework の概要を示します。  
+  
+ [.NET framework 4.6.2](#v462)   
+ [.NET framework 4.6.1](#v461)   
+ [.NET 2015年、.NET Framework 4.6](#v46)   
+ [.NET framework 4.5.2](#v452)   
+ [.NET framework 4.5.1](#v451)   
+ [.NET framework 4.5](#core)  
+  
+ この記事は、各新機能の包括的な情報を説明するものではありません。また、この内容は変更される可能性があります。 .NET Framework の概要については、次を参照してください。[概要](../../../docs/framework/get-started/index.md)します。 サポートされるプラットフォームは、次を参照してください。[システム要件](../../../docs/framework/get-started/system-requirements.md)します。 ダウンロード リンクとインストール手順については、次を参照してください。[インストール ガイド](../../../docs/framework/install/guide-for-developers.md)します。  
+  
+> [!NOTE]
+>  .NET Framework チームは、アウトオブ バンドで NuGet プラットフォームのサポートを拡張し、変更できないコレクションおよび SIMD が有効なベクター型などの新機能を実装する機能も解放します。 詳細については、次を参照してください。[するその他のクラス ライブラリと Api](../../../ml/index.xml)と[.NET Framework および特別のリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)します。 参照してください、 [NuGet パッケージの完全な一覧](http://blogs.msdn.com/b/dotnet/p/nugetpackages.aspx)、.NET framework やサブスクライブを[フィード](https://nuget.org/api/v2/curated-feeds/dotnetframework/Packages/)します。  
+  
+<a name="v462"></a>   
+## <a name="introducing-the-net-framework-462"></a>.NET Framework 4.6.2 の概要  
+ この [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] は、.NET Framework 4.6 と 4.6.1 を基に、多数の新しい修正といくつかの新機能を追加したものであり、これまでと同様に非常に安定した製品です。  
+  
+### <a name="downloading-and-installing-the-net-framework-462"></a>.NET Framework 4.6.2 のダウンロードおよびインストール  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] は、次の場所からダウンロードできます。  
+  
+-   [.NET framework 4.6.2 Web インストーラー](http://go.microsoft.com/fwlink/?LinkId=780597)  
+  
+-   [NET Framework 4.6.2 のオフライン インストーラー](http://go.microsoft.com/fwlink/?LinkId=780601)  
+  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] は、Windows 10、Windows 8.1、Windows 7、および Windows Server 2008 R2 SP1 以降に相当するサーバー プラットフォームにインストールできます。 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] は、Web インストーラーまたはオフライン インストーラーを使用してインストールできます。 ほとんどのユーザーにお勧めする方法は、Web インストーラーの使用です。  
+  
+ 対象にすることができます、 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] Visual Studio 2012、または後でインストールすることによって、 [.NET Framework 4.6.2 Developer Pack](http://go.microsoft.com/fwlink/?LinkId=780617)します。  
+  
+### <a name="whats-new-in-the-net-framework-462"></a>.NET Framework 4.6.2 の新機能  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] には、次の領域における新機能が含まれています。  
+  
+-   [ASP.NET](#ASPNET462)  
+  
+-   [文字カテゴリ](#Strings)  
+  
+-   [暗号化](#Crypto462)  
+  
+-   [SqlClient](#SQLClient)  
+  
+-   [Windows Communication Foundation](#WCF)  
+  
+-   [Windows Presentation Foundation (WPF)](#WPF462)  
+  
+-   [Windows Workflow Foundation (WF)](#WF462)  
+  
+-   [ClickOnce](#ClickOnce)  
+  
+-   [Windows フォームと WPF アプリ UWP アプリを変換します。](#UWPConvert)  
+  
+-   [デバッグの機能強化](#Debug462)  
+  
+ 追加された新しい Api の一覧の場合、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]を参照してください[API の変更を .NET Framework 4.6.2](https://github.com/Microsoft/dotnet/blob/master/releases/net462/dotnet462-api-changes.md) GitHub にします。 機能の改善とにおけるバグ修正の一覧については、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]を参照してください[API の変更を .NET Framework 4.6.2](http://go.microsoft.com/fwlink/?LinkId=708778) github します。  詳細については、次を参照してください。 [4.6.2 の .NET Framework の発表](https://blogs.msdn.microsoft.com/dotnet/2016/08/02/announcing-net-framework-4-6-2/)、.NET ブログです。  
+  
+<a name="ASPNET462"></a>   
+### <a name="aspnet"></a>ASP.NET  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、ASP.NET の機能が次のように強化されています。  
+  
+ **データ注釈の検証コントロールのローカライズされたエラー メッセージのサポートの強化**  
+ データ注釈検証コントロールを使用して、1 つ以上の属性をクラス プロパティに追加して検証を行うことができます。 属性の<xref:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessage%2A?displayProperty=fullName>要素は、検証が失敗した場合にエラー メッセージのテキストを定義します。 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] 以降では、ASP.NET でエラー メッセージを簡単にローカライズできます。 エラー メッセージは次のような場合にローカライズされます。  
+  
+1.  <xref:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessage%2A?displayProperty=fullName>検証属性で提供されています。  
+  
+2.  リソース ファイルが App_LocalResources フォルダーに格納されている。  
+  
+3.  ローカライズされたリソース ファイル名の形式`DataAnnotation.Localization.{`*名*`}.resx`ここで、*名*形式のカルチャ名は、*言語コード*`-`*国または地域番号*または*言語コード*します。  
+  
+4.  リソースのキーの名前は、文字列に割り当てられている、 <xref:System.ComponentModel.DataAnnotations.ValidationAttribute.ErrorMessage%2A?displayProperty=fullName>属性、およびその値は、ローカライズされたエラー メッセージ。  
+  
+ たとえば、次のデータ注釈属性は、無効なレベルの既定のカルチャのエラー メッセージを定義します。  
+  
+```csharp  
+  
+public class RatingInfo  
+{  
+   [Required(ErrorMessage = "The rating must be between 1 and 10.")]  
+   [Display(Name = "Your Rating")]  
+   public int Rating { get; set; }  
+}  
+  
+```  
+  
+```vb  
+  
+Public Class RatingInfo  
+   <Required(ErrorMessage = "The rating must be between 1 and 10.")>  
+   <Display(Name = "Your Rating")>  
+   Public Property Rating As Integer = 1  
+End Class  
+  
+```  
+  
+ リソース ファイル、DataAnnotation.Localization.fr.resx、キーを持つエラー メッセージ文字列は、値がローカライズされたエラー メッセージを作成できます。 ファイルを検索する、`App.LocalResources`フォルダーです。 たとえば、次は、キーと、値は、ローカライズされたフランス語 (fr) 言語のエラー メッセージです。  
+  
+|名前|値|  
+|----------|-----------|  
+|評価は、1 ~ 10 でする必要があります。|Doit être メニュー 1 を構成する la 注 et 10 です。|  
+  
+ このファイルをこともできます。  
+  
+ また、データ注釈ローカリゼーションを拡張することができます。 開発者が実装することによって文字列ローカライザー プロバイダーに接続できます、 <xref:System.Web.Globalization.IStringLocalizerProvider>以外の場所に、ローカライズ文字列をリソース ファイルに格納するインターフェイスです。  
+  
+ **セッション状態ストアのプロバイダーとの非同期サポート**  
+ ASP.NET では、セッション状態ストア プロバイダーでタスクを返すメソッドを使用できるようになりました。これにより、ASP.NET アプリで非同期のスケーラビリティのメリットが得られます。 非同期操作のセッション状態とストア プロバイダーをサポートする、ASP.NET には、新しいインターフェイスが含まれています。 <xref:System.Web.SessionState.ISessionStateModule?displayProperty=fullName>、から継承される<xref:System.Web.IHttpModule>により、開発者は、独自のセッション状態モジュールと async セッション ストア プロバイダーを実装するとします。 このインターフェイスは次のように定義されます。  
+  
+```csharp  
+  
+public interface ISessionStateModule : IHttpModule {  
+    void ReleaseSessionState(HttpContext context);  
+    Task ReleaseSessionStateAsync(HttpContext context);  
+}  
+  
+```  
+  
+ さらに、 <xref:System.Web.SessionState.SessionStateUtility>クラスには、2 つの新しいメソッドが含まれています。 <xref:System.Web.SessionState.SessionStateUtility.IsSessionStateReadOnly%2A>と<xref:System.Web.SessionState.SessionStateUtility.IsSessionStateRequired%2A>、非同期操作をサポートするために使用できます。  
+  
+ **出力キャッシュ プロバイダーの非同期サポート**  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] 以降では、タスクを返すメソッドを出力キャッシュ プロバイダーで使用して、非同期のスケーラビリティのメリットを得ることができます。  これらのメソッドを実装するプロバイダーは、Web サーバー上のスレッド ブロックを減らし、ASP.NET サービスのスケーラビリティを向上させます。  
+  
+ 非同期出力キャッシュ プロバイダーをサポートするために、次の API が追加されました。  
+  
+-   <xref:System.Web.Caching.OutputCacheProviderAsync?displayProperty=fullName>から継承されるクラスが<xref:System.Web.Caching.OutputCacheProvider?displayProperty=fullName>により、開発者が非同期の出力キャッシュ プロバイダーを実装するとします。  
+  
+-   <xref:System.Web.Caching.OutputCacheUtility>クラスで、出力キャッシュを構成するためのヘルパー メソッドを提供します。  
+  
+-   18 の新しいメソッドで、 <xref:System.Web.HttpCachePolicy?displayProperty=fullName>クラスです。 以下の<xref:System.Web.HttpCachePolicy.GetCacheability%2A>、 <xref:System.Web.HttpCachePolicy.GetCacheExtensions%2A>、 <xref:System.Web.HttpCachePolicy.GetETag%2A>、 <xref:System.Web.HttpCachePolicy.GetETagFromFileDependencies%2A>、 <xref:System.Web.HttpCachePolicy.GetMaxAge%2A>、 <xref:System.Web.HttpCachePolicy.GetMaxAge%2A>、 <xref:System.Web.HttpCachePolicy.GetNoStore%2A>、 <xref:System.Web.HttpCachePolicy.GetNoTransforms%2A>、 <xref:System.Web.HttpCachePolicy.GetOmitVaryStar%2A>、 <xref:System.Web.HttpCachePolicy.GetProxyMaxAge%2A>、 <xref:System.Web.HttpCachePolicy.GetRevalidation%2A>、 <xref:System.Web.HttpCachePolicy.GetUtcLastModified%2A>、 <xref:System.Web.HttpCachePolicy.GetVaryByCustom%2A>、 <xref:System.Web.HttpCachePolicy.HasSlidingExpiration%2A>、および<xref:System.Web.HttpCachePolicy.IsValidUntilExpires%2A>します。  
+  
+-   2 つの新しい方法で、 <xref:System.Web.HttpCacheVaryByContentEncodings?displayProperty=fullName>クラス: <xref:System.Web.HttpCacheVaryByContentEncodings.GetContentEncodings%2A>と<xref:System.Web.HttpCacheVaryByContentEncodings.SetContentEncodings%2A>します。  
+  
+-   2 つの新しい方法で、 <xref:System.Web.HttpCacheVaryByHeaders?displayProperty=fullName>クラス: <xref:System.Web.HttpCacheVaryByHeaders.GetHeaders%2A>と<xref:System.Web.HttpCacheVaryByHeaders.SetHeaders%2A>します。  
+  
+-   2 つの新しい方法で、 <xref:System.Web.HttpCacheVaryByParams?displayProperty=fullName>クラス: <xref:System.Web.HttpCacheVaryByParams.GetParams%2A>と<xref:System.Web.HttpCacheVaryByParams.SetParams%2A>します。  
+  
+-   <xref:System.Web.Caching.AggregateCacheDependency?displayProperty=fullName> 、クラス、 <xref:System.Web.Caching.AggregateCacheDependency.GetFileDependencies%2A>メソッドです。  
+  
+-   <xref:System.Web.Caching.CacheDependency>、 <xref:System.Web.Caching.CacheDependency.GetFileDependencies%2A>メソッドです。  
+  
+<a name="Strings"></a>   
+### <a name="character-categories"></a>文字カテゴリ  
+ 内の文字、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]に基づいて分類は、 [Unicode 標準のバージョン 8.0.0](http://www.unicode.org/versions/Unicode8.0.0/)します。 [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] と [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] では、文字は Unicode 6.3 文字のカテゴリに基づいて分類されました。  
+  
+ Unicode 8.0 のサポートは、文字の分類を制限、 <xref:System.Globalization.CharUnicodeInfo>クラスし、それに依存する型およびメソッドにします。 含まれます、 <xref:System.Globalization.StringInfo>クラスをオーバー ロードされた<xref:System.Char.GetUnicodeCategory%2A?displayProperty=fullName>メソッド、および[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md).NET Framework 正規表現エンジンによって認識されます。  文字や文字列の比較と並べ替えは、この変更の影響を受けることなく、引き続き基となるオペレーティング システムに依存します (Windows 7 システムの場合は、.NET Framework で提供される文字データに依存)。  
+  
+ Unicode 6.0 から 7.0 の Unicode の文字のカテゴリが変更されたのため、次を参照してください。 [Unicode 標準を、バージョン 7.0.0](http://www.unicode.org/versions/Unicode7.0.0/) Unicode Consortium の web サイトに掲載します。 変更は Unicode 7.0 Unicode 8.0 を次を参照してください。 [Unicode 標準を、バージョン 8.0.0](http://www.unicode.org/versions/Unicode8.0.0/) Unicode Consortium の web サイトに掲載します。  
+  
+<a name="Crypto462"></a>   
+### <a name="cryptography"></a>暗号  
+ **証明書を含む FIPS 186 3 DSA の X509 のサポート**  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] には、FIPS 186-2 の 1024 ビットという制限を超えるキーを持つ、DSA (Digital Signature Algorithm) X509 証明書のサポートが追加されています。  
+  
+ より大きな FIPS 186-3 のキー サイズのサポートに加えて、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、SHA-2 ファミリのハッシュ アルゴリズム (SHA256、SHA384、SHA512) によるシグネチャ計算も可能です。 FIPS 186 3 のサポートはによって提供される新しい<xref:System.Security.Cryptography.DSACng?displayProperty=fullName>クラスです。  
+  
+ 最新の変更に合わせて、 <xref:System.Security.Cryptography.RSA> .NET Framework 4.6 のクラスと<xref:System.Security.Cryptography.ECDsa> 4.6.1、.NET Framework クラスに、 <xref:System.Security.Cryptography.DSA>抽象基本クラスで[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]キャストせずには、この機能を使用して呼び出し元を許可するその他の方法があります。 呼び出すことができます、 <xref:System.Security.Cryptography.X509Certificates.DSACertificateExtensions.GetDSAPrivateKey%2A?displayProperty=fullName>拡張メソッドを次の例のように、データに署名します。  
+  
+```csharp  
+  
+public static byte[] SignDataDsaSha384(byte[] data, X509Certificate2 cert)  
+{  
+    using (DSA dsa = cert.GetDSAPrivateKey())  
+    {  
+        return dsa.SignData(data, HashAlgorithmName.SHA384);  
+    }  
+}  
+  
+```  
+  
+```vb  
+  
+Public Shared Function SignDataDsaSha384(data As Byte(), cert As X509Certificate2) As Byte()  
+    Using DSA As DSA = cert.GetDSAPrivateKey()  
+        Return DSA.SignData(data, HashAlgorithmName.SHA384)  
+    End Using  
+End Function  
+  
+```  
+  
+ 呼び出すことができます、 <xref:System.Security.Cryptography.X509Certificates.DSACertificateExtensions.GetDSAPublicKey%2A?displayProperty=fullName>拡張メソッドを次の例のように、符号付きのデータを確認します。  
+  
+```csharp  
+  
+public static bool VerifyDataDsaSha384(byte[] data, byte[] signature, X509Certificate2 cert)  
+{  
+    using (DSA dsa = cert.GetDSAPublicKey())  
+    {  
+        return dsa.VerifyData(data, signature, HashAlgorithmName.SHA384);  
+    }  
+}  
+  
+```  
+  
+```  
+  
+ Public Shared Function VerifyDataDsaSha384(data As Byte(), signature As Byte(), cert As X509Certificate2) As Boolean  
+    Using dsa As DSA = cert.GetDSAPublicKey()  
+        Return dsa.VerifyData(data, signature, HashAlgorithmName.SHA384)  
+    End Using  
+End Function  
+  
+```  
+  
+ **ECDiffieHellman キー派生ルーチンへの入力に明瞭さを向上**  
+ .NET Framework 3.5 では、3 種類の KDF (キー派生関数) ルーチンによる Elliptic Curve Diffie-Hellman キー承諾のサポートが追加されました。 プロパティを使用して構成されていた、ルーチン、およびルーチン自体への入力、 <xref:System.Security.Cryptography.ECDiffieHellmanCng>オブジェクトです。 しかし、すべてのルーチンですべての入力プロパティが読み取られるわけではないため、これまで開発者がよく混乱することがありました。  
+  
+ これに対処する、 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]、次の&3; つのメソッドに追加された、 <xref:System.Security.Cryptography.ECDiffieHellman>基本 KDF ルーチンと、入力値をより明確に表すクラス。  
+  
+|ECDiffieHellman メソッド|説明|  
+|----------------------------|-----------------|  
+|[DeriveKeyFromHash (ECDiffieHellmanPublicKey HashAlgorithmName、バイト\[\]、バイト\<xref:System.Security.Cryptography.ECDiffieHellman.DeriveKeyFromHash%28System.Security.Cryptography.ECDiffieHellmanPublicKey%2CSystem.Security.Cryptography.HashAlgorithmName%2CSystem.Byte%5B%5D%2CSystem.Byte%5B%5D%29>|次の式を使用してキー マテリアルを派生させます。<br /><br /> HASH(secretPrepend ||*x* | | secretAppend)<br /><br /> ハッシュ (secretPrepend OrElse *x* OrElse secretAppend)<br /><br /> ここで*x* EC Diffie-hellman アルゴリズムの計算結果を示します。|  
+|[DeriveKeyFromHmac (ECDiffieHellmanPublicKey HashAlgorithmName、バイト\[\]、バイト\[\]、バイト\<xref:System.Security.Cryptography.ECDiffieHellman.DeriveKeyFromHmac%28System.Security.Cryptography.ECDiffieHellmanPublicKey%2CSystem.Security.Cryptography.HashAlgorithmName%2CSystem.Byte%5B%5D%2CSystem.Byte%5B%5D%2CSystem.Byte%5B%5D%29>|次の式を使用してキー マテリアルを派生させます。<br /><br /> HMAC (hmacKey secretPrepend | |*x* | | secretAppend)<br /><br /> HMAC (hmacKey secretPrepend OrElse *x* OrElse secretAppend)<br /><br /> ここで*x* EC Diffie-hellman アルゴリズムの計算結果を示します。|  
+|[DeriveKeyTls (ECDiffieHellmanPublicKey、バイト\[\]、バイト\<xref:System.Security.Cryptography.ECDiffieHellman.DeriveKeyTls%28System.Security.Cryptography.ECDiffieHellmanPublicKey%2CSystem.Byte%5B%5D%2CSystem.Byte%5B%5D%29>|TLS 擬似乱数関数 (PRF) 派生アルゴリズムを使用して、キー マテリアルを派生させます。|  
+  
+ **永続化キー対称暗号化のサポート**  
+ Windows の暗号化ライブラリ (CNG) では、永続化された対称キーの格納とハードウェアに格納された対称キーの使用のサポートが追加され、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] で開発者はこの機能を利用できるようになりました。  キー名とキー プロバイダーの概念が実装に固有であるため、この機能を使用するには、推奨されるファクトリ手法 (`Aes.Create` の呼び出しなど) ではなく、具象実装型のコンストラクターを利用する必要があります。  
+  
+ AES の永続化キー対称暗号化のサポートが存在する (<xref:System.Security.Cryptography.AesCng>) および 3 des (<xref:System.Security.Cryptography.TripleDESCng>) アルゴリズム。 例:  
+  
+```csharp  
+  
+public static byte[] EncryptDataWithPersistedKey(byte[] data, byte[] iv)  
+{  
+    using (Aes aes = new AesCng("AesDemoKey", CngProvider.MicrosoftSoftwareKeyStorageProvider))  
+    {  
+        aes.IV = iv;  
+  
+        // Using the zero-argument overload is required to make use of the persisted key  
+        using (ICryptoTransform encryptor = aes.CreateEncryptor())  
+        {  
+            if (!encryptor.CanTransformMultipleBlocks)  
+            {  
+                throw new InvalidOperationException("This is a sample, this case wasn’t handled...");  
+            }  
+  
+            return encryptor.TransformFinalBlock(data, 0, data.Length);  
+        }  
+    }  
+}  
+  
+```  
+  
+```vb  
+  
+Public Shared Function EncryptDataWithPersistedKey(data As Byte(), iv As Byte()) As Byte()  
+    Using Aes As Aes = New AesCng("AesDemoKey", CngProvider.MicrosoftSoftwareKeyStorageProvider)  
+        Aes.IV = iv  
+  
+        ' Using the zero-argument overload Is required to make use of the persisted key  
+        Using encryptor As ICryptoTransform = Aes.CreateEncryptor()  
+            If Not encryptor.CanTransformMultipleBlocks Then  
+                Throw New InvalidOperationException("This is a sample, this case wasn’t handled...")  
+            End If  
+            Return encryptor.TransformFinalBlock(data, 0, data.Length)  
+        End Using  
+    End Using  
+End Function  
+  
+```  
+  
+ **Sha-2 ハッシュの SignedXml サポート**  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]にサポートが追加されて、 <xref:System.Security.Cryptography.Xml.SignedXml>ダイジェスト アルゴリズムを rsa-sha256、RSA SHA384、SHA512 RSA PKCS&#1; の署名方法と、SHA256、SHA384、SHA512 リファレンス クラスです。  
+  
+ URI の定数がすべてで公開されている<xref:System.Security.Cryptography.Xml.SignedXml>:  
+  
+|SignedXml フィールド|定数|  
+|---------------------|--------------|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigSHA256Url>|"http://www.w3.org/2001/04/xmlenc#sha256"|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigRSASHA256Url>|"http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigSHA384Url>|"http://www.w3.org/2001/04/xmldsig-more#sha384"|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigRSASHA384Url>|"http://www.w3.org/2001/04/xmldsig-more#rsa-sha384"|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigSHA512Url>|"http://www.w3.org/2001/04/xmlenc#sha512"|  
+|<xref:System.Security.Cryptography.Xml.SignedXml.XmlDsigRSASHA512Url>|"http://www.w3.org/2001/04/xmldsig-more#rsa-sha512"|  
+  
+ カスタムを登録するすべてのプログラム<xref:System.Security.Cryptography.SignatureDescription>にハンドラー <xref:System.Security.Cryptography.CryptoConfig>これらのアルゴリズムは引き続き、過去に行ったことがあるのでここでのプラットフォームの既定値 としての機能をサポートするため、 <xref:System.Security.Cryptography.CryptoConfig>登録は必要なくなりました。  
+  
+<a name="SQLClient"></a>   
+### <a name="sqlclient"></a>SqlClient  
+ .NET framework Data Provider for SQL Server (<xref:System.Data.SqlClient?displayProperty=fullName>) で次の新機能が含まれています、 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]:  
+  
+ **接続プールと Azure SQL データベースとタイムアウト**  
+ 接続プールが有効な状態で、タイムアウトまたは他のログイン エラーが発生した場合は、例外がキャッシュされ、キャッシュされた例外は次の 5 秒から 1 分の間の後続の接続試行時にすべてスローされます。  詳細については、次を参照してください。 [SQL サーバー接続プール (ADO.NET)](../../../docs/framework/data/adonet/sql-server-connection-pooling.md)します。  
+  
+ 通常は迅速に復旧される一時的なエラーで接続試行が失敗する可能性があるため、Azure SQL Database への接続時のこの動作は望ましくありません。 接続試行操作をより最適化するため、Azure SQL Database への接続が失敗した場合は、接続プールのブロック期間の動作は削除されます。  
+  
+ 新しい `PoolBlockingPeriod` キーワードを追加することで、使用しているアプリに最適なブロック期間を選択できます。 次の値が含まれます。  
+  
+ `Auto`  
+ Azure SQL Database に接続しているアプリケーションの接続プールのブロック期間は無効になり、他のすべての SQL Server インスタンスに接続しているアプリケーションの接続プールのブロック期間が有効になります。 これが既定値です。 サーバー エンドポイント名の末尾が以下のいずれかである場合は、Azure SQL Database と見なされます。  
+  
+-   .database.windows.net  
+  
+-   .database.chinacloudapi.cn  
+  
+-   .database.usgovcloudapi.net  
+  
+-   .database.cloudapi.de  
+  
+ `AlwaysBlock`  
+ 接続プールのブロック期間は常に有効になります。  
+  
+ `NeverBlock`  
+ 接続プールのブロック期間は常に無効になります。  
+  
+ **拡張機能は常に暗号化の**  
+ SQLClient では、Always Encrypted の以下の&2; つの機能が強化されました。  
+  
+-   暗号化されたデータベースの列に対するパラメーター クエリのパフォーマンスを向上させるために、クエリ パラメーターの暗号化メタデータがキャッシュされるようになりました。 <xref:System.Data.SqlClient.SqlConnection.ColumnEncryptionQueryMetadataCacheEnabled%2A?displayProperty=fullName>プロパティに設定`true`(既定値は、)、同じクエリを複数回呼び出すと、クライアント パラメーターのメタデータ サーバーから&1; 回だけ取得します。  
+  
+-   キーのキャッシュ内の列暗号化キーのエントリが設定を使用して、構成可能な時間間隔後に解放されるようになりました、 <xref:System.Data.SqlClient.SqlConnection.ColumnEncryptionKeyCacheTtl%2A?displayProperty=fullName>プロパティです。  
+  
+<a name="WCF"></a>   
+### <a name="windows-communication-foundation"></a>Windows Communication Foundation  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、Windows Communication Foundation の次の領域の機能が強化されています。  
+  
+ **CNG を使用して格納されている証明書を WCF トランスポート セキュリティのサポート**  
+ WCF トランスポート セキュリティでは、Windows 暗号化ライブラリ (CNG) を使用して格納される証明書がサポートされます。 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、このサポートは、指数の長さが 32 ビット以下の公開キーを持つ証明書を使用する場合に限定されます。 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] を対象とするアプリケーションでは、この機能は既定で有効になります。  
+  
+ 対象とするアプリケーションの[!INCLUDE[net_v461](../../../includes/net-v461-md.md)]以前ですが実行していると、 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)]、次の行を追加することで、この機能を有効にすることができます、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) app.config または web.config ファイルのセクションです。  
+  
+```xml  
+  
+<AppContextSwitchOverrides  
+    value="Switch.System.ServiceModel.DisableCngCertificates=false"  
+/>  
+  
+```  
+  
+ 以下のようなコードを使用してプログラムで行うこともできます。  
+  
+```csharp  
+  
+private const string DisableCngCertificates = @"Switch.System.ServiceModel.DisableCngCertificates";  
+AppContext.SetSwitch(disableCngCertificates, false);  
+  
+```  
+  
+```vb  
+  
+Const DisableCngCertificates As String = "Switch.System.ServiceModel.DisableCngCertificates"  
+AppContext.SetSwitch(disableCngCertificates, False)  
+  
+```  
+  
+ **DataContractJsonSerializer クラスによって夏時間調整規則が複数のサポートの強化**  
+ お客様は、決定をアプリケーション構成の設定を使用しているかどうか、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>クラスは、1 つのタイム ゾーンの複数の調整規則をサポートしています。 これはオプトイン機能です。 これを有効にするには、app.config ファイルに次の設定を追加します。  
+  
+```xml  
+  
+<runtime>  
+     <AppContextSwitchOverrides value="Switch.System.Runtime.Serialization.DoNotUseTimeZoneInfo=false" />  
+</runtime>  
+  
+```  
+  
+ この機能が有効にすると、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>オブジェクトが使用、 <xref:System.TimeZoneInfo>型の代わりに、<xref:System.TimeZone>日付と時刻のデータを逆シリアル化する型。 <xref:System.TimeZoneInfo>履歴のタイム ゾーンのデータを使用することが複数の調整規則をサポートしています  <xref:System.TimeZone>しません。  
+  
+ 詳細については、 <xref:System.TimeZoneInfo>構造とタイム ゾーン調整を参照してください[タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)します。  
+  
+ **時刻、UTC を保持するためのサポートおよび XMLSerializer クラスを使用して逆シリアル化**  
+ 通常、ときに、 <xref:System.Xml.Serialization.XmlSerializer>クラスは、UTC をシリアル化に使用<xref:System.DateTime>値、日付と時刻を保持しますが、時間がローカルでと想定するシリアル化されたタイム文字列を作成します。  たとえば、次のコードを呼び出して UTC 日時をインスタンス化するとします。  
+  
+```csharp  
+DateTime utc = new DateTime(2016, 11, 07, 3, 0, 0, DateTimeKind.Utc);  
+```  
+  
+```vb  
+Dim utc As New Date(2016, 11, 07, 3, 0, 0, DateTimeKind.Utc)  
+```  
+  
+ この場合、システムのシリアル化された時刻文字列は、UTC より&8; 時間遅れの "03:00:00.0000000-08:00" となります。  シリアル化された値は常に、現地日時の値として逆シリアル化されます。  
+  
+ アプリケーション構成の設定を使用するを判断するかどうか、 <xref:System.Xml.Serialization.XmlSerializer>シリアル化とシリアル化するときに、UTC タイム ゾーン情報が保持されます<xref:System.DateTime>値。  
+  
+```xml  
+  
+<runtime>  
+     <AppContextSwitchOverrides   
+          value="Switch.System.Runtime.Serialization.DisableSerializeUTCDateTimeToTimeAndDeserializeUTCTimeToUTCDateTime=false" />  
+</runtime>  
+  
+```  
+  
+ この機能が有効にすると、 <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer>オブジェクトが使用、 <xref:System.TimeZoneInfo>型の代わりに、<xref:System.TimeZone>日付と時刻のデータを逆シリアル化する型。 <xref:System.TimeZoneInfo>履歴のタイム ゾーンのデータを使用することが複数の調整規則をサポートしています  <xref:System.TimeZone>しません。  
+  
+ 詳細については、 <xref:System.TimeZoneInfo>構造とタイム ゾーン調整を参照してください[タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)します。  
+  
+ **NetNamedPipeBinding 最適な一致**  
+ WCF には、クライアント アプリケーションで設定できる新しいアプリ設定があります。これにより、クライアント アプリケーションは常に、要求したものと最も一致する URI でリッスンしているサービスに接続できます。 このアプリケーション設定`false`(既定値) を使用してクライアントは<xref:System.ServiceModel.NetNamedPipeBinding>要求された URI の部分文字列である URI をリッスンするサービスに接続しようとします。  
+  
+ たとえば、クライアントが `net.pipe://localhost/Service1` でリッスンしているサービスに接続しようとしているときに、管理者特権で実行しているコンピューター上の別のサービスが `net.pipe://localhost` でリッスンしているとします。 このアプリ設定が `false` に設定されている場合、クライアントは間違ったサービスに接続しようとします。 アプリ設定を `true` に設定すれば、クライアントは常に最も一致するサービスに接続するようになります。  
+  
+> [!NOTE]
+>  使用してクライアント<xref:System.ServiceModel.NetNamedPipeBinding>完全なエンドポイント アドレスではなく (ある場合) をサービスのベース アドレスに基づくサービスを検索します。 この設定が常に機能するようにするには、サービスは一意のベース アドレスを使用する必要があります。  
+  
+ この変更を有効にするには、以下のアプリ設定をクライアント アプリケーションの App.config ファイルまたは Web.config ファイルに追加します。  
+  
+```xml  
+  
+<configuration>  
+    <appSettings>  
+        <add key="wcf:useBestMatchNamedPipeUri" value="true" />  
+    </appSettings>  
+</configuration>  
+  
+```  
+  
+ **SSL 3.0 が既定のプロトコルではありません。**  
+ トランスポート セキュリティで NetTcp を使用し、証明書の資格情報の種類を使用する場合、SSL 3.0 は、安全な接続のネゴシエーションに使用される既定のプロトコルではなくなりました。 TLS 1.0 が NetTcp のプロトコル一覧に含まれているため、ほとんどの場合、既存のアプリには影響はないと考えられます。 既存のすべてのクライアントは TLS 1.0 以降を使用して接続をネゴシエートできるようになりました。      Ssl3 が必要な場合は、以下の構成メカニズムのいずれかを使用して、ネゴシエートされたプロトコルの一覧に追加します。  
+  
+-   <xref:System.ServiceModel.Channels.SslStreamSecurityBindingElement.SslProtocols%2A?displayProperty=fullName>プロパティ  
+  
+-   <xref:System.ServiceModel.TcpTransportSecurity.SslProtocols%2A?displayProperty=fullName>プロパティ  
+  
+-   The [<>\>](../../../docs/framework/configure-apps/file-schema/wcf/transport-of-nettcpbinding.md) section of the [<>\>](../../../docs/framework/configure-apps/file-schema/wcf/nettcpbinding.md) section  
+  
+-   The [<>\>](../../../docs/framework/configure-apps/file-schema/wcf/sslstreamsecurity.md) section of the [<>\>](../../../docs/framework/configure-apps/file-schema/wcf/custombinding.md) section  
+  
+<a name="WPF462"></a>   
+### <a name="windows-presentation-foundation-wpf"></a>Windows Presentation Foundation (WPF)  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、Windows Presentation Foundation の次の領域の機能が強化されています。  
+  
+ **グループの並べ替え**  
+ 使用するアプリケーション、 <xref:System.Windows.Data.CollectionView>データをグループ化するオブジェクトは、グループを並べ替える方法を明示的に宣言できますようになりました。 明示的な並べ替えにより、アプリがグループを動的に追加または削除する場合や、グループ化に関連する項目のプロパティの値を変更する場合に発生する非直感的な順序付けの問題が解決されます。 また、グループ化プロパティの比較がコレクション全体の並べ替えからグループの並べ替えに変更されるため、グループ作成プロセスのパフォーマンスを向上させることができます。  
+  
+ グループの並べ替えをサポートするために、新しい<xref:System.ComponentModel.GroupDescription.SortDescriptions%2A?displayProperty=fullName>と<xref:System.ComponentModel.GroupDescription.CustomSort%2A?displayProperty=fullName>プロパティによって生成されるグループのコレクションを並べ替える方法を説明する、 <xref:System.ComponentModel.GroupDescription>オブジェクトです。 これは同じ名前を持つ方法に似ています<xref:System.Windows.Data.ListCollectionView>プロパティは、データ項目を並べ替える方法を説明します。  
+  
+ 2 つの新しい静的なプロパティ、 <xref:System.Windows.Data.PropertyGroupDescription>クラス、 <xref:System.Windows.Data.PropertyGroupDescription.CompareNameAscending%2A>と<xref:System.Windows.Data.PropertyGroupDescription.CompareNameDescending%2A>、最も一般的な場合に使用できます。  
+  
+ たとえば、次の XAML ではデータを年齢でグループ化し、年齢グループを昇順に並べ替え、各年齢グループ内の項目を姓でグループ化します。  
+  
+```xaml  
+  
+<GroupDescriptions>  
+     <PropertyGroupDescription   
+         PropertyName=”Age”   
+         CustomSort=   
+              ”{x:Static PropertyGroupDescription.CompareNamesAscending}”/>  
+     </PropertyGroupDescription>  
+</GroupDescriptions>  
+  
+<SortDescriptions>  
+     <SortDescription PropertyName=”LastName”/>  
+</SortDescriptions>  
+  
+```  
+  
+ **ソフト キーボードのサポート**  
+ ソフト キーボードのサポートにより、WPF アプリケーションでのフォーカス追跡が可能になります。テキスト入力が可能なコントロールによりタッチ入力を受信すると、Windows 10 の新しいソフト キーボードが自動的に起動および終了します。  
+  
+ .NET Framework の以前のバージョンでは、WPF アプリケーションは、WPF のペン/タッチ ジェスチャ サポートを無効にしないとフォーカス追跡を選択できません。  そのため、WPF アプリケーションは完全な WPF タッチのフル サポートを選ぶか、Windows のマウス プロモーションに依存する必要があります。  
+  
+ **モニターごとの DPI**  
+ WPF アプリ用の高 DPI とハイブリッド DPI 環境の最近の急激な増加に対応するために、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)] の WPF でモニターごとに対応できるようになりました。 参照してください、[サンプルと開発者ガイド](https://github.com/Microsoft/WPF-Samples/tree/master/PerMonitorDPI)モニターごとの DPI 対応になる WPF アプリを有効にする方法の詳細についての GitHub のです。  
+  
+ .NET Framework の以前のバージョンでは、WPF アプリはシステム DPI 対応です。 つまり、アプリケーションの UI は、アプリがレンダリングされるモニターの DPI に基づき、必要に応じて OS でスケーリングされます。 ,  
+  
+ 実行するアプリケーションの[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]、構成のステートメントを追加することで WPF アプリでは、モニターごとの DPI の変更を無効にすることができます、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md)アプリケーション構成のセクションでファイルの次のようにします。  
+  
+```xml  
+  
+<runtime>  
+   <AppContextSwitchOverrides value=”Switch.System.Windows.DoNotScaleForDpiChanges=false”/>  
+</runtime>  
+  
+```  
+  
+<a name="WF462"></a>   
+### <a name="windows-workflow-foundation-wf"></a>Windows Workflow Foundation (WF)  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] では、Windows Workflow Foundation の次領域の機能が強化されています。  
+  
+ **C# の式と Re-hosted WF デザイナーでは、IntelliSense のサポート**  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、WF によって、Visual Studio デザイナーとコード ワークフローの両方で C# 式がサポートされます。 再ホストされたワークフロー デザイナーは WF の主な機能です。これにより、ワークフロー デザイナーを Visual Studio の外部のアプリケーション (WPF など) で使用できるようになります。  Windows Workflow Foundation は、再ホストされたワークフロー デザイナーで C# 式と IntelliSense をサポートできるようにします。 詳細については、次を参照してください。、 [Windows Workflow Foundation ブログ](http://go.microsoft.com/fwlink/?LinkID=809042&clcid=0x409)します。  
+  
+ `Availability of IntelliSense when a customer rebuilds a workflow project from Visual Studio`  
+ [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] より前のバージョンの .NET Framework で、お客様が Visual Studio からワークフロー プロジェクトを再ビルドした場合、WF Designer IntelliSense は破損してしまいます。 プロジェクトのビルドが成功した、ワークフローの種類は、デザイナー上に存在しないおよびで不足しているワークフローの種類の IntelliSense からの警告が表示される間、**エラー一覧**ウィンドウです。 [!INCLUDE[net_v462](../../../includes/net-v462-md.md)] はこの問題に対処し、IntelliSense を使用できるようにします。  
+  
+ **ここでのワークフローの追跡とワークフロー V1 アプリケーション FIPS モードで実行します。**  
+ FIPS コンプライアンス モードが有効なコンピューターで、ワークフロー追跡が有効なワークフロー バージョン 1 スタイルのアプリケーションを正常に実行できるようになりました。 このシナリオを有効にするには、app.config ファイルを以下のように変更する必要があります。  
+  
+```xml  
+<add key="microsoft:WorkflowRuntime:FIPSRequired" value="true" />  
+```  
+  
+ このシナリオが有効でない場合、アプリケーションを実行すると、引き続き例外が生成され、"この実装は Windows プラットフォーム FIPS 検証暗号化アルゴリズムの一部ではありません" というメッセージが表示されます。  
+  
+ **Visual Studio ワークフロー デザイナーで動的更新を使用する場合のワークフローの強化**  
+ ワークフロー デザイナー、フローチャート アクティビティ デザイナー、およびその他のワークフロー アクティビティ デザイナーこれで正常に読み込んで表示呼び出した後に保存されているワークフロー、 <xref:System.Activities.DynamicUpdate.DynamicUpdateServices.PrepareForUpdate%2A?displayProperty=fullName>メソッドです。 前に .NET Framework のバージョンで、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]を呼び出した後に保存されているワークフローの Visual Studio で XAML ファイルの読み込み<xref:System.Activities.DynamicUpdate.DynamicUpdateServices.PrepareForUpdate%2A?displayProperty=fullName>次の問題が発生することができます。  
+  
+-   ワークフロー デザイナーでは、XAML ファイルを正しく読み込めませんでした (ときに、 <xref:System.Activities.Presentation.ViewState.ViewStateData.Id%2A?displayProperty=fullName>行の末尾にある)。  
+  
+-   フローチャート アクティビティ デザイナーまたは他のワークフロー アクティビティ デザイナーで、アタッチされるプロパティの値ではなく既定の場所にすべてのオブジェクトが表示される場合がある。  
+  
+<a name="ClickOnce"></a>   
+### <a name="clickonce"></a>ClickOnce  
+ ClickOnce が更新され、既にサポートされている 1.0 プロトコルに加え、TLS 1.1 と TLS 1.2 がサポートがサポートされるようになりました。 ClickOnce が必要なプロトコルを自動的に検出するため、TLS 1.1 と 1.2 のサポートを有効にするために、ClickOnce アプリケーション内での追加の手順は不要です。  
+  
+<a name="UWPConvert"></a>   
+### <a name="converting-windows-forms-and-wpf-apps-to--uwp-apps"></a>Windows フォームおよび WPF アプリの UWP アプリへの変換  
+ Windows では、WPF および Windows フォーム アプリを含む、既存の Windows デスクトップ アプリを UWP (ユニバーサル Windows プラットフォーム) で使用できるようになりました。 このテクノロジはブリッジとして機能し、既存のコード ベースを段階的に UWP に移行し、アプリをすべての Windows 10 デバイスで使用できるようにします。  
+  
+ 変換後のデスクトップ アプリは UWP アプリのアプリ ID のようなアプリ ID を取得し、UWP API をアクセス可能にして、ライブ タイルや通知などの機能を有効にすることができます。 アプリは引き続き従来どおり動作し、完全信頼アプリとして実行されます。 アプリが変換されたら、アプリ コンテナー プロセスを既存の完全信頼プロセスに追加し、適応ユーザー インターフェイスを追加できます。 すべての機能がアプリ コンテナー プロセスに移行されたら、完全信頼プロセスを削除し、新しい UWP アプリをすべての Windows 10 デバイスで有効にすることができます。  
+  
+<a name="Debug462"></a>   
+### <a name="debugging-improvements"></a>デバッグの機能強化  
+ *アンマネージ デバッグ API*で強化されています、[!INCLUDE[net_v462](../../../includes/net-v462-md.md)]詳細な分析を実行するときに、 <xref:System.NullReferenceException>をソース コードの単一の行には、どの変数が特定されるようにスローされる`null`します。   このシナリオをサポートするために、次の API がアンマネージ デバッグ API に追加されました。  
+  
+-   [ICorDebugCode4](../../../ocs/framework/unmanaged-api/debugging/icordebugcode4-interface.md)、 [ICorDebugVariableHome](../../../ocs/framework/unmanaged-api/debugging/icordebugvariablehome-interface.md)、および[ICorDebugVariableHomeEnum](../../../ocs/framework/unmanaged-api/debugging/icordebugvariablehomeenum-interface.md)インターフェイスで、マネージ変数のネイティブの家を公開します。 これにより、デバッガーはコード フロー分析を実行するときに、 <xref:System.NullReferenceException>が発生したと判断されたネイティブの位置に対応する管理対象の変数に旧バージョンと作業`null`します。  
+  
+-   [ICorDebugType2::GetTypeID](../Topic/ICorDebugType2::GetTypeID%20Method.md)メソッドでは、マッピングを提供する ICorDebugType の[COR_TYPEID](../../../ocs/framework/unmanaged-api/debugging/cor-typeid-structure.md)、これを使用すると、デバッガーは、取得、 [COR_TYPEID](../../../ocs/framework/unmanaged-api/debugging/cor-typeid-structure.md) ICorDebugType のインスタンスなし。 既存の Api [COR_TYPEID](../../../ocs/framework/unmanaged-api/debugging/cor-typeid-structure.md)型のクラス レイアウトを決定し、使用できます。  
+  
+<a name="v461"></a>   
+## <a name="whats-new-in-the-net-framework-461"></a>.NET Framework 4.6.1 の新機能  
+ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] には、次の領域における新機能が含まれています。  
+  
+-   [暗号化](#Crypto)  
+  
+-   [ADO.NET](#ADO.NET461)  
+  
+-   [Windows Presentation Foundation (WPF)](#WPF461)  
+  
+-   [Windows Workflow Foundation](#WWF461)  
+  
+-   [プロファイリング](#Profile461)  
+  
+-   [NGen](#NGEN461)  
+  
+ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] の詳細については、次のトピックを参照してください。  
+  
+-   [変更の .NET Framework 4.6.1 一覧](http://go.microsoft.com/fwlink/?LinkId=622964)  
+  
+-   [4.6.1 アプリケーションの互換性](../../../docs/framework/migration-guide/application-compatibility-in-the-net-framework-4-6-1.md)  
+  
+-   [.NET Framework API の相違](http://go.microsoft.com/fwlink/?LinkId=622989)(GitHub) に  
+  
+<a name="Crypto"></a>   
+### <a name="cryptography-support-for-x509-certificates-containing-ecdsa"></a>暗号化: ECDSA を含む X509 証明書のサポート  
+ .NET Framework 4.6 では、X509 証明書の RSACng サポートが追加されました。 [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] では、ECDSA (Elliptic Curve Digital Signature Algorithm: 楕円曲線デジタル署名アルゴリズム) X509 証明書のサポートが追加されました。  
+  
+ ECDSA は、RSA よりも安全な暗号化アルゴリズムで、パフォーマンスも向上するため、トランスポート層セキュリティ (TLS) のパフォーマンスとスケーラビリティが問題になる場合に最適な選択肢です。 .NET Framework の実装では、既存の Windows 機能の呼び出しがラップされます。  
+  
+ 次のサンプル コードでは、[!INCLUDE[net_v461](../../../includes/net-v461-md.md)] での新しい ECDSA X509 証明書のサポートを使用してバイト ストリームの署名が簡単に生成できることを示しています。  
+  
+ [!code-csharp[whatsnew.461.crypto#1](../../../samples/snippets/csharp/VS_Snippets_CLR/whatsnew.461.crypto/cs/Code46.cs#1)]
+ [!code-vb[whatsnew.461.crypto#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/whatsnew.461.crypto/vb/Code461.vb#1)]  
+  
+ このコードは、.NET Framework 4.6 での署名の生成に必要な次のコードとは大きく異なっています。  
+  
+ [!code-csharp[whatsnew.461.crypto#2](../../../samples/snippets/csharp/VS_Snippets_CLR/whatsnew.461.crypto/cs/Code46.cs#2)]
+ [!code-vb[whatsnew.461.crypto#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/whatsnew.461.crypto/vb/Code46.vb#2)]  
+  
+<a name="ADO.NET461"></a>   
+### <a name="adonet"></a>ADO.NET  
+ 次のものが ADO.NET に追加されました。  
+  
+ ハードウェア保護キーに対する Always Encrypted のサポート  
+ ADO.NET では、Always Encrypted 列 (常に暗号化される列) のマスター キーをハードウェア セキュリティ モジュール (HSM) に格納することが、ネイティブでサポートされるようになりました。 このサポートによって、ユーザーは、HSM に格納された非対称キーを利用できます。カスタムの列マスター キー ストア プロバイダーを作成してからアプリケーションに登録する必要はありません。  
+  
+ HSM に格納された列マスター キーで保護された Always Encrypted データにアクセスするには、HSM ベンダー提供の CSP プロバイダーまたは CNG キー ストア プロバイダーをアプリ サーバーまたはクライアント コンピューターにインストールする必要があります。  
+  
+ 向上<xref:System.Data.SqlClient.SqlConnectionStringBuilder.MultiSubnetFailover%2A> AlwaysOn の接続の動作  
+ SqlClient で、AlwaysOn 可用性グループ (AG) へのより高速な接続が自動的に提供されるようになりました。 SqlClient では、アプリケーションが別のサブネット上の AlwaysOn 可用性グループ (AG) に接続しているかどうかを自動的に検出し、現在のアクティブなサーバーを迅速に探索し、そのサーバーへの接続を提供します。 このリリースよりも前は、アプリケーションで接続文字列を設定し、`“MultisubnetFailover=true”` を含め、AlwaysOn 可用性グループに接続されていることを示す必要がありました。 `true` への接続キーワードを設定しないと、アプリケーションで AlwaysOn 可用性グループに接続中にタイムアウトが発生する可能性がありました。 アプリケーションではこのリリースで*いない*を設定する必要がある<xref:System.Data.SqlClient.SqlConnectionStringBuilder.MultiSubnetFailover%2A>に`true`できなくなります。 Always On 可用性グループに対する SqlClient サポートの詳細については、次を参照してください。[高可用性、災害復旧のための SqlClient サポート](../../../docs/framework/data/adonet/sql/sqlclient-support-for-high-availability-disaster-recovery.md)します。  
+  
+<a name="WPF461"></a>   
+### <a name="windows-presentation-foundation-wpf"></a>Windows Presentation Foundation (WPF)  
+ Windows Presentation Foundation には、さまざまな改善と変更が含まれています。  
+  
+ パフォーマンスの向上  
+ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] で、タッチ イベントの開始の遅延が修正されました。 さらに、入力、 <xref:System.Windows.Controls.RichTextBox>コントロールが不要になった高速の入力時にレンダリング スレッドを占有します。  
+  
+ スペル チェック機能の改善  
+ WPF のスペル チェック機能が、追加の言語のスペル チェックのためにオペレーティング システムのサポートを利用するように、Windows 8.1 以降のバージョンで更新されました。  Windows 8.1 よりも前の Windows バージョンの機能の変更はありません。  
+  
+ 以前のバージョンの .NET Framework の言語と同様に、 <xref:System.Windows.Controls.TextBox>かを制御<xref:System.Windows.Controls.RichTextBox>ブロックが次の順序で情報を探すことによって検出されました。  
+  
+-   `xml:lang` (存在する場合)。  
+  
+-   現在の入力言語。  
+  
+-   現在のスレッド カルチャ。  
+  
+ WPF でサポートされる言語の詳細については、次を参照してください。、 [WPF のブログ投稿については、.NET Framework 4.6.1 機能](http://go.microsoft.com/fwlink/?LinkID=691819)です。  
+  
+ ユーザーごとのユーザー辞書の追加サポート  
+ [!INCLUDE[net_v461](../../../includes/net-v461-md.md)] では、WPF で、グローバルに登録されているユーザー辞書が認識されます。 この機能は、ユーザー辞書をコントロールごとに登録する機能に加えて使用できます。  
+  
+ 以前のバージョンの WPF では、ユーザー辞書で除外された単語とオートコレクト リストが認識されませんでした。 `%AppData%\Microsoft\Spelling\<language tag>` ディレクトリに配置できるファイルの使用によって、これらが Windows 8.1 と Windows 10 でサポートされます。  これらのファイルには、次の規則が適用されます。  
+  
+-   これらのファイルには、拡張子の .dic (追加された単語の場合)、.exc (除外された単語の場合)、または .acl (オートコレクトの場合) が付いている必要があります。  
+  
+-   これらのファイルは、バイト オーダー マーク (BOM) で始まる UTF-16 LE プレーン テキストである必要があります。  
+  
+-   各行があります (追加と除外された単語のリストにある) に含まれる単語または、縦棒で区切られた単語と、オート コレクトの組み合わせ ("|")で、自動修正候補の一覧)。  
+  
+-   これらのファイルは読み取り専用と見なされ、システムによって変更されることはありません。  
+  
+> [!NOTE]
+>  これらの新しいファイル形式は、WPF スペル チェック API で直接サポートされるわけではありません。また、アプリケーションで WPF に提供されるユーザー辞書では以前と同様に .lex ファイルを使用する必要があります。  
+  
+ サンプル  
+ 数がある[WPF サンプル](https://msdn.microsoft.com/library/ms771633.aspx)MSDN にします。 移動されます (その使用法に基づく) 最も人気のあるサンプルの 200 を超える、[オープン ソースの GitHub リポジトリ](https://github.com/Microsoft/WPF-Samples)します。 プル要求またはオープンを送信することで、サンプルの改善にご協力を[GitHub 問題](https://github.com/Microsoft/WPF-Samples/issues)します。  
+  
+ DirectX の拡張機能  
+ WPF には、 [NuGet パッケージ](http://go.microsoft.com/fwlink/?LinkID=691342)の新しい実装を提供する<xref:System.Windows.Interop.D3DImage>をやすく DX10 および Dx11 と相互運用するためのコンテンツ。 コードは、このパッケージが開かれているために発生する場所し、が利用可能な[github](https://github.com/Microsoft/WPFDXInterop)します。  
+  
+<a name="WWF461"></a>   
+### <a name="windows-workflow-foundation-transactions"></a>Windows Workflow Foundation: トランザクション  
+ <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A?displayProperty=fullName>メソッドに、トランザクションを昇格させる MSDTC 以外の分散トランザクション マネージャーを使用できます。 新しい GUID トランザクション プロモーター識別子を指定して、これを行う<xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%28System.Transactions.IPromotableSinglePhaseNotification%2CSystem.Guid%29?displayProperty=fullName>オーバー ロードします。 この操作が成功すると、そのトランザクションの機能に制限が加えられます。 次のメソッドがスローする非 MSDTC トランザクション プロモーターが参加すると、 <xref:System.Transactions.TransactionPromotionException>これらのメソッドは、MSDTC への昇格を必要とするため。  
+  
+-   <xref:System.Transactions.Transaction.EnlistDurable%2A?displayProperty=fullName>  
+  
+-   <xref:System.Transactions.TransactionInterop.GetDtcTransaction%2A?displayProperty=fullName>  
+  
+-   <xref:System.Transactions.TransactionInterop.GetExportCookie%2A?displayProperty=fullName>  
+  
+-   <xref:System.Transactions.TransactionInterop.GetTransmitterPropagationToken%2A?displayProperty=fullName>  
+  
+ MSDTC 以外のトランザクション プロモーターが登録されると、そのプロモーターで定義するプロトコルを使用することで、そのプロモーターをその後の永続参加リストに使用する必要があります。 <xref:System.Guid>を使用して、トランザクションのプロモーターを取得できます、 <xref:System.Transactions.Transaction.PromoterType%2A>プロパティです。 ときに、トランザクションを促進、トランザクション プロモーター提供、<xref:System.Byte>昇格したトークンを表す配列。 アプリケーションでの非 MSDTC 昇格されたトランザクションの昇格したトークンを取得する、 <xref:System.Transactions.Transaction.GetPromotedToken%2A>メソッドです。  
+  
+ 新しいユーザー <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%28System.Transactions.IPromotableSinglePhaseNotification%2CSystem.Guid%29?displayProperty=fullName>オーバー ロードが、昇格操作が正常に完了するために特定の呼び出し順序に従う必要があります。 これらの規則は、メソッドのドキュメントに記載されています。  
+  
+<a name="Profile461"></a>   
+### <a name="profiling"></a>プロファイル  
+ アンマネージ プロファイル API が、次のように拡張されました。  
+  
+ Pdb へのアクセスのサポートの強化、 [ICorProfilerInfo7](../../../ocs/framework/unmanaged-api/profiling/icorprofilerinfo7-interface.md)インターフェイス  
+ ASP.NET 5 では、アセンブリがメモリ内で Roslyn によってコンパイルされることがよりいっそう一般的になっています。 プロファイル ツールを作成する開発者にとって、これは従来ディスクにシリアル化されていた PDB が存在しなくなる可能性があることを意味しています。 プロファイル ツールでは、多くの場合 PDB を使用して、コード カバレッジや&1; 行単位のパフォーマンス分析などのタスクのソース行に、コードをマップし戻します。 [ICorProfilerInfo7](../../../ocs/framework/unmanaged-api/profiling/icorprofilerinfo7-interface.md)インターフェイスは、2 つの新しいメソッド[ICorProfilerInfo7::GetInMemorySymbolsLength](../Topic/ICorProfilerInfo7::GetInMemorySymbolsLength%20Method.md)と[ICorProfilerInfo7::ReadInMemorySymbols](../Topic/ICorProfilerInfo7::ReadInMemorySymbols.md)メモリ内の PDB データへのアクセスにこれらのプロファイラー ツールを提供する新しい Api を使用すると、プロファイラーことができますをバイト配列として、メモリ内の pdb ファイルの内容を取得し、それを処理またはディスクにシリアル化します。  
+  
+ ICorProfiler インターフェイスを使用したインストルメンテーションの改良  
+ 動的インストルメンテーションに `ICorProfiler` API の ReJit 機能を使用しているプロファイラーで、いくつかのメタデータを変更できるようになりました。 従来、このようなツールでは、いつでも IL をインストルメント化できましたが、メタデータを変更できるのはモジュールを読み込む時だけでした。 IL はメタデータを参照するため、実行できるインストルメンテーションの種類が限られています。 追加することでこれらの制限の一部の廃止して、 [ICorProfilerInfo7::ApplyMetaData](../Topic/ICorProfilerInfo7::ApplyMetaData%20Method.md)モジュールが読み込まれた後、具体的には新規に追加して、メタデータの編集のサブセットをサポートするためにメソッド`AssemblyRef`、 `TypeRef`、 `TypeSpec`、 `MemberRef`、 `MemberSpec`、および`UserString`レコードです。 この変更により、はるかに広範な実行時インストルメンテーションが可能になります。  
+  
+<a name="NGEN461"></a>   
+### <a name="native-image-generator-ngen-pdbs"></a>ネイティブ イメージ ジェネレーター (NGEN) PDB  
+ マシン間のイベント トレースを使用すれば、ユーザーはマシン A 上でプログラムのプロファイリングを行い、マシン B 上でソース行のマッピングを使用して、プロファイリング データを確認できます。以前のバージョンの.NET Framework を使用する場合、ソースからネイティブへのマッピングを作成するには、ユーザーは、プロファイルされたコンピューターにあるすべてのモジュールとネイティブ イメージを、IL PDB が含まれた分析用コンピューターにコピーする必要がありました。 この処理は、Phone アプリケーションなどファイル サイズが比較的小さい場合には高速に実行されますが、これらのファイルのサイズがデスクトップ システム上で非常に大きくなる可能性があり、その場合コピーにかなりの時間を要する可能性があります。  
+  
+ NGen PDB を使用すれば、IL PDB に依存することなく、NGen で IL からネイティブへのマッピングが含まれた PDB を作成できます。 コンピューター B にコンピューター A によって生成される PDB のネイティブ イメージをコピーし、使用するには必要なは、シナリオでは、コンピューター間のイベント トレース、[インターフェイス Api へのアクセスでデバッグ](https://msdn.microsoft.com/en-us/library/ee8x173s.aspx)IL PDB のソースの IL のマッピングとネイティブ イメージ PDB の IL からネイティブへのマッピングを読み取れません。 両方のマッピングを組み合わせることで、ソースからネイティブへのマッピングが実現します。 ネイティブ イメージの PDB は、どのモジュールとネイティブ イメージよりもはるかにサイズが小さいため、コンピューター A からコンピューター B へのコピーの処理は非常に高速になります。  
+  
+<a name="v46"></a>   
+## <a name="whats-new-in-net-2015"></a>.NET 2015 の新機能  
+ .NET 2015 では、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] と .NET Core が導入されています。 一部の新機能はその両方に適用され、その他の機能は [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] または [!INCLUDE[net_core](../../../includes/net-core-md.md)] に固有です。  
+  
+-   **ASP.NET 5**  
+  
+     .NET 2015 には、ASP.NET 5 が含まれています。これは、最新のクラウド ベースのアプリを構築するのに非常に効率の良い .NET プラットフォームです。 このプラットフォームはモジュール形式であるため、アプリケーションで必要な機能のみを含めることができます。 IIS でホストすることも、カスタムのプロセスでセルフホストすることもできます。さらに同じサーバー上のさまざまなバージョンの .NET Framework でアプリを実行することも可能です。 クラウド展開用に設計されている新たな環境構成システムが含まれています。  
+  
+     MVC、Web API、および Web ページは、MVC 6 と呼ばれる 1 つのフレームワークに統合されています。 Visual Studio 2015 の新しいツールで ASP.NET 5 アプリをビルドします。 既存のアプリケーションは、この新しい .NET Framework で動作しますが、MVC 6 または SignalR 3 を使用するアプリケーションをビルドするには Visual Studio 2015 のプロジェクト システムを使用する必要があります。  
+  
+     詳細については、次を参照してください。 [ASP.NET 5](http://go.microsoft.com/fwlink/?LinkId=518238)します。  
+  
+-   **ASP.NET の更新プログラム**  
+  
+    -   **非同期応答のフラッシュのタスクベースの API**  
+  
+         ASP.NET では、非同期応答をフラッシュする簡単なタスクベースの API ようになりましたが用意されています<xref:System.Web.HttpResponse.FlushAsync%2A?displayProperty=fullName>、言語を使用して非同期的にフラッシュするへの応答を許可する`async/await`をサポートします。  
+  
+    -   `Model binding supports task-returning methods`  
+  
+         [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、Web フォーム ページやユーザー コントロールでの CRUD ベースのデータ操作に対して拡張可能なコード中心のアプローチを可能にするモデル バインド機能が ASP.NET に追加されました。 モデル バインド システムになりました<xref:System.Threading.Tasks.Task>-モデル バインディングのメソッドを取得します。 この機能により、Web フォーム開発者は Entity Framework などの ORM の新しいバージョンを使用するときに、データ バインド システムのように簡単に非同期のスケーラビリティ上のメリットを得ることができます。  
+  
+         非同期モデル バインドは、`aspnet:EnableAsyncModelBinding` 構成設定によって制御されます。  
+  
+        ```  
+  
+        <appSettings>  
+           <add key=" aspnet:EnableAsyncModelBinding" value="true|false" />  
+        </appSettings>  
+  
+        ```  
+  
+         [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を対象とするアプリでは、既定で `true` になります。 [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で実行され、.NET Framework の以前のバージョンを対象とするアプリでは、既定で `false` になります。 有効にするには、この構成設定を `true` に設定します。  
+  
+    -   **Http/2 のサポート (Windows 10)**  
+  
+         [Http/2](http://www.wikipedia.org/wiki/HTTP/2)程度接続使用率の向上 (より少ない、ラウンドト リップ クライアントとサーバー間) を提供する HTTP プロトコルの新しいバージョンの下の待機時間 web ページを読み込むときのユーザーに結果ができます。  このプロトコルは単一のエクスペリエンスの一部として要求さる複数の成果物のために最適化されているので、HTTP/2 が最も役立つのは (サービスではなく) web ページです。 .NET Framework 4.6 では、HTTP/2 のサポートが ASP.NET に追加されました。 ネットワーク機能は複数のレイヤーで存在するので、HTTP/2 を有効にするために、Windows、IIS、および ASP.NET で新機能が必要とされていました。 ASP.NET で HTTP/2 を使用するには、Windows 10 を実行している必要があります。  
+  
+         Http/2 がサポートされてに既定で windows 10 ユニバーサル Windows プラットフォーム (UWP) アプリを使用する、 <xref:System.Net.Http.HttpClient?displayProperty=fullName> API です。  
+  
+         使用する方法を提供するために、 [PUSH_PROMISE](http://http2.github.io/http2-spec/#PUSH_PROMISE)機能の ASP.NET アプリケーションでは、2 つのオーバー ロードを持つ新しいメソッドで<xref:System.Web.HttpResponse.PushPromise%28System.String%29>と<xref:System.Web.HttpResponse.PushPromise%28System.String%2CSystem.String%2CSystem.Collections.Specialized.NameValueCollection%29>に追加されて、 <xref:System.Web.HttpResponse>クラスです。  
+  
+        > [!NOTE]
+        >  ASP.NET 5 では HTTP/2 がサポートされましたが、PUSH PROMISE 機能のサポートはまだ追加されていません。  
+  
+         ブラウザーと web サーバー (Windows 上の IIS) がすべての処理を実行します。 ユーザーの側で複雑な操作を実行する必要はありません。  
+  
+         ほとんどの[主なブラウザーは http/2 をサポート](http://www.wikipedia.org/wiki/HTTP/2)できると考え、ユーザーは http/2 のサポートの場合は、サーバーでサポートされているので、します。  
+  
+    -   **トークン バインディング プロトコルのサポート**  
+  
+         Microsoft と Google と呼ばれる、認証のための新しい手法に取り組んできました、[トークン バインディング プロトコル](https://github.com/TokenBinding/Internet-Drafts)します。 (ブラウザー キャッシュ) 内の認証トークンの盗難にあったし、パスワードやその他の特別な情報を必要とせず、それ以外の場合にセキュリティで保護されたリソース (銀行口座など) にアクセスする犯罪者が使用されることはできます。 新しいプロトコルは、この問題を軽減することを目指しています。  
+  
+         トークン バインディング プロトコルは、Windows 10 でブラウザーの機能として実装されます。 ASP.NET アプリは、認証トークンの正当性が検証されるように、このプロトコルに参加します。 クライアントとサーバーの実装は、プロトコルによって指定されるエンド ツー エンドの保護を確立します。  
+  
+    -   **ランダム化された文字列のハッシュ アルゴリズム**  
+  
+         導入された .NET Framework 4.5、[ランダム化された文字列のハッシュ アルゴリズム](https://msdn.microsoft.com/library/jj152924.aspx)します。 しかし、ASP.NET の一部の機能は安定したハッシュ コードに依存していたため、この機能は ASP.NET ではサポートされませんでした。 [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] では、ランダムな文字列のハッシュ アルゴリズムがサポートされるようになりました。 この機能を有効にするには、`aspnet:UseRandomizedStringHashAlgorithm` 構成設定を使用します。  
+  
+        ```  
+  
+        <appSettings>  
+           <add key="aspnet:UseRandomizedStringHashAlgorithm" value="true|false" />  
+        </appSettings>  
+  
+        ```  
+  
+-   **ADO.NET**  
+  
+     ADO .NET では、SQL Server 2016 Community Technology Preview 2 (CTP2) で使用できる Always Encrypted 機能がサポートされました。 SQL Server は、Always Encrypted 機能を使用して、暗号化されたデータに対して操作を実行できます。特に、サーバー上ではなく、ユーザーが信頼している環境内にアプリケーションと共に暗号化キーを保存できるようになりました。 Always Encrypted でユーザー データが保護されるので、DBA はプレーン テキスト データにアクセスできません。 データの暗号化と復号化は、ドライバー レベルで透過的に行われるので、既存のアプリケーションに対する変更が最小限に抑えられます。 詳細については、「 [(データベース エンジン) を常に暗号化](https://msdn.microsoft.com/library/mt163865\(v=sql.130\).aspx)と[(クライアント開発) 常に暗号化](https://msdn.microsoft.com/library/mt147923\(v=sql.130\).aspx)します。  
+  
+-   **マネージ コードの&64; ビット JIT コンパイラ**  
+  
+     .NET Framework 4.6 の特徴の 1 つとして、新しいバージョンの 64 ビット JIT コンパイラ (RyuJIT というコードネームで呼ばれていたもの) があります。 この新しい 64 ビット コンパイラは、これまでの 64 ビット JIT コンパイラよりもパフォーマンスが大幅に向上しています。 新しい 64 ビット コンパイラは、.NET Framework 4.6 上で実行される 64 ビット プロセスで有効になります。 64 ビットまたは AnyCPU としてコンパイルされ、64 ビット オペレーティング システム上で実行されるアプリは、64 ビットで動作します。 新しいコンパイラへの移行をできる限り透過的に行うように注意を払いましたが、動作の変更が発生する可能性があります。 新しい JIT コンパイラの使用中に発生した問題については、直接お聞かせいただければと思います。 お問い合わせください[Microsoft Connect](http://connect.microsoft.com/)新しい 64 ビット JIT コンパイラに関連する可能性のある問題が発生した場合。  
+  
+     新しい 64 ビット JIT コンパイラが SIMD が有効な型と組み合わせると、ハードウェア SIMD アクセラレータ機能にはも含まれています、 <xref:System.Numerics>名前空間は、良好なパフォーマンス向上をもたらすことができます。  
+  
+-   **アセンブリ ローダーの機能強化**  
+  
+     アセンブリ ローダーで、対応する NGEN イメージの読み込み後に IL アセンブリをアンロードすることにより、メモリがより効率的に使用されるようになりました。 この変更は、仮想メモリが減少するため、特に大規模な 32 ビット アプリ (Visual Studio など) で有益であり、物理メモリの節約にもなります。  
+  
+-   **基本クラス ライブラリの変更点**  
+  
+     主なシナリオを利用できるようにするため、多くの新しい API が [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] に関連して追加されました。 変更点と追加点を以下に示します。  
+  
+    -   **IReadOnlyCollection<> \</> \>の実装**  
+  
+         追加のコレクションを実装<xref:System.Collections.Generic.IReadOnlyCollection%601>など<xref:System.Collections.Generic.Queue%601>と<xref:System.Collections.Generic.Stack%601>します。  
+  
+    -   **CultureInfo.CurrentCulture と CultureInfo.CurrentUICulture**  
+  
+         <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName>と<xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName>プロパティが読み取り/書き込みではなく読み取り専用になりました。 新しいを割り当てる場合<xref:System.Globalization.CultureInfo>オブジェクトで定義されている現在のスレッド カルチャのこれらのプロパティを`Thread.CurrentThread.CurrentCulture`プロパティと現在の UI スレッド カルチャによって定義された、`Thread.CurrentThread.CurrentUICulture`プロパティも変更します。  
+  
+    -   **ガベージ コレクション (GC) の機能強化**  
+  
+         <xref:System.GC>クラスが含まれています<xref:System.GC.TryStartNoGCRegion%2A>と<xref:System.GC.EndNoGCRegion%2A>メソッドがクリティカル パスの実行中にガベージ コレクションを不許可にできます。  
+  
+         新しいオーバー ロード、 <xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%2CSystem.Boolean%2CSystem.Boolean%29?displayProperty=fullName>メソッドを制御できる小さなオブジェクト ヒープと大きなオブジェクト ヒープの両方に関して、スイープし圧縮、スイープのみを行うかどうか。  
+  
+    -   **SIMD が有効な型**  
+  
+         <xref:System.Numerics>名前空間は、さまざまな種類の SIMD が有効ななど<xref:System.Numerics.Matrix3x2>、 <xref:System.Numerics.Matrix4x4>、<xref:System.Numerics.Plane>、<xref:System.Numerics.Quaternion>、 <xref:System.Numerics.Vector2>、 <xref:System.Numerics.Vector3>、および<xref:System.Numerics.Vector4>します。  
+  
+         新しい 64 ビット JIT コンパイラにはハードウェア SIMD アクセラレータ機能も含まれているため、新しい 64 ビット JIT コンパイラで SIMD 対応の型を使用すると、パフォーマンスが大幅に向上します。  
+  
+    -   **暗号の更新**  
+  
+         <xref:System.Security.Cryptography?displayProperty=fullName> API がサポートするために更新される、 [Windows CNG 暗号化 Api](https://msdn.microsoft.com/library/windows/desktop/aa376214.aspx)します。 .NET Framework の以前のバージョンを完全に利用して、[以前のバージョンの Windows 暗号化 Api](https://msdn.microsoft.com/library/windows/desktop/aa380255.aspx)を基準として、 <xref:System.Security.Cryptography?displayProperty=fullName>実装します。 サポートしているので、CNG API をサポートするためにリクエスト[近代暗号アルゴリズム](https://msdn.microsoft.com/library/windows/desktop/bb204775.aspx#suite_b_support)、特定のカテゴリのアプリケーションにとって重要であります。  
+  
+         .NET Framework 4.6 には、Windows CNG 暗号化 API をサポートするために、次の新しい機能強化が含まれています。  
+  
+        -   可能な場合に CAPI ベースの実装ではなく CNG ベースの実装を返す X509 証明書用の一連の拡張メソッド `System.Security.Cryptography.X509Certificates.RSACertificateExtensions.GetRSAPublicKey(System.Security.Cryptography.X509Certificates.X509Certificate2)` および `System.Security.Cryptography.X509Certificates.RSACertificateExtensions.GetRSAPrivateKey(System.Security.Cryptography.X509Certificates.X509Certificate2)`  (一部のスマート カードなどでは現在も CAPI が必要であり、API がフォールバックを処理します)。  
+  
+        -   <xref:System.Security.Cryptography.RSACng?displayProperty=fullName>クラスで、RSA アルゴリズムの CNG の実装を提供します。  
+  
+        -   一般的な操作でキャストを不要にする RSA API の機能強化。 たとえばを使用してデータの暗号化、 <xref:System.Security.Cryptography.X509Certificates.X509Certificate2>オブジェクトには、.NET Framework の以前のバージョンでは、次のようなコードが必要です。  
+  
+             [!code-csharp[WhatsNew.Casting#1](../../../samples/snippets/csharp/VS_Snippets_CLR/whatsnew.casting/cs/program.cs#1)]
+             [!code-vb[WhatsNew.Casting#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/whatsnew.casting/vb/module1.vb#1)]  
+  
+             .NET Framework 4.6 で新しい暗号化を使用するコードは、次のように書き換えてキャストを回避することができます。  
+  
+             [!code-csharp[WhatsNew.Casting#2](../../../samples/snippets/csharp/VS_Snippets_CLR/whatsnew.casting/cs/program.cs#2)]
+             [!code-vb[WhatsNew.Casting#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/whatsnew.casting/vb/module1.vb#2)]  
+  
+    -   **日付と時刻の変換と Unix 時間の間のサポート**  
+  
+         次のメソッドに追加された、 <xref:System.DateTimeOffset>と Unix 時間の間に、日付と時刻の値を変換をサポートする構造体。  
+  
+        -   <xref:System.DateTimeOffset.FromUnixTimeSeconds%2A?displayProperty=fullName>  
+  
+        -   <xref:System.DateTimeOffset.FromUnixTimeMilliseconds%2A?displayProperty=fullName>  
+  
+        -   <xref:System.DateTimeOffset.ToUnixTimeSeconds%2A?displayProperty=fullName>  
+  
+        -   <xref:System.DateTimeOffset.ToUnixTimeMilliseconds%2A?displayProperty=fullName>  
+  
+    -   **互換性スイッチ**  
+  
+         新しい<xref:System.AppContext>クラス ライブラリの作成者のユーザーの新機能の統一されたオプトアウト メカニズムを提供するようにする新しい互換性機能を追加します。 これは、オプトアウト要求を伝達するために、コンポーネント間に疎結合のコントラクトを確立します。 通常、この機能は既存の機能が変更されるときに重要となります。 それに対して、新しい機能には暗黙のオプトインが既に存在しています。  
+  
+         <xref:System.AppContext>ライブラリは、定義、およびそれらに依存するコードの中に、公開の互換性スイッチがライブラリの動作に影響するこれらのスイッチを設定できます。 ライブラリは、既定では新しい機能を提供し、スイッチが設定されている場合のみそれを変更する (つまり以前の機能を提供する) ことができます。  
+  
+         アプリケーション (またはライブラリ) は、スイッチの値を宣言できます (これは常に、<xref:System.Boolean>値)、依存するライブラリを定義します。 スイッチは常に暗黙的に `false` です。 スイッチを `true` に設定すると、それが有効になります。 スイッチを明示的に `false` に設定すると、新しい動作が提供されます。  
+  
+        ```csharp  
+        AppContext.SetSwitch("Switch.AmazingLib.ThrowOnException", true);  
+        ```  
+  
+         ライブラリは、コンシューマーがスイッチの値を宣言したことを確認してから、それを適切に実行する必要があります。  
+  
+        ```  
+  
+        if (!AppContext.TryGetSwitch("Switch.AmazingLib.ThrowOnException", out shouldThrow))   
+        {  
+           // This is the case where the switch value was not set by the application.   
+           // The library can choose to get the value of shouldThrow by other means.   
+           // If no overrides nor default values are specified, the value should be 'false'.   
+           // A false value implies the latest behavior.  
+        }  
+  
+           // The library can use the value of shouldThrow to throw exceptions or not.  
+           if (shouldThrow)   
+           {  
+              // old code  
+           }  
+           else {  
+              // new code  
+           }  
+        }  
+  
+        ```  
+  
+         スイッチは、ライブラリによって公開される正式なコントラクトであるため、一貫性のある形式を使用することをお勧めします。 2 つの明確な形式を次に示します。  
+  
+        -   *Switch*.*名前空間*.*switchname*  
+  
+        -   *Switch*.*library*.*switchname*  
+  
+    -   **タスク ベースの非同期パターン (TAP) への変更**  
+  
+         対象とするアプリに対して、 [!INCLUDE[net_v46](../../../includes/net-v46-md.md)]、<xref:System.Threading.Tasks.Task>と<xref:System.Threading.Tasks.Task%601>オブジェクトのカルチャと、呼び出し元スレッドの UI カルチャを継承します。 以前のバージョンの .NET Framework をターゲットするとアプリまたは特定のバージョンの .NET Framework をターゲットとしないアプリの動作には影響を及ぼしません。 詳細については、の「カルチャとタスク ベースの非同期操作」セクションを参照して、 <xref:System.Globalization.CultureInfo>クラスに関するトピック。  
+  
+         <xref:System.Threading.AsyncLocal%601?displayProperty=fullName>クラスを使用するなど、特定の非同期制御フローに対してローカルなアンビエント データを表すため、`async`メソッドです。 これは、スレッド間でデータを保持するために使用できます。 アンビエント データではいずれかが変更されるためされるたびに通知されるコールバック メソッドを定義することも、 <xref:System.Threading.AsyncLocal%601.Value%2A?displayProperty=fullName>プロパティが明示的に変更された、またはスレッドにコンテキストの遷移が発生したためです。  
+  
+         次の&3; つの便利なメソッド<xref:System.Threading.Tasks.Task.CompletedTask%2A?displayProperty=fullName>、 <xref:System.Threading.Tasks.Task.FromCanceled%2A?displayProperty=fullName>、および<xref:System.Threading.Tasks.Task.FromException%2A?displayProperty=fullName>、タスクベースの非同期パターン (TAP) を特定の状態で完了したタスクを返すに追加されました。  
+  
+         <xref:System.IO.Pipes.NamedPipeClientStream>クラスは、今すぐとその新しいの非同期通信をサポートしています<xref:System.IO.Pipes.NamedPipeClientStream.ConnectAsync%2A>します。 メソッドをオーバーライドします。  
+  
+    -   **EventSource は、イベント ログへの書き込みをサポートします。**  
+  
+         今すぐ使用できる、 <xref:System.Diagnostics.Tracing.EventSource>をコンピューターに作成、既存の ETW セッションにさらに、管理や運用ログにクラスがメッセージをイベント ログです。 以前は、この機能のために Microsoft.Diagnostics.Tracing.EventSource NuGet パッケージを使用する必要がありました。 この機能は .NET Framework 4.6 に組み込まれました。  
+  
+         NuGet パッケージと .NET Framework 4.6 は、どちらも次の機能によって更新されています。  
+  
+        -   **動的イベント**  
+  
+             イベント メソッドを作成せずに、実行時にイベントを定義できます。  
+  
+        -   **リッチ ペイロード**  
+  
+             特別な属性が指定されたクラスや配列に加えて、プリミティブ型もペイロードとして渡すことができます。  
+  
+        -   **動作状況の追跡**  
+  
+             Start イベントと Stop イベントの間のイベントに、現在アクティブなすべてのアクティビティを表す ID が付けられます。  
+  
+         これらをサポートする機能が、オーバー ロードされた<xref:System.Diagnostics.Tracing.EventSource.Write%2A>にメソッドが追加されて、 <xref:System.Diagnostics.Tracing.EventSource>クラスです。  
+  
+-   **Windows Presentation Foundation (WPF)**  
+  
+    -   **HDPI 機能強化**  
+  
+         [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] では、WPF での HDPI サポートが強化されました。 境界があるコントロールでのクリッピングの発生を減らすため、レイアウトの丸め処理が変更されました。 既定では、この機能が有効になっている場合にのみ、 <xref:System.Runtime.Versioning.TargetFrameworkAttribute> .NET 4.6 に設定されています。  以前のバージョンの framework を対象と、上で実行されているアプリケーション、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]次の行を追加することで、新しい動作をオプトインできます、 [ <> \> ](../../../docs/framework/configure-apps/file-schema/runtime/runtime-element.md) app.config ファイルのセクション。  
+  
+        ```  
+  
+        <AppContextSwitchOverrides  
+        value="Switch.MS.Internal.DoNotApplyLayoutRoundingToMarginsAndBorderThickness=false"  
+        />  
+  
+        ```  
+  
+         異なる DPI 設定を持つ (マルチ DPI セットアップの) 複数のモニターにまたがる WPF ウィンドウは、ブラック アウト領域なしで完全にレンダリングされるようになりました。 この動作の選択を解除するには、app.config ファイルの `<appSettings>` セクションに次の行を追加して、この新しい動作を無効にします。  
+  
+        ```  
+  
+        <add key="EnableMultiMonitorDisplayClipping" value="true"/>  
+  
+        ```  
+  
+         DPI 設定に基づいた正しいカーソルを自動的に読み込むに追加されたサポート<xref:System.Windows.Input.Cursor?displayProperty=fullName>します。  
+  
+    -   **タッチをお勧め**  
+  
+         お客様からの報告[接続](https://connect.microsoft.com/VisualStudio/feedback/details/903760/)で予期しない動作が処理された生成をタッチする、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]です。 Windows 8.1 以降では、Windows ストア アプリケーションと WPF アプリケーションのダブルタップのしきい値が同じになりました。  
+  
+    -   **透過的な子ウィンドウのサポート**  
+  
+         [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] の WPF では、Windows 8.1 以降の透過的な子ウィンドウがサポートされます。 これにより、最上位レベルのウィンドウ内に四角形でない透過的な子ウィンドウを作成できます。 この機能を有効に設定することができます、 <xref:System.Windows.Interop.HwndSourceParameters.UsesPerPixelTransparency%2A?displayProperty=fullName>プロパティを`true`します。  
+  
+-   **Windows Communication Foundation (WCF)**  
+  
+    -   **SSL のサポート**  
+  
+         WCF で、NetTcp をトランスポート セキュリティおよびクライアント認証と共に使用する場合に、SSL のバージョンとして SSL 3.0 および TLS 1.0 に加えて TLS 1.1 および TLS 1.2 がサポートされるようになりました。 使用するプロトコルを選択することも、安全性の低い古いプロトコルを無効化することもできるようになりました。 これを行う設定するか、 <xref:System.ServiceModel.TcpTransportSecurity.SslProtocols%2A>プロパティまたは構成ファイルに、次を追加します。  
+  
+        ```  
+        <netTcpBinding>  
+           <binding>  
+              <security mode= "None|Transport|Message|TransportWithMessageCredential" >  
+                 <transport clientCredentialType="None|Windows|Certificate"  
+                            protectionLevel="None|Sign|EncryptAndSign"  
+                            sslProtocols="Ssl3|Tls1|Tls11|Tls12">  
+                    </transport>  
+              </security>  
+           </binding>  
+        </netTcpBinding>  
+  
+        ```  
+  
+    -   **別の HTTP 接続を使用してメッセージを送信します。**  
+  
+         WCF で、ユーザーが別の基になる HTTP 接続を使用して特定のメッセージを送信できるようになりました。 これには、2 つの方法があります。  
+  
+        -   **接続グループ名のプレフィックスを使用します。**  
+  
+             ユーザーは、WCF で接続グループ名のプレフィックスとして使用される文字列を指定できます。 異なるプレフィックスを持つ&2; つのメッセージは、別の基になる HTTP 接続を使用して送信されます。 メッセージのキー/値ペアを追加することで、プレフィックスを設定する<xref:System.ServiceModel.Channels.Message.Properties%2A?displayProperty=fullName>プロパティです。 キーは、"HttpTransportConnectionGroupNamePrefix"です。値は、目的のプレフィックスです。  
+  
+        -   **異なる種類のチャネル ファクトリを使用します。**  
+  
+             ユーザーは、異なるチャネル ファクトリによって作成されたチャネルを使用して送信されるメッセージで別の基になる HTTP 接続を使用する機能を有効にすることもできます。 この機能を有効にするには、ユーザーが次の `appSetting` を `true` に設定する必要があります。  
+  
+            ```  
+  
+            <appSettings>  
+               <add key="wcf:httpTransportBinding:useUniqueConnectionPoolPerFactory" value="true" />  
+            </appSettings>  
+  
+            ```  
+  
+-   **Windows Workflow Foundation (WWF)**  
+  
+     順序不定の操作要求がタイムアウトする前に未処理の「非プロトコル」ブックマークが存在する場合に、ワークフロー サービスが要求を保持する秒数を指定できるようになりました。 「非プロトコル」ブックマークとは、未処理の Receive アクティビティに関連付けられていないブックマークです。 一部のアクティビティはその実装内で非プロトコル ブックマークを作成するため、必ずしも非プロトコル ブックマークの存在が明らかにわかるとは限りません。 例として State や Pick などがあります。 ステート マシンを使用して実装されたワークフロー サービスや、Pick アクティビティを含むワークフロー サービスがある場合は、非プロトコル ブックマークが存在する可能性が高くなります。 この間隔を指定するには、app.config ファイルの `appSettings` セクションに次のような行を追加します。  
+  
+    ```  
+    <add key="microsoft:WorkflowServices:FilterResumeTimeoutInSeconds" value="60"/>  
+    ```  
+  
+     既定値は 60 秒です。 `value` を 0 に設定すると、順序不定の要求はただちに拒否され、次のようなテキストを含むエラーが返されます。  
+  
+    ```Output  
+    Operation 'Request3|{http://tempuri.org/}IService' on service instance with identifier '2b0667b6-09c8-4093-9d02-f6c67d534292' cannot be performed at this time. Please ensure that the operations are performed in the correct order and that the binding in use provides ordered delivery guarantees.   
+    ```  
+  
+     これは、順序不定の操作メッセージを受信し、非プロトコル ブックマークが存在しない場合に受信するメッセージと同じです。  
+  
+     `FilterResumeTimeoutInSeconds` 要素の値がゼロ以外で、非プロトコル ブックマークが存在し、タイムアウト間隔が終了した場合、その操作は失敗し、タイムアウト メッセージが発生します。  
+  
+-   **トランザクション**  
+  
+     派生した例外を発生させたトランザクションの現在の分散トランザクションの識別子を含めることができます<xref:System.Transactions.TransactionException>がスローされます。 これを行うには、次のキーを app.config ファイルの `appSettings` セクションに追加します。  
+  
+    ```  
+    <add key="Transactions:IncludeDistributedTransactionIdInExceptionMessage" value="true"/>   
+    ```  
+  
+     既定値は `false` です。  
+  
+-   **ネットワーク接続**  
+  
+    -   **ソケットの再利用**  
+  
+         Windows 10 には、送信 TCP 接続のローカル ポートを再利用してコンピューターのリソースを効率的に使用する新しいスケーラビリティの高いネットワーク アルゴリズムが含まれています。 .NET Framework 4.6 では、この新しいアルゴリズムがサポートされ、.NET アプリで新しい動作を利用できます。 以前のバージョンの Windows では、人工的な同時接続の制限 (通常は動的なポート範囲の既定のサイズである 16,384) があったため、負荷がかかったときにポートが使い尽くされ、サービスのスケーラビリティが制限されることがありました。  
+  
+         [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] では、ポートの再利用を有効にする次の 2 つの新しい API が追加され、同時接続に対する 64K の制限が実質的になくなりました。  
+  
+        -   <xref:System.Net.Sockets.SocketOptionName?displayProperty=fullName>列挙値。  
+  
+        -   <xref:System.Net.ServicePointManager.ReusePort%2A?displayProperty=fullName>プロパティです。  
+  
+         既定では、 <xref:System.Net.ServicePointManager.ReusePort%2A?displayProperty=fullName>プロパティは、`false`しない限り、`HWRPortReuseOnSocketBind`の値、`HKLM\SOFTWARE\Microsoft\.NETFramework\v4.0.30319`レジストリ キーが 0x1 に設定します。 HTTP 接続でのローカル ポートの再利用を有効にするには設定、 <xref:System.Net.ServicePointManager.ReusePort%2A?displayProperty=fullName>プロパティを`true`します。 これにより、すべての発信 TCP ソケット接続から<xref:System.Net.Http.HttpClient>と<xref:System.Net.HttpWebRequest>新しい Windows 10 ソケット オプションを使用する[SO_REUSE_UNICASTPORT](https://msdn.microsoft.com/library/windows/desktop/ms740532.aspx)、ローカル ポートを再利用できるようにします。  
+  
+         ソケット専用のアプリケーションを作成する開発者を指定できます、 <xref:System.Net.Sockets.SocketOptionName?displayProperty=fullName>オプションなどのメソッドを呼び出すことと<xref:System.Net.Sockets.Socket.SetSocketOption%2A?displayProperty=fullName>アウト バウンド ソケットのバインド中にローカル ポートを再利用できるようにします。  
+  
+    -   **国際ドメイン名と PunyCode のサポート**  
+  
+         新しいプロパティ<xref:System.Uri.IdnHost%2A>に追加されて、 <xref:System.Uri>サポートを強化する国際ドメイン名と PunyCode クラスです。  
+  
+-   **Windows フォーム コントロールにおけるサイズ変更します。**  
+  
+     この機能が拡張されました[!INCLUDE[net_v46](../../../includes/net-v46-md.md)]に含める、 <xref:System.Windows.Forms.DomainUpDown>、 <xref:System.Windows.Forms.NumericUpDown>、 <xref:System.Windows.Forms.DataGridViewComboBoxColumn>、 <xref:System.Windows.Forms.DataGridViewColumn>と<xref:System.Windows.Forms.ToolStripSplitButton>型と指定された四角形、<xref:System.Drawing.Design.PaintValueEventArgs.Bounds%2A>描画するときに使用されるプロパティ、 <xref:System.Drawing.Design.UITypeEditor>します。  
+  
+     これはオプトイン機能です。 この機能を有効にするには、アプリケーション構成 (app.config) ファイルで `EnableWindowsFormsHighDpiAutoResizing` 要素を `true` に設定します。  
+  
+    ```  
+  
+    <appSettings>  
+       <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  
+    </appSettings>  
+  
+    ```  
+  
+-   **コード ページ エンコーディングのサポート**  
+  
+     [!INCLUDE[net_core](../../../includes/net-core-md.md)] は、本来 Unicode エンコードをサポートし、既定ではコード ページ エンコーディングに関するサポートは限定的です。 サポートされていないが、.NET Framework で使用できるコード ページ エンコーディングのサポートを追加する[!INCLUDE[net_core](../../../includes/net-core-md.md)]使用してコード ページ エンコーディングを登録することによって、 <xref:System.Text.Encoding.RegisterProvider%2A?displayProperty=fullName>メソッドです。 詳細については、次を参照してください。 [System.Text.CodePagesEncodingProvider](https://msdn.microsoft.com/en-us/library/system.text.codepagesencodingprovider.aspx)します。  
+  
+-   **.NET ネイティブ**  
+  
+     [!INCLUDE[net_core](../../../includes/net-core-md.md)] をターゲットとし、c# または Visual Basic で作成されている Windows 10 用の Windows アプリは、IL ではなくネイティブ コードにアプリをコンパイルする新しい技術を活用できます。 これで、起動時間と実行時間がより速いアプリを生成できます。 詳細については、次を参照してください。 [.NET ネイティブによるアプリのコンパイル](../../../docs/framework/net-native/index.md)します。 .NET ネイティブ JIT コンパイルと NGEN による違い、およびどのようなことの概要については、コードの意味を参照してください[.NET ネイティブとコンパイル](../../../docs/framework/net-native/net-native-and-compilation.md)します。  
+  
+     アプリは、Visual Studio 2015 でコンパイルするときに、既定でネイティブ コードにコンパイルされます。 詳細については、次を参照してください。 [.NET ネイティブの概要](../../../docs/framework/net-native/getting-started-with-net-native.md)します。  
+  
+     .NET ネイティブ アプリのデバッグをサポートするため、アンマネージ デバッグ APIに対して数多くの新しいインターフェイスと列挙型が追加されました。 詳細については、次を参照してください。、[デバッグ (アンマネージ API リファレンス)](../../../ml/index.xml)トピックです。  
+  
+-   **オープン ソースの .NET Framework パッケージ**  
+  
+     [!INCLUDE[net_core](../../../includes/net-core-md.md)]変更できないコレクションなどのパッケージ[SIMD Api](http://go.microsoft.com/fwlink/?LinkID=518639)、については、ネットワークなどの Api と、 <xref:System.Net.Http>にオープン ソース パッケージとして利用できる名前空間が[GitHub](https://github.com/)します。 コードにアクセスするを参照してください。 [GitHub の NetFx](http://go.microsoft.com/fwlink/?LinkID=518634)します。 これらのパッケージに投稿する方法と詳細については、次を参照してください。 [.NET Core とオープン ソース](../../../docs/framework/get-started/net-core-and-open-source.md)、 [GitHub の .NET ホーム ページ](http://go.microsoft.com/fwlink/?LinkID=518635)します。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="v452"></a>   
+## <a name="whats-new-in-the-net-framework-452"></a>.NET Framework 4.5.2 の新機能  
+  
+-   **ASP.NET アプリ用の新しい Api です。** 新しい<xref:System.Web.HttpResponse.AddOnSendingHeaders%2A?displayProperty=fullName>と<xref:System.Web.HttpResponseBase.AddOnSendingHeaders%2A?displayProperty=fullName>メソッドを検査し、応答がクライアント アプリにフラッシュされる際に、応答ヘッダー、ステータス コードを変更することができます。 これらのメソッドの代わりに使用を検討、 <xref:System.Web.HttpApplication.PreSendRequestHeaders>と<xref:System.Web.HttpApplication.PreSendRequestContent>イベントより効率的で信頼性の高い。  
+  
+     <xref:System.Web.Hosting.HostingEnvironment.QueueBackgroundWorkItem%2A?displayProperty=fullName>メソッドを使用して、小さなバック グラウンド作業項目をスケジュールできます。 ASP.NET はこれらの項目を追跡し、すべてのバックグラウンド作業項目が完了するまで IIS が突然ワーカー プロセスを終了しないようにします。 このメソッドは、ASP.NET マネージ アプリ ドメインの外部で呼び出すことはできません。  
+  
+     新しい<xref:System.Web.HttpResponse.HeadersWritten?displayProperty=fullName>と<xref:System.Web.HttpResponseBase.HeadersWritten?displayProperty=fullName>プロパティは、応答ヘッダーが書き込まれたかどうかを示すブール値を返します。 これらのプロパティを確認するなどの Api を呼び出している<xref:System.Web.HttpResponse.StatusCode%2A?displayProperty=fullName> (例外をスロー ヘッダーが書き込まれた場合) は成功します。  
+  
+-   **Windows フォーム コントロールにおけるサイズ変更します。** この機能が拡張されました。 これにより、システム DPI 設定を使用して、次の追加コントロールのコンポーネント (例: コンボ ボックスのドロップダウン矢印) をサイズ変更できます。  
+  
+     <xref:System.Windows.Forms.ComboBox>   
+     <xref:System.Windows.Forms.ToolStripComboBox>   
+     <xref:System.Windows.Forms.ToolStripMenuItem>   
+     <xref:System.Windows.Forms.Cursor>   
+     <xref:System.Windows.Forms.DataGridView>   
+     <xref:System.Windows.Forms.DataGridViewComboBoxColumn>  
+  
+     これはオプトイン機能です。 この機能を有効にするには、アプリケーション構成 (app.config) ファイルで `EnableWindowsFormsHighDpiAutoResizing` 要素を `true` に設定します。  
+  
+    ```  
+    <appSettings>  
+       <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  
+    </appSettings>  
+    ```  
+  
+-   **新しいワークフロー機能。** リソース マネージャーを使用している、 <xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A>メソッド (したがってを実装して、 <xref:System.Transactions.IPromotableSinglePhaseNotification>インターフェイス)、新しい使用<xref:System.Transactions.Transaction.PromoteAndEnlistDurable%2A?displayProperty=fullName>メソッドを次の要求。  
+  
+    -   トランザクションを Microsoft 分散トランザクション コーディネーター (MSDTC) トランザクションに昇格します。  
+  
+    -   置換<xref:System.Transactions.IPromotableSinglePhaseNotification>で、 <xref:System.Transactions.ISinglePhaseNotification>、単一フェーズ コミットをサポートする永続参加リストがあります。  
+  
+     これは同じアプリ ドメイン内で実行でき、MSDTC とやり取りして昇格を実行するためにアンマネージ コードを追加する必要はありません。 未処理の呼び出しがある場合にのみ、新しいメソッドを呼び出すことができる<xref:System.Transactions?displayProperty=fullName>に、 <xref:System.Transactions.IPromotableSinglePhaseNotification> `Promote`昇格可能参加リストによって実装されるメソッドです。  
+  
+-   **プロファイリングの機能強化** 次の新しいアンマネージ プロファイリング API により、さらに信頼性の高いプロファイリングを提供します。  
+  
+     [COR_PRF_ASSEMBLY_REFERENCE_INFO 構造体](../../../ocs/framework/unmanaged-api/profiling/cor-prf-assembly-reference-info-structure.md)   
+     [COR_PRF_HIGH_MONITOR 列挙型](../../../ocs/framework/unmanaged-api/profiling/cor-prf-high-monitor-enumeration.md)   
+     [GetAssemblyReferences メソッド](../Topic/ICorProfilerCallback6::GetAssemblyReferences%20Method.md)   
+     [GetEventMask2 メソッド](../Topic/ICorProfilerInfo5::GetEventMask2%20Method.md)   
+     [SetEventMask2 メソッド](../Topic/ICorProfilerInfo5::SetEventMask2%20Method.md)   
+     [AddAssemblyReference メソッド](../Topic/ICorProfilerAssemblyReferenceProvider::AddAssemblyReference%20Method.md)  
+  
+     以前の `ICorProfiler` の実装は、依存アセンブリの遅延読み込みをサポートしていました。 新しいプロファイリング API では、プロファイラーにより挿入される依存アセンブリを、アプリの完全な初期化後に読み込むのではなく、すぐに読み込む必要があります。 この変更は、既存の `ICorProfiler` API のユーザーには影響しません。  
+  
+-   **デバッグの機能強化。** 次の新しいアンマネージド デバッグ API により、プロファイラーとの統合性が向上しました。 これにより、ダンプのデバッグ時にコンパイラ ReJIT 要求により作成されたローカル変数やコードだけでなく、プロファイラーにより挿入されたメタデータにアクセスできます。  
+  
+     [SetWriteableMetadataUpdateMode メソッド](../Topic/ICorDebugProcess7::SetWriteableMetadataUpdateMode%20Method.md)   
+     [EnumerateLocalVariablesEx メソッド](../Topic/ICorDebugILFrame4::EnumerateLocalVariablesEx%20Method.md)   
+     [GetLocalVariableEx メソッド](../Topic/ICorDebugILFrame4::GetLocalVariableEx%20Method.md)   
+     [GetCodeEx メソッド](../Topic/ICorDebugILFrame4::GetCodeEx%20Method.md)   
+     [GetActiveReJitRequestILCode メソッド](../Topic/ICorDebugFunction3::GetActiveReJitRequestILCode%20Method.md)   
+     [GetInstrumentedILMap メソッド](../Topic/ICorDebugILCode2::GetInstrumentedILMap%20Method.md)  
+  
+-   **イベント トレーシングの変更です。** .NET Framework 4.5.2 では、より大きなサーフェイス領域において、アウトプロセスの Windows イベント トレーシング (ETW) に基づくアクティビティ トレーシングができるようになりました。 これにより、アドバンスト パワー マネージメント (APM) ベンダーは、スレッドを越えた個々の要求とアクティビティのコストを正確に追跡する軽量ツールを提供できます。  これらのイベントは、ETW コントローラーで有効にされた場合にのみ発生します。したがって、変更は以前に記述された ETW コードや ETW が無効な状態で実行されるコードには影響しません。  
+  
+-   **トランザクションを昇格して、永続参加リストに変換します。**  
+  
+     <xref:System.Transactions.Transaction.PromoteAndEnlistDurable%2A?displayProperty=fullName>は新しい API に追加、.NET Framework 4.5.2 と 4.6。  
+  
+    ```  
+  
+    [System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.LinkDemand, Name = "FullTrust")]  
+    public Enlistment PromoteAndEnlistDurable(Guid resourceManagerIdentifier,  
+                                              IPromotableSinglePhaseNotification promotableNotification,  
+                                              ISinglePhaseNotification enlistmentNotification,  
+                                              EnlistmentOptions enlistmentOptions)  
+  
+    ```  
+  
+     によって既に作成済みの登録リストにより、メソッドを使用する可能性があります<xref:System.Transactions.Transaction.EnlistPromotableSinglePhase%2A?displayProperty=fullName>に応えて、 <xref:System.Transactions.ITransactionPromoter.Promote%2A?displayProperty=fullName>メソッドです。 これは、`System.Transactions` に対して、トランザクションを MSDTC トランザクションに昇格させ、昇格可能参加リストを永続参加リストに「変換」するように要求します。 このメソッドは正常に完了した後、 <xref:System.Transactions.IPromotableSinglePhaseNotification>インターフェイスはによって参照されなくなった`System.Transactions`、将来通知が表示されているに到着して<xref:System.Transactions.ISinglePhaseNotification>インターフェイスです。 問題の参加リストは、永続参加リストとして機能し、トランザクションのログ記録と復旧をサポートする必要があります。 参照してください<xref:System.Transactions.Transaction.EnlistDurable%2A?displayProperty=fullName>詳細です。 さらに、参加がサポートする必要があります<xref:System.Transactions.ISinglePhaseNotification>します。  このメソッドは*のみ*処理中に呼び出される、 <xref:System.Transactions.ITransactionPromoter.Promote%2A?displayProperty=fullName>呼び出します。 この場合、それがない場合、 <xref:System.Transactions.TransactionException>例外がスローされます。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="v451"></a>   
+## <a name="whats-new-in-the-net-framework-451"></a>.NET Framework 4.5.1 の新機能  
+ **2014 年 4 月の更新**:  
+  
+-   [Visual Studio 2013 Update 2](http://go.microsoft.com/fwlink/p/?LinkId=393658)をこれらのシナリオをサポートするポータブル クラス ライブラリ テンプレートの更新プログラムが含まれています。  
+  
+    -   Windows 8.1、Windows Phone 8.1、および Windows Phone Silverlight 8.1 を対象とするポータブル ライブラリで Windows ランタイム API を使用できます。  
+  
+    -   Windows 8.1 または Windows Phone 8.1 を対象とする場合、ポータブル ライブラリに XAML (Windows.UI.XAML 型) を含めることができます。 次の XAML テンプレートがサポートされています。空白のページ、リソース ディクショナリ、テンプレート コントロール、およびユーザー コントロール。  
+  
+    -   Windows 8.1 および Windows Phone 8.1 を対象とするストア アプリで使用するためにポータブル Windows ラインタイム コンポーネント (.winmd ファイル) を作成できます。  
+  
+    -   ポータブル クラス ライブラリのような Windows ストアまたは Windows Phone ストア クラス ライブラリを再ターゲットできます。  
+  
+     これらの変更の詳細については、次を参照してください。[ポータブル クラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md)します。  
+  
+-   .NET Framework のコンテンツ セットには、Windows アプリをビルドして配置するためのプリコンパイル テクノロジである [!INCLUDE[net_native](../../../includes/net-native-md.md)] のドキュメントが含まれます。 [!INCLUDE[net_native](../../../includes/net-native-md.md)] は、中間言語 (IL) ではなくネイティブ コードへアプリを直接コンパイルすることにより、パフォーマンスを向上させます。 詳細については、「 [.NET ネイティブによるアプリのコンパイル](../../../docs/framework/net-native/index.md)します。  
+  
+-   [.NET Framework Reference Source](http://referencesource.microsoft.com/)新しい参照エクスペリエンスと強化された機能を提供します。 .NET Framework ソース コードをオンラインで表示できるようになりました[リファレンスをダウンロード](http://referencesource.microsoft.com/download.html)のデバッグ中にソース (パッチや更新プログラムを含む) をステップ実行してオフラインで表示します。 詳細については、ブログ記事を参照してください。 [.NET Reference Source の新しいデザイン](http://blogs.msdn.com/b/dotnet/archive/2014/02/24/a-new-look-for-net-reference-source.aspx)します。  
+  
+ .NET Framework 4.5.1 のコア機能の新機能と機能強化には次が含まれます。  
+  
+-   アセンブリの自動バインディング リダイレクト。 [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] 以降では、アプリまたはそのコンポーネントが同じアセンブリの複数バージョンを参照している場合、[!INCLUDE[net_v451](../../../includes/net-v451-md.md)] を対象とするアプリのコンパイル時に、バインディング リダイレクトをアプリ構成ファイルに追加できます。 また、.NET Framework の以前のバージョンを対象とするプロジェクトで、この機能を有効にすることもできます。 詳細については、次を参照してください。[方法: 有効化と自動バインディング リダイレクトを無効にする](../../../docs/framework/configure-apps/how-to-enable-and-disable-automatic-binding-redirection.md)です。  
+  
+-   開発者がサーバーおよびクラウド アプリケーションのパフォーマンスを向上するために役立つ診断情報を収集する機能。 詳細については、次を参照してください。、 <xref:System.Diagnostics.Tracing.EventSource.WriteEventWithRelatedActivityId%2A>と<xref:System.Diagnostics.Tracing.EventSource.WriteEventWithRelatedActivityIdCore%2A>内のメソッド、 <xref:System.Diagnostics.Tracing.EventSource>クラスです。  
+  
+-   ガベージ コレクション中に大きなオブジェクト ヒープ (LOH) を圧縮する機能。 詳細については、次を参照してください。、 <xref:System.Runtime.GCSettings.LargeObjectHeapCompactionMode%2A?displayProperty=fullName>プロパティです。  
+  
+-   その他のパフォーマンス向上 (ASP.NET アプリの中断、マルチコア JIT の改良、.NET Framework 更新後のアプリ起動時間の短縮など)。 詳細については、「、 [.NET Framework 4.5.1 のお知らせ](http://blogs.msdn.com/b/dotnet/archive/2013/06/26/announcing-the-net-framework-4-5-1-preview.aspx)と[ASP.NET アプリの中断](http://blogs.msdn.com/b/dotnet/archive/2013/10/09/asp-net-app-suspend-responsive-shared-net-web-hosting.aspx)ブログの投稿です。  
+  
+ Windows フォームの機能強化には次が含まれます。  
+  
+-   Windows フォーム コントロールでのサイズ変更。 アプリのアプリケーション構成ファイル (app.config) 内のエントリで有効にすることにより、システム DIP 設定を使用してコントロールのコンポーネント (例: プロパティ グリッドに表示されるアイコン) をサイズ変更できます。 現在、この機能は次の Windows フォーム コントロールでサポートされています。  
+  
+     <xref:System.Windows.Forms.PropertyGrid>   
+     <xref:System.Windows.Forms.TreeView>   
+     一部の機能、 <xref:System.Windows.Forms.DataGridView> (を参照してください[4.5.2 の新機能](#v452)サポートされているその他のコントロールの)  
+  
+     この機能を有効にするには、新しい追加<>\>要素に構成ファイル (app.config) を設定し、`EnableWindowsFormsHighDpiAutoResizing`要素を`true`:  
+  
+    ```  
+    <appSettings>  
+       <add key="EnableWindowsFormsHighDpiAutoResizing" value="true" />  
+    </appSettings>  
+    ```  
+  
+ [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] で .NET Framework アプリをデバッグするときの改善点は次のとおりです。  
+  
+-   Visual Studio デバッガーの戻り値。 [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] でマネージ アプリをデバッグする場合、メソッドの戻り値の型と値が [自動変数] ウィンドウに表示されます。 デスクトップ アプリ、Windows ストア アプリ、Windows Phone アプリについて、この情報を使用できます。 詳細については、次を参照してください。[メソッド呼び出しの戻り値を調べて](http://msdn.microsoft.com/library/e3245b37-8e2e-4200-ba84-133726e95f1f\(v=vs.120\).aspx)、MSDN ライブラリです。  
+  
+-   64 ビット アプリのエディット コンティニュ。 [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] では、デスクトップ、Windows ストア、Windows Phone 用の 64 ビット マネージ アプリについて、エディット コンティニュ機能がサポートされています。 32 ビットと 64 ビットの両方のアプリケーションの既存の制限を有効になります (の最後のセクションを参照してください、[サポートされているコード変更 (c#)](http://msdn.microsoft.com/library/ms164927\(v=vs.120\).aspx)記事)。  
+  
+-   非同期対応のデバッグ。 [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] で非同期アプリを簡単にデバッグするために、呼び出し履歴には、非同期プログラミングをサポートするためにコンパイラに用意されているインフラストラクチャ コード、および論理上の親フレーム内のチェーンが表示されません。これにより、論理的なプログラムの実行をよりわかりやすく行うことができます。 [タスク] ウィンドウが [並列タスク] ウィンドウに代わって使用され、特定のブレークポイントに関連するタスクが表示されます。また、現在アクティブなタスクやアプリでスケジュールされているタスクなども表示されます。 「非同期対応のデバッグ」セクションでは、この機能に関する記事を参照する、 [.NET Framework 4.5.1 のお知らせ](http://blogs.msdn.com/b/dotnet/archive/2013/06/26/announcing-the-net-framework-4-5-1-preview.aspx)します。  
+  
+-   Windows ランタイム コンポーネント向けのより適切な例外処理のサポート。 [!INCLUDE[win81](../../../includes/win81-md.md)] では、言語の種類に関係なく、Windows ストア アプリから発生する例外には、例外を発生させたエラーに関する情報が保持されます。 「Windows ストア アプリの開発」セクションでは、この機能に関する記事を参照する、 [.NET Framework 4.5.1 のお知らせ](http://blogs.msdn.com/b/dotnet/archive/2013/06/26/announcing-the-net-framework-4-5-1-preview.aspx)します。  
+  
+ 以降で[!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)]、使用することができます、[マネージ プロファイル ガイド付き最適化ツール (Mpgo.exe)](../../../docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md)を最適化する[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)]アプリとデスクトップ アプリ。  
+  
+ ASP.NET 4.5.1 の新機能は、次を参照してください。 [ASP.NET 4.5.1 および Visual Studio 2013](http://go.microsoft.com/fwlink/?LinkID=309094) ASP.NET サイトです。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="core"></a>   
+## <a name="whats-new-in-the-net-framework-45"></a>.NET Framework 4.5 の新機能  
+  
+### <a name="core-new-features-and-improvements"></a>コア機能の新機能と機能強化  
+  
+-   配置時に .NET Framework 4 アプリケーションを検出して終了することにより、システムの再起動を減らす機能。 参照してください[システム再起動の削減 .NET Framework 4.5 のインストール中に](../../../docs/framework/deployment/reducing-system-restarts.md)します。  
+  
+-   64 ビット プラットフォームでの 2 ギガバイト (GB) を超える配列のサポート。 この機能は、アプリケーション構成ファイルで有効にすることができます。 参照してください、 [ <> \>要素](../../../docs/framework/configure-apps/file-schema/runtime/gcallowverylargeobjects-element.md)、オブジェクトのサイズと配列サイズに関するその他の制限も記載します。  
+  
+-   サーバーのガベージ コレクションをバックグラウンドで行うことにより、パフォーマンスを改善します。 [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] でサーバーのガベージ コレクションを使用すると、バックグラウンド ガベージ コレクションが自動的に有効になります。 バック グラウンド サーバー ガベージ コレクションを参照してください、[ガベージ コレクションの基礎](../../../docs/standard/garbage-collection/fundamentals.md)トピックです。  
+  
+-   マルチコア プロセッサでオプションで使用できるバックグラウンドの Just-in-time (JIT) コンパイルを使用すると、アプリケーションのパフォーマンスが向上します。 参照してください<xref:System.Runtime.ProfileOptimization>します。  
+  
+-   正規表現エンジンがタイムアウトする前に、正規表現の解決を試みる時間に制限を設ける機能。 参照してください、 <xref:System.Text.RegularExpressions.Regex.MatchTimeout%2A?displayProperty=fullName>プロパティです。  
+  
+-   アプリケーション ドメインの既定のカルチャを定義する機能。 参照してください、 <xref:System.Globalization.CultureInfo>クラスです。  
+  
+-   Unicode UTF-16 エンコードのコンソール サポート。 参照してください、<xref:System.Console>クラスです。  
+  
+-   カルチャに従った文字列の順序のバージョン指定と比較データのサポート。 参照してください、 <xref:System.Globalization.SortVersion>クラスです。  
+  
+-   リソースを取得するときのパフォーマンスを改善します。 参照してください[のパッケージ化とリソースをデプロイする](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)です。  
+  
+-   Zip 圧縮の機能強化により、圧縮ファイルのサイズが小さくなりました。 参照してください、 <xref:System.IO.Compression?displayProperty=fullName>名前空間。  
+  
+-   既定のリフレクションの動作をオーバーライドするリフレクション コンテキストをカスタマイズする機能、 <xref:System.Reflection.Context.CustomReflectionContext>クラスです。  
+  
+-   国際化ドメイン名のアプリケーション (IDNA) の 2008年バージョンのサポートされる標準的な場合に、 <xref:System.Globalization.IdnMapping?displayProperty=fullName>クラスは、使用[!INCLUDE[win8](../../../includes/win8-md.md)]します。  
+  
+-   オペレーティング システムへの文字列比較の処理代行。.NET Framework を [!INCLUDE[win8](../../../includes/win8-md.md)] で使用したときに、Unicode 6.0 が実装されます。 他のプラットフォームで実行されている場合、.NET Framework には、Unicode 5.x. を実装する独自の文字列比較データが含まれています。 参照してください、<xref:System.String>クラスとの「解説」セクション、 <xref:System.Globalization.SortVersion>クラスです。  
+  
+-   アプリケーション ドメインごとに文字列のハッシュ コードを計算する機能。 See [<>\> Element](../../../docs/framework/configure-apps/file-schema/runtime/userandomizedstringhashalgorithm-element.md).  
+  
+-   タイプ リフレクションのサポートが分割<xref:System.Type>と<xref:System.Reflection.TypeInfo>クラスです。 参照してください[Windows ストア アプリ用 .NET Framework のリフレクション](../../../docs/framework/reflection-and-codedom/reflection-for-windows-store-apps.md)します。  
+  
+### <a name="managed-extensibility-framework-mef"></a>MEF (Managed Extensibility Framework)  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、MEF (Managed Extensibility Framework) に次の新機能が用意されています。  
+  
+-   ジェネリック型のサポート。  
+  
+-   属性ではなく命名規則に基づいてパーツを作成できるようにする、規則ベースのプログラミング モデル。  
+  
+-   複数のスコープ。  
+  
+-   [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを作成するときに使用できる MEF のサブセット。 このサブセットは、[ダウンロード可能なパッケージ](http://go.microsoft.com/fwlink/?LinkId=256238)NuGet ギャラリーからです。 パッケージをインストールするには、Visual Studio でプロジェクトを開きます、選択**NuGet パッケージの管理**から、**プロジェクト**メニューのおよびオンラインで検索、`Microsoft.Composition`パッケージです。  
+  
+ 詳細については、次を参照してください。 [Managed Extensibility Framework (MEF)](../../../docs/framework/mef/index.md)します。  
+  
+### <a name="asynchronous-file-operations"></a>非同期のファイル操作  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、新しい非同期機能が C# および Visual Basic 言語に追加されました。 これらの機能は、非同期操作を実行するためのタスク ベースのモデルを追加します。 この新しいモデルを使用するには、I/O クラスで非同期メソッドを使用します。 参照してください[非同期ファイル I/O](../../../docs/standard/io/非同期ファイル-i-o.md)します。  
+  
+<a name="tools"></a>   
+### <a name="tools"></a>ツール  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、リソース ファイル ジェネレーター (Resgen.exe) を使用すると、.NET Framework アセンブリに埋め込まれた .resources ファイルから [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリ用の .resw ファイルを作成することができます。 詳細については、次を参照してください。 [Resgen.exe (リソース ファイル ジェネレーター)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)します。  
+  
+ マネージ プロファイル ガイド付き最適化ツール (Mpgo.exe) を使用すると、ネイティブ イメージ アセンブリを最適化することによって、アプリケーションの起動時間、メモリの使用率 (ワーキング セットのサイズ)、およびスループットを向上させることができます。 このコマンド ライン ツールは、ネイティブ イメージ アプリケーション アセンブリ用のプロファイル データを生成します。 参照してください[Mpgo.exe (マネージ プロファイル ガイド付き最適化ツール)](../../../docs/framework/tools/mpgo-exe-managed-profile-guided-optimization-tool.md)します。 [!INCLUDE[vs_dev12](../../../includes/vs-dev12-md.md)] 以降では、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリおよびデスクトップ アプリを最適化するために、Mpgo.exe を使用できます。  
+  
+<a name="parallel"></a>   
+### <a name="parallel-computing"></a>並列コンピューティング  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、並列計算用にいくつかの新機能と機能強化が提供されています。 パフォーマンスの向上、コントロールの強化、非同期プログラミングのサポートの改善、新しいデータフロー ライブラリ、並列デバッグとパフォーマンス分析のためのサポートの強化などが挙げられます。 エントリを参照してください[.NET 4.5 における並列処理の新](http://go.microsoft.com/fwlink/?LinkId=235061).NET ブログでの並列プログラミングにします。  
+  
+<a name="web"></a>   
+### <a name="web"></a>Web  
+ ASP.NET 4.5 および 4.5.1 では、Web フォーム モデルのバインディング、WebSocket のサポート、非同期ハンドラー、パフォーマンスの向上などの多くの機能が追加されています。 詳細については、次のリソースを参照してください。  
+  
+-   [ASP.NET 4.5 と Visual Studio 2012](../Topic/ASP.NET%20Core%20and%20Visual%20Studio%202015.md) MSDN ライブラリです。  
+  
+-   [ASP.NET 4.5.1 および Visual Studio 2013](http://go.microsoft.com/fwlink/?LinkID=309094) ASP.NET サイトです。  
+  
+<a name="networking"></a>   
+### <a name="networking"></a>ネットワーク  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、HTTP アプリケーションに新しいプログラミング インターフェイスを提供します。 詳細については、表示、新しい<xref:System.Net.Http?displayProperty=fullName>と<xref:System.Net.Http.Headers?displayProperty=fullName>名前空間。  
+  
+ サポートも受け入れ、既存を使用して WebSocket 接続をやり取りするための新しいプログラミング インターフェイスに含まれて<xref:System.Net.HttpListener>および関連クラスです。 詳細については、表示、新しい<xref:System.Net.WebSockets>名前空間および<xref:System.Net.HttpListener>クラスです。  
+  
+ また [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] には、次のネットワークの機能強化が含まれています。  
+  
+-   RFC 準拠の URI サポート。 詳細については、次を参照してください。 <xref:System.Uri>および関連クラスです。  
+  
+-   国際化ドメイン名 (IDN: Internationalized Domain Name) による解析のサポート。 詳細については、次を参照してください。 <xref:System.Uri>および関連クラスです。  
+  
+-   電子メール アドレスの国際化 (EAI) のサポート。 詳細については、次を参照してください。、 <xref:System.Net.Mail>名前空間。  
+  
+-   強化された IPv6 サポート。 詳細については、次を参照してください。、 <xref:System.Net.NetworkInformation>名前空間。  
+  
+-   デュアル モードのソケットのサポート。 詳細については、次を参照してください。、<xref:System.Net.Sockets.Socket>と<xref:System.Net.Sockets.TcpListener>クラスです。  
+  
+<a name="client"></a>   
+### <a name="windows-presentation-foundation-wpf"></a>Windows Presentation Foundation (WPF)  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、WPF (Windows Presentation Foundation) の次の領域の機能が変更および強化されています。  
+  
+-   新しい<xref:System.Windows.Controls.Ribbon.Ribbon>コントロールで、クイック アクセス ツールバー、アプリケーション メニューおよびタブをホストするリボン ユーザー インターフェイスを実装することができます。  
+  
+-   新しい<xref:System.ComponentModel.INotifyDataErrorInfo>インターフェイスで、同期および非同期のデータの検証をサポートします。  
+  
+-   新機能、 <xref:System.Windows.Controls.VirtualizingPanel>と<xref:System.Windows.Threading.Dispatcher>クラスです。  
+  
+-   グループ化された大量のデータを表示するときに、非 UI スレッドのコレクションにアクセスすることによってパフォーマンスを向上。  
+  
+-   静的プロパティへのバインド データをカスタム型データ バインディングを実装する、 <xref:System.Reflection.ICustomTypeProvider>インターフェイス、およびバインディング式からのデータ バインディング情報を取得します。  
+  
+-   値の変更に伴うデータの再配置 (ライブ形成)。  
+  
+-   項目コンテナーのデータ コンテキストを切断するかどうかをチェックする機能。  
+  
+-   プロパティの変更とデータ ソースの更新までの経過時間を設定する機能。  
+  
+-   弱いイベント パターン実装時のサポートの強化。 また、イベントでマークアップ拡張機能を使用することもできるようになりました。  
+  
+<a name="windows_communication_foundation"></a>   
+### <a name="windows-communication-foundation-wcf"></a>Windows Communication Foundation (WCF)  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)]では、Windows Communication Foundation (WCF) アプリケーションの記述と保守を簡単にするため、次の機能が追加されました。  
+  
+-   生成された構成ファイルの簡略化。  
+  
+-   コントラクト優先開発のサポート。  
+  
+-   ASP.NET 互換モードをより簡単に構成できる機能。  
+  
+-   既定のトランスポート プロパティ値に変更を加え、設定しなければならない可能性を低減しました。  
+  
+-   更新プログラムを<xref:System.Xml.XmlDictionaryReaderQuotas>クラス XML ディクショナリ リーダーのクォータを手動で構成する必要がある可能性を低減します。  
+  
+-   ビルド処理の一部として Visual Studio による WCF 構成ファイルを検証することで、アプリケーションを実行する前に構成エラーを検出できます。  
+  
+-   新しい非同期ストリーミングのサポート。  
+  
+-   Internet Information Services (IIS) での HTTPS 上のエンドポイントを公開しやすくする新しい HTTPS プロトコル マッピング。  
+  
+-   `?singleWSDL` をサービス URL に追加して&1; つの WSDL ドキュメントのメタデータを生成する機能。  
+  
+-   TCP トランスポートと同様のパフォーマンス特性を持つポート 80 と 443 で真の双方向通信を可能にする Websockets のサポート。  
+  
+-   コード内の構成サービスのサポート。  
+  
+-   XML エディターのツール ヒント。  
+  
+-   <xref:System.ServiceModel.ChannelFactory>キャッシュのサポート。  
+  
+-   バイナリ エンコーダーの圧縮サポート。  
+  
+-   開発者が「ファイア アンド フォーゲット (撃ち放し)」メッセージングを使用するサービスを作成できるようにする UDP トランスポートのサポート。 クライアントは、サービスにメッセージを送信しますが、サービスからの応答を期待しません。  
+  
+-   HTTP トランスポートとトランスポート セキュリティを使用したときに、単一の WCF エンドポイントで複数の認証モードをサポートする機能。  
+  
+-   国際化ドメイン名 (IDN: Internationalized Domain Name) を使用する WCF サービスのサポート。  
+  
+ 詳細については、次を参照してください。 [Windows Communication Foundation の新](http://go.microsoft.com/fwlink/?LinkId=228173)します。  
+  
+<a name="windows_workflow_foundation"></a>   
+### <a name="windows-workflow-foundation-wf"></a>Windows Workflow Foundation (WF)  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、次に示すようないくつかの新しい機能が Windows Workflow Foundation (WF) に追加されました。  
+  
+-   ステート マシン ワークフローは、最初に .NET Framework 4.0.1 の一部として導入された ([.NET Framework 4 Platform Update 1](http://go.microsoft.com/fwlink/?LinkID=215092))。 この更新プログラムには、開発者がステート マシン ワークフローを作成できるようにする新しいクラスとアクティビティが複数含まれていました。 [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、これらのクラスとアクティビティが、次を含むように更新されました。  
+  
+    -   状態でブレークポイントを設定する機能。  
+  
+    -   ワークフロー デザイナーで遷移をコピーして貼り付ける機能。  
+  
+    -   共有されるトリガーの遷移作成のデザイナー サポート。  
+  
+    -   含む、ステート マシン ワークフローを作成する: <xref:System.Activities.Statements.StateMachine>、<xref:System.Activities.Statements.State>、および<xref:System.Activities.Statements.Transition>します。  
+  
+-   次のようなワークフロー デザイナーの機能が強化されました。  
+  
+    -   強化された Visual Studio で、ワークフロー検索機能を含む**クイック検索**と**ファイル内の検索**します。  
+  
+    -   2 番目の子アクティビティがコンテナー アクティビティに追加されたときに、自動的にシーケンス アクティビティを作成し、両方のアクティビティをシーケンス アクティビティに含める機能。  
+  
+    -   スクロール バーを使用せずに変更されるワークフローの表示部分を変更できるようにするパン サポート。  
+  
+    -   新しい**ドキュメント アウトライン**ツリー スタイルのアウトライン ビューで、ワークフローのコンポーネントを表示するビューでコンポーネントを選択して、 **ドキュメント アウトライン**表示します。  
+  
+    -   アクティビティに注釈を追加できる機能。  
+  
+    -   ワークフロー デザイナーでアクティビティ デリゲートを定義および使用する機能。  
+  
+    -   ステート マシンのアクティビティと遷移、およびフローチャート ワークフローの自動接続と自動挿入。  
+  
+-   ワークフローのビュー状態情報を XAML ファイルの&1; つの要素に保管して、ビュー状態情報を簡単に見つけ、編集できるようにします。  
+  
+-   子アクティビティの永続化を防ぐ NoPersistScope コンテナー アクティビティ。  
+  
+-   C# 式のサポート:   
+  
+    -   Visual Basic を使用するワークフロー プロジェクトは、Visual Basic 式を使用し、C# ワークフロー プロジェクトは C# 式を使用します。  
+  
+    -   Visual Studio 2010 で作成され、Visual Basic 式が使用されている C# ワークフロー プロジェクトは、C# 式を使用する C# ワークフロー プロジェクトと互換性があります。  
+  
+-   バージョン管理機能の強化  
+  
+    -   新しい<xref:System.Activities.WorkflowIdentity>永続化されたワークフロー インスタンスとワークフロー定義間のマッピングを提供するクラス。  
+  
+    -   を含む同じホスト内の複数のワークフロー バージョンのサイド バイ サイド実行<xref:System.ServiceModel.Activities.WorkflowServiceHost>します。  
+  
+    -   動的更新プログラムで、永続化されたワークフロー インスタンスの定義を変更する機能。  
+  
+-   既存のサービス コントラクトに合わせて自動的にアクティビティを生成するサポートが提供されるコントラクト優先のワークフロー サービス開発。  
+  
+ 詳細については、次を参照してください。 [Windows Workflow Foundation の新](http://go.microsoft.com/fwlink/?LinkId=228176)します。  
+  
+<a name="tailored"></a>   
+### [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)]  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] のアプリは、特定のフォーム ファクターに合わせて設計されており、Windows オペレーティング システムの機能を利用します。 C# または Visual Basic を使用して Windows 用の [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] アプリをビルドするために、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] または 4.5.1 のサブセットを使用できます。 このような操作が呼び出されます[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)]で説明されている場合は、[概要](http://go.microsoft.com/fwlink/?LinkId=228491)Windows デベロッパー センターでします。  
+  
+<a name="portable"></a>   
+### <a name="portable-class-libraries"></a>ポータブル クラス ライブラリ  
+ [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] (および以降のバージョン) のポータブル クラス ライブラリ プロジェクトを使用すると、複数の .NET Framework プラットフォームで動作するマネージ アセンブリを作成してビルドできます。 ポータブル クラス ライブラリ プロジェクトを使用して、対象とするプラットフォーム (Windows Phone や [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)]など) を選択します。 プロジェクトで使用できる型およびメンバーは、自動的にこれらのプラットフォーム間で共通の型とメンバーに制限されます。 詳細については、次を参照してください。[ポータブル クラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [.NET Framework および特別のリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)   
+ [Visual Studio 2013 の新機能します。](http://msdn.microsoft.com/library/bb386063\(v=vs.120\).aspx)   
+ [ASP.NET 4.5.1 および Visual Studio 2013 用 Web ツール](http://go.microsoft.com/fwlink/?LinkID=309094)   
+ [ASP.NET および Web 対応の Visual Studio](../Topic/ASP.NET%20and%20Visual%20Studio%20for%20Web.md)   
+ [Windows Communication Foundation の新機能します。](http://go.microsoft.com/fwlink/?LinkId=228173)   
+ [Windows Workflow Foundation の新機能します。](http://go.microsoft.com/fwlink/?LinkId=228176)   
+ [Visual C の新機能します。](http://msdn.microsoft.com/library/hh409293\(v=vs.120\).aspx)
\ No newline at end of file
diff --git a/docs/framework/whats-new/obsolete-members.md b/docs/framework/whats-new/obsolete-members.md
new file mode 100644
index 00000000000..1bfe01951a8
--- /dev/null
+++ b/docs/framework/whats-new/obsolete-members.md
@@ -0,0 +1,806 @@
+---
+title: ".NET Framework 4.5 で互換性のために残されているメンバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 4.5, 互換性のために残されているメンバー"
+  - "メンバー, 互換性のために残されている (.NET Framework 4.5)"
+  - "互換性のために残されているメンバー [.NET Framework]"
+ms.assetid: 0ee25062-4071-4d3c-a552-87a75d3ecd34
+caps.latest.revision: 56
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# .NET Framework 4.5 で互換性のために残されているメンバー
+この記事の表に、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] \([!INCLUDE[net_v451](../../../includes/net-v451-md.md)] などのポイント リリースも含む\) で互換性のために残されている型メンバーをアセンブリ別に示します。  各アセンブリで互換性のために残されているメンバーと推奨される代替メンバーの一覧を表示するには、以下のリンクを使用してください。  このトピックでは、廃止された型のメンバーの一覧は表示されていません。  廃止された型の一覧については、「[Obsolete Types \(互換性のために残されている型\)](../../../docs/framework/whats-new/obsolete-types.md)」をご覧ください。  
+  
+-   [互換性のために残されているシステム アセンブリのメンバー](#SystemMembers)  
+  
+    -   [mscorlib.dll](#mscorlib)  
+  
+    -   [PresentationCore.dll](#PresentationCore)  
+  
+    -   [PresentationFramework.dll](#PresFW)  
+  
+    -   [System.Activities.dll](#Act)  
+  
+    -   [System.Activities.Presentation.dll](#ActPres)  
+  
+    -   [System.Core.dll](#core)  
+  
+    -   [System.Data.dll](#data)  
+  
+    -   [System.Data.Entity.dll](#entity)  
+  
+    -   [System.Data.OracleClient.dll](#oracleclient)  
+  
+    -   [System.Design.dll](#design)  
+  
+    -   [System.dll](#system)  
+  
+    -   [System.Drawing.dll](#drawing)  
+  
+    -   [System.Messaging.dll](#messaging)  
+  
+    -   [System.ServiceModel.dll](#servicemodel)  
+  
+    -   [System.ServiceModel.Discovery.dll](#smDisc)  
+  
+    -   [System.Web.DataVisualization.dll](#datavisualization)  
+  
+    -   [System.Web.dll](#web)  
+  
+    -   [System.Web.DynamicData.dll](#dynamicdata)  
+  
+    -   [System.Web.Extensions.dll](#extensions)  
+  
+    -   [System.Web.Services.dll](#services)  
+  
+    -   [System.Windows.Forms.dll](#forms)  
+  
+    -   [System.Xaml.dll](#xaml)  
+  
+    -   [System.Xml.dll](#xml)  
+  
+-   [互換性のために残されている Microsoft アセンブリのメンバー](#MicrosoftMembers)  
+  
+    -   [IEHost.dll および IEExec.exe](#IEHost)  
+  
+    -   [ISymWrapper.dll](#isymwrapper)  
+  
+    -   [Microsoft.Build.Conversion.v4.0.dll](#conversion)  
+  
+    -   [Microsoft.Build.Engine.dll](#engine)  
+  
+    -   [Microsoft.Build.Framework.dll](#BuildFW)  
+  
+    -   [Microsoft.Build.Utilities.v4.0.dll](#BuildUtil4)  
+  
+    -   [Microsoft.Data.Entity.Build.Tasks.dll](#data_entity_tasks)  
+  
+    -   [Microsoft.VisualBasic.dll](#visualbasic)  
+  
+<a name="SystemMembers"></a>   
+## 互換性のために残されているシステム アセンブリのメンバー  
+ 次の表に、互換性のために残されているシステム アセンブリのメンバーを示します。  これらのアセンブリは、.NET Framework を対象とする汎用アプリケーションの開発で使用されます。  
+  
+<a name="mscorlib"></a>   
+### アセンブリ: mscorlib.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Enum?displayProperty=fullName>|<xref:System.Enum.ToString%28System.IFormatProvider%29>|`provider` 引数は使用されなくなりました。  <xref:System.Enum.ToString?displayProperty=fullName> を使用してください。|  
+|<xref:System.Enum?displayProperty=fullName>|<xref:System.Enum.ToString%28System.String%2CSystem.IFormatProvider%29>|`provider` 引数は使用されなくなりました。  <xref:System.Enum.ToString?displayProperty=fullName> を使用してください。|  
+|<xref:System.Activator?displayProperty=fullName>|[CreateInstance\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.Activator.CreateInstance%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Activator.CreateInstance%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Activator?displayProperty=fullName>|[CreateInstanceFrom\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.Activator.CreateInstanceFrom%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Activator.CreateInstanceFrom%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Activator?displayProperty=fullName>|[CreateInstanceFrom\(AppDomain, String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.Activator.CreateInstanceFrom%28System.AppDomain%2CSystem.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Activator.CreateInstanceFrom%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Activator?displayProperty=fullName>|[CreateInstance\(AppDomain, String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.Activator.CreateInstance%28System.AppDomain%2CSystem.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Activator.CreateInstance%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[CreateInstanceFromAndUnwrap\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.AppDomain.CreateInstanceFromAndUnwrap%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.CreateInstanceFromAndUnwrap%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[ExecuteAssembly\(String, Evidence, String\[\], Byte\<xref:System.AppDomain.ExecuteAssembly%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.String%5B%5D%2CSystem.Byte%5B%5D%2CSystem.Configuration.Assemblies.AssemblyHashAlgorithm%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssembly%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.SetAppDomainPolicy%2A>|<xref:System.AppDomain> ポリシー レベルは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[ExecuteAssemblyByName\(AssemblyName, Evidence, String\<xref:System.AppDomain.ExecuteAssemblyByName%28System.Reflection.AssemblyName%2CSystem.Security.Policy.Evidence%2CSystem.String%5B%5D%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssemblyByName%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[Load\(Byte\[\], Byte\<xref:System.AppDomain.Load%28System.Byte%5B%5D%2CSystem.Byte%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.ExecuteAssembly%28System.String%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssembly%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.AppendPrivatePath%2A>|<xref:System.AppDomain.AppendPrivatePath%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.PrivateBinPath%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[CreateInstanceAndUnwrap\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.AppDomain.CreateInstanceAndUnwrap%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.CreateInstanceFromAndUnwrap%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.Load%28System.String%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.ClearShadowCopyPath%2A>|<xref:System.AppDomain.ClearShadowCopyPath%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.ShadowCopyDirectories%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.Load%28System.Reflection.AssemblyName%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.SetCachePath%2A>|<xref:System.AppDomain.SetCachePath%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.CachePath%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[CreateInstance\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.AppDomain.CreateInstance%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.CreateInstance%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.String%2CSystem.Security.Policy.Evidence%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Boolean%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.SetShadowCopyFiles%2A>|<xref:System.AppDomain.SetShadowCopyFiles%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.ShadowCopyFiles%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[ExecuteAssemblyByName\(String, Evidence, String\<xref:System.AppDomain.ExecuteAssemblyByName%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.String%5B%5D%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssemblyByName%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.Security.Policy.Evidence%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.ClearPrivatePath%2A>|<xref:System.AppDomain.ClearPrivatePath%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.PrivateBinPath%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[ExecuteAssembly\(String, Evidence, String\<xref:System.AppDomain.ExecuteAssembly%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.String%5B%5D%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssembly%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.String%2CSystem.Security.Policy.Evidence%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Boolean%2CSystem.Collections.Generic.IEnumerable%7BSystem.Reflection.Emit.CustomAttributeBuilder%7D%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.String%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.DefineDynamicAssembly%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|[CreateInstanceFrom\(String, String, Boolean, BindingFlags, Binder, Object\[\], CultureInfo, Object\<xref:System.AppDomain.CreateInstanceFrom%28System.String%2CSystem.String%2CSystem.Boolean%2CSystem.Reflection.BindingFlags%2CSystem.Reflection.Binder%2CSystem.Object%5B%5D%2CSystem.Globalization.CultureInfo%2CSystem.Object%5B%5D%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.CreateInstanceFrom%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.GetCurrentThreadId%2A>|マネージ スレッドがファイバー \(簡易スレッド\) で実行されているときに固定の ID を提供しないので、<xref:System.AppDomain.GetCurrentThreadId%2A> の使用は推奨されていません。  マネージ スレッドの固定の ID を取得するには、<xref:System.Threading.Thread.ManagedThreadId%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.SetDynamicBase%2A>|<xref:System.AppDomain.SetDynamicBase%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.DynamicBase%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.String%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.SetShadowCopyPath%2A>|<xref:System.AppDomain.SetShadowCopyPath%2A> の使用は推奨されていません。  代わりに、<xref:System.AppDomainSetup.ShadowCopyDirectories%2A?displayProperty=fullName> の使用を検討してください。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.Security.Policy.Evidence%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.DefineDynamicAssembly%28System.Reflection.AssemblyName%2CSystem.Reflection.Emit.AssemblyBuilderAccess%2CSystem.String%2CSystem.Security.Policy.Evidence%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%29>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.AppDomain?displayProperty=fullName>|<xref:System.AppDomain.ExecuteAssemblyByName%28System.String%2CSystem.Security.Policy.Evidence%29>|証拠に基づいてサンドボックス化するメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.AppDomain.ExecuteAssemblyByName%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.LoaderOptimization?displayProperty=fullName>|<xref:System.LoaderOptimization>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.LoaderOptimization?displayProperty=fullName>|<xref:System.LoaderOptimization>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Resources.ResourceManager?displayProperty=fullName>|<xref:System.Resources.ResourceManager.ResourceSets?displayProperty=fullName>|代わりに <xref:System.Resources.ResourceManager.InternalGetResourceSet%2A?displayProperty=fullName> を呼び出してください。|  
+|<xref:System.Threading.WaitHandle?displayProperty=fullName>|<xref:System.Threading.WaitHandle.Handle%2A>|代わりに、<xref:System.Threading.WaitHandle.SafeWaitHandle%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Threading.Overlapped?displayProperty=fullName>|<xref:System.Threading.Overlapped.EventHandle%2A>|このプロパティは、64 ビット互換ではありません。  代わりに、<xref:System.Threading.Overlapped.EventHandleIntPtr%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Threading.Overlapped?displayProperty=fullName>|<xref:System.Threading.Overlapped.Pack%28System.Threading.IOCompletionCallback%29>|このメソッドは、安全ではありません。  代わりに、<xref:System.Threading.Overlapped.Pack%28System.Threading.IOCompletionCallback%2CSystem.Object%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Threading.Overlapped?displayProperty=fullName>|<xref:System.Threading.Overlapped.%23ctor%28System.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.IAsyncResult%29>|このコンストラクターは、64 ビット互換ではありません。  イベント ハンドル用に <xref:System.Threading.Overlapped.%23ctor%28System.Int32%2CSystem.Int32%2CSystem.IntPtr%2CSystem.IAsyncResult%29?displayProperty=fullName> を取得する <xref:System.IntPtr?displayProperty=fullName> コンストラクターを使用してください。|  
+|<xref:System.Threading.Overlapped?displayProperty=fullName>|<xref:System.Threading.Overlapped.UnsafePack%28System.Threading.IOCompletionCallback%29>|このメソッドは、安全ではありません。  代わりに、<xref:System.Threading.Overlapped.UnsafePack%28System.Threading.IOCompletionCallback%2CSystem.Object%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Threading.Thread?displayProperty=fullName>|<xref:System.Threading.Thread.Resume%2A>|<xref:System.Threading.Thread.Resume%2A> の使用は推奨されていません。  スレッドを同期させる場合やリソースを保護する場合は、<xref:System.Threading?displayProperty=fullName>、<xref:System.Threading.Monitor>、<xref:System.Threading.Mutex>、<xref:System.Threading.EventWaitHandle> など、<xref:System.Threading.Semaphore> の他のクラスを使用してください。|  
+|<xref:System.Threading.Thread?displayProperty=fullName>|<xref:System.Threading.Thread.SetCompressedStack%2A>|<xref:System.Threading.Thread.SetCompressedStack%2A> はサポート対象から除外されました。  <xref:System.Threading.CompressedStack?displayProperty=fullName> クラスを使用してください。|  
+|<xref:System.Threading.Thread?displayProperty=fullName>|<xref:System.Threading.Thread.GetCompressedStack%2A>|<xref:System.Threading.Thread.GetCompressedStack%2A> はサポート対象から除外されました。  <xref:System.Threading.CompressedStack?displayProperty=fullName> クラスを使用してください。|  
+|<xref:System.Threading.Thread?displayProperty=fullName>|<xref:System.Threading.Thread.ApartmentState%2A>|<xref:System.Threading.Thread.ApartmentState%2A> プロパティの使用は推奨されていません。  代わりに、<xref:System.Threading.Thread.GetApartmentState%2A?displayProperty=fullName>、<xref:System.Threading.Thread.SetApartmentState%2A?displayProperty=fullName>、または <xref:System.Threading.Thread.TrySetApartmentState%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Threading.Thread?displayProperty=fullName>|<xref:System.Threading.Thread.Suspend%2A>|<xref:System.Threading.Thread.Suspend%2A> の使用は推奨されていません。  スレッドを同期させる場合やリソースを保護する場合は、<xref:System.Threading?displayProperty=fullName>、<xref:System.Threading.Monitor>、<xref:System.Threading.Mutex>、<xref:System.Threading.EventWaitHandle> など、<xref:System.Threading.Semaphore> の他のクラスを使用してください。|  
+|<xref:System.Threading.ThreadPool?displayProperty=fullName>|<xref:System.Threading.ThreadPool.BindHandle%28System.IntPtr%29>|<xref:System.Threading.ThreadPool.BindHandle%28System.IntPtr%29> の使用は推奨されていません。  代わりに、<xref:System.Threading.ThreadPool.BindHandle%28System.Runtime.InteropServices.SafeHandle%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IDictionary%2CSystem.Single%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IDictionary%2CSystem.Single%2CSystem.Collections.IEqualityComparer%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IDictionary%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IDictionary%2CSystem.Collections.IEqualityComparer%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.%23ctor%28System.Int32%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Hashtable.%23ctor%28System.Int32%2CSystem.Collections.IEqualityComparer%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Hashtable.%23ctor%28System.Collections.IEqualityComparer%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.%23ctor%28System.Int32%2CSystem.Single%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Hashtable.%23ctor%28System.Int32%2CSystem.Single%2CSystem.Collections.IEqualityComparer%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.comparer%2A?displayProperty=fullName>|<xref:System.Collections.Hashtable.EqualityComparer%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Collections.Hashtable?displayProperty=fullName>|<xref:System.Collections.Hashtable.hcp%2A?displayProperty=fullName>|`KeyComparer` プロパティを使用してください。|  
+|<xref:System.Diagnostics.Debugger?displayProperty=fullName>|<xref:System.Diagnostics.Debugger.%23ctor%2A>|<xref:System.Diagnostics.Debugger> クラスのインスタンスを作成しないでください。  代わりに、この型の静的メソッドを直接呼び出してください。|  
+|<xref:System.Diagnostics.StackTrace?displayProperty=fullName>|<xref:System.Diagnostics.StackTrace.%23ctor%28System.Threading.Thread%2CSystem.Boolean%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このコンストラクターの使用は推奨されていません。  <xref:System.Threading.Thread> パラメーターを必要としないコンストラクターを使用してください。|  
+|<xref:System.Diagnostics.SymbolStore.ISymbolBinder?displayProperty=fullName>|<xref:System.Diagnostics.SymbolStore.ISymbolBinder.GetReader%2A>|別の方法として、<xref:System.Diagnostics.SymbolStore.ISymbolBinder1.GetReader%2A?displayProperty=fullName> を使用することをお勧めします。この方法では、インポーターのインターフェイス ポインターを <xref:System.IntPtr> ではなく、<xref:System.Int32> として取得するので、32 ビット アーキテクチャと 64 ビット アーキテクチャの両方で機能します。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.Load%28System.String%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.LoadWithPartialName%28System.String%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.LoadWithPartialName%28System.String%2CSystem.Security.Policy.Evidence%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|[Load\(Byte\[\], Byte\<xref:System.Reflection.Assembly.Load%28System.Byte%5B%5D%2CSystem.Byte%5B%5D%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.Load%28System.Reflection.AssemblyName%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.Load%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.LoadFrom%28System.String%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|<xref:System.Reflection.Assembly.LoadFile%28System.String%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.LoadFile%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.Assembly?displayProperty=fullName>|[LoadFrom\(String, Evidence, Byte\<xref:System.Reflection.Assembly.LoadFrom%28System.String%2CSystem.Security.Policy.Evidence%2CSystem.Byte%5B%5D%2CSystem.Configuration.Assemblies.AssemblyHashAlgorithm%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Reflection.Assembly.LoadFrom%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Reflection.AssemblyFlagsAttribute?displayProperty=fullName>|<xref:System.Reflection.AssemblyFlagsAttribute.%23ctor%28System.Int32%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.Reflection.AssemblyFlagsAttribute.%23ctor%28System.Reflection.AssemblyNameFlags%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Reflection.AssemblyFlagsAttribute?displayProperty=fullName>|<xref:System.Reflection.AssemblyFlagsAttribute.%23ctor%28System.UInt32%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.Reflection.AssemblyFlagsAttribute.%23ctor%28System.Reflection.AssemblyNameFlags%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Reflection.AssemblyFlagsAttribute?displayProperty=fullName>|<xref:System.Reflection.AssemblyFlagsAttribute.Flags%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Reflection.AssemblyFlagsAttribute.AssemblyFlags%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Globalization.CultureTypes?displayProperty=fullName>|<xref:System.Globalization.CultureTypes>|この値の使用は推奨されていません。  <xref:System.Globalization.CultureTypes?displayProperty=fullName> の他の値を使用してください。|  
+|<xref:System.Globalization.CultureTypes?displayProperty=fullName>|<xref:System.Globalization.CultureTypes>|この値の使用は推奨されていません。  <xref:System.Globalization.CultureTypes?displayProperty=fullName> の他の値を使用してください。|  
+|<xref:Microsoft.Win32.Registry?displayProperty=fullName>|<xref:Microsoft.Win32.Registry.DynData>|`DynData` レジストリ キーは Win9x でのみ機能し、現在の CLR ではサポートされなくなりました。  NT ベースのオペレーティング システムでは、代わりに、<xref:Microsoft.Win32.Registry.PerformanceData?displayProperty=fullName> レジストリ キーを使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|<xref:System.Security.Policy.Evidence.AddAssembly%2A>|このメソッドは、互換性のために残されています。  代わりに、<xref:System.Security.Policy.Evidence.AddAssemblyEvidence%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|<xref:System.Security.Policy.Evidence.CopyTo%2A>|証拠を <xref:System.Collections.ICollection?displayProperty=fullName> として扱うことはできません。  <xref:System.Security.Policy.Evidence.GetHostEnumerator%2A?displayProperty=fullName> を使用する代わりに、<xref:System.Security.Policy.Evidence.GetAssemblyEnumerator%2A?displayProperty=fullName> メソッドおよび <xref:System.Security.Policy.Evidence.CopyTo%2A> メソッドを使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|<xref:System.Security.Policy.Evidence.Count%2A>|証拠を <xref:System.Collections.ICollection?displayProperty=fullName> として扱うことはできません。  証拠を反復処理してカウントを集計するには、<xref:System.Security.Policy.Evidence.GetHostEnumerator%2A?displayProperty=fullName> および <xref:System.Security.Policy.Evidence.GetAssemblyEnumerator%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|<xref:System.Security.Policy.Evidence.AddHost%2A>|このメソッドは、互換性のために残されています。  代わりに、<xref:System.Security.Policy.Evidence.AddHostEvidence%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|<xref:System.Security.Policy.Evidence.GetEnumerator%2A>|<xref:System.Security.Policy.Evidence.GetEnumerator%2A> は互換性のために残されています。  代わりに、<xref:System.Security.Policy.Evidence.GetHostEnumerator%2A?displayProperty=fullName> および <xref:System.Security.Policy.Evidence.GetAssemblyEnumerator%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.Policy.Evidence?displayProperty=fullName>|[Evidence\(Object\[\], Object\<xref:System.Security.Policy.Evidence.%23ctor%28System.Object%5B%5D%2CSystem.Object%5B%5D%29>|このコンストラクターは今後は使用しません。  代わりに、[Evidence.Evidence\(EvidenceBase\[\], EvidenceBase\<xref:System.Security.Policy.Evidence.%23ctor%28System.Security.Policy.EvidenceBase%5B%5D%2CSystem.Security.Policy.EvidenceBase%5B%5D%29?displayProperty=fullName> コンストラクターを使用してください。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.CreateAppDomainLevel%2A>|AppDomain ポリシー レベルは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.RemoveFullTrustAssembly%28System.Security.Policy.StrongNameMembershipCondition%29>|すべての GAC アセンブリは常に完全に信頼されているので、完全信頼一覧は不要になりました。  信頼を確保するには、GAC のセキュリティ ポリシーで使用されるアセンブリをインストールしてください。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.FullTrustAssemblies%2A>|すべての GAC アセンブリは常に完全に信頼されているので、完全信頼一覧は不要になりました。  信頼を確保するには、GAC のセキュリティ ポリシーで使用されるアセンブリをインストールしてください。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.AddFullTrustAssembly%28System.Security.Policy.StrongName%29>|すべての GAC アセンブリは常に完全に信頼されているので、完全信頼一覧は不要になりました。  信頼を確保するには、GAC のセキュリティ ポリシーで使用されるアセンブリをインストールしてください。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.AddFullTrustAssembly%28System.Security.Policy.StrongNameMembershipCondition%29>|すべての GAC アセンブリは常に完全に信頼されているので、完全信頼一覧は不要になりました。  信頼を確保するには、GAC のセキュリティ ポリシーで使用されるアセンブリをインストールしてください。|  
+|<xref:System.Security.Policy.PolicyLevel?displayProperty=fullName>|<xref:System.Security.Policy.PolicyLevel.RemoveFullTrustAssembly%28System.Security.Policy.StrongName%29>|すべての GAC アセンブリは常に完全に信頼されているので、完全信頼一覧は不要になりました。  信頼を確保するには、GAC のセキュリティ ポリシーで使用されるアセンブリをインストールしてください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetThreadFromFiberCookie%2A>|<xref:System.Runtime.InteropServices.Marshal.GetThreadFromFiberCookie%2A> メソッドの使用は推奨されていません。  この操作を実行するには、ホスト API を使用してください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.ReleaseThreadCache%2A>|この API は操作を実行することはなく、CLR の将来のバージョンでは削除されます。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetManagedThunkForUnmanagedMethodPtr%2A>|<xref:System.Runtime.InteropServices.Marshal.GetManagedThunkForUnmanagedMethodPtr%2A> メソッドの使用は推奨されていません。将来のリリースでは削除されます。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetTypeInfoName%28System.Runtime.InteropServices.UCOMITypeInfo%29>|代わりに、<xref:System.Runtime.InteropServices.Marshal.GetTypeInfoName%28System.Runtime.InteropServices.ComTypes.ITypeInfo%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetTypeLibLcid%28System.Runtime.InteropServices.UCOMITypeLib%29>|代わりに、<xref:System.Runtime.InteropServices.Marshal.GetTypeLibLcid%28System.Runtime.InteropServices.ComTypes.ITypeLib%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetTypeLibName%28System.Runtime.InteropServices.UCOMITypeLib%29>|代わりに、<xref:System.Runtime.InteropServices.Marshal.GetTypeLibName%28System.Runtime.InteropServices.ComTypes.ITypeLib%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetTypeLibGuid%28System.Runtime.InteropServices.UCOMITypeLib%29>|代わりに、<xref:System.Runtime.InteropServices.Marshal.GetTypeLibGuid%28System.Runtime.InteropServices.ComTypes.ITypeLib%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.Marshal?displayProperty=fullName>|<xref:System.Runtime.InteropServices.Marshal.GetUnmanagedThunkForManagedMethodPtr%2A>|<xref:System.Runtime.InteropServices.Marshal.GetUnmanagedThunkForManagedMethodPtr%2A> メソッドの使用は推奨されていません。将来のリリースでは削除されます。|  
+|<xref:System.Runtime.InteropServices.RuntimeEnvironment?displayProperty=fullName>|<xref:System.Runtime.InteropServices.RuntimeEnvironment.%23ctor%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Runtime.InteropServices.RuntimeEnvironment?displayProperty=fullName> クラスのインスタンスを作成しないでください。  代わりに、この型の静的メソッドを直接呼び出してください。|  
+|<xref:System.IO.Stream?displayProperty=fullName>|<xref:System.IO.Stream.CreateWaitHandle%2A?displayProperty=fullName>|<xref:System.IO.Stream.CreateWaitHandle%2A> は最終的に削除されます。  代わりに、`new ManualResetEvent(false)` を使用してください。|  
+|<xref:System.IO.Stream?displayProperty=fullName>|<xref:System.IO.Stream.ObjectInvariant%2A?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドを呼び出したりオーバーライドしたりしないでください。|  
+|<xref:System.IO.FileStream?displayProperty=fullName>|<xref:System.IO.FileStream.%23ctor%28System.IntPtr%2CSystem.IO.FileAccess%2CSystem.Boolean%2CSystem.Int32%2CSystem.Boolean%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.IO.FileStream.%23ctor%28Microsoft.Win32.SafeHandles.SafeFileHandle%2CSystem.IO.FileAccess%2CSystem.Int32%2CSystem.Boolean%29?displayProperty=fullName> を使用してください。必要な場合は、新しい <xref:Microsoft.Win32.SafeHandles.SafeFileHandle?displayProperty=fullName> を `ownsHandle`\=`false` で作成してください。|  
+|<xref:System.IO.FileStream?displayProperty=fullName>|<xref:System.IO.FileStream.%23ctor%28System.IntPtr%2CSystem.IO.FileAccess%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.IO.FileStream.%23ctor%28Microsoft.Win32.SafeHandles.SafeFileHandle%2CSystem.IO.FileAccess%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.IO.FileStream?displayProperty=fullName>|<xref:System.IO.FileStream.Handle%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.IO.FileStream.SafeFileHandle%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.IO.FileStream?displayProperty=fullName>|<xref:System.IO.FileStream.%23ctor%28System.IntPtr%2CSystem.IO.FileAccess%2CSystem.Boolean%2CSystem.Int32%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.IO.FileStream.%23ctor%28Microsoft.Win32.SafeHandles.SafeFileHandle%2CSystem.IO.FileAccess%2CSystem.Int32%29?displayProperty=fullName> を使用してください。必要な場合は、新しい <xref:Microsoft.Win32.SafeHandles.SafeFileHandle?displayProperty=fullName> を `ownsHandle`\=`false` で作成してください。|  
+|<xref:System.IO.FileStream?displayProperty=fullName>|<xref:System.IO.FileStream.%23ctor%28System.IntPtr%2CSystem.IO.FileAccess%2CSystem.Boolean%29>|このコンストラクターの使用は推奨されていません。  代わりに、<xref:System.IO.FileStream.%23ctor%28Microsoft.Win32.SafeHandles.SafeFileHandle%2CSystem.IO.FileAccess%29?displayProperty=fullName> を使用してください。必要な場合は、新しい <xref:Microsoft.Win32.SafeHandles.SafeFileHandle?displayProperty=fullName> を `ownsHandle`\=`false` で作成してください。|  
+|<xref:System.IO.Path?displayProperty=fullName>|<xref:System.IO.Path.InvalidPathChars>|代わりに、<xref:System.IO.Path.GetInvalidPathChars%2A?displayProperty=fullName> または <xref:System.IO.Path.GetInvalidFileNameChars%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.CodeAccessPermission?displayProperty=fullName>|<xref:System.Security.CodeAccessPermission.RevertDeny%2A>|<xref:System.Security.CodeAccessPermission.Deny%2A> は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.CodeAccessPermission?displayProperty=fullName>|<xref:System.Security.CodeAccessPermission.Deny%2A>|<xref:System.Security.CodeAccessPermission.Deny%2A> は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.Permissions.SecurityAction?displayProperty=fullName>|<xref:System.Security.Permissions.SecurityAction>|<xref:System.Security.Permissions.SecurityAction> は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.Permissions.SecurityAction?displayProperty=fullName>|<xref:System.Security.Permissions.SecurityAction>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.Security.Permissions.SecurityAction?displayProperty=fullName>|<xref:System.Security.Permissions.SecurityAction>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.Security.Permissions.SecurityAction?displayProperty=fullName>|<xref:System.Security.Permissions.SecurityAction>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.Security.Permissions.FileIOPermissionAttribute?displayProperty=fullName>|<xref:System.Security.Permissions.FileIOPermissionAttribute.All%2A>|代わりに、<xref:System.Security.Permissions.FileIOPermissionAttribute.ViewAndModify%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Security.Permissions.ReflectionPermissionAttribute?displayProperty=fullName>|<xref:System.Security.Permissions.ReflectionPermissionAttribute.TypeInformation%2A>|この API の使用は推奨されていません。|  
+|<xref:System.Security.Permissions.ReflectionPermissionAttribute?displayProperty=fullName>|<xref:System.Security.Permissions.ReflectionPermissionAttribute.ReflectionEmit%2A>|このアクセス許可は、CLR では使用されなくなりました。|  
+|<xref:System.Security.Permissions.RegistryPermissionAttribute?displayProperty=fullName>|<xref:System.Security.Permissions.RegistryPermissionAttribute.All%2A>|代わりに、<xref:System.Security.Permissions.RegistryPermissionAttribute.ViewAndModify%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName>|<xref:System.Security.Permissions.ReflectionPermissionFlag>|この API の使用は推奨されていません。|  
+|<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName>|<xref:System.Security.Permissions.ReflectionPermissionFlag>|このアクセス許可の使用は推奨されていません。  フル アクセスを取得するには、<xref:System.Security.Permissions.PermissionState?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.Permissions.ReflectionPermissionFlag?displayProperty=fullName>|<xref:System.Security.Permissions.ReflectionPermissionFlag>|このアクセス許可は、CLR では使用されなくなりました。|  
+|<xref:System.Security.SecurityCriticalAttribute?displayProperty=fullName>|<xref:System.Security.SecurityCriticalAttribute.Scope%2A>|<xref:System.Security.SecurityCriticalScope?displayProperty=fullName> は、.NET 2.0 の透過的な互換性のみを目的として使用されます。|  
+|<xref:System.Security.HostSecurityManagerOptions?displayProperty=fullName>|<xref:System.Security.HostSecurityManagerOptions>|AppDomain ポリシー レベルは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.HostSecurityManager?displayProperty=fullName>|<xref:System.Security.HostSecurityManager.DomainPolicy%2A>|AppDomain ポリシー レベルは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.PermissionSet?displayProperty=fullName>|<xref:System.Security.PermissionSet.ConvertPermissionSet%2A>|このメソッドは互換性のために残されていますが、使用しないでください。|  
+|<xref:System.Security.PermissionSet?displayProperty=fullName>|<xref:System.Security.PermissionSet.Deny%2A>|<xref:System.Security.PermissionSet.Deny%2A> は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.SecurityEnabled%2A>|セキュリティをオフにすることはできなくなったので、<xref:System.Security.SecurityManager.SecurityEnabled%2A> プロパティはその効力がなくなりました。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.SavePolicy%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.LoadPolicyLevelFromFile%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.ResolvePolicy%28System.Security.Policy.Evidence%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%2CSystem.Security.PermissionSet%40%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.ResolvePolicy%28System.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.PolicyHierarchy%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|[ResolvePolicy\(Evidence\<xref:System.Security.SecurityManager.ResolvePolicy%28System.Security.Policy.Evidence%5B%5D%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.CheckExecutionRights%2A>|実行するためのアクセス許可チェックをオフにすることはできなくなったので、<xref:System.Security.SecurityManager.CheckExecutionRights%2A> プロパティはその効力がなくなりました。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.ResolvePolicyGroups%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.IsGranted%2A>|<xref:System.Security.SecurityManager.IsGranted%2A> は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  代わりに、<xref:System.AppDomain.PermissionSet%2A?displayProperty=fullName> または <xref:System.Reflection.Assembly.PermissionSet%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.LoadPolicyLevelFromString%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.ResolveSystemPolicy%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.SecurityManager?displayProperty=fullName>|<xref:System.Security.SecurityManager.SavePolicyLevel%2A>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Runtime.Remoting.Channels.ChannelServices?displayProperty=fullName>|<xref:System.Runtime.Remoting.Channels.ChannelServices.RegisterChannel%2A>|代わりに、<xref:System.Runtime.Remoting.Channels.ChannelServices.RegisterChannel%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.Remoting.Lifetime.LifetimeServices?displayProperty=fullName>|<xref:System.Runtime.Remoting.Lifetime.LifetimeServices.%23ctor%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Runtime.Remoting.Lifetime.LifetimeServices> クラスのインスタンスを作成しないでください。  代わりに、この型の静的メソッドを直接呼び出してください。|  
+|<xref:System.Runtime.Remoting.RemotingConfiguration?displayProperty=fullName>|<xref:System.Runtime.Remoting.RemotingConfiguration.Configure%28System.String%29>|代わりに、<xref:System.Runtime.Remoting.RemotingConfiguration.Configure%28System.String%2CSystem.Boolean%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.Remoting.RemotingServices?displayProperty=fullName>|<xref:System.Runtime.Remoting.RemotingServices.LogRemotingStage%2A>|このメソッドの使用は推奨されていません。  <xref:System.Runtime.Remoting.RemotingServices.LogRemotingStage%2A> は、内部診断用にのみ存在しています。|  
+|<xref:System.IO.IsolatedStorage.IsolatedStorage?displayProperty=fullName>|<xref:System.IO.IsolatedStorage.IsolatedStorage.CurrentSize%2A>|<xref:System.IO.IsolatedStorage.IsolatedStorage.CurrentSize%2A> は CLS 準拠ではないので、その使用は推奨されていません。  現在のサイズを取得するには、<xref:System.IO.IsolatedStorage.IsolatedStorage.UsedSize%2A?displayProperty=fullName> を使用します。|  
+|<xref:System.IO.IsolatedStorage.IsolatedStorage?displayProperty=fullName>|<xref:System.IO.IsolatedStorage.IsolatedStorage.MaximumSize%2A>|<xref:System.IO.IsolatedStorage.IsolatedStorage.MaximumSize%2A> は CLS 準拠ではないので、その使用は推奨されていません。  最大サイズを取得するには、<xref:System.IO.IsolatedStorage.IsolatedStorage.Quota%2A?displayProperty=fullName> を使用します。|  
+|<xref:System.IO.IsolatedStorage.IsolatedStorageFileStream?displayProperty=fullName>|<xref:System.IO.IsolatedStorage.IsolatedStorageFileStream.Handle%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.IO.IsolatedStorage.IsolatedStorageFileStream.SafeFileHandle%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.IO.IsolatedStorage.IsolatedStorageFile?displayProperty=fullName>|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.CurrentSize%2A>|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.CurrentSize%2A> は CLS 準拠ではないので、その使用は推奨されていません。  現在のサイズを取得するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.UsedSize%2A> を使用します。|  
+|<xref:System.IO.IsolatedStorage.IsolatedStorageFile?displayProperty=fullName>|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.MaximumSize%2A>|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.MaximumSize%2A> は CLS 準拠ではないので、その使用は推奨されていません。  最大サイズを取得するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.Quota%2A?displayProperty=fullName> を使用します。|  
+|<xref:System.Reflection.Emit.ConstructorBuilder?displayProperty=fullName>|<xref:System.Reflection.Emit.ConstructorBuilder.ReturnType%2A>|このプロパティは推奨されていません。|  
+|<xref:System.Reflection.Emit.FieldBuilder?displayProperty=fullName>|<xref:System.Reflection.Emit.FieldBuilder.SetMarshal%2A>|代替 API を使用できます。代わりに、<xref:System.Runtime.InteropServices.MarshalAsAttribute?displayProperty=fullName> カスタム属性を生成してください。|  
+|<xref:System.Reflection.Emit.MethodBuilder?displayProperty=fullName>|<xref:System.Reflection.Emit.MethodBuilder.SetMarshal%2A>|代替 API を使用できます。代わりに、<xref:System.Runtime.InteropServices.MarshalAsAttribute?displayProperty=fullName> カスタム属性を生成してください。|  
+|<xref:System.Reflection.Emit.OpCodeType?displayProperty=fullName>|<xref:System.Reflection.Emit.OpCodeType>|この API の使用は推奨されていません。|  
+|<xref:System.Reflection.Emit.OperandType?displayProperty=fullName>|<xref:System.Reflection.Emit.OperandType>|この API の使用は推奨されていません。|  
+|<xref:System.Reflection.Emit.FlowControl?displayProperty=fullName>|<xref:System.Reflection.Emit.FlowControl>|この API の使用は推奨されていません。|  
+|<xref:System.Reflection.Emit.ParameterBuilder?displayProperty=fullName>|<xref:System.Reflection.Emit.ParameterBuilder.SetMarshal%2A>|代替 API を使用できます。代わりに、<xref:System.Runtime.InteropServices.MarshalAsAttribute?displayProperty=fullName> カスタム属性を生成してください。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|[AssemblyHash\(AssemblyHashAlgorithm, Byte\<xref:System.Configuration.Assemblies.AssemblyHash.%23ctor%28System.Configuration.Assemblies.AssemblyHashAlgorithm%2CSystem.Byte%5B%5D%29>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash.Algorithm%2A>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|[AssemblyHash\(Byte\<xref:System.Configuration.Assemblies.AssemblyHash.%23ctor%28System.Byte%5B%5D%29>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash.Empty>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash.Clone%2A>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash.SetValue%2A>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash.GetValue%2A>|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName> クラスの使用は推奨されていません。|  
+|<xref:System.Security.Cryptography.PasswordDeriveBytes?displayProperty=fullName>|<xref:System.Security.Cryptography.PasswordDeriveBytes.GetBytes%2A>|パスワードからキー マテリアルを派生する目的で <xref:System.Security.Cryptography.Rfc2898DeriveBytes?displayProperty=fullName> は <xref:System.Security.Cryptography.PasswordDeriveBytes?displayProperty=fullName> を置き換えるものであり、新しいアプリケーションでの使用を推奨されています。|  
+|<xref:System.Security.Cryptography.X509Certificates.X509Certificate?displayProperty=fullName>|<xref:System.Security.Cryptography.X509Certificates.X509Certificate.GetIssuerName%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Security.Cryptography.X509Certificates.X509Certificate.Issuer%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Security.Cryptography.X509Certificates.X509Certificate?displayProperty=fullName>|<xref:System.Security.Cryptography.X509Certificates.X509Certificate.GetName%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Security.Cryptography.X509Certificates.X509Certificate.Subject%2A?displayProperty=fullName> プロパティを使用してください。|  
+  
+<a name="PresentationCore"></a>   
+### アセンブリ: PresentationCore.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Windows.Media.ContainerVisual?displayProperty=fullName>|<xref:System.Windows.Media.ContainerVisual.BitmapEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.ContainerVisual?displayProperty=fullName>|<xref:System.Windows.Media.ContainerVisual.BitmapEffectInput%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.DrawingContext?displayProperty=fullName>|<xref:System.Windows.Media.DrawingContext.PushEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BevelBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BevelBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateBitmapEffectOuter%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.GetOutput%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.InitializeBitmapEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.SetValue%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffectGroup?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BitmapEffectGroup?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BlurBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.BlurBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.DropShadowBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.DropShadowBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.EmbossBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.EmbossBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.OuterGlowBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.CreateUnmanagedEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Effects.OuterGlowBitmapEffect?displayProperty=fullName>|<xref:System.Windows.Media.Effects.BitmapEffect.UpdateUnmanagedPropertyState%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Media3D.Viewport3DVisual?displayProperty=fullName>|<xref:System.Windows.Media.Media3D.Viewport3DVisual.BitmapEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Media3D.Viewport3DVisual?displayProperty=fullName>|<xref:System.Windows.Media.Media3D.Viewport3DVisual.BitmapEffectInput%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.RenderCapability?displayProperty=fullName>|<xref:System.Windows.Media.RenderCapability.IsShaderEffectSoftwareRenderingSupported%2A>|このプロパティの使用は推奨されていません。  代わりに、静的な <xref:System.Windows.Media.RenderCapability.IsPixelShaderVersionSupportedInSoftware%2A?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:System.Windows.Media.Visual?displayProperty=fullName>|<xref:System.Windows.Media.Visual.VisualBitmapEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.Media.Visual?displayProperty=fullName>|<xref:System.Windows.Media.Visual.VisualBitmapEffectInput%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.UIElement?displayProperty=fullName>|<xref:System.Windows.UIElement.BitmapEffect%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.UIElement?displayProperty=fullName>|<xref:System.Windows.UIElement.BitmapEffectInput%2A>|ビットマップ効果は廃止され、機能しなくなりました。  代わりに、必要に応じて <xref:System.Windows.Media.Effects.Effect?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.Windows.UIElement?displayProperty=fullName>|<xref:System.Windows.UIElement.PersistId%2A>|<xref:System.Windows.UIElement.PersistId%2A> は使用が推奨されなくなったプロパティであり、今後のリリースで削除される可能性があります。  このプロパティの値は定義されていません。|  
+  
+<a name="PresFW"></a>   
+### アセンブリ: PresentationFramework.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Windows.Data.BindingListCollectionView?displayProperty=fullName>|<xref:System.Windows.Data.CollectionView.OnBeginChangeLogging%2A>|<xref:System.Windows.Data.CollectionView.OnAllowsCrossThreadChangesChanged%2A>で置き換えられます。|  
+|<xref:System.Windows.Data.CollectionView?displayProperty=fullName>|<xref:System.Windows.Data.CollectionView.ClearChangeLog%2A>|<xref:System.Windows.Data.CollectionView.ClearPendingChanges%2A>で置き換えられます。|  
+|<xref:System.Windows.Data.CollectionView?displayProperty=fullName>|<xref:System.Windows.Data.CollectionView.OnBeginChangeLogging%2A>|<xref:System.Windows.Data.CollectionView.OnAllowsCrossThreadChangesChanged%2A>で置き換えられます。|  
+|<xref:System.Windows.Data.ListCollectionView?displayProperty=fullName>|<xref:System.Windows.Data.ListCollectionView.OnBeginChangeLogging%2A>|<xref:System.Windows.Data.ListCollectionView.OnAllowsCrossThreadChangesChanged%2A?displayProperty=fullName>で置き換えられます。|  
+  
+<a name="Act"></a>   
+### アセンブリ: System.Activities.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Activities.Debugger.XamlDebuggerXmlReader?displayProperty=fullName>|<xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.Xaml.XamlReader%2CSystem.IO.TextReader%29?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このコンストラクターは使用しないでください。  代わりに、<xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.IO.TextReader%29?displayProperty=fullName> タグまたは <xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.IO.TextReader%2CSystem.Xaml.XamlSchemaContext%29?displayProperty=fullName> タグを使用してください。|  
+|<xref:System.Activities.Debugger.XamlDebuggerXmlReader?displayProperty=fullName>|<xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.Xaml.XamlReader%2CSystem.Xaml.IXamlLineInfo%2CSystem.IO.TextReader%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このコンストラクターは使用しないでください。  代わりに、<xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.IO.TextReader%29?displayProperty=fullName> タグまたは <xref:System.Activities.Debugger.XamlDebuggerXmlReader.%23ctor%28System.IO.TextReader%2CSystem.Xaml.XamlSchemaContext%29?displayProperty=fullName> タグを使用してください。|  
+  
+<a name="ActPres"></a>   
+### アセンブリ: System.Activities.Presentation.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.DoDragMove%28System.Activities.Presentation.WorkflowViewElement%2CSystem.Windows.Point%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  <xref:System.Activities.Presentation.DragDropHelper.DoDragMove%28System.Collections.Generic.IEnumerable%7BSystem.Activities.Presentation.WorkflowViewElement%7D%2CSystem.Windows.Point%29> を使用してください。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.GetCompositeView%28System.Windows.DragEventArgs%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  <xref:System.Activities.Presentation.DragDropHelper.GetCompositeView%28System.Activities.Presentation.WorkflowViewElement%29> を使用してください。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.GetDragDropCompletedEffects%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  代わりに <xref:System.Activities.Presentation.DragDropHelper.SetDragDropMovedViewElements%28System.Windows.DragEventArgs%2CSystem.Collections.Generic.IEnumerable%7BSystem.Activities.Presentation.WorkflowViewElement%7D%29> を使用することを検討してください。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.GetDraggedModelItem%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  <xref:System.Activities.Presentation.DragDropHelper.GetDraggedModelItems%2A> を使用してください。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.GetDroppedObject%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  <xref:System.Activities.Presentation.DragDropHelper.GetDroppedObjects%2A> を使用してください。|  
+|<xref:System.Activities.Presentation.DragDropHelper?displayProperty=fullName>|<xref:System.Activities.Presentation.DragDropHelper.SetDragDropCompletedEffects%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは、複数のアイテムのドラッグをサポートしていません。  代わりに <xref:System.Activities.Presentation.DragDropHelper.SetDragDropMovedViewElements%2A> を使用することを検討してください。|  
+|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs?displayProperty=fullName>|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.ItemsAdded%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このプロパティは使用しないでください。  代わりに、<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.ModelChangeInfo%2A> を使用してください。|  
+|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs?displayProperty=fullName>|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.ItemsRemoved%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このプロパティは使用しないでください。  代わりに、<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.ModelChangeInfo%2A> を使用してください。|  
+|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs?displayProperty=fullName>|<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.PropertiesChanged%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このプロパティは使用しないでください。  代わりに、<xref:System.Activities.Presentation.Services.ModelChangedEventArgs.ModelChangeInfo%2A> を使用してください。|  
+  
+<a name="core"></a>   
+### アセンブリ: System.Core.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Diagnostics.Eventing.Reader.StandardEventKeywords?displayProperty=fullName>|<xref:System.Diagnostics.Eventing.Reader.StandardEventKeywords>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> 値が無効です。代わりに <xref:System.Diagnostics.Eventing.Reader.StandardEventKeywords> を使用してください。|  
+|<xref:System.Linq.Expressions.Expression?displayProperty=fullName>|<xref:System.Linq.Expressions.Expression.%23ctor%28System.Linq.Expressions.ExpressionType%2CSystem.Type%29>|<xref:System.Linq.Expressions.ExpressionType?displayProperty=fullName> 引数を取らない別のコンストラクターを使用してください。  次に、<xref:System.Linq.Expressions.Expression.NodeType%2A?displayProperty=fullName> プロパティと <xref:System.Linq.Expressions.Expression.Type%2A?displayProperty=fullName> プロパティをオーバーライドして、このコンストラクターに指定される値を指定します。|  
+|<xref:System.Linq.Expressions.MemberBinding?displayProperty=fullName>|<xref:System.Linq.Expressions.MemberBinding.%23ctor%2A>|このコンストラクターは使用しないでください。  将来のリリースで削除されます。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.GroupJoin%60%604%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%2CSystem.Func%7B%60%600%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2C%60%603%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%602%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Union%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Except%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Zip%2A>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.GroupJoin%60%604%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%2CSystem.Func%7B%60%600%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2C%60%603%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Union%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Intersect%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Intersect%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Concat%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.SequenceEqual%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.SequenceEqual%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Join%60%604%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%2CSystem.Func%7B%60%600%2C%60%601%2C%60%603%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%602%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Join%60%604%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%601%7D%2CSystem.Func%7B%60%600%2C%60%602%7D%2CSystem.Func%7B%60%601%2C%60%602%7D%2CSystem.Func%7B%60%600%2C%60%601%2C%60%603%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Linq.ParallelEnumerable?displayProperty=fullName>|<xref:System.Linq.ParallelEnumerable.Except%60%601%28System.Linq.ParallelQuery%7B%60%600%7D%2CSystem.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Collections.Generic.IEqualityComparer%7B%60%600%7D%29>|二項演算子の 2 番目のデータ ソースは、<xref:System.Linq.ParallelQuery%601?displayProperty=fullName> ではなく、<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> の型である必要があります。  この問題を解決するには、<xref:System.Linq.ParallelEnumerable.AsParallel%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29> 拡張メソッドを使用して、適切なデータ ソースを <xref:System.Linq.ParallelQuery%601?displayProperty=fullName> に変換します。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.GetMatch%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.GetCachedRules%60%601%28System.Runtime.CompilerServices.RuleCache%7B%60%600%7D%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.AddRule%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.ClearMatch%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.UpdateRules%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.Bind%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.CreateMatchmaker%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.SetNotMatched%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.GetRules%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.GetRuleCache%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.CallSiteOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.CallSiteOps.MoveRule%60%601%28System.Runtime.CompilerServices.RuleCache%7B%60%600%7D%2C%60%600%2CSystem.Int32%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.ExpandoTryGetValue%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.ExpandoCheckVersion%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|[CreateRuntimeVariables\(Object\[\], Int64\<xref:System.Runtime.CompilerServices.RuntimeOps.CreateRuntimeVariables%28System.Object%5B%5D%2CSystem.Int64%5B%5D%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.ExpandoPromoteClass%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.ExpandoTryDeleteValue%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.ExpandoTrySetValue%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.Quote%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.MergeRuntimeVariables%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:System.Runtime.CompilerServices.RuntimeOps?displayProperty=fullName>|<xref:System.Runtime.CompilerServices.RuntimeOps.CreateRuntimeVariables>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+  
+<a name="data"></a>   
+### アセンブリ: System.Data.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Data.DataSysDescriptionAttribute?displayProperty=fullName>|<xref:System.Data.DataSysDescriptionAttribute.%23ctor%2A>|<xref:System.Data.DataSysDescriptionAttribute> の使用は推奨されていません。|  
+|<xref:System.Data.Common.DataAdapter?displayProperty=fullName>|<xref:System.Data.Common.DataAdapter.CloneInternals%2A>|<xref:System.Data.Common.DataAdapter.CloneInternals%2A> の使用は推奨されていません。  <xref:System.Data.Common.DataAdapter.%23ctor%28System.Data.Common.DataAdapter%29> コンストラクターを使用してください。|  
+|<xref:System.Data.Common.DBDataPermission?displayProperty=fullName>|<xref:System.Data.Common.DBDataPermission.%23ctor>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このコンストラクターの使用は推奨されていません。  <xref:System.Data.Common.DBDataPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.Common.DBDataPermission?displayProperty=fullName>|<xref:System.Data.Common.DBDataPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このコンストラクターの使用は推奨されていません。  <xref:System.Data.Common.DBDataPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.Odbc.OdbcParameterCollection?displayProperty=fullName>|<xref:System.Data.Odbc.OdbcParameterCollection.Add%28System.String%2CSystem.Object%29>|<xref:System.Data.Odbc.OdbcParameterCollection.Add%28System.String%2CSystem.Object%29> の使用は推奨されていません。  <xref:System.Data.Odbc.OdbcParameterCollection.AddWithValue%28System.String%2CSystem.Object%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Data.Odbc.OdbcPermission?displayProperty=fullName>|<xref:System.Data.Odbc.OdbcPermission.%23ctor>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.Odbc.OdbcPermission.%23ctor> の使用は推奨されていません。  <xref:System.Data.Odbc.OdbcPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.Odbc.OdbcPermission?displayProperty=fullName>|<xref:System.Data.Odbc.OdbcPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.Odbc.OdbcPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29> の使用は推奨されていません。  <xref:System.Data.Odbc.OdbcPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.OleDb.OleDbParameterCollection?displayProperty=fullName>|<xref:System.Data.OleDb.OleDbParameterCollection.Add%28System.String%2CSystem.Object%29>|<xref:System.Data.OleDb.OleDbParameterCollection.Add%28System.String%2CSystem.Object%29> の使用は推奨されていません。  <xref:System.Data.OleDb.OleDbParameterCollection.AddWithValue%2A?displayProperty=fullName> メソッドを使用します。|  
+|<xref:System.Data.OleDb.OleDbPermission?displayProperty=fullName>|<xref:System.Data.OleDb.OleDbPermission.%23ctor>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.OleDb.OleDbPermission.%23ctor> の使用は推奨されていません。  <xref:System.Data.OleDb.OleDbPermission.%23ctor%28System.Security.Permissions.PermissionState%29> に <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.OleDb.OleDbPermission?displayProperty=fullName>|<xref:System.Data.OleDb.OleDbPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.OleDb.OleDbPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29> の使用は推奨されていません。  <xref:System.Data.OleDb.OleDbPermission.%23ctor%28System.Security.Permissions.PermissionState%29> に <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.OleDb.OleDbPermission?displayProperty=fullName>|<xref:System.Data.OleDb.OleDbPermission.Provider%2A>|<xref:System.Data.OleDb.OleDbPermission.Provider%2A> プロパティの使用は推奨されていません。  <xref:System.Data.Common.DBDataPermission.Add%28System.String%2CSystem.String%2CSystem.Data.KeyRestrictionBehavior%29> メソッドを使用します。|  
+|<xref:System.Data.OleDb.OleDbPermissionAttribute?displayProperty=fullName>|<xref:System.Data.OleDb.OleDbPermissionAttribute.Provider%2A>|<xref:System.Data.OleDb.OleDbPermissionAttribute.Provider%2A> プロパティの使用は推奨されていません。  <xref:System.Data.Common.DBDataPermission.Add%28System.String%2CSystem.String%2CSystem.Data.KeyRestrictionBehavior%29> メソッドを使用します。|  
+|<xref:System.Data.SqlClient.SqlClientPermission?displayProperty=fullName>|<xref:System.Data.SqlClient.SqlClientPermission.%23ctor>|このコンストラクターを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.SqlClient.SqlClientPermission.%23ctor> の使用は推奨されていません。  <xref:System.Data.SqlClient.SqlClientPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.SqlClient.SqlClientPermission?displayProperty=fullName>|<xref:System.Data.SqlClient.SqlClientPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29>|このコンストラクターを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Data.SqlClient.SqlClientPermission.%23ctor%28System.Security.Permissions.PermissionState%2CSystem.Boolean%29> の使用は推奨されていません。  <xref:System.Data.SqlClient.SqlClientPermission.%23ctor%28System.Security.Permissions.PermissionState%29> コンストラクターに <xref:System.Security.Permissions.PermissionState?displayProperty=fullName> の値を渡します。|  
+|<xref:System.Data.SqlClient.SqlConnectionStringBuilder?displayProperty=fullName>|<xref:System.Data.SqlClient.SqlConnectionStringBuilder.ConnectionReset%2A>|<xref:System.Data.SqlClient.SqlConnectionStringBuilder.ConnectionReset%2A> の使用は推奨されていません。  <xref:System.Data.SqlClient.SqlConnection?displayProperty=fullName> は 'connection reset' キーワードを無視して、常に接続をリセットします。|  
+|<xref:System.Data.SqlClient.SqlParameterCollection?displayProperty=fullName>|<xref:System.Data.SqlClient.SqlParameterCollection.Add%28System.String%2CSystem.Object%29>|<xref:System.Data.SqlClient.SqlParameterCollection.Add%28System.String%2CSystem.Object%29> の使用は推奨されていません。  <xref:System.Data.SqlClient.SqlParameterCollection.AddWithValue%2A?displayProperty=fullName> を使用してください。|  
+  
+<a name="entity"></a>   
+### アセンブリ: System.Data.Entity.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Data.Metadata.Edm.AssociationSetEnd?displayProperty=fullName>|<xref:System.Data.Metadata.Edm.AssociationSetEnd.Role%2A>|このプロパティは削除されます。代わりに、<xref:System.Data.Metadata.Edm.AssociationSetEnd.Name%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Data.Metadata.Edm.MetadataWorkspace?displayProperty=fullName>|<xref:System.Data.Metadata.Edm.MetadataWorkspace.GetRequiredOriginalValueMembers%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> 代わりに、<xref:System.Data.Metadata.Edm.MetadataWorkspace.GetRelevantMembersForUpdate%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Data.Objects.ObjectContext?displayProperty=fullName>|<xref:System.Data.Objects.ObjectContext.ApplyPropertyChanges%2A>|代わりに、<xref:System.Data.Objects.ObjectContext.ApplyCurrentValues%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Data.Objects.ObjectContext?displayProperty=fullName>|<xref:System.Data.Objects.ObjectContext.SaveChanges%28System.Boolean%29>|代わりに、<xref:System.Data.Objects.ObjectContext.SaveChanges%28System.Data.Objects.SaveOptions%29> を使用してください。|  
+  
+<a name="oracleclient"></a>   
+### アセンブリ: System.Data.OracleClient.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Data.OracleClient.OracleParameter?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleParameter.Scale%2A>|<xref:System.Data.OracleClient.OracleParameter.Scale%2A> の使用は推奨されていません。  10 進数の小数点以下桁数を明示的に設定するには、<xref:System.Math?displayProperty=fullName> クラスを使用してください。|  
+|<xref:System.Data.OracleClient.OracleParameter?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleParameter.Precision%2A>|<xref:System.Data.OracleClient.OracleParameter.Precision%2A> の使用は推奨されていません。  10 進数の有効桁数を明示的に設定するには、<xref:System.Math?displayProperty=fullName> クラスを使用してください。|  
+|<xref:System.Data.OracleClient.OracleParameterCollection?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleParameterCollection.Add%28System.String%2CSystem.Object%29>|<xref:System.Data.OracleClient.OracleParameterCollection.Add%28System.String%2CSystem.Object%29> の使用は推奨されていません。  <xref:System.Data.OracleClient.OracleParameterCollection.AddWithValue%2A?displayProperty=fullName> を使用してください。|  
+  
+<a name="design"></a>   
+### アセンブリ: System.Design.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.ComponentModel.Design.ComponentDesigner?displayProperty=fullName>|<xref:System.ComponentModel.Design.ComponentDesigner.OnSetComponentDefaults%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.ComponentDesigner.InitializeNewComponent%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.ComponentDesigner?displayProperty=fullName>|<xref:System.ComponentModel.Design.ComponentDesigner.InitializeNonDefault%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.ComponentDesigner.InitializeExistingComponent%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.DesignSurface?displayProperty=fullName>|<xref:System.ComponentModel.Design.DesignSurface.CreateComponent%2A>|<xref:System.ComponentModel.Design.DesignSurface.CreateComponent%2A> メソッドは <xref:System.ComponentModel.Design.DesignSurface.CreateInstance%28System.Type%29>に置き換えられました。|  
+|<xref:System.ComponentModel.Design.Serialization.CodeDomSerializer?displayProperty=fullName>|<xref:System.ComponentModel.Design.Serialization.CodeDomSerializer.SerializeToReferenceExpression%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.Serialization.CodeDomSerializer.SerializeToExpression%2A> タグまたは <xref:System.ComponentModel.Design.Serialization.CodeDomSerializerBase.GetExpression%2A> タグを使用してください。|  
+|<xref:System.Windows.Forms.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Windows.Forms.Design.ControlDesigner.OnSetComponentDefaults%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Windows.Forms.Design.ControlDesigner.InitializeNewComponent%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.ShouldCodeSerialize%2A>|コードのシリアル化がサポートされていないので、このプロパティの使用は推奨されていません。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.Behavior%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.Tag%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.OnBehaviorAttached%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.Tag%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.OnBehaviorDetaching%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.Tag%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.OnBindingsCollectionChanged%2A>|別の方法として、`HtmlControlDesigner.DataBindings.Changed` イベントを処理することをお勧めします。  <xref:System.Web.UI.DataBindingCollection> プロパティによって返される <xref:System.Web.UI.Design.HtmlControlDesigner.DataBindings%2A?displayProperty=fullName> コレクションを使用すると、コントロールに関連付けられているデータ バインディングの制御を強化できます。|  
+|<xref:System.Web.UI.Design.HtmlControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.HtmlControlDesigner.DesignTimeElement%2A>|このプロパティを使用すると、コンパイラ エラーが発生します。<br /><br /> エラー: このプロパティは参照できなくなりましたが、コンパイル済みの既存のアプリケーションをサポートするために含まれています。  デザイン時の要素によっては、マークアップ要素へのアクセスが提供されない場合があります。  <xref:System.Web.UI.Design.WebFormsRootDesigner?displayProperty=fullName> には、クライアント スクリプトとコントロールを処理する際の別のメソッドがあります。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.ReadOnly%2A>|別の方法として、<xref:System.Web.UI.Design.ContainerControlDesigner?displayProperty=fullName> から継承して、<xref:System.Web.UI.Design.EditableDesignerRegion?displayProperty=fullName> を使用することをお勧めします。  デザイナーの各領域を使用すると、コンテンツの制御を強化できます。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.IsPropertyBound%2A>|別の方法として、`System.Web.UI.Design.ControlDesigner.DataBindings.Contains` を使用することをお勧めします。  <xref:System.Web.UI.DataBindingCollection?displayProperty=fullName> クラスを使用すると、コントロールに関連付けられているデータ バインディングの制御を強化できます。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.DesignTimeHtmlRequiresLoadComplete%2A>|別の方法として、`ControlDesigner.SetViewFlags(ViewFlags.DesignTimeHtmlRequiresLoadComplete, true)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.IsDirty%2A>|別の方法として、`System.Web.UI.Design.ControlDesigner.Tag.SetDirty` および `System.Web.UI.Design.ControlDesigner.Tag.IsDirty` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.RaiseResizeEvent%2A>|サイズ変更は <xref:System.Web.UI.Design.ControlDesigner.OnComponentChanged%2A?displayProperty=fullName> メソッドによって処理されるので、このメソッドの使用は推奨されていません。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.GetPersistInnerHtml%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.GetPersistenceContent%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.OnBindingsCollectionChanged%2A>|別の方法として、`ControlDesigner.DataBindings.Changed` イベントを処理することをお勧めします。  <xref:System.Web.UI.DataBindingCollection> プロパティによって返される `ControlDesigner.DataBindings` コレクションを使用すると、コントロールに関連付けられているデータ バインディングの制御を強化できます。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.OnControlResize%2A>|推奨される別の方法は、コントロールの任意のプロパティが変更されると呼び出される <xref:System.Web.UI.Design.ControlDesigner.OnComponentChanged%2A> です。|  
+|<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.ControlDesigner.DesignTimeElementView%2A>|このプロパティを使用すると、コンパイラ エラーが発生します。<br /><br /> エラー: このプロパティは参照できなくなりましたが、コンパイル済みの既存のアプリケーションをサポートするために含まれています。  デザイン時の要素のビュー アーキテクチャは使用されなくなりました。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetTemplateContainerDataSource%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.InTemplateMode%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.InTemplateMode%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetTemplateEditingVerbs%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.ActiveTemplateEditingFrame%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このプロパティの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetTemplateContainerDataItemProperty%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.EnterTemplateMode%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.ExitTemplateMode%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.SetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetTemplatePropertyParentType%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.CreateTemplateEditingFrame%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.GetCachedTemplateEditingVerbs%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplatedControlDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.TemplatedControlDesigner.OnBehaviorAttached%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.Tag%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.WebControls.BaseDataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.BaseDataListDesigner.GetTemplateContainerDataSource%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.BaseDataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.BaseDataListDesigner.OnAutoFormat%2A>|このメソッドの使用は、**\[オートフォーマット\]** ダイアログ ボックスがデザイナー ホストによって起動されるため、推奨されていません。  使用できる \[オートフォーマット\] の一覧は、 <xref:System.Web.UI.Design.ControlDesigner.AutoFormats%2A?displayProperty=fullName> プロパティによって公開されています。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.CreateTemplateEditingFrame%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.GetCachedTemplateEditingVerbs%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.GetTemplateContainerDataItemProperty%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.SetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.GetTemplatePropertyParentType%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataGridDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataGridDesigner.GetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataListDesigner.GetCachedTemplateEditingVerbs%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataListDesigner.GetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataListDesigner.GetTemplateContainerDataItemProperty%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.DataListDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.DataListDesigner.SetTemplateContent%2A>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、このメソッドの使用は推奨されていません。  テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.PanelDesigner?displayProperty=fullName>|<xref:System.Web.UI.Design.WebControls.PanelDesigner.OnBehaviorAttached%2A>|別の方法として、<xref:System.Web.UI.Design.ControlDesigner.Tag%2A?displayProperty=fullName> を使用することをお勧めします。|  
+  
+<a name="system"></a>   
+### アセンブリ: System.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.ComponentModel.AsyncCompletedEventArgs?displayProperty=fullName>|<xref:System.ComponentModel.AsyncCompletedEventArgs.%23ctor>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.ComponentModel.MemberDescriptor?displayProperty=fullName>|<xref:System.ComponentModel.MemberDescriptor.GetInvokee%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.ComponentModel.MemberDescriptor.GetInvocationTarget%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.TypeDescriptor?displayProperty=fullName>|<xref:System.ComponentModel.TypeDescriptor.ComNativeDescriptorHandler%2A>|このプロパティは推奨されていません。  代わりに、COM 型の型情報を提供する型説明のプロバイダーを使用してください。|  
+|<xref:System.ComponentModel.Design.DesignerTransactionCloseEventArgs?displayProperty=fullName>|<xref:System.ComponentModel.Design.DesignerTransactionCloseEventArgs.%23ctor%28System.Boolean%29>|このコンストラクターは今後は使用しません。  代わりに、<xref:System.ComponentModel.Design.DesignerTransactionCloseEventArgs.%23ctor%28System.Boolean%2CSystem.Boolean%29> を使用してください。|  
+|<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName>|<xref:System.ComponentModel.Design.SelectionTypes>|この値の使用は推奨されていません。  サポート対象から除外されました。|  
+|<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName>|<xref:System.ComponentModel.Design.SelectionTypes>|この値の使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName>|<xref:System.ComponentModel.Design.SelectionTypes>|この値の使用は推奨されていません。  <xref:System.Enum?displayProperty=fullName> クラス メソッドを使用して有効な値を判断するか、型コンバーターを使用してください。|  
+|<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName>|<xref:System.ComponentModel.Design.SelectionTypes>|この値の使用は推奨されていません。  サポート対象から除外されました。|  
+|<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName>|<xref:System.ComponentModel.Design.SelectionTypes>|この値の使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.SelectionTypes?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.ViewTechnology?displayProperty=fullName>|<xref:System.ComponentModel.Design.ViewTechnology>|この値の使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.ViewTechnology?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.ViewTechnology?displayProperty=fullName>|<xref:System.ComponentModel.Design.ViewTechnology>|この値の使用は推奨されていません。  代わりに、<xref:System.ComponentModel.Design.ViewTechnology?displayProperty=fullName> を使用してください。|  
+|<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName>|<xref:System.CodeDom.Compiler.CodeDomProvider.CreateGenerator>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeGenerator?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。  <xref:System.CodeDom.Compiler.CodeDomProvider> から継承した内容でインターフェイスが実装されることには変わりがないので、この警告を除外するか、このメソッドを互換性のために残してください。|  
+|<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName>|<xref:System.CodeDom.Compiler.CodeDomProvider.CreateCompiler%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。  <xref:System.CodeDom.Compiler.CodeDomProvider> から継承した内容でインターフェイスが実装されることには変わりがないので、この警告を除外するか、このメソッドを互換性のために残してください。|  
+|<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName>|<xref:System.CodeDom.Compiler.CodeDomProvider.CreateParser%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeParser?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。  <xref:System.CodeDom.Compiler.CodeDomProvider> から継承した内容でインターフェイスが実装されることには変わりがないので、この警告を除外するか、このメソッドを互換性のために残してください。|  
+|<xref:System.CodeDom.Compiler.CompilerParameters?displayProperty=fullName>|<xref:System.CodeDom.Compiler.CompilerParameters.Evidence%2A>|CAS ポリシーは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  詳しくは、「[.NET Framework 4 におけるセキュリティの変更点](http://go2.microsoft.com/fwlink/?LinkId=131738)」をご覧ください|  
+|<xref:System.CodeDom.Compiler.CompilerResults?displayProperty=fullName>|<xref:System.CodeDom.Compiler.CompilerResults.Evidence%2A>|CAS ポリシーは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  詳しくは、「[.NET Framework 4 におけるセキュリティの変更点](http://go2.microsoft.com/fwlink/?LinkId=131738)」をご覧ください|  
+|<xref:System.Collections.Specialized.NameObjectCollectionBase?displayProperty=fullName>|<xref:System.Collections.Specialized.NameObjectCollectionBase.%23ctor%28System.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Specialized.NameObjectCollectionBase.%23ctor%28System.Collections.IEqualityComparer%29> を使用してください。|  
+|<xref:System.Collections.Specialized.NameObjectCollectionBase?displayProperty=fullName>|<xref:System.Collections.Specialized.NameObjectCollectionBase.%23ctor%28System.Int32%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Specialized.NameObjectCollectionBase.%23ctor%28System.Int32%2CSystem.Collections.IEqualityComparer%29> を使用してください。|  
+|<xref:System.Collections.Specialized.NameValueCollection?displayProperty=fullName>|<xref:System.Collections.Specialized.NameValueCollection.%23ctor%28System.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Specialized.NameValueCollection.%23ctor%28System.Collections.IEqualityComparer%29> を使用してください。|  
+|<xref:System.Collections.Specialized.NameValueCollection?displayProperty=fullName>|<xref:System.Collections.Specialized.NameValueCollection.%23ctor%28System.Int32%2CSystem.Collections.IHashCodeProvider%2CSystem.Collections.IComparer%29>|代わりに、<xref:System.Collections.Specialized.NameValueCollection.%23ctor%28System.Int32%2CSystem.Collections.IEqualityComparer%29> を使用してください。|  
+|<xref:Microsoft.Win32.SystemEvents?displayProperty=fullName>|<xref:Microsoft.Win32.SystemEvents.LowMemory>|このイベントの使用は推奨されていません。|  
+|<xref:Microsoft.CSharp.CSharpCodeProvider?displayProperty=fullName>|<xref:Microsoft.CSharp.CSharpCodeProvider.CreateGenerator%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeGenerator?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。|  
+|<xref:Microsoft.CSharp.CSharpCodeProvider?displayProperty=fullName>|<xref:Microsoft.CSharp.CSharpCodeProvider.CreateCompiler%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。|  
+|<xref:Microsoft.VisualBasic.VBCodeProvider?displayProperty=fullName>|<xref:Microsoft.VisualBasic.VBCodeProvider.CreateGenerator%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeGenerator?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。|  
+|<xref:Microsoft.VisualBasic.VBCodeProvider?displayProperty=fullName>|<xref:Microsoft.VisualBasic.VBCodeProvider.CreateCompiler%2A>|呼び出し元では、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> インターフェイスを使用する代わりに、<xref:System.CodeDom.Compiler.CodeDomProvider?displayProperty=fullName> クラスのメソッドを直接使用してください。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.MakeRelative%2A>|このメソッドの使用は推奨されていません。  <xref:System.Uri.MakeRelativeUri%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.%23ctor%28System.String%2CSystem.Boolean%29>|このコンストラクターの使用は推奨されていません。  <xref:System.Uri.%23ctor%28System.String%29> を使用してください。  `dontEscape` パラメーターの使用は推奨されていません。値は常に、`false` です。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.%23ctor%28System.Uri%2CSystem.String%2CSystem.Boolean%29>|このコンストラクターの使用は推奨されていません。  <xref:System.Uri.%23ctor%28System.Uri%2CSystem.String%29> を使用してください。  `dontEscape` パラメーターの使用は推奨されていません。値は常に、`false` です。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.EscapeString%2A>|このメソッドの使用は推奨されていません。  Uri のコンポーネントまたは文字列をエスケープするには、<xref:System.Uri.GetComponents%2A> または静的な <xref:System.Uri.EscapeUriString%2A> メソッドを使用します。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.IsExcludedCharacter%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.Parse%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.Canonicalize%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.Escape%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.Unescape%2A>|このメソッドの使用は推奨されていません。  Uri のコンポーネントまたは文字列をエスケープするには、<xref:System.Uri.GetComponents%2A?displayProperty=fullName> または静的な <xref:System.Uri.EscapeUriString%2A?displayProperty=fullName> メソッドを使用します。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.CheckSecurity%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.IsReservedCharacter%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Uri?displayProperty=fullName>|<xref:System.Uri.IsBadFileSystemCharacter%2A>|このメソッドの使用は推奨されていません。  これは、システムでは使用されません。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.GetHostByAddress%28System.String%29>|<xref:System.Net.Dns.GetHostByAddress%28System.String%29> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.GetHostEntry%28System.String%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.GetHostByAddress%28System.Net.IPAddress%29>|<xref:System.Net.Dns.GetHostByAddress%28System.Net.IPAddress%29> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.GetHostEntry%28System.Net.IPAddress%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.GetHostByName%2A>|<xref:System.Net.Dns.GetHostByName%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.GetHostEntry%28System.String%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.BeginResolve%28System.String%2CSystem.AsyncCallback%2CSystem.Object%29>|<xref:System.Net.Dns.BeginResolve%28System.String%2CSystem.AsyncCallback%2CSystem.Object%29> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.BeginGetHostEntry%28System.String%2CSystem.AsyncCallback%2CSystem.Object%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.EndResolve%2A>|<xref:System.Net.Dns.EndResolve%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.EndGetHostEntry%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.Resolve%2A>|<xref:System.Net.Dns.Resolve%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.GetHostEntry%28System.String%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.BeginGetHostByName%2A>|<xref:System.Net.Dns.BeginGetHostByName%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.BeginGetHostEntry%28System.String%2CSystem.AsyncCallback%2CSystem.Object%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Dns?displayProperty=fullName>|<xref:System.Net.Dns.EndGetHostByName%2A>|<xref:System.Net.Dns.EndGetHostByName%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Dns.EndGetHostEntry%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.FileWebRequest?displayProperty=fullName>|<xref:System.Net.FileWebRequest.%23ctor%2A>|シリアル化は、この型では廃止されています。|  
+|<xref:System.Net.FileWebResponse>|<xref:System.Net.FileWebResponse.%23ctor%2A>|シリアル化は、この型では廃止されています。|  
+|<xref:System.Net.HttpWebRequest?displayProperty=fullName>|<xref:System.Net.HttpWebRequest.%23ctor>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.HttpWebRequest?displayProperty=fullName>|<xref:System.Net.HttpWebRequest.%23ctor%28System.Runtime.Serialization.SerializationInfo%2CSystem.Runtime.Serialization.StreamingContext%29>|シリアル化は、この型では廃止されています。|  
+|<xref:System.Net.HttpWebResponse?displayProperty=fullName>|<xref:System.Net.HttpWebResponse.%23ctor>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.HttpWebResponse?displayProperty=fullName>|<xref:System.Net.HttpWebResponse.%23ctor%2A>|シリアル化は、この型では廃止されています。|  
+|<xref:System.Net.IPAddress?displayProperty=fullName>|<xref:System.Net.IPAddress.Address%2A>|このプロパティは推奨されていません。  アドレス ファミリに依存しています。  比較を実行するには、<xref:System.Net.IPAddress.Equals%2A?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:System.Net.ServicePointManager?displayProperty=fullName>|<xref:System.Net.ServicePointManager.CertificatePolicy%2A>|<xref:System.Net.ServicePointManager.CertificatePolicy%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.ServicePointManager.ServerCertificateValidationCallback%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.WebClient?displayProperty=fullName>|<xref:System.Net.WebClient.AllowReadStreamBuffering%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebClient?displayProperty=fullName>|<xref:System.Net.WebClient.AllowWriteStreamBuffering%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebClient?displayProperty=fullName>|<xref:System.Net.WebClient.OnWriteStreamClosed%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebClient?displayProperty=fullName>|<xref:System.Net.WebClient.WriteStreamClosed>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebProxy?displayProperty=fullName>|<xref:System.Net.WebProxy.GetDefaultProxy%2A>|このメソッドの使用は推奨されていません。  既定で選択されているプロキシを使用してください。|  
+|<xref:System.Net.WebRequest?displayProperty=fullName>|<xref:System.Net.WebRequest.CreatorInstance%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebRequest?displayProperty=fullName>|<xref:System.Net.WebRequest.RegisterPortableWebRequestCreator%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WebSockets.WebSocket?displayProperty=fullName>|<xref:System.Net.WebSockets.WebSocket.IsApplicationTargeting45%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーは内部使用のみを目的としています、.NET Framework の将来のバージョンでは削除されます。  このメンバーは呼び出さないでください。|  
+|<xref:System.Net.WriteStreamClosedEventArgs?displayProperty=fullName>|<xref:System.Net.WriteStreamClosedEventArgs.%23ctor%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.WriteStreamClosedEventArgs?displayProperty=fullName>|<xref:System.Net.WriteStreamClosedEventArgs.Error%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.NetworkInformation.NetworkChange?displayProperty=fullName>|<xref:System.Net.NetworkInformation.NetworkChange.%23ctor>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.NetworkInformation.NetworkChange?displayProperty=fullName>|<xref:System.Net.NetworkInformation.NetworkChange.RegisterNetworkChange%28System.Net.NetworkInformation.NetworkChange%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.Socket?displayProperty=fullName>|<xref:System.Net.Sockets.Socket.SupportsIPv6%2A>|<xref:System.Net.Sockets.Socket.SupportsIPv6%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Sockets.Socket.OSSupportsIPv6%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Sockets.Socket?displayProperty=fullName>|<xref:System.Net.Sockets.Socket.SupportsIPv4%2A>|<xref:System.Net.Sockets.Socket.SupportsIPv4%2A> は、この型の互換性のために残されています。代わりに、<xref:System.Net.Sockets.Socket.OSSupportsIPv4%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Net.Sockets.SocketAsyncEventArgs?displayProperty=fullName>|<xref:System.Net.Sockets.SocketAsyncEventArgs.SocketClientAccessPolicyProtocol>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.TcpListener?displayProperty=fullName>|<xref:System.Net.Sockets.TcpListener.%23ctor%28System.Int32%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Net.Sockets.TcpListener.%23ctor%28System.Net.IPAddress%2CSystem.Int32%29> を使用してください。|  
+|<xref:System.Net.Mail.MailMessage?displayProperty=fullName>|<xref:System.Net.Mail.MailMessage.ReplyTo%2A>|<xref:System.Net.Mail.MailMessage.ReplyTo%2A> は、この型の互換性のために残されています。  代わりに、複数のアドレスを受け入れることができる <xref:System.Net.Mail.MailMessage.ReplyToList%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%2CSystem.Exception%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Security.Claims.DynamicRoleClaimProvider?displayProperty=fullName>|<xref:System.Security.Claims.DynamicRoleClaimProvider.AddDynamicRoleClaims%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> <xref:System.Security.Claims.ClaimsAuthenticationManager> を使用して、<xref:System.Security.Claims.ClaimsIdentity> にクレームを追加します。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.GetXmlNodeLineNumber%2A>|このクラスは今後は使用しません。  代わりに、<xref:System.Configuration.ConfigurationErrorsException.GetLineNumber%28System.Xml.XmlNode%29> を使用してください|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%2CSystem.String%2CSystem.Int32%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%2CSystem.Exception%2CSystem.String%2CSystem.Int32%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%2CSystem.Xml.XmlNode%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.%23ctor%28System.String%2CSystem.Exception%2CSystem.Xml.XmlNode%29>|このクラスは今後は使用しません。  新しい例外を作成するには、<xref:System.Configuration.ConfigurationErrorsException?displayProperty=fullName> を作成してください。|  
+|<xref:System.Configuration.ConfigurationException?displayProperty=fullName>|<xref:System.Configuration.ConfigurationException.GetXmlNodeFilename%2A>|このクラスは今後は使用しません。  代わりに、<xref:System.Configuration.ConfigurationErrorsException.GetFilename%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Configuration.ConfigurationSettings?displayProperty=fullName>|<xref:System.Configuration.ConfigurationSettings.AppSettings%2A>|このメソッドは、互換性のために残されています。  代わりに <xref:System.Configuration.ConfigurationManager.AppSettings%2A?displayProperty=fullName> が導入されました。|  
+|<xref:System.Configuration.ConfigurationSettings?displayProperty=fullName>|<xref:System.Configuration.ConfigurationSettings.GetConfig%2A>|このメソッドは、互換性のために残されています。  代わりに <xref:System.Configuration.ConfigurationManager.GetSection%2A?displayProperty=fullName> が導入されました。|  
+|<xref:System.Diagnostics.EventLog?displayProperty=fullName>|<xref:System.Diagnostics.EventLog.CreateEventSource%28System.String%2CSystem.String%2CSystem.String%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.EventLog.CreateEventSource%28System.Diagnostics.EventSourceCreationData%29> を使用してください。|  
+|<xref:System.Diagnostics.EventLogEntry?displayProperty=fullName>|<xref:System.Diagnostics.EventLogEntry.EventID%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.EventLogEntry.InstanceId%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName>|<xref:System.Diagnostics.EventLogPermissionAccess>|このメンバーの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName>|<xref:System.Diagnostics.EventLogPermissionAccess>|このメンバーの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName>|<xref:System.Diagnostics.EventLogPermissionAccess>|このメンバーの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.EventLogPermissionAccess?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.InstanceDataCollection?displayProperty=fullName>|<xref:System.Diagnostics.InstanceDataCollection.%23ctor%2A>|このコンストラクターの使用は推奨されていません。  このコレクションのインスタンスを取得するには、代わりに、<xref:System.Diagnostics.InstanceDataCollectionCollection.Item%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.InstanceDataCollectionCollection?displayProperty=fullName>|<xref:System.Diagnostics.InstanceDataCollectionCollection.%23ctor%2A>|このコンストラクターの使用は推奨されていません。  このコレクションのインスタンスを取得するには、代わりに、<xref:System.Diagnostics.PerformanceCounterCategory.ReadCategory%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounter?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounter.DefaultFileMappingSize>|このフィールドの使用は推奨されておらず、使用されなくなっています。  <xref:System.Diagnostics.PerformanceCounter?displayProperty=fullName> ファイル マップのサイズを設定するには、machine.config またはアプリケーション構成ファイルを使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterCategory?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterCategory.Create%28System.String%2CSystem.String%2CSystem.String%2CSystem.String%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounterCategory.Create%28System.String%2CSystem.String%2CSystem.Diagnostics.PerformanceCounterCategoryType%2CSystem.String%2CSystem.String%29> を使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterCategory?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterCategory.Create%28System.String%2CSystem.String%2CSystem.Diagnostics.CounterCreationDataCollection%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounterCategory.Create%28System.String%2CSystem.String%2CSystem.Diagnostics.PerformanceCounterCategoryType%2CSystem.Diagnostics.CounterCreationDataCollection%29> を使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterManager?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterManager.%23ctor%2A>|このクラスの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounter?displayProperty=fullName> クラスからパフォーマンス カウンターを使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterManager?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterManager.System%23Diagnostics%23ICollectData%23CollectData%2A>|このクラスの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounter> クラスからパフォーマンス カウンターを使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterManager?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterManager.System%23Diagnostics%23ICollectData%23CloseData%2A>|このクラスの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounter> クラスからパフォーマンス カウンターを使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterPermissionAccess?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterPermissionAccess>|このメンバーの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounterPermissionAccess?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.PerformanceCounterPermissionAccess?displayProperty=fullName>|<xref:System.Diagnostics.PerformanceCounterPermissionAccess>|このメンバーの使用は推奨されていません。  代わりに、<xref:System.Diagnostics.PerformanceCounterPermissionAccess?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.WorkingSet%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.WorkingSet64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.VirtualMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.VirtualMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PeakPagedMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PeakPagedMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PrivateMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PrivateMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PagedSystemMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PagedSystemMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.NonpagedSystemMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.NonpagedSystemMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PeakVirtualMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PeakVirtualMemorySize64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PeakWorkingSet%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PeakWorkingSet64%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Process?displayProperty=fullName>|<xref:System.Diagnostics.Process.PagedMemorySize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Diagnostics.Process.PagedMemorySize64%2A> を使用してください。|  
+  
+<a name="drawing"></a>   
+### アセンブリ: System.Drawing.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Drawing.FontFamily?displayProperty=fullName>|<xref:System.Drawing.FontFamily.GetFamilies%2A>|<xref:System.Drawing.FontFamily.GetFamilies%2A> メソッドを使用しないでください。代わりに、<xref:System.Drawing.FontFamily.Families%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Drawing.Imaging.EncoderParameter?displayProperty=fullName>|<xref:System.Drawing.Imaging.EncoderParameter.%23ctor%28System.Drawing.Imaging.Encoder%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このコンストラクターの使用は推奨されていません。  <xref:System.Drawing.Imaging.EncoderParameter.%23ctor%28System.Drawing.Imaging.Encoder%2CSystem.Int32%2CSystem.Drawing.Imaging.EncoderParameterValueType%2CSystem.IntPtr%29> を使用してください。|  
+  
+<a name="messaging"></a>   
+### アセンブリ: System.Messaging.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Messaging.MessageQueue?displayProperty=fullName>|<xref:System.Messaging.MessageQueue.GetEnumerator%2A>|このメソッドは、<xref:System.Messaging.MessageEnumerator?displayProperty=fullName> メソッド ファミリを正しく実装していない <xref:System.Messaging.MessageEnumerator.RemoveCurrent%2A?displayProperty=fullName> を返します。  代わりに、<xref:System.Messaging.MessageQueue.GetMessageEnumerator2%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Messaging.MessageQueue?displayProperty=fullName>|<xref:System.Messaging.MessageQueue.GetMessageEnumerator%2A>|このメソッドは、<xref:System.Messaging.MessageEnumerator?displayProperty=fullName> メソッド ファミリを正しく実装していない <xref:System.Messaging.MessageEnumerator.RemoveCurrent%2A?displayProperty=fullName> を返します。  代わりに、<xref:System.Messaging.MessageQueue.GetMessageEnumerator2%2A?displayProperty=fullName> を使用してください。|  
+  
+<a name="servicemodel"></a>   
+### アセンブリ: System.ServiceModel.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.ServiceModel.BasicHttpBinding?displayProperty=fullName>|<xref:System.ServiceModel.BasicHttpBinding.EnableHttpCookieContainer%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このプロパティは今後使用しません。  Http <xref:System.Net.CookieContainer> を有効にするには、代わりに <xref:System.ServiceModel.BasicHttpBinding.AllowCookies%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.ServiceModel.Configuration.BindingsSection?displayProperty=fullName>|<xref:System.ServiceModel.Configuration.BindingsSection.NetPeerTcpBinding%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Dispatcher.ClientOperationCompatBase?displayProperty=fullName>|<xref:System.ServiceModel.Dispatcher.ClientOperationCompatBase.ParameterInspectors%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.ServiceModel.Dispatcher.ClientRuntimeCompatBase?displayProperty=fullName>|<xref:System.ServiceModel.Dispatcher.ClientRuntimeCompatBase.MessageInspectors%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.ServiceModel.Dispatcher.ClientRuntimeCompatBase?displayProperty=fullName>|<xref:System.ServiceModel.Dispatcher.ClientRuntimeCompatBase.Operations%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.ServiceModel.Security.WindowsClientCredential?displayProperty=fullName>|<xref:System.ServiceModel.Security.WindowsClientCredential.AllowNtlm%2A>|このプロパティの使用は推奨されていません。下位互換性のためだけに保持されています。  NTLM を使用するかどうかを判断する場合には、ローカル コンピューター ポリシーが使用されます。|  
+  
+<a name="smDisc"></a>   
+### アセンブリ: System.ServiceModel.Discovery.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint?displayProperty=fullName>|<xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint.TransportSettings%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> <xref:System.ServiceModel.Discovery.UdpAnnouncementEndpoint.TransportSettings%2A> は互換性のために残されています。  トランスポート プロパティを設定するには、<xref:System.ServiceModel.Channels.UdpTransportBindingElement?displayProperty=fullName> を使用することを検討してください。|  
+|<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint?displayProperty=fullName>|<xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint.TransportSettings%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> <xref:System.ServiceModel.Discovery.UdpDiscoveryEndpoint.TransportSettings%2A> は互換性のために残されています。  トランスポート プロパティを設定する際は、<xref:System.ServiceModel.Channels.UdpTransportBindingElement?displayProperty=fullName> を使用することを検討してください。|  
+  
+<a name="datavisualization"></a>   
+### アセンブリ: System.Web.DataVisualization.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Web.UI.DataVisualization.Charting.Chart?displayProperty=fullName>|<xref:System.Web.UI.DataVisualization.Charting.Chart.ViewStateData%2A>|<xref:System.Web.UI.DataVisualization.Charting.Chart.ViewStateData%2A> の使用は推奨されていません。  代わりに、<xref:System.Web.UI.Control.ViewState%2A?displayProperty=fullName> の使用を検討してください。|  
+  
+<a name="web"></a>   
+### アセンブリ: System.Web.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:System.Web.Configuration.AuthenticationMode?displayProperty=fullName>|<xref:System.Web.Configuration.AuthenticationMode>|このフィールドは、互換性のために残されています。  パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Configuration.AuthenticationSection?displayProperty=fullName>|<xref:System.Web.Configuration.AuthenticationSection.Passport%2A>|このプロパティは今後使用しません。  パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Configuration.HttpCapabilitiesBase?displayProperty=fullName>|<xref:System.Web.Configuration.HttpCapabilitiesBase.JavaScript%2A>|別の方法として、<xref:System.Web.Configuration.HttpCapabilitiesBase.EcmaScriptVersion%2A?displayProperty=fullName> プロパティを使用することをお勧めします。  <xref:System.Version.Major%2A?displayProperty=fullName> のバージョン値が 1 以上である場合は、JavaScript のサポートを意味します。|  
+|<xref:System.Web.Configuration.SystemWebSectionGroup?displayProperty=fullName>|<xref:System.Web.Configuration.SystemWebSectionGroup.MobileControls%2A>|System.Web.Mobile.dll は、互換性のために残されています。|  
+|<xref:System.Web.HttpContext?displayProperty=fullName>|<xref:System.Web.HttpContext.GetAppConfig%2A>|別の方法として、System.Web.dll の <xref:System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.HttpContext?displayProperty=fullName>|<xref:System.Web.HttpContext.GetConfig%2A>|別の方法として、System.Web.dll の <xref:System.Web.HttpContext.GetSection%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.HttpUtility?displayProperty=fullName>|<xref:System.Web.HttpUtility.UrlEncodeUnicode%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドでは、標準に準拠しない出力が生成されるので、相互運用性に問題があります。  別の方法として、<xref:System.Web.HttpUtility.UrlEncode%28System.String%29> を使用することをお勧めします。|  
+|<xref:System.Web.HttpUtility?displayProperty=fullName>|<xref:System.Web.HttpUtility.UrlEncodeUnicodeToBytes%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドでは、標準に準拠しない出力が生成されるので、相互運用性に問題があります。  別の方法として、<xref:System.Web.HttpUtility.UrlEncodeToBytes%28System.String%29> を使用することをお勧めします。|  
+|<xref:System.Web.Routing.UrlRoutingModule?displayProperty=fullName>|<xref:System.Web.Routing.UrlRoutingModule.PostMapRequestHandler%2A>|このメソッドは、互換性のために残されています。  <xref:System.Web.Routing.UrlRoutingModule.Init%2A> イベントを使用するには、 <xref:System.Web.Routing.UrlRoutingModule.PostMapRequestHandler%2A> メソッドをオーバーライドします。|  
+|<xref:System.Web.Security.FormsAuthentication?displayProperty=fullName>|<xref:System.Web.Security.FormsAuthentication.Authenticate%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> 別の方法として、<xref:System.Web.Security.Membership?displayProperty=fullName> のような <xref:System.Web.Security.Membership.ValidateUser%2A?displayProperty=fullName> API を使用することをお勧めします。|  
+|<xref:System.Web.Security.FormsAuthentication?displayProperty=fullName>|<xref:System.Web.Security.FormsAuthentication.HashPasswordForStoringInConfigFile%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> 別の方法として、<xref:System.Web.Security.Membership?displayProperty=fullName> のような <xref:System.Web.Security.Membership.CreateUser%2A?displayProperty=fullName> API を使用することをお勧めします。|  
+|<xref:System.Web.Security.MachineKey?displayProperty=fullName>|<xref:System.Web.Security.MachineKey.Decode%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは廃止されました。現在は既存のコードとの互換性のためだけに提供されています。  代わりに、新しいコードで <xref:System.Web.Security.MachineKey.Protect%2A> メソッドと <xref:System.Web.Security.MachineKey.Unprotect%2A> メソッドを使用することをお勧めします。|  
+|<xref:System.Web.Security.MachineKey?displayProperty=fullName>|<xref:System.Web.Security.MachineKey.Encode%2A>|最初に .NET Framework 4.5 で廃止されました。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.FileDependencies%2A>|別の方法として、<xref:System.Web.HttpResponse.AddFileDependencies%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.RegisterOnSubmitStatement%2A>|別の方法として、`Page.ClientScript.RegisterOnSubmitStatement(Type type, String key, String script)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.RegisterArrayDeclaration%2A>|別の方法として、`Page.ClientScript.RegisterArrayDeclaration(String arrayName, String arrayValue)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.GetPostBackClientEvent%2A>|別の方法として、`Page.ClientScript.GetPostBackEventReference` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.GetPostBackClientHyperlink%2A>|別の方法として、`Page.ClientScript.GetPostBackClientHyperlink` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.IsStartupScriptRegistered%2A>|別の方法として、`Page.ClientScript.IsStartupScriptRegistered(String key)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.RegisterHiddenField%2A>|別の方法として、`Page.ClientScript.RegisterHiddenField(String hiddenFieldName, String hiddenFieldInitialValue)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.RegisterClientScriptBlock%2A>|別の方法として、`PageClientScript.RegisterClientScriptBlock(Type type, String key, String script)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.SmartNavigation%2A>|別の方法として、<xref:System.Web.UI.Page.SetFocus%2A?displayProperty=fullName> および <xref:System.Web.UI.Page.MaintainScrollPositionOnPostback%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.GetPostBackEventReference%28System.Web.UI.Control%29>|別の方法として、`Page.ClientScript.GetPostBackEventReference` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.RegisterStartupScript%2A>|別の方法として、`Page.ClientScript.RegisterStartupScript(Type type, String key, String script)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.IsClientScriptBlockRegistered%2A>|別の方法として、`Page.ClientScript.IsClientScriptBlockRegistered(String key)` を使用することをお勧めします。|  
+|<xref:System.Web.UI.Page?displayProperty=fullName>|<xref:System.Web.UI.Page.GetPostBackEventReference%28System.Web.UI.Control%2CSystem.String%29>|別の方法として、`Page.ClientScript.GetPostBackEventReference` を使用することをお勧めします。|  
+|<xref:System.Web.UI.TemplateControl?displayProperty=fullName>|<xref:System.Web.UI.TemplateControl.AutoHandlers%2A>|役に立たなくなったため、このプロパティの使用は推奨されていません。|  
+|<xref:System.Web.UI.WebControls.GridView?displayProperty=fullName>|<xref:System.Web.UI.WebControls.GridView.CreateAutoGeneratedColumn%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメソッドは下位互換性のために残されています。  この API は現在は使用されていません。|  
+|<xref:System.Web.UI.WebControls.Xml?displayProperty=fullName>|<xref:System.Web.UI.WebControls.Xml.Document%2A>|別の方法として、<xref:System.Web.UI.WebControls.Xml.XPathNavigator%2A?displayProperty=fullName> プロパティを使用することをお勧めします。  <xref:System.Xml.XPath.XPathDocument?displayProperty=fullName> を作成するには、<xref:System.Xml.XPath.XPathDocument.CreateNavigator%2A?displayProperty=fullName> を作成して、<xref:System.Xml.XPath.XPathNavigator?displayProperty=fullName> を呼び出します。|  
+  
+<a name="dynamicdata"></a>   
+### アセンブリ: System.Web.DynamicData.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Web.DynamicData.DynamicDataExtensions?displayProperty=fullName>|<xref:System.Web.DynamicData.DynamicDataExtensions.EnablePersistedSelection%2A>|`EnablePersistedSelection` や <xref:System.Web.UI.WebControls.GridView?displayProperty=fullName> など、データ バインディング コントロールの <xref:System.Web.UI.WebControls.ListView?displayProperty=fullName> プロパティを使用してください。|  
+  
+<a name="extensions"></a>   
+### アセンブリ: System.Web.Extensions.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Web.UI.CompositeScriptReference>|<xref:System.Web.UI.CompositeScriptReference.IsFromSystemWebExtensions%2A>|<xref:System.Web.UI.CompositeScriptReference.IsAjaxFrameworkScript%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.ScriptReferenceBase?displayProperty=fullName>|<xref:System.Web.UI.ScriptReferenceBase.NotifyScriptLoaded%2A>|スクリプト参照では、<xref:System.Web.UI.ScriptReferenceBase.NotifyScriptLoaded%2A> は不要になりました。|  
+|<xref:System.Web.UI.ScriptReferenceBase?displayProperty=fullName>|<xref:System.Web.UI.ScriptReferenceBase.IsFromSystemWebExtensions%2A>|<xref:System.Web.UI.ScriptReferenceBase.IsAjaxFrameworkScript%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.ScriptManager?displayProperty=fullName>|<xref:System.Web.UI.ScriptManager.ScriptPath%2A>|このプロパティは今後使用しません。  代わりに、<xref:System.Web.UI.ScriptReference.Path%2A> ごとに <xref:System.Web.UI.ScriptReference?displayProperty=fullName> プロパティを設定してください。|  
+|<xref:System.Web.UI.ScriptReference?displayProperty=fullName>|<xref:System.Web.UI.ScriptReference.IgnoreScriptPath%2A>|このプロパティは今後使用しません。  <xref:System.Web.UI.ScriptManager.ScriptPath%2A?displayProperty=fullName> を使用する代わりに、<xref:System.Web.UI.ScriptReference.Path%2A> ごとに <xref:System.Web.UI.ScriptReference?displayProperty=fullName> プロパティを設定してください。|  
+|<xref:System.Web.UI.ScriptReference?displayProperty=fullName>|<xref:System.Web.UI.ScriptReference.IsFromSystemWebExtensions%2A>|<xref:System.Web.UI.ScriptReference.IsAjaxFrameworkScript%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.ScriptResourceAttribute?displayProperty=fullName>|<xref:System.Web.UI.ScriptResourceAttribute.TypeName%2A>|このプロパティは今後使用しません。  代わりに、<xref:System.Web.UI.ScriptResourceAttribute.StringResourceClientTypeName%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.ScriptResourceAttribute?displayProperty=fullName>|<xref:System.Web.UI.ScriptResourceAttribute.ScriptResourceName%2A>|このプロパティは今後使用しません。  代わりに、<xref:System.Web.UI.ScriptResourceAttribute.StringResourceName%2A?displayProperty=fullName> を使用してください。|  
+  
+<a name="services"></a>   
+### アセンブリ: System.Web.Services.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Web.Services.Protocols.SoapHeaderAttribute?displayProperty=fullName>|<xref:System.Web.Services.Protocols.SoapHeaderAttribute.Required%2A>|このプロパティは、将来のバージョンでは削除されます。  SOAP メッセージ内の特定のヘッダーは必須ではなくなりました。|  
+|<xref:System.Web.Services.Discovery.DiscoveryClientProtocol?displayProperty=fullName>|<xref:System.Web.Services.Discovery.DiscoveryClientProtocol.LoadExternals%2A>|このメソッドは、将来のバージョンでは削除されます。  リソースの検出では、このメソッド呼び出しは不要になりました。|  
+  
+<a name="forms"></a>   
+### アセンブリ: System.Windows.Forms.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Windows.Forms.AccessibleStates?displayProperty=fullName>|<xref:System.Windows.Forms.AccessibleStates>|この列挙値の使用は推奨されていません。  これに代わる機能はありません。|  
+|<xref:System.Windows.Forms.ComboBox?displayProperty=fullName>|<xref:System.Windows.Forms.ComboBox.AddItemsCore%2A>|このメソッドの使用は推奨されていません。  これに代わる機能はありません。|  
+|<xref:System.Windows.Forms.Control?displayProperty=fullName>|<xref:System.Windows.Forms.Control.RenderRightToLeft%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Windows.Forms.Control.RightToLeft%2A?displayProperty=fullName> を使用してください。|  
+|<xref:System.Windows.Forms.Control?displayProperty=fullName>|<xref:System.Windows.Forms.Control.Scale%28System.Single%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Windows.Forms.Control.Scale%28System.Drawing.SizeF%29?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:System.Windows.Forms.Control?displayProperty=fullName>|<xref:System.Windows.Forms.Control.Scale%28System.Single%2CSystem.Single%29>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Windows.Forms.Control.Scale%28System.Drawing.SizeF%29?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:System.Windows.Forms.Form?displayProperty=fullName>|<xref:System.Windows.Forms.Form.ApplyAutoScaling%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A> メソッドを使用してください。|  
+|<xref:System.Windows.Forms.Form?displayProperty=fullName>|<xref:System.Windows.Forms.Form.GetAutoScaleSize%2A>|このメソッドの使用は推奨されていません。  代わりに、<xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Windows.Forms.Form?displayProperty=fullName>|<xref:System.Windows.Forms.Form.AutoScale%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Windows.Forms.Label?displayProperty=fullName>|<xref:System.Windows.Forms.Label.RenderTransparent%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Windows.Forms.Control.BackColor%2A> を使用してください。|  
+|<xref:System.Windows.Forms.ListBox?displayProperty=fullName>|<xref:System.Windows.Forms.ListBox.AddItemsCore%2A>|このメソッドの使用は推奨されていません。  これに代わる機能はありません。|  
+|<xref:System.Windows.Forms.PrintPreviewDialog?displayProperty=fullName>|<xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A>|このプロパティは推奨されていません。  代わりに、<xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A?displayProperty=fullName> プロパティを使用してください。|  
+  
+<a name="xaml"></a>   
+### アセンブリ: System.Xaml.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute?displayProperty=fullName>|<xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute.%23ctor%28System.Type%2CSystem.Type%29>|`expressionType` 引数は、XAML パーサーで使用されなくなりました。  有効な戻り値の型を指定するには、<xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute.%23ctor%28System.Type%29?displayProperty=fullName> を使用します。  式の型に対するカスタム ハンドリングを指定するには、<xref:System.Windows.Markup.XamlSetMarkupExtensionAttribute?displayProperty=fullName> を使用します。|  
+|<xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute?displayProperty=fullName>|<xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute.ExpressionType%2A>|これは、XAML パーサーでは使用されなくなりました。  <xref:System.Windows.Markup.XamlSetMarkupExtensionAttribute?displayProperty=fullName> を参照してください。|  
+  
+<a name="xml"></a>   
+### アセンブリ: System.Xml.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Xml.XmlConvert?displayProperty=fullName>|<xref:System.Xml.XmlConvert.ToDateTime%28System.String%29>|<xref:System.Xml.XmlConvert.ToDateTime%28System.String%2CSystem.Xml.XmlDateTimeSerializationMode%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Xml.XmlConvert?displayProperty=fullName>|<xref:System.Xml.XmlConvert.ToString%28System.DateTime%29>|<xref:System.Xml.XmlConvert.ToString%28System.DateTime%2CSystem.Xml.XmlDateTimeSerializationMode%29?displayProperty=fullName> を使用してください。|  
+|<xref:System.Xml.ValidationType?displayProperty=fullName>|<xref:System.Xml.ValidationType>|検証型は <xref:System.Xml.ValidationType?displayProperty=fullName> または <xref:System.Xml.ValidationType?displayProperty=fullName> として指定してください。|  
+|<xref:System.Xml.ValidationType?displayProperty=fullName>|<xref:System.Xml.ValidationType>|<xref:System.Xml.XmlValidatingReader?displayProperty=fullName> を使用した XDR 検証は、廃止されました。|  
+|<xref:System.Xml.XmlReaderSettings?displayProperty=fullName>|<xref:System.Xml.XmlReaderSettings.%23ctor%28System.Xml.XmlResolver%29>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Xml.XmlReaderSettings?displayProperty=fullName>|<xref:System.Xml.XmlReaderSettings.ProhibitDtd%2A>|代わりに、<xref:System.Xml.XmlReaderSettings.DtdProcessing%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Xml.XmlTextReader?displayProperty=fullName>|<xref:System.Xml.XmlTextReader.ProhibitDtd%2A>|代わりに、<xref:System.Xml.XmlTextReader.DtdProcessing%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Xml.Schema.XmlSchema?displayProperty=fullName>|<xref:System.Xml.Schema.XmlSchema.Compile%28System.Xml.Schema.ValidationEventHandler%29>|スキーマ コンパイルおよび検証には、<xref:System.Xml.Schema.XmlSchemaSet> を使用してください。|  
+|<xref:System.Xml.Schema.XmlSchema?displayProperty=fullName>|<xref:System.Xml.Schema.XmlSchema.Compile%28System.Xml.Schema.ValidationEventHandler%2CSystem.Xml.XmlResolver%29>|スキーマ コンパイルおよび検証には、<xref:System.Xml.Schema.XmlSchemaSet> を使用してください。|  
+|<xref:System.Xml.Schema.XmlSchemaAttribute?displayProperty=fullName>|<xref:System.Xml.Schema.XmlSchemaAttribute.AttributeType%2A>|このプロパティは推奨されていません。  厳密に型指定された属性型を返す <xref:System.Xml.Schema.XmlSchemaAttribute.AttributeSchemaType%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Xml.Schema.XmlSchemaType?displayProperty=fullName>|<xref:System.Xml.Schema.XmlSchemaType.BaseSchemaType%2A>|このプロパティは推奨されていません。  厳密に型指定された基本スキーマ型を返す <xref:System.Xml.Schema.XmlSchemaType.BaseXmlSchemaType%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Xml.Schema.XmlSchemaElement?displayProperty=fullName>|<xref:System.Xml.Schema.XmlSchemaElement.ElementType%2A>|このプロパティは推奨されていません。  厳密に型指定された要素型を返す <xref:System.Xml.Schema.XmlSchemaElement.ElementSchemaType%2A?displayProperty=fullName> プロパティを使用してください。|  
+|<xref:System.Xml.Serialization.CodeIdentifier?displayProperty=fullName>|<xref:System.Xml.Serialization.CodeIdentifier.%23ctor%2A>|このクラスには静的メソッドのみが含まれているので、このクラスは構築しないでください。|  
+|<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>|[FromMappings\(XmlMapping\<xref:System.Xml.Serialization.XmlSerializer.FromMappings%28System.Xml.Serialization.XmlMapping%5B%5D%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Xml.Serialization.XmlSerializer.FromMappings%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+|<xref:System.Xml.Serialization.XmlSerializer?displayProperty=fullName>|[XmlSerializer\(Type, XmlAttributeOverrides, Type\<xref:System.Xml.Serialization.XmlSerializer.%23ctor%28System.Type%2CSystem.Xml.Serialization.XmlAttributeOverrides%2CSystem.Type%5B%5D%2CSystem.Xml.Serialization.XmlRootAttribute%2CSystem.String%2CSystem.String%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Xml.Serialization.XmlSerializer.%23ctor%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のコンストラクター オーバーロードを使用してください。|  
+|<xref:System.Xml.Serialization.XmlSerializerFactory?displayProperty=fullName>|[CreateSerializer\(Type, XmlAttributeOverrides, Type\<xref:System.Xml.Serialization.XmlSerializerFactory.CreateSerializer%28System.Type%2CSystem.Xml.Serialization.XmlAttributeOverrides%2CSystem.Type%5B%5D%2CSystem.Xml.Serialization.XmlRootAttribute%2CSystem.String%2CSystem.String%2CSystem.Security.Policy.Evidence%29>|このメソッドは互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。  <xref:System.Xml.Serialization.XmlSerializerFactory.CreateSerializer%2A?displayProperty=fullName> パラメーターを受け取らない <xref:System.Security.Policy.Evidence?displayProperty=fullName> のオーバーロードを使用してください。|  
+  
+<a name="MicrosoftMembers"></a>   
+## 互換性のために残されている Microsoft アセンブリのメンバー  
+ 次の表に、互換性のために残されている Microsoft アセンブリのメンバーを示します。  これらのアセンブリは特殊な目的のアセンブリであり、個別の言語 \(Microsoft.VisualBasic.dll など\) やビルド システム \(Microsoft.Build.Engine.dll など\) を対象としたアセンブリが含まれています。  
+  
+<a name="IEHost"></a>   
+### アセンブリ: IEHost.dll and IEExec.exe  
+ IEHost.dll および IEExec.exe アセンブリは .NET Framework から削除されています。  そのすべての型およびメンバーは廃止され、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] ではサポートされていません。  これらのアセンブリは Internet Explorer で Windows フォーム コントロールをホストし、実行可能ファイルを実行するために使用されていました。  代替手段としては、ClickOnce、XAML ブラウザー アプリケーション \(XBAP\)、および Microsoft Silverlight をお勧めします。  
+  
+<a name="isymwrapper"></a>   
+### アセンブリ: ISymWrapper.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:System.Diagnostics.SymbolStore.SymBinder?displayProperty=fullName>|<xref:System.Diagnostics.SymbolStore.SymBinder.GetReader%28System.Int32%2CSystem.String%2CSystem.String%29>|別の方法として、<xref:System.Diagnostics.SymbolStore.SymBinder.GetReader%28System.IntPtr%2CSystem.String%2CSystem.String%29?displayProperty=fullName> を使用することをお勧めします。  <xref:System.Diagnostics.SymbolStore.ISymbolBinder1.GetReader%2A?displayProperty=fullName> は、インポーターのインターフェイス ポインターを <xref:System.IntPtr?displayProperty=fullName> ではなく、<xref:System.Int32?displayProperty=fullName> として取得するので、32 ビット アーキテクチャと 64 ビット アーキテクチャの両方で機能します。|  
+  
+<a name="conversion"></a>   
+### アセンブリ: Microsoft.Build.Conversion.v4.0.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:Microsoft.Build.Conversion.ProjectFileConverter?displayProperty=fullName>|<xref:Microsoft.Build.Conversion.ProjectFileConverter.ConvertInMemory%28Microsoft.Build.BuildEngine.Engine%2CMicrosoft.Build.BuildEngine.ProjectLoadSettings%29>|代わりに、パラメーターなしの <xref:Microsoft.Build.Conversion.ProjectFileConverter.ConvertInMemory?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:Microsoft.Build.Conversion.ProjectFileConverter?displayProperty=fullName>|<xref:Microsoft.Build.Conversion.ProjectFileConverter.ConvertInMemory%28Microsoft.Build.BuildEngine.Engine%29>|代わりに、パラメーターなしの <xref:Microsoft.Build.Conversion.ProjectFileConverter.ConvertInMemory?displayProperty=fullName> メソッドを使用してください。|  
+|<xref:Microsoft.Build.Conversion.ProjectFileConverter?displayProperty=fullName>|<xref:Microsoft.Build.Conversion.ProjectFileConverter.Convert%28System.String%29>|代わりに、パラメーターなしの <xref:Microsoft.Build.Conversion.ProjectFileConverter.Convert> オーバーロードを使用してください。|  
+|<xref:Microsoft.Build.Conversion.ProjectFileConverter?displayProperty=fullName>|<xref:Microsoft.Build.Conversion.ProjectFileConverter.Convert%28Microsoft.Build.BuildEngine.ProjectLoadSettings%29>|代わりに、パラメーターなしの <xref:Microsoft.Build.Conversion.ProjectFileConverter.Convert> オーバーロードを使用してください。|  
+  
+<a name="engine"></a>   
+### アセンブリ: Microsoft.Build.Engine.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:Microsoft.Build.BuildEngine.Engine?displayProperty=fullName>|<xref:Microsoft.Build.BuildEngine.Engine.%23ctor%28System.String%29>|.NET Framework の場所を <xref:Microsoft.Build.BuildEngine.Engine.BinPath%2A> として単純に渡そうとしていた場合は、パラメーターなしの <xref:Microsoft.Build.BuildEngine.Engine.%23ctor?displayProperty=fullName> コンストラクターに変更するだけです。  それ以外の場合は、カスタム ツールセットをレジストリまたは構成ファイルに定義するか、エンジンの <xref:Microsoft.Build.BuildEngine.ToolsetCollection?displayProperty=fullName> に要素を追加できます。  次に、<xref:Microsoft.Build.BuildEngine.Engine.%23ctor?displayProperty=fullName> コンストラクターまたは <xref:Microsoft.Build.BuildEngine.Engine.%23ctor%28Microsoft.Build.BuildEngine.ToolsetDefinitionLocations%29?displayProperty=fullName> コンストラクターを代わりに使用してください。|  
+|<xref:Microsoft.Build.BuildEngine.Engine?displayProperty=fullName>|<xref:Microsoft.Build.BuildEngine.Engine.BinPath%2A>|<xref:Microsoft.Build.BuildEngine.Engine.BinPath%2A> を設定しないようにしてください。  .NET Framework の場所を <xref:Microsoft.Build.BuildEngine.Engine.BinPath%2A> として渡そうとしていた場合は、特に他の操作は必要ありません。  それ以外の場合は、カスタム <xref:Microsoft.Build.BuildEngine.ToolsetCollection?displayProperty=fullName> を使用するため、ツールセットをレジストリまたは config ファイルに定義するか、エンジンの <xref:Microsoft.Build.BuildEngine.Engine.BinPath%2A> に要素を追加します。|  
+  
+<a name="BuildFW"></a>   
+### アセンブリ: Microsoft.Build.Framework.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:Microsoft.Build.Framework.XamlTypes.ContentType?displayProperty=fullName>|<xref:Microsoft.Build.Framework.XamlTypes.ContentType.ItemGroupName%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> 代わりに、<xref:Microsoft.Build.Framework.XamlTypes.ContentType.ItemType%2A?displayProperty=fullName> プロパティを使用してください。|  
+  
+<a name="BuildUtil4"></a>   
+### アセンブリ: Microsoft.Build.Utilities.v4.0.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:Microsoft.Build.Utilities.ToolTask?displayProperty=fullName>|<xref:Microsoft.Build.Utilities.ToolTask.EnvironmentOverride%2A>|<xref:Microsoft.Build.Utilities.ToolTask.EnvironmentVariables%2A?displayProperty=fullName> プロパティを使用します。|  
+  
+<a name="data_entity_tasks"></a>   
+### アセンブリ: Microsoft.Data.Entity.Build.Tasks.dll  
+  
+|型|メンバー|メッセージ|  
+|-------|----------|-----------|  
+|<xref:Microsoft.Data.Entity.Build.Tasks.EntityDeploy?displayProperty=fullName>|<xref:Microsoft.Data.Entity.Build.Tasks.EntityDeploy.EntityDataModelEmbeddedResources%2A>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> バージョン 3.5 の下位互換性のためだけに使用されます。|  
+  
+<a name="visualbasic"></a>   
+### アセンブリ: Microsoft.VisualBasic.dll  
+  
+|種類|メンバー|メッセージ|  
+|--------|----------|-----------|  
+|<xref:Microsoft.VisualBasic.FileSystem?displayProperty=fullName>|<xref:Microsoft.VisualBasic.FileSystem.FilePut%28System.Object%2CSystem.Object%2CSystem.Object%29>|このメンバーの使用は推奨されていません。  <xref:Microsoft.VisualBasic.FileSystem.FilePutObject%2A?displayProperty=fullName> を使用して <xref:System.Object> 型を書き込むか、非オブジェクト型の書き込みに対応するため `FileNumber` および `RecordNumber` を <xref:System.Int32> に強制的に変換してください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.Conversions?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.Conversions.FallbackUserDefinedConversion%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackSetComplex%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackInvokeDefault1%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackGet%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackInvokeDefault2%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackIndexSet%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackSet%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackIndexSetComplex%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.NewLateBinding.FallbackCall%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.CompilerServices.Operators?displayProperty=fullName>|<xref:Microsoft.VisualBasic.CompilerServices.Operators.FallbackInvokeUserDefinedOperator%2A>|このメンバーを使用すると、コンパイラ エラーが発生します。<br /><br /> このメソッドは使用しないでください。|  
+|<xref:Microsoft.VisualBasic.MyServices.RegistryProxy?displayProperty=fullName>|<xref:Microsoft.VisualBasic.MyServices.RegistryProxy.DynData%2A>|`DynData` レジストリ キーは Win9x でのみ機能し、このバージョンの .NET Framework ではサポートされていません。  代わりに、`PerformanceData` レジストリ キーを使用してください。  このプロパティは、.NET Framework の将来のバージョンでは削除されます。|  
+  
+## 参照  
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)   
+ [Obsolete Types \(互換性のために残されている型\)](../../../docs/framework/whats-new/obsolete-types.md)
\ No newline at end of file
diff --git a/docs/framework/whats-new/obsolete-types.md b/docs/framework/whats-new/obsolete-types.md
new file mode 100644
index 00000000000..f0f82a2affc
--- /dev/null
+++ b/docs/framework/whats-new/obsolete-types.md
@@ -0,0 +1,782 @@
+---
+title: ".NET Framework 4.5 で互換性のために残されている型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 4.5, 互換性のために残されている型"
+  - "互換性のために残されている型 [.NET Framework]"
+  - "型, 互換性のために残されている (.NET Framework 4.5)"
+ms.assetid: e636d024-0fac-45eb-b721-25a8c0ceca8f
+caps.latest.revision: 41
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# .NET Framework 4.5 で互換性のために残されている型
+<a name="introduction"></a> この記事の表に、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]で互換性のために残されている型をアセンブリ別に示します。 各アセンブリで互換性のために残されている型と推奨される代替型の一覧を表示するには、以下のリンクを使用してください。 これらの型は廃止されているため、そのメンバーもすべて廃止されます。 .NET Framework クラス ライブラリで廃止されたその他のメンバーの一覧については、「[互換性のために残されているメンバー](../../../docs/framework/whats-new/obsolete-members.md)」をご覧ください。  
+  
+-   [互換性のために残されているシステム アセンブリの型](#obsolete_types_in_system_assemblies)  
+  
+    -   [mscorlib.dll](#mscorlib)  
+  
+    -   [System.Core.dll](#Core)  
+  
+    -   [System.Data.dll](#data)  
+  
+    -   [System.Data.OracleClient.dll](#oracleclient)  
+  
+    -   [System.Design.dll](#design)  
+  
+    -   [System.dll](#system)  
+  
+    -   [System.EnterpriseServices.dll](#enterpriseservices)  
+  
+    -   [System.Net.dll](#net)  
+  
+    -   [System.ServiceModel.dll](#servicemodel)  
+  
+    -   [System.Web.dll](#web)  
+  
+    -   [System.Web.Mobile.dll](#mobile)  
+  
+    -   [System.Workflow.Activities.dll](#workflow_activities)  
+  
+    -   [System.Workflow.ComponentModel.dll](#workflow_componentmodel)  
+  
+    -   [System.Workflow.Runtime.dll](#workflow_runtime)  
+  
+    -   [System.WorkflowServices.dll](#workflowservices)  
+  
+    -   [System.Xaml.dll](#xaml)  
+  
+    -   [System.Xml.dll](#xml)  
+  
+    -   [WindowsBase.dll](#WindowsBase)  
+  
+-   [互換性のために残されている Microsoft アセンブリの型](#obsolete_types_in_microsoft_assemblies)  
+  
+    -   [IEHost.dll および IEExec.exe](#IEHost)  
+  
+    -   [Microsoft.Build.Engine.dll](#Engine)  
+  
+    -   [Microsoft.JScript.dll](#jscript)  
+  
+    -   [Microsoft.VisualBasic.Compatibility.dll](#VBCompat)  
+  
+    -   [Microsoft.VisualBasic.Compatibility.Data.dll](#VBCompatData)  
+  
+    -   [Microsoft.VisualC.dll](#visualc)  
+  
+<a name="obsolete_types_in_system_assemblies"></a>   
+## 互換性のために残されているシステム アセンブリの型  
+ 次の表に、システム アセンブリで、互換性のために残されていることが公表されている型を示します。 これらのアセンブリは、.NET Framework を対象とする汎用アプリケーションの開発で使用されます。  
+  
+<a name="mscorlib"></a>   
+### アセンブリ: mscorlib.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.ExecutionEngineException?displayProperty=fullName>|以前には、この型は、ランタイムで未定義の致命的なエラーを示していました。 ランタイムがこの例外を発生させることはなくなりましたが、この型は互換性のために残されています。|  
+|<xref:System.Collections.IHashCodeProvider?displayProperty=fullName>|代わりに、<xref:System.Collections.IEqualityComparer?displayProperty=fullName> を使用してください。|  
+|<xref:System.Collections.CaseInsensitiveHashCodeProvider?displayProperty=fullName>|代わりに、<xref:System.StringComparer?displayProperty=fullName> を使用してください。|  
+|<xref:System.Diagnostics.Contracts.Internal.ContractHelper?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> 代わりに <xref:System.Runtime.CompilerServices.ContractHelper> クラスを使用してください。|  
+|<xref:System.Security.Policy.FirstMatchCodeGroup?displayProperty=fullName>|この型は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Security.Policy.PermissionRequestEvidence?displayProperty=fullName>|アセンブリ レベルの宣言セキュリティは互換性のために残されていますが、既定では、CLR によって強制されることはなくなりました。|  
+|<xref:System.Security.Policy.UnionCodeGroup?displayProperty=fullName>|この型は互換性のために残されていますが、.NET Framework の将来のリリースでは削除されます。|  
+|<xref:System.Runtime.InteropServices.IDispatchImplType?displayProperty=fullName>|<xref:System.Runtime.InteropServices.IDispatchImplAttribute?displayProperty=fullName> の使用は推奨されていません。|  
+|<xref:System.Runtime.InteropServices.IDispatchImplAttribute?displayProperty=fullName>|この属性の使用は推奨されていません。この属性は、将来のバージョンでは削除されます。|  
+|<xref:System.Runtime.InteropServices.SetWin32ContextInIDispatchAttribute?displayProperty=fullName>|この属性は推奨されていません。 アプリケーション ドメインでは、IDispatch の呼び出しでアクティベーション コンテキスト境界は考慮されなくなりました。|  
+|<xref:System.Runtime.InteropServices.BIND_OPTS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.BIND_OPTS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIBindCtx?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IBindCtx?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIConnectionPointContainer?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IConnectionPointContainer?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIConnectionPoint?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IConnectionPoint?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIEnumMoniker?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IEnumMoniker?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.CONNECTDATA?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.CONNECTDATA?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIEnumConnections?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IEnumConnections?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIEnumConnectionPoints?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IEnumConnectionPoints?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIEnumString?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IEnumString?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIEnumVARIANT?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IEnumVARIANT?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.FILETIME?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.FILETIME?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIMoniker?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IMoniker?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIPersistFile?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IPersistFile?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIRunningObjectTable?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IRunningObjectTable?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.STATSTG?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.STATSTG?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMIStream?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IStream?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.DESCKIND?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.DESCKIND?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.BINDPTR?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.BINDPTR?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMITypeComp?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.ITypeComp?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.TYPEKIND?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.TYPEKIND?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.TYPEFLAGS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.TYPEFLAGS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.IMPLTYPEFLAGS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IMPLTYPEFLAGS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.TYPEATTR?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.TYPEATTR?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.FUNCDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.FUNCDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.IDLFLAG?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IDLFLAG?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.IDLDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.IDLDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.PARAMFLAG?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.PARAMFLAG?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.PARAMDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.PARAMDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.TYPEDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.TYPEDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.ELEMDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.ELEMDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.VARDESC?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.VARDESC?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.DISPPARAMS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.DISPPARAMS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.EXCEPINFO?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.EXCEPINFO?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.FUNCKIND?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.FUNCKIND?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.INVOKEKIND?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.INVOKEKIND?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.CALLCONV?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.CALLCONV?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.FUNCFLAGS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.FUNCFLAGS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.VARFLAGS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.VARFLAGS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMITypeInfo?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.ITypeInfo?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.SYSKIND?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.SYSKIND?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.LIBFLAGS?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.LIBFLAGS?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.TYPELIBATTR?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.TYPELIBATTR?displayProperty=fullName> を使用してください。|  
+|<xref:System.Runtime.InteropServices.UCOMITypeLib?displayProperty=fullName>|代わりに、<xref:System.Runtime.InteropServices.ComTypes.ITypeLib?displayProperty=fullName> を使用してください。|  
+|<xref:System.Security.SecurityCriticalScope?displayProperty=fullName>|<xref:System.Security.SecurityCriticalScope> は、.NET 2.0 の透過的な互換性のみを目的として使用されます。|  
+|<xref:System.Security.SecurityTreatAsSafeAttribute?displayProperty=fullName>|`SecurityTreatAsSafe` は、.NET 2.0 の透過的な互換性のみを目的として使用されます。 代わりに、<xref:System.Security.SecuritySafeCriticalAttribute?displayProperty=fullName> を使用してください。|  
+|<xref:System.Reflection.Emit.UnmanagedMarshal?displayProperty=fullName>|代替 API を使用できます。代わりに、`MarshalAs` カスタム属性を生成してください。|  
+|<xref:System.Configuration.Assemblies.AssemblyHash?displayProperty=fullName>|<xref:System.Configuration.Assemblies.AssemblyHash> クラスの使用は推奨されていません。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="Core"></a>   
+### アセンブリ: System.Core.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Runtime.CompilerServices.ExecutionScope?displayProperty=fullName>|この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この型は使用しないでください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="data"></a>   
+### アセンブリ: System.Data.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Data.DataSysDescriptionAttribute?displayProperty=fullName>|<xref:System.Data.DataSysDescriptionAttribute> の使用は推奨されていません。|  
+|<xref:System.Data.TypedDataSetGenerator?displayProperty=fullName>|<xref:System.Data.TypedDataSetGenerator> クラスは、将来のリリースでは削除されます。 System.Design.dll の <xref:System.Data.Design.TypedDataSetGenerator?displayProperty=fullName> を使用してください。|  
+|<xref:System.Data.PropertyAttributes?displayProperty=fullName>|<xref:System.Data.PropertyAttributes> の使用は推奨されていません。|  
+|<xref:System.Xml.XmlDataDocument?displayProperty=fullName>|<xref:System.Xml.XmlDataDocument> クラスは、将来のリリースでは削除されます。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="oracleclient"></a>   
+### アセンブリ: System.Data.OracleClient.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Data.OracleClient.OracleCommand?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleCommand> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OracleCommandBuilder?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleCommandBuilder> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OracleConnection?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleConnection> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OracleConnectionStringBuilder?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleConnectionStringBuilder> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OracleDataAdapter?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleDataAdapter> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OracleClientFactory?displayProperty=fullName>|<xref:System.Data.OracleClient.OracleClientFactory> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OraclePermission?displayProperty=fullName>|<xref:System.Data.OracleClient.OraclePermission> の使用は推奨されていません。|  
+|<xref:System.Data.OracleClient.OraclePermissionAttribute?displayProperty=fullName>|<xref:System.Data.OracleClient.OraclePermissionAttribute?displayProperty=fullName> の使用は推奨されていません。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="design"></a>   
+### アセンブリ: System.Design.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.ComponentModel.Design.LocalizationExtenderProvider?displayProperty=fullName>|このクラスの使用は推奨されていません。 代わりに、<xref:System.ComponentModel.Design.Serialization.CodeDomLocalizationProvider?displayProperty=fullName> を使用してください。|  
+|<xref:System.Web.UI.Design.DataBindingCollectionConverter?displayProperty=fullName>|データ バインディングの編集は、プロパティ グリッドではなく、<xref:System.ComponentModel.Design.DesignerActionList?displayProperty=fullName> から起動されるので、この型の使用は推奨されていません。|  
+|<xref:System.Web.UI.Design.DataBindingCollectionEditor?displayProperty=fullName>|データ バインディングの編集は、プロパティ グリッドではなく、<xref:System.ComponentModel.Design.DesignerActionList?displayProperty=fullName> から起動されるので、この型の使用は推奨されていません。|  
+|<xref:System.Web.UI.Design.IHtmlControlDesignerBehavior?displayProperty=fullName>|別の方法として、<xref:System.Web.UI.Design.IControlDesignerTag?displayProperty=fullName> および <xref:System.Web.UI.Design.IControlDesignerView?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.ITemplateEditingFrame?displayProperty=fullName>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、この型の使用は推奨されていません。 テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.ITemplateEditingService?displayProperty=fullName>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、この型の使用は推奨されていません。 テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.IControlDesignerBehavior?displayProperty=fullName>|別の方法として、<xref:System.Web.UI.Design.IControlDesignerTag?displayProperty=fullName> および <xref:System.Web.UI.Design.IControlDesignerView?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.UI.Design.IWebFormReferenceManager?displayProperty=fullName>|別の方法として、<xref:System.Web.UI.Design.WebFormsReferenceManager?displayProperty=fullName> を使用することをお勧めします。<xref:System.Web.UI.Design.WebFormsReferenceManager> は機能が追加されており、さらに機能を拡張できます。<xref:System.Web.UI.Design.WebFormsReferenceManager> を取得するには、`RootDesigner.ReferenceManager` から <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> プロパティを使用します。|  
+|<xref:System.Web.UI.Design.IWebFormsDocumentService?displayProperty=fullName>|別の方法として、<xref:System.Web.UI.Design.WebFormsRootDesigner?displayProperty=fullName> を使用することをお勧めします。<xref:System.Web.UI.Design.WebFormsRootDesigner> は機能が追加されており、さらに機能を拡張できます。<xref:System.Web.UI.Design.WebFormsRootDesigner> を取得するには、<xref:System.Web.UI.Design.ControlDesigner.RootDesigner%2A> から <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> プロパティを使用します。|  
+|<xref:System.Web.UI.Design.ReadWriteControlDesigner?displayProperty=fullName>|別の方法として、コンテンツの編集に <xref:System.Web.UI.Design.ContainerControlDesigner?displayProperty=fullName> が使用されるので、<xref:System.Web.UI.Design.EditableDesignerRegion?displayProperty=fullName> を使用することをお勧めします。 デザイナーの各領域を使用すると、編集する対象のコンテンツの制御を強化できます。|  
+|<xref:System.Web.UI.Design.TemplateEditingService?displayProperty=fullName>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、この型の使用は推奨されていません。 テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.TemplateEditingVerb?displayProperty=fullName>|テンプレート編集は <xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> で処理されるので、この型の使用は推奨されていません。 テンプレート編集をサポートするには、<xref:System.Web.UI.Design.ControlDesigner.TemplateGroups%2A?displayProperty=fullName> プロパティのテンプレート データを公開して、`ControlDesigner.SetViewFlags(ViewFlags.TemplateEditing, true)` を呼び出します。|  
+|<xref:System.Web.UI.Design.WebControls.CalendarAutoFormatDialog?displayProperty=fullName>|\[オートフォーマット\] ダイアログ ボックスはデザイナー ホストによって起動されるので、この型の使用は推奨されていません。 使用できる \[オートフォーマット\] の一覧は、<xref:System.Web.UI.Design.ControlDesigner?displayProperty=fullName> プロパティの <xref:System.Web.UI.Design.ControlDesigner.AutoFormats%2A?displayProperty=fullName> に公開されています。|  
+|<xref:System.Web.UI.Design.WebControls.PanelDesigner?displayProperty=fullName>|別の方法として、コンテンツの編集に <xref:System.Web.UI.Design.WebControls.PanelContainerDesigner?displayProperty=fullName> が使用されるので、<xref:System.Web.UI.Design.EditableDesignerRegion?displayProperty=fullName> を使用することをお勧めします。 デザイナーの各領域を使用すると、編集する対象のコンテンツの制御を強化できます。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="system"></a>   
+### アセンブリ: System.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.ComponentModel.IComNativeDescriptorHandler?displayProperty=fullName>|このインターフェイスの使用は推奨されていません。 代わりに、<xref:System.ComponentModel.TypeDescriptionProvider?displayProperty=fullName> をハンドル型 <xref:System.ComponentModel.TypeDescriptor.ComObjectType%2A?displayProperty=fullName> に追加します。|  
+|<xref:System.ComponentModel.RecommendedAsConfigurableAttribute?displayProperty=fullName>|新しい設定モデルを操作するには、代わりに、<xref:System.ComponentModel.SettingsBindableAttribute?displayProperty=fullName> を使用してください。|  
+|<xref:System.ComponentModel.Design.Serialization.RootDesignerSerializerAttribute?displayProperty=fullName>|この属性は推奨されていません。 代わりに、<xref:System.ComponentModel.Design.Serialization.DesignerSerializerAttribute?displayProperty=fullName> を使用してください。 たとえば、CodeDom のルート デザイナーを指定するには、`DesignerSerializerAttribute(...,typeof(TypeCodeDomSerializer))` を使用します。|  
+|<xref:System.Net.GlobalProxySelection?displayProperty=fullName>|このクラスの使用は推奨されていません。 グローバルな既定のプロキシにアクセスして設定するには、代わりに、<xref:System.Net.WebRequest.DefaultWebProxy%2A?displayProperty=fullName> を使用してください。<xref:System.Net.GlobalProxySelection.GetEmptyWebProxy%2A?displayProperty=fullName> の代わりに、'null' を使用してください。|  
+|<xref:System.Net.Sockets.SocketClientAccessPolicyProtocol>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Diagnostics.DiagnosticsConfigurationHandler?displayProperty=fullName>|このクラスの使用は推奨されていません。|  
+|<xref:System.Diagnostics.PerformanceCounterManager?displayProperty=fullName>|このクラスの使用は推奨されていません。 代わりに、<xref:System.Diagnostics.PerformanceCounter?displayProperty=fullName> クラスからパフォーマンス カウンターを使用してください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="enterpriseservices"></a>   
+### アセンブリ: System.EnterpriseServices.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.EnterpriseServices.RegistrationHelperTx?displayProperty=fullName>|<xref:System.EnterpriseServices.RegistrationHelperTx> クラスの使用は推奨されていません。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="net"></a>   
+### アセンブリ: System.Net.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Net.INetworkProgress?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.IUnsafeWebRequestCreate?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.NetworkProgressChangedEventArgs?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.UiSynchronizationContext?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.HttpPolicyDownloaderProtocol?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.SecurityCriticalAction?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.SocketPolicy?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.UdpAnySourceMulticastClient?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Net.Sockets.UdpSingleSourceMulticastClient?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="servicemodel"></a>   
+### アセンブリ: System.ServiceModel.dll  
+  
+|種類|メッセージ|  
+|--------|-----------|  
+|<xref:System.ServiceModel.NetPeerTcpBinding?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Channels.HttpCookieContainerBindingElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型は互換性のために残されています。 Http <xref:System.Net.CookieContainer> を有効にするには、Http バインドか `AllowCookies` で <xref:System.ServiceModel.Channels.HttpTransportBindingElement> プロパティを使用します。|  
+|<xref:System.ServiceModel.Channels.PeerCustomResolverBindingElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Channels.PeerTransportBindingElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Configuration.NetPeerTcpBindingCollectionElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Configuration.NetPeerTcpBindingElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.Configuration.PeerTransportElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+|<xref:System.ServiceModel.PeerResolvers.CustomPeerResolverService?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> ピア チャネルの機能は互換性のために残されていますが、今後削除される予定です。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="web"></a>   
+### アセンブリ: System.Web.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Web.Configuration.PassportAuthentication?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Security.PassportAuthenticationEventArgs?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Security.PassportAuthenticationEventHandler?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Security.PassportAuthenticationModule?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Security.PassportIdentity?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.Security.PassportPrincipal?displayProperty=fullName>|この型は互換性のために残されています。 パスポート認証製品はサポート対象から除外され、Live ID に置き換えられました。|  
+|<xref:System.Web.UI.ObjectConverter?displayProperty=fullName>|別の方法として、<xref:System.Convert?displayProperty=fullName> および <xref:System.String.Format%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.SmtpMail?displayProperty=fullName>|別の方法として、<xref:System.Net.Mail.SmtpClient?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.MailFormat?displayProperty=fullName>|別の方法として、<xref:System.Net.Mail.MailMessage.IsBodyHtml%2A?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.MailPriority?displayProperty=fullName>|別の方法として、<xref:System.Net.Mail.MailPriority?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.MailEncoding?displayProperty=fullName>|別の方法として、<xref:System.Net.Mime.TransferEncoding?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.MailAttachment?displayProperty=fullName>|別の方法として、<xref:System.Net.Mail.Attachment?displayProperty=fullName> を使用することをお勧めします。|  
+|<xref:System.Web.Mail.MailMessage?displayProperty=fullName>|別の方法として、<xref:System.Net.Mail.MailMessage?displayProperty=fullName> を使用することをお勧めします。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="mobile"></a>   
+### アセンブリ: System.Web.Mobile.dll  
+  
+|種類|メッセージ|  
+|--------|-----------|  
+|<xref:System.Web.Mobile.CookielessData?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.DeviceFiltersSection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.DeviceFilterElementCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.DeviceFilterElement?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.ErrorHandlerModule?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.MobileCapabilities?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.MobileDeviceCapabilitiesSectionHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.MobileErrorInfo?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.Mobile.MobileFormsAuthentication?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileControl?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.AdRotator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ArrayListCollectionBase?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TextControl?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.BaseValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Calendar?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Command?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.CompareValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListViewMode?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.BooleanOption?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.FontSize?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Alignment?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Wrapping?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListDecoration?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListSelectType?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.FormMethod?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.CommandFormat?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Constants?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ControlPager?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.CustomValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DesignerAdapterAttribute?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceOverridableAttribute?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecific?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificChoice?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificChoiceControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificChoiceTemplateBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificChoiceTemplateContainer?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceSpecificChoiceCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobilePage?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ErrorFormatterPage?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.FontInfo?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ITemplateable?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Panel?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Form?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LiteralTextContainerControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.FormControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.IControlAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Image?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.IObjectListFieldCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.IPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ItemPager?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Label?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Link?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.PagedControl?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.List?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListCommandEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListCommandEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListDataBindEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ListDataBindEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LiteralLink?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LiteralText?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LiteralTextControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LoadItemsEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.LoadItemsEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileControlsSection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceElementCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.DeviceElement?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ControlElementCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ControlElement?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileTypeNameConverter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileControlsSectionHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileListItemType?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TemplateContainer?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileListItem?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileListItemCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.MobileUserControl?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectList?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListCommand?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListCommandCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListCommandEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListCommandEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListDataBindEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListDataBindEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListField?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListFieldCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListItem?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListItemCollection?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListSelectEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListSelectEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListShowCommandsEventArgs?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListShowCommandsEventHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ObjectListTitleAttribute?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Style?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.PagerStyle?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.PanelControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.PersistNameAttribute?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.PhoneCall?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.RangeValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.RegularExpressionValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.RequiredFieldValidator?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.SelectionList?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.StyleSheet?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.StyleSheetControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TextBox?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TextBoxControlBuilder?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TextView?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.TextViewElement?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.ValidationSummary?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ControlAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlControlAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlCalendarAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlCommandAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlCommandAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlFormAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlFormAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlImageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlImageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlLinkAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlLinkAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.MultiPartWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.MobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlMobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlMobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlPhoneCallAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlPhoneCallAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlSelectionListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlSelectionListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlTextBoxAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.ChtmlTextBoxAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlCalendarAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlLabelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlLiteralTextAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlObjectListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlPanelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlTextViewAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlValidationSummaryAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.HtmlValidatorAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlMobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.UpWmlMobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlControlAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.UpWmlPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlCalendarAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlCommandAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlFormAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlImageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlLabelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlLinkAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlLiteralTextAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlObjectListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlPanelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlPhoneCallAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlPostFieldType?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlSelectionListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlTextBoxAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlTextViewAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlValidationSummaryAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.WmlValidatorAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.Doctype?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.StyleSheetLocation?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlControlAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlCalendarAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlCommandAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlFormAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlImageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlLabelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlLinkAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlLiteralTextAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlObjectListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlPageAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlPanelAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlPhoneCallAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlSelectionListAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlTextBoxAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlTextViewAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlValidationSummaryAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlValidatorAdapter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlCssHandler?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.MobileControls.Adapters.XhtmlAdapters.XhtmlMobileTextWriter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.Design.MobileControls.IMobileDesigner?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.Design.MobileControls.IMobileWebFormServices?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.Design.MobileControls.MobileResource?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.Design.MobileControls.Converters.DataFieldConverter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+|<xref:System.Web.UI.Design.MobileControls.Converters.DataMemberConverter?displayProperty=fullName>|System.Web.Mobile.dll アセンブリの使用は推奨されていません。今後は使用しないでください。 ASP.NET モバイル アプリケーションを開発する方法については、「[ASP.NET for Mobiles \(モバイル向け ASP.NET\)](http://go.microsoft.com/fwlink/?LinkId=157231)」をご覧ください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="workflow_activities"></a>   
+### アセンブリ: System.Workflow.Activities.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Workflow.Activities?displayProperty=fullName> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Activities.Configuration.ActiveDirectoryRoleFactoryConfiguration?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Activities.Rules.RuleActionTrackingEvent?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Activities.Rules.RuleConditionReference?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Activities.Rules.RuleSetReference?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="workflow_componentmodel"></a>   
+### アセンブリ: System.Workflow.ComponentModel.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Workflow.ComponentModel> と <xref:System.Workflow.ComponentModel.GetValueOverride?displayProperty=fullName> を除く <xref:System.Workflow.ComponentModel.SetValueOverride?displayProperty=fullName> 名前空間のすべての型。|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Compiler> と <xref:System.Workflow.ComponentModel.Compiler.ValidationError?displayProperty=fullName> を除く <xref:System.Workflow.ComponentModel.Compiler.ValidationErrorCollection?displayProperty=fullName> 名前空間のすべての型。|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Design> を除く<xref:System.Workflow.ComponentModel.Design.ConnectorEventHandler> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.ActivityCodeDomSerializationManager?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.ActivityCodeDomSerializer?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.ActivityMarkupSerializer?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.ActivitySurrogateSelector?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.ActivityTypeCodeDomSerializer?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.CompositeActivityMarkupSerializer?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.ComponentModel.Serialization.DependencyObjectCodeDomSerializer?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="workflow_runtime"></a>   
+### アセンブリ: System.Workflow.Runtime.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Workflow.Runtime> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Runtime.Configuration> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Runtime.DebugEngine> を除く<xref:System.Workflow.Runtime.DebugEngine.DebugEngineCallback> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Runtime.Hosting> を除く<xref:System.Workflow.Runtime.Hosting.WorkflowCommitWorkBatchService.CommitWorkBatchCallback> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+|<xref:System.Workflow.Runtime.Tracking> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> System.Workflow.\* 型の使用は推奨されていません。 代わりに、<xref:System.Activities>の新しい型を使用します。\*|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="workflowservices"></a>   
+### アセンブリ: System.WorkflowServices.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.ServiceModel.WorkflowServiceHost?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Activation.WorkflowServiceHostFactory?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Activities.Description.WorkflowRuntimeEndpoint?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Configuration.ExtendedWorkflowRuntimeServiceElementCollection?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Configuration.PersistenceProviderElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Configuration.WorkflowRuntimeElement?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Description.DurableOperationAttribute?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Description.DurableServiceAttribute?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Description.PersistenceProviderBehavior?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Description.UnknownExceptionAction?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Description.WorkflowRuntimeBehavior?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Dispatcher.DurableOperationContext?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.InstanceLockException?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.InstanceNotFoundException?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.LockingPersistenceProvider?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.PersistenceException?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.PersistenceProvider?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.PersistenceProviderFactory?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.ServiceModel.Persistence.SqlPersistenceProviderFactory?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.Workflow.Activities?displayProperty=fullName> 名前空間のすべての型|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+|<xref:System.Workflow.Runtime.Hosting.ChannelManagerService?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> WF 3 の型は廃止されました。 代わりに、<xref:System.Activities>の新しい WF 4 型を使用します。\*|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="xaml"></a>   
+### アセンブリ: System.Xaml.dll  
+  
+|種類|メッセージ|  
+|--------|-----------|  
+|<xref:System.Windows.Markup.AcceptedMarkupExtensionExpressionTypeAttribute?displayProperty=fullName>|これは、XAML パーサーでは使用されなくなりました。<xref:System.Windows.Markup.XamlSetMarkupExtensionAttribute?displayProperty=fullName> を参照してください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="xml"></a>   
+### アセンブリ: System.Xml.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Xml.IApplicationResourceStreamResolver?displayProperty=fullName>|最初に .NET Framework 4.5 で廃止されました。<br /><br /> この型を使用すると、コンパイラ エラーが発生します。<br /><br /> この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Xml.XmlValidatingReader?displayProperty=fullName>|代わりに、適切な <xref:System.Xml.XmlReader?displayProperty=fullName> を使用する <xref:System.Xml.XmlReader.Create%2A?displayProperty=fullName> メソッドによって作成された <xref:System.Xml.XmlReaderSettings?displayProperty=fullName> を使用してください。|  
+|<xref:System.Xml.XmlXapResolver?displayProperty=fullName>|この API は、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。|  
+|<xref:System.Xml.Xsl.XslTransform?displayProperty=fullName>|このクラスの使用は推奨されていません。 代わりに、<xref:System.Xml.Xsl.XslCompiledTransform?displayProperty=fullName> を使用してください。|  
+|<xref:System.Xml.Schema.XmlSchemaCollection?displayProperty=fullName>|スキーマ コンパイルおよび検証には、<xref:System.Xml.Schema.XmlSchemaSet?displayProperty=fullName> を使用してください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="WindowsBase"></a>   
+### アセンブリ: WindowsBase.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:System.Windows.Markup.IReceiveMarkupExtension?displayProperty=fullName>|<xref:System.Windows.Markup.IReceiveMarkupExtension?displayProperty=fullName> の使用は推奨されていません。 このインターフェイスは、使用されなくなりました。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="obsolete_types_in_microsoft_assemblies"></a>   
+## 互換性のために残されている Microsoft アセンブリの型  
+ 以下のセクションで、互換性のために残されている Microsoft アセンブリの型を示します。 これらのアセンブリは、個別の言語 \(たとえば、Microsoft.JScript.dll や Microsoft.VisualC.dll\) を対象とした特殊な目的のアセンブリです。  
+  
+<a name="IEHost"></a>   
+### アセンブリ: IEHost.dll and IEExec.exe  
+ IEHost.dll および IEExec.exe アセンブリは .NET Framework から削除されています。 これらのアセンブリのすべての型およびメンバーは廃止され、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] ではサポートされていません。 これらのアセンブリは Internet Explorer で Windows フォーム コントロールをホストし、実行可能ファイルを実行するために使用されていました。 代替手段としては、ClickOnce、XAML ブラウザー アプリケーション \(XBAP\)、および Microsoft Silverlight をお勧めします。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="Engine"></a>   
+### アセンブリ: Microsoft.Build.Engine.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:Microsoft.Build.BuildEngine.Engine?displayProperty=fullName>|このクラスの使用は推奨されていません。 代わりに、<xref:Microsoft.Build.Evaluation.ProjectCollection?displayProperty=fullName> アセンブリの `Microsoft.Build` を使用します。|  
+|<xref:Microsoft.Build.BuildEngine.Project>|このクラスの使用は推奨されていません。 代わりに、<xref:Microsoft.Build.Evaluation.ProjectCollection?displayProperty=fullName> アセンブリの `Microsoft.Build` を使用します。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="jscript"></a>   
+### アセンブリ: Microsoft.JScript.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaSite?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaEngine?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.BaseVsaEngine?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.BaseVsaSite?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.BaseVsaStartup?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaError?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.ResInfo?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaItem?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaCodeItem?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.JSVsaItemType?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.JSVsaItemFlag?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaPersistSite?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaItems?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaReferenceItem?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.IJSVsaGlobalItem?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.JSVsaError?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.JSVsaException?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+|<xref:Microsoft.JScript.Vsa.VsaEngine?displayProperty=fullName>|この型の使用は推奨されていません。Visual Studio 2005 の時点から使用は推奨されておらず、これに代わる機能はありません。 詳細については、<xref:System.CodeDom.Compiler.ICodeCompiler?displayProperty=fullName> のドキュメントを参照してください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="VBCompat"></a>   
+### アセンブリ: Microsoft.VisualBasic.Compatibility.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.BaseControlArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.BaseOcxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ButtonArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.CheckBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.CheckedListBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ColorDialogArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ComboBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DirListBox?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DirListBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DriveListBox?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DriveListBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.FileListBox?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.FixedLengthString?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.FontDialogArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.FormShowConstants?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.GroupBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.HScrollBarArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ImageListArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.LabelArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ListBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ListBoxItem?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ListViewArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.LoadResConstants?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.MaskedTextBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.MenuItemArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.MouseButtonConstants?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.OpenFileDialogArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.PanelArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.PictureBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.PrintDialogArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ProgressBarArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.RadioButtonArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.RichTextBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.SaveFileDialogArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ScaleMode?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ShiftConstants?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.StatusBarArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.StatusStripArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.Support?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.TabControlArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.TextBoxArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.TimerArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ToolBarArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ToolStripArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ToolStripMenuItemArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.TreeViewArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.VScrollBarArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebBrowserArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClass?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassContainingClassNotOptional?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassCouldNotFindEvent?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassNextItemCannotBeCurrentWebItem?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassNextItemRespondNotFound?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassUserWebClassNameNotOptional?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassWebClassFileNameNotOptional?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebClassWebItemNotValid?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItem?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemAssociatedWebClassNotOptional?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemClosingTagNotFound?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemCouldNotLoadEmbeddedResource?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemCouldNotLoadTemplateFile?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemNameNotOptional?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemNoTemplateSpecified?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemTooManyNestedTags?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.WebItemUnexpectedErrorReadingTemplateFile?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ZOrderConstants?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="VBCompatData"></a>   
+### アセンブリ: Microsoft.VisualBasic.Compatibility.Data.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.BOFActionEnum?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.EndOfRecordsetDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.EOFActionEnum?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.ErrorDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.FetchCompleteDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.FetchProgressDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.FieldChangeCompleteDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.MoveCompleteDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.OrientationEnum?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.RecordChangeCompleteDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.WillChangeFieldDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.WillChangeRecordDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.WillChangeRecordsetDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODC.WillMoveDelegate?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.ADODCArray?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.BaseDataEnvironment?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.BindingCollectionEnumerator?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.CONNECTDATA?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBBINDING?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBCOLUMNINFO?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBID?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBinding?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBindingCollection?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBKINDENUM?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.DBPROPIDSET?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IAccessor?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IChapteredRowset?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IColumnsInfo?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IConnectionPoint?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IConnectionPointContainer?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IDataFormat?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IDataFormatDisp?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IEnumConnectionPoints?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IEnumConnections?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowPosition?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowPositionChange?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowset?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowsetChange?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowsetIdentity?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowsetInfo?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.IRowsetNotify?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.MBinding?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.MBindingCollection?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.SRDescriptionAttribute?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.UGUID?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.UNAME?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+|<xref:Microsoft.VisualBasic.Compatibility.VB6.UpdateMode?displayProperty=fullName>|「[Microsoft.VisualBasic.Compatibility.VB6.\<member\> は互換性のために残され、32 ビット プロセス内でのみサポートされる](https://msdn.microsoft.com/en-us/library/ee839621.aspx)」をご覧ください。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="visualc"></a>   
+### アセンブリ: Microsoft.VisualC.dll  
+  
+|型|メッセージ|  
+|-------|-----------|  
+|<xref:Microsoft.VisualC.IsCXXReferenceModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.IsConstModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.IsLongModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.IsVolatileModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.IsSignedModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.NoSignSpecifiedModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.NeedsCopyConstructorModifier?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.DecoratedNameAttribute?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.MiscellaneousBitsAttribute?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+|<xref:Microsoft.VisualC.DebugInfoInPDBAttribute?displayProperty=fullName>|Microsoft.VisualC.dll は互換性のために残されているアセンブリであり、下位互換性のためだけに存在します。|  
+  
+## 参照  
+ [クラス ライブラリの互換性のために残されている機能](../../../docs/framework/whats-new/whats-obsolete.md)   
+ [互換性のために残されているメンバー](../../../docs/framework/whats-new/obsolete-members.md)
\ No newline at end of file
diff --git a/docs/framework/whats-new/whats-obsolete.md b/docs/framework/whats-new/whats-obsolete.md
new file mode 100644
index 00000000000..ce9e2de719f
--- /dev/null
+++ b/docs/framework/whats-new/whats-obsolete.md
@@ -0,0 +1,88 @@
+---
+title: ".NET Framework クラス ライブラリの互換性のために残されている機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "使用されなくなった [.NET Framework]"
+  - "互換性のために残されている [.NET Framework]"
+  - "互換性のために残されている機能 [.NET Framework]"
+ms.assetid: d356a43a-73df-4ae2-a457-b9628074c7cd
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework クラス ライブラリの互換性のために残されている機能
+.NET Framework は進化しています。  バージョンが新しくなるたびに、新しい機能を提供する新しい型と新しいメンバーが追加されています。  既存の型とそのメンバーも変更されています。  たとえば、一部の型は、その型がサポートするテクノロジが新しいテクノロジに置き換えられることで重要度が下がり、一部のメソッドは、より便利な新しいメソッドまたはより多くの機能を備えた新しいメソッドに置き換えられています。  
+  
+ .NET Framework と共通言語ランタイムでは、下位互換性をサポートするように努めています \(.NET Framework の特定のバージョンで開発したアプリケーションを、.NET Framework の次期バージョンで実行できるようにするためです\)。  そのため、型または型のメンバーを単純に削除することはできません。  そこで、.NET Framework では、型または型のメンバーが使用されなくなったことを示すために、その型またはメンバーを旧式 \(互換性のために残されている\) または非推奨として指定しています。  型またはメンバーを非推奨とする場合は、開発者がその型またはメンバーが削除予定であることを認識してその削除に対応できるように、指定を行う必要があります。  ただし、そのような型またはメンバーを使用する既存のコードは、.NET Framework の次期バージョンで引き続き実行できます。  
+  
+> [!NOTE]
+>  *旧式* \(互換性のために残されている\) という用語と*非推奨*という用語は、.NET Framework の型とメンバーに対して使用する場合は同じ意味です。  
+  
+## ObsoleteAttribute 属性  
+ .NET Framework では、型または型のメンバーが旧式であることを示すために、その型またはメンバーに <xref:System.ObsoleteAttribute> 属性を指定します。  この属性が型またはメンバーに適用されている場合、その型またはメンバーは .NET Framework の将来のバージョンで削除される予定であることを意味します。ただし、そのメンバーを使用するコンパイル済みコードに影響はありません。  
+  
+ 型または型のメンバーが旧式であることを示す以外に、<xref:System.ObsoleteAttribute> は、その型またはメンバーが含まれているソース コードをコンパイラで処理する方法を定義します。  コードをコンパイルするが警告メッセージを出力するようにすることも、旧式の型またはメンバーの使用をエラーとして扱うこともできます。  前者の場合、コードを正常にコンパイルできますが、警告メッセージによって型またはメンバーが旧式であることが示されます。  後者の場合、コンパイルは失敗します。  
+  
+ コンパイルで警告メッセージではなくエラーが生成される場合でも、<xref:System.ObsoleteAttribute> は実行時の動作には影響を与えません。  つまり、旧式の型またはメンバーを使用しているが正常にコンパイルされたアプリケーションは、常に正常に実行されます。  旧式の型またはメンバーを使用するアプリケーションを再コンパイルしようとした場合にのみ失敗します。  
+  
+## 旧式の型とメンバーを処理する方法  
+ 既存のコードをアップグレードし、再コンパイルする場合に、コンパイラの警告を生成する旧式の型またはメンバーをアプリケーションで使用しても、まったく問題ありません。  ただし、コンパイラの警告メッセージを確認して、アプリケーション コードを変更する必要があるかどうか判断する必要があります。  代わりとなる適切な方法がメッセージに示されていない場合は、次のいずれかの操作を行う必要があります。  
+  
+-   可能であれば、コードを変更して旧式の型またはメンバーの使用を止めます。  
+  
+     または  
+  
+-   このテクノロジ分野に関するドキュメントを確認して、非推奨の機能の使用に対する対応方法を決定します。  
+  
+ 既存のコードは、.NET Framework の新しいバージョンに対して再コンパイルすることはできません。  代わりに、既存のコンパイル済みコードの実行対象である .NET Framework のバージョンを指定できます。  たとえば、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] に対してコンパイルされた app1.exe というアプリケーションがあり、このアプリケーションを [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象に実行する必要があるとします。  この場合、次の手順が必要です。  
+  
+1.  メイン実行可能ファイルの構成ファイルを作成し、その名前を *appName*.exe.config にします。*appName* は、アプリケーションの実行可能ファイルの名前です。  このトピックの例の app1.exe というアプリケーションの場合は、app1.exe.config という名前の構成ファイルを作成します。  
+  
+2.  次のコードを構成ファイルに追加します。  
+  
+    ```  
+    <configuration>  
+       <startup>   
+          <supportedRuntime version="v4.0" />  
+       </startup>  
+    </configuration>  
+    ```  
+  
+ .NET Framework の特定のバージョンを対象とするために `version` 属性に割り当てることができる文字列値を次の表に示します。  
+  
+|||  
+|-|-|  
+|.NET Framework のバージョン|`version` 文字列|  
+|4.5 \(4.5.1 および他のポイント リリースを含む\)|v4.0|  
+|4|v4.0|  
+|3.5|v2.0.50727|  
+|2.0|v2.0.50727|  
+|1.1|v1.1.4322|  
+|1|v1.0.3705|  
+  
+## .NET Framework 4.5 の互換性のために残されている機能の一覧  
+ [Obsolete Types \(互換性のために残されている型\)](../../../docs/framework/whats-new/obsolete-types.md)  
+  
+ [Obsolete Members \(互換性のために残されているメンバー\)](../../../docs/framework/whats-new/obsolete-members.md)  
+  
+## 以前のバージョンの互換性のために残されている機能の一覧  
+ [.NET Framework 4 で互換性のために残されている型](http://go.microsoft.com/fwlink/?LinkId=224224)  
+  
+ [.NET Framework 4 で互換性のために残されているメンバー](http://go.microsoft.com/fwlink/?LinkId=224227)  
+  
+ [.NET Framework 3.5 廃止予定の一覧](http://go.microsoft.com/fwlink/?LinkId=163710)  
+  
+ [.NET Framework 2.0 廃止予定の一覧](http://go.microsoft.com/fwlink/?LinkID=125264)  
+  
+## 参照  
+ [\<supportedRuntime\> 要素](../../../docs/framework/configure-apps/file-schema/startup/supportedruntime-element.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/TOC.md b/docs/framework/windows-services/TOC.md
new file mode 100644
index 00000000000..f6eddf1e49d
--- /dev/null
+++ b/docs/framework/windows-services/TOC.md
@@ -0,0 +1,16 @@
+# [方法: Windows サービスを一時中断する (Visual Basic)](how-to-pause-a-windows-service-visual-basic.md)
+# [方法: Windows サービスを続行する (Visual Basic)](how-to-continue-a-windows-service-visual-basic.md)
+# [チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](walkthrough-creating-a-windows-service-application-in-the-component-designer.md)
+# [Windows サービスをデバッグする場合](troubleshooting-debugging-windows-services.md)
+# [方法: サービスをインストールおよびアンインストールする](how-to-install-and-uninstall-services.md)
+# [方法 : サービスに関する情報のログを記録する](how-to-log-information-about-services.md)
+# [Windows Service Applications](index.md)
+# [方法 : サービスを開始する](how-to-start-services.md)
+# [方法 : サービス アプリケーションにインストーラーを追加する](how-to-add-installers-to-your-service-application.md)
+# [サービス アプリケーションのプログラミング アーキテクチャ](service-application-programming-architecture.md)
+# [方法 : Windows サービス アプリケーションをデバッグする](how-to-debug-windows-service-applications.md)
+# [サービス アプリケーションをインストールできない場合](troubleshooting-service-application-wont-install.md)
+# [方法 : プログラムでサービスを作成する](how-to-write-services-programmatically.md)
+# [Windows サービス アプリケーションの概要](introduction-to-windows-service-applications.md)
+# [方法 : Windows サービスを作成する](how-to-create-windows-services.md)
+# [方法 : サービスのセキュリティ コンテキストを指定する](how-to-specify-the-security-context-for-services.md)
diff --git a/docs/framework/windows-services/how-to-add-installers-to-your-service-application.md b/docs/framework/windows-services/how-to-add-installers-to-your-service-application.md
new file mode 100644
index 00000000000..f84ea7790a8
--- /dev/null
+++ b/docs/framework/windows-services/how-to-add-installers-to-your-service-application.md
@@ -0,0 +1,73 @@
+---
+title: "方法 : サービス アプリケーションにインストーラーを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インストール コンポーネント, 追加 (サービスに)"
+  - "インストーラー, 追加 (サービスに)"
+  - "ServiceInstaller クラス, 追加 (インストーラーをサービスに)"
+  - "ServiceProcessInstaller クラス, 追加 (インストーラーをサービスに)"
+  - "サービス, 追加 (インストーラーを)"
+  - "Windows サービス アプリケーション, 追加 (インストーラーを)"
+  - "Windows サービス アプリケーション, 配置"
+ms.assetid: 8b698e9a-b88e-4f44-ae45-e0c5ea0ae5a8
+caps.latest.revision: 14
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 14
+---
+# 方法 : サービス アプリケーションにインストーラーを追加する
+Visual Studio には、サービス アプリケーションに関連付けられたリソースをインストールできるインストール コンポーネントが組み込まれています。  インストール コンポーネントは、サービスをインストール先システムに登録し、サービス コントロール マネージャーにサービスの存在を知らせます。  サービス アプリケーションを作成するときに、\[プロパティ\] ウィンドウでリンクを選択して、適切なインストーラーをプロジェクトに自動的に追加できます。  
+  
+> [!NOTE]
+>  サービスのプロパティ値は、サービス クラスからインストーラー クラスにコピーされます。  サービス クラスのプロパティ値を更新しても、インストーラーのプロパティ値は更新されません。  
+  
+ インストーラーをプロジェクトに追加すると、新しいクラス \(既定の名前は `ProjectInstaller`\) がプロジェクトに作成され、そのクラス内にインストール コンポーネントのインスタンスが作成されます。  このクラスは、プロジェクトで必要なすべてのインストール コンポーネントの核になります。  たとえば、2 番目のサービスをアプリケーションに追加し、\[インストーラーの追加\] リンクをクリックしても、2 番目のインストーラー クラスは作成されません。代わりに、2 番目のサービスに必要な追加のインストール コンポーネントが、既存のクラスに追加されます。  
+  
+ サービスを正しくインストールするために、特別なコードをインストーラーに追加する必要はありません。  ただし、インストール プロセスに特殊な機能を追加する場合は、インストーラーの変更が必要になることもあります。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### サービス アプリケーションにインストーラーを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、インストール コンポーネントを追加するサービスを**デザイン** ビューに表示します。  
+  
+2.  デザイナーの背景をクリックして、サービスの内容ではなくサービス自体を選択します。  
+  
+3.  デザイナーにフォーカスを置いた状態で右クリックし、**\[インストーラーの追加\]** をクリックします。  
+  
+     新しいクラスの `ProjectInstaller`、および <xref:System.ServiceProcess.ServiceProcessInstaller> と <xref:System.ServiceProcess.ServiceInstaller> の 2 つのインストール コンポーネントが、プロジェクトに追加されます。また、サービスのプロパティ値がこれらのコンポーネントにコピーされます。  
+  
+4.  \[<xref:System.ServiceProcess.ServiceInstaller>\] コンポーネントをクリックし、<xref:System.ServiceProcess.ServiceInstaller.ServiceName%2A> プロパティがサービス自体の <xref:System.ServiceProcess.ServiceInstaller.ServiceName%2A> プロパティと同じ値に設定されているかどうかを確認します。  
+  
+5.  サービスの起動方法を決定するには、\[<xref:System.ServiceProcess.ServiceInstaller>\] コンポーネントをクリックし、<xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティに適切な値を設定します。  
+  
+    |値|結果|  
+    |-------|--------|  
+    |<xref:System.ServiceProcess.ServiceStartMode>|インストール後に手動でサービスを起動する必要があります。  詳細については、「[方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)」を参照してください。|  
+    |<xref:System.ServiceProcess.ServiceStartMode>|コンピューターを再起動すると、サービスが自動的に起動します。|  
+    |<xref:System.ServiceProcess.ServiceStartMode>|サービスは起動できません。|  
+  
+6.  サービスが実行されるセキュリティ コンテキストを決定するには、\[<xref:System.ServiceProcess.ServiceProcessInstaller>\] コンポーネントをクリックし、適切なプロパティ値を設定します。  詳細については、「[方法 : サービスのセキュリティ コンテキストを指定する](../../../docs/framework/windows-services/how-to-specify-the-security-context-for-services.md)」を参照してください。  
+  
+7.  カスタム処理の実行が必要なメソッドをオーバーライドします。  
+  
+8.  プロジェクトに作成するサービスごとに、手順 1 ～ 7 を実行します。  
+  
+    > [!NOTE]
+    >  プロジェクトに作成するすべてのサービスについて、<xref:System.ServiceProcess.ServiceInstaller> コンポーネントをプロジェクトの `ProjectInstaller` クラスに追加する必要があります。  手順 3 で追加した <xref:System.ServiceProcess.ServiceProcessInstaller> コンポーネントは、プロジェクトのすべてのサービス インストーラーに適用されます。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)   
+ [方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)   
+ [方法 : サービスのセキュリティ コンテキストを指定する](../../../docs/framework/windows-services/how-to-specify-the-security-context-for-services.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-continue-a-windows-service-visual-basic.md b/docs/framework/windows-services/how-to-continue-a-windows-service-visual-basic.md
new file mode 100644
index 00000000000..f203420d60d
--- /dev/null
+++ b/docs/framework/windows-services/how-to-continue-a-windows-service-visual-basic.md
@@ -0,0 +1,59 @@
+---
+title: "方法: Windows サービスを続行する (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ServiceController.Continue"
+helpviewer_keywords: 
+  - "一時停止 (Windows サービス アプリケーションを)"
+  - "Windows サービス アプリケーション, 一時中断"
+ms.assetid: e5d13760-4c83-4b0d-abef-39852677cd7a
+caps.latest.revision: 16
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 16
+---
+# 方法: Windows サービスを続行する (Visual Basic)
+次に示すのは、<xref:System.ServiceProcess.ServiceController> コンポーネントを使用して、ローカル コンピューターの IIS Admin サービスを続行する例です。  
+  
+## 使用例  
+ [!code-vb[VbRadconService#11](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#11)]  
+[!code-vb[VbRadconService#13](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#13)]  
+  
+ このコードの例は、IntelliSense コード スニペットとしても利用できます。  コード スニペット ピッカーでは、このコードは、**\[Windows オペレーティング システム\] \> \[Windows サービス\]** にあります。  詳細については、「[コード スニペット](../Topic/Code%20Snippets.md)」を参照してください。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.serviceprocess.dll に対するプロジェクト参照。  
+  
+-   <xref:System.ServiceProcess> 名前空間のメンバーに対するアクセス。  コード内でメンバー名を完全修飾していない場合は、`Imports` ステートメントを追加します。  詳細については、「[Imports Statement \(.NET Namespace and Type\)](../../../ocs/visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md)」を参照してください。  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.ServiceProcess.ServiceController> クラスの <xref:System.ServiceProcess.ServiceController.MachineName%2A> プロパティは、既定ではローカル コンピューターに設定されています。  他のコンピューターの Windows サービスを参照するには、<xref:System.ServiceProcess.ServiceController.MachineName%2A> プロパティを目的のコンピューター名に変更します。  
+  
+ サービス コントローラーのステータスが <xref:System.ServiceProcess.ServiceControllerStatus> になるまでは、そのサービスに対して <xref:System.ServiceProcess.ServiceController.Continue%2A> メソッドを呼び出すことはできません。  
+  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   サービスを再開できない場合  \(<xref:System.InvalidOperationException>\)  
+  
+-   システム API へのアクセスでエラーが発生した場合  \(<xref:System.ComponentModel.Win32Exception>\)  
+  
+## .NET Framework セキュリティ  
+ <xref:System.ServiceProcess.ServiceControllerPermissionAccess> 列挙体を使用して <xref:System.ServiceProcess.ServiceControllerPermission> クラスでアクセス許可を設定することにより、使用するコンピューターのサービスに対する制御を制限できます。  
+  
+ <xref:System.Security.Permissions.PermissionState> 列挙体を使用して <xref:System.Security.Permissions.SecurityPermission> クラスでアクセス許可を設定することにより、サービス情報へのアクセスを制限できます。  
+  
+## 参照  
+ <xref:System.ServiceProcess.ServiceController>   
+ <xref:System.ServiceProcess.ServiceControllerStatus>   
+ [方法: Windows サービスを一時中断する \(Visual Basic\)](../../../docs/framework/windows-services/how-to-pause-a-windows-service-visual-basic.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-create-windows-services.md b/docs/framework/windows-services/how-to-create-windows-services.md
new file mode 100644
index 00000000000..0f1a36af864
--- /dev/null
+++ b/docs/framework/windows-services/how-to-create-windows-services.md
@@ -0,0 +1,84 @@
+---
+title: "方法 : Windows サービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "テンプレート, Windows サービス"
+  - "Windows サービス アプリケーション, 作成"
+ms.assetid: 0f5e2cbb-d95d-477c-b2b5-4b990e6b86ff
+caps.latest.revision: 18
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 18
+---
+# 方法 : Windows サービスを作成する
+サービスを作成するときには、**Windows サービス**と呼ばれる、Visual Studio プロジェクトのテンプレートを使用できます。  このテンプレートを使用すると、作業の多くを自動化できます。この自動化は、適切なクラスと名前空間を参照し、サービスの基底クラスからの継承を設定し、メソッドのいくつかをオーバーライドすることで実現されます。  
+  
+> [!WARNING]
+>  Windows サービスのプロジェクト テンプレートは、Visual Studio の Express Edition では使用できません。  
+  
+ 実用的なサービスを作成するには、少なくとも以下の作業を行う必要があります。  
+  
+-   <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティを設定します。  
+  
+-   サービス アプリケーションに必要なインストーラーを作成します。  
+  
+-   <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドのオーバーライドとコーディングを行い、サービスの動作をカスタマイズします。  
+  
+### Windows サービス アプリケーションを作成するには  
+  
+1.  **Windows サービス** プロジェクトを作成します。  
+  
+    > [!NOTE]
+    >  テンプレートを使用せずにサービスを記述する方法については、「[方法 : プログラムでサービスを作成する](../../../docs/framework/windows-services/how-to-write-services-programmatically.md)」を参照してください。  
+  
+2.  **\[プロパティ\]** ウィンドウで、サービスの <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティを設定します。  
+  
+     ![ServiceName プロパティを設定する。](../../../docs/framework/windows-services/media/windowsservice-servicename.png "WindowsService\_ServiceName")  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティの値は、各インストーラー クラスに記録されている名前と一致する必要があります。  このプロパティを変更した場合は、インストーラー クラスの <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティも変更する必要があります。  
+  
+3.  次のいずれかのプロパティを設定して、サービスの動作を決定します。  
+  
+    |プロパティ|設定|  
+    |-----------|--------|  
+    |<xref:System.ServiceProcess.ServiceBase.CanStop%2A>|サービスが実行停止要求を受け付ける場合は `True` を設定します。サービスの実行を停止しない場合は `false` を設定します。|  
+    |<xref:System.ServiceProcess.ServiceBase.CanShutdown%2A>|サービスがコンピューターのシャットダウン時に通知を受けて <xref:System.ServiceProcess.ServiceBase.OnShutdown%2A> プロシージャを呼び出す場合は、`True` を設定します。|  
+    |<xref:System.ServiceProcess.ServiceBase.CanPauseAndContinue%2A>|サービスが一時停止要求または再開要求を受け付ける場合は `True` を設定します。サービスを一時停止または再開しない場合は `false` を設定します。|  
+    |<xref:System.ServiceProcess.ServiceBase.CanHandlePowerEvent%2A>|コンピューターの電源状態の変化をサービスに通知する場合は `True`  を設定します。サービスに電源状態の変化を通知しない場合は、`false` を設定します。|  
+    |<xref:System.ServiceProcess.ServiceBase.AutoLog%2A>|サービスがアクションを実行したときにアプリケーション イベント ログに情報を入力する場合は `True` を設定します。この機能を無効にする場合は `false` を設定します。  詳細については、「[方法 : サービスに関する情報のログを記録する](../../../docs/framework/windows-services/how-to-log-information-about-services.md)」を参照してください。 **Note:**  既定では、<xref:System.ServiceProcess.ServiceBase.AutoLog%2A> は `true` に設定されています。|  
+  
+    > [!NOTE]
+    >  <xref:System.ServiceProcess.ServiceBase.CanStop%2A>  `` または <xref:System.ServiceProcess.ServiceBase.CanPauseAndContinue%2A> `` を `false` に設定すると、**サービス コントロール マネージャー**は、対応するメニュー オプション \(サービスの停止、一時停止、または継続\) を無効にします。  
+  
+4.  コード エディターを起動し、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> プロシージャと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> プロシージャの処理を記述します。  
+  
+5.  ほかに動作を定義するメソッドがある場合は、それをオーバーライドします。  
+  
+6.  サービス アプリケーションの必要なインストーラーを追加します。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+7.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックして、プロジェクトを作成します。  
+  
+    > [!NOTE]
+    >  F5 キーを押してプロジェクトを実行しないでください。この方法ではサービス プロジェクトを実行できません。  
+  
+8.  サービスをインストールします。  詳細については、「[方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)」を参照してください。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : プログラムでサービスを作成する](../../../docs/framework/windows-services/how-to-write-services-programmatically.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)   
+ [方法 : サービスに関する情報のログを記録する](../../../docs/framework/windows-services/how-to-log-information-about-services.md)   
+ [方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)   
+ [方法 : サービスのセキュリティ コンテキストを指定する](../../../docs/framework/windows-services/how-to-specify-the-security-context-for-services.md)   
+ [方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)   
+ [チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-debug-windows-service-applications.md b/docs/framework/windows-services/how-to-debug-windows-service-applications.md
new file mode 100644
index 00000000000..4a620c248a9
--- /dev/null
+++ b/docs/framework/windows-services/how-to-debug-windows-service-applications.md
@@ -0,0 +1,125 @@
+---
+title: "方法 : Windows サービス アプリケーションをデバッグする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デバッグ [Visual Studio], Windows サービス"
+  - "デバッグ (Windows サービス アプリケーションの)"
+  - "サービス, デバッグ"
+  - "Windows NT サービス, デバッグ"
+  - "Windows サービス アプリケーション, デバッグ"
+ms.assetid: 63ab0800-0f05-4f1e-88e6-94c73fd920a2
+caps.latest.revision: 16
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 16
+---
+# 方法 : Windows サービス アプリケーションをデバッグする
+サービスは、Visual Studio 内からではなく、サービス コントロール マネージャーのコンテキスト内から実行する必要があります。  そのため、サービスのデバッグは、その他の種類の Visual Studio アプリケーションをデバッグするように単純ではありません。  サービスのデバッグを行うには、サービスを起動してから、サービスを実行しているプロセスにデバッガーをアタッチします。  これにより、Visual Studio のすべての標準デバッグ機能を使用して、アプリケーションをデバッグできるようになります。  
+  
+> [!CAUTION]
+>  プロセスが強制終了される可能性もあるため、アタッチするプロセスの特性や、アタッチによる影響をよく理解している場合に限って、プロセスにデバッガーをアタッチしてください。  たとえば、システムは WinLogon プロセスがないと動作しないため、WinLogon プロセスにデバッガーをアタッチした後でデバッグを中止すると、システムは停止します。  
+  
+ デバッガーをアタッチできるのは、実行中のサービスだけです。  アタッチのプロセスは、サービスが現在実行している処理に割り込みます。実際にサービスの処理の停止や一時停止を行うのではありません。  つまり、実行中のサービスに対してデバッグを開始すると、デバッグの間、サービスは技術的には起動状態のままですが、処理は中断されます。  
+  
+ プロセスにデバッガーをアタッチした後で、ブレークポイントを設定し、設定したブレークポイントを使用してコードをデバッグできます。  プロセスへのアタッチに使用するダイアログ ボックスを閉じると、デバッグ モードが有効になります。  サービス コントロール マネージャーを使用して、サービスの開始、停止、一時停止、および再開を行うことができます。これによって、設定したブレークポイントにヒットします。  デバッグが正常に完了したら、このダミー サービスを削除できます。  
+  
+ この記事ではローカル コンピューターで実行されているサービスのデバッグについて説明しますが、リモート コンピューターで実行されている Windows サービスをデバッグすることもできます。  「[リモート デバッグ](../Topic/Remote%20Debugging.md)」を参照してください。  
+  
+> [!NOTE]
+>  サービス コントロール マネージャーではすべてのサービスの開始試行に対して 30 秒の制限が適用されるため、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドのデバッグが困難になる場合があります。  詳細については、「[Windows サービスをデバッグする場合](../../../docs/framework/windows-services/troubleshooting-debugging-windows-services.md)」を参照してください。  
+  
+> [!WARNING]
+>  デバッグに有用な情報を取得するためには、Visual Studio デバッガーは、デバッグ対象のバイナリのシンボル ファイルを検索する必要があります。  Visual Studio に組み込まれているサービスをデバッグしている場合は、シンボル ファイル \(.pdb ファイル\) は実行可能ファイルまたはライブラリと同じフォルダーにあり、デバッガーはそれらを自動的に読み込みます。  構築していないサービスをデバッグしている場合は、最初にサービスのシンボルを検索し、デバッガーでこれらを検出できるようにする必要があります。  「[シンボルとソース コードの管理](../Topic/Specify%20Symbol%20\(.pdb\)%20and%20Source%20Files%20in%20the%20Visual%20Studio%20Debugger.md)」を参照してください。  システム プロセスをデバッグしているか、サービスにシステム呼び出しのシンボルを含めたい場合は、Microsoft シンボル サーバーを追加する必要があります。  「[シンボルを使用したデバッグ](http://msdn.microsoft.com/windows/desktop/ee416588.aspx)」を参照してください。  
+  
+### サービスをデバッグするには  
+  
+1.  サービスをデバッグ構成で構築します。  
+  
+2.  サービスをインストールします。  詳細については、「[方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)」を参照してください。  
+  
+3.  **サービス コントロール マネージャー**、**サーバー エクスプローラー**、またはコードで、サービスを起動します。  詳細については、「[方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)」を参照してください。  
+  
+4.  システム プロセスにアタッチすることができるように、管理者資格情報を使用して Visual Studio を起動します。  
+  
+5.  \(省略可能\) Visual Studio のメニュー バーで **\[ツール\]**、**\[オプション\]** の順に選択します。  **\[オプション\]** ダイアログ ボックスで、**\[デバッグ\]**、**\[シンボル\]** の順に選択し、**\[Microsoft シンボル サーバー\]** チェック ボックスをオンにし、**\[OK\]** を選択します。  
+  
+6.  メニュー バーの **\[デバッグ\]** または **\[ツール\]** メニューで、**\[プロセスにアタッチ\]** を選択します。  \(キーボード: Ctrl \+ Alt \+ P\)  
+  
+     **\[プロセス\]** ダイアログ ボックスが表示されます。  
+  
+7.  **\[Show processes from all users\]** チェック ボックスをオンにします。  
+  
+8.  **\[選択可能なプロセス\]** セクションでサービスのプロセスを選択し、**\[アタッチ\]** を選択します。  
+  
+    > [!TIP]
+    >  プロセスの名前は、サービスの実行可能ファイルの名前と同じになります。  
+  
+     **\[プロセスにアタッチ\]** ダイアログ ボックスが表示されます。  
+  
+9. 適切なオプションを選択し、**\[OK\]** を選択してダイアログ ボックスを閉じます。  
+  
+    > [!NOTE]
+    >  デバッグ モードになります。  
+  
+10. コード内で使用する任意のブレークポイントを設定します。  
+  
+11. サービス コントロール マネージャーを起動し、停止、一時停止、再開の各コマンドを送信してサービスを操作して、ブレークポイントをヒットします。  サービス コントロール マネージャーの実行方法の詳細については、「[方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)」を参照してください。  さらに、「[Windows サービスをデバッグする場合](../../../docs/framework/windows-services/troubleshooting-debugging-windows-services.md)」を参照してください。  
+  
+## Windows サービスのデバッグのヒント  
+ サービスのプロセスにアタッチすると、そのサービスのコードのほとんど \(すべてではない\) をデバッグすることができます。  たとえば、サービスが既に開始されているため、そのサービスの <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッド内のコード、またはサービスをこの方法で読み込むために使用されている `Main` メソッド内のコードは、デバッグすることができません。  この制限に対処する方法の 1 つは、デバッグ専用の一時的な "ダミー" サービスを作成し、サービス アプリケーションに追加することです。  サービスを両方ともインストールし、ダミー サービスを開始してサービス プロセスを読み込むことができます。  "ダミー" サービスがプロセスを起動した後は、Visual Studio の **\[デバッグ\]** メニューで、サービス プロセスへのアタッチを行うことができます。  
+  
+ <xref:System.Threading.Thread.Sleep%2A> メソッドに呼び出しを追加して、プロセスにアタッチできるようになるまで動作を遅延します。  
+  
+ プログラムを通常のコンソール アプリケーションに変更します。  このためには、起動方法に応じて Windows サービスとコンソール アプリケーションの両方として実行することができるように、`Main` メソッドを次のように書き換えます。  
+  
+#### 方法: Windows サービスをコンソール アプリケーションとして実行する  
+  
+1.  <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドを実行するサービスにメソッドを追加します。  
+  
+    ```  
+    internal void TestStartupAndStop(string[] args)  
+    {  
+        this.OnStart(args);  
+        Console.ReadLine();  
+        this.OnStop();  
+    }  
+    ```  
+  
+2.  `Main` メソッドを次のように書き換えます。  
+  
+    ```  
+    static void Main(string[] args)  
+            {  
+                if (Environment.UserInteractive)  
+                {  
+                    MyNewService service1 = new MyNewService(args);  
+                    service1.TestStartupAndStop(args);  
+                }  
+                else  
+                {  
+                    // Put the body of your old Main method here.  
+                }  
+    ```  
+  
+3.  プロジェクトのプロパティの **\[アプリケーション\]** タブで、**\[出力の種類\]** を **\[コンソール アプリケーション\]** に設定します。  
+  
+4.  **\[デバッグの開始\]** を選択します \(F5\)。  
+  
+5.  プログラムを再度 Windows サービスとして実行するには、プログラムをインストールして、Windows サービスとして通常どおり起動します。  これらの変更を反対にする必要はありません。  
+  
+ システムの起動時にのみ発生する問題をデバッグするときなどのいくつかのケースでは、Windows デバッガーを使用する必要があります。  [Windows 用のデバッグ ツール](http://msdn.microsoft.com/windows/hardware/hh852365)をインストールし、「[Windows サービスをデバッグする方法](http://support.microsoft.com/kb/824344)」を参照してください。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)   
+ [方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)   
+ [サービスのデバッグ](http://msdn.microsoft.com/library/windows/desktop/ms682546.aspx)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-install-and-uninstall-services.md b/docs/framework/windows-services/how-to-install-and-uninstall-services.md
new file mode 100644
index 00000000000..61a5a849d03
--- /dev/null
+++ b/docs/framework/windows-services/how-to-install-and-uninstall-services.md
@@ -0,0 +1,75 @@
+---
+title: "方法: サービスをインストールおよびアンインストールする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インストール, Windows サービス"
+  - "インストール (Windows サービスを)"
+  - "installutil.exe ツール"
+  - "サービス, インストール"
+  - "サービス, アンインストール"
+  - "アンインストール (アプリケーションを), Windows サービス"
+  - "アンインストール (Windows サービスを)"
+  - "Windows サービス アプリケーション, 配置"
+ms.assetid: c89c5169-f567-4305-9d62-db31a1de5481
+caps.latest.revision: 19
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 17
+---
+# 方法: サービスをインストールおよびアンインストールする
+.NET Framework を使用して Windows サービスを開発している場合は、InstallUtil.exe というコマンド ライン ユーティリティを使用してサービス アプリケーションをすばやくインストールできます。  開発者は、ユーザーがインストールおよびアンインストールできる Windows サービスをリリースする場合、InstallShield を使用する必要があります。  「[Windows インストーラーの配置](http://msdn.microsoft.com/ja-jp/121be21b-b916-43e2-8f10-8b080516d2a0)」を参照してください。  
+  
+> [!WARNING]
+>  サービスをコンピューターからアンインストールする場合は、この記事の手順には従わないでください。  代わりに、サービスをインストールしたプログラムまたはソフトウェア パッケージを確認し、\[コントロール パネル\] の **\[プログラムの追加と削除\]** を選択してそのプログラムをアンインストールします。  多くのサービスが Windows の不可欠な構成要素であることに注意してください。それらを削除すると、システムが不安定になることがあります。  
+  
+ この記事の手順を使用するためには、まず、Windows サービスにサービス インストーラーを追加する必要があります。  「[チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)」を参照してください。  
+  
+ Windows サービス プロジェクトは、F5 キーを押して Visual Studio 開発環境から直接実行することができません。  これは、プロジェクトを実行する前に、プロジェクトのサービスをインストールする必要があるためです。  
+  
+> [!TIP]
+>  **サーバー エクスプローラー**を起動して、サービスがインストールまたはアンインストールされているかどうかを確認できます。  詳細については、「[方法 : サーバー エクスプローラー\/データベース エクスプローラーにアクセスして初期化する](../Topic/How%20to:%20Access%20and%20Initialize%20Server%20Explorer-Database%20Explorer.md)」を参照してください。  
+  
+### サービスを手動でインストールするには  
+  
+1.  Windows の **\[スタート\]** メニューまたは **\[スタート\]** 画面で、**\[Visual Studio\]**、**\[Visual Studio ツール\]**、**\[開発者コマンド プロンプト\]** の順に選択します。  
+  
+     Visual Studio コマンド プロンプトが表示されます。  
+  
+2.  プロジェクトのコンパイル済み実行可能ファイルが格納されているディレクトリに移動します。  
+  
+3.  プロジェクトの実行可能ファイルをパラメーターとして指定し、コマンド プロンプトから InstallUtil.exe を実行します。  
+  
+    ```  
+    installutil <yourproject>.exe  
+    ```  
+  
+     Visual Studio コマンド プロンプトを使用している場合は、InstallUtil.exe がシステム パス上にある必要があります。  該当しない場合は、パスに追加するか、完全修飾パスを使用して起動します。  このツールは .NET Framework と共にインストールされ、パスは `%WINDIR%\Microsoft.NET\Framework[64]\<framework_version>` です。  たとえば、32 ビット版の .NET Framework 4 または 4.5\* では、Windows のインストール ディレクトリが C:\\Windows である場合、パスは `C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe` になります。  64 ビット版の .NET Framework 4 または 4.5\* では、既定のパスは `C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe` になります。  
+  
+### サービスを手動でアンインストールするには  
+  
+1.  Windows の **\[スタート\]** メニューまたは **\[スタート\]** 画面で、**\[Visual Studio\]**、**\[Visual Studio ツール\]**、**\[開発者コマンド プロンプト\]** の順に選択します。  
+  
+     Visual Studio コマンド プロンプトが表示されます。  
+  
+2.  プロジェクトの出力先ファイルをパラメーターとして指定し、コマンド プロンプトから InstallUtil.exe を実行します。  
+  
+    ```  
+    installutil /u <yourproject>.exe  
+    ```  
+  
+3.  場合によっては、サービスの実行可能ファイルを削除した後も、レジストリ内にサービスが存在したままになることがあります。  このような場合は、コマンド [sc delete](http://technet.microsoft.com/library/cc742045.aspx) を使用して、レジストリからサービスのエントリを削除します。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)   
+ [Installutil.exe \(インストーラー ツール\)](../../../docs/framework/tools/installutil-exe-installer-tool.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-log-information-about-services.md b/docs/framework/windows-services/how-to-log-information-about-services.md
new file mode 100644
index 00000000000..95a7ac97fcb
--- /dev/null
+++ b/docs/framework/windows-services/how-to-log-information-about-services.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : サービスに関する情報のログを記録する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション イベント ログ, サービス アプリケーション"
+  - "AutoLog プロパティ"
+  - "イベント ログ, サービス アプリケーション"
+  - "ログ, サービス アプリケーション"
+  - "サービス, ログ情報"
+  - "Windows サービス アプリケーション, ログ情報"
+ms.assetid: c0d8140f-c055-4d8e-a2e0-37358a550116
+caps.latest.revision: 17
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 17
+---
+# 方法 : サービスに関する情報のログを記録する
+既定では、すべての Windows サービス プロジェクトはアプリケーション イベント ログとやり取りして、そこに情報および例外を書き込むことができます。 アプリケーションにこの機能が必要かどうかを指定するには、<xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを使用します。 既定では、Windows サービス プロジェクト テンプレートで作成したサービスには、ログが有効にされます。<xref:System.Diagnostics.EventLog> クラスの静的フォームを使用すると、<xref:System.Diagnostics.EventLog> コンポーネントのインスタンスを作成したり、手動でソースを登録したりすることなく、ログにサービス情報を書き込むことができます。  
+  
+ ログが有効にされていると、サービスのインストーラーは自動的に、プロジェクトの各サービスを有効なイベント ソースとして、サービスのインストール先コンピューター上のアプリケーション ログに登録します。 サービスの起動時、停止時、一時停止時、再開時、インストール時、アンインストール時には常に、サービスが情報をログに記録します。 また、発生したすべてのエラーもログに記録します。 既定の動作を使用している場合、ログにエントリを書き込むためのコードを作成する必要はありません。これは、サービスが自動的に処理します。  
+  
+ アプリケーション ログ以外のイベント ログに書き込む必要がある場合は、<xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを `false` に設定し、サービス コード内に独自のカスタム イベント ログを作成して、そのログに有効なエントリのソースとしてサービスを登録します。 その後、対象の操作が行われるたびにログにエントリを記録するコードを作成する必要があります。  
+  
+> [!NOTE]
+>  カスタム イベント ログを使用して、そのログに書き込むようにサービス アプリケーションを構成する場合、コードでサービスの <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティを設定する前に、そのイベント ログにアクセスしようとしないでください。 サービスを有効なイベントのソースとして登録するには、イベント ログにこのプロパティの値が必要です。  
+  
+### サービスの既定のイベント ログを有効にするには  
+  
+-   コンポーネントの <xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを `true` に設定します。  
+  
+    > [!NOTE]
+    >  既定では、このプロパティは `true` に設定されています。 条件を評価してから、その条件の結果に基づいて <xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを設定するなどの複雑な処理を作成するのでない限り、このプロパティを明示的に設定する必要はありません。  
+  
+### サービスの既定のイベント ログを無効にするには  
+  
+-   コンポーネントの <xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを `false` に設定します。  
+  
+     [!code-csharp[VbRadconService#17](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#17)]
+     [!code-vb[VbRadconService#17](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#17)]  
+  
+### カスタム ログへのログ記録を設定するには  
+  
+1.  <xref:System.ServiceProcess.ServiceBase.AutoLog%2A> プロパティを `false` に設定します。  
+  
+    > [!NOTE]
+    >  カスタム ログを使用するには、<xref:System.ServiceProcess.ServiceBase.AutoLog%2A> を false に設定する必要があります。  
+  
+2.  Windows サービス アプリケーションに <xref:System.Diagnostics.EventLog> コンポーネントのインスタンスを設定します。  
+  
+3.  <xref:System.Diagnostics.EventLog.CreateEventSource%2A> メソッドを呼び出し、作成するログ ファイルのソース文字列と名前を指定して、カスタム ログを作成します。  
+  
+4.  <xref:System.Diagnostics.EventLog> コンポーネント インスタンスの <xref:System.Diagnostics.EventLog.Source%2A> プロパティを、手順 3 で作成したソース文字列に設定します。  
+  
+5.  <xref:System.Diagnostics.EventLog> コンポーネント インスタンスで <xref:System.Diagnostics.EventLog.WriteEntry%2A> メソッドにアクセスして、エントリを作成します。  
+  
+     次のコードに、カスタム ログへのログ記録を設定する方法を示します。  
+  
+    > [!NOTE]
+    >  このコード例では、<xref:System.Diagnostics.EventLog> コンポーネントのインスタンスに `eventLog1` という名前を付けています \(Visual Basic では `EventLog1`\)。 手順 2 で別の名前を持つインスタンスを作成した場合は、それに応じてコードを変更してください。  
+  
+     [!code-csharp[VbRadconService#14](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#14)]
+     [!code-vb[VbRadconService#14](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#14)]  
+    [!code-csharp[VbRadconService#15](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#15)]
+    [!code-vb[VbRadconService#15](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#15)]  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-pause-a-windows-service-visual-basic.md b/docs/framework/windows-services/how-to-pause-a-windows-service-visual-basic.md
new file mode 100644
index 00000000000..2d93dac3daf
--- /dev/null
+++ b/docs/framework/windows-services/how-to-pause-a-windows-service-visual-basic.md
@@ -0,0 +1,58 @@
+---
+title: "方法: Windows サービスを一時中断する (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ServiceController.Pause"
+helpviewer_keywords: 
+  - "一時停止 (Windows サービス アプリケーションを)"
+  - "Windows サービス アプリケーション, 一時中断"
+ms.assetid: eddb9409-942b-46b6-a2ce-fbd4c65f2790
+caps.latest.revision: 17
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 15
+---
+# 方法: Windows サービスを一時中断する (Visual Basic)
+次に示すのは、<xref:System.ServiceProcess.ServiceController> コンポーネントを使用して、ローカル コンピューターの IIS Admin サービスを一時中断する例です。  
+  
+## 使用例  
+ [!code-vb[VbRadconService#11](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#11)]  
+[!code-vb[VbRadconService#12](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#12)]  
+  
+ このコードの例は、IntelliSense コード スニペットとしても利用できます。  コード スニペット ピッカーでは、このコードは、**\[Windows オペレーティング システム\] \> \[Windows サービス\]** にあります。  詳細については、「[コード スニペット](../Topic/Code%20Snippets.md)」を参照してください。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.serviceprocess.dll に対するプロジェクト参照。  
+  
+-   <xref:System.ServiceProcess> 名前空間のメンバーに対するアクセス。  コード内でメンバー名を完全修飾していない場合は、`Imports` ステートメントを追加します。  詳細については、「[Imports Statement \(.NET Namespace and Type\)](../../../ocs/visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md)」を参照してください。  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.ServiceProcess.ServiceController> クラスの <xref:System.ServiceProcess.ServiceController.MachineName%2A> プロパティは、既定ではローカル コンピューターに設定されています。  他のコンピューターの Windows サービスを参照するには、<xref:System.ServiceProcess.ServiceController.MachineName%2A> プロパティを目的のコンピューター名に変更します。  
+  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   サービスが一時中断できない場合  \([InvalidOperationException クラス](frlrfSystemInvalidOperationExceptionClassTopic)\)  
+  
+-   システム API へのアクセスでエラーが発生した場合  \([Win32Exception クラス](frlrfSystemComponentModelWin32ExceptionClassTopic)\)  
+  
+## .NET Framework セキュリティ  
+ [ServiceControllerPermissionAccess 列挙体](frlrfSystemServiceProcessServiceControllerPermissionAccessClassTopic)を使用して[ServiceControllerPermission クラス](frlrfSystemServiceProcessServiceControllerPermissionClassTopic)でアクセス許可を設定することにより、使用するコンピューターのサービスに対する制御を制限できます。  
+  
+ [PermissionState 列挙体](frlrfSystemSecurityPermissionsPermissionStateClassTopic)を使用して [SecurityPermission クラス](frlrfSystemSecurityPermissionsSecurityPermissionClassTopic)でアクセス許可を設定することにより、サービス情報へのアクセスを制限できます。  
+  
+## 参照  
+ <xref:System.ServiceProcess.ServiceController>   
+ <xref:System.ServiceProcess.ServiceControllerStatus>   
+ <xref:System.ServiceProcess.ServiceController.WaitForStatus%2A>   
+ [方法: Windows サービスを続行する \(Visual Basic\)](../../../docs/framework/windows-services/how-to-continue-a-windows-service-visual-basic.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-specify-the-security-context-for-services.md b/docs/framework/windows-services/how-to-specify-the-security-context-for-services.md
new file mode 100644
index 00000000000..8e4cd31bd73
--- /dev/null
+++ b/docs/framework/windows-services/how-to-specify-the-security-context-for-services.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : サービスのセキュリティ コンテキストを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテキスト, Visual Studio のセキュリティ"
+  - "セキュリティ [Visual Studio], コンテキスト"
+  - "セキュリティ [Visual Studio], サービス アプリケーション"
+  - "ServiceInstaller クラス, セキュリティ コンテキスト"
+  - "ServiceProcessInstaller クラス, セキュリティ コンテキスト"
+  - "サービス, セキュリティ"
+  - "Windows サービス アプリケーション, セキュリティ"
+ms.assetid: 02187c7b-dbf2-45f2-96c2-e11010225a22
+caps.latest.revision: 10
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 10
+---
+# 方法 : サービスのセキュリティ コンテキストを指定する
+既定では、サービスは、ログイン ユーザーのセキュリティ コンテキストとは異なるセキュリティ コンテキストで実行されます。  サービスは、`LocalSystem` という既定のシステム アカウントのコンテキストで実行されます。このアカウントがサービスに認可するシステム リソースへのアクセス特権は、ユーザーに認可するものとは異なります。  この動作を変更して、サービスを実行する他のユーザー アカウントを指定できます。  
+  
+ セキュリティ コンテキストを設定するには、サービスが実行されるプロセスの <xref:System.ServiceProcess.ServiceProcessInstaller.Account%2A> プロパティを操作します。  このプロパティを使用することにより、サービスを次の 4 種類のアカウントのうちのいずれかに設定できます。  
+  
+-   `User`。サービスをインストールするときにシステムによって有効なユーザー名とパスワードが要求され、ネットワーク上の 1 人のユーザーによって指定されたアカウントのコンテキストで実行されます。  
+  
+-   `LocalService`。ローカル コンピューターで非特権ユーザーとして機能するアカウントのコンテキストで実行され、リモート サーバーには匿名の資格情報を渡します。  
+  
+-   `LocalSystem`は、リモート サーバーに、各種のローカル権限を提供する、コンピューター資格情報を表示したりアカウントのコンテキストで実行;  
+  
+-   `NetworkService`。ローカル コンピューター上で非特権ユーザーとして機能するアカウントのコンテキストで実行され、リモート サーバーにはコンピューター自体の資格情報を渡します。  
+  
+ 詳細については、<xref:System.ServiceProcess.ServiceAccount> 列挙体の解説を参照してください。  
+  
+### サービスのセキュリティ コンテキストを指定するには  
+  
+1.  サービスの作成後、必要なインストーラーを追加します。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+2.  デザイナーで、`ProjectInstaller` クラスにアクセスし、対象となるサービスのサービス プロセス インストーラーをクリックします。  
+  
+    > [!NOTE]
+    >  いずれのサービス アプリケーションの場合でも、少なくとも 2 つのインストール コンポーネントが `ProjectInstaller` クラスにあります。1 つはプロジェクトのすべてのサービスのプロセスをインストールするコンポーネントで、もう 1 つはアプリケーションに含まれているサービス単位でインストールするコンポーネントです。  この場合は、<xref:System.ServiceProcess.ServiceProcessInstaller> を選択します。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.ServiceProcess.ServiceProcessInstaller.Account%2A> を適切な値に設定します。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-start-services.md b/docs/framework/windows-services/how-to-start-services.md
new file mode 100644
index 00000000000..331a103b248
--- /dev/null
+++ b/docs/framework/windows-services/how-to-start-services.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : サービスを開始する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス, 開始"
+  - "Windows サービス アプリケーション, 開始"
+ms.assetid: 9ea77955-2d96-4c3d-913c-14db7604cdad
+caps.latest.revision: 16
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 14
+---
+# 方法 : サービスを開始する
+サービスをインストールした後で、サービスを起動します。  起動することで、サービス クラスの <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドが呼び出されます。  通常、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドにはサービスが本来行う処理を定義します。  サービスの起動後は、手動で一時停止または停止するまで、アクティブの状態を維持します。  
+  
+ サービスを自動で起動するか手動で起動するかを設定できます。  自動的に起動するサービスは、そのサービスがインストールされているコンピューターを再起動したとき、または初めて電源を入れたときに起動します。  手動で起動するサービスは、ユーザーが起動する必要があります。  
+  
+> [!NOTE]
+>  既定では、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で作成されたサービスは手動で起動するように設定されます。  
+  
+ サービスを手動で起動するには、**サーバー エクスプローラー**または**サービス コントロール マネージャー**を使用します。<xref:System.ServiceProcess.ServiceController> コンポーネントでコードによって起動することもできます。  
+  
+ <xref:System.ServiceProcess.ServiceInstaller> クラスの <xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティを設定し、サービスを手動で起動するか自動で起動するかを指定します。  
+  
+### サービスの起動方法を指定するには  
+  
+1.  サービスの作成後、必要なインストーラーを追加します。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+2.  デザイナーで、対象となるサービスのインストーラーをクリックします。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティに次のいずれかの値を設定します。  
+  
+    |サービスを起動するタイミング|設定値|  
+    |--------------------|---------|  
+    |コンピューターを再起動したとき。|**自動**|  
+    |明示的なユーザー アクションによってサービスを開始するとき。|**手動**|  
+  
+    > [!TIP]
+    >  サービスが起動しないようにするには、<xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティを **\[無効\]** に設定します。  サーバーを数回再起動することが見込まれる場合は、サービスを自動的に起動しないように設定することで、再起動の時間を短縮できます。  
+  
+    > [!NOTE]
+    >  以上のプロパティやその他のプロパティの設定は、サービスのインストール後に変更できます。  
+  
+     <xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティが **\[手動\]** に設定されているサービスを起動するには、**サーバー エクスプローラー**または **Windows サービス コントロール マネージャー**を使用します。また、コードで起動することもできます。  起動方法によっては、**サービス コントロール マネージャー**のコンテキストではサービスを起動しません。**サーバー エクスプローラー**によるサービスの起動とコードによるサービスの起動の場合は、実際にはコントローラーを操作しています。  
+  
+### サーバー エクスプローラーでサービスを手動起動するには  
+  
+1.  サーバーが**サーバー エクスプローラー**の一覧にない場合は追加します。  詳細については、「[方法 : サーバー エクスプローラー\/データベース エクスプローラーにアクセスして初期化する](../Topic/How%20to:%20Access%20and%20Initialize%20Server%20Explorer-Database%20Explorer.md)」を参照してください。  
+  
+2.  **\[サービス\]** ノードを展開し、開始するサービスを検索します。  
+  
+3.  サービス名を右クリックし、**\[開始\]** をクリックします。  
+  
+### サービス制御マネージャーでサービスを手動起動するには  
+  
+1.  **サービス コントロール マネージャー**を次のいずれかの方法で開きます。  
+  
+    -   Windows XP および Windows 2000 Professional のデスクトップで、**\[マイ コンピューター\]** を右クリックし、**\[管理\]** をクリックします。  表示されるダイアログ ボックスで、**\[サービスとアプリケーション\]** ノードを展開します。  
+  
+         または  
+  
+    -   Windows Server 2003 および Windows 2000 Server では、**\[スタート\]** メニューの **\[プログラム\]** をポイントし、**\[管理ツール\]** をポイントして、**\[サービス\]** をクリックします。  
+  
+        > [!NOTE]
+        >  Windows NT Version 4.0 では、**\[コントロール パネル\]** でこのダイアログ ボックスを開くことができます。  
+  
+     ウィンドウの **\[サービス\]** セクションに、サービスが一覧表示されます。  
+  
+2.  一覧で目的のサービスを右クリックし、**\[開始\]** をクリックします。  
+  
+### コードでサービスを手動起動するには  
+  
+1.  <xref:System.ServiceProcess.ServiceController> クラスのインスタンスを作成し、管理対象となるサービスと対話するように設定します。  
+  
+2.  <xref:System.ServiceProcess.ServiceController.Start%2A> メソッドを呼び出してサービスを起動します。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)   
+ [方法 : サーバー エクスプローラー\/データベース エクスプローラーにアクセスして初期化する](../Topic/How%20to:%20Access%20and%20Initialize%20Server%20Explorer-Database%20Explorer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/how-to-write-services-programmatically.md b/docs/framework/windows-services/how-to-write-services-programmatically.md
new file mode 100644
index 00000000000..7e67d908e2f
--- /dev/null
+++ b/docs/framework/windows-services/how-to-write-services-programmatically.md
@@ -0,0 +1,81 @@
+---
+title: "方法 : プログラムでサービスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス, 作成"
+  - "Windows サービス アプリケーション, 作成"
+ms.assetid: 3abbb2ec-78d2-41e6-b9f9-6662d4e2cdc7
+caps.latest.revision: 21
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 21
+---
+# 方法 : プログラムでサービスを作成する
+Windows サービス プロジェクトのテンプレートを使用しない場合は、継承などの基本要素を設定して独自のサービスを作成できます。  プログラミングによってサービスを作成する場合は、テンプレートでは自動化される手順を手動で行う必要があります。  
+  
+-   サービス クラスが <xref:System.ServiceProcess.ServiceBase> クラスから継承されるように設定します。  
+  
+-   サービス プロジェクトの `Main` メソッドを作成します。このメソッドは、実行するサービスを定義し、それに対して <xref:System.ServiceProcess.ServiceBase.Run%2A> メソッドを呼び出します。  
+  
+-   <xref:System.ServiceProcess.ServiceBase.OnStart%2A> プロシージャと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> プロシージャをオーバーライドし、任意の処理内容を記述します。  
+  
+### プログラミングによってサービスを作成するには  
+  
+1.  空のプロジェクトを作成し、必要な名前空間への参照を作成するには、次の手順を実行します。  
+  
+    1.  **ソリューション エクスプローラー**で、**\[参照設定\]** ノードを右クリックし、**\[参照の追加\]** をクリックします。  
+  
+    2.  **\[.NET\]** タブで **System.dll** までスクロールして選択し、**\[選択\]** をクリックします。  
+  
+    3.  **System.ServiceProcess.dll** までスクロールして選択し、**\[選択\]** をクリックします。  
+  
+    4.  **\[OK\]** をクリックします。  
+  
+2.  クラスを追加し、<xref:System.ServiceProcess.ServiceBase> から継承されるように設定します。  
+  
+     [!code-csharp[VbRadconService#7](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#7)]
+     [!code-vb[VbRadconService#7](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#7)]  
+  
+3.  次のコードを追加してサービス クラスを設定します。  
+  
+     [!code-csharp[VbRadconService#8](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#8)]
+     [!code-vb[VbRadconService#8](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#8)]  
+  
+4.  クラスの `Main` メソッドを作成し、それを使用してクラスに含まれるサービスを定義します。`userService1` がクラスの名前です。  
+  
+     [!code-csharp[VbRadconService#9](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#9)]
+     [!code-vb[VbRadconService#9](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#9)]  
+  
+5.  <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドをオーバーライドし、サービスの開始時に実行する処理を定義します。  
+  
+     [!code-csharp[VbRadconService#10](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#10)]
+     [!code-vb[VbRadconService#10](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#10)]  
+  
+6.  他に独自の処理を定義するメソッドがあればそれをオーバーライドし、サービスが行うアクションを記述します。  
+  
+7.  サービス アプリケーションの必要なインストーラーを追加します。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+8.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックして、プロジェクトを作成します。  
+  
+    > [!NOTE]
+    >  F5 キーを押してプロジェクトを実行しないでください。この方法ではサービス プロジェクトを実行できません。  
+  
+9. セットアップ プロジェクトと、サービスをインストールするカスタム処理を作成します。  例については、「[チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)」を参照してください。  
+  
+10. サービスをインストールします。  詳細については、「[方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)」を参照してください。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)   
+ [方法 : サービスに関する情報のログを記録する](../../../docs/framework/windows-services/how-to-log-information-about-services.md)   
+ [チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/index.md b/docs/framework/windows-services/index.md
new file mode 100644
index 00000000000..227adc9c7ff
--- /dev/null
+++ b/docs/framework/windows-services/index.md
@@ -0,0 +1,57 @@
+---
+title: "Developing Windows Service Applications | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ServiceInstaller class, Windows Service applications"
+  - "Service class, Windows Service applications"
+  - "Windows Service applications"
+  - "Windows NT services"
+  - "ServiceProcessInstaller class, Windows Service applications"
+  - "services"
+  - ".NET applications, Windows applications"
+ms.assetid: ba72d648-9553-4849-b829-069ad5ea014b
+caps.latest.revision: 18
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 18
+---
+# Developing Windows Service Applications
+[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] または Microsoft [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] SDK を使用すると、サービスとしてインストールされるアプリケーションを作成することで、簡単にサービスを作成できます。  このアプリケーションは Windows サービスと呼ばれます。  フレームワーク機能を使用して、サービスを作成およびインストールできます。また、起動や停止など、サービスの動作制御を行うこともできます。  
+  
+> [!WARNING]
+>  C\+\+ の Windows サービスのテンプレートは、Visual Studio 2010 に含まれていませんでした。  Windows サービスを作成するには、Visual C\# マネージ コードのサービスを作成することも、既存必要に応じて C\+\+ コードと相互運用することも、[ATL プロジェクト ウィザード](../Topic/ATL%20Project%20Wizard.md)を使用してネイティブ C\+\+ の Windows サービスを作成できます Visual Basic。  
+  
+## このセクションの内容  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)  
+ サービス アプリケーションが通常のプロジェクトとの違い Windows サービス アプリケーションの概要、サービスの有効期間ついて説明します。  
+  
+ [チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)  
+ サービスの作成例を [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] および Visual C\# で説明します。  
+  
+ [サービス アプリケーションのプログラミング アーキテクチャ](../../../docs/framework/windows-services/service-application-programming-architecture.md)  
+ サービスのプログラミングに使用する言語要素について説明します。  
+  
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)  
+ Windows サービス プロジェクトのテンプレートを使用して Windows サービスを作成および構成するプロセスについて説明します。  
+  
+## 関連項目  
+ <xref:System.ServiceProcess.ServiceBase>  
+ サービスの作成に使用される <xref:System.ServiceProcess.ServiceBase> クラスの主な機能について説明します。  
+  
+ <xref:System.ServiceProcess.ServiceProcessInstaller>  
+ サービスのインストールおよびアンインストールのために <xref:System.ServiceProcess.ServiceInstaller> クラスと共に使用される、<xref:System.ServiceProcess.ServiceProcessInstaller> クラスの機能について説明します。  
+  
+ <xref:System.ServiceProcess.ServiceInstaller>  
+ サービスのインストールおよびアンインストールのために <xref:System.ServiceProcess.ServiceProcessInstaller> クラスと共に使用される、<xref:System.ServiceProcess.ServiceInstaller> クラスの機能について説明します。  
+  
+ [テンプレートからのプロジェクトの作成](http://msdn.microsoft.com/ja-jp/7c36d86a-6b79-4480-8228-0f925f1204b2)  
+ この章で使用されているプロジェクトの種類と、プロジェクトの種類の選び方について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-services/introduction-to-windows-service-applications.md b/docs/framework/windows-services/introduction-to-windows-service-applications.md
new file mode 100644
index 00000000000..4c03b449e03
--- /dev/null
+++ b/docs/framework/windows-services/introduction-to-windows-service-applications.md
@@ -0,0 +1,97 @@
+---
+title: "Windows サービス アプリケーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ServiceController"
+helpviewer_keywords: 
+  - "フレームワーク サービス, 作成 (サービスを)"
+  - "OnContinue メソッド"
+  - "OnPause メソッド"
+  - "OnStop メソッド"
+  - "Service クラス, Windows サービス アプリケーション"
+  - "サービスの状態"
+  - "ServiceController コンポーネント, Windows サービスの概要"
+  - "サービス, サービスの概要"
+  - "サービス, 有効期間"
+  - "サービス, 状態"
+  - "WaitForStatus メソッド"
+  - "Win32OwnProcess サービス型"
+  - "Win32ShareProcess サービス型"
+  - "Windows サービス アプリケーション, Windows サービス アプリケーションの概要"
+  - "Windows サービス アプリケーション, 配置"
+  - "Windows サービス アプリケーション, 有効期間"
+ms.assetid: 1b1b5e67-3ff3-40c0-8154-322cfd6ef0ae
+caps.latest.revision: 17
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 17
+---
+# Windows サービス アプリケーションの概要
+Microsoft Windows サービス \(旧 NT サービス\) を使用すると、Microsoft Windows サービス自体の Windows セッションで長時間にわたって実行されるアプリケーションを作成できます。  作成したサービスは、コンピューターのブート時に自動的に起動させることができます。また、サービスを一時停止したり、再起動したりすることもできます。このサービスはユーザー インターフェイスを表示しません。  このような特徴があるため、サービスはサーバー上で使用するのに適しており、コンピューターを共用する他のユーザーの邪魔をせずに長時間稼動させる機能を実現するのに最適です。  また、ログオン ユーザーや既定のコンピューター アカウントとは異なる、特定のユーザー アカウントのセキュリティ コンテキストでサービスを実行することもできます。  サービスと Windows セッションの詳細については、MSDN ライブラリの Windows SDK ドキュメントを参照してください。  
+  
+ サービスは、サービスとしてインストールするアプリケーションを作成することで簡単に作成できます。  たとえば、パフォーマンス カウンターのデータを監視し、しきい値を基準にした処理を行うとします。  この場合、パフォーマンス カウンターのデータを取得する Windows サービス アプリケーションを作成し配置して、データの収集と分析を行うことができます。  
+  
+ サービスは、Microsoft Visual Studio のプロジェクトとして作成します。サービスには、サービスに送信できるコマンドと、コマンド受信時に行うアクションとを制御するコードを定義します。  サービスに送信できるコマンドには、サービスの起動コマンド、一時停止コマンド、再開コマンド、および停止コマンドがあります。また、カスタム コマンドも実行できます。  
+  
+ アプリケーションを作成してビルドした後に、コマンド ライン ユーティリティの InstallUtil.exe を実行してサービスの実行可能ファイルのパスを指定することで、アプリケーションをインストールできます。  アプリケーションをインストールすると、**サービス コントロール マネージャー**を使用して、サービスを起動、停止、一時停止、再開、および設定できるようになります。  **サーバー エクスプローラー**の **\[サービス\]** ノード、または <xref:System.ServiceProcess.ServiceController> クラスを使用して、これらの作業を行うこともできます。  
+  
+## サービス アプリケーションと他の Visual Studio アプリケーション  
+ サービス アプリケーションの動作は、次に示すように、他のプロジェクトと異なります。  
+  
+-   サービス アプリケーション プロジェクトが作成するコンパイル済み実行可能ファイルは、プロジェクトの使用開始前にサーバーにインストールしておく必要があります。  F5 キーまたは F11 キーを押してサービス アプリケーションをデバッグまたは実行することはできません。サービスを即時に実行したり、サービスのコードにステップ インすることはできません。  サービスのインストールと起動を行ってから、デバッガーをサービスのプロセスにアタッチする必要があります。  詳細については、「[方法 : Windows サービス アプリケーションをデバッグする](../../../docs/framework/windows-services/how-to-debug-windows-service-applications.md)」を参照してください。  
+  
+-   一部のプロジェクトの場合とは異なり、サービス アプリケーションのインストール コンポーネントは必ず作成する必要があります。  インストール コンポーネントは、サーバーへのサービスのインストールと登録を行い、Windows **サービス コントロール マネージャー**でサービスのエントリを作成します。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+-   サービス アプリケーションの `Main` メソッドは、プロジェクトに含まれているサービスの Run コマンドを実行する必要があります。  `Run` メソッドによって、適切なサーバーの**サービス コントロール マネージャー**にサービスが読み込まれます。  **Windows サービス**のプロジェクト テンプレートを使用すると、このメソッドは自動的に作成されます。  サービスの読み込みとサービスの起動は異なります。  詳細については、後述の「サービスの有効期間」を参照してください。  
+  
+-   Windows サービス アプリケーションは、ログオン ユーザーの対話型ステーションとは異なるウィンドウ ステーションで実行されます。  ウィンドウ ステーションは、クリップボード、グローバルなアトムのセット、およびデスクトップ オブジェクトのグループを含む安全なオブジェクトです。  Windows サービスのステーションは対話型ステーションではないので、Windows サービス アプリケーションから出力されたダイアログ ボックスは表示されず、プログラムの応答が停止することがあります。  同様に、エラー メッセージもユーザー インターフェイスに出力されるのではなく、Windows イベント ログに記録されます。  
+  
+     .NET Framework でサポートされている Windows サービスのクラスは、対話型ステーション、つまりログオン ユーザーとの対話をサポートしていません。  また、.NET Framework には、ステーションおよびデスクトップを表すクラスが含まれていません。  Windows サービスが他のステーションと対話する必要がある場合は、アンマネージ Windows API にアクセスする必要があります。  詳細については、Windows SDK ドキュメントを参照してください。  
+  
+     Windows サービスとユーザーまたは他のステーションとの対話は、ログオン ユーザーがいない場合やユーザーが予期しないデスクトップ オブジェクトのセットを持っている場合などのシナリオにも対応できるように注意してデザインする必要があります。  場合によっては、ユーザーの制御下で実行される Windows アプリケーションを書いた方がより適切であることもあります。  
+  
+-   Windows サービス アプリケーションは、独自のセキュリティ コンテキストで実行され、Windows サービス アプリケーションがインストールされている Windows コンピューターにユーザーがログインする前に起動されます。  サービスを実行するユーザー アカウントは慎重に検討する必要があります。システム アカウントで実行されるサービスには、ユーザー アカウントで実行される場合より多くのアクセス許可とアクセス特権が認められます。  
+  
+## サービスの有効期間  
+ サービスの内部状態は、有効期間内でさまざまに変化します。  まず初めに、サービスを実行するシステムにインストールされます。  このプロセスでは、サービス プロジェクトのインストーラーが実行され、ターゲット コンピューターの**サービス コントロール マネージャー**にサービスが読み込まれます。  **サービス コントロール マネージャー**は、サービス管理の中核となる Windows 標準ユーティリティです。  
+  
+ サービスが読み込まれた後で、サービスを起動します。  サービスを起動すると、サービスが動作できるようになります。  サービスは、**サービス コントロール マネージャー**から起動することも、**サーバー エクスプローラー**から起動することも、コードから <xref:System.ServiceProcess.ServiceController.Start%2A> メソッドを呼び出して起動することもできます。  <xref:System.ServiceProcess.ServiceController.Start%2A> メソッドは、処理をアプリケーションの <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドに渡し、このメソッドに定義されている処理を実行します。  
+  
+ 実行中のサービスは、サービスの停止や一時停止が指示されたり、コンピューターがシャットダウンされるまで、実行中の状態を維持できます。  サービスの基本的な状態は、<xref:System.ServiceProcess.ServiceControllerStatus>、<xref:System.ServiceProcess.ServiceControllerStatus>、または <xref:System.ServiceProcess.ServiceControllerStatus> です。  サービスは保留中のコマンドの状態 \(<xref:System.ServiceProcess.ServiceControllerStatus>、<xref:System.ServiceProcess.ServiceControllerStatus>、<xref:System.ServiceProcess.ServiceControllerStatus>、または <xref:System.ServiceProcess.ServiceControllerStatus>\) も報告できます。  これらの状態は、実行中のサービスを一時停止するコマンドなどが実行されたが、まだ完了していない状態を表します。  <xref:System.ServiceProcess.ServiceController.Status%2A> を問い合わせるとサービスがどの状態にあるかを判別でき、<xref:System.ServiceProcess.ServiceController.WaitForStatus%2A> を使用するとこのいずれかの状態になったときに処理を実行できます。  
+  
+ サービスの一時停止、停止、および再開は、**サービス コントロール マネージャー**または**サーバー エクスプローラー**で実行できます。また、コードでメソッドを呼び出して実行することもできます。  これらのアクションは、サービスの中でそれぞれ対応するプロシージャ \(<xref:System.ServiceProcess.ServiceBase.OnStop%2A>、<xref:System.ServiceProcess.ServiceBase.OnPause%2A>、または <xref:System.ServiceProcess.ServiceBase.OnContinue%2A>\) を呼び出すことができます。これらのプロシージャには、サービスの状態が変化したときに実行する追加処理を定義できます。  
+  
+## サービスの種類  
+ Visual Studio で .NET Framework を使用して作成できるサービスには 2 種類あります。  プロセスを占有するサービスには、<xref:System.ServiceProcess.ServiceType> 型が割り当てられます。  他のサービスとプロセスを共有するサービスには、<xref:System.ServiceProcess.ServiceType> 型が割り当てられます。  サービスの種類は、<xref:System.ServiceProcess.ServiceController.ServiceType%2A> プロパティを問い合わせて取得できます。  
+  
+ Visual Studio 以外で作成された既存のサービスを問い合わせた場合は、これ以外のサービスの種類が割り当てられていることもあります。  それらの詳細については、「<xref:System.ServiceProcess.ServiceType>」を参照してください。  
+  
+## サービスと ServiceController コンポーネント  
+ <xref:System.ServiceProcess.ServiceController> コンポーネントは、インストール済みのサービスに接続し、サービスの状態を操作するときに使用します。<xref:System.ServiceProcess.ServiceController> コンポーネントを使用すると、サービスの起動と停止、およびサービスの一時停止と継続を実行できます。また、カスタム コマンドをサービスに送信することもできます。  ただし、サービス アプリケーションを作成する場合は、<xref:System.ServiceProcess.ServiceController> コンポーネントを使用する必要はありません。  ほとんどの場合は、サービスを定義している Windows サービス アプリケーションとは別のアプリケーションに <xref:System.ServiceProcess.ServiceController> コンポーネントが含まれています。  
+  
+ 詳細については、「<xref:System.ServiceProcess.ServiceController>」を参照してください。  
+  
+## 要件  
+  
+-   サービスは、**Windows サービス** アプリケーション プロジェクトなどの .NET Framework 対応プロジェクト内で作成する必要があります。.NET Framework 対応プロジェクトは、ビルド時に .exe ファイルを作成し、<xref:System.ServiceProcess.ServiceBase> クラスから継承を行います。  
+  
+-   Windows サービスを含むプロジェクトには、プロジェクトのインストール コンポーネントと、プロジェクトのサービスのインストール コンポーネントが必要です。  これは **\[プロパティ\]** ウィンドウで簡単に設定できます。  詳細については、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」を参照してください。  
+  
+## 参照  
+ [Windows Service Applications](../../../docs/framework/windows-services/index.md)   
+ [サービス アプリケーションのプログラミング アーキテクチャ](../../../docs/framework/windows-services/service-application-programming-architecture.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)   
+ [方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)   
+ [方法 : サービスを開始する](../../../docs/framework/windows-services/how-to-start-services.md)   
+ [方法 : Windows サービス アプリケーションをデバッグする](../../../docs/framework/windows-services/how-to-debug-windows-service-applications.md)   
+ [チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成](../../../docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md)   
+ [方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/media/windowsservice-installerproperties.PNG b/docs/framework/windows-services/media/windowsservice-installerproperties.PNG
new file mode 100644
index 00000000000..7e6066ebad5
Binary files /dev/null and b/docs/framework/windows-services/media/windowsservice-installerproperties.PNG differ
diff --git a/docs/framework/windows-services/media/windowsservices-eventviewer.PNG b/docs/framework/windows-services/media/windowsservices-eventviewer.PNG
new file mode 100644
index 00000000000..b4db8122f62
Binary files /dev/null and b/docs/framework/windows-services/media/windowsservices-eventviewer.PNG differ
diff --git a/docs/framework/windows-services/media/windowsservices-serviceswindow.PNG b/docs/framework/windows-services/media/windowsservices-serviceswindow.PNG
new file mode 100644
index 00000000000..110ffa862b1
Binary files /dev/null and b/docs/framework/windows-services/media/windowsservices-serviceswindow.PNG differ
diff --git a/docs/framework/windows-services/service-application-programming-architecture.md b/docs/framework/windows-services/service-application-programming-architecture.md
new file mode 100644
index 00000000000..5e338415914
--- /dev/null
+++ b/docs/framework/windows-services/service-application-programming-architecture.md
@@ -0,0 +1,74 @@
+---
+title: "サービス アプリケーションのプログラミング アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ServiceBase クラス, サービスの状態"
+  - "ServiceController クラス"
+  - "ServiceController コンポーネント, プログラミング アーキテクチャ"
+  - "ServiceProcessInstaller クラス, サービス アプリケーションのコード モデル"
+  - "サービス, プログラミング アーキテクチャ"
+  - "サービス, 状態"
+  - "Windows サービス アプリケーション, コード モデル"
+  - "Windows サービス アプリケーション, 状態"
+ms.assetid: 83230026-d068-4174-97ff-e264c896eb2f
+caps.latest.revision: 15
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 15
+---
+# サービス アプリケーションのプログラミング アーキテクチャ
+Windows サービス アプリケーションは、<xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> クラスから継承するクラスに基づいています。  このクラスからメソッドをオーバーライドし、機能を定義してサービスの動作を決定します。  
+  
+ サービスの作成には、主に次のクラスを使用します。  
+  
+-   <xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> クラス。サービス作成時に <xref:System.ServiceProcess.ServiceBase> クラスのメソッドをオーバーライドし、サービスの機能をこの継承クラスに定義します。  
+  
+-   <xref:System.ServiceProcess.ServiceProcessInstaller?displayProperty=fullName> クラスおよび <xref:System.ServiceProcess.ServiceInstaller?displayProperty=fullName> クラス。サービスのインストールとアンインストールを行うときに使用します。  
+  
+ また、<xref:System.ServiceProcess.ServiceController> クラスを使用してサービス自体を操作することもできます。  このクラスはサービスの作成には使用しませんが、サービスの起動や停止を行うとき、サービスにコマンドを渡すとき、およびサービス一覧の取得を行うときに使用できます。  
+  
+## サービスの動作定義  
+ サービス制御マネージャーでサービスの状態が変更されたときの動作は、基本クラスの関数によって定義されていますが、サービス クラスでは基本クラスの関数をオーバーライドして使用します。  <xref:System.ServiceProcess.ServiceBase> クラスには次のメソッドがあり、このメソッドをオーバーライドして独自の動作を追加できます。  
+  
+|メソッド|オーバーライドの目的|  
+|----------|----------------|  
+|<xref:System.ServiceProcess.ServiceBase.OnStart%2A>|サービスの実行を開始したときのアクションを示します。  サービス本来の処理は、このプロシージャに記述する必要があります。|  
+|<xref:System.ServiceProcess.ServiceBase.OnPause%2A>|サービスを一時停止したときの動作を示します。|  
+|<xref:System.ServiceProcess.ServiceBase.OnStop%2A>|サービスの実行を停止したときの動作を示します。|  
+|<xref:System.ServiceProcess.ServiceBase.OnContinue%2A>|一時停止したサービスを再開したときの動作を示します。|  
+|<xref:System.ServiceProcess.ServiceBase.OnShutdown%2A>|実行中のサービスの、システムがシャットダウンする直前の動作を示します。|  
+|<xref:System.ServiceProcess.ServiceBase.OnCustomCommand%2A>|サービスがカスタム コマンドを受信したときの動作を示します。  カスタム コマンドの詳細については、MSDN オンラインを参照してください。|  
+|<xref:System.ServiceProcess.ServiceBase.OnPowerEvent%2A>|低電力モードやサスペンド モードなど、電源管理イベントを受信したときのサービスの応答を示します。|  
+  
+> [!NOTE]
+>  上記のメソッドは、有効期間内に順次に移り変わるサービスの状態を表しています。  たとえば、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> が呼び出されていない状態では、サービスは <xref:System.ServiceProcess.ServiceBase.OnContinue%2A> コマンドに応答できません。  
+  
+ 上記以外にも関連するプロパティおよびメソッドがあります。  以下に例を示します。  
+  
+-   <xref:System.ServiceProcess.ServiceBase> クラスの <xref:System.ServiceProcess.ServiceBase.Run%2A> メソッド。  サービスのメイン エントリ ポイントです。  Windows サービスのテンプレートを使用してサービスを作成した場合は、アプリケーションの `Main` メソッドにサービスを実行するコードを挿入します。  コード例を次に示します。  
+  
+     [!code-csharp[VbRadconService#6](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#6)]
+     [!code-vb[VbRadconService#6](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#6)]  
+  
+    > [!NOTE]
+    >  上記の例では、<xref:System.ServiceProcess.ServiceBase> 型の配列を使用しています。アプリケーションに含まれる各サービスをこの配列に追加して、すべてのサービスを同時に実行できます。  ただし、サービスを 1 つだけ作成する場合は、配列を使用せず、<xref:System.ServiceProcess.ServiceBase> から継承する新しいオブジェクトを宣言して実行することもできます。  例については、「[方法 : プログラムでサービスを作成する](../../../docs/framework/windows-services/how-to-write-services-programmatically.md)」を参照してください。  
+  
+-   <xref:System.ServiceProcess.ServiceBase> クラスの各プロパティ。  サービスに対して呼び出すことができるメソッドを決定します。  たとえば、<xref:System.ServiceProcess.ServiceBase.CanStop%2A> プロパティに `true` が設定されている場合は、サービスの <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドを呼び出すことができます。  <xref:System.ServiceProcess.ServiceBase.CanPauseAndContinue%2A> プロパティに `true` が設定されている場合は、<xref:System.ServiceProcess.ServiceBase.OnPause%2A> メソッドと <xref:System.ServiceProcess.ServiceBase.OnContinue%2A> メソッドを呼び出すことができます。  これらのいずれかのプロパティに `true` を設定する場合は、該当するメソッドの処理のオーバーライドと定義を行う必要があります。  
+  
+    > [!NOTE]
+    >  サービスが有用であるためには、少なくとも <xref:System.ServiceProcess.ServiceBase.OnStart%2A> と <xref:System.ServiceProcess.ServiceBase.OnStop%2A> をオーバーライドする必要があります。  
+  
+ <xref:System.ServiceProcess.ServiceController> コンポーネントを使用して、既存のサービスと通信したり、既存のサービスの動作を制御したりできます。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : Windows サービスを作成する](../../../docs/framework/windows-services/how-to-create-windows-services.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/troubleshooting-debugging-windows-services.md b/docs/framework/windows-services/troubleshooting-debugging-windows-services.md
new file mode 100644
index 00000000000..58f379cb6ec
--- /dev/null
+++ b/docs/framework/windows-services/troubleshooting-debugging-windows-services.md
@@ -0,0 +1,35 @@
+---
+title: "Windows サービスをデバッグする場合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デバッグ [Visual Studio], Windows サービス"
+  - "デバッグ (Windows サービス アプリケーションの)"
+  - "サービス, デバッグ"
+  - "サービス, トラブルシューティング"
+  - "トラブルシューティング (デバッグ), Windows サービス"
+  - "トラブルシューティング (サービス アプリケーション)"
+  - "Windows サービス アプリケーション, デバッグ"
+  - "Windows サービス アプリケーション, トラブルシューティング"
+ms.assetid: cf859d4c-f04c-4cb7-81e3-bc7de8bea190
+caps.latest.revision: 8
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 8
+---
+# Windows サービスをデバッグする場合
+Windows サービス アプリケーションをデバッグするときには、サービスと **Windows サービス マネージャー**が対話します。  **サービス マネージャー**は、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドを呼び出してサービスを起動し、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドがリターンするのを 30 秒間待ちます。  この時間内にメソッドがリターンしない場合、マネージャーはサービス起動エラーを表示します。  
+  
+ 「[方法 : Windows サービス アプリケーションをデバッグする](../../../docs/framework/windows-services/how-to-debug-windows-service-applications.md)」で説明しているように、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドをデバッグするときには、この 30 秒のタイム リミットに注意してください。  <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドにブレークポイントを設定し、30 秒以内にそこを通過しなかった場合、マネージャーはサービスを起動しません。  
+  
+## 参照  
+ [方法 : Windows サービス アプリケーションをデバッグする](../../../docs/framework/windows-services/how-to-debug-windows-service-applications.md)   
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/troubleshooting-service-application-wont-install.md b/docs/framework/windows-services/troubleshooting-service-application-wont-install.md
new file mode 100644
index 00000000000..fb58b18f2fe
--- /dev/null
+++ b/docs/framework/windows-services/troubleshooting-service-application-wont-install.md
@@ -0,0 +1,35 @@
+---
+title: "サービス アプリケーションをインストールできない場合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サービス, デバッグ"
+  - "サービス, トラブルシューティング"
+  - "トラブルシューティング (NT サービス)"
+  - "トラブルシューティング (サービス アプリケーション)"
+  - "Windows NT サービス, トラブルシューティング"
+  - "Windows サービス アプリケーション, トラブルシューティング"
+ms.assetid: 45c48e2e-b97d-44bc-8896-14f328e0ce33
+caps.latest.revision: 8
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 8
+---
+# サービス アプリケーションをインストールできない場合
+サービス アプリケーションが正しくインストールされない場合は、サービス クラスの <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> プロパティに、そのサービスのインストーラーに表示される値と同じ値が設定されているかどうかを確認します。  サービスを正しくインストールするには、これらの両方に同じ値を設定する必要があります。  
+  
+> [!NOTE]
+>  インストール ログでインストール プロセスの情報を参照することもできます。  
+  
+ 同名のサービスが既にインストールされているかどうかを調べる必要もあります。  サービスをインストールするには、サービス名が一意であることが必要です。  
+  
+## 参照  
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)
\ No newline at end of file
diff --git a/docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md b/docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md
new file mode 100644
index 00000000000..6233b4ae6bd
--- /dev/null
+++ b/docs/framework/windows-services/walkthrough-creating-a-windows-service-application-in-the-component-designer.md
@@ -0,0 +1,433 @@
+---
+title: "チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Windows サービス アプリケーション, 作成"
+  - "Windows サービス アプリケーション, チュートリアル"
+ms.assetid: e24d8a3d-edc6-485c-b6e0-5672d91fb607
+caps.latest.revision: 57
+author: "ghogen"
+ms.author: "ghogen"
+manager: "douge"
+caps.handback.revision: 55
+---
+# チュートリアル: コンポーネント デザイナーによる Windows サービス アプリケーションの作成
+この記事では、イベント ログにメッセージを書き込む単純な Windows サービス アプリケーションを Visual Studio で作成する方法を示します。 サービスを作成して使用するために実行する基本的な手順は次のとおりです。  
+  
+1.  **Windows Service** プロジェクト テンプレートを使用して[サービスの作成](#BK_CreateProject)を行い、構成します。 このテンプレートは、<xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> を継承するクラスを作成し、基本的なサービス コードの多く \(サービスを開始するコードなど\) を記述します。  
+  
+2.  <xref:System.ServiceProcess.ServiceBase.OnStart%2A> プロシージャと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> プロシージャの[サービスへの機能追加](#BK_WriteCode)を行い、再定義する他のすべてのメソッドを上書きします。  
+  
+3.  [サービスの状態の設定](#BK_SetStatus)。 既定では、<xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> で作成されたサービスは、利用可能な状態フラグのサブセットだけを実装します。 サービスの開始、一時停止、または停止に時間がかかる場合は、\[保留の開始\] または \[保留の停止\] などの状態値を実装し、操作の実行中であることを示すことができます。  
+  
+4.  サービス アプリケーションの[サービスへのインストーラーの追加](#BK_AddInstallers)を行います。  
+  
+5.  \(省略可能\) [スタートアップ パラメーターの設定](#BK_StartupParameters)を行い、既定の起動時の引数を指定して、ユーザーがサービスを手動で開始するときに既定の設定を上書きできるようにします。  
+  
+6.  [サービスの構築](#BK_Build)。  
+  
+7.  ローカル コンピューターへの[サービスのインストール](#BK_Install)を行います。  
+  
+8.  Windows サービス コントロール マネージャーにアクセスし、[サービスの開始および実行](#BK_StartService)を行います。  
+  
+9. [Windows サービスのアンインストール](#BK_Uninstall)。  
+  
+> [!WARNING]
+>  このチュートリアルで必要な Windows サービスのプロジェクト テンプレートは、Visual Studio Express Edition では使用できません。  
+  
+ [!INCLUDE[note_settings_general](../../../includes/note-settings-general-md.md)]  
+  
+<a name="BK_CreateProject"></a>   
+## サービスの作成  
+ 最初に、プロジェクトを作成し、サービスが正しく機能するために必要な値を設定します。  
+  
+#### サービスを作成して設定するには  
+  
+1.  Visual Studio のメニュー バーで、**\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。  
+  
+     **\[新しいプロジェクト\]** ダイアログ ボックスが表示されます。  
+  
+2.  Visual Basic や Visual C\# のプロジェクト テンプレートの一覧で、**Windows サービス**を選択し、プロジェクトに「**MyNewService**」という名前を付けます。**\[OK\]** をクリックします。  
+  
+     プロジェクト テンプレートは、`Service1` を継承する <xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> という名前のコンポーネント クラスを自動的に追加します。  
+  
+3.  **\[編集\]** メニューで、**\[検索と置換\]**、**\[フォルダーを指定して検索\]** の順にクリックします \(キーボード: Ctrl \+ Shift \+ F\)。 出現するすべての `Service1` を `MyNewService` に変更します。 Service1.cs、Program.cs、および Service1.Designer.cs \(または対応する .vb\) にインスタンスがあります。  
+  
+4.  **Service1.cs \[Design\]** や **Service1.vb \[Design\]** の **\[プロパティ\]** ウィンドウで、`Service1` の <xref:System.ServiceProcess.ServiceBase.ServiceName%2A> と **\(Name\)** プロパティが **MyNewService** に設定されていない場合は設定します。  
+  
+5.  ソリューション エクスプローラーで、**Service1.cs** を **MyNewService.cs** に、または **Service1.vb** を **MyNewService.vb** に変更します。  
+  
+<a name="BK_WriteCode"></a>   
+## サービスへの機能追加  
+ このセクションでは、Windows サービスにカスタム イベント ログを追加します。 イベント ログは、Windows サービスとまったく関連付けられていません。 ここでは、Windows サービスに追加できるコンポーネントの種類の例として、<xref:System.Diagnostics.EventLog> コンポーネントを使用しています。  
+  
+#### サービスにカスタム イベント ログ機能を追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**MyNewService.cs** または **MyNewService.vb** のコンテキスト メニューを開き、**\[デザイナーの表示\]** を選択します。  
+  
+2.  **\[ツールボックス\]** の **\[コンポーネント\]** セクションから、<xref:System.Diagnostics.EventLog> コンポーネントをデザイナーにドラッグします。  
+  
+3.  **ソリューション エクスプローラー**で、**MyNewService.cs** または **MyNewService.vb** のコンテキスト メニューを開き、**\[コードの表示\]** を選択します。  
+  
+4.  `MyNewService` クラスの、`components` 変数を宣言している行の直後に、**eventLog** オブジェクトの宣言を追加します。  
+  
+     [!code-csharp[VbRadconService#16](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#16)]
+     [!code-vb[VbRadconService#16](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#16)]  
+  
+5.  コンストラクターを追加または編集して、カスタム イベント ログを定義します。  
+  
+     [!code-csharp[VbRadconService#2](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#2)]
+     [!code-vb[VbRadconService#2](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#2)]  
+  
+#### サービスの開始時の処理を定義するには  
+  
+-   コード エディターで、プロジェクトの作成時に自動的にオーバーライドされた <xref:System.ServiceProcess.ServiceBase.OnStart%2A> を見つけ、次のコードに置き換えます。 これにより、サービスが実行を開始するときに、イベント ログにエントリが追加されます。  
+  
+     [!code-csharp[VbRadconService#3](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#3)]
+     [!code-vb[VbRadconService#3](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#3)]  
+  
+     サービス アプリケーションは長期間実行するように設計されているため、通常は、システム内の何かをポーリングまたは監視しています。 この監視は、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドで設定します。 ただし、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> は実際には監視を行いません。<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドは、サービスの操作が開始された後にオペレーティング システムに戻る必要があります。 永久的に続くループやブロックは実行できません。 単純なポーリング機構を設定するには、<xref:System.Timers.Timer?displayProperty=fullName> コンポーネントを次のように使用します。<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドで、コンポーネントのパラメーターを設定してから、<xref:System.Timers.Timer.Enabled%2A> プロパティを `true` に設定します。 このタイマーによって、コード内で定期的にイベントが発生します。サービスは、イベントが発生するごとに監視を実行できます。 このためには、次のコードを使用できます。  
+  
+    ```csharp  
+    // Set up a timer to trigger every minute.  
+    System.Timers.Timer timer = new System.Timers.Timer();  
+    timer.Interval = 60000; // 60 seconds  
+    timer.Elapsed += new System.Timers.ElapsedEventHandler(this.OnTimer);  
+    timer.Start();  
+    ```  
+  
+    ```vb  
+    ' Set up a timer to trigger every minute.  
+    Dim timer As System.Timers.Timer = New System.Timers.Timer()  
+    timer.Interval = 60000 ' 60 seconds  
+    AddHandler timer.Elapsed, AddressOf Me.OnTimer  
+    timer.Start()  
+    ```  
+  
+     タイマー イベントを処理するコードを追加します。  
+  
+    ```csharp  
+    public void OnTimer(object sender, System.Timers.ElapsedEventArgs args)  
+    {  
+        // TODO: Insert monitoring activities here.  
+        eventLog1.WriteEntry("Monitoring the System", EventLogEntryType.Information, eventId++);  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub OnTimer(sender As Object, e As Timers.ElapsedEventArgs)  
+        ' TODO: Insert monitoring activities here.  
+        eventLog1.WriteEntry("Monitoring the System", EventLogEntryType.Information, eventId)  
+        eventId = eventId + 1  
+    End Sub  
+    ```  
+  
+     メイン スレッドですべての作業を実行するのではなく、バックグラウンド ワーカー スレッドを使用してタスクを実行する場合があります。 例については、<xref:System.ServiceProcess.ServiceBase?displayProperty=fullName> のリファレンス ページを参照してください。  
+  
+#### サービスの停止時の処理を定義するには  
+  
+-   <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドのコードを次のコードに置き換えます。 これにより、サービスが停止したときに、イベント ログにエントリが追加されます。  
+  
+     [!code-csharp[VbRadconService#4](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#4)]
+     [!code-vb[VbRadconService#4](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#4)]  
+  
+ 次のセクションでは、<xref:System.ServiceProcess.ServiceBase.OnPause%2A>、<xref:System.ServiceProcess.ServiceBase.OnContinue%2A>、および <xref:System.ServiceProcess.ServiceBase.OnShutdown%2A> の各メソッドをオーバーライドして、コンポーネントの追加の処理を定義できます。  
+  
+#### サービスに対して他の処理を定義するには  
+  
+-   処理するメソッドを見つけ、オーバーライドし、実行する処理を定義します。  
+  
+     次のコード例は、<xref:System.ServiceProcess.ServiceBase.OnContinue%2A> メソッドをオーバーライドする方法を示しています。  
+  
+     [!code-csharp[VbRadconService#5](../../../samples/snippets/csharp/VS_Snippets_VBCSharp/VbRadconService/CS/MyNewService.cs#5)]
+     [!code-vb[VbRadconService#5](../../../samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbRadconService/VB/MyNewService.vb#5)]  
+  
+ いくつかのカスタム動作は、Windows サービスが <xref:System.Configuration.Install.Installer> クラスによりインストールされるときに発生する必要があります。 Visual Studio は、これらのインストーラーを Windows サービス専用に作成し、プロジェクトに追加できます。  
+  
+<a name="BK_SetStatus"></a>   
+## サービスの状態の設定  
+ サービスは、その状態をサービス コントロール マネージャーに報告します。これによりユーザーは、サービスが正常に機能しているかどうかを確認することができます。 既定では、<xref:System.ServiceProcess.ServiceBase> を継承するサービスは、\[停止\]、\[一時停止\]、\[実行中\] など、限られた状態設定のセットを報告します。 サービスの開始に若干時間がかかるときは、\[保留の開始\] 状態を報告すると役立つ場合があります。 \[保留の開始\] と \[保留の停止\] の状態設定は、Windows の [SetServiceStatus 関数](http://msdn.microsoft.com/library/windows/desktop/ms686241.aspx)を呼び出すコードを追加することによって実装することもできます。  
+  
+#### サービス保留の状態を実装するには  
+  
+1.  MyNewService.cs ファイルや MyNewService.vb ファイルの <xref:System.Runtime.InteropServices?displayProperty=fullName> 名前空間に `using` ステートメントや `Imports` 宣言を追加します。  
+  
+    ```csharp  
+    using System.Runtime.InteropServices;  
+    ```  
+  
+    ```vb  
+    Imports System.Runtime.InteropServices  
+    ```  
+  
+2.  MyNewService.cs に次のコードを追加して、`ServiceState` の値を宣言し、プラットフォーム呼び出しで使用する状態の構造を追加します。  
+  
+    ```csharp  
+    public enum ServiceState  
+      {  
+          SERVICE_STOPPED = 0x00000001,  
+          SERVICE_START_PENDING = 0x00000002,  
+          SERVICE_STOP_PENDING = 0x00000003,  
+          SERVICE_RUNNING = 0x00000004,  
+          SERVICE_CONTINUE_PENDING = 0x00000005,  
+          SERVICE_PAUSE_PENDING = 0x00000006,  
+          SERVICE_PAUSED = 0x00000007,  
+      }  
+  
+      [StructLayout(LayoutKind.Sequential)]  
+      public struct ServiceStatus  
+      {  
+          public long dwServiceType;  
+          public ServiceState dwCurrentState;  
+          public long dwControlsAccepted;  
+          public long dwWin32ExitCode;  
+          public long dwServiceSpecificExitCode;  
+          public long dwCheckPoint;  
+          public long dwWaitHint;  
+      };  
+    ```  
+  
+    ```vb  
+    Public Enum ServiceState  
+        SERVICE_STOPPED = 1  
+        SERVICE_START_PENDING = 2  
+        SERVICE_STOP_PENDING = 3  
+        SERVICE_RUNNING = 4  
+        SERVICE_CONTINUE_PENDING = 5  
+        SERVICE_PAUSE_PENDING = 6  
+        SERVICE_PAUSED = 7  
+    End Enum  
+  
+    <StructLayout(LayoutKind.Sequential)>  
+    Public Structure ServiceStatus  
+        Public dwServiceType As Long  
+        Public dwCurrentState As ServiceState  
+        Public dwControlsAccepted As Long  
+        Public dwWin32ExitCode As Long  
+        Public dwServiceSpecificExitCode As Long  
+        Public dwCheckPoint As Long  
+        Public dwWaitHint As Long  
+    End Structure  
+    ```  
+  
+3.  `MyNewService` クラスで、プラットフォーム呼び出しを使用して、[SetServiceStatus 関数](http://msdn.microsoft.com/library/windows/desktop/ms686241.aspx)を宣言します。  
+  
+    ```csharp  
+    [DllImport("advapi32.dll", SetLastError=true)]  
+            private static extern bool SetServiceStatus(IntPtr handle, ref ServiceStatus serviceStatus);  
+  
+    ```  
+  
+    ```vb  
+    Declare Auto Function SetServiceStatus Lib "advapi32.dll" (ByVal handle As IntPtr, ByRef serviceStatus As ServiceStatus) As Boolean  
+    ```  
+  
+4.  \[保留の開始\] 状態を実装するには、<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドの先頭に次のコードを追加します。  
+  
+    ```csharp  
+    // Update the service state to Start Pending.  
+    ServiceStatus serviceStatus = new ServiceStatus();  
+    serviceStatus.dwCurrentState = ServiceState.SERVICE_START_PENDING;  
+    serviceStatus.dwWaitHint = 100000;  
+    SetServiceStatus(this.ServiceHandle, ref serviceStatus);  
+    ```  
+  
+    ```vb  
+    ' Update the service state to Start Pending.  
+    Dim serviceStatus As ServiceStatus = New ServiceStatus()  
+    serviceStatus.dwCurrentState = ServiceState.SERVICE_START_PENDING  
+    serviceStatus.dwWaitHint = 100000  
+    SetServiceStatus(Me.ServiceHandle, serviceStatus)  
+    ```  
+  
+5.  <xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドの末尾に、状態を \[実行中\] に設定するコードを追加します。  
+  
+    ```  
+    // Update the service state to Running.  
+    serviceStatus.dwCurrentState = ServiceState.SERVICE_RUNNING;  
+    SetServiceStatus(this.ServiceHandle, ref serviceStatus);  
+    ```  
+  
+    ```vb  
+    ' Update the service state to Running.  
+    serviceStatus.dwCurrentState = ServiceState.SERVICE_RUNNING  
+    SetServiceStatus(Me.ServiceHandle, serviceStatus)  
+    ```  
+  
+6.  \(省略可能\) <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドに対してこの手順を繰り返します。  
+  
+> [!CAUTION]
+>  [サービス コントロール マネージャー](http://msdn.microsoft.com/library/windows/desktop/ms685150.aspx)は、[SERVICE\_STATUS 構造](http://msdn.microsoft.com/library/windows/desktop/ms685996.aspx)の `dwWaitHint` メンバーと `dwCheckpoint` メンバーを使用して、Windows サービスの開始やシャットダウンまでの待機時間を判断します。<xref:System.ServiceProcess.ServiceBase.OnStart%2A> メソッドと <xref:System.ServiceProcess.ServiceBase.OnStop%2A> メソッドが長時間実行している場合、サービスは、インクリメントした `dwCheckPoint` 値で [SetServiceStatus](http://msdn.microsoft.com/library/windows/desktop/ms686241.aspx) をもう一度呼び出すことによって、追加の時間を要求できます。  
+  
+<a name="BK_AddInstallers"></a>   
+## サービスへのインストーラーの追加  
+ Windows サービスを実行するには、まず、サービスをインストールする必要があります。これにより、サービスがサービス コントロール マネージャーに登録されます。 登録の詳細を処理するインストーラーをプロジェクトに追加できます。  
+  
+#### サービスのインストーラーを作成するには  
+  
+1.  **ソリューション エクスプローラー**で、**MyNewService.cs** または **MyNewService.vb** のコンテキスト メニューを開き、**\[デザイナーの表示\]** を選択します。  
+  
+2.  デザイナーの背景をクリックして、サービスの内容ではなくサービス自体を選択します。  
+  
+3.  デザイナー ウィンドウのコンテキスト メニューを開き \(ポインティング デバイスを使用している場合は、ウィンドウ内を右クリック\)、**\[インストーラーの追加\]** を選択します。  
+  
+     既定では、2 つのインストーラーを含むコンポーネント クラスがプロジェクトに追加されます。 このコンポーネントは **ProjectInstaller** という名前で、サービス用のインストーラーと、サービスの関連プロセス用のインストーラーを含んでいます。  
+  
+4.  **\[ProjectInstaller\]** の **\[デザイン\]** ビューで、**\[serviceInstaller1\]** \(Visual C\# プロジェクトの場合\) または **\[ServiceInstaller1\]** \(Visual Basic プロジェクトの場合\) を選択します。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.ServiceProcess.ServiceInstaller.ServiceName%2A> プロパティが **MyNewService** に設定されていることを確認します。  
+  
+6.  **\[説明\]** プロパティに、「A sample service」などのテキストを設定します。 このテキストは \[サービス\] ウィンドウに表示されます。これによりユーザーは、サービスを識別したり、その用途を理解したりできます。  
+  
+7.  <xref:System.ServiceProcess.ServiceInstaller.DisplayName%2A> プロパティに、\[サービス\] ウィンドウの **\[名前\]** 列に表示するテキストを設定します。 たとえば、「MyNewService Display Name」と入力できます。 この名前は、システムによって使用される \(たとえば、<xref:System.ServiceProcess.ServiceInstaller.ServiceName%2A> コマンドを使用してサービスを開始する場合\) 名前である `net start` プロパティとは異なる名前にすることができます。  
+  
+8.  <xref:System.ServiceProcess.ServiceInstaller.StartType%2A> プロパティを <xref:System.ServiceProcess.ServiceStartMode> に設定します。  
+  
+     ![Windows サービスのインストーラー プロパティ](../../../docs/framework/windows-services/media/windowsservice-installerproperties.PNG "WindowsService\_InstallerProperties")  
+  
+9. デザイナーで、**\[serviceProcessInstaller1\]** \(Visual C\# プロジェクトの場合\) または **\[ServiceProcessInstaller1\]** \(Visual Basic プロジェクトの場合\) を選択します。<xref:System.ServiceProcess.ServiceProcessInstaller.Account%2A> プロパティを <xref:System.ServiceProcess.ServiceAccount> に設定します。 これにより、サービスがインストールされ、ローカル サービス アカウントで実行されます。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.ServiceProcess.ServiceAccount> アカウントには、イベント ログへの書き込みを含む、幅広いアクセス許可が設定されています。 このアカウントは悪意のあるソフトウェアから攻撃されるリスクが高いため、使用する場合は注意が必要です。 その他のタスクについては、ローカル コンピューターで非特権ユーザーとして機能し、リモート サーバーには匿名の資格情報を渡す <xref:System.ServiceProcess.ServiceAccount> アカウントの使用を検討してください。 この例は、<xref:System.ServiceProcess.ServiceAccount> アカウントを使用しようとすると失敗します。これは、イベント ログに書き込むアクセス許可が必要になるためです。  
+  
+     インストーラーについて詳しくは、「[方法 : サービス アプリケーションにインストーラーを追加する](../../../docs/framework/windows-services/how-to-add-installers-to-your-service-application.md)」をご覧ください。  
+  
+<a name="BK_StartupParameters"></a>   
+## スタートアップ パラメーターの設定  
+ Windows サービスは、その他の実行可能ファイルと同様、コマンド ライン引数、またはスタートアップ パラメーターを受け入れることができます。 スタートアップ パラメーターを処理するコードを追加すると、ユーザーは、Windows のコントロール パネルの \[サービス\] ウィンドウを使用して、カスタムのスタートアップ パラメーターによりサービスを開始できます。 ただし、これらのスタートアップ パラメーターは、次回のサービスの開始時には保持されません。 スタートアップ パラメーターを永続的に設定するために、次の手順で示すようにレジストリに設定することができます。  
+  
+> [!NOTE]
+>  スタートアップ パラメーターを追加するよう決定する前に、これがサービスに情報を渡す最適な方法であるかどうかを検討してください。 スタートアップ パラメーターの使用や解析は簡単であり、ユーザーが簡単にオーバーライドできますが、ドキュメントなしでは検索や使用が困難である可能性があります。 一般的に、サービスに必要なスタートアップ パラメーターが複数ある場合は、代わりにレジストリまたは構成ファイルの使用を検討する必要があります。 すべての Windows サービスのレジストリのエントリは、HKLM\\System\\CurrentControlSet\\services にあります。 サービスのキーで、**Parameters** サブキーを使用して、サービスがアクセスできる情報を格納することができます。 その他の種類のプログラムの場合と同じ方法で、Windows サービスに対してアプリケーション構成ファイルを使用することができます。 コード例については、「<xref:System.Configuration.ConfigurationManager.AppSettings%2A>」を参照してください。  
+  
+#### スタートアップ パラメーターの追加  
+  
+1.  Program.cs または MyNewService.Designer.vb の `Main` メソッドに、コマンド ラインの引数を追加します。  
+  
+    ```csharp  
+    static void Main(string[] args)        {            ServiceBase[] ServicesToRun;            ServicesToRun = new ServiceBase[]             {                 new MyNewService(args)             };            ServiceBase.Run(ServicesToRun);        }  
+    ```  
+  
+    ```vb  
+    Shared Sub Main(ByVal cmdArgs() As String)        Dim ServicesToRun() As System.ServiceProcess.ServiceBase        ServicesToRun = New System.ServiceProcess.ServiceBase() {New MyNewServiceVB(cmdArgs)}        System.ServiceProcess.ServiceBase.Run(ServicesToRun)    End Sub  
+    ```  
+  
+2.  `MyNewService` コンストラクターを次のように変更します。  
+  
+    ```csharp  
+    public MyNewService(string[] args)        {            InitializeComponent();            string eventSourceName = "MySource";            string logName = "MyNewLog";            if (args.Count() > 0)            {                eventSourceName = args[0];            }            if (args.Count() > 1)            {                logName = args[1];            }            eventLog1 = new System.Diagnostics.EventLog();            if (!System.Diagnostics.EventLog.SourceExists(eventSourceName))            {                System.Diagnostics.EventLog.CreateEventSource(                    eventSourceName, logName);            }            eventLog1.Source = eventSourceName;            eventLog1.Log = logName;        }  
+    ```  
+  
+    ```vb  
+    Public Sub New(ByVal cmdArgs() As String)        InitializeComponent()        Dim eventSourceName As String = "MySource"        Dim logName As String = "MyNewLog"        If (cmdArgs.Count() > 0) Then            eventSourceName = cmdArgs(0)        End If        If (cmdArgs.Count() > 1) Then            logName = cmdArgs(1)        End If        eventLog1 = New System.Diagnostics.EventLog()        If (Not System.Diagnostics.EventLog.SourceExists(eventSourceName)) Then            System.Diagnostics.EventLog.CreateEventSource(                eventSourceName, logName)        End If        eventLog1.Source = eventSourceName        eventLog1.Log = logName    End Sub  
+    ```  
+  
+     このコードでは、指定したスタートアップ パラメーターに従ってイベント ソースとログ名が設定されるか、引数を指定しなかった場合は既定値が使用されます。  
+  
+3.  コマンド ライン引数を指定するには、ProjectInstaller.cs または ProjectInstaller.vb の `ProjectInstaller` クラスに次のコードを追加します。  
+  
+    ```csharp  
+    protected override void OnBeforeInstall(IDictionary savedState)        {            string parameter = "MySource1\" \"MyLogFile1";            Context.Parameters["assemblypath"] = "\"" + Context.Parameters["assemblypath"] + "\" \"" + parameter + "\"";            base.OnBeforeInstall(savedState);        }  
+    ```  
+  
+    ```vb  
+    Protected Overrides Sub OnBeforeInstall(ByVal savedState As IDictionary)        Dim parameter As String = "MySource1"" ""MyLogFile1"        Context.Parameters("assemblypath") = """" + Context.Parameters("assemblypath") + """ """ + parameter + """"        MyBase.OnBeforeInstall(savedState)    End Sub  
+    ```  
+  
+     このコードでは、既定のパラメーター値を追加することによって、一般的に Windows サービスの実行可能ファイルへの完全パスが含まれる **ImagePath** レジストリ キーが変更されます。 サービスが正しく開始されるためには、パス \(およびそれぞれ個々のパラメーター\) を囲む引用符が必要です。 この Windows サービスのスタートアップ パラメーターを変更するために、ユーザーは、**ImagePath** レジストリ キーで指定されたパラメーターを変更できます。ただし、パラメーターをプログラムによって変更し、ユーザーに対してはわかりやすい方法 \(たとえば、管理ユーティリティや構成ユーティリティ\) で機能を示すことをお勧めします。  
+  
+<a name="BK_Build"></a>   
+## サービスの構築  
+  
+#### サービス プロジェクトをビルドするには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクトのコンテキスト メニューを開き、**\[プロパティ\]** を選択します。 プロジェクトのプロパティ ページが表示されます。  
+  
+2.  \[アプリケーション\] タブで、**\[スタートアップ オブジェクト\]** ボックスの一覧の **\[MyNewService.Program\]** を選択します。  
+  
+3.  **ソリューション エクスプローラー**で、プロジェクトのコンテキスト メニューを開き、**\[ビルド\]** を選択してプロジェクトをビルドします \(キーボード: Ctrl \+ Shift \+ B\)。  
+  
+<a name="BK_Install"></a>   
+## サービスのインストール  
+ Windows サービスを構築済みであるため、サービスをインストールできます。 Windows サービスをインストールするには、インストール先のコンピューターの管理者資格情報が必要です。  
+  
+#### Windows サービスをインストールするには  
+  
+1.  Windows 7 および Windows Server の **\[スタート\]** メニューで、**\[Visual Studio ツール\]** の **\[開発者コマンド プロンプト\]** を開きます。 Windows 8 または Windows 8.1 の **\[スタート\]** 画面で、**\[Visual Studio ツール\]** タイルを選択し、管理者資格情報を使用して開発者コマンド プロンプトを実行します。 \(マウスを使用している場合は、**\[開発者コマンド プロンプト\]** を右クリックし、**\[管理者として実行\]** を選択します\)  
+  
+2.  コマンド プロンプト ウィンドウで、プロジェクトの出力が格納されているフォルダーに移動します。 たとえば、ユーザーの \[マイ ドキュメント\] フォルダーで、Visual Studio 2013\\Projects\\MyNewService\\bin\\Debug に移動します。  
+  
+3.  次のコマンドを入力します。  
+  
+    ```  
+    installutil.exe MyNewService.exe  
+    ```  
+  
+     サービスが正常にインストールされたら、正常に実行されたことが installutil.exe によって報告されます。 InstallUtil.exe が見つからなかった場合は、コンピューター上に存在することを確認します。 このツールは、.NET Framework と共にフォルダー `%WINDIR%\Microsoft.NET\Framework[64]\`*framework\_version* にインストールされます。 たとえば、32 ビット版の .NET Framework 4、4.5、4.5.1、および 4.5.2 の既定のパスは、`C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe` です。  
+  
+     installutil.exe のプロセスでエラーが発生する場合は、インストール ログで理由を確認します。 既定で、ログはサービスの実行可能ファイルと同じフォルダーにあります。[RunInstallerAttribute クラス](../Topic/RunInstallerAttribute%20Class.md) が `ProjectInstaller` クラスにない場合、属性が `true` に設定されていない場合、または `ProjectInstaller` クラスが `public` でない場合は、インストールが失敗することがあります。  
+  
+     詳細については、「[方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)」を参照してください。  
+  
+<a name="BK_StartService"></a>   
+## サービスの開始および実行  
+  
+#### サービスを開始および停止するには  
+  
+1.  Windows で、**\[スタート\]** 画面や **\[スタート\]** メニューを開き、「`services.msc`」と入力します。  
+  
+     **\[サービス\]** ウィンドウの一覧に **MyNewService** が表示されます。  
+  
+     ![&#91;サービス&#93; ウィンドウの MyNewService。](../../../docs/framework/windows-services/media/windowsservices-serviceswindow.PNG "WindowsServices\_ServicesWindow")  
+  
+2.  **\[サービス\]** ウィンドウで、サービスのショートカット メニューを開き、**\[開始\]** を選択します。  
+  
+3.  サービスのショートカット メニューを開き、**\[停止\]** を選択します。  
+  
+4.  \(省略可能\) コマンド ラインからコマンド `net start` `ServiceName` および `net stop` `ServiceName` を使用することで、サービスを開始および停止できます。  
+  
+#### サービスのイベント ログ出力を検査するには  
+  
+1.  Visual Studio で、**サーバー エクスプローラー**を開き \(キーボード: Ctrl \+ Alt \+ S\)、ローカル コンピューターの **\[イベント ログ\]** ノードにアクセスします。  
+  
+2.  **MyNewLog** \(または、省略可能な手順を使用してコマンド ライン引数を追加した場合は **MyLogFile1**\) の一覧を見つけ、展開します。 サービスが実行した 2 つの操作 \(開始および停止\) のエントリが表示されます。  
+  
+     ![イベント ビューアーを使用してイベント ログ項目を表示する。](../../../docs/framework/windows-services/media/windowsservices-eventviewer.PNG "WindowsServices\_EventViewer")  
+  
+<a name="BK_Uninstall"></a>   
+## Windows サービスのアンインストール  
+  
+#### サービスをアンインストールするには  
+  
+1.  管理者資格情報を使用して、開発者コマンド プロンプトを開きます。  
+  
+2.  コマンド プロンプト ウィンドウで、プロジェクトの出力が格納されているフォルダーに移動します。 たとえば、ユーザーの \[マイ ドキュメント\] フォルダーで、Visual Studio 2013\\Projects\\MyNewService\\bin\\Debug に移動します。  
+  
+3.  次のコマンドを入力します。  
+  
+    ```  
+    installutil.exe /u MyNewService.exe  
+    ```  
+  
+     サービスが正常にアンインストールされたら、サービスが正常に削除されたことが installutil.exe によって報告されます。 詳細については、「[方法: サービスをインストールおよびアンインストールする](../../../docs/framework/windows-services/how-to-install-and-uninstall-services.md)」を参照してください。  
+  
+## 次の手順  
+ 他のユーザーが Windows サービスのインストールに使用できるスタンドアロン セットアップ プログラムを作成できますが、これには追加の手順が必要になります。 ClickOnce では Windows サービスがサポートされていないため、発行ウィザードを使用できません。 Microsoft では提供されていませんが、InstallShield のフル ライセンス版を使用できます。 InstallShield について詳しくは、「[InstallShield Limited Edition](../Topic/InstallShield%20Limited%20Edition.md)」をご覧ください。[Windows Installer XML Toolset](http://go.microsoft.com/fwlink/?LinkId=249067) を使用して、Windows サービスのインストーラーを作成することもできます。  
+  
+ インストールしたサービスにコマンドを送信するための <xref:System.ServiceProcess.ServiceController> コンポーネントの使用法を調べることもできます。  
+  
+ インストーラーを使用すると、アプリケーションの実行時にイベント ログを作成する代わりに、アプリケーションのインストール時にイベント ログを作成できます。 さらに、イベント ログは、アプリケーションがアンインストールされたときにインストーラーによって削除されます。 詳細については、<xref:System.Diagnostics.EventLogInstaller> のリファレンス ページを参照してください。  
+  
+## 参照  
+ [Windows Service Applications](../../../docs/framework/windows-services/index.md)   
+ [Windows サービス アプリケーションの概要](../../../docs/framework/windows-services/introduction-to-windows-service-applications.md)   
+ [方法 : Windows サービス アプリケーションをデバッグする](../../../docs/framework/windows-services/how-to-debug-windows-service-applications.md)   
+ [方法 : サーバー エクスプローラー\/データベース エクスプローラーにアクセスして初期化する](../Topic/How%20to:%20Access%20and%20Initialize%20Server%20Explorer-Database%20Explorer.md)   
+ [サービス \(Windows\)](http://msdn.microsoft.com/library/windows/desktop/ms685141.aspx)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/100-workflowinstancerecord.md b/docs/framework/windows-workflow-foundation/100-workflowinstancerecord.md
new file mode 100644
index 00000000000..cc62e3a2d29
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/100-workflowinstancerecord.md
@@ -0,0 +1,45 @@
+---
+title: "100 - WorkflowInstanceRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ed4d1851-b378-489b-a22d-c1db09571fb4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 100 - WorkflowInstanceRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|100|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフローの状態が Started、Resumed、Persisted、Idle、Deleted、Completed、Canceled、Unloaded、Unsuspended の場合に、ワークフロー インスタンスが WorkflowInstanceRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord\= WorkflowInstanceRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、Annotations \= %6、ProfileName \= %7  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前。|  
+|State|xs:string|ワークフローの現在の状態。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1001-workflowapplicationcompleted.md b/docs/framework/windows-workflow-foundation/1001-workflowapplicationcompleted.md
new file mode 100644
index 00000000000..f9e20e925ba
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1001-workflowapplicationcompleted.md
@@ -0,0 +1,38 @@
+---
+title: "1001 - WorkflowApplicationCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7a2ab59a-cf66-437a-b01e-f8f7268a3f7a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 1001 - WorkflowApplicationCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1001|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションが Closed 状態で完了したことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: %1 は Closed 状態で完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフローのインスタンス ID|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1002-workflowapplicationterminated.md b/docs/framework/windows-workflow-foundation/1002-workflowapplicationterminated.md
new file mode 100644
index 00000000000..0fdbd189b79
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1002-workflowapplicationterminated.md
@@ -0,0 +1,39 @@
+---
+title: "1002 - WorkflowApplicationTerminated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e8b111f-79dc-4898-bb4a-e9b36f69420f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 1002 - WorkflowApplicationTerminated
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1002|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 例外が発生し、ワークフロー アプリケーションが Faulted 状態で終了したことを示します。  
+  
+## メッセージ  
+ WorkflowApplication ID: %1 は中止されました。  例外により Faulted 状態で完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowApplicationId|`xs:string`|ワークフロー アプリケーション ID|  
+|例外|`xs:string`|例外の詳細|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1003-workflowinstancecanceled.md b/docs/framework/windows-workflow-foundation/1003-workflowinstancecanceled.md
new file mode 100644
index 00000000000..e988709d5dd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1003-workflowinstancecanceled.md
@@ -0,0 +1,38 @@
+---
+title: "1003 - WorkflowInstanceCanceled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 64754dc2-c160-4bf3-869a-13d56694e2dc
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 1003 - WorkflowInstanceCanceled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1003|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー インスタンスが Canceled 状態で完了したことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: %1 は Canceled 状態で完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフローのインスタンス ID|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1004-workflowinstanceaborted.md b/docs/framework/windows-workflow-foundation/1004-workflowinstanceaborted.md
new file mode 100644
index 00000000000..8f35dffa4da
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1004-workflowinstanceaborted.md
@@ -0,0 +1,39 @@
+---
+title: "1004 - WorkflowInstanceAborted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: edb9ab8c-0b9a-488d-aa96-9c8c7984b53c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 1004 - WorkflowInstanceAborted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1004|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー インスタンスが例外で中断されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' は例外により中止されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフローのインスタンス ID|  
+|例外|`xs:string`|例外の詳細|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1005-workflowapplicationidled.md b/docs/framework/windows-workflow-foundation/1005-workflowapplicationidled.md
new file mode 100644
index 00000000000..224149aa829
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1005-workflowapplicationidled.md
@@ -0,0 +1,38 @@
+---
+title: "1005 - WorkflowApplicationIdled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 74d77dfa-f20d-4fe9-a6ae-e6d1b5fe4182
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1005 - WorkflowApplicationIdled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1005|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションがアイドル状態になったことを示します。  
+  
+## メッセージ  
+ WorkflowApplication ID: '%1' がアイドル状態になりました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフロー アプリケーション ID|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1006-workflowapplicationunhandledexception.md b/docs/framework/windows-workflow-foundation/1006-workflowapplicationunhandledexception.md
new file mode 100644
index 00000000000..71c2098011a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1006-workflowapplicationunhandledexception.md
@@ -0,0 +1,39 @@
+---
+title: "1006 - WorkflowApplicationUnhandledException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dfe0f316-e03b-47fb-b6a3-622c56bfd753
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1006 - WorkflowApplicationUnhandledException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1006|  
+|キーワード|WFRuntime|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションでハンドルされない例外が検出されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' でハンドルされない例外が発生しました。例外は Activity '%2'、DisplayName: '%3' から発生しました。次の操作が実行されます: %4。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフローのインスタンス ID|  
+|例外|`xs:string`|例外の詳細|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1007-workflowapplicationpersisted.md b/docs/framework/windows-workflow-foundation/1007-workflowapplicationpersisted.md
new file mode 100644
index 00000000000..d09923d8a9c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1007-workflowapplicationpersisted.md
@@ -0,0 +1,38 @@
+---
+title: "1007 - WorkflowApplicationPersisted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f4ea4452-28e3-4e66-93c6-eb12ee29bcb1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1007 - WorkflowApplicationPersisted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1007|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションが永続化されていることを示します。  
+  
+## メッセージ  
+ WorkflowApplication ID: %1 が永続化されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowApplicationId|`xs:string`|ワークフロー アプリケーション ID|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1008-workflowapplicationunloaded.md b/docs/framework/windows-workflow-foundation/1008-workflowapplicationunloaded.md
new file mode 100644
index 00000000000..8dfdae9ecaf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1008-workflowapplicationunloaded.md
@@ -0,0 +1,38 @@
+---
+title: "1008 - WorkflowApplicationUnloaded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a605b780-4a7e-43ab-92e7-0a3b01d053b0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1008 - WorkflowApplicationUnloaded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1008|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションがアンロードしたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' がアンロードされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|`xs:string`|ワークフローのインスタンス ID|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1009-activityscheduled.md b/docs/framework/windows-workflow-foundation/1009-activityscheduled.md
new file mode 100644
index 00000000000..b1e22afa22e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1009-activityscheduled.md
@@ -0,0 +1,43 @@
+---
+title: "1009 - ActivityScheduled | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 307e38b6-d47e-47a4-9708-e74d8314b1a1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1009 - ActivityScheduled
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1009|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティの実行がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Parent Activity '%1'、DisplayName: '%2'、InstanceId: '%3' scheduled child Activity '%4'、DisplayName: '%5'、InstanceId: '%6'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ParentActivity|xs:string|親アクティビティの型名。|  
+|ParentDisplayName|xs:string|親アクティビティの表示名。|  
+|ParentInstanceId|xs:string|親アクティビティのインスタンス ID。|  
+|ChildActivity|xs:string|スケジュール済みの子アクティビティの型名。|  
+|ChildDisplayName|xs:string|スケジュール済みの子アクティビティの表示名。|  
+|ChildInstanceId|xs:string|スケジュール済み子アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/101-workflowinstanceunhandledexceptionrecord.md b/docs/framework/windows-workflow-foundation/101-workflowinstanceunhandledexceptionrecord.md
new file mode 100644
index 00000000000..3ccb6a86cc8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/101-workflowinstanceunhandledexceptionrecord.md
@@ -0,0 +1,49 @@
+---
+title: "101 - WorkflowInstanceUnhandledExceptionRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ab7d50a0-5347-4390-8445-1def4dfdff6a
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 101 - WorkflowInstanceUnhandledExceptionRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|101|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|エラー|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceUnhandledExceptionRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceUnhandledExceptionRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、SourceName \= %5、SourceId \= %6、SourceInstanceId \= %7、SourceTypeName\=%8、Exception\=%9、Annotations\= %10、ProfileName \= %11  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|SourceName|xs:string|失敗して unhandledException が発生した原因のアクティビティ名|  
+|SourceId|xs:string|エラーの原因であるアクティビティのアクティビティ ID|  
+|SourceInstanceId|xs:string|エラーの原因であるアクティビティのアクティビティ インスタンス ID|  
+|SourceTypeName|xs:string|失敗して unhandledException が発生した原因のアクティビティの型名|  
+|Exception|xs:string|ハンドルされない例外の詳細|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1010-activitycompleted.md b/docs/framework/windows-workflow-foundation/1010-activitycompleted.md
new file mode 100644
index 00000000000..6ef798e9244
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1010-activitycompleted.md
@@ -0,0 +1,41 @@
+---
+title: "1010 - ActivityCompleted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d256284e-3fd2-4c33-82f4-abb617575706
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1010 - ActivityCompleted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1010|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティが実行を完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' が状態 '%4' で完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|状態|xs:string|アクティビティの状態。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1011-scheduleexecuteactivityworkitem.md b/docs/framework/windows-workflow-foundation/1011-scheduleexecuteactivityworkitem.md
new file mode 100644
index 00000000000..87cf462865c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1011-scheduleexecuteactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1011 - ScheduleExecuteActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e503ae46-ad6b-4fcb-8c0e-146d59a8eff1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1011 - ScheduleExecuteActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1011|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ExecuteActivityWorkItem がスケジュールされたことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して ExecuteActivityWorkItem がスケジュールされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1012-startexecuteactivityworkitem.md b/docs/framework/windows-workflow-foundation/1012-startexecuteactivityworkitem.md
new file mode 100644
index 00000000000..d9cfc730fb3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1012-startexecuteactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1012 - StartExecuteActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 29e9b1c6-c5d7-4b58-b59d-a06a923d3c80
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1012 - StartExecuteActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1012|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ExecuteActivityWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の ExecuteActivityWorkItem の実行を開始しています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1013-completeexecuteactivityworkitem.md b/docs/framework/windows-workflow-foundation/1013-completeexecuteactivityworkitem.md
new file mode 100644
index 00000000000..402a23173a7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1013-completeexecuteactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1013 - CompleteExecuteActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31fc57b3-ef2f-48f0-a5de-b4e2c5c9ded7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1013 - CompleteExecuteActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1013|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ExecuteActivityWorkItem が完了したことを示します  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の ExecuteActivityWorkItem が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1014-schedulecompletionworkitem.md b/docs/framework/windows-workflow-foundation/1014-schedulecompletionworkitem.md
new file mode 100644
index 00000000000..f30af7bfc7c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1014-schedulecompletionworkitem.md
@@ -0,0 +1,43 @@
+---
+title: "1014 - ScheduleCompletionWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84203735-478d-42d8-a320-c175dbddcb38
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1014 - ScheduleCompletionWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1014|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CompletionWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ 親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して CompletionWorkItem がスケジュールされました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ParentActivity|xs:string|親アクティビティの型名。|  
+|ParentDisplayName|xs:string|親アクティビティの表示名。|  
+|ParentInstanceId|xs:string|親アクティビティのインスタンス ID。|  
+|CompletedActivity|xs:string|完了したアクティビティの型名。|  
+|CompletedActivityDisplayName|xs:string|完了したアクティビティの表示名。|  
+|CompletedActivityInstanceId|xs:string|完了したアクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1015-startcompletionworkitem.md b/docs/framework/windows-workflow-foundation/1015-startcompletionworkitem.md
new file mode 100644
index 00000000000..3aa5c8473fb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1015-startcompletionworkitem.md
@@ -0,0 +1,43 @@
+---
+title: "1015 - StartCompletionWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96fd1d4e-c5d0-46ad-8a71-4b4b49ac7262
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1015 - StartCompletionWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1015|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CompletionWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ 親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CompletionWorkItem の実行を開始しています。  Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ParentActivity|xs:string|親アクティビティの型名。|  
+|ParentDisplayName|xs:string|親アクティビティの表示名。|  
+|ParentInstanceId|xs:string|親アクティビティのインスタンス ID。|  
+|CompletedActivity|xs:string|完了したアクティビティの型名。|  
+|CompletedActivityDisplayName|xs:string|完了したアクティビティの表示名。|  
+|CompletedActivityInstanceId|xs:string|完了したアクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1016-completecompletionworkitem.md b/docs/framework/windows-workflow-foundation/1016-completecompletionworkitem.md
new file mode 100644
index 00000000000..ab9499325a1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1016-completecompletionworkitem.md
@@ -0,0 +1,43 @@
+---
+title: "1016 - CompleteCompletionWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 246929fb-6f14-440a-814b-cd8349350644
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1016 - CompleteCompletionWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1016|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CompletionWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ 親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CompletionWorkItem が完了しました。  Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ParentActivity|xs:string|親アクティビティの型名。|  
+|ParentDisplayName|xs:string|親アクティビティの表示名。|  
+|ParentInstanceId|xs:string|親アクティビティのインスタンス ID。|  
+|CompletedActivity|xs:string|完了したアクティビティの型名。|  
+|CompletedActivityDisplayName|xs:string|完了したアクティビティの表示名。|  
+|CompletedActivityInstanceId|xs:string|完了したアクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1017-schedulecancelactivityworkitem.md b/docs/framework/windows-workflow-foundation/1017-schedulecancelactivityworkitem.md
new file mode 100644
index 00000000000..4ce316f00d6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1017-schedulecancelactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1017 - ScheduleCancelActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 864546ab-d65c-4989-8fcb-537ba03a3cdd
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1017 - ScheduleCancelActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1017|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CancelActivityWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して CancelActivityWorkItem がスケジュールされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1018-startcancelactivityworkitem.md b/docs/framework/windows-workflow-foundation/1018-startcancelactivityworkitem.md
new file mode 100644
index 00000000000..c095e766673
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1018-startcancelactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1018 - StartCancelActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 68b4fa1d-eee6-4a2a-8c16-7e9d89f08ab9
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1018 - StartCancelActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1018|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CancelActivityWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CancelActivityWorkItem の実行を開始しています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1019-completecancelactivityworkitem.md b/docs/framework/windows-workflow-foundation/1019-completecancelactivityworkitem.md
new file mode 100644
index 00000000000..1317d3b42af
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1019-completecancelactivityworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1019 - CompleteCancelActivityWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75a4a1ab-e5a3-4f4e-88e4-d19806e671d7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1019 - CompleteCancelActivityWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1019|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CancelActivityWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CancelActivityWorkItem が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/102-workflowinstanceabortedrecord.md b/docs/framework/windows-workflow-foundation/102-workflowinstanceabortedrecord.md
new file mode 100644
index 00000000000..ed160ee38bc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/102-workflowinstanceabortedrecord.md
@@ -0,0 +1,45 @@
+---
+title: "102 - WorkflowInstanceAbortedRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bde4378d-4eea-4907-aaf2-c1a2bc770a37
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 102 - WorkflowInstanceAbortedRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|102|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceAbortedRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceAbortedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|Reason|xs:string|ワークフローが中止された理由|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1020-createbookmark.md b/docs/framework/windows-workflow-foundation/1020-createbookmark.md
new file mode 100644
index 00000000000..0f2665cc5b9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1020-createbookmark.md
@@ -0,0 +1,42 @@
+---
+title: "1020 - CreateBookmark | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4bee948d-816f-4803-85cc-3883b5e23d10
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1020 - CreateBookmark
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1020|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ あるアクティビティ用のブックマークが作成されたことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のブックマークが作成されました。BookmarkName: %4、BookmarkScope: %5。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|BookmarkName|xs:string|ブックマークの名前。|  
+|BookmarkScope|xs:string|ブックマークのスコープ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1021-schedulebookmarkworkitem.md b/docs/framework/windows-workflow-foundation/1021-schedulebookmarkworkitem.md
new file mode 100644
index 00000000000..2ee1b93208e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1021-schedulebookmarkworkitem.md
@@ -0,0 +1,42 @@
+---
+title: "1021 - ScheduleBookmarkWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e0da311-b219-4637-9460-90cdafcc4ecd
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1021 - ScheduleBookmarkWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1021|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ BookmarkWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して BookmarkWorkItem がスケジュールされました。BookmarkName: %4、BookmarkScope: %5。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|BookmarkName|xs:string|ブックマークの名前。|  
+|BookmarkScope|xs:string|ブックマークのスコープ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1022-startbookmarkworkitem.md b/docs/framework/windows-workflow-foundation/1022-startbookmarkworkitem.md
new file mode 100644
index 00000000000..32e0deca277
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1022-startbookmarkworkitem.md
@@ -0,0 +1,42 @@
+---
+title: "1022 - StartBookmarkWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4415fbdb-0329-4019-803f-aea66e75f3da
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1022 - StartBookmarkWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1022|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ BookmarkWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の BookmarkWorkItem の実行を開始しています。BookmarkName: %4、BookmarkScope: %5。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|BookmarkName|xs:string|ブックマークの名前。|  
+|BookmarkScope|xs:string|ブックマークのスコープ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1023-completebookmarkworkitem.md b/docs/framework/windows-workflow-foundation/1023-completebookmarkworkitem.md
new file mode 100644
index 00000000000..47089365757
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1023-completebookmarkworkitem.md
@@ -0,0 +1,42 @@
+---
+title: "1023 - CompleteBookmarkWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc5dac57-b3eb-4826-b505-c6d269e4774d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1023 - CompleteBookmarkWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1023|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ BookmarkWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の BookmarkWorkItem が完了しました。  BookmarkName: %4、BookmarkScope: %5。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|BookmarkName|xs:string|ブックマークの名前。|  
+|BookmarkScope|xs:string|ブックマークのスコープ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1024-createbookmarkscope.md b/docs/framework/windows-workflow-foundation/1024-createbookmarkscope.md
new file mode 100644
index 00000000000..00b055a3a86
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1024-createbookmarkscope.md
@@ -0,0 +1,38 @@
+---
+title: "1024 - CreateBookmarkScope | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1ed8fc2-2a31-4878-a851-5db8b869283a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1024 - CreateBookmarkScope
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1024|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ BookmarkScope が作成されていることを示します。  
+  
+## メッセージ  
+ BookmarkScope が作成されました: %1。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|BookmarkScope|xs:string|ブックマークのスコープ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1025-bookmarkscopeinitialized.md b/docs/framework/windows-workflow-foundation/1025-bookmarkscopeinitialized.md
new file mode 100644
index 00000000000..c17ebf999d7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1025-bookmarkscopeinitialized.md
@@ -0,0 +1,39 @@
+---
+title: "1025 - BookmarkScopeInitialized | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 63584434-e709-471d-9e96-97d3d99e70d6
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1025 - BookmarkScopeInitialized
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1025|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ BookmarkScope が初期化されていることを示します。  
+  
+## メッセージ  
+ TemporaryId: '%1' を指定されていた BookmarkScope が ID: '%2' で初期化されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TemporaryId|xs:string|ブックマークの一時 ID。|  
+|InitializedId|xs:string|ブックマークの初期化された ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1026-scheduletransactioncontextworkitem.md b/docs/framework/windows-workflow-foundation/1026-scheduletransactioncontextworkitem.md
new file mode 100644
index 00000000000..d3905cd539a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1026-scheduletransactioncontextworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1026 - ScheduleTransactionContextWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d5f86ba-ec21-4129-a726-5432e425384c
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1026 - ScheduleTransactionContextWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1026|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TransactionContextWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して TransactionContextWorkItem がスケジュールされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1027-starttransactioncontextworkitem.md b/docs/framework/windows-workflow-foundation/1027-starttransactioncontextworkitem.md
new file mode 100644
index 00000000000..7c5ff993bb9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1027-starttransactioncontextworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1027 - StartTransactionContextWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 116ae5ec-b9d5-4231-824e-270d00eea7b8
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1027 - StartTransactionContextWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1027|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TransactionContextWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の TransactionContextWorkItem の実行を開始しています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1028-completetransactioncontextworkitem.md b/docs/framework/windows-workflow-foundation/1028-completetransactioncontextworkitem.md
new file mode 100644
index 00000000000..33c45677910
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1028-completetransactioncontextworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1028 - CompleteTransactionContextWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95423f9d-d29a-460e-bcd8-096e80af5bd0
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1028 - CompleteTransactionContextWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1028|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TransactionContextWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の TransactionContextWorkItem が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1029-schedulefaultworkitem.md b/docs/framework/windows-workflow-foundation/1029-schedulefaultworkitem.md
new file mode 100644
index 00000000000..cbc9710994c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1029-schedulefaultworkitem.md
@@ -0,0 +1,44 @@
+---
+title: "1029 - ScheduleFaultWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3a56b29e-f740-459d-8576-d81e58bf5a03
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1029 - ScheduleFaultWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1029|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ FaultWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して FaultWorkItem がスケジュールされました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FaultActivity|xs:string|エラーとなったアクティビティの型名。|  
+|FaultActivityDisplayName|xs:string|エラーとなったアクティビティの表示名。|  
+|FaultActivityInstanceId|xs:string|エラーとなったアクティビティのインスタンス ID。|  
+|ExceptionActivity|xs:string|例外をスローしたアクティビティの型名。|  
+|ExceptionActivityDisplayName|xs:string|例外をスローしたアクティビティの表示名。|  
+|ExceptionActivityInstanceId|xs:string|例外をスローしたアクティビティのインスタンス ID。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/103-activitystaterecord.md b/docs/framework/windows-workflow-foundation/103-activitystaterecord.md
new file mode 100644
index 00000000000..0ef50c1d100
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/103-activitystaterecord.md
@@ -0,0 +1,50 @@
+---
+title: "103 - ActivityStateRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 57636a9a-561e-44aa-aef9-1f1894aaa6dd
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 103 - ActivityStateRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|103|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティが ActivityStateRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= ActivityStateRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、State \= %4、Name\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Arguments\=%9、Variables\=%10、Annotations\=%11、ProfileName \= %12  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|State|xs:string|アクティビティの状態|  
+|Name|xs:string|イベントを生成したアクティビティの表示名|  
+|ActivityId|xs:string|生成したアクティビティのアクティビティ ID|  
+|ActivityInstanceId|xs:string|生成したアクティビティのアクティビティ インスタンス ID|  
+|ActivityTypeName|xs:string|生成したアクティビティの型名|  
+|Arguments|xs:string|このイベントで追跡された引数。値は、\<items\>\<\> item  name \= "argumentName" type\="System.String"\<argumentValue\>\<\/item\>\/items という形式で XML 要素に格納されます。引数が追跡されなかった場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。string、char、bool、int、short、long、uint、ushort、ulong、System.Single、float、double、System.Guid、System.DateTimeOffset、および System.DateTime の各型は、ToString\(\) から返される値として格納されます。その他のすべての型は、System.Runtime.Serialization.NetDataContractSerializer を使用してシリアル化されます。|  
+|Variables|xs:string|このイベントで追跡された変数。値は、\<items\>\<\> item  name \= "variableName" type\="System.String"\<variableValue\>\<\/item\>\/items という形式で XML 要素に格納されます。変数が追跡されなかった場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、変数の値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。string、char、bool、int、short、long、uint、ushort、ulong、System.Single、float、double、System.Guid、System.DateTimeOffset、および System.DateTime の各型は、ToString\(\) から返される値として格納されます。その他のすべての型は、System.Runtime.Serialization.NetDataContractSerializer を使用してシリアル化されます。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1030-startfaultworkitem.md b/docs/framework/windows-workflow-foundation/1030-startfaultworkitem.md
new file mode 100644
index 00000000000..43063b2f59d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1030-startfaultworkitem.md
@@ -0,0 +1,44 @@
+---
+title: "1030 - StartFaultWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1601fb9-0bc6-4dbe-816f-f24914063d34
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1030 - StartFaultWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1030|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ FaultWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の FaultWorkItem の実行を開始しています。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FaultActivity|xs:string|エラーとなったアクティビティの型名。|  
+|FaultActivityDisplayName|xs:string|エラーとなったアクティビティの表示名。|  
+|FaultActivityInstanceId|xs:string|エラーとなったアクティビティのインスタンス ID。|  
+|ExceptionActivity|xs:string|例外をスローしたアクティビティの型名。|  
+|ExceptionActivityDisplayName|xs:string|例外をスローしたアクティビティの表示名。|  
+|ExceptionActivityInstanceId|xs:string|例外をスローしたアクティビティのインスタンス ID。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1031-completefaultworkitem.md b/docs/framework/windows-workflow-foundation/1031-completefaultworkitem.md
new file mode 100644
index 00000000000..6a6be72b771
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1031-completefaultworkitem.md
@@ -0,0 +1,44 @@
+---
+title: "1031 - CompleteFaultWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 95f4ccb0-6be4-41f3-9330-fae43165828f
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1031 - CompleteFaultWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1031|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ FaultWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の FaultWorkItem が完了しました。  Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FaultActivity|xs:string|エラーとなったアクティビティの型名。|  
+|FaultActivityDisplayName|xs:string|エラーとなったアクティビティの表示名。|  
+|FaultActivityInstanceId|xs:string|エラーとなったアクティビティのインスタンス ID。|  
+|ExceptionActivity|xs:string|例外をスローしたアクティビティの型名。|  
+|ExceptionActivityDisplayName|xs:string|例外をスローしたアクティビティの表示名。|  
+|ExceptionActivityInstanceId|xs:string|例外をスローしたアクティビティのインスタンス ID。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1032-scheduleruntimeworkitem.md b/docs/framework/windows-workflow-foundation/1032-scheduleruntimeworkitem.md
new file mode 100644
index 00000000000..cd51e8df511
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1032-scheduleruntimeworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1032 - ScheduleRuntimeWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 54688101-becf-42f3-80ca-f53a7b527620
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1032 - ScheduleRuntimeWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1032|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ RuntimeWorkItem がスケジュールされていることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対してランタイム作業項目がスケジュールされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1033-startruntimeworkitem.md b/docs/framework/windows-workflow-foundation/1033-startruntimeworkitem.md
new file mode 100644
index 00000000000..39929520a2a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1033-startruntimeworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1033 - StartRuntimeWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 172b5346-9f3b-46ae-bc06-39872022376a
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1033 - StartRuntimeWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1033|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ RuntimeWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のランタイム作業項目の実行を開始しています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1034-completeruntimeworkitem.md b/docs/framework/windows-workflow-foundation/1034-completeruntimeworkitem.md
new file mode 100644
index 00000000000..45bf0e1e8f7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1034-completeruntimeworkitem.md
@@ -0,0 +1,40 @@
+---
+title: "1034 - CompleteRuntimeWorkItem | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 45620011-8b04-4f87-ab5a-65b24145e17d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1034 - CompleteRuntimeWorkItem
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1034|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ RuntimeWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のランタイム作業項目が完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1035-runtimetransactionset.md b/docs/framework/windows-workflow-foundation/1035-runtimetransactionset.md
new file mode 100644
index 00000000000..b15fa4ee349
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1035-runtimetransactionset.md
@@ -0,0 +1,43 @@
+---
+title: "1035 - RuntimeTransactionSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03b37de9-778c-4beb-b0e3-de73ece6088e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1035 - RuntimeTransactionSet
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1035|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティがランタイムのトランザクションを設定したことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' によってランタイム トランザクションが設定されました。実行は Activity '%4'、DisplayName: '%5'、InstanceId: '%6' に分離されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|IsolatedActivity|xs:string|トランザクションが分離されるアクティビティの型の名前。|  
+|IsolatedActivityDisplayName|xs:string|トランザクションが分離されるアクティビティの表示名。|  
+|IsolatedActivityInstanceId|xs:string|トランザクションが分離されるアクティビティのインスタンスの ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1036-runtimetransactioncompletionrequested.md b/docs/framework/windows-workflow-foundation/1036-runtimetransactioncompletionrequested.md
new file mode 100644
index 00000000000..794ae171c75
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1036-runtimetransactioncompletionrequested.md
@@ -0,0 +1,40 @@
+---
+title: "1036 - RuntimeTransactionCompletionRequested | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d36b9f44-7c0f-4083-9d3a-9034dd2b98de
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1036 - RuntimeTransactionCompletionRequested
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1036|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティがランタイムのトランザクションの完了をスケジュールしたことを示します。  
+  
+## メッセージ  
+ Activity '%1'、DisplayName: '%2'、InstanceId: '%3' はランタイム トランザクションの完了をスケジュールしました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1037-runtimetransactioncomplete.md b/docs/framework/windows-workflow-foundation/1037-runtimetransactioncomplete.md
new file mode 100644
index 00000000000..ca1e1045344
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1037-runtimetransactioncomplete.md
@@ -0,0 +1,38 @@
+---
+title: "1037 - RuntimeTransactionComplete | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2c8c31e0-42a9-4f46-865b-2da9ab16a0ba
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1037 - RuntimeTransactionComplete
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1037|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ランタイム トランザクションが完了したことを示します。  
+  
+## メッセージ  
+ ランタイム トランザクションは '%1' の状態で完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|状態|xs:string|トランザクションの状態。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1038-enternopersistblock.md b/docs/framework/windows-workflow-foundation/1038-enternopersistblock.md
new file mode 100644
index 00000000000..7a576ab7ed7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1038-enternopersistblock.md
@@ -0,0 +1,37 @@
+---
+title: "1038 - EnterNoPersistBlock | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 64f3e60a-614d-46a5-8d30-fa63417c3d91
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1038 - EnterNoPersistBlock
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1038|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ no persist ブロックが入力されたことを示します。  
+  
+## メッセージ  
+ no persist ブロックに入ります。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1039-exitnopersistblock.md b/docs/framework/windows-workflow-foundation/1039-exitnopersistblock.md
new file mode 100644
index 00000000000..842027d2100
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1039-exitnopersistblock.md
@@ -0,0 +1,37 @@
+---
+title: "1039 - ExitNoPersistBlock | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3b46ea28-3ee0-43eb-96ff-a6d696da87f8
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1039 - ExitNoPersistBlock
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1039|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ no persist ブロックが終了したことを示します。  
+  
+## メッセージ  
+ no persist ブロックを終了します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/104-activityscheduledrecord.md b/docs/framework/windows-workflow-foundation/104-activityscheduledrecord.md
new file mode 100644
index 00000000000..776397aa9b2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/104-activityscheduledrecord.md
@@ -0,0 +1,51 @@
+---
+title: "104 - ActivityScheduledRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae202178-8fb1-4646-a3aa-18beeda8ff93
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 104 - ActivityScheduledRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|104|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティが ActivityScheduledRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= ActivityScheduledRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、Name \= %4、ActivityId \= %5、ActivityInstanceId \= %6、ActivityTypeName \= %7、ChildActivityName \= %8、ChildActivityId \= %9、ChildActivityInstanceId \= %10、ChildActivityTypeName \=%11、Annotations\=%12、ProfileName \= %13  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|子アクティビティをスケジュールしたアクティビティの名前|  
+|ActivityId|xs:string|子アクティビティをスケジュールしたアクティビティの ID|  
+|ActivityInstanceId|xs:string|子アクティビティをスケジュールしたアクティビティのインスタンス ID|  
+|ActivityTypeName|xs:string|取り消し操作を要求したアクティビティの型|  
+|ChildActivityName|xs:string|スケジュール済みアクティビティの名前|  
+|ChildActivityId|xs:string|スケジュール済みアクティビティの ID|  
+|ChildActivityInstanceId|xs:string|スケジュール済みアクティビティのインスタンス ID|  
+|ChildActivityTypeName|xs:string|スケジュール済みアクティビティの型|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1040-inargumentbound.md b/docs/framework/windows-workflow-foundation/1040-inargumentbound.md
new file mode 100644
index 00000000000..829f4a28d7c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1040-inargumentbound.md
@@ -0,0 +1,42 @@
+---
+title: "1040 - InArgumentBound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7dfaad1b-36c0-4575-84c1-31d63b0eaf5d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1040 - InArgumentBound
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1040|  
+|キーワード|WFActivities|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ In 引数がバインドされたことを示します。  
+  
+## メッセージ  
+ Activity '%2' の引数 '%1' で、DisplayName: '%3'、InstanceId: '%4' が値: %5 にバインドされています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InArgument|xs:string|InArgument の名前。|  
+|アクティビティ|xs:string|アクティビティの型名。|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|InstanceId|xs:string|アクティビティのインスタンス ID。|  
+|値|xs:string|InArgument にバインドされた値。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1041-workflowapplicationpersistableidle.md b/docs/framework/windows-workflow-foundation/1041-workflowapplicationpersistableidle.md
new file mode 100644
index 00000000000..2bad904d44e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1041-workflowapplicationpersistableidle.md
@@ -0,0 +1,39 @@
+---
+title: "1041 - WorkflowApplicationPersistableIdle | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 966adf2f-e21d-44df-a3ec-a8e285e0a316
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1041 - WorkflowApplicationPersistableIdle
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1041|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アプリケーションがアイドル状態のままであることを示します。  ワークフロー アプリケーションはアイドル状態または永続化されます。  
+  
+## メッセージ  
+ WorkflowApplication ID: '%1' がアイドル状態のままです。次の操作が実行されます: %2。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowApplicationId|xs:string|ワークフロー アプリケーション ID|  
+|ActionTaken|xs:string|ワークフロー アプリケーションで実行されるアクション。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/105-faultpropagationrecord.md b/docs/framework/windows-workflow-foundation/105-faultpropagationrecord.md
new file mode 100644
index 00000000000..7e2e1088475
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/105-faultpropagationrecord.md
@@ -0,0 +1,53 @@
+---
+title: "105 - FaultPropagationRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 168473b1-b1e5-4e9f-8a2a-35bbdb2ef531
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 105 - FaultPropagationRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|105|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスを持つアクティビティが FaultPropagationRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= FaultPropagationRecord、InstanceID\=%1、RecordNumber\=%2、EventTime\=%3、FaultSourceActivityName\=%4、FaultSourceActivityId\=%5、FaultSourceActivityInstanceId\=%6、FaultSourceActivityTypeName\=%7、FaultHandlerActivityName\=%8、 FaultHandlerActivityId \= %9、FaultHandlerActivityInstanceId \=%10、FaultHandlerActivityTypeName\=%11、Fault\=%12、IsFaultSource\=%13、Annotations\=%14、ProfileName \= %15  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベンの生成時刻 \(UTC\)。|  
+|FaultSourceActivityName|xs:string|エラーを生成したアクティビティの名前。|  
+|FaultSourceActivityId|xs:string|エラーを生成したアクティビティの ID。|  
+|FaultSourceActivityInstanceId|xs:string|エラーを生成したアクティビティのインスタンス ID。|  
+|FaultSourceActivityTypeName|xs:string|エラーを生成したアクティビティのタイプ。|  
+|FaultHandlerActivityName|xs:string|エラー ハンドラー アクティビティの表示名。|  
+|FaultHandlerActivityId|xs:string|エラー ハンドラー アクティビティの ID。|  
+|FaultHandlerActivityInstanceId|xs:string|エラー ハンドラー アクティビティのインスタンス ID。|  
+|FaultHandlerActivityTypeName|xs:string|エラー ハンドラー アクティビティのタイプ。|  
+|Fault|xs:string|エラーの詳細。|  
+|IsFaultSource|xs:unsignedByte|イベントがエラー ソースから生成されたかどうかを示します。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/106-cancelrequestrecord.md b/docs/framework/windows-workflow-foundation/106-cancelrequestrecord.md
new file mode 100644
index 00000000000..cc7b40ed893
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/106-cancelrequestrecord.md
@@ -0,0 +1,51 @@
+---
+title: "106 - CancelRequestRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f72a59aa-8093-4a8e-94df-40acaffb1ffb
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 106 - CancelRequestRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|106|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティが cancelrequestedrecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= CancelRequestedRecord、InstanceID\=%1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityId\=%5、ActivityInstanceId\=%6、ActivityTypeName \= %7、ChildActivityName \= %8、ChildActivityId \= %9、ChildActivityInstanceId \= %10、ChildActivityTypeName \=%11、Annotations\=%12、ProfileName \= %13  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|操作のキャンセルを要求したアクティビティの名前|  
+|ActivityId|xs:string|操作のキャンセルを要求したアクティビティの ID|  
+|ActivityInstanceId|xs:string|操作のキャンセルを要求したアクティビティのインスタンス ID|  
+|ActivityTypeName|xs:string|操作のキャンセルを要求したアクティビティの型|  
+|ChildActivityName|xs:string|キャンセルされるアクティビティの名前|  
+|ChildActivityId|xs:string|キャンセルされるアクティビティの ID|  
+|ChildActivityInstanceId|xs:string|キャンセルされるアクティビティのインスタンス ID|  
+|ChildActivityTypeName|xs:string|キャンセルされるアクティビティの型|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/107-bookmarkresumptionrecord.md b/docs/framework/windows-workflow-foundation/107-bookmarkresumptionrecord.md
new file mode 100644
index 00000000000..8452c2aae75
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/107-bookmarkresumptionrecord.md
@@ -0,0 +1,49 @@
+---
+title: "107 -- BookmarkResumptionRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: aa2d37ed-2bfa-439b-89e8-a9354027f155
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 107 -- BookmarkResumptionRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|107|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが BookmarkResumptionRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= BookmarkResumptionRecord、InstanceID\=%1、RecordNumber\=%2,EventTime\=%3、Name\=%4、SubInstanceID\=%5、OwnerActivityName\=%6、OwnerActivityId \=%7、OwnerActivityInstanceId\=%8、OwnerActivityTypeName\=%9、Annotations\=%10、ProfileName \= %11  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|再開したブックマークの名前|  
+|SubInstanceID|xs:GUID|ブックマーク スコープの ID|  
+|OwnerActivityName|xs:string|ブックマーク アクティビティの名前|  
+|OwnerActivityId|xs:string|ブックマーク アクティビティの ID|  
+|OwnerActivityInstanceId|xs:string|ブックマーク アクティビティのインスタンス ID|  
+|OwnerActivityTypeName|xs:string|ブックマーク アクティビティの型|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/108-customtrackingrecordinfo.md b/docs/framework/windows-workflow-foundation/108-customtrackingrecordinfo.md
new file mode 100644
index 00000000000..ee82e4b800d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/108-customtrackingrecordinfo.md
@@ -0,0 +1,49 @@
+---
+title: "108 - CustomTrackingRecordInfo | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5bee501e-4e00-42cd-b949-e88009c3d4e8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 108 - CustomTrackingRecordInfo
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|108|  
+|キーワード|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティが情報レベルで CustomTrackingRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|CustomTrackingRecord の名前|  
+|ActivityName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|ActivityId|xs:string|CustomTrackingRecord を出力するアクティビティの ID|  
+|ActivityInstanceId|xs:string|CustomTrackingRecord を出力するアクティビティのインスタンス|  
+|ActivityTypeName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|Data|xs:string|このイベントで追跡されたデータ。値は、\<items\>\<\> item  name \= "dataName" type\="System.String"\<dataName\>\<\/item\>\/items という形式で XML 要素に格納されます。データが追跡されなかった場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、データの値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。string、char、bool、int、short、long、uint、ushort、ulong、System.Single、float、double、System.Guid、System.DateTimeOffset、および System.DateTime の各型は、ToString\(\) から返される値として格納されます。その他のすべての型は、System.Runtime.Serialization.NetDataContractSerializer を使用してシリアル化されます。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/110-customtrackingrecordwarning.md b/docs/framework/windows-workflow-foundation/110-customtrackingrecordwarning.md
new file mode 100644
index 00000000000..36d7e62a5d1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/110-customtrackingrecordwarning.md
@@ -0,0 +1,49 @@
+---
+title: "110 – CustomTrackingRecordWarning | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bc093de-be47-4ed0-983f-05b4246446fc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 110 – CustomTrackingRecordWarning
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|110|  
+|キーワード|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Warning \(警告\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティが警告レベルで CustomTrackingRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|CustomTrackingRecord の名前|  
+|ActivityName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|ActivityId|xs:string|CustomTrackingRecord を出力するアクティビティの ID|  
+|ActivityInstanceId|xs:string|CustomTrackingRecord を出力するアクティビティのインスタンス|  
+|ActivityTypeName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|Data|xs:string|このイベントで追跡されたデータ。値は、\<items\>\<\> item  name \= "dataName" type\="System.String"\<dataName\>\<\/item\>\/items という形式で XML 要素に格納されます。データが追跡されなかった場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、データの値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。string、char、bool、int、short、long、uint、ushort、ulong、System.Single、float、double、System.Guid、System.DateTimeOffset、および System.DateTime の各型は、ToString\(\) から返される値として格納されます。その他のすべての型は、System.Runtime.Serialization.NetDataContractSerializer を使用してシリアル化されます。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1101-workflowactivitystart.md b/docs/framework/windows-workflow-foundation/1101-workflowactivitystart.md
new file mode 100644
index 00000000000..fb931257693
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1101-workflowactivitystart.md
@@ -0,0 +1,38 @@
+---
+title: "1101 - WorkflowActivityStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 831cd386-b9b5-47a9-9690-aff6292ff348
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1101 - WorkflowActivityStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1101|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アクティビティが開始されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' E2E アクティビティ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|xs:string|ワークフロー インスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1102-workflowactivitystop.md b/docs/framework/windows-workflow-foundation/1102-workflowactivitystop.md
new file mode 100644
index 00000000000..566963c1039
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1102-workflowactivitystop.md
@@ -0,0 +1,38 @@
+---
+title: "1102 - WorkflowActivityStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 285e5cb8-e90d-4914-ac06-e9b176ffefa2
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1102 - WorkflowActivityStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1102|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アクティビティが中止されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' E2E アクティビティ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|xs:string|ワークフロー インスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1103-workflowactivitysuspend.md b/docs/framework/windows-workflow-foundation/1103-workflowactivitysuspend.md
new file mode 100644
index 00000000000..ca0586b7773
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1103-workflowactivitysuspend.md
@@ -0,0 +1,38 @@
+---
+title: "1103 - WorkflowActivitySuspend | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b64e15c2-cb2c-4314-9074-ce2c6717232e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1103 - WorkflowActivitySuspend
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1103|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アクティビティが中断されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' E2E アクティビティ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|xs:string|ワークフロー インスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1104-workflowactivityresume.md b/docs/framework/windows-workflow-foundation/1104-workflowactivityresume.md
new file mode 100644
index 00000000000..622456d5443
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1104-workflowactivityresume.md
@@ -0,0 +1,38 @@
+---
+title: "1104 - WorkflowActivityResume | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7fe95d1e-34bd-43ca-b92e-587d2d248fff
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1104 - WorkflowActivityResume
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1104|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ワークフロー アクティビティが再開されたことを示します。  
+  
+## メッセージ  
+ WorkflowInstance ID: '%1' E2E アクティビティ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|WorkflowInstanceId|xs:string|ワークフロー インスタンス ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/111-customtrackingrecorderror.md b/docs/framework/windows-workflow-foundation/111-customtrackingrecorderror.md
new file mode 100644
index 00000000000..21620c010d2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/111-customtrackingrecorderror.md
@@ -0,0 +1,49 @@
+---
+title: "111 - CustomTrackingRecordError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d469fb12-e094-4d6c-9b4d-abd7ce0d17da
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 111 - CustomTrackingRecordError
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|111|  
+|キーワード|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|エラー|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンス内のアクティビティがエラー レベルで CustomTrackingRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|Name|xs:string|CustomTrackingRecord の名前|  
+|ActivityName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|ActivityId|xs:string|CustomTrackingRecord を出力するアクティビティの ID|  
+|ActivityInstanceId|xs:string|CustomTrackingRecord を出力するアクティビティのインスタンス|  
+|ActivityTypeName|xs:string|CustomTrackingRecord を出力するアクティビティの名前|  
+|Data|xs:string|このイベントで追跡されたデータ。値は、\<items\>\<\> item  name \= "dataName" type\="System.String"\<dataName\>\<\/item\>\/items という形式で XML 要素に格納されます。データが追跡されなかった場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、データの値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。string、char、bool、int、short、long、uint、ushort、ulong、System.Single、float、double、System.Guid、System.DateTimeOffset、および System.DateTime の各型は、ToString\(\) から返される値として格納されます。その他のすべての型は、System.Runtime.Serialization.NetDataContractSerializer を使用してシリアル化されます。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/112-workflowinstancesuspendedrecord.md b/docs/framework/windows-workflow-foundation/112-workflowinstancesuspendedrecord.md
new file mode 100644
index 00000000000..a0cfc90b6d2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/112-workflowinstancesuspendedrecord.md
@@ -0,0 +1,45 @@
+---
+title: "112 - WorkflowInstanceSuspendedRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bc825c7c-8c90-48f7-9336-9a978a8246c6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 112 - WorkflowInstanceSuspendedRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|112|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|Information \(情報\)|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceSuspended Record を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceSuspendedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|Reason|xs:string|ワークフローの中断の理由。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1124-invokemethodisstatic.md b/docs/framework/windows-workflow-foundation/1124-invokemethodisstatic.md
new file mode 100644
index 00000000000..a8c9fbb1c78
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1124-invokemethodisstatic.md
@@ -0,0 +1,38 @@
+---
+title: "1124 - InvokeMethodIsStatic | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9643641-fb52-4fa8-b354-4dd6617d68f6
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1124 - InvokeMethodIsStatic
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1124|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CacheMetadata の手順では、InvokeMethod アクティビティは、呼び出すメソッドが静的であることを示します。  
+  
+## メッセージ  
+ InvokeMethod '%1' \- メソッドは Static です。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InvokeMethod|xs:string|InvokeMethod アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1125-invokemethodisnotstatic.md b/docs/framework/windows-workflow-foundation/1125-invokemethodisnotstatic.md
new file mode 100644
index 00000000000..4c227fa3332
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1125-invokemethodisnotstatic.md
@@ -0,0 +1,38 @@
+---
+title: "1125 - InvokeMethodIsNotStatic | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ea2b3827-63da-497b-b2c3-d5cebefe57a1
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1125 - InvokeMethodIsNotStatic
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1125|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CacheMetadata の手順では、InvokeMethod アクティビティは、呼び出すメソッドが静的ではないことを示します。  
+  
+## メッセージ  
+ InvokeMethod '%1' \- メソッドは Static ではありません。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InvokeMethod|xs:string|InvokeMethod アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1126-invokedmethodthrewexception.md b/docs/framework/windows-workflow-foundation/1126-invokedmethodthrewexception.md
new file mode 100644
index 00000000000..3d8e7c1bbfa
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1126-invokedmethodthrewexception.md
@@ -0,0 +1,39 @@
+---
+title: "1126 - InvokedMethodThrewException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0d3cff1a-97e6-4b6c-be18-108c6881bfc0
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1126 - InvokedMethodThrewException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1126|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ InvokeMethod アクティビティによって呼び出されたメソッドにより、例外がスローされたことを示します。  
+  
+## メッセージ  
+ アクティビティ '%1' によって呼び出されたメソッドで例外がスローされました。  %2  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InvokeMethod|xs:string|InvokeMethod アクティビティの表示名。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/113-workflowinstanceterminatedrecord.md b/docs/framework/windows-workflow-foundation/113-workflowinstanceterminatedrecord.md
new file mode 100644
index 00000000000..012b3046fea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/113-workflowinstanceterminatedrecord.md
@@ -0,0 +1,45 @@
+---
+title: "113 - WorkflowInstanceTerminatedRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f53204ee-4ea2-45e1-8859-e86d07305efd
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 113 - WorkflowInstanceTerminatedRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|Id|113|  
+|キーワード|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|レベル|エラー|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceTerminatedRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceTerminatedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7  
+  
+## 詳細  
+  
+|データ項目名|データ項目型|説明|  
+|------------|------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|Reason|xs:string|ワークフローの終了の理由|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\<\> item  name \= "annotationName" type\="System.String"\<annotationValue\>\<\/item\>\/items という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|HostReference|xs:string|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、"Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名" と定義されます。たとえば、"Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService" と定義されます。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1131-invokemethoduseasyncpattern.md b/docs/framework/windows-workflow-foundation/1131-invokemethoduseasyncpattern.md
new file mode 100644
index 00000000000..f4aee6beb26
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1131-invokemethoduseasyncpattern.md
@@ -0,0 +1,40 @@
+---
+title: "1131 - InvokeMethodUseAsyncPattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eca50fa7-5276-4759-ad1c-e490b9bd1f82
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1131 - InvokeMethodUseAsyncPattern
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1131|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CacheMetadata の手順では、InvokeMethod アクティビティはメソッドを呼び出すときの非同期パターンを使用していることを示します。  
+  
+## メッセージ  
+ InvokeMethod '%1' \- メソッドでは '%2' および '%3' の非同期パターンを使用します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InvokeMethod|xs:string|InvokeMethod アクティビティの表示名。|  
+|BeginMethod|xs:string|begin メソッドの名前。|  
+|EndMethod|xs:string|end メソッドの名前。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1132-invokemethoddoesnotuseasyncpattern.md b/docs/framework/windows-workflow-foundation/1132-invokemethoddoesnotuseasyncpattern.md
new file mode 100644
index 00000000000..f836a7fc6cf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1132-invokemethoddoesnotuseasyncpattern.md
@@ -0,0 +1,38 @@
+---
+title: "1132 - InvokeMethodDoesNotUseAsyncPattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 436b3767-4460-46b0-9ea3-fc2963260c11
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1132 - InvokeMethodDoesNotUseAsyncPattern
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1132|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CacheMetadata 手順内で、InvokeMethod アクティビティがメソッドを呼び出すときに非同期パターンを使用しないことを示します。  
+  
+## メッセージ  
+ InvokeMethod '%1' \- メソッドでは非同期パターンを使用しません。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InvokeMethod|xs:string|InvokeMethod アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/114-workflowinstancerecordwithid.md b/docs/framework/windows-workflow-foundation/114-workflowinstancerecordwithid.md
new file mode 100644
index 00000000000..0dab392971b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/114-workflowinstancerecordwithid.md
@@ -0,0 +1,45 @@
+---
+title: "114 - WorkflowInstanceRecordWithId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2bd8b4a1-b210-4c07-8156-f19392318c08
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 114 - WorkflowInstanceRecordWithId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|114|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフローの状態が Started、Resumed、Persisted、Idle、Deleted、Completed、Canceled、Unloaded、Unsuspended の場合に、ワークフロー インスタンスが WorkflowInstanceRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord\= WorkflowInstanceRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前。|  
+|State|xs:string|ワークフローの現在の状態。|  
+|Annotations|xs:string|このイベントに追加された注釈。値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1140-flowchartstart.md b/docs/framework/windows-workflow-foundation/1140-flowchartstart.md
new file mode 100644
index 00000000000..91bc89dfdc2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1140-flowchartstart.md
@@ -0,0 +1,38 @@
+---
+title: "1140 - FlowchartStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9aa2c71e-a4ab-4aed-b76d-4795e8493b70
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1140 - FlowchartStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1140|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャートの開始がスケジュールされていることを示します。  
+  
+## メッセージ  
+ フローチャート '%1' \- 開始がスケジュールされています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1141-flowchartempty.md b/docs/framework/windows-workflow-foundation/1141-flowchartempty.md
new file mode 100644
index 00000000000..2d00e9bc902
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1141-flowchartempty.md
@@ -0,0 +1,38 @@
+---
+title: "1141 - FlowchartEmpty | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5361db9-c3b5-40fc-96d5-4879953c4cd9
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1141 - FlowchartEmpty
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1141|  
+|キーワード|WFActivities|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャートがノードなしで実行されたことを示します。  
+  
+## メッセージ  
+ フローチャート '%1' \- ノードなしで実行されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1143-flowchartnextnull.md b/docs/framework/windows-workflow-foundation/1143-flowchartnextnull.md
new file mode 100644
index 00000000000..cb07f5e2096
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1143-flowchartnextnull.md
@@ -0,0 +1,38 @@
+---
+title: "1143 - FlowchartNextNull | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d0ee0829-da83-4086-aa2c-a74a4144b4a2
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1143 - FlowchartNextNull
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1143|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャートの次のノードが null であることを示します。  フローチャートの実行は終了します。  
+  
+## メッセージ  
+ フローチャート '%1'\/FlowStep \- 次のノードは null です。  フローチャートの実行は終了します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1146-flowchartswitchcase.md b/docs/framework/windows-workflow-foundation/1146-flowchartswitchcase.md
new file mode 100644
index 00000000000..ef6eb4de788
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1146-flowchartswitchcase.md
@@ -0,0 +1,39 @@
+---
+title: "1146 - FlowchartSwitchCase | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 274e9209-1720-4512-a615-e742f00895f4
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1146 - FlowchartSwitchCase
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1146|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャート スイッチで、どの例が選択されたかを示します。  
+  
+## メッセージ  
+ フローチャート '%1'\/FlowSwitch \- Case '%2' が選択されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|Case|xs:string|選択したスイッチに示します。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1147-flowchartswitchdefault.md b/docs/framework/windows-workflow-foundation/1147-flowchartswitchdefault.md
new file mode 100644
index 00000000000..d8fa2b9a342
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1147-flowchartswitchdefault.md
@@ -0,0 +1,38 @@
+---
+title: "1147 - FlowchartSwitchDefault | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 03bb91f4-bfa4-4420-97fe-8443ee9b03e5
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1147 - FlowchartSwitchDefault
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1147|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャート スイッチで既定の例が選択されたことを示します。  
+  
+## メッセージ  
+ フローチャート '%1'\/FlowSwitch \- 既定の Case が選択されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1148-flowchartswitchcasenotfound.md b/docs/framework/windows-workflow-foundation/1148-flowchartswitchcasenotfound.md
new file mode 100644
index 00000000000..bfd3d7ac785
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1148-flowchartswitchcasenotfound.md
@@ -0,0 +1,38 @@
+---
+title: "1148 - FlowchartSwitchCaseNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9ee7fcee-e040-4306-968e-ed840a1cb00c
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1148 - FlowchartSwitchCaseNotFound
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1148|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ フローチャート スイッチの一致の例および既定の例のいずれも見つけることができなかったことを示します。  フローチャートの実行は終了します。  
+  
+## メッセージ  
+ Flowchart '%1'\/FlowSwitch \- 式の結果に一致する Case アクティビティも Default Case も見つかりませんでした。  フローチャートの実行は終了します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|FlowChart|xs:string|FlowChart の表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/115-workflowinstanceabortedrecordwithid.md b/docs/framework/windows-workflow-foundation/115-workflowinstanceabortedrecordwithid.md
new file mode 100644
index 00000000000..20da1d757a4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/115-workflowinstanceabortedrecordwithid.md
@@ -0,0 +1,45 @@
+---
+title: "115 - WorkflowInstanceAbortedRecordWithId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0293dd4e-e6ae-473a-b3d6-c2d38f9bd875
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 115 - WorkflowInstanceAbortedRecordWithId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|115|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceAbortedRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceAbortedRecord, InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|状態|xs:string|ワークフローの現在の状態。|  
+|コメント|xs:string|このイベントに追加された注釈。  値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。  注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。  ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。  イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1150-compensationstate.md b/docs/framework/windows-workflow-foundation/1150-compensationstate.md
new file mode 100644
index 00000000000..a48d681ba7c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1150-compensationstate.md
@@ -0,0 +1,39 @@
+---
+title: "1150 - CompensationState | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: eb015842-cc5a-47be-bce5-6af39e567723
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 1150 - CompensationState
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1150|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ CompensableActivity の状態の変更を示します。  
+  
+## メッセージ  
+ CompensableActivity '%1' は '%2' 状態です。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|状態|xs:string|補正の状態。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/116-workflowinstancesuspendedrecordwithid.md b/docs/framework/windows-workflow-foundation/116-workflowinstancesuspendedrecordwithid.md
new file mode 100644
index 00000000000..a3496a3da58
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/116-workflowinstancesuspendedrecordwithid.md
@@ -0,0 +1,45 @@
+---
+title: "116 - WorkflowInstanceSuspendedRecordWithId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 38232c03-6139-4494-a020-79bc83eb9dce
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 116 - WorkflowInstanceSuspendedRecordWithId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|116|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceSuspended Record を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceSuspendedRecord, InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|状態|xs:string|ワークフローの現在の状態。|  
+|コメント|xs:string|このイベントに追加された注釈。  値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。  注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。  ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。  イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/117-workflowinstanceterminatedrecordwithid.md b/docs/framework/windows-workflow-foundation/117-workflowinstanceterminatedrecordwithid.md
new file mode 100644
index 00000000000..738e4b61dba
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/117-workflowinstanceterminatedrecordwithid.md
@@ -0,0 +1,45 @@
+---
+title: "117 - WorkflowInstanceTerminatedRecordWithId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e68539d0-5338-468a-9f75-7e5b09d39a3c
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 117 - WorkflowInstanceTerminatedRecordWithId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|117|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceTerminatedRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceTerminatedRecord, InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|状態|xs:string|ワークフローの現在の状態。|  
+|コメント|xs:string|このイベントに追加された注釈。  値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。  注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。  ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。  イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/118-workflowinstanceunhandledexceptionrecordwithid.md b/docs/framework/windows-workflow-foundation/118-workflowinstanceunhandledexceptionrecordwithid.md
new file mode 100644
index 00000000000..810acadd14a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/118-workflowinstanceunhandledexceptionrecordwithid.md
@@ -0,0 +1,50 @@
+---
+title: "118 - WorkflowInstanceUnhandledExceptionRecordWithId | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2ce4b193-e141-4cc4-86a3-2e8c984c110d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 118 - WorkflowInstanceUnhandledExceptionRecordWithId
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|118|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが WorkflowInstanceUnhandledExceptionRecord を生成したときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord \= WorkflowInstanceUnhandledExceptionRecord, InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、SourceName \= %5、SourceId \= %6、SourceInstanceId \= %7、SourceTypeName\=%8、Exception\=%9、Annotations\= %10、ProfileName \= %11、WorkflowDefinitionIdentity \= %12  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|SourceName|xs:string|失敗して unhandledException が発生した原因のアクティビティ名|  
+|SourceId|xs:string|エラーの原因であるアクティビティのアクティビティ ID|  
+|SourceInstanceId|xs:string|エラーの原因であるアクティビティのアクティビティ インスタンス ID|  
+|SourceTypeName|xs:string|失敗して unhandledException が発生した原因のアクティビティの型名|  
+|例外|xs:string|ハンドルされない例外の詳細|  
+|状態|xs:string|ワークフローの現在の状態。|  
+|コメント|xs:string|このイベントに追加された注釈。  値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。  注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。  ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。  イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/119-workflowinstanceupdatedrecord.md b/docs/framework/windows-workflow-foundation/119-workflowinstanceupdatedrecord.md
new file mode 100644
index 00000000000..fadef9680b6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/119-workflowinstanceupdatedrecord.md
@@ -0,0 +1,47 @@
+---
+title: "119 - WorkflowInstanceUpdatedRecord | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 32485d0a-dcdb-45bc-b1e3-79fa9ad9439b
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 119 - WorkflowInstanceUpdatedRecord
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|119|  
+|キーワード|HealthMonitoring、WFTracking|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー インスタンスが更新されたときに、ETW 追跡参加要素によって生成されます。  
+  
+## メッセージ  
+ TrackRecord\= WorkflowInstanceUpdatedRecord, InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、OriginalDefinitionIdentity \= %6、UpdatedDefinitionIdentity \= %7、Annotations \= %8、ProfileName \= %9  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|InstanceId|xs:GUID|ワークフローのインスタンス ID|  
+|RecordNumber|xs:long|生成されたレコードのシーケンス番号|  
+|EventTime|xs:dateTime|イベントの生成時刻 \(UTC\)|  
+|ActivityDefinitionId|xs:string|ワークフローのルート アクティビティの名前|  
+|状態|xs:string|ワークフローの現在の状態。|  
+|OriginalDefinitionIdentity|xs:string|元のワークフロー定義 ID|  
+|UpdatedDefinitionIdentity|xs:string|更新されたワークフロー定義 ID|  
+|コメント|xs:string|このイベントに追加された注釈。  値は、\<items\>\< item name \= "annotationName" type\="System.String"\>annotationValue\<\/item\>\<\/items\> という形式で XML 要素に格納されます。  注釈が指定されていない場合は、文字列に \<items\/\> が含まれます。  ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードに制限されます。  イベントのサイズが ETW の制限を超えると、注釈が破棄され、注釈値が \<items\>...\<\/items\> に置き換えられて、イベントが切り捨てられます。|  
+|ProfileName|xs:string|このイベントを生成した追跡プロファイルの名前|  
+|WorkflowDefinitionIdentity|xs:string|ワークフロー定義 ID|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1223-switchcasenotfound.md b/docs/framework/windows-workflow-foundation/1223-switchcasenotfound.md
new file mode 100644
index 00000000000..ddbf574b383
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1223-switchcasenotfound.md
@@ -0,0 +1,38 @@
+---
+title: "1223 - SwitchCaseNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 332ace82-2d9e-4fd9-a9a8-f077f43b4a08
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1223 - SwitchCaseNotFound
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1223|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ Expression の結果に一致する Case アクティビティが Switch アクティビティに見つけられなかったことを示します。  
+  
+## メッセージ  
+ Switch アクティビティ '%1' は Expression の結果に一致する Case アクティビティを見つけることができませんでした。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1449-wfmessagereceived.md b/docs/framework/windows-workflow-foundation/1449-wfmessagereceived.md
new file mode 100644
index 00000000000..5532912b313
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1449-wfmessagereceived.md
@@ -0,0 +1,37 @@
+---
+title: "1449 - WfMessageReceived | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93f4562b-eb7e-4dd5-a208-9b6420f198fa
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1449 - WfMessageReceived
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1449|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ メッセージがワークフローで受信されたことを示します。  
+  
+## メッセージ  
+ ワークフローによって受信されたメッセージ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/1450-wfmessagesent.md b/docs/framework/windows-workflow-foundation/1450-wfmessagesent.md
new file mode 100644
index 00000000000..7984e29d796
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/1450-wfmessagesent.md
@@ -0,0 +1,37 @@
+---
+title: "1450 - WfMessageSent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1acc8b92-a76d-479b-a6fe-328affff5f3d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 1450 - WfMessageSent
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|1450|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ メッセージがワークフローで送信されたことを示します。  
+  
+## メッセージ  
+ ワークフローから送信されたメッセージ  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2021-executeworkitemstart.md b/docs/framework/windows-workflow-foundation/2021-executeworkitemstart.md
new file mode 100644
index 00000000000..f33cd899fda
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2021-executeworkitemstart.md
@@ -0,0 +1,37 @@
+---
+title: "2021 - ExecuteWorkItemStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 767e9c1c-2a7f-4f6a-af03-bf0e45168f41
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2021 - ExecuteWorkItemStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2021|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ExecuteWorkItem が実行を開始していることを示します。  
+  
+## メッセージ  
+ 作業項目の実行を開始します  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2022-executeworkitemstop.md b/docs/framework/windows-workflow-foundation/2022-executeworkitemstop.md
new file mode 100644
index 00000000000..0a1efe513dc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2022-executeworkitemstop.md
@@ -0,0 +1,37 @@
+---
+title: "2022 - ExecuteWorkItemStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 731a6355-3a33-46c5-9830-00b44a665812
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2022 - ExecuteWorkItemStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2022|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ExecuteWorkItem が完了したことを示します。  
+  
+## メッセージ  
+ 作業項目の実行を停止します  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2023-sendmessagechannelcachemiss.md b/docs/framework/windows-workflow-foundation/2023-sendmessagechannelcachemiss.md
new file mode 100644
index 00000000000..b13b0e07d20
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2023-sendmessagechannelcachemiss.md
@@ -0,0 +1,37 @@
+---
+title: "2023 - SendMessageChannelCacheMiss | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93b5f0fa-c09e-4252-91b1-898ead4d0f2d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2023 - SendMessageChannelCacheMiss
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2023|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SendMessageChannelCache のキャッシュ ミスを示します。  
+  
+## メッセージ  
+ SendMessageChannelCache ミス  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2024-internalcachemetadatastart.md b/docs/framework/windows-workflow-foundation/2024-internalcachemetadatastart.md
new file mode 100644
index 00000000000..92445e2734b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2024-internalcachemetadatastart.md
@@ -0,0 +1,38 @@
+---
+title: "2024 - InternalCacheMetadataStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 18758528-6d3b-4d25-9427-12d2d3f4ec4e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2024 - InternalCacheMetadataStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2024|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティの InternalCacheMetadata の開始を示します。  
+  
+## メッセージ  
+ アクティビティ '%1' で InternalCacheMetadata が開始されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2025-internalcachemetadatastop.md b/docs/framework/windows-workflow-foundation/2025-internalcachemetadatastop.md
new file mode 100644
index 00000000000..15b00c6eb65
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2025-internalcachemetadatastop.md
@@ -0,0 +1,38 @@
+---
+title: "2025 - InternalCacheMetadataStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88e6dbcd-1c41-40a3-9800-4c60eca7d11d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2025 - InternalCacheMetadataStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2025|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティの InternalCacheMetadata の完了を示します。  
+  
+## メッセージ  
+ アクティビティ '%1' で InternalCacheMetadata が停止されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2026-compilevbexpressionstart.md b/docs/framework/windows-workflow-foundation/2026-compilevbexpressionstart.md
new file mode 100644
index 00000000000..6dca2786b14
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2026-compilevbexpressionstart.md
@@ -0,0 +1,38 @@
+---
+title: "2026 - CompileVbExpressionStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: daad57eb-8198-49b5-9920-aa0e7428ccf1
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2026 - CompileVbExpressionStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2026|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ VB の式のコンパイルの開始を示します。  
+  
+## メッセージ  
+ VB の式 '%1' をコンパイルしています  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|式|xs:string|コンパイルする VisualBasic 式。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2027-cacherootmetadatastart.md b/docs/framework/windows-workflow-foundation/2027-cacherootmetadatastart.md
new file mode 100644
index 00000000000..f039d97881f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2027-cacherootmetadatastart.md
@@ -0,0 +1,38 @@
+---
+title: "2027 - CacheRootMetadataStart | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1421a473-c99e-45bb-b1ab-6a9f8da6fcd2
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2027 - CacheRootMetadataStart
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2027|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティの CacheRootMetadata の開始を示します。  
+  
+## メッセージ  
+ アクティビティ '%1' で CacheRootMetadata が開始されました  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2028-cacherootmetadatastop.md b/docs/framework/windows-workflow-foundation/2028-cacherootmetadatastop.md
new file mode 100644
index 00000000000..60c0e2fd0bc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2028-cacherootmetadatastop.md
@@ -0,0 +1,38 @@
+---
+title: "2028 - CacheRootMetadataStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d799b707-ee16-4b04-8b6d-b87c0d60e71d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2028 - CacheRootMetadataStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2028|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ アクティビティの CacheRootMetadata の完了を示します。  
+  
+## メッセージ  
+ アクティビティ %1 で CacheRootMetadata が停止されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2029-compilevbexpressionstop.md b/docs/framework/windows-workflow-foundation/2029-compilevbexpressionstop.md
new file mode 100644
index 00000000000..8b7c79b02d6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2029-compilevbexpressionstop.md
@@ -0,0 +1,37 @@
+---
+title: "2029 - CompileVbExpressionStop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f0752c88-61f9-4579-81a1-d804fbc000a9
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2029 - CompileVbExpressionStop
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2029|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ VB の式のコンパイルの完了を示します。  
+  
+## メッセージ  
+ VB の式のコンパイルが完了しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/225-tracecorrelationkeys.md b/docs/framework/windows-workflow-foundation/225-tracecorrelationkeys.md
new file mode 100644
index 00000000000..08fc1eb054a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/225-tracecorrelationkeys.md
@@ -0,0 +1,41 @@
+---
+title: "225 - TraceCorrelationKeys | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d9083aaf-3816-4c1c-bae0-2d7f49628345
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 225 - TraceCorrelationKeys
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|225|  
+|キーワード|Troubleshooting、ServiceModel|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ このイベントは、ワークフロー サービスでコンテンツ ベースの相関関係が使用されるときに生成されます。これには、メッセージとインスタンスの相関関係を定義するために適用されている相関関係キーが含まれます。  
+  
+## メッセージ  
+ 親スコープ '%3' の値 '%2' を使用して相関関係キー '%1' が計算されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Instance Key|`xs:GUID`|相関関係値から生成されたキー。|  
+|Values|`xs:string`|相関関係インスタンス キーの計算に使用された値。|  
+|Parent Scope|`xs:string`||  
+|HostReference|`xs:string`|Web ホスト サービスの場合は、このフィールドにより、サービスが Web 階層内で一意に識別されます。その形式は、'Web サイト名アプリケーション仮想パス&#124;サービス仮想パス&#124;サービス名' と定義されます。例: 'Default Web Site\/CalculatorApplication&#124;\/CalculatorService.svc&#124;CalculatorService'。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2576-trycatchexceptionfromtry.md b/docs/framework/windows-workflow-foundation/2576-trycatchexceptionfromtry.md
new file mode 100644
index 00000000000..daa3e62713f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2576-trycatchexceptionfromtry.md
@@ -0,0 +1,39 @@
+---
+title: "2576 - TryCatchExceptionFromTry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 47e48973-b17c-4a16-8338-c84b54aa0a6e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2576 - TryCatchExceptionFromTry
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2576|  
+|キーワード|WFActivities|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TryCatch アクティビティが例外をキャッチしたことを示します。  
+  
+## メッセージ  
+ TryCatch アクティビティ '%1' は、型 '%2' の例外をキャッチしました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|例外|xs:string|例外の型名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2577-trycatchexceptionduringcancelation.md b/docs/framework/windows-workflow-foundation/2577-trycatchexceptionduringcancelation.md
new file mode 100644
index 00000000000..96b293501b2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2577-trycatchexceptionduringcancelation.md
@@ -0,0 +1,38 @@
+---
+title: "2577 - TryCatchExceptionDuringCancelation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 35ee9f55-227f-4566-bcb4-4c7c75dea85b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2577 - TryCatchExceptionDuringCancelation
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2577|  
+|キーワード|WFActivities|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TryCatch アクティビティの子アクティビティが取り消し中に例外をスローしたことを示します。  
+  
+## メッセージ  
+ TryCatch アクティビティ '%1' の子アクティビティは取り消し中に例外をスローしました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/2578-trycatchexceptionfromcatchorfinally.md b/docs/framework/windows-workflow-foundation/2578-trycatchexceptionfromcatchorfinally.md
new file mode 100644
index 00000000000..1af04db2c72
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/2578-trycatchexceptionfromcatchorfinally.md
@@ -0,0 +1,38 @@
+---
+title: "2578 - TryCatchExceptionFromCatchOrFinally | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4803fee6-b8d8-4937-9907-d5c5fd5299db
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 2578 - TryCatchExceptionFromCatchOrFinally
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|2578|  
+|キーワード|WFActivities|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ Catch または Finally アクティビティから例外がスローされたことを示します。  
+  
+## メッセージ  
+ TryCatch アクティビティ '%1' に関連付けられている Catch または Finally アクティビティは例外をスローしました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|DisplayName|xs:string|アクティビティの表示名。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3501-inferredcontractdescription.md b/docs/framework/windows-workflow-foundation/3501-inferredcontractdescription.md
new file mode 100644
index 00000000000..f573abc6425
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3501-inferredcontractdescription.md
@@ -0,0 +1,39 @@
+---
+title: "3501 - InferredContractDescription | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 21a70849-4fc0-41d2-b9a4-db5aa2acdf1a
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3501 - InferredContractDescription
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3501|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ ContractDescription が WorkflowService から推論されたことを示します。  
+  
+## メッセージ  
+ Name\='%1' で Namespace\='%2' の ContractDescription が WorkflowService から推論されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|名前|xs:string|ContractDescription の名前。|  
+|Namespace|xs:string|ContractDescription の名前空間。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3502-inferredoperationdescription.md b/docs/framework/windows-workflow-foundation/3502-inferredoperationdescription.md
new file mode 100644
index 00000000000..27db9718b74
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3502-inferredoperationdescription.md
@@ -0,0 +1,40 @@
+---
+title: "3502 - InferredOperationDescription | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6aebb614-3c72-4537-ba11-3cc7200ef1f1
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3502 - InferredOperationDescription
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3502|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ OperationDescription が WorkflowService から推論されたことを示します。  
+  
+## メッセージ  
+ コントラクト '%2' 内の Name\='%1' の OperationDescription が WorkflowService から推論されました。  IsOneWay\=%3。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|OperationName|xs:string|操作の名前。|  
+|ContractName|xs:string|コントラクトの名前。|  
+|IsOneWay|xs:string|True または False はコントラクトが一方向かどうかを示します。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3503-duplicatecorrelationquery.md b/docs/framework/windows-workflow-foundation/3503-duplicatecorrelationquery.md
new file mode 100644
index 00000000000..be3bcb3b8fc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3503-duplicatecorrelationquery.md
@@ -0,0 +1,38 @@
+---
+title: "3503 - DuplicateCorrelationQuery | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b857f8e6-ce4d-4da4-bc9d-6cd63fa558a4
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3503 - DuplicateCorrelationQuery
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3503|  
+|キーワード|WFServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ 重複する CorrelationQuery が見つかったことを示します。  相関の計算時には、重複するクエリは使用されません。  
+  
+## メッセージ  
+ Where\='%1' で重複する CorrelationQuery が見つかりました。  相関の計算時には、この重複するクエリは使用されません。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Where|xs:string|関連付けクエリの Where 部分。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3507-serviceendpointadded.md b/docs/framework/windows-workflow-foundation/3507-serviceendpointadded.md
new file mode 100644
index 00000000000..aa51c6f6ec5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3507-serviceendpointadded.md
@@ -0,0 +1,40 @@
+---
+title: "3507 - ServiceEndpointAdded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c068fc0e-07ee-4551-9824-ea7216e1fe37
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3507 - ServiceEndpointAdded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3507|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ サービス エンドポイントが追加されていることを示します。  
+  
+## メッセージ  
+ アドレス '%1'、バインド '%2'、コントラクト '%3' のサービス エンドポイントが追加されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Address|xs:string|エンドポイントのアドレス。|  
+|バインディング|xs:string|エンドポイントのバインド。|  
+|コントラクト|xs:string|エンドポイントのコントラクト。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3508-trackingprofilenotfound.md b/docs/framework/windows-workflow-foundation/3508-trackingprofilenotfound.md
new file mode 100644
index 00000000000..a11ca5d3324
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3508-trackingprofilenotfound.md
@@ -0,0 +1,39 @@
+---
+title: "3508 - TrackingProfileNotFound | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4cee3c4a-0490-4c94-aa19-ef7ce7287c02
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3508 - TrackingProfileNotFound
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3508|  
+|キーワード|WFServices|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ 構成ファイル内に TrackingProfile がないか、または ActivityDefinitionId がプロファイルと一致していないことを示します。  
+  
+## メッセージ  
+ ActivityDefinitionId '%2' の TrackingProfile '%1' が見つかりません。  config ファイルに TrackingProfile がないか、ActivityDefinitionId が一致しません。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TrackingProfile|xs:string|追跡プロファイルの名前。|  
+|ActivityDefinitionId|xs:string|アクティビティ定義 ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3550-bufferoutofordermessagenoinstance.md b/docs/framework/windows-workflow-foundation/3550-bufferoutofordermessagenoinstance.md
new file mode 100644
index 00000000000..946f27de2b6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3550-bufferoutofordermessagenoinstance.md
@@ -0,0 +1,38 @@
+---
+title: "3550 - BufferOutOfOrderMessageNoInstance | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1299d294-99b8-430e-98b1-55f5f17002f3
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3550 - BufferOutOfOrderMessageNoInstance
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3550|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ バッファーされた受信機能が失敗したことを示します。  サービス インスタンスがこの特定の操作を処理する準備が整った場合、操作が再試行されます。  
+  
+## メッセージ  
+ 操作 '%1' は現時点では実行できません。  サービス インスタンスがこの特定の操作を処理できる状態になったとき、もう一度試行されます。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|OperationName|xs:string|操作の名前。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3551-bufferoutofordermessagenobookmark.md b/docs/framework/windows-workflow-foundation/3551-bufferoutofordermessagenobookmark.md
new file mode 100644
index 00000000000..81af1d4d33c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3551-bufferoutofordermessagenobookmark.md
@@ -0,0 +1,39 @@
+---
+title: "3551 - BufferOutOfOrderMessageNoBookmark | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7930d6c4-c843-4a83-933a-cecd71b80d1e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3551 - BufferOutOfOrderMessageNoBookmark
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3551|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ ブックマークの再開が失敗したことを示します。  サービス インスタンスがこの特定の操作を処理する準備が整ったら、バッファーされた受信操作が再試行されます。  
+  
+## メッセージ  
+ サービス インスタンス '%1' での操作 '%2' は現時点では実行できません。  サービス インスタンスがこの特定の操作を処理できる状態になったとき、もう一度試行されます。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|OperationName|xs:string|操作の名前。|  
+|ServiceInstanceId|xs:string|サービス インスタンスの ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3552-maxpendingmessagesperchannelexceeded.md b/docs/framework/windows-workflow-foundation/3552-maxpendingmessagesperchannelexceeded.md
new file mode 100644
index 00000000000..a94d821d19b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3552-maxpendingmessagesperchannelexceeded.md
@@ -0,0 +1,38 @@
+---
+title: "3552 - MaxPendingMessagesPerChannelExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc8309d9-eb3a-4636-a6f0-dd0018c1361d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 3552 - MaxPendingMessagesPerChannelExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3552|  
+|キーワード|クォータ、WFServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ スロットル 'MaxPendingMessagesPerChannel' の制限に達したことを示します。  
+  
+## メッセージ  
+ '%1' のスロットル 'MaxPendingMessagesPerChannel' の制限に達しました。  この制限を引き上げるには、BufferedReceiveServiceBehavior の MaxPendingMessagesPerChannel プロパティを調整してください。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Limit|xs:string|MaxPendingMessagesPerChannel スロットルの制限。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/3557-transactedreceivescopeendcommitfailed.md b/docs/framework/windows-workflow-foundation/3557-transactedreceivescopeendcommitfailed.md
new file mode 100644
index 00000000000..f63ab958dbe
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/3557-transactedreceivescopeendcommitfailed.md
@@ -0,0 +1,39 @@
+---
+title: "3557 - TransactedReceiveScopeEndCommitFailed | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 079f0188-8146-49ee-b6ae-a08f4e4d2b9b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 3557 - TransactedReceiveScopeEndCommitFailed
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|3557|  
+|キーワード|WFServices|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ CommittableTransaction の EndCommit への呼び出しが TransactionException をスローしたことを示します。  
+  
+## メッセージ  
+ id \= '%1' の CommittableTransaction に対する EndCommit への呼び出しにより、次のメッセージと共に TransactionException がスローされました: '%2'。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|TransactionId|xs:string|CommittableTransaction の ID。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/39456-trackingrecorddropped.md b/docs/framework/windows-workflow-foundation/39456-trackingrecorddropped.md
new file mode 100644
index 00000000000..a1e3d1655ac
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/39456-trackingrecorddropped.md
@@ -0,0 +1,38 @@
+---
+title: "39456 - TrackingRecordDropped | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: da13d5bc-1736-47a4-b3fd-064ca8040326
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 39456 - TrackingRecordDropped
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|39456|  
+|キーワード|WFTracking|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ サイズが ETW セッション プロバイダーによって許可される最大値を超えているため、追跡レコードが削除されたことを示します。  
+  
+## メッセージ  
+ 追跡レコード %1 のサイズが、プロバイダー %2 の ETW セッションで許可される最大サイズを超えています  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/39457-trackingrecordraised.md b/docs/framework/windows-workflow-foundation/39457-trackingrecordraised.md
new file mode 100644
index 00000000000..4a9deeef3f1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/39457-trackingrecordraised.md
@@ -0,0 +1,39 @@
+---
+title: "39457 - TrackingRecordRaised | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a2731d1-c731-4b79-bb69-016cb69ef481
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 39457 - TrackingRecordRaised
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|39457|  
+|キーワード|WFRuntime|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ TrackingRecord が TrackingParticipant に発生したことを示します。  
+  
+## メッセージ  
+ 追跡レコード %1 が %2 になりました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|RecordNumber|xs:string|追跡レコード番号。|  
+|ParticipantId|xs:string|追跡参加要素|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/39458-trackingrecordtruncated.md b/docs/framework/windows-workflow-foundation/39458-trackingrecordtruncated.md
new file mode 100644
index 00000000000..3cb5256d563
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/39458-trackingrecordtruncated.md
@@ -0,0 +1,39 @@
+---
+title: "39458 - TrackingRecordTruncated | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5352f0eb-d571-454a-bab5-e2162888b218
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 39458 - TrackingRecordTruncated
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|39458|  
+|キーワード|WFTracking|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 追跡レコードが省略されたことを示します。  変数、注釈、ユーザー データは削除されています。  
+  
+## メッセージ  
+ プロバイダー %2 の ETW セッションに書き込まれた追跡レコード %1 が切り捨てられました。  変数\/注釈\/ユーザー データは削除されました  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|RecordNumber|xs:string|追跡レコード番号。|  
+|ProviderId|xs:string|ETW プロバイダー ID。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/39459-trackingdataextracted.md b/docs/framework/windows-workflow-foundation/39459-trackingdataextracted.md
new file mode 100644
index 00000000000..c23e6250b4f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/39459-trackingdataextracted.md
@@ -0,0 +1,39 @@
+---
+title: "39459 - TrackingDataExtracted | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fcf7be96-8a7b-4ae1-bf38-b77ea9ebfb6b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 39459 - TrackingDataExtracted
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|39459|  
+|キーワード|WFRuntime|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 追跡データがアクティビティで抽出されたことを示します。  
+  
+## メッセージ  
+ 追跡データ %1 がアクティビティ %2 で抽出されました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|データ|xs:string|抽出されたデータ名。|  
+|アクティビティ|xs:string|アクティビティの名前。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/39460-trackingvaluenotserializable.md b/docs/framework/windows-workflow-foundation/39460-trackingvaluenotserializable.md
new file mode 100644
index 00000000000..32949ada1e2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/39460-trackingvaluenotserializable.md
@@ -0,0 +1,38 @@
+---
+title: "39460 - TrackingValueNotSerializable | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 476a29ad-24d8-4359-8c17-d4e20c1e1c15
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 39460 - TrackingValueNotSerializable
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|39460|  
+|キーワード|WFTracking|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 追跡レコード内の抽出された引数または変数をシリアル化できないことを示します。  
+  
+## メッセージ  
+ 抽出された引数\/変数 '%1' はシリアル化できません。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|名前|xs:string|項目の名前。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4201-endsqlcommandexecute.md b/docs/framework/windows-workflow-foundation/4201-endsqlcommandexecute.md
new file mode 100644
index 00000000000..e927080966a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4201-endsqlcommandexecute.md
@@ -0,0 +1,38 @@
+---
+title: "4201 - EndSqlCommandExecute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae0dbc15-f98c-4096-a8d9-fbe4dc36f1cd
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4201 - EndSqlCommandExecute
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4201|  
+|キーワード|WFInstanceStore|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL コマンドの実行が完了したことを示します。  
+  
+## メッセージ  
+ SQL コマンドの実行を終了します: %1  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|SqlCommand|xs:string|実行された SQL コマンド。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4202-startsqlcommandexecute.md b/docs/framework/windows-workflow-foundation/4202-startsqlcommandexecute.md
new file mode 100644
index 00000000000..20ec29990b9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4202-startsqlcommandexecute.md
@@ -0,0 +1,38 @@
+---
+title: "4202 - StartSqlCommandExecute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4559f64f-c824-4075-9e7e-4710bf30f805
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4202 - StartSqlCommandExecute
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4202|  
+|キーワード|WFInstanceStore|  
+|レベル|詳細|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL コマンドが実行されることを示します。  
+  
+## メッセージ  
+ SQL コマンドの実行を開始します: %1  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|SqlCommand|xs:string|実行された SQL コマンド。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4203-renewlocksystemerror.md b/docs/framework/windows-workflow-foundation/4203-renewlocksystemerror.md
new file mode 100644
index 00000000000..599b965d0bf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4203-renewlocksystemerror.md
@@ -0,0 +1,37 @@
+---
+title: "4203 - RenewLockSystemError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6ec9ec6f-4ae2-45cf-b99b-02cdb9dc9ec9
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4203 - RenewLockSystemError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4203|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ ロックの有効期限が既に過ぎているか、またはロック所有者が削除されたために、SQL プロバイダーはロックの有効期限を延長できなかったことを示します。  SqlWorkflowInstanceStore は中止されます。  
+  
+## メッセージ  
+ ロックの有効期限を延長できませんでした。ロックの有効期限が既に過ぎているか、ロックの所有者が削除されました。  SqlWorkflowInstanceStore を中止します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4205-foundprocessingerror.md b/docs/framework/windows-workflow-foundation/4205-foundprocessingerror.md
new file mode 100644
index 00000000000..a0698432b98
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4205-foundprocessingerror.md
@@ -0,0 +1,39 @@
+---
+title: "4205 - FoundProcessingError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2235a15-dd87-439e-8cb9-8b1b89a3dacf
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4205 - FoundProcessingError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4205|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL プロバイダー コマンドが失敗したことを示します。  
+  
+## メッセージ  
+ コマンドが失敗しました: %1  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ExceptionMessage|xs:string|SQL 例外からのメッセージ。|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4206-unlockinstanceexception.md b/docs/framework/windows-workflow-foundation/4206-unlockinstanceexception.md
new file mode 100644
index 00000000000..7cbb4695440
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4206-unlockinstanceexception.md
@@ -0,0 +1,38 @@
+---
+title: "4206 - UnlockInstanceException | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5a46dc5f-d517-4135-8905-25a42f01206b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4206 - UnlockInstanceException
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4206|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ インスタンスのロックを解除しようとしているときに例外が発生したことを示します。  
+  
+## メッセージ  
+ インスタンスのロックを解除しようとして、例外 %1 が発生しました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ExceptionMessage|xs:string|SQL 例外からのメッセージ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4207-maximumretriesexceededforsqlcommand.md b/docs/framework/windows-workflow-foundation/4207-maximumretriesexceededforsqlcommand.md
new file mode 100644
index 00000000000..ac849f8e569
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4207-maximumretriesexceededforsqlcommand.md
@@ -0,0 +1,37 @@
+---
+title: "4207 - MaximumRetriesExceededForSqlCommand | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8c8bee26-9ad4-4e01-bd16-0e1fd510fb6b
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 4207 - MaximumRetriesExceededForSqlCommand
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4207|  
+|キーワード|クオータ、WFInstanceStore|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 再試行が最大実行回数実行されたので、SQL プロバイダーは SQL コマンドの再試行を停止しようとしていることを示します。  
+  
+## メッセージ  
+ SQL コマンドが最大実行回数実行されたので、この SQL コマンドの再試行を停止します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4208-retryingsqlcommandduetosqlerror.md b/docs/framework/windows-workflow-foundation/4208-retryingsqlcommandduetosqlerror.md
new file mode 100644
index 00000000000..028cba85af8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4208-retryingsqlcommandduetosqlerror.md
@@ -0,0 +1,38 @@
+---
+title: "4208 - RetryingSqlCommandDueToSqlError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a8e6483a-a6e4-4bbf-82ec-cd8b6e711aad
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4208 - RetryingSqlCommandDueToSqlError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4208|  
+|キーワード|WFInstanceStore|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL プロバイダーは SQL エラーのために SQL コマンドを再試行していることを示します。  
+  
+## メッセージ  
+ SQL エラー番号 %1 のため、SQL コマンドを再試行します。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ErrorNumber|xs:string|SQL エラー番号。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4209-timeoutopeningsqlconnection.md b/docs/framework/windows-workflow-foundation/4209-timeoutopeningsqlconnection.md
new file mode 100644
index 00000000000..5bfe5bcf604
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4209-timeoutopeningsqlconnection.md
@@ -0,0 +1,38 @@
+---
+title: "4209 - TimeoutOpeningSqlConnection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f0e56518-9758-41dc-a760-50d1a10fba6e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4209 - TimeoutOpeningSqlConnection
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4209|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL 接続を開こうとしてタイムアウトが発生したことを示します。  
+  
+## メッセージ  
+ SQL 接続を開こうとしてタイムアウトしました。  割り当てられたタイムアウト時間 %1 内に操作が完了しませんでした。  この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Timeout|xs:string|SQL 接続を開く場合のタイムアウト値。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4210-sqlexceptioncaught.md b/docs/framework/windows-workflow-foundation/4210-sqlexceptioncaught.md
new file mode 100644
index 00000000000..176b100bc61
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4210-sqlexceptioncaught.md
@@ -0,0 +1,39 @@
+---
+title: "4210 - SqlExceptionCaught | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f0ce8af3-eb4c-48c8-b3d9-dd2f94b5574b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4210 - SqlExceptionCaught
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4210|  
+|キーワード|WFInstanceStore|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL 例外が発生したことを示します。  
+  
+## メッセージ  
+ SQL 例外番号 %1 メッセージ %2 がキャッチされました。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ErrorNumber|xs:string|SQL エラー番号。|  
+|ExceptionMessage|xs:string|SQL 例外からのメッセージ。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4211-queuingsqlretry.md b/docs/framework/windows-workflow-foundation/4211-queuingsqlretry.md
new file mode 100644
index 00000000000..23c484a1219
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4211-queuingsqlretry.md
@@ -0,0 +1,38 @@
+---
+title: "4211 - QueuingSqlRetry | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: df569f88-c86b-4503-840d-1399b67f4df7
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4211 - QueuingSqlRetry
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4211|  
+|キーワード|WFInstanceStore|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL の再試行をキューに登録していることを示します。  
+  
+## メッセージ  
+ %1 ミリ秒の遅延で SQL の再試行をキューに登録しています。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Delay|xs:string|再試行の遅延。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4212-lockretrytimeout.md b/docs/framework/windows-workflow-foundation/4212-lockretrytimeout.md
new file mode 100644
index 00000000000..c20420d3a14
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4212-lockretrytimeout.md
@@ -0,0 +1,38 @@
+---
+title: "4212 - LockRetryTimeout | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d4ad415a-9871-49fc-85b8-8ee2ea149b1d
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4212 - LockRetryTimeout
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4212|  
+|キーワード|WFInstanceStore|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ SQL プロバイダーはインスタンス ロックを取得しようとしてタイムアウトを検出しました。  
+  
+## メッセージ  
+ インスタンスのロックを取得しようとしてタイムアウトが発生しました。%1 の割り当てられたタイムアウト時間内に操作が完了しませんでした。  この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Delay|xs:string|再試行の遅延。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4213-runnableinstancesdetectionerror.md b/docs/framework/windows-workflow-foundation/4213-runnableinstancesdetectionerror.md
new file mode 100644
index 00000000000..d5ac7ff8d21
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4213-runnableinstancesdetectionerror.md
@@ -0,0 +1,38 @@
+---
+title: "4213 - RunnableInstancesDetectionError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 979ec935-bd9f-4798-be9a-25e08c4b94cf
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4213 - RunnableInstancesDetectionError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4213|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ 実行可能インスタンスの検出は例外のために失敗しました  
+  
+## メッセージ  
+ 実行可能インスタンスの検出は次の例外のために失敗しました  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/4214-instancelocksrecoveryerror.md b/docs/framework/windows-workflow-foundation/4214-instancelocksrecoveryerror.md
new file mode 100644
index 00000000000..1a6c77e0b60
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/4214-instancelocksrecoveryerror.md
@@ -0,0 +1,38 @@
+---
+title: "4214 - InstanceLocksRecoveryError | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d28fb2d5-bf15-4648-8d20-8141ad16f04b
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 4214 - InstanceLocksRecoveryError
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|4214|  
+|キーワード|WFInstanceStore|  
+|レベル|Error|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Debug|  
+  
+## 説明  
+ インスタンスのロックの回復は例外のために失敗しました。  
+  
+## メッセージ  
+ インスタンスのロックの回復は次の例外のために失敗しました  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|例外|xs:string|例外の詳細|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/440-startsignpostevent.md b/docs/framework/windows-workflow-foundation/440-startsignpostevent.md
new file mode 100644
index 00000000000..9617f951c7a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/440-startsignpostevent.md
@@ -0,0 +1,38 @@
+---
+title: "440 - StartSignpostEvent1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27b551b5-ae76-49f8-bab8-6300009eb4c1
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 440 - StartSignpostEvent1
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|440|  
+|キーワード|Troubleshooting|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ アクティビティ トレースでは、送信または受信においてメッセージがアクティビティの境界を越え始めたことを示します。  
+  
+## Message  
+ アクティビティの境界。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|ExtendedData|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/441-stopsignpostevent.md b/docs/framework/windows-workflow-foundation/441-stopsignpostevent.md
new file mode 100644
index 00000000000..a054cac8707
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/441-stopsignpostevent.md
@@ -0,0 +1,38 @@
+---
+title: "441- StopSignpostEvent1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc9850a5-0dc3-4b84-a09a-744301c7c18e
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 441- StopSignpostEvent1
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|441|  
+|キーワード|トラブルシューティング|  
+|レベル|情報|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ アクティビティ トレースでは、送信または受信におけるアクティビティの境界をメッセージが越えたことを示します。  
+  
+## Message  
+ アクティビティの境界。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|Extended Data|`xs:string`|アクティビティの名前。|  
+|AppDomain|`xs:string`|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/57398-maxinstancesexceeded.md b/docs/framework/windows-workflow-foundation/57398-maxinstancesexceeded.md
new file mode 100644
index 00000000000..563d5c1cdef
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/57398-maxinstancesexceeded.md
@@ -0,0 +1,38 @@
+---
+title: "57398 - MaxInstancesExceeded | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f943d209-dfeb-43e5-b572-c9a06217936e
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# 57398 - MaxInstancesExceeded
+## プロパティ  
+  
+|||  
+|-|-|  
+|ID|57398|  
+|キーワード|WFServices|  
+|レベル|警告|  
+|チャネル|Microsoft\-Windows\-Application Server\-Applications\/Analytic|  
+  
+## 説明  
+ システムがスロットル 'MaxConcurrentInstances' に設定された制限に達したことを示します。  
+  
+## メッセージ  
+ システムはスロットル 'MaxConcurrentInstances' に設定された制限に達しました。  このスロットルの制限は %1 に設定されました。  スロットル値を変更するには、serviceThrottle 要素の属性 'maxConcurrentInstances' を変更するか、動作 ServiceThrottlingBehavior の 'MaxConcurrentInstances' プロパティを変更する必要があります。  
+  
+## 詳細  
+  
+|データ項目名|データ項目の型|説明|  
+|------------|-------------|--------|  
+|名前|xs:string|項目の名前。|  
+|AppDomain|xs:string|AppDomain.CurrentDomain.FriendlyName で返される文字列。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/TOC.md b/docs/framework/windows-workflow-foundation/TOC.md
new file mode 100644
index 00000000000..3454f56b676
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/TOC.md
@@ -0,0 +1,264 @@
+# [39459 - TrackingDataExtracted](39459-trackingdataextracted.md)
+# [441- StopSignpostEvent1](441-stopsignpostevent.md)
+# [3552 - MaxPendingMessagesPerChannelExceeded](3552-maxpendingmessagesperchannelexceeded.md)
+# [1023 - CompleteBookmarkWorkItem](1023-completebookmarkworkitem.md)
+# [Windows Workflow の概要](overview.md)
+# [トランザクション](transaction-activities-in-wf.md)
+# [57398 - MaxInstancesExceeded](57398-maxinstancesexceeded.md)
+# [ホストのロック更新時間](host-lock-renewal-period.md)
+# [永続参加要素](persistence-participants.md)
+# [ワークフローを実行する方法](how-to-run-a-workflow.md)
+# [106 - CancelRequestRecord](106-cancelrequestrecord.md)
+# [Windows Workflow Foundation プログラミングの新機能](programming.md)
+# [113 - WorkflowInstanceTerminatedRecord](113-workflowinstanceterminatedrecord.md)
+# [1007 - WorkflowApplicationPersisted](1007-workflowapplicationpersisted.md)
+# [インスタンス ストア](instance-stores.md)
+# [4205 - FoundProcessingError](4205-foundprocessingerror.md)
+# [追跡参加要素](tracking-participants.md)
+# [4209 - TimeoutOpeningSqlConnection](4209-timeoutopeningsqlconnection.md)
+# [4210 - SqlExceptionCaught](4210-sqlexceptioncaught.md)
+# [2029 - CompileVbExpressionStop](2029-compilevbexpressionstop.md)
+# [トレースを使用したワークフロー実行時間の決定](determining-workflow-execution-duration-using-tracing.md)
+# [1004 - WorkflowInstanceAborted](1004-workflowinstanceaborted.md)
+# [100 - WorkflowInstanceRecord](100-workflowinstancerecord.md)
+# [1131 - InvokeMethodUseAsyncPattern](1131-invokemethoduseasyncpattern.md)
+# [1150 - CompensationState](1150-compensationstate.md)
+# [1125 - InvokeMethodIsNotStatic](1125-invokemethodisnotstatic.md)
+# [非同期アクティビティ内のエラー処理](error-handling-in-asynchronous-activities.md)
+# [Windows Workflow Foundation の機能仕様](feature-specifics.md)
+# [フローチャート](flowchart-activities-in-wf.md)
+# [117 - WorkflowInstanceTerminatedRecordWithId](117-workflowinstanceterminatedrecordwithid.md)
+# [コントラクト優先ワークフロー サービスの開発](contract-first-workflow-service-development.md)
+# [ランタイム](runtime-activities-in-wf.md)
+# [ビルトイン アクティビティ ライブラリ](net-framework-4-5-built-in-activity-library.md)
+# [1011 - ScheduleExecuteActivityWorkItem](1011-scheduleexecuteactivityworkitem.md)
+# [アクティビティ デリゲートの使用](using-activity-delegates.md)
+# [1024 - CreateBookmarkScope](1024-createbookmarkscope.md)
+# [1030 - StartFaultWorkItem](1030-startfaultworkitem.md)
+# [1006 - WorkflowApplicationUnhandledException](1006-workflowapplicationunhandledexception.md)
+# [4211 - QueuingSqlRetry](4211-queuingsqlretry.md)
+# [2026 - CompileVbExpressionStart](2026-compilevbexpressionstart.md)
+# [39456 - TrackingRecordDropped](39456-trackingrecorddropped.md)
+# [225 - TraceCorrelationKeys](225-tracecorrelationkeys.md)
+# [2028 - CacheRootMetadataStop](2028-cacherootmetadatastop.md)
+# [ワークフローのセキュリティ](workflow-security.md)
+# [Windows Workflow Foundation の拡張](extend.md)
+# [Windows Workflow Foundation のデータ モデル](data-model.md)
+# [4212 - LockRetryTimeout](4212-lockretrytimeout.md)
+# [取り消し](modeling-cancellation-behavior-in-workflows.md)
+# [111 - CustomTrackingRecordError](111-customtrackingrecorderror.md)
+# [1036 - RuntimeTransactionCompletionRequested](1036-runtimetransactioncompletionrequested.md)
+# [4214 - InstanceLocksRecoveryError](4214-instancelocksrecoveryerror.md)
+# [1010 - ActivityCompleted](1010-activitycompleted.md)
+# [1143 - FlowchartNextNull](1143-flowchartnextnull.md)
+# [変数と引数](variables-and-arguments.md)
+# [CodeActivity 基本クラス](workflow-activity-authoring-using-the-codeactivity-class.md)
+# [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](authoring-workflows-activities-and-expressions-using-imperative-code.md)
+# [WorkflowInvoker と WorkflowApplication の使用](using-workflowinvoker-and-workflowapplication.md)
+# [アクティビティ定義のスコープ設定と表示](activity-definition-scoping-and-visibility.md)
+# [移行のガイドライン](migration-guidance.md)
+# [ワークフローとワークフロー サービスの SQL 永続性を有効にする方法](how-to-enable-sql-persistence-for-workflows-and-workflow-services.md)
+# [式](expressions.md)
+# [チュートリアル入門](getting-started-tutorial.md)
+# [追跡イベントのリファレンス](tracking-events-reference.md)
+# [アクティビティを作成する方法](how-to-create-an-activity.md)
+# [3507 - ServiceEndpointAdded](3507-serviceendpointadded.md)
+# [How to: Create and Run a Long Running Workflow](how-to-create-and-run-a-long-running-workflow.md)
+# [ワークフロー デザイナーのホスト変更](rehosting-the-workflow-designer.md)
+# [102 - WorkflowInstanceAbortedRecord](102-workflowinstanceabortedrecord.md)
+# [112 - WorkflowInstanceSuspendedRecord](112-workflowinstancesuspendedrecord.md)
+# [ワークフロー追跡とトレース](workflow-tracking-and-tracing.md)
+# [1124 - InvokeMethodIsStatic](1124-invokemethodisstatic.md)
+# [アクティビティ作成オプション](activity-authoring-options-in-wf.md)
+# [3503 - DuplicateCorrelationQuery](3503-duplicatecorrelationquery.md)
+# [WorkflowIdentity と Versioning の使用](using-workflowidentity-and-versioning.md)
+# [1103 - WorkflowActivitySuspend](1103-workflowactivitysuspend.md)
+# [Pick アクティビティ](pick-activity.md)
+# [デバッグのワークフロー](debugging-workflows.md)
+# [方法: インスタンス データ プロパティを逆シリアル化する](how-to-deserialize-instance-data-properties.md)
+# [Flowchart のワークフロー](flowchart-workflows.md)
+# [104 - ActivityScheduledRecord](104-activityscheduledrecord.md)
+# [命令型コードに基づく検証](imperative-code-based-validation.md)
+# [4201 - EndSqlCommandExecute](4201-endsqlcommandexecute.md)
+# [101 - WorkflowInstanceUnhandledExceptionRecord](101-workflowinstanceunhandledexceptionrecord.md)
+# [Windows Workflow Foundation 用語集](glossary.md)
+# [107 -- BookmarkResumptionRecord](107-bookmarkresumptionrecord.md)
+# [ワークフローのホスティング](hosting-workflows.md)
+# [4208 - RetryingSqlCommandDueToSqlError](4208-retryingsqlcommandduetosqlerror.md)
+# [Windows Workflow ドキュメントのガイド](guide-to-the-documentation.md)
+# [1008 - WorkflowApplicationUnloaded](1008-workflowapplicationunloaded.md)
+# [1141 - FlowchartEmpty](1141-flowchartempty.md)
+# [ワークフロー実行プロパティ](workflow-execution-properties.md)
+# [1148 - FlowchartSwitchCaseNotFound](1148-flowchartswitchcasenotfound.md)
+# [.NET Framework 4 ワークフローでの相互運用アクティビティの使用](using-the-interop-activity-in-a-net-framework-4-workflow.md)
+# [ブックマーク](bookmarks.md)
+# [1140 - FlowchartStart](1140-flowchartstart.md)
+# [Windows Workflow Foundation](index.md)
+# [ワークフロー デザイン操作のカスタマイズ](customizing-the-workflow-design-experience.md)
+# [4213 - RunnableInstancesDetectionError](4213-runnableinstancesdetectionerror.md)
+# [1015 - StartCompletionWorkItem](1015-startcompletionworkitem.md)
+# [1041 - WorkflowApplicationPersistableIdle](1041-workflowapplicationpersistableidle.md)
+# [1031 - CompleteFaultWorkItem](1031-completefaultworkitem.md)
+# [1028 - CompleteTransactionContextWorkItem](1028-completetransactioncontextworkitem.md)
+# [1449 - WfMessageReceived](1449-wfmessagereceived.md)
+# [2023 - SendMessageChannelCacheMiss](2023-sendmessagechannelcachemiss.md)
+# [ステート マシン](state-machine-activities-in-wf.md)
+# [インスタンス完了アクション](instance-completion-action.md)
+# [ワークフローの追跡の構成](configuring-tracking-for-a-workflow.md)
+# [変数と引数の追跡](variable-and-argument-tracking.md)
+# [カスタム アクティビティの使用](using-a-custom-activity.md)
+# [アクティビティのローカライズ](activity-localization.md)
+# [プリミティブ](primitives-activities-in-wf.md)
+# [SQL Workflow Instance Store](sql-workflow-instance-store.md)
+# [4207 - MaximumRetriesExceededForSqlCommand](4207-maximumretriesexceededforsqlcommand.md)
+# [動的な更新](dynamic-update.md)
+# [インスタンス エンコーディング オプション](instance-encoding-option.md)
+# [2025 - InternalCacheMetadataStop](2025-internalcachemetadatastop.md)
+# [追跡を使用したアプリケーションのトラブルシューティング](using-tracking-to-troubleshoot-applications.md)
+# [ワークフローを作成する方法](how-to-create-a-workflow.md)
+# [1017 - ScheduleCancelActivityWorkItem](1017-schedulecancelactivityworkitem.md)
+# [1014 - ScheduleCompletionWorkItem](1014-schedulecompletionworkitem.md)
+# [1101 - WorkflowActivityStart](1101-workflowactivitystart.md)
+# [Visual Studio 2010 での .NET Framework 3.0 および 3.5 を対象とするプロジェクトの作成](projects-targeting-dotnet-in-vs.md)
+# [1104 - WorkflowActivityResume](1104-workflowactivityresume.md)
+# [ModelItem 編集コンテキストの使用](using-the-modelitem-editing-context.md)
+# [1040 - InArgumentBound](1040-inargumentbound.md)
+# [ストア拡張](store-extensibility.md)
+# [アクティビティ基本クラス](workflow-activity-authoring-using-the-activity-class.md)
+# [1001 - WorkflowApplicationCompleted](1001-workflowapplicationcompleted.md)
+# [3551 - BufferOutOfOrderMessageNoBookmark](3551-bufferoutofordermessagenobookmark.md)
+# [2021 - ExecuteWorkItemStart](2021-executeworkitemstart.md)
+# [1019 - CompleteCancelActivityWorkItem](1019-completecancelactivityworkitem.md)
+# [1005 - WorkflowApplicationIdled](1005-workflowapplicationidled.md)
+# [セキュリティ](security.md)
+# [2022 - ExecuteWorkItemStop](2022-executeworkitemstop.md)
+# [タスク 3: ツールボックス ペインと PropertyGrid ペインの作成](task-3-create-the-toolbox-and-propertygrid-panes.md)
+# [補正](compensation.md)
+# [Interop アクティビティと .NET Framework 4 内の .NET Framework 3.0 WF アクティビティの使用](net-framework-3-0-wf-in-net-framework-4-interop.md)
+# [4203 - RenewLockSystemError](4203-renewlocksystemerror.md)
+# [3502 - InferredOperationDescription](3502-inferredoperationdescription.md)
+# [永続化のベスト プラクティス](persistence-best-practices.md)
+# [例外、トランザクション、および補正](exceptions-transactions-and-compensation.md)
+# [1018 - StartCancelActivityWorkItem](1018-startcancelactivityworkitem.md)
+# [制御フロー](control-flow-activities-in-wf.md)
+# [Windows Workflow Foundation 4 のパフォーマンス](performance.md)
+# [方法: カスタム アクティビティ テンプレートを作成する](how-to-create-a-custom-activity-template.md)
+# [宣言の制約](declarative-constraints.md)
+# [1038 - EnterNoPersistBlock](1038-enternopersistblock.md)
+# [1003 - WorkflowInstanceCanceled](1003-workflowinstancecanceled.md)
+# [1025 - BookmarkScopeInitialized](1025-bookmarkscopeinitialized.md)
+# [トランザクション](workflow-transactions.md)
+# [非永続化ワークフロー インスタンス](non-persisted-workflow-instances.md)
+# [SQL Workflow Instance Store のプロパティ](properties-of-sql-workflow-instance-store.md)
+# [108 - CustomTrackingRecordInfo](108-customtrackingrecordinfo.md)
+# [方法: 再ホストされたデザイナーの検証エラーを表示する](how-to-display-validation-errors-in-a-rehosted-designer.md)
+# [4206 - UnlockInstanceException](4206-unlockinstanceexception.md)
+# [39457 - TrackingRecordRaised](39457-trackingrecordraised.md)
+# [カスタム インスタンス ストアを作成する方法](how-to-create-a-custom-instance-store.md)
+# [103 - ActivityStateRecord](103-activitystaterecord.md)
+# [1032 - ScheduleRuntimeWorkItem](1032-scheduleruntimeworkitem.md)
+# [39458 - TrackingRecordTruncated](39458-trackingrecordtruncated.md)
+# [シーケンシャル ワークフローを作成する方法](how-to-create-a-sequential-workflow.md)
+# [手続き型ワークフロー](procedural-workflows.md)
+# [追跡レコード](tracking-records.md)
+# [ワークフロー内での入力の待機](waiting-for-input-in-a-workflow.md)
+# [アクティビティ拡張機能の使用](using-activity-extensions.md)
+# [実行可能インスタンス検出期間](runnable-instances-detection-period.md)
+# [1002 - WorkflowApplicationTerminated](1002-workflowapplicationterminated.md)
+# [SQL Server 永続性データベース](sql-server-persistence-database.md)
+# [カスタム アクティビティの設計と実装](designing-and-implementing-custom-activities.md)
+# [3508 - TrackingProfileNotFound](3508-trackingprofilenotfound.md)
+# [必須の引数とオーバーロード グループ](required-arguments-and-overload-groups.md)
+# [1020 - CreateBookmark](1020-createbookmark.md)
+# [Deprecated types in Windows Workflow Foundation](deprecated-types.md)
+# [移行](migration-activity-in-wf.md)
+# [非同期アクティビティの作成](creating-asynchronous-activities-in-wf.md)
+# [2578 - TryCatchExceptionFromCatchOrFinally](2578-trycatchexceptionfromcatchorfinally.md)
+# [2576 - TryCatchExceptionFromTry](2576-trycatchexceptionfromtry.md)
+# [39460 - TrackingValueNotSerializable](39460-trackingvaluenotserializable.md)
+# [接続文字列と接続文字列名](connection-string-and-connection-string-name.md)
+# [1034 - CompleteRuntimeWorkItem](1034-completeruntimeworkitem.md)
+# [4202 - StartSqlCommandExecute](4202-startsqlcommandexecute.md)
+# [1022 - StartBookmarkWorkItem](1022-startbookmarkworkitem.md)
+# [1132 - InvokeMethodDoesNotUseAsyncPattern](1132-invokemethoddoesnotuseasyncpattern.md)
+# [ワークフローの設計](designing-workflows.md)
+# [方法: ステート マシン ワークフローを作成する](how-to-create-a-state-machine-workflow.md)
+# [110 – CustomTrackingRecordWarning](110-customtrackingrecordwarning.md)
+# [1039 - ExitNoPersistBlock](1039-exitnopersistblock.md)
+# [1029 - ScheduleFaultWorkItem](1029-schedulefaultworkitem.md)
+# [ワークフローの永続性](workflow-persistence.md)
+# [116 - WorkflowInstanceSuspendedRecordWithId](116-workflowinstancesuspendedrecordwithid.md)
+# [ワークフロー ホスティングのオプション](workflow-hosting-options.md)
+# [XAML との間のワークフローおよびアクティビティのシリアル化](serializing-workflows-and-activities-to-and-from-xaml.md)
+# [2577 - TryCatchExceptionDuringCancelation](2577-trycatchexceptionduringcancelation.md)
+# [永続性データベース スキーマ](persistence-database-schema.md)
+# [CacheMetadata を使用したデータの公開](exposing-data-with-cachemetadata.md)
+# [ステート マシン ワークフロー](state-machine-workflows.md)
+# [1223 - SwitchCaseNotFound](1223-switchcasenotfound.md)
+# [119 - WorkflowInstanceUpdatedRecord](119-workflowinstanceupdatedrecord.md)
+# [1013 - CompleteExecuteActivityWorkItem](1013-completeexecuteactivityworkitem.md)
+# [1009 - ActivityScheduled](1009-activityscheduled.md)
+# [方法: カスタム アクティビティ デザイナーを作成する](how-to-create-a-custom-activity-designer.md)
+# [デザイナー コントロールへのカスタム アクティビティ プロパティのバインド](binding-a-custom-activity-property-to-a-designer-control.md)
+# [1021 - ScheduleBookmarkWorkItem](1021-schedulebookmarkworkitem.md)
+# [118 - WorkflowInstanceUnhandledExceptionRecordWithId](118-workflowinstanceunhandledexceptionrecordwithid.md)
+# [1037 - RuntimeTransactionComplete](1037-runtimetransactioncomplete.md)
+# [114 - WorkflowInstanceRecordWithId](114-workflowinstancerecordwithid.md)
+# [ワークフローとワークフロー サービスの永続化を有効にする方法](how-to-enable-persistence-for-workflows-and-workflow-services.md)
+# [アクティビティの使用と作成](using-and-creating-activities.md)
+# [Windows Workflow の概念](conceptual-overview.md)
+# [1012 - StartExecuteActivityWorkItem](1012-startexecuteactivityworkitem.md)
+# [方法: 非永続的インスタンスを検索する](how-to-query-for-non-persisted-instances.md)
+# [C# の式](csharp-expressions.md)
+# [1102 - WorkflowActivityStop](1102-workflowactivitystop.md)
+# [カスタムのフロー制御アクティビティの作成](creating-custom-flow-control-activities.md)
+# [440 - StartSignpostEvent1](440-startsignpostevent.md)
+# [1146 - FlowchartSwitchCase](1146-flowchartswitchcase.md)
+# [タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成](task-1-create-a-new-wpf-app.md)
+# [実行中のワークフロー インスタンスの定義を更新する方法](how-to-update-the-definition-of-a-running-workflow-instance.md)
+# [コレクション](collection-activities-in-wf.md)
+# [アクティビティ検証の構成](configuring-activity-validation.md)
+# [NativeActivity の基本クラス](nativeactivity-base-class.md)
+# [エラー処理](error-handling-activities-in-wf.md)
+# [1016 - CompleteCompletionWorkItem](1016-completecompletionworkitem.md)
+# [カスタム追跡レコード](custom-tracking-records.md)
+# [アクティビティ検証の呼び出し](invoking-activity-validation.md)
+# [追跡プロファイル](tracking-profiles.md)
+# [3501 - InferredContractDescription](3501-inferredcontractdescription.md)
+# [移行のガイドライン](migration-guidance.md)
+# [カスタム永続参加要素を作成する方法](how-to-create-a-custom-persistence-participant.md)
+# [Windows Workflow のアーキテクチャ](architecture.md)
+# [カスタム追跡参加要素を作成する方法](how-to-create-a-custom-tracking-participant.md)
+# [ワークフローからの OData フィードの利用](consuming-odata-feeds-from-a-workflow.md)
+# [実行時におけるアクティビティの作成](creating-an-activity-at-runtime-with-dynamicactivity.md)
+# [1450 - WfMessageSent](1450-wfmessagesent.md)
+# [カスタム アクティビティ デザイナーおよびテンプレートの使用](using-custom-activity-designers-and-templates.md)
+# [再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート](wf-features-in-the-rehosted-workflow-designer.md)
+# [.NET 4.5 での Windows Workflow Foundation の新機能](whats-new-in-wf-in-dotnet.md)
+# [2024 - InternalCacheMetadataStart](2024-internalcachemetadatastart.md)
+# [ワークフロー トレース](workflow-tracing.md)
+# [フローチャート ワークフローを作成する方法](how-to-create-a-flowchart-workflow.md)
+# [1033 - StartRuntimeWorkItem](1033-startruntimeworkitem.md)
+# [105 - FaultPropagationRecord](105-faultpropagationrecord.md)
+# [インスタンス ロック例外アクション](instance-locked-exception-action.md)
+# [プロパティと引数](properties-vs-arguments.md)
+# [2027 - CacheRootMetadataStart](2027-cacherootmetadatastart.md)
+# [インスタンスのアクティブ化処理](instance-activation.md)
+# [3550 - BufferOutOfOrderMessageNoInstance](3550-bufferoutofordermessagenoinstance.md)
+# [Windows Workflow Foundation の新機能](whats-new.md)
+# [ワークフローの一時停止と再開](pausing-and-resuming-a-workflow.md)
+# [既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)
+# [1027 - StartTransactionContextWorkItem](1027-starttransactioncontextworkitem.md)
+# [アクティビティ ツリー検査](activity-tree-inspection.md)
+# [Windows Workflow の基本概念](fundamental-concepts.md)
+# [1026 - ScheduleTransactionContextWorkItem](1026-scheduletransactioncontextworkitem.md)
+# [1126 - InvokedMethodThrewException](1126-invokedmethodthrewexception.md)
+# [タスク 2: ワークフロー デザイナーのホスティング](task-2-host-the-workflow-designer.md)
+# [ワークフローの複数のバージョンを同時にホストする方法](how-to-host-multiple-versions-of-a-workflow-side-by-side.md)
+# [クエリのサポート](support-for-queries.md)
+# [カスタム式エディターの使用](using-a-custom-expression-editor.md)
+# [3557 - TransactedReceiveScopeEndCommitFailed](3557-transactedreceivescopeendcommitfailed.md)
+# [例外](exceptions.md)
+# [1147 - FlowchartSwitchDefault](1147-flowchartswitchdefault.md)
+# [1035 - RuntimeTransactionSet](1035-runtimetransactionset.md)
+# [115 - WorkflowInstanceAbortedRecordWithId](115-workflowinstanceabortedrecordwithid.md)
diff --git a/docs/framework/windows-workflow-foundation/activity-authoring-options-in-wf.md b/docs/framework/windows-workflow-foundation/activity-authoring-options-in-wf.md
new file mode 100644
index 00000000000..eec0cf7d9eb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/activity-authoring-options-in-wf.md
@@ -0,0 +1,43 @@
+---
+title: "WF のアクティビティ作成オプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b9061f5f-12c3-47f0-adbe-1330e2714c94
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# WF のアクティビティ作成オプション
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、カスタム アクティビティを作成するオプションがいくつか用意されています。  特定のアクティビティを作成するために使用する適切な方法は、実行時に必要な機能によって異なります。  
+  
+## カスタム アクティビティを作成するために使用する基本アクティビティ クラスの決定  
+ 次の表は、カスタム アクティビティの基本クラスに使用できる機能の一覧です。  
+  
+|基本アクティビティ クラス|使用できる機能|  
+|-------------------|-------------|  
+|<xref:System.Activities.Activity>|システム標準アクティビティおよびカスタム アクティビティのグループを複合アクティビティに構成します。|  
+|<xref:System.Activities.CodeActivity>|オーバーライドできる <xref:System.Activities.CodeActivity%601.Execute%2A> メソッドを提供することで、命令型機能を実装します。  また、追跡、変数、および引数へのアクセスを提供します。|  
+|<xref:System.Activities.NativeActivity>|<xref:System.Activities.CodeActivity> のすべての機能を提供します。さらに、アクティビティの実行中止、子アクティビティの実行の取り消し、ブックマークの使用、および、アクティビティ、アクティビティのアクション、および機能のスケジュールも提供します。|  
+|<xref:System.Activities.DynamicActivity>|WF デザイナーおよび <xref:System.ComponentModel.IcustomTypeDescriptor> を介したランタイム機構と連携するアクティビティの構築に対応する、DOM のようなアプローチを提供します。これにより、新しい型を定義せずに新しいアクティビティを作成できるようになります。|  
+  
+## アクティビティを使用したアクティビティの作成  
+ <xref:System.Activities.Activity> から派生するアクティビティは、他の既存のアクティビティをまとめることで機能を構成します。  これらのアクティビティには、既存のカスタム アクティビティと、[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] アクティビティ ライブラリのアクティビティを使用できます。  これらのアクティビティをまとめることは、カスタム機能を作成するための最も基本的な方法です。  このアプローチは、ワークフローを作成するうえでビジュアル デザイン環境を使用するときによく採用されます。  
+  
+## CodeActivity または AsyncCodeActivity を使用したアクティビティの作成  
+ <xref:System.Activities.CodeActivity> または <xref:System.Activities.AsyncCodeActivity> から派生するアクティビティは、<xref:System.Activities.CodeActivity%601.Execute%2A> メソッドをカスタムの命令型コードでオーバーライドすることで、命令型機能を実装できます。  カスタム コードが実行されるのは、アクティビティが実行時に実行されるときです。  この方法で作成されたアクティビティはカスタム機能にアクセスできますが、実行時環境へのフル アクセス、子アクティビティのスケジュール機能、ブックマークの作成、Cancel メソッドや Abort メソッドのサポートなどの、ランタイムのすべての機能にアクセスすることはできません。  <xref:System.Activities.CodeActivity> を実行すると、\(<xref:System.Activities.CodeActivityContext> クラスまたは <xref:System.Activities.AsyncCodeActivityContext> クラスを介して\) 限定されたバージョンの実行時環境にアクセスできます。  <xref:System.Activities.CodeActivity> を使用して作成したアクティビティは、引数と変数の解決、拡張、および追跡にアクセスできます。  非同期アクティビティのスケジュールは、<xref:System.Activities.AsyncCodeActivity> を使用して実行できます。  
+  
+## NativeActivity を使用したアクティビティの作成  
+ <xref:System.Activities.NativeActivity> から派生するアクティビティは、<xref:System.Activities.CodeActivity> から派生するアクティビティと同様に、<xref:System.Activities.NativeActivity.Execute%2A> をオーバーライドすることで、命令型機能を作成します。ただし、<xref:System.Activities.NativeActivityContext> メソッドに渡される <xref:System.Activities.NativeActivity.Execute%2A> を介して、ワークフロー ランタイムのすべての機能にもアクセスできます。  このコンテキストは、子アクティビティのスケジュールと取り消し、<xref:System.Activities.ActivityAction> および <xref:System.Activities.ActivityFunc> オブジェクトの実行、ワークフローへのトランザクションの流し込み、非同期プロセスの呼び出し、実行の取り消しと中止、実行プロパティおよび実行拡張機能へのアクセス、およびブックマーク \(一時停止したワークフローの再開を処理\) をサポートします。  
+  
+## DynamicActivity を使用したアクティビティの作成  
+ 他の 3 種類のアクティビティとは異なり、<xref:System.Activities.DynamicActivity> から新しい型を派生することでは新しい機能は作成されません \(クラスはシールされています\)。その代わり、アクティビティのドキュメント オブジェクト モデル \(DOM\) を使用して、<xref:System.Activities.DynamicActivity.Properties%2A> プロパティと <xref:System.Activities.DynamicActivity.Implementation%2A> プロパティに機能をまとめることで、新しい機能を作成します。  
+  
+## 結果を返すアクティビティの作成  
+ 多くのアクティビティは、実行後に結果を返します。  この目的でアクティビティにカスタムの <xref:System.Activities.OutArgument%601> を定義することは常に可能ですが、代わりに <xref:System.Activities.Activity%601> を使用するか、<xref:System.Activities.CodeActivity%601> または <xref:System.Activities.NativeActivity%601> から派生することをお勧めします。  これらの各基本クラスには、アクティビティの戻り値に使用できる Result という <xref:System.Activities.OutArgument%601> があります。  結果を返すアクティビティは、1 つの結果のみをアクティビティから返す必要がある場合にのみ使用します。複数の結果を返す必要がある場合は、別の <xref:System.Activities.OutArgument%601> メンバーを代わりに使用します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/activity-definition-scoping-and-visibility.md b/docs/framework/windows-workflow-foundation/activity-definition-scoping-and-visibility.md
new file mode 100644
index 00000000000..2a531cb9297
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/activity-definition-scoping-and-visibility.md
@@ -0,0 +1,73 @@
+---
+title: "アクティビティ定義のスコープ設定と表示 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ccdffa07-9503-4eea-a61b-17f1564368b7
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# アクティビティ定義のスコープ設定と表示
+アクティビティ定義のスコープと可視性は、オブジェクトのスコープと可視性と同様に、他のオブジェクトまたはアクティビティがアクティビティのメンバーにアクセスするために必要な機能です。アクティビティ定義は次の実装によって実行されます。  
+  
+1.  アクティビティによってユーザーに公開されるメンバー \(<xref:System.Activities.Argument>、<xref:System.Activities.Variable>、および <xref:System.Activities.ActivityDelegate> オブジェクト、および子アクティビティ\) の指定。  
+  
+2.  アクティビティの実行ロジックの実装。  
+  
+ この実装には、アクティビティのコンシューマーには公開されないが、実装の詳細であるメンバーが含まれる場合があります。型定義と同様に、作成者は、アクティビティ モデルを使用することで、定義対象のアクティビティの定義について、アクティビティ メンバーの可視性を指定できます。この可視性によって、データのスコープなどメンバーの使用法の要素が決定します。  
+  
+## スコープ  
+ データのスコープ以外に、アクティビティ モデルの可視性によって、検証、デバッグ、追跡、トレースなどのアクティビティの他の要素へのアクセスが制限される場合があります。実行プロパティでは、実行の特性を特定の定義のスコープに制限するための可視性とスコープを使用します。セカンダリ ルートでは、可視性とスコープを使用して、<xref:System.Activities.Statements.CompensableActivity> によってキャプチャされた状態を補正可能なアクティビティが使用される定義のスコープに制限します。  
+  
+## 定義と使用法  
+ ワークフローは、基本アクティビティ クラスからの継承によって新しいアクティビティを作成すると共に、[ビルトイン アクティビティ ライブラリ](../../../docs/framework/windows-workflow-foundation//net-framework-4-5-built-in-activity-library.md) のアクティビティを使用することによって作成されます。アクティビティを使用するには、アクティビティ作成者によってその定義の各コンポーネントの可視性が設定される必要があります。  
+  
+### アクティビティ メンバー  
+ アクティビティ モデルでは、アクティビティによってコンシューマーが使用できるようになる引数、変数、デリゲート、および子アクティビティが定義されます。各メンバーは、`public` または `private` として宣言できます。パブリック メンバーはアクティビティのコンシューマーが設定し、`private` メンバーはアクティビティの作成者によって指定された実装を使用します。データのスコープの可視性に関する規則は、次のとおりです。  
+  
+1.  パブリック メンバーおよびパブリック子アクティビティのパブリック メンバーは、パブリック変数を参照できます。  
+  
+2.  プライベート メンバーおよびパブリック子アクティビティのパブリック メンバーは引数およびプライベート変数を参照できます。  
+  
+ アクティビティのコンシューマーが設定可能なメンバーは、プライベートに指定できません。  
+  
+### 作成モデル  
+ カスタム アクティビティは、<xref:System.Activities.NativeActivity>、<xref:System.Activities.Activity>、<xref:System.Activities.CodeActivity>、または <xref:System.Activities.AsyncCodeActivity> を使用して定義されます。これらのクラスから派生するアクティビティによって、可視性が異なるさまざまなメンバー型が公開されます。  
+  
+#### NativeActivity  
+ <xref:System.Activities.NativeActivity> から派生したアクティビティの動作は、命令型コードで記述され、任意で既存のアクティビティを使用して定義できます。<xref:System.Activities.NativeActivity> からアクティビティを派生させると、ランタイムによって公開されるすべての機能にアクセスできます。このようなアクティビティのメンバーは、引数を除く `public` としてのみ宣言可能なパブリックまたはプライベートの可視性を使用して定義できます。  
+  
+ <xref:System.Activities.NativeActivity> から派生したクラスのメンバーは、<xref:System.Activities.NativeActivity.CacheMetadata%2A> メソッドに渡される <xref:System.Activities.NativeActivityMetadata> 構造体を使用してランタイムに宣言されます。  
+  
+#### アクティビティ  
+ <xref:System.Activities.Activity> を使用して作成されたアクティビティの動作は、他のアクティビティが作成されることで厳密にデザインされます。<xref:System.Activities.Activity> クラスの 1 つの実装子アクティビティは、<xref:System.Activities.Activity.Implementation%2A> を使用するランタイムによって取得されます。<xref:System.Activities.Activity> から派生するアクティビティは、パブリック引数、パブリック変数、インポートされた ActivityDelegates、およびインポートされた Activities を定義します。  
+  
+ インポートされた ActivityDelegates および Activities は、パブリックのアクティビティの子として宣言されますが、アクティビティによって直接はスケジュールされません。この情報は検証時に使用され、アクティビティが実行されないロケーションで複数の親が同時に検証されるのを防ぎます。また、パブリック子と同様に、インポートされた子は、アクティビティの実装時に参照およびスケジュールされます。つまり、Activity1 と呼ばれるアクティビティをインポートするアクティビティには、Activity1 をスケジュールする実装の <xref:System.Activities.Statements.Sequence> が含まれている場合があります。  
+  
+#### CodeActivity\/ AsyncCodeActivity  
+ この基本クラスは、命令型コードの動作の定義に使用されます。このクラスから派生したアクティビティだけが、このアクティビティよって公開された引数にアクセスできます。つまり、これらのアクティビティによって公開されるメンバーのみがパブリック引数になります。他のメンバーおよび可視性はこれらのアクティビティに適用されません。  
+  
+#### 可視性の概要  
+ このセクションの前半の情報の概要を次の表に示します。  
+  
+|メンバーの型|NativeActivity|アクティビティ|CodeActivity\/ AsyncCodeActivity|  
+|------------|--------------------|-------------|--------------------------------------|  
+|Arguments|パブリック\/プライベート|パブリック|該当なし|  
+|Variables|パブリック\/プライベート|パブリック|該当なし|  
+|Child Activities|パブリック\/プライベート|パブリック \(実装時に定義された修正済みのプライベート子\)|該当なし|  
+|ActivityDelegates|パブリック\/プライベート|パブリック|該当なし|  
+  
+ 通常、アクティビティのコンシューマーが設定不可能なメンバーは、パブリックに指定できません。  
+  
+### 実行プロパティ  
+ 状況によっては、特定の実行プロパティのスコープをアクティビティのパブリック子に限定すると便利な場合があります。<xref:System.Activities.ExecutionProperties> コレクションによって、<xref:System.Activities.ExecutionProperties.Add%2A> メソッドでこれを実行できます。このメソッドの Boolean 型パラメーターは、特定のプロパティのスコープがすべての子に限定されているか、パブリックである子にのみ限定されているかを示します。このパラメーターが `true` に設定されている場合、プロパティはパブリック メンバーおよびパブリック子のパブリック メンバーに可視性が限定されます。  
+  
+### セカンダリ ルート  
+ セカンダリ ルートは、補正アクティビティの状態を管理するためのランタイムの内部の機構です。<xref:System.Activities.Statements.CompensableActivity> の実行が終了しても、その状態はすぐにクリーン アップされません。代わりに、補正が完了するまで、セカンダリ ルートのランタイムによってこの状態が維持されます。セカンダリ ルートによってキャプチャされた配置環境は、補正可能なアクティビティが使用される定義のスコープに対応します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/activity-localization.md b/docs/framework/windows-workflow-foundation/activity-localization.md
new file mode 100644
index 00000000000..e03d2be78e7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/activity-localization.md
@@ -0,0 +1,79 @@
+---
+title: "アクティビティのローカライズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ee7bc16-e609-469a-a3e8-8062952e2676
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# アクティビティのローカライズ
+ワークフロー アプリケーションとコンポーネントが他のカルチャおよび言語にローカライズされる可能性がある場合は、再コンパイルせずにローカライズできるようにリソース文字列を使用する必要があります。  
+  
+## アクティビティのローカライズ  
+ ローカライズが必要なすべてのアプリケーション \(言語とカルチャが異なり、異なるバージョンでリリースされたアプリケーション\) について、ユーザーに表示される文字列は、コードに直接記述せず、リソース ファイルに格納する必要があります。文字列には、<xref:System.Environment.GetResourceString> を介してアクセスできます。複数の言語で配布されるコンポーネントを開発する場合、アクティビティの検証メッセージ、ユーザー定義の追跡データ、追跡メッセージ、およびエラー メッセージにもリソース文字列を使用できます。  
+  
+ 次の演習では、リソース ファイルの使用手順を示します。  
+  
+#### ローカライズ文字列へのリソース ファイルの使用  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] の**ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[追加\]** の **\[新しい項目\]** をクリックします。  
+  
+2.  **\[リソース ファイル\]** を選択し、ファイルに ErrorResources.resx という名前を付けます。**\[追加\]** をクリックします。  
+  
+3.  リソース ファイルを開きます。**\[名前\]** が ErrorString で **\[値\]** が "The activity is not valid." の新しいエントリを追加します。  
+  
+4.  次の `using` ステートメントをクラスに追加します。  
+  
+    ```  
+    using System.Reflection;  
+    using System.Resources;  
+  
+    ```  
+  
+5.  プロジェクトでリソース マネージャーを作成します。  
+  
+    ```  
+    ResourceManager ErrorManager;  
+    ...  
+    ErrorManager = new ResourceManager("MyNamespace.ErrorResources", Assembly.GetExecutingAssembly());  
+  
+    ```  
+  
+6.  必要に応じてリソース マネージャーから文字列を取得します。  
+  
+    ```  
+    String errorMessage = ErrorManager.GetString("ErrorString");  
+  
+    ```  
+  
+ 次のコードは、<xref:System.Activities.Activity.CacheMetadata%2A> メソッドでローカライズした文字列を利用する方法の例です。  
+  
+```  
+       protected override void CacheMetadata(CodeActivityMetadata metadata)  
+        {  
+           .....  
+          // rest of the code elided for brevity  
+           .....  
+            if (this.Value != null && this.To != null)  
+            {  
+                if (!TypeHelper.AreTypesCompatible(this.Value.ArgumentType, this.To.ArgumentType))  
+                {  
+//---------------------------------------------  
+// ** SR.TypeMismatchForAssign will fetch the string from the resource manager **  
+//---------------------------------------------  
+                    metadata.AddValidationError(SR.TypeMismatchForAssign(  
+                                this.Value.ArgumentType,  
+                                this.To.ArgumentType,  
+                                this.DisplayName));  
+                }  
+            }  
+        }  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/activity-tree-inspection.md b/docs/framework/windows-workflow-foundation/activity-tree-inspection.md
new file mode 100644
index 00000000000..ef9d416d3a4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/activity-tree-inspection.md
@@ -0,0 +1,55 @@
+---
+title: "アクティビティ ツリー検査 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 100d00e4-8c1d-4233-8fbb-dd443a01155d
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# アクティビティ ツリー検査
+アクティビティ ツリー検査は、アプリケーションによってホストされるワークフローを検査するためにワークフロー アプリケーションの作成者によって使用されます。<xref:System.Activities.WorkflowInspectionServices> を使用することによって、特定の子アクティビティを対象としてワークフローを検索したり、個々のアクティビティとそのプロパティを列挙したりできるほか、アクティビティのランタイム メタデータを特定の時点でキャッシュできます。ここでは、<xref:System.Activities.WorkflowInspectionServices> の概要を説明します。また、これを使用してアクティビティ ツリーを検査する方法も説明します。  
+  
+## WorkflowInspectionServices の使用  
+ <xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> メソッドは、指定したアクティビティ ツリーのアクティビティをすべて列挙するために使用されます。<xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> は、子、デリゲート ハンドラー、変数の既定値、引数の式を含む、ツリー内のすべてのアクティビティに接触する列挙可能なアクティビティを返します。次の例では、ワークフロー定義は <xref:System.Activities.Statements.Sequence>、<xref:System.Activities.Statements.While>、<xref:System.Activities.Statements.ForEach%601>、<xref:System.Activities.Statements.WriteLine>、および式を使用して作成されます。ワークフロー定義が作成されると、このワークフロー定義が呼び出されて、`InspectActivity` メソッドが呼び出されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#45](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#45)]  
+  
+ アクティビティを列挙するために、<xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> がルート アクティビティで呼び出され、返される各アクティビティでもう一度再帰的に呼び出されます。次の例では、アクティビティ ツリーのそれぞれのアクティビティと式の <xref:System.Activities.Activity.DisplayName%2A> がコンソールに書き込まれます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#46](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#46)]  
+  
+ このサンプル コードから次の出力が得られます。  
+  
+ **リスト項目 1**   
+**リスト項目 2**   
+**リスト項目 3**   
+**リスト項目 4**   
+**リスト項目 5**   
+**コレクションに追加された項目。**   
+**シーケンス**   
+ **Literal\<リスト\<文字列\>\>**   
+ **While**   
+ **AddToCollection\<文字列\>**   
+ **VariableValue\<ICollection\<文字列\>\>**   
+ **LambdaValue\<文字列\>**   
+ **LocationReferenceValue\<List\<文字列\>\>**   
+ **LambdaValue\<ブール型\>**   
+ **LocationReferenceValue\<List\<文字列\>\>**   
+ **ForEach\<文字列\>**   
+ **VariableValue\<IEnumerable\<文字列\>\>**   
+ **WriteLine**   
+ **DelegateArgumentValue\<文字列\>**   
+ **シーケンス**   
+ **WriteLine**   
+ **Literal\<文字列\>**  すべてのアクティビティを列挙するのではなく、特定のアクティビティを取得する場合は、<xref:System.Activities.WorkflowInspectionServices.Resolve%2A> を使用します。<xref:System.Activities.WorkflowInspectionServices.Resolve%2A> と <xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> はいずれも、`WorkflowInspectionServices.CacheMetadata` が前に呼び出されていない場合にメタデータのキャッシュ処理を実行します。<xref:System.Activities.WorkflowInspectionServices.CacheMetadata%2A> が呼び出されている場合、<xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> は既存のメタデータに基づいています。このため、<xref:System.Activities.WorkflowInspectionServices.CacheMetadata%2A> を最後に呼び出した後でツリーが変更されていると、予期しない結果が <xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> で生じることがあります。<xref:System.Activities.WorkflowInspectionServices.GetActivities%2A> を呼び出した後にワークフローに変更を加えた場合は、<xref:System.Activities.Validation.ActivityValidationServices><xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> メソッドを呼び出して、メタデータを再キャッシュすることができます。メタデータのキャッシュ処理については、次のセクションで説明します。  
+  
+### メタデータのキャッシュ処理  
+ アクティビティのメタデータをキャッシュすると、アクティビティの引数、変数、子アクティビティ、アクティビティ デリゲートの記述が構築および検証されます。既定では、メタデータはアクティビティが実行用に準備されるときにランタイムによってキャッシュされます。ワークフロー ホストの作成者が、それよりも前 \(すべてのコストを先に取得する場合など\) にアクティビティまたはアクティビティ ツリーのメタデータをキャッシュする場合は、<xref:System.Activities.WorkflowInspectionServices.CacheMetadata%2A> を使用して目的の時点でメタデータをキャッシュできます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/architecture.md b/docs/framework/windows-workflow-foundation/architecture.md
new file mode 100644
index 00000000000..dcea5fe32e5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/architecture.md
@@ -0,0 +1,57 @@
+---
+title: "Windows Workflow のアーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d4c6495-d64a-46d0-896a-3a01fac90aa9
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# Windows Workflow のアーキテクチャ
+[!INCLUDE[wf](../../../includes/wf-md.md)] は、実行時間の長いインタラクティブ アプリケーションの開発用に抽象化のレベルを引き上げます。作業単位はアクティビティとしてカプセル化されます。アクティビティが実行される環境には、フロー制御、例外処理、エラー伝達、状態データの永続化、動作中のワークフローのメモリへの読み込みやアンロード、追跡、トランザクション フローに対応する機能が備わっています。  
+  
+## アクティビティのアーキテクチャ  
+ アクティビティは、<xref:System.Activities.Activity>、<xref:System.Activities.CodeActivity>、<xref:System.Activities.AsyncCodeActivity> または <xref:System.Activities.NativeActivity> のいずれかから派生する CLR 型として開発されたり、または値 <xref:System.Activities.Activity%601>、<xref:System.Activities.CodeActivity%601>、<xref:System.Activities.AsyncCodeActivity%601> または <xref:System.Activities.NativeActivity%601> を返す CLR 型の変化形として開発されます。<xref:System.Activities.Activity> から派生するアクティビティを開発すると、ユーザーは既存のアクティビティを組み合わせて、ワークフロー環境で実行される作業単位をすばやく作成できます。一方、<xref:System.Activities.CodeActivity> では、主にアクティビティ引数にアクセスするために <xref:System.Activities.CodeActivityContext> を使用してマネージ コードで作成される実行ロジックが有効になります。<xref:System.Activities.AsyncCodeActivity> は、非同期タスクを実装するためにしようできること以外の点で <xref:System.Activities.CodeActivity> に似ています。<xref:System.Activities.NativeActivity> から派生するアクティビティを開発すると、<xref:System.Activities.NativeActivityContext> を通じてランタイムにアクセスし、子のスケジュール設定、ブックマーク作成、非同期の作業の呼び出し、トランザクションの登録などの機能を使用できます。  
+  
+ <xref:System.Activities.Activity> から派生するアクティビティの作成は宣言型です。また、これらのアクティビティは XAML で作成できます。次の例では、`Prompt` というアクティビティが、実行の本体用に他のアクティビティを使用して作成されます。  
+  
+```  
+<Activity x:Class='Prompt'  
+  xmlns:x='http://schemas.microsoft.com/winfx/2006/xaml'  
+    xmlns:z='http://schemas.microsoft.com/netfx/2008/xaml/schema'  
+xmlns:my='clr-namespace:XAMLActivityDefinition;assembly=XAMLActivityDefinition'  
+xmlns:s="clr-namespace:System;assembly=mscorlib"  
+xmlns="http://schemas.microsoft.com/2009/workflow">  
+<z:SchemaType.Members>  
+    <z:SchemaType.SchemaProperty Name='Text' Type=' InArgument(s:String)' />  
+  <z:SchemaType.SchemaProperty Name='Response' Type='OutArgument(s:String)' />  
+</z:SchemaType.Members>  
+  <Sequence>  
+    <my:WriteLine Text='[Text]' />  
+    <my:ReadLine BookmarkName='r1' Result='[Response]' />  
+  </Sequence>  
+</Activity>  
+```  
+  
+## アクティビティ コンテキスト  
+ <xref:System.Activities.ActivityContext> は、アクティビティ作成者のワークフロー ランタイムへのインターフェイスであり、ランタイムのさまざまな機能にアクセスできます。次の例では、ブックマーク \(データをアクティビティに渡してホストが再開できる、実行の継続点をアクティビティが登録できる仕組み\) を作成する実行コンテキストを使用するアクティビティが定義されています。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#15](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#15)]  
+  
+## アクティビティ ライフ サイクル  
+ アクティビティのインスタンスは <xref:System.Activities.ActivityInstanceState> 状態で開始します。例外が検出された場合を除き、すべての子アクティビティが実行を終了し、他の保留中の作業 \(<xref:System.Activities.Bookmark> オブジェクトなど\) が完了するまでこの状態が維持されてから、<xref:System.Activities.ActivityInstanceState> 状態に移行します。アクティビティ インスタンスの親は子にキャンセルを要求できます。子がキャンセル可能な場合、子は <xref:System.Activities.ActivityInstanceState> 状態で完了します。実行中に例外がスローされた場合は、ランタイムはアクティビティを <xref:System.Activities.ActivityInstanceState> 状態にし、アクティビティの親チェーンの上方向に例外を伝達します。アクティビティの 3 つの完了状態を次に示します。  
+  
+-   **Closed:** アクティビティは作業を完了し、終了しました。  
+  
+-   **Canceled:** アクティビティは作業を正常に中断し、終了しました。この状態に移行した場合、作業は明示的にロール バックされません。  
+  
+-   **Faulted:** アクティビティがエラーを検出し、作業を完了せずに終了しました。  
+  
+ アクティビティは、永続化またはアンロードされても <xref:System.Activities.ActivityInstanceState> 状態を維持します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/authoring-workflows-activities-and-expressions-using-imperative-code.md b/docs/framework/windows-workflow-foundation/authoring-workflows-activities-and-expressions-using-imperative-code.md
new file mode 100644
index 00000000000..ebcb9f14b4f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/authoring-workflows-activities-and-expressions-using-imperative-code.md
@@ -0,0 +1,199 @@
+---
+title: "命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cefc9cfc-2882-4eb9-8c94-7a6da957f2b2
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# 命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法
+ワークフロー定義は、構成済みのアクティビティ オブジェクトのツリーです。このアクティビティ ツリーは、手動で XAML を編集したり、ワークフロー デザイナーを使用して XAML を生成したりするなど、多くの方法で定義することができます。ただし、XAML の使用は必須ではありません。ワークフロー定義は、プログラムで作成することもできます。このトピックでは、コードを使用したワークフローの定義、アクティビティ、および式の作成の概要について説明します。コードを使用して XAML ワークフローを操作する方法の例については、「[XAML との間のワークフローおよびアクティビティのシリアル化](../../../docs/framework/windows-workflow-foundation//serializing-workflows-and-activities-to-and-from-xaml.md)」を参照してください。  
+  
+## ワークフロー定義の作成  
+ アクティビティ型のインスタンスをインスタンス化して、アクティビティ オブジェクトのプロパティを構成することで、ワークフロー定義を作成できます。子アクティビティを含まないアクティビティの場合、数行のコードを使用してこれを作成できます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#47](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#47)]  
+  
+> [!NOTE]
+>  このトピックの例では、<xref:System.Activities.WorkflowInvoker> を使用してサンプル ワークフローを実行します。ワークフローの呼び出し、引数の受け渡し、および使用可能なさまざまなホストの選択[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WorkflowInvoker と WorkflowApplication の使用](../../../docs/framework/windows-workflow-foundation//using-workflowinvoker-and-workflowapplication.md)」を参照してください。  
+  
+ 次の例では、1 つの <xref:System.Activities.Statements.WriteLine> アクティビティから成るワークフローを作成します。<xref:System.Activities.Statements.WriteLine> アクティビティの <xref:System.Activities.Statements.WriteLine.Text%2A> 引数が設定され、ワークフローが呼び出されます。アクティビティに子アクティビティが含まれる場合も、作成のメソッドは同じです。次の例では、2 つの <xref:System.Activities.Statements.WriteLine> アクティビティを含む <xref:System.Activities.Statements.Sequence> アクティビティを使用します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#48](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#48)]  
+  
+### オブジェクト初期化子の使用  
+ このトピックの例では、オブジェクトの初期化の構文を使用します。オブジェクトの初期化の構文は、コードでワークフロー定義を作成する場合に便利な方法です。これは、ワークフローのアクティビティの階層ビューが提供され、アクティビティ間の関係が示されるためです。プログラムからワークフローを作成する場合に、オブジェクトの初期化の構文を使用しなければならないという要件はありません。次の例は、機能的には前のサンプルと同じです。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#49](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#49)]  
+  
+ オブジェクト初期化子[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法 : コンストラクターを呼び出さずにオブジェクトを初期化する \(C\# プログラミング ガイド\)](http://go.microsoft.com/fwlink/?LinkId=161015)」および「[方法 : オブジェクト初期化子を使用してオブジェクトを宣言する](http://go.microsoft.com/fwlink/?LinkId=161016)」を参照してください。  
+  
+### 変数、リテラル値、および式の使用  
+ コードを使用してワークフロー定義を作成する場合は、ワークフロー定義の作成の一部としてコードが実行する内容、およびそのワークフローのインスタンスの実行の一部としてコードが実行する内容に注意してください。たとえば、次のワークフローはランダムな数値を生成し、それをコンソールに出力します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#50](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#50)]  
+  
+ このワークフロー定義のコードが実行されると、`Random.Next` への呼び出しが実行され、その結果がリテラル値としてワークフロー定義に保存されます。このワークフローの多くのインスタンスを呼び出すことができ、そのすべてに同じ数字が表示されます。ワークフローの実行中にランダムな数値を生成するには、ワークフローを実行するたびに評価する式を使用する必要があります。次の例では、<xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> で Visual Basic 式を使用します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#51](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#51)]  
+  
+ 前の例にある式は、<xref:Microsoft.CSharp.Activities.CSharpValue%601> と C\# 式を使用して実装することもできます。  
+  
+```csharp  
+new Assign<int>  
+{  
+    To = n,  
+    Value = new CSharpValue<int>("new Random().Next(1, 101)")  
+}  
+  
+```  
+  
+ C\# 式は、その式を含むワークフローが呼び出される前にコンパイルする必要があります。C\# 式がコンパイルされていない場合、ワークフローが呼び出されると <xref:System.NotSupportedException> がスローされ、"`Expression Activity type 'CSharpValue`1' requires compilation in order to run.  Please ensure that the workflow has been compiled.`" のようなメッセージが表示されます。Visual Studio で作成されたワークフローが関連するほとんどのシナリオでは、C\# 式が自動的にコンパイルされますが、コード ワークフローなどの一部のシナリオでは、C\# 式を手動でコンパイルする必要があります。C\# 式をコンパイルする方法の例については、「[C\# の式](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md)」の「[コード ワークフローでの C\# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CodeWorkflows)」を参照してください。  
+  
+ <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> は式の右辺値として使用できる Visual Basic 構文の式を表し、<xref:Microsoft.CSharp.Activities.CSharpValue%601> は式の右辺値として使用できる C\# 構文の式を表します。これらの式は、含まれるアクティビティが実行されるたびに評価されます。  
+  
+> [!NOTE]
+>  この 2 つのコードはプログラミング言語として C\# を使用している例ですが、1 つは <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> を使用し、もう 1 つは <xref:Microsoft.CSharp.Activities.CSharpValue%601> を使用しています。<xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> および <xref:Microsoft.CSharp.Activities.CSharpValue%601> は、Visual Basic と C\# の両方のプロジェクトで使用できます。既定では、ワークフロー デザイナーで作成された式は、ホスティング プロジェクトの言語に一致します。ワークフローをコードで作成する場合、必要な言語はワークフロー作成者の判断に委ねられます。  
+  
+ これらの例では、式の結果がワークフロー変数 `n` に代入され、その結果がワークフロー内の次のアクティビティで使用されます。実行時にワークフローの変数 `n` の値にアクセスするには、<xref:System.Activities.ActivityContext> が必要です。次のようなラムダ式を使用するとアクセスできます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#52](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#52)]  
+  
+ ラムダ式[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ラムダ式 \(C\# プログラミング ガイド\)](http://go.microsoft.com/fwlink/?LinkID=152436)」または「[ラムダ式 \(Visual Basic\)](http://go.microsoft.com/fwlink/?LinkID=152437)」を参照してください。  
+  
+ ラムダ式は XAML 形式にシリアル化できません。ラムダ式を使用してワークフローのシリアル化を試みると、<xref:System.Activities.Expressions.LambdaSerializationException> がスローされ、"このワークフローには、コードで指定されたラムダ式が含まれています。これらの式は XAML にシリアル化できません。このワークフローを XAML にシリアル化できるようにするには、VisualBasicValue\/VisualBasicReference を使用するか、ExpressionServices.Convert\(lambda\) を使用します。これにより、ラムダ式が式アクティビティに変換されます。" というメッセージが表示されます。この式に XAML との互換性を持たせるには、次の例に示すように <xref:System.Activities.Expressions.ExpressionServices> および <xref:System.Activities.Expressions.ExpressionServices.Convert%2A> を使用します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#53](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#53)]  
+  
+ <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> を使用することもできます。Visual Basic 式を使用する場合はラムダ式が不要であることに注意してください。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#54](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#54)]  
+  
+ 実行時に、Visual Basic 式は LINQ 式にコンパイルされます。前の例はいずれも XAML にシリアル化できますが、シリアル化された XAML をワークフロー デザイナーで表示および編集することを目的としている場合は、式に <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> を使用してください。`ExpressionServices.Convert` を使用するシリアル化されたワークフローはデザイナーで開くことができますが、式の値は空白になります。ワークフローを XAML にシリアル化する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[XAML との間のワークフローおよびアクティビティのシリアル化](../../../docs/framework/windows-workflow-foundation//serializing-workflows-and-activities-to-and-from-xaml.md)」を参照してください。  
+  
+#### リテラル式と参照型  
+ リテラル式は、ワークフロー内では <xref:System.Activities.Expressions.Literal%601> アクティビティによって表されます。次の <xref:System.Activities.Statements.WriteLine> アクティビティは機能的には同じです。  
+  
+```csharp  
+new WriteLine  
+{  
+    Text = "Hello World."  
+},  
+new WriteLine  
+{  
+    Text = new Literal<string>("Hello World.")  
+}  
+  
+```  
+  
+ <xref:System.String> 以外の参照型を使用してリテラル式を初期化することはできません。次の例では、<xref:System.Activities.Statements.Assign> アクティビティの <xref:System.Activities.Statements.Assign.Value%2A> プロパティは `List<string>` を使用したリテラル式で初期化されます。  
+  
+```csharp  
+new Assign  
+{  
+    To = new OutArgument<List<string>>(items),  
+    Value = new InArgument<List<string>>(new List<string>())  
+},  
+  
+```  
+  
+ このアクティビティを含むワークフローを検証すると、"リテラルは、値の型と変更不可の型 System.String のみをサポートします。型 System.Collections.Generic.List\`1\[System.String\] はリテラルとして使用できません。" という検証エラーが返されます。ワークフローが呼び出されると、検証エラーのテキストを含む <xref:System.Activities.InvalidWorkflowException> がスローされます。参照型のリテラル式を作成しても、ワークフローの各インスタンスに対して参照型の新しいインスタンスが作成されないため、これは検証エラーとなります。このエラーを解決するには、リテラル式を、参照型の新しいインスタンスを作成して返すリテラル式に置き換えます。  
+  
+```csharp  
+new Assign  
+{  
+    To = new OutArgument<List<string>>(items),  
+    Value = new InArgument<List<string>>(new VisualBasicValue<List<string>>("New List(Of String)"))  
+},  
+  
+```  
+  
+ 式[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[式](../../../docs/framework/windows-workflow-foundation//expressions.md)」を参照してください。  
+  
+#### 式と InvokeMethod アクティビティを使用したオブジェクトのメソッド呼び出し  
+ <xref:System.Activities.Expressions.InvokeMethod%601> アクティビティを使用すると、.NET Framework のクラスの静的メソッドとインスタンス メソッドを呼び出すことができます。このトピックの前の例では、乱数が <xref:System.Random> クラスを使用して生成されました。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#51](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#51)]  
+  
+ また <xref:System.Activities.Expressions.InvokeMethod%601> アクティビティは、<xref:System.Random.Next%2A> クラスの <xref:System.Random> メソッドの呼び出しにも使用されました。  
+  
+```csharp  
+new InvokeMethod<int>  
+{  
+    TargetObject = new InArgument<Random>(new VisualBasicValue<Random>("New Random()")),  
+    MethodName = "Next",  
+    Parameters =   
+    {  
+        new InArgument<int>(1),  
+        new InArgument<int>(101)  
+    },  
+    Result = n  
+}  
+  
+```  
+  
+ <xref:System.Random.Next%2A> は静的メソッドではないので、<xref:System.Activities.Expressions.InvokeMethod%601.TargetObject%2A> プロパティには <xref:System.Random> クラスのインスタンスが指定されます。この例では、新しいインスタンスが Visual Basic 式を使用して作成されますが、これまでも作成されてワークフロー変数に格納されている場合があります。この例では、<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティの代わりに、<xref:System.Activities.Statements.Assign%601> アクティビティをより簡単に使用しています。<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティまたは <xref:System.Activities.Statements.Assign%601> アクティビティで最終的に呼び出されるメソッド呼び出しが長時間実行されている場合、<xref:System.Activities.Expressions.InvokeMethod%601> には <xref:System.Activities.Expressions.InvokeMethod%601.RunAsynchronously%2A> プロパティがあるため、効果があります。このプロパティが `true` に設定されると、呼び出されるメソッドはワークフローに対して非同期に実行されます。他のアクティビティが並列実行される場合、そのメソッドは非同期に実行され、それらのアクティビティはブロックされません。また、呼び出すメソッドに戻り値がない場合、<xref:System.Activities.Expressions.InvokeMethod%601> はメソッドを呼び出すための適切な手段となります。  
+  
+## 引数と動的なアクティビティ  
+ アクティビティをアクティビティ ツリーにまとめてプロパティと引数を構成すると、コードでワークフロー定義を作成できます。既存の引数を見つけることはできますが、新しい引数をアクティビティに追加することはできません。これには、ルート アクティビティに渡されるワークフロー引数が含まれます。ワークフロー引数は、命令型コードでは新しい CLR 型のプロパティとして指定され、XAML では `x:Class` および `x:Member` を使用して宣言されます。ワークフロー定義がメモリ内オブジェクトのツリーとして作成された場合は新しい CRL 型が作成されないため、引数を追加できません。ただし、<xref:System.Activities.DynamicActivity> に引数を追加することはできます。次の例では、2 つの整数の引数を取り、それを一緒に追加して結果を返す <xref:System.Activities.DynamicActivity%601> を作成します。各引数に対して <xref:System.Activities.DynamicActivityProperty> が作成され、操作の結果が <xref:System.Activities.DynamicActivity%601> の <xref:System.Activities.Activity%601.Result%2A> 引数に代入されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#55](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#55)]  
+  
+ 動的なアクティビティ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[実行時におけるアクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-an-activity-at-runtime-with-dynamicactivity.md)」を参照してください。  
+  
+## コンパイルされたアクティビティ  
+ 動的アクティビティは、コードを使用して引数を格納するアクティビティを定義するための 1 つの方法ですが、アクティビティをコードで作成して型にコンパイルすることもできます。<xref:System.Activities.CodeActivity> から派生する単純なアクティビティと、<xref:System.Activities.AsyncCodeActivity> から派生する非同期アクティビティを作成できます。これらのアクティビティは、引数を保持し、値を返して、命令型コードを使用してロジックを定義できます。これらの種類のアクティビティの作成例については、「[CodeActivity 基本クラス](../../../docs/framework/windows-workflow-foundation//workflow-activity-authoring-using-the-codeactivity-class.md)」および「[非同期アクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-asynchronous-activities-in-wf.md)」を参照してください。  
+  
+ <xref:System.Activities.NativeActivity> から派生するアクティビティは、命令型コードを使用してロジックを定義できるだけでなく、ロジックを定義する子アクティビティを含むこともできます。これらのアクティビティは、ブックマークの作成など、ランタイムの機能をすべて利用できます。<xref:System.Activities.NativeActivity> ベースのアクティビティの作成例については、「[NativeActivity の基本クラス](../../../docs/framework/windows-workflow-foundation//nativeactivity-base-class.md)」、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」、および「[ネイティブ アクティビティを使用したカスタム複合](../../../docs/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity.md)」のサンプルを参照してください。  
+  
+ <xref:System.Activities.Activity> から派生するアクティビティは、子アクティビティを使用してロジックだけを定義します。これらのアクティビティは、通常、ワークフロー デザイナーを使用して作成されますが、コードを使用して定義することもできます。次の例では、`Activity<int>` から派生する `Square` アクティビティが定義されます。`Square` アクティビティには `Value` という名前の 1 つの <xref:System.Activities.InArgument%601> があり、そのロジックが <xref:System.Activities.Activity.Implementation%2A> プロパティを使用して <xref:System.Activities.Statements.Sequence> アクティビティを指定してロジックを定義します。<xref:System.Activities.Statements.Sequence> アクティビティには、<xref:System.Activities.Statements.WriteLine> アクティビティと <xref:System.Activities.Statements.Assign%601> アクティビティが含まれています。この 3 つのアクティビティは、`Square` アクティビティのロジックを実装します。  
+  
+```csharp  
+class Square : Activity<int>  
+{  
+    [RequiredArgument]  
+    public InArgument<int> Value { get; set; }  
+  
+    public Square()  
+    {  
+        this.Implementation = () => new Sequence  
+        {  
+            Activities =  
+            {  
+                new WriteLine  
+                {  
+                    Text = new InArgument<string>((env) => "Squaring the value: " + this.Value.Get(env))  
+                },  
+                new Assign<int>  
+                {  
+                    To = new OutArgument<int>((env) => this.Result.Get(env)),  
+                    Value = new InArgument<int>((env) => this.Value.Get(env) * this.Value.Get(env))  
+                }  
+            }  
+        };  
+    }  
+}  
+  
+```  
+  
+ 次の例では、単一の `Square` アクティビティで構成されるワークフロー定義を <xref:System.Activities.WorkflowInvoker> を使用して呼び出します。  
+  
+```csharp  
+Dictionary<string, object> inputs = new Dictionary<string, object> {{ "Value", 5}};  
+int result = WorkflowInvoker.Invoke(new Square(), inputs);  
+Console.WriteLine("Result: {0}", result);  
+  
+```  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **Squaring the value: 5**   
+**Result: 25**
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/binding-a-custom-activity-property-to-a-designer-control.md b/docs/framework/windows-workflow-foundation/binding-a-custom-activity-property-to-a-designer-control.md
new file mode 100644
index 00000000000..719850084ce
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/binding-a-custom-activity-property-to-a-designer-control.md
@@ -0,0 +1,146 @@
+---
+title: "デザイナー コントロールへのカスタム アクティビティ プロパティのバインド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2e8061ea-10f5-407c-a31f-d0d74ce12f27
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# デザイナー コントロールへのカスタム アクティビティ プロパティのバインド
+テキスト ボックスのデザイナー コントロールをアクティビティ引数にバインドする方法はきわめて簡単ですが、コンボ ボックスなどの複合デザイナー コントロールをアクティビティ引数にバインドする場合は困難が伴うことがあります。このトピックでは、カスタム アクティビティ デザイナーでアクティビティ引数をコンボ ボックス コントロールにバインドする方法について説明します。  
+  
+#### コンボ ボックス項目コンバーターの作成  
+  
+1.  Visual Studio で、CustomProperty という名前で新しい空のソリューションを作成します。  
+  
+2.  ComboBoxItemConverter という名前で新しいクラスを作成します。System.Windows.Data に参照を追加し、<xref:System.Windows.Data.IValueConverter> の派生クラスを使用できるようにします。Visual Studio で、<xref:System.Windows.Data.IValueConverter.Convert%2A> および <xref:System.Windows.Data.IValueConverter.ConvertBack%2A> のスタブを生成するインターフェイスを実装します。  
+  
+3.  <xref:System.Windows.Data.IValueConverter.Convert%2A> メソッドに次のコードを追加します。次のコードはアクティビティの <xref:System.String> 型の <xref:System.Activities.InArgument%601> をデザイナーに配置される値に変換します。  
+  
+    ```  
+    ModelItem modelItem = value as ModelItem;  
+    if (value != null)  
+    {  
+        InArgument<string> inArgument = modelItem.GetCurrentValue() as InArgument<string>;  
+  
+        if (inArgument != null)  
+        {  
+            Activity<string> expression = inArgument.Expression;  
+            VisualBasicValue<string> vbexpression = expression as VisualBasicValue<string>;  
+            Literal<string> literal = expression as Literal<string>;  
+  
+            if (literal != null)  
+            {  
+                return "\"" + literal.Value + "\"";  
+            }  
+            else if (vbexpression != null)  
+            {  
+                return vbexpression.ExpressionText;  
+            }  
+        }  
+    }  
+    return null;  
+  
+    ```  
+  
+     上のコード スペニットにおける式も、<xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> の代わりに <xref:Microsoft.CSharp.Activities.CSharpValue%601> を使用して作成できます。  
+  
+    ```  
+    ModelItem modelItem = value as ModelItem;  
+    if (value != null)  
+    {  
+        InArgument<string> inArgument = modelItem.GetCurrentValue() as InArgument<string>;  
+  
+        if (inArgument != null)  
+        {  
+            Activity<string> expression = inArgument.Expression;  
+            CSharpValue<string> csexpression = expression as CSharpValue<string>;  
+            Literal<string> literal = expression as Literal<string>;  
+  
+            if (literal != null)  
+            {  
+                return "\"" + literal.Value + "\"";  
+            }  
+            else if (csexpression != null)  
+            {  
+                return csexpression.ExpressionText;  
+            }  
+        }  
+    }  
+    return null;  
+  
+    ```  
+  
+4.  <xref:System.Windows.Data.IValueConverter.ConvertBack%2A> メソッドに次のコードを追加します。このコードは受信コンボ ボックス項目を <xref:System.Activities.InArgument%601> に戻します。  
+  
+    ```  
+    // Convert combo box value to InArgument<string>  
+                string itemContent = (string)((ComboBoxItem)value).Content;  
+                VisualBasicValue<string> vbArgument = new VisualBasicValue<string>(itemContent);  
+                InArgument<string> inArgument = new InArgument<string>(vbArgument);  
+                return inArgument;  
+  
+    ```  
+  
+     上のコード スペニットにおける式も、<xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> の代わりに <xref:Microsoft.CSharp.Activities.CSharpValue%601> を使用して作成できます。  
+  
+    ```  
+    // Convert combo box value to InArgument<string>  
+                string itemContent = (string)((ComboBoxItem)value).Content;  
+                CSharpValue<string> csArgument = new CSharpValue<string>(itemContent);  
+                InArgument<string> inArgument = new InArgument<string>(csArgument);  
+                return inArgument;  
+  
+    ```  
+  
+#### アクティビティのカスタム デザイナーへの ComboBoxItemConverter の追加  
+  
+1.  新しい項目をプロジェクトに追加します。\[新しい項目\] ダイアログ ボックスで \[ワークフロー\] ノードを選択し、新しい項目の種類として \[アクティビティ デザイナー\] を選択します。項目に CustomPropertyDesigner という名前を付けます。  
+  
+2.  新しいデザイナーにコンボ ボックスを追加します。Items プロパティには、コンボ ボックスに 2 つの項目を追加し、コンテンツの値に "Item1" および "Item2" を指定します。  
+  
+3.  コンボ ボックスの XAML を変更し、新しい項目コンバーターをコンボ ボックスに使用する項目コンバーターとして追加します。コンバーターは ActivityDesigner.Resources セグメントにリソースとして追加され、<xref:System.Windows.Controls.ComboBox> の Converter 属性にコンバーターを指定します。プロジェクトの名前空間はアクティビティ デザイナーの名前空間属性で指定します。デザイナーを別のプロジェクトで使用する場合は、この名前空間を変更する必要があります。  
+  
+    ```  
+    <sap:ActivityDesigner x:Class="CustomProperty.CustomPropertyDesigner"  
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+        xmlns:c="clr-namespace:CustomProperty"  
+        xmlns:sap="clr-namespace:System.Activities.Presentation;assembly=System.Activities.Presentation"  
+        xmlns:sapv="clr-namespace:System.Activities.Presentation.View;assembly=System.Activities.Presentation">  
+  
+        <sap:ActivityDesigner.Resources>  
+            <ResourceDictionary>  
+                <c:ComboBoxItemConverter x:Key="comboBoxItemConverter"/>  
+            </ResourceDictionary>  
+        </sap:ActivityDesigner.Resources>  
+        <Grid>  
+            <ComboBox SelectedValue="{Binding Path=ModelItem.Text, Mode=TwoWay, Converter={StaticResource comboBoxItemConverter}}"  Height="23" HorizontalAlignment="Left" Margin="132,5,0,0" Name="comboBox1" VerticalAlignment="Top" Width="120" ItemsSource="{Binding}">  
+                <ComboBoxItem>item1</ComboBoxItem>  
+                <ComboBoxItem>item2</ComboBoxItem>  
+            </ComboBox>  
+        </Grid>  
+    </sap:ActivityDesigner>  
+  
+    ```  
+  
+4.  <xref:System.Activities.CodeActivity> 型の新しい項目を作成します。この例では、アクティビティの IDE によって作成された既定のコードで十分です。  
+  
+5.  クラス定義に次の属性を追加します。  
+  
+    ```  
+    [Designer(typeof(CustomPropertyDesigner))]  
+  
+    ```  
+  
+     この行は、新しいデザイナーを新しいクラスに関連付けます。  
+  
+ これで新しいアクティビティがデザイナーに関連付けられました。新しいアクティビティをテストするには、アクティビティをワークフローに追加し、コンボ ボックスに 2 つの値を設定します。プロパティ ウィンドウが更新されてコンボ ボックスの値が反映されます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/bookmarks.md b/docs/framework/windows-workflow-foundation/bookmarks.md
new file mode 100644
index 00000000000..7d1e7bfaaec
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/bookmarks.md
@@ -0,0 +1,122 @@
+---
+title: "ブックマーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b51a346-09ae-455c-a70a-e2264ddeb9e2
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ブックマーク
+ブックマークは、ワークフローのスレッド上に保持することなく、アクティビティが受動的に入力を待機できるようにする機構です。アクティビティが働きかけを待機していることを示すときは、ブックマークを作成できます。これは、現在実行中の \(<xref:System.Activities.Bookmark> を作成した\) メソッドから返された場合でも、アクティビティの実行が完了していると見なさないことをランタイムに対して示します。  
+  
+## ブックマークの基本  
+ <xref:System.Activities.Bookmark> は、ワークフロー インスタンス内で実行を再開できるポイント \(および入力を渡すことができるポイント\) を表します。通常、<xref:System.Activities.Bookmark> には名前が付けられ、外部 \(ホストまたは拡張\) コードで、関連データを含むブックマークを再開する処理を実行します。<xref:System.Activities.Bookmark> を再開すると、ワークフロー ランタイムは、作成時に、その <xref:System.Activities.Bookmark> と関連付けられた <xref:System.Activities.BookmarkCallback> のデリゲートをスケジュールします。  
+  
+## ブックマークのオプション  
+ <xref:System.Activities.BookmarkOptions> クラスは、作成する <xref:System.Activities.Bookmark> の種類を指定します。互いに矛盾しない値として、<xref:System.Activities.BookmarkOptions>、<xref:System.Activities.BookmarkOptions>、および <xref:System.Activities.BookmarkOptions> があります。1 度のみ再開される想定の <xref:System.Activities.Bookmark> を作成する場合、既定では <xref:System.Activities.BookmarkOptions> を使用します。複数回再開できる <xref:System.Activities.Bookmark> を作成する場合は、<xref:System.Activities.BookmarkOptions> を使用します。再開しない <xref:System.Activities.Bookmark> を作成する場合は、<xref:System.Activities.BookmarkOptions> を使用します。既定の <xref:System.Activities.BookmarkOptions> を使用して作成されるブックマークとは異なり、<xref:System.Activities.BookmarkOptions> ブックマークはアクティビティの完了を妨げません。  
+  
+## ブックマークの再開  
+ ブックマークは、ワークフロー以外のコードから、<xref:System.Activities.WorkflowApplication.ResumeBookmark%2A> オーバーロードのいずれかを使用して再開できます。この例では、`ReadLine` アクティビティが作成されます。実行されると、`ReadLine` アクティビティは <xref:System.Activities.Bookmark> を作成し、コールバックを登録してから、<xref:System.Activities.Bookmark> が再開されるのを待機します。再開されると、`ReadLine` アクティビティは <xref:System.Activities.Bookmark> と一緒に渡されたデータを <xref:System.Activities.Activity%601.Result%2A> 引数に割り当てます。  
+  
+```csharp  
+public sealed class ReadLine : NativeActivity<string>  
+{  
+    [RequiredArgument]  
+    public  InArgument<string> BookmarkName { get; set; }  
+  
+    protected override void Execute(NativeActivityContext context)  
+    {  
+        // Create a Bookmark and wait for it to be resumed.  
+        context.CreateBookmark(BookmarkName.Get(context),   
+            new BookmarkCallback(OnResumeBookmark));  
+    }  
+  
+    // NativeActivity derived activities that do asynchronous operations by calling   
+    // one of the CreateBookmark overloads defined on System.Activities.NativeActivityContext   
+    // must override the CanInduceIdle property and return true.  
+    protected override bool CanInduceIdle  
+    {  
+        get { return true; }  
+    }  
+  
+    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)  
+    {  
+        // When the Bookmark is resumed, assign its value to  
+        // the Result argument.  
+        Result.Set(context, (string)obj);  
+    }  
+}  
+```  
+  
+ 次の例では、`ReadLine` アクティビティを使用してユーザー名を収集し、それをコンソール ウィンドウに表示するワークフローを作成します。ホスト アプリケーションは入力を収集する実際の作業を実行し、<xref:System.Activities.Bookmark> を再開することでワークフローに渡します。  
+  
+```csharp  
+Variable<string> name = new Variable<string>  
+{  
+    Name = "name"  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables =  
+    {  
+        name  
+    },  
+    Activities =  
+    {  
+        new WriteLine()  
+        {  
+            Text = "What is your name?"  
+        },  
+        new ReadLine()  
+        {  
+            BookmarkName = "UserName",  
+            Result = name  
+        },  
+        new WriteLine()  
+        {  
+            Text = new InArgument<string>((env) => "Hello, " + name.Get(env))  
+        }  
+    }  
+};  
+  
+AutoResetEvent syncEvent = new AutoResetEvent(false);  
+  
+// Create the WorkflowApplication using the desired  
+// workflow definition.  
+WorkflowApplication wfApp = new WorkflowApplication(wf);  
+  
+// Handle the desired lifecycle events.  
+wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)  
+{  
+    // Signal the host that the workflow is complete.  
+    syncEvent.Set();  
+};  
+  
+// Start the workflow.  
+wfApp.Run();  
+  
+// Collect the user's name and resume the bookmark.  
+// Bookmark resumption only occurs when the workflow  
+// is idle. If a call to ResumeBookmark is made and the workflow  
+// is not idle, ResumeBookmark blocks until the workflow becomes  
+// idle before resuming the bookmark.  
+wfApp.ResumeBookmark("UserName", Console.ReadLine());  
+  
+// Wait for Completed to arrive and signal that  
+// the workflow is complete.  
+syncEvent.WaitOne();  
+```  
+  
+ `ReadLine` アクティビティが実行されると、`UserName` という名前の <xref:System.Activities.Bookmark> が作成され、ブックマークが再開されるのを待機します。ホストは必要なデータを収集し、<xref:System.Activities.Bookmark> を再開します。ワークフローが再開されると名前が表示されて、完了します。ブックマークの再開に関して、同期コードは必要ありません。<xref:System.Activities.Bookmark> を再開できるのは、ワークフローがアイドルの場合のみです。ワークフローがアイドルではない場合、<xref:System.Activities.WorkflowApplication.ResumeBookmark%2A> を呼び出すと、ワークフローがアイドルになるまでブロックされます。  
+  
+## ブックマークの再開結果  
+ <xref:System.Activities.WorkflowApplication.ResumeBookmark%2A> は、ブックマークの再開要求の結果を示す <xref:System.Activities.BookmarkResumptionResult> 列挙値を返します。戻り値には <xref:System.Activities.BookmarkResumptionResult>、<xref:System.Activities.BookmarkResumptionResult>、および <xref:System.Activities.BookmarkResumptionResult> があります。ホストと拡張ではこの値を使用して処理の進め方を決定します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/collection-activities-in-wf.md b/docs/framework/windows-workflow-foundation/collection-activities-in-wf.md
new file mode 100644
index 00000000000..2f62847d19a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/collection-activities-in-wf.md
@@ -0,0 +1,438 @@
+---
+title: "WF 内のコレクション アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2680c3e2-9902-4968-b98d-cab776103dbe
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WF 内のコレクション アクティビティ
+コレクション アクティビティはワークフローのコレクション オブジェクトの作業に使用します。  [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、コレクション内の項目の追加および削除、コレクション内の項目の存在を確認するテスト、およびコレクションの消去を行うシステム標準アクティビティがあります。  `ExistsInCollection` および `RemoveFromCollectio`n に、結果を示す <xref:System.Activities.OutArgument%601> 型の <xref:System.Boolean> があります。  
+  
+> [!IMPORTANT]
+>  コレクション アクティビティが、基礎となるコレクション オブジェクトの設定前に実行された場合、<xref:System.InvalidOperationException> がスローされ、アクティビティは失敗します。  
+  
+## コレクション アクティビティ  
+  
+|||  
+|-|-|  
+|<xref:System.Activities.Statements.AddToCollection%601>|指定したコレクションに項目を追加します。|  
+|<xref:System.Activities.Statements.ClearCollection%601>|指定したコレクションからすべての項目を削除します。|  
+|<xref:System.Activities.Statements.ExistsInCollection%601>|項目がコレクション内に存在する場合、`true` を返します。|  
+|<xref:System.Activities.Statements.RemoveFromCollection%601>|指定したコレクションから項目を削除し、項目が正常に削除された場合は `true` を返します。|  
+  
+## コレクション アクティビティの使用  
+ 次のコードは、ワークフロー変数として宣言されたコレクションとやり取りする方法の例です。  使用するコレクションは、<xref:System.Collections.Generic.List%E2%80%991> という <xref:System.String> オブジェクトの `fruitList` です。  
+  
+```csharp  
+Variable<ICollection<string>> fruitList = new Variable<ICollection<string>>  
+{  
+    Default = new VisualBasicValue<ICollection<string>>("New List(Of String) From {\"Apple\", \"Orange\"}"),  
+    Name = "FruitList"  
+};  
+  
+Variable<bool> result = new Variable<bool>  
+{  
+    Name = "Result"  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables = { fruitList, result },  
+  
+    Activities =   
+    {  
+        new If  
+        {  
+            Condition = new ExistsInCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Pear"  
+            },  
+            Then = new AddToCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Pear"  
+            },  
+            Else = new RemoveFromCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Apple"  
+            }  
+        },  
+  
+        new RemoveFromCollection<string>  
+        {  
+            Collection = fruitList,  
+            Item = "Apple",  
+            Result = result  
+        },  
+        new If  
+        {  
+            Condition = result,  
+            Then = new ClearCollection<string>  
+            {  
+                Collection = fruitList,  
+            }  
+        }  
+    }  
+};  
+  
+```  
+  
+```xaml  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:scg="clr-namespace:System.Collections.Generic;assembly=mscorlib"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <Sequence.Variables>  
+    <x:Reference>__ReferenceID0</x:Reference>  
+    <x:Reference>__ReferenceID1</x:Reference>  
+  </Sequence.Variables>  
+  <If>  
+    <If.Condition>  
+      <InArgument  
+         x:TypeArguments="x:Boolean">  
+        <ExistsInCollection  
+           x:TypeArguments="x:String"  
+           Item="Pear">  
+          <ExistsInCollection.Result>  
+            <OutArgument  
+               x:TypeArguments="x:Boolean" />  
+          </ExistsInCollection.Result>  
+          <InArgument  
+             x:TypeArguments="scg:ICollection(x:String)">  
+            <VariableValue  
+               x:TypeArguments="scg:ICollection(x:String)">  
+              <VariableValue.Result>  
+                <OutArgument  
+                   x:TypeArguments="scg:ICollection(x:String)" />  
+              </VariableValue.Result>  
+              <VariableValue.Variable>  
+                <Variable  
+                   x:TypeArguments="scg:ICollection(x:String)"  
+                   x:Name="__ReferenceID0"  
+                   Default="[New List(Of String) From {"Apple", "Orange"}]"  
+                   Name="FruitList" />  
+              </VariableValue.Variable>  
+            </VariableValue>  
+          </InArgument>  
+        </ExistsInCollection>  
+      </InArgument>  
+    </If.Condition>  
+    <If.Then>  
+      <AddToCollection  
+         x:TypeArguments="x:String"  
+         Item="Pear">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </AddToCollection>  
+    </If.Then>  
+    <If.Else>  
+      <RemoveFromCollection  
+         x:TypeArguments="x:String"  
+         Item="Apple"  
+         Result="{x:Null}">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </RemoveFromCollection>  
+    </If.Else>  
+  </If>  
+  <RemoveFromCollection  
+     x:TypeArguments="x:String"  
+     Item="Apple">  
+    <RemoveFromCollection.Result>  
+      <OutArgument  
+         x:TypeArguments="x:Boolean">  
+        <VariableReference  
+           x:TypeArguments="x:Boolean">  
+          <VariableReference.Result>  
+            <OutArgument  
+               x:TypeArguments="Location(x:Boolean)" />  
+          </VariableReference.Result>  
+          <VariableReference.Variable>  
+            <Variable  
+               x:TypeArguments="x:Boolean"  
+               x:Name="__ReferenceID1"  
+               Name="Result" />  
+          </VariableReference.Variable>  
+        </VariableReference>  
+      </OutArgument>  
+    </RemoveFromCollection.Result>  
+    <InArgument  
+       x:TypeArguments="scg:ICollection(x:String)">  
+      <VariableValue  
+         x:TypeArguments="scg:ICollection(x:String)"  
+         Variable="{x:Reference __ReferenceID0}">  
+        <VariableValue.Result>  
+          <OutArgument  
+             x:TypeArguments="scg:ICollection(x:String)" />  
+        </VariableValue.Result>  
+      </VariableValue>  
+    </InArgument>  
+  </RemoveFromCollection>  
+  <If>  
+    <If.Condition>  
+      <InArgument  
+         x:TypeArguments="x:Boolean">  
+        <VariableValue  
+           x:TypeArguments="x:Boolean"  
+           Variable="{x:Reference __ReferenceID1}">  
+          <VariableValue.Result>  
+            <OutArgument  
+               x:TypeArguments="x:Boolean" />  
+          </VariableValue.Result>  
+        </VariableValue>  
+      </InArgument>  
+    </If.Condition>  
+    <If.Then>  
+      <ClearCollection  
+         x:TypeArguments="x:String">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </ClearCollection>  
+    </If.Then>  
+  </If>  
+</Sequence>  
+  
+```  
+  
+ 上のコード サンプルは、<xref:Microsoft.CSharp.Activities.CSharpValue%601> の代わりに <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> を使用しても作成できます。  
+  
+```  
+Variable<ICollection<string>> fruitList = new Variable<ICollection<string>>  
+{  
+    Default = new CSharpValue<ICollection<string>>("new List<String> From {\"Apple\", \"Orange\"};"),  
+    Name = "FruitList"  
+};  
+  
+Variable<bool> result = new Variable<bool>  
+{  
+    Name = "Result"  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables = { fruitList, result },  
+  
+    Activities =   
+    {  
+        new If  
+        {  
+            Condition = new ExistsInCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Pear"  
+            },  
+            Then = new AddToCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Pear"  
+            },  
+            Else = new RemoveFromCollection<string>  
+            {  
+                Collection = fruitList,  
+                Item = "Apple"  
+            }  
+        },  
+  
+        new RemoveFromCollection<string>  
+        {  
+            Collection = fruitList,  
+            Item = "Apple",  
+            Result = result  
+        },  
+        new If  
+        {  
+            Condition = result,  
+            Then = new ClearCollection<string>  
+            {  
+                Collection = fruitList,  
+            }  
+        }  
+    }  
+};  
+  
+```  
+  
+```  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:scg="clr-namespace:System.Collections.Generic;assembly=mscorlib"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <Sequence.Variables>  
+    <x:Reference>__ReferenceID0</x:Reference>  
+    <x:Reference>__ReferenceID1</x:Reference>  
+  </Sequence.Variables>  
+  <If>  
+    <If.Condition>  
+      <InArgument  
+         x:TypeArguments="x:Boolean">  
+        <ExistsInCollection  
+           x:TypeArguments="x:String"  
+           Item="Pear">  
+          <ExistsInCollection.Result>  
+            <OutArgument  
+               x:TypeArguments="x:Boolean" />  
+          </ExistsInCollection.Result>  
+          <InArgument  
+             x:TypeArguments="scg:ICollection(x:String)">  
+            <VariableValue  
+               x:TypeArguments="scg:ICollection(x:String)">  
+              <VariableValue.Result>  
+                <OutArgument  
+                   x:TypeArguments="scg:ICollection(x:String)" />  
+              </VariableValue.Result>  
+              <VariableValue.Variable>  
+                <Variable  
+                   x:TypeArguments="scg:ICollection(x:String)"  
+                   x:Name="__ReferenceID0"  
+                   Default="[new List<String> From {"Apple", "Orange"};]"  
+                   Name="FruitList" />  
+              </VariableValue.Variable>  
+            </VariableValue>  
+          </InArgument>  
+        </ExistsInCollection>  
+      </InArgument>  
+    </If.Condition>  
+    <If.Then>  
+      <AddToCollection  
+         x:TypeArguments="x:String"  
+         Item="Pear">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </AddToCollection>  
+    </If.Then>  
+    <If.Else>  
+      <RemoveFromCollection  
+         x:TypeArguments="x:String"  
+         Item="Apple"  
+         Result="{x:Null}">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </RemoveFromCollection>  
+    </If.Else>  
+  </If>  
+  <RemoveFromCollection  
+     x:TypeArguments="x:String"  
+     Item="Apple">  
+    <RemoveFromCollection.Result>  
+      <OutArgument  
+         x:TypeArguments="x:Boolean">  
+        <VariableReference  
+           x:TypeArguments="x:Boolean">  
+          <VariableReference.Result>  
+            <OutArgument  
+               x:TypeArguments="Location(x:Boolean)" />  
+          </VariableReference.Result>  
+          <VariableReference.Variable>  
+            <Variable  
+               x:TypeArguments="x:Boolean"  
+               x:Name="__ReferenceID1"  
+               Name="Result" />  
+          </VariableReference.Variable>  
+        </VariableReference>  
+      </OutArgument>  
+    </RemoveFromCollection.Result>  
+    <InArgument  
+       x:TypeArguments="scg:ICollection(x:String)">  
+      <VariableValue  
+         x:TypeArguments="scg:ICollection(x:String)"  
+         Variable="{x:Reference __ReferenceID0}">  
+        <VariableValue.Result>  
+          <OutArgument  
+             x:TypeArguments="scg:ICollection(x:String)" />  
+        </VariableValue.Result>  
+      </VariableValue>  
+    </InArgument>  
+  </RemoveFromCollection>  
+  <If>  
+    <If.Condition>  
+      <InArgument  
+         x:TypeArguments="x:Boolean">  
+        <VariableValue  
+           x:TypeArguments="x:Boolean"  
+           Variable="{x:Reference __ReferenceID1}">  
+          <VariableValue.Result>  
+            <OutArgument  
+               x:TypeArguments="x:Boolean" />  
+          </VariableValue.Result>  
+        </VariableValue>  
+      </InArgument>  
+    </If.Condition>  
+    <If.Then>  
+      <ClearCollection  
+         x:TypeArguments="x:String">  
+        <InArgument  
+           x:TypeArguments="scg:ICollection(x:String)">  
+          <VariableValue  
+             x:TypeArguments="scg:ICollection(x:String)"  
+             Variable="{x:Reference __ReferenceID0}">  
+            <VariableValue.Result>  
+              <OutArgument  
+                 x:TypeArguments="scg:ICollection(x:String)" />  
+            </VariableValue.Result>  
+          </VariableValue>  
+        </InArgument>  
+      </ClearCollection>  
+    </If.Then>  
+  </If>  
+</Sequence>  
+  
+```  
+  
+## 参照  
+ [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/compensation.md b/docs/framework/windows-workflow-foundation/compensation.md
new file mode 100644
index 00000000000..f780f32f93b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/compensation.md
@@ -0,0 +1,336 @@
+---
+title: "補正 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 722e9766-48d7-456c-9496-d7c5c8f0fa76
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 補正
+[!INCLUDE[wf](../../../includes/wf-md.md)] の補正は、エラーが発生した場合に、前に完了した作業を \(アプリケーションで定義されるロジックに応じて\) 取り消したり補正したりできる機構です。ここでは、ワークフローで補正を使用する方法について説明します。  
+  
+## 補正とトランザクション  
+ トランザクションを使用することで、複数の操作を 1 つの作業単位にまとめることができます。アプリケーションでトランザクションを使用すると、トランザクションのプロセスでエラーが発生した場合、トランザクション内で実行されたすべての変更を中止 \(ロールバック\) できます。ただし、作業が長時間実行されている場合は、トランザクションの使用が適切でないことがあります。たとえば、旅行計画用アプリケーションはワークフローとして実装されます。このワークフローの手順は、フライトの予約、マネージャーによる承認の待機、およびチケットの支払いで構成されていることがあります。このプロセスには数日かかる場合があり、フライトの予約と支払いの手順を同じトランザクションに参加させるのは実用的ではありません。このようなシナリオでは、処理の後半でエラーが発生した場合、補正を使用してワークフローの予約の手順を取り消すことができます。  
+  
+> [!NOTE]
+>  このトピックでは、ワーク フローの補正について説明します。[!INCLUDE[crabout](../../../includes/crabout-md.md)] ワークフロー内でのトランザクションについては、[トランザクション](../../../docs/framework/windows-workflow-foundation//workflow-transactions.md) と <xref:System.Activities.Statements.TransactionScope> を参照してください。[!INCLUDE[crabout](../../../includes/crabout-md.md)] トランザクションについては、<xref:System.Transactions?displayProperty=fullName> と <xref:System.Transactions.Transaction?displayProperty=fullName> を参照してください。  
+  
+## CompensableActivity の使用  
+ <xref:System.Activities.Statements.CompensableActivity> は、[!INCLUDE[wf1](../../../includes/wf1-md.md)] の中心的な補正アクティビティです。補正が必要な可能性がある作業を実行するアクティビティは、すべて <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> に配置されます。この例では、航空券を購入する予約手順を <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> に配置し、予約の取り消しを <xref:System.Activities.Statements.CompensableActivity.CompensationHandler%2A> に配置します。ワークフロー内の <xref:System.Activities.Statements.CompensableActivity> の直後には、マネージャーの承認を待ち、航空券の購入手順を完了するという 2 つのアクティビティがあります。<xref:System.Activities.Statements.CompensableActivity> が正常に完了した後に、エラー条件によってワークフローが取り消された場合、<xref:System.Activities.Statements.CompensableActivity.CompensationHandler%2A> ハンドラー内のアクティビティがスケジュールされ、航空券は取り消されます。  
+  
+ [!code-csharp[CFX_CompensationExample#1](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_CompensationExample/cs/Program.cs#1)]  
+  
+ 次の例は XAML のワークフローです。  
+  
+```xaml  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:c="clr-namespace:CompensationExample;assembly=CompensationExample"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <CompensableActivity>  
+    <CompensableActivity.Result>  
+      <OutArgument  
+         x:TypeArguments="CompensationToken" />  
+    </CompensableActivity.Result>  
+    <CompensableActivity.CompensationHandler>  
+      <c:CancelFlight />  
+    </CompensableActivity.CompensationHandler>  
+    <c:ReserveFlight />  
+  </CompensableActivity>  
+  <c:ManagerApproval />  
+  <c:PurchaseFlight />  
+</Sequence>  
+```  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **ReserveFlight: チケットが予約されました。**   
+**ManagerApproval: マネージャーの承認を受けました。**   
+**PurchaseFlight: チケットが購入されました。**   
+**ワークフローは Closed の状態で正常に完了しました。**    
+> [!NOTE]
+>  `ReserveFlight` などのこのトピックのサンプル アクティビティでは、コンソールにアクティビティの名前や目的が表示されるため、補正が行われるときのアクティビティの順序がわかりやすくなっています。  
+  
+### 既定のワークフローの補正  
+ 既定では、ワークフローを取り消すと、正常に完了済みであるがまだ確認または補正されていない補正可能なアクティビティに対して、補正ロジックが実行されます。  
+  
+> [!NOTE]
+>  <xref:System.Activities.Statements.CompensableActivity> を*確認*すると、そのアクティビティの補正は呼び出すことができなくなります。確認プロセスについては、このセクションの後半で説明します。  
+  
+ この例では、航空券の予約後かつマネージャーの承認手順前に例外がスローされます。  
+  
+ [!code-csharp[CFX_CompensationExample#2](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_CompensationExample/cs/Program.cs#2)]  
+  
+ この例は XAML のワークフローです。  
+  
+```xaml  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:c="clr-namespace:CompensationExample;assembly=CompensationExample"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <CompensableActivity>  
+    <CompensableActivity.Result>  
+      <OutArgument  
+         x:TypeArguments="CompensationToken" />  
+    </CompensableActivity.Result>  
+    <CompensableActivity.CompensationHandler>  
+      <c:CancelFlight />  
+    </CompensableActivity.CompensationHandler>  
+    <c:ReserveFlight />  
+  </CompensableActivity>  
+  <c:SimulatedErrorCondition />  
+  <c:ManagerApproval />  
+  <c:PurchaseFlight />  
+</Sequence>  
+```  
+  
+ [!code-csharp[CFX_CompensationExample#100](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_CompensationExample/cs/Program.cs#100)]  
+  
+ ワークフローが呼び出されると、シミュレートされたエラー状態の例外が <xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> のホスト アプリケーションで処理されて、ワークフローが取り消され、補正ロジックが呼び出されます。  
+  
+ **ReserveFlight: チケットが予約されました。**   
+**SimulatedErrorCondition: ApplicationException をスローします。**   
+**ワークフロー未処理の例外:**   
+**System.ApplicationException: ワーク フローのシミュレートされたエラー状態。**   
+**CancelFlight: チケットは取り消されました。**   
+**ワークフローは Canceled の状態で正常に完了しました。**    
+### 取り消しと CompensableActivity  
+ <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> 内のアクティビティが完了せず、アクティビティが取り消されると、<xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> が実行されます。  
+  
+> [!NOTE]
+>  <xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> が呼び出されるのは、<xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> 内のアクティビティが完了せず、アクティビティが取り消された場合だけです。<xref:System.Activities.Statements.CompensableActivity.CompensationHandler%2A> は、<xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> 内のアクティビティが正常に完了し、その後にアクティビティで補正が呼び出された場合にのみ実行されます。  
+  
+ <xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> を使用すると、ワークフローの作成者は、適切な取り消しロジックを指定できます。次の例では、<xref:System.Activities.Statements.CompensableActivity.Body%2A> の実行中に例外がスローされてから、<xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> が呼び出されます。  
+  
+```csharp  
+Activity wf = new Sequence()  
+{  
+    Activities =  
+    {  
+        new CompensableActivity  
+        {  
+            Body = new Sequence  
+            {  
+                Activities =   
+                {  
+                    new ChargeCreditCard(),  
+                    new SimulatedErrorCondition(),  
+                    new ReserveFlight()  
+                }  
+            },  
+            CompensationHandler = new CancelFlight(),  
+            CancellationHandler = new CancelCreditCard()  
+        },  
+        new ManagerApproval(),  
+        new PurchaseFlight()  
+    }  
+};  
+  
+```  
+  
+ この例は XAML のワークフローです。  
+  
+```xaml  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:c="clr-namespace:CompensationExample;assembly=CompensationExample"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <CompensableActivity>  
+    <CompensableActivity.Result>  
+      <OutArgument  
+         x:TypeArguments="CompensationToken" />  
+    </CompensableActivity.Result>  
+    <Sequence>  
+      <c:ChargeCreditCard />  
+      <c:SimulatedErrorCondition />  
+      <c:ReserveFlight />  
+    </Sequence>  
+    <CompensableActivity.CancellationHandler>  
+      <c:CancelCreditCard />  
+    </CompensableActivity.CancellationHandler>  
+    <CompensableActivity.CompensationHandler>  
+      <c:CancelFlight />  
+    </CompensableActivity.CompensationHandler>  
+  </CompensableActivity>  
+  <c:ManagerApproval />  
+  <c:PurchaseFlight />  
+</Sequence>  
+```  
+  
+ ワークフローが呼び出されると、シミュレートされたエラー状態の例外が、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> のホスト アプリケーションで処理されて、ワークフローが取り消され、<xref:System.Activities.Statements.CompensableActivity> の取り消しロジックが呼び出されます。この例では、補正ロジックと取り消しロジックの目的は異なります<xref:System.Activities.Statements.CompensableActivity.Body%2A> が正常に完了した場合、これはクレジット カードに課金されてフライトが予約されたことを意味するので、補正で両方の手順を取り消す必要があります\(この例では、航空券を取り消すとクレジット カードへの課金が自動的に取り消されます\)。ただし、<xref:System.Activities.Statements.CompensableActivity> が取り消される場合、これは <xref:System.Activities.Statements.CompensableActivity.Body%2A> が完了しなかったことを意味するので、<xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> のロジックが取り消しを一番うまく処理する方法を決定できる必要があります。この例では、 <xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> はクレジット カードへの課金を取り消しますが、`ReserveFlight` は <xref:System.Activities.Statements.CompensableActivity.Body%2A> の最後のアクティビティなので、航空券の取り消しを試みません。`ReserveFlight` は <xref:System.Activities.Statements.CompensableActivity.Body%2A> の最後のアクティビティなので、そのアクティビティが正常に完了して <xref:System.Activities.Statements.CompensableActivity.Body%2A> が完了すると、取り消しは不可能となります。  
+  
+ **ChargeCreditCard: 航空券の料金をクレジット カードに請求します。**   
+**SimulatedErrorCondition: ApplicationException をスローします。**   
+**ワークフロー未処理の例外:**   
+**System.ApplicationException: ワーク フローのシミュレートされたエラー状態。**   
+**CancelCreditCard: クレジット カードへの課金を取り消します。**   
+**ワークフローは Canceled の状態で正常に完了しました。**  取り消し[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[取り消し](../../../docs/framework/windows-workflow-foundation//modeling-cancellation-behavior-in-workflows.md)」を参照してください。  
+  
+### Compensate アクティビティを使用した明示的な補正  
+ 前のセクションでは、暗黙的な補正について説明しました。暗黙的な補正は単純なシナリオには適していますが、補正処理のスケジュールに関して、より明示的な制御が必要な場合は、<xref:System.Activities.Statements.Compensate> アクティビティを使用できます。<xref:System.Activities.Statements.Compensate> アクティビティを使用して補正プロセスを開始するには、補正が望ましい <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensationToken> を使用します。<xref:System.Activities.Statements.Compensate> アクティビティは、完了した <xref:System.Activities.Statements.CompensableActivity> で、まだ確認または補正されていない場合に補正を開始するときに使用できます。たとえば、<xref:System.Activities.Statements.Compensate> アクティビティは、<xref:System.Activities.Statements.TryCatch.Catches%2A> アクティビティの  <xref:System.Activities.Statements.TryCatch> セクションで使用できるし、または <xref:System.Activities.Statements.CompensableActivity> の完了後にいつでも使用できます。この例では、<xref:System.Activities.Statements.Compensate> アクティビティを <xref:System.Activities.Statements.TryCatch.Catches%2A> アクティビティの <xref:System.Activities.Statements.TryCatch> セクションで使用して、<xref:System.Activities.Statements.CompensableActivity> のアクションを反転します。  
+  
+ [!code-csharp[CFX_CompensationExample#3](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_CompensationExample/cs/Program.cs#3)]  
+  
+ この例は XAML のワークフローです。  
+  
+```xaml  
+<TryCatch  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:c="clr-namespace:CompensationExample;assembly=CompensationExample"  
+   xmlns:s="clr-namespace:System;assembly=mscorlib"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <TryCatch.Variables>  
+    <Variable  
+       x:TypeArguments="CompensationToken"  
+       x:Name="__ReferenceID0"  
+       Name="token1" />  
+  </TryCatch.Variables>  
+  <TryCatch.Try>  
+    <Sequence>  
+      <CompensableActivity>  
+        <CompensableActivity.Result>  
+          <OutArgument  
+             x:TypeArguments="CompensationToken">  
+            <VariableReference  
+               x:TypeArguments="CompensationToken"  
+               Variable="{x:Reference __ReferenceID0}">  
+              <VariableReference.Result>  
+                <OutArgument  
+                   x:TypeArguments="Location(CompensationToken)" />  
+              </VariableReference.Result>  
+            </VariableReference>  
+          </OutArgument>  
+        </CompensableActivity.Result>  
+        <CompensableActivity.CompensationHandler>  
+          <c:CancelFlight />  
+        </CompensableActivity.CompensationHandler>  
+        <CompensableActivity.ConfirmationHandler>  
+          <c:ConfirmFlight />  
+        </CompensableActivity.ConfirmationHandler>  
+        <c:ReserveFlight />  
+      </CompensableActivity>  
+      <c:SimulatedErrorCondition />  
+      <c:ManagerApproval />  
+      <c:PurchaseFlight />  
+    </Sequence>  
+  </TryCatch.Try>  
+  <TryCatch.Catches>  
+    <Catch  
+       x:TypeArguments="s:ApplicationException">  
+      <ActivityAction  
+         x:TypeArguments="s:ApplicationException">  
+        <Compensate>  
+          <Compensate.Target>  
+            <InArgument  
+               x:TypeArguments="CompensationToken">  
+              <VariableValue  
+                 x:TypeArguments="CompensationToken"  
+                 Variable="{x:Reference __ReferenceID0}">  
+                <VariableValue.Result>  
+                  <OutArgument  
+                     x:TypeArguments="CompensationToken" />  
+                </VariableValue.Result>  
+              </VariableValue>  
+            </InArgument>  
+          </Compensate.Target>  
+        </Compensate>  
+      </ActivityAction>  
+    </Catch>  
+  </TryCatch.Catches>  
+</TryCatch>  
+```  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **ReserveFlight: チケットが予約されました。**   
+**SimulatedErrorCondition: ApplicationException をスローします。**   
+**CancelFlight: チケットは取り消されました。**   
+**ワークフローは Closed の状態で正常に完了しました。**    
+### 補正の確認  
+ 既定で、補正可能なアクティビティは、完了後の任意のタイミングで補正できます。ただし、シナリオによっては適切でない場合があります。前の例では、航空券予約の補正は、予約の取り消しでした。ただし、フライトが完了すると、その後は、この補正手順は有効でなくなります。補正可能なアクティビティを確認すると、<xref:System.Activities.Statements.CompensableActivity.ConfirmationHandler%2A> で指定したアクティビティが呼び出されます。この使用例としては、補正を実行する必要があるリソースを解放できるようになることが挙げられます。補正可能なアクティビティは、確認されると補正できなくなります。この処理が試行されると、<xref:System.InvalidOperationException> 例外がスローされます。ワークフローが正常に完了すると、正常に完了したがまだ確認も補正も実行されていない補正可能なすべてのアクティビティは、補正とは逆の順序で確認されます。この例では、航空券の予約、購入、および完了後に、補正可能なアクティビティが確認されます。<xref:System.Activities.Statements.CompensableActivity> を確認するには、<xref:System.Activities.Statements.Confirm> アクティビティを使用し、<xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensationToken> を指定します。  
+  
+ [!code-csharp[CFX_CompensationExample#4](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_CompensationExample/cs/Program.cs#4)]  
+  
+ この例は XAML のワークフローです。  
+  
+```xaml  
+<Sequence  
+   xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+   xmlns:c="clr-namespace:CompensationExample;assembly=CompensationExample"  
+   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <Sequence.Variables>  
+    <x:Reference>__ReferenceID0</x:Reference>  
+  </Sequence.Variables>  
+  <CompensableActivity>  
+    <CompensableActivity.Result>  
+      <OutArgument  
+         x:TypeArguments="CompensationToken">  
+        <VariableReference  
+           x:TypeArguments="CompensationToken">  
+          <VariableReference.Result>  
+            <OutArgument  
+               x:TypeArguments="Location(CompensationToken)" />  
+          </VariableReference.Result>  
+          <VariableReference.Variable>  
+            <Variable  
+               x:TypeArguments="CompensationToken"  
+               x:Name="__ReferenceID0"  
+               Name="token1" />  
+          </VariableReference.Variable>  
+        </VariableReference>  
+      </OutArgument>  
+    </CompensableActivity.Result>  
+    <CompensableActivity.CompensationHandler>  
+      <c:CancelFlight />  
+    </CompensableActivity.CompensationHandler>  
+    <CompensableActivity.ConfirmationHandler>  
+      <c:ConfirmFlight />  
+    </CompensableActivity.ConfirmationHandler>  
+    <c:ReserveFlight />  
+  </CompensableActivity>  
+  <c:ManagerApproval />  
+  <c:PurchaseFlight />  
+  <c:TakeFlight />  
+  <Confirm>  
+    <Confirm.Target>  
+      <InArgument  
+         x:TypeArguments="CompensationToken">  
+        <VariableValue  
+           x:TypeArguments="CompensationToken"  
+           Variable="{x:Reference __ReferenceID0}">  
+          <VariableValue.Result>  
+            <OutArgument  
+               x:TypeArguments="CompensationToken" />  
+          </VariableValue.Result>  
+        </VariableValue>  
+      </InArgument>  
+    </Confirm.Target>  
+  </Confirm>  
+</Sequence>  
+```  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **ReserveFlight: チケットが予約されました。**   
+**ManagerApproval: マネージャーの承認を受けました。**   
+**PurchaseFlight: チケットが購入されました。**   
+**TakeFlight: 航空券の購入処理が完了しました。**   
+**ConfirmFlight: 航空券の購入処理が完了し、補正が行われる可能性はありません。**   
+**ワークフローは Closed の状態で正常に完了しました。**   
+## 補正アクティビティの入れ子化  
+ <xref:System.Activities.Statements.CompensableActivity> は、別の <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.Body%2A> セクションに配置できます。<xref:System.Activities.Statements.CompensableActivity> は、別の <xref:System.Activities.Statements.CompensableActivity> のハンドラーで処理されない場合があります。親の <xref:System.Activities.Statements.CompensableActivity> が取り消されたとき、確認されたとき、または補正されたとき、正常に完了していてまだ確認または補正されていないすべての子の補正可能なアクティビティを、親が取り消し、確認、または補正を完了する前に、確認または補正されるようにすることは親のそのアクティビティの役割ですです。補正が明示的にモデル化されていない場合、親の <xref:System.Activities.Statements.CompensableActivity> は、親が取り消しまたは補正のシグナルを受け取ったとき、子の補正可能なアクティビティを暗黙的に補正します。親は、確認通知を受け取ると、暗黙的に子の補正可能なアクティビティを確認します。取り消し、確認、または補正を処理するロジックが親の <xref:System.Activities.Statements.CompensableActivity> のハンドラーで明示的にモデル化されている場合、明示的に処理されなかった子は暗黙的に確認されます。  
+  
+## 参照  
+ <xref:System.Activities.Statements.CompensableActivity>   
+ <xref:System.Activities.Statements.Compensate>   
+ <xref:System.Activities.Statements.Confirm>   
+ <xref:System.Activities.Statements.CompensationToken>   
+ [補正可能なアクティビティ](../../../docs/framework/windows-workflow-foundation/samples/compensable-activity-sample.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/conceptual-overview.md b/docs/framework/windows-workflow-foundation/conceptual-overview.md
new file mode 100644
index 00000000000..73579dffd55
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/conceptual-overview.md
@@ -0,0 +1,31 @@
+---
+title: "Windows Workflow の概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF], 概念"
+  - "Windows Workflow Foundation [WF], 概念"
+ms.assetid: 2a5c0ac2-813f-4a7b-83ac-9e5cb85e0640
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Windows Workflow の概念
+このセクションには、[!INCLUDE[wf](../../../includes/wf-md.md)] の背景となる、より大きな概念について説明したトピックが含まれます。  
+  
+## このセクションの内容  
+ [Windows Workflow の概要](../../../docs/framework/windows-workflow-foundation//overview.md)  
+ [!INCLUDE[wv](../../../includes/wv-md.md)]、[!INCLUDE[wxp](../../../includes/wxp-md.md)]、[!INCLUDE[ws2003](../../../includes/ws2003-md.md)]、および [!INCLUDE[lserver](../../../includes/lserver-md.md)] の各オペレーティング システム用に記述されたアプリケーション内でシステム ワークフローまたはヒューマン ワークフローの作成が可能になる基盤について説明します。  
+  
+ [Windows Workflow の基本概念](../../../docs/framework/windows-workflow-foundation//fundamental-concepts.md)  
+ 一部の開発者にとっては耳慣れない [!INCLUDE[wf2](../../../includes/wf2-md.md)] 開発に使用される基礎的な概念について説明します。  
+  
+ [Windows Workflow のアーキテクチャ](../../../docs/framework/windows-workflow-foundation//architecture.md)  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] 開発に使用されるコンポーネントについて説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/configuring-activity-validation.md b/docs/framework/windows-workflow-foundation/configuring-activity-validation.md
new file mode 100644
index 00000000000..45839426b96
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/configuring-activity-validation.md
@@ -0,0 +1,43 @@
+---
+title: "アクティビティ検証の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 25a4eccb-b8fc-4857-a01d-2683b6341219
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# アクティビティ検証の構成
+アクティビティの検証を使用すると、アクティビティの作成者とユーザーは、アクティビティを実行する前に、アクティビティの構成エラーを特定および報告できます。[!INCLUDE[wf](../../../includes/wf-md.md)] には、次に示す 3 種類のアクティビティの検証方法があります:  
+  
+-   `RequiredArgument` 属性および `OverloadGroup` 属性。  
+  
+-   命令型コードに基づく検証。  
+  
+-   宣言の制約。  
+  
+ `RequiredArgument` 属性と `OverloadGroup` 属性は、アクティビティにおける特定の引数が必須であることを示します。命令型コードに基づく検証には、アクティビティが自身に関する検証を提供できる単純な方法が用意されています。また、宣言の制約を使用すると、アクティビティとそれを含むワークフローとの関係に関して検証できます。検証の要件に従ってアクティビティが正しく構成されていない場合、検証のエラーと警告が返されます。包含するワークフローをワークフロー デザイナーを使用して作成する場合、デザイナーには任意の検証のエラーと警告が表示されます。ワークフローをワークフロー デザイナーを使用せずに作成する場合、ワークフローを呼び出すときに任意の検証エラーが返されます。ワークフローの作成方法にかかわらず、検証エラーを含むワークフローは実行できません。ここでは、このようなアクティビティの検証に関する概要と、アクティビティの検証を呼び出す方法について説明します。  
+  
+## このセクションの内容  
+ [必須の引数とオーバーロード グループ](../../../docs/framework/windows-workflow-foundation//required-arguments-and-overload-groups.md)  
+ 検証を実現するために、`RequiredArgument` 属性および `OverloadGroup` 属性を使用する方法について説明します。  
+  
+ [命令型コードに基づく検証](../../../docs/framework/windows-workflow-foundation//imperative-code-based-validation.md)  
+ <xref:System.Activities.CodeActivity> および <xref:System.Activities.NativeActivity> に基づくアクティビティにコードに基づく検証を使用する方法について説明します。  
+  
+ [宣言の制約](../../../docs/framework/windows-workflow-foundation//declarative-constraints.md)  
+ 複雑なアクティビティの検証を実現するために宣言の制約を使用する方法について説明します。  
+  
+ [アクティビティ検証の呼び出し](../../../docs/framework/windows-workflow-foundation//invoking-activity-validation.md)  
+ アクティビティの検証が自動的に呼び出される場合と、明示的に検証を呼び出す方法について説明します。  
+  
+## 関連項目  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/configuring-tracking-for-a-workflow.md b/docs/framework/windows-workflow-foundation/configuring-tracking-for-a-workflow.md
new file mode 100644
index 00000000000..df83ae2c9a1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/configuring-tracking-for-a-workflow.md
@@ -0,0 +1,276 @@
+---
+title: "ワークフローの追跡の構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 905adcc9-30a0-4918-acd6-563f86db988a
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# ワークフローの追跡の構成
+ワークフローは、次の 3 つの方法で実行できます。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストする  
+  
+-   <xref:System.Activities.WorkflowApplication> として実行する  
+  
+-   <xref:System.Activities.WorkflowInvoker> を使用して直接実行する  
+  
+ ワークフローのホスト オプションに応じて、コードまたは構成ファイルによって追跡参加要素を追加できます。  ここでは、追跡参加要素を <xref:System.Activities.WorkflowApplication> および <xref:System.ServiceModel.Activities.WorkflowServiceHost> に追加して追跡を構成する方法、および <xref:System.Activities.WorkflowInvoker> の使用時に追跡を有効にする方法について説明します。  
+  
+## ワークフロー アプリケーション追跡の構成  
+ ワークフローは、<xref:System.Activities.WorkflowApplication> クラスを使用して実行できます。  ここで、追跡参加要素を [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] ワークフロー ホストに追加することで、<xref:System.Activities.WorkflowApplication> ワークフロー アプリケーション用に追跡を構成する方法について説明します。  この場合、ワークフローはワークフロー アプリケーションとして実行されます。  <xref:System.Activities.WorkflowApplication> クラスを使用する自己ホスト型の .exe ファイルであるコードを介して \(構成ファイルを使用せずに\)、ワークフロー アプリケーションを構成します。  追跡参加要素は <xref:System.Activities.WorkflowApplication> インスタンスの拡張として追加します。  これを行うには、<xref:System.Activities.Tracking.TrackingParticipant> を WorkflowApplication インスタンスの拡張コレクションに追加します。  
+  
+ ワークフロー アプリケーションの場合、次のコードのように <xref:System.Activities.Tracking.EtwTrackingParticipant> 動作拡張を追加できます。  
+  
+```csharp  
+LogActivity activity = new LogActivity();  
+  
+WorkflowApplication instance = new WorkflowApplication(activity);  
+EtwTrackingParticipant trackingParticipant =  
+    new EtwTrackingParticipant  
+{  
+  
+        TrackingProfile = new TrackingProfile  
+           {  
+               Name = "SampleTrackingProfile",  
+               ActivityDefinitionId = "ProcessOrder",  
+               Queries = new WorkflowInstanceQuery  
+               {  
+                  States = { "*" }  
+              }  
+          }  
+       };  
+instance.Extensions.Add(trackingParticipant);  
+  
+```  
+  
+### ワークフロー サービス追跡の構成  
+ ワーク フローは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス ホストでホストされるとき、<xref:System.ServiceModel.Activities.WorkflowServiceHost> サービスとして公開できます。  <xref:System.ServiceModel.Activities.WorkflowServiceHost> は、ワークフロー ベースのサービスの .NET ServiceHost の特殊な実装です。  ここでは、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] で実行されている <xref:System.ServiceModel.Activities.WorkflowServiceHost> ワークフロー サービスの追跡を構成する方法について説明します。  Web.config ファイル \(Web ホスト サービスの場合\) または App.config ファイル \(コンソール アプリケーションなどのスタンドアロン アプリケーションでホストされるサービスの場合\) を介し、サービス動作を指定して構成するか、またはコードを介し、サービス ホスト用に <xref:System.ServiceModel.Description.ServiceDescription.Behaviors%2A> コレクションに追跡固有の動作を追加して構成できます。  
+  
+ <xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスの場合、次の例のように、構成ファイル内の \<<xref:System.Activities.Tracking.EtwTrackingParticipant>\> 要素を使用して `behavior` を追加できます。  
+  
+```  
+  
+<behaviors>  
+   <serviceBehaviors>  
+        <behavior>  
+          <etwTracking profileName="Sample Tracking Profile" />  
+        </behavior>              
+   </serviceBehaviors>  
+<behaviors>  
+  
+```  
+  
+ また、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー サービスの場合、コードを介して <xref:System.Activities.Tracking.EtwTrackingParticipant> 動作拡張を追加できます。  カスタムの追跡参加要素を追加するには、次のコード例のように、新しい動作拡張を作成し、それを <xref:System.ServiceModel.ServiceHost> に追加します。  
+  
+> [!NOTE]
+>  カスタムの追跡参加要素を追加するカスタムの動作要素を作成する方法を示すサンプル コードを確認するには、「[追跡](../../../docs/framework/windows-workflow-foundation/samples/tracking.md)」のサンプルを参照してください。  
+  
+```  
+ServiceHost svcHost = new ServiceHost(typeof(WorkflowService), new   
+                                 Uri("http://localhost:8001/Sample"));  
+EtwTrackingBehavior trackingBehavior =   
+    new EtwTrackingBehavior  
+    {  
+        ProfileName = "Sample Tracking Profile"  
+    };  
+svcHost.Description.Behaviors.Add(trackingBehavior);  
+svcHost.Open();  
+  
+```  
+  
+ 追跡参加要素は、動作の拡張としてワークフロー サービス ホストに追加されます。  
+  
+ 以下のサンプル コードは、構成ファイルから追跡プロファイルを読み取る方法の例です。  
+  
+```  
+TrackingProfile GetProfile(string profileName, string displayName)  
+        {  
+            TrackingProfile trackingProfile = null;  
+            TrackingSection trackingSection = (TrackingSection)WebConfigurationManager.GetSection("system.serviceModel/tracking");  
+            if (trackingSection == null)   
+            {  
+                return null;  
+            }  
+  
+            if (profileName == null)   
+            {  
+                profileName = "";  
+            }  
+  
+            //Find the profile with the specified profile name in the list of profile found in config  
+            var match = from p in new List<TrackingProfile>(trackingSection.TrackingProfiles)  
+                        where (p.Name == profileName) && ((p.ActivityDefinitionId == displayName) || (p.ActivityDefinitionId == "*"))  
+                        select p;  
+  
+            if (match.Count() == 0)  
+            {  
+                //return an empty profile  
+                trackingProfile = new TrackingProfile()  
+                {  
+                    ActivityDefinitionId = displayName  
+                };  
+  
+            }  
+            else  
+            {  
+                trackingProfile = match.First();  
+            }  
+  
+            return trackingProfile;  
+  
+```  
+  
+ このサンプル コードは、ワークフロー ホストに追跡プロファイルを追加する方法の例です。  
+  
+```  
+WorkflowServiceHost workflowServiceHost = serviceHostBase as WorkflowServiceHost;  
+if (null != workflowServiceHost)  
+{  
+              string workflowDisplayName = workflowServiceHost.Activity.DisplayName;  
+               TrackingProfile trackingProfile = GetProfile(this.profileName, workflowDisplayName);  
+                workflowServiceHost.WorkflowExtensions.Add(()  => new EtwTrackingParticipant  {  
+               TrackingProfile = trackingProfile  
+                        });  
+ }  
+```  
+  
+> [!NOTE]
+>  プロファイルの追跡の詳細については、「[追跡プロファイル](http://go.microsoft.com/fwlink/?LinkId=201310)」を参照してください。  
+  
+### WorkflowInvoker を使用した追跡の構成  
+ <xref:System.Activities.WorkflowInvoker> を使用して実行するワークフローの追跡を構成するには、追跡プロバイダーを拡張として <xref:System.Activities.WorkflowInvoker> インスタンスに追加します。  次のコード例は、「[カスタム追跡](../../../docs/framework/windows-workflow-foundation/samples/custom-tracking.md)」のサンプルから抜粋したものです。  
+  
+```  
+WorkflowInvoker invoker = new WorkflowInvoker(BuildSampleWorkflow());  
+invoker.Extensions.Add(customTrackingParticipant);  
+invoker.Invoke();  
+  
+```  
+  
+### イベント ビューアーでの追跡レコードの表示  
+ WF 実行 \- 分析ログとデバッグ ログ \- を追跡すると、特に興味深い 2 つのイベント ビューアーのログ記録があります。  2 つとも \[Microsoft\]、\[Windows\]、\[アプリケーション サーバー \- アプリケーション\] ノードの下にあります。  このセクション含まれるログは、システム全体に影響を及ぼすイベントではなく、1 つのアプリケーションからのイベントを格納します。  
+  
+ デバッグ トレースのイベントがデバッグ ログに書き込まれます。  イベント ビューアー内の WF のデバッグ トレース イベントを収集するには、デバッグ ログを有効にします。  
+  
+1.  イベント ビューアーを開くために、**\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックします。 \[ファイル名を指定して実行\] ダイアログ ボックスで、「`eventvwr`」と入力します。  
+  
+2.  \[イベント ビューアー\] ダイアログ ボックスで、**\[アプリケーションとサービス ログ\]** ノードを展開します。  
+  
+3.  **\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順にノードを展開します。  
+  
+4.  **\[アプリケーション サーバー \- アプリケーション\]** ノードの下の **\[デバッグ\]** ノードを右クリックし、**\[ログを有効にする\]** をクリックします。  
+  
+5.  トレースが有効になっているアプリケーションを実行して追跡イベントを生成します。  
+  
+6.  **\[デバッグ\]** ノードを右クリックし、**\[最新の情報に更新\]** を選択します。 トレース イベントが中央ペインに表示されます。  
+  
+ WF 4 には、追跡レコードを ETW \(Event Tracing for Windows\) セッションに書き込む追跡参加要素が用意されています。  ETW 追跡参加要素は、追跡レコードを定期受信するように追跡プロファイルで構成されています。  追跡が有効な場合は、エラーの追跡レコードが ETW に出力されます。  ETW 追跡参加要素によって出力される追跡イベントに対応する ETW 追跡イベント \(100 ～ 113 の範囲にある\) が分析ログに書き込まれます。  
+  
+ 追跡レコードを表示するには、次の手順を実行します。  
+  
+1.  イベント ビューアーを開くために、**\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックします。 \[ファイル名を指定して実行\] ダイアログ ボックスで、「`eventvwr`」と入力します。  
+  
+2.  \[イベント ビューアー\] ダイアログ ボックスで、**\[アプリケーションとサービス ログ\]** ノードを展開します。  
+  
+3.  **\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順にノードを展開します。  
+  
+4.  **\[アプリケーション サーバー \- アプリケーション\]** ノードの下の **\[分析\]** ノードを右クリックし、**\[ログを有効にする\]** をクリックします。  
+  
+5.  追跡が有効になっているアプリケーションを実行して追跡レコードを生成します。  
+  
+6.  **\[分析\]** ノードを右クリックし、**\[最新の情報に更新\]** をクリックします。 追跡レコードが中央ペインに表示されます。  
+  
+ イベント ビューアーの追跡イベントを次の図に示します。  
+  
+ ![追跡レコードを表示するイベント ビューアー](../../../docs/framework/windows-workflow-foundation//media/trackingeventviewer.PNG "TrackingEventViewer")  
+  
+### アプリケーション固有のプロバイダー ID の登録  
+ イベントを特定のアプリケーション ログに書き込む必要がある場合は、次の手順に従って新しいプロバイダー マニフェストを登録します。  
+  
+1.  アプリケーション構成ファイルでプロバイダー ID を宣言します。  
+  
+    ```  
+    <system.serviceModel>  
+        <diagnostics etwProviderId="2720e974-9fe9-477a-bb60-81fe3bf91eec"/>  
+    </system.serviceModel>  
+  
+    ```  
+  
+2.  マニフェスト ファイルを %windir%\\Microsoft.NET\\Framework\\\<[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] の最新バージョン\>\\Microsoft.Windows.ApplicationServer.Applications.man から一時的な場所にコピーし、その名前を Microsoft.Windows.ApplicationServer.Applications\_Provider1.man に変更します。  
+  
+3.  マニフェスト ファイルの GUID を新しい GUID に変更します。  
+  
+    ```  
+    <provider name="Microsoft-Windows-Application Server-Applications" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}"  
+  
+    ```  
+  
+4.  既定のプロバイダーをアンインストールしない場合は、プロバイダー名を変更します。  
+  
+    ```  
+    <provider name="Microsoft-Windows-Application Server-Applications" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}"  
+  
+    ```  
+  
+5.  前の手順でプロバイダー名を変更した場合は、マニフェスト ファイルのチャネル名を新しいプロバイダー名に変更します。  
+  
+    ```  
+    <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Admin" chid="ADMIN_CHANNEL" symbol="ADMIN_CHANNEL" type="Admin" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ADMIN_CHANNEL.message)" />  
+    <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Operational" chid="OPERATIONAL_CHANNEL" symbol="OPERATIONAL_CHANNEL" type="Operational" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.OPERATIONAL_CHANNEL.message)" />  
+    <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Analytic" chid="ANALYTIC_CHANNEL" symbol="ANALYTIC_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ANALYTIC_CHANNEL.message)" />  
+    <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Debug" chid="DEBUG_CHANNEL" symbol="DEBUG_CHANNEL" type="Debug" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.DEBUG_CHANNEL.message)" />  
+    <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Perf" chid="PERF_CHANNEL" symbol="PERF_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.PERF_CHANNEL.message)" />  
+  
+    ```  
+  
+6.  次の手順に従ってリソース DLL を生成します。  
+  
+    1.  Windows SDK をインストールします。  Windows SDK には、メッセージ コンパイラ \([mc.exe](http://go.microsoft.com/fwlink/?LinkId=184606)\) およびリソース コンパイラ \([rc.exe](http://go.microsoft.com/fwlink/?LinkId=184605)\) が含まれています。  
+  
+    2.  Windows SDK コマンド プロンプトで、新しいマニフェスト ファイルに対して mc.exe を実行します。  
+  
+        ```  
+        mc.exe Microsoft.Windows.ApplicationServer.Applications_Provider1.man  
+  
+        ```  
+  
+    3.  前の手順で生成されたリソース ファイルに対して rc.exe を実行します。  
+  
+        ```  
+        rc.exe  Microsoft.Windows.ApplicationServer.Applications_Provider1.rc  
+  
+        ```  
+  
+    4.  NewProviderReg.cs という名前の空の cs ファイルを作成します。  
+  
+    5.  C\# コンパイラを使用してリソース DLL を作成します。  
+  
+        ```  
+        csc /target:library /win32res:Microsoft.Windows.ApplicationServer.Applications_Provider1.res NewProviderReg.cs /out:Microsoft.Windows.ApplicationServer.Applications_Provider1.dll  
+        ```  
+  
+    6.  マニフェスト ファイルのリソース dll とメッセージ dll の名前を `Microsoft.Windows.ApplicationServer.Applications.Provider1.man` から新しい dll 名に変更します。  
+  
+        ```  
+        <provider name="Microsoft-Windows-Application Server-Applications_Provider1" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}" symbol="Microsoft_Windows_ApplicationServer_ApplicationEvents" resourceFileName="<dll directory>\Microsoft.Windows.ApplicationServer.Applications_Provider1.dll" messageFileName="<dll directory>\Microsoft.Windows.ApplicationServer.Applications_Provider1.dll">  
+  
+        ```  
+  
+    7.  [wevtutil](http://go.microsoft.com/fwlink/?LinkId=184608) を使用してマニフェストを登録します。  
+  
+        ```  
+        wevtutil im Microsoft.Windows.ApplicationServer.Applications_Provider1.man  
+        ```  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/connection-string-and-connection-string-name.md b/docs/framework/windows-workflow-foundation/connection-string-and-connection-string-name.md
new file mode 100644
index 00000000000..aaeab40bd7c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/connection-string-and-connection-string-name.md
@@ -0,0 +1,18 @@
+---
+title: "接続文字列と接続文字列名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 473e7a3c-c88a-4a01-914a-bea82ba42866
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 接続文字列と接続文字列名
+**接続文字列**プロパティには、SQL Workflow Instance Store が永続性データベースに接続するときに使用する接続文字列を指定します。このパラメーターは省略可能です。**接続文字列名**プロパティには、SQL Workflow Instance Store が永続性データベースに接続するときに使用する名前付き接続文字列の名前を指定します。このパラメーターは省略可能です。SQL Workflow Instance Store で既定の名前付き接続文字列である **DefaultSqlWorkflowInstanceStoreConnectionString** を使用しない場合、接続文字列名プロパティまたは接続文字列プロパティの値を指定する必要があります。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/consuming-odata-feeds-from-a-workflow.md b/docs/framework/windows-workflow-foundation/consuming-odata-feeds-from-a-workflow.md
new file mode 100644
index 00000000000..38d097cedfb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/consuming-odata-feeds-from-a-workflow.md
@@ -0,0 +1,140 @@
+---
+title: "ワークフローからの OData フィードの利用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b26617c-53e9-476a-81af-675c36d95919
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ワークフローからの OData フィードの利用
+WCF Data Services は [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のコンポーネントです。このコンポーネントを使用すると、Representational State Transfer \(REST\) のセマンティクスを使用して、Web またはイントラネット上のデータを公開および使用するために Open Data Protocol \(OData\) を使用するサービスを作成できます。 OData は、URI でアドレス指定できるリソースとしてデータを公開します。 HTTP 要求を送信し、データ サービスが返す OData フィードを処理できるのであれば、どのようなアプリケーションでも OData ベースのデータ サービスと対話できます。 さらに、WCF Data Services には [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションから OData フィードを使用する際のプログラミング エクスペリエンスを向上させるクライアント ライブラリが含まれています。 このトピックでは、クライアント ライブラリを使用した場合と使用しない場合のワークフローでの OData フィードの使用の概要について説明します。  
+  
+## Northwind Odata サービス サンプルの使用  
+ このトピックの例では、[http:\/\/services.odata.org\/Northwind\/Northwind.svc\/](http://go.microsoft.com/fwlink/?LinkID=187426) に含まれている Northwind データ サービス サンプルを使用します。 このサービスは [OData SDK](http://go.microsoft.com/fwlink/?LinkID=185248) に含まれており、Northwind データベース サンプルへの読み取り専用アクセスを提供します。 書き込みアクセスが必要な場合、またはローカルの WCF Data Service が必要な場合は、「[クイック スタート \(WCF Data Services\)](http://go.microsoft.com/fwlink/?LinkID=131076)」の手順に従って、Northwind データベースへのアクセスを提供するローカルの OData サービスを作成できます。 クイックスタートの手順に従う場合は、このトピックのコード例に指定されている URI をローカルの URI に置き換えてください。  
+  
+## クライアント ライブラリを使用した OData フィードの使用  
+ WCF Data Services には、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションおよびクライアント アプリケーションから OData フィードを簡単に使用できるクライアント ライブラリが含まれています。 これらのライブラリは、HTTP メッセージの送受信を簡略化します。 また、メッセージ ペイロードをエンティティ データを表す CLR オブジェクトに変換します。 クライアント ライブラリには、<xref:System.Data.Services.Client.DataServiceContext> および <xref:System.Data.Services.Client.DataServiceQuery%601> という 2 つのコア クラスがあります。 これらのクラスを使用すると、データ サービスをクエリして、返されるエンティティ データを CLR オブジェクトとして処理できます。 ここではクライアント ライブラリを使用するアクティビティを作成するための 2 つの方法を説明します。  
+  
+### WCF Data Service へのサービス参照の追加  
+ Northwind クライアント ライブラリを生成するには、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の **\[サービス参照の追加\]** ダイアログ ボックスを使用して参照を Northwind OData サービスに追加できます。  
+  
+ ![サービス参照の追加](../../../docs/framework/windows-workflow-foundation//media/addservicereferencetonorthwindodataservice.gif "AddServiceReferencetoNorthwindODataService")  
+  
+ サービスによって公開されるサービス操作はなく、**\[サービス\]** ボックスの一覧には Northwind データ サービスによって公開されるエンティティを表す項目が含まれていることに注意してください。 サービス参照を追加すると、これらのエンティティに対するクラスが生成され、クライアント コードで使用できるようになります。 このトピックの例ではこれらのクラスと `NorthwindEntities` クラスを使用してクエリを実行します。  
+  
+> [!NOTE]
+>  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[データ サービス クライアント ライブラリの生成 \(WCF Data Services\)](http://go.microsoft.com/fwlink/?LinkID=191611)」を参照してください。  
+  
+### 非同期メソッドの使用  
+ Web のリソースにアクセスするときに発生することのある、待機時間に伴う問題に対処するために、WCF Data Services には非同期でアクセスすることをお勧めします。 WCF Data Services クライアント ライブラリにはクエリを呼び出すための非同期メソッドが含まれ、[!INCLUDE[wf](../../../includes/wf-md.md)] は非同期アクティビティを作成するための <xref:System.Activities.AsyncCodeActivity> クラスを提供します。<xref:System.Activities.AsyncCodeActivity> 派生アクティビティを書き込んで、非同期メソッドを含む [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] クラスを利用するか、非同期で実行するコードをメソッドに含め、デリゲートを使用して呼び出すことができます。 ここでは、<xref:System.Activities.AsyncCodeActivity> 派生アクティビティの例を 2 つ紹介します。1 つは WCF Data Services クライアント ライブラリの非同期メソッドを使用し、もう 1 つはデリゲートを使用しています。  
+  
+> [!NOTE]
+>  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[非同期操作 \(WCF Data Services\)](http://go.microsoft.com/fwlink/?LinkId=193396)」および「[非同期アクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-asynchronous-activities-in-wf.md)」を参照してください。  
+  
+### クライアント ライブラリの非同期メソッドの使用  
+ <xref:System.Data.Services.Client.DataServiceQuery%601> クラスには、OData サービスを非同期で照会するための <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッドと <xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドが用意されています。 これらのメソッドは、<xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> 派生クラスの <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> オーバーライドと <xref:System.Activities.AsyncCodeActivity> オーバーライドから呼び出すことができます。<xref:System.Activities.AsyncCodeActivity> <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> オーバーライドが戻ると、ワークフローはアイドル状態になることができ \(永続化はされない\)、非同期操作が完了すると、<xref:System.Activities.AsyncCodeActivity.EndExecute%2A> がランタイムによって呼び出されます。  
+  
+ 次の例では、2 つの入力引数がある `OrdersByCustomer` アクティビティが定義されています。 引数 `CustomerId` は、返す注文を識別する顧客を表し、引数 `ServiceUri` は、照会する OData サービスの URI を表します。 アクティビティは `AsyncCodeActivity<IEnumerable<Order>>` から派生するので、クエリ結果を返すために使用される <xref:System.Activities.Activity%601.Result%2A> 出力引数も存在します。<xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> オーバーライドは、指定された顧客の注文をすべて選択する LINQ クエリを作成します。 このクエリは、渡された <xref:System.Activities.AsyncCodeActivityContext.UserState%2A> の <xref:System.Activities.AsyncCodeActivityContext> として指定され、その後クエリの <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> メソッドが呼び出されます。 クエリの <xref:System.Data.Services.Client.DataServiceQuery%601.BeginExecute%2A> に渡されるコールバックと状態は、アクティビティの <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> メソッドに渡されるものであることに注意してください。 クエリの実行が完了すると、アクティビティの <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> メソッドが呼び出されます。 クエリは <xref:System.Activities.AsyncCodeActivityContext.UserState%2A> から取得され、その後クエリの <xref:System.Data.Services.Client.DataServiceQuery%601.EndExecute%2A> メソッドが呼び出されます。 このメソッドは、指定されたエンティティ型の <xref:System.Collections.Generic.IEnumerable%601> を返します。この場合は `Order` になります。`IEnumerable<Order>` は <xref:System.Activities.AsyncCodeActivity%601> のジェネリック型であるので、この `IEnumerable` はアクティビティの <xref:System.Activities.Activity%601.Result%2A> <xref:System.Activities.OutArgument%601> として設定されます。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#100](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#100)]  
+  
+ 次の例では、指定された顧客の注文一覧を `OrdersByCustomer` アクティビティが取得した後、返された注文を <xref:System.Activities.Statements.ForEach%601> アクティビティが列挙し、各注文の日付をコンソールに書き込みます。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#10](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#10)]  
+  
+ このワークフローを呼び出すと、次のデータがコンソールに書き込まれます。  
+  
+ **WCF Data Service を呼び出しています...**   
+**8\/25\/1997**   
+**10\/3\/1997**   
+**10\/13\/1997**   
+**1\/15\/1998**   
+**3\/16\/1998**   
+**4\/9\/1998**    
+> [!NOTE]
+>  OData サーバーへの接続を確立できない場合は、次のような例外が表示されます。  
+>   
+>  ハンドルされていない例外: System.InvalidOperationException: この要求の処理中にエラーが発生しました。 \-\-\-\> System.Net.WebException: リモート サーバーに接続できません。\-\-\-\> System.Net.Sockets.SocketException: 接続済みの呼び出し先が一定の時間を過ぎても正しく応答しなかったため、接続できませんでした。または接続済みのホストが応答しなかったため、確立された接続は失敗しました。  
+  
+ クエリによって返されたデータをさらに処理する必要がある場合は、アクティビティの <xref:System.Activities.AsyncCodeActivity%601.EndExecute%2A> オーバーライドで実行できます。<xref:System.Activities.AsyncCodeActivity%601.BeginExecute%2A> と <xref:System.Activities.AsyncCodeActivity%601.EndExecute%2A> はどちらもワークフロー スレッドを使用して呼び出されます。これらのオーバーライド内のコードは非同期では実行されません。 追加の処理が大規模なものであるか、時間がかかるか、クエリ結果がページングされる場合は、次のセクションで説明する方法を検討してください。この方法では、デリゲートを使用してクエリを実行し、追加の処理を非同期で行います。  
+  
+### デリゲートの使用  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] クラスの非同期メソッドを呼び出すほかに、<xref:System.Activities.AsyncCodeActivity> ベースのアクティビティでは独自のメソッドのいずれかに非同期ロジックを定義することもできます。 このメソッドは、アクティビティの <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> オーバーライド内でデリゲートを使用することで指定します。 このメソッドが戻ると、ランタイムによってアクティビティの <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> オーバーライドが呼び出されます。 OData サービスをワークフローから呼び出すときは、このメソッドを使用してサービスを照会し、追加の処理を実行できます。  
+  
+ 次の例では、`ListCustomers` アクティビティを定義します。 このアクティビティは、Northwind データ サービス サンプルを照会し、Northwind データベース内の顧客をすべて含む `List<Customer>` を返します。 非同期操作は `GetCustomers` メソッドによって実行されます。 このメソッドは、サービスに対してすべての顧客を照会し、これらの顧客を `List<Customer>` にコピーします。 次に、結果がページングされているかどうかを確認します。 ページングされている場合は、サービスに対して結果の次のページを照会し、それを一覧に追加します。処理は顧客データをすべて取得するまで続行されます。  
+  
+> [!NOTE]
+>  WCF Data Services のページングの[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、以下を参照してください。[方法: ページングされた結果を読み込む \(WCF Data Services\)](http://go.microsoft.com/fwlink/?LinkId=193452)。  
+  
+ 顧客がすべて追加されると、一覧が返されます。`GetCustomers` メソッドはアクティビティの <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> オーバーライドで指定されます。 メソッドには戻り値があるので、メソッドを指定するために `Func<string, List<Customer>>` が作成されます。  
+  
+> [!NOTE]
+>  非同期操作を実行するメソッドに戻り値がない場合は、<xref:System.Action> の代わりに <xref:System.Func> が使用されます。 両方の方法を使用した非同期例の作成例については、「[非同期アクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-asynchronous-activities-in-wf.md)」を参照してください。  
+  
+ この <xref:System.Func> は <xref:System.Activities.AsyncCodeActivityContext.UserState%2A> に割り当てられ、`BeginInvoke` が呼び出されます。 呼び出すメソッドはアクティビティの引数の環境にアクセスできないので、引数 `ServiceUri` 値は <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> に渡されたコールバックおよび状態と共に、最初のパラメーターとして渡されます。`GetCustomers` が戻ると、ランタイムによって <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> が呼び出されます。<xref:System.Activities.AsyncCodeActivity.EndExecute%2A> 内のコードはデリゲートを <xref:System.Activities.AsyncCodeActivityContext.UserState%2A> から取得し、`EndInvoke` を呼び出し、結果を返します。この結果は、`GetCustomers` メソッドから返された顧客の一覧です。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#200](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#200)]  
+  
+ 次の例では、顧客の一覧を `ListCustomers` アクティビティが取得した後、その一覧を <xref:System.Activities.Statements.ForEach%601> アクティビティが列挙し、各顧客の会社名と連絡先名をコンソールに書き込みます。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#20](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#20)]  
+  
+ このワークフローを呼び出すと、次のデータがコンソールに書き込まれます。 このクエリは多くの顧客を返すので、ここでは出力の一部のみが表示されています。  
+  
+ **WCF Data Service を呼び出しています...**   
+**Alfreds Futterkiste, 連絡先: Maria Anders**   
+**Ana Trujillo Emparedados y helados, 連絡先: Ana Trujillo**   
+**Antonio Moreno Taquería, 連絡先: Antonio Moreno**   
+**Around the Horn, 連絡先: Thomas Hardy**   
+**Berglunds snabbköp, 連絡先: Christina Berglund**   
+**...**    
+## クライアント ライブラリを使用しない OData フィードの使用  
+ OData は、URI でアドレス指定できるリソースとしてデータを公開します。 クライアント ライブラリを使用するとこれらの URI が自動的に作成されますが、必ずしもクライアント ライブラリを使用する必要はありません。 OData サービスはクライアント ライブラリを使用せずに直接アクセスすることもできます。 クライアント ライブラリを使用しない場合、サービスの場所と必要なデータは URI によって指定され、結果が HTTP 要求への応答の中で返されます。 この生データはその後自由に処理または操作できます。 OData クエリの結果を取得する方法の 1 つとして、<xref:System.Net.WebClient> クラスを使用する方法があります。 この例では、キー ALFKI が表す顧客の連絡先名が取得されます。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#2](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#2)]  
+  
+ このコードが実行されると、次の出力がコンソールに表示されます。  
+  
+ **生データが返されました:**   
+**\<?xml version\="1.0" encoding\="utf\-8" standalone\="yes"?\>**   
+**\<ContactName xmlns\="http:\/\/schemas.microsoft.com\/ado\/2007\/08\/dataservices"\>Maria Anders\<\/ContactName\>**  ワークフローでは、この例のコードを <xref:System.Activities.CodeActivity.Execute%2A> ベースのカスタム アクティビティの <xref:System.Activities.CodeActivity> オーバーライドに組み込むことができますが、<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティを使用して同じ機能を実行することもできます。<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティは、ワークフローの作成者がクラスの静的メソッドやインスタンス メソッドを呼び出すことができるようにします。また、指定したメソッドを非同期で呼び出すオプションもあります。 次の例では、<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティは <xref:System.Net.WebClient.DownloadString%2A> クラスの<xref:System.Net.WebClient> メソッドを呼び出して顧客一覧を返すように構成されています。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#3](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#3)]  
+  
+ <xref:System.Activities.Expressions.InvokeMethod%601> は、クラスの静的メソッドとインスタンス メソッドの両方を呼び出すことができます。<xref:System.Net.WebClient.DownloadString%2A> は <xref:System.Net.WebClient> クラスのインスタンス メソッドであるため、<xref:System.Net.WebClient> のために <xref:System.Activities.Expressions.InvokeMethod%601.TargetObject%2A> クラスの新規インスタンスが指定されます。`DownloadString` は <xref:System.Activities.Expressions.InvokeMethod%601.MethodName%2A> として指定され、クエリを含む URI は <xref:System.Activities.Expressions.InvokeMethod%601.Parameters%2A> のコレクションで指定され、戻り値が <xref:System.Activities.Activity%601.Result%2A> の値に指定されます。<xref:System.Activities.Expressions.InvokeMethod%601.RunAsynchronously%2A> 値は `true` に設定されます。これは、ワークフローに関するメソッドの呼び出しが非同期で実行されることを意味します。 次の例では、<xref:System.Activities.Expressions.InvokeMethod%601> アクティビティを使用するワークフローが作成され、Northwind データ サービス サンプルに対して特定の顧客の注文一覧が照会されます。返されたデータはコンソールに書き込まれます。  
+  
+ [!code-csharp[CFX_WCFDataServicesActivityExample#1](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_WCFDataServicesActivityExample/cs/Program.cs#1)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。 このクエリは複数の注文を返すので、ここでは出力の一部のみが表示されています。  
+  
+ **WCF Data Service を呼び出しています...**   
+**生データが返されました:**   
+**\<?xml version\="1.0" encoding\="utf\-8" standalone\="yes"?\>**   
+**\<feed**   
+ **xml:base\="http:\/\/services.odata.org\/Northwind\/Northwind.svc\/"**   
+ **xmlns:d\="http:\/\/schemas.microsoft.com\/ado\/2007\/08\/dataservices"**   
+ **xmlns:m\="http:\/\/schemas.microsoft.com\/ado\/2007\/08\/dataservices\/metadata"**   
+ **xmlns\="http:\/\/www.w3.org\/2005\/Atom"\>**   
+ **\<title type\="text"\>Orders\<\/title\>**   
+ **\<id\>http:\/\/services.odata.org\/Northwind\/Northwind.svc\/Customers\('ALFKI'\)\/Orders\<\/id\>**   
+ **\<updated\>2010\-05\-19T19:37:07Z\<\/updated\>**   
+ **\<link rel\="self" title\="Orders" href\="Orders" \/\>**   
+ **\<entry\>**   
+ **\<id\>http:\/\/services.odata.org\/Northwind\/Northwind.svc\/Orders\(10643\)\<\/id\>**   
+ **\<title type\="text"\>\<\/title\>**   
+ **\<updated\>2010\-05\-19T19:37:07Z\<\/updated\>**   
+ **\<author\>**   
+ **\<name \/\>**   
+ **\<\/author\>**   
+ **\<link rel\="edit" title\="Order" href\="Orders\(10643\)" \/\>**   
+ **\<link rel\="http:\/\/schemas.microsoft.com\/ado\/2007\/08\/dataservices\/related\/Customer"**   
+ **type\="application\/atom\+xml;type\=entry" title\="Customer" href\="Orders\(10643\)\/Customer" \/\>**   
+**...**  この例は、ワークフロー アプリケーションの作成者が OData サービスから返された生データを使用できる方法の 1 つを示しています。 URI を使用して WCF Data Services にアクセスする方法の[!INCLUDE[crabout](../../../includes/crabout-md.md)]については、「[データ サービス リソースへのアクセス \(WCF Data Services\)](http://go.microsoft.com/fwlink/?LinkId=193397)」および[OData: URI 規約](http://go.microsoft.com/fwlink/?LinkId=185564)に関するページを参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/contract-first-workflow-service-development.md b/docs/framework/windows-workflow-foundation/contract-first-workflow-service-development.md
new file mode 100644
index 00000000000..932f94bdd3e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/contract-first-workflow-service-development.md
@@ -0,0 +1,138 @@
+---
+title: "コントラクト優先ワークフロー サービスの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5dbaa7b-005f-4330-848d-58ac4f42f093
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# コントラクト優先ワークフロー サービスの開発
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降の [!INCLUDE[wf](../../../includes/wf-md.md)] では、コントラクト優先ワークフローの開発という形で、Web サービスとワークフローの統合が向上しています。コントラクト優先ワークフローの開発ツールでは、コードのコントラクトを先に設計できます。その後、ツールボックス内に、コントラクト内の操作用のアクティビティ テンプレートが自動的に生成されます。このトピックでは、ワークフロー サービスのアクティビティおよびプロパティをサービス コントラクトの属性にマップする方法の概要について説明します。コントラクト優先ワークフロー サービスの作成手順の例については、「[既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)」を参照してください。  
+  
+## このトピックの内容  
+  
+-   [ワークフロー属性へのサービス コントラクト属性のマップ](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#MappingAttributes)  
+  
+    -   [サービス コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#ServiceContract)  
+  
+    -   [操作コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#OperationContract)  
+  
+    -   [メッセージ コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#MessageContract)  
+  
+    -   [データ コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#DataContract)  
+  
+    -   [エラー コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#FaultContract)  
+  
+-   [サポートおよび実装に関する詳細情報](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#AdditionalSupport)  
+  
+    -   [サポートされていないサービス コントラクト機能](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#UnsupportedFeatures)  
+  
+    -   [構成済みのメッセージング アクティビティの生成](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#ActivityGeneration)  
+  
+##  <a name="MappingAttributes"></a> ワークフロー属性へのサービス コントラクト属性のマップ  
+ 次のセクションにある表では、さまざまな WCF 属性およびプロパティを示し、それらをコントラクト優先ワークフローのメッセージング アクティビティおよびプロパティにマップする方法について説明します。  
+  
+-   [サービス コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#ServiceContract)  
+  
+-   [操作コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#OperationContract)  
+  
+-   [メッセージ コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#MessageContract)  
+  
+-   [データ コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#DataContract)  
+  
+-   [エラー コントラクト属性](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#FaultContract)  
+  
+###  <a name="ServiceContract"></a> サービス コントラクト属性  
+  
+|プロパティ名|サポートの有無|説明|WF の検証|  
+|------------|-------------|--------|------------|  
+|CallbackContract|なし|コントラクトが双方向コントラクトの場合のコールバック コントラクトの型を取得または設定します。|\(なし\)|  
+|ConfigurationName|なし|アプリケーション構成ファイル内でサービスを検索するために使用される名前を取得または設定します。|\(なし\)|  
+|HasProtectionLevel|あり|メンバーに保護レベルが割り当てられているかどうかを示す値を取得します。|Receive.ProtectionLevel を null にすることはできません。|  
+|Name|あり|Web サービス記述言語 \(WSDL\) での \<portType\> 要素の名前を取得または設定します。|Receive.ServiceContractName.LocalName が一致している必要があります。|  
+|名前空間|あり|Web サービス記述言語 \(WSDL\) での \<portType\> 要素の名前空間を取得または設定します。|Receive.ServiceContractName.NameSpace が一致している必要があります。|  
+|ProtectionLevel|あり|コントラクトのバインドで、ProtectionLevel プロパティの値をサポートする必要があるかどうかを指定します。|Receive.ProtectionLevel が一致している必要があります。|  
+|SessionMode|なし|セッションが許可されるか、許可されないか、または必要であるかを示す値を取得または設定します。|\(なし\)|  
+|TypeId|なし|派生クラスで実装すると、この属性の一意の識別子を取得します \(属性から継承\)。|\(なし\)|  
+  
+ ここにサブセクションの本文を挿入します。  
+  
+###  <a name="OperationContract"></a> 操作コントラクト属性  
+  
+|プロパティ名|サポートの有無|説明|WF の検証|  
+|------------|-------------|--------|------------|  
+|Action|あり|要求メッセージの WS\-Addressing アクションを取得または設定します。|Receive.Action が一致している必要があります。|  
+|AsyncPattern|なし|サービス コントラクト内で Begin\<methodName\> メソッドと \<EndmethodName\> メソッドのペアを使用して、操作が非同期的に実装されることを示します。|\(なし\)|  
+|HasProtectionLevel|あり|この操作のメッセージの暗号化、署名、または両方が必要かどうかを示す値を取得または設定します。|Receive.ProtectionLevel を null にすることはできません。|  
+|IsInitiating|なし|メソッドが \(セッションが存在する場合に\) サーバー上でセッションを開始できる操作を実装するかどうかを示す値を取得または設定します。|\(なし\)|  
+|IsOneWay|あり|操作が応答メッセージを返すかどうかを示す値を取得または設定します。|\(この Receive の SendReply またはこの Send の ReceiveReply がありません。\)|  
+|IsTerminating|なし|応答メッセージが存在する場合に、そのメッセージの送信後にセッションを終了するようにサービス操作がサーバーに指示するかどうかを示す値を取得または設定します。|\(なし\)|  
+|Name|あり|操作の名前を取得または設定します。|Receive.OperationName が一致している必要があります。|  
+|ProtectionLevel|あり|操作のメッセージの暗号化、署名、または両方が必要かどうかを示す値を取得または設定します。|Receive.ProtectionLevel が一致している必要があります。|  
+|ReplyAction|あり|操作の応答メッセージの SOAP アクションの値を取得または設定します。|SendReply.Action が一致している必要があります。|  
+|TypeId|なし|派生クラスで実装すると、この属性の一意の識別子を取得します \(属性から継承\)。|\(なし\)|  
+  
+###  <a name="MessageContract"></a> メッセージ コントラクト属性  
+  
+|プロパティ名|サポートの有無|説明|WF の検証|  
+|------------|-------------|--------|------------|  
+|HasProtectionLevel|あり|メッセージに保護レベルが割り当てられているかどうかを示す値を取得します。|検証なし \(Receive.Content と SendReply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|IsWrapped|あり|メッセージ本文にラッパー要素があるかどうかを指定する値を取得または設定します。|検証なし \(Receive.Content と Sendreply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|ProtectionLevel|なし|メッセージの暗号化、署名、または両方が必要かどうかを指定する値を取得または設定します。|\(なし\)|  
+|TypeId|あり|派生クラスで実装すると、この属性の一意の識別子を取得します \(属性から継承\)。|検証なし \(Receive.Content と SendReply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|WrapperName|あり|メッセージ本文のラッパー要素の名前を取得または設定します。|検証なし \(Receive.Content と SendReply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|WrapperNamespace|なし|メッセージ本文のラッパー要素の名前空間を取得または設定します。|\(なし\)|  
+  
+###  <a name="DataContract"></a> データ コントラクト属性  
+  
+|プロパティ名|サポートの有無|説明|WF の検証|  
+|------------|-------------|--------|------------|  
+|IsReference|なし|オブジェクト参照データを保持するかどうかを示す値を取得または設定します。|\(なし\)|  
+|Name|あり|型のデータ コントラクトの名前を取得または設定します。|検証なし \(Receive.Content と SendReply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|名前空間|あり|型のデータ コントラクトの名前空間を取得または設定します。|検証なし \(Receive.Content と SendReply.Content がメッセージ コントラクト型と一致している必要があります\)。|  
+|TypeId|なし|派生クラスで実装すると、この属性の一意の識別子を取得します \(属性から継承\)。|\(なし\)|  
+  
+###  <a name="FaultContract"></a> エラー コントラクト属性  
+  
+|プロパティ名|サポートの有無|説明|WF の検証|  
+|------------|-------------|--------|------------|  
+|Action|あり|操作コントラクトの一部として指定された SOAP エラー メッセージのアクションを取得または設定します。|SendReply.Action が一致している必要があります。|  
+|DetailType|あり|エラー情報を含むシリアル化可能なオブジェクトの型を取得します。|SendReply.Content が型と一致している必要があります。|  
+|HasProtectionLevel|なし|SOAP エラー メッセージに保護レベルが割り当てられているかどうかを示す値を取得します。|\(なし\)|  
+|Name|なし|Web サービス記述言語 \(WSDL\) でのエラー メッセージの名前を取得または設定します。|\(なし\)|  
+|名前空間|なし|SOAP エラーの名前空間を取得または設定します。|\(なし\)|  
+|ProtectionLevel|なし|SOAP エラーがバインドに要求する保護レベルを指定します。|\(なし\)|  
+|TypeId|なし|派生クラスで実装すると、この属性の一意の識別子を取得します \(属性から継承\)。|\(なし\)|  
+  
+##  <a name="AdditionalSupport"></a> サポートおよび実装に関する詳細情報  
+  
+-   [サポートされていないサービス コントラクト機能](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#UnsupportedFeatures)  
+  
+-   [構成済みのメッセージング アクティビティの生成](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md#ActivityGeneration)  
+  
+###  <a name="UnsupportedFeatures"></a> サポートされていないサービス コントラクト機能  
+  
+-   コントラクトでの TPL \(タスク並列ライブラリ\) タスクの使用はサポートされていません。  
+  
+-   サービス コントラクトの継承はサポートされていません。  
+  
+###  <a name="ActivityGeneration"></a> 構成済みのメッセージング アクティビティの生成  
+ コントラクト優先ワークフロー サービスを使用する場合に事前構成されたメッセージ アクティビティの生成をサポートするために、2 つのパブリック静的メソッドが <xref:System.ServiceModel.Activities.Receive> アクティビティと <xref:System.ServiceModel.Activities.SendReply> アクティビティに追加されています。  
+  
+-   <xref:System.ServiceModel.Activities.Receive.FromOperationDescription%2A?displayProperty=fullName>  
+  
+-   <xref:System.ServiceModel.Activities.SendReply.FromOperationDescription%2A?displayProperty=fullName>  
+  
+ これらのメソッドによって生成されたアクティビティはコントラクト検証に合格する必要があるため、これらのメソッドは <xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.SendReply> の検証ロジックの一部として内部で使用されます。<xref:System.ServiceModel.Activities.Receive.OperationName%2A>、<xref:System.ServiceModel.Activities.Receive.ServiceContractName%2A>、<xref:System.ServiceModel.Activities.Receive.Action%2A>、<xref:System.ServiceModel.Activities.Receive.SerializerOption%2A>、<xref:System.ServiceModel.Activities.Receive.ProtectionLevel%2A>、および <xref:System.ServiceModel.Activities.Receive.KnownTypes%2A> はすべて、インポートされたコントラクトに一致するよう事前に構成されています。ワークフロー デザイナーにあるアクティビティのコンテンツ プロパティ ページの **\[メッセージ\]** または **\[パラメーター\]** セクションも、コントラクトと一致するように事前に構成されています。  
+  
+ WCF エラー コントラクトは、<xref:System.ServiceModel.Description.OperationDescription.Faults%2A> <xref:System.ServiceModel.Description.FaultDescriptionCollection> に表示される、エラーごとに構成された個別の構成済み <xref:System.ServiceModel.Activities.SendReply> アクティビティ セットを返すことによって処理されます。  
+  
+ WF サービスで現在サポートされていない、<xref:System.ServiceModel.Description.OperationDescription> の他の部分 \(WebGet\/WebInvoke の動作、カスタム操作の動作など\) では、API は生成および構成の一環としてそれらの値を無視します。例外はスローされません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/control-flow-activities-in-wf.md b/docs/framework/windows-workflow-foundation/control-flow-activities-in-wf.md
new file mode 100644
index 00000000000..73cd1fca4c3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/control-flow-activities-in-wf.md
@@ -0,0 +1,35 @@
+---
+title: "WF 内の制御フロー アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6892885b-f7c5-4aea-8f5e-28863fb4ae75
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# WF 内の制御フロー アクティビティ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、ワークフロー内の実行フローを制御するアクティビティがいくつか用意されています。このようなアクティビティの一部 \(`Switch` や `If`\) は、[!INCLUDE[csprcs](../../../includes/csprcs-md.md)] など、プログラミング環境のアクティビティと似たフロー制御構造を実装しています。一方、その他は新しいプログラミング構造をモデル化しています \(`Pick` など\)。  
+  
+ `Parallel` および `ParallelForEach` などのアクティビティは、同時実行のために複数の子アクティビティをスケジュールできますが、シングル スレッドのみがワークフローに使用されます。これらのアクティビティのそれぞれの子アクティビティは連続して実行され、連続するアクティビティは前のアクティビティが完了するかアイドルになるまで実行されません。その結果、これらのアクティビティは、ブロック処理の可能性がある複数のアクティビティがインターリーブ形式で実行されるアプリケーションの場合に最も有効です。これらのアクティビティに、アイドルになる子アクティビティがない場合、`Parallel` は `Sequence` とまったく同様に実行され、`ParallelForEach` アクティビティは `ForEach` とまったく同様に実行されます。しかし、非同期アクティビティ \(<xref:System.Activities.AsyncCodeActivity> から派生するアクティビティなど\) またはメッセージング アクティビティが使用されると、子アクティビティがそのメッセージ受信を待っていても、または非同期作業を完了する必要があっても、コントロールは次の分岐にパスします。  
+  
+## フロー制御アクティビティ  
+  
+|アクティビティ|説明|  
+|-------------|--------|  
+|<xref:System.Activities.Statements.DoWhile>|含まれるアクティビティを 1 回実行し、条件が `true` の間はその実行を続行します。|  
+|<xref:System.Activities.Statements.ForEach%601>|コレクション内の要素ごとに埋め込みステートメントを順番に実行します。<xref:System.Activities.Statements.ForEach%601> はキーワード `foreach` と似ていますが、言語ステートメントではなくアクティビティとして実装されます。|  
+|<xref:System.Activities.Statements.If>|条件が `true` の場合は含まれるアクティビティを実行します。条件が `false` の場合は <xref:System.Activities.Statements.If.Else%2A> プロパティに含まれるアクティビティを実行できます。|  
+|<xref:System.Activities.Statements.Parallel>|含まれるアクティビティを並列実行します。|  
+|<xref:System.Activities.Statements.ParallelForEach%601>|コレクション内の要素ごとに埋め込みステートメントを並行実行します。|  
+|<xref:System.Activities.Statements.Pick>|イベント ベースの制御フロー モデリングを提供します。|  
+|<xref:System.Activities.Statements.PickBranch>|<xref:System.Activities.Statements.Pick> アクティビティ内の実行パスを表します。|  
+|<xref:System.Activities.Statements.Sequence>|含まれるアクティビティを連続実行します。|  
+|<xref:System.Activities.Statements.Switch%601>|指定された式の値に基づいて、実行する複数のアクティビティから 1 つを選択します。|  
+|<xref:System.Activities.Statements.While>|条件が `true` である間は、含まれるアクティビティを実行します。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/creating-an-activity-at-runtime-with-dynamicactivity.md b/docs/framework/windows-workflow-foundation/creating-an-activity-at-runtime-with-dynamicactivity.md
new file mode 100644
index 00000000000..5037be25942
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/creating-an-activity-at-runtime-with-dynamicactivity.md
@@ -0,0 +1,107 @@
+---
+title: "実行時における DynamicActivity を使用したアクティビティの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1af85cc6-912d-449e-90c5-c5db3eca5ace
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 実行時における DynamicActivity を使用したアクティビティの作成
+<xref:System.Activities.DynamicActivity> は、パブリック コンストラクターを持つ、具体的なシール クラスです。<xref:System.Activities.DynamicActivity> は、実行時にアクティビティ DOM を使用してアクティビティの機能を構築するために使用できます。  
+  
+## DynamicActivity の機能  
+ <xref:System.Activities.DynamicActivity> は、実行プロパティ、引数、変数にアクセスできますが、子アクティビティのスケジュール設定や追跡などのランタイム サービスにはアクセスできません。  
+  
+ 最上位のプロパティは、ワークフローの <xref:System.Activities.Argument> オブジェクトを使用して設定できます。命令型コードでは、これらの引数は新しい型で CLR プロパティを使用して作成されます。XAML では `x:Class` タグおよび `x:Member` タグを使用して、これらの引数が宣言されます。  
+  
+ <xref:System.Activities.DynamicActivity> を使用して構築されたアクティビティは、<xref:System.ComponentModel.ICustomTypeDescriptor> を使用してデザイナーとやり取りします。デザイナーで作成されたアクティビティは、次の手順に示すように、<xref:System.Activities.XamlIntegration.ActivityXamlServices.Load%2A> を使用して動的に読み込むことができます。  
+  
+#### 命令型コードを使用して実行時にアクティビティを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  **\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。**\[プロジェクトの種類\]** ウィンドウの **\[Visual C\#\]** の下にある **\[Workflow 4.0\]** を選択し、v2010 ノードを選択します。**\[テンプレート\]** ウィンドウで **\[シーケンシャル ワークフロー コンソール アプリケーション\]** をクリックします。新しいプロジェクトに DynamicActivitySample という名前を付けます。  
+  
+3.  HelloActivity プロジェクトの Workflow1.xaml を右クリックし、**\[削除\]** をクリックします。  
+  
+4.  Program.cs を開きます。次のディレクティブをファイルの先頭に追加します。  
+  
+    ```  
+    using System.Collections.Generic;  
+    ```  
+  
+5.  1 つの <xref:System.Activities.Statements.WriteLine> アクティビティを含む <xref:System.Activities.Statements.Sequence> アクティビティを作成する次のコードで `Main` メソッドの内容を置き換え、新しい動的アクティビティの <xref:System.Activities.DynamicActivity.Implementation%2A> プロパティに割り当てます。  
+  
+    ```csharp  
+    //Define the input argument for the activity  
+    var textOut = new InArgument<string>();  
+    //Create the activity, property, and implementation  
+                Activity dynamicWorkflow = new DynamicActivity()  
+                {  
+                    Properties =   
+                    {  
+                        new DynamicActivityProperty  
+                        {  
+                            Name = "Text",  
+                            Type = typeof(InArgument<String>),  
+                            Value = textOut  
+                        }  
+                    },  
+                    Implementation = () => new Sequence()  
+                    {  
+                        Activities =   
+                        {  
+                            new WriteLine()  
+                            {  
+                                Text = new InArgument<string>(env => textOut.Get(env))  
+                            }  
+                        }  
+                    }  
+                };  
+    //Execute the activity with a parameter dictionary  
+                WorkflowInvoker.Invoke(dynamicWorkflow, new Dictionary<string, object> { { "Text", "Hello World!" } });  
+                Console.ReadLine();  
+  
+    ```  
+  
+6.  アプリケーションを実行します。コンソール ウィンドウに、テキスト "Hello World\!" が表示されます。  
+  
+#### XAML を使用して実行時にアクティビティを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  **\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。**\[プロジェクトの種類\]** ウィンドウの **\[Visual C\#\]** の下にある **\[Workflow 4.0\]** を選択し、v2010 ノードを選択します。**\[テンプレート\]** ウィンドウで **\[ワークフロー コンソール アプリケーション\]** をクリックします。新しいプロジェクトに DynamicActivitySample という名前を付けます。  
+  
+3.  HelloActivity プロジェクトの Workflow1.xaml を開きます。デザイナーの下部にある **\[引数\]** オプションをクリックします。`String` 型の `TextToWrite` という新しい `In` 引数を作成します。  
+  
+4.  WriteLine アクティビティを、ツールボックスの **\[プリミティブ\]** セクションからデザイナー サーフェイスにドラッグします。値 `TextToWrite` をアクティビティの **\[テキスト\]** プロパティに割り当てます。  
+  
+5.  Program.cs を開きます。次のディレクティブをファイルの先頭に追加します。  
+  
+    ```  
+    using System.Activities.XamlIntegration;  
+    ```  
+  
+6.  `Main` メソッドの内容を次のコードに置き換えます。  
+  
+    ```  
+    Activity act2 = ActivityXamlServices.Load(@"Workflow1.xaml");  
+                    results = WorkflowInvoker.Invoke(act2, new Dictionary<string, object> { { "TextToWrite", "HelloWorld!" } });  
+    Console.ReadLine();  
+    ```  
+  
+7.  アプリケーションを実行します。コンソール ウィンドウに、テキスト "Hello World\!" が表示されます。  
+  
+8.  ソリューション エクスプローラーで、Workflow1.xaml ファイルを右クリックし、**\[コードの表示\]** をクリックします。アクティビティ クラスが `x:Class` を使用して作成され、プロパティが `x:Property` を使用して作成されています。  
+  
+## 参照  
+ [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)   
+ [DynamicActivity の作成](../../../docs/framework/windows-workflow-foundation/samples/dynamicactivity-creation.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/creating-asynchronous-activities-in-wf.md b/docs/framework/windows-workflow-foundation/creating-asynchronous-activities-in-wf.md
new file mode 100644
index 00000000000..1c84bee524a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/creating-asynchronous-activities-in-wf.md
@@ -0,0 +1,57 @@
+---
+title: "WF 内での非同期アクティビティの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 497e81ed-5eef-460c-ba55-fae73c05824f
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# WF 内での非同期アクティビティの作成
+<xref:System.Activities.AsyncCodeActivity> は使用する基本クラスをアクティビティ作成者に提供します。その結果、派生アクティビティが非同期実行ロジックを実装できるようになります。これは、ワークフローのスケジューラ スレッドを保持したり、並行して実行される可能性があるすべてのアクティビティをブロックしたりすることなく、非同期作業を実行する必要があるカスタム アクティビティに役立ちます。ここでは、<xref:System.Activities.AsyncCodeActivity> を使用してカスタムの非同期アクティビティを作成する方法の概要を説明します。  
+  
+## AsyncCodeActivity の使用  
+ <xref:System.Activities?displayProperty=fullName> は、カスタム アクティビティ作成者に、アクティビティの作成要件に応じてさまざまな基本クラスを提供します。それぞれが特定のセマンティックを持ち、ワークフロー作成者 \(およびアクティビティ ランタイム\) に対応するコントラクトを提供します。<xref:System.Activities.AsyncCodeActivity> ベースのアクティビティは、スケジューラ スレッド、およびマネージ コードで表される実行ロジックに関連して、非同期に作業を実行するアクティビティです。非同期作業になると、<xref:System.Activities.AsyncCodeActivity> によって実行中にアイドル ポイントが発生する可能性があります。非同期作業には揮発的な性質があるため、<xref:System.Activities.AsyncCodeActivity> はアクティビティの実行期間に対して常に非永続的なブロックを作成します。こうすることで、ワークフロー ランタイムによって、非同期作業中にワークフロー インスタンスが永続化されることを回避できます。また、非同期コードの実行中にワークフロー インスタンスがアンロードされることを回避できます。  
+  
+### AsyncCodeActivity メソッド  
+ <xref:System.Activities.AsyncCodeActivity> から派生するアクティビティでは、<xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> メソッドと <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> メソッドをカスタム コードでオーバーライドすることで、非同期実行ロジックを作成できます。ランタイムから呼び出される場合、これらのメソッドは <xref:System.Activities.AsyncCodeActivityContext> に渡されます。<xref:System.Activities.AsyncCodeActivityContext> はアクティビティの作成者に、コンテキストの <xref:System.Activities.AsyncCodeActivityContext.UserState%2A> プロパティを内の <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A>\/ <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> 全体で共有状態を提供します。次の例では、`GenerateRandom` アクティビティによって非同期に乱数を生成します。  
+  
+ [!code-csharp[CFX_ActivityExample#8](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#8)]  
+  
+ 前の例のアクティビティは、<xref:System.Activities.AsyncCodeActivity%601> から派生し、`Result` という昇格した `OutArgument<int>` を備えています。`GetRandom` メソッドが返す値は、<xref:System.Activities.AsyncCodeActivity%601.EndExecute%2A> のオーバーライドによって抽出され、返されます。また、この値は `Result` 値として設定されます。結果を返さない非同期アクティビティは、<xref:System.Activities.AsyncCodeActivity> から派生する必要があります。次の例では、<xref:System.Activities.AsyncCodeActivity> から派生する `DisplayRandom` アクティビティが定義されます。このアクティビティは `GetRandom` アクティビティに似ていますが、結果を返す代わりにコンソールにメッセージを表示します。  
+  
+ [!code-csharp[CFX_ActivityExample#11](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#11)]  
+  
+ 戻り値がないため、`DisplayRandom` は <xref:System.Func%602> の代わりに <xref:System.Action> を使用してデリゲートを呼び出し、デリゲートは値を返さないことに注意してください。  
+  
+ また、<xref:System.Activities.AsyncCodeActivity> は <xref:System.Activities.AsyncCodeActivity.Cancel%2A> のオーバーライドも提供します。<xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> と <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> は必須のオーバーライドですが、<xref:System.Activities.AsyncCodeActivity.Cancel%2A> はオプションで、アクティビティを取り消したり中止したりするときに未処理の非同期状態を消去できるようにオーバーライドすることが可能です。消去が可能で `AsyncCodeActivity.ExecutingActivityInstance.IsCancellationRequested` が `true` の場合、アクティビティでは <xref:System.Activities.AsyncCodeActivityContext.MarkCanceled%2A> を呼び出します。このメソッドからスローされるすべての例外は、ワークフロー インスタンスにとって致命的なものです。  
+  
+ [!code-csharp[CFX_ActivityExample#10](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#10)]  
+  
+### クラスでの非同期メソッドの呼び出し  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の多くのクラスには、非同期機能が用意されています。この非同期機能は、<xref:System.Activities.AsyncCodeActivity> ベースのアクティビティを使用して非同期に呼び出すことができます。「[アクティビティでの AsyncOperationContext の使用](../../../docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md)」の次の例では、<xref:System.IO.FileStream> クラスを使用して非同期にファイルを作成するアクティビティが作成されます。  
+  
+ [!code-csharp[CFX_ActivityExample#12](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#12)]  
+  
+### BeginExecute および EndExecute の間の共有状態  
+ 前の例では、<xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> で作成された <xref:System.IO.FileStream> のオブジェクトは <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> 内でアクセスされました。これは、`file` 変数が <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> 内の <xref:System.Activities.AsyncCodeActivityContext.UserState%2A?displayProperty=fullName> のプロパティに渡されたために可能です。これは <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> および <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> の間で状態を共有するためのただしい方法です。アクティビティのオブジェクトは複数のアクティビティのインスタンスに参照される可能性があるため、派生クラス内 \(この場合は `FileWriter`\) のメンバー変数を使用して <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> および <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> の間の状態を共有することは正しくありません。状態を共有するためにメンバー変数を使用すると、1 つの <xref:System.Activities.ActivityInstance> からの値をオーバーライドしたり、他の <xref:System.Activities.ActivityInstance> からの値を使用することになる場合があります。  
+  
+### 引数値へのアクセス  
+ <xref:System.Activities.AsyncCodeActivity> の環境は、アクティビティに定義されている引数から構成されます。これらの引数は、<xref:System.Activities.AsyncCodeActivityContext> パラメーターを使用して <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A>\/<xref:System.Activities.AsyncCodeActivity.EndExecute%2A> オーバーライドからアクセスできます。デリゲートでは引数にアクセスできませんが、そのパラメーターを使用して引数値または任意の他の必要なデータをデリゲートに渡すことができます。次の例では、`Max` 引数から包含的上限を取得する乱数生成アクティビティを定義します。デリゲートを呼び出すと、引数の値は非同期コードに渡されます。  
+  
+ [!code-csharp[CFX_ActivityExample#9](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#9)]  
+  
+### AsyncCodeActivity を使用した、操作または子アクティビティのスケジュール設定  
+ <xref:System.Activities.AsyncCodeActivity> 派生カスタム アクティビティはワークフローのスレッドに関する作業を非同期に実行するメソッドを提供しますが、子アクティビティ、またはアクションをスケジュールする機能は提供しません。ただし、非同期動作は、コンポジションを介して子アクティビティのスケジュールに組み込むことができます。非同期アクティビティを作成し、<xref:System.Activities.Activity> または <xref:System.Activities.NativeActivity> の派生アクティビティと共に構成して、子アクティビティまたはアクションの非同期動作とスケジュール機能を提供できます。たとえば、アクティビティを <xref:System.Activities.Activity> から派生するように作成し、その実装時に <xref:System.Activities.Statements.Sequence> に非同期アクティビティと共にアクティビティのロジックを実装する他のアクティビティを含めることができます。<xref:System.Activities.Activity> および <xref:System.Activities.NativeActivity> を使用したアクティビティの構成例の詳細については、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md), [アクティビティ作成オプション](../../../docs/framework/windows-workflow-foundation//activity-authoring-options-in-wf.md)」、および「[複合](../../../docs/framework/windows-workflow-foundation/samples/composite.md)」のアクティビティ サンプルを参照してください。  
+  
+## 参照  
+ <xref:System.Action>   
+ <xref:System.Func%602>   
+ [アクティビティでの AsyncOperationContext の使用](../../../docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/creating-custom-flow-control-activities.md b/docs/framework/windows-workflow-foundation/creating-custom-flow-control-activities.md
new file mode 100644
index 00000000000..82b128ed681
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/creating-custom-flow-control-activities.md
@@ -0,0 +1,41 @@
+---
+title: "カスタムのフロー制御アクティビティの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27f409f6-2d1d-4cfb-9765-93eb2ad667d5
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# カスタムのフロー制御アクティビティの作成
+.NET Framework には、抽象化されたプログラミング構造 \(<xref:System.Activities.Statements.Flowchart> など\) や標準的なプログラミング ステートメント \(<xref:System.Activities.Statements.If> など\) に対して同様に機能するさまざまなフロー制御アクティビティがあります。このトピックでは、サンプル プロジェクト [非ジェネリックの ForEach](../../../docs/framework/windows-workflow-foundation/samples/non-generic-foreach.md) の 1 つのアーキテクチャについて説明します。  
+  
+## カスタム クラスの作成  
+ 非ジェネリックの ForEach クラスは子アクティビティをスケジュールする必要があるため、<xref:System.Activities.NativeActivity> から派生する必要があります。<xref:System.Workflow.Activities.CodeActivity> から派生したアクティビティにはこの機能がありません。  
+  
+```  
+public sealed class ForEach : NativeActivity  
+    {  
+  
+```  
+  
+ カスタム クラスには、アクティビティによって使用されているデータを格納し、アクティビティの子アクティビティを実行する機能を提供するためのいくつかのメンバーが必要です。そのメンバーには以下が含まれます。  
+  
+-   `valueEnumerator`: 項目のコレクションを反復処理する非パブリックの <xref:System.Collections.IEnumerator> 型の <xref:System.Activities.Variable%601>。このメンバーは引数またはパブリック プロパティではなく、アクティビティで内部的に使用されるため、<xref:System.Activities.Variable%601> 型となり、このオブジェクトの発生元がアクティビティの外部にある場合に使用されます。  
+  
+-   `OnChildComplete`: 各子の実行の完了時に実行されるパブリック <xref:System.Activities.CompletionCallback> プロパティ。このメンバーは、アクティビティの異なるインスタンスごとに値が変わらないため、CLR プロパティとして定義されています。  
+  
+-   `Values`: 子アクティビティの反復処理に使用される入力のコレクション。このメンバーは、データの発生元がアクティビティの外部にあり、アクティビティの実行中にコレクションの内容の変更が想定されないため、<xref:System.Activities.InArgument%601> 型です。アクティビティの実行中に、アクティビティ \(たとえば、追加または削除\) のためにこのコレクションの内容を変更する機能が必要な場合、このメンバーは <xref:System.Activities.ActivityAction> として定義されます。この場合、メンバーはアクセスするたびに評価され、変更をアクティビティに反映できます。  
+  
+-   `Body`: このメンバーはアクティビティを `Values` コレクションの項目ごとに実行されるように定義します。このメンバーは、アクセスするたびに評価されるように <xref:System.Activities.ActivityAction> として定義されます。  
+  
+-   `Execute`: このメソッドは `InternalExecute`、`OnForEachComplete`、および `GetStateAndExecute` の非パブリック メンバーを使用して実行をスケジュールし、Body メンバーに定義された子アクティビティの完了ハンドラーを割り当てます。  
+  
+-   `CacheMetadata`: このメンバーはアクティビティの実行に必要な情報をランタイムに提供します。既定では、アクティビティの `CacheMetadata` メソッドはランタイムにアクティビティのすべてのパブリック メンバーを通知しますが、このアクティビティは一部の機能にプライベート メンバーを使用するため、ランタイムにプライベート メンバーの存在を通知して認識されるようにする必要があります。この場合、`CacheMetadata` 関数はオーバーライドされ、プライベートの `valueEnumerator` メンバーにアクセスできるようにします。このメンバーはアクティビティの値の引数も作成し、実行時にアクティビティに渡すことができるようにします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/csharp-expressions.md b/docs/framework/windows-workflow-foundation/csharp-expressions.md
new file mode 100644
index 00000000000..63599924f96
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/csharp-expressions.md
@@ -0,0 +1,292 @@
+---
+title: "C# の式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 29110be7-f4e3-407e-8dbe-78102eb21115
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# C# の式
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、[!INCLUDE[wf](../../../includes/wf-md.md)] で C\# 式がサポートされています。[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で作成された、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とする新しい C\# ワークフロー プロジェクトでは C\# 式が使用され、Visual Basic ワークフロー プロジェクトでは Visual Basic 式が使用されます。Visual Basic 式を使用する既存の [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] ワークフロー プロジェクトは、プロジェクトの言語に関係なく [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] に移行することができ、サポートされています。ここでは、[!INCLUDE[wf1](../../../includes/wf1-md.md)] での C\# 式の概要について説明します。  
+  
+## ワークフローでの C\# 式の使用  
+  
+-   [ワークフロー デザイナーでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#WFDesigner)  
+  
+    -   [下位互換性](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#BackwardCompat)  
+  
+-   [コード ワークフローでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CodeWorkflows)  
+  
+-   [XAML ワークフローでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#XamlWorkflows)  
+  
+    -   [コンパイルされた Xaml](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CompiledXaml)  
+  
+    -   [Loose Xaml](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#LooseXaml)  
+  
+-   [XAMLX ワークフロー サービスでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#WFServices)  
+  
+###  <a name="WFDesigner"></a> ワークフロー デザイナーでの C\# 式の使用  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、[!INCLUDE[wf](../../../includes/wf-md.md)] で C\# 式がサポートされています。[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で作成された、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とする C\# ワークフロー プロジェクトでは C\# 式が使用されるのに対し、Visual Basic ワークフロー プロジェクトでは Visual Basic 式が使用されます。必要な C\# 式を指定するには、その式を **\[C\# の式を入力してください\]** というラベルの付いたボックスに入力します。このラベルは、プロパティ ウィンドウ \(デザイナーでアクティビティを選択した場合\) またはワークフロー デザイナーのアクティビティに表示されます。次の例では、2 つの `WriteLine` アクティビティが `NoPersistScope` の中で `Sequence` 内に含まれています。  
+  
+ ![自動的に作成された Sequence アクティビティ](../../../docs/framework/windows-workflow-foundation//media/autosurround2.png "AutoSurround2")  
+  
+> [!NOTE]
+>  C\# 式は、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] のみでサポートされており、再ホストされたワークフロー デザイナーではサポートされていません。再ホストされたデザイナーでサポートされている新しい WF45 機能[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート](../../../docs/framework/windows-workflow-foundation//wf-features-in-the-rehosted-workflow-designer.md)」を参照してください。  
+  
+####  <a name="BackwardCompat"></a> 下位互換性  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] に移行した既存の [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] C\# ワークフロー プロジェクトの Visual Basic 式はサポートされています。Visual Basic 式をワークフロー デザイナーで表示すると、既存の Visual Basic 式のテキストは、その Visual Basic 式が有効な C\# 構文である場合を除き、**"値が XAML で設定されました"** に置き換えられます。Visual Basic 式が有効な C\# 構文である場合は、式が表示されます。Visual Basic 式を C\# に更新するには、ワークフロー デザイナーでその式を編集して、対応する C\# 式を指定します。Visual Basic 式を C\# に更新する必要はありませんが、ワークフロー デザイナーで式を更新すると、式は C\# に変換され、Visual Basic に戻すことができなくなる場合があります。  
+  
+###  <a name="CodeWorkflows"></a> コード ワークフローでの C\# 式の使用  
+ C\# 式は、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] コードベースのワークフローでサポートされていますが、ワークフローを呼び出す前に、<xref:System.Activities.XamlIntegration.TextExpressionCompiler.Compile%2A?displayProperty=fullName> を使用して C\# 式をコンパイルする必要があります。ワークフローの作成者は、`CSharpValue` を使用して式の右辺値を表し、`CSharpReference` を使用して式の左辺値を表すことができます。次の例では、`Sequence` アクティビティに含まれる `Assign` アクティビティと `WriteLine` アクティビティを使用してワークフローを作成します。`CSharpReference` は `Assign` の `To` 引数として指定され、式の左辺値を表します。`CSharpValue` は `Assign` の `Value` 引数、および `WriteLine` の `Text` 引数として指定され、2 つの式の右辺値を表します。  
+  
+```csharp  
+Variable<int> n = new Variable<int>  
+{  
+    Name = "n"  
+};  
+  
+Activity wf = new Sequence  
+{  
+    Variables = { n },  
+    Activities =  
+    {  
+        new Assign<int>  
+        {  
+            To = new CSharpReference<int>("n"),  
+            Value = new CSharpValue<int>("new Random().Next(1, 101)")  
+        },  
+        new WriteLine  
+        {  
+            Text = new CSharpValue<string>("\"The number is \" + n")  
+        }  
+    }  
+};  
+  
+CompileExpressions(wf);  
+  
+WorkflowInvoker.Invoke(wf);  
+```  
+  
+ ワークフローが作成されると、`CompileExpressions` ヘルパー メソッドを呼び出して C\# 式がコンパイルされ、ワークフローが呼び出されます。次の例は、`CompileExpressions` メソッドです。  
+  
+```csharp  
+static void CompileExpressions(Activity activity)  
+{  
+    // activityName is the Namespace.Type of the activity that contains the  
+    // C# expressions.  
+    string activityName = activity.GetType().ToString();  
+  
+    // Split activityName into Namespace and Type.Append _CompiledExpressionRoot to the type name  
+    // to represent the new type that represents the compiled expressions.  
+    // Take everything after the last . for the type name.  
+    string activityType = activityName.Split('.').Last() + "_CompiledExpressionRoot";  
+    // Take everything before the last . for the namespace.  
+    string activityNamespace = string.Join(".", activityName.Split('.').Reverse().Skip(1).Reverse());  
+  
+    // Create a TextExpressionCompilerSettings.  
+    TextExpressionCompilerSettings settings = new TextExpressionCompilerSettings  
+    {  
+        Activity = activity,  
+        Language = "C#",  
+        ActivityName = activityType,  
+        ActivityNamespace = activityNamespace,  
+        RootNamespace = null,  
+        GenerateAsPartialClass = false,  
+        AlwaysGenerateSource = true,  
+        ForImplementation = false  
+    };  
+  
+    // Compile the C# expression.  
+    TextExpressionCompilerResults results =  
+        new TextExpressionCompiler(settings).Compile();  
+  
+    // Any compilation errors are contained in the CompilerMessages.  
+    if (results.HasErrors)  
+    {  
+        throw new Exception("Compilation failed.");  
+    }  
+  
+    // Create an instance of the new compiled expression type.  
+    ICompiledExpressionRoot compiledExpressionRoot =  
+        Activator.CreateInstance(results.ResultType,  
+            new object[] { activity }) as ICompiledExpressionRoot;  
+  
+    // Attach it to the activity.  
+    CompiledExpressionInvoker.SetCompiledExpressionRoot(  
+        activity, compiledExpressionRoot);  
+}  
+```  
+  
+> [!NOTE]
+>  C\# 式がコンパイルされていない場合、ワークフローが呼び出されると <xref:System.NotSupportedException> がスローされ、"`Expression Activity type 'CSharpValue`1' requires compilation in order to run.  Please ensure that the workflow has been compiled.`" のようなメッセージが表示されます。  
+  
+ カスタムのコードベースのワークフローで `DynamicActivity` を使用する場合は、次のコード例に示すように、`CompileExpressions` メソッドに変更を加える必要があります。  
+  
+```csharp  
+static void CompileExpressions(DynamicActivity dynamicActivity)  
+{  
+    // activityName is the Namespace.Type of the activity that contains the  
+    // C# expressions. For Dynamic Activities this can be retrieved using the  
+    // name property , which must be in the form Namespace.Type.  
+    string activityName = dynamicActivity.Name;  
+  
+    // Split activityName into Namespace and Type.Append _CompiledExpressionRoot to the type name  
+    // to represent the new type that represents the compiled expressions.  
+    // Take everything after the last . for the type name.  
+    string activityType = activityName.Split('.').Last() + "_CompiledExpressionRoot";  
+    // Take everything before the last . for the namespace.  
+    string activityNamespace = string.Join(".", activityName.Split('.').Reverse().Skip(1).Reverse());  
+  
+    // Create a TextExpressionCompilerSettings.  
+    TextExpressionCompilerSettings settings = new TextExpressionCompilerSettings  
+    {  
+        Activity = dynamicActivity,  
+        Language = "C#",  
+        ActivityName = activityType,  
+        ActivityNamespace = activityNamespace,  
+        RootNamespace = null,  
+        GenerateAsPartialClass = false,  
+        AlwaysGenerateSource = true,  
+        ForImplementation = true  
+    };  
+  
+    // Compile the C# expression.  
+    TextExpressionCompilerResults results =  
+        new TextExpressionCompiler(settings).Compile();  
+  
+    // Any compilation errors are contained in the CompilerMessages.  
+    if (results.HasErrors)  
+    {  
+        throw new Exception("Compilation failed.");  
+    }  
+  
+    // Create an instance of the new compiled expression type.  
+    ICompiledExpressionRoot compiledExpressionRoot =  
+        Activator.CreateInstance(results.ResultType,  
+            new object[] { dynamicActivity }) as ICompiledExpressionRoot;  
+  
+    // Attach it to the activity.  
+    CompiledExpressionInvoker.SetCompiledExpressionRootForImplementation(  
+        dynamicActivity, compiledExpressionRoot);  
+}  
+```  
+  
+ 動的アクティビティで C\# 式をコンパイルする `CompileExpressions` オーバーロードには、いくつかの相違点があります。  
+  
+-   `CompileExpressions` のパラメーターが `DynamicActivity` です。  
+  
+-   型名および名前空間の取得に `DynamicActivity.Name` プロパティが使用されます。  
+  
+-   `TextExpressionCompilerSettings.ForImplementation` が `true` に設定されます。  
+  
+-   `CompiledExpressionInvoker.SetCompiledExpressionRoot` の代わりに `CompiledExpressionInvoker.SetCompiledExpressionRootForImplementation` が呼び出されます。  
+  
+ コード内で式を使用する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)」を参照してください。  
+  
+###  <a name="XamlWorkflows"></a> XAML ワークフローでの C\# 式の使用  
+ C\# 式は XAML ワークフローでサポートされています。コンパイルされた XAML ワークフローは型にコンパイルされ、Loose XAML ワークフローはランタイムによって読み込まれ、ワークフローの実行時にアクティビティ ツリーにコンパイルされます。  
+  
+-   [コンパイルされた Xaml](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CompiledXaml)  
+  
+-   [Loose Xaml](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#LooseXaml)  
+  
+####  <a name="CompiledXaml"></a> コンパイルされた Xaml  
+ C\# 式は、コンパイルされた XAML ワークフローでサポートされており、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] を対象とする C\# ワークフロー プロジェクトの一部として型にコンパイルされます。コンパイルされた XAML は、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] でワークフローを作成する際の既定の種類です。また、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] で作成された、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] を対象とする C\# ワークフロー プロジェクトでは C\# 式が使用されます。  
+  
+####  <a name="LooseXaml"></a> Loose Xaml  
+ C\# 式は Loose XAML ワークフローでがサポートされています。Loose XAML ワークフローを読み込んで呼び出すワークフロー ホスト プログラムは、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] を対象としている必要があります。また、<xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings.CompileExpressions%2A> は `true` \(既定値は `false`\) に設定する必要がります。<xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings.CompileExpressions%2A> を `true` に設定するには、<xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings.CompileExpressions%2A> プロパティが `true` に設定されている <xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings> インスタンスを作成し、そのインスタンスを <xref:System.Activities.XamlIntegration.ActivityXamlServices.Load%2A?displayProperty=fullName> へパラメーターとして渡します。`CompileExpressions` が `true` に設定されていない場合は、<xref:System.NotSupportedException> がスローされ、"`Expression Activity type 'CSharpValue`1' requires compilation in order to run.  Please ensure that the workflow has been compiled.`" のようなメッセージが表示されます。  
+  
+```csharp  
+ActivityXamlServicesSettings settings = new ActivityXamlServicesSettings  
+{  
+    CompileExpressions = true  
+};  
+  
+DynamicActivity<int> wf = ActivityXamlServices.Load(new StringReader(serializedAB), settings) as DynamicActivity<int>;  
+```  
+  
+ XAML ワークフローの操作方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[XAML との間のワークフローおよびアクティビティのシリアル化](../../../docs/framework/windows-workflow-foundation//serializing-workflows-and-activities-to-and-from-xaml.md)」を参照してください。  
+  
+###  <a name="WFServices"></a> XAMLX ワークフロー サービスでの C\# 式の使用  
+ C\# 式は XAMLX ワークフロー サービスでがサポートされています。ワークフロー サービスが IIS または WAS でホストされている場合、追加の手順は必要ありません。ただし、XAML ワークフロー サービスが自己ホスト型サービスの場合は、C\# 式をコンパイルする必要があります。C\# 式を自己ホスト型の XAMLX ワークフロー サービスでコンパイルするには、最初に XAMLX ファイルを `WorkflowService` に読み込んでから、前の「[コード ワークフローでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CodeWorkflows)」で説明した `CompileExpressions` メソッドに `WorkflowService` の `Body` を渡します。次の例では、XAMLX ワークフロー サービスが読み込まれ、C\# 式がコンパイルされた後、ワークフロー サービスが開かれて要求を待機します。  
+  
+```csharp  
+// Load the XAMLX workflow service.  
+WorkflowService workflow1 =  
+    (WorkflowService)XamlServices.Load(xamlxPath);  
+  
+// Compile the C# expressions in the workflow by passing the Body to CompileExpressions.  
+CompileExpressions(workflow1.Body);  
+  
+// Initialize the WorkflowServiceHost.  
+var host = new WorkflowServiceHost(workflow1, new Uri("http://localhost:8293/Service1.xamlx"));  
+  
+// Enable Metadata publishing/  
+ServiceMetadataBehavior smb = new ServiceMetadataBehavior();  
+smb.HttpGetEnabled = true;  
+smb.MetadataExporter.PolicyVersion = PolicyVersion.Policy15;  
+host.Description.Behaviors.Add(smb);  
+  
+// Open the WorkflowServiceHost and wait for requests.  
+host.Open();  
+Console.WriteLine("Press enter to quit");  
+Console.ReadLine();  
+```  
+  
+ C\# 式がコンパイルされないと、`Open` の処理は成功しますが、ワークフローは呼び出し時に失敗します。次の `CompileExpressions` メソッドは、前の「[コード ワークフローでの C# 式の使用](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md#CodeWorkflows)」にあるメソッドと同じです。  
+  
+```csharp  
+static void CompileExpressions(Activity activity)  
+{  
+    // activityName is the Namespace.Type of the activity that contains the  
+    // C# expressions.  
+    string activityName = activity.GetType().ToString();  
+  
+    // Split activityName into Namespace and Type.Append _CompiledExpressionRoot to the type name  
+    // to represent the new type that represents the compiled expressions.  
+    // Take everything after the last . for the type name.  
+    string activityType = activityName.Split('.').Last() + "_CompiledExpressionRoot";  
+    // Take everything before the last . for the namespace.  
+    string activityNamespace = string.Join(".", activityName.Split('.').Reverse().Skip(1).Reverse());  
+  
+    // Create a TextExpressionCompilerSettings.  
+    TextExpressionCompilerSettings settings = new TextExpressionCompilerSettings  
+    {  
+        Activity = activity,  
+        Language = "C#",  
+        ActivityName = activityType,  
+        ActivityNamespace = activityNamespace,  
+        RootNamespace = null,  
+        GenerateAsPartialClass = false,  
+        AlwaysGenerateSource = true,  
+        ForImplementation = false  
+    };  
+  
+    // Compile the C# expression.  
+    TextExpressionCompilerResults results =  
+        new TextExpressionCompiler(settings).Compile();  
+  
+    // Any compilation errors are contained in the CompilerMessages.  
+    if (results.HasErrors)  
+    {  
+        throw new Exception("Compilation failed.");  
+    }  
+  
+    // Create an instance of the new compiled expression type.  
+    ICompiledExpressionRoot compiledExpressionRoot =  
+        Activator.CreateInstance(results.ResultType,  
+            new object[] { activity }) as ICompiledExpressionRoot;  
+  
+    // Attach it to the activity.  
+    CompiledExpressionInvoker.SetCompiledExpressionRoot(  
+        activity, compiledExpressionRoot);  
+}  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/custom-tracking-records.md b/docs/framework/windows-workflow-foundation/custom-tracking-records.md
new file mode 100644
index 00000000000..1221216bd34
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/custom-tracking-records.md
@@ -0,0 +1,37 @@
+---
+title: "カスタム追跡レコード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24284565-c68b-40bf-b7f1-e148d151a6fc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# カスタム追跡レコード
+このトピックではカスタム追跡レコードを作成し、出力されたデータをレコードと一緒に読み込む方法を示します。  
+  
+## カスタム追跡レコードの出力  
+ 次の例に示すように、カスタム追跡レコードはコード アクティビティから出力できます。  
+  
+```  
+protected override void Execute(CodeActivityContext context)  
+{  
+…  
+            CustomTrackingRecord customRecord = new CustomTrackingRecord("CustomEmailSentEvent");  
+            customRecord.Data.Add("SendTime", sendTime);  
+            context.Track(customRecord);  
+}  
+```  
+  
+ `ActvityContext` 上で <xref:System.Activities.NativeActivityContext.Track%2A> メソッドを呼び出すことで、<xref:System.Activities.Tracking.CustomTrackingRecord> をコード アクティビティに出力できます。  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/customizing-the-workflow-design-experience.md b/docs/framework/windows-workflow-foundation/customizing-the-workflow-design-experience.md
new file mode 100644
index 00000000000..982b5a0036c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/customizing-the-workflow-design-experience.md
@@ -0,0 +1,39 @@
+---
+title: "ワークフロー デザイン操作のカスタマイズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "拡張 [WF], ワークフロー デザイナー"
+ms.assetid: 98135077-0f5d-4d16-9337-01094e843537
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# ワークフロー デザイン操作のカスタマイズ
+[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、カスタム アクティビティを設計するシナリオや [!INCLUDE[wfd1](../../../includes/wfd1-md.md)]を再ホストするシナリオが大幅に簡略化されました。開発も配置も簡単になり、柔軟性も向上しました。主要なインフラストラクチャ上の変更として、新しいアクティビティ デザイナー プログラミング モデルが [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] の上に構築されています。そのため、アクティビティ デザイナーを宣言によって定義することや、他のアプリケーションに[!INCLUDE[wfd2](../../../includes/wfd2-md.md)]を再ホストすることが比較的簡単にできます。再ホストするときに、カスタム式エディターを開発して、IntelliSense や簡略化された式ドメインをサポートできます。[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] との統合は、ワークフロー サービスを使用することで、よりシームレスになっています。カスタム アクティビティ デザイナーおよびモデル アイテム ツリーを使用して、再ホストされたワークフロー デザイナーのデザイン時の操作を拡張できます。  
+  
+## このセクションの内容  
+ [カスタム アクティビティ デザイナーおよびテンプレートの使用](../../../docs/framework/windows-workflow-foundation//using-custom-activity-designers-and-templates.md)  
+ 新しいカスタム アクティビティ デザイナーおよびテンプレートを作成する方法について説明します。  
+  
+ [ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] 以外に [!INCLUDE[wfd1](../../../includes/wfd1-md.md)]を再ホストする方法および検証エラーを表示する方法を説明します。  
+  
+ [カスタム式エディターの使用](../../../docs/framework/windows-workflow-foundation//using-a-custom-expression-editor.md)  
+ [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] 以外で再ホストされたワークフロー デザイナーで使用するカスタム式エディターの実装方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Activities.Presentation.ActivityDesigner>  
+  
+## 参照  
+ [Windows Workflow Foundation の拡張](../../../docs/framework/windows-workflow-foundation//extend.md)   
+ [デザイナー](../../../docs/framework/windows-workflow-foundation/samples/designer.md)   
+ [カスタム アクティビティ デザイナー](../../../docs/framework/windows-workflow-foundation/samples/custom-activity-designers.md)   
+ [デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation/samples/designer-rehosting.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/data-model.md b/docs/framework/windows-workflow-foundation/data-model.md
new file mode 100644
index 00000000000..c2bef0ac98f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/data-model.md
@@ -0,0 +1,36 @@
+---
+title: "Windows Workflow Foundation のデータ モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], データ モデル"
+ms.assetid: d5752e51-cfc9-4499-af71-53b6daae9879
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# Windows Workflow Foundation のデータ モデル
+Windows Workflow Foundation のデータ モデルは、変数、引数、式の 3 つの概念で構成されます。変数はデータ ストレージを表し、引数はアクティビティへのデータ フローを表します。引数は、変数を参照できる式を使用してバインドされます \(値が代入されます\)。  
+  
+## このセクションの内容  
+ [変数と引数](../../../docs/framework/windows-workflow-foundation//variables-and-arguments.md).  
+ 変数と引数の概念と使用方法を説明します。  
+  
+ [式](../../../docs/framework/windows-workflow-foundation//expressions.md)  
+ 式と、ワークフローの開発で式を使用する方法を説明します。  
+  
+ [C\# の式](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md)  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された、ワークフローの C\# 式について説明します。  
+  
+ [プロパティと引数](../../../docs/framework/windows-workflow-foundation//properties-vs-arguments.md)  
+ アクティビティの入力に使用する型を選択する方法について説明します。  
+  
+ [CacheMetadata を使用したデータの公開](../../../docs/framework/windows-workflow-foundation//exposing-data-with-cachemetadata.md)  
+ 実行中のアクティビティのメンバーに関するメタデータのカスタム セットを公開する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/debugging-workflows.md b/docs/framework/windows-workflow-foundation/debugging-workflows.md
new file mode 100644
index 00000000000..82573628346
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/debugging-workflows.md
@@ -0,0 +1,39 @@
+---
+title: "デバッグのワークフロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b23b4814-ebb1-4c51-b7a9-469f4da7a96d
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# デバッグのワークフロー
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、開発環境から実行中のワークフローをデバッグするオプションがいくつかあります。  ワークフローは、デザイナー、XAML、およびコードでデバッグできます。  
+  
+## ワークフロー デザイナーでのデバッグ  
+ ワークフロー デザイナーでブレークポイントをアクティビティに設定するには、アクティビティを選択して **F9** キーを押すか、アクティビティのコンテキスト メニューを使用します。  ワークフロー ホストをデバッグ モードで実行すると、ワークフローの実行は一時停止します。  次のスクリーンショットでは、ワークフローの実行はブレークポイントで一時停止します。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[ワークフロー デザイナーを使用したワークフローのデバッグ](../Topic/Debugging%20Workflows%20with%20the%20Workflow%20Designer.md)」  
+  
+## XAML でのデバッグ  
+ デザイナーでワークフローがブレークポイントで一時停止すると、XAML でもワークフローをデバッグできます。  XAML で実行ポイントを表示するには、ワークフローの実行が一時停止したときにワークフロー デザイナーで **\[XAML ビュー\]** を選択します。  デバッグをデザイナーに切り替えるには、ソリューション エクスプローラーからデザイナーでワークフローを開き直します。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[ワークフロー デザイナーを使用して XAML をデバッグする方法](../Topic/How%20to:%20Debug%20XAML%20with%20the%20Workflow%20Designer.md)」  
+  
+## コードでのデバッグ  
+ コードのブレークポイントは、他の命令型アプリケーションで使用する方法と同様に [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] で使用できます。  コード ペインの左側の余白をクリックし、コードのブレークポイントを作成するか、**F9** キーを押してカーソル位置にブレークポイントを配置します。  
+  
+## ワークフロー プロセスへのアタッチ  
+ ワークフローのデバッグは、Visual Studio のインフラストラクチャを使用したプロセスへのアタッチもサポートしています。  そのため、ワークフロー作成者は、Internet Information Services \(IIS\) 7.0 など異なるホスト環境で実行されているワークフローをデバッグできます。  
+  
+## リモート デバッグ  
+ [!INCLUDE[wf](../../../includes/wf-md.md)] のリモート デバッグは、他の [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] コンポーネントのリモート デバッグと同じように機能します。  リモート デバッグの使用については、「[方法: リモート デバッグを有効にする](http://go.microsoft.com/fwlink/?LinkId=196257)」を参照してください。  
+  
+> [!NOTE]
+>  ワークフロー アプリケーションが x86 アーキテクチャを対象とし、64 ビットのオペレーティング システムを実行しているコンピューターでホストされる場合は、リモート デバッグは、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] をリモート コンピューターにインストールするか、またはワークフロー アプリケーションの対象が **Any CPU** に変更されなければ機能しません。  
+  
+## ワークフロー デバッグ サービスの拡張  
+ ワークフロー デバッガー サービスは公開されるようになり、ホストを変更したデザイナーでのモニタリング、シミュレーション、デバッグなど、カスタム アプリケーションを作成するときに使用できます。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「<xref:System.Activities.Presentation.Debug.DebuggerService>」のトピックを参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/declarative-constraints.md b/docs/framework/windows-workflow-foundation/declarative-constraints.md
new file mode 100644
index 00000000000..96927e75ebd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/declarative-constraints.md
@@ -0,0 +1,185 @@
+---
+title: "宣言の制約 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67001ed1-7f4d-4ada-ae57-a31176901a53
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 宣言の制約
+宣言の制約には、アクティビティ、およびそのアクティビティと他のアクティビティとの関係に関する検証の強力なメソッドが用意されています。アクティビティに関する制約はプロセスの作成中に構成されますが、ワークフロー ホストによって追加の制約を指定することもできます。ここでは、宣言の制約を使用してアクティビティを検証する方法の概要について説明します。  
+  
+## 宣言の制約の使用  
+ 制約とは、検証ロジックを含むアクティビティです。この制約アクティビティは、コードまたは XAML で作成できます。制約アクティビティを作成したら、アクティビティの作成者はこの制約をアクティビティの <xref:System.Activities.Activity.Constraints%2A> プロパティに追加して検証を実行します。またはこの制約を使用して、<xref:System.Activities.Validation.ValidationSettings> インスタンスの <xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> プロパティを使った追加の検証を実行します。検証ロジックは、アクティビティのメタデータの検証など、単純な検証で構成されますが、親アクティビティ、子アクティビティ、および兄弟アクティビティに対する現在のアクティビティの関係を考慮した検証を実行することもできます。制約は、<xref:System.Activities.Validation.Constraint%601> アクティビティを使用して作成されます。また、検証のエラーと警告の作成を補助し、ワークフロー内の関連するアクティビティに関する情報を提供する追加の検証アクティビティがいくつか用意されています。  
+  
+### AssertValidation と AddValidationError  
+ <xref:System.Activities.Validation.AssertValidation> アクティビティは、その <xref:System.Activities.Validation.AssertValidation.Assertion%2A> から参照される式を評価します。また、式が `false` に評価されると、検証のエラーまたは警告が <xref:System.Activities.Validation.ValidationResults> に追加されます。<xref:System.Activities.Validation.AssertValidation.Message%2A> プロパティは検証エラーを示し、<xref:System.Activities.Validation.AssertValidation.IsWarning%2A> は検証の失敗がエラーか警告かを指定します。<xref:System.Activities.Validation.AssertValidation.IsWarning%2A> の既定値は `false` です。  
+  
+ 次の例では、検証対象のアクティビティの <xref:System.Activities.Activity.DisplayName%2A> が 2 文字以下の場合、検証の警告を返す制約を宣言します。<xref:System.Activities.Validation.Constraint%601> に使用されるジェネリック型パラメーターには、この制約によって検証されるアクティビティの型を指定します。この制約では、ジェネリック型として <xref:System.Activities.Activity> を使用します。この制約はすべての種類のアクティビティに使用できます。  
+  
+```csharp  
+public static Constraint ActivityDisplayNameIsNotSetWarning()  
+{  
+    DelegateInArgument<Activity> element = new DelegateInArgument<Activity>();  
+  
+    return new Constraint<Activity>  
+    {  
+        Body = new ActivityAction<Activity, ValidationContext>  
+        {  
+            Argument1 = element,  
+            Handler = new AssertValidation  
+            {  
+                IsWarning = true,  
+                Assertion = new InArgument<bool>(env => (element.Get(env).DisplayName.Length > 2)),  
+                Message = new InArgument<string>("It is a best practice to have a DisplayName of more than 2 characters."),  
+            }  
+        }  
+    };  
+}  
+```  
+  
+ あるアクティビティに対してこの制約を指定するには、次のコード例のように、アクティビティの <xref:System.Activities.Activity.Constraints%2A> に追加します。  
+  
+```csharp  
+public sealed class SampleActivity : CodeActivity  
+{  
+    public SampleActivity()  
+    {  
+        base.Constraints.Add(ActivityDisplayNameIsNotSetWarning());  
+    }  
+  
+    // Activity implementation omitted.  
+}  
+```  
+  
+ またこの制約は、ホストで <xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> を使用することによって、ワークフローのアクティビティに指定することもできます。この方法については、次のセクションで説明します。  
+  
+ <xref:System.Activities.Validation.AddValidationError> アクティビティは、式を評価せずに、検証のエラーまたは警告を生成するために使用されます。このプロパティは <xref:System.Activities.Validation.AssertValidation> に似ており、<xref:System.Activities.Statements.If> アクティビティなど、制約のフロー コントロール アクティビティと併用できます。  
+  
+### ワークフロー関係のアクティビティ  
+ 複数の検証アクティビティが使用できます。これにより検証されるアクティビティに関連してワークフロー内の他のアクティビティに関する情報が提供されます。<xref:System.Activities.Validation.GetParentChain> は現在のアクティビティとルート アクティビティ間のすべてのアクティビティを含むアクティビティのコレクションを返します。<xref:System.Activities.Validation.GetChildSubtree> は再帰パターンで子アクティビティを含むアクティビティのコレクションを提供し、<xref:System.Activities.Validation.GetWorkflowTree> はワークフロー中のすべてのアクティビティを取得します。  
+  
+ [アクティビティの関係の検証](../../../docs/framework/windows-workflow-foundation/samples/activity-relationships-validation.md) サンプルの次の例では、`CreateState` アクティビティが定義されます。`CreateState` アクティビティは `CreateCountry` アクティビティ内に含まれる必要があり、`GetParent` メソッドはこの要件を適用する制約を返します。`GetParent` は <xref:System.Activities.Validation.GetParentChain> アクティビティを <xref:System.Activities.Statements.ForEach%601> アクティビティと組み合わせて使用し、`CreateState` のアクティビティの親アクティビティを確認し、要件を満たしているかどうか判断します。  
+  
+```csharp  
+public sealed class CreateState : CodeActivity  
+{  
+    public CreateState()  
+    {  
+        base.Constraints.Add(CheckParent());  
+        this.Cities = new List<Activity>();              
+    }  
+  
+    public List<Activity> Cities { get; set; }  
+  
+    public string Name { get; set; }    
+  
+    static Constraint CheckParent()  
+    {  
+        DelegateInArgument<CreateState> element = new DelegateInArgument<CreateState>();  
+        DelegateInArgument<ValidationContext> context = new DelegateInArgument<ValidationContext>();                          
+        Variable<bool> result = new Variable<bool>();  
+        DelegateInArgument<Activity> parent = new DelegateInArgument<Activity>();  
+  
+        return new Constraint<CreateState>  
+        {                                     
+            Body = new ActivityAction<CreateState,ValidationContext>  
+            {                      
+                Argument1 = element,  
+                Argument2 = context,  
+                Handler = new Sequence  
+                {  
+                    Variables =  
+                    {  
+                        result   
+                    },  
+                    Activities =  
+                    {  
+                        new ForEach<Activity>  
+                        {                                  
+                            Values = new GetParentChain  
+                            {  
+                                ValidationContext = context                                      
+                            },  
+                            Body = new ActivityAction<Activity>  
+                            {     
+                                Argument = parent,   
+                                Handler = new If()  
+                                {                                            
+                                    Condition = new InArgument<bool>((env) => object.Equals(parent.Get(env).GetType(),typeof(CreateCountry))),                                          
+                                    Then = new Assign<bool>  
+                                    {  
+                                        Value = true,  
+                                        To = result  
+                                    }  
+                                }  
+                            }                                  
+                        },  
+                        new AssertValidation  
+                        {  
+                            Assertion = new InArgument<bool>(result),  
+                            Message = new InArgument<string> ("CreateState has to be inside a CreateCountry activity"),                                                                  
+                        }  
+                    }  
+                }  
+            }  
+        };  
+    }  
+  
+    protected override void Execute(CodeActivityContext context)  
+    {  
+        // not needed for the sample  
+    }  
+}  
+```  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]、Windows Workflow Foundation の [検証](../../../docs/framework/windows-workflow-foundation/samples/validation.md) サンプルを参照してください。  
+  
+## 追加の制約  
+ ワークフロー ホスト作成者は、ワークフロー内のアクティビティに追加の検証の制約を指定できます。この場合、制約を作成し、それを <xref:System.Activities.Validation.ValidationSettings> インスタンスの <xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> ディクショナリに追加します。<xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> の各アイテムには、制約の適用対象であるアクティビティの種類と、その種類のアクティビティに対する追加の制約一覧が含まれます。ワークフローで検証が呼び出されると、派生クラスを含め、指定した種類の各アクティビティは制約を評価します。この例では、前のセクションの `ActivityDisplayNameIsNotSetWarning` 制約は、ワークフロー内のすべてのアクティビティに適用されます。  
+  
+```csharp  
+Activity wf = new Sequence  
+{  
+    // Workflow Details Omitted.  
+};  
+  
+ValidationSettings settings = new ValidationSettings()  
+{  
+  
+    AdditionalConstraints =  
+    {  
+        {typeof(Activity), new List<Constraint> {ActivityDisplayNameIsNotSetWarning()}},       
+    }  
+};  
+  
+// Validate the workflow.  
+ValidationResults results = ActivityValidationServices.Validate(wf, settings);  
+  
+// Evaluate the results.  
+if (results.Errors.Count == 0 && results.Warnings.Count == 0)  
+{  
+    Console.WriteLine("No warnings or errors");  
+}  
+else  
+{  
+    foreach (ValidationError error in results.Errors)  
+    {  
+        Console.WriteLine("Error in " + error.Source.DisplayName + ": " + error.Message);  
+    }  
+    foreach (ValidationError warning in results.Warnings)  
+    {  
+        Console.WriteLine("Warning in " + warning.Source.DisplayName + ": " + warning.Message);  
+    }  
+}  
+```  
+  
+ <xref:System.Activities.Validation.ValidationSettings> の <xref:System.Activities.Validation.ValidationSettings.OnlyUseAdditionalConstraints%2A> プロパティが `true` の場合、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> を呼び出すことで検証が開始されると、指定した追加の制約のみが評価されます。これは、特定の検証の構成についてワークフローを調べる場合に役立ちます。ただし、ワークフローを呼び出すときに、ワークフロー内で構成されている検証ロジックが評価されます。また、ワークフローが正常に開始するように合格する必要があります。[!INCLUDE[crabout](../../../includes/crabout-md.md)] 検証の呼び出しは、[アクティビティ検証の呼び出し](../../../docs/framework/windows-workflow-foundation//invoking-activity-validation.md) を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/deprecated-types.md b/docs/framework/windows-workflow-foundation/deprecated-types.md
new file mode 100644
index 00000000000..7d9f9271bd2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/deprecated-types.md
@@ -0,0 +1,43 @@
+---
+title: "Deprecated types in Windows Workflow Foundation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4aebe928-a964-4c1c-abf7-0dbbd3604b13
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# Deprecated types in Windows Workflow Foundation
+.NET 4 の段階で、ワークフロー チームは、<xref:System.Activities> 名前空間のまったく新しいワークフロー エンジンをリリースしました。  .NET 4.5 ベータ リリースからは、"WF 3" <xref:System.Workflow.Activities>、<xref:System.Workflow.ComponentModel>、および <xref:System.Workflow.Runtime> 名前空間に含まれる型のほとんどが、使用を推奨されない旧式扱いとなります。  
+  
+## 旧式の名前空間とツール  
+ 次のアセンブリには、今後使用を推奨されなくなるパブリック型が 1 つ以上含まれています。  
+  
+-   System.Workflow.Activities.dll  
+  
+-   System.Workflow.ComponentModel.dll  
+  
+-   System.Workflow.Runtime.dll  
+  
+-   System.WorkflowServices.dll  
+  
+-   Microsoft.Workflow.DebugController.dll  
+  
+-   Microsoft.Workflow.Compiler.exe  
+  
+-   Wfc.exe  
+  
+ その結果、推奨されなくなった WF 3 API を今後使用すると、ビルド時に警告が発生し、次のようなメッセージが表示されます。  
+  
+  **警告 BC40000: X は互換性のために残されています: WF 3 の型の使用は推奨されていません。  代わりに WF 4 を使用してください。**  WF 3 の型は .NET Framework の将来のリリースで削除されますが、実際の削除時期はまだ未定です \(4.5 では行われません\)。  この段階的な変更は、今後の方向性を示し、お客様が WF 4 モデルに余裕をもって移行するための期間を確保するためのものです。  もちろん、WF 3 の型は [Microsoft サポート ライフサイクル ポリシー](http://aka.ms/MicrosoftSupportLifecycle) に基づいて引き続きサポートされます。  既存の WF 3 アプリケーションは .NET 4.5 でも問題なく動作します。また、WF 3 ベースの新規および既存ソリューションは [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] でもサポートされます。  
+  
+ <xref:System.Workflow.Activities.Rules> 名前空間に含まれるルール関連の型については、WF 4.5 には相当する型がないため、非推奨扱いにはなりません。  
+  
+ WF 4 へのアプリケーション移行作業に役立つリソースとしては、MSDN サイトの[移行のガイドライン](http://aka.ms/WF4MigrationGuidance)に関する記事と、[WF Codeplex](http://aka.ms/WFCodeplex) サイトにある [WF 4 移行キット](http://aka.ms/WF4MigrationKit) があります。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/designing-and-implementing-custom-activities.md b/docs/framework/windows-workflow-foundation/designing-and-implementing-custom-activities.md
new file mode 100644
index 00000000000..161a13e0533
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/designing-and-implementing-custom-activities.md
@@ -0,0 +1,55 @@
+---
+title: "カスタム アクティビティの設計と実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e30e63d-6e33-4842-a7a4-ce807cef1fad
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# カスタム アクティビティの設計と実装
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] のカスタム アクティビティを作成するには、システム標準アクティビティを複合アクティビティにアセンブルするか、<xref:System.Activities.CodeActivity>、<xref:System.Activities.AsyncCodeActivity>、または <xref:System.Activities.NativeActivity> から派生する新しい型を作成します。  ここでは、いずれかのメソッドを使用してカスタム アクティビティを作成する方法について説明します。  
+  
+> [!IMPORTANT]
+>  既定では、カスタム アクティビティは、ワークフロー デザイナー内で、アクティビティ名を含む単純な四角形として表示されます。  ワーク フロー デザイナーでアクティビティのカスタム ビジュアル表現を指定するには、カスタム デザイナーを作成する必要があります。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]「[カスタム アクティビティ デザイナーおよびテンプレートの使用](../../../docs/framework/windows-workflow-foundation//using-custom-activity-designers-and-templates.md)」を参照してください。  
+  
+## このセクションの内容  
+ [アクティビティ作成オプション](../../../docs/framework/windows-workflow-foundation//activity-authoring-options-in-wf.md)  
+ [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] で使用できる作成スタイルについて説明します。  
+  
+ [カスタム アクティビティの使用](../../../docs/framework/windows-workflow-foundation//using-a-custom-activity.md)  
+ ワークフロー プロジェクトにカスタム アクティビティを追加する方法について説明します。  
+  
+ [非同期アクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-asynchronous-activities-in-wf.md)  
+ 非同期アクティビティを作成する方法について説明します。  
+  
+ [アクティビティ検証の構成](../../../docs/framework/windows-workflow-foundation//configuring-activity-validation.md)  
+ アクティビティの検証を使用して、アクティビティを実行する前にその構成エラーを特定および報告する方法について説明します。  
+  
+ [実行時におけるアクティビティの作成](../../../docs/framework/windows-workflow-foundation//creating-an-activity-at-runtime-with-dynamicactivity.md)  
+ <xref:System.Activities.DynamicActivity> を使用して実行時にアクティビティを作成する方法について説明します。  
+  
+ [ワークフロー実行プロパティ](../../../docs/framework/windows-workflow-foundation//workflow-execution-properties.md)  
+ ワークフロー実行プロパティを使用して、アクティビティの環境にコンテキスト固有のプロパティを追加する方法について説明します。  
+  
+ [アクティビティ デリゲートの使用](../../../docs/framework/windows-workflow-foundation//using-activity-delegates.md)  
+ アクティビティ デリゲートを含むアクティビティを作成および使用する方法について説明します。  
+  
+ [アクティビティのローカライズ](../../../docs/framework/windows-workflow-foundation//activity-localization.md)  
+ アクティビティの文字列リソースのローカライズを使用する方法について説明します。  
+  
+ [アクティビティ拡張機能の使用](../../../docs/framework/windows-workflow-foundation//using-activity-extensions.md)  
+ アクティビティ拡張機能を作成および使用する方法について説明します。  
+  
+ [ワークフローからの OData フィードの利用](../../../docs/framework/windows-workflow-foundation//consuming-odata-feeds-from-a-workflow.md)  
+ ワークフローから WCF Data Service を呼び出すためのいくつかの方法について説明します。  
+  
+ [アクティビティ定義のスコープ設定と表示](../../../docs/framework/windows-workflow-foundation//activity-definition-scoping-and-visibility.md)  
+ アクティビティのデータのスコープとメンバーの参照範囲を定義するためのオプションおよび規則について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/designing-workflows.md b/docs/framework/windows-workflow-foundation/designing-workflows.md
new file mode 100644
index 00000000000..d5abe8f271e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/designing-workflows.md
@@ -0,0 +1,33 @@
+---
+title: "ワークフローの設計 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], ワークフローの設計"
+ms.assetid: 41f727b5-b142-4c1b-b046-492b96135ae6
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# ワークフローの設計
+このセクションの各トピックでは、ワークフローの開発で使用するフロー制御パラダイムについて説明します。  
+  
+## このセクションの内容  
+ [Flowchart のワークフロー](../../../docs/framework/windows-workflow-foundation//flowchart-workflows.md)  
+ なじみのあるフローチャート パラダイムを使用してワークフロー作成する方法を示します。  
+  
+ [手続き型ワークフロー](../../../docs/framework/windows-workflow-foundation//procedural-workflows.md)  
+ 基本的で連続的な実行パラダイムを使用してワークフローを作成する方法を示します。  
+  
+ [ステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//state-machine-workflows.md)  
+ 以前のバージョンでは使用されていたステート マシン モデルの代わりに、[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] でフローチャート ワークフローを使用してイベント ドリブン ワークフローを実装する方法について説明します。  
+  
+ [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)  
+ 命令型コードを使用してワークフローを作成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/determining-workflow-execution-duration-using-tracing.md b/docs/framework/windows-workflow-foundation/determining-workflow-execution-duration-using-tracing.md
new file mode 100644
index 00000000000..87b8e9668f3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/determining-workflow-execution-duration-using-tracing.md
@@ -0,0 +1,43 @@
+---
+title: "トレースを使用したワークフロー実行時間の決定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f04ad0fd-edc7-4cbc-8979-356f2a1131c4
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# トレースを使用したワークフロー実行時間の決定
+このトピックでは、ワークフロー トレースを使用して、正常に完了した自己ホスト型ワークフローの実行所要時間を決定する方法を示します。  
+  
+### ワークフロー トレースを使用してワークフロー アプリケーションの実行時間を決定するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を起動します。**\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順にクリックします。**\[C\#\]** から **\[ワークフロー\]** ノードを選択します。テンプレートの一覧から **\[ワークフロー コンソール アプリケーション\]** を選択します。新しいプロジェクトに `WorkflowDurationTracing` という名前を設定し、**\[OK\]** をクリックします。  
+  
+2.  Workflow1.xaml を開きます。<xref:System.Activities.Statements.Delay> アクティビティをデザイナー画面にドラッグします。00:00:10 \(10 秒\) という値をアクティビティの "実行時間" プロパティに割り当てます。  
+  
+3.  **\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックし、「`eventvwr.exe`」と入力してイベント ビューアーを開きます。  
+  
+4.  ワークフロー トレースを有効にしていない場合は、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** の順に展開します。**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。**\[デバッグ\]** を右クリックし、**\[ログを有効にする\]** をクリックします。ワークフローが実行された後にトレースを表示できるように、イベント ビューアーを開いたままにしておきます。  
+  
+5.  Ctrl \+ Shift \+ B キーを押してワークフロー アプリケーションを実行します。  
+  
+6.  イベント ビューアーで、1009 の ID を持つ最近のイベント、および次のようなメッセージを探します。メッセージがログに記録された時刻を書き留めます。  
+  
+ **Parent Activity '', DisplayName: '', InstanceId: '' scheduled child Activity 'WorkflowDurationTracking.Workflow1', DisplayName: 'Workflow1', InstanceId: '1'.**  
+  
+7.  さらに、1001 の ID を持つ最近のイベント、および次のようなメッセージを探します。このメッセージのログに記録された値から前のメッセージの時刻を差し引いてワークフロー実行時間を決定します。この時間は約 10 秒になります。  
+  
+ **WorkflowInstance Id: '1bbac57b\-3322\-498e\-9e27\-8833fda3a5bf' has completed in the Closed state.**  
+  
+## 参照  
+ [ワークフロー トレース](../../../docs/framework/windows-workflow-foundation//workflow-tracing.md)   
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/dynamic-update.md b/docs/framework/windows-workflow-foundation/dynamic-update.md
new file mode 100644
index 00000000000..ab6a164edda
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/dynamic-update.md
@@ -0,0 +1,199 @@
+---
+title: "動的な更新 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8b6ef19b-9691-4b4b-824c-3c651a9db96e
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 動的な更新
+動的更新は、ワークフロー アプリケーションの開発者が永続化されたワークフロー インスタンスのワークフロー定義を更新するためのメカニズムを提供します。  これには、バグ修正の実装、新しい要件の実装、または予期しない変更への対応があります。  このトピックでは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された動的更新機能の概要について説明します。  
+  
+## 動的な更新  
+ 永続化されたワークフロー インスタンスに動的更新を適用するには、必要な変更を反映するよう永続化されたワークフロー インスタンスを変更する方法を説明した指示をランタイム用に含む <xref:System.Activities.DynamicUpdate.DynamicUpdateMap> を作成します。  更新マップが作成されると、対象の永続化されたワークフロー インスタンスに適用されます。  動的更新が適用されると、更新された新しいワークフロー定義を使用して、ワークフロー インスタンスが再開される場合があります。  更新マップを作成して適用する際に必要な手順は 4 つあります。  
+  
+1.  [動的更新用のワークフロー定義を準備します。](../../../docs/framework/windows-workflow-foundation//dynamic-update.md#Prepare)  
+  
+2.  [必要な変更を反映するようにワークフロー定義を更新します。](../../../docs/framework/windows-workflow-foundation//dynamic-update.md#Update)  
+  
+3.  [更新マップを作成します。](../../../docs/framework/windows-workflow-foundation//dynamic-update.md#Create)  
+  
+4.  [目的の永続化されたワークフロー インスタンスに更新マップを適用します。](../../../docs/framework/windows-workflow-foundation//dynamic-update.md#Apply)  
+  
+> [!NOTE]
+>  更新マップの作成に対応する手順 1. ～ 3. は、更新の適用とは関係なく実行できます。  一般的には、ワークフローの開発者が更新マップをオフラインで作成し、管理者が後でその更新を適用します。  
+  
+ このトピックでは、コンパイルされた XAML ワークフローの永続インスタンスに新しいアクティビティを追加するという動的更新プロセスの概要について説明します。  
+  
+###  <a name="Prepare"></a> 動的更新用のワークフロー定義を準備します。  
+ 動的更新プロセスでは、最初に、更新に必要なワークフロー定義を準備します。  これを行うには、<xref:System.Activities.DynamicUpdate.DynamicUpdateServices.PrepareForUpdate%2A?displayProperty=fullName> メソッドを呼び出し、変更するワークフロー定義を渡します。  このメソッドは、ワークフロー ツリーを検証して、変更後のワークフロー定義と後で比較できるようにタグ付けを必要とする、パブリック アクティビティやパブリック変数などのすべてのオブジェクトを特定します。  この処理が完了すると、ワークフロー ツリーは複製され、元のワークフロー定義にアタッチされます。  更新マップを作成すると、ワークフロー定義の更新後のバージョンが元のワークフロー定義と比較され、その相違点に基づいて更新マップが生成されます。  
+  
+ 動的更新用に XAML ワークフローを準備するために、XAML ワークフローが <xref:System.Activities.ActivityBuilder> に読み込まれた後、<xref:System.Activities.ActivityBuilder> が <xref:System.Activities.DynamicUpdate.DynamicUpdateServices.PrepareForUpdate%2A?displayProperty=fullName> に渡される場合があります。  
+  
+> [!NOTE]
+>  シリアル化されたワークフローと <xref:System.Activities.ActivityBuilder> の作業の詳細については、「[XAML との間のワークフローおよびアクティビティのシリアル化](../../../docs/framework/windows-workflow-foundation//serializing-workflows-and-activities-to-and-from-xaml.md)」を参照してください。  
+  
+ 次の例では、\(複数の子アクティビティを持つ `MortgageWorkflow` で構成される\) <xref:System.Activities.Statements.Sequence> の定義が <xref:System.Activities.ActivityBuilder> に読み込まれ、動的更新用に準備されます。  メソッドから制御が戻ると、<xref:System.Activities.ActivityBuilder> には元のワークフロー定義とコピーが格納されます。  
+  
+```csharp  
+// Load the MortgageWorkflow definition from Xaml into  
+// an ActivityBuilder.  
+XamlXmlReaderSettings readerSettings = new XamlXmlReaderSettings()  
+{  
+    LocalAssembly = Assembly.GetExecutingAssembly()  
+};  
+  
+XamlXmlReader xamlReader = new XamlXmlReader(@"C:\WorkflowDefitinions\MortgageWorkflow.xaml",   
+    readerSettings);  
+  
+ActivityBuilder ab = XamlServices.Load(  
+    ActivityXamlServices.CreateBuilderReader(xamlReader)) as ActivityBuilder;  
+  
+// Prepare the workflow definition for dynamic update.  
+DynamicUpdateServices.PrepareForUpdate(ab);  
+```  
+  
+> [!NOTE]
+>  このトピックに含まれるサンプル コードをダウンロードするには、[動的更新のサンプル コード](http://go.microsoft.com/fwlink/?LinkId=227905)を参照してください。  
+  
+###  <a name="Update"></a> 必要な変更を反映するようにワークフロー定義を更新します。  
+ ワークフロー定義を更新するための準備が完了したら、必要な変更を加えることができます。  アクティビティの追加または削除、パブリック変数の追加、移動、または削除、引数の追加または削除、およびアクティビティ デリゲートのシグネチャの変更を実行できます。  実行中のアクティビティを削除したり、実行中のデリゲートのシグネチャを変更したりすることはできません。  これらの変更は、コードを使用して行うか、再ホストされたワークフロー デザイナーで行うことができます。  次の例では、カスタムの `VerifyAppraisal` アクティビティが、前の例の `MortgageWorkflow` の本体を構成する Sequence に追加されます。  
+  
+```csharp  
+// Make desired changes to the definition. In this example, we are  
+// inserting a new VerifyAppraisal activity as the 3rd child of the root Sequence.  
+VerifyAppraisal va = new VerifyAppraisal  
+{  
+    Result = new VisualBasicReference<bool>("LoanCriteria")  
+};  
+  
+// Get the Sequence that makes up the body of the workflow.  
+Sequence s = ab.Implementation as Sequence;  
+  
+// Insert the new activity into the Sequence.  
+s.Activities.Insert(2, va);  
+```  
+  
+###  <a name="Create"></a> 更新マップを作成します。  
+ 更新用に準備されたワークフロー定義を変更すると、更新マップを作成できます。  動的更新マップを作成するには、<xref:System.Activities.DynamicUpdate.DynamicUpdateServices.CreateUpdateMap%2A?displayProperty=fullName> メソッドを呼び出します。  これにより、永続化されたワークフロー インスタンスを新しいワークフロー定義で読み込んで再開できるように変更するためにランタイムに必要な情報を含む <xref:System.Activities.DynamicUpdate.DynamicUpdateMap> が返されます。  次の例では、前の例で変更した `MortgageWorkflow` 定義に対して動的マップが作成されます。  
+  
+```csharp  
+// Create the update map.  
+DynamicUpdateMap map = DynamicUpdateServices.CreateUpdateMap(ab);  
+```  
+  
+ この更新マップは、永続化されたワークフロー インスタンスを変更するためにすぐに使用できますが、通常は、後で更新が適用されるように保存できます。  更新マップを保存する 1 つの方法として、次の例に示すように、更新マップをファイルにシリアル化します。  
+  
+```csharp  
+// Serialize the update map to a file.  
+DataContractSerializer serializer = new DataContractSerializer(typeof(DynamicUpdateMap));  
+using (FileStream fs = System.IO.File.Open(@"C:\WorkflowDefitinions\MortgageWorkflow.map", FileMode.Create))  
+{  
+    serializer.WriteObject(fs, map);  
+}  
+```  
+  
+ <xref:System.Activities.DynamicUpdate.DynamicUpdateServices.CreateUpdateMap%2A?displayProperty=fullName> 空制御が戻ると、<xref:System.Activities.DynamicUpdate.DynamicUpdateServices.PrepareForUpdate%2A?displayProperty=fullName> の呼び出し時に追加された、複製されたワークフロー定義とその他の動的更新情報が削除され、更新されたワークフロー インスタンスを後で再開するときに使用できるように変更後のワークフロー定義を保存できるようになります。  次の例では、変更後のワークフロー定義が `MortgageWorkflow_v2.xaml` に保存されます。  
+  
+```csharp  
+// Save the modified workflow definition.  
+StreamWriter sw = File.CreateText(@"C:\WorkflowDefitinions\MortgageWorkflow_v1.1.xaml");  
+XamlWriter xw = ActivityXamlServices.CreateBuilderWriter(new XamlXmlWriter(sw, new XamlSchemaContext()));  
+XamlServices.Save(xw, ab);  
+sw.Close();  
+```  
+  
+###  <a name="Apply"></a> 目的の永続化されたワークフロー インスタンスに更新マップを適用します。  
+ 更新マップは作成後にいつでも適用できます。  これは、<xref:System.Activities.DynamicUpdate.DynamicUpdateMap> によって返された <xref:System.Activities.DynamicUpdate.DynamicUpdateServices.CreateUpdateMap%2A?displayProperty=fullName> インスタンスを使用してすぐに実行することも、更新マップの保存したコピーを使用して後で実行することもできます。  ワークフロー インスタンスを更新するには、<xref:System.Activities.WorkflowApplicationInstance> を使用して、そのワークフロー インスタンスを <xref:System.Activities.WorkflowApplication.GetInstance%2A?displayProperty=fullName> に読み込みます。  次に、更新されたワークフロー定義と必要な <xref:System.Activities.WorkflowApplication> を使用して、<xref:System.Activities.WorkflowIdentity> を作成します。  この <xref:System.Activities.WorkflowIdentity> は、元のワークフローの永続化に使用されたものとは異なる場合があるため、通常は、永続化されたインスタンスが変更されていることを示すために使用されます。  <xref:System.Activities.WorkflowApplication> は、作成されると、<xref:System.Activities.WorkflowApplication.Load%2A?displayProperty=fullName> を取得する <xref:System.Activities.DynamicUpdate.DynamicUpdateMap> のオーバーロードを使用して読み込まれ、<xref:System.Activities.WorkflowApplication.Unload%2A?displayProperty=fullName> の呼び出しを使用してアンロードされます。  これにより、動的更新が適用され、更新されたワークフロー インスタンスが永続化されます。  
+  
+```csharp  
+// Load the serialized update map.  
+DynamicUpdateMap map;  
+using (FileStream fs = File.Open(@"C:\WorkflowDefitinions\MortgageWorkflow.map", FileMode.Open))  
+{  
+    DataContractSerializer serializer = new DataContractSerializer(typeof(DynamicUpdateMap));  
+    object updateMap = serializer.ReadObject(fs);  
+    if (updateMap == null)  
+    {  
+        throw new ApplicationException("DynamicUpdateMap is null.");  
+    }  
+  
+    map = (DynamicUpdateMap)updateMap;  
+}  
+  
+// Retrieve a list of workflow instance ids that corresponds to the  
+// workflow instances to update. This step is the responsibility of  
+// the application developer.  
+List<Guid> ids = GetPersistedWorkflowIds();  
+foreach (Guid id in ids)  
+{  
+    // Get a proxy to the persisted workflow instance.  
+    SqlWorkflowInstanceStore store = new SqlWorkflowInstanceStore(connectionString);  
+    WorkflowApplicationInstance instance = WorkflowApplication.GetInstance(id, store);  
+  
+    // If desired, you can inspect the WorkflowIdentity of the instance  
+    // using the DefinitionIdentity property to determine whether to apply  
+    // the update.  
+    Console.WriteLine(instance.DefinitionIdentity);  
+  
+    // Create a workflow application. You must specify the updated workflow definition, and  
+    // you may provide an updated WorkflowIdentity if desired to reflect the update.  
+    WorkflowIdentity identity = new WorkflowIdentity  
+    {  
+        Name = "MortgageWorkflow v1.1",  
+        Version = new Version(1, 1, 0, 0)  
+    };  
+  
+    // Load the persisted workflow instance using the updated workflow definition  
+    // and with an updated WorkflowIdentity. In this example the MortgageWorkflow class  
+    // contains the updated definition.  
+    WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow(), identity);  
+  
+    // Apply the dynamic update on the loaded instance.                
+    wfApp.Load(instance, map);  
+  
+    // Unload the updated instance.  
+    wfApp.Unload();  
+}  
+```  
+  
+### 更新されたワークフロー インスタンスの再開  
+ 動的更新が適用されると、ワークフロー インスタンスが再開される場合があります。  更新された新しい定義と <xref:System.Activities.WorkflowIdentity> を使用する必要があります。  
+  
+> [!NOTE]
+>  <xref:System.Activities.WorkflowApplication> と <xref:System.Activities.WorkflowIdentity> の使用の詳細については、「[WorkflowIdentity と Versioning の使用](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md)」を参照してください。  
+  
+ 次の例では、前の例の `MortgageWorkflow_v1.1.xaml` ワークフローがコンパイルされ、更新されたワークフロー定義を使用して読み込まれ、再開されます。  
+  
+```csharp  
+// Load the persisted workflow instance using the updated workflow definition  
+// and updated WorkflowIdentity.  
+WorkflowIdentity identity = new WorkflowIdentity  
+{  
+    Name = "MortgageWorkflow v1.1",  
+    Version = new Version(1, 1, 0, 0)  
+};  
+  
+WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow(), identity);  
+  
+// Configure persistence and desired workflow event handlers.  
+// (Omitted for brevity.)  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Load the persisted workflow instance.  
+wfApp.Load(InstanceId);  
+  
+// Resume the workflow.  
+// wfApp.ResumeBookmark(...);  
+```  
+  
+> [!NOTE]
+>  このトピックに含まれるサンプル コードをダウンロードするには、[動的更新のサンプル コード](http://go.microsoft.com/fwlink/?LinkId=227905)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/error-handling-activities-in-wf.md b/docs/framework/windows-workflow-foundation/error-handling-activities-in-wf.md
new file mode 100644
index 00000000000..5704cd4dc6f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/error-handling-activities-in-wf.md
@@ -0,0 +1,26 @@
+---
+title: "WF 内のエラー処理アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 24b68bd3-cef5-4413-ab82-2e2625f209aa
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WF 内のエラー処理アクティビティ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、エラーの処理および回復を実装するためのシステム標準のアクティビティが用意されています。  [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][例外](../../../docs/framework/windows-workflow-foundation//exceptions.md)。  
+  
+## エラー処理アクティビティ  
+  
+|||  
+|-|-|  
+|<xref:System.Activities.Statements.Rethrow>|`TryCatch` アクティビティ内からスローされた最後の例外を再スローします。|  
+|<xref:System.Activities.Statements.Throw>|例外をスローします。|  
+|<xref:System.Activities.Statements.TryCatch>|例外処理を実装します。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/error-handling-in-asynchronous-activities.md b/docs/framework/windows-workflow-foundation/error-handling-in-asynchronous-activities.md
new file mode 100644
index 00000000000..94ed885db76
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/error-handling-in-asynchronous-activities.md
@@ -0,0 +1,56 @@
+---
+title: "非同期アクティビティ内のエラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e8f8ce2b-50c9-4e44-b187-030e0cf30a5d
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 非同期アクティビティ内のエラー処理
+<xref:System.Activities.AsyncCodeActivity> でのエラー処理には 、アクティビティのコールバック システムを使用したエラーの送信が含まれています。このトピックでは、SendMail アクティビティのサンプルを使用してホストへ非同期操作でスローされる エラーを取得する方法について説明します。  
+  
+## 非同期アクティビティでスローされたエラーをホストへ返す  
+ SendMail アクティビティ サンプルにある、ホストに返される非同期操作でのエラー送信には、次の手順が含まれています。:  
+  
+-   Exception プロパティを `SendMailAsyncResult` クラスに追加します。  
+  
+-   スローされたエラーを `SendCompleted` イベント ハンドラー内でそのプロパティにコピーします。  
+  
+-   `EndExecute` イベント ハンドラー内で例外をスローします。  
+  
+ 結果として得られるコードは次のようになります。  
+  
+```csharp  
+class SendMailAsyncResult : IAsyncResult  
+        {  
+            …  
+            public Exception Error { get; set; }   
+            …  
+            void SendCompleted(object sender, AsyncCompletedEventArgs e)  
+            {  
+                Error = e.Error;  
+                this.asyncWaitHandle.Set();  
+                callback(this);  
+            }  
+         }  
+  
+    public sealed class SendMail: AsyncCodeActivity  
+    {  
+         …  
+        protected override void EndExecute(AsyncCodeActivityContext context, IAsyncResult result)  
+        {  
+            SendMailAsyncResult sendMailResult = result as SendMailAsyncResult;  
+            if (sendMailResult != null && sendMailResult.Error != null)  
+                throw sendMailResult.Error;   
+        }  
+    }  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/exceptions-transactions-and-compensation.md b/docs/framework/windows-workflow-foundation/exceptions-transactions-and-compensation.md
new file mode 100644
index 00000000000..32db5334e8d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/exceptions-transactions-and-compensation.md
@@ -0,0 +1,36 @@
+---
+title: "例外、トランザクション、および補正 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], エラー処理"
+ms.assetid: 694db4f9-7387-4b13-8f9f-b923b18c7490
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 例外、トランザクション、および補正
+[!INCLUDE[wf1](../../../includes/wf1-md.md)] には、ワークフロー内のランタイム エラー条件を処理するさまざまな機構が用意されています。ワークフローでは、例外ハンドラー、トランザクション、キャンセル、および補正の組み合わせを使用して、エラー条件の処理と適切な回復を行えます。  
+  
+## このセクションの内容  
+ [例外](../../../docs/framework/windows-workflow-foundation//exceptions.md)  
+ <xref:System.Activities.Statements.TryCatch> アクティビティを使用して、ワークフローで例外を処理する方法について説明します。  
+  
+ [トランザクション](../../../docs/framework/windows-workflow-foundation//workflow-transactions.md)  
+ <xref:System.Activities.Statements.TransactionScope> アクティビティを利用してワークフローでトランザクションを使用する方法を説明します。  
+  
+ [補正](../../../docs/framework/windows-workflow-foundation//compensation.md)  
+ ワークフローの補正について説明します。また、<xref:System.Activities.Statements.CompensableActivity>、<xref:System.Activities.Statements.Compensate>、および <xref:System.Activities.Statements.Confirm> などの補正アクティビティを使用する方法について説明します。  
+  
+ [取り消し](../../../docs/framework/windows-workflow-foundation//modeling-cancellation-behavior-in-workflows.md)  
+ 組み込みのアクティビティとカスタム アクティビティを使用してワークフローでキャンセル処理を実行する方法について説明します。  
+  
+ [デバッグのワークフロー](../../../docs/framework/windows-workflow-foundation//debugging-workflows.md)  
+ ワークフローをデバッグする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/exceptions.md b/docs/framework/windows-workflow-foundation/exceptions.md
new file mode 100644
index 00000000000..4e84e40e860
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/exceptions.md
@@ -0,0 +1,61 @@
+---
+title: "例外 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 065205cc-52dd-4f30-9578-b17d8d113136
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# 例外
+ワークフローは、<xref:System.Activities.Statements.TryCatch> アクティビティを使用して、ワークフローの実行中に発生した例外を処理することができます。これらの例外は、処理することも可能ですが、<xref:System.Activities.Statements.Rethrow> アクティビティを使用して再スローすることもできます。<xref:System.Activities.Statements.TryCatch.Finally%2A> セクションのアクティビティは、<xref:System.Activities.Statements.TryCatch.Try%2A> セクションまたは <xref:System.Activities.Statements.TryCatch.Catches%2A> セクションが完了したときに実行されます。また、<xref:System.Activities.WorkflowApplication> インスタンスによってホストされるワークフローは <xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> イベント ハンドラーを使用して、<xref:System.Activities.Statements.TryCatch> アクティビティで処理されない例外を処理することができます。  
+  
+## 例外の原因  
+ ワークフローでは、例外は、次の方法で生成されます。  
+  
+-   <xref:System.Activities.Statements.TransactionScope> でのトランザクションのタイムアウト  
+  
+-   <xref:System.Activities.Statements.Throw> アクティビティを使用してワークフローからスローされた明示的な例外  
+  
+-   アクティビティからスローされた [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] 例外  
+  
+-   ワークフローで使用されているライブラリ、コンポーネント、サービスなどの外部コードからスローされた例外  
+  
+## 例外処理  
+ アクティビティからスローされた例外が処理されない場合、既定の動作では、ワークフロー インスタンスが終了します。カスタムの <xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> ハンドラーが存在する場合、このハンドラーで既定の動作をオーバーライドできます。このハンドラーがあると、ワークフロー ホストの作成者は、カスタムのログ記録、ワークフローの中止、ワークフローのキャンセル、ワークフローの終了などの適切な処理を実行できます。ワークフローが処理されない例外を発生する場合、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> ハンドラーが呼び出されます。<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> から戻された3 つの可能なアクションがあり、これによりワークフローの最終結果が決定されます。  
+  
+-   **キャンセル** \- キャンセルされたワークフロー インスタンスは分岐実行の通常終了です。キャンセルの動作をモデル化できます \(たとえば、CancellationScope アクティビティを使用して\)。完了済みハンドラーはキャンセル プロセスが完了したときに呼び出されます。取り消されたワーク フローは キャンセル状態にあります。  
+  
+-   **終了** \- 終了したワークフロー インスタンスは再開または再起動できません。これにより完了イベントがトリガーされ、中断されたという理由の例外を提供できます。終了したハンドラーはキャンセル プロセスが終了したときに呼び出されます。終了したワークフローは失敗状態です。  
+  
+-   **中止** \- 永続的な構成した場合にのみ、中止されたワークフロー インスタンスを再開できます。永続化がない場合、ワークフローは再開できません。ワークフローが中止したポイントで、最後の永続性ポイントが失われるため \(メモリ内で\)、どの作業も終了します 。中止されたワーク フローに対して、中止プロセスが完了したときの例外を使用して、中止されたハンドラーが呼び出されます。しかし、キャンセルおよび終了と異なり、完了ハンドラーは呼び出されません。中止されたワーク フローが中断状態にあります。  
+  
+ 次の例では、例外をスローするワークフローを呼び出しています。ワークフローで例外が処理されないため、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> ハンドラーが呼び出されます。例外に関する情報を提供するために <xref:System.Activities.WorkflowApplicationUnhandledExceptionEventArgs> が調査され、ワークフローは終了します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#1](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#1)]  
+  
+### TryCatch アクティビティでの例外処理  
+ ワークフロー内部での例外処理は、<xref:System.Activities.Statements.TryCatch> アクティビティで実行されます。<xref:System.Activities.Statements.TryCatch> アクティビティには、それぞれが特定の <xref:System.Exception> 型に関連付けられている <xref:System.Activities.Statements.Catch> アクティビティの <xref:System.Activities.Statements.TryCatch.Catches%2A> コレクションがあります。<xref:System.Activities.Statements.TryCatch> アクティビティの <xref:System.Activities.Statements.TryCatch.Try%2A> セクションに含まれているアクティビティからスローされた例外が、<xref:System.Activities.Statements.TryCatch.Catches%2A> コレクションの <xref:System.Activities.Statements.Catch%601> アクティビティの例外に一致する場合、スローされた例外が処理されます。例外が明示的に再スローされるか、新しい例外がスローされた場合、この例外は親アクティビティに渡されます。次のコード例は、<xref:System.Activities.Statements.TryCatch.Try%2A> セクションで <xref:System.Activities.Statements.Throw> アクティビティからスローされた <xref:System.ApplicationException> を処理する <xref:System.Activities.Statements.TryCatch> アクティビティを示しています。例外のメッセージが <xref:System.Activities.Statements.Catch%601> アクティビティによってコンソールに書き込まれた後、<xref:System.Activities.Statements.TryCatch.Finally%2A> セクションでメッセージがコンソールに書き込まれます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#33](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#33)]  
+  
+ <xref:System.Activities.Statements.TryCatch.Finally%2A> セクションのアクティビティは、<xref:System.Activities.Statements.TryCatch.Try%2A> セクションまたは <xref:System.Activities.Statements.TryCatch.Catches%2A> セクションが正常に完了したときに実行されます。例外がスローされない場合 <xref:System.Activities.Statements.TryCatch.Try%2A> セクションは正常に終了し、例外がスローされるまたは再スローされない場合 <xref:System.Activities.Statements.TryCatch.Catches%2A> セクションは正常に完了します。例外が <xref:System.Activities.Statements.TryCatch> の <xref:System.Activities.Statements.TryCatch.Try%2A> セクションでスローされ、<xref:System.Activities.Statements.TryCatch.Catches%2A> セクションの <xref:System.Activities.Statements.Catch%601> で処理されないか、または <xref:System.Activities.Statements.TryCatch.Catches%2A> からスローされる場合、<xref:System.Activities.Statements.TryCatch.Finally%2A> のアクティビティは以下のいずれかが発生しない限り実行されます。  
+  
+-   高レベルの <xref:System.Activities.Statements.TryCatch> から再スローされるかにかかわらず、例外がワーク フローの高レベルの <xref:System.Activities.Statements.TryCatch> アクティビティによって取得されます。  
+  
+-   例外は高レベルの <xref:System.Activities.Statements.TryCatch>では扱われず、ワークフローのルートをエスケープし、ワーク フローが完了または中止ではなく取り消すように構成されます。<xref:System.Activities.WorkflowApplication> を使用してホストされたワークフローは、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> を処理し <xref:System.Activities.UnhandledExceptionAction> を返してこれを構成できます。<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> を処理する例は、このトピックですでに提供されています。ワークフロー サービスは <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> を使用し <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionAction> を指定してこれを構成できます。<xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> の構成の例は、[ワークフロー サービス ホストの拡張機能](../../../docs/framework/wcf/feature-details/workflow-service-host-extensibility.md) を参照してください。  
+  
+## 例外処理と補正の比較  
+ 例外処理は、アクティビティの実行中に発生するという点で補正と異なります。補正が発生するのは、アクティビティが正常に完了した後です。例外処理では、アクティビティが例外を生成した後でクリーン アップを実行できます。また、補正処理では、前に完了したアクティビティの正常に完了した作業を元に戻すことが可能です。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][補正](../../../docs/framework/windows-workflow-foundation//compensation.md).  
+  
+## 参照  
+ <xref:System.Activities.Statements.TryCatch>   
+ <xref:System.Activities.WorkflowApplication.OnUnhandledException%2A>   
+ <xref:System.Activities.Statements.CompensableActivity>
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/exposing-data-with-cachemetadata.md b/docs/framework/windows-workflow-foundation/exposing-data-with-cachemetadata.md
new file mode 100644
index 00000000000..ff5976a072c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/exposing-data-with-cachemetadata.md
@@ -0,0 +1,94 @@
+---
+title: "CacheMetadata を使用したデータの公開 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 34832f23-e93b-40e6-a80b-606a855a00d9
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# CacheMetadata を使用したデータの公開
+アクティビティを実行する前に、ワークフロー ランタイムは実行を維持するために必要なアクティビティに関するすべての情報を取得します。ワークフロー ランタイムは <xref:System.Activities.Activity.CacheMetadata%2A> メソッドの実行時にこの情報を取得します。このメソッドの既定の実装は、アクティビティによって公開されたすべてのパブリック引数、変数、子アクティビティを実行時にランタイムに提供します。アクティビティがランタイムにその他の情報 \(プライベート メンバーやアクティビティによってスケジュールされるアクティビティなど\) を提供する必要がある場合、このメソッドをオーバーライドして情報を提供できます。  
+  
+## CacheMetadata の既定の動作  
+ <xref:System.Activities.NativeActivity> から派生したアクティビティの <xref:System.Activities.NativeActivity.CacheMetadata%2A> の既定の実装は、次のメソッド型を以下の方法で処理します。  
+  
+-   <xref:System.Activities.InArgument%601>、<xref:System.Activities.OutArgument%601>、または <xref:System.Activities.InOutArgument%601> \(ジェネリック引数\): これらの引数は公開されたプロパティと同じ名前、データ型、引数の方向、および検証データで引数としてランタイムに公開されます。  
+  
+-   <xref:System.Activities.Variable> またはそのサブクラス: これらのメンバーはパブリック変数としてランタイムに公開されます。  
+  
+-   <xref:System.Activities.Activity> またはそのサブクラス: これらのメンバーはパブリック子アクティビティとしてランタイムに公開されます。既定の動作を明示的に実装するには、子アクティビティを渡して <xref:System.Activities.ActivityMetadata.AddImportedChild%2A> を呼び出します。  
+  
+-   <xref:System.Activities.ActivityDelegate> またはそのサブクラス: これらのメンバーはパブリック デリゲートとしてランタイムに公開されます。  
+  
+-   <xref:System.Activities.Variable> 型の <xref:System.Collections.ICollection>: コレクション内のすべての要素がパブリック変数としてランタイムに公開されます。  
+  
+-   <xref:System.Activities.Activity> 型の <xref:System.Collections.ICollection>: コレクション内のすべての要素がパブリック子としてランタイムに公開されます。  
+  
+-   <xref:System.Activities.ActivityDelegate> 型の <xref:System.Collections.ICollection>: コレクション内のすべての要素がパブリック デリゲートとしてランタイムに公開されます。  
+  
+ <xref:System.Activities.Activity>、<xref:System.Workflow.Activities.CodeActivity>、および <xref:System.Activities.AsyncCodeActivity> から派生したアクティビティの <xref:System.Activities.Activity.CacheMetadata%2A> も次の相違点を除いて前述と同様に機能します。  
+  
+-   <xref:System.Activities.Activity> から派生したクラスは子アクティビティまたはデリゲートをスケジュールできないため、これらのメンバーはインポートされた子およびデリゲートとして公開されます。  
+  
+-   <xref:System.Activities.CodeActivity> および <xref:System.Activities.AsyncCodeActivity> から派生したクラスは変数、子、またはデリゲートをサポートしないため、引数のみが公開されます。  
+  
+## CacheMetadata をオーバーライドしてランタイムに情報を提供する  
+ 次のコード スニペットは、<xref:System.Activities.Activity.CacheMetadata%2A> メソッドの実行時にメンバーに関する情報をアクティビティのメタデータに追加する方法を示しています。メソッドの base を呼び出して、アクティビティに関するすべてのパブリック データをキャッシュしています。  
+  
+```  
+protected override void CacheMetadata(NativeActivityMetadata metadata)  
+{      
+    base.CacheMetadata(metadata);  
+    metadata.AddImplementationChild(this._writeLine);  
+    metadata.AddVariable(this._myVariable);  
+    metadata.AddImplementationVariable(this._myImplementationVariable);  
+  
+    RuntimeArgument argument = new RuntimeArgument("MyArgument", ArgumentDirection.In, typeof(SomeType));  
+    metadata.Bind(argument, this.SomeName);  
+    metadata.AddArgument(argument);  
+}  
+  
+```  
+  
+## CacheMetadata を使用して実装の子を公開する  
+ アクティビティによってスケジュールされる子アクティビティに変数を使用してデータを渡すには、変数を実装変数として追加する必要があります。パブリック変数ではこの方法で値を設定することはできません。その理由は、アクティビティはカプセル化されたクラス \(プロパティを持つ\) としてよりも、関数 \(パラメーターを持つ\) の実装として実行することを目的としているためです。ただし、場合によっては引数を明示的に設定する必要があります。たとえば、スケジュールされたアクティビティは親アクティビティの引数に子アクティビティと同じ方法でアクセスすることはできないため、<xref:System.Activities.NativeActivityContext.ScheduleActivity%2A> を使用する場合には引数の明示的な設定が必要です。  
+  
+ 次のコード スニペットは、<xref:System.Activities.Activity.CacheMetadata%2A> を使用してネイティブ アクティビティからスケジュールされたアクティビティに引数を渡す方法を示しています。  
+  
+```  
+public sealed class ChildActivity : NativeActivity  
+{  
+    public WriteLine _writeLine;  
+    public InArgument<string> Message { get; set; }  
+    private Variable<string> MessageVariable { get; set; }  
+    public ChildActivity()  
+    {  
+        MessageVariable = new Variable<string>();  
+        _writeLine = new WriteLine  
+        {  
+            Text = new InArgument<string>(MessageVariable),  
+        };  
+    }  
+    protected override void CacheMetadata(NativeActivityMetadata metadata)  
+    {  
+        base.CacheMetadata(metadata);  
+        metadata.AddImplementationVariable(this.MessageVariable);  
+        metadata.AddImplementationChild(this._writeLine);  
+    }  
+    protected override void Execute(NativeActivityContext context)  
+    {  
+        string configuredMessage = context.GetValue(Message);  
+        context.SetValue(MessageVariable, configuredMessage);  
+        context.ScheduleActivity(this._writeLine);  
+    }  
+}  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/expressions.md b/docs/framework/windows-workflow-foundation/expressions.md
new file mode 100644
index 00000000000..725db6973a6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/expressions.md
@@ -0,0 +1,178 @@
+---
+title: "式 [.NET Framework 4] | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c42341a9-43a1-462c-bffb-c5de004aa428
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 式 [.NET Framework 4]
+[!INCLUDE[wf](../../../includes/wf-md.md)] 式は結果を返す任意のアクティビティです。すべての式アクティビティは、アクティビティの戻り値として <xref:System.Activities.Activity%601.Result%2A> という名前の <xref:System.Activities.OutArgument> プロパティを含む <xref:System.Activities.Activity%601> から間接的に派生します。[!INCLUDE[wf1](../../../includes/wf1-md.md)] には、幅広い式アクティビティが用意されています。式アクティビティは、演算子アクティビティを介して 1 つのワークフロー変数へアクセスできる <xref:System.Activities.Expressions.VariableValue%601> や <xref:System.Activities.Expressions.VariableReference%601> などの単純なアクティビティから、結果を生成するために Visual Basic 言語一式へアクセスできる <xref:Microsoft.VisualBasic.Activities.VisualBasicReference%601> や <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> などの複雑なアクティビティまでさまざまです。追加の式アクティビティは、<xref:System.Activities.CodeActivity%601> または <xref:System.Activities.NativeActivity%601> から派生して作成できます。  
+  
+## 式の使用  
+ ワークフロー デザイナーでは、Visual Basic プロジェクトのすべての式に <xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> および <xref:Microsoft.VisualBasic.Activities.VisualBasicReference%601>、C\# ワークフロー プロジェクトの式に <xref:Microsoft.CSharp.Activities.CSharpValue%601> および <xref:Microsoft.CSharp.Activities.CSharpReference%601> を使用します。  
+  
+> [!NOTE]
+>  ワークフロー プロジェクトでの C\# 式のサポートは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入されました。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [C\# の式](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md).  
+  
+ デザイナーによって生成されたワークフローは XAML に保存されます。XAML には、次の例のように、式が角かっこに囲まれて表示されます。  
+  
+```  
+<Sequence xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <Sequence.Variables>  
+    <Variable x:TypeArguments="x:Int32" Default="1" Name="a" />  
+    <Variable x:TypeArguments="x:Int32" Default="2" Name="b" />  
+    <Variable x:TypeArguments="x:Int32" Default="3" Name="c" />  
+    <Variable x:TypeArguments="x:Int32" Default="0" Name="r" />  
+  </Sequence.Variables>  
+  <Assign>  
+    <Assign.To>  
+      <OutArgument x:TypeArguments="x:Int32">[r]</OutArgument>  
+    </Assign.To>  
+    <Assign.Value>  
+      <InArgument x:TypeArguments="x:Int32">[a + b + c]</InArgument>  
+    </Assign.Value>  
+  </Assign>  
+</Sequence>  
+  
+```  
+  
+ コードでワークフローを定義すると、任意の式アクティビティを使用できます。次のコードは、3 つの数を追加する演算子アクティビティの使用例です。  
+  
+```  
+Variable<int> a = new Variable<int>("a", 1);  
+Variable<int> b = new Variable<int>("b", 2);  
+Variable<int> c = new Variable<int>("c", 3);  
+Variable<int> r = new Variable<int>("r", 0);  
+  
+Sequence w = new Sequence  
+{  
+    Variables = { a, b, c, r },  
+    Activities =   
+    {  
+        new Assign {  
+            To = new OutArgument<int>(r),  
+            Value = new InArgument<int> {  
+                Expression = new Add<int, int, int> {  
+                    Left = new Add<int, int, int> {  
+                        Left = new InArgument<int>(a),  
+                        Right = new InArgument<int>(b)  
+                    },  
+                    Right = new InArgument<int>(c)  
+                }  
+            }  
+        }  
+    }  
+};  
+  
+```  
+  
+ C\# のラムダ式を使用すると、次の例のように、同じワークフローをよりコンパクトに表現できます。  
+  
+```  
+Variable<int> a = new Variable<int>("a", 1);  
+Variable<int> b = new Variable<int>("b", 2);  
+Variable<int> c = new Variable<int>("c", 3);  
+Variable<int> r = new Variable<int>("r", 0);  
+  
+Sequence w = new Sequence  
+{  
+    Variables = { a, b, c, r },  
+    Activities =   
+    {  
+        new Assign {  
+            To = new OutArgument<int>(r),  
+            Value = new InArgument<int>((ctx) => a.Get(ctx) + b.Get(ctx) + c.Get(ctx))  
+        }  
+    }  
+};  
+  
+```  
+  
+ 次の例のように、Visual Basic の式アクティビティを使用してワークフローを表現することもできます。  
+  
+```  
+Variable<int> a = new Variable<int>("a", 1);  
+Variable<int> b = new Variable<int>("b", 2);  
+Variable<int> c = new Variable<int>("c", 3);  
+Variable<int> r = new Variable<int>("r", 0);  
+  
+Sequence w = new Sequence  
+{  
+    Variables = { a, b, c, r },  
+    Activities =   
+    {  
+        new Assign {  
+            To = new OutArgument<int>(r),  
+            Value = new InArgument<int>(new VisualBasicValue<int>("a + b + c"))  
+        }  
+    }  
+};  
+  
+```  
+  
+## カスタム式アクティビティによる使用可能な式の拡張  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] の式には、追加の式アクティビティを作成できる拡張性があります。次のコードは、3 つの整数値の合計を返すアクティビティの例です。  
+  
+```  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.Activities;  
+  
+namespace ExpressionsDemo  
+{  
+    public sealed class AddThreeValues : CodeActivity<int>  
+    {  
+        public InArgument<int> Value1 { get; set; }  
+        public InArgument<int> Value2 { get; set; }  
+        public InArgument<int> Value3 { get; set; }  
+  
+        protected override int Execute(CodeActivityContext context)  
+        {  
+            return Value1.Get(context) +   
+                   Value2.Get(context) +   
+                   Value3.Get(context);  
+        }  
+    }  
+}  
+```  
+  
+ 次の例のように、この新しいアクティビティを使用して、3 つの値を追加した前のワークフローを書き直すことができます。  
+  
+```  
+Variable<int> a = new Variable<int>("a", 1);  
+Variable<int> b = new Variable<int>("b", 2);  
+Variable<int> c = new Variable<int>("c", 3);  
+Variable<int> r = new Variable<int>("r", 0);  
+  
+Sequence w = new Sequence  
+{  
+    Variables = { a, b, c, r },  
+    Activities =   
+    {  
+        new Assign {  
+            To = new OutArgument<int>(r),  
+            Value = new InArgument<int> {  
+                Expression = new AddThreeValues() {  
+                    Value1 = new InArgument<int>(a),  
+                    Value2 = new InArgument<int>(b),  
+                    Value3 = new InArgument<int>(c)  
+                }  
+            }  
+        }  
+    }  
+};  
+  
+```  
+  
+ コードで式を使用する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/extend.md b/docs/framework/windows-workflow-foundation/extend.md
new file mode 100644
index 00000000000..8f9c2b4b147
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/extend.md
@@ -0,0 +1,31 @@
+---
+title: "Windows Workflow Foundation の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "拡張 [WF]"
+  - "WF [WF], 拡張"
+  - "Windows Workflow Foundation [WF], 拡張"
+ms.assetid: d6861f28-9c8c-4225-872d-9a80e2e59034
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# Windows Workflow Foundation の拡張
+次のセクションでは、[!INCLUDE[vs2010](../../../includes/vs2010-md.md)] の外部の再ホストされた環境でカスタム アクティビティとデザイナーを使用して [!INCLUDE[wf](../../../includes/wf-md.md)] を拡張する方法について説明します。  
+  
+## このセクションの内容  
+ [ワークフロー デザイン操作のカスタマイズ](../../../docs/framework/windows-workflow-foundation//customizing-the-workflow-design-experience.md)  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] で、カスタム アクティビティを設計するシナリオや [!INCLUDE[wfd1](../../../includes/wfd1-md.md)] のホストを変更するシナリオが大幅に簡略化されたことを示します。新しいアクティビティ デザイナー プログラミング モデルは [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] に基づいて構築されているため、開発も配置も簡単になり、柔軟性も向上しました。  
+  
+## 関連項目  
+  
+## 参照  
+ [Windows Workflow Foundation](../../../docs/framework/windows-workflow-foundation//index.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/feature-specifics.md b/docs/framework/windows-workflow-foundation/feature-specifics.md
new file mode 100644
index 00000000000..955a2aede38
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/feature-specifics.md
@@ -0,0 +1,370 @@
+---
+title: "Windows Workflow Foundation の機能仕様 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e84d12da-a055-45f6-b4d1-878d127b46b6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# Windows Workflow Foundation の機能仕様
+[!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] は、Windows Workflow Foundation にいくつかの機能を追加します。このドキュメントでは、いくつかの新機能について説明し、役に立つ可能性のあるシナリオの詳細を示します。  
+  
+## メッセージング アクティビティ  
+ メッセージング アクティビティ \(<xref:System.ServiceModel.Activities.Receive>、<xref:System.ServiceModel.Activities.SendReply>、<xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.ReceiveReply>\) は、ワークフローから [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージを送信および受信するために使用されます。<xref:System.ServiceModel.Activities.Receive> アクティビティと <xref:System.ServiceModel.Activities.SendReply> アクティビティは、標準 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Web サービスなどの WSDL を介して公開される [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービス操作の形成に使用されます。<xref:System.ServiceModel.Activities.Send> および <xref:System.ServiceModel.Activities.ReceiveReply> は、WCF <xref:System.ServiceModel.ChannelFactory> に似た Web サービスを使用するために使用されます。構成済みアクティビティを生成する Workflow Foundation 用の **\[サービス参照の追加\]** エクスペリエンスも存在します。  
+  
+### メッセージング アクティビティの概要  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、WCF ワークフロー サービス アプリケーション プロジェクトを作成します。<xref:System.ServiceModel.Activities.Receive> と <xref:System.ServiceModel.Activities.SendReply> のペアがキャンバスに配置されます。  
+  
+-   プロジェクトを右クリックし、**\[サービス参照の追加\]** をクリックします。既存の Web サービス WSDL をポイントし、**\[OK\]** をクリックします。\(<xref:System.ServiceModel.Activities.Send> および <xref:System.ServiceModel.Activities.ReceiveReply> を使用して実装された\) 生成されたアクティビティをツールボックスに表示するプロジェクトをビルドします。  
+  
+-   これらのアクティビティのサンプルは次のセクションにあります。  
+  
+    -   基本: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+    -   シナリオ: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+-   [概念説明のドキュメント](http://go.microsoft.com/fwlink/?LinkId=204801)  
+  
+-   [メッセージング アクティビティ デザイナーのドキュメント](http://go.microsoft.com/fwlink/?LinkId=204802)  
+  
+### メッセージング アクティビティのシナリオ例  
+ `BestPriceFinder` サービスは、複数の航空会社サービスを呼び出して、特定の航路の最良チケット価格を探します。このシナリオを実装するには、メッセージ アクティビティを使用して価格要求を受信し、バックエンド サービスから価格を取得し、価格要求に最良価格で応答する必要があります。他の事前定義アクティビティを使用して最良価格を計算するビジネス ロジックを作成する必要もあります。  
+  
+## WorkflowServiceHost  
+ <xref:System.ServiceModel.WorkflowServiceHost> は、複数のインスタンス、構成、および [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージングをサポートする事前定義のワークフロー ホストです \(ただし、ワークフローをホストするためにメッセージングを使用する必要はありません\)。一連のサービスの動作を介して永続性、追跡、およびインスタンス コントロールとも統合されます。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の <xref:System.ServiceModel.ServiceHost> と同様に、<xref:System.ServiceModel.WorkflowServiceHost> は console\/WinForms\/WPF アプリケーションまたは Windows サービスで自己ホスト型にするか、IIS または WAS で \(.xamlx ファイルとして\) Web にホストできます。  
+  
+### ワークフロー サービス ホストの概要  
+  
+-   Visual Studio 2010 で、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービス アプリケーション プロジェクトを作成します。このプロジェクトは、Web ホスト環境で <xref:System.ServiceModel.WorkflowServiceHost> を使用するように設定されます。  
+  
+-   非メッセージング ワークフローをホストするには、メッセージに基づいてインスタンスを作成するカスタム <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を追加します。  
+  
+-   ワークフロー インスタンスが制御できます \(たとえば、中止または終了できます）。<xref:System.ServiceModel.Activities.WorkflowControlEndpoint> を <xref:System.ServiceModel.WorkflowServiceHost> に追加し、<xref:System.ServiceModel.Activities.WorkflowControlClient> を使用することによって、  
+  
+-   <xref:System.ServiceModel.WorkflowServiceHost> のサンプルは次のセクションにあります。  
+  
+    -   [実行](../../../docs/framework/windows-workflow-foundation/samples/execution.md)  
+  
+    -   基本: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+    -   シナリオ: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+    -   アプリケーション: [中断されたインスタンスの管理](../../../docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md)  
+  
+-   [WorkflowServiceHost の概念説明ドキュメント](http://go.microsoft.com/fwlink/?LinkId=204807)  
+  
+### WorkflowServiceHost のシナリオ  
+ BestPriceFinder サービスは、複数の航空会社サービスを呼び出して、特定の航路の最良チケット価格を探します。このシナリオを実装するには、<xref:System.ServiceModel.WorkflowServiceHost> にワークフローをホストする必要があります。メッセージ アクティビティを使用して価格要求を受信し、バックエンド サービスから価格を取得し、価格要求に最良価格で応答する必要もあります。  
+  
+## 相関関係  
+ 相関関係は次の 2 つのいずれかです。  
+  
+-   メッセージをグループ化する方法。つまり、要求メッセージとその応答の関係。  
+  
+-   サービス インスタンスにデータの一部をマッピングする方法。  
+  
+### 概要  
+  
+-   相関を開始するには、Visual Studio で新規プロジェクトを作成します。<xref:System.ServiceModel.Activities.CorrelationHandle> 型の変数を作成します。  
+  
+-   メッセージのグループ化に使用する相関関係の例は、メッセージをグループ化する要求\/応答の相関関係です。  
+  
+    -   <xref:System.ServiceModel.Activities.Receive> アクティビティで、<xref:System.ServiceModel.Activities.Receive.CorrelationInitializers%2A> プロパティをクリックし、前の最初のステップで作成した CorrelationHandle を使用して <xref:System.ServiceModel.Activities.RequestReplyCorrelationInitializer> を追加します。  
+  
+    -   <xref:System.ServiceModel.Activities.Receive> を右クリックし、\[SendReply の作成\] をクリックして <xref:System.ServiceModel.Activities.SendReply> アクティビティを作成します。これをワークフローの <xref:System.ServiceModel.Activities.Receive> アクティビティの後に貼り付けます。  
+  
+-   データの一部をサービス インスタンスにマッピングする例は、データの一部 \(オーダー ID など\) を特定のワークフロー インスタンスにマップするコンテンツ ベースの相関関係です。  
+  
+    -   任意のメッセージング アクティビティで、`CorrelationInitializers` プロパティをクリックし、上記で作成した <xref:System.ServiceModel.Activities.CorrelationHandle> 変数を使用して <xref:System.ServiceModel.Activities.QueryCorrelationInitializer> を追加します。メッセージの目的のプロパティをクリックします \(たとえば、OrderID\) 。ドロップダウン メニューから`CorrelatesWith` プロパティを上記で使用した <xref:System.ServiceModel.Activities.CorrelationHandle> 変数に設定します。  
+  
+-   サンプル:  
+  
+    -   基本: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+    -   シナリオ: [サービス](../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+  
+    -   [相関関係の概念説明ドキュメント](http://go.microsoft.com/fwlink/?LinkId=204939)  
+  
+### 相関関係のシナリオ  
+ 注文処理ワークフローを使用して、新規注文の作成と、処理中の既存の注文の更新を処理します。このシナリオを実装するには、ワークフローを <xref:System.ServiceModel.WorkflowServiceHost> にホストし、メッセージング アクティビティを使用する必要があります。適切なワークフローに更新が行われるようにするために `orderId` に基づく相関関係も必要です。  
+  
+## 簡略化された構成  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 構成スキーマは複雑であり、探すのが難しい多くの機能をユーザーに提供します。[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] では、次の機能で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ユーザーによるサービスの構成を支援することに重点を置いていました。  
+  
+-   サービスごとの明示的な構成の必要性をなくします。サービスに対して \<service\> 要素を構成せず、かつ、サービスがプログラムを使用してエンドポイントを定義しない場合は、一連のエンドポイントが自動的にサービスに追加されます。この場合、サービスのベース アドレスごとに 1 つ、サービスによって実装されるコントラクトごとに 1 つのエンドポイントが追加されます。  
+  
+-   明示的な構成のないサービスに適用される WCF バインディングおよび動作の既定値をユーザーが定義できるようにします。  
+  
+-   標準のエンドポイントは、事前に構成された再利用可能なエンドポイントを定義します。このエンドポイントは、1 つ以上のエンドポイント プロパティ \(アドレス、バインド、およびコントラクト\) に対して固定値を持ち、カスタム プロパティを定義できるようにします。  
+  
+-   最後に、<xref:System.ServiceModel.Configuration.ConfigurationChannelFactory%601> では [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアント構成を集中管理できます。これは、アプリケーション ドメインの読み込み時の後に構成が選択または変更されるシナリオで役立ちます。  
+  
+### 概要  
+  
+-   [WCF 4.0 開発者ガイド](http://go.microsoft.com/fwlink/?LinkId=204940)  
+  
+-   [構成チャネル ファクトリ](http://go.microsoft.com/fwlink/?LinkId=204941)  
+  
+-   [標準エンドポイント要素](http://go.microsoft.com/fwlink/?LinkId=204942)  
+  
+-   [.NET Framework 4 でのサービス構成の向上](http://go.microsoft.com/fwlink/?LinkId=204943)  
+  
+-   [.NET 4 でよくあるユーザーの誤り: WF\/WCF サービス構成名の入力ミス](http://go.microsoft.com/fwlink/?LinkId=204944)  
+  
+### 簡略化された構成のシナリオ  
+  
+-   経験豊富な ASMX 開発者が [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の使用開始を希望しています。ただし、 [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] は複雑すぎるようにみえます\!構成ファイルに書き込む必要のある情報は何ですか。.NET 4 では、構成ファイルをまったく使用しないこともできます。  
+  
+-   既存の WCF サービスのセットは構成とメンテナンスが非常に困難です。構成ファイルには、変更するのが非常に危険な XML コードが何千行もあります。コード量を管理しやすい量に減らすための支援が必要です。  
+  
+## データ コントラクト リゾルバー  
+ .NET 3.5 では、既知の型の設計にはいくつかの制限がありました。  
+  
+-   シリアル化または逆シリアル化中に既知の型を動的に追加することはできませんでした。  
+  
+-   シリアライザーは不明な xsi:type の情報を処理できませんでした。  
+  
+-   ユーザーは、ネットワーク上のシリアル化インスタンスのサイズを小さくするなど、ネットワーク上に出現する xsi:type を指定できませんでした。  
+  
+ [DataContractResolver](../../../docs/framework/wcf/samples/datacontractresolver.md) は、.NET 4.5 でこれらの問題を解決します。  
+  
+### はじめに  
+  
+-   [データ コントラクト リゾルバー API のドキュメント](http://go.microsoft.com/fwlink/?LinkId=204946)  
+  
+-   [データ コントラクト リゾルバーの概要](http://go.microsoft.com/fwlink/?LinkId=204947)  
+  
+-   サンプル:  
+  
+    -   [DataContractResolver](../../../docs/framework/wcf/samples/datacontractresolver.md)  
+  
+    -   [KnownAssemblyAttribute](../../../docs/framework/wcf/samples/knownassemblyattribute.md)  
+  
+### データ コントラクト リゾルバーのシナリオ  
+  
+-   数十の <xref:System.Runtime.Serialization.KnownTypeAttribute> オブジェクトをサービスで宣言する必要性の回避。  
+  
+-   XML BLOB のサイズの削減。  
+  
+## フローチャート  
+ フローチャートは、ドメインの問題を視覚的に表すための既知のパラダイムです。これは .NET の 4 で導入される新しい制御フロー スタイルです。フローチャートの主な特性は、一度に 1 つのアクティビティのみ実行されることです。フローチャートはループと代替結果を表すことができますが、その性質上、複数ノードの同時実行を表すことはできません。  
+  
+### 概要  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、ワークフロー コンソール アプリケーションを作成します。ワークフロー デザイナーにフローチャートを追加します。  
+  
+-   フローチャート機能では、次のクラスを使用します。  
+  
+    -   <xref:System.Activities.Statements.Flowchart>  
+  
+    -   <xref:System.Activities.Statements.FlowNode>  
+  
+    -   <xref:System.Activities.Statements.FlowDecision>  
+  
+    -   <xref:System.Activities.Statements.FlowStep>  
+  
+    -   <xref:System.Activities.Statements.FlowSwitch%601>  
+  
+-   サンプル:  
+  
+    -   [TryCatch を使用した Flowchart アクティビティでのエラー処理](../../../docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md)  
+  
+    -   [FlowChart と Pick の組み合わせを使用する StateMachine シナリオ](../../../docs/framework/windows-workflow-foundation/samples/statemachine-scenario-using-a-combination-of-flowchart-and-pick.md)  
+  
+    -   [雇用プロセス](../../../docs/framework/windows-workflow-foundation/samples/hiring-process.md)  
+  
+-   デザイナー ドキュメント:  
+  
+    -   [フローチャート アクティビティ デザイナー](../Topic/Flowchart%20Activity%20Designers.md)  
+  
+### フローチャートのシナリオ  
+ フローチャート アクティビティを使用して推測ゲームを実装できます。推測ゲームは非常に単純です。コンピューターによってランダムな数値が選択され、プレーヤーはその数値を推測する必要があります。プレーヤーが推測を送信すると、コンピューターにヒント \("もっと小さい数字を試してください"\) が表示されます。"もっと小さい数字を試してください"\)プレーヤーが 6 回以下で数値を見つけた場合は、特別な祝福のメッセージが表示されます。このゲームは、次の手続き型アクティビティの組み合わせで実装できます。  
+  
+-   <xref:System.Activities.Statements.Sequence>  
+  
+-   <xref:System.Activities.Statements.While>  
+  
+-   <xref:System.Activities.Statements.Switch%601>  
+  
+-   <xref:System.Activities.Statements.TryCatch>  
+  
+-   <xref:System.Activities.Statements.Assign%601>  
+  
+-   <xref:System.Activities.Statements.If>  
+  
+## 手続き型アクティビティ \(Sequence、If、ForEach、Switch、Assign、DoWhile、While\)  
+ 手続き型アクティビティは、プログラマになじみのある概念を使用してシーケンシャル制御フローをモデル化するメカニズムを提供します。これらのアクティビティにより、従来の構造型プログラミング言語構成要素が有効になり、該当する場合には C\#\/VB などの一般的な手続き型言語と同等の言語が提供されます。  
+  
+### 概要  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、ワークフロー コンソール アプリケーションを作成します。ワークフロー デザイナーで、手続き型アクティビティを追加します。  
+  
+-   サンプル:  
+  
+    -   [雇用プロセス](../../../docs/framework/windows-workflow-foundation/samples/hiring-process.md)  
+  
+    -   [企業の購買プロセス](../../../docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md)  
+  
+-   デザイナー ドキュメント:  
+  
+    -   [Parallel アクティビティ デザイナー](../Topic/Parallel%20Activity%20Designer.md)  
+  
+    -   [ParallelForEach\<T\> アクティビティ デザイナー](../Topic/ParallelForEach%3CT%3E%20Activity%20Designer.md)  
+  
+### 手続き型アクティビティのシナリオ  
+  
+-   <xref:System.Activities.Statements.Parallel>並列: イントラネット ドキュメント管理システムにドキュメント承認ワークフローがあります。ドキュメントは、イントラネットに公開する前に、複数の部門の担当者によって承認する必要があります。設定されている承認順序はありません。ドキュメントが "承認保留" フェーズにあるときにいつでも承認できます。ユーザーがレビューのためにドキュメントを送信した場合は、直属のマネージャー、イントラネット管理者、および内部コミュニケーション マネージャーがそのドキュメントを承認する必要があります。  
+  
+-   <xref:System.Activities.Statements.ParallelForEach%601>: WF アプリケーションは、大規模企業内での企業購買を管理します。企業の規則では、購買作業を計画する前に 3 社の異なるベンダーを評価する必要があると規定されています。購買部門の従業員は、企業のベンダー リストから 3 社のベンダーを選択します。これらのベンダーを選択し、通知した後で、企業は経済提案書を待ちます。提案書は任意の順序で到着します。WF でこのシナリオを実装するには、ベンダーのコレクションを反復処理して経済提案書を求める <xref:System.Activities.Statements.ParallelForEach%601> を使用します。すべての提案が収集された後で、最良の提案が選択されて表示されます。  
+  
+## InvokeMethod  
+ <xref:System.Activities.Statements.InvokeMethod> アクティビティでは、オブジェクト内のパブリック メソッドまたはスコープ内の型を呼び出すことができます。パラメーター付きまたはパラメーターなし \(パラメーター配列を含む\) でのインスタンス メソッドおよび静的メソッドの呼び出し、および汎用メソッドの呼び出しがサポートされます。メソッドを同期および非同期で実行することもできます。  
+  
+### 概要  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、ワークフロー コンソール アプリケーションを作成します。ワークフロー デザイナーに <xref:System.Activities.Statements.InvokeMethod> アクティビティを追加し、そこに静的メソッドとインスタンス メソッドを構成します。  
+  
+-   サンプル:  
+  
+    -   [InvokeMethod](../../../docs/framework/windows-workflow-foundation/samples/invokemethod.md)  
+  
+-   デザイナー ドキュメント: [InvokeMethod アクティビティ デザイナー](../Topic/InvokeMethod%20Activity%20Designer.md)  
+  
+### InvokeMethod のシナリオ  
+  
+-   スコープ内のオブジェクトのメソッドを呼び出す必要があります。たとえば、辞書に値を追加する必要があります。辞書のインスタンスの Add メソッドが呼び出され、キーと値が指定されます。  
+  
+-   レガシー CLR オブジェクトに対してメソッドを呼び出す必要があります。カスタム アクティビティを作成してそのレガシー クラスの呼び出しをラップする代わりに、ワークフロー実行中にそのクラスがスコープ内にある場合には <xref:System.Activities.Statements.InvokeMethod> を使用できます。  
+  
+## エラー処理アクティビティ  
+ <xref:System.Activities.Statements.TryCatch> アクティビティには、含まれるアクティビティのセットの実行中に発生する例外をキャッチするメカニズムが用意されています \(C\#\/VB の Try\/Catch construct に類似\)。<xref:System.Activities.Statements.TryCatch> はワークフロー レベルの例外処理を提供します。ハンドルされていない例外がスローされると、ワークフローが中止され、Finally ブロックは実行されません。この動作は C\# と一貫性があります。  
+  
+### はじめに  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、ワークフロー コンソール アプリケーションを作成します。ワークフロー デザイナーで <xref:System.Activities.Statements.TryCatch> アクティビティを追加します。  
+  
+-   サンプル:  
+  
+    1.  [TryCatch を使用した Flowchart アクティビティでのエラー処理](../../../docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md)  
+  
+    2.  [手続き型アクティビティの使用](../../../docs/framework/windows-workflow-foundation/samples/using-procedural-activities.md)  
+  
+-   デザイナー ドキュメント: [エラー処理アクティビティ デザイナー](../Topic/Error%20Handling%20Activity%20Designers.md)  
+  
+### エラー処理のシナリオ  
+ アクティビティのセットを実行する必要があり、エラーの発生時に特定のロジックを実行する必要があります。そのエラー処理ロジック中にエラーが回復不能であることがわかった場合は、例外が再スローされ、親アクティビティ \(またはホスト\) によって問題が処理されます。  
+  
+## Pick アクティビティ  
+ <xref:System.Activities.Statements.Pick> アクティビティは、WF で、イベント ベースの制御フロー モデリングを提供します。<xref:System.Activities.Statements.Pick> には、多数の分岐が含まれています。各分岐は、特定のイベントが発生すると実行されます。この設定では、<xref:System.Activities.Statements.Pick> は、アクティビティがリッスンしているイベント セットの 1 つのみを実行する <xref:System.Activities.Statements.Switch%601> と同様に動作します。各分岐はイベント ドリブンなので、発生したイベントが対応する分岐を実行します。他のすべての分岐は、イベントのリッスンをキャンセルし、停止します。  
+  
+### 概要  
+  
+-   [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、ワークフロー コンソール アプリケーションを作成します。ワークフロー デザイナーで <xref:System.Activities.Statements.Pick> アクティビティを追加します。  
+  
+-   サンプル: [Pick アクティビティの使用](../../../docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md)  
+  
+-   デザイナー ドキュメント: [Pick アクティビティ デザイナー](../Topic/Pick%20Activity%20Designer.md)  
+  
+### Pick のシナリオ  
+ ユーザーに入力を求めるプロンプトを表示する必要があります。通常の状況下では、開発者は <xref:System.Console.ReadLine%2A> のようなメソッド呼び出しを使用してユーザーの入力を求めます。この設定の問題は、ユーザーが何か入力するまでプログラムが待機することです。このシナリオでは、ブロッキング アクティビティのブロックを解除するためにタイムアウトが必要です。一般的なシナリオでは、特定の期間内にタスクが完了する必要があります。ブロッキング アクティビティのタイムアウトは、Pick が大量の値を追加するシナリオです。  
+  
+## WCF ルーティング サービス  
+ ルーティング サービスは、クライアントとサービス間で [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージがどのように流れるかを制御できる汎用ソフトウェア ルーターとなるように設計されています。ルーティング サービスにより、クライアントをサービスから切り離し、サポートできる構成の自由度と、サービスをホストする方法を検討するときの柔軟性を高めることができます。.NET 3.5 では、クライアントとサービスが密接に結び付いていました。クライアントは、対話する必要のあるすべてのサービスについて、およびサービスが置かれている場所を知っている必要がありました。また、.Net Framework 3.5 の WCF には次の制限がありました。  
+  
+-   ロジックをクライアントにハードコーディングする必要があったため、エラー処理が複雑でした。  
+  
+-   クライアントとサービスは常に同じバインディングを使用する必要がありました。  
+  
+-   サービスが適切に分類されていることはほとんどありませんでした。複数のサービス間で選択するよりも、クライアントがすべてを実装する 1 つのサービスと対話する方が簡単です。  
+  
+ .Net 4 のルーティング サービスは、これらの問題を簡単に解決できるように設計されています。新しいルーティング サービスには次の機能があります。  
+  
+1.  コンテント ベースのルーティング \(<xref:System.ServiceModel.Dispatcher.MessageFilter> オブジェクトがメッセージを調べて送信先を判断します。\)  
+  
+2.  プロトコル バインディング \(トランスポートとメッセージ\)  
+  
+3.  エラー処理 \(ルーターは、通信例外をキャッチし、バックアップ エンドポイントにフェールオーバーします\)  
+  
+4.  <xref:System.ServiceModel.Dispatcher.MessageFilterTable%601> およびルーティング構成の動的 \(メモリ内\) 更新。  
+  
+### 概要  
+  
+1.  ドキュメント: [ルーティング](../../../docs/framework/wcf/feature-details/routing.md)  
+  
+2.  サンプル: [ルーティング サービス &#91;WCF サンプル&#93;](../../../docs/framework/wcf/samples/routing-services.md)  
+  
+3.  ブログ: [ルーティング規則](http://go.microsoft.com/fwlink/?LinkId=204956)  
+  
+### ルーティング シナリオ  
+ ルーティング サービスは、次のシナリオに役立ちます。  
+  
+-   クライアントは、複数のサービスを直接アドレス指定することなく、これらのサービスと対話できます。  
+  
+-   クライアントは、ルーティング先を判断するためにクライアント要求で追加のロジックを実行できます。  
+  
+-   クライアントをリファクタリングすることなく、クライアントが実行する操作を複数のサービス実装に分解します。  
+  
+-   クライアントとサービスは、異なるセキュリティ設定の異なるバインディングで会話できます。  
+  
+-   クライアントは、障害またはサービスの使用不能に対してより堅牢になることができます。  
+  
+## WCF Discovery  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] Discovery は、アプリケーション インフラストラクチャに探索メカニズムを組み込むことのできるフレームワーク テクノロジです。これを使用して、サービスを探索可能にし、サービスを検索するようにクライアントを構成できます。クライアントはエンドポイントでハードコーディングする必要がなくなるため、アプリケーションはより堅牢になりフォールト トレランスが向上します。探索は、アプリケーションに自動構成機能をビルドするための最適なプラットフォームです。  
+  
+ 製品は、WS\-Discovery 標準の上に構築されます。相互運用可能、拡張可能、および汎用的になるように設計されています。製品では 2 つの操作モードがサポートされます。  
+  
+1.  マネージド: 既存のサービスに関する知識を持つエンティティがネットワーク上にあり、クライアントは情報を直接クエリします。これは Active Directory に類似しています。  
+  
+2.  アドホック: クライアントはマルチキャスト メッセージを使用してサービスを特定します。  
+  
+ さらに、探索メッセージはネットワーク プロトコルに依存しません。モード要件をサポートする任意のプロトコル上でこれらを使用できます。たとえば、探索マルチキャスト メッセージを UDP チャネル上またはマルチキャスト メッセージングをサポートする他の任意のネットワーク上に送信できます。これらの設計ポイントが機能の柔軟性と結合されて、探索をソリューションに適応させることができます。  
+  
+### 概要  
+  
+-   ドキュメント: [WCF Discovery](../../../docs/framework/wcf/feature-details/wcf-discovery.md)  
+  
+-   サンプル: [探索 \(サンプル\)](../../../docs/framework/wcf/samples/discovery-samples.md)  
+  
+### 探索のシナリオ  
+ サービスがいつ使用可能になるかが不明なため、開発者はエンドポイントのハードコーディングを望みません。代わりに、開発者は実行時にサービスを選択することを望んでいます。アプリケーションのコンポーネント間に、切り離し、堅牢性、および自動構成がさらに必要です。  
+  
+## 追跡  
+ ワークフロー追跡では、ワークフロー インスタンスの実行を把握できます。追跡イベントは、ワークフロー インスタンス レベルで、またワークフロー内のアクティビティの実行時にワークフローから出力されます。追跡レコードを定期受信するにはワークフロー追跡参加要素をワークフロー ホストに追加する必要があります。追跡レコードは、追跡プロファイルを使用してフィルター処理されます。.Net Framework には ETW \(Event Tracing for Windows\) 追跡参加要素が用意されており、基本プロファイルが machine.config ファイルにインストールされます。  
+  
+### 概要  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] で、WCF ワークフロー サービス アプリケーション プロジェクトを作成します。開始するキャンバスに <xref:System.ServiceModel.Activities.Receive> と <xref:System.ServiceModel.Activities.SendReply> のペアが配置されます。  
+  
+2.  web.config を開き、プロファイルなしで ETW 追跡動作を追加します。  
+  
+    1.  既定のプロファイルが使用されます。  
+  
+    2.  イベント ビューアーを開き、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]**、**\[アプリケーション サーバー \- アプリケーション\]** のノードで分析チャネルを有効にします。**\[分析\]** を右クリックし、**\[ログを有効にする\]** を選択します。  
+  
+    3.  ワークフロー サービスを実行します。  
+  
+    4.  イベント ビューアーでワークフロー追跡イベントを確認します。  
+  
+3.  サンプル: [追跡](../../../docs/framework/windows-workflow-foundation/samples/tracking.md)  
+  
+4.  概念説明のドキュメント: [ワークフロー追跡とトレース](../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)  
+  
+## SQL Workflow Instance Store  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> は、SQL Server ベースのインスタンス ストアの実装です。インスタンス ストアは、実行中のインスタンスの状態を、そのインスタンスの読み込みと再開に必要なすべてのデータと共に格納します。サービス ホストは、ワークフローが永続的な場合にインスタンス状態を保存するようインスタンス ストアに指示し、そのインスタンスのメッセージが到着するか遅延アクティビティが期限切れになったときにインスタンス状態を読み込むようインスタンス ストアに指示します。  
+  
+### 概要  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で、暗黙的または明示的な <xref:System.Activities.Statements.Persist> アクティビティを含むワークフローを作成します。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 動作をワークフロー サービス ホストに追加します。これはコードまたはアプリケーション構成ファイルで行うことができます。  
+  
+2.  サンプル: [永続性](../../../docs/framework/windows-workflow-foundation/samples/persistence.md)  
+  
+3.  概念説明のドキュメント: [SQL Workflow Instance Store](../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/flowchart-activities-in-wf.md b/docs/framework/windows-workflow-foundation/flowchart-activities-in-wf.md
new file mode 100644
index 00000000000..4e3b0c75309
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/flowchart-activities-in-wf.md
@@ -0,0 +1,27 @@
+---
+title: "WF のフローチャート アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e80d9734-b43a-4d21-a250-74400330a4c0
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# WF のフローチャート アクティビティ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、フローチャート内の実行と分岐を制御する、システムによって提供されるアクティビティがいくつか用意されています。  
+  
+|||  
+|-|-|  
+|<xref:System.Activities.Statements.Flowchart>|使い慣れたフローチャート パラダイムを使用して、含まれるアクティビティを実行します。|  
+|<xref:System.Activities.Statements.FlowDecision>|2 つの結果を持つ条件ノードをモデル化する機能を提供する特殊な <xref:System.Activities.Statements.FlowNode>。|  
+|<xref:System.Activities.Statements.FlowSwitch%601>|アクティビティの型指定子に定義された型の 1 つの式、および各一致につき 1 つの結果を使用してスイッチ構造のモデリングができる、特殊な <xref:System.Activities.Statements.FlowNode>。|  
+  
+## 参照  
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/flowchart-workflows.md b/docs/framework/windows-workflow-foundation/flowchart-workflows.md
new file mode 100644
index 00000000000..8f0e68ed6e5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/flowchart-workflows.md
@@ -0,0 +1,103 @@
+---
+title: "Flowchart のワークフロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b0a3475c-d22f-49eb-8912-973c960aebf5
+caps.latest.revision: 22
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 22
+---
+# Flowchart のワークフロー
+フローチャートは、プログラムを診断するための既知のパラダイムです。通常、Flowchart アクティビティはシーケンシャル以外のワークフローを実装するために使用されますが、`FlowDecision` ノードが使用されない場合は、シーケンシャル ワークフローにも使用できます。  
+  
+## Flowchart のワークフロー構造  
+ Flowchart アクティビティは、実行されるアクティビティのコレクションを含むアクティビティです。フローチャートには、変数の値に基づいて含まれているアクティビティ間の実行を指示する、<xref:System.Activities.Statements.FlowDecision> および <xref:System.Activities.Statements.FlowSwitch> などのフロー制御要素も含まれています。  
+  
+## フロー ノードの種類  
+ 要素の実行時に必要なフロー制御の種類に応じて、さまざまな種類の要素が使用されます。フローチャート要素には次のような種類があります。  
+  
+-   `FlowStep` \- フローチャートの実行の 1 ステップをモデル化します。  
+  
+-   `FlowDecision` \- <xref:System.Activities.Statements.If> と同様に、ブール条件に基づいて実行を分岐します。  
+  
+-   `FlowSwitch` \- <xref:System.Activities.Statements.Switch%601> と同様に、排他的スイッチに基づいて実行を分岐します。  
+  
+ 各リンクには、子アクティビティの実行に使用できる <xref:System.Activities.ActivityAction> を定義した `Action` プロパティと、現在の要素の実行が完了したときに実行する 1 つ以上の要素を定義した 1 つ以上の `Next` プロパティがあります。  
+  
+### FlowStep ノードによる基本的な Activity Sequence の作成  
+ 2 つのアクティビティを連続して実行する基本的なシーケンスをモデル化するには、`FlowStep` 要素を使用します。次の例では、2 つの `FlowStep` 要素を使用して 2 つのアクティビティを連続して実行しています。  
+  
+```  
+<Flowchart>  
+  <FlowStep>      
+  <Assign DisplayName="Get Name">  
+    <Assign.To>  
+      <OutArgument x:TypeArguments="x:String">[result]</OutArgument>  
+    </Assign.To>  
+    <Assign.Value>  
+      <InArgument x:TypeArguments="x:String">["User"]</InArgument>  
+    </Assign.Value>  
+  </Assign>  
+    <FlowStep.Next>  
+      <FlowStep>  
+        <WriteLine Text="["Hello, " & result]"/>  
+</FlowStep>  
+    </FlowStep.Next>  
+  </FlowStep>  
+</Flowchart>  
+  
+```  
+  
+### FlowDecision ノードによる条件付きフローの作成  
+ フローチャート ワークフローの条件付きフロー ノードをモデル化するには \(つまり、従来のフローチャートの決定シンボルとして機能するリンクを作成するには\)、<xref:System.Activities.Statements.FlowDecision> ノードを使用します。ノードの <xref:System.Activities.Statements.FlowDecision.Condition%2A> プロパティは、条件を定義する式に設定されます。<xref:System.Activities.Statements.FlowDecision.True%2A> および <xref:System.Activities.Statements.FlowDecision.False%2A> プロパティは、式が `true` または `false`に評価された場合に実行される <xref:System.Activities.Statements.FlowNode> インスタンスに設定されます。次の例では、<xref:System.Activities.Statements.FlowDecision> ノードを使用するワークフローを定義する方法を示します。  
+  
+```  
+<Flowchart>  
+  <FlowStep>  
+    <Read Result="[s]"/>  
+    <FlowStep.Next>  
+      <FlowDecision>  
+        <IsEmpty Input="[s]" />  
+        <FlowDecision.True>  
+    <FlowStep>  
+            <Write Text="Empty"/>  
+    </FlowStep>  
+        </FlowDecision.True>  
+        <FlowDecision.False>  
+    <FlowStep>  
+            <Write Text="Non-Empty"/>  
+          </FlowStep>  
+        </FlowDecision.False>  
+      </FlowDecision>  
+    </FlowStep.Next>  
+  </FlowStep>  
+</Flowchart>  
+  
+```  
+  
+### FlowSwitch ノードによる排他的スイッチの作成  
+ 一致する値に基づいて 1 つの排他的パスを選択するフローチャートをモデル化するには、<xref:System.Activities.Statements.FlowSwitch%601> ノードを使用します。<xref:System.Activities.Statements.FlowSwitch%601.Expression%2A> プロパティは、選択に対して一致する値を定義する <xref:System.Object> の型パラメーターを持つ <xref:System.Activities.Activity%601> に設定されます。<xref:System.Activities.Statements.FlowSwitch%601.Cases%2A> プロパティは、条件式に対して一致する、キーと <xref:System.Activities.Statements.FlowNode> オブジェクトのディクショナリと、特定のケースが条件式に一致する場合のフローの実行方法を定義する <xref:System.Activities.Statements.FlowNode> オブジェクトのセットを定義します。また、<xref:System.Activities.Statements.FlowSwitch%601> は、条件式に一致するケースがない場合の実行フローを定義する <xref:System.Activities.Statements.FlowSwitch%601.Default%2A> プロパティも定義します。次のコードは、<xref:System.Activities.Statements.FlowSwitch%601> 要素を使用するワークフローを定義する方法の例です。  
+  
+```  
+<Flowchart>  
+    <FlowSwitch>  
+      <FlowStep x:Key="Red">  
+        <WriteRed/>  
+      </FlowStep>  
+      <FlowStep x:Key="Blue">  
+        <WriteBlue/>  
+      </FlowStep>  
+      <FlowStep x:Key="Green">  
+        <WriteGreen/>  
+      </FlowStep>  
+    </FlowSwitch>  
+</Flowchart>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/fundamental-concepts.md b/docs/framework/windows-workflow-foundation/fundamental-concepts.md
new file mode 100644
index 00000000000..c5d0be3d983
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/fundamental-concepts.md
@@ -0,0 +1,71 @@
+---
+title: "Windows Workflow の基本概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0e930e80-5060-45d2-8a7a-95c0690105d4
+caps.latest.revision: 27
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 27
+---
+# Windows Workflow の基本概念
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] のワークフロー開発で使用される概念は、一部の開発者にとっては不慣れなものかもしれません。ここでは、そのいくつかの概念について、内容と実装方法を説明します。  
+  
+## ワークフローとアクティビティ  
+ ワークフローは、プロセスをモデル化するアクションの構造化されたコレクションです。ワークフローの各アクションは、アクティビティとしてモデル化されます。ホストがワークフローとのやり取りを行う場合、メソッドと同じようにワークフローを呼び出すときは <xref:System.Activities.WorkflowInvoker> が使用され、1 つのワークフロー インスタンスの実行を明示的に制御するときは <xref:System.Activities.WorkflowApplication> が使用されるほか、インスタンスが複数のシナリオでメッセージ ベースのやり取りを行うときは <xref:System.ServiceModel.WorkflowServiceHost> が使用されます。ワークフローの手順はアクティビティの階層として定義されるため、階層の最上位のアクティビティはワークフローそのものを定義すると言えます。この階層モデルは、前のバージョンの明示的な `SequentialWorkflow` クラスおよび `StateMachineWorkflow` クラスの代わりになります。アクティビティ自体は、他のアクティビティの集まりとして開発されたり \(ベースとして <xref:System.Activities.Activity> クラスを使用。通常は XAML を使用して定義されます\)、データ アクセスにランタイムを使用できる <xref:System.Activities.CodeActivity> クラスや、ワークフロー ランタイムの範囲をアクティビティの作成者に提示する <xref:System.Activities.NativeActivity> クラスを使用して作成されるカスタムとして開発されたりします。<xref:System.Activities.CodeActivity> および <xref:System.Activities.NativeActivity> を使用して開発されるアクティビティは、C\# などの CLR 準拠の言語を使用して作成されます。  
+  
+## アクティビティ データ モデル  
+ アクティビティは、次の表に示すタイプを使用してデータを格納および共有します。  
+  
+|||  
+|-|-|  
+|変数|データをアクティビティに格納します。|  
+|引数|データをアクティビティに移動したり、アクティビティから移動したりします。|  
+|式|引数のバインディングで使用される、昇格された戻り値を持つアクティビティです。|  
+  
+## ワークフロー ランタイム  
+ ワーク フロー ランタイムはワーク フローが実行される環境です。<xref:System.Activities.WorkflowInvoker> はワークフローを実行する最も単純な方法です。ホストは、次の処理に <xref:System.Activities.WorkflowInvoker> を使用します。  
+  
+-   ワークフローの同期呼び出しを実行する。  
+  
+-   ワークフローに入力を行ったり、ワークフローから出力を取り出したりする。  
+  
+-   アクティビティによって使用される拡張機能を追加する。  
+  
+ <xref:System.Activities.ActivityInstance> は、ホストがランタイムとのやり取りに使用できるスレッドセーフなプロキシです。ホストは、次の処理に <xref:System.Activities.ActivityInstance> を使用します。  
+  
+-   インスタンスを作成するか、インスタンス ストアから読み込んで、インスタンスを取得する。  
+  
+-   インスタンスのライフサイクル イベントが通知されるようにする。  
+  
+-   ワークフローの実行を制御する。  
+  
+-   ワークフローに入力を行ったり、ワークフローから出力を取り出したりする。  
+  
+-   ワークフローの継続を通知し、値をワークフローに渡す。  
+  
+-   ワークフローのデータを永続化する。  
+  
+-   アクティビティによって使用される拡張機能を追加する。  
+  
+ アクティビティは、<xref:System.Activities.NativeActivityContext> または <xref:System.Activities.CodeActivityContext> などの、適切な <xref:System.Activities.ActivityContext> 派生クラスを使用してワーク フローのランタイム環境にアクセスできます。これらの要素がこのクラスを使用する目的は、引数や変数の解決や子アクティビティのスケジュール設定など、多岐にわたります。  
+  
+## サービス  
+ ワークフローは、メッセージング アクティビティを使用して疎結合サービスの実装およびアクセスを行う、無理のない方法です。メッセージング アクティビティは [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] 上にビルドされる、ワーク フローとのデータの受け渡しに使用される主要な方法です。任意の種類のメッセージ交換パターンをモデル化するため、複数のメッセージング アクティビティを共に作成できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] は [メッセージング アクティビティ](../../../docs/framework/wcf/feature-details/messaging-activities.md) を参照します。ワークフロー サービスは <xref:System.ServiceModel.Activities.WorkflowServiceHost> クラスを使用してホストされます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ワークフロー サービスのホストの概要](../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md).[!INCLUDE[crabout](../../../includes/crabout-md.md)] ワークフロー サービスは以下を参照します。[ワークフロー サービス](../../../docs/framework/wcf/feature-details/workflow-services.md)  
+  
+## 永続性、アンロード、実行時間の長いワークフロー  
+ Windows Workflow は次の機能により、実行時間の長いリアクティブなプログラムの作成を簡素化しています。  
+  
+-   外部入力にアクセスするアクティビティ  
+  
+-   ホストのリスナーが再開できる <xref:System.Activities.Bookmark> オブジェクトを作成する機能  
+  
+-   ワークフローのデータを永続化してワークフローをアンロードした後、特定のワークフローでの <xref:System.Activities.Bookmark> オブジェクトの再開に反応してワークフローを再読み込みおよび再アクティブ化する機能。  
+  
+ ワークフローは、実行するアクティビティがなくなるか、現在の実行中のすべてのアクティビティが入力を待機するまで、アクティビティを継続して実行します。後者の場合、ワークフローはアイドル状態になります。ホストでは、アイドル状態になったワークフローをアンロードし、メッセージが到着したときに実行を継続するためのワークフローを再読み込みすることは一般的です。<xref:System.ServiceModel.Activities.WorkflowServiceHost> によって、この機能が実現されるほか、拡張可能なアンロード ポリシーを使用できます。揮発性状態のデータまたは永続化できない他のデータを使用する実行ブロックの場合、アクティビティは <xref:System.Activities.NoPersistHandle> を使用して永続化すべきではないホストを指定できます。また、ワークフローは <xref:System.Activities.Statements.Persist> アクティビティを使用して、そのデータを永続ストレージ メディアに明示的に永続化することもできます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/getting-started-tutorial.md b/docs/framework/windows-workflow-foundation/getting-started-tutorial.md
new file mode 100644
index 00000000000..8b9b6419265
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/getting-started-tutorial.md
@@ -0,0 +1,46 @@
+---
+title: "チュートリアル入門 [.NET Framework 4.5] | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF], はじめに"
+  - "Windows Workflow Foundation [WF], 概要"
+ms.assetid: c2d3585f-6b1a-4d4f-9865-bd7cd31c5d42
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# チュートリアル入門 [.NET Framework 4.5]
+このセクションには、[!INCLUDE[wf](../../../includes/wf-md.md)] アプリケーションのプログラミングの概要を説明する一連のチュートリアル トピックが掲載されています。これらのトピックの手順に従って、数値推測ゲーム アプリケーションを構築します。チュートリアルの最初のトピックでは、ワークフローに必要なカスタム アクティビティを作成する手順について説明します。2 番目のトピックでは、カスタム アクティビティをビルトイン ワークフロー アクティビティと共にフローチャート ワークフローにアセンブルします。3 番目のトピックでは、ホスト アプリケーションを構成してワークフローを実行します。最後のトピックでは永続化の概要について説明します。このプロセスの各手順はその前の手順に基づいているため、順番に完了することをお勧めします。  
+  
+## このセクションの内容  
+ [アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)  
+ <xref:System.Activities.NativeActivity%601> から派生するカスタム アクティビティを作成する方法、およびアクティビティ デザイナーを使用してカスタム アクティビティをビルトイン アクティビティと共に複合アクティビティへと構成する方法について説明します。  
+  
+ [ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)  
+ ビルトイン アクティビティと前のチュートリアルのカスタム アクティビティを使用して、フローチャート、シーケンシャル、およびステート マシンのワークフローを作成する方法について説明します。  
+  
+ [ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)  
+ ホスト環境からワークフローを呼び出す方法、データをワークフローとの間でやり取りする方法、およびブックマークを再開する方法について説明します。  
+  
+ [長時間にわたって実行されるワークフローを作成して実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md)  
+ 永続性をワークフロー アプリケーションに追加する方法について説明します。  
+  
+ [カスタム追跡参加要素を作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md)  
+ カスタムの追跡参加要素と追跡プロファイルを作成する方法について説明します。  
+  
+ [ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)  
+ `WorkflowIdentity` を使用して、ワークフローの複数バージョンを同時にホストする方法について説明します。  
+  
+ [実行中のワークフロー インスタンスの定義を更新する方法](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md)  
+ 動的更新を使用して、実行中のワークフロー インスタンスを変更する方法について説明します。  
+  
+## 参照  
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/glossary.md b/docs/framework/windows-workflow-foundation/glossary.md
new file mode 100644
index 00000000000..c5a36f633dd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/glossary.md
@@ -0,0 +1,42 @@
+---
+title: ".NET Framework 4.5 の Windows Workflow Foundation 用語集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF], 用語集"
+  - "Windows Workflow Foundation [WF], 用語集"
+ms.assetid: ab682b2f-3779-45ca-b831-b7c03d7dbb3a
+caps.latest.revision: 259
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 259
+---
+# .NET Framework 4.5 の Windows Workflow Foundation 用語集
+Windows Workflow Foundation のドキュメントで使用される用語については、次の表を参照してください。  
+  
+## 用語  
+  
+|用語|定義|  
+|--------|--------|  
+|アクティビティ|Windows Workflow Foundation のプログラム動作の単位です。それぞれのアクティビティをまとめて、より複雑なアクティビティを構成できます。|  
+|アクティビティ操作|ワークフローおよびアクティビティの実行のコールバックを公開するために使用されるデータ構造です。|  
+|引数|アクティビティに出入りするデータ フローを定義します。各引数には in、out、または in\/out などの方向が指定されます。これらの値は、アクティビティの入力パラメーター、出力パラメーター、および入力\/出力パラメーターを表します。|  
+|ブックマーク|アクティビティの一時停止と再開まで待機することを可能にするポイントです。|  
+|補正|前に完了した作業の効果を取り消したり補正したりするように設計されたアクションのグループです。|  
+|相関|ワークフローまたはサービス インスタンスにメッセージをルーティングするためのメカニズムです。|  
+|式|1 つまたは複数の引数を取得し、その引数の操作を実行し、単一の値を返すコンストラクターです。式は、アクティビティが使用可能であれば、どこでも使用できます。|  
+|フローチャート|方向矢印と一緒にリンクされた記号でプログラム コンポーネントを表す既知のモデリング パラダイムです。.NET Framework 4 では、Flowchart アクティビティを使用してワークフローをフローチャートとしてモデル化できます。|  
+|長時間のプロセス|すぐに制御が返されず、システムの再起動をまたぐ場合もあるプログラム実行の単位です。|  
+|永続化|メモリからアンロードしたり、システム障害から回復できるように、永続メディアにワークフローまたはサービスの状態を保存することです。|  
+|ステート マシン|イベント ドリブン状態遷移と一緒にリンクされた個々の状態でプログラム コンポーネントを表す既知のモデリング パラダイムです。ワークフローは、StateMachine アクティビティを使用して、ステート マシンとしてモデル化できます。|  
+|サブスタンス|共通の識別子の下の関連ブックマークのグループを表し、特定のブックマーク再開が有効か、有効になる可能性があるかどうかがランタイムによって決定します。|  
+|型コンバーター|CLR 型は、CLR 型のインスタンスと他の型のインスタンスを変換する 1 つまたは複数の System.ComponentModel.TypeConverter 派生型に関連付けることができます。型コンバーターは、System.ComponentModel.TypeConverterAttribute 属性を使用して、CLR 型に関連付けられています。TypeConverterAttribute は、CLR 型またはプロパティで直接指定できます。プロパティで指定された型コンバーターは、プロパティの CLR 型で指定された型コンバーターよりも常に優先されます。|  
+|変数|保存して後からアクセスする必要がある一部のデータのストレージを表します。|  
+|ワークフロー|ホスト プロセスにより呼び出される単一のアクティビティまたはアクティビティのツリーです。|  
+|XAML|eXtensible Application Markup Language|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/guide-to-the-documentation.md b/docs/framework/windows-workflow-foundation/guide-to-the-documentation.md
new file mode 100644
index 00000000000..f6370e7e7ea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/guide-to-the-documentation.md
@@ -0,0 +1,43 @@
+---
+title: "Windows Workflow ドキュメントのガイド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF], ガイド"
+  - "Windows Workflow Foundation [WF], ガイド"
+ms.assetid: a75025be-f225-430f-90cf-98f7022db436
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# Windows Workflow ドキュメントのガイド
+ここでは、Windows Workflow Foundation ドキュメントを使用する方法について説明します。リンク先のドキュメントは、特定の目的と専門知識のレベルに応じて分類された、推奨される出発点となります。  
+  
+## Windows Workflow Foundation プログラミング入門  
+  
+-   Windows Workflow Foundation を使用したプログラミングの初心者であり、まず動作するアプリケーションのサンプルをいくつか確認する場合は、「[Windows Workflow のサンプル](../../../docs/framework/windows-workflow-foundation/samples/index.md)」に記載されている各トピックを参照してください。  
+  
+-   多様な Windows Workflow Foundation フロー制御モデルの説明については、「[ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)」を参照してください。  
+  
+-   Windows Workflow Foundation アプリケーションの基本的な作成手順のチュートリアルについては、「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」を参照してください。  
+  
+-   Windows Workflow Foundation の背景にある概念に関心がある場合は、「[Windows Workflow の概念](../../../docs/framework/windows-workflow-foundation//conceptual-overview.md)」の各トピックを参照してください。  
+  
+-   Windows Workflow Foundation のドキュメントで使用される用語の一覧については、「[.NET Framework 4.5 の Windows Workflow Foundation 用語集](../../../docs/framework/windows-workflow-foundation//glossary.md)」を参照してください。  
+  
+-   新しい概念と機能の一覧については、「[Windows Workflow Foundation の新機能](../../../docs/framework/windows-workflow-foundation//whats-new.md)」を参照してください。  
+  
+## プログラミングの詳細  
+  
+-   Windows Workflow Foundation オブジェクト モデルの詳細な説明については、「[Windows Workflow のアーキテクチャ](../../../docs/framework/windows-workflow-foundation//architecture.md)」を参照してください。  
+  
+-   アプリケーション開発を開始する準備が整っている場合は、「[Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)」を参照してください。  
+  
+-   要件に合わせて Windows Workflow Foundation を拡張したり、カスタマイズしたりする場合は、「[Windows Workflow Foundation の拡張](../../../docs/framework/windows-workflow-foundation//extend.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/host-lock-renewal-period.md b/docs/framework/windows-workflow-foundation/host-lock-renewal-period.md
new file mode 100644
index 00000000000..0630c697632
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/host-lock-renewal-period.md
@@ -0,0 +1,24 @@
+---
+title: "ホストのロック更新時間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f8ba94fc-27e0-4d8e-8f85-50a6d2a3cd43
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ホストのロック更新時間
+SQL Workflow Instance Store の**ホストのロック更新時間**のプロパティを使用すると、ホストがワークフロー インスタンスに対してロックを更新する時間を指定できます。ロックは、ホストのロック更新時間 \+ 30 秒の間は有効です。この期間内にホストがロックの更新 \(つまり、リースを延長\) に失敗した場合は、ロックの有効期限が切れ、永続化プロバイダーはインスタンスのロックを解除します。このプロパティの値は TimeSpan 型で、“hh:mm:ss" の形式です。最小許容値は “00:00:01” \(1 秒\) です。このプロパティの既定値は “00:00:30” \(30 秒\) です。  
+  
+ このプロパティは、所有するワークフロー サービス インスタンスのロックを解除する前にワークフロー サービス ホストがエラーになった場合に重要です。このような場合、ロックの有効期限が切れた後に永続プロバイダーによって永続性データベースのワークフロー サービス インスタンスのロックが削除され、サーバー ファーム内の同じコンピューターまたは別のコンピューターで実行されている別のワークフロー サービスホストがロックを取得してメモリにワークフロー サービス インスタンスを読み込み、最後の永続化状態から実行を再開できるようにします。  
+  
+ このプロパティに大きな値を設定すると、ワークフロー サービス インスタンスが永続性データベースで長時間ロックされ、最後の永続性ポイントからインスタンスが回復するのが遅くなります。このプロパティに短い間隔を設定すると、ワークフロー サービス ホストの新しいインスタンスがすぐにエラーになったワークフロー サービス インスタンスを取得することになりますが、これによってワークフロー サービス ホストと SQL Server データベースの負荷が増加します。  
+  
+ SQL Workflow Instance Store が実行する内部タスクは、定期的にアクティブになり、有効期限切れのロックを持つインスタンスを検出します。有効期限切れのロックを持つインスタンスが見つかると、そのインスタンスを RunnableInstances テーブルに置き、ワークフロー ホストがそのインスタンスを取得して実行できるようにします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/hosting-workflows.md b/docs/framework/windows-workflow-foundation/hosting-workflows.md
new file mode 100644
index 00000000000..2cee44667d6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/hosting-workflows.md
@@ -0,0 +1,41 @@
+---
+title: "ワークフローのホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], ワークフローのホスティング"
+ms.assetid: a99a5990-b53b-419b-9538-b1c3d1ba5db3
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# ワークフローのホスティング
+このセクションの各トピックでは、ワークフローのホスティングについて説明します。  
+  
+## このセクションの内容  
+ [ワークフロー ホスティングのオプション](../../../docs/framework/windows-workflow-foundation//workflow-hosting-options.md)  
+ ワークフローの適切なホストを選択する方法について説明します。  
+  
+ [WorkflowInvoker と WorkflowApplication の使用](../../../docs/framework/windows-workflow-foundation//using-workflowinvoker-and-workflowapplication.md)  
+ <xref:System.Activities.WorkflowInvoker> および <xref:System.Activities.WorkflowApplication> を使用してワークフローを呼び出す方法について説明します。  
+  
+ [アクティビティ ツリー検査](../../../docs/framework/windows-workflow-foundation//activity-tree-inspection.md)  
+ ワークフロー ホスト作成者が <xref:System.Activities.WorkflowInspectionServices> を使用してワークフローを調べることができる方法について説明します。  
+  
+ [XAML との間のワークフローおよびアクティビティのシリアル化](../../../docs/framework/windows-workflow-foundation//serializing-workflows-and-activities-to-and-from-xaml.md)  
+ ワークフローを XAML にシリアル化し、シリアル化したワークフロー定義を使用する方法を説明します。  
+  
+ [WorkflowIdentity と Versioning の使用](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md)  
+ `WorkflowIdentity` を使用して、ワークフローの複数バージョンを同時にホストする方法について説明します。  
+  
+## 参照  
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)   
+ [ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)   
+ [Windows Workflow Foundation のデータ モデル](../../../docs/framework/windows-workflow-foundation//data-model.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-designer.md b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-designer.md
new file mode 100644
index 00000000000..aec88b18114
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-designer.md
@@ -0,0 +1,366 @@
+---
+title: "方法: カスタム アクティビティ デザイナーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2f3aade6-facc-44ef-9657-a407ef8b9b31
+caps.latest.revision: 25
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 25
+---
+# 方法: カスタム アクティビティ デザイナーを作成する
+カスタム アクティビティ デザイナーは、通常、関連付けられたアクティビティを他のアクティビティと組み合わせることができるように実装されます。他のアクティビティのデザイナーは、アクティビティと一緒にデザイン サーフェイスにドロップできます。この機能を実現するには、任意のアクティビティを配置できる "ドロップ ゾーン" と、結果となるデザイン サーフェイス上の要素のコレクションを管理するための手段を、カスタム アクティビティ デザイナーで提供する必要があります。ここでは、そのようなドロップ ゾーンを含むカスタム アクティビティ デザイナーを作成する方法と、デザイナー要素のコレクションを管理するために必要な編集機能を提供するカスタム アクティビティ デザイナーを作成する方法を説明します。  
+  
+ カスタム アクティビティ デザイナーは、通常、<xref:System.Activities.Presentation.ActivityDesigner> を継承します。これは、特定のデザイナーを持たないアクティビティの既定の基本アクティビティ デザイナー型です。この型には、プロパティ グリッドと対話し、色やアイコンの管理などの基本的な側面を構成するデザイン時の機能があります。  
+  
+ <xref:System.Activities.Presentation.ActivityDesigner> では、カスタム アクティビティ デザイナーを開発しやすくする 2 つのヘルパー コントロール <xref:System.Activities.Presentation.WorkflowItemPresenter> と <xref:System.Activities.Presentation.WorkflowItemsPresenter> を使用します。これらは、子要素のドラッグ アンド ドロップ、その子要素の削除、選択、追加などの一般的な機能を処理します。<xref:System.Activities.Presentation.WorkflowItemPresenter> には、"ドロップ ゾーン" を提供する 1 つの子 UI 要素を含めることができます。一方、<xref:System.Activities.Presentation.WorkflowItemsPresenter> では複数の UI 要素がサポートされており、子要素の順序変更、移動、削除、追加などの機能を使用できます。  
+  
+ カスタム アクティビティ デザイナーの実装におけるもう 1 つの重要なポイントは、ビジュアル編集が、デザイナーで編集している対象のメモリ内インスタンスに、[!INCLUDE[avalon2](../../../includes/avalon2-md.md)] データ バインディングを使用してバインドされるしくみに関係しています。これは、モデル アイテム ツリーによって実現されます。モデル アイテム ツリーは、変更通知やイベント \(状態の変化など\) の追跡を実現するためにも使用されます。  
+  
+ ここでは、次の 2 つの手順の概要を説明します。  
+  
+1.  1 つ目の手順では、他のアクティビティを受け取るドロップ ゾーンを提供する <xref:System.Activities.Presentation.WorkflowItemPresenter> を使用してカスタム アクティビティ デザイナーを作成する方法を説明します。この手順は、「[カスタム複合デザイナー \- Workflow Item Presenter](../../../docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-item-presenter.md)」に基づいています。  
+  
+2.  2 つ目の手順では、含まれている要素のコレクションを編集するために必要な機能を提供する <xref:System.Activities.Presentation.WorkflowItemsPresenter> を使用してカスタム アクティビティ デザイナーを作成する方法を説明します。この手順は、「[カスタム複合デザイナー \- Workflow Items Presenter](../../../docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-items-presenter.md)」に基づいています。  
+  
+### WorkflowItemPresenter を使用してドロップ ゾーンを含むカスタム アクティビティ デザイナーを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を起動します。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト…\]** をクリックします。  
+  
+     **\[新しいプロジェクト\]** ダイアログ ボックスが表示されます。  
+  
+3.  **\[インストールされているテンプレート\]** ペインで任意の言語を選択し、**\[Windows\]** を選択します。  
+  
+4.  **\[テンプレート\]** ペインで、**\[WPF アプリケーション\]** を選択します。  
+  
+5.  **\[名前\]** ボックスに、「`UsingWorkflowItemPresenter`」と入力します。  
+  
+6.  **\[場所\]** ボックスにプロジェクトを保存するディレクトリを入力するか、**\[参照\]** をクリックしてディレクトリを選択します。  
+  
+7.  **\[ソリューション\]** ボックスは既定値のままにしておきます。  
+  
+8.  **\[OK\]** をクリックします。  
+  
+9. **\[ソリューション エクスプローラー\]** で MainWindows.xaml ファイルを右クリックし、**\[削除\]** をクリックします。**\[Microsoft Visual Studio\]** のダイアログ ボックスで **\[OK\]** をクリックして削除を確定します。  
+  
+10. **\[ソリューション エクスプローラー\]** で UsingWorkflowItemPresenter プロジェクトを右クリックし、**\[追加\]**、**\[新しい項目…\]** の順にクリックして、**\[新しい項目の追加\]** ダイアログを表示します。ダイアログの左側にある **\[インストールされているテンプレート\]** セクションで、**\[WPF\]** カテゴリを選択します。  
+  
+11. **\[ウィンドウ \(WPF\)\]** テンプレートを選択し、"`RehostingWFDesigner`" という名前を付けて、**\[追加\]** をクリックします。  
+  
+12. RehostingWFDesigner.xaml ファイルを開き、次のコードを貼り付けてアプリケーションの UI を定義します。  
+  
+    ```  
+  
+    <Window x:Class=" UsingWorkflowItemPresenter.RehostingWFDesigner"  
+            xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+            xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+            xmlns:sapt="clr-namespace:System.Activities.Presentation.Toolbox;assembly=System.Activities.Presentation"  
+            xmlns:sys="clr-namespace:System;assembly=mscorlib"  
+            Title="Window1" Height="600" Width="900">  
+        <Window.Resources>  
+            <sys:String x:Key="AssemblyName">System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35</sys:String>  
+        </Window.Resources>  
+        <Grid>  
+            <Grid.ColumnDefinitions>  
+                <ColumnDefinition Width="2*"/>  
+                <ColumnDefinition Width="7*"/>  
+                <ColumnDefinition Width="3*"/>  
+            </Grid.ColumnDefinitions>  
+            <Border Grid.Column="0">  
+                <sapt:ToolboxControl Name="Toolbox">  
+                    <sapt:ToolboxCategory CategoryName="Basic">  
+                        <sapt:ToolboxItemWrapper AssemblyName="{StaticResource AssemblyName}" >  
+                            <sapt:ToolboxItemWrapper.ToolName>  
+                                System.Activities.Statements.Sequence  
+                            </sapt:ToolboxItemWrapper.ToolName>  
+                           </sapt:ToolboxItemWrapper>  
+                        <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                            <sapt:ToolboxItemWrapper.ToolName>  
+                                System.Activities.Statements.WriteLine  
+                            </sapt:ToolboxItemWrapper.ToolName>  
+  
+                        </sapt:ToolboxItemWrapper>  
+                        <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                            <sapt:ToolboxItemWrapper.ToolName>  
+                                System.Activities.Statements.If  
+                            </sapt:ToolboxItemWrapper.ToolName>  
+  
+                        </sapt:ToolboxItemWrapper>  
+                        <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                            <sapt:ToolboxItemWrapper.ToolName>  
+                                System.Activities.Statements.While  
+                            </sapt:ToolboxItemWrapper.ToolName>  
+  
+                        </sapt:ToolboxItemWrapper>  
+                    </sapt:ToolboxCategory>  
+                </sapt:ToolboxControl>  
+            </Border>  
+            <Border Grid.Column="1" Name="DesignerBorder"/>  
+            <Border Grid.Column="2" Name="PropertyBorder"/>  
+        </Grid>  
+    </Window>  
+  
+    ```  
+  
+13. アクティビティ デザイナーをアクティビティ タイプと関連付けるには、そのアクティビティ デザイナーをメタデータ ストアを使用して登録する必要があります。この操作を行うには、`RegisterMetadata` メソッドを `RehostingWFDesigner` クラスに追加します。`RegisterMetadata` メソッドのスコープで <xref:System.Activities.Presentation.Metadata.AttributeTableBuilder> オブジェクトを作成し、<xref:System.Activities.Presentation.Metadata.AttributeTableBuilder.AddCustomAttributes%2A> メソッドを呼び出して属性を追加します。<xref:System.Activities.Presentation.Metadata.MetadataStore.AddAttributeTable%2A> メソッドを呼び出して <xref:System.Activities.Presentation.Metadata.AttributeTable> をメタデータ ストアに追加します。次のコードには、デザイナーの再ホスト ロジックが含まれています \(メタデータの登録、`SimpleNativeActivity` のツールボックスへの追加、およびワークフローの作成\)。このコードを RehostingWFDesigner.xaml.cs ファイルに追加します。  
+  
+    ```  
+  
+    using System;  
+    using System.Activities.Core.Presentation;  
+    using System.Activities.Presentation;  
+    using System.Activities.Presentation.Metadata;  
+    using System.Activities.Presentation.Toolbox;  
+    using System.Activities.Statements;  
+    using System.ComponentModel;  
+    using System.Windows;  
+  
+    namespace UsingWorkflowItemPresenter  
+    {  
+        // Interaction logic for RehostingWFDesigner.xaml  
+        public partial class RehostingWFDesigner  
+        {  
+            public RehostingWFDesigner()  
+            {  
+                InitializeComponent();  
+            }  
+  
+            protected override void OnInitialized(EventArgs e)  
+            {  
+                base.OnInitialized(e);  
+                // register metadata  
+                (new DesignerMetadata()).Register();  
+                RegisterCustomMetadata();  
+                // add custom activity to toolbox  
+                Toolbox.Categories.Add(new ToolboxCategory("Custom activities"));  
+                Toolbox.Categories[1].Add(new ToolboxItemWrapper(typeof(SimpleNativeActivity)));  
+  
+                // create the workflow designer  
+                WorkflowDesigner wd = new WorkflowDesigner();  
+                wd.Load(new Sequence());  
+                DesignerBorder.Child = wd.View;  
+                PropertyBorder.Child = wd.PropertyInspectorView;  
+  
+            }  
+  
+            void RegisterCustomMetadata()  
+            {  
+                AttributeTableBuilder builder = new AttributeTableBuilder();  
+                builder.AddCustomAttributes(typeof(SimpleNativeActivity), new DesignerAttribute(typeof(SimpleNativeDesigner)));  
+                MetadataStore.AddAttributeTable(builder.CreateTable());  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+14. ソリューション エクスプローラーで \[参照設定\] ディレクトリを右クリックし、**\[参照の追加…\]** をクリックして、**\[参照の追加\]** ダイアログを表示します。  
+  
+15. **\[.NET\]** タブをクリックし、**\[System.Activities.Core.Presentation\]** という名前のアセンブリを見つけて選択し、**\[OK\]** をクリックします。  
+  
+16. 同じ手順で次のアセンブリへの参照を追加します。  
+  
+    1.  System.Data.DataSetExtensions.dll  
+  
+    2.  System.Activities.Presentation.dll  
+  
+    3.  System.ServiceModel.Activities.dll  
+  
+17. App.xaml ファイルを開き、StartUpUri の値を "RehostingWFDesigner.xaml" に変更します。  
+  
+18. **\[ソリューション エクスプローラー\]** で UsingWorkflowItemPresenter プロジェクトを右クリックし、**\[追加\]**、**\[新しい項目…\]** の順にクリックして、**\[新しい項目の追加\]** ダイアログを表示します。ダイアログの左側にある **\[インストールされているテンプレート\]** セクションで、**\[ワークフロー\]** カテゴリを選択します。  
+  
+19. **\[アクティビティ デザイナー\]** テンプレートを選択し、"`SimpleNativeDesigner`" という名前を付けて、**\[追加\]** をクリックします。  
+  
+20. SimpleNativeDesigner.xaml ファイルを開いて次のコードを貼り付けます。このコードは、<xref:System.Activities.Presentation.ActivityDesigner> をルート要素として使用し、子の型を複合アクティビティ デザイナーに表示できるように、バインディングを使用してデザイナーに <xref:System.Activities.Presentation.WorkflowItemPresenter> を統合する方法を示しています。  
+  
+    > [!NOTE]
+    >  <xref:System.Activities.Presentation.ActivityDesigner> のスキーマでは、カスタム アクティビティ デザイナー定義に 1 つの子要素のみを追加できます。ただし、この要素は、`StackPanel`、`Grid` などの複合 UI 要素の可能性があります。  
+  
+    ```  
+  
+    <sap:ActivityDesigner x:Class=" UsingWorkflowItemPresenter.SimpleNativeDesigner"  
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+        xmlns:sap="clr-namespace:System.Activities.Presentation;assembly=System.Activities.Presentation"  
+        xmlns:sapv="clr-namespace:System.Activities.Presentation.View;assembly=System.Activities.Presentation">  
+        <sap:ActivityDesigner.Resources>  
+            <DataTemplate x:Key="Collapsed">  
+                <StackPanel>  
+                    <TextBlock>This is the collapsed view</TextBlock>  
+                </StackPanel>  
+            </DataTemplate>  
+            <DataTemplate x:Key="Expanded">  
+                <StackPanel>  
+                    <TextBlock>Custom Text</TextBlock>  
+                    <sap:WorkflowItemPresenter Item="{Binding Path=ModelItem.Body, Mode=TwoWay}"  
+                                            HintText="Please drop an activity here" />  
+                </StackPanel>  
+            </DataTemplate>  
+            <Style x:Key="ExpandOrCollapsedStyle" TargetType="{x:Type ContentPresenter}">  
+                <Setter Property="ContentTemplate" Value="{DynamicResource Collapsed}"/>  
+                <Style.Triggers>  
+                    <DataTrigger Binding="{Binding Path=ShowExpanded}" Value="true">  
+                        <Setter Property="ContentTemplate" Value="{DynamicResource Expanded}"/>  
+                    </DataTrigger>  
+                </Style.Triggers>  
+            </Style>  
+        </sap:ActivityDesigner.Resources>  
+        <Grid>  
+            <ContentPresenter Style="{DynamicResource ExpandOrCollapsedStyle}" Content="{Binding}" />  
+        </Grid>  
+    </sap:ActivityDesigner>  
+  
+    ```  
+  
+21. **\[ソリューション エクスプローラー\]** で UsingWorkflowItemPresenter プロジェクトを右クリックし、**\[追加\]**、**\[新しい項目…\]** の順にクリックして、**\[新しい項目の追加\]** ダイアログを表示します。ダイアログの左側にある **\[インストールされているテンプレート\]** セクションで、**\[ワークフロー\]** カテゴリを選択します。  
+  
+22. **\[コード アクティビティ\]** テンプレートを選択し、"`SimpleNativeActivity`" という名前を付けて、**\[追加\]** をクリックします。  
+  
+23. SimpleNativeActivity.cs ファイルに次のコードを入力して、`SimpleNativeActivity` クラスを実装します。  
+  
+    ```  
+  
+    using System.Activities;  
+  
+    namespace UsingWorkflowItemPresenter  
+    {  
+        public sealed class SimpleNativeActivity : NativeActivity  
+        {  
+            // this property contains an activity that will be scheduled in the execute method  
+    // the WorkflowItemPresenter in the designer is bound to this to enable editing  
+    // of the value  
+            public Activity Body { get; set; }  
+  
+            protected override void CacheMetadata(NativeActivityMetadata metadata)  
+            {  
+               metadata.AddChild(Body);  
+               base.CacheMetadata(metadata);  
+  
+            }  
+  
+            protected override void Execute(NativeActivityContext context)  
+            {  
+                context.ScheduleActivity(Body);  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+24. **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+25. **\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、再ホストされたカスタム デザイン ウィンドウを開きます。  
+  
+### WorkflowItemsPresenter を使用してカスタム アクティビティ デザイナーを作成するには  
+  
+1.  2 つ目のカスタム アクティビティ デザイナーの手順は、1 つ目の手順とほとんど同じですが、いくつかの変更点があります。まず、2 つ目のアプリケーションには "`UsingWorkflowItemsPresenter`" という名前を付けます。また、このアプリケーションでは新しいカスタム アクティビティを定義しません。  
+  
+2.  主な相違点は、CustomParallelDesigner.xaml ファイルと RehostingWFDesigner.xaml.cs ファイルに含まれています。次のコードは、UI を定義する CustomParallelDesigne.xaml ファイルのコードです。  
+  
+    ```  
+    <sap:ActivityDesigner x:Class=" UsingWorkflowItemsPresenter.CustomParallelDesigner"  
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+        xmlns:sap="clr-namespace:System.Activities.Presentation;assembly=System.Activities.Presentation"  
+        xmlns:sapv="clr-namespace:System.Activities.Presentation.View;assembly=System.Activities.Presentation">  
+        <sap:ActivityDesigner.Resources>  
+            <DataTemplate x:Key="Collapsed">  
+                <TextBlock>This is the Collapsed View</TextBlock>  
+            </DataTemplate>  
+            <DataTemplate x:Key="Expanded">  
+                <StackPanel>  
+                    <TextBlock HorizontalAlignment="Center">This is the</TextBlock>  
+                    <TextBlock HorizontalAlignment="Center">extended view</TextBlock>  
+                    <sap:WorkflowItemsPresenter HintText="Drop Activities Here"  
+                                        Items="{Binding Path=ModelItem.Branches}">  
+                        <sap:WorkflowItemsPresenter.SpacerTemplate>  
+                            <DataTemplate>  
+                                <Ellipse Width="10" Height="10" Fill="Black"/>  
+                            </DataTemplate>  
+                        </sap:WorkflowItemsPresenter.SpacerTemplate>  
+                        <sap:WorkflowItemsPresenter.ItemsPanel>  
+                            <ItemsPanelTemplate>  
+                                <StackPanel Orientation="Horizontal"/>  
+                            </ItemsPanelTemplate>  
+                        </sap:WorkflowItemsPresenter.ItemsPanel>  
+                    </sap:WorkflowItemsPresenter>  
+                </StackPanel>  
+            </DataTemplate>  
+            <Style x:Key="ExpandOrCollapsedStyle" TargetType="{x:Type ContentPresenter}">  
+                <Setter Property="ContentTemplate" Value="{DynamicResource Collapsed}"/>  
+                <Style.Triggers>  
+                    <DataTrigger Binding="{Binding Path=ShowExpanded}" Value="true">  
+                        <Setter Property="ContentTemplate" Value="{DynamicResource Expanded}"/>  
+                    </DataTrigger>  
+                </Style.Triggers>  
+            </Style>  
+        </sap:ActivityDesigner.Resources>  
+        <Grid>  
+            <ContentPresenter Style="{DynamicResource ExpandOrCollapsedStyle}" Content="{Binding}"/>  
+        </Grid>  
+    </sap:ActivityDesigner>  
+  
+    ```  
+  
+3.  次のコードは、再ホスト ロジックを提供する RehostingWFDesigner.xaml.cs ファイルのコードです。  
+  
+    ```  
+  
+    using System;  
+    using System.Activities.Core.Presentation;  
+    using System.Activities.Presentation;  
+    using System.Activities.Presentation.Metadata;  
+    using System.Activities.Statements;  
+    using System.ComponentModel;  
+    using System.Windows;  
+  
+    namespaceUsingWorkflowItemsPresenter  
+    {  
+        public partial class RehostingWfDesigner : Window  
+        {  
+            public RehostingWfDesigner()  
+            {  
+                InitializeComponent();  
+            }  
+  
+            protected override void OnInitialized(EventArgs e)  
+            {  
+                base.OnInitialized(e);  
+                // register metadata  
+                (new DesignerMetadata()).Register();  
+                RegisterCustomMetadata();  
+  
+                // create the workflow designer  
+                WorkflowDesigner wd = new WorkflowDesigner();  
+                wd.Load(new Sequence());  
+                DesignerBorder.Child = wd.View;  
+                PropertyBorder.Child = wd.PropertyInspectorView;  
+  
+            }  
+  
+            void RegisterCustomMetadata()  
+            {  
+                AttributeTableBuilder builder = new AttributeTableBuilder();  
+                builder.AddCustomAttributes(typeof(Parallel), new DesignerAttribute(typeof(CustomParallelDesigner)));  
+                MetadataStore.AddAttributeTable(builder.CreateTable());  
+            }  
+        }  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Activities.Presentation.ActivityDesigner>   
+ <xref:System.Activities.Presentation.WorkflowItemPresenter>   
+ <xref:System.Activities.Presentation.WorkflowItemsPresenter>   
+ <xref:System.Activities.Presentation.WorkflowViewElement>   
+ <xref:System.Activities.Presentation.Model.ModelItem>   
+ [ワークフロー デザイン操作のカスタマイズ](../../../docs/framework/windows-workflow-foundation//customizing-the-workflow-design-experience.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-template.md b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-template.md
new file mode 100644
index 00000000000..ccad7b17f13
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-activity-template.md
@@ -0,0 +1,139 @@
+---
+title: "方法: カスタム アクティビティ テンプレートを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6760a5cc-6eb8-465f-b4fa-f89b39539429
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 方法: カスタム アクティビティ テンプレートを作成する
+カスタム複合アクティビティなどのアクティビティの構成のカスタマイズには、カスタム アクティビティ テンプレートが使用されるため、手動で各アクティビティを個別に作成し、そのプロパティおよびその他の設定を構成する必要はありません。このようなカスタム テンプレートは、[!INCLUDE[wfd1](../../../includes/wfd1-md.md)] 上の **\[ツールボックス\]** または再ホストされたデザイナーから利用できるようにすることが可能です。ユーザーは、ここから構成済みのデザイン サーフェイスにカスタム テンプレートをドラッグできます。[!INCLUDE[wfd2](../../../includes/wfd2-md.md)] には以下のようなテンプレートの例が梱包されます: [SendAndReceiveReply テンプレート デザイナー](../Topic/SendAndReceiveReply%20Template%20Designer.md) および [メッセージング アクティビティ デザイナー](../Topic/Messaging%20Activity%20Designers.md) の [ReceiveAndSendReply テンプレート デザイナー](../Topic/ReceiveAndSendReply%20Template%20Designer.md) カテゴリ。  
+  
+ このトピックの最初の手順では、**Delay** アクティビティのカスタム アクティビティ テンプレートを作成する方法について説明し、2 番目の手順では、[!INCLUDE[wfd2](../../../includes/wfd2-md.md)]でカスタム アクティビティ テンプレートを利用できるようにしてカスタム テンプレートが機能することを確認する方法について簡単に説明します。  
+  
+ カスタム アクティビティ テンプレートに <xref:System.Activities.Presentation.IActivityTemplateFactory> を実装する必要があります。このインターフェイスには単一の <xref:System.Activities.Presentation.IActivityTemplateFactory.Create%2A> メソッドがあり、このメソッドを使用して、テンプレートで使用されるアクティビティ インスタンスを作成および構成できます。  
+  
+### Delay アクティビティのテンプレートを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を起動します。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+     **\[新しいプロジェクト\]** ダイアログ ボックスが表示されます。  
+  
+3.  **\[プロジェクトの種類\]** ペインで、プログラミング言語の設定に応じて、**\[Visual C\#\]** プロジェクトまたは **\[Visual Basic\]** グループから **\[ワークフロー\]** を選択します。  
+  
+4.  **\[テンプレート\]** ペインで **\[アクティビティ ライブラリ\]** をクリックします。  
+  
+5.  **\[名前\]** ボックスに、「`DelayActivityTemplate`」と入力します。  
+  
+6.  **\[場所\]** テキスト ボックスと **\[ソリューション名\]** テキスト ボックスの既定の設定を受け入れ、**\[OK\]** をクリックします。  
+  
+7.  **ソリューション エクスプローラー**で、DelayActivityTemplate プロジェクトの \[参照設定\] ディレクトリを右クリックし、**\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを開きます。  
+  
+8.  **\[.NET\]** タブに移動し、左側の **\[コンポーネント名\]** 列から **\[PresentationFramework\]** を選択します。**\[OK\]** をクリックして PresentationFramework.dll ファイルへの参照を追加します。  
+  
+9. この手順を繰り返して、System.Activities.Presentation.dll ファイルと WindowsBase.dll ファイルへの参照を追加します。  
+  
+10. **ソリューション エクスプローラー**で、DelayActivityTemplate プロジェクトを右クリックして **\[追加\]** をポイントし、**\[新しい項目\]** をクリックして **\[新しい項目の追加\]** ダイアログ ボックスを開きます。  
+  
+11. **\[クラス\]** テンプレートを選択し、"MyDelayTemplate" という名前を付けて、**\[OK\]** をクリックします。  
+  
+12. MyDelayTemplate.cs ファイルを開き、次のステートメントを追加します。  
+  
+    ```  
+  
+    //Namespaces added  
+    using System.Activities;  
+    using System.Activities.Statements;  
+    using System.Activities.Presentation;  
+    using System.Windows;  
+  
+    ```  
+  
+13. 次のコードを使用して、`MyDelayActivity` クラスを持つ <xref:System.Activities.Presentation.IActivityTemplateFactory> を実装します。これにより、10 秒間の遅延が構成されます。  
+  
+    ```  
+  
+    public sealed class MyDelayActivity : IActivityTemplateFactory  
+    {  
+        public Activity Create(System.Windows.DependencyObject target)  
+        {  
+            return new System.Activities.Statements.Delay  
+            {  
+                DisplayName = "DelayActivityTemplate",  
+                Duration = new TimeSpan(0, 0, 10)  
+  
+            };  
+        }  
+    }  
+  
+    ```  
+  
+14. **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックして、DelayActivityTemplate.dll ファイルを生成します。  
+  
+### ワークフロー デザイナーでテンプレートを利用できるようにするには  
+  
+1.  **ソリューション エクスプローラー**で、DelayActivityTemplate ソリューションを右クリックして **\[追加\]** をポイントし、**\[新しいプロジェクト\]** をクリックして **\[新しいプロジェクトの追加\]** ダイアログ ボックスを開きます。  
+  
+2.  **\[ワークフロー コンソール アプリケーション\]** テンプレートを選択し、"`CustomActivityTemplateApp`" という名前を付けて、**\[OK\]** をクリックします。  
+  
+3.  **ソリューション エクスプローラー**で、CustomActivityTemplateApp プロジェクトの \[参照設定\] ディレクトリを右クリックし、**\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを開きます。  
+  
+4.  **\[プロジェクト\]** タブに移動し、左側の **\[プロジェクト名\]** 列から **\[DelayActivityTemplate\]** を選択します。**\[OK\]** をクリックして、最初の手順で作成した DelayActivityTemplate.dll ファイルへの参照を追加します。  
+  
+5.  **ソリューション エクスプローラー**で CustomActivityTemplateApp プロジェクトを右クリックし、**\[ビルド\]** をクリックしてアプリケーションをコンパイルします。  
+  
+6.  **ソリューション エクスプローラー**で CustomActivityTemplateApp プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+7.  **\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、cmd.exe ウィンドウから要求されたら任意のキーを押して続行します。  
+  
+8.  Workflow1.xaml ファイルを開き、**\[ツールボックス\]** を開きます。  
+  
+9. **DelayActivityTemplate** カテゴリの **MyDelayActivity** テンプレートを見つけます。デザイン サーフェイスにドラッグします。**\[プロパティ\]** ウィンドウで、`Duration` プロパティが 10 秒に設定されていることを確認します。  
+  
+## 使用例  
+ MyDelayActivity.cs ファイルには次のコードが含まれます。  
+  
+```  
+  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+  
+//Namespaces added  
+using System.Activities;  
+using System.Activities.Statements;  
+using System.Activities.Presentation;  
+using System.Windows;  
+  
+namespace DelayActivityTemplate  
+{  
+    public sealed class MyDelayActivity : IActivityTemplateFactory  
+    {  
+        public Activity Create(System.Windows.DependencyObject target)  
+        {  
+            return new System.Activities.Statements.Delay  
+            {  
+                DisplayName = "DelayActivityTemplate",  
+                Duration = new TimeSpan(0, 0, 10)  
+  
+            };  
+        }  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ <xref:System.Activities.Presentation.IActivityTemplateFactory>   
+ [ワークフロー デザイン操作のカスタマイズ](../../../docs/framework/windows-workflow-foundation//customizing-the-workflow-design-experience.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-custom-instance-store.md b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-instance-store.md
new file mode 100644
index 00000000000..4de2e5c6acd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-instance-store.md
@@ -0,0 +1,404 @@
+---
+title: "カスタム インスタンス ストアを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 593c4e9d-8a49-4e12-8257-cee5e6b4c075
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# カスタム インスタンス ストアを作成する方法
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> という、SQL Server を使用してワークフロー データの永続化を行うインスタンス ストアが含まれています。  ワークフロー データの永続化を別のメディアで行う、つまり、別のデータベースやファイル システムなどを使用して行う必要があるアプリケーションの場合は、カスタム インスタンス ストアを実装できます。  カスタム インスタンス ストアを作成するには、抽象 <xref:System.Runtime.DurableInstancing.InstanceStore> クラスを拡張し、その実装に必要なメソッドを実装します。  カスタム インスタンス ストア実装の完成例については、「[企業の購買プロセス](../../../docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md)」のサンプルを参照してください。  
+  
+## BeginTryCommand メソッドの実装  
+ <xref:System.Runtime.DurableInstancing.InstanceStore.BeginTryCommand%2A> は永続化エンジンによってインスタンス ストアに送信されます。  `command` パラメーターの型は、どのコマンドを実行するかを示します。このパラメーターは次のいずれかになります:  
+  
+-   <xref:System.Activities.DurableInstancing.SaveWorkflowCommand>: ワークフローをストレージ メディアに永続化する場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  ワーク フローの永続性データは、<xref:System.Activities.DurableInstancing.SaveWorkflowCommand.InstanceData%2A> パラメーターの `command` メンバー内のメソッドに提供されます。  
+  
+-   <xref:System.Activities.DurableInstancing.LoadWorkflowCommand>: ワークフローをストレージ メディアから読み込む場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  読み込むワークフローのインスタンス ID は、`instanceId` パラメーターの <xref:System.Runtime.DurableInstancing.InstancePersistenceContext.InstanceView%2A> プロパティの `context` パラメーター内のメソッドに提供されます。  
+  
+-   <xref:System.Activities.DurableInstancing.CreateWorkflowOwnerCommand>: <xref:System.ServiceModel.Activities.WorkflowServiceHost> をロック所有者として登録する必要がある場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  現在のワーク フローのインスタンス ID を、<xref:System.Runtime.DurableInstancing.InstancePersistenceContext.BindInstanceOwner%2A> パラメーターの `context` メソッドを使用してインスタンス ストアに提供する必要があります。  
+  
+     次のコード スニペットは、CreateWorkflowOwner コマンドを実装して明示的なロック所有者を割り当てる方法を示しています。  
+  
+    ```  
+    XName WFInstanceScopeName = XName.Get(scopeName, "<namespace>");  
+    ...  
+    CreateWorkflowOwnerCommand createCommand = new CreateWorkflowOwnerCommand()  
+    {  
+        InstanceOwnerMetadata =  
+        {  
+            { WorkflowHostTypeName, new InstanceValue(WFInstanceScopeName) },  
+        }  
+    };  
+    InstanceHandle ownerHandle = store.CreateInstanceHandle();  
+    store.DefaultInstanceOwner = store.Execute(  
+                                   ownerHandle,  
+                                   createCommand,  
+                                   TimeSpan.FromSeconds(30)).InstanceOwner;  
+    childInstance.AddInitialInstanceValues(new Dictionary<XName, object>() { { WorkflowHostTypeName, WFInstanceScopeName } });  
+  
+    ```  
+  
+-   <xref:System.Activities.DurableInstancing.DeleteWorkflowOwnerCommand>: ロック所有者のインスタンス ID をインスタンス ストアから削除してよい場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  <xref:System.Activities.DurableInstancing.CreateWorkflowOwnerCommand> と同様に、アプリケーションがロック所有者の ID を提供する必要があります。  
+  
+     次のコード スニペットは、<xref:System.Activities.DurableInstancing.DeleteWorkflowOwnerCommand> を使用してロックを解除する方法を示しています。  
+  
+    ```  
+    static void FreeHandleAndDeleteOwner(InstanceStore store, InstanceHandle handle)  
+    {  
+        handle.Free();  
+        handle = store.CreateInstanceHandle(store.DefaultInstanceOwner);  
+        try  
+        {  
+            // We need this sleep so that we dont prematurely delete the owner, we need time to update the database.  
+            Thread.Sleep(10000);  
+            store.Execute(handle, new DeleteWorkflowOwnerCommand(), TimeSpan.FromSeconds(10));  
+        }  
+        catch (InstancePersistenceCommandException ex) { Log.Inform(ex.Message); }  
+        catch (InstanceOwnerException ex) { Log.Inform(ex.Message); }  
+        catch (OperationCanceledException ex) { Log.Inform(ex.Message); }  
+        catch (Exception ex) { Log.Inform(ex.Message); }  
+        finally  
+        {  
+            handle.Free();  
+            store.DefaultInstanceOwner = null;  
+        }  
+    }  
+  
+    ```  
+  
+     上のメソッドは、子インスタンスが実行されているときに Try ～ Catch ブロック内から呼び出す必要があります。  
+  
+    ```  
+    try  
+    {  
+        childInstance.Run();  
+    }  
+    catch (Exception)  
+    {  
+        throw ;  
+    }  
+    finally  
+    {  
+        FreeHandleAndDeleteOwner(store, ownerHandle);  
+    }  
+  
+    ```  
+  
+-   <xref:System.Activities.DurableInstancing.LoadWorkflowByInstanceKeyCommand>: ワークフローのインスタンス キーを使用してワークフローのインスタンスを読み込む場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  インスタンス キーの ID は、このコマンドの <xref:System.Activities.DurableInstancing.LoadWorkflowByInstanceKeyCommand.LookupInstanceKey%2A> パラメーターを使用して確認できます。  
+  
+-   <xref:System.Activities.DurableInstancing.QueryActivatableWorkflowsCommand>: ワークフローを読み込むワークフロー ホストを作成するために永続化ワークフローのアクティベーション パラメーターを取得する場合は、永続化エンジンがこのコマンドをインスタンス ストアに送信します。  このコマンドは、インスタンス ストアがアクティブ化できるインスタンスを見つけて、ホストに <xref:System.Activities.DurableInstancing.HasActivatableWorkflowEvent> を発生させたとき、それに対する応答としてエンジンにより送信されます。  アクティブ化できるワーク フローがあるかどうかを判別するには、インスタンス ストアをポーリングする必要があります。  
+  
+-   <xref:System.Activities.DurableInstancing.TryLoadRunnableWorkflowCommand>: 実行可能なワークフロー インスタンスを読み込む場合、永続化エンジンがインスタンス ストアにこのコマンドを送信します。  このコマンドは、インスタンス ストアが実行できるインスタンスを見つけて、ホストに <xref:System.Activities.DurableInstancing.HasRunnableWorkflowEvent> を発生させたとき、それに対する応答としてエンジンにより送信されます。  実行できるワークフローを見つけるには、インスタンス ストアをポーリングする必要があります。  次のコード スニペットは、実行またはアクティブ化できるワークフローのために、インスタンス ストアのポーリングを行う方法を示しています。  
+  
+    ```  
+    public void PollForEvents()  
+    {  
+        InstanceOwner[] storeOwners = this.GetInstanceOwners();  
+  
+        foreach (InstanceOwner owner in storeOwners)  
+        {  
+            foreach (InstancePersistenceEvent ppEvent in this.GetEvents(owner))  
+            {  
+                if (ppEvent.Equals(HasRunnableWorkflowEvent.Value))  
+                {  
+                    bool hasRunnable = GetRunnableEvents(this.StoreId, owner.InstanceOwnerId, isActivable);  
+                    if (hasRunnable)  
+                    {  
+                        this.SignalEvent(ppEvent, owner);  
+                    }  
+                    else  
+                    {  
+                        this.ResetEvent(ppEvent, owner);  
+                    }  
+                }  
+                else if(ppEvent.Equals(HasActivatableWorkflowEvent.Value))  
+                {  
+                   bool hasActivable = GetActivableEvents(this.StoreId, owner.InstanceOwnerId);  
+                   if (hasActivable)  
+                    {  
+                        this.SignalEvent(ppEvent, owner);  
+                    }  
+                    else  
+                    {  
+                        this.ResetEvent(ppEvent, owner);  
+                    }  
+                }  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+     上のコード スニペットでは、インスタンス ストアが、使用できるイベントを探し、各イベントが <xref:System.Activities.DurableInstancing.HasRunnableWorkflowEvent> イベントであるかどうかを判断しています。  使用できるイベントが見つかると、<xref:System.Runtime.DurableInstancing.InstanceStore.SignalEvent%2A> が呼び出され、インスタンス ストアにコマンドを送信することを指示する通知がホストに送信されます。  次のコード スニペットはこのコマンドのハンドラーの実装を示します。  
+  
+    ```  
+    If (command is TryLoadRunnableWorkflowCommand)  
+    {  
+        Owner owner;  
+        CheckOwner(context, command.Name, out owner);                          
+        // Checking instance.Owner is like an InstanceLockQueryResult.  
+        context.QueriedInstanceStore(new InstanceLockQueryResult(context.InstanceView.InstanceId, context.InstanceView.InstanceOwner.InstanceOwnerId));  
+  
+        XName ownerService = null;  
+        InstanceValue value;  
+        Instance runnableInstance = default(Instance);  
+        bool foundRunnableInstance = false;  
+  
+        value = QueryPropertyBag(WorkflowNamespace.WorkflowHostType, owner.Data);  
+        if (value != null && value.Value is XName)  
+        {  
+            ownerService = (XName)value.Value;  
+        }  
+  
+        foreach (KeyValuePair<Guid, Instance> instance in MemoryStore.instances)  
+        {  
+            if (instance.Value.Owner != Guid.Empty || instance.Value.Completed)  
+            {  
+                continue;  
+            }  
+  
+            if (ownerService != null)  
+            {  
+                value = QueryPropertyBag(WorkflowNamespace.WorkflowHostType, instance.Value.Metadata);  
+                if (value == null || ((XName)value.Value) != ownerService)  
+                {  
+                    continue;  
+                }  
+            }  
+  
+            value = QueryPropertyBag(WorkflowServiceNamespace.SuspendReason, instance.Value.Metadata);  
+            if (value != null && value.Value != null && value.Value is string)  
+            {  
+                continue;  
+            }  
+  
+            value = QueryPropertyBag(WorkflowNamespace.Status, instance.Value.Data);  
+            if (value != null && value.Value is string && ((string)value.Value) == "Executing")  
+            {  
+                runnableInstance = instance.Value;  
+                foundRunnableInstance = true;  
+            }  
+  
+            if (!foundRunnableInstance)  
+            {  
+                value = QueryPropertyBag(XNamespace.Get("urn:schemas-microsoft-com:System.Activities/4.0/properties").GetName("TimerExpirationTime"), instance.Value.Data);  
+                if (value != null && value.Value is DateTime && ((DateTime)value.Value) <= DateTime.UtcNow)  
+                {                          
+                    runnableInstance = instance.Value;  
+                    foundRunnableInstance = true;  
+                }  
+            }  
+  
+            if (foundRunnableInstance)  
+            {  
+                runnableInstance.LockVersion++;  
+                runnableInstance.Owner = context.InstanceView.InstanceOwner.InstanceOwnerId;  
+                MemoryStore.instances[instance.Key] = runnableInstance;  
+                context.BindInstance(instance.Key);  
+                context.BindAcquiredLock(runnableInstance.LockVersion);  
+  
+                Dictionary<Guid, IDictionary<XName, InstanceValue>> associatedKeys = new Dictionary<Guid, IDictionary<XName, InstanceValue>>();  
+                Dictionary<Guid, IDictionary<XName, InstanceValue>> completedKeys = new Dictionary<Guid, IDictionary<XName, InstanceValue>>();  
+                foreach (KeyValuePair<Guid, Key> keyEntry in MemoryStore.keys)  
+                {  
+                if (keyEntry.Value.Instance == context.InstanceView.InstanceId)  
+                {  
+                    if (keyEntry.Value.Completed)  
+                    {  
+                        completedKeys.Add(keyEntry.Key, DeserializePropertyBag(keyEntry.Value.Metadata));  
+                    }  
+                    else  
+                    {  
+                        associatedKeys.Add(keyEntry.Key, DeserializePropertyBag(keyEntry.Value.Metadata));  
+                    }  
+                }  
+            }  
+  
+            context.LoadedInstance(InstanceState.Initialized, DeserializePropertyBag(runnableInstance.Data), DeserializePropertyBag(runnableInstance.Metadata), associatedKeys, completedKeys);  
+            break;  
+        }  
+    }  
+  
+    ```  
+  
+     上のコード スニペットでは、インスタンス ストアは実行可能なインスタンスを検索します。  インスタンスが見つかると、そのインスタンスが実行コンテキストにバインドされ、読み込まれます。  
+  
+## カスタム インスタンス ストアの使用  
+ カスタム インスタンス ストアを実装するには、インスタンス ストアのインスタンスを <xref:System.Activities.WorkflowApplication.InstanceStore%2A> に割り当て、<xref:System.Activities.WorkflowApplication.PersistableIdle%2A> メソッドを実装します。  詳細については、「[長時間にわたって実行されるワークフローを作成して実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md)」のチュートリアルを参照してください。  
+  
+## サンプル インスタンス ストア  
+ 次のコード サンプルは、「[企業の購買プロセス](../../../docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md)」のサンプルに含まれている完成したインスタンス ストア実装の例です。  このインスタンス ストアは、XML を使用してファイルにワークフロー データを永続化します。  
+  
+```  
+  
+using System;  
+using System.Activities.DurableInstancing;  
+using System.Collections.Generic;  
+using System.IO;  
+using System.Runtime.DurableInstancing;  
+using System.Runtime.Serialization;  
+using System.ServiceModel.Persistence;  
+using System.Xml;  
+using System.Xml.Linq;  
+  
+namespace Microsoft.Samples.WF.PurchaseProcess  
+{  
+  
+    public class XmlWorkflowInstanceStore : InstanceStore  
+    {  
+        Guid ownerInstanceID;  
+  
+        public XmlWorkflowInstanceStore() : this(Guid.NewGuid())  
+        {  
+  
+        }  
+  
+        public XmlWorkflowInstanceStore(Guid id)  
+        {  
+            ownerInstanceID = id;  
+        }  
+  
+        //Synchronous version of the Begin/EndTryCommand functions  
+        protected override bool TryCommand(InstancePersistenceContext context, InstancePersistenceCommand command, TimeSpan timeout)  
+        {  
+            return EndTryCommand(BeginTryCommand(context, command, timeout, null, null));  
+        }  
+  
+        //The persistence engine will send a variety of commands to the configured InstanceStore,  
+        //such as CreateWorkflowOwnerCommand, SaveWorkflowCommand, and LoadWorkflowCommand.  
+        //This method is where we will handle those commands  
+        protected override IAsyncResult BeginTryCommand(InstancePersistenceContext context, InstancePersistenceCommand command, TimeSpan timeout, AsyncCallback callback, object state)  
+        {  
+            IDictionary<XName, InstanceValue> data = null;  
+  
+            //The CreateWorkflowOwner command instructs the instance store to create a new instance owner bound to the instanace handle  
+            if (command is CreateWorkflowOwnerCommand)  
+            {  
+                context.BindInstanceOwner(ownerInstanceID, Guid.NewGuid());  
+            }  
+            //The SaveWorkflow command instructs the instance store to modify the instance bound to the instance handle or an instance key  
+            else if (command is SaveWorkflowCommand)  
+            {  
+                SaveWorkflowCommand saveCommand = (SaveWorkflowCommand)command;  
+                data = saveCommand.InstanceData;  
+  
+                Save(data);  
+            }  
+            //The LoadWorkflow command instructs the instance store to lock and load the instance bound to the identifier in the instance handle  
+            else if (command is LoadWorkflowCommand)  
+            {  
+                string fileName = IOHelper.GetFileName(this.ownerInstanceID);  
+  
+                try  
+                {  
+                    using (FileStream inputStream = new FileStream(fileName, FileMode.Open))  
+                    {  
+                        data = LoadInstanceDataFromFile(inputStream);  
+                        //load the data into the persistence Context  
+                        context.LoadedInstance(InstanceState.Initialized, data, null, null, null);  
+                    }  
+                }  
+                catch (Exception exception)  
+                {  
+                    throw new PersistenceException(exception.Message);  
+                }  
+            }  
+  
+            return new CompletedAsyncResult<bool>(true, callback, state);  
+        }  
+  
+        protected override bool EndTryCommand(IAsyncResult result)  
+        {  
+            return CompletedAsyncResult<bool>.End(result);  
+        }  
+  
+        //Reads data from xml file and creates a dictionary based off of that.  
+        IDictionary<XName, InstanceValue> LoadInstanceDataFromFile(Stream inputStream)  
+        {  
+            IDictionary<XName, InstanceValue> data = new Dictionary<XName, InstanceValue>();  
+  
+            NetDataContractSerializer s = new NetDataContractSerializer();  
+  
+            XmlReader rdr = XmlReader.Create(inputStream);  
+            XmlDocument doc = new XmlDocument();  
+            doc.Load(rdr);  
+  
+            XmlNodeList instances = doc.GetElementsByTagName("InstanceValue");  
+            foreach (XmlElement instanceElement in instances)  
+            {  
+                XmlElement keyElement = (XmlElement)instanceElement.SelectSingleNode("descendant::key");  
+                XName key = (XName)DeserializeObject(s, keyElement);  
+  
+                XmlElement valueElement = (XmlElement)instanceElement.SelectSingleNode("descendant::value");  
+                object value = DeserializeObject(s, valueElement);  
+                InstanceValue instVal = new InstanceValue(value);  
+  
+                data.Add(key, instVal);  
+            }  
+  
+            return data;  
+        }  
+  
+        object DeserializeObject(NetDataContractSerializer serializer, XmlElement element)  
+        {  
+            object deserializedObject = null;  
+  
+            MemoryStream stm = new MemoryStream();  
+            XmlDictionaryWriter wtr = XmlDictionaryWriter.CreateTextWriter(stm);  
+            element.WriteContentTo(wtr);  
+            wtr.Flush();  
+            stm.Position = 0;  
+  
+            deserializedObject = serializer.Deserialize(stm);  
+  
+            return deserializedObject;  
+        }  
+  
+        //Saves the persistence data to an xml file.  
+        void Save(IDictionary<XName, InstanceValue> instanceData)  
+        {  
+            string fileName = IOHelper.GetFileName(this.ownerInstanceID);  
+            XmlDocument doc = new XmlDocument();  
+            doc.LoadXml("<InstanceValues/>");  
+  
+            foreach (KeyValuePair<XName,InstanceValue> valPair in instanceData)  
+            {  
+                XmlElement newInstance = doc.CreateElement("InstanceValue");  
+  
+                XmlElement newKey = SerializeObject("key", valPair.Key, doc);  
+                newInstance.AppendChild(newKey);  
+  
+                XmlElement newValue = SerializeObject("value", valPair.Value.Value, doc);  
+                newInstance.AppendChild(newValue);  
+  
+                doc.DocumentElement.AppendChild(newInstance);  
+            }  
+            doc.Save(fileName);  
+       }  
+  
+        XmlElement SerializeObject(string elementName, object o, XmlDocument doc)  
+        {  
+            NetDataContractSerializer s = new NetDataContractSerializer();  
+            XmlElement newElement = doc.CreateElement(elementName);  
+            MemoryStream stm = new MemoryStream();  
+  
+            s.Serialize(stm, o);  
+            stm.Position = 0;  
+            StreamReader rdr = new StreamReader(stm);  
+            newElement.InnerXml = rdr.ReadToEnd();  
+  
+            return newElement;  
+        }  
+    }  
+}  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-custom-persistence-participant.md b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-persistence-participant.md
new file mode 100644
index 00000000000..ee6fccd0100
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-persistence-participant.md
@@ -0,0 +1,59 @@
+---
+title: "カスタム永続参加要素を作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1d9cc47a-8966-4286-94d5-4221403d9c06
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# カスタム永続参加要素を作成する方法
+次の手順では、永続参加要素を作成します。永続参加要素の実装例については、「[永続への参加](http://go.microsoft.com/fwlink/?LinkID=177735)」のサンプルと「[ストア拡張](../../../docs/framework/windows-workflow-foundation//store-extensibility.md)」を参照してください。  
+  
+1.  <xref:System.Activities.Persistence.PersistenceParticipant> または <xref:System.Activities.Persistence.PersistenceIOParticipant> クラスから派生するクラスを作成します。PersistenceIOParticipant クラスには、IO 操作に参加できることに加え、PersistenceParticipant クラスと同じ拡張ポイントが備わっています。次のうち、必要な手順を行います。  
+  
+2.  <xref:System.Activities.Persistence.PersistenceParticipant.CollectValues%2A> メソッドを実装します。**CollectValues** メソッドには、2 つのディクショナリ パラメーターがあります。1 つは、読み取り\/書き込み可能な値を格納するパラメーターで、もう 1 つは書き込み専用の値を格納するパラメーターです \(後でクエリで使用します\)。このメソッドでは、永続参加要素に固有のデータをこれらのディクショナリに設定する必要があります。各ディクショナリには、値の名前がキーとして格納されているほか、値そのものが <xref:System.Runtime.DurableInstancing.InstanceValue> オブジェクトとして格納されています。  
+  
+     readWriteValues ディクショナリの値は、**InstanceValue** オブジェクトとしてパッケージ化されています。書き込み専用のディクショナリの値は、InstanceValueOptions.Optional および InstanceValueOption.WriteOnly セットで **InstanceValue** オブジェクトとしてパッケージ化されています。すべての永続参加要素について **CollectValues** の実装によって形成される各 **InstanceValue** の名前は一意である必要があります。  
+  
+    ```  
+    protected virtual void CollectValues (out IDictionary<XName,Object> readWriteValues, out IDictionary<XName,Object> writeOnlyValues)  
+  
+    ```  
+  
+3.  <xref:System.Activities.Persistence.PersistenceParticipant.MapValues%2A> メソッドを実装します。**MapValues** メソッドが受け取る 2 つのパラメーターは、**CollectValues** メソッドが受け取るパラメーターと似ています。**CollectValues** の段階で収集されるすべての値は、これらのディクショナリ パラメーターを通じて渡されます。**MapValues** の段階で追加される新しい値は、書き込み専用の値に追加されます。書き込み専用のディクショナリが、直接インスタンスの値に関連付けられていない外部ソースにデータを提供するために使用されます。すべての永続参加要素について **MapValues** メソッドの実装によって形成されるそれぞれの値の名前は一意である必要があります。  
+  
+    ```  
+    protected virtual IDictionary<XName,Object> MapValues (IDictionary<XName,Object> readWriteValues,IDictionary<XName,Object> writeOnlyValues)  
+    ```  
+  
+     <xref:System.Activities.Persistence.PersistenceParticipant.MapValues%2A> メソッドは <xref:System.Activities.Persistence.PersistenceParticipant.CollectValues%2A> が提供しない機能を提供し、<xref:System.Activities.Persistence.PersistenceParticipant.CollectValues%2A> が処理しなかった別の永続参加により提供される、別の値への依存関係が許可されます。  
+  
+4.  **PublishValues** メソッドを実装します。**PublishValues** メソッドは、永続ストアから読み込まれた値をすべて含むディクショナリを受け取ります。  
+  
+    ```  
+    protected virtual void PublishValues (IDictionary<XName,Object> readWriteValues)  
+  
+    ```  
+  
+5.  参加要素が永続 IO 参加要素である場合、**BeginOnSave** メソッドを実装します。このメソッドは保存操作中に呼び出されます。このメソッドでは、永続化 \(保存\) しているワークフロー インスタンスに付随する IO を実行する必要があります。ホストが、対応する永続化コマンドのトランザクションを使用している場合、同じトランザクションが Transaction.Current で確立されます。さらに、PersistenceIOParticipant はトランザクションの一貫性の要件を通知することがあります。この場合、ホストはほかに使用されなければ、永続化のトランザクションを作成します。  
+  
+    ```  
+  
+    protected virtual IAsyncResult BeginOnSave (IDictionary<XName,Object> readWriteValues, IDictionary<XName,Object> writeOnlyValues, TimeSpan timeout, AsyncCallback callback, Object state)  
+    ```  
+  
+6.  参加要素が永続 IO 参加要素である場合、**BeginOnLoad** メソッドを実装します。このメソッドは読み込み操作中に呼び出されます。このメソッドでは、ワークフロー インスタンスの読み込みに付随する IO を実行する必要があります。ホストが、対応する永続化コマンドのトランザクションを使用している場合、同じトランザクションが Transaction.Current で確立されます。さらに、PersistenceIOParticipant はトランザクションの一貫性の要件を通知することがあります。この場合、ホストはほかに使用されなければ、永続化のトランザクションを作成します。  
+  
+    ```  
+  
+    protected virtual IAsyncResult BeginOnLoad (IDictionary<XName,Object> readWriteValues, TimeSpan timeout, AsyncCallback callback, Object state)  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-custom-tracking-participant.md b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-tracking-participant.md
new file mode 100644
index 00000000000..a24360dbe76
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-custom-tracking-participant.md
@@ -0,0 +1,351 @@
+---
+title: "カスタム追跡参加要素を作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b612c7e-2381-4a7c-b07a-77030415f2a3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# カスタム追跡参加要素を作成する方法
+ワークフロー追跡により、ワークフロー実行の状態が視覚的に示されます。ワークフロー ランタイムによって、ワークフローのライフサイクル イベント、アクティビティのライフサイクル イベント、ブックマークの再開、およびエラーについて説明する追跡レコードが出力されます。これらの追跡レコードは、追跡参加要素によって使用されます。[!INCLUDE[wf](../../../includes/wf-md.md)] には、追跡レコードを Event Tracing for Windows \(ETW\) イベントとして書き込む標準の追跡参加要素が含まれています。これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。チュートリアルのこの手順では、`WriteLine` アクティビティの出力をキャプチャするカスタム追跡参加要素と追跡プロファイルを作成して、ユーザーに表示できるようにする方法について説明します。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。このトピックを完了する前に、これまでのトピックを完了する必要があります。チュートリアルの完成版をダウンロードしたり、チュートリアルのビデオを閲覧したりするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+## このトピックの内容  
+  
+-   [カスタム追跡参加要素を作成するには](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md#BKMK_CustomTrackingParticipant)  
+  
+-   [追跡プロファイルを作成して追跡参加要素を登録するには](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md#BKMK_TrackingProfile)  
+  
+-   [追跡情報を表示するには](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md#BKMK_DisplayTracking)  
+  
+-   [アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md#BKMK_BuildAndRun)  
+  
+###  <a name="BKMK_CustomTrackingParticipant"></a> カスタム追跡参加要素を作成するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowHost** を右クリックし、**\[追加\]** をポイントして、**\[クラス\]** をクリックします。**\[名前\]** ボックスに「`StatusTrackingParticipant`」と入力し、**\[追加\]** をクリックします。  
+  
+2.  次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Activities.Tracking  
+    Imports System.IO  
+    ```  
+  
+    ```csharp  
+    using System.Activities.Tracking;  
+    using System.IO;  
+    ```  
+  
+3.  `StatusTrackingParticipant` クラスを変更して、`TrackingParticipant` から継承されるようにします。  
+  
+    ```vb  
+    Public Class StatusTrackingParticipant  
+        Inherits TrackingParticipant  
+  
+    End Class  
+    ```  
+  
+    ```csharp  
+    class StatusTrackingParticipant : TrackingParticipant  
+    {  
+    }  
+    ```  
+  
+4.  次の `Track` メソッド オーバーライドを追加します。追跡レコードには、いくつかの種類があります。ここでは、アクティビティ追跡レコードに含まれる `WriteLine` アクティビティの出力に注目します。`TrackingRecord` が `WriteLine` アクティビティの `ActivityTrackingRecord` である場合は、ワークフローの `InstanceId` に基づいた名前の付いたファイルに `WriteLine` の `Text` が追加されます。このチュートリアルでは、ファイルはホスト アプリケーションの現在のフォルダーに保存されます。  
+  
+    ```vb  
+    Protected Overrides Sub Track(record As TrackingRecord, timeout As TimeSpan)  
+        Dim asr As ActivityStateRecord = TryCast(record, ActivityStateRecord)  
+  
+        If Not asr Is Nothing Then  
+            If asr.State = ActivityStates.Executing And _  
+            asr.Activity.TypeName = "System.Activities.Statements.WriteLine" Then  
+  
+                'Append the WriteLine output to the tracking  
+                'file for this instance.  
+                Using writer As StreamWriter = File.AppendText(record.InstanceId.ToString())  
+                    writer.WriteLine(asr.Arguments("Text"))  
+                    writer.Close()  
+                End Using  
+            End If  
+        End If  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    protected override void Track(TrackingRecord record, TimeSpan timeout)  
+    {  
+        ActivityStateRecord asr = record as ActivityStateRecord;  
+  
+        if (asr != null)  
+        {  
+            if (asr.State == ActivityStates.Executing &&  
+                asr.Activity.TypeName == "System.Activities.Statements.WriteLine")  
+            {  
+                // Append the WriteLine output to the tracking  
+                // file for this instance  
+                using (StreamWriter writer = File.AppendText(record.InstanceId.ToString()))  
+                {  
+                    writer.WriteLine(asr.Arguments["Text"]);  
+                    writer.Close();  
+                }  
+            }  
+        }  
+    }  
+    ```  
+  
+     追跡プロファイルを指定しない場合は、既定の追跡プロファイルが使用されます。既定の追跡プロファイルを使用する場合は、すべての `ActivityStates` に関する追跡レコードが出力されます。ここでは、`WriteLine` アクティビティのライフサイクル中に 1 回だけテキストをキャプチャする必要があるため、`ActivityStates.Executing` 状態からテキストを抽出するだけです。「[追跡プロファイルを作成して追跡参加要素を登録するには](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md#BKMK_TrackingProfile)」では、`WriteLine` `ActivityStates.Executing` の追跡レコードのみが出力されるように指定する追跡プロファイルを作成します。  
+  
+###  <a name="BKMK_TrackingProfile"></a> 追跡プロファイルを作成して追跡参加要素を登録するには  
+  
+1.  **ソリューション エクスプローラー**で **WorkflowHostForm** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Activities.Tracking  
+    ```  
+  
+    ```csharp  
+    using System.Activities.Tracking;  
+    ```  
+  
+3.  ワークフロー拡張機能に `StringWriter` を追加するコードの直後で、ワークフロー ライフサイクル ハンドラーの前に、`ConfigureWorkflowApplication` に次のコードを追加します。  
+  
+    ```vb  
+    'Add the custom tracking participant with a tracking profile  
+    'that only emits tracking records for WriteLine activities.  
+    Dim query As New ActivityStateQuery()  
+    query.ActivityName = "WriteLine"  
+    query.States.Add(ActivityStates.Executing)  
+    query.Arguments.Add("Text")  
+  
+    Dim profile As New TrackingProfile()  
+    profile.Queries.Add(query)  
+  
+    Dim stp As New StatusTrackingParticipant()  
+    stp.TrackingProfile = profile  
+  
+    wfApp.Extensions.Add(stp)  
+    ```  
+  
+    ```csharp  
+    // Add the custom tracking participant with a tracking profile  
+    // that only emits tracking records for WriteLine activities.  
+    StatusTrackingParticipant stp = new StatusTrackingParticipant  
+    {  
+        TrackingProfile = new TrackingProfile  
+        {  
+            Queries =   
+            {  
+                new ActivityStateQuery  
+                {  
+                    ActivityName = "WriteLine",  
+                    States = { ActivityStates.Executing },  
+                    Arguments = { "Text" }  
+                }  
+            }  
+        }  
+    };  
+  
+    wfApp.Extensions.Add(stp);  
+    ```  
+  
+     この追跡プロファイルでは、`Executing` 状態の `WriteLine` アクティビティのアクティビティ状態レコードのみがカスタム追跡参加要素に出力されるように指定します。  
+  
+     このコードを追加した後、`ConfigureWorkflowApplication` の先頭は次の例のようになります。  
+  
+    ```vb  
+    Private Sub ConfigureWorkflowApplication(wfApp As WorkflowApplication)  
+        'Configure the persistence store.  
+        wfApp.InstanceStore = store  
+  
+        'Add a StringWriter to the extensions. This captures the output  
+        'from the WriteLine activities so we can display it in the form.  
+        Dim sw As New StringWriter()  
+        wfApp.Extensions.Add(sw)  
+  
+        'Add the custom tracking participant with a tracking profile  
+        'that only emits tracking records for WriteLine activities.  
+        Dim query As New ActivityStateQuery()  
+        query.ActivityName = "WriteLine"  
+        query.States.Add(ActivityStates.Executing)  
+        query.Arguments.Add("Text")  
+  
+        Dim profile As New TrackingProfile()  
+        profile.Queries.Add(query)  
+  
+        Dim stp As New StatusTrackingParticipant()  
+        stp.TrackingProfile = profile  
+  
+        wfApp.Extensions.Add(stp)  
+  
+        'Workflow lifecycle handlers...  
+    ```  
+  
+    ```csharp  
+    private void ConfigureWorkflowApplication(WorkflowApplication wfApp)  
+    {  
+        // Configure the persistence store.  
+        wfApp.InstanceStore = store;  
+  
+        // Add a StringWriter to the extensions. This captures the output  
+        // from the WriteLine activities so we can display it in the form.  
+        StringWriter sw = new StringWriter();  
+        wfApp.Extensions.Add(sw);  
+  
+        // Add the custom tracking participant with a tracking profile  
+        // that only emits tracking records for WriteLine activities.  
+        StatusTrackingParticipant stp = new StatusTrackingParticipant  
+        {  
+            TrackingProfile = new TrackingProfile  
+            {  
+                Queries =   
+                {  
+                    new ActivityStateQuery  
+                    {  
+                        ActivityName = "WriteLine",  
+                        States = { ActivityStates.Executing },  
+                        Arguments = { "Text" }  
+                    }  
+                }  
+            }  
+        };  
+  
+        wfApp.Extensions.Add(stp);  
+  
+        // Workflow lifecycle handlers...  
+    ```  
+  
+###  <a name="BKMK_DisplayTracking"></a> 追跡情報を表示するには  
+  
+1.  **ソリューション エクスプローラー**で **WorkflowHostForm** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `InstanceId_SelectedIndexChanged` ハンドラーで、ステータス ウィンドウをクリアするコードの直後に次のコードを追加します。  
+  
+    ```vb  
+    'If there is tracking data for this workflow, display it  
+    'in the status window.  
+    If File.Exists(WorkflowInstanceId.ToString()) Then  
+        Dim status As String = File.ReadAllText(WorkflowInstanceId.ToString())  
+        UpdateStatus(status)  
+    End If  
+    ```  
+  
+    ```csharp  
+    // If there is tracking data for this workflow, display it  
+    // in the status window.  
+    if (File.Exists(WorkflowInstanceId.ToString()))  
+    {  
+        string status = File.ReadAllText(WorkflowInstanceId.ToString());  
+        UpdateStatus(status);  
+    }  
+    ```  
+  
+     ワークフローの一覧で新しいワークフローを選択すると、そのワークフローの追跡レコードがステータス ウィンドウに読み込まれて表示されます。完成した `InstanceId_SelectedIndexChanged` ハンドラーは次のようになります。  
+  
+    ```vb  
+    Private Sub InstanceId_SelectedIndexChanged(sender As Object, e As EventArgs) Handles InstanceId.SelectedIndexChanged  
+        If InstanceId.SelectedIndex = -1 Then  
+            Return  
+        End If  
+  
+        'Clear the status window.  
+        WorkflowStatus.Clear()  
+  
+        'If there is tracking data for this workflow, display it  
+        'in the status window.  
+        If File.Exists(WorkflowInstanceId.ToString()) Then  
+            Dim status As String = File.ReadAllText(WorkflowInstanceId.ToString())  
+            UpdateStatus(status)  
+        End If  
+  
+        'Get the workflow version and display it.  
+        'If the workflow is just starting then this info will not  
+        'be available in the persistence store so do not try and retrieve it.  
+        If Not WorkflowStarting Then  
+            Dim instance As WorkflowApplicationInstance = _  
+                WorkflowApplication.GetInstance(WorkflowInstanceId, store)  
+  
+            WorkflowVersion.Text = _  
+                WorkflowVersionMap.GetIdentityDescription(instance.DefinitionIdentity)  
+  
+            'Unload the instance.  
+            instance.Abandon()  
+        End If  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void InstanceId_SelectedIndexChanged(object sender, EventArgs e)  
+    {  
+        if (InstanceId.SelectedIndex == -1)  
+        {  
+            return;  
+        }  
+  
+        // Clear the status window.  
+        WorkflowStatus.Clear();  
+  
+        // If there is tracking data for this workflow, display it  
+        // in the status window.  
+        if (File.Exists(WorkflowInstanceId.ToString()))  
+        {  
+            string status = File.ReadAllText(WorkflowInstanceId.ToString());  
+            UpdateStatus(status);  
+        }  
+  
+        // Get the workflow version and display it.  
+        // If the workflow is just starting then this info will not  
+        // be available in the persistence store so do not try and retrieve it.  
+        if (!WorkflowStarting)  
+        {  
+            WorkflowApplicationInstance instance =  
+                WorkflowApplication.GetInstance(this.WorkflowInstanceId, store);  
+  
+            WorkflowVersion.Text =  
+                WorkflowVersionMap.GetIdentityDescription(instance.DefinitionIdentity);  
+  
+            // Unload the instance.  
+            instance.Abandon();  
+        }  
+    }  
+  
+    ```  
+  
+###  <a name="BKMK_BuildAndRun"></a> アプリケーションをビルドして実行するには  
+  
+1.  Ctrl キーと Shift キーを押しながら B キーを押してアプリケーションをビルドします。  
+  
+2.  Ctrl キーを押しながら F5 キーを押してアプリケーションを起動します。  
+  
+3.  推測ゲームの範囲と開始するワークフローの種類を選択し、**\[New Game\]** をクリックします。**\[Guess\]** ボックスに推定値を入力し、**\[Go\]** をクリックして推定値を送信します。ワークフローの状態がステータス ウィンドウに表示されます。この出力は、`WriteLine` アクティビティからキャプチャされます。**\[Workflow Instance Id\]** ボックスの一覧で別のワークフローを選択してそのワークフローに切り替えて、現在のワークフローの状態が削除されることを確認します。以前のワークフローに戻して、次の例のように、状態が復元されることを確認します。  
+  
+    > [!NOTE]
+    >  追跡が有効になる前に開始されたワークフローに切り替えた場合、状態は表示されません。ただし、推定値を追加すると、この時点では追跡が有効になっているため、その状態が保存されます。  
+  
+ **Please enter a number between 1 and 10**   
+**Your guess is too high.**   
+**Please enter a number between 1 and 10**    
+    > [!NOTE]
+    >  この情報は、乱数の範囲を決定する場合に役立ちますが、これまでに作成された推定値に関する情報を含んでいません。この情報については、次の手順「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で説明します。  
+  
+     ワークフロー インスタンス ID を書き留め、ゲームを最後まで実行します。  
+  
+4.  エクスプローラーを開き、**NumberGuessWorkflowHost\\bin\\debug** フォルダー \(プロジェクトの設定によっては **bin\\release**\) に移動します。プロジェクトの実行可能ファイルに加え、GUID ファイル名が付いたファイルがあることに注意します。前の手順で完了したワークフローのワークフロー インスタンス ID に対応するファイルを特定してメモ帳で開きます。追跡情報は、次のような情報が含まれています。  
+  
+ **Please enter a number between 1 and 10**   
+**Your guess is too high.**   
+**Please enter a number between 1 and 10**   
+**Your guess is too high.**   
+**Please enter a number between 1 and 10**      この追跡データには、ユーザーの推定値だけでなく、ワークフローの最後の推定値に関する情報も含まれていません。これは、追跡情報がワークフローからの `WriteLine` 出力のみで構成されており、表示される最後のメッセージがワークフロー完了後に `Completed` ハンドラーから表示されるためです。チュートリアルの次の手順「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」では、ユーザーの推定値が表示されるように既存の `WriteLine` アクティビティを変更し、最終結果を表示する新しい `WriteLine` アクティビティを追加します。これらの変更を統合した後、「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」では、ワークフローの複数のバージョンを同時にホストする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-flowchart-workflow.md b/docs/framework/windows-workflow-foundation/how-to-create-a-flowchart-workflow.md
new file mode 100644
index 00000000000..9de622e4ae7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-flowchart-workflow.md
@@ -0,0 +1,162 @@
+---
+title: "フローチャート ワークフローを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 185d7aea-68a6-4bd8-adde-45050f33170a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# フローチャート ワークフローを作成する方法
+ワークフローは、ビルトイン アクティビティおよびカスタム アクティビティから構築できます。このトピックでは、<xref:System.Activities.Statements.Flowchart> アクティビティなどのビルトイン アクティビティ、および前の「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」トピックのカスタム アクティビティの両方を使用するワークフローを作成します。このワークフローは、数値推測ゲームをモデル化しています。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。このトピックを完了する前に、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」を完了する必要があります。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+### ワークフローを作成するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowActivities** を右クリックし、**\[追加\]** をポイントして、**\[新しい項目\]** をクリックします。  
+  
+2.  **\[インストール済み\]** の **\[共通項目\]** ノードで、**\[ワークフロー\]** を選択します。**\[ワークフロー\]** リストで **\[アクティビティ\]** を選択します。  
+  
+3.  **\[名前\]** ボックスに「`FlowchartNumberGuessWorkflow`」と入力し、**\[追加\]** をクリックします。  
+  
+4.  **ツールボックス**の **\[フローチャート\]** セクションから **Flowchart** アクティビティをドラッグし、ワークフロー デザイン サーフェイスの **\[ここにアクティビティをドロップ\]** ラベルの上にドロップします。  
+  
+### ワークフロー変数および引数を作成するには  
+  
+1.  **FlowchartNumberGuessWorkflow.xaml** がまだ表示されていない場合は、**ソリューション エクスプローラー**でダブルクリックして、デザイナーにワークフローを表示します。  
+  
+2.  ワークフロー デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを表示します。  
+  
+3.  **\[引数の作成\]** をクリックします。  
+  
+4.  **\[名前\]** ボックスに「`MaxNumber`」と入力し、**\[方向\]** ボックスで **\[IN\]** を選択して、**\[引数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して引数を保存します。  
+  
+5.  **\[引数の作成\]** をクリックします。  
+  
+6.  新しく追加した `MaxNumber` 引数の下にある **\[名前\]** ボックスに「`Turns`」と入力し、**\[方向\]** ボックスで **\[OUT\]** を選択して、**\[引数の型\]** ドロップダウン リストで **\[Int32\]** を選択し、Enter キーを押します。  
+  
+7.  アクティビティ デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを閉じます。  
+  
+8.  ワークフロー デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを表示します。  
+  
+9. **\[変数の作成\]** をクリックします。  
+  
+    > [!TIP]
+    >  **\[変数の作成\]** ボックスが表示されていない場合は、ワークフロー デザイナー画面の <xref:System.Activities.Statements.Flowchart> アクティビティをクリックして選択します。  
+  
+10. **\[名前\]** ボックスに「`Guess`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+11. **\[変数の作成\]** をクリックします。  
+  
+12. **\[名前\]** ボックスに「`Target`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+13. アクティビティ デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを閉じます。  
+  
+### ワークフロー アクティビティを追加するには  
+  
+1.  **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、フローチャートの上部にある **Start** ノード上に置きます。**Assign** アクティビティが **Start** ノード上にあるときに、3 個の三角形が **Start** ノードの周囲に表示されます。**Assign** アクティビティを **Start** ノードのすぐ下にある三角形の上にドロップします。これにより 2 つのアイテムがリンクされ、**Assign** アクティビティがフローチャート内の最初のアクティビティとして指定されます。  
+  
+    > [!NOTE]
+    >  アクティビティは、開始ノードに手動でリンクすることにより、ワークフローの開始アクティビティとして指定することもできます。これを行うには、**Start** ノードをポイントし、**Start** ノードをポイントすると表示される四角形の 1 つをクリックして、目的のアクティビティに線を接続するようにマウスをドラッグし、表示される四角形の 1 つにドロップします。また、アクティビティを右クリックして **\[StartNode として設定\]** を選択して、アクティビティを開始アクティビティとして指定することもできます。  
+  
+2.  **\[終端側\]** ボックスに「`Target`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに次の式を入力します。  
+  
+    ```vb  
+    New System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    ```csharp  
+    new System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    > [!TIP]
+    >  **\[ツールボックス\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+3.  **ツールボックス**の **\[NumberGuessWorkflowActivities\]** セクションから **Prompt** アクティビティをドラッグし、前の手順でドロップした **Assign** アクティビティの下にドロップして、**Prompt** アクティビティを **Assign** アクティビティに接続します。2 つのアクティビティを接続する方法は 3 種類あります。1 つ目の方法では、**Prompt** アクティビティをワークフロー上にドロップするときにアクティビティを接続します。ワークフローに **Prompt** アクティビティをドラッグするときに、**Assign** アクティビティ上にマウス ポインターを置き、**Prompt** アクティビティが **Assign** のアクティビティ上にあるときに表示される 4 つの三角形の 1 つにドロップします。2 つ目の方法では、ワークフローの希望する位置に **Prompt** アクティビティをドロップします。その後、**Assign** アクティビティにマウス ポインターを置き、表示される四角形の 1 つを **Prompt** アクティビティにドラッグします。**Assign** アクティビティから **Prompt** アクティビティの四角形の 1 つに線を接続するようにマウスをドラッグし、マウスのボタンを離します。3 つ目の方法は 1 つ目の方法とよく似ていますが、**Prompt** アクティビティを**ツールボックス**からドラッグする代わりに、ワークフロー デザイン サーフェイス上のその位置からドラッグし、マウス ポインターを **Assign** アクティビティ上に移動して、表示される三角形の 1 つにドロップします。  
+  
+4.  **Prompt** アクティビティの **\[プロパティ\] ウィンドウ**で、**\[BookmarkName\]** プロパティ値ボックスに「`"EnterGuess"`」\(引用符を含む\) と入力します。**\[Result\]** プロパティ値ボックスに「`Guess`」と入力し、**\[Text\]** プロパティ ボックスに次の式を入力します。  
+  
+    ```vb  
+    "Please enter a number between 1 and " & MaxNumber  
+    ```  
+  
+    ```csharp  
+    "Please enter a number between 1 and " + MaxNumber  
+    ```  
+  
+    > [!TIP]
+    >  **\[プロパティ\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** を選択します。  
+  
+5.  **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、前の手順で説明した方法のいずれかを使用して、このアクティビティが **Prompt** アクティビティの下になるように接続します。  
+  
+6.  **\[終端側\]** ボックスに「`Turns`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに「`Turns + 1`」と入力します。  
+  
+7.  **ツールボックス**の **\[フローチャート\]** セクションから **FlowDecision** をドラッグし、**Assign** アクティビティの下に接続します。**\[プロパティ\]** ウィンドウで、**\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    Guess = Target  
+    ```  
+  
+    ```csharp  
+    Guess == Target  
+    ```  
+  
+8.  **\[ツールボックス\]** から別の **FlowDecision** アクティビティをドラッグし、最初のアクティビティの下にドロップします。2 つのアクティビティを接続するには、上部の **FlowDecision** アクティビティにある **\[False\]** という四角形から、2 番目の **FlowDecision** アクティビティの上部にある四角形までドラッグします。  
+  
+    > [!TIP]
+    >  **FlowDecision** 上に **\[True\]** および **\[False\]** というラベルが表示されない場合は、**FlowDecision** にマウス ポインターを置きます。  
+  
+9. 2 番目の **FlowDecision** アクティビティをクリックして選択します。**\[プロパティ\]** ウィンドウで、**\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    Guess < Target  
+    ```  
+  
+10. **\[ツールボックス\]** の **\[プリミティブ\]** セクションから 2 つの **WriteLine** アクティビティをドラッグし、2 つの **FlowDecision** アクティビティの下に並べるようにドロップします。下部の **FlowDecision** アクティビティの **True** アクションを最も左の **WriteLine** に接続し、**False** アクションを最も右の **WriteLine** に接続します。  
+  
+11. 最も左の **WriteLine** アクティビティをクリックし、**\[プロパティ\]** ウィンドウの **\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    "Your guess is too low."  
+    ```  
+  
+12. その上にある **Prompt** アクティビティの左側に **WriteLine** を接続します。  
+  
+13. 最も右の **WriteLine** アクティビティをクリックし、**\[プロパティ\]** ウィンドウの **\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    "Your guess is too high."  
+    ```  
+  
+14. その上にある **Prompt** アクティビティの右側に **WriteLine** アクティビティを接続します。  
+  
+     次の例は完成したワークフローを示しています。  
+  
+     ![完成した Windows Workflow Foundation](../../../docs/framework/windows-workflow-foundation//media/gettingstartedtutorialcompletedflowchart.PNG "GettingStartedTutorialCompletedFlowchart")  
+  
+### ワークフローをビルドするには  
+  
+1.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+     ワークフローを実行する手順については、次のトピック「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」を参照してください。「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の手順を別のスタイルのワークフローを使用して既に完了している場合に、この手順のフローチャート ワークフローを使用して実行するには、「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の「[アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md#BKMK_ToRunTheApplication)」に進んでください。  
+  
+## 参照  
+ <xref:System.Activities.Statements.Flowchart>   
+ <xref:System.Activities.Statements.FlowDecision>   
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)   
+ [ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)   
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)   
+ [アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)   
+ [ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-sequential-workflow.md b/docs/framework/windows-workflow-foundation/how-to-create-a-sequential-workflow.md
new file mode 100644
index 00000000000..eb2fefa9428
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-sequential-workflow.md
@@ -0,0 +1,169 @@
+---
+title: "シーケンシャル ワークフローを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5280e816-ae17-48c4-8de0-a1e6895dd8f0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# シーケンシャル ワークフローを作成する方法
+ワークフローは、ビルトイン アクティビティおよびカスタム アクティビティから構築できます。このトピックでは、<xref:System.Activities.Statements.Sequence> アクティビティなどのビルトイン アクティビティ、および前の「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」トピックのカスタム アクティビティの両方を使用するワークフローを作成します。このワークフローは、数値推測ゲームをモデル化しています。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。このトピックを完了する前に、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」を完了する必要があります。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+### ワークフローを作成するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowActivities** を右クリックし、**\[追加\]** をポイントして、**\[新しい項目\]** をクリックします。  
+  
+2.  **\[インストール済み\]** の **\[共通項目\]** ノードで、**\[ワークフロー\]** を選択します。**\[ワークフロー\]** リストで **\[アクティビティ\]** を選択します。  
+  
+3.  **\[名前\]** ボックスに「`SequentialNumberGuessWorkflow`」と入力し、**\[追加\]** をクリックします。  
+  
+4.  **ツールボックス**の **\[制御フロー\]** セクションから **Sequence** アクティビティをドラッグし、ワークフロー デザイン サーフェイスの **\[ここにアクティビティをドロップ\]** ラベルの上にドロップします。  
+  
+### ワークフロー変数および引数を作成するには  
+  
+1.  **ソリューション エクスプローラー**で **SequentialNumberGuessWorkflow.xaml** をダブルクリックし、デザイナーにワークフローを表示します \(まだ表示されていない場合\)。  
+  
+2.  ワークフロー デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを表示します。  
+  
+3.  **\[引数の作成\]** をクリックします。  
+  
+4.  **\[名前\]** ボックスに「`MaxNumber`」と入力し、**\[方向\]** ボックスで **\[IN\]** を選択して、**\[引数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して引数を保存します。  
+  
+5.  **\[引数の作成\]** をクリックします。  
+  
+6.  新しく追加した `MaxNumber` 引数の下にある **\[名前\]** ボックスに「`Turns`」と入力し、**\[方向\]** ボックスで **\[OUT\]** を選択して、**\[引数の型\]** ドロップダウン リストで **\[Int32\]** を選択し、Enter キーを押します。  
+  
+7.  アクティビティ デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを閉じます。  
+  
+8.  ワークフロー デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを表示します。  
+  
+9. **\[変数の作成\]** をクリックします。  
+  
+    > [!TIP]
+    >  **\[変数の作成\]** ボックスが表示されていない場合は、ワークフロー デザイナー画面の **Sequence** アクティビティをクリックして選択します。  
+  
+10. **\[名前\]** ボックスに「`Guess`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+11. **\[変数の作成\]** をクリックします。  
+  
+12. **\[名前\]** ボックスに「`Target`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+13. アクティビティ デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを閉じます。  
+  
+### ワークフロー アクティビティを追加するには  
+  
+1.  **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、**Sequence** アクティビティにドロップします。**\[終端側\]** ボックスに「`Target`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに次の式を入力します。  
+  
+    ```vb  
+    New System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    ```csharp  
+    new System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    > [!TIP]
+    >  **\[ツールボックス\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+2.  **ツールボックス**の **\[制御フロー\]** セクションから **DoWhile** アクティビティをドラッグし、ワークフロー上の **Assign** アクティビティの下にドロップします。  
+  
+3.  **DoWhile** アクティビティの **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    Guess <> Target  
+    ```  
+  
+    ```csharp  
+    Guess != Target  
+    ```  
+  
+     <xref:System.Activities.Statements.DoWhile> アクティビティはその子アクティビティを実行し、その <xref:System.Activities.Statements.DoWhile.Condition%2A> を評価します。<xref:System.Activities.Statements.DoWhile.Condition%2A> が `True` と評価される場合、<xref:System.Activities.Statements.DoWhile> 内のアクティビティが再度実行されます。この例では、ユーザーの推定値が評価され、推定値が正しいと判断されるまで <xref:System.Activities.Statements.DoWhile> が続行されます。  
+  
+4.  **ツールボックス**の **\[NumberGuessWorkflowActivities\]** セクションから **Prompt** アクティビティをドラッグし、前の手順の **DoWhile** アクティビティの下にドロップします。  
+  
+5.  **\[プロパティ\] ウィンドウ**で、**Prompt** アクティビティの **\[BookmarkName\]** プロパティ値ボックスに「`"EnterGuess"`」\(引用符を含む\) と入力します。**\[Result\]** プロパティ値ボックスに「`Guess`」と入力し、**\[Text\]** プロパティ ボックスに次の式を入力します。  
+  
+    ```vb  
+    "Please enter a number between 1 and " & MaxNumber  
+    ```  
+  
+    ```csharp  
+    "Please enter a number between 1 and " + MaxNumber  
+    ```  
+  
+    > [!TIP]
+    >  **\[プロパティ\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** を選択します。  
+  
+6.  **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、**Prompt** アクティビティの後になるように **DoWhile** アクティビティ内にドロップします。  
+  
+    > [!NOTE]
+    >  **Assign** アクティビティをドロップするときに、ワークフロー デザイナーによって、**Prompt** アクティビティと新しく追加した **Assign** アクティビティの両方を含む **Sequence** アクティビティが自動的に追加されることに注意してください。  
+  
+7.  **\[終端側\]** ボックスに「`Turns`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに「`Turns + 1`」と入力します。  
+  
+8.  **ツールボックス**の **\[制御フロー\]** セクションから **If** アクティビティをドラッグし、新しく追加した **Assign** アクティビティの後になるように **Sequence** アクティビティ内にドロップします。  
+  
+9. **If** アクティビティの **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    Guess <> Target  
+    ```  
+  
+    ```csharp  
+    Guess != Target  
+    ```  
+  
+10. **ツールボックス**の **\[制御フロー\]** セクションから **If** アクティビティをドラッグし、最初の **If** アクティビティの **Then** セクションにドロップします。  
+  
+11. 新しく追加した **If** アクティビティの **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    Guess < Target  
+    ```  
+  
+12. **ツールボックス**の **\[プリミティブ\]** セクションから 2 つの **WriteLine** アクティビティをドラッグし、1 つは新しく追加した **If** アクティビティの **Then** セクション内に、もう 1 つは **Else** セクション内に配置されるようにドロップします。  
+  
+13. **Then** セクションの **WriteLine** アクティビティをクリックして選択し、**\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    "Your guess is too low."  
+    ```  
+  
+14. **Else** セクションの **WriteLine** アクティビティをクリックして選択し、**\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    "Your guess is too high."  
+    ```  
+  
+     次の例は完成したワークフローを示しています。  
+  
+     ![完成したシーケンシャル ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wfsequentialgettingstartedtutorialcomplete.JPG "WFSequentialGettingStartedTutorialComplete")  
+  
+### ワークフローをビルドするには  
+  
+1.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+     ワークフローを実行する手順については、次のトピック「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」を参照してください。「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の手順を別のスタイルのワークフローを使用して既に完了している場合に、この手順のシーケンシャル ワークフローを使用して実行するには、「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の「[アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md#BKMK_ToRunTheApplication)」に進んでください。  
+  
+## 参照  
+ <xref:System.Activities.Statements.Flowchart>   
+ <xref:System.Activities.Statements.FlowDecision>   
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)   
+ [ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)   
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)   
+ [アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)   
+ [ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-state-machine-workflow.md b/docs/framework/windows-workflow-foundation/how-to-create-a-state-machine-workflow.md
new file mode 100644
index 00000000000..f3e869d26e9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-state-machine-workflow.md
@@ -0,0 +1,199 @@
+---
+title: "方法: ステート マシン ワークフローを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3ec60e8f-fad4-493e-a426-e7962d7aee8c
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 方法: ステート マシン ワークフローを作成する
+ワークフローは、ビルトイン アクティビティおよびカスタム アクティビティから構築できます。このトピックでは、<xref:System.Activities.Statements.StateMachine> アクティビティなどのビルトイン アクティビティ、および前の「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」トピックのカスタム アクティビティの両方を使用するワークフローを作成します。このワークフローは、数値推測ゲームをモデル化しています。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。このトピックを完了する前に、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」を完了する必要があります。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+### ワークフローを作成するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowActivities** を右クリックし、**\[追加\]** をポイントして、**\[新しい項目\]** をクリックします。  
+  
+2.  **\[インストール済み\]** の **\[共通項目\]** ノードで、**\[ワークフロー\]** を選択します。**\[ワークフロー\]** リストで **\[アクティビティ\]** を選択します。  
+  
+3.  **\[名前\]** ボックスに「`StateMachineNumberGuessWorkflow`」と入力し、**\[追加\]** をクリックします。  
+  
+4.  **ツールボックス**の **\[ステート マシン\]** セクションから **StateMachine** アクティビティをドラッグし、ワークフロー デザイン サーフェイスの **\[ここにアクティビティをドロップ\]** ラベル上にドロップします。  
+  
+### ワークフロー変数および引数を作成するには  
+  
+1.  **ソリューション エクスプローラー**で **StateMachineNumberGuessWorkflow.xaml** をダブルクリックし、デザイナーでワークフローを表示します \(まだ表示されていない場合\)。  
+  
+2.  ワークフロー デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを表示します。  
+  
+3.  **\[引数の作成\]** をクリックします。  
+  
+4.  **\[名前\]** ボックスに「`MaxNumber`」と入力し、**\[方向\]** ボックスで **\[IN\]** を選択して、**\[引数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して引数を保存します。  
+  
+5.  **\[引数の作成\]** をクリックします。  
+  
+6.  新しく追加した `MaxNumber` 引数の下にある **\[名前\]** ボックスに「`Turns`」と入力し、**\[方向\]** ボックスで **\[OUT\]** を選択して、**\[引数の型\]** ドロップダウン リストで **\[Int32\]** を選択し、Enter キーを押します。  
+  
+7.  アクティビティ デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを閉じます。  
+  
+8.  ワークフロー デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを表示します。  
+  
+9. **\[変数の作成\]** をクリックします。  
+  
+    > [!TIP]
+    >  **\[変数の作成\]** ボックスが表示されていない場合は、ワークフロー デザイナー画面の <xref:System.Activities.Statements.StateMachine> アクティビティをクリックして選択します。  
+  
+10. **\[名前\]** ボックスに「`Guess`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+11. **\[変数の作成\]** をクリックします。  
+  
+12. **\[名前\]** ボックスに「`Target`」と入力し、**\[変数の型\]** ボックスで **\[Int32\]** を選択し、Enter キーを押して変数を保存します。  
+  
+13. アクティビティ デザイナーの左下にある **\[変数\]** をクリックし、**\[変数\]** ペインを閉じます。  
+  
+### ワークフロー アクティビティを追加するには  
+  
+1.  **\[State1\]** をクリックして選択します。**\[プロパティ\] ウィンドウ**で、**DisplayName** を「`Initialize Target`」に変更します。  
+  
+    > [!TIP]
+    >  **\[プロパティ\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** を選択します。  
+  
+2.  ワークフロー デザイナーで、名前を **\[Initialize Target\]** に変更した状態をダブルクリックして展開します。  
+  
+3.  **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、状態の **Entry** セクションにドロップします。**\[終端側\]** ボックスに「`Target`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに次の式を入力します。  
+  
+    ```vb  
+    New System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    ```csharp  
+    new System.Random().Next(1, MaxNumber + 1)  
+    ```  
+  
+    > [!TIP]
+    >  **\[ツールボックス\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+4.  ワークフロー デザイナーの上部にある階層リンク表示の **\[StateMachine\]** をクリックして、ワークフロー デザイナーの全体的なステート マシン ビューに戻ります。  
+  
+5.  **ツールボックス**の **\[ステート マシン\]** セクションから **State** アクティビティをワークフロー デザイナー上にドラッグし、**Initialize Target** 状態の上に置きます。新しい状態が上に置かれると、**Initialize Target** 状態の周囲に 4 つの三角形が表示されることに注意してください。**Initialize Target** 状態のすぐ下にある三角形の上に、新しい状態をドロップします。これにより、新しい状態がワークフロー上に配置され、**Initialize Target** 状態から新しい状態への遷移が作成されます。  
+  
+6.  **\[State1\]** をクリックして選択し、**DisplayName** を「`Enter Guess`」に変更して、ワークフロー デザイナーでその状態をダブルクリックして展開します。  
+  
+7.  **ツールボックス**の **\[プリミティブ\]** セクションから **WriteLine** アクティビティをドラッグし、状態の **Entry** セクションの上にドロップします。  
+  
+8.  **WriteLine** の **\[Text\]** プロパティ ボックスに次の式を入力します。  
+  
+    ```vb  
+    "Please enter a number between 1 and " & MaxNumber  
+    ```  
+  
+    ```csharp  
+    "Please enter a number between 1 and " + MaxNumber  
+    ```  
+  
+9. **ツールボックス**の **\[プリミティブ\]** セクションから **Assign** アクティビティをドラッグし、状態の **Exit** セクションにドロップします。  
+  
+10. **\[終端側\]** ボックスに「`Turns`」と入力し、**\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに「`Turns + 1`」と入力します。  
+  
+11. ワークフロー デザイナーの上部にある階層リンク表示の **\[StateMachine\]** をクリックして、ワークフロー デザイナーの全体的なステート マシン ビューに戻ります。  
+  
+12. **ツールボックス**の **\[ステート マシン\]** セクションから **FinalState** アクティビティをドラッグして **Enter Guess** 状態の上にマウス ポインターを置き、**Enter Guess** 状態の右側に表示される三角形の上にドロップすると、**Enter Guess** と **FinalState** の間に遷移が作成されます。  
+  
+13. 遷移の既定名は **T2** です。ワークフロー デザイナーでその遷移をクリックして選択し、その **DisplayName** に「**Guess Correct**」を設定します。その後、**FinalState** をクリックして選択し、それを右方向へドラッグして、遷移名全体が 2 つの状態のどちらにも重ならずに表示されるようにします。これにより、チュートリアルの残りの手順をより簡単に実行できます。  
+  
+14. ワークフロー デザイナーで、新しい名前に変更された **Guess Correct** 遷移をダブルクリックして展開します。  
+  
+15. **ツールボックス**の **\[NumberGuessWorkflowActivities\]** セクションから **ReadInt** アクティビティをドラッグして遷移の **Trigger** セクションにドロップします。  
+  
+16. **ReadInt** アクティビティの **\[プロパティ\] ウィンドウ**で、**\[BookmarkName\]** プロパティ値ボックスに「`"EnterGuess"`」\(引用符を含む\) と入力し、**\[Result\]** プロパティ値ボックスに「`Guess`」と入力します。  
+  
+17. **Guess Correct** 遷移の **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    Guess = Target  
+    ```  
+  
+    ```csharp  
+    Guess == Target  
+    ```  
+  
+18. ワークフロー デザイナーの上部にある階層リンク表示の **\[StateMachine\]** をクリックして、ワークフロー デザイナーの全体的なステート マシン ビューに戻ります。  
+  
+    > [!NOTE]
+    >  トリガー イベントが受け取られ、<xref:System.Activities.Statements.Transition.Condition%2A> \(存在する場合\) が `True` と評価される場合に遷移が発生します。この遷移では、ユーザーの `Guess` がランダムに生成された `Target` と一致する場合、制御が **FinalState** に渡され、ワークフローが完了します。  
+  
+19. 推定値が正しいかどうかに応じて、ワークフローは **FinalState** に遷移するか、もう一度実行するために **Enter Guess** 状態に戻る必要があります。両方の遷移では、**ReadInt** アクティビティを介して受け取るユーザーの推定値を待機するのに同じトリガーを共有します。これは、共有遷移と呼ばれます。共有遷移を作成するには、**Guess Correct** 遷移の始点を示す円をクリックし、目的の状態にドラッグします。この場合、これは自己遷移であるため、**Guess Correct** 遷移の始点をドラッグし、**Enter Guess** 状態の下にドロップします。遷移の作成後、ワークフロー デザイナーでその遷移を選択し、**DisplayName** プロパティに **Guess Incorrect** を設定します。  
+  
+    > [!NOTE]
+    >  共有遷移は、遷移デザイナー内から作成することもできます。これには、遷移デザイナーの下部にある **\[トリガーを共有する遷移の追加\]** をクリックし、**\[接続の使用可能な状態\]** ボックスの一覧で、目的となる対象の状態を選択します。  
+  
+    > [!NOTE]
+    >  遷移の <xref:System.Activities.Statements.Transition.Condition%2A> が `false` と評価された場合 \(またはトリガーを共有する遷移すべての状態が `false` と評価された場合\)、遷移は行われず、その状態からのすべての遷移のすべてのトリガーが再スケジュールされます。このチュートリアルでは、条件の構成方法 \(推定値が正しいか間違っているかを判断する特定のアクションが用意されています\) により、この状況は発生しません。  
+  
+20. ワークフロー デザイナーで **Guess Incorrect** 遷移をダブルクリックして展開します。**Trigger** は、**Guess Correct** 遷移で使用されたのと同じ **ReadInt** アクティビティに既に設定されていることに注意してください。  
+  
+21. **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb  
+    Guess <> Target  
+    ```  
+  
+    ```csharp  
+    Guess != Target  
+    ```  
+  
+22. **ツールボックス**の **\[制御フロー\]** セクションから **If** アクティビティをドラッグして遷移の **Action** セクションにドロップします。  
+  
+23. **If** アクティビティの **\[Condition\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    Guess < Target  
+    ```  
+  
+24. **ツールボックス**の **\[プリミティブ\]** セクションから 2 つの **WriteLine** アクティビティをドラッグし、1 つは **If** アクティビティの **Then** セクション内に、もう 1 つは **Else** セクション内に配置されるようにドロップします。  
+  
+25. **Then** セクションの **WriteLine** アクティビティをクリックして選択し、**\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    "Your guess is too low."  
+    ```  
+  
+26. **Else** セクションの **WriteLine** アクティビティをクリックして選択し、**\[Text\]** プロパティ値ボックスに次の式を入力します。  
+  
+    ```vb-c#  
+    "Your guess is too high."  
+    ```  
+  
+27. ワークフロー デザイナーの上部にある階層リンク表示の **\[StateMachine\]** をクリックして、ワークフロー デザイナーの全体的なステート マシン ビューに戻ります。  
+  
+     次の例は完成したワークフローを示しています。  
+  
+     ![完成したステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wfstatemachinegettingstartedtutorialcomplete.JPG "WFStateMachineGettingStartedTutorialComplete")  
+  
+### ワークフローをビルドするには  
+  
+1.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+     ワークフローを実行する手順については、次のトピック「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」を参照してください。「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の手順を別のスタイルのワークフローを使用して既に完了している場合に、この手順のステート マシンのワークフローを使用して実行するには、「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」の「[アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md#BKMK_ToRunTheApplication)」に進んでください。  
+  
+## 参照  
+ <xref:System.Activities.Statements.Flowchart>   
+ <xref:System.Activities.Statements.FlowDecision>   
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)   
+ [ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)   
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)   
+ [アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)   
+ [ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md b/docs/framework/windows-workflow-foundation/how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md
new file mode 100644
index 00000000000..d221956fe66
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md
@@ -0,0 +1,69 @@
+---
+title: "既存のサービス コントラクトを使用するワークフロー サービスを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11d11b59-acc4-48bf-8e4b-e97b516aa0a9
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 既存のサービス コントラクトを使用するワークフロー サービスを作成する方法
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、コントラクト優先ワークフローの開発という形で、Web サービスとワークフローの統合が向上しています。コントラクト優先ワークフローの開発ツールでは、コードのコントラクトを先に設計できます。その後、ツールボックス内に、コントラクト内の操作用のアクティビティ テンプレートが自動的に生成されます。  
+  
+> [!NOTE]
+>  このトピックでは、コントラクト優先ワークフロー サービスを作成する手順について説明します。コントラクト優先ワークフロー サービスの開発[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[コントラクト優先ワークフロー サービスの開発](../../../docs/framework/windows-workflow-foundation//contract-first-workflow-service-development.md)」を参照してください。  
+  
+### ワークフロー プロジェクトの作成  
+  
+1.  [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] で、**\[ファイル\]**、**\[新しいプロジェクト\]** を順に選択します。**\[テンプレート\]** ツリーで **\[C\#\]** ノードの下にある **\[WCF\]** ノードを選択し、**\[WCF ワークフロー サービス アプリケーション\]** テンプレートを選択します。  
+  
+2.  新しいプロジェクトに「`ContractFirst`」という名前を付け、**\[OK\]** をクリックします。  
+  
+### サービス コントラクトの作成  
+  
+1.  **ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[追加\]** をポイントして、**\[新しい項目\]** をクリックします。左側で **\[コード\]** ノードを選択し、右側で **\[クラス\]** テンプレートを選択します。新しいクラスに「`IBookService`」という名前を付け、**\[OK\]** をクリックします。  
+  
+2.  表示されるコード ウィンドウの上部で、`System.Servicemodel` に対する Using ステートメントを追加します。  
+  
+    ```  
+    using System.ServiceModel;  
+    ```  
+  
+3.  サンプルのクラス定義を次のインターフェイス定義に変更します。  
+  
+    ```  
+    [ServiceContract]  
+        public interface IBookService  
+        {  
+            [OperationContract]  
+            void Buy(string bookName);  
+  
+            [OperationContract(IsOneWay=true)]  
+            void Checkout();  
+        }  
+    ```  
+  
+4.  Ctrl キーと Shift キーを押しながら B キーを押して、プロジェクトをビルドします。  
+  
+### サービス コントラクトのインポート  
+  
+1.  **ソリューション エクスプローラー**でプロジェクトを右クリックし、**\[サービス コントラクトのインポート\]** をクリックします。**\[\<現在のプロジェクト\>\]** の下で、すべてのサブノードを開き、**IBookService** を選択します。**\[OK\]** をクリックします。  
+  
+2.  ダイアログが表示され、操作が正常に完了したことと、プロジェクトをビルドすると、生成されたアクティビティがツールボックスに表示されることが示されます。**\[OK\]** をクリックします。  
+  
+3.  Ctrl キーと Shift キーを押しながら B キーを押してプロジェクトをビルドすると、インポートしたアクティビティがツールボックスに表示されます。  
+  
+4.  **ソリューション エクスプローラー**で、Service1.xamlx を開きます。ワークフロー サービスがデザイナーに表示されます。  
+  
+5.  **Sequence** アクティビティを選択します。\[プロパティ\] ウィンドウで、**ImplementedContract** プロパティの省略記号ボタン **\(…\)** をクリックします。**\[型コレクション エディター\]** ウィンドウが表示されたら、**\[型\]** ボックスをクリックし、**\[型の参照\]** エントリを選択します。**\[参照して .Net の種類を選択\]** ダイアログ ボックスの **\[\<現在のプロジェクト\>\]** の下で、すべてのサブノードを開き、**IBookService** を選択します。**\[OK\]** をクリックします。**\[型コレクション エディター\]** ダイアログ ボックスで **\[OK\]** をクリックします。  
+  
+6.  **ReceiveRequest** アクティビティと **SendResponse** アクティビティを選択して削除します。  
+  
+7.  ツールボックスから **Buy\_ReceiveAndSendReply** アクティビティと **Checkout\_Receive** アクティビティを **"シーケンシャル サービス"** アクティビティ上にドラッグします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-a-workflow.md b/docs/framework/windows-workflow-foundation/how-to-create-a-workflow.md
new file mode 100644
index 00000000000..6b60a2f7174
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-a-workflow.md
@@ -0,0 +1,37 @@
+---
+title: "ワークフローを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 87234108-8e21-4cb3-9340-4a1a13f3f98c
+caps.latest.revision: 34
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 34
+---
+# ワークフローを作成する方法
+ワークフローは、ビルトイン アクティビティおよびカスタム アクティビティから構築できます。このセクションのこのトピックでは、<xref:System.Activities.Statements.Flowchart> アクティビティなどのビルトイン アクティビティ、および前の「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」トピックのカスタム アクティビティの両方を使用するワークフローを作成します。このワークフローは、数値推測ゲームをモデル化しています。このセクションのトピックの 1 つだけでチュートリアルを終わることができます。目的のスタイルを選択し、手順に従ってください。ただし、必要に応じて、すべてのトピックを修了することができます。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。このトピックを完了する前に、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」を完了する必要があります。  
+  
+> [!NOTE]
+>  チュートリアルのバージョン一式をダウンロードするには、「[Windows Workflow Foundation （WF45） \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+## このセクションの内容  
+ [シーケンシャル ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-sequential-workflow.md)  
+ <xref:System.Activities.Statements.Sequence> アクティビティを使用してシーケンシャルなワークフローを作成する方法を説明します。  
+  
+ [フローチャート ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-flowchart-workflow.md)  
+ <xref:System.Activities.Statements.Flowchart> アクティビティを使用してフローチャート ワークフローを作成する方法を説明します。  
+  
+ [方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md)  
+ <xref:System.Activities.Statements.StateMachine> アクティビティを使用してステート マシン ワークフローを作成する方法を説明します。  
+  
+## 参照  
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-an-activity.md b/docs/framework/windows-workflow-foundation/how-to-create-an-activity.md
new file mode 100644
index 00000000000..7f5319356b2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-an-activity.md
@@ -0,0 +1,117 @@
+---
+title: "アクティビティを作成する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c09b1e99-21b5-4d96-9c04-ec31db3f4436
+caps.latest.revision: 39
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 39
+---
+# アクティビティを作成する方法
+アクティビティは [!INCLUDE[wf1](../../../includes/wf1-md.md)] の動作の中心的な単位です。アクティビティの実行ロジックはマネージ コードで実装できます。または他のアクティビティを使用して実装できます。このトピックでは、2 つのアクティビティを作成する方法について説明します。最初のアクティビティは、コードを使用してその実行ロジックを実装する単純なアクティビティです。2 番目のアクティビティの実装は他のアクティビティを使用して定義されています。これらのアクティビティは、チュートリアルの次の手順で使用します。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+### アクティビティ ライブラリ プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を開き、**\[ファイル\]** メニューの **\[新規作成\]** の **\[プロジェクト\]** をクリックします。  
+  
+2.  **\[インストールされているテンプレート\]** の一覧で **\[その他のプロジェクトの種類\]** ノードを展開し、**\[Visual Studio ソリューション\]** を選択します。  
+  
+3.  **\[Visual Studio ソリューション\]** リストで **\[空のソリューション\]** を選択します。.NET Framework バージョンのドロップダウン リストで **\[.NET Framework 4.5\]** が選択されていることを確認します。**\[名前\]** ボックスに「`WF45GettingStartedTutorial`」と入力し、**\[OK\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **WF45GettingStartedTutorial** を右クリックし、**\[追加\]** をポイントして、**\[新しいプロジェクト\]** をクリックします。  
+  
+    > [!TIP]
+    >  **ソリューション エクスプローラー** ウィンドウが表示されない場合は、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+5.  **\[インストール済み\]** ノードで、**\[Visual C\#\]**、**\[ワークフロー\]** \(または **\[Visual Basic\]**、**\[ワークフロー\]**\) の順に選択します。[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョンのドロップダウン リストで **\[.NET Framework 4.5\]** が選択されていることを確認します。**\[ワークフロー\]** リストで **\[アクティビティ ライブラリ\]** を選択します。**\[名前\]** ボックスに「`NumberGuessWorkflowActivities`」と入力し、**\[OK\]** をクリックします。  
+  
+    > [!NOTE]
+    >  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で第一言語として設定されているプログラミング言語に応じて、**\[インストール済み\]** ノードの **\[他の言語\]** ノードの下に、**\[Visual C\#\]** ノードまたは **\[Visual Basic\]** ノードが表示されます。  
+  
+6.  **ソリューション エクスプローラー**で **Activity1.xaml** を右クリックし、**\[削除\]** をクリックします。**\[OK\]** をクリックして確定します。  
+  
+### ReadInt アクティビティを作成するには  
+  
+1.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+2.  **\[インストール済み\]** の **\[共通項目\]** ノードで、**\[ワークフロー\]** を選択します。**\[ワークフロー\]** リストで **\[コード アクティビティ\]** を選択します。  
+  
+3.  **\[名前\]** ボックスに「`ReadInt`」と入力し、**\[追加\]** をクリックします。  
+  
+4.  既存の `ReadInt` 定義を次の定義に置き換えます。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#1](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/readint.cs#1)]
+     [!code-vb[CFX_WF_GettingStarted#1](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/readint.vb#1)]  
+  
+    > [!NOTE]
+    >  `ReadInt` アクティビティは、コード アクティビティ テンプレートの既定値である <xref:System.Activities.CodeActivity> ではなく <xref:System.Activities.NativeActivity%601> から派生します。<xref:System.Activities.CodeActivity%601> は、<xref:System.Activities.Activity%601.Result%2A> 引数を介して公開される 1 つの結果がアクティビティによって提供される場合に使用できますが、<xref:System.Activities.CodeActivity%601> ではブックマークの使用がサポートされていないため、<xref:System.Activities.NativeActivity%601> が使用されます。  
+  
+### Prompt アクティビティを作成するには  
+  
+1.  **Ctrl** キーと **Shift** キーを押しながら **B** キーを押して、プロジェクトをビルドします。プロジェクトをビルドすると、このプロジェクトの `ReadInt` アクティビティを使用して、この手順からカスタム アクティビティをビルドできます。  
+  
+2.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+3.  **\[インストール済み\]** の **\[共通項目\]** ノードで、**\[ワークフロー\]** を選択します。**\[ワークフロー\]** リストで **\[アクティビティ\]** を選択します。  
+  
+4.  **\[名前\]** ボックスに「`Prompt`」と入力し、**\[追加\]** をクリックします。  
+  
+5.  **ソリューション エクスプローラー**で **Prompt.xaml** をダブルクリックし、デザイナーにワークフローを表示します \(まだ表示されていない場合\)。  
+  
+6.  アクティビティ デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを表示します。  
+  
+7.  **\[引数の作成\]** をクリックします。  
+  
+8.  **\[名前\]** ボックスに「`BookmarkName`」と入力し、**\[方向\]** ボックスの一覧の **\[IN\]** を選択して、**\[引数の型\]** ボックスの一覧の **\[String\]** を選択し、Enter キーを押して引数を保存します。  
+  
+9. **\[引数の作成\]** をクリックします。  
+  
+10. 新しく追加した `BookmarkName` 引数の下にある **\[名前\]** ボックスに「`Result`」と入力し、**\[方向\]** ボックスで **\[OUT\]** を選択して、**\[引数の型\]** ドロップダウン リストで **\[Int32\]** を選択し、Enter キーを押します。  
+  
+11. **\[引数の作成\]** をクリックします。  
+  
+12. **\[名前\]** ボックスに「`Text`」と入力し、**\[方向\]** ボックスで **\[IN\]** を選択して、**\[引数の型\]** ボックスで **\[String\]** を選択し、Enter キーを押して引数を保存します。  
+  
+     これら 3 つの引数は、次の手順で、`Prompt` アクティビティに追加される <xref:System.Activities.Statements.WriteLine> アクティビティと `ReadInt` アクティビティの対応する引数にバインドされます。  
+  
+13. アクティビティ デザイナーの左下にある **\[引数\]** をクリックし、**\[引数\]** ペインを閉じます。  
+  
+14. **ツールボックス**の **\[制御フロー\]** セクションから **Sequence** アクティビティをドラッグし、**Prompt** アクティビティ デザイナーの **\[ここにアクティビティをドロップ\]** ラベルの上にドロップします。  
+  
+    > [!TIP]
+    >  **\[ツールボックス\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[ツールボックス\]** をクリックします。  
+  
+15. **ツールボックス**の **\[プリミティブ\]** セクションから **WriteLine** アクティビティをドラッグし、**Sequence** アクティビティの **\[ここにアクティビティをドロップ\]** ラベルの上にドロップします。  
+  
+16. **\[プロパティ\]** ウィンドウの **\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに「`Text`」と入力して、**WriteLine** アクティビティの **Text** 引数を **Prompt** アクティビティの **Text** 引数にバインドします。次に Tab キーを 2 回押します。これで、IntelliSense リスト メンバー ウィンドウを閉じ、プロパティから選択を外してプロパティ値を保存します。このプロパティは、アクティビティ自体の **\[C\# の式を入力してください\]** ボックスまたは **\[VB の式を入力してください\]** ボックスに「`Text`」と入力して設定することもできます。  
+  
+    > [!TIP]
+    >  **\[プロパティ\]** ウィンドウが表示されていない場合は、**\[表示\]** メニューの **\[プロパティ ウィンドウ\]** を選択します。  
+  
+17. **ツールボックス**の **\[NumberGuessWorkflowActivities\]** セクションから **ReadInt** アクティビティをドラッグし、**WriteLine** アクティビティの後になるように **Sequence** アクティビティ内にドロップします。  
+  
+18. **\[プロパティ\]** ウィンドウで **BookmarkName** 引数の右にある **\[VB の式を入力してください\]** ボックスに「`BookmarkName`」と入力して、**ReadInt** アクティビティの **BookmarkName** 引数を **Prompt** アクティビティの **BookmarkName** 引数にバインドします。次に Tab キーを 2 回押して IntelliSense リスト メンバー ウィンドウを閉じ、プロパティを保存します。  
+  
+19. **\[プロパティ\]** ウィンドウの **Result** 引数の右にある **\[VB の式を入力してください\]** ボックスに「`Result`」と入力して、**ReadInt** アクティビティの **Result** 引数を **Prompt** アクティビティの **Result** 引数にバインドします。次に Tab キーを 2 回押します。  
+  
+20. Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+     これらのアクティビティを使用してワークフローを作成する手順については、チュートリアルの次の手順「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Activities.CodeActivity>   
+ <xref:System.Activities.NativeActivity%601>   
+ [カスタム アクティビティの設計と実装](../../../docs/framework/windows-workflow-foundation//designing-and-implementing-custom-activities.md)   
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)   
+ [ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)   
+ [カスタム アクティビティ デザイナーでの ExpressionTextBox の使用](../../../docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-create-and-run-a-long-running-workflow.md b/docs/framework/windows-workflow-foundation/how-to-create-and-run-a-long-running-workflow.md
new file mode 100644
index 00000000000..858c89cafea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-create-and-run-a-long-running-workflow.md
@@ -0,0 +1,1340 @@
+---
+title: "How to: Create and Run a Long Running Workflow | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c0043c89-2192-43c9-986d-3ecec4dd8c9c
+caps.latest.revision: 40
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 40
+---
+# How to: Create and Run a Long Running Workflow
+[!INCLUDE[wf](../../../includes/wf-md.md)] の中心的な機能の 1 つは、アイドル状態のワークフローをデータベースにアップロードできる実行時の機能です。 手順に [方法: ワークフローを実行する](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md) でコンソール アプリケーションを使用してワークフローのホスティングの基本について説明しました。 ワークフローの開始、ワークフロー ライフサイクル ハンドラー、およびブックマークの再開の例を紹介しました。 ワークフローの永続化を効果的に説明するためには、複数のワークフロー インスタンスの開始と再開をサポートするより複雑なワークフロー ホストが必要です。 チュートリアルのこの手順では、複数のワークフロー インスタンスの開始と再開およびワークフローの永続化をサポートする Windows フォーム ホスト アプリケーションを作成する方法について説明します。また、この手順は、以降の手順で説明する追跡やバージョン管理などの高度な機能の基礎となります。  
+  
+> [!NOTE]
+>  このチュートリアルの手順と後続のステップから次の 3 つすべてのワークフロー型を使用して [方法: ワークフローを作成](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)します。 3 種類すべてが完成していない場合から手順の完成版をダウンロードすることができます [Windows Workflow Foundation (WF45) - チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)します。  
+  
+> [!NOTE]
+>  完成版をダウンロードまたは表示、ビデオ、チュートリアルのガイドは、次を参照してください。 [Windows Workflow Foundation (WF45) - チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)します。  
+  
+## <a name="in-this-topic"></a>このトピックの内容  
+  
+-   [永続性データベースを作成するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_CreatePersistenceDatabase)  
+  
+-   [DurableInstancing アセンブリへの参照を追加するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_AddReference)  
+  
+-   [ワークフロー ホスト フォームを作成するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_CreateForm)  
+  
+-   [プロパティと、フォームのヘルパー メソッドを追加するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_AddHelperMethods)  
+  
+-   [インスタンス ストア、ワークフロー ライフ サイクル ハンドラー、および拡張機能を構成するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_ConfigureWorkflowApplication)  
+  
+-   [型を開始してを複数のワークフローの再開を有効にするには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_WorkflowVersionMap)  
+  
+-   [新しいワークフローを開始するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_StartWorkflow)  
+  
+-   [ワークフローを再開するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_ResumeWorkflow)  
+  
+-   [ワークフローを終了するには](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_TerminateWorkflow)  
+  
+-   [ビルドして、アプリケーションの実行](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_BuildAndRun)  
+  
+###  <a name="a-namebkmkcreatepersistencedatabasea-to-create-the-persistence-database"></a><a name="BKMK_CreatePersistenceDatabase"></a> 永続性データベースを作成するには  
+  
+1.  SQL Server Management Studio を開き、次に例をローカル サーバーに接続 **. \SQLEXPRESS**します。 右クリックし、 **データベース** し、ローカル サーバー上のノード **新しいデータベース**します。 新しいデータベースの名前 **WF45GettingStartedTutorial**, 他のすべての値をそのまま使用し、選択 **OK**します。  
+  
+    > [!NOTE]
+    >  できることを確認 **Create Database** データベースを作成する前に、ローカル サーバーにアクセスを許可します。  
+  
+2.  選択 **開く**, 、**ファイル** から、 **ファイル** メニュー。 次のフォルダーに移動します: `C:\Windows\Microsoft.NET\Framework\4.0.30319\sql\en`。  
+  
+     次の 2 つのファイルを選択し、クリックして **開く**します。  
+  
+    -   SqlWorkflowInstanceStoreLogic.sql  
+  
+    -   SqlWorkflowInstanceStoreSchema.sql  
+  
+3.  選択 **SqlWorkflowInstanceStoreSchema.sql** から、 **ウィンドウ** メニュー。 いることを確認 **WF45GettingStartedTutorial** で選択した、 **利用可能なデータベース** ドロップダウンをクリックし、選択 **Execute** から、 **クエリ** メニュー。  
+  
+4.  選択 **SqlWorkflowInstanceStoreLogic.sql** から、 **ウィンドウ** メニュー。 いることを確認 **WF45GettingStartedTutorial** で選択した、 **利用可能なデータベース** ドロップダウンをクリックし、選択 **Execute** から、 **クエリ** メニュー。  
+  
+    > [!WARNING]
+    >  前の 2 つの手順を正しい順序で実行することが重要です。 クエリが正しい順序で実行されないと、エラーが発生し、永続性データベースは正しく構成されません。  
+  
+###  <a name="a-namebkmkaddreferencea-to-add-the-reference-to-the-durableinstancing-assemblies"></a><a name="BKMK_AddReference"></a> DurableInstancing アセンブリへの参照を追加するには  
+  
+1.  右クリック **NumberGuessWorkflowHost** で **ソリューション エクスプ ローラー** 選択 **参照の追加**します。  
+  
+2.  選択 **アセンブリ** から、 **参照の追加** リスト、および型 `DurableInstancing` に、 **アセンブリの検索** ボックス。 これにより、アセンブリがフィルター処理され、目的の参照を簡単に選択できます。  
+  
+3.  横にあるチェック ボックスをオン **System.Activities.DurableInstancing** と **System.Runtime.DurableInstancing** から、 **検索結果** 一覧を開き、をクリックして **OK**します。  
+  
+###  <a name="a-namebkmkcreateforma-to-create-the-workflow-host-form"></a><a name="BKMK_CreateForm"></a> ワークフロー ホスト フォームを作成するには  
+  
+> [!NOTE]
+>  この手順では、フォームを手動で追加して構成する方法について説明します。 必要に応じて、チュートリアルのソリューション ファイルをダウンロードし、完成したフォームをプロジェクトに追加できます。 チュートリアル ファイルをダウンロードするを参照してください。 [Windows Workflow Foundation (WF45) - チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)します。 右クリックし、ファイルがダウンロードされると、 **NumberGuessWorkflowHost** 選択 **参照の追加**します。 参照を追加 **System.Windows.Forms** と **System.Drawing**します。 新しいフォームを追加する場合、これらの参照は自動的に追加、 **追加**, 、**[新しい項目の** ] メニューの [がフォームをインポートするときに手動で追加する必要があります。 右クリックし、参照が追加されると、 **NumberGuessWorkflowHost** で **ソリューション エクスプ ローラー** を選択し、 **追加**, 、**既存項目の**です。 参照、 `Form` 選択、プロジェクト ファイル内のフォルダー **WorkflowHostForm.cs** (または **WorkflowHostForm.vb**)、をクリックして **追加**します。 フォームをインポートするかどうかは、次のセクションまでスキップできます [プロパティと、フォームのヘルパー メソッドを追加する](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md#BKMK_AddHelperMethods)です。  
+  
+1.  右クリック **NumberGuessWorkflowHost** で **ソリューション エクスプ ローラー** 選択 **追加**, 、**[新しい項目の**です。  
+  
+2.   **インストールされている** テンプレート リストで、選択 **Windows フォーム**, 、型 `WorkflowHostForm` で、 **名前** ボックスし、をクリックして **追加**します。  
+  
+3.  フォームの次のプロパティを構成します。  
+  
+    |プロパティ|値|  
+    |--------------|-----------|  
+    |FormBorderStyle|FixedSingle|  
+    |MaximizeBox|False|  
+    |サイズ|400, 420|  
+  
+4.  次のコントロールを指定された順序でフォームに追加し、指示に従ってプロパティを構成します。  
+  
+    |コントロール|プロパティ: 値|  
+    |-------------|---------------------|  
+    |**ボタン**|名前: NewGame<br /><br /> 場所: 13、13<br /><br /> サイズ: 75、23<br /><br /> 新しいゲームのテキスト:|  
+    |**ラベル**|場所: 94、18<br /><br /> テキスト: 1 の数値を推測します。|  
+    |**コンボ ボックス**|名前: NumberRange<br /><br /> DropDownStyle: DropDownList<br /><br /> 項目数: 10、100、1000<br /><br /> 場所: 228、12<br /><br /> サイズ: 143、21|  
+    |**ラベル**|場所: 13、43<br /><br /> ワークフロー型のテキスト:|  
+    |**コンボ ボックス**|名前: WorkflowType<br /><br /> DropDownStyle: DropDownList<br /><br /> StateMachineNumberGuessWorkflow FlowchartNumberGuessWorkflow、SequentialNumberGuessWorkflow のアイテム:<br /><br /> 場所: 94, 40<br /><br /> サイズ: 277、21|  
+    |**ラベル**|名前: WorkflowVersion<br /><br /> 場所: 13、362<br /><br /> ワークフローのバージョンはテキスト:|  
+    |**グループ ボックス**|場所: 13、67<br /><br /> サイズ: 358、287<br /><br /> テキスト: ゲーム|  
+  
+    > [!NOTE]
+    >  次のコントロールを追加するときに、GroupBox に配置します。  
+  
+    |コントロール|プロパティ: 値|  
+    |-------------|---------------------|  
+    |**ラベル**|場所: 7, 20<br /><br /> テキスト: ワークフロー インスタンス Id|  
+    |**コンボ ボックス**|名前: InstanceId<br /><br /> DropDownStyle: DropDownList<br /><br /> 場所: 121、17<br /><br /> サイズ: 227、21|  
+    |**ラベル**|場所: 7、47<br /><br /> テキスト: 推測|  
+    |**テキスト ボックス**|名前: 推測<br /><br /> 場所: 50, 44<br /><br /> サイズ: 65, 20|  
+    |**ボタン**|名前: EnterGuess<br /><br /> 場所: 121、42<br /><br /> サイズ: 75、23<br /><br /> 推定値を入力するテキスト。|  
+    |**ボタン**|名前: QuitGame<br /><br /> 場所: 274、42<br /><br /> サイズ: 75、23<br /><br /> テキスト: 終了|  
+    |**テキスト ボックス**|名前: WorkflowStatus<br /><br /> 場所: 10、73<br /><br /> 複数行: True<br /><br /> 読み取り専用: True<br /><br /> スクロール バー: 垂直方向<br /><br /> サイズ: 338、208|  
+  
+5.  設定、 **AcceptButton** にフォームのプロパティ **EnterGuess**します。  
+  
+ 次の例は完成したフォームを示しています。  
+  
+ ![WF45 チュートリアル入門のワークフロー ホスト フォーム](../../../docs/framework/windows-workflow-foundation//media/wf45gettingstartedtutorialworkflowhostform.png "WF45GettingStartedTutorialWorkflowHostForm")  
+  
+###  <a name="a-namebkmkaddhelpermethodsa-to-add-the-properties-and-helper-methods-of-the-form"></a><a name="BKMK_AddHelperMethods"></a> プロパティと、フォームのヘルパー メソッドを追加するには  
+ このセクションの手順では、フォーム クラスに、数値推測ワークフローの実行と再開をサポートするようフォームの UI を構成するプロパティとヘルパー メソッドを追加します。  
+  
+1.  右クリック **WorkflowHostForm** で **ソリューション エクスプ ローラー** 選択 **コードの表示**します。  
+  
+2.  次の `using` (または `Imports`) ステートメントを、他の `using` (または `Imports`) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Windows.Forms  
+    Imports System.Activities.DurableInstancing  
+    Imports System.Activities  
+    Imports System.Data.SqlClient  
+    Imports System.IO  
+    ```  
+  
+    ```csharp  
+    using System.Windows.Forms;  
+    using System.Activities.DurableInstancing;  
+    using System.Activities;  
+    using System.Data.SqlClient;  
+    using System.IO;  
+    ```  
+  
+3.  次のメンバー宣言を追加、 **WorkflowHostForm** クラスです。  
+  
+    ```vb  
+    Const connectionString = "Server=.\SQLEXPRESS;Initial Catalog=WF45GettingStartedTutorial;Integrated Security=SSPI"  
+    Dim store As SqlWorkflowInstanceStore  
+    Dim WorkflowStarting As Boolean  
+    ```  
+  
+    ```csharp  
+    const string connectionString = "Server=.\\SQLEXPRESS;Initial Catalog=WF45GettingStartedTutorial;Integrated Security=SSPI";  
+    SqlWorkflowInstanceStore store;  
+    bool WorkflowStarting;  
+    ```  
+  
+    > [!NOTE]
+    >  接続文字列が異なる場合は、使用しているデータベースを参照するように `connectionString` を更新してください。  
+  
+4.  `WorkflowInstanceId` プロパティを `WorkflowFormHost` クラスに追加します。  
+  
+    ```vb  
+    Public ReadOnly Property WorkflowInstanceId() As Guid  
+        Get  
+            If InstanceId.SelectedIndex = -1 Then  
+                Return Guid.Empty  
+            Else  
+                Return New Guid(InstanceId.SelectedItem.ToString())  
+            End If  
+        End Get  
+    End Property  
+    ```  
+  
+    ```csharp  
+    public Guid WorkflowInstanceId  
+    {  
+        get  
+        {  
+            return InstanceId.SelectedIndex == -1 ? Guid.Empty : (Guid)InstanceId.SelectedItem;  
+        }  
+    }  
+    ```  
+  
+      `InstanceId` コンボ ボックスは、永続化されたワークフロー インスタンス id の一覧を表示、 `WorkflowInstanceId` プロパティは、現在選択されているワークフローを返します。  
+  
+5.  フォームの `Load` イベントのハンドラーを追加します。 切り替えて、ハンドラーを追加する **デザイン ビュー** 、フォームをクリックして、 **イベント** の上部にあるアイコン、 **プロパティ** ウィンドウ、およびダブルクリック **ロード**します。  
+  
+    ```vb  
+    Private Sub WorkflowHostForm_Load(sender As Object, e As EventArgs) Handles Me.Load  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void WorkflowHostForm_Load(object sender, EventArgs e)  
+    {  
+  
+    }  
+    ```  
+  
+6.  `WorkflowHostForm_Load` に次のコードを追加します。  
+  
+    ```vb  
+    'Initialize the store and configure it so that it can be used for  
+    'multiple WorkflowApplication instances.  
+    store = New SqlWorkflowInstanceStore(connectionString)  
+    WorkflowApplication.CreateDefaultInstanceOwner(store, Nothing, WorkflowIdentityFilter.Any)  
+  
+    'Set default ComboBox selections.  
+    NumberRange.SelectedIndex = 0  
+    WorkflowType.SelectedIndex = 0  
+  
+    ListPersistedWorkflows()  
+    ```  
+  
+    ```csharp  
+    // Initialize the store and configure it so that it can be used for  
+    // multiple WorkflowApplication instances.  
+    store = new SqlWorkflowInstanceStore(connectionString);  
+    WorkflowApplication.CreateDefaultInstanceOwner(store, null, WorkflowIdentityFilter.Any);  
+  
+    // Set default ComboBox selections.  
+    NumberRange.SelectedIndex = 0;  
+    WorkflowType.SelectedIndex = 0;  
+  
+    ListPersistedWorkflows();  
+    ```  
+  
+     フォームの読み込み時に、`SqlWorkflowInstanceStore` が構成され、範囲とワークフローの種類のコンボ ボックスが既定値に設定されます。さらに、永続化されたワークフロー インスタンスが `InstanceId` コンボ ボックスに追加されます。  
+  
+7.  `SelectedIndexChanged` の `InstanceId` ハンドラーを追加します。 切り替えて、ハンドラーを追加する **デザイン ビュー** 、フォームの選択、 `InstanceId` コンボ ボックス] をクリックして、 **イベント** の上部にあるアイコン、 **プロパティ** ウィンドウ、およびダブルクリック **SelectedIndexChanged**します。  
+  
+    ```vb  
+    Private Sub InstanceId_SelectedIndexChanged(sender As Object, e As EventArgs) Handles InstanceId.SelectedIndexChanged  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void InstanceId_SelectedIndexChanged(object sender, EventArgs e)  
+    {  
+  
+    }  
+    ```  
+  
+8.  `InstanceId_SelectedIndexChanged` に次のコードを追加します。 ユーザーがコンボ ボックスを使用してワークフローを選択するたびに、このハンドラーによってステータス ウィンドウが更新されます。  
+  
+    ```vb  
+    If InstanceId.SelectedIndex = -1 Then  
+        Return  
+    End If  
+  
+    'Clear the status window.  
+    WorkflowStatus.Clear()  
+  
+    'Get the workflow version and display it.  
+    'If the workflow is just starting then this info will not  
+    'be available in the persistence store so do not try and retrieve it.  
+    If Not WorkflowStarting Then  
+        Dim instance As WorkflowApplicationInstance = _  
+            WorkflowApplication.GetInstance(WorkflowInstanceId, store)  
+  
+        WorkflowVersion.Text = _  
+            WorkflowVersionMap.GetIdentityDescription(instance.DefinitionIdentity)  
+  
+        'Unload the instance.  
+        instance.Abandon()  
+    End If  
+    ```  
+  
+    ```csharp  
+    if (InstanceId.SelectedIndex == -1)  
+    {  
+        return;  
+    }  
+  
+    // Clear the status window.  
+    WorkflowStatus.Clear();  
+  
+    // Get the workflow version and display it.  
+    // If the workflow is just starting then this info will not  
+    // be available in the persistence store so do not try and retrieve it.  
+    if (!WorkflowStarting)  
+    {  
+        WorkflowApplicationInstance instance =  
+            WorkflowApplication.GetInstance(this.WorkflowInstanceId, store);  
+  
+        WorkflowVersion.Text =  
+            WorkflowVersionMap.GetIdentityDescription(instance.DefinitionIdentity);  
+  
+        // Unload the instance.  
+        instance.Abandon();  
+    }  
+    ```  
+  
+9. 次の `ListPersistedWorkflows` メソッドをフォーム クラスに追加します。  
+  
+    ```vb  
+    Private Sub ListPersistedWorkflows()  
+        Using localCon As New SqlConnection(connectionString)  
+            Dim localCmd As String = _  
+                "Select [InstanceId] from [System.Activities.DurableInstancing].[Instances] Order By [CreationTime]"  
+  
+            Dim cmd As SqlCommand = localCon.CreateCommand()  
+            cmd.CommandText = localCmd  
+            localCon.Open()  
+            Using reader As SqlDataReader = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+  
+                While (reader.Read())  
+                    'Get the InstanceId of the persisted Workflow.  
+                    Dim id As Guid = Guid.Parse(reader(0).ToString())  
+                    InstanceId.Items.Add(id)  
+                End While  
+            End Using  
+        End Using  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    using (SqlConnection localCon = new SqlConnection(connectionString))  
+    {  
+        string localCmd =  
+            "Select [InstanceId] from [System.Activities.DurableInstancing].[Instances] Order By [CreationTime]";  
+  
+        SqlCommand cmd = localCon.CreateCommand();  
+        cmd.CommandText = localCmd;  
+        localCon.Open();  
+        using (SqlDataReader reader = cmd.ExecuteReader(CommandBehavior.CloseConnection))  
+        {  
+            while (reader.Read())  
+            {  
+                // Get the InstanceId of the persisted Workflow  
+                Guid id = Guid.Parse(reader[0].ToString());  
+                InstanceId.Items.Add(id);  
+            }  
+        }  
+    }  
+    ```  
+  
+     `ListPersistedWorkflows` は、永続化されたワークフロー インスタンスのインスタンス ストアに対してクエリを実行し、`cboInstanceId` コンボ ボックスにインスタンス ID を追加します。  
+  
+10. 次の `UpdateStatus` メソッドと対応するデリゲートをフォーム クラスに追加します。 このメソッドは、現在実行中のワークフローのステータスでフォーム上のステータス ウィンドウを更新します。  
+  
+    ```vb  
+    Private Delegate Sub UpdateStatusDelegate(msg As String)  
+    Public Sub UpdateStatus(msg As String)  
+        'We may be on a different thread so we need to  
+        'make this call using BeginInvoke.  
+        If InvokeRequired Then  
+            BeginInvoke(New UpdateStatusDelegate(AddressOf UpdateStatus), msg)  
+        Else  
+            If Not msg.EndsWith(vbCrLf) Then  
+                msg = msg & vbCrLf  
+            End If  
+  
+            WorkflowStatus.AppendText(msg)  
+  
+            'Ensure that the newly added status is visible.  
+            WorkflowStatus.SelectionStart = WorkflowStatus.Text.Length  
+            WorkflowStatus.ScrollToCaret()  
+        End If  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private delegate void UpdateStatusDelegate(string msg);  
+    public void UpdateStatus(string msg)  
+    {  
+        // We may be on a different thread so we need to  
+        // make this call using BeginInvoke.  
+        if (InvokeRequired)  
+        {  
+            BeginInvoke(new UpdateStatusDelegate(UpdateStatus), msg);  
+        }  
+        else  
+        {  
+            if (!msg.EndsWith("\r\n"))  
+            {  
+                msg += "\r\n";  
+            }  
+            WorkflowStatus.AppendText(msg);  
+  
+            WorkflowStatus.SelectionStart = WorkflowStatus.Text.Length;  
+            WorkflowStatus.ScrollToCaret();  
+        }  
+    }  
+    ```  
+  
+11. 次の `GameOver` メソッドと対応するデリゲートをフォーム クラスに追加します。 このメソッドが完了したワークフローのインスタンス id を削除して、フォームの UI を更新するワークフローが完了したらから、 **InstanceId** コンボ ボックス。  
+  
+    ```vb  
+    Private Delegate Sub GameOverDelegate()  
+    Private Sub GameOver()  
+        If InvokeRequired Then  
+            BeginInvoke(New GameOverDelegate(AddressOf GameOver))  
+        Else  
+            'Remove this instance from the InstanceId combo box.  
+            InstanceId.Items.Remove(InstanceId.SelectedItem)  
+            InstanceId.SelectedIndex = -1  
+        End If  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private delegate void GameOverDelegate();  
+    private void GameOver()  
+    {  
+        if (InvokeRequired)  
+        {  
+            BeginInvoke(new GameOverDelegate(GameOver));  
+        }  
+        else  
+        {  
+            // Remove this instance from the combo box  
+            InstanceId.Items.Remove(InstanceId.SelectedItem);  
+            InstanceId.SelectedIndex = -1;  
+        }  
+    }  
+    ```  
+  
+###  <a name="a-namebkmkconfigureworkflowapplicationa-to-configure-the-instance-store-workflow-lifecycle-handlers-and-extensions"></a><a name="BKMK_ConfigureWorkflowApplication"></a> インスタンス ストア、ワークフロー ライフ サイクル ハンドラー、および拡張機能を構成するには  
+  
+1.  フォーム クラスに `ConfigureWorkflowApplication` メソッドを追加します。  
+  
+    ```vb  
+    Private Sub ConfigureWorkflowApplication(wfApp As WorkflowApplication)  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void ConfigureWorkflowApplication(WorkflowApplication wfApp)  
+    {      
+    }  
+    ```  
+  
+     このメソッドは `WorkflowApplication` を構成し、目的の拡張機能を追加して、ワークフロー ライフサイクル イベントのハンドラーを追加します。  
+  
+2.  `ConfigureWorkflowApplication` で、`SqlWorkflowInstanceStore` の `WorkflowApplication` を指定します。  
+  
+    ```vb  
+    'Configure the persistence store.  
+    wfApp.InstanceStore = store  
+    ```  
+  
+    ```csharp  
+    // Configure the persistence store.  
+    wfApp.InstanceStore = store;  
+    ```  
+  
+3.  次に、`StringWriter` インスタンスを作成して `Extensions` の `WorkflowApplication` コレクションに追加します。 ときに、 `StringWriter` 拡張に追加されて、すべてがキャプチャされます `WriteLine` アクティビティの出力です。 ワークフローがアイドル状態になると、`WriteLine` の出力を `StringWriter` から抽出してフォームに表示できます。  
+  
+    ```vb  
+    'Add a StringWriter to the extensions. This captures the output  
+    'from the WriteLine activities so we can display it in the form.  
+    Dim sw As New StringWriter()  
+    wfApp.Extensions.Add(sw)  
+    ```  
+  
+    ```csharp  
+    // Add a StringWriter to the extensions. This captures the output  
+    // from the WriteLine activities so we can display it in the form.  
+    StringWriter sw = new StringWriter();  
+    wfApp.Extensions.Add(sw);  
+    ```  
+  
+4.  
+          `Completed` イベントの次のハンドラーを追加します。 ワークフローが正常に完了すると、数値を推測するための順番の数がステータス ウィンドウに表示されます。 ワークフローが終了すると、終了の原因となった例外情報が表示されます。 ハンドラーの末尾で、`GameOver` メソッドが呼び出され、完了したワークフローがワークフローの一覧から削除されます。  
+  
+    ```vb  
+    wfApp.Completed = _  
+        Sub(e As WorkflowApplicationCompletedEventArgs)  
+            If e.CompletionState = ActivityInstanceState.Faulted Then  
+                UpdateStatus(String.Format("Workflow Terminated. Exception: {0}" & vbCrLf & "{1}", _  
+                    e.TerminationException.GetType().FullName, _  
+                    e.TerminationException.Message))  
+            ElseIf e.CompletionState = ActivityInstanceState.Canceled Then  
+                UpdateStatus("Workflow Canceled.")  
+            Else  
+                Dim Turns As Integer = Convert.ToInt32(e.Outputs("Turns"))  
+                UpdateStatus(String.Format("Congratulations, you guessed the number in {0} turns.", Turns))  
+            End If  
+            GameOver()  
+        End Sub  
+    ```  
+  
+    ```csharp  
+    wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)  
+    {  
+        if (e.CompletionState == ActivityInstanceState.Faulted)  
+        {  
+            UpdateStatus(string.Format("Workflow Terminated. Exception: {0}\r\n{1}",  
+                e.TerminationException.GetType().FullName,  
+                e.TerminationException.Message));  
+        }  
+        else if (e.CompletionState == ActivityInstanceState.Canceled)  
+        {  
+            UpdateStatus("Workflow Canceled.");  
+        }  
+        else  
+        {  
+            int Turns = Convert.ToInt32(e.Outputs["Turns"]);  
+            UpdateStatus(string.Format("Congratulations, you guessed the number in {0} turns.", Turns));  
+        }  
+        GameOver();  
+    };  
+    ```  
+  
+5.  次の `Aborted` ハンドラーと `OnUnhandledException` ハンドラーを追加します。 `GameOver` メソッドが `Aborted` ハンドラーから呼び出されることはありません。これは、ワークフロー インスタンスが中止された場合、そのインスタンスは終了せず、後で再開することができるためです。  
+  
+    ```vb  
+    wfApp.Aborted = _  
+        Sub(e As WorkflowApplicationAbortedEventArgs)  
+            UpdateStatus(String.Format("Workflow Aborted. Exception: {0}" & vbCrLf & "{1}", _  
+                e.Reason.GetType().FullName, _  
+                e.Reason.Message))  
+        End Sub  
+  
+    wfApp.OnUnhandledException = _  
+        Function(e As WorkflowApplicationUnhandledExceptionEventArgs)  
+            UpdateStatus(String.Format("Unhandled Exception: {0}" & vbCrLf & "{1}", _  
+                e.UnhandledException.GetType().FullName, _  
+                e.UnhandledException.Message))  
+            GameOver()  
+            Return UnhandledExceptionAction.Terminate  
+        End Function  
+    ```  
+  
+    ```csharp  
+    wfApp.Aborted = delegate(WorkflowApplicationAbortedEventArgs e)  
+    {  
+        UpdateStatus(string.Format("Workflow Aborted. Exception: {0}\r\n{1}",  
+                e.Reason.GetType().FullName,  
+                e.Reason.Message));  
+    };  
+  
+    wfApp.OnUnhandledException = delegate(WorkflowApplicationUnhandledExceptionEventArgs e)  
+    {  
+        UpdateStatus(string.Format("Unhandled Exception: {0}\r\n{1}",  
+                e.UnhandledException.GetType().FullName,  
+                e.UnhandledException.Message));  
+        GameOver();  
+        return UnhandledExceptionAction.Terminate;  
+    };  
+    ```  
+  
+6.  次の `PersistableIdle` ハンドラーを追加します。 このハンドラーは、追加された `StringWriter` 拡張機能を取得し、`WriteLine` アクティビティからの出力を抽出して、ステータス ウィンドウに表示します。  
+  
+    ```vb  
+    wfApp.PersistableIdle = _  
+        Function(e As WorkflowApplicationIdleEventArgs)  
+            'Send the current WriteLine outputs to the status window.  
+            Dim writers = e.GetInstanceExtensions(Of StringWriter)()  
+            For Each writer In writers  
+                UpdateStatus(writer.ToString())  
+            Next  
+            Return PersistableIdleAction.Unload  
+        End Function  
+    ```  
+  
+    ```csharp  
+    wfApp.PersistableIdle = delegate(WorkflowApplicationIdleEventArgs e)  
+    {  
+        // Send the current WriteLine outputs to the status window.  
+        var writers = e.GetInstanceExtensions<StringWriter>();  
+        foreach (var writer in writers)  
+        {  
+            UpdateStatus(writer.ToString());  
+        }  
+        return PersistableIdleAction.Unload;  
+    };  
+    ```  
+  
+      <xref:System.Activities.PersistableIdleAction> 列挙体には 3 つの値: <xref:System.Activities.PersistableIdleAction>, 、<xref:System.Activities.PersistableIdleAction>, 、および <xref:System.Activities.PersistableIdleAction>します。 <xref:System.Activities.PersistableIdleAction> 原因が永続化するワークフローは、ワークフローがアンロードを伴いません。 <xref:System.Activities.PersistableIdleAction> により、ワークフローが永続化され、アンロードされます。  
+  
+     完成した `ConfigureWorkflowApplication` メソッドは次のようになります。  
+  
+    ```vb  
+    Private Sub ConfigureWorkflowApplication(wfApp As WorkflowApplication)  
+        'Configure the persistence store.  
+        wfApp.InstanceStore = store  
+  
+        'Add a StringWriter to the extensions. This captures the output  
+        'from the WriteLine activities so we can display it in the form.  
+        Dim sw As New StringWriter()  
+        wfApp.Extensions.Add(sw)  
+  
+        wfApp.Completed = _  
+            Sub(e As WorkflowApplicationCompletedEventArgs)  
+                If e.CompletionState = ActivityInstanceState.Faulted Then  
+                    UpdateStatus(String.Format("Workflow Terminated. Exception: {0}" & vbCrLf & "{1}", _  
+                        e.TerminationException.GetType().FullName, _  
+                        e.TerminationException.Message))  
+                ElseIf e.CompletionState = ActivityInstanceState.Canceled Then  
+                    UpdateStatus("Workflow Canceled.")  
+                Else  
+                    Dim Turns As Integer = Convert.ToInt32(e.Outputs("Turns"))  
+                    UpdateStatus(String.Format("Congratulations, you guessed the number in {0} turns.", Turns))  
+                End If  
+                GameOver()  
+            End Sub  
+  
+        wfApp.Aborted = _  
+            Sub(e As WorkflowApplicationAbortedEventArgs)  
+                UpdateStatus(String.Format("Workflow Aborted. Exception: {0}" & vbCrLf & "{1}", _  
+                    e.Reason.GetType().FullName, _  
+                    e.Reason.Message))  
+            End Sub  
+  
+        wfApp.OnUnhandledException = _  
+            Function(e As WorkflowApplicationUnhandledExceptionEventArgs)  
+                UpdateStatus(String.Format("Unhandled Exception: {0}" & vbCrLf & "{1}", _  
+                    e.UnhandledException.GetType().FullName, _  
+                    e.UnhandledException.Message))  
+                GameOver()  
+                Return UnhandledExceptionAction.Terminate  
+            End Function  
+  
+        wfApp.PersistableIdle = _  
+            Function(e As WorkflowApplicationIdleEventArgs)  
+                'Send the current WriteLine outputs to the status window.  
+                Dim writers = e.GetInstanceExtensions(Of StringWriter)()  
+                For Each writer In writers  
+                    UpdateStatus(writer.ToString())  
+                Next  
+                Return PersistableIdleAction.Unload  
+            End Function  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void ConfigureWorkflowApplication(WorkflowApplication wfApp)  
+    {  
+        // Configure the persistence store.  
+        wfApp.InstanceStore = store;  
+  
+        // Add a StringWriter to the extensions. This captures the output  
+        // from the WriteLine activities so we can display it in the form.  
+        StringWriter sw = new StringWriter();  
+        wfApp.Extensions.Add(sw);  
+  
+        wfApp.Completed = delegate(WorkflowApplicationCompletedEventArgs e)  
+        {  
+            if (e.CompletionState == ActivityInstanceState.Faulted)  
+            {  
+                UpdateStatus(string.Format("Workflow Terminated. Exception: {0}\r\n{1}",  
+                    e.TerminationException.GetType().FullName,  
+                    e.TerminationException.Message));  
+            }  
+            else if (e.CompletionState == ActivityInstanceState.Canceled)  
+            {  
+                UpdateStatus("Workflow Canceled.");  
+            }  
+            else  
+            {  
+                int Turns = Convert.ToInt32(e.Outputs["Turns"]);  
+                UpdateStatus(string.Format("Congratulations, you guessed the number in {0} turns.", Turns));  
+            }  
+            GameOver();  
+        };  
+  
+        wfApp.Aborted = delegate(WorkflowApplicationAbortedEventArgs e)  
+        {  
+            UpdateStatus(string.Format("Workflow Aborted. Exception: {0}\r\n{1}",  
+                    e.Reason.GetType().FullName,  
+                    e.Reason.Message));  
+        };  
+  
+        wfApp.OnUnhandledException = delegate(WorkflowApplicationUnhandledExceptionEventArgs e)  
+        {  
+            UpdateStatus(string.Format("Unhandled Exception: {0}\r\n{1}",  
+                    e.UnhandledException.GetType().FullName,  
+                    e.UnhandledException.Message));  
+            GameOver();  
+            return UnhandledExceptionAction.Terminate;  
+        };  
+  
+        wfApp.PersistableIdle = delegate(WorkflowApplicationIdleEventArgs e)  
+        {  
+            // Send the current WriteLine outputs to the status window.  
+            var writers = e.GetInstanceExtensions<StringWriter>();  
+            foreach (var writer in writers)  
+            {  
+                UpdateStatus(writer.ToString());  
+            }  
+            return PersistableIdleAction.Unload;  
+        };  
+    }  
+    ```  
+  
+###  <a name="a-namebkmkworkflowversionmapa-to-enable-starting-and-resuming-multiple-workflow-types"></a><a name="BKMK_WorkflowVersionMap"></a> 型を開始してを複数のワークフローの再開を有効にするには  
+ ワークフロー インスタンスを再開するには、ホストはワークフロー定義を指定する必要があります。 このチュートリアルには 3 種類のワークフローがあり、以降の手順では、これらの種類の複数のバージョンを指定します。 `WorkflowIdentity` を使用すると、ホスト アプリケーションは、識別情報を永続化されたワークフロー インスタンスに関連付けることができます。 このセクションの手順では、永続化されたワークフロー インスタンスから対応するワークフロー定義へのワークフロー ID のマッピングに役立つユーティリティ クラスの作成方法を示します。 [!INCLUDE[crabout](../../../includes/crabout-md.md)]`WorkflowIdentity` およびバージョン管理を参照してください [を使用して WorkflowIdentity と Versioning](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md)します。  
+  
+1.  右クリック **NumberGuessWorkflowHost** で **ソリューション エクスプ ローラー** 選択 **追加**, 、**クラス**します。 型 `WorkflowVersionMap` に、 **名前** ボックスし、をクリックして **追加**します。  
+  
+2.  次の `using` または `Imports` ステートメントを、他の `using` または `Imports` ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports NumberGuessWorkflowActivities  
+    Imports System.Activities  
+    ```  
+  
+    ```csharp  
+    using NumberGuessWorkflowActivities;  
+    using System.Activities;  
+    ```  
+  
+3.  `WorkflowVersionMap` クラス宣言を次の宣言に置き換えます。  
+  
+    ```vb  
+    Public Module WorkflowVersionMap  
+        Dim map As Dictionary(Of WorkflowIdentity, Activity)  
+  
+        'Current version identities.  
+        Public StateMachineNumberGuessIdentity As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity As WorkflowIdentity  
+  
+        Sub New()  
+            map = New Dictionary(Of WorkflowIdentity, Activity)  
+  
+            'Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            map.Add(StateMachineNumberGuessIdentity, New StateMachineNumberGuessWorkflow())  
+            map.Add(FlowchartNumberGuessIdentity, New FlowchartNumberGuessWorkflow())  
+            map.Add(SequentialNumberGuessIdentity, New SequentialNumberGuessWorkflow())  
+        End Sub  
+  
+        Public Function GetWorkflowDefinition(identity As WorkflowIdentity) As Activity  
+            Return map(identity)  
+        End Function  
+  
+        Public Function GetIdentityDescription(identity As WorkflowIdentity) As String  
+            Return identity.ToString()  
+        End Function  
+    End Module  
+    ```  
+  
+    ```csharp  
+    public static class WorkflowVersionMap  
+    {  
+        static Dictionary<WorkflowIdentity, Activity> map;  
+  
+        // Current version identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity;  
+  
+        static WorkflowVersionMap()  
+        {  
+            map = new Dictionary<WorkflowIdentity, Activity>();  
+  
+            // Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            map.Add(StateMachineNumberGuessIdentity, new StateMachineNumberGuessWorkflow());  
+            map.Add(FlowchartNumberGuessIdentity, new FlowchartNumberGuessWorkflow());  
+            map.Add(SequentialNumberGuessIdentity, new SequentialNumberGuessWorkflow());  
+        }  
+  
+        public static Activity GetWorkflowDefinition(WorkflowIdentity identity)  
+        {  
+            return map[identity];  
+        }  
+  
+        public static string GetIdentityDescription(WorkflowIdentity identity)  
+        {          
+            return identity.ToString();  
+       }  
+    }  
+    ```  
+  
+     `WorkflowVersionMap` は、このチュートリアルの 3 つのワークフロー定義にマップされる 3 つのワークフロー ID を格納しており、以降のセクションでワークフローが開始および再開されるときに使用されます。  
+  
+###  <a name="a-namebkmkstartworkflowa-to-start-a-new-workflow"></a><a name="BKMK_StartWorkflow"></a> 新しいワークフローを開始するには  
+  
+1.  `Click` の `NewGame` ハンドラーを追加します。 切り替えて、ハンドラーを追加する **デザイン ビュー** をダブルクリックして、フォームの `NewGame`です。 `NewGame_Click` ハンドラーが追加され、ビューがフォームのコード ビューに切り替わります。 ユーザーがこのボタンをクリックするたびに、新しいワークフローが開始されます。  
+  
+    ```vb  
+    Private Sub NewGame_Click(sender As Object, e As EventArgs) Handles NewGame.Click  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void NewGame_Click(object sender, EventArgs e)  
+    {  
+  
+    }  
+    ```  
+  
+2.  Click ハンドラーに次のコードを追加します。 このコードにより、引数名によってキー指定された、ワークフローの入力引数のディクショナリが作成されます。 このディクショナリには、範囲のコンボ ボックスから取得したランダムに生成された数値の範囲を含む 1 つのエントリがあります。  
+  
+    ```vb  
+    Dim inputs As New Dictionary(Of String, Object)()  
+    inputs.Add("MaxNumber", Convert.ToInt32(NumberRange.SelectedItem))  
+    ```  
+  
+    ```csharp  
+    var inputs = new Dictionary<string, object>();  
+    inputs.Add("MaxNumber", Convert.ToInt32(NumberRange.SelectedItem));  
+    ```  
+  
+3.  次に、ワークフローを開始する次のコードを追加します。 選択されたワークフローの種類に対応する `WorkflowIdentity` とワークフロー定義が `WorkflowVersionMap` ヘルパー クラスを使用して取得されます。 さらに、新しい `WorkflowApplication` インスタンスを作成するには、ワークフロー定義、`WorkflowIdentity`、および入力引数のディクショナリを使用します。  
+  
+    ```vb  
+    Dim identity As WorkflowIdentity = Nothing  
+    Select Case WorkflowType.SelectedItem.ToString()  
+        Case "SequentialNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity  
+  
+        Case "StateMachineNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity  
+  
+        Case "FlowchartNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity  
+    End Select  
+  
+    Dim wf As Activity = WorkflowVersionMap.GetWorkflowDefinition(identity)  
+  
+    Dim wfApp = New WorkflowApplication(wf, inputs, identity)  
+    ```  
+  
+    ```csharp  
+    WorkflowIdentity identity = null;  
+    switch (WorkflowType.SelectedItem.ToString())  
+    {  
+        case "SequentialNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity;  
+            break;  
+  
+        case "StateMachineNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity;  
+            break;  
+  
+        case "FlowchartNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity;  
+            break;  
+    };  
+  
+    Activity wf = WorkflowVersionMap.GetWorkflowDefinition(identity);  
+  
+    WorkflowApplication wfApp = new WorkflowApplication(wf, inputs, identity);  
+    ```  
+  
+4.  次に、ワークフローの一覧にワークフローを追加し、フォーム上にワークフローのバージョン情報を表示する次のコードを追加します。  
+  
+    ```vb  
+    'Add the workflow to the list and display the version information.  
+    WorkflowStarting = True  
+    InstanceId.SelectedIndex = InstanceId.Items.Add(wfApp.Id)  
+    WorkflowVersion.Text = identity.ToString()  
+    WorkflowStarting = False  
+    ```  
+  
+    ```csharp  
+    // Add the workflow to the list and display the version information.  
+    WorkflowStarting = true;  
+    InstanceId.SelectedIndex = InstanceId.Items.Add(wfApp.Id);  
+    WorkflowVersion.Text = identity.ToString();  
+    WorkflowStarting = false;  
+    ```  
+  
+5.  `ConfigureWorkflowApplication` を呼び出して、この `WorkflowApplication` インスタンスのインスタンス ストア、拡張機能、およびワークフロー ライフサイクル ハンドラーを構成します。  
+  
+    ```vb  
+    'Configure the instance store, extensions, and   
+    'workflow lifecycle handlers.  
+    ConfigureWorkflowApplication(wfApp)  
+    ```  
+  
+    ```csharp  
+    // Configure the instance store, extensions, and   
+    // workflow lifecycle handlers.  
+    ConfigureWorkflowApplication(wfApp);  
+    ```  
+  
+6.  最後に、`Run` を呼び出します。  
+  
+    ```vb  
+    'Start the workflow.  
+    wfApp.Run()  
+    ```  
+  
+    ```  
+    // Start the workflow.  
+    wfApp.Run();  
+    ```  
+  
+     完成した `NewGame_Click` ハンドラーは次のようになります。  
+  
+    ```vb  
+    Private Sub NewGame_Click(sender As Object, e As EventArgs) Handles NewGame.Click  
+        'Start a new workflow.  
+        Dim inputs As New Dictionary(Of String, Object)()  
+        inputs.Add("MaxNumber", Convert.ToInt32(NumberRange.SelectedItem))  
+  
+        Dim identity As WorkflowIdentity = Nothing  
+        Select Case WorkflowType.SelectedItem.ToString()  
+            Case "SequentialNumberGuessWorkflow"  
+                identity = WorkflowVersionMap.SequentialNumberGuessIdentity  
+  
+            Case "StateMachineNumberGuessWorkflow"  
+                identity = WorkflowVersionMap.StateMachineNumberGuessIdentity  
+  
+            Case "FlowchartNumberGuessWorkflow"  
+                identity = WorkflowVersionMap.FlowchartNumberGuessIdentity  
+        End Select  
+  
+        Dim wf As Activity = WorkflowVersionMap.GetWorkflowDefinition(identity)  
+  
+        Dim wfApp = New WorkflowApplication(wf, inputs, identity)  
+  
+        'Add the workflow to the list and display the version information.  
+        WorkflowStarting = True  
+        InstanceId.SelectedIndex = InstanceId.Items.Add(wfApp.Id)  
+        WorkflowVersion.Text = identity.ToString()  
+        WorkflowStarting = False  
+  
+        'Configure the instance store, extensions, and   
+        'workflow lifecycle handlers.  
+        ConfigureWorkflowApplication(wfApp)  
+  
+        'Start the workflow.  
+        wfApp.Run()  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void NewGame_Click(object sender, EventArgs e)  
+    {  
+        var inputs = new Dictionary<string, object>();  
+        inputs.Add("MaxNumber", Convert.ToInt32(NumberRange.SelectedItem));  
+  
+        WorkflowIdentity identity = null;  
+        switch (WorkflowType.SelectedItem.ToString())  
+        {  
+            case "SequentialNumberGuessWorkflow":  
+                identity = WorkflowVersionMap.SequentialNumberGuessIdentity;  
+                break;  
+  
+            case "StateMachineNumberGuessWorkflow":  
+                identity = WorkflowVersionMap.StateMachineNumberGuessIdentity;  
+                break;  
+  
+            case "FlowchartNumberGuessWorkflow":  
+                identity = WorkflowVersionMap.FlowchartNumberGuessIdentity;  
+                break;  
+        };  
+  
+        Activity wf = WorkflowVersionMap.GetWorkflowDefinition(identity);  
+  
+        WorkflowApplication wfApp = new WorkflowApplication(wf, inputs, identity);  
+  
+        // Add the workflow to the list and display the version information.  
+        WorkflowStarting = true;  
+        InstanceId.SelectedIndex = InstanceId.Items.Add(wfApp.Id);  
+        WorkflowVersion.Text = identity.ToString();  
+        WorkflowStarting = false;  
+  
+        // Configure the instance store, extensions, and   
+        // workflow lifecycle handlers.  
+        ConfigureWorkflowApplication(wfApp);  
+  
+        // Start the workflow.  
+        wfApp.Run();  
+    }  
+    ```  
+  
+###  <a name="a-namebkmkresumeworkflowa-to-resume-a-workflow"></a><a name="BKMK_ResumeWorkflow"></a> ワークフローを再開するには  
+  
+1.  `Click` の `EnterGuess` ハンドラーを追加します。 切り替えて、ハンドラーを追加する **デザイン ビュー** をダブルクリックして、フォームの `EnterGuess`です。 ユーザーがこのボタンをクリックするたびに、ワークフローが再開されます。  
+  
+    ```vb  
+    Private Sub EnterGuess_Click(sender As Object, e As EventArgs) Handles EnterGuess.Click  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void EnterGuess_Click(object sender, EventArgs e)  
+    {  
+  
+    }  
+    ```  
+  
+2.  ワークフローがワークフローの一覧で選択され、ユーザーの推定値が有効であることを確認するために、次のコードを追加します。  
+  
+    ```vb  
+    If WorkflowInstanceId = Guid.Empty Then  
+        MessageBox.Show("Please select a workflow.")  
+        Return  
+    End If  
+  
+    Dim userGuess As Integer  
+    If Not Int32.TryParse(Guess.Text, userGuess) Then  
+        MessageBox.Show("Please enter an integer.")  
+        Guess.SelectAll()  
+        Guess.Focus()  
+        Return  
+    End If  
+    ```  
+  
+    ```csharp  
+    if (WorkflowInstanceId == Guid.Empty)  
+    {  
+        MessageBox.Show("Please select a workflow.");  
+        return;  
+    }  
+  
+    int guess;  
+    if (!Int32.TryParse(Guess.Text, out guess))  
+    {  
+        MessageBox.Show("Please enter an integer.");  
+        Guess.SelectAll();  
+        Guess.Focus();  
+        return;  
+    }  
+    ```  
+  
+3.  次に、永続化されたワークフロー インスタンスの `WorkflowApplicationInstance` を取得します。 `WorkflowApplicationInstance` は、ワークフロー定義にまだ関連付けられていない永続化されたワークフロー インスタンスを表します。 `DefinitionIdentity` の `WorkflowApplicationInstance` には、永続化されたワークフロー インスタンスの `WorkflowIdentity` が含まれます。 このチュートリアルでは、`WorkflowVersionMap` を適切なワークフロー定義にマップするために、`WorkflowIdentity` ユーティリティ クラスが使用されます。 ワークフロー定義が取得されると、`WorkflowApplication` が、適切なワークフロー定義を使用して作成されます。  
+  
+    ```vb  
+    Dim instance As WorkflowApplicationInstance = _  
+        WorkflowApplication.GetInstance(WorkflowInstanceId, store)  
+  
+    'Use the persisted WorkflowIdentity to retrieve the correct workflow  
+    'definition from the dictionary.  
+    Dim wf As Activity = _  
+        WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity)  
+  
+    'Associate the WorkflowApplication with the correct definition  
+    Dim wfApp As WorkflowApplication = _  
+        New WorkflowApplication(wf, instance.DefinitionIdentity)  
+    ```  
+  
+    ```csharp  
+    WorkflowApplicationInstance instance =  
+        WorkflowApplication.GetInstance(WorkflowInstanceId, store);  
+  
+    // Use the persisted WorkflowIdentity to retrieve the correct workflow  
+    // definition from the dictionary.  
+    Activity wf =  
+        WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity);  
+  
+    // Associate the WorkflowApplication with the correct definition  
+    WorkflowApplication wfApp =  
+        new WorkflowApplication(wf, instance.DefinitionIdentity);  
+    ```  
+  
+4.  `WorkflowApplication` が作成されたら、`ConfigureWorkflowApplication` を呼び出してインスタンス ストア、ワークフロー ライフサイクル ハンドラー、および拡張機能を構成します。 これらの手順は、新しい `WorkflowApplication` が作成されるたびに行う必要があります。また、ワークフロー インスタンスが `WorkflowApplication` に読み込まれる前に行う必要があります。 ワークフローは、読み込まれた後、ユーザーの推定値を使用して再開されます。  
+  
+    ```vb  
+    'Configure the extensions and lifecycle handlers.  
+    'Do this before the instance is loaded. Once the instance is  
+    'loaded it is too late to add extensions.  
+    ConfigureWorkflowApplication(wfApp)  
+  
+    'Load the workflow.  
+    wfApp.Load(instance)  
+  
+    'Resume the workflow.  
+    wfApp.ResumeBookmark("EnterGuess", userGuess)  
+    ```  
+  
+    ```csharp  
+    // Configure the extensions and lifecycle handlers.  
+    // Do this before the instance is loaded. Once the instance is  
+    // loaded it is too late to add extensions.  
+    ConfigureWorkflowApplication(wfApp);  
+  
+    // Load the workflow.  
+    wfApp.Load(instance);  
+  
+    // Resume the workflow.  
+    wfApp.ResumeBookmark("EnterGuess", guess);  
+    ```  
+  
+5.  最後に、Guess テキスト ボックスをクリアして、別の推定値を受け取るようにフォームを準備します。  
+  
+    ```vb  
+    'Clear the Guess textbox.  
+    Guess.Clear()  
+    Guess.Focus()  
+    ```  
+  
+    ```csharp  
+    // Clear the Guess textbox.  
+    Guess.Clear();  
+    Guess.Focus();  
+    ```  
+  
+     完成した `EnterGuess_Click` ハンドラーは次のようになります。  
+  
+    ```vb  
+    Private Sub EnterGuess_Click(sender As Object, e As EventArgs) Handles EnterGuess.Click  
+        If WorkflowInstanceId = Guid.Empty Then  
+            MessageBox.Show("Please select a workflow.")  
+            Return  
+        End If  
+  
+        Dim userGuess As Integer  
+        If Not Int32.TryParse(Guess.Text, userGuess) Then  
+            MessageBox.Show("Please enter an integer.")  
+            Guess.SelectAll()  
+            Guess.Focus()  
+            Return  
+        End If  
+  
+        Dim instance As WorkflowApplicationInstance = _  
+            WorkflowApplication.GetInstance(WorkflowInstanceId, store)  
+  
+        'Use the persisted WorkflowIdentity to retrieve the correct workflow  
+        'definition from the dictionary.  
+        Dim wf As Activity = _  
+            WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity)  
+  
+        'Associate the WorkflowApplication with the correct definition  
+        Dim wfApp As WorkflowApplication = _  
+            New WorkflowApplication(wf, instance.DefinitionIdentity)  
+  
+        'Configure the extensions and lifecycle handlers.  
+        'Do this before the instance is loaded. Once the instance is  
+        'loaded it is too late to add extensions.  
+        ConfigureWorkflowApplication(wfApp)  
+  
+        'Load the workflow.  
+        wfApp.Load(instance)  
+  
+        'Resume the workflow.  
+        wfApp.ResumeBookmark("EnterGuess", userGuess)  
+  
+        'Clear the Guess textbox.  
+        Guess.Clear()  
+        Guess.Focus()  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void EnterGuess_Click(object sender, EventArgs e)  
+    {  
+        if (WorkflowInstanceId == Guid.Empty)  
+        {  
+            MessageBox.Show("Please select a workflow.");  
+            return;  
+        }  
+  
+        int guess;  
+        if (!Int32.TryParse(Guess.Text, out guess))  
+        {  
+            MessageBox.Show("Please enter an integer.");  
+            Guess.SelectAll();  
+            Guess.Focus();  
+            return;  
+        }  
+  
+        WorkflowApplicationInstance instance =  
+            WorkflowApplication.GetInstance(WorkflowInstanceId, store);  
+  
+        // Use the persisted WorkflowIdentity to retrieve the correct workflow  
+        // definition from the dictionary.  
+        Activity wf =  
+            WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity);  
+  
+        // Associate the WorkflowApplication with the correct definition  
+        WorkflowApplication wfApp =  
+            new WorkflowApplication(wf, instance.DefinitionIdentity);  
+  
+        // Configure the extensions and lifecycle handlers.  
+        // Do this before the instance is loaded. Once the instance is  
+        // loaded it is too late to add extensions.  
+        ConfigureWorkflowApplication(wfApp);  
+  
+        // Load the workflow.  
+        wfApp.Load(instance);  
+  
+        // Resume the workflow.  
+        wfApp.ResumeBookmark("EnterGuess", guess);  
+  
+        // Clear the Guess textbox.  
+        Guess.Clear();  
+        Guess.Focus();  
+    }  
+    ```  
+  
+###  <a name="a-namebkmkterminateworkflowa-to-terminate-a-workflow"></a><a name="BKMK_TerminateWorkflow"></a> ワークフローを終了するには  
+  
+1.  `Click` の `QuitGame` ハンドラーを追加します。 切り替えて、ハンドラーを追加する **デザイン ビュー** をダブルクリックして、フォームの `QuitGame`です。 ユーザーがこのボタンをクリックするたびに、現在選択されているワークフローが終了します。  
+  
+    ```vb  
+    Private Sub QuitGame_Click(sender As Object, e As EventArgs) Handles QuitGame.Click  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void QuitGame_Click(object sender, EventArgs e)  
+    {  
+  
+    }  
+    ```  
+  
+2.  次のコードを `QuitGame_Click` ハンドラーに追加します。 このコードは、まず、ワークフローの一覧でワークフローが選択されているかどうかを確認します。 その後、永続化されたインスタンスが `WorkflowApplicationInstance` に読み込まれ、`DefinitionIdentity` を使用して適切なワークフロー定義を判断し、`WorkflowApplication` を初期化します。 次に、拡張機能とワークフロー ライフサイクル ハンドラーは、`ConfigureWorkflowApplication` の呼び出しによって構成されます。 `WorkflowApplication` は構成された後に読み込まれ、その後 `Terminate` によって呼び出されます。  
+  
+    ```vb  
+    If WorkflowInstanceId = Guid.Empty Then  
+        MessageBox.Show("Please select a workflow.")  
+        Return  
+    End If  
+  
+    Dim instance As WorkflowApplicationInstance = _  
+        WorkflowApplication.GetInstance(WorkflowInstanceId, store)  
+  
+    'Use the persisted WorkflowIdentity to retrieve the correct workflow  
+    'definition from the dictionary.  
+    Dim wf As Activity = WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity)  
+  
+    'Associate the WorkflowApplication with the correct definition.  
+    Dim wfApp As WorkflowApplication = _  
+        New WorkflowApplication(wf, instance.DefinitionIdentity)  
+  
+    'Configure the extensions and lifecycle handlers.  
+    ConfigureWorkflowApplication(wfApp)  
+  
+    'Load the workflow.  
+    wfApp.Load(instance)  
+  
+    'Terminate the workflow.  
+    wfApp.Terminate("User resigns.")  
+    ```  
+  
+    ```csharp  
+    if (WorkflowInstanceId == Guid.Empty)  
+    {  
+        MessageBox.Show("Please select a workflow.");  
+        return;  
+    }  
+  
+    WorkflowApplicationInstance instance =  
+        WorkflowApplication.GetInstance(WorkflowInstanceId, store);  
+  
+    // Use the persisted WorkflowIdentity to retrieve the correct workflow  
+    // definition from the dictionary.  
+    Activity wf = WorkflowVersionMap.GetWorkflowDefinition(instance.DefinitionIdentity);  
+  
+    // Associate the WorkflowApplication with the correct definition  
+    WorkflowApplication wfApp =  
+        new WorkflowApplication(wf, instance.DefinitionIdentity);  
+  
+    // Configure the extensions and lifecycle handlers  
+    ConfigureWorkflowApplication(wfApp);  
+  
+    // Load the workflow.  
+    wfApp.Load(instance);  
+  
+    // Terminate the workflow.  
+    wfApp.Terminate("User resigns.");  
+    ```  
+  
+###  <a name="a-namebkmkbuildandruna-to-build-and-run-the-application"></a><a name="BKMK_BuildAndRun"></a> ビルドして、アプリケーションの実行  
+  
+1.  ダブルクリックして **Program.cs** (または **Module1.vb**) で **ソリューション エクスプ ローラー** コードを表示します。  
+  
+2.  次の `using` (または `Imports`) ステートメントを、他の `using` (または `Imports`) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Windows.Forms  
+    ```  
+  
+    ```csharp  
+    using System.Windows.Forms;  
+    ```  
+  
+3.  削除またはコメント アウト既存のワークフロー ホスティング コードを [方法: ワークフローを実行する](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md), 、次のコードに置き換えます。  
+  
+    ```vb  
+    Sub Main()  
+        Application.EnableVisualStyles()  
+        Application.Run(New WorkflowHostForm())  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    static void Main(string[] args)  
+    {  
+        Application.EnableVisualStyles();  
+        Application.Run(new WorkflowHostForm());  
+    }  
+    ```  
+  
+4.  右クリック **NumberGuessWorkflowHost** で **ソリューション エクスプ ローラー** 選択 **プロパティ**します。  **アプリケーション** タブで、指定 **Windows アプリケーション** の **出力の種類**します。 この手順は省略可能ですが、省略した場合は、フォームに加えてコンソール ウィンドウが表示されます。  
+  
+5.  Ctrl キーと Shift キーを押しながら B キーを押してアプリケーションをビルドします。  
+  
+6.  いることを確認 **NumberGuessWorkflowHost** が設定されているスタートアップ アプリケーションとしてアプリケーションを起動するには、Ctrl + F5 キーを押します。  
+  
+7.  推測ゲームを開始、およびをクリックするワークフローの種類の範囲を選択 **新しいゲーム**します。 推定値を入力して、 **推測** ボックスし、をクリックして **移動** 、推定値を送信します。 `WriteLine` アクティビティからの出力がフォームに表示されることに注意してください。  
+  
+8.  異なるワークフローの種類と数値の範囲を使用して複数のワークフローを開始し、いくつかの推定値を入力し、ワークフローからを選択して切り替える、 **ワークフロー インスタンス Id** ] ボックスの一覧です。  
+  
+     新しいワークフローに切り替えると、前の推定値とワークフローの進行状況はステータス ウィンドウに表示されません。 ステータスが利用できない理由は、ステータスがキャプチャされず、どこにも保存されないためです。 チュートリアルでは、次の手順で [方法: カスタム追跡参加要素を作成](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-tracking-participant.md), 、この情報を保存するカスタム追跡参加要素を作成します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-deserialize-instance-data-properties.md b/docs/framework/windows-workflow-foundation/how-to-deserialize-instance-data-properties.md
new file mode 100644
index 00000000000..e4e4f374016
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-deserialize-instance-data-properties.md
@@ -0,0 +1,256 @@
+---
+title: "方法: インスタンス データ プロパティを逆シリアル化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b13a3508-1b97-4359-b336-03d85fa23bc4
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 方法: インスタンス データ プロパティを逆シリアル化する
+ユーザーまたはワークフロー管理者は、永続化されたワークフロー インスタンスの状態を手動で調べることが必要になる場合があります。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> は、次の 4 列を公開するインスタンス テーブルに関するビューを提供します。  
+  
+-   ReadWritePrimitiveDataProperties  
+  
+-   WriteOnlyPrimitiveDataProperties  
+  
+-   ReadWriteComplexDataProperties  
+  
+-   WriteOnlyComplexDataProperties  
+  
+ プリミティブ データ プロパティは、.NET Framework 型が "一般的" であると見なされているプロパティ \(Int32 や String など\) を表し、複合データ プロパティは他のすべての型を表します。プリミティブ型の正確な列挙については、後で示すコード例を参照してください。  
+  
+ 読み取り\/書き込みプロパティは、インスタンスが読み込まれるときに、ワークフロー ランタイムに戻されるプロパティを表します。WriteOnly プロパティは、データベースに書き込まれた後に再度読み取られることはありません。  
+  
+ この例では、プリミティブ データ プロパティを逆シリアル化できるコードを示します。ReadWritePrimitiveDataProperties 列または WriteOnlyPrimitiveDataProperties 列からバイト配列が読み取られることを前提として、このコードはバイナリ ラージ オブジェクト \(BLOB\) を、キー\/値の各ペアがプロパティ名と対応する値を表す \<XName, object\> 型の <xref:System.Collections.Generic.Dictionary%601> に変換します。  
+  
+ 複合データ プロパティを逆シリアル化する操作は現在サポートされていないので、この例ではその方法は示しません。  
+  
+```  
+  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.IO;  
+using System.IO.Compression;  
+using System.Xml.Linq;  
+using System.Xml;  
+using System.Globalization;  
+using System.Data.SqlClient;  
+  
+namespace PropertyReader  
+{  
+    class Program  
+    {  
+        const string ConnectionString = @"Data Source=localhost;Initial Catalog=Persistence;Integrated Security=True;Asynchronous Processing=True";  
+        static void Main(string[] args)  
+        {  
+            string queryString = "SELECT TOP 10 * FROM [System.Activities.DurableInstancing].[Instances]";  
+  
+            using (SqlConnection connection =  
+                       new SqlConnection(ConnectionString))  
+            {  
+                SqlCommand command =  
+                    new SqlCommand(queryString, connection);  
+                connection.Open();  
+  
+                SqlDataReader reader = command.ExecuteReader();  
+  
+                byte encodingOption;  
+  
+                while (reader.Read())  
+                {  
+                    if (reader["ReadWritePrimitiveDataProperties"] != DBNull.Value)  
+                    {  
+                        encodingOption = (byte)reader["EncodingOption"];  
+                        Console.WriteLine("Printing the ReadWritePrimitiveDataProperties of the instance with Id:" + reader["InstanceId"]);  
+                        foreach (KeyValuePair<XName, object> pair in (Dictionary<XName, object>)ReadDataProperties((byte[])reader["ReadWritePrimitiveDataProperties"], encodingOption))  
+                        {  
+                            Console.WriteLine("{0}, {1}" , pair.Key, pair.Value);  
+                        }  
+                        Console.WriteLine();  
+                    }  
+                    if (reader["WriteOnlyPrimitiveDataProperties"] != DBNull.Value)  
+                    {  
+                        encodingOption = (byte)reader["EncodingOption"];  
+                        Console.WriteLine("Printing the WriteOnlyPrimitiveDataProperties of the instance with Id:" + reader["InstanceId"]);  
+                        foreach (KeyValuePair<XName, object> pair in (Dictionary<XName, object>)ReadDataProperties((byte[])reader["WriteOnlyPrimitiveDataProperties"], encodingOption))  
+                        {  
+                            Console.WriteLine("{0}, {1}", pair.Key, pair.Value);  
+                        }  
+                        Console.WriteLine();  
+                    }  
+                }  
+  
+                // Call Close when done reading.  
+                reader.Close();  
+            }  
+  
+            Console.ReadLine();  
+  
+        }  
+  
+        static Dictionary<XName, object> ReadDataProperties(byte[] serializedDataProperties, byte encodingOption)  
+        {  
+            if (serializedDataProperties != null)  
+            {  
+                Dictionary<XName, object> propertyBag = new Dictionary<XName, object>();  
+                bool isCompressed = (encodingOption == 1);  
+  
+                using (MemoryStream memoryStream = new MemoryStream(serializedDataProperties))  
+                {  
+                    // if the instance state is compressed using GZip algorithm  
+                    if (isCompressed)  
+                    {  
+                        // decompress the data using the GZip   
+                        using (GZipStream stream = new GZipStream(memoryStream, CompressionMode.Decompress))  
+                        {  
+                            // create an XmlReader object and pass it on to the helper method ReadPrimitiveDataProperties  
+                            using (XmlReader reader = XmlDictionaryReader.CreateBinaryReader(stream, XmlDictionaryReaderQuotas.Max))  
+                            {  
+                                // invoke the helper method  
+                                ReadPrimitiveDataProperties(reader, propertyBag);  
+                            }  
+                        }  
+                    }  
+                    else  
+                    {  
+                        // if the instance data is not compressed   
+                        // create an XmlReader object and pass it on to the helper method ReadPrimitiveDataProperties  
+                        using (XmlReader reader = XmlDictionaryReader.CreateBinaryReader(memoryStream, XmlDictionaryReaderQuotas.Max))  
+                        {  
+                            // invoke the helper method  
+                            ReadPrimitiveDataProperties(reader, propertyBag);  
+                        }  
+                    }  
+                    return propertyBag;  
+                }  
+            }  
+  
+            return null;  
+        }  
+  
+        // reads the primitive data properties from the XML stream  
+        // invoked by the ReadDataProperties method  
+        static void ReadPrimitiveDataProperties(XmlReader reader, Dictionary<XName, object> propertyBag)  
+        {  
+            const string xmlElementName = "Property";  
+  
+            if (reader.ReadToDescendant(xmlElementName))  
+            {  
+                do  
+                {  
+                    // get the name of the property  
+                    reader.MoveToFirstAttribute();  
+                    string propertyName = reader.Value;  
+  
+                    // get the type of the property  
+                    reader.MoveToNextAttribute();  
+                    PrimitiveType type = (PrimitiveType)Int32.Parse(reader.Value, CultureInfo.InvariantCulture);  
+  
+                    // get the value of the property  
+                    reader.MoveToNextAttribute();  
+                    object propertyValue = ConvertStringToNativeType(reader.Value, type);  
+  
+                    // add the name and value of the property to the property bag  
+                    propertyBag.Add(propertyName, propertyValue);  
+                }  
+  
+                while (reader.ReadToNextSibling(xmlElementName));  
+            }  
+        }  
+  
+        // invoked by the ReadPrimitiveDataProperties method  
+        // Given a property value as parsed from an XML attribute, and the .NET Type of the Property, recreates the actual property value  
+        // (e.g. Given a property value of "1" and a PrimitiveType of Int32, this method will return an object of type Int32 with value 1)  
+        static object ConvertStringToNativeType(string value, PrimitiveType type)  
+        {  
+            switch (type)  
+            {  
+                case PrimitiveType.Bool:  
+                    return XmlConvert.ToBoolean(value);  
+                case PrimitiveType.Byte:  
+                    return XmlConvert.ToByte(value);  
+                case PrimitiveType.Char:  
+                    return XmlConvert.ToChar(value);  
+                case PrimitiveType.DateTime:  
+                    return XmlConvert.ToDateTime(value, XmlDateTimeSerializationMode.RoundtripKind);  
+                case PrimitiveType.DateTimeOffset:  
+                    return XmlConvert.ToDateTimeOffset(value);  
+                case PrimitiveType.Decimal:  
+                    return XmlConvert.ToDecimal(value);  
+                case PrimitiveType.Double:  
+                    return XmlConvert.ToDouble(value);  
+                case PrimitiveType.Float:  
+                    return float.Parse(value, CultureInfo.InvariantCulture);  
+                case PrimitiveType.Guid:  
+                    return XmlConvert.ToGuid(value);  
+                case PrimitiveType.Int:  
+                    return XmlConvert.ToInt32(value);  
+                case PrimitiveType.Long:  
+                    return XmlConvert.ToInt64(value);  
+                case PrimitiveType.SByte:  
+                    return XmlConvert.ToSByte(value);  
+                case PrimitiveType.Short:  
+                    return XmlConvert.ToInt16(value);  
+                case PrimitiveType.String:  
+                    return value;  
+                case PrimitiveType.TimeSpan:  
+                    return XmlConvert.ToTimeSpan(value);  
+                case PrimitiveType.Type:  
+                    return Type.GetType(value);  
+                case PrimitiveType.UInt:  
+                    return XmlConvert.ToUInt32(value);  
+                case PrimitiveType.ULong:  
+                    return XmlConvert.ToUInt64(value);  
+                case PrimitiveType.Uri:  
+                    return new Uri(value);  
+                case PrimitiveType.UShort:  
+                    return XmlConvert.ToUInt16(value);  
+                case PrimitiveType.XmlQualifiedName:  
+                    return new XmlQualifiedName(value);  
+                case PrimitiveType.Null:  
+                case PrimitiveType.Unavailable:  
+                default:  
+                    return null;  
+            }  
+        }  
+        // .NET Types which SQL Workflow Instance Store considers to be Primitive. Any other .NET type not listed in this enumeration is a "Complex" property.  
+        enum PrimitiveType  
+        {  
+            Bool = 0,  
+            Byte,  
+            Char,  
+            DateTime,  
+            DateTimeOffset,  
+            Decimal,  
+            Double,  
+            Float,  
+            Guid,  
+            Int,  
+            Null,  
+            Long,  
+            SByte,  
+            Short,  
+            String,  
+            TimeSpan,  
+            Type,  
+            UInt,  
+            ULong,  
+            Uri,  
+            UShort,  
+            XmlQualifiedName,  
+            Unavailable = 99  
+        }  
+    }  
+}  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-display-validation-errors-in-a-rehosted-designer.md b/docs/framework/windows-workflow-foundation/how-to-display-validation-errors-in-a-rehosted-designer.md
new file mode 100644
index 00000000000..c2cd1c20292
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-display-validation-errors-in-a-rehosted-designer.md
@@ -0,0 +1,52 @@
+---
+title: "方法: 再ホストされたデザイナーの検証エラーを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5aa8fb53-8f75-433b-bc06-7c7d33583d5d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 方法: 再ホストされたデザイナーの検証エラーを表示する
+このトピックでは、再ホストされた [!INCLUDE[wfd1](../../../includes/wfd1-md.md)]で検証エラーを取得および発行する方法について説明します。再ホストされたデザイナー内のワークフローが有効であることを確認するために手順を示します。  
+  
+ このタスクは 2 つの部分で構成されています。最初に、<xref:System.Activities.Presentation.Validation.IValidationErrorService> を実装します。このインターフェイスには、1 つの重要なメソッド <xref:System.Activities.Presentation.Validation.IValidationErrorService.ShowValidationErrors%2A> を実装します。このメソッドは、エラーに関する情報を含む <xref:System.Activities.Presentation.Validation.ValidationErrorInfo> オブジェクトの一覧をデバッグ ログに渡します。このインターフェイスを実装した後に、その実装のインスタンスを編集コンテキストに発行して、エラー情報を取得します。  
+  
+### IValidationErrorService インターフェイスの実装  
+  
+1.  以下に、検証エラーをデバッグ ログに書き込む単純な実装を表すコード例を示します。  
+  
+    ```  
+  
+    using System.Activities.Presentation.Validation;  
+    using System.Collections.Generic;  
+    using System.Diagnostics;  
+    using System.Linq;  
+  
+    namespace VariableFinderShell  
+    {  
+        class DebugValidationErrorService : IValidationErrorService  
+        {  
+            public void ShowValidationErrors(IList<ValidationErrorInfo> errors)  
+            {  
+                errors.ToList().ForEach(vei => Debug.WriteLine(string.Format("Error: {0} ", vei.Message)));  
+            }  
+        }  
+    }  
+    ```  
+  
+### 編集コンテキストへの発行  
+  
+1.  以下に、編集コンテキストに発行するコードを示します。  
+  
+    ```  
+  
+    wd.Context.Services.Publish<IValidationErrorService>(new DebugValidationErrorService());  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-enable-persistence-for-workflows-and-workflow-services.md b/docs/framework/windows-workflow-foundation/how-to-enable-persistence-for-workflows-and-workflow-services.md
new file mode 100644
index 00000000000..8b49e3fb5bd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-enable-persistence-for-workflows-and-workflow-services.md
@@ -0,0 +1,71 @@
+---
+title: "ワークフローとワークフロー サービスの永続化を有効にする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2b1c8bf3-9866-45a4-b06d-ee562393e503
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ワークフローとワークフロー サービスの永続化を有効にする方法
+ここでは、ワークフローとワークフロー サービスの永続化を有効にする方法について説明します。  
+  
+## ワークフローの永続化を有効にする  
+ <xref:System.Activities.WorkflowApplication> クラスの <xref:System.Activities.WorkflowApplication.InstanceStore%2A> プロパティを使用して、インスタンス ストアと **WorkflowApplication** を関連付けることができます。<xref:System.Activities.WorkflowApplication.Persist%2A> メソッドは、アプリケーションに関連付けられたインスタンス ストアにワークフローを保存または永続化します。<xref:System.Activities.WorkflowApplication.Unload%2A> メソッドは、ワークフローをインスタンス ストアに永続化し、メモリからインスタンスをアンロードします。**Load** メソッドは、インスタンスの永続化ストアに格納されているワークフロー データを使用し、ワークフローをメモリに読み込みます。  
+  
+ **Persist** メソッドは、次の手順を実行します。  
+  
+1.  ワークフローのスケジューラを一時停止し、アイドル状態に移行するまで待機します。  
+  
+2.  ワークフローを永続化 \(永続化ストアに保存\) します。  
+  
+3.  ワークフローのスケジューラを再開します。  
+  
+ **Unload** メソッドは、次の手順を実行します。  
+  
+1.  ワークフローのスケジューラを一時停止し、アイドル状態に移行するまで待機します。  
+  
+2.  ワークフローを永続化 \(永続化ストアに保存\) します。  
+  
+3.  メモリ内のワークフロー インスタンスを破棄します。  
+  
+ ワークフローが非永続化ゾーンにある間は、ワークフローが非永続化ゾーンを終了するまで、**Persist** メソッドと **Unload** メソッドのどちらもブロックします。メソッドは、非永続化ゾーンの完了後に、永続化またはアンロードの操作を続行します。期限切れになる前に非永続化ゾーンが完了しない場合、または永続化プロセスに時間がかかりすぎる場合は、TimeoutException がスローされます。  
+  
+## コードでのワークフロー サービスの永続化を有効にする  
+ <xref:System.ServiceModel.WorkflowServiceHost> クラスの **DurableInstancingOptions** メンバーには **InstanceStore** というプロパティがあり、インスタンス ストアを **WorkflowServiceHost** に関連付けるために使用できます。  
+  
+```  
+  
+// wsh is an instance of WorkflowServiceHost class  
+wsh.DurableInstancingOptions.InstanceStore = new SqlWorkflowInstanceStore();  
+  
+```  
+  
+ **WorkflowServiceHost** を開くと、**DurableInstancingOptions.InstanceStore** が null ではない場合、永続化が自動的に有効になります。  
+  
+ 通常、サービスの動作には、**InstanceStore** プロパティを使用してワークフロー サービス ホストと共に使用できる具象インスタンス ストアが用意されています。たとえば、SqlWorkflowInstanceStoreBehavior は、**SqlWorkflowInstanceStore** のインスタンスを作成し、構成して、**DurableInstancingOptions.InstanceStore** に割り当てます。  
+  
+## アプリケーション構成ファイルを使用してワークフロー サービスの永続化を有効にする  
+ 次のコードを app.config または web.config file に追加すると、アプリケーション構成ファイルを使用して永続化を有効にできます。  
+  
+```xml  
+<configuration>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior name=”myBehavior”>  
+          <SqlWorkflowInstanceStore connectionString=”Data Source=myDatatbaseServer;Initial Catalog=myPersistenceDatabase”>  
+        </behavior>  
+      </serviceBehaviors>  
+    <behaviors>  
+  </system.serviceModel>  
+</configuration>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-enable-sql-persistence-for-workflows-and-workflow-services.md b/docs/framework/windows-workflow-foundation/how-to-enable-sql-persistence-for-workflows-and-workflow-services.md
new file mode 100644
index 00000000000..843e9e81f5c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-enable-sql-persistence-for-workflows-and-workflow-services.md
@@ -0,0 +1,187 @@
+---
+title: "ワークフローとワークフロー サービスの SQL 永続性を有効にする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca7bf77f-3e5d-4b23-b17a-d0b60f46411d
+caps.latest.revision: 36
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 36
+---
+# ワークフローとワークフロー サービスの SQL 永続性を有効にする方法
+このトピックでは、ワークフローとワークフロー サービスの永続性をプログラムと構成ファイルの両方から使用して有効にできるように、SQL Workflow Instance Store の機能を構成する方法について説明します。  
+  
+ Windows Server App Fabric を使用すると、永続化の構成のプロセスを簡潔化できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][App Fabric 永続化の構成](http://go.microsoft.com/fwlink/?LinkId=201204)  
+  
+ SQL Workflow Instance Store 機能を使用する前に、この機能においてワークフロー インスタンスの永続化に使用するデータベースを作成します。[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] セットアップ プログラムによって、SQL Workflow Instance Store 機能に関連する SQL スクリプト ファイルが %WINDIR%\\Microsoft.NET\\Framework\\v4.xxx\\SQL\\EN フォルダーにコピーされます。これらのスクリプト ファイルは、SQL Workflow Instance Store がワークフロー インスタンスの永続化に使用する SQL Server 2005 または SQL Server 2008 のデータベースに対して実行します。最初に SqlWorkflowInstanceStoreSchema.sql ファイルを実行してから、SqlWorkflowInstanceStoreLogic.sql ファイルを実行します。  
+  
+> [!NOTE]
+>  永続性データベースをクリーンアップして新しいデータベースにするには、%WINDIR%\\Microsoft.NET\\Framework\\v4.xxx\\SQL\\EN にあるスクリプトを次の順序で実行します。  
+>   
+>  1.  SqlWorkflowInstanceStoreSchema.sql  
+> 2.  SqlWorkflowInstanceStoreLogic.sql  
+  
+> [!IMPORTANT]
+>  永続性データベースを作成しない場合、ホストがワークフローを永続化しようとしたときに、SQL Workflow Instance Store 機能によって次のような例外がスローされます。  
+>   
+>  System.Data.SqlClient.SqlException: ストアド プロシージャ 'System.Activities.DurableInstancing.CreateLockOwner' が見つかりませんでした。  
+  
+ 以下のセクションでは、SQL Workflow Instance Store を使用してワークフローとワークフロー サービスの永続性を有効にする方法について説明します。SQL Workflow Instance Store のプロパティ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[SQL Workflow Instance Store のプロパティ](../../../docs/framework/windows-workflow-foundation//properties-of-sql-workflow-instance-store.md)」を参照してください。  
+  
+## WorkflowApplication を使用する自己ホスト型ワークフローの永続化の有効化  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> オブジェクト モデルを使用して、プログラムから <xref:System.Activities.WorkflowApplication> を使用する自己ホスト型ワークフローの永続化を有効にすることができます。これを行う手順を次に示します。  
+  
+#### 自己ホスト型ワークフローの永続化を有効にするには  
+  
+1.  System.Activites.DurableInstancing.dll への参照を追加します。  
+  
+2.  ソース ファイルの先頭にある既存の "using" ステートメントの後に、次のステートメントを追加します。  
+  
+    ```csharp  
+    using System.Activities.DurableInstancing;  
+    ```  
+  
+3.  次のコード例に示すように、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を構築して <xref:System.Activities.WorkflowApplication> の <xref:System.Activities.WorkflowApplication.InstanceStore%2A> に割り当てます。  
+  
+    ```csharp  
+  
+    SqlWorkflowInstanceStore store =   
+        new SqlWorkflowInstanceStore("Server=.\\SQLEXPRESS;Initial Catalog=Persistence;Integrated Security=SSPI");  
+  
+    WorkflowApplication wfApp =  
+        new WorkflowApplication(new Workflow1());  
+  
+    wfApp.InstanceStore = store;  
+  
+    ```  
+  
+    > [!NOTE]
+    >  使用している SQL Server のエディションによって、接続文字列のサーバー名は異なる可能性があります。  
+  
+4.  <xref:System.Activities.WorkflowApplication> オブジェクトの <xref:System.Activities.WorkflowApplication.Persist%2A> メソッドを呼び出してワークフローを永続化するか、<xref:System.Activities.WorkflowApplication.Unload%2A> メソッドを呼び出してワークフローを永続化およびアンロードします。また、<xref:System.Activities.WorkflowApplication> オブジェクトによって発生した <xref:System.Activities.WorkflowApplication.PersistableIdle%2A> イベントを処理して、<xref:System.Activities.PersistableIdleAction> の適切なメンバー \(<xref:System.Activities.PersistableIdleAction> または <xref:System.Activities.PersistableIdleAction>\) を返すこともできます。  
+  
+    ```csharp  
+    wfApp.PersistableIdle = delegate(WorkflowApplicationIdleEventArgs e)  
+    {  
+        return PersistableIdleAction.Persist;  
+    };  
+    ```  
+  
+> [!NOTE]
+>  <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用したワークフローの永続化の有効化のサンプルについては、「[永続性](../../../docs/framework/windows-workflow-foundation/samples/persistence.md)」の「[ワークフロー アプリケーションの永続化](../../../docs/framework/windows-workflow-foundation/samples/persisting-a-workflow-application.md)」のサンプルを参照してください。手順の詳細については、「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の「[長時間にわたって実行されるワークフローを作成して実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md)」の手順を参照してください。  
+  
+## WorkflowServiceHost を使用する自己ホスト型ワークフロー サービスの永続化の有効化  
+ <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> クラスまたは <xref:System.ServiceModel.Activities.WorkflowServiceHost.DurableInstancingOptions%2A> クラスを使用して、プログラムから <xref:System.ServiceModel.WorkflowServiceHost> を使用する自己ホスト型ワークフロー サービスの永続化を有効にすることができます。  
+  
+### SqlWorkflowInstanceStoreBehavior クラスの使用  
+ <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> クラスを使用して、自己ホスト型ワークフロー サービスの永続化を有効にする手順を次に示します。  
+  
+##### SqlWorkflowInstanceStoreBehavior を使用して永続化を有効にするには  
+  
+1.  System.ServiceModel.dll への参照を追加します。  
+  
+2.  ソース ファイルの先頭にある既存の "using" ステートメントの後に、次のステートメントを追加します。  
+  
+    ```csharp  
+    using System.ServiceModel.Activities.Description;  
+    ```  
+  
+3.  `WorkflowServiceHost` のインスタンスを作成し、ワークフロー サービスのエンドポイントを追加します。  
+  
+    ```  
+  
+    WorkflowServiceHost host = new WorkflowServiceHost(new CountingWorkflow(), new Uri(hostBaseAddress));  
+    host.AddServiceEndpoint("ICountingWorkflow", new BasicHttpBinding(), "");  
+  
+    ```  
+  
+4.  `SqlWorkflowInstanceStoreBehavior` オブジェクトを作成して、動作オブジェクトのプロパティを設定します。  
+  
+    ```csharp  
+  
+    SqlWorkflowInstanceStoreBehavior instanceStoreBehavior = new SqlWorkflowInstanceStoreBehavior(connectionString);  
+    instanceStoreBehavior.HostLockRenewalPeriod = new TimeSpan(0, 0, 5);  
+    instanceStoreBehavior.InstanceCompletionAction = InstanceCompletionAction.DeleteAll;  
+    instanceStoreBehavior.InstanceLockedExceptionAction = InstanceLockedExceptionAction.AggressiveRetry;  
+    instanceStoreBehavior.InstanceEncodingOption = InstanceEncodingOption.GZip;  
+    instanceStoreBehavior.RunnableInstancesDetectionPeriod = new TimeSpan("00:00:02");  
+    host.Description.Behaviors.Add(instanceStoreBehavior);  
+  
+    ```  
+  
+5.  ワークフロー サービス ホストを開きます。  
+  
+    ```vb  
+  
+    host.Open();  
+  
+    ```  
+  
+> [!IMPORTANT]
+>  `SqlWorkflowInstanceStoreBehavior` クラスを使用したワークフロー サービスの永続化の有効化のサンプルについては、「[永続性](../../../docs/framework/windows-workflow-foundation/samples/persistence.md)」の「[組み込みの構成](../../../docs/framework/windows-workflow-foundation/samples/built-in-configuration.md)」のサンプルを参照してください。  
+  
+### DurableInstancingOptions プロパティの使用  
+ `SqlWorkflowInstanceStoreBehavior` が適用される場合、`WorkflowServiceHost` の `DurableInstancingOptions.InstanceStore` は構成値を使用して作成された `SqlWorkflowInstanceStore` オブジェクトに設定されます。同じ内容をプログラムから実行するには、次のコード例に示すように、`SqlWorkflowInstanceStoreBehavior` クラスを使用せずに `WorkflowServiceHost` の <xref:System.ServiceModel.Activities.WorkflowServiceHost.DurableInstancingOptions%2A> プロパティを設定します。  
+  
+```  
+workflowServiceHost.DurableInstancingOptions.InstanceStore = sqlInstanceStoreObject;  
+```  
+  
+## WorkflowServiceHost を使用する WAS でホストされるワークフロー サービスの構成ファイルを使用した永続化の有効化  
+ 構成ファイルを使用することで、自己ホスト型または Windows プロセス アクティブ化サービス \(WAS\) でホストされるワークフロー サービスの永続化を有効にできます。WAS でホストされるワークフロー サービスは、自己ホスト型ワークフローのように WorkflowServiceHost を使用します。  
+  
+ `SqlWorkflowInstanceStoreBehavior` は、XML 構成によって [SQL Workflow Instance Store](../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md) のプロパティを簡単に変更できるサービスの動作です。WAS でホストされるワークフロー サービスの場合は、Web.config ファイルを使用します。次の構成例では、構成ファイルで `sqlWorkflowInstanceStore` という動作要素を使用して SQL Workflow Instance Store を構成する方法について説明します。  
+  
+```  
+  
+<serviceBehaviors>  
+    <behavior name="">  
+        <sqlWorkflowInstanceStore   
+                    connectionString="Data Source=(local);Initial Catalog=DefaultPersistenceProviderDb;Integrated Security=True;Async=true"  
+                    instanceEncodingOption="GZip | None"  
+                    instanceCompletionAction="DeleteAll | DeleteNothing"  
+                    instanceLockedExceptionAction="NoRetry | BasicRetry |AggressiveRetry"  
+                    hostLockRenewalPeriod="00:00:30"   
+                    runnableInstancesDetectionPeriod="00:00:05">  
+  
+        <sqlWorkflowInstanceStore/>  
+    </behavior>  
+</serviceBehaviors>  
+  
+```  
+  
+ `connectionString` または `connectionStringName` プロパティの値が設定されていない場合、SQL Workflow Instance Store は既定の名前付き接続文字列 `DefaultSqlWorkflowInstanceStoreConnectionString` を使用します。  
+  
+ `SqlWorkflowInstanceStoreBehavior` が適用される場合、`WorkflowServiceHost` の `DurableInstancingOptions.InstanceStore` は構成値を使用して作成された `SqlWorkflowInstanceStore` オブジェクトに設定されます。同じ内容をプログラムから実行するには、サービスの動作要素を使用せずに `SqlWorkflowInstanceStore` を `WorkflowServiceHost` と一緒に使用します。  
+  
+```  
+workflowServiceHost.DurableInstancingOptions.InstanceStore = sqlInstanceStoreObject;  
+```  
+  
+> [!IMPORTANT]
+>  ユーザー名やパスワードなどの機密情報は、Web.config ファイルに保存しないことをお勧めします。Web.config ファイルに機密情報を保存する場合は、ファイル システムのアクセス制御リスト \(ACL\) を使用して、Web.config ファイルへのアクセスをセキュリティで保護する必要があります。また、「[保護された構成を使用した構成情報の暗号化](http://go.microsoft.com/fwlink/?LinkId=178419)」で説明しているように、構成ファイル内の構成値をセキュリティで保護することもできます。  
+  
+### SQL Workflow Instance Store 機能に関連する Machine.config の要素  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] のインストールでは、SQL Workflow Instance Store 機能に関連する次の要素が Machine.config ファイルに追加されます。  
+  
+-   構成ファイルで \<`sqlWorkflowInstanceStore`\> サービスの動作要素を使用してサービスの永続化を設定できるように、Machine.config ファイルに次の動作拡張要素を追加します。  
+  
+    ```  
+  
+    <configuration>  
+        <system.serviceModel>  
+            <extensions>  
+                <behaviorExtensions>  
+                    <add name="sqlWorkflowInstanceStore" type="System.Activities.DurableInstancing.SqlWorkflowInstanceStoreElement, System.Activities.DurableInstancing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" />  
+                </behaviorExtensions>  
+            </extensions>  
+        <system.serviceModel>  
+    <configuration>  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-host-multiple-versions-of-a-workflow-side-by-side.md b/docs/framework/windows-workflow-foundation/how-to-host-multiple-versions-of-a-workflow-side-by-side.md
new file mode 100644
index 00000000000..0042b26b434
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-host-multiple-versions-of-a-workflow-side-by-side.md
@@ -0,0 +1,586 @@
+---
+title: "ワークフローの複数のバージョンを同時にホストする方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 09c575df-e0a3-4f3b-9e01-a7ac59d65287
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ワークフローの複数のバージョンを同時にホストする方法
+`WorkflowIdentity` を使用すると、ワークフロー アプリケーションの開発者は、名前とバージョンをワークフロー定義に関連付け、永続化されたワークフロー インスタンスにこの情報を関連付けることができます。この ID 情報は、ワークフロー アプリケーションの開発者がワークフロー定義の複数のバージョンの side\-by\-side 実行などのシナリオを有効にするために使用できます。また、動的更新などの他の機能の基礎となります。チュートリアルのこの手順では、`WorkflowIdentity` を使用してワークフローの複数のバージョンを同時にホストする方法について説明します。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードしたり、チュートリアルのビデオを閲覧したりするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+## このトピックの内容  
+ チュートリアルのこの手順では、追加情報を提供するようにワークフローの `WriteLine` アクティビティが変更され、新しい `WriteLine` アクティビティが追加されます。元のワークフロー アセンブリのコピーが格納され、ホスト アプリケーションは、元のワークフローと更新されたワークフローの両方を同時に実行できるように更新されます。  
+  
+-   [NumberGuessWorkflowActivities プロジェクトのコピーを作成するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_BackupCopy)  
+  
+-   [ワークフローを更新するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_UpdateWorkflows)  
+  
+    -   [StateMachine ワークフローを更新するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_UpdateStateMachine)  
+  
+    -   [フローチャート ワークフローを更新するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_UpdateFlowchart)  
+  
+    -   [シーケンシャル ワークフローを更新するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_UpdateSequential)  
+  
+-   [以前のワークフロー バージョンを含むように WorkflowVersionMap を更新するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_UpdateWorkflowVersionMap)  
+  
+-   [アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md#BKMK_BuildAndRun)  
+  
+> [!NOTE]
+>  このトピックの手順を実行する前に、アプリケーションを実行し、各種類のワークフローをいくつか開始して、ワークフローごとに 1 つまたは 2 つの推定値を作成します。これらの永続化されたワークフローは、この手順および次の手順「[実行中のワークフロー インスタンスの定義を更新する方法](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md)」で使用されます。  
+  
+> [!NOTE]
+>  チュートリアル入門の各手順は、その前の手順に応じて異なります。前の手順を完了していない場合は、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」からチュートリアルの完成版をダウンロードできます。  
+  
+###  <a name="BKMK_BackupCopy"></a> NumberGuessWorkflowActivities プロジェクトのコピーを作成するには  
+  
+1.  **WF45GettingStartedTutorial** ソリューションを開いていない場合は、[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  **WF45GettingStartedTutorial** ソリューションを閉じます。  
+  
+4.  エクスプローラーを開き、チュートリアルのソリューション ファイルおよびプロジェクト フォルダーが格納されているフォルダーに移動します。  
+  
+5.  **PreviousVersions** という名前の新しいフォルダーを、**NumberGuessWorkflowHost** および **NumberGuessWorkflowActivities** と同じフォルダーに作成します。このフォルダーは、チュートリアルの以降の手順で使用されるワークフローの異なるバージョンを含むアセンブリを格納するために使用されます。  
+  
+6.  **NumberGuessWorkflowActivities\\bin\\debug** フォルダー \(プロジェクトの設定によっては **bin\\release**\) に移動します。**NumberGuessWorkflowActivities.dll** をコピーし、**PreviousVersions** フォルダーに貼り付けます。  
+  
+7.  **PreviousVersions** フォルダー内の **NumberGuessWorkflowActivities.dll** の名前を **NumberGuessWorkflowActivities\_v1.dll** に変更します。  
+  
+    > [!NOTE]
+    >  このトピックの手順では、ワークフローの複数のバージョンを格納するためのアセンブリを管理する 1 つの方法を示します。アセンブリに厳密な名前を付けてグローバル アセンブリ キャッシュに登録するなど、他の方法も使用できます。  
+  
+8.  **NumberGuessWorkflowHost**、**NumberGuessWorkflowActivities**、および新しく追加した **PreviousVersions** フォルダーと同じフォルダー内に **NumberGuessWorkflowActivities\_du** という名前の新しいフォルダーを作成し、**NumberGuessWorkflowActivities** フォルダーのすべてのファイルとサブフォルダーを新しい **NumberGuessWorkflowActivities\_du** フォルダーにコピーします。アクティビティの最初のバージョンのプロジェクトのこのバックアップ コピーは、「[実行中のワークフロー インスタンスの定義を更新する方法](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md)」で使用されます。  
+  
+9. [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] で **WF45GettingStartedTutorial** ソリューションを再度開きます。  
+  
+###  <a name="BKMK_UpdateWorkflows"></a> ワークフローを更新するには  
+ ここでは、ワークフロー定義が更新されます。ユーザーの推定値についてフィードバックを返す 2 つの `WriteLine` アクティビティが更新され、新しい `WriteLine` アクティビティが追加されます。新しいアクティビティは、数値が推定されるとゲームに関する追加情報を提供します。  
+  
+####  <a name="BKMK_UpdateStateMachine"></a> StateMachine ワークフローを更新するには  
+  
+1.  **ソリューション エクスプローラー**で、**NumberGuessWorkflowActivities** プロジェクトの下の **StateMachineNumberGuessWorkflow.xaml** をダブルクリックします。  
+  
+2.  ステート マシンの **Guess Incorrect** 遷移をダブルクリックします。  
+  
+3.  `If` アクティビティで、左端の `WriteLine` の `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too low."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too low."  
+    ```  
+  
+4.  `If` アクティビティで、右端の `WriteLine` の `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too high."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too high."  
+    ```  
+  
+5.  ワークフロー デザイナーの上部にある階層リンク表示の **\[StateMachine\]** をクリックして、ワークフロー デザイナーの全体的なステート マシン ビューに戻ります。  
+  
+6.  ステート マシンの **Guess Incorrect** 遷移をダブルクリックします。  
+  
+7.  **ツールボックス**の **\[プリミティブ\]** セクションから **WriteLine** アクティビティをドラッグし、遷移の **\[ここに Action アクティビティをドロップします\]** ラベル上にドロップします。  
+  
+8.  `Text` プロパティ ボックスに、次の式を入力します。  
+  
+    ```vb  
+    Guess & " is correct. You guessed it in " & Turns & " turns."  
+    ```  
+  
+    ```csharp  
+    Guess + " is correct. You guessed it in " + Turns + " turns."  
+    ```  
+  
+####  <a name="BKMK_UpdateFlowchart"></a> フローチャート ワークフローを更新するには  
+  
+1.  **ソリューション エクスプローラー**で、**NumberGuessWorkflowActivities** プロジェクトの下の **FlowchartNumberGuessWorkflow.xaml** をダブルクリックします。  
+  
+2.  左端の `WriteLine` アクティビティの `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too low."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too low."  
+    ```  
+  
+3.  右端の `WriteLine` アクティビティの `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too high."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too high."  
+    ```  
+  
+4.  **ツールボックス**の **\[プリミティブ\]** セクションから **WriteLine** アクティビティをドラッグし、最上位の `FlowDecision` の `True` アクションのドロップ ポイント上にドロップします。`WriteLine` アクティビティがフローチャートに追加され、`FlowDecision` の `True` アクションにリンクされます。  
+  
+5.  `Text` プロパティ ボックスに、次の式を入力します。  
+  
+    ```vb  
+    Guess & " is correct. You guessed it in " & Turns & " turns."  
+    ```  
+  
+    ```csharp  
+    Guess + " is correct. You guessed it in " + Turns + " turns."  
+    ```  
+  
+####  <a name="BKMK_UpdateSequential"></a> シーケンシャル ワークフローを更新するには  
+  
+1.  **ソリューション エクスプローラー**で、**NumberGuessWorkflowActivities** プロジェクトの下の **SequentialNumberGuessWorkflow.xaml** をダブルクリックします。  
+  
+2.  `If` アクティビティで、左端の `WriteLine` の `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too low."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too low."  
+    ```  
+  
+3.  `If` アクティビティで、右端の `WriteLine` アクティビティの `Text` を更新します。  
+  
+    ```vb  
+    Guess & " is too high."  
+    ```  
+  
+    ```csharp  
+    Guess + " is too high."  
+    ```  
+  
+4.  **WriteLine** がルートの `Sequence` アクティビティの最後のアクティビティになるように、**ツールボックス**の **\[プリミティブ\]** セクションから **WriteLine** アクティビティをドラッグし、**DoWhile** アクションの後ろにドロップします。  
+  
+5.  `Text` プロパティ ボックスに、次の式を入力します。  
+  
+    ```vb  
+    Guess & " is correct. You guessed it in " & Turns & " turns."  
+    ```  
+  
+    ```csharp  
+    Guess + " is correct. You guessed it in " + Turns + " turns."  
+    ```  
+  
+###  <a name="BKMK_UpdateWorkflowVersionMap"></a> 以前のワークフロー バージョンを含むように WorkflowVersionMap を更新するには  
+  
+1.  **NumberGuessWorkflowHost** プロジェクトの下の **WorkflowVersionMap.cs** \(または **WorkflowVersionMap.vb**\) をダブルクリックして開きます。  
+  
+2.  次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Reflection  
+    Imports System.IO  
+    ```  
+  
+    ```csharp  
+    using System.Reflection;  
+    using System.IO;  
+    ```  
+  
+3.  既存の 3 つのワークフロー ID 宣言の直後に、新しいワークフロー ID を 3 つ追加します。これらの新しい `v1` ワークフロー ID は、更新が行われる前に開始されたワークフローに対して正しいワークフロー定義を指定するために使用されます。  
+  
+    ```vb  
+    'Current version identities.  
+    Public StateMachineNumberGuessIdentity As WorkflowIdentity  
+    Public FlowchartNumberGuessIdentity As WorkflowIdentity  
+    Public SequentialNumberGuessIdentity As WorkflowIdentity  
+  
+    'v1 Identities.  
+    Public StateMachineNumberGuessIdentity_v1 As WorkflowIdentity  
+    Public FlowchartNumberGuessIdentity_v1 As WorkflowIdentity  
+    Public SequentialNumberGuessIdentity_v1 As WorkflowIdentity  
+    ```  
+  
+    ```csharp  
+    // Current version identities.  
+    static public WorkflowIdentity StateMachineNumberGuessIdentity;  
+    static public WorkflowIdentity FlowchartNumberGuessIdentity;  
+    static public WorkflowIdentity SequentialNumberGuessIdentity;  
+  
+    // v1 identities.  
+    static public WorkflowIdentity StateMachineNumberGuessIdentity_v1;  
+    static public WorkflowIdentity FlowchartNumberGuessIdentity_v1;  
+    static public WorkflowIdentity SequentialNumberGuessIdentity_v1;  
+    ```  
+  
+4.  `WorkflowVersionMap` コンストラクターで、3 つの現在のワークフロー ID の `Version` プロパティを `2.0.0.0` に更新します。  
+  
+    ```vb  
+    'Add the current workflow version identities.  
+    StateMachineNumberGuessIdentity = New WorkflowIdentity With  
+    {  
+        .Name = "StateMachineNumberGuessWorkflow",  
+        .Version = New Version(2, 0, 0, 0)  
+    }  
+  
+    FlowchartNumberGuessIdentity = New WorkflowIdentity With  
+    {  
+        .Name = "FlowchartNumberGuessWorkflow",  
+        .Version = New Version(2, 0, 0, 0)  
+    }  
+  
+    SequentialNumberGuessIdentity = New WorkflowIdentity With  
+    {  
+        .Name = "SequentialNumberGuessWorkflow",  
+        .Version = New Version(2, 0, 0, 0)  
+    }  
+  
+    map.Add(StateMachineNumberGuessIdentity, New StateMachineNumberGuessWorkflow())  
+    map.Add(FlowchartNumberGuessIdentity, New FlowchartNumberGuessWorkflow())  
+    map.Add(SequentialNumberGuessIdentity, New SequentialNumberGuessWorkflow())  
+    ```  
+  
+    ```csharp  
+    // Add the current workflow version identities.  
+    StateMachineNumberGuessIdentity = new WorkflowIdentity  
+    {  
+        Name = "StateMachineNumberGuessWorkflow",  
+        // Version = new Version(1, 0, 0, 0),  
+        Version = new Version(2, 0, 0, 0)  
+    };  
+  
+    FlowchartNumberGuessIdentity = new WorkflowIdentity  
+    {  
+        Name = "FlowchartNumberGuessWorkflow",  
+        // Version = new Version(1, 0, 0, 0),  
+        Version = new Version(2, 0, 0, 0)  
+    };  
+  
+    SequentialNumberGuessIdentity = new WorkflowIdentity  
+    {  
+        Name = "SequentialNumberGuessWorkflow",  
+        // Version = new Version(1, 0, 0, 0),  
+        Version = new Version(2, 0, 0, 0)  
+    };  
+  
+    map.Add(StateMachineNumberGuessIdentity, new StateMachineNumberGuessWorkflow());  
+    map.Add(FlowchartNumberGuessIdentity, new FlowchartNumberGuessWorkflow());  
+    map.Add(SequentialNumberGuessIdentity, new SequentialNumberGuessWorkflow());  
+    ```  
+  
+     ワークフローの現在のバージョンをディクショナリに追加するコードでは、プロジェクトで参照されている現在のバージョンを使用しているため、ワークフロー定義を初期化するコードを更新する必要はありません。  
+  
+5.  コンストラクターで、現在のバージョンをディクショナリに追加するコードの直後に、次のコードを追加します。  
+  
+    ```vb  
+    'Initialize the previous workflow version identities.  
+    StateMachineNumberGuessIdentity_v1 = New WorkflowIdentity With  
+    {  
+        .Name = "StateMachineNumberGuessWorkflow",  
+        .Version = New Version(1, 0, 0, 0)  
+    }  
+  
+    FlowchartNumberGuessIdentity_v1 = New WorkflowIdentity With  
+    {  
+        .Name = "FlowchartNumberGuessWorkflow",  
+        .Version = New Version(1, 0, 0, 0)  
+    }  
+  
+    SequentialNumberGuessIdentity_v1 = New WorkflowIdentity With  
+    {  
+        .Name = "SequentialNumberGuessWorkflow",  
+        .Version = New Version(1, 0, 0, 0)  
+    }  
+    ```  
+  
+    ```csharp  
+    // Initialize the previous workflow version identities.  
+    StateMachineNumberGuessIdentity_v1 = new WorkflowIdentity  
+    {  
+        Name = "StateMachineNumberGuessWorkflow",  
+        Version = new Version(1, 0, 0, 0)  
+    };  
+  
+    FlowchartNumberGuessIdentity_v1 = new WorkflowIdentity  
+    {  
+        Name = "FlowchartNumberGuessWorkflow",  
+        Version = new Version(1, 0, 0, 0)  
+    };  
+  
+    SequentialNumberGuessIdentity_v1 = new WorkflowIdentity  
+    {  
+        Name = "SequentialNumberGuessWorkflow",  
+        Version = new Version(1, 0, 0, 0)  
+    };  
+    ```  
+  
+     これらのワークフロー ID は、対応するワークフロー定義の最初のバージョンに関連付けられます。  
+  
+6.  次に、ワークフロー定義の最初のバージョンを含むアセンブリを読み込み、対応するワークフロー定義を作成してそのディクショナリに追加します。  
+  
+    ```vb  
+    'Add the previous version workflow identities to the dictionary along with  
+    'the corresponding workflow definitions loaded from the v1 assembly.  
+    'Assembly.LoadFile requires an absolute path so convert this relative path  
+    'to an absolute path.  
+    Dim v1AssemblyPath As String = "..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll"  
+    v1AssemblyPath = Path.GetFullPath(v1AssemblyPath)  
+    Dim v1Assembly As Assembly = Assembly.LoadFile(v1AssemblyPath)  
+  
+    map.Add(StateMachineNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow"))  
+  
+    map.Add(SequentialNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow"))  
+  
+    map.Add(FlowchartNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow"))  
+    ```  
+  
+    ```csharp  
+    // Add the previous version workflow identities to the dictionary along with  
+    // the corresponding workflow definitions loaded from the v1 assembly.  
+    // Assembly.LoadFile requires an absolute path so convert this relative path  
+    // to an absolute path.  
+    string v1AssemblyPath = @"..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll";  
+    v1AssemblyPath = Path.GetFullPath(v1AssemblyPath);  
+    Assembly v1Assembly = Assembly.LoadFile(v1AssemblyPath);  
+  
+    map.Add(StateMachineNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow") as Activity);  
+  
+    map.Add(SequentialNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow") as Activity);  
+  
+    map.Add(FlowchartNumberGuessIdentity_v1,  
+        v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow") as Activity);  
+  
+    ```  
+  
+     次の例では、更新された `WorkflowVersionMap` クラス全体を示します。  
+  
+    ```vb  
+    Public Module WorkflowVersionMap  
+        Dim map As Dictionary(Of WorkflowIdentity, Activity)  
+  
+        'Current version identities.  
+        Public StateMachineNumberGuessIdentity As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity As WorkflowIdentity  
+  
+        'v1 Identities.  
+        Public StateMachineNumberGuessIdentity_v1 As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity_v1 As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity_v1 As WorkflowIdentity  
+  
+        Sub New()  
+            map = New Dictionary(Of WorkflowIdentity, Activity)  
+  
+            'Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            map.Add(StateMachineNumberGuessIdentity, New StateMachineNumberGuessWorkflow())  
+            map.Add(FlowchartNumberGuessIdentity, New FlowchartNumberGuessWorkflow())  
+            map.Add(SequentialNumberGuessIdentity, New SequentialNumberGuessWorkflow())  
+  
+            'Initialize the previous workflow version identities.  
+            StateMachineNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            'Add the previous version workflow identities to the dictionary along with  
+            'the corresponding workflow definitions loaded from the v1 assembly.  
+            'Assembly.LoadFile requires an absolute path so convert this relative path  
+            'to an absolute path.  
+            Dim v1AssemblyPath As String = "..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll"  
+            v1AssemblyPath = Path.GetFullPath(v1AssemblyPath)  
+            Dim v1Assembly As Assembly = Assembly.LoadFile(v1AssemblyPath)  
+  
+            map.Add(StateMachineNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow"))  
+  
+            map.Add(SequentialNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow"))  
+  
+            map.Add(FlowchartNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow"))  
+        End Sub  
+  
+        Public Function GetWorkflowDefinition(identity As WorkflowIdentity) As Activity  
+            Return map(identity)  
+        End Function  
+  
+        Public Function GetIdentityDescription(identity As WorkflowIdentity) As String  
+            Return identity.ToString()  
+        End Function  
+    End Module  
+    ```  
+  
+    ```csharp  
+    public static class WorkflowVersionMap  
+    {  
+        static Dictionary<WorkflowIdentity, Activity> map;  
+  
+        // Current version identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity;  
+  
+        // v1 identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity_v1;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity_v1;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity_v1;  
+  
+        static WorkflowVersionMap()  
+        {  
+            map = new Dictionary<WorkflowIdentity, Activity>();  
+  
+            // Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            map.Add(StateMachineNumberGuessIdentity, new StateMachineNumberGuessWorkflow());  
+            map.Add(FlowchartNumberGuessIdentity, new FlowchartNumberGuessWorkflow());  
+            map.Add(SequentialNumberGuessIdentity, new SequentialNumberGuessWorkflow());  
+  
+            // Initialize the previous workflow version identities.  
+            StateMachineNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            // Add the previous version workflow identities to the dictionary along with  
+            // the corresponding workflow definitions loaded from the v1 assembly.  
+            // Assembly.LoadFile requires an absolute path so convert this relative path  
+            // to an absolute path.  
+            string v1AssemblyPath = @"..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll";  
+            v1AssemblyPath = Path.GetFullPath(v1AssemblyPath);  
+            Assembly v1Assembly = Assembly.LoadFile(v1AssemblyPath);  
+  
+            map.Add(StateMachineNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow") as Activity);  
+  
+            map.Add(SequentialNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow") as Activity);  
+  
+            map.Add(FlowchartNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow") as Activity);  
+        }  
+  
+        public static Activity GetWorkflowDefinition(WorkflowIdentity identity)  
+        {  
+            return map[identity];  
+        }  
+  
+        public static string GetIdentityDescription(WorkflowIdentity identity)  
+        {  
+            return identity.ToString();  
+        }  
+    }  
+  
+    ```  
+  
+###  <a name="BKMK_BuildAndRun"></a> アプリケーションをビルドして実行するには  
+  
+1.  Ctrl キーと Shift キーを押しながら B キーを押してアプリケーションをビルドし、Ctrl キーを押しながら F5 キーを押して起動します。  
+  
+2.  **\[New Game\]** をクリックして、新しいワークフローを開始します。ワークフローのバージョンは、ステータス ウィンドウの下に表示され、関連付けられた `WorkflowIdentity` から更新後のバージョンを反映します。完了時にワークフローの追跡ファイルを確認できるように `InstanceId` を書き留めておき、ゲームが完了するまで推定値を入力します。`WriteLine` アクティビティに対する更新に基づき、ステータス ウィンドウに示される情報に、ユーザーの推定値がどのように表示されるかを確認します。  
+  
+ **Please enter a number between 1 and 10**   
+**5 is too high.**   
+**Please enter a number between 1 and 10**   
+**3 is too high.**   
+**Please enter a number between 1 and 10**   
+**1 is too low.**   
+**Please enter a number between 1 and 10**   
+**Congratulations, you guessed the number in 4 turns.**    
+    > [!NOTE]
+    >  `WriteLine` アクティビティから更新されたテキストは表示されますが、このトピックで追加された最後の `WriteLine` アクティビティの出力は表示されません。これは、ステータス ウィンドウが `PersistableIdle` ハンドラーによって更新されるためです。ワークフローは完了し、最後のアクティビティの後にアイドル状態にならないため、`PersistableIdle` ハンドラーは呼び出されません。ただし、`Completed` ハンドラーによって同様のメッセージがステータス ウィンドウに表示されます。必要に応じて、コードを `Completed` ハンドラーに追加し、`StringWriter` からテキストを抽出してステータス ウィンドウに表示できます。  
+  
+3.  エクスプローラーを開き、**NumberGuessWorkflowHost\\bin\\debug** フォルダー \(プロジェクトの設定によっては **bin\\release**\) に移動して、完了したワークフローに対応する追跡ファイルをメモ帳を使用して開きます。`InstanceId` を書き留めなかった場合は、エクスプローラーの **\[更新日時\]** の情報を使用して正しい追跡ファイルを特定できます。  
+  
+ **Please enter a number between 1 and 10**   
+**5 is too high.**   
+**Please enter a number between 1 and 10**   
+**3 is too high.**   
+**Please enter a number between 1 and 10**   
+**1 is too low.**   
+**Please enter a number between 1 and 10**   
+**2 is correct.You guessed it in 4 turns.**      更新された `WriteLine` の出力は、このトピックで追加した `WriteLine` の出力を含む追跡ファイル内に含まれています。  
+  
+4.  数値推測アプリケーションに戻り、更新が行われる前に開始したワークフローのうち 1 つを選択します。現在選択されているワークフローのバージョンを特定するには、ステータス ウィンドウの下に表示されるバージョン情報を確認します。いくつかの推定値を入力し、ステータスの更新が前のバージョンからの `WriteLine` アクティビティの出力と一致しており、ユーザーの推定値が含まれていないことを確認してください。これらのワークフローでは、`WriteLine` の更新を含まない以前のワークフロー定義を使用しているためです。  
+  
+     次の手順「[実行中のワークフロー インスタンスの定義を更新する方法](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md)」では、実行中の `v1` ワークフロー インスタンスを更新して、`v2` インスタンスとして新機能が含まれるようにします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-query-for-non-persisted-instances.md b/docs/framework/windows-workflow-foundation/how-to-query-for-non-persisted-instances.md
new file mode 100644
index 00000000000..61e8fc251ea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-query-for-non-persisted-instances.md
@@ -0,0 +1,69 @@
+---
+title: "方法: 非永続的インスタンスを検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 294019b1-c1a7-4b81-a14f-b47c106cd723
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 方法: 非永続的インスタンスを検索する
+サービスに SQL Workflow Instance Store の動作が定義されている場合、サービスの新しいインスタンスが作成されると、サービス ホストにより、そのサービス インスタンスの初期エントリがインスタンス ストアに作成されます。その後、そのサービス インスタンスが初めて永続化されると、SQL Workflow Instance Store の動作により、現在のインスタンスの状態が、アクティベーション、回復、および制御に必要な追加データと共に格納されます。  
+  
+ インスタンスの初期エントリが作成された後にインスタンスが永続化されていない場合、そのサービス インスタンスの状態を非永続的状態と呼びます。永続的サービス インスタンスはすべてクエリおよび制御できますが、非永続的サービス インスタンスはクエリも制御もできません。非永続的インスタンスが未処理の例外によって中断された場合は、クエリはできますが制御はできません。  
+  
+ 次のような場合、まだ永続化されていない永続性サービス インスタンスが非永続的状態のままになります。  
+  
+-   インスタンスが初めて永続化される前にサービス ホストがクラッシュした場合。インスタンスの初期エントリがインスタンス ストアに残ります。インスタンスを回復することはできません。関連付けられるメッセージが受信されると、インスタンスが再びアクティブになります。  
+  
+-   インスタンスが初めて永続化される前にインスタンスで未処理の例外が発生した場合。次の状況が発生します。  
+  
+    -   **UnhandledExceptionAction** プロパティの値が **Abandon** に設定されている場合は、サービス展開情報がインスタンス ストアに書き込まれて、インスタンスがメモリからアンロードされます。インスタンスは、非永続的状態のまま永続性データベースに残ります。  
+  
+    -   **UnhandledExceptionAction** プロパティの値が **AbandonAndSuspsend** に設定されている場合は、サービス展開情報が永続性データベースに書き込まれて、インスタンスの状態が **Suspended** に設定されます。インスタンスを再開、取り消し、または終了することはできません。インスタンスはまだ永続化されておらず、インスタンスのデータベース エントリが完成していないため、サービス ホストはインスタンスを読み込むことができません。  
+  
+    -   **UnhandledExceptionAction** プロパティの値が **Cancel** または **Terminate** に設定されている場合は、サービス展開情報がインスタンス ストアに書き込まれて、インスタンスの状態が **Completed** に設定されます。  
+  
+ 以降では、SQL 永続性データベースで非永続的インスタンスを検索するためのサンプル クエリと、それらのインスタンスをデータベースから削除するためのサンプル クエリを紹介します。  
+  
+## まだ永続化されていないインスタンスをすべて検索するには  
+ 次の SQL クエリは、まだ永続性データベースに永続化されていないすべてのインスタンスの ID と作成時刻を返します。  
+  
+```  
+  
+select InstanceId, CreationTime from [System.Activities.DurableInstancing].[Instances] where IsInitialized = 0;  
+  
+```  
+  
+## まだ永続化されておらず、読み込まれてもいないインスタンスをすべて検索するには  
+ 次の SQL クエリは、まだ永続化されておらず、読み込まれてもいないすべてのインスタンスの ID と作成時刻を返します。  
+  
+```  
+  
+select InstanceId, CreationTime from [System.Activities.DurableInstancing].[Instances] where IsInitialized = 0 and CurrentMachine is NULL;  
+  
+```  
+  
+## まだ永続化されていない中断されたインスタンスをすべて検索するには  
+ 次の SQL クエリは、まだ永続化されていない中断状態のすべてのインスタンスの ID、作成時刻、中断の理由、および中断例外の名前を返します。  
+  
+```  
+  
+select InstanceId, CreationTime, SuspensionReason, SuspensionExceptionName from [System.Activities.DurableInstancing].[Instances] where IsInitialized = 0 and IsSuspended = 1;  
+  
+```  
+  
+## 非永続的インスタンスを永続性データベースから削除するには  
+ 非永続的インスタンスがないかどうかをインスタンス ストアで定期的に確認して、関連付けられるメッセージをもう受信しないことがわかっている場合は、インスタンス ストアから削除する必要があります。たとえば、数か月にわたってデータベースに残っているインスタンスがある場合、そのワークフローの通常の有効期間が数日程度なら、クラッシュした未初期化のインスタンスと見なしても問題ありません。  
+  
+ 一般に、非永続的インスタンスは、中断されていない場合や読み込まれていない場合は安全に削除できます。作成されたばかりでまだ永続化されていないインスタンスもあるため、非永続的インスタンスをすべて削除するのはやめてください。削除する必要があるのは、インスタンスを読み込んだワークフロー サービス ホストで例外が発生したり、インスタンス自体で例外が発生したりしたために永続化されずに残っているインスタンスだけです。  
+  
+> [!WARNING]
+>  非永続的インスタンスをインスタンス ストアから削除すると、ストアのサイズが小さくなって、ストア操作のパフォーマンスが向上する可能性があります。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-run-a-workflow.md b/docs/framework/windows-workflow-foundation/how-to-run-a-workflow.md
new file mode 100644
index 00000000000..3277a2d9123
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-run-a-workflow.md
@@ -0,0 +1,172 @@
+---
+title: "ワークフローを実行する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f814ff82-fe2b-4614-aebb-b768c3e61179
+caps.latest.revision: 33
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 33
+---
+# ワークフローを実行する方法
+このトピックでは、Windows Workflow Foundation チュートリアル入門の続きと、ワークフロー ホストを作成して、前の「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」で定義したワークフローを実行する方法について説明します。  
+  
+> [!NOTE]
+>  チュートリアル入門の各トピックは、前のトピックに応じて異なります。 このトピックを完了する前に、「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」および「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」を完了する必要があります。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードするには、「[Windows Workflow Foundation \(WF45\) \- Getting Started Tutorial \(Windows Workflow Foundation \(WF45\) \- チュートリアル入門\)](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+### ワークフロー ホスト プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を使用して、前の「[アクティビティを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-an-activity.md)」トピックからソリューションを開きます。  
+  
+2.  **ソリューション エクスプローラー**で **WF45GettingStartedTutorial** ソリューションを右クリックし、**\[追加\]** をポイントして、**\[新しいプロジェクト\]** をクリックします。  
+  
+    > [!TIP]
+    >  **ソリューション エクスプローラー** ウィンドウが表示されない場合は、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+3.  **\[インストール済み\]** ノードで、**\[Visual C\#\]**、**\[ワークフロー\]** \(または **\[Visual Basic\]**、**\[ワークフロー\]**\) の順に選択します。  
+  
+    > [!NOTE]
+    >  Visual Studio で第一言語として設定されているプログラミング言語に応じて、**\[インストール済み\]** ノードの **\[他の言語\]** ノードの下に、**\[Visual C\#\]** ノードまたは **\[Visual Basic\]** ノードが表示されます。  
+  
+     .NET Framework バージョンのドロップダウン リストで **\[.NET Framework 4.5\]** が選択されていることを確認します。**\[ワークフロー\]** の一覧から **\[ワークフロー コンソール アプリケーション\]** を選択します。**\[名前\]** ボックスに「`NumberGuessWorkflowHost`」と入力し、**\[OK\]** をクリックします。 これで、基本的なワークフロー ホスティングをサポートする、基本ワークフロー アプリケーションが作成されます。 この基本的なホスティング コードを変更し、ワークフロー アプリケーションの実行に使用します。  
+  
+4.  **ソリューション エクスプローラー**で新しく追加した **NumberGuessWorkflowHost** プロジェクトを右クリックし、**\[参照の追加\]** をクリックします。**\[参照の追加\]** の一覧から **\[ソリューション\]** を選択し、**NumberGuessWorkflowActivities** の横にあるチェック ボックスをオンにして、**\[OK\]** をクリックします。  
+  
+5.  **ソリューション エクスプローラー**で **Workflow1.xaml** を右クリックし、**\[削除\]** をクリックします。**\[OK\]** をクリックして確定します。  
+  
+### ワークフロー ホスティング コードを変更するには  
+  
+1.  **ソリューション エクスプローラー**で、**Program.cs** または **Module1.vb** をダブルクリックしてコードを表示します。  
+  
+    > [!TIP]
+    >  **ソリューション エクスプローラー** ウィンドウが表示されない場合は、**\[表示\]** メニューの **\[ソリューション エクスプローラー\]** をクリックします。  
+  
+     このプロジェクトは**ワークフロー コンソール アプリケーション** テンプレートを使用して作成されたため、**Program.cs** または **Module1.vb** には、次のようなワークフローの基本的なホスティング コードが含まれます。  
+  
+    ```vb  
+    ' Create and cache the workflow definition  
+    Activity workflow1 = new Workflow1()  
+    WorkflowInvoker.Invoke(workflow1)  
+    ```  
+  
+    ```csharp  
+    // Create and cache the workflow definition  
+    Activity workflow1 = new Workflow1();  
+    WorkflowInvoker.Invoke(workflow1);  
+    ```  
+  
+     この生成されたホスト コードでは <xref:System.Activities.WorkflowInvoker> を使用します。<xref:System.Activities.WorkflowInvoker> は、メソッド呼び出しのようにワークフローを呼び出す簡単な方法を提供し、永続化を使用しないワークフローのみに使用できます。<xref:System.Activities.WorkflowApplication> は、ライフ サイクル イベントの通知、実行制御、ブックマークの再開、および永続化を含むワークフローを実行するための豊富なモデルを提供します。 次の例ではブックマークを使用し、ワークフローのホスティングには <xref:System.Activities.WorkflowApplication> を使用します。**Program.cs** または **Module1.vb** の先頭にある既存の **using** ステートメントまたは **Imports** ステートメントの下に、次の `using` ステートメントまたは **Imports** ステートメントを追加します。  
+  
+    ```vb  
+    Imports NumberGuessWorkflowActivities  
+    Imports System.Threading  
+    ```  
+  
+    ```csharp  
+    using NumberGuessWorkflowActivities;  
+    using System.Threading;  
+    ```  
+  
+     <xref:System.Activities.WorkflowInvoker> を使用するコード行を次の <xref:System.Activities.WorkflowApplication> の基本的なホスティング コードに置き換えます。 このサンプル ホスティング コードでは、ワークフローをホストして呼び出すための基本的な手順を示します。ただし、このトピックのワークフローを正しく実行するための機能はまだありません。 次の手順では、アプリケーションが完了するまでにこの基本的なコードを変更して機能を追加します。  
+  
+    > [!NOTE]
+    >  前の「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」の手順で完了したワークフローに応じて、これらの例の `Workflow1` を `FlowchartNumberGuessWorkflow`、`SequentialNumberGuessWorkflow`、または `StateMachineNumberGuessWorkflow` に置き換えます。`Workflow1` を置き換えないと、ワークフローをビルドまたは実行しようとするときにビルド エラーが発生します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#4](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/extrasnippets.cs#4)]
+     [!code-vb[CFX_WF_GettingStarted#4](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/extrasnippets.vb#4)]  
+  
+     このコードでは <xref:System.Activities.WorkflowApplication> を作成し、3 つのワークフローのライフサイクル イベントに定期受信し、<xref:System.Activities.WorkflowApplication.Run%2A> を呼び出してワークフローを開始し、そのワークフローが完了するまで待機します。 ワークフローが完了すると <xref:System.Threading.AutoResetEvent> が設定され、ホスト アプリケーションが完了します。  
+  
+### ワークフローの入力引数を設定するには  
+  
+1.  **Program.cs** または **Module1.vb** の先頭にある既存の `using` ステートメントまたは `Imports` ステートメントの下に、次のステートメントを追加します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#5](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#5)]
+     [!code-vb[CFX_WF_GettingStarted#5](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#5)]  
+  
+2.  新しい <xref:System.Activities.WorkflowApplication> を作成するコード行を、作成時にワークフローにパラメーターの辞書を作成して渡す次のコードに置き換えます。  
+  
+    > [!NOTE]
+    >  前の「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」の手順で完了したワークフローに応じて、これらの例の `Workflow1` を `FlowchartNumberGuessWorkflow`、`SequentialNumberGuessWorkflow`、または `StateMachineNumberGuessWorkflow` に置き換えます。`Workflow1` を置き換えないと、ワークフローをビルドまたは実行しようとするときにビルド エラーが発生します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#6](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#6)]
+     [!code-vb[CFX_WF_GettingStarted#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#6)]  
+  
+     この辞書には、`MaxNumber` というキーを持つ 1 つの要素が含まれます。 入力辞書のキーは、ワークフローのルート アクティビティの入力引数に対応します。`MaxNumber` は、ランダムに生成される数値の上限を決定するためにワークフローによって使用されます。  
+  
+### ワークフローの出力引数を取得するには  
+  
+1.  <xref:System.Activities.WorkflowApplication.Completed%2A> ハンドラーを変更して、ワークフローが使用する順番の数を取得して表示します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#7](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#7)]
+     [!code-vb[CFX_WF_GettingStarted#7](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#7)]  
+  
+### ブックマークを再開するには  
+  
+1.  `Main` メソッドの上部にある既存の <xref:System.Threading.AutoResetEvent> 宣言の直後に、次のコードを追加します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#8](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#8)]
+     [!code-vb[CFX_WF_GettingStarted#8](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#8)]  
+  
+2.  <xref:System.Activities.WorkflowApplication.Idle%2A> にある既存の 3 つのワークフロー ライフサイクル ハンドラーの直後に、次の `Main` ハンドラーを追加します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#9](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#9)]
+     [!code-vb[CFX_WF_GettingStarted#9](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#9)]  
+  
+     このハンドラーは、次の推定値を待機してワークフローがアイドル状態になるたびに呼び出され、`idleAction`<xref:System.Threading.AutoResetEvent> が設定されます。 次の手順のコードでは、`idleEvent` と `syncEvent` を使用して、ワークフローが次の推定値を待機しているのか、完了しているのかを判断します。  
+  
+    > [!NOTE]
+    >  この例では、ホスト アプリケーションは <xref:System.Activities.WorkflowApplication.Completed%2A> および <xref:System.Activities.WorkflowApplication.Idle%2A> ハンドラーの自動リセット イベントを使用して、ホスト アプリケーションとワークフローの進行状況を同期させます。 ブックマークを再開する前にワークフローがアイドル状態になるのをブロックして待機する必要はありませんが、この例では同期イベントが必要であるため、ホストはワークフローが完了しているのか、さらにユーザーの入力を待っているのかを <xref:System.Activities.Bookmark> を使用して把握します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [ブックマーク](../../../docs/framework/windows-workflow-foundation//bookmarks.md)。  
+  
+3.  `WaitOne` への呼び出しを削除して、ユーザーからの入力を収集して <xref:System.Activities.Bookmark> を再開するためのコードに置き換えます。  
+  
+     次のコード行を削除します。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#10](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/extrasnippets.cs#10)]
+     [!code-vb[CFX_WF_GettingStarted#10](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/extrasnippets.vb#10)]  
+  
+     これを次の例に置き換えます。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#11](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#11)]
+     [!code-vb[CFX_WF_GettingStarted#11](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#11)]  
+  
+##  <a name="BKMK_ToRunTheApplication"></a> アプリケーションをビルドして実行するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowHost** を右クリックして **\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+2.  Ctrl キーを押しながら F5 キーを押してアプリケーションをビルドし、実行します。 できるだけ早い順番の数を推測します。  
+  
+     他のスタイルのワークフローのいずれかでアプリケーションを試すには、目的のワークフローのスタイルに応じて、`Workflow1` を作成するコード内の <xref:System.Activities.WorkflowApplication> を、`FlowchartNumberGuessWorkflow`、`SequentialNumberGuessWorkflow`、または `StateMachineNumberGuessWorkflow` に置き換えます。  
+  
+     [!code-csharp[CFX_WF_GettingStarted#6](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#6)]
+     [!code-vb[CFX_WF_GettingStarted#6](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#6)]  
+  
+     ワークフロー アプリケーションに永続化を追加する方法については、次のトピック「[長時間にわたって実行されるワークフローを作成して実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、`Main` メソッドの完全なコードの一覧を示します。  
+  
+> [!NOTE]
+>  前の「[ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)」の手順で完了したワークフローに応じて、これらの例の `Workflow1` を `FlowchartNumberGuessWorkflow`、`SequentialNumberGuessWorkflow`、または `StateMachineNumberGuessWorkflow` に置き換えます。`Workflow1` を置き換えないと、ワークフローをビルドまたは実行しようとするときにビルド エラーが発生します。  
+  
+ [!code-csharp[CFX_WF_GettingStarted#12](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_wf_gettingstarted/cs/program.cs#12)]
+ [!code-vb[CFX_WF_GettingStarted#12](../../../samples/snippets/visualbasic/VS_Snippets_CFX/cfx_wf_gettingstarted/vb/module1.vb#12)]  
+  
+## 参照  
+ <xref:System.Activities.WorkflowApplication>   
+ <xref:System.Activities.Bookmark>   
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)   
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)   
+ [ワークフローを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow.md)   
+ [長時間にわたって実行されるワークフローを作成して実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-and-run-a-long-running-workflow.md)   
+ [ワークフロー内での入力の待機](../../../docs/framework/windows-workflow-foundation//waiting-for-input-in-a-workflow.md)   
+ [ワークフローのホスティング](../../../docs/framework/windows-workflow-foundation//hosting-workflows.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/how-to-update-the-definition-of-a-running-workflow-instance.md b/docs/framework/windows-workflow-foundation/how-to-update-the-definition-of-a-running-workflow-instance.md
new file mode 100644
index 00000000000..cf7d74541f3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/how-to-update-the-definition-of-a-running-workflow-instance.md
@@ -0,0 +1,1588 @@
+---
+title: "実行中のワークフロー インスタンスの定義を更新する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 26dfac36-ae23-4909-9867-62495b55fb5e
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 実行中のワークフロー インスタンスの定義を更新する方法
+動的更新は、ワークフロー アプリケーションの開発者が永続化されたワークフロー インスタンスのワークフロー定義を更新するためのメカニズムを提供します。必要な変更には、バグ修正の実装、新しい要件の実装、または予期しない変更への対応があります。チュートリアルのこの手順では、「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で説明した新機能に対応するように `v1` 数値推測ワークフローの永続化されたインスタンスを、動的更新を使用して変更する方法について説明します。  
+  
+> [!NOTE]
+>  チュートリアルの完成版をダウンロードしたり、チュートリアルのビデオを閲覧したりするには、「[Windows Workflow Foundation \(WF45\) \- チュートリアル入門](http://go.microsoft.com/fwlink/?LinkID=248976)」を参照してください。  
+  
+## このトピックの内容  
+  
+-   [CreateUpdateMaps プロジェクトを作成するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_CreateProject)  
+  
+-   [StateMachineNumberGuessWorkflow を更新するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_StateMachine)  
+  
+-   [FlowchartNumberGuessWorkflow を更新するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_Flowchart)  
+  
+-   [SequentialNumberGuessWorkflow を更新するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_Sequential)  
+  
+-   [CreateUpdateMaps アプリケーションをビルドして実行するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_CreateUpdateMaps)  
+  
+-   [更新されたワークフロー アセンブリをビルドするには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_BuildAssembly)  
+  
+-   [新しいバージョンで WorkflowVersionMap を更新するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_UpdateWorkflowVersionMap)  
+  
+-   [動的更新を適用するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_ApplyUpdate)  
+  
+-   [更新されたワークフローを含むアプリケーションを実行するには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_BuildAndRun)  
+  
+-   [ワークフローの以前のバージョンを開始できるようにするには](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md#BKMK_StartPreviousVersions)  
+  
+###  <a name="BKMK_CreateProject"></a> CreateUpdateMaps プロジェクトを作成するには  
+  
+1.  **ソリューション エクスプローラー**で **WF45GettingStartedTutorial** を右クリックし、**\[追加\]** をポイントして、**\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[インストール済み\]** ノードで **\[Visual C\#\]**、**\[Windows\]** \(または **\[Visual Basic\]**、**\[Windows\]**\) の順に選択します。  
+  
+    > [!NOTE]
+    >  Visual Studio で第一言語として設定されているプログラミング言語に応じて、**\[インストール済み\]** ノードの **\[他の言語\]** ノードの下に、**\[Visual C\#\]** ノードまたは **\[Visual Basic\]** ノードが表示されます。  
+  
+     .NET Framework バージョンのドロップダウン リストで **\[.NET Framework 4.5\]** が選択されていることを確認します。**\[Windows\]**  ボックスから **\[コンソール アプリケーション\]** を選択します。**\[名前\]** ボックスに「**CreateUpdateMaps**」と入力し、**\[OK\]** をクリックします。  
+  
+3.  **ソリューション エクスプローラー**で **CreateUpdateMaps** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+4.  **\[参照の追加\]** の一覧で、**\[アセンブリ\]** ノードから **\[フレームワーク\]** を選択します。**\[アセンブリの検索\]** ボックスに「**System.Activities**」と入力し、アセンブリをフィルター処理して目的の参照を選択しやすくします。  
+  
+5.  **\[検索結果\]** の一覧で **System.Activities** の横にあるチェック ボックスをオンにします。  
+  
+6.  **\[アセンブリの検索\]** ボックスに「**Serialization**」と入力し、**\[検索結果\]** の一覧で **System.Runtime.Serialization** の横にあるチェック ボックスをオンにします。  
+  
+7.  **\[アセンブリの検索\]** ボックスに「**System.Xaml**」と入力し、**\[検索結果\]** の一覧で **System.Xaml** の横にあるチェック ボックスをオンにします。  
+  
+8.  **\[OK\]** をクリックして**参照マネージャー**を閉じ、参照を追加します。  
+  
+9. 次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Activities  
+    Imports System.Activities.Statements  
+    Imports System.Xaml  
+    Imports System.Reflection  
+    Imports System.IO  
+    Imports System.Activities.XamlIntegration  
+    Imports System.Activities.DynamicUpdate  
+    Imports System.Runtime.Serialization  
+    Imports Microsoft.VisualBasic.Activities  
+    ```  
+  
+    ```csharp  
+    using System.Activities;  
+    using System.Activities.Statements;  
+    using System.IO;  
+    using System.Xaml;  
+    using System.Reflection;  
+    using System.Activities.XamlIntegration;  
+    using System.Activities.DynamicUpdate;  
+    using System.Runtime.Serialization;  
+    using Microsoft.CSharp.Activities;  
+    ```  
+  
+10. `Program` クラス \(または `Module1`\) に次の 2 つの文字列メンバーを追加します。  
+  
+    ```vb  
+    Const mapPath = "..\..\..\PreviousVersions"  
+    Const definitionPath = "..\..\..\NumberGuessWorkflowActivities_du"  
+    ```  
+  
+    ```csharp  
+    const string mapPath = @"..\..\..\PreviousVersions";  
+    const string definitionPath = @"..\..\..\NumberGuessWorkflowActivities_du";  
+    ```  
+  
+11. `Program` クラス \(または `Module1`\) に次の `StartUpdate` メソッドを追加します。このメソッドにより、指定した xaml ワークフロー定義が `ActivityBuilder` に読み込まれた後、`DynamicUpdate.PrepareForUpdate` が呼び出されます。`PrepareForUpdate` は `ActivityBuilder` 内にワークフロー定義のコピーを作成します。ワークフロー定義が変更されると、更新マップを作成するように変更されたワークフロー定義と共に、このコピーは使用されます。  
+  
+    ```vb  
+    Private Function StartUpdate(name As String) As ActivityBuilder  
+        'Create the XamlXmlReaderSettings.  
+        Dim readerSettings As XamlReaderSettings = New XamlXmlReaderSettings()  
+        'In the XAML the "local" namespace referes to artifacts that come from   
+        'the same project as the XAML. When loading XAML if the currently executing   
+        'assembly is not the same assembly that was referred to as "local" in the XAML  
+        'LocalAssembly must be set to the assembly containing the artifacts.  
+        'Assembly.LoadFile requires an absolute path so convert this relative path  
+        'to an absolute path.  
+        readerSettings.LocalAssembly = Assembly.LoadFile(  
+            Path.GetFullPath(Path.Combine(mapPath, "NumberGuessWorkflowActivities_v1.dll")))  
+  
+        Dim fullPath As String = Path.Combine(definitionPath, name)  
+        Dim xamlReader As XamlXmlReader = New XamlXmlReader(fullPath, readerSettings)  
+  
+        'Load the workflow definition into an ActivityBuilder.  
+        Dim wf As ActivityBuilder = XamlServices.Load(  
+            ActivityXamlServices.CreateBuilderReader(xamlReader))  
+  
+        'PrepareForUpdate makes a copy of the workflow definition in the  
+        'ActivityBuilder that is used for comparison when the update  
+        'map is created.  
+        DynamicUpdateServices.PrepareForUpdate(wf)  
+  
+        Return wf  
+    End Function  
+    ```  
+  
+    ```csharp  
+    private static ActivityBuilder StartUpdate(string name)  
+    {  
+        // Create the XamlXmlReaderSettings.  
+        XamlXmlReaderSettings readerSettings = new XamlXmlReaderSettings()  
+        {  
+            // In the XAML the "local" namespace referes to artifacts that come from   
+            // the same project as the XAML. When loading XAML if the currently executing   
+            // assembly is not the same assembly that was referred to as "local" in the XAML  
+            // LocalAssembly must be set to the assembly containing the artifacts.  
+            // Assembly.LoadFile requires an absolute path so convert this relative path  
+            // to an absolute path.  
+            LocalAssembly = Assembly.LoadFile(  
+                Path.GetFullPath(Path.Combine(mapPath, "NumberGuessWorkflowActivities_v1.dll")))  
+        };  
+  
+        string path = Path.Combine(definitionPath, name);  
+        XamlXmlReader xamlReader = new XamlXmlReader(path, readerSettings);  
+  
+        // Load the workflow definition into an ActivityBuilder.  
+        ActivityBuilder wf = XamlServices.Load(  
+            ActivityXamlServices.CreateBuilderReader(xamlReader))  
+            as ActivityBuilder;  
+  
+        // PrepareForUpdate makes a copy of the workflow definition in the  
+        // ActivityBuilder that is used for comparison when the update  
+        // map is created.  
+        DynamicUpdateServices.PrepareForUpdate(wf);  
+  
+        return wf;  
+    }  
+    ```  
+  
+12. 次に、`Program` クラス \(または `Module1`\) に次の `CreateUpdateMethod` を追加します。これにより、DynamicUpdateServices.CreateUpdateMap が呼び出されて動的更新マップが作成され、指定した名前を使用してその更新マップが保存されます。この更新マップには、`ActivityBuilder` に格納されている元のワークフロー定義を使用して開始された、永続化されたワークフロー インスタンスが、更新されたワークフロー定義を使用して完了するよう更新するために、ワークフロー ランタイムで必要な情報が含まれています。  
+  
+    ```vb  
+    Private Sub CreateUpdateMaps(wf As ActivityBuilder, name As String)  
+        'Create the UpdateMap.  
+        Dim map As DynamicUpdateMap =  
+            DynamicUpdateServices.CreateUpdateMap(wf)  
+  
+        'Serialize it to a file.  
+        Dim mapFullPath As String = Path.Combine(mapPath, name)  
+        Dim sz As DataContractSerializer = New DataContractSerializer(GetType(DynamicUpdateMap))  
+        Using fs As FileStream = File.Open(mapFullPath, FileMode.Create)  
+            sz.WriteObject(fs, map)  
+        End Using  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void CreateUpdateMaps(ActivityBuilder wf, string name)  
+    {  
+        // Create the UpdateMap.  
+        DynamicUpdateMap map =  
+            DynamicUpdateServices.CreateUpdateMap(wf);  
+  
+        // Serialize it to a file.  
+        string path = Path.Combine(mapPath, name);  
+        DataContractSerializer sz = new DataContractSerializer(typeof(DynamicUpdateMap));  
+        using (FileStream fs = System.IO.File.Open(path, FileMode.Create))  
+        {  
+            sz.WriteObject(fs, map);  
+        }  
+    }  
+    ```  
+  
+13. `Program` クラス \(または `Module1`\) に次の `SaveUpdatedDefinition` メソッドを追加します。このメソッドは、更新マップが作成されると、更新されたワークフロー定義を保存します。  
+  
+    ```vb  
+    Private Sub SaveUpdatedDefinition(wf As ActivityBuilder, name As String)  
+        Dim xamlPath As String = Path.Combine(definitionPath, name)  
+        Dim sw As StreamWriter = File.CreateText(xamlPath)  
+        Dim xw As XamlWriter = ActivityXamlServices.CreateBuilderWriter(  
+            New XamlXmlWriter(sw, New XamlSchemaContext()))  
+        XamlServices.Save(xw, wf)  
+        sw.Close()  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void SaveUpdatedDefinition(ActivityBuilder wf, string name)  
+    {  
+        string xamlPath = Path.Combine(definitionPath, name);  
+        StreamWriter sw = File.CreateText(xamlPath);  
+        XamlWriter xw = ActivityXamlServices.CreateBuilderWriter(  
+            new XamlXmlWriter(sw, new XamlSchemaContext()));  
+        XamlServices.Save(xw, wf);  
+        sw.Close();  
+    }  
+    ```  
+  
+###  <a name="BKMK_StateMachine"></a> StateMachineNumberGuessWorkflow を更新するには  
+  
+1.  `Program` クラス \(または `Module1`\) に `CreateStateMachineUpdateMap` を追加します。  
+  
+    ```vb  
+    Private Sub CreateStateMachineUpdateMap()  
+  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void CreateStateMachineUpdateMap()  
+    {    
+    }  
+    ```  
+  
+2.  `StartUpdate` を呼び出し、ワークフローのルート `StateMachine` アクティビティへの参照を取得します。  
+  
+    ```vb  
+    Dim wf As ActivityBuilder = StartUpdate("StateMachineNumberGuessWorkflow.xaml")  
+  
+    'Get a reference to the root StateMachine activity.  
+    Dim sm As StateMachine = wf.Implementation  
+    ```  
+  
+    ```csharp  
+    ActivityBuilder wf = StartUpdate("StateMachineNumberGuessWorkflow.xaml");  
+  
+    // Get a reference to the root StateMachine activity.  
+    StateMachine sm = wf.Implementation as StateMachine;  
+    ```  
+  
+3.  「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で行った更新と一致するように、ユーザーの推定値が大きすぎるか小さすぎるかを表示する 2 つの `WriteLine` アクティビティの式を更新します。  
+  
+    ```vb  
+    'Update the Text of the two WriteLine activities that write the  
+    'results of the user's guess. They are contained in the workflow as the  
+    'Then and Else action of the If activity in sm.States[1].Transitions[1].Action.  
+    Dim guessLow As Statements.If = sm.States(1).Transitions(1).Action  
+  
+    'Update the "too low" message.  
+    Dim tooLow As WriteLine = guessLow.Then  
+    tooLow.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too low.""")  
+  
+    'Update the "too high" message.  
+    Dim tooHigh As WriteLine = guessLow.Else  
+    tooHigh.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too high.""")  
+    ```  
+  
+    ```csharp  
+    // Update the Text of the two WriteLine activities that write the  
+    // results of the user's guess. They are contained in the workflow as the  
+    // Then and Else action of the If activity in sm.States[1].Transitions[1].Action.  
+    If guessLow = sm.States[1].Transitions[1].Action as If;  
+  
+    // Update the "too low" message.  
+    WriteLine tooLow = guessLow.Then as WriteLine;  
+    tooLow.Text = new CSharpValue<string>("Guess.ToString() + \" is too low.\"");  
+  
+    // Update the "too high" message.  
+    WriteLine tooHigh = guessLow.Else as WriteLine;  
+    tooHigh.Text = new CSharpValue<string>("Guess.ToString() + \" is too high.\"");  
+    ```  
+  
+4.  終了メッセージを表示する新しい `WriteLine` アクティビティを追加します。  
+  
+    ```vb  
+    'Create the new WriteLine that displays the closing message.  
+    Dim wl As New WriteLine() With  
+    {  
+        .Text = New VisualBasicValue(Of String) _  
+            ("Guess.ToString() + "" is correct. You guessed it in "" & Turns.ToString() & "" turns.""")  
+    }  
+  
+    'Add it as the Action for the Guess Correct transition. The Guess Correct  
+    'transition is the first transition of States[1]. The transitions are listed  
+    'at the bottom of the State activity designer.  
+    sm.States(1).Transitions(0).Action = wl  
+    ```  
+  
+    ```csharp  
+    // Create the new WriteLine that displays the closing message.  
+    WriteLine wl = new WriteLine  
+    {  
+        Text = new CSharpValue<string>("Guess.ToString() + \" is correct. You guessed it in \" + Turns.ToString() + \" turns.\"")  
+    };  
+  
+    // Add it as the Action for the Guess Correct transition. The Guess Correct  
+    // transition is the first transition of States[1]. The transitions are listed  
+    // at the bottom of the State activity designer.  
+    sm.States[1].Transitions[0].Action = wl;  
+    ```  
+  
+5.  ワークフローを更新したら、`CreateUpdateMaps` と `SaveUpdatedDefinition` を呼び出します。`CreateUpdateMaps` は `DynamicUpdateMap` を作成して保存し、`SaveUpdatedDefinition` は更新されたワークフロー定義を保存します。  
+  
+    ```vb  
+    'Create the update map.  
+    CreateUpdateMaps(wf, "StateMachineNumberGuessWorkflow.map")  
+  
+    'Save the updated workflow definition.  
+    SaveUpdatedDefinition(wf, "StateMachineNumberGuessWorkflow_du.xaml")  
+    ```  
+  
+    ```csharp  
+    // Create the update map.  
+    CreateUpdateMaps(wf, "StateMachineNumberGuessWorkflow.map");  
+  
+    // Save the updated workflow definition.  
+    SaveUpdatedDefinition(wf, "StateMachineNumberGuessWorkflow_du.xaml");  
+    ```  
+  
+     完成した `CreateStateMachineUpdateMap` メソッドは次のようになります。  
+  
+    ```vb  
+    Private Sub CreateStateMachineUpdateMap()  
+        Dim wf As ActivityBuilder = StartUpdate("StateMachineNumberGuessWorkflow.xaml")  
+  
+        'Get a reference to the root StateMachine activity.  
+        Dim sm As StateMachine = wf.Implementation  
+  
+        'Update the Text of the two WriteLine activities that write the  
+        'results of the user's guess. They are contained in the workflow as the  
+        'Then and Else action of the If activity in sm.States[1].Transitions[1].Action.  
+        Dim guessLow As Statements.If = sm.States(1).Transitions(1).Action  
+  
+        'Update the "too low" message.  
+        Dim tooLow As WriteLine = guessLow.Then  
+        tooLow.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too low.""")  
+  
+        'Update the "too high" message.  
+        Dim tooHigh As WriteLine = guessLow.Else  
+        tooHigh.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too high.""")  
+  
+        'Create the new WriteLine that displays the closing message.  
+        Dim wl As New WriteLine() With  
+        {  
+            .Text = New VisualBasicValue(Of String) _  
+                ("Guess.ToString() + "" is correct. You guessed it in "" & Turns.ToString() & "" turns.""")  
+        }  
+  
+        'Add it as the Action for the Guess Correct transition. The Guess Correct  
+        'transition is the first transition of States[1]. The transitions are listed  
+        'at the bottom of the State activity designer.  
+        sm.States(1).Transitions(0).Action = wl  
+  
+        'Create the update map.  
+        CreateUpdateMaps(wf, "StateMachineNumberGuessWorkflow.map")  
+  
+        'Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "StateMachineNumberGuessWorkflow_du.xaml")  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void CreateStateMachineUpdateMap()  
+    {  
+        ActivityBuilder wf = StartUpdate("StateMachineNumberGuessWorkflow.xaml");  
+  
+        // Get a reference to the root StateMachine activity.  
+        StateMachine sm = wf.Implementation as StateMachine;  
+  
+        // Update the Text of the two WriteLine activities that write the  
+        // results of the user's guess. They are contained in the workflow as the  
+        // Then and Else action of the If activity in sm.States[1].Transitions[1].Action.  
+        If guessLow = sm.States[1].Transitions[1].Action as If;  
+  
+        // Update the "too low" message.  
+        WriteLine tooLow = guessLow.Then as WriteLine;  
+        tooLow.Text = new CSharpValue<string>("Guess.ToString() + \" is too low.\"");  
+  
+        // Update the "too high" message.  
+        WriteLine tooHigh = guessLow.Else as WriteLine;  
+        tooHigh.Text = new CSharpValue<string>("Guess.ToString() + \" is too high.\"");  
+  
+        // Create the new WriteLine that displays the closing message.  
+        WriteLine wl = new WriteLine  
+        {  
+            Text = new CSharpValue<string>("Guess.ToString() + \" is correct. You guessed it in \" + Turns.ToString() + \" turns.\"")  
+        };  
+  
+        // Add it as the Action for the Guess Correct transition. The Guess Correct  
+        // transition is the first transition of States[1]. The transitions are listed  
+        // at the bottom of the State activity designer.  
+        sm.States[1].Transitions[0].Action = wl;  
+  
+        // Create the update map.  
+        CreateUpdateMaps(wf, "StateMachineNumberGuessWorkflow.map");  
+  
+        // Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "StateMachineNumberGuessWorkflow_du.xaml");  
+    }  
+    ```  
+  
+###  <a name="BKMK_Flowchart"></a> FlowchartNumberGuessWorkflow を更新するには  
+  
+1.  `Program` クラス \(または `Module1`\) に次の `CreateFlowchartUpdateMethod` を追加します。このメソッドは `CreateStateMachineUpdateMap` に似ています。最初に `StartUpdate` を呼び出し、フローチャート ワークフロー定義を更新して、最後に更新マップおよび更新されたワークフロー定義を保存します。  
+  
+    ```vb  
+    Private Sub CreateFlowchartUpdateMap()  
+        Dim wf As ActivityBuilder = StartUpdate("FlowchartNumberGuessWorkflow.xaml")  
+  
+        'Get a reference to the root Flowchart activity.  
+        Dim fc As Flowchart = wf.Implementation  
+  
+        'Update the Text of the two WriteLine activities that write the  
+        'results of the user's guess. They are contained in the workflow as the  
+        'True and False action of the "Guess < Target" FlowDecision, which is  
+        'Nodes[4].  
+        Dim guessLow As FlowDecision = fc.Nodes(4)  
+  
+        'Update the "too low" message.  
+        Dim trueStep As FlowStep = guessLow.True  
+        Dim tooLow As WriteLine = trueStep.Action  
+        tooLow.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too low.""")  
+  
+        'Update the "too high" message.  
+        Dim falseStep As FlowStep = guessLow.False  
+        Dim tooHigh As WriteLine = falseStep.Action  
+        tooHigh.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too high.""")  
+  
+        'Create the new WriteLine that displays the closing message.  
+        Dim wl As New WriteLine() With  
+        {  
+            .Text = New VisualBasicValue(Of String) _  
+                ("Guess.ToString() + "" is correct. You guessed it in "" & Turns.ToString() & "" turns.""")  
+        }  
+  
+        'Create a FlowStep to hold the WriteLine.  
+        Dim closingStep As New FlowStep() With  
+        {  
+            .Action = wl  
+        }  
+  
+        'Add this new FlowStep to the True action of the   
+        '"Guess = Guess" FlowDecision  
+        Dim guessCorrect As FlowDecision = fc.Nodes(3)  
+        guessCorrect.True = closingStep  
+  
+        'Add the new FlowStep to the Nodes collection.  
+        'If closingStep was replacing an existing node then  
+        'we would need to remove that Step from the collection.  
+        'In this example there was no existing True step to remove.  
+        fc.Nodes.Add(closingStep)  
+  
+        'Create the update map.  
+        CreateUpdateMaps(wf, "FlowchartNumberGuessWorkflow.map")  
+  
+        'Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "FlowchartNumberGuessWorkflow_du.xaml")  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void CreateFlowchartUpdateMap()  
+    {  
+        ActivityBuilder wf = StartUpdate("FlowchartNumberGuessWorkflow.xaml");  
+  
+        // Get a reference to the root Flowchart activity.  
+        Flowchart fc = wf.Implementation as Flowchart;  
+  
+        // Update the Text of the two WriteLine activities that write the  
+        // results of the user's guess. They are contained in the workflow as the  
+        // True and False action of the "Guess < Target" FlowDecision, which is  
+        // Nodes[4].  
+        FlowDecision guessLow = fc.Nodes[4] as FlowDecision;  
+  
+        // Update the "too low" message.  
+        FlowStep trueStep = guessLow.True as FlowStep;  
+        WriteLine tooLow = trueStep.Action as WriteLine;  
+        tooLow.Text = new CSharpValue<string>("Guess.ToString() + \" is too low.\"");  
+  
+        // Update the "too high" message.  
+        FlowStep falseStep = guessLow.False as FlowStep;  
+        WriteLine tooHigh = falseStep.Action as WriteLine;  
+        tooHigh.Text = new CSharpValue<string>("Guess.ToString() + \" is too high.\"");  
+  
+        // Add the new WriteLine that displays the closing message.  
+        WriteLine wl = new WriteLine  
+        {  
+            Text = new CSharpValue<string>("Guess.ToString() + \" is correct. You guessed it in \" + Turns.ToString() + \" turns.\"")  
+        };  
+  
+        // Create a FlowStep to hold the WriteLine.  
+        FlowStep closingStep = new FlowStep  
+        {  
+            Action = wl  
+        };  
+  
+        // Add this new FlowStep to the True action of the   
+        // "Guess == Guess" FlowDecision  
+        FlowDecision guessCorrect = fc.Nodes[3] as FlowDecision;  
+        guessCorrect.True = closingStep;  
+  
+        // Add the new FlowStep to the Nodes collection.  
+        // If closingStep was replacing an existing node then  
+        // we would need to remove that Step from the collection.  
+        // In this example there was no existing True step to remove.  
+        fc.Nodes.Add(closingStep);  
+  
+        // Create the update map.  
+        CreateUpdateMaps(wf, "FlowchartNumberGuessWorkflow.map");  
+  
+        //  Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "FlowchartNumberGuessWorkflow_du.xaml");  
+    }  
+    ```  
+  
+###  <a name="BKMK_Sequential"></a> SequentialNumberGuessWorkflow を更新するには  
+  
+1.  `Program` クラス \(または `Module1`\) に次の `CreateSequentialUpdateMethod` を追加します。このメソッドは、他の 2 つのメソッドに似ています。最初に `StartUpdate` を呼び出し、シーケンシャル ワークフロー定義を更新して、最後に更新マップおよび更新されたワークフロー定義を保存します。  
+  
+    ```vb  
+    Private Sub CreateSequentialUpdateMap()  
+        Dim wf As ActivityBuilder = StartUpdate("SequentialNumberGuessWorkflow.xaml")  
+  
+        'Get a reference to the root activity in the workflow.  
+        Dim rootSequence As Sequence = wf.Implementation  
+  
+        'Update the Text of the two WriteLine activities that write the  
+        'results of the user's guess. They are contained in the workflow as the  
+        'Then and Else action of the "Guess < Target" If activity.  
+        'Sequence[1]->DoWhile->Body->Sequence[2]->If->Then->If  
+        Dim gameLoop As Statements.DoWhile = rootSequence.Activities(1)  
+        Dim gameBody As Sequence = gameLoop.Body  
+        Dim guessCorrect As Statements.If = gameBody.Activities(2)  
+        Dim guessLow As Statements.If = guessCorrect.Then  
+        Dim tooLow As WriteLine = guessLow.Then  
+        tooLow.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too low.""")  
+        Dim tooHigh As WriteLine = guessLow.Else  
+        tooHigh.Text = New VisualBasicValue(Of String)("Guess.ToString() & "" is too high.""")  
+  
+        'Create the new WriteLine that displays the closing message.  
+        Dim wl As New WriteLine() With  
+        {  
+            .Text = New VisualBasicValue(Of String) _  
+                ("Guess.ToString() + "" is correct. You guessed it in "" & Turns.ToString() & "" turns.""")  
+        }  
+  
+        'Insert it as the third activity in the root sequence  
+        rootSequence.Activities.Insert(2, wl)  
+  
+        'Create the update map.  
+        CreateUpdateMaps(wf, "SequentialNumberGuessWorkflow.map")  
+  
+        'Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "SequentialNumberGuessWorkflow_du.xaml")  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private static void CreateSequentialUpdateMap()  
+    {  
+        ActivityBuilder wf = StartUpdate("SequentialNumberGuessWorkflow.xaml");  
+  
+        // Get a reference to the root activity in the workflow.  
+        Sequence rootSequence = wf.Implementation as Sequence;  
+  
+        // Update the Text of the two WriteLine activities that write the  
+        // results of the user's guess. They are contained in the workflow as the  
+        // Then and Else action of the "Guess < Target" If activity.  
+        // Sequence[1]->DoWhile->Body->Sequence[2]->If->Then->If  
+        DoWhile gameLoop = rootSequence.Activities[1] as DoWhile;  
+        Sequence gameBody = gameLoop.Body as Sequence;  
+        If guessCorrect = gameBody.Activities[2] as If;  
+        If guessLow = guessCorrect.Then as If;  
+        WriteLine tooLow = guessLow.Then as WriteLine;  
+        tooLow.Text = new CSharpValue<string>("Guess.ToString() + \" is too low.\"");  
+        WriteLine tooHigh = guessLow.Else as WriteLine;  
+        tooHigh.Text = new CSharpValue<string>("Guess.ToString() + \" is too high.\"");  
+  
+        // Add the new WriteLine that displays the closing message.  
+        WriteLine wl = new WriteLine  
+        {  
+            Text = new CSharpValue<string>("Guess.ToString() + \" is correct. You guessed it in \" + Turns.ToString() + \" turns.\"")  
+        };  
+  
+        // Insert it as the third activity in the root sequence  
+        rootSequence.Activities.Insert(2, wl);  
+  
+        // Create the update map.  
+        CreateUpdateMaps(wf, "SequentialNumberGuessWorkflow.map");  
+  
+        // Save the updated workflow definition.  
+        SaveUpdatedDefinition(wf, "SequentialNumberGuessWorkflow_du.xaml");  
+    }  
+    ```  
+  
+###  <a name="BKMK_CreateUpdateMaps"></a> CreateUpdateMaps アプリケーションをビルドして実行するには  
+  
+1.  `Main` メソッドを更新し、次の 3 つのメソッド呼び出しを追加します。これらのメソッドは次のセクションで追加されます。各メソッドは、対応する数値推測ワークフローを更新し、更新内容を示す `DynamicUpdateMap` を作成します。  
+  
+    ```vb  
+    Sub Main()  
+        'Create the update maps for the changes needed to the v1 activities  
+        'so they match the v2 activities.  
+        CreateSequentialUpdateMap()  
+        CreateFlowchartUpdateMap()  
+        CreateStateMachineUpdateMap()  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    static void Main(string[] args)  
+    {  
+        // Create the update maps for the changes needed to the v1 activities  
+        // so they match the v2 activities.  
+        CreateSequentialUpdateMap();  
+        CreateFlowchartUpdateMap();  
+        CreateStateMachineUpdateMap();  
+    }  
+    ```  
+  
+2.  **ソリューション エクスプローラー**で **CreateUpdateMaps** を右クリックし、**\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+3.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押して `CreateUpdateMaps` アプリケーションを実行します。  
+  
+    > [!NOTE]
+    >  `CreateUpdateMaps` アプリケーションでは、実行中にステータス情報が表示されませんが、**NumberGuessWorkflowActivities\_du** フォルダーと **PreviousVersions** フォルダーを調べると、更新されたワークフロー定義ファイルと更新マップが見つかります。  
+  
+     更新マップが作成され、ワークフロー定義が更新されたら、次に、更新された定義を含む更新されたワークフロー アセンブリをビルドします。  
+  
+###  <a name="BKMK_BuildAssembly"></a> 更新されたワークフロー アセンブリをビルドするには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の別のインスタンスを開きます。  
+  
+2.  **\[ファイル\]** メニューの **\[開く\]**、**\[プロジェクト\/ソリューション\]** の順にクリックします。  
+  
+3.  「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で作成した **NumberGuessWorkflowActivities\_du** フォルダーに移動し、**NumberGuessWorkflowActivities.csproj** \(または **vbproj**\) を選択して、**\[開く\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **SequentialNumberGuessWorkflow.xaml** を右クリックし、**\[プロジェクトから除外\]** をクリックします。**FlowchartNumberGuessWorkflow.xaml** と **StateMachineNumberGuessWorkflow.xaml** に対しても同じ操作を実行します。この手順により、以前のバージョンのワークフロー定義がプロジェクトから削除されます。  
+  
+5.  **\[プロジェクト\]** メニューの **\[既存項目の追加\]** をクリックします。  
+  
+6.  「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で作成した **NumberGuessWorkflowActivities\_du** フォルダーに移動します。  
+  
+7.  **\[ファイルの種類\]** ボックスの一覧の **\[XAML ファイル \(\*.xaml;\*.xoml\)\]** を選択します。  
+  
+8.  **SequentialNumberGuessWorkflow\_du.xaml**、**FlowchartNumberGuessWorkflow\_du.xaml**、および **StateMachineNumberGuessWorkflow\_du.xaml** を選択して、**\[追加\]** をクリックします。  
+  
+    > [!NOTE]
+    >  複数の項目を同時に選択するには、Ctrl を押しながら各項目をクリックします。  
+  
+     この手順により、更新されたワークフロー定義がプロジェクトに追加されます。  
+  
+9. **Ctrl** キーと **Shift** キーを押しながら **B** キーを押して、プロジェクトをビルドします。  
+  
+10. **\[ファイル\]** メニューの **\[ソリューションを閉じる\]** をクリックします。プロジェクトのソリューション ファイルは不要なため、**\[いいえ\]** をクリックして、ソリューション ファイルを保存せずに [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] を終了します。**\[ファイル\]** メニューの **\[終了\]** をクリックして [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] を終了します。  
+  
+11. エクスプローラーを開き、**NumberGuessWorkflowActivities\_du\\bin\\Debug** フォルダー \(プロジェクトの設定によっては **bin\\Release**\) に移動します。  
+  
+12. **NumberGuessWorkflowActivities.dll** の名前を **NumberGuessWorkflowActivities\_v15.dll** に変更し、「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」で作成した **PreviousVersions** フォルダーにコピーします。  
+  
+###  <a name="BKMK_UpdateWorkflowVersionMap"></a> 新しいバージョンで WorkflowVersionMap を更新するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] の最初のインスタンスに戻ります。  
+  
+2.  **NumberGuessWorkflowHost** プロジェクトの下の **WorkflowVersionMap.cs** \(または **WorkflowVersionMap.vb**\) をダブルクリックして開きます。  
+  
+3.  既存の 6 つのワークフロー ID 宣言の直後に、新しいワークフロー ID を 3 つ追加します。このチュートリアルでは、`1.5.0.0` は動的更新 ID の `WorkflowIdentity.Version` として使用されます。これらの新しい `v15` ワークフロー ID は、動的に更新される永続化されたワークフロー インスタンスに適切なワークフロー定義を指定するために使用されます。  
+  
+    ```vb  
+    'Current version identities.  
+    Public StateMachineNumberGuessIdentity As WorkflowIdentity  
+    Public FlowchartNumberGuessIdentity As WorkflowIdentity  
+    Public SequentialNumberGuessIdentity As WorkflowIdentity  
+  
+    'v1 identities.  
+    Public StateMachineNumberGuessIdentity_v1 As WorkflowIdentity  
+    Public FlowchartNumberGuessIdentity_v1 As WorkflowIdentity  
+    Public SequentialNumberGuessIdentity_v1 As WorkflowIdentity  
+  
+    'v1.5 (Dynamimc Update) identities.  
+    Public StateMachineNumberGuessIdentity_v15 As WorkflowIdentity  
+    Public FlowchartNumberGuessIdentity_v15 As WorkflowIdentity  
+    Public SequentialNumberGuessIdentity_v15 As WorkflowIdentity  
+    ```  
+  
+    ```csharp  
+    // Current version identities.  
+    static public WorkflowIdentity StateMachineNumberGuessIdentity;  
+    static public WorkflowIdentity FlowchartNumberGuessIdentity;  
+    static public WorkflowIdentity SequentialNumberGuessIdentity;  
+  
+    // v1 identities.  
+    static public WorkflowIdentity StateMachineNumberGuessIdentity_v1;  
+    static public WorkflowIdentity FlowchartNumberGuessIdentity_v1;  
+    static public WorkflowIdentity SequentialNumberGuessIdentity_v1;  
+  
+    // v1.5 (Dynamic Update) identities.  
+    static public WorkflowIdentity StateMachineNumberGuessIdentity_v15;  
+    static public WorkflowIdentity FlowchartNumberGuessIdentity_v15;  
+    static public WorkflowIdentity SequentialNumberGuessIdentity_v15;  
+    ```  
+  
+4.  コンストラクターの末尾に、次のコードを追加します。このコードでは、動的更新ワークフロー ID を初期化し、対応するワークフロー定義を読み込み、これらをワークフロー バージョン ディクショナリに追加します。  
+  
+    ```vb  
+    'Initialize the dynamic update workflow identities.  
+    StateMachineNumberGuessIdentity_v15 = New WorkflowIdentity With  
+    {  
+        .Name = "StateMachineNumberGuessWorkflow",  
+        .Version = New Version(1, 5, 0, 0)  
+    }  
+  
+    FlowchartNumberGuessIdentity_v15 = New WorkflowIdentity With  
+    {  
+        .Name = "FlowchartNumberGuessWorkflow",  
+        .Version = New Version(1, 5, 0, 0)  
+    }  
+  
+    SequentialNumberGuessIdentity_v15 = New WorkflowIdentity With  
+    {  
+        .Name = "SequentialNumberGuessWorkflow",  
+        .Version = New Version(1, 5, 0, 0)  
+    }  
+  
+    'Add the dynamic update workflow identities to the dictionary along with  
+    'the corresponding workflow definitions loaded from the v15 assembly.  
+    'Assembly.LoadFile requires an absolute path so convert this relative path  
+    'to an absolute path.  
+    Dim v15AssemblyPath As String = "..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v15.dll"  
+    v15AssemblyPath = Path.GetFullPath(v15AssemblyPath)  
+    Dim v15Assembly As Assembly = Assembly.LoadFile(v15AssemblyPath)  
+  
+    map.Add(StateMachineNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow"))  
+  
+    map.Add(SequentialNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow"))  
+  
+    map.Add(FlowchartNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow"))  
+    ```  
+  
+    ```csharp  
+    // Initialize the dynamic update workflow identities.  
+    StateMachineNumberGuessIdentity_v15 = new WorkflowIdentity  
+    {  
+        Name = "StateMachineNumberGuessWorkflow",  
+        Version = new Version(1, 5, 0, 0)  
+    };  
+  
+    FlowchartNumberGuessIdentity_v15 = new WorkflowIdentity  
+    {  
+        Name = "FlowchartNumberGuessWorkflow",  
+        Version = new Version(1, 5, 0, 0)  
+    };  
+  
+    SequentialNumberGuessIdentity_v15 = new WorkflowIdentity  
+    {  
+        Name = "SequentialNumberGuessWorkflow",  
+        Version = new Version(1, 5, 0, 0)  
+    };  
+  
+    // Add the dynamic update workflow identities to the dictionary along with  
+    // the corresponding workflow definitions loaded from the v15 assembly.  
+    // Assembly.LoadFile requires an absolute path so convert this relative path  
+    // to an absolute path.  
+    string v15AssemblyPath = @"..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v15.dll";  
+    v15AssemblyPath = Path.GetFullPath(v15AssemblyPath);  
+    Assembly v15Assembly = Assembly.LoadFile(v15AssemblyPath);  
+  
+    map.Add(StateMachineNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow") as Activity);  
+  
+    map.Add(SequentialNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow") as Activity);  
+  
+    map.Add(FlowchartNumberGuessIdentity_v15,  
+        v15Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow") as Activity);  
+  
+    ```  
+  
+     完成した `WorkflowVersionMap` クラスは次のようになります。  
+  
+    ```vb  
+    Public Module WorkflowVersionMap  
+        Dim map As Dictionary(Of WorkflowIdentity, Activity)  
+  
+        'Current version identities.  
+        Public StateMachineNumberGuessIdentity As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity As WorkflowIdentity  
+  
+        'v1 identities.  
+        Public StateMachineNumberGuessIdentity_v1 As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity_v1 As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity_v1 As WorkflowIdentity  
+  
+        'v1.5 (Dynamimc Update) identities.  
+        Public StateMachineNumberGuessIdentity_v15 As WorkflowIdentity  
+        Public FlowchartNumberGuessIdentity_v15 As WorkflowIdentity  
+        Public SequentialNumberGuessIdentity_v15 As WorkflowIdentity  
+  
+        Sub New()  
+            map = New Dictionary(Of WorkflowIdentity, Activity)  
+  
+            'Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(2, 0, 0, 0)  
+            }  
+  
+            map.Add(StateMachineNumberGuessIdentity, New StateMachineNumberGuessWorkflow())  
+            map.Add(FlowchartNumberGuessIdentity, New FlowchartNumberGuessWorkflow())  
+            map.Add(SequentialNumberGuessIdentity, New SequentialNumberGuessWorkflow())  
+  
+            'Initialize the previous workflow version identities.  
+            StateMachineNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity_v1 = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(1, 0, 0, 0)  
+            }  
+  
+            'Add the previous version workflow identities to the dictionary along with  
+            'the corresponding workflow definitions loaded from the v1 assembly.  
+            'Assembly.LoadFile requires an absolute path so convert this relative path  
+            'to an absolute path.  
+            Dim v1AssemblyPath As String = "..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll"  
+            v1AssemblyPath = Path.GetFullPath(v1AssemblyPath)  
+            Dim v1Assembly As Assembly = Assembly.LoadFile(v1AssemblyPath)  
+  
+            map.Add(StateMachineNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow"))  
+  
+            map.Add(SequentialNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow"))  
+  
+            map.Add(FlowchartNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow"))  
+  
+            'Initialize the dynamic update workflow identities.  
+            StateMachineNumberGuessIdentity_v15 = New WorkflowIdentity With  
+            {  
+                .Name = "StateMachineNumberGuessWorkflow",  
+                .Version = New Version(1, 5, 0, 0)  
+            }  
+  
+            FlowchartNumberGuessIdentity_v15 = New WorkflowIdentity With  
+            {  
+                .Name = "FlowchartNumberGuessWorkflow",  
+                .Version = New Version(1, 5, 0, 0)  
+            }  
+  
+            SequentialNumberGuessIdentity_v15 = New WorkflowIdentity With  
+            {  
+                .Name = "SequentialNumberGuessWorkflow",  
+                .Version = New Version(1, 5, 0, 0)  
+            }  
+  
+            'Add the dynamic update workflow identities to the dictionary along with  
+            'the corresponding workflow definitions loaded from the v15 assembly.  
+            'Assembly.LoadFile requires an absolute path so convert this relative path  
+            'to an absolute path.  
+            Dim v15AssemblyPath As String = "..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v15.dll"  
+            v15AssemblyPath = Path.GetFullPath(v15AssemblyPath)  
+            Dim v15Assembly As Assembly = Assembly.LoadFile(v15AssemblyPath)  
+  
+            map.Add(StateMachineNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow"))  
+  
+            map.Add(SequentialNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow"))  
+  
+            map.Add(FlowchartNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow"))  
+        End Sub  
+  
+        Public Function GetWorkflowDefinition(identity As WorkflowIdentity) As Activity  
+            Return map(identity)  
+        End Function  
+  
+        Public Function GetIdentityDescription(identity As WorkflowIdentity) As String  
+            Return identity.ToString()  
+        End Function  
+    End Module  
+    ```  
+  
+    ```csharp  
+    public static class WorkflowVersionMap  
+    {  
+        static Dictionary<WorkflowIdentity, Activity> map;  
+  
+        // Current version identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity;  
+  
+        // v1 identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity_v1;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity_v1;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity_v1;  
+  
+        // v1.5 (Dynamic Update) identities.  
+        static public WorkflowIdentity StateMachineNumberGuessIdentity_v15;  
+        static public WorkflowIdentity FlowchartNumberGuessIdentity_v15;  
+        static public WorkflowIdentity SequentialNumberGuessIdentity_v15;  
+  
+        static WorkflowVersionMap()  
+        {  
+            map = new Dictionary<WorkflowIdentity, Activity>();  
+  
+            // Add the current workflow version identities.  
+            StateMachineNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                // Version = new Version(1, 0, 0, 0),  
+                Version = new Version(2, 0, 0, 0)  
+            };  
+  
+            map.Add(StateMachineNumberGuessIdentity, new StateMachineNumberGuessWorkflow());  
+            map.Add(FlowchartNumberGuessIdentity, new FlowchartNumberGuessWorkflow());  
+            map.Add(SequentialNumberGuessIdentity, new SequentialNumberGuessWorkflow());  
+  
+            // Initialize the previous workflow version identities.  
+            StateMachineNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity_v1 = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                Version = new Version(1, 0, 0, 0)  
+            };  
+  
+            // Add the previous version workflow identities to the dictionary along with  
+            // the corresponding workflow definitions loaded from the v1 assembly.  
+            // Assembly.LoadFile requires an absolute path so convert this relative path  
+            // to an absolute path.  
+            string v1AssemblyPath = @"..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v1.dll";  
+            v1AssemblyPath = Path.GetFullPath(v1AssemblyPath);  
+            Assembly v1Assembly = Assembly.LoadFile(v1AssemblyPath);  
+  
+            map.Add(StateMachineNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow") as Activity);  
+  
+            map.Add(SequentialNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow") as Activity);  
+  
+            map.Add(FlowchartNumberGuessIdentity_v1,  
+                v1Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow") as Activity);  
+  
+            // Initialize the dynamic update workflow identities.  
+            StateMachineNumberGuessIdentity_v15 = new WorkflowIdentity  
+            {  
+                Name = "StateMachineNumberGuessWorkflow",  
+                Version = new Version(1, 5, 0, 0)  
+            };  
+  
+            FlowchartNumberGuessIdentity_v15 = new WorkflowIdentity  
+            {  
+                Name = "FlowchartNumberGuessWorkflow",  
+                Version = new Version(1, 5, 0, 0)  
+            };  
+  
+            SequentialNumberGuessIdentity_v15 = new WorkflowIdentity  
+            {  
+                Name = "SequentialNumberGuessWorkflow",  
+                Version = new Version(1, 5, 0, 0)  
+            };  
+  
+            // Add the dynamic update workflow identities to the dictionary along with  
+            // the corresponding workflow definitions loaded from the v15 assembly.  
+            // Assembly.LoadFile requires an absolute path so convert this relative path  
+            // to an absolute path.  
+            string v15AssemblyPath = @"..\..\..\PreviousVersions\NumberGuessWorkflowActivities_v15.dll";  
+            v15AssemblyPath = Path.GetFullPath(v15AssemblyPath);  
+            Assembly v15Assembly = Assembly.LoadFile(v15AssemblyPath);  
+  
+            map.Add(StateMachineNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.StateMachineNumberGuessWorkflow") as Activity);  
+  
+            map.Add(SequentialNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.SequentialNumberGuessWorkflow") as Activity);  
+  
+            map.Add(FlowchartNumberGuessIdentity_v15,  
+                v15Assembly.CreateInstance("NumberGuessWorkflowActivities.FlowchartNumberGuessWorkflow") as Activity);  
+        }  
+  
+        public static Activity GetWorkflowDefinition(WorkflowIdentity identity)  
+        {  
+            return map[identity];  
+        }  
+  
+        public static string GetIdentityDescription(WorkflowIdentity identity)  
+        {  
+            return identity.ToString();  
+        }  
+    }  
+    ```  
+  
+5.  **Ctrl** キーと **Shift** キーを押しながら **B** キーを押して、プロジェクトをビルドします。  
+  
+###  <a name="BKMK_ApplyUpdate"></a> 動的更新を適用するには  
+  
+1.  **ソリューション エクスプローラー**で **WF45GettingStartedTutorial** を右クリックし、**\[追加\]** をポイントして、**\[新しいプロジェクト\]** をクリックします。  
+  
+2.  **\[インストール済み\]** ノードで **\[Visual C\#\]**、**\[Windows\]** \(または **\[Visual Basic\]**、**\[Windows\]**\) の順に選択します。  
+  
+    > [!NOTE]
+    >  Visual Studio で第一言語として設定されているプログラミング言語に応じて、**\[インストール済み\]** ノードの **\[他の言語\]** ノードの下に、**\[Visual C\#\]** ノードまたは **\[Visual Basic\]** ノードが表示されます。  
+  
+     .NET Framework バージョンのドロップダウン リストで **\[.NET Framework 4.5\]** が選択されていることを確認します。**\[Windows\]**  ボックスから **\[コンソール アプリケーション\]** を選択します。**\[名前\]** ボックスに「**ApplyDynamicUpdate**」と入力し、**\[OK\]** をクリックします。  
+  
+3.  **ソリューション エクスプローラー**で **ApplyDynamicUpdate** を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+4.  **\[ソリューション\]** をクリックし、**NumberGuessWorkflowHost** の横にあるチェック ボックスをオンにします。この参照は、`ApplyDynamicUpdate` で `NumberGuessWorkflowHost.WorkflowVersionMap` クラスを使用できるようにするために必要です。  
+  
+5.  **\[参照の追加\]** の一覧で、**\[アセンブリ\]** ノードから **\[フレームワーク\]** を選択します。**\[アセンブリの検索\]** ボックスに「**System.Activities**」と入力します。これにより、アセンブリがフィルター処理され、目的の参照が選択しやすくなります。  
+  
+6.  **\[検索結果\]** の一覧で **System.Activities** の横にあるチェック ボックスをオンにします。  
+  
+7.  **\[アセンブリの検索\]** ボックスに「**Serialization**」と入力し、**\[検索結果\]** の一覧で **System.Runtime.Serialization** の横にあるチェック ボックスをオンにします。  
+  
+8.  **\[アセンブリの検索\]** ボックスに「**DurableInstancing**」と入力し、**\[検索結果\]** の一覧で **System.Activities.DurableInstancing** および **System.Runtime.DurableInstancing** の横にあるチェック ボックスをオンにします。  
+  
+9. **\[OK\]** をクリックして**参照マネージャー**を閉じ、参照を追加します。  
+  
+10. ソリューション エクスプローラーで **ApplyDynamicUpdate** を右クリックし、**\[追加\]**、**\[クラス\]** の順にクリックします。**\[名前\]** ボックスに「`DynamicUpdateInfo`」と入力し、**\[追加\]** をクリックします。  
+  
+11. `DynamicUpdateInfo` クラスに次の 2 つのメンバーを追加します。完成した `DynamicUpdateInfo` クラスは次のようになります。このクラスには、ワークフロー インスタンスの更新時に使用された更新マップと新しいワークフロー ID に関する情報が格納されています。  
+  
+    ```vb  
+    Public Class DynamicUpdateInfo  
+        Public updateMap As DynamicUpdateMap  
+        Public newIdentity As WorkflowIdentity  
+    End Class  
+    ```  
+  
+    ```csharp  
+    class DynamicUpdateInfo  
+    {  
+        public DynamicUpdateMap updateMap;  
+        public WorkflowIdentity newIdentity;  
+    }  
+    ```  
+  
+12. 次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports System.Activities  
+    Imports System.Activities.DynamicUpdate  
+    ```  
+  
+    ```csharp  
+    using System.Activities;  
+    using System.Activities.DynamicUpdate;  
+    ```  
+  
+13. ソリューション エクスプローラーで **Program.cs** \(または **Module1.vb**\) をダブルクリックします。  
+  
+14. 次の `using` \(または `Imports`\) ステートメントを、他の `using` \(または `Imports`\) ステートメントを含むファイルの先頭に追加します。  
+  
+    ```vb  
+    Imports NumberGuessWorkflowHost  
+    Imports System.Data.SqlClient  
+    Imports System.Activities.DynamicUpdate  
+    Imports System.IO  
+    Imports System.Runtime.Serialization  
+    Imports System.Activities  
+    Imports System.Activities.DurableInstancing  
+    ```  
+  
+    ```csharp  
+    using NumberGuessWorkflowHost;  
+    using System.Data;  
+    using System.Data.SqlClient;  
+    using System.Activities;  
+    using System.Activities.DynamicUpdate;  
+    using System.IO;  
+    using System.Runtime.Serialization;  
+    using System.Activities.DurableInstancing;  
+    ```  
+  
+15. `Program` クラス \(または `Module1`\) に次の接続文字列メンバーを追加します。  
+  
+    ```vb  
+    Const connectionString = "Server=.\SQLEXPRESS;Initial Catalog=WF45GettingStartedTutorial;Integrated Security=SSPI"  
+    ```  
+  
+    ```csharp  
+    const string connectionString = "Server=.\\SQLEXPRESS;Initial Catalog=WF45GettingStartedTutorial;Integrated Security=SSPI";  
+    ```  
+  
+    > [!NOTE]
+    >  使用している SQL Server のエディションによって、接続文字列のサーバー名は異なる可能性があります。  
+  
+16. `Program` クラス \(または `Module1`\) に次の `GetIDs` メソッドを追加します。このメソッドは、永続化されたワークフロー インスタンス ID の一覧を返します。  
+  
+    ```vb  
+    Function GetIds() As IList(Of Guid)  
+        Dim Ids As New List(Of Guid)  
+        Dim localCmd = _  
+            String.Format("Select [InstanceId] from [System.Activities.DurableInstancing].[Instances] Order By [CreationTime]")  
+        Using localCon = New SqlConnection(connectionString)  
+            Dim cmd As SqlCommand = localCon.CreateCommand()  
+            cmd.CommandText = localCmd  
+            localCon.Open()  
+            Using reader = cmd.ExecuteReader(CommandBehavior.CloseConnection)  
+                While reader.Read()  
+                    'Get the InstanceId of the persisted Workflow  
+                    Dim id As Guid = Guid.Parse(reader(0).ToString())  
+  
+                    'Add it to the list.  
+                    Ids.Add(id)  
+                End While  
+            End Using  
+        End Using  
+  
+        Return Ids  
+    End Function  
+    ```  
+  
+    ```csharp  
+    static IList<Guid> GetIds()  
+    {  
+        List<Guid> Ids = new List<Guid>();  
+        string localCmd = string.Format("Select [InstanceId] from [System.Activities.DurableInstancing].[Instances] Order By [CreationTime]");  
+        using (SqlConnection localCon = new SqlConnection(connectionString))  
+        {  
+            SqlCommand cmd = localCon.CreateCommand();  
+            cmd.CommandText = localCmd;  
+            localCon.Open();  
+            using (SqlDataReader reader = cmd.ExecuteReader(CommandBehavior.CloseConnection))  
+            {  
+                while (reader.Read())  
+                {  
+                    // Get the InstanceId of the persisted Workflow  
+                    Guid id = Guid.Parse(reader[0].ToString());  
+  
+                    // Add it to the list.  
+                    Ids.Add(id);  
+                }  
+            }  
+        }  
+  
+        return Ids;  
+    }  
+    ```  
+  
+17. `Program` クラス \(または `Module1`\) に次の `LoadMap` メソッドを追加します。このメソッドは、更新マップに `v1` ワークフロー ID をマップするディクショナリと、対応する永続化されたワークフロー インスタンスの更新に使用される新しいワークフロー ID を作成します。  
+  
+    ```vb  
+    Function LoadMap(mapName As String) As DynamicUpdateMap  
+        Dim mapPath As String = Path.Combine("..\..\..\PreviousVersions", mapName)  
+  
+        Dim map As DynamicUpdateMap  
+        Using fs As FileStream = File.Open(mapPath, FileMode.Open)  
+            Dim serializer As DataContractSerializer = New DataContractSerializer(GetType(DynamicUpdateMap))  
+            Dim updateMap = serializer.ReadObject(fs)  
+            If updateMap Is Nothing Then  
+                Throw New ApplicationException("DynamicUpdateMap is null.")  
+            End If  
+  
+            map = updateMap  
+        End Using  
+  
+        Return map  
+    End Function  
+    ```  
+  
+    ```csharp  
+    static DynamicUpdateMap LoadMap(string mapName)  
+    {  
+        string path = Path.Combine(@"..\..\..\PreviousVersions", mapName);  
+  
+        DynamicUpdateMap map;  
+        using (FileStream fs = File.Open(path, FileMode.Open))  
+        {  
+            DataContractSerializer serializer = new DataContractSerializer(typeof(DynamicUpdateMap));  
+            object updateMap = serializer.ReadObject(fs);  
+            if (updateMap == null)  
+            {  
+                throw new ApplicationException("DynamicUpdateMap is null.");  
+            }  
+  
+            map = updateMap as DynamicUpdateMap;  
+        }  
+  
+        return map;  
+    }  
+    ```  
+  
+18. `Program` クラス \(または `Module1`\) に次の `LoadMaps` メソッドを追加します。このメソッドは、3 つの更新マップを読み込み、更新マップに `v1` ワークフロー ID をマップするディクショナリを作成します。  
+  
+    ```vb  
+    Function LoadMaps() As IDictionary(Of WorkflowIdentity, DynamicUpdateInfo)  
+        'There are 3 update maps to describe the changes to update v1 workflows,  
+        'one for reach of the 3 workflow types in the tutorial.  
+        Dim maps = New Dictionary(Of WorkflowIdentity, DynamicUpdateInfo)()  
+  
+        Dim sequentialMap As DynamicUpdateMap = LoadMap("SequentialNumberGuessWorkflow.map")  
+        Dim sequentialInfo = New DynamicUpdateInfo With  
+        {  
+            .updateMap = sequentialMap,  
+            .newIdentity = WorkflowVersionMap.SequentialNumberGuessIdentity_v15  
+        }  
+        maps.Add(WorkflowVersionMap.SequentialNumberGuessIdentity_v1, sequentialInfo)  
+  
+        Dim stateMap As DynamicUpdateMap = LoadMap("StateMachineNumberGuessWorkflow.map")  
+        Dim stateInfo = New DynamicUpdateInfo With  
+        {  
+            .updateMap = stateMap,  
+            .newIdentity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v15  
+        }  
+        maps.Add(WorkflowVersionMap.StateMachineNumberGuessIdentity_v1, stateInfo)  
+  
+        Dim flowchartMap As DynamicUpdateMap = LoadMap("FlowchartNumberGuessWorkflow.map")  
+        Dim flowchartInfo = New DynamicUpdateInfo With  
+        {  
+            .updateMap = flowchartMap,  
+            .newIdentity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v15  
+        }  
+        maps.Add(WorkflowVersionMap.FlowchartNumberGuessIdentity_v1, flowchartInfo)  
+  
+        Return maps  
+    End Function  
+    ```  
+  
+    ```csharp  
+    static IDictionary<WorkflowIdentity, DynamicUpdateInfo> LoadMaps()  
+    {  
+        // There are 3 update maps to describe the changes to update v1 workflows,  
+        // one for reach of the 3 workflow types in the tutorial.  
+        Dictionary<WorkflowIdentity, DynamicUpdateInfo> maps =  
+            new Dictionary<WorkflowIdentity, DynamicUpdateInfo>();  
+  
+        DynamicUpdateMap sequentialMap = LoadMap("SequentialNumberGuessWorkflow.map");  
+        DynamicUpdateInfo sequentialInfo = new DynamicUpdateInfo  
+        {  
+            updateMap = sequentialMap,  
+            newIdentity = WorkflowVersionMap.SequentialNumberGuessIdentity_v15  
+        };  
+        maps.Add(WorkflowVersionMap.SequentialNumberGuessIdentity_v1, sequentialInfo);  
+  
+        DynamicUpdateMap stateMap = LoadMap("StateMachineNumberGuessWorkflow.map");  
+        DynamicUpdateInfo stateInfo = new DynamicUpdateInfo  
+        {  
+            updateMap = stateMap,  
+            newIdentity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v15  
+        };  
+        maps.Add(WorkflowVersionMap.StateMachineNumberGuessIdentity_v1, stateInfo);  
+  
+        DynamicUpdateMap flowchartMap = LoadMap("FlowchartNumberGuessWorkflow.map");  
+        DynamicUpdateInfo flowchartInfo = new DynamicUpdateInfo  
+        {  
+            updateMap = flowchartMap,  
+            newIdentity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v15  
+        };  
+        maps.Add(WorkflowVersionMap.FlowchartNumberGuessIdentity_v1, flowchartInfo);  
+  
+        return maps;              
+    }  
+    ```  
+  
+19. `Main` に次のコードを追加します。このコードでは、永続化されたワークフロー インスタンスを反復処理し、それぞれの `WorkflowIdentity` を調べます。`WorkflowIdentity` が `v1` ワークフロー インスタンスにマップされると、`WorkflowApplication` は、更新されたワークフロー定義と更新されたワークフロー ID を使用して構成されます。次に、`WorkflowApplication.Load` がそのインスタンスと更新マップを使用して呼び出され、動的更新マップが適用されます。更新が適用されると、更新されたインスタンスは `Unload` の呼び出しによって永続化されます。  
+  
+    ```vb  
+    Dim store = New SqlWorkflowInstanceStore(connectionString)  
+    WorkflowApplication.CreateDefaultInstanceOwner(store, Nothing, WorkflowIdentityFilter.Any)  
+  
+    Dim updateMaps As IDictionary(Of WorkflowIdentity, DynamicUpdateInfo) = LoadMaps()  
+  
+    For Each id As Guid In GetIds()  
+        'Get a proxy to the instance.   
+        Dim instance As WorkflowApplicationInstance = WorkflowApplication.GetInstance(id, store)  
+  
+        Console.WriteLine("Inspecting: {0}", instance.DefinitionIdentity)  
+  
+        'Only update v1 workflows.  
+        If Not instance.DefinitionIdentity Is Nothing AndAlso _  
+            instance.DefinitionIdentity.Version.Equals(New Version(1, 0, 0, 0)) Then  
+  
+            Dim info As DynamicUpdateInfo = updateMaps(instance.DefinitionIdentity)  
+  
+            'Associate the persisted WorkflowApplicationInstance with  
+            'a WorkflowApplication that is configured with the updated  
+            'definition and updated WorkflowIdentity.  
+            Dim wf As Activity = WorkflowVersionMap.GetWorkflowDefinition(info.newIdentity)  
+            Dim wfApp = New WorkflowApplication(wf, info.newIdentity)  
+  
+            'Apply the Dynamic Update.               
+            wfApp.Load(instance, info.updateMap)  
+  
+            'Persist the updated instance.  
+            wfApp.Unload()  
+  
+            Console.WriteLine("Updated to: {0}", info.newIdentity)  
+        Else  
+            'Not updating this instance, so unload it.  
+            instance.Abandon()  
+        End If  
+    Next  
+  
+    ```  
+  
+    ```csharp  
+    SqlWorkflowInstanceStore store = new SqlWorkflowInstanceStore(connectionString);  
+    WorkflowApplication.CreateDefaultInstanceOwner(store, null, WorkflowIdentityFilter.Any);  
+  
+    IDictionary<WorkflowIdentity, DynamicUpdateInfo> updateMaps = LoadMaps();  
+  
+    foreach (Guid id in GetIds())  
+    {  
+        // Get a proxy to the instance.   
+        WorkflowApplicationInstance instance =  
+            WorkflowApplication.GetInstance(id, store);  
+  
+        Console.WriteLine("Inspecting: {0}", instance.DefinitionIdentity);  
+  
+        // Only update v1 workflows.  
+        if (instance.DefinitionIdentity != null &&  
+            instance.DefinitionIdentity.Version.Equals(new Version(1, 0, 0, 0)))  
+        {  
+            DynamicUpdateInfo info = updateMaps[instance.DefinitionIdentity];  
+  
+            // Associate the persisted WorkflowApplicationInstance with  
+            // a WorkflowApplication that is configured with the updated  
+            // definition and updated WorkflowIdentity.  
+            Activity wf = WorkflowVersionMap.GetWorkflowDefinition(info.newIdentity);  
+            WorkflowApplication wfApp =  
+                new WorkflowApplication(wf, info.newIdentity);  
+  
+            // Apply the Dynamic Update.               
+            wfApp.Load(instance, info.updateMap);  
+  
+            // Persist the updated instance.  
+            wfApp.Unload();  
+  
+            Console.WriteLine("Updated to: {0}", info.newIdentity);  
+        }  
+        else  
+        {  
+            // Not updating this instance, so unload it.  
+            instance.Abandon();  
+        }  
+    }  
+    ```  
+  
+20. **ソリューション エクスプローラー**で **ApplyDynamicUpdate** を右クリックして **\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+21. Ctrl キーと Shift キーを押しながら B キーを押してソリューションをビルドし、Ctrl キーを押しながら F5 キーを押して `ApplyDynamicUpdate` アプリケーションを実行して、永続化されたワークフロー インスタンスを更新します。表示される出力は、次のようになります。バージョン 1.0.0.0 のワークフローはバージョン 1.5.0.0 に更新されますが、バージョン 2.0.0.0 のワークフローは更新されません。  
+  
+ **Inspecting: StateMachineNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: StateMachineNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: StateMachineNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: StateMachineNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: FlowchartNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: FlowchartNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: FlowchartNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: FlowchartNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: SequentialNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: SequentialNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: SequentialNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: SequentialNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: SequentialNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: SequentialNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: StateMachineNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: StateMachineNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: FlowchartNumberGuessWorkflow; Version\=1.0.0.0**   
+**Updated to: FlowchartNumberGuessWorkflow; Version\=1.5.0.0**   
+**Inspecting: StateMachineNumberGuessWorkflow; Version\=2.0.0.0**   
+**Inspecting: StateMachineNumberGuessWorkflow; Version\=2.0.0.0**   
+**Inspecting: FlowchartNumberGuessWorkflow; Version\=2.0.0.0**   
+**Inspecting: FlowchartNumberGuessWorkflow; Version\=2.0.0.0**   
+**Inspecting: SequentialNumberGuessWorkflow; Version\=2.0.0.0**   
+**Inspecting: SequentialNumberGuessWorkflow; Version\=2.0.0.0**   
+**続行するには、いずれかのキーを押します...**  
+  
+###  <a name="BKMK_BuildAndRun"></a> 更新されたワークフローを含むアプリケーションを実行するには  
+  
+1.  **ソリューション エクスプローラー**で **NumberGuessWorkflowHost** を右クリックして **\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+2.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+3.  **\[New Game\]** をクリックして新しいワークフローを開始し、ステータス ウィンドウの下にあるバージョン情報でワークフローが `v2` ワークフローであると示されていることを確認します。  
+  
+4.  「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」の最初に開始した `v1` ワークフローの 1 つを選択します。ステータス ウィンドウの下にあるバージョン情報で、ワークフローがバージョン **1.5.0.0** ワークフローであると示されていることを確認します。前の推定値については、その値が大きすぎるか小さすぎるかという点以外の情報はありません。  
+  
+ **Please enter a number between 1 and 10**   
+**Your guess is too low.**  
+  
+5.  `InstanceId` を書き留めておき、ワークフローが完了するまで推定値を入力します。ステータス ウィンドウには、`WriteLine` アクティビティが動的更新によって更新されたため、推測の内容に関する情報が表示されます。  
+  
+ **Please enter a number between 1 and 10**   
+**Your guess is too low.**   
+**Please enter a number between 1 and 10**   
+**5 is too low.**   
+**Please enter a number between 1 and 10**   
+**7 is too high.**   
+**Please enter a number between 1 and 10**   
+**Congratulations, you guessed the number in 4 turns.**  
+  
+6.  エクスプローラーを開き、**NumberGuessWorkflowHost\\bin\\debug** フォルダー \(プロジェクトの設定によっては **bin\\release**\) に移動して、完了したワークフローに対応する追跡ファイルをメモ帳を使用して開きます。`InstanceId` を書き留めなかった場合は、エクスプローラーの **\[更新日時\]** の情報を使用して正しい追跡ファイルを特定できる可能性があります。追跡情報の最後の行には、新しく追加した `WriteLine` アクティビティの出力が含まれます。  
+  
+ **Please enter a number between 1 and 10**   
+**Your guess is too low.**   
+**Please enter a number between 1 and 10**   
+**5 is too low.**   
+**Please enter a number between 1 and 10**   
+**7 is too high.**   
+**Please enter a number between 1 and 10**   
+**6 is correct.You guessed it in 4 turns.**  
+  
+###  <a name="BKMK_StartPreviousVersions"></a> ワークフローの以前のバージョンを開始できるようにするには  
+ 更新するワークフローがなくなったら、ワークフローの以前のバージョンを開始できるように `NumberGuessWorkflowHost` アプリケーションを変更できます。  
+  
+1.  **ソリューション エクスプローラー**で **WorkflowHostForm** をダブルクリックし、**WorkflowType** コンボ ボックスを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、**Items** プロパティを選択し、省略記号ボタンをクリックして **Items** コレクションを編集します。  
+  
+3.  コレクションに次の 3 つの項目を追加します。  
+  
+    ```vb-c#  
+    StateMachineNumberGuessWorkflow v1  
+    FlowchartNumberGuessWorkflow v1  
+    SequentialNumberGuessWorkflow v1  
+    ```  
+  
+     完成した `Items` コレクションには 6 個の項目があります。  
+  
+    ```vb-c#  
+    StateMachineNumberGuessWorkflow  
+    FlowchartNumberGuessWorkflow  
+    SequentialNumberGuessWorkflow  
+    StateMachineNumberGuessWorkflow v1  
+    FlowchartNumberGuessWorkflow v1  
+    SequentialNumberGuessWorkflow v1  
+    ```  
+  
+4.  **ソリューション エクスプローラー**で **WorkflowHostForm** をダブルクリックし、**\[コードの表示\]** をクリックします。  
+  
+5.  `NewGame_Click` ハンドラーの `switch` \(または `Select Case`\) ステートメントに 3 つの新しい case を追加し、**WorkflowType** コンボ ボックスの新しい項目を一致するワークフロー ID にマップします。  
+  
+    ```vb  
+    Case "SequentialNumberGuessWorkflow v1"  
+        identity = WorkflowVersionMap.SequentialNumberGuessIdentity_v1  
+  
+    Case "StateMachineNumberGuessWorkflow v1"  
+        identity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v1  
+  
+    Case "FlowchartNumberGuessWorkflow v1"  
+        identity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v1  
+    ```  
+  
+    ```csharp  
+    case "SequentialNumberGuessWorkflow v1":  
+        identity = WorkflowVersionMap.SequentialNumberGuessIdentity_v1;  
+        break;  
+  
+    case "StateMachineNumberGuessWorkflow v1":  
+        identity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v1;  
+        break;  
+  
+    case "FlowchartNumberGuessWorkflow v1":  
+        identity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v1;  
+        break;  
+    ```  
+  
+     完成した `switch` \(または `Select Case`\) ステートメントを次の例に示します。  
+  
+    ```vb  
+    Select Case WorkflowType.SelectedItem.ToString()  
+        Case "SequentialNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity  
+  
+        Case "StateMachineNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity  
+  
+        Case "FlowchartNumberGuessWorkflow"  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity  
+  
+        Case "SequentialNumberGuessWorkflow v1"  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity_v1  
+  
+        Case "StateMachineNumberGuessWorkflow v1"  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v1  
+  
+        Case "FlowchartNumberGuessWorkflow v1"  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v1  
+    End Select  
+    ```  
+  
+    ```csharp  
+    switch (WorkflowType.SelectedItem.ToString())  
+    {  
+        case "SequentialNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity;  
+            break;  
+  
+        case "StateMachineNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity;  
+            break;  
+  
+        case "FlowchartNumberGuessWorkflow":  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity;  
+            break;  
+  
+        case "SequentialNumberGuessWorkflow v1":  
+            identity = WorkflowVersionMap.SequentialNumberGuessIdentity_v1;  
+            break;  
+  
+        case "StateMachineNumberGuessWorkflow v1":  
+            identity = WorkflowVersionMap.StateMachineNumberGuessIdentity_v1;  
+            break;  
+  
+        case "FlowchartNumberGuessWorkflow v1":  
+            identity = WorkflowVersionMap.FlowchartNumberGuessIdentity_v1;  
+            break;  
+    };  
+    ```  
+  
+6.  Ctrl キーを押しながら F5 キーを押してアプリケーションをビルドし、実行します。これで、ワークフローの現在のバージョンに加え、`v1` バージョンを開始できるようになりました。これらの新しいインスタンスを動的に更新するには、**ApplyDynamicUpdate** アプリケーションを実行します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/imperative-code-based-validation.md b/docs/framework/windows-workflow-foundation/imperative-code-based-validation.md
new file mode 100644
index 00000000000..63e915b7aca
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/imperative-code-based-validation.md
@@ -0,0 +1,62 @@
+---
+title: "命令型コードに基づく検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ae12537c-455e-42b1-82f4-cea4c46c023e
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 命令型コードに基づく検証
+命令型コードに基づく検証は、アクティビティでアクティビティ自身の検証を可能にする簡単な方法を提供し、<xref:System.Activities.CodeActivity>、<xref:System.Activities.AsyncCodeActivity>、および <xref:System.Activities.NativeActivity> から派生するアクティビティで使用できます。検証のエラーまたは警告を判定する検証コードがアクティビティに追加されます。  
+  
+## コードに基づく検証の使用  
+ コードに基づく検証は、<xref:System.Activities.CodeActivity>、<xref:System.Activities.AsyncCodeActivity>、および <xref:System.Activities.NativeActivity> から派生するアクティビティでサポートされています。検証コードは <xref:System.Activities.CodeActivity.CacheMetadata%2A> オーバーライドに配置できます。また、検証のエラーまたは警告はメタデータ引数に追加できます。次の例は、[基本検証](../../../docs/framework/windows-workflow-foundation/samples/basic-validation.md) サンプルからのものであり、`Cost` が `Price`よりも高い場合、検証エラーがメタデータに追加されます。  
+  
+> [!NOTE]
+>  `Cost` と `Price` はこのアクティビティの引数ではありませんが、デザイン時に設定されるプロパティです。その理由は、これらの値は <xref:System.Activities.CodeActivity.CacheMetadata%2A> オーバーライドで検証できるからです。引数に流入するデータの値は、データが実行時まで流れないのでデザイン時には検証できません。しかし、`RequiredArgument` 属性とオーバーロード グループを使用してアクティビティの引数を検証すると、それらの引数にバインドされていることが確認できます。このコード例では、`Description` 引数の `RequiredArgument` 属性を確認します。これがバインドされていなければ、検証エラーが生成されます。必要な引数については、[必須の引数とオーバーロード グループ](../../../docs/framework/windows-workflow-foundation//required-arguments-and-overload-groups.md) で説明します。  
+  
+```csharp  
+public sealed class CreateProduct : CodeActivity  
+{  
+    public double Price { get; set; }  
+    public double Cost { get; set; }  
+  
+    // [RequiredArgument] attribute will generate a validation error   
+    // if the Description argument is not set.  
+    [RequiredArgument]  
+    public InArgument<string> Description { get; set; }  
+  
+    protected override void CacheMetadata(CodeActivityMetadata metadata)  
+    {  
+        base.CacheMetadata(metadata);  
+        // Determine when the activity has been configured in an invalid way.  
+        if (this.Cost > this.Price)  
+        {  
+            // Add a validation error with a custom message.  
+            metadata.AddValidationError("The Cost must be less than or equal to the Price.");  
+        }  
+    }  
+  
+    protected override void Execute(CodeActivityContext context)  
+    {  
+        // Not needed for the sample.  
+    }  
+}  
+  
+```  
+  
+ 既定では、検証エラーがメタデータに追加されるのは、<xref:System.Activities.CodeActivityMetadata.AddValidationError%2A> が呼び出されたときです。検証の警告を追加するには、<xref:System.Activities.Validation.ValidationError> を受け取る <xref:System.Activities.CodeActivityMetadata.AddValidationError%2A> オーバーロードを使用し、<xref:System.Activities.Validation.ValidationError.IsWarning%2A> プロパティを設定することで <xref:System.Activities.Validation.ValidationError> が警告を表すことを示します。  
+  
+ 検証が発生するのは、ワークフローがワークフロー デザイナーで修正され、検証エラーまたは警告がワークフロー デザイナーに表示されたときです。ワーク フローの呼び出し時に検証も行われます。検証エラーが発生すると、既定の検証ロジックによって <xref:System.Activities.InvalidWorkflowException> がスローされます。[!INCLUDE[crabout](../../../includes/crabout-md.md)] 検証の呼び出しと検証の警告やエラーへのアクセスについては、「[アクティビティ検証の呼び出し](../../../docs/framework/windows-workflow-foundation//invoking-activity-validation.md)」を参照してください。  
+  
+ <xref:System.Activities.CodeActivity.CacheMetadata%2A> からスローされる例外は、検証エラーとして処理されません。これらの例外は、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> への呼び出しからエスケープされ、呼び出し元によって処理される必要があります。  
+  
+ コードに基づく検証は、コードを含み、ワークフロー内の他のアクティビティから表示できないアクティビティを検証するときに役立ちます。宣言の制約の検証には、ワークフロー内のアクティビティと他のアクティビティとの関係を検証するアクティビティが用意されています。これについては、「[宣言の制約](../../../docs/framework/windows-workflow-foundation//declarative-constraints.md)」トピックを参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/index.md b/docs/framework/windows-workflow-foundation/index.md
new file mode 100644
index 00000000000..a7d9046276b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/index.md
@@ -0,0 +1,52 @@
+---
+title: "Windows Workflow Foundation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF]"
+  - "Windows Workflow Foundation [WF]"
+ms.assetid: 9a23ea6b-d600-483e-89cd-8889cfec5f66
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# Windows Workflow Foundation
+ここでは、[!INCLUDE[wf](../../../includes/wf-md.md)] のプログラミング モデル、サンプル、およびツールについて説明します。  
+  
+## このセクションの内容  
+ [Windows Workflow ドキュメントのガイド](../../../docs/framework/windows-workflow-foundation//guide-to-the-documentation.md)  
+ 推奨されるトピックの一覧です。理解度 \(初心者から熟練者まで\) や必要性に応じて、適切なトピックを参照できます。  
+  
+ [Windows Workflow Foundation の新機能](../../../docs/framework/windows-workflow-foundation//whats-new.md)  
+ 以前のバージョンからの開発パラダイムの変更点について説明します。  
+  
+ [.NET 4.5 での Windows Workflow Foundation の新機能](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md)  
+ [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] の Windows Workflow Foundation の新機能について説明します。  
+  
+ [Windows Workflow Foundation の機能仕様](../../../docs/framework/windows-workflow-foundation//feature-specifics.md)  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] の Windows Workflow Foundation の新機能について説明します。  
+  
+ [Windows Workflow の概念](../../../docs/framework/windows-workflow-foundation//conceptual-overview.md)  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] の背景となる、より大きな概念について説明する一連のトピックです。  
+  
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] アプリケーションのプログラミングの概要を説明する一連のチュートリアル トピックです。  
+  
+ [Windows Workflow Foundation プログラミングの新機能](../../../docs/framework/windows-workflow-foundation//programming.md)  
+ [!INCLUDE[wf1](../../../includes/wf1-md.md)] の熟練したプログラマになるために理解する必要のある一連の入門トピックです。  
+  
+ [Windows Workflow Foundation の拡張](../../../docs/framework/windows-workflow-foundation//extend.md)  
+ 要件に併せて [!INCLUDE[wf2](../../../includes/wf2-md.md)] を拡張またはカスタマイズする方法について説明する一連のトピックです。  
+  
+ [.NET Framework 4.5 の Windows Workflow Foundation 用語集](../../../docs/framework/windows-workflow-foundation//glossary.md)  
+ WF に固有の用語の一覧を定義します。  
+  
+ [Windows Workflow のサンプル](../../../docs/framework/windows-workflow-foundation/samples/index.md)  
+ WF 機能およびシナリオを示すサンプル アプリケーションが含まれています。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/instance-activation.md b/docs/framework/windows-workflow-foundation/instance-activation.md
new file mode 100644
index 00000000000..92c344e89a0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/instance-activation.md
@@ -0,0 +1,48 @@
+---
+title: "インスタンスのアクティブ化処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 134c3f70-5d4e-46d0-9d49-469a6643edd8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# インスタンスのアクティブ化処理
+SQL Workflow Instance Store が実行する内部タスクは、定期的にアクティブになり、実行可能またはアクティブ化可能なワークフロー インスタンスを永続性データベースで検出します。このタスクは、実行可能なワークフロー インスタンスを検出すると、このインスタンスをアクティブ化することができるワークフロー ホストに通知します。Instance Store がアクティブ化可能なワークフロー インスタンスを検出した場合、ワークフロー ホストをアクティブ化する汎用ホストに Instance Store が通知を行い、ワークフロー ホストがワークフロー インスタンスを実行します。このトピックの以降のセクションでは、インスタンスのアクティブ化処理を詳細に説明します。  
+  
+##  <a name="RunnableSection"></a> 実行可能なワークフロー インスタンスの検出とアクティブ化  
+ SQL Workflow Instance Store がワークフロー インスタンスを*実行可能*と見なすのは、インスタンスが非中断状態または完了状態であり、次の条件を満たす場合です。  
+  
+-   インスタンスがロック解除されていて、保留タイマーの期限が切れている。  
+  
+-   インスタンスに期限切れのロックがある。  
+  
+-   インスタンスがロック解除されていて、ステータスが **Executing** である。  
+  
+ SQL Workflow Instance Store は、実行可能なインスタンスを見つけると <xref:System.Activities.DurableInstancing.HasRunnableWorkflowEvent> を生成します。その後、SqlWorkflowInstanceStore は <xref:System.Activities.DurableInstancing.TryLoadRunnableWorkflowCommand> がストアで一度呼び出されるまで監視を停止します。  
+  
+ <xref:System.Activities.DurableInstancing.HasRunnableWorkflowEvent> に定期受信し、インスタンスの読み込みが可能なワークフロー ホストは、インスタンス ストアに対して <xref:System.Activities.DurableInstancing.TryLoadRunnableWorkflowCommand> を実行してインスタンスをメモリに読み込みます。ワークフロー ホストがワークフロー インスタンスを読み込みできると見なされるのは、ホストとインスタンスのメタデータ プロパティ **WorkflowServiceType** が同じ値に設定されている場合です。  
+  
+## アクティブ化可能なワークフロー インスタンスの検出とアクティブ化  
+ ワークフロー インスタンスが*アクティブ化可能*と見なされるのは、そのインスタンスが実行可能であり、そのインスタンスを読み込むことが可能なワークフロー ホストがコンピューターで実行されていない場合です。実行可能なワークフロー インスタンスの定義については、前の「実行可能なワークフロー インスタンスの検出とアクティブ化」を参照してください。  
+  
+ SQL Workflow Instance Store は、データベースでアクティブ化可能なワークフロー インスタンスを見つけると <xref:System.Activities.DurableInstancing.HasActivatableWorkflowEvent> を生成します。その後、SqlWorkflowInstanceStore は <xref:System.Activities.DurableInstancing.QueryActivatableWorkflowsCommand> がストアで一度呼び出されるまで監視を停止します。  
+  
+ <xref:System.Activities.DurableInstancing.HasActivatableWorkflowEvent> に定期受信している汎用ホストは、イベントを受け取ると、インスタンス ストアに対して <xref:System.Activities.DurableInstancing.QueryActivatableWorkflowsCommand> を実行して、ワークフロー ホストの作成に必要なアクティブ化のパラメーターを取得します。汎用ホストは、このアクティブ化パラメーターを使用してワークフロー ホストを作成します。作成されたワークフロー ホストは、実行可能なサービス インスタンスを読み込んで実行します。  
+  
+## 汎用ホスト  
+ 汎用ホストとは、汎用ホストのメタデータ プロパティ **WorkflowServiceType** が、任意のワークフロー型を処理できることを示す **WorkflowServiceType.Any** に設定されているホストです。汎用ホストには、**ActivationType** という XName パラメーターがあります。  
+  
+ 現時点では、SQL Workflow Instance Store は、ActivationType パラメーターが **WAS** に設定された汎用ホストをサポートしています。ActivationType が WAS に設定されていない場合、SQL Workflow Instance Store は <xref:System.Runtime.DurableInstancing.InstancePersistenceException> をスローします。[!INCLUDE[dublin](../../../includes/dublin-md.md)] に付属するワークフロー管理サービスは、アクティブ化のタイプが **WAS** に設定された汎用ホストです。  
+  
+ WAS アクティブ化の場合、汎用ホストは、新しいホストをアクティブ化できるエンドポイント アドレスを派生する一連のアクティブ化パラメーターを要求します。WAS アクティブ化のアクティブ化パラメーターは、サイトの名前、サイトを基準としたアプリケーションの相対パス、アプリケーションを基準としたサービスの相対パスです。SQL Workflow Instance Store は、<xref:System.Activities.DurableInstancing.SaveWorkflowCommand> の実行中にこれらのアクティブ化パラメーターを格納します。  
+  
+## 実行可能インスタンス検出期間  
+ SQL Workflow Instance Store の**実行可能インスタンス検出期間**プロパティは、前の検出サイクルの後、SQL Workflow Instance Store が実行可能またはアクティブ化可能なワークフロー インスタンスを永続性データベースで検出するために検出タスクを実行するまでの期間を指定します。このプロパティの詳細については、「[実行可能インスタンス検出期間](../../../docs/framework/windows-workflow-foundation//runnable-instances-detection-period.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/instance-completion-action.md b/docs/framework/windows-workflow-foundation/instance-completion-action.md
new file mode 100644
index 00000000000..3eb6d5a2581
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/instance-completion-action.md
@@ -0,0 +1,25 @@
+---
+title: "インスタンス完了アクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 90cc99d2-9fef-42fd-bcbf-a56917993721
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# インスタンス完了アクション
+SQL Workflow Instance Store の**インスタンス完了アクション**プロパティでは、インスタンスの完了後にワークフロー インスタンスのデータとメタデータが永続性データベースから削除されるかどうかを指定できます。このプロパティに使用できる値は **DeleteAll** と **DeleteNothing** です。これらのオプションについて次の一覧で説明します。  
+  
+-   **DeleteAll \(既定\)。**このプロパティの値を DeleteAll に設定すると、ワークフロー インスタンスの完了後に、永続性データベースからワークフロー インスタンスのデータおよびメタデータは削除されます。  
+  
+-   **DeleteNothing。**このプロパティの値を DeleteNothing に設定すると、ワークフロー インスタンスが完了しても、ワークフロー インスタンスのデータおよびメタデータは永続性データベースに残ります。  
+  
+    > [!CAUTION]
+    >  インスタンスの完了後にインスタンス状態情報を残すと、永続性データベースのサイズが大きくなります。データベースのサイズが大きくなるにつれて、永続性サブシステムが実行するデータベース操作にかかる時間が長くなります。そのため、永続性データベースからインスタンス状態情報を定期的に削除して、パフォーマンスの要件を満たすレベルでサービスが実行されるようにします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/instance-encoding-option.md b/docs/framework/windows-workflow-foundation/instance-encoding-option.md
new file mode 100644
index 00000000000..f019441b52c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/instance-encoding-option.md
@@ -0,0 +1,24 @@
+---
+title: "インスタンス エンコーディング オプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 89e4b029-4f68-438c-8117-9b21fe094ef4
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# インスタンス エンコーディング オプション
+SQL Workflow Instance Store の**インスタンス エンコーディング オプション**プロパティでは、SQL 永続化プロバイダーが、ワークフロー インスタンス状態情報を永続性データベースに格納する前に、GZip アルゴリズムを使用してその情報を圧縮するかどうかを指定できます。このプロパティに使用できる値は GZip と None です。既定値は None です。これらのオプションを次の一覧で説明します。  
+  
+1.  **GZip**。永続化プロバイダーは、永続性データベースに状態情報を永続化する前に、GZip アルゴリズムを使用して状態情報をエンコードします。  
+  
+2.  **None**。永続化プロバイダーは、永続性データベースに情報を保存する前は、状態情報をエンコードしません。  
+  
+ GZip を使用してワークフロー インスタンスの状態情報をエンコードすると、SQL データベースのメモリ消費量が減ります。また、ワークフロー サービス ホストが実行されているコンピューターとは異なるコンピューターがネットワーク上にあり、そこにデータベースが配置されている場合、ネットワークの消費量も減ります。一般的なガイダンスは、ワークフロー インスタンス状態が小さい場合、**インスタンス エンコーディング オプション** プロパティを **None** に設定することです。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/instance-locked-exception-action.md b/docs/framework/windows-workflow-foundation/instance-locked-exception-action.md
new file mode 100644
index 00000000000..e7a4557d58c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/instance-locked-exception-action.md
@@ -0,0 +1,32 @@
+---
+title: "インスタンス ロック例外アクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 164a5419-315c-4987-ad72-54cbdb88d402
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# インスタンス ロック例外アクション
+SQL Workflow Instance Store の <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceLockedExceptionAction%2A> プロパティでは、SQL 永続化プロバイダーが <xref:System.Runtime.DurableInstancing.InstanceLockedException> を受け取ったときに実行するアクションを指定します。永続化プロバイダーがこの例外を受け取るのは、別のサービス ホストが現在ロックしているワークフロー サービス インスタンスをこの永続化プロバイダーがロックしようとしたときです。このプロパティの値は <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction>、<xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction>、および <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> です。既定値は <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> です。この 3 つのオプションを次の一覧で説明します。  
+  
+-   <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction>.サービス ホストはワーク フロー サービスのインスタンスをロックしようとせず、<xref:System.Runtime.DurableInstancing.InstanceLockedException> を呼び出し元に渡します。ワーク フローが 60 秒を超える期間をメモリにとどまったら再試行として <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> を使用します。既定値は <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> です。  
+  
+-   <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction>.サービス ホストは一定の再試行間隔でワークフロー サービス インスタンスのロックを再試行し、シーケンスの最後に <xref:System.Runtime.DurableInstancing.InstanceLockedException> を呼び出し元に渡します。ワークフローがおよそ 5\-60 秒間メモリに留まり、ワークフローをアンロードする前にすべてのメッセージを処理するため、同じホスト上の同じインスタンスに送信されるメッセージのようにメッセージがバッチで届く場合、リソースを無駄にしない最適な待ち時間を実現するため <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> を使用します。  
+  
+-   <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction>.サービス ホストは指数バックオフ間隔でワークフロー サービス インスタンスのロックを再試行し、シーケンスの最後に例外を呼び出し元に渡します。ワーク フローがとても短い間 \(5 秒以内\) 目盛りに留まる場合、または Web ファームが大きく別のメッセージが同じホストに渡される可能性が高くない場合、最適な待ち時間を実現するため <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> を使用します。  
+  
+ インスタンス ロック例外アクション機能は、次のシナリオをサポートしています。いずれのシナリオでも、SqlWorkflowInstanceStore の instanceLockedExceptionAction プロパティが <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> または <xref:System.Activities.DurableInstancing.InstanceLockedExceptionAction> に設定されていれば、ホストはインスタンスのロックを取得するために、再試行を自動的に繰り返します。  
+  
+1.  **正常なシャットダウンの有効化およびアプリケーション ドメインの重複したリサイクル。**ワークフロー サービス インスタンスを実行するサービス ホストを持つ **AppDomain** がリサイクルされていて、新しい要求を処理するために新しい **AppDomain** が起動され、古い **AppDomain** が正常にシャットダウンされることが想定されています。このシャットダウンは、ワークフロー サービス インスタンスがアイドル状態になるまで待機した後、このインスタンスを永続化してアンロードします。新しい **AppDomain** でインスタンスをロックする処理をホストが再試行すると、<xref:System.Runtime.DurableInstancing.InstanceLockedException> が発生します。  
+  
+2.  **同種サーバー ファームでの永続的ワークフローの水平的スケーリング。**ワークフロー インスタンスが実行されているサーバー ファームのノードがクラッシュし、ワークフロー ホストが実行しているインスタンスのロックを解除できないことを想定しています。ファームの別のノードで実行されているサービス ホストは、そのワークフロー インスタンスのメッセージを受け取ると、<xref:System.Runtime.DurableInstancing.InstanceLockedException> を受け取ることになる、これらのインスタンスのロックを取得する処理を試行します。ロックを更新することになっていたホストは存在しないため、ロックはしばらくすると期限切れになります。  
+  
+     **同種サーバー ファームでの永続的ワークフローの水平的スケーリング:** NLB \(ネットワーク負荷分散\) の内側で複数のホストを使用して永続的なワークフローを水平的にスケーリングし、ファームのいずれかのノードで実行されているワークフロー ホストがワークフロー インスタンスを読み込み、メッセージを処理することを想定しています。また、このインスタンスへの次のメッセージは別のノードで実行されているホストにルーティングされます。これは、すでにインスタンスを実行しているホストにメッセージを届けるルーティング アルゴリズムが NLB にないためです。メッセージを受け取ると、最初のホストがワークフロー インスタンスのロックを保持しているため、2 つ目のホストがこのインスタンスをロードする処理を試行し、<xref:System.Runtime.DurableInstancing.InstanceLockedException> を受け取ります。最初のホストは、最初のメッセージ処理の終了時にこのインスタンスのロックを解除し、2 つ目のホストは次に再試行し、インスタンスをロードして、2 つ目のメッセージを処理する時にロックを取得します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/instance-stores.md b/docs/framework/windows-workflow-foundation/instance-stores.md
new file mode 100644
index 00000000000..4cce270412f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/instance-stores.md
@@ -0,0 +1,36 @@
+---
+title: "インスタンス ストア | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2629668-0923-4987-b943-67477131c1e0
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# インスタンス ストア
+インスタンス ストアは、インスタンスの論理コンテナーです。この場所には、インスタンス データとメタデータが格納されます。インスタンス ストアは、専用の物理的なストレージを意味しているわけではありません。インスタンス ストアには SQL Server データベースの永続的な情報と、メモリ内の非永続的な状態の情報が含まれます。[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には SQL Workflow Instance Store が付属しています。これはインスタンス ストアの具象実装で、ワークフローが SQL Server 2005 または SQL Server 2008 データベースにインスタンス データとメタデータを永続化できるようにします。また、Windows Server App Fabric は、インスタンス ストアの具象実装を提供します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Server App Fabric のインスタンス ストア、クエリ、および管理プロバイダー](http://go.microsoft.com/fwlink/?LinkID=201201&clcid=0x409)。  
+  
+ 永続化 API は、ホストがコマンド要求 \(<xref:System.Activities.DurableInstancing.LoadWorkflowCommand> や <xref:System.Activities.DurableInstancing.SaveWorkflowCommand> など\) をインスタンス ストアに送信できるようにするための、ホストとインスタンス ストア間のインターフェイスです。この API の具象実装は、永続化プロバイダーと呼ばれます。永続化プロバイダーはホストからの要求を受け取り、インスタンス ストアを変更します。  
+  
+ ホストで多くのインスタンス ストアを使用し、インスタンス ストアを多くのホストで使用できるように、ホストとインスタンス ストアはプラグ可能です。通常、インスタンス ストアは特定のホストの使用パターンに合わせて最適化されますが、インスタンス ストアとホストはそれぞれのライフ サイクルで進化する場合があります。たとえば、**WorkflowServiceHost** と **SqlWorkflowInstanceStore** は、併せて効果的に使用できるように設計されています。独自のインスタンス ストアを作成して、ワークフロー サービス インスタンスのデータとメタデータを永続化したり、そのインスタンス ストアを **WorkflowServiceHost** と一緒に使用したりすることができます。たとえば、SQL Server データベースに保存するのではなく、OracleWorkflowInstanceStore を作成して、ワークフローに Oracle データベースに情報を永続化させることができます。  
+  
+ 通常、ホストは保存されたオブジェクトを変更する機能を追加して拡張されます。たとえば、インスタンス永続化システムに、ワークフロー ホスト、「中断」操作をサポートする拡張機能、および SQL インスタンス ストアがあるとします。ワークフロー ホストは保存または読み込みなどの標準的なコマンドを送信して、インスタンス ストアに対してワークフローの保存または読み込みを行ったり、インスタンス ストアにワークフローを保存したりします。中断されたワークフロー インスタンスが読み込まれないように、中断の拡張機能によって、ワークフロー インスタンスの保存および読み込みを行うコマンドに追加のセマンティクスが追加されます。SQL インスタンス ストアの永続化プロバイダーは、ワークフロー インスタンスの保存と読み込み用のコマンドを理解し、SQL Server データベースの永続オブジェクトのテーブルを変更する適切なストアド プロシージャを呼び出して、コマンドを実装します。  
+  
+ インスタンス ストア内では、ホストはインスタンスの所有者として動作します。ホストは、同時に複数のインスタンス ストアを持つ複数のインスタンスの所有者として動作します。ホストはインスタンスに関連付けられているインスタンス キーの GUID を提供します。インスタンス キーは、インスタンスを識別する一意の別名です。永続化システムは、ホストが要求したコマンドを実行するときに、インスタンスの所有者情報を作成、更新、および削除します。  
+  
+ ホストとインスタンス ストアとの対話に関連する重要な手順を次に示します。  
+  
+1.  永続化プロバイダーから **InstanceStore** を取得します。  
+  
+2.  **InstanceStore** の<xref:System.Runtime.Persistence.InstanceStore.CreateInstanceHandle%2A> メソッドを呼び出して、インスタンスへのハンドルを取得します。  
+  
+3.  **InstanceStore** の<xref:System.Runtime.Persistence.InstanceStore.Execute%2A> メソッドを呼び出して、インスタンスのハンドルに対してコマンドを呼び出します。  
+  
+4.  **InstanceStore.Execute** から返された <xref:System.Runtime.Persistence.InstanceView> を確認して、コマンドの結果を判断します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/invoking-activity-validation.md b/docs/framework/windows-workflow-foundation/invoking-activity-validation.md
new file mode 100644
index 00000000000..ca2014d7479
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/invoking-activity-validation.md
@@ -0,0 +1,313 @@
+---
+title: "アクティビティ検証の呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22bef766-c505-4fd4-ac0f-7b363b238969
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# アクティビティ検証の呼び出し
+アクティビティの検証は、アクティビティを実行する前にアクティビティの構成エラーを特定および報告する手段です。検証が発生するのは、ワークフローがワークフロー デザイナーで修正され、検証エラーまたは警告がワークフロー デザイナーに表示されたときです。ワーク フローの呼び出し時に検証も行われます。検証エラーが発生すると、既定の検証ロジックによって <xref:System.Activities.InvalidWorkflowException> がスローされます。[!INCLUDE[wf](../../../includes/wf-md.md)] には、アクティビティを明示的に検証するためにワークフロー アプリケーションやツールの開発者が使用できる <xref:System.Activities.Validation.ActivityValidationServices> クラスが用意されています。このトピックでは、<xref:System.Activities.Validation.ActivityValidationServices> を使用してアクティビティの検証を実行する方法を説明します。  
+  
+## ActivityValidationServices の使用  
+ <xref:System.Activities.Validation.ActivityValidationServices> には、アクティビティの検証ロジックの呼び出しに使用される 2 つの <xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> オーバーロードがあります。1 つ目のオーバーロードは、検証されるルート アクティビティを受け取り、一連の検証エラーと警告を返します。次の例では、2 つの必須引数を持つカスタムの `Add` アクティビティが使用されています。  
+  
+```csharp  
+public sealed class Add : CodeActivity<int>  
+{  
+    [RequiredArgument]  
+    public InArgument<int> Operand1 { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<int> Operand2 { get; set; }  
+  
+    protected override int Execute(CodeActivityContext context)  
+    {  
+        return Operand1.Get(context) + Operand2.Get(context);  
+    }  
+}  
+```  
+  
+ `Add` アクティビティが <xref:System.Activities.Statements.Sequence> 内で使用されていますが、次の例に示すように、その 2 つの必須引数はバインドされていません。  
+  
+```csharp  
+Variable<int> Operand1 = new Variable<int>{ Default = 10 };  
+Variable<int> Operand2 = new Variable<int>{ Default = 15 };  
+Variable<int> Result = new Variable<int>();  
+  
+Activity wf = new Sequence  
+{  
+    Variables = { Operand1, Operand2, Result },  
+    Activities =   
+    {  
+        new Add(),  
+        new WriteLine  
+        {  
+            Text = new InArgument<string>(env => "The result is " + Result.Get(env))  
+        }  
+    }  
+};  
+```  
+  
+ このワーク フローは、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> を呼び出して検証できます。<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> は、次の例に示すように、アクティビティと子に含まれる一連の検証エラーと警告を返します。  
+  
+```csharp  
+ValidationResults results = ActivityValidationServices.Validate(wf);  
+  
+if (results.Errors.Count == 0 && results.Warnings.Count == 0)  
+{  
+    Console.WriteLine("No warnings or errors");  
+}  
+else  
+{  
+    foreach (ValidationError error in results.Errors)  
+    {  
+        Console.WriteLine("Error: {0}", error.Message);  
+    }  
+    foreach (ValidationError warning in results.Warnings)  
+    {  
+        Console.WriteLine("Warning: {0}", warning.Message);  
+    }  
+}  
+```  
+  
+ このサンプル ワークフローで <xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> が呼び出されると、次の 2 つの検証エラーが返されます。  
+  
+ **エラー: 必須のアクティビティ引数 'Operand2' の値が指定されませんでした。**   
+**エラー: 必須のアクティビティ引数 'Operand1' の値が指定されませんでした。**  このワークフローが呼び出された場合、次の例に示すように、<xref:System.Activities.InvalidWorkflowException> がスローされることになります。  
+  
+```csharp  
+try  
+{  
+    WorkflowInvoker.Invoke(wf);  
+}  
+catch (Exception ex)  
+{  
+    Console.WriteLine(ex);  
+}  
+```  
+  
+ **System.Activities.InvalidWorkflowException:**   
+**次のエラーがワーク フロー ツリーの処理中に見つかりました:**   
+**'Add': 必須のアクティビティ引数 'Operand2' の値が指定されませんでした。**   
+**'Add': 必須のアクティビティ引数 'Operand1' の値が指定されませんでした。**  このサンプル ワークフローを有効にするには、`Add` アクティビティの 2 つの必須変数をバインドする必要があります。次の例では、2 つの必須変数と結果値がワークフロー変数にバインドされています。この例では、2 つの必須変数に加え、<xref:System.Activities.Activity%601.Result%2A> 引数がバインドされています。<xref:System.Activities.Activity%601.Result%2A> 引数はバインドする必要がなく、バインドされていなくても検証エラーは発生しません。<xref:System.Activities.Activity%601.Result%2A> の値がワークフローの別の場所で使用される場合、この引数のバインドはワークフローの作成者が行う必要があります。  
+  
+```csharp  
+new Add  
+{  
+    Operand1 = Operand1,  
+    Operand2 = Operand2,  
+    Result = Result  
+}  
+```  
+  
+### ルート アクティビティでの必須引数の検証  
+ ワーク フローのルート アクティビティに引数がある場合、ワーク フローが呼び出され、パラメーターがワーク フローに渡されるまでこれらの引数はバインドされません。次のワーク フローは検証を渡しますが、次の例に示すように、ワーク フローが必要な引数に渡されずに呼び出されると、例外がスローされます。  
+  
+```csharp  
+Activity wf = new Add();  
+  
+ValidationResults results = ActivityValidationServices.Validate(wf);  
+// results has no errors or warnings, but when the workflow  
+// is invoked, an InvalidWorkflowException is thrown.  
+try  
+{  
+    WorkflowInvoker.Invoke(wf);  
+}  
+catch (Exception ex)  
+{  
+    Console.WriteLine(ex);  
+}  
+```  
+  
+ **System.ArgumentException: ルート アクティビティの引数の設定が正しくありません。**   
+**ワーク フロー定義を修正するか、値を入力してこれらのエラーを修正してください:**   
+**'Add': 必須のアクティビティ引数 'Operand2' の値が指定されませんでした。**   
+**'Add': 必須のアクティビティ引数 'Operand1' の値が指定されませんでした。**  正しい引数が渡された後、次の例に示すように、ワークフローは正常に完了します。  
+  
+```csharp  
+Add wf = new Add();  
+  
+ValidationResults results = ActivityValidationServices.Validate(wf);  
+// results has no errors or warnings, and the workflow completes  
+// successfully because the required arguments were passed.  
+try  
+{  
+    Dictionary<string, object> wfparams = new Dictionary<string, object>  
+    {  
+        { "Operand1", 10 },  
+        { "Operand2", 15 }  
+    };  
+  
+    int result = WorkflowInvoker.Invoke(wf, wfparams);  
+    Console.WriteLine("Result: {0}", result);  
+}  
+catch (Exception ex)  
+{  
+    Console.WriteLine(ex);  
+}  
+```  
+  
+> [!NOTE]
+>  この例では、前の例の `Activity` とは異なり、ルート アクティビティは `Add` として宣言されています。このため、`WorkflowInvoker.Invoke` メソッドは、`out` 引数のディクショナリではなく、`Add` アクティビティの結果を表す 1 つの整数を返すことができます。また、変数 `wf` は `Activity<int>` として宣言することも可能です。  
+  
+ ルート引数を検証する場合、ワークフローが呼び出されたときにすべての必須変数が渡されたことを確認するのはホスト アプリケーションが担当します。  
+  
+### 命令型コードに基づく検証の呼び出し  
+ 命令型コードに基づく検証は、アクティビティでアクティビティ自身の検証を可能にする簡単な方法を提供し、<xref:System.Activities.CodeActivity>、<xref:System.Activities.AsyncCodeActivity>、および <xref:System.Activities.NativeActivity> から派生するアクティビティで使用できます。検証のエラーまたは警告を判定する検証コードがアクティビティに追加されます。検証がアクティビティで呼び出されると、これらの警告またはエラーは、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> への呼び出しで返されるコレクションに格納されます。以下の例では [基本検証](../../../docs/framework/windows-workflow-foundation/samples/basic-validation.md) から取られたサンプル `CreateProduct` のアクティビティが定義されます。`Cost` が `Price` よりも高い場合、検証エラーが <xref:System.Activities.CodeActivity.CacheMetadata%2A> オーバーライドのメタデータに追加されます。  
+  
+```csharp  
+public sealed class CreateProduct : CodeActivity  
+{  
+    public double Price { get; set; }  
+    public double Cost { get; set; }  
+  
+    // [RequiredArgument] attribute will generate a validation error   
+    // if the Description argument is not set.  
+    [RequiredArgument]  
+    public InArgument<string> Description { get; set; }  
+  
+    protected override void CacheMetadata(CodeActivityMetadata metadata)  
+    {  
+        base.CacheMetadata(metadata);  
+        // Determine when the activity has been configured in an invalid way.  
+        if (this.Cost > this.Price)  
+        {  
+            // Add a validation error with a custom message.  
+            metadata.AddValidationError("The Cost must be less than or equal to the Price.");  
+        }  
+    }  
+  
+    protected override void Execute(CodeActivityContext context)  
+    {  
+        // Not needed for the sample.  
+    }  
+}  
+  
+```  
+  
+ この例では、ワーク フローは `CreateProduct` のアクティビティを使用して構成されます。このワーク フローで、`Cost` は `Price` より大きく、必須の `Description` 引数は設定されません。検証を呼び出すと、次のエラーが返されます。  
+  
+```csharp  
+Activity wf = new Sequence  
+{  
+    Activities =   
+    {  
+        new CreateProduct  
+        {  
+            Cost = 75.00,  
+            Price = 55.00  
+            // Cost > Price and required Description argument not set.  
+        },  
+        new WriteLine  
+        {  
+            Text = "Product added."  
+        }  
+    }  
+};  
+  
+ValidationResults results = ActivityValidationServices.Validate(wf);  
+  
+if (results.Errors.Count == 0 && results.Warnings.Count == 0)  
+{  
+    Console.WriteLine("No warnings or errors");  
+}  
+else  
+{  
+    foreach (ValidationError error in results.Errors)  
+    {  
+        Console.WriteLine("Error: {0}", error.Message);  
+    }  
+    foreach (ValidationError warning in results.Warnings)  
+    {  
+        Console.WriteLine("Warning: {0}", warning.Message);  
+    }  
+}  
+  
+```  
+  
+ **エラー: コストが価格以下になるようにする必要があります。**   
+**エラー: 必須のアクティビティ引数 'Description' の値が指定されませんでした。**    
+> [!NOTE]
+>  カスタム アクティビティの作成者は、アクティビティの <xref:System.Activities.CodeActivity.CacheMetadata%2A> オーバーライドに検証ロジックを指定できます。<xref:System.Activities.CodeActivity.CacheMetadata%2A> からスローされる例外は、検証エラーとして処理されません。これらの例外は、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> への呼び出しからエスケープされ、呼び出し元によって処理される必要があります。  
+  
+## ValidationSettings の使用  
+ 既定では、アクティビティ ツリー内のすべてのアクティビティは、検証が <xref:System.Activities.Validation.ActivityValidationServices> に呼び出されたときに評価されます。<xref:System.Activities.Validation.ValidationSettings> を使用すると、その 3 つのプロパティを構成することによって、さまざまな方法で検証をカスタマイズできます。<xref:System.Activities.Validation.ValidationSettings.SingleLevel%2A> は、バリデーターがアクティビティ ツリー全体を調べるか、指定したアクティビティにのみ検証ロジックを適用するかを指定します。この値の既定値は `false` です。<xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> は、型から制約のリストへの追加の制約マッピングを指定します。検証されているアクティビティ ツリーの各アクティビティの基本型について、<xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> への参照が行われます。一致する制約リストが見つかると、アクティビティについて、リストのすべての制約が評価されます。<xref:System.Activities.Validation.ValidationSettings.OnlyUseAdditionalConstraints%2A> は、バリデーターがすべての制約を評価するか、<xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> で指定された制約のみを評価するかを指定します。既定値は `false` です。<xref:System.Activities.Validation.ValidationSettings.AdditionalConstraints%2A> および <xref:System.Activities.Validation.ValidationSettings.OnlyUseAdditionalConstraints%2A> は、FxCop のようなツールのポリシーの制約など、ワークフローの検証をワークフロー ホストの作成者がさらに追加する場合に便利です。制約 [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[宣言の制約](../../../docs/framework/windows-workflow-foundation//declarative-constraints.md)」を参照してください。  
+  
+ <xref:System.Activities.Validation.ValidationSettings> を使用するには、必要なプロパティを構成し、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> の呼び出しで渡します。この例では、カスタムの `Add` アクティビティを持つ <xref:System.Activities.Statements.Sequence> で構成されるワークフローが検証されます。この `Add` アクティビティには必須引数が 2 つあります。  
+  
+```csharp  
+public sealed class Add : CodeActivity<int>  
+{  
+    [RequiredArgument]  
+    public InArgument<int> Operand1 { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<int> Operand2 { get; set; }  
+  
+    protected override int Execute(CodeActivityContext context)  
+    {  
+        return Operand1.Get(context) + Operand2.Get(context);  
+    }  
+}  
+```  
+  
+ 次の `Add` アクティビティは <xref:System.Activities.Statements.Sequence> で使用されますが、その 2 つの必須変数はバインドされていません。  
+  
+```csharp  
+Variable<int> Operand1 = new Variable<int> { Default = 10 };  
+Variable<int> Operand2 = new Variable<int> { Default = 15 };  
+Variable<int> Result = new Variable<int>();  
+  
+Activity wf = new Sequence  
+{  
+    Variables = { Operand1, Operand2, Result },  
+    Activities =   
+    {  
+        new Add(),  
+        new WriteLine  
+        {  
+            Text = new InArgument<string>(env => "The result is " + Result.Get(env))  
+        }  
+    }  
+};  
+```  
+  
+ 次の例では、<xref:System.Activities.Validation.ValidationSettings.SingleLevel%2A> が `true` に設定されて検証が実行されるため、ルート アクティビティ <xref:System.Activities.Statements.Sequence> のみが検証されます。  
+  
+```csharp  
+ValidationSettings settings = new ValidationSettings  
+{  
+    SingleLevel = true  
+};  
+  
+ValidationResults results = ActivityValidationServices.Validate(wf, settings);  
+  
+if (results.Errors.Count == 0 && results.Warnings.Count == 0)  
+{  
+    Console.WriteLine("No warnings or errors");  
+}  
+else  
+{  
+    foreach (ValidationError error in results.Errors)  
+    {  
+        Console.WriteLine("Error: {0}", error.Message);  
+    }  
+    foreach (ValidationError warning in results.Warnings)  
+    {  
+        Console.WriteLine("Warning: {0}", warning.Message);  
+    }  
+}  
+```  
+  
+ このコードを実行すると、次の出力が表示されます:  
+  
+ **No warnings or errors** `Add` アクティビティにバインドされていない必須引数がある場合でも、ルート アクティビティのみが評価されるため、検証は正常に実行されます。このタイプの検証は、デザイナーで 1 つのアクティビティのプロパティの変更を検証するなど、アクティビティ ツリーの特定の要素のみを検証する場合に便利です。このワークフローが呼び出された場合、ワークフローで構成された完全な検証が評価され、<xref:System.Activities.InvalidWorkflowException> がスローされます。<xref:System.Activities.Validation.ActivityValidationServices> および <xref:System.Activities.Validation.ValidationSettings> で構成されるのは、ホストによって明示的に呼び出される検証だけであり、ワークフローが呼び出されたときに発生する検証ではありません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/media/addservicereferencetonorthwindodataservice.gif b/docs/framework/windows-workflow-foundation/media/addservicereferencetonorthwindodataservice.gif
new file mode 100644
index 00000000000..74abca7c77d
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/addservicereferencetonorthwindodataservice.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/annotationdialog.png b/docs/framework/windows-workflow-foundation/media/annotationdialog.png
new file mode 100644
index 00000000000..e4581beca17
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/annotationdialog.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/autoconnect1.png b/docs/framework/windows-workflow-foundation/media/autoconnect1.png
new file mode 100644
index 00000000000..9d95faf0037
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/autoconnect1.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/autoinsert.png b/docs/framework/windows-workflow-foundation/media/autoinsert.png
new file mode 100644
index 00000000000..6a9867f8e08
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/autoinsert.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/autosurround1.png b/docs/framework/windows-workflow-foundation/media/autosurround1.png
new file mode 100644
index 00000000000..33daf81a4c4
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/autosurround1.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/autosurround2.png b/docs/framework/windows-workflow-foundation/media/autosurround2.png
new file mode 100644
index 00000000000..11add9d2f14
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/autosurround2.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/basiccompensationworkflows.gif b/docs/framework/windows-workflow-foundation/media/basiccompensationworkflows.gif
new file mode 100644
index 00000000000..7c43149fe36
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/basiccompensationworkflows.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/comparechart.gif b/docs/framework/windows-workflow-foundation/media/comparechart.gif
new file mode 100644
index 00000000000..97bdf534212
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/comparechart.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/complexmemoryusage.gif b/docs/framework/windows-workflow-foundation/media/complexmemoryusage.gif
new file mode 100644
index 00000000000..4713f9b17d1
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/complexmemoryusage.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/complexworkflowboth.gif b/docs/framework/windows-workflow-foundation/media/complexworkflowboth.gif
new file mode 100644
index 00000000000..4523d914f2c
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/complexworkflowboth.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/complexworkflowthroughputworkflow.gif b/docs/framework/windows-workflow-foundation/media/complexworkflowthroughputworkflow.gif
new file mode 100644
index 00000000000..2c58b1025bc
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/complexworkflowthroughputworkflow.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/correlationandpersistencegraph.gif b/docs/framework/windows-workflow-foundation/media/correlationandpersistencegraph.gif
new file mode 100644
index 00000000000..a5634ebc790
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/correlationandpersistencegraph.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/correlationscopeworkflow.gif b/docs/framework/windows-workflow-foundation/media/correlationscopeworkflow.gif
new file mode 100644
index 00000000000..6607aa9dcc1
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/correlationscopeworkflow.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/correlationthroughputgraph.gif b/docs/framework/windows-workflow-foundation/media/correlationthroughputgraph.gif
new file mode 100644
index 00000000000..6019b2735ca
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/correlationthroughputgraph.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/correlationthroughputworkflow.gif b/docs/framework/windows-workflow-foundation/media/correlationthroughputworkflow.gif
new file mode 100644
index 00000000000..5fbe48faab6
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/correlationthroughputworkflow.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/designercontextmenu.png b/docs/framework/windows-workflow-foundation/media/designercontextmenu.png
new file mode 100644
index 00000000000..ee0ea5c8f5d
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/designercontextmenu.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/gettingstartedtutorialcompletedflowchart.PNG b/docs/framework/windows-workflow-foundation/media/gettingstartedtutorialcompletedflowchart.PNG
new file mode 100644
index 00000000000..506ecc76d70
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/gettingstartedtutorialcompletedflowchart.PNG differ
diff --git a/docs/framework/windows-workflow-foundation/media/latencyandthroughputenvironment.gif b/docs/framework/windows-workflow-foundation/media/latencyandthroughputenvironment.gif
new file mode 100644
index 00000000000..766b6df1e86
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/latencyandthroughputenvironment.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/latencyresultsgraph.gif b/docs/framework/windows-workflow-foundation/media/latencyresultsgraph.gif
new file mode 100644
index 00000000000..7502b8badcf
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/latencyresultsgraph.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/nestedsequencewf.gif b/docs/framework/windows-workflow-foundation/media/nestedsequencewf.gif
new file mode 100644
index 00000000000..bd95b5a91e4
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/nestedsequencewf.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/netframework4platformupdate1statemachineactivities.jpg b/docs/framework/windows-workflow-foundation/media/netframework4platformupdate1statemachineactivities.jpg
new file mode 100644
index 00000000000..2f760537ecf
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/netframework4platformupdate1statemachineactivities.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/media/numberofactivitiesequation.gif b/docs/framework/windows-workflow-foundation/media/numberofactivitiesequation.gif
new file mode 100644
index 00000000000..c0881ffc0fb
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/numberofactivitiesequation.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/onlinestoreperfgraph.gif b/docs/framework/windows-workflow-foundation/media/onlinestoreperfgraph.gif
new file mode 100644
index 00000000000..45c18f66522
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/onlinestoreperfgraph.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/outlineviewinworkflowdesigner.jpg b/docs/framework/windows-workflow-foundation/media/outlineviewinworkflowdesigner.jpg
new file mode 100644
index 00000000000..cf5000bdbfc
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/outlineviewinworkflowdesigner.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/media/panbutton.png b/docs/framework/windows-workflow-foundation/media/panbutton.png
new file mode 100644
index 00000000000..57aa0dd224a
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/panbutton.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/performancedata.gif b/docs/framework/windows-workflow-foundation/media/performancedata.gif
new file mode 100644
index 00000000000..b84a59acf85
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/performancedata.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/performancetestchart.gif b/docs/framework/windows-workflow-foundation/media/performancetestchart.gif
new file mode 100644
index 00000000000..14989fb6ba5
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/performancetestchart.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/persistworkflow.gif b/docs/framework/windows-workflow-foundation/media/persistworkflow.gif
new file mode 100644
index 00000000000..337020cd7ac
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/persistworkflow.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/pickconceptual.JPG b/docs/framework/windows-workflow-foundation/media/pickconceptual.JPG
new file mode 100644
index 00000000000..647b67bb8f2
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/pickconceptual.JPG differ
diff --git a/docs/framework/windows-workflow-foundation/media/receiveworkflowboth.gif b/docs/framework/windows-workflow-foundation/media/receiveworkflowboth.gif
new file mode 100644
index 00000000000..3f27a978c3f
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/receiveworkflowboth.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/replicatorandparallelforeach.gif b/docs/framework/windows-workflow-foundation/media/replicatorandparallelforeach.gif
new file mode 100644
index 00000000000..19279b4d5ef
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/replicatorandparallelforeach.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/testresults1.gif b/docs/framework/windows-workflow-foundation/media/testresults1.gif
new file mode 100644
index 00000000000..be5ddc11c17
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/testresults1.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/throughputpersistence.gif b/docs/framework/windows-workflow-foundation/media/throughputpersistence.gif
new file mode 100644
index 00000000000..81021f681aa
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/throughputpersistence.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/trackingdatathroughetwparticipant.gif b/docs/framework/windows-workflow-foundation/media/trackingdatathroughetwparticipant.gif
new file mode 100644
index 00000000000..5ba5f19b5e2
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/trackingdatathroughetwparticipant.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/trackingeventviewer.PNG b/docs/framework/windows-workflow-foundation/media/trackingeventviewer.PNG
new file mode 100644
index 00000000000..e25decf2884
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/trackingeventviewer.PNG differ
diff --git a/docs/framework/windows-workflow-foundation/media/w3numberofactivitiesequation.gif b/docs/framework/windows-workflow-foundation/media/w3numberofactivitiesequation.gif
new file mode 100644
index 00000000000..fb81f568097
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/w3numberofactivitiesequation.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/wf3workflow.gif b/docs/framework/windows-workflow-foundation/media/wf3workflow.gif
new file mode 100644
index 00000000000..e657a5364b8
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wf3workflow.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/wf45gettingstartedtutorialworkflowhostform.png b/docs/framework/windows-workflow-foundation/media/wf45gettingstartedtutorialworkflowhostform.png
new file mode 100644
index 00000000000..44a4d9acd46
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wf45gettingstartedtutorialworkflowhostform.png differ
diff --git a/docs/framework/windows-workflow-foundation/media/wfperfenvironment.gif b/docs/framework/windows-workflow-foundation/media/wfperfenvironment.gif
new file mode 100644
index 00000000000..929a0678175
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wfperfenvironment.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/wfsequentialgettingstartedtutorialcomplete.JPG b/docs/framework/windows-workflow-foundation/media/wfsequentialgettingstartedtutorialcomplete.JPG
new file mode 100644
index 00000000000..41d25ad6d2b
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wfsequentialgettingstartedtutorialcomplete.JPG differ
diff --git a/docs/framework/windows-workflow-foundation/media/wfstatemachinegettingstartedtutorialcomplete.JPG b/docs/framework/windows-workflow-foundation/media/wfstatemachinegettingstartedtutorialcomplete.JPG
new file mode 100644
index 00000000000..c6583b230a4
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wfstatemachinegettingstartedtutorialcomplete.JPG differ
diff --git a/docs/framework/windows-workflow-foundation/media/workflowinteraction.gif b/docs/framework/windows-workflow-foundation/media/workflowinteraction.gif
new file mode 100644
index 00000000000..5a34eb888ac
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/workflowinteraction.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/workflowtracingcost.gif b/docs/framework/windows-workflow-foundation/media/workflowtracingcost.gif
new file mode 100644
index 00000000000..fd65d09b7c6
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/workflowtracingcost.gif differ
diff --git a/docs/framework/windows-workflow-foundation/media/wv.gif b/docs/framework/windows-workflow-foundation/media/wv.gif
new file mode 100644
index 00000000000..52fc6c938ea
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/media/wv.gif differ
diff --git a/docs/framework/windows-workflow-foundation/migration-activity-in-wf.md b/docs/framework/windows-workflow-foundation/migration-activity-in-wf.md
new file mode 100644
index 00000000000..67257a4912e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/migration-activity-in-wf.md
@@ -0,0 +1,21 @@
+---
+title: "WF 内の移行のアクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ad46db7-5744-410e-8fac-6c3b325b1dd0
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WF 内の移行のアクティビティ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] 提供、 <xref:> System.Activities.Statements.Interop?qualifyHint=False&autoUpgrade=True から派生するアクティビティを実行するアクティビティ <xref:System.WorkflowModel.Activities.Activity> に基づくワークフロー内で <xref:System.Activities.Activity>します。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)]  [移行ガイダンス](../../../docs/framework/windows-workflow-foundation//migration-guidance.md) セクションです。  
+  
+> [!NOTE]
+>   <xref:System.Activities.Statements.Interop> ワークフローのプロジェクトで、アクティビティがワークフロー デザイナー ツールボックスに表示されない、 **ターゲット フレームワーク** ] に設定 **.Net Framework 4** またはそれ以降。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/migration-guidance.md b/docs/framework/windows-workflow-foundation/migration-guidance.md
new file mode 100644
index 00000000000..1bd28f663b4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/migration-guidance.md
@@ -0,0 +1,31 @@
+---
+title: "Windows Workflow Foundation (WF) への移行のガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb65c132-58c9-4028-b3d4-1efc71d5e60e
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Windows Workflow Foundation (WF) への移行のガイドライン
+このセクションでは、前のバージョンの [!INCLUDE[wf](../../../includes/wf-md.md)] からのワークフロー移行に関するトピックを示しています。  
+  
+## このセクションの内容  
+ [移行のガイドライン](../../../docs/framework/windows-workflow-foundation//migration-guidance.md)  
+ 移行に関するトピックが記載されたホワイトペーパーへのリンクの一覧を含んでいます。  
+  
+ [Interop アクティビティと .NET Framework 4 内の .NET Framework 3.0 WF アクティビティの使用](../../../docs/framework/windows-workflow-foundation//net-framework-3-0-wf-in-net-framework-4-interop.md)  
+ <xref:System.Activities.Statements.Interop> アクティビティを使用して [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] アクティビティを [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフローに埋め込む方法について説明しています。  
+  
+ [.NET Framework 4 ワークフローでの相互運用アクティビティの使用](../../../docs/framework/windows-workflow-foundation//using-the-interop-activity-in-a-net-framework-4-workflow.md)  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] で [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] の規則を使用する方法について説明しています。  
+  
+ [Visual Studio 2010 での .NET Framework 3.0 および 3.5 を対象とするプロジェクトの作成](../../../docs/framework/windows-workflow-foundation//projects-targeting-dotnet-in-vs.md)  
+ .NET Framework version 3.0 または 3.5 を対象とするプロジェクトを [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を使用して作成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/modeling-cancellation-behavior-in-workflows.md b/docs/framework/windows-workflow-foundation/modeling-cancellation-behavior-in-workflows.md
new file mode 100644
index 00000000000..9ccd63eeae7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/modeling-cancellation-behavior-in-workflows.md
@@ -0,0 +1,96 @@
+---
+title: "ワークフローでの取り消し動作のモデル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d48f6cf3-cdde-4dd3-8265-a665acf32a03
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ワークフローでの取り消し動作のモデル化
+アクティビティは、たとえば <xref:System.Activities.Statements.Parallel> アクティビティを使用して、ワークフロー内部で取り消すことができます。このアクティビティでは、<xref:System.Activities.Statements.Parallel.CompletionCondition%2A> の評価結果が `true` になると、完了していない分岐が取り消されます。また、ホストで <xref:System.Activities.WorkflowApplication.Cancel%2A> を呼び出すと、アクティビティをワークフロー外から取り消すこともできます。取り消し処理を指定するには、ワークフローの作成者は、<xref:System.Activities.Statements.CancellationScope> アクティビティまたは <xref:System.Activities.Statements.CompensableActivity> アクティビティを使用するか、取り消しロジックを指定するカスタム アクティビティを作成します。このトピックでは、ワークフローにおける取り消しの概要について説明します。  
+  
+## 取り消し、補正、およびトランザクション  
+ アプリケーションでトランザクションを使用すると、トランザクションのプロセスでエラーが発生した場合、トランザクション内で実行されたすべての変更を中止 \(ロールバック\) できます。ただし、長期間にわたって実行される処理やトランザクション リソースを含まない処理など、取り消す \(元に戻す\) 必要がある処理によってはトランザクションに適さないものもあります。補正は、ワークフローでエラーが発生した場合に、前に完了した非トランザクションの処理を元に戻すためのモデルを提供します。取り消しは、完了していない非トランザクションの処理をワークフローやアクティビティの作成者が処理できるようにするためのモデルを提供します。実行を完了していないアクティビティが取り消された場合、取り消しロジックが指定されていればそのロジックが呼び出されます。  
+  
+> [!NOTE]
+>  トランザクションと補正[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[トランザクション](../../../docs/framework/windows-workflow-foundation//workflow-transactions.md)」および「[補正](../../../docs/framework/windows-workflow-foundation//compensation.md)」を参照してください。  
+  
+## CancellationScope の使用  
+ <xref:System.Activities.Statements.CancellationScope> アクティビティには、子アクティビティを含めることができる <xref:System.Activities.Statements.CancellationScope.Body%2A> および <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> という 2 つのセクションがあります。<xref:System.Activities.Statements.CancellationScope.Body%2A> には、アクティビティのロジックを構成するアクティビティを配置し、<xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> には、アクティビティの取り消しロジックを指定するアクティビティを配置します。アクティビティは、完了していない場合にのみ取り消すことができます。<xref:System.Activities.Statements.CancellationScope> アクティビティの場合は、<xref:System.Activities.Statements.CancellationScope.Body%2A> のアクティビティが完了すると完了したことになります。取り消し要求がスケジュールされている場合、<xref:System.Activities.Statements.CancellationScope.Body%2A> のアクティビティが完了していなければ、<xref:System.Activities.Statements.CancellationScope> が <xref:System.Activities.ActivityInstanceState> とマークされ、<xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> アクティビティが実行されます。  
+  
+### ホストからのワークフローの取り消し  
+ ホストでワークフローを取り消すには、ワークフローをホストしている <xref:System.Activities.WorkflowApplication> インスタンスの <xref:System.Activities.WorkflowApplication.Cancel%2A> メソッドを呼び出します。次の例では、<xref:System.Activities.Statements.CancellationScope> を含むワークフローが作成されます。このワークフローが呼び出され、ホストで <xref:System.Activities.WorkflowApplication.Cancel%2A> が呼び出されます。ワークフローのメインの実行が停止し、<xref:System.Activities.Statements.CancellationScope> の <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> メソッドが呼び出され、ワークフローがステータス <xref:System.Activities.ActivityInstanceState> で完了します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#35](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#35)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **ワークフローを開始します。**   
+**CancellationHandler が呼び出されました。**   
+**ワークフロー b30ebb30\-df46\-4d90\-a211\-e31c38d8db3c が取り消されました。**    
+> [!NOTE]
+>  <xref:System.Activities.Statements.CancellationScope> アクティビティを取り消して <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> を呼び出す場合、適切な取り消しロジックを指定するには、ワークフローの作成者が、アクティビティが取り消されるまでの進行状況を確認する必要があります。<xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> からは、取り消されるアクティビティの進行状況に関する情報は提供されません。  
+  
+ ワークフローのルートの後に未処理の例外がバブルアップされ、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> ハンドラーから <xref:System.Activities.UnhandledExceptionAction> が返された場合も、ホストからワークフローを取り消すことができます。次の例では、ワークフローの開始後に、ワークフローから <xref:System.ApplicationException> がスローされます。この例外はワークフローで処理されないため、<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A> ハンドラーが呼び出されます。ハンドラーがランタイムにワークフローを取り消すように指示し、現在実行中の <xref:System.Activities.Statements.CancellationScope> アクティビティの <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> が呼び出されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#36](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#36)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **ワークフローを開始します。**   
+**ワークフロー 6bb2d5d6\-f49a\-4c6d\-a988\-478afb86dbe9 の OnUnhandledException**   
+**ApplicationException がスローされました。**   
+**CancellationHandler が呼び出されました。**   
+**ワークフロー 6bb2d5d6\-f49a\-4c6d\-a988\-478afb86dbe9 が取り消されました。**    
+### ワークフロー内部からのアクティビティの取り消し  
+ アクティビティは、親から取り消すこともできます。たとえば、<xref:System.Activities.Statements.Parallel> アクティビティに実行中の分岐が複数ある場合、その <xref:System.Activities.Statements.Parallel.CompletionCondition%2A> の評価結果が `true` になると、完了していない分岐は取り消されます。次の例では、2 つの分岐がある <xref:System.Activities.Statements.Parallel> アクティビティが作成されます。<xref:System.Activities.Statements.Parallel.CompletionCondition%2A> が `true` に設定されているため、どちらかの分岐が完了した時点で <xref:System.Activities.Statements.Parallel> が完了します。この例では、分岐 2 が完了するため、分岐 1 が取り消されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#37](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#37)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **分岐 1 を開始します。**   
+**分岐 2 が完了しました。**   
+**分岐 1 が取り消されました。**   
+**ワークフロー e0685e24\-18ef\-4a47\-acf3\-5c638732f3be が完了しました。**  アクティビティは、アクティビティのルートの後に例外がバブルアップされ、その例外がワークフローの上位で処理されていない場合にも取り消されます。次の例では、ワークフローのメイン ロジックが <xref:System.Activities.Statements.Sequence> アクティビティで構成されています。<xref:System.Activities.Statements.Sequence> は、<xref:System.Activities.Statements.TryCatch> アクティビティに含まれる <xref:System.Activities.Statements.CancellationScope> アクティビティの  <xref:System.Activities.Statements.CancellationScope.Body%2A> として指定されています。<xref:System.Activities.Statements.Sequence> の本体から例外がスローされて親の <xref:System.Activities.Statements.TryCatch> アクティビティによって処理され、<xref:System.Activities.Statements.Sequence> が取り消されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#39](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#39)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **シーケンスを開始します。**   
+**シーケンスが取り消されました。**   
+**例外がキャッチされました。**   
+**ワークフロー e3c18939\-121e\-4c43\-af1c\-ba1ce977ce55 が完了しました。**   
+### CancellationHandler からの例外のスロー  
+ <xref:System.Activities.Statements.CancellationScope> の <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> からスローされるすべての例外は、ワークフローにとって致命的なものです。例外が <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> からエスケープされる可能性がある場合は、<xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> の <xref:System.Activities.Statements.TryCatch> を使用して、それらの例外をキャッチして処理するようにしてください。  
+  
+### CompensableActivity を使用した取り消し  
+ <xref:System.Activities.Statements.CancellationScope> アクティビティと同様に、<xref:System.Activities.Statements.CompensableActivity> には <xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> があります。<xref:System.Activities.Statements.CompensableActivity> が取り消されると、その <xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> に含まれるアクティビティが呼び出されます。これは、部分的に完了した補正可能な処理を元に戻す場合に役立ちます。補正や取り消しに <xref:System.Activities.Statements.CompensableActivity> を使用する方法については、「[補正](../../../docs/framework/windows-workflow-foundation//compensation.md)」を参照してください。  
+  
+## カスタム アクティビティを使用した取り消し  
+ カスタム アクティビティの作成者は、いくつかの方法でカスタム アクティビティに取り消しロジックを実装することができます。<xref:System.Activities.Activity> から派生するカスタム アクティビティは、<xref:System.Activities.Statements.CancellationScope> またはキャンセル ロジックを含む他のカスタム アクティビティをアクティビティの本体に配置することによって、取り消しロジックを実装できます。<xref:System.Activities.AsyncCodeActivity> および <xref:System.Activities.NativeActivity> から派生したアクティビティは、それぞれの <xref:System.Activities.NativeActivity.Cancel%2A> メソッドをオーバーライドして、取り消しロジックを提供できます。<xref:System.Activities.CodeActivity> 派生アクティビティでは取り消しの処置を行うことはできません。ランタイムが <xref:System.Activities.CodeActivity.Execute%2A> メソッドを呼び出すと、すべての作業が一度に実行されるからです。実行メソッドが呼び出される前に <xref:System.Activities.CodeActivity> ベースのアクティビティを取り消した場合、アクティビティはステータス <xref:System.Activities.ActivityInstanceState> で終了し、<xref:System.Activities.CodeActivity.Execute%2A> メソッドは呼び出されません。  
+  
+### NativeActivity を使用した取り消し  
+ <xref:System.Activities.NativeActivity> 派生アクティビティでは、<xref:System.Activities.NativeActivity.Cancel%2A> メソッドをオーバーライドしてカスタムの取り消しロジックを指定できます。このメソッドがオーバーライドされていない場合は、既定のワークフロー取り消しロジックが適用されます。既定の取り消しは、<xref:System.Activities.NativeActivity> の <xref:System.Activities.NativeActivity.Cancel%2A> メソッドがオーバーライドされていない場合、つまり <xref:System.Activities.NativeActivity.Cancel%2A> メソッドが基本の <xref:System.Activities.NativeActivity> <xref:System.Activities.NativeActivity.Cancel%2A> メソッドを呼び出す場合に発生する処理です。アクティビティが取り消されると、ランタイムは、取り消し対象のフラグをアクティビティに設定し、特定のクリーンアップ処理を自動的に実行します。アクティビティに未処理のブックマークしかない場合、それらのブックマークが削除され、アクティビティが <xref:System.Activities.ActivityInstanceState> とマークされます。取り消されるアクティビティに未処理の子アクティビティがある場合は、それらも取り消されます。子アクティビティを追加でスケジュールしようとすると無視され、アクティビティは <xref:System.Activities.ActivityInstanceState> とマークされます。未処理の子アクティビティが <xref:System.Activities.ActivityInstanceState> または <xref:System.Activities.ActivityInstanceState> の状態で完了した場合、アクティビティは <xref:System.Activities.ActivityInstanceState> とマークされます。取り消し要求は無視される場合があることに注意してください。アクティビティに未処理のブックマークも実行中の子アクティビティもなく、取り消し対象のフラグが設定された後に追加の作業項目のスケジュールも行っていない場合は、アクティビティが正常に完了します。ほとんどの場合はこの既定の取り消しで十分ですが、別の取り消しロジックが必要な場合は、組み込みの取り消しアクティビティやカスタム アクティビティを使用できます。  
+  
+ 次の例では、<xref:System.Activities.NativeActivity> ベースのカスタム `ParallelForEach` アクティビティの <xref:System.Activities.NativeActivity.Cancel%2A> オーバーライドが定義されます。アクティビティが取り消されると、このオーバーライドによってアクティビティの取り消しロジックが処理されます。この例は、「[非ジェネリックの ParallelForEach](../../../docs/framework/windows-workflow-foundation/samples/non-generic-parallelforeach.md)」のサンプルの一部です。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#1010](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#1010)]  
+  
+ <xref:System.Activities.NativeActivity> 派生アクティビティでは、<xref:System.Activities.NativeActivityContext.IsCancellationRequested%2A> プロパティを調べることによって取り消しが要求されたかどうかを確認し、<xref:System.Activities.NativeActivityContext.MarkCanceled%2A> メソッドを呼び出して取り消し対象としてマークできます。<xref:System.Activities.NativeActivityContext.MarkCanceled%2A> を呼び出した後、すぐにアクティビティが完了するわけではありません。ランタイムは通常どおり、未処理の処理がなくなってからアクティビティを完了します。ただし、<xref:System.Activities.NativeActivityContext.MarkCanceled%2A> が呼び出された場合は、最終的な状態が <xref:System.Activities.ActivityInstanceState> ではなく <xref:System.Activities.ActivityInstanceState> になります。  
+  
+### AsyncCodeActivity を使用した取り消し  
+ <xref:System.Activities.AsyncCodeActivity> ベースのアクティビティでも、<xref:System.Activities.AsyncCodeActivity.Cancel%2A> メソッドをオーバーライドしてカスタムの取り消しロジックを指定できます。このメソッドがオーバーライドされていない場合は、アクティビティが取り消されても取り消し処理は実行されません。次の例では、<xref:System.Activities.AsyncCodeActivity> ベースのカスタム `ExecutePowerShell` アクティビティの <xref:System.Activities.AsyncCodeActivity.Cancel%2A> オーバーライドが定義されます。アクティビティが取り消されると、必要な取り消し動作が実行されます。この例は、「[InvokePowerShell アクティビティの使用](../../../docs/framework/windows-workflow-foundation/samples/using-the-invokepowershell-activity.md)」のサンプルの一部です。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#1020](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#1020)]  
+  
+ <xref:System.Activities.AsyncCodeActivity> 派生アクティビティでは、<xref:System.Activities.AsyncCodeActivityContext.IsCancellationRequested%2A> プロパティを調べることによって取り消しが要求されたかどうかを確認し、<xref:System.Activities.AsyncCodeActivityContext.MarkCanceled%2A> メソッドを呼び出して取り消し対象としてマークできます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/nativeactivity-base-class.md b/docs/framework/windows-workflow-foundation/nativeactivity-base-class.md
new file mode 100644
index 00000000000..d0b01b2c115
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/nativeactivity-base-class.md
@@ -0,0 +1,83 @@
+---
+title: "NativeActivity の基本クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 254a4c50-425b-426d-a32f-0f7234925bac
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# NativeActivity の基本クラス
+<xref:System.Activities.NativeActivity> はプロテクト コンストラクターを持つ抽象クラスです。<xref:System.Activities.CodeActivity> と同様に、<xref:System.Activities.NativeActivity> は、<xref:System.Activities.NativeActivity.Execute%2A> メソッドを実装して、強制的な動作を記述するときに使用します。<xref:System.Activities.CodeActivity> とは異なり、<xref:System.Activities.NativeActivity> からは、<xref:System.Activities.NativeActivity.Execute%2A> メソッドに渡される <xref:System.Activities.NativeActivityContext> オブジェクトを介して、ワークフロー ランタイムの公開されているすべての機能にアクセスできます。  
+  
+## NativeActivityContext の使用  
+ ワークフロー ランタイムの機能には、<xref:System.Activities.NativeActivityContext> 型の `context` パラメーターを使用して、<xref:System.Activities.NativeActivity.Execute%2A> メソッド内からアクセスできます。<xref:System.Activities.NativeActivityContext> を介して、以下の機能を使用できます。  
+  
+-   引数と変数を取得および設定する。  
+  
+-   <xref:System.Activities.NativeActivityContext.ScheduleActivity%2A> を使用して子のアクティビティのスケジュールを設定する。  
+  
+-   <xref:System.Activities.NativeActivityContext.Abort%2A> を使用してアクティビティの実行を中止する。  
+  
+-   <xref:System.Activities.NativeActivityContext.CancelChild%2A> および <xref:System.Activities.NativeActivityContext.CancelChildren%2A> を使用して子の実行を取り消す。  
+  
+-   <xref:System.Activities.NativeActivityContext.CreateBookmark%2A>、<xref:System.Activities.NativeActivityContext.RemoveBookmark%2A>、および <xref:System.Activities.NativeActivityContext.ResumeBookmark%2A> などのメソッドを使用して、アクティビティのブックマークにアクセスする。  
+  
+-   <xref:System.Activities.CodeActivityContext.Track%2A> を使用したカスタムの追跡機能。  
+  
+-   <xref:System.Activities.CodeActivityContext.GetProperty%2A> および <xref:System.Activities.NativeActivityContext.GetValue%2A> を使用して、アクティビティの実行プロパティと値プロパティにアクセスする。  
+  
+-   <xref:System.Activities.NativeActivityContext.ScheduleAction%2A> および <xref:System.Activities.NativeActivityContext.ScheduleFunc%2A> を使用してアクティビティのアクションと機能のスケジュールを設定する。  
+  
+#### NativeActivity から継承するカスタム アクティビティを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。**\[プロジェクトの種類\]** ウィンドウの **\[Visual C\#\]** の下にある **\[ワークフロー 4.0\]** を選択し、v2010 ノードを選択します。**\[テンプレート\]** ウィンドウで **\[アクティビティ ライブラリ\]** をクリックします。新しいプロジェクトに HelloActivity という名前を付けます。  
+  
+3.  HelloActivity プロジェクトの Activity1.xaml を右クリックし、**\[削除\]** をクリックします。  
+  
+4.  HelloActivity プロジェクトを右クリックして、**\[追加\]** の **\[クラス\]** をクリックします。新しいクラスに HelloActivity.cs という名前を付けます。  
+  
+5.  HelloActivity.cs ファイルで、次の `using` ディレクティブを追加します。  
+  
+    ```csharp  
+    using System.Activities;  
+    using System.Activities.Statements;  
+    ```  
+  
+6.  クラス宣言に基本クラスを追加することにより、新しいクラスで <xref:System.Activities.NativeActivity> から継承します。  
+  
+    ```csharp  
+    class HelloActivity : NativeActivity  
+    ```  
+  
+7.  <xref:System.Activities.NativeActivity.Execute%2A> メソッドを追加して、このクラスに機能を追加します。  
+  
+    ```csharp  
+    protected override void Execute(NativeActivityContext context)  
+    {  
+        Console.WriteLine("Hello World!");  
+    }  
+    ```  
+  
+8.  <xref:System.Activities.NativeActivity.CacheMetadata%2A> メソッドをオーバーライドして適切な Add メソッドを呼び出し、カスタム アクティビティの変数、引数、子およびデリゲートについてワークフロー ランタイムに通知します。詳細については、<xref:System.Activities.NativeActivityMetadata> クラスのトピックを参照してください。  
+  
+9. <xref:System.Activities.NativeActivityContext> オブジェクトを使用してブックマークをスケジュールします。ブックマークを作成、スケジュール、および再開する方法の詳細については、「<xref:System.Activities.WorkflowApplicationIdleEventArgs.Bookmarks%2A>」を参照してください。  
+  
+    ```  
+    protected override void Execute(NativeActivityContext context)  
+        {  
+            // Create a Bookmark and wait for it to be resumed.  
+            context.CreateBookmark(BookmarkName.Get(context),   
+                new BookmarkCallback(OnResumeBookmark));  
+        }  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/net-framework-3-0-wf-in-net-framework-4-interop.md b/docs/framework/windows-workflow-foundation/net-framework-3-0-wf-in-net-framework-4-interop.md
new file mode 100644
index 00000000000..730a1bf9d1e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/net-framework-3-0-wf-in-net-framework-4-interop.md
@@ -0,0 +1,63 @@
+---
+title: "Interop アクティビティと .NET Framework 4 内の .NET Framework 3.0 WF アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 71f112ba-abb0-46f7-b05f-a5d2eb9d0c5c
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# Interop アクティビティと .NET Framework 4 内の .NET Framework 3.0 WF アクティビティの使用
+ <xref:System.Activities.Statements.Interop> アクティビティは、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] (WF 4.5) アクティビティをラップする、 [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] (WF 3.5) アクティビティ内で、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフローです。 WF 3 アクティビティは、単一のリーフ アクティビティまたはツリー全体のアクティビティです。 [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] アクティビティの実行 (取り消しおよび例外処理を含む) および保持は、実行中の [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフロー インスタンスのコンテキスト内で発生します。  
+  
+> [!NOTE]
+>   <xref:System.Activities.Statements.Interop> ワークフローのプロジェクトで、アクティビティがワークフロー デザイナー ツールボックスに表示されない、 **ターゲット フレームワーク** ] に設定 **.NET Framework 4.5**します。  
+  
+## <a name="criteria-for-using-a-wf-3-activity-with-an-interop-activity"></a>WF 3 アクティビティと Interop アクティビティを使用するための基準  
+ WF 3 アクティビティ内で正常に実行する、 <xref:System.Activities.Statements.Interop> アクティビティ、次の条件を満たす必要があります。  
+  
+-   WF 3 アクティビティから派生する必要があります <xref:System.Workflow.ComponentModel.Activity?displayProperty=fullName>します。  
+  
+-   WF 3 アクティビティが `public` として宣言されています。また、`abstract` ではありません。  
+  
+-   WF 3 アクティビティにパブリックの既定コンストラクターがあります。  
+  
+-   型がインターフェイスでの制限のため、 <xref:System.Activities.Statements.Interop> アクティビティがサポートできる、 <xref:System.Workflow.Activities.HandleExternalEventActivity> と <xref:System.Workflow.Activities.CallExternalMethodActivity> ことはできませんが、直接使用、派生アクティビティをワークフロー通信アクティビティ ツール (WCA.exe) を使用して作成を使用できます。 参照してください [Windows Workflow Foundation ツール](http://go.microsoft.com/fwlink/?LinkId=178889) 詳細です。  
+  
+## <a name="configuring-a-wf-3-activity-within-an-interop-activity"></a>Interop アクティビティ内の WF 3 アクティビティの構成  
+ 構成し、相互運用の境界を越えて、WF 3 アクティビティに出入りするデータを渡す、WF 3 アクティビティのプロパティとメタデータのプロパティがによって公開されて、 <xref:System.Activities.Statements.Interop> アクティビティ。 WF 3 アクティビティのメタデータのプロパティ (よう <xref:System.Workflow.ComponentModel.Activity.Name%2A>) を介して公開される、 <xref:System.Activities.Statements.Interop.ActivityMetaProperties%2A> コレクションです。 これは、WF 3 アクティビティのメタデータのプロパティに関する値を定義するために使用される名前と値ペアのコレクションです。 メタデータのプロパティは、プロパティを依存関係プロパティに基づく、 <xref:System.Workflow.ComponentModel.DependencyPropertyOptions> フラグを設定します。  
+  
+ WF 3 アクティビティのプロパティがを介して公開される、 <xref:System.Activities.Statements.Interop.ActivityProperties%2A> コレクションです。 これは名前と値のペアのセットの各値が、 <xref:System.Activities.Argument> オブジェクト、WF 3 アクティビティのプロパティの引数を定義するために使用します。 としてすべてのプロパティを表示、WF 3 アクティビティのプロパティの方向は推論できないため、 <xref:System.Activities.InArgument>/<xref:System.Activities.OutArgument> のペアです。 やすい表示するアクティビティの使用方法、プロパティ、によって、 <xref:System.Activities.InArgument> エントリ、 <xref:System.Activities.OutArgument> エントリ、またはその両方です。 想定される名前、 <xref:System.Activities.InArgument> コレクション内のエントリがプロパティの名前を WF 3 アクティビティに定義されています。 想定される名前、 <xref:System.Activities.OutArgument> コレクション内のエントリは、プロパティの名前、および文字列"out を"連結したものです。  
+  
+## <a name="limitations-of-using-a-wf-3-activity-within-an-interop-activity"></a>Interop アクティビティ内で WF 3 アクティビティを使用する際の制限  
+ WF 3 システム標準アクティビティを直接ラップすることはできません、 <xref:System.Activities.Statements.Interop> アクティビティ。 一部の WF 3 アクティビティなど、 <xref:System.Workflow.Activities.DelayActivity>, 、これは、類似する WF 4.5 アクティビティがあるためです。 その他のアクティビティの場合、これはそのアクティビティの機能がサポートされないことが原因です。 多くの WF 3 システム標準アクティビティによってラップしたワークフロー内で使用できます、 <xref:System.Activities.Statements.Interop> アクティビティは、次の制限を受けます。  
+  
+1.  <xref:System.ServiceModel.Activities.Send> と <xref:System.ServiceModel.Activities.Receive> では使用できません、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+2.  <xref:System.Workflow.Activities.WebServiceInputActivity>, 、<xref:System.Workflow.Activities.WebServiceOutputActivity>, 、および <xref:System.Workflow.Activities.WebServiceFaultActivity> 内で使用されることはできません、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+3.  <xref:System.Workflow.Activities.InvokeWorkflowActivity> 内で使用されることはできません、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+4.  <xref:System.Workflow.ComponentModel.SuspendActivity> 内で使用されることはできません、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+5.  補正に関連するアクティビティを使用できない、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+ 内の WF 3 アクティビティの使用に関して理解できるいくつかの動作仕様もあります、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+1.  WF 3 アクティビティに含まれている、 <xref:System.Activities.Statements.Interop> アクティビティがするときに初期化、 <xref:System.Activities.Statements.Interop> アクティビティが実行されます。 WF 4.5 には、実行前にワークフロー インスタンスの初期化フェーズはありません。  
+  
+2.  そのトランザクションの開始位置に関係なく、トランザクションの開始時に、WF 4.5 ランタイムはワークフロー インスタンス状態を確認できません (内部または外部で、 <xref:System.Activities.Statements.Interop> アクティビティ)。  
+  
+3.  内のアクティビティに関する WF 3 追跡レコード、 <xref:System.Activities.Statements.Interop> として WF 4.5 の追跡参加要素に提供されます <xref:System.Activities.Tracking.InteropTrackingRecord> オブジェクトです。 <xref:System.Activities.Tracking.InteropTrackingRecord> の派生クラスは、 <xref:System.Activities.Tracking.CustomTrackingRecord>します。  
+  
+4.  WF 3 カスタム アクティビティからは、WF 3 ワークフロー ランタイム内とまったく同じ方法で、相互運用環境内でワークフロー キューを使用してデータにアクセスできます。 カスタム アクティビティ コードの変更は必要ありません。 ホストで、データが追加、WF 3 ワークフロー キューを再開することで、 <xref:System.Activities.Bookmark>します。 ブックマークの名前の文字列の形式は、 <xref:System.IComparable> ワークフロー キューの名前。  
+  
+## <a name="see-also"></a>「  
+ [.NET Framework 4.5 ワークフローでの .NET Framework 3.0 または .NET Framework 3.5 アクティビティの使用](../../../docs/framework/windows-workflow-foundation/samples/using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/net-framework-4-5-built-in-activity-library.md b/docs/framework/windows-workflow-foundation/net-framework-4-5-built-in-activity-library.md
new file mode 100644
index 00000000000..cf37730eaaf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/net-framework-4-5-built-in-activity-library.md
@@ -0,0 +1,40 @@
+---
+title: ".NET Framework 4.5 ビルトイン アクティビティ ライブラリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e559e87b-6aed-491d-9546-e92bcec16fdf
+caps.latest.revision: 30
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 30
+---
+# .NET Framework 4.5 ビルトイン アクティビティ ライブラリ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、拡張された機能を持つ新しいアクティビティ ライブラリが含まれています。アクティビティには次の型があります。  
+  
+-   [制御フロー](../../../docs/framework/windows-workflow-foundation//control-flow-activities-in-wf.md)  
+  
+-   [フローチャート](../../../docs/framework/windows-workflow-foundation//flowchart-activities-in-wf.md)  
+  
+-   [ステート マシン](../../../docs/framework/windows-workflow-foundation//state-machine-activities-in-wf.md)  
+  
+-   [メッセージング アクティビティ](../../../docs/framework/wcf/feature-details/messaging-activities.md)  
+  
+-   [ランタイム](../../../docs/framework/windows-workflow-foundation//runtime-activities-in-wf.md)  
+  
+-   [プリミティブ](../../../docs/framework/windows-workflow-foundation//primitives-activities-in-wf.md)  
+  
+-   [トランザクション](../../../docs/framework/windows-workflow-foundation//transaction-activities-in-wf.md)  
+  
+-   [コレクション](../../../docs/framework/windows-workflow-foundation//collection-activities-in-wf.md)  
+  
+-   [エラー処理](../../../docs/framework/windows-workflow-foundation//error-handling-activities-in-wf.md)  
+  
+-   [移行](../../../docs/framework/windows-workflow-foundation//migration-activity-in-wf.md)  
+  
+ 組み込みのアクティビティ ライブラリのアクティビティを構成してワークフローを作成できるし、またはカスタム アクティビティと一緒に使用できます。組み込みのアクティビティ ライブラリのアクティビティはシールされています。これらの使用目的は、継承によって新しい機能を作成することではありません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/non-persisted-workflow-instances.md b/docs/framework/windows-workflow-foundation/non-persisted-workflow-instances.md
new file mode 100644
index 00000000000..cb1664cee7f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/non-persisted-workflow-instances.md
@@ -0,0 +1,77 @@
+---
+title: "非永続化ワークフロー インスタンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5e01af77-6b14-4964-91a5-7dfd143449c0
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 非永続化ワークフロー インスタンス
+状態が永続するワークフローの新しいインスタンスを <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> に作成すると、サービス ホストはそのサービスのエントリをインスタンス ストアに作成します。その後、ワークフロー インスタンスが初めて永続化されると、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> は現在のインスタンス状態を格納します。ワークフローが Windows プロセス アクティブ化サービスにホストされている場合は、インスタンスが初めて永続化するとサービス配置データもインスタンス ストアに書き込まれます。  
+  
+ ワークフロー インスタンスが永続化されていない場合、インスタンスの状態は**非永続化**状態です。この状態の場合、アプリケーション ドメインのリサイクル、ホストの障害、またはコンピューターの障害の後にワークフロー インスタンスを回復することはできません。  
+  
+## 非永続化状態  
+ 次のような場合、まだ永続化されていない永続性ワークフロー インスタンスが非永続的状態のままになります。  
+  
+-   ワークフロー インスタンスが初めて永続化される前にサービス ホストがクラッシュした場合。ワークフロー インスタンスはインスタンス ストアに残り、回復されません。関連付けられるメッセージが受信されると、ワークフロー インスタンスが再びアクティブになります。  
+  
+-   ワークフロー インスタンスが初めて永続化される前にインスタンスで例外が発生した場合。返される <xref:System.Activities.UnhandledExceptionAction> に応じて、次のシナリオが発生します。  
+  
+    -   <xref:System.Activities.UnhandledExceptionAction> が <xref:System.Activities.UnhandledExceptionAction> に設定されている場合:  例外が発生すると、サービス配置情報がインスタンス ストアに書き込まれ、ワークフロー インスタンスがメモリからアンロードされます。ワークフロー インスタンスは非永続化状態となり、再読み込みできません。  
+  
+    -   <xref:System.Activities.UnhandledExceptionAction> が <xref:System.Activities.UnhandledExceptionAction> または <xref:System.Activities.UnhandledExceptionAction> に設定されている場合:  例外が発生すると、サービス配置情報がインスタンス ストアに書き込まれ、アクティビティ インスタンスの状態が <xref:System.Activities.ActivityInstanceState> に設定されます。  
+  
+ アンロードされている非永続化ワークフロー インスタンスが発生するリスクを最低限に抑えるため、ライフサイクルの早い段階でワークフローを永続化することをお勧めします。  
+  
+## 非永続化インスタンスの検出と削除  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> は非永続化ワークフロー インスタンスをインスタンス ストアから削除しません。非永続化ワークフロー インスタンスが関連付けられている期限切れのロックの所有者も削除されません。  
+  
+ 管理者は定期的にインスタンス ストアの非永続化インスタンスを調べることをお勧めします。管理者はこのワークフローが相関メッセージを受信しないことがわかっている限り、これらのインスタンスをインスタンス ストアから削除することができます。たとえば、数か月にわたってデータベースに残っているインスタンスがある場合、そのワークフローの通常の有効期間が数日程度なら、クラッシュした初期化済みのインスタンスと見なしても問題ありません。  
+  
+ SQL Workflow Instance Store 内の非永続化インスタンスを見つけるには、次の SQL クエリを使用できます。  
+  
+-   このクエリは、まだ永続化されていないすべてのインスタンスを検索し、その ID と作成時刻 \(UTC 時刻で格納\) を返します。  
+  
+    ```sql  
+    select InstanceId, CreationTime   
+        from [System.Activities.DurableInstancing].[Instances]   
+        where IsInitialized = 0  
+    ```  
+  
+-   このクエリは、まだ永続化されておらず、読み込まれてもいないすべてのインスタンスを検索し、その ID と作成時刻 \(UTC 時刻で格納\) を返します。  
+  
+    ```sql  
+    select InstanceId, CreationTime   
+        from [System.Activities.DurableInstancing].[Instances]   
+        where IsInitialized = 0   
+            and CurrentMachine is NULL  
+    ```  
+  
+-   このクエリは、まだ永続化されていない中断されたすべてのインスタンスを検索し、その ID、作成時刻 \(UTC 時刻で格納\)、中断の理由、およびその例外名を返します。  
+  
+    ```sql  
+    select InstanceId, CreationTime, SuspensionReason, SuspensionExceptionName   
+        from [System.Activities.DurableInstancing].[Instances]   
+        where IsInitialized = 0   
+            and IsSuspended = 1  
+    ```  
+  
+ 非永続化インスタンスを削除する際は注意してください。一般に、<xref:System.ServiceModel.Activities.WorkflowServiceHost> によって作成された非永続化インスタンスは、中断されている場合や読み込まれていない場合は安全に削除できます。これらの特定のインスタンスは、次の SQL コマンドを正しいインスタンス ID に置き換えて使用し、`[System.Activities.DurableInstancing].[Instances]` ビューから削除することで、ストアから削除することが可能です。  
+  
+```sql  
+delete [System.Activities.DurableInstancing].[Instances]   
+    where InstanceId=’078a9bc4-ada5-4f9e-8cce-b0eb0009995f’  
+  
+```  
+  
+> [!WARNING]
+>  作成されたばかりでまだ永続化されていないインスタンスもあるため、非永続的インスタンスをすべて削除することはお勧めしません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/overview.md b/docs/framework/windows-workflow-foundation/overview.md
new file mode 100644
index 00000000000..59418dc4582
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/overview.md
@@ -0,0 +1,50 @@
+---
+title: "Windows Workflow の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fc44adbe-1412-49ae-81af-0298be44aae6
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# Windows Workflow の概要
+ワークフローは *"アクティビティ"* と呼ばれる要素の集まりであり、これらは実際の業務手順を聞モデルとして保存されます。ワークフローでは、短期間だけ行われる業務や長期間にわたって行われる業務の各部分の実行順序と、それらの間の依存関係を表すことができます。このような業務はモデルの最初から最後まで通して行われます。アクティビティには、人間によって実行されるものと、システム機能によって実行されるものがあります。  
+  
+## ワークフロー ランタイム エンジン  
+ 実行されるそれぞれのワークフロー インスタンスは、ホスト プロセスが次のいずれかを通して対話するプロセス内ランタイム エンジンによって作成および保持されます。  
+  
+-   <xref:System.Activities.WorkflowInvoker>。メソッドのようにワークフローを呼び出します。  
+  
+-   <xref:System.Activities.WorkflowApplication>。1 つのワークフロー インスタンスの実行に対して明示的な制御を行います。  
+  
+-   <xref:System.ServiceModel.WorkflowServiceHost>。複数のインスタンスを使用する場合にメッセージ ベースの対話を行います。  
+  
+ これらの各クラスは、アクティビティの実行に関与する <xref:System.Activities.ActivityInstance> として表されるコアのアクティビティ ランタイムをラップします。実行するアプリケーション ドメイン内では、同時に複数の <xref:System.Activities.ActivityInstance> オブジェクトを使用できます。  
+  
+ 前述のホストと対話する 3 つのオブジェクトは、それぞれワークフロー プログラムと呼ばれるアクティビティのツリーから作成されます。ワークフローは、これらの型を使用するか、<xref:System.Activities.ActivityInstance> をラップするカスタムのホストを使用して、コンソール アプリケーション、フォームに基づくアプリケーション、Windows サービス、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] Web サイト、[!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスなどの任意の Windows プロセス内で実行できます。  
+  
+ ![ホスト プロセス内のワークフローのコンポーネント](../../../docs/framework/windows-workflow-foundation//media/44c79d1d-178b-4487-87ed-3e33015a3842.png "44c79d1d\-178b\-4487\-87ed\-3e33015a3842")  
+ホスト プロセス内のワークフローのコンポーネント  
+  
+## ワークフロー コンポーネント間の対話  
+ 次の図は、ワークフロー コンポーネントが互いにどのように対話するかを示しています。  
+  
+ ![ワークフローの相互作用](../../../docs/framework/windows-workflow-foundation//media/workflowinteraction.gif "WorkflowInteraction")  
+  
+ 前の図では、複数のワークフロー インスタンスを呼び出すために、<xref:System.Activities.WorkflowInvoker> クラスの <xref:System.Activities.WorkflowInvoker.Invoke%2A> メソッドが使用されます。<xref:System.Activities.WorkflowInvoker> は、ホストからの管理が不要な軽量のワークフローに使用されます。ホストからの管理が必要なワークフロー \(<xref:System.Activities.Bookmark> の再開など\) は、代わりに <xref:System.Activities.WorkflowApplication.Run%2A> を使用して実行する必要があります。他のワークフロー インスタンスを呼び出す前に、現在のワークフロー インスタンスが完了するのを待機する必要はありません。ランタイム エンジンでは、複数のワークフロー インスタンスの同時実行をサポートしています。呼び出されるワークフローは次のとおりです。  
+  
+-   <xref:System.Activities.Statements.WriteLine> 子アクティビティを含む <xref:System.Activities.Statements.Sequence> アクティビティ。親アクティビティの <xref:System.Activities.Variable> は、子アクティビティの <xref:System.Activities.InArgument> にバインドされます。変数、引数、およびバインド[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[変数と引数](../../../docs/framework/windows-workflow-foundation//variables-and-arguments.md)」を参照してください。  
+  
+-   `ReadLine` という名前のカスタム アクティビティ。<xref:System.Activities.WorkflowInvoker.Invoke%2A> メソッドの呼び出しに対して `ReadLine` アクティビティの <xref:System.Activities.OutArgument> が返されます。  
+  
+-   <xref:System.Activities.CodeActivity> 抽象クラスから派生するカスタム アクティビティ。<xref:System.Activities.CodeActivity> は、<xref:System.Activities.CodeActivity.Execute%2A> メソッドのパラメーターとして使用可能な <xref:System.Activities.CodeActivityContext> を使用して、ランタイム機能 \(追跡やプロパティなど\) にアクセスできます。これらのランタイム機能[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ワークフロー追跡とトレース](../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)」、および「[ワークフロー実行プロパティ](../../../docs/framework/windows-workflow-foundation//workflow-execution-properties.md)」を参照してください。  
+  
+## 参照  
+ [BizTalk Server 2006 または WF?プロジェクトに最適なワークフロー ツールの選択](http://go.microsoft.com/fwlink/?LinkId=154901)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/pausing-and-resuming-a-workflow.md b/docs/framework/windows-workflow-foundation/pausing-and-resuming-a-workflow.md
new file mode 100644
index 00000000000..88df64b6342
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/pausing-and-resuming-a-workflow.md
@@ -0,0 +1,119 @@
+---
+title: "ワークフローの一時停止と再開 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 11f38339-79c7-4295-b610-24a7223bbf6d
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ワークフローの一時停止と再開
+ワークフローはブックマークや <xref:System.Activities.Statements.Delay> などのブロッキング アクティビティへの応答として一時停止および再開をしますが、永続化を使用して、明示的に一時停止、アンロード、再開することもできます。  
+  
+## ワークフローの一時停止  
+ ワークフローを一時停止するには、<xref:System.Activities.WorkflowApplication.Unload%2A> を使用します。このメソッドはワークフローの永続化とアンロードを要求し、ワークフローが 30 秒以内にアンロードしないと <xref:System.TimeoutException> をスローします。  
+  
+```csharp  
+try  
+{  
+    // attempt to unload will fail if the workflow is idle within a NoPersistZone  
+    application.Unload(TimeSpan.FromSeconds(5));  
+}  
+catch (TimeoutException e)  
+{  
+    Console.WriteLine(e.Message);  
+}  
+  
+```  
+  
+## ワークフローの再開  
+ 以前に一時停止およびアンロードされているワークフローを再開するには、<xref:System.Activities.WorkflowApplication.Load%2A> を使用します。このメソッドは、ワークフローを永続化ストアからメモリに読み込みます。  
+  
+```csharp  
+WorkflowApplication application = new WorkflowApplication(activity);  
+application.InstanceStore = instanceStore;  
+application.Load(id);  
+  
+```  
+  
+## 例  
+ 次のコード例は、永続化を使用してワークフローを一時停止および再開する方法を示しています。  
+  
+```csharp  
+static string bkName = "bkName";  
+static void Main(string[] args)   
+{  
+    StartAndUnloadInstance();  
+}  
+  
+static void StartAndUnloadInstance()   
+{  
+    AutoResetEvent waitHandler = new AutoResetEvent(false);  
+    WorkflowApplication wfApp = new WorkflowApplication(GetDelayedWF());  
+    SqlWorkflowInstanceStore instanceStore = SetupSqlpersistenceStore();  
+    wfApp.InstanceStore = instanceStore;  
+    wfApp.Extensions.Add(SetupMyFileTrackingParticipant);  
+    wfApp.PersistableIdle = (e) => {          ///persists application state and remove it from memory   
+    return PersistableIdleAction.Unload;  
+    };  
+    wfApp.Unloaded = (e) => {  
+        waitHandler.Set();  
+    };  
+    Guid id = wfApp.Id;  
+    wfApp.Run();  
+    waitHandler.WaitOne();  
+    LoadAndCompleteInstance(id);  
+}  
+  
+static void LoadAndCompleteInstance(Guid id)   
+{            
+    Console.WriteLine("Press <enter> to load the persisted workflow");  
+    Console.ReadLine();  
+    AutoResetEvent waitHandler = new AutoResetEvent(false);  
+    WorkflowApplication wfApp = new WorkflowApplication(new Workflow1());  
+    wfApp.InstanceStore =  
+        new SqlWorkflowInstanceStore(ConfigurationManager.AppSettings["SqlWF4PersistenceConnectionString"].ToString());  
+    wfApp.Completed = (workflowApplicationCompletedEventArgs) => {  
+        Console.WriteLine("\nWorkflowApplication has Completed in the {0} state.",  
+            workflowApplicationCompletedEventArgs.CompletionState);  
+    };  
+    wfApp.Unloaded = (workflowApplicationEventArgs) => {  
+        Console.WriteLine("WorkflowApplication has Unloaded\n");  
+        waitHandler.Set();  
+    };  
+    wfApp.Load(id);  
+    wfApp.Run();  
+    waitHandler.WaitOne();  
+}  
+  
+public static Activity GetDelayedWF()   
+{  
+    return new Sequence {  
+        Activities ={  
+            new WriteLine{Text="Workflow Started"},  
+            new Delay{Duration=TimeSpan.FromSeconds(10)},  
+            new WriteLine{Text="Workflow Ended"}  
+        }  
+    };  
+}  
+  
+private static SqlWorkflowInstanceStore SetupSqlpersistenceStore()   
+{   
+     string connectionString = ConfigurationManager.AppSettings["SqlWF4PersistenceConnectionString"].ToString();  
+    SqlWorkflowInstanceStore sqlWFInstanceStore = new SqlWorkflowInstanceStore(connectionString);  
+    sqlWFInstanceStore.InstanceCompletionAction = InstanceCompletionAction.DeleteAll;  
+    InstanceHandle handle = sqlWFInstanceStore.CreateInstanceHandle();  
+    InstanceView view = sqlWFInstanceStore.Execute(handle, new CreateWorkflowOwnerCommand(), TimeSpan.FromSeconds(5));  
+    handle.Free();  
+    sqlWFInstanceStore.DefaultInstanceOwner = view.InstanceOwner;  
+    return sqlWFInstanceStore;  
+}  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/performance.md b/docs/framework/windows-workflow-foundation/performance.md
new file mode 100644
index 00000000000..1801770a8e5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/performance.md
@@ -0,0 +1,480 @@
+---
+title: "Windows Workflow Foundation 4 のパフォーマンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 67d2b3e8-3777-49f8-9084-abbb33b5a766
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# Windows Workflow Foundation 4 のパフォーマンス
+Dustin Metzgar  
+  
+ Wenlong Dong  
+  
+ Microsoft Corporation、2010 年 9 月  
+  
+ Microsoft [!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] には [!INCLUDE[wf](../../../includes/wf-md.md)] のメジャー リビジョンが含まれ、パフォーマンスに多大な投資をしています。この新しいリビジョンでは、.NET Framework 3.0 および [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] の一部として提供されている [!INCLUDE[wf1](../../../includes/wf1-md.md)] の以前のバージョンからデザインが大幅に変更されています。プログラミング モデル、ランタイム、およびパフォーマンスと操作性が大幅に向上するツールの基本機能に基づいて再設計されています。このトピックでは、これらのリビジョンの重要なパフォーマンス上の特徴を説明し、以前のバージョンと比較します。  
+  
+ WF3 と WF4 を比較すると、個々のワークフロー コンポーネントのパフォーマンスが桁違いに向上しています。これにより、手動コーディングの [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] サービスと [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービスとのギャップが微小になります。WF4 でワークフローの待機時間は大幅に短縮されました。永続化のパフォーマンスは 2.5 ～ 3.0 倍向上しています。ワークフロー追跡による状態監視のオーバーヘッドも格段に短縮されました。これらの要因はアプリケーション内で WF4 に移行する、または WF4 を導入する理由として説得力があります。  
+  
+## 用語  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] で紹介される [!INCLUDE[wf1](../../../includes/wf1-md.md)] のバージョンは、このトピックではこれから WF4 として言及されます。[!INCLUDE[wf1](../../../includes/wf1-md.md)] は .NET 3.0 で紹介され、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] SP1 でいくつかの小さな変更がありました。また、以後 [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] バージョンの Workflow Foundation を WF3 と呼びます。WF3 は WF4 とともに [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] に付属しています。[!INCLUDE[crabout](../../../includes/crabout-md.md)] では WF3 の成果物を WF4 に移行しています。『[Windows Workflow Foundation 4 移行ガイド](http://go.microsoft.com/fwlink/?LinkID=153313)』を参照してください  
+  
+ [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] は、サービス指向のアプリケーションを構築するための Microsoft の統一プログラミング モデルです。当初は WF3 と共に .NET 3.0 の一部として導入されましたが、現在では [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の重要なコンポーネントになっています。  
+  
+ Windows Server AppFabric はインターネット インフォメーション サービス \(IIS\) 上で実行する Web アプリケーションおよび複合アプリケーションの構築、拡張、および管理を容易にする一連の統合テクノロジです。監視およびサービスとワークフローの管理を行うためのツールを提供します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Server AppFabric](http://msdn.microsoft.com/windowsserver/ee695849.aspx)  
+  
+## 目的  
+ このトピックの目的は、WF4 のパフォーマンス特性のさまざまな状況での測定データを示し、WF4 と WF3 を詳細に比較して、新しいリビジョンでの大幅な機能強化について説明することです。この記事のシナリオとデータは WF4 と WF3 のさまざまな側面の基本的なコストを定量化しています。このデータは WF4 のパフォーマンス特性を理解するうえで役立ちます。また、WF3 から WF4 への移行計画または WF4 を使用したアプリケーション開発に役立つことがあります。ただし、この記事に記載されているデータから結論を導き出す場合には注意が必要です。複合ワークフロー アプリケーションのパフォーマンスは、ワークフローの実装方法や異なるコンポーネントの統合方法に大きく依存します。アプリケーションのパフォーマンス特性を確認するには、各アプリケーションを測定する必要があります。  
+  
+## WF4 のパフォーマンスの強化の概要  
+ WF4 は慎重に設計され、高いパフォーマンスとスケーラビリティが実装されています。これらについて、次のセクションで説明します。  
+  
+### WF ランタイム  
+ [!INCLUDE[wf1](../../../includes/wf1-md.md)] ランタイムの中核は、ワークフロー内のアクティビティを実行する非同期スケジューラです。非同期スケジューラはアクティビティに高パフォーマンスで予測可能な実行環境を提供します。この環境には実行、継続、完了、キャンセル、例外に関する明確に定義されたコントラクトと予測可能なスレッド モデルがあります。  
+  
+ WF4 ランタイムのスケジューラは WF3 のスケジューラより効率的です。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] と同じ I\/O スレッド プールを利用し、バッチ作業項目をきわめて効率的に実行します。内部作業項目のスケジューラ キューは一般的な使用パターンに合わせて最適化されています。また、WF4 ランタイムは同期およびイベント処理のロジックを最小限に抑えたきわめてコンパクトな方法で実行状態を管理するのに対し、WF3 は大規模なイベントの登録と呼び出しに依存して状態遷移のための複雑な同期を実行します。  
+  
+### データの格納とフロー  
+ WF3 では、アクティビティに関連付けられたデータは <xref:System.Windows.DependencyProperty> 型によって実装される依存関係プロパティを使用してモデル化されます。依存関係プロパティのパターンは [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] で導入されました。通常、このパターンはデータ バインドなどの UI 機能の簡単な操作をサポートするための高度な柔軟性を備えています。ただし、パターンを使用するには、ワークフロー定義にプロパティを静的フィールドとして定義する必要があります。[!INCLUDE[wf1](../../../includes/wf1-md.md)] ランタイムがプロパティ値を設定または取得するたびに、高負荷の検索ロジックが実行されます。  
+  
+ WF4 では、明確なデータ スコープ設定ロジックを使用することでワークフロー内のデータ処理方法が大幅に向上しています。WF4 は、変数と引数という 2 つの異なる概念を使用して、アクティビティに保存されたデータとアクティビティ境界間を移動するデータを区別します。変数と "In\/Out\/InOut" 引数の明確な階層スコープを使用することにより、アクティビティのデータの使用法の複雑さが大幅に緩和され、データの有効期間も自動的にスコープ設定されます。アクティビティには、引数によって表されるシグネチャが適切に定義されています。アクティビティを検査するだけで、予想される受け取りデータとアクティビティの実行結果として生成されるデータを知ることができます。  
+  
+ アクティビティは、WF3 ではワークフローの作成時に初期化されますが、WF4 では実行時にのみ初期化されます。これにより、新規ワークフローのインスタンスの作成時に初期化\/非初期化を行わずにアクティビティのライフサイクルを簡素化できるため、実行が効率化されます。  
+  
+### 制御フロー  
+ 他のプログラミング言語と同様、[!INCLUDE[wf1](../../../includes/wf1-md.md)] はシーケンス、ループ、分岐などのパターンに関する一連の制御フロー アクティビティを導入することによりワークフロー定義の制御フローをサポートします。WF3 では、同じアクティビティを再実行する必要がある場合に、新規の <xref:System.Workflow.ComponentModel.ActivityExecutionContext> を作成し、<xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> に基づく高負荷のシリアル化および逆シリアル化ロジックでアクティビティを複製します。通常、反復制御フローはアクティビティを順次実行する場合より時間がかかります。  
+  
+ WF4 の処理方法はまったく異なります。WF4 ではアクティビティ テンプレートを取得し、新規の ActivityInstance オブジェクトを作成してスケジューラ キューに追加します。このプロセスは明示的にオブジェクトを作成するだけなので、きわめて低負荷です。  
+  
+### 非同期プログラミング  
+ 通常、I\/O や分散コンピューティング処理などの実行時間の長いブロッキング操作に非同期プログラミングを使用することにより、アプリケーションのパフォーマンスとスケーラビリティは向上します。WF4 は基本アクティビティ型 <xref:System.Activities.AsyncCodeActivity>、<xref:System.Activities.AsyncCodeActivity%601> で非同期をサポートします。ランタイムは非同期アクティビティをネイティブに認識するため、非同期操作が保留状態の場合にインスタンスを自動的に非永続化ゾーンに配置できます。カスタム アクティビティをこれらの型から派生させることで、ワークフローのスケジューラ スレッドを保持したり、並行して実行される可能性があるすべてのアクティビティをブロックしたりすることなく、非同期操作を実行できます。  
+  
+### メッセージング  
+ 当初、WF3 のメッセージングのサポートは、外部イベントまたは Web サービスの呼び出しによるきわめて限定的なものでした。.Net 3.5 では、<xref:System.Workflow.Activities.SendActivity> および <xref:System.Workflow.Activities.ReceiveActivity> を使用して、ワークフローを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] クライアントとして実装したり、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとして公開することができるようになりました。WF4 では、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] メッセージング ロジックを WF に密接に統合することで、ワークフローベースのメッセージング プログラミングの概念がさらに強化されました。  
+  
+ .Net 4 の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] で提供されている統合メッセージ処理パイプラインにより、WF4 サービスのパフォーマンスとスケーラビリティは WF3 と比べて大幅に向上しています。WF4 ではメッセージング プログラミングのサポートも強化され、複雑なメッセージ交換パターン \(MEP\) をモデル化できます。開発者は、型指定されたサービス コントラクトを使用することで、プログラミングを簡素化できます。また、型指定されないサービス コントラクトを使用することで、シリアル化のコストをなくしてパフォーマンスを向上させることができます。WF4 の <xref:System.ServiceModel.Activities.SendMessageChannelCache> クラスを使用したクライアント側チャネルのキャッシュのサポートにより、少ない手間で短時間にアプリケーションを作成できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Send アクティビティのキャッシュ共有レベルの変更](../../../docs/framework/wcf/feature-details/changing-the-cache-sharing-levels-for-send-activities.md).  
+  
+### 宣言型プログラミング  
+ WF4 にはビジネス プロセスおよびサービスをモデル化するための単純明快な宣言型プログラミング フレームワークがあります。このプログラミング モデルは、完全な宣言型のアクティビティの作成をサポートし、コードの記述をなくしてワークフローの作成を大幅に簡素化します。[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、XAML ベースの宣言型プログラミング フレームワークが 1 つのアセンブリ System.Xaml.dll に統合され、WPF と WF の両方をサポートします。  
+  
+ WF4 では、XAML で完全な宣言型の記述を行い、ワークフローの定義全体を XML マークアップに定義して、.NET を使用して作成したアクティビティや型を参照できます。WF3 の XOML 形式の場合、この操作をカスタム分離コード ロジックなしで行うことは困難です。.Net 4 の新しい XAML スタックではワークフローの成果物をシリアル化\/逆シリアル化する際のパフォーマンスがはるかに向上し、宣言型プログラミングの魅力と信頼性を増しています。  
+  
+### ワークフロー デザイナー  
+ WF4 の完全な宣言型プログラミングのサポートでは、大規模なワークフローのデザイン時のパフォーマンスに関して、より高い要件を明示的に指定します。WF4 のワークフロー デザイナーは、WF3 のワークフロー デザイナーと比べて大規模なワークフローのスケーラビリティがはるかに向上しています。UI 仮想化のサポートにより、WF4 のデザイナーは 1,000 のアクティビティがある大規模なワークフローを数秒で簡単に読み込むことができますが、WF3 のデザイナーは数百のアクティビティがあるワークフローを読み込むこともほぼ不可能です。  
+  
+## コンポーネント レベルのパフォーマンス比較  
+ このセクションでは、WF3 ワークフローと WF4 ワークフローの個別のアクティビティを直接比較したデータについて説明します。永続性などの主要分野は、個々のアクティビティのコンポーネントよりパフォーマンスに重大な影響をもたらします。それでも、WF4 ではコンポーネントが手動コーディングによる調整ロジックと比肩するほど高速になっているため、個別コンポーネントのパフォーマンスの向上は重要です。その一例を次のセクション、「サービス構成シナリオ」で説明します。  
+  
+### 環境の設定  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+ 上の図は、コンポーネント レベルのパフォーマンス測定に使用するコンピューター構成を示しています。1 台のサーバーと 5 台のクライアントを 1 つの 1 Gbps イーサネット ネットワーク インターフェイスで接続します。測定を簡素化するため、サーバーは Windows Server 2008 x86 を実行するデュアル プロセッサ\/クアッド コア サーバーの 1 つのコアを使用する構成にします。システムの CPU 利用状況はほぼ 100% で推移します。  
+  
+### テストの詳細  
+ WF3 <xref:System.Workflow.Activities.CodeActivity> は WF3 ワークフローで使用可能な最も単純なアクティビティであると考えられます。アクティビティは、ワークフローのプログラマがカスタム コードを配置できる分離コード内のメソッドを呼び出します。WF4 には、同様の機能を提供する WF3 の <xref:System.Workflow.Activities.CodeActivity> に直接匹敵する機能はありません。WF4 の <xref:System.Activities.CodeActivity> 基本クラスは WF3 の <xref:System.Workflow.Activities.CodeActivity> とは関連がありません。ワークフロー作成者には、カスタム アクティビティを作成し、XAML のみのワークフローを構築することをお勧めします。以下のテストでは、WF4 ワークフローで `Comment` という名前のアクティビティが空の <xref:System.Workflow.Activities.CodeActivity> の代わりに使用されます。`Comment` アクティビティのコードを次に示します。  
+  
+```  
+[ContentProperty("Body")]  
+    public sealed class Comment : CodeActivity  
+    {  
+        public Comment()  
+            : base()  
+        {  
+        }  
+  
+        [DefaultValue(null)]  
+        public Activity Body  
+        {  
+            get;  
+            set;  
+        }  
+  
+        protected override void Execute(CodeActivityContext context)  
+        {  
+        }  
+    }  
+  
+```  
+  
+### 空のワークフロー  
+ このテストでは、子アクティビティがないシーケンス ワークフローを使用します。  
+  
+### 1 つのアクティビティ  
+ ワークフローは子アクティビティを 1 つ含むシーケンス ワークフローです。アクティビティは、WF3 の場合はコードなしの <xref:System.Workflow.Activities.CodeActivity>、WF4 の場合は `Comment` アクティビティです。  
+  
+### While の 1,000 回反復  
+ このシーケンス ワークフローには 1 つの <xref:System.Activities.Statements.While> アクティビティが含まれ、ループ内に何も処理しない 1 つの子アクティビティを含みます。  
+  
+### Replicator と ParallelForEach の比較  
+ WF3 の <xref:System.Workflow.Activities.ReplicatorActivity> には順次実行モードと並列実行モードがあります。順次モードのアクティビティのパフォーマンスは <xref:System.Workflow.Activities.WhileActivity> と同様です。並列実行で特に便利なアクティビティは <xref:System.Workflow.Activities.ReplicatorActivity> です。このアクティビティに類似した WF4 のアクティビティは <xref:System.Activities.Statements.ParallelForEach> です。  
+  
+ 次の図は、このテストに使用するワークフローを示しています。左側が WF3 ワークフロー、右側が WF4 ワークフローです。  
+  
+ ![WF3 ReplicatorActivity および WF4 ParallelForEach](../../../docs/framework/windows-workflow-foundation//media/replicatorandparallelforeach.gif "ReplicatorAndParallelForEach")  
+  
+### 5 つのアクティビティがあるシーケンシャル ワークフロー  
+ このテストは、複数のアクティビティを順番に実行した場合の効果を示すことを目的としています。シーケンス内には 5 つのアクティビティがあります。  
+  
+### トランザクション スコープ  
+ トランザクション スコープ テストはその他のテストと若干異なり、反復のたびに新しいワークフロー インスタンスを作成するのではなく、ワークフローは処理のない 1 つのアクティビティを含む <xref:System.Activities.Statements.TransactionScope> アクティビティを含む while ループで構造化されます。while ループで 50 回反復するバッチを 1 回実行するたびに 1 つの操作としてカウントされます。  
+  
+### 補正  
+ WF3 ワークフローには `WorkScope` という名前の補正可能アクティビティが 1 つあります。このアクティビティは単純に <xref:System.Workflow.ComponentModel.ICompensatableActivity> インターフェイスを実装します。  
+  
+```  
+class WorkScope :   
+        CompositeActivity, ICompensatableActivity  
+    {  
+        public WorkScope() : base() { }  
+  
+        public WorkScope(string name)  
+        {  
+            this.Name = name;  
+        }  
+  
+        public ActivityExecutionStatus Compensate(  
+            ActivityExecutionContext executionContext)  
+        {  
+            return ActivityExecutionStatus.Closed;  
+        }  
+    }  
+```  
+  
+ エラー ハンドラーは `WorkScope` アクティビティをターゲットにします。WF4 ワークフローも同様に単純です。<xref:System.Activities.Statements.CompensableActivity> には本文と補正ハンドラーがあります。明示的な補正はシーケンスの次に来ます。本文アクティビティと補正ハンドラー アクティビティはどちらも空の実装です。  
+  
+```  
+public sealed class CompensableActivityEmptyCompensation : CodeActivity  
+    {  
+        public CompensableActivityEmptyCompensation()  
+            : base() { }  
+  
+        public Activity Body { get; set; }  
+  
+        protected override void Execute(CodeActivityContext context) { }  
+    }  
+    public sealed class CompensableActivityEmptyBody : CodeActivity  
+    {  
+        public CompensableActivityEmptyBody()  
+            : base() { }  
+  
+        public Activity Body { get; set; }  
+  
+        protected override void Execute(CodeActivityContext context) { }  
+    }  
+  
+```  
+  
+ ![WF3 および WF の基本補正のワークフロー](../../../docs/framework/windows-workflow-foundation//media/basiccompensationworkflows.gif "BasicCompensationWorkflows")  
+  
+ 図 2 – WF3 \(左\) と WF4 \(右\) の基本的な補正ワークフロー  
+  
+### パフォーマンスのテスト結果  
+ ![パフォーマンスのテスト結果](../../../docs/framework/windows-workflow-foundation//media/performancedata.gif "PerformanceData")  
+  
+ ![パフォーマンス テスト データのグラフ](../../../docs/framework/windows-workflow-foundation//media/performancetestchart.gif "PerformanceTestChart")  
+  
+ トランザクション スコープ テスト以外のすべてのテストは 1 秒あたりのワークフローで測定されます。上で説明したように、[!INCLUDE[wf1](../../../includes/wf1-md.md)] ランタイムのパフォーマンスは全体的に向上しました。while ループのような同じアクティビティの複数の実行を必要とする分野では特に向上が顕著でした。  
+  
+## サービス構成シナリオ  
+ 前のセクション "コンポーネント レベルのパフォーマンス比較" に示したように、WF3 と WF4 を比較した場合にオーバーヘッドは大幅に短縮されています。[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービスは手動でコーディングした [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスにほぼ匹敵するパフォーマンスを実現し、[!INCLUDE[wf1](../../../includes/wf1-md.md)] ランタイムのあらゆる利点を備えています。このテスト シナリオでは、[!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと WF4 の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービスを比較します。  
+  
+### オンライン ストア サービス  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] の特徴の 1 つは、複数のサービスを使用してプロセスを作成できることです。この例として、2 つのサービスの呼び出しを調整して発注するオンライン ストア サービスがあります。まず、注文検証サービスを使用して注文を検証します。次に、ウェアハウス サービスを使用して注文を受け付けます。  
+  
+ 注文検証サービスとウェアハウス サービスの 2 つのバックエンド サービスは両方のテストで不変です。変更する部分は、調整を行うオンライン ストア サービスです。1 つのケースでは、サービスを [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスとして手動でコーディングします。もう 1 つのケースでは、サービスを WF4 の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービスとして記述します。追跡や永続化などの [!INCLUDE[wf1](../../../includes/wf1-md.md)] 固有の機能はこのテストでは無効にします。  
+  
+### 環境  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+ クライアントは複数のコンピューターから HTTP 経由でオンライン ストア サービスを要求します。1 台のコンピューターで 3 つのサービスのすべてをホストします。オンライン ストア サービスとバックエンド サービスの間にあるトランスポート層は TCP または HTTP です。1 秒あたりの操作は、オンライン ストア サービスに対する `PurchaseOrder` の呼び出しが完了した件数に基づいて測定されます。チャネル プールは WF4 で導入された新機能です。このテスト チャネル プールの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] の部分は標準では提供されていないため、オンライン ストア サービスでは単純なプール手法の手動コーディングによる実装を使用しました。  
+  
+### パフォーマンス  
+ ![オンライン ストア サービスのパフォーマンスのグラフ](../../../docs/framework/windows-workflow-foundation//media/onlinestoreperfgraph.gif "OnlineStorePerfGraph")  
+  
+ チャネル プールなしでバックエンド TCP サービスに接続した場合、[!INCLUDE[wf1](../../../includes/wf1-md.md)] サービスはスループットに 17.2% 影響します。チャネル プールを使用した場合、スループットは 23.8% 低下します。HTTP では影響ははるかに小さく、プールなしの場合で 4.3%、プールを使用した場合で 8.1% の影響があります。HTTP を使用する場合はチャネル プールのメリットがきわめて少ないことも重要な点です。  
+  
+ このテストでは、手動でコーディングした [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービスと比べると WF4 ランタイムにオーバーヘッドがありますが、これは最悪の場合のシナリオと考えることができます。このテストの 2 つのバックエンド サービスはほとんど処理を行いません。実際のエンド ツー エンドのシナリオでは、これらのサービスでデータベースの呼び出しなどの高負荷の操作を行うため、トランスポート層のパフォーマンスへの影響の重要性は低下します。また、WF4 で提供されている機能の長所により、Workflow Foundation はオーケストレーション サービスの作成に有効な選択肢になります。  
+  
+## パフォーマンスに関する重要な考慮事項  
+ WF4 では、このセクションの相互運用機能以外の機能分野は WF3 から大幅に変更されています。この変更はワークフロー アプリケーションのデザインおよびパフォーマンスに影響します。  
+  
+#### ワークフローのアクティブ化にかかる待機時間  
+ [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービス アプリケーションでは、ブロックが発生する可能性があるため、新規ワークフローの開始または既存ワークフローの読み込みにかかる待機時間は重要です。このテスト ケースでは、一般的なシナリオで WF3 XOML ホストを WF4 XAMLX ホストと比較して測定します。  
+  
+##### 環境の設定  
+ ![待機時間の環境設定およびスループット テスト](../../../docs/framework/windows-workflow-foundation//media/latencyandthroughputenvironment.gif "LatencyAndThroughputEnvironment")  
+  
+##### テストの設定  
+ このシナリオでは、クライアント コンピューターはコンテキスト ベースの相関関係を使用して [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ワークフロー サービスに接続します。コンテキスト相関関係は特殊なコンテキスト バインドを必要とし、コンテキスト ヘッダーまたはクッキーを使用してメッセージを適切なワークフロー インスタンスに関連付けます。相関関係 ID がメッセージ ヘッダーに存在するため、メッセージ本文を解析する必要がないというパフォーマンス上の利点があります。[!INCLUDE[crabout](../../../includes/crabout-md.md)] コンテキスト相関関係は以下を参照してください。[コンテキスト交換の相関関係](../../../docs/framework/wcf/feature-details/context-exchange-correlation.md)  
+  
+ サービスは要求を行う新しいワークフローを作成し、ワークフローの実行にかかった時間が待機時間の測定に含まれないように、すぐに応答を送信します。WF3 のワークフローは XOML と分離コードで構成され、WF4 のワークフローは全体が XAML で構成されます。WF4 のワークフローは次のようになります。  
+  
+ ![WF 4 相関スコープ](../../../docs/framework/windows-workflow-foundation//media/correlationscopeworkflow.gif "CorrelationScopeWorkflow")  
+  
+ <xref:System.ServiceModel.Activities.Receive> アクティビティはワークフロー インスタンスを作成します。受信メッセージに渡した値は応答メッセージにエコーされます。応答の後のシーケンスにはワークフローの残りの部分が含まれます。前の例では 1 つの Comment アクティビティのみを示しました。ワークフローの複雑さをシミュレーションするには、Comment アクティビティの数を変更します。comment アクティビティは何も処理しない WF3の <xref:System.Workflow.Activities.CodeActivity> と同等です。Comment アクティビティ [!INCLUDE[crabout](../../../includes/crabout-md.md)]、前のセクション "コンポーネント レベルのパフォーマンス比較" を参照してください。  
+  
+##### テスト結果  
+ ![待機時間の結果](../../../docs/framework/windows-workflow-foundation//media/latencyresultsgraph.gif "LatencyResultsGraph")  
+  
+ 図 3 – WCF ワークフロー サービスのコールド待機時間とウォーム待機時間  
+  
+ 上の図のコールドは、特定ワークフローに既存の <xref:System.ServiceModel.WorkflowServiceHost> が存在しない場合を示します。つまり、コールド待機時間は、ワークフローが初めて使用され、XOML または XAML をコンパイルする必要がある場合の待機時間です。ウォーム待機時間は、ワークフロー型が既にコンパイル済みの場合に新規ワークフロー インスタンスを作成する時間です。WF4 ではワークフローの複雑さによって大きな差は生じませんが、WF3 ではワークフローの複雑さに応じて時間がかかります。  
+  
+#### 相関スループット  
+ WF4 では新しいコンテンツ ベースの相関関係機能が導入されました。WF3 ではコンテキスト ベースの相関関係のみが提供されていました。コンテキスト ベースの相関関係は特定の [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] チャネル バインドに対してのみ実行可能です。チャネル バインドを使用する際に、ワークフロー ID がメッセージ ヘッダーに挿入されます。WF3 ランタイムでは、ID 以外でワークフローを識別することはできません。コンテンツ ベースの相関関係では、ワークフロー作成者はアカウント番号や顧客 ID などの関連するデータから相関関係キーを作成できます。コンテンツ ベースの相関関係 [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[コンテンツ ベースの相関関係。](../../../docs/framework/wcf/feature-details/content-based-correlation.md)」を参照してください。  
+  
+ コンテキスト ベースの相関関係には、相関関係キーがメッセージ ヘッダーに存在するというパフォーマンス上の利点があります。逆シリアル化やメッセージのコピーを行わずに相関関係キーをメッセージから読み取ることができます。コンテンツ ベースの相関関係では、相関関係キーはメッセージ本文に格納されます。キーの検索には XPath 式を使用します。この余分な処理のコストは、メッセージのサイズ、本文のキーの深さ、キーの数によって決まります。このテストでは、コンテキスト ベースの相関関係とコンテンツ ベースの相関関係を比較し、複数のキーを使用した場合のパフォーマンス低下を示します。  
+  
+#### 環境の設定  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+#### テストの設定  
+ ![相関スループットのワークフロー テスト](../../../docs/framework/windows-workflow-foundation//media/correlationthroughputworkflow.gif "CorrelationThroughputWorkflow")  
+  
+ 前のワークフローは、後のセクション、「永続性」で使用しているワークフローと同じです。永続化なしの相関関係テストでは、ランタイムに永続化プロバイダーがインストールされていません。相関関係は CreateOrder と CompleteOrder の 2 か所で発生します。  
+  
+#### テスト結果  
+ ![相関スループット](../../../docs/framework/windows-workflow-foundation//media/correlationthroughputgraph.gif "CorrelationThroughputGraph")  
+  
+ この図は、コンテンツ ベースの相関関係で使用するキーの数が増えた場合のパフォーマンスの低下を示しています。TCP と HTTP の曲線の類似性は、これらのプロトコルに関連するオーバーヘッドを示しています。  
+  
+#### 永続化を伴う相関関係  
+ 永続化されたワークフローでは、コンテンツ ベースの相関関係からの CPU 圧迫はワークフロー ランタイムから SQL データベースに移行します。SQL 永続化プロバイダー内のストアド プロシージャは、適切なワークフローを検索するためにキーの照合作業を実行します。  
+  
+ ![相関および永続化の結果](../../../docs/framework/windows-workflow-foundation//media/correlationandpersistencegraph.gif "CorrelationAndPersistenceGraph")  
+  
+ コンテキスト ベースの相関関係は、コンテンツ ベースの相関関係よりも高速です。ただし、永続化の方が相関関係よりパフォーマンスへの影響が大きいため、違いはあまり顕著ではありません。  
+  
+### 複合ワークフローのスループット  
+ ワークフローの複雑さを測定する要素はアクティビティの数だけではありません。複合アクティビティに複数の子が含まれ、その子も複合アクティビティである場合があります。入れ子のレベルの数が増えるほど、現在実行中の状態になり得るアクティビティの数と変数の数も増えます。このテストでは、複合ワークフローを実行する場合の WF3 と WF4 のスループットを比較します。  
+  
+### テストの設定  
+ これらのテストは、4 GB の RAM を搭載した Intel Xeon X5355 @ 2.66 GHz 4 ウェイのコンピューターで Windows Server 2008 x64 を使用して実行されました。テスト コードは、CPU 使用率が 100% に達するように、1 コアあたり 1 つのスレッドを使用する 1 つのプロセスで実行します。  
+  
+ このテスト用に生成されたワークフローには、各シーケンスのアクティビティの深さと数という 2 つの主な変数があります。各深さレベルには Parallel アクティビティ、while ループ、判断、割り当て、シーケンスが含まれます。下図の WF4 のデザイナーは、トップレベルのフローチャートを示しています。各フローチャートのアクティビティはメイン フローチャートと相似しています。深さがテストのパラメーターに制限されるこのワークフローを図示する場合、フラクタルを考慮すると役立つことがあります。  
+  
+ 特定のテストのアクティビティの数は、1 シーケンスあたりのアクティビティの深さと数によって決まります。WF4 のテストのアクティビティの数は、次の数式によって計算します。  
+  
+ ![アクティビティ数の計算式](../../../docs/framework/windows-workflow-foundation//media/numberofactivitiesequation.gif "NumberOfActivitiesEquation")  
+  
+ WF3 のテストには追加シーケンスがあるため、アクティビティの数を計算する数式が多少異なります。  
+  
+ ![アクティビティ数の計算式](../../../docs/framework/windows-workflow-foundation//media/w3numberofactivitiesequation.gif "W3NumberOfActivitiesEquation")  
+  
+ d は 1 シーケンスあたりのアクティビティの深さ、a は 1 シーケンスあたりのアクティビティの数を表します。これらの数式では、最初の定数 × a はシーケンスの数を表し、2 番目の定数は現在のレベルのアクティビティの静的な数を表します。各フローチャートに 3 つのフローチャート子アクティビティがあります。ボトム レベルの深さのフローチャートは空で、それ以外のレベルにはメイン フローチャートのコピーがあります。各テスト バリエーションのワークフロー定義内のアクティビティの数を次の表に示します。  
+  
+ ![各テストで使用されるアクティビティの数を比較する](../../../docs/framework/windows-workflow-foundation//media/comparechart.gif "CompareChart")  
+  
+ ワークフロー定義内のアクティビティの数は、各深さレベルに従って急激に増加します。ただし、特定のワークフロー インスタンスで実行されるパスは判断ポイントごとに 1 つのみであるため、実際のアクティビティのごく小規模なサブセットのみが実行されます。  
+  
+ ![複合ワークフロー](../../../docs/framework/windows-workflow-foundation//media/complexworkflowthroughputworkflow.gif "ComplexWorkflowThroughputWorkflow")  
+  
+ 同等のワークフローが WF3 用にも作成されました。WF3 デザイナーは入れ子ではなく、ワークフロー全体をデザイン領域に表示するので、このトピックの表示内容としては大きすぎます。ワークフローのスニペットを以下に示します。  
+  
+ ![WF3 ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wf3workflow.gif "WF3Workflow")  
+  
+ 入れ子の極端なケースを実行するため、このテストの一部となるもう 1 つのワークフローでは 100 回入れ子になったシーケンスを使用します。最も内側のシーケンスには 1 つの `Comment` または <xref:System.Workflow.Activities.CodeActivity> があります。  
+  
+ ![入れ子になったシーケンス](../../../docs/framework/windows-workflow-foundation//media/nestedsequencewf.gif "NestedSequenceWF")  
+  
+ 追跡および永続化はこのテストに含まれません。  
+  
+### テスト結果  
+ ![スループットのグラフ](../../../docs/framework/windows-workflow-foundation//media/testresults1.gif "TestResults1")  
+  
+ アクティビティの深さと数が多い複合ワークフローの場合でも、パフォーマンス結果は前述した他のスループット数値と整合しています。WF4 のスループットは桁違いに高速なため、対数スケールで比較する必要があります。  
+  
+### メモリ  
+ Windows Workflow Foundation のメモリ オーバーヘッドは、2 つの重要な要素であるワークフローの複雑さとワークフロー定義の数で測定されます。メモリの測定は Windows 7 の 64 ビット ワークステーションで行われました。ワーキング セットのサイズの測定データを取得するには、パフォーマンス カウンターを監視する、Environment.WorkingSet をポーリングする、[VMMap](http://technet.microsoft.com/sysinternals/dd535533.aspx) から提供されている VMMap などのツールを使用するなど、さまざまな方法があります。ここでは複数の方法を組み合わせて各テストの結果を取得し、検証しました。  
+  
+### ワークフローの複雑さテスト  
+ ワークフローの複雑さテストでは、ワークフローの複雑さに基づいてワーキング セットの違いを測定します。前のセクションで使用した複合ワークフローの他に、1 つのアクティビティ ワークフローと 1,000 のアクティビティがあるシーケンスという 2 つの基本ケースを取り入れるための新しいバリエーションを追加します。これらのテストでは、ワークフローを初期化し、1 分間の単一シリアル ループ内で完了するまで実行します。各テスト バリエーションを 3 回実行し、その平均データを記録しました。  
+  
+ 新しい 2 つの基本テストには次のようなワークフローがあります。  
+  
+ ![複合ワークフロー](../../../docs/framework/windows-workflow-foundation//media/complexworkflowboth.gif "ComplexWorkflowBoth")  
+  
+ 前の WF3 のワークフローでは、空の <xref:System.Workflow.Activities.CodeActivity> アクティビティを使用しています。前の WF4 ワークフローでは `Comment` アクティビティを使用しています。`Comment` アクティビティについては前の「コンポーネント レベルのパフォーマンス比較」で説明しました。  
+  
+ ![メモリ使用量グラフ](../../../docs/framework/windows-workflow-foundation//media/complexmemoryusage.gif "ComplexMemoryUsage")  
+  
+ この図で注目すべき明白な傾向の 1 つは、WF3 および WF4 のいずれの場合も入れ子がメモリ使用量に与える影響が比較的小さいことです。メモリに最も重大な影響をもたらす要因はワークフロー内のアクティビティの数です。シーケンス 1,000、複合深さ 5 シーケンス 5、複合深さ 7 シーケンス 1 \(バリエーションあり\) の各データから、アクティビティの数が千単位になるとメモリ使用量の増加が顕著になることが明らかです。最大 29 K のアクティビティが存在する極端なケース \(深さ 7 シーケンス 1\) では、WF4 のメモリ使用量は WF3 より約 79% 少なくなっています。  
+  
+### 複数のワークフロー定義のテスト  
+ ワークフロー定義ごとのメモリの測定は、WF3 と WF4 でワークフローのホスティングに使用できるオプションが原因で 2 つの異なるテストに分かれています。このテストでは、ワークフローの複雑さテストと異なり、指定されたワークフローのインスタンス化と実行を定義ごとに 1 回だけ行います。これは、ワークフロー定義とそのホストは AppDomain の有効期間中はメモリ内に保持されるためです。指定されたワークフロー インスタンスの実行によって使用されたメモリは、ガベージ コレクション中にクリーンアップする必要があります。WF4 の移行ガイドラインに、ホスト オプションの詳細が記載されています。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]、「[WF 移行の詳細: ワークフロー ホスティング](http://go.microsoft.com/fwlink/?LinkID=153313)」を参照してください。  
+  
+ ワークフロー定義テスト用に多数のワークフロー定義を作成するには、いくつかの方法があります。たとえば、コード生成を使用して、名前以外は同一の 1,000 のワークフローを作成し、各ワークフローを個別のファイルに保存します。この方法はコンソール ホストのテストで使用しました。WF3 では、ワークフロー定義の実行に <xref:System.Workflow.Runtime.WorkflowRuntime> クラスを使用します。WF4 は <xref:System.Activities.WorkflowApplication> を使用して単一ワークフロー のインスタンスを作成するか、直接 <xref:System.Activities.WorkflowInvoker> を使用してアクティビティがメソッドに呼び出された場合のように実行できます。<xref:System.Activities.WorkflowApplication> は単一ワークフロー のインスタンスのホストで、<xref:System.Workflow.Runtime.WorkflowRuntime> に類似した機能を持つため、このテストで使用しました。  
+  
+ IIS でワークフローをホストする場合、<xref:System.Web.Hosting.VirtualPathProvider> を使用することで、すべての XAMLX または XOML ファイルを生成するのではなく、新しい <xref:System.ServiceModel.WorkflowServiceHost> を作成することができます。<xref:System.Web.Hosting.VirtualPathProvider> は受信要求を処理し、データベースから読み込み可能な、またはこの場合は実行時に生成可能な "仮想ファイル" を使用して応答します。したがって、1,000 個の物理ファイルを作成する必要はありません。  
+  
+ コンソール テストで使用したワークフロー定義はアクティビティが 1 つの単純なシーケンシャル ワークフローです。1 つのアクティビティは、WF3 の場合は空の <xref:System.Workflow.Activities.CodeActivity>、WF4 の場合は `Comment` アクティビティでした。IIS でホストするケースでは、メッセージの受信で開始し、応答の送信で終了するワークフローを使用しました。  
+  
+ ![WF3 および WF4 でのワークフロー サービス](../../../docs/framework/windows-workflow-foundation//media/receiveworkflowboth.gif "ReceiveWorkflowBoth")  
+  
+ 図 4 \- ReceiveActivity を使用した WF3 ワークフローと要求\/応答パターンを使用した WF4 ワークフロー  
+  
+ 次の表に、1 つのワークフロー定義と 1,001 の定義との間のワーキング セットのデルタを示します。  
+  
+|ホスト オプション|WF3 のワーキング セット デルタ|WF4 のワーキング セット デルタ|  
+|---------------|------------------------|------------------------|  
+|コンソール アプリケーションでホストされるワークフロー|18 MB|9 MB|  
+|IIS でホストされるワークフロー サービス|446 MB|364 MB|  
+  
+ IIS のホスト ワークフロー定義の方がメモリ使用量がはるかに多いのは、<xref:System.ServiceModel.WorkflowServiceHost>、詳細な [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] サービス成果物、およびホストに関連付けられているメッセージ処理ロジックが原因です。  
+  
+ WF3 のコンソール ホストでは、ワークフローは XOML ではなくコードで実装されています。WF4 では既定で XAML を使用します。XAML は埋め込みリソースとしてアセンブリに格納され、実行時にコンパイルされてワークフローの実装を提供します。このプロセスにはある程度のオーバーヘッドが伴います。WF3 と WF4 を公正に比較するため、XAML ではなくコード化されたワークフローを使用しました。WF4 ワークフローの例を次に示します。  
+  
+```  
+public class Workflow1 : Activity  
+{  
+    protected override Func<Activity> Implementation  
+    {  
+        get  
+        {  
+            return new Func<Activity>(() =>  
+            {  
+                return new Sequence  
+                {  
+                    Activities = {  
+                        new Comment()  
+                    }  
+                };  
+            });  
+        }  
+        set  
+        {  
+            base.Implementation = value;  
+        }  
+    }  
+}  
+  
+```  
+  
+ その他にもメモリ消費量に影響を与えるさまざまな要因があります。すべてのマネージ プログラムに対しても同じアドバイスが当てはまります。IIS ホスト環境では、ワークフロー定義に対して作成された <xref:System.ServiceModel.WorkflowServiceHost> オブジェクトはアプリケーション プールがリサイクルされるまでメモリに保持されます。拡張を書き込むときは、この点に注意してください。グローバル変数 \(ワークフロー全体をスコープとする変数\) の使用を避け、変数のスコープをできるだけ制限することをお勧めします。  
+  
+## ワークフロー ランタイムのサービス  
+  
+### 永続性  
+ WF3 と WF4 には SQL 永続化プロバイダーが付属しています。WF3 の SQL 永続化プロバイダーはワークフロー インスタンスをシリアル化して BLOB に格納する単純な実装です。そのため、このプロバイダーのパフォーマンスはワークフロー インスタンスのサイズに大きく依存します。WF3 では、前述したさまざまな理由からインスタンスのサイズは大きくなる可能性があります。シリアル化されたインスタンスをデータベースに格納するとワークフローの状態を視認できないため、多くの場合に顧客は既定の SQL 永続化プロバイダーを使用しません。ワークフロー ID が不明な場合、特定のワークフローを探すには、永続化された各インスタンスを逆シリアル化して内容を確認する必要があります。多くの開発者は、この不都合を解消するために独自の永続化プロバイダーを作成することを選択します。  
+  
+ WF4 の SQL 永続化プロバイダーでは、この問題の一部に対処することを試みました。永続化テーブルは、アクティブなブックマークや昇格可能なプロパティなどの一定の情報を公開します。WF4 の新しいコンテンツ ベースの相関関係機能は WF3 の SQL 永続化手法では適切に機能せず、永続化されたワークフロー インスタンスの構成に変更が生じます。これにより永続化プロバイダーの処理が複雑化し、データベースに余分な負荷がかかります。  
+  
+### 環境の設定  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+### テストの設定  
+ 機能セットを向上させ、同時実行処理の設定を改善した場合でも、WF4 の SQL 永続化プロバイダーは WF3 のプロバイダーより高速です。このことを示すため、WF3 と WF4 で同じ操作をする 2 つのワークフローの比較を次に示します。  
+  
+ ![永続化ワークフロー](../../../docs/framework/windows-workflow-foundation//media/persistworkflow.gif "PersistWorkflow")  
+  
+ 図 5 – WF3 の永続化ワークフロー \(左側\) と WF4 の永続化ワークフロー \(右側\)  
+  
+ 2 つのワークフローは、いずれも受信したメッセージによって作成されます。最初に応答を送信すると、ワークフローが永続化されます。WF3 の場合は、空の <xref:System.Workflow.ComponentModel.TransactionScopeActivity> を使用して永続化を開始します。WF3 では \[クローズ時に保持\] アクティビティとしてマークすることによって同じ操作を行うこともできます。2 番目の、関連付けられたメッセージによってワークフローを完了します。ワークフローは永続化されますが、アンロードされません。  
+  
+### テスト結果  
+ ![スループットの永続性](../../../docs/framework/windows-workflow-foundation//media/throughputpersistence.gif "ThroughputPersistence")  
+  
+ クライアントと中間層とのトランスポートが HTTP の場合、WF4 の永続化ではパフォーマンスが 2.6 倍向上し、TCP トランスポートの場合では 3.0 倍向上しています。いずれの場合も、中間層の CPU 使用率は 98% 以上です。WF4 の方がスループットが高い理由はワークフロー ランタイムが高速であるためです。シリアル化されたインスタンスのサイズはどちらの場合も小さく、ここでは大きな要因になりません。  
+  
+ このテストでは、WF3 と WF4 の両方のワークフローに、永続化するときを明示的に示すアクティビティを使用します。この方法にはワークフローをアンロードせずに永続化できるという利点があります。WF3 では <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> 機能を使用して永続化することもできますが、この機能はワークフロー インスタンスをメモリからアンロードします。WF3 では、特定の時点でワークフローが永続化されていることを確認する場合、ワークフロー定義を変更するか、ワークフロー インスタンスをアンロードして再読み込みする必要があります。WF4 の新機能 <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToPersist%2A> を使用すると、アンロードせずに永続化することができます。この機能ではワークフロー インスタンスをアイドル状態で永続化することが可能で、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> のしきい値に達するか、実行が再開されるまでワークフロー インスタンスがメモリに保持されます。  
+  
+ WF4 の SQL 永続化プロバイダーはデータベース層でより多くの作業を実行することに注意してください。SQL データベースはボトルネックになる可能性があるため、CPU およびディスクの使用量を監視することが重要です。ワークフロー アプリケーションのパフォーマンス テストを行う場合、必ず SQL データベースから次のパフォーマンス カウンターを含めてください。  
+  
+-   PhysicalDisk\\% Disk Read Time  
+  
+-   PhysicalDisk\\% Disk Time  
+  
+-   PhysicalDisk\\% Disk Write Time  
+  
+-   PhysicalDisk\\% Avg.Disk Queue Length  
+  
+-   PhysicalDisk\\Avg.Disk Read Queue Length  
+  
+-   PhysicalDisk\\Avg.Disk Write Queue Length  
+  
+-   PhysicalDisk\\Current Disk Queue Length  
+  
+-   Processor Information\\% Processor Time  
+  
+-   SQLServer:Latches\\Average Latch Wait Time \(ms\)  
+  
+-   SQLServer:Latches\\Latch Waits\/sec  
+  
+### 追跡  
+ ワークフロー追跡機能を使用して、ワークフローの進行状況を管理できます。追跡イベントに含まれる情報は追跡プロファイルによって決まります。追跡プロファイルが複雑になるほど、追跡の負荷が大きくなります。  
+  
+ WF3 には SQL ベースの追跡サービスが付属しています。このサービスはバッチ モードと非バッチ モードで動作します。非バッチ モードでは、イベントの追跡はデータベースに直接書き込まれます。バッチ モードでは、追跡イベントは同じバッチ内にワークフロー インスタンスの状態として収集されます。バッチ モードは多様なワークフロー デザインを高パフォーマンスで処理します。ただし、ワークフローが永続化せずに多数のアクティビティを実行し、そのアクティビティを追跡する場合、バッチ処理によってパフォーマンスが低下する可能性があります。このような状態は一般にループで発生するので、大規模なループに永続化ポイントを含めることが最善の回避策になります。ループに永続化ポイントを導入することによってもパフォーマンスが低下する可能性があるので、両者のコストを測定してバランスを考慮することが重要です。  
+  
+ WF4 には SQL 追跡サービスは付属していません。SQL データベースへの追跡情報の記録は [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] に組み込むよりもアプリケーション サーバーから処理する方が適しているため、SQL 追跡は AppFabric によって処理するようになりました。WF4 の標準追跡プロバイダーは Event Tracing for Windows \(ETW\) に基づいています。  
+  
+ ETW は Windows に組み込まれた、カーネル レベルの待機時間が短いイベント システムです。このシステムは、実際に使用したときにのみイベント追跡のコストが発生するようにすることが可能なプロバイダー\/コンシューマー モデルを使用しています。プロセッサ、ディスク、メモリ、ネットワーク使用量などのカーネル イベント以外にも、多くのアプリケーションが ETW を利用しています。ETW イベントは、イベントをアプリケーションに応じてカスタマイズできるという点でパフォーマンス カウンターより高機能です。イベントにワークフロー ID や情報メッセージなどのテキストを含めることができます。また、すべてのイベントをキャプチャするより一定のイベントのサブセットを使用した方がパフォーマンスへの影響が少ないため、イベントはビットマスクを使用して分類されています。  
+  
+ 追跡に SQL ではなく ETW を使用する方法には次の利点があります。  
+  
+-   追跡イベントの収集を別のプロセスに分離できます。これによりイベントの記録方法の柔軟性が高まります。  
+  
+-   ETW の追跡イベントは [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] ETW イベントまたは SQL Server やカーネル プロバイダーなどのその他の ETW プロバイダーと容易に組み合わせることができます。  
+  
+-   ワークフローの作成者は、WF3 の SQL 追跡サービスのバッチ モードなど、特定の追跡の実装を改良するためにワークフローを変更する必要がありません。  
+  
+-   管理者はホスト プロセスをリサイクルすることなく追跡をオンまたはオフにできます。  
+  
+ ETW による追跡にはパフォーマンス上の利点と同時に欠点もあります。システムが極度のリソース圧迫にさらされると、ETW イベントは失われる可能性があります。イベントの処理は通常のプログラムの実行をブロックすることを目的としていないため、すべての ETW イベントがサブスクライバーにブロードキャストされることは保証されません。そのため、ETW 追跡は状態監視に適していますが、監査には適しません。  
+  
+ WF4 には SQL 追跡プロバイダーはありませんが、AppFabric に SQL 追跡プロバイダーがあります。AppFabric の SQL 追跡では、クイック挿入用にイベントをバッチ処理して SQL テーブルに書き込む Windows サービスを使用して、ETW イベントに定期受信します。別のジョブでこのテーブルからデータを排出し、形式を変更して AppFabric ダッシュボードに表示可能なレポート テーブルに格納します。追跡イベントのバッチは元になるワークフローとは独立して処理されるため、永続化ポイントを待機せずに記録されます。  
+  
+ ETW イベントの記録には logman や xperf などのツールを使用できます。小規模な ETL ファイルは xperfview などのツールで表示できます。または、tracerpt を使用して XML などのわかりやすい形式に変換することもできます。WF3 では、SQL データベースなしで追跡イベントを取得する唯一の方法は、カスタム追跡サービスを作成することです。ETW [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WCF サービスと Event Tracing for Windows](../../../docs/framework/wcf/samples/wcf-services-and-event-tracing-for-windows.md)」および「[Event Tracing for Windows](http://msdn.microsoft.com/library/ff190903.aspx\))」を参照してください。  
+  
+ ワークフロー追跡を有効にした場合のパフォーマンスへの影響の程度はさまざまです。次のベンチマークでは、logman ツールを使用し、ETW 追跡イベントを使用してそのイベントを ETL ファイルに記録します。AppFabric の SQL 追跡のコストについてはこの記事の対象外です。このベンチマークには AppFabric でも使用される基本的な追跡プロファイルが示されています。状態監視イベントのみを追跡した場合のコストも含まれています。これらのイベントは問題をトラブルシューティングし、システムの平均スループットを確認するために役立ちます。  
+  
+### 環境の設定  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+### テスト結果  
+ ![ワークフロー トレースのコスト](../../../docs/framework/windows-workflow-foundation//media/workflowtracingcost.gif "WorkflowTracingCost")  
+  
+ 状態監視はスループットに約 3% の影響をもたらしています。基本プロファイルのコストは約 8% です。  
+  
+## Interop  
+ WF4 では [!INCLUDE[wf1](../../../includes/wf1-md.md)] をほぼ全面的に変更しているため、WF3 のワークフローおよびアクティビティは WF4 とは直接互換性がありません。以前に [!INCLUDE[wf2](../../../includes/wf2-md.md)] を使用していた多くの顧客は WF3 用の自社製またはサードパーティ製のワークフロー定義とカスタム アクティビティを有しています。WF4 への移行を簡素化するには、Interop アクティビティを使用する方法があります。この方法により WF4 ワークフロー内から WF3 アクティビティを実行できます。<xref:System.Activities.Statements.Interop> アクティビティは必要な場合にのみ使用することをお勧めします。WF4 への移行 [!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WF4 への移行のガイドライン](http://go.microsoft.com/fwlink/?LinkID=153313)」を参照してください。  
+  
+### 環境の設定  
+ ![ワークフロー パフォーマンス テスト環境](../../../docs/framework/windows-workflow-foundation//media/wfperfenvironment.gif "WFPerfEnvironment")  
+  
+### テスト結果  
+ 次の表に、シーケンスに 5 つのアクティビティを含むワークフローのさまざまな構成での実行結果を示します。  
+  
+|テスト|スループット \(ワークフロー\/秒\)|  
+|---------|--------------------------|  
+|WF3 ランタイムの WF3 シーケンス|1,576|  
+|Interop を使用した WF4 ランタイムの WF3 シーケンス|2,745|  
+|WF4 シーケンス|153,582|  
+  
+ Interop を使用した場合の方が直接 WF3 を使用した場合よりパフォーマンスが顕著に高くなっていますが、WF4 アクティビティと比較した場合、パフォーマンスの向上はごくわずかです。  
+  
+## 概要  
+ WF4 のパフォーマンスに対する多大な投資は多くの重要な面で成果をもたらしました。個々のワークフロー コンポーネントのパフォーマンスは、[!INCLUDE[wf1](../../../includes/wf1-md.md)] ランタイムが効率的になることにより、WF4 が WF3 と比較して数百倍高速になる場合があります。待機時間の数値も大幅に向上しています。[!INCLUDE[wf1](../../../includes/wf1-md.md)] を使用することによる利点を考慮すると、手動コーディングの [!INCLUDE[indigo2](../../../includes/indigo2-md.md)] オーケストレーション サービスと比べて、[!INCLUDE[wf1](../../../includes/wf1-md.md)] を使用した場合のパフォーマンスの低下はごく些細です。永続化のパフォーマンスは 2.5 ～ 3.0 倍向上しています。ワークフロー追跡による状態監視のオーバーヘッドもごくわずかになりました。WF3 から WF4 への移行を検討する場合の包括的な移行ガイドも提供されています。これらのあらゆる要素を考慮すると、WF4 は複雑なアプリケーションの作成において魅力的な選択肢です。  
+  
+## 謝辞  
+ 次の寄稿者および校閲者の方々のご協力に感謝します。  
+  
+-   Leon Welicki、Microsoft Corporation  
+  
+-   Ryszard Kwiecinski、Microsoft Corporation  
+  
+-   Emil Velinov、Microsoft Corporation  
+  
+-   Nate Talbert、Microsoft Corporation  
+  
+-   Bob Schmidt、Microsoft Corporation  
+  
+-   Stefan Batres、Microsoft Corporation
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/persistence-best-practices.md b/docs/framework/windows-workflow-foundation/persistence-best-practices.md
new file mode 100644
index 00000000000..3980c6ddd2e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/persistence-best-practices.md
@@ -0,0 +1,90 @@
+---
+title: "永続化のベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6974c5a4-1af8-4732-ab53-7d694608a3a0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 永続化のベスト プラクティス
+このドキュメントでは、ワークフローの永続化に関するワークフローのデザインと構成のベスト プラクティスについて説明します。  
+  
+## 永続的ワークフローのデザインと実装  
+ 一般的に、ワークフローは短く分割された期間に作業を行い、その合間にイベント待機中のアイドル時間がインタリーブされています。このイベントには、メッセージや期限付きタイマーなどがあります。ワークフロー インスタンスがアイドルになったときにこのインスタンスをアンロードするには、サービス ホストがワークフロー インスタンスを永続化する必要があります。これは、ワークフロー インスタンスが非永続化ゾーン \(たとえばトランザクションの完了を待機していたり、非同期コールバックを待機している場合\) にない場合にのみ可能です。アイドル状態のワークフロー インスタンスのアンロードを可能にするために、ワークフローの作成者は短時間のアクションに対してのみトランザクション スコープと非同期アクティビティを使用するようにしてください。特に、これらの非永続化ゾーン内での遅延アクティビティはできるだけ短くしてください。  
+  
+ ワークフローは、ワークフローが使用するすべてのデータ型がシリアル化可能である場合にのみ永続化できます。また、永続化されたワークフローで使用されるカスタム型は、<xref:System.Runtime.Serialization.NetDataContractSerializer> を使用してシリアル化可能である必要があります。そうしないと、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用してワークフローを永続化することはできません。  
+  
+ 永続化されていないワークフロー インスタンスは、ホストまたはコンピューターに障害が発生した場合、復元できません。通常は、ワークフローのライフ サイクルの早い時期にワークフロー インスタンスを永続化することをお勧めします。  
+  
+ ワークフローが長時間ビジー状態になっている場合は、ビジー期間中、定期的にワークフロー インスタンスを永続化することをお勧めします。永続化するには、ワークフロー インスタンスをビジー状態にする一連のアクティビティに <xref:System.Activities.Statements.Persist> アクティビティを追加します。こうすると、アプリケーション ドメインのリサイクル、ホストの障害、またはコンピューターの障害が原因でシステムがビジー期間の始めにロールバックするのを避けることができます。<xref:System.Activities.Statements.Persist> アクティビティをワークフローに追加すると、パフォーマンスが低下する場合があることに注意してください。  
+  
+ Windows Server App Fabric を使用すると、永続化の構成と使用を大幅に簡潔化できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Server App Fabric の永続化](http://go.microsoft.com/fwlink/?LinkID=201200&clcid=0x409)  
+  
+## スケーラビリティ パラメーターの構成  
+ スケーラビリティとパフォーマンスの要件により、次のパラメーターの設定が決定されます。  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToPersist%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A>  
+  
+-   <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior.InstanceLockedExceptionAction%2A>  
+  
+ これらのパラメーターは、現在のシナリオに応じて次のように設定してください。  
+  
+### シナリオ: 最適な応答時間が要求される少数のワークフロー インスタンスが存在する場合  
+ このシナリオでは、ワークフロー インスタンスがアイドル状態になったときに、これらのインスタンスすべてを読み込んだ状態のまま保持する必要があります。<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> を大きな値に設定します。この設定を使用すると、ワークフロー インスタンスがコンピューター間で移動するのを回避できます。この設定は、次の 1 つ以上の条件が真である場合にのみ使用してください。  
+  
+-   ワークフロー インスタンスが有効期間中に 1 つのメッセージを受信する。  
+  
+-   すべてのワークフロー インスタンスが 1 台のコンピューター上で実行される。  
+  
+-   ワークフロー インスタンスがすべてのメッセージを同じコンピューターで受信する。  
+  
+ <xref:System.Activities.Statements.Persist> アクティビティを使用するか、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToPersist%2A> を 0 に設定し、サービス ホストまたはコンピューターに障害が発生した場合にワークフロー インスタンスを回復できるようにします。  
+  
+### シナリオ: ワークフロー インタンスが長期間アイドル状態になる場合  
+ このシナリオでは、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> を 0 に設定してリソースをできるだけ早く解放します。  
+  
+### シナリオ: ワークフロー インスタンスが短期間に複数のメッセージを受信する場合  
+ このシナリオでは、同じコンピューターでこれらのメッセージを受信する場合、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> を 60 秒に設定します。これにより、ワークフロー インスタンスのアンロードと読み込みが頻繁に繰り返される状態を回避できます。また、インスタンスがメモリ内に長く留まることを避けることもできます。  
+  
+ これらのメッセージを異なるコンピューターで受信する場合は、<xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> を 0 に設定し、<xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior.InstanceLockedExceptionAction%2A> を BasicRetry または AggressiveRetry に設定します。これにより、別のコンピューターがワークフロー インスタンスを読み込むことができるようになります。  
+  
+### シナリオ: ワークフローが短期間の遅延アクティビティを使用する場合  
+ このシナリオでは、読み込む必要のあるインスタンスに対して <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> が定期的に永続性データベースをポーリングします。その理由は、<xref:System.Activities.Statements.Delay> アクティビティが期限切れになるためです。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> が次のポーリング間隔で期限切れになるタイマーを見つけた場合は、SQL Workflow Instance Store によってポーリング間隔が短縮されます。次のポーリングは、タイマーが期限切れになった直後に発生します。このようにして、SQL Workflow Instance Store はポーリング間隔よりも長く実行されるタイマーの精度を保持します。タイマーは <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> によって設定されます。より短い遅延で迅速な処理を実行するために、ワークフロー インスタンスは少なくとも 1 つのポーリング間隔中、メモリに留まる必要があります。  
+  
+ <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToPersist%2A> を 0 に設定し、有効期限を永続性データベースに書き込みます。  
+  
+ <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior.TimeToUnload%2A> を <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> 以上に設定し、少なくとも 1 つのポーリング間隔中、インスタンスをメモリに保持します。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> の値を小さくすることはお勧めできません。それによって永続性データベースへの読み込みが増加するためです。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用する各サービス ホストは、検出期間ごとにデータベースを 1 回ポーリングします。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> に設定した間隔が小さすぎると、サービス ホストの数が大きい場合にシステムのパフォーマンスが低下することがあります。  
+  
+## SQL Workflow Instance Store の構成  
+ SQL Workflow Instance Store には、次の構成パラメーターがあります。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceEncodingOption%2A>  
+ このパラメーターは、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> に対してワークフロー インスタンス状態を圧縮するように指示します。圧縮により、永続性データベースに保存されるデータの量が削減され、永続性データベースが専用のデータベース サーバーに常駐している場合のネットワーク トラフィックが緩和されます。圧縮を使用する場合は、インスタンス状態を圧縮および抽出するための計算リソースが必要になります。ほとんどの場合は圧縮によってパフォーマンスが向上します。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceCompletionAction%2A>  
+ このパラメーターは、完了したインスタンスを保持または削除するように <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> に指示します。完了したインスタンスを保持しておくと、永続性データベースにより多くのストレージが必要となり、テーブルのサイズが増加するため、テーブルの検索時間が長くなります。完了したインスタンスがデバックまたは監査の目的で必要とならない限り、完了したインスタンスは削除するように <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> に指示するのが最適です。削除したインスタンスは、ユーザーが後でこれらを取り除くプロセスを確立する場合にのみ保持してください。完了したワークフロー インスタンスがインスタンス ストアに残っている限り、相関関係キーを再利用することはできないことに注意してください。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A>  
+ このパラメーターは、<xref:System.Activities.Statements.Delay> アクティビティが期限切れになったときに読み込む必要のあるインスタンスに対して <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> が永続性データベースをポーリングする最大間隔を定義します。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> が次のポーリング間隔で期限切れになるタイマーを見つけた場合は、ポーリング間隔を短縮し、タイマーの期限切れ直後に次のポーリングが発生するようにします。このようにして、SQL Workflow Instance Store は <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> よりも長く実行されるタイマーの精度を保持します。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> の値を小さくすることはお勧めできません。それによって永続性データベースへの読み込みが増加するためです。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用する各サービス ホストは、検出期間ごとにデータベースを 1 回ポーリングします。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.RunnableInstancesDetectionPeriod%2A> に設定した間隔が小さすぎると、サービス ホストの数が大きい場合にシステムのパフォーマンスが低下することがあります。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.HostLockRenewalPeriod%2A>  
+ このパラメーターは、ホストが永続性データベース内のロックを更新する間隔を定義します。この間隔を短縮すると、ホストまたはコンピューターに障害が発生した場合にワークフロー インスタンスをよりすばやく回復できるようになります。一方、ロックの更新間隔を短くすると、永続性データベースへの読み込みが増えます。<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用する各サービス ホストは、1 つの更新間隔ごとにデータベース内のロックを 1 回更新します。コンピューターが多くのサービス ホストを実行する場合は、ロックの更新によって発生する読み込みがシステム パフォーマンスの低下をもたらさないようにしてください。パフォーマンスが低下する場合は、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.HostLockRenewalPeriod%2A> を大きくしてください。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceLockedExceptionAction%2A>  
+ 有効にした場合、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> はロック済みインスタンスの読み込みを次の 30 秒間再試行します。ワークフローが短期間に複数のメッセージを受信し、これらのメッセージを異なるコンピューターで受信する場合は、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceLockedExceptionAction%2A> を BasicRetry または AggressiveRetry に設定してください。  
+  
+ 読み込みが再試行されない限り、再試行メカニズムによってパフォーマンスのオーバーヘッドが発生することはないので、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.InstanceLockedExceptionAction%2A> は常に有効にしてください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/persistence-database-schema.md b/docs/framework/windows-workflow-foundation/persistence-database-schema.md
new file mode 100644
index 00000000000..d0509021413
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/persistence-database-schema.md
@@ -0,0 +1,87 @@
+---
+title: "永続性データベース スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 34f69f4c-df81-4da7-b281-a525a9397a5c
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 永続性データベース スキーマ
+このトピックでは、SQL Workflow Instance Store でサポートされるパブリック ビューについて説明します。  
+  
+## Instances ビュー  
+ **Instances** ビューには、データベースのすべてのワークフロー インスタンスに関する一般的な情報が格納されます。  
+  
+|列名|列の型|説明|  
+|--------|---------|--------|  
+|InstanceId|UniqueIdentifier|ワークフロー インスタンスの ID。|  
+|PendingTimer|DateTime|ワークフローが Delay アクティビティでブロックされていて、タイマーが時間切れになってから再開されることを示します。タイマーが時間切れになるまで待機するようにワークフローがブロックされていない場合は null になります。|  
+|CreationTime|DateTime|ワークフローが作成された日時を示します。|  
+|LastUpdatedTime|DateTime|ワークフローがデータベースに最後に永続化された日時を示します。|  
+|ServiceDeploymentId|BigInt|\[ServiceDeployments\] ビューに対する外部キーとして機能します。現在のワークフロー インスタンスが Web ホスト型サービスのインスタンスの場合、この列に値が設定されます。それ以外の場合は NULL に設定されます。|  
+|SuspensionExceptionName|Nvarchar\(450\)|ワークフローの中断の原因となった例外の種類 \(InvalidOperationException など\) を示します。|  
+|SuspensionReason|Nvarchar\(max\)|ワークフロー インスタンスが中断された理由を示します。例外が原因でインスタンスが中断された場合は、例外に関連付けられているメッセージが格納されます。<br /><br /> 手動でインスタンスが中断された場合は、ユーザーが指定したインスタンスの中断理由が格納されます。|  
+|ActiveBookmarks|Nvarchar\(max\)|ワークフロー インスタンスがアイドル状態の場合、このプロパティはインスタンスがブロックされているブックマークを示します。インスタンスがアイドル状態でない場合は、この列は NULL になります。|  
+|CurrentMachine|Nvarchar\(128\)|ワークフロー インスタンスが現在メモリに読み込まれているコンピューターの名前を示します。|  
+|LastMachine|Nvarchar\(450\)|ワークフロー インスタンスを最後に読み込んだコンピューターを示します。|  
+|ExecutionStatus|Nvarchar\(450\)|ワークフローの現在の実行状態を示します。状態には、**Executing**、**Idle**、**Closed** などがあります。|  
+|IsInitialized|Bit|ワークフロー インスタンスが初期化されているかどうかを示します。初期化されたワークフロー インスタンスとは、少なくとも 1 回は永続化されているワークフロー インスタンスのことです。|  
+|IsSuspended|Bit|ワークフロー インスタンスが中断されているかどうかを示します。|  
+|IsCompleted|Bit|ワークフロー インスタンスの実行が完了しているかどうかを示します。 **Note:**  **InstanceCompletionAction** プロパティが **DeleteAll** に設定されている場合、完了時にビューからインスタンスが削除されます。|  
+|EncodingOption|TinyInt|データ プロパティのシリアル化に使用されるエンコーディングを示します。<br /><br /> -   0 – エンコーディングなし<br />-   1 – GzipStream|  
+|ReadWritePrimitiveDataProperties|Varbinary\(max\)|インスタンスが読み込まれるときにワークフロー ランタイムに戻される、シリアル化されたインスタンスのデータ プロパティが格納されます。<br /><br /> プリミティブ型の各プロパティはネイティブな CLR 型です。つまり、BLOB を逆シリアル化するときに特別なアセンブリは必要ありません。|  
+|WriteOnlyPrimitiveDataProperties|Varbinary\(max\)|インスタンスが読み込まれるときにワークフロー ランタイムに戻されない、シリアル化されたインスタンスのデータ プロパティが格納されます。<br /><br /> プリミティブ型の各プロパティはネイティブな CLR 型です。つまり、BLOB を逆シリアル化するときに特別なアセンブリは必要ありません。|  
+|ReadWriteComplexDataProperties|Varbinary\(max\)|インスタンスが読み込まれるときにワークフロー ランタイムに戻される、シリアル化されたインスタンスのデータ プロパティが格納されます。<br /><br /> デシリアライザーで、この BLOB に格納されているすべてのオブジェクト型を認識している必要があります。|  
+|WriteOnlyComplexDataProperties|Varbinary\(max\)|インスタンスが読み込まれるときにワークフロー ランタイムに戻されない、シリアル化されたインスタンスのデータ プロパティが格納されます。<br /><br /> デシリアライザーで、この BLOB に格納されているすべてのオブジェクト型を認識している必要があります。|  
+|IdentityName|Nvarchar\(max\)|ワークフロー定義の名前。|  
+|IdentityPackage|Nvarchar\(max\)|ワークフローが作成されたときに指定されたパッケージの情報 \(アセンブリ名など\)。|  
+|ビルド|BigInt|ワークフロー バージョンのビルド番号。|  
+|Major|BigInt|ワークフロー バージョンのメジャー番号。|  
+|Minor|BigInt|ワークフロー バージョンのマイナー番号。|  
+|Revision|BigInt|ワークフロー バージョンのリビジョン番号。|  
+  
+> [!CAUTION]
+>  **Instances** ビューには、Delete トリガーも含まれています。適切な権限を持つユーザーは、このビューに対して delete ステートメントを実行して、データベースからワークフロー インスタンスを強制的に削除することができます。ただし、ワークフロー ランタイムからインスタンスを削除すると意図しない結果を引き起こすことがあるため、ビューから直接削除する方法は最後の手段としてのみ使用することをお勧めします。代わりに、ワークフロー インスタンス管理エンドポイントを使用して、ワークフロー ランタイムでインスタンスを終了するようにしてください。ビューから多数のインスタンスを削除する場合は、それらのインスタンスで稼動しているアクティブなランタイムがないことを確認してください。  
+  
+## ServiceDeployments ビュー  
+ **ServiceDeployments** ビューには、Web \(IIS\/WAS\) ホスト型のすべてのワークフロー サービスの配置情報が格納されます。Web ホスト型の各ワークフロー インスタンスに、このビューの行を参照する **ServiceDeploymentId** が格納されます。  
+  
+|列名|列の型|説明|  
+|--------|---------|--------|  
+|ServiceDeploymentId|BigInt|このビューの主キー。|  
+|SiteName|Nvarchar\(max\)|ワーク フロー サービスを含むサイト名を表します \(**既定の Web サイト** など\)。|  
+|RelativeServicePath|Nvarchar\(max\)|ワークフロー サービスの仮想パスを、サイトを基準とした相対パスで表します \(**\/app1\/PurchaseOrderService.svc** など\)。|  
+|RelativeApplicationPath|Nvarchar\(max\)|ワークフロー サービスを含むアプリケーションの仮想パスを、サイトを基準とした相対パスで表します \(**\/app1** など\)。|  
+|ServiceName|Nvarchar\(max\)|ワークフロー サービスの名前を表します \(**PurchaseOrderService** など\)。|  
+|ServiceNamespace|Nvarchar\(max\)|ワークフロー サービスの名前空間を表します \(**MyCompany** など\)。|  
+  
+ ServiceDeployments ビューには、Delete トリガーも含まれています。適切な権限を持つユーザーは、このビューに対して delete ステートメントを実行して、データベースから ServiceDeployment のエントリを削除することができます。次の点に注意してください。  
+  
+1.  このビューからエントリを削除するときは、実行前にデータベース全体をロックしなければならないため、この操作は高コストです。これは、存在しない ServiceDeployment のエントリをワークフロー インスタンスが参照しないようにするために必要です。このビューからの削除は、ダウンタイムか保守時間帯のみに行うようにしてください。  
+  
+2.  **Instances** ビューのエントリによって参照されている ServiceDeployment 行を削除しようとすると、no\-op になります。削除できるのは、参照がない ServiceDeployment 行だけです。  
+  
+## InstancePromotedProperties ビュー  
+ **InstancePromotedProperties** ビューには、ユーザーが指定したすべての昇格されたプロパティの情報が格納されます。昇格されたプロパティはファーストクラスのプロパティとして機能します。ユーザーは、このプロパティをクエリで使用してインスタンスを取得できます。たとえば、注文のコストを常に **Value1** 列に格納する PurchaseOrder 昇格を追加できます。これにより、コストが特定の値を超えるすべての購買発注書を照会することができます。  
+  
+||||  
+|-|-|-|  
+|列の型|列の型|説明|  
+|InstanceId|UniqueIdentifier|ワークフロー インスタンスの ID。|  
+|EncodingOption|TinyInt|昇格されたバイナリ プロパティのシリアル化に使用されるエンコーディングを示します。<br /><br /> -   0 – エンコーディングなし<br />-   1 – GZipStream|  
+|PromotionName|Nvarchar\(400\)|このインスタンスに関連付けられた昇格の名前。PromotionName は、この行の汎用的な列にコンテキストを追加するために必要です。<br /><br /> たとえば、PromotionName が PurchaseOrder の場合、Value1 に注文のコスト、Value2 に注文を行った顧客の名前、Value 3 に顧客の住所、などのように格納されることを示します。|  
+|Value\[1\-32\]|SqlVariant|Value\[1\-32\] には、SqlVariant 列に格納できる値が格納されます。1 つの昇格に 32 を超える SqlVariant を格納することはできません。|  
+|Value\[33\-64\]|Varbinary\(max\)|Value\[33\-64\] には、シリアル化された値が格納されます。たとえば、Value33 に購入品目の JPEG を格納することができます。1 つの昇格に 32 を超えるバイナリ プロパティを格納することはできません。|  
+  
+ InstancePromotedProperties ビューはスキーマ バインドであるため、このビューに対するクエリを最適化するために、1 つまたは複数の列にインデックスを追加することができます。  
+  
+> [!NOTE]
+>  インデックス付きビューを使用する場合、必要なストレージが多くなり、処理のオーバーヘッドが増加します。詳細については、「[SQL Server 2008 のインデックス付きビューを使用したパフォーマンスの向上](http://go.microsoft.com/fwlink/?LinkId=179529)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/persistence-participants.md b/docs/framework/windows-workflow-foundation/persistence-participants.md
new file mode 100644
index 00000000000..428a306865c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/persistence-participants.md
@@ -0,0 +1,69 @@
+---
+title: "永続参加要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f84d2d5d-1c1b-4f19-be45-65b552d3e9e3
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 永続参加要素
+永続参加要素は、アプリケーション ホストによってトリガーされる永続化操作 \(保存または読み込み\) に参加できます。[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には **PersistenceParticipant** および **PersistenceIOParticipant** の 2 つの抽象クラスが付属しており、これらを使用して永続参加要素を作成できます。永続参加要素はこれらのクラスの 1 つから派生し、目的のメソッドを実装して、このクラスのインスタンスを <xref:System.ServiceModel.Activities.WorkflowServiceHost> の <xref:System.ServiceModel.Activities.WorkflowServiceHost.WorkflowExtensions%2A> コレクションに追加します。アプリケーション ホストは、ワークフロー インスタンスを永続化するときにこのようなワークフロー拡張機能を必要とする場合があり、適切なときに永続参加要素の適切なメソッドを呼び出します。  
+  
+ 次の一覧では、永続化 \(保存\) 操作のさまざまな段階で永続化サブシステムが実行するタスクについて説明します。3 番目および 4 番目の段階で永続参加要素が使用されます。参加要素が IO 参加要素 \(IO 操作にも参加する参加要素\) の場合、その参加要素は 6 番目の段階でも使用されます。  
+  
+1.  ワークフロー状態、ブックマーク、マップされた変数、およびタイムスタンプなどの組み込みの値を収集します。  
+  
+2.  ワークフロー インスタンスに関連付けられた拡張コレクションに追加された永続参加要素を収集します。  
+  
+3.  すべての永続参加要素によって実装された <xref:System.Activities.Persistence.PersistenceParticipant.CollectValues%2A> メソッドを呼び出します。  
+  
+4.  すべての永続参加要素によって実装された <xref:System.Activities.Persistence.PersistenceParticipant.MapValues%2A> メソッドを呼び出します。  
+  
+5.  ワークフローを永続ストアに永続化または保存します。  
+  
+6.  すべての永続 IO 参加要素の <xref:System.Activities.Persistence.PersistenceIOParticipant.BeginOnSave%2A> メソッドを呼び出します。参加要素が IO 参加要素でない場合は、このタスクをスキップします。永続化がトランザクションである場合、Transaction.Current プロパティにトランザクションが提供されます。  
+  
+7.  すべての永続参加要素が完了するのを待機します。すべての参加要素がインスタンス データの永続化に成功したら、トランザクションをコミットします。  
+  
+ 永続参加要素は **PersistenceParticipant** クラスから派生し、**CollectValues** および **MapValues** メソッドを実装できます。永続 IO 参加要素は **PersistenceIOParticipant** クラスから派生し、**CollectValues** および **MapValues** メソッドの実装に加えて **BeginOnSave** を実装できます。  
+  
+ それぞれの段階の完了後に次の段階が開始されます。たとえば、最初の段階では、**すべての**永続参加要素から値が収集されます。2 番目の段階では、最初の段階で収集されたすべての値がマップのためにすべての永続参加要素に提供されます。3 番目の段階では、1 番目および 2 番目の段階で収集してマップされたすべての値が永続参加要素に提供されます。  
+  
+ 次の一覧では、読み込み操作のさまざまな段階で永続化サブシステムが実行するタスクについて説明します。4 番目の段階で永続参加要素が使用されます。永続 IO 参加要素 \(IO 操作にも参加する永続参加要素\) は 3 番目の段階でも使用されます。  
+  
+1.  ワークフロー インスタンスに関連付けられた拡張コレクションに追加された永続参加要素を収集します。  
+  
+2.  永続ストアからワークフローを読み込みます。  
+  
+3.  すべての永続 IO 参加要素の <xref:System.Activities.Persistence.PersistenceIOParticipant.BeginOnLoad%2A> を呼び出して、すべての永続参加要素が完了するのを待機します。永続化がトランザクションである場合、Transaction.Current にトランザクションが提供されます。  
+  
+4.  永続ストアから取得されたデータに基づいて、メモリ内のワークフロー インスタンスを読み込みます。  
+  
+5.  各永続参加要素の <xref:System.Activities.Persistence.PersistenceParticipant.PublishValues%2A> メソッドを呼び出します。  
+  
+ 永続参加要素は **PersistenceParticipant** クラスから派生し、**PublishValues** メソッドを実装できます。永続 IO 参加要素は **PersistenceIOParticipant** クラスから派生し、**PublishValues** メソッドの実装に加えて **BeginOnLoad** メソッドを実装できます。  
+  
+ ワークフロー インスタンスを読み込む場合、永続化プロバイダーはそのインスタンスのロックを作成します。これにより、各インスタンスが複数ノードのシナリオでは、複数のホストによって読み込まれることはありません。ロックされたワークフロー インスタンスを読み込もうとすると、次のような例外が表示されます: 例外 「System.ServiceModel.Persistence.InstanceLockException: 要求された操作は、たとえばロック 「00000000\-0000\-0000\-0000\-000000000000'」が取得できなかったため、完了できませんでした。このエラーが発生するのは、次のいずれかが発生した場合です。  
+  
+-   複数ノード シナリオで、インスタンスが他のホストによって読み込まれます。これらの種類の競合を解決する方法がいくつかあります。ロックと再試行を所有するノードへ処理を転送するか、または他のホストでの作業を保存できないようにする読み込みを強制します。  
+  
+-   単一ノード シナリオで、ホストがクラッシュしました。ホストが再度起動されるとき \(プロセスのリサイクル、または新しい永続化プロバイダー ファクトリの作成\)、新しいホストが、ロックの期限がまだ切れていないために古いホストによってまだロックされているインスタンスの読み込みを試みます。  
+  
+-   単一ノード シナリオで、当該インスタンスがあるポイントで中止され、別のホスト ID を持つ新しい永続化プロバイダー インスタンスが作成されます。  
+  
+ ロックのタイムアウト値の既定値は 5 分です。呼び出したときに、別のタイムアウト値を指定できます <xref:System.ServiceModel.Persistence.PersistenceProvider.Load%2A>。  
+  
+## このセクションの内容  
+  
+-   [カスタム永続参加要素を作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-persistence-participant.md)  
+  
+## 参照  
+ [ストア拡張](../../../docs/framework/windows-workflow-foundation//store-extensibility.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/pick-activity.md b/docs/framework/windows-workflow-foundation/pick-activity.md
new file mode 100644
index 00000000000..56ba8ee5551
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/pick-activity.md
@@ -0,0 +1,97 @@
+---
+title: "Pick アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b3e49b7f-0285-4720-8c09-11ae18f0d53e
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# Pick アクティビティ
+<xref:System.Activities.Statements.Pick> アクティビティを使用すると、イベント トリガー セットとそれに続く対応するハンドラーのモデル化が単純になります。  <xref:System.Activities.Statements.Pick> アクティビティには、<xref:System.Activities.Statements.PickBranch> アクティビティのコレクションが含まれます。各 <xref:System.Activities.Statements.PickBranch> は、<xref:System.Activities.Statements.PickBranch.Trigger%2A> アクティビティと <xref:System.Activities.Statements.PickBranch.Action%2A> アクティビティの組み合わせです。  実行時に、すべての分岐のトリガーが並行して実行されます。  1 つのトリガーが完了すると、対応するアクションが実行され、その他すべてのトリガーが取り消されます。  [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)]<xref:System.Activities.Statements.Pick> アクティビティの動作は、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)]<xref:System.Workflow.Activities.Listen> アクティビティに似ています。  
+  
+ 次の「[Pick アクティビティの使用](../../../docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md)」に含まれる SDK サンプルのスクリーンショットは、2 つの分岐がある Pick アクティビティを示しています。  1 つ目の分岐には **Read input** というトリガーがあります。これはコマンド ラインから入力を読み取るカスタム アクティビティです。 2 つ目の分岐には <xref:System.Activities.Statements.Delay> アクティビティ トリガーがあります。 <xref:System.Activities.Statements.Delay> アクティビティが完了する前に **Read input** アクティビティがデータを受信した場合、<xref:System.Activities.Statements.Delay> が取り消され、メッセージがコンソールに書き込まれます。  それ以外の場合、**Read input** が割り当て時間内にデータを受信しないときは、アクティビティは取り消され、タイムアウト メッセージがコンソールに書き込まれます。  これは、任意のアクションにタイムアウトを追加するために使用される一般的なパターンです。  
+  
+ ![Pick アクティビティ](../../../docs/framework/windows-workflow-foundation//media/pickconceptual.JPG "PickConceptual")  
+  
+## <a name="best-practices"></a>ベスト プラクティス  
+ Pick を使用する場合、実行する分岐は、トリガーが最初に完了する分岐です。  概念的には、すべてのトリガーは並行して実行され、1 つのトリガーがロジックの大部分を実行してから、他のトリガーが完了したために実行が取り消されることがあります。  この点に留意すると、Pick アクティビティを使用する場合に従う一般的なガイドラインは、トリガーを単一のイベントの代表として扱い、できるだけ少ないロジックを含めることです。  理想的には、トリガーにはイベントを受信するために必要なロジックのみを含め、そのイベントのすべての処理を分岐のアクションに含めます。  この方法で、トリガーの実行の重複を最小限に抑えることができます。  たとえば、2 つのトリガーを含む <xref:System.Activities.Statements.Pick> があるとします。各トリガーには <xref:System.ServiceModel.Activities.Receive> アクティビティとそれに続いて追加のロジックが含まれます。  追加のロジックによってアイドル ポイントが発生する場合、両方の <xref:System.ServiceModel.Activities.Receive> は正常に完了する可能性があります。  1 つのトリガーが完全に完了し、もう 1 つのトリガーは部分的に完了します。  一部のシナリオでは、メッセージを受け入れてから、その処理を部分的に完了することは許容されません。  したがって、<xref:System.ServiceModel.Activities.Receive> や <xref:System.ServiceModel.Activities.SendReply> など、WF のビルトイン メッセージング アクティビティを使用する場合、一般的には <xref:System.ServiceModel.Activities.Receive> がトリガーに使用されますが、可能な限り <xref:System.ServiceModel.Activities.SendReply> や他のロジックをアクションに含める必要があります。  
+  
+## <a name="using-the-pick-activity-in-the-designer"></a>デザイナーでの Pick アクティビティの使用  
+ デザイナーで Pick を使用するには、ツールボックスで **[Pick]** と **[PickBranch]** を見つけます。  **[Pick]** をキャンバスにドラッグ アンド ドロップします。  既定では、デザイナーに新しく追加された **Pick** アクティビティには 2 つの分岐があります。  新しい分岐を追加するには、**PickBranch** アクティビティを既存の分岐の横にドラッグ アンド ドロップします。 アクティビティは、任意の **PickBranch** の **[Trigger]** 領域または **[Action]** 領域の **Pick** アクティビティにドロップできます。  
+  
+## <a name="using-the-pick-activity-in-code"></a>コードでの Pick アクティビティの使用  
+ <xref:System.Activities.Statements.Pick> アクティビティを使用するには、<xref:System.Activities.Statements.PickBranch> アクティビティで <xref:System.Activities.Statements.Pick.Branches%2A> コレクションを設定します。 各 <xref:System.Activities.Statements.PickBranch> アクティビティには、<xref:System.Activities.Activity> 型の <xref:System.Activities.Statements.PickBranch.Trigger%2A> プロパティがあります。 指定したアクティビティの実行が完了すると、<xref:System.Activities.Statements.PickBranch.Action%2A> が実行されます。  
+  
+ 次のコードは、<xref:System.Activities.Statements.Pick> アクティビティを使用して、コンソールからの入力を読み取るアクティビティのタイムアウトを実装する方法の例です。  
+  
+```csharp  
+Sequence body = new Sequence()  
+{  
+    Variables = { name },  
+    Activities =   
+   {  
+       new System.Activities.Statements.Pick  
+        {  
+           Branches =   
+           {  
+               new PickBranch  
+               {  
+                   Trigger = new ReadLine  
+                   {  
+                      Result = name,  
+                      BookmarkName = "name"  
+                   },  
+                   Action = new WriteLine   
+                   {   
+                       Text = ExpressionServices.Convert<string>(ctx => "Hello " +   
+                           name.Get(ctx))   
+                   }  
+               },  
+               new PickBranch  
+               {  
+                   Trigger = new Delay  
+                   {  
+                      Duration = new TimeSpan(0, 0, 5)  
+                   },  
+                   Action = new WriteLine  
+                   {  
+                      Text = "Time is up."  
+                   }  
+               }  
+           }  
+       }  
+   }  
+};  
+  
+```  
+  
+```xaml  
+<Sequence xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <Sequence.Variables>  
+    <Variable x:TypeArguments="x:String" Name="username" />  
+  </Sequence.Variables>  
+  <Pick>  
+    <PickBranch>  
+      <PickBranch.Trigger>  
+        <ReadLine BookmarkName="name" Result="username" />  
+      </PickBranch.Trigger>  
+      <WriteLine>[String.Concat("Hello ", username)]</WriteLine>  
+    </PickBranch>  
+    <PickBranch>  
+      <PickBranch.Trigger>  
+        <Delay>00:00:05</Delay>  
+      </PickBranch.Trigger>  
+      <WriteLine>Time is up.</WriteLine>  
+    </PickBranch>  
+  </Pick>  
+</Sequence>  
+  
+```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/primitives-activities-in-wf.md b/docs/framework/windows-workflow-foundation/primitives-activities-in-wf.md
new file mode 100644
index 00000000000..d56d8446df6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/primitives-activities-in-wf.md
@@ -0,0 +1,26 @@
+---
+title: "WF 内のプリミティブ アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8e9009d1-236e-4d8e-86fc-e43132bf6dfc
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WF 内のプリミティブ アクティビティ
+[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] には、共通のタスクを実行する便利な機構を提供する、システムによって提供されるアクティビティがいくつか用意されています。  
+  
+|アクティビティ|説明|  
+|-------------|--------|  
+|<xref:System.Activities.Statements.Assign>|現在のスコープで、変数に値を割り当てます。|  
+|<xref:System.Activities.Statements.Delay>|1 つの実行パスをアイドル状態にして、場合によってはワークフローをアンロードできるようにします。|  
+|<xref:System.Activities.Statements.InvokeDelegate>|<xref:System.Activities.ActivityDelegate> から派生し、プロパティとして公開されるデリゲートを実行します。|  
+|<xref:System.Activities.Statements.InvokeMethod>|CLR オブジェクトのパブリック メソッドを実行します。|  
+|<xref:System.Activities.Statements.WriteLine>|指定した文字列を、コンソールまたは指定した <xref:System.IO.TextWriter> オブジェクトに書き込みます。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/procedural-workflows.md b/docs/framework/windows-workflow-foundation/procedural-workflows.md
new file mode 100644
index 00000000000..d08545c375c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/procedural-workflows.md
@@ -0,0 +1,45 @@
+---
+title: "手続き型ワークフロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 52401de9-9115-472d-8fd9-047af6a072b9
+caps.latest.revision: 17
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 17
+---
+# 手続き型ワークフロー
+手続き型ワークフローでは、手続き型言語と似たフロー制御方法を使用します。これらの構造には `While` と `If` が含まれます。これらのワークフローは、<xref:System.Activities.Statements.Flowchart> や <xref:System.Activities.Statements.Sequence> など、他のフロー制御アクティビティを使用して自由に構成できます。  
+  
+## 実行フローの制御  
+ ワークフロー アクティビティ ライブラリには、手続き型言語で使用されるほとんどのフロー制御方法をモデル化するアクティビティがあります。これには次のものが含まれます。  
+  
+-   <xref:System.Activities.Statements.While>  
+  
+-   <xref:System.Activities.Statements.DoWhile>  
+  
+-   <xref:System.Activities.Statements.ForEach>  
+  
+-   <xref:System.Activities.Statements.Parallel>  
+  
+-   <xref:System.Activities.Statements.ParallelForEach>  
+  
+-   <xref:System.Activities.Statements.If>  
+  
+-   <xref:System.Activities.Statements.Switch>  
+  
+-   <xref:System.Activities.Statements.Pick>  
+  
+ フロー制御アクティビティを使用するには、**\[アクティビティ\]** ツールボックスからデザイナー ウィンドウ内の複合アクティビティにドラッグ アンド ドロップします。  
+  
+> [!NOTE]
+>  [!INCLUDE[dublin](../../../includes/dublin-md.md)] を使用して Web ファーム上のワークフローをホストする場合、AppFabric は異なる AppFabric サーバー間でインスタンスを移動します。これには、リソースがすべてのノード間で共有される必要があります。既定の NET 4 ワークフロー アクティビティには、ローカル リソースにアクセスする操作が含まれていません。AppFabric はワークフローを普遍としてマークするメカニズムを提供しないため、開発者はワークフローが移動されると失敗するカスタム アクティビティを作成する必要があります。  
+  
+## 参照  
+ [Flowchart のワークフロー](../../../docs/framework/windows-workflow-foundation//flowchart-workflows.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/programming.md b/docs/framework/windows-workflow-foundation/programming.md
new file mode 100644
index 00000000000..bb892d514ea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/programming.md
@@ -0,0 +1,62 @@
+---
+title: "Windows Workflow Foundation プログラミングの新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF]"
+  - "WF [WF], プログラミング"
+  - "Windows Workflow Foundation [WF], プログラミング"
+ms.assetid: f62354e2-6a2b-4e8c-a4bc-533fb96267a4
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# Windows Workflow Foundation プログラミングの新機能
+このセクションには、[!INCLUDE[wf](../../../includes/wf-md.md)] の熟練したプログラマになるうえで理解する必要がある一連の入門トピックが含まれます。  
+  
+## このセクションの内容  
+ [ワークフローの設計](../../../docs/framework/windows-workflow-foundation//designing-workflows.md)  
+ ワークフローの開発で使用するフロー制御パラダイムについて説明します。  
+  
+ [アクティビティの使用と作成](../../../docs/framework/windows-workflow-foundation//using-and-creating-activities.md)  
+ [!INCLUDE[wf](../../../includes/wf-md.md)] で使用できる、システムによって提供されるアクティビティについて説明します。  
+  
+ [Windows Workflow Foundation のデータ モデル](../../../docs/framework/windows-workflow-foundation//data-model.md)  
+ [!INCLUDE[wf1](../../../includes/wf1-md.md)] の変数、引数、および式について説明します。  
+  
+ [ワークフロー内での入力の待機](../../../docs/framework/windows-workflow-foundation//waiting-for-input-in-a-workflow.md)  
+ ブックマークとメッセージング アクティビティの使用方法について説明します。  
+  
+ [例外、トランザクション、および補正](../../../docs/framework/windows-workflow-foundation//exceptions-transactions-and-compensation.md)  
+ ランタイム エラーを処理する例外ハンドラー、トランザクション、および補正の使用方法について説明します。  
+  
+ [ワークフローのホスティング](../../../docs/framework/windows-workflow-foundation//hosting-workflows.md)  
+ ワークフロー ホスト アプリケーションの作成の詳細について説明します。  
+  
+ [動的な更新](../../../docs/framework/windows-workflow-foundation//dynamic-update.md)  
+ 動的更新を使用して、永続化されたワークフロー インスタンスのワークフロー定義を更新する方法について説明します。  
+  
+ [ワークフロー サービス](../../../docs/framework/wcf/feature-details/workflow-services.md)  
+ サービスの宣言による作成をサポートするプログラミング モデルについて説明します。  
+  
+ [ワークフローの永続性](../../../docs/framework/windows-workflow-foundation//workflow-persistence.md)  
+ ワークフロー データを自動または手動で永続化したり、メモリからワークフローをアンロードするためのオプションについて説明します。  
+  
+ [移行のガイドライン](../../../docs/framework/windows-workflow-foundation//migration-guidance.md)  
+ 前のバージョンの [!INCLUDE[wf](../../../includes/wf-md.md)] からワークフローを移行する方法について説明します。  
+  
+ [ワークフロー追跡とトレース](../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)  
+ ワークフローの追跡とトレース、およびワークフロー アプリケーションを監視するためにこれらの機能を使用する方法について説明します。  
+  
+ [ワークフローのセキュリティ](../../../docs/framework/windows-workflow-foundation//workflow-security.md)  
+ SQL および [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] を使用する場合に、ワークフローのセキュリティを維持する方法について説明します。  
+  
+ [Windows Workflow Foundation 4 のパフォーマンス](../../../docs/framework/windows-workflow-foundation//performance.md)  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] 4 のパフォーマンスについて説明し、WF の以前のバージョンと比較します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/projects-targeting-dotnet-in-vs.md b/docs/framework/windows-workflow-foundation/projects-targeting-dotnet-in-vs.md
new file mode 100644
index 00000000000..ba4b12996a9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/projects-targeting-dotnet-in-vs.md
@@ -0,0 +1,38 @@
+---
+title: "Visual Studio 2010 での .NET Framework 3.0 および 3.5 を対象とするプロジェクトの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 81858ab7-763c-4eac-83fe-d7205e5c4c98
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# Visual Studio 2010 での .NET Framework 3.0 および 3.5 を対象とするプロジェクトの作成
+[!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を使用して、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] Version 3.0 または 3.5 を対象とするプロジェクトを作成します。このトピックでは、この実行方法について説明します。  
+  
+> [!NOTE]
+>  アクティビティを追加する際は、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の必要なバージョンが設定されていることを確認してください。アクティビティを追加した後でワークフローのターゲット バージョンを変更すると、ワークフロー検証が失敗します。  
+  
+> [!WARNING]
+>  .Net Framework 3.5 アクティビティを持つ [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] で既存のワークフローを開くと、`this.SetValue()` でエラーが発生します。以前のバージョンの .Net Framework で作成されたプロジェクトを開くには、最初にデザイナーで空白のワークフローを開き、.Net Framework 3.5 アクティビティを追加します。  
+  
+## Visual Studio 2010 で .NET Framework 3.0 または 3.5 プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を起動します。  
+  
+2.  **\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順にクリックします。  
+  
+3.  ダイアログ ボックス最上部のボックスで、必要なバージョンの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を選択します。  
+  
+## 対象となる .NET Framework のバージョンをアップグレードするには  
+  
+1.  ソリューション エクスプローラーでプロジェクトを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[対象のフレームワーク\]** ボックスの一覧で、必要なバージョンを選択します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/properties-of-sql-workflow-instance-store.md b/docs/framework/windows-workflow-foundation/properties-of-sql-workflow-instance-store.md
new file mode 100644
index 00000000000..8af93567a98
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/properties-of-sql-workflow-instance-store.md
@@ -0,0 +1,36 @@
+---
+title: "SQL Workflow Instance Store のプロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5bf75f3c-8f33-450d-967f-6ee862c14c67
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# SQL Workflow Instance Store のプロパティ
+このセクションの各トピックでは、SQL Workflow Instance Store のプロパティの詳細について説明します。  
+  
+## このセクションの内容  
+  
+-   [インスタンス エンコーディング オプション](../../../docs/framework/windows-workflow-foundation//instance-encoding-option.md)  
+  
+-   [インスタンス完了アクション](../../../docs/framework/windows-workflow-foundation//instance-completion-action.md)  
+  
+-   [インスタンス ロック例外アクション](../../../docs/framework/windows-workflow-foundation//instance-locked-exception-action.md)  
+  
+-   [ホストのロック更新時間](../../../docs/framework/windows-workflow-foundation//host-lock-renewal-period.md)  
+  
+-   [実行可能インスタンス検出期間](../../../docs/framework/windows-workflow-foundation//runnable-instances-detection-period.md)  
+  
+-   [接続文字列と接続文字列名](../../../docs/framework/windows-workflow-foundation//connection-string-and-connection-string-name.md)  
+  
+## 参照  
+ [Windows Server App Fabric Instance Store](http://go.microsoft.com/fwlink/?LinkId=201201)   
+ [App Fabric SQL Server Persistence Database](http://go.microsoft.com/fwlink/?LinkId=201202)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/properties-vs-arguments.md b/docs/framework/windows-workflow-foundation/properties-vs-arguments.md
new file mode 100644
index 00000000000..4e863d1de69
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/properties-vs-arguments.md
@@ -0,0 +1,27 @@
+---
+title: "プロパティと引数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 14651389-4a49-4cbb-9ddf-c83fdc155df1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# プロパティと引数
+データをアクティビティに渡すために使用可能なオプションはいくつかあります。<xref:System.Activities.InArgument> を使用する以外に、標準の CLR プロパティまたはパブリック <xref:System.Activities.ActivityAction> プロパティを使用してデータを受け取るアクティビティを開発できます。このトピックでは適切なメソッド型の選択方法について説明します。  
+  
+## CLR プロパティの使用  
+ データをアクティビティに渡す場合、CLR プロパティ \(Get および Set ルーチンを使用してデータを公開するパブリック メソッド\) は最も制限が大きいオプションです。ソリューションをコンパイルする際、CLR プロパティに渡すパラメーターの値がわかっている必要があります。この値はワークフローのすべてのインスタンスで同一です。このように、CLR プロパティに渡された値はコードで定義された定数に似ています。この値はアクティビティの有効期間を通じて変更されず、アクティビティの異なるインスタンスのために変更できません。<xref:System.Activities.Expressions.InvokeMethod%601.MethodName%2A> はアクティビティによって公開される CLR プロパティの一つです。アクティビティが呼び出すメソッドの名前は、実行時の要件に基づいて変更できず、アクティビティのすべてのインスタンスで同じです。  
+  
+## 引数の使用  
+ 引数は、データがアクティビティの有効期間内だけに一度評価されるとき使用する必要があります。つまり、値はアクティビティの有効期間中に変化しません。しかし値はアクティビティの異なるインスタンスごとに異なります。<xref:System.Activities.Statements.If.Condition%2A> は一度評価された値の例です。そのため引数として定義されます。<xref:System.Activities.Statements.WriteLine.Text%2A> は引数として定義すべきメソッドの別の例です。これはアクティビティの実行中に一回のみ評価されますが、アクティビティの異なるインスタンスごとに異なることができます。  
+  
+## ActivityAction の使用  
+ アクティビティの実行の有効期間中にデータを複数回評価する必要がある場合は <xref:System.Activities.ActivityAction> を使用してください。たとえば、<xref:System.Activities.Statements.While.Condition%2A> プロパティは <xref:System.Activities.Statements.While> ループを反復するたびに評価されます。この目的で <xref:System.Activities.InArgument> を使用した場合、引数は反復のたびに再評価されず、常に同じ結果を返すため、ループは終了しません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/rehosting-the-workflow-designer.md b/docs/framework/windows-workflow-foundation/rehosting-the-workflow-designer.md
new file mode 100644
index 00000000000..ecc02e0ea20
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/rehosting-the-workflow-designer.md
@@ -0,0 +1,32 @@
+---
+title: "ワークフロー デザイナーのホスト変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bec1fc28-f902-4edb-86c5-436cec802c2b
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ワークフロー デザイナーのホスト変更
+[!INCLUDE[wfd1](../../../includes/wfd1-md.md)]は、ワークフローを作成、変更、および監視する目的で [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] 以外の環境にホストを変更できます。  
+  
+ <xref:System.Activities.Presentation.WorkflowDesigner> 型はキャンバス、プロパティ グリッド、および他の要素のラッパーであり、デザイナーのホスト変更シナリオの多くに対応する基本的なプログラミング モデルを公開しています。[!INCLUDE[avalon1](../../../includes/avalon1-md.md)] アプリケーション内での <xref:System.Activities.Presentation.WorkflowDesigner> のホストは、[!INCLUDE[wfd2](../../../includes/wfd2-md.md)]の一般的なホスト変更シナリオです。  
+  
+## このセクションの内容  
+ [タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成](../../../docs/framework/windows-workflow-foundation//task-1-create-a-new-wpf-app.md)  
+  
+ [タスク 2: ワークフロー デザイナーのホスティング](../../../docs/framework/windows-workflow-foundation//task-2-host-the-workflow-designer.md)  
+  
+ [タスク 3: ツールボックス ペインと PropertyGrid ペインの作成](../../../docs/framework/windows-workflow-foundation//task-3-create-the-toolbox-and-propertygrid-panes.md)  
+  
+ [再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート](../../../docs/framework/windows-workflow-foundation//wf-features-in-the-rehosted-workflow-designer.md)  
+  
+## 参照  
+ [ワークフロー デザイン操作のカスタマイズ](../../../docs/framework/windows-workflow-foundation//customizing-the-workflow-design-experience.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/required-arguments-and-overload-groups.md b/docs/framework/windows-workflow-foundation/required-arguments-and-overload-groups.md
new file mode 100644
index 00000000000..a19c82968ce
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/required-arguments-and-overload-groups.md
@@ -0,0 +1,166 @@
+---
+title: "必須の引数とオーバーロード グループ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ca3ed06-b9af-4b85-8b70-88c2186aefa3
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 必須の引数とオーバーロード グループ
+アクティビティは、アクティビティの実行を有効にするためには特定の引数をバインドする必要があるように構成できます。`RequiredArgument` 属性は、アクティビティの特定の引数が必須であることを示す場合に使用します。また、`OverloadGroup` 属性は、必須の引数のカテゴリをグループ化する場合に使用します。これらの属性を使用することで、アクティビティ作成者は、単純なアクティビティ検証の構成も複雑な構成も適用できます。  
+  
+## 必須の引数の使用  
+ アクティビティで `RequiredArgument` 属性を使用するためには、<xref:System.Activities.RequiredArgumentAttribute> を使用して目的の引数を指定します。次の例では、2 つの必須引数がある `Add` アクティビティが定義されています。  
+  
+```csharp  
+public sealed class Add : CodeActivity<int>  
+{  
+    [RequiredArgument]  
+    public InArgument<int> Operand1 { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<int> Operand2 { get; set; }  
+  
+    protected override int Execute(CodeActivityContext context)  
+    {  
+        return Operand1.Get(context) + Operand2.Get(context);  
+    }  
+}  
+```  
+  
+ また、XAML では、必須引数の指定に <xref:System.Activities.RequiredArgumentAttribute> も使用されます。この例では、3 つの引数を使用して `Add` アクティビティを定義し、<xref:System.Activities.Statements.Assign%601> アクティビティを使用して追加操作を実行します。  
+  
+```xaml  
+<Activity x:Class="ValidationDemo.Add" ...>  
+  <x:Members>  
+    <x:Property Name="Operand1" Type="InArgument(x:Int32)">  
+      <x:Property.Attributes>  
+        <RequiredArgumentAttribute />  
+      </x:Property.Attributes>  
+    </x:Property>  
+    <x:Property Name="Operand2" Type="InArgument(x:Int32)">  
+      <x:Property.Attributes>  
+        <RequiredArgumentAttribute />  
+      </x:Property.Attributes>  
+    </x:Property>  
+    <x:Property Name="Result" Type="OutArgument(x:Int32)" />  
+  </x:Members>  
+  <Assign>  
+    <Assign.To>  
+      <OutArgument x:TypeArguments="x:Int32">[Result]</OutArgument>  
+    </Assign.To>  
+    <Assign.Value>  
+      <InArgument x:TypeArguments="x:Int32">[Operand1 + Operand2]</InArgument>  
+    </Assign.Value>  
+  </Assign>  
+</Activity>  
+```  
+  
+ アクティビティが使用され、いずれかの必須引数がバインドされていない場合は、次の検証エラーが返されます。  
+  
+ **"Value for a required activity argument 'Operand1' was not supplied."**   
+> [!NOTE]
+>  検証のエラーと警告の確認方法と処理方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[アクティビティ検証の呼び出し](../../../docs/framework/windows-workflow-foundation//invoking-activity-validation.md)」を参照してください。  
+  
+## オーバーロード グループの使用  
+ オーバーロード グループには、あるアクティビティ内で有効である引数の組み合わせを示すメソッドが用意されています。引数は <xref:System.Activities.OverloadGroupAttribute> を使用してグループ化されます。各グループには、<xref:System.Activities.OverloadGroupAttribute> によって指定される名前が与えられます。アクティビティが有効なのは、オーバーロード グループに含まれる 1 つの引数セットのみがバインドされる場合です。次の例では、[OverloadGroups](../../../docs/framework/windows-workflow-foundation/samples/overloadgroups.md) サンプルから取られた、`CreateLocation` クラスが定義されます。  
+  
+```csharp  
+class CreateLocation: Activity  
+{  
+    [RequiredArgument]  
+    public InArgument<string> Name { get; set; }  
+  
+    public InArgument<string> Description { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G1")]  
+    public InArgument<int> Latitude { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G1")]  
+    public InArgument<int> Longitude { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G2")]  
+    [OverloadGroup("G3")]  
+    public InArgument<string> Street { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G2")]  
+    public InArgument<string> City { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G2")]  
+    public InArgument<string> State { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("G3")]  
+    public InArgument<int> Zip { get; set; }                  
+}  
+```  
+  
+ このアクティビティの目的は、米国内の場所を指定することです。これを行うために、アクティビティのユーザーは、3 つある引数グループの 1 つを使用して場所を指定できます。引数の有効な組み合わせを指定するため、3 種類のオーバーロード グループを定義します。`G1` には `Latitude` および `Longitude` の引数が含まれます。`G2` には `Street`、`City`、および `State` が含まれます。`G3` には `Street` および `Zip` が含まれます。`Name` も必要な引数ですが、オーバーロード グループの一部ではありません。このアクティビティを有効にするには、1 つのオーバーロード グループのみから、すべての引数をバインドすると共に、`Name` をバインドする必要があります。  
+  
+ [データベース アクセス アクティビティ](../../../docs/framework/windows-workflow-foundation/samples/database-access-activities.md) サンプルから取得された次の例では、2 個のオーバーロード グループ `ConnectionString` および `ConfigFileSectionName` があります。このアクティビティを有効にするには、`ProviderName` および `ConnectionString` の引数がバインドされるか、`ConfigName` の引数がバインドされる必要がありますが、両方同時にバインドすることはできません。  
+  
+```  
+Public class DbUpdate: AsyncCodeActivity  
+{  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ProviderName { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DependsOn("ProviderName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConnectionString { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConfigFileSectionName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConfigName { get; set; }  
+  
+    [DefaultValue(null)]  
+    public CommandType CommandType { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<string> Sql { get; set; }  
+  
+    [DependsOn("Sql")]  
+    [DefaultValue(null)]  
+    public IDictionary<string, Argument> Parameters { get; }  
+  
+    [DependsOn("Parameters")]  
+    public OutArgument<int> AffectedRecords { get; set; }       
+}  
+```  
+  
+ オーバーロード グループを定義する場合:  
+  
+-   オーバーロード グループを別のオーバーロード グループのサブセットまたは等価セットにすることはできません。  
+  
+    > [!NOTE]
+    >  この規則には例外が 1 つあります。オーバーロード グループが別のオーバーロード グループのサブセットであり、サブセットに `RequiredArgument` が `false` である引数のみが含まれている場合、オーバーロード グループは有効です。  
+  
+-   複数のオーバーロード グループは重なることはできます。しかし、一方か両方のオーバーロード グループの必須引数すべてがグループの積集合に含まれると、エラーになります。前の例では `G2` および `G3` のオーバーロード グループはオーバーラップしましたが、共通部分には一方または両方のグループの引数すべてが含まれてはいなかったため有効でした。  
+  
+ オーバーロード グループの引数をバインドする場合:  
+  
+-   オーバーロード グループ内の `RequiredArgument` 引数すべてがバインドされている場合、そのグループはバインドされていると見なされます。  
+  
+-   グループに `RequiredArgument` 引数がなく、1 つ以上の引数がバインドされている場合、そのグループはバインドされていると見なされます。  
+  
+-   複数あるオーバーロード グループのうち、1 つもバインドされていない場合は、検証エラーになります。ただし、1 つのオーバーロード グループに `RequiredArgument` 引数が 1 つもない場合を除きます。  
+  
+-   複数のオーバーロード グループをバインドすると、エラーになります。つまり、1 つのオーバーロード グループの必須引数すべてがバインドされ、かつ別のオーバーロード グループの任意の引数もバインドされると、エラーになります。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/runnable-instances-detection-period.md b/docs/framework/windows-workflow-foundation/runnable-instances-detection-period.md
new file mode 100644
index 00000000000..fcc34e3e3e9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/runnable-instances-detection-period.md
@@ -0,0 +1,22 @@
+---
+title: "実行可能インスタンス検出期間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4ea5c787-b638-47fd-bfc8-ede8c2898ce6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 実行可能インスタンス検出期間
+SQL Workflow Instance Store が実行する内部タスクは、定期的にアクティブになり、実行可能またはアクティブ化可能なインスタンスを永続性データベースで検出します。SQL Workflow Instance Store の**実行可能インスタンス検出期間**プロパティは、前の検出サイクルの後、SQL Workflow Instance Store が実行可能またはアクティブ化可能なワークフロー インスタンスを永続性データベースで検出するために検出タスクを実行するまでの期間を指定します。  
+  
+ このプロパティの間隔を短く設定すると、ワークフロー インスタンスに関連付けられたタイマーの期限切れと、イベントのシグナリングおよび後続のインスタンスの読み込みの間の時間が短くなります。ただし、ホストにかかる処理の負荷も増えるため、永続的なタイマーやホスト エラーがまれなシナリオでは望ましくない場合があります。プロパティの型は TimeSpan で、プロパティの値は hh:mm:ss の形式です。このプロパティの最小値は 00:00:01 です。プロパティの既定値は 00:00:05 です。  
+  
+ 実行可能およびアクティブ化可能なワークフロー インスタンスを検出およびアクティブ化する方法の詳細については、「[インスタンスのアクティブ化処理](../../../docs/framework/windows-workflow-foundation//instance-activation.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/runtime-activities-in-wf.md b/docs/framework/windows-workflow-foundation/runtime-activities-in-wf.md
new file mode 100644
index 00000000000..164aeadb4c0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/runtime-activities-in-wf.md
@@ -0,0 +1,24 @@
+---
+title: "WF のランタイム アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e5ae8c31-19bc-4655-88b3-6b75cd6a1bd5
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# WF のランタイム アクティビティ
+[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] には、永続化や終了などのワークフロー ランタイムの機能にアクセスするために、システムによって提供されるアクティビティがいくつか用意されています。  
+  
+|アクティビティ|説明|  
+|-------------|--------|  
+|<xref:System.Activities.Statements.Persist>|ワークフローがその状態を永続化するように明示的に要求します。|  
+|<xref:System.Activities.Statements.TerminateWorkflow>|実行中のワークフロー インスタンスを終了します。|  
+|<xref:System.Activities.Statements.NoPersistScope>|子アクティビティの永続化を防ぐコンテナー アクティビティ。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/TOC.md b/docs/framework/windows-workflow-foundation/samples/TOC.md
new file mode 100644
index 00000000000..454b8542210
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/TOC.md
@@ -0,0 +1,141 @@
+# [検証](validation.md)
+# [ルールのサンプル](rules-samples.md)
+# [カスタム複合デザイナー - Workflow Item Presenter](custom-composite-designers-workflow-item-presenter.md)
+# [カスタム アクティビティ デザイナーでの ExpressionTextBox の使用](using-the-expressiontextbox-in-a-custom-activity-designer.md)
+# [Windows のイベント トレースへの追跡イベント](tracking-events-into-event-tracing-in-windows.md)
+# [WorkflowApplication ReadLine ホスト](workflowapplication-readline-host.md)
+# [条件付きアクティビティ グループ](conditioned-activity-group.md)
+# [中断されたインスタンスの管理](suspended-instance-management.md)
+# [制限された並列 ForEach](throttled-parallel-foreach.md)
+# [XAMLX における永続的な遅延](durable-delay-in-xamlx.md)
+# [ネイティブ アクティビティを使用したカスタム複合](custom-composite-using-native-activity.md)
+# [サービス内での TransactionScope の入れ子化](nesting-of-transactionscope-within-a-service.md)
+# [Send によるチャネル キャッシュ](channel-caching-with-send.md)
+# [追跡を使用した WF データの抽出](extract-wf-data-using-tracking.md)
+# [コレクション アクティビティの使用](using-collection-activities.md)
+# [Windows Workflow のサンプル](index.md)
+# [非ジェネリックの ParallelForEach](non-generic-parallelforeach.md)
+# [While アクティビティでの中断のエミュレート](emulating-breaking-in-a-while-activity.md)
+# [カスタム アクティビティ デザイナー](custom-activity-designers.md)
+# [DynamicActivity の作成](dynamicactivity-creation.md)
+# [雇用プロセス](hiring-process.md)
+# [入力アクティビティの待機](wait-for-input-activity.md)
+# [TransactedReceiveScope の使用](use-of-transactedreceivescope.md)
+# [OverloadGroups](overloadgroups.md)
+# [シナリオ](scenario.md)
+# [RangeEnumeration アクティビティ](rangeenumeration-activity.md)
+# [ルール付き IfElse](ifelse-with-rules.md)
+# [相関電卓](correlated-calculator.md)
+# [基本的なアクティビティの構成](basic-activity-composition.md)
+# [基本的な XAML 専用サービス](basic-xaml-only-service.md)
+# [エンティティ アクティビティ](entity-activities.md)
+# [デザイナー](designer.md)
+# [WorkflowInstanceId の取得](get-workflowinstanceid.md)
+# [命令型 TransactionScope でのワークフローの実行](execute-a-workflow-in-an-imperative-transactionscope.md)
+# [SQL 追跡](sql-tracking.md)
+# [基本検証](basic-validation.md)
+# [正規表現アクティビティ](regular-expression-activities.md)
+# [Pick アクティビティの使用](using-the-pick-activity.md)
+# [LINQ メッセージ クエリの関連付け](linq-message-query-correlation.md)
+# [制約の種類](constraint-types.md)
+# [デザイナーのホスト変更](designer-rehosting.md)
+# [InvokeMethod アクティビティの使用](using-the-invokemethod-activity.md)
+# [絶対遅延](absolute-delay.md)
+# [トランザクション キュー](transacted-queues.md)
+# [サービス](services.md)
+# [追跡](tracking.md)
+# [補正可能なアクティビティでのキャンセル ハンドラー](cancellation-handler-on-compensable-activity.md)
+# [トランザクション](transactions.md)
+# [ワークフロー アプリケーションの永続化](persisting-a-workflow-application.md)
+# [実行](execution.md)
+# [デザイナーによって XAML ファイルに追加されるビューステートの削除](removing-the-view-state-the-designer-adds-to-an-xaml-file.md)
+# [WorkflowHostingEndpoint 再開ブックマーク](workflowhostingendpoint-resume-bookmark.md)
+# [企業の購買プロセス](corporate-purchase-process.md)
+# [XAML での WPF と WF の統合](wpf-and-wf-integration-in-xaml.md)
+# [External RuleSet Toolkit](external-ruleset-toolkit.md)
+# [バッファーされた受信機能](buffered-receive.md)
+# [ドキュメント承認プロセス](document-approval-process.md)
+# [NoPersistScope アクティビティ](nopersistscope-activity.md)
+# [エラーの送信と処理](sending-and-handling-faults.md)
+# [WorkflowHostingEndpoint のブックマーク リゾルバー](bookmark-resolver-for-workflowhostingendpoint.md)
+# [ActivityAction の公開と呼び出し](exposing-and-invoking-activityactions.md)
+# [External Data Exchange での Interop の使用](using-interop-with-external-data-exchange.md)
+# [3.5 ルール セットとの相互運用](interop-with-3-5-rule-set.md)
+# [InvokePowerShell アクティビティの使用](using-the-invokepowershell-activity.md)
+# [SendMail カスタム アクティビティ](sendmail-custom-activity.md)
+# [.NET Framework 4.5 の外部化されたポリシー アクティビティ](externalized-policy-activity-in-net-framework-4-5.md)
+# [検証](validation.md)
+# [.NET Framework 4.5 のポリシー アクティビティ](policy-activity-in-net-framework-4-5.md)
+# [FlowChart と Pick の組み合わせを使用する StateMachine シナリオ](statemachine-scenario-using-a-combination-of-flowchart-and-pick.md)
+# [コンテンツ ベースの相関関係](content-based-correlation.md)
+# [確認](confirmation.md)
+# [Basic](basic.md)
+# [複合](composite.md)
+# [プロパティ昇格アクティビティ](property-promotion-activity.md)
+# [トランザクションのロールバック](transaction-rollback.md)
+# [永続性](persistence.md)
+# [編集スコープの使用](using-editing-scope.md)
+# [高度なポリシー](advanced-policy.md)
+# [ツールボックス サービス](toolbox-service.md)
+# [Hello World カスタム アクティビティ](hello-world-custom-activity.md)
+# [カスタム複合デザイナー - Workflow Items Presenter](custom-composite-designers-workflow-items-presenter.md)
+# [アクティビティの関係の検証](activity-relationships-validation.md)
+# [ワークフロー サービスでのメッセージの書式設定](formatting-messages-in-workflow-services.md)
+# [.NET Framework 4.5 ワークフローでの .NET Framework 3.0 または .NET Framework 3.5 アクティビティの使用](using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md)
+# [簡単なポリシー](simple-policy.md)
+# [自動確認パターン](auto-confirm-pattern.md)
+# [ポリシーを使用した注文処理](order-processing-with-policy.md)
+# [LINQ to SQL](linq-to-sql-sample.md)
+# [SQLStoreExtensibility](sqlstoreextensibility.md)
+# [カスタム アクティビティ](custom-activities.md)
+# [コード本文](code-bodied.md)
+# [メタデータ ストアのプログラム性](metadata-store-programmability.md)
+# [補正可能なアクティビティ](compensable-activity-sample.md)
+# [非ジェネリックの ForEach](non-generic-foreach.md)
+# [テキスト ファイルを使用した追跡](tracking-using-a-text-file.md)
+# [OperationScope](operationscope.md)
+# [ワークフロー サービスのセキュリティ保護](securing-workflow-services.md)
+# [アクティビティ ライブラリ](activity-library.md)
+# [サービス](services.md)
+# [移行](migration.md)
+# [トランザクション](basic-transactions.md)
+# [TryCatch を使用した Flowchart アクティビティでのエラー処理](fault-handling-in-a-flowchart-activity-using-trycatch.md)
+# [OperationContext へのアクセス](accessing-operationcontext.md)
+# [永続的な二重](durable-duplex.md)
+# [トランザクション スコープの抑制](suppress-transaction-scope.md)
+# [外部アクティビティの検証](external-activity-validation.md)
+# [XAML アクティベーション](xaml-activation.md)
+# [カスタム型を使用した Switch アクティビティの使用](usage-of-the-switch-activity-with-custom-types.md)
+# [値の範囲で切り替えを行うカスタム アクティビティ](custom-activity-to-switch-on-a-range-of-values.md)
+# [式](expressions.md)
+# [LINQ to Objects アクティビティ](linq-to-objects-activity.md)
+# [補正](compensation-samples.md)
+# [ワークフロー管理エンドポイントのサンプル](workflow-management-endpoint-sample.md)
+# [CancellationScope の使用](using-cancellationscope.md)
+# [カスタム アクティビティの記述について](getting-started-writing-a-custom-activity.md)
+# [カスタム補正](custom-compensation-sample.md)
+# [トランザクション コンボイ スコープ](transaction-convoy-scope.md)
+# [プロパティ グリッドの拡張](property-grid-extensibliity.md)
+# [組み込みの構成](built-in-configuration.md)
+# [CommentOut アクティビティ](commentout-activity.md)
+# [ビルトイン アクティビティ](built-in-activities.md)
+# [実行プロパティ](execution-properties.md)
+# [For アクティビティ](for-activity.md)
+# [カスタム追跡](custom-tracking.md)
+# [.NET Framework 3.5 ルールセットでの変数の使用](using-variables-with-dotnet-ruleset.md)
+# [アプリケーション](application.md)
+# [永続的な遅延](durable-delay.md)
+# [XAML からの読み込み](load-from-xaml.md)
+# [基本 TransactionScope](basic-transactionscope.md)
+# [手続き型アクティビティの使用](using-procedural-activities.md)
+# [SendParameters および ReceiveParameters アクティビティの基本的な使用方法](basic-usage-of-sendparameters-and-receiveparameters-activities.md)
+# [ワークフロー インスタンスの作成と実行](creating-and-running-a-workflow-instance.md)
+# [データベース アクセス アクティビティ](database-access-activities.md)
+# [非同期通信](asynchronous-communication.md)
+# [動的引数](dynamic-arguments.md)
+# [WorkflowInvoker クラスの使用](using-the-workflowinvoker-class.md)
+# [アクティビティでの AsyncOperationContext の使用](using-asyncoperationcontext-in-an-activity-sample.md)
+# [InvokeMethod](invokemethod.md)
+# [ブックマーク](bookmarks.md)
+# [モデル アイテム ツリーのプログラミング](programming-model-item-tree.md)
+# [ビジュアル ワークフロー追跡](visual-workflow-tracking.md)
diff --git a/docs/framework/windows-workflow-foundation/samples/absolute-delay.md b/docs/framework/windows-workflow-foundation/samples/absolute-delay.md
new file mode 100644
index 00000000000..255b0bcca8d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/absolute-delay.md
@@ -0,0 +1,77 @@
+---
+title: "絶対遅延 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b483139a-39bb-4560-8003-8969a8fc2cd1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 絶対遅延
+このサンプルの主要なシナリオは、ワークフロー アプリケーションで永続的なタイマーを使用して、指定した <xref:System.DateTime> まで遅延することです。これは、特定の <xref:Sysem.TimeSpan> \(または分数\/秒数\) の遅延のみ行うことができるため、組み込みの <xref:System.Activities.Statements.Delay> アクティビティの使用とは異なります。  
+  
+ この区別を行う現実のシナリオとして、次のようなものがあります。  
+  
+1.  メールの送信を 30 秒遅延させて、誤りがないことを確認します。  
+  
+2.  時間外に作業し、通常の営業時間 \(午前 8 時など\) まですべてのメールを遅延させます。  
+  
+## 使用例  
+  
+1.  絶対遅延を実装するための <xref:System.Activities.Statements.DurableTimerExtension>  
+  
+2.  永続的なタイマーに <xref:System.Activities.WorkflowApplication> を使用した永続性の設定  
+  
+3.  拡張ポイントを使用するための <xref:System.Activities.NativeActivity%601> の使用  
+  
+4.  SendEmail アクティビティでの <xref:System.Activities.CodeActivity%601> の使用  
+  
+5.  <xref:System.Activities.Statements.Delay>  
+  
+6.  XAML のみのワークフロー  
+  
+ このサンプルでは、<xref:System.DateTime> を取得するカスタム アクティビティの作成方法と、永続的なタイマーを使用して遅延期間を登録する方法を示します。永続的なタイマーを使用している場合は、<xref:System.Activities.NativeActivity> を使用してブックマークを作成する必要があります。このブックマークをタイマー拡張に登録する必要があります。このサンプルでは、永続的なタイマーが時間切れになると、`OnTimerExpired` メソッドが呼び出されます。タイマー拡張を <xref:System.Activities.NativeActivity%601.CacheMetadata%2A> イベントに追加して、この情報がランタイムに確実に提供されるようにします。永続的なタイマーは <xref:System.DateTime> のみを取得するため、その他の実装詳細として挙げられるものは、<xref:System.DateTime> から <xref:Sysem.TimeSpan> に変換するためのロジックを実装する必要があることのみです。次の操作を行うことで、精度に小さな逸脱があることに注意します。  
+  
+> [!NOTE]
+>  <xref:System.DateTime> から <xref:Sysem.TimeSpan> への変換により、精度が若干低下します。  
+  
+ このサンプルは、<xref:System.Activities.WorkflowApplication> の永続性をオンにする方法も示しています。このサンプルでは、タイマーの時間切れを待機している間のアイドル時間中にワークフロー データが永続性データベースにアンロードされる永続的なタイマーを使用します。この実装は、他の永続性アクションにも使用できます。このサンプルは、SQL Server で永続性接続文字列を設定する方法、およびワークフロー インスタンスのデータを永続化するためにインスタンス ストアを作成する方法を示しています。ワークフロー インスタンスを実行可能にするイベントが発生した後でワークフローを再開する方法に関するロジックも提供されています。  
+  
+ このサンプルをステップ実行すると、電子メール メッセージが送信される原因となる組み込みの遅延が開始および完了する時刻が表示されます。ここから、AbsoluteDelay アクティビティは指定した <xref:System.DateTime> まで \(または <xref:System.DateTime> を経過している場合は 0 秒間\) 停止します。時間切れになると、電子メールが送信されます。これは、組み込みの <xref:System.Activities.Statements.Delay> 機能と AbsoluteDelay アクティビティの使用の 2 つの異なるユース ケースを示します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  SQL Server Express \(またはそれ以降\) がコンピューターにインストールされていることを確認します。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトで setup.cmd \(WF\/Basic\/Services\/AbsoluteDelay\/CS にあります\) を実行して AbsoluteDelaySampleDB データベースを作成し、永続性スキーマと永続性ロジックを作成します。  
+  
+3.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+4.  Delay アクティビティに Duration を指定します。  
+  
+5.  AbsoluteDelay アクティビティに ExpirationTime を指定します。  
+  
+6.  SendMail アクティビティの SendMailTo、SendMailFrom、SendMailSubject、SendMailBody、SmtpHost の各フィールドを更新します。  
+  
+    > [!NOTE]
+    >  有効な SMTP ホストを入力しない場合は、アプリケーションで SMTP 例外がスローされます。  
+  
+7.  **\[ビルド\]**、**\[ソリューションのビルド\]** の順にクリックして、ソリューションをビルドします。  
+  
+8.  **F5** キーを押して、ソリューションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\AbsoluteDelay`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/accessing-operationcontext.md b/docs/framework/windows-workflow-foundation/samples/accessing-operationcontext.md
new file mode 100644
index 00000000000..190f9233a0b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/accessing-operationcontext.md
@@ -0,0 +1,51 @@
+---
+title: "OperationContext へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e92efe8-7e79-41f3-b50e-bdc38b9f41f8
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# OperationContext へのアクセス
+このサンプルでは、メッセージング アクティビティ \(<xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.Send>\) を、カスタムのスコープ アクティビティと共に使用して <xref:System.ServiceModel.OperationContext.Current%2A> にアクセスし、送信メッセージまたは受信メッセージ内のカスタム メッセージ ヘッダーを追加または取得する方法を示します。  
+  
+## 使用例  
+ メッセージング アクティビティ、<xref:System.ServiceModel.Activities.ISendMessageCallback>、<xref:System.ServiceModel.Activities.IReceiveMessageCallback>。  
+  
+## 説明  
+ このサンプルでは、メッセージング アクティビティで拡張ポイント \(<xref:System.ServiceModel.Activities.ISendMessageCallback> および <xref:System.ServiceModel.Activities.IReceiveMessageCallback>\) を使用して <xref:System.ServiceModel.OperationContext.Current%2A> にアクセスする方法を示します。これらのコールバックは、実行時にメッセージング アクティビティによって取得される <xref:System.Activities.IExecutionProperty> の実装としてワークフロー ランタイム内に登録されます。その <xref:System.Activities.IExecutionProperty> 実装と同じスコープ内のメッセージング アクティビティはすべて影響を受けます。具体的には、このサンプルでは、カスタムのスコープ アクティビティを使用してコールバック動作を適用します。<xref:System.ServiceModel.Activities.ISendMessageCallback> は、ワークフローの <xref:System.Activities.WorkflowApplication.Id%2A> を送信 <xref:System.ServiceModel.Channels.MessageHeader> として含めるためにクライアント ワークフローで使用されます。このヘッダーはサービスで <xref:System.ServiceModel.Activities.IReceiveMessageCallback> を使用して取得され、ヘッダーの値がコンソールに出力されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルでは、HTTP エンドポイントを使用してワークフロー サービスを公開します。このサンプルを実行するには、適切な URL ACL を追加する必要があります \(詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照\)。適切な ACL を追加するには、Visual Studio を管理者として実行するか、権限のレベルが高いプロンプトで次のコマンドを実行します。ドメインとユーザー名は置き換えてください。  
+  
+    ```  
+    netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%  
+    ```  
+  
+2.  URL ACL を追加したら、次の手順を実行します。  
+  
+    1.  ソリューションをビルドします。  
+  
+    2.  ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックして、複数のスタートアップ プロジェクトを設定します。  
+  
+    3.  複数のスタートアップ プロジェクトとして **Service** および **Client** を \(この順序で\) 追加します。  
+  
+    4.  アプリケーションを実行します。クライアント コンソールに実行中のワークフローが 2 回示され、\[サービス\] ウィンドウにこれらのワークフローのインスタンス ID が示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\Accessing Operation Context`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/activity-library.md b/docs/framework/windows-workflow-foundation/samples/activity-library.md
new file mode 100644
index 00000000000..9356f09a2d7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/activity-library.md
@@ -0,0 +1,76 @@
+---
+title: "アクティビティ ライブラリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5323e9d4-71d6-47eb-bfa6-31feac62044d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# アクティビティ ライブラリ
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] の高度なカスタム アクティビティを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [.NET Framework 4.5 のポリシー アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md)  
+ Policy4 アクティビティで [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] \(WF 3.5\) <xref:System.Workflow.Activities.Rules.RuleSet> オブジェクト内の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] を、WF 3.5 に付属しているルール エンジンを使用して [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] \(WF 4.5\) の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] で直接使用できるようにする方法を示します。  
+  
+ [値の範囲で切り替えを行うカスタム アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/custom-activity-to-switch-on-a-range-of-values.md)  
+ <xref:System.Activities.Statements.Switch%601> の使用を拡張するカスタム アクティビティを作成する方法を示します。  
+  
+ [LINQ to Objects アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/linq-to-objects-activity.md)  
+ LINQ to Objects を使用してコレクション内の要素に対してクエリを実行するアクティビティを作成する方法を示します。  
+  
+ [LINQ to SQL](../../../../docs/framework/windows-workflow-foundation/samples/linq-to-sql-sample.md)  
+ SQL Server データベース内のテーブルの LINQ to SQL クエリ エンティティを使用するアクティビティを作成する方法を示します。  
+  
+ [InvokePowerShell アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-the-invokepowershell-activity.md)  
+ InvokePowerShell アクティビティを使用して Windows PowerShell コマンドを呼び出す方法を示します。  
+  
+ [RangeEnumeration アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/rangeenumeration-activity.md)  
+ 数値のコレクションを反復処理するカスタム アクティビティを作成する方法を示します。  
+  
+ [正規表現アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/regular-expression-activities.md)  
+ <xref:System.Text.RegularExpressions> 名前空間の正規表現機能を公開する一連のアクティビティを作成する方法を示します。  
+  
+ [SendMail カスタム アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/sendmail-custom-activity.md)  
+ <xref:System.Activities.AsyncCodeActivity> から派生するカスタム アクティビティを作成して、SMTP を使用して電子メールを送信し、ワークフロー アプリケーション内で使用する方法を示します。  
+  
+ [For アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/for-activity.md)  
+ <xref:System.Activities.NativeActivity> から継承するカスタム アクティビティを構築し、そのアクティビティをワークフローで使用して値の範囲を反復処理する方法を示します。  
+  
+ [入力アクティビティの待機](../../../../docs/framework/windows-workflow-foundation/samples/wait-for-input-activity.md)  
+ ワークフローに名前付きブックマークを作成する方法を示します。  
+  
+ [制限された並列 ForEach](../../../../docs/framework/windows-workflow-foundation/samples/throttled-parallel-foreach.md)  
+ `ThrottleParallelForEach` アクティビティは、実行する同時分岐の数を制限するための同時実行要因を設定できるという 1 つの例外を除き、<xref:System.Activities.Statements.ParallelForEach%601> アクティビティと似ていることについて示します。  
+  
+ [エンティティ アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/entity-activities.md)  
+ ADO.NET Entity Framework と [!INCLUDE[wf2](../../../../includes/wf2-md.md)] を使用してデータ アクセスを簡素化する方法を示します。  
+  
+ [データベース アクセス アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/database-access-activities.md)  
+ データベースにアクセスして情報を取得または変更できるアクティビティを作成する方法と、[ADO.NET](http://go.microsoft.com/fwlink/?LinkId=166081) を使用してデータベースにアクセスする方法を示します。  
+  
+ [CommentOut アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/commentout-activity.md)  
+ 実行のパスから他のアクティビティを削除し、それらを有効にコメント化するカスタム アクティビティを記述する方法を示します。  
+  
+ [.NET Framework 4.5 の外部化されたポリシー アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/externalized-policy-activity-in-net-framework-4-5.md)  
+ ExternalizedPolicy4 アクティビティで [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] \(WF 3.5\) <xref:System.Workflow.Activities.Rules.RuleSet> オブジェクト内の既存の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] を、WF 3.5 に付属しているルール エンジンを使用して [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] \(WF 4.5\) の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] で直接実行できるようにする方法を示します。  
+  
+ [NoPersistScope アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/nopersistscope-activity.md)  
+ ワークフローでシリアル化不可能で破棄可能な状態を処理する方法を示します。  
+  
+ [非ジェネリックの ForEach](../../../../docs/framework/windows-workflow-foundation/samples/non-generic-foreach.md)  
+ <xref:System.Activities.Statements.ForEach%601> アクティビティの非ジェネリック バージョンを作成する方法を示します。  
+  
+ [非ジェネリックの ParallelForEach](../../../../docs/framework/windows-workflow-foundation/samples/non-generic-parallelforeach.md)  
+ <xref:System.Activities.Statements.ParallelForEach%601> アクティビティの非ジェネリック バージョンを作成する方法を示します。  
+  
+ [WorkflowInstanceId の取得](../../../../docs/framework/windows-workflow-foundation/samples/get-workflowinstanceid.md)  
+ カスタム アクティビティ `GetWorkflowInstanceId` を使用して、ワークフロー インスタンス ID を返す方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/activity-relationships-validation.md b/docs/framework/windows-workflow-foundation/samples/activity-relationships-validation.md
new file mode 100644
index 00000000000..680c51d026c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/activity-relationships-validation.md
@@ -0,0 +1,50 @@
+---
+title: "アクティビティの関係の検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6f11a34e-ed67-4bce-88ce-7e96bbb4d052
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# アクティビティの関係の検証
+このサンプルには 3 つのアクティビティ `CreateCity`、`CreateState`、および `CreateCountry` が含まれます。`CreateCity` は `CreateState` アクティビティ内にあり、`CreateState` は `CreateCountry` アクティビティ内にある必要があります。このサンプルの目的から、検証ロジックは、`CreateState` アクティビティについてはコードで記述され、`CreateCity` アクティビティについては XAML で記述されます。制約の動作は両方とも同じです。  
+  
+ [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] には、アクティビティ間の関係を検証するために使用できる次の 3 つのヘルパー アクティビティが用意されています。  
+  
+ <xref:System.Activities.Validation.GetParentChain>  
+ 現在のノードの親に属しているすべてのアクティビティのコレクションを提供します。  
+  
+ <xref:System.Activities.Validation.GetChildSubtree>  
+ 現在のノードのサブツリーに属しているすべてのアクティビティのコレクションを提供します \(現在のノードを除く\)。  
+  
+ <xref:System.Activities.Validation.GetWorkflowTree>  
+ 現在のノードと同じツリーにあるすべてのアクティビティのコレクションを提供します。  
+  
+ このサンプルでは、<xref:System.Activities.Statements.ForEach%601> アクティビティを使用して、<xref:System.Activities.Validation.GetParentChain> から返されたコレクション内のすべての要素を処理します。コレクション内の要素ごとに、その型が `CreateCountry` \(`CreateCity` を検証する場合は `CreateState`\) と比較され、一致が見つかると、結果フラグが `true` に設定されます。最後に、結果フラグが `false` に設定される場合は、<xref:System.Activities.Validation.AssertValidation> を使用して検証エラーが生成されます。  
+  
+### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ContainmentValidation.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドします。  
+  
+3.  CTRL キーを押しながら F5 キーを押して、プログラムを起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Validation\ActivityRelationships`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/advanced-policy.md b/docs/framework/windows-workflow-foundation/samples/advanced-policy.md
new file mode 100644
index 00000000000..e848d00fa47
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/advanced-policy.md
@@ -0,0 +1,88 @@
+---
+title: "高度なポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 75a22c88-5e54-4ae8-84cb-fbb22a612f0a
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 高度なポリシー
+このサンプルは、単純なポリシーのサンプルを拡張するものです。単純なポリシーのサンプルに含まれる個人向け割引ルールとビジネス割引ルールの他に、新しいルールがいくつか追加されています。  
+  
+ 高額な注文に対する割引額を大きく設定する、高額ルールが追加されています。このルールの優先順位の値は前の 2 つのルールより小さいので、割引フィールドを上書きし、個人向けおよびビジネス向けの両方の割引ルールよりも優先されます。  
+  
+ 割引レベルに基づいて合計額を計算する、合計の計算ルールも追加されています。ワークフロー アクティビティに定義されたメソッドの参照方法と、他のアクションの使用方法を示します。また、このルールは、割引フィールドが変更されるたびに評価されるため、チェーン動作についても示します。さらに、メソッドに対する属性の適用についても、CalculateTotal メソッドに RuleWriteAttribute 属性を適用する例で示します。これにより、メソッドが実行されるたびに、影響を受けるルール \(ErrorTotalRule\) が再評価されます。  
+  
+ 追加された最後のルールはエラーを検出するルールです \(ここでは、Total は 0 未満\)。エラーが検出されると、ポリシーの実行は停止されます。  
+  
+ 最後に、`Console.Writeline` 呼び出しがアクションとして各ルールに追加されています。これは、ルール実行についての詳細を表示できるようにするため、また、参照型の静的メソッドにアクセスできることを示すためのものです。追跡を使用して、実行されるルールの詳細を表示することもできます。  
+  
+ このサンプルで使用されているルールを次に示します。  
+  
+ **ResidentialDiscountRule:**  
+  
+ IF OrderValue \> 500 AND CustomerType OrderValue \= Residential  
+  
+ THEN Discount \= 5%  
+  
+ **BusinessDiscountRule:**  
+  
+ IF OrderValue \> 10000 AND CustomerType OrderValue \= Business  
+  
+ THEN Discount \= 10%  
+  
+ **HighValueDiscountRule:**  
+  
+ IF OrderValue 20000 \>  
+  
+ THEN Discount \= 15%  
+  
+ **TotalRule:**  
+  
+ IF Discount \> 0  
+  
+ THEN CalculateTotal\(OrderValue, Discount\)  
+  
+ ELSE Total \= OrderValue  
+  
+ **ErrorTotalRule:**  
+  
+ IF Total \< 0  
+  
+ THEN Error \= "Fired ErrorTotalRule"; Halt  
+  
+ ルールの評価と実行をトレースと追跡によって確認することもできます。  
+  
+### サンプルをビルドするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、ソリューションをデバッグなしで実行します。  
+  
+### サンプルを実行するには  
+  
+-   \[SDK コマンド プロンプト\] ウィンドウで、AdvancedPolicy\\bin\\debug フォルダー \(Visual Basic バージョンのサンプルの場合は AdvancedPolicy\\bin フォルダー\) にある .exe ファイルを実行します。このフォルダーは、サンプルのメイン フォルダーの下に作成されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Rules\Policy\AdvancedPolicy`  
+  
+## 参照  
+ <xref:System.Workflow.Activities.Rules.RuleSet>   
+ <xref:System.Workflow.Activities.PolicyActivity>   
+ [簡単なポリシー](../../../../docs/framework/windows-workflow-foundation/samples/simple-policy.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/application.md b/docs/framework/windows-workflow-foundation/samples/application.md
new file mode 100644
index 00000000000..96e9a5d9aa2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/application.md
@@ -0,0 +1,34 @@
+---
+title: "アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22d27e12-ab04-432b-9695-9f74e098cff3
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# アプリケーション
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] のワークフロー アプリケーション関連のサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ドキュメント承認プロセス](../../../../docs/framework/windows-workflow-foundation/samples/document-approval-process.md)  
+ 基幹業務アプリケーションでのワークフローの使用方法を示します。  
+  
+ [企業の購買プロセス](../../../../docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md)  
+ ウィンドウ内および Web ホスト アプリケーションでのワークフローの使用方法を示します。  
+  
+ [雇用プロセス](../../../../docs/framework/windows-workflow-foundation/samples/hiring-process.md)  
+ メッセージング アクティビティ、およびワークフロー サービスとしてホストされる 2 つのワークフローを使用して、ビジネス プロセスを実装する方法を示します。  
+  
+ [ビジュアル ワークフロー追跡](../../../../docs/framework/windows-workflow-foundation/samples/visual-workflow-tracking.md)  
+ メッセージング アクティビティ、およびワークフロー サービスとしてホストされる 2 つのワークフローを使用して、ビジネス プロセスを実装する方法を示します。  
+  
+ [中断されたインスタンスの管理](../../../../docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md)  
+ 中断されているワークフロー インスタンスを管理する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/asynchronous-communication.md b/docs/framework/windows-workflow-foundation/samples/asynchronous-communication.md
new file mode 100644
index 00000000000..c8c3ab38269
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/asynchronous-communication.md
@@ -0,0 +1,54 @@
+---
+title: "非同期通信 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 128dc092-9eb2-4e33-9470-9a7f62b60df6
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 非同期通信
+このサンプルでは、2 つの異なる [!INCLUDE[wf](../../../../includes/wf-md.md)] サービス間の非同期通信が既定でどのように行われるのかを示します。  
+  
+## 使用例  
+ [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サービス間の非同期通信  
+  
+## 説明  
+ このサンプルでは、.NET Framework が提供するメッセージング アクティビティを使用して、[!INCLUDE[wf1](../../../../includes/wf1-md.md)] アプリケーション間の非同期通信がどのように行われるのかを示します。  
+  
+ このサンプルは、次の 3 つのプロジェクトで構成されています。  
+  
+ CreditCheckService  
+ このサービスは、特定の個人のクレジット スコアまたは取得する項目の値を受け取り、その個人にクレジットを与えるかどうかを判断します。  
+  
+ RentalApprovalService  
+ このサービスは、特定のクレジットを必要としている個人から申請を受け取ります。このサービスは `CreditCheckService` と非同期で通信して、クレジットの申請が有効かどうかを判断します。  
+  
+ Client  
+ クライアントは `RentalApprovalService` と同期通信を行い、クレジットが承認されているかどうかを調べます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  **AsynchronousCommunication** ソリューションを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[共通プロパティ\]** で、**\[スタートアップ プロジェクト\]** をクリックし、**\[マルチ スタートアップ プロジェクト\]** をクリックします。  
+  
+3.  **RentalApprovalService** を一覧の先頭に移動し、次に **CreditCheckService**、その次に **Client** が続くようにそれぞれ移動します。3 つのプロジェクトすべてに **\[開始\]** アクションを設定します。  
+  
+4.  **\[OK\]** をクリックし、F5 キーを押してサンプルを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\AsynchronousCommunication`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/auto-confirm-pattern.md b/docs/framework/windows-workflow-foundation/samples/auto-confirm-pattern.md
new file mode 100644
index 00000000000..c7ac3457ba2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/auto-confirm-pattern.md
@@ -0,0 +1,47 @@
+---
+title: "自動確認パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 668aec65-78d3-4636-9c7b-deed643a18f9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 自動確認パターン
+このサンプルは、カスタム `AutoConfirmScope` アクティビティを示す 3 つのシナリオで構成されます。1 つ目のサンプルでは、2 番目と 3 番目の補正可能なアクティビティが `AutoConfirmScope` で入れ子になっている 4 つの補正可能なアクティビティのシーケンスが正常に実行された場合を示します。2 つ目のサンプルでは、同じシーケンスを示しますが、4 番目の <xref:System.Activities.Statements.CompensableActivity> の実行後に例外が発生します。3 つ目のシナリオでは、同じシーケンスを示しますが、2 番目の <xref:System.Activities.Statements.CompensableActivity> の完了後に `AutoConfirmScope` で例外が発生します。  
+  
+ このサンプルでは、スコープが正常に完了したときにすべての補正可能な子アクティビティが確認される自動確認パターンを示します。このパターンでは、すべての補正可能な子アクティビティの有効期間が定義され、この期間を過ぎるとこれらのアクティビティは補正または確認できなくなります。  
+  
+ スコープは、<xref:System.Activities.Statements.TryCatch.Try%2A> が内部 <xref:System.Activities.Statements.CompensableActivity> である <xref:System.Activities.Statements.TryCatch> で構成されます。`AutoConfirmScope` のユーザー指定の本文は、内部 <xref:System.Activities.Statements.CompensableActivity> の本文です。この内部 <xref:System.Activities.Statements.CompensableActivity> が完了すると、<xref:System.Activities.Statements.CompensationToken> が out 引数として生成されます。`AutoConfirmScope` は、<xref:System.Activities.Statements.TryCatch.Finally%2A> を使用してトークンが生成されているかどうかをチェックし、生成されている場合は内部 <xref:System.Activities.Statements.CompensableActivity> を確認します。内部 <xref:System.Activities.Statements.CompensableActivity> は、本文に存在する補正可能なアクティビティの既定の補正を呼び出します。  
+  
+ 1 つ目のシナリオでは、ワークフローが正常に実行された場合を示します。ワークフローが完了して 1 番目と 4 番目の補正可能なアクティビティが確認されるときには、2 番目と 3 番目の補正可能なアクティビティは既に確認されています。ここでは、確認順序は 3、2、4、1 となります。  
+  
+ 2 つ目のシナリオでは、4 つの補正可能なアクティビティの完了後に例外が発生した場合を示します。補正可能なアクティビティ 2 および 3 は既に確認されているので影響を受けませんが、1 および 4 は補正されます。ここでは、3 が確認され、2 が確認され、4 が補正されて 1 が補正されます。  
+  
+ 最後のシナリオでは、`AutoConfirmScope` が正常に実行されなかった場合を示します。このシナリオでは、2 番目の <xref:System.Activities.Statements.CompensableActivity> の完了後に例外が発生します。3 番目と 4 番目の補正可能なアクティビティは実行されていないので影響を受けません。スコープが正常に完了しなかったので、2 番目の <xref:System.Activities.Statements.CompensableActivity> は確認されません。ここでは、補正順序は 2、1 となります。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、AutoConfirmSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Compensation\AutoConfirm`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-activity-composition.md b/docs/framework/windows-workflow-foundation/samples/basic-activity-composition.md
new file mode 100644
index 00000000000..acae12c75ce
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-activity-composition.md
@@ -0,0 +1,40 @@
+---
+title: "基本的なアクティビティの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c283a1a7-1245-4ecd-8072-206c1b4ca379
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 基本的なアクティビティの構成
+このサンプルでは、カスタム アクティビティとシステム標準アクティビティを作成して、追加のカスタム アクティビティを構築する方法を示します。  
+  
+ Survey アクティビティを使用するこのワークフローでは、質問のリストと共に Survey をスケジュールし、受け取った回答を出力します。  
+  
+## サンプルの詳細  
+ このサンプルでは、次の 3 つのカスタム アクティビティを使用します。`ReadLine` は、スケジュールされたときに <xref:System.Activities.Bookmark> を作成し、`Return`<xref:System.Activities.OutArgument%601> を <xref:System.Activities.Bookmark> を再開する値に設定する単純な <xref:System.Activities.NativeActivity>\<string\> です。`Prompt` は、`Text` という名前の <xref:System.Activities.InArgument%601>\<string\> を使用し、ユーザーの応答を `Result`<xref:System.Activities.OutArgument%601>\<string\> で返す <xref:System.Activities.Activity%601>\<string\> です。`Prompt` アクティビティは、.NET Framework に付属する <xref:System.Activities.Statements.Sequence> アクティビティと <xref:System.Activities.Statements.WriteLine> アクティビティを使用します。また、ユーザー入力を取得するためにカスタムの `ReadLine` アクティビティも組み込まれています。最後のカスタム アクティビティは `Survey` アクティビティです。これは <xref:System.Activities.Activity>\<ICollection\<string\>\> になります。このアクティビティは、`Questions` という名前の <xref:System.Activities.InArgument%601>\<IEnumerable\<string\>\> を受け取り、`Result` out 引数に回答を設定します。`Survey` アクティビティは、.NET Framework の <xref:System.Activities.Statements.ForEach>、<xref:System.Activities.Statements.Sequence>、および <xref:System.Activities.Statements.AddToCollection%601> を使用し、調査の質問をして回答を得るために `Prompt` アクティビティも使用します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で **BasicActivityComposition.sln** サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Composite\ActivityComposition`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-transactions.md b/docs/framework/windows-workflow-foundation/samples/basic-transactions.md
new file mode 100644
index 00000000000..6ebfd831004
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-transactions.md
@@ -0,0 +1,27 @@
+---
+title: "トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "02/09/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51212219-a39e-448e-bff3-10064ff5de64
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+---
+# トランザクション
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] のワークフロー トランザクションを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [基本 TransactionScope](../../../../docs/framework/windows-workflow-foundation/samples/basic-transactionscope.md)  
+ <xref:System.Activities.Statements.TransactionScope> インスタンスを入れ子にする方法を示す 4 つのシナリオで構成されます。  
+  
+ [TransactedReceiveScope の使用](../../../../docs/framework/windows-workflow-foundation/samples/use-of-transactedreceivescope.md)  
+ クライアントからサーバーにトランザクションをフローする方法を示します。このために、<xref:System.Activities.Statements.TransactionScope> を使用してクライアント上に新しいトランザクションを作成し、<xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用してフローされたトランザクションを含むメッセージを受信し、サーバー上でトランザクションの有効期間のスコープを設定します。  
+  
+ [サービス内での TransactionScope の入れ子化](../../../../docs/framework/windows-workflow-foundation/samples/nesting-of-transactionscope-within-a-service.md)  
+ サービス内で <xref:System.Activities.Statements.TransactionScope> アクティビティ インスタンスを処理する方法を示す 2 つのシナリオで構成されます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-transactionscope.md b/docs/framework/windows-workflow-foundation/samples/basic-transactionscope.md
new file mode 100644
index 00000000000..82e917d5bd8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-transactionscope.md
@@ -0,0 +1,48 @@
+---
+title: "基本 TransactionScope | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1e22b76a-76de-43b4-9be7-7a86ed3d5a44
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 基本 TransactionScope
+このサンプルは、<xref:System.Activities.Statements.TransactionScope> インスタンスを入れ子にする方法を示す 4 つのシナリオで構成されています。1 つ目のシナリオは、作成者には構造がわからないサードパーティのアクティビティを入れ子にする方法を示しています。2 つ目と 3 つ目のシナリオは、タイムアウトがどのように機能するかを示しています。4 つ目のシナリオは、<xref:System.Activities.Statements.TransactionScope.AbortInstanceOnTransactionFailure%2A> の設定を示しています。  
+  
+## TransactionScopeActivity の入れ子  
+ 1 つ目のシナリオのワークフローは、2 つの <xref:System.Activities.Statements.WriteLine> アクティビティと 1 つの <xref:System.Activities.Statements.TransactionScope> のシーケンスで構成されています。<xref:System.Activities.Statements.TransactionScope> の本体は、2 つの <xref:System.Activities.Statements.WriteLine> アクティビティ、トランザクションのローカル識別子を出力するカスタム アクティビティ、およびサードパーティのアクティビティのシーケンスです。サードパーティのアクティビティである `TransactionScopeTest` には <xref:System.Activities.Statements.TransactionScope> が含まれていますが、ワークフローの作成者にはわかりません。このシナリオは、<xref:System.Activities.Statements.TransactionScope> アクティビティを入れ子にできることを示しています。  
+  
+## タイムアウト  
+ 2 つ目のシナリオのワークフローは 1 つ目のシナリオとほとんど同じですが、`TransactionScopeTest` が <xref:System.Activities.Statements.TransactionScope> に置き換えられています。この <xref:System.Activities.Statements.TransactionScope> の本体は 5 秒の遅延で、トランザクションのタイムアウトは 2 秒に設定されています。外側の <xref:System.Activities.Statements.TransactionScope> のタイムアウトは 10 秒に設定されています。スコープで最も小さいタイムアウト値が適用されるため、トランザクションがタイムアウトします。  
+  
+ 3 つ目のシナリオのワークフローは 2 つ目のシナリオとほとんど同じですが、遅延アクティビティが内側の <xref:System.Activities.Statements.TransactionScope> の本体からその直後 \(外側の <xref:System.Activities.Statements.TransactionScope> の本体\) に移動されています。この場合もトランザクションがタイムアウトしますが、内側の <xref:System.Activities.Statements.TransactionScope> の 2 秒のタイムアウトはもう適用されないため、トランザクションは 10 秒後 \(外側の <xref:System.Activities.Statements.TransactionScope> のタイムアウト期間が経過したとき\) にタイムアウトします。  
+  
+## トランザクション エラーによる中止  
+ このワークフローは 3 つ目のシナリオに似ていますが、タイムアウトが <xref:System.Activities.Statements.TransactionScope.AbortInstanceOnTransactionFailure%2A> プロパティに置き換えられています。内側にあるすべての子は、フラグが設定されている場合、フラグが外側の <xref:System.Activities.Statements.TransactionScope> と一致している必要がありますが、このシナリオでは一致していないため、ワークフローを開くと例外がスローされます。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で BasicTransactionScopeSample.sln ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+3.  ビルドが完了したら、F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Transactions\BasicTransactionScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-usage-of-sendparameters-and-receiveparameters-activities.md b/docs/framework/windows-workflow-foundation/samples/basic-usage-of-sendparameters-and-receiveparameters-activities.md
new file mode 100644
index 00000000000..65fcd3f66b0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-usage-of-sendparameters-and-receiveparameters-activities.md
@@ -0,0 +1,39 @@
+---
+title: "SendParameters および ReceiveParameters アクティビティの基本的な使用方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1b6b1681-3d41-403f-bfe2-3f600f24aa8c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# SendParameters および ReceiveParameters アクティビティの基本的な使用方法
+このサンプルでは、<xref:System.ServiceModel.Activities.SendParametersContent> アクティビティと <xref:System.ServiceModel.Activities.ReceiveParametersContent> アクティビティの使用方法を示します。このサービスは、文字列引数を取得して、クライアントに入力を再度エコーするという 1 つの操作を公開します。このサンプルで示すのは、これらのメッセージング アクティビティのパラメーターを設定する方法です。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\SendReceiveParameters`  
+  
+#### このサンプルの使用  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  最初に、\[ソリューションの基本ディレクトリ\]\\EchoWorkflowService\\bin\\debug に生成された EchoWorkflowService アプリケーションを実行します。  
+  
+3.  2 番目に、\[ソリューションの基本ディレクトリ\]\\EchoWorkflowClient\\bin\\debug に生成された EchoWorkflowClient アプリケーションを実行します。  
+  
+4.  クライアントは、サービスで Echo 操作を呼び出し、結果を出力します。完了したら、Enter キーを押してクライアントを終了し、サービスを終了します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-validation.md b/docs/framework/windows-workflow-foundation/samples/basic-validation.md
new file mode 100644
index 00000000000..a5e168eac9d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-validation.md
@@ -0,0 +1,52 @@
+---
+title: "基本検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ba1343cc-aaab-4ade-b0c0-1dd5063bf4ad
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 基本検証
+このサンプルは、`CreateProduct` アクティビティで構成されています。このアクティビティでは、その `Cost` 引数が `Price` 引数以下であることを検証します。  
+  
+## サンプルの詳細  
+ 検証を使用する 2 人の作成者が存在します。1 人はアクティビティの検証ロジックを作成するアクティビティ作成者で、もう 1 人は、特定のワークフローで検証サービスを呼び出すワークフロー作成者です。このシナリオでは、アクティビティ作成者はアクティビティのすべてのインスタンスで、コストが必ず価格以下になるように強制します。  
+  
+ アクティビティ作成者 \(アクティビティ内\) は、次を行う必要があります。  
+  
+-   制約 \(`PriceGreaterThanCost`\) を作成します。ここには、すべての検証ロジックが存在します。  
+  
+-   <xref:System.Activities.CodeActivity%601.OnGetConstraints%2A> をオーバーライドし、制約 \(`PriceGreaterThanCost`\) を制約 <xref:System.Collections.IList> に追加します。  
+  
+ ワークフロー作成者 \(メイン プログラム\) は次を実行する必要があります。  
+  
+-   検証するアクティビティのインスタンスを含むワークフローを作成します \(`CreateProduct`\)。  
+  
+-   <xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> を呼び出すと、<xref:System.Activities.Validation.ConstraintViolation> の <xref:System.Activities.Validation.ValidationResults> コレクションが返されます。  
+  
+-   \(省略可能\) <xref:System.Activities.Validation.ConstraintViolation> オブジェクトを出力します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で BasicValidation.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Validation\BasicValidation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic-xaml-only-service.md b/docs/framework/windows-workflow-foundation/samples/basic-xaml-only-service.md
new file mode 100644
index 00000000000..629668eeecf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic-xaml-only-service.md
@@ -0,0 +1,39 @@
+---
+title: "基本的な XAML 専用サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c106feb0-0245-43b5-aefe-93ce0e4d38eb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 基本的な XAML 専用サービス
+このサンプルでは、XAML 専用サービスを作成する方法を示します。このシナリオは自動車関連の問題に対する診断サービスです。このサービスは、顧客に一連の質問をして問題を診断するワークフローとして実装されます。このサービスで診断できる問題は 2 種類です \(車のエンジンがかからない、または空調装置が動作しない\)。ワークフローでは、デザイナーの要求\/応答テンプレートを使用して、3 つの簡単なサービス操作を公開します。サービスは、 IIS に仮想ディレクトリを作成し、service1.xamlx ファイルおよび Web.config ファイルをその仮想ディレクトリにコピーすることによって IIS でホストされます。コンパイルされたコードは必要ありません。既定では、このサンプルでは、Visual Studi 2010 でのビルト時に、WCF および WF のサンプルのセットアップ手順 \([Windows Communication Foundation サンプルの 1 回限りのセットアップの手順](../../../../docs/framework/wcf/samples/one-time-setup-procedure-for-the-wcf-samples.md)\) に従って作成する仮想ディレクトリに、必要なファイルが自動的にコピーされます:。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  \[ソリューションの基本ディレクトリ\]\\Client\\bin\\debug に生成されたクライアント アプリケーションを実行します。  
+  
+3.  オプションが出力されるので、オプションを選択します。質問が表示されたら、はいかいいえで \(Y キーまたは N キーを使用して\) 回答します。サービスによる問題の診断が完了すると、診断結果が出力されます。  
+  
+4.  オプションが再度表示されます。もう一度問題を診断することも、アプリケーションを終了することもできます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\XAMLService`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/basic.md b/docs/framework/windows-workflow-foundation/samples/basic.md
new file mode 100644
index 00000000000..7e8a5391e77
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/basic.md
@@ -0,0 +1,63 @@
+---
+title: "Basic | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 84a315b6-3f96-4959-8306-49be37936a23
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# Basic
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] の基本的な機能を示すサンプルが用意されています。  
+  
+## このセクションの内容  
+ [ビルトイン アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/built-in-activities.md)  
+ ビルトイン アクティビティ ライブラリを使用するサンプルが含まれます。  
+  
+ [補正](../../../../docs/framework/windows-workflow-foundation/samples/compensation-samples.md)  
+ 補正を示すサンプルが示まれます。  
+  
+ [カスタム アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/custom-activities.md)  
+ カスタム アクティビティの作成を示すサンプルが含まれます。  
+  
+ [デザイナー](../../../../docs/framework/windows-workflow-foundation/samples/designer.md)  
+ [!INCLUDE[wfd1](../../../../includes/wfd1-md.md)]の使用方法を示すサンプルが含まれます。  
+  
+ [デザイナーのホスト変更](../../../../docs/framework/windows-workflow-foundation/samples/designer-rehosting.md)  
+ アクティビティ デザイナーの再ホストを示すサンプルが含まれます。  
+  
+ [実行](../../../../docs/framework/windows-workflow-foundation/samples/execution.md)  
+ ワークフローの実行を示すサンプルが含まれます。  
+  
+ [式](../../../../docs/framework/windows-workflow-foundation/samples/expressions.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] 式を示すサンプルが含まれます。  
+  
+ [移行](../../../../docs/framework/windows-workflow-foundation/samples/migration.md)  
+ 前のバージョンの [!INCLUDE[wf](../../../../includes/wf-md.md)] で作成されたワークフローの移行を示すサンプルが含まれます。  
+  
+ [永続性](../../../../docs/framework/windows-workflow-foundation/samples/persistence.md)  
+ 永続メディアへのワークフローの永続化を示すサンプルが含まれます。  
+  
+ [ルールのサンプル](../../../../docs/framework/windows-workflow-foundation/samples/rules-samples.md)  
+ [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] のワークフロー ルール エンジンを使用する方法を示すサンプルが含まれます。  
+  
+ [サービス](../../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+ ワークフロー サービスを示すサンプルが含まれます。  
+  
+ [追跡](../../../../docs/framework/windows-workflow-foundation/samples/tracking.md)  
+ ワークフロー追跡を示すサンプルが含まれます。  
+  
+ [トランザクション](../../../../docs/framework/windows-workflow-foundation/samples/basic-transactions.md)  
+ ワークフロー トランザクションを示すサンプルが含まれます。  
+  
+ [検証](../../../../docs/framework/windows-workflow-foundation/samples/validation.md)  
+ [!INCLUDE[wf2](../../../../includes/wf2-md.md)] での検証を示すサンプルが含まれます。  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/bookmark-resolver-for-workflowhostingendpoint.md b/docs/framework/windows-workflow-foundation/samples/bookmark-resolver-for-workflowhostingendpoint.md
new file mode 100644
index 00000000000..bfcae7de3cf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/bookmark-resolver-for-workflowhostingendpoint.md
@@ -0,0 +1,45 @@
+---
+title: "WorkflowHostingEndpoint のブックマーク リゾルバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97fd5816-935e-4625-ad04-e6f6befa07de
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WorkflowHostingEndpoint のブックマーク リゾルバー
+このサンプルでは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を <xref:System.ServiceModel.Activities.WorkflowServiceHost> と共に使用して、ワークフロー インスタンスを作成する方法を示します。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint>,<xref:System.ServiceModel.Activities.WorkflowServiceHost>  
+  
+## 説明  
+ このサンプルでは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を使用して、 <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされるワークフロー インスタンスを作成します。<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> は、次のシナリオで使用できる <xref:System.ServiceModel.Activities.WorkflowServiceHost> の機能拡張ポイントです。  
+  
+-   新しいワークフロー インスタンスの作成  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされているワークフロー インスタンスでのブックマークの再開  
+  
+ 含まれているサンプルのエンドポイントでは、ワークフローを作成してインスタンス ID を返したり、特定の ID を持つインスタンスを作成したりするための操作を提供するコントラクトを公開します。サンプルのコンソール アプリケーションでは、ワークフロー定義を含む <xref:System.ServiceModel.Activities.WorkflowServiceHost> インスタンスが作成されて、`CreationEndpoint` がホストに追加されます。その後、エンドポイントで `Create` 操作が呼び出され、新しいワークフロー インスタンスが作成されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドします。  
+  
+2.  アプリケーションを実行します。`CreationEndpoint` コンソールには、ワークフロー インスタンスの作成時にインスタンス ID を含むメッセージが表示されます。ワークフロー インスタンスからメッセージ "Hello World\!" が出力されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\CreationEndpoint`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/bookmarks.md b/docs/framework/windows-workflow-foundation/samples/bookmarks.md
new file mode 100644
index 00000000000..33ad561913e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/bookmarks.md
@@ -0,0 +1,37 @@
+---
+title: "ブックマーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 035fadb2-49fa-4ac7-b398-daf138f66e87
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ブックマーク
+このサンプルでは、外部入力を受信するためのブックマークを作成するカスタム アクティビティを記述する方法を示します。また、このサンプルでは、基本的なコンソール アプリケーションによってワークフローでカスタム アクティビティを使用し、実行中のワークフロー インスタンスに関連付けられたブックマークを探索および再開する方法を示します。ブックマーク [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ブックマーク](../../../../docs/framework/windows-workflow-foundation//bookmarks.md)」を参照してください。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で Bookmarks.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  サンプルを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CodeBodied\Bookmarks`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/buffered-receive.md b/docs/framework/windows-workflow-foundation/samples/buffered-receive.md
new file mode 100644
index 00000000000..b30b5a133fd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/buffered-receive.md
@@ -0,0 +1,116 @@
+---
+title: "バッファーされた受信機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9d46d9b9-96c9-4531-9695-ab526b4d704a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# バッファーされた受信機能
+このサンプルでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] のバッファーされた受信機能を設定および構成する方法を示します。バッファーされた受信機能を使用すると、ワークフロー作成者は、メッセージが受信される順序を考慮することなくワークフローを作成できます。バッファーされた受信機能では、メッセージがローカルにバッファーされ、ワークフローで受信準備が整ったときにメッセージが配信されます。  
+  
+## 使用例  
+ メッセージング アクティビティと共にバッファーされた受信機能を使用した、順番を無視したメッセージ処理。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\BufferedReceive`  
+  
+## 説明  
+ このサンプルでは、[!INCLUDE[wf1](../../../../includes/wf1-md.md)] を使用して [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスが実装されます。このサービスには <xref:System.ServiceModel.Activities.Receive> アクティビティのシーケンスがあります。このワークフローは、ローン承認のための 3 つの通知を受け取る単純なローン承認プロセスをモデル化しています。[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] クライアント アプリケーションは、サービスで想定される順序とは逆の順序で 3 つの関連付けられた通知を送信します。サービスでバッファーされた受信機能が有効になっているので、順番を無視した各メッセージがサービスにバッファーされ、ワークフローで受信準備が整ったときに処理されます。  
+  
+ バッファーされた受信機能では、バインディングによる <xref:System.ServiceModel.Activities.ReceiveContent> のサポートが必要なので、サービスで <xref:System.ServiceModel.NetMsmqBinding> が使用されます。バインディングのための特別な構成は不要なので、既定の設定が使用されます。  
+  
+```  
+<endpoint address ="net.msmq://localhost/private/LoanService/Service1.xamlx"  
+                  binding="netMsmqBinding"  
+                  contract="ILoanService"/>  
+  
+```  
+  
+ また、サービスでは、<xref:System.ServiceModel.Description.ServiceMetadataBehavior> を使用してサービスのメタデータが公開されます。  
+  
+ 同様に、<xref:System.ServiceModel.NetMsmqBinding> を使用してクライアント エンドポイントが構成されます。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] の **\[サービス参照の追加\]** 機能を使用して、クライアント コードと構成が生成されます。App.config ファイルで生成されたクライアント エンドポイントを次の例に示します。  
+  
+```  
+<endpoint address="net.msmq://localhost/private/LoanService/Service1.xamlx"  
+                binding="netMsmqBinding" bindingConfiguration="NetMsmqBinding_ILoanService"  
+                contract="ServiceReference1.ILoanService" name="NetMsmqBinding_ILoanService" />  
+  
+```  
+  
+ このサンプルでは、次の Windows コンポーネントが有効になっている必要があります。  
+  
+1.  [!INCLUDE[iis60](../../../../includes/iis60-md.md)]  
+  
+2.  [!INCLUDE[iis60](../../../../includes/iis60-md.md)] と互換性のある管理、IIS メタベースおよび IIS 6 構成との互換性  
+  
+3.  World Wide Web サービス、アプリケーション開発機能、および ASP.NET  
+  
+4.  Microsoft メッセージ キュー \(MSMQ\) サーバー  
+  
+#### サンプルをセットアップしてビルドするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトで、「`aspnet_regiis –I`」と入力して ASP.NET を登録し、Enter キーを押します。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を管理者として実行します。  
+  
+3.  LoanService.sln を開きます。  
+  
+4.  LoanService プロジェクトの仮想ディレクトリを作成するかどうかを確認するメッセージが表示されたら、**\[はい\]** をクリックします。  
+  
+#### サービス キューを設定するには  
+  
+1.  F5 キーを押して LoanClient アプリケーションを実行し、キューを作成して Service1.xamlx で定義されたサービスをアクティブ化します。  
+  
+2.  コマンド プロンプトから Compmgmt.msc を実行して、**\[コンピューターの管理\]** コンソールを開きます。  
+  
+3.  **\[コンピューターの管理\]** コンソールで、**\[サービスとアプリケーション\]**、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+4.  loanservice\/service1.xamlx キューを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+5.  **\[セキュリティ\]** タブをクリックし、Everyone グループに **\[メッセージの受信\]**、**\[メッセージのピーク\]**、および **\[メッセージの送信\]** アクセス許可を追加します。  
+  
+6.  [!INCLUDE[iis60](../../../../includes/iis60-md.md)] マネージャーを開きます。  
+  
+7.  **\[サーバー\]**、**\[サイト\]**、**\[既定の Web サイト\]**、**\[private\]**、**\[LoanService\]** の順に参照し、**\[詳細オプション\]** をクリックします。  
+  
+8.  **\[有効なプロトコル\]** を **http**,**net.msmq** に変更します。  
+  
+#### サンプルを実行するには  
+  
+1.  http:\/\/localhost\/private\/loanservice\/service1.xamlx を参照し、サービスが実行されていることを確認します。  
+  
+2.  F5 キーを押して LoanClient アプリケーションを実行します。ワークフローが完了したら、メッセージ交換の結果を示す out.txt ファイルが C:\\Inbox に保存されます。  
+  
+#### クリーンアップするには  
+  
+1.  コマンド プロンプトから Compmgmt.msc を実行して、**\[コンピューターの管理\]** コンソールを開きます。  
+  
+2.  **\[サービスとアプリケーション\]** 、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+3.  loanservice\/service1.xamlx キューを削除します。  
+  
+4.  C:\\Inbox ディレクトリを削除します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\BufferedReceive`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/built-in-activities.md b/docs/framework/windows-workflow-foundation/samples/built-in-activities.md
new file mode 100644
index 00000000000..4c1e8550461
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/built-in-activities.md
@@ -0,0 +1,58 @@
+---
+title: "ビルトイン アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31e1b8c2-7f74-458a-b2e2-fddc5b10eac1
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ビルトイン アクティビティ
+このセクションには、ビルトイン [!INCLUDE[wf](../../../../includes/wf-md.md)] アクティビティを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [TryCatch を使用した Flowchart アクティビティでのエラー処理](../../../../docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md)  
+ 複雑な制御フロー アクティビティ内で <xref:System.Activities.Statements.TryCatch> アクティビティを使用する方法を示します。  
+  
+ [While アクティビティでの中断のエミュレート](../../../../docs/framework/windows-workflow-foundation/samples/emulating-breaking-in-a-while-activity.md)  
+ <xref:System.Activities.Statements.DoWhile>、<xref:System.Activities.Statements.ForEach%601>、<xref:System.Activities.Statements.While>、および <xref:System.Activities.Statements.ParallelForEach%601> の各アクティビティのループ機構を中断する方法を示します。  
+  
+ [DynamicActivity の作成](../../../../docs/framework/windows-workflow-foundation/samples/dynamicactivity-creation.md)  
+ <xref:System.Activities.DynamicActivity> アクティビティを使用して実行時にアクティビティを作成する 2 つの異なる方法を示します。  
+  
+ [.NET Framework 3.5 ルールセットでの変数の使用](../../../../docs/framework/windows-workflow-foundation/samples/using-variables-with-dotnet-ruleset.md)  
+ <xref:System.Activities.Statements.Interop> アクティビティを使用するワークフローを作成し、ポリシーとルールを使用する、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] で記述されたカスタム アクティビティを統合する方法を示します。  
+  
+ [XAML からの読み込み](../../../../docs/framework/windows-workflow-foundation/samples/load-from-xaml.md)  
+ XamlBuildTask ツールを実行することなく、XAML ワークフローを動的に読み込む方法を示します。  
+  
+ [コレクション アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-collection-activities.md)  
+ <xref:System.Collections.ICollection> インターフェイスを実装するクラスでコレクション アクティビティ \(<xref:System.Activities.Statements.AddToCollection%601>、<xref:System.Activities.Statements.ClearCollection%601>、<xref:System.Activities.Statements.ExistsInCollection%601>、および <xref:System.Activities.Statements.RemoveFromCollection%601>\) を使用する方法と、コレクションを反復処理してコレクション内の各要素の内容を出力するカスタム アクティビティを作成する方法を示します。  
+  
+ [InvokeMethod アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-the-invokemethod-activity.md)  
+ <xref:System.Activities.Statements.InvokeMethod> アクティビティを使用してパブリック クラス内のパブリック メソッドを呼び出す方法を示します。  
+  
+ [Pick アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md)  
+ <xref:System.Activities.Statements.Pick> アクティビティを使用する方法を示します。  
+  
+ [手続き型アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-procedural-activities.md)  
+ <xref:System.Activities.Statements.Sequence>、<xref:System.Activities.Statements.Assign>、<xref:System.Activities.Statements.If>、<xref:System.Activities.Statements.While>、<xref:System.Activities.Statements.Switch%601>、<xref:System.Activities.Statements.TryCatch>、および <xref:System.Activities.Statements.WriteLine> の各アクティビティを使用して推測ゲームを実装する方法を示します。  
+  
+ [CancellationScope の使用](../../../../docs/framework/windows-workflow-foundation/samples/using-cancellationscope.md)  
+ <xref:System.Activities.Statements.CancellationScope> アクティビティを使用してアプリケーション内の処理を取り消す方法を示します。  
+  
+ [InvokeMethod](../../../../docs/framework/windows-workflow-foundation/samples/invokemethod.md)  
+ <xref:System.Activities.Statements.InvokeMethod> アクティビティを使用してクラスのメソッドを呼び出すさまざまな方法を示します。  
+  
+ [カスタム型を使用した Switch アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/usage-of-the-switch-activity-with-custom-types.md)  
+ <xref:System.Activities.Statements.Switch%601> アクティビティを有効にしてユーザー定義の複合型を実行時に評価する方法について説明します。  
+  
+ [3.5 ルール セットとの相互運用](../../../../docs/framework/windows-workflow-foundation/samples/interop-with-3-5-rule-set.md)  
+ <xref:System.Activities.Statements.Interop> アクティビティを使用して、<xref:System.Workflow.Activities.PolicyActivity> とルールを使用する [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] のカスタム アクティビティと統合する例を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/built-in-configuration.md b/docs/framework/windows-workflow-foundation/samples/built-in-configuration.md
new file mode 100644
index 00000000000..8760fef62c8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/built-in-configuration.md
@@ -0,0 +1,115 @@
+---
+title: "組み込みの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 34e85c9b-088d-4347-816c-0f77cb73ef2f
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 組み込みの構成
+このサンプルでは、SQL Workflow Instance Store の使用法と構成を示します。SQL Workflow Instance Store は、SQL ベースのインスタンス ストアの実装です。SQL Workflow Instance Store を使用すると、インスタンスの状態を SQL Server データベースや SQL Server Express データベースに保存したり読み込んだりすることができます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、ダウンロード ページに移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration`  
+  
+## サンプルの詳細  
+ このサンプルは、カウント サービスを実装するワークフローで構成されています。サービスの start メソッドが呼び出されると、0 から 59 までのカウントが行われます。カウンターは 2 秒ごとにインクリメントされ、カウントのたびにワークフローが永続化されます。  
+  
+ このカウント ワークフローは、ワークフロー サービス ホストによってホストされる自己ホスト型サービスです。プログラムの `Main` メソッドは、カウント ワークフローをホストするワークフロー サービス ホストのインスタンスを作成し、カウント ワークフローにアクセスできるエンドポイントを定義します。その後、SQL Workflow Instance Store を構成するために使用される SQL Workflow Instance Store の動作を定義します。続いて、カウント ワークフローの start メソッドを呼び出すクライアントがプログラムで作成されます。  
+  
+ プログラムを開始すると、カウンターが自動的にカウントを開始します。インスタンスを読み込んで SQL Workflow Instance Store を構成するのに数秒かかる場合もあります。Workflow Instance Store [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SQL Workflow Instance Store](../../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)」を参照してください。  
+  
+ このサンプルは、2 つの部分で構成されています。  
+  
+1.  InstanceStore1 は、C\# コードを使用して <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を構成する方法を示しています \(Program.cs を参照\)。  
+  
+2.  InstanceStore2 は、XML を使用して <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を構成する方法を示しています \(App.config を参照\)。  
+  
+ SQL Workflow Instance Store の動作を構成するには次の設定を使用できます。  
+  
+-   `HostLockRenewalPeriod` を設定します。この時間は、ホストで実行されているインスタンスの所有権ロックをホストが更新する間隔を定義します。ロックの情報はインスタンス ストアに格納されます。`HostLockRenewalPeriod` で定義されている間隔が 2 回経過しても所有権が更新されないと、インスタンスが破棄されたと見なされます。同じワークフローを実行し、同じインスタンス ストア \(同じコンピューターにあっても別のコンピューターにあってもかまいません\) に接続している別の <xref:System.ServiceModel.Activities.WorkflowServiceHost> がある場合は、その WorkflowServiceHost によってインスタンスが回復されます。\(インスタンスの回復はこのサンプルの範囲外です\)。  
+  
+-   `RunnableInstancesDetectionPeriod` を設定します。この期間は、実行可能になったインスタンスをホストがポーリングする間隔を定義します。インスタンスが実行可能になるのは次の場合です。  
+  
+    -   永続的なタイマー \(<xref:System.Activities.Statements.Delay>\) が切れた場合。  
+  
+    -   別のホストで `HostLockRenewal` のハートビートが \(コンピューターがクラッシュしたなどの理由で\) 失敗してインスタンスが回復された場合。  
+  
+-   `InstanceCompletionAction` を設定します。このプロパティを `DeleteNothing` に設定すると、完了したインスタンスがインスタンス ストアに保持されます。`DeleteAll` に設定すると、インスタンスが完了時にストアから削除されます。次の点に注意してください。  
+  
+    > [!NOTE]
+    >  カウントが完了する前に Enter キーを押してホストを終了すると、ワークフロー インスタンスが完了しません。  
+  
+-   `InstanceLockedExceptionAction` を設定します。この設定は、別のホストによってロックされているインスタンスを読み込もうとした場合の動作を定義します。次の選択肢があります。  
+  
+    -   `NoRetry`: 読み込みを再試行せずにホストに `InstanceLockedException` を返します。  
+  
+    -   `BasicRetry`: インスタンスの読み込みを再試行し続けます。再試行のスケジュールは、単純な線形アルゴリズムに従って設定されます \(5 秒ごとに再試行するなど\)。  
+  
+    -   `AggressiveRetry`: インスタンスの読み込みを再試行し続けます。再試行のスケジュールは、積極的な指数バックオフ アルゴリズムに従って設定されます。  
+  
+-   Encoding オプションを設定します。この設定は、SQL Workflow Instance Store にインスタンスの状態を格納する方法を定義します。次の選択肢があります。  
+  
+    -   GZip 圧縮アルゴリズムを使用してインスタンスの状態を圧縮します。  
+  
+    -   インスタンスの状態を圧縮しません。  
+  
+#### このサンプルを使用するには  
+  
+1.  アクセス許可がある場合は、管理者として [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+2.  サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\BuiltInConfiguration\\CS\) に移動して、CreateInstanceStore.cmd を実行します。  
+  
+3.  管理特権がない場合は、SQL Server ログインを作成します。`[セキュリティ]` の **\[ログイン\]** に移動し、**\[ログイン\]** を右クリックして新しいログインを作成します。  
+  
+4.  自分の ACL ユーザーを SQL ロールに追加します。**\[データベース\]**、**\[InstanceStore\]**、**\[セキュリティ\]** の順に開き、**\[ユーザー\]** を右クリックして **\[新しいユーザー\]** をクリックします。**\[ログイン名\]** を、前の手順で作成したユーザーに設定します。そのユーザーを、**System.Activities.DurableInstancing.InstanceStoreUsers** \(およびその他\) のデータベース ロールのメンバーシップに追加します。ユーザーが既に存在している場合もあります \(ユーザー dbo など\)。  
+  
+5.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で InstanceStore.sln ファイルを開き、CTRL キー、SHIFT キーを押しながら B キーを押してソリューションをビルドします。  
+  
+6.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] で、サンプルの該当する bin\\debug ディレクトリ \(\\WF\\Basic\\Persistence\\BuiltInConfiguration\\cs\\InstanceStore\(1 または 2\)\\bin\\debug\) に移動し、InstanceStore.exe を右クリックして **\[管理者として実行\]** をクリックします。このサンプルはチャネル リスナーを開くため、管理特権で実行する必要があります。  
+  
+7.  ローカルの SQL Server Express 以外のデータベースにインスタンス ストアを作成した場合は、サンプルのデータベース接続文字列 \(InstanceStore1 プロジェクトの Program.cs にある `const string ConnectionString` と、InstanceStore2 プロジェクトの App.config にある `connectionString` 属性\) を更新してサンプルを再コンパイルする必要があります。  
+  
+#### サンプルが正常に実行されていることを確認するには  
+  
+1.  サンプルの実行中に、SQL Server Management Studio を起動します。  
+  
+2.  **\[オブジェクト エクスプローラー\]** で、**\[データベース\]**、**\[InstanceStore\]**、**\[テーブル\]** の順に選択し、**\[System.Activities.DurableInstancing.InstanceTable\]** を選択します。  
+  
+3.  **\[InstanceTable\]** を右クリックし、**\[上位 1000 行を選択\]** をクリックします。  
+  
+4.  新しいエントリがあり、**\[ロックの期限\]** が 5 秒ごとに変化していることを確認します \(クエリを更新するには、タスク バーの **\[実行\]** ボタンをクリックします\)。これは、**\[ホストのロック更新時間\]** が 5 に設定されているためです。  
+  
+5.  カウントの完了後にインスタンス テーブルのエントリが削除されることを確認します。これは、**\[インスタンス完了アクション\]** が **\[DeleteAll\]** に設定されているためです。  
+  
+6.  Enter キーを押してワークフロー ホスト アプリケーションを終了し、**LockOwnersTable** が削除されることを確認します。  
+  
+#### サンプルをアンインストールするには  
+  
+1.  サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\BuiltInConfiguration\) で RemoveInstanceStore.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration`  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/cancellation-handler-on-compensable-activity.md b/docs/framework/windows-workflow-foundation/samples/cancellation-handler-on-compensable-activity.md
new file mode 100644
index 00000000000..bd515d12f8a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/cancellation-handler-on-compensable-activity.md
@@ -0,0 +1,97 @@
+---
+title: "補正可能なアクティビティでのキャンセル ハンドラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: afd98bee-eccf-47e9-99c9-27cea84ce5ce
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 補正可能なアクティビティでのキャンセル ハンドラー
+このサンプルでは、<xref:System.Activities.Statements.CompensableActivity> でキャンセル ハンドラーを使用する例を示します。  
+  
+ このサンプルには、<xref:System.Activities.Statements.CompensableActivity> キャンセルの使用法を示す 2 つのシナリオが含まれています。最初のシナリオには、3 つの補正可能な子アクティビティを含む補正可能なルート アクティビティが含まれます。2 つの子アクティビティは、アクティビティ本体の実行を正常に終了します。3 つ目の子アクティビティ本体が実行されると、3 つ目のアクティビティ処理をキャンセルすることで処理される例外が発生し、その後ルート アクティビティのキャンセルがトリガーされます。この例のルート アクティビティのロジックでは、先に完了している他の 2 つの子アクティビティが補正されます。  
+  
+```  
+Try  
+{  
+    CA   
+    {  
+        CA1   
+        {  
+        }  
+        CA2  
+        {  
+        }  
+        CA3  
+        {  
+            //Exception here  
+            // Then this will get cancelled  
+        }  
+  
+       // Cancellation for the root activity automatically gets called, which, in turn, adds some logic to revert what was done (Or can decide to actually confirm CA1 & CA2 if the user so desires).  
+    }  
+}  
+Catches {  
+// Can do more stuff...  
+}  
+  
+```  
+  
+ 2 つ目のシナリオでは、<xref:System.Activities.Statements.TryCatch> 分岐の前に終了する <xref:System.Activities.Statements.Delay> と平行して、<xref:System.Activities.Statements.TryCatch> を実行する方法を示します。最初の分岐が終了したときに完了条件が `true` に設定されて、他の分岐がキャンセルされます。  
+  
+```  
+Parallel   
+{  
+    Branch1   
+    {  
+        // Small Delay that times out (timeout1) before branch2.  
+    }  
+    Branch2   
+    {  
+        CA   
+        {  
+            CA1   
+            {  
+            }  
+            CA2   
+            {  
+            }  
+            CA3   
+            {  
+            }  
+            If (timeout1)    
+            {  
+                call Cancel CA  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して CompensationCancellation.sln を開きます。  
+  
+2.  CTRL キー、SHIFT キーを押しながら B キーを押すか、\[ビルド\] メニューの \[ソリューションのビルド\] をクリックして、サンプルをビルドします。  
+  
+3.  F5 キーを押すか、\[デバッグ\] メニューの \[デバッグ開始\] をクリックしてサンプルを実行します。または、Ctrl キーを押しながら F5 キーを押すか、\[デバッグ\] メニューの \[デバッグなしで開始\] をクリックすることもできます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Compensation\CompensationCancellation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/channel-caching-with-send.md b/docs/framework/windows-workflow-foundation/samples/channel-caching-with-send.md
new file mode 100644
index 00000000000..32a9905db99
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/channel-caching-with-send.md
@@ -0,0 +1,46 @@
+---
+title: "Send によるチャネル キャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e69a2502-25cb-43bf-b8d2-95fbdecb41cb
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# Send によるチャネル キャッシュ
+<xref:System.ServiceModel.Activities.SendMessageChannelCache> を使用すると、ユーザーは <xref:System.ServiceModel.Activities.Send> および <xref:System.ServiceModel.Activities.SendParametersContent> アクティビティでさまざまなレベルのチャネル キャッシュを利用できます。既定では、インスタンス レベルのキャッシュが有効になっています。このサンプルでは、次の機能を示します。  
+  
+1.  アプリケーション ドメイン間での <xref:System.ServiceModel.Activities.SendMessageChannelCache> の共有。  
+  
+2.  チャネル キャッシュの無効化。  
+  
+3.  <xref:System.ServiceModel.Activities.WorkflowServiceHost> 内のワークフロー インスタンス間での <xref:System.ServiceModel.Activities.SendMessageChannelCache> の共有。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Activities.SendMessageChannelCache> 拡張、<xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.Receive>、<xref:System.ServiceModel.Activities.ReceiveContent>、および <xref:System.ServiceModel.Activities.SendReply> アクティビティ。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  \\EchoWorkflowService\\bin\\debug に生成された EchoWorkflowService アプリケーションを実行します。  
+  
+3.  \\EchoWorkflowClient\\bin\\debug に生成された EchoWorkflowClient アプリケーションを実行します。\\EchoWorkflowClient\\bin\\debug  
+  
+4.  クライアントは、サービスで Echo 操作を呼び出し、結果を出力します。結果が出力されたら、Enter キーを押してクライアントを終了し、サービスを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\ChannelCache`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/code-bodied.md b/docs/framework/windows-workflow-foundation/samples/code-bodied.md
new file mode 100644
index 00000000000..0512e604e4e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/code-bodied.md
@@ -0,0 +1,40 @@
+---
+title: "コード本文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5bfb2d95-9092-4551-9c59-bd8f0a37225e
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# コード本文
+このセクションでは、コードで宣言して作成するカスタム アクティビティのサンプルを示します。  
+  
+## このセクションの内容  
+ [ブックマーク](../../../../docs/framework/windows-workflow-foundation/samples/bookmarks.md)  
+ このサンプルでは、外部入力を受信するためのブックマークを作成するカスタム アクティビティを記述する方法を示します。  
+  
+ [ネイティブ アクティビティを使用したカスタム複合](../../../../docs/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity.md)  
+ このサンプルでは、他の <xref:System.Activities.Activity> オブジェクトをスケジュールしてワークフローの実行のフローを制御する <xref:System.Activities.NativeActivity> を作成する方法を示します。  
+  
+ [実行プロパティ](../../../../docs/framework/windows-workflow-foundation/samples/execution-properties.md)  
+ このサンプルでは、カスタム アクティビティで実行プロパティを定義および使用する方法を示します。  
+  
+ [ActivityAction の公開と呼び出し](../../../../docs/framework/windows-workflow-foundation/samples/exposing-and-invoking-activityactions.md)  
+ このサンプルでは、<xref:System.Activities.ActivityAction> を含むカスタム アクティビティを開発する方法を示します。  
+  
+ [アクティビティでの AsyncOperationContext の使用](../../../../docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md)  
+ このサンプルでは、<xref:System.Activities.AsyncOperationContext> を使用してワークフロー外で非同期に作業を実行するカスタムの <xref:System.Activities.CodeActivity> を開発する方法を示します。  
+  
+ [Hello World カスタム アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/hello-world-custom-activity.md)  
+ このサンプルでは、単純なカスタム アクティビティを作成する方法を含む、[!INCLUDE[wf](../../../../includes/wf-md.md)] の主要な機能をいくつか示します。  
+  
+ [動的引数](../../../../docs/framework/windows-workflow-foundation/samples/dynamic-arguments.md)  
+ このサンプルでは、アクティビティの作成者ではなくアクティビティのコンシューマーによって引数が定義されるアクティビティの実装方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/commentout-activity.md b/docs/framework/windows-workflow-foundation/samples/commentout-activity.md
new file mode 100644
index 00000000000..b2f10218097
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/commentout-activity.md
@@ -0,0 +1,69 @@
+---
+title: "CommentOut アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 340204c3-f827-45fb-870e-55e2ac457ca5
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# CommentOut アクティビティ
+このサンプルでは、実行のパスから他のアクティビティを削除し、それらを有効にコメント化するカスタム アクティビティを記述する方法を示します。  
+  
+## CommentOut アクティビティ  
+ CommentOut アクティビティでは、目標を達成するために、<xref:System.Activities.CodeActivity> 基本クラスを継承し、空の <xref:System.Activities.CodeActivity.Execute%2A> メソッドを実装します。  
+  
+```  
+protected override void Execute(CodeActivityContext context)  
+{  
+}  
+```  
+  
+ クラスは次の例のように宣言されます。  
+  
+```  
+[Designer(typeof(CommentOutDesigner))]  
+[ContentProperty("Body")]  
+public sealed class CommentOut : CodeActivity  
+  
+```  
+  
+ `Designer` 属性は、デザイン時にアクティビティのビジュアル インターフェイスを実装するクラスを指定します。`ContentProperty` 属性は、このアクティビティのインスタンスの XAML 表現で `“Body”` プロパティを省略できることを宣言します。  
+  
+```  
+<Border x:Uid="Border_1" BorderThickness ="1">  
+    <sad:WorkflowItemPresenter   
+    x:Uid="sad:WorkflowItemPresenter_1" AutomationProperties.AutomationId="Body" Item="{Binding Path=ModelItem.Body, Mode=TwoWay}"  
+    AllowedItemType="{x:Type sa:Activity}"  
+    HintText="Drop activity here"   
+    Margin="5,5,5,5" />  
+</Border>  
+```  
+  
+ デザイナー クラスでは、XAML はアクティビティのカスタム ビジュアル表現を作成するために使用されます。<xref:System.Activities.Presentation.WorkflowItemPresenter> はビジュアル エディターを提供するクラスです。  
+  
+ `CommentOut` アクティビティ サーフェイス上には、1 つのアクティビティをドロップできます。このサーフェイスに複数のアクティビティを追加する場合は、最初にシーケンス アクティビティをここにドラッグします。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で CommentOut.sln を開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをコンパイルします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、サンプルをデバッグなしで開始します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\CommentOut`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/compensable-activity-sample.md b/docs/framework/windows-workflow-foundation/samples/compensable-activity-sample.md
new file mode 100644
index 00000000000..a8a03365a58
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/compensable-activity-sample.md
@@ -0,0 +1,37 @@
+---
+title: "補正可能なアクティビティのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58f4898c-b2b8-44a4-9a73-3bef4da6d5ba
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 補正可能なアクティビティのサンプル
+このサンプルでは、`CompensableActivity` アクティビティを使用して、通常の実行中に特定のアクションに対して実行される作業、および必要に応じて後からアクションを補正するために実行する必要がある作業を定義する方法を示します。サンプルの最初の部分では、`CompensableActivity` アクティビティを使用して [!INCLUDE[wf](../../../../includes/wf-md.md)] で補正可能な作業の単位を定義する方法と、これらの作業を正常に実行する方法を示します。サンプルの 2 つ目の部分では、予期しないイベントが発生してワークフロー インスタンスがキャンセルされたときに、同じ単位の補正可能な作業が自動的に補正を引き継ぐ方法を示します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  Visual Studio 2010 を使用して、CompensableActivity.sln を開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  F5 キーを押してアプリケーションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Compensation\BasicCompensableActivity`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/compensation-samples.md b/docs/framework/windows-workflow-foundation/samples/compensation-samples.md
new file mode 100644
index 00000000000..d44e2a05ff2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/compensation-samples.md
@@ -0,0 +1,31 @@
+---
+title: "補正 (サンプル) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3bf46970-d40c-4cf1-b8a7-b1ff46b2af82
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 補正 (サンプル)
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] の補正に関連するサンプルが含まれています。  
+  
+## このセクションの内容  
+ [補正可能なアクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/compensable-activity-sample.md)  
+ <xref:System.Activities.Statements.CompensableActivity> アクティビティを使用して、通常の実行中に特定のアクションに対して実行される作業、および必要に応じて後からアクションを補正するために実行する必要がある作業を定義する方法を示します。  
+  
+ [カスタム補正](../../../../docs/framework/windows-workflow-foundation/samples/custom-compensation-sample.md)  
+ <xref:System.Activities.Statements.CompensableActivity> とその補正ハンドラーを使用してカスタム補正ロジックを定義する方法を示します。  
+  
+ [確認](../../../../docs/framework/windows-workflow-foundation/samples/confirmation.md)  
+ <xref:System.Activities.Statements.CompensableActivity> および確認を使用する 4 つの一般的なシナリオを示します。  
+  
+ [補正可能なアクティビティでのキャンセル ハンドラー](../../../../docs/framework/windows-workflow-foundation/samples/cancellation-handler-on-compensable-activity.md)  
+ <xref:System.Activities.Statements.CompensableActivity> でキャンセル ハンドラーを使用する例を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/composite.md b/docs/framework/windows-workflow-foundation/samples/composite.md
new file mode 100644
index 00000000000..2f075406842
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/composite.md
@@ -0,0 +1,25 @@
+---
+title: "複合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 82d8e85d-8a19-49f4-a3ec-44b7ad543b0f
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 複合
+このセクションでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] の他のアクティビティで構成されるカスタム アクティビティのサンプルを示します。  
+  
+## このセクションの内容  
+ [基本的なアクティビティの構成](../../../../docs/framework/windows-workflow-foundation/samples/basic-activity-composition.md)  
+ カスタム アクティビティとシステム標準アクティビティを作成して、追加のカスタム アクティビティを構築する方法を示します。  
+  
+ [カスタム アクティビティの記述について](../../../../docs/framework/windows-workflow-foundation/samples/getting-started-writing-a-custom-activity.md)  
+ XAML で単純なカスタム アクティビティを定義する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/conditioned-activity-group.md b/docs/framework/windows-workflow-foundation/samples/conditioned-activity-group.md
new file mode 100644
index 00000000000..3c9fc594149
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/conditioned-activity-group.md
@@ -0,0 +1,47 @@
+---
+title: "条件付きアクティビティ グループ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f76ef924-34ce-48ae-8c8d-48faf9697754
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 条件付きアクティビティ グループ
+このサンプルは、旅行の予約アプリケーションです。<xref:System.Workflow.Activities.ConditionedActivityGroup> \(CAG\) には、コード アクティビティである Car アクティビティと Airline アクティビティの 2 つがあります。`SimpleCAGWorkflow` コンストラクタ内の ArrayList オブジェクト "travelNeedType" には、必要とされる旅行の予約の種類が設定されています。`travelNeeds.Add` ステートメントの 1 つまたは両方をコメント化することで、CAG の動作を変更できます。Car アクティビティと Airline アクティビティには、<xref:System.Workflow.Activities.CodeCondition> の設定された <xref:System.Workflow.Activities.ConditionedActivityGroup.WhenConditionProperty> 条件がそれぞれ含まれています。Car アクティビティは、`travelNeeds` コレクションに `TravelNeeds.Car` エントリがある場合にだけ実行され、Airline アクティビティは、`travelNeeds` コレクションに `TravelNeeds.Airline` エントリがある場合にだけ実行されます。  
+  
+ 各アクティビティが実行されると、コレクションから対応するエントリが削除されます。既定の条件 <xref:System.Workflow.Activities.ConditionedActivityGroup.UntilCondition%2A> では、実行中または実行する準備の整った子がない場合に \(それぞれの <xref:System.Workflow.Activities.ConditionedActivityGroup.WhenConditionProperty> 条件による\)、CAG が終了するように指定されています。このサンプルでは、CAG は `travelNeeds` コレクションが空になったときに終了します。  
+  
+### サンプルをビルドするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、ソリューションをデバッグなしで実行します。  
+  
+### サンプルを実行するには  
+  
+-   \[SDK コマンド プロンプト\] ウィンドウで、SimpleCAG\\bin\\debug フォルダ \(Visual Basic バージョンのサンプルの場合は SimpleCAG\\bin フォルダ\) にある .exe ファイルを実行します。このフォルダは、サンプルのメイン フォルダの下にあります。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Rules\SimpleCAG`  
+  
+## 参照  
+ <xref:System.Workflow.Activities.ConditionedActivityGroup>   
+ <xref:System.Workflow.Activities.ConditionedActivityGroup.WhenConditionProperty>   
+ <xref:System.Workflow.Activities.CodeCondition>   
+ <xref:System.Workflow.Activities.ConditionedActivityGroup.UntilCondition%2A>
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/confirmation.md b/docs/framework/windows-workflow-foundation/samples/confirmation.md
new file mode 100644
index 00000000000..8fec62cd022
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/confirmation.md
@@ -0,0 +1,51 @@
+---
+title: "確認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8637aeaf-ac9e-49b8-93f4-da15dee45277
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 確認
+このサンプルでは、<xref:System.Activities.Statements.CompensableActivity> および確認を使用する 4 つの一般的なシナリオを示します。確認を示すために、4 つのワークフローを実行します。このサンプルには、宣言型バージョンと命令型バージョンが用意されています。  
+  
+## 補正可能なアクティビティの確認  
+ 最初のワークフローでは、補正可能なアクティビティを確認する方法を示します。このワークフローは、2 つの <xref:System.Activities.Statements.CompensableActivity> インスタンスのシーケンスで構成されています。2 つ目の <xref:System.Activities.Statements.CompensableActivity> の完了後、確認アクティビティによって 1 つ目のアクティビティが確認されます。ワークフローが正常に完了すると、確認または補正されていないすべての <xref:System.Activities.Statements.CompensableActivity> インスタンスが既定の順序で自動的に確認されます。確認アクティビティを使用しなかった場合、2 つ目の <xref:System.Activities.Statements.CompensableActivity> が最初に確認されていたことになります。  
+  
+## 明示的な補正  
+ 2 番目のシナリオでは、<xref:System.Activities.Statements.CompensableActivity> が明示的に補正される場合の既定の確認に対する影響を示します。このワークフローは、2 つの <xref:System.Activities.Statements.CompensableActivity> アクティビティのシーケンスで構成されています。2 つ目のアクティビティが完了すると、1 つ目のアクティビティが明示的に補正されます。したがって、ワークフローが完了すると、2 つ目の <xref:System.Activities.Statements.CompensableActivity> のみが確認されます。  
+  
+## 入れ子になった CompensableActivity アクティビティの確認順序の制御  
+ 3 番目のシナリオでは、入れ子になった <xref:System.Activities.Statements.CompensableActivity> の確認順序を制御する方法を示します。このシナリオは、ワークフローのルートとしての <xref:System.Activities.Statements.CompensableActivity> で構成されています。ルート <xref:System.Activities.Statements.CompensableActivity> の本体は 3 つの <xref:System.Activities.Statements.CompensableActivity> のシーケンスです。ルート <xref:System.Activities.Statements.CompensableActivity> の <xref:System.Activities.Statements.CompensableActivity.ConfirmationHandler%2A> は、1 つ目および 2 つ目の入れ子になった <xref:System.Activities.Statements.CompensableActivity> をこの順序で確認するように指定するシーケンスです。ワークフローが完了すると、ルート <xref:System.Activities.Statements.CompensableActivity> が確認され、その後、1 つ目、2 つ目、および 3 つ目の入れ子になった <xref:System.Activities.Statements.CompensableActivity> がこの順序で確認されます。したがって、既定の確認順序は基本的に逆になります。3 つ目の <xref:System.Activities.Statements.CompensableActivity> はルート <xref:System.Activities.Statements.CompensableActivity> の一部として <xref:System.Activities.Statements.CompensableActivity.ConfirmationHandler%2A> によって明示的に確認されなかったため、既定の順序に従って確認されます。ただし、このアクティビティが唯一未確認の <xref:System.Activities.Statements.CompensableActivity> であるので、このアクティビティが確認されるだけです。  
+  
+## 変数のスコープ  
+ 4 番目のシナリオでは、アクティビティが完了した場合またはワークフローが完了した場合でも、<xref:System.Activities.Statements.CompensableActivity.CompensationHandler%2A>、<xref:System.Activities.Statements.CompensableActivity.ConfirmationHandler%2A>、または<xref:System.Activities.Statements.CompensableActivity.CancellationHandler%2A> の各ハンドラーが実行されるときに、<xref:System.Activities.Statements.CompensableActivity> またはその親のいずれかに対して定義された変数が有効期間中にスコープ外にならないようにする方法を示します。このワークフローは、2 つの <xref:System.Activities.Statements.CompensableActivity> のシーケンスで構成されています。1 つ目のアクティビティの本体では、変数 `mySum` は、5 と 10 の合計、および印刷される結果に設定されます。2 つ目の <xref:System.Activities.Statements.CompensableActivity> の本体では、合計は、既存の合計と 7 の合計、および印刷される結果に設定されます。1 つ目の <xref:System.Activities.Statements.CompensableActivity> に対しては、カスタムの確認ハンドラーが定義されています。このアクティビティは、合計を印刷し、7 を差し引いて、合計を再度印刷します。印刷された合計を調べることで、両方の <xref:System.Activities.Statements.CompensableActivity> の本体だけでなく <xref:System.Activities.Statements.CompensableActivity.ConfirmationHandler%2A> についても変数がスコープ内にあることがわかります。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でソリューションを読み込みます。  
+  
+2.  ConfirmationSample.exe アプリケーションを実行します。  
+  
+3.  次の出力を確認します。  
+  
+ **明示的な確認: workflowCompensableActivity1 の開始: BodyCompensableActivity2: BodyCompensableActivity1: Confirmation HandlerEnd \(workflowCompensableActivity2\): Confirmation HandlerExplicit の補正: workflowCompensableActivity1 の開始: BodyCompensableActivity2: BodyCompensableActivity1: Compensation HandlerEnd \(workflowCompensableActivity2\): Confirmation HandlerCustom 確認ハンドラー: workflowCompensableActivity1 の開始: BodyCompensableActivity2: BodyCompensableActivity3: BodyEnd \(workflowCompensableActivity1\): Confirmation HandlerCompensableActivity2: Confirmation HandlerCompensableActivity3: Confirmation HandlerVariable のアクセス \(確認ハンドラー内\): workflowCompensableActivity1 の開始: BodyCompensableActivity1: 合計: 15 CompensableActivity2: BodyCompensableActivity2: 7 を sumCompensableActivity2 に加算: 現在の合計: 22 workflowCompensableActivity2 の終了: Confirmation HandlerCompensableActivity1: Confirmation HandlerCompensableActivity2: 合計: 22 CompensableActivity2: 12 を引いた後の現在の合計: 10 終了するには、Enter キーを押します。**  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Compensation\Confirmation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/constraint-types.md b/docs/framework/windows-workflow-foundation/samples/constraint-types.md
new file mode 100644
index 00000000000..16ddb4588f9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/constraint-types.md
@@ -0,0 +1,57 @@
+---
+title: "制約の種類 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6b246e6-1130-4698-9625-c5c42abcbfed
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 制約の種類
+このサンプルでは、ワークフローに制約を適用する 2 種類の方法を示します。1 つはアクティビティの内部 \(ビルド\) から適用する方法で、もう 1 つはアクティビティの外部 \(ポリシー\) から適用する方法です。このシナリオでは、\(サードパーティのソフトウェア会社の\) アクティビティ作成者が 2 つの引数間のリレーションシップを検証します。ここでは、コストが価格以下になるようにする必要があります。これは、一般的な検証ビルド制約です。  
+  
+ 次に、ショップ オーナーがこの一般的なアクティビティに検証を追加します。ここでは、製品のほとんどを $9.99 以下にします。したがって、`CreateProduct` アクティビティに基づくポリシー制約を使用します。  
+  
+ このサンプルでは、次の操作を行います。  
+  
+ アクティビティ作成者 \(ビルド\) は、次を行う必要があります。  
+  
+-   制約 \(`PriceGreaterThanCost`\) を作成します。ここには、すべての検証ロジックが存在します。  
+  
+-   <xref:System.Activities.CodeActivity%601.OnGetConstraints%2A> をオーバーライドし、制約 \(`PriceGreaterThanCost`\) を制約 <xref:System.Collections.IList> に追加します。  
+  
+ ワークフロー作成者 \(ポリシー\) は、次を行う必要があります。  
+  
+-   検証するアクティビティのインスタンスを含むワークフローを作成します \(`CreateProduct`\)。  
+  
+-   制約 \(`MaxPrice`\) を作成します。  
+  
+-   <xref:System.Activities.Validation.ValidatorSettings> インスタンス \(`validatorSettings`\) を作成し、制約 \(`MaxPrice`\) をコレクション `AdditionalConstraints` に追加します。ここで、ワークフロー作成者は、シーケンスや並列などのアクティビティにポリシー制約を追加できます。  
+  
+-   <xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> を呼び出すと、<xref:System.Activities.Validation.ConstraintViolation> オブジェクトの <xref:System.Activities.Validation.ValidationResults> コレクションが返されます。  
+  
+-   \(省略可能\) <xref:System.Activities.Validation.ConstraintViolation> オブジェクトを出力します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ConstraintTypes.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Validation\ConstraintLibrary`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/content-based-correlation.md b/docs/framework/windows-workflow-foundation/samples/content-based-correlation.md
new file mode 100644
index 00000000000..898d6289ccb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/content-based-correlation.md
@@ -0,0 +1,47 @@
+---
+title: "コンテンツ ベースの相関関係 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8638b5d6-1d59-456d-8acd-179a5b39b260
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# コンテンツ ベースの相関関係
+このサンプルでは、メッセージング アクティビティ \(<xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.Receive>、<xref:System.ServiceModel.Activities.SendReply>、および <xref:System.ServiceModel.Activities.ReceiveReply>\) を 1 つまたは複数のコンテンツ ベースの相関関係で使用する方法を示します。このシナリオでは、最初に発注書 ID に基づいて 1 つの相関関係を初期化し、後から顧客 ID に基づいて別の相関関係を作成します。ここでは、<xref:System.ServiceModel.Activities.Receive> アクティビティで、既存の相関関係を追跡し、なおかつ同じ受信メッセージに基づいて新しい相関関係を初期化する方法を示します。  
+  
+## 使用例  
+ メッセージング アクティビティとコンテンツ ベースの相関関係  
+  
+## 説明  
+ このサンプルでは、複数のコンテンツ ベースの相関関係を使用する方法を示します。このシナリオでは、最初に発注書 ID に基づいて 1 つの相関関係を初期化し、後から顧客 ID に基づいて別の相関関係を作成します。相関関係は、<xref:System.ServiceModel.Activities.Receive> アクティビティを使用してカスケード化されます。このアクティビティは、既存の相関関係 \(PurchaseOrderId\) を追跡し、なおかつ同じ受信メッセージに基づいて新しい相関関係 \(CustomerId\) も初期化します。これを実現するために、<xref:System.ServiceModel.Activities.Receive> アクティビティで <xref:System.ServiceModel.Activities.Receive.CorrelatesOn%2A> プロパティ、<xref:System.ServiceModel.Activities.Receive.CorrelatesWith%2A> プロパティ、および <xref:System.ServiceModel.Activities.Receive.CorrelationInitializers%2A> プロパティを使用します。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] アイコンを右クリックして **\[管理者として実行\]** をクリックし、昇格されたアクセス許可で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CascadingCorrelation.sln ソリューション ファイルを開きます。  
+  
+3.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+4.  サーバーを実行するには、F5 キーを押します。  
+  
+5.  サービスの準備ができ、メッセージのリッスンを開始したら、ソリューション エクスプローラーで、Client プロジェクトを右クリックして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\ContentBasedCorrelation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md b/docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md
new file mode 100644
index 00000000000..78ad44523f4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/corporate-purchase-process.md
@@ -0,0 +1,184 @@
+---
+title: "企業の購買プロセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a5e57336-4290-41ea-936d-435593d97055
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 企業の購買プロセス
+このサンプルは、Request for Proposals \(RFP: 提案依頼書\) に基づくごく基本的な購買プロセスを作成する方法を示しています。この購買プロセスでは最良の提案が自動的に選択されます。  このサンプルでは、<xref:System.Activities.Statements.Parallel>、<xref:System.Activities.Statements.ParallelForEach%601>、および <xref:System.Activities.Statements.ForEach%601> と、プロセスを表すワークフローを作成するカスタム アクティビティが組み合わされています。  
+  
+ このサンプルには、異なる参加者として \(元の要求者や特定のベンダーとして\) プロセスとやり取りできる [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] クライアント アプリケーションが含まれています。  
+  
+## 必要条件  
+  
+-   [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)]。  
+  
+-   [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)]。  
+  
+## 使用例  
+  
+-   カスタム アクティビティ。  
+  
+-   アクティビティの構成。  
+  
+-   ブックマーク。  
+  
+-   永続性。  
+  
+-   スキーマ化された永続化。  
+  
+-   トレース。  
+  
+-   追跡。  
+  
+-   さまざまなクライアントでの [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のホスティング \([!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] Web アプリケーションおよび WinForms アプリケーション\)。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Application\PurchaseProcess`  
+  
+## プロセスの説明  
+ このサンプルは、任意の会社のためにベンダーからの提案を集める [!INCLUDE[wf](../../../../includes/wf-md.md)] プログラムの実装を示しています。  
+  
+1.  Company X の従業員が Request for Proposal \(RFP\) を作成します。  
+  
+    1.  RFP のタイトルと説明を入力します。  
+  
+    2.  提案の送信を依頼するベンダーを選択します。  
+  
+2.  従業員が提案を送信します。  
+  
+    1.  ワークフローのインスタンスが作成されます。  
+  
+    2.  ワークフローは、すべてのベンダーから提案が送信されるまで待機します。  
+  
+3.  すべての提案が受信されると、それらがワークフローによって反復処理されて、最良の提案が選択されます。  
+  
+    1.  ベンダーにはそれぞれ評価があります \(評価リストは VendorRepository.cs に格納されています\)。  
+  
+    2.  提案の合計金額は、\(ベンダーによって入力された金額\) \* \(記録されているベンダーの評価\) \/ 100 という式によって決定されます。  
+  
+4.  元の要求者は、送信されたすべての提案を表示できます。  最良の提案はレポートの特別なセクションに表示されます。  
+  
+## プロセスの定義  
+ このサンプルのコア ロジックでは <xref:System.Activities.Statements.ParallelForEach%601> アクティビティが使用されています。このアクティビティは、各ベンダーからの提案を待機して \(ブックマークを作成するカスタム アクティビティを使用\)、ベンダーの提案を RFP として登録します \(<xref:System.Activities.Statements.InvokeMethod> アクティビティを使用\)。  
+  
+ その後、`RfpRepository` に格納されている受信したすべての提案が反復処理されて、調整金額が計算されます \(<xref:System.Activities.Statements.Assign> アクティビティと <xref:System.Activities.Expressions> アクティビティを使用\)。調整金額が前の最良の提案より優れている場合は、その新しい金額が最良の提案に割り当てられます \(<xref:System.Activities.Statements.If> アクティビティと <xref:System.Activities.Statements.Assign> アクティビティを使用\)。  
+  
+## このサンプルのプロジェクト  
+ このサンプルには次のプロジェクトが含まれています。  
+  
+|プロジェクト|説明|  
+|------------|--------|  
+|Common|プロセス内で使用されるエンティティ オブジェクト \(Request for Proposal、Vendor、および Vendor Proposal\)。|  
+|WfDefinition|購買プロセス ワークフローのインスタンスの作成および使用のためにクライアント アプリケーションによって使用されるプロセス \([!INCLUDE[wf1](../../../../includes/wf1-md.md)] プログラムとしてのプロセス\) とホスト \(`PurchaseProcessHost`\) の定義。|  
+|WebClient|購買プロセスのインスタンスを作成したりそれに参加したりできる [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] クライアント アプリケーション。  独自に作成したホストを使用してワークフロー エンジンとやり取りします。|  
+|WinFormsClient|購買プロセスのインスタンスを作成したりそれに参加したりできる Windows フォーム クライアント アプリケーション。  独自に作成したホストを使用してワークフロー エンジンとやり取りします。|  
+  
+### WfDefinition  
+ 次の表には、WfDefinition プロジェクトの最も重要なファイルの説明が含まれています。  
+  
+|ファイル|説明|  
+|----------|--------|  
+|IPurchaseProcessHost.cs|ワークフローのホストのインターフェイス。|  
+|PurchaseProcessHost.cs|ワークフローのホストの実装。  ホストは、ワークフロー ランタイムの詳細を抽象化します。`PurchaseProcess` ワークフローのインスタンスの読み込み、実行、およびインスタンスとのやり取りのために、すべてのクライアント アプリケーションで使用されます。|  
+|PurchaseProcessWorkflow.cs|Purchase Process ワークフローの定義を含むアクティビティ \(<xref:System.Activities.Activity> から派生します\)。<br /><br /> <xref:System.Activities.Activity> から派生するアクティビティは、既存のカスタム アクティビティと [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] アクティビティ ライブラリのアクティビティをまとめることで機能を構成します。  これらのアクティビティをまとめることは、カスタム機能を作成するための最も基本的な方法です。|  
+|WaitForVendorProposal.cs|このカスタム アクティビティは <xref:System.Activities.NativeActivity> から派生し、後にベンダーが提案を送信するときに再開する必要がある名前付きブックマークを作成します。<br /><br /> <xref:System.Activities.NativeActivity> から派生するアクティビティは、<xref:System.Activities.CodeActivity> から派生するアクティビティと同様に、<xref:System.Activities.NativeActivity.Execute%2A> をオーバーライドすることで、命令型機能を作成します。ただし、<xref:System.Activities.ActivityContext> メソッドに渡される `Execute` を介して、ワークフロー ランタイムのすべての機能にもアクセスできます。  このコンテキストは、子アクティビティのスケジュールと取り消し、非永続化ゾーン \(アトミック トランザクションの中など、ランタイムによってワークフローのデータが永続化されない実行ブロック\) の設定、および <xref:System.Activities.Bookmark> オブジェクト \(一時停止したワークフローの再開を処理\) をサポートします。|  
+|TrackingParticipant.cs|すべての追跡イベントを受信してテキスト ファイルに保存する <xref:System.Activities.Tracking.TrackingParticipant>。<br /><br /> 追跡参加要素は拡張としてワークフロー インスタンスに追加されます。|  
+|XmlWorkflowInstanceStore.cs|ワークフロー アプリケーションを XML ファイルに保存するカスタムの <xref:System.Runtime.DurableInstancing.InstanceStore>。|  
+|XmlPersistenceParticipant.cs|Request for Proposal のインスタンスを XML ファイルに保存するカスタムの <xref:System.Activities.Persistence.PersistenceParticipant>。|  
+|AsyncResult.cs \/ CompletedAsyncResult.cs|永続化コンポーネントに非同期パターンを実装するためのヘルパー クラス。|  
+  
+### Common  
+ 次の表には、Common プロジェクトの最も重要なクラスの説明が含まれています。  
+  
+|クラス|説明|  
+|---------|--------|  
+|Vendor|Request for Proposals で提案を送信するベンダー。|  
+|RequestForProposal|Request for Proposals \(RFP\) は、ベンダーに特定の商品またはサービスについての提案の送信を求める依頼書です。|  
+|VendorProposal|ベンダーによって具象 RFP に送信された提案。|  
+|VendorRepository|Vendor のリポジトリ。  この実装には、Vendor のインスタンスのメモリ内コレクションと、それらのインスタンスを公開するためのメソッドが含まれています。|  
+|RfpRepository|Request for Proposals のリポジトリ。  この実装は、Linq to XML を使用して、スキーマ化された永続化によって生成された Request for Proposal の XML ファイルをクエリします。  このクラスは <xref:System.Runtime.Persistence.IDataViewMapper> を実装します。|  
+|IOHelper|このクラスは、I\/O 関連のすべての問題を処理します \(フォルダー、パスなど\)。|  
+  
+### Web Client  
+ 次の表には、Web Client プロジェクトの最も重要な Web ページの説明が含まれています。  
+  
+|||  
+|-|-|  
+|ファイル|説明|  
+|CreateRfp.aspx|新しい Request for Proposals を作成して送信します。|  
+|Default.aspx|アクティブな Request for Proposals と完了した Request for Proposals をすべて表示します。|  
+|GetVendorProposal.aspx|具象 Request for Proposals 内のベンダーからの提案を取得します。  このページを使用するのはベンダーだけです。|  
+|ShowRfp.aspx|Request for Proposals に関するすべての情報 \(受信した提案、日付、金額、およびその他の情報\) を表示します。  このページを使用するのは Request for Proposal の作成者だけです。|  
+  
+### WinForms Client  
+ 次の表には、WinForms Client プロジェクトの最も重要なフォームの説明が含まれています。  
+  
+|||  
+|-|-|  
+|フォーム|説明|  
+|NewRfp|新しい Request for Proposals を作成して送信します。|  
+|ShowProposals|アクティブな Request for Proposals と完了した Request for Proposals をすべて表示します。 **Note:**  Request for Proposal を作成または変更した後にこの画面に変更内容が表示されない場合は、UI の **\[Refresh\]** ボタンをクリックしてください。|  
+|SubmitProposal|具象 Request for Proposals 内のベンダーからの提案を取得します。  このウィンドウを使用するのはベンダーだけです。|  
+|ViewRfp|Request for Proposals に関するすべての情報 \(受信した提案、日付、金額、およびその他の情報\) を表示します。  このウィンドウを使用するのは Request for Proposals の作成者だけです。|  
+  
+### 永続化ファイル  
+ 次の表は、永続化プロバイダー \(`XmlPersistenceProvider`\) によって生成されるファイルを示しています。これらのファイルは、現在のシステムの一時フォルダーのパスに配置されます \(<xref:System.IO.Path.GetTempPath%2A> を使用\)。  トレース ファイルは現在の実行パスに作成されます。  
+  
+||||  
+|-|-|-|  
+|ファイル名|説明|パス|  
+|rfps.xml|アクティブな Request for Proposals と完了した Request for Proposals をすべて含む XML ファイル。|<xref:System.IO.Path.GetTempPath%2A>|  
+|\[instanceid\]|このファイルには、ワークフロー インスタンスに関するすべての情報が含まれています。<br /><br /> このファイルは、スキーマ化された永続化の実装 \(XmlPersistenceProvider の PersistenceParticipant\) によって生成されます。|<xref:System.IO.Path.GetTempPath%2A>|  
+|\[instanceId\].tracking|具象インスタンス内で発生したすべてのイベントを含むテキスト ファイル。<br /><br /> このファイルは TrackingParticipant によって生成されます。|<xref:System.IO.Path.GetTempPath%2A>|  
+|PurchaseProcess.Tracing.TraceLog.txt|App.config ファイルまたは Web.config ファイルの構成パラメーターに基づいてワークフローによって生成されるトレース ファイル。|現在の実行パス|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、PurchaseProcess.sln ソリューション ファイルを開きます。  
+  
+2.  Web Client プロジェクトを実行するには、**\[ソリューション エクスプローラー\]** を開き、**\[Web Client\]** プロジェクトを右クリックして、  **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+3.  WinForms Client プロジェクトを実行するには、**\[ソリューション エクスプローラー\]** を開き、**\[WinForms Client\]** プロジェクトを右クリックして、  **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+4.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+5.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+### Web Client のオプション  
+  
+-   **Create a new RFP**: 新しい Request for Proposals \(RFP\) を作成し、Purchase Process ワークフローを開始します。  
+  
+-   **Refresh**: メイン ウィンドウの \[Active and Finished RFPs\] の一覧を更新します。  
+  
+-   **View**: 既存の RFP の内容を表示します。  ベンダーは自身の提案を送信できます \(依頼されている場合。依頼されていない場合は RFP が完了していません\)。  
+  
+-   View As: さまざまな ID を使用して RFP にアクセスできます。そのためには、アクティブな RFP のグリッドの **\[View as\]** ボックスで目的の参加者を選択します。  
+  
+### WinForms Client のオプション  
+  
+-   **Create RFP**: 新しい Request for Proposals \(RFP\) を作成し、Purchase Process ワークフローを開始します。  
+  
+-   **Refresh**: メイン ウィンドウの \[Active and Finished RFPs\] の一覧を更新します。  
+  
+-   **View RFP**: 既存の RFP の内容を表示します。  ベンダーは自身の提案を送信できます \(依頼されている場合。依頼されていない場合は RFP が完了していません\)。  
+  
+-   **Connect As**: さまざまな ID を使用して RFP にアクセスできます。そのためには、アクティブな RFP のグリッドの **\[View as\]** コンボ ボックスで目的の参加者を選択します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/correlated-calculator.md b/docs/framework/windows-workflow-foundation/samples/correlated-calculator.md
new file mode 100644
index 00000000000..cf3bec34fb7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/correlated-calculator.md
@@ -0,0 +1,45 @@
+---
+title: "相関電卓 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c365166e-6552-49a4-bf17-9f4e597d4d41
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 相関電卓
+このサンプルでは、メッセージ内のパラメーターに基づくコンテンツ ベースの相関関係と共に、デザイナーでメッセージング アクティビティ \(<xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.SendReply>\) を使用する方法を示します。このシナリオでは、電卓の操作はパラレルなコンボイで行われます。インスタンスおよび \(`CalculatorId` に基づく\) 相関関係は、最初のメッセージがワークフローに送信されたときに作成され、それ以降の同じ `CalculatorId` を持つメッセージは、リセット操作が呼び出されるまでそのインスタンスにディスパッチされます。クライアントは、コード ベースのクライアント プロキシを使用してサービスと通信する WPF アプリケーションとして実装されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  昇格されたアクセス許可で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を起動し、For.sln ソリューション ファイルを開きます。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] が含まれるフォルダーに移動します。  
+  
+    2.  Devenv.exe を右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CorrelatedCalculator.sln ソリューション ファイルを開きます。  
+  
+3.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+4.  サービス プロジェクトを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+5.  サービスの準備ができ、メッセージのリッスンを開始したら、ソリューション エクスプローラーで、Client プロジェクトを右クリックして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\CorellatedCalculator`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/creating-and-running-a-workflow-instance.md b/docs/framework/windows-workflow-foundation/samples/creating-and-running-a-workflow-instance.md
new file mode 100644
index 00000000000..8eabc015c90
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/creating-and-running-a-workflow-instance.md
@@ -0,0 +1,38 @@
+---
+title: "ワークフロー インスタンスの作成と実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 19d27f47-0491-4569-8f53-51bc1d940e80
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ワークフロー インスタンスの作成と実行
+このサンプルでは、ワークフロー インスタンスを実行する方法を示します。ここでは、ワークフロー インスタンスを同期的または非同期的に実行する方法を示します。  
+  
+## 使用例  
+ <xref:System.Activities.WorkflowInvoker>, <xref:System.Activities.WorkflowApplication>.  
+  
+## 説明  
+ サンプルの最初の部分では <xref:System.Activities.WorkflowInvoker.Invoke%2A> を使用します。これはワークフローを実行する最も基本的な方法です。<xref:System.Activities.WorkflowInvoker.Invoke%2A> を使用して実行するワークフローは同期的に実行されます。  
+  
+ サンプルの 2 番目の部分は <xref:System.Activities.WorkflowApplication> クラスを使用します。<xref:System.Activities.WorkflowApplication> を使用すると、各インスタンスをより細かく制御できるようになり、実行中のワークフローと対話したり、ワークフローを非同期的に実行したりできます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\CreatingWorkflowInstances`  
+  
+## 参照  
+ [WorkflowInvoker と WorkflowApplication の使用](../../../../docs/framework/windows-workflow-foundation//using-workflowinvoker-and-workflowapplication.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-activities.md b/docs/framework/windows-workflow-foundation/samples/custom-activities.md
new file mode 100644
index 00000000000..70750c952f8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-activities.md
@@ -0,0 +1,31 @@
+---
+title: "カスタム アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5cde06b3-51b2-4e46-900d-11140bae77f4
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# カスタム アクティビティ
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] でカスタム アクティビティを作成する方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [コード本文](../../../../docs/framework/windows-workflow-foundation/samples/code-bodied.md)  
+ コードで宣言して作成するカスタム アクティビティのサンプルを示します。  
+  
+ [複合](../../../../docs/framework/windows-workflow-foundation/samples/composite.md)  
+ 他のアクティビティで構成されるカスタム アクティビティのサンプルを示します。  
+  
+ [カスタム アクティビティ デザイナー](../../../../docs/framework/windows-workflow-foundation/samples/custom-activity-designers.md)  
+ ワークフロー デザイナーに表示するカスタム デザイナーを使用するアクティビティ サンプルを示します。  
+  
+ [検証](../../../../docs/framework/windows-workflow-foundation/samples/validation.md)  
+ デザイン時のアクティビティの検証を示すサンプルを示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-activity-designers.md b/docs/framework/windows-workflow-foundation/samples/custom-activity-designers.md
new file mode 100644
index 00000000000..0897e65232c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-activity-designers.md
@@ -0,0 +1,34 @@
+---
+title: "カスタム アクティビティ デザイナー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: dcf14dca-ce6d-4278-96ba-062f0a679075
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# カスタム アクティビティ デザイナー
+このセクションでは、ワークフロー デザイナーに表示するカスタム デザイナーを使用するアクティビティ サンプルを示します。  
+  
+## このセクションの内容  
+ [カスタム複合デザイナー \- Workflow Item Presenter](../../../../docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-item-presenter.md)  
+ このサンプルでは、このような "ドロップ ゾーン" を表示するアクティビティ デザイナーの構築方法を示します。  
+  
+ [カスタム複合デザイナー \- Workflow Items Presenter](../../../../docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-items-presenter.md)  
+ このサンプルでは、このような編集可能なコレクションを表示するアクティビティ デザイナーの構築方法を示します。  
+  
+ [メタデータ ストアのプログラム性](../../../../docs/framework/windows-workflow-foundation/samples/metadata-store-programmability.md)  
+ このサンプルでは、属性を実行時の型に適用することで、メタデータ ストアを使用して制御できないソースをプログラミングする方法を示します。  
+  
+ [カスタム アクティビティ デザイナーでの ExpressionTextBox の使用](../../../../docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md)  
+ このサンプルでは、カスタム アクティビティ デザイナーで <xref:System.Activities.Presentation.View.ExpressionTextBox> を使用する方法を示します。  
+  
+ [編集スコープの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-editing-scope.md)  
+ このサンプルでは、変更のセットを 1 つの分割不可能な単位で元に戻せるように、変更のセットをバッチ処理する方法を示します。既定では、アクティビティ デザイナー作者が実行した操作は、"元に戻す\/やり直し" システムに自動的に統合されます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-activity-to-switch-on-a-range-of-values.md b/docs/framework/windows-workflow-foundation/samples/custom-activity-to-switch-on-a-range-of-values.md
new file mode 100644
index 00000000000..62b7c02a962
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-activity-to-switch-on-a-range-of-values.md
@@ -0,0 +1,117 @@
+---
+title: "値の範囲で切り替えを行うカスタム アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 441e0a17-421f-430c-ba97-59e4cc6c88e3
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 値の範囲で切り替えを行うカスタム アクティビティ
+このサンプルでは、<xref:System.Activities.Statements.Switch%601> の使用を拡張するカスタム アクティビティを作成する方法を示します。従来の <xref:System.Activities.Statements.Switch%601> ステートメントでは、単一の値に基づく切り替えが可能です。しかし、ビジネス上のシナリオでは、値の範囲に基づいて切り替えを行う必要があるアクティビティもあります。たとえば、切り替えの基準となる値が 1 ～ 5 の場合はあるアクションを実行し、6 ～ 10 の場合は別のアクションを実行し、それ以外の値の場合は既定のアクションを実行するようなアクティビティもあります。このカスタム アクティビティを使用すると、そのようなシナリオが可能になります。  
+  
+## SwitchRange アクティビティ  
+ `SwitchRange` アクティビティは、式の結果の値がいずれかの `Cases` の範囲内に含まれる場合に子アクティビティをスケジュールします。  
+  
+ 値の範囲に基づいて切り替えを行うカスタム アクティビティのコード例を次に示します。  
+  
+```csharp  
+  
+public sealed class SwitchRange<T> : NativeActivity where T : IComparable  
+{  
+   [RequiredArgument]  
+   [DefaultValue(null)]  
+   public InArgument<T> Expression { get; set; }  
+  
+   public IList<CaseRange<T>> Cases  
+  
+   [DefaultValue(null)]  
+   public Activity Default { get; set; }}  
+}  
+```  
+  
+|||  
+|-|-|  
+|プロパティ|説明|  
+|式|評価されて Cases リストの範囲と比較される式です。式の結果は T 型です。|  
+|Cases|各ケースは、範囲 \(From および To\) とアクティビティ \(Body\) で構成されます。式が評価されて範囲と比較され、式の結果がいずれかのケースの範囲内の値になると、対応するアクティビティが実行されます。|  
+|Default|一致するケースがない場合に実行されるアクティビティです。`null` に設定されている場合、アクションは実行されません。|  
+  
+## CaseRange クラス  
+ `CaseRange` クラスは、`SwitchRange` アクティビティ内の範囲を表します。`CaseRange` の各インスタンスには、範囲 \(`From` および `To`\) と、`SwitchRange` の式の評価結果が範囲内の値になった場合にスケジュールされる `Body` アクティビティが含まれます。  
+  
+ `CaseRange` クラスの定義のコード例を次に示します。  
+  
+```  
+  
+public class CaseRange<T> where T : IComparable  
+{  
+    public T From { get; set; }  
+  
+    public T To { get; set; }  
+  
+    public Activity Action { get; set; }  
+}  
+```  
+  
+> [!NOTE]
+>  このサンプルで定義されている `SwitchRange` クラスと `CaseRange` クラスはどちらも、<xref:System.Activities.Statements.Switch%601> クラスと同様に、`IComparable` を実装する任意の型で実行できるジェネリック クラスです。  
+  
+## サンプルの使用方法  
+ `SwitchRange` アクティビティの使用方法を次のコード例に示します。  
+  
+```csharp  
+  
+Activity SwitchRange = new SwitchRange<int>  
+{  
+    Expression = new InArgument<int>(value),  
+    Cases =   
+    {  
+        new CaseRange<int>                      
+        {  
+            From = 1,  
+            To = 5,  
+            Action = new WriteLine  
+            {  
+                Text = "Case 1-5 selected",  
+            }  
+        },  
+        new CaseRange<int>  
+        {  
+            From = 6,  
+            To = 10,  
+            Action = new WriteLine  
+            {  
+                Text = "Case 6-10 selected",  
+            }  
+        }  
+    },  
+    Default = new WriteLine { Text = "Default Case selected" }  
+};  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、SwitchRange.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\SwitchRange`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-compensation-sample.md b/docs/framework/windows-workflow-foundation/samples/custom-compensation-sample.md
new file mode 100644
index 00000000000..ccd6fe799a6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-compensation-sample.md
@@ -0,0 +1,60 @@
+---
+title: "カスタム補正のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 385920da-9284-44bf-9fe9-0d87c7478ec5
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# カスタム補正のサンプル
+このサンプルでは、<xref:System.Activities.Statements.CompensableActivity> とその補正ハンドラーを使用してカスタム補正ロジックを定義する方法を示します。このサンプルでは、トラック レンタル会社のシナリオをモデル化しています。  
+  
+## サンプルの詳細  
+ シミュレートする手順は次のとおりです。  
+  
+1.  ユーザーが日付を指定してトラック レンタルの見積もりを要求します。  
+  
+2.  トラック会社 3 社に連絡して、3 つの見積もりを入手します。  
+  
+3.  ユーザーがトラックの見積もりを 1 つ選択し、クレジット カードでの注文に進みます。  
+  
+4.  アプリケーションで、他の 2 つのトラックの見積もりが取り消されます。  
+  
+5.  利用予定日の 10 日前を過ぎてからの取り消しの場合にプレミアム アカウント以外には払い戻しされないサービス手数料が、アプリケーションで請求されます。  
+  
+6.  アプリケーションで、トラックのレンタル料金が請求されます。  
+  
+7.  アプリケーションは、利用予定日になるか顧客が予約を取り消すか、どちらか早い方まで待機します。  
+  
+8.  顧客が予約を取り消した場合、次のロジックに従って <xref:System.Activities.Statements.CompensableActivity.CompensationHandler%2A> カスタム補正ロジックが実行されます。  
+  
+    1.  顧客がプレミアム アカウントでなく、かつ利用予定日の 10 日前を過ぎている場合、サービス手数料が請求されます。それ以外の場合は、サービス手数料が返金されます。  
+  
+    2.  残りの補正可能なアクティビティ \(トラックの注文 \+ トラックの注文料金\) については、既定の補正ロジックに従って、逆の順序で補正が実行されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CustomCompensation.sln ソリューション ファイルを開きます。このソリューションは \\WF\\Basic\\Compensation\\CustomCompensation ディレクトリにあります。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Compensation\CustomCompensation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-item-presenter.md b/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-item-presenter.md
new file mode 100644
index 00000000000..46d0cf8dc40
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-item-presenter.md
@@ -0,0 +1,90 @@
+---
+title: "カスタム複合デザイナー - Workflow Item Presenter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f85224cf-9e30-44a5-9a81-3bc438a34364
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# カスタム複合デザイナー - Workflow Item Presenter
+<xref:System.Activities.Presentation.WorkflowItemPresenter> は、任意のアクティビティを配置できる "ドロップ ゾーン" を作成できる、WF デザイナー プログラミング モデル内の主要な型です。このサンプルでは、このような "ドロップ ゾーン" を表示するアクティビティ デザイナーの構築方法を示します。  
+  
+ このサンプルでは、次の方法を示します。  
+  
+## 使用例  
+  
+-   <xref:System.Activities.Presentation.WorkflowItemPresenter> を使用したカスタム アクティビティ デザイナーの作成  
+  
+-   メタデータ ストアを使用したカスタム デザイナーの登録。  
+  
+-   宣言および命令による再ホストされたツールボックスのプログラミング。  
+  
+## サンプルの詳細  
+ このサンプルのコードを次に示します。  
+  
+-   カスタム アクティビティ デザイナーは `SimpleNativeActivity` クラス用に作成されます。  
+  
+-   <xref:System.Activities.Presentation.WorkflowItemPresenter> を使用してカスタム アクティビティ デザイナーを作成します。  
+  
+```xaml  
+<sap:ActivityDesigner x:Class="Microsoft.Samples.UsingWorkflowItemPresenter.SimpleNativeDesigner"  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    xmlns:sap="clr-namespace:System.Activities.Presentation;assembly=System.Activities.Presentation"  
+    xmlns:sapv="clr-namespace:System.Activities.Presentation.View;assembly=System.Activities.Presentation">  
+    <sap:ActivityDesigner.Resources>  
+        <DataTemplate x:Key="Collapsed">  
+            <StackPanel>  
+                <TextBlock>This is the collapsed view</TextBlock>  
+            </StackPanel>  
+        </DataTemplate>  
+        <DataTemplate x:Key="Expanded">  
+            <StackPanel>  
+                <TextBlock>Custom Text</TextBlock>  
+                <sap:WorkflowItemPresenter Item="{Binding Path=ModelItem.Body, Mode=TwoWay}"  
+                                        HintText="Please drop an activity here" />  
+            </StackPanel>  
+        </DataTemplate>  
+        <Style x:Key="ExpandOrCollapsedStyle" TargetType="{x:Type ContentPresenter}">  
+            <Setter Property="ContentTemplate" Value="{DynamicResource Collapsed}"/>  
+            <Style.Triggers>  
+                <DataTrigger Binding="{Binding Path=ShowExpanded}" Value="true">  
+                    <Setter Property="ContentTemplate" Value="{DynamicResource Expanded}"/>  
+                </DataTrigger>  
+            </Style.Triggers>  
+        </Style>  
+    </sap:ActivityDesigner.Resources>  
+    <Grid>  
+        <ContentPresenter Style="{DynamicResource ExpandOrCollapsedStyle}" Content="{Binding}" />  
+    </Grid>  
+</sap:ActivityDesigner>  
+```  
+  
+ `ModelItem.Body` にバインドする WPF のデータ バインドの使用に注意してください。`ModelItem` は、デザイナーが使用されている、基になるオブジェクト \(この例では **SimpleNativeActivity**\) を参照する <xref:System.Activities.Presentation.WorkflowElementDesigner> のプロパティです。  
+  
+#### サンプルをセットアップ、作成、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  F5 キーを押してアプリケーションをコンパイルし、実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CustomActivityDesigners\WorkflowItemPresenter`  
+  
+## 参照  
+ <xref:System.Activities.Presentation.WorkflowItemPresenter>   
+ [ワークフロー デザイナーを使用したアプリケーションの開発](../Topic/Developing%20Applications%20with%20the%20Workflow%20Designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-items-presenter.md b/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-items-presenter.md
new file mode 100644
index 00000000000..efa90167679
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-composite-designers-workflow-items-presenter.md
@@ -0,0 +1,172 @@
+---
+title: "カスタム複合デザイナー - Workflow Items Presenter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 70055c4b-1173-47a3-be80-b5bce6f59e9a
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# カスタム複合デザイナー - Workflow Items Presenter
+<xref:System.Activities.Design.WorkflowItemsPresenter> は、格納されている要素のコレクションを編集できる、WF デザイナー プログラミング モデル内の主要な型です。このサンプルでは、このような編集可能なコレクションを表示するアクティビティ デザイナーの構築方法を示します。  
+  
+ このサンプルでは、次の方法を示します。  
+  
+-   <xref:System.Activities.Design.WorkflowItemsPresenter> を使用したカスタム アクティビティ デザイナーの作成。  
+  
+-   "折りたたまれている" および "展開されている" ビューを示すアクティビティ デザイナーの作成  
+  
+-   再ホストされたアプリケーションでの既定のデザイナーのオーバーライド  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  C\# または VB 用の **UsingWorkflowItemsPresenter.sln** サンプル ソリューションを [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で開きます。  
+  
+2.  ソリューションをビルドして実行します。再ホストされたワークフロー デザイナー アプリケーションが開き、アクティビティをキャンバスにドラッグできます。  
+  
+## サンプルの詳細  
+ このサンプルのコードには、次の内容が表示されます。  
+  
+-   デザイナーをビルドするアクティビティは `Parallel` です。  
+  
+-   <xref:System.Activities.Design.WorkflowItemsPresenter> を使用してカスタム アクティビティ デザイナーを作成します。次の点に注意してください。  
+  
+    -   `ModelItem.Branches` にバインドする WPF のデータ バインドの使用に注意してください。`ModelItem` は、デザイナーが使用されている、基になるオブジェクト \(この例では `Parallel`\) を参照する <xref:System.Activities.Design.WorkflowElementDesigner> のプロパティです。  
+  
+    -   <xref:System.Activities.Design.WorkflowItemsPresenter.SpacerTemplate%2A> は、コレクション内の個々の項目間にビジュアル表示を配置するために使用できます。  
+  
+    -   <xref:System.Activities.Design.WorkflowItemsPresenter.ItemsPanel%2A> は、コレクション内の項目のレイアウトを決定するために提供できるテンプレートです。この例では、水平方向のスタック パネルが使用されます。  
+  
+ このコード例を次に示します。  
+  
+```xaml  
+<sad:WorkflowItemsPresenter HintText="Drop Activities Here"  
+                              Items="{Binding Path=ModelItem.Branches}">  
+    <sad:WorkflowItemsPresenter.SpacerTemplate>  
+      <DataTemplate>  
+        <Ellipse Width="10" Height="10" Fill="Black"/>  
+      </DataTemplate>  
+    </sad:WorkflowItemsPresenter.SpacerTemplate>  
+    <sad:WorkflowItemsPresenter.ItemsPanel>  
+      <ItemsPanelTemplate>  
+        <StackPanel Orientation="Horizontal"/>  
+      </ItemsPanelTemplate>  
+    </sad:WorkflowItemsPresenter.ItemsPanel>  
+  </sad:WorkflowItemsPresenter>  
+  
+```  
+  
+-   `DesignerAttribute` の `Parallel` 型への関連付けを実行し、報告された属性を出力します。  
+  
+    -   最初に、すべての既定のデザイナーを登録します。  
+  
+ このコード例を次に示します。  
+  
+```csharp  
+// register metadata  
+(new DesignerMetadata()).Register();  
+RegisterCustomMetadata();  
+  
+```  
+  
+```vb  
+' register metadata  
+Dim metadata = New DesignerMetadata()  
+metadata.Register()  
+' register custom metadata  
+RegisterCustomMetadata()  
+  
+```  
+  
+-   -   次に、`RegisterCustomMetadata` メソッドで parallel をオーバーライドします。  
+  
+ 次に、C\# と Visual Basic のコード例をそれぞれ示します。  
+  
+ C\#  
+  
+```csharp  
+void RegisterCustomMetadata()  
+{  
+      AttributeTableBuilder builder = new AttributeTableBuilder();  
+      builder.AddCustomAttributes(typeof(Parallel), new DesignerAttribute(typeof(CustomParallelDesigner)));  
+      MetadataStore.AddAttributeTable(builder.CreateTable());  
+}  
+  
+```  
+  
+```vb  
+Sub RegisterCustomMetadata()  
+   Dim builder As New AttributeTableBuilder()  
+   builder.AddCustomAttributes(GetType(Parallel), New DesignerAttribute(GetType(CustomParallelDesigner)))  
+   MetadataStore.AddAttributeTable(builder.CreateTable())  
+End Sub  
+  
+```  
+  
+-   最後に、さまざまなデータ テンプレートとトリガーを使用して、`IsRootDesigner` プロパティに基づいて適切なテンプレートを選択していることに注目してください。  
+  
+ このコード例を次に示します。  
+  
+```xaml  
+<sad:ActivityDesigner x:Class="Microsoft.Samples.CustomParallelDesigner"  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    xmlns:sad="clr-namespace:System.Activities.Design;assembly=System.Activities.Design"  
+    xmlns:sadv="clr-namespace:System.Activities.Design.View;assembly=System.Activities.Design">  
+  <sad:ActivityDesigner.Resources>  
+    <DataTemplate x:Key="Expanded">  
+      <StackPanel>  
+        <TextBlock>This is the Expanded View</TextBlock>  
+        <sad:WorkflowItemsPresenter HintText="Drop Activities Here"  
+                                    Items="{Binding Path=ModelItem.Branches}">  
+          <sad:WorkflowItemsPresenter.SpacerTemplate>  
+            <DataTemplate>  
+              <Ellipse Width="10" Height="10" Fill="Black"/>  
+            </DataTemplate>  
+          </sad:WorkflowItemsPresenter.SpacerTemplate>  
+          <sad:WorkflowItemsPresenter.ItemsPanel>  
+            <ItemsPanelTemplate>  
+              <StackPanel Orientation="Horizontal"/>  
+            </ItemsPanelTemplate>  
+          </sad:WorkflowItemsPresenter.ItemsPanel>  
+        </sad:WorkflowItemsPresenter>  
+      </StackPanel>  
+    </DataTemplate>  
+    <DataTemplate x:Key="Collapsed">  
+      <TextBlock>This is the Collapsed View</TextBlock>  
+    </DataTemplate>  
+    <Style x:Key="ExpandOrCollapsedStyle" TargetType="{x:Type ContentPresenter}">  
+      <Setter Property="ContentTemplate" Value="{DynamicResource Collapsed}"/>  
+      <Style.Triggers>  
+        <DataTrigger Binding="{Binding Path=IsRootDesigner}" Value="true">  
+          <Setter Property="ContentTemplate" Value="{DynamicResource Expanded}"/>  
+        </DataTrigger>  
+      </Style.Triggers>  
+    </Style>  
+  </sad: ActivityDesigner.Resources>  
+  <Grid>  
+    <ContentPresenter Style="{DynamicResource ExpandOrCollapsedStyle}" Content="{Binding}"/>  
+  </Grid>  
+</sad: ActivityDesigner>  
+  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CustomActivityDesigners\WorkflowItemsPresenter`  
+  
+## 参照  
+ <xref:System.Activities.Presentation.WorkflowItemsPresenter>   
+ [ワークフロー デザイナーを使用したアプリケーションの開発](../Topic/Developing%20Applications%20with%20the%20Workflow%20Designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity.md b/docs/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity.md
new file mode 100644
index 00000000000..ef67a186ecf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-composite-using-native-activity.md
@@ -0,0 +1,50 @@
+---
+title: "ネイティブ アクティビティを使用したカスタム複合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ef9e739c-8a8a-4d11-9e25-cb42c62e3c76
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# ネイティブ アクティビティを使用したカスタム複合
+このサンプルでは、他の <xref:System.Activities.Activity> オブジェクトをスケジュールしてワークフローの実行のフローを制御する <xref:System.Activities.NativeActivity> を作成する方法を示します。この方法を示すために、このサンプルでは一般的な制御フローである Sequence と While の 2 つを使用します。  
+  
+## サンプルの詳細  
+ `MySequence` から始めるとき、最初に気づくことは、それが <xref:System.Activities.NativeActivity> から派生しているということです。<xref:System.Activities.NativeActivity> は、`Execute` メソッドに渡される <xref:System.Activities.NativeActivityContext> を介して、ワークフロー ランタイム一式を公開する <xref:System.Activities.Activity> オブジェクトです。  
+  
+ `MySequence` は、ワークフローの作成者によって設定された <xref:System.Activities.Activity> オブジェクトのパブリック コレクションを公開します。ワークフローの実行前に、ワークフロー ランタイムがワークフローの各アクティビティに対して <xref:System.Activities.Activity.CacheMetadata%2A> メソッドを呼び出します。このプロセスの実行中に、ランタイムによって、データのスコープや有効期間を管理するための親子のリレーションシップが確立されます。<xref:System.Activities.Activity.CacheMetadata%2A> メソッドの既定の実装では、`MySequence` アクティビティの <xref:System.ComponentModel.TypeDescriptor> インスタンス クラスを使用して、<xref:System.Activities.Activity> 型または <xref:System.Collections.IEnumerable>\<<xref:System.Activities.Activity>\> 型のパブリック プロパティを `MySequence` アクティビティの子として追加します。  
+  
+ アクティビティで子アクティビティのパブリック コレクションを公開するときは、それらの子アクティビティ間で状態を共有すると考えられます。そのため、親アクティビティ \(この場合は `MySequence`\) で、子アクティビティがそれを実現するための変数のコレクションも公開することをお勧めします。子アクティビティと同様に、<xref:System.Activities.Activity.CacheMetadata%2A> メソッドで、<xref:System.Activities.Variable> 型または <xref:System.Collections.IEnumerable>\<<xref:System.Activities.Variable>\> 型のパブリック プロパティを `MySequence` アクティビティに関連付けられた変数として追加します。  
+  
+ `MySequence` の子によって操作されるパブリック変数に加えて、`MySequence` では、子の実行の進行状況を追跡する必要もあります。これを実現するために、プライベート変数 `currentIndex` を使用します。この変数は、`MySequence` アクティビティの <xref:System.Activities.Activity.CacheMetadata%2A> メソッド内に <xref:System.Activities.NativeActivityMetadata.AddImplementationVariable%2A> メソッドの呼び出しを追加することで、`MySequence` 環境の一部として登録されています。`MySequence` `Activities` コレクションに追加された <xref:System.Activities.Activity> オブジェクトは、この方法で追加された変数にアクセスできません。  
+  
+ `MySequence` をランタイムで実行すると、ランタイムがその <xref:System.Activities.NativeActivity.Execute%2A> メソッドを呼び出し、<xref:System.Activities.NativeActivityContext> を渡します。<xref:System.Activities.NativeActivityContext> は、引数と変数の逆参照と、他の <xref:System.Activities.Activity> オブジェクトや `ActivityDelegates` のスケジュールを行うランタイムに返すアクティビティのプロキシです。`MySequence` は、`InternalExecute` メソッドを使用して、最初の子と後続のすべての子を単一のメソッドでスケジュールするロジックをカプセル化します。このメソッドは、まず `currentIndex` を逆参照します。`Activities` コレクションに含まれる数と等しい場合、シーケンスは終了し、アクティビティが処理をスケジュールせずに戻り、ランタイムによって状態が <xref:System.Activities.ActivityInstanceState> に変更されます。`currentIndex` がアクティビティ数より小さい場合、次の子は `Activities` コレクションから取得され、`MySequence` が <xref:System.Activities.NativeActivityContext.ScheduleActivity%2A> を呼び出して、スケジュールされている子と、`InternalExecute` メソッドを指す <xref:System.Activities.CompletionCallback> を渡します。最後に、`currentIndex` がインクリメントされ、制御がランタイムに戻されます。`MySequence` のインスタンスで子 <xref:System.Activities.Activity> オブジェクトがスケジュールされていれば、ランタイムはそのインスタンスの状態が Executing であると見なします。  
+  
+ 子アクティビティが完了すると、<xref:System.Activities.CompletionCallback> が実行され、ループが先頭から継続されます。`Execute` と同様、<xref:System.Activities.CompletionCallback> は <xref:System.Activities.NativeActivityContext> を受け取り、実装側へのアクセスをランタイムに提供します。  
+  
+ `MyWhile` が `MySequence` と異なるのは、1 つの <xref:System.Activities.Activity> オブジェクトを繰り返しスケジュールし、`Condition` という名前の <xref:System.Activities.Activity%601>\<bool\> を使用して、そのスケジュールを実行するかどうかを判断することです。`MySequence` と同様に、`MyWhile` でも、`InternalExecute` メソッドを使用してスケジュール ロジックを集中化しています。`OnEvaluationCompleted` という名前の <xref:System.Activities.CompletionCallback%601>\<bool\> を使用して `Condition`<xref:System.Activities.Activity>\<bool\> をスケジュールします。`Condition` の実行が完了すると、その結果を、この <xref:System.Activities.CompletionCallback> を通じて、`result` という名前の厳密に型指定されたパラメーターで使用できるようになります。`true` の場合、`MyWhile` は <xref:System.Activities.NativeActivityContext.ScheduleActivity%2A> を呼び出し、<xref:System.Activities.CompletionCallback> として `Body`<xref:System.Activities.Activity> オブジェクトと `InternalExecute` を渡します。`Body` の実行が完了すると、`InternalExecute` でもう一度 `Condition` がスケジュールされ、再度ループが開始されます。`Condition` が `false` を返すと、`MyWhile` のインスタンスが `Body` をスケジュールせずに制御をランタイムに戻し、ランタイムによって状態が <xref:System.Activities.ActivityInstanceState> に変更されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で Composite.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\CustomCompositeNativeActivity`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/custom-tracking.md b/docs/framework/windows-workflow-foundation/samples/custom-tracking.md
new file mode 100644
index 00000000000..ced049c9bf7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/custom-tracking.md
@@ -0,0 +1,161 @@
+---
+title: "カスタム追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2d191c9f-62f4-4c63-92dd-cda917fcf254
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# カスタム追跡
+このサンプルでは、カスタムの追跡参加要素を作成し、追跡データをコンソールに出力する方法を示します。また、ユーザー定義データが設定された <xref:System.Activities.Tracking.CustomTrackingRecord> オブジェクトを出力する方法も示します。コンソール ベースの追跡参加要素は、コードで作成された追跡プロファイル オブジェクトを使用して、ワークフローで出力された <xref:System.Activities.Tracking.TrackingRecord> オブジェクトをフィルター処理します。  
+  
+## サンプルの詳細  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] には、ワークフロー インスタンスの実行を追跡できる追跡インフラストラクチャが用意されています。追跡ランタイムは、ワークフロー ライフサイクルに関連するイベント、ワークフロー アクティビティのイベント、およびカスタム追跡イベントを出力するワークフロー インスタンスを実装しています。次の表で、追跡インフラストラクチャの主要コンポーネントの詳細を説明します。  
+  
+|コンポーネント|説明|  
+|-------------|--------|  
+|追跡ランタイム|追跡レコードを出力するためのインフラストラクチャを提供します。|  
+|追跡参加要素|追跡レコードを処理します。[!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] には、追跡レコードを Event Tracing for Windows \(ETW\) イベントとして書き込む追跡参加要素が用意されています。|  
+|追跡プロファイル|ワークフロー インスタンスから出力された追跡レコードのサブセットを追跡参加要素から定期受信するためのフィルター機構。|  
+  
+ 次の表で、ワークフロー ランタイムが出力する追跡レコードの詳細を説明します。  
+  
+|追跡レコード|説明|  
+|------------|--------|  
+|ワークフロー インスタンスの追跡レコード|ワークフロー インスタンスのライフサイクルを表します。たとえば、ワークフローの開始時または完了時にインスタンス レコードが出力されます。|  
+|アクティビティ状態の追跡レコード|アクティビティの実行状況を詳しく記録します。これらのレコードは、アクティビティをスケジュールしたとき、アクティビティが完了したとき、エラーがスローされたときなど、ワークフロー アクティビティの状態を示します。|  
+|ブックマーク再開レコード|ワークフロー インスタンス内のブックマークが再開されたときに出力されます。|  
+|カスタム追跡レコード|ワークフロー作成者はカスタム追跡レコードを作成し、カスタム アクティビティ内で出力できます。|  
+  
+ 追跡参加要素は、追跡プロファイルを使用して、出力された <xref:System.Activities.Tracking.TrackingRecord> オブジェクトのサブセットを定期受信します。追跡プロファイルには、特定の追跡レコード タイプを定期受信するための追跡クエリが含まれています。追跡プロファイルは、コードで指定したり、構成で指定したりすることができます。  
+  
+### カスタムの追跡参加要素  
+ 追跡参加要素 API では、ワークフロー ランタイムが出力する <xref:System.Activities.Tracking.TrackingRecord> オブジェクトを処理するためのカスタム ロジックを含めることが可能なユーザー指定の追跡参加要素を使用して、追跡ランタイムを拡張できます。  
+  
+ 追跡参加要素を書き込むには、ユーザーは <xref:System.Activities.Tracking.TrackingParticipant> を実装する必要があります。具体的には、カスタム参加要素で <xref:System.Activities.Tracking.TrackingParticipant.Track%2A> メソッドを実装する必要があります。このメソッドは、ワークフロー ランタイムによって <xref:System.Activities.Tracking.TrackingRecord> が出力されるときに呼び出されます。  
+  
+```csharp  
+public abstract class TrackingParticipant  
+{  
+    protected TrackingParticipant();  
+  
+    public virtual TrackingProfile TrackingProfile { get; set; }  
+    public abstract void Track(TrackingRecord record, TimeSpan timeout);  
+}  
+  
+```  
+  
+ 完全な追跡参加要素は ConsoleTrackingParticipant.cs ファイルで実装します。次のコード例は、カスタム追跡参加要素の <xref:System.Activities.Tracking.TrackingParticipant.Track%2A> メソッドです。  
+  
+```csharp  
+protected override void Track(TrackingRecord record, TimeSpan timeout)  
+{  
+    ...             
+    WorkflowInstanceRecord workflowInstanceRecord = record as WorkflowInstanceRecord;  
+    if (workflowInstanceRecord != null)  
+    {  
+        Console.WriteLine(String.Format(CultureInfo.InvariantCulture,  
+            " Workflow InstanceID: {0} Workflow instance state: {1}",  
+            record.InstanceId, workflowInstanceRecord.State));  
+    }  
+  
+    ActivityStateRecord activityStateRecord = record as ActivityStateRecord;  
+    if (activityStateRecord != null)  
+    {  
+        IDictionary<String, object> variables = activityStateRecord.Variables;  
+        StringBuilder vars = new StringBuilder();  
+  
+        if (variables.Count > 0)  
+        {  
+            vars.AppendLine("\n\tVariables:");  
+            foreach (KeyValuePair<string, object> variable in variables)  
+            {     
+                vars.AppendLine(String.Format(  
+                    "\t\tName: {0} Value: {1}", variable.Key, variable.Value));  
+            }  
+        }  
+        Console.WriteLine(String.Format(CultureInfo.InvariantCulture,  
+            " :Activity DisplayName: {0} :ActivityInstanceState: {1} {2}",  
+                activityStateRecord.Activity.Name, activityStateRecord.State,  
+            ((variables.Count > 0) ? vars.ToString() : String.Empty)));  
+    }  
+  
+    CustomTrackingRecord customTrackingRecord = record as CustomTrackingRecord;  
+  
+    if ((customTrackingRecord != null) && (customTrackingRecord.Data.Count > 0))  
+    {  
+        ...  
+    }  
+    Console.WriteLine();  
+  
+}  
+  
+```  
+  
+ 次のコード例では、ワークフローの呼び出し元にコンソール参加要素を追加します。  
+  
+```csharp  
+ConsoleTrackingParticipant customTrackingParticipant = new ConsoleTrackingParticipant()  
+{  
+    ...  
+    // The tracking profile is set here, refer to Program.CS  
+...  
+}  
+  
+WorkflowInvoker invoker = new WorkflowInvoker(BuildSampleWorkflow());  
+invoker.Extensions.Add(customTrackingParticipant);  
+  
+```  
+  
+### カスタム追跡レコードの出力  
+ このサンプルでは、カスタム ワークフロー アクティビティから <xref:System.Activities.Tracking.CustomTrackingRecord> オブジェクトを出力する機能も示します。  
+  
+-   <xref:System.Activities.Tracking.CustomTrackingRecord> オブジェクトは、レコードと一緒に出力する必要があるユーザー定義データを使用して作成および設定します。  
+  
+-   <xref:System.Activities.Tracking.CustomTrackingRecord> を出力するには、<xref:System.Activities.ActivityContext> の追跡メソッドを呼び出します。  
+  
+ 次の例では、カスタム アクティビティ内で <xref:System.Activities.Tracking.CustomTrackingRecord> オブジェクトを出力する方法を示します。  
+  
+```csharp  
+// Create the Custom Tracking Record  
+CustomTrackingRecord customRecord = new CustomTrackingRecord("OrderIn")  
+{  
+    Data =   
+    {  
+        {"OrderId", 200},  
+        {"OrderDate", "20 Aug 2001"}  
+    }  
+};  
+  
+// Emit custom tracking record  
+context.Track(customRecord);  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CustomTrackingSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\CustomTracking`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/database-access-activities.md b/docs/framework/windows-workflow-foundation/samples/database-access-activities.md
new file mode 100644
index 00000000000..87c61fd67fb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/database-access-activities.md
@@ -0,0 +1,339 @@
+---
+title: "データベース アクセス アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 174a381e-1343-46a8-a62c-7c2ae2c4f0b2
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# データベース アクセス アクティビティ
+データベース アクセス アクティビティを使用すると、ワークフロー内でデータベースにアクセスできます。データベースにアクセスして情報を取得または変更したり、[ADO.NET](http://go.microsoft.com/fwlink/?LinkId=166081) を使用してデータベースにアクセスしたりできます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、ダウンロード ページに移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\DbActivities`  
+  
+## データベース アクティビティ  
+ 以降では、このサンプルに含まれている一連のアクティビティについて説明します。  
+  
+## DbUpdate  
+ データベースを変更する SQL クエリを実行します \(挿入、更新、削除、およびその他の変更\)。  
+  
+ このクラスは作業を非同期に実行します \(<xref:System.Activities.AsyncCodeActivity> から派生し、その非同期機能を使用します\)。  
+  
+ 接続情報を構成するには、プロバイダーの不変名 \(`ProviderName`\) と接続文字列 \(`ConnectionString`\) を設定するか、アプリケーション構成ファイルの接続文字列構成名 \(`ConfigFileSectionName`\) を使用します。  
+  
+ 実行するクエリは `Sql` プロパティで構成し、パラメーターは `Parameters` コレクションを通じて渡します。  
+  
+ `DbUpdate` の実行が完了すると、影響を受けたレコードの数が `AffectedRecords` プロパティで返されます。  
+  
+```  
+Public class DbUpdate: AsyncCodeActivity  
+{  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ProviderName { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DependsOn("ProviderName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConnectionString { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConfigFileSectionName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConfigName { get; set; }  
+  
+    [DefaultValue(null)]  
+    public CommandType CommandType { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<string> Sql { get; set; }  
+  
+    [DependsOn("Sql")]  
+    [DefaultValue(null)]  
+    public IDictionary<string, Argument> Parameters { get; }  
+  
+    [DependsOn("Parameters")]  
+    public OutArgument<int> AffectedRecords { get; set; }       
+}  
+```  
+  
+|||  
+|-|-|  
+|引数|説明|  
+|ProviderName|ADO.NET プロバイダーの不変名。この引数を設定する場合は、`ConnectionString` も設定する必要があります。|  
+|ConnectionString|データベースに接続するための接続文字列。この引数を設定する場合は、`ProviderName` も設定する必要があります。|  
+|ConfigName|接続情報が格納されている構成ファイル セクションの名前。この引数を設定する場合は、`ProviderName` と `ConnectionString` は必要ありません。|  
+|CommandType|実行する <xref:System.Data.Common.DbCommand> の種類。|  
+|Sql|実行する SQL コマンド。|  
+|Parameters|SQL クエリのパラメーターのコレクション。|  
+|AffectedRecords|最後の操作の影響を受けたレコードの数。|  
+  
+## DbQueryScalar  
+ データベースから 1 つの値を取得するクエリを実行します。  
+  
+ このクラスは作業を非同期に実行します \(<xref:System.Activities.AsyncCodeActivity%601> から派生し、その非同期機能を使用します\)。  
+  
+ 接続情報を構成するには、プロバイダーの不変名 \(`ProviderName`\) と接続文字列 \(`ConnectionString`\) を設定するか、アプリケーション構成ファイルの接続文字列構成名 \(`ConfigFileSectionName`\) を使用します。  
+  
+ 実行するクエリは `Sql` プロパティで構成し、パラメーターは `Parameters` コレクションを通じて渡します。  
+  
+ `DbQueryScalar` の実行が完了すると、スカラーが `Result``out` 引数 \(型は、基本クラス <xref:System.Activities.AsyncCodeActivity%601> で定義されている `TResult`\) で返されます。  
+  
+```  
+public class DbQueryScalar<TResult> : AsyncCodeActivity<TResult>  
+{  
+    // public arguments  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ProviderName { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DependsOn("ProviderName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConnectionString { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConfigFileSectionName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConfigName { get; set; }  
+  
+    [DefaultValue(null)]  
+    public CommandType CommandType { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<string> Sql { get; set; }  
+  
+    [DependsOn("Sql")]  
+    [DefaultValue(null)]  
+    public IDictionary<string, Argument> Parameters { get; }  
+}  
+```  
+  
+|||  
+|-|-|  
+|引数|説明|  
+|ProviderName|ADO.NET プロバイダーの不変名。この引数を設定する場合は、`ConnectionString` も設定する必要があります。|  
+|ConnectionString|データベースに接続するための接続文字列。この引数を設定する場合は、`ProviderName` も設定する必要があります。|  
+|ConfigName|接続情報が格納されている構成ファイル セクションの名前。この引数を設定する場合は、`ProviderName` と `ConnectionString` は必要ありません。|  
+|CommandType|実行する <xref:System.Data.Common.DbCommand> の種類。|  
+|Sql|実行する SQL コマンド。|  
+|Parameters|SQL クエリのパラメーターのコレクション。|  
+|Result|クエリの実行後に取得されたスカラー。この引数は `TResult` 型です。|  
+  
+## DbQuery  
+ オブジェクトのリストを取得するクエリを実行します。クエリの実行後にマッピング関数が実行されます \(<xref:System.Func%601>\<`DbDataReader`, `TResult`\> または <xref:System.Activities.ActivityFunc%601>\<`DbDataReader`, `TResult`\>\)。このマッピング関数は、`DbDataReader` 内のレコードを取得して、返されるオブジェクトにマップします。  
+  
+ 接続情報を構成するには、プロバイダーの不変名 \(`ProviderName`\) と接続文字列 \(`ConnectionString`\) を設定するか、アプリケーション構成ファイルの接続文字列構成名 \(`ConfigFileSectionName`\) を使用します。  
+  
+ 実行するクエリは `Sql` プロパティで構成し、パラメーターは `Parameters` コレクションを通じて渡します。  
+  
+ SQL クエリの結果は、`DbDataReader` を使用して取得されます。`DbDataReader` が反復処理されて、`DbDataReader` の行が `TResult` のインスタンスにマップされます。`DbQuery` のユーザーは、マッピング コードを指定する必要があります。これには、<xref:System.Func%601>\<`DbDataReader`, `TResult`\> を使用する方法と <xref:System.Activities.ActivityFunc%601>\<`DbDataReader`, `TResult`\> を使用する方法の 2 つの方法があります。1 つ目の方法は、マッピングが 1 つのパルスで実行されるので高速ですが、XAML にシリアル化することはできません。2 つ目の方法は、マッピングが複数のパルスで実行されるので時間がかかることがありますが、XAML へのシリアル化や宣言による作成が可能です \(既存のアクティビティをマッピングに参加させることができます\)。  
+  
+```  
+public class DbQuery<TResult> : AsyncCodeActivity<IList<TResult>> where TResult : class  
+{  
+    // public arguments  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ProviderName { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DependsOn("ProviderName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConnectionString { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConfigFileSectionName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConfigName { get; set; }  
+  
+    [DefaultValue(null)]  
+    public CommandType CommandType { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<string> Sql { get; set; }  
+  
+    [DependsOn("Sql")]  
+    [DefaultValue(null)]  
+    public IDictionary<string, Argument> Parameters { get; }  
+  
+    [OverloadGroup("DirectMapping")]  
+    [DefaultValue(null)]  
+    public Func<DbDataReader, TResult> Mapper { get; set; }  
+  
+    [OverloadGroup("MultiplePulseMapping")]  
+    [DefaultValue(null)]  
+    public ActivityFunc<DbDataReader, TResult> MapperFunc { get; set; }  
+}  
+```  
+  
+|||  
+|-|-|  
+|引数|説明|  
+|ProviderName|ADO.NET プロバイダーの不変名。この引数を設定する場合は、`ConnectionString` も設定する必要があります。|  
+|ConnectionString|データベースに接続するための接続文字列。この引数を設定する場合は、`ProviderName` も設定する必要があります。|  
+|ConfigName|接続情報が格納されている構成ファイル セクションの名前。この引数を設定する場合は、`ProviderName` と `ConnectionString` は必要ありません。|  
+|CommandType|実行する <xref:System.Data.Common.DbCommand> の種類。|  
+|Sql|実行する SQL コマンド。|  
+|Parameters|SQL クエリのパラメーターのコレクション。|  
+|Mapper|クエリの実行結果として取得された `DataReader` 内のレコードを取得して、`Result` コレクションに追加される `TResult` 型のオブジェクトのインスタンスを返すマッピング関数 \(<xref:System.Func%601>\<`DbDataReader`, `TResult`\>\)。<br /><br /> この場合、マッピングは 1 つのパルスで実行されますが、デザイナーを使用して宣言で作成することはできません。|  
+|MapperFunc|クエリの実行結果として取得された `DataReader` 内のレコードを取得して、`Result` コレクションに追加される `TResult` 型のオブジェクトのインスタンスを返すマッピング関数 \(<xref:System.Activities.ActivityFunc%601>\<`DbDataReader`, `TResult`\>\)。<br /><br /> この場合、マッピングは複数のパルスで実行されます。この関数は、XAML へのシリアル化や宣言による作成が可能です \(既存のアクティビティをマッピングに参加させることができます\)。|  
+|Result|クエリを実行し、`DataReader` の各レコードに対してマッピング関数を実行した結果として取得されたオブジェクトのリスト。|  
+  
+## DbQueryDataSet  
+ <xref:System.Data.DataSet> を返すクエリを実行します。このクラスは作業を非同期に実行します \(<xref:System.Activities.AsyncCodeActivity>\<`TResult`\> から派生し、その非同期機能を使用します\)。  
+  
+ 接続情報を構成するには、プロバイダーの不変名 \(`ProviderName`\) と接続文字列 \(`ConnectionString`\) を設定するか、アプリケーション構成ファイルの接続文字列構成名 \(`ConfigFileSectionName`\) を使用します。  
+  
+ 実行するクエリは `Sql` プロパティで構成し、パラメーターは `Parameters` コレクションを通じて渡します。  
+  
+ `DbQueryDataSet` の実行が完了すると、`DataSet` が `Result``out` 引数 \(型は、基本クラス <xref:System.Activities.AsyncCodeActivity%601> で定義されている `TResult`\) で返されます。  
+  
+```  
+public class DbQueryDataSet : AsyncCodeActivity<DataSet>  
+{  
+    // public arguments  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ProviderName { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConnectionString")]  
+    [DependsOn("ProviderName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConnectionString { get; set; }  
+  
+    [RequiredArgument]  
+    [OverloadGroup("ConfigFileSectionName")]  
+    [DefaultValue(null)]  
+    public InArgument<string> ConfigName { get; set; }  
+  
+    [DefaultValue(null)]  
+    public CommandType CommandType { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<string> Sql { get; set; }  
+  
+    [DependsOn("Sql")]  
+    [DefaultValue(null)]  
+    public IDictionary<string, Argument> Parameters { get; }  
+}  
+```  
+  
+|||  
+|-|-|  
+|引数|説明|  
+|ProviderName|ADO.NET プロバイダーの不変名。この引数を設定する場合は、`ConnectionString` も設定する必要があります。|  
+|ConnectionString|データベースに接続するための接続文字列。この引数を設定する場合は、`ProviderName` も設定する必要があります。|  
+|ConfigName|接続情報が格納されている構成ファイル セクションの名前。この引数を設定する場合は、`ProviderName` と `ConnectionString` は必要ありません。|  
+|CommandType|実行する <xref:System.Data.Common.DbCommand> の種類。|  
+|Sql|実行する SQL コマンド。|  
+|Parameters|SQL クエリのパラメーターのコレクション。|  
+|Result|クエリの実行後に取得された <xref:System.Data.DataSet>。|  
+  
+## 接続情報の構成  
+ すべての DbActivities は同じ構成パラメーターを共有します。パラメーターを構成するには次の 2 つの方法があります。  
+  
+-   `ConnectionString + InvariantName`: ADO.NET プロバイダーの不変名と接続文字列を設定します。  
+  
+    ```  
+    Activity dbSelectCount = new DbQueryScalar<DateTime>()  
+    {  
+        ProviderName = "System.Data.SqlClient",  
+        ConnectionString = @"Data Source=.\SQLExpress;  
+                             Initial Catalog=DbActivitiesSample;  
+                             Integrated Security=True",  
+        Sql = "SELECT GetDate()"  
+    };  
+    ```  
+  
+-   `ConfigName`: 接続情報を含む構成セクションの名前を設定します。  
+  
+    ```  
+    <connectionStrings>      
+        <add name="DbActivitiesSample"  
+             providerName="System.Data.SqlClient"  
+             connectionString="Data Source=.\SQLExpress;Initial Catalog=DbActivitiesSample;Integrated Security=true"/>  
+      </connectionStrings>  
+    ```  
+  
+-   アクティビティで次のように設定します。  
+  
+    ```  
+    Activity dbSelectCount = new DbQueryScalar<int>()  
+    {                  
+        ConfigName = "DbActivitiesSample",  
+        Sql = "SELECT COUNT(*) FROM Roles"  
+    };  
+    ```  
+  
+## このサンプルの実行  
+  
+### セットアップ手順  
+ このサンプルはデータベースを使用します。設定と読み込みのためのスクリプト \(Setup.cmd\) がサンプルに付属しているので、そのファイルを、コマンド プロンプトを使用して実行してください。  
+  
+ Setup.cmd スクリプトは、CreateDb.sql スクリプト ファイルを呼び出します。このスクリプト ファイルには、次の操作を実行する SQL コマンドが含まれています。  
+  
+-   DbActivitiesSample という名前のデータベースを作成します。  
+  
+-   Roles テーブルを作成します。  
+  
+-   Employees テーブルを作成します。  
+  
+-   3 個のレコードを Roles テーブルに挿入します。  
+  
+-   12 個のレコードを Employees テーブルに挿入します。  
+  
+##### Setup.cmd を実行するには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  DbActivities サンプル フォルダーに移動します。  
+  
+3.  「setup.cmd」と入力し、Enter キーを押します。  
+  
+    > [!NOTE]
+    >  Setup.cmd は、ローカル コンピューターの SqlExpress インスタンスにサンプルをインストールしようとします。他の SQL Server インスタンスにインストールする場合は、その新しいインスタンス名を使用して Setup.cmd を編集します。  
+  
+##### サンプル データベースをアンインストールするには  
+  
+1.  コマンド プロンプトで、サンプル フォルダーから Cleanup.cmd を実行します。  
+  
+##### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  ソリューションをコンパイルするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、サンプルをデバッグなしで実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\DbActivities`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/designer-rehosting.md b/docs/framework/windows-workflow-foundation/samples/designer-rehosting.md
new file mode 100644
index 00000000000..0f5467a3586
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/designer-rehosting.md
@@ -0,0 +1,140 @@
+---
+title: "デザイナーのホスト変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b676ad31-5f64-4d84-9a36-b4d7113a2f4d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# デザイナーのホスト変更
+デザイナーのホスト変更は、カスタム アプリケーション内でワークフロー デザイン キャンバスをホストすることを示す一般的なシナリオです。多くのユーザーにとって、使い慣れたホスト アプリケーションは Visual Studio ですが、アプリケーションでワークフロー デザイナーを表示すると役立つ場合があるシナリオも数多くあります。  
+  
+-   監視アプリケーション \(エンド ユーザーがプロセス、およびプロセスに関するランタイム データ \(現在アクティブな状態、実行時間の集計データ、ワークフローのインスタンスに関するその他の情報など\) を表示できるようにします\)。  
+  
+-   ユーザーが限られたアクティビティ セットを使用してプロセスをカスタマイズできるようにするアプリケーション。  
+  
+ このような種類のアプリケーションをサポートするために、ワークフロー デザイナーが .NET Framework に付属しており、WPF アプリケーション内でホストするか、適切な WPF ホスト コードを使用して WinForms アプリケーション内でホストすることができます。このサンプルでは、次の方法を示します。  
+  
+-   WF デザイナーのホスト変更方法。  
+  
+-   再ホストされたツールボックスおよびプロパティ グリッドの使用方法。  
+  
+## デザイナーのホスト変更  
+ このサンプルでは、次のグリッド レイアウトのような、デザイナーを含む WPF レイアウトを作成する方法を示します \(スペースを考慮してツールボックス コードは省略しています\)。デザイナーおよびプロパティ グリッドを含む罫線の名前に注意してください。  
+  
+```xaml  
+<Grid>  
+    <Grid.ColumnDefinitions>  
+        <ColumnDefinition Width="2*"/>  
+        <ColumnDefinition Width="7*"/>  
+        <ColumnDefinition Width="3*"/>  
+    </Grid.ColumnDefinitions>  
+    <Border Grid.Column="0">  
+        <sapt:ToolboxControl>...</sapt:ToolboxControl>  
+    </Border>  
+    <Border Grid.Column="1" Name="DesignerBorder"/>  
+    <Border Grid.Column="2" Name="PropertyBorder"/>  
+</Grid>  
+  
+```  
+  
+ 次に、このサンプルではデザイナーを作成し、そのプライマリ <xref:System.Activities.Presentation.WorkflowDesigner.View%2A> および <xref:System.Activities.Presentation.WorkflowDesigner.PropertyInspectorView%2A> をユーザー インターフェイスの適切なコンテナーに関連付けます。次の例に示すいくつかのコード行について説明します。<xref:System.Activities.Core.Presentation.DesignerMetadata.Register%2A> 呼び出しは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] に付属しているアクティビティの既定のアクティビティ デザイナーを関連付けるために必要です。<xref:System.Activities.Presentation.WorkflowDesigner.Load%2A> は、編集する WF 項目を渡すために呼び出されます。最後に、<xref:System.Activities.Presentation.WorkflowDesigner.View%2A> \(プライマリ キャンバス\) および <xref:System.Activities.Presentation.WorkflowDesigner.PropertyInspectorView%2A> \(プロパティ グリッド\) がユーザー インターフェイス画面に配置されます。  
+  
+```csharp  
+protected override void OnInitialized(EventArgs e)  
+{  
+   base.OnInitialized(e);  
+   // register metadata  
+   (new DesignerMetadata()).Register();  
+  
+   // create the workflow designer  
+   WorkflowDesigner wd = new WorkflowDesigner();  
+   wd.Load(new Sequence());  
+   DesignerBorder.Child = wd.View;  
+   PropertyBorder.Child = wd.PropertyInspectorView;  
+}  
+  
+```  
+  
+## 再ホストされたツールボックスの使用  
+ このサンプルでは、XAML で宣言によって再ホストされたツールボックス コントロールを使用します。コードで型を <xref:System.Activities.Presentation.Toolbox.ToolboxItemWrapper> コンストラクターに渡すことができることに注意してください。  
+  
+```xaml  
+<!-- Copyright (c) Microsoft Corporation. All rights reserved-->  
+<Window x:Class="Microsoft.Samples.DesignerRehosting.RehostingWfDesigner"  
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+        xmlns:sapt="clr-namespace:System.Activities.Presentation.Toolbox;assembly=System.Activities.Presentation"  
+        xmlns:sys="clr-namespace:System;assembly=mscorlib"  
+        Title="Window1" Height="600" Width="900">  
+    <Window.Resources>  
+        <sys:String x:Key="AssemblyName">System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35</sys:String>  
+    </Window.Resources>  
+    <Grid>  
+        <Grid.ColumnDefinitions>  
+            <ColumnDefinition Width="2*"/>  
+            <ColumnDefinition Width="7*"/>  
+            <ColumnDefinition Width="3*"/>  
+        </Grid.ColumnDefinitions>  
+        <Border Grid.Column="0">  
+            <sapt:ToolboxControl>  
+                <sapt:ToolboxCategory CategoryName="Basic">  
+                    <sapt:ToolboxItemWrapper AssemblyName="{StaticResource AssemblyName}" >  
+                        <sapt:ToolboxItemWrapper.ToolName>  
+                            System.Activities.Statements.Sequence  
+                        </sapt:ToolboxItemWrapper.ToolName>  
+                       </sapt:ToolboxItemWrapper>  
+                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                        <sapt:ToolboxItemWrapper.ToolName>  
+                            System.Activities.Statements.WriteLine  
+                        </sapt:ToolboxItemWrapper.ToolName>  
+  
+                    </sapt:ToolboxItemWrapper>  
+                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                        <sapt:ToolboxItemWrapper.ToolName>  
+                            System.Activities.Statements.If  
+                        </sapt:ToolboxItemWrapper.ToolName>  
+  
+                    </sapt:ToolboxItemWrapper>  
+                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">  
+                        <sapt:ToolboxItemWrapper.ToolName>  
+                            System.Activities.Statements.While  
+                        </sapt:ToolboxItemWrapper.ToolName>  
+  
+                    </sapt:ToolboxItemWrapper>  
+                </sapt:ToolboxCategory>  
+            </sapt:ToolboxControl>  
+        </Border>  
+        <Border Grid.Column="1" Name="DesignerBorder"/>  
+        <Border Grid.Column="2" Name="PropertyBorder"/>  
+    </Grid>  
+</Window>  
+  
+```  
+  
+#### サンプルの使用  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で DesignerRehosting.sln ソリューションを開きます。  
+  
+2.  F5 キーを押してアプリケーションをコンパイルし、実行します。  
+  
+3.  WPF アプリケーションが再ホストされたデザイナーと共に起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\DesignerRehosting\Basic`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/designer.md b/docs/framework/windows-workflow-foundation/samples/designer.md
new file mode 100644
index 00000000000..9e1daccc2a5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/designer.md
@@ -0,0 +1,31 @@
+---
+title: "デザイナー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bf28aae3-ddfb-4a86-b55d-1957f08c4e10
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# デザイナー
+このセクションには、[!INCLUDE[wfd1](../../../../includes/wfd1-md.md)]を使用する方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [デザイナーによって XAML ファイルに追加されるビューステートの削除](../../../../docs/framework/windows-workflow-foundation/samples/removing-the-view-state-the-designer-adds-to-an-xaml-file.md)  
+ <xref:System.Windows.Markup.XamlWriter> から派生し、XAML ファイルからビューステートを削除するクラスを作成する方法を示します。  
+  
+ [モデル アイテム ツリーのプログラミング](../../../../docs/framework/windows-workflow-foundation/samples/programming-model-item-tree.md)  
+ [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] ツリー ビューの宣言型データ バインディングを使用して <xref:System.Activities.Presentation.Model.ModelItem> ツリーを操作する方法を示します。  
+  
+ [プロパティ グリッドの拡張](../../../../docs/framework/windows-workflow-foundation/samples/property-grid-extensibliity.md)  
+ デザイナー内で特定のアクティビティを選択したときに表示されるプロパティ グリッドをカスタマイズする方法を示します。  
+  
+ [ツールボックス サービス](../../../../docs/framework/windows-workflow-foundation/samples/toolbox-service.md)  
+ ワークフローのコンテキストに基づいて [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] ツールボックス アクティビティを更新する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/document-approval-process.md b/docs/framework/windows-workflow-foundation/samples/document-approval-process.md
new file mode 100644
index 00000000000..10742d17680
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/document-approval-process.md
@@ -0,0 +1,156 @@
+---
+title: "ドキュメント承認プロセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9b240937-76a7-45cd-8823-7f82c34d03bd
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# ドキュメント承認プロセス
+このサンプルでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] と [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] のさまざまな機能を一緒に使用して、ドキュメント承認プロセスのシナリオを実装する方法を示します。クライアント アプリケーションでは、承認の必要なドキュメントを送信したり、ドキュメントを承認したりすることができます。クライアント間の通信を促進したり承認プロセスのルールを適用したりするための承認マネージャー アプリケーションも用意されています。この承認プロセスは、複数の種類の承認を実行できるワークフローで、単一承認、定足数承認 \(承認者全体のパーセンテージ\)、および複合承認 \(定足数承認と単一承認のシーケンスから成る承認\) を得るためのアクティビティが用意されています。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Application\DocumentApprovalProcess`  
+  
+## サンプルの詳細  
+ 次の図は、ドキュメント承認プロセスのワークフローを表しています。  
+  
+ ![ドキュメント承認プロセスのワークフロー](../../../../docs/framework/windows-workflow-foundation/samples/media/approvalprocess.jpg "ApprovalProcess")  
+  
+ クライアントから見た場合、承認プロセスは次のように機能します。  
+  
+1.  クライアントが承認プロセス システムに定期受信します。  
+  
+2.  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントが、承認マネージャー アプリケーションによってホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスにその要求を送信します。  
+  
+3.  一意のユーザー ID がクライアントに返されます。これで、クライアントが承認プロセスに参加できるようになります。  
+  
+4.  プロセスに参加したクライアントは、単一、定足数、または複合の承認プロセスを使用して、承認の必要なドキュメントを送信できます。  
+  
+5.  クライアントのインターフェイスにあるボタンをクリックすると、クライアントのワークフロー サービス ホストでワークフロー インスタンスが開始されます。  
+  
+6.  ワークフローが承認マネージャー アプリケーションに承認要求を送信します。  
+  
+7.  ワークフロー マネージャーの側でも、承認プロセスを表すワークフローが開始されます。  
+  
+8.  マネージャーの承認ワークフローが実行されると、結果がクライアントに返されます。  
+  
+9. 結果がクライアントに表示されます。  
+  
+10. クライアントは、いつでも承認要求を受信してその要求に応答できます。  
+  
+11. クライアントでホストされている [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが、承認マネージャー アプリケーションからの承認要求を受信します。  
+  
+12. ドキュメントの情報がレビューのためにクライアントに表示されます。  
+  
+13. ユーザーは、そのドキュメントを承認することも却下することもできます。  
+  
+14. 承認応答は、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] クライアントを使用して承認マネージャー アプリケーションに返されます。  
+  
+ 承認マネージャー アプリケーションから見た場合、承認プロセスは次のように機能します。  
+  
+1.  クライアントが承認プロセス システムへの参加を要求します。  
+  
+2.  承認マネージャーの [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスが承認プロセス システムへの参加要求を受信します。  
+  
+3.  クライアントに対して一意の ID が生成され、ユーザー情報がデータベースに格納されます。  
+  
+4.  一意の ID がユーザーに返されます。  
+  
+5.  承認要求が受信されます。承認マネージャーが承認プロセスを実行します。  
+  
+6.  承認要求が承認マネージャーによって受信されると、新しいワークフローが開始されます。  
+  
+7.  要求の種類 \(単一、定足数、または複合\) に応じて異なるアクティビティが実行されます。  
+  
+8.  相関関係を持つ Send アクティビティと Receive アクティビティを使用して、承認要求がレビューのためにクライアントに送信され、応答が受信されます。  
+  
+9. 承認プロセス ワークフローの結果がクライアントに送信されます。  
+  
+## サンプルの使用  
+  
+##### データベースを設定するには  
+  
+1.  管理特権で開いた [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトから、この DocumentApprovalProcess フォルダーを開いて、Setup.cmd を実行します。  
+  
+##### アプリケーションを設定するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、DocumentApprovalProcess.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、承認マネージャー アプリケーションを起動します。**\[ソリューション エクスプローラー\]** で \[ApprovalManager\] プロジェクトを右クリックし、**\[デバッグ\]** をポイントして、**\[新しいインスタンスを開始\]** をクリックします。  
+  
+     準備完了のメッセージが表示されるまで待ちます。  
+  
+##### 単一承認のシナリオを実行するには  
+  
+1.  管理者のアクセス許可を使用してコマンド プロンプトを開きます。  
+  
+2.  ソリューションが含まれているディレクトリに移動します。  
+  
+3.  ApprovalClient\\Bin\\Debug フォルダーに移動して、ApprovalClient.exe のインスタンスを 2 つ実行します。  
+  
+4.  **\[discover\]** をクリックして、**\[subscribe\]** ボタンが有効になるまで待ちます。  
+  
+5.  ユーザー名を入力し、**\[subscribe\]** をクリックします。一方のクライアントに対しては "`UserType1`" を使用し、もう一方のクライアントに対しては "`UserType2`" を使用します。  
+  
+6.  `UserType1` クライアントで、ドロップ ダウン メニューから単一承認を選択し、ドキュメントの名前と内容を入力します。**\[Request Approval\]** をクリックします。  
+  
+7.  `UserType2` クライアントに承認待ちのドキュメントが表示されます。そのドキュメントを選択し、**\[approve\]** または **\[reject\]** をクリックします。`UserType1` クライアントに結果が表示されます。  
+  
+##### 定足数承認のシナリオを実行するには  
+  
+1.  管理者のアクセス許可を使用してコマンド プロンプトを開きます。  
+  
+2.  ソリューションが含まれているディレクトリに移動します。  
+  
+3.  ApprovalClient\\Bin\\Debug フォルダーに移動して、ApprovalClient.exe のインスタンスを 3 つ実行します。  
+  
+4.  **\[discover\]** をクリックして、**\[subscribe\]** ボタンが有効になるまで待ちます。  
+  
+5.  ユーザー名を入力し、**\[subscribe\]** をクリックします。1 つのクライアントに対しては "`UserType1`" を使用し、残りの 2 つのクライアントに対しては "`UserType2`" を使用します。  
+  
+6.  `UserType1` クライアントで、ドロップ ダウン メニューから定足数承認を選択し、ドキュメントの名前と内容を入力します。**\[Request Approval\]** をクリックします。これにより、2 つの `UserType2` クライアントが、ドキュメントを承認または却下するように要求されます。両方の `UserType2` クライアントが応答する必要がありますが、いずれか一方のクライアントが承認すればドキュメントは承認されます。  
+  
+7.  2 つの `UserType2` クライアントに承認待ちのドキュメントが表示されます。そのドキュメントを選択し、**\[approve\]** または **\[reject\]** をクリックします。`UserType1` クライアントに結果が表示されます。  
+  
+##### 複合承認のシナリオを実行するには  
+  
+1.  管理者のアクセス許可を使用してコマンド プロンプトを開きます。  
+  
+2.  ソリューションが含まれているディレクトリに移動します。  
+  
+3.  ApprovalClient\\Bin\\Debug フォルダーに移動して、ApprovalClient.exe のインスタンスを 4 つ実行します。  
+  
+4.  **\[discover\]** をクリックして、**\[subscribe\]** ボタンが有効になるまで待ちます。  
+  
+5.  ユーザー名を入力し、**\[subscribe\]** をクリックします。1 つのクライアントに対して "`UserType1`" を、2 つのクライアントに対して "`UserType2`" を、最後のクライアントに対して "`UserType3`" を使用します。  
+  
+6.  `UserType1` クライアントで、ドロップ ダウン メニューから単一承認を選択し、ドキュメントの名前と内容を入力します。**\[Request Approval\]** をクリックします。  
+  
+7.  2 つの `UserType2` クライアントに承認待ちのドキュメントが表示されます。そのドキュメントを選択し、**\[approve\]** をクリックします。ドキュメントが `UserType3` クライアントに渡されます。  
+  
+     ドキュメントは、最初の `UserType2` クライアントの定足数によって承認されると `UserType3` クライアントに渡されます。  
+  
+8.  `UserType3` クライアントでドキュメントを承認または却下します。`UserType1` クライアントに結果が表示されます。  
+  
+##### クリーンアップするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトで、DocumentApprovalProcess フォルダーに移動して Cleanup.cmd を実行します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/durable-delay-in-xamlx.md b/docs/framework/windows-workflow-foundation/samples/durable-delay-in-xamlx.md
new file mode 100644
index 00000000000..ed330b0b5db
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/durable-delay-in-xamlx.md
@@ -0,0 +1,73 @@
+---
+title: "XAMLX における永続的な遅延 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: efc38df4-2d34-453c-8e59-2c21d1307354
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# XAMLX における永続的な遅延
+このサンプルでは、永続的な遅延を使用する方法を示します。これは、遅延の間、ワークフローを永続的なデバイスに永続化する遅延のことです。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\DurableDelayXamlx`  
+  
+## 説明  
+ このサンプル ワークフローには、遅延によって分割された 2 つのローカル ファイルへのメッセージが含まれています。遅延が発生すると、ワークフローがアンロードされ、ワークフローはメモリに再読み込みされるまでワークフロー インスタンス ストアで 5 秒間待機します。  
+  
+ この .xamlx ファイルは、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] でホストされているワークフロー サービスです。[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] は、ワークフロー サービス ホストを使用する Cassini を使用して、ワークフローをホストします。  
+  
+ ワークフロー サービス ホストは、ワークフローをホストするだけでなく、読み込みとアンロードを行うことによってワークフロー インスタンスを管理します。ワークフロー サービス ホストで [!INCLUDE[wf](../../../../includes/wf-md.md)] 定義のインスタンスを開始するには、ワークフローの <xref:System.ServiceModel.Activities.Receive> アクティビティにメッセージを送信するクライアントを設定します。この <xref:System.ServiceModel.Activities.Receive> は、<xref:System.ServiceModel.Activities.Receive.CanCreateInstance%2A> プロパティが `true` に設定されているため、メッセージを受信した後にワークフローの新しいインスタンスを作成できます。  
+  
+ 初期化中に、ワークフロー サービス ホストに対してインスタンスを永続化ストア \(データベース\) にアンロードするように指定する、インスタンスのアンロード動作が構成ファイルに追加されます。このサンプルでは、\(遅延が発生して\) ワークフローがアイドル状態になった直後にインスタンスがアンロードされます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+2.  DurableDelayXamlx\\CS フォルダーに移動します。  
+  
+3.  Setup.cmd を実行します。  
+  
+4.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を管理者として実行します。  
+  
+5.  DurableDelayXamlx.sln ソリューション ファイルを開きます。  
+  
+6.  **ソリューション エクスプローラー**で、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+7.  **\[マルチ スタートアップ プロジェクト\]** を選択し、両方のプロジェクトを **\[開始\]** に設定します。  
+  
+8.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+9. ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+#### このサンプルをアンインストールするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+2.  DurableDelayXamlx\\CS フォルダーに移動します。  
+  
+3.  Cleanup.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\DurableDelayXamlX`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/durable-delay.md b/docs/framework/windows-workflow-foundation/samples/durable-delay.md
new file mode 100644
index 00000000000..f229f6f94d0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/durable-delay.md
@@ -0,0 +1,79 @@
+---
+title: "永続的な遅延 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 220ec240-b958-430c-81ff-b734a6aa97ae
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 永続的な遅延
+このサンプルでは、永続的な遅延を使用する方法を示します。これは、遅延の間、ワークフローを永続的なデバイスに永続化する遅延のことです。このサンプル ワークフローには、遅延によって分割された 2 つのコンソールへのメッセージが含まれています。遅延が発生すると、ワークフローがアンロードされ、ワークフローはメモリに再読み込みされるまでワークフロー インスタンス ストアで 5 秒間待機します。  
+  
+## ワークフローの詳細  
+ ワークフロー サービス ホストは、ワークフローをホストし、読み込みとアンロードを行うことによってワークフロー インスタンスを管理します。ワークフロー定義のインスタンスを開始するために、このサンプルでは、ワークフローの <xref:System.ServiceModel.Activities.Receive> アクティビティにメッセージを送信するプロキシを設定します。<xref:System.ServiceModel.Activities.Receive.CanCreateInstance%2A> プロパティを `true` に設定し、このプロパティがメッセージを受信したらワークフローの新しいインスタンスを作成できるようにします。  
+  
+ 初期化時のワークフロー サービス ホストによる設定の詳細を次に示します。  
+  
+1.  アドレス \(http:\/\/localhost:8080\/Client\) を持つサービス ホストを作成します。  
+  
+2.  ワークフロー内で <xref:System.ServiceModel.Activities.Receive> アクティビティとの通信を可能にする、サービス ホストのエンドポイントを作成します。  
+  
+3.  SQL インスタンス ストアを設定します。  
+  
+4.  ワークフロー サービス ホストがワークフロー インスタンスを SQL 永続化ストアにアンロードする条件を指定する、インスタンスのアンロード動作を追加します。このサンプルでは、\(遅延が発生して\) ワークフローがアイドル状態になった直後にインスタンスがアンロードされます。  
+  
+5.  ワークフローの <xref:System.ServiceModel.Activities.Receive> アクティビティにメッセージを送信するプロキシを作成します。  
+  
+#### このサンプルを使用するには  
+  
+1.  永続性データベースを設定します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+    2.  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ディレクトリ \(C:\\Windows\\Microsoft.NET\\Framework\\v4.X\\\) に移動します。  
+  
+    3.  WorkflowManagementService.exe.config ファイルを編集し、\<`database`\> 要素内に次の接続文字列を追加します。  
+  
+        ```  
+        <database connectionString="Data Source=localhost\SQLEXPRESS;Initial Catalog=DefaultSampleStore;Integrated Security=True;Asynchronous Processing=True" />  
+  
+        ```  
+  
+    4.  DurableDelay\\CS ディレクトリに移動します。  
+  
+    5.  Setup.cmd を実行します。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] アイコンを右クリックして **\[管理者として実行\]** をクリックし、昇格されたアクセス許可を使用して [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を実行します。  
+  
+3.  Delay.sln ソリューション ファイルを開きます。  
+  
+4.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+5.  Ctrl キーを押しながら F5 キーを押してソリューションを実行します。  
+  
+#### このサンプルをアンインストールするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+2.  DurableDelay\\CS ディレクトリに移動します。  
+  
+3.  Cleanup.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\DurableDelay`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/durable-duplex.md b/docs/framework/windows-workflow-foundation/samples/durable-duplex.md
new file mode 100644
index 00000000000..27854972c0e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/durable-duplex.md
@@ -0,0 +1,195 @@
+---
+title: "永続的な二重 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e76d1a1-f3d8-4a0f-8746-4a322cdff6eb
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 永続的な二重
+このサンプルでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] のメッセージング アクティビティを使用して、永続的な双方向メッセージ交換を設定および構成する方法を示します。永続的な双方向メッセージ交換は、長期間行われる双方向メッセージ交換です。メッセージ交換の有効期間は、通信チャネルの有効期間およびサービス インスタンスのメモリ内有効期間よりも長い場合があります。  
+  
+## サンプルの詳細  
+ このサンプルでは、[!INCLUDE[wf2](../../../../includes/wf2-md.md)] を使用して実装された 2 つの [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスで、永続的な双方向メッセージ交換を構成します。永続的な双方向メッセージ交換は、MSMQ を介して送信されて [.NET コンテキスト交換](http://go.microsoft.com/fwlink/?LinkID=166059)を使用して関連付けられる 2 つの一方向メッセージで構成されます。これらのメッセージは、<xref:System.ServiceModel.Activities.Send> メッセージング アクティビティと <xref:System.ServiceModel.Activities.Receive> メッセージング アクティビティを使用して送信されます。.NET コンテキスト交換は、送信メッセージに対してコールバック アドレスを指定するために使用します。どちらのサービスも Windows プロセス アクティブ化サービス \(WAS\) を使用してホストされ、サービス インスタンスの永続化を有効にするように構成されます。  
+  
+ 1 つ目のサービス \(Service1.xamlx\) は、処理を実行する送信サービス \(Service2.xamlx\) に要求を送信します。処理が完了したら、Service2.xamlx は、処理が完了したことを示す通知を Service1.xamlx に送り返します。ワークフロー コンソール アプリケーションによって、サービスがリッスンするキューが設定され、Service1.xamlx をアクティブ化するために最初の開始メッセージが送信されます。Service1.xamlx は、要求した処理が完了したことを示す通知を Service2.xamlx から受け取ったら、結果を XML ファイルに保存します。コールバック メッセージを待機している間、Service1.xamlx は既定の <xref:System.ServiceModel.Activities.Description.WorkflowIdleBehavior> を使用してインスタンスの状態を永続化します。Service2.xamlx は、Service1.xamlx によって要求された処理を完了する一環としてインスタンスの状態を永続化します。  
+  
+ MSMQ を介して .NET コンテキスト交換を使用するようにサービスを構成するために、<xref:System.ServiceModel.Channels.ContextBindingElement> と <xref:System.ServiceModel.Channels.MsmqTransportBindingElement> から成るカスタム バインディングを使用するように両方のサービスが構成されます。<xref:System.ServiceModel.Channels.ContextBindingElement> ではコールバック アドレスが指定され、カスタム バインディングを使用して送信されるすべてのメッセージのコールバック コンテキスト ヘッダーに含まれます。カスタム バインディングを定義するコード例を次に示します。  
+  
+```xml  
+<configuration>  
+     <system.serviceModel>  
+          …  
+          <bindings>  
+               <customBinding>  
+                    <binding name="netMsmqContextBinding">  
+                         <context clientCallbackAddress="net.msmq://localhost/private/DurableDuplex/Service1.xamlx"/>  
+                         <msmqTransport exactlyOnce="False">  
+                              <msmqTransportSecurity msmqAuthenticationMode="None" msmqProtectionLevel="None"/>  
+                         </msmqTransport>  
+                    </binding>  
+               </customBinding>  
+          </bindings>  
+          …  
+     </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+> [!NOTE]
+>  このサンプルで使用するバインディングはセキュリティで保護されていません。アプリケーションを配置するときに、アプリケーションのセキュリティ要件に基づいてバインディングを構成する必要があります。  
+  
+> [!NOTE]
+>  このサンプルで使用するキューはトランザクション キューではありません。トランザクション キューを使用して [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] メッセージ交換を設定する方法を示したサンプルについては、「[MSMQ アクティベーション](../../../../docs/framework/wcf/samples/msmq-activation.md)」のサンプルを参照してください。  
+  
+ Service1.xamlx によって Service2.xamlx に送信されるメッセージは、Service2.xamlx のアドレスと前に定義したカスタム バインディングを使用して構成されるクライアント エンドポイントを使用して送信されます。Service2.xamlx から Service1.xamlx へのコールバックは、アドレスが明示的に構成されていないクライアント エンドポイントを使用して送信されます。アドレスは、Service1.xamlx によって送信されるコールバック コンテキストから取得されます。クライアント エンドポイントを定義するコード例を次に示します。  
+  
+```xml  
+<?xml version="1.0"?>  
+<configuration>  
+     <system.serviceModel>  
+          …  
+          <client>  
+               <endpoint address="net.msmq://localhost/private/DurableDuplex/Service2.xamlx" binding="customBinding" bindingConfiguration="netMsmqContextBinding" contract="IDoWork"/>  
+               <endpoint binding="customBinding" bindingConfiguration="netMsmqContextBinding" contract="INotify"/>  
+          </client>  
+          …  
+     </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ このカスタム バインディングを使用するように net.msmq ベース アドレスの既定のプロトコル マッピングを変更することで、このカスタム バインディングを使用するエンドポイントを公開するコード例を次に示します。  
+  
+```  
+<configuration>  
+     <system.serviceModel>  
+          <protocolMapping>  
+               <add scheme="net.msmq" binding="customBinding" bindingConfiguration="netMsmqContextBinding"/>  
+          </protocolMapping>  
+          …  
+     </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+ <xref:System.ServiceModel.Activities.Description.SqlWorkflowInstanceStoreBehavior> の動作を両方のサービスに追加して永続性データベースの接続文字列を指定することで、両方のサービスの永続化を有効にするコード例を次に示します。  
+  
+```xml  
+<?xml version="1.0"?>  
+<configuration>  
+    <system.serviceModel>  
+          …  
+          <behaviors>  
+               <serviceBehaviors>  
+                    <behavior>  
+                         <serviceDebug includeExceptionDetailInFaults="True"/>  
+                         <serviceMetadata httpGetEnabled="True"/>  
+                         <sqlWorkflowInstanceStore connectionString="Data Source=.\SQLEXPRESS;Initial Catalog=DefaultSampleStore;Integrated Security=True"/>  
+                    </behavior>  
+               </serviceBehaviors>  
+          </behaviors>  
+     </system.serviceModel>  
+</configuration>  
+  
+```  
+  
+## システム要件  
+ このサンプルには、次のコンポーネントが必要です。  
+  
+1.  インターネット インフォメーション サービス。  
+  
+2.  \[Internet Information Services\] \-\> \[IIS 6 と互換性のある管理\] \-\> \[IIS メタベースおよび IIS 6 構成との互換性\]。  
+  
+3.  \[World Wide Web サービス\] \-\> \[アプリケーション開発機能\] \-\> \[ASP.NET\]。  
+  
+4.  Microsoft メッセージ キュー \(MSMQ\) サーバー。  
+  
+#### このサンプルを使用するには  
+  
+1.  永続性データベースと結果ディレクトリを設定します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+    2.  このサンプルのフォルダーに移動して Setup.cmd を実行します。  
+  
+2.  仮想アプリケーションを設定します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトから次のコマンドを実行し、ASP.NET を登録します。  
+  
+        ```  
+        aspnet_regiis -i  
+        ```  
+  
+    2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を右クリックして **\[管理者として実行\]** をクリックし、管理者のアクセス許可で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を実行します。  
+  
+    3.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、DurableDuplex.sln ファイルを開きます。  
+  
+3.  サービス キューを設定します。  
+  
+    1.  DurableDuplex クライアントを実行するために、F5 キーを押します。  
+  
+    2.  コマンド プロンプトから `Compmgmt.msc` を実行して、**\[コンピューターの管理\]** コンソールを開きます。  
+  
+    3.  **\[サービスとアプリケーション\]**、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+    4.  durableduplex\/service1.xamlx キューと durableduplex\/service2.xamlx キューを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    5.  **\[セキュリティ\]** タブをクリックし、両方のキューで Everyone グループに対して **\[メッセージの受信\]**、**\[メッセージのピーク\]**、および **\[メッセージの送信\]** アクセス許可を与えます。  
+  
+    6.  インターネット インフォメーション サービス \(IIS\) マネージャーを開きます。  
+  
+    7.  **\[サーバー\]**、**\[サイト\]**、**\[既定の Web サイト\]**、**\[private\]**、**\[永続的な二重\]** の順に参照し、**\[詳細オプション\]** をクリックします。  
+  
+    8.  **\[有効なプロトコル\]** を **http,net.msmq** に変更します。  
+  
+4.  サンプルを実行します。  
+  
+    1.  http:\/\/localhost\/private\/durableduplex\/service1.xamlx および http:\/\/localhost\/private\/durableduplex\/service2.xamlx を参照し、両方のサービスが実行されていることを確認します。  
+  
+    2.  F5 キーを押して DurableDuplexClient を実行します。  
+  
+         永続的な双方向メッセージ交換が完了したら、メッセージ交換の結果を示す result.xml ファイルが C:\\Inbox フォルダーに保存されます。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  Cleanup.cmd を実行します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+    2.  このサンプルのフォルダーに移動して Cleanup.cmd を実行します。  
+  
+2.  サービスの仮想アプリケーションを削除します。  
+  
+    1.  コマンド プロンプトから `Inetmgr.exe` を実行して、インターネット インフォメーション サービス \(IIS\) マネージャーを開きます。  
+  
+    2.  既定の Web サイトを参照して、**private** 仮想ディレクトリを削除します。  
+  
+3.  このサンプルに対して設定されているキューを削除します。  
+  
+    1.  コマンド プロンプトから `Compmgmt.msc` を実行して、\[コンピューターの管理\] コンソールを開きます。  
+  
+    2.  **\[サービスとアプリケーション\]**、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+    3.  durableduplex\/service1.xamlx キューと durableduplex\/service2.xamlx キューを削除します。  
+  
+4.  C:\\Inbox ディレクトリを削除します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\DurableDuplex`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/dynamic-arguments.md b/docs/framework/windows-workflow-foundation/samples/dynamic-arguments.md
new file mode 100644
index 00000000000..175a9c6d855
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/dynamic-arguments.md
@@ -0,0 +1,53 @@
+---
+title: "動的引数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 122ad479-d306-4602-a943-5aefe711329d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 動的引数
+このサンプルでは、アクティビティの作成者ではなくアクティビティのコンシューマーによって引数が定義されるアクティビティの実装方法を示します。ここではそのために、ランタイムによるアクティビティのメタデータの構築方法をオーバーライドします。  
+  
+## サンプルの詳細  
+ ランタイムは、実行前にアクティビティの記述を構築します。これは、アクティビティ型のパブリック メンバーを調べて、引数、変数、子アクティビティ、およびアクティビティ デリゲートをアクティビティのメタデータの一部として自動的に宣言することによって行われます。これにより、ワークフローが正しく構築されるようにすると同時に、ランタイム リレーションシップおよび有効期間ルールを管理します。通常は、アクティビティの作成者が、<xref:System.Activities.Argument> から派生するパブリック メンバーをアクティビティ型で指定することによってアクティビティの引数を定義します。ランタイムにより、<xref:System.Activities.Argument> から派生する各パブリック メンバーに対して <xref:System.Activities.RuntimeArgument> が作成され、そのメンバーに対してユーザーが指定した引数にバインドされます。しかし、アクティビティのコンシューマーが指定する構成によって引数のセットが決まる場合もあります。アクティビティの作成者がアクティビティのメタデータ \(アクティビティに関連付けられる引数のセットを含む\) の構築方法をカスタマイズするには、<xref:System.Activities.Activity.CacheMetadata%2A> をオーバーライドします。  
+  
+ このサンプルでは、メソッドを呼び出すアクティビティの引数リストを動的に構築する方法を示します。アクティビティのコンシューマーが、型および呼び出すメソッドの名前を、そのメソッドに渡す引数のコレクションと共に指定します。  
+  
+> [!NOTE]
+>  このサンプルの目的は、<xref:System.Activities.CodeActivity.CacheMetadata%2A> をオーバーライドする方法と、<xref:System.Activities.RuntimeArgument> を使用する方法を示すことです。このアクティビティで呼び出すことのできるメソッドの種類に関しては、いくつかの注意事項があります。たとえば、ジェネリックやパラメーター配列は使用できません。.NET Framework に含まれている <xref:System.Activities.Statements.InvokeMethod> アクティビティにはこのような制限はありません。  
+  
+ <xref:System.Activities.CodeActivity.CacheMetadata%2A> をオーバーライドする `MethodInvoke` アクティビティは、まず最初に、メソッド呼び出しの結果を処理するための <xref:System.Activities.RuntimeArgument> を作成し、`Result` という名前のパブリックに設定可能な <xref:System.Activities.OutArgument> にバインドします。`MethodInvoke.Result` が `null` の場合は、その型の既定の式で構成された <xref:System.Activities.OutArgument> が自動的に設定されるため、引数のプロパティが `null` かどうかをアクティビティの作成者が確認する必要はありません。  
+  
+ 次に、<xref:System.Activities.CodeActivity.CacheMetadata%2A> のオーバーライドにより、ユーザーによって指定された `MethodName` および `TargetType` から、呼び出しに使用する `MethodInfo` が特定されます。`DetermineMethodInfo` メソッドは、<xref:System.Activities.CodeActivity.CacheMetadata%2A> のオーバーライドに渡された <xref:System.Activities.CodeActivityMetadata> パラメーターを受け取るため、構成エラーがあった場合には検証エラーとして報告できます。これは、`metadata.AddValidationError` を呼び出すことによって行われます。  
+  
+ `MethodInfo` が設定されると、`MethodInfo` のパラメーターが反復処理されて、各パラメーターに対して <xref:System.Activities.RuntimeArgument> が作成され、`Parameters` プロパティのユーザーが指定したコレクションの対応する引数にバインドされます。最後に、`metadata.SetArgumentsCollection` が呼び出されて、<xref:System.Activities.RuntimeArgument> のコレクションがアクティビティに関連付けられます。  
+  
+ 引数の解決には、`resultArgument` の場合のように <xref:System.Activities.RuntimeArgument> を使用することも、`Parameters` コレクションの場合のようにユーザーが指定した引数を使用することもできます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、DynamicArguments.sln ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\DynamicArguments`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/dynamicactivity-creation.md b/docs/framework/windows-workflow-foundation/samples/dynamicactivity-creation.md
new file mode 100644
index 00000000000..38c2ac58bb8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/dynamicactivity-creation.md
@@ -0,0 +1,158 @@
+---
+title: "DynamicActivity の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d8ebe82f-98c8-4452-aed7-2c60a512b097
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# DynamicActivity の作成
+このサンプルでは、<xref:System.Activities.DynamicActivity> アクティビティを使用して実行時にアクティビティを作成する 2 つの異なる方法を示します。  
+  
+ このサンプルでは、<xref:System.Activities.Statements.ForEach%601> アクティビティと <xref:System.Activities.Statements.Assign%601> アクティビティを含む <xref:System.Activities.Statements.Sequence> アクティビティが本体に含まれたアクティビティを実行時に作成します。整数の入力リストがこのアクティビティに渡され、プロパティとして設定されます。次に、<xref:System.Activities.Statements.ForEach%601> アクティビティは値のリストを反復処理し、累計します。<xref:System.Activities.Statements.Assign%601> アクティビティでは、累計値をリスト内の要素数で除算して平均値を計算し、その値を平均に代入します。  
+  
+ このサンプルでは、入力引数として変数に設定され、出力引数として戻り値に設定される <xref:System.Activities.DynamicActivity> アクティビティを使用します。このアクティビティには、整数のリストである `Numbers` という名前の 1 つの入力引数があります。<xref:System.Activities.Statements.ForEach%601> アクティビティは値のリストを反復処理し、累計します。<xref:System.Activities.Statements.Assign%601> アクティビティでは、累計値をリスト内の要素数で除算して平均値を計算し、その値を平均に代入します。平均は、`Average` という名前の出力引数として返されます。  
+  
+ 動的アクティビティをプログラムで作成する場合は、次のコード例に示すように入力と出力を宣言します。  
+  
+```csharp  
+DynamicActivity act = new DynamicActivity()  
+{  
+    DisplayName = "Find average",  
+    Properties =   
+    {  
+        // Input argument  
+        new DynamicActivityProperty  
+        {  
+            Name = "Numbers",  
+            Type = typeof(InArgument<List<int>>),  
+            Value = numbers  
+        },  
+        // Output argument  
+        new DynamicActivityProperty  
+        {  
+            Name = "Average",  
+            Type = typeof(OutArgument<double>),  
+            Value = average  
+        }  
+    },  
+};  
+  
+```  
+  
+ リスト内の値の平均を計算する `DynamicActivity` の完全な定義を次のコード例に示します。  
+  
+```  
+DynamicActivity act = new DynamicActivity()  
+{  
+    DisplayName = "Find average",  
+    Properties =   
+    {  
+        // Input argument  
+        new DynamicActivityProperty  
+        {  
+            Name = "Numbers",  
+            Type = typeof(InArgument<List<int>>),  
+            Value = numbers  
+        },  
+        // Output argument  
+        new DynamicActivityProperty  
+        {  
+            Name = "Average",  
+            Type = typeof(OutArgument<double>),  
+            Value = average  
+        }  
+    },  
+    Implementation = () =>  
+        new Sequence  
+        {  
+            Variables = { result, accumulator },  
+            Activities =  
+            {  
+                new ForEach<int>  
+                {  
+                    Values =  new ArgumentValue<IEnumerable<int>> { ArgumentName = "Numbers" },                                  
+                    Body = new ActivityAction<int>  
+                    {  
+                        Argument = iterationVariable,  
+                        Handler = new Assign<int>  
+                        {  
+                            To = accumulator,  
+                            Value = new InArgument<int>(env => iterationVariable.Get(env) +  accumulator.Get(env))  
+                        }  
+                    }  
+                },  
+  
+                // Calculate the average and assign to the output argument.  
+                new Assign<double>  
+                {  
+                    To = new ArgumentReference<double> { ArgumentName = "Average" },  
+                    Value = new InArgument<double>(env => accumulator.Get(env) / numbers.Get(env).Count<int>())  
+                },  
+            }  
+        }  
+};  
+```  
+  
+ XAML で作成する場合は、次の例に示すように入力と出力を宣言します。  
+  
+```  
+<Activity x:Class="Microsoft.Samples.DynamicActivityCreation.FindAverage"  
+          xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"  
+          xmlns:scg="clr-namespace:System.Collections.Generic;assembly=mscorlib"  
+          xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <x:Members>  
+    <x:Property Name="Numbers" Type="InArgument(scg:List(x:Int32))" />  
+    <x:Property Name="Average" Type="OutArgument(x:Double)" />  
+  </x:Members>  
+    ...  
+    ...  
+</Activity>  
+```  
+  
+ XAML は、[!INCLUDE[wfd1](../../../../includes/wfd1-md.md)] を使用して視覚的に作成できます。Visual Studio プロジェクトに含まれている場合は、"ビルド アクション" を "なし" に設定して、コンパイルされないようにしてください。その後、XAML は、次の呼び出しを使用して動的に読み込むことができます。  
+  
+```  
+Activity act2 = ActivityXamlServices.Load(@"FindAverage.xaml");  
+  
+```  
+  
+ プログラムによって、または XAML ワークフローを読み込むことによって作成された <xref:System.Activities.DynamicActivity> インスタンスは、次のコード例に示すように使用できます。`WorkflowInvoker.Invoke` に渡される "act" は、最初のコード例で定義されている "act" <xref:System.Activities.Activity> であることに注意してください。  
+  
+```  
+IDictionary<string, object> results = WorkflowInvoker.Invoke(act, new Dictionary<string, object> { { "Numbers", numbers } });  
+  
+Console.WriteLine("The average calculated using the code activity is = " + results["Average"]);  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、DynamicActivityCreation.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+## コマンド ライン引数  
+ このサンプルでは、コマンド ライン引数を受け取ります。ユーザーは、アクティビティで平均を計算する対象となる数値のリストを指定できます。使用する数値のリストは、スペースで区切られた数値のリストとして渡します。たとえば、5、10、および 32 の平均を計算するには、次のコマンド ラインを使用してこのサンプルを呼び出します。  
+  
+ **DynamicActivityCreation 5 10 32**   
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\DynamicActivity\DynamicActivityCreation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/emulating-breaking-in-a-while-activity.md b/docs/framework/windows-workflow-foundation/samples/emulating-breaking-in-a-while-activity.md
new file mode 100644
index 00000000000..d7a3c524d45
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/emulating-breaking-in-a-while-activity.md
@@ -0,0 +1,90 @@
+---
+title: "While アクティビティでの中断のエミュレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ddff715d-d623-4b54-b841-60bacbc3ca21
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# While アクティビティでの中断のエミュレート
+このサンプルでは、<xref:System.Activities.Statements.DoWhile>、<xref:System.Activities.Statements.ForEach%601>、<xref:System.Activities.Statements.While>、および <xref:System.Activities.Statements.ParallelForEach%601> の各アクティビティのループ機構を中断する方法を示します。  
+  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] にはこれらのループの実行を中断するアクティビティは用意されていないので、この方法が役立ちます。  
+  
+## シナリオ  
+ このサンプルでは、ベンダー \(`Vendor` クラスのインスタンス\) のリストから信頼できるベンダーを探し、最初に見つかったベンダーを取得します。各ベンダーには、`ID`、`Name`、およびそのベンダーがどの程度信頼できるかを示す信頼度の数値があります。このサンプルでは、`FindReliableVendor` というカスタム アクティビティを作成します。このアクティビティは、2 つの入力パラメーター \(ベンダーのリストと信頼度の最小値\) を受け取り、リストのベンダーのうち、指定された条件に一致する最初のベンダーを返します。  
+  
+## ループの中断  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] にはループを中断するアクティビティは用意されていません。コード サンプルでは、<xref:System.Activities.Statements.If> アクティビティといくつかの変数を使用してループの中断を実現します。このサンプルでは、`reliableVendor` 変数に `null` 以外の値が代入されると、<xref:System.Activities.Statements.While> アクティビティが中断されます。  
+  
+ while ループを中断する方法を示すコード例を次に示します。  
+  
+```csharp  
+// Iterates while the “i” variable is lower than the size of the list   
+// and any reliable Vendor is found.        
+new While(env => i.Get(env) < this.Vendors.Get(env).Count && reliableVendor.Get(env) == null)  
+{  
+    DisplayName = "Main loop. Breaks when a reliable vendor is found",  
+    Body = new Sequence  
+    {                              
+        Activities =  
+        {  
+            // This is the if used for setting the value of the break value…  
+            new If  
+            {  
+                DisplayName = "Check for a reliable vendor",  
+  
+                //  If a vendor satisfies the reliability level…  
+                Condition = new InArgument<bool>(env =>   
+                           this.Vendors.Get(env)[i.Get(env)].Reliability >   
+                           this.MinimumReliability.Get(env)),  
+  
+                // then assign that vendor to the reliable vendor variable and   
+                // the while condition becomes false (exit the loop).  
+                Then = new Assign<Vendor>  
+                {  
+                    To = reliableVendor,  
+                    Value = new InArgument<Vendor>(env =>   
+                                  this.Vendors.Get(env)[i.Get(env)])  
+                }  
+            },  
+  
+            // Increment the iteration variable.   
+            new Assign<int>  
+            {  
+                DisplayName = "Increment iteration variable",  
+                To = i,  
+                Value = new InArgument<int>(env => i.Get(env) + 1)  
+            }   
+        }  
+    }  
+}  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、EmulatingBreakInWhile.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\EmulatingBreakInWhile`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/entity-activities.md b/docs/framework/windows-workflow-foundation/samples/entity-activities.md
new file mode 100644
index 00000000000..88fb451234d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/entity-activities.md
@@ -0,0 +1,268 @@
+---
+title: "エンティティ アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c04f7413-7fb8-40c6-819e-dc92b145b62e
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# エンティティ アクティビティ
+このサンプルでは、ADO.NET Entity Framework と [!INCLUDE[wf2](../../../../includes/wf2-md.md)] を使用してデータ アクセスを簡素化する方法を示します。  
+  
+ ADO.NET Entity Framework を使用すると、開発者は、ドメイン固有のオブジェクト、プロパティ、およびリレーションシップ \(Customers、Orders、Order Details、およびこれらのエンティティ間のリレーションシップなど\) の形式でデータを扱うことができます。ADO.NET Entity Framework では、この機能を実現するために、リレーショナル ストレージ スキーマに対して直接プログラムを作成するのではなく、概念アプリケーション モデルに対してプログラムを作成できるようにする抽象化レベルを提供します。ADO.NET Entity Framework[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[「ADO.NET Entity Framework」](http://go.microsoft.com/fwlink/?LinkId=165549)を参照してください。  
+  
+## サンプルの詳細  
+ このサンプルでは、`Northwind` データベースを使用します。また、`Northwind` データベースを作成および削除するためのスクリプトが用意されています \(Setup.cmd と Cleanup.cmd\)。このサンプルのプロジェクトには、`Northwind` データベースに基づく Entity Data Model が含まれています。このモデルは、プロジェクトに含まれている `Northwind.edmx` ファイルを開くことで見つかります。これは、ADO.NET Entity Framework を使用してアクセスできるオブジェクトの形状を定義するモデルです。  
+  
+ このサンプルには、次のアクティビティがあります。  
+  
+-   `EntitySQLQuery`: `EntitySQLQuery` アクティビティを使用すると、Entity SQL クエリ文字列に基づいてデータベースからオブジェクトを取得できます。Entity SQL はストレージに依存しない SQL と似たクエリ言語です。この言語では、概念モデルに基づいて、またモデルまたはドメインの一部であるエンティティに基づいて、クエリを指定できます。Entity SQL 言語[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[Entity SQL 言語](http://go.microsoft.com/fwlink/?LinkId=165646)」を参照してください。  
+  
+-   `EntityLinqQuery`: このアクティビティを使用すると、LINQ クエリまたは LINQ 述語に基づいてデータベースからオブジェクトを取得できます。  
+  
+-   `EntityAdd`: `EntityAdd` アクティビティを使用すると、エンティティまたはエンティティのコレクションをデータベースに追加できます。  
+  
+-   `EntityDelete`: `EntityDelete` アクティビティを使用すると、エンティティまたはエンティティのコレクションをデータベースから削除できます。  
+  
+-   `ObjectContextScope`: 前に説明した各アクティビティは、これらを格納する `ObjectContextScope` アクティビティ インスタンス内でしか使用できません。`ObjectContextScope` アクティビティは、データベースへの接続を設定します。これには接続文字列が必要です \(接続文字列は、構成ファイルの設定を使用して渡すか取得します\)。`ObjectContextScope` アクティビティにより、エンティティに対して、関連する操作のグループを簡単に実行できるようになります。このスコープはアクティブな接続を維持するので、非永続的スコープです。また、`ObjectContextScope` アクティビティが存在する場合、そのスコープ内でエンティティ アクティビティを使用して取得したオブジェクトに対する変更は、データベースに自動的に永続化され、オブジェクトをデータベースに保存するのに明示的な操作や追加の操作は必要ありません。  
+  
+## エンティティ アクティビティの使用  
+ 以下の各コード スニペットは、このサンプルに含まれているエンティティ アクティビティを使用する方法を示しています。  
+  
+### EntitySql  
+ 次のコード スニペットは、ロンドン在住のすべての顧客を照会して名前で並べ替える方法、および顧客のリストを反復処理する方法を示しています。  
+  
+```  
+Variable<IEnumerable<Customer>> londonCustomers = new Variable<IEnumerable<Customer>>();  
+DelegateInArgument<Customer> iterationVariable = new DelegateInArgument<Customer>();  
+  
+// create and return the workflow  
+return new ObjectContextScope  
+{  
+    ConnectionString = new InArgument<string>(connStr),  
+    ContainerName = "NorthwindEntities",  
+    Variables = { londonCustomers },  
+    Body = new Sequence  
+        {  
+            Activities =   
+                {               
+                    new WriteLine { Text = "Executing query" },                            
+                    // query for all customers that are in london   
+                    new EntitySqlQuery<Customer>  
+                    {  
+                        EntitySql =  @"SELECT VALUE Customer   
+                                        FROM NorthwindEntities.Customers AS Customer   
+                                        WHERE Customer.City = 'London'   
+                                        ORDER BY Customer.ContactName",  
+                        Result = londonCustomers  
+                    },  
+  
+                    // iterate through the list of customers and display them   
+                    new ForEach<Customer>  
+                    {                                      
+                        Values = londonCustomers,  
+                        Body = new ActivityAction<Customer>  
+                        {  
+                            Argument = iterationVariable,  
+                            Handler = new WriteLine   
+                            {   
+                                  Text = new InArgument<String>(e =>    
+                                              iterationVariable.Get(e).ContactName)   
+                            }  
+                        }  
+                    }  
+                }  
+        }                 
+};  
+  
+```  
+  
+### EntityLinqQuery  
+ 次のコード スニペットは、ロンドン在住のすべての顧客を照会する方法、および結果として得られた顧客のリストを反復処理する方法を示しています。  
+  
+```  
+Variable<IEnumerable<Customer>> londonCustomers = new Variable<IEnumerable<Customer>>() { Name = "LondonCustomers" };  
+DelegateInArgument<Customer> iterationVariable = new DelegateInArgument<Customer>() { Name = "iterationVariable" };  
+  
+return new ObjectContextScope  
+{  
+    ConnectionString = new InArgument<string>(connStr),  
+    ContainerName = "NorthwindEntities",  
+    Variables = { londonCustomers },  
+    Body = new Sequence  
+    {  
+        Activities =   
+        {               
+            // return all the customers that match with the provided Linq predicate  
+            new EntityLinqQuery<Customer>  
+            {   
+                Predicate = new LambdaValue<Func<Customer, bool>>(  
+                          ctx => new Func<Customer, bool>(c => c.City.Equals("London"))),                              
+                Result = londonCustomers  
+            },  
+  
+            // iterate through the list of customers and display in the console  
+            new ForEach<Customer>  
+            {                                      
+                Values = londonCustomers,  
+                Body = new ActivityAction<Customer>  
+                {  
+                    Argument = iterationVariable,  
+                    Handler = new WriteLine   
+                    {   
+                        Text = new InArgument<String>(e =>   
+                                      iterationVariable.Get(e).ContactName)   
+                    }  
+                }  
+            }  
+        }  
+    }  
+};  
+  
+```  
+  
+### EntityAdd  
+ 次のコード スニペットは、OrderDetail レコードを既存の Order に追加する方法を示しています。  
+  
+```  
+Variable<IEnumerable<Order>> orders = new Variable<IEnumerable<Order>>();  
+Variable<IEnumerable<OrderDetail>> orderDetails = new Variable<IEnumerable<OrderDetail>>();  
+Variable<Order> order = new Variable<Order>();  
+Variable<OrderDetail> orderDetail = new Variable<OrderDetail>();              
+  
+return new ObjectContextScope  
+{  
+    Variables = { order, orders, orderDetail, orderDetails },  
+    ContainerName = "NorthwindEntities",  
+    ConnectionString = new InArgument<string>(connStr),                  
+    Body = new Sequence  
+    {                      
+        Activities =   
+        {                            
+           // get the order where we want to add the detail  
+           new EntitySqlQuery<Order>  
+           {  
+               EntitySql =    
+                    @"SELECT VALUE [Order]  
+                      FROM NorthwindEntities.Orders as [Order]  
+                      WHERE Order.OrderID == 10249",  
+               Result = orders  
+           },  
+  
+           // store the order in a variable  
+           new Assign<Order>   
+           {  
+               To = new OutArgument<Order>(order),  
+               Value = new InArgument<Order>(c => orders.Get(c).First<Order>())  
+           },  
+  
+           // add the detail to the order  
+           new EntityAdd<OrderDetail>  
+           {  
+               Entity = new InArgument<OrderDetail>(c =>   
+                                         new OrderDetail {   
+                                                  OrderID=10249, ProductID=11,   
+                                                  Quantity=1, UnitPrice = 15,   
+                                                  Discount = 0, Order = order.Get(c) })  
+           }  
+        }  
+    }  
+};  
+  
+```  
+  
+### EntityDelete  
+ 次のコード スニペットは、Order の既存の OrderDetail レコードを削除する方法を示しています \(OrderDetail レコードがある場合\)。  
+  
+```  
+Variable<IEnumerable<OrderDetail>> orderDetails = new Variable<IEnumerable<OrderDetail>>();              
+  
+return new ObjectContextScope  
+{  
+    Variables = { orderDetails },  
+    ConnectionString = new InArgument<string>(connStr),  
+    ContainerName = "NorthwindEntities",  
+    Body = new Sequence  
+    {  
+        Activities =   
+        {               
+            // find the entitiy to be deleted (order detail for product 11 in order 10249)  
+            new EntitySqlQuery<OrderDetail>  
+            {  
+                EntitySql = @"SELECT VALUE OrderDetail  
+                                FROM NorthwindEntities.OrderDetails as OrderDetail  
+                               WHERE OrderDetail.OrderID == 10249   
+                                 AND OrderDetail.ProductID == 11",  
+                Result = orderDetails  
+            },  
+  
+            // if the order detail is found, delete it, otherwise, display a message  
+            new If  
+            {  
+                Condition = new InArgument<bool>(c=>orderDetails.Get(c).Count() > 0),  
+                Then = new Sequence  
+                {   
+                    Activities =   
+                    {                                      
+                        new EntityDelete<OrderDetail>  
+                        {  
+                            Entity = new InArgument<OrderDetail>(c =>   
+                                              orderDetails.Get(c).First<OrderDetail>())  
+                        },  
+                    }  
+                },                              
+                Else = new WriteLine { Text = "Order Detail for Deleting not found" }                              
+            }                                                  
+        }  
+    }  
+};  
+  
+```  
+  
+## このサンプルを使用するには  
+ このサンプルを実行する前に、SQL Server Express のローカル インスタンスに `Northwind` データベースを作成する必要があります。  
+  
+#### Northwind データベースを設定するには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  新しいコマンド プロンプト ウィンドウで、EntityActivities\\CS フォルダーに移動します。  
+  
+3.  「`setup.cmd`」と入力し、Enter キーを押します。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、EntityActivities.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+ このサンプルの実行後、`Northwind` データベースの削除が必要になる場合があります。  
+  
+#### Northwind データベースをアンインストールするには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  新しいコマンド プロンプト ウィンドウで、EntityActivities\\CS フォルダーに移動します。  
+  
+3.  「`cleanup.cmd`」と入力し、Enter キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\EntityActivities`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/execute-a-workflow-in-an-imperative-transactionscope.md b/docs/framework/windows-workflow-foundation/samples/execute-a-workflow-in-an-imperative-transactionscope.md
new file mode 100644
index 00000000000..ce052530fdf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/execute-a-workflow-in-an-imperative-transactionscope.md
@@ -0,0 +1,46 @@
+---
+title: "命令型 TransactionScope でのワークフローの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd0e8686-c1d0-4400-a541-da94ed03afc7
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# 命令型 TransactionScope でのワークフローの実行
+このサンプルでは、命令型 C\# コードから <xref:System.Transactions.Transaction> で <xref:System.Activities.WorkflowInvoker> を使用してワークフローを実行する方法を示します。  
+  
+## サンプルの詳細  
+ 命令型 C\# コードで、<xref:System.Transactions.TransactionScope> を使用して、同じトランザクションで実行される一連の作業をカプセル化します。<xref:System.Transactions.TransactionScope> は、アンビエント トランザクションを作成し、<xref:System.Transactions.Transaction.Current%2A> プロパティを初期化することによって機能します。初期化後、このプロパティには、そのスレッドで実行されるどの作業からでもアクセスできます。  
+  
+ ワークフローではアクティビティ間でスレッド アフィニティが維持されないため、ワークフローで同等の動作を実現するには、ランタイムで、追加の作業として各アクティビティの実行前に <xref:System.Transactions.Transaction.Current%2A> を初期化する必要があります。このランタイムによるサポートの結果として、<xref:System.Transactions.TransactionScope> 内で <xref:System.Activities.WorkflowInvoker> を使用してワークフローを実行するとき、すべてのアクティビティが、<xref:System.Transactions.TransactionScope> によって作成されたアンビエント トランザクションのコンテキストで実行されるようになります。  
+  
+ ワークフローではワークフロー インスタンスごとに 1 つのアンビエント トランザクションしか使用できず、入れ子になったトランザクションは使用できません。ワークフローに <xref:System.Activities.Statements.TransactionScope> アクティビティがある場合でも、新しい内側のトランザクションは作成されません。代わりに、ワークフロー外で作成されたアンビエント トランザクションが再利用されます。  
+  
+ このサンプルでは、新しい <xref:System.Transactions.Transaction.TransactionScope> を開始し、トランザクション ID を出力して、<xref:System.Activities.WorkflowInvoker> によってワークフローを開始します。ワークフローではトランザクション ID を再度出力し \(これにより、同じトランザクションであることが示されます\)、<xref:System.Activities.Statements.TransactionScope> を実行して、完了します。<xref:System.Activities.WorkflowInvoker> での <xref:System.Activities.WorkflowInvoker.Invoke%2A> の呼び出しは同期的であるので、元のスレッドはワークフローが完了するまでブロックされます。ワークフローが完了すると、トランザクションが完了し、リソースが破棄されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ImperativeTransactionSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\ImperativeTransaction`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/execution-properties.md b/docs/framework/windows-workflow-foundation/samples/execution-properties.md
new file mode 100644
index 00000000000..01ca24698a4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/execution-properties.md
@@ -0,0 +1,38 @@
+---
+title: "実行プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 31c009db-397c-4653-87e2-32dc77fa4b13
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 実行プロパティ
+このサンプルでは、カスタム アクティビティで実行プロパティを定義および使用する方法を示します。この例では、実行プロパティによってコンソールの前景色が決定されます。例のワークフローでは、実行のさまざまな論理パス \(<xref:System.Activities.Statements.Parallel> アクティビティの分岐\) が、アクティビティの逐次的実行にもかかわらず、<xref:System.Activities.Statements.Parallel> アクティビティの分岐全体にわたってさまざまなコンソール色をどのように保持するかを示します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ExecutionProperties.sln サンプル ソリューションを開きます。  
+  
+    > [!NOTE]
+    >  使用されるカスタム アクティビティはソリューションと同時にビルドする必要があるため、ソリューションをビルドする前に ThreeColors.xaml を表示するとエラーが表示されます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\ExecutionProperties`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/execution.md b/docs/framework/windows-workflow-foundation/samples/execution.md
new file mode 100644
index 00000000000..3e2d3693892
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/execution.md
@@ -0,0 +1,37 @@
+---
+title: "実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a9dcedcc-9f4c-45c2-8222-6bcbf48f3534
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 実行
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] でのワークフローの実行を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [ワークフロー管理エンドポイントのサンプル](../../../../docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md)  
+ ワークフロー コントロール エンドポイントを使用して、ローカルとリモートの両方でワークフローを作成および実行する方法を示します。  
+  
+ [WorkflowInvoker クラスの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-the-workflowinvoker-class.md)  
+ <xref:System.Activities.WorkflowInvoker> クラスを使用して、メソッドのようにアクティビティを呼び出す方法を示します。  
+  
+ [WorkflowApplication ReadLine ホスト](../../../../docs/framework/windows-workflow-foundation/samples/workflowapplication-readline-host.md)  
+ 汎用 ReadLine ホストを作成する方法を示します。  
+  
+ [ワークフロー インスタンスの作成と実行](../../../../docs/framework/windows-workflow-foundation/samples/creating-and-running-a-workflow-instance.md)  
+ ワークフロー インスタンスを実行する方法を示します。ここでは、ワークフロー インスタンスを同期的または非同期的に実行する方法を示します。  
+  
+ [WorkflowHostingEndpoint 再開ブックマーク](../../../../docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md)  
+ <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を <xref:System.ServiceModel.Activities.WorkflowServiceHost> と共に使用して、ワークフロー インスタンスを作成する方法を示します。  
+  
+ [WorkflowHostingEndpoint のブックマーク リゾルバー](../../../../docs/framework/windows-workflow-foundation/samples/bookmark-resolver-for-workflowhostingendpoint.md)  
+ このサンプルでは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を <xref:System.ServiceModel.Activities.WorkflowServiceHost> と一緒に使用して、ワークフロー インスタンスのカスタムのブックマークを再開する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/exposing-and-invoking-activityactions.md b/docs/framework/windows-workflow-foundation/samples/exposing-and-invoking-activityactions.md
new file mode 100644
index 00000000000..9f664c8f9f7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/exposing-and-invoking-activityactions.md
@@ -0,0 +1,37 @@
+---
+title: "ActivityAction の公開と呼び出し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 97ce4797-426e-463d-9cc4-1261afad6df4
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# ActivityAction の公開と呼び出し
+このサンプルでは、<xref:System.Activities.ActivityAction> を含むカスタム アクティビティを開発する方法を示します。また、<xref:System.Activities.ActivityAction> の実装を提供して、このアクティビティを使用する方法も示します。  
+  
+ <xref:System.Activities.ActivityAction> を使用すると、アクティビティ作成者がカスタムの動作をプラグインできる、特定の署名を持つ "差し込み口" を公開できます。たとえば、<xref:System.Activities.Statements.ForEach> アクティビティ \(項目のコレクションで動作します\) の <xref:System.Activities.ActivityAction> では、アクティビティ ユーザーは現在の反復処理項目で機能する動作をプラグインできます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で **ActivityAction.sln** サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\ActivityAction`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/expressions.md b/docs/framework/windows-workflow-foundation/samples/expressions.md
new file mode 100644
index 00000000000..e92945bcd4d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/expressions.md
@@ -0,0 +1,42 @@
+---
+title: "式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 43a85905-77b5-4893-bb38-1cb9b293d69d
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 式
+このサンプルでは、基本的な式をワークフローで使用する方法を示します。このサンプルは、架空の会社の 2 人の従業員の基本給を計算するワークフローで構成されます。`Employee` および `SalaryStats` という 2 つのクラスが Employee.cs と SalaryStats.cs で定義されています。これらのクラスをワークフローで使用して、複合型の変数のプロパティに対する単純な数値演算と文字列操作を実行する方法を示します。  
+  
+ 給与計算ワークフローは、2 つの作成スタイルを示すために XAML と C\# の両方で定義されています。XAML バージョンは SalaryCalculation.xaml にあり、ワークフロー デザイナーで表示および編集できます。C\# バージョンは Program.cs にあります。XAML で使用されている式は Visual Basic 構文に準拠しており、<xref:Microsoft.VisualBasic.Activities.VisualBasicValue%601> 式アクティビティと <xref:Microsoft.VisualBasic.Activities.VisualBasicReference%601> 式アクティビティを使用して実行されます。Visual Basic の式[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[式](http://go.microsoft.com/fwlink/?LinkId=165912)」を参照してください。一方、C\# の式はラムダ式で記述されており、<xref:System.Activities.Expressions.LambdaValue%601> 式アクティビティと <xref:System.Activities.Expressions.LambdaReference%601> 式アクティビティが使用されます。ラムダ式で記述されているため、C\# コンパイラで構文の強調表示や静的な検証を行うことができます。C\# のラムダ式 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[ラムダ式 \(C\# プログラミング ガイド\)](http://go.microsoft.com/fwlink/?LinkId=182082) を参照してください。ワーク フローで Visual Basic を使用してコードで書かれれば、Visual Basic ラムダ式が使用されます。Visual Basic のラムダ式 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ラムダ式 \(Visual Basic\)](http://go.microsoft.com/fwlink/?LinkId=152437)」を参照してください。命令型コードを使用してワークフローを作成する方法 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)」を参照してください。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で Expressions.sln ソリューションを開きます。  
+  
+2.  CTRL キーと SHIFT キーを押したまま B キーを押してソリューションをビルドするか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+    > [!NOTE]
+    >  Visual Studio デザイナーで SalaryCalculation.xaml を開くには、先にプロジェクトをコンパイルして、`Employee` クラスと `SalaryStats` クラスをデザイナーで使用できるようにする必要があります。  
+  
+3.  ビルドが完了したら、F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Expressions`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/external-activity-validation.md b/docs/framework/windows-workflow-foundation/samples/external-activity-validation.md
new file mode 100644
index 00000000000..4102346c331
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/external-activity-validation.md
@@ -0,0 +1,43 @@
+---
+title: "外部アクティビティの検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49619f59-9819-484a-bcd8-5596308e8551
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 外部アクティビティの検証
+このサンプルでは、ユーザーが作成するものではないビルトイン アクティビティに検証ロジックを追加する方法を示します。検証ロジックでは、ワークフロー内に存在するすべての <xref:System.Activities.Statements.If> アクティビティに <xref:System.Activities.Statements.If.Then%2A> または <xref:System.Activities.Statements.If.Else%2A> のいずれかのプロパティが強制的に設定されます。また、ワークフロー内に存在するすべての <xref:System.Activities.Statements.Pick> アクティビティに複数の分岐が含まれているかどうかが確認され、分岐が含まれていない場合は警告が生成されます。  
+  
+## サンプルの詳細  
+ このサンプルでは、検証する各アクティビティ \(<xref:System.Activities.Statements.If> アクティビティと <xref:System.Activities.Statements.Pick> アクティビティ\) のインスタンスを含むワークフローを作成します。検証動作ごとに <xref:System.Activities.Validation.Constraint> を作成します。このサンプルで作成される制約は `ConstraintError_IfShouldHaveThenOrElse` と `ConstraintWarning_PickHasOneBranch` です。次に、これらの制約を <xref:System.Activities.Validation.ValidationSettings> インスタンスの `AdditionalConstraints` コレクションに追加します。最後に、<xref:System.Activities.Validation.ActivityValidationServices> の `static`<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> メソッドを呼び出してワークフロー内のアクティビティを検証し、検証結果をコンソールに出力します。  
+  
+> [!NOTE]
+>  ポリシー制約は、任意のアクティビティに追加できます。たとえば、<xref:System.Activities.Statements.Sequence> または <xref:System.Activities.Statements.Parallel> アクティビティにポリシー制約を追加できます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ExternalActivityValidation.sln ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Validation\ExternalActivityValidation`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/external-ruleset-toolkit.md b/docs/framework/windows-workflow-foundation/samples/external-ruleset-toolkit.md
new file mode 100644
index 00000000000..99a1d0dddbc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/external-ruleset-toolkit.md
@@ -0,0 +1,144 @@
+---
+title: "External RuleSet Toolkit | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a306d283-a031-475e-aa01-9ae86e7adcb0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# External RuleSet Toolkit
+通常、ワークフロー アプリケーション内でルールが使用される場合は、そのルールはアセンブリの一部です。場合によっては、ワークフロー アセンブリのリビルドや配置を行わずに RuleSet を更新できるように、RuleSet をアセンブリとは別に管理することもあります。このサンプルでは、RuleSet をデータベース内で管理および編集し、実行時にそれらの RuleSet にワークフローからアクセスできるようにしています。その結果、実行中のワークフロー インスタンスに、RuleSet への変更を自動的に組み込むことができます。  
+  
+ この External RuleSet Toolkit サンプルには、RuleSet のバージョンをデータベース内で管理および編集するために使用できる Windows フォーム ベースのツールが含まれています。また、このようなルールを実行するためのアクティビティとホスト サービスも含まれます。  
+  
+> [!NOTE]
+>  このサンプルには [Microsoft SQL Server](http://go.microsoft.com/fwlink/?LinkId=96181) が必要です。  
+  
+ [!INCLUDE[vsprvsext](../../../../includes/vsprvsext-md.md)] には、Windows WF \(Workflow Foundation\) の一部として RuleSet エディタが用意されています。このエディタは、ワークフロー内の `Policy` アクティビティをダブルクリックすると起動できます。これにより、定義済みの RuleSet オブジェクトが、ワークフローに関連付けられている .rules ファイルにシリアル化されます \(`Policy` アクティビティにより、ワークフローに対して RuleSet インスタンスが実行されます\)。.rules ファイルは、ワークフロー プロジェクトをビルドするときに、リソースとしてアセンブリにコンパイルされます。  
+  
+ このサンプルは、次のコンポーネントで構成されています。  
+  
+-   RuleSet のバージョンをデータベース内で編集および管理するために使用できる RuleSet グラフィカル ユーザー インターフェイス ツール。  
+  
+-   ホスト アプリケーション上で構成され、データベースから RuleSet にアクセスする RuleSet サービス。  
+  
+-   RuleSet サービスから RuleSet を要求し、その RuleSet をワークフローに対して実行する `ExternalPolicy` アクティビティ。  
+  
+ これらのコンポーネントの相互関係を図 1 に示します。図の後で各コンポーネントについて説明します。  
+  
+ ![External RuleSet サンプルの概念](../../../../docs/framework/windows-workflow-foundation/samples/media/rulesettoolkitsampleoverview.gif "RuleSetToolkitSampleOverview")  
+  
+ 図 1: サンプルの概要  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ExternalRuleSetToolKit`  
+  
+## RuleSet ツール  
+ RuleSet ツールのスクリーンショットを図 2 に示します。**\[Rule Store\]** メニューを使用して、使用可能な RuleSet をデータベースから読み込み、変更済みの RuleSet をストアに保存することができます。RuleSet データベースのデータベース接続文字列は、アプリケーション構成ファイルで指定されます。ツールを起動すると、構成済みのデータベースから自動的に RuleSet が読み込まれます。  
+  
+ ![External RuleSet Toolkit のサンプル出力](../../../../docs/framework/windows-workflow-foundation/samples/media/rulesetbrowser.gif "RuleSetBrowser")  
+  
+ 図 2: RuleSet ブラウザ  
+  
+ RuleSet ツールでは、RuleSet にメジャー バージョン番号とマイナー バージョン番号を割り当てます。これにより、複数のバージョンを同時に管理および保存できます \(ツールには、バージョン管理機能以外に、ロックなどの構成管理機能は用意されていません\)。このツールを使用して、新しいバージョンの RuleSet を作成したり、既存のバージョンを削除したりできます。**\[New\]** をクリックすると新しい RuleSet 名が作成されて、バージョン 1.0 が適用されます。バージョンをコピーすると、含まれているルールを含め、選択した RuleSet バージョンのコピーが作成されて、新しい一意のバージョン番号が割り当てられます。これらのバージョン番号は、既存の RuleSet のバージョン番号を基に割り当てられます。RuleSet 名とバージョン番号は、フォーム上の対応するフィールドを使用して変更できます。  
+  
+ **\[Edit Rules\]** をクリックすると、図 3 に示す RuleSet エディタが起動します。  
+  
+ ![External RuleSet Toolkit のサンプル出力](../../../../docs/framework/windows-workflow-foundation/samples/media/ruleseteditor.gif "RuleSetEditor")  
+  
+ 図 3: RuleSet エディタ  
+  
+ これは、Windows Workflow Foundation [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] アドインの一部であるエディタ ダイアログのホストを変更したものです。そのため、Intellisense サポートを含めて、同等の機能が用意されています。ルールは、ツール内で RuleSet に関連付けられている対象の型 \(ワークフローなど\) に対して作成されます。ツールのメイン ダイアログで **\[Browse\]** をクリックすると、図 4 に示す **\[Workflow\/Type Selector\]** ダイアログ ボックスが表示されます。  
+  
+ ![ワークフロー&#47;型選択](../../../../docs/framework/windows-workflow-foundation/samples/media/71f08d57-e8f2-499e-8151-ece2cbdcabfd.gif "71f08d57\-e8f2\-499e\-8151\-ece2cbdcabfd")  
+  
+ 図 4: UI\-Workflow\/Type Selector  
+  
+ **\[Workflow\/Type Selector\]** ダイアログ ボックスを使用して、アセンブリとそのアセンブリ内の特定の型を指定できます。ルールの作成 \(および実行\) は、この型に対して行います。多くの場合、対象となる型は、ワークフロー型または他の任意のアクティビティ型です。ただし、RuleSet は任意の .NET 型に対して実行できます。  
+  
+ アセンブリ ファイルのパスと型名は RuleSet と共にデータベースに保存されるため、RuleSet をデータベースから取得するときに、ツールによって対象の型が自動的に読み込まれます。  
+  
+ **\[UI\-Workflow\/Type Selector\]** ダイアログ ボックスで **\[OK\]** をクリックすると、ルールで参照されているすべてのメンバが対象の型に確実に含まれるよう、選択した型が RuleSet に照らして検証されます。エラーは **\[Validation Errors\]** ダイアログ ボックスに表示されます \(図 5 を参照\)。エラーがあっても変更を続行することも、**\[Cancel\]** をクリックすることもできます。ツールのメイン ダイアログ ボックスで、**\[Tools\]** メニューの **\[Validate\]** をクリックして、対象のアクティビティに対して RuleSet のバージョンを再検証できます。  
+  
+ 8019e86d-dc35-4af0-93f5-316b8244032b  
+  
+ 図 5: Validation Errors  
+  
+ ツールの **\[Data\]** メニューから、RuleSet をインポートおよびエクスポートすることができます。**\[Import\]** クリックすると、ファイル選択ダイアログ ボックスが表示され、.rules ファイルを選択できます。このファイルが [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] で最初に作成されているかどうかはわかりません。.rules ファイルは、条件のコレクションと RuleSet のコレクションを含む、シリアル化された `RuleDefinitions` インスタンスを保持します。このツールでは条件のコレクションは使用されませんが、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] 環境とのやり取りのために `RuleDefinitions` .rules 形式が使用されます。  
+  
+ .rules ファイルを選択した後に、**\[RuleSet Selector\]** ダイアログ ボックスが表示されます \(図 6 を参照\)。このダイアログ ボックスを使用して、インポートするファイルから RuleSet を選択できます \(既定では、すべての RuleSet が指定されます\)。WF プロジェクト内の RuleSet のバージョンはアセンブリのバージョンと同じであるため、.rules ファイル内の RuleSet にはバージョン番号がありません。インポート処理中に、次に使用できるメジャー バージョン番号がツールによって自動的に割り当てられます \(このバージョン番号はインポート後に変更できます\)。割り当てられたバージョン番号は、**\[RuleSet Selector\]** ボックスの一覧で確認できます。  
+  
+ ツールでは、インポートする RuleSet ごとに、RuleSet で使用されるメンバに基づいて、.rules ファイルの場所の下に bin\\Debug フォルダ \(存在する場合\) から関連付けられている型が検索されます。一致する型が複数見つかった場合は、.rules ファイル名と型名の対応関係に基づいて型が選択されます \(たとえば、`Workflow1` 型は Workflow1.rules に対応します\)。対応関係が複数存在する場合は、型を選択するように求められます。対応するアセンブリまたは型がこのような自動識別機構で見つからない場合は、インポート後にツールのメイン ダイアログ ボックスの **\[Browse\]** をクリックして、関連付けられている型に移動できます。  
+  
+ ![ルールセット セレクター](../../../../docs/framework/windows-workflow-foundation/samples/media/rulesetselector.gif "RuleSetSelector")  
+  
+ 図 6: RuleSet Selector  
+  
+ ツールのメイン メニューで **\[Data\]** メニューの \[Export\] をクリックした場合も **\[RuleSet Selector\]** ダイアログ ボックスが表示されます。このダイアログ ボックスを使用して、データベースからエクスポートする RuleSet を決定できます。**\[OK\]** をクリックすると、**\[Save File\]** ダイアログ ボックスが表示されます。このダイアログ ボックスでは、エクスポートした .rules  ファイルの名前と保存場所を指定できます。.rules ファイルではバージョン情報が保持されないため、特定の RuleSet 名を持つ RuleSet バージョンを 1 つだけ選択することができます。  
+  
+## PolicyFromService アクティビティ  
+ `PolicyFromService` アクティビティのコードは単純です。このコードの動作は、WF で提供される `Policy` アクティビティによく似ていますが、.rules ファイルから対象の RuleSet を取得するのではなく、ホスト サービスを呼び出して RuleSet のインスタンスを取得します。その後、ルートのワークフロー アクティビティ インスタンスに対して RuleSet を実行します。  
+  
+ ワークフロー内でこのアクティビティを使用するには、ワークフロー プロジェクトから `PolicyActivities` アセンブリおよび `RuleSetService` アセンブリへの参照を追加します。ツールボックスにアクティビティを追加する方法については、このトピックの最後にある手順を参照してください。  
+  
+ ワークフロー内にアクティビティを配置したら、実行する RuleSet の名前を指定する必要があります。この名前は、リテラル値として入力することも、他のアクティビティのワークフロー変数やプロパティにバインドすることもできます。必要に応じて、実行する特定の RuleSet のバージョン番号を入力できます。メジャー バージョン番号とマイナー バージョン番号を既定値の 0 のままにしておくと、データベース内の最新のバージョン番号が自動的にアクティビティに指定されます。  
+  
+## RuleSet サービス  
+ このサービスには、指定された RuleSet のバージョンをデータベースから取得し、呼び出し元のアクティビティに返す役割があります。既に説明したように、`GetRuleSet` の呼び出しで渡されるメジャー バージョンとマイナー バージョンの値がどちらも 0 の場合は、最新のバージョンが取得されます。現時点では、RuleSet の定義と RuleSet インスタンスはキャッシュされず、RuleSet のバージョンに "配置済み" というマークを付けて実行中の RuleSet と区別する機能もありません。  
+  
+ サービスからアクセスされるデータベースは、アプリケーション構成ファイルを使用してホストで構成する必要があります。  
+  
+#### ツールを実行するには  
+  
+1.  ツールとサービスで使用される RuleSet テーブルを設定するフォルダには Setup.sql ファイルがあります。Setup.cmd バッチ ファイルを実行して SQL Express 上に Rules データベースを作成して RuleSet テーブルを設定します。  
+  
+2.  このバッチ ファイルまたは Setup.sql を編集して、SQL Express を使用しないように指定した場合、または `Rules` 以外の名前のデータベースにテーブルを配置するように指定した場合は、RuleSet ツールのアプリケーション構成ファイルと `UsageSample` プロジェクトを同じ情報で編集する必要があります。  
+  
+3.  Setup.sql スクリプトを実行したら、`ExternalRuleSetToolkit` ソリューションをビルドし、その後 ExternalRuleSetTool プロジェクトから RuleSet ツールを起動できます。  
+  
+4.  `RuleSetToolkitUsageSample` のシーケンシャル ワークフロー コンソール アプリケーション ソリューションにはサンプル ワークフローが含まれています。このワークフローは、`PolicyFromService` アクティビティ、および `orderValue` と `discount` の 2 つの変数で構成されており、対象の RuleSet はこれらに対して実行されます。  
+  
+5.  サンプルを使用するには `RuleSetToolkitUsageSample` ソリューションをビルドします。次に、RuleSet ツールのメイン メニューから **\[Data\]** メニューの \[Import\] をクリックし、RuleSetToolkitUsageSample フォルダ内の DiscountRuleSet.rules ファイルを指定します。**\[Rule Store\]** メニューの \[Save\] をクリックして、インポートした RuleSet をデータベースに保存します。  
+  
+6.  `PolicyActivities` アセンブリがサンプル ワークフロー プロジェクトから参照されているため、`PolicyFromService` アクティビティがワークフロー内に表示されます。ただし、既定ではツールボックスに表示されません。ツールボックスに追加するには、次の手順を実行します。  
+  
+    -   ツールボックスを右クリックし、**\[Choose Items\]** をクリックします \(時間がかかる場合があります\)。  
+  
+    -   **\[Choose Toolbox Items\]** ダイアログ ボックスが表示されたら、**\[Activities\]** タブをクリックします。  
+  
+    -   `ExternalRuleSetToolkit` ソリューション内の `PolicyActivities` アセンブリを参照し、**\[Open\]** をクリックします。  
+  
+    -   **\[Choose Toolbox Items\]** ダイアログ ボックスで `PolicyFromService` アクティビティが選択されていることを確認し、**\[OK\]** をクリックします。  
+  
+    -   アクティビティがツールボックスの **\[RuleSetToolkitUsageSample Components\]** カテゴリに表示されます。  
+  
+7.  RuleSet サービスは、Program.cs 内の次のステートメントを使用して既にコンソール アプリケーション ホストで構成されています。  
+  
+    ```  
+    workflowRuntime.AddService(new RuleSetService());  
+    ```  
+  
+8.  構成ファイルを使用して、ホストでこのサービスを構成することもできます。詳細については、SDK のドキュメントを参照してください。  
+  
+9. アプリケーション構成ファイルがワークフロー プロジェクトに追加され、サービスが使用するデータベース接続文字列が指定されます。この接続文字列は、RuleSet テーブルを含むデータベースを指す、RuleSet ツールが使用する接続文字列と同一である必要があります。  
+  
+10. これで、`RuleSetToolkitUsageSample` プロジェクトを他のワークフロー コンソール アプリケーションと同様に実行できるようになります。[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] 内で F5 キーまたは Ctrl \+ F5 キーを押すか、直接 RuleSetToolkitUsageSample.exe ファイルを実行します。  
+  
+    > [!NOTE]
+    >  RuleSet ツールは使用方法サンプルのアセンブリを読み込んでいるため、使用方法サンプルを再コンパイルするには RuleSet ツールを閉じる必要があります。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/externalized-policy-activity-in-net-framework-4-5.md b/docs/framework/windows-workflow-foundation/samples/externalized-policy-activity-in-net-framework-4-5.md
new file mode 100644
index 00000000000..19da4d123c5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/externalized-policy-activity-in-net-framework-4-5.md
@@ -0,0 +1,94 @@
+---
+title: ".NET Framework 4.5 の外部化されたポリシー アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 92fd6f92-23a1-4adf-b96a-2754ea93ad3e
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# .NET Framework 4.5 の外部化されたポリシー アクティビティ
+このサンプルでは、ExternalizedPolicy4 アクティビティによって既存の [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] [!INCLUDE[wf2](../../../../includes/wf2-md.md)] \(WF 3.5\) <xref:System.Workflow.Activities.Rules.RuleSet> オブジェクトを、WF 3.5 に付属しているルール エンジンを使用して [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] [!INCLUDE[wf2](../../../../includes/wf2-md.md)] \(WF 4.5\) で直接実行できるようにする方法を示します。このアクティビティを使用すると、既存の WF 3.5 <xref:System.Workflow.Activities.Rules.RuleSet> を開いて実行できます。[!INCLUDE[crabout](../../../../includes/crabout-md.md)] Windows Workflow Foundation の一部として用意されている WF 3.5 ルール エンジンについては、[「Windows Workflow Foundation ルール エンジンの紹介」](http://go.microsoft.com/fwlink/?LinkId=166079) を参照してください。[!INCLUDE[crabout](../../../../includes/crabout-md.md)][!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] の [!INCLUDE[wf1](../../../../includes/wf1-md.md)] へのルール移行については、[移行のガイドライン](../../../../docs/framework/windows-workflow-foundation//migration-guidance.md) にあるガイドラインを参照してください。  
+  
+## このサンプルのプロジェクト  
+  
+||||  
+|-|-|-|  
+|プロジェクト名|説明|メイン ファイル|  
+|ExternalizedPolicy4|ExternalizedPolicy4 アクティビティとその WF 4.5 デザイナーが含まれます。|**ExternalizedPolicy4.cs**: アクティビティ定義です。<br /><br /> **ExternalizedPolicy4Designer.xaml**: ExternalizedPolicy4 アクティビティのカスタム デザイナーです。WF 3.5 ルール エンジンからルール エディター \(<xref:System.Workflow.Activities.Rules.Design.RuleSetDialog>\) を使用します。|  
+|ImperativeCodeClientSample|命令型 C\# コードで、ExternalizedPolicy4 アプリケーションを使用してワークフローを構成および実行するサンプル クライアント アプリケーションです \(デザイナーは不使用\)。|**ApplyDiscount.rules**: [!INCLUDE[wf1](../../../../includes/wf1-md.md)] ルール定義が記述されたファイルです。<br /><br /> **Order.cs**: 顧客の注文を表す型です。ルールはこの型のオブジェクトに適用されます。<br /><br /> **Program.cs**: Policy4 アクティビティを使用するワークフローを構成および実行して、ApplyDiscount.rules で定義されているルールを Order オブジェクトのインスタンスに適用します。<br /><br /> App.config: ルール ファイルのパスが記述された構成ファイルです。|  
+|DesignerClientSample|[!INCLUDE[wf1](../../../../includes/wf1-md.md)] デザイナーで、ExternalPolicy4 アプリケーションを使用してワークフローを構成および実行するサンプル クライアント アプリケーションです。|**Sequence1.xaml**: Policy4 アクティビティを使用してルール評価を実行するシーケンシャル ワークフローです。<br /><br /> **Program.cs**: Sequence1.xaml で定義されているワークフローのインスタンスを実行します。|  
+  
+## ExternalizedPolicy4 アクティビティ  
+ ExternalizedPolicy4 アクティビティは、WF 4.5 のワークフロー内で WF 3.5 <xref:System.Workflow.Activities.Rules.RuleSet> オブジェクトを実行できるようにする <xref:System.Activities.NativeActivity> です。次のコード例は、このアクティビティのパブリック オブジェクト モデルの簡略化された定義です。  
+  
+```  
+public class ExternalizedPolicy4Activity<TResult>: CodeActivity  
+{  
+    public string RulesFilePath   
+  
+    public string RuleSetName           
+  
+    [RequiredArgument]  
+    public InArgument<T> TargetObject   
+  
+    [RequiredArgument]  
+    public OutArgument<T> ResultObject   
+  
+    public OutArgument<ValidationErrorCollection> ValidationErrors   
+}  
+```  
+  
+|||  
+|-|-|  
+|プロパティ|説明|  
+|RuleSetFilePath|アクティビティが実行されるときに評価される .NET Framework 3.5 <xref:System.Workflow.Activities.Rules.RuleSet> ファイルのパスです。|  
+|RuleSetName|.rules ファイル内で使用される <xref:System.Workflow.Activities.Rules.RuleSet> の名前です。|  
+|TargetObject|<xref:System.Workflow.Activities.Rules.RuleSet> の <xref:System.Workflow.Activities.Rules.Rule> オブジェクトを評価する対象のオブジェクトです。|  
+|ResultObject|ルールが適用された後の結果として得られるオブジェクトです \(たとえば、ルールが Input 引数に対して適用され、結果が Result 引数に格納されます\)。|  
+|ValidationError|実行前に対象オブジェクトに対して <xref:System.Workflow.Activities.Rules.RuleSet> を検証するときに、WF 3.5 ルール エンジンから返される検証エラーのリストです。|  
+  
+## ExternalizedPolicy4 アクティビティ デザイナー  
+ ExternalizedPolicy4 デザイナーを使用すると、コードを記述せずに、既存の RuleSet を使用するようにアクティビティを構成できます。.rules ファイルのパスを設定し、使用する <xref:System.Workflow.Activities.Rules.RuleSet> の名前を指定するだけです。また、<xref:System.Workflow.Activities.Rules.RuleSet> を変更することもできます。ソリューションをビルドすると、Microsoft.Samples.Activities.Rules セクションのツールボックス内からこのデザイナーを使用できるようになります。このデザイナーでは、.rules ファイルと <xref:System.Workflow.Activities.Rules.RuleSet> を選択できます。**\[Edit RuleSet\]** ボタンをクリックすると、WF 3.5 <xref:System.Workflow.Activities.Rules.Design.RuleSetDialog> が表示されます。このダイアログはホストを変更した WF 3.5 ルール エディターであり、ExternalizedPolicy4 アクティビティで実行するルールを表示および編集するために使用します。  
+  
+## Policy4 と ExternalPolicy4  
+ [.NET Framework 4.5 のポリシー アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md)を使用すると、WF 4.5 のワークフロー内で .NET Framework 3.5 RuleSet を作成して実行できます。<xref:System.Workflow.Activities.Rules.RuleSet> は、Policy4 アクティビティの XAML 定義でインラインでシリアル化されます。ExternalizedPolicy4 サンプルでは、既存の外部 <xref:System.Workflow.Activities.Rules.RuleSet> \(.rules ファイル内に格納\) を使用する方法を示します。  
+  
+## このサンプルの使用  
+ このサンプルを実行するのに特別な設定は必要ありません。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] でソリューションを開き、F5 キーを押してアプリケーションを実行します。  
+  
+ このサンプルには、ImperativeCodeClientSample と DesignerClientSample の 2 つのクライアント アプリケーションがあります。ImperativeCodeClientSample クライアントは、C\# 命令型コードを使用して ExternalizedPolicy4 アクティビティを構成および実行する方法を示します。DesignerClientSample は、デザイナーを使用して ExternalizedPolicy4 アクティビティを構成および実行する方法を示します。  
+  
+#### ImperativeCodeClientSample アプリケーションを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、Policy4sample.sln ソリューション ファイルを開きます。  
+  
+2.  **ソリューション エクスプローラー**で、**ImperativeCodeClientSample** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+3.  プロジェクトを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+#### DesignerClientSample アプリケーションを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、Policy4sample.sln ソリューション ファイルを開きます。  
+  
+2.  **ソリューション エクスプローラー**で、**DesignerClientSample** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+3.  Ctrl キーと Shift キーを押しながら B キーを押して、プロジェクトをコンパイルします。  
+  
+4.  プロジェクトを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\Rules-ExternalizedPolicy4`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/extract-wf-data-using-tracking.md b/docs/framework/windows-workflow-foundation/samples/extract-wf-data-using-tracking.md
new file mode 100644
index 00000000000..d0336ce16ee
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/extract-wf-data-using-tracking.md
@@ -0,0 +1,164 @@
+---
+title: "追跡を使用した WF データの抽出 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e30c68f5-8c6a-495a-bd20-667a4364c68e
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# 追跡を使用した WF データの抽出
+このサンプルでは、ワークフロー追跡を使用して、アクティビティからワークフロー変数と引数を抽出する方法を示します。また、追跡レコードへの注釈の追加、およびカスタム追跡レコード内のデータ ペイロードの抽出の例も示します。このサンプルでは、ワークフローからデータを抽出するために Event Tracing for Windows \(ETW\) 追跡参加要素を使用します。  
+  
+## サンプルの詳細  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] には、ワークフロー インスタンスの実行を視覚的に示す追跡機能が用意されています。追跡ランタイムでは、ワークフローの実行中にワークフロー追跡レコードが出力されます。このワークフロー追跡レコードと共に、ワークフロー インスタンス内のデータをワークフローから抽出することができます。追跡レコードから抽出できるデータの種類の詳細を以下に示します。  
+  
+1.  アクティビティ内のワークフロー変数とアクティビティの実行時の追跡レコード。  
+  
+     ワークフロー変数を抽出するには、抽出する変数をプロファイルで指定します。抽出する変数は、`ActivityStateQueries` でのみ指定できます。アクティビティからワークフロー変数を抽出するために使用する追跡プロファイルのコード例を次に示します。  
+  
+    ```xml  
+    <activityStateQuery activityName="StockPriceService">  
+         <states>  
+              <state name="Closed"/>  
+         </states>  
+         <variables>  
+              <variable name="symbol"/>  
+         </variables>  
+    </activityStateQuery>  
+    ```  
+  
+2.  アクティビティ引数とアクティビティ状態の追跡レコード。  
+  
+     引数は、アクティビティとのデータ フローの方法を定義します。抽出する引数は、<xref:System.Activities.Tracking.ActivityStateQuery> を使用して指定します。`Value` 引数を抽出する追跡プロファイルのコード例を次に示します。  
+  
+    ```xml  
+    <activityStateQuery activityName="GetStockPrice">  
+         <states>  
+              <state name="Closed"/>  
+         </states>  
+         <arguments>  
+              <argument name="Value"/>  
+         </arguments>  
+    </activityStateQuery>  
+    ```  
+  
+3.  注釈は、出力される追跡レコードに追加できるキーと値のペアです。  
+  
+     注釈は、追跡レコードのタグ付け機構として機能します。追跡プロファイルを通して追跡レコードに追加され、どの種類のワークフロー追跡クエリにも追加できます。追跡レコードに注釈を追加する方法を示す追跡プロファイルのコード例を次に示します。  
+  
+    ```xml  
+    <workflowInstanceQuery>  
+         <states>  
+              <state name="Started"/>  
+         </states>  
+         <annotations>  
+              <annotation name="StockPriceWorkflow" value="Begin"/>  
+         </annotations>  
+    </workflowInstanceQuery>  
+    ```  
+  
+4.  カスタム追跡レコードは、ユーザー定義のアクティビティから出力されます。  
+  
+     カスタム追跡レコードは、対象のアクティビティ内で定義されたペイロード データを伝達できます。追跡プロファイルでカスタム追跡レコードを定期受信すると、追跡レコード内のペイロードを抽出することができます。カスタム追跡レコードを抽出するには、カスタムの <xref:System.Activities.Tracking.TrackingQuery> を使用します。カスタム追跡レコードをそのペイロードと共に抽出する追跡プロファイルのコード例を次に示します。  
+  
+    ```  
+    <customTrackingQuery name="QuoteLookupEvent" activityName="GetStockPrice"/>  
+    ```  
+  
+ このサンプルでは、Web.config で指定されたプロファイルを使用して、変数、引数、およびカスタム レコードを抽出し、注釈を追加する例を示しています。サンプルのワークフロー サービスでは、`<etwTracking>` 動作要素を追加して追跡を有効にしています。`ExtractWorkflowVariables` 追跡プロファイルの追跡を有効にするコード例を次に示します。  
+  
+```  
+<serviceBehaviors>  
+     <behavior>  
+               <etwTracking profileName="ExtractWorkflowVariables"/>  
+     </behavior>  
+</serviceBehaviors>  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、WFStockPriceApplication.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+     ブラウザー ウィンドウが開き、アプリケーションのディレクトリの一覧が示されます。  
+  
+4.  ブラウザーで、StockPriceService.xamlx をクリックします。  
+  
+5.  ブラウザーに、\[StockPriceService\] ページが表示され、ローカル サービスの WSDL アドレスが示されます。このアドレスをコピーします。  
+  
+     ローカル サービスの WSDL アドレスの例を次に示します。`http://localhost:53797/StockPriceService.xamlx?wsdl`  
+  
+6.  サービスを呼び出す前に、イベント ビューアーを起動し、ワークフロー サービスから生成された追跡イベントをイベント ログでリッスンしていることを確認します。  
+  
+7.  **\[スタート\]** メニューから、**\[管理ツール\]**、**\[イベント ビューアー\]** の順に選択します。  
+  
+8.  イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]** の順に選択して **\[Microsoft\]** に移動します。**\[Microsoft\]** を右クリックし、**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。  
+  
+     **\[分析およびデバッグ ログの表示\]** オプションがオンになっていることを確認します。  
+  
+9. イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログを有効にする\]** を選択します。  
+  
+10. [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を使用して、WCF テスト クライアントを開きます。  
+  
+     WCF テスト クライアント \(WcfTestClient.exe\) は \<[!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] のインストール フォルダー\>\\Common7\\IDE\\ フォルダーにあります。  
+  
+     [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] の既定のインストール フォルダーは C:\\Program Files\\Microsoft Visual Studio 10.0 です。  
+  
+11. WCF テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。  
+  
+     前の手順でコピーしたローカル サービスの WSDL アドレスを入力ボックスに追加します。  
+  
+12. WCF テスト クライアントで、`GetStockPrice` をダブルクリックします。  
+  
+     `GetStockPrice` メソッドが開きます。この要求はパラメーターを 1 つ受け取ります。値 **Contoso** を使用します。  
+  
+13. **\[起動\]** をクリックします。  
+  
+14. イベント ビューアーに戻り、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[更新\]** を選択します。ワークフロー イベントのイベント ID の範囲は 100 ～ 199 です。  
+  
+     イベントには、イベント ビューアーで表示できる注釈、変数、引数、およびカスタム追跡レコードが含まれます。  
+  
+## イベント ビューアーでのクリーンアップ  
+ イベント ログの分析チャネルは、次の手順に従ってイベント ビューアーでクリーンアップできます。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  イベント ビューアーを開きます。  
+  
+2.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログの無効化\]** を選択します。  
+  
+3.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログのクリア\]** を選択します。  
+  
+     **\[クリア\]** オプションを選択してイベントをクリアします。  
+  
+## 既知の問題  
+  
+> [!NOTE]
+>  イベント ビューアーの既知の問題により、ETW イベントをデコードできない場合があります。その場合、次のようなエラー メッセージが表示されます。  
+>   
+>  `ソース "Microsoft-Windows-Application Server-Applications" からのイベント ID <id> の説明が見つかりません。このイベントを発生させるコンポーネントがローカル コンピューターにインストールされていないか、インストールが壊れています。ローカル コンピューターにコンポーネントをインストールするか、コンポーネントを修復してください。`  
+>   
+>  このエラーが発生した場合は、操作ウィンドウで **\[最新の情報に更新\]** をクリックしてください。これにより、イベントが正常にデコードされます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\ExtractWfData`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md b/docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md
new file mode 100644
index 00000000000..41aff40cb30
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/fault-handling-in-a-flowchart-activity-using-trycatch.md
@@ -0,0 +1,56 @@
+---
+title: "TryCatch を使用した Flowchart アクティビティでのエラー処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 50922964-bfe0-4ba8-9422-0e7220d514fd
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# TryCatch を使用した Flowchart アクティビティでのエラー処理
+このサンプルでは、複雑な制御フロー アクティビティ内で <xref:System.Activities.Statements.TryCatch> アクティビティを使用する方法を示します。  
+  
+ このサンプルでは、販売促進コードに対応する式に基づいて割引率を計算する <xref:System.Activities.Statements.Flowchart> アクティビティに、販売促進コードと子供の数が変数として渡されます。このサンプルには、命令型コードとワークフロー デザイナー バージョンのサンプルが含まれています。  
+  
+ 次の表で、`CreateFlowchartWithFaults` アクティビティの変数の詳細を説明します。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|promoCode|販売促進コード。型: String<br /><br /> 使用できる値は次のとおりです \(かっこ内は値の説明\)。<br /><br /> -   Single \(独身\)<br />-   MNK \(子供のいない既婚者\)<br />-   MWK \(子供のいる既婚者\)|  
+|numKids|子供の数。型: int|  
+  
+ `CreateFlowchartWithFaults` アクティビティでは、`promoCode` 引数を有効にする <xref:System.Activities.Statements.FlowSwitch%601> アクティビティを使用し、次の式を使って割引率を計算します。  
+  
+|`promoCode` の値|割引率 \(%\)|  
+|--------------------|---------------|  
+|Single|10|  
+|MNK|15|  
+|MWK|15 \+ \(1 – 1\/`numberOfKids`\)\*10 **Note:**  この計算では、<xref:System.DivideByZeroException> がスローされる可能性があります。そのため、割引率の計算は、<xref:System.DivideByZeroException> 例外をキャッチして割引率をゼロに設定する <xref:System.Activities.Statements.TryCatch> アクティビティでラップされます。|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、FlowchartWithFaultHandling.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\FlowChartWithFaultHandling`  
+  
+## 参照  
+ [Flowchart のワークフロー](../../../../docs/framework/windows-workflow-foundation//flowchart-workflows.md)   
+ [例外](../../../../docs/framework/windows-workflow-foundation//exceptions.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/for-activity.md b/docs/framework/windows-workflow-foundation/samples/for-activity.md
new file mode 100644
index 00000000000..2eed9076749
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/for-activity.md
@@ -0,0 +1,69 @@
+---
+title: "For アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 2ea751b4-36f0-48aa-a115-70a2ab89f6d8
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# For アクティビティ
+For サンプルでは、<xref:System.Activities.NativeActivity> から継承するカスタム アクティビティを構築し、そのアクティビティをワークフローで使用して実際の例を実行する方法を示します。このサンプルに含まれるカスタム アクティビティは、C\# の `for` ステートメントと同じように機能します。T  
+  
+ `For` カスタム アクティビティには、`InitAction`、`IterationAction`、`Condition`、および `Body` というプロパティがあります。これらのプロパティは、標準的な C\# の `For` ステートメントの初期化ステートメント、反復ステートメント、継続条件、および本体ステートメントにそれぞれ対応します。  
+  
+ 次の表で、サンプルの主要なファイルについて説明します。  
+  
+|ファイル|説明|  
+|----------|--------|  
+|For.cs|`For` カスタム アクティビティのクラス定義。<xref:System.Activities.NativeActivity> クラスを拡張して C\# の `For` ステートメントの機能を提供します。|  
+|Program.cs|カスタム `For` アクティビティを使用してコレクションに対して基本的な反復処理を実行するクライアント アプリケーション。|  
+  
+> [!NOTE]
+>  `For` カスタム アクティビティを使用する場合は、必ず `Condition` プロパティを設定してください。そうしないと、無限ループが発生する可能性があります。  
+  
+## 使用例  
+ <xref:System.Activities.NativeActivity> から継承するカスタム アクティビティを作成します。  
+  
+## 説明  
+ 次の表で、このサンプルに含まれるアクティビティのプロパティについて説明します。  
+  
+ InitAction  
+ 初期化ステートメント  
+  
+ IterationAction  
+ 反復ステートメント  
+  
+ Condition  
+ 条件ステートメント  
+  
+ Body  
+ 本体ステートメント  
+  
+ このアクティビティは、<xref:System.Activities.NativeActivity> から継承して、ランタイム機能 \(<xref:System.Activities.NativeActivityContext> のいずれかの `ScheduleActivity` メソッドを使用した追加アクティビティの実行スケジュールの設定など\) へのアクセスを取得します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、For.sln ソリューション ファイルを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  F5 キーを押して、ソリューションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\For`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/formatting-messages-in-workflow-services.md b/docs/framework/windows-workflow-foundation/samples/formatting-messages-in-workflow-services.md
new file mode 100644
index 00000000000..28c8db2a90e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/formatting-messages-in-workflow-services.md
@@ -0,0 +1,39 @@
+---
+title: "ワークフロー サービスでのメッセージの書式設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6d15d44b-20f8-4cb7-bd4f-598c32781ebc
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# ワークフロー サービスでのメッセージの書式設定
+このサンプルでは、メッセージング アクティビティ \(WF サービス\) で使用できるユーザーの種類を示します。サンプルのサービスは、簡単な費用承認サービスで、3 つの操作を公開します。`ApproveExpense` はデータ コントラクト型を受け取り、既知の型を使用する方法を示します。この操作では、費用の金額に基づいて `true` または `false` を返します。`ApprovePO` は、XmlSerializer 型を受け取り、費用の金額に基づいて `true` または `false` を返します。`ApprovedVendor` は、メッセージ コントラクト型を受け取り、販売元が承認された販売元の一覧に含まれているかどうか、または要求が経理部からのものであるかどうか \(経理部はどの販売元でも使用できます\) に応じて `true` または `false` を返します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でプロジェクト ソリューションを読み込み、プロジェクトをビルドします。  
+  
+2.  最初に、\[ソリューションの基本ディレクトリ\]\\FormatterService\\bin\\debug\\ に生成されたサービスを実行します。  
+  
+3.  2 番目に、\[ソリューションの基本ディレクトリ\]\\FormatterClient\\bin\\debug に生成されたクライアント アプリケーションを実行します。  
+  
+4.  クライアントは、サービスで 3 つの操作を呼び出し、結果を出力します。完了したら、Enter キーを押してクライアントを終了し、サービスを終了します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\Formatter`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/get-workflowinstanceid.md b/docs/framework/windows-workflow-foundation/samples/get-workflowinstanceid.md
new file mode 100644
index 00000000000..cb3b6517acd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/get-workflowinstanceid.md
@@ -0,0 +1,46 @@
+---
+title: "WorkflowInstanceId の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bd7eea3b-1c28-4b84-9a67-003bc553aa81
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WorkflowInstanceId の取得
+このサンプルでは、カスタム アクティビティ `GetWorkflowInstanceId` を使用して、ワークフロー インスタンス ID を返す方法を示します。  
+  
+## 使用例  
+ カスタム アクティビティの開発、ワークフロー インスタンスにアクセスする方法。  
+  
+## 説明  
+ 実行中のワークフローのインスタンス ID を取得するには、コードを記述する必要があります。完全な宣言型のワークフローを記述する場合は、ワークフロー インスタンス ID を返すことができるアクティビティが必要です。そのアクティビティをワークフローで参照することで、完全な宣言型のワークフローを作成できるようになります。多くのシナリオで、インスタンス ID へのアクセスが必要になります。例としては、ログ記録または監査のためや、後で連携できるようにインスタンス ID をクライアントに返送する \(たとえば、SendReply アクティビティ内でこのアクティビティを使用する\) ことでアプリケーション レベルの関連付けを行うためなどが挙げられます。  
+  
+ `GetWorkflowInstanceId` は、<xref:System.Guid> 型の値を返す必要があり、ワークフローのインスタンス ID を取得するために <xref:System.Activities.CodeActivityContext> にアクセスできる必要があるので、<xref:System.Activities.CodeActivity%601> として実装されます。この実装は非常に基本的なものです。  
+  
+```  
+public sealed class GetWorkflowInstanceId : CodeActivity<Guid>  
+{  
+protected override Guid Execute(CodeActivityContext context)  
+        {  
+            return context.WorkflowInstanceId;  
+        }  
+}  
+  
+```  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\GetWorkflowInstanceId`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/getting-started-writing-a-custom-activity.md b/docs/framework/windows-workflow-foundation/samples/getting-started-writing-a-custom-activity.md
new file mode 100644
index 00000000000..546cf8ac30a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/getting-started-writing-a-custom-activity.md
@@ -0,0 +1,35 @@
+---
+title: "カスタム アクティビティの記述について | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3902f5fa-8a43-4048-8a6a-6b15472f90f0
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# カスタム アクティビティの記述について
+このサンプルでは、XAML で単純なカスタム アクティビティを定義する方法を示します。このアクティビティの名前は `Rhyme` で、ロジックは 3 つの連続する <xref:System.Activities.Statements.WriteLine> アクティビティです。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で **Simple.sln** サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Composite\GettingStarted`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/hello-world-custom-activity.md b/docs/framework/windows-workflow-foundation/samples/hello-world-custom-activity.md
new file mode 100644
index 00000000000..cb9fee521b6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/hello-world-custom-activity.md
@@ -0,0 +1,60 @@
+---
+title: "Hello World カスタム アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72b1dd0a-9aad-47d5-95a9-a1024ee1d0a1
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# Hello World カスタム アクティビティ
+このサンプルでは、単純なカスタム アクティビティを作成する方法を含む、[!INCLUDE[wf](../../../../includes/wf-md.md)] の主要な機能をいくつか示します。このサンプルで示す機能では、C\# でカスタム アクティビティを作成し、`in` 引数と `out` 引数 \(<xref:System.Activities.InArgument> と <xref:System.Activities.OutArgument>\) を使用します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\HelloWorld`  
+  
+## コードでのワークフローの作成  
+ このサンプルでは、C\# コードを使用して、2 つのカスタム アクティビティを作成します。どちらのカスタム アクティビティも、<xref:System.Activities.Activity%601> から直接または間接に継承して、1 つの値を返します。非ジェネリック クラス <xref:System.Activities.Activity> から継承する代わりにジェネリックな戻り値を使用する利点は、特定のアクティビティ \(<xref:System.Activities.Statements.Assign> など\) が、作成されるアクティビティの一部として使用する場合に戻り値にアクセスできることです。  
+  
+ AppendString  
+ このアクティビティは、<xref:System.Activities.Activity%601> から継承し、2 つの文字列を 1 つに連結する <xref:System.Activities.Statements.Assign> アクティビティを使用します。  
+  
+ Prepend String  
+ このアクティビティは、<xref:System.Activities.CodeActivity%601> から直接継承し、`AppendString` アクティビティと同様の機能を作成します。この機能は、既存のアクティビティから構成されるのではなく、コードに実装されているロジックを使用します。  
+  
+ このプロジェクトには、次のファイルがあります。  
+  
+ AppendString.cs  
+ 複数の文字列を 1 つにするカスタム アクティビティです。文字列を受け取り、リテラル テキスト文字列 "says hello world" と結合して、1 つの完全なメッセージを出力します。  
+  
+ PrependString.cs  
+ このアクティビティは、定義済みの文字列を入力文字列の先頭に付けます。  
+  
+ Sequence1.xaml  
+ `AppendString` カスタム アクティビティと `PrependString` カスタム アクティビティを使用するワークフローです。  
+  
+ Program.cs  
+ ワークフローを実行するプログラムです。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、HelloWorld.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/hiring-process.md b/docs/framework/windows-workflow-foundation/samples/hiring-process.md
new file mode 100644
index 00000000000..8b5c904d48a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/hiring-process.md
@@ -0,0 +1,243 @@
+---
+title: "雇用プロセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d5fcacbb-c884-4b37-a5d6-02b1b8eec7b4
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# 雇用プロセス
+このサンプルでは、メッセージング アクティビティ、およびワークフロー サービスとしてホストされる 2 つのワークフローを使用して、ビジネス プロセスを実装する方法を示します。この 2 つのワークフローは、Contoso, Inc という架空の会社の IT インフラストラクチャの一部です。  
+  
+ `HiringRequest` ワークフロー プロセス \(<xref:System.Activities.Statements.Flowchart> として実装\) は、組織の複数のマネージャーの承認が必要です。この目標を達成するため、ワークフローでは、組織内の他の既存のサービス \(ここでは、プレーン [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスとして実装された受信トレイ サービスおよび組織データ サービス\) を使用します。  
+  
+ `ResumeRequest` ワークフロー \(<xref:System.Activities.Statements.Sequence> として実装\) は、Contoso 社の外部 Careers Web サイトに求人情報を発行し、履歴書の受け取りを管理します。求人情報は、指定した期間 \(タイムアウトになるまで\) または Contoso の従業員が削除を決定するまで、外部 Web サイトに掲載されます。  
+  
+ このサンプルでは、次の [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] の機能について説明します。  
+  
+-   ビジネス プロセスをモデル化する <xref:System.Activities.Statements.Flowchart> および <xref:System.Activities.Statements.Sequence> ワークフロー。  
+  
+-   ワークフロー サービス。  
+  
+-   メッセージング アクティビティ。  
+  
+-   コンテンツ ベースの相関関係。  
+  
+-   カスタム アクティビティ \(宣言型およびコードベース\)。  
+  
+-   システムで指定された SQL サーバー永続性。  
+  
+-   カスタム <xref:System.Activities.Persistence.PersistenceParticipant>。  
+  
+-   カスタム追跡  
+  
+-   Event Tracking for Windows \(ETW\) 追跡。  
+  
+-   アクティビティの構成。  
+  
+-   <xref:System.Activities.Statements.Parallel> アクティビティ。  
+  
+-   <xref:System.Activities.Statements.CancellationScope> アクティビティ。  
+  
+-   永続的なタイマー \(<xref:System.Activities.Statements.Delay> アクティビティ\)。  
+  
+-   トランザクション。  
+  
+-   同一ソリューションの複数のワークフロー。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Application\HiringProcess`  
+  
+## プロセスの説明  
+ Contoso 社は、各部門の人数を綿密に管理しようとしています。このため、従業員が新しい雇用プロセスを開始する場合、求人を実際に開始する前に雇用要件プロセスの承認を受ける必要があります。このプロセスは、雇用プロセス要求 \(HiringRequestService プロジェクトで定義\) と呼ばれ、次の手順で構成されます。  
+  
+1.  従業員 \(要求者\) は雇用プロセス要求を開始します。  
+  
+2.  要求者のマネージャーは、要求を承認する必要があります。  
+  
+    1.  マネージャーは要求を拒否できます。  
+  
+    2.  マネージャーは、追加情報が必要な場合、要求者に要求を戻すことができます。  
+  
+        1.  要求者は要求を再検討し、マネージャーに再承認を求めることができます。  
+  
+    3.  マネージャーはこれを承認します。  
+  
+3.  要求者のマネージャーの承認後は、その部門の責任者が要求を承認する必要があります。  
+  
+    1.  部門の責任者は要求を拒否できます。  
+  
+    2.  部門の責任者は要求を承認できます。  
+  
+4.  部門の責任者の承認後は、HR \(人事部\) の 2名のマネージャーまたは CEO \(最高経営責任者\) の承認を受ける必要があります。  
+  
+    1.  プロセスは承認状態または拒否状態のいずれかになります。  
+  
+    2.  プロセスが \[承諾済み\] になると、`ResumeRequest` ワークフローの新しいインスタンスが開始されます \(`ResumeRequest` はサービス参照を使用して HiringRequest.csproj にリンクされます\)。  
+  
+ マネージャーが新しい従業員の雇用を承認すると、HR は適切な応募者を採用する必要があります。このプロセスは、2 番目のワークフロー \(`ResumeRequest`。ResumeRequestService.csproj で定義。\) で実行されます。このワークフローによって、Contoso 社の外部 Careers Web サイトに求人情報を送信するプロセスが定義され、応募者から履歴書を受信し、募集の状況が監視されます。求人は、指定した期間 \(有効期間が過ぎるまで\) または Contoso の従業員が削除を指定するまで有効です。`ResumeRequest` ワークフローは、次のステップから構成されています。  
+  
+1.  Contoso 社の従業員は、求人およびタイムアウト期間に関する情報を入力します。従業員がこの情報を入力すると、Careers Web サイトに求人情報が掲載されます。  
+  
+2.  この情報が発行されると、この情報に興味を持った人が自分の履歴書を送信します。履歴書は、送信後、求人にリンクされたレコードに保存されます。  
+  
+3.  応募者は、タイムアウトになるまで、または Contoso 社の HR 部でプロセスを停止して求人を削除することを明示的に決定するまでは履歴書を送信することができます。  
+  
+## サンプルのプロジェクト  
+ サンプル ソリューションのプロジェクトを次の表に示します。  
+  
+|プロジェクト|説明|  
+|------------|--------|  
+|ContosoHR|データ コントラクト、ビジネス オブジェクト、およびリポジトリ クラスを含んでいます。|  
+|HiringRequestService|Hiring Request Process ワークフローの定義を含んでいます。<br /><br /> このプロジェクトは、サービスとしてワークフロー \(xaml ファイル\) を自己ホストするコンソール アプリケーションとして実装されます。|  
+|ResumeRequestService|タイムアウトとなるかプロセス終了が決定するまで応募者からの履歴書を収集するワークフロー サービス。<br /><br /> このプロジェクトは、宣言型ワークフロー サービス \(xamlx\) として実装されます。|  
+|OrgService|組織情報 \(Employees、Positions、PositionTypes、および Departments\) を公開するサービス。このサービスは、Enterprise Resource Plan \(ERP\) の Company Organization モジュールと考えることができます。<br /><br /> このプロジェクトは、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サービスを公開するコンソール アプリケーションとして実装されます。|  
+|InboxService|従業員のアクション可能なタスクを含んでいる受信トレイです。<br /><br /> このプロジェクトは、WCF サービスを公開するコンソール アプリケーションとして実装されます。|  
+|InternalClient|プロセスと対話するための Web アプリケーション。ユーザーは、HiringProcess ワークフローを開始して、参加し、表示できます。このアプリケーションを使用すると、ResumeRequest プロセスを開始および監視することもできます。<br /><br /> このサイトは、Contoso のイントラネット内のサイトとして実装されます。このプロジェクトは ASP.NET Web サイトとして実装されます。|  
+|CareersWebSite|Contoso 社で募集中の求人を公開する外部 Web サイト。興味を持った応募者は、このサイトに移動して、履歴書を送信します。|  
+  
+## 機能の概要  
+ このサンプルでの各機能の使用方法を次の表に示します。  
+  
+|機能|説明|プロジェクト|  
+|--------|--------|------------|  
+|フローチャート|ビジネス プロセスがフローチャートとして表されます。このフローチャートの説明では、業務時にプロセスがホワイトボードに描画されるのと同じ方法でプロセスが表されます。|HiringRequestService|  
+|ワークフロー サービス|プロセスの定義を持つフローチャートは、サービスでホストされます \(この例では、サービスはコンソール アプリケーションでホストされます\)。|HiringRequestService|  
+|メッセージング アクティビティ|フローチャートでは、次の 2 つの方法でメッセージング アクティビティが使用されます。<br /><br /> -   ユーザーから情報を取得する \(各承認手順で決定および関連情報を受信する\)。<br />-   他の既存のサービス \(サービス参照から使用できる InboxService および OrgDataService\) と対話する。|HiringRequestService|  
+|コンテンツ ベースの相関関係|雇用要求の ID プロパティにおける承認メッセージ相関関係は次のとおりです。<br /><br /> -   プロセスが開始されると、関連付けハンドルが要求の ID によって初期化されます。<br />-   受信承認メッセージは、その ID \(各承認メッセージの最初のパラメーターが要求の ID です\) に基づいて関連付けられます。|HiringRequestService \/ ResumeRequestService|  
+|カスタム アクティビティ \(宣言型およびコード ベース\)|このサンプルには、次の複数のカスタム アクティビティがあります。<br /><br /> -   `SaveActionTracking`: このアクティビティは、カスタムの <xref:System.Activities.Tracking.TrackingRecord> を出力します \(<xref:System.Activities.NativeActivityContext.Track%2A> を使用\)。このアクティビティは、<xref:System.Activities.NativeActivity> を拡張する命令型コードを使用して作成されています。<br />-   `GetEmployeesByPositionTypes`: このアクティビティは、タイプ ID のリストを受信し、Contoso 社でその職種に就いている従業員のリストを返します。このアクティビティは、宣言的に作成されています \(アクティビティ デザイナーを使用\)。<br />-   `SaveHiringRequestInfo`: このアクティビティは、`HiringRequest` の情報を保存します \(`HiringRequestRepository.Save` を使用\)。このアクティビティは、<xref:System.Activities.CodeActivity> を拡張する命令型コードを使用して作成されています。|HiringRequestService|  
+|システムで指定された SQL サーバー永続性|Flowchart プロセス定義をホストする<xref:System.ServiceModel.Activities.WorkflowServiceHost> インスタンスは、システムで指定された SQL サーバー永続性を使用するように構成されています。|HiringRequestService \/ ResumeRequestService|  
+|カスタム追跡|このサンプルには、`HiringRequestProcess` の履歴を保存するカスタム追跡参加要素が含まれています \(これによって、アクションの内容、実行者、および時期が記録されます\)。ソース コードは、HiringRequestService の Tracking フォルダーにあります。|HiringRequestService|  
+|ETW 追跡|システムで指定された ETW 追跡は、HiringRequestService サービスの App.config ファイルで設定されます。|HiringRequestService|  
+|アクティビティの構成|プロセス定義では、<xref:System.Activities.Activity> のフリー コンポジションが使用されます。Flowchart には、その他のアクティビティなどを同時に含んでいる複数の Sequence アクティビティと Parallel アクティビティが含まれています。|HiringRequestService|  
+|並列アクティビティ|-   <xref:System.Activities.Statements.ParallelForEach%601> は、CEO および HR マネージャーの受信トレイへの同時登録を可能にするために使用されます \(2 人の HR マネージャーの承認手順を待機します\)。<br />-   <xref:System.Activities.Statements.Parallel> は、\[完了\] 手順および \[却下\] 手順のクリーンアップ タスクの一部を実行するために使用されます。|HiringRequestService|  
+|モデルの取り消し|フローチャートでは、<xref:System.Activities.Statements.CancellationScope> を使用して、取り消し動作を作成します \(この場合、一部のクリーンアップが実行されます\)。|HiringRequestService|  
+|カスタマー永続参加要素|`HiringRequestPersistenceParticipant` は、ワークフロー変数のデータを Contoso HR データベースに保存されているテーブルに保存します。|HiringRequestService|  
+|ワークフロー サービス|`ResumeRequestService` は、ワークフロー サービスを使用して実装されます。ワークフロー定義およびサービス情報は、ResumeRequestService.xamlx に含まれています。サービスは、永続性と追跡を使用するように構成されます。|ResumeRequestService|  
+|永続的なタイマー|`ResumeRequestService` は、永続的なタイマーを使用して、求人の期間を定義します \(タイムアウトになると、求人は終了します\)。|ResumeRequestService|  
+|トランザクション|<xref:System.Activities.Statements.TransactionScope> は、複数のアクティビティの実行時にデータの一貫性を保つために使用されます \(新しい履歴書の受信時\)。|ResumeRequestService|  
+|トランザクション|カスタムの永続参加要素 \(`HiringRequestPersistenceParticipant`\) とカスタムの追跡参加要素 \(`HistoryFileTrackingParticipant`\) では、同じトランザクションを使用します。|HiringRequestService|  
+|[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションでの [!INCLUDE[wf1](../../../../includes/wf1-md.md)] の使用|ワークフローは 2 つの [!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] アプリケーションからアクセスされます。|InternalClient \/ CareersWebSite|  
+  
+## データ ストレージ  
+ データは、`ContosoHR` という名前の SQL Server データベースに保存されます \(このデータベースを作成するためのスクリプトは `DbSetup` フォルダーにあります\)。ワークフロー インスタンスは `InstanceStore` という名前の SQL Server データベースに保存されます \(インスタンス ストアを作成するためのスクリプトは [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] の配布に含まれています\)。  
+  
+ 両方のデータベースとも、[!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] コマンド プロンプトの Setup.cmd スクリプトを実行して作成されます。  
+  
+## サンプルの実行  
+  
+#### データベースを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] コマンド プロンプトを開きます。  
+  
+2.  サンプル フォルダーに移動します。  
+  
+3.  Setup.cmd を実行します。  
+  
+4.  2 つのデータベース \(`ContosoHR` と `InstanceStore`\) が SQL Express に作成されたことを確認します。  
+  
+#### ソリューションの実行を設定するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を管理者として実行します。HiringRequest.sln を開きます。  
+  
+2.  **ソリューション エクスプローラー**で、ソリューションを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+3.  オプション **\[マルチ スタートアップ プロジェクト\]** を選択して、**\[CareersWebSite\]**、**\[InternalClient\]**、**\[HiringRequestService\]**、および **\[ResumeRequestService\]** を **\[開始\]** に設定します。**\[ContosoHR\]**、**\[InboxService\]**、および **\[OrgService\]** は \[なし\] のままにしておいてください。  
+  
+4.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。ビルドが成功したことを確認します。  
+  
+#### ソリューションを実行するには  
+  
+1.  デバッグを行わない場合は、ソリューションのビルド後、Ctrl キーを押しながら F5 キーを押してソリューションを実行します。すべてのサービスが開始されたことを確認します。  
+  
+2.  ソリューションで **\[InternalClient\]** を右クリックし、**\[ブラウザーで表示\]** をクリックします。`InternalClient` の既定のページが表示されます。サービスが実行中であることを確認し、リンクをクリックします。  
+  
+3.  **HiringRequest** モジュールが表示されます。詳細については、以下のシナリオを参照してください。  
+  
+4.  `HiringRequest` が完了すると、`ResumeRequest` を開始できます。詳細については、以下のシナリオを参照してください。  
+  
+5.  `ResumeRequest` は、投稿されると、パブリック Web サイト \(Contoso Careers Web サイト\) で使用可能になります。求人を確認するには \(さらに、応募するには\)、Careers Web サイトに移動します。  
+  
+6.  ソリューションで **\[CareersWebSite\]** を右クリックし、**\[ブラウザーで表示\]** をクリックします。  
+  
+7.  ソリューションで **\[InternalClient\]** を右クリックし、**\[ブラウザーで表示\]** をクリックして、`InternalClient` に戻ります。  
+  
+8.  受信トレイのトップ メニューの **\[求人\]** をクリックし、**\[JobPostings\]** セクションに移動します。詳細については、以下のシナリオを参照してください。  
+  
+## シナリオ  
+  
+### 雇用要求  
+  
+1.  Michael Alexander \(ソフトウェア エンジニア\) は、エンジニアリング部において、C\# の分野で 3 年以上の実務経験を持つ SDET \(Software Engineer in Test\) を採用するための新たな求人を要求します。  
+  
+2.  要求を作成すると、その要求が Michael の受信トレイに表示されます \(要求が表示されない場合は、**\[更新\]** をクリックします\)。 Michael のマネージャーである Peter Brehm の承認を待っている状態です。  
+  
+3.  Peter は、Michael の要求に対応します。Peter は、この職種で要求される C\# の実務経験は 3 年ではなく 5 年であると考え、その旨を知らせるコメントを送信します。  
+  
+4.  Michael は、Peter からのメッセージを受信し、これに対応します。Michael は、求人要求の履歴を確認し、Peter の意見に同意します。Michael は、求人要求の C\# の実務経験に関する説明を 5 年に変更し、その変更を受け入れます。  
+  
+5.  Peter は、Michael の変更済みの要求を確認し、これを受け入れます。ここで、要求は、エンジニアリング部長 Tsvi Reiter の承認が必要になります。  
+  
+6.  Tsvi Reiter は、要求に多くの時間をかけることができないため、要求が緊急であることと、この要求を受け入れることをコメントします。  
+  
+7.  ここで、要求は、2 人の HR マネージャーまたは CEO の承認が必要になります。CEO である Brian Richard Goldstein は Tsvi による緊急要求を確認します。Brian Richard Goldstein は、これを受け入れ、2 人の HR マネージャーによる承認を省略して、要求に対応します。  
+  
+8.  要求は Michael の受信トレイから削除され、SDET を雇用するためのプロセスが開始されます。  
+  
+### 履歴書の要求の開始  
+  
+1.  現在、求人は、多くの人々が申し込み可能な外部 Web サイトへの投稿を待っている状態です \(**\[求人\]** リンクをクリックすると、確認できます\)。現在、この求人は、求人を決定して掲載する HR 担当者の最終判断を待っている状態です。  
+  
+2.  HR は、60 分のタイムアウトを設定して \(現実的には、数日または数週間になります\)、この求人を編集します \(**\[編集\]** リンクをクリックします\)。タイムアウトによって、求人は指定時間に従い外部 Web サイトに掲載されます。  
+  
+3.  編集した求人情報は、保存されると、**\[履歴書受付中\]** タブに表示されます \(新たな求人を確認するには、Web ページを更新してください\)。  
+  
+### 履歴書の収集  
+  
+1.  求人は外部の Web サイトに提示されています。求人の応募に興味がある人は、この求人に応募するために履歴書を送信することができます。  
+  
+2.  Job Postings List サービスに戻ると、これまでに応募があった履歴書を確認できます。  
+  
+3.  また、HR は履歴書の募集を停止することもできます \(適切な応募者が見つかった場合など\)。  
+  
+## トラブルシューティング  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を実行するには、管理特権が必要です。  
+  
+2.  ソリューションをビルドできない場合は、次の項目を確認してください。  
+  
+    -   `ContosoHR` への参照が `InternalClient` プロジェクトまたは `CareersWebSite` プロジェクトにある。  
+  
+3.  ソフトウェアを実行できない場合は、次の項目を確認してください。  
+  
+    1.  すべてのサービスが実行中である。  
+  
+    2.  サービス参照が更新されている。  
+  
+        1.  App\_WebReferences フォルダーを開きます。  
+  
+        2.  **\[Contoso\]** を右クリックし、**\[Web 参照またはサービス参照を更新する\]** をクリックします。  
+  
+        3.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] で、Ctrl キーと Shift キーを押しながら B キーを押してソリューションをリビルドします。  
+  
+## アンインストール  
+  
+1.  DbSetup フォルダーにある Cleanup.bat を実行して SQL Server インスタンス ストアを削除します。  
+  
+2.  ハード ドライブからソース コードを削除します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/ifelse-with-rules.md b/docs/framework/windows-workflow-foundation/samples/ifelse-with-rules.md
new file mode 100644
index 00000000000..0f7cd87f53a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/ifelse-with-rules.md
@@ -0,0 +1,47 @@
+---
+title: "ルール付き IfElse | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c4ad9bb2-9037-413a-8b14-59ed7b927a9e
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ルール付き IfElse
+このサンプルでは、ルール条件を <xref:System.Workflow.Activities.IfElseActivity> アクティビティで使用する方法を示します。  
+  
+ このサンプルでは、ホストから `OrderValue` パラメータが渡されます。このパラメータの値は、<xref:System.Workflow.Activities.IfElseActivity> アクティビティの最初の分岐のルール条件で使用されます。値が 10,000 未満の場合は最初の分岐が実行され、最初の分岐内の <xref:System.Workflow.Activities.CodeActivity> アクティビティによってコンソールに **Get Manager Approval** が出力されます。値が 10,000 より大きい場合は、2 番目の分岐内の <xref:System.Workflow.Activities.CodeActivity> アクティビティが実行され、コンソールに **Get VP Approval** が出力されます。  
+  
+### サンプルをビルドするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、ソリューションをデバッグなしで実行します。  
+  
+### サンプルを実行するには  
+  
+-   \[SDK コマンド プロンプト\] ウィンドウで、IfElseWithRules\\bin\\debug フォルダー \(Visual Basic バージョンのサンプルの場合は IfElseWithRules\\bin フォルダー\) にある .exe ファイルを実行します。このフォルダーは、サンプルのメイン フォルダーの下に作成されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Rules\IfElseWithRules`  
+  
+## 参照  
+ <xref:System.Workflow.Activities.Rules>   
+ <xref:System.Workflow.Activities.IfElseActivity>   
+ <xref:System.Workflow.Activities.CodeActivity>   
+ <xref:System.Workflow.Activities.Rules.RuleDefinitions>
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/index.md b/docs/framework/windows-workflow-foundation/samples/index.md
new file mode 100644
index 00000000000..3b88b2c1ce4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/index.md
@@ -0,0 +1,35 @@
+---
+title: "Windows Workflow (WF) のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0aef017-4381-4f2f-a904-6e1ed898687e
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# Windows Workflow (WF) のサンプル
+これらのサンプルでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] のさまざまな特性について説明します。  
+  
+ このサンプルは、[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkId=150780) からダウンロードできます。  
+  
+> [!NOTE]
+>  これらの例は [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] と [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] で作成されていますが、[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)]、および [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] と互換性があります。[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] の追加の例は、[Codeplex](http://aka.ms/WF45Samples) を参照してください。  
+  
+## このセクションの内容  
+ [アプリケーション](../../../../docs/framework/windows-workflow-foundation/samples/application.md)  
+ ワークフロー アプリケーションに関連するサンプルが用意されています。  
+  
+ [Basic](../../../../docs/framework/windows-workflow-foundation/samples/basic.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] の基本的な機能を示すサンプルが用意されています。  
+  
+ [シナリオ](../../../../docs/framework/windows-workflow-foundation/samples/scenario.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] のシナリオの例が用意されています。  
+  
+ このセクションに含まれているサンプルでは、C\# 3.0 の新機能を利用します。C\# 3.0 の新機能に精通していない場合、その詳細については、「[C\# 3.0 の概要](http://go.microsoft.com/fwlink/?LinkId=193972)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/interop-with-3-5-rule-set.md b/docs/framework/windows-workflow-foundation/samples/interop-with-3-5-rule-set.md
new file mode 100644
index 00000000000..3ac97e6fe3a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/interop-with-3-5-rule-set.md
@@ -0,0 +1,87 @@
+---
+title: "3.5 ルール セットとの相互運用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 969f3295-d874-428c-a9c6-623e3d578e51
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 3.5 ルール セットとの相互運用
+このサンプルでは、<xref:System.Activities.Statements.Interop> アクティビティを使用して、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] とルールを使用する <xref:System.Workflow.Activities.Policy> のカスタム アクティビティと統合する例を示します。  このサンプルでは、カスタム アクティビティで公開されている依存プロパティに [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] 変数をバインドすることで、カスタム アクティビティにデータを渡します。  
+  
+## 必要条件  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)]  
+  
+2.  [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)]  
+  
+3.  [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)]  
+  
+## 使用例  
+ <xref:System.Activities.Statements.Interop> アクティビティ、依存プロパティを使用する <xref:System.Workflow.Activities.Policy> の [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] アクティビティ  
+  
+## 説明  
+ このサンプルでは、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] アクティビティと統合するための統合シナリオの 1 つを示します。  このサンプルには、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] アクティビティを呼び出す <xref:System.Workflow.Activities.Policy> カスタム アクティビティが含まれています。  
+  
+## TravelRuleLibrary  
+ デザイナーで TravelRuleSet.cs を開くと、次のようにポリシー アクティビティを含むカスタムのシーケンシャル アクティビティが示されます。  
+  
+ ![相互運用アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulespolicy.jpg "InteropRulesPolicy")  
+  
+ ルールを検証するには、**DiscountPolicy** ポリシー アクティビティをダブルクリックします。  ルール エディターが表示され、ルールが表示されます。  
+  
+ ![規則セット エディター](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulesruleseteditor.jpg "InteropRulesRuleSetEditor")  
+  
+ このアクティビティと共に使用されるコード側 C\# コードを検証するには、**DiscountPolicy** アクティビティを右クリックして **\[コードの表示\]** をクリックします。  `DiscountLevel` の依存関係プロパティの設定を確認します。  これは、<xref:System.Activities.Argument> の [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] と同じです。  
+  
+```  
+public static DependencyProperty DiscountLevelProperty = DependencyProperty.Register("DiscountLevel", typeof(int), typeof(TravelRuleSet));  
+  
+[DescriptionAttribute("DiscountLevel")]  
+[CategoryAttribute("DiscountLevel Category")]  
+[BrowsableAttribute(true)]  
+[DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Visible)]  
+public int DiscountLevel  
+{  
+   get  
+   {  
+return ((int)base.GetValue(TravelRuleSet.DiscountLevelProperty)));  
+   }  
+   set  
+   {  
+base.SetValue(TravelRuleSet.DiscountLevelProperty, value);  
+   }  
+}  
+```  
+  
+## InteropWith35RuleSet  
+ これは、[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] アクティビティを使用して、TravelRuleLibrary プロジェクトで作成されたカスタム ルール セットと統合する <xref:System.Activities.Statements.Interop> シーケンシャル ワークフロー プロジェクトです。  変数は、次のように最上位レベルの <xref:System.Activities.Statements.Sequence> で作成されます。  
+  
+ ![変数](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulesvariables.jpg "InteropRulesVariables")  
+  
+ ![ソリューション エクスプローラー](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulessolutionexplorer.jpg "InteropRulesSolutionExplorer")  
+  
+ 最後に、<xref:System.Activities.Statements.Interop> アクティビティは、TravelRuleSet と統合するために使用されます。  <xref:System.Activities.Statements.Sequence> で事前に宣言された変数は、依存プロパティにバインドするために使用されます。  
+  
+ ![アクティビティの種類](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprules.jpg "InteropRules")  
+  
+ ![矢印](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulesarrow.jpg "InteropRulesArrow")  
+  
+ ![プロパティ](../../../../docs/framework/windows-workflow-foundation/samples/media/interoprulesproperties.jpg "InteropRulesProperties")  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\InteropWith35RuleSet`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/invokemethod.md b/docs/framework/windows-workflow-foundation/samples/invokemethod.md
new file mode 100644
index 00000000000..460e625cc74
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/invokemethod.md
@@ -0,0 +1,77 @@
+---
+title: "InvokeMethod | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04988eb3-65f8-456d-b1bd-509f5d05a57c
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# InvokeMethod
+このサンプルでは、<xref:System.Activities.Statements.InvokeMethod> アクティビティを使用してクラスのメソッドを呼び出すさまざまな方法を示します。  
+  
+ メソッドはクラスに属し、含まれる操作のセットを表します。<xref:System.Activities.Statements.InvokeMethod> アクティビティを使用すると、オブジェクトまたは型に対してメソッドを呼び出し、パラメーターを渡して、戻り値を取得できます。メソッドは、同期または非同期に呼び出すことができます。  
+  
+## サンプルの詳細  
+ このサンプルでは、<xref:System.Activities.Statements.InvokeMethod> アクティビティを使用して次のシナリオを実行します。  
+  
+1.  パラメーターを指定せずにインスタンス メソッドを呼び出します。  
+  
+2.  2 つのパラメーター \(<xref:System.String> と <xref:System.Int32>\) を指定してインスタンス メソッドを呼び出します。  
+  
+3.  2 つのパラメーター \(<xref:System.String> と <xref:System.Int32>\) および <xref:System.String>\[\] 型のパラメーター配列を指定してインスタンス メソッドを呼び出します。  
+  
+4.  <xref:System.Int32> 型の 2 つのパラメーターおよび <xref:System.Int32> 型の結果を指定してインスタンス メソッドを呼び出します。このシナリオでは、結果値は変数にバインドされ、別のアクティビティで使用されます。この値は、<xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに表示されます。  
+  
+5.  <xref:System.String> 型と <xref:System.Int32> 型の 2 つのパラメーターを指定して静的メソッドを呼び出します。  
+  
+6.  <xref:System.String> 型の 1 つのジェネリック パラメーターを指定してインスタンス メソッドを呼び出します。  
+  
+7.  <xref:System.String> 型と <xref:System.Int32> 型の 2 つのジェネリック パラメーターを指定して静的メソッドを呼び出します。  
+  
+8.  <xref:System.String> 型の参照渡しされる 1 つのパラメーターを持つインスタンス メソッドを呼び出します。このシナリオでは、参照パラメーターは変数 \(`outParam`\) にバインドされ、別のアクティビティで使用されます。この値は、<xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに表示されます。  
+  
+9. 非同期インスタンス メソッドを呼び出します。  
+  
+10. 2 つの <xref:System.Activities.Statements.InvokeMethod> アクティビティを使用して、1 つのオブジェクトの同じインスタンスで 2 つの異なるメソッドを呼び出します。  
+  
+11. オブジェクトのインスタンスに値を格納します。  
+  
+12. オブジェクトのインスタンスから値を取得します。  
+  
+## このサンプルを使用するには  
+ このサンプルには、2 つのバージョンが用意されています。このサンプルの第 1 のバージョンでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] プログラミング モデルを使用して、C\# コードから <xref:System.Activities.Statements.InvokeMethod> を使用する方法を示します。これは、CodedWorkflow\\CS フォルダーにあります。第 2 のバージョンでは、XAML で <xref:System.Activities.Statements.InvokeMethod> を使用する方法を示します。これは、DesignerWorkflow\\CS フォルダーにあります。  
+  
+#### コード化されたワークフロー サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CodedWorkflow\\CS フォルダーにある InvokeMethodUsage.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+#### デザイナー ワークフロー サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、DesignerWorkflow\\CS フォルダーにある InvokeMethodUsage.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\InvokeMethod`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/linq-message-query-correlation.md b/docs/framework/windows-workflow-foundation/samples/linq-message-query-correlation.md
new file mode 100644
index 00000000000..bc2338f8694
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/linq-message-query-correlation.md
@@ -0,0 +1,49 @@
+---
+title: "LINQ メッセージ クエリの関連付け | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b746872e-57b1-4514-b337-53398a0e0deb
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# LINQ メッセージ クエリの関連付け
+このサンプルでは、システム標準の <xref:System.ServiceModel.XPathMessageQuery> ではなく、カスタムの <xref:System.ServiceModel.Dispatcher.MessageQuery> 実装を使用して、コンテンツ ベースの関連付けを実行する方法を示します。  
+  
+## 使用例  
+ カスタムの <xref:System.ServiceModel.Dispatcher.MessageQuery>、コンテンツ ベースの相関関係。  
+  
+## 説明  
+ このサンプルでは、関連付けのために <xref:System.ServiceModel.Dispatcher.MessageQuery> 基本クラスから拡張する方法を示します。カスタム実装の `LinqMessageQuery` を使用すると、XLinq を使用してメッセージ内で検索する XName を指定できます。クエリによって取得されたデータを使用して、メッセージを適切なワークフロー インスタンスにディスパッチするための相関関係キーを作成します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルでは、HTTP エンドポイントを使用してワークフロー サービスを公開します。このサンプルを実行するには、適切な URL ACL を追加する必要があります \(詳細については、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照\)。適切な ACL を追加するには、Visual Studio を管理者として実行するか、権限のレベルが高いプロンプトで次のコマンドを実行します。ドメインとユーザー名は置き換えてください。  
+  
+    ```  
+    netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%  
+    ```  
+  
+2.  URL ACL を追加したら、次の手順を実行します。  
+  
+    1.  ソリューションをビルドします。  
+  
+    2.  ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックして、複数のスタートアップ プロジェクトを設定します。複数のスタートアップ プロジェクトとして **Service** および **Client** を \(この順序で\) 追加します。  
+  
+    3.  アプリケーションを実行します。クライアント コンソールには、注文を送信し、発注書 ID を受信した後に、注文を確認するワークフローが示されます。Service のウィンドウには、処理されている要求が示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\LinqMessageQueryCorrelation`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/linq-to-objects-activity.md b/docs/framework/windows-workflow-foundation/samples/linq-to-objects-activity.md
new file mode 100644
index 00000000000..f41e744c4ca
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/linq-to-objects-activity.md
@@ -0,0 +1,124 @@
+---
+title: "LINQ to Objects アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 403c82e8-7f2b-42f6-93cd-95c35bc76ead
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# LINQ to Objects アクティビティ
+このサンプルでは、LINQ to Objects を使用してコレクション内の要素に対してクエリを実行するアクティビティを作成する方法を示します。  
+  
+## FindInCollection のアクティビティの詳細  
+ このアクティビティでは、LINQ to Objects を使用してメモリ内のコレクションの要素に対してクエリを実行できます。LINQ 述語をラムダ式のフォームで指定して、結果をフィルター処理する必要があります。このアクティビティは、<xref:System.Activities.Statements.AddToCollection%601> アクティビティと組み合わせて使用することができます。  
+  
+ 次の表で、アクティビティのプロパティと戻り値について詳しく説明します。  
+  
+|プロパティ値または戻り値|説明|  
+|------------------|--------|  
+|`Collection` プロパティ|ソース コレクションを指定する必須のプロパティ|  
+|`Predicate` プロパティ|コレクションのフィルターをラムダ式のフォームで指定する必須のプロパティ|  
+|戻り値|フィルター処理されたコレクション|  
+  
+## カスタム アクティビティを使用するコード サンプル  
+ 次のコード例では、`FindInCollection` カスタム アクティビティを使用して、`Role` プロパティと `Location` プロパティがそれぞれ `Manager` と `Redmond` に設定されている従業員のコレクションのすべての行を検索します。  
+  
+```csharp  
+// Find all program managers in Redmond in the employees collection.  
+  
+Activity wf = new FindInCollection<Employee>  
+{  
+    Collections = new LambdaValue<IEnumerable<Employee>>(c => employees),                
+    Predicate = new LambdaValue<Func<Employee, bool>>(c => new Func<Employee, bool>(e => e.Role.Equals("Manager") && e.Location.Equals("Redmond")))  
+};  
+  
+```  
+  
+ 次のコードでは、カスタム FindInCollection アクティビティ、<xref:System.Activities.Statements.AddToCollection%601>、および <xref:System.Activities.Statements.ForEach%601> アクティビティを使用して、コレクションに従業員を挿入し、ロールが開発者で勤務地が Redmond である従業員をすべて検索して、生成されたリストを反復処理するワークフロー プログラムを作成する方法を示します。  
+  
+```csharp  
+// Create the Linq predicate for the find expression  
+  
+Func<Employee, bool> predicate = e => e.Role == "DEV" && e.Location.Equals("Redmond");  
+  
+// Create workflow program  
+Activity sampleWorkflow = new Sequence  
+{  
+    Variables = { employees, devsFromRedmond },  
+    Activities =  
+    {  
+        new Assign<IList<Employee>>  
+        {  
+            To = employees,  
+            Value = new LambdaValue<IList<Employee>>(c => new List<Employee>())  
+        },  
+        new AddToCollection<Employee>  
+        {  
+            Collection = new InArgument<ICollection<Employee>>(employees),  
+            Item =  new LambdaValue<Employee>(c => new Employee(1, "Employee 1", "DEV", "Redmond"))  
+        },  
+        new AddToCollection<Employee>  
+        {  
+            Collection = new InArgument<ICollection<Employee>>(employees),  
+            Item =  new LambdaValue<Employee>(c => new Employee(2, "Employee 2", "DEV", "Redmond"))  
+        },  
+        new AddToCollection<Employee>  
+        {  
+            Collection = new InArgument<ICollection<Employee>>(employees),  
+            Item =  new LambdaValue<Employee>(c => new Employee(3, "Employee 3", "PM", "Redmond"))  
+        },  
+        new AddToCollection<Employee>  
+        {  
+            Collection = new InArgument<ICollection<Employee>>(employees),  
+            Item =  new LambdaValue<Employee>(c => new Employee(4, "Employee 4", "PM", "China"))  
+        },  
+        new FindInCollection<Employee>  
+        {  
+            Collections = new InArgument<IEnumerable<Employee>>(employees),  
+            Predicate = new LambdaValue<Func<Employee, bool>>(c => predicate),  
+            Result = new OutArgument<IList<Employee>>(devsFromRedmond)  
+        },  
+        new ForEach<Employee>  
+        {  
+            Values = new InArgument<IEnumerable<Employee>>(devsFromRedmond),  
+            Body = new ActivityAction<Employee>  
+            {  
+                Argument = iterationVariable,  
+                Handler = new WriteLine  
+                {  
+                    Text = new InArgument<string>(env => iterationVariable.Get(env).ToString())  
+                }  
+            }  
+        }  
+    }  
+};  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、LinqToObjects.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\Linq\LinqToObjects`  
+  
+## 参照  
+ [ラムダ式 \(C\# プログラミング ガイド\)](http://go.microsoft.com/fwlink/?LinkId=150381)   
+ [LINQ to Objects](http://go.microsoft.com/fwlink/?LinkID=150380)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/linq-to-sql-sample.md b/docs/framework/windows-workflow-foundation/samples/linq-to-sql-sample.md
new file mode 100644
index 00000000000..36099d490f1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/linq-to-sql-sample.md
@@ -0,0 +1,100 @@
+---
+title: "LINQ to SQL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5f39db9e-0e62-42c9-8c98-bb8b54cec98c
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# LINQ to SQL
+このサンプルでは、SQL Server データベース内のテーブルの LINQ to SQL クエリ エンティティを使用するアクティビティを作成する方法を示します。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\Samples\WCFWFCardspace`  
+>   
+>  このディレクトリが存在しない場合は、このページの上部にあるサンプルのダウンロードのリンクをクリックします。このリンクをクリックすると、[!INCLUDE[wf1](../../../../includes/wf1-md.md)]、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)]、および [!INCLUDE[infocard](../../../../includes/infocard-md.md)] のサンプルがすべてダウンロードおよびインストールされます。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\Samples\WCFWFCardSpace\WF\Scenario\ActivityLibrary\Linq\LinqToSql`  
+  
+## FindInSqlTable のアクティビティの詳細  
+ このアクティビティでは、LINQ to SQL を使用してデータベース内のテーブルのエンティティに対してクエリを実行できます。アクティビティのユーザーは、LINQ 述語をラムダ式のフォームで指定して、結果をフィルター処理することもできます。述語を指定しない場合、テーブル全体が返されます。次の表で、アクティビティのプロパティと戻り値について詳しく説明します。  
+  
+|プロパティ値または戻り値|説明|  
+|------------------|--------|  
+|`Collection` プロパティ|ソース コレクションを指定する必須のプロパティ|  
+|`Predicate` プロパティ|コレクションのフィルターをラムダ式のフォームで指定する必須のプロパティ|  
+|戻り値|フィルター処理されたコレクション|  
+  
+## カスタム アクティビティを使用するコード サンプル  
+ `FindInSqlTable` カスタム アクティビティを使用して、`Employee` という名前の SQL Server テーブルで `Role` 列が `SDE` になっている行をすべて検索するコード例を次に示します。  
+  
+```csharp  
+  
+new FindInSqlTable<Employee>   
+{  
+    ConnectionString = @"Data Source=.\SQLExpress;Initial Catalog=LinqToSqlSample;Integrated Security=True",                          
+    Predicate = new LambdaValue<Func<Employee, bool>>(c => new Func<Employee, bool>(emp => emp.Role.Equals("SDE"))),  
+    Result = new OutArgument<IList<Employee>>(employees)  
+},  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  このサンプルが含まれるフォルダーに移動します。  
+  
+3.  Setup.cmd コマンド ファイルを実行します。  
+  
+    > [!NOTE]
+    >  Setup.cmd スクリプトは、ローカル コンピューターに SQL Server Express のサンプル データベースをインストールしようとします。他の SQL Server インスタンスにインストールする場合は、Setup.cmd を編集します。  
+  
+     Setup.cmd スクリプトでは、次の操作を実行します。  
+  
+    -   LinqToSqlSample という名前のデータベースを作成します。  
+  
+    -   Roles テーブルを作成します。  
+  
+    -   Employees テーブルを作成します。  
+  
+    -   3 個のレコードを Roles テーブルに挿入します。  
+  
+    -   12 個のレコードを Employees テーブルに挿入します。  
+  
+4.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、LinqToSQL.sln ソリューション ファイルを開きます。  
+  
+5.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+6.  ソリューションを実行するには、F5 キーを押します。  
+  
+#### LinqToSql サンプル データベースをアンインストールするには  
+  
+1.  コマンド プロンプトを開きます。  
+  
+2.  このサンプルが含まれるフォルダーに移動します。  
+  
+3.  Cleanup.cmd コマンド ファイルを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\Liiinq\LinqToSql`  
+  
+## 参照  
+ [LINQ to SQL](http://go.microsoft.com/fwlink/?LinkId=150376)   
+ [概要 \(LINQ to SQL\)](http://go.microsoft.com/fwlink/?LinkId=150377)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/load-from-xaml.md b/docs/framework/windows-workflow-foundation/samples/load-from-xaml.md
new file mode 100644
index 00000000000..671e426a2d1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/load-from-xaml.md
@@ -0,0 +1,37 @@
+---
+title: "XAML からの読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1f103ef6-7bed-4f16-ae52-9e665c5a43d7
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# XAML からの読み込み
+このサンプルでは、XamlBuildTask ツールを実行することなく、XAML ワークフローを動的に読み込む方法を示します。代わりに、このサンプルでは <xref:System.Activities.XamlIntegration.ActivityXamlServices.Load%2A> メソッドを呼び出します。このサンプルは、<xref:System.Activities.XamlIntegration.ActivityXamlServices> クラスを使用して XAML ワークフローを読み込み、その XAML ワークフローを実行する [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] クライアント アプリケーションです。<xref:System.Activities.XamlIntegration.ActivityXamlServices> クラスを使用して XAML ワークフローが読み込まれると、実行可能な <xref:System.Activities.DynamicActivity%601> が返されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、LoadFromXAML.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\DynamicActivity\LoadFromXAML`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/media/71f08d57-e8f2-499e-8151-ece2cbdcabfd.gif b/docs/framework/windows-workflow-foundation/samples/media/71f08d57-e8f2-499e-8151-ece2cbdcabfd.gif
new file mode 100644
index 00000000000..65d1a1a9fc5
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/71f08d57-e8f2-499e-8151-ece2cbdcabfd.gif differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/approvalprocess.jpg b/docs/framework/windows-workflow-foundation/samples/media/approvalprocess.jpg
new file mode 100644
index 00000000000..0deb08d4e86
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/approvalprocess.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprules.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprules.jpg
new file mode 100644
index 00000000000..8b50fa5a69c
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprules.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulesarrow.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulesarrow.jpg
new file mode 100644
index 00000000000..09c2f2f7767
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulesarrow.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulespolicy.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulespolicy.jpg
new file mode 100644
index 00000000000..fa7880841ff
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulespolicy.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulesproperties.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulesproperties.jpg
new file mode 100644
index 00000000000..ba692288844
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulesproperties.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulesruleseteditor.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulesruleseteditor.jpg
new file mode 100644
index 00000000000..0b5dd02168b
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulesruleseteditor.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulessolutionexplorer.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulessolutionexplorer.jpg
new file mode 100644
index 00000000000..dc8aa4d5aef
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulessolutionexplorer.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/interoprulesvariables.jpg b/docs/framework/windows-workflow-foundation/samples/media/interoprulesvariables.jpg
new file mode 100644
index 00000000000..e4ceeaa7d48
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/interoprulesvariables.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/rulesetbrowser.gif b/docs/framework/windows-workflow-foundation/samples/media/rulesetbrowser.gif
new file mode 100644
index 00000000000..8b81b78027b
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/rulesetbrowser.gif differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/ruleseteditor.gif b/docs/framework/windows-workflow-foundation/samples/media/ruleseteditor.gif
new file mode 100644
index 00000000000..c2e9864121c
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/ruleseteditor.gif differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/rulesetselector.gif b/docs/framework/windows-workflow-foundation/samples/media/rulesetselector.gif
new file mode 100644
index 00000000000..11e0929be10
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/rulesetselector.gif differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/rulesettoolkitsampleoverview.gif b/docs/framework/windows-workflow-foundation/samples/media/rulesettoolkitsampleoverview.gif
new file mode 100644
index 00000000000..abb02b498c8
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/rulesettoolkitsampleoverview.gif differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/waitforinputdesigner.jpg b/docs/framework/windows-workflow-foundation/samples/media/waitforinputdesigner.jpg
new file mode 100644
index 00000000000..e3ba9d5136e
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/waitforinputdesigner.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/waitforinputtoolbox.jpg b/docs/framework/windows-workflow-foundation/samples/media/waitforinputtoolbox.jpg
new file mode 100644
index 00000000000..a66da6453bd
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/waitforinputtoolbox.jpg differ
diff --git a/docs/framework/windows-workflow-foundation/samples/media/workflowdesignerarch.JPG b/docs/framework/windows-workflow-foundation/samples/media/workflowdesignerarch.JPG
new file mode 100644
index 00000000000..d0013d1c6b2
Binary files /dev/null and b/docs/framework/windows-workflow-foundation/samples/media/workflowdesignerarch.JPG differ
diff --git a/docs/framework/windows-workflow-foundation/samples/metadata-store-programmability.md b/docs/framework/windows-workflow-foundation/samples/metadata-store-programmability.md
new file mode 100644
index 00000000000..e15fc6d76a3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/metadata-store-programmability.md
@@ -0,0 +1,47 @@
+---
+title: "メタデータ ストアのプログラム性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5b613661-f3f9-4e07-8e88-28c9ea2fd8f8
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# メタデータ ストアのプログラム性
+メタデータ ストアは、実行時に任意のメタデータを CLR 属性の形式で型に関連付けることができる [!INCLUDE[wfd1](../../../../includes/wfd1-md.md)]機能です。これにより、実行時コンポーネントと対応するデザイン時コンポーネントの間の疎結合、および実行時コンポーネントに影響を与えることなくデザイン時コンポーネントを変更する機能が実現します。このサンプルでは、属性を実行時の型に適用することで、メタデータ ストアを使用して制御できないソースをプログラミングする方法を示します。通常使用されるこの用語は、ホスト アプリケーションによって型セットのメタデータが登録されることを示します。  
+  
+ 出力内に、追加の予期しない属性 <xref:System.Runtime.InteropServices.GUIDAttribute> がある場合があります。これはメタデータ API の使用時に追加されるもので、サンプルの実行には影響しません。  
+  
+ このサンプルでは、次の方法を示します。  
+  
+## 使用例  
+  
+-   メタデータ ストア API を使用して属性を挿入する方法。  
+  
+-   コールバック メカニズムを使用してメタデータの登録を遅らせる方法。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ProgrammingMetadataStore.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CustomActivityDesigners\MetadataStore`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/migration.md b/docs/framework/windows-workflow-foundation/samples/migration.md
new file mode 100644
index 00000000000..a96fc325ce3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/migration.md
@@ -0,0 +1,25 @@
+---
+title: "移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51ca5be7-94dc-4bed-a206-f57c898cf078
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# 移行
+このセクションには、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] で記述された [!INCLUDE[wf](../../../../includes/wf-md.md)] コンテンツを [!INCLUDE[netfx40_short](../../../../includes/netfx40-short-md.md)] に移行する方法を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [.NET Framework 4.5 ワークフローでの .NET Framework 3.0 または .NET Framework 3.5 アクティビティの使用](../../../../docs/framework/windows-workflow-foundation/samples/using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md)  
+ <xref:System.Activities.Statements.Interop> アクティビティを使用して、文字列をカスタムの [!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] アクティビティに引数として渡す方法を示します。  
+  
+ [External Data Exchange での Interop の使用](../../../../docs/framework/windows-workflow-foundation/samples/using-interop-with-external-data-exchange.md)  
+ WF4 ワークフロー サービスの <xref:System.Activities.Statements.Interop> アクティビティを使用して、<xref:System.Workflow.Activities.ExternalDataExchangeService> \(およびメソッドを呼び出してイベントを処理するための対応するカスタム アクティビティ\) を使用する WF3 ワークフローを設定および実行する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/nesting-of-transactionscope-within-a-service.md b/docs/framework/windows-workflow-foundation/samples/nesting-of-transactionscope-within-a-service.md
new file mode 100644
index 00000000000..842737ea1ae
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/nesting-of-transactionscope-within-a-service.md
@@ -0,0 +1,43 @@
+---
+title: "サービス内での TransactionScope の入れ子化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e7e1ba64-1384-4eba-add8-415636e2d6d0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# サービス内での TransactionScope の入れ子化
+このサンプルは、サービス内で <xref:System.Activities.Statements.TransactionScope> アクティビティ インスタンスを処理する方法を示す 2 つのシナリオで構成されます。トランザクションでは、まず <xref:System.Activities.Statements.TransactionScope> を使用してクライアント上に新しいトランザクションを作成し、<xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用してサーバー上でトランザクションを受信し、トランザクションの有効期間のスコープを設定します。サービス内の最初のシナリオでは、2 つ目の <xref:System.Activities.Statements.TransactionScope> アクティビティを実行して、サービス内で <xref:System.Activities.Statements.TransactionScope> アクティビティを入れ子にする方法を示します。2 番目のシナリオでは、入れ子になった <xref:System.Activities.Statements.TransactionScope> アクティビティ内でタイムアウトがどのように機能するかを示します。  
+  
+## クライアント アプリケーション  
+ クライアント アプリケーションは、<xref:System.Activities.Statements.TransactionScope> アクティビティの開始、分散トランザクション ID の出力、サーバーへのメッセージの送信、トランザクションのフロー、応答の受信、分散トランザクション ID の再出力、および完了処理を行うワークフローを実行します。クライアント アプリケーションは、このワークフローをサービス シナリオごとに 1 回だけ実行します。  
+  
+## サーバー アプリケーション  
+ サーバー プロジェクトは、クライアントからのメッセージをリッスンするためのエンドポイントを作成する <xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされます。ワークフローの中心は、クライアントからフローされたトランザクションを受信し、分散トランザクション ID を出力して、2 つ目の <xref:System.Activities.Statements.TransactionScope> アクティビティを実行する <xref:System.ServiceModel.Activities.TransactedReceiveScope> です。最初のシナリオでは、トランザクションは正常に完了します。2 番目のシナリオでは、<xref:System.Activities.Statements.TransactionScope> アクティビティの本体は 5 秒の遅延で、トランザクションのタイムアウトは 2 秒に設定されています。トランザクションがタイムアウトすると、トランザクションは中止されます。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で TransactionServiceExample.sln ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+3.  ビルドが完了したら、ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。ダイアログ ボックスで、**\[マルチ スタートアップ プロジェクト\]** を選択し、両方のプロジェクトのアクションが **\[開始\]** になっていることを確認します。  
+  
+4.  F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Transactions\TRSComposability`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/non-generic-foreach.md b/docs/framework/windows-workflow-foundation/samples/non-generic-foreach.md
new file mode 100644
index 00000000000..c3f936b9f8e
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/non-generic-foreach.md
@@ -0,0 +1,118 @@
+---
+title: "非ジェネリックの ForEach | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 576cd07a-d58d-4536-b514-77bad60bff38
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# 非ジェネリックの ForEach
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] のツールボックスには、制御フロー アクティビティのセットが用意されています。これには、<xref:System.Activities.Statements.ForEach%601> コレクションを反復処理できる <xref:System.Collections.IEnumerable%601> が含まれています。  
+  
+ <xref:System.Activities.Statements.ForEach%601> では、その <xref:System.Activities.Statements.ForEach%601.Values%2A> プロパティを <xref:System.Collections.IEnumerable%601> 型にする必要があります。  このため、ユーザーは、<xref:System.Collections.IEnumerable%601> インターフェイス \(<xref:System.Collections.ArrayList> など\) を実装するデータ構造を反復処理できません。  <xref:System.Activities.Statements.ForEach%601> の非ジェネリック バージョンにはこの要件はありませんが、コレクション内の値の型の互換性を確保するために実行時の複雑さが増します。  
+  
+ このサンプルでは、非ジェネリックの <xref:System.Activities.Statements.ForEach%601> アクティビティとそのデザイナーを実装する方法を示します。  このアクティビティは、<xref:System.Collections.ArrayList> の反復処理に使用できます。  
+  
+## ForEach アクティビティ  
+ C\# および VB の `foreach` ステートメントは、コレクションの要素を列挙し、コレクションの各要素に対して埋め込みステートメントを実行します。  [!INCLUDE[wf1](../../../../includes/wf1-md.md)] に相当する `foreach` のアクティビティは、<xref:System.Activities.Statements.ForEach%601> および <xref:System.Activities.Statements.ParallelForEach%601> です。  <xref:System.Activities.Statements.ForEach%601> アクティビティには、値のリストと本体が含まれます。  実行時に、リストが反復処理されて、リスト内の値ごとに本体が実行されます。  
+  
+ ほとんどの場合、ジェネリック バージョンのアクティビティを使用することをお勧めします。ジェネリック バージョンのアクティビティは、そのアクティビティを使用するシナリオの大半に対応し、コンパイル時の型チェックが実現するためです。  非ジェネリック バージョンは、非ジェネリックの <xref:System.Collections.IEnumerable> インターフェイスを実装する型を反復処理するために使用できます。  
+  
+## クラス定義  
+ 次のコード例は、非ジェネリックの `ForEach` アクティビティの定義を示しています。  
+  
+```  
+[ContentProperty("Body")]  
+public class ForEach : NativeActivity  
+{  
+    [RequiredArgument]  
+    [DefaultValue(null)]  
+    InArgument<IEnumerable> Values { get; set; }  
+  
+    [DefaultValue(null)]  
+    [DependsOn("Values")]  
+    ActivityAction<object> Body { get; set; }   
+}  
+```  
+  
+ Body \(省略可能\)  
+ コレクション内の要素ごとに実行される <xref:System.Activities.ActivityAction> 型の <xref:System.Object>。  各要素は、`Argument` プロパティを使用して Body に渡されます。  
+  
+ Values \(省略可能\)  
+ 反復処理される要素のコレクション。  コレクションのすべての要素の型が互換性のある型であることが実行時に確認されます。  
+  
+## ForEach の使用例  
+ アプリケーションでの ForEach アクティビティの使用方法を次のコードに示します。  
+  
+```  
+string[] names = { "bill", "steve", "ray" };  
+  
+DelegateInArgument<object> iterationVariable = new DelegateInArgument<object>() { Name = "iterationVariable" };  
+  
+Activity sampleUsage =  
+    new ForEach  
+    {  
+       Values = new InArgument<IEnumerable>(c=> names),  
+       Body = new ActivityAction<object>   
+       {                          
+           Argument = iterationVariable,  
+           Handler = new WriteLine  
+           {  
+               Text = new InArgument<string>(env => string.Format("Hello {0}",                                                               iterationVariable.Get(env)))  
+           }  
+       }  
+   };  
+```  
+  
+|状態|メッセージ|重大度|例外の種類|  
+|--------|-----------|---------|-----------|  
+|値が `null` である|必須のアクティビティ引数 'Values' の値が指定されませんでした。|エラー|<xref:System.InvalidOperationException>|  
+  
+## ForEach デザイナー  
+ サンプルのアクティビティ デザイナーは、組み込みの <xref:System.Activities.Statements.ForEach%601> アクティビティ用に提供されているデザイナーに外観が似ています。  このデザイナーは、ツールボックスの **\[サンプル\]** の **\[非ジェネリック アクティビティ\]** カテゴリにあります。  このデザイナーのツールボックスにおける名前は **ForEachWithBodyFactory** です。これは、適切に構成された <xref:System.Activities.Presentation.IActivityTemplateFactory> を使用してアクティビティを作成する <xref:System.Activities.ActivityAction> がツールボックスでアクティビティによって公開されるためです。  
+  
+```  
+public sealed class ForEachWithBodyFactory : IActivityTemplateFactory  
+{  
+    public Activity Create(DependencyObject target)  
+    {  
+        return new Microsoft.Samples.Activities.Statements.ForEach()  
+        {  
+            Body = new ActivityAction<object>()  
+            {  
+                Argument = new DelegateInArgument<object>()  
+                {  
+                    Name = "item"  
+                }  
+            }  
+        };  
+    }  
+}  
+```  
+  
+#### このサンプルを実行するには  
+  
+1.  選択したプロジェクトをソリューションのスタートアップ プロジェクトに設定します。  
+  
+    1.  **CodeTestClient** は、コードを使用したアクティビティの使用方法を示します。  
+  
+    2.  **DesignerTestClient** は、デザイナー内でアクティビティを使用する方法を示します。  
+  
+2.  プロジェクトをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\NonGenericForEach`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/non-generic-parallelforeach.md b/docs/framework/windows-workflow-foundation/samples/non-generic-parallelforeach.md
new file mode 100644
index 00000000000..e916b4d203c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/non-generic-parallelforeach.md
@@ -0,0 +1,122 @@
+---
+title: "非ジェネリックの ParallelForEach | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: de17e7a2-257b-48b3-91a1-860e2e9bf6e6
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 非ジェネリックの ParallelForEach
+[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] のツールボックスには、制御フロー アクティビティのセットが用意されています。これには、<xref:System.Activities.Statements.ParallelForEach%601> コレクションを反復処理できる <xref:System.Collections.IEnumerable%601> が含まれています。  
+  
+ <xref:System.Activities.Statements.ParallelForEach%601> では、その <xref:System.Activities.Statements.ParallelForEach%601.Values%2A> プロパティを <xref:System.Collections.IEnumerable%601> 型にする必要があります。  このため、ユーザーは、<xref:System.Collections.IEnumerable%601> インターフェイス \(<xref:System.Collections.ArrayList> など\) を実装するデータ構造を反復処理できません。  <xref:System.Activities.Statements.ParallelForEach%601> の非ジェネリック バージョンにはこの要件はありませんが、コレクション内の値の型の互換性を確保するために実行時の複雑さが増します。  
+  
+ このサンプルでは、非ジェネリックの <xref:System.Activities.Statements.ParallelForEach%601> アクティビティとそのデザイナーを実装する方法を示します。  このアクティビティは、<xref:System.Collections.ArrayList> の反復処理に使用できます。  
+  
+## ParallelForEachT アクティビティ  
+ C\# および VB の `foreach` ステートメントは、コレクションの要素を列挙し、コレクションの各要素に対して埋め込みステートメントを実行します。  このステートメントに相当する [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のアクティビティは、<xref:System.Activities.Statements.ForEach%601> および <xref:System.Activities.Statements.ParallelForEach%601> です。  <xref:System.Activities.Statements.ForEach%601> アクティビティには、値のリストと本体が含まれます。  実行時に、リストが反復処理されて、リスト内の値ごとに本体が実行されます。  
+  
+ <xref:System.Activities.Statements.ParallelForEach%601> には <xref:System.Activities.Statements.ParallelForEach%601.CompletionCondition%2A> があります。そのため、<xref:System.Activities.Statements.ParallelForEach%601> の評価が <xref:System.Activities.Statements.ParallelForEach%601.CompletionCondition%2A> を返した場合、`true` アクティビティは早期に完了することがあります。  <xref:System.Activities.Statements.ParallelForEach%601.CompletionCondition%2A> は、各イテレーションの完了後に評価されます。  
+  
+ ほとんどの場合、ジェネリック バージョンのアクティビティを使用することをお勧めします。ジェネリック バージョンのアクティビティは、そのアクティビティを使用するシナリオの大半に対応し、コンパイル時の型チェックを提供するためです。  非ジェネリック バージョンは、非ジェネリックの <xref:System.Collections.IEnumerable> インターフェイスを実装する型を反復処理するために使用できます。  
+  
+## クラス定義  
+ 次のコード例は、非ジェネリックの `ParallelForEach` アクティビティの定義を示しています。  
+  
+```  
+[ContentProperty("Body")]  
+public class ParallelForEach : NativeActivity  
+{  
+    [RequiredArgument]  
+    [DefaultValue(null)]  
+    InArgument<IEnumerable> Values { get; set; }  
+  
+    [DefaultValue(null)]  
+    [DependsOn("Values")]  
+    public Activity<bool> CompletionCondition  
+    [DefaultValue(null)]  
+    [DependsOn("CompletionCondition")]  
+    ActivityAction<object> Body { get; set; }   
+}  
+```  
+  
+ Body \(省略可能\)  
+ コレクション内の要素ごとに実行される <xref:System.Activities.ActivityAction> 型の <xref:System.Object>。  各要素は、Argument プロパティを使用して Body に渡されます。  
+  
+ Values \(省略可能\)  
+ 反復処理される要素のコレクション。  コレクションのすべての要素の型が互換性のある型であることが実行時に確認されます。  
+  
+ CompletionCondition \(省略可能\)  
+ <xref:System.Activities.Statements.ParallelForEach%601.CompletionCondition%2A> プロパティは、イテレーションの完了後に評価されます。  `true` であると評価する場合、スケジュールされた保留イテレーションはキャンセルされます。  このプロパティが設定されていない場合、分岐コレクション内のすべてのアクティビティは完了するまで実行されます。  
+  
+## ParallelForEach の使用例  
+ アプリケーションでの ParallelForEach アクティビティの使用方法を次のコードに示します。  
+  
+```  
+string[] names = { "bill", "steve", "ray" };  
+  
+DelegateInArgument<object> iterationVariable = new DelegateInArgument<object>() { Name = "iterationVariable" };  
+  
+Activity sampleUsage =  
+    new ParallelForEach  
+    {  
+       Values = new InArgument<IEnumerable>(c=> names),  
+       Body = new ActivityAction<object>   
+       {                          
+           Argument = iterationVariable,  
+           Handler = new WriteLine  
+           {  
+               Text = new InArgument<string>(env => string.Format("Hello {0}",                                                               iterationVariable.Get(env)))  
+           }  
+       }  
+   };  
+```  
+  
+## ParallelForEach デザイナー  
+ サンプルのアクティビティ デザイナーは、組み込みの <xref:System.Activities.Statements.ParallelForEach%601> アクティビティ用に提供されているデザイナーに外観が似ています。  このデザイナーは、ツールボックスの **\[サンプル\]** の **\[非ジェネリック アクティビティ\]** カテゴリにあります。  このデザイナーのツールボックスにおける名前は **ParallelForEachWithBodyFactory** です。これは、適切に構成された <xref:System.Activities.Presentation.IActivityTemplateFactory> を使用してアクティビティを作成する <xref:System.Activities.ActivityAction> がツールボックスでアクティビティによって公開されるためです。  
+  
+```  
+public sealed class ParallelForEachWithBodyFactory : IActivityTemplateFactory  
+{  
+    public Activity Create(DependencyObject target)  
+    {  
+        return new Microsoft.Samples.Activities.Statements.ParallelForEach()  
+        {  
+            Body = new ActivityAction<object>()  
+            {  
+                Argument = new DelegateInArgument<object>()  
+                {  
+                    Name = "item"  
+                }  
+            }  
+        };  
+    }  
+}  
+```  
+  
+#### サンプルを実行するには  
+  
+1.  選択したプロジェクトをソリューションのスタートアップ プロジェクトに設定します。  
+  
+    1.  **CodeTestClient** は、コードを使用したアクティビティの使用方法を示します。  
+  
+    2.  **DesignerTestClient** は、デザイナー内でアクティビティを使用する方法を示します。  
+  
+2.  プロジェクトをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\NonGenericParallelForEach`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/nopersistscope-activity.md b/docs/framework/windows-workflow-foundation/samples/nopersistscope-activity.md
new file mode 100644
index 00000000000..0708ef4f195
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/nopersistscope-activity.md
@@ -0,0 +1,51 @@
+---
+title: "NoPersistScope アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9a0baeb7-a05c-4fac-b905-252758cb71bb
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# NoPersistScope アクティビティ
+このサンプルでは、ワークフローでシリアル化不可能で破棄可能な状態を処理する方法を示します。ワークフローでシリアル化不可能な状態を永続化しないようにし、破棄可能なオブジェクトをワークフローで使用した後にクリーンアップすることが重要です。  
+  
+## 使用例  
+ `NoPersistScope` カスタム アクティビティおよびデザイナー。  
+  
+## NoPersistZone アクティビティの使用  
+ サンプル ワークフローの実行時に、`CreateTextWriter` というカスタム アクティビティによって、<xref:System.IO.TextWriter> 型のオブジェクトが作成されてワークフロー変数に保存されます。<xref:System.IO.TextWriter> が <xref:System.IDisposable> オブジェクトです。この <xref:System.IO.TextWriter> は、サンプルが実行されるディレクトリにある out.txt という名前のファイルに書き込むように構成されており、コンソールで入力するテキストをエコーするときに <xref:System.Activities.Statements.WriteLine> アクティビティによって使用されます。  
+  
+ エコー ロジックは、ワークフローが永続化されないようにする `NoPersistScope` アクティビティ \(このサンプルの一部でもあるコード\) 内で実行されます。コンソールで「`unload`」と入力すると、ホストはワークフロー インスタンスを永続化しようとしますが、ワークフローは `NoPersistScope` 内に留まるので、この操作はタイムアウトします。また、ワークフローは `Dispose` というカスタム アクティビティを使用して、<xref:System.IO.TextWriter> オブジェクトを使い終わったら破棄します。`Dispose` アクティビティは、Try ブロックの実行中に例外が発生した場合でも実行されるように、<xref:System.IO.TextWriter> 変数が宣言される <xref:System.Activities.Statements.TryCatch> アクティビティの <xref:System.Activities.Statements.TryCatch.Finally%2A> ブロック内に配置されます。  
+  
+ 「`exit`」と入力すると、ワークフロー インスタンスを完了してプログラムを終了することができます。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で NoPersistZone.sln ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+3.  ビルドが完了したら、F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  SQL インスタンス ストアを削除するには、Cleanup.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\NoPersistScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/operationscope.md b/docs/framework/windows-workflow-foundation/samples/operationscope.md
new file mode 100644
index 00000000000..f7387762ebb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/operationscope.md
@@ -0,0 +1,48 @@
+---
+title: "OperationScope | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56206a21-1e63-422d-b92a-e5d8b713e707
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# OperationScope
+このサンプルでは、メッセージング アクティビティの <xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.SendReply> を使用して、既存のカスタム アクティビティをワークフロー サービス内の操作として公開する方法を示します。このサンプルには、`OperationScope` という新しいカスタム アクティビティが含まれています。このアクティビティは、ユーザーが操作の本文をカスタム アクティビティとして個別に作成できるようにし、それを `OperationScope` アクティビティを使用してサービス操作として簡単に公開できるようにすることで、ワークフロー サービスの開発を容易にするためのものです。たとえば、2 つの `in` 引数を受け取って 1 つの `out` 引数を返すカスタム `Add` アクティビティは、`OperationScope` にドロップすることでワークフロー サービスの `Add` 操作として公開できます。  
+  
+ スコープは、本文として提供されたアクティビティを調べることによって機能します。バインドされていない `in` 引数は、受信メッセージからの入力であると見なされます。`out` 引数はすべて、バインドされているかどうかに関係なく、後続の応答メッセージの出力であると見なされます。公開される操作の名前は、`OperationScope` アクティビティの表示名から取得されます。最後に、本文アクティビティは、アクティビティの引数にバインドされたメッセージからのパラメーターを使用して、<xref:System.ServiceModel.Activities.Receive> および <xref:System.ServiceModel.Activities.SendReply> にラップされます。  
+  
+ このサンプルでは、HTTP エンドポイントを使用してワークフロー サービスを公開します。サンプルを実行するには、適切な URL ACL を追加する必要があります。[!INCLUDE[crdefault](../../../../includes/crdefault-md.md)]、「[HTTP および HTTPS の構成](http://go.microsoft.com/fwlink/?LinkId=70353)」を参照してください。権限のレベルが高いプロンプトで次のコマンドを実行すると、適切な ACL が追加されます \(%DOMAIN%\\%UserName% は使用するドメインとユーザー名に置き換えてください\)。  
+  
+ **netsh http add urlacl url\=http:\/\/\+:8000\/ user\=%DOMAIN%\\%UserName%**  
+  
+### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で OperationScope.sln ソリューションを開きます。  
+  
+2.  ソリューション エクスプローラーでソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックして、複数のスタートアップ プロジェクトを設定します。複数のスタートアップ プロジェクトとして Scenario および Scenario\_Client を \(この順序で\) 追加します。  
+  
+3.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+    > [!WARNING]
+    >  カスタム アクティビティ `OperationScope` が原因で、BankService.xaml ワークフローを表示するためにこの手順が必要になります。  
+  
+4.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。Scenario\_Client コンソールで入力が求められ、対応する出力が Scenario コンソールに表示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\OperationScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/order-processing-with-policy.md b/docs/framework/windows-workflow-foundation/samples/order-processing-with-policy.md
new file mode 100644
index 00000000000..782c8a50bce
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/order-processing-with-policy.md
@@ -0,0 +1,152 @@
+---
+title: "ポリシーを使用した注文処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 66833724-dc36-4fad-86b0-59ffeaa3ba6a
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# ポリシーを使用した注文処理
+注文処理ポリシー サンプルでは、Windows WF \(Workflow Foundation\) の [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] に導入された重要な機能の一部を示しています。次の機能が WF ルール エンジンに新しく追加されました。  
+  
+-   演算子のオーバーロードのサポート。  
+  
+-   `new` 演算子のサポート。これにより、WF ルールから新しいオブジェクトおよび配列を作成できます。  
+  
+-   拡張メソッドのサポート。これにより、C\# のコーディング スタイルとの互換性を持つ拡張メソッドのWF ルールからの呼び出しが容易かつ便利になります。  
+  
+> [!NOTE]
+>  このサンプルでは、ビルドおよび実行のために [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] がインストールされていることが必要です。[!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] ではプロジェクトとソリューション ファイルを開く必要があります。  
+  
+ このサンプルでは、使用できるアイテムの番号付きリストと郵便番号で構成される顧客の注文を入力する、`OrderProcessingPolicy` プロジェクトを示します。両方の入力が正しい場合は、注文が正常に処理されますが、正しくない場合は、ポリシーによってエラー オブジェクトが作成され、オーバーロードされた `+` 演算子と定義済みの拡張メソッドによって、ユーザーにエラーが通知されます。  
+  
+> [!NOTE]
+>  拡張メソッド[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[C\# バージョン 3.0 の仕様](http://go.microsoft.com/fwlink/?LinkId=95402)」を参照してください。  
+  
+ サンプルは、以下のプロジェクトで構成されます。  
+  
+-   `OrderErrorLibrary`  
+  
+     `OrderErrorLibrary` は、`OrderError` クラスおよび `OrderErrorCollection` クラスを定義するクラス ライブラリです。`OrderError` インスタンスは、無効な入力が行われたときに作成されます。ライブラリには、`OrderErrorCollection` 内のすべての `OrderError` オブジェクトの `ErrorText` プロパティを出力する `OrderErrorCollection` クラスの拡張メソッドも用意されています。  
+  
+-   `OrderProcessingPolicy`  
+  
+     `OrderProcessingPolicy` プロジェクトは、1 つの `PolicyFromFile` アクティビティを定義する WF コンソール アプリケーションです。このアクティビティには、以下のルールがあります。  
+  
+    -   `invalidItemNum`  
+  
+         このルールでは、アイテム番号が 1 ～ 6 の範囲内かどうかが検証されます。アイテム番号が有効範囲内の場合は、コンソールへの出力を除き、処理は何も行われません。アイテム番号が 1 ～ 6 の範囲外の場合は、`invalidItemNum` ルールによって以下の処理が行われます。  
+  
+        1.  新しい `OrderError` オブジェクトを作成し、入力されたアイテム番号をこのオブジェクトに渡して、このオブジェクトの `ErrorText` プロパティおよび `CustomerName` プロパティを設定します。  
+  
+        2.  `invalidItemNumErrorCollection` オブジェクトを作成します。  
+  
+        3.  新しく作成した `OrderError` インスタンスを `invalidItemNumErrorCollection` に追加します。  
+  
+         これは、ルール内でオブジェクトのインスタンスを作成できる `new` 演算子がサポートされていることを示します。  
+  
+    -   `invalidZip`  
+  
+         このルールでは、郵便番号が 5 桁で、600 ～ 99998 の範囲内にあるかどうかを検証します。郵便番号が有効範囲内の場合は、コンソールへの出力を除き、処理は何も行われません。郵便番号が 5 桁よりも少ないか、郵便番号が 00600 ～ 99998 の範囲外の場合は、`invalidZip` ルールによって以下の処理が行われます。  
+  
+        1.  `OrderError` オブジェクトを作成し、入力された郵便番号をこのオブジェクトに渡して、このオブジェクトの `ErrorText` プロパティおよび `CustomerName` プロパティを設定します。  
+  
+        2.  `invalidZipCodeErrorCollection` オブジェクトを作成します。  
+  
+        3.  新しく作成した `OrderError` インスタンスを、新しく作成した `invalidZipCodeErrorCollection` に追加します。  
+  
+         このルールで、`new` 演算子のサポートが再度実現され、ルール内でのオブジェクトのインスタンスの作成が可能となります。  
+  
+    -   `displayErrors`  
+  
+         このルールでは、上記の 2 つの `OrderErrorCollection` オブジェクト、`invalidItemNumErrorCollection` および `invalidIZipCodeErrorCollection` の 2 つのルールによって追加されたエラーがあるかどうかを確認します。エラーがある場合 \(`invalidItemNumErrorCollection` または `invalidZipCodeErrorCollection` が `null` ではない場合\)、このルールによって以下の処理が行われます。  
+  
+        1.  オーバーロードされた `+` 演算子を呼び出して `invalidItemNumErrorCollection` と`invalidZipCodeErrorCollection` の内容を `invalidOrdersCollection``OrderErrorCollection` インスタンスにコピーします。  
+  
+        2.  `invalidOrdersCollection` の `PrintOrderErrors` 拡張メソッドを呼び出し、`invalidOrdersCollection` 内のすべての `orderError` オブジェクトの `ErrorText` プロパティを出力します。  
+  
+ `OrderErrorCollection` のオーバーロードされた `+` 演算子は、`OrderErrorLibrary` プロジェクトの `OrderErrorCollection` クラスで定義されています。この演算子は、2 つの `OrderErrorCollection` オブジェクトを受け取り、1 つの `OrderErrorCollection` オブジェクトに結合します。  
+  
+ `PrintOrderErrors` 拡張メソッドも `OrderErrorLibrary` プロジェクトで定義されています。拡張メソッドは C\# の新機能であり、開発者は、クラスの派生や元の型の再コンパイルを行わなくても、新しいメソッドを既存の CLR 型のパブリック コントラクトに追加できます。  
+  
+ サンプルを実行すると、名前、購入するアイテムの番号、および郵便番号の入力が求められます。その後、この情報は、ポリシー アクティビティで定義されているルールによって検証されます。このプログラムの出力サンプルを次に示します。  
+  
+```  
+Please enter your name: John  
+  
+What would you like to purchase?  
+        (1) Vista Ultimate DVD  
+        (2) Vista Ultimate Upgrade DVD  
+        (3) Vista Home Premium DVD  
+        (4) Vista Home Premium Upgrade DVD  
+        (5) Vista Home Basic DVD  
+        (6) Vista Home Basic Upgrade DVD  
+  
+Please enter an item number: 1  
+  
+Please enter your 5-Digit zip code: 98102  
+  
+        Executing Rule: invalidItemNum  
+        Executing Rule: invalidZip  
+        Executing Rule: displayErrors  
+  
+                              Thank you for your order, it has been processed.  
+  
+Workflow Completed  
+Another Order? (Y/N): y  
+  
+Please enter your name: Joel  
+  
+What would you like to purchase?  
+        (1) Vista Ultimate DVD  
+        (2) Vista Ultimate Upgrade DVD  
+        (3) Vista Home Premium DVD  
+        (4) Vista Home Premium Upgrade DVD  
+        (5) Vista Home Basic DVD  
+        (6) Vista Home Basic Upgrade DVD  
+  
+Please enter an item number: 8  
+  
+Please enter your 5-Digit zip code: 0000  
+  
+        Executing Rule: invalidItemNum  
+        Executing Rule: invalidZip  
+        Executing Rule: displayErrors  
+  
+                              Your order contains the following error(s)  
+  
+Error: No item number found. Please choose an available item.  
+Error: Invalid zip code. Please choose a zip code between 00600 and 99998.  
+  
+Workflow Completed  
+Another Order? (Y/N): n  
+```  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で OrderProcessingPolicy.sln プロジェクト ファイルを開きます。  
+  
+2.  このソリューションには、`OrderErrorLibrary` および `OrderProcessingPolicy` という 2 つの異なるプロジェクトが含まれています。`OrderProcessingPolicy` プロジェクトでは、`OrderErrorLibrary` プロジェクトで定義されているクラスとメソッドが使用されます。  
+  
+3.  すべてのプロジェクトをビルドします。  
+  
+4.  **\[実行\]** をクリックします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Rules\Policy\OrderProcessingPolicy`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/overloadgroups.md b/docs/framework/windows-workflow-foundation/samples/overloadgroups.md
new file mode 100644
index 00000000000..3a768bc13f3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/overloadgroups.md
@@ -0,0 +1,47 @@
+---
+title: "OverloadGroups | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d1d547d2-f5fb-4de3-a959-ee6139a4f1ad
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# OverloadGroups
+このサンプルは、次の 2 つの興味深い特性を持つアクティビティ \(`CreateLocation`\) で構成されます。  
+  
+1.  いくつかの必須の引数といくつかの省略可能な引数があります。  
+  
+2.  ユーザーは、2 つの異なる引数セットのうちのどちらを指定するかを選択できます。  
+  
+ これらの動作は、次の 2 つの機能によって実現されます。  
+  
+-   `[isRequired]` : 特定のアクティビティのプロパティが割り当てられているかどうかを検証し、割り当てられていない場合は例外をスローします。  
+  
+-   `[OverloadGroup]` : 一連の引数をまとめて、アクティビティのユーザーが 2 つのセットのうちのどちらを使用するかを選択できるようにします。ユーザーは、同じインスタンス内の異なるオーバーロード グループの引数を使用できません。  
+  
+ さまざまなワークフローを設定したら、<xref:System.Activities.Validation.ConstraintViolation> の <xref:System.Activities.Validation.ValidationResults> コレクションを返す <xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> を呼び出します。<xref:System.Activities.Validation.ConstraintViolation> オブジェクトをコンソールに出力します。  
+  
+### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で **OverloadGroups.sln** サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Validation\OverloadGroups`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/persistence.md b/docs/framework/windows-workflow-foundation/samples/persistence.md
new file mode 100644
index 00000000000..cd7277ceab2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/persistence.md
@@ -0,0 +1,31 @@
+---
+title: "永続性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79c14759-9f87-458a-b339-beec8300e339
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 永続性
+このセクションでは、[!INCLUDE[wf](../../../../includes/wf-md.md)] での永続メディアへのワークフローの永続化に関するサンプルを示します。  
+  
+## このセクションの内容  
+ [ワークフロー アプリケーションの永続化](../../../../docs/framework/windows-workflow-foundation/samples/persisting-a-workflow-application.md)  
+ <xref:System.Activities.WorkflowApplication> を実行し、アイドル状態になったときにアンロードしてから、再読み込みしてその実行を継続する方法を示します。  
+  
+ [組み込みの構成](../../../../docs/framework/windows-workflow-foundation/samples/built-in-configuration.md)  
+ SQL ワークフロー インスタンス ストアの使用法と構成を示します。  
+  
+ [SQLStoreExtensibility](../../../../docs/framework/windows-workflow-foundation/samples/sqlstoreextensibility.md)  
+ SQL ワークフロー インスタンス ストアの昇格したプロパティの使用法と構成を示します。  
+  
+ [プロパティ昇格アクティビティ](../../../../docs/framework/windows-workflow-foundation/samples/property-promotion-activity.md)  
+ このサンプルでは、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 昇格機能をワークフロー作成エクスペリエンスに直接統合するエンド ツー エンドのソリューションを示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/persisting-a-workflow-application.md b/docs/framework/windows-workflow-foundation/samples/persisting-a-workflow-application.md
new file mode 100644
index 00000000000..1c4132377ea
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/persisting-a-workflow-application.md
@@ -0,0 +1,65 @@
+---
+title: "ワークフロー アプリケーションの永続化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: abcff14c-f047-4195-ba26-d27f4a82c24e
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# ワークフロー アプリケーションの永続化
+このサンプルでは、<xref:System.Activities.WorkflowApplication> を実行し、アイドル状態になったときにアンロードしてから、再読み込みしてその実行を継続する方法を示します。  
+  
+## サンプルの詳細  
+ <xref:System.Activities.WorkflowApplication> は、単純なインターフェイスを提供していくつかのより一般的なホスト シナリオを実現する、単一のワークフロー インスタンスのホストです。このようなシナリオの 1 つに、永続化によって容易になる実行時間の長いワークフローがあります。永続化のホスト コントロールは、<xref:System.Activities.WorkflowApplication> で永続化操作を呼び出すか、<xref:System.Activities.WorkflowApplication> イベントを処理して <xref:System.Activities.WorkflowApplication> が永続化することを示すことで実行されます。  
+  
+ サンプル ワークフローは、ユーザーに名前の入力を求める <xref:System.Activities.Statements.WriteLine> アクティビティ、<xref:System.Activities.Bookmark> の再開を通じて名前を入力として受け取るための `ReadLine` アクティビティ、およびメッセージをユーザーにエコーするためのもう 1 つの <xref:System.Activities.Statements.WriteLine> です。ワークフローが入力を待機しているとき、これは永続化に適したポイントになります。これは <xref:System.Workflow.Runtime.Tracking.TrackingWorkflowEvent> ポイントと呼ばれています。<xref:System.Activities.WorkflowApplication> は、ワークフロー プログラムが永続化可能で、ブックマークの再開待ちの状態で、他の処理が実行されていないとき常に、<xref:System.Workflow.Runtime.Tracking.TrackingWorkflowEvent> イベントを発生します。このサンプルのワークフローでは、そのポイントが `ReadLine` アクティビティの実行開始直後に発生します。  
+  
+ <xref:System.Activities.WorkflowApplication> は、<xref:System.Runtime.Persistence.InstanceStore> を使用して永続化を実行するように設定されています。このサンプルでは、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用しています。<xref:System.Runtime.Persistence.InstanceStore> は、<xref:System.Activities.WorkflowApplication> の実行前に <xref:System.Activities.WorkflowApplication.InstanceStore%2A> プロパティに割り当てる必要があります。  
+  
+ このサンプルでは、<xref:System.Activities.WorkflowApplication.PersistableIdle%2A> イベントにハンドラーを追加します。このイベントのハンドラーは、<xref:System.Activities.PersistableIdleAction> を返すことによって <xref:System.Activities.WorkflowApplication> が行う処理を示します。<xref:System.Activities.PersistableIdleAction> が返された場合、<xref:System.Activities.WorkflowApplication> はアンロードされます。  
+  
+ その後、このサンプルはユーザーからの入力を受け入れ、永続化されたワークフローを新しい <xref:System.Activities.WorkflowApplication> に読み込みます。これを行うには、新しい <xref:System.Activities.WorkflowApplication> を作成し、<xref:System.Runtime.Persistence.InstanceStore> を再作成します。次に、完了してアンロードされたイベントをインスタンスに関連付けて、対象のワークフロー インスタンスの識別子を使用して <xref:System.Activities.WorkflowApplication.Load%2A> を呼び出します。インスタンスが取得されたら、`ReadLine` アクティビティのブックマークが再開されます。ワークフローは、`ReadLine` アクティビティ内から実行を続け、最後まで実行します。ワークフローが完了してアンロードされると、最後にもう一度 <xref:System.Runtime.Persistence.InstanceStore> が呼び出され、ワークフローが削除されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+     このサンプルを実行するには、既定で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] と共にインストールされる SQL Server Express が必要です。  
+  
+2.  サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\InstancePersistence\\CS\) に移動して、CreateInstanceStore.cmd を実行します。  
+  
+    > [!CAUTION]
+    >  CreateInstanceStore.cmd スクリプトは、SQL Server 2008 Express の既定のインスタンスにデータベースを作成しようとします。別のインスタンスにデータベースをインストールする場合は、そのようにスクリプトを変更してください。  
+  
+3.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して Persistence.sln ソリューション ファイルを開き、CTRL キーと SHIFT キーを押しながら B キーを押してビルドします。  
+  
+    > [!CAUTION]
+    >  SQL Server の既定以外のインスタンスにデータベースをインストールした場合は、ソリューションをビルドする前に、コードの接続文字列を更新してください。  
+  
+4.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] でプロジェクトの bin ディレクトリ \(\\WF\\Basic\\Persistence\\InstancePersistence\\bin\\Debug\) に移動し、Workflow.exe を右クリックして **\[管理者として実行\]** をクリックすることで、サンプルを管理者権限で実行します。  
+  
+#### インスタンス ストア データベースを削除するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+2.  サンプル ディレクトリに移動して RemoveInstanceStore.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\InstancePersistence`  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md b/docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md
new file mode 100644
index 00000000000..e06038db825
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md
@@ -0,0 +1,89 @@
+---
+title: ".NET Framework 4.5 のポリシー アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8e375e0c-d7c1-4d69-88ab-36d52db0aa7e
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# .NET Framework 4.5 のポリシー アクティビティ
+Policy4 アクティビティは、[!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] \(WF 3.5\) <xref:System.Workflow.Activities.Rules.RuleSet> オブジェクト内の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] を、WF 3.5 に付属しているルール エンジンを使用して [!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] \(WF 4.5\) の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] で直接使用できるようにします。このアクティビティを使用すると、WF 3.5 <xref:System.Workflow.Activities.Rules.RuleSet> を作成して実行できます。Windows Workflow Foundation の一部として用意されている WF 3.5 ルール エンジン[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「Windows Workflow Foundation ルール エンジンの紹介」を参照してください。[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] へのルール移行の詳細については、「[移行のガイドライン](../../../../docs/framework/windows-workflow-foundation//migration-guidance.md)」を参照してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\Rules-Policy4`  
+  
+## このサンプルのプロジェクト  
+  
+|プロジェクト名|説明|メイン ファイル|  
+|-------------|--------|--------------|  
+|Policy4|Policy4 アクティビティとその [!INCLUDE[wf1](../../../../includes/wf1-md.md)] デザイナーが含まれます。|**Policy4.cs**: Policy4 アクティビティ定義です。<br /><br /> **PolicyDesigner.xaml**: Policy4 アクティビティのカスタム デザイナーです。[!INCLUDE[wf1](../../../../includes/wf1-md.md)] ルール エンジンからルール エディター \([RuleSetDialog クラス](http://go.microsoft.com/fwlink/?LinkId=150378)\) を使用します。|  
+|ImperativeCodeClientSample|命令型 C\# コードで、Policy4 アプリケーションを使用してワークフローを構成および実行するサンプル クライアント アプリケーションです \([!INCLUDE[wf1](../../../../includes/wf1-md.md)] デザイナーは不使用\)。|**ApplyDiscount.rules**: [!INCLUDE[wf1](../../../../includes/wf1-md.md)] ルール定義が記述されたファイルです。<br /><br /> **Order.cs**: 顧客の注文を表す型です。ルールはこの型のオブジェクトに適用されます。<br /><br /> **Program.cs**: Policy4 アクティビティを使用するワークフローを構成および実行して、ApplyDiscount.rules で定義されているルールを Order オブジェクトのインスタンスに適用します。<br /><br /> **App.config**: ルール ファイルのパスが記述された構成ファイルです。|  
+|DesignerClientSample|[!INCLUDE[wf1](../../../../includes/wf1-md.md)] デザイナーで、Policy4 アプリケーションを使用してワークフローを構成および実行するサンプル クライアント アプリケーションです。|**Sequence1.xaml**: Policy4 アクティビティを使用してルール評価を実行するシーケンシャル ワークフローです。<br /><br /> `Program.cs`: Sequence1.xaml で定義されているワークフローのインスタンスを実行します。|  
+  
+## Policy4 アクティビティ  
+ Policy4 アクティビティは、ワークフローで [!INCLUDE[wf1](../../../../includes/wf1-md.md)] RuleSet を実行できるようにする <xref:System.Activities.NativeActivity%601> の派生クラスです。次のコード例は、このアクティビティのパブリック OM の簡略化された定義です。  
+  
+```csharp  
+  
+public class Policy4Activity<TResult>: NativeActivity<TResult>  
+{  
+    public RuleSet RuleSet  
+  
+    [IsRequired]  
+    public InArgument Input  
+  
+    public OutArgument<ValidationErrorCollection> ValidationErrors  
+}  
+```  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|RuleSet|アクティビティが実行されるときに評価される、.NET Framework 3.5 の WF [RuleSet クラス](http://go.microsoft.com/fwlink/?LinkId=150379)です。|  
+|TargetObject|[RuleSet クラス](http://go.microsoft.com/fwlink/?LinkId=150379)の Rules を評価する対象のオブジェクトです。|  
+|ValidationError|実行前に対象オブジェクトに対して [RuleSet クラス](http://go.microsoft.com/fwlink/?LinkId=150379)を検証するときに、.NET Framework 3.5 の [!INCLUDE[wf1](../../../../includes/wf1-md.md)] ルール エンジンから返される検証エラーのリストです。|  
+  
+## Policy4 アクティビティ デザイナー  
+ Policy4 デザイナーを使用すると、コードを記述することなく Policy4 アクティビティを構成できます。ソリューションをビルドすると、**Microsoft.Samples.Activities.Rules** セクションのツールボックス内からこのデザイナーを使用できるようになります。  
+  
+ WF デザイナーでは、対象オブジェクトや RuleSet を構成できます。**\[Edit RuleSet\]** ボタンをクリックすると、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] の WF [RuleSetDialog クラス](http://go.microsoft.com/fwlink/?LinkId=150378)が表示されます。このダイアログは、ホストを変更した [!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] ルール エディターです。このエディターを使用して、Policy4 アクティビティで実行するルールを作成および編集します。  
+  
+## このサンプルの使用  
+ このサンプルを実行するのに特別な設定は必要ありません。Visual Studio でソリューションを開き、F5 キーを押してアプリケーションを実行するだけです。  
+  
+ このサンプルには、ImperativeCodeClientSample と DesignerClientSample の 2 つのクライアント アプリケーションがあります。ImperativeCodeClientSample クライアントは、C\# 命令型コードを使用して Policy4 アクティビティを構成および実行する方法を示します。DesignerClientSample は、デザイナーを使用して Policy4 アクティビティを構成および実行する方法を示します。  
+  
+#### ImperativeCodeClientSample クライアント アプリケーションを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、Policy4Sample.sln ソリューション ファイルを開きます。  
+  
+2.  **ソリューション エクスプローラー**で、**ImperativeCodeClientSample** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+3.  プロジェクトを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+#### ImperativeCodeClientSample クライアント アプリケーションを実行するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、Policy4Sample.sln ソリューション ファイルを開きます。  
+  
+2.  **ソリューション エクスプローラー**で、**DesignerClientSample** プロジェクトを右クリックします。  
+  
+    -   **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+3.  プロジェクトをコンパイルするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+4.  プロジェクトを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/programming-model-item-tree.md b/docs/framework/windows-workflow-foundation/samples/programming-model-item-tree.md
new file mode 100644
index 00000000000..5e81febe667
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/programming-model-item-tree.md
@@ -0,0 +1,58 @@
+---
+title: "モデル アイテム ツリーのプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0229efde-19ac-4bdc-a187-c6227a7bd1a5
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# モデル アイテム ツリーのプログラミング
+このサンプルでは、[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] ツリー ビューの宣言型データ バインディングを使用して <xref:System.Activities.Presentation.Model.ModelItem> ツリーを操作する方法を示します。  
+  
+## サンプルの詳細  
+ <xref:System.Activities.Presentation.Model.ModelItem> ツリーは、編集する基のインスタンスに関するデータを公開するために [!INCLUDE[wfd1](../../../../includes/wfd1-md.md)] のインフラストラクチャで使用される抽象表現です。次の図は、[!INCLUDE[wfd2](../../../../includes/wfd2-md.md)]のインフラストラクチャのさまざまな層を表しています。  
+  
+ ![ワークフロー デザイナーのアーキテクチャ](../../../../docs/framework/windows-workflow-foundation/samples/media/workflowdesignerarch.JPG "WorkflowDesignerArch")  
+  
+ <xref:System.Activities.Presentation.Model.ModelItem> は、基になる値へのポインターと、<xref:System.Activities.Presentation.Model.ModelProperty> オブジェクトのコレクションで構成されています。<xref:System.Activities.Presentation.Model.ModelProperty> オブジェクトはさらに、プロパティの名前や型などのデータと、また別の <xref:System.Activities.Presentation.Model.ModelItem> である値へのポインターで構成されています。<xref:System.Activities.Presentation.Model.ModelProperty> から返される一部の <xref:System.Activities.Presentation.Model.ModelItem> に対しては、ツリー ビューに正しく表示されるように操作するために値コンバーターが使用されます。このサンプルでは、次の例のような命令構文を使用して <xref:System.Activities.Presentation.Model.ModelItem> ツリーを命令型プログラミングで操作する方法を示します。  
+  
+```csharp  
+ModelItem mi = wd.Context.Services.GetService<ModelService>().Root;  
+ModelProperty mp = mi.Properties["Activities"];  
+mp.Collection.Add(new Persist());  
+ModelItem justAdded = mp.Collection.Last();  
+justAdded.Properties["DisplayName"].SetValue("new name");  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ProgrammingModelItemTree.sln ソリューションを開きます。  
+  
+2.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックして、ソリューションをビルドします。  
+  
+3.  F5 キーを押してアプリケーションを実行します。[!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] フォームが表示されます。  
+  
+4.  **\[Load WF\]** ボタンをクリックして <xref:System.Activities.Presentation.Model.ModelItem> を読み込み、ツリー ビューにバインドします。  
+  
+5.  **\[Change Model Item Tree\]** ボタンをクリックして先ほどのコードを実行して、ツリーにアイテムを追加してプロパティを設定します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Designer\ProgrammingModelItemTree`  
+  
+## 参照  
+ <xref:System.Windows.Data.IValueConverter>
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/property-grid-extensibliity.md b/docs/framework/windows-workflow-foundation/samples/property-grid-extensibliity.md
new file mode 100644
index 00000000000..3c63d5fcd91
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/property-grid-extensibliity.md
@@ -0,0 +1,141 @@
+---
+title: "プロパティ グリッドの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3530c3a3-756d-4712-9f10-fb2897414d3a
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# プロパティ グリッドの拡張
+開発者は、デザイナー内で特定のアクティビティを選択したときに表示されるプロパティ グリッドをカスタマイズできます。これにより、高度な編集操作の作成が可能になります。このサンプルでは、その方法を示します。  
+  
+## 使用例  
+ ワークフロー デザイナーのプロパティ グリッドの拡張。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Designer\PropertyGridExtensibility`  
+  
+## 説明  
+ 開発者がプロパティ グリッドを拡張できるように、プロパティ グリッド エディターのインラインの外観をカスタマイズするオプションと、高度な編集画面用のダイアログを表示するオプションが用意されています。このサンプルでは、インライン エディターとダイアログ エディターの 2 種類のエディターを示します。  
+  
+## インライン エディター  
+ インライン エディターのサンプルで示す内容は次のとおりです。  
+  
+-   <xref:System.Activities.Presentation.PropertyEditing.PropertyValueEditor> から派生する型を作成します。  
+  
+-   コンストラクターで、[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] データ テンプレートを使用して <xref:System.Activities.Presentation.PropertyEditing.PropertyValueEditor.InlineEditorTemplate%2A> 値を設定します。これは XAML テンプレートにバインドできますが、このサンプルではコードを使用してデータ バインディングを初期化します。  
+  
+-   プロパティ グリッドに表示される項目の <xref:System.Activities.Presentation.PropertyEditing.PropertyValue> のデータ コンテキストは、データ テンプレートに含まれています。次のコード \(CustomInlineEditor.cs のコード\) で、このコンテキストが `Value` プロパティにバインドされていることに注意してください。  
+  
+    ```csharp  
+    FrameworkElementFactory stack = new FrameworkElementFactory(typeof(StackPanel));  
+    FrameworkElementFactory slider = new FrameworkElementFactory(typeof(Slider));  
+    Binding sliderBinding = new Binding("Value");  
+    sliderBinding.Mode = BindingMode.TwoWay;  
+    slider.SetValue(Slider.MinimumProperty, 0.0);  
+    slider.SetValue(Slider.MaximumProperty, 100.0);  
+    slider.SetValue(Slider.ValueProperty, sliderBinding);  
+    stack.AppendChild(slider);  
+  
+    ```  
+  
+-   アクティビティとデザイナーが同じアセンブリにあるため、アクティビティ デザイナーの属性の登録は、アクティビティ自体の静的コンストラクターで行われます。SimpleCodeActivity.cs の例を次に示します。  
+  
+    ```  
+    static SimpleCodeActivity()  
+    {  
+        AttributeTableBuilder builder = new AttributeTableBuilder();  
+        builder.AddCustomAttributes(typeof(SimpleCodeActivity), "RepeatCount", new EditorAttribute(typeof(CustomInlineEditor), typeof(PropertyValueEditor)));  
+        builder.AddCustomAttributes(typeof(SimpleCodeActivity), "FileName", new EditorAttribute(typeof(FilePickerEditor), typeof(DialogPropertyValueEditor)));  
+        MetadataStore.AddAttributeTable(builder.CreateTable());  
+    }  
+  
+    ```  
+  
+## ダイアログ エディター  
+ ダイアログ エディターのサンプルで示す内容は次のとおりです。  
+  
+1.  <xref:System.Activities.Presentation.PropertyEditing.DialogPropertyValueEditor> から派生する型を作成します。  
+  
+2.  コンストラクターで、[!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] データ テンプレートを使用して <xref:System.Activities.Presentation.PropertyEditing.PropertyValueEditor.InlineEditorTemplate%2A> 値を設定します。これは XAML で作成できますが、このサンプルではコードで作成します。  
+  
+3.  プロパティ グリッドに表示される項目の <xref:System.Activities.Presentation.PropertyEditing.PropertyValue> のデータ コンテキストは、データ テンプレートに含まれています。次のコードで、これが `Value` プロパティにバインドされています。FilePickerEditor.cs では、ダイアログを起動するボタンを指定するための <xref:System.Activities.Presentation.PropertyEditing.EditModeSwitchButton> を含めることも重要です。  
+  
+    ```  
+    this.InlineEditorTemplate = new DataTemplate();  
+  
+    FrameworkElementFactory stack = new FrameworkElementFactory(typeof(StackPanel));  
+    stack.SetValue(StackPanel.OrientationProperty, Orientation.Horizontal);  
+    FrameworkElementFactory label = new FrameworkElementFactory(typeof(Label));  
+    Binding labelBinding = new Binding("Value");  
+    label.SetValue(Label.ContentProperty, labelBinding);  
+    label.SetValue(Label.MaxWidthProperty, 90.0);  
+  
+    stack.AppendChild(label);  
+  
+    FrameworkElementFactory editModeSwitch = new FrameworkElementFactory(typeof(EditModeSwitchButton));  
+  
+    editModeSwitch.SetValue(EditModeSwitchButton.TargetEditModeProperty, PropertyContainerEditMode.Dialog);  
+  
+    stack.AppendChild(editModeSwitch);  
+  
+    this.InlineEditorTemplate.VisualTree = stack;  
+    ```  
+  
+4.  ダイアログの表示を処理するデザイナー型の <xref:Microsoft.Windows.Design.PropertyEditing.ShowDialog%2A> メソッドをオーバーライドします。このサンプルでは、基本的な <xref:System.Windows.Forms.FileDialog> を示します。  
+  
+    ```  
+    public override void ShowDialog(PropertyValue propertyValue, IInputElement commandSource)  
+    {  
+        Microsoft.Win32.OpenFileDialog ofd = new Microsoft.Win32.OpenFileDialog();  
+        if (ofd.ShowDialog() == true)  
+        {  
+            propertyValue.Value = ofd.FileName;  
+        }  
+    }  
+  
+    ```  
+  
+5.  アクティビティとデザイナーが同じアセンブリにあるため、アクティビティ デザイナーの属性の登録は、アクティビティ自体の静的コンストラクターで行われます。SimpleCodeActivity.cs の例を次に示します。  
+  
+    ```  
+    static SimpleCodeActivity()  
+    {  
+        AttributeTableBuilder builder = new AttributeTableBuilder();  
+        builder.AddCustomAttributes(typeof(SimpleCodeActivity), "RepeatCount", new EditorAttribute(typeof(CustomInlineEditor), typeof(PropertyValueEditor)));  
+        builder.AddCustomAttributes(typeof(SimpleCodeActivity), "FileName", new EditorAttribute(typeof(FilePickerEditor), typeof(DialogPropertyValueEditor)));  
+        MetadataStore.AddAttributeTable(builder.CreateTable());  
+    }  
+  
+    ```  
+  
+## サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドし、Workflow1.xaml を開きます。  
+  
+2.  **SimpleCodeActivity** フォームをツールボックスからデザイナー キャンバスにドラッグします。  
+  
+3.  **SimpleCodeActivity** をクリックし、プロパティ グリッドを開きます。スライダー コントロールとファイル選択コントロールが表示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Designer\PropertyGridExtensibility`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/property-promotion-activity.md b/docs/framework/windows-workflow-foundation/samples/property-promotion-activity.md
new file mode 100644
index 00000000000..ffcf7cbe24f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/property-promotion-activity.md
@@ -0,0 +1,202 @@
+---
+title: "プロパティ昇格アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 802196b7-1159-4c05-b41b-d3bfdfcc88d9
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# プロパティ昇格アクティビティ
+このサンプルでは、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 昇格機能をワークフロー作成に直接統合するエンド ツー エンドのソリューションを示します。昇格機能の使用を単純化する構成要素、ワークフロー アクティビティ、およびワークフロー拡張機能のコレクションが用意されています。また、サンプルには、このコレクションの使用方法を示す簡単なワークフローが含まれています。  
+  
+> [!NOTE]
+>  サンプルは、演習目的で利用するためにのみ提供されています。サンプルを運用環境で使用することは想定されていないため、運用環境でのサンプルのテストは行われていません。Microsoft では、これらのサンプルに関する製品サポート情報を提供していません。  
+  
+## 前提条件  
+  
+-   初期化された <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> データベース  
+  
+-   [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)]  
+  
+## サンプル プロジェクト  
+  
+-   **PropertyPromotionActivity** プロジェクトには、昇格固有の構成要素、ワークフロー アクティビティ、およびワークフロー拡張機能に関連するファイルが含まれています。  
+  
+-   **CounterServiceApplication** プロジェクトには、**SqlWorkflowInstanceStorePromotion** プロジェクトを使用するサンプル ワークフローが含まれています。  
+  
+-   <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> データベースに対して実行される必要がある SQL スクリプト \(PropertyPromotionActivitySQLSample.sql\)。  
+  
+-   2 つの [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] プロジェクトをリンクするソリューション ファイル \(`PropertyPromotionActivity.sln`\)。  
+  
+## サンプルをセットアップおよび実行するには  
+  
+1.  ワークフロー永続化データベースを初期化します。  
+  
+    1.  サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\PropertyPromotionActivity\) に移動して、CreateInstanceStore.cmd を実行します。  
+  
+    2.  管理特権がない場合は、SQL Server ログインを作成します。SQL Server Management Studio で **\[セキュリティ\]**、**\[ログイン\]** に移動します。**\[ログイン\]** を右クリックして新しいログインを作成します。**\[データベース\]**、**\[InstanceStore\]**、**\[セキュリティ\]** を開いて、自分の ACL ユーザーを SQL ロールに追加します。**\[ユーザー\]** を右クリックして **\[新しいユーザー\]** をクリックします。**\[ログイン名\]** を、上記で作成したユーザーに設定します。そのユーザーを、System.Activities.DurableInstancing.InstanceStoreUsers \(およびその他\) のデータベース ロールのメンバーシップに追加します。ユーザーが既に存在している場合もあります \(ユーザー dbo など\)。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で PropertyPromotionActivity.sln ソリューション ファイルを開きます。  
+  
+3.  ローカルの SQL Server Express 以外のデータベースにインスタンス ストアを作成した場合は、データベース接続文字列を更新する必要があります。手順 1. で初期化された永続化データベースをポイントするように `sqlWorkflowInstanceStorePromotion` ノードの `connectionString` 属性の値を設定して、**CounterServiceApplication** の下の App.config ファイルを変更します。  
+  
+4.  ソリューションをビルドして実行します。これにより、カウンター WF サービスが開始され、ワークフロー インスタンスが自動的に開始されます。  
+  
+5.  永続化データベースの \[dbo\].\[CounterService\] ビューですべての行をすばやく選択します \(このビューは、手順 1. の CreateInstanceStore.cmd の実行により追加されました\)。以下と同様の結果セットが生成されます。  
+  
+    |InstanceId|CounterValue|CounterValueLastUpdated|  
+    |----------------|------------------|-----------------------------|  
+    |2FA2C302\-929E\-4C0D\-8C25\-768A3DA20CE5|12|2010\-02\-18 22:48:01.740|  
+  
+     ビューの更新を続行すると、CounterValue および CounterValueLastUpdated が 2 秒ごとに変更されます。これは、カウンターがカウンター自身を更新する間隔です。CounterValue と CounterValueLastUpdated は、このワークフローの昇格されたプロパティを表します。  
+  
+## サンプルを削除するには  
+  
+-   サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\PropertyPromotionActivity\) で RemoveInstanceStore.cmd を実行します。  
+  
+## このサンプルについて  
+ サンプルには、次の 2 つのプロジェクトと SQL ファイルが含まれています。  
+  
+-   **CounterServiceApplication** は、単純なカウンター WF サービスをホストするコンソール アプリケーションです。`Start` エンドポイントを通して一方向のメッセージを受信すると、ワークフローは 0 から 29 までをカウントし、2 秒ごとにカウンター変数がインクリメントされます。カウンターがインクリメントされるたびに、ワークフローが永続化され、昇格されたプロパティは \[dbo\].\[CounterService\] ビューで更新されます。コンソール アプリケーションが実行されると、WF サービスをホストし、メッセージを `Start` エンドポイントに送信して、カウンター WF インスタンスを作成します。  
+  
+-   **PropertyPromotionActivity** は、**CounterServiceApplication** が使用する構成要素、ワークフロー アクティビティ、およびワークフロー拡張機能を含むクラス ライブラリです。  
+  
+-   **PropertyPromotionActivitySQLSample.sql** は、ビュー \[dbo\].\[CounterService\] を作成し、データベースに追加します。  
+  
+### CounterServiceApplication  
+  
+#### SqlWorkflowInstanceStorePromotion 構成要素の使用  
+ `SqlWorkflowInstanceStorePromotion` 構成要素は `SqlWorkflowInstanceStore` 構成要素から継承されますが、`promotionSets` という追加の構成要素が追加されます。`promotionSets` 要素は、ユーザーが構成を通して昇格されたプロパティを指定できるようにします。これは、サンプルで使用される構成ファイルです。  
+  
+```xml  
+<sqlWorkflowInstanceStorePromotion connectionString ="Data Source=.;Initial Catalog=SqlWorkflowInstanceStoreTest;Integrated Security=True;">  
+  <promotionSets>  
+    <promotionSet name="CounterService">  
+      <promotedValue propertyName="Count"/>  
+      <promotedValue propertyName="LastIncrementedAt"/>  
+    </promotionSet>  
+  </promotionSets>  
+</sqlWorkflowInstanceStorePromotion>  
+```  
+  
+ \[dbo\].\[CounterService\] ビューの定義を確認します。  
+  
+```sql  
+create view [dbo].[CounterService] as  
+      select [InstanceId],  
+ [Value1] as [CounterValue],  
+ [Value2] as [CounterValueLastUpdated]  
+      from [System.Activities.DurableInstancing].[InstancePromotedProperties]  
+      where [PromotionName] = 'CounterService'  
+go  
+  
+```  
+  
+ ワークフロー インスタンスが永続化されると、構成で定義された各 `PromotionSet` の `InstancePromotedProperties` ビューに行が挿入されます。この行には、`PromotionSet` のすべての昇格されたプロパティが含まれます \(列ごとに 1 つの昇格されたプロパティ\)。この `PromotionSet` は、`InstanceId, PromotionName` のタプルによってキー指定されます。このサンプルには、名前属性が `CounterService` である構成で定義されている 1 つの `PromotionSet` があります。`PromotionName` 列の値が `PromotionSet` 要素の名前属性と等しいことがわかります。  
+  
+ `promotedValue` 要素の順序は、`InstancePromotedProperties` ビューの昇格されたプロパティの位置と相関しています。`Count` は最初の `promotedValue` 要素です。その結果、`InstancePromotedProperties` ビューの `Value1` 列にマップされます。`LastIncrementedAt` は 2 番目の `promotedValue` 要素です。その結果、`InstancePromotedProperties` ビューの `Value2` 列にマップされます。  
+  
+#### PromoteValue アクティビティの使用  
+ [!INCLUDE[wf2](../../../../includes/wf2-md.md)] デザイナーで CounterService.xamlx ファイルを確認します。WF の定義には、`PromoteValue<DateTime>` および `PromoteValue<Int32>` の 2 つの特別なアクティビティがあります。  
+  
+ `PromoteValue<Int32>` アクティビティには、`Count` として定義されているその `Name` メンバーがあります。これは、構成の最初の `promotedValue` 要素と一致し、`Counter` ワークフロー変数として定義されているその `Value` があります。ワークフローが永続化されると、`Counter` ワークフロー変数は昇格されたプロパティとして `InstancePromotedProperties` ビューの `Value1` 列に保存されます。  
+  
+ `PromoteValue<DateTime>` アクティビティには、`LastIncrementedAt` として定義されているその `Name` メンバーがあります。これは、構成の 2 番目の `promotedValue` 要素と一致し、`TimeLastIncremented` ワークフロー変数として定義されているその `Value` があります。これは、ワークフローが永続化されると、`TimeLastIncremented` ワークフロー変数の値が昇格されたプロパティとして `InstancePromotedProperties` ビューの  `Value2` 列に保存されることを意味します。  
+  
+ `PromotedValue` アクティビティには、`ClearExistingPromotedData` というブール型のメンバーもあります。このメンバーを `true` に設定すると、ワークフローのその時点までのすべての昇格されたプロパティ値が消去されます。たとえば、Sequence アクティビティが次のように定義されているとします。  
+  
+1.  PromoteValue { Name \= “Count”, Value \= 3}  
+  
+2.  PromoteValue {Name \= “LastIncrementedAt”, Value \= 1\-1\-2000 }  
+  
+3.  永続化  
+  
+4.  PromoteValue {Name \= “Count”, Value \= 4, ClearExistingPromotedData \= true}  
+  
+5.  永続化  
+  
+ 2 番目の永続化では、`Count` の昇格された値は 4 になります。ただし、`LastIncrementedAt` の昇格された値は `NULL` になります。手順 4. で `ClearExistingPromotedData` を `true` に設定しなかった場合は、2 番目の永続化の後、Count の昇格された値は 4 になります。その結果、`LastIncrementedAt` の昇格された値は 1\-1\-2000 のままです。  
+  
+### PropertyPromotionActivity  
+ このクラス ライブラリには、<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> 昇格機能の使用を単純化する次のパブリック クラスが含まれています。  
+  
+#### PromoteValue クラス  
+ このクラスは 1 つのプロパティを昇格します。昇格されたプロパティの名前は、構成の `promotedValue` 要素の名前属性と同じである必要があります。このアクティビティは、ワークフロー デザイナーで使用できます。使用例については、「CounterServiceApplication」を参照してください。  
+  
+```csharp  
+public class PromoteValue<T> : CodeActivity  
+{  
+    public PromoteValue()  
+    {  
+    }  
+  
+    public bool ClearExistingPromotedData { get; set; }  
+    public string Name { get; set; }  
+    public InArgument<T> Value { get; set; }  
+}  
+  
+```  
+  
+ ClearExistingPromotedData \(Bool\)  
+ このアクティビティの前に昇格されたすべての値を消去します。  
+  
+ Name \(string\)  
+ このプロパティを表す名前。これは、構成の \<promotedValue\> 要素の名前属性と同じである必要があります。  
+  
+ Value \(InArgument\<T\>\)  
+ 列に格納する変数\/値。  
+  
+#### PromoteValues クラス  
+ 複数のプロパティを昇格します。昇格されたプロパティの名前は、構成の `promotedValue` 要素のすべての名前属性と同じである必要があります。使用方法は、`PromoteValue` アクティビティと似ていますが、複数のプロパティを同時に昇格できる点が異なります。このアクティビティは、ワークフロー デザイナーでは使用できません。  
+  
+```  
+public class PromoteValues : CodeActivity  
+{  
+    public PromoteValues()  
+    {  
+        this.ValuesToPromote = new Dictionary<string, InArgument>();  
+    }  
+  
+    public bool ClearExistingPromotedData { get; set; }  
+    public IDictionary<string, InArgument> ValuesToPromote { get; set; }  
+}  
+```  
+  
+#### SqlWorkflowInstanceStorePromotionBehavior  
+ `SqlWorkflowInstanceStoreBehavior` から派生します。この派生クラスは、カスタムの永続化参加要素 \(このライブラリの一部でもあります\) をワークフロー拡張機能として追加します。前の 2 つのワークフロー アクティビティの実装は、このカスタムの永続化参加要素に依存しています。  
+  
+```  
+public class SqlWorkflowInstanceStorePromotionBehavior :  
+             SqlWorkflowInstanceStoreBehavior, IServiceBehavior  
+{  
+        public void Promote(string name, IEnumerable<string> promoteAsSqlVariant,  
+                            IEnumerable<string> promoteAsBinary)  
+  
+}  
+  
+```  
+  
+ このクラス ライブラリには、`SqlWorkflowInstanceStorePromotionElement` の `ConfigurationElement` 実装と前の昇格アクティビティで使用されたカスタムの永続化参加要素も含まれています。  
+  
+### PropertyPromotionActivitySQLSample  
+ この SQL ファイルでは、CounterService 昇格セットを持つすべてのインスタンスをクエリするために `[InstancePromotedProperties]` ビューのほかに `[dbo].[CounterService]` ビューも作成されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\PropertyPromotionActivity`  
+  
+## 参照  
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/rangeenumeration-activity.md b/docs/framework/windows-workflow-foundation/samples/rangeenumeration-activity.md
new file mode 100644
index 00000000000..f5b0267a0bb
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/rangeenumeration-activity.md
@@ -0,0 +1,51 @@
+---
+title: "RangeEnumeration アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: ca5b78f4-94fa-4aa7-830d-26039ac422c8
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# RangeEnumeration アクティビティ
+このサンプルでは、数値のコレクションを反復処理するカスタム アクティビティを作成する方法を示します。次の表で、このサンプルに含まれるメイン ファイルについて説明します。  
+  
+|ファイル名|説明|  
+|-----------|--------|  
+|RangeEnumeration.cs|<xref:System.Activities.NativeActivity> クラスをオーバーライドし、一連の数値をループする `RangeEnumeration` というカスタム アクティビティを定義します。|  
+|RangeEnumerationSample.cs|`RangeEnumeration` アクティビティを使用して数値のコレクションを反復処理するクライアント アプリケーション。|  
+  
+ 次の表で、`RangeEnumeration` アクティビティのプロパティについて説明します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|Start|ループの開始位置を示す整数。|  
+|Stop|ループの停止位置を示す整数。|  
+|Step|各反復処理の反復回数を指定します。|  
+|Body|各反復処理中に実行するコードを指定します。|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、RangeEnumeration.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\RangeEnumeration`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/regular-expression-activities.md b/docs/framework/windows-workflow-foundation/samples/regular-expression-activities.md
new file mode 100644
index 00000000000..678406e6ad6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/regular-expression-activities.md
@@ -0,0 +1,126 @@
+---
+title: "正規表現アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8f24694-49db-4339-92ec-014e3d4ae63b
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 正規表現アクティビティ
+このサンプルでは、<xref:System.Text.RegularExpressions> 名前空間の正規表現機能を公開する一連のアクティビティを作成する方法を示します。このカスタム アクティビティはワークフロー アプリケーション内で使用できます。正規表現[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[N: System.Text.RegularExpressions](http://go.microsoft.com/fwlink/?LinkId=150434)」の名前空間参照してください。  
+  
+ 次の表に、このサンプルのカスタム アクティビティの詳細を示します。  
+  
+|アクティビティ|説明|  
+|-------------|--------|  
+|IsMatch|正規表現で入力文字列内に一致が見つかったかどうかを示します。|  
+|Matches|入力文字列で、正規表現に一致するすべての文字列を検索し、一致した文字列をすべて返します。|  
+|Replace|指定された入力文字列内で、正規表現パターンに一致する文字列を、指定された置換文字列で置き換えます。|  
+  
+## IsMatch  
+ `IsMatch` カスタム アクティビティは、`Input` 文字列プロパティが `Pattern` プロパティで指定された正規表現で一致を見つけると、`true` を返します。このアクティビティは <xref:System.Activities.CodeActivity%601> から派生し、<xref:System.Activities.CodeActivity%601.Execute%2A> メソッド内で、<xref:System.Text.RegularExpressions.Regex.IsMatch%2A> メソッドを呼び出します。  
+  
+ 次の表で、`IsMatch` カスタム アクティビティのプロパティと戻り値について説明します。  
+  
+|プロパティ値または戻り値|説明|  
+|------------------|--------|  
+|Pattern \(必須\)|検索に使用する正規表現。|  
+|Input \(必須\)|検索対象の入力文字列。|  
+|RegexOptions|[RegexOptions](http://go.microsoft.com/fwlink/?LinkId=150446) 列挙値のビット単位の OR の組み合わせ。|  
+|戻り値|指定されたパターンで一致が見つかった場合は `true`、それ以外の場合は `false`。|  
+  
+ 次のコード例は、`IsMatch` カスタム アクティビティの使用方法を示します。  
+  
+```  
+new IsMatch  
+{  
+    Pattern = new InArgument<string>( @"^-?\d+(\.\d{2})?$"),  
+    Input = "20.00",  
+};  
+  
+```  
+  
+## Matches  
+ `Matches` カスタム アクティビティは、入力文字列で、正規表現に一致するすべての文字列を検索し、一致した文字列をすべて返します。このアクティビティは <xref:System.Activities.CodeActivity%601> から派生し、<xref:System.Activities.CodeActivity%601.Execute%2A> メソッド内で、<xref:System.Text.RegularExpressions.Regex.Matches%2A> メソッドを呼び出します。  
+  
+ 次の表で、`IsMatch` カスタム アクティビティのプロパティと戻り値について説明します。  
+  
+|プロパティ値または戻り値|説明|  
+|------------------|--------|  
+|Pattern \(必須\)|検索に使用する正規表現。|  
+|Input \(必須\)|検索対象の入力文字列。|  
+|RegexOptions|[RegexOptions](http://go.microsoft.com/fwlink/?LinkId=150446) 列挙値のビット単位の OR の組み合わせ。|  
+|戻り値|一致する文字列のコレクションが格納された <xref:System.Text.RegularExpressions.MatchCollection>。|  
+  
+ 次のコード例は、`Matches` カスタム アクティビティの使用方法を示します。  
+  
+```  
+new Matches  
+{  
+    Pattern = @"\b(?<word>\w+)\s+(\k<word>)\b",  
+    Input = "The quick brown fox  fox jumped over over the lazy dog dog.",  
+};  
+  
+```  
+  
+## Replace  
+ `Replace` カスタム アクティビティは入力文字列を検索し、指定された正規表現と一致するすべての文字列を 1 つの文字列で置き換えます。このアクティビティは <xref:System.Activities.CodeActivity%601> から派生し、<xref:System.Activities.CodeActivity%601.Execute%2A> メソッド内で、<xref:System.Text.RegularExpressions.Regex.Replace%2A> メソッドを呼び出します。  
+  
+ 次の表で、`Replace` カスタム アクティビティのプロパティと戻り値について説明します。  
+  
+|プロパティ値または戻り値|説明|  
+|------------------|--------|  
+|Pattern \(必須\)|検索に使用する正規表現。|  
+|Input \(必須\)|検索対象の入力文字列。|  
+|Replacement|置換文字列。<br /><br /> `Replacement` が指定されると、`MatchEvaluator` プロパティは無視されます。`Replacement` または `MatchEvaluator` のどちらかのプロパティを設定する必要があります。|  
+|MatchEvaluator|各一致文字列を調べ、元の一致文字列または置換文字列のどちらかを返すカスタム メソッド。<br /><br /> `Replacement` が指定されると、`MatchEvaluator` プロパティは無視されます。`Replacement` または `MatchEvaluator` のどちらかのプロパティを設定する必要があります。|  
+|RegexOptions|[RegexOptions](http://go.microsoft.com/fwlink/?LinkId=150446) 列挙値のビット単位の OR の組み合わせ。|  
+|戻り値|一致する文字列のコレクションが格納された <xref:System.Text.RegularExpressions.MatchCollection>。|  
+  
+ 次のコード例は、`Replace` カスタム アクティビティの使用方法を示します。  
+  
+```  
+// Using the replacement string.  
+new Replace  
+{  
+    Pattern = @"\bWorld\b",  
+    Input = "Hello World! This is a wonderful World",  
+    Replacement = "Universe"  
+};  
+  
+// Using a match evaluator.  
+new Replace  
+{  
+    Pattern = new InArgument<string>(pattern),  
+    Input = new InArgument<string>(input),  
+    MatchEvaluator = new MatchEvaluator(CapText)                  
+};  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、RegexActivities.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\Regex`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/removing-the-view-state-the-designer-adds-to-an-xaml-file.md b/docs/framework/windows-workflow-foundation/samples/removing-the-view-state-the-designer-adds-to-an-xaml-file.md
new file mode 100644
index 00000000000..6d6fa19e77f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/removing-the-view-state-the-designer-adds-to-an-xaml-file.md
@@ -0,0 +1,128 @@
+---
+title: "デザイナーによって XAML ファイルに追加されるビューステートの削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a801ce22-8699-483c-a392-7bb3834aae4f
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# デザイナーによって XAML ファイルに追加されるビューステートの削除
+このサンプルでは、<xref:System.Windows.Markup.XamlWriter> から派生するクラスを作成する方法を示し、XAML ファイルからビューステートを削除します。[!INCLUDE[wfd1](../../../../includes/wfd1-md.md)] は、ビューステートと呼ばれる情報を XAML ドキュメントに書き込みます。ビューステートは、ランタイムでは不必要なレイアウト配置などの、デザイン時に必要な情報を参照します。[!INCLUDE[wfd2](../../../../includes/wfd2-md.md)] は、編集時に、XAML ドキュメントにこの情報を挿入します。[!INCLUDE[wfd2](../../../../includes/wfd2-md.md)] は、`mc:Ignorable` 属性を持つ XAML ファイルにビュー ステートを書き込みます。この結果、ランタイムが XAML ファイルを読み込みとき、この情報は読み込まれません。このサンプルでは、XAML ノードの処理中にそのビューステート情報を削除するクラスを作成する方法を示します。  
+  
+## 説明  
+ このサンプルでは、カスタム ライターを作成する方法を示します。  
+  
+ カスタム XAML ライターをビルドするには、<xref:System.Windows.Markup.XamlWriter> を継承するクラスを作成します。XAML ライターは入れ子になっていることが多いので、通常は "内部" XAML ライターを追跡します。この "内部" ライターは XAML ライターの残りのスタックへの参照と考えることができ、これによって複数のエントリ ポイントで処理が実行されるようにし、処理を残りのスタックにデリゲートすることができます。  
+  
+ このサンプルには、重要な項目がいくつかあります。その 1 つとして、書き込まれる項目がデザイナー名前空間からのものであるかどうかの確認が挙げられます。これにより、ワークフローでデザイナー名前空間の他の型の使用が排除されることに注意してください。  
+  
+```  
+static Boolean IsDesignerAttachedProperty(XamlMember xamlMember)  
+{  
+return xamlMember.IsAttachable &&  
+   xamlMember.PreferredXamlNamespace.Equals(c_sapNamespaceURI, StringComparison.OrdinalIgnoreCase);  
+}  
+  
+const String c_sapNamespaceURI = "http://schemas.microsoft.com/netfx/2009/xaml/activities/presentation";  
+The next item of interest is the constructor, where the utilization of the inner XAML writer is seen.  
+public ViewStateCleaningWriter(XamlWriter innerWriter)  
+{  
+this.InnerWriter = innerWriter;  
+this.MemberStack = new Stack<XamlMember>();  
+}  
+  
+XamlWriter InnerWriter {get; set; }  
+Stack<XamlMember> MemberStack {get; set; }  
+  
+```  
+  
+ これにより、ノード ストリームの走査中に使用される XAML メンバーのスタックも作成されます。このサンプルの残りの作業は、主に <xref:System.Windows.Markup.XamlWriter.WriteStartMember%2A> メソッドに含まれています。  
+  
+```  
+public override void WriteStartMember(XamlMember xamlMember)  
+{  
+MemberStack.Push(xamlMember);  
+if (IsDesignerAttachedProperty(xamlMember))  
+{  
+m_attachedPropertyDepth++;  
+}  
+  
+if (m_attachedPropertyDepth > 0)  
+{  
+return;  
+}  
+  
+InnerWriter.WriteStartMember(xamlMember);  
+}  
+  
+```  
+  
+ 後続のメソッドで、まだビューステート コンテナーに含まれているかどうかがチェックされ、含まれている場合は制御が戻り、ノードはライター スタックに渡されません。  
+  
+```  
+public override void WriteValue(Object value)  
+{  
+if (m_attachedPropertyDepth > 0)  
+{  
+return;  
+}  
+  
+InnerWriter.WriteValue(value);  
+}  
+```  
+  
+ カスタム XAML ライターを使用するには、XAML ライターのスタックでまとめて連結する必要があります。この使用方法を次のコードに示します。  
+  
+```  
+XmlWriterSettings writerSettings = new XmlWriterSettings {  Indent = true };  
+XmlWriter xmlWriter = XmlWriter.Create(File.OpenWrite(args[1]), writerSettings);  
+XamlXmlWriter xamlWriter = new XamlXmlWriter(xmlWriter, new XamlSchemaContext());  
+XamlServices.Save(new ViewStateCleaningWriter(ActivityXamlServices.CreateBuilderWriter(xamlWriter)), ab);  
+  
+```  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ViewStateCleaningWriter.sln ソリューション ファイルを開きます。  
+  
+2.  コマンド プロンプトを開き、ViewStageCleaningWriter.exe がビルドされているディレクトリに移動します。  
+  
+3.  Workflow1.xaml ファイルに対して ViewStateCleaningWriter.exe を実行します。  
+  
+     実行可能ファイルの構文の例を次に示します。  
+  
+ **ViewStateCleaningWriter.exe \[入力ファイル\] \[出力ファイル\]**     これにより、XAML ファイルは、すべてのビューステート情報が削除された状態で \[出力ファイル\] に出力されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Activities.Statements.Sequence> ワークフローでは、多数の仮想化のヒントが削除されます。その結果、デザイナーは次回の読み込み時にレイアウトを再計算します。このサンプルを <xref:System.Activities.Statements.Flowchart> に対して使用すると、すべての配置情報および線のルーティング情報が削除され、後続のデザイナーへの読み込み時にすべてのアクティビティが画面の左側に積み上げられます。  
+  
+#### このサンプルで使用するサンプル XAML ファイルを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  新しいワークフロー コンソール アプリケーションを作成します。  
+  
+3.  いくつかのアクティビティをキャンバスにドラッグ アンド ドロップします。  
+  
+4.  ワークフロー XAML ファイルを保存します。  
+  
+5.  XAML ファイルを調べて、ビューステートの添付プロパティを確認します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Designer\ViewStateCleaningWriter`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/rules-samples.md b/docs/framework/windows-workflow-foundation/samples/rules-samples.md
new file mode 100644
index 00000000000..f390e101178
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/rules-samples.md
@@ -0,0 +1,34 @@
+---
+title: "ルールのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fe156790-3260-4d50-a4a6-e6bc80575af0
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ルールのサンプル
+このセクションには、[!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] のワークフロー ルール エンジンを使用する方法を示すサンプルが含まれます。  
+  
+## このセクションの内容  
+ [高度なポリシー](../../../../docs/framework/windows-workflow-foundation/samples/advanced-policy.md)  
+ 単純なポリシーのサンプルを拡張する方法を示します。単純なポリシーのサンプルに含まれる個人向け割引ルールとビジネス割引ルールの他に、新しいルールがいくつか追加されています。  
+  
+ [簡単なポリシー](../../../../docs/framework/windows-workflow-foundation/samples/simple-policy.md)  
+ ワークフローで <xref:System.Workflow.Activities.PolicyActivity> アクティビティを使用する方法を示します。  
+  
+ [ルール付き IfElse](../../../../docs/framework/windows-workflow-foundation/samples/ifelse-with-rules.md)  
+ ルール条件を <xref:System.Workflow.Activities.IfElseActivity> アクティビティで使用する方法を示します。  
+  
+ [条件付きアクティビティ グループ](../../../../docs/framework/windows-workflow-foundation/samples/conditioned-activity-group.md)  
+ 旅行の予約アプリケーションを示します。  
+  
+ [ポリシーを使用した注文処理](../../../../docs/framework/windows-workflow-foundation/samples/order-processing-with-policy.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] の [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] で導入されたいくつかの主要な機能を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/scenario.md b/docs/framework/windows-workflow-foundation/samples/scenario.md
new file mode 100644
index 00000000000..1d0ab9e7bf3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/scenario.md
@@ -0,0 +1,40 @@
+---
+title: "シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cb678fda-79aa-4495-833b-ef570539d4c3
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# シナリオ
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] シナリオの例が含まれています。  
+  
+## このセクションの内容  
+ [アクティビティ ライブラリ](../../../../docs/framework/windows-workflow-foundation/samples/activity-library.md)  
+ ビルトイン アクティビティ ライブラリを使用するシナリオを示すサンプルが含まれています。  
+  
+ [サービス](../../../../docs/framework/windows-workflow-foundation/samples/services.md)  
+ ワークフロー サービスを使用するシナリオを示すサンプルが含まれています。  
+  
+ [トランザクション](../../../../docs/framework/windows-workflow-foundation/samples/transactions.md)  
+ トランザクションを使用するシナリオを示すサンプルが含まれています。  
+  
+ [自動確認パターン](../../../../docs/framework/windows-workflow-foundation/samples/auto-confirm-pattern.md)  
+ カスタム `AutoConfirmScope` アクティビティを示す 3 つのシナリオで構成されます。  
+  
+ [FlowChart と Pick の組み合わせを使用する StateMachine シナリオ](../../../../docs/framework/windows-workflow-foundation/samples/statemachine-scenario-using-a-combination-of-flowchart-and-pick.md)  
+ <xref:System.Activities.Statements.Flowchart> アクティビティと <xref:System.Activities.Statements.Pick> アクティビティを組み合わせて簡単なストップウォッチ シナリオを実装する方法を示します。  
+  
+ [XAML での WPF と WF の統合](../../../../docs/framework/windows-workflow-foundation/samples/wpf-and-wf-integration-in-xaml.md)  
+ [!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] および [!INCLUDE[wf](../../../../includes/wf-md.md)] 機能を使用するアプリケーションを 1 つの XAML ドキュメントで作成する方法を示します。これを実現するために、サンプルでは [!INCLUDE[wf](../../../../includes/wf-md.md)] および XAML 機能拡張を使用します。  
+  
+ [External RuleSet Toolkit](../../../../docs/framework/windows-workflow-foundation/samples/external-ruleset-toolkit.md)  
+ データベースで RuleSet を管理および編集し、実行時にそれらの RuleSet にワークフローからアクセスする方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/securing-workflow-services.md b/docs/framework/windows-workflow-foundation/samples/securing-workflow-services.md
new file mode 100644
index 00000000000..87c15dd9240
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/securing-workflow-services.md
@@ -0,0 +1,59 @@
+---
+title: "ワークフロー サービスのセキュリティ保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 53f84ad5-1ed1-4114-8d0d-b12e8a021c6e
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ワークフロー サービスのセキュリティ保護
+セキュリティで保護されたワークフロー サービス サンプルでは、次の手順を示します。  
+  
+-   <xref:System.ServiceModel.Activities.Receive> アクティビティと <xref:System.ServiceModel.Activities.SendReply> アクティビティを使用して基本ワークフロー サービスを作成する。  
+  
+-   [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] 構成を使用して、ワークフロー サービスで使用するセキュリティで保護されたエンドポイントを定義する。  
+  
+-   カスタム ポリシー内にクレームを作成し、<xref:System.ServiceModel.ServiceAuthorizationManager> を使用してクレームを検証する。  
+  
+## 使用例  
+ WCF セキュリティを使用して、クライアントとワークフロー サービス間の通信、クレーム ベースの承認を保護します。  
+  
+## 説明  
+ このサンプルでは、[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] セキュリティ インフラストラクチャを使用して、通常の [!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] サービスと同様にワークフロー サービスをセキュリティで保護する方法を示します。具体的には、承認にカスタム クレームを使用します。この例では、<xref:System.ServiceModel.WSHttpBinding> とメッセージ モード セキュリティを Windows 資格情報と共に使用します。  
+  
+ カスタムの <xref:System.IdentityModel.Policy.IAuthorizationPolicy> \(`CustomNameCheckerPolicy`\) は、クライアントの Windows ユーザー名をチェックし、特定の文字がないか確認します。該当する文字がある場合は、クレームを作成して <xref:System.IdentityModel.Policy.EvaluationContext> に追加します。このようにすることで、カスタム ポリシーは、クライアントのユーザー名にこの文字が含まれていることを示すステートメントを作成します。このクレームは、呼び出しの有効期間においてクエリできます。該当の文字は `Constants.cs` で検索できます。  
+  
+ 承認ポリシーは、`SecureWorkFlowAuthZManager` 内のクレームを探します。クレームが見つかると、`true` を返し、ワークフローを続行できるようにします。クレームが見つからない場合は、`false` を返し、クライアントには "アクセスは拒否されました" メッセージが返されます。他のクレームもコンテキスト内にあり、`SecureWorkFlowAuthZManager` 内で調べることができます。  
+  
+#### このサンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を管理者権限で実行します。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] に SecuringWorkflowServices.sln を読み込みます。  
+  
+3.  Ctrl キーと Shift キーを押しながら B キーを押してソリューションをコンパイルします。  
+  
+4.  Service プロジェクトをソリューションのスタートアップ プロジェクトに設定します。  
+  
+5.  Ctrl キーを押しながら F5 キーを押して、デバッグを行わずにサービスを起動します。  
+  
+6.  Client プロジェクトをソリューションのスタートアップ プロジェクトに設定します。  
+  
+7.  Ctrl キーを押しながら F5 キーを押して、デバッグを行わずにクライアントを起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Services\SecuringWorkflowServices`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/sending-and-handling-faults.md b/docs/framework/windows-workflow-foundation/samples/sending-and-handling-faults.md
new file mode 100644
index 00000000000..3df48914124
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/sending-and-handling-faults.md
@@ -0,0 +1,53 @@
+---
+title: "エラーの送信と処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 98e8e04d-2ac9-4a33-ae08-462f757a7a14
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# エラーの送信と処理
+このサンプルでは、<xref:System.ServiceModel.Activities.SendReply> および <xref:System.ServiceModel.Activities.ReceiveReply> メッセージング アクティビティを使用して、予期したエラーと予期しないエラーを送受信する方法を示します。このシナリオでは、最初のクライアント要求で、その <xref:System.ServiceModel.Activities.Send.KnownTypes%2A> コレクションに含まれている予期したエラーが発生します。次のいくつかのクライアント要求によって、予期しないエラーを受信してから、最後の要求が成功します。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] アイコンを右クリックして **\[管理者として実行\]** をクリックし、昇格されたアクセス許可で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  Faults.sln ソリューション ファイルを開きます。  
+  
+3.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+4.  サービス プロジェクトを実行します。  
+  
+    1.  **ソリューション エクスプローラー**で `FaultService` プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+    2.  Ctrl キーを押しながら、F5 キーを押します。  
+  
+5.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] アイコンを右クリックして **\[管理者として実行\]** をクリックし、昇格されたアクセス許可で [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] の別のコピーを開きます。  
+  
+6.  Faults.sln ソリューション ファイルを開きます。  
+  
+7.  クライアント プロジェクトを実行します。  
+  
+    1.  **ソリューション エクスプローラー**で `FaultClient` プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+    2.  Ctrl キーを押しながら、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\Faults`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/sendmail-custom-activity.md b/docs/framework/windows-workflow-foundation/samples/sendmail-custom-activity.md
new file mode 100644
index 00000000000..35a5983010d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/sendmail-custom-activity.md
@@ -0,0 +1,152 @@
+---
+title: "SendMail カスタム アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 947a9ae6-379c-43a3-9cd5-87f573a5739f
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# SendMail カスタム アクティビティ
+このサンプルでは、<xref:System.Activities.AsyncCodeActivity> から派生するカスタム アクティビティを作成して、SMTP を使用して電子メールを送信し、ワークフロー アプリケーション内で使用する方法を示します。カスタム アクティビティは <xref:System.Net.Mail.SmtpClient> の機能を使用して、電子メールを非同期的に送信したり、電子メールを認証付きで送信します。また、テスト モード、トークン置換、ファイル テンプレート、テスト ドロップ パスなどのエンドユーザーの機能も提供しています。  
+  
+ 次の表で、`SendMail` アクティビティの引数の詳細を説明します。  
+  
+||||  
+|-|-|-|  
+|名前|型|説明|  
+|Host|文字列|SMTP サーバー ホストのアドレス。|  
+|Port|文字列|ホストの SMTP サービスのポート。|  
+|EnableSsl|ブール値|<xref:System.Net.Mail.SmtpClient> が、接続を暗号化するために SSL \(Secure Sockets Layer\) を使用するかどうかを指定します。|  
+|UserName|文字列|差出人の <xref:System.Net.Mail.SmtpClient.Credentials%2A> プロパティを認証する資格情報を設定するユーザー名。|  
+|Password|文字列|差出人の <xref:System.Net.Mail.SmtpClient.Credentials%2A> プロパティを認証する資格情報を設定するパスワード。|  
+|Subject|<xref:System.Activities.InArgument%601>\<文字列\>|メッセージの件名。|  
+|Body|<xref:System.Activities.InArgument%601>\<文字列\>|メッセージの本文。|  
+|Attachments|<xref:System.Activities.InArgument%601>\<文字列\>|この電子メール メッセージに添付されるデータの格納に使用される添付データのコレクション。|  
+|From|<xref:System.Net.Mail.MailAddress>|この電子メール メッセージの差出人アドレス。|  
+|To|<xref:System.Activities.InArgument%601>\<<xref:System.Net.Mail.MailAddressCollection>\>|この電子メール メッセージの受信者を格納するアドレスのコレクション。|  
+|CC|<xref:System.Activities.InArgument%601>\<<xref:System.Net.Mail.MailAddressCollection>\>|この電子メール メッセージの CC \(carbon copy\) 受信者を格納するアドレスのコレクション。|  
+|BCC|<xref:System.Activities.InArgument%601>\<<xref:System.Net.Mail.MailAddressCollection>\>|この電子メール メッセージの BCC \(blind carbon copy\) 受信者を格納するアドレスのコレクション。|  
+|Tokens|<xref:System.Activities.InArgument%601>\<IDictionary\<文字列,文字列\>\>|本文で置換するトークン。この機能を使用すると、本文にいくつかの値を指定した後、このプロパティを使用して提供されるトークンで置換できます。|  
+|BodyTemplateFilePath|文字列|本文のテンプレートのパス。`SendMail` アクティビティは、このファイルの内容をその body プロパティにコピーします。<br /><br /> テンプレートは、tokens プロパティの内容によって置き換えられるトークンを含めることができます。|  
+|TestMailTo|<xref:System.Net.Mail.MailAddress>|このプロパティを設定すると、すべての電子メールがそのプロパティで指定されているアドレスに送信されます。<br /><br /> このプロパティは、ワークフローをテストするときに使用するためのものです。たとえば、実際の受信者に送信せずに、すべての電子メールが送信されることを確認します。|  
+|TestDropPath|文字列|このプロパティを設定すると、すべての電子メールが指定したファイルにも保存されます。<br /><br /> このプロパティは、ワークフローのテストやデバッグを行うときに使用したり、送信する電子メールの形式や内容が適切であることを確認するためのものです。|  
+  
+## ソリューションのコンテンツ  
+ ソリューションには、次の 2 つのプロジェクトが含まれています。  
+  
+|プロジェクト|説明|重要なファイル|  
+|------------|--------|-------------|  
+|SendMail|SendMail アクティビティ|1.  SendMail.cs: main アクティビティの実装<br />2.  SendMailDesigner.xaml および SendMailDesigner.xaml.cs: SendMail アクティビティのデザイナー<br />3.  MailTemplateBody.htm: 送信される電子メールのテンプレート|  
+|SendMailTestClient|SendMail アクティビティをテストするクライアント。このプロジェクトでは、SendMail アクティビティを宣言的に起動する方法とプログラムで起動する方法を示します。|1.  Sequence1.xaml: SendMail アクティビティを起動するワークフロー<br />2.  Program.cs: Sequence1 を呼び出し、SendMail を使用するワークフローもプログラムで作成します。|  
+  
+## SendMail アクティビティの追加構成  
+ サンプルには表示されませんが、SendMail アクティビティの追加構成を実行できます。次の 3 つのセクションは、その方法を示しています。  
+  
+### 本文で指定されたトークンを使用した電子メールの送信  
+ 次のコード スニペットでは、本文のトークンを使用して電子メールを送信する方法を示します。トークンが body プロパティに指定されていることに注目してください。それらのトークンの値は、tokens プロパティに指定されています。  
+  
+```html  
+IDictionary<string, string> tokens = new Dictionary<string, string>();  
+tokens.Add("@name", "John Doe");  
+tokens.Add("@date", DateTime.Now.ToString());  
+tokens.Add("@server", "localhost");  
+  
+new SendMail  
+{  
+    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),  
+    To = new LambdaValue<MailAddressCollection>(  
+                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),  
+    Subject = "Test email",  
+    Body = "Hello @name. This is a test email sent from @server. Current date is @date",  
+    Host = "localhost",  
+    Port = 25,  
+    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens)  
+};  
+  
+```  
+  
+### テンプレートを使用した電子メールの送信  
+ 次のスニペットでは、本文のテンプレート トークンを使用して電子メールを送信する方法を示します。`BodyTemplateFilePath` プロパティを設定するときに、Body プロパティの値を指定する必要がないことに注目してください \(テンプレート ファイルのコンテンツは本文にコピーされます\)。  
+  
+```  
+new SendMail  
+{    
+    From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),  
+    To = new LambdaValue<MailAddressCollection>(  
+                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),  
+    Subject = "Test email",  
+    Host = "localhost",  
+    Port = 25,  
+    Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),  
+    BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",   
+};  
+  
+```  
+  
+### テスト モードでの電子メールの送信  
+ 次のコード スニペットでは、2 つのテスト プロパティを設定する方法を示します。すべてのメッセージに `TestMailTo` を設定すると、\(To、Cc、Bcc の値に関係なく\) john.doe@contoso.con に送信されます。TestDropPath を設定すると、送信するすべての電子メールは、指定したパスにも記録されます。これらのプロパティは、個別に設定できます \(関連していません\)。  
+  
+```  
+new SendMail  
+{    
+   From = new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),  
+   To = new LambdaValue<MailAddressCollection>(  
+                    ctx => new MailAddressCollection() { new MailAddress("someone@microsoft.com") }),  
+   Subject = "Test email",  
+   Host = "localhost",  
+   Port = 25,  
+   Tokens = new LambdaValue<IDictionary<string, string>>(ctx => tokens),  
+   BodyTemplateFilePath = @"..\..\..\SendMail\Templates\MailTemplateBody.htm",  
+   TestMailTo= new LambdaValue<MailAddress>(ctx => new MailAddress("john.doe@contoso.com")),  
+   TestDropPath = @"c:\Samples\SendMail\TestDropPath\",  
+};  
+  
+```  
+  
+## セットアップ手順  
+ このサンプルでは SMTP サーバーにアクセスする必要があります。  
+  
+ SMTP サーバーの設定[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、次のリンクを参照してください。  
+  
+-   [Microsoft Technet](http://go.microsoft.com/fwlink/?LinkId=166060)  
+  
+-   [SMTP サービス \(IIS 6.0\) の構成](http://go.microsoft.com/fwlink/?LinkId=150456)  
+  
+-   [IIS 7.0: SMTP 電子メールの構成](http://go.microsoft.com/fwlink/?LinkId=150457)  
+  
+-   [SMTP サービスをインストールする方法](http://go.microsoft.com/fwlink/?LinkId=150458)  
+  
+ ダウンロードには、サードパーティで提供されている SMTP エミュレーターを使用できます。  
+  
+##### このサンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、SendMail.sln ソリューション ファイルを開きます。  
+  
+2.  有効な SMTP サーバーへのアクセス権があることを確認してください。セットアップ手順を参照してください。  
+  
+3.  サーバー アドレスと電子メールの差出人アドレスおよび宛先アドレスを使用してプログラムを構成します。  
+  
+     このサンプルを正しく実行するには、電子メールの差出人アドレスおよび宛先アドレスの値と Program.cs および Sequence.xaml の SMTP サーバーのアドレスを設定する必要がある場合があります。プログラムでは電子メールが 2 つの方法で送信されるため、両方の場所でアドレスを変更する必要があります。  
+  
+4.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+5.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\SendMail`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/services.md b/docs/framework/windows-workflow-foundation/samples/services.md
new file mode 100644
index 00000000000..01949ee8720
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/services.md
@@ -0,0 +1,58 @@
+---
+title: "サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 521cdb66-98cb-4ad1-b706-370788a43485
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# サービス
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] のサービス機能を示すサンプルへのリンクが含まれています。  
+  
+## このセクションの内容  
+ [絶対遅延](../../../../docs/framework/windows-workflow-foundation/samples/absolute-delay.md)  
+ 永続的な遅延を使用する方法を示します。これは、遅延の間、ワークフローを永続的なデバイスに永続化する遅延のことです。  
+  
+ [永続的な遅延](../../../../docs/framework/windows-workflow-foundation/samples/durable-delay.md)  
+ 永続的な遅延を使用する方法を示します。これは、遅延の間、ワークフローを永続的なデバイスに永続化する遅延のことです。  
+  
+ [エラーの送信と処理](../../../../docs/framework/windows-workflow-foundation/samples/sending-and-handling-faults.md)  
+ <xref:System.ServiceModel.Activities.SendReply> および <xref:System.ServiceModel.Activities.ReceiveReply> メッセージング アクティビティを使用して、予期したエラーと予期しないエラーを送受信する方法を示します。  
+  
+ [SendParameters および ReceiveParameters アクティビティの基本的な使用方法](../../../../docs/framework/windows-workflow-foundation/samples/basic-usage-of-sendparameters-and-receiveparameters-activities.md)  
+ <xref:System.ServiceModel.Activities.SendParameters> および <xref:System.ServiceModel.Activities.ReceiveParameters> アクティビティの使用法を示します。  
+  
+ [基本的な XAML 専用サービス](../../../../docs/framework/windows-workflow-foundation/samples/basic-xaml-only-service.md)  
+ XAML 専用サービスを作成する方法を示します。  
+  
+ [ワークフロー サービスでのメッセージの書式設定](../../../../docs/framework/windows-workflow-foundation/samples/formatting-messages-in-workflow-services.md)  
+ メッセージング アクティビティ \(WF サービス\) で使用できるユーザーの種類を示します。サンプルのサービスは、簡単な費用承認サービスで、3 つの操作を公開します。  
+  
+ [永続的な二重](../../../../docs/framework/windows-workflow-foundation/samples/durable-duplex.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] のメッセージング アクティビティを使用して、永続的な双方向メッセージ交換を設定および構成する方法を示します。  
+  
+ [コンテンツ ベースの相関関係](../../../../docs/framework/windows-workflow-foundation/samples/content-based-correlation.md)  
+ メッセージング アクティビティ \(<xref:System.ServiceModel.Activities.Send>、<xref:System.ServiceModel.Activities.Receive>、<xref:System.ServiceModel.Activities.SendReply>、および <xref:System.ServiceModel.Activities.ReceiveReply>\) を 1 つまたは複数のコンテンツ ベースの相関関係で使用する方法を示します。  
+  
+ [Send によるチャネル キャッシュ](../../../../docs/framework/windows-workflow-foundation/samples/channel-caching-with-send.md)  
+ <xref:System.ServiceModel.Activities.SendMessageChannelCache> の使用方法を示します。  
+  
+ [XAMLX における永続的な遅延](../../../../docs/framework/windows-workflow-foundation/samples/durable-delay-in-xamlx.md)  
+ 永続的な遅延を使用する方法を示します。これは、遅延の間、ワークフローを永続的なデバイスに永続化する遅延のことです。  
+  
+ [バッファーされた受信機能](../../../../docs/framework/windows-workflow-foundation/samples/buffered-receive.md)  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] のバッファーされた受信機能を設定および構成する方法を示します。  
+  
+ [XAML アクティベーション](../../../../docs/framework/windows-workflow-foundation/samples/xaml-activation.md)  
+ 宣言型ワークフローを [!INCLUDE[iisver](../../../../includes/iisver-md.md)] でホストする方法を示します。  
+  
+## 参照  
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/simple-policy.md b/docs/framework/windows-workflow-foundation/samples/simple-policy.md
new file mode 100644
index 00000000000..05b0b3ceafe
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/simple-policy.md
@@ -0,0 +1,46 @@
+---
+title: "簡単なポリシー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6a94c834-2e32-4bed-9f47-ae5845eef6ff
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# 簡単なポリシー
+このサンプルでは、ワークフロー内で <xref:System.Workflow.Activities.PolicyActivity> アクティビティを使用する方法を示します。  
+  
+ このサンプルのシーケンシャル ワークフローは、<xref:System.Workflow.Activities.PolicyActivity> アクティビティを使用して作成します。ワークフローは、製品割引ワークフローを定義するために使用するフィールド `orderValue`、`customerType`、および `discount` を定義します。ルール ファイルに定義済みのルールは、`orderValue` と `customerType` に基づいて、割引金額を設定します。`orderValue` と `customerType` が `SimplePolicyWorkflow` クラス定義で設定されています。これを変更すると、動作を変更できます。結果として得られた割引率は、`SimplePolicyWorkflow` クラスに定義されているイベント ハンドラ <xref:System.Workflow.Runtime.WorkflowRuntime.WorkflowCompleted> でコンソールに出力されます。  
+  
+### サンプルをビルドするには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、ソリューションを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押して、ソリューションをデバッグなしで実行します。  
+  
+### サンプルを実行するには  
+  
+-   \[SDK コマンド プロンプト\] ウィンドウで、SimplePolicy\\bin\\debug フォルダー \(Visual Basic バージョンのサンプルの場合は SimplePolicy\\bin フォルダー\) にある .exe ファイルを実行します。このフォルダーは、サンプルのメイン フォルダーの下に作成されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Rules\Policy\SimplePolicy`  
+  
+## 参照  
+ <xref:System.Workflow.Activities.Rules.RuleSet>   
+ <xref:System.Workflow.Activities.PolicyActivity>   
+ [高度なポリシー](../../../../docs/framework/windows-workflow-foundation/samples/advanced-policy.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/sql-tracking.md b/docs/framework/windows-workflow-foundation/samples/sql-tracking.md
new file mode 100644
index 00000000000..e28244d220f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/sql-tracking.md
@@ -0,0 +1,68 @@
+---
+title: "SQL 追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: bcaebeb1-b9e5-49e8-881b-e49af66fd341
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# SQL 追跡
+このサンプルでは、追跡レコードを SQL データベースに書き込むカスタム SQL 追跡参加要素を作成する方法を示します。[!INCLUDE[wf](../../../../includes/wf-md.md)] には、ワークフロー インスタンスの実行を視覚的に示すワークフロー追跡機能が用意されています。追跡ランタイムでは、ワークフローの実行中にワークフロー追跡レコードが出力されます。ワークフロー追跡機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[ワークフロー追跡とトレース](../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)を参照してください。  
+  
+#### このサンプルを使用するには  
+  
+1.  SQL Server 2008、SQL Server 2008 Express、またはそれ以降のバージョンがインストールされていることを確認します。サンプルと共にパッケージ化されているスクリプトは、SQL Express インスタンスをローカル コンピューターで使用していることが前提になります。別のインスタンスがある場合は、データベース関連のスクリプトを変更してからサンプルを実行してください。  
+  
+2.  Scripts ディレクトリ \(\\WF\\Basic\\Tracking\\SqlTracking\\CS\\Scripts\) 内で Trackingsetup.cmd を実行して SQL Server 追跡データベースを作成します。これによって、TrackingSample という名前のデータベースが作成されます。  
+  
+    > [!NOTE]
+    >  このスクリプトでは、SQL Express の既定のインスタンスにデータベースが作成されます。別のデータベース インスタンスにインストールする場合は、Trackingsetup.cmd スクリプトを編集してください。  
+  
+3.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で SqlTrackingSample.sln を開きます。  
+  
+4.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+5.  F5 キーを押してアプリケーションを実行します。  
+  
+     ブラウザー ウィンドウが開き、アプリケーションのディレクトリの一覧が示されます。  
+  
+6.  ブラウザーで、StockPriceService.xamlx をクリックします。  
+  
+7.  ブラウザーに、\[StockPriceService\] ページが表示され、ローカル サービスの WSDL アドレスが示されます。このアドレスをコピーします。  
+  
+     ローカル サービスの WSDL アドレスは、http:\/\/localhost:65193\/StockPriceService.xamlx?wsdl などになります。  
+  
+8.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を使用して、WCF テスト クライアント \(WcfTestClient.exe\) を実行します。このテスト クライアントは Microsoft Visual Studio 10.0\\Common7\\IDE ディレクトリにあります。  
+  
+9. WCF テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。テキスト ボックスにローカル サービスのアドレスを貼り付けます。**\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+10. WCF テスト クライアントで、**\[GetStockPrice\]** をダブルクリックします。これで、1 つのパラメーターを使用する `GetStockPrice` 操作が開きます。「`Contoso`」という値を入力し、**\[呼び出し\]** をクリックします。  
+  
+11. 出力された追跡レコードが SQL データベースに書き込まれます。追跡レコードを表示するには、SQL Management Studio で TrackingSample データベースを開き、テーブルに移動します。SQL Server Management Studio [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SQL Server Management Studio の概要](http://go.microsoft.com/fwlink/?LinkId=165645)」を参照してください。SQL Server 2008 Management Studio Express は、[ここ](http://go.microsoft.com/fwlink/?LinkId=180520)からダウンロードできます。テーブルで選択クエリを実行すると、それぞれのテーブルに格納されている追跡レコード内のデータが表示されます。  
+  
+#### サンプルをアンインストールするには  
+  
+1.  サンプル ディレクトリ \(\\WF\\Basic\\Tracking\\SqlTracking\) で Trackingcleanup.cmd スクリプトを実行します。  
+  
+    > [!NOTE]
+    >  Trackingcleanup.cmd は、ローカル コンピューターの SQL Express 内にあるデータベースを削除しようとします。別の SQL Server インスタンスを使用している場合は、Trackingcleanup.cmd を編集します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\SqlTracking`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/sqlstoreextensibility.md b/docs/framework/windows-workflow-foundation/samples/sqlstoreextensibility.md
new file mode 100644
index 00000000000..cf35d751588
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/sqlstoreextensibility.md
@@ -0,0 +1,88 @@
+---
+title: "SQLStoreExtensibility | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 5da1b5a3-f144-41ba-b9c4-02818b28b15d
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# SQLStoreExtensibility
+このサンプルでは、SQL ワークフロー インスタンス ストアの昇格したプロパティの使用法と構成を示します。SQL Workflow Instance Store は、SQL ベースのインスタンス ストアの実装です。SQL Workflow Instance Store を使用すると、インスタンスの状態を SQL Server データベースや SQL Server Express データベースに保存したり読み込んだりすることができます。ストア拡張機能を使用すると、ユーザーは、インスタンス ストアに格納されるプロパティを定義できます。このようなプロパティは、ユーザーがクエリを実行できる昇格したプロパティ ビューに表示されます。  
+  
+ このサンプルは、カウント サービスを実装するワークフローで構成されています。サービスの start メソッドが呼び出されると、0 から 29 までのカウントが行われます。カウンターは 2 秒ごとにインクリメントされ、カウントのたびにワークフローが永続化されます。現在のカウンター値は、昇格したプロパティとしてインスタンス ストアに格納されます。  
+  
+ このカウント ワークフローは、ワークフロー サービス ホストによってホストされる自己ホスト型サービスです。プログラムの `Main` メソッドは、次のアクションを実行します。  
+  
+-   カウント ワークフローをホストするワークフロー サービス ホストのインスタンスを作成し、カウント ワークフローにアクセスできるエンドポイントを定義します。  
+  
+-   SQL Workflow Instance Store を構成するために使用される SQL Workflow Instance Store の動作を定義します。このストアは、`CountStatus` を昇格したプロパティとして扱うように指示されます。  
+  
+-   カウント ワークフローの start メソッドを呼び出すクライアントを作成します。  
+  
+ プログラムを開始すると、カウンターが自動的にカウントを開始します。インスタンスを読み込んで SQL Workflow Instance Store を構成するのに数秒かかる場合もあります。  
+  
+ カウンター値をカスタム プロパティとして昇格するには、次の手順を実行する必要があります。  
+  
+1.  クラス `CounterStatus` は、<xref:System.Activities.Persistence.PersistenceParticipant> 型のインスタンス拡張機能を定義し、この型はアクティビティが状態変数を提供するために使用されます。`Count` は書き込み専用値として定義されます。ワークフロー インスタンスが永続性ポイントに達すると、インスタンス拡張機能によって、`Count` プロパティが永続性データ コレクションに保存されます。  
+  
+2.  インスタンス ストアの作成時に、新しいプロパティ `CountStatus` が `store.Promote()` を使用して定義されます。  
+  
+3.  ワークフローの `SaveCounter` アクティビティによって、現在のカウンター値が `Count` 状態フィールドに代入されます。  
+  
+### このサンプルを使用するには  
+  
+1.  インスタンス ストア データベースを作成します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトを開きます。  
+  
+    2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトでサンプル ディレクトリ \(\\WF\\Basic\\Persistence\\SqlStoreExtensibility\\CS\) に移動して、CreateInstanceStore.cmd を実行します。  
+  
+        > [!WARNING]
+        >  CreateInstanceStore.cmd スクリプトは、SQL Server 2008 Express の既定のインスタンスにデータベースを作成しようとします。別のインスタンスにデータベースをインストールする場合は、そのようにスクリプトを変更してください。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を開いて SqlStoreExtensibility.sln ソリューションを読み込み、CTRL キーと SHIFT キーを押しながら B キーを押してビルドします。  
+  
+    > [!WARNING]
+    >  SQL Server の既定以外のインスタンスにデータベースをインストールした場合は、ソリューションをビルドする前に、コードの接続文字列を更新してください。  
+  
+3.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] でプロジェクトの bin ディレクトリ \(\\WF\\Basic\\Persistence\\SqlStoreExtensibility\\bin\\Debug\) に移動し、SqlStoreExtensibility.exe を右クリックして **\[管理者として実行\]** をクリックすることで、サンプルを管理者権限で実行します。  
+  
+### サンプルが正常に動作していることを確認するには  
+  
+1.  SQL Server Management Studio を使用して、オブジェクト エクスプローラーで **\[データベース\]**、**\[InstanceStore\]**、**\[System.ServiceModel.Activities.DurableInstancing.InstanceTable\]** の順に選択してインスタンス テーブルの内容を表示し、**\[System.ServiceModel.Activities.DurableInstancing.InstanceTable\]** を右クリックして **\[上位 1000 行を選択\]** をクリックします。SQL Server Management Studio [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[SQL Server Management Studio の概要](http://go.microsoft.com/fwlink/?LinkId=165645)」を参照してください。  
+  
+2.  一覧表示されるワークフロー インスタンスを確認します。  
+  
+3.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトで、サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\SqlStoreExtensibility\) にある QueryInstanceStore.cmd スクリプトを実行します。  
+  
+4.  **CountStatus** の下に表示されるカウンター値を確認します。  
+  
+5.  スクリプトを数回実行して **CountStats** の値の変化を確認します。  
+  
+6.  Enter キーを押してワークフロー アプリケーションを終了します。  
+  
+### サンプルをアンインストールするには  
+  
+1.  サンプル ディレクトリ \(\\WF\\Basic\\Persistence\\SqlStoreExtensibility\) にある RemoveInstanceStore.cmd スクリプトを実行して、インスタンス ストア データベースを削除します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\SQLStoreExtensibility`  
+  
+## 参照  
+ [ワークフローの永続性](../../../../docs/framework/windows-workflow-foundation//workflow-persistence.md)   
+ [ワークフロー サービス](../../../../docs/framework/wcf/feature-details/workflow-services.md)   
+ [AppFabric のホストおよび永続化のサンプル](http://go.microsoft.com/fwlink/?LinkId=193961)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/statemachine-scenario-using-a-combination-of-flowchart-and-pick.md b/docs/framework/windows-workflow-foundation/samples/statemachine-scenario-using-a-combination-of-flowchart-and-pick.md
new file mode 100644
index 00000000000..0b65807321c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/statemachine-scenario-using-a-combination-of-flowchart-and-pick.md
@@ -0,0 +1,67 @@
+---
+title: "FlowChart と Pick の組み合わせを使用する StateMachine シナリオ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 88d81395-f7a3-41d8-8439-20a425c538a6
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# FlowChart と Pick の組み合わせを使用する StateMachine シナリオ
+このサンプルでは、<xref:System.Activities.Statements.Flowchart> アクティビティと <xref:System.Activities.Statements.Pick> アクティビティを組み合わせて簡単なストップウォッチ シナリオを実装する方法を示します。このサンプルでは、Pick アクティビティ内で Receive と Send を使用して、ストップウォッチ イベントをリッスンします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、ダウンロード ページに移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\StateMachineWithPick`  
+  
+## サンプルの詳細  
+ 次の表に、このサンプルのプロジェクトを示します。  
+  
+|||  
+|-|-|  
+|プロジェクト名|説明|  
+|StopWatchService|このプロジェクトには、<xref:System.Activities.Statements.Flowchart> アクティビティと <xref:System.Activities.Statements.Pick> アクティビティを組み合わせて使用するストップウォッチ サンプルのステート マシンの実装が含まれます。<br /><br /> <xref:System.Activities.Statements.Pick> アクティビティには、`GetStart`、`GetStop`、および `GetOff` の各イベントをリッスンする 3 つの <xref:System.Activities.Statements.PickBranch> ステートメントが <xref:System.Activities.Statements.Pick.Branches%2A> プロパティ内にあります。受信イベントに基づいて、分岐のいずれかのトリガーがアクティブになり、対応する <xref:System.Activities.Statements.PickBranch.Action%2A> が起動されます。<xref:System.Activities.Statements.PickBranch.Action%2A> プロパティには、遷移が正当な遷移であるかどうかを評価する <xref:System.Activities.Statements.Switch%601> ステートメントがあります。正当な遷移の場合、`currentState` プロパティが遷移中の状態に更新され、クライアントに送信されます。<br /><br /> <xref:System.Activities.Statements.Flowchart> の最後にある <xref:System.Activities.Statements.FlowDecision> アクティビティは、`currentState` プロパティを評価して、終了状態であるかどうかを確認します。終了状態の場合、ワークフローは終了します。それ以外の場合は、<xref:System.Activities.Statements.Pick> アクティビティの先頭に戻ります。このアクティビティでは、ワークフローは他のストップウォッチ イベントを待機します。|  
+|StopWatchClient|このプロジェクトは、簡単な Send アクティビティまたは Receive アクティビティを組み合わせてさまざまなストップウォッチ イベントを送信する簡単なシーケンシャル ワークフロー コンソール アプリケーションです。|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、StateMachineWithPick.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] から StopWatchService.exe を管理者として開始します。これを行うには、.exe ファイルを右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+    1.  StateMachineWithPick\\CS\\StopWatchService\\bin\\Debug フォルダーに移動します。  
+  
+    2.  StopWatchService.exe ファイルを右クリックし、**\[管理者として実行\]** をクリックします。  
+  
+4.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] 内から StopWatchClient クライアント アプリケーションを開始します。  
+  
+    1.  **ソリューション エクスプローラー**で、**StopWatchClient** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+    2.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+5.  状態遷移を確認するには、StopWatchService.exe のコンソール ウィンドウに切り替えます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\StateMachineWithPick`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/suppress-transaction-scope.md b/docs/framework/windows-workflow-foundation/samples/suppress-transaction-scope.md
new file mode 100644
index 00000000000..ea4f7ddaeef
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/suppress-transaction-scope.md
@@ -0,0 +1,60 @@
+---
+title: "トランザクション スコープの抑制 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 49fb6dd4-30d4-4067-925c-c5de44c8c740
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# トランザクション スコープの抑制
+このサンプルでは、アンビエント ランタイム トランザクションが存在する場合はそのトランザクションを抑制するカスタム `SuppressTransactionScope` アクティビティを作成する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\SuppressTransactionScope`  
+  
+## サンプルの詳細  
+ このカスタム アクティビティを使用すると、トランザクション フローが特定のシナリオに適さない場合に、別のサービスにトランザクションがフローされないようにすることができます。ワークフロー ランタイムには <xref:System.Activities.NativeActivity> クラスのアンビエント トランザクションを抑制するためのサポートが組み込まれていますが、そのサポートを使用するには、このサンプルで示すようなカスタム <xref:System.Activities.NativeActivity> アクティビティを作成する必要があります。  
+  
+ このシナリオは、3 つの部分で構成されています。まず、<xref:System.Activities.Statements.TransactionScope> によって、アンビエントになるランタイム トランザクションが作成されます。これは、トランザクションのローカル識別子と分散識別子を出力するカスタム アクティビティによって検証されます。その後、トランザクションがリモート サービスにフローされてから、2 番目の部分が始まります。2 番目の部分では、ワークフローが `SuppressTransactionScope` に移り、トランザクション識別子を出力してトランザクションをフローさせるプロセスがもう一度繰り返されます。ただし、カスタム アクティビティでアンビエント トランザクションを探さないため、サービスにフローされるメッセージにはトランザクションが含まれません。その結果、サービスによってトランザクションが作成され、クライアントとサービスで出力される分散 ID が一致しなくなります。最後の部分は、`SuppressTransactionScope` が終了した後の部分です。分散識別子が最初のメッセージの識別子と一致する別のメッセージがサービスにフローされ、そのメッセージによる検証でランタイム トランザクションがもう一度アンビエントになります。  
+  
+ アクティビティ自体は、子アクティビティをスケジュールして実行プロパティを追加する必要があるため、<xref:System.Activities.NativeActivity> から派生します。`SuppressTransactionScope` には、<xref:System.Activities.RuntimeTransactionHandle> 型の <xref:System.Activities.Variable> が含まれます。ハンドルを初期化する必要があるため、<xref:System.Activities.RuntimeTransactionHandle> 型のインスタンス フィールドではなく、この変数を使用する必要があります。`Variable<RuntimeTransactionHandle>` は内部でのみ使用されるため、実装変数としてアクティビティのメタデータに追加されます。  
+  
+ アクティビティを実行すると、まず本体が指定されているかどうかがチェックされ、指定されていれば <xref:System.Activities.RuntimeTransactionHandle> に `SuppressTransaction` プロパティが設定されます。このプロパティは、設定されると実行プロパティに追加され、アンビエントになります。つまり、`SuppressTransactionScope` のすべての子アクティビティがこのプロパティを参照できるようになります。これにより、ランタイム トランザクションの抑制が適用され、入れ子になった <xref:System.Activities.Statements.TransactionScope> で例外がスローされます。実行プロパティにハンドルが追加されると、本体の実行がスケジュールされます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で SuppressTransactionScope.sln ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+3.  ビルドが完了したら、ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。ダイアログで、**\[マルチ スタートアップ プロジェクト\]** を選択し、両方のプロジェクトのアクションが **\[開始\]** になっていることを確認します。  
+  
+4.  F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+    > [!NOTE]
+    >  クライアントを起動する前に、サーバーを起動しておく必要があります。サービスをホストするコンソール ウィンドウの出力で、起動された時間が示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\SuppressTransactionScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md b/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md
new file mode 100644
index 00000000000..4b41716a080
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/suspended-instance-management.md
@@ -0,0 +1,91 @@
+---
+title: "中断されたインスタンスの管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f5ca3faa-ba1f-4857-b92c-d927e4b29598
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 中断されたインスタンスの管理
+このサンプルでは、中断されているワークフロー インスタンスを管理する方法を示します。<xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> の既定のアクションは `AbandonAndSuspend` です。つまり、既定では、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるワークフロー インスタンスからスローされた未処理の例外により、インスタンスがメモリから破棄され、インスタンスの永続バージョンが中断状態としてマークされることになります。中断されたワークフロー インスタンスは、中断が解除されるまで実行できません。  
+  
+ このサンプルでは、コマンド ライン ユーティリティを実装して、中断されたインスタンスについてクエリを実行する方法、およびユーザーがインスタンスを再開または終了できるようにする方法を示します。このサンプルでは、ワークフロー サービスから例外が意図的にスローされ、中断状態になります。その後、コマンド ライン ユーティリティを使用してインスタンスについてクエリを実行し、さらに、インスタンスを再開または終了できます。  
+  
+## 使用例  
+ [!INCLUDE[wf](../../../../includes/wf-md.md)] の <xref:System.ServiceModel.Activities.Description.WorkflowUnhandledExceptionBehavior> および <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> を使用する <xref:System.ServiceModel.WorkflowServiceHost>。  
+  
+## 説明  
+ このサンプルに実装されているコマンド ライン ユーティリティは、[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] に用意されている SQL インスタンス ストアの実装に固有のものです。インスタンス ストアのカスタム実装がある場合は、サンプルの `WorkflowInstanceCommand` の実装を、使用しているインスタンス ストアに固有の実装に置き換えることで、このユーティリティを調整できます。  
+  
+ 用意されている実装では、SQL インスタンス ストアに対して SQL コマンドを直接実行して、中断されたインスタンスのリストを取得し、<xref:System.ServiceModel.WorkflowServiceHost> に追加された <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> を使用して、インスタンスを再開または終了できるようにします。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルでは、次の Windows コンポーネントが有効になっている必要があります。  
+  
+    1.  Microsoft メッセージ キュー \(MSMQ\) サーバー  
+  
+    2.  SQL Server Express  
+  
+2.  SQL Server データベースを設定します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] コマンド プロンプトで、SuspendedInstanceManagement サンプル ディレクトリから "setup.cmd" を実行します。これにより、次の操作が行われます。  
+  
+        1.  SQL Server Express を使用して永続性データベースを作成します。永続性データベースが既に存在する場合、データベースは削除され、再作成されます。  
+  
+        2.  永続化のためにデータベースを設定します。  
+  
+        3.  IIS APPPOOL\\DefaultAppPool および NT AUTHORITY\\Network Service を、永続化のためにデータベースを設定するときに定義された InstanceStoreUsers ロールに追加します。  
+  
+3.  サービス キューを設定します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で **SampleWorkflowApp** プロジェクトを右クリックして **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+    2.  **F5** キーを押して SampleWorkflowApp をコンパイルし、実行します。これにより、必要なキューが作成されます。  
+  
+    3.  **Enter** キーを押して SampleWorkflowApp を停止します。  
+  
+    4.  コマンド プロンプトから Compmgmt.msc を実行して、\[コンピューターの管理\] コンソールを開きます。  
+  
+    5.  **\[サービスとアプリケーション\]**、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+    6.  **\[ReceiveTx\]** を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+    7.  **\[セキュリティ\]** タブをクリックし、**Everyone** グループに対して **\[メッセージの受信\]**、**\[メッセージのピーク\]**、および **\[メッセージの送信\]** アクセス許可を与えます。  
+  
+4.  サンプルを実行します。  
+  
+    1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で、**Ctrl** キーを押しながら F5 キーを押して、SampleWorkflowApp プロジェクトをデバッグなしで再度実行します。2 つのエンドポイント アドレスがコンソール ウィンドウに出力されます。1 つはアプリケーション エンドポイントのアドレスで、もう 1 つは <xref:System.ServiceModel.Activities.WorkflowControlEndpoint> のアドレスです。その後、ワークフロー インスタンスが作成され、そのインスタンスの追跡レコードがコンソール ウィンドウに表示されます。ワークフロー インスタンスから例外がスローされ、インスタンスは中断されて中止されます。  
+  
+    2.  次に、コマンド ライン ユーティリティを使用して、これらのインスタンスに対してさらに操作を実行できます。コマンド ライン引数の構文は次のとおりです。  
+  
+         `SuspendedInstanceManagement -Command:[CommandName] -Server:[ServerName] -Database:[DatabaseName] -InstanceId:[InstanceId]`  
+  
+         サポートされるコマンドは、`Query`、`Resume`、および `Terminate` です。InstanceId スイッチを指定する必要があるのは、`Resume` 操作および `Terminate` 操作だけです。  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  `vs2010` コマンド プロンプトから Compmgmt.msc を実行して、\[コンピューターの管理\] コンソールを開きます。  
+  
+2.  **\[サービスとアプリケーション\]**、**\[メッセージ キュー\]**、**\[専用キュー\]** の順に展開します。  
+  
+3.  **\[ReceiveTx\]** キューを削除します。  
+  
+4.  永続性データベースを削除するには、cleanup.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Application\SuspendedInstanceManagement`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/throttled-parallel-foreach.md b/docs/framework/windows-workflow-foundation/samples/throttled-parallel-foreach.md
new file mode 100644
index 00000000000..b869d4fe8e9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/throttled-parallel-foreach.md
@@ -0,0 +1,45 @@
+---
+title: "制限された並列 ForEach | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f2855b5f-e9a7-433d-96a4-40fc31025215
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 制限された並列 ForEach
+`ThrottleParallelForEach` アクティビティは、実行する同時分岐の数を制限するための同時実行要因を設定できるという 1 つの例外を除き、<xref:System.Activities.Statements.ParallelForEach> アクティビティと似ていることについて示します。`ThrottleParallelForEach` アクティビティは、<xref:System.Activities.NativeActivityContext> クラスを介してのみアクセスできる他のアクティビティ \(子アクティビティ\) をスケジュールする必要があるため、<xref:System.Activities.NativeActivity> クラスから派生します。  
+  
+## プロジェクト  
+  
+||||  
+|-|-|-|  
+|**プロジェクト名**|**説明**|**メイン ファイル**|  
+|ThrottledParallelForEach|`ThrottledParallelForEach` アクティビティとそのデザイナーが含まれます。|ThrottledParallelForEach.cs<br /><br /> `ThrottledParallelForEach` アクティビティ定義。|  
+|CodeTestClient|命令型コードを使用して、`ThrottledParallelForEach` を含むワークフローを構成および実行するサンプル クライアント アプリケーション。|Program.cs<br /><br /> サンプル ワークフローのインスタンスを定義および実行します。|  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ThrottledParallelForEach.sln ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\ThrottledParallelForEach`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/toolbox-service.md b/docs/framework/windows-workflow-foundation/samples/toolbox-service.md
new file mode 100644
index 00000000000..56db1f576e9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/toolbox-service.md
@@ -0,0 +1,62 @@
+---
+title: "ツールボックス サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 742212d0-445e-41ed-9739-9ee848ce7f1b
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# ツールボックス サービス
+このサンプルでは、ワークフローのコンテキストに基づいて [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] ツールボックス アクティビティを更新する方法を示します。このサンプルには、カスタム アクティビティが選択されているかどうかに基づいてツールボックスの内容を変更するワークフローが含まれています。  
+  
+## 説明  
+ ワークフローの作成中には、通常、状況に応じてツールボックスが変化することが求められます。たとえば、特定のアクティビティをワークフローに追加すると、別のアクティビティがいくつかツールボックスに表示されるようにすることが必要な場合があります。アクティビティをワークフローから削除したときは、ドメインの要件に基づいてツールボックスが適切に応答する必要があります。  
+  
+ ホストを変更したワークフロー デザイナーでは、ツールボックス コントロールを制御し、ワークフローのモデル変更に基づいて、ホストによってツールボックス コントロールで適切な変更がトリガーされるようにすることができます。ただし、[!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] では、ツールボックスをユーザーが制御することはないので、その内容を変更するにはインターフェイスが必要です。`IActivityToolboxService` がそのインターフェイスにあたります。  
+  
+ この API には、次の 4 つのメソッドが用意されています。  
+  
+```  
+public interface IActivityToolboxService   
+{   
+        void AddCategory(string categoryName);   
+        void RemoveCategory(string categoryName);   
+        void AddItem(string qualifiedTypeName, string categoryName);   
+        void RemoveItem(string qualifiedTypeName, string categoryName);   
+        IList<string> EnumCategories();   
+        IList<string> EnumItems(string categoryName);   
+}  
+```  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、WorkflowSimulator.sln ソリューション ファイルを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Workflow.xaml ファイルを開きます。  
+  
+4.  ツールボックスから **\[CustomActivity\]** をドラッグ アンド ドロップして追加します。アクティビティ **\[Assign\]** が追加された **\[New WF Category\]** というツールボックス カテゴリが追加されます。  
+  
+5.  別のアクティビティを **\[CustomActivity\]** にドラッグして、この項目の選択を解除します。  
+  
+6.  ツールボックスのカテゴリ **\[New WF Category\]** の項目 **\[Assign\]** が削除されます。また、このカテゴリには項目がほかにないので、カテゴリも削除されます。  
+  
+7.  **\[CustomActivity\]** をもう一度選択すると、カテゴリと **\[Assign\]** アクティビティが再度追加されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Designer\IActivityToolboxService`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/tracking-events-into-event-tracing-in-windows.md b/docs/framework/windows-workflow-foundation/samples/tracking-events-into-event-tracing-in-windows.md
new file mode 100644
index 00000000000..41420e83222
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/tracking-events-into-event-tracing-in-windows.md
@@ -0,0 +1,159 @@
+---
+title: "Windows のイベント トレースへの追跡イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f812659b-0943-45ff-9430-4defa733182b
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# Windows のイベント トレースへの追跡イベント
+このサンプルでは、ワークフロー サービスで [!INCLUDE[wf](../../../../includes/wf-md.md)] 追跡を有効にし、Event Tracing for Windows \(ETW\) で追跡イベントを出力する方法を示します。ワークフロー追跡レコードを ETW に出力するために、このサンプルでは ETW 追跡参加要素 \(<xref:System.Activities.Tracking.EtwTrackingParticipant>\) を使用します。  
+  
+ このサンプルのワークフローでは、要求を受け取り、入力データの逆数を入力変数に割り当てて、クライアントに逆数を返します。入力データが 0 の場合、処理されない 0 による除算の例外が発生し、ワークフローが中止されます。追跡を有効にすると、エラー追跡レコードが ETW に出力され、後でエラーをトラブルシューティングする際に役立ちます。ETW 追跡参加要素は、追跡レコードを定期受信するように追跡プロファイルで構成されています。追跡プロファイルは、Web.config ファイルで定義され、構成パラメーターとして ETW 追跡参加要素に渡されます。ETW 追跡参加要素は、ワークフロー サービスの Web.config ファイルで構成され、サービス動作としてサービスに適用されます。このサンプルでは、イベント ログの追跡イベントをイベント ビューアーを使用して確認します。  
+  
+## ワークフロー追跡の詳細  
+ [!INCLUDE[wf2](../../../../includes/wf2-md.md)] には、ワークフロー インスタンスの実行を追跡できる追跡インフラストラクチャが用意されています。追跡ランタイムは、ワークフロー ライフサイクルに関連するイベント、ワークフロー アクティビティのイベント、およびカスタム イベントを出力するワークフロー インスタンスを作成します。次の表で、追跡インフラストラクチャの主要コンポーネントの詳細を説明します。  
+  
+|コンポーネント|説明|  
+|-------------|--------|  
+|追跡ランタイム|追跡レコードを出力するためのインフラストラクチャを提供します。|  
+|追跡参加要素|追跡レコードにアクセスします。[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] には、追跡レコードを Event Tracing for Windows \(ETW\) イベントとして書き込む追跡参加要素が用意されています。|  
+|追跡プロファイル|ワークフロー インスタンスから出力された追跡レコードのサブセットを追跡参加要素から定期受信するためのフィルター機構。|  
+  
+ 次の表で、ワークフロー ランタイムが出力する追跡レコードの詳細を説明します。  
+  
+|追跡レコード|説明|  
+|------------|--------|  
+|ワークフロー インスタンスの追跡レコード|ワークフロー インスタンスのライフサイクルを表します。たとえば、ワークフローの開始時または完了時にインスタンス レコードが出力されます。|  
+|アクティビティ状態の追跡レコード|アクティビティの実行状況を詳しく記録します。これらのレコードは、アクティビティをスケジュールしたとき、アクティビティが完了したとき、エラーがスローされたときなど、ワークフロー アクティビティの状態を示します。|  
+|ブックマーク再開レコード|ワークフロー インスタンス内のブックマークが再開されたときに出力されます。|  
+|カスタム追跡レコード|ワークフロー作成者はカスタム追跡レコードを作成し、カスタム アクティビティ内で出力できます。|  
+|<xref:System.Activities.Tracking.ActivityScheduledRecord>|このレコードは、アクティビティが別のアクティビティをスケジュールするときに出力されます。|  
+|<xref:System.Activities.Tracking.FaultPropagationRecord>|このレコードは、アクティビティからエラーが伝達されたときに出力されます。|  
+|<xref:System.Activities.Tracking.CancelRequestedRecord>|このレコードは、アクティビティが別のアクティビティによって取り消されたときに出力されます。|  
+  
+ 追跡参加要素は、追跡プロファイルを使用して、出力された追跡レコードのサブセットを定期受信します。追跡プロファイルには、特定の追跡レコード タイプを定期受信するための追跡クエリが含まれています。追跡プロファイルは、コードで指定したり、構成で指定したりすることができます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、EtwTrackingParticipantSample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+     既定では、サービスはポート 53797 \(http:\/\/localhost:53797\/SampleWorkflowService.xamlx\) をリッスンします。  
+  
+4.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を使用して、WCF テスト クライアントを開きます。  
+  
+     WCF テスト クライアント \(WcfTestClient.exe\) は \<[!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] のインストール フォルダー\>\\Common7\\IDE\\ フォルダーにあります。  
+  
+     [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] の既定のインストール フォルダーは C:\\Program Files\\Microsoft Visual Studio 10.0 です。  
+  
+5.  WCF テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。  
+  
+     入力ボックスにエンドポイントのアドレスを追加します。既定値は http:\/\/localhost:53797\/SampleWorkflowService.xamlx です。  
+  
+6.  イベント ビューアー アプリケーションを開きます。  
+  
+     サービスを呼び出す前に、**\[スタート\]** ボタン、**\[ファイル名を指定して実行\]** の順にクリックし、「`eventvwr.exe`」と入力してイベント ビューアーを起動します。ワークフロー サービスから生成された追跡イベントをイベント ログでリッスンしていることを確認します。  
+  
+7.  イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]** の順に選択して **\[Microsoft\]** に移動します。**\[Microsoft\]** を右クリックし、**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックして、分析ログとデバッグ ログを有効にします。  
+  
+     **\[分析およびデバッグ ログの表示\]** オプションがオンになっていることを確認します。  
+  
+8.  イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログを有効にする\]** を選択して **\[分析\]** ログを有効にします。  
+  
+9. WCF テスト クライアントで、`GetData` をダブルクリックしてサービスをテストします。  
+  
+     `GetData` メソッドが開きます。この要求はパラメーターを 1 つ受け取ります。値が 0 \(既定値\) になっていることを確認します。  
+  
+     **\[起動\]** をクリックします。  
+  
+10. ワークフローから出力されたイベントを確認します。  
+  
+     イベント ビューアーに戻り、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[更新\]** を選択します。  
+  
+     イベント ビューアーにワークフロー イベントが表示されます。ワークフロー実行イベントが表示され、その中にワークフローのエラーに対応する未処理の例外が含まれていることに注意してください。また、アクティビティがエラーをスローしたことを示す警告イベントもワークフロー アクティビティから出力されます。  
+  
+11. エラーがスローされないように入力データを 0 以外にして、手順 9. と 10. を繰り返します。  
+  
+ 追跡プロファイルを使用すると、実行時にワークフロー インスタンスの状態が変化したときに生成されるイベントを定期受信できます。監視の要件に応じて、ワークフローの主な状態変化の少数のセットを定期受信する、大まかなプロファイルを作成できます。それとは反対に、後で実行を十分に再構築できるほど出力が豊富な、詳細なプロファイルを作成することもできます。このサンプルでは、イベントの少数のセットを出力する `HealthMonitoring Tracking Profile` を使用して、ワークフロー ランタイムから ETW に出力されるイベントを示します。Web.config には、それよりも多くのワークフロー追跡イベントを出力する `Troubleshooting Tracking Profile` という名前の別のプロファイルも用意されています。[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] をインストールすると、Machine.config ファイルでは、空の名前の既定のプロファイルが構成されています。このプロファイルは、プロファイル名が指定されなかった場合や空のプロファイル名が指定された場合に、ETW 追跡動作の構成で使用されます。  
+  
+ 状態監視追跡プロファイルでは、ワークフロー インスタンス レコードとアクティビティ エラー伝達レコードが出力されます。このプロファイルは、Web.config 構成ファイルに次の追跡プロファイルを追加して作成されます。  
+  
+```xml  
+<<tracking>  
+      <profiles>  
+        <trackingProfile name="HealthMonitoring Tracking Profile">  
+          <workflow activityDefinitionId="*">  
+            <workflowInstanceQueries>  
+              <workflowInstanceQuery>  
+                <states>  
+                  <state name="Started"/>  
+                  <state name="Completed"/>  
+                  <state name="Aborted"/>  
+                  <state name="UnhandledException"/>  
+                </states>  
+            </workflowInstanceQuery>  
+           </workflowInstanceQueries>  
+            <faultPropagationQueries>  
+              <faultPropagationQuery faultSourceActivityName ="*" faultHandlerActivityName="*"/>  
+            </faultPropagationQueries>  
+          </workflow>  
+        </trackingProfile>  
+       </profiles>  
+</tracking>  
+```  
+  
+ プロファイルを変更するには、`EtwTrackingParticipant` 構成を次のように変更します。  
+  
+```xml  
+<behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <etwTracking profileName="HealthMonitoring Tracking Profile"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+  
+```  
+  
+#### クリーンアップするには \(省略可能\)  
+  
+1.  イベント ビューアーを開きます。  
+  
+2.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログの無効化\]** を選択します。  
+  
+3.  **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[分析\]** を右クリックし、**\[ログのクリア\]** を選択します。  
+  
+4.  **\[クリア\]** オプションを選択してイベントをクリアします。  
+  
+## 既知の問題  
+  
+> [!NOTE]
+>  イベント ビューアーの既知の問題により、ETW イベントをデコードできない場合があります。その場合、次のようなエラー メッセージが表示されます。  
+>   
+>  ソース "Microsoft\-Windows\-Application Server\-Applications" からのイベント ID \<id\> の説明が見つかりません。このイベントを発生させるコンポーネントがローカル コンピューターにインストールされていないか、インストールが壊れています。ローカル コンピューターにコンポーネントをインストールするか、コンポーネントを修復してください。  
+>   
+>  このエラーが発生した場合は、操作ウィンドウで \[最新の情報に更新\] をクリックしてください。これにより、イベントが正常にデコードされます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\EtwTracking`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/tracking-using-a-text-file.md b/docs/framework/windows-workflow-foundation/samples/tracking-using-a-text-file.md
new file mode 100644
index 00000000000..ccf35885dd2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/tracking-using-a-text-file.md
@@ -0,0 +1,101 @@
+---
+title: "テキスト ファイルを使用した追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 56a82682-73c2-4b91-a206-4d8bb12c561b
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# テキスト ファイルを使用した追跡
+このサンプルでは、カスタムの追跡参加要素を作成して [!INCLUDE[wf](../../../../includes/wf-md.md)] で追跡を拡張する方法を示します。追跡参加要素は、出力された追跡レコードをランタイムから受け取る .NET Framework クラスです。追跡参加要素を作成して、シナリオに必要な出力先に追跡イベントを転送することができます。たとえば、ETW \(Event Tracing for Windows\) 追跡参加要素は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の一部として提供されています。このサンプルの追跡参加要素は、レコードを XML 形式でテキスト ファイルに書き込みます。  
+  
+## サンプルの詳細  
+ 追跡参加要素の有用性と信頼性を最適化するには、いくつかの追加手順を完了して追跡参加要素をランタイムに適切に接続する必要があります。ベスト プラクティスに準拠する追跡参加要素を作成するためにこのサンプルで使用するクラスを次の表に示します。  
+  
+|クラス|説明|  
+|---------|--------|  
+|`TextFileTrackingExtensionElement`|<xref:System.ServiceModel.Configuration.BehaviorExtensionElement> を使用して、テキスト ファイルの追跡参加要素の構成に使用される構成セクションを定義します。これにより、ユーザーは、標準の .NET Framework 構成ファイルを使用してログ ファイルの出力先を指定できます。|  
+|`TextFileTrackingBehavior`|[!INCLUDE[indigo2](../../../../includes/indigo2-md.md)] の動作によって、ユーザーは、拡張機能をランタイムに挿入できるようになります。この動作によって、サービスの開始時に追跡参加要素がサービスに追加されます。|  
+|`TextFileTrackingParticipant`|実行時に追跡参加要素を受け取って XML としてログ ファイルに格納する追跡参加要素。|  
+  
+## 動作拡張要素の構成  
+ .NET Framework 構成ファイルを使用して前に記述した動作拡張要素を利用するには、もう 1 つの手順が必要です。拡張機能を使用する構成ファイルに次の構成を挿入する必要があります。  
+  
+```  
+<system.serviceModel>  
+    <extensions>  
+      <behaviorExtensions>  
+        <add name="textFileTracking" type="Microsoft.Samples.TextFileTracking.TextFileTrackingExtensionElement, WFStockPriceApplication, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />  
+      </behaviorExtensions>  
+    </extensions>  
+…  
+  </system.serviceModel>  
+  
+```  
+  
+> [!NOTE]
+>  動作拡張要素の構成の詳細な使用例については、サンプルの Web.config ファイルを参照してください。  
+  
+## カスタム追跡レコード  
+ GetStockPrices.cs ファイルでは、<xref:System.Activities.CodeActivity> 内からカスタム追跡レコードを作成する方法を示します。サンプルの実行時にこのレコードを調べてください。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、WFStockPriceApplication.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+     ブラウザー ウィンドウが開き、アプリケーションのディレクトリの一覧が示されます。  
+  
+4.  ブラウザーで、StockPriceService.xamlx をクリックします。  
+  
+5.  ブラウザーに、**\[StockPriceService\]** ページが表示され、ローカル サービスの wsdl アドレスが示されます。このアドレスをコピーします。  
+  
+     ローカル サービスの wsdl アドレスは、http:\/\/localhost:53797\/StockPriceService.xamlx?wsdl などになります。  
+  
+6.  [!INCLUDE[fileExplorer](../../../../includes/fileexplorer-md.md)] を使用して、[!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] フォルダー \(既定のインストール フォルダーは %SystemDrive%\\Program Files\\Microsoft Visual Studio 10.0\) に移動しま す。Common7\\IDE\\ サブフォルダーを見つけます。  
+  
+7.  WcfTestClient.exe ファイルをダブルクリックして、WCF テスト クライアントを起動します。  
+  
+8.  WCF テスト クライアントで、**\[ファイル\]** メニューの **\[サービスの追加\]** をクリックします。  
+  
+9. コピーした URL をテキスト ボックスに貼り付けます。  
+  
+10. **\[OK\]** をクリックしてダイアログ ボックスを閉じます。  
+  
+11. WCF テスト クライアントを使用してサービスをテストします。  
+  
+    1.  WCF テスト クライアントで、**\[IStockPriceService\]** ノードの下の **\[GetStockPrice\(\)\]** をダブルクリックします。  
+  
+         **GetStockPrice\(\)** メソッドが、1 つのパラメーターと共に右ペインに表示されます。  
+  
+    2.  パラメーターの値として「Contoso」と入力します。  
+  
+    3.  **\[起動\]** をクリックします。  
+  
+12. アプリケーション データ ディレクトリにあるログ ファイル \(%APPDATA%\\trackingRecords.log\) で追跡イベントを確認します。  
+  
+    > [!NOTE]
+    >  %APPDATA% は、[!INCLUDE[wv](../../../../includes/wv-md.md)]、[!INCLUDE[lserver](../../../../includes/lserver-md.md)]、または Windows Server 2008 で %SystemDrive%\\Users\\\<username\>\\AppData\\Roaming に解決される環境変数です。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\TextFileTracking`  
+  
+## 参照  
+ [AppFabric の監視のサンプル](http://go.microsoft.com/fwlink/?LinkId=193959)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/tracking.md b/docs/framework/windows-workflow-foundation/samples/tracking.md
new file mode 100644
index 00000000000..a41ece2f953
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/tracking.md
@@ -0,0 +1,34 @@
+---
+title: "追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: afdcd9bd-b462-4b2a-aac7-bebf9c80be81
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# 追跡
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] のワークフロー追跡を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [カスタム追跡](../../../../docs/framework/windows-workflow-foundation/samples/custom-tracking.md)  
+ カスタムの追跡参加要素を作成し、追跡データをコンソールに出力する方法を示します。  
+  
+ [Windows のイベント トレースへの追跡イベント](../../../../docs/framework/windows-workflow-foundation/samples/tracking-events-into-event-tracing-in-windows.md)  
+ ワークフロー サービスで [!INCLUDE[wf1](../../../../includes/wf1-md.md)] 追跡を有効にし、Event Tracing for Windows \(ETW\) で追跡イベントを出力する方法を示します。  
+  
+ [SQL 追跡](../../../../docs/framework/windows-workflow-foundation/samples/sql-tracking.md)  
+ カスタム SQL 追跡参加要素を作成し、追跡レコードを SQL データベースに書き込む方法を示します。  
+  
+ [追跡を使用した WF データの抽出](../../../../docs/framework/windows-workflow-foundation/samples/extract-wf-data-using-tracking.md)  
+ ワークフロー追跡を使用して、アクティビティからワークフロー変数と引数を抽出する方法を示します。  
+  
+ [テキスト ファイルを使用した追跡](../../../../docs/framework/windows-workflow-foundation/samples/tracking-using-a-text-file.md)  
+ カスタムの追跡参加要素を作成して [!INCLUDE[wf1](../../../../includes/wf1-md.md)] で追跡を拡張する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/transacted-queues.md b/docs/framework/windows-workflow-foundation/samples/transacted-queues.md
new file mode 100644
index 00000000000..0d09e9d3905
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/transacted-queues.md
@@ -0,0 +1,45 @@
+---
+title: "トランザクション キュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b1b011dd-5e0b-482c-9bb0-9d8727038f14
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# トランザクション キュー
+このサンプルでは、キューとトランザクションを [!INCLUDE[wf](../../../../includes/wf-md.md)] に統合し、信頼性があり、拡張性の高いサービスを作成する方法を示します。<xref:System.Activities.TransactionScope> は、<xref:System.ServiceModel.NetMsmqBinding> を使用してトランザクション内でキューにメッセージを送信するためにクライアント ワークフローで使用されます。<xref:System.ServiceModel.Activities.TransactedReceiveScope> は、キューからメッセージを受信して同じトランザクション内でワークフローの状態を更新するためにサーバーで使用されます。  
+  
+## 使用例  
+ <xref:System.Activities.Statements.TransactionScope>、<xref:System.ServiceModel.Activities.TransactedReceiveScope>、<xref:System.ServiceModel.NetMsmqBinding>、<xref:System.ServiceModel.Activities.Receive>、およびコンテンツ ベースの相関関係。  
+  
+## 説明  
+ このサンプルで取り上げる機能について説明するために、特定のアカウント用に取得されて使用されるポイントを追跡する `RewardsPoints` ワークフロー サービスが作成されます。クライアントは、<xref:System.Activities.WorkflowInvoker> を使用してキューへのさまざまな要求の送信をシミュレートします。トランザクション内でキューにメッセージを送信するために、<xref:System.ServiceModel.Activities.Send> アクティビティを <xref:System.Activities.Statements.TransactionScope> の <xref:System.Activities.Statements.TransactionScope.Body%2A> 内に配置できます。このサンプルでは、キューに置かれたメッセージがクライアント アプリケーションとサーバー アプリケーションを切り離す方法について説明するために、最初にクライアントが実行され、次にサーバーが実行されます。  
+  
+ クライアントが完了したら、サービスが構成されてホストされます。サービスが開くとすぐに、既にキューに置かれているメッセージの処理が開始されます。各メッセージが同じサーバー トランザクション内で受信および処理されます。このサンプルでは、最初に受信するメッセージは、要求メッセージの一部として渡されるアカウント名に基づいてインスタンスを作成してコンテンツ ベースの相関関係を初期化する `CreateAccount` 要求です。実際に必要となる可能性のある種類のサービスをモデル化するために、`AddPoints` メッセージと `UsePoints` メッセージを処理する次の 2 つの <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティが `while` ループ内の並行分岐に配置されており、これらのメッセージを任意の順序で繰り返し処理できるようになっています。  
+  
+ <xref:System.Activities.Statements.TransactionScope> および <xref:System.ServiceModel.Activities.TransactedReceiveScope> は、それぞれスコープの末尾に暗黙的な永続化ポイントを持つので、これらのアクティビティをキューと組み合わせて [!INCLUDE[wf1](../../../../includes/wf1-md.md)] で使用すると、メッセージが失われないようにしながら、ワークフローを一貫性のある状態から次の一貫性のある状態に確実に移行できます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  MSMQ をインストールして構成します。詳細については、「[メッセージ キュー \(MSMQ\) のインストール](http://go.microsoft.com/fwlink/?LinkId=178526)」を参照してください。  
+  
+2.  コマンド ラインで次のコマンドを実行して、MSDTC を確実に実行します。`net start msdtc`  
+  
+3.  プロジェクトをコンパイルして実行可能ファイルを開くか、[!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] でプロジェクトを開いてデバッグ メニューから開始オプションを選択します。最初にキューが作成され、次にクライアントが実行されてキューにメッセージが送信され、最後にサービスが開始されてメッセージが処理されます。プログラムを終了するには、Enter キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\TransactedQueues`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/transaction-convoy-scope.md b/docs/framework/windows-workflow-foundation/samples/transaction-convoy-scope.md
new file mode 100644
index 00000000000..d77f6510ed7
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/transaction-convoy-scope.md
@@ -0,0 +1,51 @@
+---
+title: "トランザクション コンボイ スコープ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37141708-a29f-4b6a-81fe-f8a11f825061
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# トランザクション コンボイ スコープ
+このサンプルでは、パラレルなコンボイ メッセージング アクティビティ パターンを <xref:System.ServiceModel.Activities.TransactedReceiveScope> と組み合わせて作成し、多数の操作をすべて同じトランザクションで任意の順序で行うことができるプロトコルをモデル化する方法を示します。また、トランザクションがサーバーにフローされないためにクライアントで使用できるトランザクションがない場合に、<xref:System.ServiceModel.Activities.TransactedReceiveScope> で自動的に新しいトランザクションを作成する方法も示します。  
+  
+ このサンプルは、クライアントとサーバーを表す 2 つのワークフロー プロジェクトで構成されます。クライアント プロジェクトでは、最初にメッセージを送信してサーバー ワークフローをブートストラップするワークフローを実行します。このワークフローで、相関関係が初期化され、残りのメッセージング アクティビティのトランザクション スコープが開始されます。クライアントの <xref:System.Activities.Statements.Sequence> アクティビティには、<xref:System.ServiceModel.Activities.Send> と <xref:System.ServiceModel.Activities.ReceiveReply> の最初のペアと、3 つの分岐がある <xref:System.Activities.Statements.Parallel> アクティビティが含まれます。各分岐で、一方向のメッセージがサーバーに送信されます。<xref:System.Activities.Statements.Parallel> アクティビティの <xref:System.Activities.Statements.Parallel.CompletionCondition%2A> プロパティは、3 つすべての分岐を完了するように `false` に設定されています。  
+  
+ サーバー ワークフローはクライアント ワークフローに似ていますが、メッセージング アクティビティが通信のサーバー側のものになり、すべての作業が同じトランザクションで実行されるように <xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティ内に格納されています。サーバーで最初のメッセージを受信すると、トランザクションが作成されます。トランザクションはこのスコープのアンビエント トランザクションになり、<xref:System.ServiceModel.Activities.TransactedReceiveScope> 本体のスコープ内のあらゆるアクティビティがこのトランザクションにアクセスできます。その後、すべての受信が並行して実行されます。並行アクティビティの完了条件の定義に従って、すべての受信が 1 回だけ実行される必要があります。暗黙的な永続化ポイントが <xref:System.ServiceModel.Activities.TransactedReceiveScope> 本体の末尾にあり、永続化操作も同じトランザクションで実行されます。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ParallelConvoySample.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  どちらのプロジェクトも開始されるように設定されていることを確認します。  
+  
+    1.  **ソリューション エクスプローラー**で、ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。  
+  
+    2.  **\[マルチ スタートアップ プロジェクト\]** を選択し、両方のプロジェクトのアクションが **\[開始\]** に設定されていることを確認します。  
+  
+4.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+     サーバーで "`Server is running`" と出力され、サーバーの準備ができたことが示されます。  
+  
+     クライアント コンソール ウィンドウで任意のキーを押してサンプルを開始します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\TransactedConvoyScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/transaction-rollback.md b/docs/framework/windows-workflow-foundation/samples/transaction-rollback.md
new file mode 100644
index 00000000000..099e0df1159
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/transaction-rollback.md
@@ -0,0 +1,45 @@
+---
+title: "トランザクションのロールバック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f377147-7529-4689-a588-608cee87fdf8
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# トランザクションのロールバック
+このサンプルでは、アンビエント <xref:System.Activities.RuntimeTransactionHandle> にアクセスしてアンビエント トランザクションを取得し、そのトランザクションを明示的にロールバックするカスタム <xref:System.Activities.NativeActivity> を作成する方法を示します。  
+  
+## サンプルの詳細  
+ ワークフローでは、最も外側の <xref:System.Activities.Statements.TransactionScope> または <xref:System.ServiceModel.Activities.TransactedReceiveScope> が完了すると、トランザクションは自動的に完了します。未処理の例外がスコープの境界を越えて伝達されると、トランザクションは暗黙的にロールバックします。ただし、例外をスローせずにトランザクションを明示的にロールバックすることが有効な場合もあります。この場合、このサンプルのアクティビティのようなカスタム ロールバック アクティビティを使用して、アンビエント トランザクションを明示的に中止し、必要に応じて例外の理由を提供することができます。  
+  
+ `RollbackActivity` は、アンビエント <xref:System.Activities.RuntimeTransactionHandle> を取得するために実行プロパティにアクセスする必要があるので、<xref:System.Activities.NativeActivity> になります。`Execute` メソッドでは、<xref:System.Activities.RuntimeTransactionHandle> を取得し、アンビエント ランタイム トランザクションなしでアクティビティが使用されたことを示す `null` であるかどうかを確認します。次にトランザクションを取得し、`null` が存在するかどうかを再度確認します。ランタイム トランザクションを初期化せずにアンビエント <xref:System.Activities.RuntimeTransactionHandle> を取得することができます。最後に、<xref:System.Transactions.Transaction.Rollback%2A> を呼び出し、ユーザー指定の例外、またはアクティビティによってトランザクションがロールバックされたことを示す汎用的な例外を指定して、トランザクションを中止します。  
+  
+ このサンプルのワークフローは、`RollbackActivity` の実行の前後にトランザクションの状態を印刷する本体を持つ <xref:System.Activities.Statements.TransactionScope> で構成されます。トランザクションがロールバックされた場合でも、<xref:System.Activities.Statements.TransactionScope> は完了まで実行され、本体が完了するまでワークフローは中止されないことに注意してください。ワークフローが中止されるのは、<xref:System.Activities.Statements.TransactionScope.AbortInstanceOnTransactionFailure%2A> プロパティが既定で `true` に設定されるためです。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] に TransactionRollback.sln ソリューションを読み込みます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\Transactions\TransactionRollback`  
+  
+## 参照  
+ [トランザクション](../../../../docs/framework/windows-workflow-foundation//workflow-transactions.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/transactions.md b/docs/framework/windows-workflow-foundation/samples/transactions.md
new file mode 100644
index 00000000000..3a86cf45a40
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/transactions.md
@@ -0,0 +1,34 @@
+---
+title: "トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51212219-a39e-448e-bff3-10064ff5de64
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# トランザクション
+このセクションには、[!INCLUDE[wf](../../../../includes/wf-md.md)] のワークフロー トランザクションを使用するシナリオを示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [命令型 TransactionScope でのワークフローの実行](../../../../docs/framework/windows-workflow-foundation/samples/execute-a-workflow-in-an-imperative-transactionscope.md)  
+ 命令型 C\# コードから <xref:System.Transactions.Transaction> の下にある <xref:System.Activities.WorkflowInvoker> を使用してワークフローを実行する方法を示します。  
+  
+ [トランザクション コンボイ スコープ](../../../../docs/framework/windows-workflow-foundation/samples/transaction-convoy-scope.md)  
+ パラレルなコンボイ メッセージング アクティビティ パターンを <xref:System.ServiceModel.Activities.TransactedReceiveScope> と組み合わせて作成し、多数の操作をすべて同じトランザクションで任意の順序で行うことができるプロトコルをモデル化する方法を示します。  
+  
+ [トランザクションのロールバック](../../../../docs/framework/windows-workflow-foundation/samples/transaction-rollback.md)  
+ アンビエント <xref:System.Activities.RuntimeTransactionHandle> にアクセスしてアンビエント トランザクションを取得し、そのトランザクションを明示的にロールバックするカスタム <xref:System.Activities.NativeActivity> を作成する方法を示します。  
+  
+ [トランザクション スコープの抑制](../../../../docs/framework/windows-workflow-foundation/samples/suppress-transaction-scope.md)  
+ アンビエント ランタイム トランザクションが存在する場合はそのトランザクションを抑制するカスタム `SuppressTransactionScope` アクティビティを作成する方法を示します。  
+  
+ [トランザクション キュー](../../../../docs/framework/windows-workflow-foundation/samples/transacted-queues.md)  
+ キューとトランザクションを [!INCLUDE[wf1](../../../../includes/wf1-md.md)] に統合し、信頼性があり、拡張性の高いサービスを作成する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/usage-of-the-switch-activity-with-custom-types.md b/docs/framework/windows-workflow-foundation/samples/usage-of-the-switch-activity-with-custom-types.md
new file mode 100644
index 00000000000..837f8bb548d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/usage-of-the-switch-activity-with-custom-types.md
@@ -0,0 +1,141 @@
+---
+title: "カスタム型を使用した Switch アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 482a48c4-eb83-40c3-a4e2-2f9a8af88b75
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# カスタム型を使用した Switch アクティビティの使用
+このサンプルでは、<xref:System.Activities.> Statements.Switch`1?qualifyHint=False&autoUpgrade=True アクティビティを有効にしてユーザー定義の複合型を実行時に評価する方法について説明します。従来のほとんどの手続き型プログラミング言語では、[switch](http://go.microsoft.com/fwlink/?LinkId=180521) ステートメントで変数の条件の評価に基づいて実行ロジックを選択します。従来、`switch` ステートメントは、静的に評価できる式を対象としています。つまり、たとえば C\# では、プリミティブ型 \(<xref:System.Boolean>、<xref:System.Int32>、<xref:System.String>、列挙型など\) のみがサポートされます。  
+  
+ カスタム クラスで切り替えを有効にするには、カスタム複合型の値を実行時に評価するロジックを実装する必要があります。このサンプルでは、`Person` という名前のカスタム複合型で切り替えを有効にする方法を示します。  
+  
+-   カスタム クラス `Person` では、<xref:System.ComponentModel.TypeConverter> 属性がカスタム <xref:System.ComponentModel.TypeConverter> の名前で宣言されます。  
+  
+    ```  
+    [TypeConverter(typeof(PersonConverter))]  
+    public class Person  
+    {  
+       public string Name { get; set; }  
+       public int Age { get; set; }  
+    ...  
+  
+    ```  
+  
+-   カスタム クラス `Person` では、<xref:System.Object.Equals%2A> クラスと <xref:System.Object.GetHashCode%2A> クラスがオーバーライドされます。  
+  
+    ```  
+    public override bool Equals(object obj)  
+    {  
+        Person person = obj as Person;  
+  
+        if (person != null)  
+        {  
+            return string.Equals(this.Name, person.Name);  
+        }  
+  
+        return false;  
+    }  
+  
+    public override int GetHashCode()  
+    {  
+        if (this.Name != null)  
+        {  
+            return this.Name.GetHashCode();  
+        }  
+  
+        return 0;  
+    }  
+  
+    ```  
+  
+-   カスタム クラスのインスタンスから文字列への変換、および文字列からカスタム クラスのインスタンスへの変換を行う、カスタム <xref:System.ComponentModel.TypeConverter> クラスが実装されます。  
+  
+    ```  
+    public class PersonConverter : TypeConverter  
+    {  
+        public override bool CanConvertFrom(ITypeDescriptorContext context,  
+           Type sourceType)  
+        {  
+            return (sourceType is string);  
+        }  
+  
+        // Overrides the ConvertFrom method of TypeConverter.  
+        public override object ConvertFrom(ITypeDescriptorContext context,  
+           CultureInfo culture, object value)  
+        {  
+            if (value == null)  
+            {  
+                return null;  
+            }  
+  
+            if (value is string)  
+            {  
+                return new Person  
+                {  
+                    Name = (string)value  
+                };  
+            }  
+  
+            return base.ConvertFrom(context, culture, value);  
+        }  
+  
+        // Overrides the ConvertTo method of TypeConverter.  
+        public override object ConvertTo(ITypeDescriptorContext context,  
+           CultureInfo culture, object value, Type destinationType)  
+        {  
+            if (destinationType == typeof(string))  
+            {  
+                if (value != null)  
+                {  
+                    return ((Person) value).Name;  
+                }  
+                else  
+                {  
+                    return null;  
+                }  
+            }  
+  
+            return base.ConvertTo(context, culture, value, destinationType);  
+        }  
+    }  
+    ```  
+  
+ このサンプルには、次のファイルが含まれています。  
+  
+-   **Person.cs**: `Person` クラスを定義します。  
+  
+-   **PersonConverter.cs**: `Person` クラスの型コンバーター。  
+  
+-   **Sequence.xaml**: `Person` 型の切り替えを行うワークフロー。  
+  
+-   **Program.cs**: ワークフローを実行する main 関数。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] に Switch.sln を読み込みます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押してサンプルを実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\Switch`  
+  
+## 参照  
+ [ビルトイン アクティビティ ライブラリ](../../../../docs/framework/windows-workflow-foundation//net-framework-4-5-built-in-activity-library.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/use-of-transactedreceivescope.md b/docs/framework/windows-workflow-foundation/samples/use-of-transactedreceivescope.md
new file mode 100644
index 00000000000..457c4190378
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/use-of-transactedreceivescope.md
@@ -0,0 +1,48 @@
+---
+title: "TransactedReceiveScope の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d455f1dc-bfc5-43d6-8ae9-bc3b3a3ea08a
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# TransactedReceiveScope の使用
+このサンプルでは、クライアントからサーバーにトランザクションをフローする方法を示します。このために、<xref:System.Activities.Statements.TransactionScope> を使用してクライアント上に新しいトランザクションを作成し、<xref:System.ServiceModel.Activities.TransactedReceiveScope> を使用してフローされたトランザクションを含むメッセージを受信し、サーバー上でトランザクションの有効期間のスコープを設定します。このサンプルは、クライアントとサーバーの役割を果たす 2 つのプロジェクトで構成されます。  
+  
+## クライアント アプリケーション  
+ クライアント アプリケーションは、分散トランザクション ID の出力、サーバーへのメッセージの送信、トランザクションのフロー、応答の受信、分散トランザクション ID の再出力、および完了処理を行うワークフローを実行します。最初に出力される分散トランザクション ID は空の GUID です。これは、その時点ではトランザクションがまだローカルのみであるためです。  
+  
+## サーバー アプリケーション  
+ サーバー プロジェクトはクライアントに似ていますが、ワークフローが <xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされます。これは、エンドポイントでクライアントからのメッセージをリッスンする必要があるためです。ワークフローの中心は、クライアントからフローされたトランザクションの受信、送信されたメッセージの出力、分散トランザクション ID の出力、およびクライアントへの応答の送信を行う <xref:System.ServiceModel.Activities.TransactedReceiveScope> です。分散トランザクション ID は空でない GUID になり、トランザクションに対応するアクティビティが <xref:System.ServiceModel.Activities.TransactedReceiveScope> の本体に追加された場合、そのアクティビティはフローされたランザクションで実行されます。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で TransactedReceiveScope.sln ソリューションを開きます。  
+  
+2.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+3.  ビルドが完了したら、ソリューションを右クリックし、**\[スタートアップ プロジェクトの設定\]** をクリックします。ダイアログで、**\[マルチ スタートアップ プロジェクト\]** を選択し、両方のプロジェクトのアクションが **\[開始\]** になっていることを確認します。  
+  
+4.  F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。または、Ctrl キーを押しながら F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグなしで開始\]** をクリックして、デバッグ機能なしで実行します。  
+  
+    > [!NOTE]
+    >  クライアントを起動する前に、サーバーを起動しておく必要があります。サービスをホストするコンソール ウィンドウの出力で、起動された時間が示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Transactions\TransactedReceiveScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md b/docs/framework/windows-workflow-foundation/samples/using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md
new file mode 100644
index 00000000000..b99fee4e5ff
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-a-net-3-0-or-net-3-5-activity-in-a-net-4-5-workflow.md
@@ -0,0 +1,37 @@
+---
+title: ".NET Framework 4.5 ワークフローでの .NET Framework 3.0 または .NET Framework 3.5 アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6c53fd4c-5dd0-4fb4-ab6b-111302629548
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# .NET Framework 4.5 ワークフローでの .NET Framework 3.0 または .NET Framework 3.5 アクティビティの使用
+<xref:System.Activities.Statements.Interop> アクティビティでは、[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] ワークフロー内で .NET Framework 3.0 [!INCLUDE[wf](../../../../includes/wf-md.md)] アクティビティを実行できます。このサンプルでは、<xref:System.Activities.Statements.Interop> アクティビティを使用して、文字列をカスタムの [!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] アクティビティに引数として渡す方法を示します。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../../includes/vs-current-long-md.md)] を使用して、SimpleInterop.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Migration\SimpleInterop`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md b/docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md
new file mode 100644
index 00000000000..fe5f434f4bc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-asyncoperationcontext-in-an-activity-sample.md
@@ -0,0 +1,38 @@
+---
+title: "アクティビティ サンプルでの AsyncOperationContext の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0888a0bd-d227-4c00-ad6a-b654a01740e8
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# アクティビティ サンプルでの AsyncOperationContext の使用
+このサンプルでは、<xref:System.Activities.AsyncOperationContext> を使用してワークフロー外で非同期に作業を実行するカスタムの <xref:System.Activities.CodeActivity> を開発する方法を示します。  
+  
+## サンプルの詳細  
+ サンプルのアクティビティでは、<xref:System.IO.FileStream> クラスの <xref:System.IO.FileStream.BeginWrite> メソッドおよび <xref:System.IO.FileStream.EndWrite> メソッドを使用して、非同期にデータをファイルに書き込みます。ここで示すパターンは、他の非同期メソッドでの使用に合わせて変更できます。非同期操作の実行中、ワークフローの他のアクティビティを実行できますが、ワークフローを永続化することはできません。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で Async.sln サンプル ソリューションを開きます。  
+  
+2.  ソリューションをビルドして実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\Code-Bodied\Async`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-cancellationscope.md b/docs/framework/windows-workflow-foundation/samples/using-cancellationscope.md
new file mode 100644
index 00000000000..cc258b2dee6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-cancellationscope.md
@@ -0,0 +1,47 @@
+---
+title: "CancellationScope の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 39c5c338-b316-43d6-b7fe-a543281dd1ec
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# CancellationScope の使用
+このサンプルでは、<xref:System.Activities.Statements.CancellationScope> アクティビティを使用してアプリケーション内の処理を取り消す方法を示します。  
+  
+ 中間層のコンポーネントやサービスの多くでは、既知のプログラミング構成要素であるトランザクションを使用して取り消しを処理します。  ただし、トランザクションでは実行できない処理を取り消さなければならない場合も数多くあります。  取り消しを使用することがトランザクションを使用することよりも難しいのは、取り消す必要がある処理を先に追跡しなければならないからです。  [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] には、この処理に役立つ <xref:System.Activities.Statements.CancellationScope> アクティビティが用意されています。  
+  
+ 取り消しはアクティビティ内またはアクティビティの親からトリガーできます。  子アクティビティは、親アクティビティ \(<xref:System.Activities.Statements.Sequence>、<xref:System.Activities.Statements.Parallel>、<xref:System.Activities.Statements.Flowchart>、またはカスタム複合アクティビティ\) によってスケジュールされます。  親アクティビティは、どのような理由でも子アクティビティを取り消すことができます。  たとえば、3 つの子分岐がある <xref:System.Activities.Statements.Parallel> アクティビティでは、1 つの分岐が完了し、<xref:System.Activities.Statements.Parallel.CompletionCondition%2A> 式の評価結果が `true` であれば、残りの子分岐を取り消します。  ワークフローは、ホスト アプリケーションで <xref:System.Activities.WorkflowApplication.Cancel%2A> を呼び出すことで外部から取り消すこともできます。  
+  
+ <xref:System.Activities.Statements.CancellationScope> アクティビティを使用するには、取り消す必要がある処理を <xref:System.Activities.Statements.CancellationScope.Body%2A> プロパティに設定し、取り消し後に実行する処理を <xref:System.Activities.Statements.CancellationScope.CancellationHandler%2A> プロパティに設定します。  
+  
+ このサンプルでは、アクティビティ自体からアクティビティを取り消す方法を示します。  
+  
+ このサンプルでは、マイアミ行きのチケットをできるだけ早く購入する必要があるクライアントのシナリオを使用して、<xref:System.Activities.Statements.CancellationScope> アクティビティの例を示します。  取り引きを検討している旅行代理店が 2 社あり、  このビジネス ロジックを、<xref:System.Activities.Statements.CancellationScope> アクティビティ内の 2 つの <xref:System.Activities.Statements.Parallel> を使用してモデル化しています。  <xref:System.Activities.Statements.Parallel.CompletionCondition%2A> アクティビティの <xref:System.Activities.Statements.Parallel> は `true` に設定されています。分岐の完了後に <xref:System.Activities.Statements.Parallel.CompletionCondition%2A> が確認されるため、最初の分岐が完了すると残りの分岐が取り消されます。  クライアント アプリケーションは、両方の代理店にチケットを注文し、どちらかでチケットを購入できた時点でもう一方の代理店の注文を取り消します。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、CancelationScopeXAML.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。  続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。  このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\CancellationScope`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-collection-activities.md b/docs/framework/windows-workflow-foundation/samples/using-collection-activities.md
new file mode 100644
index 00000000000..01569e986c6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-collection-activities.md
@@ -0,0 +1,56 @@
+---
+title: "コレクション アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e1977cf8-1695-4071-b946-7046fe39601e
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# コレクション アクティビティの使用
+このサンプルでは、<xref:System.Collections.ICollection> インターフェイスを実装するクラスでコレクション アクティビティ \(<xref:System.Activities.Statements.AddToCollection%601>、<xref:System.Activities.Statements.ClearCollection%601>、<xref:System.Activities.Statements.ExistsInCollection%601>、および <xref:System.Activities.Statements.RemoveFromCollection%601>\) を使用する方法と、コレクションを反復処理してコレクション内の各要素の内容を出力するカスタム アクティビティを作成する方法を示します。`PrintCollection` という名前のカスタム アクティビティは、`Numbers` という名前のコレクションの項目メンバーをコンソールに出力します。  
+  
+ 次の表で、ワークフローにコレクション操作を提供する 4 つのアクティビティについて説明します。  
+  
+|アクティビティ名|説明|  
+|--------------|--------|  
+|<xref:System.Activities.Statements.AddToCollection%601>|項目をコレクションに追加します。|  
+|<xref:System.Activities.Statements.ClearCollection%601>|コレクションの項目をすべて削除します。|  
+|<xref:System.Activities.Statements.ExistsInCollection%601>|指定された項目がコレクション内に存在する場合、`true` を返します。|  
+|<xref:System.Activities.Statements.RemoveFromCollection%601>|コレクションから項目を削除します。|  
+  
+ このサンプルは 2 つのソリューションで構成されます。1 つは CodedWorkflow ディレクトリにあり、もう 1 つは DesignerWorkflow ディレクトリにあります。これらのソリューションでは、アクティビティを使用して同じ目的を達成するための 2 つの異なる方法を示します。  
+  
+||||  
+|-|-|-|  
+|ソリューション|説明|メイン ファイル|  
+|CodedWorkflow|プログラムでコレクション アクティビティを呼び出す方法を示すサンプル クライアント アプリケーション。|**PrintCollection.cs**: コレクション内のすべての項目をコンソールに出力するためのヘルパー アクティビティ。<br /><br /> **Program.cs**: 一連のコレクション アクティビティを含むシーケンス アクティビティを構築して実行します。|  
+|DesignerWorkflow|ワークフロー デザイナーでコレクション アクティビティを宣言的に使用する方法を示すサンプル クライアント アプリケーション。|**CollectionWorkflow.xaml**: コレクション アクティビティを使用するデザイナーで宣言によって作成されるワークフロー。<br /><br /> **PrintCollection.cs**: コレクション内のすべての項目をコンソールに出力するためのヘルパー アクティビティ。<br /><br /> **Program.cs**: CollectionWorkflow.xaml に記述されたワークフローを呼び出します。|  
+  
+ デモでは、`PrintCollection` という名前のカスタム定義アクティビティを使用して、コレクション `Numbers` の項目メンバーをコンソールに出力します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、Collection.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\Collection`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-editing-scope.md b/docs/framework/windows-workflow-foundation/samples/using-editing-scope.md
new file mode 100644
index 00000000000..e23ccd008d1
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-editing-scope.md
@@ -0,0 +1,49 @@
+---
+title: "編集スコープの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 79306f9e-318b-4687-9863-8b93d1841716
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# 編集スコープの使用
+このサンプルでは、変更のセットを 1 つの分割不可能な単位で元に戻せるように、変更のセットをバッチ処理する方法を示します。既定では、アクティビティ デザイナー作者が実行した操作は、"元に戻す\/やり直し" システムに自動的に統合されます。  
+  
+## 使用例  
+ 編集スコープ、元に戻す、およびやり直し。  
+  
+## 説明  
+ このサンプルでは、1 つの作業単位内で <xref:System.Activities.Presentation.Model.ModelItem> ツリーに対する変更のセットをバッチ処理する方法を示します。WPF デザイナーから <xref:System.Activities.Presentation.Model.ModelItem> 値に直接バインドする場合、変更が自動的に適用されることに注意してください。このサンプルでは、1 つの変更ではなく、バッチ処理する複数の変更を命令型コードによって行うときに実行する必要がある操作を示します。  
+  
+ このサンプルでは、3 つのアクティビティを追加します。編集が開始されると、<xref:System.Activities.Presentation.Model.ModelItem.BeginEdit%2A> が <xref:System.Activities.Presentation.Model.ModelItem> のインスタンスで呼び出されます。この編集スコープ内で <xref:System.Activities.Presentation.Model.ModelItem> ツリーに対して行った変更を、バッチ処理します。<xref:System.Activities.Presentation.Model.ModelItem.BeginEdit%2A> コマンドは、このインスタンスを制御するために使用できる <xref:System.Activities.Presentation.Model.EditingScope> を返します。<xref:System.Activities.Presentation.Model.EditingScope.OnComplete%2A> または <xref:System.Activities.Presentation.Model.EditingScope.OnRevert%2A> を呼び出して、編集スコープをコミットするか元に戻すことができます。  
+  
+ <xref:System.Activities.Presentation.Model.EditingScope> オブジェクトを入れ子にすることもできます。これにより、変更の複数のセットをより大きな編集スコープの一部として追跡したり、個別に制御したりできます。この機能を使用する可能性があるシナリオとしては、複数のダイアログからの変更について、すべての変更を 1 つの分割不可能な操作として扱いながら、別々にコミットしたり元に戻したりする必要がある場合が挙げられます。このサンプルでは、<xref:System.Activities.Presentation.Model.ModelEditingScope> 型の <xref:System.Collections.ObjectModel.ObservableCollection%601> を使用して、編集スコープをスタックします。<xref:System.Collections.ObjectModel.ObservableCollection%601> を使用すると、デザイナー画面で入れ子の深さを確認できます。  
+  
+## サンプルを設定、ビルド、および実行するには  
+  
+1.  サンプルをビルドして実行し、左にあるボタンを使用してワークフローを変更します。  
+  
+2.  **\[Open Editing Scope\]** をクリックします。  
+  
+    1.  このコマンドにより、編集スコープを作成して編集スタックにプッシュする <xref:System.Activities.Presentation.Model.ModelItem.BeginEdit%2A> が呼び出されます。  
+  
+    2.  次に、選択した <xref:System.Activities.Presentation.Model.ModelItem> に 3 つのアクティビティを追加します。編集スコープを <xref:System.Activities.Presentation.Model.ModelItem.BeginEdit%2A> によって開かなかった場合は、3 つの新しいアクティビティがデザイナー キャンバスに表示されることに注意してください。この操作は <xref:System.Activities.Presentation.Model.EditingScope> 内で保留中のままであるので、デザイナーはまだ更新されません。  
+  
+3.  **\[Close Editing Scope\]** をクリックして、編集スコープをコミットします。3 つのアクティビティがデザイナーに表示されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CustomActivityDesigners\UsingEditingScope`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-interop-with-external-data-exchange.md b/docs/framework/windows-workflow-foundation/samples/using-interop-with-external-data-exchange.md
new file mode 100644
index 00000000000..f423c3c9e2d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-interop-with-external-data-exchange.md
@@ -0,0 +1,35 @@
+---
+title: "External Data Exchange での Interop の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 96f6fe26-5305-494f-9119-7748e0c4b3fa
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# External Data Exchange での Interop の使用
+<xref:System.Activities.Statements.Interop> アクティビティを使用して、[!INCLUDE[vstecwinfx](../../../../includes/vstecwinfx-md.md)] および [!INCLUDE[netfx35_long](../../../../includes/netfx35-long-md.md)] \(WF3\) の [!INCLUDE[wf](../../../../includes/wf-md.md)] からアクティビティを実行し、[!INCLUDE[netfx_current_long](../../../../includes/netfx-current-long-md.md)] \(WF4\) の [!INCLUDE[wf2](../../../../includes/wf2-md.md)] からワークフローを実行することができます。このサンプルは、WF4 ワークフロー サービスの <xref:System.Activities.Statements.Interop> アクティビティを使用して、<xref:System.Workflow.Activities.ExternalDataExchangeService> \(およびメソッドを呼び出してイベントを処理するための対応するカスタム アクティビティ\) を使用する WF3 ワークフローを設定および実行する方法を示します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Migration\ExternalDataExchange`  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ExternalDataExchange.sln ファイルを開きます。  
+  
+2.  サンプルをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  サンプルを実行するには、F5 キーを押します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-procedural-activities.md b/docs/framework/windows-workflow-foundation/samples/using-procedural-activities.md
new file mode 100644
index 00000000000..eb66272cfa6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-procedural-activities.md
@@ -0,0 +1,45 @@
+---
+title: "手続き型アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1c67f739-3878-48ad-806c-b2ce0d6733a0
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# 手続き型アクティビティの使用
+このサンプルでは、<xref:System.Activities.Statements.Sequence>、<xref:System.Activities.Statements.Assign>、<xref:System.Activities.Statements.If>、<xref:System.Activities.Statements.While>、<xref:System.Activities.Statements.Switch%601>、<xref:System.Activities.Statements.TryCatch>、および <xref:System.Activities.Statements.WriteLine> の各アクティビティを使用して推測ゲームを実装します。推測ゲームではランダムな数値が選択され、プレーヤーはその数値を推測する必要があります。プレーヤーが送信した推測が間違っていると、ワークフローは、その値が正解よりも上か下かを示すヒントを提供します。プレーヤーが 7 回未満で数値を推測できた場合は、特別な祝福のメッセージがユーザーに表示されます。  
+  
+## このサンプルのカスタム アクティビティ  
+  
+### ReadLine  
+ コンソールからテキスト行を読み取ります。このアクティビティは <xref:System.Activities.NativeActivity> クラスから派生し、行が読み取られるときにコンソール アプリケーションによって再開されるブックマークを作成します。  
+  
+### PromptInt  
+ ユーザーに数値の入力を求めるメッセージを表示し、その数値をコンソール ウィンドウから読み取ります。このアクティビティは <xref:System.Activities.Activity%601> から派生し、<xref:System.Activities.Statements.WriteLine> アクティビティと `ReadLine` アクティビティを使用します。  
+  
+##### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、GuessingGame.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\Procedurals`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md b/docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md
new file mode 100644
index 00000000000..b2745c0e7b0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md
@@ -0,0 +1,56 @@
+---
+title: "カスタム アクティビティ デザイナーでの ExpressionTextBox の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f82e73e7-a256-4a4d-82b7-c0d62f4ab5e7
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# カスタム アクティビティ デザイナーでの ExpressionTextBox の使用
+このサンプルでは、カスタム アクティビティ デザイナーで <xref:System.Activities.Presentation.View.ExpressionTextBox> を使用する方法を示します。カスタム アクティビティ `MultiAssign` は、2 つの文字列値を 2 つの文字列変数に割り当てます。<xref:System.Activities.Presentation.View.ExpressionTextBox> コントロールには、<xref:System.Activities.InArgument> にバインドされるものと <xref:System.Activities.OutArgument> にバインドされるものがあります。  
+  
+## サンプルの詳細  
+ `ArgumentToExpressionConverter` は、式を引数にバインドするときに使用される型コンバーターです。必要に応じて、`ConverterParameter` は、`In`、または `Out` に設定する必要があります。`InOut` はサポートされていません。  
+  
+ `UseLocationExpression` 属性は、`OutArgument` で使用され、式を L 値 \("左辺値" または "位置値"\) 式にすることを指定します。ほとんど場合、L 値式は、返される `OutArgument` が変数または引数の名前であることを示すために使用される有効な Visual Basic 識別子です。  
+  
+ この例では、`MaxLines` 属性は 1 に設定され、`MinLines` は設定されていません。つまり、ユーザーによって入力されるテキストの量に関係なく、<xref:System.Activities.Presentation.View.ExpressionTextBox> のサイズが 1 行に固定されることを示しています。<xref:System.Activities.Presentation.View.ExpressionTextBox> がユーザーの入力に合わせて拡大されるようにするには、`MaxLines` に `MinLines` より大きい値を設定します。  
+  
+ ExpressionTextBox は、引数にのみバインドできます。CLR プロパティにはバインドできません。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、ExpressionTextBoxSample.sln ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+#### このサンプルを実行するには  
+  
+1.  新しいワークフロー コンソール アプリケーションをソリューションに追加します。  
+  
+2.  **ExpressionTextBoxSample** プロジェクトへの参照を新しいワークフロー コンソール アプリケーション プロジェクトから追加します。  
+  
+3.  ソリューションをビルドします。  
+  
+4.  ツールボックスの **MultiAssign** アクティビティをドラッグし、ワークフローにドロップします。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\CustomActivities\CustomActivityDesigners\ExpressionTextBox`  
+  
+## 参照  
+ <xref:System.Activities.Presentation.View.ExpressionTextBox>   
+ [ワークフロー デザイナーを使用したアプリケーションの開発](../Topic/Developing%20Applications%20with%20the%20Workflow%20Designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-the-invokemethod-activity.md b/docs/framework/windows-workflow-foundation/samples/using-the-invokemethod-activity.md
new file mode 100644
index 00000000000..22649316df2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-the-invokemethod-activity.md
@@ -0,0 +1,63 @@
+---
+title: "InvokeMethod アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b6643550-d043-4ac7-8069-9c55ebbb4233
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# InvokeMethod アクティビティの使用
+このサンプルでは、<xref:System.Activities.Statements.InvokeMethod%601> アクティビティを使用してパブリック クラス内のパブリック メソッドを呼び出す方法を示します。<xref:System.Activities.Statements.InvokeMethod%601> アクティビティを使用すると、ワークフローでオブジェクトに対してメソッドを呼び出し、パラメーターを渡して、戻り値を取得し、ジェネリック メソッドの型を指定し、メソッドが同期または非同期のどちらであるかを指定できます。  
+  
+ <xref:System.Activities.Statements.InvokeMethod> アクティビティの非ジェネリック バージョンでは、戻り値が <xref:System.Activities.Statements.InvokeMethod.Result%2A> プロパティに設定され、<xref:System.Activities.Statements.InvokeMethod%601> アクティビティのジェネリック バージョンでは、戻り値が `TResult` 型の <xref:System.Activities.Statements.InvokeMethod.Result%601.Result%2A> プロパティを通じて返されます。  
+  
+ このサンプルでは、さまざまな型のメソッドの呼び出し方法を示します。次に、このサンプルに示されているメソッドの型の詳細を示します。  
+  
+-   パラメーターを指定せずにインスタンス メソッドを呼び出します。  
+  
+-   2 つのパラメーター \(System.String および System.Int32\) を指定してインスタンス メソッドを呼び出します。  
+  
+-   2 つのパラメーター \(System.String および System.Int32\) と、型 System.String\[\] のパラメーター配列を指定してインスタンス メソッドを呼び出します。  
+  
+-   2 つのパラメーター \(2 つの System.Int32 数値\) および System.Int32 型の結果を指定してインスタンス メソッドを呼び出します。  
+  
+     戻り値は変数にバインドされ、<xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに出力されます。  
+  
+-   2 つのパラメーター \(System.String および System.Int32\) を指定して静的メソッドを呼び出します。  
+  
+-   1 つのジェネリック パラメーター \(System.String\) を指定してインスタンス メソッドを呼び出します。  
+  
+-   2 つのジェネリック パラメーター \(System.String および System.Int32\) を指定して静的メソッドを呼び出します。  
+  
+-   参照渡しされる 1 つのパラメーター \(System.String\) を持つインスタンス メソッドを呼び出します。  
+  
+     参照されているパラメーターは変数にバインドされ、<xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに出力されます。  
+  
+-   非同期インスタンス メソッドを呼び出します。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、InvokeMethodUsage.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\InvokeMethod`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-the-invokepowershell-activity.md b/docs/framework/windows-workflow-foundation/samples/using-the-invokepowershell-activity.md
new file mode 100644
index 00000000000..06b2a069df5
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-the-invokepowershell-activity.md
@@ -0,0 +1,224 @@
+---
+title: "InvokePowerShell アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 956251a0-31ca-4183-bf76-d277c08585df
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# InvokePowerShell アクティビティの使用
+InvokePowerShell サンプルでは、`InvokePowerShell` アクティビティを使用して Windows PowerShell コマンドを呼び出す方法を示します。  
+  
+## 使用例  
+  
+-   Windows PowerShell コマンドの簡便さと革新性。  
+  
+-   Windows PowerShell の出力パイプラインから値を取得してワークフロー変数に格納する。  
+  
+-   実行するコマンドのための入力パイプラインとして Windows PowerShell にデータを渡す。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\PowerShell`  
+  
+## 説明  
+ このサンプルには次の 3 つのプロジェクトが含まれています。  
+  
+|プロジェクト名|説明|メイン ファイル|  
+|-------------|--------|--------------|  
+|CodedClient|PowerShell アクティビティを使用するサンプル クライアント アプリケーション。|-   **Program.cs**: InvokePowerShell アクティビティを呼び出すシーケンス ベースのワークフローをプログラムで作成します。|  
+|DesignerClient|`InvokePowerShell` カスタム アクティビティや他のさまざまなカスタム アクティビティを含むカスタム アクティビティのセットと、それらを使用するワークフロー。|<ul><li>アクティビティ:<br /><br /> <ul><li>**PrintCollection.cs**: コレクション内のすべての項目をコンソールに出力するヘルパー アクティビティ。</li><li>**ReadLine.cs**: コンソールからの入力を読み取るためのヘルパー アクティビティ。</li></ul></li><li>ファイル システム:<br /><br /> <ul><li>**Copy.xaml**: ファイルをコピーするアクティビティ。</li><li>**CreateFile.xaml**: ファイルを作成するアクティビティ。</li><li>**DeleteFile.xaml**: ファイルを削除するアクティビティ。</li><li>**MakeDir.xaml**: ディレクトリを作成するアクティビティ。</li><li>**Move.xaml**: ファイルを移動するアクティビティ。</li><li>**ReadFile.xaml**: ファイルを読み取ってその内容を返すアクティビティ。</li><li>**TestPath.xaml**: パスが存在するかどうかを調べるアクティビティ。</li></ul></li><li>プロセス:<br /><br /> <ul><li>**GetProcess.xaml**: 実行中のプロセスのリストを取得するアクティビティ。</li><li>**StopProcess.xaml**: 特定のプロセスを停止するアクティビティ。</li></ul></li><li>**Program.cs**: Sequence1 ワークフローを呼び出します。</li><li>**Sequence1.xaml**: シーケンス ベースのワークフロー。</li></ul>|  
+|PowerShell|`InvokePowerShell` アクティビティと、それに関連付けられたデザイナー。|アクティビティのファイル<br /><br /> -   **ExecutePowerShell.cs**: アクティビティのメインの実行ロジック。<br />-   **InvokePowerShell.cs**: メインの実行ロジックのラッパー。ジェネリック \(値を返す\) バージョンと非ジェネリック \(値を返さない\) バージョンが含まれています。これは、アクティビティのパブリック インターフェイスです。<br />-   **NoPersistZone.cs**: このアクティビティは、子アクティビティが永続化されるのを防ぎます。このクラスは、`InvokePowerShell` アクティビティの実装の中で、アクティビティが実行の途中で永続化されるのを防ぐために使用されます。<br /><br /> デザイナーのファイル:<br /><br /> 1.  **ArgumentDictionaryEditor.cs**: `InvokePowerShell` アクティビティの引数を編集できる Windows ダイアログ。<br />2.  **GenericInvokePowerShellDesigner.xaml** および **GenericInvokePowerShellDesigner.xaml.cs**: [!INCLUDE[wfd2](../../../../includes/wfd2-md.md)]でのジェネリック `InvokePowerShell` アクティビティの外観を定義します。<br />3.  **InvokePowerShellDesigner.xaml** および **InvokePowerShellDesigner.cs**: [!INCLUDE[wfd2](../../../../includes/wfd2-md.md)]での非ジェネリック `InvokePowerShell` アクティビティの外観を定義します。|  
+  
+ PowerShell アクティビティの使用方法を把握しているとその内部機能を理解しやすくなるため、クライアント プロジェクトから先に説明します。  
+  
+## このサンプルの使用  
+ 以降では、このサンプルの 3 つのプロジェクトの使用方法について説明します。  
+  
+### CodedClient プロジェクトの使用  
+ このサンプル クライアントは、`InvokePowerShell` アクティビティのさまざまな使用方法の例を含むシーケンス アクティビティをプログラムで作成します。最初の呼び出しでは、メモ帳を起動します。  
+  
+```  
+new InvokePowerShell()  
+{  
+    CommandText = "notepad"  
+},  
+  
+```  
+  
+ 2 番目の呼び出しでは、ローカル コンピューターで実行されているプロセスのリストを取得します。  
+  
+```  
+new InvokePowerShell<Process>()  
+{  
+    CommandText = "Get-Process",  
+    Output = processes1,  
+},  
+  
+```  
+  
+ `Output` は、コマンドの出力を格納するための変数です。  
+  
+ 次の呼び出しは、 PowerShell 呼び出しの個々の出力の後処理のステップを実行する方法を示します。`InitializationAction` は、各プロセスの文字列形式を出力する関数に設定されます。それらの文字列のコレクションは、`InvokePowerShell<string>` アクティビティによって `Output` 変数で返されます。  
+  
+ その後に続く一連の `InvokePowerShell` の呼び出しは、アクティビティにデータを渡して出力とエラーを取得する方法を示しています。  
+  
+### DesignerClient プロジェクトの使用  
+ DesignerClient プロジェクトは一連のカスタム アクティビティで構成されていますが、それらのほぼすべてに `InvokePowerShell` アクティビティが含まれています。ほとんどのアクティビティは、非ジェネリック バージョンの `InvokePowerShell` アクティビティを呼び出します。したがって、戻り値を受け取りません。ジェネリック バージョンの `InvokePowerShell` アクティビティを使用するその他のアクティビティは、`InitializationAction` 引数を使用して結果の後処理を行います。  
+  
+## PowerShell プロジェクトの使用  
+ アクティビティの主要なアクションは `ExecutePowerShell` クラスで実行されます。PowerShell コマンドの実行によってメインのワークフロー スレッドがブロックされないようにする必要があるため、アクティビティは、<xref:System.Activities.AsyncCodeActivity> クラスを継承して非同期アクティビティとして作成されています。  
+  
+ ワークフロー ランタイムによって <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> メソッドが呼び出されると、アクティビティの実行が開始されます。このメソッドは、まず最初に、PowerShell API を呼び出して PowerShell パイプラインを作成します。  
+  
+```  
+runspace = RunspaceFactory.CreateRunspace();  
+runspace.Open();  
+pipeline = runspace.CreatePipeline();  
+  
+```  
+  
+ 次に、PowerShell コマンドを作成してパラメーターと変数を設定します。  
+  
+```  
+Command cmd = new Command(this.CommandText, this.IsScript);   
+// loop over parameters and run: cmd.Parameters.Add(...)  
+// loop over variables and run: runspace.SessionStateProxy.SetVariable(...)  
+pipeline.Commands.Add(cmd);  
+  
+```  
+  
+ この時点で、パイプ入力された入力がパイプラインにも送信されます。最後に、パイプラインが `PipelineInvokerAsyncResult` オブジェクトでラップされて返されます。`PipelineInvokerAsyncResult` オブジェクトは、リスナーを登録してパイプラインを呼び出します。  
+  
+```  
+pipeline.InvokeAsync();  
+  
+```  
+  
+ 実行が終了すると、出力とエラーが同じ `PipelineInvokerAsyncResult` オブジェクトに格納され、最初に <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> に渡されたコールバック メソッドが呼び出されてワークフロー ランタイムに制御が返されます。  
+  
+ メソッドの実行の最後に、ワークフロー ランタイムがアクティビティの <xref:System.Activities.AsyncCodeActivity.EndExecute%2A> メソッドを呼び出します。  
+  
+ `InvokePowerShell` クラスは `ExecutePowerShellCommand` クラスをラップして、ジェネリック バージョンと非ジェネリック バージョンの 2 つのバージョンのアクティビティを作成します。非ジェネリック バージョンは PowerShell の実行の出力をそのまま返しますが、ジェネリック バージョンは個々の結果をジェネリック型に変換します。  
+  
+ ジェネリック バージョンのアクティビティは、`ExecutePowerShellCommand` を呼び出してその結果の後処理を行うシーケンシャル ワークフローとして実装されています。後処理のステップでは、結果のコレクションの各要素に対して、`InitializationAction` が設定されている場合にはそれが呼び出され、設定されていない場合には単純なキャストが行われます。  
+  
+```  
+new ForEach<PSObject>  
+{  
+    Values = psObjects,  
+    Body = new ActivityAction<PSObject>  
+    {  
+        Argument = psObject,  
+        Handler = new Sequence  
+        {  
+            Activities =  
+            {  
+                new If  
+                {  
+                    Condition = // Is InitializationAction set?  
+                    Then = new InvokeFunc<PSObject, TResult>  
+                    {  
+                        Argument = psObject,  
+                        Result = outputObject,  
+                        Func = this.InitializationAction  
+                    },  
+                    Else = new Assign<TResult>  
+                    {  
+                        To = outputObject,  
+                        Value = new InArgument<TResult>(ctx => (TResult) psObject.Get(ctx).BaseObject),  
+                    }  
+                },  
+                new AddToCollection<TResult>  
+                {  
+                    Collection = outputObjects,  
+                    Item = outputObject  
+                },  
+            }  
+        }  
+    }  
+},  
+  
+```  
+  
+ 2 つの `InvokePowerShell` アクティビティ \(ジェネリックと非ジェネリック\) のそれぞれにデザイナーが用意されています。InvokePowerShellDesigner.xaml とその関連 .cs ファイルは、非ジェネリック バージョンの `InvokePowerShell` アクティビティの[!INCLUDE[wfd2](../../../../includes/wfd2-md.md)]での外観を定義します。InvokePowerShellDesigner.xaml では、<xref:System.Windows.Controls.DockPanel> を使用してグラフィカル インターフェイスを表しています。  
+  
+```  
+<DockPanel x:Uid="DockPanel_1" LastChildFill="True">  
+        <TextBlock x:Uid="TextBlock_1" Text="CommandText" />  
+        <TextBox x:Uid="TextBox_1" Text="{Binding Path=ModelItem.CommandText, Mode=TwoWay}"  
+                 TextWrapping="WrapWithOverflow"  AcceptsReturn="True" MinLines="4" MaxLines="4"  
+                 Background="{x:Null}" Margin="3" />  
+    </DockPanel>  
+  
+```  
+  
+ テキスト ボックスの `Text` プロパティが双方向のバインドになっているため、アクティビティの `CommandText` プロパティの値がデザイナーに入力された値と同じになります。  
+  
+ GenericInvokePowerShellDesigner.xaml とその関連 .cs ファイルは、ジェネリック `InvokePowerShell` アクティビティのグラフィカル インターフェイスを定義します。このデザイナーは、`InitializationAction` を設定できるようになっているため、非ジェネリック バージョンのデザイナーに比べてやや複雑です。ここでのポイントは、<xref:System.Activities.Presentation.WorkflowItemPresenter> を使用して、`InvokePowerShell` のデザイナー画面に子アクティビティをドラッグ アンド ドロップできるようにしていることです。  
+  
+```  
+<sap:WorkflowItemPresenter x:Uid="sap:WorkflowItemPresenter_1" Margin="0,10,0,10"  
+    HintText="Drop Activities Here"  
+    AllowedItemType="{x:Type sa:Activity}"  
+    Item="{Binding Path=ModelItem.InitializationAction.Handler, Mode=TwoWay}"  
+    Grid.Row="1" Grid.Column="1" />  
+  
+```  
+  
+ デザイナーでカスタマイズできるのは、デザイン キャンバスでのアクティビティの外観を定義する .xaml ファイルだけではありません。アクティビティのパラメーターを表示するために使用されるダイアログ ボックスもカスタマイズできます。これらのパラメーターや PowerShell 変数は、PowerShell コマンドの動作に影響します。アクティビティはこれらを <xref:System.Collections.Generic.Dictionary%601> 型として公開します。これらの型を編集できるダイアログ ボックスは、ArgumentDictionaryEditor.cs、PropertyEditorResources.xaml、および PropertyEditorResources.cs で定義されています。  
+  
+## サンプルを設定、ビルド、および実行するには  
+ このサンプルを実行するには Windows PowerShell をインストールする必要があります。Windows PowerShell は、[Windows PowerShell](http://go.microsoft.com/fwlink/?LinkId=150383) からインストールできます。  
+  
+#### コード クライアントを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して PowerShell.sln を開きます。  
+  
+2.  ソリューションを右クリックしてビルドします。  
+  
+3.  **\[CodedClient\]** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+4.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+#### デザイナー クライアントを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して PowerShell.sln を開きます。  
+  
+2.  ソリューションを右クリックしてビルドします。  
+  
+3.  **\[DesignerClient\]** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+4.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+## 既知の問題  
+  
+1.  `InvokePowerShell` アクティビティのアセンブリやプロジェクトを別のプロジェクトから参照してビルド エラーが発生した場合は、必要に応じて、新しいプロジェクトの .csproj ファイル \(`InvokePowerShell` を参照している行の下\) に `<SpecificVersion>True</SpecificVersion>` 要素を手動で追加してください。  
+  
+2.  Windows PowerShell がインストールされていない場合は、`InvokePowerShell` アクティビティをワークフローに追加するとすぐに、Visual Studio で次のエラー メッセージが表示されます。"`ワークフロー デザイナーはドキュメントで問題を検出しました。ファイルまたはアセンブリ 'System.Management.Automation'、またはその依存関係の 1 つが読み込めませんでした。指定されたファイルが見つかりません。`  
+  
+3.  Windows PowerShell 2.0 では、プログラムで `$input.MoveNext()` を呼び出すと呼び出しが失敗します。そのため、`$input.MoveNext()` を使用するスクリプトで予想外のエラーと結果が生成されます。この問題を回避するには、配列を反復処理するときに、`MoveNext()` を呼び出す代わりに PowerShell の動詞 `foreach` を使用することを検討してください。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\PowerShell`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md b/docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md
new file mode 100644
index 00000000000..73d1a0f325b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-the-pick-activity.md
@@ -0,0 +1,63 @@
+---
+title: "Pick アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b89be812-a247-4025-b0e3-ffb20db027a6
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# Pick アクティビティの使用
+このサンプルでは、<xref:System.Activities.Statements.Pick> アクティビティを使用する方法を示します。  
+  
+ <xref:System.Activities.Statements.Pick> アクティビティでは、イベント ベースの制御モデリングを提供します。このアクティビティの動作は C\# の `switch` ステートメントに似ています。`switch` ステートメントでは、その分岐のうち 1 つだけが実行されます。ただし、値に基づいて分岐が実行される `switch` ステートメントと異なり、<xref:System.Activities.Statements.Pick> アクティビティでは、アクティビティの完了の状態に基づいて分岐を実行します。  
+  
+ このサンプルでは、指定した時間内にコンソールでユーザー名を入力するようユーザーに求めます。このサンプルの <xref:System.Activities.Statements.Pick> アクティビティには、ユーザーが 5 秒以内にユーザー名を入力したかどうかに基づいて実行される 2 つの分岐があります。ユーザーが 5 秒以内にユーザー名を入力した場合は、カスタムの `ReadLine` アクティビティを含む最初の分岐が実行されます。それ以外の場合は、<xref:System.Activities.Statements.Delay> アクティビティを含むもう 1 つの分岐が実行されます。コンソールでユーザー名を入力すると、そのユーザー名がコンソールに出力されます。5 秒以内に入力しないと、操作はタイムアウトします。  
+  
+## 使用例  
+ <xref:System.Activities.Statements.Pick> アクティビティ。  
+  
+## 説明  
+ このサンプルには、デザイナー ワークフローとコード化されたワークフローがあります。  
+  
+ デザイナー ワークフロー  
+ このサンプルのデザイナー バージョンでは、デザイナーでワークフローを作成する方法を示します。次のファイルがあります。  
+  
+-   Program.cs: サンプル ワークフローを実行する `Main` 関数が含まれています。  
+  
+-   ReadString.cs: コンソールからの入力を読み取るカスタム アクティビティです。  
+  
+-   Sequence1.xaml: Pick を使用する、デザイナーで作成されたワークフローです。  
+  
+ コード化されたワークフロー  
+ このサンプルのコード化されたバージョンでは、デザイナーでワークフローを作成する方法を示します。次のファイルがあります。  
+  
+-   Program.cs: サンプル ワークフローを実行する `Main` 関数が含まれています。  
+  
+-   ReadString.cs: コンソールからの入力を読み取るカスタム アクティビティです。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、Pick.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\Pick`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-the-workflowinvoker-class.md b/docs/framework/windows-workflow-foundation/samples/using-the-workflowinvoker-class.md
new file mode 100644
index 00000000000..166622f870f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-the-workflowinvoker-class.md
@@ -0,0 +1,44 @@
+---
+title: "WorkflowInvoker クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a966164-3990-4e78-8aa2-c6797ebbee94
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# WorkflowInvoker クラスの使用
+このサンプルでは、<xref:System.Activities.WorkflowInvoker> クラスを使用して、メソッドのようにアクティビティを呼び出す方法を示します。  
+  
+## サンプルの詳細  
+ アクティビティを実行するための最も簡単な方法は、<xref:System.Activities.WorkflowInvoker> クラスを使用する方法です。このクラスは、メソッドを呼び出すようにアクティビティを直接実行することを目的として設計されています。このクラスは、軽量で高性能な、使いやすい API で、アクティビティを実行する際に他のホスティングのバリエーションが提供する制御インフラストラクチャを必要としないシナリオで使用できます。  
+  
+ このサンプルは、2 つの <xref:System.Activities.InArgument%601> \(`X` および `Y`\) を追加する `Add` という名前の <xref:System.Activities.CodeActivity%601>\<Int32\> から派生したカスタム アクティビティを使用し、`Result`<xref:System.Activities.OutArgument%601> を返します \(`Result` という名前の <xref:System.Activities.OutArgument%601>\<T\> を持つ <xref:System.Activities.Activity%601>\<T\> から派生した <xref:System.Activities.CodeActivity%601>\<T\>\)。`Dictionary`\<文字列、オブジェクト\> は、<xref:System.Activities.WorkflowInvoker> を介して呼び出されるアクティビティに引数を渡すために使用されます。ディクショナリのキーは、呼び出し先のアクティビティにおける引数名に対応します。特定のキーに関連付けられた値は、キーによって識別される引数にバインドされます。  
+  
+ このサンプルは、<xref:System.Activities.WorkflowInvoker.Invoke%2A> を呼び出して、`X` および `Y` の値を含むディクショナリを渡します。<xref:System.Activities.WorkflowInvoker> クラスは、これらの値を `Add` アクティビティの引数にバインドし、アクティビティを実行して、結果を返します。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、Invoker.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\WorkflowInvoker`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/using-variables-with-dotnet-ruleset.md b/docs/framework/windows-workflow-foundation/samples/using-variables-with-dotnet-ruleset.md
new file mode 100644
index 00000000000..bfa7b5508a9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/using-variables-with-dotnet-ruleset.md
@@ -0,0 +1,58 @@
+---
+title: ".NET Framework 3.5 ルールセットでの変数の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 27b56249-22fe-4252-840f-74c0d6c7a6b3
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# .NET Framework 3.5 ルールセットでの変数の使用
+このサンプルでは、<xref:System.Activities.Statements.Interop> アクティビティを使用するワークフローを作成し、ポリシーとルールを使用する、[!INCLUDE[netfx35_short](../../../../includes/netfx35-short-md.md)] で記述されたカスタム アクティビティを統合する方法を示します。このワークフローでは、カスタム アクティビティで公開されている依存プロパティに変数をバインドすることで、カスタム アクティビティにデータを渡します。  
+  
+## サンプルのチュートリアル  
+  
+#### TravelRuleLibrary を検証するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して、InteropWith35RuleSet.sln ソリューション ファイルを開きます。  
+  
+2.  ワークフロー デザイナーで TravelRuleSet.cs を開きます。  
+  
+     <xref:System.Workflow.Activities.PolicyActivity> を含むカスタム シーケンシャル アクティビティが表示されます。  
+  
+3.  ルールを検証するには、DiscountPolicy ポリシー アクティビティをダブルクリックします。  
+  
+     ルール エディターがポップアップで開き、ルールが表示されます。  
+  
+4.  アクティビティのコード側 C\# コードを検証するには、`DiscountPolicy` を右クリックして **\[コードの表示\]** をクリックします。  
+  
+     `DiscountLevel` の依存関係プロパティの設定を確認します。これは [!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] の引数と同じです。引数 [!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[変数と引数](../../../../docs/framework/windows-workflow-foundation//variables-and-arguments.md)」を参照してください。  
+  
+## InteropWith35RuleSet  
+ これは、<xref:System.Activities.Statements.Interop> アクティビティを使用して、`TravelRuleLibrary` プロジェクトで作成されたカスタム ルール セットと統合するシーケンシャル ワークフロー プロジェクトです。変数は、最上位レベルの <xref:System.Activities.Statements.Sequence> アクティビティで作成されます。<xref:System.Activities.Statements.Interop> アクティビティは、`TravelRuleSet` アクティビティと統合するために使用されます。<xref:System.Activities.Statements.Sequence> で宣言された変数は、依存プロパティにバインドするために使用されます。  
+  
+## このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、InteropWith35RuleSet.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Built-InActivities\InteropWith35RuleSet`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/validation.md b/docs/framework/windows-workflow-foundation/samples/validation.md
new file mode 100644
index 00000000000..b464b0262df
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/validation.md
@@ -0,0 +1,31 @@
+---
+title: "検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8ea741d7-ccfb-46c5-a3fb-b66d6ebd6928
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 検証
+このセクションには、アクティビティの検証を示すサンプルが含まれています。  
+  
+## このセクションの内容  
+ [外部アクティビティの検証](../../../../docs/framework/windows-workflow-foundation/samples/external-activity-validation.md)  
+ このサンプルでは、ユーザーが作成するものではないビルトイン アクティビティに検証ロジックを追加する方法を示します。  
+  
+ [基本検証](../../../../docs/framework/windows-workflow-foundation/samples/basic-validation.md)  
+ `CreateProduct` アクティビティを示します。このアクティビティでは、その `Cost` 引数が `Price` 引数以下であることを検証します。  
+  
+ [OverloadGroups](../../../../docs/framework/windows-workflow-foundation/samples/overloadgroups.md)  
+ `CreateLocation` アクティビティを示します。このアクティビティには、必須の引数と省略可能な引数があり、ユーザーは 2 つの異なる引数のセットのどちらかを指定できます。  
+  
+ [アクティビティの関係の検証](../../../../docs/framework/windows-workflow-foundation/samples/activity-relationships-validation.md)  
+ アクティビティ間の関係を検証する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/visual-workflow-tracking.md b/docs/framework/windows-workflow-foundation/samples/visual-workflow-tracking.md
new file mode 100644
index 00000000000..c5c55f70284
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/visual-workflow-tracking.md
@@ -0,0 +1,48 @@
+---
+title: "ビジュアル ワークフロー追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0143448f-2044-40a0-8a3d-941f6d12468b
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ビジュアル ワークフロー追跡
+このサンプルでは、[!INCLUDE[netfx_current_short](../../../../includes/netfx-current-short-md.md)] のデバッグ機能を使用してビジュアル ワークフロー追跡アプリケーションを作成する方法を示します。  
+  
+## サンプルの詳細  
+ このアプリケーションは、Workflow.xaml に定義されている単純なフローチャート ワークフローを実行し、ワークフロー デザイナーを再ホストして現在実行中のワークフローを表示します。ワークフローが実行されると、現在実行中のアクティビティが黄色の枠とデバッグ矢印で示されます。さらに、ワークフローによって生成された追跡レコードもアプリケーション ウィンドウに表示されます。ワークフロー追跡機能[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、[ワークフロー追跡とトレース](../../../../docs/framework/windows-workflow-foundation//workflow-tracking-and-tracing.md)を参照してください。[!INCLUDE[crabout](../../../../includes/crabout-md.md)] ワークフロー デザイナーのホスト変更は、[ワークフロー デザイナーのホスト変更](../../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md) を参照してください。  
+  
+ このワークフロー シミュレーターは、2 つのディクショナリを保持することによって機能します。一方のディクショナリには、現在実行中のアクティビティ オブジェクトと、そのアクティビティがインスタンス化された XAML の行番号とのマッピングが含まれています。もう一方のディクショナリには、アクティビティ インスタンス ID とアクティビティ オブジェクトとのマッピングが含まれています。カスタム追跡プロファイルを使用して追跡レコードが出力されるときには、現在実行中のアクティビティのインスタンス ID が特定されて、そのアクティビティをインスタンス化した XAML ファイルにマップされます。その後、再ホストされたワークフロー デザイナーで、ワークフロー デバッガーと同じ方法を使用してそのアクティビティがデザイナー画面で強調表示されます \(アクティビティが黄色の枠で囲まれ、デザイナーの左端に黄色の矢印が表示されます\)。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] のサンプル ディレクトリにある WorkflowSimulator.sln ファイルを開きます。  
+  
+2.  Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+3.  Ctrl キーを押しながら F5 キーを押してサンプルを実行します。再ホストされたワークフロー デザイナーのウィンドウに Workflow.xaml ファイルが表示されます。  
+  
+4.  **\[ファイル\]** メニューの **\[ワークフローの実行...\]** をクリックします。  
+  
+5.  現在実行中のアクティビティが上述のように強調表示され、アプリケーション ウィンドウの右側に追跡レコードが表示されます。  
+  
+6.  ワークフローが完了したら、任意の追跡レコードをクリックして、どのアクティビティに対応しているのかを調べることができます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Application\VisualWorkflowTracking`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/wait-for-input-activity.md b/docs/framework/windows-workflow-foundation/samples/wait-for-input-activity.md
new file mode 100644
index 00000000000..2b04fab1320
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/wait-for-input-activity.md
@@ -0,0 +1,71 @@
+---
+title: "入力アクティビティの待機 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d58c344e-9ee8-4ce2-b199-75b3fe45237f
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# 入力アクティビティの待機
+このサンプルでは、ワークフローに名前付きブックマークを作成する方法を示します。[!INCLUDE[wf](../../../../includes/wf-md.md)] には、宣言型ブックマークを作成するアクティビティは用意されていません。そのため、ワークフローにブックマークを作成する場合は、ブックマークを作成するカスタム アクティビティを記述する必要があります。このサンプルで定義される `WaitForInput` アクティビティはこの機能を提供します。そのため、ユーザーはワークフロー内で宣言によってブックマークを作成できます。  
+  
+## このサンプルのプロジェクト  
+  
+||||  
+|-|-|-|  
+|**プロジェクト名**|**説明**|**メイン ファイル**|  
+|WaitForInput|`WaitForInput` アクティビティとそのデザイナーが含まれます。|WaitForInput.cs<br /><br /> `WaitForInput` アクティビティ定義。|  
+|||WaitForInputDesigner.xaml<br /><br /> `WaitForInput` アクティビティのカスタム デザイナー。|  
+|||TypeToFirstGenericArgumentConverter.cs<br /><br /> デザイナーでアクティビティのジェネリック型を更新するために使用される WPF 型コンバーター。|  
+|WaitForInputTestClient|ワークフロー デザイナーで、複数の WaitForInput アクティビティを使用してワークフローを構成および実行するサンプル クライアント アプリケーション。|Sequence1.xaml<br /><br /> `WaitForInput` アクティビティを使用するシーケンシャル ワークフロー。|  
+|||Program.cs<br /><br /> Sequence1.xaml で定義されているワークフローのインスタンスを実行します。|  
+  
+## WaitForInput アクティビティ  
+ `WaitForInput` アクティビティは、ワークフローに名前付きブックマークを作成します。ブックマークはシグナルを待機し、構成された型のデータを受信します。ブックマークが再開されると、ワークフローに渡されたデータを `Result` プロパティで使用できるようになります。  
+  
+ `WaitForInput` アクティビティは、<xref:System.Activities.NativeActivityContext> クラスを介してのみアクセスできるブックマークを作成する必要があるため、<xref:System.Activities.NativeActivity> クラスから派生します。  
+  
+ このアクティビティには、デザイナーをバインドするための属性、更新可能なジェネリック引数機能を追加するための属性、および既定のジェネリック型を文字列に設定するための属性が割り当てられます。また、このアクティビティには、次の表に示す引数があります。  
+  
+||||  
+|-|-|-|  
+|**名前**|**型**|**説明**|  
+|TResult|ジェネリック引数 \(TResult\)|ブックマークの型。これは再開時にブックマークに渡されるデータの型です。|  
+|BookmarkName|InArgument\<string\>|ブックマークの名前。|  
+|Result|InArgument\<TResult\>|ブックマークが再開されたときにアクティビティに渡されるデータ。|  
+  
+## WaitForInput アクティビティ デザイナー  
+ `WaitForInput` アクティビティ デザイナーは、WaitForInputDesigner.xaml ファイルで実装されます。`WaitForInput` アクティビティとそのデザイナーは、同じアセンブリに格納されます。次の図は、アセンブリと同じ名前を持つカテゴリ内のツールボックスに含まれる `WaitForInput` アクティビティを示しています。  
+  
+ ![WaitForInput ツールボックスのスクリーンショット](../../../../docs/framework/windows-workflow-foundation/samples/media/waitforinputtoolbox.jpg "WaitForInputToolbox")  
+  
+ 次の図は、`WaitForInput` デザイナーを示しています。`WaitForInput` アクティビティは非常に基本的なアクティビティであるため、そのすべての引数をデザイナー サーフェイスで直接設定できます。  
+  
+ ![WaitForInput アクティビティ デザイナー](../../../../docs/framework/windows-workflow-foundation/samples/media/waitforinputdesigner.jpg "WaitForInputDesigner")  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、WaitForInput.sln ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  サンプルをデバッグなしで開始するには、Ctrl キーを押しながら F5 キーを押します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\ActivityLibrary\WaitForInput`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md b/docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md
new file mode 100644
index 00000000000..1327dc77ca0
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/workflow-management-endpoint-sample.md
@@ -0,0 +1,43 @@
+---
+title: "ワークフロー管理エンドポイントのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 3ac6e08f-c43d-4bb7-83c3-e3890a4dac03
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# ワークフロー管理エンドポイントのサンプル
+このサンプルでは、ワークフロー コントロール エンドポイントを使用して、ローカルとリモートの両方でワークフローを作成および実行する方法を示します。このサンプルでは、コントロール エンドポイントをホストし、そのコントロール エンドポイントを呼び出すクライアントを記述して、ワークフローのインスタンスを作成および実行する方法を示します。このワークフローはサービスではありません。  
+  
+ サンプルのサービス側で、ワーク フローが WorkflowServiceHost を使用してホストされ、クライアントが管理操作 \(保留、開始など\) を実行できるように WorkflowControlEndpoint が追加されます。ワークフローの作成のため、ユーザー定義 CreationEndpoint も追加されます。次にサービスは中断状態のワーク フローを開始するこれらのエンドポイントを使用して、ワーク フローを再開します。クライアントはクライアント コードから同じ操作を実行します。これらのインターフェイスについては、[!INCLUDE[crabout](../../../../includes/crabout-md.md)]、「[ワークフロー コントロール エンドポイント](../../../../docs/framework/wcf/feature-details/workflow-control-endpoint.md)」および「[方法 : IIS でサービス以外のワークフローをホストする](../../../../docs/framework/wcf/feature-details/how-to-host-a-non-service-workflow-in-iis.md)」を参照してください。  
+  
+#### サンプルを実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を管理者権限で実行します。  
+  
+2.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で ManagementEndpoint.sln ソリューションを開きます。  
+  
+3.  ソリューションをビルドするには、CTRL キーと SHIFT キーを押したまま B キーを押すか、**\[ビルド\]** メニューの **\[ソリューションのビルド\]** を選択します。  
+  
+4.  ManagementEndpoint.exe アプリケーションを起動します。  
+  
+5.  Client.exe アプリケーションを起動します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\ManagementEndpoint`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/workflowapplication-readline-host.md b/docs/framework/windows-workflow-foundation/samples/workflowapplication-readline-host.md
new file mode 100644
index 00000000000..97eeeef27bf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/workflowapplication-readline-host.md
@@ -0,0 +1,68 @@
+---
+title: "WorkflowApplication ReadLine ホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f7b362be-cb42-40d7-b9ef-cfc4aed2455b
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# WorkflowApplication ReadLine ホスト
+このサンプルは、汎用 ReadLine ホストです。用意されている `ReadLine` アクティビティ \(または文字列を使用して再開されるブックマークからデータを取得する他の同様のアクティビティ\) を使用して、任意のワークフローを読み込んで実行することができます。`WriteLine` アクティビティ、または <xref:System.Activities.Statements.WriteLine.TextWriter%2A> 拡張に書き込みを行うアクティビティからの出力は、ホスト ウィンドウに送られます。インスタンスがアイドル状態の場合、そのインスタンスの使用可能なブックマークがコンボ ボックスに表示されます。ブックマークを選択してテキストを入力し、ブックマークを再開するボタンをクリックすると、ワークフローの実行が続行されます。選択したワークフローを取り消したり、中止または終了することもできます。既定では永続化が有効になっており、ホストをシャットダウンして再起動しても、データベースに格納されているインスタンスがインスタンスの一覧に読み込まれます。<xref:System.Activities.WorkflowApplication> レベルのイベントをホストに出力するには、追跡を使用します。オプションで、アクティビティ レベルの詳細な追跡も行うことができます。  
+  
+## サンプルの詳細  
+ このホストには、ビューとインスタンス マネージャーの 2 つのレイヤーがあります。ビューは、`HostView` クラスと `WorkflowApplicationInfo` クラスで構成されます。このホストの一般的なパターンでは、`HostView` クラスを使用して、対象のインスタンスと適切に同期された `WorkflowApplicationInfo` オブジェクトに基づいて、ユーザーに使用可能なオプションを表示します。インスタンス マネージャー レイヤーは、すべてのホスト通信の中核となる `WorkflowApplicationManager` クラス、インスタンスとそれを開始するのに使用されたプログラム定義との関係を永続化する `WorkflowDefinitionExtension` クラス、およびその他のいくつかのクラスで構成されます。`HostView` から、`WorkflowApplicationManager` に対する制御操作の呼び出しが行われます。これらの呼び出しは、通常、ユーザー インターフェイスの応答性を維持するために非同期で実行されます。非同期呼び出しが完了すると、`WorkflowApplicationManager` から、適切に定義されたインターフェイス \(`IHostView`\) を介してビュー レイヤーにコールバックされます。`HostView` クラスは、ほとんどの場合、`WorkflowApplicationManager` クラスからのこれらの呼び出しをユーザー インターフェイス スレッドにディスパッチします。`HostView` クラスで提供されるスレッド セーフな <xref:System.Activities.Statements.WriteLine.TextWriter%2A> オブジェクトへのテキストの書き込みが実行されます。イベントを生成する方法はユーザー インターフェイスだけではありません。たとえば、<xref:System.Activities.WorkflowApplication> オブジェクトも、状態が `Idle`、`Complete`、または `Aborted` になると `WorkflowApplicationManager` に通知します。`WorkflowApplicationManager` クラスは、ホストにクリーンアップ処理または更新処理をディスパッチしてイベント スレッドを削除します。  
+  
+ <xref:System.Activities.WorkflowApplication> の起動に使用されたファイルは、`WorkflowDefinitionExtension` クラスを使用して簡単に記録することができます。このクラスは、永続化に参加してワークフロー定義のパスを永続化するために、<xref:System.Activities.Persistence.PersistenceIOParticipant> インターフェイスを実装します。  
+  
+ `WorkflowApplicationManager.Load` メソッドは、格納されているパスを使用して、未完了の <xref:System.Activities.WorkflowApplication> オブジェクトの読み込みに必要なワークフロー プログラムをインスタンス化します。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  このサンプルを実行するには、SQL Express がインストールされている必要があります。SQL Express は [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] に付属しています。  
+  
+2.  Visual Studio 2010 コマンド プロンプトを開きます。  
+  
+3.  サンプル ディレクトリ \(\\WF\\Basic\\Execution\\ControllingWorkflowApplications\) に移動して、CreateInstanceStore.cmd を実行します。  
+  
+4.  CreateInstanceStore.cmd スクリプトは、SQL Server 2008 Express の既定のインスタンスにデータベースを作成しようとします。別のインスタンスにデータベースをインストールする場合は、そのようにスクリプトを変更してください。  
+  
+5.  WorkflowApplicationReadLineHost プロジェクトをコンパイルし、コマンド ラインから実行します。  
+  
+6.  実行後、永続化を有効にするか無効にするかを必要に応じて切り替えることができます。また、詳細なアクティビティ追跡についても、有効にするか無効にするかを切り替えることができます。  
+  
+7.  **\[実行\]** ボタンの横にある省略記号ボタンをクリックして、XAML ファイルで定義されたワークフローを参照します。  
+  
+     SampleWorkflows フォルダーには、サンプルが 2 つあります。parallel1.xaml サンプルはアイドル状態になります。  
+  
+8.  サンプルを選択したら、**\[実行\]** ボタンをクリックします。  
+  
+9. ワークフローがアイドル状態になると、使用可能なブックマークが **\[ブックマーク\]** ボックスに読み込まれます。  
+  
+10. ここで、ブックマークの再開や、ワークフローの取り消し、中止、または終了を実行できます。また、ホストをシャットダウンして再起動することもできます。永続化を有効なままにしてあれば、シャットダウン時にインスタンスがアンロードされ、起動時に再度読み込まれます。  
+  
+     ブックマークを再開するには、目的のブックマークを選択し、コンボ ボックスの横にあるテキスト ボックスに値を入力して、**\[ブックマークの再開\]** をクリックします。  
+  
+#### インスタンス ストア データベースを削除するには  
+  
+1.  Visual Studio 2010 コマンド プロンプトを開きます。  
+  
+2.  サンプル ディレクトリ \(\\WF\\Basic\\Execution\\ControllingWorkflowApplications\) に移動して、RemoveInstanceStore.cmd を実行します。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\ControllingWorkflowApplications`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md b/docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md
new file mode 100644
index 00000000000..c9b8825a801
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/workflowhostingendpoint-resume-bookmark.md
@@ -0,0 +1,45 @@
+---
+title: "WorkflowHostingEndpoint 再開ブックマーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a708064f-50b0-4751-b44e-d5410d08d451
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WorkflowHostingEndpoint 再開ブックマーク
+このサンプルでは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を <xref:System.ServiceModel.Activities.WorkflowServiceHost> と共に使用して、ワークフロー インスタンスを作成する方法を示します。  
+  
+## 使用例  
+ <xref:System.ServiceModel.Activities.WorkflowHostingEndpoint>,<xref:System.ServiceModel.Activities.WorkflowServiceHost>  
+  
+## 説明  
+ このサンプルでは、<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> を使用して、 <xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用してホストされるワークフロー インスタンスを作成します。<xref:System.ServiceModel.Activities.WorkflowHostingEndpoint> は、次のシナリオで使用できる <xref:System.ServiceModel.Activities.WorkflowServiceHost> の機能拡張ポイントです。  
+  
+-   新しいワークフロー インスタンスの作成  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowServiceHost> でホストされているワークフロー インスタンスでのブックマークの再開  
+  
+ 含まれているサンプルのエンドポイントでは、ワークフローを作成してインスタンス ID を返したり、特定の ID を持つインスタンスを作成したりするための操作を提供するコントラクトを公開します。サンプルのコンソール アプリケーションでは、基本のワークフロー定義を含む <xref:System.ServiceModel.Activities.WorkflowServiceHost> インスタンスが作成されて、`CreationEndpoint` がホストに追加されます。その後、エンドポイントで `Create` 操作が呼び出され、新しいワークフロー インスタンスが作成されます。  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  ソリューションをビルドします。  
+  
+2.  アプリケーションを実行します。`CreationEndpoint` コンソールには、ワークフロー インスタンスの作成時にインスタンス ID を含むメッセージが表示されます。ブックマークが正しく再開されると、ワークフローによってメッセージ "Hello World\!" が出力されます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Execution\ResumeBookmarkEndpoint`
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/wpf-and-wf-integration-in-xaml.md b/docs/framework/windows-workflow-foundation/samples/wpf-and-wf-integration-in-xaml.md
new file mode 100644
index 00000000000..468b7076b4a
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/wpf-and-wf-integration-in-xaml.md
@@ -0,0 +1,53 @@
+---
+title: "XAML での WPF と WF の統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a4f53b48-fc90-4315-bca0-ba009562f488
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# XAML での WPF と WF の統合
+このサンプルでは、[!INCLUDE[avalon1](../../../../includes/avalon1-md.md)] および [!INCLUDE[wf](../../../../includes/wf-md.md)] 機能を使用するアプリケーションを 1 つの XAML ドキュメントで作成する方法を示します。これを実現するために、サンプルでは [!INCLUDE[wf](../../../../includes/wf-md.md)] および XAML 機能拡張を使用します。  
+  
+## サンプルの詳細  
+ ShowWindow.xaml ファイルは、シーケンスのアクティビティによって操作される 2 つの文字列変数 `ShowWindow` および `WriteLine` を持つ <xref:System.Activities.Statements.Sequence> アクティビティに逆シリアル化します。<xref:System.Activities.Statements.WriteLine> アクティビティは、<xref:System.Activities.Statements.WriteLine.Text%2A> プロパティに割り当てる式をコンソール ウィンドウに出力します。`ShowWindow` アクティビティは、実行ロジックの一部として [!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] ウィンドウを表示します。このウィンドウの <xref:System.Activities.ActivityContext.DataContext%2A> には、シーケンスで宣言された変数が含まれます。`ShowWindow` アクティビティで宣言されたウィンドウのコントロールは、データ バインドを使用してこれらの変数を操作します。最後に、このウィンドウにはボタン コントロールが含まれます。このボタンの `Click` イベントは、`CloseWindow` アクティビティを含む `MarkupExtension` という名前の <xref:System.Activities.ActivityDelegate> によって処理されます。`MarkUpExtension` は、`x:Name` によって識別されるオブジェクトおよび格納先ウィンドウの <xref:System.Activities.ActivityContext.DataContext%2A> を、コンテキストとして提供する、含まれているアクティビティを呼び出します。したがって、`CloseWindow.InArgument<Window>` は、ウィンドウの名前を参照する式を使用してバインドできます。  
+  
+ `ShowWindow` アクティビティは、[!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] ウィンドウを表示するために <xref:System.Activities.AsyncCodeActivity%601> クラスから派生し、ウィンドウが閉じられるときに完了します。`Window` プロパティは、アクティビティの実行ごとにウィンドウを必要に応じて作成できるようにする `Func<Window>` 型です。`Window` プロパティは、<xref:System.Xaml.XamlDeferringLoader> を使用してこの遅延評価モデルを有効にします。`FuncFactoryDeferringLoader` を使用すると、`XamlReader` をシリアル化中にキャプチャしてアクティビティの実行中に読み取ることができます。  
+  
+ アクティビティが適切に記述されていれば、スケジューラ スレッドはブロックされません。ただし、`ShowWindow` アクティビティは、表示しているウィンドウが閉じられるまで完了できません。`ShowWindow` アクティビティは、<xref:System.Activities.AsyncCodeActivity> から派生して <xref:System.Activities.WorkflowInvoker.BeginInvoke%2A> メソッドを <xref:System.Activities.AsyncCodeActivity.BeginExecute%2A> メソッドで呼び出し、ウィンドウをモーダルで表示することによってこの動作を実現します。デリゲートは、WPF <xref:System.ServiceModel.InstanceContext.SynchronizationContext%2A> を介して呼び出されます。`ShowWindow` アクティビティは、<xref:System.Activities.ActivityContext.DataContext%2A> プロパティを `Window.DataContext` プロパティに割り当てて、データ バインド コントロールがスコープ内の変数にアクセスできるようにします。  
+  
+ このサンプルにおける最後の重要な点は、`DelegateActivityExtension` という <xref:System.Workflow.ComponentModel.Serialization.MarkupExtension> です。このマークアップ拡張機能の `ProvideValue` メソッドは、埋め込みアクティビティを呼び出すデリゲートを返します。このアクティビティは、[!INCLUDE[avalon2](../../../../includes/avalon2-md.md)] データ コンテキストおよびスコープ内の `x:Name` 値を含む環境で実行されます。`GenericInvoke` メソッドで、この環境は <xref:System.Activities.Hosting.SymbolResolver> 拡張機能を介してアクティビティに提供されます。この拡張機能は、マークアップ拡張機能のデリゲートが呼び出されるたびに埋め込みアクティビティを呼び出すために使用される <xref:System.Activities.WorkflowInvoker> に追加されます。  
+  
+> [!NOTE]
+>  既定のデザイナーでは ShowWindow アクティビティはサポートされません。したがって、ShowWindow.Xaml ファイルはデザイナーでは正しく表示されません。  
+  
+#### このサンプルを使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] を使用して、WPFWFIntegration.sln ソリューション ファイルを開きます。  
+  
+2.  ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。  
+  
+3.  ソリューションを実行するには、F5 キーを押します。  
+  
+4.  姓と名をダイアログ ボックスに入力します。  
+  
+5.  ダイアログ ボックスを閉じると、コンソールに名前がエコーされます。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、「[.NET Framework 4 向けの Windows Communication Foundation \(WCF\) および Windows Workflow Foundation \(WF\) のサンプル](http://go.microsoft.com/fwlink/?LinkId=150780)」にアクセスして、[!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] および [!INCLUDE[wf1](../../../../includes/wf1-md.md)] のサンプルをすべてダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Scenario\WPFWFIntegration`  
+  
+## 参照
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/samples/xaml-activation.md b/docs/framework/windows-workflow-foundation/samples/xaml-activation.md
new file mode 100644
index 00000000000..2cef9ad2182
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/samples/xaml-activation.md
@@ -0,0 +1,47 @@
+---
+title: "XAML アクティベーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 486760e2-bb10-4ed5-8c02-fe7472498d2d
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# XAML アクティベーション
+このサンプルでは、宣言型ワークフローを IIS でホストする方法を示します。このサンプルは、1 つの操作を持つ、`EchoService` という名前の基本的なワークフローです。  
+  
+> [!IMPORTANT]
+>  サンプルは、既にコンピューターにインストールされている場合があります。続行する前に、次の \(既定の\) ディレクトリを確認してください。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples`  
+>   
+>  このディレクトリが存在しない場合は、ダウンロード ページに移動して、すべての [!INCLUDE[indigo1](../../../../includes/indigo1-md.md)] サンプルおよび [!INCLUDE[wf1](../../../../includes/wf1-md.md)] サンプルをダウンロードしてください。このサンプルは、次のディレクトリに格納されます。  
+>   
+>  `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Services\XAMLActivation`  
+  
+#### サンプルを設定、ビルド、および実行するには  
+  
+1.  [!INCLUDE[vs2010](../../../../includes/vs2010-md.md)] で XAMLActivation.sln ソリューションを開きます。  
+  
+2.  **F5** キーを押して、ソリューションをビルドします。  
+  
+3.  WcfTestClient.exe を実行します。コマンド プロンプトで、次のコマンドを入力します。  
+  
+    1.  cd %SystemDrive%\\Program Files\\Microsoft Visual Studio 10.0\\Common7\\IDE  
+  
+    2.  WcfTestClient.exe を実行します。  
+  
+4.  WcfTestClient.exe でサービスのアドレスを設定します。これを行うには、Ctrl と Shift キーを押しながら A キーを押して、サービス アドレスを http:\/\/localhost:56133\/Service.xamlx に設定します。  
+  
+5.  エコー操作を実行してサービスをテストします。  
+  
+6.  管理特権を使用で、コマンド プロンプトの DeployToIIS.Bat を使用して、IIS でサービスを配置します。  
+  
+7.  クライアントでサービスのアドレスを http:\/\/localhost\/XAMLActivation\/Service.xamlx に更新し、WcfTestClient.exe を使用してサービスを再度テストします。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/security.md b/docs/framework/windows-workflow-foundation/security.md
new file mode 100644
index 00000000000..194ce3c5072
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/security.md
@@ -0,0 +1,29 @@
+---
+title: "セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 737ec121-bfc5-4b75-a504-2d53c2c8af39
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# セキュリティ
+SQL Workflow Instance Store は、次のデータベース セキュリティ ロールを使用して、永続性データベースのインスタンス状態情報へのアクセスをセキュリティ保護します。  
+  
+-   **System.Activities.DurableInstancing.InstanceStoreUsers**。このロールには、パブリック ビューへの読み取りおよび書き込みのアクセス権と、インスタンスの作成、読み込み、保存に関連するストアド プロシージャへの実行権限があります。  
+  
+-   **System.Activities.DurableInstancing.InstanceStoreObservers**。このロールには、パブリック ビューへの読み取り専用アクセス権があります。  
+  
+-   **System.Activities.DurableInstancing.WorkflowActivationUsers**。このロールには、インスタンスのアクティベーション プロセスにかかわるストアド プロシージャへの実行権限があります。インスタンスのアクティベーションの詳細については、「[インスタンスのアクティブ化処理](../../../docs/framework/windows-workflow-foundation//instance-activation.md)」を参照してください。汎用ホスト \([!INCLUDE[dublin](../../../includes/dublin-md.md)] のワークフロー管理サービスなど\) を実行するユーザー アカウントは、このデータベース ロールに追加する必要があります。  
+  
+ [!INCLUDE[crabout](../../../includes/crabout-md.md)] Windows Server App Fabric で永続化ストアのセキュリティは、[「App Fabric の永続ストアのセキュリティ構成」](http://go.microsoft.com/fwlink/?LinkId=201208) を参照してください。  
+  
+> [!CAUTION]
+>  インスタンス ストア内にある固有のインスタンス データへのアクセス権を持つクライアントは、同じインスタンス ストア内にあるその他すべてのインスタンスにもアクセスできます。インスタンス ストアでは、インスタンス レベルでセキュリティ アクセス許可を指定することはできません。個別のインスタンス ストアを作成し、ストアごとに、各グループやユーザーのアクセス権を設定します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/serializing-workflows-and-activities-to-and-from-xaml.md b/docs/framework/windows-workflow-foundation/serializing-workflows-and-activities-to-and-from-xaml.md
new file mode 100644
index 00000000000..cb53547b7b9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/serializing-workflows-and-activities-to-and-from-xaml.md
@@ -0,0 +1,100 @@
+---
+title: "XAML との間のワークフローおよびアクティビティのシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37685b32-24e3-4d72-88d8-45d5fcc49ec2
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# XAML との間のワークフローおよびアクティビティのシリアル化
+ワークフロー定義は、アセンブリに含まれる型にコンパイルされるほか、XAML にシリアル化することもできます。これらのシリアル化された定義は、編集や検査のために再度読み込んだり、コンパイルのためにビルド システムに渡したり、読み込んで呼び出したりすることができます。このトピックでは、ワークフロー定義のシリアル化と XAML ワークフロー定義の使用に関する概要について説明します。  
+  
+## XAML ワークフロー定義の使用  
+ シリアル化するワークフロー定義を作成するには、<xref:System.Activities.ActivityBuilder> クラスを使用します。<xref:System.Activities.ActivityBuilder> の作成は、<xref:System.Activities.DynamicActivity> の作成とほとんど同じです。目的の引数を指定し、動作を構成するアクティビティを構成します。次の例では、2 つの入力引数を受け取り、それらを加算して結果を返す `Add` アクティビティを作成しています。このアクティビティは結果を返すため、ジェネリック <xref:System.Activities.ActivityBuilder%601> クラスが使用されています。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#41](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#41)]  
+  
+ それぞれの <xref:System.Activities.DynamicActivityProperty> インスタンスでワークフローへの入力引数を 1 つずつ表し、<xref:System.Activities.ActivityBuilder.Implementation%2A> にワークフローのロジックを構成するアクティビティが格納されています。この例では、右辺値の式が Visual Basic 式であることに注意してください。<xref:System.Activities.Expressions.ExpressionServices.Convert%2A> を使用しないと、ラムダ式は XAML 形式にシリアル化できません。シリアル化されたワーク フローをワークフロー デザイナーで開くか編集することを目的としている場合は、Visual Basic 式を使用する必要があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md).  
+  
+ XAML への <xref:System.Activities.ActivityBuilder> インスタンスで表されるワークフロー定義を XAML 形式にシリアル化するには、<xref:System.Activities.XamlIntegration.ActivityXamlServices> を使用して <xref:System.Xaml.XamlWriter> を作成した後、その <xref:System.Xaml.XamlWriter> を使用することで、<xref:System.Xaml.XamlServices> を使用してワークフロー定義をシリアル化します。<xref:System.Activities.XamlIntegration.ActivityXamlServices> には、<xref:System.Activities.ActivityBuilder> インスタンスを XAML との間でマッピングしたり、XAML ワークフローを読み込んで、呼び出し可能な <xref:System.Activities.DynamicActivity> を返したりするメソッドがあります。次の例では、前の例の <xref:System.Activities.ActivityBuilder> インスタンスを文字列にシリアル化し、さらにファイルに保存しています。  
+  
+```csharp  
+// Serialize the workflow to XAML and store it in a string.  
+StringBuilder sb = new StringBuilder();  
+StringWriter tw = new StringWriter(sb);  
+XamlWriter xw = ActivityXamlServices.CreateBuilderWriter(new XamlXmlWriter(tw, new XamlSchemaContext()));  
+XamlServices.Save(xw , ab);  
+string serializedAB = sb.ToString();  
+  
+// Display the XAML to the console.  
+Console.WriteLine(serializedAB);  
+  
+// Serialize the workflow to XAML and save it to a file.  
+StreamWriter sw = File.CreateText(@"C:\Workflows\add.xaml");  
+XamlWriter xw2 = ActivityXamlServices.CreateBuilderWriter(new XamlXmlWriter(sw, new XamlSchemaContext()));  
+XamlServices.Save(xw2, ab);  
+sw.Close();  
+  
+```  
+  
+ シリアル化されたワークフローの例を次に示します。  
+  
+```xaml  
+<Activity   
+  x:TypeArguments="x:Int32"   
+  x:Class="Add"   
+  xmlns="http://schemas.microsoft.com/netfx/2009/xaml/activities"   
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">  
+  <x:Members>  
+    <x:Property Name="Operand1" Type="InArgument(x:Int32)" />  
+    <x:Property Name="Operand2" Type="InArgument(x:Int32)" />  
+  </x:Members>  
+  <Sequence>  
+    <WriteLine Text="[Operand1.ToString() + " + " + Operand2.ToString()]" />  
+    <Assign x:TypeArguments="x:Int32" Value="[Operand1 + Operand2]">  
+      <Assign.To>  
+        <OutArgument x:TypeArguments="x:Int32">  
+          <ArgumentReference x:TypeArguments="x:Int32" ArgumentName="Result" />  
+          </OutArgument>  
+      </Assign.To>  
+    </Assign>  
+  </Sequence>  
+</Activity>  
+```  
+  
+ シリアル化されたワークフローを読み込むには、<xref:System.Activities.XamlIntegration.ActivityXamlServices> <xref:System.Activities.XamlIntegration.ActivityXamlServices.Load%2A> メソッドを使用します。このメソッドは、シリアル化されたワークフロー定義を受け取り、ワークフロー定義を表す <xref:System.Activities.DynamicActivity> を返します。検証プロセス中に <xref:System.Activities.DynamicActivity> の本体で <xref:System.Activities.Activity.CacheMetadata%2A> が呼び出されるまでは、XAML は逆シリアル化されないことに注意してください。検証が明示的に呼び出されない場合は、ワークフローが呼び出されたときに実行されます。XAML ワークフロー定義が無効な場合、<xref:System.Argument> 例外がスローされます。<xref:System.Activities.Activity.CacheMetadata%2A> からスローされる例外は、<xref:System.Activities.Validation.ActivityValidationServices.Validate%2A> への呼び出しからエスケープされ、呼び出し元によって処理される必要があります。次の例では、前の例のシリアル化されたワークフローを読み込み、<xref:System.Activities.WorkflowInvoker> を使用して呼び出しています。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#43](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#43)]  
+  
+ このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **25 \+ 15**   
+**40**    
+> [!NOTE]
+>  入力引数および出力引数を指定してワークフローを呼び出す方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[WorkflowInvoker と WorkflowApplication の使用](../../../docs/framework/windows-workflow-foundation//using-workflowinvoker-and-workflowapplication.md)」および「<xref:System.Activities.WorkflowInvoker.Invoke%2A>」を参照してください。  
+  
+ シリアル化されたワークフローに C\# 式が含まれている場合、<xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings.CompileExpressions%2A> プロパティが `true` に設定されている <xref:System.Activities.XamlIntegration.ActivityXamlServicesSettings> インスタンスは、パラメーターとして <xref:System.Activities.XamlIntegration.ActivityXamlServices.Load%2A?displayProperty=fullName> に渡す必要があります。そうしないと、<xref:System.NotSupportedException> がスローされ、"`Expression Activity type 'CSharpValue`1' requires compilation in order to run.  Please ensure that the workflow has been compiled.`" のようなメッセージが表示されます。  
+  
+```csharp  
+ActivityXamlServicesSettings settings = new ActivityXamlServicesSettings  
+{  
+    CompileExpressions = true  
+};  
+  
+DynamicActivity<int> wf = ActivityXamlServices.Load(new StringReader(serializedAB), settings) as DynamicActivity<int>;  
+  
+```  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] [C\# の式](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md).  
+  
+ シリアル化されたワークフロー定義は、<xref:System.Activities.XamlIntegration.ActivityXamlServices> <xref:System.Activities.XamlIntegration.ActivityXamlServices.CreateBuilderReader%2A> メソッドを使用して <xref:System.Activities.ActivityBuilder> インスタンスに読み込むこともできます。シリアル化されたワークフローを <xref:System.Activities.ActivityBuilder> インスタンスに読み込むと、検査や変更が可能になります。これにより、デザイン プロセス中にワークフロー定義を保存したり再度読み込んだりするためのメカニズムが提供され、カスタム ワークフロー デザイナーを作成するときに役立ちます。次の例では、前の例のシリアル化されたワークフロー定義を読み込み、そのプロパティを検査しています。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#44](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#44)]
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/sql-server-persistence-database.md b/docs/framework/windows-workflow-foundation/sql-server-persistence-database.md
new file mode 100644
index 00000000000..6ed372ac7bc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/sql-server-persistence-database.md
@@ -0,0 +1,29 @@
+---
+title: "SQL Server 永続性データベース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4e594eec-2a31-4d49-ad31-aca2ecbb1f69
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# SQL Server 永続性データベース
+このセクションでは、SQL Workflow Instance Store でサポートされるパブリック データベース ビューの詳細について説明し、インスタンスのプリミティブ データ プロパティを逆シリアル化する方法と非永続的インスタンスに対してクエリを実行する方法を示します。  
+  
+## このセクションの内容  
+  
+-   [永続性データベース スキーマ](../../../docs/framework/windows-workflow-foundation//persistence-database-schema.md)  
+  
+-   [方法: インスタンス データ プロパティを逆シリアル化する](../../../docs/framework/windows-workflow-foundation//how-to-deserialize-instance-data-properties.md)  
+  
+-   [方法: 非永続的インスタンスを検索する](../../../docs/framework/windows-workflow-foundation//how-to-query-for-non-persisted-instances.md)  
+  
+## 参照  
+ [App Fabric SQL Server 永続性データベース](http://go.microsoft.com/fwlink/?LinkID=201202&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/sql-workflow-instance-store.md b/docs/framework/windows-workflow-foundation/sql-workflow-instance-store.md
new file mode 100644
index 00000000000..f778ae3231d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/sql-workflow-instance-store.md
@@ -0,0 +1,45 @@
+---
+title: "SQL Workflow Instance Store | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8cd2f8a5-4bf8-46ea-8909-c7fdb314fabc
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# SQL Workflow Instance Store
+[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] には SQL Workflow Instance Store が含まれます。これを使用すると、ワークフロー インスタンスに関する状態情報を SQL Server 2005 または SQL Server 2008 のデータベースに永続化できます。この機能は主に <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> クラスの形式で実装されます。このクラスは永続化フレームワークの <xref:System.Runtime.Persistence.InstanceStore> 抽象クラスから派生します。SQL Workflow Instance Store 機能によって SQL 永続性プロバイダーを構成します。このプロバイダーは、ホストが永続化コマンドをストアに送信するときに使用する永続化 API の具象実装です。  
+  
+ SQL Workflow Instance Store は、セルフホストされているワークフローや、<xref:System.Activities.WorkflowApplication> または <xref:System.ServiceModel.WorkflowServiceHost> を使用するワークフロー サービスだけでなく、<xref:System.ServiceModel.WorkflowServiceHost> を使用して WAS でホストされるサービスをサポートします。セルフホストされているサービスの SQL Workflow Instance Store 機能をプログラムで構成するには、この機能が公開しているオブジェクト モデルを使用します。プログラムでオブジェクト モデルや XML 構成ファイルを使用することにより、<xref:System.ServiceModel.WorkflowServiceHost> でホストされるサービスについてこの機能を構成できます。  
+  
+ SQL Workflow Instance Store 機能 \(**SqlWorkflowInstanceStore** クラス\) は <xref:System.ServiceModel.Persistence.PersistenceProviderFactory> を実装していないため、ワークフロー以外の継続的な WCF サービスをサポートする永続化は提供しません。また、<xref:System.Workflow.Runtime.Hosting.WorkflowPersistenceService> を実装していないため、3.x ワークフローの永続化は提供しません。この機能は、WF 4.0 \(以降\) のワークフローとワークフロー サービスについてのみ永続化をサポートします。また、SQL Server 2005 と SQL Server 2008 以外のデータベースはサポートしません。  
+  
+ このセクションのトピックでは、SQL Workflow Instance Store のプロパティと機能、およびストアの構成方法の詳細を説明します。  
+  
+ Windows Server App Fabric は、インスタンス ストアの構成と使用を単純化する独自のインスタンス ストアとツールを提供します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)] 「[Windows Server App Fabric Instance Store](http://go.microsoft.com/fwlink/?LinkId=201201)」を参照してください。App Fabric SQL Server 永続化データベース[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[App Fabric SQL Server 永続化データベース](http://go.microsoft.com/fwlink/?LinkId=201202)」を参照してください。  
+  
+## このセクションの内容  
+  
+-   [SQL Workflow Instance Store のプロパティ](../../../docs/framework/windows-workflow-foundation//properties-of-sql-workflow-instance-store.md)  
+  
+-   [ワークフローとワークフロー サービスの SQL 永続性を有効にする方法](../../../docs/framework/windows-workflow-foundation//how-to-enable-sql-persistence-for-workflows-and-workflow-services.md)  
+  
+-   [インスタンスのアクティブ化処理](../../../docs/framework/windows-workflow-foundation//instance-activation.md)  
+  
+-   [クエリのサポート](../../../docs/framework/windows-workflow-foundation//support-for-queries.md)  
+  
+-   [ストア拡張](../../../docs/framework/windows-workflow-foundation//store-extensibility.md)  
+  
+-   [セキュリティ](../../../docs/framework/windows-workflow-foundation//security.md)  
+  
+-   [SQL Server 永続性データベース](../../../docs/framework/windows-workflow-foundation//sql-server-persistence-database.md)  
+  
+## 参照  
+ [永続化のサンプル](http://go.microsoft.com/fwlink/?LinkID=177735)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/state-machine-activities-in-wf.md b/docs/framework/windows-workflow-foundation/state-machine-activities-in-wf.md
new file mode 100644
index 00000000000..b0b2e4fe4e8
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/state-machine-activities-in-wf.md
@@ -0,0 +1,28 @@
+---
+title: "WF のステート マシン アクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 93312eaf-07e0-4a55-b4f7-4cdbbc4dee2d
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# WF のステート マシン アクティビティ
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、ステート マシン ワーク フローを作成するために、システム指定のいくつかのアクティビティおよびアクティビティ デザイナーを提供します。  
+  
+|||  
+|-|-|  
+|<xref:System.Activities.Statements.StateMachine>|使い慣れたステート マシン パラダイムを使用して、含まれているアクティビティを実行します。|  
+|<xref:System.Activities.Statements.State>|ステート マシンの状態を表します。|  
+|<xref:System.Activities.Core.Presentation.FinalState>|ステート マシンの最終状態を表します。<xref:System.Activities.Core.Presentation.FinalState> は、使用すると、最終状態として事前に構成済みの <xref:System.Activities.Statements.State> を作成するアクティビティ デザイナーです。詳細については、「[FinalState アクティビティ デザイナー](../Topic/FinalState%20Activity%20Designer.md)」を参照してください。|  
+|<xref:System.Activities.Statements.Transition>|2 つの状態間の遷移を表します。<xref:System.Activities.Statements.Transition> の**ツールボックス** の項目はありません。移行は、ワーク フロー デザイナーで、2 つの状態の間で行をドラッグ アンド ドロップするか、または 1 つの状態を別の状態の上に配置したときに表示される三角形の上に状態をドロップして作成されます。詳細については、「[Transition アクティビティ デザイナー](../Topic/Transition%20Activity%20Designer.md)」を参照してください。|  
+  
+## 参照  
+ [チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/state-machine-workflows.md b/docs/framework/windows-workflow-foundation/state-machine-workflows.md
new file mode 100644
index 00000000000..fc20cdccdff
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/state-machine-workflows.md
@@ -0,0 +1,113 @@
+---
+title: "ステート マシン ワークフロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 344caacd-bf3b-4716-bd5a-eca74fc5a61d
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# ステート マシン ワークフロー
+ステート マシンは、プログラムを開発するための既知のパラダイムです。<xref:System.Activities.Statements.StateMachine> アクティビティは、<xref:System.Activities.Statements.State>、<xref:System.Activities.Statements.Transition> および他のアクティビティと共に、ステート マシン ワークフロー プログラムのビルドに使用できます。このトピックでは、ステート マシン ワークフローの概要について説明します。  
+  
+## ステート マシン ワークフローの概要  
+ ステート マシン ワークフローは、イベント ドリブンの方法でワークフローをモデル化できるモデル化スタイルを提供します。<xref:System.Activities.Statements.StateMachine> アクティビティには、ステート マシンのロジックを構成し、アクティビティが使用される任意の場所で使用できる、状態および遷移が含まれます。ステート マシン ランタイムにはいくつかのクラスがあります:  
+  
+-   <xref:System.Activities.Statements.StateMachine>  
+  
+-   <xref:System.Activities.Statements.State>  
+  
+-   <xref:System.Activities.Statements.Transition>  
+  
+ ステート マシン ワークフローを作成するため、状態が <xref:System.Activities.Statements.StateMachine> アクティビティに追加され、遷移は状態間のフローのコントロールに使用されます。次のスクリーンショットには、[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md) の手順 [方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md) から、 3 つの状態と 3 つの遷移を持つステート マシン ワークフローが示されます。**\[ターゲットの初期化\]** が初期状態で、ワークフローの最初の状態を表します。これは **\[開始\]** ノードから伸びる線によって示されます。ワークフローの最終状態は **\[FinalState\]** と呼ばれ、ワークフローが完了する点を表します。  
+  
+ ![完成したステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wfstatemachinegettingstartedtutorialcomplete.JPG "WFStateMachineGettingStartedTutorialComplete")  
+  
+ ステート マシン ワークフローには 1 つのみの初期状態および少なくとも 1 つの最終状態が必要です。最終状態ではない各状態には少なくとも 1 個以上の移行が必要です。次のセクションでは状態および遷移の作成および構成について説明します。  
+  
+## 状態の作成および構成  
+ <xref:System.Activities.Statements.State> はステート マシンの状態を表します。ワークフローに <xref:System.Activities.Statements.State> を追加するには、**\[ツールボックス\]** の **\[ステート マシン\]** セクションから **\[State\]** アクティビティをドラッグし、[!INCLUDE[wfd1](../../../includes/wfd1-md.md)] 画面上の <xref:System.Activities.Statements.StateMachine> アクティビティ上にドロップします。  
+  
+ ![WF4 ステート マシン アクティビティ](../../../docs/framework/windows-workflow-foundation//media/netframework4platformupdate1statemachineactivities.jpg "NETFramework4PlatformUpdate1StateMachineActivities")  
+  
+ に **\[初期状態\]**として状態を構成するには、状態を右クリックして **\[初期状態として設定\]** を選択します。さらに、現在の初期状態がない場合、初期状態はワーク フローの上の **\[開始\]** ノードから目的の状態まで線をドラッグして指定できます。<xref:System.Activities.Statements.StateMachine> のアクティビティがワークフロー デザイナーにドロップされると、**\[State1\]** という名前の初期状態が事前に構成されます。ステート マシン ワークフローには 1 つのみの初期状態が必要です。  
+  
+ ステート マシンを終了させる状態を表す状態は、最終状態と呼ばれます。最終状態とは、`true` に設定された <xref:System.Activities.Statements.State.IsFinal%2A> のプロパティを持ち、<xref:System.Activities.Statements.State.Exit%2A> のアクティビティは持たず、そこから発生する遷移がない状態です。ワークフローに最終状態を追加するには、**\[FinalState\]** のアクティビティ デザイナーを **\[ツールボックス\]** の **\[ステート マシン\]** セクションからドラッグし、それを [!INCLUDE[wfd1](../../../includes/wfd1-md.md)] 画面の <xref:System.Activities.Statements.StateMachine> のアクティビティ上にドロップします。ステート マシン ワークフローには少なくとも 1 つの最終ステートが必要です。  
+  
+### エントリおよび終了操作の構成  
+ 状態は、<xref:System.Activities.Statements.State.Entry%2A> アクションおよび <xref:System.Activities.Statements.State.Exit%2A> アクションを持つことができます。\(最終状態として構成されている状態は 1 つのみのエントリ アクションを持つことができます\)。ワークフロー インスタンスが状態に入ると、エントリ アクションのあらゆるアクティビティが実行されます。エントリ アクションが完了すると、状態の遷移のトリガーがスケジュールされます。別のステートへの遷移が確認されると、状態遷移が同じ状態に戻ったとしても、終了アクションのアクティビティが実行されます。終了のアクションが完了すると、遷移のアクションのアクティビティが実行され、その新しい状態が遷移され、エントリ アクションがスケジュールされます。  
+  
+> [!NOTE]
+>  ステート マシン ワークフローをデバッグする場合、ブレークポイントは、ステート マシン ワークフロー内のルート ステート マシンのアクティビティおよび状態の上に配置できます。ブレークポイントは繊維の上に血肉節配置されず、状態及び遷移内の任意のアクティビティ上に配置される場合があります。  
+  
+## 遷移の作成および構成  
+ すべての状態には少なくとも 1 つの遷移が必要です。例外は遷移を持たないかもしれない最終状態です。遷移は、状態マシン ワークフローに状態が追加される後に追加される、または状態がドロップされた時に作成される場合があります。  
+  
+ 1 つの手順で <xref:System.Activities.Statements.State> を追加して遷移を作成するには、**\[ツールボックス\]** の **\[ステート マシン\]** から **\[状態\]** のアクティビティをドラッグしてワークフロー デザイナー内の他の状態の上に置きます。ドラッグされている <xref:System.Activities.Statements.State> が別の <xref:System.Activities.Statements.State> の上にある場合、もう一方の <xref:System.Activities.Statements.State> の周囲に 4 つの三角形が表示されます。<xref:System.Activities.Statements.State> が 4 個の三角形のいずれかの上にドロップされる場合、それはステート マシンに追加され、ソース <xref:System.Activities.Statements.State> からドロップされた目的の <xref:System.Activities.Statements.State> への遷移が作成されます。詳細については、「[Transition アクティビティ デザイナー](../Topic/Transition%20Activity%20Designer.md)」を参照してください。  
+  
+ 状態の追加後に遷移を作成するには、2 つのオプションがあります。最初のオプションは、ワークフロー デザイナー画面から状態をドラッグして既存の状態の上に置き、ドロップ ポイントのいずれかにドロップすることです。これは、前のセクションで説明したメソッドに非常に似ています。また、マウス ポインターを目的のソースの状態の上に置き、線を適切な目的の状態にドラッグすることもできます。  
+  
+> [!NOTE]
+>  ステート マシンの単一の状態はワーク フロー デザイナーを使用して作成された最大 76 の遷移を持つことができます。デザイナーを使用せずに作成されるワーク フローの状態の遷移制限は、システム リソースによってのみ制限されます。  
+  
+ 遷移は <xref:System.Activities.Statements.Transition.Trigger%2A>、<xref:System.Activities.Statements.Transition.Condition%2A>、および <xref:System.Activities.Statements.Transition.Action%2A> を持つ場合があります。移行の <xref:System.Activities.Statements.Transition.Trigger%2A> は遷移のソース状態のアクションの <xref:System.Activities.Statements.State.Entry%2A> アクションが完了する時にスケジュールされます。通常 <xref:System.Activities.Statements.Transition.Trigger%2A> は、ある種のイベント発生を待つアクティビティですが、任意のアクティビティまたはアクティビティがなくてもかまいません。<xref:System.Activities.Statements.Transition.Trigger%2A> のアクティビティが完了したら、<xref:System.Activities.Statements.Transition.Condition%2A> がある場合は評価されます。<xref:System.Activities.Statements.Transition.Trigger%2A> のアクティビティがない場合、<xref:System.Activities.Statements.Transition.Condition%2A> は直ちに評価されます。条件が `false` になる場合、遷移はキャンセルされ、その状態からのすべての遷移の <xref:System.Activities.Statements.Transition.Trigger%2A> アクティビティは再スケジュールされます。現在の遷移と同じソースの状態を共有する他の遷移がある場合、<xref:System.Activities.Statements.Transition.Trigger%2A> のアクションもキャンセルされて、再スケジュールされます。<xref:System.Activities.Statements.Transition.Condition%2A> が `true` である場合、または条件がない場合、ソース状態の <xref:System.Activities.Statements.State.Exit%2A> のアクションが実行され、遷移の <xref:System.Activities.Statements.Transition.Action%2A> が実行されます。<xref:System.Activities.Statements.Transition.Action%2A> が完了すると、コントロールは **\[ターゲット\]** 状態を渡します  
+  
+ 共通トリガーを共有する遷移は、共有トリガー遷移として知られます。共有トリガー遷移グループの各遷移には同じトリガーがありますが、<xref:System.Activities.Statements.Transition.Condition%2A> およびアクションは一意です。遷移に追加のアクションを追加し、共有遷移を作成するには、目的の遷移の開始点を表す円をクリックし、目的の状態にドラッグします。新しい遷移は最初の遷移と同じトリガーを共有しますが、一意の条件とアクションがあります。共有遷移は、Transition デザイナー内から Transition デザイナーの下部にある **\[共有されるトリガーの遷移の追加\]** をクリックし、**\[接続の使用可能な状態\]** ボックスから目的のターゲットの状態を選択することでも作成できます。  
+  
+> [!NOTE]
+>  遷移の <xref:System.Activities.Statements.Transition.Condition%2A> が `False` と評価された場合 \(または共有トリガー遷移のすべての状態が `False` と評価された場合\)、遷移は発生せず、その状態からのすべての遷移のすべてのトリガーは再スケジュールされます。  
+  
+ ステート マシン ワークフロー作成方法の詳細については、「[方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md)」、「[StateMachine アクティビティ デザイナー](../Topic/StateMachine%20Activity%20Designer.md)」、「[State アクティビティ デザイナー](../Topic/State%20Activity%20Designer.md)」、「[FinalState アクティビティ デザイナー](../Topic/FinalState%20Activity%20Designer.md)」、および「[Transition アクティビティ デザイナー](../Topic/Transition%20Activity%20Designer.md)」を参照してください。  
+  
+## ステート マシン用語  
+ このセクションでは、このトピック全体で使用されるステート マシンの表現形式を定義します。  
+  
+ State  
+ ステート マシンを構成する基本単位。ステート マシンは任意の特定の時刻に 1 つの状態になれます。  
+  
+ エントリ アクション  
+ 状態に入るときに実行されるアクティビティ  
+  
+ 終了アクション  
+ 状態を終了するときに実行されるアクティビティ  
+  
+ 遷移  
+ 2 つの状態間の直接の関係で、特定の種類のイベントの生成に対するステート マシンの完全な応答を表します。  
+  
+ 共有遷移  
+ 1 つまたはそれ以上の遷移を持つソースの状態やトリガーを共有するトランザクションですが、一意の条件とアクションを持ちます。  
+  
+ トリガー  
+ 遷移を発生させるトリガー アクティビティです。  
+  
+ 条件  
+ 完了する遷移のためにトリガーを発生した後に `true` となる必要がある制約。  
+  
+ 遷移アクション  
+ 特定の遷移を実行する時に実行されるアクティビティです。  
+  
+ 条件付き遷移  
+ 明示的な条件付きの移行です。  
+  
+ 自己遷移  
+ 状態から自分自身に遷移する遷移です。  
+  
+ 初期状態  
+ ステート マシンの開始点を示す状態です。  
+  
+ 最終状態  
+ ステート マシンの完了を示す状態です。  
+  
+## 参照  
+ [方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md)   
+ [StateMachine アクティビティ デザイナー](../Topic/StateMachine%20Activity%20Designer.md)   
+ [State アクティビティ デザイナー](../Topic/State%20Activity%20Designer.md)   
+ [FinalState アクティビティ デザイナー](../Topic/FinalState%20Activity%20Designer.md)   
+ [Transition アクティビティ デザイナー](../Topic/Transition%20Activity%20Designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/store-extensibility.md b/docs/framework/windows-workflow-foundation/store-extensibility.md
new file mode 100644
index 00000000000..3f77960216f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/store-extensibility.md
@@ -0,0 +1,132 @@
+---
+title: "ストア拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7c3f4a46-4bac-4138-ae6a-a7c7ee0d28f5
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# ストア拡張
+<xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用して、永続性データベースのインスタンスをクエリする場合に使用できるカスタムのアプリケーション固有のプロパティを昇格できます。プロパティを昇格することで、データベース内の特殊なビュー内で値が使用できるようになります。これらの昇格したプロパティ \(ユーザー クエリで使用できるプロパティ\) は、単純型 \(Int64、Guid、String、DateTime など\) またはシリアル化されたバイナリ型 \(byte\[\]\) になる場合があります。  
+  
+ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> クラスには <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore.Promote%2A> メソッドがあり、クエリで使用できるプロパティとしてプロパティを昇格するために使用できます。次の例は、ストア拡張のエンド ツー エンドの例です。  
+  
+1.  この例のシナリオでは、ドキュメント処理 \(DP\) アプリケーションにワークフローがあり、それぞれがドキュメント処理にカスタム アクティビティを使用しています。これらのワークフローは、エンド ユーザーから見える必要がある一連の状態変数を備えています。これを実現するために、DP アプリケーションには <xref:System.Activities.Persistence.PersistenceParticipant> 型を持つインスタンス拡張機能があり、状態変数を提供するアクティビティによって使用されます。  
+  
+    ```  
+  
+    class DocumentStatusExtension : PersistenceParticipant  
+    {  
+        public string DocumentId;  
+        public string ApprovalStatus;  
+        public string UserName;  
+        public DateTime LastUpdateTime;  
+    }  
+  
+    ```  
+  
+2.  次に、新しい機能拡張がホストに追加されます。  
+  
+    ```  
+    static Activity workflow = CreateWorkflow();  
+    WorkflowApplication application = new WorkflowApplication(workflow);  
+    DocumentStatusExtension documentStatusExtension = new DocumentStatusExtension ();  
+    application.Extensions.Add(documentStatusExtension);  
+  
+    ```  
+  
+     カスタムの永続参加要素の追加の詳細については、「[永続参加要素](../../../docs/framework/windows-workflow-foundation//persistence-participants.md)」のサンプルを参照してください。  
+  
+3.  DP アプリケーションのカスタム アクティビティでは、**Execute** メソッドでさまざまな状態フィールドを設定します。  
+  
+    ```  
+  
+    public override void Execute(CodeActivityContext context)  
+    {  
+        // ...  
+        context.GetExtension<DocumentStatusExtension>().DocumentId = Guid.NewGuid();  
+        context.GetExtension<DocumentStatusExtension>().UserName = "John Smith";  
+        context.GetExtension<DocumentStatusExtension>().ApprovalStatus = “Approved”;  
+        context.GetExtension<DocumentStatusExtension>().LastUpdateTime = DateTime.Now();  
+        // ...  
+    }  
+  
+    ```  
+  
+4.  ワークフロー インスタンスが永続性ポイントに達すると、**DocumentStatusExtension** 永続参加要素の **CollectValues** メソッドによって、これらのプロパティが永続性データ コレクションに保存されます。  
+  
+    ```  
+  
+    class DocumentStatusExtension : PersistenceParticipant  
+    {  
+        const XNamespace xNS = XNamespace.Get("http://contoso.com/DocumentStatus");  
+  
+        protected override void CollectValues(out IDictionary<XName, object> readWriteValues, out IDictionary<XName, object> writeOnlyValues)  
+        {  
+            readWriteValues = new Dictionary<XName, object>();  
+            readWriteValues.Add(xNS.GetName("UserName"), this.UserName);  
+            readWriteValues.Add(xNS.GetName("ApprovalStatus"), this.ApprovalStatus);  
+            readWriteValues.Add(xNS.GetName("DocumentId"), this.DocumentId);  
+            readWriteValues.Add(xNS.GetName("LastModifiedTime"), this.LastUpdateTime);  
+  
+            writeOnlyValues = null;  
+        }  
+        // ...  
+    }  
+  
+    ```  
+  
+    > [!NOTE]
+    >  これらすべてのプロパティは、**SaveWorkflowCommand.InstanceData** コレクションを介して、永続化フレームワークによって **SqlWorkflowInstanceStore** に渡されます。  
+  
+5.  DP アプリケーションは SQL Workflow Instance Store を初期化し、**Promote** メソッドを呼び出してこのデータを昇格します。  
+  
+    ```  
+    SqlWorkflowInstanceStore store = new SqlWorkflowInstanceStore(connectionString);  
+  
+    List<XName> variantProperties = new List<XName>()   
+    {   
+        xNS.GetName("UserName"),   
+        xNS.GetName("ApprovalStatus"),   
+        xNS.GetName("DocumentId"),   
+        xNS.GetName("LastModifiedTime")   
+    };  
+  
+    store.Promote("DocumentStatus", variantProperties, null);  
+    ```  
+  
+     この昇格情報に基づいて、**SqlWorkflowInstanceStore** は、[[System.Activities.DurableInstancing.InstancePromotedProperties] ビュー](../Topic/Store%20Extensibility.md#InstancePromotedProperties) の列にデータ プロパティを設定します。  
+  
+6.  昇格テーブルのデータのサブセットを照会するために、DP アプリケーションによって昇格ビューの上にカスタマイズされたビューが追加されます。  
+  
+    ```  
+  
+    create view [dbo].[DocumentStatus] with schemabinding  
+    as  
+        select  P.[InstanceId] as [InstanceId],  
+            P.Value1 as [UserName],  
+            P.Value2 as [ApprovalStatus],  
+            P.Value3 as [DocumentId],  
+            P.Value4 as [LastUpdatedTime]  
+    from [System.Activities.DurableInstancing].[InstancePromotedProperties] as P  
+    where P.PromotionName = N'DocumentStatus'  
+    go  
+  
+    ```  
+  
+##  <a name="InstancePromotedProperties"></a> \[System.Activities.DurableInstancing.InstancePromotedProperties\] ビュー  
+  
+|列名|列の型|説明|  
+|--------|---------|--------|  
+|InstanceId|GUID|この昇格が属するワークフロー インスタンス。|  
+|PromotionName|nvarchar\(400\)|昇格自体の名前。|  
+|Value1、Value2、Value3、…Value32|sql\_variant|昇格したプロパティ自体の値。ほとんどの SQL プリミティブ データ型はバイナリ ブロブを除外し、長さが 8,000 バイトを超える文字列は sql\_variant に合わせて短縮されます。|  
+|Value33、Value34、Value35、…、Value64|varbinary\(max\)|varbinary\(max\) として明示的に宣言される昇格したプロパティの値。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/support-for-queries.md b/docs/framework/windows-workflow-foundation/support-for-queries.md
new file mode 100644
index 00000000000..6b14aff76fc
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/support-for-queries.md
@@ -0,0 +1,107 @@
+---
+title: "クエリのサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 093c22f5-3294-4642-857a-5252233d6796
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# クエリのサポート
+SQL Workflow Instance Store は、一連の既知のプロパティをストアに記録します。ユーザーは、これらのプロパティに基づいてインスタンスのクエリを実行できます。これらの既知のプロパティの一部を次の一覧に示します。  
+  
+-   **サイト名:** サービスが存在する Web サイトの名前。  
+  
+-   **相対アプリケーション パス:** Web サイトを基準としたアプリケーションの相対パス。  
+  
+-   **相対サービス パス:** アプリケーションを基準としたサービスの相対パス。  
+  
+-   **サービス名:** サービスの名前。  
+  
+-   **サービスの名前空間:** サービスが使用する名前空間の名称。  
+  
+-   **現在のコンピューター:**  
+  
+-   **最後のコンピューター:** ワークフロー サービスのインスタンスが最後に実行されたコンピューター。  
+  
+> [!NOTE]
+>  ワークフロー サービス ホストを使用する自己ホスト型のシナリオでは、最後の 4 つのプロパティにのみ値が指定されます。ワークフロー アプリケーション シナリオでは、最後のプロパティにのみ値が指定されます。  
+  
+ ワークフロー ランタイムは、最初の 3 つのプロパティの値を指定します。ワークフロー サービス ホストは、**中断の理由**プロパティの値を指定します。SQL Workflow Instance Store 自体は、**最後に更新されたコンピューター** プロパティの値を指定します。  
+  
+ また、SQL Workflow Instance Store の機能により、永続性データベースで値を格納したり、クエリで使用したりするカスタム プロパティを指定することができます。カスタムの昇格の詳細については、「[ストア拡張](../../../docs/framework/windows-workflow-foundation//store-extensibility.md)」を参照してください。  
+  
+## ビュー  
+ インスタンス ストアには、次のビューがあります。詳細については、「[永続性データベース スキーマ](../../../docs/framework/windows-workflow-foundation//persistence-database-schema.md)」を参照してください。  
+  
+### Instances ビュー  
+ Instances ビューには、次のフィールドがあります。  
+  
+1.  **Id**  
+  
+2.  **PendingTimer**  
+  
+3.  **CreationTime**  
+  
+4.  **LastUpdatedTime**  
+  
+5.  **ServiceDeploymentId**  
+  
+6.  **SuspensionExceptionName**  
+  
+7.  **SuspensionReason**  
+  
+8.  **ActiveBookmarks**  
+  
+9. **CurrentMachine**  
+  
+10. **LastMachine**  
+  
+11. **ExecutionStatus**  
+  
+12. **IsInitialized**  
+  
+13. **IsSuspended**  
+  
+14. **IsCompleted**  
+  
+15. **EncodingOption**  
+  
+16. **ReadWritePrimitiveDataProperties**  
+  
+17. **WriteOnlyPrimitiveDataProperties**  
+  
+18. **ReadWriteComplexDataProperties**  
+  
+19. **WriteOnlyComplexDataProperties**  
+  
+### ServiceDeployments ビュー  
+ ServiceDeployments ビューには、次のフィールドがあります。  
+  
+1.  **SiteName**  
+  
+2.  **RelativeServicePath**  
+  
+3.  **RelativeApplicationPath**  
+  
+4.  **ServiceName**  
+  
+5.  **ServiceNamespace**  
+  
+### InstancePromotedProperties ビュー  
+ InstancePromotedProperties ビューには、次のフィールドがあります。昇格されたプロパティの詳細については、「[ストア拡張](../../../docs/framework/windows-workflow-foundation//store-extensibility.md)」を参照してください。  
+  
+1.  **InstanceId**  
+  
+2.  **EncodingOption**  
+  
+3.  **PromotionName**  
+  
+4.  **Value\#** \(**Value1** から **Value64** までのフィールド範囲\)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/task-1-create-a-new-wpf-app.md b/docs/framework/windows-workflow-foundation/task-1-create-a-new-wpf-app.md
new file mode 100644
index 00000000000..75dbbed3bd9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/task-1-create-a-new-wpf-app.md
@@ -0,0 +1,52 @@
+---
+title: "タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 270eaeba-9492-4532-af9f-403ce5c9935b
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成
+このタスクでは、WPF Application Visual Studio テンプレートを使用することによって、空の [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] アプリケーションを作成し、適切な [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフロー アセンブリに参照を追加します。  
+  
+### WPF アプリケーション プロジェクトを作成するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] を開き、**\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスの左側にある **\[インストールされているテンプレート\]** ペインで、**\[Visual C\#\]** または **\[Visual Basic\]** を選択します。選択した言語が表示されない場合は、**\[他の言語\]** で探します。  
+  
+3.  **\[インストールされているテンプレート\]** ペインの **\[Windows\]** を選択します。  
+  
+4.  上部ペインにあるドロップダウン リスト ボックスで、既定値の **\[.NET Framework 4\]** が選択されていることを確認し、**\[WPF アプリケーション\]** を選択します。  
+  
+5.  ウィンドウの下部でプロジェクトの名前を **HostingApplication** に設定します。  
+  
+6.  ソリューションの名前を **RehostingTheDesigner** に設定します。  
+  
+7.  **\[OK\]** をクリックすると、アプリケーション プロジェクトが作成されます。[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] によって、使用するアプリケーション用の基本的な WPF UI が作成され、適切な XAML と分離コード ファイルが含まれます。  
+  
+8.  **WorkflowModel** アセンブリへの参照を追加します。この場合、**ソリューション エクスプローラー**で **HostingApplication** プロジェクトを右クリックし、**\[参照の追加\]** をクリックします。  
+  
+9. **\[参照の追加\]** ダイアログ ボックスで、**\[.NET\]** タブをクリックし、Ctrl キーを押しながら次のアセンブリを選択して、**\[OK\]** をクリックします。  
+  
+    -   System.Activities  
+  
+    -   System.Activities.Presentation  
+  
+    -   System.Activities.Core.Presentation  
+  
+10. **\[OK\]** をクリックします。  
+  
+11. ワークフロー デザイナーのデザイン キャンバスをホストする方法については、「[タスク 2: ワークフロー デザイナーのホスティング](../../../docs/framework/windows-workflow-foundation//task-2-host-the-workflow-designer.md)」を参照してください。  
+  
+## 参照  
+ [ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)   
+ [タスク 2: ワークフロー デザイナーのホスティング](../../../docs/framework/windows-workflow-foundation//task-2-host-the-workflow-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/task-2-host-the-workflow-designer.md b/docs/framework/windows-workflow-foundation/task-2-host-the-workflow-designer.md
new file mode 100644
index 00000000000..8484b35bb90
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/task-2-host-the-workflow-designer.md
@@ -0,0 +1,143 @@
+---
+title: "タスク 2: ワークフロー デザイナーのホスティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0a29b138-270d-4846-b78e-2b875e34e501
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# タスク 2: ワークフロー デザイナーのホスティング
+このトピックでは、[!INCLUDE[avalon1](../../../includes/avalon1-md.md)] アプリケーションで [!INCLUDE[wfd1](../../../includes/wfd1-md.md)]のインスタンスをホストする手順について説明します。  
+  
+ この手順では、デザイナーを格納する **Grid** コントロールを構成し、既定の <xref:System.Activities.Statements.Sequence> アクティビティを含む <xref:System.Activities.Presentation.WorkflowDesigner> のインスタンスをプログラムで作成します。さらに、デザイナーのメタデータを登録して、すべてのビルトイン アクティビティにデザイナー サポートを追加し、[!INCLUDE[avalon2](../../../includes/avalon2-md.md)] アプリケーションで[!INCLUDE[wfd2](../../../includes/wfd2-md.md)]をホストします。  
+  
+### ワークフロー デザイナーをホストするには  
+  
+1.  「[タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成](../../../docs/framework/windows-workflow-foundation//task-1-create-a-new-wpf-app.md)」で作成した HostingApplication プロジェクトを開きます。  
+  
+2.  [!INCLUDE[wfd2](../../../includes/wfd2-md.md)] が見やすくなるように、ウィンドウのサイズを調整します。ウィンドウのサイズを調整するには、デザイナーで **\[MainWindow\]** を選択し、F4 キーを押して **\[プロパティ\]** ウィンドウを表示して、**レイアウト** セクションで **\[幅\]** の値を「600」に設定し、**\[高さ\]** の値を「350」に設定します。  
+  
+3.  デザイナーで **\[グリッド\]** パネルを選択し \(**\[MainWindow\]** 内のボックスをクリックします\)、**\[プロパティ\]** ウィンドウの一番上にある **Name** プロパティを「grid1」に設定して、グリッド名を設定します。  
+  
+4.  **\[プロパティ\]** ウィンドウで、`ColumnDefinitions` プロパティの横の省略記号 \(**\[...\]**\) をクリックして **\[コレクション エディター\]** ダイアログ ボックスを開きます。  
+  
+5.  **\[コレクション エディター\]** ダイアログ ボックスの **\[追加\]** ボタンを 3 回クリックして、3 つの列をレイアウトに挿入します。最初の列には **\[ツールボックス\]** が含まれ、2 番目の列は [!INCLUDE[wfd2](../../../includes/wfd2-md.md)] をホストし、3 番目の列はプロパティ インスペクターに使用されます。  
+  
+6.  中央の列の `Width` プロパティの値を「4\*」に設定します。  
+  
+7.  **\[OK\]** をクリックして、変更を保存します。次の XAML が MainWindow.xaml ファイルに追加されます。  
+  
+    ```  
+  
+    <Grid Name="grid1">  
+        <Grid.ColumnDefinitions>  
+            <ColumnDefinition />  
+            <ColumnDefinition Width="4*" />  
+            <ColumnDefinition />  
+        </Grid.ColumnDefinitions>  
+    </Grid>  
+  
+    ```  
+  
+8.  ソリューション エクスプローラーで MainWindow.xaml を右クリックし、**\[コードの表示\]** を選択します。次の手順に従ってコードを修正します。  
+  
+    1.  次の名前空間を追加します。  
+  
+        ```csharp  
+  
+        using System.Activities;  
+        using System.Activities.Core.Presentation;  
+        using System.Activities.Presentation;  
+        using System.Activities.Presentation.Metadata;  
+        using System.Activities.Presentation.Toolbox;  
+        using System.Activities.Statements;  
+        using System.ComponentModel;  
+  
+        ```  
+  
+    2.  <xref:System.Activities.Presentation.WorkflowDesigner> のインスタンスを保持するプライベート メンバー フィールドを宣言するには、次のコードを `MainWindow` クラスに追加します。  
+  
+        ```csharp  
+  
+        public partial class MainWindow : Window  
+        {  
+            private WorkflowDesigner wd;  
+  
+            public MainWindow()  
+            {  
+                InitializeComponent();  
+            }  
+        }  
+  
+        ```  
+  
+    3.  次の `AddDesigner` メソッドを `MainWindow` クラスに追加します。この実装で、<xref:System.Activities.Presentation.WorkflowDesigner> のインスタンスを作成し、これに <xref:System.Activities.Statements.Sequence> アクティビティを追加して、grid1 **グリッド**の中央の列に配置します。  
+  
+        ```csharp  
+  
+        private void AddDesigner()  
+        {  
+            //Create an instance of WorkflowDesigner class.  
+            this.wd = new WorkflowDesigner();  
+  
+            //Place the designer canvas in the middle column of the grid.  
+            Grid.SetColumn(this.wd.View, 1);  
+  
+            //Load a new Sequence as default.  
+            this.wd.Load(new Sequence());  
+  
+            //Add the designer canvas to the grid.  
+            grid1.Children.Add(this.wd.View);  
+        }  
+  
+        ```  
+  
+    4.  デザイナーのメタデータを登録して、すべてのビルトイン アクティビティにデザイナー サポートを追加します。こうすることにより、ツールボックスから[!INCLUDE[wfd2](../../../includes/wfd2-md.md)]の元の <xref:System.Activities.Statements.Sequence> アクティビティに、アクティビティをドロップできるようになります。この操作を行うには、`RegisterMetadata` メソッドを `MainWindow` クラスに追加します。  
+  
+        ```csharp  
+  
+        private void RegisterMetadata()  
+        {               
+            DesignerMetadata dm = new DesignerMetadata();  
+            dm.Register();  
+        }  
+  
+        ```  
+  
+         登録アクティビティ デザイナー[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法: カスタム アクティビティ デザイナーを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-activity-designer.md)」を参照してください。  
+  
+    5.  `MainWindow` クラス コンストラクターで、前に宣言したメソッドへの呼び出しを追加して、デザイナー サポートのメタデータを登録し、<xref:System.Activities.Presentation.WorkflowDesigner> を作成します。  
+  
+        ```csharp  
+        public MainWindow()  
+        {  
+            InitializeComponent();  
+  
+            // Register the metadata  
+            RegisterMetadata();  
+  
+            // Add the WFF Designer  
+            AddDesigner();  
+        }  
+  
+        ```  
+  
+        > [!NOTE]
+        >  `RegisterMetadata` メソッドは、<xref:System.Activities.Statements.Sequence> アクティビティを含むビルトイン アクティビティのデザイナーのメタデータを登録します。`AddDesigner` メソッドは <xref:System.Activities.Statements.Sequence> アクティビティを使用するので、`RegisterMetadata` メソッドを先に呼び出す必要があります。  
+  
+9. F5 キーを押して、ソリューションをビルドおよび実行します。  
+  
+10. **\[ツールボックス\]** と **\[PropertyGrid\]** のサポートを、再ホストしたワークフロー デザイナーに追加する方法を学習するには、「[タスク 3: ツールボックス ペインと PropertyGrid ペインの作成](../../../docs/framework/windows-workflow-foundation//task-3-create-the-toolbox-and-propertygrid-panes.md)」を参照してください。  
+  
+## 参照  
+ [ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)   
+ [タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成](../../../docs/framework/windows-workflow-foundation//task-1-create-a-new-wpf-app.md)   
+ [タスク 3: ツールボックス ペインと PropertyGrid ペインの作成](../../../docs/framework/windows-workflow-foundation//task-3-create-the-toolbox-and-propertygrid-panes.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/task-3-create-the-toolbox-and-propertygrid-panes.md b/docs/framework/windows-workflow-foundation/task-3-create-the-toolbox-and-propertygrid-panes.md
new file mode 100644
index 00000000000..855b417fc05
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/task-3-create-the-toolbox-and-propertygrid-panes.md
@@ -0,0 +1,235 @@
+---
+title: "タスク 3: ツールボックス ペインと PropertyGrid ペインの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 72c1546a-eed5-4f0f-a616-719a163414f4
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# タスク 3: ツールボックス ペインと PropertyGrid ペインの作成
+このタスクでは、**ツールボックス** ペインと **PropertyGrid** ペインを作成し、ホストを変更した [!INCLUDE[wfd1](../../../includes/wfd1-md.md)]に追加します。  
+  
+ 参照用として、「[ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)」のトピック シリーズで 3 つのタスクを完了した後に MainWindow.xaml.cs ファイルに示されるコードをこのトピックの最後に示します。  
+  
+### ツールボックスを作成し、グリッドに追加するには  
+  
+1.  「[タスク 2: ワークフロー デザイナーのホスティング](../../../docs/framework/windows-workflow-foundation//task-2-host-the-workflow-designer.md)」で説明されている手順に従って取得した HostingApplication プロジェクトを開きます。  
+  
+2.  **ソリューション エクスプローラー** ペインで、MainWindow.xaml ファイルを右クリックし、**\[コードの表示\]** をクリックします。  
+  
+3.  <xref:System.Activities.Presentation.Toolbox.ToolboxControl> を作成する `GetToolboxControl` メソッドを `MainWindow` クラスに追加し、新しい **Toolbox** カテゴリを **Toolbox** に追加し、<xref:System.Activities.Statements.Assign> および <xref:System.Activities.Statements.Sequence> アクティビティの種類をそのカテゴリに割り当てます。  
+  
+    ```csharp  
+  
+    private ToolboxControl GetToolboxControl()  
+    {  
+        // Create the ToolBoxControl.  
+        ToolboxControl ctrl = new ToolboxControl();  
+  
+        // Create a category.  
+        ToolboxCategory category = new ToolboxCategory("category1");  
+  
+        // Create Toolbox items.  
+        ToolboxItemWrapper tool1 =   
+            new ToolboxItemWrapper("System.Activities.Statements.Assign",   
+            typeof(Assign).Assembly.FullName, null, "Assign");  
+  
+        ToolboxItemWrapper tool2 = new ToolboxItemWrapper("System.Activities.Statements.Sequence",   
+            typeof(Sequence).Assembly.FullName, null, "Sequence");  
+  
+        // Add the Toolbox items to the category.  
+        category.Add(tool1);  
+        category.Add(tool2);  
+  
+        // Add the category to the ToolBox control.  
+        ctrl.Categories.Add(category);  
+        return ctrl;  
+    }  
+  
+    ```  
+  
+4.  グリッドの左の列に **Toolbox** を配置する `AddToolbox` プライベート メソッドを `MainWindow` クラスに追加します。  
+  
+    ```csharp  
+  
+    private void AddToolBox()  
+    {  
+        ToolboxControl tc = GetToolboxControl();  
+        Grid.SetColumn(tc, 0);  
+        grid1.Children.Add(tc);  
+    }  
+  
+    ```  
+  
+5.  次のコードのように、`MainWindow()` クラス コンストラクターに `AddToolBox` メソッドへの呼び出しを追加します。  
+  
+    ```csharp  
+  
+    public MainWindow()  
+    {  
+        InitializeComponent();  
+        this.RegisterMetadata();  
+        this.AddDesigner();  
+  
+        this.AddToolBox();  
+    }  
+  
+    ```  
+  
+6.  F5 キーを押して、ソリューションをビルドおよび実行します。<xref:System.Activities.Statements.Assign> アクティビティおよび <xref:System.Activities.Statements.Sequence> を含む **\[ツールボックス\]** が表示されます。  
+  
+### PropertyGrid を作成するには  
+  
+1.  **ソリューション エクスプローラー** ペインで、MainWindow.xaml ファイルを右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `MainWindow` クラスに `AddPropertyInspector` メソッドを追加して、グリッドの最も右側の列に **PropertyGrid** ペインを配置します。  
+  
+    ```csharp  
+  
+    private void AddPropertyInspector()  
+    {  
+        Grid.SetColumn(wd.PropertyInspectorView, 2);  
+        grid1.Children.Add(wd.PropertyInspectorView);              
+    }  
+  
+    ```  
+  
+3.  次のコードのように、`MainWindow()` クラス コンストラクターに `AddPropertyInspector` メソッドへの呼び出しを追加します。  
+  
+    ```csharp  
+  
+    public MainWindow()  
+    {  
+        InitializeComponent();  
+        this.RegisterMetadata();  
+        this.AddDesigner();  
+        this.AddToolBox();  
+  
+        this.AddPropertyInspector();   
+    }  
+  
+    ```  
+  
+4.  F5 キーを押して、ソリューションをビルドおよび実行します。**Toolbox**、ワークフロー デザイン キャンバス、および **PropertyGrid** の各ペインがすべて表示されます。また、<xref:System.Activities.Statements.Assign> アクティビティまたは <xref:System.Activities.Statements.Sequence> アクティビティをデザイン キャンバスにドラッグすると、選択されているアクティビティに応じてプロパティ グリッドが更新されます。  
+  
+## 使用例  
+ MainWindow.xaml.cs ファイルに次のコードが含まれます。  
+  
+```  
+  
+using System;  
+using System.Collections.Generic;  
+using System.Linq;  
+using System.Text;  
+using System.Windows;  
+using System.Windows.Controls;  
+using System.Windows.Data;  
+using System.Windows.Documents;  
+using System.Windows.Input;  
+using System.Windows.Media;  
+using System.Windows.Media.Imaging;  
+using System.Windows.Navigation;  
+using System.Windows.Shapes;  
+//dlls added  
+using System.Activities;  
+using System.Activities.Core.Presentation;  
+using System.Activities.Presentation;  
+using System.Activities.Presentation.Metadata;  
+using System.Activities.Presentation.Toolbox;  
+using System.Activities.Statements;  
+using System.ComponentModel;  
+  
+namespace HostingApplication  
+{  
+    /// <summary>  
+    /// Interaction logic for MainWindow.xaml  
+    /// </summary>  
+    public partial class MainWindow : Window  
+    {  
+        private WorkflowDesigner wd;  
+  
+        public MainWindow()  
+        {  
+            InitializeComponent();  
+            RegisterMetadata();  
+            AddDesigner();  
+            this.AddToolBox();  
+            this.AddPropertyInspector();  
+        }  
+  
+        private void AddDesigner()  
+        {  
+            //Create an instance of WorkflowDesigner class.  
+            this.wd = new WorkflowDesigner();  
+  
+            //Place the designer canvas in the middle column of the grid.  
+            Grid.SetColumn(this.wd.View, 1);  
+  
+            //Load a new Sequence as default.  
+            this.wd.Load(new Sequence());  
+  
+            //Add the designer canvas to the grid.  
+            grid1.Children.Add(this.wd.View);  
+        }  
+  
+        private void RegisterMetadata()  
+        {  
+            DesignerMetadata dm = new DesignerMetadata();  
+            dm.Register();  
+        }  
+  
+        private ToolboxControl GetToolboxControl()  
+        {  
+            // Create the ToolBoxControl.  
+            ToolboxControl ctrl = new ToolboxControl();  
+  
+            // Create a category.  
+            ToolboxCategory category = new ToolboxCategory("category1");  
+  
+            // Create Toolbox items.  
+            ToolboxItemWrapper tool1 =  
+                new ToolboxItemWrapper("System.Activities.Statements.Assign",  
+                typeof(Assign).Assembly.FullName, null, "Assign");  
+  
+            ToolboxItemWrapper tool2 = new ToolboxItemWrapper("System.Activities.Statements.Sequence",  
+                typeof(Sequence).Assembly.FullName, null, "Sequence");  
+  
+            // Add the Toolbox items to the category.  
+            category.Add(tool1);  
+            category.Add(tool2);  
+  
+            // Add the category to the ToolBox control.  
+            ctrl.Categories.Add(category);  
+            return ctrl;  
+        }  
+  
+        private void AddToolBox()  
+        {  
+            ToolboxControl tc = GetToolboxControl();  
+            Grid.SetColumn(tc, 0);  
+            grid1.Children.Add(tc);  
+        }  
+  
+        private void AddPropertyInspector()  
+        {  
+            Grid.SetColumn(wd.PropertyInspectorView, 2);  
+            grid1.Children.Add(wd.PropertyInspectorView);  
+        }  
+  
+    }  
+}  
+  
+```  
+  
+## 参照  
+ [ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)   
+ [タスク 1: 新しい Windows Presentation Foundation アプリケーションの作成](../../../docs/framework/windows-workflow-foundation//task-1-create-a-new-wpf-app.md)   
+ [タスク 2: ワークフロー デザイナーのホスティング](../../../docs/framework/windows-workflow-foundation//task-2-host-the-workflow-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/tracking-events-reference.md b/docs/framework/windows-workflow-foundation/tracking-events-reference.md
new file mode 100644
index 00000000000..ff7cf0aba9c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/tracking-events-reference.md
@@ -0,0 +1,145 @@
+---
+title: "追跡イベントのリファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: c1c1ee87-f80a-449b-acd0-50d81eef116e
+caps.latest.revision: 23
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 23
+---
+# 追跡イベントのリファレンス
+[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] のワークフローが実行中にライフタイムのさまざまなステージを移行するとき、追跡イベントが発生します。ホストはこれらのイベントに定期受信し、ライフタイム中のワークフローの進行状況について最新の状態に保ちます。ここでは、発生する追跡イベントについて説明します。  
+  
+## イベント リファレンス  
+  
+|イベント ID|イベント レベル|イベント メッセージ|キーワード|  
+|-------------|--------------|----------------|-----------|  
+|[100 \- WorkflowInstanceRecord](../../../docs/framework/windows-workflow-foundation//100-workflowinstancerecord.md)|情報|TrackRecord\= WorkflowInstanceRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、Annotations \= %6、ProfileName \= %7|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[101 \- WorkflowInstanceUnhandledExceptionRecord](../../../docs/framework/windows-workflow-foundation//101-workflowinstanceunhandledexceptionrecord.md)|Error|TrackRecord \= WorkflowInstanceUnhandledExceptionRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、SourceName \= %5、SourceId \= %6、SourceInstanceId \= %7、SourceTypeName\=%8、Exception\=%9、Annotations\= %10、ProfileName \= %11|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[102 \- WorkflowInstanceAbortedRecord](../../../docs/framework/windows-workflow-foundation//102-workflowinstanceabortedrecord.md)|警告|TrackRecord \= WorkflowInstanceAbortedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[103 \- ActivityStateRecord](../../../docs/framework/windows-workflow-foundation//103-activitystaterecord.md)|情報|TrackRecord \= ActivityStateRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、State \= %4、Name\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Arguments\=%9、Variables\=%10、Annotations\=%11、ProfileName \= %12|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[104 \- ActivityScheduledRecord](../../../docs/framework/windows-workflow-foundation//104-activityscheduledrecord.md)|情報|TrackRecord \= ActivityScheduledRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、Name \= %4、ActivityId \= %5、ActivityInstanceId \= %6、ActivityTypeName \= %7、ChildActivityName \= %8、ChildActivityId \= %9、ChildActivityInstanceId \= %10、ChildActivityTypeName \=%11、Annotations\=%12、ProfileName \= %13|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[105 \- FaultPropagationRecord](../../../docs/framework/windows-workflow-foundation//105-faultpropagationrecord.md)|警告|TrackRecord \= FaultPropagationRecord、InstanceID\=%1、RecordNumber\=%2、EventTime\=%3、FaultSourceActivityName\=%4、FaultSourceActivityId\=%5、FaultSourceActivityInstanceId\=%6、FaultSourceActivityTypeName\=%7、FaultHandlerActivityName\=%8、 FaultHandlerActivityId \= %9、FaultHandlerActivityInstanceId \=%10、FaultHandlerActivityTypeName\=%11、Fault\=%12、IsFaultSource\=%13、Annotations\=%14、ProfileName \= %15|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[106 \- CancelRequestRecord](../../../docs/framework/windows-workflow-foundation//106-cancelrequestrecord.md)|情報|TrackRecord \= CancelRequestedRecord、InstanceID\=%1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityId\=%5、ActivityInstanceId\=%6、ActivityTypeName \= %7、ChildActivityName \= %8、ChildActivityId \= %9、ChildActivityInstanceId \= %10、ChildActivityTypeName \=%11、Annotations\=%12、ProfileName \= %13|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[107 \-\- BookmarkResumptionRecord](../../../docs/framework/windows-workflow-foundation//107-bookmarkresumptionrecord.md)|情報|TrackRecord \= BookmarkResumptionRecord、InstanceID\=%1、RecordNumber\=%2,EventTime\=%3、Name\=%4、SubInstanceID\=%5、OwnerActivityName\=%6、OwnerActivityId \=%7、OwnerActivityInstanceId\=%8、OwnerActivityTypeName\=%9、Annotations\=%10、ProfileName \= %11|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[108 \- CustomTrackingRecordInfo](../../../docs/framework/windows-workflow-foundation//108-customtrackingrecordinfo.md)|情報|TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[110 – CustomTrackingRecordWarning](../../../docs/framework/windows-workflow-foundation//110-customtrackingrecordwarning.md)|警告|TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[111 \- CustomTrackingRecordError](../../../docs/framework/windows-workflow-foundation//111-customtrackingrecorderror.md)|Error|TrackRecord \= CustomTrackingRecord、InstanceID \= %1、RecordNumber\=%2、EventTime\=%3、Name\=%4、ActivityName\=%5、ActivityId\=%6、ActivityInstanceId\=%7、ActivityTypeName\=%8、Data\=%9、Annotations\=%10、ProfileName \= %11|UserEvents、EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[112 \- WorkflowInstanceSuspendedRecord](../../../docs/framework/windows-workflow-foundation//112-workflowinstancesuspendedrecord.md)|情報|TrackRecord \= WorkflowInstanceSuspendedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[113 \- WorkflowInstanceTerminatedRecord](../../../docs/framework/windows-workflow-foundation//113-workflowinstanceterminatedrecord.md)|Error|TrackRecord \= WorkflowInstanceTerminatedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7|EndToEndMonitoring、Troubleshooting、HealthMonitoring、WFTracking|  
+|[114 \- WorkflowInstanceRecordWithId](../../../docs/framework/windows-workflow-foundation//114-workflowinstancerecordwithid.md)|情報|TrackRecord\= WorkflowInstanceRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8|HealthMonitoring、WFTracking|  
+|[115 \- WorkflowInstanceAbortedRecordWithId](../../../docs/framework/windows-workflow-foundation//115-workflowinstanceabortedrecordwithid.md)|警告|TrackRecord \= WorkflowInstanceAbortedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8|HealthMonitoring、WFTracking|  
+|[116 \- WorkflowInstanceSuspendedRecordWithId](../../../docs/framework/windows-workflow-foundation//116-workflowinstancesuspendedrecordwithid.md)|情報|TrackRecord \= WorkflowInstanceSuspendedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8|HealthMonitoring、WFTracking|  
+|[117 \- WorkflowInstanceTerminatedRecordWithId](../../../docs/framework/windows-workflow-foundation//117-workflowinstanceterminatedrecordwithid.md)|Error|TrackRecord \= WorkflowInstanceTerminatedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、Reason \= %5、Annotations \= %6、ProfileName \= %7、WorkflowDefinitionIdentity \= %8|HealthMonitoring、WFTracking|  
+|[118 \- WorkflowInstanceUnhandledExceptionRecordWithId](../../../docs/framework/windows-workflow-foundation//118-workflowinstanceunhandledexceptionrecordwithid.md)|Error|TrackRecord \= WorkflowInstanceUnhandledExceptionRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、SourceName \= %5、SourceId \= %6、SourceInstanceId \= %7、SourceTypeName\=%8、Exception\=%9、Annotations\= %10、ProfileName \= %11、WorkflowDefinitionIdentity \= %12|HealthMonitoring、WFTrackingHealthMonitoring、WFTracking|  
+|[119 \- WorkflowInstanceUpdatedRecord](../../../docs/framework/windows-workflow-foundation//119-workflowinstanceupdatedrecord.md)|情報|TrackRecord\= WorkflowInstanceUpdatedRecord、InstanceID \= %1、RecordNumber \= %2、EventTime \= %3、ActivityDefinitionId \= %4、State \= %5、OriginalDefinitionIdentity \= %6、UpdatedDefinitionIdentity \= %7、Annotations \= %8、ProfileName \= %9|HealthMonitoring、WFTracking|  
+|[225 \- TraceCorrelationKeys](../../../docs/framework/windows-workflow-foundation//225-tracecorrelationkeys.md)|情報|親スコープ '%3' の値 '%2' を使用して相関関係キー '%1' が計算されました。|トラブルシューティング \(WF サービス\)|  
+|[440 \- StartSignpostEvent1](../../../docs/framework/windows-workflow-foundation//440-startsignpostevent.md)|情報|アクティビティの境界。|トラブルシューティング \(WF サービス\)|  
+|[441\- StopSignpostEvent1](../../../docs/framework/windows-workflow-foundation//441-stopsignpostevent.md)|情報|アクティビティの境界。|トラブルシューティング \(WF サービス\)|  
+|[1001 \- WorkflowApplicationCompleted](../../../docs/framework/windows-workflow-foundation//1001-workflowapplicationcompleted.md)|情報|WorkflowInstance ID: %1 は Closed 状態で終了しました。|WFRuntime|  
+|[1002 \- WorkflowApplicationTerminated](../../../docs/framework/windows-workflow-foundation//1002-workflowapplicationterminated.md)|情報|WorkflowApplication ID: %1 は中止されました。Faulted 状態で終了し、例外が発生しました。|WFRuntime|  
+|[1003 \- WorkflowInstanceCanceled](../../../docs/framework/windows-workflow-foundation//1003-workflowinstancecanceled.md)|情報|WorkflowInstance ID: %1 は Canceled 状態で終了しました。|WFRuntime|  
+|[1004 \- WorkflowInstanceAborted](../../../docs/framework/windows-workflow-foundation//1004-workflowinstanceaborted.md)|情報|WorkflowInstance ID: '%1' は中止され、例外が発生しました。|WFRuntime|  
+|[1005 \- WorkflowApplicationIdled](../../../docs/framework/windows-workflow-foundation//1005-workflowapplicationidled.md)|情報|WorkflowApplication ID: '%1' がアイドル状態になりました。|WFRuntime|  
+|[1006 \- WorkflowApplicationUnhandledException](../../../docs/framework/windows-workflow-foundation//1006-workflowapplicationunhandledexception.md)|Error|WorkflowInstance ID: '%1' でハンドルされない例外が発生しました。例外は Activity '%2', DisplayName: '%3' から発生しました。次の操作が実行されます: %4。|WFRuntime|  
+|[1007 \- WorkflowApplicationPersisted](../../../docs/framework/windows-workflow-foundation//1007-workflowapplicationpersisted.md)|情報|WorkflowApplication ID: %1 が永続化されました。|WFRuntime|  
+|[1008 \- WorkflowApplicationUnloaded](../../../docs/framework/windows-workflow-foundation//1008-workflowapplicationunloaded.md)|情報|WorkflowInstance ID: '%1' がアンロードされました。|WFRuntime|  
+|[1009 \- ActivityScheduled](../../../docs/framework/windows-workflow-foundation//1009-activityscheduled.md)|情報|Parent Activity '%1'、DisplayName: '%2'、InstanceId: '%3' scheduled child Activity '%4'、DisplayName: '%5'、InstanceId: '%6'。|WFRuntime|  
+|[1010 \- ActivityCompleted](../../../docs/framework/windows-workflow-foundation//1010-activitycompleted.md)|情報|Parent Activity '%1'、DisplayName: '%2'、InstanceId: '%3' scheduled child Activity '%4'、DisplayName: '%5'、InstanceId: '%6'。|WFRuntime|  
+|[1011 \- ScheduleExecuteActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1011-scheduleexecuteactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して ExecuteActivityWorkItem がスケジュールされました。|WFRuntime|  
+|[1012 \- StartExecuteActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1012-startexecuteactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の ExecuteActivityWorkItem の実行を開始しています。|WFRuntime|  
+|[1013 \- CompleteExecuteActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1013-completeexecuteactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の ExecuteActivityWorkItem が完了しました。|WFRuntime|  
+|[1014 \- ScheduleCompletionWorkItem](../../../docs/framework/windows-workflow-foundation//1014-schedulecompletionworkitem.md)|Verbose|親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して CompletionWorkItem がスケジュールされました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。|WFRuntime|  
+|[1015 \- StartCompletionWorkItem](../../../docs/framework/windows-workflow-foundation//1015-startcompletionworkitem.md)|Verbose|親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CompletionWorkItem の実行を開始しています。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。|WFRuntime|  
+|[1016 \- CompleteCompletionWorkItem](../../../docs/framework/windows-workflow-foundation//1016-completecompletionworkitem.md)|Verbose|親 Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CompletionWorkItem が完了しました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' が完了しました。|WFRuntime|  
+|[1017 \- ScheduleCancelActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1017-schedulecancelactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して CancelActivityWorkItem がスケジュールされました。|WFRuntime|  
+|[1018 \- StartCancelActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1018-startcancelactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CancelActivityWorkItem の実行を開始しています。|WFRuntime|  
+|[1019 \- CompleteCancelActivityWorkItem](../../../docs/framework/windows-workflow-foundation//1019-completecancelactivityworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の CancelActivityWorkItem が完了しました。|WFRuntime|  
+|[1020 \- CreateBookmark](../../../docs/framework/windows-workflow-foundation//1020-createbookmark.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のブックマークが作成されました。BookmarkName: %4、BookmarkScope: %5。|WFRuntime|  
+|[1021 \- ScheduleBookmarkWorkItem](../../../docs/framework/windows-workflow-foundation//1021-schedulebookmarkworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して BookmarkWorkItem がスケジュールされました。BookmarkName: %4、BookmarkScope: %5。|WFRuntime|  
+|[1022 \- StartBookmarkWorkItem](../../../docs/framework/windows-workflow-foundation//1022-startbookmarkworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の BookmarkWorkItem の実行を開始しています。BookmarkName: %4、BookmarkScope: %5。|WFRuntime|  
+|[1023 \- CompleteBookmarkWorkItem](../../../docs/framework/windows-workflow-foundation//1023-completebookmarkworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の BookmarkWorkItem が完了しました。BookmarkName: %4、BookmarkScope: %5。|WFRuntime|  
+|[1024 \- CreateBookmarkScope](../../../docs/framework/windows-workflow-foundation//1024-createbookmarkscope.md)|Verbose|BookmarkScope が作成されました: %1。|WFRuntime|  
+|[1025 \- BookmarkScopeInitialized](../../../docs/framework/windows-workflow-foundation//1025-bookmarkscopeinitialized.md)|Verbose|TemporaryId: '%1' を指定されていた BookmarkScope が ID: '%2' で初期化されました。|WFRuntime|  
+|[1026 \- ScheduleTransactionContextWorkItem](../../../docs/framework/windows-workflow-foundation//1026-scheduletransactioncontextworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して TransactionContextWorkItem がスケジュールされました。|WFRuntime|  
+|[1027 \- StartTransactionContextWorkItem](../../../docs/framework/windows-workflow-foundation//1027-starttransactioncontextworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の TransactionContextWorkItem の実行を開始しています。|WFRuntime|  
+|[1028 \- CompleteTransactionContextWorkItem](../../../docs/framework/windows-workflow-foundation//1028-completetransactioncontextworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の TransactionContextWorkItem が完了しました。|WFRuntime|  
+|[1029 \- ScheduleFaultWorkItem](../../../docs/framework/windows-workflow-foundation//1029-schedulefaultworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対して FaultWorkItem がスケジュールされました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。|WFRuntime|  
+|[1030 \- StartFaultWorkItem](../../../docs/framework/windows-workflow-foundation//1030-startfaultworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の FaultWorkItem の実行を開始しています。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。|WFRuntime|  
+|[1031 \- CompleteFaultWorkItem](../../../docs/framework/windows-workflow-foundation//1031-completefaultworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' の FaultWorkItem が完了しました。Activity '%4'、DisplayName: '%5'、InstanceId: '%6' から例外が伝達されました。|WFRuntime|  
+|[1032 \- ScheduleRuntimeWorkItem](../../../docs/framework/windows-workflow-foundation//1032-scheduleruntimeworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' に対してランタイム作業項目がスケジュールされました。|WFRuntime|  
+|[1033 \- StartRuntimeWorkItem](../../../docs/framework/windows-workflow-foundation//1033-startruntimeworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のランタイム作業項目の実行を開始しています。|WFRuntime|  
+|[1034 \- CompleteRuntimeWorkItem](../../../docs/framework/windows-workflow-foundation//1034-completeruntimeworkitem.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' のランタイム作業項目が完了しました。|WFRuntime|  
+|[1035 \- RuntimeTransactionSet](../../../docs/framework/windows-workflow-foundation//1035-runtimetransactionset.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' によってランタイム トランザクションが設定されました。実行は Activity '%4'、DisplayName: '%5'、InstanceId: '%6' に分離されました。|WFRuntime|  
+|[1036 \- RuntimeTransactionCompletionRequested](../../../docs/framework/windows-workflow-foundation//1036-runtimetransactioncompletionrequested.md)|Verbose|Activity '%1'、DisplayName: '%2'、InstanceId: '%3' はランタイム トランザクションの完了をスケジュールしました。|WFRuntime|  
+|[1037 \- RuntimeTransactionComplete](../../../docs/framework/windows-workflow-foundation//1037-runtimetransactioncomplete.md)|Verbose|ランタイム トランザクションは '%1' の状態で完了しました。|WFRuntime|  
+|[1038 \- EnterNoPersistBlock](../../../docs/framework/windows-workflow-foundation//1038-enternopersistblock.md)|Verbose|非永続的ブロックに入ります。|WFRuntime|  
+|[1039 \- ExitNoPersistBlock](../../../docs/framework/windows-workflow-foundation//1039-exitnopersistblock.md)|Verbose|非永続的ブロックを終了します。|WFRuntime|  
+|[1040 \- InArgumentBound](../../../docs/framework/windows-workflow-foundation//1040-inargumentbound.md)|Verbose|Activity '%2' の引数 '%1' で、DisplayName: '%3'、InstanceId: '%4' が値: %5 にバインドされています。|WFActivities|  
+|[1041 \- WorkflowApplicationPersistableIdle](../../../docs/framework/windows-workflow-foundation//1041-workflowapplicationpersistableidle.md)|情報|WorkflowApplication ID: '%1' がアイドル状態のままです。次の操作が実行されます: %2。|WFRuntime|  
+|[1101 \- WorkflowActivityStart](../../../docs/framework/windows-workflow-foundation//1101-workflowactivitystart.md)|情報|WorkflowInstance ID: '%1' E2E アクティビティ|WFRuntime|  
+|[1102 \- WorkflowActivityStop](../../../docs/framework/windows-workflow-foundation//1102-workflowactivitystop.md)|情報|WorkflowInstance ID: '%1' E2E アクティビティ|WFRuntime|  
+|[1103 \- WorkflowActivitySuspend](../../../docs/framework/windows-workflow-foundation//1103-workflowactivitysuspend.md)|情報|WorkflowInstance ID: '%1' E2E アクティビティ|WFRuntime|  
+|[1104 \- WorkflowActivityResume](../../../docs/framework/windows-workflow-foundation//1104-workflowactivityresume.md)|情報|WorkflowInstance ID: '%1' E2E アクティビティ|WFRuntime|  
+|[1124 \- InvokeMethodIsStatic](../../../docs/framework/windows-workflow-foundation//1124-invokemethodisstatic.md)|情報|InvokeMethod '%1' \- メソッドは Static です。|WFRuntime|  
+|[1125 \- InvokeMethodIsNotStatic](../../../docs/framework/windows-workflow-foundation//1125-invokemethodisnotstatic.md)|情報|InvokeMethod '%1' \- メソッドは Static ではありません。|WFRuntime|  
+|[1126 \- InvokedMethodThrewException](../../../docs/framework/windows-workflow-foundation//1126-invokedmethodthrewexception.md)|情報|アクティビティ '%1' によって呼び出されたメソッドで例外がスローされました。%2|WFRuntime|  
+|[1131 \- InvokeMethodUseAsyncPattern](../../../docs/framework/windows-workflow-foundation//1131-invokemethoduseasyncpattern.md)|情報|InvokeMethod '%1' \- メソッドでは '%2' および '%3' の非同期パターンを使用します。|WFRuntime|  
+|[1132 \- InvokeMethodDoesNotUseAsyncPattern](../../../docs/framework/windows-workflow-foundation//1132-invokemethoddoesnotuseasyncpattern.md)|情報|InvokeMethod '%1' \- メソッドでは非同期パターンを使用しません。|WFRuntime|  
+|[1140 \- FlowchartStart](../../../docs/framework/windows-workflow-foundation//1140-flowchartstart.md)|情報|フローチャート '%1' \- 開始がスケジュールされています。|WFActivities|  
+|[1141 \- FlowchartEmpty](../../../docs/framework/windows-workflow-foundation//1141-flowchartempty.md)|警告|Flowchart '%1' \- アクティビティ '%1' によって呼び出されたメソッドで Nodes.An 例外がスローされることなく実行されました。%2|WFActivities|  
+|[1143 \- FlowchartNextNull](../../../docs/framework/windows-workflow-foundation//1143-flowchartnextnull.md)|情報|Flowchart '%1'\/FlowStep \- 次のノードは null です。フローチャートの実行は終了します。|WFActivities|  
+|[1146 \- FlowchartSwitchCase](../../../docs/framework/windows-workflow-foundation//1146-flowchartswitchcase.md)|情報|フローチャート '%1'\/FlowSwitch \- ケース '%2' が選択されました。|WFActivities|  
+|[1147 \- FlowchartSwitchDefault](../../../docs/framework/windows-workflow-foundation//1147-flowchartswitchdefault.md)|情報|フローチャート '%1'\/FlowSwitch \- 既定のケースが選択されました。|WFActivities|  
+|[1148 \- FlowchartSwitchCaseNotFound](../../../docs/framework/windows-workflow-foundation//1148-flowchartswitchcasenotfound.md)|情報|Flowchart '%1'\/FlowSwitch \- 式の結果に一致するケース アクティビティも既定のケースも見つかりませんでした。フローチャートの実行は終了します。|WFActivities|  
+|[1150 \- CompensationState](../../../docs/framework/windows-workflow-foundation//1150-compensationstate.md)|情報|CompensableActivity '%1' は '%2' 状態です|WFActivities|  
+|[1223 \- SwitchCaseNotFound](../../../docs/framework/windows-workflow-foundation//1223-switchcasenotfound.md)|情報|Switch アクティビティ 'X' は Expression の結果に一致する Case アクティビティを見つけることができませんでした。|WFActivities|  
+|[1449 \- WfMessageReceived](../../../docs/framework/windows-workflow-foundation//1449-wfmessagereceived.md)|情報|メッセージがワークフローによって受信されました|WFServices|  
+|[1450 \- WfMessageSent](../../../docs/framework/windows-workflow-foundation//1450-wfmessagesent.md)|情報|メッセージがワークフローから送信されました|WFServices|  
+|[2021 \- ExecuteWorkItemStart](../../../docs/framework/windows-workflow-foundation//2021-executeworkitemstart.md)|Verbose|作業項目の開始を実行します。|WFRuntime|  
+|[2022 \- ExecuteWorkItemStop](../../../docs/framework/windows-workflow-foundation//2022-executeworkitemstop.md)|Verbose|作業項目の停止を実行します。|WFRuntime|  
+|[2023 \- SendMessageChannelCacheMiss](../../../docs/framework/windows-workflow-foundation//2023-sendmessagechannelcachemiss.md)|Verbose|sendMessageChannelCache ミス|WFRuntime|  
+|[2024 \- InternalCacheMetadataStart](../../../docs/framework/windows-workflow-foundation//2024-internalcachemetadatastart.md)|Verbose|アクティビティ '%1' で InternalCacheMetadata が開始されました。|WFRuntime|  
+|[2025 \- InternalCacheMetadataStop](../../../docs/framework/windows-workflow-foundation//2025-internalcachemetadatastop.md)|Verbose|アクティビティ '%1' で InternalCacheMetadata が停止されました。|WFRuntime|  
+|[2026 \- CompileVbExpressionStart](../../../docs/framework/windows-workflow-foundation//2026-compilevbexpressionstart.md)|Verbose|VB 式 '%1' をコンパイルしています|WFRuntime|  
+|[2027 \- CacheRootMetadataStart](../../../docs/framework/windows-workflow-foundation//2027-cacherootmetadatastart.md)|Verbose|アクティビティ '%1' で CacheRootMetadata が開始されました|WFRuntime|  
+|[2028 \- CacheRootMetadataStop](../../../docs/framework/windows-workflow-foundation//2028-cacherootmetadatastop.md)|Verbose|アクティビティ '%1' で CacheRootMetadata が停止されました。|WFRuntime|  
+|[2029 \- CompileVbExpressionStop](../../../docs/framework/windows-workflow-foundation//2029-compilevbexpressionstop.md)|Verbose|VB 式のコンパイルを完了しました。|WFRuntime|  
+|[2576 \- TryCatchExceptionFromTry](../../../docs/framework/windows-workflow-foundation//2576-trycatchexceptionfromtry.md)|情報|TryCatch アクティビティ '%1' は型 '%2' の例外をキャッチしました。|WFActivities|  
+|[2577 \- TryCatchExceptionDuringCancelation](../../../docs/framework/windows-workflow-foundation//2577-trycatchexceptionduringcancelation.md)|警告|TryCatch アクティビティ '%1' の子アクティビティが取り消し中に例外をスローしました。|WFActivities|  
+|[2578 \- TryCatchExceptionFromCatchOrFinally](../../../docs/framework/windows-workflow-foundation//2578-trycatchexceptionfromcatchorfinally.md)|警告|TryCatch アクティビティ '%1' に関連付けられている Catch または Finally アクティビティは例外をスローしました。|WFActivities|  
+|[3501 \- InferredContractDescription](../../../docs/framework/windows-workflow-foundation//3501-inferredcontractdescription.md)|情報|Name\='%1'、Namespace\='%2' の ContractDescription が WorkflowService から推論されました。|WFServices|  
+|[3502 \- InferredOperationDescription](../../../docs/framework/windows-workflow-foundation//3502-inferredoperationdescription.md)|情報|コントラクト '%2' 内の Name\='%1' の OperationDescription が WorkflowService から推論されました。IsOneWay\=%3。|WFServices|  
+|[3503 \- DuplicateCorrelationQuery](../../../docs/framework/windows-workflow-foundation//3503-duplicatecorrelationquery.md)|警告|重複する CorrelationQuery が Where\='%1 で見つかりました。この重複するクエリは相関関係の計算では使用されません。|WFServices|  
+|[3507 \- ServiceEndpointAdded](../../../docs/framework/windows-workflow-foundation//3507-serviceendpointadded.md)|情報|アドレス '%1'、バインド '%2'、およびコントラクト '%3' のサービス エンドポイントが追加されました。|WFServices|  
+|[3508 \- TrackingProfileNotFound](../../../docs/framework/windows-workflow-foundation//3508-trackingprofilenotfound.md)|Verbose|ActivityDefinitionId '%2' の TrackingProfile '%1' が見つかりません。TrackingProfile が構成ファイルにないか、ActivityDefinitionId が一致しないかのいずれかです。|WFServices|  
+|[3550 \- BufferOutOfOrderMessageNoInstance](../../../docs/framework/windows-workflow-foundation//3550-bufferoutofordermessagenoinstance.md)|情報|操作 '%1' は現時点では実行できません。サービス インスタンスがこの特定の操作を処理できるようになったときにもう一度実行されます。|WFServices|  
+|[3551 \- BufferOutOfOrderMessageNoBookmark](../../../docs/framework/windows-workflow-foundation//3551-bufferoutofordermessagenobookmark.md)|情報|サービス インスタンス '%1' での操作 '%2' は現時点では実行できません。サービス インスタンスがこの特定の操作を処理できるようになったときにもう一度実行されます。|WFServices|  
+|[3552 \- MaxPendingMessagesPerChannelExceeded](../../../docs/framework/windows-workflow-foundation//3552-maxpendingmessagesperchannelexceeded.md)|警告|スロットル 'MaxPendingMessagesPerChannel' 制限 '%1' に達しました。この制限を引き上げるには、BufferedReceiveServiceBehavior の MaxPendingMessagesPerChannel プロパティを調整してください。|クォータ WFServices|  
+|[3557 \- TransactedReceiveScopeEndCommitFailed](../../../docs/framework/windows-workflow-foundation//3557-transactedreceivescopeendcommitfailed.md)|情報|id \= '%1' の CommittableTransaction への EndCommit の呼び出しで、TransactionException が次のメッセージ: '%2' と共にスローされました。|WFServices|  
+|[4201 \- EndSqlCommandExecute](../../../docs/framework/windows-workflow-foundation//4201-endsqlcommandexecute.md)|Verbose|SQL コマンドの実行を終了します: %1|WFInstanceStore|  
+|[4202 \- StartSqlCommandExecute](../../../docs/framework/windows-workflow-foundation//4202-startsqlcommandexecute.md)|Verbose|SQL コマンドの実行を開始します: %1|WFInstanceStore|  
+|[4203 \- RenewLockSystemError](../../../docs/framework/windows-workflow-foundation//4203-renewlocksystemerror.md)|Error|ロックの有効期限を延長できませんでした。ロックの有効期限がすでに過ぎているか、ロックの所有者が削除されました。SqlWorkflowInstanceStore を中止します。|WFInstanceStore|  
+|[4205 \- FoundProcessingError](../../../docs/framework/windows-workflow-foundation//4205-foundprocessingerror.md)|Error|コマンドが失敗しました: %1|WFInstanceStore|  
+|[4206 \- UnlockInstanceException](../../../docs/framework/windows-workflow-foundation//4206-unlockinstanceexception.md)|Error|インスタンスのロックを解除しようとしたときに例外 %1 が発生しました。|WFInstanceStore|  
+|[4207 \- MaximumRetriesExceededForSqlCommand](../../../docs/framework/windows-workflow-foundation//4207-maximumretriesexceededforsqlcommand.md)|情報|SQL コマンドが最大回数試行されたので、SQL コマンドの再試行を停止します。|クオータ WFInstanceStore|  
+|[4208 \- RetryingSqlCommandDueToSqlError](../../../docs/framework/windows-workflow-foundation//4208-retryingsqlcommandduetosqlerror.md)|情報|SQL エラー番号 %1 のため、SQL コマンドを再試行します。|WFInstanceStore|  
+|[4209 \- TimeoutOpeningSqlConnection](../../../docs/framework/windows-workflow-foundation//4209-timeoutopeningsqlconnection.md)|Error|SQL 接続を開こうとしてタイムアウトが発生しました。割り当てられたタイムアウト時間 %1 内に、この操作は完了しませんでした。この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。|WFInstanceStore|  
+|[4210 \- SqlExceptionCaught](../../../docs/framework/windows-workflow-foundation//4210-sqlexceptioncaught.md)|警告|SQL 例外番号 %1 メッセージ %2 がキャッチされました。|WFInstanceStore|  
+|[4211 \- QueuingSqlRetry](../../../docs/framework/windows-workflow-foundation//4211-queuingsqlretry.md)|警告|SQL の再試行を %1 ミリ秒の遅延でキューに登録します。|WFInstanceStore|  
+|[4212 \- LockRetryTimeout](../../../docs/framework/windows-workflow-foundation//4212-lockretrytimeout.md)|警告|インスタンスのロックを取得しようとしてタイムアウトが発生しました。%1 の割り当てられたタイムアウト時間内に操作が完了しませんでした。この操作に割り当てられた時間は、より長いタイムアウト時間の一部であった可能性があります。|WFInstanceStore|  
+|[4213 \- RunnableInstancesDetectionError](../../../docs/framework/windows-workflow-foundation//4213-runnableinstancesdetectionerror.md)|Error|次の例外のため、実行可能なインスタンスの検出に失敗しました|WFInstanceStore|  
+|[4214 \- InstanceLocksRecoveryError](../../../docs/framework/windows-workflow-foundation//4214-instancelocksrecoveryerror.md)|Error|次の例外のため、インスタンス ロックの回復に失敗しました|WFInstanceStore|  
+|[39456 \- TrackingRecordDropped](../../../docs/framework/windows-workflow-foundation//39456-trackingrecorddropped.md)|警告|追跡レコード %1 のサイズが、プロバイダー %2 の ETW セッションで許可されている最大サイズを超えています|WFTracking|  
+|[39457 \- TrackingRecordRaised](../../../docs/framework/windows-workflow-foundation//39457-trackingrecordraised.md)|情報|追跡レコード %1 が %2 に引き上げられました。|WFRuntime|  
+|[39458 \- TrackingRecordTruncated](../../../docs/framework/windows-workflow-foundation//39458-trackingrecordtruncated.md)|警告|プロバイダー %2 でセッション ETW に書き込まれた追跡レコード %1 が切り捨てられました。変数\/注釈\/ユーザー データは削除されました|WFTracking|  
+|[39459 \- TrackingDataExtracted](../../../docs/framework/windows-workflow-foundation//39459-trackingdataextracted.md)|Verbose|追跡データ %1 はアクティビティ %2 で展開されました。|WFRuntime|  
+|[39460 \- TrackingValueNotSerializable](../../../docs/framework/windows-workflow-foundation//39460-trackingvaluenotserializable.md)|警告|展開された引数\/変数 '%1' はシリアル化できません。|WFTracking|  
+|[57398 \- MaxInstancesExceeded](../../../docs/framework/windows-workflow-foundation//57398-maxinstancesexceeded.md)|警告|システムはスロットル 'MaxConcurrentInstances' に設定された制限値に達しました。スロットルの制限値は %1 に設定されました。スロットル値は、属性 serviceThrottle 要素の 'maxConcurrentInstances' を変更するか、動作 ServiceThrottlingBehavior の 'MaxConcurrentInstances' プロパティを変更することによって変更できます。|WFServices|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/tracking-participants.md b/docs/framework/windows-workflow-foundation/tracking-participants.md
new file mode 100644
index 00000000000..4f47229a07d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/tracking-participants.md
@@ -0,0 +1,151 @@
+---
+title: "追跡参加要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: f13e360c-eeb7-4a49-98a0-8f6a52d64f68
+caps.latest.revision: 24
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 24
+---
+# 追跡参加要素
+追跡参加要素は、ワークフロー開発者が <xref:System.Activities.Tracking.InteropTrackingRecord.TrackingRecord%2A> オブジェクトにアクセスし、そのオブジェクトを処理する機能拡張ポイントです。  [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、追跡レコードを Event Tracing for Windows \(ETW\) イベントとして書き込む標準の追跡参加要素が含まれています。  これで要件が満たされない場合は、カスタムの追跡参加要素を作成することもできます。  
+  
+## 追跡参加要素  
+ 追跡インフラストラクチャを使用すると、送信の追跡レコードにフィルターを適用して、参加要素からレコードのサブセットに定期受信できるようになります。  フィルターを適用するメカニズムは、追跡プロファイルを通して行われます。  
+  
+ [!INCLUDE[wf](../../../includes/wf-md.md)] の [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] には、追跡レコードを ETW セッションに書き込む追跡参加要素が用意されています。  参加要素は、追跡固有の動作を構成ファイルに追加することによって、ワークフロー サービスで構成されます。  ETW 追跡参加要素を有効にすると、追跡レコードをイベント ビューアーで表示できます。  ETW ベースの追跡用の SDK のサンプルを使用すると、ETW ベースの追跡参加要素を使用した WF の追跡を理解するうえで便利です。  
+  
+## ETW 追跡参加要素  
+ [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] には、追跡レコードを ETW セッションに書き込む ETW 追跡参加要素が含まれています。  これは、アプリケーションのパフォーマンスやサーバーのスループットに与える影響を最小限に抑えたまま、非常に効率的な方法で実行されます。  標準の ETW 追跡参加要素を使用する利点は、受信する追跡レコードを他のアプリケーションや Windows イベント ビューアーのシステム ログで表示できることです。  
+  
+ 次の例に示すように、標準の ETW 追跡参加要素は Web.config ファイルで構成されます。  
+  
+```  
+<configuration>  
+  <system.web>  
+    <compilation debug="true" targetFramework="4.0" />  
+  </system.web>  
+  <system.serviceModel>  
+    <behaviors>  
+      <serviceBehaviors>  
+        <behavior>  
+          <etwTracking profileName="Sample Tracking Profile"/>  
+        </behavior>  
+      </serviceBehaviors>  
+    </behaviors>  
+   <tracking>  
+      <profiles>  
+        <trackingProfile name="Sample Tracking Profile">  
+        ….  
+       </trackingProfile>  
+      </profiles>  
+    </tracking>  
+  </system.serviceModel>  
+</configuration>  
+```  
+  
+> [!NOTE]
+>  `trackingProfile` または `<etwTracking/>` のように `<etwTracking profileName=""/>` の名前が指定されていない場合、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] と一緒にインストールされている Machine.config ファイルにある既定の追跡プロファイルが使用されます。  
+  
+ Machine.config ファイルでは、既定の追跡プロファイルはワークフロー インスタンスのレコードとエラーに定期受信されています。  
+  
+ ETW では、イベントはプロバイダー ID を使用して ETW セッションに書き込まれます。  ETW 追跡参加要素が追跡レコードを ETW に書き込むのに使用するプロバイダー ID は、Web.config ファイルの診断セクション \(`<system.serviceModel><diagnostics>` の下\) に定義されます。  既定では、プロバイダー ID が指定されていない場合、次の例に示すように ETW 追跡参加要素は既定のプロバイダー ID を使用します。  
+  
+```  
+<system.serviceModel>  
+        <diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />  
+```  
+  
+ 次の図は、ETW 追跡参加要素を使用した追跡データ フローを示しています。  追跡データは、ETW セッションに到達すると、さまざまな方法でアクセスできます。  これらのイベントにアクセスする最も便利な方法の 1 つはイベント ビューアーを使用することです。イベント ビューアーは、アプリケーションやサービスのログを表示して追跡する Windows の一般的なツールです。  
+  
+ ![追跡のフローと ETW 追跡プロバイダー](../../../docs/framework/windows-workflow-foundation//media/trackingdatathroughetwparticipant.gif "TrackingDatathroughETWParticipant")  
+  
+## 追跡参加要素のイベント データ  
+ 追跡参加要素は、追跡レコードごとに 1 つのイベントという形式で、ETW セッションに追跡イベント データをシリアル化します。  イベントは、100 ～ 199 までの範囲内の ID を使用して識別されます。  追跡参加要素によって出力される追跡イベント レコードの定義については、「[追跡イベントのリファレンス](../../../docs/framework/windows-workflow-foundation//tracking-events-reference.md)」のトピックを参照してください。  
+  
+ ETW イベントのサイズは、ETW バッファーのサイズまたは ETW イベントの最大ペイロードのいずれか小さいほうの値に制限されます。  イベントのサイズが ETW のどちらかの制限を超えると、イベントが切り捨てられ、任意の方法でその内容が削除されます。  変数、引数、注釈、およびカスタム データは選択的に削除されません。  切り捨てが発生する場合は、イベント サイズが ETW の制限を超える原因となった値にかかわらず、これらのすべてが切り捨てられます。  削除されたデータは、`<item>..<item>` で置き換えられます。  
+  
+ 変数、引数、およびカスタム データ項目の複雑な型は、[NetDataContractSerializer クラス](http://go.microsoft.com/fwlink/?LinkId=177537)を使用して ETW イベント レコードにシリアル化されます。  このクラスでは、シリアル化された XML ストリームに CRL 型情報が含まれます。  
+  
+ ETW の制限によってペイロード データが切り捨てられると、ETW セッションに送信される追跡レコードの重複が生じる可能性があります。  このような状況は、複数のセッションがイベントをリッスンしており、セッションがそのイベントに対して異なるペイロードの制限を持っている場合に発生します。  
+  
+ セッションの制限が緩い場合、そのイベントが切り捨てられる可能性があります。  あるセッションのイベントが切り捨てられ、ETW の参加要素がイベントの送信を 1 回再試行する場合、ETW 追跡参加要素はイベントをリッスンしているセッション数を把握していません。  このような場合、より大きなペイロード サイズを受け入れるように設定されているセッションがそのイベントを 2 回取得します \(切り捨てられていないイベントと切り捨てられたイベント\)。  すべての ETW セッションが同じバッファー サイズの制限を持つように設定すると、重複を防ぐことができます。  
+  
+## イベント ビューアーでの ETW 追跡参加要素の追跡データへのアクセス  
+ ETW 追跡参加要素によって ETW セッションに書き込まれたイベントは、イベント ビューアーからアクセスできます \(既定のプロバイダー ID を使用している場合\)。  これによって、ワークフローが出力した追跡レコードをすぐに表示できます。  
+  
+> [!NOTE]
+>  ETW セッションに出力された追跡レコード イベントでは、100 ～ 199 の範囲のイベント ID を使用します。  
+  
+#### イベント ビューアーで追跡レコードの表示を有効にするには  
+  
+1.  イベント ビューアー \(EVENTVWR.EXE\) を起動します。  
+  
+2.  **\[イベント ビューアー\]、\[アプリケーションとサービス ログ\]、\[Microsoft\]、\[Windows\]、\[アプリケーション サーバー \- アプリケーション\]** の順に選択します。  
+  
+3.  右クリックして、**\[表示\]、\[分析およびデバッグ ログの表示\]** の順にクリックします。  有効でない場合は、ログを選択するとログの横にチェック マークが表示されます。  これは **\[分析\]**、**\[Perf\]** と **\[デバッグ\]** のログを表示します。  
+  
+4.  **\[分析\]** ログを右クリックし、**\[ログを有効にする\]** を選択します。  ログは %SystemRoot%\\System32\\Winevt\\Logs\\Microsoft\-Windows\-Application Server\-Applications%4Analytic.etl ファイルに含まれます。  
+  
+## カスタムの追跡参加要素  
+ 追跡参加要素 API では、ワークフロー ランタイムが出力する追跡レコードを処理するためのカスタム ロジックを含めることが可能なユーザー指定の追跡参加要素を使用して、追跡ランタイムを拡張できます。  カスタムの追跡参加要素を作成するためには、開発者が `Track` クラスの <xref:System.Activities.Tracking.TrackingParticipant> メソッドを実装する必要があります。  このメソッドは、ワークフロー ランタイムによって追跡レコードが出力されるときに呼び出されます。  
+  
+ 追跡参加要素は <xref:System.Activities.Tracking.TrackingParticipant> クラスから派生します。  システムによって提供される <xref:System.Activities.Tracking.EtwTrackingParticipant> は、受信する追跡レコードごとに Event Tracking for Windows \(ETW\) イベントを出力します。  カスタムの追跡参加要素を作成するには、<xref:System.Activities.Tracking.TrackingParticipant> の派生クラスを作成します。  基本的な追跡機能を提供するには、<xref:System.Activities.Tracking.TrackingParticipant.Track%2A> をオーバーライドします。  <xref:System.Activities.Tracking.TrackingParticipant.Track%2A> は、ランタイムによって追跡レコードが送信されるときに呼び出され、必要な方法で処理できます。  次の例では、すべての追跡レコードをコンソール ウィンドウに出力するカスタムの追跡参加要素クラスを定義します。  また、<xref:System.Activities.Tracking.TrackingParticipant> および `BeginTrack` メソッドを使用して、非同期で追跡レコードを処理する `EndTrack` オブジェクトを実装することもできます。  
+  
+```csharp  
+class ConsoleTrackingParticipant : TrackingParticipant  
+{  
+    protected override void Track(TrackingRecord record, TimeSpan timeout)  
+    {  
+        if (record != null)  
+        {  
+            Console.WriteLine("=================================");  
+            Console.WriteLine(record);  
+        }  
+    }  
+}  
+```  
+  
+ 特定の追跡参加要素を使用するには、次の例に示すように、追跡するワークフロー インスタンスに追跡参加要素を登録します。  
+  
+```csharp  
+myInstance.Extensions.Add(new ConsoleTrackingParticipant());  
+```  
+  
+ 次の例では、<xref:System.Activities.Statements.Sequence> アクティビティを含む <xref:System.Activities.Statements.WriteLine> アクティビティから成るワークフローを作成します。  `ConsoleTrackingParticipant` が拡張機能に追加され、ワークフローが呼び出されます。  
+  
+```csharp  
+Activity activity= new Sequence()  
+{  
+    Activities =  
+    {  
+        new WriteLine()  
+        {  
+            Text = "Hello World."  
+        }  
+    }  
+};  
+  
+WorkflowApplication instance = new WorkflowApplication(activity);  
+  
+instance.Extensions.Add(new ConsoleTrackingParticipant());  
+  instance.Completed = delegate(WorkflowApplicationCompletedEventArgs e)  
+            {  
+                Console.WriteLine("workflow instance completed, Id = " + instance.Id);  
+                resetEvent.Set();  
+            };  
+            instance.Run();  
+            Console.ReadLine();  
+  
+```  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/tracking-profiles.md b/docs/framework/windows-workflow-foundation/tracking-profiles.md
new file mode 100644
index 00000000000..55014800638
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/tracking-profiles.md
@@ -0,0 +1,412 @@
+---
+title: "追跡プロファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 22682566-1cd9-4672-9791-fb3523638e18
+caps.latest.revision: 21
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 21
+---
+# 追跡プロファイル
+追跡プロファイルには、実行時にワークフロー インスタンスの状態が変化したときに生成されるワークフロー イベントを追跡参加要素が定期受信することを可能にする追跡クエリが含まれています。  
+  
+## 追跡プロファイル  
+ 追跡プロファイルは、どの追跡情報をワーク フロー インスタンスに出力するか指定するために使用されます。プロファイルが指定されていない場合、すべての追跡イベントが出力されます。プロファイルを指定した場合、プロファイルで指定された追跡イベントが出力されます。監視の要件に応じて、ワークフローの主な状態変化の少数のセットを定期受信する、非常に一般的なプロファイルを作成できます。それとは反対に、結果として得られるイベントが、後で詳細な実行フローを十分に再構築できる極めて詳細なプロファイルを作成することもできます。  
+  
+ 追跡プロファイルは、標準の [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] 構成ファイル内の XML 要素や、コードで指定される XML 要素として出現します。追跡参加要素が `Started` と `Completed` のワークフロー イベントを定期受信できるようにする構成ファイルの [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] 追跡プロファイルの例を次に示します。  
+  
+```  
+<system.serviceModel>  
+    ...  
+    <tracking>    
+      <trackingProfile name="Sample Tracking Profile">  
+        <workflow activityDefinitionId="*">  
+          <workflowInstanceQueries>  
+            <workflowInstanceQuery>  
+              <states>  
+                <state name="Started"/>  
+                <state name="Completed"/>  
+              </states>  
+            </workflowInstanceQuery>  
+          </workflowInstanceQueries>  
+        </workflow>  
+      </trackingProfile>          
+    </profiles>  
+  </tracking>  
+    ...  
+</system.serviceModel>  
+  
+```  
+  
+ 次の例では、コードを使用して作成された同等の追跡プロファイルを示します。  
+  
+```csharp  
+TrackingProfile profile = new TrackingProfile()  
+{  
+    Name = "CustomTrackingProfile",  
+    Queries =   
+    {  
+        new WorkflowInstanceQuery()  
+        {  
+            // Limit workflow instance tracking records for started and  
+            // completed workflow states.  
+            States = { WorkflowInstanceStates.Started, WorkflowInstanceStates.Completed },  
+        }  
+    }  
+};  
+  
+```  
+  
+ 追跡レコードは、<xref:System.Activities.Tracking.ImplementationVisibility> 属性を使用して、追跡プロファイル内部の表示モードを通じてフィルター処理されます。複合アクティビティは、その実装を形成する他のアクティビティを含む最上位アクティビティです。表示モードは、実装を形成するアクティビティが追跡されているかどうかを指定するために、ワークフロー アクティビティ内の複合アクティビティから生成された追跡レコードを指定します。表示モードは、追跡プロファイル レベルで適用されます。ワークフロー内にある個々のアクティビティの追跡レコードのフィルター処理は、追跡プロファイル内のクエリによって制御されます。詳細については、このドキュメントで後述される「**プロファイルのクエリの型の追跡**」を参照してください。  
+  
+ 追跡プロファイルの `implementationVisibility` 属性で指定される 2 つの表示モードは、`RootScope` と `All` です。`RootScope` モードを使用すると、複合アクティビティがワークフローのルート アクティビティでない場合にアクティビティの実装を形成するアクティビティの追跡レコードが抑制されます。したがって、他のアクティビティを使用して実装されているアクティビティがワークフローに追加された場合、`implementationVisibility` が RootScope に設定されていると、その複合アクティビティ内の最上位アクティビティのみが追跡されます。アクティビティがワークフローのルート アクティビティである場合、アクティビティの実装はワークフローそのものであり、追跡レコードはその実装を形成するアクティビティを対象として生成されます。All モードを使用すると、ルート アクティビティとそのすべての複合アクティビティを対象として、すべての追跡レコードを生成できます。  
+  
+ たとえば、*MyActivity* は *Activity1* と *Activity2* の 2 つのアクティビティが実装に含まれている複合アクティビティである、とします。この複合アクティビティがワークフローに追加され、`implementationVisibility` が `RootScope` に設定された追跡プロファイルで追跡が有効化されると、追跡レコードは *MyActivity* のみを対象として生成されます。しかし、*Activity1* と *Activity2* の各アクティビティについてはレコードは生成されません。  
+  
+ これに対して、追跡プロファイルの `implementationVisisbility` 属性が `All` に設定されている場合は、*MyActivity* だけでなく、*Activity1* と *Activity2* の各アクティビティについても、追跡レコードが生成されます。  
+  
+ `implementationVisibility` フラグは、次の追跡レコード タイプに適用されます。  
+  
+-   ActivityStateRecord  
+  
+-   FaultPropagationRecord  
+  
+-   CancelRequestedRecord  
+  
+-   ActivityScheduledRecord  
+  
+> [!NOTE]
+>  アクティビティの実装から生成される CustomTrackingRecords は、implementationVisibility 設定によるフィルター処理で除外されません。  
+  
+ `implementationVisibility` 機能は、次のようにコードの追跡プロファイルで <xref:System.Activities.Tracking.ImplementationVisibility> と指定されます。  
+  
+```  
+TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+{  
+    Name = "Sample Tracking Profile",  
+    ImplementationVisibility = ImplementationVisibility.RootScope  
+};  
+  
+```  
+  
+ The `implementationVisibility` 機能の指定は、次のように構成ファイルの追跡プロファイルで <xref:System.Activities.Tracking.ImplementationVisibility> として指定されます。  
+  
+```  
+<tracking>  
+      <profiles>  
+        <trackingProfile name="Shipping Monitoring" implementationVisibility="All">  
+          <workflow activityDefinitionId="*">  
+...  
+         </workflow>  
+        </trackingProfile>  
+      </profiles>  
+</tracking>  
+  
+```  
+  
+ 追跡プロファイルの `ImplementationVisibility` 設定は必要に応じて行います。既定では、この値は `RootScope` に設定されます。この属性の値も、大文字と小文字が区別されます。  
+  
+### プロファイルのクエリの型の追跡  
+ 追跡プロファイルは、特定の追跡レコードを対象としてワークフロー ランタイムをクエリすることができる追跡レコードの宣言型のサブスクリプションとして構築されます。クエリには、<xref:System.Activities.Tracking.TrackingRecord> オブジェクトのさまざまなクラスを定期受信できる型がいくつかあります。追跡プロファイルは、構成で指定したり、コードで指定したりすることができます。最も一般的なクエリの型は次のとおりです。  
+  
+-   <xref:System.Activities.Tracking.WorkflowInstanceQuery> \- 前に説明した `Started` や `Completed` など、ワークフロー インスタンスのライフサイクルの変化を追跡するために使用します。<xref:System.Activities.Tracking.WorkflowInstanceQuery> は、次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの定期受信に使用されます。  
+  
+    -   <xref:System.Activities.Tracking.WorkflowInstanceRecord>  
+  
+    -   <xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>  
+  
+    -   <xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>  
+  
+    -   <xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>  
+  
+    -   <xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>  
+  
+     定期受信可能な状態は、<xref:System.Activities.Tracking.WorkflowInstanceStates> クラスで指定します。  
+  
+     <xref:System.Activities.Tracking.WorkflowInstanceQuery> を使用して `Started` インスタンス状態のワークフロー インスタンス レベルの追跡レコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <workflowInstanceQueries>  
+        <workflowInstanceQuery>  
+          <states>  
+            <state name="Started"/>  
+          </states>  
+        </workflowInstanceQuery>  
+    </workflowInstanceQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =   
+        {  
+            new WorkflowInstanceQuery()  
+            {  
+                States = { WorkflowInstanceStates.Started}                                                                     
+            }  
+        }  
+    };  
+  
+    ```  
+  
+-   <xref:System.Activities.Tracking.ActivityStateQuery> \- ワークフロー インスタンスを構成するアクティビティのライフ サイクルの変化を追跡するために使用します。たとえば、ワークフロー インスタンスの "電子メール送信" アクティビティの完了を毎回追跡する必要がある場合があります。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.ActivityStateRecord> オブジェクトを定期受信するのに必要です。定期受信可能な状態は <xref:System.Activities.Tracking.ActivityStates> で指定します。  
+  
+     `SendEmailActivity` アクティビティに <xref:System.Activities.Tracking.ActivityStateQuery> を使用するアクティビティ状態の追跡レコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <activityStateQueries>  
+      <activityStateQuery activityName="SendEmailActivity">  
+        <states>  
+          <state name="Closed"/>  
+        </states>  
+      </activityStateQuery>  
+    </activityStateQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =  
+        {  
+            new ActivityStateQuery()  
+            {                              
+                ActivityName = "SendEmailActivity",  
+                States = { ActivityStates.Closed }  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+    > [!NOTE]
+    >  複数の activityStateQuery 要素が同じ名前である場合、最後の要素の状態のみが追跡プロファイルで使用されます。  
+  
+-   <xref:System.Activities.Tracking.ActivityScheduledQuery> \- このクエリを使用すると、親アクティビティによって実行がスケジュールされているアクティビティを追跡できます。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.ActivityScheduledRecord> オブジェクトを定期受信するのに必要です。  
+  
+     <xref:System.Activities.Tracking.ActivityScheduledQuery> を使用して、スケジュールされている `SendEmailActivity` 子アクティビティに関連するレコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <activityScheduledQueries>  
+      <activityScheduledQuery activityName="ProcessNotificationsActivity" childActivityName="SendEmailActivity" />  
+     </activityScheduledQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =   
+        {  
+            new ActivityScheduledQuery()  
+            {  
+                ActivityName = "ProcessNotificationsActivity",  
+                ChildActivityName = "SendEmailActivity"  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+-   <xref:System.Activities.Tracking.FaultPropagationQuery> \- アクティビティ内で発生したエラーの処理を追跡するために使用します。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.FaultPropagationRecord> オブジェクトを定期受信するのに必要です。  
+  
+     <xref:System.Activities.Tracking.FaultPropagationQuery> を使用して、エラー伝達に関連するレコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <faultPropagationQueries>  
+      <faultPropagationQuery faultSourceActivityName="SendEmailActivity" faultHandlerActivityName="NotificationsFaultHandler" />  
+    </faultPropagationQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =  
+        {  
+            new FaultPropagationQuery()  
+            {  
+                FaultSourceActivityName = "SendEmailActivity",  
+                FaultHandlerActivityName = "NotificationsFaultHandler"  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+-   <xref:System.Activities.Tracking.CancelRequestedQuery> \- 親アクティビティによって子アクティビティをキャンセルする要求を追跡するために使用されます。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.CancelRequestedRecord> オブジェクトを定期受信するのに必要です。  
+  
+     <xref:System.Activities.Tracking.CancelRequestedQuery> を使用して、アクティビティのキャンセルに関連するレコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <cancelRequestedQueries>  
+      <cancelRequestedQuery activityName="ProcessNotificationsActivity" childActivityName="SendEmailActivity" />  
+    </cancelRequestedQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =   
+        {  
+            new CancelRequestedQuery()  
+            {  
+                ActivityName = "ProcessNotificationsActivity",  
+                ChildActivityName = "SendEmailActivity"  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+-   <xref:System.Activities.Tracking.CustomTrackingQuery> \- コード アクティビティで定義するイベントを追跡するために使用します。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.CustomTrackingRecord> オブジェクトを定期受信するのに必要です。  
+  
+     <xref:System.Activities.Tracking.CustomTrackingQuery> を使用して、カスタム追跡レコードに関連するレコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <customTrackingQueries>  
+      <customTrackingQuery name="EmailAddress" activityName="SendEmailActivity" />  
+    </customTrackingQueries>  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =   
+        {  
+            new CustomTrackingQuery()   
+            {  
+                Name = "EmailAddress",  
+                ActivityName = "SendEmailActivity"  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+-   <xref:System.Activities.Tracking.BookmarkResumptionQuery> \- ワークフロー インスタンス内のブックマークの再開を追跡するために使用します。このクエリは、<xref:System.Activities.Tracking.TrackingParticipant> が <xref:System.Activities.Tracking.BookmarkResumptionRecord> オブジェクトを定期受信するのに必要です。  
+  
+     <xref:System.Activities.Tracking.BookmarkResumptionQuery> を使用して、ブックマークの再開に関連するレコードを定期受信するために使用される構成またはコードを、次の例に示します。  
+  
+    ```  
+    <bookmarkResumptionQueries>  
+      <bookmarkResumptionQuery name="SentEmailBookmark" />  
+    </bookmarkResumptionQueries>  
+  
+    ```  
+  
+    ```  
+    TrackingProfile sampleTrackingProfile = new TrackingProfile()  
+    {  
+        Name = "Sample Tracking Profile",  
+        Queries =   
+        {  
+            new BookmarkResumptionQuery()  
+            {  
+                Name = "sentEmailBookmark"  
+            }  
+        }  
+    };  
+  
+    ```  
+  
+### 注釈  
+ 注釈を使用すると、ビルド後に構成できる値を使用して、追跡レコードへのタグ付けを任意に行うことができます。たとえば、複数のワークフローに存在する複数の追跡レコードに、"Mail Server" \=\= "Mail Server1" というタグを付けることができます。こうすると、後で追跡レコードのクエリを実行するときに、このタグの付いたすべてのレコードを簡単に見つけることができます。  
+  
+ これを可能にするために、次の例に示すように注釈が追跡クエリに追加されます。  
+  
+```  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <annotations>  
+    <annotation name="MailServer" value="Mail Server1"/>  
+  </annotations>  
+</activityStateQuery>  
+  
+```  
+  
+### 追跡プロファイルを作成する方法  
+ 追跡クエリ要素を使用することで、XML 構成ファイル、または [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] のコードを使用した追跡プロファイルを作成できます。次の例は、構成ファイルを使用して作成した追跡プロファイルです。  
+  
+```  
+<system.serviceModel>  
+  <tracking>  
+    <profiles>  
+      <trackingProfile name="Sample Tracking Profile ">  
+        <workflow activityDefinitionId="*">  
+          <!--Specify the tracking profile query elements to subscribe for tracking records-->  
+        </workflow>  
+      </trackingProfile>  
+    </profiles>  
+  </tracking>  
+</system.serviceModel>  
+  
+```  
+  
+> [!WARNING]
+>  ワークフロー サービス ホストを使用する WF の場合、追跡プロファイルは構成ファイルを使用して作成されることがほとんどです。また、追跡プロファイルや追跡クエリ API を使用するコードで追跡プロファイルを作成することも可能です。  
+  
+ XML 構成ファイルとして構成されるプロファイルは、動作拡張を使用して追跡参加要素に適用されます。後のセクション「[ワークフローの追跡の構成](../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)」で説明されているように、これは WorkflowServiceHost に追加されます。  
+  
+ ホストが生成する追跡レコードの詳細度は、追跡プロファイルの構成の設定によって決まります。追跡参加要素は、クエリを追跡プロファイルに追加して追跡レコードを定期受信します。すべての追跡レコードを定期受信するためには、追跡プロファイルにおいて各クエリの名前フィールドで “\*” を使用し、すべての追跡クエリを指定する必要があります。  
+  
+ 一般的な追跡プロファイルの例を次に示します。  
+  
+-   ワークフロー インスタンスのレコードとエラーを取得する追跡プロファイル  
+  
+```  
+<trackingProfile name="Instance and Fault Records">  
+  <workflow activityDefinitionId="*">  
+    <workflowInstanceQueries>  
+      <workflowInstanceQuery>  
+        <states>  
+          <state name="*" />  
+        </states>  
+      </workflowInstanceQuery>  
+    </workflowInstanceQueries>  
+    <activityStateQueries>  
+      <activityStateQuery activityName="*">  
+        <states>  
+          <state name="Faulted"/>  
+        </states>  
+      </activityStateQuery>  
+    </activityStateQueries>  
+  </workflow>  
+</trackingProfile>  
+  
+```  
+  
+1.  すべてのカスタム追跡レコードを取得する追跡プロファイル  
+  
+```  
+<trackingProfile name="Instance_And_Custom_Records">  
+  <workflow activityDefinitionId="*">  
+    <customTrackingQueries>  
+      <customTrackingQuery name="*" activityName="*" />  
+    </customTrackingQueries>  
+  </workflow>  
+</trackingProfile>  
+  
+```  
+  
+## 参照  
+ [SQL 追跡](../../../docs/framework/windows-workflow-foundation/samples/sql-tracking.md)   
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/tracking-records.md b/docs/framework/windows-workflow-foundation/tracking-records.md
new file mode 100644
index 00000000000..2a55ebcf374
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/tracking-records.md
@@ -0,0 +1,70 @@
+---
+title: "追跡レコード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 51adbda3-bd8b-4892-a8ea-d343186472d2
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# 追跡レコード
+ワークフロー ランタイムは、ワークフロー インスタンスの実行状況を追跡する追跡レコードを出力するためにインストルメント化されています。  
+  
+## 追跡レコード  
+ 次の表で、ワークフロー ランタイムが出力する追跡レコードの詳細を説明します。  
+  
+|追跡レコード|説明|  
+|------------|--------|  
+|ワークフロー ライフ サイクル レコード|ワークフロー インスタンスのライフ サイクルの多様なステージ中に出力されます。たとえば、ワークフローの開始時または完了時にレコードは出力されます。|  
+|アクティビティ ライフ サイクル レコード|アクティビティの実行状況を詳しく記録します。これらのレコードは、アクティビティをスケジュールしたとき、アクティビティが完了したとき、エラーが発生したときなど、ワークフロー アクティビティの状態を示します。|  
+|ブックマーク再開レコード|ワークフロー インスタンス内のブックマークが再開されたときに出力されます。|  
+|カスタム追跡レコード|ワークフロー作成者はカスタム追跡レコードを作成し、カスタム アクティビティ内で出力できます。|  
+  
+ WF ランタイムから出力されるすべての追跡関連レコードは、基本クラス <xref:System.Activities.Tracking.TrackingRecord> から派生します。この基本クラスには一般的なデータのセットが含まれます。追跡レコードは、単純なワークフローのライフ サイクルを示します。各追跡レコードには、<xref:System.Activities.Tracking.TrackingRecord.InstanceId%2A>、<xref:System.Activities.Tracking.TrackingRecord.RecordNumber%2A> などの関連する追跡イベント、および追跡レコードの型に固有の追加情報の詳細が含まれます。  
+  
+ 次の <xref:System.Activities.Tracking.TrackingRecord> オブジェクトの型は、ワークフロー ランタイムによって出力されます。  
+  
+-   **WorkflowInstanceRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、ワークフロー インスタンスのライフ サイクルを示します。たとえば、ワークフローの開始時または完了時にレコードが出力されます。また、レコードにはワークフロー インスタンスの状態が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.WorkflowInstanceRecord>」を参照してください。  
+  
+-   **WorkflowInstanceAbortedRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、ワークフロー インスタンスの中止時に出力されます。レコードにはワークフロー インスタンスが中止された理由が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.WorkflowInstanceAbortedRecord>」を参照してください。  
+  
+-   **WorkflowInstanceUnhandledExceptionRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、例外がワークフロー インスタンスで発生し、任意のアクティビティによって処理されない場合に出力されます。レコードには例外の詳細が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord>」を参照してください。  
+  
+-   **WorkflowInstanceSuspendedRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、ワークフロー インスタンスが一時停止されたときに出力されます。レコードにはワークフロー インスタンスが一時停止された理由が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.WorkflowInstanceSuspendedRecord>」を参照してください。  
+  
+-   **WorkflowInstanceTerminatedRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、ワークフロー インスタンスが終了したときに出力されます。レコードにはワークフロー インスタンスが終了した理由が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.WorkflowInstanceTerminatedRecord>」を参照してください。  
+  
+-   **ActivityStateRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、ワークフロー内のアクティビティが実行されたときに出力されます。これらのレコードは、ワークフロー インスタンス内のアクティビティの状態を示します。このレコードの詳細については、「<xref:System.Activities.Tracking.ActivityStateRecord>」を参照してください。  
+  
+-   **ActivityScheduledRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、アクティビティが子のアクティビティをスケジュールするときに出力されます。このレコードには、親のアクティビティ \(スケジューリング アクティビティ\) およびスケジュール設定された子のアクティビティの両方の詳細が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.ActivityScheduledRecord>」を参照してください。  
+  
+-   **FaultPropagationRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、レコードが処理されるまで、レコードを確認するハンドラーごとに出力されます。これは、エラーがワークフロー インスタンス内でたどるパスを示すために使用されます。このレコードの詳細については、「<xref:System.Activities.Tracking.FaultPropagationRecord>」を参照してください。  
+  
+-   **CancelRequestedRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、アクティビティが子のアクティビティを取り消そうとするときに出力されます。このレコードには、親のアクティビティおよび取り消される子のアクティビティの両方の詳細が含まれます。このレコードの詳細については、「<xref:System.Activities.Tracking.CancelRequestedRecord>」を参照してください。  
+  
+-   **BookmarkResumptionRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、正常に再開されるすべてのブックマークを追跡します。このレコードの詳細については、「<xref:System.Activities.Tracking.BookmarkResumptionRecord>」を参照してください。  
+  
+-   **CustomTrackingRecord** \- この <xref:System.Activities.Tracking.TrackingRecord> は、カスタム ワークフロー アクティビティ内のワークフロー作成者によって作成および出力されます。カスタム追跡レコードには、レコードと一緒に出力されるデータを読み込むことができます。このレコードの詳細については、「<xref:System.Activities.Tracking.CustomTrackingRecord>」を参照してください。  
+  
+ たとえば、<xref:System.Activities.Statements.WriteLine> 操作と次の順序で出力された追跡レコードを含む単純な <xref:System.Activities.Statements.Sequence> アクティビティもあります:  
+  
+1.  <xref:System.Activities.Tracking.WorkflowInstanceRecord> は、ワークフローが起動していることを示します。  
+  
+2.  <xref:System.Activities.Tracking.ActivityScheduledRecord> は、アクティビティがスケジュールされたことを示します。この場合は <xref:System.Activities.Statements.Sequence> アクティビティです。  
+  
+3.  <xref:System.Activities.Tracking.ActivityScheduledRecord> は、<xref:System.Activities.Statements.WriteLine> アクティビティを表します。  
+  
+4.  2 つのアクティビティが完了していることを示す 2 つの <xref:System.Activities.Tracking.ActivityStateRecord> レコードがあります。  
+  
+5.  <xref:System.Activities.Tracking.WorkflowInstanceRecord> は、ワークフローが完了していることを示します。  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/transaction-activities-in-wf.md b/docs/framework/windows-workflow-foundation/transaction-activities-in-wf.md
new file mode 100644
index 00000000000..a631cf6dbaa
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/transaction-activities-in-wf.md
@@ -0,0 +1,29 @@
+---
+title: "WF におけるトランザクションのアクティビティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: fb33378e-82c6-4ea0-870f-76dc77e7f0fe
+caps.latest.revision: 10
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 10
+---
+# WF におけるトランザクションのアクティビティ
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には、トランザクションや、補正、取り消しをモデル化するためのシステム指定のアクティビティがいくつかあります。これらのプログラミング モデルにより、ビジネス ロジックとエラー処理の変更の場合に、ワークフローは進行を続けることができます。トランザクション、補正および取り消し[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[トランザクション](../../../docs/framework/windows-workflow-foundation//workflow-transactions.md)」、「[補正](../../../docs/framework/windows-workflow-foundation//compensation.md)」および「[取り消し](../../../docs/framework/windows-workflow-foundation//modeling-cancellation-behavior-in-workflows.md)」を参照してください。  
+  
+## トランザクションのアクティビティ  
+  
+|||  
+|-|-|  
+|<xref:System.Activities.Statements.CancellationScope>|アクティビティの形式のキャンセル ロジックを、アクティビティとしても表される実行のメイン パスに関連付けます。|  
+|<xref:System.Activities.Statements.CompensableActivity>|子アクティビティの補正をサポートします。|  
+|<xref:System.Activities.Statements.Compensate>|<xref:System.Activities.Statements.CompensableActivity> の補正ハンドラーを明示的に呼び出します。|  
+|<xref:System.Activities.Statements.Confirm>|<xref:System.Activities.Statements.CompensableActivity> の確認ハンドラーを明示的に呼び出します。|  
+|<xref:System.Activities.Statements.TransactionScope>|トランザクションの境界を設定します。|  
+|<xref:System.ServiceModel.Activities.TransactedReceiveScope>|受信したメッセージによって開始されるトランザクションの有効期間を制御します。トランザクションは、開始メッセージでワークフローにフローすることも、メッセージの受信時にディスパッチャーが作成することも可能です。 **Note:**  <xref:System.ServiceModel.Activities.TransactedReceiveScope> は、**ツールボックス** の **\[メッセージング\]** セクションにあります。|
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-a-custom-activity.md b/docs/framework/windows-workflow-foundation/using-a-custom-activity.md
new file mode 100644
index 00000000000..e3765ec397f
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-a-custom-activity.md
@@ -0,0 +1,31 @@
+---
+title: "カスタム アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f356419-681a-4175-ae93-878eee970249
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# カスタム アクティビティの使用
+<xref:System.Activities.Activity> またはそのサブクラスから派生するアクティビティは、結合してより大規模なワークフローにしたり、コードで直接作成したりすることができます。このトピックでは、コードまたはデザイナーで作成したワークフロー内でカスタム アクティビティを使用する方法について説明します。  
+  
+> [!NOTE]
+>  カスタム アクティビティは、そのアクティビティが定義されているのと同じプロジェクト内で使用できます。これは、カスタム アクティビティとそのカスタム アクティビティを使用するアクティビティの両方がコンパイルされる \(たとえば、ビルド プロセスで生成された、インスタンス化する型によって読み込まれる\) 場合に限ります。参照しているアクティビティが \(ActivityXAMLServices の使用などによって\) 読み込まれる場合は、参照アセンブリを別のプロジェクトに配置するか、デザイナーで生成される XAML を手作業で編集して参照アセンブリを有効にする必要があります。  
+  
+#### ワークフロー プロジェクトへのカスタム アクティビティの使用  
+  
+1.  ホスト プロジェクトから、カスタム アクティビティを含むアクティビティ ライブラリ プロジェクトへの参照を追加します。  
+  
+2.  ソリューションをビルドします。  
+  
+3.  デザイナーでカスタム アクティビティを使用するには、ツールボックスでカスタム アクティビティを探して、そのアクティビティをデザイナー画面にドラッグします。  
+  
+4.  コード内でカスタム アクティビティを使用するには、カスタム アクティビティ プロジェクトを参照する Using ステートメントを追加し、そのアクティビティの新しいインスタンスを <xref:System.Activities.WorkflowInvoker.Invoke%2A> に渡します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-a-custom-expression-editor.md b/docs/framework/windows-workflow-foundation/using-a-custom-expression-editor.md
new file mode 100644
index 00000000000..5bde00f5fef
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-a-custom-expression-editor.md
@@ -0,0 +1,295 @@
+---
+title: "カスタム式エディターの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 0901b58b-e037-44a8-8281-f6f54361cfca
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# カスタム式エディターの使用
+カスタム式エディターを実装して、式の編集を多機能化したり単純化したりすることができます。たとえば、次のような場合にカスタム式エディターを使用できます。  
+  
+-   再ホストされたワークフロー デザイナーで IntelliSense などの高度な編集機能をサポートする場合。再ホストされたアプリケーションでは [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の既定の式エディターは使用できないため、この機能が必要な場合は提供する必要があります。  
+  
+-   ビジネス アナリスト ユーザーのために式の編集を単純化する場合。これにより、たとえば、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] を学習したり、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の式を扱ったりする必要がなくなります。  
+  
+ カスタム式エディターを実装するには、次の 3 つの基本的な手順を実行する必要があります。  
+  
+1.  <xref:System.Activities.Presentation.View.IExpressionEditorService> インターフェイスを実装します。このインターフェイスは、式エディターの作成と破棄を管理します。  
+  
+2.  <xref:System.Activities.Presentation.View.IExpressionEditorInstance> インターフェイスを実装します。このインターフェイスは、式エディター UI に UI を実装します。  
+  
+3.  再ホストされたワークフロー アプリケーションで <xref:System.Activities.Presentation.View.IExpressionEditorService> を公開します。  
+  
+## クラス ライブラリ内のカスタム式エディターを実装する  
+ 次のコードは、MyExpressionEditorService ライブラリ プロジェクトに含まれている <xref:System.Activities.Presentation.View.IExpressionEditorService> インターフェイスを実装する \(概念実証\) `MyEditorService` クラスのサンプル コードです。  
+  
+```  
+  
+using System;  
+using System.Collections.Generic;  
+using System.Activities.Presentation.View;  
+using System.Activities.Presentation.Hosting;  
+using System.Activities.Presentation.Model;  
+  
+namespace MyExpressionEditorService  
+{  
+    public class MyEditorService : IExpressionEditorService  
+    {  
+        public void CloseExpressionEditors()  
+        {  
+  
+        }  
+        public IExpressionEditorInstance CreateExpressionEditor(AssemblyContextControlItem assemblies, ImportedNamespaceContextItem importedNamespaces, List<ModelItem> variables, string text)  
+        {  
+            MyExpressionEditorInstance instance = new MyExpressionEditorInstance();  
+            return instance;  
+        }  
+        public IExpressionEditorInstance CreateExpressionEditor(AssemblyContextControlItem assemblies, ImportedNamespaceContextItem importedNamespaces, List<ModelItem> variables, string text, System.Windows.Size initialSize)  
+                {  
+            MyExpressionEditorInstance instance = new MyExpressionEditorInstance();  
+            return instance;  
+        }  
+        public IExpressionEditorInstance CreateExpressionEditor(AssemblyContextControlItem assemblies, ImportedNamespaceContextItem importedNamespaces, List<ModelItem> variables, string text, Type expressionType)  
+            {  
+            MyExpressionEditorInstance instance = new MyExpressionEditorInstance();  
+            return instance;  
+        }  
+        public IExpressionEditorInstance CreateExpressionEditor(AssemblyContextControlItem assemblies, ImportedNamespaceContextItem importedNamespaces, List<ModelItem> variables, string text, Type expressionType, System.Windows.Size initialSize)  
+        {  
+            MyExpressionEditorInstance instance = new MyExpressionEditorInstance();  
+            return instance;  
+        }  
+        public void UpdateContext(AssemblyContextControlItem assemblies, ImportedNamespaceContextItem importedNamespaces)  
+        {  
+  
+        }  
+  
+    }  
+}  
+  
+```  
+  
+ これは MyExpressionEditorService ライブラリ プロジェクトに含まれている <xref:System.Activities.Presentation.View.IExpressionEditorInstance> インターフェイスを実装する `MyExpressionEditorInstance` クラスのコードです。  
+  
+```  
+  
+using System;  
+using System.Activities.Presentation.View;  
+using System.Windows;  
+using System.Reflection;  
+using System.Windows.Controls;  
+  
+namespace MyExpressionEditorService  
+{  
+    public class MyExpressionEditorInstance : IExpressionEditorInstance  
+    {  
+        private TextBox textBox = new TextBox();  
+  
+        public bool AcceptsReturn { get; set; }  
+        public bool AcceptsTab { get; set; }  
+        public bool HasAggregateFocus {  
+            get  
+            {  
+                return true;  
+            }  
+        }  
+  
+        public System.Windows.Controls.ScrollBarVisibility HorizontalScrollBarVisibility { get; set; }  
+        public System.Windows.Controls.Control HostControl {  
+            get  
+            {  
+                return textBox;  
+            }  
+        }  
+        public int MaxLines { get; set; }  
+        public int MinLines { get; set; }  
+        public string Text { get; set; }  
+        public System.Windows.Controls.ScrollBarVisibility VerticalScrollBarVisibility { get; set; }  
+  
+        public event EventHandler Closing;  
+        public event EventHandler GotAggregateFocus;  
+        public event EventHandler LostAggregateFocus;  
+        public event EventHandler TextChanged;  
+  
+        public bool CanCompleteWord()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanCopy()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanCut()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanDecreaseFilterLevel()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanGlobalIntellisense()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanIncreaseFilterLevel()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanParameterInfo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanPaste()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanQuickInfo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanRedo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool CanUndo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+  
+        public void ClearSelection()  
+        {  
+            MessageBox.Show(MethodBase.GetCurrentMethod().Name);  
+        }  
+        public void Close()  
+        {  
+            MessageBox.Show(MethodBase.GetCurrentMethod().Name);  
+        }  
+        public bool CompleteWord()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool Copy()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool Cut()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool DecreaseFilterLevel()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public void Focus()  
+        {  
+            MessageBox.Show(MethodBase.GetCurrentMethod().Name);  
+        }  
+        public string GetCommittedText()  
+        {  
+            return "CommittedText";  
+        }  
+        public bool GlobalIntellisense()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool IncreaseFilterLevel()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool ParameterInfo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool Paste()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool QuickInfo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool Redo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+        public bool Undo()  
+        {  
+            return (MessageBox.Show(MethodBase.GetCurrentMethod().Name, "TestEditorInstance", MessageBoxButton.YesNo) == MessageBoxResult.Yes);  
+        }  
+    }  
+}  
+  
+```  
+  
+### WPF プロジェクトでカスタム式エディターを公開する  
+ 次のコードは、[!INCLUDE[avalon2](../../../includes/avalon2-md.md)] アプリケーションでデザイナーを再ホストする方法と、`MyEditorService` サービスを作成して公開する方法を示しています。このコードを使用する前に、avalon2 アプリケーションを含むプロジェクトから、MyExpressionEditorService ライブラリ プロジェクトへの参照を追加します。  
+  
+```  
+  
+using System.Windows;  
+using System.Windows.Controls;  
+using System.Activities.Presentation;  
+using System.Activities.Statements;  
+using System.Activities.Core.Presentation;  
+using System.Activities.Presentation.View;  
+using MyExpressionEditorService;  
+  
+namespace WpfApplication1  
+{  
+    /// <summary>  
+    /// Interaction logic for MainWindow.xaml  
+    /// </summary>  
+    public partial class MainWindow : Window  
+    {  
+  
+        private MyEditorService expressionEditorService;  
+        public MainWindow()  
+        {  
+            InitializeComponent();  
+            new DesignerMetadata().Register();  
+            createDesigner();  
+        }  
+  
+        public void createDesigner()  
+        {  
+            WorkflowDesigner designer = new WorkflowDesigner();  
+            Sequence root = new Sequence()  
+            {  
+                Activities = {  
+                new Assign(),  
+                new WriteLine()}  
+            };  
+  
+            designer.Load(root);  
+  
+            Grid.SetColumn(designer.View, 0);  
+  
+            // Create ExpressionEditorService   
+            this.expressionEditorService = new MyEditorService();  
+  
+            // Publish the instance of MyEditorService.  
+            designer.Context.Services.Publish<IExpressionEditorService>(this.expressionEditorService);  
+  
+            MyGrid.Children.Add(designer.View);  
+        }  
+    }  
+}  
+  
+```  
+  
+### メモ  
+ カスタム アクティビティ デザイナーで **ExpressionTextBox** コントロールを使用している場合は <xref:System.Activities.Presentation.View.IExpressionEditorService> インターフェイスの <xref:System.Activities.Presentation.View.IExpressionEditorService.CreateExpressionEditor%2A> および <xref:System.Activities.Presentation.View.IExpressionEditorService.CloseExpressionEditors%2A> メソッドを使用して式エディターを作成および破棄する必要はありません。<xref:System.Activities.Presentation.View.ExpressionTextBox> クラスによってこの処理が行われます。  
+  
+## 参照  
+ <xref:System.Activities.Presentation.View.IExpressionEditorService>   
+ <xref:System.Activities.Presentation.View.IExpressionEditorInstance>   
+ [カスタム アクティビティ デザイナーでの ExpressionTextBox の使用](../../../docs/framework/windows-workflow-foundation/samples/using-the-expressiontextbox-in-a-custom-activity-designer.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-activity-delegates.md b/docs/framework/windows-workflow-foundation/using-activity-delegates.md
new file mode 100644
index 00000000000..95edb231b17
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-activity-delegates.md
@@ -0,0 +1,64 @@
+---
+title: "アクティビティ デリゲートの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e33cf876-8979-440b-9b23-4a12d1139960
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# アクティビティ デリゲートの使用
+アクティビティ デリゲートを使用すると、アクティビティの作成者は、特定の署名を持つコールバックを公開できます。アクティビティのユーザーは、この署名用のアクティビティベースのハンドラーを提供できます。2 種類のアクティビティ デリゲートを使用できます。<xref:System.Activities.ActivityAction%601> は、戻り値を持たないアクティビティ デリゲートを定義する場合に使用され、<xref:System.Activities.ActivityFunc%601> は戻り値を持つアクティビティ デリゲートを定義する場合に使用されます。  
+  
+ アクティビティ デリゲートは、子アクティビティが特定の署名を持つように制限する必要がある場合に便利です。たとえば、<xref:System.Activities.Statements.While> アクティビティは制約のないあらゆる型のアクティビティを含めることができますが、<xref:System.Activities.Statements.ForEach%601> アクティビティの本体は <xref:System.Activities.ActivityAction%601> であるため、最終的には <xref:System.Activities.Statements.ForEach%601> によって実行されるその子アクティビティは、<xref:System.Activities.Statements.ForEach%601> が列挙するコレクションのメンバーと同じ型である <xref:System.Activities.InArgument%601> を持つ必要があります。  
+  
+## ActivityAction の使用  
+ いくつかの [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] アクティビティ \(<xref:System.Activities.Statements.Catch> アクティビティや <xref:System.Activities.Statements.ForEach%601> アクティビティなど\) では、アクティビティ アクションが使用されます。それぞれの場合において、アクティビティ アクションは、これらのアクティビティのいずれかを使用してワークフローを作成するときに、ワークフローの作成者が目的の動作を提供するアクティビティを指定する場所を表します。次の例では、<xref:System.Activities.Statements.ForEach%601> アクティビティを使用してコンソール ウィンドウにテキストを表示します。<xref:System.Activities.Statements.ForEach%601> の本体は、<xref:System.Activities.Statements.ForEach%601> の型 \(文字列\) に一致する <xref:System.Activities.ActivityAction%601> を使用して指定します。<xref:System.Activities.ActivityDelegate.Handler%2A> で指定された <xref:System.Activities.Statements.WriteLine> アクティビティには、<xref:System.Activities.Statements.ForEach%601> アクティビティによって反復処理されるコレクションの文字列値にバインドされる <xref:System.Activities.Statements.WriteLine.Text%2A> 引数があります。  
+  
+ [!code-csharp[CFX_ActivityExample#6](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#6)]  
+  
+ actionArgument は、コレクション内の各項目を WriteLine にフローするために使用されます。このワークフローが呼び出されると、次の出力がコンソールに表示されます。  
+  
+ **Hello**   
+**World.**  このトピックの例では、オブジェクトの初期化の構文を使用します。オブジェクトの初期化の構文は、コードでワークフロー定義を作成する場合に便利な方法です。これは、ワークフローのアクティビティの階層ビューが提供され、アクティビティ間の関係が示されるためです。プログラムからワークフローを作成する場合に、オブジェクトの初期化の構文を使用しなければならないという要件はありません。次の例は、機能的には前のサンプルと同じです。  
+  
+ [!code-csharp[CFX_ActivityExample#7](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#7)]  
+  
+ オブジェクト初期化子[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[方法: コンストラクターを呼び出さずにオブジェクトを初期化する \(C\# プログラミング ガイド\)](http://go.microsoft.com/fwlink/?LinkId=161015)」および「[方法: オブジェクト初期化子を使用してオブジェクトを宣言する](http://go.microsoft.com/fwlink/?LinkId=161016)」を参照してください。  
+  
+ 次の例では、ワークフローで <xref:System.Activities.Statements.TryCatch> アクティビティを使用します。ワークフローによって <xref:System.ApplicationException> がスローされ、<xref:System.Activities.Statements.Catch%601> アクティビティによってこの例外が処理されます。<xref:System.Activities.Statements.Catch%601> アクティビティのアクティビティ アクションのハンドラーは <xref:System.Activities.Statements.WriteLine> アクティビティで、例外の詳細は `ex` <xref:System.Activities.DelegateInArgument%601> を介してこのハンドラーにフローされます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#33](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#33)]  
+  
+ <xref:System.Activities.ActivityAction%601> を定義するカスタム アクティビティを作成する場合は、<xref:System.Activities.Statements.InvokeAction%601> を使用して <xref:System.Activities.ActivityAction%601> の呼び出しをモデル化します。次の例では、カスタムの `WriteLineWithNotification` アクティビティを定義します。このアクティビティは、<xref:System.Activities.Statements.WriteLine> アクティビティが含まれ、その後に 1 つの文字列引数を取る <xref:System.Activities.ActivityAction%601> を呼び出す <xref:System.Activities.Statements.InvokeAction%601> が続く <xref:System.Activities.Statements.Sequence> で構成されます。  
+  
+ [!code-csharp[CFX_ActivityExample#1](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#1)]  
+  
+ `WriteLineWithNotification` アクティビティを使用してワークフローを作成する場合、ワークフローの作成者は、アクティビティ アクションの <xref:System.Activities.ActivityDelegate.Handler%2A> で必要なカスタム ロジックを指定します。次の例では、`WriteLineWithNotification` アクティビティを使用してワークフローを作成し、<xref:System.Activities.ActivityDelegate.Handler%2A> として <xref:System.Activities.Statements.WriteLine> アクティビティを使用します。  
+  
+ [!code-csharp[CFX_ActivityExample#2](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#2)]  
+  
+ 1 つ以上の引数を渡すために <xref:System.Activities.Statements.InvokeAction%601> および <xref:System.Activities.ActivityAction%601> のジェネリック バージョンが複数用意されています。  
+  
+## ActivityFunc の使用  
+ <xref:System.Activities.ActivityAction%601> はアクティビティから結果値が返されない場合に役立ち、<xref:System.Activities.ActivityFunc%601> は結果値が返される場合に使用されます。<xref:System.Activities.ActivityFunc%601> を定義するカスタム アクティビティを作成する場合は、<xref:System.Activities.Expressions.InvokeFunc%601> を使用して <xref:System.Activities.ActivityFunc%601> の呼び出しをモデル化します。次の例では、`WriteFillerText` アクティビティを定義します。充てんテキストを提供するために、整数の引数を取って文字列の結果を持つ <xref:System.Activities.Expressions.InvokeFunc%601> を指定します。充てんテキストが取得されると、<xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに表示されます。  
+  
+ [!code-csharp[CFX_ActivityExample#3](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#3)]  
+  
+ テキストを提供するには、`int` の引数を 1 つ取って文字列の結果を持つアクティビティを使用する必要があります。次の例では、これらの要件を満たす `TextGenerator` アクティビティを示します。  
+  
+ [!code-csharp[CFX_ActivityExample#4](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#4)]  
+  
+ `TextGenerator` アクティビティと `WriteRandomText` アクティビティを一緒に使用するには、<xref:System.Activities.ActivityDelegate.Handler%2A> として指定します。  
+  
+ [!code-csharp[CFX_ActivityExample#5](../../../samples/snippets/csharp/VS_Snippets_CFX/CFX_ActivityExample/cs/Program.cs#5)]  
+  
+## 参照  
+ [ActivityAction の公開と呼び出し](../../../docs/framework/windows-workflow-foundation/samples/exposing-and-invoking-activityactions.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-activity-extensions.md b/docs/framework/windows-workflow-foundation/using-activity-extensions.md
new file mode 100644
index 00000000000..3a14daed7a2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-activity-extensions.md
@@ -0,0 +1,139 @@
+---
+title: "アクティビティ拡張機能の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 500eb96a-c009-4247-b6b5-b36faffdf715
+caps.latest.revision: 5
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 5
+---
+# アクティビティ拡張機能の使用
+アクティビティは、ワークフローで明示的にモデル化されていない追加機能の提供をホストに許可するワークフロー アプリケーション拡張機能と相互作用することができます。ここでは、アクティビティの実行回数をカウントする拡張機能を作成および使用する方法について説明します。  
+  
+### 実行回数をカウントするアクティビティ拡張機能を使用するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を起動します。**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。**\[Visual C\#\]** ノードから **\[ワークフロー\]** を選択します。テンプレートの一覧から **\[ワークフロー コンソール アプリケーション\]** を選択します。プロジェクトに「`Extensions`」という名前を付けます。**\[OK\]** をクリックして、プロジェクトを作成します。  
+  
+2.  Program.cs ファイルに、**System.Collections.Generic** 名前空間の `using` ステートメントを追加します。  
+  
+    ```  
+    using System.Collections.Generic;  
+  
+    ```  
+  
+3.  Program.cs ファイルで、**ExecutionCountExtension** という名前の新しいクラスを作成します。次のコードは、**Register** メソッドを呼び出したときにインスタンス ID を追跡するワークフロー拡張機能を作成します。  
+  
+    ```  
+    // This extension collects a list of workflow Ids  
+    public class ExecutionCountExtension  
+    {  
+        IList<Guid> instances = new List<Guid>();  
+  
+        public int ExecutionCount  
+        {  
+            get  
+            {  
+                return this.instances.Count;  
+            }  
+        }  
+  
+        public IEnumerable<Guid> InstanceIds  
+        {  
+            get  
+            {  
+                return this.instances;  
+            }  
+        }  
+  
+        public void Register(Guid activityInstanceId)  
+        {  
+            if (!this.instances.Contains<Guid>(activityInstanceId))  
+            {  
+                instances.Add(activityInstanceId);  
+            }  
+        }  
+    }  
+  
+    ```  
+  
+4.  **ExecutionCountExtension** を使用するアクティビティを作成します。次のコードは、ランタイムから **ExecutionCountExtension** オブジェクトを取得して、アクティビティが実行されるとその **Register** メソッドを呼び出すアクティビティを定義します。  
+  
+    ```  
+    // Activity that consumes an extension provided by the host. If the extension is available  
+    // in the context, it will invoke (in this case, registers the Id of the executing workflow)  
+    public class MyActivity: CodeActivity  
+    {  
+        protected override void Execute(CodeActivityContext context)  
+        {  
+            ExecutionCountExtension ext = context.GetExtension<ExecutionCountExtension>();  
+            if (ext != null)  
+            {  
+                ext.Register(context.WorkflowInstanceId);                         
+            }  
+  
+        }  
+    }  
+  
+    ```  
+  
+5.  program.cs ファイルの **Main** メソッドにアクティビティを実装します。次のコードには、2 つの異なるワークフローを生成し、各ワークフローを数回実行して、拡張機能に含まれる結果のデータを表示するメソッドが含まれています。  
+  
+    ```  
+    class Program  
+    {  
+        // Creates a workflow that uses the activity that consumes the extension  
+        static Activity CreateWorkflow1()  
+        {  
+            return new Sequence  
+            {  
+                Activities =  
+                {  
+                    new MyActivity()  
+                }  
+            };  
+        }  
+  
+        // Creates a workflow that uses two instances of the activity that consumes the extension  
+        static Activity CreateWorkflow2()  
+        {  
+            return new Sequence  
+            {  
+                Activities =  
+                {  
+                    new MyActivity(),  
+                    new MyActivity()  
+                }  
+            };  
+        }  
+  
+        static void Main(string[] args)  
+        {  
+            // create the extension   
+            ExecutionCountExtension executionCountExt = new ExecutionCountExtension();  
+  
+            // configure the first invoker and execute 3 times  
+            WorkflowInvoker invoker = new WorkflowInvoker(CreateWorkflow1());  
+            invoker.Extensions.Add(executionCountExt);                          
+            invoker.Invoke();  
+            invoker.Invoke();  
+            invoker.Invoke();  
+  
+            // configure the second invoker and execute 2 times  
+            WorkflowInvoker invoker2 = new WorkflowInvoker(CreateWorkflow2());  
+            invoker2.Extensions.Add(executionCountExt);  
+            invoker2.Invoke();  
+            invoker2.Invoke();  
+  
+            // show the data in the extension  
+            Console.WriteLine("Executed {0} times", executionCountExt.ExecutionCount);  
+            executionCountExt.InstanceIds.ToList().ForEach(i => Console.WriteLine("...{0}", i));  
+        }  
+    }  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-and-creating-activities.md b/docs/framework/windows-workflow-foundation/using-and-creating-activities.md
new file mode 100644
index 00000000000..a2655e23ba3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-and-creating-activities.md
@@ -0,0 +1,27 @@
+---
+title: "アクティビティの使用と作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], アクティビティ"
+ms.assetid: 2a69f32e-007f-47d0-ab96-535311641428
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# アクティビティの使用と作成
+このセクションのトピックでは、[!INCLUDE[wf](../../../includes/wf-md.md)] で使用できるシステム標準アクティビティについて説明します。  
+  
+## このセクションの内容  
+ [ビルトイン アクティビティ ライブラリ](../../../docs/framework/windows-workflow-foundation//net-framework-4-5-built-in-activity-library.md)  
+ [!INCLUDE[wf1](../../../includes/wf1-md.md)] で使用できるシステム標準アクティビティについて説明します。  
+  
+ [カスタム アクティビティの設計と実装](../../../docs/framework/windows-workflow-foundation//designing-and-implementing-custom-activities.md)  
+ <xref:System.Activities.CodeActivity> メソッドまたは <xref:System.Activities.NativeActivity> メソッドを使用してカスタム アクティビティを作成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-custom-activity-designers-and-templates.md b/docs/framework/windows-workflow-foundation/using-custom-activity-designers-and-templates.md
new file mode 100644
index 00000000000..2be850d71a6
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-custom-activity-designers-and-templates.md
@@ -0,0 +1,48 @@
+---
+title: "カスタム アクティビティ デザイナーおよびテンプレートの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1aab82e7-7f89-4255-be46-526b09ceeb8b
+caps.latest.revision: 8
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 8
+---
+# カスタム アクティビティ デザイナーおよびテンプレートの使用
+このセクションの各トピックでは、カスタム アクティビティ デザイナーとカスタム アクティビティ テンプレートの作成方法について説明します。  
+  
+## このセクションの内容  
+ [方法: カスタム アクティビティ デザイナーを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-activity-designer.md)  
+ ワークフローによって提供されるデザイナーがデザイン タスクに適していない場合に、カスタマイズされたアクティビティ デザイナーを作成する方法を示します。  
+  
+ [方法: カスタム アクティビティ テンプレートを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-custom-activity-template.md)  
+ ユーザーが手動で各アクティビティを個別に作成し、そのプロパティおよびその他の設定を構成しなくても済むように、カスタム アクティビティ テンプレートを使用してアクティビティを事前に構成する方法を示します。  
+  
+ [ModelItem 編集コンテキストの使用](../../../docs/framework/windows-workflow-foundation//using-the-modelitem-editing-context.md)  
+ デザイナーがホストと対話できるようにする ModelItem 編集コンテキスト機能の使用方法について説明します。  
+  
+ [デザイナー コントロールへのカスタム アクティビティ プロパティのバインド](../../../docs/framework/windows-workflow-foundation//binding-a-custom-activity-property-to-a-designer-control.md)  
+ デザイナーのアクティビティ プロパティに listview コントロールをバインドする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Activities.Presentation.ActivityDesigner>  
+  
+ <xref:System.Activities.Presentation.View.ExpressionTextBox>  
+  
+ <xref:System.Activities.ActivityAction>  
+  
+ <xref:System.Activities.Presentation.IActivityTemplateFactory>  
+  
+ <xref:System.Activities.Presentation.Model.ModelTreeManager>  
+  
+## 関連項目  
+ [ワークフロー デザイナーのホスト変更](../../../docs/framework/windows-workflow-foundation//rehosting-the-workflow-designer.md)  
+  
+## 外部リソース  
+ [カスタム アクティビティ](../../../docs/framework/windows-workflow-foundation/samples/custom-activities.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-the-interop-activity-in-a-net-framework-4-workflow.md b/docs/framework/windows-workflow-foundation/using-the-interop-activity-in-a-net-framework-4-workflow.md
new file mode 100644
index 00000000000..09a11fe9189
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-the-interop-activity-in-a-net-framework-4-workflow.md
@@ -0,0 +1,374 @@
+---
+title: ".NET Framework 4 ワークフローでの相互運用アクティビティの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 9bb747f0-eb33-4f70-84cd-317382372dcd
+caps.latest.revision: 20
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 20
+---
+# .NET Framework 4 ワークフローでの相互運用アクティビティの使用
+使用して作成されたアクティビティ [!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] または [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] で使用できる、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] を使用してワークフロー、 <xref:System.Activities.Statements.Interop> アクティビティ。 このトピックの概要を使用して、 <xref:System.Activities.Statements.Interop> アクティビティ。  
+  
+> [!NOTE]
+>   <xref:System.Activities.Statements.Interop> ワークフローのプロジェクトで、アクティビティがワークフロー デザイナー ツールボックスに表示されない、 **ターゲット フレームワーク** ] に設定 **.Net Framework 4** またはそれ以降。  
+  
+## <a name="using-the-interop-activity-in-net-framework-45-workflows"></a>.NET Framework 4.5 ワークフローでの相互運用アクティビティの使用  
+ このトピックでは、[!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] アクティビティを含む `DiscountCalculator` アクティビティ ライブラリを作成します。  `DiscountCalculator` 購入額に基づいて割引を計算してから構成され、 <xref:System.Workflow.Activities.SequenceActivity> を含む、 <xref:System.Workflow.Activities.PolicyActivity>します。  
+  
+> [!NOTE]
+>   [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] このトピックで作成したアクティビティを使用して、 <xref:System.Workflow.Activities.PolicyActivity> アクティビティのロジックを実装します。 カスタムを使用する必要はありません [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] アクティビティまたは <xref:System.Activities.Statements.Interop> でルールを使用するためにアクティビティ、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフローです。 ルールを使用する例については、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフローを使用せず、 <xref:System.Activities.Statements.Interop> アクティビティを参照してください、 [.NET Framework 4.5 のポリシー アクティビティ](../../../docs/framework/windows-workflow-foundation/samples/policy-activity-in-net-framework-4-5.md) サンプルです。  
+  
+#### <a name="to-create-the-net-framework-35-activity-library-project"></a>.NET Framework 3.5 アクティビティ ライブラリ プロジェクトを作成するには  
+  
+1.  開いている [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] 選択 **新規** し **プロジェクト.**  **ファイル** メニュー。  
+  
+2.  展開、 **その他のプロジェクトの種類** 内のノード、 **インストールされたテンプレート** ペイン **Visual Studio ソリューション**します。  
+  
+3.  選択 **空のソリューション** から、 **Visual Studio ソリューション** ] ボックスの一覧です。 型 `PolicyInteropDemo` で、 **名前** ボックスし、をクリックして **OK**します。  
+  
+4.  右クリック **PolicyInteropDemo** で **ソリューション エクスプ ローラー** 選択 **追加** し **新しいプロジェクト]**します。  
+  
+    > [!TIP]
+    >  場合、 **ソリューション エクスプ ローラー** ウィンドウが表示されている、選択ができない **ソリューション エクスプ ローラー** から、 **ビュー** メニュー。  
+  
+5.   **インストールされたテンプレート** 一覧で、[ **Visual c#** し **ワークフロー**します。 選択 **.NET Framework 3.5** クリックして .NET Framework のバージョンのドロップダウン リストから **ワークフロー アクティビティ ライブラリ** から、 **テンプレート** ] ボックスの一覧です。  
+  
+6.  型 `PolicyActivityLibrary` で、 **名前** ボックスし、をクリックして **OK**します。  
+  
+7.  右クリック **Activity1.cs** で **ソリューション エクスプ ローラー** 選択 **削除**します。 **[OK]** をクリックして確定します。  
+  
+#### <a name="to-create-the-discountcalculator-activity"></a>DiscountCalculator アクティビティを作成するには  
+  
+1.  右クリック **PolicyActivityLibrary** で **ソリューション エクスプ ローラー** 選択 **追加** し **アクティビティ]**します。  
+  
+2.  選択 **アクティビティ (コード分離付き)** から、 **Visual c# アイテム** ] ボックスの一覧です。 型 `DiscountCalculator` で、 **名前** ボックスし、をクリックして **OK**します。  
+  
+3.  右クリック **DiscountCalculator.xoml** で **ソリューション エクスプ ローラー** 選択 **コードの表示**します。  
+  
+4.  `DiscountCalculator` クラスに次の 3 つのプロパティを追加します。  
+  
+    ```csharp  
+    public partial class DiscountCalculator : SequenceActivity  
+    {  
+        public double Subtotal { get; set; }  
+        public double DiscountPercent { get; set; }  
+        public double Total { get; set; }  
+    }  
+    ```  
+  
+5.  右クリック **DiscountCalculator.xoml** で **ソリューション エクスプ ローラー** 選択 **ビュー デザイナー**します。  
+  
+6.  ドラッグ、 **ポリシー** からアクティビティ、 **Windows Workflow v3.0** のセクションで、 **ツールボックス** にドロップし、 **DiscountCalculator** アクティビティ。  
+  
+    > [!TIP]
+    >  場合、 **ツールボックス** ウィンドウが表示されている、選択ができない **ツールボックス** から、 **ビュー** メニュー。  
+  
+#### <a name="to-configure-the-rules"></a>ルールを構成するには  
+  
+1.  新しく追加された] をクリックして **ポリシー** アクティビティをまだ選択されていない場合にオンにします。  
+  
+2.  クリックして、 **RuleSetReference** プロパティに、 **プロパティ** ウィンドウを選択し、プロパティの右側にある省略記号ボタンをクリックします。  
+  
+    > [!TIP]
+    >  場合、 **プロパティ** ウィンドウが表示されていない、選択 **プロパティ] ウィンドウ** から、 **ビュー** メニュー。  
+  
+3.  選択 **... [新規**します。  
+  
+4.  クリックして **ルールの追加**します。  
+  
+5.  次の式を入力、 **条件** ボックス。  
+  
+    ```  
+    this.Subtotal >= 50 && this.Subtotal < 100  
+    ```  
+  
+6.  次の式を入力、 **Then アクション** ボックス。  
+  
+    ```  
+    this.DiscountPercent = 0.075  
+    ```  
+  
+7.  クリックして **ルールの追加**します。  
+  
+8.  次の式を入力、 **条件** ボックス。  
+  
+    ```  
+    this.Subtotal >= 100  
+    ```  
+  
+9. 次の式を入力、 **Then アクション** ボックス。  
+  
+    ```  
+    this.DiscountPercent = 0.15  
+    ```  
+  
+10. クリックして **ルールの追加**します。  
+  
+11. 次の式を入力、 **条件** ボックス。  
+  
+    ```  
+    this.DiscountPercent > 0  
+    ```  
+  
+12. 次の式を入力、 **Then アクション** ボックス。  
+  
+    ```  
+    this.Total = this.Subtotal - this.Subtotal * this.DiscountPercent  
+    ```  
+  
+13. 次の式を入力、 **Else アクション** ボックス。  
+  
+    ```  
+    this.Total = this.Subtotal  
+    ```  
+  
+14. をクリックして **OK** を閉じる、 **ルール セット エディター** ] ダイアログ ボックス。  
+  
+15. 新たに作成されたことを確認 <xref:System.Workflow.Activities.Rules.RuleSet> で選択した、 **名前** 一覧を開き、をクリックして **OK**します。  
+  
+16. Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+ この手順で `DiscountCalculator` アクティビティに追加したルールを次のコード例に示します。  
+  
+```  
+Rule1: IF this.Subtotal >= 50 && this.Subtotal < 100   
+       THEN this.DiscountPercent = 0.075   
+  
+Rule2: IF this. Subtotal >= 100   
+       THEN this.DiscountPercent = 0.15   
+  
+Rule3: IF this.DiscountPercent > 0   
+       THEN this.Total = this.Subtotal - this.Subtotal * this.DiscountPercent   
+       ELSE this.Total = this.Subtotal  
+```  
+  
+ ときに、 <xref:System.Workflow.Activities.PolicyActivity> 実行されると、これらの 3 つのルールが評価および変更、 `Subtotal`, 、`DiscountPercent`, と `Total` プロパティの値を `DiscountCalculator` を目的の割引を計算するアクティビティ。  
+  
+## <a name="using-the-discountcalculator-activity-with-the-interop-activity"></a>DiscountCalculator アクティビティと相互運用アクティビティの使用  
+ 使用する、 `DiscountCalculator` 内のアクティビティ、 [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] 、ワークフロー、 <xref:System.Activities.Statements.Interop> アクティビティを使用します。 このセクションの 2 つのワークフローが作成され、一方を使用する方法を示しているコードとワークフロー デザイナーを使用して 1 つを使用して、 <xref:System.Activities.Statements.Interop> アクティビティと、 `DiscountCalculator` アクティビティ。 両方のワークフローに同じホスト アプリケーションを使用します。  
+  
+#### <a name="to-create-the-host-application"></a>ホスト アプリケーションを作成するには  
+  
+1.  右クリック **PolicyInteropDemo** で **ソリューション エクスプ ローラー** 選択 **追加**, 、し **新しいプロジェクト]**します。  
+  
+2.  いることを確認 **.NET Framework 4.5** .NET Framework のバージョンのドロップダウン リストで選択され、選択  **ワークフロー コンソール アプリケーション** から、 **Visual c# アイテム** ] ボックスの一覧です。  
+  
+3.  型 `PolicyInteropHost` に、 **名前** ボックスし、をクリックして **OK**します。  
+  
+4.  右クリック **PolicyInteropHost** で **ソリューション エクスプ ローラー** 選択 **プロパティ**します。  
+  
+5.   **ターゲット フレームワーク** ドロップ ダウン ボックスの一覧で、選択した項目を変更する **.NET Framework 4 Client Profile** に **.NET Framework 4.5**します。 クリックして **はい** を確認します。  
+  
+6.  右クリック **PolicyInteropHost** で **ソリューション エクスプ ローラー** 選択 **参照の追加]**します。  
+  
+7.  選択 **PolicyActivityLibrary** から、 **プロジェクト** ] タブでをクリックし、 **OK**します。  
+  
+8.  右クリック **PolicyInteropHost** で **ソリューション エクスプ ローラー** 選択 **参照の追加]**します。  
+  
+9. 選択 **System.Workflow.Activities**, 、**System.Workflow.ComponentModel**, 、し **System.Workflow.Runtime** から、 **.NET** ] タブでをクリックし、 **OK**します。  
+  
+10. 右クリック **PolicyInteropHost** で **ソリューション エクスプ ローラー** 選択 **スタートアップ プロジェクトとして設定**します。  
+  
+11. Ctrl キーと Shift キーを押しながら B キーを押して、ソリューションをビルドします。  
+  
+### <a name="using-the-interop-activity-in-code"></a>コードでの Interop アクティビティの使用  
+ 含むコードを使用して、ワークフロー定義を作成この例では、 <xref:System.Activities.Statements.Interop> アクティビティおよび `DiscountCalculator` アクティビティ。 使用して、このワークフローが呼び出される <xref:System.Activities.WorkflowInvoker> を使用してコンソールに、ルールの評価結果が書き込まれると、 <xref:System.Activities.Statements.WriteLine> アクティビティ。  
+  
+##### <a name="to-use-the-interop-activity-in-code"></a>コードで Interop アクティビティを使用するには  
+  
+1.  右クリック **Program.cs** で **ソリューション エクスプ ローラー** 選択 **コードの表示**します。  
+  
+2.  ファイルの先頭に次の `using` ステートメントを追加します。  
+  
+    ```csharp  
+    using PolicyActivityLibrary;  
+    ```  
+  
+3.  `Main` メソッドの内容を削除し、次のコードに置き換えます。  
+  
+    ```csharp  
+    static void Main(string[] args)  
+    {  
+        CalculateDiscountUsingCodeWorkflow();  
+    }  
+    ```  
+  
+4.  次のコードを含む `Program` と呼ばれる `CalculateDiscountUsingCodeWorkflow` クラスで新しいメソッドを作成します。  
+  
+    ```csharp  
+    static void CalculateDiscountUsingCodeWorkflow()  
+    {  
+        Variable<double> Subtotal = new Variable<double>  
+        {  
+            Default = 75.99,  
+            Name = "Subtotal"  
+        };  
+  
+        Variable<double> DiscountPercent = new Variable<double>  
+        {  
+            Name = "DiscountPercent"  
+        };  
+  
+        Variable<double> Total = new Variable<double>  
+        {  
+            Name = "Total"  
+        };  
+  
+        Activity wf = new Sequence  
+        {  
+            Variables = { Subtotal, DiscountPercent, Total },  
+            Activities =   
+            {  
+                new Interop  
+                {  
+                    ActivityType = typeof(DiscountCalculator),  
+                    ActivityProperties =   
+                    {  
+                        { "Subtotal", new InArgument<double>(Subtotal) },  
+                        { "DiscountPercentOut", new OutArgument<double>(DiscountPercent) },  
+                        { "TotalOut", new OutArgument<double>(Total) }  
+                    }  
+                },  
+                new WriteLine  
+                {  
+                    Text =  new InArgument<string>(env =>   
+                        string.Format("Subtotal: {0:C}, Discount {1}%, Total {2:C}",   
+                        Subtotal.Get(env), DiscountPercent.Get(env) * 100, Total.Get(env)))  
+                }  
+            }  
+        };  
+  
+        WorkflowInvoker.Invoke(wf);  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >   `Subtotal`, 、`DiscountPercent`, 、および `Total` のプロパティ、 `DiscountCalculator` の引数として表示、 <xref:System.Activities.Statements.Interop> アクティビティ、およびローカル ワークフロー変数にバインドで、 <xref:System.Activities.Statements.Interop> アクティビティの <xref:System.Activities.Statements.Interop.ActivityProperties%2A> コレクションです。 `Subtotal` として追加、 <xref:System.Activities.ArgumentDirection> 引数のため、 `Subtotal` にデータが流れる、 <xref:System.Activities.Statements.Interop> アクティビティ、および `DiscountPercent` と `Total` として追加されます <xref:System.Activities.ArgumentDirection> 引数のデータであるので、 <xref:System.Activities.Statements.Interop> アクティビティ。 注意してください、2 つ <xref:System.Activities.ArgumentDirection> 引数はという名前で追加 `DiscountPercentOut` と `TotalOut` を表すことを示す <xref:System.Activities.ArgumentDirection> 引数。  `DiscountCalculator` として型が指定されている、 <xref:System.Activities.Statements.Interop> アクティビティの <xref:System.Activities.Statements.Interop.ActivityType%2A>します。  
+  
+5.  Ctrl キーを押しながら F5 キーを押してアプリケーションをビルドし、実行します。 `Subtotal` 値を異なる値に置き換え、`DiscountCalculator` アクティビティに用意されているさまざまな割引レベルをテストします。  
+  
+    ```csharp  
+    Variable<double> Subtotal = new Variable<double>  
+    {  
+        Default = 75.99, // Change this value.  
+        Name = "Subtotal"  
+    };  
+    ```  
+  
+### <a name="using-the-interop-activity-in-the-workflow-designer"></a>ワークフロー デザイナーでの Interop アクティビティの使用  
+ この例では、ワークフロー デザイナーを使用してワークフローを作成します。 このワークフローには、前の例と同じ機能を除くよりも使用する代わりに、 <xref:System.Activities.Statements.WriteLine> 、割引を表示するアクティビティ ホスト アプリケーションを取得し、ワークフローの完了時に割引情報が表示されます。 また、データを含むローカル ワークフロー変数を使用するのではなく、ワークフローの呼び出し時に、引数がワークフロー デザイナーで作成され、値はホストから渡されます。  
+  
+##### <a name="to-host-the-policyactivity-using-a-workflow-designer-created-workflow"></a>ワークフロー デザイナーで作成したワークフローを使用して PolicyActivity をホストするには  
+  
+1.  右クリック **Workflow1.xaml** で **ソリューション エクスプ ローラー** 選択 **削除**します。 **[OK]** をクリックして確定します。  
+  
+2.  右クリック **PolicyInteropHost** で **ソリューション エクスプ ローラー** 選択 **追加**, 、**新しい項目]**します。  
+  
+3.  展開、 **Visual c# アイテム** ノード **ワークフロー**します。 選択 **アクティビティ** から、 **Visual c# アイテム** ] ボックスの一覧です。  
+  
+4.  型 `DiscountWorkflow` に、 **名前** ボックスし、をクリックして **追加**します。  
+  
+5.  クリックして、 **引数** を表示するワークフロー デザイナーの左下のボタン、 **引数** ウィンドウです。  
+  
+6.  クリックして **引数の作成**します。  
+  
+7.  型 `Subtotal` に、 **名前** ボックスで、 **で** から、 **方向** ドロップダウン リストで、[ **二重** から、 **引数の型** ドロップ ダウンし、enter キーを押して引数を保存します。  
+  
+    > [!NOTE]
+    >  場合 **二重** に含まれていない、 **引数の型** ドロップダウン リストで、 **の種類の [参照]**, 、型 `System.Double` で、 **型名** ボックスし、をクリックして **[ok]**します。  
+  
+8.  クリックして **引数の作成**します。  
+  
+9. 型 `DiscountPercent` に、 **名前** ボックスで、 **アウト** から、 **方向** ドロップダウン リストで、[ **二重** から、 **引数の型** ドロップ ダウンし、enter キーを押して引数を保存します。  
+  
+10. クリックして **引数の作成**します。  
+  
+11. 型 `Total` に、 **名前** ボックスで、 **アウト** から、 **方向** ドロップダウン リストで、[ **二重** から、 **引数の型** ドロップ ダウンし、enter キーを押して引数を保存します。  
+  
+12. クリックして、 **引数** を閉じる、ワークフロー デザイナーの左下のボタン、 **引数** ウィンドウです。  
+  
+13. ドラッグ、 **シーケンス** からアクティビティ、 **制御フロー** のセクションで、 **ツールボックス** し、ワークフロー デザイナー画面にドロップします。  
+  
+14. ドラッグ、 **相互運用機能** からアクティビティ、 **移行** のセクションで、 **ツールボックス** にドロップし、 **シーケンス** アクティビティ。  
+  
+15. クリックして、 **相互運用機能** 上のアクティビティ、 **を参照する] をクリックします.** ラベルを入力 **DiscountCalculator** で、 **型名** ボックスし、をクリックして **OK**します。  
+  
+    > [!NOTE]
+    >  ときに、 <xref:System.Activities.Statements.Interop> アクティビティがワークフローに追加された、 `DiscountCalculator` として型を指定の <xref:System.Activities.Statements.Interop.ActivityType%2A>, 、 <xref:System.Activities.Statements.Interop> アクティビティでは、3 つによって公開される <xref:System.Activities.ArgumentDirection> 引数と 3 つ <xref:System.Activities.ArgumentDirection> の 3 つのパブリック プロパティを表す引数、 `DiscountCalculator` アクティビティ。  <xref:System.Activities.ArgumentDirection> 引数が 3 つのパブリック プロパティと、3 つと同じ名前を付ける <xref:System.Activities.ArgumentDirection> 引数と同じ名前を持つ **アウト** プロパティ名に付加します。 次の手順では、前の手順で作成したワークフロー引数がバインドされて、 <xref:System.Activities.Statements.Interop> アクティビティの引数。  
+  
+16. 型 `DiscountPercent` に、 **VB の式を入力して** の右側のボックスに、 **DiscountPercentOut** プロパティと TAB キーを押します。  
+  
+17. 型 `Subtotal` に、 **VB の式を入力して** の右側のボックスに、 **Subtotal** プロパティと TAB キーを押します。  
+  
+18. 型 `Total` に、 **VB の式を入力して** の右側のボックスに、 **TotalOut** プロパティと TAB キーを押します。  
+  
+19. 右クリック **Program.cs** で **ソリューション エクスプ ローラー** 選択 **コードの表示**します。  
+  
+20. ファイルの先頭に次の `using` ステートメントを追加します。  
+  
+    ```csharp  
+    using System.Collections.Generic;  
+    ```  
+  
+21. `CalculateDiscountInCode` メソッドに含まれる `Main` メソッドの呼び出しをコメント アウトし、次のコードを追加します。  
+  
+    > [!NOTE]
+    >  前の手順を実行せず、既定の `Main` コードのままの場合、`Main` の内容を次のコードに置き換えます。  
+  
+    ```csharp  
+    static void Main(string[] args)  
+    {  
+        CalculateDiscountUsingDesignerWorkflow();  
+        //CalculateDiscountUsingCodeWorkflow();  
+    }  
+    ```  
+  
+22. 次のコードを含む `Program` と呼ばれる `CalculateDiscountUsingDesignerWorkflow` クラスで新しいメソッドを作成します。  
+  
+    ```csharp  
+    static void CalculateDiscountUsingDesignerWorkflow()  
+    {  
+        double SubtotalValue = 125.99;  
+        Dictionary<string, object> wfargs = new Dictionary<string, object>  
+        {  
+            {"Subtotal", SubtotalValue}  
+        };  
+  
+        Activity wf = new DiscountWorkflow();  
+  
+        IDictionary<string, object> outputs =  
+            WorkflowInvoker.Invoke(wf, wfargs);  
+  
+        Console.WriteLine("Subtotal: {0:C}, Discount {1}%, Total {2:C}",  
+            SubtotalValue, (double)outputs["DiscountPercent"] * 100,  
+            outputs["Total"]);  
+    }  
+    ```  
+  
+23. Ctrl キーを押しながら F5 キーを押してアプリケーションをビルドし、実行します。 異なる `Subtotal` の額を指定するには、次のコードの `SubtotalValue` 値を変更します。  
+  
+    ```csharp  
+    double SubtotalValue = 125.99; // Change this value.  
+    ```  
+  
+## <a name="rules-features-overview"></a>ルール機能の概要  
+ [!INCLUDE[wf1](../../../includes/wf1-md.md)] ルール エンジンは、フォワード チェーンをサポートする優先順位に基づく方法で、ルールの処理をサポートしています。 単一のアイテムまたはコレクション内のアイテムについて、ルールを評価できます。 ルールの概要および特定のルール機能に関する情報については、次の表を参照してください。  
+  
+|ルール機能|ドキュメント|  
+|-------------------|-------------------|  
+|ルールの概要|[Windows Workflow Foundation ルール エンジンの概要](http://go.microsoft.com/fwlink/?LinkID=152836)|  
+|RuleSet|[ワークフロー内での RuleSets の使用](http://go.microsoft.com/fwlink/?LinkId=178516) と <xref:System.Workflow.Activities.Rules.RuleSet>|  
+|ルールの評価|[RuleSets 内のルールの評価](http://go.microsoft.com/fwlink/?LinkId=178517)|  
+|ルール チェーン|[フォワード チェーン コントロール](http://go.microsoft.com/fwlink/?LinkId=178518) と [ルールのフォワード チェーン](http://go.microsoft.com/fwlink/?LinkId=178519)|  
+|ルール内コレクションの処理|[ルール内コレクションの処理](http://go.microsoft.com/fwlink/?LinkId=178520)|  
+|PolicyActivity の使用|[PolicyActivity アクティビティの使用](http://go.microsoft.com/fwlink/?LinkId=178521) と <xref:System.Workflow.Activities.PolicyActivity>|  
+  
+ 作成されたワークフロー [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] によって提供されるルール機能の一部しか使用しない [!INCLUDE[wf1](../../../includes/wf1-md.md)], 、宣言的アクティビティ条件やなどの条件付きアクティビティなど、 <xref:System.Workflow.Activities.ConditionedActivityGroup> と <xref:System.Workflow.Activities.ReplicatorActivity>します。 必要に応じて、この機能は [!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] および [!INCLUDE[netfx35_short](../../../includes/netfx35-short-md.md)] を使用して作成したワークフローに使用できます。 [!INCLUDE[crdefault](../../../includes/crdefault-md.md)][移行ガイダンス](../../../docs/framework/windows-workflow-foundation//migration-guidance.md)します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-the-modelitem-editing-context.md b/docs/framework/windows-workflow-foundation/using-the-modelitem-editing-context.md
new file mode 100644
index 00000000000..9e3fd77fc5b
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-the-modelitem-editing-context.md
@@ -0,0 +1,154 @@
+---
+title: "ModelItem 編集コンテキストの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7f9f1ea5-0147-4079-8eca-be94f00d3aa1
+caps.latest.revision: 2
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 2
+---
+# ModelItem 編集コンテキストの使用
+<xref:System.Activities.Presentation.Model.ModelItem> 編集コンテキストは、ホスト アプリケーションがデザイナーとの通信に使用するオブジェクトです。<xref:System.Activities.Presentation.EditingContext> は使用できる 2 個のメソッド <xref:System.Activities.Presentation.EditingContext.Items%2A> と <xref:System.Activities.Presentation.EditingContext.Services%2A>を公開します。  
+  
+## Items コレクション  
+ <xref:System.Activities.Presentation.EditingContext.Items%2A> コレクションは、ホストとデザイナー間で共有されるデータ、またはすべてのデザイナーで使用可能なデータへのアクセスに使用されます。このコレクションには、<xref:System.Activities.Presentation.ContextItemManager> クラスを介してアクセスされる次の機能があります。  
+  
+1.  <xref:System.Activities.Presentation.ContextItemManager.GetValue%2A>  
+  
+2.  <xref:System.Activities.Presentation.ContextItemManager.Subscribe%2A>  
+  
+3.  <xref:System.Activities.Presentation.ContextItemManager.Unsubscribe%2A>  
+  
+4.  <xref:System.Activities.Presentation.ContextItemManager.SetValue%2A>  
+  
+## Services コレクション  
+ <xref:System.Activities.Presentation.EditingContext.Services%2A> コレクションは、デザイナーとホスト間の対話に使用されるサービス、またはすべてのデザイナーで使用されるサービスへのアクセスに使用されます。このコレクションには、重要な次のメソッドがあります。  
+  
+1.  <xref:System.Activities.Presentation.ServiceManager.Publish%2A>  
+  
+2.  <xref:System.Activities.Presentation.ServiceManager.Subscribe%2A>  
+  
+3.  <xref:System.Activities.Presentation.ServiceManager.Unsubscribe%2A>  
+  
+4.  <xref:System.Activities.Presentation.ServiceManager.GetService%2A>  
+  
+## デザイナーへのアクティビティの割り当て  
+ アクティビティで使用されるデザイナーを指定するには、Designer 属性が使用されます。  
+  
+```  
+[Designer(typeof(MyClassDesigner))]  
+public sealed class MyClass : CodeActivity  
+{  
+  
+```  
+  
+## サービスの作成  
+ デザイナーとホスト間の情報のコンジットとして機能するサービスを作成するには、インターフェイスと実装を作成する必要があります。インターフェイスはサービスのメンバーを定義するために <xref:System.Activities.Presentation.ServiceManager.Publish%2A> メソッドによって使用され、実装にはサービスのロジックが含まれます。次のコード例では、サービス インターフェイスと実装が作成されます。  
+  
+```  
+public interface IMyService  
+    {  
+        IEnumerable<string> GetValues(string DisplayName);  
+    }  
+  
+    public class MyServiceImpl : IMyService  
+    {  
+        public IEnumerable<string> GetValues(string DisplayName)  
+        {  
+            return new string[]  {   
+                DisplayName + " One",   
+                DisplayName + " Two",  
+                "Three " + DisplayName  
+            } ;  
+        }  
+    }  
+  
+```  
+  
+## サービスの公開  
+ デザイナーでサービスを使用するには、最初に <xref:System.Activities.Presentation.ServiceManager.Publish%2A> メソッドを使用してホストで公開する必要があります。  
+  
+```  
+this.Context.Services.Publish<IMyService>(new MyServiceImpl);  
+```  
+  
+## サービスの定期受信  
+ デザイナーは、<xref:System.Activities.Presentation.WorkflowViewElement.OnModelItemChanged%2A> メソッドの <xref:System.Activities.Presentation.ServiceManager.Subscribe%2A> メソッドを使用してサービスにアクセスします。次のコード スニペットは、サービスを定期受信する方法を示しています。  
+  
+```  
+protected override void OnModelItemChanged(object newItem)  
+{  
+    if (!subscribed)  
+    {  
+        this.Context.Services.Subscribe<IMyService>(  
+            servInstance =>  
+            {  
+                listBox1.ItemsSource = servInstance.GetValues(this.ModelItem.Properties["DisplayName"].ComputedValue.ToString());  
+            }  
+            );  
+        subscribed = true;   
+    }  
+}  
+  
+```  
+  
+## Items コレクションを使用したデータの共有  
+ Items コレクションの使用は Services コレクションの使用と似ていますが、Publish の代わりに <xref:System.Activities.Presentation.ContextItemManager.SetValue%2A> が使用されます。このコレクションは、複雑な機能よりも、デザイナーとホスト間での単純なデータの共有に適しています。  
+  
+## EditingContext ホスト項目およびサービス  
+ .NET Framework には、編集コンテキストを介してアクセスされる多数の項目とサービスが組み込まれています。  
+  
+ 項目:  
+  
+-   <xref:System.Activities.Presentation.Hosting.AssemblyContextControlItem>: ワークフロー内でコントロール \(式エディターなど\) に使用される参照先ローカル アセンブリのリストを管理します。  
+  
+-   <xref:System.Activities.Presentation.Hosting.ReadOnlyState>: デザイナーが読み取り専用状態かどうかを示します。  
+  
+-   <xref:System.Activities.Presentation.View.Selection>: 現在選択されているオブジェクトのコレクションを定義します。  
+  
+-   <xref:System.Activities.Presentation.Hosting.WorkflowCommandExtensionItem>:  
+  
+-   <xref:System.Activities.Presentation.WorkflowFileItem>: 現在の編集セッションが基づくファイルに関する情報を提供します。  
+  
+ サービス:  
+  
+-   <xref:System.Activities.Presentation.Model.AttachedPropertiesService>: <xref:System.Activities.Presentation.Model.AttachedPropertiesService.AddProperty%2A> を使用して現在のインスタンスにプロパティを追加できます。  
+  
+-   <xref:System.Activities.Presentation.View.DesignerView>: デザイナー キャンバスのプロパティにアクセスできるようにします。  
+  
+-   <xref:System.Activities.Presentation.IActivityToolboxService>: ツールボックスの内容を更新できるようにします。  
+  
+-   <xref:System.Activities.Presentation.Hosting.ICommandService>: デザイナー コマンド \(コンテキスト メニューなど\) をカスタム提供サービスの実装と統合するために使用します。  
+  
+-   <xref:System.Activities.Presentation.Debug.IDesignerDebugView>: デザイナー デバッガーの機能を提供します。  
+  
+-   <xref:System.Activities.Presentation.View.IExpressionEditorService>: \[式エディター\] ダイアログへのアクセスを可能にします。  
+  
+-   <xref:System.Activities.Presentation.IIntegratedHelpService>: デザイナーに統合ヘルプ機能を提供します。  
+  
+-   <xref:System.Activities.Presentation.Validation.IValidationErrorService>:  <xref:System.Activities.Presentation.Validation.IValidationErrorService.ShowValidationErrors%2A> を使用した検証エラーへのアクセスを可能にします。  
+  
+-   <xref:System.Activities.Presentation.IWorkflowDesignerStorageService>: データを格納および取得するための内部サービスを提供します。このサービスは、.Net Framework によって内部的に使用されます。外部での使用を目的としていません。  
+  
+-   <xref:System.Activities.Presentation.IXamlLoadErrorService>:  <xref:System.Activities.Presentation.IXamlLoadErrorService.ShowXamlLoadErrors%2A> を使用した XAML 読み込みエラー コレクションへのアクセスを可能にします。  
+  
+-   <xref:System.Activities.Presentation.Services.ModelService>: 編集されているワークフローのモデルと対話するためにデザイナーによって使用されます。  
+  
+-   <xref:System.Activities.Presentation.Model.ModelTreeManager>:  <xref:System.Activities.Presentation.Model.ModelItem.Root%2A> を使用したモデル アイテム ツリーのルートへのアクセスを可能にします。  
+  
+-   <xref:System.Activities.Presentation.UndoEngine>: 元に戻す機能とやり直し機能を提供します。  
+  
+-   <xref:System.Activities.Presentation.Services.ViewService>: 基になるモデル アイテムにビジュアル要素をマップします。  
+  
+-   <xref:System.Activities.Presentation.View.ViewStateService>: モデル アイテムのビュー ステートを格納します。  
+  
+-   <xref:System.Activities.Presentation.View.VirtualizedContainerService>: 仮想コンテナーの UI 動作をカスタマイズするために使用します。  
+  
+-   <xref:System.Activities.Presentation.Hosting.WindowHelperService>: イベント通知のデリゲートを登録および登録解除するために使用します。ウィンドウ所有者も設定できます。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-tracking-to-troubleshoot-applications.md b/docs/framework/windows-workflow-foundation/using-tracking-to-troubleshoot-applications.md
new file mode 100644
index 00000000000..e8e46711bcf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-tracking-to-troubleshoot-applications.md
@@ -0,0 +1,62 @@
+---
+title: "追跡を使用したアプリケーションのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8851adde-c3c2-4391-9523-d8eb831490af
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 追跡を使用したアプリケーションのトラブルシューティング
+[!INCLUDE[wf](../../../includes/wf-md.md)] を使用すると、ワークフロー関連の情報を追跡して、詳細を [!INCLUDE[wf2](../../../includes/wf2-md.md)] アプリケーションまたはサービスの実行に提供できます。[!INCLUDE[wf2](../../../includes/wf2-md.md)] ホストでは、ワークフロー インスタンスの実行中に、ワークフロー イベントをキャプチャできます。ワークフローがエラーまたは例外を生成すると、[!INCLUDE[wf2](../../../includes/wf2-md.md)] の追跡の詳細を使用して処理の問題を解決できます。  
+  
+## WF の追跡を使用した WF のトラブルシューティング  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] アクティビティの処理内のエラーを検出するために、Faulted の状態を持つ <xref:System.Activities.Tracking.ActivityStateRecord> を照会する追跡プロファイルを使用して追跡を有効にすることができます。対応するクエリは、次のコードで指定されています。  
+  
+```  
+<activityStateQueries>  
+              <activityStateQuery activityName="*">  
+                <states>  
+                  <state name="Faulted" />  
+                </states>  
+              </activityStateQuery>  
+ </activityStateQueries>  
+```  
+  
+ エラーがエラー ハンドラー \(<xref:System.Activities.Statements.TryCatch> アクティビティなど\) 内で反映および処理される場合、<xref:System.Activities.Tracking.FaultPropagationRecord> を使用して検出できます。<xref:System.Activities.Tracking.FaultPropagationRecord> は、エラーのソース アクティビティとエラー ハンドラーの名前を示します。<xref:System.Activities.Tracking.FaultPropagationRecord> には、エラーに関する例外スタックの形式でエラーの詳細が含まれます。<xref:System.Activities.Tracking.FaultPropagationRecord> を定期受信するクエリを次の例に示します。  
+  
+```  
+<faultPropagationQueries>  
+              <faultPropagationQuery faultSourceActivityName ="*" faultHandlerActivityName="*"/>  
+ </faultPropagationQueries>  
+  
+```  
+  
+ エラーがワークフロー内で処理されない場合は、ワークフロー インスタンスでハンドルされない例外になり、ワークフロー インスタンスは中止されます。ハンドルされない例外の詳細を把握するために、追跡プロファイルでは、次のように `state name=”UnhandledException”` を持つワークフロー インスタンス レコードを照会する必要があります。  
+  
+```  
+<workflowInstanceQueries>  
+              <workflowInstanceQuery>  
+                <states>  
+                  <state name="UnhandledException" />  
+                </states>  
+              </workflowInstanceQuery>  
+</workflowInstanceQueries>  
+```  
+  
+ [!INCLUDE[wf2](../../../includes/wf2-md.md)] の追跡が有効になっている場合、ワークフロー インスタンスでハンドルされていない例外が発生すると、<xref:System.Activities.Tracking.WorkflowInstanceUnhandledExceptionRecord> オブジェクトが出力されます。  
+  
+ この追跡レコードには、例外スタックの形式でエラーの詳細が含まれます。この詳細には、失敗し、ハンドルされない例外になったエラーのソース \(アクティビティなど\) の詳細が含まれます。[!INCLUDE[wf2](../../../includes/wf2-md.md)] のエラー イベントを定期受信するには、追跡参加要素を追加することによって、追跡を有効にします。この参加要素は、`ActivityStateQuery (state=”Faulted”)`、<xref:System.Activities.Tracking.FaultPropagationRecord>、および `WorkflowInstanceQuery (state=”UnhandledException”)` を照会する追跡プロファイルで構成します。  
+  
+ ETW 追跡参加要素を使用して追跡を有効にした場合、エラー イベントは ETW セッションに書き出されます。イベントはイベント ビューアーを使用して表示できます。これは、分析チャネルのノードで **\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して、**\[アプリケーション サーバー \- アプリケーション\]** で確認できます。  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-workflowidentity-and-versioning.md b/docs/framework/windows-workflow-foundation/using-workflowidentity-and-versioning.md
new file mode 100644
index 00000000000..3e8008ca723
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-workflowidentity-and-versioning.md
@@ -0,0 +1,164 @@
+---
+title: "WorkflowIdentity と Versioning の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: b8451735-8046-478f-912b-40870a6c0c3a
+caps.latest.revision: 6
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 6
+---
+# WorkflowIdentity と Versioning の使用
+<xref:System.Activities.WorkflowIdentity> を使用すると、ワークフロー アプリケーションの開発者は、名前と <xref:System.Version> をワークフロー定義に関連付け、永続化されたワークフロー インスタンスにこの情報を関連付けることができます。この ID 情報は、ワークフロー アプリケーションの開発者がワークフロー定義の複数のバージョンの side\-by\-side 実行などのシナリオを有効にするために使用できます。また、動的更新などの他の機能の基礎となります。このトピックでは、<xref:System.Activities.WorkflowApplication> ホスティングでの <xref:System.Activities.WorkflowIdentity> の使用の概要について説明します。ワークフロー サービスでのワークフロー定義の side\-by\-side 実行の詳細については、「[WorkflowServiceHost による side\-by\-side でのバージョン管理](../../../docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md)」を参照してください。動的更新については、「[動的な更新](../../../docs/framework/windows-workflow-foundation//dynamic-update.md)」を参照してください。  
+  
+## このトピックの内容  
+  
+-   [WorkflowIdentity の使用](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#UsingWorkflowIdentity)  
+  
+    -   [WorkflowIdentity を使用した side-by-side 実行](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#SxS)  
+  
+-   [ワークフローのバージョン管理をサポートする .NET Framework 4 永続性データベースのアップグレード](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#UpdatingWF4PersistenceDatabases)  
+  
+    -   [データベース スキーマをアップグレードするには](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#ToUpgrade)  
+  
+##  <a name="UsingWorkflowIdentity"></a> WorkflowIdentity の使用  
+ <xref:System.Activities.WorkflowIdentity> を使用するには、インスタンスを作成および構成し、<xref:System.Activities.WorkflowApplication> インスタンスに関連付けます。<xref:System.Activities.WorkflowIdentity> インスタンスには 3 種類の識別情報が格納されます。<xref:System.Activities.WorkflowIdentity.Name%2A> と <xref:System.Activities.WorkflowIdentity.Version%2A> は必須で、名前と <xref:System.Version> を表します。また、<xref:System.Activities.WorkflowIdentity.Package%2A> は省略可能で、アセンブリ名やその他の必要な情報などの情報を格納する追加文字列の指定に使用できます。<xref:System.Activities.WorkflowIdentity> は、その 3 つのプロパティのいずれかが他の <xref:System.Activities.WorkflowIdentity> と異なる場合に一意です。  
+  
+> [!IMPORTANT]
+>  <xref:System.Activities.WorkflowIdentity> には、個人を特定できる情報 \(PII\) を含めないでください。インスタンスの作成に使用される <xref:System.Activities.WorkflowIdentity> に関する情報は、ランタイムによるアクティビティ ライフ サイクルのさまざまなポイントで構成されているすべての追跡サービスに出力されます。WF の追跡には PII \(機密ユーザー データ\) を非表示にするメカニズムがありません。そのため、<xref:System.Activities.WorkflowIdentity> インスタンスには PII データを含めないでください。PII データは、ランタイムによって追跡レコードに出力され、追跡レコードを表示するためのアクセス権を持つユーザーに表示できます。  
+  
+ 次の例では、<xref:System.Activities.WorkflowIdentity> を作成し、`MortgageWorkflow` のワークフロー定義を使用して作成したワークフローのインスタンスに関連付けます。  
+  
+```csharp  
+WorkflowIdentity identityV1 = new WorkflowIdentity  
+{  
+    Name = "MortgageWorkflow v1",  
+    Version = new Version(1, 0, 0, 0)  
+};  
+  
+WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow(), identity);  
+  
+// Configure the WorkflowApplication with persistence and desired workflow event handlers.  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Run the workflow.  
+wfApp.Run();  
+```  
+  
+ ワークフローを再読み込みして再開すると、永続化されたワークフロー インスタンスの <xref:System.Activities.WorkflowIdentity> と一致するように構成されている <xref:System.Activities.WorkflowIdentity> を使用する必要があります。  
+  
+```csharp  
+WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow(), identityV1);  
+  
+// Configure the WorkflowApplication with persistence and desired workflow event handlers.  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Load the workflow.  
+wfApp.Load(instanceId);  
+  
+// Resume the workflow...  
+```  
+  
+ ワークフロー インスタンスの再読み込み時に使用される <xref:System.Activities.WorkflowIdentity> が永続化された <xref:System.Activities.WorkflowIdentity> と一致しない場合は、<xref:System.Activities.VersionMismatchException> がスローされます。次の例では、前の例で永続化された `MortgageWorkflow` インスタンスで読み込み操作が行われます。この読み込み操作は、永続化されたインスタンスと一致しない、住宅ローン ワークフローの新しいバージョン用に構成された <xref:System.Activities.WorkflowIdentity> を使用して行われます。  
+  
+```csharp  
+WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow_v2(), identityV2);  
+  
+// Configure the WorkflowApplication with persistence and desired workflow event handlers.  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Attempt to load the workflow instance.  
+wfApp.Load(instanceId);  
+  
+// Resume the workflow...  
+```  
+  
+ 前のコードが実行されると、次の <xref:System.Activities.VersionMismatchException> がスローされます。  
+  
+ **読み込まれたインスタンスの WorkflowIdentity \('MortgageWorkflow v1; Version\=1.0.0.0'\) が、指定されたワークフロー定義の WorkflowIdentity \('MortgageWorkflow v2; Version\=2.0.0.0'\) と一致しません。別の定義を使用してインスタンスを読み込むか、動的更新を使用してインスタンスを更新してください。**   
+###  <a name="SxS"></a> WorkflowIdentity を使用した side\-by\-side 実行  
+ <xref:System.Activities.WorkflowIdentity> を使用すると、ワークフローの複数のバージョンの side\-by\-side 実行を簡略化できます。たとえば、実行時間の長いワークフローのビジネス要件を変更します。ワークフローの多くのインスタンスは、更新されたバージョンを配置すると実行できます。ホスト アプリケーションは、新しいインスタンスの開始時に更新されたワークフロー定義を使用するよう構成できます。また、インスタンスの再開時に適切なワークフロー定義を指定するのはホスト アプリケーションの役割です。<xref:System.Activities.WorkflowIdentity> を使用すると、ワークフロー インスタンスの再開時に、一致するワークフロー定義を特定して指定できます。  
+  
+ 永続化されたワークフロー インスタンスの <xref:System.Activities.WorkflowIdentity> を取得するには、<xref:System.Activities.WorkflowApplication.GetInstance%2A> メソッドを使用します。<xref:System.Activities.WorkflowApplication.GetInstance%2A> メソッドは、永続化されたワークフロー インスタンスの <xref:System.Activities.WorkflowApplication.Id%2A>、および永続化されたインスタンスを格納する <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を取得して、<xref:System.Activities.WorkflowApplicationInstance> を返します。<xref:System.Activities.WorkflowApplicationInstance> には、永続化されたワークフロー インスタンスに関する情報 \(関連付けられた <xref:System.Activities.WorkflowIdentity> など\) が格納されます。この関連付けられた <xref:System.Activities.WorkflowIdentity> は、ワークフロー インスタンスを読み込んで再開するときに、適切なワークフロー定義を指定するためにホストで使用できます。  
+  
+> [!NOTE]
+>  null の <xref:System.Activities.WorkflowIdentity> は有効で、ホストで使用すると、関連付けられた <xref:System.Activities.WorkflowIdentity> がない、永続化されたインスタンスを適切なワークフロー定義にマップできます。このシナリオは、ワークフロー アプリケーションがワークフローのバージョン管理で最初に記述されなかった場合、またはアプリケーションが [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] からアップグレードされた場合に発生する可能性があります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]、「[ワークフローのバージョン管理をサポートする .NET Framework 4 永続性データベースのアップグレード](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#UpdatingWF4PersistenceDatabases)」を参照してください。  
+  
+ 次の例では、`Dictionary<WorkflowIdentity, Activity>` を使用して <xref:System.Activities.WorkflowIdentity> インスタンスが一致するワークフロー定義に関連付けられ、ワークフローは、`identityV1`<xref:System.Activities.WorkflowIdentity> に関連付けられている `MortgageWorkflow` ワークフロー定義を使用して開始されます。  
+  
+```csharp  
+WorkflowIdentity identityV1 = new WorkflowIdentity  
+{  
+    Name = "MortgageWorkflow v1",  
+    Version = new Version(1, 0, 0, 0)  
+};  
+  
+WorkflowIdentity identityV2 = new WorkflowIdentity  
+{  
+    Name = "MortgageWorkflow v2",  
+    Version = new Version(2, 0, 0, 0)  
+};  
+  
+Dictionary<WorkflowIdentity, Activity> WorkflowVersionMap = new Dictionary<WorkflowIdentity, Activity>();  
+WorkflowVersionMap.Add(identityV1, new MortgageWorkflow());  
+WorkflowVersionMap.Add(identityV2, new MortgageWorkflow_v2());  
+  
+WorkflowApplication wfApp = new WorkflowApplication(new MortgageWorkflow(), identityV1);  
+  
+// Configure the WorkflowApplication with persistence and desired workflow event handlers.  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Run the workflow.  
+wfApp.Run();  
+```  
+  
+ 次の例では、前の例の永続化されたワークフロー インスタンスに関する情報を <xref:System.Activities.WorkflowApplication.GetInstance%2A> を呼び出すことによって取得し、永続化された <xref:System.Activities.WorkflowIdentity> の情報を使用して一致するワークフロー定義を取得します。この情報を使用して <xref:System.Activities.WorkflowApplication> を構成すると、ワークフローが読み込まれます。<xref:System.Activities.WorkflowApplicationInstance> を受け取る <xref:System.Activities.WorkflowApplication.Load%2A> オーバーロードが使用されるため、<xref:System.Activities.WorkflowApplicationInstance> で構成された <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> が <xref:System.Activities.WorkflowApplication> によって使用され、その結果、その <xref:System.Activities.WorkflowApplication.InstanceStore%2A> プロパティを構成する必要はありません。  
+  
+> [!NOTE]
+>  <xref:System.Activities.WorkflowApplication.InstanceStore%2A> プロパティを設定する場合は、<xref:System.Activities.WorkflowApplicationInstance> によって使用されるのと同じ <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> インスタンスで設定する必要があります。そうしないと、<xref:System.ArgumentException> がスローされ、"`The instance is configured with a different InstanceStore than this WorkflowApplication.`" というメッセージが表示されます。  
+  
+```csharp  
+// Get the WorkflowApplicationInstance of the desired workflow from the specified  
+// SqlWorkflowInstanceStore.  
+WorkflowApplicationInstance instance = WorkflowApplication.GetInstance(instanceId, store);  
+  
+// Use the persisted WorkflowIdentity to retrieve the correct workflow  
+// definition from the dictionary.  
+Activity definition = WorkflowVersionMap[instance.DefinitionIdentity];  
+  
+WorkflowApplication wfApp = new WorkflowApplication(definition, instance.DefinitionIdentity);  
+  
+// Configure the WorkflowApplication with persistence and desired workflow event handlers.  
+ConfigureWorkflowApplication(wfApp);  
+  
+// Load the persisted workflow instance.  
+wfApp.Load(instance);  
+  
+// Resume the workflow...  
+```  
+  
+##  <a name="UpdatingWF4PersistenceDatabases"></a> ワークフローのバージョン管理をサポートする .NET Framework 4 永続性データベースのアップグレード  
+ SqlWorkflowInstanceStoreSchemaUpgrade.sql データベース スクリプトは、[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] データベース スクリプトを使用して作成された永続性データベースを更新するために用意されています。このスクリプトは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された新しいバージョン管理機能をサポートするようにデータベースを更新します。データベースで永続化されたすべてのワークフロー インスタンスは、既定のバージョン番号が付与されるため、side\-by\-side 実行および動的更新に参加できるようになります。  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] ワークフロー アプリケーションが、提供されたスクリプトを使用してアップグレードされていない永続性データベースで新しいバージョン管理機能を使用する永続化操作を実行すると、<xref:System.Runtime.DurableInstancing.InstancePersistenceCommandException> がスローされ、次のようなメッセージが表示されます。  
+  
+ **SqlWorkflowInstanceStore のデータベースのバージョンが '4.0.0.0' です。このバージョンのデータベースに対して InstancePersistenceCommand 'System.Activities.DurableInstancing.CreateWorkflowOwnerWithIdentityCommand' を実行することはできません。データベースを '4.5.0.0' にアップグレードしてください。**   
+###  <a name="ToUpgrade"></a> データベース スキーマをアップグレードするには  
+  
+1.  SQL Server Management Studio を開き、**.\\SQLEXPRESS** などの永続性データベース サーバーに接続します。  
+  
+2.  **\[ファイル\]** メニューの **\[開く\]** をポイントし、**\[ファイル\]** をクリックします。次のフォルダーに移動します: `C:\Windows\Microsoft.NET\Framework\4.0.30319\sql\en`。  
+  
+3.  **SqlWorkflowInstanceStoreSchemaUpgrade.sql** を選択して **\[開く\]** をクリックします。  
+  
+4.  **\[使用できるデータベース\]** ボックスの一覧で、永続性データベースの名前を選択します。  
+  
+5.  **\[クエリ\]** メニューの **\[実行\]** をクリックします。  
+  
+ クエリが完了すると、データベース スキーマがアップグレードされるため、必要に応じて、永続化されたワークフロー インスタンスに割り当てられた既定のワークフロー ID を確認できます。**オブジェクト エクスプローラー**の **\[データベース\]** ノードで永続性データベースを展開し、**\[ビュー\]** ノードを展開します。**System.Activities.DurableInstancing.Instances** を右クリックし、**\[上位 1000 行の選択\]** を選択します。列の末尾までスクロールし、**IdentityName**、**IdentityPackage**、**Build**、**Major**、**Minor**、および **Revision** の 6 つの列がビューに追加されていることを確認します。すべての永続化されたワークフローでは、これらのフィールドに値 **NULL** が設定されており、null のワークフロー ID を表します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/using-workflowinvoker-and-workflowapplication.md b/docs/framework/windows-workflow-foundation/using-workflowinvoker-and-workflowapplication.md
new file mode 100644
index 00000000000..1885c9e4bcd
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/using-workflowinvoker-and-workflowapplication.md
@@ -0,0 +1,102 @@
+---
+title: "WorkflowInvoker と WorkflowApplication の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cd0e583c-a3f9-4fa2-b247-c7b3368c48a7
+caps.latest.revision: 19
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 19
+---
+# WorkflowInvoker と WorkflowApplication の使用
+[!INCLUDE[wf](../../../includes/wf-md.md)] は、ワーク フロー ホスティングのいくつかのメソッドを提供します。<xref:System.Activities.WorkflowInvoker> は、メソッド呼び出しのようにワークフローを呼び出す単純な方法を提供し、永続化を使用しないワーク フローにのみ使用できます。<xref:System.Activities.WorkflowApplication> は、ライフサイクル イベントの通知、実行制御、ブックマークの再開、および永続化を含むワークフローを実行するための多様なモデルを提供します。<xref:System.ServiceModel.Activities.WorkflowServiceHost> は、メッセージング アクティビティをサポートし、主にワーク フロー サービスと一緒に使用されます。このトピックでは、<xref:System.Activities.WorkflowInvoker> と <xref:System.Activities.WorkflowApplication> を使用したワークフロー ホスティングついて説明します。<xref:System.ServiceModel.Activities.WorkflowServiceHost> を使用したワークフロー ホスティング[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[ワークフロー サービス](../../../docs/framework/wcf/feature-details/workflow-services.md)」および「[ワークフロー サービスのホストの概要](../../../docs/framework/wcf/feature-details/hosting-workflow-services-overview.md)」を参照してください。  
+  
+## WorkflowInvoker の使用  
+ <xref:System.Activities.WorkflowInvoker> は、メソッドを呼び出すようにワークフローを実行するモデルを提供します。<xref:System.Activities.WorkflowInvoker> を使用してワークフローを呼び出すには、<xref:System.Activities.WorkflowInvoker.Invoke%2A> メソッドを呼び出し、呼び出すワークフローのワークフロー定義を渡します。次の例では、<xref:System.Activities.WorkflowInvoker> を使用して <xref:System.Activities.Statements.WriteLine> アクティビティを呼び出します。  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#1](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#1)]  
+  
+ <xref:System.Activities.WorkflowInvoker> を使用してワークフローを呼び出すと、呼び出し元のスレッドでワークフローが実行され、ワークフローが完了するまで \(アイドル時間を含む\) <xref:System.Activities.WorkflowInvoker.Invoke%2A> メソッドがブロックされます。ワークフローを完了しなければならないタイムアウト期間を構成するには、<xref:System.TimeSpan> パラメーターを受け取る <xref:System.Activities.WorkflowInvoker.Invoke%2A> オーバーロードのいずれかを使用します。この例では、2 つの異なるタイムアウト期間を使用してワークフローを 2 回呼び出します。最初のワークフローは完了しますが、2 回目は完了しません。  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#50](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#50)]  
+  
+> [!NOTE]
+>  <xref:System.TimeoutException> がスローされるのは、タイムアウト期間が経過してワークフローが実行中にアイドル状態になった場合だけです。指定されたタイムアウト期間内には完了しないワークフローが正常に完了するのは、アイドル状態にならない場合です。  
+  
+ <xref:System.Activities.WorkflowInvoker> も非同期バージョンのメソッド呼び出しを提供します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.Activities.WorkflowInvoker.InvokeAsync%2A> および <xref:System.Activities.WorkflowInvoker.BeginInvoke%2A>。  
+  
+### ワークフローの入力引数の設定  
+ ワークフローの入力引数にマップされ、引数名によってキー指定されている入力パラメーターの辞書を使用して、データをワークフローに渡すことができます。次の例では、<xref:System.Activities.Statements.WriteLine> が呼び出され、その <xref:System.Activities.Statements.WriteLine.Text%2A> 引数の値は入力パラメーターの辞書を使用して指定されています。  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#3](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#3)]  
+  
+### ワークフローの出力引数の取得  
+ ワークフローの出力パラメーターは、<xref:System.Activities.WorkflowInvoker.Invoke%2A> の呼び出しから返される出力辞書を使用して取得できます。次の例は、2 つの入力引数と 2 つの出力引数を持つ 1 つの `Divide` アクティビティで構成されるワークフローを呼び出します。ワークフローを呼び出すと、`arguments` 辞書が渡されます。ここには引数名でキー指定された各入力引数の値が含まれています。`Invoke` の呼び出しから制御が戻るときに、同様に引数名でキー指定された各出力引数が、`outputs` 辞書で返されます。  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#120](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#120)]  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#20](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#20)]  
+  
+ ワークフローが `CodeActivity<TResult>` や `Activity<TResult>` などの <xref:System.Activities.ActivityWithResult> から派生し、適切に定義された <xref:System.Activities.Activity%601.Result%2A> 出力引数以外にも出力引数がある場合は、`Invoke` の非ジェネリック オーバーロードを使用して、追加の引数を取得する必要があります。これを行うには、`Invoke` に渡されるワークフロー定義は <xref:System.Activities.Activity> 型である必要があります。この例では、`Divide` アクティビティは `CodeActivity<int>` から派生していますが、<xref:System.Activities.Activity> として宣言されているため、1 つの戻り値ではなく引数の辞書を返す、`Invoke` の非ジェネリック オーバーロードが使用されます。  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#121](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#121)]  
+  
+ [!code-csharp[CFX_WorkflowInvokerExample#21](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs#21)]  
+  
+## WorkflowApplication の使用  
+ <xref:System.Activities.WorkflowApplication> は、ワークフロー インスタンス管理を実現する豊富な機能群を備えています。<xref:System.Activities.WorkflowApplication> は実際の <xref:System.Activities.Hosting.WorkflowInstance> に対してスレッド セーフなプロキシとして動作し、ランタイムをカプセル化します。また、ワークフロー インスタンスの作成と読み込み、ライフサイクル イベントの一時停止と再開、終了、および通知を行うメソッドを提供します。<xref:System.Activities.WorkflowApplication> を使用してワークフローを実行するには、<xref:System.Activities.WorkflowApplication> を作成して必要なライフサイクル イベントに定期受信し、ワークフローを開始して、それが終了するまで待機します。この例では、<xref:System.Activities.Statements.WriteLine> アクティビティから成るワークフロー定義が作成され、そのワークフロー定義を使用して <xref:System.Activities.WorkflowApplication> が作成されます。ワーク フローが完了したときにホストに通知されるように <xref:System.Activities.WorkflowApplication.Completed%2A> が処理され、<xref:System.Activities.WorkflowApplication.Run%2A> の呼び出しによってワーク フローが開始され、ホストはワークフローが完了するのを待ちます。次の例に示すように、ワークフローが完了すると <xref:System.Threading.AutoResetEvent> が設定され、ホスト アプリケーションは実行を再開できます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#31](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#31)]  
+  
+### WorkflowApplication のライフサイクル イベント  
+ <xref:System.Activities.WorkflowApplication.Completed%2A> の他にも、ワークフローがアンロードされたとき \(<xref:System.Activities.WorkflowApplication.Unloaded%2A>\)、中止されたとき \(<xref:System.Activities.WorkflowApplication.Aborted%2A>\)、アイドル状態になったとき \(<xref:System.Activities.WorkflowApplication.Idle%2A> および <xref:System.Activities.WorkflowApplication.PersistableIdle%2A>\)、または未処理の例外が発生したとき \(<xref:System.Activities.WorkflowApplication.OnUnhandledException%2A>\) にホストの作成者に通知されます。次の例に示すように、ワークフロー アプリケーションの開発者はこれらの通知を処理して適切なアクションを行うことができます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#32](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#32)]  
+  
+### ワークフローの入力引数の設定  
+ <xref:System.Activities.WorkflowInvoker> を使用しているときにデータを渡す方法と同様に、起動時にパラメーターの辞書を使用してデータをワークフローに渡すことができます。辞書の各項目は、指定されたワークフローの入力引数にマップされます。次の例では、<xref:System.Activities.Statements.WriteLine> アクティビティから成るワークフローが呼び出され、その <xref:System.Activities.Statements.WriteLine.Text%2A> 引数が入力パラメーターの辞書を使用して指定されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#30](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#30)]  
+  
+### ワークフローの出力引数の取得  
+ ワークフローが完了したら、<xref:System.Activities.WorkflowApplicationCompletedEventArgs.Outputs%2A?displayProperty=fullName> 辞書にアクセスして、<xref:System.Activities.WorkflowApplication.Completed%2A> ハンドラーの出力引数を取得できます。次の例は、<xref:System.Activities.WorkflowApplication> を使用したワークフローをホストしています。1 つの `DiceRoll` アクティビティで構成されるワークフロー定義を使用して <xref:System.Activities.WorkflowApplication> インスタンスが構築されます。`DiceRoll` アクティビティには、サイコロ振り操作の結果を表す 2 つの出力引数があります。ワークフローが完了すると、この出力が <xref:System.Activities.WorkflowApplication.Completed%2A> ハンドラーで取得されます。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#130](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#130)]  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#21](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#21)]  
+  
+> [!NOTE]
+>  <xref:System.Activities.WorkflowApplication> と <xref:System.Activities.WorkflowInvoker> は入力引数の辞書を取得し、`out` 引数の辞書を返します。これらの辞書のパラメーター、プロパティ、および戻り値は `IDictionary<string, object>` 型です。渡される辞書クラスの実際のインスタンスには、`IDictionary<string, object>` を実装した任意のクラスを使用できます。これらの例では、`Dictionary<string, object>` が使用されています。ディクショナリ[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「<xref:System.Collections.Generic.IDictionary%602>」および「<xref:System.Collections.Generic.Dictionary%602>」を参照してください。  
+  
+### ブックマークを使用した実行中のワークフローへのデータの受け渡し  
+ ブックマークは、アクティビティが再開されるのを受動的に待機するメカニズムです。また、実行中のワークフロー インスタンスにデータを渡すメカニズムでもあります。次の例に示すように、アクティビティがデータを待機している場合、<xref:System.Activities.Bookmark> を作成し、<xref:System.Activities.Bookmark> が再開されたときに呼び出されるコールバック メソッドを登録します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#15](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#15)]  
+  
+ 実行されると、`ReadLine` アクティビティは <xref:System.Activities.Bookmark> を作成し、コールバックを登録してから、<xref:System.Activities.Bookmark> が再開されるのを待機します。再開されると、`ReadLine` アクティビティは <xref:System.Activities.Bookmark> と一緒に渡されたデータを <xref:System.Activities.Activity%601.Result%2A> 引数に代入します。次の例では、`ReadLine` アクティビティを使用してユーザー名を収集し、それをコンソール ウィンドウに表示するワークフローを作成します。  
+  
+ [!code-csharp[CFX_WorkflowApplicationExample#22](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#22)]  
+  
+ `ReadLine` アクティビティが実行されると、`UserName` という名前の <xref:System.Activities.Bookmark> が作成され、ブックマークが再開されるのを待機します。ホストは必要なデータを収集し、<xref:System.Activities.Bookmark> を再開します。ワークフローが再開されると名前が表示されて、完了します。  
+  
+ ホスト アプリケーションでは、ワークフローを調べて、アクティブなブックマークがあるかどうかを確認できます。この操作を実行するには、<xref:System.Activities.WorkflowApplication> インスタンスの <xref:System.Activities.WorkflowApplication.GetBookmarks%2A> メソッドを呼び出すか、<xref:System.Activities.WorkflowApplication.Idle%2A> ハンドラーの <xref:System.Activities.WorkflowApplicationIdleEventArgs> を調べます。  
+  
+ 次のコード例は前の例と似ていますが、ブックマークを再開する前にアクティブなブックマークを列挙する点が異なります。ワークフローが開始され、<xref:System.Activities.Bookmark> が作成されてワークフローがアイドル状態になると、<xref:System.Activities.WorkflowApplication.GetBookmarks%2A> が呼び出されます。このワークフローが完了すると、次の出力がコンソールに表示されます。  
+  
+ **What is your name?**   
+**BookmarkName: UserName \- OwnerDisplayName: ReadLine**   
+**Steve**   
+**Hello, Steve**  [!code-csharp[CFX_WorkflowApplicationExample#14](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#14)]  
+  
+ <xref:System.Activities.WorkflowApplication> インスタンスの <xref:System.Activities.WorkflowApplication.Idle%2A> ハンドラーに渡される <xref:System.Activities.WorkflowApplicationIdleEventArgs> を調べるコード サンプルを次に示します。この例では、アイドル状態になるワークフローに、`EnterGuess` という名前で `ReadInt` というアクティビティによって所有されている 1 つの <xref:System.Activities.Bookmark> があります。このコード例は、「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の一部である「[ワークフローを実行する方法](../../../docs/framework/windows-workflow-foundation//how-to-run-a-workflow.md)」のサンプルの一部です。この例のコードを含めるようにこの手順の <xref:System.Activities.WorkflowApplication.Idle%2A> ハンドラーを変更すると、次の出力が表示されます。  
+  
+ **BookmarkName: EnterGuess \- OwnerDisplayName: ReadInt** [!code-csharp[CFX_WorkflowApplicationExample#2](../../../samples/snippets/csharp/VS_Snippets_CFX/cfx_workflowapplicationexample/cs/program.cs#2)]  
+  
+## 概要  
+ <xref:System.Activities.WorkflowInvoker> はワークフローを呼び出す簡単な方法を提供します。また、ワークフローの開始時にデータを渡し、完了したワークフローからデータを抽出する方法を提供しますが、<xref:System.Activities.WorkflowApplication> を使用できるような複雑なシナリオには使用できません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/variable-and-argument-tracking.md b/docs/framework/windows-workflow-foundation/variable-and-argument-tracking.md
new file mode 100644
index 00000000000..a054bdad0e9
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/variable-and-argument-tracking.md
@@ -0,0 +1,57 @@
+---
+title: "変数と引数の追跡 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 8f3d9d30-d899-49aa-b7ce-a8d0d32c4ff0
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# 変数と引数の追跡
+ワークフローの実行を追跡するときは、データを抽出すると便利です。これにより、実行後に追跡レコードにアクセスするときにコンテキストが追加されます。[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] では、追跡を使用して、ワークフローのアクティビティのスコープ内の参照可能な変数や引数を抽出できます。プロファイルを追跡すると、データを簡単に抽出できるようになります。  
+  
+## 変数と引数  
+ 変数および引数が抽出されるのは、アクティビティが ActivityStateRecord を生成したときです。変数は、アクティビティのスコープ内にある場合にのみ抽出の対象となります。アクティビティ内に抽出する変数は、次のように指定します。  
+  
+-   変数名によって変数が指定されている場合、追跡されている現在のアクティビティと親アクティビティ内の変数が追跡で検索されます。変数は、現在のアクティビティのスコープと親スコープ内で検索されます。  
+  
+-   抽出される変数が name\="\*" を使用して指定されている場合、追跡されている現在のアクティビティ内のすべての変数が抽出されます。この場合、スコープ内の変数でも、親アクティビティで定義されているものは抽出されません。  
+  
+ 引数の抽出時、抽出される引数はアクティビティの状態によって異なります。アクティビティの状態が Executing である場合、`InArguments` のみが抽出に使用できます。他のアクティビティ状態 \(Closed、Faulted、Canceled\) については、すべての引数、InArguments と OutArguments の両方が抽出に使用できます。  
+  
+ 次の例は、アクティビティの `Closed` 追跡レコードが生成されたときに変数と引数を抽出するアクティビティ状態クエリを示しています。変数と引数は、<xref:System.Activities.Tracking.ActivityStateRecord> でのみ抽出できるため、<xref:System.Activities.Tracking.ActivityStateQuery> を使用して追跡プロファイル内で定期受信されます。  
+  
+```  
+<activityStateQuery activityName="SendEmailActivity">  
+  <states>  
+    <state name="Closed"/>  
+  </states>  
+  <variables>  
+    <variable name="FromAddress"/>  
+  </variables>  
+  <arguments>  
+    <argument name="Result"/>  
+  </arguments>  
+</activityStateQuery>  
+  
+```  
+  
+## 変数および引数に格納される情報の保護  
+ 追跡される変数や引数は、既定では WF ランタイムによって参照可能になります。ワークフローの開発者は、次のような手順を行うことで、追跡対象の変数や引数へのアクセスを防止できます。  
+  
+1.  変数の値を暗号化します。  
+  
+2.  追跡プロファイルの作成を管理して、変数や引数の抽出を防止します。  
+  
+3.  カスタムの追跡参加要素については、変数や引数に格納されている機密情報が WF コードによって公開されないようにします。  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/variables-and-arguments.md b/docs/framework/windows-workflow-foundation/variables-and-arguments.md
new file mode 100644
index 00000000000..f46a1ea1de2
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/variables-and-arguments.md
@@ -0,0 +1,149 @@
+---
+title: "変数と引数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: d03dbe34-5b2e-4f21-8b57-693ee49611b8
+caps.latest.revision: 15
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 15
+---
+# 変数と引数
+[!INCLUDE[wf](../../../includes/wf-md.md)] では、変数はデータ ストレージを表し、引数はアクティビティとのデータ フローを表します。アクティビティには一連の引数があり、その引数はアクティビティの署名を構成します。また、アクティビティは開発者がワークフローの設計時に変数を追加または削除できる変数のリストを保持しています。引数は、値を返す式を使用してバインドされます。  
+  
+## 変数  
+ 変数はデータを保存する場所です。変数はワークフロー定義の一部として宣言されます。変数は実行時に値を受け取ります。これらの値はワークフロー インスタンスの状態の一部として保存されます。変数の定義では、変数の型を指定します。オプションで名前を指定する場合もあります。変数を宣言し、<xref:System.Activities.Statements.Assign%601> アクティビティを使用して変数に値を代入し、その値を <xref:System.Activities.Statements.WriteLine> アクティビティを使用してコンソールに表示する方法を次のコードに示します。  
+  
+```csharp  
+// Define a variable named "str" of type string.  
+Variable<string> var = new Variable<string>  
+{  
+    Name = "str"  
+};  
+  
+// Declare the variable within a Sequence, assign  
+// a value to it, and then display it.  
+Activity wf = new Sequence()  
+{  
+    Variables = { var },  
+    Activities =  
+    {  
+        new Assign<string>  
+        {  
+            To = var,  
+            Value = "Hello World."  
+        },  
+        new WriteLine  
+        {  
+            Text = var  
+        }  
+    }  
+};  
+  
+WorkflowInvoker.Invoke(wf);  
+```  
+  
+ オプションで、変数宣言の一部として既定値の式を指定できます。また、変数は修飾子を使用することもできます。たとえば変数が読み取り専用の場合は、読み取り専用の <xref:System.Activities.VariableModifiers> 修飾子を適用できます。次の例では、既定値を代入した読み取り専用の変数を作成します。  
+  
+```csharp  
+// Define a read-only variable with a default value.  
+Variable<string> var = new Variable<string>  
+{  
+    Default = "Hello World.",  
+    Modifiers = VariableModifiers.ReadOnly  
+};  
+```  
+  
+## 変数のスコープ  
+ 実行時の変数の有効期間は、変数を宣言したアクティビティの有効期間と同じです。アクティビティが完了すると、その変数はクリーンアップされ、その後は参照できません。  
+  
+## 引数  
+ アクティビティの作成者は、引数を使用してアクティビティとのデータ フローの方法を定義します。各引数には <xref:System.Activities.ArgumentDirection>、<xref:System.Activities.ArgumentDirection>、<xref:System.Activities.ArgumentDirection> などの方向が指定されます。  
+  
+ ワークフロー ランタイムでは、アクティビティへのデータ移動のタイミングについて次のように保証しています。  
+  
+1.  アクティビティが実行を開始すると、すべての入力および入出力引数の値が計算されます。たとえば、<xref:System.Activities.Argument.Get%2A> が呼び出されるタイミングにかかわらず、返される値は `Execute` が呼び出される前にランタイムによって計算された値になります。  
+  
+2.  <xref:System.Activities.InOutArgument%601.Set%2A> が呼び出されると、ランタイムはすぐにその値を設定します。  
+  
+3.  必要に応じて、引数に <xref:System.Activities.Argument.EvaluationOrder%2A> を指定できます。<xref:System.Activities.Argument.EvaluationOrder%2A>は、引数の評価順序を指定するゼロベースの値です。既定では引数の評価順序は指定されておらず、<xref:System.Activities.Argument.UnspecifiedEvaluationOrder> の値と同じです。<xref:System.Activities.Argument.EvaluationOrder%2A> に 0 以上の値を設定して、この引数の評価順序を指定します。[!INCLUDE[wf2](../../../includes/wf2-md.md)] は指定された評価順序を使用して昇順で引数を評価します。評価順序が指定されていない引数は、評価順序が指定されている引数の前に評価されることに注意してください。  
+  
+ アクティビティの作成者は、引数を公開する場合に厳密な型指定のメカニズムを使用できます。これを行うには、<xref:System.Activities.InArgument%601>、<xref:System.Activities.OutArgument%601>、および <xref:System.Activities.InOutArgument%601> の型のプロパティを宣言します。これにより、アクティビティの作成者は、アクティビティに受け渡しするデータの特定のコントラクトを確立できます。  
+  
+### アクティビティの引数の定義  
+ <xref:System.Activities.InArgument%601>、<xref:System.Activities.OutArgument%601>、および <xref:System.Activities.InOutArgument%601> 型のプロパティを指定することで、アクティビティに引数を定義できます。次のコードでは、ユーザーに表示する文字列を受け取り、ユーザーの応答を含む文字列を返す `Prompt` アクティビティの引数を定義する方法を示します。  
+  
+```csharp  
+public class Prompt : Activity  
+{  
+    public InArgument<string> Text { get; set; }  
+    public OutArgument<string> Response { get; set; }  
+    // Rest of activity definition omitted.  
+}  
+```  
+  
+> [!NOTE]
+>  1 つの値を返すアクティビティは、<xref:System.Activities.Activity%601>、<xref:System.Activities.NativeActivity%601>、または <xref:System.Activities.CodeActivity%601> から派生させることができます。これらのアクティビティは、アクティビティの戻り値を含む <xref:System.Activities.Activity%601.Result%2A> という名前の適切に定義された <xref:System.Activities.OutArgument%601> を持っています。  
+  
+### ワークフローでの変数と引数の使用  
+ 次の例は、ワークフローで変数と引数を使用する方法を示しています。このワークフローは、3 つの変数 `var1`、`var2`、`var3` を宣言するシーケンスです。このワークフローの最初のアクティビティは `Assign` アクティビティで、変数 `var1` の値を変数 `var2` に代入します。これに `WriteLine` アクティビティが続き、変数 `var2` の値を出力します。その次はもう 1 つの `Assign` アクティビティで、変数 `var2` の値を変数 `var3` に代入します。最後にもう 1 つの `WriteLine` アクティビティがあり、変数 `var3` の値を出力します。最初の `Assign` アクティビティは、アクティビティの引数のバインディングを明示的に表す `InArgument<string>` オブジェクトと `OutArgument<string>` オブジェクトを使用します。`InArgument<string>` は、値が <xref:System.Activities.Statements.Assign%601> アクティビティにその <xref:System.Activities.Statements.Assign.Value%2A> 引数を通ってフローするので、<xref:System.Activities.Statements.Assign.Value%2A> に使用されます。`OutArgument<string>` は、値が <xref:System.Activities.Statements.Assign.To%2A> 引数から変数へフローするので、<xref:System.Activities.Statements.Assign.To%2A> に使用されます。2 番目の `Assign` アクティビティは、より少ないコードで暗黙的なキャストを使用する同等の構文を使用して同じ内容を実行します。`WriteLine` アクティビティも少ないコードの構文を使用します。  
+  
+```csharp  
+// Declare three variables; the first one is given an initial value.  
+Variable<string> var1 = new Variable<string>()  
+{  
+    Default = "one"  
+};  
+Variable<string> var2 = new Variable<string>();  
+Variable<string> var3 = new Variable<string>();  
+  
+// Define the workflow  
+Activity wf = new Sequence  
+{  
+    Variables = { var1, var2, var3 },  
+    Activities =   
+    {  
+        new Assign<string>()  
+        {  
+            Value = new InArgument<string>(var1),  
+            To = new OutArgument<string>(var2)  
+        },  
+        new WriteLine() { Text = var2 },  
+        new Assign<string>()  
+        {  
+            Value = var2,  
+            To = var3  
+        },  
+        new WriteLine() { Text = var3 }  
+    }  
+};  
+  
+WorkflowInvoker.Invoke(wf);  
+```  
+  
+### コードに基づいたアクティビティでの変数と引数の使用  
+ 前の例は、ワークフローの引数と変数、および宣言型のアクティビティを使用する方法を示しています。引数と変数は、コードに基づくアクティビティでも使用されます。概念上は、使用法は非常に似ています。変数はアクティビティ内のデータ ストレージを表し、引数はアクティビティへのデータ フローを表し、ワークフロー作成者によってワークフローでデータの受け渡しを行う場所を示す他の変数または引数にバインドされます。アクティビティの変数または引数の値を取得または設定するには、アクティビティの現在の実行環境を表すアクティビティ コンテキストを使用する必要があります。これは、ワークフロー ランタイムによってアクティビティの <xref:System.Activities.CodeActivity%601.Execute%2A> メソッドに渡されます。次の例では、2 つの <xref:System.Activities.ArgumentDirection> 引数を持つカスタムの `Add` アクティビティが定義されています。この引数の値にアクセスするために <xref:System.Activities.Argument.Get%2A> メソッドが使用され、ワークフロー ランタイムによって渡されたコンテキストが使用されます。  
+  
+```csharp  
+public sealed class Add : CodeActivity<int>  
+{  
+    [RequiredArgument]  
+    public InArgument<int> Operand1 { get; set; }  
+  
+    [RequiredArgument]  
+    public InArgument<int> Operand2 { get; set; }  
+  
+    protected override int Execute(CodeActivityContext context)  
+    {  
+        return Operand1.Get(context) + Operand2.Get(context);  
+    }  
+}  
+```  
+  
+ コードでの引数、変数、および式の使用[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[命令型コードを使用してワークフロー、アクティビティ、および式を作成する方法](../../../docs/framework/windows-workflow-foundation//authoring-workflows-activities-and-expressions-using-imperative-code.md)」および「[必須の引数とオーバーロード グループ](../../../docs/framework/windows-workflow-foundation//required-arguments-and-overload-groups.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/waiting-for-input-in-a-workflow.md b/docs/framework/windows-workflow-foundation/waiting-for-input-in-a-workflow.md
new file mode 100644
index 00000000000..1327149da0c
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/waiting-for-input-in-a-workflow.md
@@ -0,0 +1,24 @@
+---
+title: "ワークフロー内での入力の待機 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], ブックマーク"
+ms.assetid: 50a007c5-8ab7-4b9a-a7ec-1b7e2f4930fe
+caps.latest.revision: 4
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 4
+---
+# ワークフロー内での入力の待機
+このセクションの各トピックでは、ブックマークとメッセージング アクティビティの使用方法について説明します。  
+  
+## このセクションの内容  
+ [ブックマーク](../../../docs/framework/windows-workflow-foundation//bookmarks.md)  
+ ブックマークの使用方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/wf-features-in-the-rehosted-workflow-designer.md b/docs/framework/windows-workflow-foundation/wf-features-in-the-rehosted-workflow-designer.md
new file mode 100644
index 00000000000..7689906153d
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/wf-features-in-the-rehosted-workflow-designer.md
@@ -0,0 +1,150 @@
+---
+title: "再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 1a4a4038-d8e6-41dd-99ea-93bd76286772
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# 再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の [!INCLUDE[wf](../../../includes/wf-md.md)] には、ワークフロー デザイナー エクスペリエンスの拡張機能を含む、多くの新機能が導入されています。このトピックでは、このような新機能のうち、再ホストされたデザイナーでサポートされている機能と現時点ではサポートされていない機能について詳しく説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された、デザイナーのホスト変更とは関連のない新機能を含む、[!INCLUDE[wf](../../../includes/wf-md.md)] のすべての新機能の一覧については、「[.NET 4.5 での Windows Workflow Foundation の新機能](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md)」を参照してください。  
+  
+## アクティビティ  
+ 組み込みのアクティビティ ライブラリには、既存のアクティビティ用の新しいアクティビティと新しい機能が含まれています。これらの新しいアクティビティはすべて、再ホストされたデザイナーでサポートされています。これらの新しいアクティビティの詳細については、「[.NET 4.5 での Windows Workflow Foundation の新機能](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md)」の「[アクティビティ](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_NewActivities)」を参照してください。  
+  
+## C\# の式  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] より前のバージョンでは、ワークフロー内のすべての式を Visual Basic のみで記述できました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、Visual Basic の式は Visual Basic で作成されたプロジェクトでのみ使用されます。Visual C\# プロジェクトでは、式に C\# が使用されるようになりました。[!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] でワークフローを作成する場合、文法強調表示や Intellisense などの機能を備えた、フル機能の C\# 式エディターが用意されています。以前のバージョンで作成された、Visual Basic の式を使用する C\# ワークフロー プロジェクトは引き続き動作します。  
+  
+> [!WARNING]
+>  C\# の式は、再ホストされたデザイナーではサポートされていません。  
+  
+## デザイナーの新機能  
+  
+### デザイナーでの検索  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された[クイック検索](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_QuickFind)機能と[[フォルダーを指定して検索]](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_FindInFiles)機能は、再ホストされたデザイナーではサポートされていません。`Toolbox` による検索は、再ホストされたデザイナーでもサポートされています。これらの機能の詳細については、「[デザイナーでの検索](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_DesignerSearch)」を参照してください。  
+  
+> [!WARNING]
+>  [クイック検索](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_QuickFind)と[[フォルダーを指定して検索]](../../../docs/framework/windows-workflow-foundation//whats-new-in-wf-in-dotnet.md#BKMK_FindInFiles)は、再ホストされたデザイナーではサポートされていません。  
+  
+### 変数デザイナーと引数デザイナーのコンテキスト メニューの \[削除\]  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、変数および引数を削除できるのは、デザイナーでキーボードを使用した場合のみでした。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、コンテキスト メニューを使用して変数および引数を削除できます。この機能は、再ホストされたデザイナーでサポートされています。  
+  
+ 変数デザイナーと引数デザイナーのコンテキスト メニューを次のスクリーンショットに示しています。  
+  
+ ![変数&#47;引数デザイナーのコンテキスト メニュー](../../../docs/framework/windows-workflow-foundation//media/designercontextmenu.png "DesignerContextMenu")  
+  
+### ブロックの自動挿入シーケンス  
+ ワークフローまたは特定のコンテナー アクティビティ \(<xref:System.Activities.Statements.NoPersistScope> など\) には Body アクティビティを 1 つしか含めることができないため、2 つ目のアクティビティを追加するには、開発者が最初のアクティビティを削除し、<xref:System.Activities.Statements.Sequence> アクティビティを追加してから、シーケンス アクティビティに両方のアクティビティを追加する必要がありました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、デザイナー画面に 2 つ目のアクティビティを追加すると、`Sequence` アクティビティが自動的に作成され、両方のアクティビティがラップされます。この機能は、再ホストされたデザイナーでサポートされています。  
+  
+ 次のスクリーンショットは、`NoPersistScope` の `Body` 内の `WriteLine` アクティビティを示しています。  
+  
+ ![ドロップ位置の自動囲い込み](../../../docs/framework/windows-workflow-foundation//media/autosurround1.png "AutoSurround1")  
+  
+ 次のスクリーンショットは、2 つ目の `WriteLine` を 1 つ目の下にドロップしたときに `Body` 内に自動的に作成された `Sequence` アクティビティを示しています。  
+  
+ ![自動的に作成された Sequence アクティビティ](../../../docs/framework/windows-workflow-foundation//media/autosurround2.png "AutoSurround2")  
+  
+### パン モード  
+ デザイナーで大規模なワークフロー内をより簡単に移動するには、パン モードを有効にすると、開発者は、スクロール バーを使用する必要なく、ワークフローの表示される部分をクリックおよびドラッグして移動できるようになります。パン モードをアクティブ化するボタンは、デザイナーの右下隅にあります。この機能は、再ホストされたデザイナーでサポートされています。  
+  
+ 次のスクリーンショットは、ワークフロー デザイナーの右下隅にあるパン ボタンを示しています。  
+  
+ ![ワークフロー デザイナーの &#91;パン&#93; ボタン](../../../docs/framework/windows-workflow-foundation//media/panbutton.png "PanButton")  
+  
+ マウスの中央ボタンまたは Space キーを使用して、ワークフロー デザイナーをパンすることもできます。  
+  
+### 複数選択  
+ 複数のアクティビティを同時に選択できます。これを行うには、複数のアクティビティを囲むようにドラッグするか \(パン モードが無効な場合\)、Ctrl キーを押したまま目的のアクティビティを 1 つずつクリックします。この機能は、再ホストされたデザイナーでサポートされています。  
+  
+ 選択した複数のアクティビティは、デザイナー内でドラッグ アンド ドロップすることも、コンテキスト メニューを使用して操作することもできます。  
+  
+### ワークフロー項目のアウトライン表示  
+ 階層ワークフローを移動しやすくするため、ワークフローのコンポーネントはツリー スタイルのアウトライン表示で示されます。アウトライン表示は、**\[ドキュメント アウトライン\]** ビューに表示されます。このビューを [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] で開くには、上部のメニューから **\[表示\]**、**\[その他のウィンドウ\]**、**\[ドキュメント アウトライン\]** の順に選択するか、Ctrl キーを押しながら W キーと U キーを押します。アウトライン表示でノードをクリックすると、ワークフロー デザイナーの対応するアクティビティに移動し、アウトライン表示が更新されて、デザイナーで選択されているアクティビティが表示されます。この機能は、再ホストされたデザイナーでサポートされています。  
+  
+ 「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の完成したワークフローの次のスクリーンショットは、シーケンシャル ワークフローを含むアウトライン表示を示しています。  
+  
+ ![ワークフロー デザイナーのアウトライン ビュー](../../../docs/framework/windows-workflow-foundation//media/outlineviewinworkflowdesigner.jpg "OutlineViewinWorkflowDesigner")  
+  
+### シェル バーおよびヘッダー項目の可視性の詳細な制御  
+ 再ホストされたデザイナーでは、標準 UI コントロールの中に、特定のワークフローにとって意味がないものもあれば、無効になっているものもあります。[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、このカスタマイズがデザイナーの下部のシェル バーのみでサポートされています。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、デザイナーの上部にあるシェルのヘッダー項目の表示は、適切な <xref:System.Activities.Presentation.View.ShellHeaderItemsVisibility> 値で <xref:System.Activities.Presentation.View.DesignerView.WorkflowShellHeaderItemsVisibility%2A> を設定することにより調整できます。  
+  
+### フローチャートおよびステート マシンのワークフローの自動接続と自動挿入  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、フローチャート ワークフロー内のノード間の接続は手動で追加する必要がありました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、フローチャート ノードとステート マシン ノードに自動接続ポイントがあり、これらのポイントは、アクティビティをツールボックスからデザイナー画面上にドラッグすると表示されます。アクティビティをこれらのポイントのうち 1 つにドロップすると、アクティビティが必要な接続と共に自動的に追加されます。  
+  
+ 次のスクリーンショットは、アクティビティがツールボックスからドラッグされるときに表示されるアタッチ ポイントを示します。  
+  
+ ![フローチャートの開始ノードに自動接続ポイントが示されている](../../../docs/framework/windows-workflow-foundation//media/autoconnect1.png "Autoconnect1")  
+  
+ アクティビティは、フローチャート ノードと状態の間の接続にドラッグすることで、その他 2 つのノード間にノードを自動挿入することもできます。次のスクリーンショットは、アクティビティをツールボックスからドラッグ アンド ドロップできる、強調表示された接続線を示しています。  
+  
+ ![アクティビティをドロップするための自動挿入ハンドル](../../../docs/framework/windows-workflow-foundation//media/autoinsert.png "Autoinsert")  
+  
+ 自動接続と自動挿入は、再ホストされたデザイナーでサポートされています。  
+  
+### デザイナー注釈  
+ より大規模なワークフローの開発を容易にするため、デザイン プロセスを追跡できるよう注釈の追加がサポートされるようになりました。注釈は、アクティビティ、状態、フローチャート ノード、変数、および引数に追加できます。次のスクリーンショットは、デザイナーに注釈を追加するためのコンテキスト メニューを示しています。  
+  
+ ![注釈コンテキスト メニュー](../../../docs/framework/windows-workflow-foundation//media/annotationdialog.png "annotationdialog")  
+  
+ デザイナー注釈は、再ホストされたデザイナーでサポートされています。  
+  
+### デザイナーでの ActivityDelegate オブジェクトの定義と使用  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] のアクティビティでは、<xref:System.Activities.ActivityDelegate> オブジェクトを使用して、ワークフローの他の部分がワークフローの実行と対話できる実行ポイントを公開していましたが、通常、これらの実行ポイントを使用するには相当な量のコードが必要でした。このリリースでは、開発者はワークフロー デザイナーを使用してアクティビティ デリゲートを定義および使用できます。詳細については、「[ワークフロー デザイナーでアクティビティ デリゲートを定義および使用する方法](../Topic/How%20to:%20Define%20and%20consume%20activity%20delegates%20in%20the%20Workflow%20Designer.md)」を参照してください。  
+  
+ アクティビティ デリゲートは、再ホストされたデザイナーでサポートされています。  
+  
+### ビルド時の検証  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローの検証エラーが、ワークフロー プロジェクトのビルド中のビルド エラーとして数えられていませんでした。つまり、ワークフローの検証エラーが発生した場合でも、ワークフロー プロジェクトのビルドは成功している可能性があります。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、ワークフローの検証エラーが発生するとビルドは失敗します。  
+  
+> [!WARNING]
+>  ビルド時の検証は、再ホストされたデザイナーではサポートされていません。  
+  
+### デザイン時バックグラウンド検証  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローがフォアグラウンド プロセスとして検証されていました。これにより、複雑な検証プロセスや時間のかかる検証プロセスでは UI が応答を停止する可能性がありました。現在、ワークフローの検証はバックグラウンド スレッドで実行されるため、UI がブロックされることはありません。  
+  
+ デザイン時バックグラウンド検証は、再ホストされたデザイナーでサポートされています。  
+  
+### XAML ファイル内で別々の場所にあるビューステート  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローのビューステート情報は、多くの異なる場所にある XAML ファイルに保存されていました。これは、XAML を直接読み取ったり、ビューステート情報を削除するコードを記述したりする開発者にとっては不便です。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、XAML ファイルのビューステート情報は XAML ファイル内の個別の要素としてシリアル化されています。そのため、開発者は、簡単に、アクティビティのビューステート情報を探して編集したり、ビューステートを削除したりできます。  
+  
+ この機能は、再ホストされたワークフロー デザイナーでサポートされています。  
+  
+### 再ホストされたデザイナーでの Workflow 4.5 機能のオプトイン  
+ 下位互換性を維持するために、再ホストされたデザイナーでは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] に含まれる新機能の一部が既定で有効になっていません。これは、再ホストされたデザイナーを使用する既存のアプリケーションが、最新バージョンに更新することで壊れないようにするためです。再ホストされたデザイナーで新機能を有効にするには、<xref:System.Activities.Presentation.DesignerConfigurationService.TargetFrameworkName%2A> を ".Net Framework 4.5" に設定するか、<xref:System.Activities.Presentation.DesignerConfigurationService> の各メンバーを設定して各機能を有効にします。  
+  
+## 新しいワークフロー開発モデル  
+ このリリースには、フローチャートおよびシーケンシャル ワークフロー開発モデルに加えて、ステート マシンのワークフロー、およびコントラクト優先ワークフロー サービスが含まれています。  
+  
+### ステート マシンのワークフロー  
+ ステート マシンのワークフローは、.NET Framework 4.0.1 の一部として [Microsoft .NET Framework 4 Platform Update 1](http://go.microsoft.com/fwlink/?LinkID=215092) で導入されました。この更新プログラムには、開発者がステート マシンのワークフローを作成できるようにする、いくつかの新しいクラスとアクティビティが含まれていました。これらのクラスおよびアクティビティは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 用に更新されました。更新プログラムには次のものが含まれています。  
+  
+1.  状態にブレークポイントを設定する機能。  
+  
+2.  ワークフロー デザイナーで遷移をコピーして貼り付ける機能。  
+  
+3.  トリガーを共有する遷移の作成に対するデザイナーのサポート。  
+  
+4.  ステート マシンのワークフロー作成に使用するアクティビティ \(<xref:System.Activities.Statements.StateMachine><xref:System.Activities.Statements.State>、<xref:System.Activities.Statements.Transition> など\)。  
+  
+ 次のスクリーン ショットは、「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の「[方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md)」の手順で完成したステート マシンのワークフローを示しています。  
+  
+ ![完成したステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wfstatemachinegettingstartedtutorialcomplete.JPG "WFStateMachineGettingStartedTutorialComplete")  
+  
+ ステート マシンのワークフローの作成方法の詳細については、「[ステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//state-machine-workflows.md)」を参照してください。ステート マシンのワークフローは、再ホストされたデザイナーでサポートされています。  
+  
+### コントラクト優先ワークフローの開発  
+ コントラクト優先ワークフローの開発ツールにより、開発者はコード優先のコントラクトを設計することができ、その後、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] で数回クリックするだけで、各操作を表すアクティビティ テンプレートをツールボックス内に自動的に生成できます。これらのアクティビティは、コントラクトで定義された操作を実装するワークフローを作成するために使用されます。ワークフロー デザイナーは、ワークフロー サービスを検証し、これらの操作が実装され、ワークフローの署名がコントラクトの署名と一致することを確認します。また、開発者は、ワークフロー サービスを、実装済みコントラクトのコレクションと関連付けることもできます。コントラクト優先ワークフロー サービスの開発の詳細については、「[既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)」を参照してください。  
+  
+> [!WARNING]
+>  コントラクト優先ワークフローの開発は、ワークフロー デザイナーではサポートされていません。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/whats-new-in-wf-in-dotnet.md b/docs/framework/windows-workflow-foundation/whats-new-in-wf-in-dotnet.md
new file mode 100644
index 00000000000..b368ea22993
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/whats-new-in-wf-in-dotnet.md
@@ -0,0 +1,219 @@
+---
+title: ".NET 4.5 での Windows Workflow Foundation の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 195c43a8-e0a8-43d9-aead-d65a9e6751ec
+caps.latest.revision: 32
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 32
+---
+# .NET 4.5 での Windows Workflow Foundation の新機能
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] の [!INCLUDE[wf](../../../includes/wf-md.md)] では、新しいアクティビティ、デザイナー機能、ワークフロー開発モデルなどの多くの新機能が導入されました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された新しいワークフロー機能の多くは、ホストを変更したワークフロー デザイナーでサポートされています \(ただし、すべての機能がサポートされているわけではありません\)。サポートされている新しい機能[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[再ホストされたワークフロー デザイナーにおける Workflow Foundation 4.5 の新機能のサポート](../../../docs/framework/windows-workflow-foundation//wf-features-in-the-rehosted-workflow-designer.md)」を参照してください。.NET 3.0 および .NET 3.5 ワークフロー アプリケーションを移行して最新バージョンを使用する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[移行のガイドライン](../../../docs/framework/windows-workflow-foundation//migration-guidance.md)」を参照してください。ここでは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された新しいワークフロー機能の概要について説明します。  
+  
+> [!WARNING]
+>  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された新しい [!INCLUDE[wf2](../../../includes/wf2-md.md)] 機能は、以前のバージョンのフレームワークを対象とするプロジェクトには使用できません。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] を対象とするプロジェクトの対象を以前のバージョンのフレームワークに変更すると、いくつかの問題が発生する場合があります。  
+>   
+>  -   デザイナーでは、C\# の式が **"値が XAML で設定されました"** というメッセージに置き換えられます。  
+> -   次のエラーを含む、多くのビルド エラーが発生します。  
+>   
+>  **現在のターゲット フレームワークと互換性のないファイル形式です。ファイル形式を変換するにはファイルを明示的に保存してください。このエラー メッセージは、ファイルを保存してデザイナーを開き直すと表示されなくなります。**  
+  
+##  <a name="BKMK_Versioning"></a> ワークフローのバージョン管理  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、新しい <xref:System.Activities.WorkflowIdentity> クラスに基づいて、いくつかの新しいバージョン管理機能が導入されました。<xref:System.Activities.WorkflowIdentity> には、ワークフロー アプリケーションの作成者向けに、永続化されたワークフロー インスタンスをその定義でマップするメカニズムが備わっています。  
+  
+-   <xref:System.Activities.WorkflowApplication> ホスティングを使用する開発者は、<xref:System.Activities.WorkflowIdentity> を使用して、ワークフローの複数のバージョンを同時にホストできます。永続化されたワークフロー インスタンスは新しい <xref:System.Activities.WorkflowApplicationInstance> クラスを使用して読み込むことができ、ホストは <xref:System.Activities.WorkflowApplicationInstance.DefinitionIdentity%2A> を使用して、<xref:System.Activities.WorkflowApplication> のインスタンス化時に適切なバージョンのワークフロー定義を提供できます。詳細については、「[WorkflowIdentity と Versioning の使用](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md)」および「[ワークフローの複数のバージョンを同時にホストする方法](../../../docs/framework/windows-workflow-foundation//how-to-host-multiple-versions-of-a-workflow-side-by-side.md)」を参照してください。  
+  
+-   現在、<xref:System.ServiceModel.WorkflowServiceHost> は複数のバージョンのホストです。ワークフロー サービスの新しいバージョンを配置すると、新しいインスタンスが新しいサービスを使用して作成されますが、既存のインスタンスは以前のバージョンを使用して完了します。詳細については、「[WorkflowServiceHost による side\-by\-side でのバージョン管理](../../../docs/framework/wcf/feature-details/side-by-side-versioning-in-workflowservicehost.md)」を参照してください。  
+  
+-   永続化されたワークフロー インスタンスの定義を更新するためのメカニズムを提供する動的更新が導入されました。詳細については、「[動的な更新](../../../docs/framework/windows-workflow-foundation//dynamic-update.md)」および「[実行中のワークフロー インスタンスの定義を更新する方法](../../../docs/framework/windows-workflow-foundation//how-to-update-the-definition-of-a-running-workflow-instance.md)」を参照してください。  
+  
+-   SqlWorkflowInstanceStoreSchemaUpgrade.sql データベース スクリプトは、[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] データベース スクリプトを使用して作成された永続性データベースを更新するために用意されています。このスクリプトは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で導入された新しいバージョン管理機能をサポートするように [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] 永続性データベースを更新します。データベースで永続化されたワークフロー インスタンスは、既定のバージョン番号が付与されるため、side\-by\-side 実行および動的更新に参加できるようになります。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]、「[ワークフローのバージョン管理をサポートする .NET Framework 4 永続性データベースのアップグレード](../../../docs/framework/windows-workflow-foundation//using-workflowidentity-and-versioning.md#UpdatingWF4PersistenceDatabases)」を参照してください。  
+  
+##  <a name="BKMK_NewActivities"></a> アクティビティ  
+ 組み込みのアクティビティ ライブラリには、既存のアクティビティ用の新しいアクティビティと新しい機能が含まれています。  
+  
+###  <a name="BKMK_NoPersistScope"></a> NoPersistScope  
+ <xref:System.Activities.Statements.NoPersistScope> は、NoPersistScope の子アクティビティの実行時にワークフローが永続化されないようにする新しいコンテナー アクティビティです。これは、ワークフローがファイル ハンドルなどのコンピューター固有のリソースを使用している場合、データベース トランザクション中など、ワークフローの永続化が適切でないシナリオで役立ちます。以前のバージョンでは、アクティビティ実行中に永続化されないようにするために、<xref:System.Activities.NoPersistHandle> を使用したカスタム <xref:System.Activities.NativeActivity> が必要でした。  
+  
+###  <a name="BKMK_NewFlowchartCapabilities"></a> フローチャートの新機能  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 用に更新されたフローチャートには、次の新機能があります。  
+  
+-   <xref:System.Activities.Statements.FlowSwitch%601> アクティビティまたは <xref:System.Activities.Statements.FlowDecision> アクティビティの `DisplayName` プロパティは編集できます。これにより、アクティビティ デザイナーではアクティビティの目的に関する詳細な情報を表示できます。  
+  
+-   フローチャートには <xref:System.Activities.Statements.Flowchart.ValidateUnconnectedNodes%2A> という新しいプロパティがあります。このプロパティの既定値は `False` です。このプロパティを `True` に設定すると、接続されていないフローチャート ノードでは検証エラーが発生します。  
+  
+## 部分信頼のサポート  
+ [!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] のワークフローでは、完全に信頼されたアプリケーション ドメインが必要でした。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、ワークフローを部分信頼環境で動作させることができます。部分信頼環境では、サード パーティのコンポーネントは、ホストのリソースに対するフル アクセスを許可しなくても使用できます。部分信頼でのワークフローの実行に関する問題は次のとおりです。  
+  
+1.  部分信頼環境では、<xref:System.Activities.Statements.Interop> アクティビティに含まれるレガシ コンポーネント \(規則など\) を使用することはできません。  
+  
+2.  <xref:System.ServiceModel.WorkflowServiceHost> において部分信頼でワークフローを実行することはできません。  
+  
+3.  部分信頼シナリオで例外を永続化すると、セキュリティ上の脅威になる可能性があります。例外の永続化を無効にするには、例外が永続化されないように <xref:System.Activities.ExceptionPersistenceExtension> 型の拡張機能をプロジェクトに追加する必要があります。この型を実装する方法を示したコード例を次に示します。  
+  
+    ```  
+    public class ExceptionPersistenceExtension   
+    {  
+        public ExceptionPersistenceExtension()   
+        {   
+            this.PersistExceptions = false;   
+        }   
+        public bool PersistExceptions { get; set; }   
+    }  
+  
+    ```  
+  
+     例外がシリアル化されない場合は、例外が <xref:System.Activities.Statements.NoPersistScope> 内で使用されていることを確認してください。  
+  
+4.  アクティビティの作成者は、<xref:System.Activities.Activity.CacheMetadata%2A> をオーバーライドして、ワークフロー ランタイムが型に対してリフレクションを自動的に実行しないようにする必要があります。引数と子アクティビティには null 以外を指定する必要があり、<xref:System.Activities.ActivityMetadata.Bind%2A> は明示的に呼び出す必要があります。<xref:System.Activities.Activity.CacheMetadata%2A> のオーバーライドの詳細については、「[CacheMetadata を使用したデータの公開](../../../docs/framework/windows-workflow-foundation//exposing-data-with-cachemetadata.md)」を参照してください。また、型が `internal` または **private** の引数のインスタンスは、リフレクションによって作成されないように、<xref:System.Activities.Activity.CacheMetadata%2A> で明示的に作成する必要があります。  
+  
+5.  型は、シリアル化に <xref:System.Runtime.Serialization.ISerializable> または <xref:System.SerializableAttribute> を使用しません。シリアル化する型では、<xref:System.Runtime.DataContractSerializer> をサポートする必要があります。  
+  
+6.  <xref:System.Activities.Expressions.LambdaValue%601> を使用する式は <xref:System.Security.Permissions.ReflectionPermissionAttribute.RestrictedMemberAccess%2A> を必要とするため、部分信頼では動作しません。<xref:System.Activities.Expressions.LambdaValue%601> を使用するワークフローでは、これらの式を、<xref:System.Activities.CodeActivity%601> から派生するアクティビティと置き換える必要があります。.  
+  
+7.  部分信頼では、<xref:System.Activities.XamlIntegration.WorkflowExpressionCompiler> または Visual Basic でホストされているコンパイラを使用して式をコンパイルすることはできませんが、以前コンパイルされた式を実行することはできます。  
+  
+8.  [レベル 2 の透過性](http://aka.ms/Level2Transparency)を使用する 1 つのアセンブリは、[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)]、[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] \(完全信頼\)、および [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] \(部分信頼\) では使用できません。  
+  
+##  <a name="BKMK_NewDesignerCapabilites"></a> デザイナーの新機能  
+  
+###  <a name="BKMK_DesignerSearch"></a> デザイナーでの検索  
+ より大規模なワークフローを管理しやすくするために、キーワードでワークフローを検索できるようになりました。この機能は [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] でのみ使用できます。つまり、再ホストされたデザイナーでは使用できません。利用できる検索機能には 2 種類あります。  
+  
+-   クイック検索 \(Ctrl キーを押しながら F キーを押すか、**\[編集\]**、**\[検索と置換\]**、**\[クイック検索\]** を順に選択して開始します\)。  
+  
+-   フォルダーを指定して検索 \(Ctrl キーと Shift キーを押しながら F キーを押すか、**\[編集\]**、**\[検索と置換\]**、**\[フォルダーを指定して検索\]** を順に選択して開始します\)。  
+  
+ 置換はサポートされていません。  
+  
+####  <a name="BKMK_QuickFind"></a> クイック検索  
+ ワークフロー内で検索されるキーワードは、次のデザイナー項目に一致します。  
+  
+-   <xref:System.Activities.Activity> オブジェクト、<xref:System.Activities.Statements.FlowNode> オブジェクト、<xref:System.Activities.Statements.State> オブジェクト、<xref:System.Activities.Statements.Transition> オブジェクト、およびその他のカスタム フロー制御項目のプロパティ。  
+  
+-   変数  
+  
+-   引数  
+  
+-   式  
+  
+ クイック検索はデザイナーの <xref:System.Activities.Presentation.Model.Modelitem> ツリーで実行されます。クイック検索は、ワークフロー定義にインポートされた名前空間を検索しません。  
+  
+####  <a name="BKMK_FindInFiles"></a> \[フォルダーを指定して検索\]  
+ ワークフロー内で検索されるキーワードは、ワークフロー ファイルの実際のコンテンツに一致します。検索結果は Visual Studio の検索結果ビュー ペインに表示されます。結果の項目をダブルクリックすると、ワークフロー デザイナーで一致を含むアクティビティに移動します。  
+  
+###  <a name="BKMK_VariableDeleteContextMenu"></a> 変数デザイナーと引数デザイナーのコンテキスト メニューの \[削除\]  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、変数および引数を削除できるのは、デザイナーでキーボードを使用した場合のみでした。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、コンテキスト メニューを使用して変数および引数を削除できます。  
+  
+ 変数デザイナーと引数デザイナーのコンテキスト メニューを次のスクリーンショットに示しています。  
+  
+ ![変数&#47;引数デザイナーのコンテキスト メニュー](../../../docs/framework/windows-workflow-foundation//media/designercontextmenu.png "DesignerContextMenu")  
+  
+###  <a name="BKMK_AutoSurround"></a> ブロックの自動挿入シーケンス  
+ ワークフローまたは特定のコンテナー アクティビティ \(<xref:System.Activities.Statements.NoPersistScope> など\) には Body アクティビティを 1 つしか含めることができないため、2 つ目のアクティビティを追加するには、開発者が最初のアクティビティを削除し、<xref:System.Activities.Statements.Sequence> アクティビティを追加してから、シーケンス アクティビティに両方のアクティビティを追加する必要がありました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、デザイナー画面に 2 つ目のアクティビティを追加すると、`Sequence` アクティビティが自動的に作成され、両方のアクティビティがラップされます。  
+  
+ 次のスクリーンショットは、`NoPersistScope` の `Body` 内の `WriteLine` アクティビティを示しています。  
+  
+ ![ドロップ位置の自動囲い込み](../../../docs/framework/windows-workflow-foundation//media/autosurround1.png "AutoSurround1")  
+  
+ 次のスクリーンショットは、2 つ目の `WriteLine` を 1 つ目の下にドロップしたときに `Body` 内に自動的に作成された `Sequence` アクティビティを示しています。  
+  
+ ![自動的に作成された Sequence アクティビティ](../../../docs/framework/windows-workflow-foundation//media/autosurround2.png "AutoSurround2")  
+  
+###  <a name="BKMK_PanMode"></a> パン モード  
+ デザイナーで大規模なワークフロー内をより簡単に移動するには、パン モードを有効にすると、開発者は、スクロール バーを使用する必要なく、ワークフローの表示される部分をクリックおよびドラッグして移動できるようになります。パン モードをアクティブ化するボタンは、デザイナーの右下隅にあります。  
+  
+ 次のスクリーンショットは、ワークフロー デザイナーの右下隅にあるパン ボタンを示しています。  
+  
+ ![ワークフロー デザイナーの &#91;パン&#93; ボタン](../../../docs/framework/windows-workflow-foundation//media/panbutton.png "PanButton")  
+  
+ マウスの中央ボタンまたは Space キーを使用して、ワークフロー デザイナーをパンすることもできます。  
+  
+###  <a name="BKMK_MultiSelect"></a> 複数選択  
+ 複数のアクティビティを同時に選択できます。これを行うには、複数のアクティビティを囲むようにドラッグするか \(パン モードが無効な場合\)、Ctrl キーを押したまま目的のアクティビティを 1 つずつクリックします。  
+  
+ 選択した複数のアクティビティは、デザイナー内でドラッグ アンド ドロップすることも、コンテキスト メニューを使用して操作することもできます。  
+  
+###  <a name="BKMK_DocumentOutline"></a> ワークフロー項目のアウトライン表示  
+ 階層ワークフローを移動しやすくするため、ワークフローのコンポーネントはツリー スタイルのアウトライン表示で示されます。アウトライン表示は、**\[ドキュメント アウトライン\]** ビューに表示されます。このビューを開くには、上部のメニューから **\[表示\]**、**\[その他のウィンドウ\]**、**\[ドキュメント アウトライン\]** の順に選択するか、Ctrl キーを押しながら W キーと U キーを押します。アウトライン表示でノードをクリックすると、ワークフロー デザイナーの対応するアクティビティに移動し、アウトライン表示が更新されて、デザイナーで選択されているアクティビティが表示されます。  
+  
+ 「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の完成したワークフローの次のスクリーンショットは、シーケンシャル ワークフローを含むアウトライン表示を示しています。  
+  
+ ![ワークフロー デザイナーのアウトライン ビュー](../../../docs/framework/windows-workflow-foundation//media/outlineviewinworkflowdesigner.jpg "OutlineViewinWorkflowDesigner")  
+  
+###  <a name="BKMK_CSharpExpressions"></a> C\# の式  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] より前のバージョンでは、ワークフロー内のすべての式を Visual Basic のみで記述できました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、Visual Basic の式は Visual Basic で作成されたプロジェクトでのみ使用されます。Visual C\# プロジェクトでは、式に C\# が使用されるようになりました。文法強調表示や Intellisense などの機能を備えた、フル機能の C\# 式エディターが用意されています。以前のバージョンで作成された、Visual Basic の式を使用する C\# ワークフロー プロジェクトは引き続き動作します。  
+  
+ C\# の式はデザイン時に検証されます。C\# 式のエラーは赤い波下線でマークされます。  
+  
+ C\# の式[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[C\# の式](../../../docs/framework/windows-workflow-foundation//csharp-expressions.md)」を参照してください。  
+  
+###  <a name="BKMK_Visibility"></a> シェル バーおよびヘッダー項目の可視性の詳細な制御  
+ 再ホストされたデザイナーでは、標準 UI コントロールの中に、特定のワークフローにとって意味がないものもあれば、無効になっているものもあります。[!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、このカスタマイズがデザイナーの下部のシェル バーのみでサポートされています。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、デザイナーの上部にあるシェルのヘッダー項目の表示は、適切な <xref:System.Activities.Presentation.View.ShellHeaderItemsVisibility> 値で <xref:System.Activities.Presentation.View.DesignerView.WorkflowShellHeaderItemsVisibility%2A> を設定することにより調整できます。  
+  
+###  <a name="BKMK_AutoConnect"></a> フローチャートおよびステート マシンのワークフローの自動接続と自動挿入  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、フローチャート ワークフロー内のノード間の接続は手動で追加する必要がありました。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、フローチャート ノードとステート マシン ノードに自動接続ポイントがあり、これらのポイントは、アクティビティをツールボックスからデザイナー画面上にドラッグすると表示されます。アクティビティをこれらのポイントのうち 1 つにドロップすると、アクティビティが必要な接続と共に自動的に追加されます。  
+  
+ 次のスクリーンショットは、アクティビティがツールボックスからドラッグされるときに表示されるアタッチ ポイントを示します。  
+  
+ ![フローチャートの開始ノードに自動接続ポイントが示されている](../../../docs/framework/windows-workflow-foundation//media/autoconnect1.png "Autoconnect1")  
+  
+ アクティビティは、フローチャート ノードと状態の間の接続にドラッグすることで、その他 2 つのノード間にノードを自動挿入することもできます。次のスクリーンショットは、アクティビティをツールボックスからドラッグ アンド ドロップできる、強調表示された接続線を示しています。  
+  
+ ![アクティビティをドロップするための自動挿入ハンドル](../../../docs/framework/windows-workflow-foundation//media/autoinsert.png "Autoinsert")  
+  
+###  <a name="BKMK_Annotations"></a> デザイナー注釈  
+ より大規模なワークフローの開発を容易にするため、デザイン プロセスを追跡できるよう注釈の追加がサポートされるようになりました。注釈は、アクティビティ、状態、フローチャート ノード、変数、および引数に追加できます。次のスクリーンショットは、デザイナーに注釈を追加するためのコンテキスト メニューを示しています。  
+  
+ ![注釈コンテキスト メニュー](../../../docs/framework/windows-workflow-foundation//media/annotationdialog.png "annotationdialog")  
+  
+### デバッグ状態  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、アクティビティ以外の要素は、実行の単位ではないため、デバッグ ブレークポイントがサポートされていませんでした。このリリースでは、<xref:System.Activities.Statements.State> オブジェクトにブレークポイントを追加する機能が用意されています。ブレークポイントを <xref:System.Activities.Statements.State> に設定した場合、そのエントリ アクティビティまたはトリガーがスケジュールされる前に、状態が遷移すると実行が停止します。  
+  
+###  <a name="BKMK_ActivityDelegates"></a> デザイナーでの ActivityDelegate オブジェクトの定義と使用  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] のアクティビティでは、<xref:System.Activities.ActivityDelegate> オブジェクトを使用して、ワークフローの他の部分がワークフローの実行と対話できる実行ポイントを公開していましたが、通常、これらの実行ポイントを使用するには相当な量のコードが必要でした。このリリースでは、開発者はワークフロー デザイナーを使用してアクティビティ デリゲートを定義および使用できます。詳細については、「[ワークフロー デザイナーでアクティビティ デリゲートを定義および使用する方法](../Topic/How%20to:%20Define%20and%20consume%20activity%20delegates%20in%20the%20Workflow%20Designer.md)」を参照してください。  
+  
+###  <a name="BKMK_BuildTimeValidation"></a> ビルド時の検証  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローの検証エラーが、ワークフロー プロジェクトのビルド中のビルド エラーとして数えられていませんでした。つまり、ワークフローの検証エラーが発生した場合でも、ワークフロー プロジェクトのビルドは成功している可能性があります。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、ワークフローの検証エラーが発生するとビルドは失敗します。  
+  
+###  <a name="BKMK_DesignTimeValidation"></a> デザイン時バックグラウンド検証  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローがフォアグラウンド プロセスとして検証されていました。これにより、複雑な検証プロセスや時間のかかる検証プロセスでは UI が応答を停止する可能性がありました。現在、ワークフローの検証はバックグラウンド スレッドで実行されるため、UI がブロックされることはありません。  
+  
+###  <a name="BKMK_ViewState"></a> XAML ファイル内で別々の場所にあるビューステート  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] では、ワークフローのビューステート情報は、多くの異なる場所にある XAML ファイルに保存されていました。これは、XAML を直接読み取ったり、ビューステート情報を削除するコードを記述したりする開発者にとっては不便です。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、XAML ファイルのビューステート情報は XAML ファイル内の個別の要素としてシリアル化されています。そのため、開発者は、簡単に、アクティビティのビューステート情報を探して編集したり、ビューステートを削除したりできます。  
+  
+###  <a name="BKMK_ExpressionExtensibility"></a> 式の拡張性  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、開発者が、ワークフロー デザイナーにプラグインできる、独自の式および式作成操作を作成できるようになります。  
+  
+###  <a name="BKMK_BackwardCompatRehostedDesigner"></a> 再ホストされたデザイナーでの Workflow 4.5 機能のオプトイン  
+ 下位互換性を維持するために、再ホストされたデザイナーでは、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] に含まれる新機能の一部が既定で有効になっていません。これは、再ホストされたデザイナーを使用する既存のアプリケーションが、最新バージョンに更新することで壊れないようにするためです。再ホストされたデザイナーで新機能を有効にするには、<xref:System.Activities.Presentation.DesignerConfigurationService.TargetFrameworkName%2A> を ".NET Framework 4.5" に設定するか、<xref:System.Activities.Presentation.DesignerConfigurationService> の各メンバーを設定して各機能を有効にします。  
+  
+##  <a name="BKMK_NewWFModels"></a> 新しいワークフロー開発モデル  
+ このリリースには、フローチャートおよびシーケンシャル ワークフロー開発モデルに加えて、ステート マシンのワークフロー、およびコントラクト優先ワークフロー サービスが含まれています。  
+  
+###  <a name="BKMK_StateMachine"></a> ステート マシンのワークフロー  
+ ステート マシンのワークフローは、.NET Framework 4.0.1 の一部として [Microsoft .NET Framework 4 Platform Update 1](http://go.microsoft.com/fwlink/?LinkID=215092) で導入されました。この更新プログラムには、開発者がステート マシンのワークフローを作成できるようにする、いくつかの新しいクラスとアクティビティが含まれていました。これらのクラスおよびアクティビティは [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 用に更新されました。更新プログラムには次のものが含まれています。  
+  
+1.  状態にブレークポイントを設定する機能。  
+  
+2.  ワークフロー デザイナーで遷移をコピーして貼り付ける機能。  
+  
+3.  トリガーを共有する遷移の作成に対するデザイナーのサポート。  
+  
+4.  ステート マシンのワークフロー作成に使用するアクティビティ \(<xref:System.Activities.Statements.StateMachine><xref:System.Activities.Statements.State>、<xref:System.Activities.Statements.Transition> など\)。  
+  
+ 次のスクリーン ショットは、「[チュートリアル入門](../../../docs/framework/windows-workflow-foundation//getting-started-tutorial.md)」の「[方法: ステート マシン ワークフローを作成する](../../../docs/framework/windows-workflow-foundation//how-to-create-a-state-machine-workflow.md)」の手順で完成したステート マシンのワークフローを示しています。  
+  
+ ![完成したステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//media/wfstatemachinegettingstartedtutorialcomplete.JPG "WFStateMachineGettingStartedTutorialComplete")  
+  
+ ステート マシンのワークフローの作成方法の詳細については、「[ステート マシン ワークフロー](../../../docs/framework/windows-workflow-foundation//state-machine-workflows.md)」を参照してください。  
+  
+###  <a name="BKMK_ContractFirst"></a> コントラクト優先ワークフローの開発  
+ コントラクト優先ワークフローの開発ツールにより、開発者はコード優先のコントラクトを設計することができ、その後、[!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] で数回クリックするだけで、各操作を表すアクティビティ テンプレートをツールボックス内に自動的に生成できます。これらのアクティビティは、コントラクトで定義された操作を実装するワークフローを作成するために使用されます。ワークフロー デザイナーは、ワークフロー サービスを検証し、これらの操作が実装され、ワークフローの署名がコントラクトの署名と一致することを確認します。また、開発者は、ワークフロー サービスを、実装済みコントラクトのコレクションと関連付けることもできます。コントラクト優先ワークフロー サービスの開発の詳細については、「[既存のサービス コントラクトを使用するワークフロー サービスを作成する方法](../../../docs/framework/windows-workflow-foundation//how-to-create-a-workflow-service-that-consumes-an-existing-service-contract.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/whats-new.md b/docs/framework/windows-workflow-foundation/whats-new.md
new file mode 100644
index 00000000000..24b11f6a2ff
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/whats-new.md
@@ -0,0 +1,63 @@
+---
+title: "Windows Workflow Foundation の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WF [WF], 新機能"
+  - "Windows Workflow Foundation [WF], 新機能"
+ms.assetid: 11f96014-001e-41a0-bcc2-d0684a52fa43
+caps.latest.revision: 29
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 29
+---
+# Windows Workflow Foundation の新機能
+[!INCLUDE[netfx40_long](../../../includes/netfx40-long-md.md)] の [!INCLUDE[wf](../../../includes/wf-md.md)] では、前のバージョンから開発パラダイムがいくつか変更されました。ワークフローでは、新しい機能のホストの作成、実行、保守、実装が簡単になっています。.NET 3.0 および .NET 3.5 ワークフロー アプリケーションを移行して最新バージョンを使用する方法[!INCLUDE[crabout](../../../includes/crabout-md.md)]、「[移行のガイドライン](../../../docs/framework/windows-workflow-foundation//migration-guidance.md)」を参照してください。  
+  
+## ワークフロー アクティビティ モデル  
+ アクティビティは、現在はワークフロー作成の基本単位であり、<xref:System.Workflow.Activities.SequentialWorkflowActivity> クラスや <xref:System.Workflow.Activities.StatemachineWorkflowActivity> クラスは使用されなくなっています。<xref:System.Activities.Activity> クラスは、ワークフロー動作の基本抽象クラスです。このため、アクティビティの作成者は、基本的なカスタム アクティビティ機能用に <xref:System.Activities.CodeActivity> を実装するか、一定範囲のランタイムを使用するカスタム アクティビティ機能用に <xref:System.Activities.NativeActivity> を実装することができます。また、アクティビティの作成者は <xref:System.Activities.Activity> クラスを使用して、他の <xref:System.Activities.NativeActivity> オブジェクト、<xref:System.Activities.CodeActivity> オブジェクト、<xref:System.Activities.AsyncCodeActivity> オブジェクト、または <xref:System.Activities.DynamicActivity> オブジェクトによって新しい動作を宣言して表します。このオブジェクトは、カスタムに開発されたものである場合と、[ビルトイン アクティビティ ライブラリ](../../../docs/framework/windows-workflow-foundation//net-framework-4-5-built-in-activity-library.md)に含まれているものである場合があります。  
+  
+## 豊富な複合アクティビティ オプション  
+ <xref:System.Activities.Statements.Flowchart> は新しい強力な制御フロー アクティビティです。作成者は、これを使用して任意のループや条件分岐をモデル化できます。<xref:System.Activities.Statements.Flowchart> により、以前は <xref:System.Workflow.Activities.StateMachineWorkflowActivity> でのみ実装が可能であったイベント ドリブン プログラミング モデルを使用できます。手続き型のワークフローでは、<xref:System.Activities.Statements.TryCatch> や <xref:System.Activities.Statements.Switch%601> などの従来のフロー制御構造をモデル化する新しいフロー制御アクティビティを利用できます。  
+  
+## 拡張ビルトイン アクティビティ ライブラリ  
+ アクティビティ ライブラリには、次のような新しい機能があります。  
+  
+-   <xref:System.Activities.Statements.DoWhile>、<xref:System.Activities.Statements.Pick>、<xref:System.Activities.Statements.TryCatch>、<xref:System.Activities.Statements.ForEach%601>、<xref:System.Activities.Statements.Switch%601>、<xref:System.Activities.Statements.ParallelForEach%601> などの新しいフロー制御アクティビティ  
+  
+-   <xref:System.Activities.Statements.Assign> などのメンバー データを操作するためのアクティビティと、<xref:System.Activities.Statements.AddToCollection%601> などのコレクション アクティビティ  
+  
+-   <xref:System.Activities.Statements.TransactionScope> や <xref:System.Activities.Statements.Compensate> などのトランザクションを制御するアクティビティ  
+  
+-   <xref:System.ServiceModel.Activities.SendContent> や <xref:System.ServiceModel.Activities.ReceiveReply> などの新しいメッセージング アクティビティ  
+  
+## 明示的なアクティビティ データ モデル  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] には、データを格納および移動するための新しいオプションがあります。データは、<xref:System.Activities.Variable> を使用してアクティビティに格納できます。データをアクティビティに移動したり、アクティビティから移動したりするときは、特殊な引数型を使用してデータの移動方向が判定されます。これらの型は、<xref:System.Activities.InArgument>、<xref:System.Activities.InOutArgument>、<xref:System.Activities.OutArgument>です。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Workflow Foundation のデータ モデル](../../../docs/framework/windows-workflow-foundation//data-model.md).  
+  
+## ホスティング、永続化、追跡の強化されたオプション  
+ [!INCLUDE[netfx40_short](../../../includes/netfx40-short-md.md)] には、次のような永続化の拡張機能があります。  
+  
+-   <xref:System.ServiceModel.Activities.WorkflowServiceHost>、<xref:System.Activities.WorkflowApplication>、<xref:System.Activities.WorkflowInvoker> などの、ワークフローを実行するための多数のオプションがあります。  
+  
+-   <xref:System.Activities.Statements.Persist> アクティビティを使用してワークフロー状態データを明示的に永続化できます。  
+  
+-   ホストは、<xref:System.Activities.ActivityInstance> をアンロードせずに永続化できます。  
+  
+-   ワークフローは、永続化できないデータを処理するときは非永続化ゾーンを指定できます。このため、非永続化ゾーンを終了するまで永続化は延期されます。  
+  
+-   トランザクションは、<xref:System.Activities.Statements.TransactionScope> を使用してワークフローに流し込むことができます。  
+  
+-   追跡は、<xref:System.Activities.Tracking.TrackingParticipant> を使用して、簡単に実行できます。  
+  
+-   システムのイベント ログへの追跡は <xref:System.Activities.Tracking.EtwTrackingParticipant> を使用して実現されます。  
+  
+-   保留中のワークフローの再開は、<xref:System.Activities.Bookmark> オブジェクトを使用して管理されるようになりました。  
+  
+## WF デザイナー エクスペリエンスの容易な拡張  
+ 新しい WF デザイナーは [!INCLUDE[avalon1](../../../includes/avalon1-md.md)] に基づいて構築されており、Visual Studio の外部で WF デザイナーを再ホストするときに簡単に使用できるモデルです。また、カスタムのアクティビティ デザイナーを作成するための使いやすいメカニズムを備えています。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ワークフロー デザイン操作のカスタマイズ](../../../docs/framework/windows-workflow-foundation//customizing-the-workflow-design-experience.md).
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-activity-class.md b/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-activity-class.md
new file mode 100644
index 00000000000..60b97653575
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-activity-class.md
@@ -0,0 +1,30 @@
+---
+title: "アクティビティ クラスを使用したワークフロー アクティビティの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 7b7b1c66-f093-43c3-b4d1-7173b46516da
+caps.latest.revision: 7
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 7
+---
+# アクティビティ クラスを使用したワークフロー アクティビティの作成
+[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] で [!INCLUDE[wf](../../../includes/wf-md.md)] を使用してアクティビティを作成する最も基本的な方法は、カスタム アクティビティまたは [ビルトイン アクティビティ ライブラリ](../../../docs/framework/windows-workflow-foundation//net-framework-4-5-built-in-activity-library.md) のアクティビティをアセンブルして、機能を作成する <xref:System.Activities.Activity> から継承するクラスを作成することです。ここでは、2 つのメッセージをコンソールに書き込むアクティビティを作成する方法について説明します。  
+  
+### アクティビティ デザイナーを使ってカスタム アクティビティを作成するには  
+  
+1.  [!INCLUDE[vs_current_long](../../../includes/vs-current-long-md.md)] を開きます。  
+  
+2.  \[ファイル\]、\[新規作成\]、\[プロジェクト\] の順にクリックします。**\[プロジェクトの種類\]** ウィンドウの **\[Visual C\#\]** の下にある **\[ワークフロー 4.0\]** を選択し、**v2010 ノード**を選択します。**\[テンプレート\]** ウィンドウで **\[アクティビティ ライブラリ\]** をクリックします。新しいプロジェクトに HelloActivity という名前を付けます。  
+  
+3.  新しいアクティビティを開きます。<xref:System.Activities.Statements.Sequence> アクティビティをツールボックスからデザイナー画面にドラッグします。  
+  
+4.  <xref:System.Activities.Statements.WriteLine> アクティビティを <xref:System.Activities.Statements.Sequence> アクティビティにドラッグします。**テキスト** フィールドに「`"Hello World"`」\(引用符を含む\) と入力します。  
+  
+5.  2 つ目の <xref:System.Activities.Statements.WriteLine> アクティビティを、1 つ目の下にある <xref:System.Activities.Statements.Sequence> アクティビティにドラッグします。**テキスト** フィールドに「`"Goodbye"`」\(引用符を含む\) と入力します。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-codeactivity-class.md b/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-codeactivity-class.md
new file mode 100644
index 00000000000..4283f8a4f93
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-activity-authoring-using-the-codeactivity-class.md
@@ -0,0 +1,72 @@
+---
+title: "CodeActivity クラスを使用したワークフロー アクティビティの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: cfe315c1-f86d-43ec-b9ce-2f8c469b1106
+caps.latest.revision: 11
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 11
+---
+# CodeActivity クラスを使用したワークフロー アクティビティの作成
+<xref:System.Activities.CodeActivity> を継承して作成されたアクティビティは、<xref:System.Activities.CodeActivity.Execute%2A> メソッドをオーバーライドすることで強制的な基本動作を実装できます。  
+  
+## CodeActivityContext の使用  
+ ワークフロー ランタイムの機能は、<xref:System.Activities.CodeActivityContext> 型の `context` パラメーターを使用して、<xref:System.Activities.CodeActivity.Execute%2A> メソッド内からアクセスできます。<xref:System.Activities.CodeActivityContext> を介して、以下のような機能を使用できます。  
+  
+-   変数と引数の値を取得および設定。  
+  
+-   <xref:System.Activities.CodeActivityContext.Track%2A> を使用したカスタムの追跡機能。  
+  
+-   <xref:System.Activities.CodeActivityContext.GetProperty%2A> を使用したアクティビティの実行プロパティへのアクセス。  
+  
+#### CodeActivity を継承するカスタム アクティビティを作成するには  
+  
+1.  [!INCLUDE[vs2010](../../../includes/vs2010-md.md)] を開きます。  
+  
+2.  **\[ファイル\]**、**\[新規作成\]**、**\[プロジェクト\]** の順に選択します。**\[プロジェクトの種類\]** ウィンドウの **\[Visual C\#\]** の下にある **\[ワークフロー 4.0\]** を選択し、**v2010 ノード**を選択します。**\[テンプレート\]** ウィンドウで **\[アクティビティ ライブラリ\]** をクリックします。新しいプロジェクトに HelloActivity という名前を付けます。  
+  
+3.  HelloActivity プロジェクトの Activity1.xaml を右クリックし、**\[削除\]** をクリックします。  
+  
+4.  HelloActivity プロジェクトを右クリックして、**\[追加\]**、**\[クラス\]** の順に選択します。新しいクラスに HelloActivity.cs という名前を付けます。  
+  
+5.  HelloActivity.cs ファイルで、次の `using` ディレクティブを追加します。  
+  
+    ```csharp  
+    using System.Activities;  
+    using System.Activities.Statements;  
+    ```  
+  
+6.  クラス宣言に基本クラスを追加して、新しいクラスを <xref:System.Activities.CodeActivity> から継承します。  
+  
+    ```csharp  
+    class HelloActivity : CodeActivity  
+    ```  
+  
+7.  <xref:System.Activities.CodeActivity.Execute%2A> メソッドを追加して、このクラスに機能を追加します。  
+  
+    ```csharp  
+    protected override void Execute(CodeActivityContext context)  
+    {  
+        Console.WriteLine("Hello World!");  
+    }  
+    ```  
+  
+8.  <xref:System.Activities.CodeActivityContext> を使用して追跡レコードを作成します。  
+  
+    ```csharp  
+    protected override void Execute(CodeActivityContext context)  
+    {  
+        Console.WriteLine("Hello World!");  
+        CustomTrackingRecord record = new CustomTrackingRecord("MyRecord");  
+        record.Data.Add(new KeyValuePair<String, Object>("ExecutionTime", DateTime.Now));  
+        context.Track(record);  
+    }  
+  
+    ```
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-execution-properties.md b/docs/framework/windows-workflow-foundation/workflow-execution-properties.md
new file mode 100644
index 00000000000..42ac7b54341
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-execution-properties.md
@@ -0,0 +1,175 @@
+---
+title: "ワークフロー実行プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: a50e088e-3a45-4267-bd51-1a3e6c2d246d
+caps.latest.revision: 9
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 9
+---
+# ワークフロー実行プロパティ
+CLR は、スレッド ローカル ストレージ \(TLS\) を介して各スレッドの実行コンテキストを維持します。この実行コンテキストは、名前付きスロットのようなユーザー定義のスレッド プロパティのほかに、スレッド ID、アンビエント トランザクション、現在のアクセス許可セットなどの既知のスレッド プロパティを制御します。  
+  
+ CLR を直接対象にするプログラムとは異なり、ワークフロー プログラムは、スレッド非依存環境で実行されるアクティビティのツリーへ階層的にスコープ設定されます。つまり、特定の作業項目のスコープに含まれるコンテキストを判断するために、標準の TLS 機構を直接使用することはできません。たとえば、2 つの並行する実行の分岐で異なるトランザクションを使用していても、スケジューラは同じ CLR スレッド上でそれらの実行をインターリーブすることがあります。  
+  
+ ワークフローの実行プロパティには、アクティビティの環境にコンテキスト特有のプロパティを追加する機構が用意されています。これによって、アクティビティでサブツリーのスコープに含まれるプロパティを宣言できるようになり、また CLR オブジェクトと適切に相互作用するように TLS の設定および設定解除を行うフックが実現されます。  
+  
+## ワークフロー実行プロパティの作成と使用  
+ ワークフロー実行プロパティは、通常、<xref:System.Activities.IExecutionProperty> インターフェイスを実装します。ただし、メッセージングに重点を置いたプロパティが代わりに <xref:> System.ServiceModel.Activities.ISendMessageCallback?qualifyHint=False&autoUpgrade=True と <xref:> System.ServiceModel.Activities.IReceiveMessageCallback?qualifyHint=False&autoUpgrade=True を実装することもあります。ワークフロー実行プロパティを作成するには、<xref:System.Activities.IExecutionProperty> インターフェイスを実装するクラスを作成し、メンバーの <xref:System.Activities.IExecutionProperty.SetupWorkflowThread%2A> および <xref:System.Activities.IExecutionProperty.CleanupWorkflowThread%2A> を実装します。これらのメンバーには、プロパティを含むアクティビティ \(すべての子アクティビティを含む\) の作業の各パルス中に、スレッド ローカル ストレージを適切に設定および設定解除できる実行プロパティがあります。この例では、`Console.ForegroundColor` を設定する `ConsoleColorProperty` を作成します。  
+  
+> [!NOTE]
+>  このトピックの次のコード例は、「[実行プロパティ](../../../docs/framework/windows-workflow-foundation/samples/execution-properties.md)」のサンプル コードに基づいています。  
+  
+```csharp  
+class ConsoleColorProperty : IExecutionProperty  
+{  
+    public const string Name = "ConsoleColorProperty";  
+  
+    ConsoleColor original;  
+    ConsoleColor color;  
+  
+    public ConsoleColorProperty(ConsoleColor color)  
+    {  
+        this.color = color;  
+    }  
+  
+    void IExecutionProperty.SetupWorkflowThread()  
+    {  
+        original = Console.ForegroundColor;  
+        Console.ForegroundColor = color;  
+    }  
+  
+    void IExecutionProperty.CleanupWorkflowThread()  
+    {  
+        Console.ForegroundColor = original;  
+    }  
+}  
+```  
+  
+ アクティビティ作成者がこのプロパティを使用するには、アクティビティの実行オーバーライドに登録します。この例では、現在の <xref:System.Activities.NativeActivityContext> の <xref:System.Activities.NativeActivityContext.Properties%2A> コレクションに追加することで、`ConsoleColorProperty` を登録する `ConsoleColorScope` アクティビティが定義されています。  
+  
+```csharp  
+public sealed class ConsoleColorScope : NativeActivity  
+{  
+    public ConsoleColorScope()  
+        : base()  
+    {  
+    }  
+  
+    public ConsoleColor Color { get; set; }  
+    public Activity Body { get; set; }  
+  
+    protected override void Execute(NativeActivityContext context)  
+    {  
+        context.Properties.Add(ConsoleColorProperty.Name, new ConsoleColorProperty(this.Color));  
+  
+        if (this.Body != null)  
+        {  
+            context.ScheduleActivity(this.Body);  
+        }  
+    }  
+}  
+```  
+  
+ アクティビティの本体が作業のパルスを開始すると、プロパティの <xref:System.Activities.IExecutionProperty.SetupWorkflowThread%2A> メソッドが呼び出されます。作業のパルスが完了すると、<xref:System.Activities.IExecutionProperty.CleanupWorkflowThread%2A> が呼び出されます。この例では、3 つの分岐がある <xref:System.Activities.Statements.Parallel> アクティビティを使用するワークフローが作成されます。最初の 2 つの分岐では `ConsoleColorScope` アクティビティを使用しますが、3 つ目の分岐は使用しません。3 つの分岐にはいずれも 2 つの <xref:System.Activities.Statements.WriteLine> アクティビティと 1 つの <xref:System.Activities.Statements.Delay> アクティビティが含まれます。<xref:System.Activities.Statements.Parallel> アクティビティが実行されると、その分岐に含まれるアクティビティはインターリーブ形式で実行されますが、それぞれの子アクティビティが実行されるとき、`ConsoleColorProperty` によって適切なコンソールの色が適用されます。  
+  
+```csharp  
+Activity wf = new Parallel  
+{  
+    Branches =   
+    {  
+        new ConsoleColorScope  
+        {  
+            Color = ConsoleColor.Blue,  
+            Body = new Sequence  
+            {  
+                Activities =   
+                {  
+                    new WriteLine  
+                    {  
+                        Text = "Start blue text."  
+                    },  
+                    new Delay  
+                    {  
+                        Duration = TimeSpan.FromSeconds(1)  
+                    },  
+                    new WriteLine  
+                    {  
+                        Text = "End blue text."  
+                    }  
+                }  
+            }  
+        },  
+        new ConsoleColorScope  
+        {  
+            Color = ConsoleColor.Red,  
+            Body = new Sequence  
+            {  
+                Activities =   
+                {  
+                    new WriteLine  
+                    {  
+                        Text = "Start red text."  
+                    },  
+                    new Delay  
+                    {  
+                        Duration = TimeSpan.FromSeconds(1)  
+                    },  
+                    new WriteLine  
+                    {  
+                        Text = "End red text."  
+                    }  
+                }  
+            }  
+        },  
+        new Sequence  
+        {  
+            Activities =   
+            {  
+                new WriteLine  
+                {  
+                    Text = "Start default text."  
+                },  
+                new Delay  
+                {  
+                    Duration = TimeSpan.FromSeconds(1)  
+                },  
+                new WriteLine  
+                {  
+                    Text = "End default text."  
+                }  
+            }  
+        }  
+    }  
+};  
+  
+WorkflowInvoker.Invoke(wf);  
+```  
+  
+ このワークフローを呼び出すと、次の出力がコンソール ウィンドウに書き込まれます。  
+  
+```  
+Start blue text.  
+Start red text.  
+Start default text.  
+End blue text.  
+End red text.  
+End default text.  
+```  
+  
+> [!NOTE]
+>  前の出力には示されていませんが、コンソール ウィンドウの各テキスト行は、指定した色で表示されます。  
+  
+ ワークフロー実行プロパティは、カスタム アクティビティ作成者が使用できます。また、このプロパティには、<xref:System.ServiceModel.Activities.CorrelationScope> や <xref:System.Activities.Statements.TransactionScope> などのアクティビティ向けにハンドル管理の機構も用意されています。  
+  
+## 参照  
+ <xref:System.Activities.IExecutionProperty>   
+ <xref:System.Activities.IPropertyRegistrationCallback>   
+ <xref:System.Activities.RegistrationContext>
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-hosting-options.md b/docs/framework/windows-workflow-foundation/workflow-hosting-options.md
new file mode 100644
index 00000000000..cf010dbeadf
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-hosting-options.md
@@ -0,0 +1,34 @@
+---
+title: "ワークフロー ホスティングのオプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 37bcd668-9c5c-4e7c-81da-a1f1b3a16514
+caps.latest.revision: 3
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 3
+---
+# ワークフロー ホスティングのオプション
+[!INCLUDE[wf](../../../includes/wf-md.md)] のほとんどのサンプルでは、コンソール アプリケーションでホストされているワークフローが使用されていますが、これは実際のワークフローにとって現実的なシナリオではありません。実際のビジネス アプリケーションのワークフローは、開発者が作成した Windows サービス、[!INCLUDE[iisver](../../../includes/iisver-md.md)] や AppFabric などのサーバー アプリケーションのいずれかの永続的なプロセスでホストされます。これらの方法の違いを次に示します。  
+  
+## Windows AppFabric を使用した IIS でのワークフローのホスト  
+ IIS と AppFabric は、ワークフローに推奨されるホストです。AppFabric を使用したワークフローのホスト アプリケーションは Windows プロセス アクティブ化サービスで、これは IIS を介した HTTP への依存関係のみを解消します。  
+  
+## IIS のみでのワークフローのホスト  
+ [!INCLUDE[iisver](../../../includes/iisver-md.md)] のみを使用することは推奨されていません。AppFabric には、実行中のアプリケーションのメンテナンスを容易にする管理ツールと監視ツールがあるためです。ワークフローを [!INCLUDE[iisver](../../../includes/iisver-md.md)] のみでホストする必要があるのは、AppFabric への移行に関してインフラストラクチャ上の問題がある場合だけです。  
+  
+> [!WARNING]
+>  さまざまな理由により、アプリケーション プールは [!INCLUDE[iisver](../../../includes/iisver-md.md)] によって定期的にリサイクルされます。アプリケーション プールがリサイクルされると、IIS は古いプールへのメッセージの受け取りを中止し、新しいアプリケーション プールをインスタンス化して新しい要求を受け取ります。ワークフローが応答の送信後も動作し続ける場合、[!INCLUDE[iisver](../../../includes/iisver-md.md)] は作業が完了したことを認識せず、ホスト アプリケーション プールをリサイクルする可能性があります。このような現象が発生した場合、ワークフローは中止され、追跡サービスは、\[理由\] フィールドが空になっている [1004 \- WorkflowInstanceAborted](../../../docs/framework/windows-workflow-foundation//1004-workflowinstanceaborted.md) メッセージを記録します。  
+>   
+>  永続化を使用する場合、ホストは、最後の永続性ポイントから、中止されたインスタンスを明示的に再開する必要があります。  
+>   
+>  AppFabric を使用する場合、永続化を使用すると、ワークフロー管理サービスは、最終的に、最後に成功した永続性ポイントからワークフローを再開します。永続化を使用せず、ワークフローが要求\/応答パターン以外の操作を実行している場合、ワークフローが中止されるとデータは失われます。  
+  
+## カスタム Windows サービスでのワークフローのホスト  
+ カスタム ワークフロー サービスを作成してワークフローをホストする場合、開発者は AppFabric に標準搭載されている多くの機能を複製する必要がありますが、カスタム機能をより柔軟に使用できるようになります。このオプションは、AppFabric を選択できない場合にのみ検討してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-persistence.md b/docs/framework/windows-workflow-foundation/workflow-persistence.md
new file mode 100644
index 00000000000..a28a7125147
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-persistence.md
@@ -0,0 +1,61 @@
+---
+title: "ワークフローの永続性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], 永続性"
+ms.assetid: 39e69d1f-b771-4c16-9e18-696fa43b65b2
+caps.latest.revision: 26
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 26
+---
+# ワークフローの永続性
+ワークフローの永続化は、プロセスやコンピューターの情報とは独立した、ワークフロー インスタンスの状態の永続的なキャプチャです。永続化の目的は、システム生涯時にワークフロー インスタンスの既知の回復ポイントを提供するため、アクティブに作業を実行していないワークフロー インスタンスをアンロードしてメモリを節約するため、またはワークフロー インスタンスの状態をサーバー ファーム内のあるノードから別のノードに移行するためです。  
+  
+ 永続化によって、プロセスの迅速性、拡張性、エラー時の回復、およびメモリをより効率的に管理できる機能を実現できます。永続化プロセスには永続化ポイントの指定や保存するデータの収集が含まれ、最終的にはデータの実際のストレージが永続化プロバイダーにデリゲートされます。  
+  
+ ワークフローの永続化を有効にするには、「[ワークフローとワークフロー サービスの永続化を有効にする方法](../../../docs/framework/windows-workflow-foundation//how-to-enable-persistence-for-workflows-and-workflow-services.md)」の説明に従って、インスタンス ストアを **WorkflowApplication** または **WorkflowServiceHost** に関連付ける必要があります。**WorkflowApplication** と **WorkflowServiceHost** は、それらに関連付けられているインスタンス ストアを使用して、ワークフロー インスタンスを永続化ストアに永続化し、永続化ストアに格納されているワークフロー インスタンス データに基づいてワークフロー インスタンスをメモリに読み込む処理を有効にします。  
+  
+ [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] には **SqlWorkflowInstanceStore** クラスがあります。このクラスを使用すると、ワークフロー インスタンスに関するデータおよびメタデータを SQL Server 2005 または SQL Server 2008 のデータベースに永続化できます。詳細については、「[SQL Workflow Instance Store](../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)」を参照してください。  
+  
+ アプリケーション固有のデータをワークフロー インスタンス関連の情報と共に格納し、読み込むために、<xref:System.Activities.Persistence.PersistenceParticipant> クラスを拡張する永続参加要素を作成できます。永続参加要素は永続化プロセスに参加して、カスタムのシリアル化可能なデータを永続化ストアに保存し、インスタンス ストアからメモリにデータを読み込み、永続化トランザクションで任意の追加ロジックを実行します。詳細については、「[永続参加要素](../../../docs/framework/windows-workflow-foundation//persistence-participants.md)」を参照してください。  
+  
+ Windows Server App Fabric を使用すると、永続化の構成のプロセスを簡潔化できます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Server App Fabric での永続化の概念](http://go.microsoft.com/fwlink/?LinkId=201200)  
+  
+## 暗黙的な永続化ポイント  
+ 次の一覧は、インスタンス ストアがワークフローに関連付けられている場合にワークフローが永続化される条件の例です。  
+  
+-   **TransactionScope** アクティビティまたは **TransactedReceiveScope** アクティビティが完了したとき。  
+  
+-   ワークフロー インスタンスがアイドルになり、**WorkflowIdleBehavior** がワークフロー ホストに設定されたとき。たとえば、メッセージング アクティビティ、つまり **Delay** アクティビティを使用すると、この処理が発生します。  
+  
+-   WorkflowApplication がアイドルになり、アプリケーションの **PersistableIdle** プロパティが **PersistableIdleAction.Persist** に設定されたとき。  
+  
+-   ホスト アプリケーションに対して、ワークフロー インスタンスの永続化またはアンロードが指示されたとき。  
+  
+-   ワークフロー インスタンスが終了したとき。  
+  
+-   **Persist** アクティビティが実行されたとき。  
+  
+-   以前のバージョンの Windows Workflow Foundation を使用して開発したワークフロー インスタンスが、相互運用可能な実行中に永続化ポイントに到達したとき。  
+  
+## このセクションの内容  
+  
+-   [SQL Workflow Instance Store](../../../docs/framework/windows-workflow-foundation//sql-workflow-instance-store.md)  
+  
+-   [インスタンス ストア](../../../docs/framework/windows-workflow-foundation//instance-stores.md)  
+  
+-   [永続参加要素](../../../docs/framework/windows-workflow-foundation//persistence-participants.md)  
+  
+-   [永続化のベスト プラクティス](../../../docs/framework/windows-workflow-foundation//persistence-best-practices.md)  
+  
+-   [非永続化ワークフロー インスタンス](../../../docs/framework/windows-workflow-foundation//non-persisted-workflow-instances.md)  
+  
+-   [ワークフローの一時停止と再開](../../../docs/framework/windows-workflow-foundation//pausing-and-resuming-a-workflow.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-security.md b/docs/framework/windows-workflow-foundation/workflow-security.md
new file mode 100644
index 00000000000..d8081559b79
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-security.md
@@ -0,0 +1,63 @@
+---
+title: "ワークフローのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], ワークフローのセキュリティ"
+ms.assetid: d712a566-f435-44c0-b8c0-49298e84b114
+caps.latest.revision: 13
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 13
+---
+# ワークフローのセキュリティ
+[!INCLUDE[wf](../../../includes/wf-md.md)] は、Microsoft SQL Server や [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] などの複数のさまざまなテクノロジと統合されています。  これらのテクノロジと相互作用するうえで、不適切に実行された場合にワークフローでセキュリティの問題が発生することがあります。  
+  
+## 永続化のセキュリティに関する注意事項  
+  
+1.  <xref:System.Activities.Statements.Delay> アクティビティと永続化を使用するワークフローは、サービスによって再アクティブ化する必要があります。  Windows AppFabric はワークフロー管理サービス \(WMS\) を使用して、タイマーが期限切れのワークフローを再アクティブ化します。  WMS は <xref:System.ServiceModel.WorkflowServiceHost> を作成して、再アクティブ化されたワークフローをホストします。  WMS サービスが停止した場合、永続化されたワークフローはタイマーが時間切れになっていると再アクティブ化されません。  
+  
+2.  永続的なインスタンスへのアクセスは、アプリケーション ドメイン外の安全でないエンティティから保護する必要があります。  また、開発者は、悪意のあるコードが永続性インスタンス化コードと同じアプリケーション ドメインで実行できないようにする必要があります。  
+  
+3.  永続性インスタンス化は、高い \(管理者の\) アクセス許可で実行しないでください。  
+  
+4.  アプリケーション ドメインの外部で処理されるデータは、保護する必要があります。  
+  
+5.  セキュリティの分離を必要とするアプリケーションは、スキーマ抽象化と同じインスタンスを共有しないようにします。  このようなアプリケーションは、異なるストア プロバイダーを使用するか、別のストアのインスタンス化を使用するように構成されたストア プロバイダーを使用する必要があります。  
+  
+## SQL サーバーのセキュリティに関する注意事項  
+  
+-   子アクティビティ、場所、ブックマーク、ホストの拡張機能、またはスコープを多数使用する場合、またはペイロードが非常に大きいブックマークを使用する場合、メモリが不足したり、永続化の実行中に必要以上のディスク容量が割り当てられる可能性があります。  オブジェクト レベルおよびデータベース レベルのセキュリティを使用すると、このような状態を緩和できます。  
+  
+-   <xref:System.Activities.DurableInstancing.SqlWorkflowInstanceStore> を使用する場合、インスタンス ストアをセキュリティで保護する必要があります。  「[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][SQL Server ベスト プラクティス](http://go.microsoft.com/fwlink/?LinkId=164972)」。  
+  
+-   インスタンス ストアの機密情報は暗号化する必要があります。  「[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][SQL のセキュリティの暗号化](http://go.microsoft.com/fwlink/?LinkId=164976)」。  
+  
+-   多くの場合、データベース接続文字列は構成ファイルに含まれているので、Windows レベルのセキュリティ \(ACL\) を使用して、構成ファイル \(通常は Web.Config\) が安全であるように、またログインとパスワードの情報が接続文字列に含まれないようにする必要があります。  Windows 認証をデータベースと Web サーバー間で代わりに使用する必要があります。  
+  
+## WorkflowServiceHost に関する考慮事項  
+  
+-   ワークフローで使用されている [!INCLUDE[indigo1](../../../includes/indigo1-md.md)] のエンドポイントは、セキュリティで保護される必要があります。  「[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][WCF のセキュリティの概要](http://go.microsoft.com/fwlink/?LinkID=164975)」。  
+  
+-   <xref:System.ServiceModel.ServiceAuthorizationManager> を使用して、ホスト レベルの認証を実装できます。  詳細については、「[方法 : サービスで使用するカスタム承認マネージャーを作成する](http://go.microsoft.com/fwlink/?LinkId=192228)」を参照してください。  これは、サンプル「[ワークフロー サービスのセキュリティ保護](../../../docs/framework/windows-workflow-foundation/samples/securing-workflow-services.md)」でも説明されています。  
+  
+-   受信メッセージの ServiceSecurityContext は、OperationContext へのアクセスによって、ワーク フロー内からも使用できます。  詳細については、「[ワークフロー サービスから OperationContext へのアクセス](../../../docs/framework/wcf/feature-details/accessing-operationcontext-from-a-workflow-service.md)」を参照してください。  
+  
+## WF Security Pack CTP  
+ Microsoft WF Security Pack CTP 1 は、[.NET Framework 4](http://msdn.microsoft.com/netframework/default.aspx) \(WF 4\) の [Windows Workflow Foundation](http://msdn.microsoft.com/netframework/aa663328.aspx) と [Windows Identity Foundation \(WIF\)](http://msdn.microsoft.com/security/aa570351.aspx) に基づく、一連のアクティビティとその実装の最初の Community Technology Preview \(CTP\) リリースです。  Microsoft WF Security Pack CTP 1 には、アクティビティおよび、ワークフローを使用してさまざまなセキュリティ関連のシナリオを簡単に有効にする方法を示すそのデザイナーの両方が含まれています。これらには以下のものが含まれます。  
+  
+1.  ワークフローのクライアント ID の偽装  
+  
+2.  PrincipalPermission やクレームの検証などの内部ワークフローの認証  
+  
+3.  ユーザー名\/パスワードやセキュリティ トークン サービス \(STS\) から取得するトークンなど、ワークフローで指定される ClientCredentials を使用した認証されたメッセージ  
+  
+4.  WS\-Trust ActAs を使用して、クライアント セキュリティ トークンをバックエンド サービス \(クレーム ベースの委任\) にフロー  
+  
+ 詳細については、また WF Security Pack CTP をダウンロードするには、「[WF Security Pack CTP](http://wf.codeplex.com/releases/view/48114)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-tracing.md b/docs/framework/windows-workflow-foundation/workflow-tracing.md
new file mode 100644
index 00000000000..72186ab1dc4
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-tracing.md
@@ -0,0 +1,80 @@
+---
+title: "ワークフロー トレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 18737989-0502-4367-b5f6-617ebfb77c96
+caps.latest.revision: 12
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 12
+---
+# ワークフロー トレース
+ワークフロー トレースでは、.NET Framework のトレース リスナーを使用して診断情報を取得できます。トレースは、アプリケーションで問題が検出された場合に有効にし、その問題が解決されたら、再度無効にすることが可能です。ワークフローのデバッグ トレースを有効にする方法は 2 つあります。また、イベント トレース ビューアーを使用してトレースを構成したり、<xref:System.Diagnostics> を使用してトレース イベントをファイルに送信したりすることができます。  
+  
+## ETW でのデバッグ トレースの有効化  
+ ETW を使用してトレースを有効化するには、次の手順に従ってイベント ビューアーでデバッグ チャネルを有効化します。  
+  
+1.  イベント ビューアーで分析ログおよびデバッグ ログのノードに移動します。  
+  
+2.  イベント ビューアーのツリー ビューで、**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[アプリケーション サーバー \- アプリケーション\]** を右クリックし、**\[表示\]**、**\[分析およびデバッグ ログの表示\]** の順にクリックします。**\[デバッグ\]** を右クリックし、**\[ログを有効にする\]** を選択します。  
+  
+3.  ワークフローがデバッグを実行し、トレースが ETW デバッグ チャネルに出力されると、トレースをイベント ビューアーで参照できます。**\[イベント ビューアー\]**、**\[アプリケーションとサービス ログ\]**、**\[Microsoft\]**、**\[Windows\]** の順に選択して **\[アプリケーション サーバー \- アプリケーション\]** に移動します。**\[デバッグ\]** を右クリックし、**\[更新\]** を選択します。  
+  
+4.  既定の分析トレースのバッファー サイズは 4 KB ですが、このサイズを 32 KB に増やすことをお勧めします。これを行うには、次の手順を実行します。  
+  
+    1.  現在のフレームワークのディレクトリ \(C:\\Windows\\Microsoft.NET\\Framework\\v4.0.21203 など\) で、次のコマンドを実行します。`wevtutil um Microsoft.Windows.ApplicationServer.Applications.man`  
+  
+    2.  Windows.ApplicationServer.Applications.man ファイルの \<bufferSize\> の値を 32 に変更します。  
+  
+        ```  
+        <channel name="Microsoft-Windows-Application Server-Applications/Analytic" chid="ANALYTIC_CHANNEL" symbol="ANALYTIC_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ANALYTIC_CHANNEL.message)" >  
+                    <publishing>  
+                      <bufferSize>32</bufferSize>  
+                    </publishing>  
+                  </channel>  
+  
+        ```  
+  
+    3.  現在のフレームワークのディレクトリ \(C:\\Windows\\Microsoft.NET\\Framework\\v4.0.21203 など\) で、次のコマンドを実行します。`wevtutil im Microsoft.Windows.ApplicationServer.Applications.man`  
+  
+> [!NOTE]
+>  .NET Framework 4 Client Profile を使用している場合は、.NET Framework 4 ディレクトリから次のコマンドを実行することによって、最初に ETW マニフェストを登録する必要があります。`ServiceModelReg.exe –i –c:etw`  
+  
+## System.Diagnostics を使用したデバッグ トレースの有効化  
+ これらのリスナーは、ワークフロー アプリケーションの App.config ファイルまたはワークフロー サービスの Web.config ファイルで構成します。この例では、現在のディレクトリにある MyTraceLog.txt ファイルにトレース情報を保存するように [TextWriterTraceListener](http://go.microsoft.com/fwlink/?LinkId=165424) が構成されています。  
+  
+```  
+<configuration>  
+  <system.diagnostics>  
+    <sources>  
+      <source name="System.Activities" switchValue="Information">  
+        <listeners>  
+          <add name="textListener" />  
+          <remove name="Default" />  
+        </listeners>  
+      </source>  
+    </sources>  
+    <sharedListeners>  
+      <add name="textListener"  
+           type="System.Diagnostics.TextWriterTraceListener"  
+           initializeData="MyTraceLog.txt"  
+           traceOutputOptions="ProcessId, DateTime" />  
+    </sharedListeners>  
+    <trace autoflush="true" indentsize="4">  
+      <listeners>  
+        <add name="textListener" />  
+      </listeners>  
+    </trace>  
+  </system.diagnostics>  
+</configuration>  
+```  
+  
+## 参照  
+ [Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273)   
+ [App Fabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201275)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-tracking-and-tracing.md b/docs/framework/windows-workflow-foundation/workflow-tracking-and-tracing.md
new file mode 100644
index 00000000000..f411d51b866
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-tracking-and-tracing.md
@@ -0,0 +1,63 @@
+---
+title: "ワークフロー追跡とトレース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プログラミング [WF], 追跡とトレース"
+ms.assetid: b965ded6-370a-483d-8790-f794f65b137e
+caps.latest.revision: 16
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 16
+---
+# ワークフロー追跡とトレース
+Windows ワークフロー追跡は、ワークフローの実行を確認できるように設計された [!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] の機能です。また、ワークフロー インスタンスの実行を追跡できる追跡インフラストラクチャが用意されています。WF 追跡インフラストラクチャはワークフローを透過的にインストルメント化し、実行中の主要イベントを反映してレコードを出力します。この機能はすべての [!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] ワークフローから既定で使用できます。[!INCLUDE[netfx_current_long](../../../includes/netfx-current-long-md.md)] ワークフローで追跡を実行するために変更は必要ありません。必要なのは、受信する追跡データの量を決定することのみです。ワークフロー インスタンスが開始または完了すると、追跡レコードの処理が出力されます。また、追跡によって、ワークフロー変数に関連付けられたビジネス関連データを抽出することもできます。たとえば、ワークフローが注文処理システムを表している場合、注文 ID と共に <xref:System.Activities.Tracking.TrackingRecord> オブジェクトを抽出できます。一般的に、WF 追跡機能を有効にすると、ワークフローの実行から診断またはビジネス分析データにアクセスしやすくなります。  
+  
+ これらの追跡コンポーネントは、[!INCLUDE[vstecwinfx](../../../includes/vstecwinfx-md.md)] の追跡サービスと同等です。[!INCLUDE[netfx_current_short](../../../includes/netfx-current-short-md.md)] では、WF 追跡機能のパフォーマンスが改善され、プログラミング モデルが簡略化されました。追跡ランタイムがワークフロー インスタンスをインストルメント化し、ワークフローのライフ サイクル、ワークフロー アクティビティ、およびカスタム イベント関連のイベントを出力します。  
+  
+ Windows Server App Fabric は、WCF とワーク フロー サービスの実行を監視することができます。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][Windows Server App Fabric の監視](http://go.microsoft.com/fwlink/?LinkId=201273) と [Windows Server AppFabric を使用したアプリケーションの監視](http://go.microsoft.com/fwlink/?LinkId=201287)  
+  
+ ワークフロー ランタイムの問題を解決するには、診断ワークフロー追跡を有効にします。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][ワークフロー トレース](../../../docs/framework/windows-workflow-foundation//workflow-tracing.md).  
+  
+ プログラミング モデルを理解するには、追跡インフラストラクチャの主要コンポーネントに関するトピックの説明を参照してください。  
+  
+-   <xref:System.Activities.Tracking.TrackingRecord> オブジェクトは、ワークフロー ランタイムから取得します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][追跡レコード](../../../docs/framework/windows-workflow-foundation//tracking-records.md).  
+  
+-   <xref:System.Activities.Tracking.TrackingParticipant> オブジェクトは <xref:System.Activities.Tracking.TrackingRecord> オブジェクトに定期受信します。追跡参加要素には、<xref:System.Activities.Tracking.TrackingRecord> オブジェクトのペイロードを処理するロジックがありません \(たとえば、ファイルに書き込むことができるなど\)。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][追跡参加要素](../../../docs/framework/windows-workflow-foundation//tracking-participants.md).  
+  
+-   <xref:System.Activities.Tracking.TrackingProfile> オブジェクトは、ワークフロー インスタンスから出力された追跡レコードをフィルター処理します。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)][追跡プロファイル](../../../docs/framework/windows-workflow-foundation//tracking-profiles.md).  
+  
+## ワークフロー追跡インフラストラクチャ  
+ ワークフロー追跡インフラストラクチャは、パブリッシュおよび定期受信のパラダイムに従っています。ワークフロー インスタンスは追跡レコードのパブリッシャーですが、追跡レコードのサブスクライバーはワークフローに対する拡張として登録されます。<xref:System.Activities.Tracking.TrackingRecord> オブジェクトに定期受信するこれらの拡張は、追跡参加要素と呼ばれます。追跡参加要素は、<xref:System.Activities.Tracking.TrackingRecord> オブジェクトにアクセスし、そのための書き込み方法にかかわらず処理する機能拡張ポイントです。追跡インフラストラクチャを使用すると、送信の追跡レコードにフィルターを適用して、参加要素からレコードのサブセットに定期受信できるようになります。このフィルター機構は追跡プロファイル ファイルによって実現します。  
+  
+ 追跡インフラストラクチャの概要図を次に示します。  
+  
+ ![ワークフロー追跡インフラストラクチャ](../../../docs/framework/windows-workflow-foundation//media/wv.gif "WV")  
+  
+## このセクションの内容  
+ [追跡レコード](../../../docs/framework/windows-workflow-foundation//tracking-records.md)  
+ ワークフロー ランタイムが出力する追跡レコードについて説明します。  
+  
+ [追跡プロファイル](../../../docs/framework/windows-workflow-foundation//tracking-profiles.md)  
+ 追跡プロファイルを使用する方法について説明します。  
+  
+ [追跡参加要素](../../../docs/framework/windows-workflow-foundation//tracking-participants.md)  
+ システム標準の追跡参加要素を使用する方法またはカスタムの追跡参加要素を作成する方法について説明します。  
+  
+ [ワークフローの追跡の構成](../../../docs/framework/windows-workflow-foundation//configuring-tracking-for-a-workflow.md)  
+ ワークフローの追跡を構成する方法について説明します。  
+  
+ [ワークフロー トレース](../../../docs/framework/windows-workflow-foundation//workflow-tracing.md)  
+ ワークフローのデバッグ追跡を有効にする 2 つの方法について説明します。  
+  
+ [トレースを使用したワークフロー実行時間の決定](../../../docs/framework/windows-workflow-foundation//determining-workflow-execution-duration-using-tracing.md)  
+ トレース メッセージを使用してワークフローの実行時間を決定する方法を説明します。  
+  
+## 参照  
+ [SQL 追跡](../../../docs/framework/windows-workflow-foundation/samples/sql-tracking.md)
\ No newline at end of file
diff --git a/docs/framework/windows-workflow-foundation/workflow-transactions.md b/docs/framework/windows-workflow-foundation/workflow-transactions.md
new file mode 100644
index 00000000000..25c36054ca3
--- /dev/null
+++ b/docs/framework/windows-workflow-foundation/workflow-transactions.md
@@ -0,0 +1,60 @@
+---
+title: "ワークフロー トランザクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 6081fb02-c0f2-483d-97b8-f3b7dc03011d
+caps.latest.revision: 14
+author: "Erikre"
+ms.author: "erikre"
+manager: "erikre"
+caps.handback.revision: 14
+---
+# ワークフロー トランザクション
+[!INCLUDE[wf1](../../../includes/wf1-md.md)] は、<xref:System.Activities.Statements.TransactionScope> アクティビティを使用してトランザクション済み作業単位のスコープを設定することで、<xref:System.Transactions> トランザクションへの参加をサポートします。<xref:System.Transactions.TransactionScope?displayProperty=fullName> は明示的に完了する必要がありますが、<xref:System.Activities.Statements.TransactionScope?displayProperty=fullName> アクティビティは正常完了時にトランザクション上で暗黙的に完了を呼び出します。<xref:System.Activities.Statements.TransactionScope.Body%2A> アクティビティの <xref:System.Activities.Statements.TransactionScope> に含まれるすべてのアクティビティは、トランザクションに参加します。WF は、<xref:System.ServiceModel.Activities.TransactedReceiveScope> アクティビティを使用してワークフローにトランザクションをフローできます。<xref:System.Activities.Statements.TransactionScope> アクティビティと同様に、<xref:System.ServiceModel.Activities.TransactedReceiveScope.Body%2A> に含まれるすべてのアクティビティはトランザクションに参加します。WF は、<xref:System.Transactions.Transaction.Current%2A?displayProperty=fullName> に依存するアクティビティが、<xref:System.Activities.Statements.TransactionScope> と <xref:System.ServiceModel.Activities.TransactedReceiveScope> の両方で確実に動作するようにします。システム標準アクティビティがすべての要件を満たさない場合、高度なフロー シナリオやトランザクション制御シナリオを可能にするには、<xref:System.Activities.RuntimeTransactionHandle> を使用してカスタム アクティビティを構築します。  
+  
+ 次の例は、[基本 TransactionScope](../../../docs/framework/windows-workflow-foundation/samples/basic-transactionscope.md) サンプルから取られ、ワーク フローは <xref:System.Activities.Statements.Sequence> アクティビティの構成で作成され、<xref:System.Activities.Statements.TransactionScope> のアクティビティを含む子アクティビティが含まれます。<xref:System.Activities.Statements.TransactionScope> の <xref:System.Activities.Statements.TransactionScope.Body%2A> アクティビティは、<xref:System.Activities.Statements.TransactionScope> アクティビティにより初期化されるトランザクションの下で実行されます。  
+  
+```csharp  
+static Activity ScenarioOne()  
+{  
+    return new Sequence  
+    {  
+        Activities =  
+        {  
+            new WriteLine { Text = "    Begin workflow" },  
+  
+            new TransactionScope  
+            {  
+                Body = new Sequence  
+                {  
+                    Activities =   
+                    {  
+                        new WriteLine { Text = "    Begin TransactionScope" },  
+  
+                        new PrintTransactionId(),  
+  
+                        new TransactionScopeTest(),  
+  
+                        new WriteLine { Text = "    End TransactionScope" },  
+                    },  
+                },  
+            },  
+  
+            new WriteLine { Text = "    End workflow" },  
+        }  
+    };  
+}  
+  
+```  
+  
+ [!INCLUDE[crdefault](../../../includes/crdefault-md.md)] は基本 [トランザクション](../../../docs/framework/windows-workflow-foundation/samples/basic-transactions.md) サンプル、およびシナリオ ベースの [トランザクション](../../../docs/framework/windows-workflow-foundation/samples/transactions.md) サンプルです。[!INCLUDE[crdefault](../../../includes/crdefault-md.md)]<xref:System.ServiceModel.Activities.TransactedReceiveScope> の使用は、「[ワークフロー サービスへのトランザクションのフロー](../../../docs/framework/wcf/feature-details/flowing-transactions-into-and-out-of-workflow-services.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Activities.Statements.TransactionScope>   
+ <xref:System.Transactions.TransactionScope>   
+ <xref:System.Transactions.Transaction.Current%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/winforms/TOC.md b/docs/framework/winforms/TOC.md
new file mode 100644
index 00000000000..fc0839c1135
--- /dev/null
+++ b/docs/framework/winforms/TOC.md
@@ -0,0 +1,59 @@
+# [方法 : INotifyPropertyChanged インターフェイスを実装する](how-to-implement-the-inotifypropertychanged-interface.md)
+# [Windows フォームのイベントの順序](order-of-events-in-windows-forms.md)
+# [方法 : クリックとダブルクリックを識別する](how-to-distinguish-between-clicks-and-double-clicks.md)
+# [方法 : キーボード入力をフォーム レベルで処理する](how-to-handle-keyboard-input-at-the-form-level.md)
+# [方法 : バインド コントロールを作成して表示データの書式を設定する](how-to-create-a-bound-control-and-format-the-displayed-data.md)
+# [Windows フォームのダイアログ ボックス](dialog-boxes-in-windows-forms.md)
+# [キーボード イベントの使用](using-keyboard-events.md)
+# [Windows フォームの座標](windows-forms-coordinates.md)
+# [新しい Windows フォームの作成](creating-a-new-windows-form.md)
+# [方法 : 子テーブルの選択行が現在位置を保持することを保証する](ensure-the-selected-row-in-a-child-table-correct.md)
+# [Windows フォームでのデータ バインド](windows-forms-data-binding.md)
+# [Windows フォームにおけるマウス ポインター](mouse-pointers-in-windows-forms.md)
+# [方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ](multiple-controls-bound-to-data-source-synchronized.md)
+# [方法 : Windows フォームのコレクションにアクセス キーを指定する](how-to-access-keyed-collections-in-windows-forms.md)
+# [Windows フォーム データ バインドの変更通知](change-notification-in-windows-forms-data-binding.md)
+# [方法 : Windows フォームの境界線を変更する](how-to-change-the-borders-of-windows-forms.md)
+# [方法 : Windows フォームのダイアログ ボックスを表示する](how-to-display-dialog-boxes-for-windows-forms.md)
+# [方法 : PropertyNameChanged パターンを適用する](how-to-apply-the-propertynamechanged-pattern.md)
+# [Windows フォームについて](getting-started-with-windows-forms.md)
+# [Windows フォームのサイズとスケールを調整する](adjusting-the-size-and-scale-of-windows-forms.md)
+# [Windows フォーム アプリケーションにおけるユーザー入力](user-input-in-a-windows-forms-application.md)
+# [キーボード入力のしくみ](how-keyboard-input-works.md)
+# [方法 : Windows フォームでデータ間を移動する](how-to-navigate-data-in-windows-forms.md)
+# [Windows フォームのセキュリティ](windows-forms-security.md)
+# [Windows フォームにおけるマウス イベント](mouse-events-in-windows-forms.md)
+# [Windows フォームにおけるマウスのキャプチャ](mouse-capture-in-windows-forms.md)
+# [方法 : ITypedList インターフェイスを実装する](how-to-implement-the-itypedlist-interface.md)
+# [イベントの概要](events-overview-windows-forms.md)
+# [Windows フォーム アプリケーションにおけるマウス入力](mouse-input-in-a-windows-forms-application.md)
+# [方法 : マウス イベントとキーボード イベントをコードでシミュレートする](how-to-simulate-mouse-and-keyboard-events-in-code.md)
+# [Windows フォームにおける自動スケーリング](automatic-scaling-in-windows-forms.md)
+# [Windows フォーム アプリケーションにおけるキーボード入力](keyboard-input-in-a-windows-forms-application.md)
+# [Windows フォームにおけるドラッグ アンド ドロップ機能](drag-and-drop-functionality-in-windows-forms.md)
+# [Windows フォーム内でのイベント ハンドラーの作成](creating-event-handlers-in-windows-forms.md)
+# [方法 : IListSource インターフェイスを実装する](how-to-implement-the-ilistsource-interface.md)
+# [Windows フォーム](index.md)
+# [方法 : キーボード入力を標準コントロールに変更する](how-to-modify-keyboard-input-to-a-standard-control.md)
+# [方法 : Windows フォームのサイズを変更する](how-to-resize-windows-forms.md)
+# [方法 : Windows フォームの 1 つのイベント ハンドラーに複数のイベントを関連付ける](how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md)
+# [Windows フォームでのユーザー入力の検証](user-input-validation-in-windows-forms.md)
+# [方法 : Windows フォーム アプリケーションでのフォント パターンの変更に応答する](how-to-respond-to-font-scheme-changes-in-a-windows-forms-application.md)
+# [Windows フォームでのより安全な印刷](more-secure-printing-in-windows-forms.md)
+# [Windows フォームにおけるマウス入力のしくみ](how-mouse-input-works-in-windows-forms.md)
+# [Windows フォームのセキュリティの概要](security-in-windows-forms-overview.md)
+# [方法 : コマンド ラインから Windows フォーム アプリケーションを作成する](how-to-create-a-windows-forms-application-from-the-command-line.md)
+# [データ連結と Windows フォーム](data-binding-and-windows-forms.md)
+# [方法 : Windows フォーム コントロールでユーザー入力イベントを処理する](how-to-handle-user-input-events-in-windows-forms-controls.md)
+# [Windows フォームがサポートするデータ ソース](data-sources-supported-by-windows-forms.md)
+# [Windows フォームにおけるファイルおよびデータへのより安全なアクセス](more-secure-file-and-data-access-in-windows-forms.md)
+# [方法 : Windows フォームに単純バインド コントロールを作成する](how-to-create-a-simple-bound-control-on-a-windows-form.md)
+# [Windows フォームの概要](windows-forms-overview.md)
+# [方法 : Windows フォームで実行時にイベント ハンドラーを作成する](how-to-create-event-handlers-at-run-time-for-windows-forms.md)
+# [イベント ハンドラーの概要](event-handlers-overview-windows-forms.md)
+# [方法 : どの修飾子キーが押されたかを判断する](how-to-determine-which-modifier-key-was-pressed.md)
+# [Windows フォームのセキュリティに関するその他の考慮事項](additional-security-considerations-in-windows-forms.md)
+# [データ連結に関連するインターフェイス](interfaces-related-to-data-binding.md)
+# [Windows フォームでのユーザー入力](user-input-in-windows-forms.md)
+# [Windows フォームの ClickOnce 配置](clickonce-deployment-for-windows-forms.md)
+# [Windows フォームの表示形式の変更](changing-the-appearance-of-windows-forms.md)
diff --git a/docs/framework/winforms/additional-security-considerations-in-windows-forms.md b/docs/framework/winforms/additional-security-considerations-in-windows-forms.md
new file mode 100644
index 00000000000..bf58df25f82
--- /dev/null
+++ b/docs/framework/winforms/additional-security-considerations-in-windows-forms.md
@@ -0,0 +1,110 @@
+---
+title: "Windows フォームのセキュリティに関するその他の考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "API 呼び出し, Windows フォームのセキュリティ設定"
+  - "API, 呼び出し"
+  - "クリップボードのトピック, セキュリティ (アクセスの)"
+  - "セキュリティ [Windows フォーム]"
+  - "セキュリティ [Windows フォーム], 呼び出し (API の)"
+  - "Windows API, 呼び出し"
+  - "Windows API, 安全な呼び出し"
+  - "Windows API, Windows フォームのセキュリティ設定"
+  - "Windows フォーム, 安全な呼び出し (Windows API の)"
+ms.assetid: 15abda8b-0527-47c7-aedb-77ab595f2bf1
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Windows フォームのセキュリティに関するその他の考慮事項
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] セキュリティ設定によっては、ローカル コンピューターとは異なり、アプリケーションが部分信頼環境で実行されることがあります。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、ファイル システム、ネットワーク、アンマネージ API などの重要なローカル リソースへのアクセスを他のリソースの場合よりも制限します。  セキュリティ設定により、セキュリティ システムが検証できない Microsoft Win32 API やその他の API を呼び出す機能が影響を受けます。  また、ファイルやデータへのアクセス、印刷など、アプリケーションのその他の処理にも影響があります。  部分信頼環境でのファイルやデータへのアクセスの詳細については、「[Windows フォームにおけるファイルおよびデータへのより安全なアクセス](../../../docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md)」を参照してください。  部分信頼環境での印刷の詳細については、「[Windows フォームでのより安全な印刷](../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)」を参照してください。  
+  
+ 以下のセクションでは、クリップボードの使用、ウィンドウ操作の実行、および部分信頼環境で動作しているアプリケーションからの Win32 API の呼び出しについて説明しています。  
+  
+## クリップボードへのアクセス  
+ <xref:System.Security.Permissions.UIPermission> クラスがクリップボードへのアクセスを制御し、関連付けられた <xref:System.Security.Permissions.UIPermissionClipboard> 列挙値がアクセスのレベルを示します。  使用されるアクセス許可レベルを次の表に示します。  
+  
+|UIPermissionClipboard の値|Description|  
+|------------------------------|-----------------|  
+|<xref:System.Security.Permissions.UIPermissionClipboard>|クリップボードは制限なしに使用できます。|  
+|<xref:System.Security.Permissions.UIPermissionClipboard>|クリップボードは制限付きで使用できます。  クリップボードにデータを格納する機能 \(\[コピー\] または \[切り取り\] のコマンド操作\) は制限されません。  テキスト ボックスなど、\[貼り付け\] を受け入れる固有のコントロールは、クリップボードのデータを受け入れます。しかし、ユーザー コントロールはプログラムでクリップボードからデータを読み取ることができません。|  
+|<xref:System.Security.Permissions.UIPermissionClipboard>|クリップボードは使用できません。|  
+  
+ 既定では、\[イントラネット\] ゾーンでは <xref:System.Security.Permissions.UIPermissionClipboard> アクセスが許可され、\[インターネット\] ゾーンでは <xref:System.Security.Permissions.UIPermissionClipboard> アクセスが許可されます。  つまり、アプリケーションはクリップボードにデータをコピーできますが、プログラムでクリップボードに貼り付けたりクリップボードから読み取ったりはできません。  これらの制限により、完全に信頼されていないプログラムは、他のアプリケーションによってクリップボードにコピーされた内容を読み取ることができません。  アプリケーションがクリップボードへの完全なアクセスを必要とするにもかかわらず、アクセス許可がない場合は、アプリケーションに対するアクセス許可の度合いを高める必要があります。  アクセス許可を増やす方法の詳細については、「[コード アクセス セキュリティと ADO.NET](http://msdn.microsoft.com/ja-jp/5121fe35-f0e3-402c-94ab-4f35b0a87b4b)」を参照してください。  
+  
+## ウィンドウ操作  
+ <xref:System.Security.Permissions.UIPermission> クラスは、ウィンドウ操作や他の UI 関連処理を実行するアクセス許可も管理し、関連付けられた <xref:System.Security.Permissions.UIPermissionWindow> 列挙値がアクセスのレベルを示します。  使用されるアクセス許可レベルを次の表に示します。  
+  
+ 既定では、\[イントラネット\] ゾーンでは <xref:System.Security.Permissions.UIPermissionWindow> アクセスが許可され、\[インターネット\] ゾーンでは <xref:System.Security.Permissions.UIPermissionWindow> アクセスが許可されます。  つまり、\[インターネット\] ゾーンでは、アプリケーションがほとんどのウィンドウ操作および UI 関連処理を実行できますが、ウィンドウの外観が変更されます。  変更されたウィンドウには、最初の実行時にバルーン通知が表示され、変更されたタイトル バー テキストが表示され、タイトル バーに閉じるボタンが必要になります。  バルーン通知とタイトル バーは、アプリケーションのユーザーに、アプリケーションが部分信頼で動作していることを示します。  
+  
+|UIPermissionWindow の値|Description|  
+|---------------------------|-----------------|  
+|<xref:System.Security.Permissions.UIPermissionWindow>|ユーザーは、すべてのウィンドウとユーザー入力イベントを無制限に使用できます。|  
+|<xref:System.Security.Permissions.UIPermissionWindow>|ユーザーは、セーフ トップレベル ウィンドウとセーフ サブウィンドウだけを描画に使用でき、それらのセーフ トップレベル ウィンドウとセーフ サブウィンドウの中のユーザー インターフェイスに対するユーザー入力イベントだけを使用できます。  これらのセーフ ウィンドウには明確なラベルが付けられ、最小サイズと最大サイズに制限があります。  これらの制限により、システム ログオン画面やシステム デスクトップの偽装など、有害の可能性がある、なりすまし攻撃が防止されます。また、親ウィンドウ、フォーカス関連の API、および <xref:System.Windows.Forms.ToolTip> コントロールの使用に対して、プログラムによるアクセスが制限されます。|  
+|<xref:System.Security.Permissions.UIPermissionWindow>|ユーザーは、セーフ サブウィンドウだけを描画に使用でき、そのセーフ サブウィンドウの中のユーザー インターフェイスに対するユーザー入力イベントだけを使用できます。  ブラウザー内に表示されるコントロールは、セーフ サブウィンドウの一例です。|  
+|<xref:System.Security.Permissions.UIPermissionWindow>|ユーザーは、ウィンドウおよびユーザー インターフェイス イベントを使用できません。  ユーザー インターフェイスは使用できません。|  
+  
+ <xref:System.Security.Permissions.UIPermissionWindow> 列挙値によって示される各アクセス許可レベルでは、レベルが下がるにつれて許可される処理が少なくなります。  <xref:System.Security.Permissions.UIPermissionWindow> と <xref:System.Security.Permissions.UIPermissionWindow> の値によって制限される処理を次の表に示します。  各メンバーに対して必要なアクセス許可については、.NET Framework クラス ライブラリのドキュメントで該当するメンバーのトピックを参照してください。  
+  
+ <xref:System.Security.Permissions.UIPermissionWindow> アクセス許可は、次の表に示される処理を制限します。  
+  
+|コンポーネント|制限される処理|  
+|-------------|-------------|  
+|<xref:System.Windows.Forms.Application>|-   <xref:System.Windows.Forms.Application.SafeTopLevelCaptionFormat%2A> プロパティの設定|  
+|<xref:System.Windows.Forms.Control>|-   <xref:System.Windows.Forms.Control.Parent%2A> プロパティの取得<br />-   `Region` プロパティの設定<br />-   <xref:System.Windows.Forms.Control.FindForm%2A>、<xref:System.Windows.Forms.Control.Focus%2A>、<xref:System.Windows.Forms.Control.FromChildHandle%2A>、<xref:System.Windows.Forms.Control.FromHandle%2A>、<xref:System.Windows.Forms.Control.PreProcessMessage%2A>、<xref:System.Windows.Forms.Control.ReflectMessage%2A>、または <xref:System.Windows.Forms.Control.SetTopLevel%2A> の各メソッドの呼び出し<br />-   返されたコントロールが呼び出し元のコントロールの子でない場合には、<xref:System.Windows.Forms.Control.GetChildAtPoint%2A> メソッドの呼び出し<br />-   コンテナー コントロール内でのコントロール フォーカスの変更|  
+|<xref:System.Windows.Forms.Cursor>|-   <xref:System.Windows.Forms.Cursor.Clip%2A> プロパティの設定<br />-   <xref:System.Windows.Forms.Control.Hide%2A> メソッドの呼び出し|  
+|<xref:System.Windows.Forms.DataGrid>|-   <xref:System.Windows.Forms.ContainerControl.ProcessTabKey%2A> メソッドの呼び出し|  
+|<xref:System.Windows.Forms.Form>|-   <xref:System.Windows.Forms.Form.ActiveForm%2A> プロパティまたは <xref:System.Windows.Forms.Form.MdiParent%2A> プロパティの取得<br />-   <xref:System.Windows.Forms.Form.ControlBox%2A>、<xref:System.Windows.Forms.Form.ShowInTaskbar%2A> プロパティ、または <xref:System.Windows.Forms.Form.TopMost%2A> プロパティの設定<br />-   50% より小さい <xref:System.Windows.Forms.Form.Opacity%2A> プロパティ値の設定<br />-   プログラムで <xref:System.Windows.Forms.Form.WindowState%2A> プロパティを <xref:System.Windows.Forms.FormWindowState> に設定<br />-   <xref:System.Windows.Forms.Form.Activate%2A> メソッドの呼び出し<br />-   <xref:System.Windows.Forms.FormBorderStyle>、<xref:System.Windows.Forms.FormBorderStyle>、および <xref:System.Windows.Forms.FormBorderStyle> という <xref:System.Windows.Forms.FormBorderStyle> 列挙値の使用|  
+|<xref:System.Windows.Forms.NotifyIcon>|-   <xref:System.Windows.Forms.NotifyIcon> コンポーネントの使用は完全に制限されます。|  
+  
+ <xref:System.Security.Permissions.UIPermissionWindow> の値は、<xref:System.Security.Permissions.UIPermissionWindow> の値による制限に加えて、次の表に示される処理を制限します。  
+  
+|コンポーネント|制限される処理|  
+|-------------|-------------|  
+|<xref:System.Windows.Forms.CommonDialog>|-   <xref:System.Windows.Forms.CommonDialog> クラスから派生したダイアログ ボックスの表示|  
+|<xref:System.Windows.Forms.Control>|-   <xref:System.Windows.Forms.Control.CreateGraphics%2A> メソッドの呼び出し<br />-   <xref:System.Windows.Forms.Control.Cursor%2A> プロパティの設定|  
+|<xref:System.Windows.Forms.Control.Cursor%2A>|-   <xref:System.Windows.Forms.Cursor.Current%2A> プロパティの設定|  
+|<xref:System.Windows.Forms.MessageBox>|-   <xref:System.Windows.Forms.Form.Show%2A> メソッドの呼び出し|  
+  
+### サードパーティ コントロールのホスト  
+ フォームでサードパーティ コントロールをホストしている場合、他の種類のウィンドウ操作が発生する可能性があります。  サードパーティ コントロールとは、自分で開発およびコンパイルを行っていないカスタムの <xref:System.Windows.Forms.UserControl> です。  ホスト シナリオを攻略するのは困難ですが、理論上、サードパーティ コントロールが描画サーフェイスを拡張して、フォームの領域全体を対象にする可能性があります。  このようなコントロールは、重要なダイアログ ボックスを模倣し、ユーザーのユーザー名\/パスワードの組み合わせや銀行口座番号などの情報を要求する可能性があります。  
+  
+ このような考えられるリスクを制限するために、信頼できる販売元のサードパーティ コントロールのみを使用します。  確認できないソースからサードパーティ コントロールをダウンロードした場合、攻略行為が実行されないかソース コードを確認します。  ソースに悪意がないことを検証してから、アセンブリを自分でコンパイルし、ソースがアセンブリと一致することを確認します。  
+  
+## Win32 API 呼び出し  
+ アプリケーションのデザインで Win32 API から関数を呼び出す必要がある場合は、アンマネージ コードにアクセスします。  この場合、Win32 API の呼び出しまたは値を使用するときに、ウィンドウまたはオペレーティング システムに対するコードの動作が決定できません。  <xref:System.Security.Permissions.SecurityPermission> クラスと、<xref:System.Security.Permissions.SecurityPermissionFlag> 列挙定数の <xref:System.Security.Permissions.SecurityPermissionFlag> 値によって、アンマネージ コードへのアクセスを制御します。  アプリケーションは、<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可が与えられている場合にだけ、アンマネージ コードにアクセスできます。  既定では、ローカルに動作しているアプリケーションだけがアンマネージ コードを呼び出すことができます。  
+  
+ Windows フォームのいくつかのメンバーが、<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可を必要とするアンマネージ アクセスを提供します。  アクセス許可を必要とする <xref:System.Windows.Forms> 名前空間のメンバーを次の表に示します。  メンバーに対して必要なアクセス許可の詳細については、.NET Framework クラス ライブラリのドキュメントを参照してください。  
+  
+|コンポーネント|メンバー|  
+|-------------|----------|  
+|<xref:System.Windows.Forms.Application>|-   <xref:System.Windows.Forms.Application.AddMessageFilter%2A> メソッド<br />-   <xref:System.Windows.Forms.Application.CurrentInputLanguage%2A> プロパティ<br />-   `Exit` メソッド<br />-   <xref:System.Windows.Forms.Application.ExitThread%2A> メソッド<br />-   <xref:System.Windows.Forms.Application.ThreadException> イベント|  
+|<xref:System.Windows.Forms.CommonDialog>|-   <xref:System.Windows.Forms.CommonDialog.HookProc%2A> メソッド<br />-   <xref:System.Windows.Forms.CommonDialog.OwnerWndProc%2A> メソッド<br />-   <xref:System.Windows.Forms.CommonDialog.Reset%2A> メソッド<br />-   <xref:System.Windows.Forms.CommonDialog.RunDialog%2A> メソッド|  
+|<xref:System.Windows.Forms.Control>|-   <xref:System.Windows.Forms.Control.CreateParams%2A> メソッド<br />-   <xref:System.Windows.Forms.Control.DefWndProc%2A> メソッド<br />-   <xref:System.Windows.Forms.Control.DestroyHandle%2A> メソッド<br />-   <xref:System.Windows.Forms.Control.WndProc%2A> メソッド|  
+|<xref:System.Windows.Forms.Help>|-   <xref:System.Windows.Forms.Help.ShowHelp%2A>メソッド<br />-   <xref:System.Windows.Forms.Help.ShowHelpIndex%2A> メソッド|  
+|<xref:System.Windows.Forms.NativeWindow>|-   <xref:System.Windows.Forms.NativeWindow> クラス|  
+|<xref:System.Windows.Forms.Screen>|-   <xref:System.Windows.Forms.Screen.FromHandle%2A> メソッド|  
+|<xref:System.Windows.Forms.SendKeys>|-   <xref:System.Windows.Forms.SendKeys.Send%2A> メソッド<br />-   <xref:System.Windows.Forms.SendKeys.SendWait%2A> メソッド|  
+  
+ アプリケーションがアンマネージ コードを呼び出すアクセス許可を持っていない場合、<xref:System.Security.Permissions.SecurityPermissionFlag> アクセス許可を要求するか、別の方法で機能を実装することを考慮する必要があります。多くの場合、Windows フォームでは代わりに Win32 API 関数のマネージ コードを提供します。  代わりの手段がなく、アプリケーションがアンマネージ コードにアクセスする必要がある場合は、アプリケーションに対するアクセス許可を増やす必要があります。  
+  
+ アンマネージ コードを呼び出すアクセス許可を与えられたアプリケーションは、ほとんど何でも実行できます。  そのため、アンマネージ コードを呼び出すアクセス許可は、信頼されたソースからのアプリケーションに対してだけ与えるようにしてください。  また、アプリケーションによっては、アンマネージ コードへの呼び出しを生成するアプリケーション機能の一部をオプションにするか、完全信頼環境でのみ有効にすることもできます。  危険なアクセス許可の詳細については、「[危険なアクセス許可とポリシー管理](../../../docs/framework/misc/dangerous-permissions-and-policy-administration.md)」を参照してください。  アクセス許可の昇格の詳細については、「[NIB: General Security Policy Administration](http://msdn.microsoft.com/ja-jp/5121fe35-f0e3-402c-94ab-4f35b0a87b4b)」を参照してください。  
+  
+## 参照  
+ [Windows フォームにおけるファイルおよびデータへのより安全なアクセス](../../../docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md)   
+ [Windows フォームでのより安全な印刷](../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)   
+ [Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)   
+ [Windows フォームのセキュリティ](../../../docs/framework/winforms/windows-forms-security.md)   
+ [ClickOnce アプリケーションのセキュリティ](../Topic/Securing%20ClickOnce%20Applications.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/adjusting-the-size-and-scale-of-windows-forms.md b/docs/framework/winforms/adjusting-the-size-and-scale-of-windows-forms.md
new file mode 100644
index 00000000000..d615e63f0fc
--- /dev/null
+++ b/docs/framework/winforms/adjusting-the-size-and-scale-of-windows-forms.md
@@ -0,0 +1,47 @@
+---
+title: "Windows フォームのサイズとスケールを調整する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 調整 (サイズを)"
+  - "Windows フォーム, 変更 (スケールを)"
+  - "Windows フォーム, 変更 (サイズを)"
+ms.assetid: a014d2b3-3273-4521-95e1-00171033bf58
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォームのサイズとスケールを調整する
+このトピックは、Windows フォームのサイズ変更に関する情報へのリンクを示します。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームのサイズを変更する](../../../docs/framework/winforms/how-to-resize-windows-forms.md)  
+ Windows フォームのサイズを指定する方法について説明します。  
+  
+ [Windows フォームにおける自動スケーリング](../../../docs/framework/winforms/automatic-scaling-in-windows-forms.md)  
+ 自動スケーリングにより、マシン間でフォームとコントロールが適切に表示される方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Size>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームの表示形式の変更](../../../docs/framework/winforms/changing-the-appearance-of-windows-forms.md)  
+ Windows フォームの外観を変更する他の方法を説明するトピックへのリンクを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/TOC.md b/docs/framework/winforms/advanced/TOC.md
new file mode 100644
index 00000000000..d11dc2a0188
--- /dev/null
+++ b/docs/framework/winforms/advanced/TOC.md
@@ -0,0 +1,192 @@
+# [方法 : フォント メトリックを取得する](how-to-obtain-font-metrics.md)
+# [方法 : 補間モードを使用してスケーリング時の画質を制御する](how-to-use-interpolation-mode-to-control-image-quality-during-scaling.md)
+# [方法 : アプリケーション間でドラッグ アンド ドロップ操作を実行する](how-to-perform-drag-and-drop-operations-between-applications.md)
+# [方法 : 形状のアウトラインを描画する](how-to-draw-an-outlined-shape.md)
+# [方法 : 1 本のベジエ スプラインを描画する](how-to-draw-a-single-bezier-spline.md)
+# [方法 : エンコーダーがサポートするパラメーターの確認](how-to-determine-the-parameters-supported-by-an-encoder.md)
+# [カスタム コントロールのアプリケーション設定](application-settings-for-custom-controls.md)
+# [方法 : 複合モードを使用してアルファ ブレンドを制御する](how-to-use-compositing-mode-to-control-alpha-blending.md)
+# [イメージの色の変更](recoloring-images.md)
+# [パスの作成および描画](constructing-and-drawing-paths.md)
+# [方法 : ライン キャップを使用した直線を描画する](how-to-draw-a-line-with-line-caps.md)
+# [チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行](walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md)
+# [グラフィックス プログラミングについて](getting-started-with-graphics-programming.md)
+# [方法 : サムネイル イメージを作成する](how-to-create-thumbnail-images.md)
+# [GDI+ でのブラシと塗りつぶされた図形](brushes-and-filled-shapes-in-gdi.md)
+# [マネージ グラフィックス クラスの使用](using-managed-graphics-classes.md)
+# [方法 : 曲線のパスを直線に平坦化する](how-to-flatten-a-curved-path-into-a-line.md)
+# [チュートリアル: WPF コンテンツへのスタイルの適用](walkthrough-styling-wpf-content.md)
+# [方法 : デザイン時に ElementHost コントロールをコピーして貼り付ける](how-to-copy-and-paste-an-elementhost-control-at-design-time.md)
+# [方法 : 色を回転させる](how-to-rotate-colors.md)
+# [方法 : 四角形内にテキストを折り返して描画する](how-to-draw-wrapped-text-in-a-rectangle.md)
+# [変換を使用した色のスケーリング](using-transformations-to-scale-colors.md)
+# [方法 :テクスチャを使用して塗りつぶした直線を描画する](how-to-draw-a-line-filled-with-a-texture.md)
+# [ダブル バッファリングの使用](using-double-buffering.md)
+# [方法 : 実行時に設定を C# で読み取る](how-to-read-settings-at-run-time-with-csharp.md)
+# [方法 : グラデーションに対してガンマ補正を適用する](how-to-apply-gamma-correction-to-a-gradient.md)
+# [方法 : Windows フォームに塗りつぶした四角形を描画する](how-to-draw-a-filled-rectangle-on-a-windows-form.md)
+# [フォントとテキストの使用](using-fonts-and-text.md)
+# [方法 : フォント ファミリとフォントを作成する](how-to-construct-font-families-and-fonts.md)
+# [方法 : カスタム破線を描画する](how-to-draw-a-custom-dashed-line.md)
+# [方法 : Windows フォームを継承する](how-to-inherit-windows-forms.md)
+# [アプリケーション設定アーキテクチャ](application-settings-architecture.md)
+# [方法 : Windows フォームを印刷する](how-to-print-a-windows-form.md)
+# [座標系の種類](types-of-coordinate-systems.md)
+# [ImeMode プロパティによるアジア言語の文字表示](display-of-asian-characters-with-the-imemode-property.md)
+# [方法 : 設計時に新しい設定を作成する](how-to-create-a-new-setting-at-design-time.md)
+# [方法 : GDI+ を使用してイメージをレンダリングする](how-to-render-images-with-gdi.md)
+# [ブラシを使用した図形の塗りつぶし](using-a-brush-to-fill-shapes.md)
+# [Windows フォーム アプリケーションにおけるネットワーク](networking-in-windows-forms-applications.md)
+# [グローバル変換とローカル変換](global-and-local-transformations.md)
+# [チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの割り当て](walkthrough-assigning-wpf-content-on-windows-forms-at-design-time.md)
+# [GDI+ でのイメージのトリミングおよびスケーリング](cropping-and-scaling-images-in-gdi.md)
+# [ユーザ補助ガイドラインをサポートする Windows フォーム コントロールのプロパティ](properties-on-windows-forms-controls-that-support-accessibility-guidelines.md)
+# [Windows フォームでの電源管理](power-management-in-windows-forms.md)
+# [直線、曲線、および図形](lines-curves-and-shapes.md)
+# [方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)
+# [方法 : ペンの色を設定する](how-to-set-the-color-of-a-pen.md)
+# [GDI+ マネージ コードについて](about-gdi-managed-code.md)
+# [Windows フォームでのヘルプの統合](integrating-user-help-in-windows-forms.md)
+# [GDI+ での多角形](polygons-in-gdi.md)
+# [イメージ、ビットマップ、アイコン、およびメタファイルの操作](working-with-images-bitmaps-icons-and-metafiles.md)
+# [グラフィックスについて](overview-of-graphics.md)
+# [GDI+ でのグラフィックス パス](graphics-paths-in-gdi.md)
+# [方法 : 不透明ブラシおよび半透明ブラシを使用して描画する](how-to-draw-with-opaque-and-semitransparent-brushes.md)
+# [方法 : カーディナル スプラインを描画する](how-to-draw-cardinal-splines.md)
+# [Windows フォームにおける印刷のサポート](windows-forms-print-support.md)
+# [方法 : イメージを回転、反転、および傾斜させる](how-to-rotate-reflect-and-skew-images.md)
+# [方法 : カラー行列を使用してイメージのアルファ値を設定する](how-to-use-a-color-matrix-to-set-alpha-values-in-images.md)
+# [方法 : ペンの幅と配置を設定する](how-to-set-pen-width-and-alignment.md)
+# [チュートリアル: デザイン時のホストされている WPF 要素のプロパティの変更](walkthrough-changing-properties-of-a-hosted-wpf-element-at-design-time.md)
+# [入れ子になっているグラフィックス コンテナーの使用](using-nested-graphics-containers.md)
+# [方法 : MDI 子フォームを配置する](how-to-arrange-mdi-child-forms.md)
+# [座標系と変換](coordinate-systems-and-transformations.md)
+# [方法 : 直線を接合する](how-to-join-lines.md)
+# [方法 : アプリケーション設定を検証する](how-to-validate-application-settings.md)
+# [方法 : BMP イメージから PNG イメージへの変換](how-to-convert-a-bmp-image-to-a-png-image.md)
+# [方法 : 実行時にユーザー設定を C# で書き込む](how-to-write-user-settings-at-run-time-with-csharp.md)
+# [方法 : ハッチ パターンで図形を塗りつぶす](how-to-fill-a-shape-with-a-hatch-pattern.md)
+# [方法 : クリップボードからデータを取得する](how-to-retrieve-data-from-the-clipboard.md)
+# [方法 : カラー リマップ テーブルを使用する](how-to-use-a-color-remap-table.md)
+# [方法 : [継承ピッカー] ダイアログ ボックスを使用してフォームを継承する](how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md)
+# [グラフィックスの概要](graphics-overview-windows-forms.md)
+# [方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する](how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md)
+# [方法 : 不透明な直線および半透明な直線を描画する](how-to-draw-opaque-and-semitransparent-lines.md)
+# [GDI+ での描画サーフェイスの制限](restricting-the-drawing-surface-in-gdi.md)
+# [ペンを使用した直線と図形の描画](using-a-pen-to-draw-lines-and-shapes.md)
+# [方法 : Windows フォームでファイルに関連付けられているアイコンを抽出する](how-to-extract-the-icon-associated-with-a-file-in-windows-forms.md)
+# [方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](com-interop-by-displaying-a-windows-form-shadow.md)
+# [方法 : ソリッド ブラシを作成する](how-to-create-a-solid-brush.md)
+# [Windows フォームのビジュアルの継承](windows-forms-visual-inheritance.md)
+# [方法 : 描画テキストを配置する](how-to-align-drawn-text.md)
+# [方法 : 直線、曲線、および形状から図形を作成する](how-to-create-figures-from-lines-curves-and-shapes.md)
+# [Windows フォームとアンマネージ アプリケーション](windows-forms-and-unmanaged-applications.md)
+# [直線と曲線のアンチエイリアシング](antialiasing-with-lines-and-curves.md)
+# [方法 : ペンを作成する](how-to-create-a-pen.md)
+# [ドラッグ アンド ドロップ操作とクリップボードのサポート](drag-and-drop-operations-and-clipboard-support.md)
+# [方法 : Windows アプリケーションにヘルプを提供する](how-to-provide-help-in-a-windows-application.md)
+# [Windows フォーム アプリケーションの双方向サポート](bi-directional-support-for-windows-forms-applications.md)
+# [方法 : Windows フォームに塗りつぶした楕円を描画する](how-to-draw-a-filled-ellipse-on-a-windows-form.md)
+# [領域の使用](using-regions.md)
+# [曲線の作成と描画](constructing-and-drawing-curves.md)
+# [グラフィックス コンテナーの使用](using-graphics-containers.md)
+# [方法 : 実行時にビットマップを作成する](how-to-create-a-bitmap-at-run-time.md)
+# [Windows フォーム アプリケーションの拡張](index.md)
+# [Windows フォームのグローバル化](globalizing-windows-forms.md)
+# [方法 : イメージ メタデータを読み取る](how-to-read-image-metadata.md)
+# [方法 : Windows フォームに縦書きテキストを描画する](how-to-draw-vertical-text-on-a-windows-form.md)
+# [イメージ、ビットマップ、およびメタファイル](images-bitmaps-and-metafiles.md)
+# [チュートリアル : ElementHost コントロールの別の Windows フォームへのコピーと貼り付け](copy--paste-an-elementhost-control-into-forms.md)
+# [方法 : 成型された Windows フォームを作成する](how-to-create-a-shaped-windows-form.md)
+# [方法 : イメージを並べたパターンによって図形を塗りつぶす](how-to-tile-a-shape-with-an-image.md)
+# [方法 : 線形グラデーションを作成する](how-to-create-a-linear-gradient.md)
+# [ビットマップの種類](types-of-bitmaps.md)
+# [チュートリアル : ユーザー補助対応の Windows ベースのアプリケーションの作成](walkthrough-creating-an-accessible-windows-based-application.md)
+# [方法 : プライベート フォント コレクションを作成する](how-to-create-a-private-font-collection.md)
+# [方法 : 描画されたテキストにタブ ストップを設定する](how-to-set-tab-stops-in-drawn-text.md)
+# [Windows フォームのアプリケーション設定](application-settings-for-windows-forms.md)
+# [方法 : Windows フォームでユーザーのコンピューターに接続されたプリンターを選択する](how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md)
+# [Graphics オブジェクトの状態の管理](managing-the-state-of-a-graphics-object.md)
+# [方法 : メタファイルを読み込んで表示する](how-to-load-and-display-metafiles.md)
+# [方法 : テキストを指定の位置に描画する](how-to-draw-text-at-a-specified-location.md)
+# [方法 : 自動スケーリングを解除してパフォーマンスを向上させる](how-to-improve-performance-by-avoiding-automatic-scaling.md)
+# [チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの配置](walkthrough-arranging-wpf-content-on-windows-forms-at-design-time.md)
+# [方法 : 設計時に既存の設定の値を変更する](how-to-change-the-value-of-an-existing-setting-at-design-time.md)
+# [方法 : Windows フォームにテキストを描画する](how-to-draw-text-on-a-windows-form.md)
+# [方法: 既存のビットマップを画面に描画する](how-to-draw-an-existing-bitmap-to-the-screen.md)
+# [方法 : 開いている図形を塗りつぶす](how-to-fill-open-figures.md)
+# [マルチ ドキュメント インターフェイス (MDI) アプリケーション](multiple-document-interface-mdi-applications.md)
+# [GDI+ でのベジエ スプライン](bezier-splines-in-gdi.md)
+# [方法 : Windows フォームに直線を描画する](how-to-draw-a-line-on-a-windows-form.md)
+# [方法 : ペンを使用して四角形を描画する](how-to-use-a-pen-to-draw-rectangles.md)
+# [アプリケーション設定とユーザー設定の使用](using-application-settings-and-user-settings.md)
+# [アルファ ブレンドの直線と塗りつぶし](alpha-blending-lines-and-fills.md)
+# [アプリケーション設定の属性](application-settings-attributes.md)
+# [GDI+ での領域](regions-in-gdi.md)
+# [GDI+ でのメタファイル](metafiles-in-gdi.md)
+# [方法 : バッファリングされたグラフィックスを手動で描画する](how-to-manually-render-buffered-graphics.md)
+# [方法 : 垂直方向のテキストを作成する](how-to-create-vertical-text.md)
+# [方法 : イメージ テクスチャによって図形を塗りつぶす](how-to-fill-a-shape-with-an-image-texture.md)
+# [ダブル バッファリングされたグラフィックス](double-buffered-graphics.md)
+# [方法 : バッファリングされたグラフィックスを手動で管理する](how-to-manually-manage-buffered-graphics.md)
+# [方法 : JPEG 圧縮レベルの設定](how-to-set-jpeg-compression-level.md)
+# [方法 : Windows フォームで印刷プレビューを使用して印刷する](how-to-print-in-windows-forms-using-print-preview.md)
+# [方法 : インストールされたエンコーダーの一覧](how-to-list-installed-encoders.md)
+# [方法 : テキストでのアンチエイリアシングの使用](how-to-use-antialiasing-with-text.md)
+# [方法 : C# のアプリケーションに複数の設定セットを追加する](how-to-add-multiple-sets-of-settings-to-your-application-in-csharp.md)
+# [方法 : カラー行列を使用して単一色を変換する](how-to-use-a-color-matrix-to-transform-a-single-color.md)
+# [方法 : 領域でクリッピングを使用する](how-to-use-clipping-with-a-region.md)
+# [方法 : 実行時に PrintDialog のユーザー入力をキャプチャする](how-to-capture-user-input-from-a-printdialog-at-run-time.md)
+# [方法 : 領域でヒット テストを使用する](how-to-use-hit-testing-with-a-region.md)
+# [変換順序が重要となる理由](why-transformation-order-is-significant.md)
+# [方法 : 一連のベジエ スプラインを描画する](how-to-draw-a-sequence-of-bezier-splines.md)
+# [Windows フォームにおけるグラフィックスと描画](graphics-and-drawing-in-windows-forms.md)
+# [方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](how-to-print-a-multi-page-text-file-in-windows-forms.md)
+# [GDI+ での楕円および円弧](ellipses-and-arcs-in-gdi.md)
+# [方法 :ピクセルをコピーして Windows フォームのちらつきを低減する](how-to-copy-pixels-for-reducing-flicker-in-windows-forms.md)
+# [方法 : アクティブな MDI 子フォームを特定する](how-to-determine-the-active-mdi-child.md)
+# [方法 : Modifiers プロパティおよび GenerateMember プロパティを使用する](how-to-use-the-modifiers-and-generatemember-properties.md)
+# [方法 : Windows フォームでグラフィックスを印刷する](how-to-print-graphics-in-windows-forms.md)
+# [システム情報と Windows フォーム](system-information-and-windows-forms.md)
+# [GDI+ でのペン、直線、および四角形](pens-lines-and-rectangles-in-gdi.md)
+# [チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)
+# [グラデーション ブラシを使用した図形の塗りつぶし](using-a-gradient-brush-to-fill-shapes.md)
+# [Windows フォームおよびコントロールの国際対応フォント](international-fonts-in-windows-forms-and-controls.md)
+# [Windows フォーム アプリケーションのヘルプ システム](help-systems-in-windows-forms-applications.md)
+# [方法 : GDI を使用してテキストを描画する](how-to-draw-text-with-gdi.md)
+# [方法 : インストールされているフォントを列挙する](how-to-enumerate-installed-fonts.md)
+# [方法 : クリップボードにデータを追加する](how-to-add-data-to-the-clipboard.md)
+# [方法 : Windows フォームの印刷ジョブを完了する](how-to-complete-windows-forms-print-jobs.md)
+# [Windows フォームのユーザー補助](windows-forms-accessibility.md)
+# [エンコード方式および Windows フォームのグローバリゼーション](encoding-and-windows-forms-globalization.md)
+# [方法 : ポップアップ ヘルプを表示する](how-to-display-pop-up-help.md)
+# [方法 : イメージの色を変換する](how-to-translate-image-colors.md)
+# [マネージ GDI+ での変換の使用](using-transformations-in-managed-gdi.md)
+# [方法 : アプリケーション設定を作成する](how-to-create-application-settings.md)
+# [ワールド変換の使用](using-the-world-transformation.md)
+# [基本フォームの外観を変更した場合の影響](effects-of-modifying-base-form-appearance.md)
+# [方法 : アプリケーション セッション間で設定値を変更する](how-to-change-the-value-of-a-setting-between-application-sessions.md)
+# [方法 : パス グラデーションを作成する](how-to-create-a-path-gradient.md)
+# [方法 : MDI 子フォームを作成する](how-to-create-mdi-child-forms.md)
+# [方法 : 描画する Graphics オブジェクトを作成する](how-to-create-graphics-objects-for-drawing.md)
+# [方法 : MDI 親フォームを作成する](how-to-create-mdi-parent-forms.md)
+# [方法 : インストールされたデコーダーの一覧](how-to-list-installed-decoders.md)
+# [方法 : アクティブな MDI 子フォームにデータを送信する](how-to-send-data-to-the-active-mdi-child.md)
+# [マネージ GDI+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](using-image-encoders-and-decoders-in-managed-gdi.md)
+# [アプリケーション設定の概要](application-settings-overview.md)
+# [方法 : 色を傾斜する](how-to-shear-colors.md)
+# [Windows フォームおよびアンマネージ アプリケーションの概要](windows-forms-and-unmanaged-applications-overview.md)
+# [GDI+ でのイメージの描画、配置、およびクローン作成](drawing-positioning-and-cloning-images-in-gdi.md)
+# [GDI+ でのカーディナル スプライン](cardinal-splines-in-gdi.md)
+# [GDI+ での開いた曲線と閉じた曲線](open-and-closed-curves-in-gdi.md)
+# [方法 : ペンを使用して線を描画する](how-to-use-a-pen-to-draw-lines.md)
+# [グラフィックス サービスの 3 つのカテゴリ](three-categories-of-graphics-services.md)
+# [変換の行列表現](matrix-representation-of-transformations.md)
+# [方法 : 純色で図形を塗りつぶす](how-to-fill-a-shape-with-a-solid-color.md)
+# [方法 : イメージをトリミングおよびスケーリングする](how-to-crop-and-scale-images.md)
+# [WPF コントロールの使用](using-wpf-controls.md)
+# [方法 : 標準の Windows フォーム印刷ジョブを作成する](how-to-create-standard-windows-forms-print-jobs.md)
+# [ツールヒントを使用したコントロールのヘルプ](control-help-using-tooltips.md)
+# [チュートリアル : ビジュアル継承のデモンストレーション](walkthrough-demonstrating-visual-inheritance.md)
+# [ベクター グラフィックスの概要](vector-graphics-overview.md)
+# [グラフィックス インターフェイスの構造体](structure-of-the-graphics-interface.md)
diff --git a/docs/framework/winforms/advanced/about-gdi-managed-code.md b/docs/framework/winforms/advanced/about-gdi-managed-code.md
new file mode 100644
index 00000000000..dffbaf00212
--- /dev/null
+++ b/docs/framework/winforms/advanced/about-gdi-managed-code.md
@@ -0,0 +1,72 @@
+---
+title: "GDI+ マネージ コードについて | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+"
+  - "GDI+, GDI+ の概要"
+  - "グラフィックス, GDI+"
+ms.assetid: a98a76ab-e455-49c9-891c-0491ac932f2c
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# GDI+ マネージ コードについて
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、2 次元ベクター グラフィックス、イメージング、および文字体裁を提供する Windows オペレーティング システムの部分です。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は新機能を追加し、既存の機能を最適化することで、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] \(以前のバージョンの Windows に含まれているグラフィックス デバイス インターフェイス\) を強化しています。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] マネージ クラスのインターフェイス \(ラッパーのセット\) は、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] 一部である XML Web サービスとその他のアプリケーションの構築、配置、および実行のための環境です。  
+  
+ このセクションは、マネージ コードを使用するプログラマのための [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] API に関する情報を示しています。  
+  
+## このセクションの内容  
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)  
+ ベクター グラフィックスについて説明します。  
+  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)  
+ 使用可能なイメージの種類とそれらを操作する方法について説明します。  
+  
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用してグラフィックスを変換する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Image?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Bitmap?displayProperty=fullName>、  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Imaging.Metafile?displayProperty=fullName>、  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Font?displayProperty=fullName>、  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Brush?displayProperty=fullName>、  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Color?displayProperty=fullName>、  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Drawing2D.Matrix?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.TextRenderer?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)  
+ `Graphics` プログラミング インターフェイスを使用する方法を説明するトピックへのリンクが含まれます。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md b/docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md
new file mode 100644
index 00000000000..84e8a6934fd
--- /dev/null
+++ b/docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md
@@ -0,0 +1,52 @@
+---
+title: "アルファ ブレンドの直線と塗りつぶし | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アルファ ブレンド"
+  - "アルファ ブレンド, 使用 (塗りつぶしで)"
+  - "アルファ ブレンド, 使用 (直線で)"
+  - "例 [Windows フォーム], アルファ ブレンド"
+  - "塗りつぶし, アルファ ブレンド"
+  - "線, 追加 (透明度を)"
+  - "線, アルファ ブレンド"
+  - "形状, 追加 (透明度を)"
+ms.assetid: 5440f48c-3ac9-44c3-b170-c1c110bdbab8
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# アルファ ブレンドの直線と塗りつぶし
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、アルファ、赤、緑、青の各要素に 8 ビットずつ割り当てた 32 ビット値で色を表します。  アルファ値は、色の透明度、つまり、色を背景色とブレンドする度合いを示します。  アルファ値の範囲は 0 から 255 までです。0 は色の透明度が最大であることを表し、255 は色の不透明度が最大であることを表します。  
+  
+ アルファ ブレンドでは、ソース カラーのデータと背景色のデータをピクセルごとにブレンドします。  ソース カラーの 3 つの各要素 \(赤、緑、青\) は、次の数式に基づいて、背景色の対応する要素とブレンドされます。  
+  
+ displayColor \= sourceColor × alpha \/ 255 \+ backgroundColor × \(255 – alpha\) \/ 255  
+  
+ たとえば、ソース カラーの赤の要素が 150、背景色の赤の要素が 100 だとします。  アルファ値が 200 の場合、生成される色の赤の要素は、次のように計算されます。  
+  
+ 150 × 200 \/ 255 \+ 100 × \(255 – 200\) \/ 255 \= 139  
+  
+## このセクションの内容  
+ [方法 : 不透明な直線および半透明な直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md)  
+ アルファ ブレンドされた線を描画する方法を示します。  
+  
+ [方法 : 不透明ブラシおよび半透明ブラシを使用して描画する](../../../../docs/framework/winforms/advanced/how-to-draw-with-opaque-and-semitransparent-brushes.md)  
+ ブラシでアルファ ブレンドする方法を説明します。  
+  
+ [方法 : 複合モードを使用してアルファ ブレンドを制御する](../../../../docs/framework/winforms/advanced/how-to-use-compositing-mode-to-control-alpha-blending.md)  
+ <xref:System.Drawing.Drawing2D.CompositingMode> を使用してアルファ ブレンドを制御する方法を説明します。  
+  
+ [方法 : カラー行列を使用してイメージのアルファ値を設定する](../../../../docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-set-alpha-values-in-images.md)  
+ <xref:System.Drawing.Imaging.ColorMatrix> オブジェクトを使用してアルファ ブレンドを制御する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/antialiasing-with-lines-and-curves.md b/docs/framework/winforms/advanced/antialiasing-with-lines-and-curves.md
new file mode 100644
index 00000000000..ec58a817161
--- /dev/null
+++ b/docs/framework/winforms/advanced/antialiasing-with-lines-and-curves.md
@@ -0,0 +1,56 @@
+---
+title: "直線と曲線のアンチエイリアシング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アンチエイリアシング"
+  - "アンチエイリアシング, スムージング モード"
+  - "GDI+, アンチエイリアシング"
+ms.assetid: 810da1a4-c136-4abf-88df-68e49efdd8d4
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 直線と曲線のアンチエイリアシング
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して直線を描画する場合は、直線の開始点と終了点を指定しますが、直線上のそれぞれのピクセルについての情報を指定する必要はありません。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] とディスプレイ ドライバー ソフトウェアによって、特定の表示デバイス上で直線を表示するためにどのピクセルをオンにするかが決定されます。  
+  
+## エイリアシング  
+ 点 \(4, 2\) と点 \(16, 10\) を結ぶ赤い直線を表示するとします。  座標系の原点が左上隅で、座標系の単位がピクセルであると仮定します。  また、x 軸が右向き、y 軸が下向きであると仮定します。  多色の背景上に描画された、赤い直線を拡大した表示を次の図に示します。  
+  
+ ![線 &#40;アンチエイリアシングなし&#41;](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art33.png "AboutGdip02\_Art33")  
+  
+ 直線のレンダリングに使用された赤いピクセルは不透明です。  直線上には、部分的に透明なピクセルはありません。  直線をこの方法でレンダリングすると、直線の輪郭がぎざぎざになり、細かい階段状になった直線が表示されます。  このように階段状の表示を使用して直線を表現する手法をエイリアシングと呼びます。階段状の表示は、理論上の直線です。  
+  
+## アンチエイリアシング  
+ エイリアシングよりも高度な直線のレンダリング手法では、不透明なピクセルと共に部分的に透明なピクセルを使用します。  各ピクセルは、ピクセルから直線までの距離に応じて、純色の赤または赤と背景色をブレンドした色に設定されます。  このようなレンダリングをアンチエイリアシングと呼び、この手法で生成される直線は、人間の目にはより滑らかに映ります。  アンチエイリアシングで直線を生成するために、特定のピクセルと背景がどのようにブレンドされるかを次の図に示します。  
+  
+ ![アンチエイリアシング線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art34.png "AboutGdip02\_Art34")  
+  
+ アンチエイリアシング \(平滑化\) は、曲線にも適用できます。  平滑化された楕円を拡大した表示を次の図に示します。  
+  
+ ![アンチエイリアシング曲線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art35.png "AboutGdip02\_Art35")  
+  
+ 実サイズの同じ楕円にアンチエイリアシングを適用していない例と、アンチエイリアシングを適用した例を次の図に示します。  
+  
+ ![アンチエイリアシング例](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art36.gif "AboutGdip02\_Art36")  
+  
+ アンチエイリアシングを適用した直線および曲線を描画するには、<xref:System.Drawing.Graphics> クラスのインスタンスを作成し、その <xref:System.Drawing.Graphics.SmoothingMode%2A> プロパティを <xref:System.Drawing.Drawing2D.SmoothingMode> または <xref:System.Drawing.Drawing2D.SmoothingMode> に設定します。  次に、同じ <xref:System.Drawing.Graphics> クラスのいずれかの描画メソッドを呼び出します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#81](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#81)]
+ [!code-vb[LinesCurvesAndShapes#81](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#81)]  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.SmoothingMode?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : テキストでのアンチエイリアシングの使用](../../../../docs/framework/winforms/advanced/how-to-use-antialiasing-with-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/application-settings-architecture.md b/docs/framework/winforms/advanced/application-settings-architecture.md
new file mode 100644
index 00000000000..1eaace39f38
--- /dev/null
+++ b/docs/framework/winforms/advanced/application-settings-architecture.md
@@ -0,0 +1,162 @@
+---
+title: "アプリケーション設定アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], アーキテクチャ"
+ms.assetid: c8eb2ad0-fac6-4ea2-9140-675a4a44d562
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# アプリケーション設定アーキテクチャ
+このトピックでは、アプリケーション設定アーキテクチャのしくみについて説明し、グループ設定や設定キーなど、アーキテクチャの高度な機能についても解説します。  
+  
+ アプリケーション設定アーキテクチャにより、アプリケーション スコープまたはユーザー スコープを使用して厳密に型指定された設定の定義や、アプリケーション セッション間における設定の永続化がサポートされます。  また、このアーキテクチャによって、ローカル ファイル システムとの間で設定を保存したり、設定を読み込んだりするために使用する、既定の永続化エンジンが提供されます。  さらに、このアーキテクチャは、カスタムの永続化エンジンを指定するためのインターフェイスも定義します。  
+  
+ カスタム コンポーネントがアプリケーションにホストされる際に、そのコンポーネントの独自の設定を永続化できるようにするインターフェイスが提供されます。  設定キーを使用することにより、コンポーネントでそのコンポーネントの複数のインスタンスの設定を区別できます。  
+  
+## 設定の定義  
+ アプリケーション設定アーキテクチャは、[!INCLUDE[vstecasp](../../../../includes/vstecasp-md.md)] および Windows フォームの内部で使用され、この両方の環境で共有される多くの基本クラスを含みます。  最も重要な基本クラスは <xref:System.Configuration.SettingsBase> であり、コレクションを介した設定へのアクセスと、設定を読み込んだり保存したりするための下位のメソッドを提供します。  各環境は、<xref:System.Configuration.SettingsBase> から派生した独自のクラスを実装し、その環境用の追加の設定機能を提供します。  Windows フォーム ベースのアプリケーションでは、次に示すような機能を基本クラスに追加する <xref:System.Configuration.ApplicationSettingsBase> クラスの派生クラス上で、すべてのアプリケーション設定を定義する必要があります。  
+  
+-   高水準の読み込み操作および保存操作  
+  
+-   ユーザー スコープの設定のサポート  
+  
+-   ユーザー設定から定義済み既定値への復帰  
+  
+-   以前のバージョンのアプリケーションで使用した設定のアップグレード  
+  
+-   設定の変更前または保存前における検証  
+  
+ 設定は、<xref:System.Configuration> 名前空間内で定義されている数多くの属性を使用して表すことができます。これらの属性については、「[アプリケーション設定の属性](../../../../docs/framework/winforms/advanced/application-settings-attributes.md)」を参照してください。  設定を定義する際は、<xref:System.Configuration.ApplicationScopedSettingAttribute> または <xref:System.Configuration.UserScopedSettingAttribute> のいずれかを使用して設定を適用する必要があります。これにより、その設定がアプリケーション全体に適用されるか、または現在のユーザーにだけ適用されるかが指定されます。  
+  
+ 次のコード例では、 `BackgroundColor` という単一の設定を持つカスタム設定クラスを定義します。  
+  
+ [!code-csharp[ApplicationSettings.Create#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Create/CS/MyAppSettings.cs#1)]
+ [!code-vb[ApplicationSettings.Create#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Create/VB/MyAppSettings.vb#1)]  
+  
+## 設定の永続化  
+ <xref:System.Configuration.ApplicationSettingsBase> クラス自体は設定の永続化も読み込みも行いません。この作業は <xref:System.Configuration.SettingsProvider> の派生クラスである設定プロバイダーによって行われます。  <xref:System.Configuration.ApplicationSettingsBase> の派生クラスが <xref:System.Configuration.SettingsProviderAttribute> を使用して設定プロバイダーを指定しない場合は、既定のプロバイダーである <xref:System.Configuration.LocalFileSettingsProvider> が使用されます。  
+  
+ もともと [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] と共にリリースされた構成システムでは、ローカル コンピューターの machine.config ファイルまたはアプリケーションと共に配置する `app.`exe.config ファイルを介した、静的なアプリケーション構成データの提供がサポートされています。  <xref:System.Configuration.LocalFileSettingsProvider> クラスによって、このネイティブ サポートが次のように拡張されます。  
+  
+-   アプリケーション スコープの設定は machine.config ファイルまたは `app.`exe.config ファイルに格納できます。  machine.config は常に読み取り専用です。一方、`app`.exe.config はセキュリティ上の配慮から、大部分のアプリケーションで読み取り専用に制限されています。  
+  
+-   ユーザー スコープの設定は `app`.exe.config ファイルに格納できます。この場合、設定は静的な既定値として扱われます。  
+  
+-   既定値以外のユーザー スコープの設定は、*user*.config という新しいファイルに格納されます。*user* は現在このアプリケーションを実行しているユーザーの名前です。  ユーザー スコープの設定の既定値は、<xref:System.Configuration.DefaultSettingValueAttribute> を使用して指定できます。  ユーザー スコープの設定はアプリケーションの実行時に変更されることがよくあるため、`user`.config は常に読み取り\/書き込み用となります。  
+  
+ この 3 つの構成ファイルはいずれも XML 形式で設定を格納します。  アプリケーション スコープの設定の最上位 XML 要素は、`<appSettings>` で、ユーザー スコープの設定の最上位 XML 要素は `<userSettings>` です。  アプリケーション スコープの設定およびユーザー スコープの設定の既定値を含む `app`.exe.config ファイルは、次のようになります。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<configuration>  
+    <configSections>  
+        <sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >  
+            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
+        </sectionGroup>  
+        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >  
+            <section name="WindowsApplication1.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" />  
+        </sectionGroup>  
+    </configSections>  
+    <applicationSettings>  
+        <WindowsApplication1.Properties.Settings>  
+            <setting name="Cursor" serializeAs="String">  
+                <value>Default</value>  
+            </setting>  
+            <setting name="DoubleBuffering" serializeAs="String">  
+                <value>False</value>  
+            </setting>  
+        </WindowsApplication1.Properties.Settings>  
+    </applicationSettings>  
+    <userSettings>  
+        <WindowsApplication1.Properties.Settings>  
+            <setting name="FormTitle" serializeAs="String">  
+                <value>Form1</value>  
+            </setting>  
+            <setting name="FormSize" serializeAs="String">  
+                <value>595, 536</value>  
+            </setting>  
+        </WindowsApplication1.Properties.Settings>  
+    </userSettings>  
+</configuration>  
+```  
+  
+ 構成ファイルのアプリケーション設定セクションに含まれる要素の定義については、「[アプリケーション設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/application-settings-schema.md)」を参照してください。  
+  
+### 設定のバインディング  
+ アプリケーション設定では、Windows フォーム データのバインディング アーキテクチャを使用し、設定オブジェクトと設定コンポーネントの間で、設定の更新を双方向で通信します。  Visual Studio を使用してアプリケーション設定を作成し、その設定をコンポーネントのプロパティに割り当てる場合、このバインディングは自動的に生成されます。  
+  
+ <xref:System.Windows.Forms.IBindableComponent> インターフェイスをサポートするコンポーネントに対しては、アプリケーション設定のバインド以外は実行できません。  また、コンポーネントでは、特定のバインドされたプロパティに変更イベントを実装するか、<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを使用してプロパティの変更をアプリケーション設定へ通知する必要があります。  コンポーネントで <xref:System.Windows.Forms.IBindableComponent> を実装せずに Visual Studio を使用してバインドした場合、バインドされたプロパティは初回のみ設定されますが、更新されません。  コンポーネントが <xref:System.Windows.Forms.IBindableComponent> を実装してもプロパティの変更通知をサポートしていない場合、プロパティが変更されたときに設定のバインディングは更新されません。  
+  
+ <xref:System.Windows.Forms.ToolStripItem> など、一部の Windows フォーム コンポーネントは、設定のバインディングをサポートしていません。  
+  
+### 設定のシリアル化  
+ <xref:System.Configuration.LocalFileSettingsProvider> がディスクに設定を保存する必要がある場合、次のような処理を実行します。  
+  
+1.  リフレクションを使用して、<xref:System.Configuration.ApplicationSettingsBase> 派生クラスで定義されているすべてのプロパティを調べ、<xref:System.Configuration.ApplicationScopedSettingAttribute> または <xref:System.Configuration.UserScopedSettingAttribute> を使用して適用されたプロパティを見つけます。  
+  
+2.  プロパティをディスクにシリアル化します。  まず、型に関連付けられている <xref:System.ComponentModel.TypeConverter> に <xref:System.ComponentModel.TypeConverter.ConvertToString%2A> または <xref:System.ComponentModel.TypeConverter.ConvertFromString%2A> を呼び出そうとします。  これが成功しない場合、代わりに XML シリアル化を使用します。  
+  
+3.  設定の属性に基づいて、どの設定がどのファイルに指定されているかを判断します。  
+  
+ 独自の設定クラスを実装している場合、<xref:System.Configuration.SettingsSerializeAsAttribute> で <xref:System.Configuration.SettingsSerializeAs> 列挙値を使用して、バイナリのシリアル化またはカスタムのシリアル化の設定にマークを付けることができます。  コードで独自の設定クラスを作成する方法の詳細については、「[方法 : アプリケーション設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)」を参照してください。  
+  
+### 設定ファイルの場所  
+ `app`.exe.config ファイルおよび *user*.config ファイルの場所は、アプリケーションのインストール方法によって異なります。  Windows フォーム ベースのアプリケーションをローカル コンピューターにコピーした場合、`app`.exe.config はアプリケーションのメインの実行可能ファイルのベース ディレクトリと同じディレクトリに配置され、*user*.config は <xref:System.Windows.Forms.Application.LocalUserAppDataPath%2A?displayProperty=fullName> プロパティで指定した場所に配置されます。  アプリケーションを [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] を使用してインストールした場合、どちらのファイルも %InstallRoot%\\Documents and Settings\\*username*\\Local Settings の下にある [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] のデータ ディレクトリに配置されます。  
+  
+ ユーザーがローミング プロファイルを有効にしている場合、これらのファイルの格納場所はわずかに異なります。ローミング プロファイルでは、ユーザーがドメイン内の別のコンピューターを使用する際に Windows とアプリケーションに対して異なる設定を定義できます。  この場合、[!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] アプリケーションも [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] 以外のアプリケーションも、`app`.exe.config ファイルおよび *user*.config ファイルが %InstallRoot%\\Documents and Settings\\*username*\\Application Data に格納されます。  
+  
+ アプリケーション設定機能と新しい配置テクノロジの連携の詳細については、「[ClickOnce とアプリケーション設定](../Topic/ClickOnce%20and%20Application%20Settings.md)」を参照してください。  [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] のデータ ディレクトリの詳細については、「[ClickOnce アプリケーションにおけるローカル データおよびリモート データへのアクセス](../Topic/Accessing%20Local%20and%20Remote%20Data%20in%20ClickOnce%20Applications.md)」を参照してください。  
+  
+## アプリケーション設定とセキュリティ  
+ アプリケーション設定は部分信頼で機能するように設計されています。部分信頼とは、インターネット上やイントラネット上でホストされる Windows フォーム アプリケーションにとって既定となる制限された環境のことです。  既定の設定プロバイダーと共にアプリケーション設定を使用する場合、部分信頼以外に特別なアクセス許可は必要ありません。  
+  
+ [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] アプリケーション内でアプリケーション設定を使用する場合、`user`.config ファイルは [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] のデータ ディレクトリに格納されます。  アプリケーションの `user`.config ファイルのサイズを、[!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] で設定したデータ ディレクトリ クォータより大きくすることはできません。  詳細については、「[ClickOnce とアプリケーション設定](../Topic/ClickOnce%20and%20Application%20Settings.md)」を参照してください。  
+  
+## カスタム設定プロバイダー  
+ アプリケーション設定アーキテクチャでは、<xref:System.Configuration.ApplicationSettingsBase> から派生したアプリケーション設定ラッパー クラスと、<xref:System.Configuration.SettingsProvider> から派生した、1 つまたは複数の関連するプロバイダーとの間には緩い結合があります。  この結合は、ラッパー クラスまたはその個々のプロパティに適用されている <xref:System.Configuration.SettingsProviderAttribute> によってのみ定義されます。  設定プロバイダーを明示的に指定しないと、既定のプロバイダーである <xref:System.Configuration.LocalFileSettingsProvider> が使用されます。  したがって、このアーキテクチャではカスタム設定プロバイダーの作成と使用がサポートされていることになります。  
+  
+ たとえば、すべての設定データを Microsoft SQL Server データベースに格納するプロバイダーである `SqlSettingsProvider` を使用するとします。  <xref:System.Configuration.SettingsProvider> 派生クラスは、この情報を <xref:System.Collections.Specialized.NameValueCollection?displayProperty=fullName> 型のパラメーターとして  `Initialize`  メソッドで受け取ります。  次に、<xref:System.Configuration.SettingsProvider.GetPropertyValues%2A> メソッドを実装して、設定値をデータ ストアから取得し、<xref:System.Configuration.SettingsProvider.SetPropertyValues%2A> を使用して保存します。  このプロバイダーは、<xref:System.Configuration.SettingsProvider.GetPropertyValues%2A> に指定される <xref:System.Configuration.SettingsPropertyCollection> を使用して、プロパティの名前、型、スコープや、このプロパティに対して定義されたその他の設定属性を判断します。  
+  
+ このプロバイダーでは、1 つのプロパティと 1 つのメソッドを実装する必要がありますが、この実装はわかりにくいことがあります。  <xref:System.Configuration.SettingsProvider.ApplicationName%2A> プロパティは、<xref:System.Configuration.SettingsProvider> の抽象プロパティです。次のような値を返すようにプログラムする必要があります。  
+  
+ [!code-csharp[ApplicationSettings.Architecture#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Architecture/CS/DummyClass.cs#2)]
+ [!code-vb[ApplicationSettings.Architecture#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Architecture/VB/DummyProviderClass.vb#2)]  
+  
+ また、派生クラスは、引数を受け取らず値を返さない `Initialize` メソッドも実装する必要があります。  このメソッドは <xref:System.Configuration.SettingsProvider> によって定義されません。  
+  
+ 最後にプロバイダーに <xref:System.Configuration.IApplicationSettingsProvider> を実装して、設定の更新、設定値から既定値への復帰、およびアプリケーションのあるバージョンから別のバージョンへの設定のアップグレードをサポートします。  
+  
+ カスタム プロバイダーの実装とコンパイルを行った後、設定クラスに対して、既定のプロバイダーではなくこのプロバイダーを使用するように指示する必要があります。  これには、<xref:System.Configuration.SettingsProviderAttribute> を使用します。  設定クラス全体にこのプロバイダーを適用した場合、このプロバイダーはこのクラスが定義する各設定に対して使用されます。個々の設定に適用した場合、アプリケーション設定アーキテクチャは、該当する設定に対してのみこのプロバイダーを使用し、それ以外の設定については <xref:System.Configuration.LocalFileSettingsProvider> を使用します。  次のコード例では、設定クラスに対してカスタム プロバイダーを使用するように指示する方法を示します。  
+  
+ [!code-csharp[ApplicationSettings.Architecture#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Architecture/CS/DummyClass.cs#1)]
+ [!code-vb[ApplicationSettings.Architecture#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Architecture/VB/DummyProviderClass.vb#1)]  
+  
+ 複数のスレッドから同時にプロバイダーを呼び出すことができますが、プロバイダーは常に同じストレージの場所に書き込みを行います。したがって、アプリケーション設定アーキテクチャによってインスタンス化されるカスタム プロバイダー クラスは 1 つだけです。  
+  
+> [!IMPORTANT]
+>  カスタム プロバイダーがスレッド セーフであり、構成ファイルへの書き込みを実行できるのは一度に 1 つのスレッドだけであることを確認しておく必要があります。  
+  
+ カスタム プロバイダーは <xref:System.Configuration?displayProperty=fullName> 名前空間で定義されているすべての設定属性をサポートする必要はありませんが、少なくとも <xref:System.Configuration.ApplicationScopedSettingAttribute>、<xref:System.Configuration.UserScopedSettingAttribute>、および <xref:System.Configuration.DefaultSettingValueAttribute> をサポートしている必要があります。  サポートしていない属性については、カスタム プロバイダーは警告なしに失敗し、例外をスローしません。  ただし、設定クラスが無効な属性の組み合わせを使用した場合 \(同じ設定に <xref:System.Configuration.ApplicationScopedSettingAttribute> と <xref:System.Configuration.UserScopedSettingAttribute> を適用するなど\)、カスタム プロバイダーは例外をスローし、操作が中断されます。  
+  
+## 参照  
+ <xref:System.Configuration.ApplicationSettingsBase>   
+ <xref:System.Configuration.SettingsProvider>   
+ <xref:System.Configuration.LocalFileSettingsProvider>   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [カスタム コントロールのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-custom-controls.md)   
+ [ClickOnce とアプリケーション設定](../Topic/ClickOnce%20and%20Application%20Settings.md)   
+ [アプリケーション設定のスキーマ](../../../../docs/framework/configure-apps/file-schema/application-settings-schema.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/application-settings-attributes.md b/docs/framework/winforms/advanced/application-settings-attributes.md
new file mode 100644
index 00000000000..ec84c2f1d0f
--- /dev/null
+++ b/docs/framework/winforms/advanced/application-settings-attributes.md
@@ -0,0 +1,53 @@
+---
+title: "アプリケーション設定の属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], 属性"
+  - "属性 [Windows フォーム], アプリケーション設定"
+  - "ラッパー クラス, アプリケーション設定"
+ms.assetid: 53caa66c-a9fb-43a5-953c-ad092590098d
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# アプリケーション設定の属性
+アプリケーション設定アーキテクチャには、アプリケーション設定ラッパー クラスまたはその個々のプロパティに適用できるさまざまな属性が用意されています。  これらの属性は、カスタム ラッパーの指定要件に合わせて機能を調節できるように、アプリケーション設定インフラストラクチャ \(多くの場合、具体的には設定プロバイダー\) によって実行時にチェックされます。  
+  
+ アプリケーション設定ラッパー クラス、このクラスの個々のプロパティ、またはその両方に適用できる属性を次の表に示します。  定義上、各設定プロパティに 1 つのスコープ属性 \(**UserScopedSettingAttribute** または **ApplicationScopedSettingAttribute**\) だけを適用する必要があります。  
+  
+> [!NOTE]
+>  <xref:System.Configuration.SettingsProvider> クラスから派生するカスタム設定プロバイダーは、**ApplicationScopedSettingAttribute**、**UserScopedSettingAttribute**、**DefaultSettingValueAttribute** の 3 つの属性だけを認識する必要があります。  
+  
+|属性|Target|Description|  
+|--------|------------|-----------------|  
+|<xref:System.Configuration.SettingsProviderAttribute>|Both|永続化に使用される設定プロバイダーの短い名前を指定します。<br /><br /> この属性を指定しないときは、既定のプロバイダー <xref:System.Configuration.LocalFileSettingsProvider> を指定したものと見なされます。|  
+|<xref:System.Configuration.UserScopedSettingAttribute>|Both|ユーザー スコープのアプリケーション設定としてプロパティを定義します。|  
+|<xref:System.Configuration.ApplicationScopedSettingAttribute>|Both|アプリケーション スコープのアプリケーション設定としてプロパティを定義します。|  
+|<xref:System.Configuration.DefaultSettingValueAttribute>|プロパティ|プロバイダーによって、このプロパティのハードコーディングされた既定値に逆シリアル化できる文字列を指定します。<br /><br /> <xref:System.Configuration.LocalFileSettingsProvider> はこの属性を必要としません。既に永続化されている値がある場合は、この属性で指定された値をオーバーライドします。|  
+|<xref:System.Configuration.SettingsDescriptionAttribute>|プロパティ|主に実行時ツールとデザイン時ツールによって使用される、個々の設定の記述テストを指定します。|  
+|<xref:System.Configuration.SettingsGroupNameAttribute>|Class|設定グループの名前を明示的に指定します。  この属性を指定しない場合、<xref:System.Configuration.ApplicationSettingsBase> はラッパー クラス名を使用します。|  
+|<xref:System.Configuration.SettingsGroupDescriptionAttribute>|Class|主に実行時ツールとデザイン時ツールによって使用される、設定グループの記述テストを指定します。|  
+|<xref:System.Configuration.SettingsManageabilityAttribute>|Both|設定グループまたはプロパティに提供する必要がある 0 個以上の管理機能サービスを指定します。  使用できるサービスは、<xref:System.Configuration.SettingsManageability> 列挙型によって記述されます。|  
+|<xref:System.Configuration.SpecialSettingAttribute>|プロパティ|設定プロバイダーによる特別な処理を意味する特別な定義済みカテゴリ \(接続文字列など\) に設定が属することを示します。  この属性の定義済みカテゴリは、<xref:System.Configuration.SpecialSetting> 列挙型によって定義されます。|  
+|<xref:System.Configuration.SettingsSerializeAsAttribute>|Both|設定グループまたはプロパティに推奨されるシリアル化機構を指定します。  使用できるシリアル化機構は、<xref:System.Configuration.SettingsSerializeAs> 列挙型によって定義されます。|  
+|<xref:System.Configuration.NoSettingsVersionUpgradeAttribute>|プロパティ|マークしたプロパティのアプリケーション アップグレード機能を設定プロバイダーがすべて無効にすることを指定します。|  
+  
+ *クラス*は、その属性をアプリケーション設定ラッパー クラスだけに適用できることを示します。  *プロパティ*は、その属性を設定プロパティだけに適用できることを示します。  *両方*は、その属性をどちらのレベルでも適用できることを示します。  
+  
+## 参照  
+ <xref:System.Configuration.ApplicationSettingsBase>   
+ <xref:System.Configuration.SettingsProvider>   
+ [アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)   
+ [How to: Create Application Settings](http://msdn.microsoft.com/ja-jp/53b3af80-1c02-4e35-99c6-787663148945)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/application-settings-for-custom-controls.md b/docs/framework/winforms/advanced/application-settings-for-custom-controls.md
new file mode 100644
index 00000000000..8aa805b26a3
--- /dev/null
+++ b/docs/framework/winforms/advanced/application-settings-for-custom-controls.md
@@ -0,0 +1,60 @@
+---
+title: "カスタム コントロールのアプリケーション設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], カスタム コントロール"
+  - "カスタム コントロール [Windows フォーム], アプリケーション設定"
+ms.assetid: f44afb74-76cc-44f2-890a-44b7cdc211a1
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# カスタム コントロールのアプリケーション設定
+コントロールがサードパーティのアプリケーションでホストされている場合、アプリケーション設定を永続化するための機能をカスタム コントロールに持たせるには特定のタスクを完了する必要があります。  
+  
+ アプリケーション設定機能に関するほとんどのドキュメントは、スタンドアロン アプリケーションを作成していることを前提にしています。  ただし、他の開発者が作成したアプリケーション内でホストされるコントロールを作成する場合には、コントロールが設定を適切に永続化できるように、追加の手順を実行する必要があります。  
+  
+## アプリケーション設定とカスタム コントロール  
+ コントロールで設定を適切に永続化できるようにするためには、<xref:System.Configuration.ApplicationSettingsBase> から派生した独自の専用アプリケーション設定ラッパー クラスを作成することによってプロセスをカプセル化する必要があります。  また、メイン コントロール クラスで <xref:System.Configuration.IPersistComponentSettings> を実装する必要があります。  このインターフェイスには、複数のプロパティと 2 つのメソッド \(<xref:System.Configuration.IPersistComponentSettings.LoadComponentSettings%2A> および <xref:System.Configuration.IPersistComponentSettings.SaveComponentSettings%2A>\) が含まれます。  Visual Studio の **Windows フォーム デザイナー**を使用してコントロールをフォームに追加する場合、コントロールの初期化時に、Windows フォームは自動的に <xref:System.Configuration.IPersistComponentSettings.LoadComponentSettings%2A> を呼び出します。<xref:System.Configuration.IPersistComponentSettings.SaveComponentSettings%2A> は、コントロールの  `Dispose`  メソッド内で独自に呼び出す必要があります。  
+  
+ また、カスタム コントロールのアプリケーション設定が Visual Studio などデザイン時の環境で正しく動作するように、次を実装する必要があります。  
+  
+1.  <xref:System.ComponentModel.IComponent> を 1 つのパラメーターとして使用するコンストラクターを含む、カスタム アプリケーション設定クラス。  このクラスを使用して、すべてのアプリケーション設定を読み込みます。  このクラスの新しいインスタンスを作成するときに、コンストラクターを使用してカスタム コントロールを渡します。  
+  
+2.  コントロールを作成し、フォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラーなどに配置した後に、カスタム設定クラスを作成します。  
+  
+ カスタム設定クラスを作成する手順については、「[方法 : アプリケーション設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)」を参照してください。  
+  
+## 設定キーと共有設定  
+ コントロールの中には、同じフォーム内で何度も使用できるものがあります。  ほとんどの場合、このようなコントロールが個々の設定を独自に永続化するように設定すると便利です。  <xref:System.Configuration.IPersistComponentSettings> の <xref:System.Configuration.IPersistComponentSettings.SettingsKey%2A> プロパティを使用すると、フォーム上のコントロールの複数のバージョンを区別する一意の文字列を指定できます。  
+  
+ <xref:System.Configuration.IPersistComponentSettings.SettingsKey%2A> を実装する最も簡単な方法は、コントロールの <xref:System.Windows.Forms.Control.Name%2A> プロパティを <xref:System.Configuration.IPersistComponentSettings.SettingsKey%2A> に使用することです。  コントロールの設定を読み込むときまたは保存するときに、<xref:System.Configuration.IPersistComponentSettings.SettingsKey%2A> の値を <xref:System.Configuration.ApplicationSettingsBase> クラスの <xref:System.Configuration.ApplicationSettingsBase.SettingsKey%2A> プロパティに渡します。  アプリケーション設定は、ユーザーの設定を XML ファイルに永続化するときにこの一意キーを使用します。   `Text`  プロパティの設定を保存する  `CustomControl1`  という名前のカスタム コントロールのインスタンスを  `<userSettings>`  セクションが検索するしくみを次のコード例に示します。  
+  
+```  
+<userSettings>  
+    <CustomControl1>  
+        <setting name="Text" serializedAs="string">  
+            <value>Hello, World</value>  
+        </setting>  
+    </CustomControl1>  
+</userSettings>  
+```  
+  
+ <xref:System.Configuration.ApplicationSettingsBase.SettingsKey%2A> の値を指定しないコントロールのすべてのインスタンスは、同じ設定を共有します。  
+  
+## 参照  
+ <xref:System.Configuration.ApplicationSettingsBase>   
+ <xref:System.Configuration.IPersistComponentSettings>   
+ [アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/application-settings-for-windows-forms.md b/docs/framework/winforms/advanced/application-settings-for-windows-forms.md
new file mode 100644
index 00000000000..8c9c4d8a3b8
--- /dev/null
+++ b/docs/framework/winforms/advanced/application-settings-for-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "Windows フォームのアプリケーション設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ClientApplicationSettings"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム]"
+  - "Windows フォーム, アプリケーション設定"
+ms.assetid: 64090a34-8556-4904-8ea0-20efe9f8c886
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Windows フォームのアプリケーション設定
+Windows フォームのアプリケーション設定の機能により、カスタム アプリケーションと、クライアント上のユーザー設定の作成、保存、および保守が簡単になります。  アプリケーション設定では、データベースの接続文字列など、アプリケーションのデータだけでなく、ツールバーの位置や最近使用した一覧など、ユーザー固有のデータも格納することができます。  
+  
+## このセクションの内容  
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)  
+ アプリケーションとユーザーのために設定のデータを作成して格納する方法について説明します。  
+  
+ [アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)  
+ アプリケーション設定機能のしくみについて説明し、グループ化された設定や設定キーなど、アーキテクチャの高度な機能について説明します。  
+  
+ [アプリケーション設定の属性](../../../../docs/framework/winforms/advanced/application-settings-attributes.md)  
+ アプリケーションの設定のラッパー クラスまたはその設定のプロパティに適用できる属性を一覧で説明しています。  
+  
+ [カスタム コントロールのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-custom-controls.md)  
+ サード パーティ製のアプリケーションでホストされている場合、アプリケーション設定を保存する機能をカスタム コントロールに追加するためにしなければならないことについて説明します。  
+  
+ [方法 : アプリケーション設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)  
+ アプリケーション セッション間で永続化される新しいアプリケーション設定を作成する方法を示します。  
+  
+ [方法 : アプリケーション設定を検証する](../../../../docs/framework/winforms/advanced/how-to-validate-application-settings.md)  
+ 永続化する前に、アプリケーション設定を検証する方法について説明します。  
+  
+ 参照:  
+  
+-   [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/application-settings-overview.md b/docs/framework/winforms/advanced/application-settings-overview.md
new file mode 100644
index 00000000000..4719ab17357
--- /dev/null
+++ b/docs/framework/winforms/advanced/application-settings-overview.md
@@ -0,0 +1,69 @@
+---
+title: "アプリケーション設定の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ApplicationsSettingsOverview"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム]、アプリケーション設定について"
+  - "動的プロパティ"
+  - "ユーザー設定、追跡"
+ms.assetid: 0dd8bca5-a6bf-4ac4-8eec-5725d08b38dc
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# アプリケーション設定の概要
+このトピックでは、アプリケーションとユーザーのために設定のデータを作成して格納する方法について説明します。  
+  
+ Windows フォームのアプリケーション設定の機能により、カスタム アプリケーションと、クライアント コンピューター上のユーザー設定の作成、保存、および保守が簡単になります。 Windows フォーム アプリケーションの設定ではデータベースの接続文字列など、アプリケーションのデータだけでなく、ユーザー アプリケーションの設定などのユーザー固有のデータを格納することができます。 Visual Studio またはカスタムのマネージ コードを使用して、新しい設定の作成、ディスクからの読み取りまたは書き込み、フォームのプロパティへのバインド、および読み込みと保存の前の設定データの検証を実行することができます。  
+  
+ アプリケーション設定は、開発者がカスタム コードをほとんど使用しないでアプリケーションの状態を保存でき、以前のバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の動的プロパティに代わるものです。 アプリケーション設定には、読み取り専用で、遅延バインディングであり、複数のカスタム プログラミングを必要とする動的プロパティに対する多くの機能強化が含まれます。 動的プロパティ クラスは [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] で保持されていますが、アプリケーション設定クラスを少しラップするシェル クラスです。  
+  
+## アプリケーション設定とは何でしょうか?  
+ Windows フォーム アプリケーションでは、アプリケーションの実行のために欠かせない特定のデータが必要とされるものの、そのデータをアプリケーションのコードに直接含めるのは望ましくないということがよくあります。 アプリケーションが Web サービスまたはデータベース サーバーを使用する場合、この情報を別のファイルに保存することで、将来再コンパイルせずに変更することができます。 同様に、アプリケーションは、現在のユーザーに固有の格納データを必要とすることがあります。 たとえば、ほとんどのアプリケーションでは、アプリケーションの外観と動作をカスタマイズするユーザー設定があります。  
+  
+ アプリケーション設定は、クライアント コンピューターにアプリケーション スコープとユーザー スコープの両方の設定を保存する簡単な方法を提供することにより、両方のニーズに対応します。 Visual Studio またはコード エディターを使用して、名前、データ型、およびスコープ \(アプリケーションまたはユーザー\) を指定して特定のプロパティの設定を定義します。 使いやすさと読みやすさのために、関連する設定を名前付きのグループに配置することもできます。 これらの設定は、定義された後も保持され、実行時に自動的にメモリに読み込まれます。 プラグ可能なアーキテクチャにより永続化メカニズムを変更できますが、既定では、ローカル ファイル システムが使用されます。  
+  
+ アプリケーションの設定は、設定がアプリケーション スコープかユーザー スコープかに応じて、別の構成 \(.config\) ファイルに XML としてデータを保持することで機能します。 ほとんどの場合は、アプリケーション スコープ設定は読み取り専用です。これは、アプリケーション スコープ設定がプログラム情報であり、通常は上書きする必要がないためです。 これに対し、ユーザー スコープ設定は、アプリケーションが部分信頼で実行されている場合でも、実行時に安全に読み書きできます。 部分信頼の詳細については、「[Windows フォームのセキュリティの概要](../../../../docs/framework/winforms/security-in-windows-forms-overview.md)」を参照してください。  
+  
+ 設定は、構成ファイルの XML フラグメントとして格納されます。 アプリケーション スコープ設定は `<application.Settings>` 要素によって表され、通常は *app*.exe.config に配置されます。ここで、*app* はメインの実行可能ファイルの名前です。 ユーザー スコープ設定は、`<userSettings>` 要素によって表され、*user*.config に配置されます。ここで、*user* は、現在アプリケーションを実行しているユーザーのユーザー名です。*app*.exe.config ファイルはアプリケーションと共に展開する必要があります。*user*.config ファイルは、アプリケーションがそのユーザーの設定を初めて保存するときに、必要に応じて設定アーキテクチャが作成します。 また、*app*.exe.config 内で `<userSettings>` ブロックを定義して、ユーザー スコープ設定の既定値を指定することもできます。  
+  
+ カスタム コントロールでは、<xref:System.Configuration.IPersistComponentSettings.SaveSettings%2A> メソッドを公開する<xref:System.Configuration.IPersistComponentSettings> インターフェイスを実装することで、独自の設定を保存できます。 Windows フォーム <xref:System.Windows.Forms.ToolStrip> コントロールは、このインターフェイスを実装して、アプリケーション セッション間でのツールバーとツールバー項目の位置を保存します。 カスタム コントロールとアプリケーション設定の詳細については、「[カスタム コントロールのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-custom-controls.md)」を参照してください。  
+  
+## アプリケーションの設定の制限事項  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] をホストするアンマネージ アプリケーションで、アプリケーション設定を使用することはできません。 Visual Studio アドイン、C\+\+ for Microsoft Office、Internet Explorer のコントロール ホスト、Microsoft Outlook のアドインやプロジェクトなどの環境では、設定は機能しません。  
+  
+ 現在、Windows フォームの一部のプロパティをバインドできません。 最も注目に値する例は、<xref:System.Windows.Forms.Form.ClientSize%2A> プロパティで、このプロパティへのバインドにより、実行時に予期しない動作が発生します。 これらの設定をプログラムで保存して読み込むことで、通常はこれらの問題を回避できます。  
+  
+ アプリケーション設定には、情報を自動的に暗号化するための組み込みの機能がありません。 データベースのパスワードなどのセキュリティ関連の情報は、クリア テキストで保存しないでください。 このような機密情報を格納する場合、アプリケーション開発者に、機密情報の安全性を確保する責任があります。 接続文字列を格納する場合は、URL にパスワードをハード コーディングするのではなく、Windows 統合セキュリティを使用することをお勧めします。 詳細については、「[コード アクセス セキュリティと ADO.NET](../../../../docs/framework/data/adonet/code-access-security.md)」を参照してください。  
+  
+## アプリケーション設定の概要  
+ Visual Studio を使用している場合に、Windows フォーム デザイナーの **\[プロパティ\]** ウィンドウの **\(ApplicationSettings\)** プロパティを使用して設定を定義することができます。 この方法で設定を定義する場合、Visual Studio は各設定をクラス プロパティに関連付けるカスタムのマネージ ラッパー クラスを自動的に作成します。 また、Visual Studio は、フォームが表示されるとコントロールの設定が自動的に復元され、フォームが閉じられると自動的に保存されるように、フォームまたはコントロールのプロパティへの設定のバインドも処理します。  
+  
+ 設定のより詳細なコントロールが必要な場合は、独自のカスタムのアプリケーション設定のラッパー クラスを定義することができます。 これは、<xref:System.Configuration.ApplicationSettingsBase> からクラスを派生させ、各設定に対応するプロパティを追加して、これらのプロパティに特別な属性を適用することで実現します。 ラッパー クラスを作成する方法については、「[アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)」を参照してください。  
+  
+ また、<xref:System.Windows.Forms.Binding> クラスを使用して、フォームとコントロールのプロパティに設定をプログラムでバインドすることもできます。  
+  
+## 参照  
+ <xref:System.Configuration.ApplicationSettingsBase>   
+ <xref:System.Configuration.SettingsProvider>   
+ <xref:System.Configuration.LocalFileSettingsProvider>   
+ <xref:System.Configuration.IPersistComponentSettings>   
+ [方法 : アプリケーション設定を検証する](../../../../docs/framework/winforms/advanced/how-to-validate-application-settings.md)   
+ [アプリケーションの設定の管理 \(.NET\)](../Topic/Managing%20Application%20Settings%20\(.NET\).md)   
+ [方法 : 実行時に設定を C\# で読み取る](../../../../docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md)   
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [アプリケーション設定アーキテクチャ](../../../../docs/framework/winforms/advanced/application-settings-architecture.md)   
+ [カスタム コントロールのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/bezier-splines-in-gdi.md b/docs/framework/winforms/advanced/bezier-splines-in-gdi.md
new file mode 100644
index 00000000000..14fdf42cbd4
--- /dev/null
+++ b/docs/framework/winforms/advanced/bezier-splines-in-gdi.md
@@ -0,0 +1,52 @@
+---
+title: "GDI+ でのベジエ スプライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ベジエ スプライン"
+  - "GDI+, ベジエ スプライン"
+  - "スプライン, ベジエ"
+ms.assetid: 5774ce1e-87d4-4bc7-88c4-4862052781b8
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# GDI+ でのベジエ スプライン
+ベジエ スプラインは、4 つの点、つまり 2 つのエンドポイント \(p1 と p2\) と 2 つの制御点 \(c1 と c2\) によって指定される曲線です。  曲線は p1 で開始され、p2 で終了します。  この曲線は制御点を通過しません。しかし、制御点は磁石のような役割を果たし、曲線を特定の方向に引っ張って曲線の曲がり方を制御します。  ベジエ曲線およびそのエンドポイントと制御点を次の図に示します。  
+  
+ ![ベジエ スプライン](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art11a.png "Aboutgdip02\_art11a")  
+  
+ 曲線は p1 で開始され、制御点 c1 に向かって移動します。  p1 における曲線の接線は、p1 と c1 を結ぶ直線です。  エンドポイント p2 における接線は、c2 と p2 を結ぶ直線です。  
+  
+## ベジエ スプラインの描画  
+ ベジエ スプラインを描画するには、<xref:System.Drawing.Graphics> クラスのインスタンスと <xref:System.Drawing.Pen> が必要です。  <xref:System.Drawing.Graphics> クラスのインスタンスは <xref:System.Drawing.Graphics.DrawBezier%2A> メソッドを提供し、<xref:System.Drawing.Pen> は曲線を描画するために使用される線の幅や色などの属性を格納します。  <xref:System.Drawing.Pen> は、引数の 1 つとして <xref:System.Drawing.Graphics.DrawBezier%2A> メソッドに渡されます。  <xref:System.Drawing.Graphics.DrawBezier%2A> メソッドに渡される他の引数は、エンドポイントと制御点です。  開始点 \(0, 0\)、制御点 \(40, 20\) および \(80, 150\)、終了点 \(100, 10\) のベジエ スプラインを描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#71](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#71)]
+ [!code-vb[LinesCurvesAndShapes#71](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#71)]  
+  
+ 曲線、制御点、および 2 つの接線を次の図に示します。  
+  
+ ![ベジエ スプライン](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art12.png "Aboutgdip02\_art12")  
+  
+ ベジエ スプラインは、自動車業界向けのデザイン用に Pierre Bézier 氏によって開発されました。  それ以降、ベジエ スプラインはコンピューター支援設計のさまざまな用途で利用できることが実証され、フォントのアウトラインの定義にも使用されています。  ベジエ スプラインで作成できるさまざまな図形のいくつかを次の図に示します。  
+  
+ ![パス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art13.png "Aboutgdip02\_art13")  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [曲線の作成と描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-curves.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/bi-directional-support-for-windows-forms-applications.md b/docs/framework/winforms/advanced/bi-directional-support-for-windows-forms-applications.md
new file mode 100644
index 00000000000..cfe88eea558
--- /dev/null
+++ b/docs/framework/winforms/advanced/bi-directional-support-for-windows-forms-applications.md
@@ -0,0 +1,130 @@
+---
+title: "Windows フォーム アプリケーションの双方向サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "双方向言語サポート, Windows アプリケーション"
+  - "グローバリゼーション [Windows フォーム], 双方向サポート (Windows の)"
+  - "ローカリゼーション [Windows フォーム], 双方向サポート (Windows の)"
+  - "Windows フォーム, 双方向サポート"
+  - "Windows フォーム, 国際対応"
+ms.assetid: 7b622fa4-f390-4e4d-b624-83a1917cccf2
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Windows フォーム アプリケーションの双方向サポート
+[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を使用して、アラビア語やヘブライ語などの双方向 \(右から左\) の言語をサポートする Windows ベースのアプリケーションを作成できます。  これには、標準的なフォーム、ダイアログ ボックス、MDI フォームや、これらのフォームで操作できるすべてのコントロール、まり、<xref:System.Windows.Forms.Control> 名前空間のすべてのオブジェクトが含まれます。  
+  
+## カルチャのサポート  
+ カルチャと UI カルチャの設定は、アプリケーションが日付、時刻、通貨、およびその他の情報をどのように操作するかを決定します。  双方向言語のカルチャおよび UI カルチャのサポートは、その他の言語と同じです。  「[グローバルな Windows フォームおよび Web フォームにおけるカルチャ固有のクラス](http://msdn.microsoft.com/library/94ye9x8c\(v=vs.110\))」または「[グローバルな Windows フォームおよび Web フォームにおけるカルチャ固有のクラス](http://msdn.microsoft.com/library/94ye9x8c\(v=vs.120\))」も参照してください。  
+  
+## RightToLeft プロパティと RightToLeftLayout プロパティ  
+ フォームの派生元となる基底 <xref:System.Windows.Forms.Control> クラスには、フォームとコントロールの読み取り順序を変更するよう設定できる <xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティが含まれます。  フォームの <xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティを設定する場合、既定ではフォームのコントロールがこの設定を継承します。  ただし、ほとんどのコントロールで <xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティを個別に設定することもできます。  「[方法 : グローバリゼーション用に Windows フォームで右から左の方向でテキストを表示する](http://msdn.microsoft.com/library/7d3337xw\(v=vs.110\))」も参照してください。  
+  
+ <xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティの影響は、コントロールごとに異なります。  一部のコントロールで、<xref:System.Windows.Forms.Button>、<xref:System.Windows.Forms.TreeView>、および <xref:System.Windows.Forms.ToolTip> の各コントロールの場合のように、プロパティでは読み取り順序のみを設定します。  その他のコントロールでは、<xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティが読み取り順序とレイアウトの両方を変更します。  これには、<xref:System.Windows.Forms.RadioButton>、<xref:System.Windows.Forms.ComboBox>、および <xref:System.Windows.Forms.CheckBox> の各コントロールが含まれます。  その他のコントロールには、右から左のレイアウトのミラーに適用される <xref:System.Windows.Forms.Form.RightToLeftLayout%2A> プロパティが必要です。  次の表は、<xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティと <xref:System.Windows.Forms.Form.RightToLeftLayout%2A> プロパティが個々 の Windows フォーム コントロールに影響する方法の詳細を示します。  
+  
+|コントロールとコンポーネント|RightToLeft プロパティの効果|RightToLeftLayout プロパティの効果|ミラー化が必要か|  
+|--------------------|--------------------------|--------------------------------|--------------|  
+|<xref:System.Windows.Forms.Button>|RTL の読み取り順序を設定します。  <xref:System.Windows.Forms.ButtonBase.TextAlign%2A>、<xref:System.Windows.Forms.ButtonBase.ImageAlign%2A>、および <xref:System.Windows.Forms.ButtonBase.TextImageRelation%2A> を反転する|効果なし|いいえ|  
+|<xref:System.Windows.Forms.CheckBox>|テキストの右側にチェック ボックスが表示されます。|効果なし|いいえ|  
+|<xref:System.Windows.Forms.CheckedListBox>|テキストの右側にすべてのチェック ボックスが表示されます。|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ColorDialog>|影響を受けません。オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ComboBox>|コンボ ボックス コントロール内のアイテムが右揃え|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ContextMenu>|RTL の読み取り順序で右揃えで表示|効果なし|いいえ|  
+|<xref:System.Windows.Forms.DataGrid>|RTL の読み取り順序で右揃えで表示|効果なし|いいえ|  
+|<xref:System.Windows.Forms.DataGridView>|RTL の読み取り順序とコントロールのレイアウトの両方に影響を与える|効果なし|いいえ|  
+|<xref:System.Windows.Forms.DateTimePicker>|影響を受けません。オペレーティング システムの言語によって異なります|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.DomainUpDown>|上矢印と下矢印ボタンを左揃え|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ErrorProvider>|サポートなし|効果なし|いいえ|  
+|<xref:System.Windows.Forms.FontDialog>|オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Windows.Forms.Form>|RTL の読み取り順序を設定し、スクロール バーを反転させる|フォームをミラー化する|はい|  
+|<xref:System.Windows.Forms.GroupBox>|キャプションが右揃えで表示されます。  子コントロールは、このプロパティを継承できます。|コントロール内で <xref:System.Windows.Forms.TableLayoutPanel> を使用して、右から左へのミラーリングをサポートする|いいえ|  
+|<xref:System.Windows.Forms.HScrollBar>|右揃えのスクロール ボックス \(つまみ\) で始まる|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ImageList>|不要|効果なし|いいえ|  
+|<xref:System.Windows.Forms.Label>|右揃えに表示されます。  <xref:System.Windows.Forms.Label.TextAlign%2A> および <xref:System.Windows.Forms.Label.ImageAlign%2A> を反転する|効果なし|いいえ|  
+|<xref:System.Windows.Forms.LinkLabel>|右揃えに表示されます。  <xref:System.Windows.Forms.Label.TextAlign%2A> および <xref:System.Windows.Forms.Label.ImageAlign%2A> を反転する|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ListBox>|アイテムが右揃え|効果なし|いいえ|  
+|<xref:System.Windows.Forms.ListView>|読み取り順序を RTL に設定し、要素は左揃えを維持する|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.MainMenu>|\(デザイン時ではなく\) 実行時に RTL の読み取り順序で右揃えの表示|効果なし|いいえ|  
+|<xref:System.Windows.Forms.MaskedTextBox>|テキストが右から左へ表示されます。|効果なし|いいえ|  
+|<xref:System.Windows.Forms.MonthCalendar>|影響を受けません。オペレーティング システムの言語によって異なります|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.NotifyIcon>|サポートなし|サポートなし|いいえ|  
+|<xref:System.Windows.Forms.NumericUpDown>|上矢印と下矢印ボタンを左揃え|効果なし|いいえ|  
+|<xref:System.Windows.Forms.OpenFileDialog>|影響を受けません。オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Windows.Forms.PageSetupDialog>|影響を受けません。オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Windows.Forms.Panel>|子コントロールは、このプロパティを継承できます。|コントロール内で <xref:System.Windows.Forms.TableLayoutPanel> を使用して、右から左をサポートする|はい|  
+|<xref:System.Windows.Forms.PictureBox>|サポートなし|効果なし|いいえ|  
+|<xref:System.Windows.Forms.PrintDialog>|影響を受けません。オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Drawing.Printing.PrintDocument>|垂直スクロール バーが左揃えになり、水平スクロール バーが左から開始|効果なし|いいえ|  
+|<xref:System.Windows.Forms.PrintPreviewDialog>|サポートなし|サポートなし|いいえ|  
+|<xref:System.Windows.Forms.ProgressBar>|このプロパティによる影響はなし|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.RadioButton>|テキストの右側にラジオ ボタンが表示|効果なし|いいえ|  
+|<xref:System.Windows.Forms.RichTextBox>|テキストを含むコントロールの要素が RTL の読み取り順序で右から左に表示される|効果なし|いいえ|  
+|<xref:System.Windows.Forms.SaveFileDialog>|影響を受けません。オペレーティング システムの言語によって異なります|効果なし|いいえ|  
+|<xref:System.Windows.Forms.SplitContainer>|パネルのレイアウトが反転され、垂直スクロール バーは左側に表示され、水平スクロール バーは右から始まる|<xref:System.Windows.Forms.TableLayoutPanel> を使用して、子コントロールの順序をミラーリングする|いいえ|  
+|<xref:System.Windows.Forms.Splitter>|サポートなし|効果なし|いいえ|  
+|<xref:System.Windows.Forms.StatusBar>|サポートされていません。代わりに <xref:System.Windows.Forms.StatusStrip> を使用|効果はありません。代わりに <xref:System.Windows.Forms.StatusStrip> を使用|いいえ|  
+|<xref:System.Windows.Forms.TabControl>|このプロパティによる影響はなし|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.TextBox>|RTL の読み取り順序で右から左へテキストが表示されます。|効果なし|いいえ|  
+|<xref:System.Windows.Forms.Timer>|不要|不要|いいえ|  
+|<xref:System.Windows.Forms.ToolBar>|このプロパティの夜影響はなし。代わりに <xref:System.Windows.Forms.ToolStrip> を使用|効果はありません。代わりに <xref:System.Windows.Forms.ToolStrip> を使用|はい|  
+|<xref:System.Windows.Forms.ToolTip>|RTL の読み取り順序を設定|効果なし|いいえ|  
+|<xref:System.Windows.Forms.TrackBar>|スクロールやトラックは右から始まります。<xref:System.Windows.Forms.TrackBar.Orientation%2A> が垂直方向の場合、タイマー刻みは右から発生します。|効果なし|いいえ|  
+|<xref:System.Windows.Forms.TreeView>|RTL の読み取り順序のみを設定|コントロールをミラーリングする|はい|  
+|<xref:System.Windows.Forms.UserControl>|左側に垂直スクロール バーが表示され、水平スクロール バーは右側につまみがあります|直接サポートはありません。<xref:System.Windows.Forms.TableLayoutPanel> を使用します。|いいえ|  
+|<xref:System.Windows.Forms.VScrollBar>|右側のスクロール可能なコントロールの代わりに左側に表示されます。|効果なし|いいえ|  
+  
+## エンコード  
+ Windows フォームは Unicode をサポートするので、双方向のアプリケーションを作成するときに、任意の文字セットを含めることができます。  ただし、すべての Windows フォーム コントロールですべてのプラットフォームの Unicode をサポートするわけではありません。  詳細については、「[エンコード方式および Windows フォームのグローバリゼーション](../../../../docs/framework/winforms/advanced/encoding-and-windows-forms-globalization.md)」を参照してください。  
+  
+## GDI\+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して、右から左への読み取り順序でテキストを描画できます。  <xref:System.Drawing.Graphics.DrawString%2A> メソッドは、テキストの描画に使用され、テキストの原点を反転させるために、<xref:System.Drawing.StringFormatFlags> 列挙の <xref:System.Drawing.StringFormatFlags> のメンバーを設定できる `StringFormat` パラメーターをサポートします。  
+  
+## コモン ダイアログ ボックス  
+ Windows の制御下にある \[ファイルを開く\] ダイアログ ボックスなどのシステム ツールです。  これらは、オペレーティング システムから言語要素を継承します。  適切な言語設定のバージョンの Windows を使用している場合は、これらのダイアログ ボックスは双方向言語で正しく動作します。  
+  
+ 同様に、メッセージ ボックスはオペレーティング システムを通過して、双方向のテキストをサポートします。  メッセージ ボックスのボタンのキャプションは、現在の言語設定に基づいています。  既定では、メッセージ ボックスは右から左への読み取り順序を使用せず、メッセージ ボックスが表示される場合に、読み取り順序を変更するパラメーターを指定することができます。  
+  
+## RightToLeft、Scrollbars、および ScrollableControl  
+ Windows フォームには現在制限があり、両方の <xref:System.Windows.Forms.Control.RightToLeft%2A> が有効になり、<xref:System.Windows.Forms.ScrollableControl.AutoScroll%2A> が <xref:System.Windows.Forms.RightToLeft> に設定されている場合に、<xref:System.Windows.Forms.ScrollableControl> から派生したすべてのクラスが適切に動作しされません。  たとえば、フォームに <xref:System.Windows.Forms.Panel> のようなコントロールや、<xref:System.Windows.Forms.Panel> \(<xref:System.Windows.Forms.FlowLayoutPanel> または <xref:System.Windows.Forms.TableLayoutPanel> など\) から派生したコンテナー クラスを配置するとします。  コンテナーの <xref:System.Windows.Forms.ScrollableControl.AutoScroll%2A> を <xref:System.Windows.Forms.RightToLeft> に設定し、コンテナー内の 1 つ以上のコントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティを <xref:System.Windows.Forms.AnchorStyles> に設定する場合、スクロール バーが表示されません。  <xref:System.Windows.Forms.ScrollableControl> から派生するクラスは、<xref:System.Windows.Forms.ScrollableControl.AutoScroll%2A> が <xref:System.Windows.Forms.RightToLeft> に設定された場合のように動作します。  
+  
+ 現在、唯一の回避策は、別の <xref:System.Windows.Forms.ScrollableControl> 内側に <xref:System.Windows.Forms.ScrollableControl> をネストすることです。  たとえば、この状況で <xref:System.Windows.Forms.TableLayoutPanel> が動作することが必要な場合は、<xref:System.Windows.Forms.Panel> コントロールの内側に配置して、<xref:System.Windows.Forms.Panel> 上の <xref:System.Windows.Forms.ScrollableControl.AutoScroll%2A> を <xref:System.Windows.Forms.RightToLeft> に設定します。  
+  
+## ミラー化  
+ *ミラーリング*とは、右から左にフローできるように UI 要素のレイアウトを反転させることを指します。  たとえば、ミラーリングされた Windows フォームでは、最小化、最大化、および閉じるボタンはタイトル バーの右端ではなく左端に表示されます。  
+  
+ フォームまたはコントロールの <xref:System.Windows.Forms.Control.RightToLeft%2A> プロパティを `true` に設定すると、フォームの要素の読み取り順序が反転しますが、この設定は、右から左のレイアウトを反転しません。つまり、ミラーリングが発生しません。  たとえば、このプロパティを設定したときに、フォームのタイトル バーにある**最小化**、**最大化**、および**閉じる**ボタンを、フォームの左側に移動することはありません。  同様に、<xref:System.Windows.Forms.TreeView> コントロールなどのいくつかコントロールは、アラビア語またはヘブライ語に適した表示に変更するには、ミラーリングが必要です。  <xref:System.Windows.Forms.Form.RightToLeftLayout%2A> プロパティを設定することで、これらのコントロールをミラーリングできます。  
+  
+ 次のコントロールのミラーリングされたバージョンを作成できます。  
+  
+-   <xref:System.Windows.Forms.ColumnHeader.ListView%2A>  
+  
+-   <xref:System.Windows.Forms.Panel>  
+  
+-   <xref:System.Windows.Forms.StatusBar>  
+  
+-   <xref:System.Windows.Forms.TabControl>  
+  
+-   <xref:System.Windows.Forms.TabPage>  
+  
+-   <xref:System.Windows.Forms.ToolBar>  
+  
+-   <xref:System.Windows.Forms.TreeView>  
+  
+ 一部のコントロールはシールされています。  そのため、そこから新しいコントロールを派生できません。  これには、<xref:System.Windows.Forms.ImageList> コントロールや <xref:System.Windows.Forms.ProgressBar> コントロールが含まれます。  
+  
+## 参照  
+ [Bidirectional Support for ASP.NET Web Applications](../Topic/Bidirectional%20Support%20for%20ASP.NET%20Web%20Applications.md)   
+ [Windows フォームのグローバル化](../../../../docs/framework/winforms/advanced/globalizing-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md b/docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md
new file mode 100644
index 00000000000..4f0caa3fd08
--- /dev/null
+++ b/docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md
@@ -0,0 +1,92 @@
+---
+title: "GDI+ でのブラシと塗りつぶされた図形 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ブラシ, GDI+"
+  - "ブラシ, グラデーション"
+  - "塗りつぶされた図形, GDI+"
+  - "GDI+, ブラシ"
+  - "GDI+, 塗りつぶされた図形"
+  - "グラデーション ブラシ"
+  - "形状, GDI+"
+ms.assetid: e863e2a7-0294-4130-99b6-f1ea3201e7cd
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# GDI+ でのブラシと塗りつぶされた図形
+四角形や楕円などの閉じた図形は、アウトラインと内部から構成されます。  アウトラインはペンを使用して描画され、内部はブラシを使用して塗りつぶされます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、閉じた図形の内部を塗りつぶすためのブラシ クラスとして、<xref:System.Drawing.SolidBrush>、<xref:System.Drawing.Drawing2D.HatchBrush>、<xref:System.Drawing.TextureBrush>、<xref:System.Drawing.Drawing2D.LinearGradientBrush> 、および <xref:System.Drawing.Drawing2D.PathGradientBrush> が用意されています。  これらのクラスはすべて、<xref:System.Drawing.Brush> クラスを継承します。  ソリッド ブラシを使用して塗りつぶされた四角形と、ハッチ ブラシを使用して塗りつぶされた楕円を次の図に示します。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art17.png "Aboutgdip02\_art17")  
+  
+## ソリッド ブラシ  
+ 閉じた図形を塗りつぶすには、<xref:System.Drawing.Graphics> クラスのインスタンスと <xref:System.Drawing.Brush> オブジェクトが必要です。  <xref:System.Drawing.Graphics> クラスのインスタンスには、<xref:System.Drawing.Graphics.FillRectangle%2A> や <xref:System.Drawing.Graphics.FillEllipse%2A> などのメソッドが用意されています。<xref:System.Drawing.Brush> は、色やパターンなどの塗りつぶし属性を格納します。  <xref:System.Drawing.Brush> は、引数の 1 つとして塗りつぶしメソッドに渡されます。  楕円を純色の赤で塗りつぶす方法を次のコード例に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#121](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#121)]
+ [!code-vb[LinesCurvesAndShapes#121](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#121)]  
+  
+> [!NOTE]
+>  上記の例のブラシは <xref:System.Drawing.SolidBrush> 型で、<xref:System.Drawing.Brush> から継承されています。  
+  
+## ハッチ ブラシ  
+ ハッチ ブラシを使用して図形を塗りつぶす場合は、前景色、背景色、およびハッチ スタイルを指定します。  前景色はハッチングの色です。  
+  
+ [!code-csharp[LinesCurvesAndShapes#122](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#122)]
+ [!code-vb[LinesCurvesAndShapes#122](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#122)]  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、50 種類を超えるハッチ スタイルが用意されています。<xref:System.Drawing.Drawing2D.HatchStyle>、<xref:System.Drawing.Drawing2D.HatchStyle>、および <xref:System.Drawing.Drawing2D.HatchStyle> の 3 つのスタイルを次の図に示します。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art18.png "Aboutgdip02\_art18")  
+  
+## テクスチャ ブラシ  
+ テクスチャ ブラシを使用すると、ビットマップに格納されているパターンを使用して図形を塗りつぶすことができます。  たとえば、`MyTexture.bmp` という名前のディスク ファイルに、次のピクチャが格納されているとします。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art19.png "Aboutgdip02\_Art19")  
+  
+ `MyTexture.bmp` に格納されているピクチャを繰り返して楕円を塗りつぶすコード例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#123](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#123)]
+ [!code-vb[LinesCurvesAndShapes#123](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#123)]  
+  
+ 塗りつぶされた楕円を次の図に示します。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art20.png "AboutGdip02\_Art20")  
+  
+## グラデーション ブラシ  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、線形とパスの 2 種類のグラデーション ブラシが用意されています。  線形グラデーション ブラシを使用すると、図形内を横方向、縦方向、または対角線方向に移動するのに応じて色を段階的に変化させながら図形を塗りつぶすことができます。  楕円の左端から右端へ移動するのに応じて、青から緑へ変化する横方向のグラデーション ブラシを使用して楕円を塗りつぶすコード例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#124](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#124)]
+ [!code-vb[LinesCurvesAndShapes#124](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#124)]  
+  
+ 塗りつぶされた楕円を次の図に示します。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art21.png "AboutGdip02\_Art21")  
+  
+ パス グラデーション ブラシは、図形の中央から外縁に向かって移動するのに応じて色が変化するように設定できます。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art22.png "AboutGdip02\_Art22")  
+  
+ パス グラデーション ブラシは、柔軟性の高いブラシです。  グラデーション ブラシを使用して、中央の赤から頂点の 3 つの異なる色へ色が段階的に変化するように三角形を塗りつぶす例を次の図に示します。  
+  
+ ![塗りつぶされた図形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art23.png "AboutGdip02\_Art23")  
+  
+## 参照  
+ <xref:System.Drawing.SolidBrush?displayProperty=fullName>   
+ <xref:System.Drawing.Drawing2D.HatchBrush?displayProperty=fullName>   
+ <xref:System.Drawing.TextureBrush?displayProperty=fullName>   
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : Windows フォームに塗りつぶした四角形を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-filled-rectangle-on-a-windows-form.md)   
+ [方法 : Windows フォームに塗りつぶした楕円を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-filled-ellipse-on-a-windows-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/cardinal-splines-in-gdi.md b/docs/framework/winforms/advanced/cardinal-splines-in-gdi.md
new file mode 100644
index 00000000000..3acbb8b2012
--- /dev/null
+++ b/docs/framework/winforms/advanced/cardinal-splines-in-gdi.md
@@ -0,0 +1,46 @@
+---
+title: "GDI+ でのカーディナル スプライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カーディナル スプライン"
+  - "GDI+, カーディナル スプライン"
+  - "スプライン, カーディナル"
+ms.assetid: 09b3797a-6294-422d-9adf-a5a0a7695c0c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# GDI+ でのカーディナル スプライン
+カーディナル スプラインとは、大きな曲線を形成するために接合された個別の曲線の集まりのことです。  スプラインは、複数の点の配列とテンション パラメーターによって指定されます。  カーディナル スプラインは、配列内の各点を滑らかに通過します。不連続な傾きの変化や曲線のテンションの急激な変化はありません。  点のセットおよびセット内の各点を通過するカーディナル スプラインを次の図に示します。  
+  
+ ![カーディナル スプライン](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art09.png "Aboutgdip02\_art09")  
+  
+## 物理的なスプラインと数学的なスプライン  
+ 物理的なスプラインは、木などの柔軟な材料で作られた薄い板です。  数学的なスプラインが実用化されるまで、デザイナーは物理的なスプラインを使用して曲線を作図していました。  デザイナーは、紙の上にスプラインを置き、指定した点のセット上でスプラインを固定します。  次に、デザイナーはスプラインに沿ってペンまたは鉛筆で曲線を作図します。  物理的なスプラインの特性に応じて、指定した点のセットからさまざまな曲線を作成できます。  たとえば、曲げに対する抵抗力が強いスプラインと非常に柔軟なスプラインでは、作成される曲線は異なります。  
+  
+ 数学的なスプラインの数式は柔軟な棒の特性に基づいているため、数学的なスプラインで作成される曲線は、従来の物理的なスプラインで作成される曲線に類似しています。  物理的なスプラインでは、指定した点のセットからテンションに応じてさまざまな曲線が作成されます。同様に、数学的なスプラインでは、指定した点のセットからテンション パラメーターの値に応じてさまざまな曲線が作成されます。  同じ点のセットを通過する 4 つのカーディナル スプラインを次の図に示します。  各スプラインのテンションが示されています。  テンションの値 0 は無限大の物理的テンションに相当し、曲線は点の間の最短距離 \(直線\) を通過するように強制されます。  テンションの値 1 は物理的テンションがない状態に相当し、スプラインは曲げの合計が最小になるパスを通過できます。  テンションの値が 1 より大きい場合、曲線は圧縮されたばねと同様に長いパスを通過するように強制されます。  
+  
+ ![カーディナル スプライン](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art10.png "Aboutgdip02\_art10")  
+  
+ 上記の図の 4 つのスプラインでは、開始点における接線はすべて同じです。  接線は、開始点と曲線上の次の点を結ぶ直線です。  同様に、終了点における接線は、終了点と曲線上の前の点を結ぶ直線です。  
+  
+ カーディナル スプラインを描画するには、<xref:System.Drawing.Graphics> クラスのインスタンス、<xref:System.Drawing.Pen>、および <xref:System.Drawing.Point> オブジェクトの配列が必要です。<xref:System.Drawing.Graphics> クラスのインスタンスはスプラインを描画する <xref:System.Drawing.Graphics.DrawCurve%2A> メソッドを提供し、<xref:System.Drawing.Pen> は線幅や色などのスプラインの属性を格納します。  <xref:System.Drawing.Point> オブジェクト配列は曲線が通過する複数の点を格納します。   `myPointArray` 内の点を通過するカーディナル スプラインを描画する方法を次のコード例に示します。  3 番目のパラメーターはテンションです。  
+  
+ [!code-csharp[LinesCurvesAndShapes#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#31)]
+ [!code-vb[LinesCurvesAndShapes#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#31)]  
+  
+## 参照  
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [曲線の作成と描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-curves.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md b/docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md
new file mode 100644
index 00000000000..4c491fd3c15
--- /dev/null
+++ b/docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM [Windows フォーム]"
+  - "Windows フォーム, アンマネージ"
+  - "COM interop, 呼び出しメソッド"
+  - "ActiveX コントロール [Windows フォーム], COM 相互運用機能"
+  - "ShowDialog メソッド"
+  - "Windows フォーム, 相互運用"
+ms.assetid: 87aac8ad-3c04-43b3-9b0c-d0b00df9ee74
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループで Windows フォームを表示して、コンポーネント オブジェクト モデル \(COM\) 相互運用性の問題を解決できます。これは、<xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName> メソッドを使用して作成されます。  
+  
+ フォームが COM クライアント アプリケーションから正しく動作するには、Windows フォームのメッセージ ループ上で実行する必要があります。 そのためには、次の方法のいずれかを使用します。  
+  
+-   <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用して、Windows フォームを表示します。  
+  
+-   各 Windows フォームを別のスレッドで表示します。 詳細については、「[方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)」を参照してください。  
+  
+## プロシージャ  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループにフォームを表示する方法としては、すべての方法の中で実装する必要があるコードが最も少ない <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用する方法が最も簡単です。  
+  
+ <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドは、管理されていないアプリケーションのメッセージ ループを一時停止し、フォームをダイアログ ボックスとして表示します。 ホスト アプリケーションのメッセージ ループが一時停止されているので、<xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドは、新しい [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループを作成してフォームのメッセージを処理します。  
+  
+ <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用する場合の欠点は、フォームがモーダル ダイアログ ボックスとして開かれることです。 この動作により、Windows フォームが開かれている間は呼び出し元のアプリケーションですべてのユーザー インターフェイス \(UI\) がブロックされます。 ユーザーがフォームを終了すると、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループが終了し、以前のアプリケーションのメッセージ ループの実行が再び開始されます。  
+  
+ フォームを表示するためのメソッドが含まれるクラス ライブラリを Windows フォームで作成し、その後で COM 相互運用機能のクラス ライブラリをビルドすることができます。 Visual Basic 6.0 または Microsoft Foundation Classes \(MFC\) からこの DLL ファイルを使用し、これらのいずれかの環境から <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを呼び出してフォームを表示することができます。  
+  
+#### ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする方法  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] コンポーネントで、<xref:System.Windows.Forms.Form.Show%2A?displayProperty=fullName> メソッドのすべての呼び出しを <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドの呼び出しに置き換えます。  
+  
+## 参照  
+ [COM への .NET Framework コンポーネントの公開](../../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)   
+ [Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/constructing-and-drawing-curves.md b/docs/framework/winforms/advanced/constructing-and-drawing-curves.md
new file mode 100644
index 00000000000..bfffaadfca3
--- /dev/null
+++ b/docs/framework/winforms/advanced/constructing-and-drawing-curves.md
@@ -0,0 +1,36 @@
+---
+title: "曲線の作成と描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "曲線, 描画"
+  - "描画, 曲線"
+  - "例 [Windows フォーム], 描画 (曲線を)"
+ms.assetid: 76e92623-4130-4644-b867-faca58bdb3a2
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 曲線の作成と描画
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、楕円、円弧、カーディナル スプライン、およびベジエ スプラインなどの各種の曲線をサポートしています。  楕円は外接する四角形によって定義されます。円弧は楕円の一部であり、開始角度およびスイープ角度によって定義されます。  カーディナル スプラインは、点の配列とテンション パラメーターによって定義されます。つまり、この曲線は配列内の各点を滑らかに結び、テンション パラメーターの作用によって曲げられます。  ベジエ スプラインは、2 つの端点と 2 つの制御点によって定義されます。つまり、この曲線は制御点を結ぶのではなく、曲線が一方の端点からもう一方の端点に移動するにつれて制御点はその曲線の方向と歪曲度に影響します。  
+  
+## このセクションの内容  
+ [方法 : カーディナル スプラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-cardinal-splines.md)  
+ カーディナル スプラインとその描画方法について説明します。  
+  
+ [方法 : 1 本のベジエ スプラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-single-bezier-spline.md)  
+ ベジエ スプラインとその描画方法について説明します。  
+  
+ [方法 : 一連のベジエ スプラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-sequence-of-bezier-splines.md)  
+ 複数のベジエ スプラインを順に描画する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/constructing-and-drawing-paths.md b/docs/framework/winforms/advanced/constructing-and-drawing-paths.md
new file mode 100644
index 00000000000..c83e8ab5f17
--- /dev/null
+++ b/docs/framework/winforms/advanced/constructing-and-drawing-paths.md
@@ -0,0 +1,44 @@
+---
+title: "パスの作成および描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (パスを)"
+  - "例 [Windows フォーム], 描画 (パスを)"
+  - "グラフィックス パス, 作成"
+  - "グラフィックス パス, 描画"
+  - "パス, 描画"
+ms.assetid: f16ec921-56cf-46d1-9741-d7316ad06b23
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# パスの作成および描画
+パスとは、1 つの単位として操作および描画できる、連続した複数のグラフィックス プリミティブ \(直線、四角形、曲線、テキストなど\) のことです。  パスは、開いた*図形*または閉じた図形のいずれかに分類できます。  図形には、複数のプリミティブが含まれています。  
+  
+ パスを描画するには <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawPath%2A> メソッドを呼び出し、パスを塗りつぶすには <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.FillPath%2A> メソッドを呼び出します。  
+  
+## このセクションの内容  
+ [方法 : 直線、曲線、および形状から図形を作成する](../../../../docs/framework/winforms/advanced/how-to-create-figures-from-lines-curves-and-shapes.md)  
+ <xref:System.Drawing.Drawing2D.GraphicsPath> を使用して図形を作成する方法を示します。  
+  
+ [方法 : 開いている図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-fill-open-figures.md)  
+ <xref:System.Drawing.Drawing2D.GraphicsPath> を塗りつぶす方法について説明します。  
+  
+ [方法 : 曲線のパスを直線に平坦化する](../../../../docs/framework/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md)  
+ <xref:System.Drawing.Drawing2D.GraphicsPath> を平坦化する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Drawing2D.GraphicsPath>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/control-help-using-tooltips.md b/docs/framework/winforms/advanced/control-help-using-tooltips.md
new file mode 100644
index 00000000000..d2e99a8d142
--- /dev/null
+++ b/docs/framework/winforms/advanced/control-help-using-tooltips.md
@@ -0,0 +1,33 @@
+---
+title: "ツールヒントを使用したコントロールのヘルプ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], ツールヒント"
+  - "ヘルプ, 追加 (ダイアログ ボックスに)"
+  - "ヘルプ, ツールヒント (コントロールの)"
+  - "ツールヒント [Windows フォーム], コントロールの"
+ms.assetid: 03263f94-e539-440b-a67c-8b9110c96dcd
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ツールヒントを使用したコントロールのヘルプ
+<xref:System.Windows.Forms.ToolTip> コンポーネントを使用することにより、Windows フォーム上の個別のコントロールについて簡単な固有のヘルプ メッセージを表示できます。  <xref:System.Windows.Forms.ToolTip> コンポーネントには、フォーム上の各コントロールに対して表示するテキストを指定するためのプロパティがあります。  このような、<xref:System.Windows.Forms.ToolTip> コンポーネントの操作方法の詳細については、「[方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](../../../../docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)」を参照してください。  さらに、<xref:System.Windows.Forms.ToolTip> コンポーネントでは、表示するまでの時間を設定できます。  詳細については、「[方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)」を参照してください。  
+  
+## 参照  
+ [方法 : ポップアップ ヘルプを表示する](../../../../docs/framework/winforms/advanced/how-to-display-pop-up-help.md)   
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)   
+ [Windows フォームでのヘルプの統合](../../../../docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/coordinate-systems-and-transformations.md b/docs/framework/winforms/advanced/coordinate-systems-and-transformations.md
new file mode 100644
index 00000000000..a4f9d10a88c
--- /dev/null
+++ b/docs/framework/winforms/advanced/coordinate-systems-and-transformations.md
@@ -0,0 +1,47 @@
+---
+title: "座標系と変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, 変換"
+  - "行列による変換"
+  - "変換"
+ms.assetid: 9fef7451-bddf-4c68-9350-400d1f1f25a3
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 座標系と変換
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、描画対象の項目を変換 \(回転、スケーリング、平行移動など\) できるように、ワールド変換とページ変換がサポートされています。  この 2 つの変換は、さまざまな座標系で使用できます。  
+  
+## このセクションの内容  
+ [座標系の種類](../../../../docs/framework/winforms/advanced/types-of-coordinate-systems.md)  
+ 座標系と変換の概要について説明します。  
+  
+ [変換の行列表現](../../../../docs/framework/winforms/advanced/matrix-representation-of-transformations.md)  
+ 行列を使用した座標変換について説明します。  
+  
+ [グローバル変換とローカル変換](../../../../docs/framework/winforms/advanced/global-and-local-transformations.md)  
+ グローバル変換とローカル変換について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Drawing2D.Matrix>  
+ ジオメトリック変換を表現する 3 × 3 のアフィン行列をカプセル化します。  
+  
+## 関連項目  
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)  
+ 行列変換の使用方法の詳細について説明するトピックの一覧を示します。  
+  
+ [GDI\+ マネージ コードについて](../../../../docs/framework/winforms/advanced/about-gdi-managed-code.md)  
+ .NET Framework で使用できるグラフィックス構成要素について説明するトピックの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/copy--paste-an-elementhost-control-into-forms.md b/docs/framework/winforms/advanced/copy--paste-an-elementhost-control-into-forms.md
new file mode 100644
index 00000000000..0fe2538e60b
--- /dev/null
+++ b/docs/framework/winforms/advanced/copy--paste-an-elementhost-control-into-forms.md
@@ -0,0 +1,81 @@
+---
+title: "チュートリアル : ElementHost コントロールの別の Windows フォームへのコピーと貼り付け | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ElementHost コントロール, コピーと貼り付け (デザイン時に)"
+  - "相互運用性 [WPF]"
+  - "Windows フォーム, コンテンツのコピーと貼り付け"
+  - "WPF ユーザー コントロール, ホスト (Windows フォームで)"
+ms.assetid: 6e81bb13-577c-46c3-a1cf-8d15969fb83e
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# チュートリアル : ElementHost コントロールの別の Windows フォームへのコピーと貼り付け
+このチュートリアルでは、Windows フォーム間で Windows Presentation Foundation \(WPF\) コントロールをコピーする方法について説明します。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   プロジェクトを作成する。  
+  
+-   WPF コントロールをコピーする。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)].  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `CopyElementHost` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## WPF コントロールのコピー  
+ プロジェクトに WPF コントロールを追加した後、プロジェクト内の他のフォームにコピーすることができます。  
+  
+#### WPF コントロールをコピーするには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> プロジェクトをソリューションに追加します。  コントロール型の既定の名前である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  プロジェクトをビルドします。  
+  
+3.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+4.  **ツールボックス**から、`UserControl1` のインスタンスをフォームにドラッグします。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+5.  `elementHost1` を選択して、CTRL \+ C キーを押してクリップボードにコピーします。  
+  
+6.  新しい Windows フォームをプロジェクトに追加します。  フォームの種類の既定の名前である `Form2` を使用します。  
+  
+7.  Windows フォーム デザイナーで `Form2` を開いたまま、CTRL キーを押しながら V キーを押して、`elementHost1` のコピーをフォームに貼り付けます。  
+  
+     `Form2` クラスのプライベート フィールドであるため、コピーしたコントロールの名前も `elementHost1` です。  `Form1` クラスの `elementHost1` には名前の競合がありません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/cropping-and-scaling-images-in-gdi.md b/docs/framework/winforms/advanced/cropping-and-scaling-images-in-gdi.md
new file mode 100644
index 00000000000..a792ffc3335
--- /dev/null
+++ b/docs/framework/winforms/advanced/cropping-and-scaling-images-in-gdi.md
@@ -0,0 +1,57 @@
+---
+title: "GDI+ でのイメージのトリミングおよびスケーリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "圧縮 (データを), イメージ"
+  - "GDI+, トリミング (イメージを)"
+  - "GDI+, スケーリング (イメージの)"
+  - "イメージ [Windows フォーム], 圧縮"
+  - "イメージ [Windows フォーム], トリミング"
+  - "イメージ [Windows フォーム], 展開"
+  - "イメージ [Windows フォーム], スケーリング"
+  - "四角形, 描画先"
+  - "四角形, source"
+ms.assetid: ad5daf26-005f-45bc-a2af-e0e97777a21a
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# GDI+ でのイメージのトリミングおよびスケーリング
+<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドを使用して、ベクター イメージとラスター イメージを描画および配置できます。  <xref:System.Drawing.Graphics.DrawImage%2A> はオーバーロードされたメソッドであるため、いくつかの方法でこのメソッドの引数を指定できます。  
+  
+## DrawImage のバリエーション  
+ ある <xref:System.Drawing.Graphics.DrawImage%2A> メソッドは、<xref:System.Drawing.Bitmap> と <xref:System.Drawing.Rectangle> を受け取ります。  四角形は、描画操作の範囲を指定します。つまり、イメージが描画される先の四角形を指定します。  描画先の四角形のサイズと元のイメージのサイズが異なる場合、イメージは、描画先の四角形と一致するようにスケーリングされます。  スケーリングなし、拡大、および縮小の操作をそれぞれ適用して、同じイメージを 3 回描画するコード例を次に示します。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#31)]  
+  
+ 3 つのピクチャを次の図に示します。  
+  
+ ![スケーリング](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art06.png "AboutGdip03\_Art06")  
+  
+ 描画元の四角形パラメーターと描画先の四角形パラメーターを使用する <xref:System.Drawing.Graphics.DrawImage%2A> メソッドもあります。  描画元の四角形パラメーターは、描画する元のイメージの部分を指定します。  描画先の四角形は、イメージのその部分が描画される先の四角形を指定します。  描画先の四角形のサイズと描画元の四角形のサイズが異なる場合、ピクチャは、描画先の四角形と一致するようにスケーリングされます。  
+  
+ Runner.jpg ファイルから <xref:System.Drawing.Bitmap> オブジェクトを構築するコード例を次に示します。  イメージ全体が \(0, 0\) の位置にスケーリングなしで描画されます。  次に、縮小と拡大の操作をそれぞれ適用して、イメージの小さい部分が 2 回描画されます。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#32](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#32)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#32](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#32)]  
+  
+ スケーリングなしのイメージ、縮小されたイメージ部分、および拡大されたイメージ部分を次の図に示します。  
+  
+ ![トリミングとスケーリング](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art07.png "AboutGdip03\_Art07")  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/display-of-asian-characters-with-the-imemode-property.md b/docs/framework/winforms/advanced/display-of-asian-characters-with-the-imemode-property.md
new file mode 100644
index 00000000000..315105e19ce
--- /dev/null
+++ b/docs/framework/winforms/advanced/display-of-asian-characters-with-the-imemode-property.md
@@ -0,0 +1,38 @@
+---
+title: "ImeMode プロパティによるアジア言語の文字表示 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アジアの言語"
+  - "アジアの言語, 表示 (ImeMode で)"
+  - "中国語の文字, 表示 (ImeMode で)"
+  - "グローバリゼーション [Windows フォーム], 文字セット"
+  - "IME モード"
+  - "IMEMode プロパティ"
+  - "Input Method Editor (IME), モード"
+  - "国際対応のアプリケーション [Windows フォーム], 文字表示"
+  - "各種言語の文字"
+  - "日本語の文字, 表示 (ImeMode で)"
+  - "韓国語文字"
+  - "ローカリゼーション [Windows フォーム], 文字セット"
+ms.assetid: c60ae399-0dab-4f07-9dea-6dbfb15ec0ae
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# ImeMode プロパティによるアジア言語の文字表示
+<xref:System.Windows.Forms.Control.ImeMode%2A> プロパティは、IME \(Input Method Editor\) のモードを強制的に指定する場合に、フォームおよびコントロールで使用します。  IME は、中国語、日本語、および韓国語の言語を記述するときに不可欠なコンポーネントです。これらの言語には、通常のキーボードではエンコードできないほど多くの文字が含まれているからです。  たとえば、特定のテキスト ボックスに入力できる文字を ASCII 文字だけにする必要があるとします。  この場合、<xref:System.Windows.Forms.Control.ImeMode%2A> プロパティを <xref:System.Windows.Forms.ImeMode> に設定することにより、特定のテキスト ボックスでは、ユーザーが ASCII 以外の文字を入力できないように設定できます。  <xref:System.Windows.Forms.Control.ImeMode%2A> プロパティの既定の値は、<xref:System.Windows.Forms.ImeMode> です。したがって、プロパティをフォームに設定すると、このフォーム上のすべてのコントロールでこの設定が継承されます。  詳細については、「[ImeMode プロパティ](frlrfSystemWindowsFormsControlClassImeModeTopic)」および「[ImeMode 列挙](frlrfSystemWindowsFormsImeModeClassTopic)」を参照してください。  
+  
+## 参照  
+ [Windows フォームのグローバル化](../../../../docs/framework/winforms/advanced/globalizing-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/double-buffered-graphics.md b/docs/framework/winforms/advanced/double-buffered-graphics.md
new file mode 100644
index 00000000000..2c27e85e02c
--- /dev/null
+++ b/docs/framework/winforms/advanced/double-buffered-graphics.md
@@ -0,0 +1,51 @@
+---
+title: "ダブル バッファリングされたグラフィックス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダブル バッファリング"
+  - "例 [Windows フォーム], ダブル バッファリングされたグラフィックス"
+  - "ちらつき, 軽減 (ダブル バッファリングにより)"
+  - "グラフィックス, ダブル バッファリング"
+ms.assetid: 4f6fef99-0972-436e-9d73-0167e4033f71
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ダブル バッファリングされたグラフィックス
+グラフィックスをプログラミングするときは、ちらつきが一般的な問題になります。  複数の複雑な描画操作を必要とするグラフィックス操作を実行すると、描画されたイメージがちらつきなどによって適切に表示されないことがあります。  このような問題に対処するために、.NET Framework では、ダブル バッファリングを利用できます。  
+  
+ ダブル バッファリングでは、メモリ バッファーを使用して、複数の描画操作に関連するちらつきの問題に対処します。  ダブル バッファリングを有効にすると、すべての描画操作が画面上の描画サーフェイスではなく、最初にメモリ バッファーに描画されます。  描画操作がすべて完了すると、メモリ バッファーが、関連付けられている描画サーフェイスに直接コピーされます。  画面上で実行されるグラフィックス操作は 1 つだけなので、複雑な描画操作に関連するイメージのちらつきが解消されます。  
+  
+## 既定のダブル バッファリング  
+ アプリケーションでダブル バッファリングを使用するには、.NET Framework に用意されている、フォームやコントロールに対する既定のダブル バッファリングを使用するのが最も簡単です。  Windows フォームや作成した Windows コントロールに対して既定のダブル バッファリングを有効にするには、<xref:System.Windows.Forms.Control.DoubleBuffered%2A> プロパティを `true` に設定するか、<xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを使用します。  詳細については、「[方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する](../../../../docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md)」を参照してください。  
+  
+## バッファリングされたグラフィックスの手動管理  
+ アニメーションや高度なメモリ管理など、より高度なダブル バッファリングのシナリオでは、.NET Framework クラスを使用して独自のダブル バッファリング ロジックを実装できます。  個々のグラフィックス バッファーの割り当てと管理を担当するクラスは <xref:System.Drawing.BufferedGraphicsContext> クラスです。  各アプリケーション ドメインには、そのアプリケーションの既定のダブル バッファリングをすべて管理する、それぞれ独自の既定の <xref:System.Drawing.BufferedGraphicsContext> インスタンスがあります。  多くの場合、アプリケーションごとに存在するアプリケーション ドメインは 1 つだけなので、通常、アプリケーションごとに 1 つの既定の <xref:System.Drawing.BufferedGraphicsContext> があります。  既定の <xref:System.Drawing.BufferedGraphicsContext> インスタンスは、<xref:System.Drawing.BufferedGraphicsManager> クラスによって管理されます。  既定の <xref:System.Drawing.BufferedGraphicsContext> インスタンスへの参照を取得するには、[BufferedGraphicsManager.Current プロパティ](frlrfSystemDrawingBufferedGraphicsManagerClassCurrentTopic)を呼び出します。  また、専用の <xref:System.Drawing.BufferedGraphicsContext> インスタンスを作成して、グラフィックス重視のアプリケーションのパフォーマンスを向上させることもできます。  <xref:System.Drawing.BufferedGraphicsContext> インスタンスの作成方法については、「[方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)」を参照してください。  
+  
+## バッファリングされたグラフィックスの手動表示  
+ <xref:System.Drawing.BufferedGraphicsContext> クラスのインスタンスを使用して [BufferedGraphicsContext.Allocate メソッド](frlrfSystemDrawingBufferedGraphicsContextClassAllocateTopic)を呼び出すと、グラフィックス バッファーを作成できます。このメソッドは、<xref:System.Drawing.BufferedGraphics> クラスのインスタンスを返します。  <xref:System.Drawing.BufferedGraphics> オブジェクトは、フォームやコントロールなどの描画面に関連付けられたメモリ バッファーを管理します。  
+  
+ インスタンス化された <xref:System.Drawing.BufferedGraphics> クラスは、メモリ内のグラフィックス バッファーへの描画を管理します。  グラフィックスは、[BufferedGraphics.Graphics プロパティ](frlrfSystemDrawingBufferedGraphicsClassGraphicsTopic)を通じてメモリ バッファーに描画できます。このプロパティは、メモリ バッファーを直接表す <xref:System.Drawing.Graphics> オブジェクトを公開します。  この <xref:System.Drawing.Graphics> オブジェクトには、描画サーフェイスを表す <xref:System.Drawing.Graphics> オブジェクトに描画する場合と同じように描画できます。  すべてのグラフィックスをバッファーに描画すると、[BufferedGraphics.Render メソッド](frlrfSystemDrawingBufferedGraphicsClassRenderTopic)を使用して、バッファーの内容を画面上の描画サーフェイスにコピーできます。  
+  
+ <xref:System.Drawing.BufferedGraphics> クラスの使い方の詳細については、「[方法 : バッファリングされたグラフィックスを手動で描画する](../../../../docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md)」を参照してください。  グラフィックスの描画の詳細については、「[Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Drawing.BufferedGraphics>   
+ <xref:System.Drawing.BufferedGraphicsContext>   
+ <xref:System.Drawing.BufferedGraphicsManager>   
+ [方法 : バッファリングされたグラフィックスを手動で描画する](../../../../docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md)   
+ [方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する](../../../../docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md)   
+ [方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md b/docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md
new file mode 100644
index 00000000000..316ef35d279
--- /dev/null
+++ b/docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md
@@ -0,0 +1,54 @@
+---
+title: "ドラッグ アンド ドロップ操作とクリップボードのサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "クリップボードのトピック, Windows フォーム"
+  - "ドラッグ アンド ドロップ"
+  - "ドラッグ アンド ドロップ, Windows フォーム"
+ms.assetid: 7cce79b6-5835-46fd-b690-73f12ad368b2
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ドラッグ アンド ドロップ操作とクリップボードのサポート
+一連のイベントを処理することで、Windows ベースのアプリケーション内でユーザーによるドラッグ アンド ドロップ操作を有効にすることができます。最も顕著なのは <xref:System.Windows.Forms.Control.DragEnter>、<xref:System.Windows.Forms.Control.DragLeave>、および <xref:System.Windows.Forms.Control.DragDrop> のイベントです。  
+  
+ 単純なメソッドの呼び出しを使用して、Windows ベースのアプリケーション内で、ユーザーの切り取り\/コピー\/貼り付けのサポートや、ユーザー データの転送を実装することもできます。  
+  
+## このセクションの内容  
+ [チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行](../../../../docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md)  
+ ドラッグ アンド ドロップ操作を開始する方法について説明します。  
+  
+ [方法 : アプリケーション間でドラッグ アンド ドロップ操作を実行する](../../../../docs/framework/winforms/advanced/how-to-perform-drag-and-drop-operations-between-applications.md)  
+ アプリケーション間でドラッグ アンド ドロップ操作を実行する方法を示しています。  
+  
+ [方法 : クリップボードにデータを追加する](../../../../docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md)  
+ プログラムを使用して、クリップボードの情報を挿入する方法について説明します。  
+  
+ [方法 : クリップボードからデータを取得する](../../../../docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md)  
+ クリップボードに保存されているデータにアクセスする方法について説明します。  
+  
+## 関連項目  
+ [Windows フォームにおけるドラッグ アンド ドロップ機能](../../../../docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md)  
+ ドラッグ アンド ドロップの動作を実装するために使用されるメソッド、イベント、およびクラスについて説明します。  
+  
+ <xref:System.Windows.Forms.Control.QueryContinueDrag>  
+ ドラッグ操作を続行するためにアクセス許可を確認する複雑なイベントについて説明します。  
+  
+ <xref:System.Windows.Forms.Control.DoDragDrop%2A>  
+ ドラッグ操作を開始するときに中心となる複雑なメソッドについて説明します。  
+  
+ <xref:System.Windows.Forms.Clipboard>  
+ 「[方法 : アクティブな MDI 子フォームにデータを送信する](http://msdn.microsoft.com/library/y0hkh2c8\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/drawing-positioning-and-cloning-images-in-gdi.md b/docs/framework/winforms/advanced/drawing-positioning-and-cloning-images-in-gdi.md
new file mode 100644
index 00000000000..538929b7e43
--- /dev/null
+++ b/docs/framework/winforms/advanced/drawing-positioning-and-cloning-images-in-gdi.md
@@ -0,0 +1,63 @@
+---
+title: "GDI+ でのイメージの描画、配置、およびクローン作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, イメージ"
+  - "描画, ラスター イメージ"
+  - "GDI+, クローン作成 (イメージの)"
+  - "GDI+, 描画 (イメージを)"
+  - "GDI+, 配置 (イメージを)"
+  - "イメージ [Windows フォーム], クローンの作成"
+  - "イメージ [Windows フォーム], 描画"
+  - "イメージ [Windows フォーム], 配置"
+  - "ラスター イメージ"
+ms.assetid: 09f0c07a-19c0-43b4-90a2-862a10545ce8
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# GDI+ でのイメージの描画、配置、およびクローン作成
+<xref:System.Drawing.Bitmap> クラスを使用して、ラスター イメージを読み込んだり表示したりできます。また、<xref:System.Drawing.Imaging.Metafile> クラスを使用して、ベクター イメージを読み込んだり表示したりできます。  <xref:System.Drawing.Bitmap> クラスおよび <xref:System.Drawing.Imaging.Metafile> クラスは、<xref:System.Drawing.Image> クラスを継承します。  ベクター イメージを表示するには、<xref:System.Drawing.Graphics> クラスのインスタンスと <xref:System.Drawing.Imaging.Metafile> が必要です。  ラスター イメージを表示するには、<xref:System.Drawing.Graphics> クラスのインスタンスと <xref:System.Drawing.Bitmap> が必要です。  <xref:System.Drawing.Graphics> クラスのインスタンスには、<xref:System.Drawing.Imaging.Metafile> または <xref:System.Drawing.Bitmap> を引数として受け取る <xref:System.Drawing.Graphics.DrawImage%2A> メソッドが用意されています。  
+  
+## ファイルの種類とクローン作成  
+ ファイル Climber.jpg から <xref:System.Drawing.Bitmap> を構築し、ビットマップを表示するコード例を次に示します。  イメージの左上隅を配置する点 \(10, 10\) は、2 番目と 3 番目のパラメーターで指定されます。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#11)]  
+  
+ このイメージを次の図に示します。  
+  
+ ![イメージ サンプル](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art04.png "AboutGdip03\_Art04")  
+  
+ BMP、GIF、JPEG、EXIF、PNG、TIFF、ICON などさまざまなグラフィックス ファイル形式から <xref:System.Drawing.Bitmap> オブジェクトを構築できます。  
+  
+ さまざまな種類のファイルから <xref:System.Drawing.Bitmap> オブジェクトを構築し、ビットマップを表示するコード例を次に示します。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#12)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#12)]  
+  
+ <xref:System.Drawing.Bitmap> クラスには、既存の <xref:System.Drawing.Bitmap> のコピーを作成するために使用できる <xref:System.Drawing.Bitmap.Clone%2A> メソッドが用意されています。  <xref:System.Drawing.Bitmap.Clone%2A> メソッドには、コピー元のビットマップでコピーする部分を指定するために使用できる四角形パラメーターがあります。  既存の <xref:System.Drawing.Bitmap> の上半分のクローンを作成して <xref:System.Drawing.Bitmap> を作成するコード例を次に示します。  次に、両方のイメージを描画します。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#13](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#13)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#13](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#13)]  
+  
+ 2 つのイメージを次の図に示します。  
+  
+ ![トリミング](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art05.png "AboutGdip03\_Art05")  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md b/docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md
new file mode 100644
index 00000000000..fde14465f3a
--- /dev/null
+++ b/docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md
@@ -0,0 +1,40 @@
+---
+title: "基本フォームの外観を変更した場合の影響 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "基本フォーム"
+  - "継承, フォーム"
+  - "継承フォーム, 変更 (基本フォームに対する)"
+  - "親フォーム"
+  - "Windows フォーム, 基本フォームの外観"
+ms.assetid: 1c3f2b29-a05c-4c6f-aa1a-4e66b94f343a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 基本フォームの外観を変更した場合の影響
+アプリケーションの開発時には、同じプロジェクト \(または他のプロジェクト\) 内の他のフォームの継承元となる、基本フォームの外観の変更が必要になることがよくあります。  
+  
+ デザイン時にプロパティ設定の変更やコントロールの追加または削除によって基本フォームの外観を変更すると、基本フォームを含むプロジェクトを作成するときに、その変更が継承先のフォームに反映されます。  基本フォームに対する変更を保存するだけでは、継承先のフォームに反映されません。  プロジェクトを作成するには、**\[ビルド\]** メニューの **\[ビルド\]** をクリックします。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+ 実行時に基本フォームに変更を加えても、既にインスタンス化された継承先のフォームには反映されません。  
+  
+## 参照  
+ [base](../Topic/base%20\(C%23%20Reference\).md)   
+ [方法 : Windows フォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-windows-forms.md)   
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/ellipses-and-arcs-in-gdi.md b/docs/framework/winforms/advanced/ellipses-and-arcs-in-gdi.md
new file mode 100644
index 00000000000..147711cfa80
--- /dev/null
+++ b/docs/framework/winforms/advanced/ellipses-and-arcs-in-gdi.md
@@ -0,0 +1,62 @@
+---
+title: "GDI+ での楕円および円弧 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "円弧"
+  - "描画, 円弧"
+  - "描画, 楕円"
+  - "楕円"
+  - "GDI+, 円弧"
+  - "GDI+, 楕円"
+ms.assetid: 34f35133-a835-4ca4-81f6-0dfedee8b683
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# GDI+ での楕円および円弧
+<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドおよび <xref:System.Drawing.Graphics.DrawArc%2A> メソッドを使用すると、楕円と円弧を簡単に描画できます。  
+  
+## 楕円の描画  
+ 楕円を描画するには、<xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトには <xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドが用意されており、<xref:System.Drawing.Pen> オブジェクトには楕円の描画に使用する線の幅や色などの属性が格納されます。  <xref:System.Drawing.Pen> オブジェクトは、引数の 1 つとして <xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドに渡されます。  <xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドに渡される他の引数は、楕円に外接する四角形を指定します。  楕円とその楕円に外接する四角形を次の図に示します。  
+  
+ ![楕円と円弧](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art05.png "Aboutgdip02\_art05")  
+  
+ 楕円を描画する例を次に示します。外接する四角形は、幅 80、高さ 40、左上隅 \(100, 50\) です。  
+  
+ [!code-csharp[LinesCurvesAndShapes#51](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#51)]
+ [!code-vb[LinesCurvesAndShapes#51](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#51)]  
+  
+ <xref:System.Drawing.Graphics.DrawEllipse%2A> は <xref:System.Drawing.Graphics> クラスのオーバーロードされたメソッドであるため、いくつかの方法でこのメソッドの引数を指定できます。  たとえば、<xref:System.Drawing.Rectangle> を構築して、その <xref:System.Drawing.Rectangle> を引数として <xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドに渡すことができます。  
+  
+ [!code-csharp[LinesCurvesAndShapes#52](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#52)]
+ [!code-vb[LinesCurvesAndShapes#52](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#52)]  
+  
+## 円弧の描画  
+ 円弧は、楕円の一部です。  円弧を描画するには、<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawArc%2A> メソッドを呼び出します。  <xref:System.Drawing.Graphics.DrawArc%2A> メソッドのパラメーターは、<xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドのパラメーターと基本的に同じです。ただし、<xref:System.Drawing.Graphics.DrawArc%2A> では開始角度とスイープ角度が必要です。  開始角度 30°、スイープ角度 180°の円弧を描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#53](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#53)]
+ [!code-vb[LinesCurvesAndShapes#53](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#53)]  
+  
+ 円弧、楕円、および外接する四角形を次の図に示します。  
+  
+ ![楕円と円弧](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art06.png "Aboutgdip02\_art06")  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)   
+ [方法 : 形状のアウトラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/encoding-and-windows-forms-globalization.md b/docs/framework/winforms/advanced/encoding-and-windows-forms-globalization.md
new file mode 100644
index 00000000000..13c2f0eda83
--- /dev/null
+++ b/docs/framework/winforms/advanced/encoding-and-windows-forms-globalization.md
@@ -0,0 +1,49 @@
+---
+title: "エンコード方式および Windows フォームのグローバリゼーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DateTimePicker コントロール [Windows フォーム], Unicode サポートのない"
+  - "グローバリゼーション [Windows フォーム], 文字セット"
+  - "ImageList コンポーネント [Windows フォーム], Unicode サポートのない"
+  - "国際対応のアプリケーション [Windows フォーム], 文字表示"
+  - "各種言語の文字"
+  - "ListView コントロール [Windows フォーム], Unicode サポートのない"
+  - "ローカリゼーション [Windows フォーム], 文字セット"
+  - "MonthCalendar コントロール [Windows フォーム], Unicode サポートのない"
+  - "ProgressBar コントロール [Windows フォーム], Unicode 対応フォーム"
+  - "StatusBar コントロール [Windows フォーム], Unicode サポートのない"
+  - "TabControl コントロール [Windows フォーム], Unicode サポートのない"
+  - "ToolBar コントロール [Windows フォーム], Unicode サポートのない"
+  - "TrackBar コントロール [Windows フォーム], Unicode サポートのない"
+  - "TreeView コントロール [Windows フォーム], Unicode サポートのない"
+  - "Unicode [Windows フォーム]"
+  - "Windows フォーム, エンコーディング"
+ms.assetid: 22e8965d-a712-42b3-8167-3ee346bd70f9
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# エンコード方式および Windows フォームのグローバリゼーション
+Windows フォーム アプリケーションは、Unicode に完全対応しているため、プラットフォーム、プログラム、または言語に関係なく、文字がそれぞれ一意の数字で表されます。  Unicode の詳細については、[Unicode コンソーシアムの Web サイト](http://www.unicode.org)を参照してください。  
+  
+## Unicode の利点  
+ Unicode 対応フォームの利点として、ヒンディー語などの Unicode 専用のスクリプトを操作できる点も含まれます。  さらに、1 つのフォームで複数の言語を使用できます。  Unicode では、すべての文字が 2 バイト長なので、2 バイト文字を表すために特別な作業は必要ありません。  また、すべてのプラットフォームで動作する 1 つのコードのセットを作成することもできます。  これは、Windows NT や [!INCLUDE[win98](../../../../includes/win98-md.md)] など、プラットフォームが異なると別のコードを作成する必要がある、以前のバージョンの [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] から変更されています。  
+  
+ ただし、[!INCLUDE[win98](../../../../includes/win98-md.md)] および Windows Millennium Edition では、特定のコントロールが Unicode をサポートしません。  これらのコントロールはすべてコモン コントロールから継承されていて、Windows コード ページで [!INCLUDE[vcpransi](../../../../includes/vcpransi-md.md)] としてデータを処理します。  これらのコントロールは、<xref:System.Windows.Forms.TabControl>、<xref:System.Windows.Forms.ListView>、<xref:System.Windows.Forms.TreeView>、<xref:System.Windows.Forms.DateTimePicker>、<xref:System.Windows.Forms.MonthCalendar>、<xref:System.Windows.Forms.TrackBar>、<xref:System.Windows.Forms.ProgressBar>、<xref:System.Windows.Forms.ImageList>、<xref:System.Windows.Forms.ToolBar>、および <xref:System.Windows.Forms.StatusBar> です。  その結果、前述のプラットフォーム上のこれらのコントロールで Unicode データを表示することはできません。  たとえば、日本語の文字を英語の [!INCLUDE[win98](../../../../includes/win98-md.md)] オペレーティング システムで表示することはできません。  
+  
+ <xref:System.Windows.Forms.ToolBar> コントロールと <xref:System.Windows.Forms.StatusBar> コントロールの Unicode 対応の代替手段として、これらの古いコントロールを置換する <xref:System.Windows.Forms.ToolStrip> コントロールと <xref:System.Windows.Forms.StatusStrip> コントロールを使用します。  アプリケーションの視覚要素の間で同様のルック アンド フィールを維持するには、メニューの表示に <xref:System.Windows.Forms.MainMenu> の代わりに <xref:System.Windows.Forms.MenuStrip> コントロールを使用します。  <xref:System.Windows.Forms.ToolStrip> と <xref:System.Windows.Forms.StatusStrip> のように、<xref:System.Windows.Forms.MenuStrip> も Unicode 文字を処理して表示することができます。  
+  
+## 参照  
+ [Windows フォームのグローバル化](../../../../docs/framework/winforms/advanced/globalizing-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/getting-started-with-graphics-programming.md b/docs/framework/winforms/advanced/getting-started-with-graphics-programming.md
new file mode 100644
index 00000000000..80533975c8d
--- /dev/null
+++ b/docs/framework/winforms/advanced/getting-started-with-graphics-programming.md
@@ -0,0 +1,74 @@
+---
+title: "グラフィックス プログラミングについて | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画"
+  - "例 [Windows フォーム], グラフィックス"
+  - "はじめに, グラフィックス プログラミング"
+  - "グラフィックス, はじめに"
+ms.assetid: eb0f6d6f-9e52-4167-9592-ff4b82fb5869
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# グラフィックス プログラミングについて
+ここでは、Windows フォーム アプリケーションで [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用する方法について概要を説明します。  以下のトピックでは、図形とテキストの描画および塗りつぶしなどのタスクを [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] で実行する方法について説明します。  
+  
+## このセクションの内容  
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)  
+ <xref:System.Drawing.Graphics> オブジェクトを作成して描画を行う方法について説明します。  
+  
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)  
+ ペンの作成方法について説明します。  
+  
+ [方法 : ペンの色を設定する](../../../../docs/framework/winforms/advanced/how-to-set-the-color-of-a-pen.md)  
+ ペンの色を設定する方法について説明します。  
+  
+ [方法 : ソリッド ブラシを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-solid-brush.md)  
+ ソリッド ブラシを作成する方法について説明します。  
+  
+ [方法 : Windows フォームに直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md)  
+ 線を描画する方法について説明します。  
+  
+ [方法 : 形状のアウトラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md)  
+ 図形を描画する方法について説明します。  
+  
+ [方法 : Windows フォームに塗りつぶした四角形を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-filled-rectangle-on-a-windows-form.md)  
+ 四角形を描画する方法について説明します。  
+  
+ [方法 : Windows フォームに塗りつぶした楕円を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-filled-ellipse-on-a-windows-form.md)  
+ 塗りつぶし楕円を描画する方法について説明します。  
+  
+ [方法 : Windows フォームにテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md)  
+ テキストを描画する方法について説明します。  
+  
+ [方法 : Windows フォームに縦書きテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-vertical-text-on-a-windows-form.md)  
+ テキストを垂直方向に描画する方法を示します。  
+  
+ [方法 : GDI\+ を使用してイメージをレンダリングする](../../../../docs/framework/winforms/advanced/how-to-render-images-with-gdi.md)  
+ イメージを描画する方法について説明します。  
+  
+ [方法 : 成型された Windows フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-shaped-windows-form.md)  
+ フォームの形状を変更する方法について説明します。  
+  
+ [方法 :ピクセルをコピーして Windows フォームのちらつきを低減する](../../../../docs/framework/winforms/advanced/how-to-copy-pixels-for-reducing-flicker-in-windows-forms.md)  
+ ある領域から別の領域にピクセルをコピーする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing>  
+ この名前空間について説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms>  
+ この名前空間について説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/global-and-local-transformations.md b/docs/framework/winforms/advanced/global-and-local-transformations.md
new file mode 100644
index 00000000000..7c48f2c14dd
--- /dev/null
+++ b/docs/framework/winforms/advanced/global-and-local-transformations.md
@@ -0,0 +1,71 @@
+---
+title: "グローバル変換とローカル変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "行列, 使用 (変換を)"
+  - "変換, global"
+  - "変換, local"
+ms.assetid: b601d66d-d572-4f11-9d2e-92f0dc8893f3
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# グローバル変換とローカル変換
+グローバル変換は、特定の <xref:System.Drawing.Graphics> オブジェクトで描画されるすべての項目に対して適用される変換です。  これに対し、ローカル変換は、描画される特定の項目に対して適用される変換です。  
+  
+## グローバル変換  
+ グローバル変換を行うには、<xref:System.Drawing.Graphics> オブジェクトを作成し、そのオブジェクトの <xref:System.Drawing.Graphics.Transform%2A> プロパティを操作します。  <xref:System.Drawing.Graphics.Transform%2A> プロパティは <xref:System.Drawing.Drawing2D.Matrix> オブジェクトであるため、連続するアフィン変換の任意の組み合わせを保持できます。  <xref:System.Drawing.Graphics.Transform%2A> プロパティに格納される変換を、ワールド変換と呼びます。  <xref:System.Drawing.Graphics> クラスには、複合ワールド変換を構築するためのメソッドとして、<xref:System.Drawing.Graphics.MultiplyTransform%2A>、<xref:System.Drawing.Graphics.RotateTransform%2A>、<xref:System.Drawing.Graphics.ScaleTransform%2A>、および <xref:System.Drawing.Graphics.TranslateTransform%2A> が用意されています。  ワールド変換の作成前に 1 回、作成後に 1 回楕円を描画する例を次に示します。  この変換では、y 方向にファクター 0.5 のスケーリング、x 方向に 50 単位の平行移動、30°の回転を順に実行します。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.CoordinateSystems#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#21)]  
+  
+ この変換で使用される行列を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art14.gif "AboutGdip05\_art14")  
+  
+> [!NOTE]
+>  上の例の楕円の回転の中心は座標系の原点で、これはクライアント領域の左上隅にあります。  この結果は、回転の中心が楕円の中心である場合とは異なります。  
+  
+## ローカル変換  
+ ローカル変換は、描画される特定の項目に対して適用されます。  たとえば、<xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトの <xref:System.Drawing.Drawing2D.GraphicsPath.Transform%2A> メソッドを使用すると、そのパスのデータ点を変換できます。  次の例は、変換せずに四角形を描画し、回転変換を実行してパスを描画します。  ワールド変換は適用されないことを前提とします。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#22)]
+ [!code-vb[System.Drawing.CoordinateSystems#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#22)]  
+  
+ さまざまな結果を得るために、ワールド変換とローカル変換を組み合わせて実行できます。  たとえば、ワールド変換を使用して座標系を変更し、新しい座標系上に描画されたオブジェクトをローカル変換を使用して回転およびスケーリングできます。  
+  
+ たとえば、クライアント領域の左端から 200 ピクセル、上端から 150 ピクセルの位置にある点を座標系の原点にするとします。  また、単位がピクセル、x 軸が右向き、y 軸が上向きであることを前提とします。  既定の座標系の y 軸は下向きであるため、水平軸を基準とした反転を実行する必要があります。  このような反転の行列を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art15.png "AboutGdip05\_art15")  
+  
+ 次に、右に 200 単位、下に 150 単位の平行移動を実行する必要があるとします。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトのワールド変換を設定することにより、上で説明した座標系を設定する例を次に示します。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#23)]
+ [!code-vb[System.Drawing.CoordinateSystems#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#23)]  
+  
+ 左下隅が新しい座標系の原点である四角形 1 つで構成されるパスを作成するコードを次に示します。このコードは、上の例の末尾に記述します。  この四角形は、ローカル変換を適用せずに 1 回、ローカル変換を適用して 1 回塗りつぶされます。  このローカル変換は、水平方向にファクター 2 のスケーリングと、それに続く 30°の回転で構成されます。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#24](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#24)]
+ [!code-vb[System.Drawing.CoordinateSystems#24](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#24)]  
+  
+ 新しい座標系と 2 つの四角形を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art16.png "AboutGdip05\_art16")  
+  
+## 参照  
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)   
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/globalizing-windows-forms.md b/docs/framework/winforms/advanced/globalizing-windows-forms.md
new file mode 100644
index 00000000000..4de3f26c99e
--- /dev/null
+++ b/docs/framework/winforms/advanced/globalizing-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "Windows フォームのグローバル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グローバル アプリケーション, 作成 (Windows フォームを)"
+  - "グローバリゼーション [Windows フォーム]"
+  - "ローカリゼーション [Windows フォーム]"
+  - "Windows フォーム, グローバリゼーション"
+  - "国際対応アプリケーション"
+ms.assetid: 72f6cd92-83be-45ec-aa37-9cb8e3ebc3c5
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームのグローバル化
+*グローバリゼーション*は、複数のロケールで機能するソフトウェア製品をデザインおよび開発するプロセスです。  
+  
+## このセクションの内容  
+ [エンコード方式および Windows フォームのグローバリゼーション](../../../../docs/framework/winforms/advanced/encoding-and-windows-forms-globalization.md)  
+ Unicode の完全なサポートとその影響について説明します。  
+  
+ [Windows フォームおよびコントロールの国際対応フォント](../../../../docs/framework/winforms/advanced/international-fonts-in-windows-forms-and-controls.md)  
+ Windows フォームで各国語の文字を表示するためのフォントを選択するタイミングと方法について説明します。  
+  
+ [ImeMode プロパティによるアジア言語の文字表示](../../../../docs/framework/winforms/advanced/display-of-asian-characters-with-the-imemode-property.md)  
+ Windows フォームまたはコントロールが受け取る入力の種類を制御するために使用する、`ImeMode` プロパティを説明しています。  
+  
+-   [チュートリアル : ClickOnce 配置 API を使用して必要に応じてサテライト アセンブリをダウンロードする](http://msdn.microsoft.com/library/ms366788\(v=vs.110\))  
+  
+-   [ClickOnce アプリケーションのローカライズ](http://msdn.microsoft.com/library/ms404266%20\(v=vs.110\))  
+  
+-   [チュートリアル : ClickOnce 配置 API を使用して必要に応じてサテライト アセンブリをダウンロードする](http://msdn.microsoft.com/library/ms404269\(v=vs.110\))  
+  
+-   [方法 : Windows フォームのグローバリゼーション用のカルチャおよび UI カルチャを設定する](http://msdn.microsoft.com/library/b28bx3bh\(v=vs.110\))  
+  
+-   [方法: ミラー化された Windows フォームおよびコントロールを作成する](http://msdn.microsoft.com/library/xwbz5ws0\(v=vs.110\))  
+  
+-   [方法 : AutoSize と TableLayoutPanel コントロールを使用して Windows フォームのローカリゼーションをサポートする](http://msdn.microsoft.com/library/1zkt8b33\(v=vs.110\))  
+  
+-   [チュートリアル : Windows フォームのローカリゼーション](http://msdn.microsoft.com/library/y99d1cd3\(v=vs.110\))  
+  
+-   [チュートリアル : ローカライズの際に均等に調整されるレイアウトの作成](http://msdn.microsoft.com/library/7k9fa71y\(v=vs.110\))  
+  
+-   [方法 : 双方向 Windows フォームのメッセージ ボックスを作成する](http://msdn.microsoft.com/library/k1689bxh\(v=vs.110\))  
+  
+-   [チュートリアル : ClickOnce 配置 API を使用して必要に応じてサテライト アセンブリをダウンロードする](http://msdn.microsoft.com/library/ms366788\(v=vs.120\))  
+  
+-   [ClickOnce アプリケーションのローカライズ](http://msdn.microsoft.com/library/ms404266%20\(v=vs.120\))  
+  
+-   [チュートリアル : ClickOnce 配置 API を使用して必要に応じてサテライト アセンブリをダウンロードする](http://msdn.microsoft.com/library/ms404269\(v=vs.120\))  
+  
+## 関連項目  
+  
+1.  [アプリケーションのグローバライズとローカライズ](http://msdn.microsoft.com/library/1021kkz0\(v=vs.110\))  
+  
+2.  [アプリケーションのグローバル化](http://msdn.microsoft.com/library/eaa7b9c0\(v=vs.110\))  
+  
+3.  [アプリケーションのグローバライズとローカライズ](http://msdn.microsoft.com/library/1021kkz0\(v=vs.120\))  
+  
+4.  [アプリケーションのグローバル化](http://msdn.microsoft.com/library/eaa7b9c0\(v=vs.120\))
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md b/docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md
new file mode 100644
index 00000000000..7c30fb6bd0d
--- /dev/null
+++ b/docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md
@@ -0,0 +1,59 @@
+---
+title: "Windows フォームにおけるグラフィックスと描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 [Windows フォーム]"
+  - "GDI+, 使用 (マネージ コードで)"
+  - "グラフィックス [Windows フォーム]"
+  - "グラフィックス, 使用 (Windows フォームで)"
+ms.assetid: 362532c5-1a06-4257-bdc8-723461009ede
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Windows フォームにおけるグラフィックスと描画
+共通言語ランタイムは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] と呼ばれる Windows グラフィックス デバイス インターフェイス \([!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)]\) の高度な実装を使用します。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して、グラフィックスの作成、テキストの描画や、グラフィカル イメージをオブジェクトとして操作することができます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] はパフォーマンスと使いやすさを提供するよう設計されています。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して、Windows フォームとコントロールのグラフィカル イメージを表示できます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を Web フォームで直接使用することはできませんが、イメージの Web サーバー コントロールからグラフィカル イメージを表示できます。  
+  
+ このセクションでは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] プログラミングの基礎を紹介するトピックが見つかります。  このセクションは、包括的なリファレンスを意図したものではありませんが、<xref:System.Drawing.Graphics>、<xref:System.Drawing.Pen>、<xref:System.Drawing.Brush>、および <xref:System.Drawing.Color> の各オブジェクトに関する情報が含まれ、図形の描画、テキストの描画、イメージの表示などのタスクを実行する方法について説明します。  詳細については、MSDN ライブラリ \(http:\/\/msdn.microsoft.com\/library\) で「GDI\+ の参照」を参照してください。  
+  
+## このセクションの内容  
+ [グラフィックスの概要](../../../../docs/framework/winforms/advanced/graphics-overview-windows-forms.md)  
+ グラフィックスに関連するマネージ クラスの概要を提供します。  
+  
+ [GDI\+ マネージ コードについて](../../../../docs/framework/winforms/advanced/about-gdi-managed-code.md)  
+ マネージ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] クラスに関する情報を提供します。  
+  
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] マネージ クラスを使用して、さまざまなタスクを完了する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Drawing>  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の基本的なグラフィックス機能を使用できるようにします。  
+  
+ <xref:System.Drawing.Drawing2D>  
+ 2 次元グラフィックスおよびベクター グラフィックス機能の詳細を提供します。  
+  
+ <xref:System.Drawing.Imaging>  
+ 高度な [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] イメージング機能を提供します。  
+  
+ <xref:System.Drawing.Text>  
+ 高度な [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] タイポグラフィ機能を提供します。  この名前空間のクラスを使用して、フォントのコレクションを作成して使用することができます。  
+  
+ <xref:System.Drawing.Printing>  
+ 印刷機能を提供します。  
+  
+## 関連項目  
+ [コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)  
+ 描画コントロールのコードを提供する方法について詳しく説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/graphics-overview-windows-forms.md b/docs/framework/winforms/advanced/graphics-overview-windows-forms.md
new file mode 100644
index 00000000000..f8a6253f61a
--- /dev/null
+++ b/docs/framework/winforms/advanced/graphics-overview-windows-forms.md
@@ -0,0 +1,57 @@
+---
+title: "グラフィックスの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, Windows フォーム"
+  - "グラフィックス"
+  - "グラフィックス, Windows フォーム"
+  - "Windows フォーム, GDI+"
+  - "Windows フォーム, グラフィックス"
+ms.assetid: 94084509-2c6f-477d-923b-d25d37a36b1c
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# グラフィックスの概要 (Windows フォーム)
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は 、デバイスに依存しないアプリケーションを作成することをプログラムが使用するグラフィック デバイス インターフェイスです。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] のサービスは、一連のマネージ クラスを使用して公開されます。  
+  
+## このセクションの内容  
+ [グラフィックスについて](../../../../docs/framework/winforms/advanced/overview-of-graphics.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の概要について説明します。  
+  
+ [グラフィックス サービスの 3 つのカテゴリ](../../../../docs/framework/winforms/advanced/three-categories-of-graphics-services.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] によるプログラミングに含まれる 3 つのカテゴリについて説明します。  
+  
+ [グラフィックス インターフェイスの構造体](../../../../docs/framework/winforms/advanced/structure-of-the-graphics-interface.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] のマネージ クラス インターフェイスについて説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing>  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] 基本グラフィックス機能へのアクセスを提供します。  
+  
+ <xref:System.Drawing.Drawing2D>  
+ 高度な 2 次元グラフィックスおよびベクター グラフィックス機能を提供します。  
+  
+ <xref:System.Drawing.Imaging>  
+ 高度な[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] イメージング機能を提供します。  
+  
+ <xref:System.Drawing.Text>  
+ 高度な [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] タイポグラフィ機能を提供します。  
+  
+ <xref:System.Drawing.Printing>  
+ 印刷に関連するサービスを提供します。  
+  
+ <xref:System.Windows.Forms.TextRenderer>  
+ [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] のテキスト描画機能、およびテキスト寸法計測機能を提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/graphics-paths-in-gdi.md b/docs/framework/winforms/advanced/graphics-paths-in-gdi.md
new file mode 100644
index 00000000000..5186916768a
--- /dev/null
+++ b/docs/framework/winforms/advanced/graphics-paths-in-gdi.md
@@ -0,0 +1,80 @@
+---
+title: "GDI+ でのグラフィックス パス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, パス"
+  - "GDI+, 描画 (パスを)"
+  - "グラフィックス, パス"
+  - "パス, 描画"
+ms.assetid: a5500dec-666c-41fd-9da3-2169dd89c5eb
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# GDI+ でのグラフィックス パス
+パスは、直線、四角形、および単純な曲線を組み合わせて作成されます。  ピクチャの描画に最も適した基本的なビルド ブロックとして次の図形を使用できることは、「[ベクター グラフィックスの概要](../../../../docs/framework/winforms/advanced/vector-graphics-overview.md)」で既に説明しました。  
+  
+-   線  
+  
+-   四角形  
+  
+-   楕円  
+  
+-   円弧  
+  
+-   多角形  
+  
+-   カーディナル スプライン  
+  
+-   ベジエ スプライン  
+  
+ GDI\+ の <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトを使用すると、複数のビルド ブロックから成るシーケンスを 1 つの単位として定義できます。  こうすると、直線、四角形、多角形、および曲線から成るシーケンス全体を <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawPath%2A> メソッドへの 1 回の呼び出しで描画できます。  直線、円弧、ベジエ スプライン、およびカーディナル スプラインを組み合わせて作成したパスを次の図に示します。  
+  
+ ![パス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art14.png "Aboutgdip02\_art14")  
+  
+## パスの使用  
+ The <xref:System.Drawing.Drawing2D.GraphicsPath> クラスには、描画される項目のシーケンスを作成するためのメソッドとして、<xref:System.Drawing.Drawing2D.GraphicsPath.AddLine%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddRectangle%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddEllipse%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddArc%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddPolygon%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddCurve%2A> \(カーディナル スプライン用\)、および <xref:System.Drawing.Drawing2D.GraphicsPath.AddBezier%2A> が用意されています。  これらの各メソッドはオーバーロードされています。つまり、各メソッドが複数の異なるパラメーター リストをサポートします。  たとえば、ある <xref:System.Drawing.Drawing2D.GraphicsPath.AddLine%2A> メソッドは 4 個の整数を受け取り、別の <xref:System.Drawing.Drawing2D.GraphicsPath.AddLine%2A> メソッドは 2 個の <xref:System.Drawing.Point> オブジェクトを受け取ります。  
+  
+ 直線、四角形、およびベジエ スプラインをパスに追加するメソッドには、1 回の呼び出しで複数の項目をパスに追加するコンパニオン メソッドである <xref:System.Drawing.Drawing2D.GraphicsPath.AddLines%2A>、<xref:System.Drawing.Drawing2D.GraphicsPath.AddRectangles%2A>、および <xref:System.Drawing.Drawing2D.GraphicsPath.AddBeziers%2A> があります。  また、<xref:System.Drawing.Drawing2D.GraphicsPath.AddCurve%2A> メソッドと <xref:System.Drawing.Drawing2D.GraphicsPath.AddArc%2A> メソッドには、閉じた曲線または扇形をパスに追加するコンパニオン メソッド <xref:System.Drawing.Drawing2D.GraphicsPath.AddClosedCurve%2A> と <xref:System.Drawing.Drawing2D.GraphicsPath.AddPie%2A> があります。  
+  
+ パスを描画するには、<xref:System.Drawing.Graphics> オブジェクト、<xref:System.Drawing.Pen> オブジェクト、および <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトは <xref:System.Drawing.Graphics.DrawPath%2A> メソッドを提供し、<xref:System.Drawing.Pen> オブジェクトはパスの描画に使用される線の幅や色などの属性を格納します。  <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトは、パスを構成する直線と曲線のシーケンスを格納します。  <xref:System.Drawing.Pen> オブジェクトと <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトは、引数として <xref:System.Drawing.Graphics.DrawPath%2A> メソッドに渡されます。  直線、楕円、およびベジエ スプラインで構成されるパスを描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#101](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#101)]
+ [!code-vb[LinesCurvesAndShapes#101](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#101)]  
+  
+ このパスを次の図に示します。  
+  
+ ![パス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art15.png "Aboutgdip02\_art15")  
+  
+ 直線、四角形、および曲線をパスに追加する以外に、パスを別のパスに追加することもできます。  こうすると、既存のパスを組み合わせて、大きい複雑なパスを作成できます。  
+  
+ [!code-csharp[LinesCurvesAndShapes#102](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#102)]
+ [!code-vb[LinesCurvesAndShapes#102](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#102)]  
+  
+ 上記以外に、文字列と扇形の 2 種類の項目をパスに追加できます。  扇形は、楕円の内部にある一部分です。  円弧、カーディナル スプライン、文字列、および扇形からパスを作成する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#103](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#103)]
+ [!code-vb[LinesCurvesAndShapes#103](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#103)]  
+  
+ このパスを次の図に示します。  パスは連続している必要はありません。円弧、カーディナル スプライン、文字列、および扇形は分離されています。  
+  
+ ![パス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art16.png "Aboutgdip02\_Art16")  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.GraphicsPath?displayProperty=fullName>   
+ <xref:System.Drawing.Point?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md b/docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md
new file mode 100644
index 00000000000..588da21fad1
--- /dev/null
+++ b/docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md
@@ -0,0 +1,40 @@
+---
+title: "Windows フォーム アプリケーションのヘルプ システム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ヘルプ, 追加 (Windows アプリケーションに)"
+  - "ヘルプ, Windows フォーム"
+  - "HelpProvider コンポーネント [Windows フォーム], 用意 (ヘルプを Windows アプリケーションに)"
+  - "ポップ ヒント ヘルプ"
+  - "Windows アプリケーション, 用意 (ヘルプ システムを)"
+ms.assetid: 2a96a278-432c-41fc-9e3c-5bfedf5e1267
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォーム アプリケーションのヘルプ システム
+アプリケーションの開発者として、ユーザーに対する最も重要な配慮の 1 つは、役に立つヘルプ システムをアプリケーションに用意することです。  操作がわからないときや、混乱したときにユーザーが頼りにするのは、ヘルプ システムです。  Windows ベースのアプリケーションには、[HelpProvider コンポーネント](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md) を使用することで簡単にヘルプ システムを用意できます。  
+  
+## さまざまな種類のヘルプ  
+ Windows フォームの <xref:System.Windows.Forms.HelpProvider> コンポーネントは、HTML Help 1.x ヘルプ ファイル \(HTML Help Workshop で生成した .chm ファイル、または .htm ファイル\) を Windows ベースのアプリケーションに関連付けるために使用します。  <xref:System.Windows.Forms.HelpProvider> コンポーネントにより、Windows フォームのコントロール、または固有のコントロールに状況依存のヘルプを用意できます。  さらに、<xref:System.Windows.Forms.HelpProvider> コンポーネントは目次、索引、検索機能のメイン ページなど、ヘルプ ファイルの特定の領域を開くことができます。  <xref:System.Windows.Forms.HelpProvider> コンポーネントに関する一般的な情報については、「[HelpProvider コンポーネントの概要](../../../../docs/framework/winforms/controls/helpprovider-component-overview-windows-forms.md)」を参照してください。  <xref:System.Windows.Forms.HelpProvider> コンポーネントを使用して Windows フォーム上にポップアップ ヘルプを表示する方法については、「[方法 : ポップアップ ヘルプを表示する](../../../../docs/framework/winforms/advanced/how-to-display-pop-up-help.md)」を参照してください。  <xref:System.Windows.Forms.ToolTip> コンポーネントを使用してコントロール固有のヘルプを表示する方法については、「[ツールヒントを使用したコントロールのヘルプ](../../../../docs/framework/winforms/advanced/control-help-using-tooltips.md)」を参照してください。  
+  
+ HTML Help Workshop で HTML Help 1.x ファイルを生成できます。  HTML Help の詳細については、MSDN の HTML Help Workshop または他の HTML Help のトピックを参照してください。  
+  
+## 参照  
+ [Windows フォームでのヘルプの統合](../../../../docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md)   
+ [HelpProvider コンポーネント](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md)   
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)   
+ [Windows フォームの概要](../../../../docs/framework/winforms/windows-forms-overview.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md b/docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md
new file mode 100644
index 00000000000..0247e88a9e4
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : クリップボードにデータを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "クリップボードのトピック, コピー (データを)"
+  - "データ [Windows フォーム], コピー (クリップボードに)"
+ms.assetid: 25152454-0e78-40a9-8a9e-a2a5a274e517
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : クリップボードにデータを追加する
+<xref:System.Windows.Forms.Clipboard> クラスには、Windows オペレーティング システムのクリップボード機能とやり取りするためのメソッドが用意されています。  クリップボードは、データの一時的なレポジトリとして多くのアプリケーションで使用されます。  たとえば、ワード プロセッサは、切り取り、貼り付けの操作でクリップボードを使用します。  クリップボードはデータをアプリケーション間で移動させるときにも使用します。  
+  
+ データをクリップボードに追加する場合にはデータ形式を指定できるため、別のアプリケーションはその形式を使用できるかどうかを判断できます。  データをさまざまな形式でクリップボードに追加することで、データを使用できるアプリケーションの数を増やすこともできます。  
+  
+ クリップボード形式は、形式を識別する文字列です。この形式を使用するアプリケーションが、関連データを取得できるようにします。  <xref:System.Windows.Forms.DataFormats> クラスにはユーザーが使用できる定義済みの形式名が含まれています。  また、独自の形式名を使用したり、オブジェクトの型を形式名として使用したりできます。  
+  
+ 1 つまたは複数の形式でデータをクリップボードに追加するには、<xref:System.Windows.Forms.Clipboard.SetDataObject%2A> メソッドを使用します。  このメソッドには任意のオブジェクトを渡すことができますが、データを複数の形式で追加するには、最初に、複数の形式で動作するようにデザインされている個別のオブジェクトにデータを追加する必要があります。  一般には、<xref:System.Windows.Forms.DataObject> にデータを追加しますが、<xref:System.Windows.Forms.IDataObject> インターフェイスを実装している任意の型を使用できます。  
+  
+ [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、基本的なクリップボード タスクを簡単に実行できるようにデザインされている新しいメソッドを使って、クリップボードにデータを直接追加できます。  これらのメソッドは、テキストなど、単一の共通形式のデータを操作するときに使用します。  
+  
+> [!NOTE]
+>  Windows ベースのアプリケーションはすべて、クリップボードを共有します。  そのため、別のアプリケーションに切り替えるとクリップボードの内容は変わります。  
+>   
+>  <xref:System.Windows.Forms.Clipboard> クラスは、シングル スレッド アパートメント \(STA: Single\-Threaded Apartment\) モードに設定されたスレッドでのみ使用できます。  このクラスを使用するには、`Main` メソッドが <xref:System.STAThreadAttribute> 属性でマークされている必要があります。  
+>   
+>  オブジェクトをクリップボードに置く場合は、オブジェクトをシリアル化する必要があります。  型をシリアル化するには、<xref:System.SerializableAttribute> 属性でマークします。  非シリアル化オブジェクトをクリップボード メソッドに渡すと、例外をスローせずにメソッドは失敗します。  シリアル化の詳細については、「<xref:System.Runtime.Serialization>」を参照してください。  
+  
+### データを単一の共通形式でクリップボードに追加するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.SetAudio%2A>、<xref:System.Windows.Forms.Clipboard.SetFileDropList%2A>、<xref:System.Windows.Forms.Clipboard.SetImage%2A>、または <xref:System.Windows.Forms.Clipboard.SetText%2A> メソッドを使用します。  これらのメソッドは [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] 以外では使用できません。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#2)]
+     [!code-vb[System.Windows.Forms.Clipboard#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#2)]  
+  
+### データをカスタム形式でクリップボードに追加するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.SetData%2A> メソッドとカスタム形式名を使用します。  このメソッドは [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] 以外では使用できません。  
+  
+     また、定義済みの形式名を指定して <xref:System.Windows.Forms.Clipboard.SetData%2A> メソッドを使用することもできます。  詳細については、「<xref:System.Windows.Forms.DataFormats>」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#3)]
+     [!code-vb[System.Windows.Forms.Clipboard#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#3)]  
+    [!code-csharp[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#100)]
+    [!code-vb[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#100)]  
+  
+### データを複数の形式でクリップボードに追加するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.SetDataObject%2A> メソッドを使用し、データを格納している <xref:System.Windows.Forms.DataObject> を渡します。  [!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] よりも前のバージョンでクリップボードにデータを追加する場合は、このメソッドを使う必要があります。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#4)]
+     [!code-vb[System.Windows.Forms.Clipboard#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#4)]  
+    [!code-csharp[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#100)]
+    [!code-vb[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#100)]  
+  
+## 参照  
+ [ドラッグ アンド ドロップ操作とクリップボードのサポート](../../../../docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md)   
+ [方法 : クリップボードからデータを取得する](../../../../docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-add-multiple-sets-of-settings-to-your-application-in-csharp.md b/docs/framework/winforms/advanced/how-to-add-multiple-sets-of-settings-to-your-application-in-csharp.md
new file mode 100644
index 00000000000..dc707997d66
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-add-multiple-sets-of-settings-to-your-application-in-csharp.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : C# のアプリケーションに複数の設定セットを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], C#"
+  - "アプリケーション設定 [Windows フォーム], 複数セット"
+ms.assetid: 45007ac6-cf07-4be7-bc38-3f0ef962faf9
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : C# のアプリケーションに複数の設定セットを追加する
+アプリケーションの中に、複数の設定セットを用意する場合があります。  たとえば、特定のグループの設定だけが頻繁に変更されると想定されるアプリケーションを開発する場合は、それらの設定を 1 つのファイルに分離しておき、他の設定に影響を与えることなく、そのファイル全体を置換できるようにすると便利です。  Visual Studio では、複数の設定セットをプロジェクトに追加できます。  追加の設定セットには、Properties.Settings オブジェクトを介してアクセスできます。  
+  
+### アプリケーションに追加の設定セットを追加するには  
+  
+1.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  **\[新しい項目の追加\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[設定ファイル\]** をクリックし、ファイルの名前を入力します。次に、**\[追加\]** をクリックして、新しい設定ファイルをソリューションに追加します。  
+  
+3.  **ソリューション エクスプローラー**で、新しい設定ファイルを **\[プロパティ\]** フォルダーにドラッグします。  これで、新しい設定をコード内で使用できます。  
+  
+4.  他の設定ファイルと同じように、このファイルに設定を追加し、ファイルの設定を使用します。  このグループの設定は、Properties.Settings オブジェクトを介してアクセスできます。  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-align-drawn-text.md b/docs/framework/winforms/advanced/how-to-align-drawn-text.md
new file mode 100644
index 00000000000..416ff2267fc
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-align-drawn-text.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 描画テキストを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト, エイリアスの使用"
+  - "Windows フォーム, 配置 (描画されたテキストを)"
+ms.assetid: 83c10a81-1a90-4b5c-98aa-2c6c4b280079
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : 描画テキストを配置する
+カスタムな描画を実行するとき、フォームまたはコントロールに描画テキストを中央揃えで配置することがよくあります。  描画テキストの配置は、<xref:System.Drawing.Graphics.DrawString%2A> メソッドまたは <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドを使用し、正しい書式設定オブジェクトの作成と適切な書式設定フラグの設定を行うことによって簡単に実行できます。  
+  
+### GDI\+ \(DrawString\) を使用して、テキストを中央揃えで描画するには  
+  
+1.  <xref:System.Drawing.StringFormat> を適切な <xref:System.Drawing.Graphics.DrawString%2A> メソッドに使用して、テキストの中央揃えを指定します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#10)]
+     [!code-vb[System.Drawing.AlignDrawnText#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#10)]  
+  
+### GDI \(DrawText\) を使用して、テキストを中央揃えで描画するには  
+  
+1.  テキストの折り返し、および垂直と水平方向の中央揃えのために、<xref:System.Windows.Forms.TextFormatFlags> 列挙値を適切な <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドに使用します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#20)]
+     [!code-vb[System.Drawing.AlignDrawnText#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#20)]  
+  
+## コードのコンパイル  
+ このコード例は Windows フォームでの使用を前提としたものであり、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [方法 : フォント ファミリとフォントを作成する](../../../../docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-apply-gamma-correction-to-a-gradient.md b/docs/framework/winforms/advanced/how-to-apply-gamma-correction-to-a-gradient.md
new file mode 100644
index 00000000000..a6fb5006fe6
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-apply-gamma-correction-to-a-gradient.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : グラデーションに対してガンマ補正を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラデーション ブラシ, ガンマ補正"
+  - "グラデーション, ガンマ補正"
+ms.assetid: da4690e7-5fac-4fd2-b3f0-5cb35c165b92
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : グラデーションに対してガンマ補正を適用する
+線形グラデーション ブラシの <xref:System.Drawing.Drawing2D.LinearGradientBrush.GammaCorrection%2A> プロパティを `true` に設定することによって、そのブラシに対するガンマ補正を有効化できます。  <xref:System.Drawing.Drawing2D.LinearGradientBrush.GammaCorrection%2A> プロパティを `false` に設定すると、ガンマ補正は無効化されます。  既定では、ガンマ補正は無効になっています。  
+  
+## 使用例  
+ 線形グラデーション ブラシを作成し、そのブラシを使用して 2 つの四角形を塗りつぶす例を示します。  最初の四角形はガンマ補正を適用せずに塗りつぶされ、2 番目の四角形はガンマ補正を適用して塗りつぶされます。  
+  
+ 2 つの塗りつぶされた四角形を次の図に示します。  ガンマ補正が適用されていない上の四角形は、中央の部分が暗くなっています。  ガンマ補正が適用されている下の四角形は、輝度がより均等化されているように見えます。  
+  
+ ![グラデーション](../../../../docs/framework/winforms/advanced/media/gammagradient1.png "gammagradient1")  
+  
+ [!code-csharp[System.Drawing.UsingaGradientBrush#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.UsingaGradientBrush#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush>   
+ [グラデーション ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md b/docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md
new file mode 100644
index 00000000000..5adf1619392
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : MDI 子フォームを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子フォーム, 配置"
+  - "MDI, 整列 (子フォームを)"
+ms.assetid: a0786378-3206-4ccc-898e-7d3b38cc5089
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : MDI 子フォームを配置する
+多くの場合、アプリケーションには、並べて表示、重ねて表示、整列など、開いている MDI 子フォームのレイアウトを制御するメニュー コマンドがあります。  <xref:System.Windows.Forms.Form.LayoutMdi%2A> メソッドと <xref:System.Windows.Forms.MdiLayout> 列挙値のいずれかを使用して、MDI 親フォーム内の子フォームを再配置することができます。  
+  
+ <xref:System.Windows.Forms.MdiLayout> 列挙値は、子フォームを重ねて表示したり、水平方向または垂直方向に並べて表示したり、または MDI フォームの下部に沿って整列された子フォーム アイコンとして表示します。  これらの値にはそれぞれ、Windows コマンドの **\[重ねて表示\]**、**\[ウィンドウを左右に並べて表示\]**、**\[ウィンドウを上下に並べて表示\]**、および **\[デスクトップを表示\]** と同じ効果があります。  
+  
+ 多くの場合、これらのメソッドは、メニュー項目の <xref:System.Windows.Forms.Control.Click> イベントで呼び出されるイベント ハンドラーとして使用されます。  このようにして、テキスト "重ねて表示" を指定したメニュー項目に、MDI 子ウィンドウに対する目的の効果を持たせることができます。  
+  
+### 子フォームを整列させるには  
+  
+1.  メソッドで、<xref:System.Windows.Forms.Form.LayoutMdi%2A> メソッドを使用して MDI 親フォームの <xref:System.Windows.Forms.MdiLayout> 列挙体を設定します。  次に、MDI 親フォーム \(`Form1`\) の子ウィンドウに <xref:System.Windows.Forms.MdiLayout?displayProperty=fullName> 列挙値を使用する例を示します。  列挙体は、**\[重ねて表示\]** メニュー項目の <xref:System.Windows.Forms.Control.Click> イベントのイベント ハンドラー内のコードで使用されます。  
+  
+    ```vb  
+    Protected Sub CascadeWindows_Click(ByVal sender As System.Object, ByVal e As System.EventArgs)  
+       Me.LayoutMdi(System.Windows.Forms.MdiLayout.Cascade)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void CascadeWindows_Click(object sender, System.EventArgs e){  
+       this.LayoutMdi(System.Windows.Forms.MdiLayout.Cascade);  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  使用する <xref:System.Windows.Forms.MdiLayout> 列挙値を変更することで、ウィンドウを並べて表示したり、ウィンドウをアイコンとして並べたりすることもできます。  
+  
+2.  Visual C\# を使用している場合は、フォームのコンストラクターに次のコードを追加して、イベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+    ```  
+  
+## 参照  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)   
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)   
+ [方法 : アクティブな MDI 子フォームにデータを送信する](../../../../docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md b/docs/framework/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md
new file mode 100644
index 00000000000..96268bbf423
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : 実行時に PrintDialog のユーザー入力をキャプチャする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷オプション"
+  - "印刷オプション, 変更 (実行時に)"
+  - "印刷 [Windows フォーム], オプション"
+  - "実行時に, 変更 (印刷オプションを)"
+ms.assetid: 438501d8-9a70-4fb3-aae6-e46579aba0c6
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : 実行時に PrintDialog のユーザー入力をキャプチャする
+印刷に関連するオプションはデザイン時に設定できますが、多くの場合ユーザーの選択によって、実行時にこれらのオプションの変更が必要となることがあります。  <xref:System.Windows.Forms.PrintDialog> コンポーネントと <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用して、文書を印刷するユーザー入力をキャプチャできます。  
+  
+### 印刷オプションをプログラムで変更するには  
+  
+1.  フォームに <xref:System.Windows.Forms.PrintDialog> コンポーネントと <xref:System.Drawing.Printing.PrintDocument> コンポーネントを追加します。  
+  
+2.  <xref:System.Windows.Forms.PrintDialog> の <xref:System.Windows.Forms.PrintDialog.Document%2A> プロパティをフォームに追加した <xref:System.Drawing.Printing.PrintDocument> に設定します。  
+  
+    ```vb  
+    PrintDialog1.Document = PrintDocument1  
+  
+    ```  
+  
+    ```csharp  
+    printDialog1.Document = PrintDocument1;  
+  
+    ```  
+  
+    ```cpp  
+    printDialog1->Document = PrintDocument1;  
+    ```  
+  
+3.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用して <xref:System.Windows.Forms.PrintDialog> コンポーネントを表示します。  
+  
+    ```vb  
+    PrintDialog1.ShowDialog()  
+  
+    ```  
+  
+    ```csharp  
+    printDialog1.ShowDialog();  
+  
+    ```  
+  
+    ```cpp  
+    printDialog1->ShowDialog();  
+    ```  
+  
+4.  ダイアログ ボックスでユーザーが選択した内容は、<xref:System.Drawing.Printing.PrintDocument> コンポーネントの <xref:System.Drawing.Printing.PrinterSettings> プロパティにコピーされます。  
+  
+## 参照  
+ [方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md)   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md b/docs/framework/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md
new file mode 100644
index 00000000000..20e6d1caf78
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : アプリケーション セッション間で設定値を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], アプリケーション セッション間"
+  - "アプリケーション設定 [Windows フォーム], 変更"
+ms.assetid: 1a85911f-97b2-476c-930b-83379edd890c
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : アプリケーション セッション間で設定値を変更する
+アプリケーションのコンパイルと配置後に、アプリケーション セッション間で設定値を変更する場合があります。  たとえば、接続文字列が適切なデータベースの場所を指すように変更します。  設計時に使用したツールは、アプリケーションをコンパイルして配置した後は使用できないので、ファイル内の設定値を手動で変更する必要があります。  
+  
+### アプリケーション セッション間で設定値を変更するには  
+  
+1.  Microsoft メモ帳などのテキスト エディターまたは XML エディターを使用して、アプリケーションに関連付けらている .config ファイルを開きます。  
+  
+2.  変更する設定のエントリを探します。  それは、次の例に似ています。  
+  
+    ```  
+    <setting name="Setting1" serializeAs="String" >  
+       <value>My Setting Value</value>  
+    </setting>  
+    ```  
+  
+3.  新しい設定値を入力し、ファイルを保存します。  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md b/docs/framework/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md
new file mode 100644
index 00000000000..8ff324f3656
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 設計時に既存の設定の値を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], 変更"
+  - "アプリケーション設定 [Windows フォーム], デザイン時"
+ms.assetid: 5da91272-ad7e-49e7-9d1f-eb64439a1e4d
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 設計時に既存の設定の値を変更する
+Visual Studio を使用して、プロジェクト内の既存の設定の値を編集できます。  
+  
+### C\# での設計時に既存の設定の値を変更するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクトの **\[プロパティ\]** ノードを展開します。  
+  
+2.  新しい設定を追加する .settings ファイルをダブルクリックします。  このファイルの既定の名前は Settings.settings です。  
+  
+3.  設定デザイナーで、値を変更する設定を見つけ、\[値\] 列に新しい値を入力します。  
+  
+### Visual Basic での設計時に既存の設定の値を変更するには  
+  
+1.  **ソリューション エクスプローラー** で、プロジェクト ノードを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[プロパティ\]** ページの **\[設定\]** タブをクリックします。  
+  
+3.  設定デザイナーで、値を変更する設定を見つけ、\[値\] 列に新しい値を入力します。  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [方法 : 設計時に新しい設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md b/docs/framework/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md
new file mode 100644
index 00000000000..dc2f82655b4
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md
@@ -0,0 +1,118 @@
+---
+title: "方法 : Windows フォームでユーザーのコンピューターに接続されたプリンターを選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷 [Windows フォーム], プリンターの選択"
+  - "プリンター, 選択"
+ms.assetid: 63c1172b-2931-4ac0-953f-37f629494bbf
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォームでユーザーのコンピューターに接続されたプリンターを選択する
+既定のプリンター以外のプリンターに印刷することがよくあります。<xref:System.Windows.Forms.PrintDialog> コンポーネントを使用すると、現在インストールされているプリンターからユーザーに選択させることができます。<xref:System.Windows.Forms.PrintDialog> コンポーネントでは、<xref:System.Windows.Forms.PrintDialog> コンポーネントの <xref:System.Windows.Forms.DialogResult> がキャプチャされ、プリンターの選択に使用されます。  
+  
+ 次の手順では、既定のプリンターに印刷するテキスト ファイルを選択します。<xref:System.Windows.Forms.PrintDialog> クラスがインスタンス化されます。  
+  
+### プリンターを選択してファイルを印刷するには  
+  
+1.  <xref:System.Windows.Forms.PrintDialog> コンポーネントを使用して、使用するプリンターを選択します。  
+  
+     次のコード例では、2 つのイベントを処理しています。 最初の <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントでは、<xref:System.Windows.Forms.PrintDialog>クラスがインスタンス化され、ユーザーが選択したプリンターが <xref:System.Windows.Forms.DialogResult> プロパティでキャプチャされます。  
+  
+     2 番目の <xref:System.Drawing.Printing.PrintDocument> コンポーネントの <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントでは、サンプル ドキュメントが指定されたプリンターに印刷されます。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles Button1.Click  
+       Dim PrintDialog1 As New PrintDialog()  
+       PrintDialog1.Document = PrintDocument1  
+       Dim result As DialogResult = PrintDialog1.ShowDialog()  
+  
+       If (result = DialogResult.OK) Then  
+         PrintDocument1.Print()  
+       End If   
+  
+    End Sub  
+  
+    Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage  
+       e.Graphics.FillRectangle(Brushes.Red, New Rectangle(500, 500, 500, 500))          
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       PrintDialog printDialog1 = new PrintDialog();  
+       printDialog1.Document = printDocument1;  
+       DialogResult result = printDialog1.ShowDialog();  
+       if (result == DialogResult.OK)  
+       {  
+          printDocument1.Print();  
+       }  
+    }  
+  
+    private void printDocument1_PrintPage(object sender,   
+    System.Drawing.Printing.PrintPageEventArgs e)  
+    {  
+       e.Graphics.FillRectangle(Brushes.Red,   
+         new Rectangle(500, 500, 500, 500));  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          PrintDialog ^ printDialog1 = gcnew PrintDialog();  
+          printDialog1->Document = printDocument1;  
+          System::Windows::Forms::DialogResult result =   
+             printDialog1->ShowDialog();  
+          if (result == DialogResult::OK)  
+          {  
+             printDocument1->Print();  
+          }  
+       }  
+    private:  
+       void printDocument1_PrintPage(System::Object ^ sender,  
+          System::Drawing::Printing::PrintPageEventArgs ^ e)  
+       {  
+          e->Graphics->FillRectangle(Brushes::Red,  
+             Rectangle(500, 500, 500, 500));  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを追加して、イベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.printDocument1.PrintPage += new  
+       System.Drawing.Printing.PrintPageEventHandler  
+       (this.printDocument1_PrintPage);  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->printDocument1->PrintPage += gcnew  
+       System::Drawing::Printing::PrintPageEventHandler  
+       (this, &Form1::printDocument1_PrintPage);  
+    this->button1->Click += gcnew  
+       System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-complete-windows-forms-print-jobs.md b/docs/framework/winforms/advanced/how-to-complete-windows-forms-print-jobs.md
new file mode 100644
index 00000000000..6e5bff367da
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-complete-windows-forms-print-jobs.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : Windows フォームの印刷ジョブを完了する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷ジョブ, 完了 (Windows フォームで)"
+  - "印刷 [Windows フォーム], 印刷ジョブ"
+ms.assetid: 23ec74f7-34c5-4710-82a0-ee2914518548
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : Windows フォームの印刷ジョブを完了する
+印刷ジョブを伴うワード プロセッサやその他のアプリケーションでは、多くの場合、印刷ジョブが完了したというメッセージをユーザーに表示するオプションが用意されています。  <xref:System.Drawing.Printing.PrintDocument> コンポーネントの <xref:System.Drawing.Printing.PrintDocument.EndPrint> イベントを処理することによって、Windows フォームにこの機能を用意できます。  
+  
+ 次の手順では、<xref:System.Drawing.Printing.PrintDocument> コンポーネントのある Windows ベースのアプリケーションを作成している必要があります。これは Windows ベースのアプリケーションからの印刷を有効にする標準的な方法です。  <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用した Windows フォームからの印刷の詳細については、「[方法 : 標準の Windows フォーム印刷ジョブを作成する](../../../../docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md)」を参照してください。  
+  
+### 印刷ジョブを完了するには  
+  
+1.  <xref:System.Drawing.Printing.PrintDocument> コンポーネントの <xref:System.Drawing.Printing.PrintDocument.DocumentName%2A> プロパティを設定します。  
+  
+    ```vb  
+    PrintDocument1.DocumentName = "MyTextFile"  
+  
+    ```  
+  
+    ```csharp  
+    printDocument1.DocumentName = "MyTextFile";  
+  
+    ```  
+  
+    ```cpp  
+    printDocument1->DocumentName = "MyTextFile";  
+    ```  
+  
+2.  <xref:System.Drawing.Printing.PrintDocument.EndPrint> イベントを処理するコードを記述します。  
+  
+     次のコード例では、ドキュメントの印刷が完了したことを示すメッセージ ボックスが表示されます。  
+  
+    ```vb  
+    Private Sub PrintDocument1_EndPrint(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintEventArgs) Handles PrintDocument1.EndPrint  
+       MessageBox.Show(PrintDocument1.DocumentName + " has finished printing.")  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void printDocument1_EndPrint(object sender,   
+    System.Drawing.Printing.PrintEventArgs e)  
+    {  
+       MessageBox.Show(printDocument1.DocumentName +   
+          " has finished printing.");  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void printDocument1_EndPrint(System::Object ^ sender,  
+          System::Drawing::Printing::PrintEventArgs ^ e)  
+       {  
+          MessageBox::Show(String::Concat(printDocument1->DocumentName,  
+             " has finished printing."));  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.printDocument1.EndPrint += new  
+       System.Drawing.Printing.PrintEventHandler  
+       (this.printDocument1_EndPrint);  
+  
+    ```  
+  
+    ```cpp  
+    this->printDocument1->EndPrint += gcnew  
+       System::Drawing::Printing::PrintEventHandler  
+       (this, &Form1::printDocument1_EndPrint);  
+    ```  
+  
+## 参照  
+ <xref:System.Drawing.Printing.PrintDocument>   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md b/docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md
new file mode 100644
index 00000000000..bc64b26e60b
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : フォント ファミリとフォントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント ファミリ, 構築"
+  - "フォント, 構築"
+ms.assetid: d3a4a223-9492-4b54-9afd-db1c31c3cefd
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : フォント ファミリとフォントを作成する
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、スタイルは異なってもタイプフェイスが同じフォントを、フォント ファミリにグループ化しています。  たとえば、Arial フォント ファミリには次のフォントが含まれます。  
+  
+-   Arial 標準  
+  
+-   Arial 太字  
+  
+-   Arial 斜体  
+  
+-   Arial 太字斜体  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、標準、太字、斜体、太字斜体の 4 つのスタイルがファミリに含まれます。  "*narrow*" や "*rounded*" などの形容詞は、スタイルではなく、ファミリ名の一部と見なされます。  たとえば、Arial Narrow は、次のようなメンバーで構成されるフォント ファミリです。  
+  
+-   Arial Narrow 標準  
+  
+-   Arial Narrow 太字  
+  
+-   Arial Narrow 斜体  
+  
+-   Arial Narrow 太字斜体  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] でテキストを描画するには、事前に <xref:System.Drawing.FontFamily> オブジェクトと <xref:System.Drawing.Font> オブジェクトを作成しておく必要があります。  <xref:System.Drawing.FontFamily> オブジェクトが Arial などのタイプフェイスを指定し、<xref:System.Drawing.Font> オブジェクトがサイズ、スタイル、および単位を指定します。  
+  
+## 使用例  
+ 標準スタイルの Arial フォントを 16 ピクセルのサイズで作成する例を次に示します。  次のコードでは、<xref:System.Drawing.Font.%23ctor%2A> コンストラクターに渡される最初の引数は <xref:System.Drawing.FontFamily> オブジェクトです。  2 番目の引数は、フォントのサイズを 4 番目の引数で識別される単位で指定します。  3 番目の引数は、スタイルを識別します。  
+  
+ <xref:System.Drawing.GraphicsUnit> は <xref:System.Drawing.GraphicsUnit> 列挙体のメンバーで、<xref:System.Drawing.FontStyle> は <xref:System.Drawing.FontStyle> 列挙体のメンバーです。  
+  
+ [!code-csharp[System.Drawing.FontsAndText#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#61)]
+ [!code-vb[System.Drawing.FontsAndText#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#61)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-convert-a-bmp-image-to-a-png-image.md b/docs/framework/winforms/advanced/how-to-convert-a-bmp-image-to-a-png-image.md
new file mode 100644
index 00000000000..5ba9149accc
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-convert-a-bmp-image-to-a-png-image.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : BMP イメージから PNG イメージへの変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BMP イメージ, 変換 (PNG に)"
+  - "イメージ形式, 変換"
+ms.assetid: 9d4a692d-73ac-4ce3-9e05-9ec321e8fbd6
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : BMP イメージから PNG イメージへの変換
+多くの場合、1 つのイメージ ファイル形式から別の形式に変換します。  この変換は、<xref:System.Drawing.Image> クラスの <xref:System.Drawing.Image.Save%2A> のメソッドを呼び出して、必要なイメージ ファイル形式に対して <xref:System.Drawing.Imaging.ImageFormat> を指定することで簡単に実行できます。  
+  
+## 使用例  
+ 次の例では、型から BMP イメージを読み込み、PNG 形式で画像を保存します。  
+  
+ [!code-csharp[UsingImageEncodersDecoders#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#4)]
+ [!code-vb[UsingImageEncodersDecoders#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#4)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   Windows フォーム アプリケーション  
+  
+-   `System.Drawing.Imaging` 名前空間への参照  
+  
+## 参照  
+ [方法 : インストールされたエンコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-encoders.md)   
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)   
+ [ビットマップの種類](../../../../docs/framework/winforms/advanced/types-of-bitmaps.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-copy-and-paste-an-elementhost-control-at-design-time.md b/docs/framework/winforms/advanced/how-to-copy-and-paste-an-elementhost-control-at-design-time.md
new file mode 100644
index 00000000000..6aaaaf22447
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-copy-and-paste-an-elementhost-control-at-design-time.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : デザイン時に ElementHost コントロールをコピーして貼り付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ElementHost コントロール, コピーと貼り付け (デザイン時に)"
+  - "相互運用性 [WPF]"
+  - "Windows フォーム, コンテンツのコピーと貼り付け"
+  - "WPF ユーザー コントロール, ホスト (Windows フォームで)"
+ms.assetid: e570375d-2a68-44ba-b4f7-c781af2d20e8
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : デザイン時に ElementHost コントロールをコピーして貼り付ける
+ここでは、Windows Presentation Foundation \(WPF\) コントロールを Windows フォームにコピーする方法について説明します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時に ElementHost コントロールをコピーして貼り付けるには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> を Windows フォーム プロジェクトに追加します。  名前はこのコントロール型の既定である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  **\[プロパティ\]** ウィンドウで、`UserControl1` の <xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+3.  <xref:System.Windows.Controls.Control.Background%2A> プロパティの値を `Blue` に設定します。  
+  
+4.  プロジェクトをビルドします。  
+  
+5.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+6.  **\[ツールボックス\]** から `UserControl1` のインスタンスをフォームにドラッグします。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+7.  `elementHost1` が選択された状態で Ctrl キーを押しながら C キーを押して、クリップボードにコピーします。  
+  
+8.  Ctrl キーを押しながら V キーを押して、コピーしたコントロールをフォームに貼り付けます。  
+  
+     `elementHost2` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールがフォームに作成されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [チュートリアル : ElementHost コントロールの別の Windows フォームへのコピーと貼り付け](../../../../docs/framework/winforms/advanced/copy--paste-an-elementhost-control-into-forms.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-copy-pixels-for-reducing-flicker-in-windows-forms.md b/docs/framework/winforms/advanced/how-to-copy-pixels-for-reducing-flicker-in-windows-forms.md
new file mode 100644
index 00000000000..a9fcac6cf34
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-copy-pixels-for-reducing-flicker-in-windows-forms.md
@@ -0,0 +1,77 @@
+---
+title: "方法 :ピクセルをコピーして Windows フォームのちらつきを低減する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビット ブロック転送"
+  - "bitblt"
+  - "ちらつき"
+  - "ちらつき, 低減 (Windows フォーム内の)"
+  - "グラフィックス, コピー"
+  - "グラフィックス, 低減 (ちらつきを)"
+  - "ピクセル, コピー"
+ms.assetid: 33b76910-13a3-4521-be98-5c097341ae3b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 :ピクセルをコピーして Windows フォームのちらつきを低減する
+単純なグラフィックをアニメーション化する場合、ちらつきやその他の望ましくない視覚効果が生じる可能性があります。  この問題を抑制する 1 つの方法は、グラフィックに対して "BitBlt" プロセスを使用することです。  BitBlt とは、転送元のピクセルの四角形から転送先のピクセルの四角形へカラー データを "ビット ブロック転送" することです。  
+  
+ Windows フォームでは、BitBlt は <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.CopyFromScreen%2A> メソッドを使用して行われます。  メソッドの各パラメーターに、転送元と転送先 \(頂点\)、コピーする領域のサイズ、および新しい形状の描画に使用するグラフィックス オブジェクトを指定します。  
+  
+ 次の例では、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラー内でフォーム上に形状を描画します。  次に、<xref:System.Drawing.Graphics.CopyFromScreen%2A> メソッドを使用してその形状を複製します。  
+  
+> [!NOTE]
+>  フォームの <xref:System.Windows.Forms.Control.DoubleBuffered%2A> プロパティを `true` に設定すると、<xref:System.Windows.Forms.Control.Paint> イベント内にあるグラフィックス ベースのコードがダブル バッファー化されます。  以下のコードを使用しても明確なパフォーマンスの向上は見られませんが、より複雑なグラフィックス操作コードを使用する場合には、この設定が重要になります。  
+  
+## 使用例  
+  
+```vb  
+Private Sub Form1_Paint(ByVal sender As Object, ByVal e As _  
+    System.Windows.Forms.PaintEventArgs) Handles MyBase.Paint  
+    ' Draw a circle with a bar on top.  
+        e.Graphics.FillEllipse(Brushes.DarkBlue, New Rectangle _  
+             (10, 10, 60, 60))  
+        e.Graphics.FillRectangle(Brushes.Khaki, New Rectangle _  
+             (20, 30, 60, 10))  
+    ' Copy the graphic to a new location.  
+        e.Graphics.CopyFromScreen(New Point(10, 10), New Point _  
+             (100, 100), New Size(70, 70))  
+End Sub  
+  
+```  
+  
+```csharp  
+private void Form1_Paint(System.Object sender,  
+    System.Windows.Forms.PaintEventArgs e)  
+        {  
+        e.Graphics.FillEllipse(Brushes.DarkBlue, new  
+            Rectangle(10,10,60,60));  
+        e.Graphics.FillRectangle(Brushes.Khaki, new  
+            Rectangle(20,30,60,10));  
+        e.Graphics.CopyFromScreen(new Point(10, 10), new Point(100, 100),   
+            new Size(70, 70));  
+}  
+```  
+  
+## コードのコンパイル  
+ 上のコードは、フォームの再描画時にグラフィックスが保持されるように、フォームの <xref:System.Windows.Forms.Control.Paint> イベント ハンドラー内で実行されます。  したがって、<xref:System.Windows.Forms.Form.Load> イベント ハンドラー内ではグラフィックス関連のメソッドを呼び出さないようにします。呼び出すと、フォームをサイズ変更したり、フォームが他のフォームによって隠されたりしている場合に、内容が再描画されなくなります。  
+  
+## 参照  
+ <xref:System.Drawing.CopyPixelOperation>   
+ <xref:System.Drawing.Graphics.FillRectangle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A?displayProperty=fullName>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-bitmap-at-run-time.md b/docs/framework/winforms/advanced/how-to-create-a-bitmap-at-run-time.md
new file mode 100644
index 00000000000..b5b3936f8bb
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-bitmap-at-run-time.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 実行時にビットマップを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ, 作成"
+  - "ビットマップ, 例 [Visual Basic]"
+ms.assetid: 737bae30-e599-4e1d-bf30-bab8280b32be
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 実行時にビットマップを作成する
+この例は、<xref:System.Drawing.Bitmap> オブジェクトを作成して図形を描画し、既存の Windows フォーム <xref:System.Windows.Forms.PictureBox> コントロールに表示します。  
+  
+## 使用例  
+ [!code-csharp[System.Drawing.CreateBitmapAtRuntime#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CreateBitmapAtRuntime/CS/Form1.cs#1)]
+ [!code-vb[System.Drawing.CreateBitmapAtRuntime#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CreateBitmapAtRuntime/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System、System.Drawing、System.Windows.Forms の各アセンブリをインポートする Windows フォーム。  
+  
+## 参照  
+ <xref:System.Drawing.Bitmap>   
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-linear-gradient.md b/docs/framework/winforms/advanced/how-to-create-a-linear-gradient.md
new file mode 100644
index 00000000000..0c85a93d9dc
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-linear-gradient.md
@@ -0,0 +1,88 @@
+---
+title: "方法 : 線形グラデーションを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 作成 (線形グラデーションを)"
+  - "グラデーション"
+  - "グラデーション, 作成 (線形)"
+  - "線形グラデーション, 作成"
+ms.assetid: 6c88e1cc-1217-4399-ac12-cb37592b9f01
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 線形グラデーションを作成する
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、水平方向、垂直方向、および対角線方向の線形グラデーションをサポートしています。  既定では、線形グラデーションの色は均等に変化していきます。  しかし、線形グラデーションをカスタマイズして、色が不均等に変化していくようにすることもできます。  
+  
+ 直線、楕円、および四角形を水平方向の線形グラデーション ブラシで塗りつぶす例を次に示します。  
+  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush.%23ctor%2A> コンストラクターは、4 つの引数として 2 つの点と 2 つの色を受け取ります。  最初の点 \(0, 10\) は最初の色 \(赤\) に関連付けられており、2 番目の点 \(200, 10\) は 2 番目の色 \(青\) に関連付けられています。  想定されるとおり、\(0, 10\) から \(200, 10\) へと描画された直線は、赤から青に段階的に変化していきます。  
+  
+ 点 \(50, 10\) と点 \(200, 10\) の座標内の 10 という値そのものは重要ではありません。  ここで重要なのは、2 つの点の 2 番目の座標が同じであること、つまり 2 つの点を結ぶ直線が水平であるということです。  楕円と四角形も水平方向の座標値が 0 から 200 に移動するにつれて、赤から青に段階的に変化していきます。  
+  
+ これらの直線、楕円、および四角形を次の図に示します。  水平方向の座標値が 200 を超えた場合は、同じグラデーション パターンが繰り返し適用されます。  
+  
+ ![線形グラデーション](../../../../docs/framework/winforms/advanced/media/cslineargradient1.png "cslineargradient1")  
+  
+### 水平方向の線形グラデーションを使用するには  
+  
+-   3 番目および 4 番目の引数として、それぞれ不透明な赤および不透明な青を渡します。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#21)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#21)]  
+  
+ 上の例では、水平方向の座標値が 0 から 200 に移動するにつれて、色の要素が線形に変化していきます。  たとえば、最初の座標が 0 から 200 までの間にある点は、青の要素も 0 から 255 までの間にあります。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、色がグラデーションの一方の端からもう一方の端へ向かって変化していくようすを調整できます。  黒から赤に変化するグラデーション ブラシを次の表に基づいて作成する場合を考えます。  
+  
+|水平方向の座標|RGB コンポーネント|  
+|-------------|-----------------|  
+|0|\(0, 0, 0\)|  
+|40|\(128, 0, 0\)|  
+|200|\(255, 0, 0\)|  
+  
+ 水平方向の座標が 0 から 200 までの値の 20% にしか満たない値のときに、赤の要素の輝度が既に最大値の半分になっています。  
+  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush> オブジェクトの <xref:System.Drawing.Drawing2D.LinearGradientBrush.Blend%2A> プロパティを設定して、3 つの相対的な輝度値を 3 つの相対位置に関連付ける例を次に示します。  上の表で示したように、相対的な輝度値 0.5 を相対位置 0.2 に関連付けます。  このコードは、楕円および四角形をグラデーション ブラシで塗りつぶします。  
+  
+ 結果として得られた楕円と四角形を次の図に示します。  
+  
+ ![線形グラデーション](../../../../docs/framework/winforms/advanced/media/cslineargradient2.png "cslineargradient2")  
+  
+### 線形グラデーションをカスタマイズするには  
+  
+-   3 番目および 4 番目の引数として、それぞれ不透明な黒および不透明な赤を渡します。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#22)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#22)]  
+  
+ 上の例のグラデーションは水平方向であり、つまり、水平線に沿って移動するにつれて色が段階的に変化していきました。  垂直方向のグラデーションと対角線方向のグラデーションも定義できます。  
+  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush.%23ctor%2A> コンストラクターに点 \(0, 0\) と点 \(200, 100\) を渡す例を次に示します。  青色は点 \(0, 0\) に関連付けられており、緑色は点 \(200, 100\) に関連付けられています。  直線 \(ペン幅が 10\) と楕円が、線形グラデーション ブラシで塗りつぶされます。  
+  
+ これらの直線と楕円を次の図に示します。  点 \(0, 0\) から点 \(200, 100\) を結ぶ直線と平行な直線に沿って移動するにつれて、楕円内の色が段階的に変化しています。  
+  
+ ![線形グラデーション](../../../../docs/framework/winforms/advanced/media/cslineargradient3.png "cslineargradient3")  
+  
+### 対角線方向の線形グラデーションを作成するには  
+  
+-   3 番目および 4 番目の引数として、それぞれ不透明な青および不透明な緑を渡します。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#23)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#23)]  
+  
+## 参照  
+ [グラデーション ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md b/docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md
new file mode 100644
index 00000000000..1cf79ae1f13
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 設計時に新しい設定を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], 作成"
+  - "アプリケーション設定 [Windows フォーム], デザイン時"
+ms.assetid: c5d60a66-6507-462f-a81f-e3bc0a804e16
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 設計時に新しい設定を作成する
+設定デザイナーを使用して、設計時に新しい設定を作成できます。  設定デザイナーは、新しい設定を作成して各設定のプロパティを指定できるグリッド スタイルのインターフェイスです。  新しい設定には、名前、値、種類、およびスコープを指定する必要があります。  作成した設定は、コード内でアクセスできます。  
+  
+### 設計時に C\# で新しい設定を作成するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクトの **\[プロパティ\]** ノードを展開します。  
+  
+2.  新しい設定を追加する .settings ファイルをダブルクリックします。  このファイルの既定の名前は Settings.settings です。  
+  
+3.  設定デザイナーで、設定の名前、値、種類、およびスコープを設定します。  各行が 1 つの設定を表します。  
+  
+### 設計時に Visual Basic で新しい設定を作成するには  
+  
+1.  **ソリューション エクスプローラー** で、プロジェクト ノードを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **\[プロパティ\]** ページの **\[設定\]** タブをクリックします。  
+  
+3.  設定デザイナーで、設定の名前、値、種類、およびスコープを設定します。  各行が 1 つの設定を表します。  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [方法 : 設計時に既存の設定の値を変更する](../../../../docs/framework/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-path-gradient.md b/docs/framework/winforms/advanced/how-to-create-a-path-gradient.md
new file mode 100644
index 00000000000..8d79587f956
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-path-gradient.md
@@ -0,0 +1,118 @@
+---
+title: "方法 : パス グラデーションを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラデーション, 作成 (パスを)"
+  - "グラフィックス パス, 作成 (グラデーションを)"
+  - "パス グラデーション, 作成"
+ms.assetid: 1948e834-e104-481c-b71d-d8aa9e4d106e
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : パス グラデーションを作成する
+<xref:System.Drawing.Drawing2D.PathGradientBrush> クラスを使用すると、図形を塗りつぶすときの段階的な色の変化をカスタマイズできます。  たとえば、パスの中心に 1 つの色を指定し、パスの境界に別の色を指定できます。  また、パスの境界上にある点ごとに個別の色を指定することもできます。  
+  
+> [!NOTE]
+>  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] におけるパスとは、<xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトによって維持される連続した複数の直線と曲線のことです。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] パスの詳細については、「[GDI\+ でのグラフィックス パス](../../../../docs/framework/winforms/advanced/graphics-paths-in-gdi.md)」、および「[パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)」を参照してください。  
+  
+### パス グラデーションを使用して楕円を塗りつぶすには  
+  
+-   パス グラデーション ブラシで楕円を塗りつぶす例を次に示します。  中心の色が青に設定され、境界の色が明るい緑青に設定されています。  塗りつぶされた楕円を次の図に示します。  
+  
+     ![グラデーション パス](../../../../docs/framework/winforms/advanced/media/pathgradient1.png "pathgradient1")  
+  
+     既定では、パス グラデーション ブラシはパスの境界の外側には拡張されません。  パス グラデーション ブラシを使用して、パスの境界の外側まで図を塗りつぶす場合、パスの外側にある画面領域は塗りつぶされません。  
+  
+     次のコードの <xref:System.Drawing.Graphics.FillEllipse%2A> の呼び出しを `e.Graphics.FillRectangle(pthGrBrush, 0, 10, 200, 40)` に変更した場合に実行される処理を、次の図に示します。  
+  
+     ![グラデーション パス](../../../../docs/framework/winforms/advanced/media/pathgradient2.png "pathgradient2")  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#11)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#11)]  
+  
+     このコード例は Windows フォームでの使用を前提としたものであり、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> が必要です。  
+  
+### 境界上の点を指定するには  
+  
+-   星型のパスからパス グラデーション ブラシを生成する例を次に示します。  このコードでは、星型の重心の色として赤を指定するように <xref:System.Drawing.Drawing2D.PathGradientBrush.CenterColor%2A> プロパティを設定します。  次に、<xref:System.Drawing.Drawing2D.PathGradientBrush.SurroundColors%2A> プロパティを設定して、`points` 配列内の個々の点に、`colors` 配列に格納されているさまざまな色を指定します。  最後のコード ステートメントは、星型のパスをパス グラデーション ブラシで塗りつぶします。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#12)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#12)]  
+  
+-   コード内で <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトを使用せずに、パス グラデーションを描画する例を次に示します。  この例で使用されている特定の <xref:System.Drawing.Drawing2D.PathGradientBrush.%23ctor%2A> コンストラクターは点の配列を受け取りますが、<xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトは必要としません。  また、<xref:System.Drawing.Drawing2D.PathGradientBrush> は、パスではなく四角形を塗りつぶすために使用されています。  この四角形は、ブラシを定義するために使用した閉じたパスよりも大きいため、四角形の一部はブラシによって塗りつぶされていません。  四角形 \(点線\) とパス グラデーション ブラシによって塗りつぶされた四角形部分を次の図に示します。  
+  
+     ![グラデーション](../../../../docs/framework/winforms/advanced/media/gradient4.png "gradient4")  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#13](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#13)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#13](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#13)]  
+  
+### パス グラデーションをカスタマイズするには  
+  
+-   パス グラデーション ブラシをカスタマイズする方法の 1 つとして、そのブラシの <xref:System.Drawing.Drawing2D.PathGradientBrush.FocusScales%2A> プロパティを設定する方法があります。  フォーカス スケールは、メイン パスの内側にある内部パスを指定します。  中心の色は、中心点だけでなく、この内部パスの内側すべてに適用されます。  
+  
+     楕円のパスに基づいてパス グラデーション ブラシを作成する例を次に示します。  このコードでは、境界の色を青に設定し、中心の色を明るい緑青に設定してから、パス グラデーション ブラシで楕円のパスを塗りつぶします。  
+  
+     次に、パス グラデーション ブラシのフォーカス スケールを設定します。  x フォーカス スケールは 0.3 に、y フォーカス スケールは 0.8 に設定します。  このコードは、<xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.TranslateTransform%2A> メソッドを呼び出して、続けて呼び出す <xref:System.Drawing.Graphics.FillPath%2A> では最初の楕円の右側にある楕円を塗りつぶすようにします。  
+  
+     フォーカス スケールの効果を確認するために、小さな楕円がメインの楕円と中心を共有すると想定してみます。  小さな \(内部\) 楕円は、メインの楕円を水平方向に 0.3、垂直方向に 0.8 の係数を適用して縮小した図形です。  外側の楕円の境界から内側の楕円の境界に移動するにつれて、色が青から明るい緑青に段階的に変化していきます。  内側の楕円の境界から共有の中心へと移動しても、色は明るい緑青のままです。  
+  
+     次のコードによる出力を次の図に示します。  左側の楕円は、中心点だけが明るい緑青になっています。  右側の楕円は、内側のパスの内部すべてが明るい緑青になっています。  
+  
+ ![グラデーション](../../../../docs/framework/winforms/advanced/media/focusscales1nogamma.png "focusscales1NoGamma")  
+  
+ [!code-csharp[System.Drawing.UsingaGradientBrush#14](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#14)]
+ [!code-vb[System.Drawing.UsingaGradientBrush#14](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#14)]  
+  
+### 補間を使用してカスタマイズするには  
+  
+-   パス グラデーション ブラシをカスタマイズする別の方法として、補間色の配列と補間位置の配列を指定する方法もあります。  
+  
+     三角形に基づいてパス グラデーション ブラシを作成する例を次に示します。  このコードは、パス グラデーション ブラシの <xref:System.Drawing.Drawing2D.PathGradientBrush.InterpolationColors%2A> プロパティを設定して、補間色の配列 \(濃い緑、明るい緑青、青\) と補間位置の配列 \(0, 0.25, 1\) を指定します。  三角形の境界から中心点に移動するにつれて、色が濃い緑から明るい緑青へ、さらに明るい緑青から青へと変化していきます。  濃い緑から明るい緑青への変化は、濃い緑から青までの距離の 25% の部分で発生します。  
+  
+     このカスタム パス グラデーション ブラシで塗りつぶされた三角形を次の図に示します。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#15](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#15)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#15](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#15)]  
+  
+### 中心点を設定するには  
+  
+-   既定では、パス グラデーション ブラシの中心点は、ブラシを作成するために使用したパスの重心になります。  <xref:System.Drawing.Drawing2D.PathGradientBrush> クラスの <xref:System.Drawing.Drawing2D.PathGradientBrush.CenterPoint%2A> プロパティを設定することによって、中心点の位置を変更できます。  
+  
+     楕円に基づいてパス グラデーション ブラシを作成する例を次に示します。  この楕円の中心は \(70, 35\) ですが、パス グラデーション ブラシの中心点は \(120, 40\) に設定されています。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#16](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#16)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#16](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#16)]  
+  
+     塗りつぶされた楕円とパス グラデーション ブラシの中心点を次の図に示します。  
+  
+     ![グラデーション パス](../../../../docs/framework/winforms/advanced/media/pathgradient5.png "pathgradient5")  
+  
+-   パス グラデーション ブラシの中心点をそのブラシを作成するために使用したパスの外側の位置に設定することもできます。  前のコードの <xref:System.Drawing.Drawing2D.PathGradientBrush.CenterPoint%2A> プロパティを設定するための呼び出しを置換する例を次に示します。  
+  
+     [!code-csharp[System.Drawing.UsingaGradientBrush#17](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/CS/Class1.cs#17)]
+     [!code-vb[System.Drawing.UsingaGradientBrush#17](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingaGradientBrush/VB/Class1.vb#17)]  
+  
+     この変更による出力を次の図に示します。  
+  
+     ![グラデーション パス](../../../../docs/framework/winforms/advanced/media/pathgradient6.png "pathgradient6")  
+  
+     上の図では、楕円の右端にある点の色は、青にきわめて近い色ですが、純粋な青ではありません。  グラデーション内の色は、塗りつぶしが点 \(145, 35\) にまで達し、その点が純粋な青 \(0, 0, 255\) になるように配置されます。  しかし、パス グラデーション ブラシはそのパスの内側しか塗りつぶさないため、実際の塗りつぶしが点 \(145, 35\) まで達することはありません。  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [グラデーション ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-pen.md b/docs/framework/winforms/advanced/how-to-create-a-pen.md
new file mode 100644
index 00000000000..8b07fd204f7
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-pen.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ペンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, 作成 (ペンを)"
+  - "Pen オブジェクト"
+  - "ペン, 作成"
+ms.assetid: 7fbea8b7-7ac1-4413-9c17-733a850381e3
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ペンを作成する
+<xref:System.Drawing.Pen> オブジェクトを作成する例を次に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#3](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#3)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#3)]
+ [!code-vb[System.Drawing.ConceptualHowTos#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#3)]  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.Drawing.Pen> オブジェクトなど、システム リソースを消費するオブジェクトについては、使用後に <xref:System.Drawing.Pen.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.Pen>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [GDI\+ でのペン、直線、および四角形](../../../../docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-private-font-collection.md b/docs/framework/winforms/advanced/how-to-create-a-private-font-collection.md
new file mode 100644
index 00000000000..f337f018617
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-private-font-collection.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : プライベート フォント コレクションを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント, 作成 (プライベート コレクションを)"
+  - "プライベート フォント コレクション, 作成"
+ms.assetid: 6533d5e5-a8dc-4b76-9fc4-3bf75c8b9212
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : プライベート フォント コレクションを作成する
+<xref:System.Drawing.Text.PrivateFontCollection> クラスは、<xref:System.Drawing.Text.FontCollection> 抽象基本クラスを継承します。  <xref:System.Drawing.Text.PrivateFontCollection> オブジェクトを使用して、アプリケーションに固有のフォント セットを維持できます。  プライベート フォント コレクションには、インストールされているシステム フォントだけでなく、コンピューターにインストールされていないフォントを含むことができます。  プライベート フォント コレクションにフォント ファイルを追加するには、<xref:System.Drawing.Text.PrivateFontCollection> オブジェクトの <xref:System.Drawing.Text.PrivateFontCollection.AddFontFile%2A> メソッドを呼び出します。  
+  
+ <xref:System.Drawing.Text.PrivateFontCollection> オブジェクトの <xref:System.Drawing.Text.FontCollection.Families%2A> プロパティは、<xref:System.Drawing.FontFamily> オブジェクトの配列を格納します。  
+  
+ プライベート フォント コレクション内のフォント ファミリの数は、そのコレクションに追加されたフォント ファイルの数と必ずしも同じではありません。  たとえば、ArialBd.tff、Times.tff、TimesBd.tff の各ファイルをコレクションに追加するとします。  コレクション内には 3 つのファイルがありますが、Times.tff と TimesBd.tff は同じファミリに属しているため、コレクション内のファミリ数は 2 つだけになります。  
+  
+## 使用例  
+ 次の 3 つのフォント ファイルを <xref:System.Drawing.Text.PrivateFontCollection> オブジェクトに追加する例を次に示します。  
+  
+-   C:\\*systemroot*\\Fonts\\Arial.tff \(Arial、標準\)  
+  
+-   C:\\*systemroot*\\Fonts\\CourBI.tff \(Courier New、太字斜体\)  
+  
+-   C:\\*systemroot*\\Fonts\\TimesBd.tff \(Times New Roman、太字\)  
+  
+ このコードは、<xref:System.Drawing.Text.PrivateFontCollection> オブジェクトの <xref:System.Drawing.Text.FontCollection.Families%2A> プロパティから <xref:System.Drawing.FontFamily> オブジェクトの配列を取得します。  
+  
+ このコードはコレクション内の <xref:System.Drawing.FontFamily> オブジェクトごとに <xref:System.Drawing.FontFamily.IsStyleAvailable%2A> メソッドを呼び出し、各種のスタイル \(標準、太字、斜体、太字斜体、下線、および取り消し線\) を使用できるかどうかを確認します。  <xref:System.Drawing.FontFamily.IsStyleAvailable%2A> メソッドに渡される引数は、<xref:System.Drawing.FontStyle> 列挙体のメンバーです。  
+  
+ 特定のファミリとスタイルの組み合わせを使用できる場合、<xref:System.Drawing.Font> オブジェクトはそのファミリとスタイルを使用して作成されます。  別の形式の <xref:System.Drawing.Font.%23ctor%2A> コンストラクターの場合、最初に渡される引数は <xref:System.Drawing.FontFamily> オブジェクトですが、この <xref:System.Drawing.Font.%23ctor%2A> コンストラクターに渡される最初の引数はフォント ファミリ名です。  <xref:System.Drawing.Font> オブジェクトが作成されると、そのオブジェクトが <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawString%2A> メソッドに渡され、ファミリ名と一緒にスタイルの名前が表示されます。  
+  
+ 下記のコードによる出力の例を次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/csfontstext7.png "csfontstext7")  
+  
+ 次のコード例でプライベート フォント コレクションに追加されている Arial.tff は、Arial 標準スタイルのフォント ファイルです。  しかし、プログラム出力では、Arial フォント ファミリについて標準以外にも使用できるスタイルがいくつか示されています。  これは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] で、標準スタイルから太字、斜体、および太字斜体の各スタイルをシミュレートできるためです。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、標準スタイルを基に下線および取り消し線を生成することもできます。  
+  
+ 同様に、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、太字スタイルまたは斜体スタイルから太字斜体スタイルをシミュレートできます。  プログラム出力には、TimesBd.tff \(Times New Roman 太字\) がコレクション内の唯一の Times ファイルである場合も、Times ファミリの太字斜体スタイルを使用できることが示されます。  
+  
+ [!code-csharp[System.Drawing.FontsAndText#51](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#51)]
+ [!code-vb[System.Drawing.FontsAndText#51](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#51)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Text.PrivateFontCollection>   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-shaped-windows-form.md b/docs/framework/winforms/advanced/how-to-create-a-shaped-windows-form.md
new file mode 100644
index 00000000000..fd744b10487
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-shaped-windows-form.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : 成型された Windows フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 変更 (形を)"
+  - "フォーム, 円形"
+  - "フォーム, カスタムの形"
+  - "フォーム, 四角形以外"
+  - "フォーム, 角の丸い"
+  - "成型されたフォーム"
+  - "Windows フォーム, 円形"
+  - "Windows フォーム, カスタムの形"
+  - "Windows フォーム, 四角形以外の形状"
+  - "Windows フォーム, 角の丸い"
+  - "Windows フォーム, 成型された"
+ms.assetid: 6e6041e0-8e67-4487-b1e9-e410dbd1ef6c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 成型された Windows フォームを作成する
+この例は、フォームと共にサイズ変更する楕円形をフォームに設定します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#10](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#10)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#10)]
+ [!code-vb[System.Drawing.ConceptualHowTos#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#10)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   <xref:System.Windows.Forms> 名前空間および <xref:System.Drawing> 名前空間への参照。  
+  
+ 次のコード例では、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドし、フォームの形状を変更します。  このコードを使用するには、メソッド宣言と共にメソッド内の描画コードをコピーします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ <xref:System.Drawing.Region>   
+ <xref:System.Drawing>   
+ <xref:System.Drawing.Drawing2D.GraphicsPath.AddEllipse%2A>   
+ <xref:System.Windows.Forms.Control.Region%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-a-solid-brush.md b/docs/framework/winforms/advanced/how-to-create-a-solid-brush.md
new file mode 100644
index 00000000000..3bc5ea0322f
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-a-solid-brush.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : ソリッド ブラシを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ブラシ, 作成 (ソリッド)"
+  - "ブラシ, 例"
+  - "純色のブラシ"
+ms.assetid: 85c3fe7d-fb1d-4591-8a9f-d75b556b90af
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ソリッド ブラシを作成する
+<xref:System.Drawing.Graphics> オブジェクトが図形の塗りつぶしに使用できる <xref:System.Drawing.SolidBrush> オブジェクトを作成する例を次に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#1)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#1)]
+ [!code-vb[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#1)]  
+  
+## 信頼性の高いプログラミング  
+ ブラシ オブジェクトなど、システム リソースを消費するオブジェクトについては、使用後に <xref:System.IDisposable.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.SolidBrush>   
+ <xref:System.Drawing.Brush>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [GDI\+ でのブラシと塗りつぶされた図形](../../../../docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md)   
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-application-settings.md b/docs/framework/winforms/advanced/how-to-create-application-settings.md
new file mode 100644
index 00000000000..643d2cd763f
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-application-settings.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : アプリケーション設定を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定, 作成"
+  - "アプリケーション設定, Windows フォーム"
+ms.assetid: 1e7aa347-af75-41e5-89ca-f53cab704f72
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : アプリケーション設定を作成する
+マネージ コードを使用することにより、新しいアプリケーション設定を作成し、フォームまたはフォームのコントロールのプロパティにバインドして、これらの設定が実行時に自動的に読み込まれて保存されるようにすることができます。  
+  
+ 次の手順では、<xref:System.Configuration.ApplicationSettingsBase> から派生するラッパー クラスを手動で作成します。  このクラスには、公開する各アプリケーション設定に対して、パブリックにアクセスできるプロパティを追加します。  
+  
+ また、Visual Studio デザイナーで最小限のコードを使用してこの手順を実行することもできます。  「[方法 : デザイナーを使用してアプリケーション設定を作成する](http://msdn.microsoft.com/library/wabtadw6\(v=vs.110\))」も参照してください。  
+  
+### 新しいアプリケーション設定をプログラムで作成するには  
+  
+1.  プロジェクトに新しいクラスを追加して、名前を変更します。  この手順では、このクラスを  `MyUserSettings` と呼びます。  クラスの派生元が <xref:System.Configuration.ApplicationSettingsBase> になるようクラス定義を変更します。  
+  
+2.  必要な各アプリケーション設定のこのラッパー クラスでプロパティを定義し、設定のスコープに応じて、そのプロパティを <xref:System.Configuration.ApplicationScopedSettingAttribute> または <xref:System.Configuration.UserScopedSettingAttribute> のいずれかを使用して適用します。  設定のスコープの詳細については、「[アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)」を参照してください。  ここまでで、コードは次のようになります。  
+  
+     [!code-csharp[ApplicationSettings.Create#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Create/CS/MyAppSettings.cs#1)]
+     [!code-vb[ApplicationSettings.Create#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Create/VB/MyAppSettings.vb#1)]  
+  
+3.  アプリケーションでこのラッパー クラスのインスタンスを作成します。  これは、一般的にはメイン フォームのプライベート メンバーです。  クラスを定義したので、それをプロパティにバインドする必要があります。この場合は、フォームの <xref:System.Windows.Forms.Form.BackColor%2A> プロパティです。  これは、フォームの  `Load`  イベント ハンドラーで実行できます。  
+  
+     [!code-csharp[ApplicationSettings.Create#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Create/CS/Form1.cs#2)]
+     [!code-vb[ApplicationSettings.Create#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Create/VB/Form1.vb#2)]  
+  
+4.  実行時に設定を変更する方法を提供する場合は、フォームを閉じるときにユーザーの現在の設定をディスクに保存する必要があります。そうしないと、これらの変更が失われます。  
+  
+     [!code-csharp[ApplicationSettings.Create#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ApplicationSettings.Create/CS/Form1.cs#3)]
+     [!code-vb[ApplicationSettings.Create#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ApplicationSettings.Create/VB/Form1.vb#3)]  
+  
+     これで、新しいアプリケーション設定を正常に作成し、指定されたプロパティにバインドしました。  
+  
+## .NET Framework セキュリティ  
+ 既定の設定プロバイダーの <xref:System.Configuration.LocalFileSettingsProvider> は、情報をプレーン テキストとして構成ファイルに保存します。  これにより、セキュリティがオペレーティング システムが現在のユーザーに対して提供するファイル アクセスのセキュリティに制限されます。  このため、構成ファイルに保存される情報に注意する必要があります。  たとえば、アプリケーション設定の一般的な用途の 1 つとして、アプリケーションのデータ ストアをポイントする接続文字列を格納します。  ただし、セキュリティの問題があるため、このような文字列にパスワードは含まれません。  接続文字列の詳細については、「<xref:System.Configuration.SpecialSetting>」を参照してください。  
+  
+## 参照  
+ <xref:System.Configuration.SpecialSettingAttribute>   
+ <xref:System.Configuration.LocalFileSettingsProvider>   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [方法 : アプリケーション設定を検証する](../../../../docs/framework/winforms/advanced/how-to-validate-application-settings.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-figures-from-lines-curves-and-shapes.md b/docs/framework/winforms/advanced/how-to-create-figures-from-lines-curves-and-shapes.md
new file mode 100644
index 00000000000..31f4881a585
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-figures-from-lines-curves-and-shapes.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 直線、曲線、および形状から図形を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "図形, 作成 (直線から)"
+  - "図形, 作成 (形状から)"
+ms.assetid: 82fd56c7-b443-4765-9b7c-62ce030656ec
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 直線、曲線、および形状から図形を作成する
+図形を作成するには、<xref:System.Drawing.Drawing2D.GraphicsPath> を作成し、<xref:System.Drawing.Drawing2D.GraphicsPath.AddLine%2A> や <xref:System.Drawing.Drawing2D.GraphicsPath.AddCurve%2A> などのメソッドを呼び出して、パスにプリミティブを追加します。  
+  
+## 使用例  
+ 次のコード例では、図形を含むパスを作成します。  
+  
+-   1 番目の例では、1 つの図形から成るパスを作成します。  この図形は、1 つの円弧から成ります。  この円弧のスイープ角度は \-180°であり、既定の座標系では、これは反時計回りに計測された角度です。  
+  
+-   2 番目の例では、2 つの図形から成るパスを作成します。  最初の図形では、円弧の後に直線が続いています。  2 番目の図形では、直線の後に曲線が続き、さらにその後に直線が続いています。  最初の図形は開いたままで、2 番目の図形は閉じています。  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingPaths#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.ConstructingDrawingPaths#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/VB/Class1.vb#21)]  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingPaths#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/CS/Class1.cs#22)]
+ [!code-vb[System.Drawing.ConstructingDrawingPaths#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/VB/Class1.vb#22)]  
+  
+## コードのコンパイル  
+ 前の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.GraphicsPath>   
+ [パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md b/docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md
new file mode 100644
index 00000000000..bbe7abc336a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md
@@ -0,0 +1,189 @@
+---
+title: "方法 : 描画する Graphics オブジェクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, 作成 (イメージを)"
+  - "グラフィックス [Windows フォーム], 作成"
+  - "Graphics クラス"
+  - "イメージ [Windows フォーム], 作成"
+ms.assetid: 162861f9-f050-445e-8abb-b2c43a918b8b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 描画する Graphics オブジェクトを作成する
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して線や形状の描画、テキストのレンダリング、イメージの表示と操作などを行うには、<xref:System.Drawing.Graphics> オブジェクトを作成する必要があります。  <xref:System.Drawing.Graphics> オブジェクトは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の描画サーフェイスを表し、グラフィカル イメージの作成に使用します。  
+  
+ グラフィックスの操作には 2 つの手順があります。  
+  
+1.  <xref:System.Drawing.Graphics> オブジェクトを構築する。  
+  
+2.  <xref:System.Drawing.Graphics> オブジェクトを使用して、線や形状の描画、テキストのレンダリング、またはイメージの表示と操作を実行する。  
+  
+## Graphics オブジェクトの作成  
+ グラフィックス オブジェクトはさまざまな方法で作成できます。  
+  
+#### グラフィックス オブジェクトを作成するには  
+  
+-   グラフィックス オブジェクトへの参照を、フォームまたはコントロールの <xref:System.Windows.Forms.Control.Paint> イベントの <xref:System.Windows.Forms.PaintEventArgs> の一部として受け取ります。  これは、コントロールの描画コードを作成するときにグラフィックス オブジェクトへの参照を取得するための一般的な方法です。  同様に、<xref:System.Drawing.Printing.PrintDocument> の <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントを処理するときに、<xref:System.Drawing.Printing.PrintPageEventArgs> のプロパティとしてグラフィックス オブジェクトとして取得することもできます。  
+  
+     または  
+  
+-   コントロールまたはフォームの <xref:System.Windows.Forms.Control.CreateGraphics%2A> メソッドを呼び出して、そのコントロールまたはフォームの描画サーフェイスを表す <xref:System.Drawing.Graphics> オブジェクトへの参照を取得します。  このメソッドは、既に存在するフォームまたはコントロール上に描画する場合に使用します。  
+  
+     または  
+  
+-   <xref:System.Drawing.Image> を継承する任意のオブジェクトから <xref:System.Drawing.Graphics> オブジェクトを作成します。  この方法は、既存のイメージを変更する場合に便利です。  
+  
+     これらのそれぞれの方法について、以降で詳しく説明します。  
+  
+## Paint イベント ハンドラーの PaintEventArgs  
+ コントロールの <xref:System.Windows.Forms.PaintEventHandler>、または <xref:System.Drawing.Printing.PrintDocument> の <xref:System.Drawing.Printing.PrintDocument.PrintPage> をプログラミングする場合、グラフィックス オブジェクトが <xref:System.Windows.Forms.PaintEventArgs> または <xref:System.Drawing.Printing.PrintPageEventArgs> のプロパティの 1 つとして用意されています。  
+  
+#### Paint イベントの PaintEventArgs から Graphics オブジェクトへの参照を取得するには  
+  
+1.  <xref:System.Drawing.Graphics> オブジェクトを宣言します。  
+  
+2.  <xref:System.Windows.Forms.PaintEventArgs> の一部として渡された <xref:System.Drawing.Graphics> オブジェクトを参照する変数を割り当てます。  
+  
+3.  フォームまたはコントロールを描画するコードを挿入します。  
+  
+     <xref:System.Windows.Forms.Control.Paint> イベントの <xref:System.Windows.Forms.PaintEventArgs> から <xref:System.Drawing.Graphics> オブジェクトを参照する方法を次の例に示します。  
+  
+    ```vb  
+    Private Sub Form1_Paint(sender As Object, pe As PaintEventArgs) Handles _  
+       MyBase.Paint  
+       ' Declares the Graphics object and sets it to the Graphics object  
+       ' supplied in the PaintEventArgs.  
+       Dim g As Graphics = pe.Graphics  
+       ' Insert code to paint the form here.  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void Form1_Paint(object sender,   
+       System.Windows.Forms.PaintEventArgs pe)   
+    {  
+       // Declares the Graphics object and sets it to the Graphics object  
+       // supplied in the PaintEventArgs.  
+       Graphics g = pe.Graphics;  
+       // Insert code to paint the form here.  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void Form1_Paint(System::Object ^ sender,  
+          System::Windows::Forms::PaintEventArgs ^ pe)  
+       {  
+          // Declares the Graphics object and sets it to the Graphics object  
+          // supplied in the PaintEventArgs.  
+          Graphics ^ g = pe->Graphics;  
+          // Insert code to paint the form here.  
+       }  
+    ```  
+  
+## CreateGraphics メソッド  
+ コントロールまたはフォームの <xref:System.Windows.Forms.Control.CreateGraphics%2A> メソッドを使用して、そのコントロールまたはフォームの描画サーフェイスを表す <xref:System.Drawing.Graphics> オブジェクトへの参照を取得することもできます。  
+  
+#### CreateGraphics メソッドで Graphics オブジェクトを作成するには  
+  
+-   グラフィックをレンダリングするフォームまたはコントロールの <xref:System.Windows.Forms.Control.CreateGraphics%2A> メソッドを呼び出します。  
+  
+    ```vb  
+    Dim g as Graphics  
+    ' Sets g to a Graphics object representing the drawing surface of the  
+    ' control or form g is a member of.  
+    g = Me.CreateGraphics  
+  
+    ```  
+  
+    ```csharp  
+    Graphics g;  
+    // Sets g to a graphics object representing the drawing surface of the  
+    // control or form g is a member of.  
+    g = this.CreateGraphics();  
+  
+    ```  
+  
+    ```cpp  
+    Graphics ^ g;  
+    // Sets g to a graphics object representing the drawing surface of the  
+    // control or form g is a member of.  
+    g = this->CreateGraphics();  
+    ```  
+  
+## Image オブジェクトからの作成  
+ <xref:System.Drawing.Image> クラスから派生した任意のオブジェクトからグラフィックス オブジェクトを作成することもできます。  
+  
+#### Image から Graphics オブジェクトを作成するには  
+  
+-   <xref:System.Drawing.Graphics.FromImage%2A?displayProperty=fullName> オブジェクトの作成元となる Image 変数の名前を指定して、<xref:System.Drawing.Graphics> メソッドを呼び出します。  
+  
+     <xref:System.Drawing.Bitmap> オブジェクトを使用する方法を次の例に示します。  
+  
+    ```vb  
+    Dim myBitmap as New Bitmap("C:\Documents and Settings\Joe\Pics\myPic.bmp")  
+    Dim g as Graphics = Graphics.FromImage(myBitmap)  
+  
+    ```  
+  
+    ```csharp  
+    Bitmap myBitmap = new Bitmap(@"C:\Documents and   
+       Settings\Joe\Pics\myPic.bmp");  
+    Graphics g = Graphics.FromImage(myBitmap);  
+  
+    ```  
+  
+    ```cpp  
+    Bitmap ^ myBitmap = gcnew  
+       Bitmap("D:\\Documents and Settings\\Joe\\Pics\\myPic.bmp");  
+    Graphics ^ g = Graphics::FromImage(myBitmap);  
+    ```  
+  
+> [!NOTE]
+>  <xref:System.Drawing.Graphics> オブジェクトを作成できるのは、16 ビット .bmp ファイル、24 ビット .bmp ファイル、32 ビット .bmp ファイルなどの、インデックスのない .bmp ファイルからだけです。  インデックスのない .bmp ファイルの各ピクセルは色を保持します。これに対して、インデックス付き .bmp ファイルのピクセルはカラー テーブルに対するインデックスを保持します。  
+  
+## 形状およびイメージの描画と操作  
+ 作成した <xref:System.Drawing.Graphics> オブジェクトを使用して、線や形状の描画、テキストのレンダリング、およびイメージの表示と操作を行うことができます。  <xref:System.Drawing.Graphics> オブジェクトと一緒に使用される主要なオブジェクトを次に示します。  
+  
+-   <xref:System.Drawing.Pen> クラス \- 線の描画、形状のアウトラインの作成、またはその他の幾何学表現に使用します。  
+  
+-   <xref:System.Drawing.Brush> クラス \- 形状、イメージ、テキストの塗りつぶしなど、グラフィック領域の塗りつぶしに使用します。  
+  
+-   <xref:System.Drawing.Font> クラス \- テキストのレンダリング時に使用する形状についての説明を提供します。  
+  
+-   <xref:System.Drawing.Color> 構造体 \- 各種の表示色を表します。  
+  
+#### 作成した Graphics オブジェクトを使用するには  
+  
+-   上記のオブジェクトを使用して目的の項目を描画します。  
+  
+     詳細については、次のトピックを参照してください。  
+  
+    |レンダリング対象|参照項目|  
+    |--------------|----------|  
+    |線|[方法 : Windows フォームに直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md)|  
+    |図形|[方法 : 形状のアウトラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md)|  
+    |テキスト|[方法 : Windows フォームにテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md)|  
+    |\[イメージ\]|[方法 : GDI\+ を使用してイメージをレンダリングする](../../../../docs/framework/winforms/advanced/how-to-render-images-with-gdi.md)|  
+  
+## 参照  
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : GDI\+ を使用してイメージをレンダリングする](../../../../docs/framework/winforms/advanced/how-to-render-images-with-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md b/docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md
new file mode 100644
index 00000000000..43d1baab6a8
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md
@@ -0,0 +1,121 @@
+---
+title: "方法 : MDI 子フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子フォーム"
+  - "MDI, 作成 (フォームを)"
+ms.assetid: 164b69bb-2eca-4339-ada3-0679eb2c6dda
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : MDI 子フォームを作成する
+MDI 子フォームは、ユーザー操作の中心であるため、[マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)の重要な要素です。  
+  
+ 次の手順では、ほとんどのワード プロセッシング アプリケーションに似ている <xref:System.Windows.Forms.RichTextBox> コントロールを表示する MDI 子フォームを作成します。  <xref:System.Windows.Forms> コントロールを、<xref:System.Windows.Forms.DataGridView> コントロールやコントロールを組み合わせたその他のコントロールで置き換えることで、さまざまな可能性のある MDI 子ウィンドウ \(およびその拡張としての MDI アプリケーション\) を作成できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### MDI 子フォームを作成するには  
+  
+1.  新しい Windows フォーム プロジェクトを作成します。  フォームの **\[プロパティ\] ウィンドウ**で、<xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定し、`WindowsState` プロパティを `Maximized` に設定します。  
+  
+     これによって、フォームが子ウィンドウの MDI コンテナーとして指定されます。  
+  
+2.  `Toolbox` から、<xref:System.Windows.Forms.MenuStrip> コントロールをフォームにドラッグします。  `Text` プロパティを **\[ファイル\]** に設定します。  
+  
+3.  **\[項目\]** プロパティの隣にある省略記号 \(...\) をクリックして、**\[追加\]** をクリックし、2 つの子ツール ストリップのメニュー項目を追加します。  これらの項目の `Text` プロパティを **\[新規\]** と **\[ウィンドウ\]** に設定します。  
+  
+4.  **\[ソリューション エクスプローラー\]** で、プロジェクトを右クリックして、**\[追加\]** をポイントし、**\[新しい項目の追加\]** を選択します。  
+  
+5.  **\[新しい項目の追加\]** ダイアログ ボックスで、**\[テンプレート\]** ペインから **\[Windows フォーム\]** \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] 内\) または **\[Windows フォーム アプリケーション \(.NET\)\]** \([!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] 内\) を選択します。  **\[名前\]** ボックスで、フォーム Form2 の名前を付けます。  **\[開く\]** ボタンをクリックして、フォームをプロジェクトに追加します。  
+  
+    > [!NOTE]
+    >  この手順で作成した、MDI 子フォームは、標準の Windows フォームです。  そのため、フォームの透明度を制御できる <xref:System.Windows.Forms.Form.Opacity%2A> プロパティを持っています。  ただし、<xref:System.Windows.Forms.Form.Opacity%2A> プロパティは最上位レベルのウィンドウ用に設計されています。  描画に関する問題が発生する可能性があるため、MDI 子フォームと共に使用しないでください。  
+  
+     このフォームは、MDI 子フォーム用のテンプレートになります。  
+  
+     **Windows フォーム デザイナー**が開き、Form2 を表示します。  
+  
+6.  **\[ツールボックス\]** から、**\[RichTextBox\]** コントロールをフォームにドラッグします。  
+  
+7.  **\[プロパティ\]** ウィンドウで、`Anchor` プロパティを **\[上、左\]** に設定し、`Dock` プロパティを **\[塗りつぶし\]** に設定します。  
+  
+     これにより、フォームがサイズ変更された場合でも、<xref:System.Windows.Forms.RichTextBox> コントロールが MDI 子フォームの領域を完全に塗りつぶします。  
+  
+8.  **\[新規\]** メニュー項目をダブルクリックして、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーを作成します。  
+  
+9. ユーザーが **\[新規\]** メニュー項目をクリックしたときに新しい MDI 子フォームを作成するには、次のようなコードを挿入します。  
+  
+    > [!NOTE]
+    >  次の例では、イベント ハンドラーが `MenuItem2` の <xref:System.Windows.Forms.Control.Click> イベントを処理します。  アプリケーションのアーキテクチャの仕様によっては、**\[新規\]** メニュー項目が `MenuItem2` でない可能性があります。  
+  
+    ```vb  
+    Protected Sub MDIChildNew_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MenuItem2.Click  
+       Dim NewMDIChild As New Form2()  
+       'Set the Parent Form of the Child window.  
+       NewMDIChild.MdiParent = Me  
+       'Display the new form.  
+       NewMDIChild.Show()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void MDIChildNew_Click(object sender, System.EventArgs e){  
+       Form2 newMDIChild = new Form2();  
+       // Set the Parent Form of the Child window.  
+       newMDIChild.MdiParent = this;  
+       // Display the new form.  
+       newMDIChild.Show();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void menuItem2_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          Form2^ newMDIChild = gcnew Form2();  
+          // Set the Parent Form of the Child window.  
+          newMDIChild->MdiParent = this;  
+          // Display the new form.  
+          newMDIChild->Show();  
+       }  
+    ```  
+  
+     [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] で、次の `#include` ディレクティブを Form1.h の先頭に追加します。  
+  
+    ```cpp  
+    #include "Form2.h"  
+    ```  
+  
+10. **\[プロパティ\]** ウィンドウの上部にあるドロップダウンリストで、**\[ファイル\]** メニュー ストリップに該当するメニュー ストリップを選択し、<xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A> プロパティを Window <xref:System.Windows.Forms.ToolStripMenuItem> に設定します。  
+  
+     これにより、**\[ウィンドウ\]** メニューで開いている MDI 子ウィンドウと、アクティブな子ウィンドウの横にチェック マークが付いている一覧が維持されます。  
+  
+11. F5 キーを押してアプリケーションを実行します。  **\[ファイル\]** メニューから **\[新規\]** を選択して、**\[ウィンドウ\]** メニュー項目で追跡される新しい MDI 子フォームを作成できます。  
+  
+    > [!NOTE]
+    >  MDI 子フォームが \(通常はメニュー項目のメニュー構造を持つ\) <xref:System.Windows.Forms.MainMenu> コンポーネントを持っていて、\(通常はメニュー項目のメニュー構造を持つ\) <xref:System.Windows.Forms.MainMenu> コンポーネントを持つ MDI 親フォーム内で開いている場合、<xref:System.Windows.Forms.MenuItem.MergeType%2A> プロパティ \(およびオプションで <xref:System.Windows.Forms.MenuItem.MergeOrder%2A> プロパティ\) を設定した場合に、メニュー項目が自動的にマージされます。  両方の <xref:System.Windows.Forms.MainMenu> コンポーネント、および子フォームのすべてのメニュー項目の <xref:System.Windows.Forms.MenuItem.MergeType%2A> プロパティを <xref:System.Windows.Forms.MenuMerge> に設定します。  また、<xref:System.Windows.Forms.MenuItem.MergeOrder%2A> プロパティを設定し、両方のメニューのメニュー項目が指定した順序で表示されるようにします。  さらに、MDI 親フォームを閉じた時に、MDI 親の <xref:System.Windows.Forms.Form.Closing> イベントが発生する前に、各 MDI 子フォームが <xref:System.Windows.Forms.Form.Closing> イベントを発生させます。  MDI 子の <xref:System.Windows.Forms.Form.Closing> イベントをキャンセルしても、MDI 親の <xref:System.Windows.Forms.Form.Closing> イベントの発生を防ぐことはできません。ただし、MDI 親の <xref:System.Windows.Forms.Form.Closing> イベントの <xref:System.ComponentModel.CancelEventArgs> 引数は `true` に設定されます。  <xref:System.ComponentModel.CancelEventArgs> 引数を `false` に設定することで、MDI 親レポートとすべての MDI 子フォームを強制的に閉じることができます。  
+  
+## 参照  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)   
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)   
+ [方法 : アクティブな MDI 子フォームにデータを送信する](../../../../docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md)   
+ [方法 : MDI 子フォームを配置する](../../../../docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md b/docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md
new file mode 100644
index 00000000000..0bcd30c01de
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : MDI 親フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, 作成 (フォームを)"
+  - "親フォーム"
+ms.assetid: 12c71221-2377-4bb6-b10b-7b4b300fd462
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : MDI 親フォームを作成する
+> [!IMPORTANT]
+>  このトピックでは、既に <xref:System.Windows.Forms.MainMenu> コントロールで置き換えられている <xref:System.Windows.Forms.MenuStrip> コントロールを使用します。  <xref:System.Windows.Forms.MainMenu> コントロールは、下位互換性と将来の使用 \(必要に応じて\) の両方のために保持されています。  <xref:System.Windows.Forms.MenuStrip> を使用した MDI 親フォームの作成方法の詳細は、「[方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md)」を参照してください。  
+  
+ マルチドキュメント インターフェイス \(MDI\) アプリケーションの基盤となるのは、MDI 親フォームです。  これは、サブウィンドウである MDI 子ウィンドウを含むフォームで、ユーザーは MDI 子ウィンドウで MDI アプリケーションと対話します。  MDI 親フォームの作成は簡単で、Windows フォーム デザイナーまたはプログラムで作成できます。  
+  
+### デザイン時に MDI 親フォームを作成するには  
+  
+1.  Windows アプリケーション プロジェクトを作成します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、[IsMDIContainer](frlrfSystemWindowsFormsFormClassIsMDIContainerTopic) プロパティを **\[true\]** に設定します。  
+  
+     これによって、フォームが子ウィンドウの MDI コンテナーとして指定されます。  
+  
+    > [!NOTE]
+    >  **\[プロパティ\]** ウィンドウでプロパティを設定するときに、必要に応じて、`WindowState` プロパティを **\[Maximized\]** に設定することもできます。MDI 子ウィンドウは、親フォームが最大化しているときに最も簡単に操作できます。  また、MDI 親フォームの端には、<xref:System.Windows.Forms.Control.BackColor%2A?displayProperty=fullName> プロパティを使用して設定した背景色ではなく、\(Windows システムのコントロール パネルで設定した\) システム カラーが適用されることに注意してください。  
+  
+3.  **\[ツールボックス\]** から、**\[MenuStrip\]** コントロールをフォームにドラッグします。  **Text** プロパティを「**ファイル \(F\)**」に設定し、「**新規作成 \(N\)**」と「**閉じる \(C\)**」というサブメニュー項目を指定して、トップレベルのメニュー項目を作成します。  また、「**ウィンドウ \(W\)**」というトップレベルのメニュー項目も作成します。  
+  
+     最初のメニューでは、実行時にメニュー項目を作成したり非表示にしたりします。2 つ目のメニューでは、開いている MDI 子ウィンドウを追跡します。  これで、MDI 親ウィンドウの作成が完了しました。  
+  
+4.  **F5** キーを押してアプリケーションを実行します。  MDI 親フォーム内で動作する MDI 子ウィンドウの作成方法の詳細については、「[方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)」を参照してください。  
+  
+## 参照  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)   
+ [方法 : アクティブな MDI 子フォームにデータを送信する](../../../../docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md)   
+ [方法 : MDI 子フォームを配置する](../../../../docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md b/docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md
new file mode 100644
index 00000000000..23c6b2a6835
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : 標準の Windows フォーム印刷ジョブを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "出力 [Visual Basic], Windows アプリケーションで"
+  - "印刷 [Windows フォーム]"
+  - "印刷 [Windows フォーム], 作成 (印刷ジョブを)"
+ms.assetid: 03342b90-9cfe-40b2-838b-b479a13c5dea
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 標準の Windows フォーム印刷ジョブを作成する
+Windows フォームでの印刷の基盤となるのは、<xref:System.Drawing.Printing.PrintDocument> コンポーネントです。より具体的に言えば、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントです。  <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントを処理するコードを記述することにより、印刷対象と印刷方法を指定できます。  
+  
+### 印刷ジョブを作成するには  
+  
+1.  フォームに <xref:System.Drawing.Printing.PrintDocument> コンポーネントを追加します。  
+  
+2.  <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントを処理するコードを記述します。  
+  
+     独自の印刷ロジックをコーディングする必要があります。  また、印刷する対象も指定する必要があります。  
+  
+     次のコード例では、印刷対象として <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント ハンドラー内で赤い四角形のサンプル グラフィックを作成しています。  
+  
+    ```vb  
+    Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage  
+       e.Graphics.FillRectangle(Brushes.Red, New Rectangle(500, 500, 500, 500))  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void printDocument1_PrintPage(object sender,   
+    System.Drawing.Printing.PrintPageEventArgs e)  
+    {  
+       e.Graphics.FillRectangle(Brushes.Red,   
+         new Rectangle(500, 500, 500, 500));  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void printDocument1_PrintPage(System::Object ^ sender,  
+          System::Drawing::Printing::PrintPageEventArgs ^ e)  
+       {  
+          e->Graphics->FillRectangle(Brushes::Red,  
+             Rectangle(500, 500, 500, 500));  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.printDocument1.PrintPage += new  
+       System.Drawing.Printing.PrintPageEventHandler  
+       (this.printDocument1_PrintPage);  
+  
+    ```  
+  
+    ```cpp  
+    printDocument1->PrintPage += gcnew  
+       System::Drawing::Printing::PrintPageEventHandler  
+       (this, &Form1::printDocument1_PrintPage);  
+    ```  
+  
+     また、<xref:System.Drawing.Printing.PrintDocument.BeginPrint> イベントおよび <xref:System.Drawing.Printing.PrintDocument.EndPrint> イベントに対するコードを記述することが必要な場合もあります。その場合、各ページが印刷されるたびに、印刷する合計ページ数を表す整数がデクリメントされるようにもできます。  
+  
+    > [!NOTE]
+    >  フォームに <xref:System.Windows.Forms.PrintDialog> コンポーネントを追加すると、明快で効率的なユーザー インターフェイス \(UI\) をユーザーに提供できます。  <xref:System.Windows.Forms.PrintDialog> コンポーネントの <xref:System.Windows.Forms.PrintDialog.Document%2A> プロパティを設定することにより、フォーム上で作業中の印刷ドキュメントに関連するプロパティを設定できます。  <xref:System.Windows.Forms.PrintDialog> コンポーネントの詳細については、「[PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)」を参照してください。  
+  
+     印刷ジョブをプログラムで作成する方法など、Windows フォームの印刷ジョブの詳細については、「<xref:System.Drawing.Printing.PrintPageEventArgs>」のトピックを参照してください。  
+  
+## 参照  
+ <xref:System.Drawing.Printing.PrintDocument>   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-thumbnail-images.md b/docs/framework/winforms/advanced/how-to-create-thumbnail-images.md
new file mode 100644
index 00000000000..f1adea648a6
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-thumbnail-images.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : サムネイル イメージを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], 作成 (サムネイル)"
+  - "サムネイル イメージ, 作成"
+ms.assetid: e956242a-1e5b-4217-a3cf-5f3fb45d00ba
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : サムネイル イメージを作成する
+サムネイル イメージとは、イメージの縮小版のことです。  サムネイル イメージを作成するには、<xref:System.Drawing.Image> オブジェクトの <xref:System.Drawing.Image.GetThumbnailImage%2A> メソッドを呼び出します。  
+  
+## 使用例  
+ JPG ファイルから <xref:System.Drawing.Image> オブジェクトを作成する例を次に示します。  元のイメージの幅は 640 ピクセルで、高さは 479 ピクセルです。  このコードは、幅および高さが共に 100 ピクセルのサムネイル イメージを作成します。  
+  
+ 作成されたサムネイル イメージを次の図に示します。  
+  
+ ![サムネイル イメージ](../../../../docs/framework/winforms/advanced/media/thumbnail1.png "Thumbnail1")  
+  
+> [!NOTE]
+>  この例では、コールバック メソッドが宣言されていますが、使用しません。  このメソッドは GDI\+ のすべてのバージョンをサポートします。  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#71](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#71)]
+ [!code-vb[System.Drawing.WorkingWithImages#71](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#71)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  この例を実行するには、次の手順に従います。  
+  
+1.  新しい Windows フォームアプリケーションを作成します。  
+  
+2.  プログラム例をフォームに追加します。  
+  
+3.  フォームの <xref:System.Windows.Forms.Control.Paint> イベントのハンドラーを作成します。  
+  
+4.  <xref:System.Windows.Forms.Control.Paint> ハンドラーで、`GetThumbnail` メソッドを呼び出し、<xref:System.Windows.Forms.PaintEventArgs> の `e` を渡します。  
+  
+5.  サムネイルを作成するイメージ ファイルを見つけます。  
+  
+6.  `GetThumbnail` メソッドで、イメージのパスとファイル名を指定します。  
+  
+7.  F5 キーを押して例を実行します。  
+  
+     100 × 100 のサムネイル イメージがフォーム上に表示されます。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-create-vertical-text.md b/docs/framework/winforms/advanced/how-to-create-vertical-text.md
new file mode 100644
index 00000000000..6a82cc1cd81
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-create-vertical-text.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : 垂直方向のテキストを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "文字列 [Windows フォーム], 描画 (縦書きの)"
+  - "テキスト [Windows フォーム], 描画 (縦書きの)"
+  - "縦書きのテキスト, 描画"
+  - "Windows フォーム, 描画 (縦書きのテキストを)"
+ms.assetid: 50c69046-4188-47d9-b949-cc2610ffd337
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 垂直方向のテキストを作成する
+<xref:System.Drawing.StringFormat> オブジェクトを使用して、テキストを水平方向ではなく垂直方向に描画するように指定できます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Drawing.StringFormat> オブジェクトの <xref:System.Drawing.StringFormat.FormatFlags%2A> プロパティに <xref:System.Drawing.StringFormatFlags> の値を割り当てます。  その <xref:System.Drawing.StringFormat> オブジェクトが <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawString%2A> メソッドに渡されます。  値 <xref:System.Drawing.StringFormatFlags> は <xref:System.Drawing.StringFormatFlags> 列挙体のメンバーです。  
+  
+ 表示される垂直方向のテキストを次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/csfontstext5.png "csfontstext5")  
+  
+ [!code-csharp[System.Drawing.FontsAndText#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.FontsAndText#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+  
+-   前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e`  が必要です。  
+  
+## 参照  
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-crop-and-scale-images.md b/docs/framework/winforms/advanced/how-to-crop-and-scale-images.md
new file mode 100644
index 00000000000..6029b4a0e8f
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-crop-and-scale-images.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : イメージをトリミングおよびスケーリングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], トリミング"
+  - "イメージ [Windows フォーム], スケーリング"
+ms.assetid: 053e3360-bca0-4b25-9afa-0e77a6f17b03
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : イメージをトリミングおよびスケーリングする
+<xref:System.Drawing.Graphics> クラスでは、<xref:System.Drawing.Graphics.DrawImage%2A> メソッドがいくつか用意されています。その中には、描画元の範囲を表す四角形パラメーターや、描画先の範囲を表す四角形パラメーターを受け取るメソッドもあり、これらはイメージをトリミングおよびスケーリングするために使用できます。  
+  
+## 使用例  
+ ディスク ファイル Apple.gif から <xref:System.Drawing.Image> オブジェクトを作成する例を次に示します。  このコードは、リンゴのイメージ全体を元のサイズで描画します。  次に、<xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドを呼び出して、リンゴのイメージの一部を、元のリンゴのイメージよりも大きな描画先の四角形に描画します。  
+  
+ <xref:System.Drawing.Graphics.DrawImage%2A> メソッドは、3 番目、4 番目、5 番目、6 番目の各引数によって指定されている、描画元の範囲を表す四角形を参照し、リンゴのどの部分を描画するかを決定します。  この場合は、リンゴの幅と高さがそれぞれの 75% になるようにトリミングされます。  
+  
+ <xref:System.Drawing.Graphics.DrawImage%2A> メソッドは、2 番目の引数によって指定されている、描画先の範囲を表す四角形を参照して、トリミングしたリンゴのイメージの描画位置と、そのイメージをどれくらいの大きさで描画するかを決定します。  この例では、描画先の範囲を表す四角形は、元のイメージよりも幅、高さ共に 30% 大きく指定されています。  
+  
+ 元のリンゴと、スケーリングおよびトリミングしたリンゴを次の図に示します。  
+  
+ ![トリミング & スケール](../../../../docs/framework/winforms/advanced/media/cscropscale1.png "csCropScale1")  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.WorkingWithImages#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  `Apple.gif` は、必ずシステム上で有効なイメージ ファイルの名前とパスに置き換えてください。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md b/docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md
new file mode 100644
index 00000000000..702076916db
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : アクティブな MDI 子フォームを特定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子フォーム"
+  - "クリップボードのトピック, コピー (データを)"
+  - "MDI, アクティブ化 (フォームを)"
+  - "MDI, 子ウィンドウ"
+  - "MDI, 指定 (フォーカスを)"
+ms.assetid: 33880ec3-0207-4c2b-a616-ff140443cc0f
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : アクティブな MDI 子フォームを特定する
+現在アクティブな子フォーム上でフォーカスされているコントロールを操作するためのコマンドを必要とする場合が考えられます。  たとえば、子フォームのテキスト ボックスから、選択したテキストをクリップボードにコピーするとします。  この場合、標準の \[編集\] メニューの \[コピー\] の <xref:System.Windows.Forms.Control.Click> イベントを使用して、選択したテキストをクリップボードにコピーするプロシージャを作成します。  
+  
+ MDI アプリケーションでは、同じ子フォームのインスタンスを多数持つことができるため、プロシージャでは使用するフォームを特定する必要があります。  正しいフォームを特定するには、フォーカスがある子フォーム、または最後にアクティブになった子フォームを返す <xref:System.Windows.Forms.Form.ActiveMdiChild%2A> プロパティを使用します。  
+  
+ 1 つのフォームに複数のコントロールがある場合は、アクティブなコントロールを特定する必要もあります。  <xref:System.Windows.Forms.Form.ActiveMdiChild%2A> プロパティと同様に、<xref:System.Windows.Forms.ContainerControl.ActiveControl%2A> プロパティは、アクティブな子フォーム上でフォーカスされているコントロールを返します。  子フォームのメニュー、MDI フォームのメニュー、またはツール バー ボタンで呼び出すことができるコピー プロシージャを次に示します。  
+  
+### アクティブな MDI 子フォームを判断してテキストをクリップボードにコピーするには  
+  
+1.  アクティブな子フォームにあるアクティブなコントロールからテキストをクリップボードにコピーするコードをメソッドに記述します。  
+  
+    > [!NOTE]
+    >  この例では、MDI 親フォーム \(`Form1`\) は <xref:System.Windows.Forms.RichTextBox> コントロールのある MDI 子ウィンドウを少なくとも 1 つ持っていることを前提としています。  詳細については、「[方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)」を参照してください。  
+  
+    ```vb  
+    Public Sub mniCopy_Click(ByVal sender As Object, _  
+       ByVal e As System.EventArgs) Handles mniCopy.Click  
+  
+       ' Determine the active child form.  
+       Dim activeChild As Form = Me.ActiveMDIChild  
+  
+       ' If there is an active child form, find the active control, which  
+       ' in this example should be a RichTextBox.  
+       If (Not activeChild Is Nothing) Then  
+          Dim theBox As RichTextBox = _  
+            TryCast(activeChild.ActiveControl, RichTextBox)  
+  
+          If (Not theBox Is Nothing) Then  
+             'Put selected text on Clipboard.  
+             Clipboard.SetDataObject(theBox.SelectedText)  
+          Else  
+             MessageBox.Show("You need to select a RichTextBox.")  
+          End If  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void mniCopy_Click (object sender, System.EventArgs e)  
+    {  
+       // Determine the active child form.  
+       Form activeChild = this.ActiveMdiChild;  
+  
+       // If there is an active child form, find the active control, which  
+       // in this example should be a RichTextBox.  
+       if (activeChild != null)  
+       {    
+          try  
+          {  
+             RichTextBox theBox = (RichTextBox)activeChild.ActiveControl;  
+             if (theBox != null)  
+             {  
+                // Put the selected text on the Clipboard.  
+                Clipboard.SetDataObject(theBox.SelectedText);  
+  
+             }  
+          }  
+          catch  
+          {  
+             MessageBox.Show("You need to select a RichTextBox.");  
+          }  
+       }  
+    }  
+  
+    ```  
+  
+## 参照  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)   
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [方法 : アクティブな MDI 子フォームにデータを送信する](../../../../docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md)   
+ [方法 : MDI 子フォームを配置する](../../../../docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-determine-the-parameters-supported-by-an-encoder.md b/docs/framework/winforms/advanced/how-to-determine-the-parameters-supported-by-an-encoder.md
new file mode 100644
index 00000000000..81dc0c026f8
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-determine-the-parameters-supported-by-an-encoder.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : エンコーダーがサポートするパラメーターの確認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エンコーダー パラメーター, 確認 (サポートされているかどうかを)"
+ms.assetid: f47ae459-e3ce-4d41-a140-2f6c6aea3f44
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : エンコーダーがサポートするパラメーターの確認
+品質や圧縮レベルなどのイメージ パラメーターを調整できますが、指定されたイメージ エンコーダーがどのパラメーターをサポートするかを確認する必要があります。  <xref:System.Drawing.Image> クラスは、特定のエンコーダーがサポートするイメージ パラメーターを確認できる <xref:System.Drawing.Image.GetEncoderParameterList%2A> メソッドを提供します。  エンコーダーは GUID で指定します。  <xref:System.Drawing.Image.GetEncoderParameterList%2A> メソッドは、<xref:System.Drawing.Imaging.EncoderParameter> オブジェクトの配列を返します。  
+  
+## 使用例  
+ JPEG エンコーダーでサポートされるパラメーターを出力する方法を次のコード例に示します。  <xref:System.Drawing.Imaging.Encoder> クラスの概要に含まれるパラメーター カテゴリと関連する GUID の一覧を使用して、各パラメーターのカテゴリを確認します。  
+  
+ [!code-csharp[UsingImageEncodersDecoders#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#3)]
+ [!code-vb[UsingImageEncodersDecoders#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#3)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Windows フォーム アプリケーション。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs>。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+## 参照  
+ [方法 : インストールされたエンコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-encoders.md)   
+ [ビットマップの種類](../../../../docs/framework/winforms/advanced/types-of-bitmaps.md)   
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-display-pop-up-help.md b/docs/framework/winforms/advanced/how-to-display-pop-up-help.md
new file mode 100644
index 00000000000..30b7db35b9d
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-display-pop-up-help.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : ポップアップ ヘルプを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "F1 ヘルプ, ダイアログ ボックスで"
+  - "フォーム, 表示 (ヘルプを)"
+  - "ヘルプ, 追加 (ダイアログ ボックスに)"
+  - "ヘルプ, ポップアップ ヘルプ"
+  - "HelpProvider コンポーネント [Windows フォーム]"
+  - "モーダル ダイアログ ボックス, ポップアップ ヘルプ"
+  - "ポップアップ ヘルプ"
+  - "Windows フォーム, 表示 (ヘルプを)"
+ms.assetid: 218aa81e-e87e-4d67-af05-11627bbdce3b
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ポップアップ ヘルプを表示する
+Windows フォーム上のヘルプを表示する方法の 1 つは、<xref:System.Windows.Forms.Form.HelpButton%2A> プロパティからアクセスできる、タイトル バーの右側にある **\[ヘルプ\]** ボタンを使用することです。  この種類のヘルプの表示は、ダイアログ ボックスでの使用に適しています。  モーダル形式で表示されるダイアログ ボックス \(<xref:System.Windows.Forms.Form.ShowDialog%2A> メソッドを使用\) は、別のウィンドウにフォーカスを移動するときはモーダル ダイアログ ボックスを閉じる必要があるため、外部のヘルプ システムを起動する場合は問題が発生します。  また、**\[ヘルプ\]** ボタンを使用する場合、**\[最小化\]** ボタンや**\[最大化\]** ボタンがタイトル バーに表示されないようにする必要があります。  これは標準のダイアログ ボックスの規約ですが、通常、フォームには **\[最小化\]** ボタンと **\[最大化\]** ボタンがあります。  
+  
+ また、ポップアップ ヘルプを実装している場合でも、<xref:System.Windows.Forms.HelpProvider> コンポーネントを使用して、コントロールをヘルプ システムのファイルにリンクできることにも注意してください。  詳細については、「[Windows アプリケーションにヘルプを提供する](../../../../docs/framework/winforms/advanced/how-to-provide-help-in-a-windows-application.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ポップアップ ヘルプを表示するには  
+  
+1.  [HelpProvider](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md) コンポーネントをツールボックスからフォームにドラッグします。  
+  
+     これは、Windows フォーム デザイナーの下部にあるトレイ内に配置されます。  
+  
+2.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Form.HelpButton%2A> プロパティを `true` に設定します。  これで、フォームのタイトル バーの右側に疑問符の付いたボタンが表示されます。  
+  
+3.  <xref:System.Windows.Forms.Form.HelpButton%2A> が表示されるには、フォームの <xref:System.Windows.Forms.Form.MinimizeBox%2A> プロパティと <xref:System.Windows.Forms.Form.MaximizeBox%2A> プロパティを `false` に設定し、<xref:System.Windows.Forms.Form.ControlBox%2A> プロパティを `true` に設定し、<xref:System.Windows.Forms.Form.FormBorderStyle%2A> プロパティを<xref:System.Windows.Forms.FormBorderStyle>、<xref:System.Windows.Forms.FormBorderStyle>、<xref:System.Windows.Forms.FormBorderStyle>、または <xref:System.Windows.Forms.FormBorderStyle> のいずれかの値に設定する必要があります。  
+  
+4.  フォーム上のヘルプを表示し、\[プロパティ\] ウィンドウのヘルプの文字列を設定するコントロールを選択します。  これは、[ツールヒント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)のようなウィンドウに表示されるテキストの文字列です。  
+  
+5.  **F5** キーを押します。  
+  
+6.  タイトル バーの **\[ヘルプ\]** ボタンをクリックして、ヘルプの文字列を設定したコントロールをクリックします。  
+  
+## 参照  
+ [ツールヒントを使用したコントロールのヘルプ](../../../../docs/framework/winforms/advanced/control-help-using-tooltips.md)   
+ [Windows フォームでのヘルプの統合](../../../../docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-custom-dashed-line.md b/docs/framework/winforms/advanced/how-to-draw-a-custom-dashed-line.md
new file mode 100644
index 00000000000..134e0323ec3
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-custom-dashed-line.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : カスタム破線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "線, カスタム"
+  - "線, 破線"
+  - "線, 描画"
+ms.assetid: cd0ed96a-cce4-47b9-b58a-3bae2e3d1bee
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : カスタム破線を描画する
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、破線スタイルがいくつか用意されており、これらのスタイルは <xref:System.Drawing.Drawing2D.DashStyle> 列挙体が保持しています。  これらの標準の破線スタイル以外の破線が必要な場合は、カスタムの破線パターンを作成できます。  
+  
+## 使用例  
+ カスタムの破線を描画するには、ダッシュと空白の長さを配列に格納し、その配列を <xref:System.Drawing.Pen.DashPattern%2A> オブジェクトの <xref:System.Drawing.Pen> プロパティの値として割り当てます。  配列  `{5, 2, 15, 4}` に基づいてカスタム破線を描画する例を次に示します。  配列の要素にペン幅 5 を掛け合わせると、`{25, 10, 75, 20}` という結果が得られます。  この破線では、25 と 75 の長さのダッシュが交互に、10 および 20 の長さの空白が交互に表示されます。  
+  
+ 結果として得られる破線を次の図に示します。  破線が点 \(405, 5\) で終了するように、最後のダッシュの長さを 25 よりも短くする必要があります。  
+  
+ ![ペン](../../../../docs/framework/winforms/advanced/media/pens6.png "pens6")  
+  
+ [!code-csharp[System.Drawing.UsingAPen#51](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#51)]
+ [!code-vb[System.Drawing.UsingAPen#51](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#51)]  
+  
+## コードのコンパイル  
+ Windows フォームを作成し、フォームの <xref:System.Windows.Forms.Control.Paint> イベントを処理します。  前述のコードを <xref:System.Windows.Forms.Control.Paint> イベント ハンドラーに貼り付けます。  
+  
+## 参照  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-filled-ellipse-on-a-windows-form.md b/docs/framework/winforms/advanced/how-to-draw-a-filled-ellipse-on-a-windows-form.md
new file mode 100644
index 00000000000..0b35102e94e
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-filled-ellipse-on-a-windows-form.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : Windows フォームに塗りつぶした楕円を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Graphics.FillEllipse"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "円, 描画"
+  - "円形"
+  - "描画, 楕円"
+  - "楕円, 描画"
+  - "フォーム, 描画 (楕円を)"
+  - "形状, 描画"
+ms.assetid: 781db806-950d-4c5b-b022-493f7fd0c4a8
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームに塗りつぶした楕円を描画する
+この例は、塗りつぶした楕円をフォームに描画します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#1)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#1)]
+ [!code-vb[System.Drawing.ConceptualHowTos#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ <xref:System.Windows.Forms.Form.Load> イベント ハンドラーでこのメソッドを呼び出すことはできません。  フォームがサイズ変更された場合、または別のフォームによって隠れている場合、描画済みのコンテンツは再描画されません。  コンテンツを自動的に再描画するには、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドする必要があります。  
+  
+## 信頼性の高いプログラミング  
+ システム リソースを消費するオブジェクト \(<xref:System.Drawing.Brush> オブジェクトや <xref:System.Drawing.Graphics> オブジェクトなど\) では、必ず <xref:System.IDisposable.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)   
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-filled-rectangle-on-a-windows-form.md b/docs/framework/winforms/advanced/how-to-draw-a-filled-rectangle-on-a-windows-form.md
new file mode 100644
index 00000000000..23a837925b5
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-filled-rectangle-on-a-windows-form.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : Windows フォームに塗りつぶした四角形を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Graphics.FillRectangle"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (四角形を)"
+  - "描画, 四角形"
+  - "四角形, 描画"
+ms.assetid: d656a93c-987d-4809-aafd-493fe17450f0
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームに塗りつぶした四角形を描画する
+この例は、塗りつぶした四角形をフォームに描画します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#2](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#2)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#2)]
+ [!code-vb[System.Drawing.ConceptualHowTos#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#2)]  
+  
+## コードのコンパイル  
+ <xref:System.Windows.Forms.Form.Load> イベント ハンドラーでこのメソッドを呼び出すことはできません。  フォームがサイズ変更された場合、または別のフォームによって隠れている場合、描画済みのコンテンツは再描画されません。  コンテンツを自動的に再描画するには、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドする必要があります。  
+  
+## 信頼性の高いプログラミング  
+ システム リソースを消費するオブジェクト \(<xref:System.Drawing.Brush> オブジェクトや <xref:System.Drawing.Graphics> オブジェクトなど\) では、必ず <xref:System.IDisposable.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.FillRectangle%2A>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [GDI\+ でのブラシと塗りつぶされた図形](../../../../docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-line-filled-with-a-texture.md b/docs/framework/winforms/advanced/how-to-draw-a-line-filled-with-a-texture.md
new file mode 100644
index 00000000000..caf712c2a56
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-line-filled-with-a-texture.md
@@ -0,0 +1,43 @@
+---
+title: "方法 :テクスチャを使用して塗りつぶした直線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (線を), テクスチャ"
+  - "描画, 線"
+  - "線, テクスチャ"
+ms.assetid: dc9118cc-f3c2-42e5-8173-f46d41d18fd5
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 :テクスチャを使用して塗りつぶした直線を描画する
+線を純色で描画する代わりに、テクスチャを使用して描画できます。  テクスチャを使用して直線や曲線を描画するには、<xref:System.Drawing.TextureBrush> オブジェクトを作成し、その <xref:System.Drawing.TextureBrush> オブジェクトを <xref:System.Drawing.Pen.%23ctor%2A> コンストラクターに渡します。  テクスチャ ブラシに関連付けられたビットマップが使用され、そのビットマップ平面が見えないように並べられます。ペンが直線または曲線を描画するときに、並べられているテクスチャの特定のピクセルがペンのストロークに沿って表示されるようになります。  
+  
+## 使用例  
+ ファイル  `Texture1.jpg` から <xref:System.Drawing.Bitmap> オブジェクトを作成する例を次に示します。  そのビットマップを使用して <xref:System.Drawing.TextureBrush> オブジェクトを作成し、その <xref:System.Drawing.TextureBrush> オブジェクトを使用して <xref:System.Drawing.Pen> オブジェクトを作成しています。  <xref:System.Drawing.Graphics.DrawImage%2A> を呼び出すと、左上隅が \(0, 0\) の位置にあるビットマップが描画されます。  <xref:System.Drawing.Graphics.DrawEllipse%2A> の呼び出しでは、<xref:System.Drawing.Pen> オブジェクトを使用して、テクスチャを適用した楕円を描画しています。  
+  
+ ビットマップと、テクスチャが適用された楕円を次の図に示します。  
+  
+ ![ペン](../../../../docs/framework/winforms/advanced/media/pens7.png "pens7")  
+  
+ [!code-csharp[System.Drawing.UsingAPen#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#61)]
+ [!code-vb[System.Drawing.UsingAPen#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#61)]  
+  
+## コードのコンパイル  
+ Windows フォームを作成し、フォームの <xref:System.Windows.Forms.Control.Paint> イベントを処理します。  前述のコードを <xref:System.Windows.Forms.Control.Paint> イベント ハンドラーに貼り付けます。   `Texture.jpg` を、システムで有効なイメージで置き換えます。  
+  
+## 参照  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md b/docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md
new file mode 100644
index 00000000000..23c04c05770
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Windows フォームに直線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Graphics.DrawLine"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (線を)"
+  - "描画, 線"
+  - "例 [Windows フォーム], 描画 (フォームに直線を)"
+  - "線, 描画"
+ms.assetid: 55c1dbeb-75d0-430c-9814-a24b8971ad8c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームに直線を描画する
+この例は、フォームに直線を描画します。  通常、フォームに描画するときは、この例に示すように、フォームの <xref:System.Windows.Forms.Control.Paint> イベントを処理し、<xref:System.Windows.Forms.PaintEventArgs> の <xref:System.Windows.Forms.PaintEventArgs.Graphics%2A> プロパティを使用して描画を実行します。  
+  
+## 使用例  
+ [!code-csharp[System.Drawing.UsingAPen#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.UsingAPen#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 信頼性の高いプログラミング  
+ システム リソースを消費するオブジェクト \(<xref:System.Drawing.Pen> オブジェクトなど\) では、必ず <xref:System.IDisposable.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.DrawLine%2A>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-line-with-line-caps.md b/docs/framework/winforms/advanced/how-to-draw-a-line-with-line-caps.md
new file mode 100644
index 00000000000..1f655785b9a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-line-with-line-caps.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : ライン キャップを使用した直線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (線を), ライン キャップ"
+  - "描画, 線"
+  - "線, 描画"
+  - "ペン, 描画 (線を)"
+ms.assetid: eb68c3e1-c400-4886-8a04-76978a429cb6
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ライン キャップを使用した直線を描画する
+ライン キャップと呼ばれるいくつかの形状のいずれかを使用して、直線の開始点または終了点を描画できます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、円形、正方形、菱形、矢じり形などの複数のライン キャップをサポートしています。  
+  
+## 使用例  
+ ライン キャップは、直線の開始点 \(開始キャップ\)、終了点 \(端点キャップ\)、または破線のダッシュ \(ダッシュ キャップ\) に対して指定できます。  
+  
+ 一方の端には矢じり形のキャップ、もう一方の端には円形のキャップを使用した直線を描画する例を次に示します。  結果として得られる直線を次の図に示します。  
+  
+ ![ペン](../../../../docs/framework/winforms/advanced/media/pens4.png "pens4")  
+  
+ [!code-csharp[System.Drawing.UsingAPen#71](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#71)]
+ [!code-vb[System.Drawing.UsingAPen#71](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#71)]  
+  
+## コードのコンパイル  
+  
+-   Windows フォームを作成し、フォームの <xref:System.Windows.Forms.Control.Paint> イベントを処理します。  プログラム例を <xref:System.Windows.Forms.Control.Paint> イベント ハンドラーに貼り付け、`e` を <xref:System.Windows.Forms.PaintEventArgs> として渡します。  
+  
+## 参照  
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ <xref:System.Drawing.Drawing2D.LineCap?displayProperty=fullName>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-sequence-of-bezier-splines.md b/docs/framework/winforms/advanced/how-to-draw-a-sequence-of-bezier-splines.md
new file mode 100644
index 00000000000..c34dfe305d3
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-sequence-of-bezier-splines.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 一連のベジエ スプラインを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ベジエ スプライン, 描画シーケンス"
+  - "スプライン, 描画 (ベジエ)"
+ms.assetid: 37a0bedb-20c2-4cf0-91fa-a5509e826b30
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 一連のベジエ スプラインを描画する
+<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawBeziers%2A> メソッドを使用すると、連結された一連のベジエ スプラインを描画できます。  
+  
+## 使用例  
+ 2 つのベジエ スプラインを結んだ 1 つの曲線を描画する例を次に示します。  1 番目のベジエ スプラインの終了点は 2 番目のベジエ スプラインの開始点です。  
+  
+ 結合されたスプラインとその 7 つの点を次の図に示します。  
+  
+ ![ベジエ スプライン](../../../../docs/framework/winforms/advanced/media/bezierspline2.png "BezierSpline2")  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingCurves#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.ConstructingDrawingCurves#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [GDI\+ でのベジエ スプライン](../../../../docs/framework/winforms/advanced/bezier-splines-in-gdi.md)   
+ [曲線の作成と描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-curves.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-a-single-bezier-spline.md b/docs/framework/winforms/advanced/how-to-draw-a-single-bezier-spline.md
new file mode 100644
index 00000000000..ebfd34273d2
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-a-single-bezier-spline.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 1 本のベジエ スプラインを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ベジエ スプライン, 描画"
+  - "描画, ベジエ スプライン"
+ms.assetid: f4f3fe30-f0a6-4743-ac91-11310cebea9f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : 1 本のベジエ スプラインを描画する
+ベジエ スプラインは、開始点、2 つの制御点、および終了点の 4 つの点によって定義されます。  
+  
+## 使用例  
+ 開始点が \(10, 100\) で終了点が \(200, 100\) のベジエ スプラインを描画する例を次に示します。  制御点は \(100, 10\) および \(150, 150\) です。  
+  
+ 生成されたベジエ スプラインとその開始点、制御点、および終了点を、次の図に示します。  また、この図では、スプラインの外側の枠である、4 つの点を直線で結んで形成される多角形も示しています。  
+  
+ ![ベジエ スプライン](../../../../docs/framework/winforms/advanced/media/bezierspline1.png "BezierSpline1")  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingCurves#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.ConstructingDrawingCurves#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.DrawBezier%2A>   
+ [GDI\+ でのベジエ スプライン](../../../../docs/framework/winforms/advanced/bezier-splines-in-gdi.md)   
+ [方法 : 一連のベジエ スプラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-sequence-of-bezier-splines.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-an-existing-bitmap-to-the-screen.md b/docs/framework/winforms/advanced/how-to-draw-an-existing-bitmap-to-the-screen.md
new file mode 100644
index 00000000000..dda7bfd257e
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-an-existing-bitmap-to-the-screen.md
@@ -0,0 +1,43 @@
+---
+title: "方法: 既存のビットマップを画面に描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 表示 (Windows フォームで)"
+  - "ビットマップ [Windows フォーム], 読み込み (Windows フォーム アプリケーションに)"
+  - "イメージ [Windows フォーム], 表示 (Windows フォームに)"
+ms.assetid: 5bc558d7-b326-4050-a834-b8600da0de95
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法: 既存のビットマップを画面に描画する
+既存のイメージを画面上に簡単に描画できます。  まず、ファイル名として <xref:System.Drawing.Bitmap.%23ctor%28System.String%29> を受け取るビットマップ コンストラクターを使用して、<xref:System.Drawing.Bitmap> オブジェクトを作成する必要があります。  このコンストラクターでは、BMP、GIF、JPEG、PNG、TIFF などのさまざまなファイル形式のイメージを使用できます。  <xref:System.Drawing.Bitmap> オブジェクトを作成した後に、その <xref:System.Drawing.Bitmap> オブジェクトを <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドに渡します。  
+  
+## 使用例  
+ JPEG ファイルから <xref:System.Drawing.Bitmap> オブジェクトを作成し、左上隅が \(60, 10\) の位置にあるビットマップを描画する例を次に示します。  
+  
+ 指定された位置に描画されたビットマップを次の図に示します。  
+  
+ ![イメージ ポジション](../../../../docs/framework/winforms/advanced/media/csimageposition1.png "csimageposition1")  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.WorkingWithImages#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md b/docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md
new file mode 100644
index 00000000000..05413071f31
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : 形状のアウトラインを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Graphics.DrawEllipse"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "円"
+  - "円, 描画"
+  - "円形"
+  - "描画, 円形"
+  - "描画, 形状"
+  - "楕円, 描画"
+  - "フォーム, 描画 (円形を)"
+  - "アウトライン形状, 描画"
+  - "アウトライン形状, 例"
+  - "形状, 描画"
+ms.assetid: f4f9214c-607e-407d-8cdd-6549f0278451
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 形状のアウトラインを描画する
+この例は、フォームに楕円と四角形のアウトラインを描画します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#6](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#6)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#6)]
+ [!code-vb[System.Drawing.ConceptualHowTos#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#6)]  
+  
+## コードのコンパイル  
+ <xref:System.Windows.Forms.Form.Load> イベント ハンドラーでこのメソッドを呼び出すことはできません。  フォームがサイズ変更された場合、または別のフォームによって隠れている場合、描画済みのコンテンツは再描画されません。  コンテンツを自動的に再描画するには、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドする必要があります。  
+  
+## 信頼性の高いプログラミング  
+ システム リソースを消費するオブジェクト \(<xref:System.Drawing.Pen> オブジェクトや <xref:System.Drawing.Graphics> オブジェクトなど\) では、必ず <xref:System.IDisposable.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.DrawEllipse%2A>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ <xref:System.Drawing.Graphics.DrawRectangle%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-cardinal-splines.md b/docs/framework/winforms/advanced/how-to-draw-cardinal-splines.md
new file mode 100644
index 00000000000..139ed1e6f5f
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-cardinal-splines.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : カーディナル スプラインを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カーディナル スプライン, 描画"
+  - "描画, カーディナル スプライン"
+  - "グラフィックス, カーディナル スプライン"
+ms.assetid: a4a41e80-4461-4b47-b6bd-2c5e68881994
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : カーディナル スプラインを描画する
+カーディナル スプラインとは、指定された一連の点を滑らかに結ぶ曲線のことです。  カーディナル スプラインを描画するには、<xref:System.Drawing.Graphics> オブジェクトを作成し、点の配列のアドレスを <xref:System.Drawing.Graphics.DrawCurve%2A> メソッドに渡します。  
+  
+### 鐘型のカーディナル スプラインの描画  
+  
+-   指定した 5 つの点を結ぶ鐘型のカーディナル スプラインを描画する例を次に示します。  この曲線と 5 つの点を次の図に示します。  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingCurves#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.ConstructingDrawingCurves#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/VB/Class1.vb#21)]  
+  
+### 閉じたカーディナル スプラインの描画  
+  
+-   閉じたカーディナル スプラインを描画するには、<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawClosedCurve%2A> メソッドを使用します。  閉じたカーディナル スプラインの場合、曲線は配列内の最後の点と、配列内の最初の点を結びます。  指定された 6 つの点を結ぶ、閉じたカーディナル スプラインを描画する例を次に示します。  この閉じたスプラインと 6 つの点を次の図に示します。  
+  
+ ![カーディナル スプライン](../../../../docs/framework/winforms/advanced/media/cardinalspline1a.png "CardinalSpline1A")  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingCurves#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/CS/Class1.cs#22)]
+ [!code-vb[System.Drawing.ConstructingDrawingCurves#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/VB/Class1.vb#22)]  
+  
+### カーディナル スプラインの歪曲度の変更  
+  
+-   カーディナル スプラインの歪曲度を変更するには、<xref:System.Drawing.Graphics.DrawCurve%2A> メソッドにテンション引数を渡します。  一連の同じ点を結ぶ 3 つのカーディナル スプラインを描画する例を次に示します。  この 3 つのスプラインとそのテンション値を次の図に示します。  テンションが 0 の場合、各点は直線で結ばれます。  
+  
+ ![カーディナル スプライン](../../../../docs/framework/winforms/advanced/media/cardinalspline2.png "CardinalSpline2")  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingCurves#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/CS/Class1.cs#23)]
+ [!code-vb[System.Drawing.ConstructingDrawingCurves#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingCurves/VB/Class1.vb#23)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [曲線の作成と描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-curves.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md b/docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md
new file mode 100644
index 00000000000..910c9f76216
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 不透明な直線および半透明な直線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アルファ ブレンド, 描画 (線を)"
+  - "描画, 線"
+  - "線, 描画 (アルファ ブレンドされた)"
+  - "透明度, 線"
+ms.assetid: 8f2508af-f495-4223-b5cc-646cbbb520eb
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : 不透明な直線および半透明な直線を描画する
+線を描画するときは、<xref:System.Drawing.Pen> オブジェクトを <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawLine%2A> メソッドに渡す必要があります。  <xref:System.Drawing.Pen.%23ctor%2A> コンストラクターのパラメーターの 1 つは、<xref:System.Drawing.Color> オブジェクトです。  不透明な直線を描画するには、色のアルファ コンポーネントを 255 に設定します。  半透明な直線を描画するには、アルファ コンポーネントを 1 ～ 254 の値に設定します。  
+  
+ 半透明な直線を背景の上に描画するとき、線の色は、背景の色とブレンドされます。  アルファ コンポーネントは、線と背景色が混在する方法を指定します。0 に近いのアルファ値は、背景色の比重が高く、255 に近いアルファ値は、線の色の比重が高くなります。  
+  
+## 使用例  
+ 次の例では、ビットマップを描画し、ビットマップを背景として使用する 3 つの線が描画されます。  最初の線はアルファ コンポーネントに 255 を使用するので、不透明です。  2 番目と 3 番目の線は、アルファ コンポーネントに 128 を使用するので、線から背景画像を確認できます。  <xref:System.Drawing.Graphics.CompositingQuality%2A> プロパティを設定するステートメントにより、3 番目の線がのブレンドがガンマ補正と組み合わせて実行されます。  
+  
+ 以下のコードの出力を次の図に示します。  
+  
+ ![不透明と半透明](../../../../docs/framework/winforms/advanced/media/compqualline.png "compqualline")  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.AlphaBlending#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前の例は、Windows フォームで使用するために設計されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` を必要とします。  
+  
+## 参照  
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)   
+ [方法 : コントロールに透明な背景を指定する](../../../../docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md)   
+ [方法 : 不透明ブラシおよび半透明ブラシを使用して描画する](../../../../docs/framework/winforms/advanced/how-to-draw-with-opaque-and-semitransparent-brushes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-text-at-a-specified-location.md b/docs/framework/winforms/advanced/how-to-draw-text-at-a-specified-location.md
new file mode 100644
index 00000000000..504132da8ed
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-text-at-a-specified-location.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : テキストを指定の位置に描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画 (テキストを)"
+  - "描画 (テキストを), 指定された位置 [Windows フォーム]"
+  - "テキスト, 描画 (指定された位置に) [Windows フォーム]"
+  - "Windows フォーム, 描画 (指定された位置にテキストを)"
+ms.assetid: 60816423-1c38-465e-980d-2c2b64d74086
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : テキストを指定の位置に描画する
+カスタムな描画を実行するとき、1 行のテキストを指定した位置から水平に描画できます。  <xref:System.Drawing.Graphics> クラスのオーバーロードされた <xref:System.Drawing.Graphics.DrawString%2A> メソッドに <xref:System.Drawing.Point> パラメーターまたは <xref:System.Drawing.PointF> パラメーターを渡して呼び出すと、この方法でテキストを描画できます。  <xref:System.Drawing.Graphics.DrawString%2A> メソッドには、<xref:System.Drawing.Brush> および <xref:System.Drawing.Font> も必要です。  
+  
+ また、<xref:System.Drawing.Point> を使用する <xref:System.Windows.Forms.TextRenderer> のオーバーロードされた <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドも使用できます。  <xref:System.Windows.Forms.TextRenderer.DrawText%2A> には、<xref:System.Drawing.Color> および <xref:System.Drawing.Font> も必要です。  
+  
+ オーバーロードされた <xref:System.Drawing.Graphics.DrawString%2A> メソッドを使用するとき、指定した位置にテキストを描画すると、次のように出力されます。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/csfontstext1.png "csfontstext1")  
+  
+### GDI\+ を使用してテキスト行を描画するには  
+  
+1.  <xref:System.Drawing.Graphics.DrawString%2A> メソッドに描画するテキスト、<xref:System.Drawing.Point> \(または <xref:System.Drawing.PointF>\)、<xref:System.Drawing.Font> および <xref:System.Drawing.Brush> を渡して使用します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#30)]
+     [!code-vb[System.Drawing.AlignDrawnText#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#30)]  
+  
+### GDI を使用してテキスト行を描画するには  
+  
+1.  <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドに描画するテキスト、<xref:System.Drawing.Point>、<xref:System.Drawing.Font>、および <xref:System.Drawing.Color> を渡して使用します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#40](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#40)]
+     [!code-vb[System.Drawing.AlignDrawnText#40](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#40)]  
+  
+## コードのコンパイル  
+ 上記の例では、次のものが必要です。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs>  `e`。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+## 参照  
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [方法 : フォント ファミリとフォントを作成する](../../../../docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md)   
+ [方法 : 四角形内にテキストを折り返して描画する](../../../../docs/framework/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md b/docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md
new file mode 100644
index 00000000000..ee13a42dd6c
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : Windows フォームにテキストを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 描画 (テキストを)"
+  - "テキスト, 描画"
+ms.assetid: 5d2447a9-21a1-4adc-b954-5516f2bb9b2c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームにテキストを描画する
+<xref:System.Drawing.Graphics> の <xref:System.Drawing.Graphics.DrawString%2A> メソッドを使用してフォーム上にテキストを描画する方法を次のコード例に示します。  また、フォーム上にテキストを描画するには <xref:System.Windows.Forms.TextRenderer> を使用することもできます。  詳細については、「[方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)」を参照してください。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#7](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#7)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#7)]
+ [!code-vb[System.Drawing.ConceptualHowTos#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#7)]  
+  
+## コードのコンパイル  
+ <xref:System.Windows.Forms.Form.Load> イベント ハンドラーで <xref:System.Drawing.Graphics.DrawString%2A> メソッドを呼び出すことはできません。  フォームがサイズ変更された場合、または別のフォームによって隠れている場合、描画済みのコンテンツは再描画されません。  コンテンツを自動的に再描画するには、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドする必要があります。  
+  
+## 信頼性の高いプログラミング  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   Arial フォントがインストールされていない。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.DrawString%2A>   
+ <xref:System.Windows.Forms.TextRenderer.DrawText%2A>   
+ <xref:System.Drawing.StringFormat.FormatFlags%2A>   
+ <xref:System.Drawing.StringFormatFlags>   
+ <xref:System.Windows.Forms.TextFormatFlags>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md b/docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md
new file mode 100644
index 00000000000..8676059793d
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : GDI を使用してテキストを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, テキスト"
+  - "GDI, 描画 (テキストを) [Windows フォーム]"
+  - "テキスト, 描画 (TextRenderer を使用して)"
+  - "Windows フォーム, 描画 (GDI でテキストを)"
+ms.assetid: 2a19fe5d-2ace-451c-94db-01cb1118ef7b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : GDI を使用してテキストを描画する
+<xref:System.Windows.Forms.TextRenderer> クラスの <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドを使用すると、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] 機能を利用してフォームまたはコントロールにテキストを描画できます。  [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] のテキスト描画機能は、一般に [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] よりもパフォーマンスが高く、テキストの寸法の計測も正確です。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.TextRenderer> クラスの <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドでは、印刷はサポートされていません。  印刷時には常に <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawString%2A> メソッドを使用してください。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドを使用して、四角形内の複数の行にテキストを描画する方法を示しています。  
+  
+ [!code-csharp[System.Windows.Forms.TextRendererExamples#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.TextRendererExamples/CS/Form1.cs#7)]
+ [!code-vb[System.Windows.Forms.TextRendererExamples#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TextRendererExamples/VB/Form1.vb#7)]  
+  
+ <xref:System.Windows.Forms.TextRenderer> クラス内でテキストを描画するには、<xref:System.Drawing.Graphics> や <xref:System.Drawing.Font> などの <xref:System.Drawing.IDeviceContext>、テキストを描画する位置、および描画する色が必要です。  オプションで、<xref:System.Windows.Forms.TextFormatFlags> 列挙値を使ってテキストの書式を指定することも可能です。  
+  
+ <xref:System.Drawing.Graphics> の取得の詳細については、「[方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)」を参照してください。  <xref:System.Drawing.Font> の構築の詳細については、「[方法 : フォント ファミリとフォントを作成する](../../../../docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md)」を参照してください。  
+  
+## コードのコンパイル  
+ 前述のコード例は Windows フォームでの使用を前提としたものであり、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextRenderer>   
+ <xref:System.Drawing.Font>   
+ <xref:System.Drawing.Color>   
+ <xref:System.Drawing.Color>   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-vertical-text-on-a-windows-form.md b/docs/framework/winforms/advanced/how-to-draw-vertical-text-on-a-windows-form.md
new file mode 100644
index 00000000000..398f9c9429d
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-vertical-text-on-a-windows-form.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォームに縦書きテキストを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "StringFormat.FormatFlags"
+  - "Graphics.DrawString"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "文字列 [Windows フォーム], 描画 (縦書きの)"
+  - "テキスト [Windows フォーム], 描画"
+  - "テキスト [Windows フォーム], 描画 (縦書きの)"
+  - "テキスト [Windows フォーム], 縦書きのテキスト"
+ms.assetid: 717a6131-00f6-4373-b574-9894e8317799
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームに縦書きテキストを描画する
+<xref:System.Drawing.Graphics> の <xref:System.Drawing.Graphics.DrawString%2A> メソッドを使用してフォーム上に縦書きテキストを描画する方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#8](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#8)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#8)]
+ [!code-vb[System.Drawing.ConceptualHowTos#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#8)]  
+  
+## コードのコンパイル  
+ <xref:System.Windows.Forms.Form.Load> イベント ハンドラーでこのメソッドを呼び出すことはできません。  フォームがサイズ変更された場合、または別のフォームによって隠れている場合、描画済みのコンテンツは再描画されません。  コンテンツを自動的に再描画するには、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドする必要があります。  
+  
+## 信頼性の高いプログラミング  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   Arial フォントがインストールされていない。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics.DrawString%2A>   
+ <xref:System.Drawing.StringFormat.FormatFlags%2A>   
+ <xref:System.Drawing.StringFormatFlags>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-with-opaque-and-semitransparent-brushes.md b/docs/framework/winforms/advanced/how-to-draw-with-opaque-and-semitransparent-brushes.md
new file mode 100644
index 00000000000..5a77ab82686
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-with-opaque-and-semitransparent-brushes.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : 不透明ブラシおよび半透明ブラシを使用して描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アルファ ブレンド, ブラシ"
+  - "ブラシ, 使用 (半透明)"
+  - "半透明の図形, 描画"
+  - "透明度, 半透明の図形"
+ms.assetid: a4f6f6b8-3bc8-440a-84af-d62ef0f8ff40
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : 不透明ブラシおよび半透明ブラシを使用して描画する
+図形を塗りつぶすときに<xref:System.Drawing.Brush> オブジェクトを <xref:System.Drawing.Graphics> クラスの fill メソッドの 1 つに渡す必要があります。  <xref:System.Drawing.SolidBrush.%23ctor%2A> コンストラクターのパラメーターの 1 つは、<xref:System.Drawing.Color> オブジェクトです。  不透明な図形を塗りつぶすには、色のアルファ コンポーネントを 255 に設定します。  半透明な図形を塗りつぶすには、アルファ コンポーネントを 1 ～ 254 の値に設定します。  
+  
+ 半透明な図形を塗りつぶすするとき、図形の色は、背景の色とブレンドされます。  アルファ コンポーネントは、図形と背景色が混在する方法を指定します。0 に近いのアルファ値は、背景色の比重が高く、255 に近いアルファ値は、図形の色の比重が高くなります。  
+  
+## 使用例  
+ 次の例では、ビットマップを描画し、ビットマップの重複する 3 つの楕円を塗りつぶします。  最初の楕円はアルファ コンポーネントに 255 を使用するので、不透明です。  2 番目と 3 番目の楕円は、アルファ コンポーネントに 128 を使用するので、楕円から背景画像を確認できます。  <xref:System.Drawing.Graphics.CompositingQuality%2A> プロパティを設定する呼び出しにより、3 番目の楕円がのブレンドがガンマ補正と組み合わせて実行されます。  
+  
+ 以下のコードの出力を次の図に示します。  
+  
+ ![不透明と半透明](../../../../docs/framework/winforms/advanced/media/compqualellipse.png "compqualellipse")  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.AlphaBlending#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前の例は、Windows フォームで使用するために設計されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` を必要とします。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)   
+ [方法 : コントロールに透明な背景を指定する](../../../../docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md)   
+ [方法 : 不透明な直線および半透明な直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md b/docs/framework/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md
new file mode 100644
index 00000000000..b0f35579b46
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : 四角形内にテキストを折り返して描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "文字列 [Windows フォーム], 描画 (四角形の中に)"
+  - "テキスト [Windows フォーム], 描画 (四角形の中に)"
+  - "Windows フォーム, 描画 (テキストを四角形の中に)"
+ms.assetid: e1fb432a-dc90-48b5-9b6b-acc14507133d
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 四角形内にテキストを折り返して描画する
+<xref:System.Drawing.Graphics> クラスのオーバーロードされた <xref:System.Drawing.Graphics.DrawString%2A> メソッドに <xref:System.Drawing.Rectangle> パラメーターまたは <xref:System.Drawing.RectangleF> パラメーターを渡して呼び出すと、四角形内にテキストを折り返して描画できます。  このとき、<xref:System.Drawing.Brush> と <xref:System.Drawing.Font> も使用します。  
+  
+ または、<xref:System.Windows.Forms.TextRenderer> のオーバーロードされた <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドに <xref:System.Drawing.Rectangle> パラメーターと <xref:System.Windows.Forms.TextFormatFlags> パラメーターを渡して呼び出しても、四角形内にテキストを折り返して描画できます。  このとき、<xref:System.Drawing.Color> と <xref:System.Drawing.Font> も使用します。  
+  
+ <xref:System.Drawing.Graphics.DrawString%2A> メソッドを使用して、四角形内にテキストを描画すると、次のように出力されます。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/csfontstext2.png "csfontstext2")  
+  
+### GDI\+ を使用して、テキストを四角形内に折り返して描画するには  
+  
+1.  オーバーロードされた <xref:System.Drawing.Graphics.DrawString%2A> メソッドに描画するテキスト、<xref:System.Drawing.Rectangle> \(または <xref:System.Drawing.RectangleF>\)、<xref:System.Drawing.Font> および <xref:System.Drawing.Brush> を渡して使用します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#50](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#50)]
+     [!code-vb[System.Drawing.AlignDrawnText#50](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#50)]  
+  
+### GDI を使用して、テキストを四角形内に描画するには  
+  
+1.  <xref:System.Windows.Forms.TextFormatFlags> 列挙値を使用し、オーバーロードされた <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドに描画するテキスト、<xref:System.Drawing.Rectangle>、<xref:System.Drawing.Font>、および <xref:System.Drawing.Color> を渡して、テキストを折り返すことを指定します。  
+  
+     [!code-csharp[System.Drawing.AlignDrawnText#60](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/CS/Form1.cs#60)]
+     [!code-vb[System.Drawing.AlignDrawnText#60](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlignDrawnText/VB/Form1.vb#60)]  
+  
+## コードのコンパイル  
+ 上記の例では、次のものが必要です。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs> `e`。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+## 参照  
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [方法 : フォント ファミリとフォントを作成する](../../../../docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md)   
+ [方法 : テキストを指定の位置に描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-at-a-specified-location.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-enumerate-installed-fonts.md b/docs/framework/winforms/advanced/how-to-enumerate-installed-fonts.md
new file mode 100644
index 00000000000..21b1493780b
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-enumerate-installed-fonts.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : インストールされているフォントを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], フォント"
+  - "フォント, 列挙 (インストールされている)"
+ms.assetid: 26d74ef5-0f39-4eeb-8d20-00e66e014abe
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : インストールされているフォントを列挙する
+<xref:System.Drawing.Text.InstalledFontCollection> クラスは、<xref:System.Drawing.Text.FontCollection> 抽象基本クラスを継承します。  <xref:System.Drawing.Text.InstalledFontCollection> オブジェクトを使用すると、コンピューターにインストールされているフォントを列挙できます。  <xref:System.Drawing.Text.InstalledFontCollection> オブジェクトの <xref:System.Drawing.Text.FontCollection.Families%2A> プロパティは、<xref:System.Drawing.FontFamily> オブジェクトの配列です。  
+  
+## 使用例  
+ コンピューターにインストールされている全フォント ファミリの名前を一覧表示する例を次に示します。  このコードは、<xref:System.Drawing.Text.FontCollection.Families%2A> プロパティによって返される配列内の各 <xref:System.Drawing.FontFamily> オブジェクトの <xref:System.Drawing.FontFamily.Name%2A> プロパティを取得します。  ファミリ名が取得されると、それらの名前を連結したコンマ区切りのリストが形成されます。  その後、<xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawString%2A> メソッドが、そのコンマ区切りのリストを四角形の内部に描画します。  
+  
+ このコード例を実行した場合、次の図に示すような出力が生成されます。  
+  
+ ![インストール済みフォント](../../../../docs/framework/winforms/advanced/media/csfontstext6.png "csfontstext6")  
+  
+ [!code-csharp[System.Drawing.FontsAndText#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.FontsAndText#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  さらに、<xref:System.Drawing.Text> 名前空間をインポートする必要があります。  
+  
+## 参照  
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-extract-the-icon-associated-with-a-file-in-windows-forms.md b/docs/framework/winforms/advanced/how-to-extract-the-icon-associated-with-a-file-in-windows-forms.md
new file mode 100644
index 00000000000..0aaec2b64a5
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-extract-the-icon-associated-with-a-file-in-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : Windows フォームでファイルに関連付けられているアイコンを抽出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "表示 (ListView コントロールにファイル名とファイルの種類のアイコンを) [Windows フォーム]"
+  - "抽出 (ファイルの種類に関連付けられているアイコンを) [Windows フォーム]"
+  - "ファイル名の拡張子のアイコン [Windows フォーム], 表示 (ListView に)"
+ms.assetid: 88e2ad8b-c34f-415a-84f2-dad756b5c928
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : Windows フォームでファイルに関連付けられているアイコンを抽出する
+多くのファイルには、関連付けられたファイルの種類をビジュアルに表すアイコンが埋め込まれています。  たとえば、Microsoft Word 文書には Word 文書として識別されるアイコンが含まれています。  リスト コントロールまたはテーブル コントロールにファイルの一覧を表示するときは、各ファイル名の横にファイルの種類を表すアイコンを表示すると便利な場合があります。  <xref:System.Drawing.Icon.ExtractAssociatedIcon%2A> メソッドを使用すると、この操作を簡単に実行できます。  
+  
+## 使用例  
+ 次のコード例は、ファイルに関連付けられているアイコンを抽出し、そのアイコンとファイル名を <xref:System.Windows.Forms.ListView> コントロールに表示する方法を示しています。  
+  
+ [!code-csharp[System.Drawing.Icon.ExtractAssociatedIconEx#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Icon.ExtractAssociatedIconEx/CS/Form1.cs#1)]
+ [!code-vb[System.Drawing.Icon.ExtractAssociatedIconEx#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Icon.ExtractAssociatedIconEx/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例をコンパイルするには、次の操作を行います。  
+  
+-   前のコードを Windows フォームに貼り付け、フォームのコンストラクターまたは <xref:System.Windows.Forms.Form.Load> イベント処理メソッドから `ExtractAssociatedIconExample` を呼び出します。  
+  
+     フォームには <xref:System.IO> 名前空間をインポートする必要があります。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-hatch-pattern.md b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-hatch-pattern.md
new file mode 100644
index 00000000000..1ba0fdabb84
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-hatch-pattern.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : ハッチ パターンで図形を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ブラシ, 使用 (ハッチ ブラシを)"
+  - "パターン, 追加 (図形に)"
+  - "形状, 塗りつぶし (パターンで)"
+ms.assetid: 9c8300ff-187b-404f-af1f-ebd499f5b16f
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ハッチ パターンで図形を塗りつぶす
+ハッチ パターンは、背景色と、背景上にパターンを形成する直線の色という 2 つの色から構成されます。  閉じている図形をハッチ パターンで塗りつぶすには、<xref:System.Drawing.Drawing2D.HatchBrush> オブジェクトを使用します。  楕円をハッチ パターンで塗りつぶす方法を次の例に示します。  
+  
+## 使用例  
+ <xref:System.Drawing.Drawing2D.HatchBrush.%23ctor%2A> コンストラクターは、ハッチ スタイル、ハッチ パターンを形成する直線の色、および背景色を 3 つの引数として受け取ります。  ハッチ スタイル引数には、<xref:System.Drawing.Drawing2D.HatchStyle> 列挙体から任意の値を指定できます。  <xref:System.Drawing.Drawing2D.HatchStyle> 列挙体は 50 を超える要素を保持しています。それらの要素のいくつかを次の一覧に示します。  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+-   <xref:System.Drawing.Drawing2D.HatchStyle>  
+  
+ 塗りつぶされた楕円を次の図に示します。  
+  
+ ![ハッチ パターン](../../../../docs/framework/winforms/advanced/media/hatch1.png "hatch1")  
+  
+ [!code-csharp[System.Drawing.UsingABrush#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.UsingABrush#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#41)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-solid-color.md b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-solid-color.md
new file mode 100644
index 00000000000..46d7da68fc6
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-solid-color.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 純色で図形を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 追加 (図形に)"
+  - "形状, 塗りつぶし"
+ms.assetid: 06088b31-bac9-4ef3-9ebe-06c2c764d6df
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 純色で図形を塗りつぶす
+図形を純色で塗りつぶすには、<xref:System.Drawing.SolidBrush> オブジェクトを作成し、その <xref:System.Drawing.SolidBrush> オブジェクトを、<xref:System.Drawing.Graphics> クラスの塗りつぶしメソッドの 1 つに引数として渡します。  楕円を赤色で塗りつぶす方法を次の例に示します。  
+  
+## 使用例  
+ 次のコードでは、<xref:System.Drawing.SolidBrush.%23ctor%2A> コンストラクターの唯一の引数として <xref:System.Drawing.Color> オブジェクトが渡されています。  <xref:System.Drawing.Color.FromArgb%2A> メソッドで使用されている値は、それぞれ、アルファ、赤、緑、および青の色要素を表します。  これらの各値は、0 から 255 までの範囲内にする必要があります。  最初の 255 は、色の不透明度が最大であることを示し、2 番目の 255 は赤の要素の輝度が最大であることを示します。  残りの 2 つの 0 は、緑と青の要素の輝度が共に 0 であることを示します。  
+  
+ <xref:System.Drawing.Graphics.FillEllipse%2A> メソッドに渡される 4 つの数値 \(0, 0, 100, 60\) は、楕円に外接する四角形の位置とサイズを指定しています。  この四角形は、左上隅が \(0, 0\) の位置にあり、幅が 100、高さが 60 です。  
+  
+ [!code-csharp[System.Drawing.UsingABrush#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.UsingABrush#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-fill-a-shape-with-an-image-texture.md b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-an-image-texture.md
new file mode 100644
index 00000000000..d6e4e34085d
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-fill-a-shape-with-an-image-texture.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : イメージ テクスチャによって図形を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 使用 (テクスチャを)"
+  - "イメージ [Windows フォーム], 使用 (ブラシと共に)"
+  - "形状, 塗りつぶし (イメージで)"
+ms.assetid: 508da5a6-2433-4d2b-9680-eaeae4e96e3b
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : イメージ テクスチャによって図形を塗りつぶす
+<xref:System.Drawing.Image> クラスおよび <xref:System.Drawing.TextureBrush> クラスを使用することによって、閉じている図形をテクスチャで塗りつぶすことができます。  
+  
+## 使用例  
+ 楕円をイメージで塗りつぶす例を次に示します。  このコードは、<xref:System.Drawing.Image> オブジェクトを作成し、その <xref:System.Drawing.Image> オブジェクトのアドレスを <xref:System.Drawing.TextureBrush.%23ctor%2A> コンストラクターに引数として渡します。  3 番目のステートメントでそのイメージを縮小し、4 番目のステートメントでは、縮小したイメージのコピーを繰り返したパターンによって楕円を塗りつぶしています。  
+  
+ 次のコードでは、<xref:System.Drawing.TextureBrush.Transform%2A> プロパティに、イメージが描画される前にそのイメージに適用される変換方法が指定されています。  元のイメージの幅が 640 ピクセルで、高さが 480 ピクセルであることを前提とします。  この変換では、水平方向と垂直方向のスケーリング値を設定することによって、イメージを 75 × 75 に縮小します。  
+  
+> [!NOTE]
+>  次の例では、イメージのサイズが 75 × 75 で、楕円のサイズが 150 × 250 です。  イメージの方が、そのイメージで塗りつぶす対象の楕円よりも小さいため、イメージを並べたパターンによって楕円が表示されます。  イメージを並べるとは、塗りつぶし対象の図形の境界に達するまで、イメージを水平方向と垂直方向に繰り返して表示することを意味します。  イメージを並べて表示する方法の詳細については、「[方法 : イメージを並べたパターンによって図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-tile-a-shape-with-an-image.md)」を参照してください。  
+  
+ [!code-csharp[System.Drawing.UsingABrush#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.UsingABrush#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-fill-open-figures.md b/docs/framework/winforms/advanced/how-to-fill-open-figures.md
new file mode 100644
index 00000000000..3b409009eac
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-fill-open-figures.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 開いている図形を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "図形, 塗りつぶし"
+  - "開いている図形, 塗りつぶし"
+ms.assetid: 5a36b0e4-f1f4-46c0-a85a-22ae98491950
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : 開いている図形を塗りつぶす
+<xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトを <xref:System.Drawing.Graphics.FillPath%2A> メソッドに渡すことによってパスを塗りつぶすことができます。  <xref:System.Drawing.Graphics.FillPath%2A> メソッドは、パスに対して現在設定されている塗りつぶしモード \(alternate または winding\) に基づいて、パスを塗りつぶします。  パスの図形が開いている場合でも、パスはその図形が閉じているかのように塗りつぶされます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、終了点から開始点に直線を描画することによってその図形を閉じます。  
+  
+## 使用例  
+ 開いている図形 \(円弧\) と閉じた図形 \(楕円\) 1 つずつから成るパスを作成する例を次に示します。  <xref:System.Drawing.Graphics.FillPath%2A> メソッドは、既定の塗りつぶしモード <xref:System.Drawing.Drawing2D.FillMode> に基づいてパスを塗りつぶします。  
+  
+ プログラム例による出力を次の図に示します。  パスは、開いている図形が終了点と開始点を結ぶ直線によって閉じられているかのように、<xref:System.Drawing.Drawing2D.FillMode> に基づいて塗りつぶされます。  
+  
+ ![ファイルを開くパス](../../../../docs/framework/winforms/advanced/media/fillopenpath.png "FillOpenPath")  
+  
+ [!code-csharp[System.Drawing.ConstructingDrawingPaths#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.ConstructingDrawingPaths#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConstructingDrawingPaths/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.GraphicsPath>   
+ [GDI\+ でのグラフィックス パス](../../../../docs/framework/winforms/advanced/graphics-paths-in-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md b/docs/framework/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md
new file mode 100644
index 00000000000..b7c6fe287c9
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-flatten-a-curved-path-into-a-line.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 曲線のパスを直線に平坦化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "曲線, 平坦化"
+  - "描画, 平坦化 (曲線を)"
+  - "Flatten メソッド"
+  - "グラフィックス, 平坦化 (曲線を直線に)"
+  - "GraphicsPath オブジェクト"
+  - "パス, 平坦化"
+ms.assetid: e654b8de-25f4-4735-9208-42e4514a589c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 曲線のパスを直線に平坦化する
+<xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトは、複数の直線とベジエ スプラインから成るシーケンスを格納します。  いくつかの種類の曲線 \(楕円、円弧、カーディナル スプライン\) をパスに追加できますが、各曲線は、パス内に格納される前にベジエ スプラインに変換されます。  パスの平坦化は、パス内の各ベジエ スプラインを複数の直線から成るシーケンスに変換する処理です。  1 つのパスが平坦化の前後でどのように変化するかを次の図に示します。  
+  
+ ![直線と曲線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art32a.png "AboutGdip02\_Art32A")  
+  
+### パスを平坦化するには  
+  
+-   <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクトの <xref:System.Drawing.Drawing2D.GraphicsPath.Flatten%2A> メソッドを呼び出します。  <xref:System.Drawing.Drawing2D.GraphicsPath.Flatten%2A> メソッドは、平坦化されたパスと元のパスの間の最大距離を指定する平坦さの引数を受け取ります。  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.GraphicsPath?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-improve-performance-by-avoiding-automatic-scaling.md b/docs/framework/winforms/advanced/how-to-improve-performance-by-avoiding-automatic-scaling.md
new file mode 100644
index 00000000000..a74d79c1f96
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-improve-performance-by-avoiding-automatic-scaling.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : 自動スケーリングを解除してパフォーマンスを向上させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "自動スケーリング"
+  - "イメージ [Windows フォーム], 向上 (パフォーマンスを)"
+  - "イメージ [Windows フォーム], 使用 (自動スケーリングなしで)"
+  - "パフォーマンス, 向上 (イメージ)"
+ms.assetid: 5fe2c95d-8653-4d55-bf0d-e5afa28f223b
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 自動スケーリングを解除してパフォーマンスを向上させる
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、イメージを描画すると自動的にそのイメージがスケーリングされ、これによりパフォーマンスが低下する場合があります。  別の方法として、描画先の四角形の寸法を <xref:System.Drawing.Graphics.DrawImage%2A> メソッドに渡すと、イメージのスケーリングを制御できます。  
+  
+ たとえば、次の <xref:System.Drawing.Graphics.DrawImage%2A> メソッドの呼び出しでは、左上隅の値 \(50, 30\) を指定していますが、描画先の四角形は指定していません。  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.WorkingWithImages#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#31)]  
+  
+ これは、指定する引数の数が少なくて済むという点では一番簡単な形式の <xref:System.Drawing.Graphics.DrawImage%2A> メソッドですが、必ずしも効率的な形式ではありません。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] によって使用される解像度 \(通常は 96 dpi\) が <xref:System.Drawing.Image> オブジェクトに格納されている解像度と異なる場合、イメージは <xref:System.Drawing.Graphics.DrawImage%2A> メソッドによってスケーリングされます。  たとえば、<xref:System.Drawing.Image> オブジェクトの幅が 216 ピクセルで、格納されている水平方向の解像度の値が 72 dpi であるとします。  216\/72 は 3 なので、<xref:System.Drawing.Graphics.DrawImage%2A> は、96 dpi の解像度で幅が 3 インチになるようにイメージをスケーリングします。  つまり、<xref:System.Drawing.Graphics.DrawImage%2A> は、96 × 3 \= 288 ピクセルの幅でイメージを表示します。  
+  
+ 画面解像度が 96 dpi ではない場合でも、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は解像度が 96 dpi であるものとしてイメージをスケーリングします。  これは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] <xref:System.Drawing.Graphics> オブジェクトがデバイス コンテキストに関連付けられているためです。一般的に、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] がデバイス コンテキストに画面解像度を照会すると、実際の画面解像度がどうなっているかにかかわらず、結果は 96 になります。  <xref:System.Drawing.Graphics.DrawImage%2A> メソッドで描画先の四角形を指定すると、自動スケーリングを解除できます。  
+  
+## 使用例  
+ 同じイメージを 2 回描画する例を次に示します。  1 回目は、描画先の四角形の幅と高さを指定していないため、イメージが自動的にスケーリングされます。  2 回目には、描画先の四角形の幅と高さ \(ピクセル単位\) が、元のイメージの幅と高さと同じになるように指定されています。  2 回描画された結果のイメージを次の図に示します。  
+  
+ ![スケール テクスチャ](../../../../docs/framework/winforms/advanced/media/csscaledtexture1.png "csscaledtexture1")  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#32](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#32)]
+ [!code-vb[System.Drawing.WorkingWithImages#32](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#32)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  Texture.jpg は、システム上で有効なイメージの名前とパスに置き換えてください。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md b/docs/framework/winforms/advanced/how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md
new file mode 100644
index 00000000000..30f552b3de5
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : [継承ピッカー] ダイアログ ボックスを使用してフォームを継承する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "継承、フォーム"
+  - "[継承ピッカー] ダイアログ ボックス"
+  - "継承されたフォーム、作成"
+ms.assetid: 969b4c04-12aa-4297-93a2-0ae747447823
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : [継承ピッカー] ダイアログ ボックスを使用してフォームを継承する
+フォームまたはその他のオブジェクトを継承する最も簡単な方法は、**\[継承ピッカー\]** ダイアログ ボックスを使用することです。  これを使用して、その他のソリューションで作成済みのコードまたはユーザー インターフェイス \(UI\) を利用できます。  
+  
+> [!NOTE]
+>  **\[継承ピッカー\]** ダイアログ ボックスを持つフォームを継承するには、このフォームを含むプロジェクトが、実行可能ファイルまたは DLL に組み込まれている必要があります。  プロジェクトを作成するには、**\[ビルド\]** メニューから **\[ソリューションのビルド\]** を選択します。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 継承ピッカーを使用して既存のフォームから継承された Windows フォームを作成するには  
+  
+1.  **\[プロジェクト\]** メニューから **\[Windows フォームの追加\]** を選択します。  
+  
+     **\[新しい項目の追加\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[継承されたフォーム\]** テンプレートを選択して、**\[名前\]** ボックスで名前を付けます。  **\[追加\]** ボタンをクリックして続行します。  
+  
+     **\[継承ピッカー\]** ダイアログ ボックスが開きます。  現在のプロジェクトに既にフォームが含まれている場合は、**\[継承ピッカー\]** ダイアログ ボックスに表示されます。  
+  
+3.  別のアセンブリのフォームから継承する場合は、**\[参照\]** ボタンをクリックします。  
+  
+4.  **\[継承元コンポーネントを含むファイルの選択\]** ダイアログ ボックスで、必要なフォームまたはモジュールを含むプロジェクトに移動します。  
+  
+5.  選択する .exe ファイルまたは .dll ファイルの名前をクリックしてそれを選択し、**\[開く\]** ボタンをクリックします。  
+  
+     これにより、**\[継承ピッカー\]** ダイアログ ボックスに戻り、ここで、配置されているプロジェクトと共にコンポーネントが一覧表示されます。  
+  
+6.  コンポーネントを選択します。  
+  
+     **ソリューション エクスプローラー**で、コンポーネントがプロジェクトに追加されます。  UI がある場合は、継承されたフォームの一部であるコントロールにはグリフ \(![VisualBasicInheritanceSymbol スクリーンショット](../../../../docs/framework/winforms/advanced/media/vbinheritanceglyph.png "vbInheritanceGlyph")\) のマークが付き、選択すると、コントロールがスーパークラスのフォーム上で持っているセキュリティのレベルを示す罫線も表示されます。  様々なセキュリティ レベルに対応する動作を、次の表に示します。  
+  
+    |コントロールのセキュリティ レベル|継承したフォームを使用したデザイナーとコード エディターの間で使用できる相互作用|  
+    |-----------------------|----------------------------------------------|  
+    |パブリック|サイズ変更ハンドルがある標準の罫線 : コントロールのサイズが変更され、移動される可能性があります。  コントロールは、宣言するクラスにより内部的にアクセスでき、他のクラスにより外部的にアクセスできます。|  
+    |プロテクト|サイズ変更ハンドルがある標準の罫線 : コントロールのサイズが変更され、移動される可能性があります。  宣言するクラス、および親クラスから継承したクラスにより内部的にアクセスできますが、外部クラスによってアクセスすることはできません。|  
+    |保護された内部 \(Visual Basic の保護されたフレンド\)|サイズ変更ハンドルがある標準の罫線 : コントロールのサイズが変更され、移動される可能性があります。  宣言するクラス、親クラスから継承したクラス、およびそれを含むアセンブリのその他のメンバーにより、内部的にアクセスできます。|  
+    |内部 \(Visual Basic のフレンド\)|**\[プロパティ\]** ウィンドウで表示されるプロパティで、フォームに表示される、サイズ変更ハンドルのない標準の罫線。  ただし、コントロールのすべての側面が読み取り専用と見なされます。  コントロールを移動またはサイズ変更したり、プロパティを変更したりできません。  グループ ボックスと同様に、コントロールがその他のコントロールのコンテナーである場合は、これらのコントロールがパブリックでも、新しいコントロールを追加することはできず、既存のコントロールを削除することもできません。  コントロールは、それを含むアセンブリの他のメンバーによってのみアクセスできます。|  
+    |プライベート|**\[プロパティ\]** ウィンドウで表示されるプロパティで、フォームに表示される、サイズ変更ハンドルのない標準の罫線。  ただし、コントロールのすべての側面が読み取り専用と見なされます。  コントロールを移動またはサイズ変更したり、プロパティを変更したりできません。  グループ ボックスと同様に、コントロールがその他のコントロールのコンテナーである場合は、これらのコントロールがパブリックでも、新しいコントロールを追加することはできず、既存のコントロールを削除することもできません。  コントロールは、宣言したクラスによってのみアクセスできます。|  
+  
+     基本フォームの外観を変更する方法については、「[基本フォームの外観を変更した場合の影響](../../../../docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  継承されたコントロールとコンポーネントを、Windows フォーム上の標準的なコントロールとコンポーネントに結合する場合、z オーダーとの競合が発生する可能性があります。  これは、**\[書式\]** メニュー内でクリックし、**\[順序\]** をポイントして、**\[最前面へ移動\]** または **\[最背面へ移動\]**.をクリックして z オーダーを変更することで修正できます。  コントロールの z オーダーに関する詳細については、「[方法 : Windows フォーム上のオブジェクトをレイヤー化する](../../../../docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ [Inherits Statement](../../../../ocs/visual-basic/language-reference/statements/inherits-statement.md)   
+ [使用](../Topic/using%20\(C%23%20Reference\).md)   
+ [基本フォームの外観を変更した場合の影響](../../../../docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md)   
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-inherit-windows-forms.md b/docs/framework/winforms/advanced/how-to-inherit-windows-forms.md
new file mode 100644
index 00000000000..ccede8bcb60
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-inherit-windows-forms.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : Windows フォームを継承する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "継承, フォーム"
+  - "継承フォーム, 作成 (実行時に)"
+  - "Windows フォーム, 継承"
+ms.assetid: cb3e1c0f-3d2a-4cdc-b0d1-c92eae567ffb
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームを継承する
+新規の Windows フォームは、基本フォームから継承して簡単に複製できます。フォームが必要になるたびに、最初から作成し直す必要はありません。  
+  
+ デザイン時に **\[継承ピッカー\]** ダイアログ ボックスを使用してフォームを継承する方法、および継承されるコントロールのセキュリティ レベルを視覚的に区別する方法の詳細については、「[方法: &#91;継承ピッカー&#93; ダイアログ ボックスを使用してフォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md)」を参照してください。  
+  
+ **メモ** フォームを継承するには、実行可能ファイルまたはダイナミック リンク ライブラリ \(DLL: Dynamic Link Library\) の形式で、継承元のフォームを含むファイルや名前空間を作成しておく必要があります。  プロジェクトを作成するには、**\[ビルド\]** メニューの **\[ビルド\]** を選択します。  また、フォームの継承先となるクラスに、名前空間への参照を追加する必要があります。  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### プログラムによってフォームを継承するには  
+  
+1.  クラスに、継承元のフォームを含む名前空間への参照を追加します。  
+  
+2.  クラス定義に、継承元のフォームへの参照を追加します。  参照では、フォームを含んでいる名前空間を指定し、その後にピリオド、続いて基本フォーム自体の名前を指定します。  
+  
+    ```vb  
+    Public Class Form2  
+        Inherits Namespace1.Form1  
+  
+    ```  
+  
+    ```csharp  
+    public class Form2 : Namespace1.Form1  
+  
+    ```  
+  
+ フォームを継承する場合は、イベント ハンドラーが 2 回呼び出されることで問題が発生する可能性があることに注意してください。これは、各イベントが基底クラスと継承クラスの両方によって処理されるためです。  この問題を回避する方法の詳細については、「[Visual Basic で継承されたイベント ハンドラーのトラブルシューティング](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)」を参照してください。  
+  
+## 参照  
+ [Inherits Statement](../../../../ocs/visual-basic/language-reference/statements/inherits-statement.md)   
+ [Imports Statement \(.NET Namespace and Type\)](../../../../ocs/visual-basic/language-reference/statements/imports-statement-net-namespace-and-type.md)   
+ [使用](../Topic/using%20\(C%23%20Reference\).md)   
+ [基本フォームの外観を変更した場合の影響](../../../../docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md)   
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-join-lines.md b/docs/framework/winforms/advanced/how-to-join-lines.md
new file mode 100644
index 00000000000..4d24ab828b8
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-join-lines.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : 直線を接合する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "面取り (直線の接合スタイル)"
+  - "描画, 接合 (直線を)"
+  - "グラフィックス, 接合 (直線を)"
+  - "GraphicsPath オブジェクト"
+  - "直線の接合"
+  - "線, 結合"
+  - "鋭角 (直線の接合スタイル)"
+  - "Pen クラス"
+  - "角丸 (直線の接合スタイル)"
+ms.assetid: 9fc480c2-3c75-4fd1-8ab5-296a99e820e2
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 直線を接合する
+直線の接合部とは、2 本の直線の端が交わることによって形成される共通領域のことです。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、直線の接合スタイルとして、鋭角、面取り、および角丸の 3 つのスタイルを提供しています。  直線の接合スタイルは、<xref:System.Drawing.Pen> クラスのプロパティです。  <xref:System.Drawing.Pen> オブジェクトに対して直線の接合スタイルを指定すると、そのペンで描画された <xref:System.Drawing.Drawing2D.GraphicsPath> オブジェクト内の連結されたすべての直線に対して、その接合スタイルが適用されます。  
+  
+ 直線の面取り接合の結果を次の図に示します。  
+  
+ ![ペン](../../../../docs/framework/winforms/advanced/media/pens5.png "pens5")  
+  
+## 使用例  
+ 直線の接合スタイルを指定するには、<xref:System.Drawing.Pen> クラスの <xref:System.Drawing.Pen.LineJoin%2A> プロパティを使用します。  水平方向の直線と垂直方向の直線の接合部に面取り接合スタイルを適用する例を次に示します。  次のコードで <xref:System.Drawing.Pen.LineJoin%2A> プロパティに割り当てられた値 <xref:System.Drawing.Drawing2D.LineJoin> は、<xref:System.Drawing.Drawing2D.LineJoin> 列挙体のメンバーです。  <xref:System.Drawing.Drawing2D.LineJoin> 列挙体のその他のメンバーには、<xref:System.Drawing.Drawing2D.LineJoin> および <xref:System.Drawing.Drawing2D.LineJoin> があります。  
+  
+ [!code-csharp[System.Drawing.UsingAPen#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.UsingAPen#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-list-installed-decoders.md b/docs/framework/winforms/advanced/how-to-list-installed-decoders.md
new file mode 100644
index 00000000000..98e0cd13184
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-list-installed-decoders.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : インストールされたデコーダーの一覧 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ コーデック, リスト"
+  - "イメージ デコーダー, リスト"
+ms.assetid: 11417191-8c95-40ca-8024-779e61706fb6
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : インストールされたデコーダーの一覧
+コンピューター上で使用可能なイメージ デコーダーを一覧表示して、使用するアプリケーションが特定のイメージ ファイル形式を読み取ることができるかどうかを確認することがあります。  <xref:System.Drawing.Imaging.ImageCodecInfo> クラスは、使用可能なイメージ デコーダーを確認できる <xref:System.Drawing.Imaging.ImageCodecInfo.GetImageDecoders%2A> 静的メソッドを提供します。  <xref:System.Drawing.Imaging.ImageCodecInfo.GetImageDecoders%2A> は、<xref:System.Drawing.Imaging.ImageCodecInfo> オブジェクトの配列を返します。  
+  
+## 使用例  
+ インストールされているデコーダーとそのプロパティ値の一覧を出力する方法を次のコード例に示します。  
+  
+ [!code-csharp[UsingImageEncodersDecoders#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#2)]
+ [!code-vb[UsingImageEncodersDecoders#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#2)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Windows フォーム アプリケーション。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs>。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+## 参照  
+ [方法 : インストールされたエンコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-encoders.md)   
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-list-installed-encoders.md b/docs/framework/winforms/advanced/how-to-list-installed-encoders.md
new file mode 100644
index 00000000000..6d2e0a9c575
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-list-installed-encoders.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : インストールされたエンコーダーの一覧 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ コーデック, リスト"
+  - "イメージ エンコーダー, リスト"
+ms.assetid: 49e8e4e9-7a67-42d9-86bf-08821cdc282e
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : インストールされたエンコーダーの一覧
+コンピューター上で使用可能なイメージ エンコーダーを一覧表示して、使用するアプリケーションが特定のイメージ ファイル形式に保存できるかどうかを確認することがあります。  <xref:System.Drawing.Imaging.ImageCodecInfo> クラスは、使用可能なイメージ エンコーダーを確認できる <xref:System.Drawing.Imaging.ImageCodecInfo.GetImageEncoders%2A> 静的メソッドを提供します。  <xref:System.Drawing.Imaging.ImageCodecInfo.GetImageEncoders%2A> は、<xref:System.Drawing.Imaging.ImageCodecInfo> オブジェクトの配列を返します。  
+  
+## 使用例  
+ インストールされているエンコーダーとそのプロパティ値の一覧を出力する方法を次のコード例に示します。  
+  
+ [!code-csharp[UsingImageEncodersDecoders#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#1)]
+ [!code-vb[UsingImageEncodersDecoders#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Windows フォーム アプリケーション。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs>。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+## 参照  
+ [方法 : インストールされたデコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-decoders.md)   
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-load-and-display-metafiles.md b/docs/framework/winforms/advanced/how-to-load-and-display-metafiles.md
new file mode 100644
index 00000000000..38630e278e1
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-load-and-display-metafiles.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : メタファイルを読み込んで表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], メタファイル"
+  - "メタファイル, 表示"
+ms.assetid: 60af1714-f148-4d85-a739-0557965ffa73
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : メタファイルを読み込んで表示する
+<xref:System.Drawing.Imaging.Metafile> クラスは、<xref:System.Drawing.Image> クラスから継承したクラスで、ベクター イメージを記録、表示、チェックするためのメソッドが用意されています。  
+  
+## 使用例  
+ 画面にベクター イメージ \(メタファイル\) を表示するには、<xref:System.Drawing.Imaging.Metafile> オブジェクトと <xref:System.Drawing.Graphics> オブジェクトが必要です。  ファイルまたはストリームの名前を <xref:System.Drawing.Imaging.Metafile> コンストラクターに渡します。  <xref:System.Drawing.Imaging.Metafile> オブジェクトを作成した後に、その <xref:System.Drawing.Imaging.Metafile> オブジェクトを <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドに渡します。  
+  
+ 例では、EMF ファイル \(拡張メタファイル\) から <xref:System.Drawing.Imaging.Metafile> オブジェクトを作成し、左上隅が \(60, 10\) の位置にあるイメージを描画します。  
+  
+ 指定された位置に描画されたメタファイルを次の図に示します。  
+  
+ ![イメージ ポジション](../../../../docs/framework/winforms/advanced/media/imageposition2.png "imageposition2")  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.WorkingWithImages#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#41)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md b/docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md
new file mode 100644
index 00000000000..3ee64b8b0ff
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : バッファリングされたグラフィックスを手動で管理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BufferedGraphicsContext クラス"
+  - "ちらつき, 軽減 (グラフィックスを手動で管理することで)"
+  - "グラフィックス, 管理 (バッファーに格納された)"
+ms.assetid: 4c2a90ee-bbbe-4ff6-9170-1b06c195c918
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : バッファリングされたグラフィックスを手動で管理する
+高度なダブル バッファリング シナリオでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] クラスを使用して独自のダブル バッファリング ロジックを実装できます。  個々のグラフィックス バッファーの割り当てと管理を担当するクラスは <xref:System.Drawing.BufferedGraphicsContext> クラスです。  各アプリケーションには、そのアプリケーションの既定のダブル バッファリングをすべて管理する、それぞれ独自の既定の <xref:System.Drawing.BufferedGraphicsContext> があります。  このインスタンスへの参照は、<xref:System.Drawing.BufferedGraphicsManager.Current%2A> を呼び出して取得できます。  
+  
+### 既定の BufferedGraphicsContext への参照を取得するには  
+  
+-   次のコード例に示すように、<xref:System.Drawing.BufferedGraphicsManager.Current%2A> プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#11)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#11)]  
+  
+    > [!NOTE]
+    >  <xref:System.Drawing.BufferedGraphicsManager> クラスから受け取る <xref:System.Drawing.BufferedGraphicsContext> 参照で `Dispose` メソッドを呼び出す必要はありません。  <xref:System.Drawing.BufferedGraphicsManager> は、既定の <xref:System.Drawing.BufferedGraphicsContext> インスタンスのメモリの割り当てと配布をすべて処理します。  
+  
+     アニメーションなど、グラフィックスを多用するアプリケーションでは、<xref:System.Drawing.BufferedGraphicsManager> が提供する <xref:System.Drawing.BufferedGraphicsContext> ではなく、専用の <xref:System.Drawing.BufferedGraphicsContext> を使用することによってパフォーマンスを向上できる場合があります。  これによって、アプリケーションに関連する他のバッファー内グラフィックスをすべて管理することによるパフォーマンスのオーバーヘッドを生じることなく、グラフィックス バッファーを個々に作成および管理できます。ただし、アプリケーションが消費するメモリは多くなります。  
+  
+### 専用の BufferedGraphicsContext を作成するには  
+  
+-   次のコード例に示すように、<xref:System.Drawing.BufferedGraphicsContext> クラスの新しいインスタンスを宣言して作成します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#12)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#12)]  
+  
+## 参照  
+ <xref:System.Drawing.BufferedGraphicsContext>   
+ [ダブル バッファリングされたグラフィックス](../../../../docs/framework/winforms/advanced/double-buffered-graphics.md)   
+ [方法 : バッファリングされたグラフィックスを手動で描画する](../../../../docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md b/docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md
new file mode 100644
index 00000000000..ef7a7204472
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : バッファリングされたグラフィックスを手動で描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BufferedGraphics クラス"
+  - "ちらつき, 軽減 (グラフィックスを手動で描画することで)"
+  - "グラフィックス [Windows フォーム], 描画"
+ms.assetid: 5192295e-bd8e-45f7-8bd6-5c4f6bd21e61
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : バッファリングされたグラフィックスを手動で描画する
+独自のバッファリングされたグラフィックスを管理している場合は、グラフィックス バッファーを作成して表示できるようにする必要があります。  <xref:System.Drawing.BufferedGraphicsContext.Allocate%2A> メソッドを呼び出すことで、画面の描画サーフェイスに関連付けられている <xref:System.Drawing.BufferedGraphics> クラスのインスタンスを作成できます。  このメソッドは、フォームやコントロールなど、特定の表示サーフェイスに関連付けられている <xref:System.Drawing.BufferedGraphics> インスタンスを作成します。  <xref:System.Drawing.BufferedGraphics> インスタンスを作成した後、<xref:System.Drawing.BufferedGraphics.Graphics%2A> プロパティを通じて表すバッファーにグラフィックスを描画することができます。  グラフィックスのすべての操作を実行した後で、<xref:System.Drawing.BufferedGraphics.Render%2A> メソッドを呼び出すことで、バッファーの内容を画面にコピーできます。  
+  
+> [!NOTE]
+>  独自の表示を実行する場合、わずかですがメモリ消費量が増加します。  
+  
+### バッファリングされたグラフィックスを手動で描画するには  
+  
+1.  <xref:System.Drawing.BufferedGraphicsContext> クラスのインスタンスへの参照を取得します。  詳細については、「[方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)」を参照してください。  
+  
+2.  次のコード例に示すように、<xref:System.Drawing.BufferedGraphicsContext.Allocate%2A> メソッドを呼び出して <xref:System.Drawing.BufferedGraphics> クラスのインスタンスを作成します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#21)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#21)]  
+  
+3.  <xref:System.Drawing.BufferedGraphics.Graphics%2A> プロパティを設定することで、グラフィックスのバッファーにグラフィックスを描画します。  次に例を示します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#22)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#22)]  
+  
+4.  グラフィックス バッファーへのすべての描画操作が完了したら、次のコード例に示すように、<xref:System.Drawing.BufferedGraphics.Render%2A> メソッドを呼び出して、そのバッファーに関連付けられている描画サーフェイス、または指定された描画サーフェイスのいずれかにバッファーを表示します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#23)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#23)]  
+  
+5.  グラフィックのレンダリングが完了した後、<xref:System.Drawing.BufferedGraphics> インスタンスの `Dispose` メソッドを呼び出し、システム リソースを解放します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#24](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#24)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#24](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#24)]  
+  
+## 参照  
+ <xref:System.Drawing.BufferedGraphicsContext>   
+ <xref:System.Drawing.BufferedGraphics>   
+ [ダブル バッファリングされたグラフィックス](../../../../docs/framework/winforms/advanced/double-buffered-graphics.md)   
+ [方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-obtain-font-metrics.md b/docs/framework/winforms/advanced/how-to-obtain-font-metrics.md
new file mode 100644
index 00000000000..1ecf3a67dae
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-obtain-font-metrics.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : フォント メトリックを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント メトリック, 取得"
+  - "フォント, 取得 (メトリックを)"
+ms.assetid: ff7c0616-67f7-4fa2-84ee-b8d642f2b09b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : フォント メトリックを取得する
+<xref:System.Drawing.FontFamily> クラスには、特定のファミリとスタイルの組み合わせに対して各種のメトリックを取得する次のメソッドが用意されています。  
+  
+-   <xref:System.Drawing.FontFamily.GetEmHeight%2A>\(FontStyle\)  
+  
+-   <xref:System.Drawing.FontFamily.GetCellAscent%2A>\(FontStyle\)  
+  
+-   <xref:System.Drawing.FontFamily.GetCellDescent%2A>\(FontStyle\)  
+  
+-   <xref:System.Drawing.FontFamily.GetLineSpacing%2A>\(FontStyle\)  
+  
+ これらのメソッドによって返される数値は、フォントのデザイン単位で測定され、特定の <xref:System.Drawing.Font> オブジェクトのサイズや単位には依存しません。  
+  
+ 各種のメトリックを次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/fontstext7a.png "fontstext7A")  
+  
+## 使用例  
+ Arial フォント ファミリの標準スタイルのメトリックの例を次に示します。  このコードでは、Arial ファミリに基づいてサイズが 16 ピクセルの <xref:System.Drawing.Font> オブジェクトも作成し、この特定の <xref:System.Drawing.Font> オブジェクトのメトリック \(ピクセル単位\) を表示します。  
+  
+ プログラム例による出力を次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/csfontstext8.png "csFontsText8")  
+  
+ 上の図に示されている出力の最初の 2 行に注目してください。  <xref:System.Drawing.Font> オブジェクトはサイズとして 16 を返し、<xref:System.Drawing.FontFamily> オブジェクトは高さとして 2,048 em を返します。  これら 2 つの数値 \(16 および 2,048\) は、フォントのデザイン単位と <xref:System.Drawing.Font> オブジェクトの単位 \(この場合はピクセル\) の変換のキーとなります。  
+  
+ たとえば、次のように、アセントをデザイン単位からピクセル単位に変換できます。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/fontstext9.png "FontsText9")  
+  
+ 次のコードは、<xref:System.Drawing.PointF> オブジェクトの <xref:System.Drawing.PointF.Y%2A> データ メンバーを設定することによって、テキストを垂直方向に配置しています。  y 座標は、テキストを改行するたびに `font.Height` ずつ増加します。  <xref:System.Drawing.Font> オブジェクトの <xref:System.Drawing.Font.Height%2A> プロパティは、その特定の <xref:System.Drawing.Font> オブジェクトの行間隔 \(ピクセル単位\) を返します。  この例では、<xref:System.Drawing.Font.Height%2A> によって返される数字は 19 です。  これは、行間隔をピクセル単位に変換して得られる数値 \(小数値は四捨五入\) と同じです。  
+  
+ em 高 \(サイズまたは em サイズともいいます\) は、アセントとディセントの合計ではないことに注意してください。  アセントとディセントの合計は、セル高と呼ばれます。  セル高から内部レディングを引いたものが、em 高です。  セルの高さに外部レディングを加えた値が、行間隔になります。  
+  
+ [!code-csharp[System.Drawing.FontsAndText#71](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#71)]
+ [!code-vb[System.Drawing.FontsAndText#71](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#71)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-perform-drag-and-drop-operations-between-applications.md b/docs/framework/winforms/advanced/how-to-perform-drag-and-drop-operations-between-applications.md
new file mode 100644
index 00000000000..f1c97294d1a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-perform-drag-and-drop-operations-between-applications.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : アプリケーション間でドラッグ アンド ドロップ操作を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ, アプリケーション間の"
+ms.assetid: fa347436-2b12-4dd6-8507-59d7241f6a06
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : アプリケーション間でドラッグ アンド ドロップ操作を実行する
+アプリケーション間でのドラッグ アンド ドロップ操作の実行は、アプリケーション内での場合と同じですが、両方のアプリケーションが <xref:System.Windows.Forms.DragEventArgs.AllowedEffect%2A> プロパティと <xref:System.Windows.Forms.DragEventArgs.Effect%2A> プロパティの間で確立された "契約" に従って動作する必要があります。  
+  
+ 次の手順では、作成した Windows ベースのアプリケーションと、Windows オペレーティング システムに含まれるワードパッドというワード プロセッサを使用して、アプリケーション間でのドラッグ アンド ドロップ操作を行います。  ワードパッドには、ドラッグ アンド ドロップされたテキストに対して実行できる処理のセットが定義されています。コードを記述する Windows ベースのアプリケーションはこれらの効果に従って動作するため、ドラッグ アンド ドロップ操作を正常に完了できます。  
+  
+### アプリケーション間でドラッグ アンド ドロップ手順を実行するには  
+  
+1.  新しい Windows フォーム アプリケーションを作成します。  
+  
+2.  フォームに <xref:System.Windows.Forms.TextBox> コントロールを追加します。  
+  
+3.  ドロップされたデータを受け取るように <xref:System.Windows.Forms.TextBox> コントロールを設定します。  
+  
+     詳細については、「[チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行](../../../../docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md)」を参照してください。  
+  
+4.  作成した Windows ベースのアプリケーションを実行し、アプリケーションの実行中にワードパッドを起動します。  
+  
+     ワードパッドは、Windows によってインストールされるテキスト エディターであり、ドラッグ アンド ドロップ操作をサポートします。  ワードパッドを起動するには、\[**スタート**\] ボタンをクリックし、\[**ファイル名を指定して実行**\] を選択し、\[**ファイル名を指定して実行**\] ダイアログ ボックスのテキスト ボックスに「`WordPad`」と入力し、\[**OK**\] をクリックします。  
+  
+5.  ワードパッドが起動したら、テキストの文字列を入力します。  
+  
+6.  マウスを使用してテキストを選択し、選択したテキストを Windows ベースのアプリケーションの <xref:System.Windows.Forms.TextBox> コントロールにドラッグします。  
+  
+     マウスを <xref:System.Windows.Forms.TextBox> コントロールに移動すると \(そして、その結果 <xref:System.Windows.Forms.Control.DragEnter> イベントが発生すると\)、マウス ポインターの形が変化し、選択したテキストを <xref:System.Windows.Forms.TextBox> コントロールにドロップできます。  
+  
+     また、テキスト文字列をワードパッドにドラッグ アンド ドロップできるように <xref:System.Windows.Forms.TextBox> コントロールを設定することもできます。  詳細については、「[チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行](../../../../docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ [方法 : クリップボードにデータを追加する](../../../../docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md)   
+ [方法 : クリップボードからデータを取得する](../../../../docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md)   
+ [ドラッグ アンド ドロップ操作とクリップボードのサポート](../../../../docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md b/docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md
new file mode 100644
index 00000000000..a25b644c40c
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォームで複数ページのテキスト ファイルを印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷 [Windows フォーム], 印刷 (複数のページを)"
+  - "印刷 [Windows フォーム], テキスト"
+  - "テキスト, 印刷 (Windows フォームを)"
+  - "Windows フォーム, 印刷 (テキストを)"
+ms.assetid: 362427f8-03d4-4826-b49f-60ab066ad322
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 方法 : Windows フォームで複数ページのテキスト ファイルを印刷する
+Windows ベースのアプリケーションでは、テキストを印刷することは非常に一般的です。  <xref:System.Drawing.Graphics> クラスは、画面やプリンターなどのデバイスにオブジェクト \(グラフィックスやテキスト\) を描画するためのメソッドを提供します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.TextRenderer> の <xref:System.Windows.Forms.TextRenderer.DrawText%2A> メソッドでは、印刷はサポートされていません。  印刷用にテキストを描画するには、次のコード例で示すように、<xref:System.Drawing.Graphics> の <xref:System.Drawing.Graphics.DrawString%2A> メソッドを常に使用する必要があります。  
+  
+### テキストを印刷するには  
+  
+1.  フォームに <xref:System.Drawing.Printing.PrintDocument> コンポーネントと文字列を追加します。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintExamples#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/CS/Form1.cs#8)]
+     [!code-vb[System.Drawing.Printing.PrintExamples#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/VB/Form1.vb#8)]  
+  
+2.  ドキュメントを印刷する場合は、<xref:System.Drawing.Printing.PrintDocument.DocumentName%2A> プロパティを印刷するドキュメントに設定し、ドキュメントの内容を開いて前に追加した文字列に読み取ります。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintExamples#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/CS/Form1.cs#1)]
+     [!code-vb[System.Drawing.Printing.PrintExamples#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/VB/Form1.vb#1)]  
+  
+3.  <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント ハンドラーで、<xref:System.Drawing.Printing.PrintPageEventArgs> クラスの <xref:System.Drawing.Printing.PrintPageEventArgs.Graphics%2A> プロパティとドキュメントの内容を使用して、行の長さと 1 ページあたりの行数を計算します。  各ページを描画した後で、最後のページかどうかを確認し、<xref:System.Drawing.Printing.PrintPageEventArgs> の <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A> プロパティを適切に設定します。  <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A> が `false` になるまで <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントが発生します。  また、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントがイベント処理メソッドに関連付けられていることを確認します。  
+  
+     次のコード例では、イベント ハンドラーは、フォームで使用されているものと同じフォントで "testPage.txt" ファイルの内容を印刷するために使用されます。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintExamples#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/CS/Form1.cs#2)]
+     [!code-vb[System.Drawing.Printing.PrintExamples#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/VB/Form1.vb#2)]  
+  
+4.  <xref:System.Drawing.Printing.PrintDocument.Print%2A> メソッドを呼び出して <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントを発生させます。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintExamples#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/CS/Form1.cs#5)]
+     [!code-vb[System.Drawing.Printing.PrintExamples#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/VB/Form1.vb#5)]  
+  
+## 使用例  
+ [!code-csharp[System.Drawing.Printing.PrintExamples#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/CS/Form1.cs#0)]
+ [!code-vb[System.Drawing.Printing.PrintExamples#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintExamples/VB/Form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   ドライブ C:\\ のルートにある、印刷するテキストを含む testPage.txt という名前のテキスト ファイル。  別のファイルを印刷するようコードを編集します。  
+  
+-   System、System.Windows.Forms、System.Drawing の各アセンブリへの参照。  
+  
+-   [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics>   
+ <xref:System.Drawing.Brush>   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-print-a-windows-form.md b/docs/framework/winforms/advanced/how-to-print-a-windows-form.md
new file mode 100644
index 00000000000..5436cfa4ebe
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-print-a-windows-form.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : Windows フォームを印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷 [Windows フォーム], 印刷 (フォームの)"
+  - "印刷 [Windows フォーム]"
+  - "印刷 (フォームの)"
+  - "Windows フォーム, 印刷"
+ms.assetid: c8dff5f8-f56a-4c07-ae31-64643b31f8fc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームを印刷する
+開発プロセスにおいて、多くの場合、Windows フォームのコピーを印刷する必要があります。  現在のフォームのコピーを <xref:System.Drawing.Graphics.CopyFromScreen%2A> メソッドを使用して印刷する方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-csharp[System.Drawing.Graphics.CopyFromScreen#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Graphics.CopyFromScreen/CS/Form1.cs#1)]
+ [!code-vb[System.Drawing.Graphics.CopyFromScreen#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Graphics.CopyFromScreen/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ これは、`Main` メソッドを含むコード全体の例です。  
+  
+## 信頼性の高いプログラミング  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   プリンターへのアクセス許可がない。  
+  
+-   プリンターがインストールされていない。  
+  
+## .NET Framework セキュリティ  
+ このコード例を実行するには、現在のコンピューターで使用しているプリンターへのアクセス許可が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Printing.PrintDocument>   
+ [方法 : GDI\+ を使用してイメージをレンダリングする](../../../../docs/framework/winforms/advanced/how-to-render-images-with-gdi.md)   
+ [方法 : Windows フォームでグラフィックスを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md b/docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md
new file mode 100644
index 00000000000..3ec81d795e4
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md
@@ -0,0 +1,80 @@
+---
+title: "方法 : Windows フォームでグラフィックスを印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, 印刷"
+  - "印刷 [Windows フォーム], グラフィックス"
+ms.assetid: 32b891e6-52ff-4fea-a9ff-2ce5db20a4c6
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : Windows フォームでグラフィックスを印刷する
+Windows ベースのアプリケーションでグラフィックスの印刷が必要になることはよくあります。  <xref:System.Drawing.Graphics> クラスは、画面やプリンターなどのデバイスにオブジェクトを描画する手段を提供します。  
+  
+### グラフィックスを印刷するには  
+  
+1.  フォームに <xref:System.Drawing.Printing.PrintDocument> コンポーネントを追加します。  
+  
+2.  <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント ハンドラーで、<xref:System.Drawing.Printing.PrintPageEventArgs> クラスの <xref:System.Drawing.Printing.PrintPageEventArgs.Graphics%2A> プロパティを使用して、印刷するグラフィックスの種類をプリンターに指示します。  
+  
+     外接する四角形内に青い楕円を作成するために使用されるイベント ハンドラーのコード例を次に示します。  四角形の位置は点 100, 150 で始まり、寸法は幅 250、高さ 250 です。  
+  
+    ```vb  
+    Private Sub PrintDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs) Handles PrintDocument1.PrintPage  
+       e.Graphics.FillEllipse(Brushes.Blue, New Rectangle(100, 150, 250, 250))  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void printDocument1_PrintPage(object sender,   
+    System.Drawing.Printing.PrintPageEventArgs e)  
+    {  
+       e.Graphics.FillRectangle(Brushes.Blue,   
+         new Rectangle(100, 150, 250, 250));  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void printDocument1_PrintPage(System::Object ^ sender,  
+          System::Drawing::Printing::PrintPageEventArgs ^ e)  
+       {  
+          e->Graphics->FillRectangle(Brushes::Blue,  
+             Rectangle(100, 150, 250, 250));  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.printDocument1.PrintPage += new  
+       System.Drawing.Printing.PrintPageEventHandler  
+       (this.printDocument1_PrintPage);  
+  
+    ```  
+  
+    ```cpp  
+    this->printDocument1->PrintPage += gcnew  
+       System::Drawing::Printing::PrintPageEventHandler  
+       (this, &Form1::printDocument1_PrintPage);  
+    ```  
+  
+## 参照  
+ <xref:System.Drawing.Graphics>   
+ <xref:System.Drawing.Brush>   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-print-in-windows-forms-using-print-preview.md b/docs/framework/winforms/advanced/how-to-print-in-windows-forms-using-print-preview.md
new file mode 100644
index 00000000000..0232cc7c10a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-print-in-windows-forms-using-print-preview.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : Windows フォームで印刷プレビューを使用して印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷 [Windows フォーム], 印刷プレビューの使用"
+  - "印刷, 印刷プレビューで"
+  - "印刷プレビュー"
+ms.assetid: 4a16f7e2-ae10-4485-b0ae-3d558334d0fe
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームで印刷プレビューを使用して印刷する
+Windows フォームのプログラミングでは、印刷サービスに加えて印刷プレビューを提供することは非常に一般的です。 印刷プレビューのサービスをアプリケーションに追加する簡単な方法は、ファイルの印刷に <xref:System.Windows.Forms.PrintPreviewDialog> コントロールを <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント処理ロジックと組み合わせて使用することです。  
+  
+### PrintPreviewDialog コントロールのテキスト ドキュメントをプレビューするには  
+  
+1.  フォームに <xref:System.Windows.Forms.PrintPreviewDialog>、<xref:System.Drawing.Printing.PrintDocument>、および 2 つの文字列を追加します。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintPreviewExample#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#1)]
+     [!code-vb[System.Drawing.Printing.PrintPreviewExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#1)]  
+  
+2.  <xref:System.Drawing.Printing.PrintDocument.DocumentName%2A> プロパティを印刷するドキュメントに設定し、ドキュメントの内容を開いて前に追加した文字列に読み取ります。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintPreviewExample#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#2)]
+     [!code-vb[System.Drawing.Printing.PrintPreviewExample#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#2)]  
+  
+3.  ドキュメントの印刷の場合と同様、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント ハンドラーで<xref:System.Drawing.Printing.PrintPageEventArgs> クラスの <xref:System.Drawing.Printing.PrintPageEventArgs.Graphics%2A> プロパティと、ファイルの内容を使用して、1 ページあたりの行数を計算し、ドキュメントの内容を表示します。 各ページを描画した後で、最後のページかどうかを確認し、<xref:System.Drawing.Printing.PrintPageEventArgs> の <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A> プロパティを適切に設定します。<xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A> が `false` になるまで <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントが発生します。 ドキュメントの表示が完了したら、表示される文字列をリセットします。 また、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントがイベント処理メソッドに関連付けられていることを確認します。  
+  
+    > [!NOTE]
+    >  アプリケーションに印刷を実装した場合は、既に手順 2 および 3 を完了している可能性があります。  
+  
+     次のコード例では、イベント ハンドラーが、フォームで使用されているものと同じフォントで "testPage.txt" ファイルの内容を印刷するために使用されます。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintPreviewExample#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#3)]
+     [!code-vb[System.Drawing.Printing.PrintPreviewExample#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#3)]  
+  
+4.  <xref:System.Windows.Forms.PrintPreviewDialog> コントロールの <xref:System.Windows.Forms.PrintPreviewDialog.Document%2A> のプロパティをフォームの <xref:System.Drawing.Printing.PrintDocument> コンポーネントに設定します。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintPreviewExample#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#5)]
+     [!code-vb[System.Drawing.Printing.PrintPreviewExample#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#5)]  
+  
+5.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> コントロールの <xref:System.Windows.Forms.PrintPreviewDialog> メソッドを呼び出します。 通常はボタンの <xref:System.Windows.Forms.Control.Click> イベント処理メソッドから <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> を呼び出します。<xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> を呼び出すことで <xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントが発生し、<xref:System.Windows.Forms.PrintPreviewDialog> コントロールに出力を表示します。 ユーザーが、ダイアログの印刷アイコンをクリックすると、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントがもう一度発生し、プレビュー ダイアログではなく、プリンターに出力を送信します。 これが理由で、手順 3 のレンダリング プロセスの最後に文字列がリセットされます。  
+  
+     次のコード例は、フォームのボタンの <xref:System.Windows.Forms.Control.Click> イベント処理メソッドを示します。 このイベント処理メソッドは、ドキュメントを読み込んで、印刷プレビューのダイアログを表示するメソッドを呼び出します。  
+  
+     [!code-csharp[System.Drawing.Printing.PrintPreviewExample#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#4)]
+     [!code-vb[System.Drawing.Printing.PrintPreviewExample#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#4)]  
+  
+## 使用例  
+ [!code-csharp[System.Drawing.Printing.PrintPreviewExample#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/CS/Form1.cs#0)]
+ [!code-vb[System.Drawing.Printing.PrintPreviewExample#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Printing.PrintPreviewExample/VB/Form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Windows.Forms、System.Drawing の各アセンブリへの参照。  
+  
+-   [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。 また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  また、「[方法: 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md)   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)   
+ [Windows フォームでのより安全な印刷](../../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-provide-help-in-a-windows-application.md b/docs/framework/winforms/advanced/how-to-provide-help-in-a-windows-application.md
new file mode 100644
index 00000000000..07aa6743235
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-provide-help-in-a-windows-application.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : Windows アプリケーションにヘルプを提供する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 提供 (ヘルプを)"
+  - "ヘルプ, Windows アプリケーション"
+  - "HelpProvider コンポーネント [Windows フォーム]"
+  - "HTML ヘルプ, Windows フォーム"
+  - "Windows アプリケーション, 提供 (ヘルプを)"
+ms.assetid: 7c4e5cec-2bd2-4f0b-8d75-c2b88929bd61
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows アプリケーションにヘルプを提供する
+<xref:System.Windows.Forms.HelpProvider> コンポーネントを使用すると、ヘルプ ファイル内のヘルプ トピックを Windows フォームの特定のコントロールに追加できます。  ヘルプ ファイルの形式には、HTML または HTMLHelp 1.x 以上を指定できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ヘルプを提供するには  
+  
+1.  **ツールボックス**から、フォームに <xref:System.Windows.Forms.HelpProvider> コンポーネントをドラッグします。  
+  
+     コンポーネントは、Windows フォーム デザイナーの下部にあるトレイに配置されます。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> プロパティを .chm、.col、または .htm ヘルプ ファイルに設定します。  
+  
+3.  フォーム上の他のコントロールを選択し、**\[プロパティ\]** ウィンドウで [HelpKeyword](frlrfSystemWindowsFormsHelpProviderClassSetHelpKeywordTopic) プロパティを設定します。  
+  
+     これは、適切なヘルプ トピックを呼び出すために <xref:System.Windows.Forms.HelpProvider> コンポーネントによってヘルプ ファイルに渡される文字列です。  
+  
+4.  **\[プロパティ\]** ウィンドウで、[HelpNavigator](frlrfSystemWindowsFormsHelpProviderClassSetHelpNavigatorTopic) プロパティを <xref:System.Windows.Forms.HelpNavigator> 列挙定数の値に設定します。  
+  
+     これにより、**HelpKeyword** プロパティがヘルプ システムに渡される方法が決まります。  設定できるオプションとその説明を次の表に示します。  
+  
+    |メンバー名|Description|  
+    |-----------|-----------------|  
+    |AssociateIndex|指定したトピックのインデックスを指定した URL で実行するように指定します。|  
+    |\[検索\]|指定した URL の検索ページを表示するように指定します。|  
+    |Index|指定した URL のインデックスを表示するように指定します。|  
+    |KeywordIndex|検索するキーワードと、指定した URL で実行するアクションを指定します。|  
+    |TableOfContents|HTML 1.0 ヘルプ ファイルの目次を表示するように指定します。|  
+    |トピック|指定した URL によって参照されるトピックを表示するように指定します。|  
+  
+ 実行時に、**HelpKeyword** プロパティおよび **HelpNavigator** プロパティを設定したコントロールにフォーカスがある状態で F1 キーを押すと、<xref:System.Windows.Forms.HelpProvider> コンポーネントに関連付けられたヘルプ ファイルが開きます。  
+  
+ 現在、**HelpNamespace** プロパティは HTMLHelp 1.x、HTMLHelp 2.0、および HTML の 3 つの形式のヘルプ ファイルをサポートしています。  したがって、**HelpNamespace** プロパティには http:\/\/ アドレス \(Web ページなど\) を設定できます。  プロパティに http:\/\/ アドレスを設定すると、既定のブラウザーが開き、**HelpKeyword** プロパティに指定した文字列をアンカーとして使用して Web ページが表示されます。  アンカーは HTML ページの特定の部分にジャンプするために使用されます。  
+  
+> [!IMPORTANT]
+>  クライアントから送信された情報は、アプリケーションで使用する前に必ずチェックしてください。  悪意のあるユーザーが、実行可能スクリプトや SQL ステートメントなどのコードの送信 \(挿入\) を試みる場合があります。  ユーザーからの入力を表示したり、データベースに格納したり、操作したりする前に、安全でない可能性のある情報が含まれていないかどうかを確認してください。  一般的な確認方法としては、ユーザーから入力を受け取ったときに、正規表現を使用して、"SCRIPT" などのキーワードを検索します。  
+  
+ Windows フォーム上のコントロールに対してヘルプ ファイルを表示するように <xref:System.Windows.Forms.HelpProvider> コンポーネントを設定した場合でも、このコンポーネントを使用してポップアップ ヘルプを表示できます。  詳細については、「[方法 : ポップアップ ヘルプを表示する](../../../../docs/framework/winforms/advanced/how-to-display-pop-up-help.md)」を参照してください。  
+  
+## 参照  
+ [方法 : ポップアップ ヘルプを表示する](../../../../docs/framework/winforms/advanced/how-to-display-pop-up-help.md)   
+ [ツールヒントを使用したコントロールのヘルプ](../../../../docs/framework/winforms/advanced/control-help-using-tooltips.md)   
+ [Windows フォームでのヘルプの統合](../../../../docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-read-image-metadata.md b/docs/framework/winforms/advanced/how-to-read-image-metadata.md
new file mode 100644
index 00000000000..00e74dd0ed7
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-read-image-metadata.md
@@ -0,0 +1,134 @@
+---
+title: "方法 : イメージ メタデータを読み取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メタデータ, プロパティ項目"
+  - "メタデータ, 読み取り (イメージの)"
+ms.assetid: 72ec0b31-0be7-444a-9575-1dbcb864e0be
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : イメージ メタデータを読み取る
+一部のイメージ ファイルにはメタデータが含まれており、このデータを読み取って、そのイメージの特徴を確認できます。  デジタル写真にはこのようなメタデータが含まれていることがあり、そのメタデータを読み取って、たとえばイメージを取り込むために使用したカメラのメーカーやモデルを確認できます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、既存のメタデータを読み取ることができるほか、新しいメタデータをイメージ ファイルに書き込むこともできます。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、個々のメタデータを <xref:System.Drawing.Imaging.PropertyItem> オブジェクトに格納します。  <xref:System.Drawing.Image> オブジェクトの <xref:System.Drawing.Image.PropertyItems%2A> プロパティを読み取ることによって、ファイルからすべてのメタデータを取得できます。  <xref:System.Drawing.Image.PropertyItems%2A> プロパティは、<xref:System.Drawing.Imaging.PropertyItem> オブジェクトの配列を返します。  
+  
+ <xref:System.Drawing.Imaging.PropertyItem> オブジェクトには、`Id`、`Value`、`Len`、および `Type` という 4 つのプロパティがあります。  
+  
+## Id  
+ メタデータ項目を識別するタグ。  <xref:System.Drawing.Imaging.PropertyItem.Id%2A> に割り当てることのできる値の一部を次の表に示します。  
+  
+|16 進値|Description|  
+|-----------|-----------------|  
+|0x0320<br /><br /> 0x010F<br /><br /> 0x0110<br /><br /> 0x9003<br /><br /> 0x829A<br /><br /> 0x5090<br /><br /> 0x5091|イメージのタイトル<br /><br /> 機器のメーカー<br /><br /> 機器のモデル<br /><br /> ExifDTOriginal<br /><br /> Exif 露光時間<br /><br /> 輝度テーブル<br /><br /> クロミナンス テーブル|  
+  
+## 値  
+ 値の配列。  値の形式は、<xref:System.Drawing.Imaging.PropertyItem.Type%2A> プロパティによって決定されます。  
+  
+## Len  
+ <xref:System.Drawing.Imaging.PropertyItem.Value%2A> プロパティが指す値配列の長さ \(バイト単位\)。  
+  
+## 種類  
+ `Value` プロパティが指す配列内の値のデータ型。  `Type` プロパティの値で示される形式を次の表に示します。  
+  
+|数値|Description|  
+|--------|-----------------|  
+|1|`Byte`|  
+|2|ASCII 形式でエンコードされた `Byte` オブジェクトの配列|  
+|3|16 ビット整数|  
+|4|32 ビット整数|  
+|5|有理数を表す 2 つの `Byte` オブジェクトの配列|  
+|6|未使用|  
+|7|未定義|  
+|8|未使用|  
+|9|`SLong`|  
+|10|`SRational`|  
+  
+## 例  
+  
+### Description  
+ ファイル `FakePhoto.jpg` からメタデータの 7 つの部分を読み取って表示するコード例を次に示します。  リスト内の 2 番目の \(インデックス 1\) プロパティ項目には、<xref:System.Drawing.Imaging.PropertyItem.Id%2A> 0x010F \(機器のメーカー\) と <xref:System.Drawing.Imaging.PropertyItem.Type%2A> 2 \(ASCII 形式でエンコードされたバイト配列\) が指定されています。  このコード例は、このプロパティ項目の値を表示します。  
+  
+ このコードは、次のような出力を生成します。  
+  
+ `Property Item 0`  
+  
+ `id: 0x320`  
+  
+ `type: 2`  
+  
+ `length: 16 bytes`  
+  
+ `Property Item 1`  
+  
+ `id: 0x10f`  
+  
+ `type: 2`  
+  
+ `length: 17 bytes`  
+  
+ `Property Item 2`  
+  
+ `id: 0x110`  
+  
+ `type: 2`  
+  
+ `length: 7 bytes`  
+  
+ `Property Item 3`  
+  
+ `id: 0x9003`  
+  
+ `type: 2`  
+  
+ `length: 20 bytes`  
+  
+ `Property Item 4`  
+  
+ `id: 0x829a`  
+  
+ `type: 5`  
+  
+ `length: 8 bytes`  
+  
+ `Property Item 5`  
+  
+ `id: 0x5090`  
+  
+ `type: 3`  
+  
+ `length: 128 bytes`  
+  
+ `Property Item 6`  
+  
+ `id: 0x5091`  
+  
+ `type: 3`  
+  
+ `length: 128 bytes`  
+  
+ `The equipment make is Northwind Camera.`  
+  
+### コード  
+ [!code-csharp[System.Drawing.WorkingWithImages#51](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#51)]
+ [!code-vb[System.Drawing.WorkingWithImages#51](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#51)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  フォームの <xref:System.Windows.Forms.Control.Paint> イベントを処理し、このコードを Paint のイベント ハンドラーに貼り付けます。  `FakePhoto.jpg` をイメージ名とシステム上の有効なパスに置き換え、`System.Drawing.Imaging` 名前空間をインポートする必要があります。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md b/docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md
new file mode 100644
index 00000000000..be18f1d9357
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 実行時に設定を C# で読み取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], C#"
+  - "アプリケーション設定 [Windows フォーム], 読み取り"
+  - "アプリケーション設定 [Windows フォーム], 実行時に"
+ms.assetid: dbe8bf09-5e1c-49da-9192-154033d7240b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 実行時に設定を C# で読み取る
+アプリケーション スコープの設定とユーザー スコープの設定は、どちらも実行時に Properties オブジェクトを使用して読み取ることができます。  Properties オブジェクトは、プロジェクトのすべての既定の設定を、Properties.Settings.Default メンバーを介して公開します。  
+  
+### 実行時に設定を C\# で読み取るには  
+  
+-   Properties.Settings.Default メンバーを介して適切な設定にアクセスします。  BackColor プロパティに `myColor` という名前の設定を割り当てる方法を次の例に示します。  この例を実行する前に、`myColor` という名前の `System.Drawing.Color` 型の設定を含む設定ファイルを作成しておく必要があります。  設定ファイルを作成する方法の詳細については、「[方法 : 設計時に新しい設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md)」を参照してください。  
+  
+    ```  
+    // C#  
+    this.BackColor = Properties.Settings.Default.myColor;  
+    ```  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [方法 : 実行時にユーザー設定を C\# で書き込む](../../../../docs/framework/winforms/advanced/how-to-write-user-settings-at-run-time-with-csharp.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md b/docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md
new file mode 100644
index 00000000000..1ad87b6426e
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DoubleBuffered プロパティ"
+  - "ちらつき, 低減 (Windows フォーム内の)"
+  - "グラフィックス, 軽減 (ダブル バッファリングによってちらつきを)"
+ms.assetid: 91083d3a-653f-4f15-a467-0f37b2aa39d6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する
+ダブル バッファリングでは、メモリ バッファーを使用して、複数の描画操作に関連するちらつきの問題に対処します。  ダブル バッファリングを有効にすると、すべての描画操作が画面上の描画サーフェイスではなく、最初にメモリ バッファーに描画されます。  描画操作がすべて完了すると、メモリ バッファーが、関連付けられている描画サーフェイスに直接コピーされます。  画面上で実行されるグラフィックス操作は 1 つだけなので、複雑な描画操作に関連するイメージのちらつきが解消されます。ほとんどのアプリケーションでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] が提供する既定のダブル バッファリングにより最善の結果が得られます。  標準の Windows フォーム コントロールは既定でダブル バッファリングをサポートしています。  フォームおよび作成済みコントロール内では既定のダブル バッファリングを 2 とおりの方法で有効にできます。  <xref:System.Windows.Forms.Control.DoubleBuffered%2A> プロパティを `true` に設定するか、<xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを呼び出して <xref:System.Windows.Forms.ControlStyles> フラグを `true` に設定します。  どちらの方法でも、フォームまたはコントロールに対して既定のダブル バッファリングが有効になり、ちらつきのないグラフィックが描画されます。  <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドの呼び出しは、ユーザーがすべてのレンダリング処理コードを記述したカスタム コントロールに対してのみ実行するようにお勧めします。  
+  
+ アニメーションや高度なメモリ管理など、より高度なダブル バッファリングのシナリオでは、独自のダブル バッファリング ロジックを実装できます。  詳細については、「[方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)」を参照してください。  
+  
+### ちらつきを軽減するには  
+  
+-   <xref:System.Windows.Forms.Control.DoubleBuffered%2A> プロパティを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#31)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#31)]  
+  
+ または  
+  
+-   <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを呼び出して、<xref:System.Windows.Forms.ControlStyles> フラグを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.LegacyBufferedGraphics#32](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/CS/Class1.cs#32)]
+     [!code-vb[System.Windows.Forms.LegacyBufferedGraphics#32](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.LegacyBufferedGraphics/VB/Class1.vb#32)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.DoubleBuffered%2A>   
+ <xref:System.Windows.Forms.Control.SetStyle%2A>   
+ [ダブル バッファリングされたグラフィックス](../../../../docs/framework/winforms/advanced/double-buffered-graphics.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-render-images-with-gdi.md b/docs/framework/winforms/advanced/how-to-render-images-with-gdi.md
new file mode 100644
index 00000000000..63576a3d6a0
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-render-images-with-gdi.md
@@ -0,0 +1,102 @@
+---
+title: "方法 : GDI+ を使用してイメージをレンダリングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, 描画 (既存のイメージを)"
+  - "イメージ [Windows フォーム], 作成"
+ms.assetid: c128b79a-3e31-47d8-9e66-3470f570a056
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : GDI+ を使用してイメージをレンダリングする
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用すると、アプリケーションにファイルとして存在するイメージをレンダリングできます。  イメージをレンダリングするには、<xref:System.Drawing.Image> クラスの新しいオブジェクト \(たとえば <xref:System.Drawing.Bitmap>\) を作成します。次に、使用する描画サーフェイスを参照する <xref:System.Drawing.Graphics> オブジェクトを作成し、<xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドを呼び出します。  イメージは、グラフィックス クラスによって指定された描画サーフェイス上に描画されます。  イメージ エディターを使用して、デザイン時にイメージ ファイルを作成および編集し、実行時に [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使ってそれらをレンダリングできます。  詳細については、「[Image Editor for Icons](../Topic/Image%20Editor%20for%20Icons.md)」を参照してください。  
+  
+### GDI\+ を使用してイメージをレンダリングするには  
+  
+1.  表示するイメージを表すオブジェクトを作成します。  このオブジェクトは、<xref:System.Drawing.Bitmap> または <xref:System.Drawing.Imaging.Metafile> などの、<xref:System.Drawing.Image> を継承するクラスのメンバーである必要があります。  次に例を示します。  
+  
+    ```vb  
+    ' Uses the System.Environment.GetFolderPath to get the path to the   
+    ' current user's MyPictures folder.  
+    Dim myBitmap as New Bitmap _  
+       (System.Environment.GetFolderPath _  
+          (System.Environment.SpecialFolder.MyPictures))  
+  
+    ```  
+  
+    ```csharp  
+    // Uses the System.Environment.GetFolderPath to get the path to the   
+    // current user's MyPictures folder.  
+    Bitmap myBitmap = new Bitmap  
+       (System.Environment.GetFolderPath  
+          (System.Environment.SpecialFolder.MyPictures));  
+  
+    ```  
+  
+    ```cpp  
+    // Uses the System.Environment.GetFolderPath to get the path to the   
+    // current user's MyPictures folder.  
+    Bitmap^ myBitmap = gcnew Bitmap  
+       (System::Environment::GetFolderPath  
+          (System::Environment::SpecialFolder::MyPictures));  
+    ```  
+  
+2.  使用する描画サーフェイスを表す <xref:System.Drawing.Graphics> オブジェクトを作成します。  詳細については、「[方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)」を参照してください。  
+  
+    ```vb  
+    ' Creates a Graphics object that represents the drawing surface of   
+    ' Button1.  
+    Dim g as Graphics = Button1.CreateGraphics  
+  
+    ```  
+  
+    ```csharp  
+    // Creates a Graphics object that represents the drawing surface of   
+    // Button1.  
+    Graphics g = Button1.CreateGraphics();  
+  
+    ```  
+  
+    ```cpp  
+    // Creates a Graphics object that represents the drawing surface of   
+    // Button1.  
+    Graphics^ g = button1->CreateGraphics();  
+    ```  
+  
+3.  イメージをレンダリングするグラフィックス オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> を呼び出します。  描画対象のイメージだけでなく、描画対象となる場所の座標も指定する必要があります。  
+  
+    ```vb  
+    g.DrawImage(myBitmap, 1, 1)  
+  
+    ```  
+  
+    ```csharp  
+    g.DrawImage(myBitmap, 1, 1);  
+  
+    ```  
+  
+    ```cpp  
+    g->DrawImage(myBitmap, 1, 1);  
+    ```  
+  
+## 参照  
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [GDI\+ でのペン、直線、および四角形](../../../../docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md)   
+ [方法 : Windows フォームにテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-on-a-windows-form.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [Drawing Lines or Closed Figures](../Topic/Drawing%20Lines%20or%20Closed%20Figures%20\(Image%20Editor%20for%20Icons\).md)   
+ [Image Editor for Icons](../Topic/Image%20Editor%20for%20Icons.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md b/docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md
new file mode 100644
index 00000000000..e76d19ca271
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : クリップボードからデータを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "クリップボードのトピック, 取得 (データを)"
+  - "貼り付け (クリップボード データを)"
+ms.assetid: 99612537-2c8a-449f-aab5-2b3b28d656e7
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : クリップボードからデータを取得する
+<xref:System.Windows.Forms.Clipboard> クラスには、Windows オペレーティング システムのクリップボード機能とやり取りするためのメソッドが用意されています。  クリップボードは、データの一時的なレポジトリとして多くのアプリケーションで使用されます。  たとえば、ワード プロセッサは、切り取り、貼り付けの操作でクリップボードを使用します。  クリップボードはデータをアプリケーション間で移動させるときにも使用します。  
+  
+ アプリケーションによっては、データが複数の形式でクリップボードに格納される場合もあります。そうすることで、より多くのアプリケーションがデータを使用できるからです。  クリップボードの形式は、その形式を識別する文字列です。  識別された形式を使用するアプリケーションでは、クリップボード上の関連データを取得できます。  <xref:System.Windows.Forms.DataFormats> クラスにはユーザーが使用できる定義済みの形式名が含まれています。  また、独自の形式名を使用したり、オブジェクトの型を形式名として使用したりできます。  データをクリップボードに追加する方法については、「[方法 : クリップボードにデータを追加する](../../../../docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md)」を参照してください。  
+  
+ 特定の形式のデータがクリップボードに含まれているかどうかを調べるには、いずれかの `Contains`*Format* メソッドを使用するか、または <xref:System.Windows.Forms.Clipboard.GetData%2A> メソッドを使用します。  クリップボードからデータを取得するには、いずれかの `Get`*Format* メソッドを使用するか、<xref:System.Windows.Forms.Clipboard.GetData%2A> メソッドを使用します。  これらは、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] で新しく追加されたメソッドです。  
+  
+ [!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] よりも前のバージョンを使用してクリップボードのデータにアクセスする場合は、<xref:System.Windows.Forms.Clipboard.GetDataObject%2A> メソッドを使用し、返された <xref:System.Windows.Forms.IDataObject> のメソッドを呼び出します。  返されたオブジェクト内で特定の形式が利用可能かどうかを調べるには、たとえば <xref:System.Windows.Forms.IDataObject.GetDataPresent%2A> メソッドを呼び出します。  
+  
+> [!NOTE]
+>  Windows ベースのアプリケーションはすべて、システムのクリップボードを共有します。  そのため、別のアプリケーションに切り替えるとクリップボードの内容は変わります。  
+>   
+>  <xref:System.Windows.Forms.Clipboard> クラスは、シングル スレッド アパートメント \(STA: Single\-Threaded Apartment\) モードに設定されたスレッドでのみ使用できます。  このクラスを使用する前に、`Main` メソッドが <xref:System.STAThreadAttribute> 属性でマーク付けされていることを確認してください。  
+  
+### クリップボードからデータを単一の一般的な形式で取得するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.GetAudioStream%2A>、<xref:System.Windows.Forms.Clipboard.GetFileDropList%2A>、<xref:System.Windows.Forms.Clipboard.GetImage%2A>、または <xref:System.Windows.Forms.Clipboard.GetText%2A> メソッドを使用します。  必要に応じて、最初に対応する `Contains`*Format* のメソッドを使用して、データが特定の形式で利用可能かどうかを判断することもできます。  これらのメソッドは [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] 以外では使用できません。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#2)]
+     [!code-vb[System.Windows.Forms.Clipboard#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#2)]  
+  
+### クリップボードからデータをカスタム形式で取得するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.GetData%2A> メソッドとカスタム形式名を使用します。  このメソッドは [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] 以外では使用できません。  
+  
+     また、定義済みの形式名を指定して <xref:System.Windows.Forms.Clipboard.SetData%2A> メソッドを使用することもできます。  詳細については、「<xref:System.Windows.Forms.DataFormats>」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#3)]
+     [!code-vb[System.Windows.Forms.Clipboard#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#3)]  
+    [!code-csharp[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#100)]
+    [!code-vb[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#100)]  
+  
+### クリップボードからデータを複数の形式で取得するには  
+  
+1.  <xref:System.Windows.Forms.Clipboard.GetDataObject%2A> メソッドを使用してください。  [!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] よりも前のバージョンでクリップボードからデータを取得する場合は、このメソッドを使う必要があります。  
+  
+     [!code-csharp[System.Windows.Forms.Clipboard#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#4)]
+     [!code-vb[System.Windows.Forms.Clipboard#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#4)]  
+    [!code-csharp[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/CS/form1.cs#100)]
+    [!code-vb[System.Windows.Forms.Clipboard#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Clipboard/vb/form1.vb#100)]  
+  
+## 参照  
+ [ドラッグ アンド ドロップ操作とクリップボードのサポート](../../../../docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md)   
+ [方法 : クリップボードにデータを追加する](../../../../docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-rotate-colors.md b/docs/framework/winforms/advanced/how-to-rotate-colors.md
new file mode 100644
index 00000000000..bb5030d02d1
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-rotate-colors.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 色を回転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 回転"
+  - "例 [Windows フォーム], 回転 (色を)"
+ms.assetid: e2e4c300-159c-4f4a-9b56-103b0f7cbc05
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 色を回転させる
+4 次元カラー空間における回転は、視覚的に認識するのが困難です。  いずれかの色要素を固定したと想定することによって、回転を視覚的に認識しやすくすることができます。  たとえば、アルファ要素を完全な不透明を示す 1 に固定したとします。  これにより、次の図に示すように、赤、緑、および青の軸を持つ 3 次元のカラー空間を視覚化できます。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring03.gif "recoloring03")  
+  
+ 1 つの色は、3 次元空間内の 1 つの点として考えることができます。  たとえば、空間内の点 \(1, 0, 0\) は赤の色を表し、空間内の点 \(0, 1, 0\) は緑の色を表します。  
+  
+ 次の図は、赤軸と緑軸が構成する平面上で色 \(1, 0, 0\) を 60°回転させるとは、どういうことかを示しています。  赤軸と緑軸が構成する平面と平行な平面における回転は、青軸を中心とした回転と考えることができます。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring04.gif "recoloring04")  
+  
+ 3 つの座標軸 \(赤、緑、青\) それぞれを中心として回転を実行するようにカラー行列を初期化する方法を次の図に示します。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring05.gif "recoloring05")  
+  
+## 使用例  
+ 次の図は、全体が 1 つの色 \(1, 0, 0.6\) であるイメージに、青軸を中心として 60°の回転を適用する例を示しています。  回転の角度は、赤軸と緑軸が構成する平面と平行な平面上で内で測定されます。  
+  
+ 次の図は、左側に元のイメージ、右側に色の回転後のイメージを示しています。  
+  
+ ![色の回転](../../../../docs/framework/winforms/advanced/media/colortrans5.png "colortrans5")  
+  
+ 次のコードで実行される色の回転を視覚化した図を次に示します。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring06.gif "recoloring06")  
+  
+ [!code-csharp[System.Drawing.RotateColors#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RotateColors/CS/Form1.cs#1)]
+ [!code-vb[System.Drawing.RotateColors#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RotateColors/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  `RotationInput.bmp` は、システム上で有効なイメージ ファイルの名前とパスに置き換えてください。  
+  
+## 参照  
+ <xref:System.Drawing.Imaging.ColorMatrix>   
+ <xref:System.Drawing.Imaging.ImageAttributes>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md b/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md
new file mode 100644
index 00000000000..cc53a4d5940
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : イメージを回転、反転、および傾斜させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], 反転"
+  - "イメージ [Windows フォーム], 回転"
+  - "イメージ [Windows フォーム], 傾斜"
+ms.assetid: a3bf97eb-63ed-425a-ba07-dcc65efb567c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : イメージを回転、反転、および傾斜させる
+元のイメージの左上隅、右上隅、および左下隅に対して、それぞれ変換後の点を指定して、イメージを回転、反転、および傾斜させることができます。  この 3 つの変換後の点によって、元の四角形イメージを平行四辺形に変換するアフィン変換が決定されます。  
+  
+## 使用例  
+ たとえば、元のイメージが、左上隅が \(0, 0\)、右上隅が \(100, 0\)、左下隅が \(0, 50\) にある四角形だとします。  これらの 3 つの点を、次に示す変換後の点に割り当てるとします。  
+  
+|変換前の点|変換後の点|  
+|-----------|-----------|  
+|左上隅 \(0, 0\)|\(200, 20\)|  
+|右上隅 \(100, 0\)|\(110, 100\)|  
+|左下隅 \(0, 50\)|\(250, 30\)|  
+  
+ 元のイメージと、変換後の平行四辺形を次の図に示します。  元のイメージは傾斜され、反転され、回転され、そして平行移動されています。  元のイメージの上辺は、変換前は x 軸に沿っていましたが、変換後は点 \(200, 20\) と点 \(110, 100\) を結ぶ直線になっています。  元のイメージの左辺は、変換前は y 軸に沿っていましたが、変換後は点 \(200, 20\) と点 \(250, 30\) を結ぶ直線になっています。  
+  
+ ![ストライプ](../../../../docs/framework/winforms/advanced/media/stripes1.gif "Stripes1")  
+  
+ 同じ変換を写真に適用した場合を次の図に示します。  
+  
+ ![変換クライマ](../../../../docs/framework/winforms/advanced/media/transformedclimber.png "TransformedClimber")  
+  
+ 同じ変換をメタファイルに適用した場合を次の図に示します。  
+  
+ ![変換メタファイル](../../../../docs/framework/winforms/advanced/media/transformedmetafile.png "TransformedMetafile")  
+  
+ 最初の図で示したイメージを作成する例を次に示します。  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#61)]
+ [!code-vb[System.Drawing.WorkingWithImages#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#61)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  `Stripes.bmp` は、必ずシステム上で有効なイメージへのパスに置き換えてください。  
+  
+## 参照  
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md b/docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md
new file mode 100644
index 00000000000..0af29ff514c
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md
@@ -0,0 +1,107 @@
+---
+title: "方法 : アクティブな MDI 子フォームにデータを送信する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子フォーム"
+  - "クリップボードのトピック, 取得 (データを)"
+  - "クリップボードのトピック, 貼り付け"
+  - "MDI, 送信 (フォームにデータを)"
+ms.assetid: 1047d2fe-1235-46db-aad9-563aea1d743b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : アクティブな MDI 子フォームにデータを送信する
+ユーザーがデータをクリップボードから MDI アプリケーションに貼り付ける場合など、[マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)のコンテキストの中で、アクティブな子ウィンドウにデータを送信することは少なくありません。  
+  
+> [!NOTE]
+>  フォーカスがある子ウィンドウを調べてその内容をクリップボードに送信する方法については、「[方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)」を参照してください。  
+  
+### クリップボードからアクティブな MDI 子ウィンドウへデータを送信するには  
+  
+1.  アクティブな子フォームにあるアクティブなコントロールにクリップボードからテキストをコピーするコードをメソッドに記述します。  
+  
+    > [!NOTE]
+    >  この例では、MDI 親フォーム \(`Form1`\) は <xref:System.Windows.Forms.RichTextBox> コントロールのある MDI 子ウィンドウを少なくとも 1 つ持っていることを前提としています。  詳細については、「[方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)」を参照してください。  
+  
+    ```vb  
+    Public Sub mniPaste_Click(ByVal sender As Object, _  
+       ByVal e As System.EventArgs) Handles mniPaste.Click  
+  
+       ' Determine the active child form.  
+       Dim activeChild As Form = Me.ParentForm.ActiveMDIChild  
+  
+       ' If there is an active child form, find the active control, which  
+       ' in this example should be a RichTextBox.  
+       If (Not activeChild Is Nothing) Then  
+          Try  
+             Dim theBox As RichTextBox = Ctype(activeChild.ActiveControl, RichTextBox)  
+             If (Not theBox Is Nothing) Then  
+                ' Create a new instance of the DataObject interface.  
+                Dim data As IDataObject = Clipboard.GetDataObject()  
+                ' If the data is text, then set the text of the   
+                ' RichTextBox to the text in the clipboard.  
+                If (data.GetDataPresent(DataFormats.Text)) Then  
+                   theBox.SelectedText = data.GetData(DataFormats.Text).ToString()  
+                End If  
+             End If  
+          Catch  
+             MessageBox.Show("You need to select a RichTextBox.")  
+          End Try  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void mniPaste_Click (object sender, System.EventArgs e)  
+    {  
+      // Determine the active child form.  
+       Form activeChild = this.ParentForm.ActiveMdiChild;  
+  
+       // If there is an active child form, find the active control, which  
+       // in this example should be a RichTextBox.  
+       if (activeChild != null)  
+       {  
+          try   
+          {  
+             RichTextBox theBox = (RichTextBox)activeChild.ActiveControl;  
+             if (theBox != null)  
+             {  
+                // Create a new instance of the DataObject interface.  
+                IDataObject data = Clipboard.GetDataObject();  
+                // If the data is text, then set the text of the   
+                // RichTextBox to the text in the clipboard.  
+                if (data.GetDataPresent(DataFormats.Text))  
+                {  
+                   theBox.SelectedText = data.GetData(DataFormats.Text).ToString();                 
+                }  
+             }  
+          }  
+          catch   
+          {  
+             MessageBox.Show("You need to select a RichTextBox.");  
+          }  
+       }  
+    }  
+  
+    ```  
+  
+## 参照  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)   
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)   
+ [方法 : MDI 子フォームを配置する](../../../../docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-set-jpeg-compression-level.md b/docs/framework/winforms/advanced/how-to-set-jpeg-compression-level.md
new file mode 100644
index 00000000000..a4e86b49995
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-set-jpeg-compression-level.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : JPEG 圧縮レベルの設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], 変更 (エンコーダー パラメーターを)"
+  - "JPEG イメージ, 設定 (品質レベルを)"
+ms.assetid: 4b9a74e3-9504-43c1-9f28-ace651d0772e
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : JPEG 圧縮レベルの設定
+イメージをディスクに保存するときに、ファイル サイズを最小化したり品質を向上させるためにイメージのパラメーターを修正することがあります。  JPEG イメージの品質を調整するには、圧縮レベルを修正します。  JPEG イメージを保存するときに圧縮レベルを指定するには、<xref:System.Drawing.Imaging.EncoderParameters> オブジェクトを作成してそれを <xref:System.Drawing.Image> クラスの <xref:System.Drawing.Image.Save%2A> メソッドに渡す必要があります。  <xref:System.Drawing.Imaging.EncoderParameters> オブジェクトを初期化して、1 つの <xref:System.Drawing.Imaging.EncoderParameter>. によって構成される配列を持つようにします。  <xref:System.Drawing.Imaging.EncoderParameter> を作成するときに <xref:System.Drawing.Imaging.Encoder.Quality> エンコーダーを指定して、必要な圧縮レベルを指定します。  
+  
+## 使用例  
+ <xref:System.Drawing.Imaging.EncoderParameter> オブジェクトを作成して 3 つの JPEG イメージを保存する方法を次のコード例に示します。  各 JPEG イメージを異なる圧縮レベルで保存するために、<xref:System.Drawing.Imaging.EncoderParameter> コンストラクターに渡す `long` の値を修正します。  品質レベル 0 は最も圧縮率が高く、品質レベル 100 は最も低い圧縮率に対応します。  
+  
+ [!code-csharp[UsingImageEncodersDecoders#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#8)]
+ [!code-vb[UsingImageEncodersDecoders#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#8)]  
+[!code-csharp[UsingImageEncodersDecoders#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/UsingImageEncodersDecoders/CS/Form1.cs#6)]
+[!code-vb[UsingImageEncodersDecoders#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/UsingImageEncodersDecoders/VB/Form1.vb#6)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Windows フォーム アプリケーション。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs>。これは、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターです。  
+  
+-   `TestPhoto.jpg` という名前のイメージ ファイル。保存場所は **c:\\** です。  
+  
+## 参照  
+ [方法 : エンコーダーがサポートするパラメーターの確認](../../../../docs/framework/winforms/advanced/how-to-determine-the-parameters-supported-by-an-encoder.md)   
+ [ビットマップの種類](../../../../docs/framework/winforms/advanced/types-of-bitmaps.md)   
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md b/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md
new file mode 100644
index 00000000000..a5476929a67
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : ペンの幅と配置を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ペン, 設定 (配置を)"
+  - "ペン, 設定 (幅を)"
+ms.assetid: a202af36-4d31-4401-a126-b232f51db581
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ペンの幅と配置を設定する
+<xref:System.Drawing.Pen> オブジェクトを作成するときに、そのコンストラクターへの引数の 1 つとしてペン幅を渡すことができます。  また、<xref:System.Drawing.Pen> クラスの <xref:System.Drawing.Pen.Width%2A> プロパティを使用して、ペン幅を変更することもできます。  
+  
+ 理論上は、線の幅は 0 です。  幅が 1 ピクセルの線を描画する場合、そのピクセルは理論上の線の中央に配置されます。  幅が 2 ピクセル以上の直線を描画する場合は、ピクセルは理論上の線の中央か、その線の片側に揃えて配置されます。  <xref:System.Drawing.Pen> のペン配置プロパティを設定して、そのペンで描画されるピクセルを理論上の線に対してどのように配置するかを指定できます。  
+  
+ 次のコード例の <xref:System.Drawing.Drawing2D.PenAlignment>、<xref:System.Drawing.Drawing2D.PenAlignment>、および <xref:System.Drawing.Drawing2D.PenAlignment> の各値は、<xref:System.Drawing.Drawing2D.PenAlignment> 列挙体のメンバーです。  
+  
+ 1 本の直線を 2 回描画する例を次に示します。1 回目は幅が 1 の黒いペンで描画し、2 回目は幅が 10 の緑のペンで描画します。  
+  
+### ペンの幅を変更するには  
+  
+-   <xref:System.Drawing.Pen.Alignment%2A> プロパティの値を <xref:System.Drawing.Drawing2D.PenAlignment> \(既定値\) に設定して、緑のペンで描画されるピクセルが理論上の直線の中央に揃えて配置されるように指定します。  結果として得られる直線を次の図に示します。  
+  
+     ![ペン](../../../../docs/framework/winforms/advanced/media/pens1a.png "pens1A")  
+  
+     四角形を 2 回描画する例を次に示します。1 回目は幅が 1 の黒いペンで描画し、2 回目は幅が 10 の緑のペンで描画します。  
+  
+     [!code-csharp[System.Drawing.UsingAPen#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#41)]
+     [!code-vb[System.Drawing.UsingAPen#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#41)]  
+  
+### ペンの配置を変更するには  
+  
+-   <xref:System.Drawing.Pen.Alignment%2A> プロパティの値を <xref:System.Drawing.Drawing2D.PenAlignment> に設定して、緑のペンで描画されるピクセルが四角形の境界の中央に揃えて配置されるように指定します。  
+  
+     結果として得られる四角形を次の図に示します。  
+  
+     ![ペン](../../../../docs/framework/winforms/advanced/media/pens2.png "pens2")  
+  
+     [!code-csharp[System.Drawing.UsingAPen#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#42)]
+     [!code-vb[System.Drawing.UsingAPen#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#42)]  
+  
+### くぼみ表示のペンを作成するには  
+  
+-   上のコードの 3 番目のステートメントを次のように変更して、緑のペンの配置を変更します。  
+  
+     [!code-csharp[System.Drawing.UsingAPen#43](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#43)]
+     [!code-vb[System.Drawing.UsingAPen#43](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#43)]  
+  
+     この場合、緑の太い直線を表すピクセルは、次の図で示すように四角形の内側に表示されます。  
+  
+     ![ペン](../../../../docs/framework/winforms/advanced/media/pens3.png "pens3")  
+  
+## 参照  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-set-tab-stops-in-drawn-text.md b/docs/framework/winforms/advanced/how-to-set-tab-stops-in-drawn-text.md
new file mode 100644
index 00000000000..d44cc8593e2
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-set-tab-stops-in-drawn-text.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : 描画されたテキストにタブ ストップを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ, 描画されたテキスト"
+  - "テキスト, 描画 (タブ ストップを使用して)"
+ms.assetid: 64878f98-39ba-4303-b63f-0859ab682eeb
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 描画されたテキストにタブ ストップを設定する
+テキストにタブ ストップを設定するには、<xref:System.Drawing.StringFormat> オブジェクトの <xref:System.Drawing.StringFormat.SetTabStops%2A> メソッドを呼び出し、その <xref:System.Drawing.StringFormat> オブジェクトを <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.DrawString%2A> メソッドに渡します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.TextRenderer?displayProperty=fullName> では描画されたテキストへのタブ ストップの追加はサポートされていませんが、<xref:System.Windows.Forms.TextFormatFlags?displayProperty=fullName> フラグを使用して既存のタブ ストップを拡張できます。  
+  
+## 使用例  
+ 150、250、350 の各位置にタブ ストップを設定する例を次に示します。  このコードは、名前とテストの得点とをタブで区切ったリストを表示します。  
+  
+ 表示されるタブ区切りのテキストを次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/fontstext4.png "fontstext4")  
+  
+ 次のコードでは、<xref:System.Drawing.StringFormat.SetTabStops%2A> メソッドに 2 つの引数を渡します。  2 番目の引数は、タブのオフセットを格納している配列です。  <xref:System.Drawing.StringFormat.SetTabStops%2A> に渡される最初の引数は 0 で、この値は、配列内の最初のオフセットが 0 の位置、つまり外接する四角形の左端から測定されることを示します。  
+  
+ [!code-csharp[System.Drawing.FontsAndText#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.FontsAndText#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#41)]  
+  
+## コードのコンパイル  
+  
+-   前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-set-the-color-of-a-pen.md b/docs/framework/winforms/advanced/how-to-set-the-color-of-a-pen.md
new file mode 100644
index 00000000000..0fc85b2cb2a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-set-the-color-of-a-pen.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : ペンの色を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色付きのペン"
+  - "ペン, 設定 (色を)"
+ms.assetid: a9df06f9-a6d5-4d9b-a2d1-583943540775
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ペンの色を設定する
+この例は、既存の <xref:System.Drawing.Pen> オブジェクトの色を変更します。  
+  
+## 使用例  
+ [!code-cpp[System.Drawing.ConceptualHowTos#9](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/cpp/form1.cpp#9)]
+ [!code-csharp[System.Drawing.ConceptualHowTos#9](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/CS/form1.cs#9)]
+ [!code-vb[System.Drawing.ConceptualHowTos#9](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ConceptualHowTos/VB/form1.vb#9)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `myPen` という名前の <xref:System.Drawing.Pen> オブジェクト  
+  
+## 信頼性の高いプログラミング  
+ システム リソースを消費するオブジェクト \(<xref:System.Drawing.Pen> オブジェクトなど\) を使用した後は、必ず <xref:System.Drawing.Pen.Dispose%2A> を呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Drawing.Pen>   
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)   
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [GDI\+ でのペン、直線、および四角形](../../../../docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-shear-colors.md b/docs/framework/winforms/advanced/how-to-shear-colors.md
new file mode 100644
index 00000000000..3d5220e7e4b
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-shear-colors.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : 色を傾斜する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 傾斜"
+  - "色, 変換 (カラー行列を使用して)"
+ms.assetid: 0a424171-5b8b-45c4-afef-e9720a6c3e22
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 色を傾斜する
+傾斜は、1 つの色要素を別の色要素との比率分だけ増加または減少させます。  たとえば、赤の要素を青の要素の値の半分だけ増加する変換を考えます。  このような変換では、色 \(0.2, 0.5, 1\) は \(0.7, 0.5, 1\) になります。  新しい赤の要素は、0.2 \+ \(1\/2\)\(1\) \= 0.7 となります。  
+  
+## 使用例  
+ ファイル ColorBars4.bmp から <xref:System.Drawing.Image> オブジェクトを作成する例を次に示します。  このコードは、次に、イメージ内の各ピクセルに上のパラグラフで説明した傾斜変換を適用します。  
+  
+ 次の図は、左側に元のイメージ、右側に傾斜されたイメージを示しています。  
+  
+ ![色の傾斜](../../../../docs/framework/winforms/advanced/media/colortrans6.png "colortrans6")  
+  
+ 傾斜変換を実行する前後の 4 つのバーのカラー ベクターを次の表に示します。  
+  
+|元|変換後|  
+|-------|---------|  
+|\(0, 0, 1, 1\)|\(0.5, 0, 1, 1\)|  
+|\(0.5, 1, 0.5, 1\)|\(0.75, 1, 0.5, 1\)|  
+|\(1, 1, 0, 1\)|\(1, 1, 0, 1\)|  
+|\(0.4, 0.4, 0.4, 1\)|\(0.6, 0.4, 0.4, 1\)|  
+  
+ [!code-csharp[System.Drawing.Misc3#9](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.Misc3/CS/Form1.cs#9)]
+ [!code-vb[System.Drawing.Misc3#9](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Misc3/VB/Form1.vb#9)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  `ColorBars.bmp` を、システムで有効なイメージ名とパスで置き換えます。  
+  
+## 参照  
+ <xref:System.Drawing.Imaging.ColorMatrix>   
+ <xref:System.Drawing.Imaging.ImageAttributes>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md b/docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md
new file mode 100644
index 00000000000..1a3e0660bf3
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM 相互運用機能, Windows フォーム"
+  - "COM [Windows フォーム]"
+  - "Windows フォーム, アンマネージ"
+  - "ActiveX コントロール [Windows フォーム], COM 相互運用機能"
+  - "Windows フォーム, 相互運用"
+ms.assetid: a9e04765-d2de-4389-a494-a9a6d07aa6ee
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループでフォームを表示して、COM 相互運用性の問題を解決できます。これは、<xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName> メソッドを使用して作成することができます。  
+  
+ Windows フォームが COM クライアント アプリケーションから正しく動作するには、Windows フォームのメッセージ ループ上でフォームを実行する必要があります。 そのためには、次の方法のいずれかを使用します。  
+  
+-   <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用して、Windows フォームを表示します。 詳細については、「[方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md)」を参照してください。  
+  
+-   各 Windows フォームを別のスレッドで表示します。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に、この機能の広範なサポートがあります。  
+  
+ 「[チュートリアル: Windows フォームを別個のスレッドに表示することによって COM 相互運用をサポートする](http://msdn.microsoft.com/library/ms233639\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ 次のコード例は、個別のスレッドでフォームを表示し、<xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName> メソッドを呼び出して、スレッドで Windows フォーム メッセージ ポンプを開始する方法を示しています。 この方法を使用するには、<xref:System.Windows.Forms.Control.Invoke%2A> メソッドを使用して、アンマネージ アプリケーションからのフォームの呼び出しをマーシャリングする必要があります。  
+  
+ この方法は、独自のメッセージ ループを使用して、独自のスレッドで、フォームの各インスタンスが実行する必要があります。 1 つのスレッドに対して複数のメッセージ ループを実行することはできません。 そのため、クライアント アプリケーションのメッセージ ループを変更することはできません。 ただし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] コンポーネントを変更して、独自のメッセージ ループを使用する新しいスレッドを開始することができます。  
+  
+ [!code-vb[System.Windows.Forms.ComInterop#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ComInterop/VB/COMForm.vb#1)]  
+  
+ [!code-vb[System.Windows.Forms.ComInterop#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ComInterop/VB/FormManager.vb#10)]  
+  
+ [!code-vb[System.Windows.Forms.ComInterop#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ComInterop/VB/Form1.vb#100)]  
+  
+## コードのコンパイル  
+  
+-   `COMForm`、`Form1`、および `FormManager` の型を、`COMWinform.dll` と呼ばれるアセンブリにコンパイルします。 「[COM 用のアセンブリのパッケージ化](../../../../docs/framework/interop/packaging-an-assembly-for-com.md)」で説明するメソッドのいずれかを使用して COM にアセンブリを登録します。 これで、アンマネージ アプリケーションのアセンブリと対応する型のライブラリ \(.tlb\) ファイルを使用できます。 たとえば、Visual Basic 6.0 の実行可能なプロジェクトで参照として型ライブラリを使用することができます。  
+  
+## 参照  
+ [COM への .NET Framework コンポーネントの公開](../../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [COM 用のアセンブリのパッケージ化](../../../../docs/framework/interop/packaging-an-assembly-for-com.md)   
+ [COM へのアセンブリの登録](../../../../docs/framework/interop/registering-assemblies-with-com.md)   
+ [方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md)   
+ [Windows フォームおよびアンマネージ アプリケーションの概要](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-tile-a-shape-with-an-image.md b/docs/framework/winforms/advanced/how-to-tile-a-shape-with-an-image.md
new file mode 100644
index 00000000000..25154251062
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-tile-a-shape-with-an-image.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : イメージを並べたパターンによって図形を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 塗りつぶし (図形を)"
+  - "イメージ [Windows フォーム], 塗りつぶし (図形を)"
+  - "形状, 並べて表示 (イメージを)"
+  - "テクスチャ ブラシ, 並べて表示 (イメージを)"
+ms.assetid: 6d407891-6e5c-4495-a546-3da5604e9fb8
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : イメージを並べたパターンによって図形を塗りつぶす
+床の上にタイルを並べて配置するように、四角形のイメージを隣り合わせに配置して、図形を塗りつぶすことができます。  イメージを並べたパターンで図形の内側を塗りつぶすには、テクスチャ ブラシを使用します。  <xref:System.Drawing.TextureBrush> オブジェクトを構築するときは、<xref:System.Drawing.Image> オブジェクトが引数の 1 つとしてコンストラクターに渡されます。  テクスチャ ブラシを使用して図形の内側を塗りつぶす場合、対象の図形は、このイメージのコピーを繰り返したパターンによって塗りつぶされます。  
+  
+ <xref:System.Drawing.TextureBrush> オブジェクトのラップ モード プロパティは、四角形のグリッド内でイメージをどのように繰り返すかを決定します。  グリッド内のすべてのイメージを同じ向きで配置することも、イメージをグリッド位置から次のグリッド位置に移動するにつれて反転させていくこともできます。  反転は、水平方向、垂直方向、その両方向で行うことができます。  各種の方法でイメージを反転させて並べたパターンによって図形を塗りつぶす例を次に示します。  
+  
+### イメージを並べて表示するには  
+  
+-   次の例では、75 × 75 のイメージを並べたパターンを使用して、200 × 200 の四角形を塗りつぶします。  
+  
+ ![並べて表示 1](../../../../docs/framework/winforms/advanced/media/tile1.png "tile1")  
+  
+-   次の図は、イメージを並べたパターンによって、四角形がどのように塗りつぶされるかを示しています。  すべてのイメージの向きは同じで、いずれも反転されていません。  
+  
+ ![並べて表示 2](../../../../docs/framework/winforms/advanced/media/tile2.png "tile2")  
+  
+ [!code-csharp[System.Drawing.UsingABrush#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.UsingABrush#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#31)]  
+  
+### 並べて表示するときにイメージを水平方向に反転させるには  
+  
+-   次の例では、同じ 75 × 75 のイメージを並べたパターンを使用して、200 × 200 の四角形を塗りつぶします。  ただし、ラップ モードが、イメージを水平方向に反転するように設定されています。  次の図は、イメージを並べたパターンによって、四角形がどのように塗りつぶされるかを示しています。  あるイメージから横方向の次の位置にあるイメージに移るときに、イメージが水平方向に反転されます。  
+  
+ ![並べて表示 3](../../../../docs/framework/winforms/advanced/media/tile3.png "tile3")  
+  
+ [!code-csharp[System.Drawing.UsingABrush#32](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#32)]
+ [!code-vb[System.Drawing.UsingABrush#32](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#32)]  
+  
+### 並べて表示するときにイメージを垂直方向に反転させるには  
+  
+-   次の例では、同じ 75 × 75 のイメージを並べたパターンを使用して、200 × 200 の四角形を塗りつぶします。  ただし、ラップ モードが、イメージを垂直方向に反転するように設定されています。  
+  
+     [!code-csharp[System.Drawing.UsingABrush#33](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#33)]
+     [!code-vb[System.Drawing.UsingABrush#33](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#33)]  
+  
+### 並べて表示するときにイメージを水平方向と垂直方向に反転させるには  
+  
+-   次の例では、同じ 75 × 75 のイメージを並べたパターンを使用して、200 × 200 の四角形を塗りつぶします。  ラップ モードは、イメージを水平方向と垂直方向の両方向に反転させるように設定されています。  次の図は、イメージを並べたパターンによって、四角形がどのように塗りつぶされるかを示しています。  あるイメージから横方向の次の位置にあるイメージに移るときに、イメージが水平方向に反転され、あるイメージから縦方向の次の位置にあるイメージに移るときに、イメージが垂直方向に反転されます。  
+  
+ ![並べて表示 5](../../../../docs/framework/winforms/advanced/media/tile5.png "tile5")  
+  
+ [!code-csharp[System.Drawing.UsingABrush#34](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingABrush/CS/Class1.cs#34)]
+ [!code-vb[System.Drawing.UsingABrush#34](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingABrush/VB/Class1.vb#34)]  
+  
+## 参照  
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-translate-image-colors.md b/docs/framework/winforms/advanced/how-to-translate-image-colors.md
new file mode 100644
index 00000000000..00c1dc34402
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-translate-image-colors.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : イメージの色を変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 変更 (色を)"
+  - "イメージの色 [Windows フォーム]"
+  - "イメージ [Windows フォーム], 変更 (色を)"
+ms.assetid: 2106fb9a-4d60-4dcf-9220-9f189a6c4d19
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : イメージの色を変換する
+変換では、4 つの色要素のうちの 1 つ以上の要素に値が追加されます。  変換を表すカラー行列エントリを次の表に示します。  
+  
+|変換対象の要素|行列エントリ|  
+|-------------|------------|  
+|赤|\[4\]\[0\]|  
+|緑|\[4\]\[1\]|  
+|青|\[4\]\[2\]|  
+|アルファ|\[4\]\[3\]|  
+  
+## 使用例  
+ ファイル ColorBars.bmp から <xref:System.Drawing.Image> オブジェクトを作成する例を次に示します。  このコードは、次に、イメージ内の各ピクセルの赤の要素に 0.75 を追加します。  元のイメージと変換後のイメージが並んで描画されます。  
+  
+ 次の図は、左側に元のイメージ、右側に変換後のイメージを示しています。  
+  
+ ![色の変換](../../../../docs/framework/winforms/advanced/media/colortrans2.png "colortrans2")  
+  
+ 赤の変換を実行する前後の 4 つのバーのカラー ベクターを次の表に示します。  色要素の最大値が 1 であるため、2 番目の行にある赤の要素は変化しません。  同様に、色要素の最小値は 0 です。  
+  
+|元|変換後|  
+|-------|---------|  
+|黒 \(0, 0, 0, 1\)|\(0.75, 0, 0, 1\)|  
+|赤 \(1, 0, 0, 1\)|\(1, 0, 0, 1\)|  
+|緑 \(0, 1, 0, 1\)|\(0.75, 1, 0, 1\)|  
+|青 \(0, 0, 1, 1\)|\(0.75, 0, 1, 1\)|  
+  
+ [!code-csharp[System.Drawing.RecoloringImages#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RecoloringImages/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.RecoloringImages#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RecoloringImages/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  `ColorBars.bmp`  は、システム上で有効なイメージ ファイルの名前とパスに置き換えてください。  
+  
+## 参照  
+ <xref:System.Drawing.Imaging.ColorMatrix>   
+ <xref:System.Drawing.Imaging.ImageAttributes>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-set-alpha-values-in-images.md b/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-set-alpha-values-in-images.md
new file mode 100644
index 00000000000..620c68ad5c8
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-set-alpha-values-in-images.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : カラー行列を使用してイメージのアルファ値を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 使用 (半透明にするためにカラー行列を)"
+  - "イメージ [Windows フォーム], 使用 (半透明にするためにカラー行列を)"
+  - "行列, アルファ値"
+  - "透明度, カラー行列"
+ms.assetid: a27121e6-f7e9-4c09-84e2-f05aa9d2a1bb
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : カラー行列を使用してイメージのアルファ値を設定する
+<xref:System.Drawing.Bitmap> クラス \(<xref:System.Drawing.Image> クラスから継承\) および <xref:System.Drawing.Imaging.ImageAttributes> クラスには、ピクセル値を取得したり設定したりするための機能が用意されています。  <xref:System.Drawing.Imaging.ImageAttributes> クラスを使用してイメージ全体のアルファ値を変更したり、<xref:System.Drawing.Bitmap> クラスの <xref:System.Drawing.Bitmap.SetPixel%2A> メソッドを呼び出して個々のピクセル値を変更したりできます。  
+  
+## 使用例  
+ <xref:System.Drawing.Imaging.ImageAttributes> クラスには多数のプロパティがあり、これらのプロパティを使用して、描画中のイメージを修正できます。  <xref:System.Drawing.Imaging.ImageAttributes> オブジェクトを使用して、すべてのアルファ値を元の 80% の値に設定する例を次に示します。  このためには、カラー行列を初期化し、行列内のアルファ スケーリング値を 0.8 に設定します。  カラー行列のアドレスが<xref:System.Drawing.Imaging.ImageAttributes> オブジェクトの <xref:System.Drawing.Imaging.ImageAttributes.SetColorMatrix%2A> メソッドに渡され、<xref:System.Drawing.Imaging.ImageAttributes> オブジェクトが <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawString%2A> メソッドに渡されます。  
+  
+ 描画中に、ビットマップのアルファ値が、元の 80% の値に変換されます。  これにより、描画されるイメージが、背景とブレンドされるようになります。  次の図で示すように、ビットマップ イメージは透明に見えるため、そのイメージを透過して黒の実線を見ることができます。  
+  
+ ![行列を使用したアルファ ブレンド](../../../../docs/framework/winforms/advanced/media/image2.png "image2")  
+  
+ イメージが背景の白い部分の上にあるところでは、そのイメージ部分が白色とブレンドされています。  イメージが黒い線を横切るところでは、そのイメージ部分が黒色とブレンドされます。  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.AlphaBlending#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-transform-a-single-color.md b/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-transform-a-single-color.md
new file mode 100644
index 00000000000..6f13631d6d2
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-transform-a-single-color.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : カラー行列を使用して単一色を変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カラー行列, 使用"
+  - "イメージ カラー, 変換"
+ms.assetid: 44df4556-a433-49c0-ac0f-9a12063a5860
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : カラー行列を使用して単一色を変換する
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、イメージの格納および操作のために、<xref:System.Drawing.Image> クラスおよび <xref:System.Drawing.Bitmap> クラスを提供しています。  <xref:System.Drawing.Image> オブジェクトおよび <xref:System.Drawing.Bitmap> オブジェクトは、各ピクセルの色として、赤、緑、青、およびアルファそれぞれに 8 ビットずつ割り当てた 32 ビットの数値を格納します。  4 つの各要素は、0 から 255 までの数値で表され、0 は輝度がないことを表し、255 は最大の輝度を表します。  アルファ要素は、色の透明度を指定します。0 は完全な透明を表し、255 は完全な不透明を表します。  
+  
+ カラー ベクターは、4 つの要素 \(赤、緑、青、アルファ\) から成る集合です。  たとえば、カラー ベクター \(0, 255, 0, 255\) は、赤と青に輝度がなく、緑の輝度が最大である不透明な色を表します。  
+  
+ 色を表すための別の規則では、数値 1 を使用して最大の輝度を表します。  その規則を使用すると、上の段落で説明した色はベクター \(0, 1, 0, 1\) で表されます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、色の変換を行うときに、最大の輝度を 1 で表す規則を使用します。  
+  
+ カラー ベクターに 4 × 4 の行列を掛け合わせることによって、そのカラー ベクターに線形変換 \(回転、スケーリングなど\) を適用できます。  しかし、線形変換ではない平行移動を行うために、4 × 4 の行列は使用できません。  ダミーとして 5 番目の座標 \(たとえば、数字 1\) を各カラー ベクターに追加すると、5 × 5 の行列を使用して、線形変換と平行移動を任意に組み合わせて適用できます。  線形変換に続いて平行移動を実行する変換をアフィン変換と呼びます。  
+  
+ たとえば、色 \(0.2, 0.0, 0.4, 1.0\) から開始して、次の変換を適用するとします。  
+  
+1.  赤の要素を 2 倍にします。  
+  
+2.  赤、緑、青の各要素に 0.2 を追加します。  
+  
+ 次の行列の掛け合わせによって、ペアになっている変換が、リストに示されている順序で実行されます。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring01.png "recoloring01")  
+  
+ カラー行列の要素には、行そして列ごとに 0 から始まるインデックスが付けられます。  たとえば、行列 M の 5 行目および 3 列目のエントリは、M \[4\]\[2\] と表記されます。  
+  
+ 次の図に示す 5 × 5 の単位行列には、対角線上に 1、それ以外のすべての位置に 0 が格納されています。  カラー ベクターとこの単位行列を掛け合わせても、そのカラー ベクターは変化しません。  カラー変換の行列を形成する簡単な方法として、単位行列から着手し、必要な変換を生成できるように微調整していく方法があります。  
+  
+ ![色変更](../../../../docs/framework/winforms/advanced/media/recoloring02.gif "recoloring02")  
+  
+ 行列と変換の詳細については、「[座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)」を参照してください。  
+  
+## 使用例  
+ 全体が 1 つの色 \(0.2, 0.0, 0.4, 1.0\) であるイメージに、上の段落で説明した変換を適用する例を次に示します。  
+  
+ 次の図は、左側に元のイメージ、右側に変換後のイメージを示しています。  
+  
+ ![色](../../../../docs/framework/winforms/advanced/media/colortrans1.png "colortrans1")  
+  
+ 次のコード例では、以下の手順で色の変更が行われます。  
+  
+1.  <xref:System.Drawing.Imaging.ColorMatrix> オブジェクトを初期化します。  
+  
+2.  <xref:System.Drawing.Imaging.ImageAttributes> オブジェクトを作成し、<xref:System.Drawing.Imaging.ImageAttributes> オブジェクトの <xref:System.Drawing.Imaging.ImageAttributes.SetColorMatrix%2A> メソッドに <xref:System.Drawing.Imaging.ColorMatrix> オブジェクトを渡します。  
+  
+3.  <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドに <xref:System.Drawing.Imaging.ImageAttributes> オブジェクトを渡します。  
+  
+ [!code-csharp[System.Drawing.RecoloringImages#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RecoloringImages/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.RecoloringImages#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RecoloringImages/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)   
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-a-color-remap-table.md b/docs/framework/winforms/advanced/how-to-use-a-color-remap-table.md
new file mode 100644
index 00000000000..f8c21b2315a
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-a-color-remap-table.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : カラー リマップ テーブルを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カラー リマップ テーブル, 使用"
+  - "カラー テーブル, リマップ (色を)"
+  - "作成した色, 作成 (カラー リマップ テーブルを使用して)"
+ms.assetid: 977df1ce-8665-42d4-9fb1-ef7f0ff63419
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : カラー リマップ テーブルを使用する
+リマップとは、イメージ内の色をカラー リマップ テーブルに基づいて変換するプロセスのことです。  カラー リマップ テーブルは、<xref:System.Drawing.Imaging.ColorMap> オブジェクトの配列です。  配列内の各 <xref:System.Drawing.Imaging.ColorMap> オブジェクトは <xref:System.Drawing.Imaging.ColorMap.OldColor%2A> プロパティと <xref:System.Drawing.Imaging.ColorMap.NewColor%2A> プロパティを持ちます。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] がイメージを描画する場合、そのイメージの各ピクセルが古い色の配列と比較されます。  ピクセルの色が古い色と一致すると、その色は対応する新しい色に変更されます。  色が変更されるのは描画時だけであり、<xref:System.Drawing.Image> オブジェクトまたは <xref:System.Drawing.Bitmap> オブジェクトに格納されているイメージ自体のカラー値は変更されません。  
+  
+ リマップされたイメージを描画するには、<xref:System.Drawing.Imaging.ColorMap> オブジェクトの配列を初期化します。  この配列を <xref:System.Drawing.Imaging.ImageAttributes> オブジェクトの <xref:System.Drawing.Imaging.ImageAttributes.SetRemapTable%2A> メソッドに渡し、その <xref:System.Drawing.Imaging.ImageAttributes> オブジェクトを <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawImage%2A> メソッドに渡します。  
+  
+## 使用例  
+ ファイル RemapInput.bmp から <xref:System.Drawing.Image> オブジェクトを作成する例を次に示します。  このコードは、1 つの <xref:System.Drawing.Imaging.ColorMap> オブジェクトから成るカラー リマップ テーブルを作成します。  `ColorRemap` オブジェクトの <xref:System.Drawing.Imaging.ColorMap.OldColor%2A> プロパティは赤で、<xref:System.Drawing.Imaging.ColorMap.NewColor%2A> プロパティは青です。  リマップを適用しない場合と適用する場合それぞれに 1 回ずつイメージが描画されます。  このリマップ プロセスでは、すべての赤いピクセルが青に変更されます。  
+  
+ 次の図は、左側に元のイメージ、右側にリマップされたイメージを示しています。  
+  
+ [!code-csharp[System.Drawing.RecoloringImages#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RecoloringImages/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.RecoloringImages#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RecoloringImages/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)   
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-lines.md b/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-lines.md
new file mode 100644
index 00000000000..656f5028ebf
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-lines.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ペンを使用して線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "線, 描画"
+  - "ペン, 描画 (線を)"
+ms.assetid: 0828c331-a438-4bdd-a4d6-3ef1e59e8795
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ペンを使用して線を描画する
+線を描画するには、<xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトは <xref:System.Drawing.Graphics.DrawLine%2A> メソッドを提供し、<xref:System.Drawing.Pen> オブジェクトは線の色や幅などの特徴を格納します。  
+  
+## 使用例  
+ 1 本の線を点 \(20, 10\) から点 \(300, 100\) に描画する例を次に示します。  最初のステートメントでは、<xref:System.Drawing.Pen.%23ctor%2A> クラス コンストラクターを使用して黒のペンを作成します。  <xref:System.Drawing.Pen.%23ctor%2A> コンストラクターに渡される 1 つの引数は、<xref:System.Drawing.Color.FromArgb%2A> メソッドで作成された <xref:System.Drawing.Color> オブジェクトです。  <xref:System.Drawing.Color> オブジェクトの作成に使用される値は \(255, 0, 0, 0\) であり、各値が色のアルファ、赤、緑、青の各要素に対応しています。  これらの値は、不透明な黒のペンを定義しています。  
+  
+ [!code-csharp[System.Drawing.UsingAPen#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.UsingAPen#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#11)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Pen>   
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)   
+ [GDI\+ でのペン、直線、および四角形](../../../../docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-rectangles.md b/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-rectangles.md
new file mode 100644
index 00000000000..9f9a3fa7747
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-rectangles.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ペンを使用して四角形を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ペン, 描画 (四角形を)"
+  - "四角形, 描画"
+ms.assetid: 54a7fa14-3ad8-4d64-b424-2a12005b250c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ペンを使用して四角形を描画する
+四角形を描画するには、<xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトは <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドを提供し、<xref:System.Drawing.Pen> オブジェクトは線の色や幅などの特徴を格納します。  
+  
+## 使用例  
+ 上隅が \(10, 10\) の位置にある四角形を描画する例を次に示します。  この四角形の幅は 100 で、高さは 50 です。  <xref:System.Drawing.Pen.%23ctor%2A> コンストラクターに渡される 2 番目の引数は、ペン幅が 5 ピクセルであることを示しています。  
+  
+ 四角形が描画されるときは、ペンは四角形の境界の中央に揃えて配置されます。  つまり、この場合はペン幅が 5 であるため、四角形の各辺は 5 ピクセルで描画されますが、そのうち 1 ピクセルは境界上に、2 ピクセルが内側に描画され、2 ピクセルが外側に描画されることになります。  ペンの配置の詳細については、「[方法 : ペンの幅と配置を設定する](../../../../docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md)」を参照してください。  
+  
+ 結果として得られる四角形を次の図に示します。  点線は、ペン幅が 1 ピクセルの場合に四角形が描画される範囲を示しています。  四角形の左上隅の拡大図は、それらの点線の中央に揃えて黒い太線を配置した場合を示しています。  
+  
+ ![ペン](../../../../docs/framework/winforms/advanced/media/pens1.png "pens1")  
+  
+ [!code-csharp[System.Drawing.UsingAPen#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.UsingAPen/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.UsingAPen#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.UsingAPen/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-antialiasing-with-text.md b/docs/framework/winforms/advanced/how-to-use-antialiasing-with-text.md
new file mode 100644
index 00000000000..2dcdcd6719b
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-antialiasing-with-text.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : テキストでのアンチエイリアシングの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アンチエイリアシング, 使用 (テキストで)"
+  - "文字列 [Windows フォーム], アンチエイリアシング (描画時に)"
+  - "文字列 [Windows フォーム], 滑らかにする (描画された)"
+  - "テキスト [Windows フォーム], アンチエイリアシング"
+  - "テキスト [Windows フォーム], 滑らかにする"
+ms.assetid: 48fc34f3-f236-4b01-a0cb-f0752e6d22ae
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : テキストでのアンチエイリアシングの使用
+*アンチエイリアシング*とは、描画されたグラフィックスとテキストのギザギザした境界を滑らかにすることで、外観と読みやすさを向上させます。  マネージ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] クラスでは、低画質のテキストだけでなく、アンチエイリアスされた高画質のテキストを描画できます。  通常、高画質での描画は、低画質での描画よりも時間がかかります。  テキストの画質のレベルを設定するには、<xref:System.Drawing.Graphics> の <xref:System.Drawing.Graphics.TextRenderingHint%2A> プロパティを <xref:System.Drawing.Text.TextRenderingHint> 列挙体の要素のいずれかに設定します。  
+  
+## 使用例  
+ 2 つの異なる画質設定でテキストを描画するコード例を次に示します。  
+  
+ このコード例の出力を次の図に示します。  
+  
+ ![フォント テキスト](../../../../docs/framework/winforms/advanced/media/fontstext10.png "FontsText10")  
+  
+ [!code-csharp[System.Drawing.FontsAndText#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.FontsAndText/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.FontsAndText#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.FontsAndText/VB/Class1.vb#21)]  
+  
+## コードのコンパイル  
+ 前述のコード例は Windows フォームでの使用を前提としたものであり、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-clipping-with-a-region.md b/docs/framework/winforms/advanced/how-to-use-clipping-with-a-region.md
new file mode 100644
index 00000000000..4823272063e
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-clipping-with-a-region.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 領域でクリッピングを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "領域, クリップする"
+  - "領域, 限定 (描画サーフェイスを)"
+ms.assetid: 43d121b4-e14c-4901-b25c-2d6c25ba4e29
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 領域でクリッピングを使用する
+<xref:System.Drawing.Graphics> クラスのプロパティの 1 つとしてクリップ領域があります。  指定の <xref:System.Drawing.Graphics> オブジェクトによって行われるすべての描画は、その <xref:System.Drawing.Graphics> オブジェクトのクリップ領域に限定されます。  クリップ領域を設定するには、<xref:System.Drawing.Graphics.SetClip%2A> メソッドを呼び出します。  
+  
+## 使用例  
+ 1 つの多角形だけから成るパスを作成する例を次に示します。  このコードは、次に、そのパスに基づいて領域を作成します。  作成された領域は <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.SetClip%2A> メソッドに渡され、2 つの文字列が描画されます。  
+  
+ クリップされた文字列を次の図に示します。  
+  
+ ![クリップ](../../../../docs/framework/winforms/advanced/media/clip1.png "clip1")  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#41)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [GDI\+ での領域](../../../../docs/framework/winforms/advanced/regions-in-gdi.md)   
+ [領域の使用](../../../../docs/framework/winforms/advanced/using-regions.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-compositing-mode-to-control-alpha-blending.md b/docs/framework/winforms/advanced/how-to-use-compositing-mode-to-control-alpha-blending.md
new file mode 100644
index 00000000000..24a9e2bfa33
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-compositing-mode-to-control-alpha-blending.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : 複合モードを使用してアルファ ブレンドを制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アルファ ブレンド, 複合"
+  - "色, ブレンド"
+  - "色, 制御 (透明度を)"
+ms.assetid: f331df2d-b395-4b0a-95be-24fec8c9bbb5
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 複合モードを使用してアルファ ブレンドを制御する
+場合によっては、次のような特徴を持つオフスクリーン ビットマップを作成する必要が生じることがあります。  
+  
+-   色のアルファ値は 255 未満である。  
+  
+-   ビットマップを作成しても、色が相互にアルファ ブレンドされることはない。  
+  
+-   完成したビットマップを表示するときに、ディスプレイ デバイス上でビットマップの色が背景色とアルファ ブレンドされる。  
+  
+ このようなビットマップを作成するには、空の <xref:System.Drawing.Bitmap> オブジェクトを作成し、そのビットマップに基づいて <xref:System.Drawing.Graphics> オブジェクトを作成します。  <xref:System.Drawing.Graphics> オブジェクトの複合モードを <xref:System.Drawing.Drawing2D.CompositingMode?displayProperty=fullName> に設定します。  
+  
+## 使用例  
+ <xref:System.Drawing.Bitmap> オブジェクトに基づいて <xref:System.Drawing.Graphics> オブジェクトを作成する例を次に示します。  このコードは、<xref:System.Drawing.Graphics> オブジェクトと共に 2 つの半透明ブラシ \(アルファ \= 160\) を使用して、ビットマップを塗りつぶします。  このコードでは、赤い楕円と緑の楕円が半透明ブラシで塗りつぶされます。  緑の楕円は赤の楕円の上に重なりますが、<xref:System.Drawing.Graphics> オブジェクトの複合モードが <xref:System.Drawing.Drawing2D.CompositingMode> に設定されているため、緑が赤とブレンドされることはありません。  
+  
+ このコードは、画面上にビットマップを 2 回描画します。1 回目は白い背景上、2 回目は複数色の背景上に描画します。  2 つの楕円の一部に含まれるビットマップ内のピクセルのアルファ要素が 160 であるため、楕円の色が画面上で背景色とブレンドされます。  
+  
+ コード例による出力を次の図に示します。  2 つの楕円は、背景とはブレンドされますが、相互にブレンドされることはありません。  
+  
+ ![ソース コピー](../../../../docs/framework/winforms/advanced/media/sourcecopy.png "sourcecopy")  
+  
+ このコード例には、次のようなステートメントがあります。  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.AlphaBlending#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#41)]  
+  
+ 2 つの楕円を背景だけではなく、相互にブレンドする場合には、このステートメントを次のように変更します。  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#42)]
+ [!code-vb[System.Drawing.AlphaBlending#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#42)]  
+  
+ 変更後のコードによる出力を次の図に示します。  
+  
+ ![ソース オーバー](../../../../docs/framework/winforms/advanced/media/sourceover.png "sourceover")  
+  
+ [!code-csharp[System.Drawing.AlphaBlending#43](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.AlphaBlending/CS/Class1.cs#43)]
+ [!code-vb[System.Drawing.AlphaBlending#43](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.AlphaBlending/VB/Class1.vb#43)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Color.FromArgb%2A>   
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-hit-testing-with-a-region.md b/docs/framework/winforms/advanced/how-to-use-hit-testing-with-a-region.md
new file mode 100644
index 00000000000..3a4cb246f06
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-hit-testing-with-a-region.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 領域でヒット テストを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ヒット テスト, 使用 (領域を)"
+  - "領域, ヒット テスト"
+ms.assetid: 3a4c07cb-a40a-4d14-ad35-008f531910a8
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 領域でヒット テストを使用する
+ヒット テストの目的は、アイコンやボタンなどの特定のオブジェクト上にカーソルが配置されているかどうかを確認することです。  
+  
+## 使用例  
+ 2 つの四角形の領域の交差させることにより、十字型の領域を作成する例を次に示します。  変数  `point`  が、最新のクリック位置を保持しているとします。  このコードは、 `point`  が十字型の領域内にあるかどうかを確認します。  `point` が保持している位置が領域内にある場合は、領域が不透明な赤いブラシで塗りつぶされます。  領域内にはない場合、領域は半透明の赤いブラシで塗りつぶされます。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#31)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.PaintEventHandler> のパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ <xref:System.Drawing.Region>   
+ [GDI\+ での領域](../../../../docs/framework/winforms/advanced/regions-in-gdi.md)   
+ [方法 : 領域でクリッピングを使用する](../../../../docs/framework/winforms/advanced/how-to-use-clipping-with-a-region.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-interpolation-mode-to-control-image-quality-during-scaling.md b/docs/framework/winforms/advanced/how-to-use-interpolation-mode-to-control-image-quality-during-scaling.md
new file mode 100644
index 00000000000..8878016713f
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-interpolation-mode-to-control-image-quality-during-scaling.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : 補間モードを使用してスケーリング時の画質を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], 制御 (質を)"
+  - "イメージ [Windows フォーム], スケーリング"
+  - "補間モード, 制御 (画質を)"
+ms.assetid: fde9bccf-8aa5-4b0d-ba4b-788740627b02
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : 補間モードを使用してスケーリング時の画質を制御する
+<xref:System.Drawing.Graphics> オブジェクトの補間モードは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] がイメージをスケーリングする方法 \(拡大および縮小\) に影響します。  <xref:System.Drawing.Drawing2D.InterpolationMode> 列挙体により、いくつかの補間モードが定義されています。そのうちの一部を次の一覧に示します。  
+  
+-   <xref:System.Drawing.Drawing2D.InterpolationMode>  
+  
+-   <xref:System.Drawing.Drawing2D.InterpolationMode>  
+  
+-   <xref:System.Drawing.Drawing2D.InterpolationMode>  
+  
+-   <xref:System.Drawing.Drawing2D.InterpolationMode>  
+  
+-   <xref:System.Drawing.Drawing2D.InterpolationMode>  
+  
+ イメージを拡大するには、元のイメージの各ピクセルを、より大きなイメージに含まれる複数のピクセルのグループに割り当てる必要があります。  イメージを縮小する場合は、元のイメージに含まれる複数のピクセルのグループを、より小さなイメージの単一のピクセルに割り当てる必要があります。  このような割り当てを行うアルゴリズムの性能に応じて、スケーリング後のイメージの画質が決まります。  高画質のイメージを生成するアルゴリズムほど、処理に時間がかかる傾向にあります。  上の一覧では、<xref:System.Drawing.Drawing2D.InterpolationMode> が最も低画質のモードで、<xref:System.Drawing.Drawing2D.InterpolationMode> が最も高画質のモードです。  
+  
+ 補間モードを設定するには、<xref:System.Drawing.Drawing2D.InterpolationMode> 列挙体のいずれかのメンバーを <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.InterpolationMode%2A> プロパティに割り当てます。  
+  
+## 使用例  
+ イメージを描画し、そのイメージを 3 つの異なる補間モードで縮小する例を次に示します。  
+  
+ 元のイメージと縮小後の 3 つのイメージを次の図に示します。  
+  
+ ![さまざまな補間設定を含むイメージ](../../../../docs/framework/winforms/advanced/media/csgrapes1.png "csgrapes1")  
+  
+ [!code-csharp[System.Drawing.WorkingWithImages#81](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/CS/Class1.cs#81)]
+ [!code-vb[System.Drawing.WorkingWithImages#81](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.WorkingWithImages/VB/Class1.vb#81)]  
+  
+## コードのコンパイル  
+ 前述の例は Windows フォームと一緒に使用することが想定されていて、<xref:System.Windows.Forms.Control.Paint> イベント ハンドラーのパラメーターである <xref:System.Windows.Forms.PaintEventArgs> `e` が必要です。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-use-the-modifiers-and-generatemember-properties.md b/docs/framework/winforms/advanced/how-to-use-the-modifiers-and-generatemember-properties.md
new file mode 100644
index 00000000000..9b06ca5916c
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-use-the-modifiers-and-generatemember-properties.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : Modifiers プロパティおよび GenerateMember プロパティを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Designer_GenerateMember"
+  - "Designer_Modifiers"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "基本フォーム"
+  - "フォームの継承"
+  - "GenerateMember プロパティ"
+  - "継承, フォーム"
+  - "継承フォーム"
+  - "継承フォーム, Windows フォーム"
+  - "Modifiers プロパティ"
+  - "Windows フォーム, 継承"
+ms.assetid: 3381a5e4-e1a3-44e2-a765-a0b758937b85
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Modifiers プロパティおよび GenerateMember プロパティを使用する
+Windows フォームにコンポーネントを配置するときに、デザイン環境では `GenerateMember` プロパティと `Modifiers` プロパティを使用できます。  `GenerateMember` プロパティは、Windows フォーム デザイナーでコンポーネントにメンバー変数を生成するときに指定します。  `Modifiers` プロパティは、そのメンバー変数に割り当てるアクセス修飾子です。  `GenerateMember` プロパティの値が `false` の場合、`Modifiers` プロパティの値は無効です。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コンポーネントがフォームのメンバーかどうかを指定するには  
+  
+1.  Windows フォーム デザイナーで、フォームを開きます。  
+  
+2.  **ツールボックス**を開き、3 つの <xref:System.Windows.Forms.Button> コントロールをフォームに配置します。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの `GenerateMember` プロパティと `Modifiers` プロパティを、次の表に示した値に設定します。  
+  
+    |ボタン名|GenerateMember 値|Modifiers 値|  
+    |----------|----------------------|-----------------|  
+    |`button1`|`true`|`private`|  
+    |`button2`|`true`|`protected`|  
+    |`button3`|`false`|変更なし|  
+  
+4.  ソリューションをビルドします。  
+  
+5.  **ソリューション エクスプローラー**の **\[すべてのファイルを表示\]** をクリックします。  
+  
+6.  **\[Form1\]** ノードを開き、**コード エディター**で、**Form1.Designer.vb** ファイルまたは **Form1.Designer.cs** ファイルを開きます。  このファイルには、Windows フォーム デザイナーからコードが出力されます。  
+  
+7.  3 つのボタンの宣言を探します。  `GenerateMember` プロパティと `Modifiers` プロパティの指定による違いを以下のコード例に示します。  
+  
+     [!code-csharp[System.Windows.Forms.GenerateMember#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.GenerateMember/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.GenerateMember#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.GenerateMember/VB/Form1.vb#3)]  
+  
+     [!code-csharp[System.Windows.Forms.GenerateMember#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.GenerateMember/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.GenerateMember#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.GenerateMember/VB/Form1.vb#2)]  
+  
+> [!NOTE]
+>  Windows フォーム デザイナーは、<xref:System.Windows.Forms.Panel> などのコンテナー コントロールに既定で `private` \(Visual Basic では `Friend`\) 修飾子を割り当てます。  ベースの <xref:System.Windows.Forms.UserControl> または <xref:System.Windows.Forms.Form> にコンテナー コントロールが含まれていても、継承されたコントロールやフォームで新しい子を追加することはできません。  これを解決するには、ベースのコンテナー コントロールの修飾子を `protected` または `public` に変更します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Button>   
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)   
+ [チュートリアル : ビジュアル継承のデモンストレーション](../../../../docs/framework/winforms/advanced/walkthrough-demonstrating-visual-inheritance.md)   
+ [方法 : Windows フォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-validate-application-settings.md b/docs/framework/winforms/advanced/how-to-validate-application-settings.md
new file mode 100644
index 00000000000..54c1e49e91c
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-validate-application-settings.md
@@ -0,0 +1,171 @@
+---
+title: "方法 : アプリケーション設定を検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定, 検証"
+  - "アプリケーション設定, Windows フォーム"
+  - "検証 (アプリケーション設定を)"
+ms.assetid: 9f145ada-4267-436a-aa4c-c4dcffd0afb7
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : アプリケーション設定を検証する
+ここでは、アプリケーション設定を永続化する前に検証する方法について説明します。  
+  
+ アプリケーションは厳密に型指定されるため、特定の設定に対してユーザーが誤った型を指定することはほとんどありません。  しかし、たとえば、誕生日として未来の日付を指定するなど、ユーザーが許容範囲外の設定値を割り当てようとすることもあります。  すべてのアプリケーション設定クラスの親クラスである <xref:System.Configuration.ApplicationSettingsBase> では、このような範囲チェックを有効にする 4 つのイベントが公開されています。  これらのイベントを処理すると、すべての検証コードを 1 か所に配置できるため、検証コードがプロジェクト全体に分散しません。  
+  
+ 次の表で説明するように、使用するイベントは設定をいつ検証するかによって決まります。  
+  
+|Event|発生と使用|  
+|-----------|-----------|  
+|<xref:System.Configuration.ApplicationSettingsBase.SettingsLoaded>|設定プロパティ グループが初めて読み込まれた後に発生します。<br /><br /> このイベントを使用して、プロパティ グループ全体の初期値がアプリケーション内で使用される前に検証します。|  
+|<xref:System.Configuration.ApplicationSettingsBase.SettingChanging>|単一の設定プロパティの値が変更される前に発生します。<br /><br /> このイベントを使用して、単一のプロパティが変更される前に検証します。  処理および選択に関するフィードバックを即時にユーザーに提供できます。|  
+|<xref:System.Configuration.ApplicationSettingsBase.PropertyChanged>|単一の設定プロパティの値が変更された後に発生します。<br /><br /> このイベントを使用して、単一のプロパティが変更された後で検証します。  時間がかかる非同期の検証プロセスが必要な場合を除き、このイベントを検証に使用することはほとんどありません。|  
+|<xref:System.Configuration.ApplicationSettingsBase.SettingsSaving>|設定プロパティ グループが格納される前に発生します。<br /><br /> このイベントを使用して、プロパティ グループ全体の値がディスクに永続化される前に検証します。|  
+  
+ 通常、同じアプリケーション内のすべてのイベントを検証の目的で使用することはありません。  たとえば、多くの場合、<xref:System.Configuration.ApplicationSettingsBase.SettingChanging> イベントを処理するだけですべての検証要件を満たすことができます。  
+  
+ 一般に、イベント ハンドラーが無効な値を検出すると、次のいずれかを実行します。  
+  
+-   既定値など、正しいことが判明している値を自動的に入力します。  
+  
+-   情報のサーバー コードをユーザーに再照会します。  
+  
+-   関連付けられたアクションの前に発生した <xref:System.Configuration.ApplicationSettingsBase.SettingChanging> や <xref:System.Configuration.ApplicationSettingsBase.SettingsSaving> などのイベントの場合は、引数 <xref:System.ComponentModel.CancelEventArgs> を使用して操作を取り消します。  
+  
+ イベント処理の詳細については、「[イベント ハンドラーの概要](../../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)」を参照してください。  
+  
+ 次のプロシージャは、<xref:System.Configuration.ApplicationSettingsBase.SettingChanging> イベントまたは <xref:System.Configuration.ApplicationSettingsBase.SettingsSaving> イベントを使用して有効な誕生日をテストする方法を示しています。  このプロシージャは、アプリケーション設定を既に作成していることを前提にしています。この例では、 `DateOfBirth` という名前の設定の範囲チェックを実行します。  設定の作成の詳細については、「[方法 : アプリケーション設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)」を参照してください。  
+  
+### アプリケーション設定オブジェクトを取得するには  
+  
+-   次の項目のいずれかを実行してアプリケーション設定オブジェクト \(ラッパー インスタンス\) への参照を取得します。  
+  
+    -   Visual Studio の**プロパティ エディター**の \[アプリケーション設定\] ダイアログ ボックスを使用して設定を作成したときは、次の式によって使用している言語用に生成された既定の設定オブジェクトを取得できます。  
+  
+        ```csharp  
+        Configuration.Settings.Default   
+        ```  
+  
+        ```vb  
+        MySettings.Default   
+        ```  
+  
+         または  
+  
+    -   Visual Basic 開発者がプロジェクト デザイナーを使用してアプリケーション設定を作成したときは、[My.Settings オブジェクト](../../../../ocs/visual-basic/language-reference/objects/my-settings-object.md) を使用して設定を取得できます。  
+  
+         または  
+  
+    -   <xref:System.Configuration.ApplicationSettingsBase> から直接派生して設定を作成したときは、手動でクラスをインスタンス化する必要があります。  
+  
+        ```csharp  
+        MyCustomSettings settings = new MyCustomSettings();  
+        ```  
+  
+        ```vb  
+        Dim Settings as New MyCustomSettings()  
+        ```  
+  
+ 次のプロシージャでは、この最後に紹介した項目を実行してアプリケーション設定オブジェクトを取得していることを前提にしています。  
+  
+### 設定の変更時にアプリケーション設定を検証するには  
+  
+1.  C\# を使用している場合は、フォームまたはコントロールの  `Load`  イベント内に <xref:System.Configuration.ApplicationSettingsBase.SettingChanging> イベントのイベント ハンドラーを追加します。  
+  
+     または  
+  
+     Visual Basic を使用している場合は、`WithEvents` キーワードを使用して `Settings` 変数を宣言します。  
+  
+    ```csharp  
+    public void Form1_Load(Object sender, EventArgs e)   
+    {  
+        settings.SettingChanging += new SettingChangingEventHandler(MyCustomSettings_SettingChanging);  
+    }  
+    ```  
+  
+    ```vb  
+    Public Sub Form1_Load(sender as Object, e as EventArgs)  
+        AddHandler settings.SettingChanging, AddressOf MyCustomSettings_SettingChanging  
+    End Sub   
+    ```  
+  
+2.  イベント ハンドラーを定義し、その中に誕生日の範囲チェックを実行するコードを記述します。  
+  
+    ```csharp  
+    private void MyCustomSettings_SettingChanging(Object sender, SettingChangingEventArgs e)  
+    {  
+        if (e.SettingName.Equals("DateOfBirth")) {  
+            Date newDate = (Date)e.NewValue;  
+            If (newDate > Date.Now) {  
+                e.Cancel = true;  
+                // Inform the user.  
+            }  
+        }  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub MyCustomSettings_SettingChanging(sender as Object, e as SettingChangingEventArgs) Handles Settings.SettingChanging  
+        If (e.SettingName.Equals("DateOfBirth")) Then  
+            Dim NewDate as Date = CType(e.NewValue, Date)  
+            If (NewDate > Date.Now) Then  
+                e.Cancel = True  
+                ' Inform the user.  
+            End If  
+        End If  
+    End Sub  
+    ```  
+  
+### 保存時にアプリケーション設定を検証するには  
+  
+1.  フォームまたはコントロールの  `Load`  イベント内に <xref:System.Configuration.ApplicationSettingsBase.SettingsSaving> イベントのイベント ハンドラーを追加します。  
+  
+    ```csharp  
+    public void Form1_Load(Object sender, EventArgs e)   
+    {  
+        settings.SettingsSaving += new SettingsSavingEventHandler(MyCustomSettings_SettingsSaving);  
+    }  
+    ```  
+  
+    ```vb  
+    Public Sub Form1_Load(Sender as Object, e as EventArgs)  
+        AddHandler settings.SettingsSaving, AddressOf MyCustomSettings_SettingsSaving  
+    End Sub  
+    ```  
+  
+2.  イベント ハンドラーを定義し、その中に誕生日の範囲チェックを実行するコードを記述します。  
+  
+    ```csharp  
+    private void MyCustomSettings_SettingsSaving(Object sender, SettingsSavingEventArgs e)  
+    {  
+        if (this["DateOfBirth"] > Date.Now) {  
+            e.Cancel = true;  
+        }  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub MyCustomSettings_SettingsSaving(Sender as Object, e as SettingsSavingEventArgs)  
+        If (Me["DateOfBirth"] > Date.Now) Then  
+            e.Cancel = True  
+        End If  
+    End Sub  
+    ```  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)   
+ [方法 : アプリケーション設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/how-to-write-user-settings-at-run-time-with-csharp.md b/docs/framework/winforms/advanced/how-to-write-user-settings-at-run-time-with-csharp.md
new file mode 100644
index 00000000000..369faeb3222
--- /dev/null
+++ b/docs/framework/winforms/advanced/how-to-write-user-settings-at-run-time-with-csharp.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : 実行時にユーザー設定を C# で書き込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], C#"
+  - "アプリケーション設定 [Windows フォーム], 実行時に"
+  - "アプリケーション設定 [Windows フォーム], 作成 (ユーザー設定を)"
+ms.assetid: 9d061c7d-b33b-470f-a36d-edccb1d6f9a3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 実行時にユーザー設定を C# で書き込む
+アプリケーション スコープの設定は読み取り専用であり、デザイン時、またはアプリケーション セッション間に .config ファイルを変更することによってのみ変更できます。  ただし、ユーザー スコープの設定は、プロパティ値を変更する場合と同様に、実行時に書き込むことができます。  新しい値は、アプリケーションのセッションの実行中に永続化します。  Save メソッドを呼び出すことによって、アプリケーション セッション間で、設定の変更を永続化することができます。  
+  
+### 方法 : 実行時にユーザー設定を C\# で書き込んで永続化する  
+  
+1.  この設定にアクセスし、この例で示すように、新しい値を割り当てます。  
+  
+    ```  
+    // C#  
+    Properties.Settings.Default.myColor = Color.AliceBlue;  
+    ```  
+  
+2.  アプリケーション セッション間で、設定の変更を永続化する場合は、この例で示すように Save メソッドを呼び出します。  
+  
+    ```  
+    // C#  
+    Properties.Settings.Default.Save();  
+    ```  
+  
+     ユーザー設定は、ユーザーの非表示のローカル アプリケーション データ フォルダーのサブフォルダー内のファイルに保存されます。  
+  
+## 参照  
+ [アプリケーション設定とユーザー設定の使用](../../../../docs/framework/winforms/advanced/using-application-settings-and-user-settings.md)   
+ [方法 : 実行時に設定を C\# で読み取る](../../../../docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md)   
+ [アプリケーション設定の概要](../../../../docs/framework/winforms/advanced/application-settings-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md b/docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md
new file mode 100644
index 00000000000..3bab8e27061
--- /dev/null
+++ b/docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md
@@ -0,0 +1,51 @@
+---
+title: "イメージ、ビットマップ、およびメタファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], ビットマップの概要"
+  - "イメージ [Windows フォーム], イメージの概要"
+  - "メタファイル, メタファイルの概要"
+  - "Windows フォーム, イメージ"
+ms.assetid: 7152b45b-a55c-49bc-8c78-ae002a844f71
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# イメージ、ビットマップ、およびメタファイル
+`Image` クラスはラスター イメージ \(ビットマップ\) およびベクター イメージ \(メタファイル\) を操作するためのメソッドを提供する抽象基本クラスです。  `Bitmap` クラスおよび <xref:System.Drawing.Imaging.Metafile> クラスは、どちらも `Image` クラスから継承されます。  `Bitmap` クラスは、ラスター イメージの読み込み、保存、および操作のための追加のメソッドを提供することで、`Image` クラスの機能を展開します。  <xref:System.Drawing.Imaging.Metafile> クラスは、ベクター イメージの記録および検証のための追加のメソッドを提供することで、`Image` クラスの機能を展開します。  
+  
+## このセクションの内容  
+ [ビットマップの種類](../../../../docs/framework/winforms/advanced/types-of-bitmaps.md)  
+ さまざまなイメージ形式について説明します。  
+  
+ [GDI\+ でのメタファイル](../../../../docs/framework/winforms/advanced/metafiles-in-gdi.md)  
+ メタファイルの [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] のサポートについて説明します。  
+  
+ [GDI\+ でのイメージの描画、配置、およびクローン作成](../../../../docs/framework/winforms/advanced/drawing-positioning-and-cloning-images-in-gdi.md)  
+ マネージ コードを使用して、ベクター イメージとラスター イメージを描画するためのメソッドについて説明します。  
+  
+ [GDI\+ でのイメージのトリミングおよびスケーリング](../../../../docs/framework/winforms/advanced/cropping-and-scaling-images-in-gdi.md)  
+ マネージ コードを使用して、ベクター イメージとラスター イメージのトリミングとスケーリングのためのメソッドについて説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Image>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Bitmap>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)  
+ アプリケーションでイメージを使用する方法を説明するトピックへのリンクが含まれます。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/index.md b/docs/framework/winforms/advanced/index.md
new file mode 100644
index 00000000000..29eb62cabda
--- /dev/null
+++ b/docs/framework/winforms/advanced/index.md
@@ -0,0 +1,75 @@
+---
+title: "Windows フォーム アプリケーションの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 追加 (機能を)"
+  - "Windows フォーム, 拡張"
+ms.assetid: 733d1219-d6ad-4256-a55b-9eccf47f5a06
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォーム アプリケーションの拡張
+Windows フォームには、ユーザーの固有のニーズに合わせて、Windows ベースのアプリケーションを強化するために使用できる多くの機能が含まれます。  次のトピックは、これらの機能とその使用方法について説明します。  
+  
+## このセクションの内容  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)  
+ Windows フォームでグラフィックスのインターフェイスを使用する方法について説明したトピックへのリンクが含まれます。  
+  
+ [Windows フォームのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-windows-forms.md)  
+ **アプリケーション設定**機能を使用する方法について説明したトピックへのリンクが含まれます。  
+  
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)  
+ Windows フォーム アプリケーションからファイルを印刷する方法について説明したトピックへのリンクを示します。  
+  
+ [ドラッグ アンド ドロップ操作とクリップボードのサポート](../../../../docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md)  
+ Windows フォームのドラッグ アンド ドロップ機能とクリップボードを使用する方法について説明したトピックへのリンクが含まれます。  
+  
+ [Windows フォーム アプリケーションにおけるネットワーク](../../../../docs/framework/winforms/advanced/networking-in-windows-forms-applications.md)  
+ Windows フォームのネットワーキングを使用する方法について説明したトピックへのリンクが含まれます。  
+  
+ [Windows フォームのグローバル化](../../../../docs/framework/winforms/advanced/globalizing-windows-forms.md)  
+ Windows フォーム アプリケーションをグローバル化する方法を示すトピックへのリンクが含まれます。  
+  
+ [Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)  
+ Windows フォーム アプリケーションから COM コンポーネントにアクセスする方法について説明したトピックへのリンクを示します。  
+  
+ [システム情報と Windows フォーム](../../../../docs/framework/winforms/advanced/system-information-and-windows-forms.md)  
+ Windows フォームでのシステム情報を使用する方法について説明します。  
+  
+ [Windows フォームでの電源管理](../../../../docs/framework/winforms/advanced/power-management-in-windows-forms.md)  
+ Windows フォーム アプリケーションでの電力使用を管理する方法について説明します。  
+  
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)  
+ 基本フォームから継承する方法について説明します。  
+  
+ [マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](../../../../docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md)  
+ 複数のマルチ ドキュメント インターフェイス \(MDI\) アプリケーションを作成する方法について説明します。  
+  
+ [Windows フォームでのヘルプの統合](../../../../docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md)  
+ アプリケーションでユーザー ヘルプを統合する方法について説明します。  
+  
+ [Windows フォームのユーザー補助](../../../../docs/framework/winforms/advanced/windows-forms-accessibility.md)  
+ さまざまなユーザーがアプリケーションを使用できるようにする方法について説明します。  
+  
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)  
+ Windows フォーム ベースのアプリケーションで WPF コントロールを使用する方法について説明します。  
+  
+## 関連項目  
+ [Windows フォーム アプリケーションのヘルプ システム](../../../../docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md)  
+ Windows フォーム アプリケーションでユーザーにヘルプを提供する方法について説明したトピックへのリンクを示します。  
+  
+ [Windows フォームについて](../../../../docs/framework/winforms/getting-started-with-windows-forms.md)  
+ Windows フォームで基本的な機能を使用する方法を説明するトピックへのリンクが含まれます。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md b/docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md
new file mode 100644
index 00000000000..3217011d926
--- /dev/null
+++ b/docs/framework/winforms/advanced/integrating-user-help-in-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "Windows フォームでのヘルプの統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム ヘルプ (デザイナーを使用した)"
+  - "ヘルプ, Windows アプリケーション (デザイナーを使用した)"
+  - "ヘルプ, Windows フォーム (デザイナーを使用した)"
+  - "HTML ヘルプ, Windows フォーム (デザイナーを使用した)"
+  - "Windows アプリケーション, ヘルプ (デザイナーを使用した)"
+  - "Windows フォーム, ヘルプ (デザイナーを使用した)"
+ms.assetid: a8563d25-8a75-4bc7-a024-f1870591b50f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Windows フォームでのヘルプの統合
+Windows ベース アプリケーションの構築に関して重要でありながら見逃されがちな部分に、ヘルプ システムがあります。これは、ユーザーが混乱したときに支援を求める場所です。  Windows フォームは、2 つの異なる種類のヘルプをサポートしており、それぞれ [HelpProvider コンポーネント](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md) コンポーネントによって提供されます。  1 つは、ユーザーに対して HTML または HTML Help 1.*x* 以降の形式のヘルプ ファイルを表示する方法です。  もう 1 つは、各コントロール上に "これは何か" という簡単な説明をヘルプの形で表示する方法です。これはダイアログ ボックスで特に便利です。  両方の種類のヘルプを同じフォームで使うことができます。  
+  
+ さらに、[ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md) コンポーネントを使用して、Windows フォーム上のコントロールに関する個別のヘルプも表示できます。  
+  
+## このセクションの内容  
+ [方法 : Windows アプリケーションにヘルプを提供する](../../../../docs/framework/winforms/advanced/how-to-provide-help-in-a-windows-application.md)  
+ `HelpProvider` コンポーネントを使用してヘルプ システムのファイルにコントロールを関連付ける方法について説明します。  
+  
+ [方法 : ポップアップ ヘルプを表示する](../../../../docs/framework/winforms/advanced/how-to-display-pop-up-help.md)  
+ `HelpProvider` コンポーネントを使用して Windows フォーム上にポップアップ ヘルプを表示する方法について説明します。  
+  
+ [ツールヒントを使用したコントロールのヘルプ](../../../../docs/framework/winforms/advanced/control-help-using-tooltips.md)  
+ `ToolTip` コンポーネントを使用してコントロール固有のヘルプを表示する方法について説明します。  
+  
+## 関連項目  
+ [HelpProvider コンポーネント](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md)  
+ `HelpProvider` コンポーネントに関する基本的な事項について説明します。  
+  
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)  
+ `ToolTip` コンポーネントに関する基本的な事項について説明します。  
+  
+ [Windows フォームの概要](../../../../docs/framework/winforms/windows-forms-overview.md)  
+ Windows フォームに関する基本的な事項について説明します。  
+  
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)  
+ Windows フォームの概要を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/international-fonts-in-windows-forms-and-controls.md b/docs/framework/winforms/advanced/international-fonts-in-windows-forms-and-controls.md
new file mode 100644
index 00000000000..c1bda7a5e8b
--- /dev/null
+++ b/docs/framework/winforms/advanced/international-fonts-in-windows-forms-and-controls.md
@@ -0,0 +1,93 @@
+---
+title: "Windows フォームおよびコントロールの国際対応フォント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント フォールバック (Windows フォームでの)"
+  - "フォント, グローバリゼーションの考慮事項"
+  - "フォント, 国際対応"
+  - "グローバリゼーション [Windows フォーム], 文字セット"
+  - "国際対応のアプリケーション [Windows フォーム], 文字表示"
+  - "ローカリゼーション [Windows フォーム], フォント"
+  - "Windows フォーム コントロール, ラベル"
+ms.assetid: 2c3066df-9bac-479a-82b2-79e484b346a3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Windows フォームおよびコントロールの国際対応フォント
+国際対応のアプリケーションでフォントを選択する方法としては、できるだけフォント フォールバックを使用することをお勧めします。  フォント フォールバックとは、文字が属する言語をシステムが判断することを指します。  
+  
+## フォント フォールバックの使用  
+ この機能を利用するには、フォームまたはその他の要素の <xref:System.Drawing.Font> プロパティは設定しないようにしてください。  アプリケーションが、オペレーティング システムのローカライズ言語ごとに異なる既定のシステム フォントを自動的に使用します。  アプリケーションの実行時、システムにより、オペレーティング システムで選択された地域に適したフォントが自動的に設定されます。  
+  
+ フォント設定をしないという規則には、フォント スタイルの変更を考慮した例外があります。  このことは、ユーザーがテキスト ボックスのテキストを太字で表示させるためにボタンをクリックするアプリケーションで重要になります。  これを行うには、フォームのフォントに関係なく、テキスト ボックスのスタイルを太字に変更する関数を作成します。  この関数は <xref:System.Windows.Forms.Control.Click> イベント ハンドラーおよび <xref:System.Windows.Forms.Control.FontChanged> イベント ハンドラーの 2 か所で呼び出す必要があります。  <xref:System.Windows.Forms.Control.Click> イベント ハンドラーでだけこの関数を呼び出した場合、コードの他の部分によってフォーム全体のフォント ファミリが変更されると、テキスト ボックスは、このフォームの残りの要素と同じフォント ファミリに変更されません。  
+  
+```  
+' Visual Basic  
+Private Sub MakeBold()  
+   ' Change the TextBox to a bold version of the form font  
+   TextBox1.Font = New Font(Me.Font, FontStyle.Bold)  
+End Sub  
+  
+Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+   ' Clicking this button makes the TextBox bold  
+   MakeBold()  
+End Sub  
+  
+Private Sub Form1_FontChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.FontChanged  
+   ' If the TextBox is already bold and the form's font changes,  
+   ' change the TextBox to a bold version of the new form font  
+   If (TextBox1.Font.Style = FontStyle.Bold) Then  
+      MakeBold()  
+   End If  
+End Sub  
+  
+// C#  
+private void button1_Click(object sender, System.EventArgs e)  
+{  
+   // Clicking this button makes the TextBox bold  
+   MakeBold();  
+}  
+  
+private void MakeBold()   
+{  
+   // Change the TextBox to a bold version of the form's font  
+   textBox1.Font = new Font(this.Font, FontStyle.Bold);  
+}  
+  
+private void Form1_FontChanged(object sender, System.EventArgs e)  
+{  
+   // If the TextBox is already bold and the form's font changes,  
+   // change the TextBox to a bold version of the new form font  
+   if (textBox1.Font.Style == FontStyle.Bold)   
+   {  
+      MakeBold();  
+   }  
+}  
+```  
+  
+ ただし、言語によっては、アプリケーションのローカライズにより、太字フォントの表示が乱れることがあります。  このことが問題になる場合は、ローカライズで、フォント切り替えオプションを太字ではなく通常のテキストに指定します。  一般に、ローカリゼーション担当者は、開発者とは異なりソース コードに手を加えることはせず、リソース ファイルだけを処理します。したがって、このオプションの設定はリソース ファイルで行う必要があります。  これを行うには、<xref:System.Drawing.Font.Bold%2A> プロパティを `true` に設定します。  これにより、フォント設定がリソース ファイルに書き出され、ローカリゼーション担当者が編集できるようになります。  `InitializeComponent`  メソッドの後に、フォームのフォントに関係なくフォントをリセットし、リソース ファイルで指定されたフォント スタイルを使用するためのコードを記述します。  
+  
+```  
+' Visual Basic  
+TextBox1.Font = New System.Drawing.Font(Me.Font, TextBox1.Font.Style)  
+  
+// C#  
+textBox1.Font = new System.Drawing.Font(this.Font, textBox1.Font.Style);  
+```  
+  
+## 参照  
+ [Windows フォームのグローバル化](../../../../docs/framework/winforms/advanced/globalizing-windows-forms.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/lines-curves-and-shapes.md b/docs/framework/winforms/advanced/lines-curves-and-shapes.md
new file mode 100644
index 00000000000..3fe31a2c6ee
--- /dev/null
+++ b/docs/framework/winforms/advanced/lines-curves-and-shapes.md
@@ -0,0 +1,65 @@
+---
+title: "直線、曲線、および図形 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "曲線, 描画"
+  - "線, 描画"
+  - "形状, 塗りつぶし"
+  - "図形、描画"
+  - "スプライン, 描画"
+ms.assetid: ace6e8d4-4e94-486b-9681-758a6667dc7f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 直線、曲線、および図形
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] のベクター グラフィックス部分は、直線、曲線、および図形の描画と塗りつぶしのために使用されます。  
+  
+## このセクションの内容  
+ [ベクター グラフィックスの概要](../../../../docs/framework/winforms/advanced/vector-graphics-overview.md)  
+ ベクター グラフィックスについて詳しく説明します。  
+  
+ [GDI\+ でのペン、直線、および四角形](../../../../docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md)  
+ 線と四角形の描画について詳しく説明します。  
+  
+ [GDI\+ での楕円および円弧](../../../../docs/framework/winforms/advanced/ellipses-and-arcs-in-gdi.md)  
+ 円弧と楕円を定義し、これらを描画するために必要なクラスを示します。  
+  
+ [GDI\+ での多角形](../../../../docs/framework/winforms/advanced/polygons-in-gdi.md)  
+ 多角形を定義し、これらを描画するために必要なクラスを示します。  
+  
+ [GDI\+ でのカーディナル スプライン](../../../../docs/framework/winforms/advanced/cardinal-splines-in-gdi.md)  
+ カーディナル スプラインを定義し、これらを描画するために必要なクラスを示します。  
+  
+ [GDI\+ でのベジエ スプライン](../../../../docs/framework/winforms/advanced/bezier-splines-in-gdi.md)  
+ ベジエ スプラインを定義し、これらを描画するために必要なクラスを示します。  
+  
+ [GDI\+ でのグラフィックス パス](../../../../docs/framework/winforms/advanced/graphics-paths-in-gdi.md)  
+ パスについて説明し、パスの作成方法と描画方法を示します。  
+  
+ [GDI\+ でのブラシと塗りつぶされた図形](../../../../docs/framework/winforms/advanced/brushes-and-filled-shapes-in-gdi.md)  
+ ブラシの種類とその使用方法について説明します。  
+  
+ [GDI\+ での開いた曲線と閉じた曲線](../../../../docs/framework/winforms/advanced/open-and-closed-curves-in-gdi.md)  
+ 開いた曲線と閉じた曲線を定義し、それらを描画したり塗りつぶしたりする方法を説明します。  
+  
+ [GDI\+ での領域](../../../../docs/framework/winforms/advanced/regions-in-gdi.md)  
+ 領域に関連付けられたメソッドについて説明します。  
+  
+ [GDI\+ での描画サーフェイスの制限](../../../../docs/framework/winforms/advanced/restricting-the-drawing-surface-in-gdi.md)  
+ クリッピングとその使用方法について説明します。  
+  
+ [直線と曲線のアンチエイリアシング](../../../../docs/framework/winforms/advanced/antialiasing-with-lines-and-curves.md)  
+ アンチエイリアシングを定義し、直線と曲線を描画する際にアンチエイリアシングを使用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/managing-the-state-of-a-graphics-object.md b/docs/framework/winforms/advanced/managing-the-state-of-a-graphics-object.md
new file mode 100644
index 00000000000..76ef6553884
--- /dev/null
+++ b/docs/framework/winforms/advanced/managing-the-state-of-a-graphics-object.md
@@ -0,0 +1,165 @@
+---
+title: "Graphics オブジェクトの状態の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, クリップする"
+  - "グラフィックス, 管理 (状態を)"
+ms.assetid: 6207cad1-7a34-4bd6-bfc1-db823ca7a73e
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Graphics オブジェクトの状態の管理
+<xref:System.Drawing.Graphics> クラスは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の中核となる役割を果たします。  描画を行う場合は、<xref:System.Drawing.Graphics> オブジェクトを取得し、そのプロパティを設定し、そのメソッド \(<xref:System.Drawing.Graphics.DrawLine%2A>、<xref:System.Drawing.Graphics.DrawImage%2A>、<xref:System.Drawing.Graphics.DrawString%2A> など\) を呼び出します。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドを呼び出す例を次に示します。  <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドに渡される最初の引数は <xref:System.Drawing.Pen> オブジェクトです。  
+  
+```vb  
+Dim graphics As Graphics = e.Graphics  
+Dim pen As New Pen(Color.Blue) ' Opaque blue  
+graphics.DrawRectangle(pen, 10, 10, 200, 100)  
+  
+```  
+  
+```csharp  
+Graphics graphics = e.Graphics;  
+Pen pen = new Pen(Color.Blue);  // Opaque blue  
+graphics.DrawRectangle(pen, 10, 10, 200, 100);  
+```  
+  
+## グラフィックスの状態  
+ <xref:System.Drawing.Graphics> オブジェクトは、<xref:System.Drawing.Graphics.DrawLine%2A> や <xref:System.Drawing.Graphics.DrawRectangle%2A> などの描画メソッドを用意するだけではありません。  <xref:System.Drawing.Graphics> オブジェクトは、次のカテゴリに分類されるグラフィックスの状態も維持します。  
+  
+-   画質の設定  
+  
+-   変換  
+  
+-   クリッピング領域  
+  
+### 画質の設定  
+ <xref:System.Drawing.Graphics> オブジェクトには、描画対象となる項目の画質に影響する複数のプロパティがあります。  たとえば、<xref:System.Drawing.Graphics.TextRenderingHint%2A> プロパティには、テキストに適用するアンチエイリアシングの種類を指定できます。  項目の画質に影響するその他のプロパティには、<xref:System.Drawing.Graphics.SmoothingMode%2A>、<xref:System.Drawing.Graphics.CompositingMode%2A>、<xref:System.Drawing.Graphics.CompositingQuality%2A>、および <xref:System.Drawing.Graphics.InterpolationMode%2A> があります。  
+  
+ 2 つの楕円を描画する例を次に示します。一方にはスムージング モードとして <xref:System.Drawing.Drawing2D.SmoothingMode> を設定し、もう一方にはスムージング モードとして <xref:System.Drawing.Drawing2D.SmoothingMode> を設定しています。  
+  
+```vb  
+Dim graphics As Graphics = e.Graphics  
+Dim pen As New Pen(Color.Blue)  
+  
+graphics.SmoothingMode = SmoothingMode.AntiAlias  
+graphics.DrawEllipse(pen, 0, 0, 200, 100)  
+graphics.SmoothingMode = SmoothingMode.HighSpeed  
+graphics.DrawEllipse(pen, 0, 150, 200, 100)  
+  
+```  
+  
+```csharp  
+Graphics graphics = e.Graphics;  
+Pen pen = new Pen(Color.Blue);  
+  
+graphics.SmoothingMode = SmoothingMode.AntiAlias;  
+graphics.DrawEllipse(pen, 0, 0, 200, 100);  
+graphics.SmoothingMode = SmoothingMode.HighSpeed;  
+graphics.DrawEllipse(pen, 0, 150, 200, 100);  
+```  
+  
+### 変換  
+ <xref:System.Drawing.Graphics> オブジェクトは 2 種類の変換 \(ワールド変換およびページ変換\) を維持しており、これらの変換がその <xref:System.Drawing.Graphics> オブジェクトが描画するすべての項目に適用されます。  ワールド変換には、任意のアフィン変換を格納できます。  アフィン変換には、スケーリング、回転、反転、傾斜、および平行移動があります。  ページ変換は、スケーリングや単位の変更 \(ピクセルからインチへの変更など\) のために使用できます。  詳細については、「[座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)」を参照してください。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトのワールド変換およびページ変換を設定する例を次に示します。  ワールド変換として、30°の回転を設定します。  ページ変換は、2 番目の <xref:System.Drawing.Graphics.DrawEllipse%2A> に渡される座標がピクセル単位ではなくミリメートル単位で扱われるように設定されます。  このコードは、<xref:System.Drawing.Graphics.DrawEllipse%2A> メソッドをまったく同じように 2 回呼び出します。  最初の <xref:System.Drawing.Graphics.DrawEllipse%2A> 呼び出しにはワールド変換が適用され、2 回目の <xref:System.Drawing.Graphics.DrawEllipse%2A> 呼び出しには両方の変換 \(ワールド変換およびページ変換\) が適用されます。  
+  
+```vb  
+Dim graphics As Graphics = e.Graphics  
+Dim pen As New Pen(Color.Red)  
+  
+graphics.ResetTransform()  
+graphics.RotateTransform(30) ' world transformation  
+graphics.DrawEllipse(pen, 0, 0, 100, 50)  
+graphics.PageUnit = GraphicsUnit.Millimeter ' page transformation  
+graphics.DrawEllipse(pen, 0, 0, 100, 50)  
+  
+```  
+  
+```csharp  
+Graphics graphics = e.Graphics;  
+Pen pen = new Pen(Color.Red);   
+  
+graphics.ResetTransform();  
+graphics.RotateTransform(30);                    // world transformation  
+graphics.DrawEllipse(pen, 0, 0, 100, 50);  
+graphics.PageUnit = GraphicsUnit.Millimeter;     // page transformation  
+graphics.DrawEllipse(pen, 0, 0, 100, 50);  
+```  
+  
+ 結果として得られる 2 つの楕円を次の図に示します。  30°の回転は、楕円の中心ではなく、座標系の原点 \(クライアント領域の左上隅\) を軸として行われます。  また、ペン幅の 1 とは、最初の楕円では 1 ピクセルを意味し、2 番目の楕円では 1 ミリメートルを意味します。  
+  
+ ![楕円](../../../../docs/framework/winforms/advanced/media/csgraphicsascon1.png "csgraphicsascon1")  
+  
+### クリッピング領域  
+ <xref:System.Drawing.Graphics> オブジェクトは、その <xref:System.Drawing.Graphics> オブジェクトが描画するすべての項目に適用されるクリッピング領域を維持しています。  クリッピング領域を設定するには、<xref:System.Drawing.Graphics.SetClip%2A> メソッドを呼び出します。  
+  
+ 2 つの四角形を交差させることによって十字型の領域を作成する例を次に示します。  この領域が、<xref:System.Drawing.Graphics> オブジェクトのクリッピング領域として指定されます。  次に、このコードは、描画範囲がクリッピング領域の内側に限定された 2 本の直線を描画します。  
+  
+```vb  
+Dim graphics As Graphics = e.Graphics  
+  
+' Opaque red, width 5  
+Dim pen As New Pen(Color.Red, 5)  
+  
+' Opaque aqua  
+Dim brush As New SolidBrush(Color.FromArgb(255, 180, 255, 255))  
+  
+' Create a plus-shaped region by forming the union of two rectangles.  
+Dim [region] As New [Region](../../../../amples/snippets/visualbasic/VS_Snippets_Wpf/ToolBarOrient_snip/visualbasic/toolbargraphics/new.bmp Rectangle(50, 0, 50, 150))  
+[region].Union(New Rectangle(0, 50, 150, 50))  
+graphics.FillRegion(brush, [region])  
+  
+' Set the clipping region.  
+graphics.SetClip([region], CombineMode.Replace)  
+  
+' Draw two clipped lines.  
+graphics.DrawLine(pen, 0, 30, 150, 160)  
+graphics.DrawLine(pen, 40, 20, 190, 150)  
+  
+```  
+  
+```csharp  
+Graphics graphics = e.Graphics;  
+  
+// Opaque red, width 5  
+Pen pen = new Pen(Color.Red, 5);    
+  
+// Opaque aqua  
+SolidBrush brush = new SolidBrush(Color.FromArgb(255, 180, 255, 255));    
+  
+// Create a plus-shaped region by forming the union of two rectangles.  
+Region region = new Region(new Rectangle(50, 0, 50, 150));  
+region.Union(new Rectangle(0, 50, 150, 50));  
+graphics.FillRegion(brush, region);  
+  
+// Set the clipping region.  
+graphics.SetClip(region, CombineMode.Replace);  
+  
+// Draw two clipped lines.  
+graphics.DrawLine(pen, 0, 30, 150, 160);  
+graphics.DrawLine(pen, 40, 20, 190, 150);  
+```  
+  
+ クリップされた直線を次の図に示します。  
+  
+ ![制限されたクリップ領域](../../../../docs/framework/winforms/advanced/media/graphicsascon2.png "graphicsascon2")  
+  
+## 参照  
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [入れ子になっているグラフィックス コンテナーの使用](../../../../docs/framework/winforms/advanced/using-nested-graphics-containers.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/matrix-representation-of-transformations.md b/docs/framework/winforms/advanced/matrix-representation-of-transformations.md
new file mode 100644
index 00000000000..64e690fa305
--- /dev/null
+++ b/docs/framework/winforms/advanced/matrix-representation-of-transformations.md
@@ -0,0 +1,114 @@
+---
+title: "変換の行列表現 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アフィン変換"
+  - "複合変換"
+  - "線形変換"
+  - "行列"
+  - "変換, 複合"
+  - "変換, リニア"
+  - "変換, 行列表現"
+  - "変換, 変換"
+  - "平行移動 (行列表現内の)"
+  - "ベクター"
+ms.assetid: 0659fe00-9e0c-41c4-9118-016f2404c905
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 変換の行列表現
+m×n 行列とは、m 行 n 列に配列された数値の集まりです。  いくつかの行列を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art04.png "AboutGdip05\_art04")  
+  
+ 同じサイズの 2 つの行列を加算するには、個々の要素を加算します。  行列加算の 2 つの例を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art05.png "AboutGdip05\_art05")  
+  
+ m×n 行列に n×p 行列を掛け合わせることができ、その結果は m×p 行列になります。  1 番目の行列の列数が、2 番目の行列の行数と同じである必要があります。  たとえば、4 × 2 行列に 2 × 3 行列を掛け合わせて、4 × 3 行列を生成できます。  
+  
+ 平面上の点および行列の行と列は、ベクターであると考えることができます。  たとえば、\(2, 5\) は 2 つの要素を持つベクターであり、\(3, 7, 1\) は 3 つの要素を持つベクターです。  2 つのベクターのドット積は、次のように定義されます。  
+  
+ \(a, b\) × \(c, d\) \= ac \+ bd  
+  
+ \(a, b, c\) × \(d, e, f\) \= ad \+ be \+ cf  
+  
+ たとえば、\(2, 3\) と \(5, 4\) のドット積は \(2\)\(5\) \+ \(3\)\(4\) \= 22 です。  \(2, 5, 1\) と \(4, 3, 1\) のドット積は \(2\)\(4\) \+ \(5\)\(3\) \+ \(1\)\(1\) \= 24 です。  2 つのベクターのドット積は、別のベクターではなく 1 つの数値になります。  また、ドット積を計算できるのは、2 つのベクターの要素の数が同じ場合だけです。  
+  
+ A\(i, j\) は、行列 A の i 行目、j 列目のエントリであるとします。  たとえば、A\(3, 2\) は行列 A の 3 行目、2 列目のエントリです。  A、B、および C の 3 つの行列があり、AB \= C であるとします。  C のエントリは次のように計算されます。  
+  
+ C\(i, j\) \= \(A の i 行\) × \(B の j 列\)  
+  
+ 行列乗算のいくつかの例を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art06.png "AboutGdip05\_art06")  
+  
+ 平面上の各点を 1 × 2 行列と考えると、その点を、2 × 2 行列を掛け合わせることによって変換できます。  点 \(2, 1\) に適用されるいくつかの変換を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art07.gif "AboutGdip05\_art07")  
+  
+ 上の図に示す変換は、すべて線形変換です。  線形変換ではない平行移動などの変換は、2 × 2 行列による乗算では表現できません。  点 \(2, 1\) を 90°回転してから、x 方向に 3 単位、y 方向に 4 単位平行移動するとします。  この変換を実行するには、行列乗算の後で行列加算を実行します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art08.gif "AboutGdip05\_art08")  
+  
+ 線形変換 \(2 × 2 行列による乗算\) の後で平行移動 \(1 × 2 行列の加算\) を実行することを、アフィン変換と呼びます。  1 つのアフィン変換を 2 つの行列 \(線形変換用の行列と平行移動用の行列\) の組み合わせに格納する代わりに、この変換全体を 1 つの 3 × 3 行列に格納できます。  この方法を使用するには、平面上の各点を、3 番目の座標としてダミー座標を持つ 1 × 3 行列に格納する必要があります。  通常の手法では、3 番目の座標はすべて 1 にします。  たとえば、点 \(2, 1\) を行列 \[2 1 1\] で表します。  アフィン変換 \(90°の回転、x 方向に 3 単位の平行移動、y 方向に 4 単位の平行移動\) を 1 つの 3 × 3 行列による乗算として表現する例を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art09.png "AboutGdip05\_art09")  
+  
+ 上の例では、点 \(2, 1\) が点 \(2, 6\) に割り当てられます。  3 × 3 行列の 3 番目の列には、数値 0, 0, 1 が格納されています。  アフィン変換の 3 × 3 行列では、常にこの数値は同じです。  重要な数値は、列 1 と列 2 にある 6 個の数値です。  行列の左上の 2 × 2 部分が線形変換を表し、3 番目の行の最初の 2 つのエントリが平行移動を表します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art10.gif "AboutGdip05\_art10")  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、アフィン変換を <xref:System.Drawing.Drawing2D.Matrix> オブジェクトに格納できます。  アフィン変換を表す行列の 3 番目の列は常に \(0, 0, 1\) であるため、<xref:System.Drawing.Drawing2D.Matrix> を構築するときには、最初の 2 列にある 6 個の数値だけを指定します。  `Matrix myMatrix = new Matrix(0, 1, -1, 0, 3, 4)` ステートメントによって、上の図に示す行列が構築されます。  
+  
+## 複合変換  
+ 複合変換は、複数の変換を 1 つずつ連続して実行します。  次の一覧に示す行列と変換を考えてみます。  
+  
+|||  
+|-|-|  
+|行列 A|90°の回転|  
+|行列 B|x 方向にファクター 2 のスケーリング|  
+|行列 C|y 方向に 3 単位の平行移動|  
+  
+ 行列 \[2 1 1\] で表される点 \(2, 1\) に A、B、C を順に掛け合わせると、点 \(2, 1\) に対して 3 つの変換が上の一覧の順序で適用されます。  
+  
+ \[2 1 1\]ABC \= \[\-2 5 1\]  
+  
+ 複合変換の 3 つの部分を 3 つの異なる行列に格納する代わりに、A、B、C をすべて掛け合わせることで、この複合変換全体を格納する 1 つの 3 × 3 行列を得ることができます。  ABC \= D であるとします。  この場合、ある点に D を掛け合わせると、その点に A、B、C を順に掛け合わせた場合と同じ結果が得られます。  
+  
+ \[2 1 1\]D \= \[\-2 5 1\]  
+  
+ A、B、C、D の各行列を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art12.png "AboutGdip05\_art12")  
+  
+ 個々の変換を表す行列を掛け合わせることにより、1 つの複合変換の行列を作成できるということは、連続するアフィン変換の任意の組み合わせを 1 つの <xref:System.Drawing.Drawing2D.Matrix> オブジェクトに格納できることを意味します。  
+  
+> [!CAUTION]
+>  変換の順序が重要です。  一般に、回転、スケーリング、平行移動の順序で実行される変換は、スケーリング、回転、平行移動の順序で実行される変換と異なります。  同様に、行列乗算でも順序が重要です。  一般に、ABC と BAC は異なります。  
+  
+ <xref:System.Drawing.Drawing2D.Matrix> クラスには、複合変換を作成するためのメソッドとして、<xref:System.Drawing.Drawing2D.Matrix.Multiply%2A>、<xref:System.Drawing.Drawing2D.Matrix.Rotate%2A>、<xref:System.Drawing.Drawing2D.Matrix.RotateAt%2A>、<xref:System.Drawing.Drawing2D.Matrix.Scale%2A>、<xref:System.Drawing.Drawing2D.Matrix.Shear%2A>、および <xref:System.Drawing.Drawing2D.Matrix.Translate%2A> が用意されています。  30°の回転、y 方向にファクター 2 のスケーリング、x 方向に 5 単位の平行移動を順に実行する複合変換の行列の作成例を次に示します。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.CoordinateSystems#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#11)]  
+  
+ この行列を次の図に示します。  
+  
+ ![変換](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art13.png "AboutGdip05\_art13")  
+  
+## 参照  
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)   
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/media/aboutgdip02-art28.gif b/docs/framework/winforms/advanced/media/aboutgdip02-art28.gif
new file mode 100644
index 00000000000..ed05bb5b29e
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip02-art28.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip02-art29.gif b/docs/framework/winforms/advanced/media/aboutgdip02-art29.gif
new file mode 100644
index 00000000000..455b344ed2b
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip02-art29.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip02-art36.gif b/docs/framework/winforms/advanced/media/aboutgdip02-art36.gif
new file mode 100644
index 00000000000..bd9796c46e5
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip02-art36.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip03-art03.gif b/docs/framework/winforms/advanced/media/aboutgdip03-art03.gif
new file mode 100644
index 00000000000..48c95b965df
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip03-art03.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip05-art07.gif b/docs/framework/winforms/advanced/media/aboutgdip05-art07.gif
new file mode 100644
index 00000000000..d2a3b12f03f
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip05-art07.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip05-art08.gif b/docs/framework/winforms/advanced/media/aboutgdip05-art08.gif
new file mode 100644
index 00000000000..fb2736d8c6a
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip05-art08.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip05-art10.gif b/docs/framework/winforms/advanced/media/aboutgdip05-art10.gif
new file mode 100644
index 00000000000..75cafea7a6e
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip05-art10.gif differ
diff --git a/docs/framework/winforms/advanced/media/aboutgdip05-art14.gif b/docs/framework/winforms/advanced/media/aboutgdip05-art14.gif
new file mode 100644
index 00000000000..5893d9d0772
Binary files /dev/null and b/docs/framework/winforms/advanced/media/aboutgdip05-art14.gif differ
diff --git a/docs/framework/winforms/advanced/media/fontstext7a.png b/docs/framework/winforms/advanced/media/fontstext7a.png
new file mode 100644
index 00000000000..81c36810573
Binary files /dev/null and b/docs/framework/winforms/advanced/media/fontstext7a.png differ
diff --git a/docs/framework/winforms/advanced/media/fontstext9.png b/docs/framework/winforms/advanced/media/fontstext9.png
new file mode 100644
index 00000000000..f3252096d36
Binary files /dev/null and b/docs/framework/winforms/advanced/media/fontstext9.png differ
diff --git a/docs/framework/winforms/advanced/media/pathgradient6.png b/docs/framework/winforms/advanced/media/pathgradient6.png
new file mode 100644
index 00000000000..1ea171aafde
Binary files /dev/null and b/docs/framework/winforms/advanced/media/pathgradient6.png differ
diff --git a/docs/framework/winforms/advanced/media/recoloring02.gif b/docs/framework/winforms/advanced/media/recoloring02.gif
new file mode 100644
index 00000000000..0142b104933
Binary files /dev/null and b/docs/framework/winforms/advanced/media/recoloring02.gif differ
diff --git a/docs/framework/winforms/advanced/media/recoloring03.gif b/docs/framework/winforms/advanced/media/recoloring03.gif
new file mode 100644
index 00000000000..2d5fb5e4c68
Binary files /dev/null and b/docs/framework/winforms/advanced/media/recoloring03.gif differ
diff --git a/docs/framework/winforms/advanced/media/recoloring04.gif b/docs/framework/winforms/advanced/media/recoloring04.gif
new file mode 100644
index 00000000000..2ec41bbc2c8
Binary files /dev/null and b/docs/framework/winforms/advanced/media/recoloring04.gif differ
diff --git a/docs/framework/winforms/advanced/media/recoloring05.gif b/docs/framework/winforms/advanced/media/recoloring05.gif
new file mode 100644
index 00000000000..8e1efce1ae2
Binary files /dev/null and b/docs/framework/winforms/advanced/media/recoloring05.gif differ
diff --git a/docs/framework/winforms/advanced/media/recoloring06.gif b/docs/framework/winforms/advanced/media/recoloring06.gif
new file mode 100644
index 00000000000..d6d7b228110
Binary files /dev/null and b/docs/framework/winforms/advanced/media/recoloring06.gif differ
diff --git a/docs/framework/winforms/advanced/media/stripes1.gif b/docs/framework/winforms/advanced/media/stripes1.gif
new file mode 100644
index 00000000000..e89d1ed5890
Binary files /dev/null and b/docs/framework/winforms/advanced/media/stripes1.gif differ
diff --git a/docs/framework/winforms/advanced/media/vbpizzaorderform.gif b/docs/framework/winforms/advanced/media/vbpizzaorderform.gif
new file mode 100644
index 00000000000..cdad626747a
Binary files /dev/null and b/docs/framework/winforms/advanced/media/vbpizzaorderform.gif differ
diff --git a/docs/framework/winforms/advanced/metafiles-in-gdi.md b/docs/framework/winforms/advanced/metafiles-in-gdi.md
new file mode 100644
index 00000000000..f83f24c9904
--- /dev/null
+++ b/docs/framework/winforms/advanced/metafiles-in-gdi.md
@@ -0,0 +1,47 @@
+---
+title: "GDI+ でのメタファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, メタファイル"
+  - "イメージ [Windows フォーム], メタファイル"
+  - "メタファイル"
+ms.assetid: 51da872c-c783-440f-8bf6-1e580a966c31
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# GDI+ でのメタファイル
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、メタファイルの記録および表示のために <xref:System.Drawing.Imaging.Metafile> クラスが用意されています。  メタファイルは、一連の描画コマンドおよび描画設定として格納されるイメージで、ベクター イメージと呼ばれることもあります。  <xref:System.Drawing.Imaging.Metafile> オブジェクトに記録されるコマンドと設定は、メモリに格納したり、ファイルやストリームに保存したりできます。  
+  
+## メタファイルの形式  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、次の形式で格納されたメタファイルを表示できます。  
+  
+-   WMF \(Windows メタファイル\)  
+  
+-   EMF \(拡張メタファイル\)  
+  
+-   EMF\+  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、EMF 形式と EMF\+ 形式でメタファイルを記録できますが、WMF 形式では記録できません。  
+  
+ EMF\+ は EMF の拡張機能であり、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] レコードを格納できます。  EMF\+ 形式には、EMF\+ Only と EMF\+ Dual の 2 種類があります。  EMF\+ Only メタファイルは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] レコードだけを格納します。  このメタファイルは [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では表示できますが、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] では表示できません。  EMF\+ Dual メタファイルは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)]レコードと [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] レコードを格納します。  EMF\+ Dual メタファイル内の各 [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] レコードは、代替の [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] レコードとペアになります。  このメタファイルは [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] または [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] で表示できます。  
+  
+ 以前にファイルとして保存されたメタファイルを表示する例を次に示します。  このメタファイルは、左上隅の座標を \(100, 100\) として表示されます。  
+  
+ [!code-csharp[System.Drawing.ImagesBitmapsMetafiles#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.ImagesBitmapsMetafiles#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.ImagesBitmapsMetafiles/VB/Class1.vb#21)]  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md b/docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md
new file mode 100644
index 00000000000..fdc8ffe7d66
--- /dev/null
+++ b/docs/framework/winforms/advanced/multiple-document-interface-mdi-applications.md
@@ -0,0 +1,46 @@
+---
+title: "マルチ ドキュメント インターフェイス (MDI) アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, MDI"
+  - "MDI"
+  - "Windows フォーム, MDI アプリケーション"
+  - "ウィンドウ, MDI"
+ms.assetid: 599faf75-13cf-49cc-ad3c-255545e5cb97
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# マルチ ドキュメント インターフェイス (MDI) アプリケーション
+マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) アプリケーションでは、一度に複数のドキュメントを開き、各ドキュメントをそれぞれのウィンドウに表示できます。  通常、MDI アプリケーションには \[ウィンドウ\] メニューがあり、その中にウィンドウまたはドキュメントを切り替えるためのサブメニューがあります。  
+  
+> [!NOTE]
+>  MDI フォームと Windows フォーム内のシングル ドキュメント インターフェイス \(SDI: Single\-Document Interface\) ウィンドウとの間には、動作に関していくつかの違いがあります。  `Opacity` プロパティは、MDI 子フォームの外観には作用しません。  さらに、<xref:System.Windows.Forms.Form.CenterToParent%2A> メソッドも、MDI 子フォームの動作には作用しません。  
+  
+## このセクションの内容  
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)  
+ MDI アプリケーション内に複数のドキュメントのコンテナーを作成する方法について説明します。  
+  
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)  
+ MDI 親フォーム内で動作するウィンドウを 1 つ以上作成する方法について説明します。  
+  
+ [方法 : アクティブな MDI 子フォームを特定する](../../../../docs/framework/winforms/advanced/how-to-determine-the-active-mdi-child.md)  
+ フォーカスを持つ子ウィンドウを確認する方法、およびそのウィンドウの内容をクリップボードに送る方法について説明します。  
+  
+ [方法 : アクティブな MDI 子フォームにデータを送信する](../../../../docs/framework/winforms/advanced/how-to-send-data-to-the-active-mdi-child.md)  
+ アクティブな子ウィンドウに情報を転送する方法について説明します。  
+  
+ [方法 : MDI 子フォームを配置する](../../../../docs/framework/winforms/advanced/how-to-arrange-mdi-child-forms.md)  
+ MDI アプリケーションの子ウィンドウを並べて表示したり、重ねて表示したり、並べ替えたりする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/networking-in-windows-forms-applications.md b/docs/framework/winforms/advanced/networking-in-windows-forms-applications.md
new file mode 100644
index 00000000000..05b637fd365
--- /dev/null
+++ b/docs/framework/winforms/advanced/networking-in-windows-forms-applications.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォーム アプリケーションにおけるネットワーク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ネットワーク, Windows フォーム"
+  - "Windows フォーム, ネットワーク"
+ms.assetid: babf8af3-8000-46e2-8c68-a42127efabba
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォーム アプリケーションにおけるネットワーク
+.NET Framework には、Web ページの表示、Web コンテンツのダウンロード、ファイル転送プロトコル \(FTP\) サイトとのやり取り、および Web サービスの利用のためのクラスが用意されており、ネットワーク機能をアプリケーションに簡単に組み込むことができます。  以下の各項目は、.NET Framework のネットワーク テクノロジと、それを Windows フォームに取り入れる方法を理解するために役立ちます。  
+  
+## 関連項目  
+ <xref:System.Net>  
+ ネットワーク接続を処理する、.NET Framework のクラスのルート名前空間。  
+  
+ <xref:System.Net.WebClient>  
+ プログラムで Web コンテンツまたは HTTP ベースのコンテンツを取得するための便利なクラス。  
+  
+ <xref:System.Net.FtpWebRequest>  
+ FTP を使用してファイルを取得および送信するためのクラス。  
+  
+ <xref:System.Windows.Forms.WebBrowser>  
+ Windows に含まれる `WebBrowser` コントロールのマネージ ラッパー クラス。  
+  
+## 関連項目  
+ [.NET Framework のネットワーク プログラミング](../../../../docs/framework/network-programming/index.md)  
+ .NET Framework におけるネットワークについて概要を説明します。  
+  
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)  
+ ローカル データ ストアまたはネットワーク上のデータベースにあるコンテンツを、アプリケーションで表示する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/open-and-closed-curves-in-gdi.md b/docs/framework/winforms/advanced/open-and-closed-curves-in-gdi.md
new file mode 100644
index 00000000000..c104420e0e5
--- /dev/null
+++ b/docs/framework/winforms/advanced/open-and-closed-curves-in-gdi.md
@@ -0,0 +1,63 @@
+---
+title: "GDI+ での開いた曲線と閉じた曲線 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "曲線"
+  - "曲線, 描画"
+  - "曲線, 塗りつぶし"
+  - "GDI+, 曲線"
+ms.assetid: 08d2cc9a-dc9d-4eed-bcbb-2c8e2ca5d3ae
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# GDI+ での開いた曲線と閉じた曲線
+開いた曲線と閉じた曲線を次の図に示します。  
+  
+ ![開いた曲線と閉じた曲線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art24.png "Aboutgdip02\_art24")  
+  
+## 曲線の管理インターフェイス  
+ 閉じた曲線には内部があるため、ブラシを使用して塗りつぶすことができます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の <xref:System.Drawing.Graphics> クラスには、閉じた図形および曲線を塗りつぶすためのメソッドとして、<xref:System.Drawing.Graphics.FillRectangle%2A>、<xref:System.Drawing.Graphics.FillEllipse%2A>、<xref:System.Drawing.Graphics.FillPie%2A>、<xref:System.Drawing.Graphics.FillPolygon%2A>、<xref:System.Drawing.Graphics.FillClosedCurve%2A>、<xref:System.Drawing.Graphics.FillPath%2A>、および <xref:System.Drawing.Graphics.FillRegion%2A> が用意されています。  これらのメソッドの 1 つを呼び出す場合は、特定のブラシ型 \(<xref:System.Drawing.SolidBrush>、<xref:System.Drawing.Drawing2D.HatchBrush>、<xref:System.Drawing.TextureBrush>、<xref:System.Drawing.Drawing2D.LinearGradientBrush>、または <xref:System.Drawing.Drawing2D.PathGradientBrush>\) の 1 つを引数として渡す必要があります。  
+  
+ <xref:System.Drawing.Graphics.FillPie%2A> メソッドは、<xref:System.Drawing.Graphics.DrawArc%2A> メソッドのコンパニオン メソッドです。  <xref:System.Drawing.Graphics.DrawArc%2A> メソッドが楕円のアウトラインの一部を描画するのと同様に、<xref:System.Drawing.Graphics.FillPie%2A> メソッドは楕円の内部の一部を塗りつぶします。  円弧を描画し、その円弧に対応する楕円の内部の一部を塗りつぶす例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#21)]
+ [!code-vb[LinesCurvesAndShapes#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#21)]  
+  
+ 円弧と塗りつぶされた扇形を次の図に示します。  
+  
+ ![開いた曲線と閉じた曲線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art25.png "Aboutgdip02\_art25")  
+  
+ <xref:System.Drawing.Graphics.FillClosedCurve%2A> メソッドは、<xref:System.Drawing.Graphics.DrawClosedCurve%2A> メソッドのコンパニオン メソッドです。  この 2 つのメソッドは、終了点と開始点を連結することによって曲線を自動的に閉じます。  \(0, 0\)、\(60, 20\)、および \(40, 50\) を通過する曲線を描画する例を次に示します。  次に、\(40, 50\) と開始点 \(0, 0\) を連結することによって曲線を自動的に閉じ、内部を純色で塗りつぶします。  
+  
+ [!code-csharp[LinesCurvesAndShapes#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#22)]
+ [!code-vb[LinesCurvesAndShapes#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#22)]  
+  
+ <xref:System.Drawing.Graphics.FillPath%2A> メソッドは、1 つのパスの各部分の内部を塗りつぶします。  パスの 1 つの部分が閉じた曲線または図形を形成していない場合、<xref:System.Drawing.Graphics.FillPath%2A> メソッドは、塗りつぶす前にパスのその部分を自動的に閉じます。  円弧、カーディナル スプライン、文字列、および扇形で構成されるパスを描画し、その内部を塗りつぶす例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#23)]
+ [!code-vb[LinesCurvesAndShapes#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#23)]  
+  
+ 純色で塗りつぶしたパスと、塗りつぶしていないパスを次の図に示します。  <xref:System.Drawing.Graphics.DrawPath%2A> メソッドによって文字列内のテキストのアウトラインは描画されていますが、内部は塗りつぶされていません。  文字列の文字の内部を塗りつぶすのは、<xref:System.Drawing.Graphics.FillPath%2A> メソッドです。  
+  
+ ![パスの文字列](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art26.png "Aboutgdip02\_art26")  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.GraphicsPath?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ <xref:System.Drawing.Point?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/overview-of-graphics.md b/docs/framework/winforms/advanced/overview-of-graphics.md
new file mode 100644
index 00000000000..8ca1fffef6b
--- /dev/null
+++ b/docs/framework/winforms/advanced/overview-of-graphics.md
@@ -0,0 +1,43 @@
+---
+title: "グラフィックスについて | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, 概要 (グラフィックスの)"
+  - "グラフィックス, 使用 (マネージ インターフェイスを)"
+ms.assetid: a602aef8-a8c8-4c36-9816-74e7bad96a68
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# グラフィックスについて
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、Microsoft Windows オペレーティング システムのサブシステムを形成するアプリケーション プログラミング インターフェイス \(API\) です。[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、情報を表示する画面およびプリンターを担当しています。  その名前からわかるように、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] の後継であり、以前のバージョンの Windows に含まれているグラフィックス デバイス インターフェイスです。  
+  
+## マネージ クラスのインターフェイス  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] API は、マネージ コードとして配置されているクラスのセットを通じて公開されます。  このクラスのセットは [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] に対する *マネージ クラスのインターフェイス* と呼ばれます。  次の名前空間は、マネージ クラスのインターフェイスを構成します。  
+  
+-   <xref:System.Drawing>  
+  
+-   <xref:System.Drawing.Drawing2D>  
+  
+-   <xref:System.Drawing.Imaging>  
+  
+-   <xref:System.Drawing.Text>  
+  
+-   <xref:System.Drawing.Printing>  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] などのグラフィックス デバイス インターフェイスを使用して、画面、またはプリンターに情報を表示でき、特定のディスプレイ デバイスの詳細について考慮する必要はありません。  プログラマは [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] クラスによって提供されるさまざまなメソッドを呼び出します。次に、これらのメソッドで、特定のデバイス ドライバーへの適切な呼び出しを実行します。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、グラフィックス ハードウェアからアプリケーションを分離します。この分離により、プログラマがデバイスに依存しないアプリケーションを作成できるようになります。  
+  
+## 参照  
+ [グラフィックスの概要](../../../../docs/framework/winforms/advanced/graphics-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md b/docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md
new file mode 100644
index 00000000000..518132f5b9e
--- /dev/null
+++ b/docs/framework/winforms/advanced/pens-lines-and-rectangles-in-gdi.md
@@ -0,0 +1,82 @@
+---
+title: "GDI+ でのペン、直線、および四角形 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, 線"
+  - "描画, 四角形"
+  - "例 [Windows フォーム], 描画 (線と形状を)"
+  - "例 [Windows フォーム], GDI+"
+  - "例 [Windows フォーム], ペン"
+  - "GDI+, 線"
+  - "GDI+, ペン"
+  - "GDI+, 四角形"
+  - "線"
+  - "線, 破線"
+  - "四角形"
+ms.assetid: 30b25aae-e3eb-4479-bdb8-187cf651fc84
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# GDI+ でのペン、直線、および四角形
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] で直線を描画するには、<xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトを作成する必要があります。  <xref:System.Drawing.Graphics> オブジェクトは実際に描画を実行するメソッドを提供し、<xref:System.Drawing.Pen> オブジェクトは線の色、幅、スタイルなどの属性を格納します。  
+  
+## 直線の描画  
+ 直線を描画するには、<xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.DrawLine%2A> メソッドを呼び出します。  <xref:System.Drawing.Pen> オブジェクトは、引数の 1 つとして <xref:System.Drawing.Graphics.DrawLine%2A> メソッドに渡されます。  点 \(4, 2\) から点 \(12, 6\) までの直線を描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#41)]
+ [!code-vb[LinesCurvesAndShapes#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#41)]  
+  
+ <xref:System.Drawing.Graphics.DrawLine%2A> は <xref:System.Drawing.Graphics> クラスのオーバーロードされたメソッドであるため、いくつかの方法でこのメソッドの引数を指定できます。  たとえば、2 つの <xref:System.Drawing.Point> オブジェクトを構築して、その <xref:System.Drawing.Point> オブジェクトを引数として <xref:System.Drawing.Graphics.DrawLine%2A> メソッドに渡すことができます。  
+  
+ [!code-csharp[LinesCurvesAndShapes#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#42)]
+ [!code-vb[LinesCurvesAndShapes#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#42)]  
+  
+## ペンの構築  
+ <xref:System.Drawing.Pen> オブジェクトを構築するときに、所定の属性を指定できます。  たとえば、ある `Pen` コンストラクターでは色と幅を指定できます。  \(0, 0\) から \(60, 30\) まで幅 2 の青い直線を描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#43](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#43)]
+ [!code-vb[LinesCurvesAndShapes#43](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#43)]  
+  
+## 破線とライン キャップ  
+ <xref:System.Drawing.Pen> オブジェクトは、線の特性を指定するために使用できる <xref:System.Drawing.Pen.DashStyle%2A> などのプロパティも公開します。  \(100, 50\) から \(300, 80\) まで破線を描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#44](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#44)]
+ [!code-vb[LinesCurvesAndShapes#44](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#44)]  
+  
+ <xref:System.Drawing.Pen> オブジェクトのプロパティを使用して、線の属性をさらに指定できます。  <xref:System.Drawing.Pen.StartCap%2A> プロパティと <xref:System.Drawing.Pen.EndCap%2A> プロパティは、直線のエンドポイントの外観を指定します。エンドポイントの外観として、フラット、直角、丸、三角、またはカスタム図形を指定できます。  <xref:System.Drawing.Pen.LineJoin%2A> プロパティでは、連結した直線の処理として、留め継ぎ \(角を丸めずに接合\)、面取り、丸め、またはクリッピングを指定できます。  さまざまなキャップ スタイルと接合スタイルを持つ直線を次の図に示します。  
+  
+ ![線](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art04.png "Aboutgdip02\_art04")  
+  
+## 四角形の描画  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用した四角形の描画は、直線の描画に似ています。  四角形を描画するには、<xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトは <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドを提供し、<xref:System.Drawing.Pen> オブジェクトは線の幅やなどの属性を格納します。  <xref:System.Drawing.Pen> オブジェクトは、引数の 1 つとして <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドに渡されます。  左上隅 \(100, 50\)、幅 80、高さ 40 の四角形を描画する例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#45](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#45)]
+ [!code-vb[LinesCurvesAndShapes#45](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#45)]  
+  
+ <xref:System.Drawing.Graphics.DrawRectangle%2A> は <xref:System.Drawing.Graphics> クラスのオーバーロードされたメソッドであるため、いくつかの方法でこのメソッドの引数を指定できます。  たとえば、<xref:System.Drawing.Rectangle> オブジェクトを構築して、その <xref:System.Drawing.Rectangle> オブジェクトを引数として <xref:System.Drawing.Graphics.DrawRectangle%2A> メソッドに渡すことができます。  
+  
+ [!code-csharp[LinesCurvesAndShapes#46](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#46)]
+ [!code-vb[LinesCurvesAndShapes#46](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#46)]  
+  
+ <xref:System.Drawing.Rectangle> オブジェクトには、四角形についての情報を操作および収集するためのメソッドとプロパティがあります。  たとえば、<xref:System.Drawing.Rectangle.Inflate%2A> メソッドと <xref:System.Drawing.Rectangle.Offset%2A> メソッドは、四角形のサイズと位置を変更します。  <xref:System.Drawing.Rectangle.IntersectsWith%2A> メソッドは、四角形が指定した別の四角形と重なる部分を持つかどうかを示します。<xref:System.Drawing.Rectangle.Contains%2A> メソッドは、指定した点が四角形の内部にあるかどうかを示します。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ <xref:System.Drawing.Rectangle?displayProperty=fullName>   
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)   
+ [方法 : Windows フォームに直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-line-on-a-windows-form.md)   
+ [方法 : 形状のアウトラインを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-an-outlined-shape.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/polygons-in-gdi.md b/docs/framework/winforms/advanced/polygons-in-gdi.md
new file mode 100644
index 00000000000..5a23e61b338
--- /dev/null
+++ b/docs/framework/winforms/advanced/polygons-in-gdi.md
@@ -0,0 +1,44 @@
+---
+title: "GDI+ での多角形 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, 多角形"
+  - "GDI+, 多角形"
+  - "多角形"
+ms.assetid: a72213d2-d69a-4c2b-a75c-be7b20390c13
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# GDI+ での多角形
+多角形は、3 つ以上の辺を持つ閉じた図形です。  たとえば、三角形、四角形、五角形は、それぞれ 3 辺、4 辺、5 辺を持つ多角形です。  いくつかの多角形を次の図に示します。  
+  
+ ![多角形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art07.png "Aboutgdip02\_art07")  
+  
+## 多角形の描画  
+ 多角形を描画するには、<xref:System.Drawing.Graphics> オブジェクト、<xref:System.Drawing.Pen> オブジェクト、および <xref:System.Drawing.Point> \(または <xref:System.Drawing.PointF>\) オブジェクト配列が必要です。  <xref:System.Drawing.Graphics> オブジェクトには、<xref:System.Drawing.Graphics.DrawPolygon%2A> メソッドが用意されています。  <xref:System.Drawing.Pen> オブジェクトは多角形の描画に使用される線の幅や色などの属性を格納し、<xref:System.Drawing.Point> オブジェクト配列は直線で連結される複数の点を格納します。  <xref:System.Drawing.Pen> オブジェクトと <xref:System.Drawing.Point> オブジェクト配列は、引数として <xref:System.Drawing.Graphics.DrawPolygon%2A> メソッドに渡されます。  3 辺を持つ多角形を描画する例を次に示します。   `myPointArray` の点は、\(0, 0\)、\(50, 30\)、および \(30, 60\) の 3 点だけです。  <xref:System.Drawing.Graphics.DrawPolygon%2A> メソッドは、\(30, 60\) から開始点 \(0, 0\) に戻る直線を描画することにより、多角形を自動的に閉じます。  
+  
+ [!code-csharp[LinesCurvesAndShapes#111](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#111)]
+ [!code-vb[LinesCurvesAndShapes#111](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#111)]  
+  
+ この多角形を次の図に示します。  
+  
+ ![多角形](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art08.png "Aboutgdip02\_art08")  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : ペンを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-pen.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/power-management-in-windows-forms.md b/docs/framework/winforms/advanced/power-management-in-windows-forms.md
new file mode 100644
index 00000000000..b53880a9c54
--- /dev/null
+++ b/docs/framework/winforms/advanced/power-management-in-windows-forms.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォームでの電源管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バッテリ状態"
+  - "電源状態"
+ms.assetid: ad04a801-5682-4d88-92c5-26eb9cdb209a
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Windows フォームでの電源管理
+Windows フォーム アプリケーションでは、Windows オペレーティング システムの電源管理機能を利用できます。  コンピューターの電源状態を監視し、状態が変化したときにアクションを実行できます。  たとえば、ポータブル コンピューターでアプリケーションを実行している場合、コンピューターの充電が一定レベルを下回ったときにアプリケーションの特定の機能を無効にできます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、オペレーティング システムを中断または再開したり、AC 電源やバッテリの状態が変化したりした場合など、電源状態が変化したときに発生する <xref:Microsoft.Win32.SystemEvents.PowerModeChanged> イベントを利用できます。  <xref:System.Windows.Forms.SystemInformation.PowerStatus%2A> クラスの <xref:System.Windows.Forms.SystemInformation> プロパティを使用すると、次のコード例に示すように現在の状態を照会できます。  
+  
+ [!code-csharp[PowerMode#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/powermode/cs/form1.cs#1)]
+ [!code-vb[PowerMode#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/powermode/vb/form1.vb#1)]  
+  
+ <xref:System.Windows.Forms.BatteryChargeStatus> 列挙値の他に、<xref:System.Windows.Forms.SystemInformation.PowerStatus%2A> プロパティにも、バッテリ容量 \(<xref:System.Windows.Forms.PowerStatus.BatteryFullLifetime%2A>\)、バッテリの充電率 \(<xref:System.Windows.Forms.PowerStatus.BatteryLifePercent%2A>、<xref:System.Windows.Forms.PowerStatus.BatteryLifeRemaining%2A>\) を確認する列挙値が含まれています。  
+  
+ <xref:System.Windows.Forms.Application> の <xref:System.Windows.Forms.Application.SetSuspendState%2A> メソッドを使用すると、コンピューターを休止モードまたは中断モードに設定できます。  `force` 引数を `false` に設定すると、中断のためのアクセス許可を要求するすべてのアプリケーションにイベントがブロードキャストされます。  また、`disableWakeEvent` 引数を `true` に設定すると、すべての wake イベントが無効になります。  
+  
+ 次のコード例は、コンピューターを休止モードに設定する方法を示しています。  
+  
+ [!code-csharp[PowerMode#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/powermode/cs/form1.cs#2)]
+ [!code-vb[PowerMode#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/powermode/vb/form1.vb#2)]  
+  
+## 参照  
+ <xref:Microsoft.Win32.SystemEvents.PowerModeChanged>   
+ <xref:System.Windows.Forms.SystemInformation.PowerStatus%2A>   
+ <xref:System.Windows.Forms.Application.SetSuspendState%2A>   
+ <xref:Microsoft.Win32.SystemEvents.SessionSwitch>
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/properties-on-windows-forms-controls-that-support-accessibility-guidelines.md b/docs/framework/winforms/advanced/properties-on-windows-forms-controls-that-support-accessibility-guidelines.md
new file mode 100644
index 00000000000..83dcc7b38a6
--- /dev/null
+++ b/docs/framework/winforms/advanced/properties-on-windows-forms-controls-that-support-accessibility-guidelines.md
@@ -0,0 +1,43 @@
+---
+title: "ユーザ補助ガイドラインをサポートする Windows フォーム コントロールのプロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセシビリティ, Windows フォーム コントロール プロパティ"
+  - "Windows フォーム, アクセシビリティ プロパティ (コントロールの)"
+ms.assetid: ad3567a6-313b-4708-9e15-f487a831f049
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# ユーザ補助ガイドラインをサポートする Windows フォーム コントロールのプロパティ
+Windows フォームの標準ツールボックス上のコントロールは、キーボード フォーカスの公開や画面要素の公開など、ユーザー補助ガイドラインの多くをサポートしています。  
+  
+## ユーザー補助の事前計画  
+ これらのコントロールのプロパティを使うと、次の表に示すように、他のユーザー補助ガイドラインをサポートできます。  また、プログラムの各機能にアクセスするメニューも使う必要があります。  
+  
+|コントロール プロパティ|ユーザー補助に関する考慮点|  
+|------------------|-------------------|  
+|AccessibleDescription|スクリーン リーダーなどのユーザー補助機能に対する説明が報告されます。  ユーザー補助機能とは、障碍を持つユーザーがコンピューターをより効果的に使用できるように特別に設計されたプログラムや装置です。|  
+|AccessibleName|ユーザー補助機能に対して報告される名前です。|  
+|AccessibleRole|ユーザー インターフェイスの要素の使用方法を記述します。|  
+|TabIndex|フォームでのフォーカスの移動順序を指定します。  固有のラベルを持たないコントロール \(テキスト ボックスなど\) では、関連するラベルがタブ オーダーで直前になるように配置する必要があります。|  
+|テキスト|"&" 文字を使用してアクセス キーを作成します。  アクセス キーの使い方は、機能へのキーボード アクセスの一部として公開されています。|  
+|Font Size|フォント サイズが調整できない場合は、10 ポイント以上に設定する必要があります。  フォームのフォント サイズが設定されると、それ以降、フォームに追加されるコントロールにはすべて同じフォント サイズが使用されます。|  
+|Forecolor|このプロパティが既定値に設定されると、フォーム上でユーザーの色設定が使用されます。|  
+|Backcolor|このプロパティが既定値に設定されると、フォーム上でユーザーの色設定が使用されます。|  
+|BackgroundImage|テキストが読みやすくなるように、このプロパティは空白のままにします。|  
+  
+## 参照  
+ [チュートリアル : ユーザー補助対応の Windows ベースのアプリケーションの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/recoloring-images.md b/docs/framework/winforms/advanced/recoloring-images.md
new file mode 100644
index 00000000000..daa3915df0e
--- /dev/null
+++ b/docs/framework/winforms/advanced/recoloring-images.md
@@ -0,0 +1,62 @@
+---
+title: "イメージの色の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], 色変更 (イメージを)"
+  - "イメージ [Windows フォーム], 色変更"
+  - "色変更 (イメージを)"
+ms.assetid: f28c54fd-9c80-4f6f-b242-55f7ffcda84b
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# イメージの色の変更
+色の変更とは、イメージの色を調整するプロセスのことです。  色を変更する例として、ある色から別の色へと変更する、別の色を基準にして色の輝度を相対的に調整する、すべての色の明るさやコントラストを調整する、色をグレー階調に変更する、などがあります。  
+  
+## このセクションの内容  
+ [方法 : カラー行列を使用して単一色を変換する](../../../../docs/framework/winforms/advanced/how-to-use-a-color-matrix-to-transform-a-single-color.md)  
+ カラー行列を使用して色を変換する方法を詳しく説明します。  
+  
+ [方法 : イメージの色を変換する](../../../../docs/framework/winforms/advanced/how-to-translate-image-colors.md)  
+ カラー行列を使用して色を変換する方法を示します。  
+  
+ [変換を使用した色のスケーリング](../../../../docs/framework/winforms/advanced/using-transformations-to-scale-colors.md)  
+ カラー行列を使用して色をスケーリングする方法を説明します。  
+  
+ [方法 : 色を回転させる](../../../../docs/framework/winforms/advanced/how-to-rotate-colors.md)  
+ カラー行列を使用して色を回転する方法を説明します。  
+  
+ [方法 : 色を傾斜する](../../../../docs/framework/winforms/advanced/how-to-shear-colors.md)  
+ 傾斜を定義し、カラー行列を使用して色を傾斜する方法について説明します。  
+  
+ [方法 : カラー リマップ テーブルを使用する](../../../../docs/framework/winforms/advanced/how-to-use-a-color-remap-table.md)  
+ リマップを定義し、カラー リマップ テーブルを使用する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Imaging.ColorMatrix>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Imaging.ColorMap>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)  
+ 各種のイメージに関するトピックの一覧を示します。  
+  
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)  
+ 各種のイメージを使用する方法を説明したトピックの一覧を示します。  
+  
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)  
+ マネージ グラフィックス クラスの使用方法を説明したトピックの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/regions-in-gdi.md b/docs/framework/winforms/advanced/regions-in-gdi.md
new file mode 100644
index 00000000000..dc23446bb1f
--- /dev/null
+++ b/docs/framework/winforms/advanced/regions-in-gdi.md
@@ -0,0 +1,51 @@
+---
+title: "GDI+ での領域 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画, 領域"
+  - "GDI+, 領域"
+  - "領域"
+ms.assetid: 52184f9b-16dd-4bbd-85be-029112644ceb
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# GDI+ での領域
+領域は、出力デバイスのディスプレイ範囲の一部です。  単純な領域 \(単一の四角形\) と複雑な領域 \(複数の多角形と閉じた曲線の組み合わせ\) があります。  四角形から構築された領域とパスから構築された領域を次の図に示します。  
+  
+ ![領域](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art27.png "AboutGdip02\_Art27")  
+  
+## 領域の使用  
+ 領域は、クリッピングとヒット テストに使用されることがよくあります。  クリッピングでは、ディスプレイ範囲の特定の領域 \(通常は更新が必要な部分\) だけに描画を制限します。  ヒット テストでは、マウス ボタンが押されたときにカーソルが画面上の特定の領域内にあるかどうかを判断します。  
+  
+ 四角形またはパスから領域を構築できます。  既存の領域を組み合わせて複雑な領域を作成することもできます。  <xref:System.Drawing.Region> クラスでは、領域を組み合わせるためのメソッドとして、<xref:System.Drawing.Region.Intersect%2A>、<xref:System.Drawing.Region.Union%2A>、<xref:System.Drawing.Region.Xor%2A>、<xref:System.Drawing.Region.Exclude%2A>、および <xref:System.Drawing.Region.Complement%2A> が用意されています。  
+  
+ 2 つの領域の積集合は、両方の領域に属しているすべての点の集合です。  和集合は、いずれか一方または両方の領域に属しているすべての点の集合です。  1 つの領域の補集合は、その領域に属していないすべての点の集合です。  上記の図にある 2 つの領域の積集合と和集合を次の図に示します。  
+  
+ ![領域](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art28.gif "AboutGdip02\_Art28")  
+  
+ <xref:System.Drawing.Region.Xor%2A> メソッドは、2 つの領域に対して適用され、いずれか一方の領域にだけ属しているすべての点を含む領域を生成します。  <xref:System.Drawing.Region.Exclude%2A> メソッドは、2 つの領域に対して適用され、1 番目の領域には属しているが 2 番目の領域には属していないすべての点を含む領域を生成します。  このトピックの最初に示した 2 つの領域に対して <xref:System.Drawing.Region.Xor%2A> メソッドと <xref:System.Drawing.Region.Exclude%2A> メソッドを適用して生成された領域を次の図に示します。  
+  
+ ![領域](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art29.gif "AboutGdip02\_Art29")  
+  
+ 領域を塗りつぶすには、<xref:System.Drawing.Graphics> オブジェクト、<xref:System.Drawing.Brush> オブジェクト、および <xref:System.Drawing.Region> オブジェクトが必要です。  <xref:System.Drawing.Graphics> オブジェクトには <xref:System.Drawing.Graphics.FillRegion%2A> メソッドが用意されており、<xref:System.Drawing.Brush> オブジェクトには色やパターンなど、塗りつぶしの属性が格納されます。  純色で領域を塗りつぶす例を次に示します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#61)]
+ [!code-vb[LinesCurvesAndShapes#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#61)]  
+  
+## 参照  
+ <xref:System.Drawing.Region?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [領域の使用](../../../../docs/framework/winforms/advanced/using-regions.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/restricting-the-drawing-surface-in-gdi.md b/docs/framework/winforms/advanced/restricting-the-drawing-surface-in-gdi.md
new file mode 100644
index 00000000000..b681cd2db73
--- /dev/null
+++ b/docs/framework/winforms/advanced/restricting-the-drawing-surface-in-gdi.md
@@ -0,0 +1,44 @@
+---
+title: "GDI+ での描画サーフェイスの制限 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "クリップする, 使用 (GDI+ を)"
+  - "GDI+, クリップする"
+  - "GDI+, 限定 (描画サーフェイスを)"
+ms.assetid: 8b5f71d9-d2f0-4540-9c41-740f90fd4c26
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# GDI+ での描画サーフェイスの制限
+クリッピングでは、特定の四角形または領域だけに描画を制限します。  文字列 "Hello" をハート形の領域に合わせてクリップした例を次の図に示します。  
+  
+ ![制限付き描画面](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art30.png "AboutGdip02\_Art30")  
+  
+## 領域のクリッピング  
+ 領域はパスから構築でき、パスは文字列のアウトラインを含むことができるため、テキストのアウトラインをクリッピングに使用できます。  複数の同心楕円をテキスト文字列の内部に合わせてクリップした例を次の図に示します。  
+  
+ ![制限付き描画面](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art31.png "AboutGdip02\_Art31")  
+  
+ クリッピングを使用して描画するには、<xref:System.Drawing.Graphics> オブジェクトを作成し、このオブジェクトの <xref:System.Drawing.Graphics.Clip%2A> プロパティを設定してから、同じ <xref:System.Drawing.Graphics> オブジェクトの描画メソッドを呼び出します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#91](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#91)]
+ [!code-vb[LinesCurvesAndShapes#91](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#91)]  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Region?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [領域の使用](../../../../docs/framework/winforms/advanced/using-regions.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/structure-of-the-graphics-interface.md b/docs/framework/winforms/advanced/structure-of-the-graphics-interface.md
new file mode 100644
index 00000000000..b9f63aa51fa
--- /dev/null
+++ b/docs/framework/winforms/advanced/structure-of-the-graphics-interface.md
@@ -0,0 +1,37 @@
+---
+title: "グラフィックス インターフェイスの構造体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, 使用 (マネージ インターフェイスを)"
+  - "グラフィックス, クラス構造"
+ms.assetid: 010a1e46-656b-40a1-8d5d-87aa05ee1243
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# グラフィックス インターフェイスの構造体
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] に対するマネージ クラス インターフェイスには、60 個のクラス、50 個の列挙体、および 8 個の構造体が含まれます。  <xref:System.Drawing.Graphics> クラスは、直線、曲線、図形、イメージ、およびテキストを実際に描画するクラスであり、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] 機能の中核としての役割を果たします。  
+  
+## 重要なクラス  
+ 多くのクラスが、この <xref:System.Drawing.Graphics> クラスと連動して機能します。  たとえば、<xref:System.Drawing.Graphics.DrawLine%2A> メソッドは、描画される線の属性 \(色、幅、破線スタイルなど\) を保持する <xref:System.Drawing.Pen> オブジェクトを受け取ります。  <xref:System.Drawing.Graphics.FillRectangle%2A> メソッドは <xref:System.Drawing.Drawing2D.LinearGradientBrush> オブジェクトへのポインターを受け取る場合がありますが、このオブジェクトは <xref:System.Drawing.Graphics> オブジェクトと連動し、グラデーション カラーで四角形を塗りつぶします。  <xref:System.Drawing.Font> オブジェクトと <xref:System.Drawing.StringFormat> オブジェクトは、<xref:System.Drawing.Graphics> オブジェクトによるテキストの描画方法を制御します。  <xref:System.Drawing.Drawing2D.Matrix> オブジェクトは、イメージの回転、スケーリング、および反転に使用される、<xref:System.Drawing.Graphics> オブジェクトのワールド変換を操作および格納します。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、グラフィックス データを編成するための構造体 \(<xref:System.Drawing.Rectangle>、<xref:System.Drawing.Point>、<xref:System.Drawing.Size> など\) もいくつか提供します。  また、構造化データ型として主に機能するクラスもあります。  たとえば、<xref:System.Drawing.Imaging.BitmapData> クラスは <xref:System.Drawing.Bitmap> クラスのヘルパーであり、<xref:System.Drawing.Drawing2D.PathData> クラスは <xref:System.Drawing.Drawing2D.GraphicsPath> クラスのヘルパーです。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、関連する複数の定数のコレクションであるいくつかの列挙体を定義します。  たとえば、<xref:System.Drawing.Drawing2D.LineJoin> 列挙体は、2 つの直線を接合するときに使用するスタイルを指定する <xref:System.Drawing.Drawing2D.LineJoin>、<xref:System.Drawing.Drawing2D.LineJoin>、<xref:System.Drawing.Drawing2D.LineJoin> の各要素を格納しています。  
+  
+## 参照  
+ [グラフィックスの概要](../../../../docs/framework/winforms/advanced/graphics-overview-windows-forms.md)   
+ [GDI\+ マネージ コードについて](../../../../docs/framework/winforms/advanced/about-gdi-managed-code.md)   
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/system-information-and-windows-forms.md b/docs/framework/winforms/advanced/system-information-and-windows-forms.md
new file mode 100644
index 00000000000..e90dcb49c6e
--- /dev/null
+++ b/docs/framework/winforms/advanced/system-information-and-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "システム情報と Windows フォーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドメイン名, 取得"
+  - "システム情報 [Windows フォーム]"
+  - "SystemInformation クラス [Windows フォーム]"
+  - "ユーザー名, 取得"
+ms.assetid: 30cf43a3-8cb2-4ff3-862b-6c34576616a8
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# システム情報と Windows フォーム
+コードにおいて何らかの決定を行うために、アプリケーションが実行されているコンピューターに関する情報を収集することが必要になる場合があります。  たとえば、特定のネットワーク ドメインに接続されているときだけ適用できる機能があるとします。この場合は、ドメインを識別し、ドメインが存在しない場合は機能を無効にする方法が必要になります。  
+  
+ Windows フォーム アプリケーションは、<xref:System.Windows.Forms.SystemInformation> クラスを使用して、実行時にコンピューターに関する各種の情報を取得できます。  次の例では、<xref:System.Windows.Forms.SystemInformation> クラスを使用して <xref:System.Windows.Forms.SystemInformation.UserName%2A> および <xref:System.Windows.Forms.SystemInformation.UserDomainName%2A> を取得する方法を示しています。  
+  
+```vb  
+Dim User As String = Windows.Forms.SystemInformation.UserName  
+Dim Domain As String = Windows.Forms.SystemInformation.UserDomainName  
+  
+MessageBox.Show("Good morning " & User & ". You are connected to " _  
+& Domain)  
+  
+```  
+  
+```csharp  
+string User = SystemInformation.UserName;  
+string Domain = SystemInformation.UserDomainName;  
+  
+MessageBox.Show("Good morning " + User + ". You are connected to " _  
++ Domain)  
+```  
+  
+ <xref:System.Windows.Forms.SystemInformation> クラスのすべてのメンバーは、読み取り専用です。ユーザーの設定を変更することはできません。  クラスには、コンピューターに接続されているモニターの数を返すもの \(<xref:System.Windows.Forms.SystemInformation.MonitorCount%2A>\) から、Windows エクスプローラーのアイコンの間隔を返すもの \(<xref:System.Windows.Forms.SystemInformation.IconHorizontalSpacing%2A> および <xref:System.Windows.Forms.SystemInformation.IconVerticalSpacing%2A>\) まで、100 を超えるメンバーがあります。  
+  
+ <xref:System.Windows.Forms.SystemInformation> クラスにおける有用なメンバーには、<xref:System.Windows.Forms.SystemInformation.ComputerName%2A>、<xref:System.Windows.Forms.SystemInformation.DbcsEnabled%2A>、<xref:System.Windows.Forms.SystemInformation.PowerStatus%2A>、および <xref:System.Windows.Forms.SystemInformation.TerminalServerSession%2A> があります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SystemInformation>   
+ [Windows フォームでの電源管理](../../../../docs/framework/winforms/advanced/power-management-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/three-categories-of-graphics-services.md b/docs/framework/winforms/advanced/three-categories-of-graphics-services.md
new file mode 100644
index 00000000000..7e97883dc31
--- /dev/null
+++ b/docs/framework/winforms/advanced/three-categories-of-graphics-services.md
@@ -0,0 +1,54 @@
+---
+title: "グラフィックス サービスの 3 つのカテゴリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "2 次元ベクター グラフィックス"
+  - "グラフィックス, カテゴリ"
+  - "イメージング"
+  - "タイポグラフィ"
+  - "ベクター グラフィックス"
+ms.assetid: 068c0ef3-f6ee-4d58-a7b6-eb2531ead408
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# グラフィックス サービスの 3 つのカテゴリ
+Windows フォームでのグラフィックスの提供は、大きく次の 3 つのカテゴリに分けられます。  
+  
+-   2 次元 \(2\-D\) ベクター グラフィックス  
+  
+-   イメージング  
+  
+-   タイポグラフィ  
+  
+## 2 次元ベクター グラフィックス  
+ 2 次元のベクター グラフィックスは、座標系内の一連の点で指定されるプリミティブ \(直線、曲線、図形など\) です。  たとえば、直線は 2 つの端点によって指定され、四角形は左上隅の位置を示す点と、幅および高さを定義する数値の組み合わせによって指定されます。  単純なパスは、直線で結ばれる複数の点の配列によって指定されます。  ベジエ スプラインは、4 つの制御点で指定される複雑な曲線です。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、プリミティブ自体の情報を格納するクラスおよび構造体、プリミティブの描画方法についての情報を格納するクラス、および実際に描画を実行するクラスを提供します。  たとえば、<xref:System.Drawing.Rectangle> 構造体には四角形の位置とサイズが格納されます。<xref:System.Drawing.Pen> クラスには、線の色、幅、およびスタイルに関する情報が格納されます。<xref:System.Drawing.Graphics> クラスには、直線、長方形、パス、およびその他の図形を描画するためのメソッドがあります。  また、いくつかの <xref:System.Drawing.Brush> クラスは、閉じられた図形およびパスを色またはパターンで塗りつぶす方法に関する情報を格納します。  
+  
+ ベクター イメージ \(複数のグラフィックス コマンドから成るシーケンス\) はメタファイルに記録できます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、メタファイルを記録、表示、および保存するための <xref:System.Drawing.Imaging.Metafile> クラスを提供します。  <xref:System.Drawing.Imaging.MetafileHeader> クラスと <xref:System.Drawing.Imaging.MetaHeader> クラスを使用すると、メタファイル ヘッダーに格納されているデータを調べることができます。  
+  
+## イメージング  
+ ベクター グラフィックスの手法では表示するのが難しい画像や、表示することができない画像もあります。  たとえば、ツール バー ボタンに表示される画像やアイコンとして表示される画像を直線と曲線の集合として指定するのは困難です。  混雑した野球場の高解像度デジタル写真をベクター手法で作成するのはさらに困難です。  このようなイメージは、画面上の各ドットの色を表す数値の配列であるビットマップとして格納されます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、ビットマップを表示、操作、および保存するための <xref:System.Drawing.Bitmap> クラスを提供します。  
+  
+## タイポグラフィ  
+ タイポグラフィは、さまざまなフォント、サイズ、およびスタイルでテキストを表示する機能です。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、この複雑なタスクをサポートするための広範なサポートが用意されています。  たとえば、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の新機能の 1 つであるサブピクセル アンチエイリアシングを使用すると、LCD 画面上により滑らかな輪郭のテキストを描画できます。  
+  
+ また、Windows フォームには、<xref:System.Windows.Forms.TextRenderer> クラスで [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] 機能を使用してテキストを描画するオプションも用意されています。  
+  
+## 参照  
+ [グラフィックスの概要](../../../../docs/framework/winforms/advanced/graphics-overview-windows-forms.md)   
+ [GDI\+ マネージ コードについて](../../../../docs/framework/winforms/advanced/about-gdi-managed-code.md)   
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/types-of-bitmaps.md b/docs/framework/winforms/advanced/types-of-bitmaps.md
new file mode 100644
index 00000000000..87791b5b0b6
--- /dev/null
+++ b/docs/framework/winforms/advanced/types-of-bitmaps.md
@@ -0,0 +1,102 @@
+---
+title: "ビットマップの種類 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - ".bmp ファイル"
+  - ".gif ファイル"
+  - ".jpeg ファイル"
+  - "ビットマップ [Windows フォーム], ファイル形式"
+  - "Exchangeable Image File"
+  - "EXIF ファイル形式"
+  - "gif ファイル"
+  - "グラフィックス [Windows フォーム], ファイル形式"
+  - "グラフィックス インターチェンジ (GIF) 形式"
+  - "イメージ [Windows フォーム], ファイル形式"
+  - "Joint Photographic Experts Group"
+  - "jpeg ファイル"
+  - "ピクチャ, ファイル形式"
+  - "PNG ファイル"
+  - "ポータブル ネットワーク グラフィックス (PNG)"
+  - "タグ イメージ (TIFF) 形式"
+  - "TIFF ファイル"
+ms.assetid: 6be085a2-2c13-47c8-b80a-c18b32777d8d
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ビットマップの種類
+ビットマップは、四角形のピクセル配列内での各ピクセルの色を指定するビット配列です。  各ピクセルで使用できるビット数により、そのピクセルに割り当てることができる色の数が決定します。  たとえば、各ピクセルが 4 ビットで表現される場合は、任意のピクセルに対して 16 色 \(2^4 \= 16\) のうちの 1 つを割り当てることができます。  指定したビット数で表現されるピクセルに対して割り当てることができる色の数の例を次の表に示します。  
+  
+|ピクセルあたりのビット数|ピクセルに割り当てることができる色の数|  
+|------------------|-------------------------|  
+|1|2^1 \= 2|  
+|2|2^2 \= 4|  
+|4|2^4 \= 16|  
+|8|2^8 \= 256|  
+|16|2^16 \= 65,536|  
+|24|2^24 \= 16,777,216|  
+  
+ 通常、ビットマップを格納するディスク ファイルには、ピクセルあたりのビット数、各行のピクセル数、配列内の行数などの情報を格納する 1 つ以上の情報ブロックがあります。  ビットマップ ファイルには、色テーブル \(カラー パレット\) も格納されることがあります。  色テーブルは、ビットマップ内の数値を特定の色に変換します。  拡大したイメージおよびそのビットマップと色テーブルを次の図に示します。  各ピクセルが 4 ビットの数値で表現されるため、色テーブルには 2^4 \= 16 色があります。  テーブル内の各色は、24 ビットの数値 \(赤が 8 ビット、緑が 8 ビット、青が 8 ビット\) で表現されます。  数値は 16 進数 \(基数 16\) 形式で示され、A \= 10、B \= 11、C \= 12、D \= 13、E \= 14、F \= 15 です。  
+  
+ ![ビットマップ サンプル](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art01.png "AboutGdip03\_Art01")  
+  
+ イメージの行 3、列 5 にあるピクセルに注目してください。  ビットマップ内で対応する数値は 1 です。  色テーブルによると 1 は赤に相当するため、このピクセルは赤になります。  ビットマップの一番上の行のエントリはすべて 3 です。  色テーブルによると 3 は青に相当するため、イメージの一番上の行のピクセルはすべて青になります。  
+  
+> [!NOTE]
+>  下から上の形式で格納されるビットマップの場合は、ビットマップの最初の行の数値がイメージの一番下の行のピクセルに対応します。  
+  
+ インデックスを色テーブルに格納するビットマップを "パレット インデックス付き" ビットマップと呼びます。  色テーブルが不要であるビットマップもあります。  たとえば、ピクセルあたり 24 ビットを使用するビットマップの場合は、インデックスを色テーブルに格納しなくても色を直接格納できます。  色テーブルを使用しないで色を直接 \(ピクセルあたり 24 ビット\) 格納するビットマップを次の図に示します。  この図には、ビットマップに対応するイメージを拡大した表示もあります。  このビットマップでは、FFFFFF は白に、FF0000 は赤に、00FF00 は緑に、0000FF は青に相当します。  
+  
+ ![ビットマップ サンプル](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art02.png "AboutGdip03\_Art02")  
+  
+## グラフィックス ファイル形式  
+ ビットマップをディスク ファイルに保存するための標準形式は多数あります。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、次に示すグラフィックス ファイル形式をサポートしています。  
+  
+### BMP  
+ BMP は、デバイスおよびアプリケーションに依存しないイメージを格納するために Windows で使用される標準形式です。  BMP ファイルのピクセルあたりのビット数 \(1、4、8、15、24、32、または 64\) は、ファイル ヘッダーで指定されます。  ピクセルあたり 24 ビットの BMP ファイルが一般的です。  通常、BMP ファイルは圧縮されないため、インターネット経由の転送には適していません。  
+  
+### GIF \(Graphics Interchange Format\)  
+ GIF は、Web ページ上に表示されるイメージの一般的な形式です。  GIF は、直線の描画、純色のブロックを使用したピクチャ、および色の間の境界が鮮明なピクチャの処理に適しています。  GIF は圧縮されますが、圧縮プロセスで情報が失われることはありません。圧縮解除されたイメージは、元のイメージとまったく同一です。  GIF 内の 1 つの色を透明に指定すると、イメージは、そのイメージを表示する任意の Web ページの背景色を持つことができます。  複数の GIF イメージのシーケンスを 1 つのファイルに格納して、GIF のアニメーションを作成できます。  GIF は、ピクセルあたり最大 8 ビットしか格納できないため、色の数は 256 色に制限されます。  
+  
+### JPEG \(Joint Photographic Experts Group\)  
+ JPEG は、スキャンされた写真など自然の光景の処理に適した圧縮スキームです。  圧縮プロセスで情報の一部が失われますが、多くの場合、情報の損失は人間の目では認識できません。  JPEG はピクセルあたり 24 ビットを格納するため、1,600 万色以上を表示できます。  JPEG は、透明の色やアニメーションをサポートしません。  
+  
+ JPEG イメージでは圧縮レベルを設定できますが、圧縮レベルを高くする \(ファイルを小さくする\) と、情報の損失が大きくなります。  通常、20:1 の圧縮比で生成されたイメージと元のイメージの違いは、人間の目ではほとんど認識できません。  1 つの BMP イメージおよびその BMP イメージから圧縮された 2 つの JPEG イメージを次の図に示します。  1 番目の JPEG の圧縮比は 4:1 で、2 番目の JPEG の圧縮比は約 8:1 です。  
+  
+ ![ファイルの種類サンプル](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art03.gif "AboutGdip03\_Art03")  
+  
+ JPEG の圧縮は、直線の描画、純色のブロック、および境界が鮮明なピクチャの処理には適していません。  1 つの BMP、2 つの JPEG、および 1 つの GIF を次の図に示します。  JPEG と GIF は、BMP から圧縮されたイメージです。  GIF の圧縮比は 4:1、小さい JPEG の圧縮比は 4:1、大きい JPEG の圧縮比は 8:3 です。  GIF では直線に沿って鮮明な境界が維持されていますが、JPEG では境界がぼやける傾向があります。  
+  
+ ![ファイルの種類](../../../../docs/framework/winforms/advanced/media/aboutgdip03-art03a.png "AboutGdip03\_Art03A")  
+  
+ JPEG は圧縮スキームであり、ファイル形式ではありません。  JPEG スキームに基づいて圧縮されたイメージを格納および転送するためのファイル形式として、JFIF \(JPEG File Interchange Format\) が一般的に使用されています。  Web ブラウザーで表示される JFIF ファイルは、.jpg 拡張子を使用します。  
+  
+### EXIF \(Exchangeable Image File\)  
+ EXIF は、デジタル カメラでキャプチャした写真のために使用されるファイル形式です。  EXIF ファイルには、JPEG 仕様に基づいて圧縮されたイメージが格納されます。  EXIF ファイルには、写真についての情報 \(撮影日付、シャッター速度、露出時間など\) およびカメラについての情報 \(メーカー、モデルなど\) も格納されます。  
+  
+### PNG \(Portable Network Graphics\)  
+ PNG 形式は、GIF 形式の利点の多くを提供するのに加えて、GIF にはない機能も提供します。  GIF ファイルと同様、PNG を圧縮しても情報は失われません。  PNG ファイルは、ピクセルあたり 8 ビット、24 ビット、または 48 ビットの色、およびピクセルあたり 1 ビット、2 ビット、4 ビット、8 ビット、または 16 ビットのグレースケールを格納できます。  これに対して、GIF ファイルはピクセルあたり 1 ビット、2 ビット、4 ビット、または 8 ビットだけを使用できます。  PNG ファイルは、各ピクセルの色と背景色のブレンドの程度を指定するために、ピクセルのアルファ値も格納できます。  
+  
+ PNG は、イメージを同時進行で表示できる点が GIF よりも優れています。つまり、ネットワーク接続経由でデータを受信するのと並行して、近似イメージの精度を上げながら表示できます。  PNG ファイルは、ガンマ補正情報と色補正情報を格納できるため、イメージをさまざまなディスプレイ デバイス上で正確にレンダリングできます。  
+  
+### TIFF \(Tag Image File Format\)  
+ TIFF は、さまざまなプラットフォームおよびイメージ処理アプリケーションで広くサポートされる、柔軟性と拡張性の高い形式です。  TIFF ファイルは、ピクセルあたり任意のビット数を持つイメージを格納でき、さまざまな圧縮アルゴリズムを使用できます。  いくつかのイメージを複数のページから成る単一の TIFF ファイルに格納できます。  イメージに関連する情報 \(スキャナーの種類、ホスト コンピューター、圧縮の種類、イメージの向き、ピクセルあたりのサンプル数など\) は、ファイルに格納でき、タグを使用して変更できます。  必要に応じて、新しいタグを承認および追加して、TIFF 形式を拡張できます。  
+  
+## 参照  
+ <xref:System.Drawing.Image?displayProperty=fullName>   
+ <xref:System.Drawing.Bitmap?displayProperty=fullName>   
+ <xref:System.Drawing.Imaging.PixelFormat?displayProperty=fullName>   
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/types-of-coordinate-systems.md b/docs/framework/winforms/advanced/types-of-coordinate-systems.md
new file mode 100644
index 00000000000..fe3cf46a421
--- /dev/null
+++ b/docs/framework/winforms/advanced/types-of-coordinate-systems.md
@@ -0,0 +1,105 @@
+---
+title: "座標系の種類 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "座標系"
+  - "デバイス座標系"
+  - "ページ座標系"
+  - "ページ変換"
+  - "変換, ページ"
+  - "変換, ワールド"
+  - "単位"
+  - "ワールド座標系"
+  - "ワールド変換"
+ms.assetid: c61ff50a-eb1d-4e6c-83cd-f7e9764cfa9f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 座標系の種類
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、ワールド座標空間、ページ座標空間、およびデバイス座標空間の 3 種類を使用します。  ワールド座標は、特定のグラフィック ワールドをモデル化するために使用する座標であり、.NET Framework でメソッドに渡す座標です。  ページ座標とは、フォームやコントロールなどの描画サーフェイスで使用される座標系です。  デバイス座標とは、画面や紙などの、描画が行われる物理デバイスで使用される座標です。  `myGraphics.DrawLine(myPen, 0, 0, 160, 80)` を呼び出す場合、<xref:System.Drawing.Graphics.DrawLine%2A> メソッドに渡す点 `(0, 0)` と `(160, 80)` は、ワールド座標空間内の点です。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] が画面上に直線を描画する前に、この座標に対して一連の変換処理が適用されます。  つまり、ワールド変換によってワールド座標がページ座標に変換され、次にページ変換によってページ座標がデバイス座標に変換されます。  
+  
+## 変換と座標系  
+ クライアント領域の左上隅ではなく内側に原点がある座標系を使用するとします。  たとえば、クライアント領域の左端から 100 ピクセル、上端から 50 ピクセルの点を原点にするとします。  この座標系を、次の図に示します。  
+  
+ ![座標系](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art01.png "AboutGdip05\_art01")  
+  
+ `myGraphics.DrawLine(myPen, 0, 0, 160, 80)` を呼び出すと、次の図に示す直線が描画されます。  
+  
+ ![座標系](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art02.png "AboutGdip05\_art02")  
+  
+ この直線の端点の座標は、3 つの座標空間では、それぞれ次のようになります。  
+  
+|||  
+|-|-|  
+|World|\(0, 0\) ～ \(160, 80\)|  
+|ページ|\(100, 50\) ～ \(260, 130\)|  
+|デバイス|\(100, 50\) ～ \(260, 130\)|  
+  
+ ページ座標空間の原点は、常にクライアント領域の左上隅です。  また、単位がピクセルであるため、デバイス座標はページ座標と同じになります。  単位をピクセル以外のインチなどに設定すると、デバイス座標はページ座標と異なる値になります。  
+  
+ ワールド座標からページ座標への変換をワールド変換と呼び、この変換は <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.Transform%2A> プロパティが保持します。  上の例のワールド変換は、x 方向に 100 単位、y 方向に 50 単位の平行移動です。  <xref:System.Drawing.Graphics> オブジェクトのワールド変換を設定し、その <xref:System.Drawing.Graphics> オブジェクトを使用して上の図に示す直線を描画する例を次に示します。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#31)]
+ [!code-vb[System.Drawing.CoordinateSystems#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#31)]  
+  
+ ページ座標からデバイス座標への変換をページ変換と呼びます。  <xref:System.Drawing.Graphics> クラスには、ページ変換を操作するための <xref:System.Drawing.Graphics.PageUnit%2A> プロパティと <xref:System.Drawing.Graphics.PageScale%2A> プロパティが用意されています。  <xref:System.Drawing.Graphics> クラスには、ディスプレイ デバイスの水平方向および垂直方向の dpi \(インチごとのドット数\) を調べるために、<xref:System.Drawing.Graphics.DpiX%2A> と <xref:System.Drawing.Graphics.DpiY%2A> の 2 つの読み取り専用プロパティも用意されています。  
+  
+ <xref:System.Drawing.Graphics> クラスの <xref:System.Drawing.Graphics.PageUnit%2A> プロパティを使用して、ピクセル以外の単位を指定できます。  
+  
+> [!NOTE]
+>  <xref:System.Drawing.Graphics.PageUnit%2A> プロパティを <xref:System.Drawing.GraphicsUnit> に設定することはできません。これは物理単位ではないため、例外が発生します。  
+  
+ \(0, 0\) から \(2, 1\) まで直線を描画する例を次に示します。ここで、点 \(2, 1\) は、点 \(0, 0\) から右に 2 インチ、下に 1 インチの位置にあります。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#32](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#32)]
+ [!code-vb[System.Drawing.CoordinateSystems#32](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#32)]  
+  
+> [!NOTE]
+>  ペンを構築するときにペン幅を指定しないと、上の例では 1 インチ幅の直線が描画されます。  ペンの幅は、次に示すように <xref:System.Drawing.Pen> コンストラクターの 2 番目の引数で指定できます。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#33](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#33)]
+ [!code-vb[System.Drawing.CoordinateSystems#33](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#33)]  
+  
+ ディスプレイ デバイスの dpi が水平方向で 96 ドット、垂直方向で 96 ドットであると仮定すると、上の例で示した直線の端点の座標は、3 つの座標空間では、それぞれ次のようになります。  
+  
+|||  
+|-|-|  
+|World|\(0, 0\) ～ \(2, 1\)|  
+|ページ|\(0, 0\) ～ \(2, 1\)|  
+|デバイス|\(0, 0\) ～ \(192, 96\)|  
+  
+ ワールド座標空間の原点はクライアント領域の左上隅であるため、ページ座標はワールド座標と同じになります。  
+  
+ さまざまな効果を得るために、ワールド変換とページ変換を組み合わせて実行できます。  たとえば、単位としてインチを使用し、座標系の原点として、クライアント領域の左端から 2 インチ、上端から 1\/2 インチの点を使用するとします。  <xref:System.Drawing.Graphics> オブジェクトのワールド変換とページ変換を設定し、\(0, 0\) から \(2, 1\) まで直線を描画する例を次に示します。  
+  
+ [!code-csharp[System.Drawing.CoordinateSystems#34](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/CS/Class1.cs#34)]
+ [!code-vb[System.Drawing.CoordinateSystems#34](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.CoordinateSystems/VB/Class1.vb#34)]  
+  
+ この直線と座標系を次の図に示します。  
+  
+ ![座標系](../../../../docs/framework/winforms/advanced/media/aboutgdip05-art03.png "AboutGdip05\_art03")  
+  
+ ディスプレイ デバイスの dpi が水平方向で 96 ドット、垂直方向で 96 ドットであると仮定すると、上の例で示した直線の端点の座標は、3 つの座標空間では、それぞれ次のようになります。  
+  
+|||  
+|-|-|  
+|World|\(0, 0\) ～ \(2, 1\)|  
+|ページ|\(2, 0.5\) ～ \(4, 1.5\)|  
+|デバイス|\(192, 48\) ～ \(384, 144\)|  
+  
+## 参照  
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)   
+ [変換の行列表現](../../../../docs/framework/winforms/advanced/matrix-representation-of-transformations.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md b/docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md
new file mode 100644
index 00000000000..d479c73636e
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md
@@ -0,0 +1,65 @@
+---
+title: "ブラシを使用した図形の塗りつぶし | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ブラシ"
+  - "例 [Windows フォーム], ブラシ"
+  - "形状, 塗りつぶし"
+ms.assetid: bf8f7fff-5a90-41e8-9051-494449fb2844
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ブラシを使用した図形の塗りつぶし
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] <xref:System.Drawing.Brush> オブジェクトは、閉じた形状の内側を塗りつぶすために使用します。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、純色、ハッチ パターン、イメージ テクスチャ、および色のグラデーションなど、いくつかの塗りつぶしスタイルが定義されています。  
+  
+## このセクションの内容  
+ [方法 : 純色で図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-solid-color.md)  
+ 純色のブラシを使用して形状を塗りつぶす方法を説明します。  
+  
+ [方法 : ハッチ パターンで図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-fill-a-shape-with-a-hatch-pattern.md)  
+ ハッチ ブラシを使用して形状を塗りつぶす方法を示します。  
+  
+ [方法 : イメージ テクスチャによって図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-fill-a-shape-with-an-image-texture.md)  
+ テクスチャ ブラシを使用して形状を塗りつぶす方法について説明します。  
+  
+ [方法 : イメージを並べたパターンによって図形を塗りつぶす](../../../../docs/framework/winforms/advanced/how-to-tile-a-shape-with-an-image.md)  
+ 形状内にイメージを並べて表示する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Brush?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.SolidBrush?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.TextureBrush?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Drawing2D.HatchBrush?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Drawing2D.PathGradientBrush?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [グラデーション ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md)  
+ グラデーション ブラシを使用する方法を説明したトピックの一覧を示します。  
+  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)  
+ アウトライン表示の形状を描画する方法を説明したトピックの一覧を示します。  
+  
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)  
+ マネージ グラフィックス クラスの使用方法を説明したトピックの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md b/docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md
new file mode 100644
index 00000000000..3645edbb487
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md
@@ -0,0 +1,49 @@
+---
+title: "グラデーション ブラシを使用した図形の塗りつぶし | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ブラシ, グラデーション ブラシ"
+  - "例 [Windows フォーム], グラデーション ブラシ"
+  - "グラデーション ブラシ"
+ms.assetid: 2c6037b9-05bd-44c0-a22a-19584b722524
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# グラデーション ブラシを使用した図形の塗りつぶし
+グラデーション ブラシを使用して、段階的に色を変化させて 1 つの図形を塗りつぶすことができます。  たとえば、水平方向のグラデーションを使用して、図形の左端から右端に移動するにつれて色が段階的に変化するように図形を塗りつぶすことができます。  左端が黒 \(赤、緑、青の各要素が \(0, 0, 0\) で表される\) で右端が赤 \(255, 0, 0\) の四角形があると想定します。  この四角形の幅が 256 ピクセルだとすると、あるピクセルの赤の要素は、その左側にあるピクセルの赤の要素よりも 1 大きい値になります。  一列に並んだピクセルの左端のピクセルの色要素は \(0, 0, 0\)、2 番目のピクセルは \(1, 0, 0\)、3 番目のピクセルは \(2, 0, 0\) となり、その後も同様に、色要素が \(255, 0, 0\) の右端のピクセルに達するまで続いていきます。  これらの補間色の値によって色のグラデーションが構成されます。  
+  
+ 線形グラデーションでは、水平方向、垂直方向、または指定した斜線と並行方向に移動するにつれて色が変化します。  パス グラデーションでは、パスの内側および境界周辺を移動するにつれて色が変化します。  パス グラデーションをカスタマイズして、さまざまな効果を得ることができます。  
+  
+ 線形グラデーション ブラシで塗りつぶした四角形と、パス グラデーション ブラシで塗りつぶした楕円を次の図に示します。  
+  
+ ![グラデーション](../../../../docs/framework/winforms/advanced/media/gradient2.png "gradient2")  
+  
+## このセクションの内容  
+ [方法 : 線形グラデーションを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-linear-gradient.md)  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush> クラスを使用して線形グラデーションを作成する方法を示します。  
+  
+ [方法 : パス グラデーションを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-path-gradient.md)  
+ <xref:System.Drawing.Drawing2D.PathGradientBrush> クラスを使用してパス グラデーションを作成する方法を説明します。  
+  
+ [方法 : グラデーションに対してガンマ補正を適用する](../../../../docs/framework/winforms/advanced/how-to-apply-gamma-correction-to-a-gradient.md)  
+ グラデーション ブラシでガンマ補正を使用する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Drawing2D.LinearGradientBrush?displayProperty=fullName>  
+ このクラスについて説明し、そのすべてのメンバーへのリンクを示します。  
+  
+ <xref:System.Drawing.Drawing2D.PathGradientBrush?displayProperty=fullName>  
+ このクラスについて説明し、そのすべてのメンバーへのリンクを示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md b/docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md
new file mode 100644
index 00000000000..871763387ee
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md
@@ -0,0 +1,53 @@
+---
+title: "ペンを使用した直線と図形の描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画"
+  - "例 [Windows フォーム], 描画 (線と形状を)"
+  - "例 [Windows フォーム], ペン"
+  - "ペン"
+ms.assetid: 8a7542ab-3e9e-443f-8405-2d6053528e20
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ペンを使用した直線と図形の描画
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の `Pen` オブジェクトを使用して、線分、曲線、および図形のアウトラインを描画します。  ここでの*線*は、特に線分だけを示すように指定されていない場合は、線分、曲線、および図形のアウトラインのすべてを指します。  ペンのプロパティを設定して、そのペンで描画した線の色、幅、配置、およびスタイルを制御できます。  
+  
+## このセクションの内容  
+ [方法 : ペンを使用して線を描画する](../../../../docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-lines.md)  
+ 線を描画する方法について説明します。  
+  
+ [方法 : ペンを使用して四角形を描画する](../../../../docs/framework/winforms/advanced/how-to-use-a-pen-to-draw-rectangles.md)  
+ 四角形を描画する方法について説明します。  
+  
+ [方法 : ペンの幅と配置を設定する](../../../../docs/framework/winforms/advanced/how-to-set-pen-width-and-alignment.md)  
+ `Pen` オブジェクトの幅と配置を変更する方法について説明します。  
+  
+ [方法 : ライン キャップを使用した直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-line-with-line-caps.md)  
+ 線を描画するとき、端点キャップを追加する方法について説明します。  
+  
+ [方法 : 直線を接合する](../../../../docs/framework/winforms/advanced/how-to-join-lines.md)  
+ 2 つの線を結合する方法について説明します。  
+  
+ [方法 : カスタム破線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-custom-dashed-line.md)  
+ 破線を描画する方法について説明します。  
+  
+ [方法 :テクスチャを使用して塗りつぶした直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-a-line-filled-with-a-texture.md)  
+ 図形をテクスチャで塗りつぶす方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Pen>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-application-settings-and-user-settings.md b/docs/framework/winforms/advanced/using-application-settings-and-user-settings.md
new file mode 100644
index 00000000000..3cbf6fcfa9f
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-application-settings-and-user-settings.md
@@ -0,0 +1,55 @@
+---
+title: "アプリケーション設定とユーザー設定の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション設定 [Windows フォーム], 方法トピック"
+  - "ユーザー設定 [Windows フォーム]"
+ms.assetid: 54682d3b-1cbf-4683-9351-012b8b4286b5
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# アプリケーション設定とユーザー設定の使用
+.NET Framework 2.0 以降、アプリケーションの実行セッション間で保持される値を作成してアクセスできます。  これらの値は、*設定*と呼ばれます。  設定は、ユーザー設定を表すことも、アプリケーションが使用する重要な情報を表すこともできます。  たとえば、アプリケーションの配色に対するユーザー設定を格納する一連の設定を作成できます。  または、アプリケーションが使用するデータベースを指定する接続文字列を格納できます。  設定を使用すると、アプリケーションにとって重要な情報のコード外での保持と、個々のユーザーのユーザー設定を保存するプロファイルの作成の両方を実行できます。  
+  
+ このセクションのトピックでは、設計時と実行時の設定の使用方法について説明します。  
+  
+## このセクションの内容  
+ [方法 : 設計時に新しい設定を作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-new-setting-at-design-time.md)  
+  
+ Visual Studio を使用してアプリケーションの新しい設定を作成する方法について説明します。  
+  
+ [方法 : 設計時に既存の設定の値を変更する](../../../../docs/framework/winforms/advanced/how-to-change-the-value-of-an-existing-setting-at-design-time.md)  
+  
+ Visual Studio を使用して既存の設定の値を変更する方法について説明します。  
+  
+ [方法 : アプリケーション セッション間で設定値を変更する](../../../../docs/framework/winforms/advanced/how-to-change-the-value-of-a-setting-between-application-sessions.md)  
+  
+ コンパイル済みのアプリケーションの設定値を、アプリケーション セッション間で変更する方法について説明します。  
+  
+ [方法 : 実行時に設定を C\# で読み取る](../../../../docs/framework/winforms/advanced/how-to-read-settings-at-run-time-with-csharp.md)  
+  
+ コードを使用して C\# の設定を読み取る方法について説明します。  
+  
+ [方法 : 実行時にユーザー設定を C\# で書き込む](../../../../docs/framework/winforms/advanced/how-to-write-user-settings-at-run-time-with-csharp.md)  
+  
+ コードを使用して C\# のユーザー設定に値を書き込んで保存する方法について説明します。  
+  
+ [方法 : C\# のアプリケーションに複数の設定セットを追加する](../../../../docs/framework/winforms/advanced/how-to-add-multiple-sets-of-settings-to-your-application-in-csharp.md)  
+  
+ C\# のアプリケーションに複数の設定セットを追加する方法について説明します。  
+  
+## 参照  
+ [Windows フォームのアプリケーション設定](../../../../docs/framework/winforms/advanced/application-settings-for-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-double-buffering.md b/docs/framework/winforms/advanced/using-double-buffering.md
new file mode 100644
index 00000000000..6a6f230574c
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-double-buffering.md
@@ -0,0 +1,50 @@
+---
+title: "ダブル バッファリングの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バッファリング, ダブル バッファリング"
+  - "ダブル バッファリング"
+  - "ちらつき, 低減 (Windows フォーム内の)"
+  - "グラフィックス, ダブル バッファリング"
+ms.assetid: dc484e33-7101-4e4b-ada5-d3c96155fbcd
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ダブル バッファリングの使用
+グラフィックスにダブル バッファリングを使用すると、複雑な描画操作を必要とするアプリケーションでちらつきを抑えることができます。  .NET Framework にはダブル バッファリングのサポートが組み込まれています。または、グラフィックスを手動で管理して描画することも可能です。  
+  
+## このセクションの内容  
+ [ダブル バッファリングされたグラフィックス](../../../../docs/framework/winforms/advanced/double-buffered-graphics.md)  
+ ダブル バッファリングの概要を紹介し、.NET Framework によるサポートについて大まかに説明します。  
+  
+ [方法 : フォームとコントロールのダブル バッファリングを行うことによってグラフィックスのちらつきを軽減する](../../../../docs/framework/winforms/advanced/how-to-reduce-graphics-flicker-with-double-buffering-for-forms-and-controls.md)  
+ .NET Framework でサポートされる既定のダブル バッファリングの使用方法について説明します。  
+  
+ [方法 : バッファリングされたグラフィックスを手動で管理する](../../../../docs/framework/winforms/advanced/how-to-manually-manage-buffered-graphics.md)  
+ アプリケーションでダブル バッファリングを管理する方法について説明します。  
+  
+ [方法 : バッファリングされたグラフィックスを手動で描画する](../../../../docs/framework/winforms/advanced/how-to-manually-render-buffered-graphics.md)  
+ ダブル バッファリングを使用してグラフィックスを描画する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Control.SetStyle%2A> ,  
+ ダブル バッファリングを可能にするメソッドを制御します。  
+  
+ <xref:System.Drawing.BufferedGraphicsContext> ,  
+ グラフィックスのバッファーを作成するメソッドを提供します。  
+  
+ <xref:System.Drawing.BufferedGraphicsManager>  
+ バッファーに格納されたグラフィックス コンテキストへのアクセスをアプリケーション ドメインに提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-fonts-and-text.md b/docs/framework/winforms/advanced/using-fonts-and-text.md
new file mode 100644
index 00000000000..eb2ccd18efb
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-fonts-and-text.md
@@ -0,0 +1,78 @@
+---
+title: "フォントとテキストの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], フォントとテキスト"
+  - "フォント, 使用 (Windows フォームで)"
+  - "GDI, 描画 (テキストを) [Windows フォーム]"
+  - "文字列 [Windows フォーム], 描画 (Windows フォームで)"
+  - "テキスト [Windows フォーム], 描画 (Windows フォームで)"
+ms.assetid: d43640f3-da94-4df2-a29d-a9d021a1c069
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# フォントとテキストの使用
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] と [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] には、Windows フォームでテキストを描画するためのクラスがいくつか用意されています。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の <xref:System.Drawing.Graphics> クラスにはいくつかの <xref:System.Drawing.Graphics.DrawString%2A> メソッドがあり、これらのメソッドを使用して、テキストの位置、外接する四角形、フォント、書式などのさまざまな特徴を指定できます。  また、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] では `TextRenderer` クラスの <xref:System.Windows.Forms.TextRenderer.DrawText%2A> と <xref:System.Windows.Forms.TextRenderer.MeasureText%2A> の静的メソッドを使用して、テキストの描画と寸法計測ができます。  [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] のメソッドを使用して、位置、フォント、および書式を指定することも可能です。  テキストの描画には [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] または [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を選択できますが、一般に [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] の方がパフォーマンスが高く、テキストの寸法計測も正確です。  この他にも、テキストの描画には `FontFamily`、`Font`、<xref:System.Drawing.StringFormat>、および `TextFormatFlags` などが使用されます。  
+  
+## このセクションの内容  
+ [方法 : フォント ファミリとフォントを作成する](../../../../docs/framework/winforms/advanced/how-to-construct-font-families-and-fonts.md)  
+ `Font` オブジェクトと `FontFamily` オブジェクトの作成方法について説明します。  
+  
+ [方法 : テキストを指定の位置に描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-at-a-specified-location.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] と [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] を使用して、テキストを特定の位置に描画する方法について説明します。  
+  
+ [方法 : 四角形内にテキストを折り返して描画する](../../../../docs/framework/winforms/advanced/how-to-draw-wrapped-text-in-a-rectangle.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] と [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] を使用して、テキストを四角形内に描画する方法について説明します。  
+  
+ [方法 : GDI を使用してテキストを描画する](../../../../docs/framework/winforms/advanced/how-to-draw-text-with-gdi.md)  
+ [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] によるテキストの描画方法について説明します。  
+  
+ [方法 : 描画テキストを配置する](../../../../docs/framework/winforms/advanced/how-to-align-drawn-text.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] と [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] でのテキストの書式設定の方法について説明します。  
+  
+ [方法 : 垂直方向のテキストを作成する](../../../../docs/framework/winforms/advanced/how-to-create-vertical-text.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] でテキストを垂直方向に配置して描画する方法について説明します。  
+  
+ [方法 : 描画されたテキストにタブ ストップを設定する](../../../../docs/framework/winforms/advanced/how-to-set-tab-stops-in-drawn-text.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] で、テキストにタブ ストップを設定して描画する方法について説明します。  
+  
+ [方法 : インストールされているフォントを列挙する](../../../../docs/framework/winforms/advanced/how-to-enumerate-installed-fonts.md)  
+ インストール済みのフォントの名前を一覧表示する方法について説明します。  
+  
+ [方法 : プライベート フォント コレクションを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-private-font-collection.md)  
+ <xref:System.Drawing.Text.PrivateFontCollection> オブジェクトの作成方法について説明します。  
+  
+ [方法 : フォント メトリックを取得する](../../../../docs/framework/winforms/advanced/how-to-obtain-font-metrics.md)  
+ セルのアセントやディセントなどのフォント メトリックを取得する方法について説明します。  
+  
+ [方法 : テキストでのアンチエイリアシングの使用](../../../../docs/framework/winforms/advanced/how-to-use-antialiasing-with-text.md)  
+ テキストの描画にアンチエイリアシングを使用する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Font>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.FontFamily>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Text.PrivateFontCollection>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.TextRenderer>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.TextFormatFlags>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-graphics-containers.md b/docs/framework/winforms/advanced/using-graphics-containers.md
new file mode 100644
index 00000000000..e4bad937749
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-graphics-containers.md
@@ -0,0 +1,37 @@
+---
+title: "グラフィックス コンテナーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], グラフィックス コンテナー"
+  - "グラフィックス コンテナー"
+  - "グラフィックス, 使用 (コンテナーを)"
+ms.assetid: 74632f91-cefa-4f51-ab7c-f9ac91942caf
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# グラフィックス コンテナーの使用
+ベクター イメージ、ラスター イメージ、およびテキストを表示するために、<xref:System.Drawing.Graphics> オブジェクトには <xref:System.Drawing.Graphics.DrawLine%2A>、<xref:System.Drawing.Graphics.DrawImage%2A>、<xref:System.Drawing.Graphics.DrawString%2A> などのメソッドが用意されています。  <xref:System.Drawing.Graphics> オブジェクトは、描画される項目の画質や方向に影響を与える複数のプロパティも保持しています。  たとえば、スムージング モード プロパティは直線や曲線に対してアンチエイリアシングが適用されるかどうかを指定し、ワールド変換プロパティは描画対象項目の位置および回転に影響を与えます。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトは、特定のディスプレイ デバイスに関連付けられています。  <xref:System.Drawing.Graphics> オブジェクトを使用してウィンドウ内で描画を行うと、その <xref:System.Drawing.Graphics> オブジェクトはそのウィンドウに関連付けられます。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトは、描画に影響を与える一連のプロパティを保持し、デバイス固有の情報にリンクされるため、コンテナーとして考えることができます。  既存の <xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.BeginContainer%2A> メソッドを呼び出すことによって、その <xref:System.Drawing.Graphics> オブジェクト内に第 2 のコンテナーを作成できます。  
+  
+## このセクションの内容  
+ [Graphics オブジェクトの状態の管理](../../../../docs/framework/winforms/advanced/managing-the-state-of-a-graphics-object.md)  
+ <xref:System.Drawing.Graphics> オブジェクトの画質設定、クリッピング領域、および変換を管理する方法について説明します。  
+  
+ [入れ子になっているグラフィックス コンテナーの使用](../../../../docs/framework/winforms/advanced/using-nested-graphics-containers.md)  
+ コンテナーを使用して <xref:System.Drawing.Graphics> オブジェクトの状態を制御する方法を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md b/docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md
new file mode 100644
index 00000000000..5a1e5229a30
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md
@@ -0,0 +1,79 @@
+---
+title: "マネージ GDI+ でのイメージ エンコーダーおよびイメージ デコーダーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ デコーダー, 使用"
+  - "イメージ エンコーダー, 使用"
+ms.assetid: 0e838ea1-4e7e-4334-b882-ab25df607b8b
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# マネージ GDI+ でのイメージ エンコーダーおよびイメージ デコーダーの使用
+<xref:System.Drawing> 名前空間は、イメージの格納および操作のための <xref:System.Drawing.Image> クラスおよび <xref:System.Drawing.Bitmap> クラスを提供します。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] でイメージ エンコーダーを使用すると、メモリからディスクにイメージを書き込むことができます。[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] でイメージ デコーダーを使用すると、ディスクからメモリにイメージを読み込むことができます。  エンコーダーは、<xref:System.Drawing.Image> オブジェクトまたは <xref:System.Drawing.Bitmap> オブジェクトのデータを指定のディスク ファイル形式に変換します。  デコーダーは、ディスク ファイルのデータを <xref:System.Drawing.Image> オブジェクトおよび <xref:System.Drawing.Bitmap> オブジェクトで必要とされる形式に変換します。  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、次のファイルの種類をサポートするエンコーダーおよびデコーダーが組み込まれています。  
+  
+-   BMP  
+  
+-   GIF  
+  
+-   JPEG  
+  
+-   PNG  
+  
+-   TIFF  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、次のファイルの種類をサポートするデコーダーも組み込まれています。  
+  
+-   WMF  
+  
+-   EMF  
+  
+-   ICON  
+  
+ 以下のトピックでは、エンコーダーとデコーダーについて詳細に説明します。  
+  
+## このセクションの内容  
+ [方法 : インストールされたエンコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-encoders.md)  
+ コンピューター上で使用できるエンコーダーを一覧表示する方法について説明します。  
+  
+ [方法 : インストールされたデコーダーの一覧](../../../../docs/framework/winforms/advanced/how-to-list-installed-decoders.md)  
+ コンピューター上で使用できるデコーダーを一覧表示する方法について説明します。  
+  
+ [方法 : エンコーダーがサポートするパラメーターの確認](../../../../docs/framework/winforms/advanced/how-to-determine-the-parameters-supported-by-an-encoder.md)  
+ エンコーダーがサポートする <xref:System.Drawing.Imaging.EncoderParameters> を一覧表示する方法について説明します。  
+  
+ [方法 : BMP イメージから PNG イメージへの変換](../../../../docs/framework/winforms/advanced/how-to-convert-a-bmp-image-to-a-png-image.md)  
+ さまざまなイメージ形式でイメージを保存する方法について説明します。  
+  
+ [方法 : JPEG 圧縮レベルの設定](../../../../docs/framework/winforms/advanced/how-to-set-jpeg-compression-level.md)  
+ イメージの品質レベルを変更する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Image>  
+  
+ <xref:System.Drawing.Bitmap>  
+  
+ <xref:System.Drawing.Imaging.ImageCodecInfo>  
+  
+ <xref:System.Drawing.Imaging.EncoderParameter>  
+  
+ <xref:System.Drawing.Imaging.Encoder>  
+  
+## 関連項目  
+ [GDI\+ マネージ コードについて](../../../../docs/framework/winforms/advanced/about-gdi-managed-code.md)  
+  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-managed-graphics-classes.md b/docs/framework/winforms/advanced/using-managed-graphics-classes.md
new file mode 100644
index 00000000000..592a3a77dcc
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-managed-graphics-classes.md
@@ -0,0 +1,72 @@
+---
+title: "マネージ グラフィックス クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GDI+, マネージ クラス"
+  - "グラフィックス, マネージ クラス"
+  - "グラフィックス, 使用 (Windows フォームで)"
+ms.assetid: e6d1a42d-2100-46aa-97e6-a5ddc0baaae5
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# マネージ グラフィックス クラスの使用
+以下のトピックでは、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] API をマネージ クラス フレームワーク内で使用する方法について説明します。  
+  
+## このセクションの内容  
+ [グラフィックス プログラミングについて](../../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して基本的なタスクを実行する方法について説明します。  
+  
+ [ペンを使用した直線と図形の描画](../../../../docs/framework/winforms/advanced/using-a-pen-to-draw-lines-and-shapes.md)  
+ ペンを作成し、それを使用してさまざまな線や図形を描画する方法について説明します。  
+  
+ [ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-brush-to-fill-shapes.md)  
+ ブラシを作成し、さまざまな効果を使用して図形を塗りつぶす方法について説明します。  
+  
+ [グラデーション ブラシを使用した図形の塗りつぶし](../../../../docs/framework/winforms/advanced/using-a-gradient-brush-to-fill-shapes.md)  
+ 各種グラデーション ブラシの作成方法、および使用方法について説明します。  
+  
+ [イメージ、ビットマップ、アイコン、およびメタファイルの操作](../../../../docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md)  
+ イメージの作成および操作の方法について説明します。  
+  
+ [アルファ ブレンドの直線と塗りつぶし](../../../../docs/framework/winforms/advanced/alpha-blending-lines-and-fills.md)  
+ 図形や線に透過性を設定する方法について説明します。  
+  
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)  
+ テキストの描画と、フォントとフォント ファミリを使用する方法について説明します。  
+  
+ [曲線の作成と描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-curves.md)  
+ カーディナル スプラインとベジエ スプラインを描画する方法について説明します。  
+  
+ [パスの作成および描画](../../../../docs/framework/winforms/advanced/constructing-and-drawing-paths.md)  
+ パスを使用して図形を作成する方法について説明します。  
+  
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)  
+ 行列変換について説明します。  
+  
+ [グラフィックス コンテナーの使用](../../../../docs/framework/winforms/advanced/using-graphics-containers.md)  
+ グラフィックス オブジェクトの状態と、入れ子になったグラフィックス コンテナーを管理する方法について説明します。  
+  
+ [領域の使用](../../../../docs/framework/winforms/advanced/using-regions.md)  
+ 領域のヒット テストとクリッピングについて説明します。  
+  
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)  
+ 色の操作におけるさまざまな要素について説明します。  
+  
+ [マネージ GDI\+ でのイメージ エンコーダーおよびイメージ デコーダーの使用](../../../../docs/framework/winforms/advanced/using-image-encoders-and-decoders-in-managed-gdi.md)  
+ イメージ エンコーダーおよびイメージ デコーダーを使用してイメージを操作する方法について説明します。  
+  
+ [ダブル バッファリングされたグラフィックス](../../../../docs/framework/winforms/advanced/double-buffered-graphics.md)  
+ ダブル バッファリングを使用してちらつきを抑える方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-nested-graphics-containers.md b/docs/framework/winforms/advanced/using-nested-graphics-containers.md
new file mode 100644
index 00000000000..c9e2e3f994f
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-nested-graphics-containers.md
@@ -0,0 +1,67 @@
+---
+title: "入れ子になっているグラフィックス コンテナーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス [Windows フォーム], クリップする"
+  - "グラフィックス, 入れ子になっているコンテナー"
+  - "グラフィックス, 変換 (入れ子になっているオブジェクトの)"
+ms.assetid: a0d9f178-43a4-4323-bb5a-d3e3f77ae6c1
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 入れ子になっているグラフィックス コンテナーの使用
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] には、<xref:System.Drawing.Graphics> オブジェクトの状態の一部を一時的に置換または増加するために使用できるコンテナーが用意されています。  コンテナーを作成するには、<xref:System.Drawing.Graphics> オブジェクトの <xref:System.Drawing.Graphics.BeginContainer%2A> メソッドを呼び出します。  <xref:System.Drawing.Graphics.BeginContainer%2A> を繰り返し呼び出すことで、入れ子になったコンテナーを形成できます。  <xref:System.Drawing.Graphics.EndContainer%2A> に対する各呼び出しは、<xref:System.Drawing.Graphics.BeginContainer%2A> と対になっている必要があります。  
+  
+## 入れ子になっているコンテナーでの変換  
+ <xref:System.Drawing.Graphics> オブジェクトを作成し、その <xref:System.Drawing.Graphics> オブジェクト内にコンテナーを作成する例を次に示します。  <xref:System.Drawing.Graphics> オブジェクトのワールド変換は、x 方向に 100 単位、y 方向に 80 単位の平行移動です。  コンテナーのワールド変換は、30°の回転です。  このコードでは、 `DrawRectangle(pen, -60, -30, 120, 60)`  の呼び出しが 2 回行われます。  <xref:System.Drawing.Graphics.DrawRectangle%2A> の最初の呼び出しはコンテナーの内側で行われます。つまり、この呼び出しは、<xref:System.Drawing.Graphics.BeginContainer%2A> が呼び出されてから <xref:System.Drawing.Graphics.EndContainer%2A> が呼び出されるまでの間に行われます。  <xref:System.Drawing.Graphics.DrawRectangle%2A> の 2 回目の呼び出しは、<xref:System.Drawing.Graphics.EndContainer%2A> を呼び出した後に行われます。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#61)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#61)]  
+  
+ 上のコードでは、コンテナーの内側から描画された四角形は、まずコンテナーのワールド変換 \(回転\) によって変換され、次に <xref:System.Drawing.Graphics> オブジェクトのワールド変換 \(平行移動\) によって変換されます。  コンテナーの外側から描画された四角形は、<xref:System.Drawing.Graphics> オブジェクトのワールド変換 \(平行移動\) だけによって変換されます。  これら 2 つの四角形を次の図に示します。  
+  
+ ![入れ子のコンテナー](../../../../docs/framework/winforms/advanced/media/csnestedcontainers1.png "csnestedcontainers1")  
+  
+## 入れ子になっているコンテナーでのクリッピング  
+ 入れ子になっているコンテナーがクリッピング領域を処理するようすを次の例に示します。  このコードは、<xref:System.Drawing.Graphics> オブジェクトを作成し、その <xref:System.Drawing.Graphics> オブジェクト内にコンテナーを作成します。  <xref:System.Drawing.Graphics> オブジェクトのクリッピング領域は四角形で、コンテナーのクリッピング領域は楕円です。  このコードは、<xref:System.Drawing.Graphics.DrawLine%2A> メソッドを 2 回呼び出します。  <xref:System.Drawing.Graphics.DrawLine%2A> の最初の呼び出しはコンテナーの内部で行われ、<xref:System.Drawing.Graphics.DrawLine%2A> の 2 回目の呼び出しはコンテナーの外側で、<xref:System.Drawing.Graphics.EndContainer%2A> の呼び出しの後に行われます。  最初の直線は、2 つのクリッピング領域の交差部分でクリップされます。  2 番目の直線は、<xref:System.Drawing.Graphics> オブジェクトの四角形のクリッピング領域だけによってクリップされます。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#62](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#62)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#62](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#62)]  
+  
+ クリップされた 2 つの直線を次の図に示します。  
+  
+ ![入れ子のコンテナー](../../../../docs/framework/winforms/advanced/media/nestedcontainers2.png "nestedcontainers2")  
+  
+ 上の 2 つの例が示すように、変換およびクリッピング領域は入れ子になっているコンテナー内では累積されます。  コンテナーおよび <xref:System.Drawing.Graphics> オブジェクトのワールド変換を設定すると、コンテナーの内側から描画された項目に対しては両方の変換が適用されます。  この場合、最初にコンテナーの変換が適用され、次に <xref:System.Drawing.Graphics> オブジェクトの変換が適用されます。  コンテナーおよび <xref:System.Drawing.Graphics> オブジェクトのクリッピング領域を設定すると、コンテナーの内側から描画された項目は、2 つのクリッピング領域の交差部分でクリップされます。  
+  
+## 入れ子になっているコンテナーでの画質設定  
+ 入れ子になっているコンテナーでの画質の設定 \(<xref:System.Drawing.Graphics.SmoothingMode%2A>, <xref:System.Drawing.Graphics.TextRenderingHint%2A> など\) は累積されず、コンテナーの画質設定によって <xref:System.Drawing.Graphics> オブジェクトの画質設定が一時的に置き換えられます。  コンテナーを新規作成するときに、そのコンテナーの画質設定は既定値に設定されます。  たとえば、スムージング モードが <xref:System.Drawing.Drawing2D.SmoothingMode> の <xref:System.Drawing.Graphics> オブジェクトがあるとします。  コンテナーを作成する場合、そのコンテナー内のスムージング モードは既定のスムージング モードになります。  コンテナーのスムージング モードは自由に設定でき、そのコンテナーの内側から描画される全項目は、設定されているモードに基づいて描画されます。  <xref:System.Drawing.Graphics.EndContainer%2A> を呼び出した後で描画される項目は、<xref:System.Drawing.Graphics.BeginContainer%2A> を呼び出す前に有効だったスムージング モード \(<xref:System.Drawing.Drawing2D.SmoothingMode>\) に基づいて描画されます。  
+  
+## 入れ子になっている複数層のコンテナー  
+ 1 つの <xref:System.Drawing.Graphics> オブジェクト内に作成できるコンテナー数は 1 つに限定されているわけではありません。  各コンテナーが前のコンテナーの入れ子になっている一連のコンテナーを作成でき、入れ子になっているコンテナーごとにワールド変換、クリッピング領域、および画質設定を指定できます。  最も内側のコンテナーから描画メソッドを呼び出す場合は、最も内側のコンテナーから始まり最も外側のコンテナーで終了するという順序で、変換が適用されます。  最も内側のコンテナーの内側から描画された項目は、すべてのクリッピング領域の交差部分でクリップされます。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトを作成し、そのテキストの画質を指定する属性として <xref:System.Drawing.Drawing2D.SmoothingMode> を設定する例を次に示します。  このコードは、1 つのコンテナーがもう 1 つのコンテナー内に入れ子になっている 2 つのコンテナーを作成します。  外側のコンテナーのテキストの画質を指定する属性は <xref:System.Drawing.Text.TextRenderingHint> に、内側のコンテナーのテキストの画質を指定する属性は <xref:System.Drawing.Drawing2D.SmoothingMode> に設定されます。  このコードは、3 つの文字列を描画します。1 つは内側のコンテナーからの文字列、1 つは外側のコンテナーからの文字列、もう 1 つは <xref:System.Drawing.Graphics> オブジェクト自体からの文字列です。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#63](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#63)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#63](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#63)]  
+  
+ これらの 3 つの文字列を次の図に示します。  内側のコンテナーおよび <xref:System.Drawing.Graphics> オブジェクトから描画された文字列は、アンチエイリアシングによって滑らかになっています。  外側のコンテナーから描画された文字列はアンチエイリアシングによって滑らかになってはいません。これは、<xref:System.Drawing.Graphics.TextRenderingHint%2A> プロパティが <xref:System.Drawing.Text.TextRenderingHint> に設定されているためです。  
+  
+ ![入れ子のコンテナー](../../../../docs/framework/winforms/advanced/media/nestedcontainers3.png "nestedcontainers3")  
+  
+## 参照  
+ <xref:System.Drawing.Graphics>   
+ [Graphics オブジェクトの状態の管理](../../../../docs/framework/winforms/advanced/managing-the-state-of-a-graphics-object.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-regions.md b/docs/framework/winforms/advanced/using-regions.md
new file mode 100644
index 00000000000..889bc4908fc
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-regions.md
@@ -0,0 +1,41 @@
+---
+title: "領域の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], 領域"
+  - "領域, 使用"
+ms.assetid: 7809295b-870f-4107-a8b5-8386c298acd5
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 領域の使用
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の <xref:System.Drawing.Region> クラスでは、カスタム図形を定義できます。  この図形は、直線、多角形、および曲線から構成できます。  
+  
+ 領域の一般的な使用方法としては、ヒット テストおよびクリッピングがあります。  ヒット テストは、画面上の特定の領域でマウスがクリックされたかどうかを確認します。  クリッピングは、描画範囲を特定の領域だけに限定します。  
+  
+## このセクションの内容  
+ [方法 : 領域でヒット テストを使用する](../../../../docs/framework/winforms/advanced/how-to-use-hit-testing-with-a-region.md)  
+ <xref:System.Drawing.Region> を使用してヒット テストを実行する方法を示します。  
+  
+ [方法 : 領域でクリッピングを使用する](../../../../docs/framework/winforms/advanced/how-to-use-clipping-with-a-region.md)  
+ <xref:System.Drawing.Graphics> オブジェクトに対してクリッピング領域を設定する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Region>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Graphics>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-the-world-transformation.md b/docs/framework/winforms/advanced/using-the-world-transformation.md
new file mode 100644
index 00000000000..3fafb7ff682
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-the-world-transformation.md
@@ -0,0 +1,53 @@
+---
+title: "ワールド変換の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グラフィックス, ワールド変換"
+  - "ワールド変換, 例"
+ms.assetid: 1e717711-1361-448e-aa49-0f3ec43110c9
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# ワールド変換の使用
+ワールド変換は、<xref:System.Drawing.Graphics> クラスのプロパティです。  ワールド変換を指定する数値は、3 × 3 の行列を表す <xref:System.Drawing.Drawing2D.Matrix> オブジェクトに格納されます。  <xref:System.Drawing.Drawing2D.Matrix> クラスおよび <xref:System.Drawing.Graphics> クラスには、ワールド変換行列の数値を設定するためのメソッドがいくつかあります。  
+  
+## さまざまな変換  
+ 最初に 50 × 50 の四角形を作成し、その四角形を原点 \(0, 0\) に配置する例を次に示します。  原点は、クライアント領域の左上隅の位置です。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#11)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#11)]  
+  
+ スケーリング変換を適用し、四角形を x 方向に係数 1.75 で拡大し、y 方向に係数 0.5 で縮小するコードを次に示します。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#12)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#12)]  
+  
+ その結果、元の四角形よりも x 方向が長く、y 方向が短い四角形が作成されます。  
+  
+ この四角形をスケーリングせずに回転させる場合は、次のコードを使用します。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#13](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#13)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#13](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#13)]  
+  
+ この四角形を平行移動するには、次のコードを使用します。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#14](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#14)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#14](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#14)]  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.Matrix>   
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)   
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md b/docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md
new file mode 100644
index 00000000000..501a64ea6f9
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md
@@ -0,0 +1,36 @@
+---
+title: "マネージ GDI+ での変換の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], 変換"
+  - "変換"
+ms.assetid: 1f8e18d3-d2f5-460e-a8e3-2da891c301de
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# マネージ GDI+ での変換の使用
+アフィン変換には、回転、スケーリング、反転、傾斜、平行移動などがあります。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、ベクター図面、イメージ、テキストに対してアフィン変換を実行するための基盤を <xref:System.Drawing.Drawing2D.Matrix> クラスが提供しています。  
+  
+## このセクションの内容  
+ [ワールド変換の使用](../../../../docs/framework/winforms/advanced/using-the-world-transformation.md)  
+ ワールド変換行列を使用してグラフィックスをスケーリングおよび回転させる方法を説明します。  
+  
+ [変換順序が重要となる理由](../../../../docs/framework/winforms/advanced/why-transformation-order-is-significant.md)  
+ 変換操作の順序が重要である理由を示します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Drawing2D.Matrix>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-transformations-to-scale-colors.md b/docs/framework/winforms/advanced/using-transformations-to-scale-colors.md
new file mode 100644
index 00000000000..8880385990b
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-transformations-to-scale-colors.md
@@ -0,0 +1,76 @@
+---
+title: "変換を使用した色のスケーリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, スケーリング"
+  - "変換, スケーリング (色の)"
+ms.assetid: df23c887-7fd6-4b15-ad94-e30b5bd4b849
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 変換を使用した色のスケーリング
+スケーリング変換では、4 つの色要素のうちの 1 つ以上の要素に数値を掛け合わせます。  スケーリングを表すカラー行列エントリを次の表に示します。  
+  
+|スケーリング対象の要素|行列エントリ|  
+|-----------------|------------|  
+|赤|\[0\]\[0\]|  
+|緑|\[1\]\[1\]|  
+|青|\[2\]\[2\]|  
+|アルファ|\[3\]\[3\]|  
+  
+## 単一色のスケーリング  
+ ファイル ColorBars2.bmp から <xref:System.Drawing.Image> オブジェクトを構築する例を次に示します。  このコードは、次に、イメージ内の各ピクセルの青の要素を係数 2 でスケーリングします。  元のイメージと変換後のイメージが並んで描画されます。  
+  
+ [!code-csharp[System.Drawing.RecoloringImages#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RecoloringImages/CS/Class1.cs#41)]
+ [!code-vb[System.Drawing.RecoloringImages#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RecoloringImages/VB/Class1.vb#41)]  
+  
+ 次の図は、左側に元のイメージ、右側にスケーリングされたイメージを示しています。  
+  
+ ![スケールの色](../../../../docs/framework/winforms/advanced/media/colortrans3.png "colortrans3")  
+  
+ 青のスケーリングを実行する前後の 4 つのバーのカラー ベクターを次の表に示します。  4 番目のカラー バーの青の要素は、0.8 から 0.6 になっています。  その理由は、[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] が結果値の小数部だけを保持するためです。  たとえば、\(2\)\(0.8\) \= 1.6 の場合、1.6 の小数部は 0.6 になります。  小数部だけを保持することによって、結果値が必ず \[0, 1\] の間隔内に収まるようにしています。  
+  
+|元|変換後|  
+|-------|---------|  
+|\(0.4, 0.4, 0.4, 1\)|\(0.4, 0.4, 0.8, 1\)|  
+|\(0.4, 0.2, 0.2, 1\)|\(0.4, 0.2, 0.4, 1\)|  
+|\(0.2, 0.4, 0.2, 1\)|\(0.2, 0.4, 0.4, 1\)|  
+|\(0.4, 0.4, 0.8, 1\)|\(0.4, 0.4, 0.6, 1\)|  
+  
+## 複数の色のスケーリング  
+ ファイル ColorBars2.bmp から <xref:System.Drawing.Image> オブジェクトを構築する例を次に示します。  このコードは、次に、イメージ内の各ピクセルの赤、緑、青の各要素をスケーリングします。  赤の要素は 25%、緑の要素は 35%、青の要素は 50% 縮小されます。  
+  
+ [!code-csharp[System.Drawing.RecoloringImages#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.RecoloringImages/CS/Class1.cs#42)]
+ [!code-vb[System.Drawing.RecoloringImages#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.RecoloringImages/VB/Class1.vb#42)]  
+  
+ 次の図は、左側に元のイメージ、右側にスケーリングされたイメージを示しています。  
+  
+ ![スケールの色](../../../../docs/framework/winforms/advanced/media/colortrans4.png "colortrans4")  
+  
+ 赤、緑、および青のスケーリングを実行する前後の 4 つのバーのカラー ベクターを次の表に示します。  
+  
+|元|変換後|  
+|-------|---------|  
+|\(0.6, 0.6, 0.6, 1\)|\(0.45, 0.39, 0.3, 1\)|  
+|\(0, 1, 1, 1\)|\(0, 0.65, 0.5, 1\)|  
+|\(1, 1, 0, 1\)|\(0.75, 0.65, 0, 1\)|  
+|\(1, 0, 1, 1\)|\(0.75, 0, 0.5, 1\)|  
+  
+## 参照  
+ <xref:System.Drawing.Imaging.ColorMatrix>   
+ <xref:System.Drawing.Imaging.ImageAttributes>   
+ [Windows フォームにおけるグラフィックスと描画](../../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)   
+ [イメージの色の変更](../../../../docs/framework/winforms/advanced/recoloring-images.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/using-wpf-controls.md b/docs/framework/winforms/advanced/using-wpf-controls.md
new file mode 100644
index 00000000000..97f4973635d
--- /dev/null
+++ b/docs/framework/winforms/advanced/using-wpf-controls.md
@@ -0,0 +1,65 @@
+---
+title: "WPF コントロールの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用性 [WPF]"
+  - "Windows フォーム デザイナー, 相互運用 (WPF との)"
+ms.assetid: 03c85dce-26ad-44cd-bc1d-8e0cb56de096
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# WPF コントロールの使用
+Windows フォーム ベースのアプリケーションでは Windows Presentation Foundation \(WPF\) コントロールを使用できます。  2 つの異なるビュー テクノロジがありますが、円滑に相互運用できます。  
+  
+ Windows フォーム デザイナーは、Windows Presentation Foundation コントロールをホストするビジュアル デザイン環境を提供します。  WPF コントロールは、<xref:System.Windows.Forms.Integration.ElementHost> という名前の特別な Windows フォーム コントロールによってホストされます。  このコントロールを使用すると、WPF コントロールが、フォームのレイアウトの一部になったり、キーボードやマウスのメッセージを受信したりできるようになります。  デザイン時には、<xref:System.Windows.Forms.Integration.ElementHost> コントロールを他の Windows フォーム コントロールと同じように配置できます。  
+  
+ Windows フォーム コントロールは、WPF ベースのアプリケーションでも使用できます。  詳細については、「[WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)」を参照してください。  
+  
+## このセクションの内容  
+ [方法 : デザイン時に ElementHost コントロールをコピーして貼り付ける](../../../../docs/framework/winforms/advanced/how-to-copy-and-paste-an-elementhost-control-at-design-time.md)  
+ Windows Presentation Foundation コントロールを Windows フォーム上でコピーする方法について説明します。  
+  
+ [チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの配置](../../../../docs/framework/winforms/advanced/walkthrough-arranging-wpf-content-on-windows-forms-at-design-time.md)  
+ 固定やスナップ線などの Windows フォームのレイアウト機能を使用して Windows Presentation Foundation コントロールを配置する方法について説明します。  
+  
+ [チュートリアル: デザイン時のホストされている WPF 要素のプロパティの変更](../../../../docs/framework/winforms/advanced/walkthrough-changing-properties-of-a-hosted-wpf-element-at-design-time.md)  
+ WPF コントロールでプロパティを変更するための、Windows フォーム デザイナーと [!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] との間のワークフローについて説明します。  
+  
+ [チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)  
+ Windows フォーム ベースのアプリケーションで使用するための Windows Presentation Foundation コントロールの作成方法について説明します。  
+  
+ [チュートリアル : ElementHost コントロールの別の Windows フォームへのコピーと貼り付け](../../../../docs/framework/winforms/advanced/copy--paste-an-elementhost-control-into-forms.md)  
+ Windows Presentation Foundation コントロールを Windows フォーム間でコピーする方法について説明します。  
+  
+ [チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの割り当て](../../../../docs/framework/winforms/advanced/walkthrough-assigning-wpf-content-on-windows-forms-at-design-time.md)  
+ フォームに表示する Windows Presentation Foundation コントロール型の選択方法について説明します。  
+  
+ [チュートリアル: WPF コンテンツへのスタイルの適用](../../../../docs/framework/winforms/advanced/walkthrough-styling-wpf-content.md)  
+ Windows Presentation Foundation コントロールにスタイルを適用するための、Windows フォーム デザイナーと [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)] との間のワークフローについて説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Integration.ElementHost>  
+ Windows Presentation Foundation コントロールを Windows フォーム ベースのアプリケーションでホストするために使用できるクラスについて説明します。  
+  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>  
+ Windows フォーム コントロールを Windows Presentation Foundation ベースのアプリケーションでホストするために使用できるクラスについて説明します。  
+  
+## 関連項目  
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)  
+ Windows Presentation Foundation テクノロジと Windows フォーム テクノロジとの間の相互運用について説明します。  
+  
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)  
+ Windows Presentation Foundation コントロールを [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でデザインする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/vector-graphics-overview.md b/docs/framework/winforms/advanced/vector-graphics-overview.md
new file mode 100644
index 00000000000..c5e541b6d1e
--- /dev/null
+++ b/docs/framework/winforms/advanced/vector-graphics-overview.md
@@ -0,0 +1,69 @@
+---
+title: "ベクター グラフィックスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "座標系"
+  - "グラフィックス, ベクター グラフィックス"
+  - "包括 (描画時に両側の端点を)"
+ms.assetid: 0195df81-66be-452d-bb53-5a582ebfdc09
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# ベクター グラフィックスの概要
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、直線や四角形などの図形を座標系内で描画します。  さまざまな座標系を選択できますが、既定の座標系は原点が左上隅、x 軸が右向き、y 軸が下向きの座標系です。  既定の座標系での単位はピクセルです。  
+  
+## GDI\+ のビルド ブロック  
+ ![ベクター グラフィックス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art01.png "AboutGdip02\_Art01")  
+  
+ コンピューターのモニターでは、画素 \(ピクセル\) と呼ばれるドットから構成される四角形の配列上に表示が生成されます。  画面上に表示されるピクセルの数はモニターごとに異なります。通常、それぞれのモニターに表示されるピクセルの数は、一定の範囲内でユーザーが設定できます。  
+  
+ ![ベクター グラフィックス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art02.png "AboutGdip02\_Art02")  
+  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] を使用して直線、四角形、または曲線を描画する場合は、項目を描画するために基本的な情報を指定します。  たとえば、2 点を定義すると直線を指定でき、1 点、高さ、および幅を定義すると四角形を指定できます。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] とディスプレイ ドライバー ソフトウェアによって、直線、四角形、または曲線を表示するためにどのピクセルをオンにするかが決定されます。  点 \(4, 2\) から点 \(12, 8\) まで直線を表示するためにオンにされているピクセルを次の図に示します。  
+  
+ ![ベクター グラフィックス](../../../../docs/framework/winforms/advanced/media/aboutgdip02-art03.png "AboutGdip02\_Art03")  
+  
+ 2 次元ピクチャの作成に最も適した基本的なビルド ブロックとして、いくつかの図形を使用できることが実証されています。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] によってすべてサポートされる、これらのビルド ブロックを次に示します。  
+  
+-   線  
+  
+-   四角形  
+  
+-   楕円  
+  
+-   円弧  
+  
+-   多角形  
+  
+-   カーディナル スプライン  
+  
+-   ベジエ スプライン  
+  
+## グラフィックス オブジェクトを使用した描画方法  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の <xref:System.Drawing.Graphics> クラスは、上記の項目を描画するためのメソッドとして、<xref:System.Drawing.Graphics.DrawLine%2A>、<xref:System.Drawing.Graphics.DrawRectangle%2A>、<xref:System.Drawing.Graphics.DrawEllipse%2A>、<xref:System.Drawing.Graphics.DrawPolygon%2A>、<xref:System.Drawing.Graphics.DrawArc%2A>、<xref:System.Drawing.Graphics.DrawCurve%2A> \(カーディナル スプライン用\)、および <xref:System.Drawing.Graphics.DrawBezier%2A> を提供します。  これらの各メソッドはオーバーロードされています。つまり、各メソッドが複数の異なるパラメーター リストをサポートします。  たとえば、ある <xref:System.Drawing.Graphics.DrawLine%2A> メソッドは <xref:System.Drawing.Pen> オブジェクトと 4 個の整数を受け取り、別の <xref:System.Drawing.Graphics.DrawLine%2A> メソッドは <xref:System.Drawing.Pen> オブジェクトと 2 個の <xref:System.Drawing.Point> オブジェクトを受け取ります。  
+  
+ 直線、四角形、およびベジエ スプラインを描画するためのメソッドには、1 回の呼び出しで複数の項目を描画するコンパニオン メソッドである <xref:System.Drawing.Graphics.DrawLines%2A>、<xref:System.Drawing.Graphics.DrawRectangles%2A>、および <xref:System.Drawing.Graphics.DrawBeziers%2A> があります。  また、<xref:System.Drawing.Graphics.DrawCurve%2A> メソッドにも、曲線の終了点と開始点を連結することによって曲線を閉じるコンパニオン メソッド <xref:System.Drawing.Graphics.DrawClosedCurve%2A> があります。  
+  
+ <xref:System.Drawing.Graphics> クラスのすべての描画メソッドは、<xref:System.Drawing.Pen> オブジェクトと共に機能します。  図形を描画するためには、少なくとも <xref:System.Drawing.Graphics> オブジェクトと <xref:System.Drawing.Pen> オブジェクトの 2 つのオブジェクトを作成する必要があります。  <xref:System.Drawing.Pen> オブジェクトには、描画される項目の属性として、線の幅や色などが格納されます。  <xref:System.Drawing.Pen> オブジェクトは、引数の 1 つとして描画メソッドに渡されます。  たとえば、ある <xref:System.Drawing.Graphics.DrawLine%2A> メソッドは、次の例に示すように <xref:System.Drawing.Pen> オブジェクトと 4 個の整数を受け取ります。このメソッドは、幅 100、高さ 50、左上隅 \(20, 10\) の四角形を描画します。  
+  
+ [!code-csharp[LinesCurvesAndShapes#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/LinesCurvesAndShapes/CS/Class1.cs#11)]
+ [!code-vb[LinesCurvesAndShapes#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/LinesCurvesAndShapes/VB/Class1.vb#11)]  
+  
+## 参照  
+ <xref:System.Drawing.Graphics?displayProperty=fullName>   
+ <xref:System.Drawing.Pen?displayProperty=fullName>   
+ [直線、曲線、および図形](../../../../docs/framework/winforms/advanced/lines-curves-and-shapes.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-arranging-wpf-content-on-windows-forms-at-design-time.md b/docs/framework/winforms/advanced/walkthrough-arranging-wpf-content-on-windows-forms-at-design-time.md
new file mode 100644
index 00000000000..24c66c4179b
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-arranging-wpf-content-on-windows-forms-at-design-time.md
@@ -0,0 +1,167 @@
+---
+title: "チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用性 [WPF]"
+  - "Windows フォーム, 固定およびドッキング (WPF コンテンツを)"
+  - "Windows フォーム, 配置 (WPF コンテンツをデザイン時に)"
+  - "WPF コンテンツ [Windows フォーム], 配置 (デザイン時に)"
+  - "WPF コンテンツ, ホスト (Windows フォームで)"
+  - "WPF ユーザー コントロール [Windows フォーム], ホスト (レイアウト パネルで)"
+ms.assetid: 5efb1c53-1484-43d6-aa8a-f4861b99bb8a
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの配置
+このチュートリアルでは、固定やスナップ線などの Windows フォームのレイアウト機能を使用して、Windows Presentation Foundation \(WPF\) コントロールを配置する方法を説明します。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   プロジェクトを作成する。  
+  
+-   WPF コントロールを作成する。  
+  
+-   レイアウト パネルで WPF コントロールをホストする。  
+  
+-   WPF コントロールを配置するスナップ線を使用する。  
+  
+-   WPF コントロールを固定してドッキングする。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)].  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `ArrangeElementHost` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## WPF コントロールの作成  
+ プロジェクトに WPF コントロール型を追加したら、フォーム状に配置できます。  
+  
+#### WPF コントロールを作成するには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> をプロジェクトに追加します。  コントロール型の既定の名前である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  デザイン ビューで `UserControl1` が選択されていることを確認します。  詳細については、「[方法 : デザイン画面上で要素を選択して移動する](http://msdn.microsoft.com/ja-jp/54cb70b6-b35b-46e4-a0cc-65189399c474)」を参照してください。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+4.  <xref:System.Windows.Controls.Control.Background%2A> プロパティの値を `[青]` に設定します。  
+  
+5.  プロジェクトをビルドします。  
+  
+## レイアウト パネルで WPF コントロールをホストする  
+ その他の Windows フォーム コントロールを使用するのと同じ方法で、レイアウト パネルで WPF コントロールを使用できます。  
+  
+#### レイアウト パネルで WPF コントロールをホストするには  
+  
+1.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+2.  **ツールボックス**から、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをフォームにドラッグします。  
+  
+3.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールのスマート タグ パネルで、**\[最後の行を削除する\]** を選択します。  
+  
+4.  幅と高さが大きくなるよう <xref:System.Windows.Forms.TableLayoutPanel> コントロールのサイズを変更します。  
+  
+5.  **\[ツールボックス\]** で `UserControl1` をダブルクリックして、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの最初のセルに `UserControl1` のインスタンスを作成します。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+6.  **\[ツールボックス\]** で `UserControl1` をダブルクリックして、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの 2 番目のセルの別のインスタンスを作成します。  
+  
+7.  **\[ドキュメント アウトライン\]** ウィンドウで、`tableLayoutPanel1` を選択します。  詳細については、「[Document Outline Window](http://msdn.microsoft.com/ja-jp/9054f2bc-f6f8-4242-9fe0-be71089b12f8)」を参照してください。  
+  
+8.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.Padding%2A> プロパティの値を `10、10、10、10` に設定します。  
+  
+     両方の <xref:System.Windows.Forms.Integration.ElementHost> コントロールが、新しいレイアウトに収まるようにサイズ変更されました。  
+  
+## WPF コントロールを配置するスナップ線を使用する  
+ スナップ線により、フォームのコントロールの配置を簡単に調整できます。  スナップ線を使用して、WPF コントロールも配置することができます。  詳細については、「[チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)」を参照してください。  
+  
+#### WPF コントロールを配置するスナップ線を使用するには  
+  
+1.  **ツールボックス**から、`UserControl1` のインスタンスをフォームにドラッグして、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの下の領域に配置します。  
+  
+     `UserControl1` のインスタンスは、`elementHost3` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+2.  スナップ線を使用して、`elementHost3` の左端を <xref:System.Windows.Forms.TableLayoutPanel> コントロールの左端に揃えます。  
+  
+3.  スナップ線を使用して、`elementHost3` のサイズを <xref:System.Windows.Forms.TableLayoutPanel> コントロールと同じ幅にします。  
+  
+4.  コントロール間に中央揃えのスナップ線が表示されるまで`elementHost3` を <xref:System.Windows.Forms.TableLayoutPanel> コントロールの方へ移動します。  
+  
+5.  **\[プロパティ\]** ウィンドウで、余白プロパティの値を `20、20、20、20` に設定します。  
+  
+6.  中央揃えのスナップ線がもう一度表示されるまで、`elementHost3` を <xref:System.Windows.Forms.TableLayoutPanel> コントロールから移動します。  中央揃えのスナップ線が、余白 20 を示すようになりました。  
+  
+7.  左端が `elementHost1` の左端に配置されるまで、`elementHost3` を右に移動します。  
+  
+8.  右端が `elementHost2` の右端に配置されるまで、`elementHost3` の幅を変更します。  
+  
+## WPF コントロールの固定およびドッキング  
+ フォームでホストされている WPF コントロールは、他の Windows フォーム コントロールと同じ固定とドッキングの動作を持ちます。  
+  
+#### WPF コントロールを固定してドッキングするには  
+  
+1.  `elementHost1` を選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティを **\[Top, Bottom, Left, Right\]** に設定します。  
+  
+3.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを大きなサイズに変更します。  
+  
+     `elementHost1` コントロールがセルを満たすようサイズ変更されます。  
+  
+4.  `elementHost2` を選択します。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+     `elementHost2` コントロールがセルを満たすようサイズ変更されます。  
+  
+6.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを選択します。  
+  
+7.  <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+8.  `elementHost3` を選択します。  
+  
+9. <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+     `elementHost3` コントロールが、フォームの残りの領域を満たすようサイズ変更されます。  
+  
+10. フォームのサイズを変更します。  
+  
+     3 つすべての <xref:System.Windows.Forms.Integration.ElementHost> コントロールのサイズを適切に変更します。  
+  
+     詳細については、「[方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [方法 : デザイン時にフォームの端に合わせてコントロールを配置する](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-assigning-wpf-content-on-windows-forms-at-design-time.md b/docs/framework/winforms/advanced/walkthrough-assigning-wpf-content-on-windows-forms-at-design-time.md
new file mode 100644
index 00000000000..351f0e93baf
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-assigning-wpf-content-on-windows-forms-at-design-time.md
@@ -0,0 +1,113 @@
+---
+title: "チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ElementHost コントロール, 割り当て (WPF コンテンツをデザイン時に)"
+  - "相互運用性 [WPF]"
+  - "Windows フォーム, コンテンツ割り当て"
+  - "WPF コンテンツ [Windows フォーム], 割り当て (デザイン時に)"
+  - "WPF ユーザー コントロール, ホスト (Windows フォームで)"
+ms.assetid: b3e9ef93-7e0f-4a2f-8f1e-3437609a1eb7
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# チュートリアル: デザイン時の Windows フォームでの WPF コンテンツの割り当て
+このチュートリアルでは、フォームに表示する Windows Presentation Foundation \(WPF\) コントロール型を選択する方法について説明します。  プロジェクトに含まれている WPF コントロール型であれば、どれでも選択できます。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   プロジェクトを作成する。  
+  
+-   WPF コントロール型を作成する。  
+  
+-   WPF コントロールを選択する。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)].  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `SelectingWpfContent` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## WPF コントロール型の作成  
+ プロジェクトに追加した WPF コントロール型は、さまざまな <xref:System.Windows.Forms.Integration.ElementHost> コントロール内でホストできます。  
+  
+#### WPF コントロール型を作成するには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> プロジェクトをソリューションに追加します。  コントロール型の既定の名前である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  デザイン ビューで `UserControl1` が選択されていることを確認します。  詳細については、「[方法 : デザイン画面上で要素を選択して移動する](http://msdn.microsoft.com/ja-jp/54cb70b6-b35b-46e4-a0cc-65189399c474)」を参照してください。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+4.  <xref:System.Windows.Controls.TextBox?displayProperty=fullName> コントロールを <xref:System.Windows.Controls.UserControl> に追加し、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティの値を「Hosted Content」に設定します。  
+  
+5.  WPF <xref:System.Windows.Controls.UserControl> をプロジェクトにもう 1 つ追加します。  コントロール型の既定の名前である `UserControl2.xaml` を使用します。  
+  
+6.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+7.  <xref:System.Windows.Controls.TextBox?displayProperty=fullName> コントロールを <xref:System.Windows.Controls.UserControl> に追加し、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティの値を「Hosted Content 2」に設定します。  
+  
+ **メモ** 一般的には、もう少し高度な WPF コンテンツをホストします。  ここでは、説明する目的でのみ <xref:System.Windows.Controls.TextBox?displayProperty=fullName> コントロールを使用しています。  
+  
+1.  プロジェクトをビルドします。  
+  
+## WPF コントロールの選択  
+ 既にコンテンツをホストしている <xref:System.Windows.Forms.Integration.ElementHost> コントロールに異なる WPF コンテンツを割り当てることができます。  
+  
+#### WPF コントロールを選択するには  
+  
+1.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+2.  **\[ツールボックス\]** で `UserControl1` をダブルクリックして、フォーム上に `UserControl1` のインスタンスを作成します。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+3.  `elementHost1` のスマート タグ パネルで、**\[ホストするコンテンツの選択\]** ドロップダウン リストを開きます。  
+  
+4.  ドロップダウン リスト ボックスの **\[UserControl2\]** を選択します。  
+  
+     これで、`elementHost1` コントロールが `UserControl2` 型のインスタンスをホストするようになりました。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Integration.ElementHost.Child%2A> プロパティが **\[UserControl2\]** に設定されていることを確認します。  
+  
+6.  **\[ツールボックス\]** の **\[WPF 相互運用性\]** グループから、<xref:System.Windows.Forms.Integration.ElementHost> コントロールをフォームにドラッグしします。  
+  
+     新しい名前として、このコントロールの既定である `elementHost2` を使用します。  
+  
+7.  `elementHost2` のスマート タグ パネルで、**\[ホストするコンテンツの選択\]** ドロップダウン リストを開きます。  
+  
+8.  ドロップダウン リストの **\[UserControl1\]** を選択します。  
+  
+9. これで、`elementHost2` コントロールが `UserControl1` 型のインスタンスをホストするようになりました。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-changing-properties-of-a-hosted-wpf-element-at-design-time.md b/docs/framework/winforms/advanced/walkthrough-changing-properties-of-a-hosted-wpf-element-at-design-time.md
new file mode 100644
index 00000000000..e24cb8a0614
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-changing-properties-of-a-hosted-wpf-element-at-design-time.md
@@ -0,0 +1,99 @@
+---
+title: "チュートリアル: デザイン時のホストされている WPF 要素のプロパティの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用性 [WPF]"
+  - "Windows フォーム, 変更 (WPF コンテンツのプロパティをデザイン時に)"
+  - "WPF コンテンツ [Windows フォーム], 変更 (プロパティをデザイン時に)"
+  - "WPF コンテンツ, ホスト (Windows フォームで)"
+ms.assetid: a1f7a90c-0bbb-4781-8c3c-8cc8bef2488d
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# チュートリアル: デザイン時のホストされている WPF 要素のプロパティの変更
+このチュートリアルでは、Windows フォームでホストされている Windows Presentation Foundation \(WPF\) コントロールのプロパティ値を変更する方法について説明します。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   プロジェクトを作成する。  
+  
+-   WPF コントロールを作成する。  
+  
+-   Windows フォームで WPF コントロールをホストする。  
+  
+-   Visual Studio の WPF デザイナーを使用してプロパティの値を変更する。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)].  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `WpfHost` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## WPF コントロールの作成  
+ プロジェクトに WPF コントロール型を追加したら、フォーム状に配置できます。  
+  
+#### WPF コントロールを作成するには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> をプロジェクトに追加します。  コントロール型の既定の名前である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Controls.Control.Background%2A> プロパティの値を `[青]` に設定します。  
+  
+3.  プロジェクトをビルドします。  
+  
+## WPF コントロールのプロパティの値を変更する  
+ <xref:System.Windows.Forms.Integration.ElementHost> スマート タグにより、WPF デザイナーを使用して、ホストされている WPF の内容のプロパティを簡単に変更できます。  
+  
+#### WPF コントロールをホストするには  
+  
+1.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+2.  **ツールボックス** の **\[WPF ユーザー コントロール\]** タブで、`UserControl1` をダブルクリックして、フォーム上に `UserControl1` のインスタンスを作成します。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+3.  **ElementHost タスク**のスマート タグ パネルで、**\[ホストするコンテンツの編集\]** を選択します。  
+  
+     UserControl1.xaml が WPF デザイナーで開きます。  
+  
+4.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Controls.Control.Background%2A> プロパティの値を `[赤]` に設定します。  
+  
+5.  プロジェクトをリビルドします。  
+  
+6.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+     `UserControl1` のインスタンスが赤の背景になります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [方法 : デザイン時にフォームの端に合わせてコントロールを配置する](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md b/docs/framework/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md
new file mode 100644
index 00000000000..6532ef801d0
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md
@@ -0,0 +1,326 @@
+---
+title: "チュートリアル : ユーザー補助対応の Windows ベースのアプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセシビリティ, Windows アプリケーション"
+  - "アプリケーション [Windows フォーム], アクセシビリティ"
+  - "Windows アプリケーション, アクセシビリティ"
+ms.assetid: 654c7f2f-1586-480b-9f12-9d9b8f5cc32b
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# チュートリアル : ユーザー補助対応の Windows ベースのアプリケーションの作成
+ユーザー補助に対応するアプリケーションを作成することは、ビジネスに重要な影響を与えます。  多くの政府は、ソフトウェアの購入に関するユーザー補助の規制があります。  Certified for Windows ロゴには、ユーザー補助に関する要件が含まれています。  米国のみで、推定 3000 万人が  ソフトウェアのユーザー補助機能によって影響を受けており、その多くが潜在的な顧客です。  
+  
+ このチュートリアルにより、Certified for Windows ロゴの 5 つのユーザー補助機能の要件に対応します。  これらの要件によると、ユーザー補助機能を持つアプリケーションとは、次のようなアプリケーションです。  
+  
+-   コントロール パネルのサイズ、色、フォント、および入力設定をサポートします。  ユーザーがコントロール パネルの設定を変更すると、メニュー バー、タイトル バー、罫線、およびステータス バーはすべてサイズが変更されます。  このアプリケーションでは、コントロールまたはコードに追加の変更は必要ありません。  
+  
+-   ハイ コントラスト モードをサポートします。  
+  
+-   すべての機能に対して文書化されたキーボード アクセスを提供します。  
+  
+-   キーボード フォーカスの場所を視覚的およびプログラムで公開します。  
+  
+-   サウンドだけで重要な情報を伝達しないようにします。  
+  
+ 詳細については、「[ユーザー補助アプリケーションのデザイン リソース](../Topic/Resources%20for%20Designing%20Accessible%20Applications.md)」を参照してください。  
+  
+ さまざまなキーボード レイアウトをサポートする方法の詳細については、「[推奨される国際対応アプリケーション開発手順](../../../../docs/standard/globalization-localization/best-practices-for-developing-world-ready-apps.md)」を参照してください。  
+  
+## プロジェクトの作成  
+ このチュートリアルでは、ピザの注文を受け取るためのアプリケーションのユーザー インターフェイスを作成します。  顧客の名前のための <xref:System.Windows.Forms.TextBox>、ピザのサイズを選択する <xref:System.Windows.Forms.RadioButton> グループ、トッピングを選択するための <xref:System.Windows.Forms.CheckedListBox>、\[注文\] と \[キャンセル\] のラベルの付いた 2 つのボタン コントロール、および \[終了\] コマンドのあるメニューで構成されます。  
+  
+ ユーザーが、顧客の名前、ピザのサイズ、および希望のトッピングを入力します。  ユーザーが \[注文\] ボタンをクリックすると、メッセージ ボックスに注文の概要と値段が表示され、コントロールがクリアされて次の注文のために準備します。  ユーザーが \[キャンセル\] ボタンをクリックすると、コントロールがクリアされて、次の注文のための準備ができた状態になります。  ユーザーが \[終了\] メニュー項目をクリックすると、プログラムを閉じます。  
+  
+ このチュートリアルの重点は、販売注文システムのコードではなく、ユーザー インターフェイスのユーザー補助機能です。  このチュートリアルは、ボタン、オプション ボタン、テキスト ボックス、およびラベルなど、頻繁に使用されるいくつかのコントロールのユーザー補助機能を示します。  
+  
+#### アプリケーションの作成を開始するには  
+  
+-   [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] で新しい Windows アプリケーションを作成します。  プロジェクトに「PizzaOrder」という名前を付けます。  \(詳細については、「[新しいソリューションとプロジェクトの作成](../Topic/Creating%20Solutions%20and%20Projects.md)」を参照。\)  
+  
+## フォームへのコントロールの追加  
+ フォームにコントロールを追加するときは、ユーザー補助に対応したアプリケーション作成のガイドラインに従うよう注意してください。  
+  
+-   <xref:System.Windows.Forms.Control.AccessibleDescription%2A> プロパティと <xref:System.Windows.Forms.Control.AccessibleName%2A> プロパティを設定します。  この例では、<xref:System.Windows.Forms.Control.AccessibleRole%2A> の既定の設定で十分です。  ユーザー補助機能のプロパティの詳細については「[Windows フォーム上のコントロールのユーザー補助情報の提供](../../../../docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md)」を参照してください。  
+  
+-   フォント サイズを 10 ポイント以上に設定します。  
+  
+    > [!NOTE]
+    >  開始するときに、フォームのフォント サイズを 10 に設定すると、その後フォームに追加されるすべてのコントロールのフォント サイズが 10 になります。  
+  
+-   TextBox コントロールを説明するラベル コントロールが、タブ オーダーで TextBox コントロールのすぐ前になるようにします。  
+  
+-   "&"の文字を使用して、ユーザーが移動する先のコントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティにアクセス キーを追加します。  
+  
+-   "&"の文字を使用して、ユーザーが移動する先のコントロールに先行するラベルの <xref:System.Windows.Forms.Control.Text%2A> プロパティにアクセス キーを追加します。  ラベルの <xref:System.Windows.Forms.Label.UseMnemonic%2A> プロパティを `true` に設定し、ユーザーがアクセス キーを押したときに、フォーカスがタブ オーダーで次のコントロールに設定されるようにします。  
+  
+-   アクセス キーをすべてのメニュー項目に追加します。  
+  
+#### Windows アプリケーションをユーザー補助に対応させるには  
+  
+-   フォームにコントロールを追加し、以下に示すように、プロパティを設定します。  フォームにコントロールを配置する方法のモデルについては、表の最後の画像を参照してください。  
+  
+    |オブジェクト|プロパティ|値|  
+    |------------|-----------|-------|  
+    |Form1|AccessibleDescription|オーダー フォーム|  
+    ||AccessibleName|オーダー フォーム|  
+    ||フォント サイズ|10|  
+    ||テキスト|ピザ オーダー フォーム|  
+    |PictureBox|名前|ロゴ|  
+    ||AccessibleDescription|ピザのスライス|  
+    ||AccessibleName|会社のロゴ|  
+    ||イメージ|任意のアイコンまたはビットマップ|  
+    |ラベル|名前|companyLabel|  
+    ||テキスト|おいしいピザ|  
+    ||TabIndex|1|  
+    ||AccessibleDescription|会社名|  
+    ||AccessibleName|会社名|  
+    ||背景色|青|  
+    ||前景色|黄|  
+    ||Font Size|18|  
+    |ラベル|名前|customerLabel|  
+    ||テキスト|名前\(&N\)|  
+    ||TabIndex|2|  
+    ||AccessibleDescription|顧客名のラベル|  
+    ||AccessibleName|顧客名のラベル|  
+    ||UseMnemonic|True|  
+    |TextBox|名前|CustomerName|  
+    ||テキスト|\(なし\)|  
+    ||TabIndex|3|  
+    ||AccessibleDescription|顧客名|  
+    ||AccessibleName|顧客名|  
+    |GroupBox|名前|sizeOptions|  
+    ||AccessibleDescription|ピザのサイズ オプション|  
+    ||AccessibleName|ピザのサイズ オプション|  
+    ||テキスト|ピザのサイズ|  
+    ||TabIndex|4|  
+    |RadioButton|名前|smallPizza|  
+    ||テキスト|スモール\(&S\) $6.00|  
+    ||チェック済み|True|  
+    ||TabIndex|0|  
+    ||AccessibleDescription|Small pizza|  
+    ||AccessibleName|Small pizza|  
+    |RadioButton|名前|largePizza|  
+    ||テキスト|ラージ\(&L\) $10.00|  
+    ||TabIndex|1|  
+    ||AccessibleDescription|ラージ サイズのピザ|  
+    ||AccessibleName|ラージ サイズのピザ|  
+    |ラベル|名前|toppingsLabel|  
+    ||テキスト|トッピング\(&T\) \(1 つ $0.75\)|  
+    ||TabIndex|5|  
+    ||AccessibleDescription|トッピング ラベル|  
+    ||AccessibleName|トッピング ラベル|  
+    ||UseMnemonic|True|  
+    |CheckedListBox|名前|トッピング|  
+    ||TabIndex|6|  
+    ||AccessibleDescription|選択可能なトッピング|  
+    ||AccessibleName|選択可能なトッピング|  
+    ||項目|ペペロニ、ソーセージ、マッシュルーム|  
+    |ボタン|名前|順序|  
+    ||テキスト|順序\(&O\)|  
+    ||TabIndex|7|  
+    ||AccessibleDescription|注文の合計|  
+    ||AccessibleName|注文の合計|  
+    |ボタン|名前|cancel|  
+    ||テキスト|キャンセル\(&C\)|  
+    ||TabIndex|9|  
+    ||AccessibleDescription|注文のキャンセル|  
+    ||AccessibleName|注文のキャンセル|  
+    |MainMenu|名前|theMainMenu|  
+    |MenuItem|名前|fileCommands|  
+    ||テキスト|ファイル\(&F\)|  
+    |MenuItem|名前|exitApp|  
+    ||テキスト|終了\(&X\)|  
+  
+     ![ピザ オーダー フォーム](../../../../docs/framework/winforms/advanced/media/vbpizzaorderform.gif "vbPizzaOrderForm")  
+フォームは次のようになります。  
+  
+## ハイ コントラスト モードのサポート  
+ ハイコントラスト モードとは、視覚的に障碍のあるユーザーの役に立つ対照的な色とフォント サイズを使用して、読みやすさを向上する Windows のシステム設定です。  [SystemInformation.HighContrast Property](frlrfSystemWindowsFormsSystemInformationClassHighContrastTopic) プロパティは、ハイ コントラスト モードが設定されているかどうかを判断するために提供されます。  
+  
+ SystemInformation.HighContrast が `true` の場合、アプリケーションは次のようになります  
+  
+-   システムの配色を使用して、すべてのユーザー インターフェイス要素を表示します。  
+  
+-   色で伝達される情報を、視覚的手掛かりまたはサウンドで伝達します。  たとえば、特定のリスト項目が赤いフォントを使用して強調表示されている場合に、フォントに太字を追加することで、項目が強調されていることをユーザーが色以外の手掛かりで確認できます。  
+  
+-   テキストの背後にあるイメージやパターンを省略します。  
+  
+ アプリケーションが開始し、システム イベント <xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> に応答する際、アプリケーションで <xref:System.Windows.Forms.SystemInformation.HighContrast%2A> の設定を確認する必要があります。  <xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> イベントは、<xref:System.Windows.Forms.SystemInformation.HighContrast%2A> の値が変更されるたびに発生します。  
+  
+ 例のアプリケーションでは、色のシステム設定を使用していない唯一の要素は、 `lblCompanyName` です。  [SystemColors Class](frlrfSystemDrawingSystemColorsClassTopic) クラスは、ユーザーが選択したシステムの色のラベルの色設定を変更する場合に使用します。  
+  
+#### 効果的な方法でハイ コントラスト モードを有効にするには  
+  
+1.  ラベルの色をシステム カラーを設定するメソッドを作成します。  
+  
+    ```  
+    ' Visual Basic  
+    Private Sub SetColorScheme()  
+       If SystemInformation.HighContrast Then  
+          companyLabel.BackColor = SystemColors.Window  
+          companyLabel.ForeColor = SystemColors.WindowText  
+       Else  
+          companyLabel.BackColor = Color.Blue  
+          companyLabel.ForeColor = Color.Yellow  
+       End If  
+    End Sub  
+  
+    // C#  
+    private void SetColorScheme()  
+    {  
+       if (SystemInformation.HighContrast)  
+       {  
+          companyLabel.BackColor = SystemColors.Window;  
+          companyLabel.ForeColor = SystemColors.WindowText;  
+       }  
+       else  
+       {  
+          companyLabel.BackColor = Color.Blue;  
+          companyLabel.ForeColor = Color.Yellow;  
+       }  
+    }  
+    ```  
+  
+2.  フォームのコンストラクターで  `SetColorScheme`  プロシージャを呼び出します \(`Public Sub New()` Visual Basic と  `public class Form1`  Visual C\# の場合\)。  Visual Basic でコンストラクターにアクセスするには、**Windows フォーム デザイナーで生成されたコード**というラベルが付いた領域を展開する必要があります。  
+  
+    ```  
+    ' Visual Basic   
+    Public Sub New()  
+       MyBase.New()  
+       InitializeComponent()  
+       SetColorScheme()  
+    End Sub  
+  
+    // C#  
+    public Form1()  
+    {  
+       InitializeComponent();  
+       SetColorScheme();  
+    }  
+    ```  
+  
+3.  適切なシグネチャを持つイベント プロシージャを作成して、<xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> イベントに対応します。  
+  
+    ```  
+    ' Visual Basic  
+    Protected Sub UserPreferenceChanged(ByVal sender As Object, _  
+    ByVal e As Microsoft.Win32.UserPreferenceChangedEventArgs)  
+       SetColorScheme()  
+    End Sub  
+  
+    // C#  
+    public void UserPreferenceChanged(object sender,   
+    Microsoft.Win32.UserPreferenceChangedEventArgs e)  
+    {  
+       SetColorScheme();  
+    }  
+    ```  
+  
+4.  `InitializeComponents` への呼び出しの後でコードをフォームのコンストラクターに追加して、イベント プロシージャをシステム イベントにフックします。  このメソッドは、 `SetColorScheme`  プロシージャを呼び出します。  
+  
+    ```  
+    ' Visual Basic  
+    Public Sub New()  
+       MyBase.New()  
+       InitializeComponent()  
+       SetColorScheme()  
+       AddHandler Microsoft.Win32.SystemEvents.UserPreferenceChanged, _  
+          AddressOf Me.UserPreferenceChanged  
+    End Sub  
+  
+    // C#  
+    public Form1()  
+    {  
+       InitializeComponent();  
+       SetColorScheme();  
+       Microsoft.Win32.SystemEvents.UserPreferenceChanged   
+          += new Microsoft.Win32.UserPreferenceChangedEventHandler(  
+          this.UserPreferenceChanged);  
+    }  
+    ```  
+  
+5.  基本クラスの <xref:System.Windows.Forms.Control.Dispose%2A> メソッドへの呼び出しの前に、フォームの <xref:System.Windows.Forms.Control.Dispose%2A> メソッドにコードを追加して、アプリケーションの終了時にイベントを解放します。  Visual Basic で <xref:System.Windows.Forms.Control.Dispose%2A> メソッドにアクセスするには、「Windows フォーム デザイナーで生成されたコード」というラベルが付いた領域を展開する必要があります。  
+  
+    > [!NOTE]
+    >  システム イベントのコードが、メイン アプリケーションとは別のスレッドを実行します。  イベントを解放しないと、プログラムが終了した後でも、イベントにフックするコードが実行されます。  
+  
+    ```  
+    ' Visual Basic  
+    Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)  
+       If disposing Then  
+          If Not (components Is Nothing) Then  
+             components.Dispose()  
+          End If  
+       End If  
+       RemoveHandler Microsoft.Win32.SystemEvents.UserPreferenceChanged, _  
+          AddressOf Me.UserPreferenceChanged  
+       MyBase.Dispose(disposing)  
+    End Sub  
+  
+    // C#  
+    protected override void Dispose( bool disposing )  
+    {  
+       if( disposing )  
+       {  
+          if (components != null)   
+          {  
+             components.Dispose();  
+          }  
+       }  
+       Microsoft.Win32.SystemEvents.UserPreferenceChanged   
+          -= new Microsoft.Win32.UserPreferenceChangedEventHandler(  
+          this.UserPreferenceChanged);  
+       base.Dispose( disposing );  
+    }  
+    ```  
+  
+6.  F5 キーを押してアプリケーションを実行します。  
+  
+## サウンド以外の方法で重要な情報を伝達する  
+ このアプリケーションでは、サウンドだけで伝達される情報はありません。  アプリケーションでサウンドを使用する場合は、別の方法もで情報を提供する必要があります。  
+  
+#### サウンド以外の方法で情報を提供するには  
+  
+1.  Windows API 関数 FlashWindow を使用して、タイトル バーをフラッシュさせます。  Windows API 関数を呼び出す方法の例は、「[チュートリアル: Windows API の呼び出し](../Topic/Walkthrough:%20Calling%20Windows%20APIs%20\(Visual%20Basic\).md)」を参照してください。  
+  
+    > [!NOTE]
+    >  ユーザーが Windows SoundSentry サービスを有効にして、コンピューターの内蔵スピーカーを通じてシステム サウンドが再生されるときにウィンドウをフラッシュさせていることがあります。  
+  
+2.  ユーザーがそれに応答できるように、非モーダル ウィンドウで重要な情報を表示します。  
+  
+3.  キーボード フォーカスを取得するメッセージ ボックスを表示します。  ユーザーが入力しているときは、このメソッドは回避します。  
+  
+4.  タスク バーの状態通知領域に状態インジケーターを表示します。  詳細については、「[方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する](../../../../docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md)」を参照してください。  
+  
+## アプリケーションのテスト  
+ アプリケーションを配置する前に、実装したユーザー補助機能をテストする必要があります。  
+  
+#### ユーザー補助機能をテストするには  
+  
+1.  キーボード アクセスをテストするには、マウスを外し、キーボードのみを使用して各機能のユーザー インターフェイスを移動します。  キーボードのみを使用してすべてのタスクが実行できることを確認します。  
+  
+2.  ハイ コントラストのサポートをテストするには、コントロール パネルの \[ユーザー補助のオプション\] アイコンを選択します。  \[表示\] タブをクリックし、\[ハイ コントラストを使用する\] チェック ボックスを選択します。  色とフォントの変更が反映されることを確認するために、すべてのユーザー インターフェイス要素を移動します。  また、テキストの背景に描画されるイメージやパターンが省略されていることを確認します。  
+  
+    > [!NOTE]
+    >  Windows NT 4 では、コントロール パネルにユーザー補助機能オプション アイコンがありません。  したがって、SystemInformation.HighContrast の設定変更のこの手順は、Windows NT 4 では機能しません。  
+  
+3.  その他のツールは、アプリケーションのユーザー補助機能をテストするためにすぐに使用できます。  
+  
+4.  キーボード フォーカスを公開することをテストするには、拡大鏡を実行します。  \(拡大鏡を開くには、**\[スタート\]** メニューをクリックし、**\[すべてのプログラム\]**、**\[アクセサリ\]**、**\[ユーザー補助\]** の順でポイントして、**\[拡大鏡\]** をクリックします\)。  キーボードの \[Tab\] キーとマウスの両方を使用して、ユーザー インターフェイスを移動します。  すべての操作が**拡大鏡**で正常に追跡されることを確認します。  
+  
+5.  画面要素の公開をテストするには、検査を実行し、マウスと TAB キーの両方を使用して、各要素に到達します。  \[検査\] ウィンドウの名前、状態、ロール、場所、および値のフィールドに表示される情報が UI 内の各オブジェクトについて、ユーザーにとって意味があることを確認します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md b/docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md
new file mode 100644
index 00000000000..2182a447aef
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md
@@ -0,0 +1,126 @@
+---
+title: "チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ElementHost コントロール"
+  - "ホスト (Windows フォームの WPF コンテンツを)"
+  - "相互運用性, WPF と Windows フォーム"
+  - "WPF コンテンツ, ホスト (Windows フォームで)"
+  - "WPF ユーザー コントロール, ホスト (Windows フォームで)"
+ms.assetid: 2e92d8e8-f0e4-4df7-9f07-2acf35cd798c
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成
+このトピックでは、Windows フォーム ベースのアプリケーションで使用する Windows Presentation Foundation \(WPF\) コントロールを作成する方法を示します。  
+  
+ このチュートリアルでは次のタスクを実行します。  
+  
+-   プロジェクトを作成する。  
+  
+-   新しい WPF コントロールを作成する。  
+  
+-   新しい WPF コントロールを Windows フォームに追加する。  WPF コントロールは <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)].  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `HostingWpf` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## 新しい WPF コントロールの作成  
+ 新しい WPF コントロールを作成し、プロジェクトに追加するのは、プロジェクトへの他の項目の追加と同じくらい簡単です。  Windows フォーム デザイナーは、*複合コントロール*、または*ユーザー コントロール*という名前の特定の種類のコントロールと連携します。  WPF ユーザー コントロールの詳細については、「<xref:System.Windows.Controls.UserControl>」を参照してください。  
+  
+> [!NOTE]
+>  WPF の <xref:System.Windows.Controls.UserControl?displayProperty=fullName> の種類は、同じ <xref:System.Windows.Forms.UserControl?displayProperty=fullName> という名前を持つ、Windows フォームで提供されるユーザー コントロールの種類とは区別されます。  
+  
+#### 新しい WPF コントロールを作成するには  
+  
+1.  **ソリューション エクスプローラー**で、新しい **WPF ユーザー コントロール ライブラリ** プロジェクトをソリューションに追加します。  このコントロール ライブラリの既定の名前である `WpfControlLibrary1` を使用します。  既定のコントロールの名前は `UserControl1.xaml` です。  
+  
+     新しいコントロールを追加すると次の影響があります。  
+  
+    -   ファイル UserControl1.xaml が追加されます。  
+  
+    -   ファイル UserControl1.xaml.cs または UserControl1.xaml.vb のいずれかが追加されます。  このファイルには、イベント ハンドラーとその他の実装のための分離コードが含まれています。  
+  
+    -   WPF アセンブリへの参照が追加されます。  
+  
+    -   ファイル UserControl1.xaml が [!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] で開きます。  
+  
+2.  デザイン ビューで `UserControl1` が選択されていることを確認します。  詳細については、「[方法 : デザイン画面上で要素を選択して移動する](http://msdn.microsoft.com/ja-jp/54cb70b6-b35b-46e4-a0cc-65189399c474)」を参照してください。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+4.  **\[ツールボックス\]**から、<xref:System.Windows.Controls.TextBox?displayProperty=fullName> コントロールをデザイン画面にドラッグします。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティの値を \[ホストするコンテンツ\] に設定します。  
+  
+    > [!NOTE]
+    >  一般的には、もう少し高度な WPF コンテンツをホストしてください。  ここでは、説明する目的でのみ <xref:System.Windows.Controls.TextBox?displayProperty=fullName> コントロールを使用しています。  
+  
+6.  プロジェクトをビルドします。  
+  
+## WPF コントロールを Windows フォームに追加する  
+ 新しい WPF コントロールは、フォームで使用可能な状態です。  Windows フォームは、<xref:System.Windows.Forms.Integration.ElementHost> コントロールを使用して、WPF コンテンツをホストします。  
+  
+#### WPF コントロールを Windows フォームに追加するには  
+  
+1.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+2.  **ツールボックス**で、**\[WPFUserControlLibrary WPF ユーザー コントロール\]** というラベルの付いたタブを探します。  
+  
+3.  `UserControl1` のインスタンスをフォームにドラッグします。  
+  
+    -   WPF コントロールをホストするためのフォームの上に、<xref:System.Windows.Forms.Integration.ElementHost> コントロールが自動的に作成されます。  
+  
+    -   <xref:System.Windows.Forms.Integration.ElementHost> コントロールに `elementHost1` という名前が付き、**\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Integration.ElementHost.Child%2A> プロパティが **UserControl1** に設定されていることが確認できます。  
+  
+    -   WPF アセンブリへの参照がプロジェクトに追加されます。  
+  
+    -   `elementHost1` コントロールに、使用可能なホスティング オプションを示すスマート タグ パネルがあります。  
+  
+4.  **ElementHost タスク**のスマート タグ パネルで、**\[親コンテナーにドッキング\]** を選択します。  
+  
+5.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 次の手順  
+ Windows フォームと WPF は異なるテクノロジですが、密接に相互運用するよう設計されています。  アプリケーションに高度な外観と動作を提供するには、次の手順を実行します。  
+  
+-   WPF ページで Windows フォーム コントロールをホストします。  詳細については、「[チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)」を参照してください。  
+  
+-   WPF コンテンツに Windows フォームの視覚スタイルを適用します。  詳細については、「[方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md)」を参照してください。  
+  
+-   WPF コンテンツのスタイルを変更します。  詳細については、「[チュートリアル: WPF コンテンツへのスタイルの適用](../../../../docs/framework/winforms/advanced/walkthrough-styling-wpf-content.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-demonstrating-visual-inheritance.md b/docs/framework/winforms/advanced/walkthrough-demonstrating-visual-inheritance.md
new file mode 100644
index 00000000000..4de5bb5eeac
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-demonstrating-visual-inheritance.md
@@ -0,0 +1,175 @@
+---
+title: "チュートリアル : ビジュアル継承のデモンストレーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォームの継承, チュートリアル"
+  - "継承, チュートリアル"
+  - "ビジュアルな継承"
+  - "チュートリアル [Windows フォーム], ビジュアルな継承"
+  - "Windows フォーム, 継承"
+ms.assetid: 01966086-3142-450e-8210-3fd4cb33f591
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# チュートリアル : ビジュアル継承のデモンストレーション
+ビジュアル継承により、基本フォームのコントロールを表示して、新しいコントロールを追加できます。  このチュートリアルでは、基本フォームを作成してクラス ライブラリにコンパイルします。  このクラス ライブラリを別のプロジェクトにインポートして、基本フォームから継承する新しいフォームを作成します。  このチュートリアルでは、次の作業を行う方法について説明します。  
+  
+-   基本フォームを含むクラス ライブラリ プロジェクトを作成します。  
+  
+-   基本フォームの派生クラスが変更できるプロパティを持つボタンを追加します。  
+  
+-   基本フォームの継承元により変更できないボタンを追加します。  
+  
+-   `BaseForm` から継承したフォームを含むプロジェクトを作成します。  
+  
+ 最終的には、このチュートリアルでは、継承されたフォーム上のプライベート コントロールとプロテクト コントロールの違いを示します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+> [!CAUTION]
+>  すべてのコントロールが基本フォームのビジュアル継承をサポートするわけではありません。  次のコントロールでは、このチュートリアルで説明するシナリオはサポートされません。  
+>   
+>  <xref:System.Windows.Forms.WebBrowser>  
+>   
+>  <xref:System.Windows.Forms.ToolStrip>  
+>   
+>  <xref:System.Windows.Forms.ToolStripPanel>  
+>   
+>  <xref:System.Windows.Forms.TableLayoutPanel>  
+>   
+>  <xref:System.Windows.Forms.FlowLayoutPanel>  
+>   
+>  <xref:System.Windows.Forms.DataGridView>  
+>   
+>  継承されたフォームのこれらのコントロールは、使用する修飾子 \(`private`、`protected`、または `public`\) に関係なく、常に読み取り専用です。  
+  
+## シナリオの手順  
+ 最初の手順では、基本フォームを作成します。  
+  
+#### 基本フォームを含むクラス ライブラリ プロジェクトを作成するには  
+  
+1.  **\[ファイル\]** メニューから **\[新規作成\]** を選択し、**\[プロジェクト…\]** を選択します。**\[新しいプロジェクト\]** ダイアログ ボックスが表示されます。  
+  
+2.  `BaseFormLibrary` という名前の Windows フォーム アプリケーションを作成します。  
+  
+3.  標準の Windows フォーム アプリケーションではなく、クラス ライブラリを作成するには、**ソリューション エクスプローラー**で、**BaseFormLibrary** プロジェクト ノードを右クリックして、**\[プロパティ\]** を選択します。  
+  
+4.  プロジェクトのプロパティで、**\[出力の種類\]** を **\[Windows アプリケーション\]** から **\[クラス ライブラリ\]** に変更します。  
+  
+5.  **\[ファイル\]** メニューから、**\[すべてを保存\]** を選択して、プロジェクトおよびファイルを既定の場所に保存します。  
+  
+ 次の 2 つの手順では、基本フォームにボタンを追加します。  ビジュアル継承を示すには、`Modifiers` プロパティを設定して、ボタンに異なるアクセス レベルを付与します。  
+  
+#### 基本フォームの継承クラスから変更が可能なボタンを追加するには  
+  
+1.  デザイナーで **Form1** を開きます。  
+  
+2.  **ツールボックス**の **\[すべての Windows フォーム\]** タブで、**\[ボタン\]** をダブルクリックしてフォームにボタンを追加します。  マウスを使用し、ボタンを配置してサイズを変更します。  
+  
+3.  \[プロパティ\] ウィンドウで、ボタンの次のプロパティを設定します。  
+  
+    -   **Text** プロパティを **Say Hello** に設定します。  
+  
+    -   **\(Name\)** プロパティを **btnProtected** に設定します。  
+  
+    -   **Modifiers** プロパティを **Protected** に設定します。  これにより、**Form1** から継承するフォームが、**btnProtected** のプロパティを変更できるようになります。  
+  
+4.  **\[Say Hello\]** ボタンをダブルクリックして、**クリック** イベントのイベント ハンドラーを追加します。  
+  
+5.  イベント ハンドラーに次のコードを追加します。  
+  
+    ```vb  
+    MessageBox.Show("Hello, World!")  
+    ```  
+  
+    ```csharp  
+    MessageBox.Show("Hello, World!");  
+    ```  
+  
+#### 基本フォームの継承元により変更できないボタンを追加するには  
+  
+1.  コード エディターの上にある **Form1.vb の \[デザイン\]、Form1.cs の \[デザイン\]、または Form1.jsl の \[デザイン\]** タブをクリックするか、F7 を押して、デザイン ビューに切り替えます。  
+  
+2.  2 番目のボタンを追加し、そのプロパティを次のように設定します。  
+  
+    -   **Text** プロパティを **Say Goodbye** に設定します。  
+  
+    -   **\(Name\)** プロパティを **btnPrivate** に設定します。  
+  
+    -   **Modifiers** プロパティを **Private** に設定します。  これにより、**Form1** から継承するフォームが、**btnPrivate** のプロパティを変更できなくなります。  
+  
+3.  **\[Say Goodbye\]** ボタンをダブルクリックして、**クリック** イベントのイベント ハンドラーを追加します。  イベントの手順で、次のコード行を配置します。  
+  
+    ```vb  
+    MessageBox.Show("Goodbye!")  
+    ```  
+  
+    ```csharp  
+    MessageBox.Show("Goodbye!");  
+    ```  
+  
+4.  **\[ビルド\]** メニューから、**\[BaseForm ライブラリのビルド\]** を選択してクラス ライブラリをビルドします。  
+  
+     ライブラリがビルドされたら、作成したフォームから継承する新しいプロジェクトを作成できます。  
+  
+#### 基本フォームから継承したフォームを含むプロジェクトを作成するには  
+  
+1.  **\[ファイル\]** メニューから **\[追加\]** を選択し、**\[新しいプロジェクト\]** を選択します。**\[新しいプロジェクトの追加\]** ダイアログ ボックスが表示されます。  
+  
+2.  `InheritanceTest` という名前の Windows フォーム アプリケーションを作成します。  
+  
+#### 継承されたフォームを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**InheritanceTest** プロジェクトを右クリックし、**\[追加\]** を選択して、**\[新しいアイテム\]** を選択します。  
+  
+2.  **\[新しいアイテムの追加\]** ダイアログ ボックスで、**\[Windows フォーム\]** カテゴリを選択して \(カテゴリのリストがある場合\)、**\[継承されたフォーム\]** テンプレートを選択します。  
+  
+3.  名前を既定の `Form2` のままにして、**\[追加\]** をクリックします。  
+  
+4.  **\[継承ピッカー\]** ダイアログ ボックスで、継承元のフォームとして、**BaseFormLibrary** プロジェクトから **Form1** を選択し、**\[OK\]** をクリックします。  
+  
+     これで、**InheritanceTest** プロジェクトに**BaseFormLibrary** のフォームから派生したフォームが作成されます。  
+  
+5.  デザイナーで継承されたフォーム \(**Form2**\) がまだ開いていない場合は、ダブルクリックして開きます。  
+  
+     デザイナーで、継承されたボタンには、上の隅に継承されたことを示すシンボル \(![VisualBasicInheritanceSymbol スクリーンショット](../../../../docs/framework/winforms/advanced/media/vbinheritanceglyph.png "vbInheritanceGlyph")\) があります。  
+  
+6.  **\[Say Hello\]** ボタンを選択して、サイズ変更ハンドルを確認します。  このボタンは保護されているため、継承元が、移動、サイズ変更、キャプションの変更、およびその他の変更を実行できます。  
+  
+7.  プライベートの **\[Say Goodbye\]** ボタンを選択して、サイズ変更ハンドルがないことを確認します。  また、**\[プロパティ\]** ウィンドウでは、このボタンのプロパティが、変更できないことを示すグレー表示になっています。  
+  
+8.  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] を使用している場合:  
+  
+    1.  **ソリューション エクスプローラー**で、**InheritanceTest** プロジェクトの **Form1** を右クリックして、**\[削除\]** を選択します。  表示されたメッセージ ボックスで、**\[OK\]** をクリックして削除を確認します。  
+  
+    2.  Program.cs ファイルを開き、行 `Application.Run(new Form1());` を `Application.Run(new Form2());` に変更します。  
+  
+9. **ソリューション エクスプローラー**で **InheritanceTest** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** を選択します。  
+  
+10. **ソリューション エクスプローラー**で **InheritanceTest** プロジェクトを右クリックし、**\[プロパティ\]** を選択します。  
+  
+11. **InheritanceTest** プロパティ ページで、**スタートアップ オブジェクト** を継承されたたフォームに設定します \(**Form2**\)。  
+  
+12. F5 を押してアプリケーションを実行し、継承されたフォームの動作を確認します。  
+  
+## 次の手順  
+ ユーザー コントロールの継承はほぼ同じ方法で機能します。  新しいクラス ライブラリ プロジェクトを開き、ユーザー コントロールを追加します。  内在コントロールを配置し、プロジェクトをコンパイルします。  別の新しいクラス ライブラリ プロジェクトを開き、コンパイル済みのクラス ライブラリへの参照を追加します。  また、継承されたコントロールを、**継承ピッカー** を使用して \(**\[新しいアイテムの追加\]** ダイアログ ボックスから\) プロジェクトに追加してみます。  ユーザー コントロールを追加し、`Inherits` \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] の`:`\) ステートメントを変更します。  詳細については、「[方法 : Windows フォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ [方法 : Windows フォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-windows-forms.md)   
+ [Windows フォームのビジュアルの継承](../../../../docs/framework/winforms/advanced/windows-forms-visual-inheritance.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md b/docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md
new file mode 100644
index 00000000000..213f346a4c9
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md
@@ -0,0 +1,124 @@
+---
+title: "チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ, Windows フォーム"
+  - "Windows フォーム, ドラッグ アンド ドロップ操作"
+ms.assetid: eb66f6bf-4a7d-4c2d-b276-40fefb2d3b6c
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行
+Windows ベースのアプリケーション内でドラッグ アンド ドロップ操作を実行するには、<xref:System.Windows.Forms.Control.DragEnter>、<xref:System.Windows.Forms.Control.DragLeave>、<xref:System.Windows.Forms.Control.DragDrop> などの一連のイベントを処理する必要があります。  これらのイベントのイベント引数で提供される情報を使用することにより、ドラッグ アンド ドロップ操作を簡単に実現できます。  
+  
+## データのドラッグ  
+ すべてのドラッグ アンド ドロップ操作は、ドラッグから始まります。  ドラッグが開始されたときにデータを収集できるようにする機能は、<xref:System.Windows.Forms.Control.DoDragDrop%2A> メソッドに実装されています。  
+  
+ 次の例では、最も直観的な <xref:System.Windows.Forms.Control.MouseDown> イベントを使用してドラッグ操作を開始しています。これは、ほとんどのドラッグ アンド ドロップ操作は、マウス ボタンが押されることによって開始されるためです。  ただし、ドラッグ アンド ドロップの手順は任意のイベントを使用して開始できます。  
+  
+> [!NOTE]
+>  ドラッグに関するカスタム イベントのあるコントロールもあります。  たとえば、<xref:System.Windows.Forms.ListView> コントロールと <xref:System.Windows.Forms.TreeView> コントロールには、<xref:System.Windows.Forms.TreeView.ItemDrag> イベントがあります。  
+  
+#### ドラッグ操作を開始するには  
+  
+1.  ドラッグが  開始されるコントロールの <xref:System.Windows.Forms.Control.MouseDown> のイベントでドラッグされるデータを設定するに `DoDragDrop` のメソッドを使用して実行できる処理のドラッグがあります。  詳細については、「<xref:System.Windows.Forms.DragEventArgs.Data%2A>」および「<xref:System.Windows.Forms.DragEventArgs.AllowedEffect%2A>」を参照してください。  
+  
+     ドラッグ操作を開始する方法の例を次に示します。  ドラッグが開始されるコントロールは <xref:System.Windows.Forms.Button> コントロール、ドラッグされるデータは、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティを表す文字列、実行できる処理はコピーまたは移動のいずれかです。  
+  
+    ```vb  
+    Private Sub Button1_MouseDown(ByVal sender As Object, ByVal e As System.Windows.Forms.MouseEventArgs) Handles Button1.MouseDown  
+       Button1.DoDragDrop(Button1.Text, DragDropEffects.Copy Or DragDropEffects.Move)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_MouseDown(object sender,   
+    System.Windows.Forms.MouseEventArgs e)  
+    {  
+       button1.DoDragDrop(button1.Text, DragDropEffects.Copy |   
+          DragDropEffects.Move);  
+    }  
+  
+    ```  
+  
+    > [!NOTE]
+    >  `DoDragDrop` メソッドでは、任意のデータをパラメーターとして使用できます。上の例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティがドラッグの開始位置 \(<xref:System.Windows.Forms.Button> コントロール\) に関連するため、値をハードコーディングしたり、データセットからデータを取得したりせずに、このプロパティを使用しています。  Windows ベースのアプリケーションにドラッグ アンド ドロップ操作を組み込む場合には、この点を考慮してください。  
+  
+ ドラッグ操作が行われている間、<xref:System.Windows.Forms.Control.QueryContinueDrag> イベントを処理できます。これは、ドラッグ操作を続けてよいかどうかシステムの "許可を得る" イベントです。  このメソッドを処理するときは、たとえば、カーソルが置かれたときに <xref:System.Windows.Forms.TreeView> コントロールの <xref:System.Windows.Forms.TreeNode> を展開するなど、ドラッグ操作に影響するメソッドを呼び出すのにも適しています。  
+  
+## データのドロップ  
+ Windows フォームまたはコントロール上の場所からデータのドラッグを開始したら、それをどこかにドロップする必要があります。  データをドロップできるように正しく設定されているフォームまたはコントロールの領域をカーソルが横切ると、カーソルの形が変わります。  <xref:System.Windows.Forms.Control.AllowDrop%2A> プロパティを設定し、<xref:System.Windows.Forms.Control.DragEnter> イベントと <xref:System.Windows.Forms.Control.DragDrop> イベントを処理することにより、Windows フォームまたはコントロール内の任意の領域で、ドロップされたデータを受け入れることができます。  
+  
+#### ドロップを実行するには  
+  
+1.  <xref:System.Windows.Forms.Control.AllowDrop%2A> プロパティを true に設定します。  
+  
+2.  ドロップ先のコントロールの `DragEnter` イベントで、ドラッグされるデータが適切な型 \(この場合、<xref:System.Windows.Forms.Control.Text%2A>\) であることを確認します。  次に、コードでは、ドロップしたときの効果を <xref:System.Windows.Forms.DragDropEffects> 列挙定数の値に設定します。  詳細については、「<xref:System.Windows.Forms.DragEventArgs.Effect%2A>」を参照してください。  
+  
+    ```vb  
+    Private Sub TextBox1_DragEnter(ByVal sender As Object, ByVal e As System.Windows.Forms.DragEventArgs) Handles TextBox1.DragEnter  
+       If (e.Data.GetDataPresent(DataFormats.Text)) Then  
+         e.Effect = DragDropEffects.Copy  
+       Else  
+         e.Effect = DragDropEffects.None  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void textBox1_DragEnter(object sender,   
+    System.Windows.Forms.DragEventArgs e)  
+    {  
+       if (e.Data.GetDataPresent(DataFormats.Text))   
+          e.Effect = DragDropEffects.Copy;  
+       else  
+          e.Effect = DragDropEffects.None;  
+    }  
+  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.DataObject.SetData%2A> メソッドの <xref:System.Object> パラメーターとして独自のオブジェクトを指定することで、固有の <xref:System.Windows.Forms.DataFormats> を定義できます。  その場合は、指定するオブジェクトがシリアル化できるオブジェクトであることを確認してください。  詳細については、「[ISerializable インターフェイス](frlrfSystemRuntimeSerializationISerializableClassTopic)」を参照してください。  
+  
+3.  ドロップ先のコントロールの <xref:System.Windows.Forms.Control.DragDrop> イベントで、<xref:System.Windows.Forms.DataObject.GetData%2A> メソッドを使用して、ドラッグされるデータを取得します。  詳細については、「[DtaObject.Data プロパティ](frlrfSystemSecurityCryptographyXmlDataObjectClassDataTopic)」を参照してください。  
+  
+     次の例では、データがドロップされるドラッグ先のコントロールは <xref:System.Windows.Forms.TextBox> コントロールです。  コードでは、<xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティをドラッグされたデータと同じ内容に設定します。  
+  
+    ```vb  
+    Private Sub TextBox1_DragDrop(ByVal sender As Object, ByVal e As System.Windows.Forms.DragEventArgs) Handles TextBox1.DragDrop  
+       TextBox1.Text = e.Data.GetData(DataFormats.Text).ToString  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void textBox1_DragDrop(object sender,   
+    System.Windows.Forms.DragEventArgs e)  
+    {  
+       textBox1.Text = e.Data.GetData(DataFormats.Text).ToString();  
+    }  
+  
+    ```  
+  
+    > [!NOTE]
+    >  さらに、<xref:System.Windows.Forms.DragEventArgs.KeyState%2A> プロパティを使用して、ドラッグ アンド ドロップ操作中に押されたキーに応じて特定の効果が得られるようにできます。たとえば一般的に、Ctrl キーを押しながらドラッグしたデータはコピーされます。  
+  
+## 参照  
+ [方法 : クリップボードにデータを追加する](../../../../docs/framework/winforms/advanced/how-to-add-data-to-the-clipboard.md)   
+ [方法 : クリップボードからデータを取得する](../../../../docs/framework/winforms/advanced/how-to-retrieve-data-from-the-clipboard.md)   
+ [ドラッグ アンド ドロップ操作とクリップボードのサポート](../../../../docs/framework/winforms/advanced/drag-and-drop-operations-and-clipboard-support.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/walkthrough-styling-wpf-content.md b/docs/framework/winforms/advanced/walkthrough-styling-wpf-content.md
new file mode 100644
index 00000000000..dfeb4726024
--- /dev/null
+++ b/docs/framework/winforms/advanced/walkthrough-styling-wpf-content.md
@@ -0,0 +1,168 @@
+---
+title: "チュートリアル: WPF コンテンツへのスタイルの適用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "相互運用性 [WDF]"
+  - "スタイル, WPF コンテンツ"
+  - "WPF デザイナー, スタイル設定 (WPF コンテンツを)"
+ms.assetid: e574aac7-7ea4-4cdb-8034-bab541f000df
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# チュートリアル: WPF コンテンツへのスタイルの適用
+このチュートリアルでは、Windows フォームでホストされている Windows Presentation Foundation \(WPF\) コントロールにスタイルを適用する方法について説明します。  
+  
+ このチュートリアルでは次のタスクを行います。  
+  
+-   プロジェクトを作成します。  
+  
+-   WPF コントロール型を作成します。  
+  
+-   WPF コントロールにスタイルを適用します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)]。  
+  
+## プロジェクトの作成  
+ まず、Windows フォーム プロジェクトを作成します。  
+  
+> [!NOTE]
+>  WPF コンテンツをホストする場合は、C\# プロジェクトと Visual Basic プロジェクトのみがサポートされます。  
+  
+#### プロジェクトを作成するには  
+  
+-   `StylingWpfContent` という名前の新しい Windows フォーム アプリケーション プロジェクトを Visual Basic または Visual C\# で作成します。  
+  
+## WPF コントロール型の作成  
+ プロジェクトに追加した WPF コントロール型は、<xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストできます。  
+  
+#### WPF コントロール型を作成するには  
+  
+1.  新しい WPF <xref:System.Windows.Controls.UserControl> プロジェクトをソリューションに追加します。  名前はこのコントロール型の既定である `UserControl1.xaml` を使用します。  詳細については、「[チュートリアル: デザイン時の Windows フォームでの新しい WPF コンテンツの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-new-wpf-content-on-windows-forms-at-design-time.md)」を参照してください。  
+  
+2.  デザイン ビューで `UserControl1` が選択されていることを確認します。  詳細については、「[方法 : デザイン画面上で要素を選択して移動する](http://msdn.microsoft.com/ja-jp/54cb70b6-b35b-46e4-a0cc-65189399c474)」を参照してください。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.FrameworkElement.Width%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Height%2A> プロパティの値を `200` に設定します。  
+  
+4.  <xref:System.Windows.Controls.Button?displayProperty=fullName> コントロールを <xref:System.Windows.Controls.UserControl> に追加し、<xref:System.Windows.Controls.ContentControl.Content%2A> プロパティの値を「Cancel」に設定します。  
+  
+5.  2 つ目の<xref:System.Windows.Controls.Button?displayProperty=fullName> コントロールを <xref:System.Windows.Controls.UserControl> に追加し、<xref:System.Windows.Controls.ContentControl.Content%2A> プロパティの値を「OK」に設定します。  
+  
+6.  プロジェクトをビルドします。  
+  
+## WPF コントロールへのスタイルの適用  
+ さまざまなスタイルを WPF コントロールに適用することで、外観や動作を変えることができます。  
+  
+#### WPF コントロールにスタイルを適用するには  
+  
+1.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+2.  **\[ツールボックス\]** で `UserControl1` をダブルクリックして、フォーム上に `UserControl1` のインスタンスを作成します。  
+  
+     `UserControl1` のインスタンスは、`elementHost1` という名前の新しい <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされます。  
+  
+3.  `elementHost1` のスマート タグ パネルで、ドロップダウン リストから \[**ホストするコンテンツの編集**\] をクリックします。  
+  
+     `UserControl1` が [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)] で開きます。  
+  
+4.  XAML ビューで、次の XAML を `<UserControl>` の開始タグの後に挿入します。  
+  
+     この XAML は、明暗のあるグラデーション境界を持つグラデーションを作成します。  このコントロールをクリックすると、グラデーションが変わり、ボタンを押したような外観が生成されます。  詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+```xaml  
+<UserControl.Resources>  
+    <LinearGradientBrush x:Key="NormalBrush" EndPoint="0,1" StartPoint="0,0">  
+        <GradientStop Color="#FFF" Offset="0.0"/>  
+        <GradientStop Color="#CCC" Offset="1.0"/>  
+    </LinearGradientBrush>  
+    <LinearGradientBrush x:Key="PressedBrush" EndPoint="0,1" StartPoint="0,0">  
+        <GradientStop Color="#BBB" Offset="0.0"/>  
+        <GradientStop Color="#EEE" Offset="0.1"/>  
+        <GradientStop Color="#EEE" Offset="0.9"/>  
+        <GradientStop Color="#FFF" Offset="1.0"/>  
+    </LinearGradientBrush>  
+    <LinearGradientBrush x:Key="NormalBorderBrush" EndPoint="0,1" StartPoint="0,0">  
+        <GradientStop Color="#CCC" Offset="0.0"/>  
+        <GradientStop Color="#444" Offset="1.0"/>  
+    </LinearGradientBrush>  
+    <LinearGradientBrush x:Key="BorderBrush" EndPoint="0,1" StartPoint="0,0">  
+        <GradientStop Color="#CCC" Offset="0.0"/>  
+        <GradientStop Color="#444" Offset="1.0"/>  
+    </LinearGradientBrush>  
+    <LinearGradientBrush x:Key="PressedBorderBrush" EndPoint="0,1" StartPoint="0,0">  
+        <GradientStop Color="#444" Offset="0.0"/>  
+        <GradientStop Color="#888" Offset="1.0"/>  
+    </LinearGradientBrush>  
+  
+    <Style x:Key="SimpleButton" TargetType="{x:Type Button}" BasedOn="{x:Null}">  
+        <Setter Property="Background" Value="{StaticResource NormalBrush}"/>  
+        <Setter Property="BorderBrush" Value="{StaticResource NormalBorderBrush}"/>  
+        <Setter Property="Template">  
+            <Setter.Value>  
+                <ControlTemplate TargetType="{x:Type Button}">  
+                    <Grid x:Name="Grid">  
+                        <Border x:Name="Border" Background="{TemplateBinding Background}" BorderBrush="{TemplateBinding BorderBrush}" BorderThickness="{TemplateBinding BorderThickness}" Padding="{TemplateBinding Padding}"/>  
+                        <ContentPresenter HorizontalAlignment="{TemplateBinding HorizontalContentAlignment}" Margin="{TemplateBinding Padding}" VerticalAlignment="{TemplateBinding VerticalContentAlignment}" RecognizesAccessKey="True"/>  
+                    </Grid>  
+                    <ControlTemplate.Triggers>  
+                        <Trigger Property="IsPressed" Value="true">  
+                            <Setter Property="Background" Value="{StaticResource PressedBrush}" TargetName="Border"/>  
+                            <Setter Property="BorderBrush" Value="{StaticResource PressedBorderBrush}" TargetName="Border"/>  
+                        </Trigger>  
+                    </ControlTemplate.Triggers>  
+                </ControlTemplate>  
+            </Setter.Value>  
+        </Setter>  
+    </Style>  
+</UserControl.Resources>  
+```  
+  
+1.  \[Cancel\] ボタンの `<Button>` タグに次の XAML を挿入することで、前の手順で定義した `SimpleButton` スタイルを \[Cancel\] ボタンに適用します。  
+  
+    ```  
+    Style="{StaticResource SimpleButton}  
+    ```  
+  
+     ボタン宣言は次の XAML のようになります。  
+  
+```xaml  
+<Button Height="23" Margin="41,52,98,0" Name="button1" VerticalAlignment="Top"  
+                Style="{StaticResource SimpleButton}">Cancel</Button>  
+```  
+  
+1.  プロジェクトをビルドします。  
+  
+2.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+3.  新しいスタイルが Button コントロールに適用されます。  
+  
+4.  **\[デバッグ\]** メニューから **\[デバッグ開始\]** を選択して、アプリケーションを実行します。  
+  
+5.  \[OK\] ボタンと \[Cancel\] ボタンをクリックして、違いを確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)   
+ [WPF コントロールの使用](../../../../docs/framework/winforms/advanced/using-wpf-controls.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/why-transformation-order-is-significant.md b/docs/framework/winforms/advanced/why-transformation-order-is-significant.md
new file mode 100644
index 00000000000..9d3b2e48bb2
--- /dev/null
+++ b/docs/framework/winforms/advanced/why-transformation-order-is-significant.md
@@ -0,0 +1,51 @@
+---
+title: "変換順序が重要となる理由 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "変換, 順序の重要性"
+ms.assetid: 37d5f9dc-a5cf-4475-aa5d-34d714e808a9
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 変換順序が重要となる理由
+1 つの <xref:System.Drawing.Drawing2D.Matrix> オブジェクトに格納できるのは、1 つの変換または連続する複数の変換です。  後者を複合変換と呼びます。  複合変換の行列は、個々の変換の行列を掛け合わせることによって得られます。  
+  
+## 複合変換の例  
+ 複合変換では、個々の変換が行われる順序が重要となります。  たとえば、最初に回転し、スケーリングし、平行移動する場合と、最初に平行移動し、回転し、スケーリングする場合とでは結果が異なります。  [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] では、複合変換は左から右に行われます。  S がスケール行列、R が回転行列、T が平行移動行列である場合、その積である SRT \(そのままの順序\) は、最初にスケーリングし、回転し、平行移動する複合変換の行列となります。  積 SRT によって生成される行列は、積 TRS によって生成される行列と異なります。  
+  
+ 実行順序が重要となる理由の 1 つとして、回転やスケーリングなどの変換が座標系の原点を基準にして行われるという点が挙げられます。  原点を中心とするオブジェクトをスケーリングする場合と、原点から離れているオブジェクトをスケーリングする場合とでは、結果が異なります。  同様に、原点を中心とするオブジェクトを回転する場合と、原点から離れているオブジェクトを回転する場合とでも、その結果は異なります。  
+  
+ スケーリング、回転、および平行移動をこの順序で組み合わせて実行される複合変換を次の例に示します。  <xref:System.Drawing.Graphics.RotateTransform%2A> メソッドに渡される引数 <xref:System.Drawing.Drawing2D.MatrixOrder> は、スケーリングの後に回転が続くことを示します。  同様に、<xref:System.Drawing.Graphics.TranslateTransform%2A> メソッドに渡される引数 <xref:System.Drawing.Drawing2D.MatrixOrder> は、回転の後に平行移動が続くことを示します。  <xref:System.Drawing.Drawing2D.MatrixOrder> および <xref:System.Drawing.Drawing2D.MatrixOrder> は、<xref:System.Drawing.Drawing2D.MatrixOrder> 列挙体のメンバーです。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#21)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#21)]  
+  
+ 次の例は、上の例と同じメソッドを呼び出していますが、呼び出しの順序が逆になっています。  操作は最初に平行移動し、回転し、スケーリングするという順序になり、最初にスケーリングし、回転し、平行移動する場合とは、結果が大きく異なります。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#22)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#22)]  
+  
+ 複合変換の個々の変換の順序を逆にする方法の 1 つとして、連続する複数のメソッドの呼び出し順序を反転させる方法があります。  操作の順序を制御する 2 番目の方法として、行列の順序引数を変更する方法もあります。  次の例は、<xref:System.Drawing.Drawing2D.MatrixOrder> が <xref:System.Drawing.Drawing2D.MatrixOrder> に変更されている点を除いて上の例と同じです。  行列の掛け合わせは SRT の順序で行われます。この場合、S、R、T は、それぞれスケール、回転、平行移動の行列です。  複合変換の順序は、最初がスケーリング、次が回転、最後が平行移動となります。  
+  
+ [!code-csharp[System.Drawing.MiscLegacyTopics#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/CS/Class1.cs#23)]
+ [!code-vb[System.Drawing.MiscLegacyTopics#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.MiscLegacyTopics/VB/Class1.vb#23)]  
+  
+ 直前の例の結果は、このトピックの最初の例の結果と同じになります。  それは、メソッドの呼び出し順序も、行列の掛け合わせ順序も両方とも反転させたためです。  
+  
+## 参照  
+ <xref:System.Drawing.Drawing2D.Matrix>   
+ [座標系と変換](../../../../docs/framework/winforms/advanced/coordinate-systems-and-transformations.md)   
+ [マネージ GDI\+ での変換の使用](../../../../docs/framework/winforms/advanced/using-transformations-in-managed-gdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/windows-forms-accessibility.md b/docs/framework/winforms/advanced/windows-forms-accessibility.md
new file mode 100644
index 00000000000..f8301980950
--- /dev/null
+++ b/docs/framework/winforms/advanced/windows-forms-accessibility.md
@@ -0,0 +1,43 @@
+---
+title: "Windows フォームのユーザー補助 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム コントロール、アクセシビリティ"
+  - "アクセシビリティ、Windows フォーム コントロール"
+ms.assetid: 23a3f168-ebc0-4f23-9efc-799109aa4a2d
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# Windows フォームのユーザー補助
+Windows フォームのアクセシビリティ機能により、さまざまなユーザーがアプリケーションを使用できるようにすることができます。  
+  
+## このセクションの内容  
+ [チュートリアル : ユーザー補助対応の Windows ベースのアプリケーションの作成](../../../../docs/framework/winforms/advanced/walkthrough-creating-an-accessible-windows-based-application.md)  
+ アクセシビリティを強化するためにサポートする必要があるすべての機能について説明します。  
+  
+## 関連項目  
+ <xref:Accessibility>  
+ アクセシビリティと関係のあるクラスを数多く含む名前空間。  
+  
+ <xref:System.Windows.Forms.AccessibleObject>  
+ 障碍を持つユーザーに合わせてアプリケーションのユーザー インターフェイス \(UI\) を調整するため、ユーザー補助対応アプリケーションで使用される情報を提供します。  
+  
+## 関連項目  
+ [Windows フォーム上のコントロールのユーザー補助情報の提供](../../../../docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md)  
+ 障碍を持つユーザーを支援するために Windows フォーム コントロールで使用できる情報の提供方法について説明します。  
+  
+ [Windows フォームにおける自動スケーリング](../../../../docs/framework/winforms/automatic-scaling-in-windows-forms.md)  
+ Windows フォーム アプリケーションをシステム フォントのサイズ変更に対応させる方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications-overview.md b/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications-overview.md
new file mode 100644
index 00000000000..4f80ff27c75
--- /dev/null
+++ b/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications-overview.md
@@ -0,0 +1,77 @@
+---
+title: "Windows フォームおよびアンマネージ アプリケーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "COM [Windows フォーム]"
+  - "Windows フォーム, アンマネージ"
+  - "COM 相互運用"
+  - "ActiveX コントロール [Windows フォーム], ActiveX コントロールの概要"
+  - "Windows フォーム, 相互運用"
+ms.assetid: 0a26d99d-8135-4895-8760-c9a2b5f67f14
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームおよびアンマネージ アプリケーションの概要
+Windows フォーム アプリケーションとコントロールは、いくつかの注意事項がありますが、アンマネージ アプリケーションと相互運用できます。 次のセクションでは、Windows フォーム アプリケーションとコントロールがサポートするシナリオと構成、および、サポートしないシナリオと構成について説明します。  
+  
+## Windows フォーム コントロールおよび ActiveX アプリケーション  
+ Microsoft Internet Explorer と Microsoft Foundation Classes \(MFC\) を除いて、Windows フォーム コントロールは、ActiveX コントロールをホストするように設計されたアプリケーションではサポートされません。 Visual Studio .NET 2003 より前のバージョンの Visual Studio からの ActiveX テスト コンテナーなど、ActiveX コントロールをホストできるその他のアプリケーションと開発ツールは、Windows Forms コントロールでサポートされるホストではありません。  
+  
+ これらの制約は、コンポーネント オブジェクト モデルの COM 相互運用機能を通じて、Windows フォーム コントロールの使用にも適用されます。 COM 呼び出し可能ラッパー \(CCW\) を通じた Windows フォーム コントロールの使用は、Internet Explorer でのみサポートされます。 COM 相互運用の詳細については、  
+  
+ [COM Interop](../Topic/COM%20Interop%20\(Visual%20Basic\).md)。  
+  
+ Windows フォーム コントロールのサポートをホストしている、使用できる ActiveX を次の表に示します。  
+  
+|Windows フォームのバージョン|Support|  
+|------------------------|-------------|  
+|.NET Framework version 1.0|Internet Explorer 5.01 以降のバージョン|  
+|.NET Framework version 1.1 以降|Internet Explorer 5.01 以降のバージョン<br /><br /> Microsoft Foundation Classes \(MFC\) 7.0 以降|  
+  
+## ActiveX コントロールとして Windows フォームのコンポーネントをホストする  
+ .NET Framework 1.1 では、MFC 7.0 以降のバージョンを含めるようサポートが拡張されました。 このサポートには、MFC 7.0 以降の ActiveX コントロール コンテナーと完全に互換性があるすべてのコンテナーが含まれています。  
+  
+ ただし、Windows フォーム コントロールの ActiveX コントロールとしての登録はサポートされません。 また、Windows フォーム コントロールの `com.ms.win32.Ole32.CoCreateInstance` メソッドの呼び出しはサポートされていません。 Windows フォーム コントロールのマネージ アクティベーションだけがサポートされます。 Windows フォーム コントロールを作成すると、ActiveX コントロールの場合と同様に MFC アプリケーションでホストできます。  
+  
+ アンマネージ アプリケーションで Windows フォーム コントロールを使用するには、アンマネージ CLR ホスティング API を使用して CLR をホストするか、C\+\+ interop 機能を使用する必要があります。 C\+\+ interop 機能の使用が、推奨されるソリューションです。  
+  
+## COM クライアント アプリケーションでの Windows フォーム  
+ Windows フォームを Visual Basic 6.0 アプリケーションや MFC アプリケーションなどの COM クライアント アプリケーションから開くと、フォームが予期しない動作をすることがあります。 たとえば、TAB キーを押した時に、フォーカスが 1 つのコントロールから別のコントロールに変更されません。 コマンド ボタンにフォーカスがあるときに ENTER キーを押すと、ボタンの <xref:System.Windows.Forms.Control.Click> イベントは発生しません。 また、キー ストロークやマウスのアクティビティで、予期しない動作が発生することもあります。  
+  
+ この動作は、Windows フォームが正常に動作するために必要なメッセージ ループ サポートを、アンマネージ アプリケーションが実装していないために発生します。 COM クライアント アプリケーションによって提供されるメッセージ ループは、Windows フォームのメッセージ ループと基本的に異なります。  
+  
+ アプリケーションのメッセージ ループは、スレッドのメッセージ キューのメッセージを取得して変換し、処理のためにアプリケーションに送信する内部プログラム ループです。 Windows フォームのメッセージ ループは、Visual Basic 6.0 アプリケーションや MFC アプリケーションなど、以前のアプリケーションが提供するメッセージ ループと同じアーキテクチャを持っていません。 メッセージ ループにポストされたウィンドウのメッセージは、Windows フォームの要求とは異なる処理を実行することがあります。 そのため、予期しない動作が発生する可能性があります。 一部のキーストロークの組み合わせ、一部のマウスのアクティビティが動作せず、一部のイベントが想定どおりに発生しないことがあります。  
+  
+## 相互運用性の問題の解決  
+ これらの問題は、<xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName> メソッドを使用して作成された [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] メッセージ ループでフォームを表示することで解決できます。  
+  
+ Windows フォームが COM クライアント アプリケーションから正しく動作するには、Windows フォームのメッセージ ループ上で実行する必要があります。 そのためには、次の方法のいずれかを使用します。  
+  
+-   <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用して、Windows フォームを表示します。 詳細については、「[方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md)」を参照してください。  
+  
+-   各 Windows フォームを新しいスレッドで表示します。 詳細については、「[方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)   
+ [COM Interop](../Topic/COM%20Interop%20\(Visual%20Basic\).md)   
+ [COM Interoperability in .NET Framework Applications](../Topic/COM%20Interoperability%20in%20.NET%20Framework%20Applications%20\(Visual%20Basic\).md)   
+ [COM Interoperability Samples](http://msdn.microsoft.com/ja-jp/09c38567-6380-4d70-848a-e896a4ca05f4)   
+ [Aximp.exe \(Windows フォーム ActiveX コントロール インポーター\)](../../../../docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md)   
+ [COM への .NET Framework コンポーネントの公開](../../../../docs/framework/interop/exposing-dotnet-components-to-com.md)   
+ [COM 用のアセンブリのパッケージ化](../../../../docs/framework/interop/packaging-an-assembly-for-com.md)   
+ [COM へのアセンブリの登録](../../../../docs/framework/interop/registering-assemblies-with-com.md)   
+ [方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md)   
+ [方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md b/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md
new file mode 100644
index 00000000000..9d6073def9a
--- /dev/null
+++ b/docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md
@@ -0,0 +1,54 @@
+---
+title: "Windows フォームとアンマネージ アプリケーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ActiveX コントロール [Windows フォーム]"
+  - "COM [Windows フォーム]"
+  - "COM 相互運用機能, Windows フォーム"
+  - "Windows フォーム, 相互運用"
+  - "Windows フォーム, アンマネージ"
+ms.assetid: 81bc100c-fa49-4614-85a6-0f7ab59eac8a
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームとアンマネージ アプリケーション
+Windows フォーム アプリケーションとコントロールは、いくつかの注意事項がありますが、アンマネージ アプリケーションと相互運用できます。  次のセクションでは、Windows フォーム アプリケーションとコントロールがサポートするシナリオと構成、および、サポートしないシナリオと構成について説明します。  
+  
+## このセクションの内容  
+ [Windows フォームおよびアンマネージ アプリケーションの概要](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications-overview.md)  
+ アンマネージ アプリケーションで使用する Windows フォーム コントロールを実装する方法に関する一般的な情報を提供します。  
+  
+ [方法 : ShowDialog メソッドで Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/com-interop-by-displaying-a-windows-form-shadow.md)  
+ <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName> メソッドを使用して Windows フォームをアンマネージ アプリケーションで実行する方法を示すコード例を提供します。  
+  
+ [方法 : 独自のスレッドで各 Windows フォームを表示して COM 相互運用機能をサポートする](../../../../docs/framework/winforms/advanced/how-to-support-com-interop-by-displaying-each-windows-form-on-its-own-thread.md)  
+ 独自のスレッドで Windows フォームを実行する方法を示すコード例を提供します。  
+  
+ 「[チュートリアル : Windows フォームを別個のスレッドに表示することによって COM 相互運用をサポートする](http://msdn.microsoft.com/library/ms233639\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Form.ShowDialog%2A?displayProperty=fullName>  
+ Windows フォーム用の個別のスレッドの作成に使用します。  
+  
+ <xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName>  
+ スレッドのメッセージ ループを開始します。  
+  
+ <xref:System.Windows.Forms.Control.Invoke%2A>  
+ フォームにアンマネージ アプリケーションからの呼び出しをマーシャリングします。  
+  
+## 関連項目  
+ [COM への .NET Framework コンポーネントの公開](../../../../docs/framework/interop/exposing-dotnet-components-to-com.md)  
+ .NET Framework の型をアンマネージ アプリケーションで使用する方法に関する一般情報を提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/windows-forms-print-support.md b/docs/framework/winforms/advanced/windows-forms-print-support.md
new file mode 100644
index 00000000000..74cf450861f
--- /dev/null
+++ b/docs/framework/winforms/advanced/windows-forms-print-support.md
@@ -0,0 +1,73 @@
+---
+title: "Windows フォームにおける印刷のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 印刷 (デザイナーを使用して)"
+  - "印刷 [Windows フォーム]"
+  - "印刷 [Windows フォーム], 印刷のサポート"
+  - "印刷, Windows フォーム, サポート"
+  - "Windows フォーム, 印刷"
+ms.assetid: a4a2960c-eb70-48e2-b641-cfb222704e46
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームにおける印刷のサポート
+Windows フォームにおける印刷では主に、ユーザーによる印刷を可能にするための [PrintDocument コンポーネント](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md) コンポーネントと、Windows オペレーティング システムを常用しているユーザーに見慣れたグラフィカル インターフェイスを提供するための [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)、[PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)、および [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md) が使用されます。  
+  
+ 通常、印刷を行う場合には、<xref:System.Drawing.Printing.PrintDocument> コンポーネントの新しいインスタンスを作成し、<xref:System.Drawing.Printing.PrinterSettings> クラスおよび <xref:System.Drawing.Printing.PageSettings> クラスを使用して印刷対象を定義してから、<xref:System.Drawing.Printing.PrintDocument.Print%2A> メソッドを呼び出してドキュメントを実際に印刷します。  
+  
+ Windows ベースのアプリケーションから印刷を行っている間、<xref:System.Drawing.Printing.PrintDocument> コンポーネントは、印刷中止ダイアログ ボックスを表示して、印刷が実行中であることをユーザーに通知し、ユーザーが印刷ジョブをキャンセルできるようにします。  
+  
+## このセクションの内容  
+ [方法 : 標準の Windows フォーム印刷ジョブを作成する](../../../../docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md)  
+ <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用して Windows フォームで印刷を行う方法について説明します。  
+  
+ [方法 : 実行時に PrintDialog のユーザー入力をキャプチャする](../../../../docs/framework/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md)  
+ 選択した印刷オプションを <xref:System.Windows.Forms.PrintDialog> コンポーネントを使用してプログラムで変更する方法について説明します。  
+  
+ [方法 : Windows フォームでユーザーのコンピューターに接続されたプリンターを選択する](../../../../docs/framework/winforms/advanced/how-to-choose-the-printers-attached-to-user-computer-in-windows-forms.md)  
+ 実行時に <xref:System.Windows.Forms.PrintDialog> コンポーネントを使用してプリンターを変更する方法について説明します。  
+  
+ [方法 : Windows フォームでグラフィックスを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md)  
+ プリンターにグラフィックを送る方法について説明します。  
+  
+ [方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md)  
+ プリンターにテキストを送る方法について説明します。  
+  
+ [方法 : Windows フォームの印刷ジョブを完了する](../../../../docs/framework/winforms/advanced/how-to-complete-windows-forms-print-jobs.md)  
+ ユーザーに印刷ジョブの完了を通知する方法について説明します。  
+  
+ [方法 : Windows フォームを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-a-windows-form.md)  
+ 現在のフォームのコピーを印刷する方法について説明します。  
+  
+ [方法 : Windows フォームで印刷プレビューを使用して印刷する](../../../../docs/framework/winforms/advanced/how-to-print-in-windows-forms-using-print-preview.md)  
+ 文書を印刷するために <xref:System.Windows.Forms.PrintPreviewDialog> を使用する方法について説明します。  
+  
+## 関連項目  
+ [PrintDocument コンポーネント](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md)  
+ <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用する方法について説明します。  
+  
+ [PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)  
+ <xref:System.Windows.Forms.PrintDialog> コンポーネントを使用する方法について説明します。  
+  
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)  
+ <xref:System.Windows.Forms.PrintPreviewDialog> コントロールを使用する方法について説明します。  
+  
+ [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md)  
+ <xref:System.Windows.Forms.PageSetupDialog> コンポーネントを使用する方法について説明します。  
+  
+ <xref:System.Drawing.Printing>  
+ <xref:System.Drawing.Printing> 名前空間に含まれるクラスについて説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/windows-forms-visual-inheritance.md b/docs/framework/winforms/advanced/windows-forms-visual-inheritance.md
new file mode 100644
index 00000000000..1bf9c3eceac
--- /dev/null
+++ b/docs/framework/winforms/advanced/windows-forms-visual-inheritance.md
@@ -0,0 +1,58 @@
+---
+title: "Windows フォームのビジュアルの継承 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "基本フォーム"
+  - "フォームの継承"
+  - "継承"
+  - "継承, フォーム"
+  - "継承フォーム"
+  - "継承フォーム, Windows フォーム"
+  - "Windows フォーム, 継承"
+ms.assetid: 857eb737-3602-4d49-bd8b-f70d33ace345
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームのビジュアルの継承
+プロジェクトで、以前のプロジェクトに作成したフォームと同様のフォームが必要になることがあります。  または、プロジェクトで再使用するウォーターマークや特定のコントロール レイアウトなどが設定された基本フォームを作成し、元のフォーム テンプレートを変更しながら繰り返し使用することが必要になる場合があります。  フォームの継承を使用すると、基本フォームを作成し、そのフォームを継承して変更できます。このとき、必要となる元の設定はすべて保持されます。  
+  
+ 派生クラス フォームは、プログラムによって、またはビジュアルな継承ピッカーを使って、作成できます。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-windows-forms.md)  
+ コードを記述して、継承フォームを作成する方法について説明します。  
+  
+ [方法 : \[継承ピッカー\] ダイアログ ボックスを使用してフォームを継承する](../../../../docs/framework/winforms/advanced/how-to-inherit-forms-using-the-inheritance-picker-dialog-box.md)  
+ 継承ピッカーを使用して、継承フォームを作成する方法について説明します。  
+  
+ [基本フォームの外観を変更した場合の影響](../../../../docs/framework/winforms/advanced/effects-of-modifying-base-form-appearance.md)  
+ 基本フォームのコントロールおよびコントロールのプロパティを変更する方法について説明します。  
+  
+ [チュートリアル : ビジュアル継承のデモンストレーション](../../../../docs/framework/winforms/advanced/walkthrough-demonstrating-visual-inheritance.md)  
+ 基本の Windows フォームを作成し、クラス ライブラリにコンパイルする方法について説明します。  このクラス ライブラリを別のプロジェクトにインポートし、基本のフォームを継承した新規フォームを作成します。  
+  
+ [方法 : Modifiers プロパティおよび GenerateMember プロパティを使用する](../../../../docs/framework/winforms/advanced/how-to-use-the-modifiers-and-generatemember-properties.md)  
+ `GenerateMember` プロパティおよび `Modifiers` プロパティの使用法について説明します。これらのプロパティは、Windows フォーム デザイナーでコンポーネントのメンバー変数を生成するときに使用されます。  
+  
+## 関連項目  
+ [NOT IN BUILD: Inheritance in Visual Basic](http://msdn.microsoft.com/ja-jp/e5e6e240-ed31-4657-820c-079b7c79313c)  
+ 他のクラスの基本クラスとして、Visual Basic クラスを定義する方法について説明します。  
+  
+ [クラス](../Topic/class%20\(C%23%20Reference\).md)  
+ 単一継承ができる C\# のクラスについて説明します。  
+  
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)  
+ 継承コンポーネントのイベント ハンドラーで発生する一般的な問題について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md b/docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md
new file mode 100644
index 00000000000..18c034d4aab
--- /dev/null
+++ b/docs/framework/winforms/advanced/working-with-images-bitmaps-icons-and-metafiles.md
@@ -0,0 +1,74 @@
+---
+title: "イメージ、ビットマップ、アイコン、およびメタファイルの操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 処理"
+  - "例 [Windows フォーム], ビットマップ"
+  - "例 [Windows フォーム], イメージ"
+  - "例 [Windows フォーム], メタファイル"
+  - "イメージ [Windows フォーム], 処理"
+  - "メタファイル, 処理"
+ms.assetid: a626d701-bd99-4fd8-b92f-7b8f794e042b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# イメージ、ビットマップ、アイコン、およびメタファイルの操作
+[!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] は、ラスター イメージを操作するための `Bitmap` クラスと、ベクター イメージを操作するための `Metafile` クラスを提供します。  `Bitmap` クラスおよび `Metafile` クラスは、どちらも `Image` クラスから継承されます。  
+  
+## このセクションの内容  
+ [方法: 既存のビットマップを画面に描画する](../../../../docs/framework/winforms/advanced/how-to-draw-an-existing-bitmap-to-the-screen.md)  
+ ビットマップを読み込んで描画する方法について説明します。  
+  
+ [方法 : メタファイルを読み込んで表示する](../../../../docs/framework/winforms/advanced/how-to-load-and-display-metafiles.md)  
+ メタファイルを読み込んで描画する方法について説明します。  
+  
+ [GDI\+ でのイメージのトリミングおよびスケーリング](../../../../docs/framework/winforms/advanced/cropping-and-scaling-images-in-gdi.md)  
+ ベクター イメージおよびラスター イメージをトリミングしてスケールを調整する方法について説明します。  
+  
+ [方法 : イメージを回転、反転、および傾斜させる](../../../../docs/framework/winforms/advanced/how-to-rotate-reflect-and-skew-images.md)  
+ 回転、反転、および傾斜したイメージを描画する方法について説明します。  
+  
+ [方法 : 補間モードを使用してスケーリング時の画質を制御する](../../../../docs/framework/winforms/advanced/how-to-use-interpolation-mode-to-control-image-quality-during-scaling.md)  
+ <xref:System.Drawing.Drawing2D.InterpolationMode> 列挙体を使用してイメージ品質を変更する方法を示しています。  
+  
+ [方法 : サムネイル イメージを作成する](../../../../docs/framework/winforms/advanced/how-to-create-thumbnail-images.md)  
+ サムネイル イメージを作成する方法について説明しています。  
+  
+ [方法 : 自動スケーリングを解除してパフォーマンスを向上させる](../../../../docs/framework/winforms/advanced/how-to-improve-performance-by-avoiding-automatic-scaling.md)  
+ 自動スケーリングなしでイメージを描画する方法について説明します。  
+  
+ [方法 : イメージ メタデータを読み取る](../../../../docs/framework/winforms/advanced/how-to-read-image-metadata.md)  
+ イメージからメタデータを読み取る方法について説明します。  
+  
+ [方法 : 実行時にビットマップを作成する](../../../../docs/framework/winforms/advanced/how-to-create-a-bitmap-at-run-time.md)  
+ 実行時にビットマップを描画する方法を示します。  
+  
+ [方法 : Windows フォームでファイルに関連付けられているアイコンを抽出する](../../../../docs/framework/winforms/advanced/how-to-extract-the-icon-associated-with-a-file-in-windows-forms.md)  
+ ファイルの埋め込みリソースであるアイコンを抽出する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Image>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Imaging.Metafile>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Bitmap>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)  
+ さまざまな種類のビットマップと、アプリケーションでこれらを操作する方法について説明するトピックへのリンクが含まれます。
\ No newline at end of file
diff --git a/docs/framework/winforms/automatic-scaling-in-windows-forms.md b/docs/framework/winforms/automatic-scaling-in-windows-forms.md
new file mode 100644
index 00000000000..447f7df8961
--- /dev/null
+++ b/docs/framework/winforms/automatic-scaling-in-windows-forms.md
@@ -0,0 +1,111 @@
+---
+title: "Windows フォームにおける自動スケーリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "スケーラビリティ, 自動 (Windows フォームでの)"
+  - "Windows フォーム, 自動スケーリング"
+ms.assetid: 68fad25b-afbc-44bd-8e1b-966fc43507a4
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォームにおける自動スケーリング
+自動スケーリングによって、特定のディスプレイの解像度またはシステムのフォントを持つマシンに合わせて設計されたフォームとコントロールを、ディスプレイの別の解像度やシステム フォントを持つ別のマシンで適切に表示することができます。  フォームとコントロールが、ユーザーとその他の開発者のマシンのネイティブ ウィンドウとその他のアプリケーションで、一貫性を持つよう適切にサイズ変更され、  自動スケーリングと視覚スタイルに対する [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のサポートにより、各ユーザーのマシンのネイティブの Windows アプリケーションと比較した場合、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションが一貫したルック アンド フィールを維持することができます。  
+  
+## 自動スケーリングの必要性  
+ 自動スケーリングがないと、1 つのディスプレイの解像度やフォントのために設計されたアプリケーションは、その解像度やフォントが変更されたときに、表示が小さすぎたり大きすぎたりします。  たとえば、アプリケーションが基準として Tahoma の 9 ポイントを使用して設計されている場合、調整なしでは、システム フォントが Tahoma の 12 ポイントのマシンで実行すると、表示が小さすぎます。  タイトル、メニュー、テキスト ボックスの内容などのテキストの要素は、他のアプリケーションより小さく表示されます。  さらに、タイトル バー、メニューや、多数のコントロールのテキストを含むユーザー インターフェイス \(UI\) 要素のサイズは、使用されるフォントに依存します。  この例では、これらの要素は比較的小さく表示されます。  
+  
+ 類似する状況は、アプリケーションがディスプレイの特定の解像度のために設計されている場合にも発生します。  最も一般的な表示解像度が 96 ドット\/インチ \(DPI\) ですが、120、133、170、およびそれ以上をサポートする解像度の高いディスプレイが、ますます一般的になっています。  調整なしだと、特にグラフィックスに基づくアプリケーションで、ある解像度のために設計されたものが、別の解像度で実行したときに、表示が大きすぎたり小さすぎたりします。  
+  
+ 自動スケーリングは、相対的なフォント サイズやディスプレイ解像度に従ってフォームと子コントロールを自動でサイズ変更することで、これらの問題を改善しようとしています。  Windows オペレーティング システムは、ダイアログ単位と呼ばれるは、相対的な測定単位を使用して、ダイアログ ボックスの自動スケーリングをサポートします。  ダイアログ単位は、システム フォントに基づいており、ピクセルとの関係は、Win32 SDK 関数 `GetDialogBaseUnits` によって決定できます。  ユーザーが Windows によって使用されるテーマを変更すると、すべてのダイアログ ボックスがそれに合わせて自動的に調整されます。  また、  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、既定のシステム フォントまたはディスプレイの解像度のいずれかに応じて自動スケーリングをサポートしています。  必要に応じて、アプリケーションで自動スケーリングを無効化できます。  
+  
+## 自動スケーリングの元のサポート  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のバージョン 1.0 および 1.1 は、Windows の UI に使用される \(Win32 SDK 値 **DEFAULT\_GUI\_FONT** で表す\) 既定のフォントに依存した、簡単な方法で自動スケーリングをサポートしていました。  このフォントは、通常、ディスプレイの解像度が変更されたときにのみ変更されました。  自動スケーリングを実装するために、次のメカニズムが使用されていました。  
+  
+1.  デザイン時は、<xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A> プロパティ \(これは現在推奨されていません\) が、開発者のマシンの既定のシステム フォントの高さと幅に設定されていました。  
+  
+2.  実行時は、ユーザーのマシンの既定のシステム フォントが <xref:System.Windows.Forms.Form> クラスの <xref:System.Windows.Forms.Control.Font%2A> プロパティを初期化するために使用されていました。  
+  
+3.  フォームを表示する前に、フォームのスケーリングのため、<xref:System.Windows.Forms.Form.ApplyAutoScaling%2A> メソッドが呼び出されました。  このメソッドは、<xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A> と <xref:System.Windows.Forms.Control.Font%2A> から相対スケール サイズを計算し、<xref:System.Windows.Forms.Control.Scale%2A> メソッドを呼び出してフォームとその子を実際にスケーリングしました。  
+  
+4.  <xref:System.Windows.Forms.Form.ApplyAutoScaling%2A> への後続の呼び出しがフォームを段階的にサイズ変更することがないよう、<xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A> の値が更新されました。  
+  
+ このメカニズムは、ほとんどの目的では十分ですが、次の制限がありました。  
+  
+-   <xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A> プロパティはベースラインのフォント サイズを整数値として表すため、フォームが複数の解像度を循環した場合、エラーの丸めが発生します。  
+  
+-   自動スケーリングは <xref:System.Windows.Forms.Form> クラスでのみ実装されており、<xref:System.Windows.Forms.ContainerControl> クラスでは実装されていませんでした。  その結果、ユーザー コントロールは、それがフォームと同じ解像度で設計されていて、かつデザイン時にそのユーザー コントロールがそのフォームに配置された場合にのみ、正しくスケーリングされるということになっていました。  
+  
+-   フォームとその子コントロールの設計作業を複数の開発者によって並行して進めることができたのは、マシンの解像度が同じ場合に限られていました。  同じように、フォームの継承は、親フォームに関連付けられている解像度に依存していました。  
+  
+-   <xref:System.Windows.Forms.FlowLayoutPanel> や <xref:System.Windows.Forms.TableLayoutPanel> など、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョン 2.0 で導入された新しいレイアウト マネージャーと互換性がありません。  
+  
+-   [!INCLUDE[compact](../../../includes/compact-md.md)] への互換性に必要なディスプレイの解像度に直接基づくスケーリングをサポートしていませんでした。  
+  
+ このメカニズムは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョン 2.0 で後方互換性のために保持されますが、次に説明するより堅牢なスケーリング メカニズムによって置き換えられました。  その結果、<xref:System.Windows.Forms.Form.AutoScale%2A>、<xref:System.Windows.Forms.Form.ApplyAutoScaling%2A>、<xref:System.Windows.Forms.Form.AutoScaleBaseSize%2A>、および特定の <xref:System.Windows.Forms.Control.Scale%2A> のオーバーロードは廃止マークが付けられています。  
+  
+> [!NOTE]
+>  従来のコードを [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョン 2.0 にアップグレードする際、これらのメンバーへの参照を削除して問題ありません。  
+  
+## 自動スケーリングの現在のサポート  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョン 2.0 は、Windows フォームの自動規スケーリングに次の変更を導入することで、以前の制限を解消しています。  
+  
+-   スケーリングの基本サポートは <xref:System.Windows.Forms.ContainerControl> クラスに移動し、フォーム、ネイティブの複合コントロールおよびユーザー コントロールは、すべて統一されたスケーリングのサポートを受け取ります。  新しいメンバー <xref:System.Windows.Forms.ContainerControl.AutoScaleFactor%2A>、<xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A>、<xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A>、および <xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A> が追加されました。  
+  
+-   <xref:System.Windows.Forms.Control> クラスにも、スケーリングに参加して同じフォームでのスケーリングの混在をサポートできる新しいメンバーがいくつかあります。  具体的には、<xref:System.Windows.Forms.Control.Scale%2A>、<xref:System.Windows.Forms.Control.ScaleChildren%2A>、および <xref:System.Windows.Forms.Control.GetScaledBounds%2A> メンバーが、スケーリングをサポートします。  
+  
+-   画面の解像度に基づくスケーリングのサポートが追加され、<xref:System.Windows.Forms.AutoScaleMode> の列挙型により定義されるように、システム フォントのサポートを補完します。  このモードは、アプリケーションの移行を容易にする [!INCLUDE[compact](../../../includes/compact-md.md)] によりサポートされる、自動スケーリングと互換性があります。  
+  
+-   <xref:System.Windows.Forms.FlowLayoutPanel> や <xref:System.Windows.Forms.TableLayoutPanel> などのレイアウト マネージャーの互換性が、自動スケーリングの実装に追加されています。  
+  
+-   スケール ファクターが、通常は <xref:System.Drawing.SizeF> 構造を使用する浮動小数点値として表され、エラーの丸めが事実上解決されています。  
+  
+> [!CAUTION]
+>  DPI とフォントのスケーリング モードの任意の混在はサポートされません。  1 つのモード \(DPI など\) を使用してユーザー コントロールのスケールを調整し、別のモード \(フォント\) を使用してフォームに配置して問題が発生しない場合でも、基底フォームはあるモード、派生フォームは別のモードというように混在させると、予期しない結果が発生することがあります。  
+  
+### 動作中の自動スケーリング  
+ Windows フォームは、次のロジックを使用して、フォームとそのコンテンツを自動的にスケール調整します。  
+  
+1.  デザイン時に、各 <xref:System.Windows.Forms.ContainerControl> は <xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A> と <xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A> にそれぞれスケーリング モードと現在の解像度を記録します。  
+  
+2.  実行時に、実際の解像度は <xref:System.Windows.Forms.ContainerControl.CurrentAutoScaleDimensions%2A> プロパティに格納されます。  <xref:System.Windows.Forms.ContainerControl.AutoScaleFactor%2A> プロパティは、実行時と設計時のスケーリング解像度の比率を動的に計算します。  
+  
+3.  フォームが読み込まれたときに、<xref:System.Windows.Forms.ContainerControl.CurrentAutoScaleDimensions%2A> と <xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A> の値が異なる場合は、<xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A> メソッドが呼び出されてコントロールと子のスケールを調整します。  このメソッドはレイアウトを中断し、<xref:System.Windows.Forms.Control.Scale%2A> メソッドを呼び出して実際のスケーリングを実行します。  その後、<xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A> の値がプログレッシブ スケーリングを避けるために更新されます。  
+  
+4.  また、<xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A> は次のような状況でも自動的に呼び出されます。  
+  
+    -   スケーリング モードが <xref:System.Windows.Forms.AutoScaleMode> の場合の <xref:System.Windows.Forms.Control.OnFontChanged%2A> イベントへの応答。  
+  
+    -   コンテナー コントロールのレイアウトが再開され、<xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A> プロパティまたは <xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A> プロパティで変更が検出されたとき。  
+  
+    -   上記に示すように、親の <xref:System.Windows.Forms.ContainerControl> がスケーリングされたとき。  各コンテナー コントロールは、親コンテナーからのスケーリング ファクターではなく、独自のスケーリング ファクターを使用してその子のスケーリングを担当します。  
+  
+5.  子コントロールは、いくつかの方法で、そのスケーリングの動作を変更できます。  
+  
+    -   <xref:System.Windows.Forms.Control.ScaleChildren%2A> プロパティをオーバーライドして、子コントロールをスケーリングすべきかどうかを決定することができます。  
+  
+    -   <xref:System.Windows.Forms.Control.GetScaledBounds%2A> メソッドをオーバーライドして、スケーリングのロジックではなく、コントロールがスケーリングされる両機にを調整することができます。  
+  
+    -   <xref:System.Windows.Forms.Control.ScaleControl%2A> メソッドをオーバーライドして、現在のコントロールのスケーリングのロジックを変更することができます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A>   
+ <xref:System.Windows.Forms.Control.Scale%2A>   
+ <xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A>   
+ <xref:System.Windows.Forms.ContainerControl.AutoScaleDimensions%2A>   
+ [visual スタイルが使用されているコントロールのレンダリング](../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)   
+ [方法 : 自動スケーリングを解除してパフォーマンスを向上させる](../../../docs/framework/winforms/advanced/how-to-improve-performance-by-avoiding-automatic-scaling.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/change-notification-in-windows-forms-data-binding.md b/docs/framework/winforms/change-notification-in-windows-forms-data-binding.md
new file mode 100644
index 00000000000..61615e5ba75
--- /dev/null
+++ b/docs/framework/winforms/change-notification-in-windows-forms-data-binding.md
@@ -0,0 +1,50 @@
+---
+title: "Windows フォーム データ バインドの変更通知 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 追加 (データ バインディングの変更通知を)"
+  - "Windows フォーム, データ バインド"
+ms.assetid: b5b10f90-0585-41d9-a377-409835262a92
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Windows フォーム データ バインドの変更通知
+Windows フォーム データ バインディングの重要な概念の 1 つに、"変更通知" があります。  データ ソースとデータ バインド コントロールに常に最新のデータを持たせるためには、データ バインディングの変更通知を追加する必要があります。  具体的には、データ ソースに加えられた変更がバインド コントロールに通知され、コントロールのバインド プロパティに加えられた変更がデータ ソースに通知されるようにします。  
+  
+ 次のように、データ バインディングの種類に応じて異なる種類の変更通知があります。  
+  
+-   単純バインディング。1 つのコントロール プロパティがオブジェクトの 1 つのインスタンスにバインドされます。  
+  
+-   リストベース バインディング。リスト内のアイテムのプロパティにバインドされる 1 つのコントロール プロパティ、またはオブジェクトのリストにバインドされるコントロール プロパティを含むことができます。  
+  
+ さらに、データ バインディングで使用する Windows フォーム コントロールを作成する場合、コントロールのバインド プロパティに対する変更がデータ ソースに反映されるように、コントロールに *PropertyName*Changed パターンを適用する必要があります。  
+  
+## 単純バインディングの変更通知  
+ 単純バインディングでは、バインド プロパティの値が変更されたときにビジネス オブジェクトが変更通知を出す必要があります。  これは、ビジネス オブジェクトの各プロパティに対して *PropertyName*Changed イベントを公開し、<xref:System.Windows.Forms.BindingSource> またはビジネス オブジェクトが <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装してプロパティの値が変更されたときに <xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントを起動するメソッドを使用して、ビジネス オブジェクトをコントロールにバインドすることによって実現できます。  詳細については、「[方法 : INotifyPropertyChanged インターフェイスを実装する](../../../docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md)」を参照してください。  <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装するオブジェクトを使用する場合、オブジェクトをコントロールにバインドするために <xref:System.Windows.Forms.BindingSource> を使用する必要はありませんが、<xref:System.Windows.Forms.BindingSource> の使用を推奨します。  
+  
+## リストベース バインディングの変更通知  
+ Windows フォームは、バインド リストに依存して、プロパティ変更 \(リスト アイテム プロパティ値の変更\) および変更されたリスト \(リストに対するアイテムの削除や追加\) の情報をバインド コントロールに提供します。  このため、データ バインディングに使用するリストには、両方の種類の変更通知を提供する <xref:System.ComponentModel.IBindingList> を実装する必要があります。  <xref:System.ComponentModel.BindingList%601> は、<xref:System.ComponentModel.IBindingList> の汎用実装で、Windows フォーム データ バインディングで使用するためにデザインされています。  <xref:System.ComponentModel.INotifyPropertyChanged> を実装するビジネス オブジェクト タイプを含む <xref:System.ComponentModel.BindingList%601> を作成できます。リストは <xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントを <xref:System.ComponentModel.IBindingList.ListChanged> イベントに自動的に変換します。  バインド リストが <xref:System.ComponentModel.IBindingList> でない場合、オブジェクトのリストを <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して Windows フォーム コントロールにバインドする必要があります。  <xref:System.Windows.Forms.BindingSource> コンポーネントは、<xref:System.ComponentModel.BindingList%601> の場合と同様にプロパティからリストへの変換を行います。  詳細については、「[方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる](../../../docs/framework/winforms/controls/raise-change-notifications--bindingsource.md)」を参照してください。  
+  
+## カスタム コントロールの変更通知  
+ 最後に、コントロール側から、データにバインドされるようにデザインされた各プロパティに *PropertyName*Changed イベントを公開する必要があります。  これで、コントロール プロパティに対する変更は、バインド データ ソースに反映されます。  詳細については、「[方法 : PropertyNameChanged パターンを適用する](../../../docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.ComponentModel.INotifyPropertyChanged>   
+ <xref:System.ComponentModel.BindingList%601>   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [Windows フォームがサポートするデータ ソース](../../../docs/framework/winforms/data-sources-supported-by-windows-forms.md)   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/changing-the-appearance-of-windows-forms.md b/docs/framework/winforms/changing-the-appearance-of-windows-forms.md
new file mode 100644
index 00000000000..1694e86f22e
--- /dev/null
+++ b/docs/framework/winforms/changing-the-appearance-of-windows-forms.md
@@ -0,0 +1,57 @@
+---
+title: "Windows フォームの表示形式の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 変更 (表示形式を)"
+ms.assetid: 12f35d5b-1587-49cc-ada3-47eec1ff1738
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Windows フォームの表示形式の変更
+罫線、不透明度、図形、スタイルの変更、または Windows フォーム アプリケーションの背景画像の設定など、Windows フォーム アプリケーションの外観をさまざまな方法でカスタマイズできます。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームの境界線を変更する](../../../docs/framework/winforms/how-to-change-the-borders-of-windows-forms.md)  
+ フォームの罫線のスタイルを変更する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Form>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.FormBorderStyle>  
+ この列挙体について説明し、そのすべてのメンバーの説明が含まれています。  
+  
+ <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Image>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Region>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Drawing.Color>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームのサイズとスケールを調整する](../../../docs/framework/winforms/adjusting-the-size-and-scale-of-windows-forms.md)  
+ フォームのサイズとスケールを変更する方法を説明するトピックへのリンクが含まれます。  
+  
+ [Windows フォームにおけるグラフィックスと描画](../../../docs/framework/winforms/advanced/graphics-and-drawing-in-windows-forms.md)  
+ Windows フォームでカスタム描画を実行する方法を説明するトピックへのリンクが含まれます。  
+  
+ [組み込みのオーナー描画サポートを備えたコントロール](../../../docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md)  
+ Windows フォーム コントロールでのオーナー描画のサポートの一覧を表示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/clickonce-deployment-for-windows-forms.md b/docs/framework/winforms/clickonce-deployment-for-windows-forms.md
new file mode 100644
index 00000000000..218a00ed6c7
--- /dev/null
+++ b/docs/framework/winforms/clickonce-deployment-for-windows-forms.md
@@ -0,0 +1,80 @@
+---
+title: "Windows フォームの ClickOnce 配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ClickOnce 配置 [Windows フォーム]"
+  - "チュートリアル [Windows フォーム], ClickOnce 配置"
+  - "Windows フォーム, ClickOnce 配置"
+ms.assetid: 1451fce9-1965-4a03-b4d3-831b5fe4ad66
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Windows フォームの ClickOnce 配置
+次のトピックでは、Windows フォーム アプリケーションをクライアント コンピューターに簡単に配置するために使用されるテクノロジである [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] について説明します。  
+  
+## 関連項目  
+ [ClickOnce 配置ストラテジの選択](../Topic/Choosing%20a%20ClickOnce%20Deployment%20Strategy.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを配置するためのいくつかのオプションが表示されます。  
+  
+ [ClickOnce の更新方法の選択](../Topic/Choosing%20a%20ClickOnce%20Update%20Strategy.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを更新するためのいくつかのオプションが表示されます。  
+  
+ [ClickOnce アプリケーションのセキュリティ](../Topic/Securing%20ClickOnce%20Applications.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] 配置のセキュリティへの影響について説明します。  
+  
+ [ClickOnce 配置のトラブルシューティング](../Topic/Troubleshooting%20ClickOnce%20Deployments.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを配置するときに発生する可能性のあるさまざまな問題について説明し、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] が生成する可能性のあるトップレベルのエラー メッセージを記載します。  
+  
+ [ClickOnce とアプリケーション設定](../Topic/ClickOnce%20and%20Application%20Settings.md)  
+ アプリケーション設定とユーザー設定を将来の取得に備えて保存するアプリケーション設定と、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] 配置の連携方法について説明します。  
+  
+ [信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)  
+ クライアント コンピューターで、信頼されたアプリケーションが高いレベルのアクセス許可で実行できるようにする [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の機能について説明します。  
+  
+ [ClickOnce と Authenticode](../Topic/ClickOnce%20and%20Authenticode.md)  
+ Authenticode テクノロジが信頼されたアプリケーション配置で使用される方法について説明します。  
+  
+ [チュートリアル : ClickOnce アプリケーションを手動で配置する](../Topic/Walkthrough:%20Manually%20Deploying%20a%20ClickOnce%20Application.md)  
+ コマンド ラインと SDK ツールを使用し、Visual Studio を使用せずに [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを配置する方法について説明します。  
+  
+ [方法: ClickOnce アプリケーション用の信頼された発行者をクライアント コンピューターに追加する](../Topic/How%20to:%20Add%20a%20Trusted%20Publisher%20to%20a%20Client%20Computer%20for%20ClickOnce%20Applications.md)  
+ 信頼されたアプリケーションの配置に必要なクライアント コンピューターの 1 回限りの構成について説明します。  
+  
+ [方法 : 配置の更新用に別の場所を指定する](../Topic/How%20to:%20Specify%20an%20Alternate%20Location%20for%20Deployment%20Updates.md)  
+ SDK ツールを使用して、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを構成し、新しいバージョンのアプリケーションの別の場所を確認する方法を示します。  
+  
+ [チュートリアル : ClickOnce 配置 API を使用して必要に応じてアセンブリをダウンロードする](../Topic/Walkthrough:%20Downloading%20Assemblies%20on%20Demand%20with%20the%20ClickOnce%20Deployment%20API.md)  
+ API 呼び出しを使用して、アプリケーションが初めて読み込もうとしたときにアセンブリを取得する方法を示します。  
+  
+ [方法 : オンライン ClickOnce アプリケーションでクエリ文字列を取得する](../Topic/How%20to:%20Retrieve%20Query%20String%20Information%20in%20an%20Online%20ClickOnce%20Application.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションの実行に使用する URL からパラメーターを取得する方法を示します。  
+  
+ [ClickOnce キャッシュの概要](../Topic/ClickOnce%20Cache%20Overview.md)  
+ ローカル コンピューターに [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションを保存するために使用されるキャッシュについて説明します。  
+  
+ [ClickOnce アプリケーションにおけるローカル データおよびリモート データへのアクセス](../Topic/Accessing%20Local%20and%20Remote%20Data%20in%20ClickOnce%20Applications.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションからローカル データ ファイルとリモート データ ソースにアクセスする方法について説明します。  
+  
+ [方法 : ClickOnce アプリケーションにデータ ファイルを含める](../Topic/How%20to:%20Include%20a%20Data%20File%20in%20a%20ClickOnce%20Application.md)  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] データ ディレクトリで利用できるファイルにマークする方法を示します。  
+  
+## 参照  
+ [アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [ClickOnce アプリケーションの発行](../Topic/Publishing%20ClickOnce%20Applications.md)   
+ [ClickOnce アプリケーションのコマンド ラインからのビルド](../Topic/Building%20ClickOnce%20Applications%20from%20the%20Command%20Line.md)   
+ [System.Deployment.Application を使用する ClickOnce アプリケーションのデバッグ](../Topic/Debugging%20ClickOnce%20Applications%20That%20Use%20System.Deployment.Application.md)   
+ [ClickOnce での COM コンポーネントの配置](../Topic/Deploying%20COM%20Components%20with%20ClickOnce.md)   
+ [方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する](../Topic/How%20to:%20Publish%20a%20ClickOnce%20Application%20using%20the%20Publish%20Wizard.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/TOC.md b/docs/framework/winforms/controls/TOC.md
new file mode 100644
index 00000000000..f51f2e3bbfd
--- /dev/null
+++ b/docs/framework/winforms/controls/TOC.md
@@ -0,0 +1,563 @@
+# [Windows フォーム DataGridView コントロールでの仮想モード](virtual-mode-in-the-windows-forms-datagridview-control.md)
+# [Windows フォームの Button コントロールを選択する方法](ways-to-select-a-windows-forms-button-control.md)
+# [Windows フォームでのコントロールの使用方法の概要](overview-of-using-controls-in-windows-forms.md)
+# [方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する](how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md)
+# [方法 : ToolStrip コントロールの AutoComplete を有効にする](how-to-enable-autocomplete-in-toolstrip-controls-in-windows-forms.md)
+# [方法 : Windows フォーム DomainUpDown コントロールにプログラムで項目を追加する](how-to-add-items-to-windows-forms-domainupdown-controls-programmatically.md)
+# [方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする](enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md)
+# [SoundPlayer クラスの概要](soundplayer-class-overview.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する](default-cell-styles-datagridview.md)
+# [チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する](walkthrough-creating-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)
+# [DomainUpDown コントロール](domainupdown-control-windows-forms.md)
+# [チュートリアル : Visual Basic による Windows フォーム コントロールからの継承](walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md)
+# [方法 : Windows フォーム BindingNavigator コントロールに [Load]、[Save]、[Cancel] の各ボタンを追加する](load-save-and-cancel-bindingnavigator.md)
+# [方法 : Windows フォームの NumericUpDown コントロールの書式を設定する](how-to-set-the-format-for-the-windows-forms-numericupdown-control.md)
+# [方法 : ToolStripContentPanel にコントロールを追加する](how-to-add-a-control-to-a-toolstripcontentpanel.md)
+# [方法 : ToolStrip オーバーフローを管理する](how-to-manage-toolstrip-overflow-in-windows-forms.md)
+# [方法 : カスタム レイアウト エンジンを実装する](how-to-implement-a-custom-layout-engine.md)
+# [PictureBox コントロール](picturebox-control-windows-forms.md)
+# [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](windows-forms-controls-padding-autosize.md)
+# [チュートリアル : Visual C# による複合コントロールの作成](walkthrough-authoring-a-composite-control-with-visual-csharp.md)
+# [方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する](unbound-column-to-a-data-bound-datagridview.md)
+# [HScrollBar コントロールおよび VScrollBar コントロール](hscrollbar-and-vscrollbar-controls-windows-forms.md)
+# [TableLayoutPanel コントロール](tablelayoutpanel-control-windows-forms.md)
+# [チュートリアル : Visual Basic による複合コントロールの作成](walkthrough-authoring-a-composite-control-with-visual-basic.md)
+# [方法 : デザイナーを使用してデータを Windows フォーム DataGridView コントロールにバインドする](bind-data-to-the-datagrid-using-the-designer.md)
+# [MenuStrip コントロールの概要](menustrip-control-overview-windows-forms.md)
+# [SoundPlayer クラス](soundplayer-class.md)
+# [方法 : Windows フォームの DataGrid コントロールを使用して入力データを検証する](how-to-validate-input-with-the-windows-forms-datagrid-control.md)
+# [Windows フォーム DataGridView コントロールの列型](column-types-in-the-windows-forms-datagridview-control.md)
+# [Windows フォーム コントロール](index.md)
+# [PrintPreviewDialog コントロールの概要](printpreviewdialog-control-overview-windows-forms.md)
+# [方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](prevent-row-addition-and-deletion-datagridview.md)
+# [GroupBox コントロール](groupbox-control-windows-forms.md)
+# [方法 : Windows フォーム BindingSource を使用して Web サービスにバインドする](how-to-bind-to-a-web-service-using-the-windows-forms-bindingsource.md)
+# [方法 : ColorDialog コンポーネントを使用してカラー パレットを表示する](how-to-show-a-color-palette-with-the-colordialog-component.md)
+# [方法 : データ バインドで発生するエラーと例外を処理する](how-to-handle-errors-and-exceptions-that-occur-with-databinding.md)
+# [ToolStripProgressBar コントロールの概要](toolstripprogressbar-control-overview.md)
+# [方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする](how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md)
+# [StatusStrip コントロール](statusstrip-control.md)
+# [方法 : Windows フォームでサウンドの再生をループする](how-to-loop-a-sound-playing-on-a-windows-form.md)
+# [DataGridView コントロールのコード ディレクトリ](datagridview-control-code-directory-windows-forms.md)
+# [OnPaint メソッドのオーバーライド](overriding-the-onpaint-method.md)
+# [コントロールとコンポーネントの作成時のトラブルシューティング](troubleshooting-control-and-component-authoring.md)
+# [方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する](how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md)
+# [ToolStrip テクノロジの概要](toolstrip-technology-summary.md)
+# [RadioButton コントロール](radiobutton-control-windows-forms.md)
+# [方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する](how-to-create-a-multipane-user-interface-with-windows-forms.md)
+# [方法 : Windows フォーム DataGridView Cells でコントロールをホストする](how-to-host-controls-in-windows-forms-datagridview-cells.md)
+# [方法 : Windows フォームの DomainUpDown コントロールから項目を削除する](how-to-remove-items-from-windows-forms-domainupdown-controls.md)
+# [CheckedListBox コントロールの概要](checkedlistbox-control-overview-windows-forms.md)
+# [Timer コンポーネントの概要](timer-component-overview-windows-forms.md)
+# [ToolStrip コントロール](toolstrip-control-windows-forms.md)
+# [PictureBox コントロールの概要](picturebox-control-overview-windows-forms.md)
+# [デザイン時の Windows フォーム コントロールの開発](developing-windows-forms-controls-at-design-time.md)
+# [TextBox コントロール](textbox-control-windows-forms.md)
+# [方法 : Windows フォーム DataGridView コントロールの列ヘッダーを非表示にする](how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)
+# [方法 : Windows フォーム アプリケーションに印刷プレビューを表示する](how-to-display-print-preview-in-windows-forms-applications.md)
+# [MenuStrip コントロール](menustrip-control-windows-forms.md)
+# [方法 : ToolStripControlHost を使用して Windows フォーム コントロールをラップする](how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md)
+# [Splitter コントロールの概要](splitter-control-overview-windows-forms.md)
+# [方法 : ToolStrip アプリケーションの色をカスタマイズする](how-to-customize-colors-in-toolstrip-applications.md)
+# [方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする ](how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md)
+# [チュートリアル : MaskedTextBox コントロールの使用](walkthrough-working-with-the-maskedtextbox-control.md)
+# [Windows フォームで使用するコントロール](controls-to-use-on-windows-forms.md)
+# [方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)
+# [方法 : Windows フォーム ListView コントロール内の項目を選択する](how-to-select-an-item-in-the-windows-forms-listview-control.md)
+# [Label コントロールの概要](label-control-overview-windows-forms.md)
+# [DataGridView コントロール](datagridview-control-windows-forms.md)
+# [Windows フォーム DataGridView コントロールでのセルのスタイル](cell-styles-in-the-windows-forms-datagridview-control.md)
+# [方法 : デザイナーを使って Windows フォーム パネルの背景を設定する](how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md)
+# [FontDialog コンポーネントの概要](fontdialog-component-overview-windows-forms.md)
+# [チュートリアル : 標準メニュー項目をフォームに用意する](walkthrough-providing-standard-menu-items-to-a-form.md)
+# [方法 : デザイナーを使って ToolBar コントロールにボタンを追加する](how-to-add-buttons-to-a-toolbar-control-using-the-designer.md)
+# [方法 : ToolStrip コントロールにトグル ボタンを作成する](how-to-create-toggle-buttons-in-toolstrip-controls.md)
+# [ユーザーの入力の処理](handling-user-input.md)
+# [方法 : Windows フォーム DataGridView コントロールの選択されたセル、行、および列を取得する](selected-cells-rows-and-columns-datagridview.md)
+# [ファイル ダイアログ ボックスのカスタム プレイス用既知のフォルダー GUID](known-folder-guids-for-file-dialog-custom-places.md)
+# [方法 : Windows フォーム DataGridView コントロールの列を操作する](how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md)
+# [イベントの定義](defining-an-event-in-windows-forms-controls.md)
+# [方法 :デザイナーを使って ToolBar ボタンのアイコンを定義する](how-to-define-an-icon-for-a-toolbar-button-using-the-designer.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](enable-column-reordering-in-the-datagrid-using-the-designer.md)
+# [.NET Framework の Windows フォーム コントロールの機能別分類](windows-forms-controls-by-function.md)
+# [FolderBrowserDialog コンポーネント](folderbrowserdialog-component-windows-forms.md)
+# [方法 : ToolStripPanel を MDI で使用する](how-to-use-toolstrippanels-for-mdi.md)
+# [方法 : ショートカット メニューを Windows フォーム NotifyIcon コンポーネントに関連付ける](how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md)
+# [方法 : Windows フォーム内の ToolStrip テキストとイメージの外観を変更する](how-to-change-the-appearance-of-toolstrip-text-and-images-in-windows-forms.md)
+# [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)
+# [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)
+# [ToolBar コントロールの概要](toolbar-control-overview-windows-forms.md)
+# [Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)
+# [方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする](customize-the-appearance-of-rows-in-the-datagrid.md)
+# [Button コントロール](button-control-windows-forms.md)
+# [方法 : マウス ポインターが ToolStripItem 上にあることを検出する](how-to-detect-when-the-mouse-pointer-is-over-a-toolstripitem.md)
+# [OpenFileDialog コンポーネント](openfiledialog-component-windows-forms.md)
+# [方法 : Windows フォーム上のコントロールのサイズを変更する](how-to-resize-controls-on-windows-forms.md)
+# [方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する](app-icons-to-the-taskbar-with-wf-notifyicon.md)
+# [TextBox コントロールの概要](textbox-control-overview-windows-forms.md)
+# [方法 : ToolStripPanel コントロールを持つ MDI フォームを作成する](how-to-create-an-mdi-form-with-toolstrippanel-controls.md)
+# [方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する](display-more-than-one-month-wf-monthcalendar-control.md)
+# [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](determine-which-panel-wf-statusbar-control-was-clicked.md)
+# [方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする](how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md)
+# [方法 : Windows フォーム DataGridView コントロールのデータを検証する](how-to-validate-data-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)
+# [方法 : フォームに ToolStripContainer を追加する](how-to-add-a-toolstripcontainer-to-a-form.md)
+# [方法 : 実行時にピクチャのサイズまたは配置を変更する](how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)
+# [方法 : Windows フォームの MonthCalendar コントロールの外観を変更する](how-to-change-monthcalendar-control-appearance.md)
+# [複合 Windows フォーム コントロールの開発](developing-a-composite-windows-forms-control.md)
+# [NumericUpDown コントロールの概要](numericupdown-control-overview-windows-forms.md)
+# [ErrorProvider コンポーネントの概要](errorprovider-component-overview-windows-forms.md)
+# [ToolStripPanel コントロールの概要](toolstrippanel-control-overview.md)
+# [方法 : ComboBox コントロールにサイズ変更可能なテキストを作成する](how-to-create-variable-sized-text-in-a-combobox-control.md)
+# [マネージ HTML DOM (Document Object Model) へのアクセス](accessing-frames-in-the-managed-html-document-object-model.md)
+# [方法 : Windows フォームの RichTextBox コントロールにスクロール バーを表示する](how-to-display-scroll-bars-in-the-windows-forms-richtextbox-control.md)
+# [OpenFileDialog コンポーネントの概要](openfiledialog-component-overview-windows-forms.md)
+# [方法 : Windows フォーム内の ToolStrip 項目の間隔と配置を変更する](how-to-change-the-spacing-and-alignment-of-toolstrip-items-in-windows-forms.md)
+# [RadioButton コントロールの概要](radiobutton-control-overview-windows-forms.md)
+# [チュートリアル : ステータス バー情報の実行時更新](walkthrough-updating-status-bar-information-at-run-time.md)
+# [方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する](view-errors-within-a-dataset-with-wf-errorprovider-component.md)
+# [方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする](how-to-bind-objects-to-windows-forms-datagridview-controls.md)
+# [ToolStripProgressBar コントロール](toolstripprogressbar-control.md)
+# [チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行](performing-common-tasks-using-smart-tags-on-wf-controls.md)
+# [方法 : ToolStripMenuItems を移動する](how-to-move-toolstripmenuitems.md)
+# [方法 : Windows フォームの RichTextBox コントロールにおけるドラッグ アンド ドロップ操作を有効にする](enable-drag-and-drop-operations-with-wf-richtextbox-control.md)
+# [ListView コントロールの概要](listview-control-overview-windows-forms.md)
+# [ToolStripContainer コントロールの概要](toolstripcontainer-control-overview.md)
+# [方法 : カスタムの ToolStripRenderer を実装する](how-to-implement-a-custom-toolstriprenderer.md)
+# [チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター/詳細形式のフォームの作成](creating-a-master-detail-form-using-two-datagrids.md)
+# [方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)
+# [方法 : ToolStrip コントロールにツールヒントを使用する](how-to-use-tooltips-in-toolstrip-controls.md)
+# [方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)
+# [方法 : デザイナーを使用して Windows フォームでマルチペイン ユーザー インターフェイスを作成する](create-a-multipane-user-interface-with-wf-using-the-designer.md)
+# [方法 : Windows フォーム CheckBox のクリックに応答する](how-to-respond-to-windows-forms-checkbox-clicks.md)
+# [方法 : TableLayoutPanel コントロールの列と行を編集する](how-to-edit-columns-and-rows-in-a-tablelayoutpanel-control.md)
+# [Windows フォーム コントロールのマルチスレッド処理](multithreading-in-windows-forms-controls.md)
+# [プロパティの定義](defining-a-property-in-windows-forms-controls.md)
+# [Windows フォーム DataGridView コントロールでの Just-In-Time データ読み込みによる仮想モードの実装](implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)
+# [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)
+# [方法 : Windows フォーム ListView コントロールの "並べて表示" ビューを有効にする](how-to-enable-tile-view-in-a-windows-forms-listview-control.md)
+# [方法 : プロフェッショナル スタイルの ToolStrip コントロールを作成する](how-to-create-a-professionally-styled-toolstrip-control.md)
+# [Windows フォームの DataGridView コントロールでのデータの並べ替え](sorting-data-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム TreeView コントロールのアイコンを設定する](how-to-set-icons-for-the-windows-forms-treeview-control.md)
+# [ErrorProvider コンポーネント](errorprovider-component-windows-forms.md)
+# [StatusStrip コントロールの概要](statusstrip-control-overview.md)
+# [方法 : Windows フォームの RichTextBox コントロールにファイルを読み込む](how-to-load-files-into-the-windows-forms-richtextbox-control.md)
+# [方法 : コントロールの描画クラスを使用する](how-to-use-a-control-rendering-class.md)
+# [PrintPreviewDialog コントロール](printpreviewdialog-control-windows-forms.md)
+# [BackgroundWorker コンポーネント](backgroundworker-component.md)
+# [BindingSource コンポーネントの概要](bindingsource-component-overview.md)
+# [SaveFileDialog コンポーネントの概要](savefiledialog-component-overview-windows-forms.md)
+# [方法 : Windows フォームの RichTextBox コントロールにおける書式属性の変更を確認する](determine-when-formatting-attributes-change-wf-richtextbox-control.md)
+# [方法 : ToolStripMenuItem を MDI ドロップダウン メニューから削除する](how-to-remove-a-toolstripmenuitem-from-an-mdi-drop-down-menu-windows-forms.md)
+# [方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる](reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md)
+# [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)
+# [方法 : ToolStripMenuItems を無効にする](how-to-disable-toolstripmenuitems.md)
+# [方法 : Windows フォームの DataGridViewComboBoxCell ドロップダウン リストのオブジェクトにアクセスする](access-objects-in-a-wf-datagridviewcomboboxcell-drop-down-list.md)
+# [方法 : Windows フォーム上のコントロールをドッキングする](how-to-dock-controls-on-windows-forms.md)
+# [方法 : Windows フォーム ColorDialog コンポーネントの表示形式を変更する](how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md)
+# [方法 : コントロールを Windows フォームのスナップ線とグリッドを使用して配置する](how-to-arrange-controls-with-snaplines-and-the-grid-in-windows-forms.md)
+# [方法 : 埋め込みを使用して Windows フォーム コントロールの周囲に境界線を作成する](how-to-create-a-border-around-a-windows-forms-control-using-padding.md)
+# [方法 : データ入力用のサイズ変更可能な Windows フォームを作成する](how-to-create-a-resizable-windows-form-for-data-entry.md)
+# [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)
+# [StatusBar コントロールの概要](statusbar-control-overview-windows-forms.md)
+# [方法 : Windows フォーム上の複数のコントロールを配置する](how-to-align-multiple-controls-on-windows-forms.md)
+# [Panel コントロールの概要](panel-control-overview-windows-forms.md)
+# [TableLayoutPanel コントロールの推奨される手順](best-practices-for-the-tablelayoutpanel-control.md)
+# [方法 : ContextMenuStrip のオープン イベントを処理する](how-to-handle-the-contextmenustrip-opening-event.md)
+# [Windows フォーム DataGridView コントロールでのデザイナーの使用](using-the-designer-with-the-windows-forms-datagridview-control.md)
+# [方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](how-to-create-an-unbound-windows-forms-datagridview-control.md)
+# [PrintDocument コンポーネントの概要](printdocument-component-overview-windows-forms.md)
+# [チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成](walkthrough-creating-a-professionally-styled-toolstrip-control.md)
+# [方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする](make-columns-read-only-in-the-datagrid-using-the-designer.md)
+# [Windows フォーム DataGridView コントロールの列フィル モード](column-fill-mode-in-the-windows-forms-datagridview-control.md)
+# [MainMenu コンポーネントの概要](mainmenu-component-overview-windows-forms.md)
+# [方法 : WebBrowser コントロールで URL に移動する](how-to-navigate-to-a-url-with-the-webbrowser-control.md)
+# [Windows フォームでのコントロールの配置](arranging-controls-on-windows-forms.md)
+# [Windows フォーム DataGridView コントロールでのデータの表示](displaying-data-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロールの現在のセルを取得および設定する](get-and-set-the-current-cell-wf-datagridview-control.md)
+# [方法 : タブ ページにコントロールを追加する](how-to-add-a-control-to-a-tab-page.md)
+# [ListBox コントロール](listbox-control-windows-forms.md)
+# [方法 : Windows フォームからシステム サウンドを再生する](how-to-play-a-system-sound-from-a-windows-form.md)
+# [LinkLabel コントロール](linklabel-control-windows-forms.md)
+# [方法 : Windows フォーム コントロールに属性を適用する](how-to-apply-attributes-in-windows-forms-controls.md)
+# [方法 : デザイナーを使用して Windows フォーム コントロールによって表示されるイメージを設定する](how-to-set-the-image-displayed-by-a-windows-forms-control-using-the-designer.md)
+# [方法 : タブ ページを無効化する](how-to-disable-tab-pages.md)
+# [Windows フォーム デザイナーでのデザイン時エラー](design-time-errors-in-the-windows-forms-designer.md)
+# [方法 : Windows フォームの RichTextBox コントロールを使用してインデント、ぶら下げインデント、および箇条書き段落を設定する](set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md)
+# [方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる](how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md)
+# [方法 : MenuStrip を MDI 親ウィンドウに追加する](how-to-append-a-menustrip-to-an-mdi-parent-window-windows-forms.md)
+# [Windows フォーム コントロールのレンダリング](rendering-a-windows-forms-control.md)
+# [方法 : ToolStripMenuItems に拡張機能を追加する](how-to-add-enhancements-to-toolstripmenuitems.md)
+# [ToolStripPanel コントロール](toolstrippanel-control.md)
+# [方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する](how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md)
+# [方法 : TableLayoutPanel コントロールの行と列を拡大する](how-to-span-rows-and-columns-in-a-tablelayoutpanel-control.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする](hide-columns-in-the-datagrid-using-the-designer.md)
+# [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)
+# [visual スタイルが使用されているコントロールのレンダリング](rendering-controls-with-visual-styles.md)
+# [ComboBox コントロールの概要](combobox-control-overview-windows-forms.md)
+# [Windows フォーム DataGridView コントロールのサイズ変更オプション](sizing-options-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGrid コントロールの書式を設定する](how-to-format-the-windows-forms-datagrid-control.md)
+# [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)
+# [Windows フォーム DataGridView コントロールの選択モード](selection-modes-in-the-windows-forms-datagridview-control.md)
+# [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)
+# [方法 : ショートカット メニューを TreeView ノードに追加する](how-to-attach-a-shortcut-menu-to-a-treeview-node.md)
+# [方法 : visual スタイル要素を描画する](how-to-render-a-visual-style-element.md)
+# [方法 : ウィンドウを水平方向に分割する](how-to-split-a-window-horizontally.md)
+# [方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する](designate-a-wf-button-as-the-accept-button-using-the-designer.md)
+# [方法 : ToolStrip を ToolStripContainer からフォームに移動する](how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md)
+# [方法 : BindingSource コンポーネントを使用してフォーム間でバインド データを共有する](how-to-share-bound-data-across-forms-using-the-bindingsource-component.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md)
+# [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)
+# [方法 : Windows フォーム DataGrid コントロールのクリックに応答する](how-to-respond-to-clicks-in-the-windows-forms-datagrid-control.md)
+# [コントロールのカスタム描画およびレンダリング](custom-control-painting-and-rendering.md)
+# [HelpProvider コンポーネント](helpprovider-component-windows-forms.md)
+# [ProgressBar コントロールの概要](progressbar-control-overview-windows-forms.md)
+# [方法 : ステータス バー パネルのサイズを設定する](how-to-set-the-size-of-status-bar-panels.md)
+# [マネージ HTML DOM (Document Object Model) の使用](using-the-managed-html-document-object-model.md)
+# [Windows フォームの DataGrid コントロール内の移動に使用できるキーボード ショートカット](keyboard-shortcuts-for-the-windows-forms-datagrid-control.md)
+# [ListView コントロール](listview-control-windows-forms.md)
+# [方法 : バックグラウンド操作を使用するフォームを実装する](how-to-implement-a-form-that-uses-a-background-operation.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](add-and-remove-columns-in-the-datagrid-using-the-designer.md)
+# [チュートリアル : デザイナーを使用した、ListView コントロールと TreeView コントロールを含むエクスプローラー スタイルのインターフェイスの作成](creating-an-explorer-style-interface-with-the-listview-and-treeview.md)
+# [LinkLabel コントロールの概要](linklabel-control-overview-windows-forms.md)
+# [方法 : OpenFileDialog コンポーネントを使用してファイルを開く](how-to-open-files-using-the-openfiledialog-component.md)
+# [方法 : Windows フォーム ListView コントロールのアイコンを表示する](how-to-display-icons-for-the-windows-forms-listview-control.md)
+# [方法 : Windows フォーム コントロールに表示するテキストをデザイナーで設定する](how-to-set-the-text-displayed-by-a-windows-forms-control-using-the-designer.md)
+# [方法 : 分割ウィンドウでのサイズ変更および位置指定動作を定義する](how-to-define-resize-and-positioning-behavior-in-a-split-window.md)
+# [ContextMenu コンポーネント](contextmenu-component-windows-forms.md)
+# [方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)
+# [方法 : バックグラウンドでファイルをダウンロードする](how-to-download-a-file-in-the-background.md)
+# [方法 : Windows フォームで Windows エクスプローラー スタイルのインターフェイスを作成する](how-to-create-a-windows-explorer-style-interface-on-a-windows-form.md)
+# [方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター/詳細形式のフォームを作成する](create-a-master-detail-form-using-two-datagrids.md)
+# [Windows フォームへのコントロールの追加](putting-controls-on-windows-forms.md)
+# [方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する](how-to-size-a-windows-forms-label-control-to-fit-its-contents.md)
+# [Windows フォーム コントロールのレイアウト](layout-in-windows-forms-controls.md)
+# [方法 : デザイナーを使用して ToolStripMenuItems を無効にする](how-to-disable-toolstripmenuitems-using-the-designer.md)
+# [方法 : ツール バー ボタンのメニュー イベントをトリガーする](how-to-trigger-menu-events-for-toolbar-buttons.md)
+# [方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する](how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md)
+# [ContextMenuStrip コントロールの概要](contextmenustrip-control-overview.md)
+# [Windows フォーム DataGridView コントロールでのデータ表示モード](data-display-modes-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム コントロールを DBNull データベース値にバインドする](how-to-bind-windows-forms-controls-to-dbnull-database-values.md)
+# [Windows フォームの MenuStrip コントロールへのメニュー項目のマージ](merging-menu-items-in-the-windows-forms-menustrip-control.md)
+# [方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する](how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md)
+# [TrackBar コントロールの概要](trackbar-control-overview-windows-forms.md)
+# [方法 : Windows フォームの RichTextBox コントロールを使用して Web スタイルのリンクを表示する](how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md)
+# [RichTextBox コントロールの概要](richtextbox-control-overview-windows-forms.md)
+# [方法 : Windows フォーム コントロールを型にバインドする](how-to-bind-a-windows-forms-control-to-a-type.md)
+# [方法 : Windows フォームにコントロールをロックする](how-to-lock-controls-to-windows-forms.md)
+# [方法 : ToolStrip コントロールをカスタム描画する](how-to-custom-draw-a-toolstrip-control.md)
+# [方法 : Windows フォーム コントロールによって表示されるイメージを設定する](how-to-set-the-image-displayed-by-a-windows-forms-control.md)
+# [方法 : Windows フォーム DataGridView コントロールの編集モードを指定する](how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする](how-to-customize-sorting-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する](remove-autogenerated-columns-from-a-wf-datagridview-control.md)
+# [TableLayoutPanel コントロールにおける AutoSize 動作](autosize-behavior-in-the-tablelayoutpanel-control.md)
+# [TabControl コントロール](tabcontrol-control-windows-forms.md)
+# [方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する](handle-errors-that-occur-during-data-entry-in-the-datagrid.md)
+# [方法 : デザイナーを使用して ToolStripMenuItems を非表示にする](how-to-hide-toolstripmenuitems-using-the-designer.md)
+# [方法 : デザイナーを使用して TreeNode にショートカット メニューを割り当てる](how-to-attach-a-shortcut-menu-to-a-treenode-using-the-designer.md)
+# [方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する](specify-default-values-for-new-rows-in-the-datagrid.md)
+# [方法 : Windows フォーム TextBox コントロールでテキストを選択する](how-to-select-text-in-the-windows-forms-textbox-control.md)
+# [方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](how-to-format-data-in-the-windows-forms-datagridview-control.md)
+# [方法 : デザイナーを使って Windows フォーム ListView コントロールの項目をグループ化する](how-to-group-items-in-a-windows-forms-listview-control-using-the-designer.md)
+# [方法 : MenuStrip にオプション ボタンを表示する](how-to-display-option-buttons-in-a-menustrip-windows-forms.md)
+# [方法 : ドッキングされた ToolStrip コントロールの Z オーダーを定義する](how-to-define-z-ordering-of-docked-toolstrip-controls.md)
+# [HScrollBar コントロールと VScrollBar コントロールの概要](hscrollbar-and-vscrollbar-controls-overview-windows-forms.md)
+# [方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する](display-specific-days-in-bold-with-wf-monthcalendar-control.md)
+# [方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する](how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム ListView コントロールに挿入マークを表示する](how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md)
+# [方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する](create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md)
+# [Windows フォーム上のコントロールのユーザー補助情報の提供](providing-accessibility-information-for-controls-on-a-windows-form.md)
+# [TreeView コントロール](treeview-control-windows-forms.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する](freeze-columns-in-the-datagrid-using-the-designer.md)
+# [方法 : シンプルな Windows フォーム コントロールを開発する](how-to-develop-a-simple-windows-forms-control.md)
+# [ComboBox コントロール](combobox-control-windows-forms.md)
+# [FileDialog クラス](filedialog-class.md)
+# [DataGrid コントロールの概要](datagrid-control-overview-windows-forms.md)
+# [方法 : ツール バー ボタンのアイコンを定義する](how-to-define-an-icon-for-a-toolbar-button.md)
+# [方法 : 実行時に ToolStrip 項目を並べ替えできるようにする](how-to-enable-reordering-of-toolstrip-items-at-run-time-in-windows-forms.md)
+# [ImageList コンポーネント](imagelist-component-windows-forms.md)
+# [方法 : StatusBar コントロールにパネルを追加する](how-to-add-panels-to-a-statusbar-control.md)
+# [PrintDialog コンポーネントの概要](printdialog-component-overview-windows-forms.md)
+# [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](best-practices-for-scaling-the-windows-forms-datagridview-control.md)
+# [ToolTip コンポーネント](tooltip-component-windows-forms.md)
+# [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)
+# [ToolStrip コントロールの概要](toolstrip-control-overview-windows-forms.md)
+# [方法 : Windows フォームの Timer コンポーネントを使用して一定間隔でプロシージャを実行する](run-procedures-at-set-intervals-with-wf-timer-component.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する](change-the-order-of-columns-in-the-datagrid-using-the-designer.md)
+# [方法 : バックグラウンド スレッドを使用してファイルを検索する](how-to-use-a-background-thread-to-search-for-files.md)
+# [方法 : Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する](perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md)
+# [方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる](raise-change-notifications--bindingsource.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView 列の種類を変更する](change-the-type-of-a-wf-datagridview-column-using-the-designer.md)
+# [方法 : デザイナーを使ってタブ ページにコントロールを追加する](how-to-add-a-control-to-a-tab-page-using-the-designer.md)
+# [方法 : Windows フォームからビープ音を再生する](how-to-play-a-beep-from-a-windows-form.md)
+# [Windows フォームの Timer コンポーネントの Interval プロパティの制限](limitations-of-the-timer-component-interval-property.md)
+# [Windows フォーム コントロールのイベント](events-in-windows-forms-controls.md)
+# [ImageList コンポーネントの概要](imagelist-component-overview-windows-forms.md)
+# [方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する](group-controls-with-wf-panel-control-using-the-designer.md)
+# [方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する](how-to-align-and-stretch-a-control-in-a-tablelayoutpanel-control.md)
+# [方法 : Windows フォーム コントロールをファクトリ オブジェクトにバインドする](how-to-bind-a-windows-forms-control-to-a-factory-object.md)
+# [方法 : Windows フォームからリソースに埋め込まれたサウンドを再生する](how-to-play-a-sound-embedded-in-a-resource-from-a-windows-form.md)
+# [MainMenu コンポーネント](mainmenu-component-windows-forms.md)
+# [方法 : Windows フォーム TabControl の表示形式を変更する](how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)
+# [ListBox の代わりに Windows フォーム ComboBox を使用する場合](when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)
+# [BindingSource コンポーネント アーキテクチャ](bindingsource-component-architecture.md)
+# [ShouldSerialize メソッドと Reset メソッドによる既定値の定義](defining-default-values-with-the-shouldserialize-and-reset-methods.md)
+# [方法 : Windows フォームのボタンのクリックに応答する](how-to-respond-to-windows-forms-button-clicks.md)
+# [方法 : 複合コントロールを作成する](how-to-author-composite-controls.md)
+# [FolderBrowserDialog コンポーネントの概要 (Windows フォーム)](folderbrowserdialog-component-overview-windows-forms.md)
+# [PageSetupDialog コンポーネントの概要](pagesetupdialog-component-overview-windows-forms.md)
+# [方法 : Windows フォーム ListView コントロールに列を追加する](how-to-add-columns-to-the-windows-forms-listview-control.md)
+# [方法 : ツール バー コントロールにボタンを追加する](how-to-add-buttons-to-a-toolbar-control.md)
+# [MonthCalendar コントロールの概要](monthcalendar-control-overview-windows-forms.md)
+# [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](basic-column-row-and-cell-features-wf-datagridview-control.md)
+# [方法 : 定型入力を設定する](how-to-set-the-input-mask.md)
+# [方法 : コントロールのコレクションに対して実行時にコントロールを追加または削除する](how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md)
+# [ContextMenuStrip コントロール](contextmenustrip-control.md)
+# [マネージ HTML DOM (Document Object Model) の非公開メンバーへのアクセス](accessing-unexposed-members-on-the-managed-html-document-object-model.md)
+# [方法 : フォームに標準メニュー項目を追加する](how-to-provide-standard-menu-items-to-a-form.md)
+# [方法 : Windows フォームのコントロールを作成する](how-to-author-controls-for-windows-forms.md)
+# [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)
+# [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](implementing-virtual-mode-wf-datagridview-control.md)
+# [方法 : PrintDialog コンポーネントを表示する](how-to-display-the-printdialog-component.md)
+# [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](add-and-remove-items-from-a-wf-combobox.md)
+# [方法 : Windows フォーム上のタブ オーダーを設定する](how-to-set-the-tab-order-on-windows-forms.md)
+# [ToolStrip コントロールのアーキテクチャ](toolstrip-control-architecture.md)
+# [方法 : ContextMenuStrip をコントロールに関連付ける](how-to-associate-a-contextmenustrip-with-a-control.md)
+# [SaveFileDialog コンポーネント](savefiledialog-component-windows-forms.md)
+# [StatusBar コントロール](statusbar-control-windows-forms.md)
+# [チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](creating-a-wf-control-design-time-features.md)
+# [Splitter コントロール](splitter-control-windows-forms.md)
+# [各 Windows フォーム コントロールのラベル設定とショートカットの作成](labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)
+# [ダイアログ ボックス コントロールおよびコンポーネント](dialog-box-controls-and-components-windows-forms.md)
+# [WebBrowser コントロールの概要](webbrowser-control-overview.md)
+# [SplitContainer コントロールの概要](splitcontainer-control-overview-windows-forms.md)
+# [ColorDialog コンポーネントの概要](colordialog-component-overview-windows-forms.md)
+# [方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする](use-the-row-template-to-customize-rows-in-the-datagrid.md)
+# [方法 : PageSetupDialog コンポーネントを使用してページのプロパティを決定する](how-to-determine-page-properties-using-the-pagesetupdialog-component.md)
+# [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](performance-tuning-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする](link-to-an-object-or-web-page-with-wf-linklabel-control.md)
+# [方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える/フィルター処理する](sort-and-filter-ado-net-data-with-wf-bindingsource-component.md)
+# [ToolBar コントロール](toolbar-control-windows-forms.md)
+# [HelpProvider コンポーネントの概要](helpprovider-component-overview-windows-forms.md)
+# [方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する](how-to-create-an-html-document-viewer-in-a-windows-forms-application.md)
+# [方法 : 実行時にコントロールを非表示にする](how-to-make-your-control-invisible-at-run-time.md)
+# [方法 : データバインドされた Windows フォーム DataGridView コントロールに列を自動生成する](autogenerate-columns-in-a-data-bound-wf-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md)
+# [方法 : TreeView コントロールまたは ListView コントロール (Windows フォーム) にカスタム情報を追加する](add-custom-information-to-a-treeview-or-listview-control-wf.md)
+# [方法 : 文字列に引用符を挿入する](how-to-put-quotation-marks-in-a-string-windows-forms.md)
+# [方法 : UserControl クラスを継承する](how-to-inherit-from-the-usercontrol-class.md)
+# [Timer コンポーネント](timer-component-windows-forms.md)
+# [方法 : Windows フォーム TabControl のタブを追加および削除する](how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)
+# [BackgroundWorker コンポーネントの概要](backgroundworker-component-overview.md)
+# [方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する](how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)
+# [方法 : よく使用する場所をファイル ダイアログ ボックスに追加する](how-to-add-a-custom-place-to-a-file-dialog-box.md)
+# [方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する](programmatically-resize-cells-to-fit-content-in-the-datagrid.md)
+# [FlowLayoutPanel コントロール](flowlayoutpanel-control-windows-forms.md)
+# [AutoSize プロパティの概要](autosize-property-overview.md)
+# [Windows フォーム コントロール開発の基本概念](windows-forms-control-development-basics.md)
+# [方法 : Windows フォーム BindingSource コンポーネントを使用してルックアップ テーブルを作成する](how-to-create-a-lookup-table-with-the-windows-forms-bindingsource-component.md)
+# [Windows フォーム DataGridView コントロールにおける新規レコード行の使用](using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム ListView コントロールの項目をグループ化する](how-to-group-items-in-a-windows-forms-listview-control.md)
+# [方法 : 読み取り専用テキスト ボックスを作成する](how-to-create-a-read-only-text-box-windows-forms.md)
+# [方法 : Windows フォームの Label コントロールでアクセス キーを作成する](how-to-create-access-keys-with-windows-forms-label-controls.md)
+# [方法 : Windows フォーム DataGridView コントロールの列の順序を変更する](how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md)
+# [Windows フォーム コントロールの機能別一覧](windows-forms-controls-by-function.md)
+# [方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする](disable-buttons-in-a-button-column-in-the-datagrid.md)
+# [方法 : 内在コントロールのプロパティを公開する](how-to-expose-properties-of-constituent-controls.md)
+# [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)
+# [ProgressBar コントロール](progressbar-control-windows-forms.md)
+# [方法 : Windows フォームの NumericUpDown コントロールを使用して数値を設定および取得する](set-and-return-numeric-values-with-wf-numericupdown-control.md)
+# [オプションのリストを表示するための Windows フォーム コントロール](windows-forms-controls-used-to-list-options.md)
+# [NotifyIcon コンポーネントの概要](notifyicon-component-overview-windows-forms.md)
+# [方法 : バックグラウンドで操作を実行する](how-to-run-an-operation-in-the-background.md)
+# [方法 :デザイナーを使って Windows フォーム ListView コントロールに列を追加する](how-to-add-columns-to-the-windows-forms-listview-control-using-the-designer.md)
+# [PrintDocument コンポーネント](printdocument-component-windows-forms.md)
+# [方法 : デザイナーを使って Windows フォーム コントロールを型にバインドする](how-to-bind-a-windows-forms-control-to-a-type-using-the-designer.md)
+# [チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)
+# [方法 : 既存のコントロールを別の親に再配置する](how-to-reassign-existing-controls-to-a-different-parent.md)
+# [方法 : Windows フォームにコントロールを固定する](how-to-anchor-controls-on-windows-forms.md)
+# [方法 : フォームの端に合わせてコントロールを配置する](how-to-align-a-control-to-the-edges-of-forms.md)
+# [方法 : セットとして機能する Windows フォーム RadioButton コントロールをグループ化する](how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md)
+# [方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する](how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する](set-the-sort-modes-for-columns-wf-datagridview-control.md)
+# [方法 : デザイナーを使って ImageList イメージを追加または削除する](how-to-add-or-remove-imagelist-images-with-the-designer.md)
+# [方法 : MDI アプリケーションでメニューの自動マージを設定する](how-to-set-up-automatic-menu-merging-for-mdi-applications.md)
+# [方法 : ListView コントロールに検索機能を追加する](how-to-add-search-capabilities-to-a-listview-control.md)
+# [内在コントロール](constituent-controls.md)
+# [方法 : DHTML コードとクライアント アプリケーション コード間の双方向の通信を実装する](implement-two-way-com-between-dhtml-and-client.md)
+# [方法 : Windows フォームに ActiveX コントロールを追加する](how-to-add-activex-controls-to-windows-forms.md)
+# [FontDialog コンポーネント](fontdialog-component-windows-forms.md)
+# [方法 : マネージ HTML DOM (Document Object Model) の HTML ソースにアクセスする](how-to-access-the-html-source-in-the-managed-html-document-object-model.md)
+# [方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する](how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md)
+# [方法 : デザイナーを使って Windows フォーム DataGrid コントロールの書式を設定する](how-to-format-the-windows-forms-datagrid-control-using-the-designer.md)
+# [方法 : 実行時に ToolStrip レンダラーを設定する](how-to-set-the-toolstrip-renderer-at-run-time.md)
+# [コントロールの種類に関するアドバイス](control-type-recommendations.md)
+# [方法 : ファイル関連のダイアログ ボックスの自動アップグレードを無効にする](how-to-opt-out-of-file-dialog-box-automatic-upgrade.md)
+# [方法 : Windows フォームの DataGridView コントロールの行を操作する](how-to-manipulate-rows-in-the-windows-forms-datagridview-control.md)
+# [方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する](how-to-add-controls-without-a-user-interface-to-windows-forms.md)
+# [方法 : デザイン時にフォームの端に合わせてコントロールを配置する](how-to-align-a-control-to-the-edges-of-forms-at-design-time.md)
+# [DateTimePicker コントロールの概要](datetimepicker-control-overview-windows-forms.md)
+# [方法 : Windows フォーム コントロールのアクセス キーを作成する](how-to-create-access-keys-for-windows-forms-controls.md)
+# [方法 : ToolStripPanel を結合する](how-to-join-toolstrippanels.md)
+# [方法 : デザイナーを使ってデータ ソースに Windows フォーム DataGrid コントロールをバインドする](bind-wf-datagrid-control-to-a-data-source-using-the-designer.md)
+# [方法 : UserControl の実行時の動作をテストする](how-to-test-the-run-time-behavior-of-a-usercontrol.md)
+# [方法 : デザイナーを使用してピクチャを読み込む](how-to-load-a-picture-using-the-designer-windows-forms.md)
+# [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する](create-a-lookup-table-for-a-wf-combobox-listbox.md)
+# [方法 : デザイナーを使用して Windows フォーム コントロールのアクセス キーを作成する](how-to-create-access-keys-for-windows-forms-controls-using-the-designer.md)
+# [Windows フォーム DataGridView コントロールでのデータ入力](data-entry-in-the-windows-forms-datagridview-control.md)
+# [方法 : デザイナーを使って Windows フォーム DataGrid コントロールにテーブルと列を追加する](add-tables-and-columns-to-wf-datagrid-control-using-the-designer.md)
+# [方法 : Windows フォームの RichTextBox コントロールを使用してファイルを保存する](how-to-save-files-with-the-windows-forms-richtextbox-control.md)
+# [ContextMenu コンポーネントの概要](contextmenu-component-overview-windows-forms.md)
+# [方法 : デザイナーで Windows フォーム TabControl を使ってタブを追加および削除する](add-and-remove-tabs-with-wf-tabcontrol-using-the-designer.md)
+# [方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](customize-the-appearance-of-cells-in-the-datagrid.md)
+# [方法 : Windows フォームの LinkLabel コントロールから Web ページを表示する (Visual Basic)](display-a-web-page-from-a-wf-linklabel-control-visual-basic.md)
+# [方法 : コントロール クラスを継承する](how-to-inherit-from-the-control-class.md)
+# [方法 : アプリケーションの ToolStrip レンダラーを設定する](how-to-set-the-toolstrip-renderer-for-an-application.md)
+# [方法 : Windows フォーム上のコントロールを位置設定する](how-to-position-controls-on-windows-forms.md)
+# [チュートリアル : バックグラウンド操作を使用するフォームの実装](walkthrough-implementing-a-form-that-uses-a-background-operation.md)
+# [方法 : MenuStrip のチェックの余白とイメージの余白を設定する](how-to-configure-menustrip-check-margins-and-image-margins.md)
+# [方法 : Windows フォーム FolderBrowserDialog コンポーネントを使用してフォルダーを選択する](how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md)
+# [Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理](default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md)
+# [PrintPreviewControl コントロールの概要](printpreviewcontrol-control-overview-windows-forms.md)
+# [BindingNavigator コントロールの概要](bindingnavigator-control-overview-windows-forms.md)
+# [Windows フォーム DataGridView コントロールの既定の機能](default-functionality-in-the-windows-forms-datagridview-control.md)
+# [Windows フォーム DataGridView コントロール内の列の並べ替えモード](column-sort-modes-in-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム TextBox コントロールで複数行を表示する](how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)
+# [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md)
+# [方法 : Windows フォーム ContextMenu コンポーネントのメニュー項目を追加および削除する](add-and-remove-menu-items-with-wf-contextmenu-component.md)
+# [方法 : ToolStripMenuItems を非表示にする](how-to-hide-toolstripmenuitems.md)
+# [方法 : マネージ HTML DOM (Document Object Model) にアクセスする](how-to-access-the-managed-html-document-object-model.md)
+# [方法 : Tab キーで ToolStrip コントロールから移動できるようにする](how-to-enable-the-tab-key-to-move-out-of-a-toolstrip-control.md)
+# [PrintPreviewControl コントロール](printpreviewcontrol-control-windows-forms.md)
+# [ToolTip コンポーネントの概要](tooltip-component-overview-windows-forms.md)
+# [方法 : WebBrowser コントロールを使用して印刷する](how-to-print-with-a-webbrowser-control.md)
+# [方法 : Windows フォームの DataGridView コントロールの列を非表示にする](how-to-hide-columns-in-the-windows-forms-datagridview-control.md)
+# [DomainUpDown コントロールの概要](domainupdown-control-overview-windows-forms.md)
+# [BindingSource コンポーネント](bindingsource-component.md)
+# [方法 : Windows フォームからサウンドを再生する](how-to-play-a-sound-from-a-windows-form.md)
+# [さまざまなカスタム コントロール](varieties-of-custom-controls.md)
+# [方法 : Windows フォーム内でサウンドを非同期的に読み込む](how-to-load-a-sound-asynchronously-within-a-windows-form.md)
+# [方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する](display-error-icons-for-form-validation-with-wf-errorprovider.md)
+# [方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する](display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md)
+# [方法 : デザイナーを使用して Windows フォーム コントロールを BindingSource コンポーネントにバインドする](bind-wf-controls-with-the-bindingsource.md)
+# [FlowLayoutPanel コントロールの概要](flowlayoutpanel-control-overview.md)
+# [方法 : デザイナーを使用してウィンドウを水平方向に分割する](how-to-split-a-window-horizontally-using-the-designer.md)
+# [方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する](how-to-add-web-browser-capabilities-to-a-windows-forms-application.md)
+# [組み込みのオーナー描画サポートを備えたコントロール](controls-with-built-in-owner-drawing-support.md)
+# [ListBox コントロールの概要](listbox-control-overview-windows-forms.md)
+# [TrackBar コントロール](trackbar-control-windows-forms.md)
+# [Panel コントロール](panel-control-windows-forms.md)
+# [ToolStripContainer コントロール](toolstripcontainer-control.md)
+# [Windows フォーム コントロールでのマージンと埋め込み](margin-and-padding-in-windows-forms-controls.md)
+# [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](how-to-set-the-text-displayed-by-a-windows-forms-control.md)
+# [方法 : すべての Windows フォームにグリッド オプションを設定する](how-to-set-grid-options-for-all-windows-forms.md)
+# [カスタム コントロールへのメソッドの実装](method-implementation-in-custom-controls.md)
+# [方法 : デザイナーで Windows フォーム TreeView コントロールを使ってノードを追加および削除する](add-and-remove-nodes-with-wf-treeview-control-using-the-designer.md)
+# [方法 : FontDialog コンポーネントを使用してフォントの一覧を表示する](how-to-show-a-font-list-with-the-fontdialog-component.md)
+# [方法 : MaskedTextBox コントロールにデータをバインドする](how-to-bind-data-to-the-maskedtextbox-control.md)
+# [方法 : ContextMenuStrip のチェックの余白とイメージの余白を設定する](how-to-configure-contextmenustrip-check-margins-and-image-margins.md)
+# [方法 : Windows フォーム DataGridView コントロールで Just-In-Time データ読み込みを使用して仮想モードを実装する](virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md)
+# [TableLayoutPanel コントロールの概要](tablelayoutpanel-control-overview.md)
+# [NumericUpDown コントロール](numericupdown-control-windows-forms.md)
+# [方法 : コントロールに透明な背景を指定する](how-to-give-your-control-a-transparent-background.md)
+# [RichTextBox コントロール](richtextbox-control-windows-forms.md)
+# [方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する](designate-a-wf-button-as-the-cancel-button-using-the-designer.md)
+# [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](handling-errors-that-occur-during-data-entry-in-the-datagrid.md)
+# [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)
+# [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](walkthrough-automatically-populating-the-toolbox-with-custom-components.md)
+# [方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](change-the-border-and-gridline-styles-in-the-datagrid.md)
+# [方法 : Windows フォーム DataGridView コントロールの選択モードを設定する](how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md)
+# [方法 : Windows フォーム DataGridView コントロールの列を固定する](how-to-freeze-columns-in-the-windows-forms-datagridview-control.md)
+# [SplitContainer コントロール](splitcontainer-control-windows-forms.md)
+# [Windows フォーム コントロールの属性](attributes-in-windows-forms-controls.md)
+# [方法 : Windows フォームの RichTextBox コントロールのフォント属性を設定する](how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md)
+# [方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)
+# [TabControl コントロールの概要](tabcontrol-control-overview-windows-forms.md)
+# [方法 : Windows フォームにコントロールを追加する](how-to-add-controls-to-windows-forms.md)
+# [方法 : Windows フォームの CheckBox コントロールでオプションを設定する](how-to-set-options-with-windows-forms-checkbox-controls.md)
+# [方法 : Windows フォーム DataGridView コントロールの各セルにツールヒントを追加する](add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md)
+# [CheckedListBox コントロール](checkedlistbox-control-windows-forms.md)
+# [Windows フォーム コントロールのプロパティ](properties-in-windows-forms-controls.md)
+# [プロパティ変更イベント](property-changed-events.md)
+# [ColorDialog コンポーネント](colordialog-component-windows-forms.md)
+# [Button コントロールの概要](button-control-overview-windows-forms.md)
+# [方法 : Windows フォームの Button コントロールをキャンセル ボタンとして指定する](how-to-designate-a-windows-forms-button-as-the-cancel-button.md)
+# [Windows フォームで ActiveX コントロールをホストする場合の考慮事項](considerations-when-hosting-an-activex-control-on-a-windows-form.md)
+# [方法 : 進行状況を示す Windows フォーム コントロールを作成する](how-to-create-a-windows-forms-control-that-shows-progress.md)
+# [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](developing-custom-windows-forms-controls.md)
+# [MaskedTextBox コントロール](maskedtextbox-control-windows-forms.md)
+# [方法 : Windows フォームの Button コントロールを承認ボタンとして指定する](how-to-designate-a-windows-forms-button-as-the-accept-button.md)
+# [方法 : デザイナーで Windows フォーム ListView コントロールを使って項目を追加および削除する](add-and-remove-items-with-wf-listview-control-using-the-designer.md)
+# [方法 : Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する](how-to-create-master-detail-lists-with-the-windows-forms-datagrid-control.md)
+# [NotifyIcon コンポーネント](notifyicon-component-windows-forms.md)
+# [Label コントロール](label-control-windows-forms.md)
+# [チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](walkthrough-debugging-custom-windows-forms-controls-at-design-time.md)
+# [方法 : メニュー項目を ContextMenuStrip に追加する](how-to-add-menu-items-to-a-contextmenustrip.md)
+# [方法 : Windows フォームの DataGridView コントロールのバンドを操作する](how-to-manipulate-bands-in-the-windows-forms-datagridview-control.md)
+# [方法 : 既存の Windows フォーム コントロールから継承する](how-to-inherit-from-existing-windows-forms-controls.md)
+# [DateTimePicker コントロール](datetimepicker-control-windows-forms.md)
+# [DataGrid コントロール](datagrid-control-windows-forms.md)
+# [方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する](automatically-resize-cells-when-content-changes-in-the-datagrid.md)
+# [PageSetupDialog コンポーネント](pagesetupdialog-component-windows-forms.md)
+# [DataGridView コントロールのアーキテクチャ](datagridview-control-architecture-windows-forms.md)
+# [チュートリアル : 操作をバックグラウンドで実行する](walkthrough-running-an-operation-in-the-background.md)
+# [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)
+# [方法 : Windows フォーム上のオブジェクトをレイヤー化する](how-to-layer-objects-on-windows-forms.md)
+# [方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする](how-to-customize-item-addition-with-the-windows-forms-bindingsource.md)
+# [方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)
+# [方法 : デザイナーで Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する](create-master-details-lists-with-wf-datagrid-control-using-the-designer.md)
+# [方法 : 実行時にピクチャを設定する](how-to-set-pictures-at-run-time-windows-forms.md)
+# [BindingNavigator コントロール](bindingnavigator-control-windows-forms.md)
+# [方法 : StatusStrip 内で Spring プロパティを対話的に使用する](how-to-use-the-spring-property-interactively-in-a-statusstrip.md)
+# [方法 : ToolStripMenuItems をコピーする](how-to-copy-toolstripmenuitems.md)
+# [方法 : Windows フォーム CheckedListBox コントロールでオンになっている項目を判断する](how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md)
+# [方法 : データを Windows フォーム DataGridView コントロールにバインドする](how-to-bind-data-to-the-windows-forms-datagridview-control.md)
+# [方法 : マネージ HTML DOM (Document Object Model) の要素のスタイルを変更する](how-to-change-styles-on-an-element-in-the-managed-html-document-object-model.md)
+# [方法 : Windows フォームの BindingNavigator コントロールを使用して DataSet を移動する](move-through-a-dataset-with-wf-bindingnavigator-control.md)
+# [方法 : Windows フォーム コントロールのスレッド セーフな呼び出しを行う](how-to-make-thread-safe-calls-to-windows-forms-controls.md)
+# [方法 : デザイナーを使って Windows フォーム ListView コントロールの "並べて表示" ビューを有効にする](enable-tile-view-in-a-wf-listview-control-using-the-designer.md)
+# [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)
+# [WebBrowser コントロール](webbrowser-control-windows-forms.md)
+# [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールの特定の項目にアクセスする](access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md)
+# [方法 : ToolStrip に ToolStripItem を配置する](how-to-position-a-toolstripitem-on-a-toolstrip.md)
+# [方法 : TabControl を使用して側面に位置を合わせて表示する](how-to-display-side-aligned-tabs-with-tabcontrol.md)
+# [方法 : Windows フォーム間でコントロールをコピーする](how-to-copy-controls-between-windows-forms.md)
+# [方法 : MDI ドロップダウン メニューに MenuStrip を挿入する](how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md)
+# [方法 : コントロールにツールボックス ビットマップを指定する](how-to-provide-a-toolbox-bitmap-for-a-control.md)
+# [TreeView コントロールの概要](treeview-control-overview-windows-forms.md)
+# [方法 : ToolStrip の項目を動的に追加する](how-to-add-toolstrip-items-dynamically.md)
+# [方法 : ToolStripTextBox を拡大して ToolStrip の残りの幅に合わせる](stretch-a-toolstriptextbox-to-fill-the-remaining-width-of-a-toolstrip-wf.md)
+# [方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する](how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md)
+# [方法 : Windows フォーム ProgressBar コントロールによって表示される値を設定する](how-to-set-the-value-displayed-by-the-windows-forms-progressbar-control.md)
+# [方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする](how-to-access-objects-bound-to-windows-forms-datagridview-rows.md)
+# [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](programming-with-cells-rows-and-columns-in-the-datagrid.md)
+# [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)
+# [方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する](change-displayed-data-at-run-time-wf-datagrid-control.md)
+# [方法 : DateTimePicker コントロールを使用して時間を表示する](how-to-display-time-with-the-datetimepicker-control.md)
+# [方法 : Windows フォーム GroupBox コントロールを使用してコントロールをグループ化する](how-to-group-controls-with-the-windows-forms-groupbox-control.md)
+# [ToolStripStatusLabel コントロールの概要](toolstripstatuslabel-control-overview.md)
+# [DataGridView コントロールの概要](datagridview-control-overview-windows-forms.md)
+# [PrintDialog コンポーネント](printdialog-component-windows-forms.md)
+# [DataGridView コントロールのシナリオ](datagridview-control-scenarios-windows-forms.md)
+# [ToolStripStatusLabel コントロール](toolstripstatuslabel-control.md)
+# [方法 : パネルの背景を設定する](how-to-set-the-background-of-a-windows-forms-panel.md)
+# [WebBrowser セキュリティ](webbrowser-security.md)
+# [チュートリアル : Visual C# による Windows フォーム コントロールからの継承](walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md)
+# [DataGridView コントロール テクノロジの概要](datagridview-control-technology-summary-windows-forms.md)
+# [方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)
+# [CheckBox コントロールの概要](checkbox-control-overview-windows-forms.md)
+# [Windows フォーム DataGridView コントロールでのデータの書式設定](data-formatting-in-the-windows-forms-datagridview-control.md)
+# [CheckBox コントロール](checkbox-control-windows-forms.md)
+# [方法 : クリックされた TreeView ノードを判別する](how-to-determine-which-treeview-node-was-clicked-windows-forms.md)
+# [MonthCalendar コントロール](monthcalendar-control-windows-forms.md)
+# [方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する](how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md)
+# [GroupBox コントロールの概要](groupbox-control-overview-windows-forms.md)
+# [ユーザー描画コントロール](user-drawn-controls.md)
+# [方法 : SaveFileDialog コンポーネントを使用してファイルを保存する](how-to-save-files-using-the-savefiledialog-component.md)
+# [方法 : デザイナーを使用して標準アイテムで基本的な ToolStrip を作成する](create-a-basic-wf-toolstrip-with-standard-items-using-the-designer.md)
+# [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](set-alternating-row-styles-for-the-datagrid-using-the-designer.md)
+# [チュートリアル : DesignerSerializationVisibilityAttribute を使用した、標準データ型のコレクションのシリアル化](serializing-collections-designerserializationvisibilityattribute.md)
+# [方法: [ツールボックス アイテムの選択] ダイアログ ボックスにコントロールを表示する](how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)
+# [Windows フォーム DataGridView コントロールのカスタマイズ](customizing-the-windows-forms-datagridview-control.md)
diff --git a/docs/framework/winforms/controls/access-objects-in-a-wf-datagridviewcomboboxcell-drop-down-list.md b/docs/framework/winforms/controls/access-objects-in-a-wf-datagridviewcomboboxcell-drop-down-list.md
new file mode 100644
index 00000000000..71ba63bdb60
--- /dev/null
+++ b/docs/framework/winforms/controls/access-objects-in-a-wf-datagridviewcomboboxcell-drop-down-list.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : Windows フォームの DataGridViewComboBoxCell ドロップダウン リストのオブジェクトにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンボ ボックス, アクセス (DataGridViewComboBoxCell ドロップダウン リストのオブジェクトに)"
+  - "コンボ ボックス, DataGridView コントロール内の"
+  - "DataGridView コントロール [Windows フォーム], アクセス (コンボ ボックス セルのオブジェクトに)"
+ms.assetid: bcbe794a-d1fa-47f8-b5a3-5f085b32097d
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : Windows フォームの DataGridViewComboBoxCell ドロップダウン リストのオブジェクトにアクセスする
+<xref:System.Windows.Forms.ComboBox> コントロールと同様に、<xref:System.Windows.Forms.DataGridViewComboBoxColumn> 型と <xref:System.Windows.Forms.DataGridViewComboBoxCell> 型を使用すると、任意のオブジェクトをドロップダウン リストに追加できます。  この機能を使用して、対応するオブジェクトを別のコレクションに格納しなくても、ドロップダウン リストで複雑な状態を表現できます。  
+  
+ <xref:System.Windows.Forms.ComboBox> コントロールとは異なり、<xref:System.Windows.Forms.DataGridView> 型には、現在選択しているオブジェクトを取得する <xref:System.Windows.Forms.ComboBox.SelectedItem%2A> プロパティがありません。  代わりに、<xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A?displayProperty=fullName> プロパティまたは <xref:System.Windows.Forms.DataGridViewComboBoxCell.ValueMember%2A?displayProperty=fullName> プロパティを、ビジネス オブジェクトのプロパティ名に設定する必要があります。  ユーザーが選択すると、指定したビジネス オブジェクトのプロパティによってセルの <xref:System.Windows.Forms.DataGridViewCell.Value%2A> プロパティが設定されます。  
+  
+ セルの値からビジネス オブジェクトを取得するには、`ValueMember` プロパティで、ビジネス オブジェクト自体への参照を返すプロパティを指定する必要があります。  そのため、使用するコントロールにその型のビジネス オブジェクトがない場合、継承によって型を拡張することでそのようなプロパティを追加します。  
+  
+ 次の手順では、ビジネス オブジェクトでドロップダウン リストを作成する方法と、セルの <xref:System.Windows.Forms.DataGridViewCell.Value%2A> プロパティからオブジェクトを取得する方法の例を示します。  
+  
+### ビジネス オブジェクトをドロップダウン リストに追加するには  
+  
+1.  新しい <xref:System.Windows.Forms.DataGridViewComboBoxColumn> を作成し、<xref:System.Windows.Forms.DataGridViewComboBoxColumn.Items%2A> コレクションを作成します。  または、列の <xref:System.Windows.Forms.DataGridViewComboBoxColumn.DataSource%2A> プロパティをビジネス オブジェクトのコレクションに設定します。  ただし、この場合、対応するビジネス オブジェクトをコレクション内に作成せずに、"未割り当て" をドロップダウン リストに追加することはできません。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewComboBoxObjectBinding#110](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/CS/form1.cs#110)]
+     [!code-vb[System.Windows.Forms.DataGridViewComboBoxObjectBinding#110](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/vb/form1.vb#110)]  
+  
+2.  <xref:System.Windows.Forms.DataGridViewComboBoxColumn.DisplayMember%2A> プロパティおよび <xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A> プロパティを設定します。  <xref:System.Windows.Forms.DataGridViewComboBoxColumn.DisplayMember%2A>は、ドロップダウン リストに表示するビジネス オブジェクトのプロパティを示します。  <xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A> は、ビジネス オブジェクトへの参照を返すプロパティを示します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewComboBoxObjectBinding#115](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/CS/form1.cs#115)]
+     [!code-vb[System.Windows.Forms.DataGridViewComboBoxObjectBinding#115](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/vb/form1.vb#115)]  
+  
+3.  ビジネス オブジェクト型に、現在のインスタンスへの参照を返すプロパティが含まれていることを確認します。  このプロパティには、前の手順で <xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A> に割り当てた値と同じ名前を付けます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewComboBoxObjectBinding#310](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/CS/form1.cs#310)]
+     [!code-vb[System.Windows.Forms.DataGridViewComboBoxObjectBinding#310](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/vb/form1.vb#310)]  
+  
+### 現在選択されているビジネス オブジェクトを取得するには  
+  
+-   セルの <xref:System.Windows.Forms.DataGridViewCell.Value%2A> プロパティを取得し、ビジネス オブジェクト型にキャストします。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewComboBoxObjectBinding#120](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/CS/form1.cs#120)]
+     [!code-vb[System.Windows.Forms.DataGridViewComboBoxObjectBinding#120](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/vb/form1.vb#120)]  
+  
+## 使用例  
+ 完全な例では、ドロップダウン リストでのビジネス オブジェクトの使用法を示します。  この例では、<xref:System.Windows.Forms.DataGridView> コントロールは `Task` オブジェクトのコレクションにバインドされます。  各 `Task` オブジェクトには、現在そのタスクに割り当てられている `Employee` オブジェクトを示す `AssignedTo` プロパティがあります。  `Assigned To` 列には、割り当てられた各従業員の `Name` プロパティ値が表示されます。`Task.AssignedTo` プロパティ値が `null` の場合、"未割り当て" が表示されます。  
+  
+ この例の動作を表示するには、次の手順を実行します。  
+  
+1.  ドロップダウン リストの他の値を選択するか、コンボ ボックス セルで Ctrl キーを押しながら 0 キーを押して、`Assigned To` 列の割り当てを変更します。  
+  
+2.  `Generate Report` をクリックして現在の割り当てを表示します。  これで、`Assigned To` 列を変更すると、自動的に `tasks` コレクションが更新されることがわかります。  
+  
+3.  `Request Status` ボタンをクリックし、その行で現在の `Employee` オブジェクトの `RequestStatus` メソッドを呼び出します。  これで、選択したオブジェクトが正常に取得されることがわかります。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewComboBoxObjectBinding#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/CS/form1.cs#000)]
+ [!code-vb[System.Windows.Forms.DataGridViewComboBoxObjectBinding#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewComboBoxObjectBinding/vb/form1.vb#000)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System アセンブリと System.Windows.Forms アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn.Items%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn.DataSource%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxCell>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxCell.Items%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxCell.DataSource%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxCell.ValueMember%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCell.Value%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ComboBox>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md b/docs/framework/winforms/controls/access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md
new file mode 100644
index 00000000000..b721b84f19c
--- /dev/null
+++ b/docs/framework/winforms/controls/access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールの特定の項目にアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CheckedListBox コントロール [Windows フォーム], アクセス (項目に)"
+  - "コンボ ボックス, アクセス (項目に)"
+  - "ComboBox コントロール [Windows フォーム], アクセス (項目に)"
+  - "リスト ボックス, アクセス (項目に)"
+  - "ListBox コントロール [Windows フォーム], アクセス (項目に)"
+  - "ListBox コントロール [Windows フォーム], 返す (項目情報を)"
+ms.assetid: 1216742f-bcf9-4ff8-8a62-d7c9053c2b96
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールの特定の項目にアクセスする
+Windows フォームのコンボ ボックス、リスト ボックス、またはチェック ボックス付きリスト ボックス内の特定の項目にアクセスすることは、必要不可欠なタスクです。  アクセスすると、リスト内の特定の場所にある項目をプロクラムによって判断できます。  
+  
+### 特定の項目にアクセスするには  
+  
+1.  特定の項目のインデックスを使用して、`Items`  コレクションに問い合わせます。  
+  
+    ```vb  
+    Private Function GetItemText(i As Integer) As String  
+       ' Return the text of the item using the index:  
+       Return ComboBox1.Items(i).ToString  
+    End Function  
+  
+    ```  
+  
+    ```csharp  
+    private string GetItemText(int i)  
+    {  
+       // Return the text of the item using the index:  
+       return (comboBox1.Items[i].ToString());  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       String^ GetItemText(int i)  
+       {  
+          // Return the text of the item using the index:  
+          return (comboBox1->Items->Item[i]->ToString());  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ <xref:System.Windows.Forms.ListBox>   
+ <xref:System.Windows.Forms.CheckedListBox>   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/accessing-frames-in-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/accessing-frames-in-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..6ba154fd198
--- /dev/null
+++ b/docs/framework/winforms/controls/accessing-frames-in-the-managed-html-document-object-model.md
@@ -0,0 +1,54 @@
+---
+title: "マネージ HTML DOM (Document Object Model) へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DOM, アクセス (マネージ HTML のフレームに)"
+  - "フレーム, アクセス"
+  - "HTML DOM, マネージ"
+  - "HTML, DOM"
+  - "HTML, マネージ"
+  - "マネージ HTML DOM"
+ms.assetid: cdeeaa22-0be4-4bbf-9a75-4ddc79199f8d
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# マネージ HTML DOM (Document Object Model) へのアクセス
+HTML ドキュメントの中には、*フレーム*で構成されるものがあります。フレームは、別個の独自の HTML ドキュメントを持つウィンドウです。  フレームを使用すると、ページ内に 1 つ以上の静的な部分 \(ナビゲーション バーなど\) があり、その他のフレームでは内容が常に変化するような HTML ページを簡単に作成できます。  
+  
+ HTML の作成者は、2 つの方法のいずれかでフレームを作成できます。  
+  
+-   `FRAMESET` タグと `FRAME` タグを使用して、固定ウィンドウを作成する。  
+  
+ または  
+  
+-   `IFRAME` タグを使用して、実行時に移動できるフローティング ウィンドウを作成する。  
+  
+1.  フレームは HTML ドキュメントを含むため、DOM \(Document Object Model\) においてフレームはウィンドウ要素およびフレーム要素の両方として表されます  
+  
+2.  <xref:System.Windows.Forms.HtmlWindow> の Frames コレクションを使用して `FRAME` タグまたは `IFRAME` タグにアクセスすると、フレームに対応するウィンドウ要素を取得できます。  これは、現在の URL、ドキュメント、サイズなど、フレームのすべての動的プロパティを表します。  
+  
+3.  <xref:System.Windows.Forms.HtmlWindow> の <xref:System.Windows.Forms.HtmlWindow.WindowFrameElement%2A> プロパティ、<xref:System.Windows.Forms.HtmlElement.Children%2A> コレクション、または <xref:System.Windows.Forms.HtmlElementCollection.GetElementsByName%2A> や <xref:System.Windows.Forms.HtmlDocument.GetElementById%2A> などのメソッドを使用して `FRAME` タグまたは `IFRAME` タグにアクセスすると、フレーム要素を取得できます。  これは、元の HTML ファイルに指定されている URL を含む、フレームの静的プロパティを表します。  
+  
+## フレームとセキュリティ  
+ フレームへのアクセスが複雑なのは、マネージ HTML DOM が*クロスフレーム スクリプティング セキュリティ*と呼ばれるセキュリティ対策を実装していることによります。  異なるドメインに属する複数の `FRAME` を持つ `FRAMESET` がドキュメントに含まれる場合、これらの `FRAME` は相互にやり取りできません。  つまり、自分の Web サイトのコンテンツを表示する `FRAME` は、サード パーティのサイト \(http:\/\/www.adatum.com\/ など\) をホストする `FRAME` 内の情報にアクセスできません  このセキュリティは、<xref:System.Windows.Forms.HtmlWindow> クラスのレベルで実装されます  別の Web サイトをホストする `FRAME` に関する一般情報 \(URL など\) は取得できますが、Web サイトの <xref:System.Windows.Forms.HtmlWindow.Document%2A> へのアクセスや、ホストしている `FRAME` または `IFRAME` のサイズや位置の変更はできません。  
+  
+ この規則は、<xref:System.Windows.Forms.HtmlWindow.Open%2A> メソッドおよび <xref:System.Windows.Forms.HtmlWindow.OpenNew%2A> メソッドを使用して開くウィンドウにも適用されます。  開いたウィンドウが <xref:System.Windows.Forms.WebBrowser> コントロール内でホストされているページとは異なるドメインにある場合、そのウィンドウを移動したり、内容をチェックしたりできません。  このような制限は、<xref:System.Windows.Forms.WebBrowser> コントロールを使用して、Windows フォーム ベースのアプリケーションの配置に使用した Web サイトとは異なる Web サイトを表示する場合にも適用されます。  [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] 配置テクノロジを使用して Web サイト A からアプリケーションをインストールし、<xref:System.Windows.Forms.WebBrowser> を使用して Web サイト B を表示した場合、Web サイト B のデータにはアクセスできません。  
+  
+ クロスサイト スクリプティングの詳細については、「[クロスフレーム スクリプティングとセキュリティ](http://msdn.microsoft.com/library/ms533028.aspx)」を参照してください。  
+  
+## 参照  
+ [FRAME 要素 &#124; フレーム オブジェクト](http://msdn.microsoft.com/library/ms535250.aspx)   
+ [マネージ HTML DOM \(Document Object Model\) の使用](../../../../docs/framework/winforms/controls/using-the-managed-html-document-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/accessing-unexposed-members-on-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/accessing-unexposed-members-on-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..9d9134bbcb2
--- /dev/null
+++ b/docs/framework/winforms/controls/accessing-unexposed-members-on-the-managed-html-document-object-model.md
@@ -0,0 +1,81 @@
+---
+title: "マネージ HTML DOM (Document Object Model) の非公開メンバーへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マネージ HTML DOM, アクセス (非公開メンバーに)"
+  - "非公開メンバー"
+ms.assetid: 762295bd-2355-4aa7-b43c-5bff997a33e6
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# マネージ HTML DOM (Document Object Model) の非公開メンバーへのアクセス
+マネージ HTML DOM \(Document Object Model\) には、すべての HTML 要素が共有するプロパティ、メソッド、およびイベントを公開する <xref:System.Windows.Forms.HtmlElement> というクラスが含まれています。  しかし、マネージ インターフェイスが直接公開しないメンバーへのアクセスが必要な場合があります。  ここでは、非公開メンバーにアクセスするための 2 つの方法について検討します。非公開メンバーには、Web ページ内部で定義される [!INCLUDE[jsprjscript](../../../../includes/jsprjscript-md.md)] 関数および VBScript 関数が含まれます。  
+  
+## マネージ インターフェイスを介した非公開メンバーへのアクセス  
+ <xref:System.Windows.Forms.HtmlDocument> および <xref:System.Windows.Forms.HtmlElement> は、非公開メンバーへのアクセスを可能にする 4 つのメソッドを提供します。  非公開メンバーの型および対応するメソッドを次の表に示します。  
+  
+|メンバーの型|メソッド|  
+|------------|----------|  
+|プロパティ \(<xref:System.Windows.Forms.HtmlElement>\)|<xref:System.Windows.Forms.HtmlElement.GetAttribute%2A><br /><br /> <xref:System.Windows.Forms.HtmlElement.SetAttribute%2A>|  
+|メソッド|<xref:System.Windows.Forms.HtmlElement.InvokeMember%2A>|  
+|イベント \(<xref:System.Windows.Forms.HtmlDocument>\)|<xref:System.Windows.Forms.HtmlDocument.AttachEventHandler%2A><br /><br /> <xref:System.Windows.Forms.HtmlDocument.DetachEventHandler%2A>|  
+|イベント \(<xref:System.Windows.Forms.HtmlElement>\)|<xref:System.Windows.Forms.HtmlElement.AttachEventHandler%2A><br /><br /> <xref:System.Windows.Forms.HtmlElement.DetachEventHandler%2A>|  
+|イベント \(<xref:System.Windows.Forms.HtmlWindow>\)|<xref:System.Windows.Forms.HtmlWindow.AttachEventHandler%2A><br /><br /> <xref:System.Windows.Forms.HtmlWindow.DetachEventHandler%2A>|  
+  
+ これらのメソッドを使用する場合、要素の基になる型が正しいことが前提になります。  ユーザーが `FORM` の値をサーバーに送信する前にいくつかの前処理を実行できるように、HTML ページにある `FORM` 要素の `Submit` イベントを待機するとします。  HTML を制御している場合、理想としては、一意の `ID` 属性を持つように `FORM` を定義します。  
+  
+```  
+<HTML>  
+  
+    <HEAD>  
+        <TITLE>Form Page</TITLE>  
+    </HEAD>  
+  
+    <BODY>  
+        <FORM ID="form1">  
+             ... form fields defined here ...  
+        </FORM>  
+    </BODY>  
+  
+</HTML>  
+```  
+  
+ このページを <xref:System.Windows.Forms.WebBrowser> コントロールに読み込むと、<xref:System.Windows.Forms.HtmlDocument.GetElementById%2A> メソッドを使用して、実行時に `FORM` を取得できます。引数には、`form1` を使用します。  
+  
+ [!code-csharp[System.Windows.Forms.HtmlElement#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.HtmlElement/CS/Form1.cs#10)]
+ [!code-vb[System.Windows.Forms.HtmlElement#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.HtmlElement/VB/Form1.vb#10)]  
+  
+## アンマネージ インターフェイスへのアクセス  
+ 各 DOM クラスによって公開されるアンマネージ コンポーネント オブジェクト モデル \(COM: Component Object Model\) インターフェイスを使用して、マネージ HTML DOM の非公開メンバーにアクセスすることもできます。  非公開メンバーに対して複数の呼び出しを行う必要がある場合や、マネージ HTML DOM によってラップされていない他のアンマネージ インターフェイスを非公開メンバーが返す場合には、この方法をお勧めします。  
+  
+ マネージ HTML DOM を通じて公開されるすべてのアンマネージ インターフェイスを次の表に示します。  各リンクをクリックすると、使用法の説明およびプログラム例が表示されます。  
+  
+|種類|アンマネージ インターフェイス|  
+|--------|---------------------|  
+|<xref:System.Windows.Forms.HtmlDocument>|<xref:System.Windows.Forms.HtmlDocument.DomDocument%2A>|  
+|<xref:System.Windows.Forms.HtmlElement>|<xref:System.Windows.Forms.HtmlElement.DomElement%2A>|  
+|<xref:System.Windows.Forms.HtmlWindow>|<xref:System.Windows.Forms.HtmlWindow.DomWindow%2A>|  
+|<xref:System.Windows.Forms.HtmlHistory>|<xref:System.Windows.Forms.HtmlHistory.DomHistory%2A>|  
+  
+ COM インターフェイスを使用する最も簡単な方法は、これはサポートされていませんがアプリケーションからアンマネージ HTML DOM ライブラリ （MSHTML.dll）への参照を追加します。  詳細については、 " " を参照してください [サポート技術情報の文書 934368](http://support.microsoft.com/kb/934368)。  
+  
+## スクリプト関数へのアクセス  
+ HTML ページでは、[!INCLUDE[jsprjscript](../../../../includes/jsprjscript-md.md)] や VBScript などのスクリプト言語を使用して 1 つ以上の関数を定義できます。  これらの関数は HTML ページの `SCRIPT` ページの内部に配置され、要求に応じて、または DOM のイベントに応答して実行できます。  
+  
+ HTML ページに定義したスクリプト関数は、<xref:System.Windows.Forms.HtmlDocument.InvokeScript%2A> メソッドを使用して呼び出すことができます。  スクリプト メソッドが HTML 要素を返す場合は、キャストを使用して、この返された結果を <xref:System.Windows.Forms.HtmlElement> に変換できます。  詳細とプログラム例については、<xref:System.Windows.Forms.HtmlDocument.InvokeScript%2A> に関するトピックを参照してください。  
+  
+## 参照  
+ [マネージ HTML DOM \(Document Object Model\) の使用](../../../../docs/framework/winforms/controls/using-the-managed-html-document-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..59cd6c99c8c
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "vs.DataGridViewAddColumnDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 追加 (列を)"
+  - "DataGridView コントロール [Windows フォーム], 削除 (列を)"
+ms.assetid: 9e709f35-0a8c-4e7e-b4c4-bacb7a834077
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する
+Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールには、データを表示するための列を含める必要があります。  コントロールに手動でデータを設定する場合は、手動で列を追加する必要があります。  別の方法として、コントロールをデータ ソースにバインドすることもできます。この場合、自動的に列が生成されデータが読み込まれます。  表示する列数を超える列がデータ ソースに含まれるときは、不要な列を削除できます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列を追加するには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の追加\]** を選択します。  
+  
+2.  **\[列の追加\]** ダイアログ ボックスで、**\[データバインド列\]** を選択し、データ ソースの列を選択します。または、**\[非バインド列\]** を選択し、提供されたフィールドを使用して列を定義します。  
+  
+3.  **\[追加\]** をクリックして列を追加します。既存の列がコントロールの表示領域いっぱいに表示されていない場合は、追加した列がデザイナーに表示されます。  
+  
+    > [!NOTE]
+    >  列のプロパティは、コントロールのスマート タグからアクセスできる **\[列の編集\]** ダイアログ ボックスで変更できます。  
+  
+### デザイナーを使用して列を削除するには  
+  
+1.  コントロールのスマート タグの **\[列の編集\]** をクリックします。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[削除\]** をクリックして列を削除します。削除した列がデザイナーに表示されなくなります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md b/docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md
new file mode 100644
index 00000000000..dbf97c4dccd
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md
@@ -0,0 +1,160 @@
+---
+title: "方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CheckedListBox コントロール [Windows フォーム], 追加と削除 (項目を)"
+  - "コンボ ボックス, 追加 (アイテムを)"
+  - "コンボ ボックス, 削除 (項目を)"
+  - "ComboBox コントロール [Windows フォーム], 追加と削除 (項目を)"
+  - "リスト ボックス, 追加 (アイテムを)"
+  - "リスト ボックス, 削除 (項目を)"
+  - "ListBox コントロール [Windows フォーム], 追加と削除 (項目を)"
+ms.assetid: 7224c8d2-4118-443e-ae1e-d7c17d1e69ee
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する
+Windows フォームのコンボ ボックス、リスト ボックス、およびチェック ボックス付きリスト ボックスは、さまざまなデータ ソースにバインドできます。このため、これらのコントロールに項目を追加する方法はいくつかあります。  ここでは、データ バインディングの必要がない、最も簡単な方法を示します。  通常、表示される項目は文字列ですが、任意のオブジェクトを使用することもできます。  コントロールに表示されているテキストは、オブジェクトの `ToString`  メソッドが返した値です。  
+  
+### 項目を追加するには  
+  
+1.  `ObjectCollection` クラスの `Add` メソッドを使用して、文字列またはオブジェクトを一覧に追加します。  コレクションは、`Items`  プロパティを使用して参照します。  
+  
+    ```vb  
+    ComboBox1.Items.Add("Tokyo")  
+  
+    ```  
+  
+    ```csharp  
+    comboBox1.Items.Add("Tokyo");  
+  
+    ```  
+  
+    ```cpp  
+    comboBox1->Items->Add("Tokyo");  
+    ```  
+  
+     または  
+  
+2.  `Insert`  メソッドを使用して、文字列またはオブジェクトをリスト内の任意の場所に挿入します。  
+  
+    ```vb  
+    CheckedListBox1.Items.Insert(0, "Copenhagen")  
+  
+    ```  
+  
+    ```csharp  
+    checkedListBox1.Items.Insert(0, "Copenhagen");  
+  
+    ```  
+  
+    ```cpp  
+    checkedListBox1->Items->Insert(0, "Copenhagen");  
+    ```  
+  
+     または  
+  
+3.  `Items`  コレクションに配列全体を割り当てます。  
+  
+    ```vb  
+    Dim ItemObject(9) As System.Object  
+    Dim i As Integer  
+       For i = 0 To 9  
+       ItemObject(i) = "Item" & i  
+    Next i  
+    ListBox1.Items.AddRange(ItemObject)  
+  
+    ```  
+  
+    ```csharp  
+    System.Object[] ItemObject = new System.Object[10];  
+    for (int i = 0; i <= 9; i++)  
+    {  
+       ItemObject[i] = "Item" + i;  
+    }  
+    listBox1.Items.AddRange(ItemObject);  
+  
+    ```  
+  
+    ```cpp  
+    Array<System::Object^>^ ItemObject = gcnew Array<System::Object^>(10);  
+    for (int i = 0; i <= 9; i++)  
+    {  
+       ItemObject[i] = String::Concat("Item", i.ToString());  
+    }  
+    listBox1->Items->AddRange(ItemObject);  
+    ```  
+  
+### 項目を削除するには  
+  
+1.  項目を削除するには、`Remove`  メソッドまたは `RemoveAt`  メソッドを呼び出します。  
+  
+     `Remove` に削除する項目を指定するには1 とおりの引数があります。`RemoveAt`指定したインデックス番号で項目を削除します。  
+  
+    ```vb  
+    ' To remove item with index 0:  
+    ComboBox1.Items.RemoveAt(0)  
+    ' To remove currently selected item:  
+    ComboBox1.Items.Remove(ComboBox1.SelectedItem)  
+    ' To remove "Tokyo" item:  
+    ComboBox1.Items.Remove("Tokyo")  
+  
+    ```  
+  
+    ```csharp  
+    // To remove item with index 0:  
+    comboBox1.Items.RemoveAt(0);  
+    // To remove currently selected item:  
+    comboBox1.Items.Remove(comboBox1.SelectedItem);  
+    // To remove "Tokyo" item:  
+    comboBox1.Items.Remove("Tokyo");  
+  
+    ```  
+  
+    ```cpp  
+    // To remove item with index 0:  
+    comboBox1->Items->RemoveAt(0);  
+    // To remove currently selected item:  
+    comboBox1->Items->Remove(comboBox1->SelectedItem);  
+    // To remove "Tokyo" item:  
+    comboBox1->Items->Remove("Tokyo");  
+    ```  
+  
+### すべての項目を削除するには  
+  
+1.  `Clear` メソッドを呼び出して、コレクションからすべての項目を削除します。  
+  
+    ```vb  
+    ListBox1.Items.Clear()  
+  
+    ```  
+  
+    ```csharp  
+    listBox1.Items.Clear();  
+  
+    ```  
+  
+    ```cpp  
+    listBox1->Items->Clear();  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ <xref:System.Windows.Forms.ListBox>   
+ <xref:System.Windows.Forms.CheckedListBox>   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](../../../../docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)   
+ [ListBox の代わりに Windows フォーム ComboBox を使用する場合](../../../../docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-items-with-wf-listview-control-using-the-designer.md b/docs/framework/winforms/controls/add-and-remove-items-with-wf-listview-control-using-the-designer.md
new file mode 100644
index 00000000000..9bd4cbc8af6
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-items-with-wf-listview-control-using-the-designer.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : デザイナーで Windows フォーム ListView コントロールを使って項目を追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ListView コントロール [Windows フォーム], 追加 (リスト項目を)"
+  - "ListView コントロール [Windows フォーム], データの読み込み"
+ms.assetid: 217611ee-fd11-4d39-9a54-a37c3e781be1
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : デザイナーで Windows フォーム ListView コントロールを使って項目を追加および削除する
+Windows フォームの <xref:System.Windows.Forms.ListView> コントロールに項目を追加するには、項目を指定し、その項目にプロパティを割り当てます。  リスト項目の追加または削除は、いつでも実行できます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ListView> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使って項目を追加または削除するには  
+  
+1.  <xref:System.Windows.Forms.ListView> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.ListView.Items%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+     **ListViewItem コレクション エディター**が表示されます。  
+  
+3.  項目を追加するには、**\[追加\]** をクリックします。  新規項目のプロパティ、たとえば <xref:System.Windows.Forms.ListView.Text%2A> プロパティや <xref:System.Windows.Forms.ListViewItem.ImageIndex%2A> プロパティなどを設定します。  
+  
+4.  項目を削除するには、項目を選択し、**\[削除\]** をクリックします。  
+  
+## 参照  
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)   
+ [方法 : Windows フォーム ListView コントロールの項目をグループ化する](../../../../docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-menu-items-with-wf-contextmenu-component.md b/docs/framework/winforms/controls/add-and-remove-menu-items-with-wf-contextmenu-component.md
new file mode 100644
index 00000000000..f2c210073e2
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-menu-items-with-wf-contextmenu-component.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : Windows フォーム ContextMenu コンポーネントのメニュー項目を追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, 追加 (アイテムを)"
+  - "コンテキスト メニュー, 例"
+  - "コンテキスト メニュー, 削除 (項目を)"
+  - "ContextMenu コンポーネント [Windows フォーム], 追加 (アイテムを)"
+  - "ContextMenu コンポーネント [Windows フォーム], 削除 (項目を)"
+  - "例 [Windows フォーム], コンテキスト メニュー"
+  - "ショートカット メニュー, 追加 (アイテムを)"
+  - "ショートカット メニュー, 例"
+  - "ショートカット メニュー, 削除 (項目を)"
+ms.assetid: 426d1eaf-7fb8-4b0b-8a33-5e8721786ea4
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム ContextMenu コンポーネントのメニュー項目を追加および削除する
+Windows フォームのショートカット メニューの項目を追加する方法および削除する方法を説明します。  
+  
+ Windows フォームの <xref:System.Windows.Forms.ContextMenu> コンポーネントには、選択したオブジェクトに関連付けられたコマンドのうち、頻繁に使用されるコマンドを簡単に実行するためのメニューが用意されています。  ショートカット メニューに項目を追加するには、<xref:System.Windows.Forms.MenuItem> オブジェクトを <xref:System.Windows.Forms.Menu.MenuItems%2A> コレクションに追加します。  
+  
+ ショートカット メニューから項目を完全に削除することもできますが、実行時にメニューを非表示または無効にした方がより適切です。  
+  
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.MenuStrip> と <xref:System.Windows.Forms.ContextMenuStrip> は、以前のバージョンの <xref:System.Windows.Forms.MainMenu> コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、<xref:System.Windows.Forms.MainMenu> および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+### ショートカット メニューから項目を削除するには  
+  
+1.  特定のメニュー項目を削除するには、<xref:System.Windows.Forms.ContextMenu> コンポーネントの <xref:System.Windows.Forms.Menu.MenuItems%2A> コレクションから、<xref:System.Windows.Forms.Menu.MenuItemCollection.Remove%2A> メソッドまたは <xref:System.Windows.Forms.Menu.MenuItemCollection.RemoveAt%2A> メソッドを使用します。  
+  
+    ```vb  
+    ' Removes the first item in the shortcut menu.  
+    ContextMenu1.MenuItems.RemoveAt(0)  
+    ' Removes a particular object from the shortcut menu.  
+    ContextMenu1.MenuItems.Remove(mnuItemNew)  
+  
+    ```  
+  
+    ```csharp  
+    // Removes the first item in the shortcut menu.  
+    contextMenu1.MenuItems.RemoveAt(0);  
+    // Removes a particular object from the shortcut menu.  
+    contextMenu1.MenuItems.Remove(mnuItemNew);  
+  
+    ```  
+  
+    ```cpp  
+    // Removes the first item in the shortcut menu.  
+    contextMenu1->MenuItems->RemoveAt(0);  
+    // Removes a particular object from the shortcut menu.  
+    contextMenu1->MenuItems->Remove(mnuItemNew);  
+    ```  
+  
+     または  
+  
+2.  メニューからすべての項目を削除するには、<xref:System.Windows.Forms.ContextMenu> コンポーネントの `MenuItems` コレクションから、`Clear` メソッドを使用します。  
+  
+    ```vb  
+    ContextMenu1.MenuItems.Clear()  
+  
+    ```  
+  
+    ```csharp  
+    contextMenu1.MenuItems.Clear();  
+  
+    ```  
+  
+    ```cpp  
+    contextMenu1->MenuItems->Clear();  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenu>   
+ [ContextMenu コンポーネント](../../../../docs/framework/winforms/controls/contextmenu-component-windows-forms.md)   
+ [ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-nodes-with-wf-treeview-control-using-the-designer.md b/docs/framework/winforms/controls/add-and-remove-nodes-with-wf-treeview-control-using-the-designer.md
new file mode 100644
index 00000000000..3d1965dda06
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-nodes-with-wf-treeview-control-using-the-designer.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : デザイナーで Windows フォーム TreeView コントロールを使ってノードを追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "ツリー ノード (TreeView コントロールの)"
+  - "TreeView コントロール [Windows フォーム], 追加 (ノードの)"
+  - "TreeView コントロール [Windows フォーム], 削除 (ノードを)"
+ms.assetid: 35bf1750-045e-4ec5-97cb-b47b0dbdaa2c
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : デザイナーで Windows フォーム TreeView コントロールを使ってノードを追加および削除する
+Windows フォームの <xref:System.Windows.Forms.TreeView> コントロールはノードを階層的に表示するため、ノードを追加するときには、どのノードを親ノードにするのかを考慮する必要があります。  
+  
+ 次の手順では、<xref:System.Windows.Forms.TreeView> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーでノードを追加または削除するには  
+  
+1.  <xref:System.Windows.Forms.TreeView> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.TreeView.Nodes%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+     **TreeNode エディター**が表示されます。  
+  
+3.  ノードを追加するには、ルート ノードが存在している必要があります。ルート ノードが存在しない場合は、まず **\[ルートの追加\]** をクリックしてルートを追加します。  次に、ルートまたはその他のノードを選択して **\[子の追加\]** をクリックし、子ノードを追加します。  
+  
+4.  ノードを削除するには、削除するノードを選択し、**\[削除\]** をクリックします。  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [TreeView コントロールの概要](../../../../docs/framework/winforms/controls/treeview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TreeView コントロールのアイコンを設定する](../../../../docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](../../../../docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md)   
+ [方法 : クリックされた TreeView ノードを判別する](../../../../docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-and-remove-tabs-with-wf-tabcontrol-using-the-designer.md b/docs/framework/winforms/controls/add-and-remove-tabs-with-wf-tabcontrol-using-the-designer.md
new file mode 100644
index 00000000000..e524f8c0fee
--- /dev/null
+++ b/docs/framework/winforms/controls/add-and-remove-tabs-with-wf-tabcontrol-using-the-designer.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : デザイナーで Windows フォーム TabControl を使ってタブを追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ ページ"
+  - "TabPage コントロール"
+  - "TabPage コントロール [Windows フォーム], 追加と削除 (タブを)"
+  - "タブ, 追加 (ページに)"
+  - "タブ, 削除 (ページから)"
+ms.assetid: 480633db-413a-45d2-9c8f-0427cc13adbe
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : デザイナーで Windows フォーム TabControl を使ってタブを追加および削除する
+コントロールを <xref:System.Windows.Forms.TabControl> フォームに配置した時点で、既定で 2 つのタブがコントロールにあります。  デザイナーを使ってタブを追加または削除できます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.TabControl> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使ってタブを追加または削除するには  
+  
+-   コントロールのスマート タグの **\[タブの追加\]** または **\[タブの削除\]** をクリックします。  
+  
+     または  
+  
+     **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.TabControl.TabPages%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックして **TabPage コレクション エディター**を表示します。  **\[追加\]** ボタンまたは **\[削除\]** ボタンをクリックします。  
+  
+## 参照  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)   
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md b/docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md
new file mode 100644
index 00000000000..f958061f78a
--- /dev/null
+++ b/docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md
@@ -0,0 +1,147 @@
+---
+title: "方法 : TreeView コントロールまたは ListView コントロール (Windows フォーム) にカスタム情報を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ListItem"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ListView コントロール"
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "ListView コントロール [Windows フォーム], 追加 (カスタム情報を)"
+  - "Tag プロパティ"
+  - "TreeView コントロール [Windows フォーム], 追加 (カスタム情報を)"
+ms.assetid: 68be11de-1d5b-430e-901f-cfbe48d14b19
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : TreeView コントロールまたは ListView コントロール (Windows フォーム) にカスタム情報を追加する
+Windows フォームの <xref:System.Windows.Forms.TreeView> コントロールに派生ノードを作成したり、<xref:System.Windows.Forms.ListView> コントロールに派生アイテムを作成したりできます。  派生によって、必要な任意のフィールドを追加できます。また、追加するフィールドを操作するための、カスタム メソッドやカスタム コンストラクターを追加することもできます。  この機能の用途の 1 つに、各ツリー ノードまたはリスト項目への Customer オブジェクトの割り当てがあります。  ここでは <xref:System.Windows.Forms.TreeView> コントロールでの例を示しますが、<xref:System.Windows.Forms.ListView> コントロールの場合も同様に操作できます。  
+  
+### ツリー ノードを派生させるには  
+  
+-   <xref:System.Windows.Forms.TreeNode> クラスから派生を行って、ファイル パスを記録するためのカスタム フィールドを持つノード クラスを新規作成します。  
+  
+    ```vb  
+    Class myTreeNode  
+       Inherits TreeNode  
+  
+       Public FilePath As String  
+  
+       Sub New(ByVal fp As String)  
+          MyBase.New()  
+          FilePath = fp  
+          Me.Text = fp.Substring(fp.LastIndexOf("\"))  
+       End Sub  
+    End Class  
+  
+    ```  
+  
+    ```csharp  
+    class myTreeNode : TreeNode  
+    {  
+       public string FilePath;  
+  
+       public myTreeNode(string fp)  
+       {  
+          FilePath = fp;  
+          this.Text = fp.Substring(fp.LastIndexOf("\\"));  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    ref class myTreeNode : public TreeNode  
+    {  
+    public:  
+       System::String ^ FilePath;  
+  
+       myTreeNode(System::String ^ fp)  
+       {  
+          FilePath = fp;  
+          this->Text = fp->Substring(fp->LastIndexOf("\\"));  
+       }  
+    };  
+    ```  
+  
+### 派生されたツリー ノードを使用するには  
+  
+1.  新しい派生ツリー ノードは、呼び出した関数に渡すパラメーターとして使用できます。  
+  
+     次の例では、テキスト ファイルの場所に対するパスとして My Documents フォルダーが設定されています。  これは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  
+  
+    ```vb  
+    ' You should replace the bold text file   
+    ' in the sample below with a text file of your own choosing.  
+    TreeView1.Nodes.Add(New myTreeNode (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\ TextFile.txt ") )  
+  
+    ```  
+  
+    ```csharp  
+    // You should replace the bold text file   
+    // in the sample below with a text file of your own choosing.  
+    // Note the escape character used (@) when specifying the path.  
+    treeView1.Nodes.Add(new myTreeNode (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       + @"\TextFile.txt") );  
+  
+    ```  
+  
+    ```cpp  
+    // You should replace the bold text file   
+    // in the sample below with a text file of your own choosing.  
+    treeView1->Nodes->Add(new myTreeNode(String::Concat(  
+       System::Environment::GetFolderPath  
+       (System::Environment::SpecialFolder::Personal),  
+       "\\TextFile.txt")));  
+    ```  
+  
+2.  渡されたツリー ノードが <xref:System.Windows.Forms.TreeNode> クラスに分類される場合は、派生クラスへのキャストを行う必要があります。  キャストとは、オブジェクトを他の型に明示的に変換することです。  キャストの詳細については、「[Implicit and Explicit Conversions](../Topic/Implicit%20and%20Explicit%20Conversions%20\(Visual%20Basic\).md)」 \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の場合\)、「[\(\) 演算子](../Topic/\(\)%20Operator%20\(C%23%20Reference\).md)」 \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] の場合\)、または「[キャスト演算子: \(\)](../../../../amples/snippets/visualbasic/VS_Snippets_Wpf/DocumentStructure/visualbasic/spec_withstructure-xps/_rels/.rels)」 \([!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] の場合\) を参照してください。  
+  
+    ```vb  
+    Public Sub TreeView1_AfterSelect(ByVal sender As Object, ByVal e As System.Windows.Forms.TreeViewEventArgs) Handles TreeView1.AfterSelect  
+       Dim mynode As myTreeNode  
+       mynode = CType(e.node, myTreeNode)  
+       MessageBox.Show("Node selected is " & mynode.filepath)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void treeView1_AfterSelect (object sender,  
+    System.Windows.Forms.TreeViewEventArgs e)  
+    {  
+       myTreeNode myNode = (myTreeNode)e.Node;  
+       MessageBox.Show("Node selected is " + myNode.FilePath);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void treeView1_AfterSelect(System::Object ^  sender,  
+          System::Windows::Forms::TreeViewEventArgs ^  e)  
+       {  
+          myTreeNode ^ myNode = safe_cast<myTreeNode^>(e->Node);  
+          MessageBox::Show(String::Concat("Node selected is ",   
+             myNode->FilePath));  
+       }  
+    ```  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-tables-and-columns-to-wf-datagrid-control-using-the-designer.md b/docs/framework/winforms/controls/add-tables-and-columns-to-wf-datagrid-control-using-the-designer.md
new file mode 100644
index 00000000000..14c49b35696
--- /dev/null
+++ b/docs/framework/winforms/controls/add-tables-and-columns-to-wf-datagrid-control-using-the-designer.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム DataGrid コントロールにテーブルと列を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 追加 (DataGrid コントロールに)"
+  - "DataGrid コントロール [Windows フォーム], 追加 (テーブルと列を)"
+  - "テーブル [Windows フォーム], 追加 (DataGrid コントロールに)"
+ms.assetid: 4a6d1b34-b696-476b-bf8a-57c6230aa9e1
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : デザイナーを使って Windows フォーム DataGrid コントロールにテーブルと列を追加する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロールのデータをテーブルおよび列に表示するには、<xref:System.Windows.Forms.DataGridTableStyle> オブジェクトを作成して <xref:System.Windows.Forms.GridTableStylesCollection> オブジェクトに追加します。GridTableStylesCollection オブジェクトには、<xref:System.Windows.Forms.DataGrid> コントロールの <xref:System.Windows.Forms.DataGrid.TableStyles%2A> プロパティを使用してアクセスできます。  各テーブル スタイルは、<xref:System.Windows.Forms.DataGridTableStyle> の <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> プロパティで指定されたデータ テーブルの内容を表示します。  既定では、列スタイルが指定されていないテーブル スタイルには、そのデータ テーブル内のすべての列が表示されます。  テーブルから表示される列を制限するには、<xref:System.Windows.Forms.DataGridColumnStyle> オブジェクトを <xref:System.Windows.Forms.GridColumnStylesCollection> に追加します。<xref:System.Windows.Forms.GridColumnStylesCollection> にアクセスするには、各 <xref:System.Windows.Forms.DataGridTableStyle> の <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A> プロパティを使用します。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGrid> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、既定で <xref:System.Windows.Forms.DataGrid> コントロールは**ツールボックス**に含まれていません。  コントロールの追加の詳細については、「[How to: Add Items to the Toolbox](http://msdn.microsoft.com/ja-jp/458e119e-17fe-450b-b889-e31c128bd7e0)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーで DataGrid コントロールにテーブルを追加するには  
+  
+1.  データをテーブルに表示するには、まず <xref:System.Windows.Forms.DataGrid> コントロールをデータセットにバインドする必要があります。  詳細については、「[方法 : デザイナーを使ってデータ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/bind-wf-datagrid-control-to-a-data-source-using-the-designer.md)」を参照してください。  
+  
+2.  \[プロパティ\] ウィンドウで <xref:System.Windows.Forms.DataGrid> コントロールの <xref:System.Windows.Forms.DataGrid.TableStyles%2A> プロパティを選択し、プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして **DataGridTableStyle コレクション エディター**を表示します。  
+  
+3.  コレクション エディターで、**\[追加\]** をクリックしてテーブル スタイルを挿入します。  
+  
+4.  **\[OK\]** をクリックしてコレクション エディターを閉じ、<xref:System.Windows.Forms.DataGrid.TableStyles%2A> プロパティの省略記号ボタンをクリックして再び開きます。  
+  
+     コレクション エディターを再び開くと、コントロールに連結されているデータ テーブルが、テーブル スタイルの <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> プロパティのドロップダウン リストに表示されます。  
+  
+5.  コレクション エディターの **\[メンバー\]** ボックスで、テーブル スタイルをクリックします。  
+  
+6.  コレクション エディターの **\[プロパティ\]** ボックスで、表示するテーブルの <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> 値を選択します。  
+  
+### デザイナーで DataGrid コントロールに列を追加するには  
+  
+1.  **DataGridTableStyle** コレクション エディターの **\[メンバー\]** ボックスで、適切なテーブル スタイルを選択します。  コレクション エディターの **\[プロパティ\]** ボックスで <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A> コレクションを選択し、プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして **DataGridColumnStyle コレクション エディター**を開きます。  
+  
+2.  コレクション エディターで、**\[追加\]** をクリックして列スタイルを挿入するか、**\[追加\]** の横にある下向きの矢印をクリックして列の種類を指定します。  
+  
+     ドロップダウン リストからは、<xref:System.Windows.Forms.DataGridTextBoxColumn> または <xref:System.Windows.Forms.DataGridBoolColumn> を選択できます。  
+  
+3.  \[OK\] をクリックして **DataGridColumnStyle コレクション エディター**を閉じ、<xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A> プロパティの省略記号ボタンをクリックして再び開きます。  
+  
+     コレクション エディターを再び開くと、連結されているテーブル内のデータ列が、列スタイルの <xref:System.Windows.Forms.DataGridColumnStyle.MappingName%2A> プロパティのドロップダウン リストに表示されます。  
+  
+4.  コレクション エディターの **\[メンバー\]** ボックスで、列スタイルをクリックします。  
+  
+5.  コレクション エディターの **\[プロパティ\]** ボックスで、表示する列の <xref:System.Windows.Forms.DataGridColumnStyle.MappingName%2A> 値を選択します。  
+  
+## 参照  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md b/docs/framework/winforms/controls/add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md
new file mode 100644
index 00000000000..565b37b4c8f
--- /dev/null
+++ b/docs/framework/winforms/controls/add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの各セルにツールヒントを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 追加 (ツールヒントを)"
+  - "DataGridView コントロール [Windows フォーム], 追加 (ツールヒントを)"
+  - "ツールヒント [Windows フォーム], 追加 (データ グリッドに)"
+ms.assetid: 2a81f9de-d58b-4ea8-bc0b-8d93c2f4cf78
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム DataGridView コントロールの各セルにツールヒントを追加する
+既定では、ツールヒントは、小さすぎて全体の内容を表示できない <xref:System.Windows.Forms.DataGridView> セルの値を表示するために使用されます。  ただし、この動作をオーバーライドして、ツールヒントのテキスト値を個々のセルに設定することもできます。  これは、セルに関する追加情報を表示したり、セルの内容の代替説明を提供したりする場合に便利です。  たとえば、ステータス アイコンを表示する行がある場合に、ツールヒントを使用して説明を提供できます。  
+  
+ <xref:System.Windows.Forms.DataGridView.ShowCellToolTips%2A?displayProperty=fullName> プロパティを `false` に設定して、セル レベルのツールヒントの表示を無効にすることもできます。  
+  
+### ツールヒントをセルに追加するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCell.ToolTipText%2A?displayProperty=fullName> プロパティを設定します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridViewCell.ToolTipText#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCell.ToolTipText/cpp/datagridviewcell.tooltiptext.cpp#1)]
+     [!code-csharp[System.Windows.Forms.DataGridViewCell.ToolTipText#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCell.ToolTipText/CS/datagridviewcell.tooltiptext.cs#1)]
+     [!code-vb[System.Windows.Forms.DataGridViewCell.ToolTipText#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCell.ToolTipText/VB/datagridviewcell.tooltiptext.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例には、次の項目が必要です。  
+  
+-   1 ～ 4 個のアスタリスク記号 \("\*"\) から成る文字列値を表示するための `Rating` という名前の列を含む `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  このコントロールの <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントは、例に示すイベント ハンドラー メソッドに関連付けられている必要があります。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.Windows.Forms.DataGridView> コントロールを外部データ ソースにバインドする場合や、仮想モードを実装して独自のデータ ソースを提供する場合には、パフォーマンスが低下することがあります。  大量のデータを処理する際のパフォーマンスの低下を防止するには、複数のセルの <xref:System.Windows.Forms.DataGridViewCell.ToolTipText%2A> プロパティを設定する代わりに、<xref:System.Windows.Forms.DataGridView.CellToolTipTextNeeded> イベントを処理します。  このイベントを処理する場合、セルの <xref:System.Windows.Forms.DataGridViewCell.ToolTipText%2A> プロパティの値を取得するとイベントが発生し、イベント ハンドラーでの指定に基づいて <xref:System.Windows.Forms.DataGridViewCellToolTipTextNeededEventArgs.ToolTipText%2A?displayProperty=fullName> プロパティの値が返されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.ShowCellToolTips%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.CellToolTipTextNeeded?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCell>   
+ <xref:System.Windows.Forms.DataGridViewCell.ToolTipText%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md b/docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md
new file mode 100644
index 00000000000..9053d7442a3
--- /dev/null
+++ b/docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md
@@ -0,0 +1,92 @@
+---
+title: "方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TrayIcon"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アイコン, 追加 (タスク バーに)"
+  - "NotifyIcon コンポーネント"
+  - "状態通知領域のアイコン"
+  - "タスク バー, 追加 (アイコンを)"
+ms.assetid: d28c0fe6-aaf2-4df7-ad74-928d861a8510
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する
+Windows フォームの <xref:System.Windows.Forms.NotifyIcon> コンポーネントは、タスクバーの状態通知領域に 1 つのアイコンを表示します。  状態通知領域に複数のアイコンを表示するには、フォームに複数の <xref:System.Windows.Forms.NotifyIcon> コンポーネントを設定する必要があります。  コントロールで表示されるアイコンを設定するには、<xref:System.Windows.Forms.NotifyIcon.Icon%2A> プロパティを使用します。  また、<xref:System.Windows.Forms.NotifyIcon.DoubleClick> イベント ハンドラーにコードを記述して、ユーザーがアイコンをダブルクリックしたときになんらかの処理を行うこともできます。  たとえば、アイコンによって表されるバックグラウンド プロセスをユーザーが設定するためのダイアログ ボックスを表示できます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.NotifyIcon> コンポーネントは、アクションまたはイベントが発生したこと、または状態になんらかの変化があったことをユーザーに通知するためにだけ使用されます。  アプリケーションとの標準的な対話には、メニューやツール バーなどのユーザー インターフェイス要素を使用してください。  
+  
+### アイコンを設定するには  
+  
+1.  <xref:System.Windows.Forms.NotifyIcon.Icon%2A> プロパティに値を割り当てます。  これは `System.Drawing.Icon` 型の値であり、.ico ファイルから読み込むことができます。  アイコン ファイルはコードで指定するか、または **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.NotifyIcon.Icon%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックし、**\[ファイルを開く\]** ダイアログ ボックスでファイルを選択します。  
+  
+2.  <xref:System.Windows.Forms.NotifyIcon.Visible%2A> プロパティを `true` に設定します。  
+  
+3.  <xref:System.Windows.Forms.NotifyIcon.Text%2A> プロパティに適切なツールヒント文字列を設定します。  
+  
+     次のコード例では、アイコンの場所に対するパスとして **\[マイ ドキュメント\]** フォルダーが設定されています。  この場所を使用するのは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、この場所を選択すると、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例では、既に <xref:System.Windows.Forms.NotifyIcon> コントロールが追加されたフォームを必要とします。  また、`Icon.ico` という名前のアイコン ファイルも必要です。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    ' You should replace the bold icon in the sample below  
+    ' with an icon of your own choosing.  
+    NotifyIcon1.Icon = New _   
+       System.Drawing.Icon(System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Icon.ico")  
+    NotifyIcon1.Visible = True  
+    NotifyIcon1.Text = "Antivirus program"  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    // You should replace the bold icon in the sample below  
+    // with an icon of your own choosing.  
+    // Note the escape character used (@) when specifying the path.  
+    notifyIcon1.Icon =   
+       new System.Drawing.Icon (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Icon.ico");  
+    notifyIcon1.Visible = true;  
+    notifyIcon1.Text = "Antivirus program";  
+  
+    ```  
+  
+     \[cpp\]  
+  
+    ```  
+    // You should replace the bold icon in the sample below  
+    // with an icon of your own choosing.  
+    notifyIcon1->Icon = gcnew   
+       System::Drawing::Icon(String::Concat  
+       (System::Environment::GetFolderPath  
+       (System::Environment::SpecialFolder::Personal),  
+       "\\Icon.ico"));  
+    notifyIcon1->Visible = true;  
+    notifyIcon1->Text = "Antivirus program";  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.NotifyIcon>   
+ <xref:System.Windows.Forms.NotifyIcon.Icon%2A>   
+ [方法 : ショートカット メニューを Windows フォーム NotifyIcon コンポーネントに関連付ける](../../../../docs/framework/winforms/controls/how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md)   
+ [NotifyIcon コンポーネント](../../../../docs/framework/winforms/controls/notifyicon-component-windows-forms.md)   
+ [NotifyIcon コンポーネントの概要](../../../../docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/arranging-controls-on-windows-forms.md b/docs/framework/winforms/controls/arranging-controls-on-windows-forms.md
new file mode 100644
index 00000000000..a14397038ec
--- /dev/null
+++ b/docs/framework/winforms/controls/arranging-controls-on-windows-forms.md
@@ -0,0 +1,83 @@
+---
+title: "Windows フォームでのコントロールの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "VisualSelection"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "配置のコントロール [Windows フォーム]"
+  - "Windows フォーム コントロールをフォーム上に配置"
+ms.assetid: b2d62ed8-c391-4a7e-b72e-6bbabfca73dc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームでのコントロールの配置
+配置して、フォーム上のコントロールを操作するさまざまな方法で、ユーザー インターフェイスをわかりやすく、ユーザーの機能を作成できます。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [方法: Windows フォーム上の複数のコントロールを配置](../../../../docs/framework/winforms/controls/how-to-align-multiple-controls-on-windows-forms.md)  
+ さまざまな Windows フォーム上のコントロールの位置を揃えるための手順を示します。  
+  
+ [方法: Windows フォームでコントロールを固定](../../../../docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md)  
+ 実行時に動的にサイズを変更するコントロールを設定する手順を示します。  
+  
+ [方法: Windows フォーム間でコントロールをコピー](../../../../docs/framework/winforms/controls/how-to-copy-controls-between-windows-forms.md)  
+ フォーム間でコントロールを複製するための手順を示します。  
+  
+ [方法: Windows フォームでコントロールをドッキング](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)  
+ 「スティック」のコントロールをフォームの端に行うための手順を示します。  
+  
+ [方法: Windows フォームでのオブジェクトをレイヤー化](../../../../docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md)  
+ どのコントロールが相対 z 軸 (z オーダー) の一番上に確立するための手順を示します。  
+  
+ [方法: Windows フォームにコントロールをロック](../../../../docs/framework/winforms/controls/how-to-lock-controls-to-windows-forms.md)  
+ フォームに完全にコントロールを固定する手順を示します。  
+  
+ [方法: Windows フォームにコントロールを配置](../../../../docs/framework/winforms/controls/how-to-position-controls-on-windows-forms.md)  
+ フォーム上のコントロールの座標を設定するための手順を示します。  
+  
+ [方法: Windows フォームでコントロールのサイズを変更します。](../../../../docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md)  
+ フォーム上のコントロールのサイズを設定するための手順を示します。  
+  
+ [方法: すべての Windows フォームのグリッドのオプションを設定](../../../../docs/framework/winforms/controls/how-to-set-grid-options-for-all-windows-forms.md)  
+ フォームのグリッドのサイズを調整するための手順を示します。  
+  
+ [方法: Windows フォーム上のタブ オーダーの設定](../../../../docs/framework/winforms/controls/how-to-set-the-tab-order-on-windows-forms.md)  
+ ユーザーがタブとフォーカスを受け取るコントロールの順序を制御する手順を示します。  
+  
+ [方法: スナップ線と Windows フォームのグリッド コントロールを配置](../../../../docs/framework/winforms/controls/how-to-arrange-controls-with-snaplines-and-the-grid-in-windows-forms.md)  
+ フォーム上のグリッドにコントロールを配置する手順を示します。  
+  
+ [方法: 別の親への既存のコントロールを再割り当て](../../../../docs/framework/winforms/controls/how-to-reassign-existing-controls-to-a-different-parent.md)  
+ 既存のコントロールを新しい親コンテナーに割り当てるための手順を示します。  
+  
+ [チュートリアル: Windows フォーム コントロールのレイアウトでは、Padding、Margin、および AutoSize プロパティ](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)  
+ 使用して、フォーム上のコントロールを配置する方法について説明します、<xref:System.Windows.Forms.Control.Margin%2A>、 <xref:System.Windows.Forms.Control.Padding%2A>、および<xref:System.Windows.Forms.Control.AutoSize%2A>内のプロパティ、**フォーム デザイナー**します。  
+  
+ [チュートリアル: スナップ線を使用して Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)  
+ スナップ線が果たすさまざまなレイアウトの役割について説明します。  
+  
+## <a name="related-sections"></a>関連項目  
+ [方法: Windows フォームの button コントロールをデザイナーを使用して、[キャンセル] ボタンとして指定します。](../Topic/How%20to:%20Designate%20a%20Windows%20Forms%20Button%20as%20the%20Cancel%20Button%20Using%20the%20Designer.md)  
+ フォームをキャンセルするコントロールとボタンを確立するための手順を示します。  
+  
+ [方法: Windows フォームの button コントロールをデザイナーを使用して承認ボタンとして指定します。](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md)  
+ フォーカスのダイアログ ボックスである時の位置に関係なく ENTER を押すと、「の入力を受け付ける」ボタンとしてボタン (多くの場合、[OK] ボタン) を確立するための手順を示します。  
+  
+ [方法: セットとして機能するには、Windows フォーム RadioButton コントロールをグループ化](../../../../docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md)  
+ セットを確立するための手順を示します`RadioButton`として相互に関連するコントロール。  
+  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ コントロールに関する情報を提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/attributes-in-windows-forms-controls.md b/docs/framework/winforms/controls/attributes-in-windows-forms-controls.md
new file mode 100644
index 00000000000..60c42cca448
--- /dev/null
+++ b/docs/framework/winforms/controls/attributes-in-windows-forms-controls.md
@@ -0,0 +1,76 @@
+---
+title: "Windows フォーム コントロールの属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性 [Windows フォーム]"
+  - "属性 [Windows フォーム], クラス"
+  - "属性 [Windows フォーム], コントロールのプロパティ"
+  - "属性 [Windows フォーム], データ バインディング プロパティ"
+ms.assetid: 2c5640e9-6c6c-49d7-a5e4-a768f6be7853
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォーム コントロールの属性
+.NET Framework には、カスタム コントロールとカスタム コンポーネントのメンバーに適用できるさまざまな属性が用意されています。  これらの属性には、クラスの実行時の動作に影響するものと、デザイン時の動作に影響するものがあります。  
+  
+## コントロールとコンポーネントのプロパティの属性  
+ カスタム コントロールとカスタム コンポーネントのプロパティやその他のメンバーに適用できる属性を次の表に示します。  これらの属性の使用例については、「[方法 : Windows フォーム コントロールに属性を適用する](../../../../docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md)」を参照してください。  
+  
+|属性|Description|  
+|--------|-----------------|  
+|<xref:System.ComponentModel.AmbientValueAttribute>|プロパティが別のソースからその値を取得できるようにするために、プロパティに渡す値を指定します。  これは、*アンビエンス*と呼ばれます。|  
+|<xref:System.ComponentModel.BrowsableAttribute>|プロパティまたはイベントを **\[プロパティ\]** ウィンドウに表示するかどうかを指定します。|  
+|<xref:System.ComponentModel.CategoryAttribute>|<xref:System.Windows.Forms.PropertySort> モードに設定された <xref:System.Windows.Forms.PropertyGrid> コントロールにプロパティまたはイベントを表示するときに、それらをグループ化するためのカテゴリの名前を指定します。|  
+|<xref:System.ComponentModel.DefaultValueAttribute>|プロパティの既定値を指定します。|  
+|<xref:System.ComponentModel.DescriptionAttribute>|プロパティまたはイベントの説明を指定します。|  
+|<xref:System.ComponentModel.DisplayNameAttribute>|プロパティ、イベント、または引数を受け取らない `public` `void` メソッドの表示名を指定します。|  
+|<xref:System.ComponentModel.EditorAttribute>|プロパティの変更に使用するエディターを指定します。|  
+|<xref:System.ComponentModel.EditorBrowsableAttribute>|プロパティまたはメソッドをエディターで表示できるように指定します。|  
+|<xref:System.ComponentModel.Design.HelpKeywordAttribute>|クラスまたはメンバーのコンテキスト キーワードを指定します。|  
+|<xref:System.ComponentModel.LocalizableAttribute>|プロパティをローカライズするかどうかを指定します。|  
+|<xref:System.ComponentModel.PasswordPropertyTextAttribute>|オブジェクトのテキスト表現が、アスタリスク \(\*\) などの文字で隠されることを示します。|  
+|<xref:System.ComponentModel.ReadOnlyAttribute>|この属性がバインドされているプロパティをデザイン時に読み取り専用にするか、読み書き両用にするかを指定します。|  
+|<xref:System.ComponentModel.RefreshPropertiesAttribute>|関連付けられているプロパティ値が変更されたときにプロパティ グリッドを更新することを示します。|  
+|<xref:System.ComponentModel.TypeConverterAttribute>|この属性がバインドされているオブジェクトのコンバーターとして使用する型を指定します。|  
+  
+## データ バインディング プロパティの属性  
+ カスタム コントロールやカスタム コンポーネントがデータ バインディング機能とやり取りする方法を指定する際に適用できる属性を、次の表に示します。  
+  
+|属性|Description|  
+|--------|-----------------|  
+|<xref:System.ComponentModel.BindableAttribute>|一般にプロパティをバインディングで使用するかどうかを指定します。|  
+|<xref:System.ComponentModel.ComplexBindingPropertiesAttribute>|コンポーネントのデータ ソース プロパティとデータ メンバー プロパティを指定します。|  
+|<xref:System.ComponentModel.DefaultBindingPropertyAttribute>|コンポーネントの既定のバインディング プロパティを指定します。|  
+|<xref:System.ComponentModel.LookupBindingPropertiesAttribute>|コンポーネントのデータ ソース プロパティとデータ メンバー プロパティを指定します。|  
+|<xref:System.ComponentModel.AttributeProviderAttribute>|属性のリダイレクトを有効にします。|  
+  
+## クラスの属性  
+ カスタム コントロールとカスタム コンポーネントのデザイン時の動作を指定する際に適用できる属性を、次の表に示します。  
+  
+|属性|Description|  
+|--------|-----------------|  
+|<xref:System.ComponentModel.DefaultEventAttribute>|コンポーネントの既定のイベントを指定します。|  
+|<xref:System.ComponentModel.DefaultPropertyAttribute>|コンポーネントの既定のプロパティを指定します。|  
+|<xref:System.ComponentModel.DesignerAttribute>|コンポーネントのデザイン時のサービスの実装に使用するクラスを指定します。|  
+|<xref:System.ComponentModel.DesignerCategoryAttribute>|クラスのデザイナーが特定のカテゴリに属すように指定します。|  
+|<xref:System.ComponentModel.ToolboxItemAttribute>|ツールボックス項目の属性を表します。|  
+|<xref:System.ComponentModel.ToolboxItemFilterAttribute>|ツールボックス項目に使用するフィルター文字列とフィルターの種類を指定します。|  
+  
+## 参照  
+ <xref:System.Attribute>   
+ [方法 : Windows フォーム コントロールに属性を適用する](../../../../docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md)   
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/autogenerate-columns-in-a-data-bound-wf-datagridview-control.md b/docs/framework/winforms/controls/autogenerate-columns-in-a-data-bound-wf-datagridview-control.md
new file mode 100644
index 00000000000..b669e4359e3
--- /dev/null
+++ b/docs/framework/winforms/controls/autogenerate-columns-in-a-data-bound-wf-datagridview-control.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : データバインドされた Windows フォーム DataGridView コントロールに列を自動生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 自動生成"
+  - "データ グリッド, 自動生成 (列を)"
+  - "DataGridView コントロール [Windows フォーム], データ バインドされた列"
+ms.assetid: 699f6f9e-6aa5-4811-902b-6a2c57dec7d6
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : データバインドされた Windows フォーム DataGridView コントロールに列を自動生成する
+<xref:System.Windows.Forms.DataGridView> コントロールに、バインドされたデータ ソースの列を表示する方法を次のコード例に示します。  <xref:System.Windows.Forms.DataGridView.AutoGenerateColumns%2A> プロパティ値が `true` \(既定\) に設定されている場合、<xref:System.Windows.Forms.DataGridViewColumn> はデータ ソース テーブルの列ごとに作成されます。  
+  
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn.DataSource%2A> プロパティを設定している場合に、<xref:System.Windows.Forms.DataGridView> コントロールに列が既にある場合は、バインドされている既存の列がデータ ソース内の列と比較され、一致するときは必ず保持されます。  バインドされていない列は常に保持されます。  データ ソースと一致しないバインドされた列は削除されます。  データ ソースに存在するのにコントロールには存在しない列があると、新しい <xref:System.Windows.Forms.DataGridViewColumn> オブジェクトが生成されます。これは <xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションの最後に追加されます。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#020](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#020)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#020](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#020)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `customersDataGridView` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   `Customers` という名前のテーブルがある `customersDataSet` という名前の <xref:System.Data.DataSet> オブジェクト。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Windows.Forms?displayProperty=fullName> アセンブリ、<xref:System.Data?displayProperty=fullName> アセンブリ、および <xref:System.Xml?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AutoGenerateColumns%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する](../../../../docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md b/docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md
new file mode 100644
index 00000000000..122c3996ebe
--- /dev/null
+++ b/docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, サイズ変更 (セルを自動的に)"
+  - "セル, サイズ変更 (自動的に)"
+  - "DataGridView コントロール [Windows フォーム], セルのサイズ変更"
+ms.assetid: 1d68934d-a04c-4b12-9e66-c856c6828131
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する
+コンテンツが変更されたときは常に行、列、ヘッダーのサイズを自動的に変更し、クリッピングなしでセルが値を表示するのに十分な大きさになるように、<xref:System.Windows.Forms.DataGridView> コントロールを構成できます。  
+  
+ 新しいサイズを決定するために使用するセルを制限する多くのオプションがあります。 たとえば、現在表示されている行の値のみに基づいて、その列の幅のサイズを自動的に変更するコントロールを構成できます。 これにより、大量の行を処理するときの非効率性を回避できますが、この場合では、<xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A> などのサイズ調整のメソッドを使用して、選択時にサイズを調整することをお勧めします。  
+  
+ 自動サイズ変更の詳細については、「[Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ 次のコード例は、自動サイズ変更に使用できるオプションを示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.AutoSizing#0](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.AutoSizing/CPP/autosizing.cpp#0)]
+ [!code-csharp[System.Windows.Forms.DataGridView.AutoSizing#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.AutoSizing/CS/autosizing.cs#0)]
+ [!code-vb[System.Windows.Forms.DataGridView.AutoSizing#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.AutoSizing/VB/autosizing.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。 また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  また、「[方法: 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeightSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowHeadersWidthSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoSizeRowsMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeRowsMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode>   
+ <xref:System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode>   
+ <xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode>   
+ [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](../../../../docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する](../../../../docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/autosize-behavior-in-the-tablelayoutpanel-control.md b/docs/framework/winforms/controls/autosize-behavior-in-the-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..8eba53b4ce7
--- /dev/null
+++ b/docs/framework/winforms/controls/autosize-behavior-in-the-tablelayoutpanel-control.md
@@ -0,0 +1,48 @@
+---
+title: "TableLayoutPanel コントロールにおける AutoSize 動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サイズの自動調整"
+  - "AutoSize プロパティ, TableLayoutPanel コントロール"
+  - "AutoSizeMode プロパティ"
+  - "コントロール [Windows フォーム], サイズ変更"
+  - "レイアウト [Windows フォーム], AutoSize"
+  - "ローカライズ (フォームを)"
+  - "サイズ変更, 自動"
+  - "TableLayoutPanel コントロール [Windows フォーム], AutoSize の動作"
+ms.assetid: 9233e0c3-2fa6-405e-8701-959479b1250e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# TableLayoutPanel コントロールにおける AutoSize 動作
+## 異なる AutoSize 動作  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、次の方法で自動サイズ変更動作をサポートします。  
+  
+-   <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを使用する。  
+  
+-   <xref:System.Windows.Forms.TableLayoutPanel> コントロールの列スタイルと行スタイルで <xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティを使用する。  
+  
+### AutoSize プロパティと列および行スタイル  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティと <xref:System.Windows.Forms.TableLayoutPanel> コントロールの列\/行スタイルとの対応について次の表に示します。  
+  
+|AutoSize の設定|スタイルに関する対応|  
+|------------------|----------------|  
+|`false`|<xref:System.Windows.Forms.TableLayoutPanel> コントロールは左から右に処理を実行し、次の順序で列または行の領域を割り当てます。<br /><br /> 1.  <xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティが <xref:System.Windows.Forms.SizeType> に設定されている場合は、<xref:System.Windows.Forms.ColumnStyle.Width%2A> または <xref:System.Windows.Forms.RowStyle.Height%2A> で指定されているピクセル数を割り当てます。<br />2.  <xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティが <xref:System.Windows.Forms.SizeType> に設定されている場合は、子コントロールの <xref:System.Windows.Forms.Control.GetPreferredSize%2A> メソッドが返すピクセル数を割り当てます。<br />3.  すべての <xref:System.Windows.Forms.SizeType> 列\/行と <xref:System.Windows.Forms.SizeType> 列\/行の領域を割り当てると、<xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> が <xref:System.Windows.Forms.SizeType> に設定されている列または行を使用して残りの空き領域を比例的に割り当てます。|  
+|`true`|<xref:System.Windows.Forms.SizeType> 列\/行が自動サイズ変更アスペクトを取得することを除いて、上記の対応と同様です。<br /><br /> <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、<xref:System.Windows.Forms.SizeType> スタイルが設定された列または行によって内容がクリップされないように、列または行を拡張して十分な空き領域を作成します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、<xref:System.Windows.Forms.ColumnStyle.Width%2A> プロパティまたは <xref:System.Windows.Forms.RowStyle.Height%2A> プロパティに従って、新しい領域を比例的に割り当てます。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [TableLayoutPanel コントロールの概要](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/autosize-property-overview.md b/docs/framework/winforms/controls/autosize-property-overview.md
new file mode 100644
index 00000000000..4595df96c5b
--- /dev/null
+++ b/docs/framework/winforms/controls/autosize-property-overview.md
@@ -0,0 +1,82 @@
+---
+title: "AutoSize プロパティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サイズの自動調整"
+  - "AutoSize プロパティ"
+  - "AutoSizeMode プロパティ"
+  - "レイアウト [Windows フォーム], AutoSize"
+  - "サイズ変更, 自動"
+ms.assetid: 62fd82a2-9565-4f65-925b-9d1e66dc4e7d
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# AutoSize プロパティの概要
+<xref:System.Windows.Forms.Control.AutoSize%2A> プロパティプロパティを使用することにより、必要に応じて <xref:System.Windows.Forms.Control.PreferredSize%2A> プロパティで指定された値までコントロールのサイズを変更できます。  特定のコントロールのサイズ変更動作を調整するには、`AutoSizeMode` プロパティを設定します。  
+  
+## AutoSize 動作  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティは、一部のコントロールだけがサポートします。  また、<xref:System.Windows.Forms.Control.AutoSize%2A> プロパティをサポートするコントロールは、`AutoSizeMode` プロパティもサポートします。  
+  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティが生成する動作は、コントロールの種類と `AutoSizeMode` プロパティ \(存在する場合\) の値に応じて多少異なります。  このプロパティが生成する標準動作の一覧とその説明を次の表に示します。  
+  
+|標準動作|Description|  
+|----------|-----------------|  
+|自動サイズ変更は実行時の機能です。|このプロパティがコントロールを拡大縮小せず、それ以上の効果が無いことを意味します。|  
+|コントロールのサイズを変更しても、<xref:System.Windows.Forms.Control.Location%2A> プロパティの値は常に一定です。|コントロールのコンテンツによってコントロールが拡大する場合、コントロールは右下に向かって拡大します。  コントロールは左側に拡大しません。|  
+|<xref:System.Windows.Forms.Control.AutoSize%2A> が `true` の場合、<xref:System.Windows.Forms.Control.Dock%2A> プロパティと <xref:System.Windows.Forms.Control.Anchor%2A> プロパティは有効です。|コントロールの <xref:System.Windows.Forms.Control.Location%2A> プロパティの値は、正確な値に調整されます。<br /><br /> **メモ** <xref:System.Windows.Forms.Label> コントロールには、この規則が適用されません。  ドッキングされる <xref:System.Windows.Forms.Label> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティに `true` を設定すると、<xref:System.Windows.Forms.Label> コントロールは伸縮しません。|  
+|コントロールの <xref:System.Windows.Forms.Control.MaximumSize%2A> プロパティと <xref:System.Windows.Forms.Control.MinimumSize%2A> プロパティは、そのコントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値とは無関係に常に有効です。|<xref:System.Windows.Forms.Control.MaximumSize%2A> プロパティと <xref:System.Windows.Forms.Control.MinimumSize%2A> プロパティは、<xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの影響を受けません。|  
+|既定で設定される最小サイズはありません。|<xref:System.Windows.Forms.Control.AutoSize%2A> に従ってコントロールが縮小するように設定され、コントロールにコンテンツが含まれていない場合、<xref:System.Windows.Forms.Control.Size%2A> プロパティが 0,0 になることを意味します。  この場合、コントロールは 1 つの点に縮小し、簡単に識別できなくなります。|  
+|コントロールで <xref:System.Windows.Forms.Control.GetPreferredSize%2A> メソッドを実装していない場合、<xref:System.Windows.Forms.Control.GetPreferredSize%2A> メソッドは、<xref:System.Windows.Forms.Control.Size%2A> プロパティに代入された最後の値を返します。|<xref:System.Windows.Forms.Control.AutoSize%2A> に `true` を設定しても無効であることを意味します。|  
+|<xref:System.Windows.Forms.TableLayoutPanel> セル内のコントロールは、その <xref:System.Windows.Forms.Control.MinimumSize%2A> に達するまで、常にセルのサイズに合わせて縮小します。|このサイズは最大サイズとして適用されます。  セルが <xref:System.Windows.Forms.SizeType> 行または列の一部である場合、これは該当しません。|  
+  
+## AutoSizeMode プロパティ  
+ `AutoSizeMode` プロパティでは、既定の <xref:System.Windows.Forms.Control.AutoSize%2A> 動作をより詳細に制御できます。  `AutoSizeMode` プロパティは、コントロールがそのサイズをコンテンツに合わせてどのように調整するかを指定します。  コンテンツは、たとえば <xref:System.Windows.Forms.Button> コントロールの場合はテキスト、コンテナーの場合は子コントロールになります。  
+  
+ <xref:System.Windows.Forms.AutoSizeMode> の設定と、各設定による動作の説明を次に示します。  
+  
+|AutoSizeMode の設定|\[動作\]|  
+|----------------------|------------|  
+|GrowAndShrink|コントロールは拡大または縮小して、コンテンツを包含します。<br /><br /> <xref:System.Windows.Forms.Control.MinimumSize%2A> 値と <xref:System.Windows.Forms.Control.MaximumSize%2A> 値は有効ですが、<xref:System.Windows.Forms.Control.Size%2A> プロパティの現在値は無視されます。<br /><br /> これは、<xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを持ち、`AutoSizeMode` プロパティを持たないコントロールと同じ動作です。|  
+|GrowOnly|コントロールは、コンテンツを包含するのに必要な大きさに拡大しますが、<xref:System.Windows.Forms.Control.Size%2A> プロパティで指定された値より縮小しません。<br /><br /> これは、`AutoSizeMode` の既定値です。|  
+  
+## AutoSize プロパティをサポートするコントロール  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティと `AutoSizeMode` プロパティをサポートするコントロールを次の表に示します。  
+  
+|AutoSize のサポート|コントロールの型|  
+|--------------------|--------------|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティをサポート。<br />-   `AutoSizeMode` プロパティなし。|<xref:System.Windows.Forms.CheckBox><br /><br /> <xref:System.Windows.Forms.DomainUpDown><br /><br /> <xref:System.Windows.Forms.Label><br /><br /> <xref:System.Windows.Forms.LinkLabel><br /><br /> <xref:System.Windows.Forms.MaskedTextBox> \(<xref:System.Windows.Forms.TextBox> ベース\)<br /><br /> <xref:System.Windows.Forms.NumericUpDown><br /><br /> <xref:System.Windows.Forms.RadioButton><br /><br /> <xref:System.Windows.Forms.TextBox><br /><br /> <xref:System.Windows.Forms.TrackBar>|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティをサポート。<br />-   `AutoSizeMode` プロパティをサポート。|<xref:System.Windows.Forms.Button><br /><br /> <xref:System.Windows.Forms.CheckedListBox><br /><br /> <xref:System.Windows.Forms.FlowLayoutPanel><br /><br /> <xref:System.Windows.Forms.Form><br /><br /> <xref:System.Windows.Forms.GroupBox><br /><br /> <xref:System.Windows.Forms.Panel><br /><br /> <xref:System.Windows.Forms.TableLayoutPanel>|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティなし。|<xref:System.Windows.Forms.CheckedListBox><br /><br /> <xref:System.Windows.Forms.ComboBox><br /><br /> <xref:System.Windows.Forms.DataGridView><br /><br /> <xref:System.Windows.Forms.DateTimePicker><br /><br /> <xref:System.Windows.Forms.ListBox><br /><br /> <xref:System.Windows.Forms.ListView><br /><br /> <xref:System.Windows.Forms.MaskedTextBox><br /><br /> <xref:System.Windows.Forms.MonthCalendar><br /><br /> <xref:System.Windows.Forms.ProgressBar><br /><br /> <xref:System.Windows.Forms.PropertyGrid><br /><br /> <xref:System.Windows.Forms.RichTextBox><br /><br /> <xref:System.Windows.Forms.SplitContainer><br /><br /> <xref:System.Windows.Forms.TabControl><br /><br /> <xref:System.Windows.Forms.TabPage><br /><br /> <xref:System.Windows.Forms.TreeView><br /><br /> <xref:System.Windows.Forms.WebBrowser><br /><br /> <xref:System.Windows.Forms.ScrollBar>|  
+  
+## デザイン環境における AutoSize  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティと `AutoSizeMode` プロパティの値に基づく、デザイン時のコントロールのサイズ変更動作を次に示します。  
+  
+ 特定のコントロールが、ユーザーによるサイズ変更が可能な状態にあるかどうかを確認するには、<xref:System.Windows.Forms.Design.ControlDesigner.SelectionRules%2A> プロパティをオーバーライドします。  次の表で、"サイズを変更できません" は <xref:System.Windows.Forms.Design.SelectionRules> のみを意味し、"サイズを変更できます" は <xref:System.Windows.Forms.Design.SelectionRules> と <xref:System.Windows.Forms.Design.SelectionRules> を意味します。  
+  
+|AutoSize の設定|デザイン時のサイズ変更ジェスチャ|  
+|------------------|----------------------|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> \= `true`<br />-   `AutoSizeMode` プロパティなし。|ユーザーは、デザイン時に次のコントロール以外のコントロールのサイズを変更できません。<br /><br /> -   <xref:System.Windows.Forms.TextBox><br />-   <xref:System.Windows.Forms.MaskedTextBox><br />-   <xref:System.Windows.Forms.RichTextBox><br />-   <xref:System.Windows.Forms.TrackBar>|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> \= `true`<br />-   `AutoSizeMode` \= <xref:System.Windows.Forms.AutoSizeMode>|ユーザーは、デザイン時にコントロールのサイズを変更できません。|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> \= `true`<br />-   `AutoSizeMode` \= <xref:System.Windows.Forms.AutoSizeMode>|ユーザーは、デザイン時にコントロールのサイズを変更できます。  <xref:System.Windows.Forms.Control.Size%2A> プロパティが設定されている場合は、ユーザーはコントロールのサイズを拡大することのみ可能です。|  
+|-   <xref:System.Windows.Forms.Control.AutoSize%2A> \= `false`、または <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティが隠されている。|ユーザーは、デザイン時にコントロールのサイズを変更できます。|  
+  
+> [!NOTE]
+>  生産性を最大限に高めるために、Windows フォーム デザイナーは、<xref:System.Windows.Forms.Form> クラスの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティをシャドウイングします。  デザイン時のフォームは、実際の設定とは無関係に <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティが `false` に設定されているように動作します。  実行時には、特別な調整は行われず、プロパティ設定で指定されたとおりに <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティが適用されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.AutoSize%2A>   
+ <xref:System.Windows.Forms.Control.PreferredSize%2A>   
+ <xref:System.Windows.Forms.Control.GetPreferredSize%2A>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/backgroundworker-component-overview.md b/docs/framework/winforms/controls/backgroundworker-component-overview.md
new file mode 100644
index 00000000000..12c2b672b15
--- /dev/null
+++ b/docs/framework/winforms/controls/backgroundworker-component-overview.md
@@ -0,0 +1,70 @@
+---
+title: "BackgroundWorker コンポーネントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "BackgroundWorker"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "非同期パターン"
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "BackgroundWorker コンポーネント"
+  - "コンポーネント [Windows フォーム], 非同期"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+ms.assetid: 64e9b3ab-7443-4a77-ab17-b8b8c0cb3f62
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# BackgroundWorker コンポーネントの概要
+一般的な操作には、実行時間が長くかかるものが数多くあります。  次に例を示します。  
+  
+-   イメージのダウンロード  
+  
+-   Web サービスの起動  
+  
+-   ファイルのダウンロードとアップロード \(ピアツーピア アプリケーションの場合を含む\)  
+  
+-   ローカルでの複雑な計算  
+  
+-   データベース トランザクション  
+  
+-   ローカル ディスク アクセス \(前提としてメモリ アクセスに比べて低速です\)  
+  
+ 以上のような操作の実行時には、ユーザー インターフェイスがハングアップすることがあります。  応答性に優れた UI を必要としながらも、このような操作との関連で長時間の遅延に直面する場合は、<xref:System.ComponentModel.BackgroundWorker> コンポーネントが便利なソリューションになります。  
+  
+ <xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用すると、時間のかかる操作を、アプリケーションのメイン UI スレッドとは別のスレッドで非同期的に \("バックグラウンドで"\) 実行できます。  <xref:System.ComponentModel.BackgroundWorker> を使用するには、バックグラウンドで実行する、時間のかかるワーカー メソッドをこのコンポーネントに通知して、<xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドを呼び出すだけです。  呼び出し元スレッドが正常に動作し続けると共に、ワーカー メソッドも非同期的に動作します。  このメソッドが終了すると、<xref:System.ComponentModel.BackgroundWorker> は、<xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントを起動して、呼び出し元スレッドに警告します。このイベントには、オプションで操作の結果を含めることもできます。  
+  
+ <xref:System.ComponentModel.BackgroundWorker> コンポーネントは、**\[コンポーネント\]** タブの **\[ツールボックス\]** で選択できます。  <xref:System.ComponentModel.BackgroundWorker> をフォームに追加するには、<xref:System.ComponentModel.BackgroundWorker> コンポーネントをフォームにドラッグします。  このコンポーネントはコンポーネント トレイに表示され、プロパティが **\[プロパティ\]** ウィンドウに表示されます。  
+  
+ 非同期操作を開始するには、<xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドを使用します。  <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> は、オプションの `object` パラメーターを受け取り、このパラメーターを使用してワーカー メソッドに引数を渡すことができます。  <xref:System.ComponentModel.BackgroundWorker> クラスは、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベントを公開します。このイベントには、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラー経由でワーカー スレッドをアタッチします。  
+  
+ <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーは、<xref:System.ComponentModel.DoWorkEventArgs.Argument%2A> プロパティを持つ <xref:System.ComponentModel.DoWorkEventArgs> パラメーターを受け取ります。  このプロパティは、<xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> からパラメーターを受け取り、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーで呼び出されるワーカー メソッドに渡されます。  次の例は、`ComputeFibonacci` というワーカー メソッドの結果を代入する方法を示しています。  これは、「[方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)」に記載されている例の一部です。  
+  
+ [!code-cpp[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#5)]
+ [!code-csharp[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#5)]
+ [!code-vb[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#5)]  
+  
+ イベント ハンドラーの使い方の詳細については、「[イベント](../../../../docs/standard/events/index.md)」を参照してください。  
+  
+> [!CAUTION]
+>  どのような種類のマルチスレッドを使用している場合でも、非常に深刻で複雑なバグを引き起こしてしまう可能性があります。  マルチスレッドを使用するソリューションを実装する前に、「[Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+ <xref:System.ComponentModel.BackgroundWorker> クラスの使い方の詳細については、「[方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)」を参照してください。  
+  
+## 参照  
+ [NOT IN BUILD: Multithreading in Visual Basic](http://msdn.microsoft.com/ja-jp/c731a50c-09c1-4468-9646-54c86b75d269)   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/backgroundworker-component.md b/docs/framework/winforms/controls/backgroundworker-component.md
new file mode 100644
index 00000000000..f08433d32be
--- /dev/null
+++ b/docs/framework/winforms/controls/backgroundworker-component.md
@@ -0,0 +1,64 @@
+---
+title: "BackgroundWorker コンポーネント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "非同期パターン"
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "BackgroundWorker コンポーネント"
+  - "コンポーネント [Windows フォーム], 非同期"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+ms.assetid: bef7b0ab-ce57-475a-a2d6-fb8a702a9417
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# BackgroundWorker コンポーネント
+`BackgroundWorker` コンポーネントを使用すると、フォームまたはコントロールで非同期の操作を実行できます。  
+  
+## このセクションの内容  
+ [BackgroundWorker コンポーネントの概要](../../../../docs/framework/winforms/controls/backgroundworker-component-overview.md)  
+ `BackgroundWorker` コンポーネントについて説明します。このコンポーネントを使用すると、時間のかかる操作を、アプリケーションのメイン UI スレッドとは別のスレッドで非同期的に \("バックグラウンドで"\) 実行できます。  
+  
+ [チュートリアル : 操作をバックグラウンドで実行する](../../../../docs/framework/winforms/controls/walkthrough-running-an-operation-in-the-background.md)  
+ デザイナーで `BackgroundWorker` コンポーネントを使用して、時間のかかる操作を別スレッドで実行する方法を説明します。  
+  
+ [方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)  
+ `BackgroundWorker` コンポーネントを使用して、時間のかかる操作を別スレッドで実行する方法を説明します。  
+  
+ [チュートリアル : バックグラウンド操作を使用するフォームの実装](../../../../docs/framework/winforms/controls/walkthrough-implementing-a-form-that-uses-a-background-operation.md)  
+ デザイナーを使用して、数値演算処理を非同期で実行するアプリケーションを作成します。  
+  
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)  
+ 数値演算処理を非同期で実行するアプリケーションを作成します。  
+  
+ [方法 : バックグラウンドでファイルをダウンロードする](../../../../docs/framework/winforms/controls/how-to-download-a-file-in-the-background.md)  
+ `BackgroundWorker` コンポーネントを使用して、別スレッドでファイルをダウンロードする方法を説明します。  
+  
+## 関連項目  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.ComponentModel.RunWorkerCompletedEventArgs>  
+ <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントのデータを保持する型について説明します。  
+  
+ <xref:System.ComponentModel.ProgressChangedEventArgs>  
+ <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントのデータを保持する型について説明します。  
+  
+## 関連項目  
+ [Event\-based Asynchronous Pattern Overview](../../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)  
+ 非同期パターンを使用することで、マルチスレッド デザイン固有の多くの複雑な問題を気にせずに、マルチスレッド アプリケーションの利点を活用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md b/docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md
new file mode 100644
index 00000000000..53a225626bb
--- /dev/null
+++ b/docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md
@@ -0,0 +1,67 @@
+---
+title: "Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], DataGridView コントロール"
+  - "データ グリッド, 例"
+  - "DataGridView コントロール [Windows フォーム], 基本的機能"
+  - "DataGridView コントロール [Windows フォーム], 例"
+ms.assetid: 78085f26-d5d2-4b75-813e-e932b72fd06f
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能
+`DataGridView` のセル、行、および列の多くの基本動作は、それぞれ 1 つのプロパティを設定することで変更できます。  このセクションの各トピックでは、これらの機能のうち、特によく使用されるものについて説明します。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームの DataGridView コントロールの列を非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-columns-in-the-windows-forms-datagridview-control.md)  
+ コントロールで特定の列を非表示にする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの列ヘッダーを非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md)  
+ コントロールで特定の列ヘッダーを非表示にする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](../../../../docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md)  
+ コントロール内の列をユーザーが再配置できるようにする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md)  
+ 1 つの列または複数の隣接する列をスクロールしないようにする方法について説明します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)  
+ コントロール内の特定の列をユーザーが編集できないようにする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)  
+ コントロールの末尾の新しいレコード用の行を削除して、ユーザーが行を追加できないようにする方法について説明します。  また、ユーザーが行を削除できないようにする方法についても説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの現在のセルを取得および設定する](../../../../docs/framework/winforms/controls/get-and-set-the-current-cell-wf-datagridview-control.md)  
+ コントロール内で現在フォーカスがあるセルにアクセスする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する](../../../../docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md)  
+ 各セルにアイコンを表示するイメージ列を作成する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ コントロールの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)  
+ コントロールの基本の外観およびセル データの表示形式を変更する方法を説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)  
+ セル、行、および列の各オブジェクトを使用したプログラムの作成方法について説明するトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..843ff262450
--- /dev/null
+++ b/docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,70 @@
+---
+title: "Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 書式指定"
+  - "DataGridView コントロール [Windows フォーム], 書式設定およびスタイル設定"
+ms.assetid: b9b90836-1f56-4aa9-8db8-edc78fe830e8
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定
+`DataGridView` コントロールを使用すると、セルの基本的な外観およびセルの値の表示形式を簡単に定義できます。  `DataGridView` コントロールのさまざまなプロパティからアクセスできる `DataGridViewCellStyle` オブジェクトのプロパティを設定することにより、個々のセル、特定の列や行のセル、またはコントロール内のすべてのセルに対して、外観および書式スタイルを定義できます。  加えて、`CellFormatting` イベントを処理することにより、セルの値などの要因に基づいてこれらのスタイルを動的に変更できます。  
+  
+## このセクションの内容  
+ [方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)  
+ `DataGridView` のプロパティを設定して、コントロールの輪郭およびセル間の境界線の外観を定義する方法を説明します。  
+  
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)  
+ `DataGridViewCellStyle` クラスについてと、この型のプロパティがどのようにやり取りしてコントロール内のセルの表示方法が定義されるかについて説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)  
+ `DataGridViewCellStyle` のプロパティを使用して、特定の行や列のセル、およびコントロール全体のセルに対して既定の外観を定義する方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)  
+ `DataGridViewCellStyle` のプロパティを使用してセルの表示値の書式を設定する方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md)  
+ `DefaultCellStyle` プロパティを使用して、コントロール内のすべてのセルの基本的な表示特性を設定する方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md)  
+ 行の表示を交互に変えて、コントロール内で帳簿のような効果を生む方法を説明します。  
+  
+ [方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする](../../../../docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md)  
+ `RowTemplate` プロパティを使用して、コントロール内のすべての行に対して適用される行のプロパティを設定する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewCellStyle>  
+ <xref:System.Windows.Forms.DataGridViewCellStyle> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.CellFormatting>  
+ <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.RowTemplate%2A>  
+ <xref:System.Windows.Forms.DataGridView.RowTemplate%2A> プロパティの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)  
+ <xref:System.Windows.Forms.DataGridView> のセルと行を独自に描画する方法と、セル、列、行の派生型を作成する方法についてのトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)  
+ セル、行、および列の一般的なプロパティを説明するトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..8944a278e48
--- /dev/null
+++ b/docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md
@@ -0,0 +1,154 @@
+---
+title: "Windows フォーム DataGridView コントロールを拡張するための推奨される手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "推奨される手順, DataGridView コントロール"
+  - "データ グリッド, 推奨される手順"
+  - "DataGridView コントロール [Windows フォーム], 推奨される手順"
+  - "DataGridView コントロール [Windows フォーム], 行の共有"
+  - "DataGridView コントロール [Windows フォーム], スケーリング"
+  - "DataGridView コントロール [Windows フォーム], 共有行"
+ms.assetid: 8321a8a6-6340-4fd1-b475-fa090b905aaf
+caps.latest.revision: 31
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# Windows フォーム DataGridView コントロールを拡張するための推奨される手順
+<xref:System.Windows.Forms.DataGridView> コントロールは、最大のスケーラビリティを提供するようにデザインされています。  大量のデータを表示する必要がある場合は、このトピックのガイドラインに従って、大量のメモリ消費やユーザー インターフェイス \(UI\) の応答速度低下を回避することが必要です。  このトピックでは、次の項目について説明します。  
+  
+-   セル スタイルの効率的な使用  
+  
+-   ショートカット メニューの効率的な使用  
+  
+-   自動サイズ変更の効率的な使用  
+  
+-   選択されているセル、行、および列のコレクションの効率的な使用  
+  
+-   共有行の使用  
+  
+-   行が非共有になることの防止  
+  
+ 特別なパフォーマンス要件がある場合には、仮想モードを実装し、独自のデータ管理操作を提供できます。  詳細については、「[Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## セル スタイルの効率的な使用  
+ 各セル、各行、および各列に、個別のスタイル情報を設定できます。  スタイル情報は、<xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトに格納されます。  多数の <xref:System.Windows.Forms.DataGridView> 要素それぞれについてセル スタイル オブジェクトを作成することは、特に大量のデータを処理する場合、非効率的です。  パフォーマンスへの影響を回避するには、次のガイドラインに従います。  
+  
+-   個々の <xref:System.Windows.Forms.DataGridViewCell> オブジェクトまたは <xref:System.Windows.Forms.DataGridViewRow> オブジェクトにセル スタイル プロパティを設定することは避けます。  これには、<xref:System.Windows.Forms.DataGridView.RowTemplate%2A> プロパティで指定された行オブジェクトも含まれます。  行テンプレートから新しい行を複製すると、それぞれの行にテンプレートのセル スタイル オブジェクトのコピーが作成されます。  スケーラビリティを最大にするには、セル スタイル プロパティの設定を <xref:System.Windows.Forms.DataGridView> レベルで行います。  たとえば、<xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName> プロパティではなく <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを設定します。  
+  
+-   既定の書式設定以外の書式設定を必要とするセルがある場合、セル、行、または列の複数のグループで同じ <xref:System.Windows.Forms.DataGridViewCellStyle> インスタンスを使用します。  個別のセル、行、および列で <xref:System.Windows.Forms.DataGridViewCellStyle> 型プロパティを直接設定することは避けます。  セル スタイルを共有する例については、「[方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)」を参照してください。  <xref:System.Windows.Forms.DataGridView.CellFormatting> イベント ハンドラーを処理してセル スタイルを個別に設定することでも、パフォーマンス低下を回避できます。  カスタマイズ例については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   セルのスタイルを確認するときは、<xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName> プロパティではなく <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A?displayProperty=fullName> プロパティを使用します。  <xref:System.Windows.Forms.DataGridViewCell.Style%2A> プロパティにアクセスすると、そのプロパティがまだ使用されていない場合は <xref:System.Windows.Forms.DataGridViewCellStyle> クラスの新しいインスタンスが作成されます。  また、行、列、またはコントロールからスタイルを継承している場合は、このオブジェクトにセルの一部のスタイル情報が含まれないことがあります。  セル スタイルの継承の詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## ショートカット メニューの効率的な使用  
+ 各セル、各行、および各列に、個別のショートカット メニューを設定できます。  <xref:System.Windows.Forms.DataGridView> コントロールのショートカット メニューは、<xref:System.Windows.Forms.ContextMenuStrip> コントロールで表されます。  セル スタイル オブジェクトと同様、多数の <xref:System.Windows.Forms.DataGridView> 要素それぞれについてショートカット メニューを作成すると、パフォーマンスの低下を招きます。  このような影響を回避するには、次のガイドラインに従います。  
+  
+-   個々のセルおよび行にショートカット メニューを作成することは避けます。  行テンプレートも同様です。行テンプレートは、コントロールに新しい行が追加されるときに複製され、このときショートカット メニューも同時に複製されます。  スケーラビリティを最大にするには、コントロールの <xref:System.Windows.Forms.Control.ContextMenuStrip%2A> プロパティのみを使用して、コントロール全体に単一のショートカット メニューを指定します。  
+  
+-   複数の行またはセルについて複数のショートカット メニューが必要な場合は、<xref:System.Windows.Forms.DataGridView.CellContextMenuStripNeeded> イベントまたは <xref:System.Windows.Forms.DataGridView.RowContextMenuStripNeeded> イベントを処理します。  これらのイベントでショートカット メニュー オブジェクトを操作することで、パフォーマンスを調整できます。  
+  
+## 自動サイズ変更の効率的な使用  
+ セルの内容を変更すると、内容全体が欠けることなく表示されるように、行、列、およびヘッダーのサイズが自動的に変更されることがあります。  サイズ変更モードを変更した場合も、行、列、およびヘッダーのサイズが変更される場合があります。  <xref:System.Windows.Forms.DataGridView> コントロールは、正しいサイズを決定するために、各セルが格納する値を調べます。  大量のデータを処理する場合には、自動サイズ変更が発生してこの解析が行われることによって、パフォーマンスが低下する可能性があります。  パフォーマンスの低下を回避するには、次のガイドラインに従います。  
+  
+-   大量の行セットを処理する <xref:System.Windows.Forms.DataGridView> コントロールでは、自動サイズ変更の使用を避けます。  自動サイズ変更を使用する場合も、表示されている行に基づくサイズ変更のみにします。  仮想モードでも、表示されている行のみを使用します。  
+  
+    -   行および列に対して、<xref:System.Windows.Forms.DataGridViewAutoSizeRowsMode>、<xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode>、および <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> の各列挙値の `DisplayedCells` フィールドまたは `DisplayedCellsExceptHeaders` フィールドを使用します。  
+  
+    -   行ヘッダーに、<xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode> 列挙値の <xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode> フィールドまたは <xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode> フィールドを使用します。  
+  
+-   スケーラビリティを最大にするには、自動サイズ変更を無効にし、プログラムによるサイズ変更を使用します。  
+  
+ 詳細については、「[Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 選択されているセル、行、および列のコレクションの効率的な使用  
+ <xref:System.Windows.Forms.DataGridView.SelectedCells%2A> コレクションは、選択範囲のサイズが大きいと効率が低下します。  <xref:System.Windows.Forms.DataGridView.SelectedRows%2A> コレクションおよび <xref:System.Windows.Forms.DataGridView.SelectedColumns%2A> コレクションの効率も低下する場合がありますが、通常の <xref:System.Windows.Forms.DataGridView> コントロールではセルの数よりも行の数が少なく、行の数よりも列の数が少ないため、低下の度合いは小さくなります。  これらのコレクション処理時のパフォーマンスの低下を回避するには、次のガイドラインに従います。  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectedCells%2A> コレクションの内容にアクセスする前に <xref:System.Windows.Forms.DataGridView> 内のすべてのセルが選択されているかどうかを確認するには、<xref:System.Windows.Forms.DataGridView.AreAllCellsSelected%2A> メソッドの戻り値をチェックします。  ただし、このメソッドを使用すると、行が非共有になることがあります。  詳細については、次のセクションを参照してください。  
+  
+-   選択されているセルの数を調べる場合は、<xref:System.Windows.Forms.DataGridViewSelectedCellCollection?displayProperty=fullName> の <xref:System.Collections.ICollection.Count%2A> プロパティの使用を避けます。  代わりに、<xref:System.Windows.Forms.DataGridView.GetCellCount%2A?displayProperty=fullName> メソッドを使用して、<xref:System.Windows.Forms.DataGridViewElementStates?displayProperty=fullName> 値を渡します。  同様に、選択されている要素の数を調べる場合は、選択されている行および列のコレクションにアクセスするのではなく、<xref:System.Windows.Forms.DataGridViewRowCollection.GetRowCount%2A?displayProperty=fullName> メソッドおよび <xref:System.Windows.Forms.DataGridViewColumnCollection.GetColumnCount%2A?displayProperty=fullName> メソッドを使用します。  
+  
+-   セルに基づく選択を行うモードの使用を避けます。  代わりに、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName> プロパティを <xref:System.Windows.Forms.DataGridViewSelectionMode?displayProperty=fullName> または <xref:System.Windows.Forms.DataGridViewSelectionMode?displayProperty=fullName> に設定します。  
+  
+## 共有行の使用  
+ 共有行を使用すると、<xref:System.Windows.Forms.DataGridView> コントロールでメモリを効率的に使用できます。  複数の行で <xref:System.Windows.Forms.DataGridViewRow> クラスのインスタンスを共有すると、行の表示形式と動作に関する情報が最大限共有されます。  
+  
+ 行のインスタンスを共有するとメモリを節約できる一方、行は非共有になりやすくなります。  たとえば、ユーザーがセルを直接操作すると、そのセルの行は非共有になります。  この動作は避けられないので、このトピックで示すガイドラインが役立つのは、大量のデータを処理する場合、およびプログラムを実行するたびにユーザーが操作するデータの割合が比較的小さい場合に限られます。  
+  
+ バインドされていない <xref:System.Windows.Forms.DataGridView> コントロール内で、値を含むセルがある行は共有できません。  <xref:System.Windows.Forms.DataGridView> コントロールを外部データ ソースにバインドしている場合、または仮想モードを実装して独自のデータ ソースを指定している場合は、セルの値はセル オブジェクトではなくコントロールの外部に格納されるので、行を共有できます。  
+  
+ 行オブジェクトは、その行のすべてのセルの状態が、それらのセルを含む行の状態および列の状態から決定できる場合に限り、共有できます。  セルの状態が変更され、そのセルの行および列の状態からセルの状態を推測できなくなった場合は、行を共有できません。  
+  
+ たとえば、次のいずれかの状況にある行は共有できません。  
+  
+-   選択されている列に含まれていない、単一選択されたセルを含む行。  
+  
+-   <xref:System.Windows.Forms.DataGridViewCell.ToolTipText%2A> プロパティまたは <xref:System.Windows.Forms.DataGridViewCell.ContextMenuStrip%2A> プロパティが設定されているセルを含む行。  
+  
+-   <xref:System.Windows.Forms.DataGridViewComboBoxCell.Items%2A> プロパティが設定されている <xref:System.Windows.Forms.DataGridViewComboBoxCell> を含む行。  
+  
+ バインド モードまたは仮想モードでは、<xref:System.Windows.Forms.DataGridView.CellToolTipTextNeeded> イベントおよび <xref:System.Windows.Forms.DataGridView.CellContextMenuStripNeeded> イベントを処理することで、ツールヒントおよびショートカット メニューを個別のセルに指定できます。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGridViewRowCollection> に行が追加されるたびに、自動的に共有行を使用しようとします。  行が確実に共有されるようにするには、次のガイドラインに従います。  
+  
+-   <xref:System.Windows.Forms.DataGridView.Rows%2A?displayProperty=fullName> コレクションの <xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A> メソッドの `Add(Object[])` オーバーロードおよび <xref:System.Windows.Forms.DataGridViewRowCollection.Insert%2A> メソッドの `Insert(Object[])` オーバーロードを呼び出さないようにします。  これらのオーバーロードは、自動的に非共有行を作成します。  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowTemplate%2A?displayProperty=fullName> プロパティに指定されている行は、次の場合に共有できます。  
+  
+    -   <xref:System.Windows.Forms.DataGridView.Rows%2A?displayProperty=fullName> コレクションの <xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A> メソッドの `Add()` オーバーロードまたは `Add(Int32)` オーバーロード、または <xref:System.Windows.Forms.DataGridViewRowCollection.Insert%2A> メソッドの `Insert(Int32,Int32)` オーバーロードを呼び出すとき。  
+  
+    -   <xref:System.Windows.Forms.DataGridView.RowCount%2A?displayProperty=fullName> プロパティの値を増加させるとき。  
+  
+    -   <xref:System.Windows.Forms.DataGridView.DataSource%2A?displayProperty=fullName> プロパティを設定するとき。  
+  
+-   <xref:System.Windows.Forms.DataGridView.Rows%2A?displayProperty=fullName> コレクションの <xref:System.Windows.Forms.DataGridViewRowCollection.AddCopy%2A>、<xref:System.Windows.Forms.DataGridViewRowCollection.AddCopies%2A>、<xref:System.Windows.Forms.DataGridViewRowCollection.InsertCopy%2A>、および <xref:System.Windows.Forms.DataGridViewRowCollection.InsertCopies%2A> の各メソッドを呼び出す場合は、`indexSource` パラメーターで指定される行が共有可能であることを確認してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView.Rows%2A?displayProperty=fullName> コレクションの <xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A> メソッドの `Add(DataGridViewRow)` オーバーロード、<xref:System.Windows.Forms.DataGridViewRowCollection.AddRange%2A> メソッド、<xref:System.Windows.Forms.DataGridViewRowCollection.Insert%2A> メソッドの `Insert(Int32,DataGridViewRow)` オーバーロード、および <xref:System.Windows.Forms.DataGridViewRowCollection.InsertRange%2A> メソッドを呼び出す場合は、指定される行が共有可能であることを確認してください。  
+  
+ 行が共有されているかどうかを確認するには、<xref:System.Windows.Forms.DataGridViewRowCollection.SharedRow%2A?displayProperty=fullName> メソッドを使用して行オブジェクトを取得し、そのオブジェクトの <xref:System.Windows.Forms.DataGridViewBand.Index%2A> プロパティを調べます。  共有行の <xref:System.Windows.Forms.DataGridViewBand.Index%2A> プロパティの値は常に –1 です。  
+  
+## 行が非共有になることの防止  
+ 共有行がコードまたはユーザー操作の結果として非共有行になることがあります。  パフォーマンスへの影響を回避するには、行が非共有にならないようにする必要があります。  アプリケーション開発時に <xref:System.Windows.Forms.DataGridView.RowUnshared> イベントを使用すると、行が非共有行になるときを確認できます。  これは、行の共有の問題をデバッグする際に便利です。  
+  
+ 行が非共有にならないようにするには、次のガイドラインに従います。  
+  
+-   <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションに対して、インデックスを指定したり、`foreach` ループで反復処理したりすることを避けます。  通常は、行に直接アクセスする必要はありません。  行を操作する <xref:System.Windows.Forms.DataGridView> のメソッドは、行のインスタンスではなく行インデックスを引数として使用します。  また、行に関連するイベントのハンドラーは、行プロパティを持つイベント引数オブジェクトを受け取ります。これを使用することで、行を非共有にすることなく操作できます。  
+  
+-   行オブジェクトにアクセスする必要がある場合は、<xref:System.Windows.Forms.DataGridViewRowCollection.SharedRow%2A?displayProperty=fullName> メソッドを使用し、行の実際のインデックスを渡します。  ただし、このメソッドで取得した共有行オブジェクトを変更すると、そのオブジェクトを共有するすべての行が変更されます。  一方、新しいレコードの行は、他の行と共有されないため、他のいずれかの行を変更しても影響を受けません。  また、同じ共有行で表される複数の行が、それぞれ異なるショートカット メニューを持つ場合があります。  共有行のインスタンスから正しいショートカット メニューを取得するには、<xref:System.Windows.Forms.DataGridViewRow.GetContextMenuStrip%2A> メソッドを使用し、行の実際のインデックスを渡します。  そうせずに、共有行の <xref:System.Windows.Forms.DataGridViewRow.ContextMenuStrip%2A> プロパティにアクセスすると、共有行のインデックス \-1 が使用され、正しいショートカット メニューを取得できません。  
+  
+-   <xref:System.Windows.Forms.DataGridViewRow.Cells%2A?displayProperty=fullName> コレクションにインデックスを指定しないようにします。  セルに直接アクセスすると、そのセルの親となる行が非共有になり、新しい <xref:System.Windows.Forms.DataGridViewRow> のインスタンスが作成されます。  セルに関連するイベントのハンドラーは、セル プロパティを持つイベント引数オブジェクトを受け取ります。これを使用することで、行を非共有にすることなくセルを操作できます。  また、<xref:System.Windows.Forms.DataGridView.CurrentCellAddress%2A> プロパティを使用すると、セルに直接アクセスすることなく、現在のセルの行と列のインデックスを取得できます。  
+  
+-   セルに基づく選択を行うモードの使用を避けます。  このようなモードでは、行が非共有になります。  代わりに、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName> プロパティを <xref:System.Windows.Forms.DataGridViewSelectionMode?displayProperty=fullName> または <xref:System.Windows.Forms.DataGridViewSelectionMode?displayProperty=fullName> に設定します。  
+  
+-   <xref:System.Windows.Forms.DataGridViewRowCollection.CollectionChanged?displayProperty=fullName> イベントまたは <xref:System.Windows.Forms.DataGridView.RowStateChanged?displayProperty=fullName> イベントを処理しないでください。  これらのイベントでは、行が非共有になります。  また、<xref:System.Windows.Forms.DataGridViewRowCollection.OnCollectionChanged%2A?displayProperty=fullName> メソッドまたは <xref:System.Windows.Forms.DataGridView.OnRowStateChanged%2A?displayProperty=fullName> メソッドを呼び出さないでください。呼び出すと、これらのイベントが発生します。  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName> プロパティの値が <xref:System.Windows.Forms.DataGridViewSelectionMode>、<xref:System.Windows.Forms.DataGridViewSelectionMode>、<xref:System.Windows.Forms.DataGridViewSelectionMode>、または <xref:System.Windows.Forms.DataGridViewSelectionMode> の場合は、<xref:System.Windows.Forms.DataGridView.SelectedCells%2A?displayProperty=fullName> コレクションにアクセスしないでください。  アクセスすると、選択されているすべての行が非共有になります。  
+  
+-   <xref:System.Windows.Forms.DataGridView.AreAllCellsSelected%2A?displayProperty=fullName> メソッドを呼び出さないでください。  このメソッドを呼び出すと、行が非共有になります。  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName> プロパティの値が <xref:System.Windows.Forms.DataGridViewSelectionMode> の場合は、<xref:System.Windows.Forms.DataGridView.SelectAll%2A?displayProperty=fullName> メソッドを呼び出さないでください。  アクセスすると、すべての行が非共有になります。  
+  
+-   セルの <xref:System.Windows.Forms.DataGridViewCell.ReadOnly%2A> プロパティまたは <xref:System.Windows.Forms.DataGridViewCell.Selected%2A> プロパティは、その列の対応するプロパティが `true` に設定されているときは `false` に設定しないでください。  アクセスすると、すべての行が非共有になります。  
+  
+-   <xref:System.Windows.Forms.DataGridViewRowCollection.List%2A?displayProperty=fullName> プロパティにアクセスしないでください。  アクセスすると、すべての行が非共有になります。  
+  
+-   <xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(IComparer)` オーバーロードを呼び出さないでください。  カスタム比較子で並べ替えを行うと、すべての行が非共有になります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md b/docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..59ca4b2157f
--- /dev/null
+++ b/docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md
@@ -0,0 +1,69 @@
+---
+title: "TableLayoutPanel コントロールの推奨される手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サイズの自動調整"
+  - "AutoSize プロパティ, TableLayoutPanel コントロール"
+  - "推奨される手順, TableLayoutPanel コントロール"
+  - "コントロール [Windows フォーム], サイズ変更"
+  - "フォーム, 推奨される手順"
+  - "レイアウト [Windows フォーム]"
+  - "レイアウト [Windows フォーム], 推奨される手順"
+  - "レイアウト [Windows フォーム], AutoSize"
+  - "サイズ変更, 自動"
+  - "TableLayoutPanel コントロール [Windows フォーム], 推奨される手順"
+  - "TableLayoutPanel コントロール [Windows フォーム], AutoSize の動作"
+ms.assetid: b6706efb-d7a4-45ec-8cf4-08fa993e3afb
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TableLayoutPanel コントロールの推奨される手順
+<xref:System.Windows.Forms.TableLayoutPanel> コントロールが提供する強力なレイアウト機能については、Windows フォームで使用する前に慎重に検討する必要があります。  
+  
+## 推奨  
+ 以下の推奨事項は、<xref:System.Windows.Forms.TableLayoutPanel> コントロールを有効に利用する上で役立ちます。  
+  
+### 対象となるレイアウト  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用する場合は注意が必要です。  サイズ変更が可能なレイアウトが必要であってもすべての状況で使用できるわけではありません。  次のようなレイアウトでは、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの使用が最も適しています。  
+  
+-   フォームが複数の部分から成り、それぞれを比例的にサイズ変更する必要があるレイアウト。  
+  
+-   実行時に動的に変更または生成されるレイアウト \(たとえば、ユーザーによるカスタマイズが可能なフィールドが、設定に基づいて追加または削除されるデータ入力フォームなど\)。  
+  
+-   全体のサイズを固定しておく必要があるレイアウト。  たとえば、ダイアログ ボックスのサイズを 800 × 600 以下に維持しながら、ローカライズされた文字列をサポートする必要がある場合などです。  
+  
+ 次のようなレイアウトでは、<xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用してもあまり有効ではありません。  
+  
+-   ラベルとテキスト入力領域の列をそれぞれ 1 つずつ持つ単純なデータ入力フォーム。  
+  
+-   サイズ変更の際に、使用できる領域全体を満たす必要がある 1 つの大きな表示領域を持つフォーム。  この例としては、単一の <xref:System.Windows.Forms.PropertyGrid> コントロールを表示するフォームがあります。  この場合、フォームのサイズを変更したときに他の要素を拡張する必要がないため、固定を適用します。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールに必要なコントロールを慎重に選択します。  アンカーを使用してテキストを 30% まで拡張する余裕がある場合、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティのみを使用することを検討してください。  レイアウトに必要な領域を推定できる場合、<xref:System.Windows.Forms.Control.Dock%2A> と <xref:System.Windows.Forms.Control.Anchor%2A> を使用する方法は、残りの領域と <xref:System.Windows.Forms.Control.AutoSize%2A> 動作の詳細を推定するよりも簡単です。  
+  
+ 一般に、<xref:System.Windows.Forms.TableLayoutPanel> を使用してレイアウトをデザインする場合、デザインはできるだけ単純にします。  
+  
+### \[ドキュメント アウトライン\] ウィンドウの使用  
+ \[ドキュメント アウトライン\] ウィンドウには、レイアウトがツリー ビューに表示されます。コントロールの Z オーダーと親子関係を操作するときに使用できます。  **\[表示\]** メニューの **\[その他のウィンドウ\]** をポイントし、**\[ドキュメント アウトライン\]** をクリックします。  
+  
+### 入れ子を避ける  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールに他の <xref:System.Windows.Forms.TableLayoutPanel> コントロールを入れ子にするのは避けてください。  入れ子になったレイアウトのデバッグは困難な場合があります。  
+  
+### ビジュアル継承を避ける  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、Windows フォーム デザイナーのビジュアル継承をサポートしていません。  派生クラスの <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、デザイン時には "ロックされた" 状態で表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ <xref:System.Windows.Forms.FlowLayoutPanel>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bind-data-to-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/bind-data-to-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..346b923ce91
--- /dev/null
+++ b/docs/framework/winforms/controls/bind-data-to-the-datagrid-using-the-designer.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : デザイナーを使用してデータを Windows フォーム DataGridView コントロールにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ ソース, バインド (Windows フォーム コントロールに)"
+  - "DataGridView コントロール [Windows フォーム], データ バインド"
+  - "Windows フォーム コントロール, バインド (データ ソースに)"
+ms.assetid: f4f46009-cec2-441b-8668-6b5af057558b
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : デザイナーを使用してデータを Windows フォーム DataGridView コントロールにバインドする
+デザイナーを使用して、データベース、ビジネス オブジェクト、Web サービスなど、さまざまなデータ ソースに <xref:System.Windows.Forms.DataGridView> コントロールを関連付けることができます。  デザイナーを使用してデータ ソースにコントロールをバインドすると、コントロールは、データ ソースを表す <xref:System.Windows.Forms.BindingSource> コンポーネントに自動的にバインドされます。  また、データ ソースが提供するスキーマ情報に合わせて、コントロール内に列が自動的に生成されます。  
+  
+ 生成された列は、必要に応じて変更できます。  たとえば、表示する必要がない列を削除したり、非表示にしたりできます。また、列を再配置したり列の種類を変更することもできます。  列の変更の詳細については、「参照」の各トピックを参照してください。  
+  
+ また、複数の <xref:System.Windows.Forms.DataGridView> コントロールを関連するテーブルにバインドし、マスター\/詳細リレーションシップを構築することもできます。  この構成の場合、あるコントロールは親テーブルを表示し、別のコントロールは親テーブルの現在の行に関連する子テーブルの行のみを表示します。  詳細については、「[方法: 関連するデータを Windows フォーム アプリケーションに表示する](../Topic/How%20to:%20Display%20Related%20Data%20in%20a%20Windows%20Forms%20Application.md)」を参照してください。  
+  
+ 次の手順では、マスター\/詳細リレーションシップに関する 1 つまたは 2 つの <xref:System.Windows.Forms.DataGridView> コントロールが含まれているフォームを持つ、**Windows アプリケーション** プロジェクトが必要です。  このようなプロジェクトの起動については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」と「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールをデータ ソースにバインドするには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅のスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックします。  
+  
+2.  **\[データ ソースの選択\]** オプションのドロップダウン矢印をクリックします。  
+  
+3.  プロジェクトのデータ ソースがまだない場合は、**\[プロジェクト データ ソースの追加\]** をクリックし、ウィザードに示された手順に従います。  
+  
+     詳細については、「[データ ソース構成ウィザード](../Topic/Data%20Source%20Configuration%20Wizard.md)」を参照してください。  新しいデータ ソースが **\[データ ソースの選択\]** ボックスに表示されます。  新しいデータ ソースに 1 つのメンバー \(たとえば、1 つのデータベース テーブル\) だけが含まれる場合、コントロールはそのメンバーに自動的にバインドされます。  それ以外の場合は、次の手順に進みます。  
+  
+4.  **\[他のデータ ソース\]** ノードと **\[プロジェクト データ ソース\]** ノードが展開されていない場合は、展開します。次に、コントロールをバインドするデータ ソースを選択します。  
+  
+5.  データ ソースに複数のメンバーが含まれる場合 \(たとえば、複数のテーブルを含む <xref:System.Data.DataSet?displayProperty=fullName> を作成した場合\) は、データ ソースを展開し、バインド先となる特定のメンバーを選択します。  
+  
+6.  マスター\/詳細リレーションシップを構築するには、2 つ目の <xref:System.Windows.Forms.DataGridView> コントロールの **\[データ ソースの選択\]** ドロップダウン ウィンドウで、親テーブル用に作成された <xref:System.Windows.Forms.BindingSource> を展開し、表示されるリストから関連する子テーブルを選択します。  
+  
+    > [!NOTE]
+    >  プロジェクトにデータ ソースが既に含まれている場合、**\[データ ソース\]** ウィンドウを使用してデータ フォームを作成することもできます。  詳細については、「[ウィンドウ](../Topic/Data%20Sources%20Window.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.DataGridView.DataMember%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A?displayProperty=fullName>   
+ [方法 : データベース内のデータに接続する](../Topic/How%20to:%20Connect%20to%20Data%20in%20a%20Database.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/change-the-order-of-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView 列の種類を変更する](../../../../docs/framework/winforms/controls/change-the-type-of-a-wf-datagridview-column-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする](../../../../docs/framework/winforms/controls/hide-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/make-columns-read-only-in-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [ウィンドウ](../Topic/Data%20Sources%20Window.md)   
+ [方法: 関連するデータを Windows フォーム アプリケーションに表示する](../Topic/How%20to:%20Display%20Related%20Data%20in%20a%20Windows%20Forms%20Application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bind-wf-controls-with-the-bindingsource.md b/docs/framework/winforms/controls/bind-wf-controls-with-the-bindingsource.md
new file mode 100644
index 00000000000..93786d9837c
--- /dev/null
+++ b/docs/framework/winforms/controls/bind-wf-controls-with-the-bindingsource.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム コントロールを BindingSource コンポーネントにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (コントロールを)"
+  - "コントロール [Windows フォーム], バインド"
+  - "データ バインド, BindingSource コンポーネント"
+ms.assetid: 391ae170-de5c-40f8-8233-91cb2ee4683a
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : デザイナーを使用して Windows フォーム コントロールを BindingSource コンポーネントにバインドする
+コントロールをフォームに追加し、アプリケーションのユーザー インターフェイスを決定したら、実行時にユーザーがアプリケーションに関するデータを変更および保存できるようにコントロールをデータ ソースにバインドできます。  
+  
+ Windows フォーム上の特定のコントロールまたは一連のコントロールをバインドする場合、フォーム上のコントロールとデータ ソース間の橋渡しとして <xref:System.Windows.Forms.BindingSource> コントロールを使用する方法が最も簡単です。  
+  
+ フォーム上の 1 つ以上のコントロールをデータにバインドできます。次の手順では、<xref:System.Windows.Forms.TextBox> コントロールをデータ ソースにバインドします。  
+  
+ この手順では、データベースから派生したデータ ソースにバインドするものと仮定します。  他のデータ ストアからデータ ソースを作成する方法の詳細については、「[データ ソースの概要](../Topic/Add%20new%20data%20sources.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にコントロールをバインドするには  
+  
+1.  <xref:System.Windows.Forms.TextBox> コントロールをフォーム上にドラッグします。  
+  
+2.  **\[プロパティ\]** ウィンドウで、次の操作を行います。  
+  
+    1.  **\[Databindings\]** ノードを展開します。  
+  
+    2.  <xref:System.Windows.Forms.TextBox.Text%2A> プロパティの横にある矢印をクリックします。  
+  
+         **DataSource** UI 型エディターが開きます。  
+  
+         データ ソースが既にこのプロジェクトまたはフォーム用に構成されている場合は、そのデータ ソースが表示されます。  
+  
+3.  **\[プロジェクト データ ソースの追加\]** をクリックしてデータに接続し、データ ソースを作成します。  
+  
+4.  **データ ソース構成ウィザード**の \[ようこそ\] ページで、**\[次へ\]** をクリックします。  
+  
+5.  **\[データ ソースの種類を選択\]** ページで、**\[データベース\]** を選択します。  
+  
+6.  **\[データ接続の選択\]** ページで、使用できる接続の一覧からデータ接続を選択します。  目的のデータ接続が表示されていないときは、**\[新しい接続\]** をクリックして新しいデータ接続を作成します。  
+  
+7.  **\[次の名前で接続を保存する\]** をクリックして、アプリケーション構成ファイルに接続文字列を保存します。  
+  
+8.  アプリケーションで使用するデータベース オブジェクトを選択します。  この場合は、<xref:System.Windows.Forms.TextBox> に表示するテーブルのフィールドを選択します。  
+  
+9. 必要に応じて、既定のデータセット名を変更します。  
+  
+10. **\[完了\]** をクリックします。  
+  
+11. **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.TextBox.Text%2A> プロパティの横にある矢印をもう一度クリックします。  **DataSource** UI 型エディターで、<xref:System.Windows.Forms.TextBox> をバインドするフィールドの名前を選択します。  
+  
+     **DataSource** UI 型エディターが閉じられ、データ接続に固有のデータセット、<xref:System.Windows.Forms.BindingSource>、およびテーブル アダプターがフォームに追加されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.BindingNavigator>   
+ [データ ソースの概要](../Topic/Add%20new%20data%20sources.md)   
+ [ウィンドウ](../Topic/Data%20Sources%20Window.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bind-wf-datagrid-control-to-a-data-source-using-the-designer.md b/docs/framework/winforms/controls/bind-wf-datagrid-control-to-a-data-source-using-the-designer.md
new file mode 100644
index 00000000000..8b1ef68a843
--- /dev/null
+++ b/docs/framework/winforms/controls/bind-wf-datagrid-control-to-a-data-source-using-the-designer.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : デザイナーを使ってデータ ソースに Windows フォーム DataGrid コントロールをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール"
+  - "バインド コントロール, DataGrid コントロール"
+  - "データ バインド, DataGrid コントロール"
+  - "データ バインド コントロール, DataGrid"
+  - "DataGrid コントロール [Windows フォーム], データ バインド"
+  - "データセット [Windows フォーム], バインド (DataGrid コントロールに)"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: 4e96e3d0-b1cc-4de1-8774-bc9970ec4554
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : デザイナーを使ってデータ ソースに Windows フォーム DataGrid コントロールをバインドする
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロールは、データ ソースの情報を表示するようにデザインされています。  このコントロールは、<xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティおよび <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティを設定してデザイン時にバインドするか、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを呼び出して実行時にバインドします。  各種データ ソースのデータを表示できますが、最も一般的なソースはデータセットとデータ ビューです。  
+  
+ デザイン時にデータ ソースを利用できる場合、たとえばフォームにデータセットやデータ ビューのインスタンスが含まれる場合などは、デザイン時にグリッドをデータ ソースにバインドできます。  その場合は、データがグリッド上でどのように見えるかをプレビューできます。  
+  
+ 実行時にプログラムでグリッドを連結することもできます。  この方法は、実行時に取得した情報に基いてデータ ソースを設定する必要があるときに便利です。  たとえば、表示するテーブルの名前をユーザーが指定できるアプリケーションなどの場合です。  実行時の連結は、データ ソースがデザイン時に存在しない場合にも必要です。  この場合のデータ ソースとしては、配列、コレクション、型指定されていないデータセット、データ リーダーなどが挙げられます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGrid> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、既定で <xref:System.Windows.Forms.DataGrid> コントロールは**ツールボックス**に含まれていません。  コントロールの追加の詳細については、「[How to: Add Items to the Toolbox](http://msdn.microsoft.com/ja-jp/458e119e-17fe-450b-b889-e31c128bd7e0)」を参照してください。  また、[!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、**\[データ ソース\]** ウィンドウを使ってデザイン時のデータ バインディングを設定します。  詳細については、「[Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーで DataGrid コントロールを単一のテーブルのデータにバインドするには  
+  
+1.  コントロールの <xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティに、連結するデータ項目を含むオブジェクトを設定します。  
+  
+2.  データ ソースがデータセットである場合は、<xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティに連結するテーブルの名前を設定します。  
+  
+3.  データ ソースが、データセット テーブルに基づくデータセットまたはデー タビューの場合は、そのデータセットにデータを読み込むためのコードをフォームに追加します。  
+  
+     実際に使用するコードは、データセットがデータをどこで取得するかに依存します。  データセットにデータベースのデータを直接読み込む場合は、通常はデータ アダプターの `Fill` メソッドを呼び出します。次のコード例では、`DsCategories1` というデータセットにデータを読み込んでいます。  
+  
+    ```vb  
+    sqlDataAdapter1.Fill(DsCategories1)  
+  
+    ```  
+  
+    ```csharp  
+    sqlDataAdapter1.Fill(DsCategories1);  
+  
+    ```  
+  
+    ```cpp  
+    sqlDataAdapter1->Fill(dsCategories1);  
+    ```  
+  
+4.  \(必要に応じて\) 適切なテーブル スタイルと列スタイルをグリッドに追加します。  
+  
+     テーブル スタイルがなくてもテーブルを表示できますが、その場合は最低限の書式だけが適用され、すべての列が表示されます。  
+  
+### デザイナーで DataGrid コントロールをデータセットの複数のテーブルにデータ連結するには  
+  
+1.  コントロールの <xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティに、連結するデータ項目を含むオブジェクトを設定します。  
+  
+2.  データセットに関連テーブルが含まれる場合 \(つまり、リレーションシップ オブジェクトが含まれる場合\)、<xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティに親テーブルの名前を設定します。  
+  
+3.  データセットにデータを読み込むコードを記述します。  
+  
+## 参照  
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [Visual Studio でのデータへのアクセス](../Topic/Accessing%20data%20in%20Visual%20Studio.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bindingnavigator-control-overview-windows-forms.md b/docs/framework/winforms/controls/bindingnavigator-control-overview-windows-forms.md
new file mode 100644
index 00000000000..8274893f55b
--- /dev/null
+++ b/docs/framework/winforms/controls/bindingnavigator-control-overview-windows-forms.md
@@ -0,0 +1,56 @@
+---
+title: "BindingNavigator コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DataNavigator"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingNavigator コントロール [Windows フォーム], BindingNavigator コントロールの概要"
+  - "データ [Windows フォーム], 移動"
+  - "データ間の移動"
+  - "レコード, 移動 (フォーム上の)"
+ms.assetid: 4423eede-f8d1-4d02-822f-5bf8432680d0
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# BindingNavigator コントロールの概要 (Windows フォーム)
+<xref:System.Windows.Forms.BindingNavigator> コントロールを使用して、ユーザーが Windows フォームでデータを検索して変更するための標準化された手段を作成できます。  <xref:System.Windows.Forms.BindingNavigator> を <xref:System.Windows.Forms.BindingSource> コンポーネントと共に頻繁に使用して、ユーザーがフォームのデータ レコードを移動して、レコードと対話できるようにします。  
+  
+## BindingNavigator のしくみ  
+ データの追加、データの削除、およびデータの移動という一般的なデータ関連の操作のほとんどで、<xref:System.Windows.Forms.BindingNavigator> コントロールは一連の <xref:System.Windows.Forms.ToolStripItem> オブジェクトを持つ <xref:System.Windows.Forms.ToolStrip> で構成されます。  既定では、<xref:System.Windows.Forms.BindingNavigator> コントロールにこれらの標準のボタンが含まれています。  次のスクリーン ショットは、フォーム上の <xref:System.Windows.Forms.BindingNavigator> コントロールを示します。  
+  
+ ![BindingNavigator コントロール](../../../../docs/framework/winforms/controls/media/cpdatacontainerctrl.gif "cpDataContainerCtrl")  
+  
+ コントロールの一覧と機能の説明を次の表に示します。  
+  
+|コントロール|関数|  
+|------------|--------|  
+|<xref:System.Windows.Forms.BindingNavigator.AddNewItem%2A> ボタン|基になるデータ ソースに新しい行を挿入します。|  
+|<xref:System.Windows.Forms.BindingNavigator.DeleteItem%2A> ボタン|基になるデータ ソースから現在の行を削除します。|  
+|<xref:System.Windows.Forms.BindingNavigator.MoveFirstItem%2A> ボタン|基になるデータ ソースの最初の項目に移動します。|  
+|<xref:System.Windows.Forms.BindingNavigator.MoveLastItem%2A> ボタン|基になるデータ ソースの最後の項目に移動します。|  
+|<xref:System.Windows.Forms.BindingNavigator.MoveNextItem%2A> ボタン|基になるデータ ソースの次の項目に移動します。|  
+|<xref:System.Windows.Forms.BindingNavigator.MovePreviousItem%2A> ボタン|基になるデータ ソースの前の項目に移動します。|  
+|<xref:System.Windows.Forms.BindingNavigator.PositionItem%2A> テキスト ボックス|基になるデータ ソース内の現在の位置を返します。|  
+|<xref:System.Windows.Forms.BindingNavigator.CountItem%2A> テキスト ボックス|基になるデータ ソースの項目の総数を返します。|  
+  
+ このコレクションの各コントロールに対して、同じ機能をプログラムで提供する <xref:System.Windows.Forms.BindingSource> コンポーネントの対応するメンバーが存在します。  たとえば、<xref:System.Windows.Forms.BindingNavigator.MoveFirstItem%2A> ボタンは <xref:System.Windows.Forms.BindingSource> コンポーネントの <xref:System.Windows.Forms.BindingSource.MoveFirst%2A> メソッドに対応し、<xref:System.Windows.Forms.BindingNavigator.DeleteItem%2A> ボタンは <xref:System.Windows.Forms.BindingSource.RemoveCurrent%2A> メソッドに対応します。  
+  
+ 既定のボタンがアプリケーションに適していない場合、またはその他の種類の機能をサポートするために追加のボタンを必要とする場合は、独自の <xref:System.Windows.Forms.ToolStrip> ボタンを指定できます。  「[方法 : Windows フォーム BindingNavigator コントロールに \[Load\]、\[Save\]、\[Cancel\] の各ボタンを追加する](../../../../docs/framework/winforms/controls/load-save-and-cancel-bindingnavigator.md)」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md b/docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md
new file mode 100644
index 00000000000..a01d9fab18f
--- /dev/null
+++ b/docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "BindingNavigator コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingNavigator コントロール [Windows フォーム]"
+  - "データ [Windows フォーム], 移動"
+  - "データ間の移動"
+ms.assetid: 18c1e2a5-9834-40d3-9b2e-2b545e4e769e
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# BindingNavigator コントロール (Windows フォーム)
+The `BindingNavigator` control is the navigation and manipulation user interface \(UI\) for controls that are bound to data.  The `BindingNavigator` control enables users to navigate through and manipulate data on a Windows Form.  
+  
+ このセクションのトピックでは、`BindingNavigator` コントロールの概要について説明し、コントロール移動データを使用して <xref:System.Data.DataSet> を移動する方法について、詳細な手順を示します。  
+  
+## このセクションの内容  
+ [BindingNavigator コントロールの概要](../../../../docs/framework/winforms/controls/bindingnavigator-control-overview-windows-forms.md)  
+ ユーザーがデータ ソースの項目を移動できるようにする `BindingNavigator` コントロールの一般的な概念を紹介します。  
+  
+ [方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する](../../../../docs/framework/winforms/controls/how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md)  
+ `BindingNavigator` コントロールをデータ ソースにバインドする手順を示します。  
+  
+ [方法 : Windows フォームの BindingNavigator コントロールを使用して DataSet を移動する](../../../../docs/framework/winforms/controls/move-through-a-dataset-with-wf-bindingnavigator-control.md)  
+ `BindingNavigator` コントロールを使用して <xref:System.Data.DataSet> 内のレコードを移動する方法を示します。  
+  
+ 「[方法 : Windows フォーム BindingNavigator コントロールに \[Load\]、\[Save\]、\[Cancel\] の各ボタンを追加する](../../../../docs/framework/winforms/controls/load-save-and-cancel-bindingnavigator.md)」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.BindingNavigator>  
+ <xref:System.Windows.Forms.BindingNavigator> コントロールのリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.BindingSource>  
+ <xref:System.Windows.Forms.BindingSource> コントロールのリファレンス ドキュメントを提供します。  
+  
+## 関連項目  
+ [Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bindingsource-component-architecture.md b/docs/framework/winforms/controls/bindingsource-component-architecture.md
new file mode 100644
index 00000000000..0d7eae7c49b
--- /dev/null
+++ b/docs/framework/winforms/controls/bindingsource-component-architecture.md
@@ -0,0 +1,188 @@
+---
+title: "BindingSource コンポーネント アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], BindingSource コンポーネントの概要"
+  - "BindingSource コンポーネント, アーキテクチャ"
+  - "データ バインド, BindingSource コンポーネント"
+  - "Windows フォーム, データ バインド"
+ms.assetid: 7bc69c90-8a11-48b1-9336-3adab5b41591
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# BindingSource コンポーネント アーキテクチャ
+<xref:System.Windows.Forms.BindingSource> コンポーネントを使用すると、すべての Windows フォーム コントロールをデータ ソースへバインドできます。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、コントロールをデータ ソースにバインドするプロセスを簡略化し、従来のデータ バインディングにはなかったいくつかの利点を提供します。  
+  
+-   ビジネス オブジェクトへのデザイン時のバインディングが可能です。  
+  
+-   <xref:System.Windows.Forms.CurrencyManager> 機能をカプセル化し、デザイン時に <xref:System.Windows.Forms.CurrencyManager> イベントを公開します。  
+  
+-   リストの変更通知機能をネイティブでサポートしないデータ ソースにリストの変更通知機能を提供することによって、<xref:System.ComponentModel.IBindingList> インターフェイスをサポートするリストの作成を簡略化します。  
+  
+-   <xref:System.ComponentModel.IBindingList.AddNew%2A?displayProperty=fullName> メソッドに機能拡張ポイントを提供します。  
+  
+-   データ ソースとコントロールの間に間接操作のレベルを提供します。  この間接操作は、実行時にデータ ソースが変化する可能性がある場合に重要です。  
+  
+-   他のデータ関連の Windows フォーム コントロール \(特に <xref:System.Windows.Forms.BindingNavigator> コントロールと <xref:System.Windows.Forms.DataGridView> コントロール\) と相互運用します。  
+  
+ これらの理由により、Windows フォーム コントロールをデータ ソースにバインドする方法として、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用することをお勧めします。  
+  
+## BindingSource の機能  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントには、コントロールをデータにバインドするための機能がいくつか用意されています。  これらの機能により、コーディングをほとんど行わずに、大部分のデータ バインディング シナリオを実装できます。  
+  
+ これを実現するため、<xref:System.Windows.Forms.BindingSource> コンポーネントはさまざまな種類のデータ ソースにアクセスするための一貫性のあるインターフェイスを提供します。  つまり、同じ手順を使用してすべての型にバインドできるということです。  たとえば、<xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティを <xref:System.Data.DataSet> にもビジネス オブジェクトにも追加できます。どちらの場合も、同じプロパティ、メソッド、およびイベントのセットを使用してデータ ソースを操作できます。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントが提供する一貫性のあるインターフェイスにより、データをコントロールにバインドするプロセスが大幅に簡略化されます。  変更通知を行うデータ ソースの場合、<xref:System.Windows.Forms.BindingSource> コンポーネントによってコントロールとデータ ソース間で変更が自動的に伝達されます。  変更通知を行うデータ ソースの場合は、変更通知を発生させるためのイベントが提供されます。  <xref:System.Windows.Forms.BindingSource> コンポーネントがサポートする機能を次に示します。  
+  
+-   間接  
+  
+-   伝達性管理  
+  
+-   リストとしてのデータ ソース  
+  
+-   <xref:System.ComponentModel.IBindingList> としての <xref:System.Windows.Forms.BindingSource>  
+  
+-   カスタム項目の作成  
+  
+-   トランザクション項目の作成  
+  
+-   <xref:System.Collections.IEnumerable> のサポート  
+  
+-   デザイン時サポート  
+  
+-   静的な <xref:System.Windows.Forms.ListBindingHelper> メソッド  
+  
+-   <xref:System.ComponentModel.IBindingListView> インターフェイスを使用した並べ替えとフィルター処理  
+  
+-   <xref:System.Windows.Forms.BindingNavigator> との統合  
+  
+### 間接  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、コントロールとデータ ソース間に間接操作のレベルを提供します。  コントロールをデータ ソースに直接バインドする代わりに、コントロールを <xref:System.Windows.Forms.BindingSource> にバインドし、<xref:System.Windows.Forms.BindingSource> コンポーネントの <xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティにデータ ソースを追加します。  
+  
+ この間接操作のレベルを使用すると、コントロールのバインディングをリセットせずにデータ ソースを変更できます。  これによって、次の作業を行うことができます。  
+  
+-   現在のコントロール バインディングを維持したまま、異なるデータ ソースに <xref:System.Windows.Forms.BindingSource> を追加できます。  
+  
+-   データ ソース内の項目を変更し、バインド コントロールに通知できます。  詳細については、「[方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる](../../../../docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md)」を参照してください。  
+  
+-   メモリ内のオブジェクトではなく、<xref:System.Type> にバインドできます。  詳細については、「[方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)」を参照してください。  その後、実行時にオブジェクトにバインドできます。  
+  
+### 伝達性管理  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、<xref:System.Windows.Forms.ICurrencyManagerProvider> インターフェイスを実装し、通過管理を処理します。  また、<xref:System.Windows.Forms.ICurrencyManagerProvider> インターフェイスにより、<xref:System.Windows.Forms.BindingSource> の CurrencyManager だけでなく、同じ <xref:System.Windows.Forms.BindingSource.DataMember%2A> にバインドされた他の <xref:System.Windows.Forms.BindingSource> の CurrencyManager にもアクセスできます。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは <xref:System.Windows.Forms.CurrencyManager> 機能をカプセル化し、最も一般的な <xref:System.Windows.Forms.CurrencyManager> プロパティとイベントを公開します。  伝達性管理に関連するメンバーのいくつかを次の表に示します。  
+  
+ <xref:System.Windows.Forms.ICurrencyManagerProvider.CurrencyManager%2A> プロパティ  
+ <xref:System.Windows.Forms.BindingSource> に関連付けられている CurrencyManager を取得します。  
+  
+ <xref:System.Windows.Forms.ICurrencyManagerProvider.GetRelatedCurrencyManager%2A> メソッド  
+ 別の <xref:System.Windows.Forms.BindingSource> が、指定したデータ メンバーにバインドされている場合、その CurrencyManager を取得します。  
+  
+ <xref:System.Windows.Forms.BindingSource.Current%2A> プロパティ  
+ データ ソースの現在の項目を取得します。  
+  
+ <xref:System.Windows.Forms.BindingSource.Position%2A> プロパティ  
+ 基になるリストでの現在の位置を取得または設定します。  
+  
+ <xref:System.Windows.Forms.BindingSource.EndEdit%2A> メソッド  
+ 基になるデータ ソースに保留中の変更を適用します。  
+  
+ <xref:System.Windows.Forms.BindingSource.CancelEdit%2A> メソッド  
+ 現在の編集操作をキャンセルします。  
+  
+### リストとしてのデータ ソース  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、<xref:System.ComponentModel.IBindingListView> インターフェイスと <xref:System.ComponentModel.ITypedList> インターフェイスを実装します。  この実装により、外部のストレージを使用せず、<xref:System.Windows.Forms.BindingSource> コンポーネント自体をデータ ソースとして使用できます。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントをデータ ソースに追加すると、データ ソースはリストとして公開されます。  
+  
+ <xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティには、複数のデータ ソースを設定できます。  たとえば、型、オブジェクト、型のリストなどです。  その結果、データ ソースがリストとして公開されます。  一般的なデータ ソースおよび結果としてのリストの評価を次の表に示します。  
+  
+|DataSource プロパティ|結果のリスト|  
+|----------------------|------------|  
+|null 参照 \(Visual Basic では `Nothing`\)|オブジェクトの空の <xref:System.ComponentModel.IBindingList>。  項目を追加すると、リストは追加した項目の型に設定されます。|  
+|<xref:System.Windows.Forms.BindingSource.DataMember%2A> を設定した null 参照 \(Visual Basic では `Nothing`\)|サポートされていません。<xref:System.ArgumentException> が発生します。|  
+|非リスト型、または "T" 型のオブジェクト|"T" 型の空の <xref:System.ComponentModel.IBindingList>。|  
+|配列インスタンス|配列要素を含む <xref:System.ComponentModel.IBindingList>。|  
+|<xref:System.Collections.IEnumerable> インスタンス|<xref:System.Collections.IEnumerable> 項目を含む <xref:System.ComponentModel.IBindingList>。|  
+|"T" 型を含むリスト インスタンス|"T" 型を含む <xref:System.ComponentModel.IBindingList> インスタンス。|  
+  
+ また、<xref:System.Windows.Forms.BindingSource.DataSource%2A> は <xref:System.ComponentModel.IListSource> や <xref:System.ComponentModel.ITypedList> などの他のリスト型に設定でき、それらは <xref:System.Windows.Forms.BindingSource> によって適切に処理されます。  この場合、リストに含まれる型は既定のコンストラクターを持ちます。  
+  
+### IBindingList としての BindingSource  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、基になるデータにアクセスし、操作するためのメンバーを <xref:System.ComponentModel.IBindingList> として提供します。  これらのメンバーのいくつかを次の表に示します。  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.Forms.BindingSource.List%2A> プロパティ|<xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティまたは <xref:System.Windows.Forms.BindingSource.DataMember%2A> プロパティの評価から生成されるリストを取得します。|  
+|<xref:System.Windows.Forms.BindingSource.AddNew%2A> メソッド|基になるリストに新しい項目を追加します。  <xref:System.ComponentModel.IBindingList> インターフェイスを実装し、項目の追加を有効にする \(つまり、<xref:System.Windows.Forms.BindingSource.AllowNew%2A> プロパティが `true` に設定されている\) データ ソースに適用されます。|  
+  
+### カスタム項目の作成  
+ <xref:System.Windows.Forms.BindingSource.AddingNew> イベントを処理して独自の項目作成ロジックを提供できます。  <xref:System.Windows.Forms.BindingSource.AddingNew> イベントは、新しいオブジェクトが <xref:System.Windows.Forms.BindingSource> に追加される前に発生します。  このイベントは、<xref:System.Windows.Forms.BindingSource.AddNew%2A> メソッドが呼び出された後、基になるリストに新しい項目が追加される前に発生します。  このイベントを処理することにより、<xref:System.Windows.Forms.BindingSource> クラスからクラスを派生せずにカスタム項目の作成動作を提供できます。  詳細については、「[方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-item-addition-with-the-windows-forms-bindingsource.md)」を参照してください。  
+  
+### トランザクション項目の作成  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、トランザクション項目が作成できるようにする <xref:System.ComponentModel.ICancelAddNew> インターフェイスを実装します。  <xref:System.Windows.Forms.BindingSource.AddNew%2A> を呼び出して新しい項目を仮に作成した後、次の方法で追加をコミットまたはロールバックできます。  
+  
+-   <xref:System.ComponentModel.ICancelAddNew.EndNew%2A> メソッドを使用して、保留中の追加を明示的にコミットします。  
+  
+-   挿入、削除、移動など、他のコレクション操作を実行すると、保留中の追加を暗黙的にコミットします。  
+  
+-   まだメソッドをコミットしていない場合に、<xref:System.ComponentModel.ICancelAddNew.CancelNew%2A> メソッドを使用して保留中の追加をロールバックします。  
+  
+### IEnumerable のサポート  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、<xref:System.Collections.IEnumerable> データ ソースへのコントロールのバインドを有効にします。  このコンポーネントを使用すると、<xref:System.Data.SqlClient.SqlDataReader?displayProperty=fullName> のようなデータ ソースにバインドできます。  
+  
+ <xref:System.Collections.IEnumerable> データ ソースが <xref:System.Windows.Forms.BindingSource> コンポーネントに割り当てられている場合、<xref:System.Windows.Forms.BindingSource> は <xref:System.ComponentModel.IBindingList> を作成し、そのリストに <xref:System.Collections.IEnumerable> データ ソースの内容を追加します。  
+  
+### デザイン時サポート  
+ 一部のオブジェクト型 \(たとえば、ファクトリ クラスで作成されたオブジェクトや Web サービスから返されたオブジェクトなど\) はデザイン時に作成できません。  コントロールをバインドできるオブジェクトがメモリに存在しない場合でも、デザイン時に、コントロールをこれらの型にバインドする必要が生じることがあります。  たとえば、<xref:System.Windows.Forms.DataGridView> コントロールの列ヘッダーにカスタム型のパブリック プロパティの名前のラベルを付けることが必要な場合もあります。  
+  
+ このようなシナリオをサポートするため、<xref:System.Windows.Forms.BindingSource> コンポーネントは <xref:System.Type> へのバインドをサポートしています。  <xref:System.Type> を <xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティに割り当てる場合、<xref:System.Windows.Forms.BindingSource> コンポーネントは <xref:System.Type> 項目の空の <xref:System.ComponentModel.BindingList%601> を作成します。  それ以降、<xref:System.Windows.Forms.BindingSource> コンポーネントにコントロールをバインドしようとすると、使用する型のプロパティまたはスキーマが既に存在することがデザイン時または実行時に警告されます。  詳細については、「[方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)」を参照してください。  
+  
+### 静的な ListBindingHelper メソッド  
+ <xref:System.Windows.Forms.BindingContext?displayProperty=fullName> 型、<xref:System.Windows.Forms.CurrencyManager?displayProperty=fullName> 型、および <xref:System.Windows.Forms.BindingSource> 型は、すべて共通のロジックを使用して `DataSource`\/`DataMember` のペアからリストを生成します。  また、この共通のロジックは、コントロールの作成者およびその他のサードパーティが使用できるように、次の `static` メソッド内で一般に公開されます。  
+  
+-   <xref:System.Windows.Forms.ListBindingHelper.GetListItemProperties%2A>  
+  
+-   <xref:System.Windows.Forms.ListBindingHelper.GetList%2A>.  
+  
+-   <xref:System.Windows.Forms.ListBindingHelper.GetListName%2A>  
+  
+-   <xref:System.Windows.Forms.ListBindingHelper.GetListItemType%2A>  
+  
+### IBindingListView インターフェイスを使用した並べ替えとフィルター処理  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは <xref:System.ComponentModel.IBindingListView> インターフェイスを実装します。このインターフェイスは、<xref:System.ComponentModel.IBindingList> インターフェイスを拡張します。  <xref:System.ComponentModel.IBindingList> には単一の列を並べ替える機能があり、<xref:System.ComponentModel.IBindingListView> には高度なソート機能とフィルタリング機能があります。  データ ソースでこれらのインターフェイスのいずれかを実装している場合、<xref:System.ComponentModel.IBindingListView> を使用すると、データ ソースの項目を並べ替えたり、フィルター処理を行うことができます。  <xref:System.Windows.Forms.BindingSource> コンポーネントは、これらのメンバーの参照実装を提供しません。  代わりに、基になるリストに呼び出しが転送されます。  
+  
+ 並べ替えとフィルター処理に使用するプロパティを次の表に示します。  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.Forms.BindingSource.Filter%2A> プロパティ|データ ソースが <xref:System.ComponentModel.IBindingListView> である場合は、表示する行のフィルター処理に使用する式を取得または設定します。|  
+|<xref:System.Windows.Forms.BindingSource.Sort%2A> プロパティ|データ ソースが <xref:System.ComponentModel.IBindingList> である場合は、並べ替えに使用する列名と並べ替え順序情報を取得または設定します。<br /><br /> または<br /><br /> データ ソースが <xref:System.ComponentModel.IBindingListView> であり、高度な並べ替えをサポートしている場合は、並べ替えに使用する複数の列名と並べ替え順序情報を取得します。|  
+  
+### BindingNavigator との統合  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して任意の Windows フォーム コントロールをデータ ソースにバインドすることもできます。ただし、<xref:System.Windows.Forms.BindingNavigator> コントロールは具体的には <xref:System.Windows.Forms.BindingSource> コンポーネントと共に使用するように設計されています。  <xref:System.Windows.Forms.BindingNavigator> コントロールは、<xref:System.Windows.Forms.BindingSource> コンポーネントの現在の項目を制御するためのユーザー インターフェイスを提供します。  既定では、<xref:System.Windows.Forms.BindingNavigator> コントロールには、<xref:System.Windows.Forms.BindingSource> コンポーネントのナビゲーション メソッドに対応するボタンが用意されています。  詳細については、「[方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する](../../../../docs/framework/winforms/controls/how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.BindingNavigator>   
+ [BindingSource コンポーネントの概要](../../../../docs/framework/winforms/controls/bindingsource-component-overview.md)   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)   
+ [方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる](../../../../docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bindingsource-component-overview.md b/docs/framework/winforms/controls/bindingsource-component-overview.md
new file mode 100644
index 00000000000..a4805194869
--- /dev/null
+++ b/docs/framework/winforms/controls/bindingsource-component-overview.md
@@ -0,0 +1,76 @@
+---
+title: "BindingSource コンポーネントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], BindingSource コンポーネントの概要"
+  - "コントロール [Windows フォーム], バインド (データに)"
+  - "データ バインド, BindingSource コンポーネント"
+  - "Windows フォーム, データ バインド"
+ms.assetid: be838caf-fcb0-4b68-827f-58b2c04b747f
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# BindingSource コンポーネントの概要
+<xref:System.Windows.Forms.BindingSource> コンポーネントは、基になるデータ ソースにコントロールをバインドするプロセスを簡略化するように設計されています。  <xref:System.Windows.Forms.BindingSource> コンポーネントは、他のコントロールのバインド先となるパイプおよびデータ ソースの両方の働きをします。  このコンポーネントは、フォームのデータ接続を抽象化し、基になるデータ リストにコマンドを渡します。  また、コンポーネントに直接データを追加することにより、コンポーネント自体がデータ ソースとして機能するようにすることができます。  
+  
+## 媒介手段としての BindingSource コンポーネント  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、フォーム上のコントロールの一部またはすべてのデータ ソースとして機能します。  Visual Studio では、<xref:System.Windows.Forms.BindingSource> は `DataBindings` プロパティを使用してコントロールにバインドします。このプロパティは **\[プロパティ\]** ウィンドウからアクセスできます。  「[方法 : デザイナーを使用して Windows フォーム コントロールを BindingSource コンポーネントにバインドする](../../../../docs/framework/winforms/controls/bind-wf-controls-with-the-bindingsource.md)」も参照してください。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは、単純なデータ ソース \(オブジェクトの 1 つのプロパティや、<xref:System.Collections.ArrayList> のような基本的なコレクションなど\) と複雑なデータ ソース \(データベース テーブルなど\) の両方にバインドできます。  <xref:System.Windows.Forms.BindingSource> コンポーネントは、バインディングおよび現在位置管理サービスを提供する媒介手段として機能します。  デザイン時や実行時には、<xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティと <xref:System.Windows.Forms.BindingSource.DataMember%2A> プロパティをそれぞれデータベースとテーブルに設定して <xref:System.Windows.Forms.BindingSource> コンポーネントを複雑なデータ ソースにバインドできます。  既存のデータ バインディング アーキテクチャにおける <xref:System.Windows.Forms.BindingSource> コンポーネントの位置づけを次の図に示します。  
+  
+ ![バインディング ソースとデータ バインディング アーキテクチャ](../../../../docs/framework/winforms/controls/media/net-bindsrcdatabindarch.gif "NET\_BindSrcDataBindArch")  
+  
+> [!NOTE]
+>  デザイン時には、特定のアクション \(データ ウィンドウから空白のフォームへのデータベース テーブルのドラッグなど\) によって <xref:System.Windows.Forms.BindingSource> コンポーネントが作成され、基になるデータ ソースにバインドされ、データ バインディングに対応したコントロールが追加されます。これらはすべて 1 つの操作によって実行されます。  「[Visual Studio でのデータへの Windows フォーム コントロールのバインド](../Topic/Bind%20Windows%20Forms%20controls%20to%20data%20in%20Visual%20Studio.md)」も参照してください。  
+  
+## データソースとしての BindingSource コンポーネント  
+ 最初にバインド先のリストを指定せずに <xref:System.Windows.Forms.BindingSource> コンポーネントに項目を追加し始めると、このコンポーネントはリスト形式のデータ ソースとして動作し、追加した項目を受け入れます。  
+  
+ また、<xref:System.Windows.Forms.BindingSource.AddingNew> イベントを使用して、カスタムの "AddNew" 機能を提供するコードを記述することもできます。このイベントは、<xref:System.Windows.Forms.BindingSource.AddNew%2A> メソッドが呼び出された時点で、リストに項目が追加される前に発生します。  詳細については、「[BindingSource コンポーネント アーキテクチャ](../../../../docs/framework/winforms/controls/bindingsource-component-architecture.md)」を参照してください。  
+  
+## ナビゲーション  
+ フォーム上でデータのナビゲーションを実行する必要のあるユーザーに対しては、<xref:System.Windows.Forms.BindingNavigator> コンポーネントが <xref:System.Windows.Forms.BindingSource> コンポーネントと連携することにより、データのナビゲーションと操作が提供されます。  詳細については、「[BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)」を参照してください。  
+  
+## データの操作  
+ <xref:System.Windows.Forms.BindingSource> は、すべてのバインディングの <xref:System.Windows.Forms.CurrencyManager> として動作するため、データ ソースに関する現在位置情報へのアクセスを提供します。  基になるデータへのアクセスおよび操作のために <xref:System.Windows.Forms.BindingSource> コンポーネントが提供するメンバーを次の表に示します。  
+  
+|メンバー|説明|  
+|----------|--------|  
+|<xref:System.Windows.Forms.BindingSource.Current%2A> プロパティ|データソースの現在の項目を取得します。|  
+|<xref:System.Windows.Forms.BindingSource.Position%2A> プロパティ|基になるリストでの現在の位置を取得または設定します。|  
+|<xref:System.Windows.Forms.BindingSource.List%2A> プロパティ|<xref:System.Windows.Forms.BindingSource.DataSource%2A> と <xref:System.Windows.Forms.BindingSource.DataMember%2A> の評価であるリストを取得します。  <xref:System.Windows.Forms.BindingSource.DataMember%2A> が設定されていないときは、<xref:System.Windows.Forms.BindingSource.DataSource%2A> によって指定されたリストを返します。|  
+|<xref:System.Windows.Forms.BindingSource.Insert%2A> メソッド|リスト内の指定されたインデックス位置に項目を挿入します。|  
+|<xref:System.Windows.Forms.BindingSource.RemoveCurrent%2A> メソッド|リストから現在の項目を削除します。|  
+|<xref:System.Windows.Forms.BindingSource.EndEdit%2A> メソッド|基になるデータ ソースに保留中の変更を適用します。|  
+|<xref:System.Windows.Forms.BindingSource.CancelEdit%2A> メソッド|現在の編集操作をキャンセルします。|  
+|<xref:System.Windows.Forms.BindingSource.AddNew%2A> メソッド|基になるリストに新しい項目を追加します。  データ ソースが <xref:System.ComponentModel.IBindingList> を実装しており、<xref:System.Windows.Forms.BindingSource.AddingNew> イベントから項目が返された場合は、その項目を追加します。  それ以外の場合、リストの <xref:System.ComponentModel.IBindingList.AddNew%2A> メソッドに要求が渡されます。  基になるリストが <xref:System.ComponentModel.IBindingList> でない場合は、既定のパブリック コンストラクターを使用して項目が自動的に作成されます。|  
+  
+## 並べ替えとフィルター処理  
+ 通常、一定の順序で並べられた、またはフィルター処理されたデータ ソースのビューを使用します。  <xref:System.Windows.Forms.BindingSource> コンポーネント データ ソースが提供するメンバーを次の表に示します。  
+  
+|メンバー|説明|  
+|----------|--------|  
+|<xref:System.Windows.Forms.BindingSource.Sort%2A> プロパティ|データ ソースが <xref:System.ComponentModel.IBindingList> である場合は、並べ替えに使用する列名と並べ替え順序情報を取得または設定します。  データ ソースが <xref:System.ComponentModel.IBindingListView> であり、高度な並べ替えをサポートしている場合は、並べ替えに使用する複数の列名と並べ替え順序情報を取得します。|  
+|<xref:System.Windows.Forms.BindingSource.Filter%2A> プロパティ|データ ソースが <xref:System.ComponentModel.IBindingListView> である場合は、表示する行のフィルター処理に使用する式を取得または設定します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.BindingNavigator>   
+ [BindingSource コンポーネント アーキテクチャ](../../../../docs/framework/winforms/controls/bindingsource-component-architecture.md)   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/bindingsource-component.md b/docs/framework/winforms/controls/bindingsource-component.md
new file mode 100644
index 00000000000..31f11752f1d
--- /dev/null
+++ b/docs/framework/winforms/controls/bindingsource-component.md
@@ -0,0 +1,80 @@
+---
+title: "BindingSource コンポーネント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム]"
+  - "データ バインド, Windows フォーム"
+  - "Windows フォーム, データ バインディング コントロール"
+ms.assetid: 3e2faf4c-f5b8-4fa6-9fbc-f59c37ec2fb9
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# BindingSource コンポーネント
+Encapsulates a data source for binding to controls.  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントは 2 つの目的で利用できます。  1 つ目は、フォームのコントロールをデータにバインドするときに、間接レイヤーの役割を果たします。  <xref:System.Windows.Forms.BindingSource> コンポーネントをデータ ソースにバインドして、フォームのコントロールを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドすることで、これを実行できます。  データとのそれ以上の対話 \(移動、並べ替え、フィルタ処理、更新など\) はすべて、<xref:System.Windows.Forms.BindingSource> コンポーネントを呼び出すことによって実行します。  
+  
+ 2 つ目は、<xref:System.Windows.Forms.BindingSource> コンポーネントが、厳密に型指定されたデータ ソースとして機能することができます。  <xref:System.Windows.Forms.BindingSource.Add%2A> メソッドを持つ <xref:System.Windows.Forms.BindingSource> コンポーネントに型を追加すると、その型の一覧が作成されます。  
+  
+## このセクションの内容  
+ [BindingSource コンポーネントの概要](../../../../docs/framework/winforms/controls/bindingsource-component-overview.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントの一般的な概念を導入し、データ ソースをコントロールにバインドすることができます。  
+  
+ [方法 : Windows フォーム コントロールを DBNull データベース値にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-windows-forms-controls-to-dbnull-database-values.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、<xref:System.DBNull> の値をデータ ソースから処理する方法を示しています。  
+  
+ [方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える\/フィルター処理する](../../../../docs/framework/winforms/controls/sort-and-filter-ado-net-data-with-wf-bindingsource-component.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、表示されるデータに並べ替えとフィルター処理を適用する方法を示します。  
+  
+ [方法 : Windows フォーム BindingSource を使用して Web サービスにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-to-a-web-service-using-the-windows-forms-bindingsource.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、Web サービスにバインドする方法を示します。  
+  
+ [方法 : データ バインドで発生するエラーと例外を処理する](../../../../docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、データ バインド操作で発生するエラーを適切に処理する方法を示します。  
+  
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、型にバインドする方法を示します。  
+  
+ [方法 : Windows フォーム コントロールをファクトリ オブジェクトにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-factory-object.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、ファクトリ オブジェクトやメソッドにバインドする方法を示します。  
+  
+ [方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-item-addition-with-the-windows-forms-bindingsource.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、新しい項目を作成し、データ ソースに追加する方法を示します。  
+  
+ [方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる](../../../../docs/framework/winforms/controls/how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、変更通知をサポートしないデータ ソースに対して変更通知イベントを発生させる方法を示します。  
+  
+ [方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる](../../../../docs/framework/winforms/controls/raise-change-notifications--bindingsource.md)  
+ <xref:System.Windows.Forms.BindingSource> コントロールを使用して <xref:System.ComponentModel.INotifyPropertyChanged> から継承する型を使用する方法を示します。  
+  
+ [方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる](../../../../docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、データ ソースの変更に応答する方法を示します。  
+  
+ [方法 : BindingSource コンポーネントを使用してフォーム間でバインド データを共有する](../../../../docs/framework/winforms/controls/how-to-share-bound-data-across-forms-using-the-bindingsource-component.md)  
+ <xref:System.Windows.Forms.BindingSource> を使用して、同じデータ ソースに複数のフォームをバインドする方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.BindingSource>  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントのリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.BindingNavigator>  
+ <xref:System.Windows.Forms.BindingNavigator> コントロールのリファレンス ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)  
+ Windows フォームのデータ バインディング アーキテクチャについて説明するトピックへのリンクが含まれます。  
+  
+ 「[Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/button-control-overview-windows-forms.md b/docs/framework/winforms/controls/button-control-overview-windows-forms.md
new file mode 100644
index 00000000000..bd2b13d5323
--- /dev/null
+++ b/docs/framework/winforms/controls/button-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "Button コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Button"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], Button コントロールの概要"
+  - "ボタン, ボタンの概要"
+ms.assetid: 255b291b-51a9-4a92-a1a4-2400cd82443f
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Button コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.Button> コントロールを使用すると、ユーザーはボタンをクリックしてアクションを実行できます。  このボタンをクリックすると、ボタンを実際に押して離したかのように表示されます。  ユーザーがボタンをクリックするたびに、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーが呼び出されます。  選択したアクションを実行するように、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーにコードを割り当てます。  
+  
+ ボタン上に表示されるテキストは、<xref:System.Windows.Forms.Control.Text%2A> プロパティに含まれています。  テキストの長さがボタンの幅を超える場合は、次の行に折り返されて表示されます。  ただし、コントロール内に全体の高さが収まらない場合は、テキストがクリッピングされます。  詳細については、「[方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)」を参照してください。  <xref:System.Windows.Forms.Control.Text%2A> プロパティには、アクセス キーを含めることができます。ユーザーは、Alt キーを押しながらアクセス キーを押して、コントロールを "クリック" するのと同じ操作ができます。  詳細については、「[方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)」を参照してください。  テキストの表示形式は、<xref:System.Windows.Forms.Control.Font%2A> プロパティと <xref:System.Windows.Forms.ButtonBase.TextAlign%2A> プロパティによって決まります。  
+  
+ <xref:System.Windows.Forms.ButtonBase.Image%2A> プロパティと <xref:System.Windows.Forms.ButtonBase.ImageList%2A> プロパティを使用すると、<xref:System.Windows.Forms.Button> コントロールでイメージを表示することもできます。  詳細については、「[方法 : Windows フォーム コントロールによって表示されるイメージを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Button>   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/button-control-windows-forms.md b/docs/framework/winforms/controls/button-control-windows-forms.md
new file mode 100644
index 00000000000..1d73da0869f
--- /dev/null
+++ b/docs/framework/winforms/controls/button-control-windows-forms.md
@@ -0,0 +1,53 @@
+---
+title: "Button コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム]"
+  - "ボタン"
+ms.assetid: d38bc40c-8040-4f19-9e88-2c665b0ab80b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Button コントロール (Windows フォーム)
+Windows フォームの `Button` コントロールを使用すると、ユーザーはそれをクリックしてアクションを実行できます。  `Button` コントロールには、テキストとイメージの両方を表示できます。  ボタンをクリックすると、ボタンを実際に押して離したかのように表示されます。  
+  
+## このセクションの内容  
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)  
+ このコントロールについて、および主な機能とプロパティについて説明します。  
+  
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)  
+ Windows フォームでのボタンの基本的な使用法について説明します。  
+  
+ [方法 : Windows フォームの Button コントロールを承認ボタンとして指定する](../../../../docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-accept-button.md)  
+ `Button` コントロールを承認ボタン \(既定のボタン\) として設定する方法を説明します。  
+  
+ [方法 : Windows フォームの Button コントロールをキャンセル ボタンとして指定する](../../../../docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-cancel-button.md)  
+ `Button` コントロールをキャンセル ボタンとして設定する方法を説明します。このボタンは、ユーザーが Esc キーを押すとクリックされます  
+  
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)  
+ ボタンを選択する方法の一覧を示します。  
+  
+ 「[方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md)」と「[方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md)」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Button> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ 「[ダイアログ ボックスへのユーザー入力](http://msdn.microsoft.com/ja-jp/63ad8645-6842-45e8-b215-73f778e29a55)」と「[方法 : ダイアログ ボックスを閉じて、ユーザー入力を保持する](http://msdn.microsoft.com/ja-jp/9e118fad-3bf4-4f70-a3de-a0cda2b0229d)」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..99defa8dbfd
--- /dev/null
+++ b/docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,176 @@
+---
+title: "Windows フォーム DataGridView コントロールでのセルのスタイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, スタイル"
+  - "データ グリッド, セル スタイル"
+  - "DataGridView コントロール [Windows フォーム], セル スタイル"
+ms.assetid: dbb75ed6-8804-4232-8382-f9920c2e380c
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# Windows フォーム DataGridView コントロールでのセルのスタイル
+<xref:System.Windows.Forms.DataGridView> コントロール内の各セルは、テキスト形式、背景色、前景色、フォントなど、独自のスタイルを持つことができます。  ただし、通常は複数のセルが特定のスタイル特性を共有します。  
+  
+ スタイルを共有するセルのグループとしては、特定の行または列のすべてのセル、特定の値を格納するすべてのセル、またはコントロール内のすべてのセル、などがあります。  これらのグループは重複するため、各セルは複数の場所からスタイル情報を取得できます。  たとえば、<xref:System.Windows.Forms.DataGridView> コントロールのすべてのセルに同じフォントを使用し、通貨列のセルだけに通貨書式を使用し、負数を持つ通貨セルだけに赤の前景色を使用するように指定することもできます。  
+  
+## DataGridViewCellStyle クラス  
+ <xref:System.Windows.Forms.DataGridViewCellStyle> クラスには、visual スタイルに関連する次のプロパティが含まれます。  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.BackColor%2A> および <xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.SelectionBackColor%2A> および <xref:System.Windows.Forms.DataGridViewCellStyle.SelectionForeColor%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.Font%2A>  
+  
+ また、このクラスには書式設定に関連する次のプロパティも含まれます。  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A> および <xref:System.Windows.Forms.DataGridViewCellStyle.FormatProvider%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.NullValue%2A> および <xref:System.Windows.Forms.DataGridViewCellStyle.DataSourceNullValue%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.Alignment%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle.Padding%2A>  
+  
+ これらのプロパティおよびその他のセル スタイル プロパティの詳細については、<xref:System.Windows.Forms.DataGridViewCellStyle> のリファレンス ドキュメント、および後の「参照」セクションに示したトピックを参照してください。  
+  
+## DataGridViewCellStyle オブジェクトの使用  
+ <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトは、<xref:System.Windows.Forms.DataGridView>、<xref:System.Windows.Forms.DataGridViewColumn>、<xref:System.Windows.Forms.DataGridViewRow>、<xref:System.Windows.Forms.DataGridViewCell> の各クラス、およびその派生クラスのさまざまなプロパティから取得できます。  これらのプロパティのいずれかが設定されていない場合、その値を取得すると、新しい <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトが作成されます。  独自に作成した <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトをインスタンス化して、これらのプロパティを割り当てることもできます。  
+  
+ 複数の <xref:System.Windows.Forms.DataGridView> 要素間で <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを共有すると、スタイル情報の不要な重複を避けることができます。  また、コントロール レベル、列レベル、および行レベルで設定されたスタイルは、各レベルからセル レベルまで、下方向にフィルター処理されるため、上位のレベルとは異なるスタイル プロパティだけを各レベルで設定することによってスタイルの重複を避けることもできます。  これについては、後の「スタイルの継承」セクションで詳しく説明します。  
+  
+ <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを取得または設定する主要なプロパティを次の表に示します。  
+  
+|プロパティ|Classes|Description|  
+|-----------|-------------|-----------------|  
+|`DefaultCellStyle`|<xref:System.Windows.Forms.DataGridView>、<xref:System.Windows.Forms.DataGridViewColumn>、<xref:System.Windows.Forms.DataGridViewRow>、および派生クラス|コントロール全体 \(ヘッダー セルを含む\)、列、または行内のすべてのセルが使用する既定のスタイルを取得または設定します。|  
+|<xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A>|<xref:System.Windows.Forms.DataGridView>|コントロール内のすべての行が使用する既定のセル スタイルを取得または設定します。  ヘッダー セルは含まれません。|  
+|<xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A>|<xref:System.Windows.Forms.DataGridView>|コントロール内の交互の行が使用する既定のセル スタイルを取得または設定します。  帳簿のような効果を出すために使用します。|  
+|<xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A>|<xref:System.Windows.Forms.DataGridView>|コントロールの行ヘッダーが使用する既定のセル スタイルを取得または設定します。  visual スタイルが有効な場合は、現在のテーマでオーバーライドされます。|  
+|<xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A>|<xref:System.Windows.Forms.DataGridView>|コントロールの列ヘッダーが使用する既定のセル スタイルを取得または設定します。  visual スタイルが有効な場合は、現在のテーマでオーバーライドされます。|  
+|<xref:System.Windows.Forms.DataGridViewCell.Style%2A>|<xref:System.Windows.Forms.DataGridViewCell> と派生クラス|セル レベルで指定されたスタイルを取得または設定します。  このスタイルは、上位レベルから継承したスタイルをオーバーライドします。|  
+|`InheritedStyle`|<xref:System.Windows.Forms.DataGridViewCell>、<xref:System.Windows.Forms.DataGridViewRow>、<xref:System.Windows.Forms.DataGridViewColumn>、および派生クラス|セル、行、または列に現在適用されているすべてのスタイルを取得します。上位レベルから継承したスタイルを含みます。|  
+  
+ 前述のように、スタイル プロパティがまだ設定されていない場合にスタイル プロパティの値を取得すると、新しい <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトのインスタンスが自動的に生成されます。  不要なオブジェクトが作成されないようにするため、行クラスや列クラスには、<xref:System.Windows.Forms.DataGridViewBand.DefaultCellStyle%2A> プロパティが設定されているかどうかを確認するためにチェックできる <xref:System.Windows.Forms.DataGridViewBand.HasDefaultCellStyle%2A> プロパティが用意されています。  同様に、セル クラスには、<xref:System.Windows.Forms.DataGridViewCell.Style%2A> プロパティが設定されているかどうかを示す <xref:System.Windows.Forms.DataGridViewCell.HasStyle%2A> プロパティがあります。  
+  
+ 各スタイル プロパティには、対応する <xref:System.Windows.Forms.DataGridView> コントロールの *PropertyName*`Changed` イベントがあります。  行、列、およびセルのプロパティの場合、イベント名は "`Row`"、"`Column`"、または "`Cell`" で始まります \(たとえば、<xref:System.Windows.Forms.DataGridView.RowDefaultCellStyleChanged>\)。  これらの各イベントは、対応するスタイル プロパティが異なる <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトに設定されているときに発生します。  これらのイベントは、スタイル プロパティから <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを取得してプロパティ値を変更したときには発生しません。  セル スタイル オブジェクト自体に対する変更に対応するには、<xref:System.Windows.Forms.DataGridView.CellStyleContentChanged> イベントを処理します。  
+  
+## スタイルの継承  
+ 各 <xref:System.Windows.Forms.DataGridViewCell> は、その <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> プロパティから外観を取得します。  このプロパティが返す <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトは、<xref:System.Windows.Forms.DataGridViewCellStyle> 型のプロパティの階層構造から値を継承します。  これらのプロパティを以下に示します。ヘッダー セル以外のセルの <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> が値を取得する順に記載します。  
+  
+1.  <xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName>  
+  
+2.  <xref:System.Windows.Forms.DataGridViewRow.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+3.  <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A?displayProperty=fullName> \(奇数のインデックス番号を持つ行のセルのみ\)  
+  
+4.  <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>  
+  
+5.  <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+6.  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+ 行および列のヘッダー セルの場合、<xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> プロパティには、指定した順序で、以下に示すソース プロパティの値が設定されます。  
+  
+1.  <xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName>  
+  
+2.  <xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A?displayProperty=fullName> または <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A?displayProperty=fullName>  
+  
+3.  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+ このプロセスを説明する図を次に示します。  
+  
+ ![DataGridViewCellStyle 型のプロパティ](../../../../docs/framework/winforms/controls/media/datagridviewcells1.png "DataGridViewCells1")  
+  
+ 特定の行および列が継承したスタイルにアクセスすることもできます。  列の <xref:System.Windows.Forms.DataGridViewColumn.InheritedStyle%2A> プロパティは、次のプロパティから値を継承します。  
+  
+1.  <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+2.  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+ 行の <xref:System.Windows.Forms.DataGridViewRow.InheritedStyle%2A> プロパティは、次のプロパティから値を継承します。  
+  
+1.  <xref:System.Windows.Forms.DataGridViewRow.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+2.  <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A?displayProperty=fullName> \(奇数のインデックス番号を持つ行のセルのみ\)  
+  
+3.  <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>  
+  
+4.  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>  
+  
+ `InheritedStyle` プロパティが返す <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトの各プロパティの場合、プロパティ値は、<xref:System.Windows.Forms.DataGridViewCellStyle> クラスの既定値以外の値に、対応するプロパティが設定された適切なリストの最初のセル スタイルから取得されます。  
+  
+ 例のセルの <xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A> プロパティ値が、そのセルを含む列から継承されるしくみを次の表に示します。  
+  
+|`DataGridViewCellStyle` 型のプロパティ|取得されるオブジェクトの `ForeColor` 値の例|  
+|-------------------------------------|----------------------------------|  
+|<xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName>|<xref:System.Drawing.Color.Empty?displayProperty=fullName>|  
+|<xref:System.Windows.Forms.DataGridViewRow.DefaultCellStyle%2A?displayProperty=fullName>|<xref:System.Drawing.Color.Red%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A?displayProperty=fullName>|<xref:System.Drawing.Color.Empty?displayProperty=fullName>|  
+|<xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>|<xref:System.Drawing.Color.Empty?displayProperty=fullName>|  
+|<xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A?displayProperty=fullName>|<xref:System.Drawing.Color.DarkBlue%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>|<xref:System.Drawing.Color.Black%2A?displayProperty=fullName>|  
+  
+ この場合、セルの行の <xref:System.Drawing.Color.Red%2A?displayProperty=fullName> 値はリストの最初の値 \(実際の値\) です。  この値が、セルの <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> の <xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A> プロパティ値になります。  
+  
+ さまざまな <xref:System.Windows.Forms.DataGridViewCellStyle> プロパティがさまざまな場所から値を継承できるしくみを次の図に示します。  
+  
+ ![DataGridView プロパティ &#45; 値の継承](../../../../docs/framework/winforms/controls/media/datagridviewcells2.png "DataGridViewCells2")  
+  
+ スタイルの継承を利用することにより、同じ情報を複数の場所で指定せずに、コントロール全体に適切なスタイルを指定できます。  
+  
+ ヘッダー セルは前述のとおりにスタイルを継承しますが、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A> プロパティおよび <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A> プロパティが返すオブジェクトは、<xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A> プロパティが返すオブジェクトのプロパティ値をオーバーライドする初期プロパティ値を持ちます。  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A> プロパティが返すオブジェクトに設定されたプロパティを行ヘッダーと列ヘッダーに適用するときは、<xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A> プロパティと <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A> プロパティが返すオブジェクトの対応するプロパティを、<xref:System.Windows.Forms.DataGridViewCellStyle> クラスに対して示された既定値に設定する必要があります。  
+  
+> [!NOTE]
+>  visual スタイルを有効にすると、行ヘッダーと列ヘッダー \(<xref:System.Windows.Forms.DataGridView.TopLeftHeaderCell%2A> を除く\) のスタイルは現在のテーマによって自動的に設定され、これらのプロパティで指定したすべてのスタイルはオーバーライドされます。  
+  
+ また、<xref:System.Windows.Forms.DataGridViewButtonColumn> 型、<xref:System.Windows.Forms.DataGridViewImageColumn> 型、および <xref:System.Windows.Forms.DataGridViewCheckBoxColumn> 型も、列の <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A> プロパティが返すオブジェクトのいくつかの値を初期化します。  詳細については、各型のリファレンス ドキュメントを参照してください。  
+  
+## 動的なスタイル設定  
+ 特定の値でセルのスタイルをカスタマイズするには、<xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName> イベントのハンドラーを実装します。  このイベントのハンドラーは、<xref:System.Windows.Forms.DataGridViewCellFormattingEventArgs> 型の引数を受け取ります。  このオブジェクトに含まれるプロパティを使用して、書式を設定するセルの値と <xref:System.Windows.Forms.DataGridView> コントロールにおけるセルの場所を決定します。  また、このオブジェクトには <xref:System.Windows.Forms.DataGridViewCellFormattingEventArgs.CellStyle%2A> プロパティも含まれます。このプロパティは、書式を設定するセルの <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> プロパティの値に初期化されます。  このセル スタイル プロパティを変更して、セルの値と場所に適したスタイル情報を指定できます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView.RowPrePaint> イベントと <xref:System.Windows.Forms.DataGridView.RowPostPaint> イベントもイベント データの <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを受け取りますが、その場合、オプジェクトは読み取り専用の行の <xref:System.Windows.Forms.DataGridViewRow.InheritedStyle%2A> プロパティのコピーです。変更しても、コントロールには反映されません。  
+  
+ <xref:System.Windows.Forms.DataGridView.CellMouseEnter?displayProperty=fullName> や <xref:System.Windows.Forms.DataGridView.CellMouseLeave> などのイベントに応答して、個々のセルのスタイルを動的に変更することもできます。  たとえば、<xref:System.Windows.Forms.DataGridView.CellMouseEnter> イベントのハンドラー内に \(セルの <xref:System.Windows.Forms.DataGridViewCell.Style%2A> プロパティから取得した\) セルの背景色の現在値を格納し、セル上にマウスが配置されたときにセルを強調表示する新しい色を設定できます。  その後、<xref:System.Windows.Forms.DataGridView.CellMouseLeave> イベントのハンドラー内で背景色を元の色に戻すことができます。  
+  
+> [!NOTE]
+>  特定のスタイル値が設定されているかどうかにかかわらず、セルの <xref:System.Windows.Forms.DataGridViewCell.Style%2A> プロパティに格納された値をキャッシュすることは重要です。  スタイル設定を一時的に置き換えた場合、元の "設定なし" の状態に戻すことによって、セルのスタイル設定を再度上位レベルから継承できます。  スタイルが継承されているかどうかにかかわらず、セルに対して有効になっている実際のスタイルを確認する必要があるときは、セルの <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A> プロパティを使用します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.InheritedStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewRow.InheritedStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.InheritedStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCell.InheritedStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCell.Style%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.CellStyleContentChanged?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowPrePaint?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowPostPaint?displayProperty=fullName>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md b/docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md
new file mode 100644
index 00000000000..b694f198470
--- /dev/null
+++ b/docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 変更 (DataGrid セル値を)"
+  - "DataGrid コントロール [Windows フォーム], データ バインド"
+  - "DataGrid コントロール [Windows フォーム], 動的に変更 (実行時に)"
+ms.assetid: 0c7a6d00-30de-416e-8223-0a81ddb4c1f8
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ デザイン時の機能を使用して Windows フォーム <xref:System.Windows.Forms.DataGrid> を作成した後で、グリッドの <xref:System.Data.DataSet> オブジェクトの要素を実行時に動的に変更できます。  これには、テーブルの個別の値を変更する場合と、<xref:System.Windows.Forms.DataGrid> コントロールに連結するデータ ソースを変更する場合があります。  個別の値の変更は、<xref:System.Windows.Forms.DataGrid> コントロールではなく、<xref:System.Data.DataSet> オブジェクトによって行います。  
+  
+### プログラムでデータを変更するには  
+  
+1.  データを変更する <xref:System.Data.DataSet> オブジェクトのテーブル、および変更する行とフィールドを指定し、セルを新しい値に設定します。  
+  
+    > [!NOTE]
+    >  <xref:System.Data.DataSet> の最初のテーブルまたはテーブルの最初の行を指定するには、0 を使用します。  
+  
+     次の例に `Button1` をクリックしてデータセットの最初のテーブルの最初の行の 2 番目のエントリを変更する方法を示します。  <xref:System.Data.DataSet> \(`ds`\) とテーブル \(`0` and`1`\) は既に作成済みです。  
+  
+    ```vb  
+    Protected Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+       ds.tables(0).rows(0)(1) = "NewEntry"  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       ds.Tables[0].Rows[0][1]="NewEntry";  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:   
+       void button1_Click(System::Object^ sender, System::EventArgs^ e)  
+       {  
+          dataSet1->Tables[0]->Rows[0][1] = "NewEntry";  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click +=  
+       gcnew System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+     実行時に、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用して、<xref:System.Windows.Forms.DataGrid> コントロールを異なるデータ ソースに連結できます。  たとえば、複数の [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] データ コントロールをそれぞれ異なるデータベースに接続できます。  
+  
+### プログラムでデータ ソースを変更するには  
+  
+1.  <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドに、連結するデータ ソースおよびテーブルの名前を設定します。  
+  
+     <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用して、データ ソースを Pubs データベースの Authors テーブルに接続されている [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] データ コントロール \(adoPubsAuthors\) に変更する例を次に示します。  
+  
+    ```vb  
+    Private Sub ResetSource()  
+       DataGrid1.SetDataBinding(adoPubsAuthors, "Authors")  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void ResetSource()  
+    {  
+       DataGrid1.SetDataBinding(adoPubsAuthors, "Authors");  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void ResetSource()  
+       {  
+          dataGrid1->SetDataBinding(adoPubsAuthors, "Authors");  
+       }  
+    ```  
+  
+## 参照  
+ [ADO.NET の DataSet](../../../../docs/framework/data/adonet/ado-net-datasets.md)   
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)   
+ [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)   
+ [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md b/docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md
new file mode 100644
index 00000000000..1a9fd7f2bc3
--- /dev/null
+++ b/docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 変更 (境界線スタイルを)"
+  - "データ グリッド, 変更 (グリッド線スタイルを)"
+  - "DataGridView コントロール [Windows フォーム], 境界線スタイル"
+  - "DataGridView コントロール [Windows フォーム], グリッド線スタイル"
+  - "グリッド線, 変更 (スタイルを)"
+ms.assetid: 2f413c7a-4025-4171-8e3a-66ef908ea583
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する
+<xref:System.Windows.Forms.DataGridView> コントロールを使用すると、コントロールの境界線とグリッド線の外観をカスタマイズしてユーザーの操作性を向上できます。  コントロール内のセルの境界線スタイルだけでなく、グリッド線の色やコントロールの境界線スタイルも変更できます。  通常のセル、行のヘッダー セル、および列のヘッダー セルに対して、異なるセル境界線スタイルを適用することもできます。  
+  
+> [!NOTE]
+>  グリッド線の色は、<xref:System.Windows.Forms.DataGridViewCellBorderStyle> 列挙体の <xref:System.Windows.Forms.DataGridViewCellBorderStyle> 値、<xref:System.Windows.Forms.DataGridViewCellBorderStyle> 値、および <xref:System.Windows.Forms.DataGridViewCellBorderStyle> 値、および <xref:System.Windows.Forms.DataGridViewHeaderBorderStyle> 列挙体の <xref:System.Windows.Forms.DataGridViewHeaderBorderStyle> 値だけで使用できます。  これらの列挙体のその他の値には、オペレーティング システムによって指定された色が使用されます。  また、<xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドにより Windows XP および Windows Server 2003 ファミリ上で visual スタイルが有効になっている場合は、<xref:System.Windows.Forms.DataGridView.GridColor%2A> プロパティ値は使用されません。  
+  
+### グリッド線の色をプログラムで変更するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.GridColor%2A> プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#031](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#031)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#031](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#031)]  
+  
+### DataGridView コントロール全体の境界線スタイルをプログラムで変更するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.BorderStyle%2A> プロパティを <xref:System.Windows.Forms.BorderStyle> 列挙値のいずれかに設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#032](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#032)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#032](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#032)]  
+  
+### DataGridView セルの境界線スタイルをプログラムで変更するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.CellBorderStyle%2A>、<xref:System.Windows.Forms.DataGridView.RowHeadersBorderStyle%2A>、および <xref:System.Windows.Forms.DataGridView.ColumnHeadersBorderStyle%2A> の各プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#033](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#033)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#033](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#033)]  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#030](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#030)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#030](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#030)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Windows.Forms?displayProperty=fullName> アセンブリ、および <xref:System.Drawing?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BorderStyle>   
+ <xref:System.Windows.Forms.DataGridView.BorderStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.CellBorderStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersBorderStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.GridColor%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowHeadersBorderStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCellBorderStyle>   
+ <xref:System.Windows.Forms.DataGridViewHeaderBorderStyle>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/change-the-order-of-columns-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/change-the-order-of-columns-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..453735c1cd9
--- /dev/null
+++ b/docs/framework/winforms/controls/change-the-order-of-columns-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 順序"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 列の順序"
+  - "Windows フォーム, 列"
+ms.assetid: 7fe52a98-75d6-448c-97a5-65ca2c568c1a
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する
+Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールをデータ ソースにバインドすると、自動的に生成される列の表示順序がデータ ソースによって指定されます。  この順序が好ましくない場合は、デザイナーを使用して列の順序を変更できます。  また、非バインド列をコントロールに追加して、それらの表示順序を変更することもできます。  列の順序をプログラムで変更する方法については、「[方法 : Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列の順序を変更するには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の編集\]** を選択します。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[選択された列\]** ボックスの右側にある上向きまたは下向きの矢印をクリックして、選択した列を目的の位置に移動します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/change-the-type-of-a-wf-datagridview-column-using-the-designer.md b/docs/framework/winforms/controls/change-the-type-of-a-wf-datagridview-column-using-the-designer.md
new file mode 100644
index 00000000000..a3f215f7778
--- /dev/null
+++ b/docs/framework/winforms/controls/change-the-type-of-a-wf-datagridview-column-using-the-designer.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView 列の種類を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 種類"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 変更 (列型を)"
+  - "Windows フォーム, 列"
+ms.assetid: 7f994d45-600d-4190-a187-35803214b40c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView 列の種類を変更する
+場合によっては、既に Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールに追加されている列の種類を変更する必要があります。  たとえば、コントロールをデータ ソースにバインドしたときに、自動的に生成される一部の列の種類を変更できます。  これは、表示するテーブルに、関連テーブル内の行への外部キーを含む列がある場合に便利です。  この場合、これらの外部キーを表示するテキスト ボックス列を、関連テーブルのより意味のある値を表示するコンボ ボックス列と置き換える必要があります。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列の種類を変更するには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の編集\]** を選択します。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[列のプロパティ\]** グリッド内で、`ColumnType` プロパティを新しい列の種類に設定します。  
+  
+    > [!NOTE]
+    >  `ColumnType` プロパティは、デザイン時のみのプロパティで、列の種類を表すクラスを示します。  これは列クラス内に定義される実際のプロパティではありません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..acc2e5e63cf
--- /dev/null
+++ b/docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "CheckBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "CheckBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, チェック ボックス"
+  - "チェック ボックス, チェック ボックスの概要"
+  - "CheckBox コントロール [Windows フォーム], CheckBox コントロールの概要"
+  - "データ バインド, チェック ボックス コントロール"
+  - "データ バインド コントロール, チェック ボックス"
+ms.assetid: 085a4e0b-9046-473f-b141-d0edddfb2ebb
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# CheckBox コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.CheckBox> コントロールでは、特定の条件がオンであるかオフであるかが示されます。  通常は、ユーザーが Yes\/No または True\/False を選択するために使用します。  ユーザーが複数の項目を選択できるように、複数のチェック ボックス コントロールをグループ化することもできます。  
+  
+ チェック ボックス コントロールは、ユーザーが選択した内容を表示するために使用されるという点で、オプション ボタン コントロールに似ています。  ただし、オプション ボタンの場合、グループ内で選択できるボタンは一度に 1 つだけです。  チェック ボックス コントロールの場合は、チェック ボックスをいくつでも選択できます。  
+  
+ 単純データ連結を使用すると、チェック ボックスをデータベース内の要素に関連付けることができます。  複数のチェック ボックスをグループ化するには、<xref:System.Windows.Forms.GroupBox> コントロールを使用します。  コントロールをグループ化すると、フォーム デザイナー上でまとめて移動できるため、外観を整理したり、ユーザー インターフェイスをデザインしたりするときに便利です。  詳細については、「[Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)」および「[GroupBox コントロール](../../../../docs/framework/winforms/controls/groupbox-control-windows-forms.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.CheckBox> コントロールには、<xref:System.Windows.Forms.CheckBox.Checked%2A> および <xref:System.Windows.Forms.CheckBox.CheckState%2A> という 2 つの重要なプロパティがあります。  <xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティは、`true` または `false` を返します。  <xref:System.Windows.Forms.CheckBox.CheckState%2A> プロパティは、<xref:System.Windows.Forms.CheckState> または <xref:System.Windows.Forms.CheckState> を返します。<xref:System.Windows.Forms.CheckBox.ThreeState%2A> プロパティが `true` に設定されている場合、<xref:System.Windows.Forms.CheckBox.CheckState%2A> も <xref:System.Windows.Forms.CheckState> を返すことがあります。  中間状態では、ボックスが淡色表示されてオプションを使用できないことが示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.CheckBox>   
+ [方法 : Windows フォームの CheckBox コントロールでオプションを設定する](../../../../docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md)   
+ [方法 : Windows フォーム CheckBox のクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md)   
+ [CheckBox コントロール](../../../../docs/framework/winforms/controls/checkbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/checkbox-control-windows-forms.md b/docs/framework/winforms/controls/checkbox-control-windows-forms.md
new file mode 100644
index 00000000000..e4bf91775c5
--- /dev/null
+++ b/docs/framework/winforms/controls/checkbox-control-windows-forms.md
@@ -0,0 +1,47 @@
+---
+title: "CheckBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック ボックス"
+  - "CheckBox コントロール [Windows フォーム]"
+  - "チェックされたリスト項目"
+  - "チェックされたリスト項目, Windows フォーム コントロール"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+ms.assetid: 0719d798-c307-40d3-9040-72a62679c227
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# CheckBox コントロール (Windows フォーム)
+Windows フォーム `CheckBox` コントロールは、特定の条件がオンかオフかを示します。  一般的に、はい\/いいえ、または True\/False の選択肢をユーザーに提示するために使用されます。  ユーザーが 1 つ以上選択可能な複数の選択肢を表示するために、チェック ボックス コントロールをグループの中で使用できます。  <xref:System.Windows.Forms.RadioButton> コントロールに似ていますが、任意の数のグループ化された `CheckBox` コントロールを選択することができます。  
+  
+## このセクションの内容  
+ [CheckBox コントロールの概要](../../../../docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md)  
+ このコントロールについて、および主な機能とプロパティについて説明します。  
+  
+ [方法 : Windows フォーム CheckBox のクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md)  
+ チェック ボックスを使用して、アプリケーションのアクションを決定する方法について説明します。  
+  
+ [方法 : Windows フォームの CheckBox コントロールでオプションを設定する](../../../../docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md)  
+ チェック ボックスを使用して、オブジェクトのプロパティなどのオプションを設定する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.CheckBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全なリストを、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..159ee34ba40
--- /dev/null
+++ b/docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "CheckedListBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "CheckedListBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック マーク"
+  - "CheckedListBox コントロール [Windows フォーム], CheckedListBox コントロールの概要"
+  - "リスト ボックス, リスト ボックスの概要"
+ms.assetid: e6cff3ce-e2ba-458e-851f-299e8e9c8abf
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# CheckedListBox コントロールの概要 (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.CheckedListBox> コントロールは、<xref:System.Windows.Forms.ListBox> コントロールを拡張したものです。  **CheckedListBox** コントロールでは、リスト ボックスで可能なほとんどの操作が実行でき、リストの項目の横にチェック マークを表示できます。  それ以外にこの 2 つのコントロールで異なる点は、チェックされたリスト ボックスは <xref:System.Windows.Forms.DrawMode?displayProperty=fullName> のみをサポートし、選択できる項目が 1 つまたは 0 となることです。  選択した項目は、チェック状態の項目とは異なり、フォーム上で強調表示されます。  
+  
+ チェックされたリスト ボックスには、**文字列コレクション エディター**を使用して設計時に項目を追加できます。また、<xref:System.Windows.Forms.CheckedListBox.Items%2A> プロパティを使用して、実行時にコレクションから動的に項目を追加することもできます。  詳細については、「[方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.CheckedListBox>   
+ <xref:System.Windows.Forms.CheckedListBox.Items%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ListControl.DataSource%2A?displayProperty=fullName>   
+ [ListBox コントロールの概要](../../../../docs/framework/winforms/controls/listbox-control-overview-windows-forms.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)   
+ [方法 : Windows フォーム CheckedListBox コントロールでオンになっている項目を判断する](../../../../docs/framework/winforms/controls/how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/checkedlistbox-control-windows-forms.md b/docs/framework/winforms/controls/checkedlistbox-control-windows-forms.md
new file mode 100644
index 00000000000..b05187e8a51
--- /dev/null
+++ b/docs/framework/winforms/controls/checkedlistbox-control-windows-forms.md
@@ -0,0 +1,51 @@
+---
+title: "CheckedListBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック マーク"
+  - "チェックされたリスト項目, Windows フォーム コントロール"
+  - "CheckedListBox コントロール [Windows フォーム]"
+  - "CheckedListBox コントロール [Windows フォーム], リファレンス"
+  - "リスト ボックス コントロール"
+  - "リスト ボックス"
+  - "リスト ボックス, 表示 (チェック マークを)"
+  - "リスト ボックス, Windows フォーム コントロール"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+ms.assetid: 2a525f72-0245-41d7-94e9-b9c971dc4484
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# CheckedListBox コントロール (Windows フォーム)
+Windows フォームの `CheckedListBox` コントロールは、<xref:System.Windows.Forms.ListBox> コントロールと同様に項目のリストを表示します。さらに、リスト内の各項目の横にチェック マークも表示できます。  
+  
+## このセクションの内容  
+ [CheckedListBox コントロールの概要](../../../../docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム CheckedListBox コントロールでオンになっている項目を判断する](../../../../docs/framework/winforms/controls/how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md)  
+ どの項目のチェック ボックスがオンにされているかを確認するためのリストの操作手順について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.CheckedListBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)  
+ リスト ボックス、コンボ ボックス、およびチェックされたリスト ボックスの機能の一覧を提供します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..dae44b27a4f
--- /dev/null
+++ b/docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md
@@ -0,0 +1,35 @@
+---
+title: "ColorDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ColorDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色のダイアログ ボックス, 色のダイアログ ボックスの概要"
+  - "ColorDialog コンポーネント, ColorDialog の概要"
+ms.assetid: 6dbdd8f0-f697-4728-bb09-7ea156f6d800
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ColorDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ColorDialog> コンポーネントは、定義済みダイアログ ボックスです。このダイアログ ボックスでは、パレットから色を選択したりパレットに色を追加したりできます。  このダイアログ ボックスは、他の Windows ベースのアプリケーションで表示される色を選択するためのダイアログ ボックスと同じです。  このコントロールは、独自のダイアログ ボックスを使用しない簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  
+  
+ ダイアログ ボックスで選択された色は、<xref:System.Windows.Forms.ColorDialog.Color%2A> プロパティに返されます。  <xref:System.Windows.Forms.ColorDialog.AllowFullOpen%2A> プロパティが `false` に設定されると、\[色の作成\] ボタンが無効になり、ユーザーが使用できる色はパレット内の定義済みの色に制限されます。  <xref:System.Windows.Forms.ColorDialog.SolidColorOnly%2A> プロパティが `true` に設定されると、ユーザーはディザー カラーを選択できなくなります。  ダイアログ ボックスを表示するには、コントロールの <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを呼び出す必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ColorDialog>   
+ [ColorDialog コンポーネント](../../../../docs/framework/winforms/controls/colordialog-component-windows-forms.md)   
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)   
+ [方法 : Windows フォーム ColorDialog コンポーネントの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/colordialog-component-windows-forms.md b/docs/framework/winforms/controls/colordialog-component-windows-forms.md
new file mode 100644
index 00000000000..92b6f331653
--- /dev/null
+++ b/docs/framework/winforms/controls/colordialog-component-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "ColorDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色のダイアログ ボックス"
+  - "ColorDialog コンポーネント"
+  - "色, ダイアログ ボックス"
+ms.assetid: 261793e0-8252-47c5-b76c-621857b8da44
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ColorDialog コンポーネント (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ColorDialog> コンポーネントは、定義済みダイアログ ボックスです。このダイアログ ボックスでは、パレットから色を選択したりパレットに色を追加したりできます。  このダイアログ ボックスは、他の Windows ベースのアプリケーションで表示される色を選択するためのダイアログ ボックスと同じです。  このコントロールは、独自のダイアログ ボックスを使用しない簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  
+  
+## このセクションの内容  
+ [ColorDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md)  
+ ユーザーがパレットから色を選択できる定義済みダイアログ ボックスを表示する、<xref:System.Windows.Forms.ColorDialog> コンポーネントの全般的な概念を説明します。  
+  
+ [方法 : Windows フォーム ColorDialog コンポーネントの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md)  
+ ユーザーが使用できる色、およびその他のプロパティを変更する方法について説明します。  
+  
+ [方法 : ColorDialog コンポーネントを使用してカラー パレットを表示する](../../../../docs/framework/winforms/controls/how-to-show-a-color-palette-with-the-colordialog-component.md)  
+ <xref:System.Windows.Forms.ColorDialog> コンポーネントのインスタンスを使用して実行時に色を選択する方法について説明します。  
+  
+## 関連項目  
+ [Windows フォームで使用できるコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [ColorDialog クラス](frlrfSystemWindowsFormsColorDialogClassTopic)  
+ <xref:System.Windows.Forms.ColorDialog> クラスとそのメンバーに関する参照情報を提供します。  
+  
+ [Windows フォームのダイアログ ボックスに必要なコード](vbtchEssentialCodeForWindowsFormsDialogBoxes)  
+ Windows フォームのダイアログ ボックス コントロールとコンポーネント、および、これらの基本機能を実行するために必要なコードについて説明します。  
+  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ アプリケーションまたはシステムとの標準的なやり取りを可能にする一連のコントロールを示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..5763d401cb6
--- /dev/null
+++ b/docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,85 @@
+---
+title: "Windows フォーム DataGridView コントロールの列フィル モード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, サイズの自動調整 (列を)"
+  - "データ グリッド, 列フィル モード"
+  - "DataGridView コントロール [Windows フォーム], 列フィル モード"
+ms.assetid: b4ef7411-ebf4-4e26-bb33-aecec90de80c
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォーム DataGridView コントロールの列フィル モード
+列フィル モードでは、<xref:System.Windows.Forms.DataGridView> コントロールの列は、コントロールの表示領域の幅を満たすように自動的にサイズ変更されます。  すべての列の幅を <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> プロパティの値以上にするために水平スクロール バーが必要な場合を除き、コントロールに水平スクロール バーは表示されません。  
+  
+ 各列のサイズ変更動作は、<xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A> プロパティによって異なります。  このプロパティの値は、列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティから継承されるか、または列の値が既定値の <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> である場合はコントロールの <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A> プロパティから継承されます。  
+  
+ 列ごとに異なるサイズ変更モードを使用できます。ただし、サイズ変更モードが <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> であるすべての列は、それ以外の列が使用していない表示領域を共有します。  この領域の幅は、フィル モードの列の間で、それぞれの <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティの値の比率に基づいて分割されます。  たとえば、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> の値が 100 の列と 200 の列がある場合、最初の列はもう 1 つの列の半分の幅になります。  
+  
+## フィル モードでのユーザーによるサイズ変更  
+ セルの内容に基づいてサイズが変更されるモードとは異なり、フィル モードでは、ユーザーは <xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A> プロパティの値が `true` の列のサイズを変更できます。  ユーザーが 1 つのフィル モード列のサイズを変更すると、サイズ変更した列より後のすべてのフィル モード列 \(<xref:System.Windows.Forms.Control.RightToLeft%2A> が `false` の場合は右側の列、それ以外の場合は左側の列\) のサイズも、表示に使用できる幅の変化とつりあうように変わります。  サイズ変更した列より後にフィル モード列がない場合は、コントロール内の他のすべてのフィル モード列のサイズが変更されます。  コントロール内に他のフィル モード列がない場合は、サイズ変更は無視されます。  フィル モードでない列のサイズを変更した場合は、コントロール内のすべてのフィル モード列のサイズが、変更とつりあうように変わります。  
+  
+ 1 つのフィル モード列のサイズを変更すると、それに合わせて変更されたすべての列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> の値が比率に応じて調整されます。  たとえば、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> 値が 100 である 4 つのフィル モード列のうち、2 番目の列の幅を元の幅の半分にすると、各フィル モード列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> 値はそれぞれ 100、50、125、125 になります。  フィル モードでない列のサイズを変更しても、フィル モード列のサイズは同じ比率を維持するように変更されるだけなので、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> 値は変わりません。  
+  
+## 内容に基づく FillWeight の調整  
+ フィル モード列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> の値は、<xref:System.Windows.Forms.DataGridView> の自動サイズ変更メソッドを使用して初期化できます。たとえば、<xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A> メソッドがあります。  このメソッドは、まず、列の内容を表示するのに必要な幅を計算します。  次に、計算した幅の比率に一致するように、すべてのフィル モード列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> の値がコントロールによって調整されます。  最後に、この新しい <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> の比率を使用して、コントロール内のすべての列が水平方向に使用可能な領域を満たすようにフィル モード列のサイズがコントロールによって変更されます。  
+  
+## 例  
+  
+### 説明  
+ <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A>、<xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A>、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A>、および <xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A> の各プロパティに適切な値を使用すると、さまざまなシナリオに応じて列のサイズ変更動作をカスタマイズできます。  
+  
+ 次のデモ コードでは、<xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A>、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A>、および <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> の各プロパティのさまざまな値をさまざまな列で試すことができます。  この例では、<xref:System.Windows.Forms.DataGridView> コントロールはそれ自体の <xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションにバインドしており、それぞれの列は <xref:System.Windows.Forms.DataGridViewColumn.HeaderText%2A>、<xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A>、<xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A>、<xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A>、および <xref:System.Windows.Forms.DataGridViewColumn.Width%2A> の各プロパティにバインドしています。  各列はコントロール内の行でも表されており、1 つの行で値を変更すると対応する列のプロパティも更新されるので、値の相互作用を確認できます。  
+  
+### コード  
+ [!code-csharp[System.Windows.Forms.DataGridViewFillColumnsDemo#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewFillColumnsDemo/CS/fillcolumns.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewFillColumnsDemo#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewFillColumnsDemo/vb/fillcolumns.vb#00)]  
+  
+### コメント  
+ このデモ アプリケーションは、次のようにして使用します。  
+  
+-   フォームのサイズを変更します。  <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティの値で示される比率が維持されたまま、列の幅が変わることを確認します。  
+  
+-   マウスで列の区分線をドラッグして、列のサイズを変更します。  <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> 値がどのように変わるかを確認します。  
+  
+-   1 つの列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> 値を変更してから、フォームのサイズをドラッグで変更します。  フォームをどれだけ小さくしても <xref:System.Windows.Forms.DataGridViewColumn.Width%2A> 値が <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> 値を下回らないことを確認します。  
+  
+-   すべての列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> 値を大きくして、その合計値がコントロールの幅を上回るようにします。  水平スクロール バーが表示されることを確認します。  
+  
+-   一部の列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> 値を変更します。  列またはフォームのサイズの変更によって何が起きるかを確認します。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ <xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode>   
+ <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Width%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.RightToLeft%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](../../../../docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..96566dd0f61
--- /dev/null
+++ b/docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,79 @@
+---
+title: "Windows フォーム DataGridView コントロール内の列の並べ替えモード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 並べ替えモード"
+  - "DataGridView コントロール [Windows フォーム], 並べ替えモード"
+ms.assetid: 43715887-2df9-4da7-bcf1-b9c7c842b2bf
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Windows フォーム DataGridView コントロール内の列の並べ替えモード
+<xref:System.Windows.Forms.DataGridView> 列には、3 つの並べ替えモードがあります。  各列の並べ替えモードは、列の <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティによって指定されます。このプロパティは、次の <xref:System.Windows.Forms.DataGridViewColumnSortMode> 列挙値のいずれかに設定できます。  
+  
+|`DataGridViewColumnSortMode` の値|Description|  
+|-------------------------------------|-----------------|  
+|<xref:System.Windows.Forms.DataGridViewColumnSortMode>|テキスト ボックス列の既定値です。  列ヘッダーを選択用として使用する場合を除き、ヘッダーをクリックすると、この列で <xref:System.Windows.Forms.DataGridView> が自動的に並べ替えられ、並べ替え順序を示すグリフが表示されます。|  
+|<xref:System.Windows.Forms.DataGridViewColumnSortMode>|非テキスト ボックス列の既定値です。  この列は、プログラムによって並べ替えることができますが、並べ替えを目的としていないため、並べ替えグリフの表示領域は予約されません。|  
+|<xref:System.Windows.Forms.DataGridViewColumnSortMode>|この列はプログラムによって並べ替えることができ、並べ替えグリフの表示領域が予約されます。|  
+  
+ 意味のある順序で並べることができる値が列に含まれている場合は、既定で <xref:System.Windows.Forms.DataGridViewColumnSortMode> に設定される列の並べ替えモードを変更できます。  たとえば、項目の状態を表す数値がデータベース列に含まれている場合、イメージ列をデータベース列に関連付けることによって、これらの数値を対応するアイコンとして表示できます。  次に、<xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName> イベントのハンドラーで、数値セルの値をイメージ表示値に変更できます。  この場合、<xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティに<xref:System.Windows.Forms.DataGridViewColumnSortMode> を設定すると、ユーザーによる列の並べ替えが可能になります。  自動並べ替えにより、ユーザーは、数値に対応する状態が自然なシーケンスでない場合でも、同じ状態の項目をグループ化できます。  自動並べ替えは、チェック ボックス列の場合にも同じ状態の項目をグループ化するのに役立ちます。  
+  
+ <xref:System.Windows.Forms.DataGridView> は、<xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> の設定と無関係に、任意の列または複数の列の値を基準にして、プログラムによって並べ替えることができます。  プログラムによる並べ替えは、独自の並べ替え用ユーザー インターフェイス \(UI\) を提供したり、カスタムの並べ替え機能を実装したりする場合に役立ちます。  独自の並べ替え UI の提供は、たとえば、<xref:System.Windows.Forms.DataGridView> 選択モードを設定して列ヘッダーの選択を有効にする場合に役立ちます。  この場合、列ヘッダーは並べ替えで使用できませんが、適切な並べ替えグリフをヘッダーに表示して、<xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティに <xref:System.Windows.Forms.DataGridViewColumnSortMode> を設定できます。  
+  
+ プログラムによる並べ替えモードに設定された列には、並べ替えグリフが自動的には表示されません。  このような列では、<xref:System.Windows.Forms.DataGridViewColumnHeaderCell.SortGlyphDirection%2A?displayProperty=fullName> プロパティを設定して、グリフを独自に表示する必要があります。  これは、カスタムの並べ替えを柔軟にする場合に必要です。  たとえば、複数の列で <xref:System.Windows.Forms.DataGridView> を並べ替える場合、複数の並べ替えグリフを表示したり、1 つも表示しないようにしたりする必要があります。  
+  
+ <xref:System.Windows.Forms.DataGridView> は、任意の列を基準にプログラムによって並べ替えることができますが、ボタン列などの一部の列には、意味のある順序で並べることのできる値を格納できないことがあります。  このような列では、<xref:System.Windows.Forms.DataGridViewColumnSortMode> の <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティ設定により、列が並べ替えで使用されないため、並べ替えグリフの表示領域をヘッダーで予約する必要がないことが示されています。  
+  
+ <xref:System.Windows.Forms.DataGridView> を並べ替えるときは、<xref:System.Windows.Forms.DataGridView.SortedColumn%2A> プロパティと <xref:System.Windows.Forms.DataGridView.SortOrder%2A> プロパティの値をチェックにして、並べ替え列と並べ替え順序を共に確認できます。  これらの値は、カスタムの並べ替え操作を実行した後には意味がなくなります。  カスタムの並べ替えの詳細については、後記の「カスタムの並べ替え」を参照してください。  
+  
+ バインド列と非バインド列の両方を含む <xref:System.Windows.Forms.DataGridView> コントロールを並べ替えるときは、非バインド列の値を自動的に保持できません。  これらの値を保持するには、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティに `true` を設定し、<xref:System.Windows.Forms.DataGridView.CellValueNeeded> イベントと <xref:System.Windows.Forms.DataGridView.CellValuePushed> イベントを処理して、仮想モードを実装する必要があります。  詳細については、「[方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する](../../../../docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md)」を参照してください。  バインド モードでの非バインド列による並べ替えはサポートされません。  
+  
+## プログラムによる並べ替え  
+ <xref:System.Windows.Forms.DataGridView> をプログラムによって並べ替えるには、<xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドを呼び出します。  
+  
+ <xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(DataGridViewColumn,ListSortDirection)` オーバーロードでは、パラメーターとして <xref:System.Windows.Forms.DataGridViewColumn> 列挙値と <xref:System.ComponentModel.ListSortDirection> 列挙値を受け取ります。  このオーバーロードは、意味のある順序で並べることができる値を含んでいても、自動並べ替えを設定するのが望ましくない列で並べ替える場合に役立ちます。  このオーバーロードを呼び出し、<xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティ値が <xref:System.Windows.Forms.DataGridViewColumnSortMode?displayProperty=fullName> の列に渡すと、<xref:System.Windows.Forms.DataGridView.SortedColumn%2A> プロパティと <xref:System.Windows.Forms.DataGridView.SortOrder%2A> プロパティが自動的に設定され、適切な並べ替えグリフが列ヘッダーに表示されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティを設定して、<xref:System.Windows.Forms.DataGridView> コントロールを外部データ ソースにバインドした場合、`Sort(DataGridViewColumn,ListSortDirection)` メソッド オーバーロードは、非バインド列に対して使用できません。  また、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティが `true` の場合、このオーバーロードは、バインド列に対してのみ呼び出すことができます。  列がデータ バインドかどうかを確認するには、<xref:System.Windows.Forms.DataGridViewColumn.IsDataBound%2A> プロパティ値を調べます。  バインド モードでの非バインド列の並べ替えはサポートされません。  
+  
+## カスタムの並べ替え  
+ <xref:System.Windows.Forms.DataGridView> をカスタマイズするには、<xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(IComparer)` オーバーロードを使用するか、<xref:System.Windows.Forms.DataGridView.SortCompare> イベントを処理します。  
+  
+ `Sort(IComparer)` メソッド オーバーロードでは、<xref:System.Collections.IComparer> インターフェイスを実装するクラスのインスタンスをパラメーターとして受け取ります。  このオーバーロードが役立つのは、たとえば、列の値が自然な並べ替え順序を持たない場合や自然な並べ替え順序が不適切な場合など、カスタムな並べ替えを実現する場合です。  この場合、自動並べ替えは使用できませんが、ユーザーが列ヘッダーをクリックして並べ替えることができます。  列ヘッダーを選択用として使用しない場合は、このオーバーロードを <xref:System.Windows.Forms.DataGridView.ColumnHeaderMouseClick> イベントのハンドラーで呼び出すことができます。  
+  
+> [!NOTE]
+>  `Sort(IComparer)` メソッド オーバーロードは、<xref:System.Windows.Forms.DataGridView> コントロールが外部データ ソースにバインドされておらず、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティ値が `false` のときにのみ使用できます。  外部データ ソースにバインドされた列の並べ替えをカスタマイズするには、データ ソースによって提供される並べ替え操作を使用する必要があります。  仮想モードでは、非バインド列に対して独自の並べ替え操作を実行できるようにする必要があります。  
+  
+ `Sort(IComparer)` メソッド オーバーロードを使用するには、<xref:System.Collections.IComparer> インターフェイスを実装する独自のクラスを作成する必要があります。  このインターフェイスでは、クラスで <xref:System.Collections.IComparer.Compare%2A?displayProperty=fullName> メソッドを実装する必要があります。このメソッドには、`Sort(IComparer)` メソッド オーバーロードが呼び出されたときに、<xref:System.Windows.Forms.DataGridView> から <xref:System.Windows.Forms.DataGridViewRow> オブジェクトが入力として渡されます。  これにより、任意の列の値を基にして適切な行の順序を計算できます。  
+  
+ `Sort(IComparer)` メソッド オーバーロードは、<xref:System.Windows.Forms.DataGridView.SortedColumn%2A> プロパティと <xref:System.Windows.Forms.DataGridView.SortOrder%2A> プロパティを設定しないため、並べ替えグリフが表示されるように常に <xref:System.Windows.Forms.DataGridViewColumnHeaderCell.SortGlyphDirection%2A?displayProperty=fullName> プロパティを設定する必要があります。  
+  
+ `Sort(IComparer)` メソッド オーバーロードを使用する代わりに、<xref:System.Windows.Forms.DataGridView.SortCompare> イベントのハンドラーを実装して、カスタムの並べ替えを可能にすることもできます。  このイベントは、自動並べ替えが設定された列のヘッダーをユーザーがクリックしたり、<xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(DataGridViewColumn,ListSortDirection)` オーバーロードを呼び出したりすると発生します。  このイベントは、コントロール内の行の各ペアに対して発生するため、行の適切な順序を計算できます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView.SortCompare> イベントは、<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティが設定されている場合や、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティ値が `true` の場合には発生しません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.Sort%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.SortedColumn%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.SortOrder%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumnHeaderCell.SortGlyphDirection%2A?displayProperty=fullName>   
+ [Windows フォームの DataGridView コントロールでのデータの並べ替え](../../../../docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する](../../../../docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..b4b448b21c9
--- /dev/null
+++ b/docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,104 @@
+---
+title: "Windows フォーム DataGridView コントロールの列型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 種類"
+  - "データ グリッド, 列"
+  - "DataGridView コントロール [Windows フォーム], 列の型"
+ms.assetid: f0a0a9f1-8757-4bfd-891f-d7d12870dbed
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Windows フォーム DataGridView コントロールの列型
+<xref:System.Windows.Forms.DataGridView> コントロールでは、情報を表示し、ユーザーが情報を変更したり追加したりできるようにさまざまな列型を使用します。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールをバインドし、<xref:System.Windows.Forms.DataGridView.AutoGenerateColumns%2A> プロパティを `true` に設定すると、バインドしたデータ ソースに含まれるデータ型に見合った既定の列型を使用して、列が自動的に生成されます。  
+  
+ また、任意の列クラスのインスタンスを独自に作成し、<xref:System.Windows.Forms.DataGridView.Columns%2A> プロパティによって返されたコレクションに追加することもできます。  作成したこれらのインスタンスは、非バインド列として使用することも、手動でバインドすることもできます。  手動バインド列は、たとえば、自動生成されたある型の列を、別の型の列に置き換える場合に便利です。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールで使用できる列クラスの一覧を次の表に示します。  
+  
+|Class|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.DataGridViewTextBoxColumn>|テキスト ベースの値で使用されます。  数値や文字列にバインドすると自動的に生成されます。|  
+|<xref:System.Windows.Forms.DataGridViewCheckBoxColumn>|<xref:System.Boolean> 値と <xref:System.Windows.Forms.CheckState> 値で使用されます。  これらの型の値にバインドすると自動的に生成されます。|  
+|<xref:System.Windows.Forms.DataGridViewImageColumn>|イメージの表示に使用されます。  バイト配列、<xref:System.Drawing.Image> オブジェクト、または <xref:System.Drawing.Icon> オブジェクトにバインドすると自動的に生成されます。|  
+|<xref:System.Windows.Forms.DataGridViewButtonColumn>|セルにボタンを表示するために使用されます。  バインド時に自動的に生成されません。  通常、非バインド列として使用されます。|  
+|<xref:System.Windows.Forms.DataGridViewComboBoxColumn>|セルにドロップダウン リストを表示するために使用されます。  バインド時に自動的に生成されません。  通常、手動でデータ バインドされます。|  
+|<xref:System.Windows.Forms.DataGridViewLinkColumn>|セルにリンクを表示するために使用されます。  バインド時に自動的に生成されません。  通常、手動でデータ バインドされます。|  
+|カスタム列型|<xref:System.Windows.Forms.DataGridViewColumn> クラスやその派生クラスを継承して独自の列クラスを作成すると、独自の外観や動作、またはホストされるコントロールを提供できます。  詳細については、「[方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](../../../../docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)」を参照してください。|  
+  
+ これらの列型について、以下のセクションで詳しく説明します。  
+  
+## DataGridViewTextBoxColumn  
+ <xref:System.Windows.Forms.DataGridViewTextBoxColumn> は、数値や文字列などのテキスト ベースの値で使用する汎用の列型です。  編集モードでは、<xref:System.Windows.Forms.TextBox> コントロールがアクティブなセルに表示されるので、ユーザーはセル値を変更できます。  
+  
+ セル値は、表示用の文字列に自動的に変換されます。  ユーザーが入力または変更した値は自動的に解析され、適切なデータ型のセル値が生成されます。  この変換は、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントと <xref:System.Windows.Forms.DataGridView.CellParsing> イベントを処理することでカスタマイズできます。  
+  
+ 列のセル値のデータ型は、列の <xref:System.Windows.Forms.DataGridViewColumn.ValueType%2A> プロパティで指定されます。  
+  
+## DataGridViewCheckBoxColumn  
+ <xref:System.Windows.Forms.DataGridViewCheckBoxColumn> は、<xref:System.Boolean> 値と <xref:System.Windows.Forms.CheckState> 値で使用されます。  <xref:System.Boolean> 値は、<xref:System.Windows.Forms.DataGridViewCheckBoxColumn.ThreeState%2A> プロパティの値に応じて、2 ステートまたは 3 ステート チェック ボックスとして表示されます。  列が <xref:System.Windows.Forms.CheckState> 値にバインドされると、<xref:System.Windows.Forms.DataGridViewCheckBoxColumn.ThreeState%2A> プロパティ値は既定で `true` になります。  
+  
+ 通常、チェック ボックス セル値は、他のデータと同様にストレージ用として、または一括操作を実行するために使用されます。  ユーザーがチェック ボックス セルをクリックしたときに直ちに応答する場合は、<xref:System.Windows.Forms.DataGridView.CellClick> イベントを処理しますが、このイベントはセル値が更新される前に発生します。  クリック時に新しい値が必要な場合は、現在の値を基に期待される値を計算するという方法が考えられます。  また別の方法として、変更を直ちにコミットし、<xref:System.Windows.Forms.DataGridView.CellValueChanged> イベントを処理してその変更に応答することも考えられます。  セルがクリックされたときに変更をコミットするには、<xref:System.Windows.Forms.DataGridView.CurrentCellDirtyStateChanged> イベントを処理する必要があります。  このハンドラーでは、現在のセルがチェック ボックス セルの場合、<xref:System.Windows.Forms.DataGridView.CommitEdit%2A> メソッドを呼び出し、<xref:System.Windows.Forms.DataGridViewDataErrorContexts> 値を渡します。  
+  
+## DataGridViewImageColumn  
+ <xref:System.Windows.Forms.DataGridViewImageColumn> は、イメージの表示に使用されます。  イメージ列は、データ ソースから自動的に設定でき、非バインド列の場合は手動で設定できます。また <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントのハンドラーで動的に設定することもできます。  
+  
+ イメージ列をデータ ソースから自動的に設定する場合は、<xref:System.Drawing.Image> クラスでサポートされるすべての形式と、Microsoft® Access や Northwind サンプル データベースで使用される OLE ピクチャ形式を含む各種イメージ形式のバイト配列を使用できます。  
+  
+ イメージ列の手動設定は、<xref:System.Windows.Forms.DataGridViewButtonColumn> の機能を独自の外観で提供する場合に役立ちます。  <xref:System.Windows.Forms.DataGridView.CellClick?displayProperty=fullName> イベントを処理することにより、イメージ セル内のクリックに応答できます。  
+  
+ <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントのハンドラーでのイメージ列のセルの設定は、計算値やイメージ形式以外の値にイメージを提供する場合に役立ちます。  たとえば、"Risk" 列には、アイコンとして表示する `"high"`、`"middle"`、`"low"` などの文字列型の値を設定できます。  また、"Image" 列には、イメージのバイナリ コンテンツではなく、読み込む必要があるイメージの場所を格納できます。  
+  
+## DataGridViewButtonColumn  
+ <xref:System.Windows.Forms.DataGridViewButtonColumn> を使用すると、ボタンを含むセルの列を表示できます。  これは、発注を行ったり別個のウィンドウに子レコードを表示したりという操作を、ユーザーが特定のレコードで簡単に実行できるようにする場合に便利です。  
+  
+ ボタン列は、<xref:System.Windows.Forms.DataGridView> コントロールをデータ バインディングしたときに自動的に生成されるわけではありません。  ボタン列を使用するには、ボタン列を手動で作成し、<xref:System.Windows.Forms.DataGridView.Columns%2A?displayProperty=fullName> プロパティによって返されたコレクションに追加する必要があります。  
+  
+ ボタン セル内のユーザー クリックに応答するには、<xref:System.Windows.Forms.DataGridView.CellClick?displayProperty=fullName> イベントを処理します。  
+  
+## DataGridViewComboBoxColumn  
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn> を使用すると、ドロップダウン リスト ボックスを含むセルの列を表示できます。  これは、Northwind サンプル データベースの Products テーブルの Category 列など、特定の値しか入力できないフィールドでのデータ入力に便利です。  
+  
+ すべてのセルで共通に使用するドロップダウン リストは、<xref:System.Windows.Forms.ComboBox> ドロップダウン リストの場合と同様に、<xref:System.Windows.Forms.DataGridViewComboBoxColumn.Items%2A> プロパティによって返されたコレクションを通じて手動で設定することも、<xref:System.Windows.Forms.DataGridViewComboBoxColumn.DataSource%2A> プロパティ、<xref:System.Windows.Forms.DataGridViewComboBoxColumn.DisplayMember%2A> プロパティ、および <xref:System.Windows.Forms.DataGridViewComboBoxColumn.ValueMember%2A> プロパティを通じてデータ ソースにバインドして設定することもできます。  詳細については、「[ComboBox コントロール](../../../../docs/framework/winforms/controls/combobox-control-windows-forms.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールによって使用されるデータ ソースに実際のセル値をバインドするには、<xref:System.Windows.Forms.DataGridViewComboBoxColumn?displayProperty=fullName> の <xref:System.Windows.Forms.DataGridViewColumn.DataPropertyName%2A> プロパティを設定します。  
+  
+ コンボ ボックス列は、<xref:System.Windows.Forms.DataGridView> コントロールをデータ バインディングしたときに自動的に生成されるわけではありません。  コンボ ボックス列を使用するには、コンボ ボックス列を手動で作成し、<xref:System.Windows.Forms.DataGridView.Columns%2A> プロパティによって返されたコレクションに追加する必要があります。  
+  
+## DataGridViewLinkColumn  
+ <xref:System.Windows.Forms.DataGridViewLinkColumn> を使用すると、ハイパーリンクを含むセルの列を表示できます。  これは、データ ソース内の URL 値を表示するのに便利です。またボタン列の代わりに使用して、子レコードを表示するウィンドウを開くなど、特別な動作を提供することもできます。  
+  
+ リンク列は、<xref:System.Windows.Forms.DataGridView> コントロールをデータ バインディングしたときに自動的に生成されるわけではありません。  リンク列を使用するには、リンク列を手動で作成し、<xref:System.Windows.Forms.DataGridView.Columns%2A> プロパティによって返されたコレクションに追加する必要があります。  
+  
+ ユーザーによるリンクのクリックに応答するには、<xref:System.Windows.Forms.DataGridView.CellContentClick> イベントを処理します。  このイベントは、ユーザーがセル内の場所をクリックしたときに発生する <xref:System.Windows.Forms.DataGridView.CellClick> イベントや <xref:System.Windows.Forms.DataGridView.CellMouseClick> イベントとは別です。  
+  
+ <xref:System.Windows.Forms.DataGridViewLinkColumn> クラスには、クリックの前後およびクリック時のリンクの外観を変更するプロパティが用意されています。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ <xref:System.Windows.Forms.DataGridViewButtonColumn>   
+ <xref:System.Windows.Forms.DataGridViewCheckBoxColumn>   
+ <xref:System.Windows.Forms.DataGridViewComboBoxColumn>   
+ <xref:System.Windows.Forms.DataGridViewImageColumn>   
+ <xref:System.Windows.Forms.DataGridViewTextBoxColumn>   
+ <xref:System.Windows.Forms.DataGridViewLinkColumn>   
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する](../../../../docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する](../../../../docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/combobox-control-overview-windows-forms.md b/docs/framework/winforms/controls/combobox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..3f7508843c4
--- /dev/null
+++ b/docs/framework/winforms/controls/combobox-control-overview-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "ComboBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ComboBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンボ ボックス, コンボ ボックスの概要"
+  - "ComboBox コントロール [Windows フォーム], ComboBox コントロールの概要"
+  - "ドロップダウン リスト, ComboBox コントロール"
+  - "ドロップダウン リスト, Windows フォーム"
+ms.assetid: a58b393f-a614-45d1-8961-857a024b5acd
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ComboBox コントロールの概要 (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.ComboBox> コントロールを使用すると、ドロップダウン コンボ ボックスのデータを表示できます。  既定では、<xref:System.Windows.Forms.ComboBox> コントロールは 2 つの部分に分かれています。上の部分は、リスト項目を入力できるテキスト ボックスです。  下の部分は、項目のリストが表示されるリスト ボックスであり、このボックスから 1 つの項目を選択できます。  その他のスタイルのコンボ ボックスの詳細については、「[ListBox の代わりに Windows フォーム ComboBox を使用する場合](../../../../docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> プロパティは、選択したリスト項目に対応する整数値を返します。  コードの <xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> 値を変更することによって、選択した項目をプログラムで変更できます。リスト内の対応する項目が、コンボ ボックス内のテキスト ボックスに表示されます。  選択項目がない場合、<xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> 値は \-1 となります。  リストの最初の項目を選択した場合、<xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> 値は 0 となります。  <xref:System.Windows.Forms.ComboBox.SelectedItem%2A> プロパティは <xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> に似ていますが、項目自体 \(通常は文字列値\) を返す点が異なります。  <xref:System.Windows.Forms.ComboBox.ObjectCollection.Count%2A> プロパティは、リスト内の項目数を表します。<xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> はゼロから始まるため、<xref:System.Windows.Forms.ComboBox.ObjectCollection.Count%2A> プロパティの値は、<xref:System.Windows.Forms.ComboBox.SelectedIndex%2A> の最大値よりも常に 1 大きくなります。  
+  
+ <xref:System.Windows.Forms.ComboBox> コントロールの項目を追加または削除するには、<xref:System.Windows.Forms.ComboBox.ObjectCollection.Add%2A> メソッド、<xref:System.Windows.Forms.ComboBox.ObjectCollection.Insert%2A> メソッド、<xref:System.Windows.Forms.ComboBox.ObjectCollection.Clear%2A> メソッド、または <xref:System.Windows.Forms.ComboBox.ObjectCollection.Remove%2A> メソッドを使用します。  デザイナーの <xref:System.Windows.Forms.ComboBox.Items%2A> プロパティを使用して、リストに項目を追加することもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ [ListBox コントロールの概要](../../../../docs/framework/winforms/controls/listbox-control-overview-windows-forms.md)   
+ [ListBox の代わりに Windows フォーム ComboBox を使用する場合](../../../../docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)   
+ [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](../../../../docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールの特定の項目にアクセスする](../../../../docs/framework/winforms/controls/access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md)   
+ [方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする ](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する](../../../../docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/combobox-control-windows-forms.md b/docs/framework/winforms/controls/combobox-control-windows-forms.md
new file mode 100644
index 00000000000..189259dac56
--- /dev/null
+++ b/docs/framework/winforms/controls/combobox-control-windows-forms.md
@@ -0,0 +1,48 @@
+---
+title: "ComboBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンボ ボックス"
+  - "コンボ ボックス, Windows フォーム コントロール"
+  - "ComboBox コントロール [Windows フォーム]"
+  - "ドロップダウン リスト, ComboBox コントロール"
+  - "ドロップダウン リスト, Windows フォーム"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+ms.assetid: 86a1bbc3-0469-4290-91c5-99ff61b739ff
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ComboBox コントロール (Windows フォーム)
+Windows フォーム `ComboBox` コントロールを使用すると、ドロップダウン コンボ ボックスのデータを表示できます。  既定では、`ComboBox` コントロールは 2 つの部分に分かれています。上の部分は、リスト項目を入力できるテキスト ボックスです。  下の部分は、項目のリストが表示されるリスト ボックスであり、このボックスから 1 つの項目を選択できます。  
+  
+## このセクションの内容  
+ [ComboBox コントロールの概要](../../../../docs/framework/winforms/controls/combobox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : ComboBox コントロールにサイズ変更可能なテキストを作成する](../../../../docs/framework/winforms/controls/how-to-create-variable-sized-text-in-a-combobox-control.md)  
+ `ComboBox` コントロールでのテキストのカスタム描画の方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ComboBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)  
+ リスト ボックス、コンボ ボックス、およびチェックされたリスト ボックスの機能の一覧を提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/considerations-when-hosting-an-activex-control-on-a-windows-form.md b/docs/framework/winforms/controls/considerations-when-hosting-an-activex-control-on-a-windows-form.md
new file mode 100644
index 00000000000..4efee63eb3a
--- /dev/null
+++ b/docs/framework/winforms/controls/considerations-when-hosting-an-activex-control-on-a-windows-form.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォームで ActiveX コントロールをホストする場合の考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ActiveX コントロール [Windows フォーム], 追加"
+  - "ActiveX コントロール [Windows フォーム], ホスト"
+  - "Windows フォーム コントロール, ActiveX コントロール"
+  - "Windows フォーム, ActiveX コントロール"
+  - "Windows フォーム, ホスト (ActiveX コントロールを)"
+ms.assetid: 2509302d-a74e-484f-9890-2acdbfa67a68
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームで ActiveX コントロールをホストする場合の考慮事項
+Windows フォームは、Windows フォーム コントロールをホストするために最適化されていますが、代わりに ActiveX コントロールも使用できます。  アプリケーションで ActiveX コントロールを使用する場合には、以下の点を考慮してください。  
+  
+-   **セキュリティ** 共通言語ランタイムは、コード アクセスのセキュリティについて強化されています。  Windows フォームを使用するアプリケーションは、問題のない完全に信頼できる環境で実行するか、またはほとんどの機能にアクセスできる、やや信頼性の低い環境で実行できます。  Windows フォーム コントロールは、ブラウザーで簡単にホストできます。  ただし、Windows フォーム上の ActiveX コントロールでは、これらのセキュリティの拡張機能を利用できません。  ActiveX コントロールの実行には、<xref:System.Security.Permissions.SecurityPermissionAttribute.UnmanagedCode%2A?displayProperty=fullName> プロパティで設定されるアンマネージ コード アクセス許可が必要です。  セキュリティおよびアンマネージ コード アクセス許可の詳細については、「[SecurityPermissionAttribute クラス](frlrfSystemSecurityPermissionsSecurityPermissionAttributeClassTopic)」を参照してください。  
+  
+-   **TCO \(Total Cost of Ownership\)** Windows フォームに追加された ActiveX コントロールは、その全体が Windows フォームと共に配置されるため、作成されるファイルのサイズがかなり大きくなる場合があります。  また、Windows フォーム上で ActiveX コントロールを使用するには、レジストリへの書き込みが必要です。  そのため、レジストリへの書き込みを必要としない Windows フォーム コントロールに比べて、ユーザーがコンピューターに干渉する度合いが大きくなります。  
+  
+    > [!NOTE]
+    >  ActiveX コントロールを使用するには、COM 相互運用ラッパーが必要です。  詳細については、「[Visual Basic および Visual C\# における COM 相互運用性](../Topic/COM%20Interoperability%20in%20.NET%20Framework%20Applications%20\(Visual%20Basic\).md)」を参照してください。  
+  
+    > [!NOTE]
+    >  ActiveX コントロールの中に、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で定義されている名前と同じ名前のメンバーがある場合、<xref:System.Windows.Forms.AxHost> の派生クラスの作成時に、ActiveX コントロール インポーターによって、これらのメンバーにプレフィックス **Ctl** が付けられます。  たとえば、ActiveX コントロールに **Layout** という名前のメンバーが含まれる場合、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] に **Layout** イベントが定義されているため、AxHost 派生クラスでは **CtlLayout** という名前に変更されます。  
+  
+## 参照  
+ [方法 : Windows フォームに ActiveX コントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)   
+ [コード アクセス セキュリティ](../../../../docs/framework/misc/code-access-security.md)   
+ [Controls and Programmable Objects Compared in Various Languages and Libraries](http://msdn.microsoft.com/ja-jp/021f2a1b-8247-4348-a5ad-e1d9ab23004b)   
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)   
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/constituent-controls.md b/docs/framework/winforms/controls/constituent-controls.md
new file mode 100644
index 00000000000..e2c610ecb26
--- /dev/null
+++ b/docs/framework/winforms/controls/constituent-controls.md
@@ -0,0 +1,59 @@
+---
+title: "内在コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "内在コントロール"
+  - "カスタム コントロール [Windows フォーム], 内在コントロール"
+  - "ユーザー コントロール [Windows フォーム], 内在コントロール"
+  - "UserControl クラス"
+ms.assetid: 5565e720-198b-4bbd-a2bd-c447ba641798
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 内在コントロール
+ユーザー コントロールを構成する各コントロールは "*内在コントロール*" と呼ばれます。内在コントロールでは、カスタム グラフィック レンダリングに関する柔軟性が比較的低くなります。  Windows フォーム コントロールはすべて、独自の <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを使用して独自のレンダリングを処理します。  このメソッドはプロテクトされているため、開発者がアクセスすることはできません。したがって、コントロールが描画されるときに、このメソッドが実行されないようにすることはできません。  ただし、内在コントロールの外観に影響するコードを追加できないという意味ではありません。  追加のレンダリングは、イベント ハンドラーを追加することで実現できます。  たとえば、`MyButton` という名前のボタンを使用して <xref:System.Windows.Forms.UserControl> を編集するとします。  [Button クラス](frlrfSystemWebUIWebControlsButtonClassTopic)によって提供される外観に独自のレンダリングを追加する場合は、次のようなコードをユーザー コントロールに追加します。  
+  
+```vb  
+Public Sub MyPaint(ByVal sender as Object, e as PaintEventArgs) Handles _  
+   MyButton.Paint  
+   'Additional rendering code goes here  
+End Sub  
+  
+```  
+  
+```csharp  
+// Add the event handler to the button's Paint event.  
+MyButton.Paint +=   
+   new System.Windows.Forms.PaintEventHandler (this.MyPaint);  
+// Create the custom painting method.  
+protected void MyPaint (object sender,   
+System.Windows.Forms.PaintEventArgs e)  
+{  
+   // Additional rendering code goes here.  
+}  
+```  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.TextBox> など、一部の Windows フォーム コントロールは、直接 Windows によって描画されます。  そのような場合、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドは呼び出されないため、例に示したコードも呼び出されません。  
+  
+ このコードは、`MyButton.Paint` イベントが実行されるたびに実行されるメソッドを作成して、コントロールに独自のグラフィカル表示を追加します。  これは `MyButton.OnPaint` の実行を妨げるものではなく、カスタム描画に加えて、ボタンによって通常実行される描画もすべて実行されます。  GDI\+ テクノロジとカスタム レンダリングの詳細については、「[GDI\+ によるグラフィカル イメージの作成](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)」を参照してください。  コントロールに固有の表示を行うための最善の方法は、継承したコントロールを作成して、それに対するカスタム レンダリング コードを記述することです。  詳細については、「[ユーザー描画コントロール](../../../../docs/framework/winforms/controls/user-drawn-controls.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.UserControl>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ [ユーザー描画コントロール](../../../../docs/framework/winforms/controls/user-drawn-controls.md)   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md b/docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md
new file mode 100644
index 00000000000..bf0c3f55d8b
--- /dev/null
+++ b/docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "ContextMenu コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ContextMenu"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, ContextMenu コンポーネント"
+  - "ContextMenu コンポーネント [Windows フォーム], ContextMenu コンポーネントの概要"
+  - "ショートカット メニュー, ContextMenu コンポーネント"
+ms.assetid: 49d6398f-d3c4-4679-84fa-1de07b68b05e
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# ContextMenu コンポーネントの概要 (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.MenuStrip> と <xref:System.Windows.Forms.ContextMenuStrip> は、以前のバージョンの <xref:System.Windows.Forms.MainMenu> コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、<xref:System.Windows.Forms.MainMenu> および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.ContextMenu> コンポーネントには、選択したオブジェクトに関連付けられたコマンドのうち、頻繁に使用されるコマンドを簡単に実行するためのメニューが用意されています。  ショートカット メニューの項目は、多くの場合、アプリケーションの他の場所に表示されるメイン メニューの項目のサブセットです。  ユーザーは、通常、マウスを右クリックしてショートカット メニューにアクセスします。  Windows フォームでは、ショートカット メニューはコントロールに関連付けられています。  
+  
+## 主要なプロパティ  
+ ショートカット メニューをコントロールに関連付けるには、コントロールの <xref:System.Windows.Forms.Control.ContextMenu%2A> プロパティに <xref:System.Windows.Forms.ContextMenu> コンポーネントを設定します。  1 つのショートカット メニューを複数のコントロールに関連付けることができますが、各コントロールに設定できるショートカット メニューは 1 つだけです。  
+  
+ <xref:System.Windows.Forms.ContextMenu> コンポーネントの主要なプロパティは、<xref:System.Windows.Forms.Menu.MenuItems%2A> プロパティです。  メニュー項目を作成するには、プログラムで <xref:System.Windows.Forms.MenuItem> オブジェクトを作成し、これらのオブジェクトをショートカット メニューの <xref:System.Windows.Forms.Menu.MenuItemCollection> に追加します。  ショートカット メニューの項目は、通常、他のメニューを基に作成するため、他のメニュー項目をコピーしてショートカット メニューに追加するのが一般的な方法です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenu>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/contextmenu-component-windows-forms.md b/docs/framework/winforms/controls/contextmenu-component-windows-forms.md
new file mode 100644
index 00000000000..c112e1aeccc
--- /dev/null
+++ b/docs/framework/winforms/controls/contextmenu-component-windows-forms.md
@@ -0,0 +1,52 @@
+---
+title: "ContextMenu コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, Windows フォーム"
+  - "ContextMenu コンポーネント [Windows フォーム]"
+  - "メニュー, コンテキスト メニュー"
+  - "メニュー, ショートカット メニュー"
+  - "ポップアップ メニュー"
+  - "ショートカット メニュー, ContextMenu コンポーネント"
+  - "Windows フォーム, メニュー"
+ms.assetid: 9b93ccbc-c0fe-44a2-968e-faac25971831
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ContextMenu コンポーネント (Windows フォーム)
+> [!NOTE]
+>  `MenuStrip` と `ContextMenuStrip` は、以前のバージョンの <xref:System.Windows.Forms.MainMenu> コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、<xref:System.Windows.Forms.MainMenu> および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ Windows フォームの `ContextMenu` コンポーネントは、選択したオブジェクトに関連付けられたコマンドのうち、頻繁に使用されるコマンドを簡単に実行するためのショートカット メニューを提供します。  ショートカット メニューの項目は、多くの場合、アプリケーションの他の場所に表示されるメイン メニューの項目のサブセットです。  通常、ショートカット メニューはマウスの右クリックで表示されます。  Windows フォームでは、ショートカット メニューが他のコントロールに関連付けられています。  
+  
+## このセクションの内容  
+ [ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)  
+ 選択したオブジェクトに関連付けられた頻繁に使用されるコマンドのメニューを提供する、`ContextMenu` コンポーネントの全般的な概念を説明します。  
+  
+ [方法 : Windows フォーム ContextMenu コンポーネントのメニュー項目を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-menu-items-with-wf-contextmenu-component.md)  
+ Windows フォームのショートカット メニューの項目を追加する方法および削除する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ContextMenu>  
+ <xref:System.Windows.Forms.ContextMenu> クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/contextmenustrip-control-overview.md b/docs/framework/winforms/controls/contextmenustrip-control-overview.md
new file mode 100644
index 00000000000..92d7a6e0f99
--- /dev/null
+++ b/docs/framework/winforms/controls/contextmenustrip-control-overview.md
@@ -0,0 +1,48 @@
+---
+title: "ContextMenuStrip コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ContextMenuStrip"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, ContextMenuStrip コントロール [Windows フォーム]"
+  - "ContextMenuStrip コントロール [Windows フォーム], ContextMenuStrip コントロールの概要"
+  - "ショートカット メニュー, ContextMenuStrip コントロール [Windows フォーム]"
+ms.assetid: 9787cdb3-88f1-4198-972f-eefd9524ce39
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# ContextMenuStrip コントロールの概要
+> [!NOTE]
+>  <xref:System.Windows.Forms.ContextMenuStrip> コントロールは、<xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ContextMenu> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ ユーザーがマウスの右ボタンをクリックすると、コンテキスト メニューとも呼ばれるショートカット メニューがマウスの位置に表示されます。  ショートカット *メニュー*は、マウス ポインター位置にクライアント領域やコントロールのオプションを提供します。  
+  
+ <xref:System.Windows.Forms.ContextMenuStrip> コントロールは、新しい <xref:System.Windows.Forms.ToolStrip> や関連するコントロールとシームレスに動作するようにデザインされていますが、<xref:System.Windows.Forms.ContextMenuStrip> コントロールは他のコントロールに簡単に関連付けることができます。  
+  
+ 重要な <xref:System.Windows.Forms.ContextMenuStrip> コンパニオン クラスを次の表に示します。  
+  
+|Class|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripMenuItem>|<xref:System.Windows.Forms.MenuStrip> または <xref:System.Windows.Forms.ContextMenuStrip> に表示される選択可能なオプションを表します。|  
+|<xref:System.Windows.Forms.ToolStripDropDown>|<xref:System.Windows.Forms.ToolStripDropDownButton> またはより高レベルのメニュー項目をクリックすると表示されるリストから、1 つの項目を選択できるようにするコントロールを表します。|  
+|<xref:System.Windows.Forms.ToolStripDropDownItem>|クリック時にドロップダウン項目を表示する、<xref:System.Windows.Forms.ToolStripItem> から派生するコントロールの基本機能を提供します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ <xref:System.Windows.Forms.ToolStripDropDown>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/contextmenustrip-control.md b/docs/framework/winforms/controls/contextmenustrip-control.md
new file mode 100644
index 00000000000..23cc695c593
--- /dev/null
+++ b/docs/framework/winforms/controls/contextmenustrip-control.md
@@ -0,0 +1,61 @@
+---
+title: "ContextMenuStrip コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー"
+  - "ContextMenuStrip コントロール [Windows フォーム]"
+  - "ショートカット メニュー"
+ms.assetid: 76e070b2-65d7-457f-8300-d104e4e01e5e
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ContextMenuStrip コントロール
+<xref:System.Windows.Forms.ContextMenuStrip> コントロールは、コントロールに関連付けるショートカット メニューを提供します。  
+  
+## このセクションの内容  
+ [ContextMenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/contextmenustrip-control-overview.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します  
+  
+ [方法 : ContextMenuStrip をコントロールに関連付ける](../../../../docs/framework/winforms/controls/how-to-associate-a-contextmenustrip-with-a-control.md)  
+ <xref:System.Windows.Forms.ContextMenuStrip> を特定のコントロールのショートカット メニューにする方法について説明します。  
+  
+ [方法 : メニュー項目を ContextMenuStrip に追加する](../../../../docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md)  
+ 選択可能なオプションを <xref:System.Windows.Forms.ContextMenuStrip> に追加する方法について説明します。  
+  
+ [方法 : ContextMenuStrip のチェックの余白とイメージの余白を設定する](../../../../docs/framework/winforms/controls/how-to-configure-contextmenustrip-check-margins-and-image-margins.md)  
+ チェックとイメージの余白のプロパティをさまざまに設定することで <xref:System.Windows.Forms.ContextMenuStrip> をカスタマイズする方法について説明します。  
+  
+ [方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする](../../../../docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md)  
+ <xref:System.Windows.Forms.ContextMenuStrip> チェックの余白をオンおよびオフに切り替える方法について説明します。  
+  
+ [方法 : ContextMenuStrip のオープン イベントを処理する](../../../../docs/framework/winforms/controls/how-to-handle-the-contextmenustrip-opening-event.md)  
+ <xref:System.Windows.Forms.ToolStripDropDown.Opening> イベントを処理することで、<xref:System.Windows.Forms.ContextMenuStrip> コントロールの動作をカスタマイズする方法について説明します。  
+  
+ 「[\[ContextMenuStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233646\(v=vs.110\))」または「[ContextMenuStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233641\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.MenuStrip>  
+ フォームにメニュー システムを提供する <xref:System.Windows.Forms.MenuStrip> クラスの機能について説明します。  
+  
+ <xref:System.Windows.Forms.ContextMenuStrip>  
+ ショートカット メニューを表す <xref:System.Windows.Forms.ContextMenuStrip> の機能について説明します。  
+  
+ <xref:System.Windows.Forms.ToolStripMenuItem>  
+ <xref:System.Windows.Forms.MenuStrip> または <xref:System.Windows.Forms.ContextMenuStrip> に表示される選択可能なオプションを表す <xref:System.Windows.Forms.ToolStripMenuItem> クラスの機能について説明します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/control-type-recommendations.md b/docs/framework/winforms/controls/control-type-recommendations.md
new file mode 100644
index 00000000000..371417e620f
--- /dev/null
+++ b/docs/framework/winforms/controls/control-type-recommendations.md
@@ -0,0 +1,93 @@
+---
+title: "コントロールの種類に関するアドバイス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 作成"
+  - "カスタム コントロール [Windows フォーム], 種類"
+  - "継承, Windows フォーム カスタム コントロール"
+  - "ユーザー コントロール [Windows フォーム], 使用する時期"
+ms.assetid: 5235fe9d-c36a-4c08-ae76-6cb90b50085e
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# コントロールの種類に関するアドバイス
+.NET Framework は、新しいコントロールを開発して実装する機能を提供します。  使い慣れたユーザー コントロールだけでなく、独自の描画を実行するカスタム コントロールを作成することも、継承によって既存のコントロールの機能を拡張することもできるようになりました。  作成するコントロールの種類の決定が、混乱を招く可能性があります。  このセクションでは、継承できるさまざまな種類のコントロールの間の違いについて説明し、プロジェクトに合わせて選択する種類に関する注意点を示しています。  
+  
+> [!NOTE]
+>  Web フォームで使用するコントロールを作成する場合は、「[Developing Custom ASP.NET Server Controls](../Topic/Developing%20Custom%20ASP.NET%20Server%20Controls.md)」を参照してください。  
+  
+## Windows フォーム コントロールからの継承  
+ 既存の Windows フォーム コントロールから継承されたコントロールを派生できます。  この方法では、すべての Windows フォーム コントロールの本質的な機能をすべて保持して、カスタム プロパティ、メソッド、またはその他の機能を追加することでその機能を拡張することができます。  たとえば、数値のみを受け付け、入力を自動的に値に変換できる <xref:System.Windows.Forms.TextBox> から派生したコントロールを作成することができます。  このようなコントロールには、テキスト ボックスのテキストが変更されるたびに呼び出される検証コードが含まれ、値のプロパティを追加で持つことができます。  一部のコントロールでは、基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドすることで、コントロールのグラフィカル インターフェイスにカスタムの外観を追加することができます。  
+  
+ 次の場合に、Windows フォーム コントロールから継承します。  
+  
+-   必要とする機能のほとんどが、既存の Windows フォーム コントロールと同じです。  
+  
+-   カスタムのグラフィカル インターフェイスが必要ないか、または既存のコントロールに対して新しいグラフィカルのフロント エンドをデザインします。  
+  
+## UserControl クラスを継承する  
+ ユーザー コントロールは、共通のコンテナー内にカプセル化された Windows フォーム コントロールのコレクションです。  コンテナーは、各 Windows フォーム コントロールに関連付けられている固有の機能をすべて保持し、それらのプロパティを選択的に公開してバインドすることができます。  ユーザー コントロールの例として、データベースから顧客の住所データを表示する貯めに作成されたコントロールがあります。  このコントロールには、各フィールドを表示するいくつかのテキスト ボックスと、レコード間を移動するボタン コントロールが含まれます。  データ バインドのプロパティは選択的に公開することができ、コントロール全体は、パッケージしてアプリケーション間で再利用できます。  
+  
+ 次の場合に、<xref:System.Windows.Forms.UserControl> クラスから継承します。  
+  
+-   いくつかの Windows フォーム コントロールの機能を再利用可能な 1 つの単位に結合します。  
+  
+## Control クラスからの継承  
+ コントロールを作成する別の方法は、<xref:System.Windows.Forms.Control> から継承することで、実質的に一から作成する方法です。  <xref:System.Windows.Forms.Control> クラスは、コントロール \(イベントなど\) によって必要とされる基本的な機能をすべて提供しますが、コントロール固有の機能やグラフィカル インターフェイスは提供しません。  <xref:System.Windows.Forms.Control> クラスから継承することでコントロールを作成する場合は、ユーザー コントロールや既存の Windows フォーム コントロールから継承する場合よりも、はるかに多くの配慮と労力が必要です。  作成者は、コントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> イベントのコード、および必要とされる機能固有のコードを作成する必要があります。  ただし、より大きな柔軟性が可能になり、正確なニーズに合わせてコントロールをカスタムに調整することができます。  カスタム コントロールの例は、アナログ時計の外観や動作を複製する時計コントロールです。  内部タイマー コンポーネントからの <xref:System.Windows.Forms.Timer.Tick> イベントに応答してカスタム描画が呼び出されて、時計の針が移動します。  
+  
+ 次の場合に、<xref:System.Windows.Forms.Control> クラスから継承します。  
+  
+-   コントロールのカスタムのグラフィカル表現を提供します。  
+  
+-   標準コントロールでは使用できないカスタムの機能を実装する必要があります。  
+  
+-   [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](http://msdn.microsoft.com/library/9yxtkx75\(v=vs.110\))  
+  
+-   [チュートリアル : DesignerSerializationVisibilityAttribute を使用した、標準データ型のコレクションのシリアル化](http://msdn.microsoft.com/library/ms171731\(v=vs.110\))  
+  
+-   [チュートリアル: Visual C\# による Windows フォーム コントロールからの継承](http://msdn.microsoft.com/en-us/library/5h0k2e6x%20\(v=vs.110\))  
+  
+-   [方法 : コントロールにツールボックス ビットマップを指定する](http://msdn.microsoft.com/library/4wk1wc0a%20\(v=vs.110\))  
+  
+-   [方法 : 既存の Windows フォーム コントロールから継承する](http://msdn.microsoft.com/library/7h62478z%20\(v=vs.110\))  
+  
+-   [チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](http://msdn.microsoft.com/library/5ytx0z24\(v=vs.110\))  
+  
+-   [方法 : コントロール クラスを継承する](http://msdn.microsoft.com/library/skcysbt2%20\(v=vs.110\))  
+  
+-   [方法 : UserControl の実行時の動作をテストする](http://msdn.microsoft.com/library/ms171738%20\(v=vs.110\))  
+  
+-   [方法 : デザイン時にフォームの端に合わせてコントロールを配置する](http://msdn.microsoft.com/library/1fxyb15b%20\(v=vs.110\))  
+  
+-   [方法 : UserControl クラスを継承する](http://msdn.microsoft.com/library/00ctb4z0\(v=vs.110\))  
+  
+-   [方法 : Windows フォームのコントロールを作成する](http://msdn.microsoft.com/library/bs3yhkh7%20\(v=vs.110\))  
+  
+-   [方法 : 複合コントロールを作成する](http://msdn.microsoft.com/library/3sf86w5h\(v=vs.110\))  
+  
+-   [チュートリアル : Visual Basic による複合コントロールの作成](http://msdn.microsoft.com/library/c316f119%20\(v=vs.110\))  
+  
+-   [チュートリアル : Visual C\# による複合コントロールの作成](http://msdn.microsoft.com/en-us/library/a6h7e207\(v=vs.110\))  
+  
+-   [チュートリアル: Visual Basic による Windows フォーム コントロールからの継承](http://msdn.microsoft.com/library/w2a8y03d\(v=vs.110\))  
+  
+-   [方法 : デザイン時機能を活用した Windows フォーム コントロールを作成する](http://msdn.microsoft.com/library/307hck25\(v=vs.110\))  
+  
+-   [方法 : デザイン時機能を活用した Windows フォーム コントロールを作成する](http://msdn.microsoft.com/library/307hck25\(v=vs.120\))  
+  
+## 参照  
+ [方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/controls-to-use-on-windows-forms.md b/docs/framework/winforms/controls/controls-to-use-on-windows-forms.md
new file mode 100644
index 00000000000..8d1de3e0511
--- /dev/null
+++ b/docs/framework/winforms/controls/controls-to-use-on-windows-forms.md
@@ -0,0 +1,246 @@
+---
+title: "Windows フォームで使用するコントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム]"
+  - "Windows フォーム コントロールの一覧"
+ms.assetid: dec51976-eae0-4398-a537-20bca7974722
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# Windows フォームで使用するコントロール
+コントロールと Windows フォームで使用できるコンポーネントのアルファベット順の一覧を次に示します。 このセクションで説明する Windows フォーム コントロール、に加えては、Windows フォームに ActiveX コントロールとカスタム コントロールを追加できます。 ここで必要な制御が表示されているが見つからない場合は、作成することも、独自です。 詳細については、「[デザイン時に Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)します。 コントロールの選択の詳細については、表示[Windows フォーム コントロールの機能別](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)します。  
+  
+> [!NOTE]
+>  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]コントロールがによって提供されるクラスに基づく、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]です。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [Windows フォーム コントロールの機能別](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)  
+ 基づく Windows フォーム コントロールを示し、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]です。  
+  
+ [組み込みのオーナー描画サポートを備えたコントロール](../../../../docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md)  
+ プロパティによって提供されていないコントロールの外観の側面を変更する方法について説明します。  
+  
+ [BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)  
+ フォームまたはコントロールを非同期的に操作を実行できます。  
+  
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)  
+ データにバインドされているコントロールの移動および操作のユーザー インターフェイス (UI) を提供します。  
+  
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)  
+ コントロールにバインドするデータ ソースをカプセル化します。  
+  
+ [ボタン コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)  
+ ユーザーがクリックする操作を実行する標準のボタンを表示します。  
+  
+ [CheckBox コントロール](../../../../docs/framework/winforms/controls/checkbox-control-windows-forms.md)  
+ 条件がオンかオフかどうかを示します。  
+  
+ [CheckedListBox コントロール](../../../../docs/framework/winforms/controls/checkedlistbox-control-windows-forms.md)  
+ 各項目の横のチェック ボックスを持つアイテムを一覧表示されます。  
+  
+ [ColorDialog コンポーネント](../../../../docs/framework/winforms/controls/colordialog-component-windows-forms.md)  
+ で構成済みのダイアログ ボックスでパレットから色を選択し、そのパレットにカスタムの色を追加できます。  
+  
+ [コンボ ボックス コントロール](../../../../docs/framework/winforms/controls/combobox-control-windows-forms.md)  
+ ドロップダウン コンボ ボックスにデータを表示します。  
+  
+ [ContextMenu コンポーネント](../../../../docs/framework/winforms/controls/contextmenu-component-windows-forms.md)  
+ 選択したオブジェクトに関連付けられている頻繁に使用されるコマンドを簡単にアクセスできるメニューにユーザーを提供します。 <xref:System.Windows.Forms.ContextMenuStrip>は置換し、する機能を追加、 <xref:System.Windows.Forms.ContextMenu>以前のバージョンの制御<xref:System.Windows.Forms.ContextMenu>必要な場合、下位互換性と将来の使用の両方を保持します。  
+  
+ [ContextMenuStrip コントロール](../../../../docs/framework/winforms/controls/contextmenustrip-control.md)  
+ ショートカット メニューを表します。 <xref:System.Windows.Forms.ContextMenuStrip>は置換し、する機能を追加、 <xref:System.Windows.Forms.ContextMenu>以前のバージョンの制御<xref:System.Windows.Forms.ContextMenu>必要な場合、下位互換性と将来の使用の両方を保持します。  
+  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)  
+ データセットから表形式のデータを表示し、データ ソースを更新できるようにします。  
+  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)  
+ 表示および表形式のデータを編集するためには、柔軟で拡張可能なシステムを提供します。  
+  
+ [DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)  
+ 日付または時刻の一覧から&1; つの項目を選択できます。  
+  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ アプリケーションまたはシステムと標準的な対話を実行できるようにするコントロールのセットについて説明します。  
+  
+ [DomainUpDown コントロール](../../../../docs/framework/winforms/controls/domainupdown-control-windows-forms.md)  
+ ユーザーが参照してから選択できるテキスト文字列を表示します。  
+  
+ [ErrorProvider コンポーネント](../../../../docs/framework/winforms/controls/errorprovider-component-windows-forms.md)  
+ 非侵入型の方法でユーザーにエラー情報を表示します。  
+  
+ 「FileDialog クラス」  
+ ファイル ダイアログ ボックスの基本クラスの機能を提供します。  
+  
+ [FlowLayoutPanel コントロール](../../../../docs/framework/winforms/controls/flowlayoutpanel-control-windows-forms.md)  
+ 水平方向または垂直方向に内容を動的にレイアウトするパネルを表します。  
+  
+ [FolderBrowserDialog コンポーネント](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md)  
+ 表示、どのユーザー インターフェイスは参照しディレクトリを選択または新規に作成します。  
+  
+ [FontDialog コンポーネント](../../../../docs/framework/winforms/controls/fontdialog-component-windows-forms.md)  
+ 現在システムにインストールされているフォントを公開します。  
+  
+ [GroupBox コントロール](../../../../docs/framework/winforms/controls/groupbox-control-windows-forms.md)  
+ その他のコントロールのグループに分けますを提供します。  
+  
+ [HelpProvider コンポーネント](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md)  
+ Windows ベースのアプリケーションで HTML ヘルプ ファイルに関連付けます。  
+  
+ [HScrollBar コントロールおよび VScrollBar コントロール](../../../../docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-windows-forms.md)  
+ または垂直方向に水平方向にスクロールすることにより、アプリケーションまたはコントロール内では、項目または大量の情報の一覧をナビゲーションを提供します。  
+  
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)  
+ その他のコントロール イメージを表示します。  
+  
+ [ラベル コントロール](../../../../docs/framework/winforms/controls/label-control-windows-forms.md)  
+ ユーザーが編集できないテキストを表示します。  
+  
+ [LinkLabel コントロール](../../../../docs/framework/winforms/controls/linklabel-control-windows-forms.md)  
+ Windows フォーム アプリケーションに Web スタイルのリンクを追加できます。  
+  
+ [ListBox コントロール](../../../../docs/framework/winforms/controls/listbox-control-windows-forms.md)  
+ 定義済みの一覧から&1; つまたは複数の項目を選択できます。  
+  
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)  
+ Windows エクスプ ローラーの方法で、アイコンが表示された項目の一覧を表示します。  
+  
+ [MainMenu コンポーネント](../../../../docs/framework/winforms/controls/mainmenu-component-windows-forms.md)  
+ 実行時にメニューが表示されます。 <xref:System.Windows.Forms.MenuStrip>は置換し、する機能を追加、 <xref:System.Windows.Forms.MainMenu>以前のバージョンの制御<xref:System.Windows.Forms.MainMenu>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [MaskedTextBox コントロール](../../../../docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md)  
+ フォームでのユーザー入力の形式を制限します。  
+  
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)  
+ フォーム用のメニュー システムを提供します。 <xref:System.Windows.Forms.MenuStrip>は置換し、する機能を追加、 <xref:System.Windows.Forms.MainMenu>以前のバージョンの制御<xref:System.Windows.Forms.MainMenu>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)  
+ ユーザー表示し、日付情報を設定するための直感的なグラフィカル インターフェイスを表示します。  
+  
+ [NotifyIcon コンポーネント](../../../../docs/framework/winforms/controls/notifyicon-component-windows-forms.md)  
+ バック グラウンドで実行し、ユーザー インターフェイスを持たないいるプロセスのアイコンが表示されます。  
+  
+ [NumericUpDown コントロール](../../../../docs/framework/winforms/controls/numericupdown-control-windows-forms.md)  
+ ユーザーが参照してから選択できる数字が表示されます。  
+  
+ [OpenFileDialog コンポーネント](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md)  
+ 構成済みのダイアログ ボックスを使用してファイルを開くことができます。  
+  
+ [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md)  
+ ページの事前構成済みダイアログ ボックスで印刷の詳細を設定します。  
+  
+ [Panel コントロール](../../../../docs/framework/winforms/controls/panel-control-windows-forms.md)  
+ その他のグループに分けますコントロール、およびスクロールできるようにを提供します。  
+  
+ [PictureBox コントロール](../../../../docs/framework/winforms/controls/picturebox-control-windows-forms.md)  
+ ビットマップ、GIF、JPEG、メタファイル、またはアイコンの形式で画像を表示します。  
+  
+ [PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)  
+ プリンターを選択して、ページを印刷し、その他の印刷関連の設定を決定します。  
+  
+ [PrintDocument コンポーネント](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md)  
+ 印刷する対象を記述するプロパティを設定し、Windows ベースのアプリケーションでドキュメントを印刷します。  
+  
+ [PrintPreviewControl コントロール](../../../../docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md)  
+ 独自に作成することができます`PrintPreview`構成済みのバージョンを使用する代わりにコンポーネントまたはダイアログ ボックス。  
+  
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)  
+ 印刷時に表示されるドキュメントを表示します。  
+  
+ [ProgressBar コントロール](../../../../docs/framework/winforms/controls/progressbar-control-windows-forms.md)  
+ 処理の進行状況をグラフィカルに示します。  
+  
+ [RadioButton コントロール](../../../../docs/framework/winforms/controls/radiobutton-control-windows-forms.md)  
+ ユーザーに一連の&2; つ以上の相互に排他的なオプションを表示します。  
+  
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)  
+ 入力、表示、および書式設定を含むテキストを操作することができます。  
+  
+ [SaveFileDialog コンポーネント](../../../../docs/framework/winforms/controls/savefiledialog-component-windows-forms.md)  
+ 保存するファイルとそれらの保存先を選択します。  
+  
+ 「SoundPlayer クラス」  
+ アプリケーションにサウンドを簡単に追加できます。  
+  
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)  
+ ドッキングされたコントロールのサイズを変更できます。  
+  
+ [Splitter コントロール](../../../../docs/framework/winforms/controls/splitter-control-windows-forms.md)  
+ ドッキングされたコントロールのサイズを変更することができます ([!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]バージョン 1.x)。  
+  
+ [StatusBar コントロール](../../../../docs/framework/winforms/controls/statusbar-control-windows-forms.md)  
+ フォーカスを持つコントロールに関連するステータス情報を表示します。 <xref:System.Windows.Forms.StatusStrip>置き換え、拡張、 <xref:System.Windows.Forms.StatusBar>以前のバージョンのコントロール<xref:System.Windows.Forms.StatusBar>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [StatusStrip コントロール](../../../../docs/framework/winforms/controls/statusstrip-control.md)  
+ Windows ステータス バー コントロールを表します。 <xref:System.Windows.Forms.StatusStrip>置き換え、拡張、 <xref:System.Windows.Forms.StatusBar>以前のバージョンのコントロール<xref:System.Windows.Forms.StatusBar>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)  
+ 画像やその他のコントロールを含めることができる複数のタブが表示されます。  
+  
+ [TableLayoutPanel コントロール](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md)  
+ 内容を行と列から成るグリッドに動的にレイアウトするパネルを表します。  
+  
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)  
+ ユーザーの編集可能な複数行の入力を許可します。  
+  
+ [Timer コンポーネント](../../../../docs/framework/winforms/controls/timer-component-windows-forms.md)  
+ 一定の間隔でイベントを発生させます。  
+  
+ [ツール バー コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)  
+ メニューとコマンドをアクティブ化するビットマップのボタンが表示されます。 コントロールの機能を拡張し、その外観と動作を変更できます。 <xref:System.Windows.Forms.ToolStrip>は置換し、する機能を追加、<xref:System.Windows.Forms.ToolBar>以前のバージョンの制御<xref:System.Windows.Forms.ToolBar>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)  
+ Windows フォーム アプリケーションでは、カスタム ツールバーおよびメニューを作成します。 <xref:System.Windows.Forms.ToolStrip>は置換し、する機能を追加、<xref:System.Windows.Forms.ToolBar>以前のバージョンの制御<xref:System.Windows.Forms.ToolBar>を選択した場合に下位互換性と将来の使用の両方を保持します。  
+  
+ [ToolStripContainer コントロール](../../../../docs/framework/winforms/controls/toolstripcontainer-control.md)  
+ ドッキング、ラフティング、および配置するためのフォームの各辺にパネルを用意<xref:System.Windows.Forms.ToolStrip>コントロール、および中央<xref:System.Windows.Forms.ToolStripContentPanel>従来のコントロールにします。  
+  
+ [ToolStripPanel コントロール](../../../../docs/framework/winforms/controls/toolstrippanel-control.md)  
+ 1 つのパネルをドッキング、ラフティングおよび配置するために提供<xref:System.Windows.Forms.ToolStrip>コントロールです。  
+  
+ [ToolStripProgressBar コントロールの概要](../../../../docs/framework/winforms/controls/toolstripprogressbar-control-overview.md)  
+ 処理の進行状況をグラフィカルに示します。 <xref:System.Windows.Forms.ToolStripProgressBar>に含まれることは通常、 <xref:System.Windows.Forms.StatusStrip>します。  
+  
+ [ToolStripStatusLabel コントロール](../../../../docs/framework/winforms/controls/toolstripstatuslabel-control.md)  
+ パネルを表します、 <xref:System.Windows.Forms.StatusStrip>コントロールです。  
+  
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)  
+ ユーザーがその他のコントロールをポイントしたときに、テキストを表示します。  
+  
+ [TrackBar コントロール](../../../../docs/framework/winforms/controls/trackbar-control-windows-forms.md)  
+ により、大量の情報や数値の設定を調整する視覚的に内を移動できます。  
+  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)  
+ 展開または折りたたまれているノードの階層が表示されます。  
+  
+ [WebBrowser コントロール](../../../../docs/framework/winforms/controls/webbrowser-control-windows-forms.md)  
+ Web ページをホストし、インターネット Web ブラウズ、アプリケーションに機能を提供します。  
+  
+ [Windows フォーム コントロールのオプションを一覧表示するために使用](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)  
+ 選択できるオプションの一覧をユーザーに提供するために使用するコントロールのセットについて説明します。  
+  
+## <a name="related-sections"></a>関連項目  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ Windows フォーム コントロールの使用法について説明し、それらを操作するための重要な概念を説明します。  
+  
+ [デザイン時にフォームのコントロールを Windows の開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)  
+ ステップ バイ ステップの情報を作成するコントロールと、独自のコントロールの作成に関するその他の情報の種類に関する推奨事項へのリンクを提供します。  
+  
+ [コントロールとプログラミング可能なオブジェクトを比較し、さまざまな言語とライブラリ](http://msdn.microsoft.com/ja-jp/021f2a1b-8247-4348-a5ad-e1d9ab23004b)  
+ 対応するコントロールを Visual Basic 6.0 でコントロールをマップするテーブルは、[!INCLUDE[vbprvblong](../../../../includes/vbprvblong-md.md)]です。 なお、コントロールが内のクラスではこれで、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)]です。  
+  
+ [方法: Windows フォームに ActiveX コントロールを追加します。](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)  
+ Windows フォームで ActiveX コントロールを使用する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md b/docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md
new file mode 100644
index 00000000000..38835136391
--- /dev/null
+++ b/docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md
@@ -0,0 +1,202 @@
+---
+title: "組み込みのオーナー描画サポートを備えたコントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "描画、所有者"
+  - "描画、カスタム"
+  - "外観を変更するコントロール [Windows フォーム]"
+  - "カスタム描画"
+  - "オーナー描画"
+ms.assetid: 3823d01e-9610-43e6-864d-99f9b7c2b351
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 組み込みのオーナー描画サポートを備えたコントロール
+オーナー描画とも呼ばれるカスタムの描画には、Windows フォームでは、特定のコントロールの外観を変更するための手法です。  
+  
+> [!NOTE]
+>  このトピックの「コントロール」という単語はいずれかから派生するクラスを意味するために使用<xref:System.Windows.Forms.Control>または<xref:System.ComponentModel.Component>します。  
+  
+ 通常、Windows の描画を自動的に処理などのプロパティの設定を使用して<xref:System.Windows.Forms.Control.BackColor%2A>コントロールの外観を決定します。 オーナー描画、引き継ぎを行う描画プロセスの外観のプロパティを使用して提供されていない要素を変更します。 たとえば、多くのコントロールを使用して、表示されるテキストの色を設定できますが、1 つの色に制限されます。 オーナー描画では、黒で部分を赤でテキストの一部を表示したりすることができます。  
+  
+ 実際には、オーナー描画は、フォーム上のグラフィックスの描画に似ています。 フォームのため、ハンドラーでグラフィックス メソッドを使用する可能性があります<xref:System.Windows.Forms.Control.Paint>をエミュレートするイベント、`ListBox`コントロールですは、すべてのユーザー操作を処理するコードを記述する必要があります。 オーナー描画、コントロールのサイズ、コードを使用して、その内容を描画するがそれ以外の場合、すべての組み込み機能を保持します。 コントロール内の各項目を描画するか、既定の外観を使用して各項目の他の側面の中に、各項目の一部の機能をカスタマイズするには、グラフィックス メソッドを使用することができます。  
+  
+## <a name="owner-drawing-in-windows-forms-controls"></a>オーナー描画 Windows フォーム コントロール  
+ をサポートしているコントロールのオーナー描画を実行するには、通常&1; つのプロパティを設定して&1; つまたは複数のイベントを処理します。  
+  
+ ほとんどのコントロールのオーナー描画をサポートしているが、`OwnerDraw`または`DrawMode`コントロールは、描画関連のイベントまたは自身を描画するときにイベントを発生させるかどうかを示すプロパティです。  
+  
+ コントロールがない、`OwnerDraw`または`DrawMode`プロパティを含む、`DataGridView`コントロールで、自動的に実行する描画イベントを提供するには、および`ToolStrip`を独自の描画に関連するイベントを持つ外部レンダリング クラスを使用して描画するコントロール。  
+  
+ 描画イベントのさまざまな種類がありますが、コントロール内の&1; つの項目を描画するために一般的な描画イベントが発生しました。 イベント ハンドラーは、`EventArgs`を描画することで描画される項目に関する情報を含み、ツール オブジェクトで使用できます。 このオブジェクトが通常、その親コレクション内の項目のインデックス番号を含むなど、<xref:System.Drawing.Rectangle>アイテムの表示の境界を示す、<xref:System.Drawing.Graphics>ペイント メソッドを呼び出すためのオブジェクト。 一部のイベント、`EventArgs`オブジェクトは、アイテムと、バック グラウンドやフォーカス四角形などの既定では、項目の一部の機能の描画に呼び出すことのできるメソッドに関する追加情報を提供します。  
+  
+ オーナー描画のカスタマイズを含む再利用可能なコントロールを作成するには、オーナー描画をサポートするコントロール クラスから派生する新しいクラスを作成します。 描画イベントを処理するのではなく、オーナー描画コードを適切な上書き含める`On` *EventName*メソッドまたは新しいクラスのメソッドです。 基本クラスを呼び出すことを確認`On` *EventName*メソッドまたはメソッドはここでは、コントロールのユーザーがオーナー描画イベントを処理して、追加のカスタマイズを提供できるようにします。  
+  
+ 次の Windows フォームでは、サポートのオーナー描画、.NET Framework のすべてのバージョンを制御します。  
+  
+-   <xref:System.Windows.Forms.ListBox>  
+  
+-   <xref:System.Windows.Forms.ComboBox>  
+  
+-   <xref:System.Windows.Forms.MenuItem> (で使用される<xref:System.Windows.Forms.MainMenu>と<xref:System.Windows.Forms.ContextMenu>)  
+  
+-   <xref:System.Windows.Forms.TabControl>  
+  
+ 次のコントロールは、オーナー描画でのみをサポート[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)]:  
+  
+-   <xref:System.Windows.Forms.ToolTip>  
+  
+-   <xref:System.Windows.Forms.ListView>  
+  
+-   <xref:System.Windows.Forms.TreeView>  
+  
+ オーナー描画との新機能は次のコントロールがサポート[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)]:  
+  
+-   <xref:System.Windows.Forms.DataGridView>  
+  
+-   <xref:System.Windows.Forms.ToolStrip>  
+  
+ 次のセクションでは、これらの各コントロールの追加の詳細を説明します。  
+  
+### <a name="listbox-and-combobox-controls"></a>リスト ボックスやコンボ ボックス コントロール  
+ <xref:System.Windows.Forms.ListBox>と<xref:System.Windows.Forms.ComboBox>コントロールを使用すると、すべてに&1; つのサイズまたはさまざまなサイズのいずれかのコントロールに個別の項目を描画します。  
+  
+> [!NOTE]
+>  ですが、 <xref:System.Windows.Forms.CheckedListBox>から派生したコントロールは、 <xref:System.Windows.Forms.ListBox>コントロール、これはサポートされないオーナー描画します。  
+  
+ 同じサイズの各項目を描画する設定、`DrawMode`プロパティを<xref:System.Windows.Forms.DrawMode>を処理し、`DrawItem`イベントです。  
+  
+ さまざまなサイズを使用して各項目を描画する設定、`DrawMode`プロパティを<xref:System.Windows.Forms.DrawMode>両方を処理し、`MeasureItem`と`DrawItem`イベントです。 `MeasureItem`イベントでは前に、の項目のサイズを指定することができます、`DrawItem`その項目に対してイベントが発生します。  
+  
+ 詳細については、コード例を含む、次のトピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.ListBox.DrawMode%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ListBox.MeasureItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ListBox.DrawItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ComboBox.DrawMode%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ComboBox.MeasureItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ComboBox.DrawItem?displayProperty=fullName>  
+  
+-   [方法: ComboBox コントロールに変数のサイズのテキストを作成します。](../../../../docs/framework/winforms/controls/how-to-create-variable-sized-text-in-a-combobox-control.md)  
+  
+### <a name="menuitem-component"></a>MenuItem コンポーネント  
+ <xref:System.Windows.Forms.MenuItem>コンポーネント内の&1; つのメニュー項目を表す、 <xref:System.Windows.Forms.MainMenu>または<xref:System.Windows.Forms.ContextMenu>コンポーネントです。  
+  
+ 描画する、 <xref:System.Windows.Forms.MenuItem>、設定、`OwnerDraw`プロパティを`true`処理とその`DrawItem`イベントです。 前にメニュー項目のサイズをカスタマイズする、`DrawItem`イベントが発生する処理、項目の`MeasureItem`イベントです。  
+  
+ 詳細については、コード例を含む次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.MenuItem.OwnerDraw%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.MenuItem.DrawItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.MenuItem.MeasureItem?displayProperty=fullName>  
+  
+### <a name="tabcontrol-control"></a>TabControl コントロール  
+ <xref:System.Windows.Forms.TabControl>コントロールでは、コントロール内の各タブを描画することができます。 オーナー描画タブのみに影響を与えます<xref:System.Windows.Forms.TabPage>内容が影響を受けません。  
+  
+ 各タブを描画する、 <xref:System.Windows.Forms.TabControl>、設定されて、`DrawMode`プロパティを<xref:System.Windows.Forms.TabDrawMode>を処理し、`DrawItem`イベントです。 タブがコントロールに表示されている場合にのみ、このイベントは各タブに&1; 回発生します。  
+  
+ 詳細については、コード例を含む次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.TabControl.DrawMode%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.TabControl.DrawItem?displayProperty=fullName>  
+  
+### <a name="tooltip-component"></a>ToolTip コンポーネント  
+ <xref:System.Windows.Forms.ToolTip>コンポーネントでは、表示された場合、全体のツールヒントを描画することができます。  
+  
+ 描画する、<xref:System.Windows.Forms.ToolTip>、設定、`OwnerDraw`プロパティを`true`処理とその`Draw`イベントです。 サイズをカスタマイズする、<xref:System.Windows.Forms.ToolTip>する前に、`Draw`処理イベントが発生する、`Popup`イベントと、 <xref:System.Windows.Forms.PopupEventArgs.ToolTipSize%2A>イベント ハンドラーのプロパティです。  
+  
+ 詳細については、コード例を含む次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolTip.OwnerDraw%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ToolTip.Draw?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ToolTip.Popup?displayProperty=fullName>  
+  
+### <a name="listview-control"></a>ListView コントロール  
+ <xref:System.Windows.Forms.ListView>コントロールでは、コントロール内の個々 のアイテム、サブ項目、および列ヘッダーを描画することができます。  
+  
+ コントロールのオーナー描画を有効にするには設定、`OwnerDraw`プロパティを`true`します。  
+  
+ コントロール内の各項目を描画するには、処理、`DrawItem`イベントです。  
+  
+ コントロール内の各サブ項目または列ヘッダーを描画するときに、<xref:System.Windows.Forms.ListView.View%2A>にプロパティが設定されている<xref:System.Windows.Forms.View>、処理、`DrawSubItem`と`DrawColumnHeader`イベントです。  
+  
+ 詳細については、コード例を含む次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.ListView.OwnerDraw%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ListView.DrawItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ListView.DrawSubItem?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.ListView.DrawColumnHeader?displayProperty=fullName>  
+  
+### <a name="treeview-control"></a>TreeView コントロール  
+ <xref:System.Windows.Forms.TreeView>コントロールでは、コントロール内の個々 のノードを描画することができます。  
+  
+ 各ノードに表示されるテキストのみを描画する設定、`DrawMode`プロパティを<xref:System.Windows.Forms.TreeViewDrawMode>を処理し、`DrawNode`テキストを描画するイベントです。  
+  
+ 各ノードのすべての要素を描画する設定、`DrawMode`プロパティを<xref:System.Windows.Forms.TreeViewDrawMode>を処理し、`DrawNode`ノードを結ぶ線とテキスト、アイコン、チェック ボックス、プラスとマイナス記号 ($) などに必要な任意の要素を描画するイベントです。  
+  
+ 詳細については、コード例を含む次のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.TreeView.DrawMode%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.TreeView.DrawNode?displayProperty=fullName>  
+  
+### <a name="datagridview-control"></a>DataGridView コントロール  
+ <xref:System.Windows.Forms.DataGridView>コントロールでは、コントロール内の個々 のセルおよび行を描画することができます。  
+  
+ 個々 のセルを描画する、`CellPainting`イベントです。  
+  
+ 個々 の行または行の要素を描画する処理の一方または両方、`RowPrePaint`と`RowPostPaint`イベントです。 `RowPrePaint`行内のセルを描画する前に、イベントが発生して、`RowPostPaint`イベント セルが描画された後に発生します。 両方のイベントを処理して、`CellPainting`とは別に、行の背景、個々 のセルおよび行の前景色の描画にイベントまたはするには、場所と必要とするそれらの行の他の要素の既定の表示を使用して特定のカスタマイズを提供できます。  
+  
+ 詳細については、コード例を含む、次のトピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView.CellPainting>  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowPrePaint>  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowPostPaint>  
+  
+-   [方法: Windows フォーム DataGridView コントロール内のセルの外観をカスタマイズします。](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)  
+  
+-   [方法: Windows フォーム DataGridView コントロール内の行の外観をカスタマイズします。](../../../../docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md)  
+  
+### <a name="toolstrip-control"></a>ToolStrip コントロール  
+ <xref:System.Windows.Forms.ToolStrip>派生コントロールの外観のさまざまな面をカスタマイズすることを有効にするとします。  
+  
+ カスタム表示を提供する<xref:System.Windows.Forms.ToolStrip>コントロール、設定、`Renderer`のプロパティ、 <xref:System.Windows.Forms.ToolStrip>、 <xref:System.Windows.Forms.ToolStripManager>、 <xref:System.Windows.Forms.ToolStripPanel>、または<xref:System.Windows.Forms.ToolStripContentPanel>に、`ToolStripRenderer`オブジェクトし、1 つ以上によって提供される多くの描画イベントの処理、`ToolStripRenderer`クラスです。 また、設定、`Renderer`から派生した独自のクラスのインスタンスにプロパティ`ToolStripRenderer`、 <xref:System.Windows.Forms.ToolStripProfessionalRenderer>、または<xref:System.Windows.Forms.ToolStripSystemRenderer>を実装またはオーバーライド特定`On` *EventName*メソッドです。  
+  
+ 詳細については、コード例を含む、次のトピックを参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolStripRenderer>  
+  
+-   [方法: 作成し、Windows フォームに ToolStrip コントロールのカスタム レンダラーを設定](../../../../docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md)  
+  
+-   [方法: ToolStrip コントロールをカスタム描画](../../../../docs/framework/winforms/controls/how-to-custom-draw-a-toolstrip-control.md)  
+  
+## <a name="see-also"></a>関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-a-basic-wf-toolstrip-with-standard-items-using-the-designer.md b/docs/framework/winforms/controls/create-a-basic-wf-toolstrip-with-standard-items-using-the-designer.md
new file mode 100644
index 00000000000..e3677623f1e
--- /dev/null
+++ b/docs/framework/winforms/controls/create-a-basic-wf-toolstrip-with-standard-items-using-the-designer.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : デザイナーを使用して標準アイテムで基本的な Windows フォーム ToolStrip を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], 追加 (アイテムを)"
+  - "ツール バー [Windows フォーム], 作成"
+  - "ToolStrip コントロール [Windows フォーム], 追加 (標準項目を)"
+  - "ToolStrip コントロール [Windows フォーム], 作成"
+ms.assetid: 028deb1a-acf8-4911-979a-ba8431cd9d82
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : デザイナーを使用して標準アイテムで基本的な Windows フォーム ToolStrip を作成する
+<xref:System.Windows.Forms.ToolStrip> を作成し、標準的なタスクを表す 7 つの <xref:System.Windows.Forms.ToolStripButton> コントロールを追加する方法を次の手順に示します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーで標準アイテムを追加するには  
+  
+1.  <xref:System.Windows.Forms.ToolStrip> コントロールを作成します。  
+  
+2.  <xref:System.Windows.Forms.ToolStrip> の右上隅のスマート タスク矢印をクリックして **ToolStrip タスク** ペインを表示します。  
+  
+3.  **ToolStrip タスク** ペインの **\[標準項目の挿入\]** を選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md b/docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md
new file mode 100644
index 00000000000..4b242cc64b2
--- /dev/null
+++ b/docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CheckedListBox コントロール [Windows フォーム], 作成 (ルックアップ テーブルを)"
+  - "コンボ ボックス, ルックアップ テーブル"
+  - "ComboBox コントロール [Windows フォーム], ルックアップ テーブル"
+  - "リスト ボックス, ルックアップ テーブル"
+  - "ListBox コントロール [Windows フォーム], 作成 (ルックアップ テーブルを)"
+  - "ListBox コントロール [Windows フォーム], ルックアップ テーブル"
+  - "ルックアップ テーブル"
+  - "ルックアップ テーブル, 作成 (コントロールの)"
+ms.assetid: 4ce35f12-1f4e-4317-92d1-af8686a8cfaa
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する
+Windows フォーム上ではわかりやすい形式でデータを表示し、一方プログラムにはより意味のある形式でデータを格納すると便利な場合があります。  たとえば、食品の注文書の場合、リスト ボックスにメニュー項目が名前で表示されます。  一方、注文を記録するデータ テーブルには、食品を表す一意の ID 番号が含まれることになります。  次の表は、食品の注文書データを格納および表示する方法の例を示しています。  
+  
+### OrderDetailsTable  
+  
+|OrderID|ItemID|数量|  
+|-------------|------------|--------|  
+|4085|12|1|  
+|4086|13|3|  
+  
+### ItemTable  
+  
+|ID|名前|  
+|--------|--------|  
+|12|ポテト|  
+|13|チキン|  
+  
+ このシナリオでは、表示と保存に関係する実際の情報が、OrderDetailsTable という 1 つのテーブルに格納されます。  しかし、スペースを節約するために、これはかなり謎めいた方法で実行されます。  もう一方のテーブル \(OrdersTable\) には、どの ID 番号がどの食品名に相当するかという見かけ上の情報のみが含まれ、実際の食品の注文についての情報はありません。  
+  
+ ItemTable は、3 つのプロパティを介して <xref:System.Windows.Forms.ComboBox>、<xref:System.Windows.Forms.ListBox>、または <xref:System.Windows.Forms.CheckedListBox> コントロールに接続されます。   `DataSource`  プロパティには、このテーブルの名前が含まれます。   `DisplayMember` プロパティには、コントロール \(食品名\) に表示する、そのテーブルのデータ列が含まれます。   `ValueMember`  プロパティには、格納された情報 \(ID 番号\) が入った、そのテーブルのデータ列が含まれます。  
+  
+ OrderDetailsTable は、<xref:System.Windows.Forms.Control.DataBindings%2A> プロパティを介してアクセスされるそのバインディング コレクションにより、コントロールに接続されます。  バインディング オブジェクトをコレクションに追加すると、データ ソース \(OrderDetailsTable\) 内の特定のデータ メンバー \(ID 番号の列\) にコントロール プロパティが接続されます。  コントロールで選択がなされる際、このテーブルはフォーム入力が保存される場所です。  
+  
+### ルックアップ テーブルを作成するには  
+  
+1.  フォームに <xref:System.Windows.Forms.ComboBox>、<xref:System.Windows.Forms.ListBox>、または <xref:System.Windows.Forms.CheckedListBox> コントロールを追加します。  
+  
+2.  データ ソースに接続します。  
+  
+3.  2 つのテーブル間のデータ リレーションシップを確立します。  「[DataRelation オブジェクトの概要](../Topic/Introduction%20to%20DataRelation%20Objects.md)」を参照してください。  
+  
+4.  次のプロパティを設定します。  これらはコードまたはデザイナーで設定できます。  
+  
+    |プロパティ|設定|  
+    |-----------|--------|  
+    |<xref:System.Windows.Forms.ListControl.DataSource%2A>|どの ID 番号がどの項目に相当するかについての情報を含むテーブル。  上記のシナリオでは、これは  `ItemTable` です。|  
+    |<xref:System.Windows.Forms.ListControl.DisplayMember%2A>|コントロールに表示するデータ ソース テーブルの列。  上記のシナリオでは、これは  `"Name"`  です \(コードで設定する場合は引用符を使用\)。|  
+    |<xref:System.Windows.Forms.ListControl.ValueMember%2A>|格納された情報を含むデータ ソース テーブルの列。  上記のシナリオでは、これは  `"ID"`  です \(コードで設定する場合は引用符を使用\)。|  
+  
+5.  プロシージャで <xref:System.Windows.Forms.ControlBindingsCollection> クラスの <xref:System.Windows.Forms.ControlBindingsCollection.Add%2A> メソッドを呼び出して、フォーム入力を記録するテーブルにコントロールの <xref:System.Windows.Forms.ListControl.SelectedValue%2A> プロパティをバインドします。  この操作は、コードでなくデザイナーでも可能です。その場合は、\[**プロパティ**\] ウィンドウでコントロールの <xref:System.Windows.Forms.Control.DataBindings%2A> プロパティにアクセスします。  上記のシナリオでは、これは  `OrderDetailsTable` であり、列は  `"ItemID"` です。  
+  
+    ```vb  
+    ListBox1.DataBindings.Add("SelectedValue", OrderDetailsTable, "ItemID")  
+  
+    ```  
+  
+    ```csharp  
+    listBox1.DataBindings.Add("SelectedValue", OrderDetailsTable, "ItemID");  
+  
+    ```  
+  
+## 参照  
+ [データ連結と Windows フォーム](../../../../docs/framework/winforms/data-binding-and-windows-forms.md)   
+ [ListBox コントロールの概要](../../../../docs/framework/winforms/controls/listbox-control-overview-windows-forms.md)   
+ [ComboBox コントロールの概要](../../../../docs/framework/winforms/controls/combobox-control-overview-windows-forms.md)   
+ [CheckedListBox コントロールの概要](../../../../docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md b/docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md
new file mode 100644
index 00000000000..5a06de66860
--- /dev/null
+++ b/docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター/詳細形式のフォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "02/15/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], マスター/詳細形式のフォーム"
+  - "マスター/詳細リスト, 作成"
+  - "親/子テーブル, 表示 (Windows フォームに)"
+ms.assetid: 99f6e876-3f7f-4139-9063-e36587c95b02
+caps.latest.revision: 23
+author: "stevehoag"
+ms.author: "shoag"
+manager: "wpickett"
+---
+# 方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター/詳細形式のフォームを作成する
+次のコード例では、2 つの <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドされた 2 つの <xref:System.Windows.Forms.DataGridView> コントロールを使用してマスター\/詳細フォームを作成します。  データ ソースが、Northwind SQL Server のサンプル データベース、および `CustomerID` 列により 2 つに関連する <xref:System.Data.DataRelation> からの `Customers` テーブルと `Orders` テーブルを含む <xref:System.Data.DataSet> です。  
+  
+ 1 つの <xref:System.Windows.Forms.BindingSource> はデータセットの親 `Customers` テーブルにバインドされます。  このデータは、マスタ <xref:System.Windows.Forms.DataGridView> コントロールに表示されます。  もう一方の <xref:System.Windows.Forms.BindingSource> は、最初のデータ コネクタにバインドされます。  2 つ目の <xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.DataMember%2A> プロパティは、<xref:System.Data.DataRelation> の名前に設定されます。  これにより、関連付けられている詳細の <xref:System.Windows.Forms.DataGridView> コントロールが、マスター <xref:System.Windows.Forms.DataGridView> コントロールの現在の行に対応する子の `Orders` テーブルの行を表示します。  
+  
+ このコード例の詳細な説明については、「[チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター\/詳細形式のフォームの作成](../../../../docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMasterDetails#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/CS/masterdetails.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewMasterDetails#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/VB/masterdetails.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Windows.Forms、および System.XML の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## .NET Framework セキュリティ  
+ 接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター\/詳細形式のフォームの作成](../../../../docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md)   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-a-multipane-user-interface-with-wf-using-the-designer.md b/docs/framework/winforms/controls/create-a-multipane-user-interface-with-wf-using-the-designer.md
new file mode 100644
index 00000000000..f5b45e2996c
--- /dev/null
+++ b/docs/framework/winforms/controls/create-a-multipane-user-interface-with-wf-using-the-designer.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : デザイナーを使用して Windows フォームでマルチペイン ユーザー インターフェイスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マルチペイン ユーザー インターフェイス"
+  - "SplitContainer コントロール [Windows フォーム], 使用 (デザイナーを)"
+  - "ユーザー インターフェイス, マルチペイン"
+ms.assetid: c3f9294d-a26c-4198-9242-f237f55f7573
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : デザイナーを使用して Windows フォームでマルチペイン ユーザー インターフェイスを作成する
+次の手順では、Microsoft Outlook で使用されているユーザー インターフェイスに似た**フォルダー**一覧、**メッセージ** ペイン、および**プレビュー** ペインを備えたマルチペイン ユーザー インターフェイスを作成します。  これは、主にコントロールをフォームにドッキングして作成します。  
+  
+ コントロールをドッキングするときは、どちらの親コンテナーの端にコントロールを固定するかを決定します。  <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定した場合、コントロールの右端が親コントロールの右端にドッキングされます。  さらに、コントロールがドッキングされた端は、そのコンテナー コントロールに合うようにサイズ変更されます。  <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティの機能の詳細については、「[方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)」を参照してください。  
+  
+ この手順は、機能を追加してアプリケーションを Microsoft Outlook のようにするのではなく、フォーム上に <xref:System.Windows.Forms.SplitContainer> などのコントロールを配置します。  
+  
+ このユーザー インターフェイスを作成するには、左側のパネルに <xref:System.Windows.Forms.TreeView> コントロールを含む <xref:System.Windows.Forms.SplitContainer> コントロール内に、すべてのコントロールを配置します。  <xref:System.Windows.Forms.SplitContainer> コントロールの右側のパネルには、第 2 の <xref:System.Windows.Forms.SplitContainer> コントロールが含まれます。第 2 のコントロールでは、上部に <xref:System.Windows.Forms.ListView> コントロール、その下部に <xref:System.Windows.Forms.RichTextBox> コントロールが配置されます。  これらの <xref:System.Windows.Forms.SplitContainer> コントロールを使用すると、フォーム上の他のコントロールを個別にサイズ変更できます。  この手順に示される手法を応用して、独自のカスタム ユーザー インターフェイスを作成できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時に Outlook スタイルのユーザー インターフェイスを作成するには  
+  
+1.  新しい Windows アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **\[ツールボックス\]** から <xref:System.Windows.Forms.SplitContainer> コントロールをフォームにドラッグします。  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+3.  **\[ツールボックス\]** から <xref:System.Windows.Forms.TreeView> コントロールを <xref:System.Windows.Forms.SplitContainer> コントロールの左側のパネルにドラッグします。  **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。これを行うには、値エディター \(下向きの矢印をクリックすると表示されるエディター\) で左側のパネルをクリックします。  
+  
+4.  **\[ツールボックス\]** から別の <xref:System.Windows.Forms.SplitContainer> コントロールをドラッグします。このコントロールは、既にフォームに追加している <xref:System.Windows.Forms.SplitContainer> コントロールの右側のパネルに配置します。  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に、<xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティを <xref:System.Windows.Forms.Orientation> に設定します。  
+  
+5.  **\[ツールボックス\]** から <xref:System.Windows.Forms.ListView> コントロールを、フォームに追加した第 2 の <xref:System.Windows.Forms.SplitContainer> コントロールの上部パネルにドラッグします。  <xref:System.Windows.Forms.ListView> コントロールの <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+6.  **\[ツールボックス\]** から <xref:System.Windows.Forms.RichTextBox> コントロールを、第 2 の <xref:System.Windows.Forms.SplitContainer> コントロールの下部パネルにドラッグします。  <xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+     この時点で F5 キーを押してアプリケーションを実行すると、フォームには、Microsoft Outlook で使用されるような 3 つの部分に分かれたユーザー インターフェイスが表示されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.SplitContainer> コントロール内のいずれかの境界線上にマウス ポインターを移動すると、内部寸法のサイズを変更できます。  
+  
+     アプリケーション開発のこの時点で、非常に洗練されたユーザー インターフェイスが作成されました。  次の手順では、<xref:System.Windows.Forms.TreeView> コントロールと <xref:System.Windows.Forms.ListView> コントロールをデータ ソースに連結して、アプリケーション自体のプログラミングに進みます。  コントロールのデータへの連結の詳細については、「[データ連結と Windows フォーム](../../../../docs/framework/winforms/data-binding-and-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md b/docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md
new file mode 100644
index 00000000000..88e7047c061
--- /dev/null
+++ b/docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md
@@ -0,0 +1,108 @@
+---
+title: "方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ツール バー [Windows フォーム], 描画"
+  - "ToolStrip コントロール [Windows フォーム], カスタムの描画"
+  - "ToolStrip コントロール [Windows フォーム], 描画"
+ms.assetid: 88a804ba-679f-4ba3-938a-0dc396199c5b
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する
+<xref:System.Windows.Forms.ToolStrip> コントロールは、テーマとスタイルを簡単に設定するための機能をサポートします。  <xref:System.Windows.Forms.ToolStrip.Renderer%2A?displayProperty=fullName> プロパティまたは <xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=fullName> プロパティをカスタム レンダラーに設定すると、まったく独自の外観と操作性 \(ルック アンド フィール\) を実現できます。  
+  
+ <xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.ContextMenuStrip>、または <xref:System.Windows.Forms.StatusStrip> の各コントロールに個別にレンダラーを割り当てたり、<xref:System.Windows.Forms.ToolStrip.RenderMode%2A?displayProperty=fullName> プロパティを <xref:System.Windows.Forms.ToolStripRenderMode?displayProperty=fullName> に設定してすべてのオブジェクトに作用する <xref:System.Windows.Forms.ToolStripManager.Renderer%2A> プロパティを使用したりできます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip.RenderMode%2A> は、<xref:System.Windows.Forms.ToolStrip.Renderer%2A?displayProperty=fullName> の値が `null` ではない場合のみ、<xref:System.Windows.Forms.ToolStripRenderMode> を返します。  
+  
+### カスタム レンダラーを作成するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripRenderer> クラスを拡張します。  
+  
+2.  適切な *On…* メンバーをオーバーライドして目的のカスタム レンダリング機能を実装します。  
+  
+    ```vb  
+    Public Class RedTextRenderer  
+        Inherits System.Windows.Forms.ToolStripRenderer  
+        Protected Overrides Sub OnRenderItemText(ByVal e As _  
+            ToolStripItemTextRenderEventArgs)   
+            e.TextColor = Color.Red  
+            e.TextFont = New Font("Helvetica", 7, FontStyle.Bold)  
+            MyBase.OnRenderItemText(e)  
+        End Sub  
+    End Class  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    public class RedTextRenderer : _  
+        System.Windows.Forms.ToolStripRenderer  
+    {  
+        protected override void _  
+            OnRenderItemText(ToolStripItemTextRenderEventArgs e)  
+        {  
+            e.TextColor = Color.Red;  
+            e.TextFont = new Font("Helvetica", 7, FontStyle.Bold);  
+           base.OnRenderItemText(e);  
+        }  
+    }  
+  
+    ```  
+  
+### カスタム レンダラーを現在のレンダラーとして設定するには  
+  
+1.  特定の<xref:System.Windows.Forms.ToolStrip> に対してカスタム レンダラーを設定するには、<xref:System.Windows.Forms.ToolStrip.Renderer%2A?displayProperty=fullName> プロパティをカスタム レンダラーに設定します。  
+  
+    ```vb  
+    toolStrip1.Renderer = New RedTextRenderer()  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    toolStrip1.Renderer = new RedTextRenderer();  
+  
+    ```  
+  
+2.  または、アプリケーションに含まれるすべての <xref:System.Windows.Forms.ToolStrip> クラスに対してカスタム レンダラーを設定するには、<xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=fullName> プロパティをカスタム レンダラーに設定し、<xref:System.Windows.Forms.ToolStrip.RenderMode%2A> プロパティを <xref:System.Windows.Forms.ToolStripRenderMode> に設定します。  
+  
+    ```vb  
+    toolStrip1.RenderMode = ToolStripRenderMode.ManagerRenderMode  
+    ToolStripManager.Renderer = New RedTextRenderer()  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    toolStrip1.RenderMode = ToolStripRenderMode.ManagerRenderMode;  
+    ToolStripManager.Renderer = new RedTextRenderer();  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripManager.Renderer%2A>   
+ <xref:System.Windows.Forms.ToolStripRenderer>   
+ <xref:System.Windows.Forms.ToolStrip.RenderMode%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/create-master-details-lists-with-wf-datagrid-control-using-the-designer.md b/docs/framework/winforms/controls/create-master-details-lists-with-wf-datagrid-control-using-the-designer.md
new file mode 100644
index 00000000000..f9bc40dbf1f
--- /dev/null
+++ b/docs/framework/winforms/controls/create-master-details-lists-with-wf-datagrid-control-using-the-designer.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : デザイナーで Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGrid コントロール [Windows フォーム], マスター/詳細リスト"
+  - "マスター/詳細リスト"
+  - "関連テーブル, 表示 (DataGrid コントロールで)"
+ms.assetid: 19438ba2-f687-4417-a2fb-ab1cd69d4ded
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイナーで Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Data.DataSet> に一連の互いに関連するテーブルが含まれている場合は、2 つの <xref:System.Windows.Forms.DataGrid> コントロールを使用してデータをマスター\/詳細形式で表示できます。  一方の <xref:System.Windows.Forms.DataGrid> をマスター グリッドに指定し、もう一方を詳細グリッドに指定します。  マスター リストのエントリを選択すると、関連するすべての子エントリが詳細リストに表示されます。  たとえば、<xref:System.Data.DataSet> に Customers テーブルおよび関連する Orders テーブルが含まれている場合は、Customers テーブルをマスター グリッドに指定し、Orders テーブルを詳細グリッドに指定します。  マスター グリッドから顧客が選択されると、Orders テーブル内でその顧客に関連するすべての注文が、詳細グリッドに表示されます。  
+  
+ 次の手順には、**Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーでマスター\/詳細リストを作成するには  
+  
+1.  フォームに 2 つの <xref:System.Windows.Forms.DataGrid> コントロールを追加します。  詳細については、「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、既定で <xref:System.Windows.Forms.DataGrid> コントロールは**ツールボックス**に含まれていません。  詳細については、「[How to: Add Items to the Toolbox](http://msdn.microsoft.com/ja-jp/458e119e-17fe-450b-b889-e31c128bd7e0)」を参照してください。  
+  
+    > [!NOTE]
+    >  以下の手順は、[!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] には当てはまりません。[!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、**\[データ ソース\]** ウィンドウを使ってデザイン時のデータ バインディングを設定します。  詳細については、「[Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)」および「[方法: 関連するデータを Windows フォーム アプリケーションに表示する](../Topic/How%20to:%20Display%20Related%20Data%20in%20a%20Windows%20Forms%20Application.md)」を参照してください。  
+  
+2.  **サーバー エクスプローラー**から 2 つ以上のテーブルをフォームにドラッグします。  
+  
+3.  **\[データ\]** メニューの **\[データセットの生成\]** をクリックします。  
+  
+4.  XML デザイナーを使用して、テーブル間にリレーションシップを設定します。  詳細については、MSDN の「方法 : XML スキーマとデータセットに一対多リレーションシップを作成する」を参照してください。  
+  
+5.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、リレーションシップを保存します。  
+  
+6.  マスター グリッドに指定する <xref:System.Windows.Forms.DataGrid> コントロールを以下のように設定します。  
+  
+    1.  <xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティのドロップダウン リストで <xref:System.Data.DataSet> を選択します。  
+  
+    2.  <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティのドロップダウン リストでマスター テーブル \(たとえば、"Customers"\) を選択します。  
+  
+7.  詳細グリッドに指定する <xref:System.Windows.Forms.DataGrid> コントロールを以下のように設定します。  
+  
+    1.  <xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティのドロップダウン リストで <xref:System.Data.DataSet> を選択します。  
+  
+    2.  <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティのドロップダウン リストでマスター テーブルと詳細テーブルの間のリレーションシップ \(たとえば、"Customers.CustOrd"\) を選択します。  リレーションシップを表示するには、ドロップダウン リストのマスター テーブルの横にあるプラス \(**\+**\) 記号をクリックして、ノードを展開します。  
+  
+## 参照  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)   
+ [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)   
+ [Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md b/docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md
new file mode 100644
index 00000000000..7fec0963df2
--- /dev/null
+++ b/docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md
@@ -0,0 +1,88 @@
+---
+title: "チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター/詳細形式のフォームの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "02/15/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], マスター/詳細形式のフォーム"
+  - "マスター/詳細リスト, 表示 (Windows フォームに)"
+  - "親/子テーブル, 表示 (Windows フォームに)"
+  - "チュートリアル [Windows フォーム], DataGridView コントロール"
+ms.assetid: c5fa29e8-47f7-4691-829b-0e697a691f36
+caps.latest.revision: 19
+author: "stevehoag"
+ms.author: "shoag"
+manager: "wpickett"
+---
+# チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター/詳細形式のフォームの作成
+<xref:System.Windows.Forms.DataGridView> コントロールの使用用途で特によくあるのが、*マスター\/詳細形式*のフォームです。これは、2 つのデータベース テーブル間の親子のリレーションシップを表示するフォームです。  マスター テーブルの行を選択すると、それに対応する子データによって詳細テーブルが更新されます。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールと <xref:System.Windows.Forms.BindingSource> コンポーネントの間の対応を使用すると、マスター\/詳細形式のフォームを簡単に実装できます。  このチュートリアルでは、2 つの <xref:System.Windows.Forms.DataGridView> コントロールと 2 つの <xref:System.Windows.Forms.BindingSource> コンポーネントを使用してフォームを作成します。  このフォームには、`Customers` と `Orders` という、SQL Server の Northwind サンプル データベースの互いに関連付けられた 2 つのテーブルが表示されます。  完成したフォームでは、データベースに格納されているすべての顧客がマスター <xref:System.Windows.Forms.DataGridView> に表示され、選択した顧客に対応するすべての注文が詳細 <xref:System.Windows.Forms.DataGridView> に表示されます。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター\/詳細形式のフォームを作成する](../../../../docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Northwind SQL Server サンプル データベースがインストールされたサーバーへのアクセス  
+  
+## フォームの作成  
+  
+#### マスター\/詳細形式のフォームを作成するには  
+  
+1.  <xref:System.Windows.Forms.Form> から派生した、2 つの <xref:System.Windows.Forms.DataGridView> コントロールと 2 つの <xref:System.Windows.Forms.BindingSource> コンポーネントを持つクラスを作成します。  次のコードは、基本的な形式の初期化処理です。この中には `Main` メソッドも含まれています。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] デザイナーを使用してフォームを作成した場合には、デザイナーによって生成されたコードをこのコードの代わりに使用できますが、この変数宣言で示されている名前を必ず使用してください。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMasterDetails#01](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/CS/masterdetails.cs#01)]
+     [!code-vb[System.Windows.Forms.DataGridViewMasterDetails#01](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/VB/masterdetails.vb#01)]  
+    [!code-csharp[System.Windows.Forms.DataGridViewMasterDetails#02](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/CS/masterdetails.cs#02)]
+    [!code-vb[System.Windows.Forms.DataGridViewMasterDetails#02](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/VB/masterdetails.vb#02)]  
+  
+2.  データベースへの接続の詳細を処理するためのメソッドを、フォームのクラス定義に実装します。  この例では、`GetData` というメソッドを使用しています。このメソッドでは、<xref:System.Data.DataSet> オブジェクトにレコードを読み込み、<xref:System.Data.DataRelation> オブジェクトをデータセットに追加し、<xref:System.Windows.Forms.BindingSource> コンポーネントをバインドします。  `connectionString` 変数の値は、使用するデータベースに合わせた適切な値に設定してください。  
+  
+    > [!IMPORTANT]
+    >  接続文字列内にパスワードなどの機密情報を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMasterDetails#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/CS/masterdetails.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewMasterDetails#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/VB/masterdetails.vb#20)]  
+  
+3.  フォームの <xref:System.Windows.Forms.Form.Load> イベントのハンドラーを実装します。この中では、<xref:System.Windows.Forms.DataGridView> コントロールを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドし、`GetData` メソッドを呼び出します。  次の例には、表示するデータに合わせて <xref:System.Windows.Forms.DataGridView> の列のサイズを変更するコードが含まれています。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMasterDetails#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/CS/masterdetails.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewMasterDetails#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMasterDetails/VB/masterdetails.vb#10)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   アプリケーションをコンパイルして実行します。  
+  
+     2 つの <xref:System.Windows.Forms.DataGridView> コントロールが上下に並んで表示されます。  Northwind の `Customers` テーブルの顧客が上に表示され、選択した顧客に対応する `Orders` が下に表示されます。  上の <xref:System.Windows.Forms.DataGridView> で別の行を選択すると、それに応じて下の <xref:System.Windows.Forms.DataGridView> の内容が変更されます。  
+  
+## 次の手順  
+ このアプリケーションでは、<xref:System.Windows.Forms.DataGridView> コントロールの機能について基本を理解できます。  次のような方法を使用すると、<xref:System.Windows.Forms.DataGridView> コントロールの外観および動作をカスタマイズできます。  
+  
+-   輪郭およびヘッダー スタイルを変更します。  詳細については、「[方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力の許可または制限。  詳細については、「[方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)」および「[方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力を検証します。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   仮想モードを使用した大量のデータの処理。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+-   セルの外観をカスタマイズします。  詳細については、「[方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)」および「[方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター\/詳細形式のフォームを作成する](../../../../docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md b/docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md
new file mode 100644
index 00000000000..e2b0d6542aa
--- /dev/null
+++ b/docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md
@@ -0,0 +1,652 @@
+---
+title: "チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "デザイン時機能, Windows フォーム"
+  - "DocumentDesigner クラス [Windows フォーム]"
+  - "チュートリアル [Windows フォーム], コントロール"
+  - "Windows フォーム コントロール, 作成"
+ms.assetid: 6f487c59-cb38-4afa-ad2e-95edacb1d626
+caps.latest.revision: 46
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 46
+---
+# チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成
+カスタム コントロールのデザイン時の操作性は、関連付けられたカスタム デザイナーを作成することで向上させることができます。  
+  
+ このチュートリアルでは、カスタム コントロールのカスタム デザイナーを作成する方法について説明します。  ここでは、`MarqueeControl` 型と、それに関連付けられた `MarqueeControlRootDesigner` というデザイナー クラスを実装します。  
+  
+ `MarqueeControl` 型は、光のアニメーションを表示し、テキストが点滅する、劇場の看板のようなディスプレイを実装します。  
+  
+ このコントロールのデザイナーは、デザイン環境と対話して、独自のデザイン時操作を提供します。  カスタム デザイナーを使用すると、光のアニメーションと点滅するテキストを多彩に組み合わせたカスタム `MarqueeControl` 実装をアセンブルできます。  アセンブルされたコントロールは、他の Windows フォーム コントロールと同じようにフォーム上で使用できます。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトの作成  
+  
+-   コントロール ライブラリ プロジェクトの作成  
+  
+-   カスタム コントロール プロジェクトの参照  
+  
+-   カスタム コントロールとそのカスタム デザイナーの定義  
+  
+-   カスタム コントロールのインスタンスの作成  
+  
+-   デザイン時デバッグのためのプロジェクト設定  
+  
+-   カスタム コントロールの実装  
+  
+-   カスタム コントロールの子コントロールの作成  
+  
+-   MarqueeBorder の子コントロールの作成  
+  
+-   プロパティをシャドウおよびフィルター処理するカスタム デザイナーの作成  
+  
+-   コンポーネントの変更処理  
+  
+-   カスタム デザイナーへのデザイナー動詞の追加  
+  
+-   カスタム UITypeEditor の作成  
+  
+-   デザイナーでのカスタム コントロールのテスト  
+  
+ 完成したカスタム コントロールは次のようになります。  
+  
+ ![可能な MarqueeControl 配置](../../../../docs/framework/winforms/controls/media/demomarqueecontrol.gif "DemoMarqueeControl")  
+  
+ 完全なコードの一覧については、「[How to: Create a Windows Forms Control That Takes Advantage of Design\-Time Features](../Topic/How%20to:%20Create%20a%20Windows%20Forms%20Control%20That%20Takes%20Advantage%20of%20Design-Time%20Features.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Visual Studio がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## プロジェクトの作成  
+ 最初にアプリケーション プロジェクトを作成します。  このプロジェクトを使用して、カスタム コントロールをホストするアプリケーションをビルドします。  
+  
+#### プロジェクトを作成するには  
+  
+-   "MarqueeControlTest" という名前の Windows フォーム アプリケーション プロジェクトを作成します。詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+## コントロール ライブラリ プロジェクトの作成  
+ 次に、コントロール ライブラリ プロジェクトを作成します。  新しいカスタム コントロールとそれに対応するカスタム デザイナーを作成します。  
+  
+#### コントロール ライブラリ プロジェクトを作成するには  
+  
+1.  Windows フォーム コントロール ライブラリ プロジェクトをソリューションに追加します。  プロジェクトに "MarqueeControlLibrary" という名前を付けます。  
+  
+2.  **ソリューション エクスプローラー**を使用して、選択した言語に応じて "UserControl1.cs" または "UserControl1.vb" という名前のソース ファイルを削除して、プロジェクトの既定のコントロールを削除します。  詳細については、「[NIB:How to: Remove, Delete, and Exclude Items](http://msdn.microsoft.com/ja-jp/6dffdc86-29c8-4eff-bcd8-e3a0dd9e9a73)」を参照してください。  
+  
+3.  新しい <xref:System.Windows.Forms.UserControl> アイテムを `MarqueeControlLibrary` プロジェクトに追加します。  新しいソース ファイルに、"MarqueeControl" という基本名を付けます。  
+  
+4.  **ソリューション エクスプローラー**を使用して、`MarqueeControlLibrary` プロジェクト内に新しいフォルダーを作成します。  詳細については、「[NIB:How to: Add New Project Items](http://msdn.microsoft.com/ja-jp/63d3e16b-de6e-4bb5-a0e3-ecec762201ce)」を参照してください。  新しいフォルダーに "Design" という名前を付けます。  
+  
+5.  **Design** フォルダーを右クリックして、新しいクラスを追加します。  ソース ファイルに、"MarqueeControlRootDesigner" という基本名を付けます。  
+  
+6.  System.Design アセンブリの型を使用して、この参照を `MarqueeControlLibrary` プロジェクトに追加する必要があります。  
+  
+    > [!NOTE]
+    >  System.Design アセンブリを使用するには、.NET Framework Client Profile ではなく、.NET Framework の完全バージョンをプロジェクトで対象とする必要があります。  ターゲット フレームワークを変更する方法については、「[方法: .NET Framework のバージョンをターゲットにする](../Topic/How%20to:%20Target%20a%20Version%20of%20the%20.NET%20Framework.md)」を参照してください。  
+  
+## カスタム コントロール プロジェクトの参照  
+ `MarqueeControlTest` プロジェクトを使用して、カスタム コントロールをテストします。  テスト プロジェクトは、`MarqueeControlLibrary` アセンブリにプロジェクト参照を追加すると、カスタム コントロールを認識します。  
+  
+#### カスタム コントロール プロジェクトを参照するには  
+  
+-   `MarqueeControlTest` プロジェクトで、プロジェクト参照を `MarqueeControlLibrary` アセンブリに追加します。  `MarqueeControlLibrary` アセンブリを直接参照する代わりに、必ず、**\[参照の追加\]** ダイアログ ボックスの **\[プロジェクト\]** タブを使用してください。  
+  
+## カスタム コントロールとそのカスタム デザイナーの定義  
+ カスタム コントロールは、<xref:System.Windows.Forms.UserControl> クラスから派生します。  これにより、カスタム コントロールに他のコントロールを含めることができ、既定の機能を豊富に割り当てることができます。  
+  
+ カスタム コントロールには、カスタム デザイナーが関連付けられます。  これにより、カスタム コントロールに特化された、独自のデザイン操作を実現できます。  
+  
+ カスタム コントロールをデザイナーに関連付けるには、<xref:System.ComponentModel.DesignerAttribute> クラスを使用します。  カスタム コントロールのデザイン時動作全体を開発するため、カスタム デザイナーは <xref:System.ComponentModel.Design.IRootDesigner> インターフェイスを実装します。  
+  
+#### カスタム コントロールとそのカスタム デザイナーを定義するには  
+  
+1.  `MarqueeControl` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に次の名前空間をインポートします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#220](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrol.cs#220)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#220](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrol.vb#220)]  
+  
+2.  <xref:System.ComponentModel.DesignerAttribute> を `MarqueeControl` クラス宣言に追加します。  これで、カスタム コントロールがデザイナーに関連付けられます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#240](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrol.cs#240)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#240](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrol.vb#240)]  
+  
+3.  `MarqueeControlRootDesigner` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に次の名前空間をインポートします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#520](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#520)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#520](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#520)]  
+  
+4.  <xref:System.Windows.Forms.Design.DocumentDesigner> クラスを継承するように `MarqueeControlRootDesigner` の宣言を変更します。  <xref:System.ComponentModel.ToolboxItemFilterAttribute> を適用して、デザイナーと**ツールボックス**との対話処理を指定します。  
+  
+     **メモ** `MarqueeControlRootDesigner` クラスの定義を、"MarqueeControlLibrary.Design" という名前空間に含めます。この宣言により、デザイン関連型用に予約されている特別な名前空間にデザイナーが配置されます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#530](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#530)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#530](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#530)]  
+  
+5.  `MarqueeControlRootDesigner` クラスのコンストラクターを定義します。  <xref:System.Diagnostics.Trace.WriteLine%2A> ステートメントをコンストラクター本体に挿入します。  これはデバッグに役立ちます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#540](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#540)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#540](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#540)]  
+  
+## カスタム コントロールのインスタンスの作成  
+ コントロールのデザイン時のカスタム動作を確認するために、コントロールのインスタンスを `MarqueeControlTest` プロジェクトのフォームに配置します。  
+  
+#### カスタム コントロールのインスタンスを作成するには  
+  
+1.  新しい <xref:System.Windows.Forms.UserControl> アイテムを `MarqueeControlTest` プロジェクトに追加します。  新しいソース ファイルに、"DemoMarqueeControl" という基本名を付けます。  
+  
+2.  `DemoMarqueeControl` ファイルを**コード エディター**で開きます。  ファイルの先頭に、次のように `MarqueeControlLibrary` 名前空間をインポートします。  
+  
+```vb  
+Imports MarqueeControlLibrary  
+```  
+  
+```csharp  
+using MarqueeControlLibrary;  
+```  
+  
+1.  `MarqueeControl` クラスを継承するように `DemoMarqueeControl` の宣言を変更します。  
+  
+2.  プロジェクトをビルドします。  
+  
+3.  Windows フォーム デザイナーで `Form1` を開きます。  
+  
+4.  **ツールボックス**の **\[MarqueeControlTest コンポーネント\]** タブを見つけて開きます。  **ツールボックス**の `DemoMarqueeControl` コントロールをフォームにドラッグします。  
+  
+5.  プロジェクトをビルドします。  
+  
+## デザイン時デバッグのためのプロジェクト設定  
+ デザイン時のカスタム操作を開発するときは、コントロールとコンポーネントのデバッグが必要になります。  プロジェクトでは、簡単な方法でデザイン時のデバッグを有効に設定できます。  詳細については、「[チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](../../../../docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md)」を参照してください。  
+  
+#### デザイン時デバッグのためにプロジェクトを設定するには  
+  
+1.  `MarqueeControlLibrary` プロジェクトを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  \[MarqueeControlLibrary プロパティ ページ\] ダイアログ ボックスで、**\[デバッグ\]** ページを選択します。  
+  
+3.  **\[開始動作\]** セクションで、**\[外部プログラムの開始\]** を選択します。  Visual Studio の別個のインスタンスをデバッグするので、省略記号 \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックして、Visual Studio IDE を参照します。  実行可能ファイルの名前は devenv.exe で、既定の場所にインストールした場合、ファイルのパスは "%programfiles%\\Microsoft Visual Studio 9.0\\Common7\\IDE\\devenv.exe" になります。  
+  
+4.  \[OK\] をクリックし、ダイアログ ボックスを閉じます。  
+  
+5.  `MarqueeControlLibrary` プロジェクトを右クリックし、\[スタートアップ プロジェクトに設定\] をクリックして、このデバッグ構成を有効にします。  
+  
+## チェックポイント  
+ これで、カスタム コントロールのデザイン時動作をデバッグできるようになりました。  デバッグ環境が適切に設定されていることを確認したら、カスタム コントロールとカスタム デザイナーの関連付けをテストします。  
+  
+#### デバッグ環境およびデザイナーとの関連付けをテストするには  
+  
+1.  **コード エディター**で `MarqueeControlRootDesigner` ソース ファイルを開き、<xref:System.Diagnostics.Trace.WriteLine%2A> ステートメントにブレークポイントを配置します。  
+  
+2.  F5 キーを押してデバッグ セッションを開始します。  Visual Studio の新しいインスタンスが作成されることを確認してください。  
+  
+3.  Visual Studio の新しいインスタンスで、"MarqueeControlTest" ソリューションを開きます。  **\[ファイル\]** メニューの **\[最近使ったプロジェクト\]** をクリックすると、ソリューションが簡単に見つかります。  "MarqueeControlTest.sln" ソリューション ファイルが、最後に使用したファイルとして表示されます。  
+  
+4.  デザイナーで `DemoMarqueeControl` を開きます。  Visual Studio のデバッグ インスタンスがフォーカスを取得し、ブレークポイントで実行が停止します。  F5 キーを押して、デバッグ セッションを継続します。  
+  
+ この時点で、カスタム コントロールとそれに関連付けられたカスタム デザイナーを開発し、デバッグする準備がすべて整いました。  このチュートリアルの残りの部分では、コントロールとデザイナーの機能の実装について詳しく説明します。  
+  
+## カスタム コントロールの実装  
+ `MarqueeControl` は、わずかにカスタマイズされた <xref:System.Windows.Forms.UserControl> コントロールです。  このコントロールは、マーキー アニメーションを開始する `Start` と、アニメーションを停止する `Stop` の 2 つのメソッドを公開します。  `MarqueeControl` は、`IMarqueeWidget` インターフェイスを実装する子コントロールを含むため、`Start` と `Stop` は各子コントロールを列挙し、`IMarqueeWidget` を実装する子コントロールごとに `StartMarquee` メソッドと `StopMarquee` メソッドをそれぞれ呼び出します。  
+  
+ `MarqueeBorder` コントロールと `MarqueeText` コントロールの外観はレイアウトによって異なるため、`MarqueeControl` は <xref:System.Windows.Forms.Control.OnLayout%2A> メソッドをオーバーライドし、同じ型の子コントロールで <xref:System.Windows.Forms.Control.PerformLayout%2A> を呼び出します。  
+  
+ これが `MarqueeControl` のカスタマイズの範囲です。  実行時の機能は、`MarqueeBorder` コントロールと `MarqueeText` コントロールによって実装され、デザイン時の機能は、`MarqueeBorderDesigner` クラスと `MarqueeControlRootDesigner` クラスによって実装されます。  
+  
+#### カスタム コントロールを実装するには  
+  
+1.  `MarqueeControl` ソース ファイルを**コード エディター**で開きます。  `Start` メソッドと `Stop` メソッドを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#260](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrol.cs#260)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#260](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrol.vb#260)]  
+  
+2.  <xref:System.Windows.Forms.Control.OnLayout%2A> メソッドをオーバーライドします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#270](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrol.cs#270)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#270](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrol.vb#270)]  
+  
+## カスタム コントロールの子コントロールの作成  
+ `MarqueeControl` は、`MarqueeBorder` コントロールと `MarqueeText` コントロールという 2 種類の子コントロールをホストします。  
+  
+-   `MarqueeBorder`: このコントロールは、その端に "光" の境界線を描画します。  光は連続して点滅するため、境界線を移動するように見えます。  光の点滅速度は、`UpdatePeriod` というプロパティで制御します。  コントロールのその他の外観は、これ以外のいくつかのカスタム プロパティによって設定します。  アニメーションの開始と停止は、`StartMarquee` および `StopMarquee` という 2 つのメソッドで制御します。  
+  
+-   `MarqueeText`: このコントロールは、点滅する文字列を描画します。  テキストの点滅速度は、`MarqueeBorder` コントロールと同様に `UpdatePeriod` プロパティで制御します。  また、`MarqueeText` コントロールには、`MarqueeBorder` コントロールと同様に `StartMarquee` メソッドと `StopMarquee` メソッドもあります。  
+  
+ デザイン時に `MarqueeControlRootDesigner` では、これら 2 種類のコントロールを自由に組み合わせて `MarqueeControl` に追加できます。  
+  
+ 2 つのコントロールの共通機能は、`IMarqueeWidget` というインターフェイスに組み込まれます。  これにより、`MarqueeControl` が Marquee 関連の子コントロールを探索し、特別に処理できます。  
+  
+ 周期的なアニメーション機能を実装するには、<xref:System.ComponentModel?displayProperty=fullName> 名前空間の <xref:System.ComponentModel.BackgroundWorker> オブジェクトを使用します。  <xref:System.Windows.Forms.Timer> オブジェクトを使用することもできますが、多くの `IMarqueeWidget` オブジェクトが存在するときは、単一の UI スレッドではアニメーションに対応できなくなることがあります。  
+  
+#### カスタム コントロールの子コントロールを作成するには  
+  
+1.  新しいクラス アイテムを `MarqueeControlLibrary` プロジェクトに追加します。  新しいソース ファイルに、"IMarqueeWidget" という基本名を付けます。  
+  
+2.  **コード エディター**で `IMarqueeWidget` ソース ファイルを開き、次のように `class` から `interface` に宣言を変更します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/imarqueewidget.cs#2)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/imarqueewidget.vb#2)]  
+  
+3.  次のコードを `IMarqueeWidget` インターフェイスに追加し、マーキー アニメーションを操作する 2 つのメソッドとプロパティを公開します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/imarqueewidget.cs#3)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/imarqueewidget.vb#3)]  
+  
+4.  新しい**カスタム コントロール** アイテムを `MarqueeControlLibrary` プロジェクトに追加します。  新しいソース ファイルに、"MarqueeText" という基本名を付けます。  
+  
+5.  **ツールボックス**の <xref:System.ComponentModel.BackgroundWorker> コンポーネントを `MarqueeText` コントロールにドラッグします。  このコンポーネントにより、`MarqueeText` コントロールが非同期的に更新されます。  
+  
+6.  \[プロパティ\] ウィンドウで、<xref:System.ComponentModel.BackgroundWorker> コンポーネントの `WorkerReportsProgess` プロパティと <xref:System.ComponentModel.BackgroundWorker.WorkerSupportsCancellation%2A> プロパティを `true` に設定します。  これらの設定により、<xref:System.ComponentModel.BackgroundWorker> コンポーネントが周期的に <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントを発生させたり、非同期の更新をキャンセルしたりできます。  詳細については、「[BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)」を参照してください。  
+  
+7.  `MarqueeText` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に次の名前空間をインポートします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#120](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#120)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#120](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#120)]  
+  
+8.  `MarqueeText` の宣言を次のように変更し、<xref:System.Windows.Forms.Label> を継承すると共に、`IMarqueeWidget` インターフェイスを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#130](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#130)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#130](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#130)]  
+  
+9. 公開されたプロパティに対応するインスタンス変数を宣言し、コンストラクターで初期化します。  `isLit` フィールドで、`LightColor` プロパティで指定された色でテキストを描画するかどうかを指定します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#140](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#140)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#140](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#140)]  
+  
+10. `IMarqueeWidget` インターフェイスを実装します。  
+  
+     `StartMarquee` メソッドと `StopMarquee` メソッドが、<xref:System.ComponentModel.BackgroundWorker> コンポーネントの <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドと <xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> メソッドを呼び出して、アニメーションを開始および停止します。  
+  
+     <xref:System.ComponentModel.CategoryAttribute.Category%2A> 属性と <xref:System.ComponentModel.BrowsableAttribute.Browsable%2A> 属性が `UpdatePeriod` プロパティに適用され、その結果、このプロパティが \[プロパティ\] ウィンドウの "Marquee" というカスタム セクションに表示されます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#150](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#150)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#150](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#150)]  
+  
+11. プロパティのアクセサーを実装します。  `LightColor` と `DarkColor` という 2 つのプロパティをクライアントに公開します。  <xref:System.ComponentModel.CategoryAttribute.Category%2A> 属性と <xref:System.ComponentModel.BrowsableAttribute.Browsable%2A> 属性がこれらのプロパティに適用され、その結果、これらのプロパティが \[プロパティ\] ウィンドウの "Marquee" というカスタム セクションに表示されます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#160](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#160)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#160](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#160)]  
+  
+12. <xref:System.ComponentModel.BackgroundWorker> コンポーネントの <xref:System.ComponentModel.BackgroundWorker.DoWork> イベントと <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントのハンドラーを実装します。  
+  
+     <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーは、`UpdatePeriod` で指定したミリ秒数の間スリープした後、コードが <xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> を呼び出してアニメーションを停止するまで <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントを発生させます。  
+  
+     <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベント ハンドラーは、テキストを明るい状態と暗い状態の間で切り替えて、点滅しているように表示します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#180](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#180)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#180](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#180)]  
+  
+13. <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドして、アニメーションを有効にします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#170](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueetext.cs#170)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#170](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueetext.vb#170)]  
+  
+14. F6 キーを押してソリューションをビルドします。  
+  
+## MarqueeBorder の子コントロールの作成  
+ `MarqueeBorder` コントロールは、`MarqueeText` コントロールよりもわずかに洗練されています。  このコントロールにはより多くのプロパティがあり、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドのアニメーションはより複雑になっています。  ただし、`MarqueeText` コントロールは基本的には MarqueeText コントロールと同じです。  
+  
+ `MarqueeBorder` コントロールは子コントロールを含むことができるので、<xref:System.Windows.Forms.Control.Layout> イベントを認識する必要があります。  
+  
+#### MarqueeBorder コントロールを作成するには  
+  
+1.  新しい**カスタム コントロール** アイテムを `MarqueeControlLibrary` プロジェクトに追加します。  新しいソース ファイルに、"MarqueeBorder" という基本名を付けます。  
+  
+2.  **ツールボックス**から <xref:System.ComponentModel.BackgroundWorker> コンポーネントを `MarqueeBorder` コントロールにドラッグします。  このコンポーネントにより、`MarqueeBorder` コントロールが非同期的に更新されます。  
+  
+3.  \[プロパティ\] ウィンドウで、<xref:System.ComponentModel.BackgroundWorker> コンポーネントの `WorkerReportsProgess` プロパティと <xref:System.ComponentModel.BackgroundWorker.WorkerSupportsCancellation%2A> プロパティを `true` に設定します。  これらの設定により、<xref:System.ComponentModel.BackgroundWorker> コンポーネントが周期的に <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントを発生させたり、非同期の更新をキャンセルしたりできます。  詳細については、「[BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)」を参照してください。  
+  
+4.  \[プロパティ\] ウィンドウの \[イベント\] をクリックします。  <xref:System.ComponentModel.BackgroundWorker.DoWork> イベントと <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントのハンドラーをアタッチします。  
+  
+5.  `MarqueeBorder` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に次の名前空間をインポートします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#20)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#20)]  
+  
+6.  `MarqueeBorder` の宣言を次のように変更し、<xref:System.Windows.Forms.Panel> を継承すると共に、`IMarqueeWidget` インターフェイスを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#30)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#30)]  
+  
+7.  `MarqueeBorder` コントロールの状態を管理する `MarqueeSpinDirection` と `MarqueeLightShape` の 2 つの列挙型を宣言します。前者は、光が境界線を "回る" 方向を指定し、後者は、光の形状 \(四角形または円形\) を指定します。  これらの宣言を、`MarqueeBorder` クラス宣言の前に配置します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#97](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#97)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#97](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#97)]  
+  
+8.  公開されたプロパティに対応するインスタンス変数を宣言し、コンストラクターで初期化します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#40](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#40)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#40](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#40)]  
+  
+9. `IMarqueeWidget` インターフェイスを実装します。  
+  
+     `StartMarquee` メソッドと `StopMarquee` メソッドが、<xref:System.ComponentModel.BackgroundWorker> コンポーネントの <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドと <xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> メソッドを呼び出して、アニメーションを開始および停止します。  
+  
+     `MarqueeBorder` コントロールは子コントロールを含むことができるので、`StartMarquee` メソッドは、すべての子コントロールを列挙し、`IMarqueeWidget` を実装する子コントロールで `StartMarquee` を呼び出します。  `StopMarquee` メソッドも同じような実装になります。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#50](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#50)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#50](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#50)]  
+  
+10. プロパティのアクセサーを実装します。  `MarqueeBorder` コントロールには、その外観を制御するプロパティがいくつかあります。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#60](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#60)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#60](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#60)]  
+  
+11. <xref:System.ComponentModel.BackgroundWorker> コンポーネントの <xref:System.ComponentModel.BackgroundWorker.DoWork> イベントと <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントのハンドラーを実装します。  
+  
+     <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーは、`UpdatePeriod` で指定したミリ秒数の間スリープした後、コードが <xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> を呼び出してアニメーションを停止するまで <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントを発生させます。  
+  
+     <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベント ハンドラーは、他の光の明暗の状態を決定するための基準になる "基本" 光の位置をインクリメントし、<xref:System.Windows.Forms.Control.Refresh%2A> メソッドを呼び出して、コントロール自体を再描画させます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#90](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#90)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#90](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#90)]  
+  
+12. `IsLit` ヘルパー メソッドと `DrawLight` ヘルパー メソッドを実装します。  
+  
+     `IsLit` メソッドは、特定の位置での光の色を指定します。  "点灯中" の光は、`LightColor` プロパティで指定された色で描画され、"暗い" 光は、`DarkColor` プロパティで指定された色で描画されます。  
+  
+     `DrawLight` メソッドは、適切な色、形状、および位置を使用して光を描画します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#80](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#80)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#80](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#80)]  
+  
+13. <xref:System.Windows.Forms.Control.OnLayout%2A> メソッドと <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドします。  
+  
+     <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドは、`MarqueeBorder` コントロールの端に沿って光を描画します。  
+  
+     <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドは、`MarqueeBorder` コントロールの寸法に依存するため、レイアウトを変更したときには必ず呼び出す必要があります。  このために、<xref:System.Windows.Forms.Control.OnLayout%2A> をオーバーライドして、<xref:System.Windows.Forms.Control.Refresh%2A> を呼び出します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#70](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#70)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#70](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#70)]  
+  
+## プロパティをシャドウおよびフィルター処理するカスタム デザイナーの作成  
+ `MarqueeControlRootDesigner` クラスは、ルート デザイナーの実装を提供します。  `MarqueeControl` で動作するこのデザイナーに加えて、`MarqueeBorder` コントロールに特別に関連付けられたカスタム デザイナーも必要です。  このカスタム デザイナーは、カスタム ルート デザイナーのコンテキストに応じたカスタム動作を実現します。  
+  
+ 具体的には、`MarqueeBorderDesigner` は、`MarqueeBorder` コントロールの特定のプロパティを "シャドウ" およびフィルター処理して、デザイン環境との対話方法を変更します。  
+  
+ コンポーネントのプロパティ アクセサーの呼び出しを受け取ることを "シャドウ" と言います。これにより、ユーザーによって設定された値をデザイナーが追跡でき、デザインされるコンポーネントにその値を渡すこともできます。  
+  
+ たとえば、<xref:System.Windows.Forms.Control.Visible%2A> プロパティと <xref:System.Windows.Forms.Control.Enabled%2A> プロパティを `MarqueeBorderDesigner` で Shadows' を実行すると、デザイン時にユーザーが `MarqueeBorder` コントロールを非表示にしたり、無効にしたりできなくなります。  
+  
+ また、デザイナーはプロパティを追加したり削除したりできます。  たとえば、`MarqueeBorder` コントロールでは、`LightSize` プロパティで指定された光のサイズに基づいて埋め込みがプログラムによって設定されるため、デザイン時に <xref:System.Windows.Forms.Control.Padding%2A> プロパティが削除されます。  
+  
+ `MarqueeBorderDesigner` の基本クラスは <xref:System.ComponentModel.Design.ComponentDesigner> で、デザイン時にコントロールによって公開される属性、プロパティ、およびイベントを変更できる以下のメソッドがあります。  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PreFilterProperties%2A>  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PostFilterProperties%2A>  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PreFilterAttributes%2A>  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PostFilterAttributes%2A>  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PreFilterEvents%2A>  
+  
+-   <xref:System.ComponentModel.Design.ComponentDesigner.PostFilterEvents%2A>  
+  
+ これらのメソッドを使用してコンポーネントのパブリック インターフェイスを変更するときは、次の規則に従う必要があります。  
+  
+-   `PreFilter` メソッドのみで、アイテムを追加または削除します。  
+  
+-   `PostFilter` メソッドのみで、既存のアイテムを変更します。  
+  
+-   `PreFilter` メソッドでは、必ず最初に基本実装を呼び出します。  
+  
+-   `PostFilter` メソッドでは、必ず最後に基本実装を呼び出します。  
+  
+ これらの規則に従うことにより、デザイン時環境のすべてのデザイナーが、デザインされるすべてのコンポーネントで一貫したビューを持つことができます。  
+  
+ <xref:System.ComponentModel.Design.ComponentDesigner> クラスは、Shadows' を実行されたプロパティの値を管理するためのディクショナリを提供するため、特定のインスタンス変数を作成する必要がありません。  
+  
+#### プロパティをシャドウおよびフィルター処理するカスタム デザイナーを作成するには  
+  
+1.  **Design** フォルダーを右クリックして、新しいクラスを追加します。  ソース ファイルに、"MarqueeBorderDesigner" という基本名を付けます。  
+  
+2.  `MarqueeBorderDesigner` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に次の名前空間をインポートします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#420](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborderdesigner.cs#420)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#420](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborderdesigner.vb#420)]  
+  
+3.  <xref:System.Windows.Forms.Design.ParentControlDesigner> を継承するように `MarqueeBorderDesigner` の宣言を変更します。  
+  
+     `MarqueeBorder` コントロールは子コントロールを含むことができるので、`MarqueeBorderDesigner` は、親子の対話を処理する <xref:System.Windows.Forms.Design.ParentControlDesigner> を継承します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#430](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborderdesigner.cs#430)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#430](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborderdesigner.vb#430)]  
+  
+4.  <xref:System.ComponentModel.Design.ComponentDesigner.PreFilterProperties%2A> の基本実装をオーバーライドします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#450](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborderdesigner.cs#450)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#450](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborderdesigner.vb#450)]  
+  
+5.  <xref:System.Windows.Forms.Control.Enabled%2A> プロパティと <xref:System.Windows.Forms.Control.Visible%2A> プロパティを実装します。  これらの実装によってコントロールのプロパティがシャドウされます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#440](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborderdesigner.cs#440)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#440](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborderdesigner.vb#440)]  
+  
+## コンポーネントの変更処理  
+ `MarqueeControlRootDesigner` クラスは、`MarqueeControl` インスタンスのデザイン時のカスタム操作を提供します。  デザイン時機能のほとんどが <xref:System.Windows.Forms.Design.DocumentDesigner> クラスから継承されるので、コンポーネントの変更処理とデザイナー動詞の追加という 2 つの固有のカスタマイズをコードで実装します。  
+  
+ ユーザーが各自の `MarqueeControl` インスタンスをデザインするときに、ルート デザイナーは、`MarqueeControl` とその子コントロールに対する変更を追跡します。  デザイン時環境は、コンポーネント状態の変更を追跡するための <xref:System.ComponentModel.Design.IComponentChangeService> という便利なサービスを提供します。  
+  
+ このサービスへの参照を取得するには、<xref:System.ComponentModel.Design.ComponentDesigner.GetService%2A> メソッドを使用してデザイン時環境を照会します。  照会が成功すると、デザイナーは、<xref:System.ComponentModel.Design.IComponentChangeService.ComponentChanged> イベントのハンドラーをアタッチし、デザイン時に一貫した状態を保持する上で必要なタスクを実行できます。  
+  
+ `MarqueeControlRootDesigner` クラスの場合は、`MarqueeControl` に含まれている各 `IMarqueeWidget` オブジェクトで <xref:System.Windows.Forms.Control.Refresh%2A> メソッドを呼び出します。  これにより、親の <xref:System.Windows.Forms.Control.Size%2A> などのプロパティが変更されたときに `IMarqueeWidget` オブジェクト自体が適切に再描画されます。  
+  
+#### コンポーネントの変更を処理するには  
+  
+1.  **コード エディター**で `MarqueeControlRootDesigner` ソース ファイルを開き、<xref:System.Windows.Forms.Design.DocumentDesigner.Initialize%2A> メソッドをオーバーライドします。  <xref:System.Windows.Forms.Design.DocumentDesigner.Initialize%2A> の基本実装を呼び出し、<xref:System.ComponentModel.Design.IComponentChangeService> を照会します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#580](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#580)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#580](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#580)]  
+  
+2.  <xref:System.ComponentModel.Design.IComponentChangeService.OnComponentChanged%2A> イベント ハンドラーを実装します。  送信側のコンポーネントの型をテストし、それが `IMarqueeWidget` の場合は、その <xref:System.Windows.Forms.Control.Refresh%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#560](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#560)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#560](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#560)]  
+  
+## カスタム デザイナーへのデザイナー動詞の追加  
+ デザイナー動詞は、イベント ハンドラーにリンクされたメニュー コマンドです。  デザイナー動詞は、デザイン時にコンポーネントのショートカット メニューに追加されます。  詳細については、「<xref:System.ComponentModel.Design.DesignerVerb>」を参照してください。  
+  
+ **\[テストの実行\]** と **\[テストの停止\]** の 2 つのデザイナー動詞をデザイナーに追加します。  これらの動詞を使用すると、`MarqueeControl` の実行時の動作をデザイン時に確認できます。  これらの動詞は、`MarqueeControlRootDesigner` に追加されます。  
+  
+ **\[テストの実行\]** を起動すると、動詞イベント ハンドラーが `MarqueeControl` で `StartMarquee` メソッドを呼び出します。  また、**\[テストの停止\]** を起動すると、動詞イベント ハンドラーが `MarqueeControl` で `StopMarquee` メソッドを呼び出します。  `StartMarquee` メソッドと `StopMarquee` メソッドの実装は、`IMarqueeWidget` を実装する、包含される側のコントロールでこれらのメソッドを呼び出すため、包含される `IMarqueeWidget` コントロールもすべてテストに加わります。  
+  
+#### デザイナー動詞をカスタム デザイナーに追加するには  
+  
+1.  `MarqueeControlRootDesigner` クラスに、`OnVerbRunTest` および `OnVerbStopTest` という名前のイベント ハンドラーを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#570](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#570)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#570](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#570)]  
+  
+2.  これらのイベント ハンドラーを、対応するデザイナー動詞に接続します。  `MarqueeControlRootDesigner` は、基本クラスから <xref:System.ComponentModel.Design.DesignerVerbCollection> を継承します。  新たに 2 つの <xref:System.ComponentModel.Design.DesignerVerb> オブジェクトを作成し、<xref:System.Windows.Forms.Design.DocumentDesigner.Initialize%2A> メソッドのこのコレクションに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#590](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueecontrolrootdesigner.cs#590)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#590](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueecontrolrootdesigner.vb#590)]  
+  
+## カスタム UITypeEditor の作成  
+ ユーザーに対しデザイン時のカスタム操作を作成するときは、一般に \[プロパティ\] ウィンドウを使用してカスタム対話を作成することが望まれます。  これを行うには、<xref:System.Drawing.Design.UITypeEditor> を作成します。  詳細については、「[How to: Create a UI Type Editor](../Topic/How%20to:%20Create%20a%20UI%20Type%20Editor.md)」を参照してください。  
+  
+ `MarqueeBorder` コントロールは、\[プロパティ\] ウィンドウにいくつかのプロパティを公開します。  これらのプロパティのうち、`MarqueeSpinDirection` と `MarqueeLightShape` の 2 つは列挙型で表されます。  UI 型エディターの使い方を示すために、`MarqueeLightShape` プロパティには、<xref:System.Drawing.Design.UITypeEditor> クラスが関連付けられます。  
+  
+#### カスタム UI 型エディターを作成するには  
+  
+1.  `MarqueeBorder` ソース ファイルを**コード エディター**で開きます。  
+  
+2.  `MarqueeBorder` クラスの定義で、<xref:System.Drawing.Design.UITypeEditor> から派生する、`LightShapeEditor` という名前のクラスを宣言します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#96](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#96)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#96](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#96)]  
+  
+3.  `editorService` という <xref:System.Windows.Forms.Design.IWindowsFormsEditorService> インスタンス変数を宣言します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#92](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#92)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#92](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#92)]  
+  
+4.  <xref:System.Drawing.Design.UITypeEditor.GetEditStyle%2A> メソッドをオーバーライドします。  この実装は、`LightShapeEditor` の表示方法をデザイン環境に指示する <xref:System.Drawing.Design.UITypeEditorEditStyle> を返します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#93](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#93)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#93](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#93)]  
+  
+5.  <xref:System.Drawing.Design.UITypeEditor.EditValue%2A> メソッドをオーバーライドします。  この実装は、デザイン環境に <xref:System.Windows.Forms.Design.IWindowsFormsEditorService> オブジェクトを照会します。  照会が成功すると、`LightShapeSelectionControl` が作成されます。  <xref:System.Windows.Forms.Design.IWindowsFormsEditorService.DropDownControl%2A> メソッドを呼び出して、`LightShapeEditor` を起動します。  この呼び出しの戻り値がデザイン環境に返されます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#94](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/marqueeborder.cs#94)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#94](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/marqueeborder.vb#94)]  
+  
+## カスタム UITypeEditor のビュー コントロールの作成  
+  
+1.  `MarqueeLightShape` プロパティは、`Square` と `Circle` の 2 種類の光の形状をサポートします。  ここでは、これらの値を \[プロパティ\] ウィンドウにグラフィカルに表示するためだけに使用するカスタム コントロールを作成します。  このカスタム コントロールは、<xref:System.Drawing.Design.UITypeEditor> が \[プロパティ\] ウィンドウと対話するために使用します。  
+  
+#### カスタム UI 型エディターのビュー コントロールを作成するには  
+  
+1.  新しい <xref:System.Windows.Forms.UserControl> アイテムを `MarqueeControlLibrary` プロジェクトに追加します。  新しいソース ファイルに、"LightShapeSelectionControl" という基本名を付けます。  
+  
+2.  **\[ツールボックス\]** から 2 つの <xref:System.Windows.Forms.Panel> コントロールを `LightShapeSelectionControl` にドラッグします。  これらのコントロールに `squarePanel` および `circlePanel` という名前を付けます。  これらを左右に並べて配置します。  両方の <xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Control.Size%2A> プロパティを \(60, 60\) に設定します。  `squarePanel` コントロールの <xref:System.Windows.Forms.Control.Location%2A> プロパティを \(8, 10\) に設定します。  `circlePanel` コントロールの <xref:System.Windows.Forms.Control.Location%2A> プロパティを \(80, 10\) に設定します。  最後に、`LightShapeSelectionControl` の <xref:System.Windows.Forms.Control.Size%2A> プロパティを \(150, 80\) に設定します。  
+  
+3.  `LightShapeSelectionControl` ソース ファイルを**コード エディター**で開きます。  ファイルの先頭に、次のように <xref:System.Windows.Forms.Design?displayProperty=fullName> 名前空間をインポートします。  
+  
+```vb  
+Imports System.Windows.Forms.Design  
+```  
+  
+```csharp  
+using System.Windows.Forms.Design;  
+```  
+  
+1.  `squarePanel` コントロールおよび `circlePanel` コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを実装します。  これらのメソッドは <xref:System.Windows.Forms.Design.IWindowsFormsEditorService.CloseDropDown%2A> を呼び出して、カスタム <xref:System.Drawing.Design.UITypeEditor> 編集セッションを終了させます。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#390](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#390)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#390](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#390)]  
+  
+2.  `editorService` という <xref:System.Windows.Forms.Design.IWindowsFormsEditorService> インスタンス変数を宣言します。  
+  
+```vb  
+Private editorService As IWindowsFormsEditorService  
+```  
+  
+```csharp  
+private IWindowsFormsEditorService editorService;  
+```  
+  
+1.  `lightShapeValue` という `MarqueeLightShape` インスタンス変数を宣言します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#330](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#330)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#330](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#330)]  
+  
+2.  `LightShapeSelectionControl` コンストラクターで、`squarePanel` コントロールと `circlePanel` コントロールの <xref:System.Windows.Forms.Control.Click> イベントに <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを追加します。  また、デザイン環境から `lightShapeValue` フィールドに `MarqueeLightShape` 値を割り当てる、コンストラクター オーバーロードを定義します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#340](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#340)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#340](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#340)]  
+  
+3.  <xref:System.ComponentModel.Component.Dispose%2A> メソッドで、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーをデタッチします。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#350](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#350)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#350](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#350)]  
+  
+4.  **ソリューション エクスプローラー**の **\[すべてのファイルを表示\]** をクリックします。  LightShapeSelectionControl.Designer.cs ファイルまたは LightShapeSelectionControl.Designer.vb ファイルを開いて、<xref:System.ComponentModel.Component.Dispose%2A> メソッドの既定の定義を削除します。  
+  
+5.  `LightShape` プロパティを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#360](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#360)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#360](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#360)]  
+  
+6.  <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドします。  この実装によって、塗りつぶされた正方形と円が描画されます。  また、いずれかの図形の周囲に境界線を描画して、選択した値を強調表示します。  
+  
+     [!code-csharp[System.Windows.Forms.Design.DocumentDesigner#380](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/CS/lightshapeselectioncontrol.cs#380)]
+     [!code-vb[System.Windows.Forms.Design.DocumentDesigner#380](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Design.DocumentDesigner/VB/lightshapeselectioncontrol.vb#380)]  
+  
+## デザイナーでのカスタム コントロールのテスト  
+ この時点で、`MarqueeControlLibrary` プロジェクトをビルドできます。  `MarqueeControl` クラスから継承するコントロールを作成し、それをフォームで使用して、実装をテストします。  
+  
+#### カスタム MarqueeControl 実装を作成するには  
+  
+1.  Windows フォーム デザイナーで `DemoMarqueeControl` を開きます。  これにより、`DemoMarqueeControl` 型のインスタンスが作成され、`MarqueeControlRootDesigner` 型のインスタンス内に表示されます。  
+  
+2.  **ツールボックス**の **\[MarqueeControlLibrary コンポーネント\]** タブを開きます。  `MarqueeBorder` コントロールと `MarqueeText` コントロールが選択可能なアイテムとして表示されます。  
+  
+3.  `MarqueeBorder` コントロールのインスタンスを `DemoMarqueeControl` のデザイン サーフェイスにドラッグします。  この `MarqueeBorder` コントロールを親コントロールにドッキングします。  
+  
+4.  `MarqueeText` コントロールのインスタンスを `DemoMarqueeControl` のデザイン サーフェイスにドラッグします。  
+  
+5.  ソリューションをビルドします。  
+  
+6.  `DemoMarqueeControl` を右クリックし、ショートカット メニューの **\[テストの実行\]** を選択すると、アニメーションが開始されます。  **\[テストの停止\]** をクリックして、アニメーションを停止します。  
+  
+7.  デザイン ビューで **\[Form1\]** を開きます。  
+  
+8.  2 つの <xref:System.Windows.Forms.Button> コントロールをフォームに配置します。  それらのコントロールに `startButton` および `stopButton` という名前を付け、<xref:System.Windows.Forms.Control.Text%2A> プロパティ値をそれぞれ「Start」と「Stop」に変更します。  
+  
+9. 両方の <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを実装します。  
+  
+10. **ツールボックス**の **\[MarqueeControlTest コンポーネント\]** タブを開きます。  `DemoMarqueeControl` が選択可能なアイテムとして表示されます。  
+  
+11. `DemoMarqueeControl` のインスタンスを **Form1** のデザイン サーフェイスにドラッグします。  
+  
+12. <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで、`DemoMarqueeControl` の `Start` メソッドと `Stop` メソッドを呼び出します。  
+  
+```vb  
+Private Sub startButton_Click(sender As Object, e As System.EventArgs)  
+    Me.demoMarqueeControl1.Start()  
+End Sub 'startButton_Click  
+  
+Private Sub stopButton_Click(sender As Object, e As System.EventArgs)  
+Me.demoMarqueeControl1.Stop()  
+End Sub 'stopButton_Click  
+```  
+  
+```csharp  
+private void startButton_Click(object sender, System.EventArgs e)  
+{  
+    this.demoMarqueeControl1.Start();  
+}  
+  
+private void stopButton_Click(object sender, System.EventArgs e)  
+{  
+    this.demoMarqueeControl1.Stop();  
+}  
+```  
+  
+1.  `MarqueeControlTest` プロジェクトをスタートアップ プロジェクトとして設定し、実行します。  フォームに `DemoMarqueeControl` が表示されます。  **\[開始\]** ボタンをクリックしてアニメーションを開始します。  テキストが点滅し、光が境界線上を移動するように見えます。  
+  
+## 次の手順  
+ `MarqueeControlLibrary` は、カスタム コントロールとそれに関連付けられたデザイナーの簡単な実装を示しています。  このサンプルは、以下の方法でより洗練されたものにできます。  
+  
+-   デザイナーで `DemoMarqueeControl` のプロパティ値を変更します。  さらに `MarqueBorder` コントロールを追加し、親インスタンス内でドッキングして、入れ子の状態にします。  `UpdatePeriod` プロパティと光関連プロパティでさまざまな設定を試みます。  
+  
+-   `IMarqueeWidget` の独自の実装を作成します。  たとえば、点滅する "ネオン サイン" や、複数のイメージを表示するアニメーション サインを作成することもできます。  
+  
+-   デザイン時の操作をさらにカスタマイズします。  <xref:System.Windows.Forms.Control.Enabled%2A> と <xref:System.Windows.Forms.Control.Visible%2A> よりも多くのプロパティをシャドウしたり、新しいプロパティを追加したりできます。  新しいデザイナー動詞を追加して、子コントロールのドッキングなどの共通タスクを簡素化します。  
+  
+-   `MarqueeControl` のライセンス処理を行います。  詳細については、「[方法 : コンポーネントおよびコントロールのライセンス処理を行う](../Topic/How%20to:%20License%20Components%20and%20Controls.md)」を参照してください。  
+  
+-   コントロールをシリアル化する方法と、コントロールのコードを生成する方法を制御します。  詳細については、「[動的なソース コードの生成とコンパイル](../../../../docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.UserControl>   
+ <xref:System.Windows.Forms.Design.ParentControlDesigner>   
+ <xref:System.Windows.Forms.Design.DocumentDesigner>   
+ <xref:System.ComponentModel.Design.IRootDesigner>   
+ <xref:System.ComponentModel.Design.DesignerVerb>   
+ <xref:System.Drawing.Design.UITypeEditor>   
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [How to: Create a Windows Forms Control That Takes Advantage of Design\-Time Features](../Topic/How%20to:%20Create%20a%20Windows%20Forms%20Control%20That%20Takes%20Advantage%20of%20Design-Time%20Features.md)   
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)   
+ [Custom Designers](../Topic/Custom%20Designers.md)   
+ [.NET Shape Library: A Sample Designer \(.NET 図形ライブラリ: サンプル デザイナー\)](http://windowsforms.net/articles/shapedesigner.aspx)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview.md b/docs/framework/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview.md
new file mode 100644
index 00000000000..da53513242b
--- /dev/null
+++ b/docs/framework/winforms/controls/creating-an-explorer-style-interface-with-the-listview-and-treeview.md
@@ -0,0 +1,115 @@
+---
+title: "チュートリアル : デザイナーを使用した、ListView コントロールと TreeView コントロールを含むエクスプローラー スタイルのインターフェイスの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エクスプローラー スタイル アプリケーション"
+  - "エクスプローラー スタイル アプリケーション, チュートリアル"
+  - "ListView コントロール [Windows フォーム], エクスプローラー スタイルのインターフェイス"
+  - "ListView コントロール [Windows フォーム], エクスプローラー スタイル インターフェイス"
+  - "ListView コントロール [Windows フォーム], TreeView コントロールで使用する"
+  - "TreeView コントロール [Windows フォーム], ListView コントロールで使用する"
+  - "TreeView コントロール [Windows フォーム], 使用 (エクスプローラー スタイルのインターフェイスで)"
+ms.assetid: 9e5e7721-19e2-4890-b273-a43589fe99ff
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# チュートリアル : デザイナーを使用した、ListView コントロールと TreeView コントロールを含むエクスプローラー スタイルのインターフェイスの作成
+Visual Studio の利点の 1 つは、プロフェッショナルなデザインの Windows フォーム アプリケーションを短時間で作成できることです。  一般的なシナリオは、Windows オペレーティング システムの Windows エクスプローラーによく似た、<xref:System.Windows.Forms.ListView> コントロールと <xref:System.Windows.Forms.TreeView> コントロールを持つユーザー インターフェイス \(UI\) を作成することです。  Windows エクスプローラーは、ユーザーのコンピューターに格納されているファイルとフォルダーを階層構造で表示します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ListView コントロールと TreeView コントロールを含むフォームを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックします。  
+  
+2.  **\[新しいプロジェクト\]** ダイアログ ボックスで以下の作業を行います。  
+  
+    1.  カテゴリで **\[Visual Basic\]** または **\[Visual C\#\]** を選択します。  
+  
+    2.  テンプレートの一覧で、**\[Windows フォーム アプリケーション\]** を選択します。  
+  
+3.  **\[OK\]** をクリックします。  新しい Windows フォーム プロジェクトが作成されます。  
+  
+4.  フォームに <xref:System.Windows.Forms.SplitContainer> コントロールを追加し、<xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+5.  `imageList1` という名前の <xref:System.Windows.Forms.ImageList> をフォームに追加し、プロパティ ウィンドウを使用して、フォルダー イメージとドキュメント イメージの 2 つのイメージをこの順に追加します。  
+  
+6.  `treeview1` という名前の <xref:System.Windows.Forms.TreeView> をフォームに追加し、<xref:System.Windows.Forms.SplitContainer> コントロールの左側に配置します。  `treeView1` のプロパティ ウィンドウで、次の手順を実行します。  
+  
+    1.  <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+    2.  <xref:System.Windows.Forms.TreeView.ImageList%2A> プロパティを `imagelist1` に設定します。  
+  
+7.  `listView1` という名前の <xref:System.Windows.Forms.ListView> をフォームに追加し、<xref:System.Windows.Forms.SplitContainer> コントロールの右側に配置します。  `listview1` のプロパティ ウィンドウで、次の手順を実行します。  
+  
+    1.  <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+    2.  <xref:System.Windows.Forms.ListView.View%2A> プロパティを <xref:System.Windows.Forms.View> に設定します。  
+  
+    3.  <xref:System.Windows.Forms.ListView.Columns%2A> プロパティの省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして、ColumnHeader コレクション エディターを開きます。3 つの列を追加し、<xref:System.Windows.Forms.ColumnHeader.Text%2A> プロパティをそれぞれ `Name`、`Type`、`Last Modified` に設定します。  **\[OK\]** をクリックし、ダイアログ ボックスを閉じます。  
+  
+    4.  <xref:System.Windows.Forms.ListView.SmallImageList%2A> プロパティを `imageList1.` に設定します。  
+  
+8.  <xref:System.Windows.Forms.TreeView> にノードとサブノードを設定するコードを実装します。  `Form1` クラスに次のコードを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ExplorerStyleInterface#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/CS/Form1.cs#1)]
+     [!code-vb[System.Windows.Forms.ExplorerStyleInterface#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/VB/Form1.vb#1)]  
+  
+9. このコードでは System.IO 名前空間を使用しているため、フォームの先頭に適切な using ステートメントまたはインポート ステートメントを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ExplorerStyleInterface#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.ExplorerStyleInterface#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/VB/Form1.vb#4)]  
+  
+10. フォームのコンストラクターまたは <xref:System.Windows.Forms.Form.Load> イベント処理メソッドから、前の手順で作成したセットアップ メソッドを呼び出します。  次のコードをフォーム コンストラクターに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ExplorerStyleInterface#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.ExplorerStyleInterface#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/VB/Form1.vb#2)]  
+  
+11. `treeview1` の <xref:System.Windows.Forms.TreeView.NodeMouseClick> イベントを処理し、ノードがクリックされたときにノードの内容を `listview1` に設定するコードを実装します。  `Form1` クラスに次のコードを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ExplorerStyleInterface#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.ExplorerStyleInterface#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/VB/Form1.vb#3)]  
+  
+     C\# を使用している場合は、<xref:System.Windows.Forms.TreeView.NodeMouseClick> イベントをそのイベント処理メソッドに関連付けてください。  次のコードをフォーム コンストラクターに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ExplorerStyleInterface#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ExplorerStyleInterface/CS/Form1.cs#5)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   F5 キーを押してアプリケーションを実行します。  
+  
+     プロジェクト ディレクトリを表示する <xref:System.Windows.Forms.TreeView> コントロールが左側にあり、3 つの列が含まれた <xref:System.Windows.Forms.ListView> コントロールが右側にある分割フォームが表示されます。  ディレクトリ ノードを選択して <xref:System.Windows.Forms.TreeView> を走査すると、選択したディレクトリの内容が <xref:System.Windows.Forms.ListView> に表示されます。  
+  
+## 次の手順  
+ このアプリケーションは、<xref:System.Windows.Forms.TreeView> コントロールと <xref:System.Windows.Forms.ListView> コントロールを一緒に使用する方法の一例です。  これらのコントロールの詳細については、次のトピックを参照してください。  
+  
+-   [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)  
+  
+-   [方法 : ListView コントロールに検索機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md)  
+  
+-   [方法 : ショートカット メニューを TreeView ノードに追加する](../../../../docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treeview-node.md)  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.TreeView>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/custom-control-painting-and-rendering.md b/docs/framework/winforms/controls/custom-control-painting-and-rendering.md
new file mode 100644
index 00000000000..b0fa45d112c
--- /dev/null
+++ b/docs/framework/winforms/controls/custom-control-painting-and-rendering.md
@@ -0,0 +1,63 @@
+---
+title: "コントロールのカスタム描画およびレンダリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 描画"
+  - "カスタム コントロール [Windows フォーム], 描画"
+  - "OnPaint メソッド"
+  - "ユーザー コントロール [Windows フォーム], 描画"
+ms.assetid: a09dbf76-0966-4cbf-a66a-2083ba98e068
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# コントロールのカスタム描画およびレンダリング
+コントロールのカスタム描画は、.NET Framework によって簡略化された作業の 1 つです。  カスタム コントロールを作成するときには、多くのオプションからコントロールの外観を決定できます。  `Control` から継承するコントロールを作成する場合は、コントロールのグラフィカル表示をレンダリングするためのコードを記述する必要があります。  `UserControl` からの継承、または Windows フォーム コントロールからの継承によってユーザー コントロールを作成する場合は、標準のグラフィカル表示をオーバーライドして、独自のグラフィック コードを指定できます。  作成する `UserControl` の内在コントロールにカスタム レンダリング機能を提供する場合、オプションは制限されますが、コントロールおよびアプリケーションに対して幅広いグラフィカル表現が可能です。  
+  
+## このセクションの内容  
+ [Windows フォーム コントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-a-windows-forms-control.md)  
+ コントロールの表示ロジックをプログラミングする方法について説明します。  
+  
+ [ユーザー描画コントロール](../../../../docs/framework/winforms/controls/user-drawn-controls.md)  
+ コントロールのレンダリング処理コードを記述またはオーバーライドする手順の概要を示します。  
+  
+ [内在コントロール](../../../../docs/framework/winforms/controls/constituent-controls.md)  
+ ユーザー コントロールおよびフォームの内在コントロールに対してカスタム レンダリング処理コードを実装する方法について説明します。  
+  
+ [方法 : 実行時にコントロールを非表示にする](../../../../docs/framework/winforms/controls/how-to-make-your-control-invisible-at-run-time.md)  
+ <xref:System.Windows.Forms.Control.Visible%2A> プロパティを使用してコントロールを表示および非表示にする方法を示します。  
+  
+ [方法 : コントロールに透明な背景を指定する](../../../../docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md)  
+ <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを使用して、背景色を不透明、透明、または半透明にする方法を示します。  
+  
+ [visual スタイルが使用されているコントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)  
+ コントロールをサポートするオペレーティング システムの visual スタイルを使用してコントロールのレンダリングを行う方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Control>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.UserControl>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.Control.OnPaint%2A>  
+ このメソッドについて説明します。  
+  
+## 関連項目  
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)  
+ [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] グラフィックス機能を Visual Studio の観点から紹介し、詳細情報へのリンクを提供します。  
+  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)  
+ 作成可能なカスタム コントロールの種類について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md b/docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md
new file mode 100644
index 00000000000..2dec6759d70
--- /dev/null
+++ b/docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, カスタマイズ (DataGridView コントロール内の)"
+  - "列 [Windows フォーム], カスタマイズ (DataGridView コントロール内の)"
+  - "DataGridView コントロール [Windows フォーム], セルのカスタマイズ"
+ms.assetid: 9b7dc7b6-5ce6-4566-9949-902f74f17a81
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする
+<xref:System.Windows.Forms.DataGridView> コントロールは、プロパティ、イベント、およびコンパニオン クラスを使用して外観と動作をカスタマイズする様々な方法を提供します。  場合によっては、これらの機能が提供するもの以外にも、セルの要件がある場合があります。  独自のカスタム <xref:System.Windows.Forms.DataGridViewCell> クラスを作成して、拡張機能を提供することができます。  
+  
+ <xref:System.Windows.Forms.DataGridViewCell> 基底クラスまたは派生クラスの 1 つから派生することで、カスタム <xref:System.Windows.Forms.DataGridViewCell> クラスを作成します。  任意の種類の列の任意の種類のセルを表示できますが、多くの場合は、セルの種類の表示に特化したカスタムの <xref:System.Windows.Forms.DataGridViewColumn> クラスを作成することになります。  列のクラスは、<xref:System.Windows.Forms.DataGridViewColumn> または派生型のいずれかから派生します。  
+  
+ 次のコード例では、マウスがセルの境界に入ってでるときを検出する、`DataGridViewRolloverCell` と呼ばれるカスタム セル クラスを作成します。  マウスがセルの範囲内にある場合に、埋め込みの四角形が描画されます。  この新しい型は <xref:System.Windows.Forms.DataGridViewTextBoxCell> から派生して、その他のすべての点では、基底クラスとして動作します。  列のコンパニオン クラスは `DataGridViewRolloverColumn` と呼ばれます。  
+  
+ これらのクラスを使用するには、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを作成して、1 つ以上の `DataGridViewRolloverColumn` オブジェクトを <xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションに追加し、値を含む行にコントロールを設定します。  
+  
+> [!NOTE]
+>  空の行を追加すると、この例は正しく動作しません。  たとえば、<xref:System.Windows.Forms.DataGridView.RowCount%2A> プロパティを設定することでコントロールに行を追加する場合に、空の行を作成します。  これは、この例で追加された行は自動的に共有されるためでです。つまり、`DataGridViewRolloverCell` オブジェクトは、各セルをクリックするまでインスタンス化されないため、関連付けられた行の共有が解除されます。  
+  
+ この種類のセルのカスタマイズには共有されていない行が必要なため、大量のデータ セットでの使用には適切ではありません。  行の共有の詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridViewCell> や <xref:System.Windows.Forms.DataGridViewColumn> から派生したクラスに新しいプロパティを追加するときは、`Clone` メソッドをオーバーライドし、複製操作時に新しいプロパティをコピーする必要があります。  また、基底クラスの `Clone` メソッドを呼び出して、基底クラスのプロパティを新しいセルまたは列にコピーする必要もあります。  
+  
+### DataGridView コントロール内でセルと列をカスタマイズするには  
+  
+1.  `DataGridViewRolloverCell`という新しいセル クラスを <xref:System.Windows.Forms.DataGridViewTextBoxCell> 型から派生させます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#201](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#201)]
+     [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#201](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#201)]  
+    [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#202](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#202)]
+    [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#202](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#202)]  
+  
+2.  <xref:System.Windows.Forms.DataGridViewTextBoxCell.Paint%2A> クラスの `DataGridViewRolloverCell` メソッドをオーバーライドします。  オーバーライドで最初にホストされているテキスト ボックスの機能を処理する基本クラスの実装を呼び出します。  次に、コントロールの <xref:System.Windows.Forms.Control.PointToClient%2A> メソッドを使用して、\(画面座標の\) カーソル位置を <xref:System.Windows.Forms.DataGridView> クライアント領域の座標に変換します。  マウスの座標がセルの境界内にある場合は、埋め込みの四角形を描画します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#210](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#210)]
+     [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#210](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#210)]  
+  
+3.  `DataGridViewRolloverCell` クラスの <xref:System.Windows.Forms.DataGridViewCell.OnMouseEnter%2A> メソッドと <xref:System.Windows.Forms.DataGridViewCell.OnMouseLeave%2A> メソッドをオーバーライドして、マウス ポインターがに入る時点または出る時点でセルが自身を再描画するよう強制します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#220](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#220)]
+     [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#220](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#220)]  
+  
+4.  `DataGridViewRolloverCellColumn` という新しいクラスを <xref:System.Windows.Forms.DataGridViewColumn> 型から派生させます。  コンストラクターで、新しい `DataGridViewRolloverCell` オブジェクトを <xref:System.Windows.Forms.DataGridViewColumn.CellTemplate%2A> プロパティに割り当てます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#300](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#300)]
+     [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#300](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#300)]  
+  
+## 使用例  
+ 完全なコード例には、カスタムのセルの種類の動作を示す小さなテスト フォームが含まれます。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewRolloverCell#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/CS/rollovercell.cs#000)]
+ [!code-vb[System.Windows.Forms.DataGridViewRolloverCell#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRolloverCell/VB/rollovercell.vb#000)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Windows.Forms、および System.Drawing の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCell>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)   
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md b/docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md
new file mode 100644
index 00000000000..e42bd05bcc3
--- /dev/null
+++ b/docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, カスタマイズ (DataGridView コントロール内の)"
+  - "データ グリッド, カスタマイズ (セルを)"
+  - "DataGridView コントロール [Windows フォーム], カスタマイズ (セルを)"
+ms.assetid: 478b20c9-625c-4116-9c5c-5a16e6f4ec67
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする
+セルの外観は、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CellPainting> イベントを処理することでカスタマイズできます。  <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Drawing.Graphics> は、<xref:System.Windows.Forms.DataGridViewCellPaintingEventArgs> の <xref:System.Windows.Forms.DataGridViewCellPaintingEventArgs.Graphics%2A> から抽出できます。  この <xref:System.Drawing.Graphics> を使用すると、<xref:System.Windows.Forms.DataGridView> コントロール全体の外観に影響しますが、通常は現在描画中のセルの外観だけをカスタマイズする必要があります。  <xref:System.Windows.Forms.DataGridViewCellPaintingEventArgs> の <xref:System.Windows.Forms.DataGridViewCellPaintingEventArgs.ClipBounds%2A> プロパティを使用すると、描画操作を現在描画中のセルだけに制限できます。  
+  
+ 次のコード例では、<xref:System.Windows.Forms.DataGridView> コントロールの配色を使用して `ContactName` 列のすべてのセルを描画します。  各セルのテキスト コンテンツは <xref:System.Drawing.Color.Crimson%2A> で描画され、くぼんで表示される四角形は <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.GridColor%2A> プロパティと同じ色で描画されます。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewCellPainting#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCellPainting/CS/form1.cs#10)]
+ [!code-vb[System.Windows.Forms.DataGridViewCellPainting#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCellPainting/VB/form1.vb#10)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Northwind サンプル データベース内の Customers テーブルの列など、`ContactName` 列を含む、`dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   System、System.Windows.Forms、System.Drawing の各アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.CellPainting>   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md b/docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md
new file mode 100644
index 00000000000..3b4ebc368dc
--- /dev/null
+++ b/docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, カスタマイズ (行を)"
+  - "DataGridView コントロール [Windows フォーム], カスタマイズ (行を)"
+  - "行, カスタマイズ (DataGridView コントロール内の)"
+ms.assetid: d40b53d2-7e7c-48c5-8570-6e79d15c3bbb
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする
+<xref:System.Windows.Forms.DataGridView> 行の外観を制御するには、<xref:System.Windows.Forms.DataGridView.RowPrePaint?displayProperty=fullName> イベントと <xref:System.Windows.Forms.DataGridView.RowPostPaint?displayProperty=fullName> イベントの一方、または両方を処理します。  これらのイベントは、ユーザーが任意のものだけ描画し、残りは <xref:System.Windows.Forms.DataGridView> コントロールに描画させるようにデザインされています。  たとえば、カスタムの背景を描画する場合は、<xref:System.Windows.Forms.DataGridView.RowPrePaint?displayProperty=fullName> イベントを処理し、それぞれの前景の内容は個々のセルに描画させるようにします。  または、セルを自動的に描画させ、<xref:System.Windows.Forms.DataGridView.RowPostPaint?displayProperty=fullName> イベントのハンドラーでカスタムの前景の内容を追加することもできます。  さらに、<xref:System.Windows.Forms.DataGridView.RowPrePaint?displayProperty=fullName> イベント ハンドラーを使用すれば、セルの描画をすべて無効にし、ユーザー自身ですべてを描画することもできます。  
+  
+ 次のコード例では、選択行にグラデーションの背景を表示し、複数の列にわたるカスタムの前景の内容を提供するために、両方のイベントのハンドラーを実装します。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewRowPainting#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRowPainting/CS/datagridviewrowpainting.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewRowPainting#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewRowPainting/VB/datagridviewrowpainting.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.RowPrePaint?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowPostPaint?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)   
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..ef45886a88c
--- /dev/null
+++ b/docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md
@@ -0,0 +1,67 @@
+---
+title: "Windows フォーム DataGridView コントロールのカスタマイズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, カスタマイズ"
+  - "DataGridView コントロール [Windows フォーム], カスタマイズ"
+ms.assetid: 01ea5d4c-a736-4596-b0e9-a67a1b86e15f
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォーム DataGridView コントロールのカスタマイズ
+`DataGridView` コントロールには、セル、行、列の外観と基本動作 \(操作性\) を調整するためのさまざまなプロパティが用意されています。  ただし、<xref:System.Windows.Forms.DataGridViewCellStyle> クラスの機能を越えるカスタマイズが必要な場合には、コントロール用のオーナー描画を実装したり、カスタムのセル、列、行を作成して機能を拡張したりすることもできます。  
+  
+ セルと行を独自に描画するには、`DataGridView` のさまざまな描画イベントを使用します。  既存の機能を修正したり、新機能を実装したりするには、既存の `DataGridViewCell`、`DataGridViewColumn`、および `DataGridViewRow` 型から派生した独自の型を作成します。  また、新しい編集機能を実装するには、セルが編集モードになったときに特定のコントロールを表示する派生型を作成します。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)  
+ <xref:System.Windows.Forms.DataGridView.CellPainting> イベントを使用してセルを手動で描画する方法について説明します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md)  
+ <xref:System.Windows.Forms.DataGridView.RowPrePaint> イベントと <xref:System.Windows.Forms.DataGridView.RowPostPaint> イベントを使用して、カスタムのグラデーション背景や複数の列にまたがる内容を含んだ行を描画する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](../../../../docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)  
+ `DataGridViewCell` および `DataGridViewColumn` から派生したカスタム型を作成して、セルにマウス ポインターが置かれたときにそのセルを強調表示する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする](../../../../docs/framework/winforms/controls/disable-buttons-in-a-button-column-in-the-datagrid.md)  
+ <xref:System.Windows.Forms.DataGridViewButtonCell> および <xref:System.Windows.Forms.DataGridViewButtonColumn> から派生したカスタム型を作成して、ボタン列に無効のボタンを表示する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView Cells でコントロールをホストする](../../../../docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md)  
+ `IDataGridViewEditingControl` インターフェイスを実装し、`DataGridViewCell` および `DataGridViewColumn` から派生したカスタム型を作成して、セルが編集モードのときに <xref:System.Windows.Forms.DateTimePicker> コントロールが表示されるようにする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewCell>  
+ <xref:System.Windows.Forms.DataGridViewCell> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewRow>  
+ <xref:System.Windows.Forms.DataGridViewRow> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewColumn>  
+ <xref:System.Windows.Forms.DataGridViewColumn> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.IDataGridViewEditingControl>  
+ <xref:System.Windows.Forms.IDataGridViewEditingControl> インターフェイスの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)  
+ コントロールの基本の外観およびセル データの表示形式を変更する方法を説明するトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..047bb7ead78
--- /dev/null
+++ b/docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,64 @@
+---
+title: "Windows フォーム DataGridView コントロールでのデータ表示モード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示モード"
+  - "データ グリッド, 表示モード"
+  - "DataGridView コントロール [Windows フォーム], 表示モード"
+ms.assetid: 9755a030-3f3f-4705-a661-ba5a48a81875
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォーム DataGridView コントロールでのデータ表示モード
+<xref:System.Windows.Forms.DataGridView> コントロールでは、バインド、非バインド、仮想の 3 つの異なるモードでデータを表示できます。  要求に基づいて最適なモードを選択します。  
+  
+## 非バインド  
+ 非バインド モードは、プログラムによって管理する、比較的少量のデータを表示するのに適しています。  このモードでは、バインド モードと違って、<xref:System.Windows.Forms.DataGridView> コントロールをデータ ソースに直接アタッチしません。  代わりに、通常、<xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A?displayProperty=fullName> メソッドを使用して、独自にコントロールにデータを設定します。  
+  
+ 非バインド モードは、読み取り専用の静的なデータを表示する場合や、外部データ ストアと対話する独自のコードを提供する場合に特に役立ちます。  ただし、ユーザーが外部データ ソースと対話するようにする場合は、通常、バインド モードを使用します。  
+  
+ 読み取り専用の非バインド <xref:System.Windows.Forms.DataGridView> の使用例については、「[方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## バインド  
+ バインド モードは、データ ストアとの自動対話によってデータを管理するのに適しています。  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティを設定して、データ ソースに直接アタッチできます。  コントロールがデータ バインドの場合、開発者の側で明示的に管理しなくてもデータ行がプッシュおよびプルされます。  <xref:System.Windows.Forms.DataGridView.AutoGenerateColumns%2A> プロパティが `true` のときは、データ ソースの各列によって、対応する列がコントロールで作成されます。  独自の列を作成する場合は、このプロパティを `false` に設定し、各列の設定時に <xref:System.Windows.Forms.DataGridViewColumn.DataPropertyName%2A> プロパティを使用してバインドします。  これは、既定で生成される型以外の列型を使用するときに役立ちます。  詳細については、「[Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ バインド <xref:System.Windows.Forms.DataGridView> コントロールの使用例については、「[チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ バインド モードの <xref:System.Windows.Forms.DataGridView> コントロールには、非バインド列を追加することもできます。  これは、特定の行に対する操作をユーザーが実行できるようにするボタンやリンクの列を表示するときに役立ちます。  また、バインド列に基づいて計算された値を含む列を表示する場合にも役立ちます。  計算された列のセル値は、<xref:System.Windows.Forms.DataGridView.CellFormatting> イベントのハンドラーに設定できます。  ただし、<xref:System.Data.DataSet> や <xref:System.Data.DataTable> をデータ ソースとして使用する場合は、代わりに <xref:System.Data.DataColumn.Expression%2A?displayProperty=fullName> プロパティを使用して、計算された列を生成することもできます。  この場合、<xref:System.Windows.Forms.DataGridView> コントロールは、計算された列を、データ ソース内の他の列と同じように取り扱います。  
+  
+ バインド モードでの非バインド列による並べ替えはサポートされません。  ユーザーによる編集が可能な値を含む非バインド列をバインド モードで作成した場合は、仮想モードを実装することで、コントロールをバインド列で並べ替えたときにこれらの値を保持する必要があります。  
+  
+## Virtual  
+ 仮想モードでは、独自のデータ管理操作を実装できます。  これは、コントロールをバインド列で並べ替えたときに、バインド モードで非バインド列の値を保持するために必要です。  ただし、仮想モードの主要な用途は、大量のデータとやりとりするときにパフォーマンスを最適化することです。  
+  
+ 管理対象であり、データ行をプッシュおよびプルするときにコードで制御するキャッシュに <xref:System.Windows.Forms.DataGridView> コントロールをアタッチします。  メモリの使用量を抑えるには、キャッシュのサイズは、現在表示されている行数と同じにする必要があります。  ユーザーが新しい行をスクロール表示すると、コードが新しいデータをキャッシュに要求し、オプションで以前のデータをメモリからフラッシュします。  
+  
+ 仮想モードを実装する場合は、新しい行がデータ モデルで必要になる時点と、新しい行の追加をロールバックする時点を監視する必要があります。  この機能の正確な実装は、データ モデルの実装とトランザクション セマンティクス \(コミット スコープがセル レベルか、行レベルか\) によって異なります。  
+  
+ 仮想モードの詳細については、「[Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)」を参照してください。  仮想モード イベントの使用例については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.DataGridViewColumn.DataPropertyName%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)   
+ [方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..31aa7b01d27
--- /dev/null
+++ b/docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,66 @@
+---
+title: "Windows フォーム DataGridView コントロールでのデータ入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ エントリ, DataGridView コントロール"
+  - "データ グリッド, データ エントリ"
+  - "DataGridView コントロール [Windows フォーム], データ エントリ"
+ms.assetid: 4a6d4676-d4e7-4b0e-9c22-50ce65ffe0d6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Windows フォーム DataGridView コントロールでのデータ入力
+`DataGridView` コントロールのいくつかの機能を使用すると、コントロール内のデータをユーザーが追加または修正する方法を変更できます。  たとえば、新しい行に既定値を挿入したり、エラーの発生時にユーザーに警告を出したりして、データ入力を効率化できます。  
+  
+## このセクションの内容  
+ [方法 : Windows フォーム DataGridView コントロールの編集モードを指定する](../../../../docs/framework/winforms/controls/how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md)  
+ ユーザーによるセル編集の開始方法を変更する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する](../../../../docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md)  
+ 新しいレコードの行をあらかじめ読み込んで、データ入力時間を節約する方法について説明します。  
+  
+ [Windows フォーム DataGridView コントロールにおける新規レコード行の使用](../../../../docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md)  
+ 新規レコードの行について詳しく説明します。新規レコードの行を隠す方法、外観をカスタマイズする方法、<xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションに関連付ける方法についても説明します。  
+  
+ [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)  
+ ユーザー入力を検証してデータ入力書式エラーの発生を防ぐ方法について説明します。  
+  
+ [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)  
+ ユーザーが新しい値をコミットしようとしたときに、データ ソースから生じたデータ入力エラーを処理する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.EditMode%2A?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.EditMode%2A> プロパティの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded> イベントの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.DataError?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.DataError> イベントの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.CellValidating?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.CellValidating> イベントの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)  
+ コントロールの内容を手動で作成する方法と、外部データ ソースから取得する方法についてのトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..2ea5fac5b6b
--- /dev/null
+++ b/docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,49 @@
+---
+title: "Windows フォーム DataGridView コントロールでのデータの書式設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 書式設定 (グリッド内の)"
+  - "データ グリッド, 書式設定 (データを)"
+  - "DataGridView コントロール [Windows フォーム], 書式設定 (データを)"
+ms.assetid: 07bf558d-3748-42ba-8ba0-37fdef924081
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォーム DataGridView コントロールでのデータの書式設定
+<xref:System.Windows.Forms.DataGridView> コントロールでは、セル値と、親列に表示されるデータ型を自動的に変換できます。  たとえば、テキスト ボックス列には、日付値、時刻値、数値、および列挙値が文字列形式で表示され、ユーザーが入力した文字列値が、データ ストアで必要な型に変換されます。  
+  
+## DataGridViewCellStyle クラスを使用した書式設定  
+ <xref:System.Windows.Forms.DataGridView> コントロールでは、<xref:System.Windows.Forms.DataGridViewCellStyle> クラスを介して、セル値の基本的なデータ書式設定を実行できます。  <xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A> プロパティを使用すると、「[型の書式設定](../../../../docs/standard/base-types/formatting-types.md)」に記載されている書式指定子を使用し、現在の既定のカルチャに合わせて日付値、時刻値、数値、および列挙値の書式を設定できます。  また、<xref:System.Windows.Forms.DataGridViewCellStyle.FormatProvider%2A> プロパティを使用すると、これらの値の書式を、特定のカルチャに合わせて設定できます。  指定した書式を使用して、データを表示したり、指定した書式でユーザーが入力したデータを解析したりできます。  
+  
+ <xref:System.Windows.Forms.DataGridViewCellStyle> クラスは、ワード ラップ、テキストの配置、および null データベース値のカスタム表示に必要な追加の書式設定プロパティを提供します。  詳細については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## CellFormatting イベントを使用した書式設定  
+ 基本的な書式設定がニーズに適合しない場合は、<xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName> イベントのハンドラーでカスタム データ書式設定を実行できます。  このハンドラーに渡される <xref:System.Windows.Forms.DataGridViewCellFormattingEventArgs> には、初期値としてセル値を含む <xref:System.Windows.Forms.ConvertEventArgs.Value%2A> プロパティがあります。  通常、この値は、表示型に自動的に変換されます。  この値を独自に変換するには、<xref:System.Windows.Forms.ConvertEventArgs.Value%2A> プロパティに表示型の値を設定します。  
+  
+> [!NOTE]
+>  書式指定文字列がセルに対して有効な場合は、<xref:System.Windows.Forms.DataGridViewCellFormattingEventArgs.FormattingApplied%2A> プロパティを `true` に設定している場合を除き、<xref:System.Windows.Forms.ConvertEventArgs.Value%2A> プロパティ値の変更内容が書式指定文字列によってオーバーライドされます。  
+  
+ また、<xref:System.Windows.Forms.DataGridView.CellFormatting> イベントは、個々のセルの <xref:System.Windows.Forms.DataGridViewCellStyle> プロパティを、それぞれの値に基づいて設定するときにも役立ちます。  詳細については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ ユーザー指定値の既定の解析がニーズに適合しない場合は、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CellParsing> イベントを処理して、カスタム解析を実行できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md b/docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md
new file mode 100644
index 00000000000..edba9425546
--- /dev/null
+++ b/docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md
@@ -0,0 +1,158 @@
+---
+title: "DataGrid コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DataGrid"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGrid コントロールにバインド データセット [Windows フォーム]"
+  - "データ バインド、DataGrid コントロール"
+  - "DataGrid コントロールの列 [Windows フォーム]"
+  - "DataGrid コントロールにバインド データ ソース"
+  - "DataGrid コントロールにバインド テーブル [Windows フォーム]"
+  - "データ バインディングの DataGrid コントロール [Windows フォーム]"
+  - "DataGrid コントロールの概要の DataGrid コントロール [Windows フォーム]"
+  - "親テーブル (DataGrid コントロールの)"
+  - "DataGrid コントロールに表示するテーブル [Windows フォーム]"
+  - "データ グリッドの概要のデータ グリッド"
+  - "複数のテーブル (DataGrid コントロールの)"
+  - "データ [Windows フォーム] を再度並べ替える"
+  - "データ [Windows フォーム] 内の移動"
+  - "DataGrid コントロールのバインドされたコントロール"
+  - "DataGrid のデータ バインド コントロール"
+  - "親テーブルからの移動 (DataGrid での)"
+  - "子テーブル、DataGrid コントロール"
+ms.assetid: 85604bce-bc03-49d9-9030-dda8896c44b1
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# DataGrid コントロールの概要 (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView>コントロールの置換し、する機能を追加、 <xref:System.Windows.Forms.DataGrid>コントロール。 ただし、、 <xref:System.Windows.Forms.DataGrid>を選択した場合、下位互換性と将来の使用の両方のコントロールが保持されています。 詳細については、次を参照してください。[の相違点の間で Windows フォームの DataGridView コントロールと DataGrid コントロール](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)します。  
+  
+ Windows フォーム<xref:System.Windows.Forms.DataGrid>コントロールは、一連の行と列のデータを表示します。 最も簡単なケースは、リレーションシップを含まない&1; つのテーブルを持つデータ ソースにグリッドがバインドされている場合です。 その場合は、スプレッドシートのように、単純な行と列でデータが表示されます。 その他のコントロールへのデータ バインディングの詳細については、次を参照してください。[データ連結と Windows フォーム](../../../../docs/framework/winforms/data-binding-and-windows-forms.md)します。  
+  
+ 場合、 <xref:System.Windows.Forms.DataGrid>複数のデータにバインドの関連するテーブルと、グリッドでナビゲーションが有効な場合、グリッドの各行にエキスパンダーが表示されます。 展開コントロールでは、ユーザーは、親テーブルから子テーブルに移動できます。 ノードをクリックすると子テーブルが表示され、[戻る] ボタンをクリックすると、元の親テーブルが表示されます。 この方法では、グリッドはテーブル間の階層リレーションシップを表示します。  
+  
+ 次のスクリーン ショットは、複数のテーブルのデータにバインドされた DataGrid を示しています。  
+  
+ ![複数のテーブルを持つデータにバインドされた DataGrid](../../../../docs/framework/winforms/controls/media/vbcontrol1.gif "vbControl1")  
+複数のテーブルを持つデータにバインドされた DataGrid  
+  
+ <xref:System.Windows.Forms.DataGrid>データセット、関連テーブル、および豊富な書式設定および編集機能間のナビゲーションのユーザー インターフェイスを提供することができます。  
+  
+ データの表示と操作は別の機能です。コントロールはユーザー インターフェイスを処理し、データの更新は Windows フォームのデータ バインディング アーキテクチャおよび [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] データ プロバイダーによって処理されます。 このため、同じデータ ソースにバインドされる複数のコントロールが同期状態を保ちます。  
+  
+> [!NOTE]
+>  Visual Basic 6.0 の DataGrid コントロールに慣れている場合は、Windows フォームにはいくつか大きな違いが表示されます<xref:System.Windows.Forms.DataGrid>コントロールです。  
+  
+ グリッドがバインドされている場合、<xref:System.Data.DataSet>列と行が自動的に作成、書式設定、および入力します。 詳細については、「 [Data Binding and Windows Forms](../../../../docs/framework/winforms/data-binding-and-windows-forms.md)」を参照してください。 次の世代の<xref:System.Windows.Forms.DataGrid>コントロールすることができます追加、削除、再配置、および、ニーズに応じて列と行の書式を設定します。  
+  
+## <a name="binding-data-to-the-control"></a>コントロールへのデータのバインド  
+ <xref:System.Windows.Forms.DataGrid>コントロールが機能するを使用してデータ ソースにバインドされている必要があります、<xref:System.Windows.Forms.DataGrid.DataSource%2A>と<xref:System.Windows.Forms.DataGrid.DataMember%2A>デザイン時にプロパティまたは<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A>メソッド実行時にします。 このバインディングの<xref:System.Windows.Forms.DataGrid>をインスタンス化されたデータ ソース オブジェクトになど、<xref:System.Data.DataSet>または<xref:System.Data.DataTable>)。 <xref:System.Windows.Forms.DataGrid>コントロールは、データ上で実行されるアクションの結果を表示します。 ほとんどのデータに固有の動作はによって実行されます、 <xref:System.Windows.Forms.DataGrid>が代わりに、データ ソースをします。  
+  
+ バインドされたデータセット内のデータが任意のメカニズムにより更新された場合、 <xref:System.Windows.Forms.DataGrid>コントロールが変更を反映します。 データ グリッド、表のスタイル、および列のスタイルがある場合、`ReadOnly`プロパティに設定`false`で、データセット内のデータを更新できます、 <xref:System.Windows.Forms.DataGrid>コントロールです。  
+  
+ 1 つのテーブルを表示できる、 <xref:System.Windows.Forms.DataGrid>一度にします。 ユーザーに表示するテーブルを選択して、関連するテーブルの間で移動できる親子リレーションシップを定義する場合のテーブル間の<xref:System.Windows.Forms.DataGrid>コントロールです。 バインドについては、 <xref:System.Windows.Forms.DataGrid>への制御、[!INCLUDE[vstecado](../../../../includes/vstecado-md.md)]デザイン時または実行時に、データ ソースを参照してください[方法: Windows フォーム DataGrid コントロールをデータ ソースにバインド](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)します。  
+  
+ 有効なデータ ソースに、 <xref:System.Windows.Forms.DataGrid>が含まれます。  
+  
+-   <xref:System.Data.DataTable>クラス  
+  
+-   <xref:System.Data.DataView>クラス  
+  
+-   <xref:System.Data.DataSet>クラス  
+  
+-   <xref:System.Data.DataViewManager>クラス  
+  
+ ソースがデータセットの場合、データセットは、フォーム内のオブジェクト、または XML Web サービスによってフォームに渡されるオブジェクトの可能性があります。 型指定されたか、型指定されていないデータセットにバインドできます。  
+  
+ バインドすることも、 <xref:System.Windows.Forms.DataGrid>配列内の要素など、構造内のオブジェクトのパブリック プロパティを公開する場合は、追加の構造を制御します。 グリッドには、構造内の要素のすべてのパブリック プロパティが表示されます。 バインドする場合など、 <xref:System.Windows.Forms.DataGrid>コントロール顧客の配列をオブジェクトに、これらの顧客オブジェクトのすべてのパブリック プロパティをグリッドが表示されます。 場合によっては、構造にバインドすることができますが、結果としてバインドされている構造が、実際のアプリケーションを持たない可能性があることを意味します。 たとえば、整数の配列にバインドできますが、`Integer` データ型はパブリック プロパティをサポートしないため、グリッドがすべてのデータを表示できません。  
+  
+ 要素がパブリック プロパティを公開する場合は、次の構造にバインドできます。  
+  
+-   実装する任意のコンポーネント、 <xref:System.Collections.IList>インターフェイスです。 これには&1; 次元の配列が含まれます。  
+  
+-   実装する任意のコンポーネント、 <xref:System.ComponentModel.IListSource>インターフェイスです。  
+  
+-   実装する任意のコンポーネント、 <xref:System.ComponentModel.IBindingList>インターフェイスです。  
+  
+ 使用できるデータ ソースの詳細については、次を参照してください。 [Windows フォームがサポートされるデータ ソース](../../../../docs/framework/winforms/data-sources-supported-by-windows-forms.md)します。  
+  
+## <a name="grid-display"></a>グリッドの表示  
+ 一般的な用途、 <xref:System.Windows.Forms.DataGrid>コントロールでは、データセットのデータの&1; つのテーブルを表示します。 ただし、関連テーブルを含む複数のテーブルを表示するためにコントロールを使用できます。 グリッドの表示は、データ ソースに応じて自動的に調整されます。 さまざまな構成で表示される内容を次の表に示します。  
+  
+|データ セットの内容|表示される内容|  
+|--------------------------|-----------------------|  
+|1 つのテーブル。|テーブルがグリッドに表示されます。|  
+|複数のテーブル。|グリッドに、ユーザーが移動して表示するテーブルを検索できるツリー ビューを表示できます。|  
+|複数の関連テーブル。|グリッドに、テーブルを選択するツリー ビューを表示でき、グリッドに親テーブルを表示するよう指定することもできます。 親テーブル内のレコードでは、ユーザーが関連する子の行に移動できます。|  
+  
+> [!NOTE]
+>  使用して、データセット内のテーブルが関連する、 <xref:System.Data.DataRelation>します。  参照してください[データセットの HYPERLINK"http://msdn.microsoft.com/library/dbwcse3d(v=vs.110)"リレーションシップ](http://msdn.microsoft.com/library/dbwcse3d\(v=vs.110\))または[データセットのリレーションシップ](http://msdn.microsoft.com/library/dbwcse3d\(v=vs.120\))します。  
+  
+ ときに、 <xref:System.Windows.Forms.DataGrid>コントロールがテーブルに表示され、 <xref:System.Windows.Forms.DataGrid.AllowSorting%2A>にプロパティが設定されている`true`データは、列見出しをクリックして再度並べ替えることができます。 ユーザーは行の追加やセルの編集も実行できます。  
+  
+ 一連のテーブル間のリレーションシップは、ナビゲーションの親/子構造体を使用してユーザーに表示されます。 親テーブルは最高レベルのデータ、および子テーブルは、親テーブルの個別の一覧から派生した個々 のデータ テーブルです。 展開コントロールは、子テーブルを含む各親の行に表示されます。 展開コントロールをクリックすると、子テーブルへの Web のようなリンクの一覧が生成されます。 ユーザーがリンクを選択すると、子テーブルが表示されます。 親行の表示/非表示のアイコンをクリックすると (![親行の表示/非表示のアイコン](../../../../docs/framework/winforms/controls/media/vbicon.png "vbIcon")) は、親テーブルに関する情報を非表示になるか、またはユーザーが非表示に表示します。 ユーザーは、戻るボタンをクリックして、前に表示されていたテーブルに移動することができます。  
+  
+## <a name="columns-and-rows"></a>列と行  
+ <xref:System.Windows.Forms.DataGrid>のコレクションから成る<xref:System.Windows.Forms.DataGridTableStyle>に含まれているオブジェクト、 <xref:System.Windows.Forms.DataGrid>コントロールの<xref:System.Windows.Forms.DataGrid.TableStyles%2A>プロパティです。 テーブルのスタイルのコレクションを含めることが<xref:System.Windows.Forms.DataGridColumnStyle>に含まれているオブジェクト、 <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A>のプロパティ、 <xref:System.Windows.Forms.DataGridTableStyle>. 編集することができます、 <xref:System.Windows.Forms.DataGrid.TableStyles%2A>と<xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A>プロパティからアクセスできるコレクション エディターを使用して、**プロパティ**ウィンドウです。  
+  
+ どの<xref:System.Windows.Forms.DataGridTableStyle>に関連付けられている、 <xref:System.Windows.Forms.DataGrid>経由でアクセスできるコントロール、 <xref:System.Windows.Forms.GridTableStylesCollection>します。 <xref:System.Windows.Forms.GridTableStylesCollection>と共に、デザイナーで編集できます、 <xref:System.Windows.Forms.DataGridTableStyle>コレクション エディターを使用してプログラムによって、または、 <xref:System.Windows.Forms.DataGrid>コントロールの<xref:System.Windows.Forms.DataGrid.TableStyles%2A>プロパティです。  
+  
+ ![DataGrid コントロールに含まれるオブジェクト](../../../../docs/framework/winforms/controls/media/vbcolumns1.png "vbColumns1")  
+DataGrid コントロールに含まれるオブジェクトを次の図に示します。  
+  
+ テーブルのスタイルおよび列のスタイルと同期されます<xref:System.Data.DataTable>のオブジェクトと<xref:System.Data.DataColumn>を設定してオブジェクトの`MappingName`プロパティを適切な<xref:System.Data.DataTable.TableName%2A>と<xref:System.Data.DataColumn.ColumnName%2A>プロパティです。 ときに、 <xref:System.Windows.Forms.DataGridTableStyle>を保持していない列にスタイルを追加、 <xref:System.Windows.Forms.DataGrid> 、有効なデータ ソースにバインドされたコントロールと<xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A>テーブルのスタイルのプロパティが有効に設定されている<xref:System.Data.DataTable.TableName%2A>プロパティ、一連の<xref:System.Windows.Forms.DataGridColumnStyle>オブジェクトを作成してテーブルのスタイルのです。 各<xref:System.Data.DataColumn>で見つかった、<xref:System.Data.DataTable.Columns%2A>のコレクション、 <xref:System.Data.DataTable>、対応する<xref:System.Windows.Forms.DataGridColumnStyle>に追加、 <xref:System.Windows.Forms.GridColumnStylesCollection>します。 <xref:System.Windows.Forms.GridColumnStylesCollection>を通じてアクセス、 <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A>のプロパティ、 <xref:System.Windows.Forms.DataGridTableStyle>します。 列を追加またはグリッドを使用して、削除、<xref:System.Windows.Forms.GridColumnStylesCollection.Add%2A>または<xref:System.Windows.Forms.GridColumnStylesCollection.Remove%2A>メソッドを<xref:System.Windows.Forms.GridColumnStylesCollection>します。 詳細については、次を参照してください。[方法: Windows フォーム DataGrid コントロールに追加のテーブルと列](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)と[方法: 削除] または [Windows フォーム DataGrid コントロールの列を非表示に](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)します。  
+  
+ 列の型のコレクションを拡張、 <xref:System.Windows.Forms.DataGridColumnStyle>豊富な書式設定と編集機能が持つクラス。 すべての列型から継承、 <xref:System.Windows.Forms.DataGridColumnStyle>基本クラスです。 作成されるクラスによって異なります、 <xref:System.Data.DataColumn.DataType%2A>のプロパティ、 <xref:System.Data.DataColumn>元となる、 <xref:System.Web.UI.WebControls.DataGridColumn>基づきます。 たとえば、 <xref:System.Data.DataColumn>を持つその<xref:System.Data.DataColumn.DataType%2A>プロパティに設定<xref:System.Boolean>が関連付けられる、 <xref:System.Windows.Forms.DataGridBoolColumn>します。 各列の型に関する説明を次の表に示します。  
+  
+|列の型|説明|  
+|-----------------|-----------------|  
+|<xref:System.Windows.Forms.DataGridTextBoxColumn>|書式設定された文字列、または書式設定されていない文字列としてデータを受け入れて表示します。 編集機能は同じで、単純なデータを編集する場合と<xref:System.Windows.Forms.TextBox>します。 継承<xref:System.Windows.Forms.DataGridColumnStyle>します。|  
+|<xref:System.Windows.Forms.DataGridBoolColumn>|`true`、`false`、および null 値を受け入れて表示します。 継承<xref:System.Windows.Forms.DataGridColumnStyle>します。|  
+  
+ 列の右端をダブルクリックすると、完全キャプションと最も幅の広いエントリを表示するよう列のサイズを変更します。  
+  
+## <a name="table-styles-and-column-styles"></a>テーブルのスタイルおよび列のスタイル  
+ 既定の形式を確立するとすぐに、 <xref:System.Windows.Forms.DataGrid>コントロール、データ グリッド内の特定のテーブルが表示されるときに使用される色をカスタマイズすることができます。  
+  
+ これのインスタンスを作成するのには、 <xref:System.Windows.Forms.DataGridTableStyle>クラスです。 テーブルのスタイルは、特定のテーブルの既定の書式設定から個別の書式を指定する、 <xref:System.Windows.Forms.DataGrid>自体を制御します。 各テーブルは、定義されたテーブルのスタイルを一度に&1; つのみ持つことができます。  
+  
+ 場合によっては、特定の列の外観を、特定のデータ テーブルの列の残りの部分と異なるものにすることが望ましい場合があります。 カスタマイズされた一連の列のスタイルを作成するにを使用して、 <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A>プロパティです。  
+  
+ 列のスタイルは、表のスタイルがデータ テーブルに関連するのと同じように、データセット内の列に関連します。 各テーブルに一度に&1; つの表のスタイルのみ定義できるように、各列も、特定のテーブルのスタイルで一度に&1; つの列のスタイルのみ定義できます。 このリレーションシップが、列で定義されている<xref:System.Windows.Forms.DataGridColumnStyle.MappingName%2A>プロパティです。  
+  
+ 列のスタイルを追加せずにテーブルのスタイルを作成した場合は、フォームおよびグリッドが実行時に作成されるときに、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] が既定の列のスタイルを追加します。 ただし、テーブルのスタイルを作成して列のスタイルを追加している場合、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] は列のスタイルを作成しません。 また、列のスタイルを定義し、マッピングの名前に割り当てて、グリッドに表示する列を持つようにする必要があります。  
+  
+ 列のスタイルに列を割り当てることでデータ グリッドに含まれる列を指定し、列に割り当てられた列のスタイルがないため、グリッドに表示されていないデータセットのデータの列を含めることができます。 ただし、データセットにデータ列が含まれているため、表示されていないデータをプログラムで編集できます。  
+  
+> [!NOTE]
+>  一般に、表のスタイルをテーブル スタイルのコレクションに追加する前に、列のスタイルを作成し、列のスタイルのコレクションに追加します。 コレクションに空のテーブルのスタイルを追加すると、列のスタイルが自動的に生成されます。 重複した新しい列のスタイルを追加しようとする場合に、例外がスローされますその結果、 <xref:System.Windows.Forms.DataGridColumnStyle.MappingName%2A>列スタイルのコレクションの値。  
+>   
+>  多くの列の中で 1 つのだけ列を微調整することが望ましい場合があります。たとえば、50 の列がデータセットに含まれていて、そのうち 49 のみが必要だとします。 この場合は、プログラムでの 49 個の列をそれぞれプログラムで追加するより、50 のすべての列をインポートし、1 つをプログラムで削除する方が簡単です。  
+  
+## <a name="formatting"></a>書式設定  
+ 書式設定を適用できる、 <xref:System.Windows.Forms.DataGrid>罫線のスタイル、グリッド線のスタイル、フォント、caption プロパティ、データの配置、および行の間の背景色を交互にコントロールが含まれます。 詳細については、次を参照してください。[方法: Windows フォーム DataGrid コントロールの書式設定](../../../../docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md)します。  
+  
+## <a name="events"></a>イベント  
+ 一般的なコントロール イベントのほかなど<xref:System.Windows.Forms.Control.MouseDown>、 <xref:System.Windows.Forms.Control.Enter>、および<xref:System.Windows.Forms.DataGrid.Scroll>、 <xref:System.Windows.Forms.DataGrid>コントロールの編集と、グリッド内での移動に関連付けられたイベントをサポートしています。 <xref:System.Windows.Forms.DataGrid.CurrentCell%2A>プロパティは、どのセルが選択を決定します。 <xref:System.Windows.Forms.DataGrid.CurrentCellChanged>イベントは、ユーザーが新しいセルに移動すると発生します。 ユーザーが、親/子リレーションシップを使用して新しいテーブルに移動すると、 <xref:System.Windows.Forms.DataGrid.Navigate>イベントが発生します。 <xref:System.Windows.Forms.DataGrid.BackButtonClick>イベントは、ユーザーが子テーブルを表示するときに、ユーザーが [戻る] ボタンをクリックすると、 <xref:System.Windows.Forms.DataGrid.ShowParentDetailsButtonClick>親行の表示/非表示のアイコンがクリックされたときにイベントが発生します。  
+  
+## <a name="see-also"></a>関連項目  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [方法: Windows フォーム DataGrid コントロールをデータ ソースにバインドします。](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)   
+ [方法: テーブルを追加し、列を Windows フォーム DataGrid コントロール](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)   
+ [方法: 削除または非表示にする列、Windows フォーム DataGrid コントロール](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)   
+ [方法: Windows フォーム DataGrid コントロールの書式設定](../../../../docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagrid-control-windows-forms.md b/docs/framework/winforms/controls/datagrid-control-windows-forms.md
new file mode 100644
index 00000000000..c9909e1bf84
--- /dev/null
+++ b/docs/framework/winforms/controls/datagrid-control-windows-forms.md
@@ -0,0 +1,92 @@
+---
+title: "DataGrid コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示 (Windows フォームに)"
+  - "データ グリッド"
+  - "DataGrid コントロール [Windows フォーム]"
+  - "データセット [Windows フォーム], 表示 (DataGrid コントロールで)"
+  - "データセット [Windows フォーム], ユーザー インターフェイス"
+  - "表示 (データを), フォーム上に"
+ms.assetid: 1d9d5683-43d2-42dd-b6c3-e43f4cf0de99
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# DataGrid コントロール (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、`DataGrid` コントロールに代わると共に追加の機能を提供します。ただし、`DataGrid` コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの `DataGrid` コントロールはユーザー インターフェイスを [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] データセットに提供し、データを表形式で表示して、データ ソースを更新できるようにします。  
+  
+ `DataGrid` コントロールを有効なデータ ソースに対して設定すると、データの形式に基づいて列と行が作成されたコントロールが自動的に作成されます。  `DataGrid` コントロールを使用すると、1 つのテーブルまたは、複数のテーブル間の階層的なリレーションシップを表示できます。  
+  
+## このセクションの内容  
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)  
+ `DataGrid` コントロールの基本的な機能について説明します。  
+  
+ [方法 : デザイナーを使って Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/add-tables-and-columns-to-wf-datagrid-control-using-the-designer.md)  
+ デザイナーを使用して `DataGrid` コントロールにテーブルと列を追加する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)  
+ プログラムによって `DataGrid` コントロールにテーブルと列を追加する方法について説明します。  
+  
+ [方法 : デザイナーを使ってデータ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/bind-wf-datagrid-control-to-a-data-source-using-the-designer.md)  
+ デザイナーを使用して [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] データセットを `DataGrid` コントロールにバインドする方法について説明します。  
+  
+ [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)  
+ [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] データセットを `DataGrid` コントロールにバインドする方法について説明します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する](../../../../docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md)  
+ `DataGrid` コントロール内でプログラムによってデータを変更する方法について説明します。  
+  
+ [方法 : デザイナーで Windows フォーム DataGrid コントロールを使用してマスター\/詳細リストを作成する](../../../../docs/framework/winforms/controls/create-master-details-lists-with-wf-datagrid-control-using-the-designer.md)  
+ デザイナーを使用して、親子のリレーションシップで結合されている 2 つのテーブルを、2 つの `DataGrid` コントロールに個別に表示する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールを使用してマスター\/詳細リストを作成する](../../../../docs/framework/winforms/controls/how-to-create-master-detail-lists-with-the-windows-forms-datagrid-control.md)  
+ 親子のリレーションシップで結合されている 2 つのテーブルを、2 つの `DataGrid` コントロールに個別に表示する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)  
+ `DataGrid` コントロール内で列を削除する方法について説明します。  
+  
+ [方法 : デザイナーを使って Windows フォーム DataGrid コントロールの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control-using-the-designer.md)  
+ デザイナーを使用して、`DataGrid` コントロールの外観に関連するプロパティを変更する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md)  
+ `DataGrid` コントロールの外観に関連するプロパティを変更する方法について説明します。  
+  
+ [Windows フォームの DataGrid コントロール内の移動に使用できるキーボード ショートカット](../../../../docs/framework/winforms/controls/keyboard-shortcuts-for-the-windows-forms-datagrid-control.md)  
+ `DataGrid` コントロール内の移動に使用できるキーボード ショートカットの一覧を示します。  
+  
+ [方法 : Windows フォーム DataGrid コントロールのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-clicks-in-the-windows-forms-datagrid-control.md)  
+ ユーザーがクリックした `DataGrid`コントロール内のセルを確認する方法を説明します。  
+  
+ [方法 : Windows フォームの DataGrid コントロールを使用して入力データを検証する](../../../../docs/framework/winforms/controls/how-to-validate-input-with-the-windows-forms-datagrid-control.md)  
+ `DataGrid` コントロールにバインドされたデータセット内の入力データを検証する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGrid>  
+ <xref:System.Windows.Forms.DataGrid> クラスの概要を説明します。  
+  
+ <xref:System.Windows.Forms.DataGrid.DataSource%2A>  
+ このプロパティを使用して、データに <xref:System.Windows.Forms.DataGrid> コントロールをバインドする方法についての詳細を説明します。  
+  
+## 関連項目  
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)  
+ Windows フォームのデータ結合に関するトピックへのリンクを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md
new file mode 100644
index 00000000000..e0a2caef030
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md
@@ -0,0 +1,156 @@
+---
+title: "DataGridView コントロールのアーキテクチャ (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], アーキテクチャ"
+ms.assetid: 1c6cabf0-02ee-4bbc-9574-b54bb7f5b19e
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# DataGridView コントロールのアーキテクチャ (Windows フォーム)
+<xref:System.Windows.Forms.DataGridView> コントロールとその関連クラスは、表形式のデータを表示および編集するための柔軟で拡張可能なシステムとして設計されています。  これらのクラスはすべて <xref:System.Windows.Forms?displayProperty=fullName> 名前空間に含まれており、どのクラス名にも "DataGridView" というプリフィックスが付いています。  
+  
+## アーキテクチャの要素  
+ <xref:System.Windows.Forms.DataGridView> の主要なコンパニオン クラスは <xref:System.Windows.Forms.DataGridViewElement> から派生しています。  次のオブジェクト モデルは、<xref:System.Windows.Forms.DataGridViewElement> 継承階層構造を示しています。  
+  
+ ![DataGridViewElement オブジェクト モデル](../../../../docs/framework/winforms/controls/media/datagridviewelement.png "DataGridViewElement")  
+DataGridViewElement オブジェクト モデル  
+  
+ <xref:System.Windows.Forms.DataGridViewElement> クラスは親となる <xref:System.Windows.Forms.DataGridView> コントロールへの参照を提供し、<xref:System.Windows.Forms.DataGridViewElement.State%2A> プロパティを備えています。このプロパティは、<xref:System.Windows.Forms.DataGridViewElementStates> 列挙体の値の組み合わせを表す値を取ります。  
+  
+ 以下のセクションでは、<xref:System.Windows.Forms.DataGridView> のコンパニオン クラスについて詳しく説明します。  
+  
+### DataGridViewElementStates  
+ <xref:System.Windows.Forms.DataGridViewElementStates> 列挙体には次の値が含まれます。  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+-   <xref:System.Windows.Forms.DataGridViewElementStates>  
+  
+ この列挙体の値はビット単位の論理演算子と組み合わせて使用できるため、<xref:System.Windows.Forms.DataGridViewElement.State%2A> プロパティで一度に複数の状態を表現できます。  たとえば、<xref:System.Windows.Forms.DataGridViewElement> を <xref:System.Windows.Forms.DataGridViewElementStates> かつ <xref:System.Windows.Forms.DataGridViewElementStates> かつ <xref:System.Windows.Forms.DataGridViewElementStates> の状態にすることができます。  
+  
+### セルとバンド  
+ <xref:System.Windows.Forms.DataGridView> コントロールは、セルとバンドという 2 種類の基本オブジェクトから構成されています。  すべてのセルは <xref:System.Windows.Forms.DataGridViewCell> 基本クラスから派生しています。  バンドには <xref:System.Windows.Forms.DataGridViewColumn> と <xref:System.Windows.Forms.DataGridViewRow> の 2 種類があり、どちらも <xref:System.Windows.Forms.DataGridViewBand> 基本クラスから派生しています。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールはさまざまなクラスとやり取りを行いますが、最もよく使用されるのは <xref:System.Windows.Forms.DataGridViewCell>、<xref:System.Windows.Forms.DataGridViewColumn>、<xref:System.Windows.Forms.DataGridViewRow> です。  
+  
+### DataGridViewCell  
+ セルは <xref:System.Windows.Forms.DataGridView> で行われるやり取りの基本単位です。  表示はセルを中心として行われますし、多くの場合、データ入力はセルを通じて実行されます。  セルにアクセスするには、<xref:System.Windows.Forms.DataGridViewRow> クラスの <xref:System.Windows.Forms.DataGridViewRow.Cells%2A> コレクションを使用します。選択中のセルにアクセスするには、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.SelectedCells%2A> コレクションを使用します。  次のオブジェクト モデルは、この使用方法と <xref:System.Windows.Forms.DataGridViewCell> 継承階層構造を示しています。  
+  
+ ![DataGridViewCell オブジェクト モデル](../../../../docs/framework/winforms/controls/media/datagridviewcell.png "DataGridViewCell")  
+DataGridViewCell オブジェクト モデル  
+  
+ <xref:System.Windows.Forms.DataGridViewCell> 型は、すべてのセル型の派生元となる抽象基本クラスです。  <xref:System.Windows.Forms.DataGridViewCell> とその派生型は Windows フォーム コントロールではありませんが、その中のいくつかは Windows フォーム コントロールをホストします。  セルで使用できる編集機能は、通常は、ホストされるコントロールによって処理されます。  
+  
+ <xref:System.Windows.Forms.DataGridViewCell> オブジェクトの外観と描画機能は、Windows フォーム コントロールとは異なる方法で制御されています。  <xref:System.Windows.Forms.DataGridViewCell> オブジェクトの外観を制御しているのは <xref:System.Windows.Forms.DataGridView> です。  <xref:System.Windows.Forms.DataGridView> コントロールのプロパティとイベントを操作することで、セルの外観と動作を大幅にカスタマイズです。  <xref:System.Windows.Forms.DataGridView> コントロールの機能を越える特殊なカスタマイズを行うときは、<xref:System.Windows.Forms.DataGridViewCell> またはその子クラスから派生した独自のクラスを実装します。  
+  
+ <xref:System.Windows.Forms.DataGridViewCell> から派生しているクラスを次に示します。  
+  
+-   <xref:System.Windows.Forms.DataGridViewTextBoxCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewButtonCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewLinkCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCheckBoxCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewComboBoxCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewImageCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewHeaderCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewRowHeaderCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumnHeaderCell>  
+  
+-   <xref:System.Windows.Forms.DataGridViewTopLeftHeaderCell>  
+  
+-   カスタムのセル型  
+  
+### DataGridViewColumn  
+ <xref:System.Windows.Forms.DataGridView> コントロールに関連付けられているデータ ストアのスキーマは、<xref:System.Windows.Forms.DataGridView> コントロールの列で表現されます。  <xref:System.Windows.Forms.DataGridView> コントロールの列にアクセスするには、<xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションを使用します。  選択中の列にアクセスするには、<xref:System.Windows.Forms.DataGridView.SelectedColumns%2A> コレクションを使用します。  次のオブジェクト モデルは、この使用方法と <xref:System.Windows.Forms.DataGridViewColumn> 継承階層構造を示しています。  
+  
+ ![DataGridViewColumn オブジェクト モデル](../../../../docs/framework/winforms/controls/media/datagridviewcolumn.png "DataGridViewColumn")  
+DataGridViewColumn オブジェクト モデル  
+  
+ いくつかの重要なセル型には、対応する列型があります。  これらの型は <xref:System.Windows.Forms.DataGridViewColumn> 基本クラスから派生しています。  
+  
+ <xref:System.Windows.Forms.DataGridViewColumn> から派生しているクラスを次に示します。  
+  
+-   <xref:System.Windows.Forms.DataGridViewButtonColumn>  
+  
+-   <xref:System.Windows.Forms.DataGridViewCheckBoxColumn>  
+  
+-   <xref:System.Windows.Forms.DataGridViewComboBoxColumn>  
+  
+-   <xref:System.Windows.Forms.DataGridViewImageColumn>  
+  
+-   <xref:System.Windows.Forms.DataGridViewTextBoxColumn>  
+  
+-   <xref:System.Windows.Forms.DataGridViewLinkColumn>  
+  
+-   カスタムの列型  
+  
+### DataGridView 編集コントロール  
+ 高度な編集機能をサポートしているセルは、通常は、Windows フォーム コントロールから派生したホストされるコントロールを使用しています。  これらのコントロールは <xref:System.Windows.Forms.IDataGridViewEditingControl> インターフェイスも実装しています。  次のオブジェクト モデルは、これらのコントロールの使用方法を示しています。  
+  
+ ![DataGridView 編集コントロール オブジェクト モデル](../../../../docs/framework/winforms/controls/media/datagridviewediting.png "DataGridViewEditing")  
+DataGridView 編集コントロール オブジェクト モデル  
+  
+ 次の編集コントロールは <xref:System.Windows.Forms.DataGridView> コントロールによって提供されます。  
+  
+-   <xref:System.Windows.Forms.DataGridViewComboBoxEditingControl>  
+  
+-   <xref:System.Windows.Forms.DataGridViewTextBoxEditingControl>  
+  
+ 独自の編集コントロールを作成する方法については、「[方法 : Windows フォーム DataGridView Cells でコントロールをホストする](../../../../docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md)」を参照してください。  
+  
+ 次の表は、セル型、列型、編集コントロールの関係を示しています。  
+  
+|セル型|ホストされるコントロール|列型|  
+|---------|------------------|--------|  
+|<xref:System.Windows.Forms.DataGridViewButtonCell>|適用なし|<xref:System.Windows.Forms.DataGridViewButtonColumn>|  
+|<xref:System.Windows.Forms.DataGridViewCheckBoxCell>|適用なし|<xref:System.Windows.Forms.DataGridViewCheckBoxColumn>|  
+|<xref:System.Windows.Forms.DataGridViewComboBoxCell>|<xref:System.Windows.Forms.DataGridViewComboBoxEditingControl>|<xref:System.Windows.Forms.DataGridViewComboBoxColumn>|  
+|<xref:System.Windows.Forms.DataGridViewImageCell>|適用なし|<xref:System.Windows.Forms.DataGridViewImageColumn>|  
+|<xref:System.Windows.Forms.DataGridViewLinkCell>|適用なし|<xref:System.Windows.Forms.DataGridViewLinkColumn>|  
+|<xref:System.Windows.Forms.DataGridViewTextBoxCell>|<xref:System.Windows.Forms.DataGridViewTextBoxEditingControl>|<xref:System.Windows.Forms.DataGridViewTextBoxColumn>|  
+  
+### DataGridViewRow  
+ <xref:System.Windows.Forms.DataGridViewRow> クラスは、<xref:System.Windows.Forms.DataGridView> コントロールのバインド先のデータ ストアに含まれているレコードのデータ フィールドを表示します。  <xref:System.Windows.Forms.DataGridView> コントロールの行にアクセスするには、<xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションを使用します。  選択中の行にアクセスするには、<xref:System.Windows.Forms.DataGridView.SelectedRows%2A> コレクションを使用します。  次のオブジェクト モデルは、この使用方法と <xref:System.Windows.Forms.DataGridViewRow> 継承階層構造を示しています。  
+  
+ ![DataGridViewRow オブジェクト モデル](../../../../docs/framework/winforms/controls/media/datagridviewrow.png "DataGridViewRow")  
+DataGridViewRow オブジェクト モデル  
+  
+ <xref:System.Windows.Forms.DataGridViewRow> から独自の型を派生させることもできますが、通常はその必要はありません。  <xref:System.Windows.Forms.DataGridView> コントロールには、<xref:System.Windows.Forms.DataGridViewRow> オブジェクトの動作をカスタマイズするための行関連のイベントとプロパティが数多く用意されています。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A> プロパティを有効にすると、新しい行を追加するための特殊な行が最終行として表示されます。  この行は <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションの一部ですが、特殊な機能を備えているので注意が必要です。  詳細については、「[Windows フォーム DataGridView コントロールにおける新規レコード行の使用](../../../../docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ [DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールにおける新規レコード行の使用](../../../../docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-code-directory-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-code-directory-windows-forms.md
new file mode 100644
index 00000000000..f122c00b14d
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-code-directory-windows-forms.md
@@ -0,0 +1,166 @@
+---
+title: "DataGridView コントロールのコード ディレクトリ (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 例"
+  - "DataGridView コントロール [Windows フォーム], コード ディレクトリ"
+  - "DataGridView コントロール [Windows フォーム], 例"
+  - "例 [Windows フォーム], DataGridView コントロール"
+ms.assetid: ea8bd66a-5ed6-491b-b9da-63873e275a0a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# DataGridView コントロールのコード ディレクトリ (Windows フォーム)
+このトピックでは、ドキュメントに用意されている、<xref:System.Windows.Forms.DataGridView> に関連するコード例へのリンクを示します。  
+  
+> [!NOTE]
+>  すべてのリンクのジャンプ先は、コード例が含まれているトピックの先頭です。  
+  
+ クラス ライブラリのリファレンス ドキュメントには、追加的なコード例があります。  <xref:System.Windows.Forms.DataGridView> コントロールに関連する主要なクラスおよびインターフェイスの一覧については、「[DataGridView コントロール テクノロジの概要](../../../../docs/framework/winforms/controls/datagridview-control-technology-summary-windows-forms.md)」の表を参照してください。  
+  
+## コードリスト  
+  
+## バインドされていないデータの例  
+  
+-   [方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する](../../../../docs/framework/winforms/controls/unbound-column-to-a-data-bound-datagridview.md)  
+  
+-   [方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md)  
+  
+-   [チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)  
+  
+## データ バインディングの例  
+  
+-   [方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : データバインドされた Windows フォーム DataGridView コントロールに列を自動生成する](../../../../docs/framework/winforms/controls/autogenerate-columns-in-a-data-bound-wf-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する](../../../../docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md)  
+  
+-   [方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md)  
+  
+-   [方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする](../../../../docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md)  
+  
+-   [方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター\/詳細形式のフォームを作成する](../../../../docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md)  
+  
+-   [チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター\/詳細形式のフォームの作成](../../../../docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md)  
+  
+## データの書式指定の例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)  
+  
+## データの妥当性検査の例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのデータを検証する](../../../../docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md)  
+  
+-   [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する](../../../../docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md)  
+  
+-   [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)  
+  
+## 外観のカスタマイズの例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする](../../../../docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md)  
+  
+## 動作のカスタマイズの例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの編集モードを指定する](../../../../docs/framework/winforms/controls/how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する](../../../../docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する](../../../../docs/framework/winforms/controls/perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md)  
+  
+-   [方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする](../../../../docs/framework/winforms/controls/enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの各セルにツールヒントを追加する](../../../../docs/framework/winforms/controls/add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する](../../../../docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md)  
+  
+## 列の操作の例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](../../../../docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォームの DataGridView コントロールの列を非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-columns-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの列ヘッダーを非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する](../../../../docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する](../../../../docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの列を操作する](../../../../docs/framework/winforms/controls/how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md)  
+  
+## 行および列のサイズ変更の例  
+  
+-   [Windows フォーム DataGridView コントロールの列フィル モード](../../../../docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する](../../../../docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する](../../../../docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md)  
+  
+## 選択の例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの選択モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの選択されたセル、行、および列を取得する](../../../../docs/framework/winforms/controls/selected-cells-rows-and-columns-datagridview.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールの現在のセルを取得および設定する](../../../../docs/framework/winforms/controls/get-and-set-the-current-cell-wf-datagridview-control.md)  
+  
+## 高度なカスタマイズの例  
+  
+-   [方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](../../../../docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)  
+  
+-   [方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする](../../../../docs/framework/winforms/controls/disable-buttons-in-a-button-column-in-the-datagrid.md)  
+  
+-   [方法 : Windows フォーム DataGridView Cells でコントロールをホストする](../../../../docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md)  
+  
+## 高度なデータの例  
+  
+-   [方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する](../../../../docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md)  
+  
+-   [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)  
+  
+-   [Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md
new file mode 100644
index 00000000000..f86390aa1a1
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md
@@ -0,0 +1,95 @@
+---
+title: "DataGridView コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DataGridView"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, DataGridView コントロール"
+  - "列 [Windows フォーム], DataGridView コントロール"
+  - "データ [Windows フォーム], 移動"
+  - "データ [Windows フォーム], 並べ替え"
+  - "データ バインディング, DataGridView コントロール"
+  - "データ グリッド, データ グリッドの概要"
+  - "データ ソース, バインド (DataGridView コントロールに)"
+  - "DataGridView コントロール [Windows フォーム], DataGridView コントロールの概要"
+  - "DataGridView コントロール [Windows フォーム], データ バインディング"
+  - "データセット [Windows フォーム], バインド (DataGridView コントロールに)"
+  - "グリッド コントロール [Windows フォーム]"
+  - "グリッド [Windows フォーム]"
+  - "テーブル [Windows フォーム], バインド (DataGridView コントロールに)"
+  - "テーブル [Windows フォーム], 表示 (DataGridView コントロール内に)"
+ms.assetid: 0a45c661-89dc-4390-9cc6-c47eee501488
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# DataGridView コントロールの概要 (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールを使用すると、さまざまな種類のデータ ソースのデータを表形式で表示したり編集したりできます。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールにデータをバインディングする方法は簡単で直感的であり、多くの場合は、<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティを設定するのと同じくらい簡単です。  複数のリストまたはテーブルを含んでいるデータ ソースにバインドするときは、<xref:System.Windows.Forms.DataGridView.DataMember%2A> プロパティに、バインド先のリストまたはテーブルを表す文字列を設定します。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは Windows フォームの標準データ バインディング モデルをサポートしているので、次の一覧に示すクラスのインスタンスにバインドできます。  
+  
+-   <xref:System.Collections.IList> インターフェイスを実装しているクラス \(1 次元配列も含む\)  
+  
+-   <xref:System.ComponentModel.IListSource> インターフェイスを実装しているクラス \(<xref:System.Data.DataTable> クラスや <xref:System.Data.DataSet> クラスなど\)  
+  
+-   <xref:System.ComponentModel.IBindingList> インターフェイスを実装しているクラス \(<xref:System.ComponentModel.BindingList%601> クラスなど\)  
+  
+-   <xref:System.ComponentModel.IBindingListView> インターフェイスを実装しているクラス \(<xref:System.Windows.Forms.BindingSource> クラスなど\)  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは、これらのインターフェイスによって返されるオブジェクトのパブリック プロパティへのデータ バインディングをサポートしており、返されるオブジェクトが <xref:System.ComponentModel.ICustomTypeDescriptor> インターフェイスを実装している場合は、このインターフェイスによって返されるプロパティ コレクションへのデータ バインディングもサポートします。  
+  
+ 通常は、<xref:System.Windows.Forms.BindingSource> コンポーネントにバインドし、その <xref:System.Windows.Forms.BindingSource> コンポーネントを別のデータ ソースにバインドするか、ビジネス オブジェクトを使用してこのコンポーネントにデータを設定します。  データ ソースとしては <xref:System.Windows.Forms.BindingSource> コンポーネントを使用することをお勧めします。このコンポーネントはさまざまな種類のデータ ソースにバインドでき、データ バインディングに関する多くの問題を自動的に解決できるからです。  詳細については、「[BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは、関連付けられたデータ ストアを持たない*非バインド* モードでも使用できます。  バインドされていない <xref:System.Windows.Forms.DataGridView> コントロールを使用するコード例については、「[チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは柔軟な設定ができ、拡張性に優れています。また、外観と動作をカスタマイズするためのさまざまなプロパティ、メソッド、およびイベントを備えています。  Windows フォーム アプリケーションで表形式のデータを表示するときには、他の <xref:System.Windows.Forms.DataGrid> などのコントロールを使用する前に、まず <xref:System.Windows.Forms.DataGridView> コントロールを検討してください。  小さなグリッドや読み取り専用の値を表示する場合、または数百万件のレコードを含むテーブルをユーザーが編集できるようにする場合は、<xref:System.Windows.Forms.DataGridView> コントロールを使用すると、プログラミング可能でメモリ効率の良い解決策を実現できます。  
+  
+## このセクションの内容  
+ [DataGridView コントロール テクノロジの概要](../../../../docs/framework/winforms/controls/datagridview-control-technology-summary-windows-forms.md)  
+ <xref:System.Windows.Forms.DataGridView> コントロールの概念と関連クラスの使い方についての概要を示します。  
+  
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)  
+ <xref:System.Windows.Forms.DataGridView> コントロールのアーキテクチャを示し、型階層と継承構造について説明します。  
+  
+ [DataGridView コントロールのシナリオ](../../../../docs/framework/winforms/controls/datagridview-control-scenarios-windows-forms.md)  
+ <xref:System.Windows.Forms.DataGridView> コントロールが使用される最も一般的なシナリオについて説明します。  
+  
+ [DataGridView コントロールのコード ディレクトリ](../../../../docs/framework/winforms/controls/datagridview-control-code-directory-windows-forms.md)  
+ <xref:System.Windows.Forms.DataGridView> を使用したさまざまなタスクのコード例へのリンクを示します。  コード例はタスクの種類ごとに分類されています。  
+  
+## 関連項目  
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)  
+ Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロール内で、情報を表示するため、およびユーザーが情報を追加または修正するために使う列の種類について説明します。  
+  
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)  
+ コントロールの内容を手動で作成する方法と、外部データ ソースから取得する方法についてのトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)  
+ <xref:System.Windows.Forms.DataGridView> のセルと行を独自に描画する方法と、セル、列、行の派生型を作成する方法についてのトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)  
+ 大量のデータを扱うときのパフォーマンスの問題を避けるために、このコントロールを効率的に使用する方法についてのトピックを示します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの既定の機能](../../../../docs/framework/winforms/controls/default-functionality-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理](../../../../docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-scenarios-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-scenarios-windows-forms.md
new file mode 100644
index 00000000000..fdfc7ebed6c
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-scenarios-windows-forms.md
@@ -0,0 +1,100 @@
+---
+title: "DataGridView コントロールのシナリオ (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示 (表形式で)"
+  - "データ グリッド, データ グリッドの概要"
+  - "DataGridView コントロール [Windows フォーム], シナリオ"
+ms.assetid: 09a5fd05-3447-47ec-a4ec-6082a2b7f0dd
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# DataGridView コントロールのシナリオ (Windows フォーム)
+<xref:System.Windows.Forms.DataGridView> コントロールでは、さまざまなデータ ソースから取得した表形式のデータを表示できます。  単純な使い方では、<xref:System.Windows.Forms.DataGridView> コントロールに手動でデータを埋め込み、このコントロールを通じてデータを直接操作します。  しかし一般的な方法では、外部データ ソースにデータを格納しておき、<xref:System.Windows.Forms.BindingSource> コンポーネントを通じてこのコントロールをデータにバインドします。  
+  
+ ここでは、<xref:System.Windows.Forms.DataGridView> コントロールを使用する一般的なシナリオをいくつか紹介します。  
+  
+## シナリオ 1: 少量のデータを表示する  
+ <xref:System.Windows.Forms.DataGridView> コントロールにデータを表示するときに、そのデータを必ず外部データ ソースに格納しなければならないわけではありません。  少量のデータを扱う場合には、そのデータをコントロールに手動で埋め込み、コントロールを通じてデータを操作できます。  これは*非バインド モード*と呼ばれます。  詳細については、「[方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### シナリオの要点  
+  
+-   非バインド モードでは、コントロールに手動でデータを埋め込みます。  
+  
+-   非バインド モードは、少量の読み取り専用データを扱うときに適しています。  
+  
+-   非バインド モードは、スプレッドシートのようなテーブルや、部分的にデータが含まれているテーブルにも適しています。  
+  
+## シナリオ 2: 外部データ ソースに格納されているデータを表示および更新する  
+ <xref:System.Windows.Forms.DataGridView> コントロールを、ユーザーがデータベース テーブルやビジネス オブジェクトのコレクションなどのデータ ソース内のデータにアクセスするときに使うユーザー インターフェイス \(UI\) として使用することができます。  詳細については、「[方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### シナリオの要点  
+  
+-   バインド モードでは、データ ソースに接続し、データ ソースのプロパティやデータベース列に基づいて自動的に列を生成し、コントロールに自動的にデータを読み込むことができます。  
+  
+-   バインド モードは、ユーザーがデータ操作を頻繁に行う場合に適しています。  データを表示用にフォーマットしたり、ユーザーが指定したデータをデータ ソース側で定義されている形式へと自動フォーマットしたりできます。  データ入力フォーマット エラーやデータベース制約エラーを検出し、ユーザーに警告を出したり、問題のあるセルを訂正したりすることもできます。  
+  
+-   ユーザーは列の並べ替え、固定、順序変更などの追加機能を使用して、ワークフローに最も適した方法でデータを表示できます。  
+  
+-   クリップボード サポートにより、ユーザーはアプリケーションから別のアプリケーションにデータをコピーできます。  
+  
+## シナリオ 3: 高度なデータ  
+ 標準のデータ バインディング モデルでは対応できない特別な要件がある場合は、*仮想モード*を実装することで、コントロールとデータとのやり取りを管理できます。  仮想モードを実装するとは、コントロールがセルに関する情報を必要なときに要求できるようにするイベント ハンドラーを実装することです。  
+  
+ たとえば、大量のデータを扱う場合には、仮想モードを実装することで最適な効率を確保できます。  仮想モードは、別のデータ ソースから取得した列と一緒に表示されているバインドされていない列の値を保守する場合にも役立ちます。  
+  
+ 仮想モードの詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+### シナリオの要点  
+  
+-   仮想モードは、高いパフォーマンスを保ちつつ大量のデータを表示しなければならないときに適しています。  
+  
+## シナリオ 4: 行と列のサイズを自動調整する  
+ 定期的に更新されるデータを表示するときは、すべての内容が表示されるように自動的に行と列のサイズを変更できます。  <xref:System.Windows.Forms.DataGridView> コントロールには、手動でのサイズ変更を有効\/無効にしたり、特定のタイミングでサイズをプログラムから変更したり、内容が変化したときに自動的にサイズを調整したりするオプションが用意されています。  詳細については、「[Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### シナリオの要点  
+  
+-   手動でのサイズ変更を有効にすると、ユーザーがセルの高さと幅を調整できます。  
+  
+-   自動サイズ変更を有効にすると、セルの内容がクリップされないようにセルのサイズを調整できます。  
+  
+-   プログラム的なサイズ変更を行うと、特定のタイミングでセルのサイズを変更することができ、連続的な自動サイズ変更によるパフォーマンス低下を回避できます。  
+  
+## シナリオ 5: 単純なカスタマイズ  
+ <xref:System.Windows.Forms.DataGridView> コントロールの基本的な外観と動作はさまざまな方法で変更できます。  詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### シナリオの要点  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを使用すると、コントロールの個々の要素に関する色、フォント、形式、位置の情報をさまざまなレベルで設定できます。  
+  
+-   セルのスタイルは複数の要素で重ねたり共有したりできるので、コードを再使用できます。  
+  
+## シナリオ 6: 高度なカスタマイズ  
+ <xref:System.Windows.Forms.DataGridView> コントロールの外観と動作はさまざまな方法でカスタマイズできます。  
+  
+### シナリオの要点  
+  
+-   独自のセル描画コードを記述できます。  詳細については、「[方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)」を参照してください。  
+  
+-   独自の行描画コードを記述できます。  この手法は、複数の列にまたがる内容を含んだ行を作成するときに役立ちます。  詳細については、「[方法 : Windows フォームの DataGridView コントロールの行の外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-rows-in-the-datagrid.md)」を参照してください。  
+  
+-   独自のセル クラスや列クラスを実装して、セルの外観をカスタマイズすることができます。  詳細については、「[方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](../../../../docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)」を参照してください。  
+  
+-   組み込みの列型ではサポートされないコントロールをホストする独自のセル クラスや列クラスを実装できます。  詳細については、「[方法 : Windows フォーム DataGridView Cells でコントロールをホストする](../../../../docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-technology-summary-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-technology-summary-windows-forms.md
new file mode 100644
index 00000000000..67f8db26b4f
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-technology-summary-windows-forms.md
@@ -0,0 +1,75 @@
+---
+title: "DataGridView コントロール テクノロジの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, データ グリッドの概要"
+  - "DataGridView コントロール [Windows フォーム], DataGridView コントロールの概要"
+ms.assetid: 094498c3-a126-4a3f-83fe-f69e96c7717b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# DataGridView コントロール テクノロジの概要 (Windows フォーム)
+ここでは、`DataGridView` コントロールおよびその使用をサポートしているクラスの概要について説明します。  
+  
+ データを表形式で表示するというタスクは頻繁に実行されます。  `DataGridView` コントロールは、データをグリッドに表示するための解決策としてデザインされたものです。  
+  
+## Keywords  
+ DataGridView、BindingSource、テーブル、セル、データ バインディング、仮想モード  
+  
+## 名前空間  
+ <xref:System.Windows.Forms?displayProperty=fullName>  
+  
+ <xref:System.Data?displayProperty=fullName>  
+  
+## 関連技術  
+ `BindingSource`  
+  
+## 背景  
+ ユーザー インターフェイス \(UI\) デザイナーは、表形式のデータをユーザーに表示しなければならない場面に頻繁に遭遇します。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] には、データをテーブルまたはグリッドに表示するための方法がいくつか用意されています。  `DataGridView` コントロールは、Windows フォーム アプリケーションで使用できるこの分野の最新機能です。  
+  
+ `DataGridView` コントロールでは、データ ストア内のデータの行を表示できます。  何種類のものデータ ストアがサポートされています。  データ ストアには、単純な型指定されていないデータ \(1 次元配列など\) を格納することも、型指定されたデータ \(<xref:System.Data.DataSet> など\) を格納することもできます。  詳細については、「[方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ `DataGridView` コントロールには、データを表形式で表示するための強力で柔軟な機能が用意されています。  このコントロールを使用して、小さなデータ セットから非常に大きなデータ セットまでの読み取り専用ビューまたは編集可能ビューを表示できます。  
+  
+ `DataGridView` コントロールをさまざまな方法で拡張して、アプリケーションにカスタム動作を組み込むことができます。  たとえば、プログラムで独自の並べ替えアルゴリズムを指定したり、独自の種類のセルを作成したりできます。  `DataGridView` コントロールの外観は、いくつかのプロパティを選択することで簡単にカスタマイズできます。  `DataGridView` コントロールはさまざまな種類のデータ ストアをデータ ソースとして使用でき、また、データ ソースをバインドしていない状態でも機能します。  
+  
+## DataGridView クラスの実装  
+ `DataGridView` コントロールの拡張機能を利用するには、いくつかの方法があります。  イベントとプロパティを通じてコントロールのさまざまな側面をカスタマイズできますが、ある種のカスタマイズを行うときには、既存の `DataGridView` クラスから派生した新しいクラスを作成する必要があります。  
+  
+ 最もよく使用される基本クラスは `DataGridViewCell` と `DataGridViewColumn` です。  `DataGridViewCell` またはその任意の子クラスから独自のセル クラスを派生させることができます。  任意の列に任意のセル型を追加できますが、通常は、カスタム セル型のセルを既定でホストする対になる列クラスを `DataGridViewColumn` から派生させます。  
+  
+ 派生セル クラス内で `IDataGridViewEditingCell` インターフェイスを実装すると、編集機能を備えつつ編集モードでコントロールをホストしないセル型を作成できます。  編集モードのセル内でホストできるコントロールを作成するには、<xref:System.Windows.Forms.Control> から派生したクラス内で `IDataGridViewEditingControl` インターフェイスを実装します。  
+  
+ 詳細については、「[方法 : Windows フォーム DataGridView コントロールのセルと列を、それぞれの動作と外観を拡張してカスタマイズする](../../../../docs/framework/winforms/controls/customize-cells-and-columns-in-the-datagrid-by-extending-behavior.md)」および「[方法 : Windows フォーム DataGridView Cells でコントロールをホストする](../../../../docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md)」を参照してください。  
+  
+## DataGridView クラスの概要  
+ <xref:System.Windows.Forms>  
+  
+|テクノロジの領域|クラス\/インターフェイス\/構成要素|  
+|--------------|-------------------------|  
+|データ バインディング|<xref:System.Windows.Forms.BindingSource>|  
+|データ プレゼンテーション|<xref:System.Windows.Forms.DataGridView><br /><br /> <xref:System.Windows.Forms.DataGridViewCell> と派生クラス<br /><br /> <xref:System.Windows.Forms.DataGridViewRow> と派生クラス<br /><br /> <xref:System.Windows.Forms.DataGridViewColumn> と派生クラス<br /><br /> <xref:System.Windows.Forms.DataGridViewCellStyle>|  
+|<xref:System.Windows.Forms.DataGridView> 拡張機能|<xref:System.Windows.Forms.DataGridViewCell> と派生クラス<br /><br /> <xref:System.Windows.Forms.DataGridViewColumn> と派生クラス<br /><br /> <xref:System.Windows.Forms.IDataGridViewEditingCell><br /><br /> <xref:System.Windows.Forms.IDataGridViewEditingControl>|  
+  
+## 新機能  
+ <xref:System.Windows.Forms.DataGridView> コントロールは、Windows フォームで表形式のデータを表示するための完璧な解決策としてデザインされたものです。  新しいアプリケーションを作成しているときは、<xref:System.Windows.Forms.DataGrid> などの他の方法を探す前に、<xref:System.Windows.Forms.DataGridView> コントロールを使用することを検討してください。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールは <xref:System.Windows.Forms.BindingSource> コンポーネントと密接に組み合わせて使用されます。  このコンポーネントはフォームの主要なデータ ソースとしてデザインされたものです。  このコンポーネントは、<xref:System.Windows.Forms.DataGridView> コントロールとデータ ソースとのやり取りをデータ ソースの種類に関係なく管理します。  
+  
+## 参照  
+ [DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)   
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datagridview-control-windows-forms.md b/docs/framework/winforms/controls/datagridview-control-windows-forms.md
new file mode 100644
index 00000000000..7aad17e1edb
--- /dev/null
+++ b/docs/framework/winforms/controls/datagridview-control-windows-forms.md
@@ -0,0 +1,95 @@
+---
+title: "DataGridView コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示 (表形式で)"
+  - "データ グリッド"
+  - "データの表示形式"
+  - "DataGridView コントロール [Windows フォーム]"
+  - "データセット [Windows フォーム], 表示 (DataGridView コントロール内に)"
+  - "データセット [Windows フォーム], ユーザー インターフェイス"
+  - "グリッド コントロール [Windows フォーム]"
+  - "テーブル [Windows フォーム]"
+  - "表データ, 表示 (Windows フォームに)"
+  - "Windows フォーム, 表示 (データを)"
+ms.assetid: dbee73f2-bba6-4874-9389-cd21d44309be
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# DataGridView コントロール (Windows フォーム)
+`DataGridView` コントロールには、データを表形式で表示するための強力で柔軟な機能が用意されています。  `DataGridView` コントロールを使用すると、読み取り専用のビューに少量のデータを表示したり、拡大して非常に大量のデータのセットの編集可能なビューを表示したりできます。  
+  
+ `DataGridView` コントロールはいくつかの方法で拡張でき、アプリケーションにカスタムの動作を組み込むことができます。  たとえば、プログラムで独自の並べ替えアルゴリズムを指定したり、独自の種類のセルを作成したりできます。  `DataGridView` コントロールの外観は、いくつかのプロパティを選択することで簡単にカスタマイズできます。  `DataGridView` コントロールでは、多くの種類のデータ ストアをデータ ソースとして使用できますが、データ ソースをバインドせずに動作させることもできます。  
+  
+ このセクションのトピックでは、`DataGridView` の機能をアプリケーションに組み込むときに使用できる概念および手法について説明します。  
+  
+## このセクションの内容  
+ [DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)  
+ Windows フォームの `DataGridView` コントロールのアーキテクチャおよび中心となる概念を説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールの既定の機能](../../../../docs/framework/winforms/controls/default-functionality-in-the-windows-forms-datagridview-control.md)  
+ Windows フォームの `DataGridView` コントロールがデータ ソースにバインドされているときの既定の外観および動作について説明します。  
+  
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)  
+ Windows フォームの `DataGridView` コントロールのデータの表示に使用する列型、およびユーザーがデータを変更または追加できるようにするために使用する列型について説明します。  
+  
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)  
+ セル、行、および列の一般的なプロパティを説明するトピックを示します。  
+  
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)  
+ コントロールの基本の外観およびセル データの書式設定を変更する方法を説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)  
+ コントロールに手動でデータを組み込む方法と、外部データ ソースからデータを取得する方法について説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](../../../../docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)  
+ セルの内容に合わせて、またはコントロールが利用可能な幅に合わせて、行と列のサイズを自動的に調整する方法を説明するトピックを示します。  
+  
+ [Windows フォームの DataGridView コントロールでのデータの並べ替え](../../../../docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md)  
+ このコントロールの並べ替え機能について説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)  
+ コントロールのデータに対してユーザーが実行できる追加および修正の仕方を変更する方法を説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](../../../../docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)  
+ コントロールのセル、行、および列の選択機能について説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)  
+ セル、行、および列オブジェクトを使用したプログラミング方法を説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)  
+ `DataGridView` のセルおよび行のカスタム描画と、セル、列、および行の派生型の作成について説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)  
+ 大量のデータを扱うときのパフォーマンスの問題を避けるために、このコントロールを効率的に使用する方法について説明するトピックを示します。  
+  
+ [Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理](../../../../docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md)  
+ キーボードとマウスを介してユーザーが `DataGridView` コントロールとやり取りする方法を説明します。  
+  
+ [Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)  
+ `DataGridView` コントロールが <xref:System.Windows.Forms.DataGrid> コントロールより改良され、これに代わるものである点について説明します。  
+  
+ 「[Windows フォーム DataGridView コントロールでのデザイナーの使用](http://msdn.microsoft.com/library/ms171593\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールのリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.BindingSource>  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントのリファレンス ドキュメントを提供します。  <xref:System.Windows.Forms.DataGridView> コントロールと <xref:System.Windows.Forms.BindingSource> コンポーネントは、密接に連携して機能するようにデザインされています。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datetimepicker-control-overview-windows-forms.md b/docs/framework/winforms/controls/datetimepicker-control-overview-windows-forms.md
new file mode 100644
index 00000000000..247b45ee154
--- /dev/null
+++ b/docs/framework/winforms/controls/datetimepicker-control-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "DateTimePicker コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DateTimePicker"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "日時指定コントロール"
+  - "DateTimePicker コントロール [Windows フォーム], 概要"
+ms.assetid: 501af106-e9fc-4efc-b9b3-c9d8dcaf8c5c
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# DateTimePicker コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.DateTimePicker> コントロールは、日付や時間のリストから 1 つの項目を選択するためのコントロールです。  このコントロールで日付を表す場合、テキスト表示された日付のドロップダウン リストと、その隣の下向きの矢印をクリックしたときに表示されるグリッドの 2 つの部分で構成されます。  グリッドは、複数の日付を選択できる <xref:System.Windows.Forms.MonthCalendar> コントロールに似ています。  <xref:System.Windows.Forms.MonthCalendar> コントロールの詳細については、「[MonthCalendar コントロールの概要](../../../../docs/framework/winforms/controls/monthcalendar-control-overview-windows-forms.md)」を参照してください。  
+  
+## 主要なプロパティ  
+ 日付の代わりに時間の指定と編集を行うコントロールとして <xref:System.Windows.Forms.DateTimePicker> を表示する場合は、<xref:System.Windows.Forms.DateTimePicker.ShowUpDown%2A> プロパティに `true` を設定し、<xref:System.Windows.Forms.DateTimePicker.Format%2A> プロパティに <xref:System.Windows.Forms.DateTimePickerFormat> を設定します。  詳細については、「[方法 : DateTimePicker コントロールを使用して時間を表示する](../../../../docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DateTimePicker.ShowCheckBox%2A> プロパティに `true` を設定すると、コントロールの選択した日付の横に、チェック ボックスが表示されます。  チェック ボックスをオンにすると、選択した日時の値を更新できます。  チェック ボックスをオフにすると、値は利用できません。  
+  
+ 日付と時間の範囲を決定するのは、コントロールの <xref:System.Windows.Forms.DateTimePicker.MaxDate%2A> プロパティと <xref:System.Windows.Forms.DateTimePicker.MinDate%2A> プロパティです。  <xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティには、コントロールに設定されている現在の日付と時間が格納されています。  詳細については、「[方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する](../../../../docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md)」を参照してください。  値は <xref:System.Windows.Forms.DateTimePickerFormat>、<xref:System.Windows.Forms.DateTimePickerFormat>、<xref:System.Windows.Forms.DateTimePickerFormat>、または <xref:System.Windows.Forms.DateTimePickerFormat> の 4 つの形式で表示できます。これは <xref:System.Windows.Forms.DateTimePicker.Format%2A> プロパティで設定します。  Custom 形式を選択した場合は、<xref:System.Windows.Forms.DateTimePicker.CustomFormat%2A> プロパティに適切な文字列を設定する必要があります。  詳細については、「[方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する](../../../../docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md)」を参照してください。  
+  
+## 参照  
+ [方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する](../../../../docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md)   
+ [方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する](../../../../docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/datetimepicker-control-windows-forms.md b/docs/framework/winforms/controls/datetimepicker-control-windows-forms.md
new file mode 100644
index 00000000000..07df5eba6f7
--- /dev/null
+++ b/docs/framework/winforms/controls/datetimepicker-control-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "DateTimePicker コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "日時指定コントロール"
+  - "日付, 選択 (リストから)"
+  - "日付, Windows フォーム コントロール"
+  - "DateTimePicker コントロール [Windows フォーム]"
+ms.assetid: 1dac1fbd-8f67-4910-9ccb-2c5462d0d855
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# DateTimePicker コントロール (Windows フォーム)
+Windows フォームの `DateTimePicker` コントロールは、日付や時間のリストから 1 つの項目を選択するためのコントロールです。  このコントロールで日付を表す場合、テキスト表示された日付のドロップダウン リストと、その隣の下向きの矢印をクリックしたときに表示されるグリッドの 2 つの部分で構成されます。  
+  
+## このセクションの内容  
+ [DateTimePicker コントロールの概要](../../../../docs/framework/winforms/controls/datetimepicker-control-overview-windows-forms.md)  
+ ユーザーが日付や時刻のリストから 1 つの項目を選択できる、`DateTimePicker` コントロールの全般的な概念を説明します。  
+  
+ [方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する](../../../../docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md)  
+ 書式指定文字列を使用して日付を任意の書式で表示する方法について説明します。  
+  
+ [方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する](../../../../docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md)  
+ コントロールで日付を設定する手順、およびユーザーによって選択された日付にアクセスする手順を説明します。  
+  
+ [方法 : DateTimePicker コントロールを使用して時間を表示する](../../../../docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md)  
+ `DateTimePicker` で時刻のみを表示する手順を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DateTimePicker>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.MonthCalendar>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)  
+ わかりやすいグラフィカル インターフェイスを使用して、ユーザーが日付情報を表示および設定できるようにします。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/default-cell-styles-datagridview.md b/docs/framework/winforms/controls/default-cell-styles-datagridview.md
new file mode 100644
index 00000000000..0158b5cf1dc
--- /dev/null
+++ b/docs/framework/winforms/controls/default-cell-styles-datagridview.md
@@ -0,0 +1,81 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 設定 (スタイルを)"
+  - "データ [Windows フォーム], 設定 (形式を)"
+  - "データ形式"
+  - "DataGridView コントロール [Windows フォーム], セル スタイル"
+ms.assetid: fc6da49f-8942-41da-b49f-b2afc38cc656
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する
+<xref:System.Windows.Forms.DataGridView> コントロールを使用すると、コントロール全体、特定の列、行ヘッダーと列ヘッダー、および交互の行の既定のセル スタイルおよびセル データ形式を指定して、帳簿のような体裁にできます。  コントロール全体に設定されている既定のスタイルは、列および交互の行に設定した既定のスタイルによってオーバーライドされます。  また、個々の行およびセルに対してコードで設定したスタイルにより、既定のスタイルがオーバーライドされます。  
+  
+ セル スタイルの詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  交互の行のスタイルを設定する方法については、「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView.RowTemplate%2A> プロパティを使用して、コントロールに追加するすべての行のスタイルを設定することもできます。  行テンプレートの詳細については、「[方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする](../../../../docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロール内のすべてのセルに既定のスタイルを設定するには  
+  
+1.  デザイナーで <xref:System.Windows.Forms.DataGridView> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A> プロパティ、<xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A> プロパティ、または <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  **\[CellStyle ビルダー\]** ダイアログ ボックスが表示されます。  
+  
+3.  プロパティを設定してスタイルを定義し、**プレビュー** ペインで選択内容を確認します。  
+  
+> [!NOTE]
+>  visual スタイルが有効になっている場合は、行ヘッダーおよび列ヘッダー \(<xref:System.Windows.Forms.DataGridView.TopLeftHeaderCell%2A> を除く\) のスタイルは現在のテーマによって自動的に設定され、<xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A> プロパティと <xref:System.Windows.Forms.DataGridView.RowHeadersDefaultCellStyle%2A> プロパティの値がオーバーライドされます。  
+>   
+>  デザイナーを使用して、選択した複数の <xref:System.Windows.Forms.DataGridView> コントロールのセル スタイルを設定できます。ただし、コントロール間で、変更するセル スタイルのプロパティ値が同じである場合に限ります。  変更するプロパティの値がいずれかのセル スタイルで異なる場合、**\[CellStyle ビルダー\]** ダイアログ ボックスの **\[プロパティ\]** ウィンドウは空白になります。  
+  
+### 個々の列のセルに既定のスタイルを設定するには  
+  
+1.  デザイナーで <xref:System.Windows.Forms.DataGridView> コントロールを右クリックし、**\[列の編集\]** をクリックします。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[列のプロパティ\]** グリッドで、<xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  **\[CellStyle ビルダー\]** ダイアログ ボックスが表示されます。  
+  
+4.  プロパティを設定してスタイルを定義し、**プレビュー** ペインで選択内容を確認します。  
+  
+### セル内のデータを書式設定するには  
+  
+1.  上記の手順のいずれかを使用して、既定のセル スタイル プロパティに関連する **\[CellStyle ビルダー\]** ダイアログ ボックスを表示します。  
+  
+2.  **\[CellStyle ビルダー\]** ダイアログ ボックスで、<xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  **\[書式文字列のダイアログ\]** ダイアログ ボックスが表示されます。  
+  
+3.  書式の種類を選択し、その詳細設定 \(小数点以下の表示桁数など\) を変更します。変更内容は **\[サンプル\]** ボックスで確認します。  
+  
+4.  null 値を格納している可能性があるデータ ソースに <xref:System.Windows.Forms.DataGridView> コントロールをバインドする場合は、**\[Null 値\]** ボックスに値を指定します。  ここで指定した値は、セルの値が null 参照 \(Visual Basic では `Nothing`\) または <xref:System.DBNull.Value?displayProperty=fullName> と等しい場合に表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/default-functionality-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/default-functionality-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..0bdcf6af6de
--- /dev/null
+++ b/docs/framework/winforms/controls/default-functionality-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,60 @@
+---
+title: "Windows フォーム DataGridView コントロールの既定の機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 既定の機能 (DataGridView コントロール内の)"
+  - "DataGridView コントロール [Windows フォーム], 既定の機能"
+ms.assetid: 4405f697-cad1-4839-9bcd-8ddb09d9f00e
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォーム DataGridView コントロールの既定の機能
+Windows フォームの <xref:System.Windows.Forms.DataGridView> コントロールには、既定の機能が多数用意されています。  
+  
+## 既定の機能  
+ <xref:System.Windows.Forms.DataGridView> コントロールの既定の機能は次のとおりです。  
+  
+-   テーブルを垂直方向にスクロールしたときに表示されたままになる列ヘッダーおよび行ヘッダーを自動的に表示します。  
+  
+-   行ヘッダーには、現在の行を示す選択インジケーターが表示されます。  
+  
+-   最初のセルに、選択領域を示す四角形が表示されます。  
+  
+-   列の区分線をダブルクリックして、列のサイズを自動的に変更できます。  
+  
+-   アプリケーションの `Main` メソッドから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A> メソッドを呼び出した場合には、Windows XP および Windows Server 2003 ファミリの visual スタイルが自動的にサポートされます。  
+  
+ また、既定では <xref:System.Windows.Forms.DataGridView> コントロールのコンテンツを編集できるようになっています。  
+  
+-   セルをダブルクリックするか F2 キーを押すと、セルは自動的に編集モードへ切り替わり、入力するとセルの内容が更新されます。  
+  
+-   グリッドを最後までスクロールすると、新規レコードを追加するための行が表示されます。  この行をクリックすると、既定値の設定された新しい行が <xref:System.Windows.Forms.DataGridView> コントロールに追加されます。  Esc キーを押すと、新しい行は消去されます。  
+  
+-   行ヘッダーをクリックすると、行全体が選択されます。  
+  
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティを設定して、<xref:System.Windows.Forms.DataGridView> コントロールをデータ ソースにバインドすると、コントロールでは次のような処理を実行します。  
+  
+-   列ヘッダーのテキストとして、データ ソースの列の名を自動的に使用します。  
+  
+-   データ ソースの内容を読み込みます。  <xref:System.Windows.Forms.DataGridView> 列は、データ ソースの各列に対応させて自動的に作成されます。  
+  
+-   表示する各行に対応させてテーブル内に行を作成します。  
+  
+-   列ヘッダーをクリックすると、基になるデータに従って行を自動的に並べ替えます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..05b4cb327e4
--- /dev/null
+++ b/docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,124 @@
+---
+title: "Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, マウス処理"
+  - "DataGridView コントロール [Windows フォーム], キーボード処理"
+  - "DataGridView コントロール [Windows フォーム], マウス処理"
+  - "DataGridView コントロール [Windows フォーム], 移動キー"
+  - "キーボード, 既定の処理 (DataGridView コントロール内の)"
+  - "マウス, 既定の処理 (DataGridView コントロール内の)"
+  - "移動キー, DataGridView コントロール"
+ms.assetid: 4519b928-bfc8-4e8b-bb9c-b1e76a0ca552
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理
+キーボードとマウスを介して、ユーザーが <xref:System.Windows.Forms.DataGridView> コントロールとやり取りする方法を次の表に示します。  
+  
+> [!NOTE]
+>  キーボードの動作をカスタマイズするには、<xref:System.Windows.Forms.Control.KeyDown> などの標準キーボード イベントを処理します。  ただし、編集モードでは、ホストされる編集コントロールがキーボード入力を受け取るため、<xref:System.Windows.Forms.DataGridView> コントロールに対するキーボード イベントは発生しません。  編集コントロールのイベントを処理するには、<xref:System.Windows.Forms.DataGridView.EditingControlShowing> イベント ハンドラーで編集コントロールにハンドラーをアタッチします。  または、<xref:System.Windows.Forms.DataGridView> サブクラスで <xref:System.Windows.Forms.DataGridView.ProcessDialogKey%2A> メソッドと <xref:System.Windows.Forms.DataGridView.ProcessDataGridViewKey%2A> メソッドをオーバーライドして、キーボードの動作をカスタマイズすることもできます。  
+  
+## 既定のキーボード処理  
+  
+### 基本的な移動キーと入力キー  
+  
+|キーまたはキーの組み合わせ|Description|  
+|-------------------|-----------------|  
+|↓|現在のセルの 1 つ下のセルにフォーカスを移動します。  フォーカスが最後の行にある場合は、何も行いません。|  
+|←|同じ行の 1 つ前のセルにフォーカスを移動します。  フォーカスが行の最初のセルにある場合は、何も行いません。|  
+|→|同じ行の次のセルにフォーカスを移動します。  フォーカスが行の最後のセルにある場合は、何も行いません。|  
+|↑|現在のセルの 1 つ上のセルにフォーカスを移動します。  フォーカスが最初の行にある場合は、何も行いません。|  
+|Home|現在の行の最初のセルにフォーカスを移動します。|  
+|End|現在の行の最後のセルにフォーカスを移動します。|  
+|PageDown|完全に表示されている行数分、コントロールを下にスクロールします。  完全に表示されている最後の行にフォーカスを移動します。列は変更しません。|  
+|PageUp|完全に表示されている行数分、コントロールを上にスクロールします。  現在表示されている最初の行にフォーカスを移動します。列は変更しません。|  
+|Tab|<xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `false` の場合は、現在の行の次のセルにフォーカスを移動します。  行の最後のセルにフォーカスがあるときは、次の行の最初のセルにフォーカスを移動します。  コントロールの最後のセルにフォーカスがあるときは、親コンテナーのタブ オーダーで次のコントロールにフォーカスを移動します。<br /><br /> <xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `true` の場合は、親コンテナーのタブ オーダーで次のコントロールにフォーカスを移動します。|  
+|Shift \+ Tab|<xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `false` の場合は、現在の行の 1 つ前のセルにフォーカスを移動します。  行の最初のセルにフォーカスがあるときは、1 つ前の行の最後のセルにフォーカスを移動します。  コントロールの最初のセルにフォーカスがある場合は、親コンテナーのタブ オーダーで 1 つ前のコントロールにフォーカスを移動します。<br /><br /> <xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `true` の場合は、親コンテナーのタブ オーダーで 1 つ前のコントロールにフォーカスを移動します。|  
+|Ctrl \+ Tab|<xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `false` の場合は、親コンテナーのタブ オーダーで次のコントロールにフォーカスを移動します。<br /><br /> <xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `true` の場合は、現在の行の次のセルにフォーカスを移動します。  行の最後のセルにフォーカスがあるときは、次の行の最初のセルにフォーカスを移動します。  コントロールの最後のセルにフォーカスがあるときは、親コンテナーのタブ オーダーで次のコントロールにフォーカスを移動します。|  
+|Ctrl \+ Shift \+ Tab|<xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `false` の場合は、親コンテナーのタブ オーダーで 1 つ前のコントロールにフォーカスを移動します。<br /><br /> <xref:System.Windows.Forms.DataGridView.StandardTab%2A> プロパティ値が `true` の場合は、現在の行の 1 つ前のセルにフォーカスを移動します。  行の最初のセルにフォーカスがあるときは、1 つ前の行の最後のセルにフォーカスを移動します。  コントロールの最初のセルにフォーカスがある場合は、親コンテナーのタブ オーダーで 1 つ前のコントロールにフォーカスを移動します。|  
+|Ctrl \+ 方向キー|矢印の方向にある最も遠いセルにフォーカスを移動します。|  
+|Ctrl \+ Home|コントロール内の最初のセルにフォーカスを移動します。|  
+|Ctrl \+ End|コントロール内の最後のセルにフォーカスを移動します。|  
+|Ctrl \+ PageDown または Ctrl \+ PageUp|PageDown または PageUp と同じです。|  
+|F2|<xref:System.Windows.Forms.DataGridView.EditMode%2A> プロパティ値が <xref:System.Windows.Forms.DataGridViewEditMode> または <xref:System.Windows.Forms.DataGridViewEditMode> の場合に、現在のセルを編集モードに設定します。|  
+|F4|現在のセルが <xref:System.Windows.Forms.DataGridViewComboBoxCell> の場合に、現在のセルを編集モードにしてドロップダウン リストを表示します。|  
+|Alt \+ ↑ または Alt \+ ↓|現在のセルが <xref:System.Windows.Forms.DataGridViewComboBoxCell> の場合に、現在のセルを編集モードにしてドロップダウン リストを表示します。|  
+|Space|現在のセルが <xref:System.Windows.Forms.DataGridViewButtonCell>、<xref:System.Windows.Forms.DataGridViewLinkCell>、または <xref:System.Windows.Forms.DataGridViewCheckBoxCell> の場合に、<xref:System.Windows.Forms.DataGridView.CellClick> イベントと <xref:System.Windows.Forms.DataGridView.CellContentClick> イベントを発生させます。  現在のセルが <xref:System.Windows.Forms.DataGridViewButtonCell> の場合は、ボタンも押します。  現在のセルが <xref:System.Windows.Forms.DataGridViewCheckBoxCell> の場合は、\(チェック ボックスの\) チェックの状態も変更します。|  
+|Enter|現在のセルおよび行への変更をコミットし、現在のセルの 1 つ下のセルにフォーカスを移動します。  フォーカスが最後の行にある場合は、変更をコミットし、フォーカスは移動しません。|  
+|Esc|コントロールが編集モードの場合は、編集をキャンセルします。  コントロールが編集モードではない場合、コントロールが編集をサポートするデータ ソースにバインドされているか、または行レベルのコミット スコープを持つ仮想モードが実装されていれば、現在の行に加えられた変更をすべて元に戻します。|  
+|BackSpace|セルを編集するときに、カーソル位置の前にある文字を削除します。|  
+|Del|セルを編集するときに、カーソル位置の後にある文字を削除します。|  
+|Ctrl \+ Enter|現在のセルに対して行われた変更をコミットします。フォーカスは移動しません。  また、コントロールが編集をサポートするデータ ソースにバインドされている場合、または行レベルのコミット スコープを持つ仮想モードが実装されている場合、現在の行に対する変更をすべてコミットします。|  
+|Ctrl \+ 0|セルを編集できる場合に、現在のセルに <xref:System.DBNull.Value?displayProperty=fullName> 値を入力します。  既定では、<xref:System.DBNull> セル値の表示値は、現在のセルに対して有効な <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.NullValue%2A> プロパティの値です。|  
+  
+### 選択キー  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> プロパティが `false` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> プロパティが <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、移動キーを使用して現在のセルを変更すると、選択対象が新しいセルに変更されます。  Shift キー、Ctrl キー、および Alt キーはこの動作には影響しません。  
+  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合も同じように動作しますが、次の動作が追加されます。  
+  
+|キーまたはキーの組み合わせ|Description|  
+|-------------------|-----------------|  
+|Shift \+ Space|行全体または列全体を選択します \(行ヘッダーまたは列ヘッダーを選択するのと同じです\)。|  
+|移動キー \(方向キー、PageUp、PageDown、Home、End\)|行全体または列全体が選択されている場合に、現在のセルを新しい行または列に変更すると、選択対象が新しい行全体または列全体に移動します \(選択モードによって異なります\)。|  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `false` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、キーボードを使用して現在のセルを新しい行または列に変更すると、選択対象が新しい行全体または列全体に移動します。  Shift キー、Ctrl キー、および Alt キーはこの動作には影響しません。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `true` に設定されている場合は、移動動作は変更されません。ただし、Shift \(Ctrl \+ Shift を含む\) キーを押しながらキーボードを使用する移動では、複数セルの選択動作が変更されます。  移動を開始する前に、コントロールは現在のセルをアンカー セルとしてマークします。  Shift キーを押しながら移動すると、アンカー セルと現在のセルの間のすべてのセルが選択範囲に含められます。  コントロール内のその他のセルは、既に選択されている場合は、選択された状態が保持されます。ただし、キーボードによる移動操作で、これらのセルがアンカー セルと現在のセルの間に一時的に含まれた場合は、選択が解除されることがあります。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `true` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合、アンカー セルと現在のセルは同じように動作しますが、選択または選択解除されるのは行全体のみまたは列全体のみです。  
+  
+## 既定のマウス処理  
+  
+### 基本的なマウス処理  
+  
+> [!NOTE]
+>  マウスの左ボタンでセルをクリックすると、常に現在のセルが変更されます。  また、マウスの右ボタンでセルをクリックすると、ショートカット メニューがある場合は、ショートカット メニューが開きます。  
+  
+|マウス操作|Description|  
+|-----------|-----------------|  
+|マウスの左ボタンを押す|クリックしたセルが現在のセルになり、<xref:System.Windows.Forms.DataGridView.CellMouseDown?displayProperty=fullName> イベントが発生します。|  
+|マウスの左ボタンを離す|<xref:System.Windows.Forms.DataGridView.CellMouseUp?displayProperty=fullName> イベントが発生します。|  
+|マウスの左ボタンでクリックする|<xref:System.Windows.Forms.DataGridView.CellClick?displayProperty=fullName> イベントと <xref:System.Windows.Forms.DataGridView.CellMouseClick?displayProperty=fullName> イベントが発生します。|  
+|マウスの左ボタンを押して列ヘッダー セル上でドラッグする|<xref:System.Windows.Forms.DataGridView.AllowUserToOrderColumns%2A?displayProperty=fullName> プロパティが `true` の場合、列を新しい位置にドロップできるように移動します。|  
+  
+### マウスによる選択  
+ マウスの中央ボタン \(マウス ホイール\) には選択動作が関連付けられていません。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> プロパティが `false` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> プロパティが <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、次のように動作します。  
+  
+|マウス操作|Description|  
+|-----------|-----------------|  
+|マウスの左ボタンでクリックする|ユーザーがセルをクリックした場合、現在のセルだけが選択されます。  ユーザーが行ヘッダーまたは列ヘッダーをクリックした場合、選択動作は行われません。|  
+|マウスの右ボタンでクリックする|ショートカット メニューがある場合は、ショートカット メニューが表示されます。|  
+  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合も、同様の動作が行われます。ただし、選択モードによっては、行ヘッダーまたは列ヘッダーをクリックすると行全体または列全体が選択され、現在のセルが行または列の最初のセルに設定されます。  
+  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、行または列の任意のセルをクリックすると行全体または列全体が選択されます。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `true` に設定されている場合、Ctrl キーまたは Shift キーを押しながらセルをクリックすると複数セルの選択が変更されます。  
+  
+ Ctrl キーを押しながらセルをクリックすると、そのセルの選択状態は変化しますが、その他のすべてのセルは現在の選択状態を保持します。  
+  
+ Shift キーを押しながら特定のセルまたは連続するセルをクリックした場合、現在のセルとアンカー セル \(最初のクリックの前に選択されていたセルの位置にあります\) の間のすべてのセルが選択されます。  マウスをクリックし、複数のセル間でポインターをドラッグした場合、ドラッグ操作の最初にクリックしたセルがアンカー セルになります。  それ以降、Shift キーを押しながらクリックすると、現在のセルは変更されますが、アンカー セルは変更されません。  コントロール内のその他のセルは、既に選択されている場合は、選択された状態が保持されます。ただし、マウスによる移動操作で、これらのセルがアンカー セルと現在のセルの間に一時的に含まれた場合は、選択が解除されることがあります。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `true` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、Shift キーを押しながら行ヘッダーまたは列ヘッダー \(選択モードによります\) をクリックすると既存の行全体または列全体の選択が変更されます \(そのような選択範囲が存在する場合\)。  それ以外の場合は、選択が解除され、新しい行全体または列全体の選択が開始されます。  ただし、Ctrl キーを押しながら行ヘッダーまたは列ヘッダーをクリックした場合は、クリックした行または列が現在の選択範囲に対して追加または削除されます。現在の選択範囲に対してそれ以外の変更はありません。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> が `true` に設定され、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> が <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定されている場合は、Shift キーまたは Ctrl キーを押しながらセルをクリックすると、行全体のみまたは列全体のみが影響を受けることを除き、同じように動作します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/defining-a-property-in-windows-forms-controls.md b/docs/framework/winforms/controls/defining-a-property-in-windows-forms-controls.md
new file mode 100644
index 00000000000..65cce7ffb6d
--- /dev/null
+++ b/docs/framework/winforms/controls/defining-a-property-in-windows-forms-controls.md
@@ -0,0 +1,135 @@
+---
+title: "Windows フォーム コントロールのプロパティの定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 定義 (プロパティをコードで)"
+  - "プロパティ [Windows フォーム], 定義 (コードで)"
+ms.assetid: c2eb8277-a842-4d99-89a9-647b901a0434
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォーム コントロールのプロパティの定義
+プロパティの概要については、「[プロパティの概要](../Topic/Properties%20Overview.md)」を参照してください。  プロパティを定義する場合に考慮する必要がある点を次に示します。  
+  
+-   定義するプロパティに属性を適用する必要があります。  属性によって、デザイナーでのプロパティの表示形式が指定されます。  詳細については、「[コンポーネントのデザイン時属性](../Topic/Design-Time%20Attributes%20for%20Components.md)」を参照してください。  
+  
+-   プロパティの変更がコントロールのビジュアル表示に影響する場合は、`set` アクセサーから <xref:System.Windows.Forms.Control.Invalidate%2A> メソッド \(<xref:System.Windows.Forms.Control> から継承されたメソッド\) を呼び出します。  すると、<xref:System.Windows.Forms.Control.Invalidate%2A> によって、コントロールを再描画する <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドが呼び出されます。  効率的な点から、<xref:System.Windows.Forms.Control.Invalidate%2A> メソッドを複数回呼び出しても <xref:System.Windows.Forms.Control.OnPaint%2A> が呼び出されるのは 1 回だけです。  
+  
+-   .NET Framework クラス ライブラリには、整数、10 進数、ブール値などの一般的なデータ型のための型コンバーターが用意されています。  型コンバーターでは、一般に文字列を値へ変換する、つまり文字列データを他のデータ型に変換することが目的です。  標準的なデータ型は既定の型コンバーターに関連付けられています。既定の型コンバーターでは、値から文字列への変換と、文字列から適切なデータ型への変換が行われます。  カスタム \(非標準\) データ型のプロパティを定義する場合には、そのプロパティに関連付ける型コンバーターを指定する属性を適用する必要があります。  属性を使用して、カスタム UI 型エディターをプロパティに関連付けることもできます。  UI 型エディターには、プロパティやデータ型を編集するためのユーザー インターフェイスが備わっています。  カラー ピッカーは、UI 型エディターの例です。  属性の例については、このトピックの最後に示します。  
+  
+    > [!NOTE]
+    >  カスタム プロパティを処理できる型コンバーターまたは UI 型エディターがない場合には、「[Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)」の説明に従ってコンバーターまたはエディターを実装できます。  
+  
+ `FlashTrackBar` カスタム コントロールの `EndColor` というカスタム プロパティを定義するコード片を次に示します。  
+  
+```vb  
+Public Class FlashTrackBar  
+   Inherits Control  
+   ...  
+   ' Private data member that backs the EndColor property.  
+   Private _endColor As Color = Color.LimeGreen  
+  
+   ' The Category attribute tells the designer to display  
+   ' it in the Flash grouping.   
+   ' The Description attribute provides a description of  
+   ' the property.   
+   <Category("Flash"), _  
+   Description("The ending color of the bar.")>  _  
+   Public Property EndColor() As Color  
+      ' The public property EndColor accesses _endColor.  
+      Get  
+         Return _endColor  
+      End Get  
+      Set  
+         _endColor = value  
+         If Not (baseBackground Is Nothing) And showGradient Then  
+            baseBackground.Dispose()  
+            baseBackground = Nothing  
+         End If  
+         ' The Invalidate method calls the OnPaint method, which redraws    
+         ' the control.  
+         Invalidate()  
+      End Set  
+   End Property  
+   ...  
+End Class  
+  
+```  
+  
+```csharp  
+public class FlashTrackBar : Control {  
+   ...  
+   // Private data member that backs the EndColor property.  
+   private Color endColor = Color.LimeGreen;  
+   // The Category attribute tells the designer to display  
+   // it in the Flash grouping.   
+   // The Description attribute provides a description of  
+   // the property.   
+   [  
+   Category("Flash"),  
+   Description("The ending color of the bar.")  
+   ]  
+   // The public property EndColor accesses endColor.  
+   public Color EndColor {  
+      get {  
+         return endColor;  
+      }  
+      set {  
+         endColor = value;  
+         if (baseBackground != null && showGradient) {  
+            baseBackground.Dispose();  
+            baseBackground = null;  
+         }  
+         // The Invalidate method calls the OnPaint method, which redraws   
+         // the control.  
+         Invalidate();  
+      }  
+   }  
+   ...  
+}  
+```  
+  
+ 型コンバーターと UI 型エディターを `Value` プロパティに関連付けるコード片を次に示します。  このコードでは、`Value` プロパティが整数であり、このプロパティには既定の型コンバーターが設定されていますが、<xref:System.ComponentModel.TypeConverterAttribute> 属性によってカスタム型コンバーター \(`FlashTrackBarValueConverter`\) が適用されます。これにより、デザイナーではこの `Value` プロパティがパーセントとして表示されます。  `FlashTrackBarValueEditor` UI 型エディターを使用すると、パーセント値が視覚的に表示されます。  この例では、さらに <xref:System.ComponentModel.TypeConverterAttribute> 属性に指定された型コンバーターまたは <xref:System.ComponentModel.EditorAttribute> 属性に指定された型エディターが既定のコンバーターをオーバーライドします。  
+  
+```vb  
+<Category("Flash"), _  
+TypeConverter(GetType(FlashTrackBarValueConverter)), _  
+Editor(GetType(FlashTrackBarValueEditor), _  
+GetType(UITypeEditor)), _  
+Description("The current value of the track bar.  You can enter an actual value or a percentage.")>  _  
+Public ReadOnly Property Value() As Integer  
+...  
+End Property  
+  
+```  
+  
+```csharp  
+[  
+Category("Flash"),   
+TypeConverter(typeof(FlashTrackBarValueConverter)),  
+Editor(typeof(FlashTrackBarValueEditor), typeof(UITypeEditor)),  
+Description("The current value of the track bar.  You can enter an actual value or a percentage.")  
+]  
+public int Value {  
+...  
+}  
+```  
+  
+## 参照  
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)   
+ [ShouldSerialize メソッドと Reset メソッドによる既定値の定義](../../../../docs/framework/winforms/controls/defining-default-values-with-the-shouldserialize-and-reset-methods.md)   
+ [プロパティ変更イベント](../../../../docs/framework/winforms/controls/property-changed-events.md)   
+ [Windows フォーム コントロールの属性](../../../../docs/framework/winforms/controls/attributes-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md b/docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md
new file mode 100644
index 00000000000..eea64763045
--- /dev/null
+++ b/docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md
@@ -0,0 +1,89 @@
+---
+title: "Windows フォーム コントロールのイベントの定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], イベント (コードを使用)"
+  - "イベント [Windows フォーム], 定義 (Windows フォームのカスタム コントロール内で)"
+ms.assetid: d89f1096-8061-42e2-a855-a1f053f1940a
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォーム コントロールのイベントの定義
+カスタム イベントの定義方法の詳細については、「[イベント](../../../../docs/standard/events/index.md)」を参照してください。  関連データがないイベントを定義する場合、イベント データの基本型である <xref:System.EventArgs> を使用し、イベント デリゲートとして <xref:System.EventHandler> を使用します。  イベント メンバーを定義し、イベントを発生させる `On`*EventName* プロテクト メソッドを定義します。その他の操作は特に必要ありません。  
+  
+ `FlashTrackBar` カスタム コントロールによる `ValueChanged` カスタム イベントの定義方法を示すコードを次に示します。  `FlashTrackBar` の完全なコード例については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports System  
+Imports System.Windows.Forms  
+Imports System.Drawing  
+  
+Public Class FlashTrackBar  
+   Inherits Control  
+  
+   ' The event does not have any data, so EventHandler is adequate   
+   ' as the event delegate.          
+   ' Define the event member using the event keyword.  
+   ' In this case, for efficiency, the event is defined   
+   ' using the event property construct.  
+   Public Event ValueChanged As EventHandler  
+   ' The protected method that raises the ValueChanged   
+   ' event when the value has actually   
+   ' changed. Derived controls can override this method.    
+   Protected Overridable Sub OnValueChanged(e As EventArgs)  
+      RaiseEvent ValueChanged(Me, e)  
+   End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Windows.Forms;  
+using System.Drawing;  
+  
+public class FlashTrackBar : Control {  
+   // The event does not have any data, so EventHandler is adequate   
+   // as the event delegate.  
+   private EventHandler onValueChanged;  
+   // Define the event member using the event keyword.  
+   // In this case, for efficiency, the event is defined   
+   // using the event property construct.  
+   public event EventHandler ValueChanged {  
+            add {  
+                onValueChanged += value;  
+            }  
+            remove {  
+                onValueChanged -= value;  
+            }  
+        }  
+   // The protected method that raises the ValueChanged  
+   // event when the value has actually   
+   // changed. Derived controls can override this method.    
+   protected virtual void OnValueChanged(EventArgs e) {  
+      if (ValueChanged != null) {  
+         ValueChanged(this, e);  
+      }  
+   }  
+}  
+```  
+  
+## 参照  
+ [Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)   
+ [イベント](../../../../docs/standard/events/index.md)   
+ [イベント](../../../../docs/standard/events/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/defining-default-values-with-the-shouldserialize-and-reset-methods.md b/docs/framework/winforms/controls/defining-default-values-with-the-shouldserialize-and-reset-methods.md
new file mode 100644
index 00000000000..4519e602573
--- /dev/null
+++ b/docs/framework/winforms/controls/defining-default-values-with-the-shouldserialize-and-reset-methods.md
@@ -0,0 +1,156 @@
+---
+title: "ShouldSerialize メソッドと Reset メソッドによる既定値の定義 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], プロパティ メソッド"
+  - "Reset メソッド"
+  - "ShouldPersist メソッド"
+ms.assetid: 7b6c5e00-3771-46b4-9142-5a80d5864a5e
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ShouldSerialize メソッドと Reset メソッドによる既定値の定義
+`ShouldSerialize` メソッドと `Reset` メソッドは、プロパティに単純な既定値がない場合に、このプロパティに指定できるオプションのメソッドです。  プロパティに単純な既定値がある場合には、<xref:System.ComponentModel.DefaultValueAttribute> を適用して、属性クラス コンストラクターに既定値を指定します。  ShouldSerialize メソッドまたは Reset メソッドを使用すると、次に示す機能がデザイナーで有効になります。  
+  
+-   プロパティの既定値が変更された場合、変更を示すマークがプロパティ ブラウザーに表示されます。  
+  
+-   プロパティの既定値に戻すには、ユーザーがプロパティを右クリックして、**\[リセット\]** をクリックします。  
+  
+-   デザイナーで、さらに効率的なコードが生成されます。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.DefaultValueAttribute> を適用するか、`Reset`*PropertyName* メソッドと `ShouldSerialize`*PropertyName* メソッドを提供します。  この 2 種類の操作を同時に実行しないでください。  
+  
+ 次のコードに示すように、`Reset`*PropertyName* メソッドはプロパティに既定値を設定します。  
+  
+```vb  
+Public Sub ResetMyFont()  
+   MyFont = Nothing  
+End Sub  
+```  
+  
+```csharp  
+public void ResetMyFont() {  
+   MyFont = null;  
+}  
+```  
+  
+> [!NOTE]
+>  `Reset` メソッドがなく、<xref:System.ComponentModel.DefaultValueAttribute> が適用されておらず、宣言で既定値が指定されていないプロパティの場合、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] の Windows フォーム デザイナーの **\[プロパティ\]** ウィンドウのショートカット メニューでは、このプロパティの `Reset` オプションが無効になります。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] などのデザイナーでは、`ShouldSerialize`*PropertyName* メソッドを使用して、プロパティの既定値が変更されているかどうかを確認し、プロパティが変更されている場合にだけフォームにコードを書き込みます。これにより、コード生成処理の効率性が向上します。  次に例を示します。  
+  
+```vb  
+'Returns true if the font has changed; otherwise, returns false.  
+' The designer writes code to the form only if true is returned.  
+Public Function ShouldSerializeMyFont() As Boolean  
+   Return Not (thefont Is Nothing)  
+End Function  
+```  
+  
+```csharp  
+// Returns true if the font has changed; otherwise, returns false.  
+// The designer writes code to the form only if true is returned.  
+public bool ShouldSerializeMyFont() {  
+   return thefont != null;  
+}  
+```  
+  
+ 完全なコード例を次に示します。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports System  
+Imports System.Windows.Forms  
+Imports System.Drawing  
+  
+Public Class MyControl  
+   Inherits Control  
+  
+   ' Declare an instance of the Font class  
+   ' and set its default value to Nothing.  
+   Private thefont As Font = Nothing  
+  
+   ' The MyFont property.   
+   Public Property MyFont() As Font  
+      ' Note that the Font property never  
+      ' returns null.  
+      Get  
+         If Not (thefont Is Nothing) Then  
+            Return thefont  
+         End If  
+         If Not (Parent Is Nothing) Then  
+            Return Parent.Font  
+         End If  
+         Return Control.DefaultFont  
+      End Get  
+      Set  
+         thefont = value  
+      End Set  
+   End Property  
+  
+   Public Function ShouldSerializeMyFont() As Boolean  
+      Return Not (thefont Is Nothing)  
+   End Function  
+  
+   Public Sub ResetMyFont()  
+      MyFont = Nothing  
+   End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Windows.Forms;  
+using System.Drawing;  
+  
+public class MyControl : Control {  
+   // Declare an instance of the Font class  
+   // and set its default value to null.  
+   private Font thefont = null;  
+  
+   // The MyFont property.      
+   public Font MyFont {  
+      // Note that the MyFont property never  
+      // returns null.  
+      get {  
+         if (thefont != null) return thefont;  
+         if (Parent != null) return Parent.Font;  
+         return Control.DefaultFont;  
+      }  
+      set {  
+         thefont = value;  
+      }  
+   }  
+  
+   public bool ShouldSerializeMyFont() {  
+      return thefont != null;  
+   }  
+  
+   public void ResetMyFont() {  
+      MyFont = null;  
+   }  
+}  
+```  
+  
+ この場合、`MyFont` プロパティがアクセスするプライベート変数の値が `null` であっても、プロパティ ブラウザーには `null` は表示されません。その代わりに、親の <xref:System.Windows.Forms.Control.Font%2A> プロパティ \(`null` 以外の場合\)、または <xref:System.Windows.Forms.Control> で定義されている <xref:System.Windows.Forms.Control.Font%2A> の既定値が表示されます。  つまり、`MyFont`  プロパティの既定値を簡単に設定できないため、このプロパティには <xref:System.ComponentModel.DefaultValueAttribute> を適用できません。  代わりに、`MyFont` プロパティに対しては、`ShouldSerialize` メソッドと `Reset` メソッドを実装する必要があります。  
+  
+## 参照  
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)   
+ [プロパティの定義](../../../../docs/framework/winforms/controls/defining-a-property-in-windows-forms-controls.md)   
+ [プロパティ変更イベント](../../../../docs/framework/winforms/controls/property-changed-events.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md b/docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md
new file mode 100644
index 00000000000..429bc841181
--- /dev/null
+++ b/docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md
@@ -0,0 +1,68 @@
+---
+title: "Windows フォーム デザイナーでのデザイン時エラー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DTELErrorList"
+  - "WhyDTELPage"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "デザイン時エラー [Windows フォーム デザイナー]"
+  - "エラー [Windows フォーム デザイナー]"
+ms.assetid: ad408380-825a-46d8-9a4a-531b130b88ce
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォーム デザイナーでのデザイン時エラー
+ここでは、Microsoft Visual Studio で Windows フォーム デザイナーの読み込みに失敗したときに表示される、デザイン時エラー一覧の意味と使用方法について説明します。  このエラー一覧の表示を、デザイナーのバグと解釈しないでください。この一覧は、コード内のエラーの修正を支援するために表示されます。  
+  
+ このエラー一覧の基本を理解し、エラーの詳細と推奨する解決方法の説明を表示することで、アプリケーションのデバッグを容易にすることができます。  
+  
+## デザイン時エラー一覧インターフェイス  
+ Windows フォーム デザイナーが読み込みに失敗すると、デザイナーにエラー一覧が表示されます。  エラーは、カテゴリ別にグループ化されます。  たとえば、宣言されていない変数のインスタンスが 4 つあった場合、それらは、同じエラー カテゴリにグループ化されます。  各エラー カテゴリには、そのエラーの概要を示す短い説明が含まれます。  
+  
+ エラー カテゴリは、エラー カテゴリ見出しをクリックするか、展開\/縮小シェブロンをクリックすることで、展開または縮小できます。  エラー カテゴリを展開すると、次の追加ヘルプが表示されます。  
+  
+-   このエラーのインスタンス。  
+  
+-   このエラーのヘルプ。  
+  
+-   このエラーに関するフォーラム ポスト。  
+  
+### このエラーのインスタンス。  
+ 追加ヘルプには、現在のプロジェクトで発生したすべてのエラー インスタンスが一覧表示されます。  多くのエラーは、エラーの発生場所を示す次の形式の情報を含みます。*\[プロジェクト名\]* *\[フォーム名\]* 行 : *\[行番号\]* 列 : *\[列番号\]*.  **\[コードに移動\]** リンクをクリックすると、コード内のエラーの発生場所にジャンプします。  
+  
+ エラーに呼び出し履歴が関連付けられている場合は、**\[コール スタックの表示\]** リンクをクリックすると、エラーがさらに展開され、呼び出し履歴が表示されます。  履歴を調べることで、有用なデバッグ情報を得ることができます。  たとえば、エラーが発生する前に呼び出されていた関数を追跡できます。  呼び出し履歴は選択可能なので、コピーして保存することができます。  
+  
+> [!NOTE]
+>  Visual Basic では、デザイン時エラー一覧に複数のエラーは表示されませんが、同じエラーの複数のインスタンスが表示される場合があります。  Visual C\+\+ では、エラーに \[コードに移動\] リンク\/行番号リンクは含まれません。  
+  
+### このエラーのヘルプ  
+ エラーに関連付けられている MSDN ヘルプ トピックがある場合は、そのヘルプ トピックへのリンクが追加ヘルプに含まれます。  このリンクをクリックすると、関連付けられているヘルプ トピックが Visual Studio に表示されます。  
+  
+### このエラーに関するフォーラム ポスト  
+ 追加ヘルプは、エラーに関連する MSDN フォーラム ポストへのリンクを含みます。  フォーラムは、エラー メッセージの文字列に基づいて検索されます。  また、次のフォーラムを検索することもできます。  
+  
+-   [Windows Forms Designer Forum \(Windows フォーム デザイナー フォーラム\)](http://go.microsoft.com/fwlink/?LinkId=203524)  
+  
+-   [Windows Forms Forums \(Windows フォーム フォーラム\)](http://go.microsoft.com/fwlink/?LinkId=203523)  
+  
+### 無視と続行  
+ エラー状態を無視して、デザイナーの読み込みを続行することを選択できます。  この操作を選択すると、予期しない動作が発生する場合があります。  たとえば、デザイン画面にコントロールが表示されない場合があります。  
+  
+## 参照  
+ [Troubleshooting Design\-Time Development](../Topic/Troubleshooting%20Design-Time%20Development.md)   
+ [コントロールとコンポーネントの作成時のトラブルシューティング](../../../../docs/framework/winforms/controls/troubleshooting-control-and-component-authoring.md)   
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)   
+ [Windows Forms Designer Error Messages](http://msdn.microsoft.com/ja-jp/cf610bf4-5fe4-471c-bce7-6a05ece07bd2)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md b/docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md
new file mode 100644
index 00000000000..23903faf6f2
--- /dev/null
+++ b/docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "承認ボタン (Windows フォームの)"
+  - "Button コントロール [Windows フォーム], 指定 (既定として)"
+  - "ボタン, 既定 (Windows フォームでの)"
+  - "Windows フォーム コントロール, 既定のボタン (フォームの)"
+ms.assetid: a1da0590-755f-49f2-aca7-609fac6351bf
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する
+すべての Windows フォーム上で、<xref:System.Windows.Forms.Button> コントロールを承認ボタン \(既定のボタンとも呼ばれます\) として指定できます。  ユーザーが **Enter** キーを押すと、フォームの他のコントロールにフォーカスがある場合でも、既定のボタンがクリックされます。  ただし、複数行テキスト ボックス、または Enter キーをトラップするカスタム コントロールの場合は例外です。また、フォーカスのあるコントロールが承認ボタン以外のボタンである場合は、フォーカスのあるボタンがクリックされます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 承認ボタンを指定するには  
+  
+1.  ボタンを配置するフォームを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、フォームの <xref:System.Windows.Forms.Form.AcceptButton%2A> プロパティを <xref:System.Windows.Forms.Button> コントロールの名前に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Form.AcceptButton%2A>   
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md b/docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md
new file mode 100644
index 00000000000..d36b886a5b6
--- /dev/null
+++ b/docs/framework/winforms/controls/designate-a-wf-button-as-the-cancel-button-using-the-designer.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], 指定 (キャンセル ボタンとして)"
+  - "ボタン, キャンセル ボタン"
+ms.assetid: 30e77d9c-d565-4ab5-a84a-62c043af8822
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : デザイナーを使用して Windows フォームの Button コントロールをキャンセル ボタンとして指定する
+すべての Windows フォーム上で、<xref:System.Windows.Forms.Button> コントロールをキャンセル ボタンとして指定できます。  ユーザーが Esc キーを押すと、フォームの他のコントロールにフォーカスがある場合でも、このキャンセル ボタンがクリックされます。  このようなボタンは、通常、ユーザーがどのアクションにもコミットせずに、すばやく操作を終了できるようにするために設定されます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### キャンセル ボタンを指定するには  
+  
+1.  ボタンを配置するフォームを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、フォームの <xref:System.Windows.Forms.Form.CancelButton%2A> プロパティを <xref:System.Windows.Forms.Button> コントロールの名前に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Form.CancelButton%2A>   
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : デザイナーを使用して Windows フォームの Button コントロールを承認ボタンとして指定する](../../../../docs/framework/winforms/controls/designate-a-wf-button-as-the-accept-button-using-the-designer.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/determine-when-formatting-attributes-change-wf-richtextbox-control.md b/docs/framework/winforms/controls/determine-when-formatting-attributes-change-wf-richtextbox-control.md
new file mode 100644
index 00000000000..6d3773d14b7
--- /dev/null
+++ b/docs/framework/winforms/controls/determine-when-formatting-attributes-change-wf-richtextbox-control.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールにおける書式属性の変更を確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], テキスト ボックス"
+  - "RichTextBox コントロール [Windows フォーム], 判断 (フォントの変更を)"
+  - "SelBold プロパティ"
+  - "SelChange イベント"
+  - "テキスト ボックス, 判断 (フォントの変更を)"
+ms.assetid: bdfed015-f77a-41e5-b38f-f8629b2fa166
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームの RichTextBox コントロールにおける書式属性の変更を確認する
+一般的に、Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールは、テキストにフォント オプションや段落スタイルなどの属性を設定するために使用されます。  多くのワード プロセッシング アプリケーションのように、テキストの書式の変更を追跡するために、アプリケーションでツール バーを表示することが必要な場合があります。  
+  
+### 書式属性の変更に応答するには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.SelectionChanged> イベント ハンドラーに、属性の値に応じて適切な処理を実行するコードを記述します。  <xref:System.Windows.Forms.RichTextBox.SelectionBullet%2A> プロパティの値に応じてツール バーのボタンの外観を変更する例を次に示します。  ツール バーのボタンは、コントロール内でカーソルが移動したときにだけ更新されます。  
+  
+     次の例では、フォームに <xref:System.Windows.Forms.RichTextBox> コントロールと、1 つのツール バー ボタンを含む <xref:System.Windows.Forms.ToolBar> コントロールがあると仮定しています。  ツール バーおよびツール バー ボタンの詳細については、「[方法 : ツール バー コントロールにボタンを追加する](../../../../docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md)」を参照してください。  
+  
+    ```vb  
+    ' The following code assumes the existence of a toolbar control  
+    ' with at least one toolbar button.  
+    Private Sub RichTextBox1_SelectionChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles RichTextBox1.SelectionChanged  
+       If RichTextBox1.SelectionBullet = True Then  
+          ' Bullet button on toolbar should appear pressed  
+          ToolBarButton1.Pushed = True  
+       Else  
+           ' Bullet button on toolbar should appear unpressed  
+           ToolBarButton1.Pushed = False  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    // The following code assumes the existence of a toolbar control  
+    // with at least one toolbar button.  
+    private void richTextBox1_SelectionChanged(object sender,  
+    System.EventArgs e)  
+    {  
+       if (richTextBox1.SelectionBullet == true)   
+       {  
+          // Bullet button on toolbar should appear pressed  
+          toolBarButton1.Pushed = true;  
+       }  
+       else   
+       {  
+          // Bullet button on toolbar should appear unpressed  
+          toolBarButton1.Pushed = false;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    // The following code assumes the existence of a toolbar control  
+    // with at least one toolbar button.  
+    private:  
+       System::Void richTextBox1_SelectionChanged(  
+          System::Object ^  sender, System::EventArgs ^  e)  
+       {  
+          if (richTextBox1->SelectionBullet == true)  
+          {  
+             // Bullet button on toolbar should appear pressed  
+             toolBarButton1->Pushed = true;  
+          }  
+          else  
+          {  
+             // Bullet button on toolbar should appear unpressed  
+             toolBarButton1->Pushed = false;  
+          }  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox.SelectionChanged>   
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md b/docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md
new file mode 100644
index 00000000000..e2be5c8a363
--- /dev/null
+++ b/docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md
@@ -0,0 +1,109 @@
+---
+title: "方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Panel コントロール [Windows フォーム], 判断 (クリックを)"
+  - "PanelClick イベント, 判断 (パネルのクリックを)"
+  - "パネル, 判断 (クリックされた)"
+  - "ステータス バー, 判断 (パネルのクリックを)"
+  - "StatusBar コントロール [Windows フォーム], コーディング (パネル クリック イベントを)"
+  - "StatusBar コントロール [Windows フォーム], 判断 (パネルのクリックを)"
+ms.assetid: d14c6092-04b2-4a07-8ddf-0dd11277ff5f
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.StatusStrip> コントロールと <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールは、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ ユーザーのクリックに応答するように [StatusBar コントロール](../../../../docs/framework/winforms/controls/statusbar-control-windows-forms.md) コントロールをプログラムするには、<xref:System.Windows.Forms.StatusBar.PanelClick> イベント内で case ステートメントを使用します。  このイベントには、クリックされた <xref:System.Windows.Forms.StatusBarPanel> オブジェクトへの参照を保持する引数 \(パネル引数\) が含まれます。  この参照を使用することにより、クリックされたパネルのインデックスを判別し、それに基づいてプログラミングできます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.StatusBar> コントロールの <xref:System.Windows.Forms.StatusBar.ShowPanels%2A> プロパティが `true` に設定されていることを確認します。  
+  
+### クリックされたパネルを判別するには  
+  
+1.  <xref:System.Windows.Forms.StatusBar.PanelClick> イベント ハンドラーで、`Select Case` ステートメント \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の場合\) または `switch case` \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] または [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] の場合\) ステートメントを使用し、イベント引数でクリックされたパネルのインデックスを調べて、どのパネルがクリックされたかを確認します。  
+  
+     次のコード例はフォームに表示を <xref:System.Windows.Forms.StatusBar>コントロールの `StatusBar1`および <xref:System.Windows.Forms.StatusBarPanel> の 2 オブジェクトおよび `StatusBarPanel1``StatusBarPanel2` 必要です。  
+  
+    ```vb  
+    Private Sub StatusBar1_PanelClick(ByVal sender As System.Object, ByVal e As System.Windows.Forms.StatusBarPanelClickEventArgs) Handles StatusBar1.PanelClick  
+       Select Case StatusBar1.Panels.IndexOf(e.StatusBarPanel)  
+         Case 0  
+           MessageBox.Show("You have clicked Panel One.")  
+         Case 1  
+           MessageBox.Show("You have clicked Panel Two.")  
+       End Select  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void statusBar1_PanelClick(object sender,   
+    System.Windows.Forms.StatusBarPanelClickEventArgs e)  
+    {  
+       switch (statusBar1.Panels.IndexOf(e.StatusBarPanel))  
+       {  
+          case 0 :  
+             MessageBox.Show("You have clicked Panel One.");  
+             break;  
+          case 1 :  
+             MessageBox.Show("You have clicked Panel Two.");  
+             break;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void statusBar1_PanelClick(System::Object ^  sender,  
+          System::Windows::Forms::StatusBarPanelClickEventArgs ^  e)  
+       {  
+          switch (statusBar1->Panels->IndexOf(e->StatusBarPanel))  
+          {  
+             case 0 :  
+                MessageBox::Show("You have clicked Panel One.");  
+                break;  
+             case 1 :  
+                MessageBox::Show("You have clicked Panel Two.");  
+                break;  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.statusBar1.PanelClick += new   
+       System.Windows.Forms.StatusBarPanelClickEventHandler   
+       (this.statusBar1_PanelClick);  
+  
+    ```  
+  
+    ```cpp  
+    this->statusBar1->PanelClick += gcnew  
+       System::Windows::Forms::StatusBarPanelClickEventHandler  
+       (this, &Form1::statusBar1_PanelClick);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusBar>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ [方法 : ステータス バー パネルのサイズを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md)   
+ [チュートリアル : ステータス バー情報の実行時更新](../../../../docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md)   
+ [StatusBar コントロールの概要](../../../../docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md b/docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md
new file mode 100644
index 00000000000..089bd9fbfd5
--- /dev/null
+++ b/docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md
@@ -0,0 +1,69 @@
+---
+title: "複合 Windows フォーム コントロールの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール"
+  - "複合コントロール, Windows フォーム"
+  - "コントロール [Windows フォーム], 複合"
+  - "カスタム コントロール [Windows フォーム], 複合コントロール"
+  - "UserControl クラス"
+ms.assetid: d086f2a3-baa3-4e09-b40c-a5bb3cfc51a6
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 複合 Windows フォーム コントロールの開発
+異なる複数の Windows フォーム コントロールを組み合わせることによって、複合 Windows フォーム コントロールを開発できます。  [System.Windows.Forms.UserControl](frlrfSystemWebUIUserControlClassTopic) から派生した複合コントロールは、ユーザー コントロールと呼ばれます。  基底クラス <xref:System.Windows.Forms.UserControl> は、子コントロールに対してキーボード ルーティングを提供し、子コントロールがフォーカスを受け取れるようにします。  ユーザー コントロールの例については、「[方法 : Windows フォーム コントロールに属性を適用する](../../../../docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md)」に記載されている <xref:System.Windows.Forms.UserControl> のサンプルを参照してください。  
+  
+ [!INCLUDE[vsprvsext](../../../../includes/vsprvsext-md.md)] の Windows フォーム デザイナーには、ユーザー コントロールを作成するための豊富なデザイン時サポートが用意されています。  
+  
+-   [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](http://msdn.microsoft.com/library/9yxtkx75\(v=vs.110\))  
+  
+-   [チュートリアル : DesignerSerializationVisibilityAttribute を使用した、標準データ型のコレクションのシリアル化](http://msdn.microsoft.com/library/ms171731\(v=vs.110\))  
+  
+-   [チュートリアル: Visual C\# による Windows フォーム コントロールからの継承](http://msdn.microsoft.com/en-us/library/5h0k2e6x%20\(v=vs.110\))  
+  
+-   [方法 : コントロールにツールボックス ビットマップを指定する](http://msdn.microsoft.com/library/4wk1wc0a%20\(v=vs.110\))  
+  
+-   [方法 : 既存の Windows フォーム コントロールから継承する](http://msdn.microsoft.com/library/7h62478z%20\(v=vs.110\))  
+  
+-   [チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](http://msdn.microsoft.com/library/5ytx0z24\(v=vs.110\))  
+  
+-   [方法 : コントロール クラスを継承する](http://msdn.microsoft.com/library/skcysbt2%20\(v=vs.110\))  
+  
+-   [方法 : UserControl の実行時の動作をテストする](http://msdn.microsoft.com/library/ms171738%20\(v=vs.110\))  
+  
+-   [方法 : デザイン時にフォームの端に合わせてコントロールを配置する](http://msdn.microsoft.com/library/1fxyb15b%20\(v=vs.110\))  
+  
+-   [方法 : UserControl クラスを継承する](http://msdn.microsoft.com/library/00ctb4z0\(v=vs.110\))  
+  
+-   [方法 : Windows フォームのコントロールを作成する](http://msdn.microsoft.com/library/bs3yhkh7%20\(v=vs.110\))  
+  
+-   [方法 : 複合コントロールを作成する](http://msdn.microsoft.com/library/3sf86w5h\(v=vs.110\))  
+  
+-   [チュートリアル : Visual Basic による複合コントロールの作成](http://msdn.microsoft.com/library/c316f119%20\(v=vs.110\))  
+  
+-   [チュートリアル : Visual C\# による複合コントロールの作成](http://msdn.microsoft.com/en-us/library/a6h7e207\(v=vs.110\))  
+  
+-   [チュートリアル: Visual Basic による Windows フォーム コントロールからの継承](http://msdn.microsoft.com/library/w2a8y03d\(v=vs.110\))  
+  
+-   [方法 : デザイン時機能を活用した Windows フォーム コントロールを作成する](http://msdn.microsoft.com/library/307hck25\(v=vs.110\))  
+  
+-   [方法 : デザイン時機能を活用した Windows フォーム コントロールを作成する](http://msdn.microsoft.com/library/307hck25\(v=vs.120\))  
+  
+## 参照  
+ [方法 : Windows フォーム コントロールに属性を適用する](../../../../docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md)   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/developing-custom-windows-forms-controls.md b/docs/framework/winforms/controls/developing-custom-windows-forms-controls.md
new file mode 100644
index 00000000000..f7eb99afd0b
--- /dev/null
+++ b/docs/framework/winforms/controls/developing-custom-windows-forms-controls.md
@@ -0,0 +1,73 @@
+---
+title: ".NET Framework を使用したカスタム Windows フォーム コントロールの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Component クラス"
+  - "Control クラス, Windows フォーム"
+  - "カスタム コントロール [Windows フォーム], 開発 (コードを使用して)"
+ms.assetid: 236cebc0-bd71-4f18-9fd6-5d0e592375df
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# .NET Framework を使用したカスタム Windows フォーム コントロールの開発
+Windows フォーム コントロールは、ユーザー インターフェイスの機能をカプセル化して、クライアント側の Windows ベースのアプリケーションで使用される再利用可能なコンポーネントです。  Windows フォームは、すぐに使用できる多数のコントロールを提供するだけでなく、独自のコントロールを開発するためのインフラストラクチャも提供します。  既存のコントロールの結合、既存のコントロールの拡張、または独自のカスタム コントロールの記述ができます。  このセクションでは、Windows フォーム コントロールの開発に役立つ背景情報とサンプルを提供します。  
+  
+## このセクションの内容  
+ [Windows フォームでのコントロールの使用方法の概要](../../../../docs/framework/winforms/controls/overview-of-using-controls-in-windows-forms.md)  
+ Windows フォーム アプリケーションでのコントロールの使用の重要な要素を示しています。  
+  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)  
+ <xref:System.Windows.Forms?displayProperty=fullName> 名前空間を使用して作成できる様々な種類のカスタム コントロールについて説明します。  
+  
+ [Windows フォーム コントロール開発の基本概念](../../../../docs/framework/winforms/controls/windows-forms-control-development-basics.md)  
+ Windows フォーム コントロールの開発の最初の手順について説明します。  
+  
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)  
+ Windows フォーム コントロールのプロパティを追加する方法を示します。  
+  
+ [Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)  
+ Windows フォーム コントロールのイベントを処理して定義する方法を示します。  
+  
+ [Windows フォーム コントロールの属性](../../../../docs/framework/winforms/controls/attributes-in-windows-forms-controls.md)  
+ カスタム コントロールとコンポーネントのプロパティや他のメンバーに適用できる属性について説明します。  
+  
+ [コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)  
+ コントロールの外観をカスタマイズする方法を示します。  
+  
+ [Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/layout-in-windows-forms-controls.md)  
+ コントロールとフォームの高度なレイアウトを作成する方法を示します。  
+  
+ [Windows フォーム コントロールのマルチスレッド処理](../../../../docs/framework/winforms/controls/multithreading-in-windows-forms-controls.md)  
+ マルチスレッド コントロールを実装する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Control?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.UserControl?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [コンポーネントのデザイン時属性](../Topic/Design-Time%20Attributes%20for%20Components.md)  
+ ビジュアル デザイナーでデザインするときに正しく表示されるようにコンポーネントとコントロールに適用するメタデータ属性の一覧を表示します。  
+  
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)  
+ デザイン時サポートを提供するエディターやデザイナーなどのクラスを実装する方法について説明します。  
+  
+ [方法 : コンポーネントおよびコントロールのライセンス処理を行う](../Topic/How%20to:%20License%20Components%20and%20Controls.md)  
+ コントロールやコンポーネントのライセンスを実装する方法について説明します。  
+  
+ 「[デザイン時の Windows フォーム コントロールの開発](http://msdn.microsoft.com/library/w29y3h59\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md b/docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md
new file mode 100644
index 00000000000..efced398aad
--- /dev/null
+++ b/docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md
@@ -0,0 +1,109 @@
+---
+title: "デザイン時の Windows フォーム コントロールの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム コントロール"
+  - "Windows フォーム コントロールを作成します。"
+  - "コントロール [Windows フォーム]"
+  - "コントロール [Windows フォーム] を作成します。"
+  - "ユーザー コントロール [Windows フォーム]"
+  - "カスタム コントロール [Windows フォーム]"
+ms.assetid: e5a8e088-7ec8-4fd9-bcb3-9078fd134829
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# デザイン時の Windows フォーム コントロールの開発
+コントロールの作成者は、.NET Framework は、さまざまなコントロール テクノロジの作成を提供します。 既存のコントロールのコレクションとして機能する複合コントロールのデザインに制限はなくなりました。 継承によって既存の複合コントロールまたは既存の Windows フォーム コントロールから、独自のコントロールを作成できます。 カスタム描画を実装する独自のコントロールを設計することもできます。 これらのオプションには、さまざまなデザインの柔軟性とビジュアル インターフェイスの機能が有効にします。 これらの機能を利用するには、オブジェクト ベースのプログラミング概念について理解ができます。  
+  
+> [!NOTE]
+>  継承、十分に理解する必要はありませんを参照する役に立つ場合があります[NOT IN ビルド: Visual Basic で継承](http://msdn.microsoft.com/ja-jp/e5e6e240-ed31-4657-820c-079b7c79313c)します。  
+  
+ Web フォームで使用するカスタム コントロールを作成する場合は、[カスタム ASP.NET サーバー コントロールの開発](../Topic/Developing%20Custom%20ASP.NET%20Server%20Controls.md)します。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [チュートリアル: Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)  
+ Visual Basic で単純な複合コントロールを作成する方法を示します。  
+  
+ [チュートリアル: Visual c# による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md)  
+ C# での簡単な複合コントロールを作成する方法を示します。  
+  
+ [チュートリアル: Visual Basic による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md)  
+ Visual Basic で継承を使用して単純な Windows フォーム コントロールを作成する方法を示します。  
+  
+ [チュートリアル: Visual c# による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md)  
+ C# での継承を使用して単純な Windows フォーム コントロールを作成する方法を示します。  
+  
+ [チュートリアル: Windows 上のスマート タグを使用した一般的なタスクを実行するフォーム コントロール](../../../../docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md)  
+ Windows フォーム コントロールのスマート タグの表示機能を使用する方法を示します。  
+  
+ [チュートリアル: designerserializationvisibilityattribute を標準的な型のコレクションをシリアル化](../../../../docs/framework/winforms/controls/serializing-collections-designerserializationvisibilityattribute.md)  
+ 使用する方法を示しています、 <xref:System.ComponentModel.DesignerSerializationVisibilityAttribute.Content?displayProperty=fullName>属性コレクションをシリアル化します。  
+  
+ [チュートリアル: カスタム Windows フォーム コントロールのデバッグ デザイン時に](../../../../docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md)  
+ Windows フォーム コントロールのデザイン時の動作をデバッグする方法を示します。  
+  
+ [チュートリアル: Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](../../../../docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md)  
+ 複合コントロールをデザイン環境に緊密に統合する方法を示します。  
+  
+ [方法: Windows フォームのコントロールを作成](../../../../docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md)  
+ Windows フォーム コントロールを実装するための考慮事項の概要を示します。  
+  
+ [方法: 複合コントロールを作成](../../../../docs/framework/winforms/controls/how-to-author-composite-controls.md)  
+ 複合コントロールから継承することでコントロールを作成する方法を示します。  
+  
+ [方法: UserControl クラスを継承](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md)  
+ 複合コントロールを作成する手順の概要を示します。  
+  
+ [方法: 既存の Windows フォーム コントロールから継承](../../../../docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md)  
+ 継承して拡張コントロールを作成する方法を示しています、<xref:System.Windows.Forms.Button>クラスを制御します。  
+  
+ [方法: コントロール クラスから継承](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md)  
+ 拡張コントロールの作成の概要を示します。  
+  
+ [方法: デザイン時に、コントロールをフォームの端を揃える](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md)  
+ 使用する方法を示しています、<xref:System.Windows.Forms.Control.Dock%2A>プロパティに合わせてそのフォームの端にコントロールを配置します。  
+  
+ [方法: にコントロールを表示、ツールボックス項目 ダイアログ ボックスの選択](../../../../docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)  
+ 表示されるように、コントロールをインストールするための手順を示しています、**ツールボックスのカスタマイズ** ダイアログ ボックス。  
+  
+ [方法: コントロールにツールボックス ビットマップを指定します。](../../../../docs/framework/winforms/controls/how-to-provide-a-toolbox-bitmap-for-a-control.md)  
+ 使用する方法を示しています、 <xref:System.Drawing.ToolboxBitmapAttribute>で、カスタム コントロールの横にあるアイコンを表示する、**ツールボックス**します。  
+  
+ [方法: UserControl の実行時の動作をテストします。](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)  
+ 使用する方法を示しています、 **UserControl テスト コンテナー**複合コントロールの動作をテストします。  
+  
+ [Windows フォーム デザイナーでデザイン時エラー](../../../../docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md)  
+ 意味と、Windows フォーム デザイナーの読み込みに失敗したときに、Microsoft Visual Studio で表示されるデザイン時のエラー リストの使用について説明します。  
+  
+ [コントロールとコンポーネントの作成のトラブルシューティング](../../../../docs/framework/winforms/controls/troubleshooting-control-and-component-authoring.md)  
+ 診断して、カスタム コンポーネントやコントロールを作成するときに発生する可能性がある一般的な問題を解決する方法を示します。  
+  
+## <a name="reference"></a>参照  
+ <xref:System.Windows.Forms.Control?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.UserControl?displayProperty=fullName>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## <a name="related-sections"></a>関連項目  
+ [フォーム コントロールの .NET Framework にカスタムの Windows の開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)  
+ .NET Framework で独自のカスタム コントロールを作成する方法について説明します。  
+  
+ [言語非依存および言語非依存コンポーネント](../../../../docs/standard/language-independence-and-language-independent-components.md)  
+ 作成およびコンポーネントの使用を簡略化するように設計された共通言語ランタイムを紹介します。 この単純さの重要な側面は、さまざまなプログラミング言語で記述されたコンポーネントの間の相互運用性を拡張します。 共通言語仕様 (CLS) では、ツールや複数のプログラミング言語で動作するコンポーネントを作成します。  
+  
+ [チュートリアル: カスタム コンポーネントを使用して、ツールボックスを自動的に設定します。](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)  
+ コンポーネントまたはコントロールに表示されるようにする方法について説明します、**ツールボックスのカスタマイズ** ダイアログ ボックス。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md b/docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md
new file mode 100644
index 00000000000..cecb3746d94
--- /dev/null
+++ b/docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md
@@ -0,0 +1,79 @@
+---
+title: "ダイアログ ボックス コントロールおよびコンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CommonDialog コントロール"
+  - "ダイアログ ボックス, Windows フォーム"
+  - "Windows フォームのダイアログ ボックス, 定義済み"
+  - "Windows フォーム, ダイアログ ボックス"
+ms.assetid: 6e5f5e9e-58d6-45f3-9df0-48b7bb6bfd5c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# ダイアログ ボックス コントロールおよびコンポーネント (Windows フォーム)
+次の Windows フォーム コントロールおよびコンポーネントは、標準のダイアログ ボックスを表示します。  各ダイアログ ボックスで使用できる機能に関する詳細については、リンクに従ってください。  
+  
+## 関連項目  
+ [ColorDialog クラス](frlrfSystemWindowsFormsColorDialogClassTopic)  
+ <xref:System.Windows.Forms.ColorDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [FontDialog クラス](frlrfSystemWindowsFormsFontDialogClassTopic)  
+ <xref:System.Windows.Forms.FontDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [OpenFileDialog クラス](frlrfSystemWindowsFormsOpenFileDialogClassTopic)  
+ <xref:System.Windows.Forms.OpenFileDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [PageSetupDialog クラス](frlrfSystemWindowsFormsPageSetupDialogClassTopic)  
+ <xref:System.Windows.Forms.PageSetupDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [PrintDialog クラス](frlrfSystemWindowsFormsPrintDialogClassTopic)  
+ <xref:System.Windows.Forms.PrintDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [PrintPreviewDialog クラス](frlrfSystemWindowsFormsPrintPreviewDialogClassTopic)  
+ <xref:System.Windows.Forms.PrintPreviewDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ [SaveFileDialog クラス](frlrfSystemWindowsFormsSaveFileDialogClassTopic)  
+ <xref:System.Windows.Forms.SaveFileDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームのダイアログ ボックス](../../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)  
+ Windows フォームのダイアログ ボックスを作成する方法について説明します。  
+  
+ [ColorDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md)  
+ ユーザーが構成済みのダイアログ ボックスでパレットから色を選択して、そのパレットにカスタムの色を追加できるようにします。  
+  
+ [FolderBrowserDialog コンポーネントの概要 \(Windows フォーム\)](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md)  
+ ユーザーがフォルダーを参照して選択できるようにします。  
+  
+ [FontDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md)  
+ 現在システムにインストールされているフォントを公開します。  
+  
+ [OpenFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md)  
+ ユーザーが構成済みのダイアログ ボックスを使用してファイルを開くことができるようにします。  
+  
+ [PageSetupDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/pagesetupdialog-component-overview-windows-forms.md)  
+ 構成済みのダイアログ ボックスを使用して印刷するページの詳細を設定します。  
+  
+ [PrintDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/printdialog-component-overview-windows-forms.md)  
+ プリンターを選択して、ページを印刷し、その他の印刷関連の設定を決定します。  
+  
+ [PrintPreviewDialog コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md)  
+ 印刷時に表示されるドキュメントを表示します。  
+  
+ [SaveFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md)  
+ 保存するファイルとそれらの保存先を選択します。  
+  
+ 「[Windows フォームのダイアログ ボックス](http://msdn.microsoft.com/library/2chz8edb\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md b/docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md
new file mode 100644
index 00000000000..4b28fd56262
--- /dev/null
+++ b/docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md
@@ -0,0 +1,58 @@
+---
+title: "Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド"
+  - "DataGrid コントロール [Windows フォーム], DataGridView コントロールとの比較"
+  - "DataGridView コントロール [Windows フォーム], DataGrid コントロールとの比較"
+ms.assetid: d412c786-140e-4210-8a56-a68467530a55
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて
+<xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わる新しいコントロールです。  <xref:System.Windows.Forms.DataGridView> コントロールには、<xref:System.Windows.Forms.DataGrid> コントロールにはない、さまざまな基本機能と高度な機能が用意されています。  さらに、<xref:System.Windows.Forms.DataGridView> コントロールのアーキテクチャにより、<xref:System.Windows.Forms.DataGrid> コントロールよりも簡単に拡張やカスタマイズが行うことができます。  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールにはない、<xref:System.Windows.Forms.DataGridView> コントロールの主要な機能のいくつかを次の表に示します。  
+  
+|DataGridView コントロールの機能|Description|  
+|----------------------------|-----------------|  
+|複数の列型|<xref:System.Windows.Forms.DataGridView> コントロールには、<xref:System.Windows.Forms.DataGrid> コントロールよりも多くの組み込みの列型が用意されています。  これらの列型は、ほとんどの一般的なシナリオのニーズに適合しますが、<xref:System.Windows.Forms.DataGrid> コントロールの列型よりも拡張や置き換えが簡単です。  詳細については、「[Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)」を参照してください。|  
+|複数の方法によるデータ表示|<xref:System.Windows.Forms.DataGrid> コントロールでは、外部データ ソースのデータしか表示できません。  それに対して、<xref:System.Windows.Forms.DataGridView> コントロールは、コントロールに保存されている非バインド データ、バインド データ ソースのデータ、またはバインド データと非バインド データを合わせて表示できます。  また、<xref:System.Windows.Forms.DataGridView> コントロールに仮想モードを実装して、カスタム データ管理を実現することもできます。  詳細については、「[Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)」を参照してください。|  
+|複数の方法によるデータ表示のカスタマイズ|<xref:System.Windows.Forms.DataGridView> コントロールには多くのプロパティとイベントが用意されていて、データの書式設定と表示方法を指定できます。  たとえば、セル、行、および列の外観をそれぞれに含まれるデータに応じて変更したり、あるデータ型のデータを別の型の等価のデータに置き換えたりできます。  詳細については、「[Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)」を参照してください。|  
+|セル、行、列、およびヘッダーの外観と動作を変更する複数のオプション|<xref:System.Windows.Forms.DataGridView> コントロールでは、個々のグリッド コンポーネントを多彩な方法で操作できます。  たとえば、行と列を固定してスクロールできないようにしたり、行、列、およびヘッダーを非表示にしたりできます。また、行、列、およびヘッダーのサイズの調整方法を変更したり、ユーザーが選択する方法を変更したりできます。さらに、個々のセル、行、および列にツールヒントとショートカット メニューを提供したりできます。|  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性と特殊なニーズに対応するために保持されますが、  ほぼすべての用途で、<xref:System.Windows.Forms.DataGridView> コントロールを使用する必要があります。  <xref:System.Windows.Forms.DataGrid> で利用できても、<xref:System.Windows.Forms.DataGridView> コントロールでは利用できない唯一の機能は、関連する 2 つのテーブルの情報を 1 つのコントロールに階層表示する機能です。  マスター\/詳細リレーションシップになっている 2 つのテーブルの情報を表示するには、<xref:System.Windows.Forms.DataGridView> コントロールを 2 つ使用する必要があります。  
+  
+## DataGridView コントロールへのアップグレード  
+ 簡単なデータ バインド シナリオで <xref:System.Windows.Forms.DataGrid> コントロールをカスタマイズせずに使用する既存のアプリケーションがある場合は、以前のコントロールを新しいコントロールに置き換えることができます。  これらのコントロールは共に Windows フォーム データ バインディング アーキテクチャを使用しているため、<xref:System.Windows.Forms.DataGridView> は、追加構成の必要なしにバインド データを表示します。  ただし、データを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドし、このコンポーネントを <xref:System.Windows.Forms.DataGridView> コントロールにバインドすると、向上したデータ バインディング機能を利用することもできます。  詳細については、「[BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールはまったく新しいアーキテクチャを採用しているため、<xref:System.Windows.Forms.DataGridView> コントロールで <xref:System.Windows.Forms.DataGrid> のカスタマイズされた機能を使用できるようにする簡単な変換パスはありません。  しかし、<xref:System.Windows.Forms.DataGridView> コントロールには組み込みの機能が用意されているため、<xref:System.Windows.Forms.DataGrid> でカスタマイズされた機能の多くは必要ありません。  <xref:System.Windows.Forms.DataGrid> コントロール用に作成したカスタム列型を <xref:System.Windows.Forms.DataGridView> コントロールで使用する場合は、新しいアーキテクチャでそれらを再実装する必要があります。  詳細については、「[Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGrid>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロール内の列の並べ替えモード](../../../../docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの選択モード](../../../../docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/disable-buttons-in-a-button-column-in-the-datagrid.md b/docs/framework/winforms/controls/disable-buttons-in-a-button-column-in-the-datagrid.md
new file mode 100644
index 00000000000..4db47fce4dc
--- /dev/null
+++ b/docs/framework/winforms/controls/disable-buttons-in-a-button-column-in-the-datagrid.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ボタン, 無効化 (ボタン列の)"
+  - "データ グリッド, 無効化 (ボタンを)"
+  - "DataGridView コントロール [Windows フォーム], 無効化 (ボタン セルを)"
+ms.assetid: 5c344d01-013a-4a6b-8f8d-62ec9321d81e
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする
+<xref:System.Windows.Forms.DataGridView> コントロールには、ボタンのようなユーザー インターフェイス \(UI\) を持つセルを表示するための <xref:System.Windows.Forms.DataGridViewButtonCell> クラスが含まれます。  ただし、<xref:System.Windows.Forms.DataGridViewButtonCell> はセルによって表示されるボタンの外観を無効にする方法は提供しません。  
+  
+ 次のコード例は、<xref:System.Windows.Forms.DataGridViewButtonCell> クラスをカスタマイズして表示可能で無効になっているボタンを表示する方法を示しています。  この例は、<xref:System.Windows.Forms.DataGridViewButtonCell> から派生した新しいセルの種類 `DataGridViewDisableButtonCell` を定義します。  このセルの種類は、`false` に設定して無効になっているボタンをセルに描画する提供できる新しい `Enabled` プロパティを提供します。  例は、`DataGridViewDisableButtonCell` オブジェクトを表示する、新しい列の種類である `DataGridViewDisableButtonColumn` も定義します。  この新しいセルと列の種類を示すために、親の <xref:System.Windows.Forms.DataGridView> 内の各 <xref:System.Windows.Forms.DataGridViewCheckBoxCell> の現在値が、同じ行にある`DataGridViewDisableButtonCell` の `Enabled` プロパティが `true` と `false` のいずれであるかを決定します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridViewCell> や <xref:System.Windows.Forms.DataGridViewColumn> から派生したクラスに新しいプロパティを追加するときは、`Clone` メソッドをオーバーライドし、複製操作時に新しいプロパティをコピーする必要があります。  また、基底クラスの `Clone` メソッドを呼び出して、基底クラスのプロパティを新しいセルまたは列にコピーする必要もあります。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridView.DisabledButtons#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DisabledButtons/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.DataGridView.DisabledButtons#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DisabledButtons/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、System.Windows.Forms、および System.Windows.Forms.VisualStyles の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)   
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md b/docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md
new file mode 100644
index 00000000000..2d462de3f9d
--- /dev/null
+++ b/docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "日付, 表示 (DateTimePicker コントロール内に)"
+  - "DateTimePicker コントロール [Windows フォーム], 表示スタイル"
+  - "例 [Windows フォーム], DateTimePicker コントロール"
+ms.assetid: 39767691-2d2b-46b6-a663-b7901e581a6e
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する
+Windows フォームの <xref:System.Windows.Forms.DateTimePicker> コントロールでは、コントロールに表示される日付および時刻の形式を柔軟に指定できます。  <xref:System.Windows.Forms.DateTimePicker.Format%2A> プロパティを使用して定義済みの形式を選択できます。定義済みの形式の一覧については、<xref:System.Windows.Forms.DateTimePickerFormat> に関するトピックを参照してください。  定義済みの形式の中に目的に適したものがない場合は、形式指定文字を使用して独自の形式スタイルを作成できます。形式指定文字の一覧については、<xref:System.Windows.Forms.DateTimePicker.CustomFormat%2A> に関するトピックを参照してください。  
+  
+### カスタム形式を表示するには  
+  
+1.  <xref:System.Windows.Forms.DateTimePicker.Format%2A> プロパティを `DateTimePickerFormat.Custom` に設定します。  
+  
+2.  <xref:System.Windows.Forms.DateTimePicker.CustomFormat%2A> プロパティを書式指定文字列に設定します。  
+  
+    ```vb  
+    DateTimePicker1.Format = DateTimePickerFormat.Custom  
+    ' Display the date as "Mon 27 Feb 2012".  
+    DateTimePicker1.CustomFormat = "ddd dd MMM yyyy"  
+  
+    ```  
+  
+    ```csharp  
+    dateTimePicker1.Format = DateTimePickerFormat.Custom;  
+    // Display the date as "Mon 27 Feb 2012".  
+    dateTimePicker1.CustomFormat = "ddd dd MMM yyyy";  
+  
+    ```  
+  
+    ```cpp  
+    dateTimePicker1->Format = DateTimePickerFormat::Custom;  
+    // Display the date as "Mon 27 Feb 2012".  
+    dateTimePicker1->CustomFormat = "ddd dd MMM yyyy";  
+    ```  
+  
+### 形式を設定した値にテキストを追加するには  
+  
+1.  "M" などの形式指定文字および ":" などの区切り記号を除く文字は、単一引用符で囲んでください。  たとえば、次の形式指定文字列は、英語 \(U.S.\) のカルチャでは現在の日付を "Today is: 05:30:31 Friday March 02, 2012" の形式で表示します。  
+  
+    ```vb  
+    DateTimePicker1.CustomFormat = "'Today is:' hh:mm:ss dddd MMMM dd, yyyy"  
+  
+    ```  
+  
+    ```csharp  
+    dateTimePicker1.CustomFormat = "'Today is:' hh:mm:ss dddd MMMM dd, yyyy";  
+  
+    ```  
+  
+    ```cpp  
+    dateTimePicker1->CustomFormat =  
+       "'Today is:' hh:mm:ss dddd MMMM dd, yyyy";  
+    ```  
+  
+     カルチャ設定に従って、単一引用符で囲まれていない文字は変更される場合があります。  たとえば、上記の形式指定文字列は、英語 \(U.S.\) のカルチャでは現在の日付を "Today is: 05:30:31 Friday March 02, 2012" の形式で表示します。  最初のコロンが単一引用符で囲まれていることに注意してください。これは、"hh:mm:ss" のコロンのように区切り文字として使用しているのではないからです。  他のカルチャでは、"Today is: 05.30.31 Friday March 02, 2012" という形式で表示される場合もあります。  
+  
+## 参照  
+ [DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)   
+ [方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する](../../../../docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/display-a-web-page-from-a-wf-linklabel-control-visual-basic.md b/docs/framework/winforms/controls/display-a-web-page-from-a-wf-linklabel-control-visual-basic.md
new file mode 100644
index 00000000000..aa1f4846a1a
--- /dev/null
+++ b/docs/framework/winforms/controls/display-a-web-page-from-a-wf-linklabel-control-visual-basic.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : Windows フォームの LinkLabel コントロールから Web ページを表示する (Visual Basic) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "LinkLabel1_LinkClicked"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], LinkLabel コントロール"
+  - "リンク, Web ページへのフォームからの"
+  - "LinkLabel コントロール [Windows フォーム], 例"
+  - "Web ページ, 表示"
+  - "Windows フォーム, リンク (Web ページに)"
+ms.assetid: 477a7398-5971-4de3-b24c-f49f32bdb28a
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Windows フォームの LinkLabel コントロールから Web ページを表示する (Visual Basic)
+次の例では、ユーザーが Windows フォームの <xref:System.Windows.Forms.LinkLabel> コントロールをクリックしたときに、既定のブラウザーに Web ページが表示されます。  
+  
+## 使用例  
+  
+```vb  
+Private Sub Form1_Load(ByVal sender As System.Object, ByVal e _  
+As System.EventArgs) Handles MyBase.Load  
+    LinkLabel1.Text = "Click here to get more info."  
+    LinkLabel1.Links.Add(6, 4, "www.microsoft.com")  
+End Sub  
+Private Sub LinkLabel1_LinkClicked(ByVal sender As System.Object, ByVal _  
+e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) Handles _  
+LinkLabel1.LinkClicked  
+    System.Diagnostics.Process.Start(e.Link.LinkData.ToString())  
+End Sub  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `Form1` という Windows フォーム  
+  
+-   `LinkLabel1` という名前の <xref:System.Windows.Forms.LinkLabel> コントロール。  
+  
+-   アクティブなインターネット接続  
+  
+## .NET Framework セキュリティ  
+ <xref:System.Diagnostics.Process.Start%2A> メソッドを呼び出すには、完全な信頼が必要です。  詳細については、「<xref:System.Security.SecurityException>」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.LinkLabel>   
+ [LinkLabel コントロール](../../../../docs/framework/winforms/controls/linklabel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md b/docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md
new file mode 100644
index 00000000000..bf604eb7600
--- /dev/null
+++ b/docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md
@@ -0,0 +1,106 @@
+---
+title: "方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エラー アイコン"
+  - "エラー メッセージ, 表示 (アイコンを)"
+  - "ErrorProvider コンポーネント [Windows フォーム], 表示 (エラー アイコンを)"
+  - "エラー [Windows フォーム], 表示 (ユーザーに)"
+ms.assetid: 3b681a32-9db4-497b-a34b-34980eabee46
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する
+Windows フォームの <xref:System.Windows.Forms.ErrorProvider> コンポーネントを使用すると、ユーザーが無効なデータを入力したときに、エラー アイコンを表示できます。  タブでフォーカスを移動して妥当性検査のコードを呼び出すには、フォーム上に少なくとも 2 つのコントロールが必要です。  
+  
+### コントロールの値が無効の場合にエラー アイコンを表示するには  
+  
+1.  Windows フォームにテキスト ボックスなどのコントロールを 2 つ追加します。  
+  
+2.  フォームに <xref:System.Windows.Forms.ErrorProvider> コンポーネントを追加します。  
+  
+3.  1 番目のコントロールを選択し、そのコントロールの <xref:System.Windows.Forms.Control.Validating> イベント ハンドラーにコードを追加します。  このコードを正しく実行するには、イベントにプロシージャを関連付ける必要があります。  詳細については、「[方法 : Windows フォームで実行時にイベント ハンドラーを作成する](../../../../docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md)」を参照してください。  
+  
+     ユーザーが入力したデータの妥当性を検査するコードの例を次に示します。データが無効の場合は、<xref:System.Windows.Forms.ErrorProvider.SetError%2A> メソッドが呼び出されます。  <xref:System.Windows.Forms.ErrorProvider.SetError%2A> メソッドの 1 番目の引数は、隣にアイコンを表示するコントロールを指定します。  2 番目の引数は、表示するエラー テキストです。  
+  
+    ```vb  
+    Private Sub TextBox1_Validating(ByVal Sender As Object, _  
+       ByVal e As System.ComponentModel.CancelEventArgs) Handles _  
+       TextBox1.Validating  
+          If Not IsNumeric(TextBox1.Text) Then  
+             ErrorProvider1.SetError(TextBox1, "Not a numeric value.")  
+          Else  
+             ' Clear the error.  
+             ErrorProvider1.SetError(TextBox1, "")  
+          End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void textBox1_Validating (object sender,  
+       System.ComponentModel.CancelEventArgs e)  
+    {  
+       try  
+       {  
+          int x = Int32.Parse(textBox1.Text);  
+          errorProvider1.SetError(textBox1, "");  
+       }  
+       catch (Exception ex)  
+       {  
+          errorProvider1.SetError(textBox1, "Not an integer value.");  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void textBox1_Validating(System::Object ^  sender,  
+          System::ComponentModel::CancelEventArgs ^  e)  
+       {  
+          try  
+          {  
+             int x = Int32::Parse(textBox1->Text);  
+             errorProvider1->SetError(textBox1, "");  
+          }  
+          catch (System::Exception ^ ex)  
+          {  
+             errorProvider1->SetError(textBox1, "Not an integer value.");  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.textBox1.Validating += new  
+    System.ComponentModel.CancelEventHandler(this.textBox1_Validating);  
+  
+    ```  
+  
+    ```cpp  
+    this->textBox1->Validating += gcnew  
+       System::ComponentModel::CancelEventHandler  
+       (this, &Form1::textBox1_Validating);  
+    ```  
+  
+4.  プロジェクトを実行します。  無効なデータ \(上の例では、数値以外のデータ\) を 1 番目のコントロールに入力し、タブで 2 番目のコントロールに移動します。  エラー アイコンが表示されたら、マウス ポインターでアイコンをポイントし、エラー テキストを表示します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ErrorProvider.SetError%2A>   
+ [ErrorProvider コンポーネントの概要](../../../../docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md)   
+ [方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する](../../../../docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md b/docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md
new file mode 100644
index 00000000000..e2c09992135
--- /dev/null
+++ b/docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "予定表, 書式指定 (表示を)"
+  - "予定表, 複数の月"
+  - "例 [Windows フォーム], 予定表コントロール"
+  - "MonthCalendar コントロール [Windows フォーム], 書式指定 (表示を)"
+ms.assetid: d197caa2-38a5-4cb4-acc3-562130c2ace3
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する
+Windows フォームの <xref:System.Windows.Forms.MonthCalendar> コントロールでは、最大 12 か月まで一度に表示できます。  既定では 1 つの月だけが表示されますが、表示する月の数と、コントロール内の各月の配置をこのコントロールで指定することもできます。  予定表の大きさを変更すると、コントロールのサイズが変更されます。したがって、新しい大きさに対して十分な領域がフォーム上にあることを確認してください。  
+  
+### 複数の月を表示するには  
+  
+-   <xref:System.Windows.Forms.MonthCalendar.CalendarDimensions%2A> プロパティに横方向および縦方向に表示する月の数を設定します。  
+  
+    ```vb  
+    MonthCalendar1.CalendarDimensions = New System.Drawing.Size (3,2)  
+  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.CalendarDimensions = new System.Drawing.Size (3,2);  
+  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->CalendarDimensions = System::Drawing::Size (3,2);  
+    ```  
+  
+## 参照  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する](../../../../docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールの外観を変更する](../../../../docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md b/docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md
new file mode 100644
index 00000000000..87e0e8af9ed
--- /dev/null
+++ b/docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md
@@ -0,0 +1,151 @@
+---
+title: "方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "予定表, 表示 (日付を太字で)"
+  - "例 [Windows フォーム], 予定表コントロール"
+  - "GetDayBold イベント"
+  - "MonthCalendar コントロール [Windows フォーム], 日付 (太字で表示される)"
+ms.assetid: 8b20db5b-8118-4825-90e8-2c45c186ac7d
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する
+Windows フォームの <xref:System.Windows.Forms.MonthCalendar> コントロールでは、日付を太字で表示できます。これは、単独の日付でも、毎年または毎月繰り返される特定の日付でもかまいません。  祝日や週末など、特別な日を目立つように表示する場合に便利です。  
+  
+ この機能は、3 つのプロパティによって制御します。  <xref:System.Windows.Forms.MonthCalendar.BoldedDates%2A> プロパティには、単独の日付が含まれます。  <xref:System.Windows.Forms.MonthCalendar.AnnuallyBoldedDates%2A> プロパティには、毎年太字で表示する日付が含まれます。  <xref:System.Windows.Forms.MonthCalendar.MonthlyBoldedDates%2A> プロパティには、毎月太字で表示する日付が含まれます。  これらの各プロパティには、<xref:System.DateTime> オブジェクトの配列が含まれます。  太字で表示する日付を追加または削除するには、<xref:System.DateTime> オブジェクトを追加または削除します。  
+  
+### 日付を太字で表示するには  
+  
+1.  <xref:System.DateTime> オブジェクトを複数個作成します。  
+  
+    ```vb  
+    Dim myVacation1 As Date = New DateTime(2001, 6, 10)  
+    Dim myVacation2 As Date = New DateTime(2001, 6, 17)  
+  
+    ```  
+  
+    ```csharp  
+    DateTime myVacation1 = new DateTime(2001, 6, 10);  
+    DateTime myVacation2 = new DateTime(2001, 6, 17);  
+  
+    ```  
+  
+    ```cpp  
+    DateTime myVacation1 = DateTime(2001, 6, 10);  
+    DateTime myVacation2 = DateTime(2001, 6, 17);  
+    ```  
+  
+2.  <xref:System.Windows.Forms.MonthCalendar> コントロールの <xref:System.Windows.Forms.MonthCalendar.AddBoldedDate%2A>、<xref:System.Windows.Forms.MonthCalendar.AddAnnuallyBoldedDate%2A>、または <xref:System.Windows.Forms.MonthCalendar.AddMonthlyBoldedDate%2A> メソッドを呼び出して、1 つの日付を太字にします。  
+  
+    ```vb  
+    MonthCalendar1.AddBoldedDate(myVacation1)  
+    MonthCalendar1.AddBoldedDate(myVacation2)  
+  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.AddBoldedDate(myVacation1);  
+    monthCalendar1.AddBoldedDate(myVacation2);  
+  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->AddBoldedDate(myVacation1);  
+    monthCalendar1->AddBoldedDate(myVacation2);  
+    ```  
+  
+     または  
+  
+     いくつかの日付を一度に太字にするには、<xref:System.DateTime> オブジェクトの配列を作成して、いずれかのプロパティに割り当てます。  
+  
+    ```vb  
+    Dim VacationDates As DateTime() = {myVacation1, myVacation2}  
+    MonthCalendar1.BoldedDates = VacationDates  
+  
+    ```  
+  
+    ```csharp  
+    DateTime[] VacationDates = {myVacation1, myVacation2};  
+    monthCalendar1.BoldedDates = VacationDates;  
+  
+    ```  
+  
+    ```cpp  
+    Array<DateTime>^ VacationDates = {myVacation1, myVacation2};  
+    monthCalendar1->BoldedDates = VacationDates;  
+    ```  
+  
+### 日付を通常のフォントで表示するには  
+  
+1.  <xref:System.Windows.Forms.MonthCalendar.RemoveBoldedDate%2A> メソッド、<xref:System.Windows.Forms.MonthCalendar.RemoveAnnuallyBoldedDate%2A> メソッド、または <xref:System.Windows.Forms.MonthCalendar.RemoveMonthlyBoldedDate%2A> メソッドを呼び出して、1 つの太字の日付を通常のフォントに戻します。  
+  
+    ```vb  
+    MonthCalendar1.RemoveBoldedDate(myVacation1)  
+    MonthCalendar1.RemoveBoldedDate(myVacation2)  
+  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.RemoveBoldedDate(myVacation1);  
+    monthCalendar1.RemoveBoldedDate(myVacation2);  
+  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->RemoveBoldedDate(myVacation1);  
+    monthCalendar1->RemoveBoldedDate(myVacation2);  
+    ```  
+  
+     または  
+  
+     <xref:System.Windows.Forms.MonthCalendar.RemoveAllBoldedDates%2A> メソッド、<xref:System.Windows.Forms.MonthCalendar.RemoveAllAnnuallyBoldedDates%2A> メソッド、または <xref:System.Windows.Forms.MonthCalendar.RemoveAllMonthlyBoldedDates%2A> メソッドを呼び出して、いずれかのリストから太字の日付をすべて削除します。  
+  
+    ```vb  
+    MonthCalendar1.RemoveAllBoldedDates()  
+  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.RemoveAllBoldedDates();  
+  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->RemoveAllBoldedDates();  
+    ```  
+  
+2.  <xref:System.Windows.Forms.MonthCalendar.UpdateBoldedDates%2A> メソッドを呼び出して、フォントの外観を更新します。  
+  
+    ```vb  
+    MonthCalendar1.UpdateBoldedDates()  
+  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.UpdateBoldedDates();  
+  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->UpdateBoldedDates();  
+    ```  
+  
+## 参照  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する](../../../../docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールの外観を変更する](../../../../docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する](../../../../docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..955eb424a3b
--- /dev/null
+++ b/docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,86 @@
+---
+title: "Windows フォーム DataGridView コントロールでのデータの表示 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示 (表形式で)"
+  - "データ グリッド, 表示 (データを)"
+  - "DataGridView コントロール [Windows フォーム], 表示 (データを)"
+  - "表示 (データを), データ グリッド"
+ms.assetid: b170b52a-2ebd-4948-ac2f-e52d494cebb2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォーム DataGridView コントロールでのデータの表示
+`DataGridView` コントロールを使用して、さまざまな外部データ ソースのデータを表示できます。  また、このコントロールに行と列を追加し、手動でデータを読み込むこともできます。  
+  
+ このコントロールをデータ ソースにバインドすると、データ ソースのスキーマに基づいて自動的に列を生成できます。  これらの列が意図したとおりに表示されない場合は、非表示にしたり、削除したり、並べ替えたりできます。  バインドしていない列を追加して、データ ソースのデータではない補足データを表示することもできます。  
+  
+ また、\(通貨書式などの\) 標準の書式を使用してデータを表示したり、必要な形式に応じて表示書式をカスタマイズしたりできます。たとえば、負の数の背景色を変更したり、文字列値を対応する画像に置き換えたりできます。  
+  
+## このセクションの内容  
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)  
+ コントロールにデータを読み込むときのオプションについて説明します。  
+  
+ [Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)  
+ セルの表示値に書式を設定するためのオプションについて説明します。  
+  
+ [チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)  
+ 手動でコントロールにデータを読み込む方法について説明します。  
+  
+ [方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)  
+ データベースからの情報を含む `BindingSource` にコントロールをバインドして、コントロールにデータを読み込む方法について説明します。  
+  
+ [方法 : データバインドされた Windows フォーム DataGridView コントロールに列を自動生成する](../../../../docs/framework/winforms/controls/autogenerate-columns-in-a-data-bound-wf-datagridview-control.md)  
+ バインドしているデータ ソースに基づいて列を自動的に生成する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する](../../../../docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md)  
+ バインドしているデータ ソースから自動的に生成された列を非表示にしたり、削除したりする方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md)  
+ バインドしているデータ ソースから自動的に生成された列を並べ替える方法について説明します。  
+  
+ [方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する](../../../../docs/framework/winforms/controls/unbound-column-to-a-data-bound-datagridview.md)  
+ バインドされていない追加の列を表示することにより、バインドされたデータ ソースのデータを補完する方法について説明します。  
+  
+ [方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md)  
+ コントロールを任意のオブジェクトのコレクションにバインドして、各オブジェクトをそれぞれ個別の行に表示する方法を説明します。  
+  
+ [方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする](../../../../docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md)  
+ コントロールの特定の行にバインドしているオブジェクトを取得する方法について説明します。  
+  
+ [チュートリアル : Windows フォームの 2 つの DataGridView コントロールを使用したマスター\/詳細形式のフォームの作成](../../../../docs/framework/winforms/controls/creating-a-master-detail-form-using-two-datagrids.md)  
+ 2 つの関連するデータベース テーブルのデータを表示する際に、一方の `DataGridView` コントロールに表示されている値が別のコントロールで現在選択されている行に依存するようにする方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)  
+ <xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName> イベントを処理して、セルの表示形式をセルの値に基づいて変更する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.BindingSource>  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)  
+ コントロールのデータに対するユーザーからの追加および修正の仕方を変更する方法を説明するトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md b/docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md
new file mode 100644
index 00000000000..28081a098e6
--- /dev/null
+++ b/docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "DomainUpDown コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DomainUpDown"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DomainUpDown コントロール [Windows フォーム], DomainUpDown コントロールの概要"
+  - "スピン ボタン コントロール, スピン ボタンの概要"
+ms.assetid: 3f40f9c1-20ad-4331-b9b5-b0127eb36eb3
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# DomainUpDown コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.DomainUpDown> コントロールは、基本的にはテキスト ボックスと、リストの項目を上下に移動するためのボタンで構成されています。  このコントロールでは、選択肢のリストから 1 つの文字列を表示したり設定したりします。  ユーザーは、上下矢印ボタンをクリックするか、方向キーを押すことで、リストの項目を選択できます。また、リスト項目と一致する文字列を直接入力することもできます。  このコントロールでは、アルファベット順のリストで項目を選択できます。  
+  
+> [!NOTE]
+>  リストを並べ替えるには、<xref:System.Windows.Forms.DomainUpDown.Sorted%2A> プロパティに `true` を設定します。  
+  
+ このコントロールの機能はリスト ボックスやコンボ ボックスによく似ていますが、このコントロールではわずかなスペースしか使用しません。  
+  
+## 主要なプロパティ  
+ コントロールの主要なプロパティは、<xref:System.Windows.Forms.DomainUpDown.Items%2A>、<xref:System.Windows.Forms.UpDownBase.ReadOnly%2A>、および <xref:System.Windows.Forms.DomainUpDown.Wrap%2A> です。  <xref:System.Windows.Forms.DomainUpDown.Items%2A> プロパティには、コントロールに表示する文字列値を持つオブジェクトのリストを格納します。  <xref:System.Windows.Forms.UpDownBase.ReadOnly%2A> に `false` を設定すると、このコントロールは、ユーザーが一部を入力した文字列をオート コンプリートし、リストの値と一致させます。  <xref:System.Windows.Forms.DomainUpDown.Wrap%2A> に `true` を設定すると、リストの末尾の項目より後にスクロールすると先頭の項目に移動します。先頭の項目より前にスクロールすると末尾の項目に移動します。  コントロールの主要なメソッドは、<xref:System.Windows.Forms.DomainUpDown.UpButton%2A> および <xref:System.Windows.Forms.DomainUpDown.DownButton%2A> です。  
+  
+ このコントロールが表示するのは文字列だけです。  数値を表示するコントロールが必要な場合は、<xref:System.Windows.Forms.NumericUpDown> コントロールを使用してください。  詳細については、「[NumericUpDown コントロールの概要](../../../../docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DomainUpDown>   
+ [DomainUpDown コントロール](../../../../docs/framework/winforms/controls/domainupdown-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/domainupdown-control-windows-forms.md b/docs/framework/winforms/controls/domainupdown-control-windows-forms.md
new file mode 100644
index 00000000000..558df308092
--- /dev/null
+++ b/docs/framework/winforms/controls/domainupdown-control-windows-forms.md
@@ -0,0 +1,53 @@
+---
+title: "DomainUpDown コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DomainUpDown コントロール [Windows フォーム]"
+  - "スピン ボタン コントロール"
+  - "スピン ボタン コントロール, アップダウン コントロール"
+  - "アップダウン コントロール"
+  - "アップダウン コントロール, スピン ボタン コントロール"
+ms.assetid: fb7cf017-e931-4a95-9d21-8caee4ee122a
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# DomainUpDown コントロール (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.DomainUpDown> コントロールの外観は、テキスト ボックスと、リストの項目を上下に移動するためのボタンで構成されています。  このコントロールでは、選択肢のリストから 1 つの文字列を表示したり設定したりします。  ユーザーは、上下矢印ボタンをクリックするか、方向キーを押すことで、リストの項目を選択できます。また、リスト項目と一致する文字列を直接入力することもできます。  このコントロールでは、アルファベット順のリストで項目を選択できます。  リストを並べ替えるには、<xref:System.Windows.Forms.DomainUpDown.Sorted%2A> プロパティに `true` を設定します。このコントロールの機能はリスト ボックスやコンボ ボックスによく似ていますが、このコントロールではわずかなスペースしか使用しません。  
+  
+ コントロールの主要なプロパティは、<xref:System.Windows.Forms.DomainUpDown.Items%2A>、<xref:System.Windows.Forms.UpDownBase.ReadOnly%2A>、および <xref:System.Windows.Forms.DomainUpDown.Wrap%2A> です。  <xref:System.Windows.Forms.DomainUpDown.Items%2A> プロパティには、コントロールに表示する文字列値を持つオブジェクトのリストを格納します。  <xref:System.Windows.Forms.UpDownBase.ReadOnly%2A> に `false` を設定すると、このコントロールは、ユーザーが一部を入力した文字列をオート コンプリートし、リストの値と一致させます。  <xref:System.Windows.Forms.DomainUpDown.Wrap%2A> に `true` を設定すると、リストの末尾の項目より後にスクロールすると先頭の項目に移動します。先頭の項目より前にスクロールすると末尾の項目に移動します。  コントロールの主要なメソッドは、<xref:System.Windows.Forms.DomainUpDown.UpButton%2A> および <xref:System.Windows.Forms.DomainUpDown.DownButton%2A> です。  
+  
+ このコントロールが表示するのは文字列だけです。  数値を表示するコントロールが必要な場合は、<xref:System.Windows.Forms.NumericUpDown> コントロールを使用してください。  詳細については、「[NumericUpDown コントロール](../../../../docs/framework/winforms/controls/numericupdown-control-windows-forms.md)」を参照してください。  
+  
+## このセクションの内容  
+ [DomainUpDown コントロールの概要](../../../../docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md)  
+ ユーザーが参照して選択できるテキスト文字列の一覧を表示する、<xref:System.Windows.Forms.DomainUpDown> コントロールの全般的な概念を説明します。  
+  
+ [方法 : Windows フォーム DomainUpDown コントロールにプログラムで項目を追加する](../../../../docs/framework/winforms/controls/how-to-add-items-to-windows-forms-domainupdown-controls-programmatically.md)  
+ <xref:System.Windows.Forms.DomainUpDown> コントロールで表示するテキスト文字列を指定する方法について説明します。  
+  
+ [方法 : Windows フォームの DomainUpDown コントロールから項目を削除する](../../../../docs/framework/winforms/controls/how-to-remove-items-from-windows-forms-domainupdown-controls.md)  
+ <xref:System.Windows.Forms.DomainUpDown> コントロールの項目をコードで削除する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DomainUpDown>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.NumericUpDown>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用できるコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/enable-column-reordering-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/enable-column-reordering-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..33539580d19
--- /dev/null
+++ b/docs/framework/winforms/controls/enable-column-reordering-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の並べ替えを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 並べ替え"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 列の順序"
+  - "Windows フォーム, 列"
+ms.assetid: d82bd69c-6799-4439-a32c-91139c5901d1
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の並べ替えを有効にする
+ユーザーが Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールに表示されるデータを確認するときに、特定の列の値を比較する必要が生じる場合があります。  これは列がコントロール内でかなり離れている場合、特に対象の列を確認するために左右にスクロールする必要がある場合には、不便です。  ユーザーが列を並べ替えることができるようにすることで列の値を容易に比較できます。  列の並べ替えを有効にすると、ユーザーは列ヘッダーをマウスでドラッグすることにより列を新しい場所に移動できます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 列の並べ替えを有効にするには  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の順序変更を有効にする\]** を選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToOrderColumns%2A?displayProperty=fullName>   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/enable-drag-and-drop-operations-with-wf-richtextbox-control.md b/docs/framework/winforms/controls/enable-drag-and-drop-operations-with-wf-richtextbox-control.md
new file mode 100644
index 00000000000..1072a49087f
--- /dev/null
+++ b/docs/framework/winforms/controls/enable-drag-and-drop-operations-with-wf-richtextbox-control.md
@@ -0,0 +1,181 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールにおけるドラッグ アンド ドロップ操作を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム]、テキスト ボックス"
+  - "ドラッグ アンド ドロップ、RichTextBox コントロール"
+  - "テキスト ボックス、ドラッグ アンド ドロップ操作"
+  - "RichTextBox コントロール [Windows フォーム]、ドラッグ アンド ドロップ操作"
+ms.assetid: ca167d1c-2014-4cf0-96a0-20598470be3b
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォームの RichTextBox コントロールにおけるドラッグ アンド ドロップ操作を有効にする
+Windows フォームでのドラッグ アンド ドロップ操作の <xref:System.Windows.Forms.RichTextBox> コントロールは、<xref:System.Windows.Forms.RichTextBox.DragEnter> および <xref:System.Windows.Forms.RichTextBox.DragDrop> イベントを処理すると実行されます。 そのため、ドラッグ アンド ドロップの操作は <xref:System.Windows.Forms.RichTextBox> コントロールを使用すると非常にシンプルです。  
+  
+### RichTextBox コントロールでドラッグ操作を有効にするには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox> プロパティの <xref:System.Windows.Forms.RichTextBox.AllowDrop%2A> コントロールを `true` に設定します。  
+  
+2.  <xref:System.Windows.Forms.RichTextBox.DragEnter> イベントのイベント ハンドラーで適切なコードを作成します。`if` ステートメントを使用して、ドラッグされるデータが適切な型 \(この場合はテキスト\) であることを確認します。<xref:System.Windows.Forms.DragEventArgs.Effect%2A?displayProperty=fullName> プロパティは、いずれかの <xref:System.Windows.Forms.DragDropEffects> 列挙値に設定できます。  
+  
+    ```vb  
+    Private Sub RichTextBox1_DragEnter(ByVal sender As Object, _   
+       ByVal e As System.Windows.Forms.DragEventArgs) _   
+       Handles RichTextBox1.DragEnter  
+       If (e.Data.GetDataPresent(DataFormats.Text)) Then  
+          e.Effect = DragDropEffects.Copy  
+       Else  
+          e.Effect = DragDropEffects.None  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void richTextBox1_DragEnter(object sender,   
+    System.Windows.Forms.DragEventArgs e)  
+    {  
+       if (e.Data.GetDataPresent(DataFormats.Text))   
+          e.Effect = DragDropEffects.Copy;  
+       else  
+          e.Effect = DragDropEffects.None;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void richTextBox1_DragEnter(System::Object ^  sender,  
+          System::Windows::Forms::DragEventArgs ^  e)  
+       {  
+          if (e->Data->GetDataPresent(DataFormats::Text))  
+             e->Effect = DragDropEffects::Copy;  
+          else  
+             e->Effect = DragDropEffects::None;  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを追加して、イベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.richTextBox1.DragEnter += new  
+        System.Windows.Forms.DragEventHandler  
+        (this.richTextBox1_DragEnter);  
+    ```  
+  
+    ```cpp  
+    this->richTextBox1->DragEnter += gcnew  
+       System::Windows::Forms::DragEventHandler  
+       (this, &Form1::richTextBox1_DragEnter);  
+    ```  
+  
+3.  <xref:System.Windows.Forms.RichTextBox.DragDrop> イベントを処理するコードを記述します。<xref:System.Windows.Forms.DataObject.GetData%2A?displayProperty=fullName> メソッドを使用してドラッグされるデータを取得します。  
+  
+     次の例では、コードは、ドラッグされるデータに相当する <xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.RichTextBox.Text%2A> のプロパティを設定します。<xref:System.Windows.Forms.RichTextBox> コントロール内にすでにテキストがある場合、ドラッグされたデータが挿入ポイントに挿入されます。  
+  
+    ```vb  
+    Private Sub RichTextBox1_DragDrop(ByVal sender As Object, _   
+       ByVal e As System.Windows.Forms.DragEventArgs) _   
+       Handles RichTextBox1.DragDrop  
+       Dim i As Int16   
+       Dim s As String  
+  
+       ' Get start position to drop the text.  
+       i = RichTextBox1.SelectionStart  
+       s = RichTextBox1.Text.Substring(i)  
+       RichTextBox1.Text = RichTextBox1.Text.Substring(0, i)  
+  
+       ' Drop the text on to the RichTextBox.  
+       RichTextBox1.Text = RichTextBox1.Text + _  
+          e.Data.GetData(DataFormats.Text).ToString()  
+       RichTextBox1.Text = RichTextBox1.Text + s  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void richTextBox1_DragDrop(object sender,   
+    System.Windows.Forms.DragEventArgs e)  
+    {  
+       int i;  
+       String s;  
+  
+       // Get start position to drop the text.  
+       i = richTextBox1.SelectionStart;  
+       s = richTextBox1.Text.Substring(i);  
+       richTextBox1.Text = richTextBox1.Text.Substring(0,i);  
+  
+       // Drop the text on to the RichTextBox.  
+       richTextBox1.Text = richTextBox1.Text +   
+          e.Data.GetData(DataFormats.Text).ToString();  
+       richTextBox1.Text = richTextBox1.Text + s;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void richTextBox1_DragDrop(System::Object ^  sender,  
+          System::Windows::Forms::DragEventArgs ^  e)  
+       {  
+          int i;  
+          String ^s;  
+  
+       // Get start position to drop the text.  
+       i = richTextBox1->SelectionStart;  
+       s = richTextBox1->Text->Substring(i);  
+       richTextBox1->Text = richTextBox1->Text->Substring(0,i);  
+  
+       // Drop the text on to the RichTextBox.  
+       String ^str = String::Concat(richTextBox1->Text, e->Data  
+       ->GetData(DataFormats->Text)->ToString());   
+       richTextBox1->Text = String::Concat(str, s);  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを追加して、イベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.richTextBox1.DragDrop += new  
+        System.Windows.Forms.DragEventHandler  
+        (this.richTextBox1_DragDrop);  
+  
+    ```  
+  
+    ```cpp  
+    this->richTextBox1->DragDrop += gcnew   
+       System::Windows::Forms::DragEventHandler  
+       (this, &Form1::richTextBox1_DragDrop);  
+    ```  
+  
+### アプリケーションでドラッグ アンド ドロップ機能をテストするには  
+  
+1.  アプリケーションを保存し、ビルドします。 実行中にワードパッドを起動します。  
+  
+     ワードパッドは、Windows によってインストールされるテキスト エディターであり、ドラッグ アンド ドロップ操作をサポートします。 ワードパッドを起動するには、**\[スタート\]** ボタンをクリックし、**\[ファイル名を指定して実行\]** を選択し、**\[ファイル名を指定して実行\]** ダイアログ ボックスのテキスト ボックスに「`WordPad`」と入力し、**\[OK\]** をクリックします。  
+  
+2.  ワードパッドが起動したら、テキストの文字列を入力します。 マウスを使用してテキストを選択し、選択したテキストを Windows アプリケーションの <xref:System.Windows.Forms.RichTextBox> コントロールにドラッグします。  
+  
+     マウスを <xref:System.Windows.Forms.RichTextBox> コントロールに移動すると \(そして、その結果 <xref:System.Windows.Forms.RichTextBox.DragEnter> イベントが発生すると\)、マウス ポインターの形が変化し、選択したテキストを <xref:System.Windows.Forms.RichTextBox> コントロールにドロップできます。  
+  
+     マウス ボタンを放すと、選択したテキストがドロップ \(つまり <xref:System.Windows.Forms.RichTextBox.DragDrop> イベントが発生\) し、<xref:System.Windows.Forms.RichTextBox> コントロール内に挿入されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox>   
+ [方法 : アプリケーション間でドラッグ アンド ドロップ操作を実行する](../../../../docs/framework/winforms/advanced/how-to-perform-drag-and-drop-operations-between-applications.md)   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/enable-tile-view-in-a-wf-listview-control-using-the-designer.md b/docs/framework/winforms/controls/enable-tile-view-in-a-wf-listview-control-using-the-designer.md
new file mode 100644
index 00000000000..8e3d894ca3a
--- /dev/null
+++ b/docs/framework/winforms/controls/enable-tile-view-in-a-wf-listview-control-using-the-designer.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム ListView コントロールの &quot;並べて表示&quot; ビューを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ListView コントロール [Windows フォーム], 並べて表示ビュー"
+  - "並べて表示ビュー機能"
+  - "タイリング, Windows フォーム, コントロール"
+ms.assetid: 12f0816a-52b8-41ee-a6d9-ded3a8a5817a
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : デザイナーを使って Windows フォーム ListView コントロールの &quot;並べて表示&quot; ビューを有効にする
+<xref:System.Windows.Forms.ListView> コントロールの並べて表示ビュー機能を使用すると、グラフィカルな情報とテキスト情報をバランスよく表示できます。  並べて表示ビューの項目で表示されるテキスト情報は、詳細表示用に定義されている列情報と同じ情報です。  並べて表示ビューは、<xref:System.Windows.Forms.ListView> コントロールのグループ化機能または挿入マーク機能のいずれかと組み合わせて使用できます。  
+  
+ 並べて表示ビューでは、サイズが 32 × 32 のアイコンと数行のテキストが以下のイメージのように使用されます。  
+  
+ ![ListView コントロール内のタイル ビュー](../../../../docs/framework/winforms/controls/media/listviewtile.gif "ListViewTile")  
+  
+ 並べて表示ビューのプロパティとメソッドを使用すると、各項目をどの列フィールドに表示するのかを指定でき、並べて表示ビュー ウィンドウ内の全項目のサイズと外観をまとめて制御できます。  また、並べて表示ビューでは、テキストの最初の行は常に項目の名前となり、変更できません。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ListView> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  並べて表示ビューを [!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] で使用できるのは、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出した場合だけです。  旧バージョンのオペレーティング システムでは、タイル ビューに関するコードがすべて無効になり、<xref:System.Windows.Forms.ListView> コントロールは大きなアイコンのビューで表示されます。  詳細については、「<xref:System.Windows.Forms.ListView.View%2A?displayProperty=fullName>」を参照してください。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーで並べて表示ビューを設定するには  
+  
+1.  フォームで <xref:System.Windows.Forms.ListView> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.ListView.View%2A> プロパティをクリックし、**\[Tile\]** を選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView.TileSize%2A>   
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md b/docs/framework/winforms/controls/enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md
new file mode 100644
index 00000000000..32592208f7c
--- /dev/null
+++ b/docs/framework/winforms/controls/enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, コピー (クリップボードに)"
+  - "クリップボードのトピック, コピー (複数のセルを)"
+  - "データ グリッド, コピー (複数のセルを)"
+  - "DataGridView コントロール [Windows フォーム], コピー (複数のセルを)"
+ms.assetid: fd0403b2-d0e3-4ae0-839c-0f737e1eb4a9
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする
+セルのコピーを有効にすると、<xref:System.Windows.Forms.DataGridView> コントロール内のデータを <xref:System.Windows.Forms.Clipboard> 経由で他のアプリケーションが簡単に利用できるようになります。  選択したセルの値は文字列に変換されてクリップボードに追加され、メモ帳や Excel などのアプリケーションにはタブ区切りのテキスト値として貼り付けられ、Word などのアプリケーションには HTML 形式のテーブルとして貼り付けられます。  
+  
+ セルのコピーは、セル値のみをコピーするか、行と列のヘッダー テキストをクリップボード データに含めるか、またはユーザーが行または列全体を選択したときのみヘッダー テキストを含めるように設定できます。  
+  
+ 選択モードによっては、ユーザーは、連続しない複数のセル グループを選択できます。  ユーザーがセルをクリップボードにコピーする際、セルが選択されていない行と列はコピーされません。  その他の行と列はすべて、クリップボードにコピーされたデータのテーブル内の行と列になります。  これらの行や列で選択されていないセルは、空白のプレースホルダーとしてクリップボードにコピーされます。  
+  
+### セルのコピーを有効にするには  
+  
+-   <xref:System.Windows.Forms.DataGridView.ClipboardCopyMode%2A?displayProperty=fullName> プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewClipboardDemo#15](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewClipboardDemo/CS/datagridviewclipboarddemo.cs#15)]
+     [!code-vb[System.Windows.Forms.DataGridViewClipboardDemo#15](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewClipboardDemo/VB/datagridviewclipboarddemo.vb#15)]  
+  
+## 使用例  
+ セルをクリップボードにコピーする完全なコード例を次に示します。  この例には、<xref:System.Windows.Forms.DataGridView.GetClipboardContent%2A?displayProperty=fullName> メソッドを使用して、選択したセルをクリップボードにコピーし、クリップボードの内容をテキスト ボックスに表示するボタンが含まれています。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewClipboardDemo#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewClipboardDemo/CS/datagridviewclipboarddemo.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewClipboardDemo#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewClipboardDemo/VB/datagridviewclipboarddemo.vb#00)]  
+  
+## コードのコンパイル  
+ このコードには、次のものが必要です。  
+  
+-   N:System アセンブリおよび N:System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.ClipboardCopyMode%2A>   
+ <xref:System.Windows.Forms.DataGridView.GetClipboardContent%2A>   
+ [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](../../../../docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md b/docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md
new file mode 100644
index 00000000000..482b4fc1fc0
--- /dev/null
+++ b/docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "ErrorProvider コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ErrorProvider"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エラー メッセージ, 表示"
+  - "ErrorProvider コンポーネント [Windows フォーム], ErrorProvider コンポーネントの概要"
+  - "エラー [Windows フォーム], 表示 (ユーザーに)"
+ms.assetid: ced189f2-b5c8-46a7-a6f1-37f5af95dc99
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ErrorProvider コンポーネントの概要 (Windows フォーム)
+Windows フォームの [ErrorProvider](../../../../docs/framework/winforms/controls/errorprovider-component-windows-forms.md) コンポーネントは、フォームまたはコントロールへのユーザー入力を検証するために使用します。  通常は、ユーザーがフォームに入力した値の妥当性を検査するとき、またはデータセット内のエラーを表示するときに使用します。  メッセージ ボックスにエラー メッセージを表示する方法もありますが、メッセージ ボックスを閉じるとエラー メッセージを見ることができなくなるため、エラー プロバイダーを使用する方が確実です。  <xref:System.Windows.Forms.ErrorProvider> コンポーネントは、テキスト ボックスなどの該当するコントロールの隣にエラー アイコン \(![ErrorProvider アイコン](../../../../docs/framework/winforms/controls/media/vberrorprovidericon.png "vbErrorProviderIcon")\) を表示します。エラー アイコンの上にマウス ポインターを置くと、エラー メッセージの文字列を表示するツールヒントが表示されます。  
+  
+## 主要なプロパティ  
+ <xref:System.Windows.Forms.ErrorProvider> コンポーネントの主要なプロパティは、<xref:System.Windows.Forms.ErrorProvider.DataSource%2A>、<xref:System.Windows.Forms.ErrorProvider.ContainerControl%2A>、および <xref:System.Windows.Forms.ErrorProvider.Icon%2A> です。  <xref:System.Windows.Forms.ErrorProvider> コンポーネントを、データがバインドされているコントロールと組み合わせて使用している場合、コンポーネントでフォーム上にエラー アイコンを表示するには、<xref:System.Windows.Forms.ErrorProvider.ContainerControl%2A> プロパティに適切なコンテナー \(通常は Windows フォーム\) を設定する必要があります。  デザイナーでこのコンポーネントを追加すると、<xref:System.Windows.Forms.ErrorProvider.ContainerControl%2A> プロパティには、コンポーネントを包含しているフォームが設定されます。コンポーネントをコードで追加する場合は、開発者が設定する必要があります。  
+  
+ <xref:System.Windows.Forms.ErrorProvider.Icon%2A> プロパティには、既定のアイコンに代えて独自のエラー アイコンを設定できます。  <xref:System.Windows.Forms.ErrorProvider.DataSource%2A> プロパティを設定すると、<xref:System.Windows.Forms.ErrorProvider> コンポーネントで特定のデータセットに関するエラー メッセージを表示できます。  <xref:System.Windows.Forms.ErrorProvider> コンポーネントの主要なメソッドは、<xref:System.Windows.Forms.ErrorProvider.SetError%2A> メソッドです。このメソッドを使用して、エラー メッセージの文字列と、エラー アイコンの表示位置を指定します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ErrorProvider> コンポーネントには、ユーザー補助クライアントの組み込みサポート機能は準備されていません。  このコンポーネントを使用する場合に、アプリケーションをユーザー補助対応にするには、新たにユーザー補助フィードバック機構を提供する必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ErrorProvider>   
+ [方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する](../../../../docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md)   
+ [方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する](../../../../docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/errorprovider-component-windows-forms.md b/docs/framework/winforms/controls/errorprovider-component-windows-forms.md
new file mode 100644
index 00000000000..1649057b43c
--- /dev/null
+++ b/docs/framework/winforms/controls/errorprovider-component-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "ErrorProvider コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エラー メッセージ, 表示"
+  - "ErrorProvider コンポーネント [Windows フォーム]"
+  - "エラー [Windows フォーム]"
+ms.assetid: c0f2e231-c5c9-413d-a507-75af2db499b6
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# ErrorProvider コンポーネント (Windows フォーム)
+Windows フォームの `ErrorProvider` コンポーネントを使用すると、処理を中断せずに、ユーザーに問題の発生を通知できます。  通常は、ユーザーがフォームに入力した値の妥当性を検査するとき、またはデータセット内のエラーを表示するときに使用します。  
+  
+## このセクションの内容  
+ [ErrorProvider コンポーネントの概要](../../../../docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md)  
+ このコンポーネントの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する](../../../../docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md)  
+ **ErrorProvider** コンポーネントを使用して、ユーザーが入力したデータの妥当性を検査する手順を示します。  
+  
+ [方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する](../../../../docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md)  
+ **ErrorProvider** コンポーネントを使用してデータ エラーを表示する手順を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ErrorProvider>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/events-in-windows-forms-controls.md b/docs/framework/winforms/controls/events-in-windows-forms-controls.md
new file mode 100644
index 00000000000..bb48262ce02
--- /dev/null
+++ b/docs/framework/winforms/controls/events-in-windows-forms-controls.md
@@ -0,0 +1,33 @@
+---
+title: "Windows フォーム コントロールのイベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], イベントの概要 (コードを使用)"
+  - "イベント [Windows フォーム], カスタム コントロール (コードを使用した)"
+ms.assetid: 7e3d1379-87aa-437c-afce-c99454eff30e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Windows フォーム コントロールのイベント
+Windows フォーム コントロールは、<xref:System.Windows.Forms.Control?displayProperty=fullName> から 60 を越えるイベントを継承します。  これらには、コントロールを描画する <xref:System.Windows.Forms.Control.Paint> イベント、ウィンドウの表示に関連するイベント \(<xref:System.Windows.Forms.Control.Resize> イベントや <xref:System.Windows.Forms.Control.Layout> イベントなど\)、下位のマウス イベントやキーボード イベントなどがあります。  <xref:System.Windows.Forms.Control> は、いくつかの下位のイベントを合成して <xref:System.Windows.Forms.Control.Click> や <xref:System.Windows.Forms.Control.DoubleClick> などの意味イベントを作成します。  継承されるイベントの詳細については、<xref:System.Windows.Forms.Control> に関するトピックを参照してください。  
+  
+ カスタム コントロールが継承したイベントの機能をオーバーライドする必要がある場合は、デリゲートを割り当てる代わりに継承した `On`*EventName* メソッドをオーバーライドします。  .NET Framework のイベント モデルの詳細については、「[コンポーネントからのイベントの生成](../Topic/Raising%20Events%20from%20a%20Component.md)」を参照してください。  
+  
+## 参照  
+ [OnPaint メソッドのオーバーライド](../../../../docs/framework/winforms/controls/overriding-the-onpaint-method.md)   
+ [ユーザーの入力の処理](../../../../docs/framework/winforms/controls/handling-user-input.md)   
+ [イベントの定義](../../../../docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md)   
+ [イベント](../../../../docs/standard/events/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/filedialog-class.md b/docs/framework/winforms/controls/filedialog-class.md
new file mode 100644
index 00000000000..f0aaa03fe87
--- /dev/null
+++ b/docs/framework/winforms/controls/filedialog-class.md
@@ -0,0 +1,44 @@
+---
+title: "FileDialog クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "FileDialog クラス"
+ms.assetid: 85a8fb62-c7d9-4a30-9b74-1cd10efe6ccb
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# FileDialog クラス
+Windows フォームの <xref:System.Windows.Forms.FileDialog> クラスは、<xref:System.Windows.Forms.OpenFileDialog> コンポーネントと <xref:System.Windows.Forms.SaveFileDialog> コンポーネントに共通する基本クラスです。  アプリケーションが実行されている Windows のバージョンによっては、これらのダイアログ ボックスの外観と動作に影響する <xref:System.Windows.Forms.FileDialog> クラスを変更できます。  
+  
+## このセクションの内容  
+ [方法 : ファイル関連のダイアログ ボックスの自動アップグレードを無効にする](../../../../docs/framework/winforms/controls/how-to-opt-out-of-file-dialog-box-automatic-upgrade.md)  
+ ファイル ダイアログ ボックスのスタイルの自動アップグレードを無効にする方法について説明します。  
+  
+ [方法 : よく使用する場所をファイル ダイアログ ボックスに追加する](../../../../docs/framework/winforms/controls/how-to-add-a-custom-place-to-a-file-dialog-box.md)  
+ ファイル ダイアログ ボックスにカスタムのファイルの場所を追加する方法について説明します。  
+  
+ [ファイル ダイアログ ボックスのカスタム プレイス用既知のフォルダー GUID](../../../../docs/framework/winforms/controls/known-folder-guids-for-file-dialog-custom-places.md)  
+ フォルダー名と、それらに関連付けられている GUID の一覧を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.OpenFileDialog>  
+  
+ <xref:System.Windows.Forms.SaveFileDialog>  
+  
+## 関連項目  
+ [OpenFileDialog コンポーネント](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md)  
+  
+ [SaveFileDialog コンポーネント](../../../../docs/framework/winforms/controls/savefiledialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/flowlayoutpanel-control-overview.md b/docs/framework/winforms/controls/flowlayoutpanel-control-overview.md
new file mode 100644
index 00000000000..fe5c2106b89
--- /dev/null
+++ b/docs/framework/winforms/controls/flowlayoutpanel-control-overview.md
@@ -0,0 +1,42 @@
+---
+title: "FlowLayoutPanel コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "FlowLayoutPanel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "FlowLayoutPanel コントロール [Windows フォーム], FlowLayoutPanel コントロールの概要"
+  - "フォーム, 動的なレイアウト"
+  - "レイアウト [Windows フォーム], 動的"
+  - "Windows フォーム, 動的なレイアウト"
+ms.assetid: 3883e024-f5a0-456d-9c27-b4dfa1cc9045
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# FlowLayoutPanel コントロールの概要
+<xref:System.Windows.Forms.FlowLayoutPanel> コントロールは、水平または垂直のフローの方向に内容を整列させます。  コントロールの内容をある行から次の行、またはある列から次の列にラップすることができます。  また、内容をラップする代わりにクリップすることができます。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティの値を設定して、フローの方向を指定できます。  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールは、右から左 \(RTL\) のレイアウトでフローの方向を正しく反転します。  また、<xref:System.Windows.Forms.FlowLayoutPanel.WrapContents%2A> プロパティの値を設定して、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの内容がラップまたはクリップされるかを指定することもできます。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールは、<xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを `true` に設定すると、自動的に内容に合わせたサイズにします。  また、**FlowBreak** プロパティを子コントロールに提供します。  FlowBreak プロパティの値を `true` に設定することで、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールを現在のフロー方向のコントロールにレイアウトすること、および次の行または列にラップすることを停止します。  
+  
+ Windows フォーム コントロールは、<xref:System.Windows.Forms.FlowLayoutPanel> の他のインスタンスを含めて、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの子にすることができます。  この機能により、実行時にフォームのサイズを調整する高度なレイアウトを構築することができます。  
+  
+ 「[チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/z9w7ek2f\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [FlowLayoutPanel コントロール](../../../../docs/framework/winforms/controls/flowlayoutpanel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/flowlayoutpanel-control-windows-forms.md b/docs/framework/winforms/controls/flowlayoutpanel-control-windows-forms.md
new file mode 100644
index 00000000000..1ca0857b0e1
--- /dev/null
+++ b/docs/framework/winforms/controls/flowlayoutpanel-control-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "FlowLayoutPanel コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "FlowLayoutPanel コントロール [Windows フォーム]"
+  - "レイアウト [Windows フォーム]"
+  - "Windows フォーム, 整列 (内容を)"
+ms.assetid: 630c9305-9ecf-4f99-94f9-ddf06de82713
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# FlowLayoutPanel コントロール (Windows フォーム)
+`FlowLayoutPanel` コントロールは、水平または垂直のフローの方向に内容を整列させます。  ある行から次の行、またはある列から次の列に内容をラップすることができます。  また、ラップする代わりにクリップすることもできます。  
+  
+ このセクションのトピックでは、`FlowLayoutPanel` の機能をアプリケーションに組み込むときに使用できる概念および手法について説明します。  
+  
+## このセクションの内容  
+ [FlowLayoutPanel コントロールの概要](../../../../docs/framework/winforms/controls/flowlayoutpanel-control-overview.md)  
+ `FlowLayoutPanel` コントロールの全般的な概念を説明します。このコントロールを使用すると、水平方向または垂直方向にフローするレイアウトを構築できます。  
+  
+ [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)  
+ <xref:System.Windows.Forms.Control.Anchor%2A> プロパティと <xref:System.Windows.Forms.Control.Dock%2A> プロパティを使用して、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールに子コントロールを固定およびドッキングする方法について説明します。  
+  
+ 「[チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/z9w7ek2f\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.FlowLayoutPanel>  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールのリファレンス ドキュメントを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..ed7f4f626dc
--- /dev/null
+++ b/docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md
@@ -0,0 +1,40 @@
+---
+title: "FolderBrowserDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "FolderBrowserDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ディレクトリ [Windows フォーム], 有効化 (アプリケーションで参照を)"
+  - "FolderBrowserDialog コンポーネント [Windows フォーム], FolderBrowserDialog の概要"
+  - "フォルダー [Windows フォーム], 有効化 (アプリケーションで参照を)"
+ms.assetid: 796b622c-3ba9-4356-93bb-e217fc52f2c7
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# FolderBrowserDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントは、フォルダーの参照と選択に使用されるモーダル ダイアログ ボックスです。  <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントから新規フォルダーを作成することもできます。  
+  
+> [!NOTE]
+>  フォルダーではなくファイルを選択する場合は、[OpenFileDialog](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md) コンポーネントを使用します。  
+  
+ <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントは、実行時に <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用して表示されます。  <xref:System.Windows.Forms.FolderBrowserDialog.RootFolder%2A> プロパティを設定して、ダイアログ ボックスのツリー ビューに表示される最上位フォルダーおよびサブフォルダーを指定します。  ダイアログ ボックスが表示された後は、<xref:System.Windows.Forms.FolderBrowserDialog.SelectedPath%2A> プロパティを使用して、選択されたフォルダーのパスを取得できます。  
+  
+ フォームに登録すると、<xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FolderBrowserDialog>   
+ [方法 : Windows フォーム FolderBrowserDialog コンポーネントを使用してフォルダーを選択する](../../../../docs/framework/winforms/controls/how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md)   
+ [FolderBrowserDialog コンポーネント](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md b/docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md
new file mode 100644
index 00000000000..ee4626da5ad
--- /dev/null
+++ b/docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md
@@ -0,0 +1,45 @@
+---
+title: "FolderBrowserDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "参照 (フォルダーを)"
+  - "ディレクトリ [Windows フォーム], 参照"
+  - "FolderBrowserDialog コンポーネント [Windows フォーム]"
+  - "フォルダー [Windows フォーム], 参照"
+ms.assetid: d71a0c5e-898a-4eea-be74-93bdf50d1852
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# FolderBrowserDialog コンポーネント (Windows フォーム)
+Windows フォームの `FolderBrowserDialog` コンポーネントは、ユーザーがフォルダーを参照して選択したり新規フォルダーを作成したりできるインターフェイスを表示します。  このコンポーネントは、ファイルの参照と選択に使用される [OpenFileDialog コンポーネント](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md) コンポーネントを補完するものです。  
+  
+## このセクションの内容  
+ [FolderBrowserDialog コンポーネントの概要 \(Windows フォーム\)](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム FolderBrowserDialog コンポーネントを使用してフォルダーを選択する](../../../../docs/framework/winforms/controls/how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md)  
+ ダイアログ ボックスから選択したフォルダーをプログラムで抽出する方法、およびコンポーネントに用意されている他のいくつかのオプション プロパティの使い方について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.FolderBrowserDialog>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームのダイアログ ボックス](../../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)  
+ ダイアログ ボックスに関する作業の一覧を示します。多くのダイアログ ボックスではタブが表示されます。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..5c1d5f901fd
--- /dev/null
+++ b/docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md
@@ -0,0 +1,37 @@
+---
+title: "FontDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "FontDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント ダイアログ ボックス"
+  - "フォント ダイアログ ボックス, Windows フォーム"
+  - "FontDialog コンポーネント [Windows フォーム], FontDialog コンポーネントの概要"
+ms.assetid: daf46e57-1b4b-4b7a-bad0-b50ca7ba75dc
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# FontDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.FontDialog> コンポーネントは、定義済みダイアログ ボックスです。このダイアログ ボックスは、現在システムにインストールされているフォントを表示するための、Windows の標準の **\[フォント\]** ダイアログ ボックスです。  このコントロールは、独自のダイアログ ボックスを使用せずにフォント設定を行うための簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  
+  
+ 既定でこのダイアログ ボックスに表示されるのは、フォント、フォント スタイル、およびサイズを選択するリスト ボックス、取り消し線や下線など、文字飾りを指定するチェック ボックス、書体の種類 \(スクリプト\) を指定するドロップダウン リスト、およびフォントの表示例です。  \[書体の種類\] ボックスを使用すると、指定されたフォントで利用できる他の文字セットを指定できます。たとえば、このドロップダウン リストで、"ヘブライ語" や "日本語" などを選択できます。フォントのダイアログ ボックスを表示するには、<xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを呼び出します。  
+  
+## 主要なプロパティ  
+ このコンポーネントには、外観を設定するための多数のプロパティがあります。  このダイアログ ボックスの選択項目を設定するのは、<xref:System.Windows.Forms.FontDialog.Font%2A> プロパティと <xref:System.Windows.Forms.FontDialog.Color%2A> プロパティです。  <xref:System.Windows.Forms.FontDialog.Font%2A> プロパティは、フォント、スタイル、サイズ、書体の種類 \(スクリプト\)、および文字飾りを設定します。たとえば、 `Arial, 10pt, style=Italic, Strikeout` と指定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FontDialog>   
+ [FontDialog コンポーネント](../../../../docs/framework/winforms/controls/fontdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/fontdialog-component-windows-forms.md b/docs/framework/winforms/controls/fontdialog-component-windows-forms.md
new file mode 100644
index 00000000000..cba6749416d
--- /dev/null
+++ b/docs/framework/winforms/controls/fontdialog-component-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "FontDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント ダイアログ ボックス, Windows フォーム"
+  - "FontDialog コンポーネント [Windows フォーム]"
+  - "フォント, ダイアログ ボックス"
+ms.assetid: 54015df3-aab2-4338-84e5-ba78cedbfdfc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# FontDialog コンポーネント (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.FontDialog> コンポーネントは、定義済みのダイアログ ボックスです。  Windows オペレーティング システムの **\[フォント\]** ダイアログ ボックスと同じダイアログ ボックスです。  このコンポーネントは、<xref:System.Windows.Forms.CommonDialog> クラスを継承します。  
+  
+## このセクションの内容  
+ [FontDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.FontDialog> コンポーネントの概念の概要を紹介します。このコンポーネントは、構成前のダイアログ ボックスの表示に使用します。  このダイアログ ボックスを使用すると、フォントとその設定を操作できます。  
+  
+ [方法 : FontDialog コンポーネントを使用してフォントの一覧を表示する](../../../../docs/framework/winforms/controls/how-to-show-a-font-list-with-the-fontdialog-component.md)  
+ <xref:System.Windows.Forms.FontDialog> コンポーネントのインスタンスを使用して実行時にフォントを選択する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.FontDialog>  
+ <xref:System.Windows.Forms.FontDialog> クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ アプリケーションまたはシステムとの標準的なやり取りを可能にする一連のコントロールおよびコンポーネントについて説明します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..58e26de8d08
--- /dev/null
+++ b/docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 固定"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 列の固定"
+  - "Windows フォーム, 列"
+ms.assetid: 87412dd2-478f-4751-af87-dafc591fc215
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する
+Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールに表示されたデータを確認する場合、ユーザーは 1 つの列または複数の列を頻繁に参照しなければならないことがあります。  たとえば、多くの列を含む顧客情報の表を表示する場合、顧客名を常に表示したまま、その他の列は表示可能な領域外にスクロールできるようにすると便利です。  
+  
+ このようにするには、コントロール内で列を固定します。  列を固定すると、その左側の \(または右から左に記述される言語スクリプトでは右側の\) すべての列も同様に固定されます。  固定された列は所定の位置に表示されたままですが、その他の列はすべてスクロールできます。  列の順序変更を有効にしている場合、固定されている列は、固定されていない列とは異なるグループと見なされます。  ユーザーはグループ内で列を再配置できますが、異なるグループには列を移動できません。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列を固定するには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の編集\]** を選択します。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[列のプロパティ\]** グリッドで、<xref:System.Windows.Forms.DataGridViewColumn.Frozen%2A> プロパティを `true` に設定します。  
+  
+    > [!NOTE]
+    >  また、**\[列の追加\]** ダイアログ ボックスの **\[固定\]** ボックスを選択することによって、列を追加する際に固定することもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Frozen%2A?displayProperty=fullName>   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](../../../../docs/framework/winforms/controls/enable-column-reordering-in-the-datagrid-using-the-designer.md)   
+ [How to: Display Right\-to\-Left Text in Windows Forms for Globalization](http://msdn.microsoft.com/ja-jp/f0663385-2354-4c65-8676-706422283b14)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/get-and-set-the-current-cell-wf-datagridview-control.md b/docs/framework/winforms/controls/get-and-set-the-current-cell-wf-datagridview-control.md
new file mode 100644
index 00000000000..6aea6013c39
--- /dev/null
+++ b/docs/framework/winforms/controls/get-and-set-the-current-cell-wf-datagridview-control.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの現在のセルを取得および設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 取得と設定 (現在の)"
+  - "DataGridView コントロール [Windows フォーム], 取得 (現在のセルを)"
+  - "DataGridView コントロール [Windows フォーム], 設定 (現在のセルを)"
+ms.assetid: b0e41e57-493a-4bd0-9376-a6f76723540c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGridView コントロールの現在のセルを取得および設定する
+多くの場合、<xref:System.Windows.Forms.DataGridView> との対話では、現在アクティブなセルをプログラムで検出する必要があります。  また、現在のセルを変更する必要もあります。  これらのタスクは <xref:System.Windows.Forms.DataGridView.CurrentCell%2A> プロパティを使用して実行できます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridViewBand.Visible%2A> プロパティが `false` に設定されている行または列には現在のセルを設定できません。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールの選択モードによっては、現在のセルを変更することで選択内容が変わることがあります。  詳細については、「[Windows フォーム DataGridView コントロールの選択モード](../../../../docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### 現在のセルをプログラムで取得するには  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CurrentCell%2A> プロパティを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#080](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#080)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#080](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#080)]  
+  
+### 現在のセルをプログラムで設定するには  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CurrentCell%2A> プロパティを設定します。  次のコード例では、現在のセルは行 0、列 1 に設定されています。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#085](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#085)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#085](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#085)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `getCurrentCellButton` という名前と `setCurrentCellButton` という名前の <xref:System.Windows.Forms.Button> コントロール。  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] では、各ボタンの <xref:System.Windows.Forms.Control.Click> イベントをプログラム例の関連付けられているイベント ハンドラーに結合する必要があります。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.CurrentCell%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの選択モード](../../../../docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md b/docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md
new file mode 100644
index 00000000000..0bd7e6a8038
--- /dev/null
+++ b/docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], グループ化"
+  - "Panel コントロール [Windows フォーム], グループ化 (コントロールを)"
+  - "Windows フォーム コントロール, グループ化"
+ms.assetid: 7e1cd708-fdb1-49d8-9ca2-5640b276bf2e
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する
+Windows フォームの <xref:System.Windows.Forms.Panel> コントロールを使用すると、他のコントロールをグループ化できます。  コントロールのグループ化には、次の 3 つの利点があります。  まず、関連しているフォーム要素を視覚的にグループ化し、わかりやすいユーザー インターフェイスを提供できます。また、オプション ボタンなどをグループ化してプログラミングできます。さらに、デザイン時に複数のコントロールをまとめて移動できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールのグループを作成するには  
+  
+1.  ツールボックスの **\[Windows フォーム\]** タブから、<xref:System.Windows.Forms.Panel> コントロールをフォームにドラッグします。  
+  
+2.  パネルにほかのコントロールを追加し、パネル内に各コントロールを配置します。  
+  
+     既存のコントロールをパネルに追加する場合は、追加するすべてのコントロールを選択し、クリップボードに切り取ります。次に、<xref:System.Windows.Forms.Panel> コントロールを選択し、そのコントロールをパネルに貼り付けます。  コントロールをパネルにドラッグすることもできます。  
+  
+3.  \(省略可能\) パネルに境界線を追加する場合は、<xref:System.Windows.Forms.BorderStyle> プロパティで設定します。  <xref:System.Windows.Forms.BorderStyle>、<xref:System.Windows.Forms.BorderStyle>、および <xref:System.Windows.Forms.BorderStyle> という 3 つの選択項目があります。  
+  
+## 参照  
+ [Panel コントロール](../../../../docs/framework/winforms/controls/panel-control-windows-forms.md)   
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)   
+ [方法 : パネルの背景を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..8271af6c974
--- /dev/null
+++ b/docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md
@@ -0,0 +1,35 @@
+---
+title: "GroupBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "GroupBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "GroupBox コントロール [Windows フォーム], GroupBox コントロールの概要"
+  - "グループ化 (コントロールを), Windows フォーム"
+ms.assetid: 03bd8ff9-c905-4f01-9bc6-8438b11d0881
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# GroupBox コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.GroupBox> コントロールを使用すると、他のコントロールと区別できるようにグループ化できます。  通常は、機能別にフォームを細分化するためにグループ ボックスを使用します。  たとえば、どの宅配業者を使用するかなどの発送情報を指定する注文フォームを作成できます。  グループ ボックスのすべてのオプションをグループ化すると、コントロールの論理的な関連性を視覚的に表現でき、デザイン時にすべてのコントロールを簡単に移動できます。<xref:System.Windows.Forms.GroupBox> コントロールを移動すると、このコントロールに含まれているすべての内容も移動します。  
+  
+ グループ ボックスのキャプションは、<xref:System.Windows.Forms.GroupBox.Text%2A> プロパティを使用して定義します。  詳細については、「[方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)」を参照してください。  
+  
+## GroupBox と Panel  
+ <xref:System.Windows.Forms.GroupBox> コントロールは <xref:System.Windows.Forms.Panel> コントロールに似ていますが、キャプションを表示できるのは <xref:System.Windows.Forms.GroupBox> コントロールだけであり、スクロール バーを表示できるのは <xref:System.Windows.Forms.Panel> コントロールだけです。  
+  
+## 参照  
+ [GroupBox コントロール](../../../../docs/framework/winforms/controls/groupbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/groupbox-control-windows-forms.md b/docs/framework/winforms/controls/groupbox-control-windows-forms.md
new file mode 100644
index 00000000000..198cd29daa0
--- /dev/null
+++ b/docs/framework/winforms/controls/groupbox-control-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "GroupBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], グループ化"
+  - "GroupBox コントロール [Windows フォーム]"
+  - "グループ化 (コントロールを)"
+ms.assetid: ee7fb3ed-2fae-4df3-bdeb-15d42e5d7d75
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# GroupBox コントロール (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.GroupBox> コントロールを使用すると、他のコントロールと区別できるようにグループ化できます。  通常は、機能別にフォームを細分化するためにグループ ボックスを使用します。  たとえば、どの宅配業者を使用するかなどの発送情報を指定する注文フォームを作成できます。  グループ ボックスのすべてのオプションをグループ化すると、論理的な関連性を視覚的に表現できます。  <xref:System.Windows.Forms.GroupBox> コントロールは <xref:System.Windows.Forms.Panel> コントロールに似ていますが、キャプションを表示できるのは <xref:System.Windows.Forms.GroupBox> コントロールだけであり、スクロール バーを表示できるのは <xref:System.Windows.Forms.Panel> コントロールだけです。  
+  
+## このセクションの内容  
+ [GroupBox コントロールの概要](../../../../docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム GroupBox コントロールを使用してコントロールをグループ化する](../../../../docs/framework/winforms/controls/how-to-group-controls-with-the-windows-forms-groupbox-control.md)  
+ このコントロールを使用してコントロールをグループ化する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.GroupBox>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.Panel>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md b/docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md
new file mode 100644
index 00000000000..a77577b75b0
--- /dev/null
+++ b/docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ エントリ, エラー処理"
+  - "データ グリッド, エラー処理"
+  - "DataGridView コントロール [Windows フォーム], エラー処理"
+  - "エラー処理, データ エントリ"
+  - "エラー処理, DataGridView コントロール"
+ms.assetid: 9004e72f-fdec-4264-a37d-2c99764efc13
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する
+次のコード例をは、データ エントリ エラーをユーザーに報告する <xref:System.Windows.Forms.DataGridView> コントロールの使用方法を示しています。  
+  
+ このコード例の詳細な説明については、「[チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridView.DataError#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridView.DataError#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Windows.Forms、および System.XML の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## .NET Framework セキュリティ  
+ 接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md b/docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md
new file mode 100644
index 00000000000..1bd36d15c15
--- /dev/null
+++ b/docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md
@@ -0,0 +1,103 @@
+---
+title: "チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ エントリ, エラー処理"
+  - "データ グリッド, エラー処理"
+  - "DataGridView コントロール [Windows フォーム], エラー処理"
+  - "エラー処理, データ エントリ"
+  - "エラー処理, DataGridView コントロール"
+  - "チュートリアル [Windows フォーム], DataGridView コントロール"
+ms.assetid: 30a68b85-d3af-4946-83c1-1e2d010d0511
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理
+データ入力アプリケーションでは、基になるデータ ストアのエラーを処理する機能が必須です。  Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールは、データ ストアが制約違反またはビジネス ルール違反を検出したときに発生する <xref:System.Windows.Forms.DataGridView.DataError> イベントを公開することで、これを簡単に実現しています。  
+  
+ このチュートリアルでは、Northwind サンプル データベースの `Customers` テーブルから行を取得し、<xref:System.Windows.Forms.DataGridView> コントロールに表示します。  新規行または編集された既存行の中で重複する `CustomerID` 値が検出されたときは、<xref:System.Windows.Forms.DataGridView.DataError> イベントが発生するので、この例外について説明する <xref:System.Windows.Forms.MessageBox> を表示することでイベントを処理します。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する](../../../../docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Northwind SQL Server サンプル データベースがインストールされたサーバーへのアクセス  
+  
+## フォームの作成  
+  
+#### DataGridView コントロール内のデータ入力エラーを処理するには  
+  
+1.  <xref:System.Windows.Forms.Form> から派生し、<xref:System.Windows.Forms.DataGridView> コントロールおよび <xref:System.Windows.Forms.BindingSource> コンポーネントを含むクラスを作成します。  
+  
+     次のコード例は、基本的な初期化処理を行い、`Main` メソッドを含みます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridView.DataError#01](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#01)]
+     [!code-vb[System.Windows.Forms.DataGridView.DataError#01](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#01)]  
+    [!code-csharp[System.Windows.Forms.DataGridView.DataError#02](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#02)]
+    [!code-vb[System.Windows.Forms.DataGridView.DataError#02](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#02)]  
+  
+2.  フォームのクラス定義に、データベースへの接続の詳細を処理するメソッドを実装します。  
+  
+     このコード例では、データが入力された <xref:System.Data.DataTable> オブジェクトを返す  `GetData`  メソッドを使用します。  `connectionString` 変数には、使用するデータベースに適した値を設定してください。  
+  
+    > [!IMPORTANT]
+    >  接続文字列内にパスワードなどの機密情報を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridView.DataError#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#30)]
+     [!code-vb[System.Windows.Forms.DataGridView.DataError#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#30)]  
+  
+3.  <xref:System.Windows.Forms.DataGridView> と <xref:System.Windows.Forms.BindingSource> の初期化、およびデータ バインディングの設定を行うために、フォームの <xref:System.Windows.Forms.Form.Load> イベントのハンドラーを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridView.DataError#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridView.DataError#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#10)]  
+  
+4.  <xref:System.Windows.Forms.DataGridView> の <xref:System.Windows.Forms.DataGridView.DataError> イベントを処理します。  
+  
+     エラーのコンテキストがコミット操作である場合は、エラーを <xref:System.Windows.Forms.MessageBox> に表示します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridView.DataError#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/CS/errorhandling.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridView.DataError#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.DataError/VB/errorhandling.vb#20)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   F5 キーを押してアプリケーションを実行します。  
+  
+     <xref:System.Windows.Forms.DataGridView> コントロールに Customers テーブルのデータが読み込まれることを確認します。  `CustomerID` に重複する値を入力して編集内容をコミットすると、セルの値が自動的に元に戻り、データ入力エラーを示す <xref:System.Windows.Forms.MessageBox> が表示されます。  
+  
+## 次の手順  
+ このアプリケーションでは、<xref:System.Windows.Forms.DataGridView> コントロールの機能について基本を理解できます。  次のような方法を使用すると、<xref:System.Windows.Forms.DataGridView> コントロールの外観および動作をカスタマイズできます。  
+  
+-   輪郭およびヘッダー スタイルを変更します。  詳細については、「[方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力の許可または制限。  詳細については、「[方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)」および「[方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力を検証します。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   仮想モードを使用した大量のデータの処理。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+-   セルの外観をカスタマイズします。  詳細については、「[方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)」および「[方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する](../../../../docs/framework/winforms/controls/handle-errors-that-occur-during-data-entry-in-the-datagrid.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/handling-user-input.md b/docs/framework/winforms/controls/handling-user-input.md
new file mode 100644
index 00000000000..cbb92e0fe9e
--- /dev/null
+++ b/docs/framework/winforms/controls/handling-user-input.md
@@ -0,0 +1,76 @@
+---
+title: "ユーザーの入力の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], キーボード イベント (コードを使用)"
+  - "カスタム コントロール [Windows フォーム], マウス イベント (コードを使用)"
+  - "カスタム コントロール [Windows フォーム], ユーザー入力 (コードを使用)"
+ms.assetid: d9b12787-86f6-4022-8e0f-e12d312c4af2
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ユーザーの入力の処理
+このトピックでは、<xref:System.Windows.Forms.Control?displayProperty=fullName> によって提供される主要なキーボード イベントとマウス イベントについて説明します。  イベントを処理する場合、コントロールの作成者はイベントにデリゲートをアタッチする代わりに、`On`*EventName* プロテクト メソッドをオーバーライドする必要があります。  イベントの詳細については、「[コンポーネントからのイベントの生成](../Topic/Raising%20Events%20from%20a%20Component.md)」を参照してください。  
+  
+> [!NOTE]
+>  イベントに関連付けられているデータがない場合には、`On`*EventName* メソッドの引数として <xref:System.EventArgs> 基本クラスのインスタンスが渡されます。  
+  
+## キーボード イベント  
+ コントロールで処理できる一般的なキーボード イベントとして、<xref:System.Windows.Forms.Control.KeyDown>、<xref:System.Windows.Forms.Control.KeyPress>、<xref:System.Windows.Forms.Control.KeyUp> などがあります。  
+  
+|イベント名|オーバーライドするメソッド|イベントに関する説明|  
+|-----------|-------------------|----------------|  
+|`KeyDown`|`void OnKeyDown(KeyEventArgs)`|初めてキーを押すときにだけ発生します。|  
+|`KeyPress`|`void OnKeyPress`<br /><br /> `(KeyPressEventArgs)`|キーを押すたびに発生します。  キーを押したままの状態にすると、オペレーティング システムで定義されているリピート間隔で <xref:System.Windows.Forms.Control.KeyPress> イベントが発生します。|  
+|`KeyUp`|`void OnKeyUp(KeyEventArgs)`|キーを離すと発生します。|  
+  
+> [!NOTE]
+>  キーボードからの入力の処理は、上記の表に示すイベントのオーバーライドよりもかなり複雑です。キーボードからの入力の処理については、このトピックでは詳しく説明しません。  詳細については、「[Windows フォームでのユーザー入力](../../../../docs/framework/winforms/user-input-in-windows-forms.md)」を参照してください。  
+  
+## マウス イベント  
+ コントロールで処理できるマウス イベントには、<xref:System.Windows.Forms.Control.MouseDown>、<xref:System.Windows.Forms.Control.MouseEnter>、<xref:System.Windows.Forms.Control.MouseHover>、<xref:System.Windows.Forms.Control.MouseLeave>、<xref:System.Windows.Forms.Control.MouseMove>、および <xref:System.Windows.Forms.Control.MouseUp> などがあります。  
+  
+|イベント名|オーバーライドするメソッド|イベントに関する説明|  
+|-----------|-------------------|----------------|  
+|`MouseDown`|`void OnMouseDown(MouseEventArgs)`|ポインターがコントロール上に置かれている状態でマウス ボタンを押すと発生します。|  
+|`MouseEnter`|`void OnMouseEnter(EventArgs)`|コントロール領域内にポインターが初めて入るときに発生します。|  
+|`MouseHover`|`void OnMouseHover(EventArgs)`|ポインターがコントロール上を移動するときに発生します。|  
+|`MouseLeave`|`void OnMouseLeave(EventArgs)`|コントロール領域内からポインターが出るときに発生します。|  
+|`MouseMove`|`void OnMouseMove(MouseEventArgs)`|コントロール領域内でポインターを移動すると発生します。|  
+|`MouseUp`|`void OnMouseUp(MouseEventArgs)`|ポインターがコントロールに置かれた状態でマウス ボタンを離すか、またはコントロール領域からポインターが出るときに発生します。|  
+  
+ <xref:System.Windows.Forms.Control.MouseDown> イベントをオーバーライドするコード片の例を次に示します。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#7)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#7)]  
+  
+ <xref:System.Windows.Forms.Control.MouseMove> イベントをオーバーライドするコード片の例を次に示します。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#8)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#8)]  
+  
+ <xref:System.Windows.Forms.Control.MouseUp> イベントをオーバーライドするコード片の例を次に示します。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#9](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#9)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#9](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#9)]  
+  
+ `FlashTrackBar` のソース コード例全体については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)   
+ [イベントの定義](../../../../docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md)   
+ [イベント](../../../../docs/standard/events/index.md)   
+ [Windows フォームでのユーザー入力](../../../../docs/framework/winforms/user-input-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/helpprovider-component-overview-windows-forms.md b/docs/framework/winforms/controls/helpprovider-component-overview-windows-forms.md
new file mode 100644
index 00000000000..024c14d330b
--- /dev/null
+++ b/docs/framework/winforms/controls/helpprovider-component-overview-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "HelpProvider コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "HelpProvider"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダイアログ ボックス, 状況依存のヘルプ"
+  - "F1 ヘルプ, 追加 (Windows フォームに)"
+  - "ヘルプ, 追加 (Windows アプリケーションに)"
+  - "HelpProvider コンポーネント [Windows フォーム], HelpProvider コンポーネントの概要"
+  - "Windows フォーム, 状況依存のヘルプ"
+ms.assetid: 6b10c2cc-c577-4cb5-9669-e37b33416af9
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# HelpProvider コンポーネントの概要 (Windows フォーム)
+Windows フォームの [HelpProvider](../../../../docs/framework/winforms/controls/helpprovider-component-windows-forms.md) コンポーネントは、HTML Help 1.x ヘルプ ファイル \(HTML Help Workshop で生成した .chm ファイル、または .htm ファイル\) を Windows アプリケーションに関連付けるために使用します。  ヘルプを用意するにはさまざまな方法があります。  
+  
+-   Windows フォームのコントロールに状況依存のヘルプを用意します。  
+  
+-   特定のダイアログ ボックスまたはダイアログ ボックス内の特定のコントロールに状況依存のヘルプを用意します。  
+  
+-   目次、索引、検索機能のメイン ページなど、ヘルプ ファイルの特定の領域を開きます。  
+  
+## HelpProvider の使用  
+ <xref:System.Windows.Forms.HelpProvider> コンポーネントを Windows フォームに追加すると、フォーム上のその他のコントロールで <xref:System.Windows.Forms.HelpProvider> コンポーネントのヘルプ プロパティを公開できます。  これによって、Windows フォーム上にコントロールのヘルプを表示できます。  <xref:System.Windows.Forms.HelpProvider> コンポーネントにヘルプ ファイルを関連付けるには、<xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> プロパティを使用します。  <xref:System.Windows.Forms.HelpProvider.SetHelpNavigator%2A> を呼び出し、特定のコントロールの <xref:System.Windows.Forms.HelpNavigator> 列挙体の値を指定することによって、提供されるヘルプの種類を指定します。  <xref:System.Windows.Forms.HelpProvider.SetHelpKeyword%2A> メソッドを呼び出して、ヘルプのキーワードまたはトピックを指定します。  
+  
+ また、特定のヘルプ文字列を他のコントロールに関連付けるには、<xref:System.Windows.Forms.HelpProvider.SetHelpString%2A> メソッドを使用します。  コントロールにフォーカスがあるときに F1 キーを押すと、コントロールに関連付けた文字列がポップアップ ウィンドウに表示されます。  
+  
+ <xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> が設定されていない場合は、<xref:System.Windows.Forms.HelpProvider.SetHelpString%2A> を使用してヘルプ テキストを用意する必要があります。  <xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> とヘルプ文字列の両方が設定されている場合は、<xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> のヘルプが優先されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.Help.ShowHelp%2A> メソッドまたは <xref:System.Windows.Forms.HelpProvider> コントロールの <xref:System.Windows.Forms.HelpProvider.HelpNamespace%2A> プロパティでヘルプ ファイルへのパスを指定する場合に相対パスを使用すると、問題が生じることがあります。  したがって、ヘルプ ファイルを指定する場合は、必ず絶対ファイル パスを使用してください。  
+  
+## 参照  
+ [Windows フォーム アプリケーションのヘルプ システム](../../../../docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/helpprovider-component-windows-forms.md b/docs/framework/winforms/controls/helpprovider-component-windows-forms.md
new file mode 100644
index 00000000000..1f6e860e20b
--- /dev/null
+++ b/docs/framework/winforms/controls/helpprovider-component-windows-forms.md
@@ -0,0 +1,45 @@
+---
+title: "HelpProvider コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, ヘルプ"
+  - "ヘルプ, 表示 (Windows フォームに)"
+  - "HelpProvider コンポーネント [Windows フォーム]"
+ms.assetid: a09a6e0b-79d8-457f-bb36-86fad2beeada
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# HelpProvider コンポーネント (Windows フォーム)
+Windows フォーム `HelpProvider` コンポーネントは、Windows ベースのアプリケーションで HTML ヘルプ 1.x のヘルプ ファイル \(HTML Help Workshop で生成された .chm ファイル、または .htm ファイル\) を関連付けるために使用します。  
+  
+## このセクションの内容  
+ [HelpProvider コンポーネントの概要](../../../../docs/framework/winforms/controls/helpprovider-component-overview-windows-forms.md)  
+ HTML ヘルプ ファイルを Windows ベースのアプリケーションに関連付けることができる、`HelpProvider` コンポーネントの一般的な概念について説明します。  
+  
+ [Windows フォーム アプリケーションのヘルプ システム](../../../../docs/framework/winforms/advanced/help-systems-in-windows-forms-applications.md).  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.HelpProvider>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.Help>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ 「[Windows フォーム アプリケーションのヘルプ システム](http://msdn.microsoft.com/library/55dct0a1\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/hide-columns-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/hide-columns-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..db28dbf0702
--- /dev/null
+++ b/docs/framework/winforms/controls/hide-columns-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 非表示"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 列の非表示"
+  - "Windows フォーム, 列"
+ms.assetid: a81c38e6-2527-426a-bcb1-be691403be04
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする
+Windows フォームの <xref:System.Windows.Forms.DataGridView> コントロールで使用できる列のうち、一部の列だけを表示する必要が生じる場合があります。  たとえば、従業員の給与の列を管理の資格情報を持つユーザーには表示して、他のユーザーには非表示にできます。  または、多くの列を含むデータ ソースにコントロールをバインドし、そのいくつかだけを表示することもできます。  この場合、通常、表示しない列は非表示にするのではなく削除します。  詳細については、「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列を非表示にするには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の編集\]** を選択します。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[列のプロパティ\]** グリッドで、<xref:System.Windows.Forms.DataGridViewColumn.Visible%2A> プロパティを `false` に設定します。  
+  
+    > [!NOTE]
+    >  また、**\[列の追加\]** ダイアログ ボックスの **\[可視\]** ボックスをオフすることによって、列の追加時に列を非表示にすることもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A?displayProperty=fullName>   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md b/docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md
new file mode 100644
index 00000000000..0d1e56280e5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, アクセス (バインドされたオブジェクトに)"
+  - "DataGridView コントロール [Windows フォーム], アクセス (行にバインドされたオブジェクトに)"
+  - "オブジェクトのバインディング, アクセス (バインドされたオブジェクトに)"
+ms.assetid: 0e05748f-4403-4eb8-8b2f-b098108181b5
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする
+場合によっては、ビジネス オブジェクトのコレクションに格納されている情報のテーブルを表示すると便利です。  <xref:System.Windows.Forms.DataGridView> コントロールをそのようなコレクションにバインドすると、<xref:System.ComponentModel.BrowsableAttribute> によって参照不可にマークされない限り、各パブリック プロパティが独自の列に表示されます。  たとえば、`Customer` オブジェクトのコレクションが、**名前**や**アドレス**などの列を持っています。  
+  
+ アクセスする追加情報とコードがこれらのオブジェクトに含まれている場合は、行オブジェクトを介してアクセスできます。  次のコード例では、ユーザーが複数の行を選択し、ボタンをクリックすると、対応する顧客のそれぞれに請求書を送信できます。  
+  
+### 行にバインドされたオブジェクトにアクセスするには  
+  
+-   <xref:System.Windows.Forms.DataGridViewRow.DataBoundItem%2A?displayProperty=fullName> プロパティを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewObjectBinding#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewObjectBinding/CS/datagridviewobjectbinding.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewObjectBinding#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewObjectBinding/VB/datagridviewobjectbinding.vb#10)]  
+  
+## 使用例  
+ 完全なコード例には、単純な `Customer` 実装が含まれ、<xref:System.Windows.Forms.DataGridView> を `Customer` オブジェクトがいくつか含まれる <xref:System.Collections.ArrayList> にバインドします。  <xref:System.Windows.Forms.Button?displayProperty=fullName> の <xref:System.Windows.Forms.Control.Click> イベント ハンドラーは、行を介して `Customer` オブジェクトにアクセスする必要があります。これは、<xref:System.Windows.Forms.Form.Load?displayProperty=fullName> イベント ハンドラーの外部で、顧客のコレクションにアクセスできないためです。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewObjectBinding#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewObjectBinding/CS/datagridviewobjectbinding.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewObjectBinding#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewObjectBinding/VB/datagridviewobjectbinding.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewRow>   
+ <xref:System.Windows.Forms.DataGridViewRow.DataBoundItem%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-access-the-html-source-in-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/how-to-access-the-html-source-in-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..f13b3ebaca9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-access-the-html-source-in-the-managed-html-document-object-model.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : マネージ HTML DOM (Document Object Model) の HTML ソースにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "HTML, アクセス (Windows フォームで)"
+  - "マネージ HTML DOM"
+ms.assetid: 53db79fa-8a5e-448e-88c2-f54ace3860b6
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : マネージ HTML DOM (Document Object Model) の HTML ソースにアクセスする
+<xref:System.Windows.Forms.WebBrowser> コントロールの <xref:System.Windows.Forms.WebBrowser.DocumentStream%2A> プロパティおよび <xref:System.Windows.Forms.WebBrowser.DocumentText%2A> プロパティは、現在のドキュメントが最初に表示されたときに存在した HTML を返します。  ただし、<xref:System.Windows.Forms.HtmlElement.AppendChild%2A> や <xref:System.Windows.Forms.HtmlElement.InnerHtml%2A> のようなメソッド呼び出しやプロパティ呼び出しを使用してページを変更すると、<xref:System.Windows.Forms.WebBrowser.DocumentStream%2A> や <xref:System.Windows.Forms.WebBrowser.DocumentText%2A> を呼び出したときにこれらの変更は表示されません。  DOM の最新の HTML ソースを取得するには、HTML 要素の <xref:System.Windows.Forms.HtmlElement.OuterHtml%2A> プロパティを呼び出す必要があります。  
+  
+ 次の手順では、動的ソースを取得し、別のショートカット メニューに表示する方法を示します。  
+  
+### OuterHtml プロパティを使用した動的ソースの取得  
+  
+1.  新しい Windows フォーム アプリケーションを作成します。  まず、<xref:System.Windows.Forms.Form> を 1 つ作成し、`Form1` という名前を付けます。  
+  
+2.  Windows フォーム アプリケーションで <xref:System.Windows.Forms.WebBrowser> コントロールをホストし、`WebBrowser1` という名前を付けます。  詳細については、「[方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md)」を参照してください。  
+  
+3.  アプリケーション内で、`CodeForm` という 2 番目の <xref:System.Windows.Forms.Form> を作成します。  
+  
+4.  <xref:System.Windows.Forms.RichTextBox> コントロールを `CodeForm` に追加し、その <xref:System.Windows.Forms.Control.Dock%2A> プロパティを `Fill` に設定します。  
+  
+5.  `CodeForm` に `Code` というパブリック プロパティを作成します。  
+  
+     [!code-csharp[DisplayWebBrowserCode#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/DisplayWebBrowserCode/CS/CodeForm.cs#1)]
+     [!code-vb[DisplayWebBrowserCode#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/DisplayWebBrowserCode/VB/CodeForm.vb#1)]  
+  
+6.  `Button1` という名前の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.Form> に追加し、<xref:System.Windows.Forms.Control.Click> イベントを監視します。  イベントの監視の詳細については、「[イベント](../../../../docs/standard/events/index.md)」を参照してください。  
+  
+7.  <xref:System.Windows.Forms.Control.Click> イベント ハンドラーに次のコードを追加します。  
+  
+     [!code-csharp[DisplayWebBrowserCode#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/DisplayWebBrowserCode/CS/Form1.cs#2)]
+     [!code-vb[DisplayWebBrowserCode#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/DisplayWebBrowserCode/VB/Form1.vb#2)]  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.Windows.Forms.WebBrowser.Document%2A> の値を取得する前に、必ずテストしてください。  現在のページの読み込みが完了していない場合、<xref:System.Windows.Forms.WebBrowser.Document%2A> またはその 1 つ以上の子オブジェクトが初期化されていない可能性があります。  
+  
+## 参照  
+ [マネージ HTML DOM \(Document Object Model\) の使用](../../../../docs/framework/winforms/controls/using-the-managed-html-document-object-model.md)   
+ [WebBrowser コントロールの概要](../../../../docs/framework/winforms/controls/webbrowser-control-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-access-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/how-to-access-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..c764b537d9c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-access-the-managed-html-document-object-model.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : マネージ HTML DOM (Document Object Model) にアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "HTML DOM にアクセスします。"
+  - "マネージ HTML DOM にアクセスします。"
+ms.assetid: 40fa5cd5-1ed8-42f6-a93f-9ac01608bbeb
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : マネージ HTML DOM (Document Object Model) にアクセスする
+マネージ HTML ドキュメント オブジェクト モデル (DOM) には、次の&2; 種類のアプリケーションからアクセスできます。  
+  
+-   マネージ ホストされている Windows フォーム アプリケーション (.exe) <xref:System.Windows.Forms.WebBrowser>コントロールです。 これら&2; つのテクノロジが相互に補完、 <xref:System.Windows.Forms.WebBrowser>コントロール、ユーザーと、ドキュメントの論理構造を表す HTML DOM にページを表示します。  
+  
+-   Windows フォーム<xref:System.Windows.Forms.UserControl> Internet Explorer 内でホストされています。 先のページを表す HTML DOM にアクセスすることができます、 <xref:System.Windows.Forms.UserControl>がドキュメントの構造を変更したり、さまざまな操作の間でのモーダル ダイアログ ボックスを開いたりするためにホストされています。  
+  
+### <a name="to-access-dom-from-a-windows-forms-application"></a>Windows フォーム アプリケーションから DOM にアクセスするには  
+  
+1.  ホスト、 <xref:System.Windows.Forms.WebBrowser> 、Windows フォーム アプリケーション内で制御し、監視、 <xref:System.Windows.Forms.WebBrowser.DocumentCompleted>イベントです。 コントロールをホストしていると、イベントの監視の詳細については、「[イベント](../../../../docs/standard/events/index.md)です。  
+  
+2.  取得、 <xref:System.Windows.Forms.HtmlDocument> 、現在のページにアクセスして、<xref:System.Windows.Forms.WebBrowser.Document%2A>のプロパティ、 <xref:System.Windows.Forms.WebBrowser>コントロールです。  
+  
+<!-- TODO: review snippet reference  [!CODE [AccessHTMLDOMApp#1](AccessHTMLDOMApp#1)]  -->  
+  
+### <a name="to-access-dom-from-a-usercontrol-hosted-in-internet-explorer"></a>Internet Explorer でホストされた UserControl から DOM にアクセスするには  
+  
+1.  独自のカスタム派生クラスを作成、 <xref:System.Windows.Forms.UserControl>クラスです。 詳細については、次を参照してください。[方法: 複合コントロールの作成](../../../../docs/framework/winforms/controls/how-to-author-composite-controls.md)します。  
+  
+2.  Load イベント ハンドラー内の次のコードを配置、 <xref:System.Windows.Forms.UserControl>:  
+  
+ [!code-csharp[AccessHTMLDOMControl#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/AccessHTMLDOMControl/cs/UserControl1.cs#1)]
+ [!code-vb[AccessHTMLDOMControl#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/AccessHTMLDOMControl/vb/UserControl1.vb#1)]  
+  
+## <a name="robust-programming"></a>信頼性の高いプログラミング  
+  
+1.  を通じて DOM を使用する場合、 <xref:System.Windows.Forms.WebBrowser>コントロールが常にまで待っていると、 <xref:System.Windows.Forms.WebBrowser.DocumentCompleted>にアクセスする前に発生するイベント、<xref:System.Windows.Forms.WebBrowser.Document%2A>のプロパティ、 <xref:System.Windows.Forms.WebBrowser>コントロールです。 <xref:System.Windows.Forms.WebBrowser.DocumentCompleted>ドキュメント全体が読み込まれた後にイベントが発生します。 アプリケーションで、実行時に例外が発生する恐れその前に、DOM を使用する場合。  
+  
+## <a name="net-framework-security"></a>.NET Framework セキュリティ  
+  
+1.  アプリケーションまたは<xref:System.Windows.Forms.UserControl>マネージ HTML DOM にアクセスするために完全な信頼が必要 使用して Windows フォーム アプリケーションを展開する場合[!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)]、アクセス許可の昇格または信頼されたアプリケーションの配置を使用して完全な信頼を要求できます。 を参照してください[ClickOnce アプリケーションのセキュリティで保護する](../Topic/Securing%20ClickOnce%20Applications.md)詳細です。  
+  
+## <a name="see-also"></a>関連項目  
+ [マネージ HTML ドキュメント オブジェクト モデルを使用します。](../../../../docs/framework/winforms/controls/using-the-managed-html-document-object-model.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page-using-the-designer.md b/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page-using-the-designer.md
new file mode 100644
index 00000000000..5c83ba6de7c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page-using-the-designer.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : デザイナーを使ってタブ ページにコントロールを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ コントロール, タブ オーダー"
+  - "タブ ページ, 追加 (コントロールを)"
+  - "TabPage コントロール"
+ms.assetid: 7ee734e1-e31e-4ed0-bbc0-a7e8a1f20fef
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : デザイナーを使ってタブ ページにコントロールを追加する
+Windows フォーム <xref:System.Windows.Forms.TabControl> \(タブ コントロール\) を使用すると、他のコントロールを整理して表示できます。  タブ ページの本体部分に画像を表示するには、次の手順に従います。  タブ ページのラベル部分にアイコンを追加する方法の詳細については、「[方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.TabControl> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使ってコントロールを追加するには  
+  
+1.  目的のタブ ページをクリックして最前面に表示します。  
+  
+2.  タブ ページ上にコントロールを描画します。  
+  
+## 参照  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)   
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md b/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md
new file mode 100644
index 00000000000..e91b897fa5f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : タブ ページにコントロールを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ コントロール, タブ オーダー"
+  - "タブ ページ, 追加 (コントロールを)"
+  - "TabPage コントロール"
+ms.assetid: b092532e-7346-469f-b9a1-897f9bea4fb7
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : タブ ページにコントロールを追加する
+Windows フォーム <xref:System.Windows.Forms.TabControl> を使用すると、他のコントロールを整理して表示できます。  次の手順は、最初のタブにボタンを追加する方法を示しています。  タブ ページのラベル部分にアイコンを追加する方法の詳細については、「[方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)」を参照してください。  
+  
+### プログラムによってコントロールを追加するには  
+  
+1.  <xref:System.Windows.Forms.TabPage> の <xref:System.Windows.Forms.Control.Controls%2A> プロパティから返されたコレクションの <xref:System.Windows.Forms.Control.ControlCollection.Add%2A> メソッドを使用します。  
+  
+     [!code-cpp[TabPageControlCollectionHowToAdd#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/tabpagecontrolcollectionhowtoadd/cpp/add.cpp#1)]
+     [!code-csharp[TabPageControlCollectionHowToAdd#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/tabpagecontrolcollectionhowtoadd/cs/add.cs#1)]
+     [!code-vb[TabPageControlCollectionHowToAdd#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/tabpagecontrolcollectionhowtoadd/vb/add.vb#1)]  
+  
+## 参照  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)   
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-a-control-to-a-toolstripcontentpanel.md b/docs/framework/winforms/controls/how-to-add-a-control-to-a-toolstripcontentpanel.md
new file mode 100644
index 00000000000..824153faa66
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-a-control-to-a-toolstripcontentpanel.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ToolStripContentPanel にコントロールを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolStripContentPanel [Windows フォーム], 追加 (コントロールを)"
+ms.assetid: fa410960-bf1a-42fc-80e8-f2e27fb3dbb8
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ToolStripContentPanel にコントロールを追加する
+<xref:System.Windows.Forms.ToolStripContentPanel> に対して、1 つまたは複数のコントロールをプログラムで追加できます。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.RichTextBox> を <xref:System.Windows.Forms.ToolStripContentPanel> に追加する方法を示しています。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStripContainer#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripContainer/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStripContainer#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripContainer/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ このコード例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」または「[\[ToolStripContainer タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233647\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripContentPanel>   
+ <xref:System.Windows.Forms.ToolStripContainer>   
+ [ToolStripContainer コントロール](../../../../docs/framework/winforms/controls/toolstripcontainer-control.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-a-custom-place-to-a-file-dialog-box.md b/docs/framework/winforms/controls/how-to-add-a-custom-place-to-a-file-dialog-box.md
new file mode 100644
index 00000000000..ffef548db66
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-a-custom-place-to-a-file-dialog-box.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : よく使用する場所をファイル ダイアログ ボックスに追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "よく使用する場所をダイアログ ボックスに"
+  - "追加 (よく使用する場所をダイアログ ボックスに)"
+  - "CustomPlaces コレクション"
+ms.assetid: 63f6469b-59cd-40f6-9e61-8b5831856780
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : よく使用する場所をファイル ダイアログ ボックスに追加する
+既定値が開き、保存 ダイアログ ボックス[!INCLUDE[wiprlhext](../../../../includes/wiprlhext-md.md)] ダイアログ ボックスの左側にある領域がある**お気に入りリンク**します。 この領域には、カスタムの場所は呼び出されます。 <xref:System.Windows.Forms.OpenFileDialog>と<xref:System.Windows.Forms.SaveFileDialog>クラスを使用すると、フォルダーを追加、 <xref:System.Windows.Forms.FileDialog.CustomPlaces%2A>コレクションです。  
+  
+> [!NOTE]
+>  カスタムの場所に表示するために、 <xref:System.Windows.Forms.OpenFileDialog>または<xref:System.Windows.Forms.SaveFileDialog>、 <xref:System.Windows.Forms.FileDialog.AutoUpgradeEnabled%2A>にプロパティを設定する必要があります`true`(既定値)。  
+  
+### <a name="to-add-a-custom-place-to-a-file-dialog-box"></a>ファイル ダイアログ ボックスに、よく使用する場所を追加するには  
+  
+-   既知のフォルダー GUID を使用して、パスを追加または<xref:System.Windows.Forms.FileDialogCustomPlace>オブジェクトを<xref:System.Windows.Forms.FileDialog.CustomPlaces%2A>  ダイアログ ボックスのコレクション。  
+  
+     次のコード例では、パスを追加する方法を示します。  
+  
+    ```vb  
+    OpenFileDialog1.CustomPlaces.Add("C:\MyCustomPlace")  
+    ```  
+  
+    ```csharp  
+    openFileDialog1.CustomPlaces.Add("C:\\MyCustomPlace");  
+    ```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Forms.FileDialog>   
+ <xref:System.Windows.Forms.FileDialogCustomPlacesCollection.Add%2A?displayProperty=fullName>   
+ [ファイル ダイアログ ボックスのカスタム プレイス用既知のフォルダー Guid](../../../../docs/framework/winforms/controls/known-folder-guids-for-file-dialog-custom-places.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-a-toolstripcontainer-to-a-form.md b/docs/framework/winforms/controls/how-to-add-a-toolstripcontainer-to-a-form.md
new file mode 100644
index 00000000000..ec88edfb37e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-a-toolstripcontainer-to-a-form.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : フォームに ToolStripContainer を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], ビルトイン ラフティング"
+  - "ToolStrip コントロール [Windows フォーム], ビルトイン ラフティング"
+  - "ToolStripContainer コントロール [Windows フォーム], 追加 (Windows フォームに)"
+ms.assetid: d0f55095-a833-453e-be5a-644906d75d54
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : フォームに ToolStripContainer を追加する
+プログラムで Windows フォームに <xref:System.Windows.Forms.ToolStripContainer> を追加し、そこにコントロールを配置できます。  
+  
+## 使用例  
+ 次のコード例は、Windows フォームに <xref:System.Windows.Forms.ToolStripContainer> および <xref:System.Windows.Forms.ToolStrip> を追加する方法、<xref:System.Windows.Forms.ToolStrip> に項目を追加する方法、<xref:System.Windows.Forms.ToolStripContainer> の <xref:System.Windows.Forms.ToolStripContainer.TopToolStripPanel%2A> に <xref:System.Windows.Forms.ToolStrip> を追加する方法を示しています。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStripContainer2#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/system.windows.forms.toolstripcontainer2/cs/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStripContainer2#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/system.windows.forms.toolstripcontainer2/vb/form1.vb#1)]  
+  
+## コードのコンパイル  
+ このコード例で必要な要素は次のとおりです。  
+  
+-   System.Drawing、System.Text、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」または「[\[ToolStripContainer タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233647\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripContainer>   
+ [ToolStripContainer コントロール](../../../../docs/framework/winforms/controls/toolstripcontainer-control.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md b/docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md
new file mode 100644
index 00000000000..bb18cd72177
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : Windows フォームに ActiveX コントロールを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ActiveX コントロール [Windows フォーム], 追加"
+  - "フォーム, 追加 (ActiveX コントロールを)"
+  - "Windows フォーム コントロール, ActiveX コントロール"
+ms.assetid: 54a61e5b-555e-4887-b41e-6244fed271eb
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームに ActiveX コントロールを追加する
+Windows フォーム デザイナーは、Windows フォーム コントロールをホストするために最適化されていますが、代わりに Windows フォームに ActiveX コントロールを配置することもできます。  
+  
+> [!CAUTION]
+>  ActiveX コントロールを Windows フォームに追加した場合は、Windows フォームのパフォーマンスが制限されます。  
+  
+ フォームに ActiveX コントロールを追加する前に、ツールボックスに ActiveX コントロールを追加する必要があります。  詳細については、「[&#91;COM コンポーネント&#93; \(&#91;ツールボックスのカスタマイズ&#93; ダイアログ ボックス\)](http://msdn.microsoft.com/ja-jp/171333f3-f207-4e02-bbdc-17862556212c)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### Windows フォームに ActiveX コントロールを追加するには  
+  
+-   ツールボックスでコントロールをダブルクリックします。  
+  
+     [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] によって、プロジェクトのコントロールにすべての参照が追加されます。  Windows フォーム上で ActiveX コントロールを使用する場合の注意事項の詳細については、「[Windows フォームで ActiveX コントロールをホストする場合の考慮事項](../../../../docs/framework/winforms/controls/considerations-when-hosting-an-activex-control-on-a-windows-form.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  Windows フォーム ActiveX コントロール インポーター \(AxImp.exe\) は、ActiveX ダイナミック リンク ライブラリのインポート時に、変則的な型のイベント引数を作成します。  AxImp.exe によって作成される引数は、`Invoke(object sender, DWebBrowserEvents2_ProgressChangeEventArgs e)` ではなく、実際には `Invoke(object sender, DWebBrowserEvents2_ProgressChangeEvent e)` のようになります。  この変則性によって、コードの正常な機能が妨げられないように注意してください。  詳細については、「[Windows フォーム ActiveX コントロール インポーター \(Aximp.exe\)](../../../../docs/framework/tools/aximp-exe-windows-forms-activex-control-importer.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Controls and Programmable Objects Compared in Various Languages and Libraries](http://msdn.microsoft.com/ja-jp/021f2a1b-8247-4348-a5ad-e1d9ab23004b)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md
new file mode 100644
index 00000000000..ac01b969a4b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォーム ListView コントロールで項目を追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ビュー, 追加 (リスト項目を)"
+  - "ListView コントロール [Windows フォーム], 追加 (リスト項目を)"
+  - "ListView コントロール [Windows フォーム], データの読み込み"
+ms.assetid: 1b35a80a-edd8-495f-a807-a28c4aae52c6
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム ListView コントロールで項目を追加および削除する
+Windows フォームの <xref:System.Windows.Forms.ListView> コントロールに項目を追加するには、項目を指定し、その項目にプロパティを割り当てます。  リスト項目の追加または削除は、いつでも実行できます。  
+  
+### プログラムによって項目を追加するには  
+  
+1.  <xref:System.Windows.Forms.ListView.Items%2A> プロパティの <xref:System.Windows.Forms.ListView.ListViewItemCollection.Add%2A> メソッドを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#11)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#11)]  
+  
+### プログラムによって項目を削除するには  
+  
+1.  <xref:System.Windows.Forms.ListView.Items%2A> プロパティの <xref:System.Windows.Forms.ListView.ListViewItemCollection.RemoveAt%2A> メソッドまたは <xref:System.Windows.Forms.ListView.ListViewItemCollection.Clear%2A> メソッドを使用します。  <xref:System.Windows.Forms.ListView.ListViewItemCollection.RemoveAt%2A> メソッドは 1 つの項目を削除します。<xref:System.Windows.Forms.ListView.ListViewItemCollection.Clear%2A> メソッドはリストのすべての項目を削除します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#12)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#12)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md b/docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md
new file mode 100644
index 00000000000..7091ac7febe
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md
@@ -0,0 +1,88 @@
+---
+title: "方法 : Windows フォーム TreeView コントロールでノードを追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "ツリー ノード (TreeView コントロールの)"
+  - "TreeView コントロール [Windows フォーム], 追加 (ノードの)"
+  - "TreeView コントロール [Windows フォーム], 削除 (ノードを)"
+ms.assetid: de1b82db-4905-449a-9f59-af271a6b6673
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム TreeView コントロールでノードを追加および削除する
+Windows フォーム コントロール <xref:System.Windows.Forms.TreeView> は、最上位のノードを <xref:System.Windows.Forms.TreeView.Nodes%2A> コレクションに保存します。  各 <xref:System.Windows.Forms.TreeNode> にも子ノードを保存するための独自の <xref:System.Windows.Forms.TreeNode.Nodes%2A> コレクションがあります。  両方のコレクションのプロパティが <xref:System.Windows.Forms.TreeNodeCollection> 型であり、ノード階層の単一のレベルでノードを追加、削除、および再配置するために使用できる標準のコレクション メンバーが用意されています。  
+  
+### プログラムによってノードを追加するには  
+  
+1.  ツリー ビューの <xref:System.Windows.Forms.TreeView.Nodes%2A> プロパティの <xref:System.Windows.Forms.TreeNodeCollection.Add%2A> メソッドを使用します。  
+  
+    ```vb  
+    ' Adds new node as a child node of the currently selected node.  
+    Dim newNode As TreeNode = New TreeNode("Text for new node")  
+    TreeView1.SelectedNode.Nodes.Add(newNode)  
+  
+    ```  
+  
+    ```csharp  
+    // Adds new node as a child node of the currently selected node.  
+    TreeNode newNode = new TreeNode("Text for new node");  
+    treeView1.SelectedNode.Nodes.Add(newNode);  
+  
+    ```  
+  
+    ```cpp  
+    // Adds new node as a child node of the currently selected node.  
+    TreeNode ^ newNode = new TreeNode("Text for new node");  
+    treeView1->SelectedNode->Nodes->Add(newNode);  
+    ```  
+  
+### プログラムによってノードを削除するには  
+  
+1.  ツリー ビューの <xref:System.Windows.Forms.TreeView.Nodes%2A> プロパティの <xref:System.Windows.Forms.TreeNodeCollection.Remove%2A> メソッドを使用して 1 つのノードを削除するか、または <xref:System.Windows.Forms.TreeNodeCollection.Clear%2A> メソッドを使用してすべてのノードを削除します。  
+  
+    ```vb  
+    ' Removes currently selected node, or root if nothing is selected.  
+    TreeView1.Nodes.Remove(TreeView1.SelectedNode)  
+    ' Clears all nodes.  
+    TreeView1.Nodes.Clear()  
+  
+    ```  
+  
+    ```csharp  
+    // Removes currently selected node, or root if nothing   
+    // is selected.  
+    treeView1.Nodes.Remove(treeView1.SelectedNode);  
+    // Clears all nodes.  
+    TreeView1.Nodes.Clear();  
+  
+    ```  
+  
+    ```cpp  
+    // Removes currently selected node, or root if nothing  
+    // is selected.  
+    treeView1->Nodes->Remove(treeView1->SelectedNode);  
+    // Clears all nodes.  
+    treeView1->Nodes->Clear();  
+    ```  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [TreeView コントロールの概要](../../../../docs/framework/winforms/controls/treeview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TreeView コントロールのアイコンを設定する](../../../../docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](../../../../docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md)   
+ [方法 : クリックされた TreeView ノードを判別する](../../../../docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md b/docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md
new file mode 100644
index 00000000000..acc5e3e43e0
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : Windows フォーム TabControl のタブを追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ ページ"
+  - "TabControl コントロール [Windows フォーム], 追加と削除 (タブを)"
+  - "TabPage コントロール"
+  - "タブ, 追加 (ページに)"
+  - "タブ, 削除 (ページから)"
+ms.assetid: 66d4dfca-41e8-44e3-9c80-fb7ac4cb1619
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム TabControl のタブを追加および削除する
+既定では、<xref:System.Windows.Forms.TabControl> コントロールには 2 つの <xref:System.Windows.Forms.TabPage> コントロールが含まれています。  これらのタブには <xref:System.Windows.Forms.TabControl.TabPages%2A> プロパティを通じてアクセスできます。  
+  
+### プログラムによってタブを追加するには  
+  
+-   <xref:System.Windows.Forms.TabControl.TabPages%2A> プロパティの <xref:System.Windows.Forms.TabControl.TabPageCollection.Add%2A> メソッドを使用します。  
+  
+    ```vb  
+    Dim myTabPage As New TabPage()  
+    myTabPage.Text = "TabPage" & (TabControl1.TabPages.Count + 1)  
+    TabControl1.TabPages.Add(myTabPage)  
+  
+    ```  
+  
+    ```csharp  
+    string title = "TabPage " + (tabControl1.TabCount + 1).ToString();  
+    TabPage myTabPage = new TabPage(title);  
+    tabControl1.TabPages.Add(myTabPage);  
+  
+    ```  
+  
+    ```cpp  
+    String^ title = String::Concat("TabPage ",  
+       (tabControl1->TabCount + 1).ToString());  
+    TabPage^ myTabPage = gcnew TabPage(title);  
+    tabControl1->TabPages->Add(myTabPage);  
+    ```  
+  
+### プログラムによってタブを削除するには  
+  
+-   選択したタブを削除するには、<xref:System.Windows.Forms.TabControl.TabPages%2A> プロパティの <xref:System.Windows.Forms.TabControl.TabPageCollection.Remove%2A> メソッドを使用します。  
+  
+     または  
+  
+-   すべてのタブを削除するには、<xref:System.Windows.Forms.TabControl.TabPages%2A> プロパティの <xref:System.Windows.Forms.TabControl.TabPageCollection.Clear%2A> メソッドを使用します。  
+  
+    ```vb  
+    ' Removes the selected tab:  
+    TabControl1.TabPages.Remove(TabControl1.SelectedTab)  
+    ' Removes all the tabs:  
+    TabControl1.TabPages.Clear()  
+  
+    ```  
+  
+    ```csharp  
+    // Removes the selected tab:  
+    tabControl1.TabPages.Remove(tabControl1.SelectedTab);  
+    // Removes all the tabs:  
+    tabControl1.TabPages.Clear();  
+  
+    ```  
+  
+    ```cpp  
+    // Removes the selected tab:  
+    tabControl1->TabPages->Remove(tabControl1->SelectedTab);  
+    // Removes all the tabs:  
+    tabControl1->TabPages->Clear();  
+    ```  
+  
+## 参照  
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control-using-the-designer.md
new file mode 100644
index 00000000000..7f4ee77563a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control-using-the-designer.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : デザイナーを使って ToolBar コントロールにボタンを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ボタンを)"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ドロップダウン メニューを)"
+  - "ToolBar コントロール [Windows フォーム], 追加 (区切り記号を)"
+  - "ツール バー [Windows フォーム], 追加 (ボタンを)"
+ms.assetid: d9ce3040-3e21-4e2d-80ae-b430982b2db8
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイナーを使って ToolBar コントロールにボタンを追加する
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ <xref:System.Windows.Forms.ToolBar> コントロールの重要な要素は、このコントロールに追加するボタンです。  追加するボタンは、メニュー コマンドへ手軽にアクセスするために使用できます。また、アプリケーションのユーザー インターフェイスの別の部分にボタンを配置することにより、メニュー構造では利用できないコマンドをユーザーに提供することもできます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ToolBar> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にボタンを追加するには  
+  
+1.  <xref:System.Windows.Forms.ToolBar> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.ToolBar.Buttons%2A> プロパティをクリックして選択し、**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックして **ToolBarButton コレクション エディター**を表示します。  
+  
+3.  <xref:System.Windows.Forms.ToolBar> コントロールにボタンを追加するには **\[追加\]** をクリックし、削除するには **\[削除\]** をクリックします。  
+  
+4.  エディターの右側のペインに表示される **\[プロパティ\]** ウィンドウで、各ボタンのプロパティを設定します。  考慮する必要がある重要なプロパティを次の表に示します。  
+  
+    |プロパティ|Description|  
+    |-----------|-----------------|  
+    |<xref:System.Windows.Forms.ToolBarButton.DropDownMenu%2A>|ドロップダウン ツール バー ボタンに表示されるメニューを設定します。  ツール バー ボタンの <xref:System.Windows.Forms.ToolBarButton.Style%2A> プロパティが <xref:System.Windows.Forms.ToolBarButtonStyle> に設定されている必要があります。  このプロパティは、<xref:System.Windows.Forms.ContextMenu> クラスのインスタンスを参照として受け取ります。|  
+    |<xref:System.Windows.Forms.ToolBarButton.PartialPush%2A>|切り替え形式のツール バー ボタンを部分的に押されている状態にするかどうかを設定します。  ツール バー ボタンの <xref:System.Windows.Forms.ToolBarButton.Style%2A> プロパティが <xref:System.Windows.Forms.ToolBarButtonStyle> に設定されている必要があります。|  
+    |<xref:System.Windows.Forms.ToolBarButton.Pushed%2A>|切り替え形式のツール バー ボタンを押されている状態にするかどうかを設定します。  ツール バー ボタンの <xref:System.Windows.Forms.ToolBarButton.Style%2A> プロパティが <xref:System.Windows.Forms.ToolBarButtonStyle> または <xref:System.Windows.Forms.ToolBarButtonStyle> に設定されている必要があります。|  
+    |<xref:System.Windows.Forms.ToolBarButton.Style%2A>|ツール バー ボタンのスタイルを設定します   <xref:System.Windows.Forms.ToolBarButtonStyle> 列挙値のいずれかの値にする必要があります。|  
+    |<xref:System.Windows.Forms.ToolBarButton.Text%2A>|ボタンによって表示される文字列です。|  
+    |<xref:System.Windows.Forms.ToolBarButton.ToolTipText%2A>|ボタンのツールヒントとして表示されるテキストです。|  
+  
+5.  **\[OK\]** をクリックしてダイアログ ボックスを閉じ、指定したパネルを作成します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [方法 : ツール バー ボタンのアイコンを定義する](../../../../docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md)   
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)   
+ [ToolBar コントロールの概要](../../../../docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md)   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md b/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md
new file mode 100644
index 00000000000..88bb6f91d24
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md
@@ -0,0 +1,163 @@
+---
+title: "方法 : ツール バー コントロールにボタンを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ボタンを)"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ドロップダウン メニューを)"
+  - "ToolBar コントロール [Windows フォーム], 追加 (区切り記号を)"
+  - "ツール バー [Windows フォーム], 追加 (ボタンを)"
+ms.assetid: 78a58a8d-1041-4e38-9219-4096fa6a5c5c
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ツール バー コントロールにボタンを追加する
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ <xref:System.Windows.Forms.ToolBar> コントロールの重要な要素は、このコントロールに追加するボタンです。  追加するボタンは、メニュー コマンドへ手軽にアクセスするために使用できます。また、アプリケーションのユーザー インターフェイスの別の部分にボタンを配置することにより、メニュー構造では利用できないコマンドをユーザーに提供することもできます。  
+  
+ 次の例では、Windows フォーム \(`Form1`\) に <xref:System.Windows.Forms.ToolBar> コントロールが追加されていると仮定しています。  
+  
+### プログラム実行時にボタンを追加するには  
+  
+1.  プロシージャで、<xref:System.Windows.Forms.ToolBar.Buttons%2A?displayProperty=fullName> コレクションにツール バー ボタンを追加することで作成します。  
+  
+2.  <xref:System.Windows.Forms.ToolBar.Buttons%2A> プロパティを通じてボタンのインデックスを渡すことにより、各ボタンごとにプロパティの設定値を指定します。  
+  
+     次の例は、既に <xref:System.Windows.Forms.ToolBar> コントロールが追加されたフォームを想定しています。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.ToolBar.Buttons%2A?displayProperty=fullName> コレクションは、インデックス番号が 0 から始まるコレクションです。コードはそれに合わせて処理する必要があります。  
+  
+    ```vb  
+    Public Sub CreateToolBarButtons()  
+    ' Create buttons and set text property.  
+       ToolBar1.Buttons.Add("One")  
+       ToolBar1.Buttons.Add("Two")  
+       ToolBar1.Buttons.Add("Three")  
+       ToolBar1.Buttons.Add("Four")  
+    ' Set properties of StatusBar panels.  
+    ' Set Style property.  
+       ToolBar1.Buttons(0).Style = ToolBarButtonStyle.PushButton  
+       ToolBar1.Buttons(1).Style = ToolBarButtonStyle.Separator  
+       ToolBar1.Buttons(2).Style = ToolBarButtonStyle.ToggleButton  
+       ToolBar1.Buttons(3).Style = ToolBarButtonStyle.DropDownButton  
+    ' Set the ToggleButton's PartialPush property.  
+       ToolBar1.Buttons(2).PartialPush = True  
+    ' Instantiate a ContextMenu component and menu items.  
+    ' Set the DropDownButton's DropDownMenu property to the context menu.  
+       Dim cm As New ContextMenu()  
+       Dim miOne As New MenuItem("One")  
+       Dim miTwo As New MenuItem("Two")  
+       Dim miThree As New MenuItem("Three")  
+       cm.MenuItems.Add(miOne)  
+       cm.MenuItems.Add(miTwo)  
+       cm.MenuItems.Add(miThree)  
+       ToolBar1.Buttons(3).DropDownMenu = cm  
+    ' Set the PushButton's Pushed property.  
+       ToolBar1.Buttons(0).Pushed = True  
+    ' Set the ToolTipText property of one of the buttons.  
+       ToolBar1.Buttons(1).ToolTipText = "Button 2"  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void CreateToolBarButtons()  
+    {  
+       // Create buttons and set text property.  
+       toolBar1.Buttons.Add("One");  
+       toolBar1.Buttons.Add("Two");  
+       toolBar1.Buttons.Add("Three");  
+       toolBar1.Buttons.Add("Four");  
+  
+       // Set properties of StatusBar panels.  
+       // Set Style property.  
+       toolBar1.Buttons[0].Style = ToolBarButtonStyle.PushButton;  
+       toolBar1.Buttons[1].Style = ToolBarButtonStyle.Separator;  
+       toolBar1.Buttons[2].Style = ToolBarButtonStyle.ToggleButton;  
+       toolBar1.Buttons[3].Style = ToolBarButtonStyle.DropDownButton;  
+  
+       // Set the ToggleButton's PartialPush property.  
+       toolBar1.Buttons[2].PartialPush = true;  
+  
+       // Instantiate a ContextMenu component and menu items.  
+       // Set the DropDownButton's DropDownMenu property to   
+       // the context menu.  
+       ContextMenu cm = new ContextMenu();  
+       MenuItem miOne = new MenuItem("One");  
+       MenuItem miTwo = new MenuItem("Two");  
+       MenuItem miThree = new MenuItem("Three");  
+       cm.MenuItems.Add(miOne);  
+       cm.MenuItems.Add(miTwo);  
+       cm.MenuItems.Add(miThree);  
+  
+       toolBar1.Buttons[3].DropDownMenu = cm;  
+       // Set the PushButton's Pushed property.  
+       toolBar1.Buttons[0].Pushed = true;  
+       // Set the ToolTipText property of 1 of the buttons.  
+       toolBar1.Buttons[1].ToolTipText = "Button 2";  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void CreateToolBarButtons()  
+       {  
+          // Create buttons and set text property.  
+          toolBar1->Buttons->Add( "One" );  
+          toolBar1->Buttons->Add( "Two" );  
+          toolBar1->Buttons->Add( "Three" );  
+          toolBar1->Buttons->Add( "Four" );  
+  
+          // Set properties of StatusBar panels.  
+          // Set Style property.  
+          toolBar1->Buttons[0]->Style = ToolBarButtonStyle::PushButton;  
+          toolBar1->Buttons[1]->Style = ToolBarButtonStyle::Separator;  
+          toolBar1->Buttons[2]->Style = ToolBarButtonStyle::ToggleButton;  
+          toolBar1->Buttons[3]->Style = ToolBarButtonStyle::DropDownButton;  
+  
+          // Set the ToggleButton's PartialPush property.  
+          toolBar1->Buttons[2]->PartialPush = true;  
+  
+          // Instantiate a ContextMenu component and menu items.  
+          // Set the DropDownButton's DropDownMenu property to   
+          // the context menu.  
+          System::Windows::Forms::ContextMenu^ cm = gcnew System::Windows::Forms::ContextMenu;  
+          MenuItem^ miOne = gcnew MenuItem( "One" );  
+          MenuItem^ miTwo = gcnew MenuItem( "Two" );  
+          MenuItem^ miThree = gcnew MenuItem( "Three" );  
+          cm->MenuItems->Add( miOne );  
+          cm->MenuItems->Add( miTwo );  
+          cm->MenuItems->Add( miThree );  
+          toolBar1->Buttons[3]->DropDownMenu = cm;  
+  
+          // Set the PushButton's Pushed property.  
+          toolBar1->Buttons[0]->Pushed = true;  
+  
+          // Set the ToolTipText property of 1 of the buttons.  
+          toolBar1->Buttons[1]->ToolTipText = "Button 2";  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [方法 : ツール バー ボタンのアイコンを定義する](../../../../docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md)   
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)   
+ [ToolBar コントロールの概要](../../../../docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md)   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control-using-the-designer.md
new file mode 100644
index 00000000000..f19cfe4f3da
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control-using-the-designer.md
@@ -0,0 +1,47 @@
+---
+title: "方法 :デザイナーを使って Windows フォーム ListView コントロールに列を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 追加 (ListView コントロールに)"
+  - "ListView コントロール [Windows フォーム], 追加 (列ヘッダーを)"
+ms.assetid: 5b1a8b4d-587e-479a-95c1-f9b90884f13a
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 :デザイナーを使って Windows フォーム ListView コントロールに列を追加する
+Windows フォームの <xref:System.Windows.Forms.ListView> コントロールでは、**詳細**ビューの場合、各リスト項目に対して複数の列を表示できます。  複数の列を使用することにより、リストの各項目に関して何種類かの情報を表示できます。  たとえば、ファイル リストに、ファイル名、ファイルの種類、サイズ、およびファイルの最終更新日を表示できます。  作成後に列に情報を設定する方法の詳細については、「[方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ListView> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーで列を追加するには  
+  
+1.  **\[プロパティ\]** ウィンドウで、コントロールの <xref:System.Windows.Forms.ListView.View%2A> プロパティを <xref:System.Windows.Forms.View> に設定します。  
+  
+2.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.ListView.Columns%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+     **ColumnHeader コレクション エディター**が表示されます。  
+  
+3.  新しい列を追加するには、**\[追加\]** をクリックします。  次に、列ヘッダーを選択し、列ヘッダーのテキスト \(列のキャプション\)、テキストの配置、および幅を設定します。  
+  
+## 参照  
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md
new file mode 100644
index 00000000000..7399e29b320
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : Windows フォーム ListView コントロールに列を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 追加 (ListView コントロールに)"
+  - "リスト ビュー, 追加 (列を)"
+  - "ListView コントロール [Windows フォーム], 追加 (列ヘッダーを)"
+ms.assetid: 79174274-12ee-4a5d-80db-6ec02976d010
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム ListView コントロールに列を追加する
+詳細ビューの <xref:System.Windows.Forms.ListView> コントロールでは、各リスト項目に対して複数の列を表示できます。  複数の列を使用することにより、リストの各項目に関して何種類かの情報を表示できます。  たとえば、ファイル リストに、ファイル名、ファイルの種類、サイズ、およびファイルの最終更新日を表示できます。  作成後に列に情報を設定する方法の詳細については、「[方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)」を参照してください。  
+  
+### プログラムによって列を追加するには  
+  
+1.  コントロールの <xref:System.Windows.Forms.ListView.View%2A> プロパティを <xref:System.Windows.Forms.View> に設定します。  
+  
+2.  リスト ビューの <xref:System.Windows.Forms.ListView.Columns%2A> プロパティの <xref:System.Windows.Forms.ListView.ColumnHeaderCollection.Add%2A> メソッドを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#31](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#31)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#31](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#31)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md b/docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md
new file mode 100644
index 00000000000..9ec9174fbb7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : Windows フォームにコントロールを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 追加"
+  - "Windows フォーム コントロール, 追加 (フォームに)"
+ms.assetid: 2af86001-9d62-4154-87fb-66db2c3cd9fd
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームにコントロールを追加する
+ほとんどのフォームは、フォームにコントロールを追加してユーザー インターフェイス \(UI\) を定義することによってデザインします。  *コントロール*は、情報の表示やユーザー入力の受け入れに使用する、フォーム上のコンポーネントです。  コントロールの詳細については、「[Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### フォームにコントロールを描画するには  
+  
+1.  フォームを開きます。  詳細については、「[How to: Display Windows Forms in the Designer](http://msdn.microsoft.com/ja-jp/bf3f1e5b-ea07-4529-85c6-6af3ded0cec5)」を参照してください。  
+  
+2.  **ツールボックス**で、フォームに追加するコントロールをクリックします。  
+  
+3.  フォーム内で、コントロールの左上隅となる位置をクリックし、コントロールの右下隅となる位置までドラッグします。  
+  
+     指定したフォームの位置に、指定したサイズのコントロールが追加されます。  
+  
+    > [!NOTE]
+    >  各コントロールには、既定のサイズが定義されています。  **ツールボックス**からフォームにコントロールをドラッグすると、既定のサイズのフォームを追加できます。  
+  
+### フォームにコントロールをドラッグするには  
+  
+1.  フォームを開きます。  詳細については、「[How to: Display Windows Forms in the Designer](http://msdn.microsoft.com/ja-jp/bf3f1e5b-ea07-4529-85c6-6af3ded0cec5)」を参照してください。  
+  
+2.  **ツールボックス**で、必要なコントロールをクリックし、フォームにドラッグします。  
+  
+     指定したフォームの位置に、既定のサイズのコントロールが追加されます。  
+  
+    > [!NOTE]
+    >  **ツールボックス**でコントロールをダブルクリックすると、フォームの左上隅に既定のサイズのコントロールを追加できます。  
+  
+     実行時に、フォームにコントロールを動的に追加することもできます。  次のコード例では、<xref:System.Windows.Forms.Button> コントロールをクリックしたときに、フォームに <xref:System.Windows.Forms.TextBox> コントロールが追加されるように設定します。  
+  
+    > [!NOTE]
+    >  次のプロシージャでは、**\[Button\]** コントロールである `Button1` が既に配置されているフォームが必要です。  
+  
+### プログラムによって、フォームにコントロールを追加するには  
+  
+1.  フォームのクラスでボタンの `Click` イベントを処理するメソッドに、次のようなコードを挿入して、制御変数への参照を追加します。コントロールの `Location` を設定し、コントロールを追加します。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+       Dim MyText As New TextBox()  
+       MyText.Location = New Point(25, 25)  
+       Me.Controls.Add(MyText)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)   
+    {  
+       TextBox myText = new TextBox();  
+       myText.Location = new Point(25,25);  
+       this.Controls.Add (myText);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+      System::Void button1_Click(System::Object ^  sender,  
+        System::EventArgs ^  e)  
+      {  
+        TextBox ^ myText = gcnew TextBox();  
+        myText->Location = Point(25,25);  
+        this->Controls->Add(myText);  
+      }  
+    ```  
+  
+    > [!NOTE]
+    >  コントロールの他のプロパティを初期化するコードを追加することもできます。  
+  
+    > [!IMPORTANT]
+    >  悪意のある `UserControl` を参照することにより、ローカル コンピューターがネットワークを通じてセキュリティ上のリスクを負う可能性があります。  このことが問題になるのは、悪意のあるユーザーが有害なカスタム コントロールを作成していて、開発者が自分のプロジェクトに誤ってそれを追加してしまった場合です。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [方法 : Windows フォーム上のコントロールのサイズを変更する](../../../../docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-controls-without-a-user-interface-to-windows-forms.md b/docs/framework/winforms/controls/how-to-add-controls-without-a-user-interface-to-windows-forms.md
new file mode 100644
index 00000000000..ae729d24748
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-controls-without-a-user-interface-to-windows-forms.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "NonVisualSelection"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 非可視の"
+  - "非表示のコントロール"
+  - "非可視のコントロール"
+  - "Windows フォーム コントロール, 追加 (フォームに)"
+  - "Windows フォーム コントロール, 非可視の"
+ms.assetid: 52134d9c-cff6-4eed-8e2b-3d5eb3bd494e
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する
+表示できる形式を持たないコントロール \(コンポーネント\) を使用すると、アプリケーションに機能を追加できます。  ほかのコントロールと異なり、コンポーネントにはユーザー インターフェイスが用意されていません。このため、Windows フォーム デザイナーの領域にコンポーネントを表示する必要はありません。  Windows フォーム デザイナーでは、フォームにコンポーネントを追加すると、すべてのコンポーネントが表示されるフォームの下部に、サイズの変更できるトレイが表示されます。  コンポーネント トレイにコントロールを追加すると、フォームのほかのコントロールの場合と同様に、コンポーネントを選択し、プロパティを設定できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### Windows フォームにコンポーネントを追加するには  
+  
+1.  フォームを開きます。  詳細については、「[How to: Display Windows Forms in the Designer](http://msdn.microsoft.com/ja-jp/bf3f1e5b-ea07-4529-85c6-6af3ded0cec5)」を参照してください。  
+  
+2.  **ツールボックス**で、コンポーネントをクリックし、フォームにドラッグします。  
+  
+     コンポーネント トレイにコンポーネントが表示されます。  
+  
+ または、実行時にフォームにコンポーネントを追加することもできます。  ユーザー インターフェイスを持つコントロールと異なり、表示できる形式を持たないコンポーネントでは、通常、このように処理します。  次の例では、<xref:System.Windows.Forms.Timer> コンポーネントが実行時に追加されます。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] には複数の種類のタイマーが用意されています。この場合は、Windows フォームの <xref:System.Windows.Forms.Timer> コンポーネントを使用します。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] の各種タイマーの詳細については、「[Introduction to Server\-Based Timers](http://msdn.microsoft.com/ja-jp/adc0bc0a-a519-4812-bafc-fb9d1a5801fc)」を参照してください。  
+  
+> [!CAUTION]
+>  コンポーネントには特有のプロパティが含まれることが多く、コンポーネントを効果的に機能させるにはこれらのプロパティを設定する必要があります。  <xref:System.Windows.Forms.Timer> コンポーネントの場合は、次の例に示されるように、`Interval` プロパティを設定します。  プロジェクトにコンポーネントを追加する場合は、コンポーネントに必要なプロパティを必ず設定してください。  
+  
+#### プログラムによって、Windows フォームにコンポーネントを追加するには  
+  
+1.  コードで <xref:System.Windows.Forms.Timer> クラスのインスタンスを作成します。  
+  
+2.  `Interval` プロパティを設定して、タイマー刻みの間隔を決定します。  
+  
+3.  コンポーネントに必要なその他のプロパティを設定します。  
+  
+     `Interval` プロパティを設定して <xref:System.Windows.Forms.Timer> を作成するコードを次に示します。  
+  
+    ```vb  
+    Public Sub CreateTimer()  
+       Dim timerKeepTrack As New System.Windows.Forms.Timer  
+       timerKeepTrack.Interval = 1000  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void createTimer()  
+    {  
+       System.Windows.Forms.Timer timerKeepTrack = new  
+           System.Windows.Forms.Timer();  
+       timerKeepTrack.Interval = 1000;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void createTimer()  
+       {  
+          System::Windows::Forms::Timer^ timerKeepTrack = gcnew  
+             System::Windows::Forms::Timer();  
+          timerKeepTrack->Interval = 1000;  
+       }  
+    ```  
+  
+    > [!IMPORTANT]
+    >  悪意のあるユーザー コントロールを参照することにより、ローカル コンピューターがネットワークを通じてセキュリティ上のリスクを負う可能性があります。  このことが問題になるのは、悪意のあるユーザーが有害なカスタム コントロールを作成していて、開発者が自分のプロジェクトに誤ってそれを追加してしまった場合です。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [方法 : Windows フォームに ActiveX コントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)   
+ [方法 : Windows フォーム間でコントロールをコピーする](../../../../docs/framework/winforms/controls/how-to-copy-controls-between-windows-forms.md)   
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-enhancements-to-toolstripmenuitems.md b/docs/framework/winforms/controls/how-to-add-enhancements-to-toolstripmenuitems.md
new file mode 100644
index 00000000000..4e151192a2c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-enhancements-to-toolstripmenuitems.md
@@ -0,0 +1,130 @@
+---
+title: "方法 : ToolStripMenuItems に拡張機能を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック マーク, 追加 (メニューに)"
+  - "コマンド [Windows フォーム], グループ化 (メニューの)"
+  - "イメージ [Windows フォーム], 追加 (メニューに)"
+  - "ショートカット キー, 表示 (メニューに)"
+  - "メニュー項目, 追加 (チェック マークを)"
+  - "メニュー項目, 追加 (イメージを)"
+  - "メニュー項目, 表示 (アクセス キーを)"
+  - "メニュー項目, 表示 (ショートカット キーを)"
+  - "メニュー項目, 表示 (区切り記号を)"
+  - "メニュー, グループ化 (コマンドを)"
+  - "区切り記号, 表示 (メニューに)"
+  - "ToolStripMenuItem"
+  - "ToolStripMenuItem, 追加 (チェック マークを)"
+  - "ToolStripMenuItem, 追加 (イメージを)"
+  - "ToolStripMenuItem, 表示 (アクセス キーを)"
+  - "ToolStripMenuItem, 表示 (ショートカット キーを)"
+  - "ToolStripMenuItem, 表示 (区分線を)"
+  - "ToolStripSeparator, 表示 (MenuStrips に)"
+ms.assetid: aa5f19bb-b545-4378-bfa6-36ba592f0d7c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ToolStripMenuItems に拡張機能を追加する
+<xref:System.Windows.Forms.MenuStrip> コントロールと <xref:System.Windows.Forms.ContextMenuStrip> コントロールの操作性は、次の方法で向上できます。  
+  
+-   チェック マークを追加して、機能を有効にするかどうか \(ワード プロセッサ アプリケーションの余白部分にルーラーを表示するかどうかなど\) を指定したり、現在表示されているファイルをファイル リスト \(**\[ウィンドウ\]** メニューなど\) に示したりします。  
+  
+-   メニュー コマンドを視覚的に表現するイメージを追加します。  
+  
+-   ショートカット キーを表示して、マウスの代わりにキーボードを使ってコマンドを実行できるようにします。  たとえば、Ctrl キーを押しながら C キーを押すと、**Copy** コマンドが実行されます。  
+  
+-   アクセス キーを表示して、マウスの代わりにキーボードを使ってメニューを移動できるようにします。  たとえば、Alt キーを押しながら F キーを押すと、**\[ファイル\]** メニューが選択されます。  
+  
+-   区分線を表示して、関連するコマンドをグループ化し、メニューを読みやすくします。  
+  
+### メニュー コマンドにチェック マークを表示するには  
+  
+-   <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A> プロパティを `true` に設定します。  
+  
+     これにより、<xref:System.Windows.Forms.ToolStripMenuItem.CheckState%2A> プロパティも `true` に設定されます。  この手順を使用するのは、メニュー コマンドを選択していなくても、既定でチェック マークを付けて表示する場合のみです。  
+  
+### クリックするたびに状態が切り替わるチェック マークを表示するには  
+  
+-   メニュー コマンドの <xref:System.Windows.Forms.ToolStripMenuItem.CheckOnClick%2A> プロパティを `true` に設定します。  
+  
+### メニュー コマンドにイメージを追加するには  
+  
+-   メニュー コマンドの <xref:System.Windows.Forms.ToolStripItem.Image%2A> プロパティにイメージの名前を設定します。  このメニュー コマンドの <xref:System.Windows.Forms.ToolStripItemDisplayStyle> プロパティが <xref:System.Windows.Forms.ToolStripItemDisplayStyle> または <xref:System.Windows.Forms.ToolStripItemDisplayStyle> に設定されている場合は、イメージを表示できません。  
+  
+> [!NOTE]
+>  イメージの余白には、チェック マークを表示することもできます。  また、イメージの <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A> プロパティを `true` に設定すると、実行時にイメージの周りにハッチングされた境界線が表示されます。  
+  
+### メニュー コマンドのショートカット キーを表示するには  
+  
+-   メニュー コマンドの <xref:System.Windows.Forms.ToolStripMenuItem.ShortcutKeys%2A> プロパティに適切なキーの組み合わせ \(たとえば、**\[開く**\] メニュー コマンドの場合には、Ctrl \+ O など\) を設定し、<xref:System.Windows.Forms.ToolStripMenuItem.ShowShortcutKeys%2A> プロパティを `true` に設定します。  
+  
+### メニュー コマンドのカスタム ショートカット キーを表示するには  
+  
+-   メニュー コマンドの <xref:System.Windows.Forms.ToolStripMenuItem.ShortcutKeyDisplayString%2A> プロパティに適切なキーの組み合わせ \(Shift \+ Ctrl \+ O ではなく、Ctrl \+ Shift \+ O など\) を設定し、<xref:System.Windows.Forms.ToolStripMenuItem.ShowShortcutKeys%2A> プロパティを `true` に設定します。  
+  
+### メニュー コマンドのアクセス キーを表示するには  
+  
+-   メニュー コマンドの <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティを設定するときは、アクセス キーとして下線を付ける文字の前にアンパサンド \(&\) を入力します。  たとえば、メニュー項目の <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティに「`開く(&O)`」と入力すると、メニュー コマンドには "開く\(**O**\)" と表示されます。  
+  
+     このメニュー コマンドに移動するには、Alt キーを押して <xref:System.Windows.Forms.MenuStrip> にフォーカスを移し、目的のメニューのアクセス キーを押します。  メニューが開き、アクセス キーが設定されたメニュー項目が表示されたら、アクセス キーを押すだけで目的のメニュー コマンドを選択できます。  
+  
+> [!NOTE]
+>  同じメニュー システムに Alt \+ F を 2 回定義するなど、アクセス キーを重複して定義することは避けてください。  重複するアクセス キーの選択順序は保証されません。  
+  
+### メニュー コマンドの間に区分線を表示するには  
+  
+-   <xref:System.Windows.Forms.MenuStrip> と、それに含める項目を定義した後に、<xref:System.Windows.Forms.ToolStripItemCollection.AddRange%2A> メソッドまたは <xref:System.Windows.Forms.ToolStripItemCollection.Add%2A> メソッドを使用して、メニュー コマンドと <xref:System.Windows.Forms.ToolStripSeparator> コントロールを任意の順序で <xref:System.Windows.Forms.MenuStrip> に追加します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    ' This code adds a top-level File menu to the MenuStrip.  
+    Me.menuStrip1.Items.Add(New ToolStripMenuItem() _  
+    {Me.fileToolStripMenuItem})  
+  
+    ' This code adds the New and Open menu commands, a separator bar,   
+    ' and the Save and Exit menu commands to the top-level File menu,   
+    ' in that order.  
+    Me.fileToolStripMenuItem.DropDownItems.AddRange(New _  
+    ToolStripMenuItem() {Me.newToolStripMenuItem, _  
+    Me.openToolStripMenuItem, Me.toolStripSeparator1, _  
+    Me.saveToolStripMenuItem, Me.exitToolStripMenuItem})  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    // This code adds a top-level File menu to the MenuStrip.  
+    this.menuStrip1.Items.Add(new ToolStripItem[]_  
+    {this.fileToolStripMenuItem});  
+  
+    // This code adds the New and Open menu commands, a separator bar,   
+    // and the Save and Exit menu commands to the top-level File menu,   
+    // in that order.  
+    this.fileToolStripMenuItem.DropDownItems.AddRange(new _  
+    ToolStripItem[] {  
+    this.newToolStripMenuItem,  
+    this.openToolStripMenuItem,  
+    this.toolStripSeparator1,  
+    this.saveToolStripMenuItem,  
+    this.exitToolStripMenuItem});  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-items-to-windows-forms-domainupdown-controls-programmatically.md b/docs/framework/winforms/controls/how-to-add-items-to-windows-forms-domainupdown-controls-programmatically.md
new file mode 100644
index 00000000000..0c14309c52b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-items-to-windows-forms-domainupdown-controls-programmatically.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : Windows フォーム DomainUpDown コントロールにプログラムで項目を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DomainUpDown コントロール [Windows フォーム], 追加 (アイテムを)"
+  - "スピン ボタン コントロール, 追加 (アイテムを)"
+ms.assetid: fd31d314-33eb-4181-90f8-d32ed0c4e072
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DomainUpDown コントロールにプログラムで項目を追加する
+Windows フォームの <xref:System.Windows.Forms.DomainUpDown> コントロールにコードで項目を追加できます。  <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection> クラスの <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Add%2A> メソッドまたは<xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Insert%2A> メソッドを呼び出して、コントロールの <xref:System.Windows.Forms.DomainUpDown.Items%2A> プロパティに項目を追加します。  <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Add%2A> メソッドは、コレクションの最後に項目を追加します。<xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Insert%2A> メソッドは、指定された位置に項目を追加します。  
+  
+### 新しい項目を追加するには  
+  
+1.  <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Add%2A> メソッドを使用して、項目のリストの最後に項目を追加します。  
+  
+    ```vb  
+    DomainUpDown1.Items.Add("noodles")  
+  
+    ```  
+  
+    ```csharp  
+    domainUpDown1.Items.Add("noodles");  
+  
+    ```  
+  
+    ```cpp  
+    domainUpDown1->Items->Add("noodles");  
+    ```  
+  
+     または  
+  
+2.  <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Insert%2A> メソッドを使用して、リスト内の指定した位置に項目を挿入します。  
+  
+    ```vb  
+    ' Inserts an item at the third position in the list  
+    DomainUpDown1.Items.Insert(2, "rice")  
+  
+    ```  
+  
+    ```csharp  
+    // Inserts an item at the third position in the list  
+    domainUpDown1.Items.Insert(2, "rice");  
+  
+    ```  
+  
+    ```cpp  
+    // Inserts an item at the third position in the list  
+    domainUpDown1->Items->Insert(2, "rice");  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.DomainUpDown>   
+ <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Add%2A?displayProperty=fullName>   
+ <xref:System.Collections.ArrayList.Insert%2A?displayProperty=fullName>   
+ [DomainUpDown コントロール](../../../../docs/framework/winforms/controls/domainupdown-control-windows-forms.md)   
+ [DomainUpDown コントロールの概要](../../../../docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md b/docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md
new file mode 100644
index 00000000000..c044f965bc1
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : メニュー項目を ContextMenuStrip に追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, 追加 (メニュー項目を)"
+  - "ContextMenuStrips, 追加 (メニュー項目を)"
+  - "ショートカット メニュー, 追加 (アイテムを)"
+ms.assetid: 1ec14776-3ea2-4752-bd22-4fae0fd19e1a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : メニュー項目を ContextMenuStrip に追加する
+<xref:System.Windows.Forms.ContextMenuStrip> には、単一のメニュー項目を追加できます。同時に複数のメニュー項目を追加することもできます。  
+  
+### 単一のメニュー項目を ContextMenuStrip に追加するには  
+  
+-   単一のメニュー項目を <xref:System.Windows.Forms.ContextMenuStrip> に追加するには、<xref:System.Windows.Forms.ToolStripItemCollection.Add%2A> メソッドを使用します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Me.contextMenuStrip1.Items.Add(Me.toolStripMenuItem1)  
+    ```  
+  
+    ```csharp  
+    this.contextMenuStrip1.Items.Add(toolStripMenuItem1);  
+    ```  
+  
+### 複数のメニュー項目を ContextMenuStrip に追加するには  
+  
+-   複数のメニュー項目を <xref:System.Windows.Forms.ContextMenuStrip> に追加するには、<xref:System.Windows.Forms.ToolStripItemCollection.AddRange%2A> メソッドを使用します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Me.contextMenuStrip1.Items.AddRange(New _  
+       System.Windows.Forms.ToolStripItem() {Me.toolStripMenuItem1, _  
+          Me.toolStripMenuItem2})  
+    ```  
+  
+    ```csharp  
+    this.contextMenuStrip1.Items.AddRange(new   
+       System.Windows.Forms.ToolStripItem[] {  
+          this.toolStripMenuItem1, this.toolStripMenuItem2});  
+    ```  
+  
+## 参照  
+ [ContextMenuStrip コントロール](../../../../docs/framework/winforms/controls/contextmenustrip-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-or-remove-imagelist-images-with-the-designer.md b/docs/framework/winforms/controls/how-to-add-or-remove-imagelist-images-with-the-designer.md
new file mode 100644
index 00000000000..5ebb6a0fd85
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-or-remove-imagelist-images-with-the-designer.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : デザイナーを使って ImageList イメージを追加または削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ImageList コンポーネント [Windows フォーム], 追加 (イメージを)"
+  - "ImageList コンポーネント [Windows フォーム], 削除 (イメージを)"
+  - "イメージ [Windows フォーム], 追加 (ImageList コンポーネントに)"
+ms.assetid: 5699b244-e37c-4d20-bc35-7441e55c1e3a
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : デザイナーを使って ImageList イメージを追加または削除する
+イメージを <xref:System.Windows.Forms.ImageList> コンポーネントに追加する方法はいくつかあります。  <xref:System.Windows.Forms.ImageList> に関連付けられているスマート タグを使うと、イメージをすばやく追加できます。また、他のプロパティを <xref:System.Windows.Forms.ImageList> に設定しているときは、\[プロパティ\] ウィンドウでイメージを簡単に追加できます。  コードを使ってイメージを追加することもできます。  コードを使ってイメージを追加する方法の詳細については、「[方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)」を参照してください。  通常は、<xref:System.Windows.Forms.ImageList> コンポーネントをコントロールに関連付ける前に、<xref:System.Windows.Forms.ImageList> コンポーネントにイメージを設定します。ただし、これは強制ではありません。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### \[プロパティ\] ウィンドウを使ってイメージを追加または削除するには  
+  
+1.  <xref:System.Windows.Forms.ImageList> コンポーネントを選択するか、フォームにコンポーネントを追加します。  
+  
+2.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.ImageList.Images%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+3.  **Image コレクション エディター**の **\[追加\]** または **\[削除\]** をクリックしてリストからイメージを追加または削除します。  
+  
+### スマート タグを使ってイメージを追加または削除するには  
+  
+1.  <xref:System.Windows.Forms.ImageList> コンポーネントを選択するか、フォームにコンポーネントを追加します。  
+  
+2.  スマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックします。  
+  
+3.  **\[ImageList タスク\]** ダイアログ ボックスの **\[イメージの選択\]** を選択します。  
+  
+4.  **Image コレクション エディター**の **\[追加\]** または **\[削除\]** をクリックしてリストからイメージを追加または削除します。  
+  
+## 参照  
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)   
+ [チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行](../../../../docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md)   
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md b/docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md
new file mode 100644
index 00000000000..593cf0c66c3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md
@@ -0,0 +1,160 @@
+---
+title: "方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ImageList コンポーネント [Windows フォーム], 追加 (イメージを)"
+  - "ImageList コンポーネント [Windows フォーム], 削除 (イメージを)"
+  - "イメージ [Windows フォーム], 追加 (ImageList コンポーネントに)"
+  - "イメージ [Windows フォーム], 表示 (コントロールと共に)"
+  - "イメージ [Windows フォーム], 削除 (ImageList コンポーネントから)"
+  - "イメージ [Windows フォーム], 格納 (コントロールの)"
+ms.assetid: c5eacc56-f769-4e2e-bfb7-f756620913db
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する
+Windows フォームの <xref:System.Windows.Forms.ImageList> コンポーネントは、コントロールに関連付ける前にイメージを設定するのが普通です。  ただし、イメージ リストをコントロールに関連付けた後で、イメージを追加または削除することもできます。  
+  
+> [!NOTE]
+>  イメージを削除するときには、関連付けられているコントロールの <xref:System.Windows.Forms.ButtonBase.ImageIndex%2A> プロパティがイメージの削除後も有効であることを確認してください。  
+  
+### プログラムによってイメージを追加するには  
+  
+-   イメージ リストの <xref:System.Windows.Forms.ImageList.Images%2A> プロパティの <xref:System.Windows.Forms.ImageList.ImageCollection.Add%2A> メソッドを使用します。  
+  
+     次のコード例では、イメージの場所に対するパスとして **My Documents** フォルダーが設定されています。  この場所を使用するのは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、この場所を選択すると、最小限のシステム アクセス レベルのユーザーがアプリケーションをより安全に実行できます。  次のコード例には、<xref:System.Windows.Forms.ImageList> コントロールを追加済みのフォームが必要です。  
+  
+    ```vb  
+    Public Sub LoadImage()  
+       Dim myImage As System.Drawing.Image = _  
+         Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Image.gif")  
+       ImageList1.Images.Add(myImage)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void addImage()  
+    {  
+    // Be sure that you use an appropriate escape sequence (such as the   
+    // @) when specifying the location of the file.  
+       System.Drawing.Image myImage =   
+         Image.FromFile  
+       (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Image.gif");  
+       imageList1.Images.Add(myImage);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void addImage()  
+       {  
+       // Replace the bold image in the following sample   
+       // with your own icon.  
+       // Be sure that you use an appropriate escape sequence (such as   
+       // \\) when specifying the location of the file.  
+          System::Drawing::Image ^ myImage =   
+             Image::FromFile(String::Concat(  
+             System::Environment::GetFolderPath(  
+             System::Environment::SpecialFolder::Personal),  
+             "\\Image.gif"));  
+          imageList1->Images->Add(myImage);  
+       }  
+    ```  
+  
+### キー値を指定してイメージを追加するには  
+  
+-   キー値を引数に受け取る、イメージ リストの <xref:System.Windows.Forms.ImageList.Images%2A> プロパティのいずれかの <xref:System.Windows.Forms.ImageList.ImageCollection.Add%2A> メソッドを使用します。  
+  
+     次のコード例では、イメージの場所に対するパスとして **My Documents** フォルダーが設定されています。  この場所を使用するのは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、この場所を選択すると、最小限のシステム アクセス レベルのユーザーがアプリケーションをより安全に実行できます。  次のコード例には、<xref:System.Windows.Forms.ImageList> コントロールを追加済みのフォームが必要です。  
+  
+    ```vb  
+    Public Sub LoadImage()  
+       Dim myImage As System.Drawing.Image = _  
+         Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Image.gif")  
+       ImageList1.Images.Add("myPhoto", myImage)  
+    End Sub  
+  
+    ```  
+  
+```csharp  
+public void addImage()  
+{  
+// Be sure that you use an appropriate escape sequence (such as the   
+// @) when specifying the location of the file.  
+   System.Drawing.Image myImage =   
+     Image.FromFile  
+   (System.Environment.GetFolderPath  
+   (System.Environment.SpecialFolder.Personal)  
+   + @"\Image.gif");  
+   imageList1.Images.Add("myPhoto", myImage);  
+}  
+  
+```  
+  
+### プログラムによってすべてのイメージを削除するには  
+  
+-   <xref:System.Windows.Forms.ImageList.ImageCollection.Remove%2A> メソッドを使用して単一のイメージを削除します。  
+  
+     または  
+  
+     <xref:System.Windows.Forms.ImageList.ImageCollection.Clear%2A> メソッドを使用して、イメージ リストのすべてのイメージを削除します。  
+  
+    ```vb  
+    ' Removes the first image in the image list  
+    ImageList1.Images.Remove(myImage)  
+    ' Clears all images in the image list  
+    ImageList1.Images.Clear()  
+  
+    ```  
+  
+```csharp  
+// Removes the first image in the image list.  
+imageList1.Images.Remove(myImage);  
+// Clears all images in the image list.  
+imageList1.Images.Clear();  
+  
+```  
+  
+### キーを指定してイメージを削除するには  
+  
+-   <xref:System.Windows.Forms.ImageList.ImageCollection.RemoveByKey%2A> メソッドを使用して、キーに対応する単一のイメージを削除します。  
+  
+    ```vb  
+    ' Removes the image named "myPhoto" from the list.  
+    ImageList1.Images.RemoveByKey("myPhoto")  
+  
+    ```  
+  
+```csharp  
+// Removes the image named "myPhoto" from the list.  
+imageList1.Images.RemoveByKey("myPhoto");  
+  
+```  
+  
+## 参照  
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)   
+ [ImageList コンポーネントの概要](../../../../docs/framework/winforms/controls/imagelist-component-overview-windows-forms.md)   
+ [イメージ、ビットマップ、およびメタファイル](../../../../docs/framework/winforms/advanced/images-bitmaps-and-metafiles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md b/docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md
new file mode 100644
index 00000000000..4941a94d80b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md
@@ -0,0 +1,137 @@
+---
+title: "方法 : StatusBar コントロールにパネルを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "パネル, ステータス バー"
+  - "ステータス バー, 追加 (パネルを)"
+  - "StatusBar コントロール [Windows フォーム], 追加 (パネルを)"
+ms.assetid: 835e3902-288c-4c38-9d69-0696d8695009
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : StatusBar コントロールにパネルを追加する
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.StatusStrip> コントロールと <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールは、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ [StatusBar コントロール](../../../../docs/framework/winforms/controls/statusbar-control-windows-forms.md) コントロール内のプログラミング可能な領域は、<xref:System.Windows.Forms.StatusBarPanel> クラスのインスタンスで構成されています。  これらのインスタンスの追加は、<xref:System.Windows.Forms.StatusBar.StatusBarPanelCollection> クラスへの追加により行われます。  
+  
+### ステータス バーにパネルを追加するには  
+  
+1.  プロシージャでは、ステータス バー パネルを <xref:System.Windows.Forms.StatusBar.StatusBarPanelCollection> に追加することによって作成します。  <xref:System.Windows.Forms.StatusBar.Panels%2A> プロパティから取得したインデックスを使用して、パネルごとにプロパティの設定値を指定します。  
+  
+     次のコード例では、アイコンの場所に対するパスとして **\[マイ ドキュメント\]** フォルダーが設定されています。  この場所を使用するのは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、この場所を選択すると、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例では、既に <xref:System.Windows.Forms.StatusBar> コントロールが追加されたフォームを必要とします。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.StatusBar.StatusBarPanelCollection> は、インデックス番号が 0 から始まるコレクションです。コードはそれに合わせて処理する必要があります。  
+  
+    ```vb  
+    Public Sub CreateStatusBarPanels()  
+    ' Create panels and set text property.  
+       StatusBar1.Panels.Add("One")  
+       StatusBar1.Panels.Add("Two")  
+       StatusBar1.Panels.Add("Three")  
+    ' Set properties of StatusBar panels.  
+    ' Set AutoSize property of panels.  
+       StatusBar1.Panels(0).AutoSize = StatusBarPanelAutoSize.Spring  
+       StatusBar1.Panels(1).AutoSize = StatusBarPanelAutoSize.Contents  
+       StatusBar1.Panels(2).AutoSize = StatusBarPanelAutoSize.Contents  
+    ' Set BorderStyle property of panels.  
+       StatusBar1.Panels(0).BorderStyle = StatusBarPanelBorderStyle.Raised  
+       StatusBar1.Panels(1).BorderStyle = StatusBarPanelBorderStyle.Sunken  
+       StatusBar1.Panels(2).BorderStyle = StatusBarPanelBorderStyle.Raised  
+    ' Set Icon property of third panel. You should replace the bolded  
+    ' icon in the sample below with an icon of your own choosing.  
+       StatusBar1.Panels(2).Icon = New _   
+       System.Drawing.Icon(System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Icon.ico")  
+       StatusBar1.ShowPanels = True  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void CreateStatusBarPanels()  
+    {  
+       // Create panels and set text property.  
+       statusBar1.Panels.Add("One");  
+       statusBar1.Panels.Add("Two");  
+       statusBar1.Panels.Add("Three");  
+       // Set properties of StatusBar panels.  
+       // Set AutoSize property of panels.  
+       statusBar1.Panels[0].AutoSize = StatusBarPanelAutoSize.Spring;  
+       statusBar1.Panels[1].AutoSize = StatusBarPanelAutoSize.Contents;  
+       statusBar1.Panels[2].AutoSize = StatusBarPanelAutoSize.Contents;  
+       // Set BorderStyle property of panels.  
+       statusBar1.Panels[0].BorderStyle =  
+          StatusBarPanelBorderStyle.Raised;  
+       statusBar1.Panels[1].BorderStyle = StatusBarPanelBorderStyle.Sunken;  
+       statusBar1.Panels[2].BorderStyle = StatusBarPanelBorderStyle.Raised;  
+       // Set Icon property of third panel. You should replace the bolded  
+       // icon in the sample below with an icon of your own choosing.  
+       // Note the escape character used (@) when specifying the path.  
+       statusBar1.Panels[2].Icon =   
+          new System.Drawing.Icon (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       + @"\Icon.ico");  
+       statusBar1.ShowPanels = true;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void CreateStatusBarPanels()  
+       {  
+          // Create panels and set text property.  
+          statusBar1->Panels->Add("One");  
+          statusBar1->Panels->Add("Two");  
+          statusBar1->Panels->Add("Three");  
+          // Set properties of StatusBar panels.  
+          // Set AutoSize property of panels.  
+          statusBar1->Panels[0]->AutoSize =  
+             StatusBarPanelAutoSize::Spring;  
+          statusBar1->Panels[1]->AutoSize =  
+             StatusBarPanelAutoSize::Contents;  
+          statusBar1->Panels[2]->AutoSize =  
+             StatusBarPanelAutoSize::Contents;  
+          // Set BorderStyle property of panels.  
+          statusBar1->Panels[0]->BorderStyle =  
+             StatusBarPanelBorderStyle::Raised;  
+          statusBar1->Panels[1]->BorderStyle =  
+             StatusBarPanelBorderStyle::Sunken;  
+          statusBar1->Panels[2]->BorderStyle =  
+             StatusBarPanelBorderStyle::Raised;  
+          // Set Icon property of third panel.  
+          // You should replace the bolded image   
+          // in the sample below with an icon of your own choosing.  
+          statusBar1->Panels[2]->Icon =  
+             gcnew System::Drawing::Icon(String::Concat(  
+             System::Environment::GetFolderPath(  
+             System::Environment::SpecialFolder::Personal),  
+             "\\Icon.ico"));  
+          statusBar1->ShowPanels = true;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusBar>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ [Collection Editor Dialog Box](http://msdn.microsoft.com/ja-jp/53fb3aad-bffa-4da5-ac89-8438e6fc803c)   
+ [方法 : ステータス バー パネルのサイズを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md)   
+ [チュートリアル : ステータス バー情報の実行時更新](../../../../docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md)   
+ [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](../../../../docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md)   
+ [StatusBar コントロールの概要](../../../../docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md b/docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md
new file mode 100644
index 00000000000..3fe61a154e9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : ListView コントロールに検索機能を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ビュー, 有効化 (検索を)"
+  - "一覧, 有効化 (検索を)"
+  - "ListView コントロール [Windows フォーム], 追加 (検索機能を)"
+  - "検索, 追加 (ListView コントロールに検索機能を)"
+ms.assetid: 557782d9-b705-4bab-b496-9938afddac82
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ListView コントロールに検索機能を追加する
+<xref:System.Windows.Forms.ListView> コントロールで大きな項目リストを使用するときは、多くの場合、ユーザーに検索機能を提供する必要があります。  <xref:System.Windows.Forms.ListView> コントロールは、テキスト一致および位置検索という 2 つの方法でこの機能を提供します。  
+  
+ <xref:System.Windows.Forms.ListView.FindItemWithText%2A> メソッドを使用すると、検索文字列とオプションの開始インデックスと終了インデックスを指定して、リスト ビューや詳細ビューの <xref:System.Windows.Forms.ListView> でテキスト検索を実行できます。  これと対照的に、<xref:System.Windows.Forms.ListView.FindNearestItem%2A> メソッドを使用すると、x 座標と y 座標および検索方向を指定して、アイコン ビューや並べて表示ビューの <xref:System.Windows.Forms.ListView> で項目を検索できます。  
+  
+### テキストを使用して項目を検索するには  
+  
+1.  <xref:System.Windows.Forms.ListView.View%2A> プロパティを <xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View> に設定して <xref:System.Windows.Forms.ListView> を作成し、<xref:System.Windows.Forms.ListView> に項目を設定します。  
+  
+2.  <xref:System.Windows.Forms.ListView.FindItemWithText%2A> メソッドを呼び出して、検索項目のテキストを渡します。  
+  
+3.  次のコード例は、基本的な <xref:System.Windows.Forms.ListView> を作成して項目を設定し、ユーザーによるテキスト入力を使用してリスト内の項目を検索する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Forms.ListViewFindItems#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/cpp/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.ListViewFindItems#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ListViewFindItems#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/VB/form1.vb#1)]  
+  
+### x 座標と y 座標を使用して項目を検索するには  
+  
+1.  <xref:System.Windows.Forms.View> プロパティを <xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View> に設定して <xref:System.Windows.Forms.ListView> を作成し、<xref:System.Windows.Forms.ListView> に項目を設定します。  
+  
+2.  <xref:System.Windows.Forms.ListView.FindNearestItem%2A> メソッドを呼び出して、適切な x 座標と y 座標および検索方向を渡します。  
+  
+3.  次のコード例は、基本アイコン <xref:System.Windows.Forms.ListView> を作成して項目を設定し、<xref:System.Windows.Forms.Control.MouseDown> イベントをキャプチャして、最も近い項目を上方向に検索する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Forms.ListViewFindItems#2](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/cpp/form1.cpp#2)]
+ [!code-csharp[System.Windows.Forms.ListViewFindItems#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/CS/form1.cs#2)]
+ [!code-vb[System.Windows.Forms.ListViewFindItems#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewFindItems/VB/form1.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListView.FindItemWithText%2A>   
+ <xref:System.Windows.Forms.ListView.FindNearestItem%2A>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..ceacd3bbb16
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md
@@ -0,0 +1,113 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 追加 (DataGrid コントロールに)"
+  - "DataGrid コントロール [Windows フォーム], 追加 (テーブルと列を)"
+  - "テーブル [Windows フォーム], 追加 (DataGrid コントロールに)"
+ms.assetid: 2fe661b9-aa06-49b9-a314-a0d3cbfdcb4d
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロールのデータをテーブルおよび列に表示するには、**DataGridTableStyle** オブジェクトを作成して **GridTableStylesCollection** オブジェクトに追加します。GridTableStylesCollection オブジェクトには、<xref:System.Windows.Forms.DataGrid> コントロールの **TableStyles** プロパティを使用してアクセスできます。  各テーブル スタイルは、**DataGridTableStyle** オブジェクトの **MappingName** プロパティで指定されたデータ テーブルの内容を表示します。  既定では、列スタイルが指定されていないテーブル スタイルには、そのデータ テーブル内のすべての列が表示されます。  **GridColumnStylesCollection** オブジェクトに **DataGridColumnStyle** オブジェクトを追加することにより、テーブルから表示する列を制限できます。GridColumnStylesCollection オブジェクトには、各 **DataGridTableStyle** オブジェクトの **GridColumnStyles** プロパティを通してアクセスできます。  
+  
+### プログラムで DataGrid にテーブルおよび列を追加するには  
+  
+1.  データをテーブルに表示するには、まず <xref:System.Windows.Forms.DataGrid> コントロールをデータセットにバインドする必要があります。  詳細については、「[方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)」を参照してください。  
+  
+    > [!CAUTION]
+    >  列スタイルをプログラムで指定する場合は、**DataGridTableStyle** オブジェクトを **GridTableStylesCollection** オブジェクトに追加する前に、必ず **DataGridColumnStyle** オブジェクトを作成して **GridColumnStylesCollection** オブジェクトに追加します。  空の **DataGridTableStyle** オブジェクトをコレクションに追加すると、**DataGridColumnStyle** オブジェクトが自動的に生成されます。  その結果、重複した **MappingName** 値で新しい **DataGridColumnStyle** オブジェクトを **GridColumnStylesCollection** オブジェクトに追加しようとすると、例外が発生します。  
+  
+2.  新しいテーブル スタイルを宣言し、そのマップ名を設定します。  
+  
+    ```vb  
+    Dim ts1 As New DataGridTableStyle()  
+    ts1.MappingName = "Customers"  
+  
+    ```  
+  
+    ```csharp  
+    DataGridTableStyle ts1 = new DataGridTableStyle();  
+    ts1.MappingName = "Customers";  
+  
+    ```  
+  
+    ```cpp  
+    DataGridTableStyle* ts1 = new DataGridTableStyle();  
+    ts1->MappingName = S"Customers";  
+    ```  
+  
+3.  新しい列スタイルを宣言し、そのマップ名とその他のプロパティを設定します。  
+  
+    ```vb  
+    Dim myDataCol As New DataGridBoolColumn()  
+    myDataCol.HeaderText = "My New Column"  
+    myDataCol.MappingName = "Current"  
+  
+    ```  
+  
+    ```csharp  
+    DataGridBoolColumn myDataCol = new DataGridBoolColumn();  
+    myDataCol.HeaderText = "My New Column";  
+    myDataCol.MappingName = "Current";  
+  
+    ```  
+  
+    ```cpp  
+    DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();  
+    myDataCol->HeaderText = "My New Column";  
+    myDataCol->MappingName = "Current";  
+    ```  
+  
+4.  **GridColumnStylesCollection** オブジェクトの **Add** メソッドを呼び出して、列をテーブル スタイルに追加します。  
+  
+    ```vb  
+    ts1.GridColumnStyles.Add(myDataCol)  
+  
+    ```  
+  
+    ```csharp  
+    ts1.GridColumnStyles.Add(myDataCol);  
+  
+    ```  
+  
+    ```cpp  
+    ts1->GridColumnStyles->Add(myDataCol);  
+    ```  
+  
+5.  **GridTableStylesCollection** オブジェクトの **Add** メソッドを呼び出して、テーブル スタイルをデータ グリッドに追加します。  
+  
+    ```vb  
+    DataGrid1.TableStyles.Add(ts1)  
+  
+    ```  
+  
+    ```csharp  
+    dataGrid1.TableStyles.Add(ts1);  
+  
+    ```  
+  
+    ```cpp  
+    dataGrid1->TableStyles->Add(ts1);  
+    ```  
+  
+## 参照  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md b/docs/framework/winforms/controls/how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md
new file mode 100644
index 00000000000..2a5ec4854cf
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md
@@ -0,0 +1,113 @@
+---
+title: "方法 : コントロールのコレクションに対して実行時にコントロールを追加または削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コレクション, 追加 (アイテムを)"
+  - "コントロール [Windows フォーム], 追加 (コレクションを使用して)"
+  - "コントロール [Windows フォーム], 削除 (コレクションを使用して)"
+  - "コントロールのコレクション"
+  - "実行時に, 追加 (コントロールを)"
+  - "実行時に, 削除 (コントロールを)"
+ms.assetid: 771bf895-3d5f-469b-a324-3528f343657e
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : コントロールのコレクションに対して実行時にコントロールを追加または削除する
+アプリケーション開発における一般的なタスクの 1 つに、フォーム上のコンテナー コントロール \(<xref:System.Windows.Forms.Panel> や <xref:System.Windows.Forms.GroupBox> などのコントロール、またはフォーム自体\) へのコントロールの追加および削除があります。  デザイン時には、パネルまたはグループ ボックスにコントロールを直接ドラッグできます。  実行時には、これらのコンテナー コントロールは `Controls` コレクションを保持します。それにより、現在どのコントロールが含まれているかを追跡します。  
+  
+> [!NOTE]
+>  次のコード例は、内部にコントロールのコレクションを保持するすべてのコントロールに適用されます。  
+  
+### プログラムによって、コレクションにコントロールを追加するには  
+  
+1.  追加するコントロールのインスタンスを作成します。  
+  
+2.  新規コントロールのプロパティを設定します。  
+  
+3.  このコントロールを親コントロールの `Controls` コレクションに追加します。  
+  
+     次に示すのは、<xref:System.Windows.Forms.Button> コントロールのインスタンスを作成する方法のコード例です。  このコード例では、フォームに <xref:System.Windows.Forms.Panel> コントロールがあり、作成するボタンのイベント処理メソッド `NewPanelButton_Click` が既に存在することが必要です。  
+  
+    ```vb  
+    Public NewPanelButton As New Button()  
+  
+    Public Sub AddNewControl()  
+       ' The Add method will accept as a parameter any object that derives  
+       ' from the Control class. In this case, it is a Button control.  
+       Panel1.Controls.Add(NewPanelButton)  
+       ' The event handler indicated for the Click event in the code   
+       ' below is used as an example. Substite the appropriate event  
+       ' handler for your application.  
+       AddHandler NewPanelButton.Click, AddressOf NewPanelButton_Click  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public Button newPanelButton = new Button();  
+  
+    public void addNewControl()  
+    {   
+       // The Add method will accept as a parameter any object that derives  
+       // from the Control class. In this case, it is a Button control.  
+       panel1.Controls.Add(newPanelButton);  
+       // The event handler indicated for the Click event in the code   
+       // below is used as an example. Substite the appropriate event  
+       // handler for your application.  
+       this.newPanelButton.Click += new System.EventHandler(this. NewPanelButton_Click);  
+    }  
+    ```  
+  
+### プログラムによって、コレクションからコントロールを削除するには  
+  
+1.  イベントからイベント ハンドラーを削除します。  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では、[RemoveHandler Statement](../../../../ocs/visual-basic/language-reference/statements/removehandler-statement.md) キーワードを使用し、[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] では、[\-\= 演算子](../Topic/-=%20Operator%20\(C%23%20Reference\)2.md) を使用します。  
+  
+2.  `Remove` メソッドを使用して、パネルの `Controls` コレクションから目的のコントロールを削除します。  
+  
+3.  <xref:System.Windows.Forms.Control.Dispose%2A> メソッドを呼び出して、そのコントロールによって使用されていたすべてのリソースを解放します。  
+  
+    ```vb  
+    Public Sub RemoveControl()  
+    ' NOTE: The code below uses the instance of   
+    ' the button (NewPanelButton) from the previous example.  
+       If Panel1.Controls.Contains(NewPanelButton) Then  
+          RemoveHandler NewPanelButton.Click, AddressOf _   
+             NewPanelButton_Click  
+          Panel1.Controls.Remove(NewPanelButton)  
+          NewPanelButton.Dispose()  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void removeControl(object sender, System.EventArgs e)  
+    {  
+    // NOTE: The code below uses the instance of   
+    // the button (newPanelButton) from the previous example.  
+       if(panel1.Controls.Contains(newPanelButton))  
+       {  
+          this.newPanelButton.Click -= new System.EventHandler(this.   
+             NewPanelButton_Click);  
+          panel1.Controls.Remove(newPanelButton);  
+          newPanelButton.Dispose();  
+       }  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Panel>   
+ [Panel コントロール](../../../../docs/framework/winforms/controls/panel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-toolstrip-items-dynamically.md b/docs/framework/winforms/controls/how-to-add-toolstrip-items-dynamically.md
new file mode 100644
index 00000000000..77f413a1db9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-toolstrip-items-dynamically.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : ToolStrip の項目を動的に追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ContextMenuStrip コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム], 追加 (アイテムを動的に)"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: 0e8dea56-5f46-408b-914d-7e360341a234
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ToolStrip の項目を動的に追加する
+メニューが開くときに <xref:System.Windows.Forms.ToolStrip> コントロールのメニュー項目コレクションを動的に設定できます。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ContextMenuStrip> コントロールに項目を動的に追加する方法を示しています。  この例は、フォーム上の 3 つの異なるコントロールに同じ <xref:System.Windows.Forms.ContextMenuStrip> を再利用する方法も示しています。  
+  
+ この例では、<xref:System.Windows.Forms.ToolStripDropDown.Opening> イベント ハンドラーがメニュー項目コレクションを設定します。  <xref:System.Windows.Forms.ToolStripDropDown.Opening> イベント ハンドラーは、<xref:System.Windows.Forms.ContextMenuStrip.SourceControl%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Forms.ToolStripItem.OwnerItem%2A?displayProperty=fullName> プロパティを調べて、ソース管理を示す <xref:System.Windows.Forms.ToolStripItem> を追加します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#40](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#40)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#40](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#40)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Drawing アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ <xref:System.Windows.Forms.ToolStripDropDownButton>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md b/docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md
new file mode 100644
index 00000000000..4828a670f17
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], WebBrowser コントロール"
+  - "Web ブラウザー [.NET Framework], 追加 (Windows フォームに)"
+  - "WebBrowser コントロール [Windows フォーム], 追加 (Web ブラウザーの機能をアプリケーションに)"
+  - "WebBrowser コントロール [Windows フォーム], 例"
+  - "Windows フォーム, 追加 (Web ブラウザーの機能を)"
+ms.assetid: 3871f072-b57a-435b-9976-e5da28df04a7
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する
+<xref:System.Windows.Forms.WebBrowser> コントロールを使用して、Web ブラウザーの機能をアプリケーションに追加することができます。  コントロールは、既定では、Web ブラウザーのように動作します。  <xref:System.Windows.Forms.WebBrowser.Url%2A> プロパティを設定することで、最初の URL を読み込んだ後に、ハイパーリンクをクリックするか、キーボード ショートカットを使用して、ナビゲーション履歴で前または次に移動できます。  既定では、右クリックして表示されるショートカット メニューからその他のブラウザーの機能にアクセスできます。  また、コントロールにドロップすることで、新しいドキュメントを開くこともできます。  <xref:System.Windows.Forms.WebBrowser> コントロールには、Internet Explorer に似たユーザー インターフェイスの機能を実装するために使用できる、いくつかのプロパティ、メソッド、およびイベントもあります。  
+  
+ 次のコード例では、アドレス バー、標準的なブラウザーのボタン、**\[ファイル\]** メニュー、ステータス バー、および現在のページのタイトルを表示するタイトル バーを実装しています。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.WebBrowser#0](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser/CPP/form1.cpp#0)]
+ [!code-csharp[System.Windows.Forms.WebBrowser#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.WebBrowser#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `System,`、`System.Drawing`、および `System.Windows.Forms` の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ [WebBrowser コントロール](../../../../docs/framework/winforms/controls/webbrowser-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md b/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md
new file mode 100644
index 00000000000..0df44f72105
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms-at-design-time.md
@@ -0,0 +1,63 @@
+---
+title: "方法 : デザイン時にフォームの端に合わせてコントロールを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], ドッキング (デザイナーを使用)"
+  - "Dock プロパティ, 配置 (コントロールをデザイナーで)"
+ms.assetid: 51f08998-5e3b-4330-be58-a4edd0eb60f4
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイン時にフォームの端に合わせてコントロールを配置する
+<xref:System.Windows.Forms.Control.Dock%2A> を設定することにより、フォームの端に合わせてコントロールを配置できます。  このプロパティは、フォーム内における目的のコントロールの配置位置を指定します。  <xref:System.Windows.Forms.Control.Dock%2A> プロパティには、次の値を設定できます。  
+  
+|設定|コントロールに対する効果|  
+|--------|------------------|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの下部にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの余白領域をすべて使用します。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの左側にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|ドッキングしません。<xref:System.Windows.Forms.Control.Location%2A> で指定された場所に表示します。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの右側にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの上部にドッキングします。|  
+  
+ これらの値は、コードでも設定できます。  詳細については、「[方法 : フォームの端に合わせてコントロールを配置する](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にコントロールの Dock プロパティを設定するには  
+  
+1.  Windows フォーム デザイナーでコントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.Dock%2A> プロパティの横にあるドロップダウン ボックスをクリックします。  
+  
+     設定可能な 6 つの <xref:System.Windows.Forms.Control.Dock%2A> 設定を示すグラフィカル インターフェイスが表示されます。  
+  
+3.  適切な設定を選択します。  
+  
+4.  目的のコントロールがこの設定に従ってドッキングされます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Dock%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.Anchor%2A?displayProperty=fullName>   
+ [方法 : フォームの端に合わせてコントロールを配置する](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [方法 : Windows フォームにコントロールを固定する](../../../../docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md)   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md b/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md
new file mode 100644
index 00000000000..4b20dd41f4c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : フォームの端に合わせてコントロールを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 配置 (フォームでの)"
+  - "カスタム コントロール [Windows フォーム], ドッキング (コードを使用)"
+  - "Dock プロパティ, 配置 (コントロールを、コードを使用)"
+  - "フォーム, 配置 (コントロールを)"
+ms.assetid: 5994cb59-242b-4e75-bd0e-62879c34d702
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : フォームの端に合わせてコントロールを配置する
+<xref:System.Windows.Forms.Control.Dock%2A> プロパティを設定することにより、フォームの端に合わせてコントロールを配置することができます。  このプロパティは、フォーム内のコントロールの場所を指定します。  <xref:System.Windows.Forms.Control.Dock%2A> プロパティには次の値のいずれかを設定できます。  
+  
+|設定|コントロールへの影響|  
+|--------|----------------|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの下部にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの残りの全スペースを埋めます。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの左側にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|どこにもドッキングせず、その <xref:System.Windows.Forms.Control.Location%2A> プロパティで指定された位置に表示されます。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの右側にドッキングします。|  
+|<xref:System.Windows.Forms.DockStyle>|フォームの上部にドッキングします。|  
+  
+ Visual Studio では、この機能のデザイン時サポートがあります。  
+  
+### 実行時にコントロールの Dock プロパティを設定するには  
+  
+1.  コードで <xref:System.Windows.Forms.Control.Dock%2A> プロパティを適切な値に設定します。  
+  
+    ```vb  
+    ' To set the Dock property internally.  
+    Me.Dock = DockStyle.Top  
+    ' To set the Dock property from another object.  
+    UserControl1.Dock = DockStyle.Top  
+    ```  
+  
+    ```csharp  
+    // To set the Dock property internally.  
+    this.Dock = DockStyle.Top;  
+    // To set the Dock property from another object.  
+    UserControl1.Dock = DockStyle.Top;  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Dock%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.Anchor%2A?displayProperty=fullName>   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-align-and-stretch-a-control-in-a-tablelayoutpanel-control.md b/docs/framework/winforms/controls/how-to-align-and-stretch-a-control-in-a-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..bfe2250745d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-align-and-stretch-a-control-in-a-tablelayoutpanel-control.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "net.ComponentModel.StyleCollectionEditor.TLP.AlignStretchCtrl"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], エイリアスの使用"
+  - "コントロール [Windows フォーム], 拡大"
+  - "TableLayoutPanel コントロール [Windows フォーム], 拡大 (コントロールを)"
+ms.assetid: 7dc1a157-6fee-4995-8ebc-b65bdc0909a8
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する
+<xref:System.Windows.Forms.Control.Anchor%2A> プロパティと <xref:System.Windows.Forms.Control.Dock%2A> プロパティを使用すると、<xref:System.Windows.Forms.TableLayoutPanel> 内でコントロールを配置して伸縮できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールを配置して伸縮するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールの左上のセルにドラッグします。  <xref:System.Windows.Forms.Button> コントロールはセルの中央に配置されます。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Left,Right` に設定します。  <xref:System.Windows.Forms.Button> コントロールがセルの幅に合わせて伸縮します。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Top,Bottom` に設定します。  <xref:System.Windows.Forms.Button> コントロールがセルの高さに合わせて伸縮します。  
+  
+5.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  <xref:System.Windows.Forms.Button> コントロールがセル全体に拡張します。  
+  
+6.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  <xref:System.Windows.Forms.Button> コントロールが元のサイズに戻り、セルの左上隅に移動します。  **Windows フォーム デザイナー**で <xref:System.Windows.Forms.Control.Anchor%2A> プロパティが `Top, Left` に設定されているからです。  
+  
+7.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Bottom,Right` に設定します。  <xref:System.Windows.Forms.Button> コントロールがセルの右下隅に移動します。  
+  
+8.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を <xref:System.Windows.Forms.AnchorStyles> に設定します。  <xref:System.Windows.Forms.Button> コントロールがセルの中央に移動します。  
+  
+## 参照  
+ [TableLayoutPanel コントロール](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-align-multiple-controls-on-windows-forms.md b/docs/framework/winforms/controls/how-to-align-multiple-controls-on-windows-forms.md
new file mode 100644
index 00000000000..de0b744cfcb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-align-multiple-controls-on-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : Windows フォーム上の複数のコントロールを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], エイリアスの使用"
+  - "コントロール [Windows フォーム], 配置"
+  - "フォーム, 配置 (コントロールを)"
+  - "Windows フォーム, 配置 (コントロールを)"
+ms.assetid: b7175656-f532-49e9-b0b1-177d1b40af3e
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム上の複数のコントロールを配置する
+Windows ベースのアプリケーションのユーザー インターフェイス \(UI\) のレイアウトを標準化するために、1 つのコマンドでコントロールのグループを配置できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### フォームで複数のコントロールを配置するには  
+  
+1.  **Windows フォーム デザイナー**に配置するコントロールを含むフォームを開きます。  
+  
+2.  配置するコントロールを選択します。このとき、最初に選択したコントロールを主コントロールとし、主コントロールに合わせて他のコントロールが配置されるようにします。  
+  
+3.  **\[書式\]** メニューの **\[整列\]** をポイントし、7 つの選択項目のうちの 1 つをクリックします。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [方法 : 既存のコントロールを別の親に再配置する](../../../../docs/framework/winforms/controls/how-to-reassign-existing-controls-to-a-different-parent.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md b/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md
new file mode 100644
index 00000000000..bf718b3a558
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子コントロール, 固定およびドッキング"
+  - "コントロール [Windows フォーム], 子"
+  - "FlowLayoutPanel コントロール [Windows フォーム], 子コントロール"
+  - "レイアウト [Windows フォーム], 子コントロール"
+ms.assetid: a2bcdfca-9b63-45e6-9c0e-3411015cba98
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする
+<xref:System.Windows.Forms.FlowLayoutPanel> コントロールは、子コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティと <xref:System.Windows.Forms.Control.Dock%2A> プロパティをサポートします。  
+  
+### FlowLayoutPanel コントロールで子コントロールを固定およびドッキングするには  
+  
+1.  フォームで <xref:System.Windows.Forms.FlowLayoutPanel> コントロールを作成します。  
+  
+2.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.Control.Width%2A> を 300 に設定し、<xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> を <xref:System.Windows.Forms.FlowDirection> に設定します。  
+  
+3.  2 つの <xref:System.Windows.Forms.Button> コントロールを作成し、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールに配置します。  
+  
+4.  最初のボタンの <xref:System.Windows.Forms.Control.Width%2A> を 200 に設定します。  
+  
+5.  2 番目のボタンの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+    > [!NOTE]
+    >  2 番目のボタンは、最初のボタンと同じ幅を前提としています。  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの幅にまたがって伸縮しません。  
+  
+6.  2 番目のボタンの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを `[なし]` に設定します。  これにより、元の幅のボタンを前提とします。  
+  
+7.  2 番目のボタンの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティを `[左、右]` に設定します。  
+  
+    > [!IMPORTANT]
+    >  2 番目のボタンは、最初のボタンと同じ幅を前提としています。  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの幅にまたがって伸縮しません。  これは、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの固定とドッキングの一般的な規則です。垂直方向のフローについては、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールが、幅の最大の列の子コントロールから暗黙の列の幅を計算します。  <xref:System.Windows.Forms.Control.Anchor%2A> プロパティまたは <xref:System.Windows.Forms.Control.Dock%2A> プロパティを持つこの列のその他のすべてのコントロールが、この暗黙の列に合わせて配置または拡大されます。  この動作は、水平のフロー方向と同様の方法で機能します。  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールは、行で最も高い子コントロールから、暗黙の行の高さを計算して、この行のすべてのドッキングまたは固定の子コントロールは、暗黙の行に合わせて配置またはサイズが変更されます。  
+  
+## 使用例  
+ 次の図は、<xref:System.Windows.Forms.FlowLayoutPanel> 内の青のボタンを基準とする相対位置に固定されてドッキングされる 4 つのボタンを示しています。  <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> が <xref:System.Windows.Forms.FlowDirection> です。  
+  
+ ![FlowLayoutPanel アンカー](../../../../docs/framework/winforms/controls/media/net-flpanchorexp.png "NET\_FLPanchorExp")  
+  
+ 次の図は、<xref:System.Windows.Forms.FlowLayoutPanel> 内の青のボタンを基準とする相対位置に固定されてドッキングされる 4 つのボタンを示しています。  <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> が <xref:System.Windows.Forms.FlowDirection> です。  
+  
+ ![FlowLayoutPanel アンカー](../../../../docs/framework/winforms/controls/media/vs-flpanchor2.png "VS\_FLPanchor2")  
+  
+ 次のコード例は、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.Button> コントロールにおける様々な <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を示します。  
+  
+ [!code-csharp[System.Windows.Forms.FlowLayoutPanel.AnchorExampleForm#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlowLayoutPanel.AnchorExampleForm/CS/FlpAnchorExampleForm.cs#1)]
+ [!code-vb[System.Windows.Forms.FlowLayoutPanel.AnchorExampleForm#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlowLayoutPanel.AnchorExampleForm/VB/FlpAnchorExampleForm.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ [FlowLayoutPanel コントロールの概要](../../../../docs/framework/winforms/controls/flowlayoutpanel-control-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md b/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..6ac5b3b72b7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "net.ComponentModel.StyleCollectionEditor.TLP.AnchorDock"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "子コントロール, 固定およびドッキング"
+  - "コントロール [Windows フォーム], 子"
+  - "レイアウト [Windows フォーム], 子コントロール"
+  - "TableLayoutPanel コントロール [Windows フォーム], 子コントロール"
+ms.assetid: 0d267c35-25f1-49b8-8976-c64e8f0ddc0b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする
+<xref:System.Windows.Forms.TableLayoutPanel> コントロールは、子コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティと <xref:System.Windows.Forms.Control.Dock%2A> プロパティをサポートします。  
+  
+### TableLayoutPanel のセル内の子コントロールを揃えるには  
+  
+1.  フォームで <xref:System.Windows.Forms.TableLayoutPanel> コントロールを作成します。  
+  
+2.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> プロパティと <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> プロパティの値を 1 に設定します。  
+  
+3.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールで <xref:System.Windows.Forms.Button> コントロールを作成します。  <xref:System.Windows.Forms.Button> がセルの左上隅を占有します。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Left` に変更します。  <xref:System.Windows.Forms.Button> コントロールが、セルの左罫線に合うように移動します。  
+  
+    > [!NOTE]
+    >  この動作は、他のコンテナー コントロールの動作と異なります。  他のコンテナー コントロールでは、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティが設定されてと子コントロールは移動せず、固定されたコントロールと親コンテナーの境界間の距離は、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティが設定されたときに固定されます。  
+  
+5.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Top, Left` に変更します。  <xref:System.Windows.Forms.Button> コントロールがセルの左上隅を占有するよう移動します。  
+  
+6.  `Top, Right` の値を指定して手順 5 を繰り返し、<xref:System.Windows.Forms.Button> コントロールをセルの右上隅に移動します。  `Bottom, Left` と `Bottom, Right` の値を指定して繰り返します。  
+  
+### TableLayoutPanel セル内の子コントロールを拡大するには  
+  
+1.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Left, Right` に変更します。  <xref:System.Windows.Forms.Button> コントロールがサイズ変更され、セルいっぱいに拡大されます。  
+  
+    > [!NOTE]
+    >  この動作は、他のコンテナー コントロールの動作と異なります。  他のコンテナー コントロールでは、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティが `Left, Right` または `Top, Bottom` に設定された場合、子コントロールはサイズ変更されません。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Top, Bottom` に変更します。  <xref:System.Windows.Forms.Button> コントロールがサイズ変更され、セルの上から下まで拡大されます。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `Top, Bottom, Left, Right` に変更します。  <xref:System.Windows.Forms.Button> コントロールがセルを満たすようサイズ変更されます。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を `None` に変更します。  <xref:System.Windows.Forms.Button> コントロールがサイズ変更され、セルの中央に配置されます。  
+  
+5.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。  <xref:System.Windows.Forms.Button> コントロールが、セルの左罫線に合うように移動します。  <xref:System.Windows.Forms.Button> コントロールの幅は保持されますが、高さはセルを垂直方向に満たすようサイズ変更されます。  
+  
+    > [!NOTE]
+    >  これは、他のコンテナー コントロール内で発生するのと同じ動作です。  
+  
+6.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。  <xref:System.Windows.Forms.Button> コントロールがセルを満たすようサイズ変更されます。  
+  
+## 使用例  
+ 次の図は、5 つの個別の <xref:System.Windows.Forms.TableLayoutPanel> のセルに固定されている 5 つのボタンを示しています。  
+  
+ ![TableLayoutPanel アンカー](../../../../docs/framework/winforms/controls/media/vs-tlpanchor.png "VS\_TLPanchor")  
+  
+ 次の図は、4 つの個別の <xref:System.Windows.Forms.TableLayoutPanel> のセルの隅に固定されている 4 つのボタンを示しています。  
+  
+ ![TableLayoutPanel アンカー](../../../../docs/framework/winforms/controls/media/vs-tlpanchor2.png "VS\_TLPanchor2")  
+  
+ 次の図は、3 つの個別の <xref:System.Windows.Forms.TableLayoutPanel> のセルに固定することで拡大された 3 つのボタンを示しています。  
+  
+ ![TableLayoutPanel アンカー](../../../../docs/framework/winforms/controls/media/vs-tlpanchor3.gif "VS\_TLPAnchor3")  
+  
+ 次のコード例は、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの <xref:System.Windows.Forms.Button> コントロールにおけるすべての組み合わせの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を示します。  
+  
+ [!code-csharp[System.Windows.Forms.TableLayoutPanel.AnchorExampleForm#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.AnchorExampleForm/CS/TlpAnchorExampleForm.cs#1)]
+ [!code-vb[System.Windows.Forms.TableLayoutPanel.AnchorExampleForm#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.AnchorExampleForm/VB/TlpAnchorExampleForm.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  コードを新しいプロジェクトに貼り付けることで、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [TableLayoutPanel コントロール](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md b/docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md
new file mode 100644
index 00000000000..1d4e78e3ea5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォームにコントロールを固定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Anchor プロパティ, 有効化 (サイズ変更可能なフォーム)"
+  - "コントロール [Windows フォーム], 固定"
+  - "コントロール [Windows フォーム], 配置"
+  - "フォーム, サイズ変更"
+  - "サイズ変更 (フォームを)"
+  - "画面の解像度とコントロールの表示"
+  - "Windows フォーム コントロール, 画面の解像度"
+  - "Windows フォーム コントロール, サイズ"
+  - "Windows フォーム, サイズ変更"
+ms.assetid: 59ea914f-fbd3-427a-80fe-decd02f7ae6d
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームにコントロールを固定する
+実行時にユーザーがサイズ変更できるフォームをデザインする場合は、フォームのコントロールが適切にサイズ変更され、再配置されるようにする必要があります。  フォームでコントロールのサイズを動的に変更するには、Windows フォーム コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティを使用します。  <xref:System.Windows.Forms.Control.Anchor%2A> プロパティでは、コントロールの固定位置を定義します。  コントロールをフォームに固定し、フォームをサイズ変更する場合は、コントロールと固定位置の距離が保持されます。  たとえば、フォームの左端、右端、および下端に固定している <xref:System.Windows.Forms.TextBox> コントロールがあるとします。フォームをサイズ変更すると、<xref:System.Windows.Forms.TextBox> コントロールは水平方向にサイズ変更され、フォームの左右の端からの距離が保持されます。  また、フォームの下端からの距離が常に保持されるように、コントロール自体が垂直方向に再配置されます。  コントロールを固定せず、フォームをサイズ変更しない場合は、フォームの端からのコントロールの位置が変更されます。  
+  
+ <xref:System.Windows.Forms.Control.Anchor%2A> プロパティは <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティとやり取りします。  詳細については、「[AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### フォームにコントロールを固定するには  
+  
+1.  固定するコントロールを選択します。  
+  
+    > [!NOTE]
+    >  複数のコントロールを同時に固定できます。これを行うには、Ctrl キーを押しながら各コントロールをクリックして選択し、以降の手順を実行します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティの右にある矢印をクリックします。  
+  
+     エディターにクロスが表示されます。  
+  
+3.  アンカーを設定するには、クロスの上、下、左、右のいずれかの部分をクリックします。  
+  
+     既定では、コントロールが上と左に固定されます。  
+  
+4.  アンカー設定を無効にするには、クロスの該当するアームをクリックします。  
+  
+5.  <xref:System.Windows.Forms.Control.Anchor%2A> プロパティ エディターを閉じるには、<xref:System.Windows.Forms.Control.Anchor%2A> プロパティ名をもう一度クリックします。  
+  
+ 実行時にフォームが表示されると、フォームの端からの距離を保持するために、コントロールのサイズが変更されます。  固定された端からの距離は、Windows フォーム デザイナーでコントロールを配置したときに定義した距離と常に等しくなります。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ComboBox> コントロールなどの特定のコントロールでは、高さが制限されています。  フォームまたはコンテナーの下端にコントロールを固定する場合、制限された高さよりコントロールを高くすることはできません。  
+  
+ 継承したコントロールを固定できるようにするには、`Protected` にする必要があります。  コントロールのアクセス レベルを変更するには、**\[プロパティ\]** ウィンドウで `Modifiers` プロパティを設定します。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)   
+ [方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-append-a-menustrip-to-an-mdi-parent-window-windows-forms.md b/docs/framework/winforms/controls/how-to-append-a-menustrip-to-an-mdi-parent-window-windows-forms.md
new file mode 100644
index 00000000000..2900e3c1ac2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-append-a-menustrip-to-an-mdi-parent-window-windows-forms.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : MenuStrip を MDI 親ウィンドウに追加する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, マージ (メニュー項目を)"
+  - "MenuStrip コントロール [Windows フォーム], 追加"
+  - "MenuStrip コントロール [Windows フォーム], マージ"
+ms.assetid: ab70c936-b452-4653-b417-17be57bb795b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : MenuStrip を MDI 親ウィンドウに追加する (Windows フォーム)
+アプリケーションの中には、マルチ ドキュメント インターフェイス \(MDI\) 子ウィンドウの種類が MDI 親ウィンドウと異なるものがあります。  たとえば、MDI 親がスプレッドシートで、MDI 子がグラフの場合があります。  そのような場合は、異なる種類の MDI 子ウィンドウがアクティブになったときに、MDI 子メニューの内容で MDI 親メニューの内容を更新する必要があります。  
+  
+ 次の手順では、<xref:System.Windows.Forms.Form.IsMdiContainer%2A>、<xref:System.Windows.Forms.ToolStrip.AllowMerge%2A>、<xref:System.Windows.Forms.MergeAction>、および <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> の各プロパティを使用して MDI 子メニューを MDI 親メニューに追加します  MDI 子ウィンドウを閉じると、追加したメニューが MDI 親から削除されます。  
+  
+ 「[マルチ ドキュメント インターフェイス \(MDI\) アプリケーション](http://msdn.microsoft.com/library/xyhh2e7e\(v=vs.110\))」も参照してください。  
+  
+### メニュー項目を MDI 親に追加するには  
+  
+1.  フォームを作成し、その <xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定します。  
+  
+2.  <xref:System.Windows.Forms.MenuStrip> を `Form1` に追加し、<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> プロパティを `true` に設定します。  
+  
+3.  `Form1` の <xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定します。  
+  
+4.  トップレベル メニュー項目を `Form1` の <xref:System.Windows.Forms.MenuStrip> に追加し、その <xref:System.Windows.Forms.Control.Text%2A> プロパティを「`&File`」に設定しますす。  
+  
+5.  サブメニュー項目を `&File` メニュー項目に追加し、その <xref:System.Windows.Forms.Form.Text%2A> プロパティを「`&Open`」に設定します。  
+  
+6.  プロジェクトにフォームを追加し、フォームに <xref:System.Windows.Forms.MenuStrip> を追加し、`Form2` の <xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> のプロパティを `true` に設定します。  
+  
+7.  トップレベル メニュー項目を `Form2` の <xref:System.Windows.Forms.MenuStrip> に追加し、その <xref:System.Windows.Forms.Form.Text%2A> プロパティを「`&Special`」に設定しますす。  
+  
+8.  2 つのサブメニュー項目を `&Special` メニュー項目に追加し、それらの <xref:System.Windows.Forms.Form.Text%2A> プロパティをそれぞれ「`Command&1`」と「`Command&2`」に設定します。  
+  
+9. `&Special`、`Command&1`、および `Command&2` メニュー項目の <xref:System.Windows.Forms.MergeAction> プロパティを <xref:System.Windows.Forms.MergeAction> に設定します。  
+  
+10. <xref:System.Windows.Forms.ToolStripMenuItem> の `&New` の <xref:System.Windows.Forms.Control.Click> イベントにイベント ハンドラーを作成します。  
+  
+11. このイベント ハンドラー内に次のコード例のようなコードを挿入し、`Form2` の新規インスタンスを `Form1` の MDI 子フォームとして作成し、表示します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles openToolStripMenuItem.Click  
+        Dim NewMDIChild As New Form2()  
+        'Set the parent form of the child window.  
+            NewMDIChild.MdiParent = Me  
+        'Display the new form.  
+            NewMDIChild.Show()  
+    End Sub  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void openToolStripMenuItem_Click(object sender, EventArgs e)  
+    {  
+        Form2 newMDIChild = new Form2();  
+        // Set the parent form of the child window.  
+            newMDIChild.MdiParent = this;  
+        // Display the new form.  
+            newMDIChild.Show();  
+    }  
+  
+    ```  
+  
+12. `&Open` <xref:System.Windows.Forms.ToolStripMenuItem> に次のコード例のようなコードを配置し、イベント ハンドラーを登録します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(sender As Object, e As _  
+    EventArgs) Handles openToolStripMenuItem.Click  
+  
+    ```  
+  
+    ```csharp  
+    this.openToolStripMenuItem.Click += new System.EventHandler(this.openToolStripMenuItem_Click);  
+  
+    ```  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `Form1` と `Form2` という名前の 2 つの <xref:System.Windows.Forms.Form> コントロール。  
+  
+-   `Form1` 上の `menuStrip1` という名前の <xref:System.Windows.Forms.MenuStrip> コントロールと、`Form2` 上の `menuStrip2` という名前の <xref:System.Windows.Forms.MenuStrip> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md b/docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md
new file mode 100644
index 00000000000..035a296b790
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md
@@ -0,0 +1,91 @@
+---
+title: "方法 : Windows フォーム コントロールに属性を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性 [Windows フォーム], 適用"
+  - "コントロール [Windows フォーム], 適用 (属性を)"
+  - "Windows フォーム コントロール, 適用 (属性を)"
+ms.assetid: af0a3f7f-155b-4ba1-83c4-9cf721331a06
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォーム コントロールに属性を適用する
+デザイン環境と適切に対話し、実行時に正しく実行されるコンポーネントやコントロールを開発するには、クラスとメンバーに属性を正しく適用する必要があります。  
+  
+## 使用例  
+ 次のコード例は、カスタム コントロールで属性を使用する方法を示しています。  このコントロールは、単純なログ記録機能を実行します。  このコントロールがデータ ソースにバインドされると、データ ソースから送られた値が <xref:System.Windows.Forms.DataGridView> コントロールに表示されます。  この値が、`Threshold` プロパティの指定値を超えている場合は、`ThresholdExceeded` イベントが生成されます。  
+  
+ `AttributesDemoControl` は、`LogEntry` クラスを使用して値のログを記録します。  `LogEntry` クラスはテンプレート クラスで、ログを記録する型でパラメーター化されます。  たとえば、`AttributesDemoControl` が `float` 型の値のログを記録する場合、各 `LogEntry` インスタンスを次のように宣言して使用します。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#110](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/form1.cs#110)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#110](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/form1.vb#110)]  
+  
+> [!NOTE]
+>  `LogEntry` は、任意の型でパラメーター化されるため、パラメーター型で動作するためにリフレクションを使用する必要があります。  しきい値機能を使用するには、パラメーター型 `T` により、<xref:System.IComparable> インターフェイスを実装する必要があります。  
+  
+ `AttributesDemoControl` をホストするフォームは、パフォーマンス カウンターを定期的に照会します。  値はそれぞれ適切な型の `LogEntry` にパッケージ化され、フォームの <xref:System.Windows.Forms.BindingSource> に追加されます。  `AttributesDemoControl` は、データ バインディングを通じて値を受け取り、<xref:System.Windows.Forms.DataGridView> コントロールに表示します。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#1)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#1)]  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/form1.cs#100)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/form1.vb#100)]  
+  
+ 最初のコード例は `AttributesDemoControl` の実装です。  2 番目のコード例は、`AttributesDemoControl` を使用するフォームを示しています。  
+  
+## クラス レベル属性  
+ 属性には、クラス レベルで適用されるものがあります。  Windows フォーム コントロールに一般的に適用される属性を次のコード例に示します。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#20)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#20)]  
+  
+### TypeConverter 属性  
+ <xref:System.ComponentModel.TypeConverterAttribute> も一般的に使用されるクラス レベル属性です。  `LogEntry` クラスでのこの属性の使用方法を次のコード例に示します。  この例は、`LogEntryTypeConverter` と呼ばれる、`LogEntry` 型の <xref:System.ComponentModel.TypeConverter> の実装も示しています。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#5)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#5)]  
+  
+## メンバー レベル属性  
+ 属性には、メンバー レベルで適用されるものがあります。  Windows フォーム コントロールのプロパティに一般的に適用される属性を次のコード例に示します。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#21)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#21)]  
+  
+### AmbientValue 属性  
+ 次のコード例は、<xref:System.ComponentModel.AmbientValueAttribute> と、この属性とデザイン環境との対話をサポートするコードを示しています。  このような対話を*アンビエンス*と言います。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#23)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#23)]  
+  
+### データ バインディング属性  
+ 複合データ バインディングの実装例を次に示します。  前記のクラス レベル <xref:System.ComponentModel.ComplexBindingPropertiesAttribute> で、データ バインディングで使用する `DataSource` プロパティと `DataMember` プロパティを指定します。  <xref:System.ComponentModel.AttributeProviderAttribute> で、`DataSource` プロパティをバインドする型を指定します。  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#25](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#25)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#25](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#25)]  
+  
+ [!code-csharp[System.ComponentModel.AttributesDemoControl#26](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/CS/attributesdemocontrol.cs#26)]
+ [!code-vb[System.ComponentModel.AttributesDemoControl#26](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AttributesDemoControl/VB/attributesdemocontrol.vb#26)]  
+  
+## コードのコンパイル  
+  
+-   `AttributesDemoControl` をホストするフォームを作成するには、`AttributesDemoControl` アセンブリが必要です。  
+  
+## 参照  
+ <xref:System.IComparable>   
+ <xref:System.Windows.Forms.DataGridView>   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [Windows フォーム コントロールの属性](../../../../docs/framework/winforms/controls/attributes-in-windows-forms-controls.md)   
+ [How to: Serialize Collections of Standard Types with the DesignerSerializationVisibilityAttribute](../Topic/How%20to:%20Serialize%20Collections%20of%20Standard%20Types%20with%20the%20DesignerSerializationVisibilityAttribute.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-arrange-controls-with-snaplines-and-the-grid-in-windows-forms.md b/docs/framework/winforms/controls/how-to-arrange-controls-with-snaplines-and-the-grid-in-windows-forms.md
new file mode 100644
index 00000000000..7de38630976
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-arrange-controls-with-snaplines-and-the-grid-in-windows-forms.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : コントロールを Windows フォームのスナップ線とグリッドを使用して配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "GridSize"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], エイリアスの使用"
+  - "合わせる (グリッドに), Windows フォーム デザイナー"
+  - "Windows フォーム, グリッド オプション (デザイナーの)"
+ms.assetid: bb54bce5-880f-4a36-af68-8cf92058dc1c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : コントロールを Windows フォームのスナップ線とグリッドを使用して配置する
+[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] のレイアウト機能を使用すると、フォーム上のコントロールの配置場所を正確に指定できます。  フォームに追加したコントロールやフォーム上で移動したコントロールは、Windows フォーム デザイナーのグリッドの行と列に合わせて自動的に配置されます。また、スナップ線機能を使用してコントロールを配置することもできます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### すべてのコントロールをグリッドにスナップするには  
+  
+-   Windows フォーム デザイナーの **\[オプション\]** ダイアログ ボックスで、**\[SnapToGrid\]** レイアウト モードを選択します。  
+  
+     詳細については、「[General, Windows Forms Designer, Options Dialog Box](http://msdn.microsoft.com/ja-jp/8dd170af-72f0-4212-b04b-034ceee92834)」を参照してください。  グリッドのポイントに沿って、すべてのコントロールが配置されます。  
+  
+     所定の位置にコントロールをロックして、各コントロールをグリッドにスナップできます。  ただし、コントロールがロックされている間、コントロールを移動したりサイズ変更したりすることはできません。  コントロールのロックの詳細については、「[方法 : Windows フォームにコントロールをロックする](../../../../docs/framework/winforms/controls/how-to-lock-controls-to-windows-forms.md)」を参照してください。  
+  
+### スナップ線を使用してコントロールを配置するには  
+  
+-   Windows フォーム デザイナーの **\[オプション\]** ダイアログ ボックスで、**\[SnapLines\]** レイアウト モードを選択します。  
+  
+     詳細については、「[チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)」を参照してください。  これで、スナップ線を使用してフォーム上にコントロールを配置したり、並べ替えたりできます。  
+  
+## 参照  
+ [General, Windows Forms Designer, Options Dialog Box](http://msdn.microsoft.com/ja-jp/8dd170af-72f0-4212-b04b-034ceee92834)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-associate-a-contextmenustrip-with-a-control.md b/docs/framework/winforms/controls/how-to-associate-a-contextmenustrip-with-a-control.md
new file mode 100644
index 00000000000..e5ce2a17179
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-associate-a-contextmenustrip-with-a-control.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : ContextMenuStrip をコントロールに関連付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, 関連付け (コントロールに)"
+  - "コンテキスト メニュー, 関連付け"
+  - "ContextMenuStrips, 関連付け (コントロールに)"
+  - "ContextMenuStrips, 関連付け"
+ms.assetid: 6fc40a42-5d69-427f-aa30-0a146193226b
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ContextMenuStrip をコントロールに関連付ける
+コントロールとショートカット メニューを作成した後、次の手順を使用することによって、ユーザーがコントロールを右クリックした時点で特定のショートカット メニューを表示します。  これらの手順は、<xref:System.Windows.Forms.ContextMenuStrip> を Windows フォームと <xref:System.Windows.Forms.ToolStrip> コントロールに関連付けます。  
+  
+### ContextMenuStrip を Windows フォームに関連付けるには  
+  
+1.  <xref:System.Windows.Forms.Control.ContextMenuStrip%2A> プロパティを関連付けられている <xref:System.Windows.Forms.ContextMenuStrip> の名前に設定します。  
+  
+### ContextMenuStrip を ToolStrip コントロールに関連付けるには  
+  
+1.  コントロールの <xref:System.Windows.Forms.Control.ContextMenuStrip%2A> プロパティを関連付けられている <xref:System.Windows.Forms.ContextMenuStrip> の名前に設定します。  
+  
+## 使用例  
+ 次のコード例では、Windows フォームと <xref:System.Windows.Forms.ToolStrip> を作成して、別の <xref:System.Windows.Forms.ContextMenuStrip> コントロールをそれぞれに関連付けています。  
+  
+ [!code-csharp[System.Windows.Forms.ContextMenuStrip#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ContextMenuStrip/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ContextMenuStrip#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ContextMenuStrip/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.Control.ContextMenuStrip%2A>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ [方法 : メニュー項目を ContextMenuStrip に追加する](../../../../docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md)   
+ [ContextMenuStrip コントロール](../../../../docs/framework/winforms/controls/contextmenustrip-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md b/docs/framework/winforms/controls/how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md
new file mode 100644
index 00000000000..bce49fccf87
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md
@@ -0,0 +1,141 @@
+---
+title: "方法 : ショートカット メニューを Windows フォーム NotifyIcon コンポーネントに関連付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, バックグラウンド プロセスの"
+  - "NotifyIcon コンポーネント, 関連付け (ショートカット メニュー)"
+  - "ショートカット メニュー, バックグラウンド プロセスの"
+ms.assetid: d68f3926-08d3-4f7d-949f-1981b29cf188
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : ショートカット メニューを Windows フォーム NotifyIcon コンポーネントに関連付ける
+> [!NOTE]
+>  <xref:System.Windows.Forms.MenuStrip> と <xref:System.Windows.Forms.ContextMenuStrip> は、以前のバージョンの <xref:System.Windows.Forms.MainMenu> コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、<xref:System.Windows.Forms.MainMenu> および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ <xref:System.Windows.Forms.NotifyIcon> コンポーネントは、タスクバーの状態通知領域に 1 つのアイコンを表示します。  一般に、アプリケーションでは、このアイコンを右クリックすると、アイコンに対応するアプリケーションにコマンドを送信できるようになっています。  <xref:System.Windows.Forms.NotifyIcon> コンポーネントに <xref:System.Windows.Forms.ContextMenu> コンポーネントを関連付けると、この機能をアプリケーションに追加できます。  
+  
+> [!NOTE]
+>  起動時にアプリケーションを最小化し、<xref:System.Windows.Forms.NotifyIcon> コンポーネントのインスタンスをタスクバーに表示する場合は、メイン フォームの <xref:System.Windows.Forms.Form.WindowState%2A> プロパティを <xref:System.Windows.Forms.FormWindowState> に設定し、<xref:System.Windows.Forms.NotifyIcon> コンポーネントの <xref:System.Windows.Forms.NotifyIcon.Visible%2A> プロパティを必ず `true` に設定します。  
+  
+### デザイン時に、NotifyIcon コンポーネントにショートカット メニューを関連付けるには  
+  
+1.  フォームに <xref:System.Windows.Forms.NotifyIcon> コンポーネントを追加し、<xref:System.Windows.Forms.NotifyIcon.Icon%2A> や <xref:System.Windows.Forms.NotifyIcon.Visible%2A> などの重要なプロパティを設定します。  
+  
+     詳細については、「[方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する](../../../../docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md)」を参照してください。  
+  
+2.  Windows フォームに <xref:System.Windows.Forms.ContextMenu> コンポーネントを追加します。  
+  
+     実行時に使用できるようにするコマンドを表すメニュー項目をショートカット メニューに追加します。  ここで、メニュー項目にアクセス キーなどのメニュー機能拡張を追加することもできます。  
+  
+3.  追加したショートカット メニューに <xref:System.Windows.Forms.NotifyIcon> コンポーネントの <xref:System.Windows.Forms.NotifyIcon.ContextMenu%2A> プロパティを設定します。  
+  
+     このプロパティを設定すると、タスク バーのアイコンがクリックされたときにショートカット メニューが表示されるようになります。  
+  
+### プログラムで NotifyIcon コンポーネントにショートカット メニューを関連付けるには  
+  
+1.  アプリケーションに必要なすべてのプロパティ \(<xref:System.Windows.Forms.NotifyIcon> コンポーネントについて <xref:System.Windows.Forms.NotifyIcon.Icon%2A> プロパティと <xref:System.Windows.Forms.NotifyIcon.Visible%2A> プロパティ、<xref:System.Windows.Forms.ContextMenu> コンポーネントについてはメニュー項目\) を設定して <xref:System.Windows.Forms.NotifyIcon> クラスと <xref:System.Windows.Forms.ContextMenu> クラスのインスタンスを作成します。  
+  
+2.  追加したショートカット メニューに <xref:System.Windows.Forms.NotifyIcon> コンポーネントの <xref:System.Windows.Forms.NotifyIcon.ContextMenu%2A> プロパティを設定します。  
+  
+     このプロパティを設定すると、タスク バーのアイコンがクリックされたときにショートカット メニューが表示されるようになります。  
+  
+    > [!NOTE]
+    >  次のコード例では、基本的なメニュー構造を作成します。  配置するアプリケーションに合わせてメニューの選択肢をカスタマイズする必要があります。  さらに、これらのメニュー項目に対する <xref:System.Windows.Forms.MenuItem.Click> イベントを処理するコードも記述する必要があります。  
+  
+    ```vb  
+    Public ContextMenu1 As New ContextMenu  
+    Public NotifyIcon1 As New NotifyIcon  
+  
+    Public Sub CreateIconMenuStructure()  
+       ' Add menu items to shortcut menu.  
+       ContextMenu1.MenuItems.Add("&Open Application")  
+       ContextMenu1.MenuItems.Add("S&uspend Application")  
+       ContextMenu1.MenuItems.Add("E&xit")  
+  
+       ' Set properties of NotifyIcon component.  
+       NotifyIcon1.Icon = New System.Drawing.Icon _   
+          (System.Environment.GetFolderPath _   
+          (System.Environment.SpecialFolder.Personal)  _   
+          & "\Icon.ico")  
+       NotifyIcon1.Text = "Right-click me!"  
+       NotifyIcon1.Visible = True  
+       NotifyIcon1.ContextMenu = ContextMenu1  
+    End Sub  
+  
+    ```  
+  
+```csharp  
+public NotifyIcon notifyIcon1 = new NotifyIcon();  
+public ContextMenu contextMenu1 = new ContextMenu();  
+  
+public void createIconMenuStructure()  
+{  
+   // Add menu items to shortcut menu.  
+   contextMenu1.MenuItems.Add("&Open Application");  
+   contextMenu1.MenuItems.Add("S&uspend Application");  
+   contextMenu1.MenuItems.Add("E&xit");  
+  
+   // Set properties of NotifyIcon component.  
+   notifyIcon1.Icon = new System.Drawing.Icon  
+      (System.Environment.GetFolderPath  
+      (System.Environment.SpecialFolder.Personal)  
+      + @"\Icon.ico");  
+   notifyIcon1.Visible = true;  
+   notifyIcon1.Text = "Right-click me!";  
+   notifyIcon1.Visible = true;  
+   notifyIcon1.ContextMenu = contextMenu1;  
+}  
+  
+```  
+  
+```cpp  
+public:  
+   System::Windows::Forms::NotifyIcon ^ notifyIcon1;  
+   System::Windows::Forms::ContextMenu ^ contextMenu1;  
+  
+   void createIconMenuStructure()  
+   {  
+      // Add menu items to shortcut menu.  
+      contextMenu1->MenuItems->Add("&Open Application");  
+      contextMenu1->MenuItems->Add("S&uspend Application");  
+      contextMenu1->MenuItems->Add("E&xit");  
+  
+      // Set properties of NotifyIcon component.  
+      notifyIcon1->Icon = gcnew System::Drawing::Icon  
+          (String::Concat(System::Environment::GetFolderPath  
+          (System::Environment::SpecialFolder::Personal),  
+          "\\Icon.ico"));  
+      notifyIcon1->Text = "Right-click me!";  
+      notifyIcon1->Visible = true;  
+      notifyIcon1->ContextMenu = contextMenu1;  
+   }  
+```  
+  
+> [!NOTE]
+>  `notifyIcon1` と `contextMenu1,` を初期化する必要があります。そのためには、フォームのコンストラクターに次のステートメントを挿入します。  
+  
+```cpp  
+notifyIcon1 = gcnew System::Windows::Forms::NotifyIcon();  
+contextMenu1 = gcnew System::Windows::Forms::ContextMenu();  
+```  
+  
+## 参照  
+ <xref:System.Windows.Forms.NotifyIcon>   
+ <xref:System.Windows.Forms.NotifyIcon.Icon%2A>   
+ [方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する](../../../../docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md)   
+ [NotifyIcon コンポーネント](../../../../docs/framework/winforms/controls/notifyicon-component-windows-forms.md)   
+ [NotifyIcon コンポーネントの概要](../../../../docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treenode-using-the-designer.md b/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treenode-using-the-designer.md
new file mode 100644
index 00000000000..a482f188e0a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treenode-using-the-designer.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : デザイナーを使用して TreeNode にショートカット メニューを割り当てる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ショートカット メニュー, 接続 (TreeNodes に)"
+  - "TreeNode, 割り当て (ショートカット メニューをデザイナーを使用して)"
+ms.assetid: 8e45e184-1313-4f8f-90ff-2cd5789b2268
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : デザイナーを使用して TreeNode にショートカット メニューを割り当てる
+Windows フォーム <xref:System.Windows.Forms.TreeView> コントロールは、Windows オペレーティング システムの Windows エクスプローラーの左ペインに表示されるファイルとフォルダーと同様のノードの階層構造を表示します。  <xref:System.Windows.Forms.Control.ContextMenuStrip%2A> プロパティを設定すると、ユーザーは、<xref:System.Windows.Forms.TreeView> コントロールを右クリックしたときにコンテキストに従った操作を選択できます。  また、<xref:System.Windows.Forms.ContextMenuStrip> コンポーネントを個々の <xref:System.Windows.Forms.TreeNode> 項目に関連付けることによって、カスタマイズされたショートカット メニュー機能を <xref:System.Windows.Forms.TreeView> コントロールに追加できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時に、ショートカット メニューを TreeNode に関連付けるには  
+  
+1.  <xref:System.Windows.Forms.TreeView> コントロールをフォームに追加し、必要に応じて、<xref:System.Windows.Forms.TreeView> にノードを追加します。  詳細については、「[方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)」を参照してください。  
+  
+2.  <xref:System.Windows.Forms.ContextMenuStrip> コンポーネントをフォームに追加し、実行時に使用できるようにするノード レベルの操作を表すメニュー項目をショートカット メニューに追加します。  詳細については、「[方法 : メニュー項目を ContextMenuStrip に追加する](../../../../docs/framework/winforms/controls/how-to-add-menu-items-to-a-contextmenustrip.md)」を参照してください。  
+  
+3.  <xref:System.Windows.Forms.TreeView> コントロールの **\[TreeNode エディター\]** ダイアログ ボックスを再び開き、編集するノードを選択します。次に、追加したショートカット メニューに <xref:System.Windows.Forms.ContextMenuStrip> プロパティを設定します。  
+  
+4.  このプロパティを設定すると、ノードを右クリックしたときにショートカット メニューが表示されるようになります。  
+  
+     さらに、これらのメニュー項目に対する <xref:System.Windows.Forms.ToolStripItem.Click> イベントを処理するコードも記述する必要があります。  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [TreeView コントロールの概要](../../../../docs/framework/winforms/controls/treeview-control-overview-windows-forms.md)   
+ [ContextMenuStrip コントロール](../../../../docs/framework/winforms/controls/contextmenustrip-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treeview-node.md b/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treeview-node.md
new file mode 100644
index 00000000000..0d414e0721b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treeview-node.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : ショートカット メニューを TreeView ノードに追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ショートカット メニュー, 追加 (TreeView コントロールに)"
+  - "ツリー ノード (TreeView コントロールの), ショートカット メニュー"
+  - "TreeView コントロール [Windows フォーム], 追加 (ショートカット メニューを)"
+ms.assetid: a23c6752-fd8f-44ad-b781-bab37962fc7c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ショートカット メニューを TreeView ノードに追加する
+Windows フォーム <xref:System.Windows.Forms.TreeView> \(ツリー ビュー\) コントロールは、Windows エクスプローラーの左側のペインに表示されるファイルやフォルダーと同じような形式で、ノードを階層表示します。  <xref:System.Windows.Forms.Control.ContextMenuStrip%2A> プロパティを設定すると、ユーザーは、<xref:System.Windows.Forms.TreeView> コントロールを右クリックしたときにコンテキストに従った操作を選択できます。  また、<xref:System.Windows.Forms.ContextMenuStrip> コンポーネントを個々の <xref:System.Windows.Forms.TreeNode> 項目に関連付けることによって、カスタマイズされたショートカット メニュー機能を <xref:System.Windows.Forms.TreeView> コントロールに追加できます。  
+  
+### プログラムでショートカット メニューを TreeNode に関連付けるには  
+  
+1.  適切なプロパティ設定で <xref:System.Windows.Forms.TreeView> コントロールをインスタンス化し、ルート <xref:System.Windows.Forms.TreeNode> を作成し、サブノードを追加します。  
+  
+2.  <xref:System.Windows.Forms.ContextMenuStrip> コンポーネントをインスタンス化し、実行時に使用できるようにする各操作の <xref:System.Windows.Forms.ToolStripMenuItem> を追加します。  
+  
+3.  適切な <xref:System.Windows.Forms.TreeNode> の <xref:System.Windows.Forms.TreeNode.ContextMenuStrip%2A> プロパティを、作成するショートカットに設定します。  
+  
+4.  このプロパティを設定すると、ノードを右クリックしたときにショートカット メニューが表示されるようになります。  
+  
+ <xref:System.Windows.Forms.TreeView> のルート <xref:System.Windows.Forms.TreeNode> に関連付けられた、基本的な <xref:System.Windows.Forms.TreeView> と <xref:System.Windows.Forms.ContextMenuStrip> を作成するコード例を次に示します。  開発する <xref:System.Windows.Forms.TreeView> に合わせてメニューの選択肢をカスタマイズする必要があります。  さらに、これらのメニュー項目に対する <xref:System.Windows.Forms.ToolStripItem.Click> イベントを処理するコードも記述する必要があります。  
+  
+ [!code-cpp[System.Windows.Forms.TreeNodeContextMenuStrip#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/system.windows.forms.TreeNodeContextMenuStrip/cpp/Form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.TreeNodeContextMenuStrip#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/system.windows.forms.TreeNodeContextMenuStrip/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.TreeNodeContextMenuStrip#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/system.windows.forms.TreeNodeContextMenuStrip/VB/Form1.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-author-composite-controls.md b/docs/framework/winforms/controls/how-to-author-composite-controls.md
new file mode 100644
index 00000000000..79e66800611
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-author-composite-controls.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : 複合コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール, 作成"
+  - "ユーザー コントロール [Windows フォーム], 作成"
+  - "ユーザー コントロール [Windows フォーム], 継承"
+  - "UserControl クラス, 作成 (複合コントロールを)"
+ms.assetid: 79c9cf05-5ab6-4a18-886d-88a64748b098
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 複合コントロールを作成する
+複合コントロールはさまざまな方法で使用できます。  Windows デスクトップ アプリケーション プロジェクトの一部として作成し、そのプロジェクトのフォームでだけ使用することもできます。  また、Windows コントロール ライブラリ プロジェクトで作成し、プロジェクトをアセンブリにコンパイルして、コントロールを他のプロジェクトで使用することもできます。  さらに、そのコントロールから継承し、ビジュアル継承を使用して、特定の用途に合わせて簡単にカスタマイズすることもできます。  
+  
+> [!NOTE]
+>  Web フォームで使用する複合コントロールを作成する場合は、「[Developing Custom ASP.NET Server Controls](../Topic/Developing%20Custom%20ASP.NET%20Server%20Controls.md)」を参照してください。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 複合コントロールを作成するには  
+  
+1.  `DemoControlHost` という新しい **Windows アプリケーション** プロジェクトを開きます。  
+  
+2.  **\[プロジェクト\]** メニューの **\[ユーザー コントロールの追加\]** をクリックします。  
+  
+3.  **\[新しい項目の追加\]** ダイアログ ボックスで、クラス ファイル \(.vb ファイルまたは .cs ファイル\) に複合コントロールの名前を付けます。  
+  
+4.  **\[追加\]** をクリックして複合コントロールのクラス ファイルを作成します。  
+  
+5.  コントロールを**ツールボックス**から複合コントロール領域に追加します。  
+  
+6.  複合コントロールまたはその内在コントロールから発生したイベントを処理するために、イベント プロシージャにコードを記述します。  
+  
+7.  プロンプトが表示されたら、複合コントロールのデザイナーを閉じ、ファイルを保存します。  
+  
+8.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+     カスタム コントロールを**ツールボックス**に表示するには、プロジェクトをビルドする必要があります。  
+  
+9. **ツールボックス**の **\[DemoControlHost\]** タブを使用して、コントロールのインスタンスを `Form1` に追加します。  
+  
+### コントロール クラス ライブラリを作成するには  
+  
+1.  新しい **Windows コントロール ライブラリ** プロジェクトを開きます。  
+  
+     既定では、プロジェクトに複合コントロールが含まれています。  
+  
+2.  上記の手順に従って、コントロールおよびコードを追加します。  
+  
+3.  継承したクラスを変更しないコントロールを選択し、このコントロールの **Modifiers** プロパティを **Private** に設定します。  
+  
+4.  DLL をビルドします。  
+  
+### コントロール クラス ライブラリの複合コントロールから継承するには  
+  
+1.  **\[ファイル\]** メニューの **\[追加\]** をポイントし、**\[新しいプロジェクト\]** をクリックして新しい **Windows アプリケーション** プロジェクトをソリューションに追加します。  
+  
+2.  **ソリューション エクスプローラー**にある新しいプロジェクトの **\[参照設定\]** フォルダーを右クリックし、**\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを開きます。  
+  
+3.  **\[プロジェクト\]** タブをクリックし、コントロール ライブラリ プロジェクトをダブルクリックします。  
+  
+4.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+5.  **ソリューション エクスプローラー**でコントロール ライブラリ プロジェクトを右クリックし、ショートカット メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+6.  **\[新しい項目の追加\]** ダイアログ ボックスの **\[継承されたユーザー コントロール\]** テンプレートをクリックします。  
+  
+7.  **\[新しい項目の追加\]** ダイアログ ボックスで、継承するコントロールをダブルクリックします。  
+  
+     新しいコントロールがプロジェクトに追加されます。  
+  
+8.  新しいコントロールのビジュアル デザイナーを開き、必要な内在コントロールを追加します。  
+  
+     DLL の複合コントロールから継承された内在コントロールが表示され、**Modifiers** プロパティが **Public** であるコントロールのプロパティを変更できます。  **Modifiers** プロパティが **Private** であるコントロールについては、プロパティを変更できません。  
+  
+## 参照  
+ [チュートリアル : Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)   
+ [チュートリアル : Visual C\# による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md)   
+ [チュートリアル : Visual Basic による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md)   
+ [チュートリアル : Visual C\# による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md)   
+ [コントロールの種類に関するアドバイス](../../../../docs/framework/winforms/controls/control-type-recommendations.md)   
+ [方法 : Windows フォームのコントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md b/docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md
new file mode 100644
index 00000000000..8c5016c2258
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : Windows フォームのコントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 作成"
+  - "カスタム コントロール [Windows フォーム], 作成"
+  - "UserControl クラス, Windows フォーム"
+ms.assetid: 7570e982-545b-4c3a-a7c7-55581d313400
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームのコントロールを作成する
+コントロールは、ユーザーとプログラムの間のグラフィカルなリンクとして機能します。  コントロールには、データの提供や処理、ユーザー入力の受け付け、イベントへの応答など、ユーザーとアプリケーションを結び付けるさまざまな機能があります。  コントロールは、本質的には、グラフィカル インターフェイスを持つコンポーネントです。このため、ユーザーとプログラムの間のやり取りを処理するだけでなく、コンポーネントが実行するすべての機能も備えています。  コントロールは特定の目的のために作成されたもので、プログラミング作業の一部としてコントロールを作成します。  これを踏まえたコントロールの作成手順の概要を以下に示します。  各手順に関連するトピックへのリンクもあります。  
+  
+> [!NOTE]
+>  Web フォームで使用するカスタム コントロールを作成する場合は、「[Developing Custom ASP.NET Server Controls](../Topic/Developing%20Custom%20ASP.NET%20Server%20Controls.md)」を参照してください。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールを作成するには  
+  
+1.  コントロールの目的、またはアプリケーションにおけるコントロールの役割を決定します。  次の点を考慮します。  
+  
+    -   どのようなグラフィカル インターフェイスが必要か。  
+  
+    -   ユーザーとコントロールの間のどのようなやり取りを処理するか。  
+  
+    -   必要な機能を持つ既存のコントロールがあるか。  
+  
+    -   いくつかの Windows フォーム コントロールを組み合わせることで必要な機能が得られるか。  
+  
+2.  コントロールのオブジェクト モデルが必要な場合は、オブジェクト モデルで機能を分散する方法を決定し、コントロールとサブオブジェクトの間で機能を分割します。  オブジェクト モデルは、複雑なコントロールをプランニングする場合や、いくつかの機能を含める場合などに役立ちます。  
+  
+3.  必要なコントロールの種類 \(ユーザー コントロール、カスタム コントロール、継承された Windows フォーム コントロールなど\) を決定します。  詳細については、「[コントロールの種類に関するアドバイス](../../../../docs/framework/winforms/controls/control-type-recommendations.md)」および「[さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)」を参照してください。  
+  
+4.  必要な機能をコントロール \(およびそのサブオブジェクトまたは下位構造\) のプロパティ、メソッド、およびイベントとして表現し、適切なアクセス レベル \(パブリックやプロテクトなど\) を割り当てます。  
+  
+5.  コントロールにカスタム描画が必要な場合は、そのためのコードを追加します。  詳細については、「[コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)」を参照してください。  
+  
+6.  コントロールが <xref:System.Windows.Forms.UserControl> を継承している場合、コントロール プロジェクトをビルドし、**UserControl テスト コンテナー**で実行することによって、コントロールの実行時の動作をテストできます。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+7.  また、Windows アプリケーションなどの新しいプロジェクトを作成し、コンテナー内に配置することで、コントロールをテストしてデバッグすることもできます。  この処理については、「[チュートリアル : Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)」で説明します。  
+  
+8.  機能を追加するごとに、新しい機能を実行するための機能をテスト プロジェクトに追加します。  
+  
+9. テストを繰り返して、デザインを微調整します。  
+  
+10. コントロールをパッケージ化して配置します。  詳細については、「[アプリケーション、サービス、およびコンポーネントの配置](../Topic/Deploying%20Applications,%20Services,%20and%20Components.md)」を参照してください。  
+  
+## 参照  
+ [チュートリアル : Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)   
+ [チュートリアル : Visual Basic による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md)   
+ [方法 : UserControl クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md)   
+ [方法 : コントロール クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md)   
+ [方法 : 既存の Windows フォーム コントロールから継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md)   
+ [方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md
new file mode 100644
index 00000000000..082e47fe8e4
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, コンボ ボックス"
+  - "コンボ ボックス, データ バインド"
+  - "ComboBox コントロール [Windows フォーム], データ バインド"
+  - "データ [Windows フォーム], バインド (コントロールに)"
+  - "データ バインド, コンボ ボックス"
+  - "データ バインド コントロール, Windows フォーム"
+  - "リスト ボックス, データ バインド"
+  - "ListBox コントロール [Windows フォーム], データ バインド"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: dfd7f081-8bea-4a41-86a3-86a1934828ef
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする 
+<xref:System.Windows.Forms.ComboBox> および <xref:System.Windows.Forms.ListBox> をデータにバインドすると、データベースのデータの参照、新しいデータの入力、既存のデータの編集などのタスクを実行できます。  
+  
+### ComboBox コントロールまたは ListBox コントロールをデータ連結するには  
+  
+1.  `DataSource`  プロパティをデータ ソース オブジェクトに設定します。  使用できるデータ ソースには、データにバインドされた <xref:System.Windows.Forms.BindingSource>、データ テーブル、データ ビュー、データセット、データ ビュー マネージャー、配列、または <xref:System.Collections.IList> インターフェイスを実装するクラスがあります。  詳細については、「[Windows フォームがサポートするデータ ソース](../../../../docs/framework/winforms/data-sources-supported-by-windows-forms.md)」を参照してください。  
+  
+2.  テーブルにバインドする場合は、`DisplayMember`  プロパティをデータ ソースの列の名前に設定します。  
+  
+     または  
+  
+     <xref:System.Collections.IList> にバインドする場合は、表示メンバーを、リスト内の型のパブリック プロパティに設定します。  
+  
+    ```vb  
+    Private Sub BindComboBox()  
+      ComboBox1.DataSource = DataSet1.Tables("Suppliers")  
+      ComboBox1.DisplayMember = "ProductName"  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void BindComboBox()  
+    {  
+      comboBox1.DataSource = dataSet1.Tables["Suppliers"];  
+      comboBox1.DisplayMember = "ProductName";  
+    }  
+  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.IBindingList> インターフェイスを実装しないデータ ソース \(<xref:System.Collections.ArrayList> オブジェクトなど\) にバインドされている場合、データ ソースが更新されても、バインドされているコントロールのデータは更新されません。  たとえば、コンボ ボックスが <xref:System.Collections.ArrayList> オブジェクトにバインドされている場合は、<xref:System.Collections.ArrayList> にデータが追加されても、コンボ ボックスに新しい項目は表示されません。  ただし、コントロールがバインドされている <xref:System.Windows.Forms.BindingContext> クラスのインスタンスの <xref:System.Windows.Forms.BindingManagerBase.SuspendBinding%2A> メソッドおよび <xref:System.Windows.Forms.BindingManagerBase.ResumeBinding%2A> メソッドを呼び出すことによって、コンボ ボックスを強制的に更新できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ <xref:System.Windows.Forms.ListBox>   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [データ連結と Windows フォーム](../../../../docs/framework/winforms/data-binding-and-windows-forms.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-factory-object.md b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-factory-object.md
new file mode 100644
index 00000000000..893226cf89b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-factory-object.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : Windows フォーム コントロールをファクトリ オブジェクトにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (ファクトリ オブジェクトに)"
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "コントロール [Windows フォーム], バインド"
+  - "ファクトリ オブジェクト, バインド"
+ms.assetid: 7d59af89-ff82-41d8-a48a-f1fbae788b0d
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム コントロールをファクトリ オブジェクトにバインドする
+データをやり取りするコントロールを作成している際に、他のオブジェクトを生成するオブジェクトやメソッドにコントロールをバインドすることが必要な場合があります。  このようなオブジェクトやメソッドは、ファクトリと呼ばれます。  たとえば、データ ソースがメモリまたは型内のオブジェクトではなく、メソッドの呼び出しからの戻り値の場合があります。  ソースがコレクションを返す限り、コントロールをこの種類のデータ ソースにバインドできます。  
+  
+ <xref:System.Windows.Forms.BindingSource> コントロールを使用して、コントロールをファクトリ オブジェクトに簡単にバインドすることができます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Forms.BindingSource> コントロールを使用して、<xref:System.Windows.Forms.DataGridView> コントロールをファクトリ メソッドにバインドする方法を示します。  ファクトリ メソッドの名前は `GetOrdersByCustomerId` であり、Northwind データベースで、特定の顧客のすべての注文を返します。  
+  
+ [!code-cpp[System.Windows.Forms.DataConnector.BindToFactory#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.BindToFactory/CPP/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.DataConnector.BindToFactory#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.BindToFactory/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnector.BindToFactory#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.BindToFactory/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type-using-the-designer.md b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type-using-the-designer.md
new file mode 100644
index 00000000000..1aaa43024bb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type-using-the-designer.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム コントロールを型にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (型への)"
+  - "コントロール [Windows フォーム], バインド (型への)"
+  - "型 [Windows フォーム], バインド (コントロールを)"
+ms.assetid: 5ab984b5-c2d0-4638-a572-1c84013e8746
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : デザイナーを使って Windows フォーム コントロールを型にバインドする
+データとやり取りするコントロールをビルドする場合、オブジェクトではなく、型にコントロールをバインドしなければならないときがあります。  データを使用できない可能性はあるが、それでもデータ バインド コントロールに型のパブリック インターフェイスからのデータを表示することが必要な場合、通常はデザイン時にコントロールを型にバインドする必要があります。  次の手順は、型にバインドされる新しい <xref:System.Windows.Forms.BindingSource> を作成し、型のプロパティの 1 つを <xref:System.Windows.Forms.TextBox> の <xref:System.Windows.Forms.TextBox.Text%2A> プロパティにバインドする方法を示しています。  
+  
+### BindingSource を型にバインドするには  
+  
+1.  Windows フォーム プロジェクトを作成します。  
+  
+     詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **デザイン** ビューから、フォームに <xref:System.Windows.Forms.BindingSource> コンポーネントをドラッグします。  
+  
+3.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティの矢印をクリックします。  
+  
+4.  **DataSource UI 型エディター**の **\[プロジェクト データ ソースの追加\]** をクリックします。  
+  
+5.  **\[データ ソースの種類を選択\]** ページで、**\[オブジェクト\]** を選択し、**\[次へ\]** をクリックします。  
+  
+6.  バインド先の型を選択します。  
+  
+    -   バインド先の型が現在のプロジェクトの中にある場合、またはその型を含むアセンブリが既に参照として追加されている場合は、ノードを展開して目的の型を見つけ、選択します。  
+  
+         または  
+  
+    -   バインド先の型が別のアセンブリにあり、現在は参照のリストに含まれていない場合は、**\[参照の追加\]** をクリックし、**\[プロジェクト\]** タブをクリックします。  使用するビジネス オブジェクトが含まれるプロジェクトを選択し、**\[OK\]** をクリックします。  このプロジェクトがアセンブリのリストに表示されるので、ノードを展開して目的の型を見つけ、選択できます。  
+  
+        > [!NOTE]
+        >  フレームワークまたは Microsoft アセンブリにある型にバインドする場合は、**\[Microsoft または System で始まるアセンブリを表示しない\]** チェック ボックスをオフにします。  
+  
+7.  **\[次へ\]** をクリックし、**\[完了\]** をクリックします。  
+  
+### コントロールを BindingSource にバインドするには  
+  
+1.  フォームに <xref:System.Windows.Forms.TextBox> を追加します。  
+  
+2.  **\[プロパティ\]** ウィンドウで **\[\(DataBindings\)\]** ノードを展開します。  
+  
+3.  <xref:System.Windows.Forms.TextBox.Text%2A> プロパティの横にある矢印をクリックします。  
+  
+4.  **DataSource UI 型エディター**で、前の手順で追加した <xref:System.Windows.Forms.BindingSource> のノードを展開し、<xref:System.Windows.Forms.TextBox> の <xref:System.Windows.Forms.TextBox.Text%2A> プロパティにバインドする型のプロパティを選択します。  
+  
+## 参照  
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)   
+ [Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md
new file mode 100644
index 00000000000..45ff16f07f7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : Windows フォーム コントロールを型にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (型への)"
+  - "コントロール [Windows フォーム], バインド (型への)"
+  - "型 [Windows フォーム], バインド (コントロールを)"
+ms.assetid: 94faeebb-d2bc-45d6-86d7-96a42661b43d
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォーム コントロールを型にバインドする
+データをやり取りするコントロールを作成する際、オブジェクトではなく型にコントロールをバインドすることが必要な場合があります。  このような状況は、特にデータを使用できないデザイン時に発生しますが、データ バインド コントロールは、型のパブリック インターフェイスから情報を表示する必要があります。  たとえば、<xref:System.Windows.Forms.DataGridView> コントロールを Web サービスによって公開されているオブジェクトにバインドし、デザイン時に <xref:System.Windows.Forms.DataGridView> コントロールで列にカスタム型のメンバー名のラベルを付けたいときがあります。  
+  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、コントロールを型に簡単にバインドできます。  
+  
+## 使用例  
+ 次のサンプル コードは、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、<xref:System.Windows.Forms.DataGridView> コントロールをカスタム型にバインドする方法を示します。  例を実行すると、コントロールにデータを設定する前に、<xref:System.Windows.Forms.DataGridView> に `Customer` オブジェクトのプロパティを反映するラベルが付いた列があることに気付きます。  この例には、データを <xref:System.Windows.Forms.DataGridView> コントロールに追加する \[顧客の追加\] ボタンがあります。  ボタンをクリックすると、新しい `Customer` オブジェクトが <xref:System.Windows.Forms.BindingSource> に追加されます。  実際のシナリオでは、Web サービスまたはその他のデータ ソースへの呼び出しにより、データを取得する可能性があります。  
+  
+ [!code-csharp[System.Windows.Forms.DataConnector.BindingToType#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.BindingToType/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnector.BindingToType#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.BindingToType/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-data-to-the-maskedtextbox-control.md b/docs/framework/winforms/controls/how-to-bind-data-to-the-maskedtextbox-control.md
new file mode 100644
index 00000000000..401ed7d669f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-data-to-the-maskedtextbox-control.md
@@ -0,0 +1,258 @@
+---
+title: "方法 : MaskedTextBox コントロールにデータをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ バインド, MaskedTextBox コントロール [Windows フォーム]"
+  - "MaskedTextBox コントロール [Windows フォーム]"
+  - "MaskedTextBox コントロール [Windows フォーム], バインド (データを)"
+ms.assetid: 34b29f07-e8df-48d4-b08b-53fcca524708
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : MaskedTextBox コントロールにデータをバインドする
+他の Windows フォーム コントロールと同様に、<xref:System.Windows.Forms.MaskedTextBox> コントロールにデータをバインドできます。  ただし、データベース内のデータの形式がマスクで定義された形式と一致しない場合は、データの形式を設定し直す必要があります。  次の手順は、<xref:System.Windows.Forms.Binding> クラスの <xref:System.Windows.Forms.Binding.Format> イベントと <xref:System.Windows.Forms.Binding.Parse> イベントを使用してこれを行い、別々の電話番号データベース フィールドと内線番号データベース フィールドを 1 つの編集可能フィールドとして表示する方法を示しています。  
+  
+ 次の手順を行うには、Northwind サンプル データベースをインストールした SQL Server データベースへのアクセスが必要です。  
+  
+### MaskedTextBox コントロールにデータをバインドするには  
+  
+1.  新しい Windows フォーム プロジェクトを作成します。  
+  
+2.  2 つの <xref:System.Windows.Forms.TextBox> コントロールをフォームにドラッグし、それぞれを `FirstName` と `LastName` と名付けます。  
+  
+3.  <xref:System.Windows.Forms.MaskedTextBox> コントロールをフォームにドラッグし、`PhoneMask` と名付けます。  
+  
+4.  `PhoneMask` の <xref:System.Windows.Forms.MaskedTextBox.Mask%2A> プロパティを `(000) 000-0000 x9999` に設定します。  
+  
+5.  次の名前空間のインポートをフォームに追加します。  
+  
+    ```csharp  
+    using System.Data.SqlClient;  
+    ```  
+  
+    ```vb  
+    Imports System.Data.SqlClient  
+    ```  
+  
+6.  フォームを右クリックし、**\[コードの表示\]** をクリックします。  このコードをフォーム クラスのどこかに配置します。  
+  
+    ```csharp  
+    Binding currentBinding, phoneBinding;  
+    DataSet employeesTable = new DataSet();  
+    SqlConnection sc;  
+    SqlDataAdapter dataConnect;  
+  
+    private void Form1_Load(object sender, EventArgs e)  
+    {  
+        DoMaskBinding();  
+    }  
+  
+    private void DoMaskBinding()  
+    {  
+        try  
+        {  
+            sc = new SqlConnection("Data Source=CLIENTUE;Initial Catalog=NORTHWIND;Integrated Security=SSPI");  
+            sc.Open();  
+        }  
+        catch (Exception ex)  
+        {  
+            MessageBox.Show(ex.Message);  
+            return;  
+        }  
+  
+        dataConnect = new SqlDataAdapter("SELECT * FROM Employees", sc);  
+        dataConnect.Fill(employeesTable, "Employees");  
+  
+        // Now bind MaskedTextBox to appropriate field. Note that we must create the Binding objects  
+        // before adding them to the control - otherwise, we won't get a Format event on the   
+        // initial load.   
+        try  
+        {  
+            currentBinding = new Binding("Text", employeesTable, "Employees.FirstName");  
+            firstName.DataBindings.Add(currentBinding);  
+  
+            currentBinding = new Binding("Text", employeesTable, "Employees.LastName");  
+            lastName.DataBindings.Add(currentBinding);  
+  
+            phoneBinding =new Binding("Text", employeesTable, "Employees.HomePhone");  
+            // We must add the event handlers before we bind, or the Format event will not get called  
+            // for the first record.  
+            phoneBinding.Format += new ConvertEventHandler(phoneBinding_Format);  
+            phoneBinding.Parse += new ConvertEventHandler(phoneBinding_Parse);  
+            phoneMask.DataBindings.Add(phoneBinding);  
+        }  
+        catch (Exception ex)  
+        {  
+            MessageBox.Show(ex.Message);  
+            return;  
+        }  
+    }  
+    ```  
+  
+    ```vb  
+    Dim WithEvents CurrentBinding, PhoneBinding As Binding  
+    Dim EmployeesTable As New DataSet()  
+    Dim sc As SqlConnection  
+    Dim DataConnect As SqlDataAdapter  
+  
+    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load  
+        DoMaskedBinding()  
+    End Sub  
+  
+    Private Sub DoMaskedBinding()  
+        Try  
+            sc = New SqlConnection("Data Source=SERVERNAME;Initial Catalog=NORTHWIND;Integrated Security=SSPI")  
+            sc.Open()  
+        Catch ex As Exception  
+            MessageBox.Show(ex.Message)  
+            Exit Sub  
+        End Try  
+  
+        DataConnect = New SqlDataAdapter("SELECT * FROM Employees", sc)  
+        DataConnect.Fill(EmployeesTable, "Employees")  
+  
+        ' Now bind MaskedTextBox to appropriate field. Note that we must create the Binding objects  
+        ' before adding them to the control - otherwise, we won't get a Format event on the   
+        ' initial load.  
+        Try  
+            CurrentBinding = New Binding("Text", EmployeesTable, "Employees.FirstName")  
+            firstName.DataBindings.Add(CurrentBinding)  
+            CurrentBinding = New Binding("Text", EmployeesTable, "Employees.LastName")  
+            lastName.DataBindings.Add(CurrentBinding)  
+            PhoneBinding = New Binding("Text", EmployeesTable, "Employees.HomePhone")  
+            PhoneMask.DataBindings.Add(PhoneBinding)  
+        Catch ex As Exception  
+            MessageBox.Show(ex.Message)  
+            Application.Exit()  
+        End Try  
+    End Sub  
+    ```  
+  
+7.  <xref:System.Windows.Forms.Binding.Format> イベントと <xref:System.Windows.Forms.Binding.Parse> イベントのイベント ハンドラーを追加します。これらのイベント ハンドラーで、バインドされている <xref:System.Data.DataSet> の `PhoneNumber` フィールドと `Extension` フィールドを組み合わせて区切り文字を挿入します。  
+  
+    ```csharp  
+    private void phoneBinding_Format(Object sender, ConvertEventArgs e)  
+    {  
+        String ext;  
+  
+        DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;  
+        if (currentRow["Extension"] == null)   
+        {  
+            ext = "";  
+        } else   
+        {  
+            ext = currentRow["Extension"].ToString();  
+        }  
+  
+        e.Value = e.Value.ToString().Trim() + " x" + ext;  
+    }  
+  
+    private void phoneBinding_Parse(Object sender, ConvertEventArgs e)  
+    {  
+        String phoneNumberAndExt = e.Value.ToString();  
+  
+        int extIndex = phoneNumberAndExt.IndexOf("x");  
+        String ext = phoneNumberAndExt.Substring(extIndex).Trim();  
+        String phoneNumber = phoneNumberAndExt.Substring(0, extIndex).Trim();  
+  
+        //Get the current binding object, and set the new extension manually.   
+        DataRowView currentRow = (DataRowView)BindingContext[employeesTable, "Employees"].Current;  
+        // Remove the "x" from the extension.  
+        currentRow["Extension"] = ext.Substring(1);  
+  
+        //Return the phone number.  
+        e.Value = phoneNumber;  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub PhoneBinding_Format(ByVal sender As Object, ByVal e As ConvertEventArgs) Handles PhoneBinding.Format  
+        Dim Ext As String  
+  
+        Dim CurrentRow As DataRowView = CType(Me.BindingContext(EmployeesTable, "Employees").Current, DataRowView)  
+        If (CurrentRow("Extension") Is Nothing) Then  
+            Ext = ""  
+        Else  
+            Ext = CurrentRow("Extension").ToString()  
+        End If  
+  
+        e.Value = e.Value.ToString().Trim() & " x" & Ext  
+    End Sub  
+  
+    Private Sub PhoneBinding_Parse(ByVal sender As Object, ByVal e As ConvertEventArgs) Handles PhoneBinding.Parse  
+        Dim PhoneNumberAndExt As String = e.Value.ToString()  
+  
+        Dim ExtIndex As Integer = PhoneNumberAndExt.IndexOf("x")  
+        Dim Ext As String = PhoneNumberAndExt.Substring(ExtIndex).Trim()  
+        Dim PhoneNumber As String = PhoneNumberAndExt.Substring(0, ExtIndex).Trim()  
+  
+        ' Get the current binding object, and set the new extension manually.   
+        Dim CurrentRow As DataRowView = CType(Me.BindingContext(EmployeesTable, "Employees").Current, DataRowView)  
+        ' Remove the "x" from the extension.  
+        CurrentRow("Extension") = CObj(Ext.Substring(1))  
+  
+        ' Return the phone number.  
+        e.Value = PhoneNumber  
+    End Sub  
+    ```  
+  
+8.  2 つの <xref:System.Windows.Forms.Button> コントロールをフォームに追加します。  それぞれに `previousButton` と `nextButton` という名前を付けます。  各ボタンをダブルクリックして <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを追加し、次のコード例に示すようにイベント ハンドラーの内容を記述します。  
+  
+    ```csharp  
+    private void previousButton_Click(object sender, EventArgs e)  
+    {  
+        BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position - 1;  
+    }  
+  
+    private void nextButton_Click(object sender, EventArgs e)  
+    {  
+        BindingContext[employeesTable, "Employees"].Position = BindingContext[employeesTable, "Employees"].Position + 1;  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub PreviousButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles PreviousButton.Click  
+        Me.BindingContext(EmployeesTable, "Employees").Position = Me.BindingContext(EmployeesTable, "Employees").Position - 1  
+    End Sub  
+  
+    Private Sub NextButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles NextButton.Click  
+        Me.BindingContext(EmployeesTable, "Employees").Position = Me.BindingContext(EmployeesTable, "Employees").Position + 1  
+    End Sub  
+    ```  
+  
+9. サンプルを実行します。  データを編集し、**\[Previous\]** ボタンと **\[Next\]** ボタンを使用して、データが <xref:System.Data.DataSet> と正しく連動していることを確認します。  
+  
+## 使用例  
+ 次のコード例は、前述の手順をすべて行った後の完全なコード リストです。  
+  
+ [!code-cpp[MaskedTextBoxData#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/MaskedTextBoxData/cpp/form1.cpp#1)]
+ [!code-csharp[MaskedTextBoxData#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/MaskedTextBoxData/CS/form1.cs#1)]
+ [!code-vb[MaskedTextBoxData#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/MaskedTextBoxData/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] または [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] プロジェクトを作成します。  
+  
+-   前述の手順の説明どおりに、<xref:System.Windows.Forms.TextBox> コントロールと <xref:System.Windows.Forms.MaskedTextBox> コントロールをフォームに追加します。  
+  
+-   プロジェクトの既定のフォームのソース コード ファイルを開きます。  
+  
+-   このファイル内のソース コードを前述の「使用例」に示したコードで置き換えます。  
+  
+-   アプリケーションをコンパイルします。  
+  
+## 参照  
+ [チュートリアル : MaskedTextBox コントロールの使用](../../../../docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..fff94688458
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : データを Windows フォーム DataGridView コントロールにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ バインド, DataGridView コントロール"
+  - "データ バインド, グリッド"
+  - "DataGridView コントロール [Windows フォーム], データ バインド"
+ms.assetid: 1660f69c-5711-45d2-abc1-e25bc6779124
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# 方法 : データを Windows フォーム DataGridView コントロールにバインドする
+<xref:System.Windows.Forms.DataGridView> コントロールは標準 Windows フォームのデータ バインディング モデルをサポートするため、各種のデータ ソースにバインドします。  ただし、ほとんどの状況では、データ ソースとの対話の詳細を管理する <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドします。  <xref:System.Windows.Forms.BindingSource> コンポーネントは Windows フォームのデータ ソースを表すことができ、データの場所を選択または変更するときに、優れた柔軟性を提供します。  <xref:System.Windows.Forms.DataGridView> コントロールでサポートされているデータ ソースの詳細については、「[DataGridView コントロールの概要](../../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)」を参照してください。  
+  
+ Visual Studio では、このタスクに対する広範なサポートが用意されています。  「[方法 : デザイナーを使用してデータを Windows フォーム DataGridView コントロールにバインドする](http://msdn.microsoft.com/library/33w255ac\(v=vs.110\))」も参照してください。  
+  
+## プロシージャ  
+  
+#### DataGridView コントロールをデータに接続するには  
+  
+1.  データベースからデータを取得する操作の詳細を処理するメソッドを実装します。  次のコード例では、<xref:System.Data.SqlClient.SqlDataAdapter> コンポーネントを初期化する `GetData` メソッドを実装し、これを使用して <xref:System.Data.DataTable> に値を設定します。  次に、<xref:System.Data.DataTable> が <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドされます。  `connectionString` 変数は、使用しているデータベースに合った値に設定してください。  Northwind SQL Server サンプル データベースがインストールされているサーバーにアクセスする必要があります。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridViewBoundEditable#20](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/cpp/datagridviewboundeditable.cpp#20)]
+     [!code-csharp[System.Windows.Forms.DataGridViewBoundEditable#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/CS/datagridviewboundeditable.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewBoundEditable#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/VB/datagridviewboundeditable.vb#20)]  
+  
+2.  フォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラーで、<xref:System.Windows.Forms.DataGridView> コントロールを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドし、`GetData` メソッドを呼び出してデータベースからデータを取得します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridViewBoundEditable#10](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/cpp/datagridviewboundeditable.cpp#10)]
+     [!code-csharp[System.Windows.Forms.DataGridViewBoundEditable#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/CS/datagridviewboundeditable.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewBoundEditable#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/VB/datagridviewboundeditable.vb#10)]  
+  
+## 使用例  
+ 次の完全なコード例では、データベースからデータを再読み込みし、データベースに変更を送信するためのボタンを提供します。  
+  
+ [!code-cpp[System.Windows.Forms.DataGridViewBoundEditable#00](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/cpp/datagridviewboundeditable.cpp#00)]
+ [!code-csharp[System.Windows.Forms.DataGridViewBoundEditable#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/CS/datagridviewboundeditable.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewBoundEditable#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewBoundEditable/VB/datagridviewboundeditable.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Windows.Forms、System.Data、および System.XML の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## .NET Framework セキュリティ  
+ 接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.DataSource%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md b/docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md
new file mode 100644
index 00000000000..c4abeb6e28e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-objects-to-windows-forms-datagridview-controls.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, オブジェクトのバインディング"
+  - "DataGridView コントロール [Windows フォーム], オブジェクトのバインディング"
+  - "オブジェクトのバインディング, DataGridView コントロール"
+ms.assetid: cb8f29fa-577e-4e2b-883f-3a01c6189b9c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : オブジェクトを Windows フォーム DataGridView コントロールにバインドする
+各オブジェクトが別々の行として表示されるように <xref:System.Windows.Forms.DataGridView> コントロールにオブジェクトのコレクションをバインドする方法を次のコード例に示します。  また、この例では、<xref:System.Windows.Forms.DataGridViewComboBoxColumn> にプロパティとして列挙型を表示し、コンボ ボックスのドロップダウン リストに列挙値が含まれるようにする方法も示されています。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridView._CollectionBound#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView._CollectionBound/CS/collectionbound.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridView._CollectionBound#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView._CollectionBound/VB/collectionbound.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォームの DataGridView 行にバインドされたオブジェクトにアクセスする](../../../../docs/framework/winforms/controls/how-to-access-objects-bound-to-windows-forms-datagridview-rows.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md b/docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md
new file mode 100644
index 00000000000..9047b8845e6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md
@@ -0,0 +1,123 @@
+---
+title: "方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール"
+  - "バインド コントロール, DataGrid コントロール"
+  - "データ バインド, DataGrid コントロール"
+  - "データ バインド コントロール, DataGrid"
+  - "DataGrid コントロール [Windows フォーム], データ バインド"
+  - "データセット [Windows フォーム], バインド (DataGrid コントロールに)"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: 128cdb07-dfd3-4d60-9d6a-902847667c36
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロールは、データ ソースの情報を表示するようにデザインされています。  実行時には <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを呼び出してコントロールをバインドします。  各種データ ソースのデータを表示できますが、最も一般的なソースはデータセットとデータ ビューです。  
+  
+### プログラムによって DataGrid コントロールをデータ連結するには  
+  
+1.  データセットにデータを読み込むコードを記述します。  
+  
+     データ ソースが、データセット テーブルに基づくデータセットまたはデー タビューの場合は、そのデータセットにデータを読み込むためのコードをフォームに追加します。  
+  
+     実際に使用するコードは、データセットがデータをどこで取得するかに依存します。  データセットにデータベースのデータを直接読み込む場合は、通常はデータ アダプターの `Fill`  メソッドを呼び出します。次の例では、`DsCategories1` というデータセットにデータを読み込んでいます。  
+  
+    ```vb  
+    sqlDataAdapter1.Fill(DsCategories1)  
+  
+    ```  
+  
+    ```csharp  
+    sqlDataAdapter1.Fill(DsCategories1);  
+  
+    ```  
+  
+    ```cpp  
+    sqlDataAdapter1->Fill(dsCategories1);  
+    ```  
+  
+     XML Web サービスのデータをデータセットに読み込む場合は、通常、サービスのインスタンスを作成するコードを記述し、データセットを返すメソッドのいずれかを呼び出します。  その後、XML Web サービスからのデータセットをローカルのデータセットにマージします。  次の例は、`CategoriesService` という XML Web サービスのインスタンスを作成し、その `GetCategories` メソッドを呼び出し、結果のデータセットを `DsCategories1` というローカル データセットにマージする方法を示します。  
+  
+    ```vb  
+    Dim ws As New MyProject.localhost.CategoriesService()  
+    ws.Credentials = System.Net.CredentialCache.DefaultCredentials  
+    DsCategories1.Merge(ws.GetCategories())  
+  
+    ```  
+  
+    ```csharp  
+    MyProject.localhost.CategoriesService ws = new MyProject.localhost.CategoriesService();  
+    ws.Credentials = System.Net.CredentialCache.DefaultCredentials;  
+    DsCategories1.Merge(ws.GetCategories());  
+  
+    ```  
+  
+    ```cpp  
+    MyProject::localhost::CategoriesService^ ws =   
+       new MyProject::localhost::CategoriesService();  
+    ws->Credentials = System::Net::CredentialCache::DefaultCredentials;  
+    dsCategories1->Merge(ws->GetCategories());  
+    ```  
+  
+2.  データ ソースとデータ メンバーを引数として、<xref:System.Windows.Forms.DataGrid> コントロールの <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを呼び出します。  データ メンバーを明示的に渡す必要がない場合は、空の文字列を渡します。  
+  
+    > [!NOTE]
+    >  グリッドのバインドを初めて実行する場合は、このコントロールの <xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティおよび <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティを設定できます。  ただし、これらのプロパティは、一度設定するとリセットできません。  したがって、常に <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用することをお勧めします。  
+  
+     次の例は、プログラムで `DsCustomers1` というデータセットの Customers テーブルにバインドする方法を示しています。  
+  
+    ```vb  
+    DataGrid1.SetDataBinding(DsCustomers1, "Customers")  
+  
+    ```  
+  
+    ```csharp  
+    DataGrid1.SetDataBinding(DsCustomers1, "Customers");  
+  
+    ```  
+  
+    ```cpp  
+    dataGrid1->SetDataBinding(dsCustomers1, "Customers");  
+    ```  
+  
+     データセットに Customers テーブル以外のテーブルが存在しない場合は、代わりに次の方法でグリッドを連結できます。  
+  
+    ```vb  
+    DataGrid1.SetDataBinding(DsCustomers1, "")  
+  
+    ```  
+  
+    ```csharp  
+    DataGrid1.SetDataBinding(DsCustomers1, "");  
+  
+    ```  
+  
+    ```cpp  
+    dataGrid1->SetDataBinding(dsCustomers1, "");  
+    ```  
+  
+3.  \(必要に応じて\) 適切なテーブル スタイルと列スタイルをグリッドに追加します。  テーブル スタイルがなくてもテーブルを表示できますが、その場合は最低限の書式だけが適用され、すべての列が表示されます。  
+  
+## 参照  
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-to-a-web-service-using-the-windows-forms-bindingsource.md b/docs/framework/winforms/controls/how-to-bind-to-a-web-service-using-the-windows-forms-bindingsource.md
new file mode 100644
index 00000000000..3921d7413f1
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-to-a-web-service-using-the-windows-forms-bindingsource.md
@@ -0,0 +1,82 @@
+---
+title: "方法 : Windows フォーム BindingSource を使用して Web サービスにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (Web サービスに)"
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "コントロール [Windows フォーム], バインド (Web サービスに)"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+  - "Web サービス, バインド (コントロールを)"
+ms.assetid: ee261207-4573-4cb9-a8cb-5185037e0fba
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# 方法 : Windows フォーム BindingSource を使用して Web サービスにバインドする
+XML Web サービスを呼び出して取得した結果に対して Windows フォーム コントロールをバインドする場合は、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用します。  この手順は、<xref:System.Windows.Forms.BindingSource> コンポーネントを型にバインディングする場合と似ています。  Web サービスが公開するメソッドおよび型を含むクライアント側プロキシを作成する必要があります。  クライアント側プロキシは、Web サービス \(.asmx\) 自体またはその Web サービス記述言語 \(WSDL: Web Services Description Language\) ファイルから生成できます。  また、クライアント側プロキシでは Web サービスが使用する複合型のフィールドをパブリック プロパティとして公開する必要があります。  その後、Web サービス プロキシ内で公開された型のいずれかに <xref:System.Windows.Forms.BindingSource> をバインドします。  
+  
+### クライアント側プロキシを作成してバインドするには  
+  
+1.  適切な名前空間を使用して、任意のディレクトリに Windows フォームを作成します。  
+  
+2.  フォームに <xref:System.Windows.Forms.BindingSource> コンポーネントを追加します。  
+  
+3.  [!INCLUDE[winsdklong](../../../../includes/winsdklong-md.md)] コマンド プロンプトを開き、フォームと同じディレクトリに移動します。  
+  
+4.  WSDL ツールを使用して、`wsdl`、および Web サービスの .asmx ファイルまたは WSDL ファイルの URL を入力し、次にアプリケーションの名前空間を入力し、使用している言語 \(これはオプション\) を入力します。  
+  
+     次のコード例では、http:\/\/webservices.eraserver.  net\/zipcoderesolver\/zipcoderesolver.asmx にある Web サービスを使用しています。  たとえば、C\# の型の場合は `wsdl http://webservices.eraserver.net.zipcoderesolver/zipcoderesolver.asmx /n:BindToWebService`、Visual Basic の型の場合は `wsdl http://webservices.eraserver.net.zipcoderesolver/zipcoderesolver.asmx /n:BindToWebService /language:VB` です。  パスを引数として WSDL ツールに渡すことで、指定した言語で、アプリケーションと同じディレクトリおよび名前空間にクライアント側プロキシが生成されます。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を使用している場合は、プロジェクトにファイルを追加します。  
+  
+5.  バインド先のクライアント側プロキシの型を選択します。  
+  
+     これは、通常、Web サービスによって提供されるメソッドが返す型です。  選択した型のフィールドは、バインド用にパブリック プロパティとして公開する必要があります。  
+  
+     [!code-cpp[System.Windows.Forms.DataConnectorWebService#4](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#4)]
+     [!code-csharp[System.Windows.Forms.DataConnectorWebService#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#4)]
+     [!code-vb[System.Windows.Forms.DataConnectorWebService#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#4)]  
+  
+6.  <xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.DataSource%2A> プロパティに、Web サービスのクライアント側プロキシに含まれる任意の型を設定します。  
+  
+     [!code-cpp[System.Windows.Forms.DataConnectorWebService#2](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#2)]
+     [!code-csharp[System.Windows.Forms.DataConnectorWebService#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#2)]
+     [!code-vb[System.Windows.Forms.DataConnectorWebService#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#2)]  
+  
+### Web サービスにバインドされた BindingSource にコントロールをバインドするには  
+  
+-   コントロールを <xref:System.Windows.Forms.BindingSource> にバインドし、Web サービスの任意の型のパブリック プロパティをパラメーターとして渡します。  
+  
+     [!code-cpp[System.Windows.Forms.DataConnectorWebService#3](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#3)]
+     [!code-csharp[System.Windows.Forms.DataConnectorWebService#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#3)]
+     [!code-vb[System.Windows.Forms.DataConnectorWebService#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#3)]  
+  
+## 使用例  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントを Web サービスにバインドし、テキスト ボックスを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドするコード例を次に示します。  ボタンをクリックすると、Web サービス メソッドが呼び出され、結果が `textbox1` に表示されます。  
+  
+ [!code-cpp[System.Windows.Forms.DataConnectorWebService#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CPP/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.DataConnectorWebService#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnectorWebService#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorWebService/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ これは、`Main` メソッドを含む完全な例であり、クライアント側プロキシのコードを短縮したバージョンです。  
+  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、System.Web.Services、System.Windows.Forms、および System.Xml の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-bind-windows-forms-controls-to-dbnull-database-values.md b/docs/framework/winforms/controls/how-to-bind-windows-forms-controls-to-dbnull-database-values.md
new file mode 100644
index 00000000000..d27f9dc6a9d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-bind-windows-forms-controls-to-dbnull-database-values.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Windows フォーム コントロールを DBNull データベース値にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], バインド (DBNull 値に)"
+  - "コントロール [Windows フォーム], バインド (DBNull 値に)"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+ms.assetid: 96494e6f-5f40-4f83-af97-bbd7192c2af8
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム コントロールを DBNull データベース値にバインドする
+データ ソースに Windows フォーム コントロールをバインドして、データ ソースが <xref:System.DBNull> 値を返す場合、イベントの処理、書式設定、または解析なしで、適切な値に置き換えることができます。  <xref:System.Windows.Forms.Binding.NullValue%2A> プロパティは、データ ソースの値を書式設定または解析する際、<xref:System.DBNull> を指定されたオブジェクトに変換します。  
+  
+## 使用例  
+ 次の例では、2 つの異なる状況で <xref:System.DBNull> の値をバインドする方法を示しています。  1 つ目は、文字列のプロパティに対して <xref:System.Windows.Forms.Binding.NullValue%2A> を設定する方法を示し、2 つ目は、イメージのプロパティに対して <xref:System.Windows.Forms.Binding.NullValue%2A> を設定する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.BindingDBNull#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingDBNull/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.BindingDBNull#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingDBNull/VB/form1.vb#1)]  
+  
+ バインドされたプロパティの種類と <xref:System.Windows.Forms.Binding.NullValue%2A> プロパティは同じにする必要があります。そうでないとエラーが発生し、<xref:System.Windows.Forms.Binding.NullValue%2A> の値はそれ以上処理されません。  このような場合は、例外はスローされません。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : データ バインドで発生するエラーと例外を処理する](../../../../docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md b/docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md
new file mode 100644
index 00000000000..ed4e1554051
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md
@@ -0,0 +1,119 @@
+---
+title: "方法 : Windows フォームの MonthCalendar コントロールの外観を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], 予定表コントロール"
+  - "MonthBackColor プロパティ"
+  - "MonthCalendar コントロール [Windows フォーム], 書式指定 (表示を)"
+  - "TitleBackColor プロパティ"
+  - "TitleForeColor プロパティ"
+  - "TrailingForeColor プロパティ"
+ms.assetid: d09b95c9-e108-4608-9b31-b9100c0677bf
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォームの MonthCalendar コントロールの外観を変更する
+Windows フォームの <xref:System.Windows.Forms.MonthCalendar> コントロールでは、さまざまな方法でカレンダーの外観をカスタマイズできます。  たとえば、配色を変更したり、週番号や現在の日付の表示と非表示を切り替えたりできます。  
+  
+### 月間予定表の配色を変更するには  
+  
+-   <xref:System.Windows.Forms.MonthCalendar.TitleBackColor%2A>、<xref:System.Windows.Forms.MonthCalendar.TitleForeColor%2A>、<xref:System.Windows.Forms.MonthCalendar.TrailingForeColor%2A> などのプロパティを設定します。  <xref:System.Windows.Forms.MonthCalendar.TitleBackColor%2A> プロパティは、曜日を示すフォントの色も決定します。  <xref:System.Windows.Forms.MonthCalendar.TrailingForeColor%2A> プロパティは、表示月の前後の月に属する日付の色を決定します。  
+  
+    ```vb  
+    MonthCalendar1.TitleBackColor = System.Drawing.Color.Blue  
+    MonthCalendar1.TrailingForeColor = System.Drawing.Color.Red  
+    MonthCalendar1.TitleForeColor = System.Drawing.Color.Yellow  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.TitleBackColor = System.Drawing.Color.Blue;  
+    monthCalendar1.TrailingForeColor = System.Drawing.Color.Red;  
+    monthCalendar1.TitleForeColor = System.Drawing.Color.Yellow;  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->TitleBackColor = System::Drawing::Color::Blue;  
+    monthCalendar1->TrailingForeColor = System::Drawing::Color::Red;  
+    monthCalendar1->TitleForeColor = System::Drawing::Color::Yellow;  
+    ```  
+  
+    > [!NOTE]
+    >  Windows Vista 以降では、テーマによっては、プロパティを設定してもカレンダーの外観が変更されない場合があります。  たとえば、Aero テーマを使用するように Windows が設定されている場合は、<xref:System.Windows.Forms.MonthCalendar.BackColor%2A>、<xref:System.Windows.Forms.MonthCalendar.TitleBackColor%2A>、<xref:System.Windows.Forms.MonthCalendar.TitleForeColor%2A>、または <xref:System.Windows.Forms.MonthCalendar.TrailingForeColor%2A> プロパティを設定しても効力はありません。  これは、更新版のカレンダーが、実行時に現在のオペレーティング システムのテーマから取得された外観でレンダリングされるためです。  これらのプロパティを使用して以前のバージョンのカレンダーを有効にする場合は、アプリケーションの visual スタイルを無効にすることができます。  visual スタイルを無効にすると、アプリケーションの他のコントロールの外観と動作に影響する可能性があります。  Visual Basic で visual スタイルを無効にするには、プロジェクト デザイナーを開いて、**\[XP Visual スタイルを有効にする\]** チェック ボックスをオフにします。  C\# で visual スタイルを無効にするには、Program.cs を開いて、`Application.EnableVisualStyles();` をコメント アウトします。  visual スタイルの詳細については、「[How to: Enable Windows XP Visual Styles](http://msdn.microsoft.com/ja-jp/0a038ade-31cf-4e56-9cfe-7a1e6b83b57f)」を参照してください。  
+  
+### コントロールの下部に現在の日付を表示するには  
+  
+-   <xref:System.Windows.Forms.MonthCalendar.ShowToday%2A> プロパティを `true` に設定します。  フォームをダブルクリックしたときに今日の日付の表示と非表示を切り替える例を次に示します。  
+  
+    ```vb  
+    Private Sub Form1_DoubleClick(ByVal sender As Object, _  
+    ByVal e As System.EventArgs) Handles MyBase.DoubleClick  
+       ' Toggle between True and False.  
+       MonthCalendar1.ShowToday = Not MonthCalendar1.ShowToday  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void Form1_DoubleClick(object sender, System.EventArgs e)  
+    {  
+       // Toggle between True and False.  
+       monthCalendar1.ShowToday = !monthCalendar1.ShowToday;  
+    }  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void Form1_DoubleClick(System::Object ^  sender,  
+          System::EventArgs ^  e)  
+       {  
+          // Toggle between True and False.  
+          monthCalendar1->ShowToday = !monthCalendar1->ShowToday;  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.DoubleClick += new System.EventHandler(this.Form1_DoubleClick);  
+    ```  
+  
+    ```cpp  
+    this->DoubleClick += gcnew System::EventHandler(this,  
+       &Form1::Form1_DoubleClick);  
+    ```  
+  
+### 週番号を表示するには  
+  
+-   <xref:System.Windows.Forms.MonthCalendar.ShowWeekNumbers%2A> プロパティを `true` に設定します。  このプロパティは、コードまたは \[プロパティ\] ウィンドウで設定できます。  
+  
+     週番号は、週の最初の日の左側に別の列として表示されます。  
+  
+    ```vb  
+    MonthCalendar1.ShowWeekNumbers = True  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.ShowWeekNumbers = true;  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->ShowWeekNumbers = true;  
+    ```  
+  
+## 参照  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する](../../../../docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する](../../../../docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する](../../../../docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-styles-on-an-element-in-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/how-to-change-styles-on-an-element-in-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..2829b1069b6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-styles-on-an-element-in-the-managed-html-document-object-model.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : マネージ HTML DOM (Document Object Model) の要素のスタイルを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マネージ HTML DOM, 変更 (要素のスタイルを)"
+ms.assetid: 154e8d9f-3e2d-4e8b-a6f3-c85a070e9cc1
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : マネージ HTML DOM (Document Object Model) の要素のスタイルを変更する
+HTML のスタイルを使用してドキュメントの外観と要素を制御できます。  <xref:System.Windows.Forms.HtmlDocument> および <xref:System.Windows.Forms.HtmlElement> は、次の形式のスタイル文字列を設定する <xref:System.Windows.Forms.HtmlElement.Style%2A> プロパティをサポートします。  
+  
+ `name1:value1;...;nameN:valueN;`  
+  
+ これは、フォントを Arial に設定し、すべてのテキストを太字に設定するスタイル文字列を持つ `DIV` です。  
+  
+ `<DIV style="font-face:arial;font-weight:bold;">`  
+  
+ `Hello, world!`  
+  
+ `</DIV>`  
+  
+ <xref:System.Windows.Forms.HtmlElement.Style%2A> プロパティを使用してスタイルを操作する場合の問題点は、文字列への個々のスタイル設定の追加や削除が面倒なことです。  たとえば、ユーザーがカーソルを `DIV` 上に配置するたびに直前のテキストを斜体で表示し、カーソルを `DIV` から離したときに斜体をオフにする手順は複雑になります。  この方法で多数のスタイルを操作する必要がある場合には、時間が問題になります。  
+  
+ 次のプロシージャには、HTML ドキュメントのスタイルと要素を簡単に操作するために使用できるコードが含まれています。  このプロシージャを実行するには、新しいプロジェクトの作成やフォームへのコントロールの追加など、Windows フォームの基本的なタスクの実行方法を理解している必要があります。  
+  
+### Windows フォーム アプリケーションのスタイル変更を処理するには  
+  
+1.  新しい Windows フォーム プロジェクトを作成します。  
+  
+2.  新しいクラス ファイルを作成します。ファイル名の最後に、プログラミング言語に適した拡張子を付けてください。  
+  
+3.  このトピックの「例」にある `StyleGenerator` クラス コードをクラス ファイルにコピーし、コードを保存します。  
+  
+4.  次の HTML を Test.htm という名前のファイルに保存します。  
+  
+    ```  
+    <HTML>  
+        <BODY>  
+  
+            <DIV style="font-face:arial;font-weight:bold;">  
+                Hello, world!  
+            </DIV><P>  
+  
+            <DIV>  
+                Hello again, world!  
+            </DIV><P>  
+  
+        </BODY>  
+    </HTML>  
+    ```  
+  
+5.  `webBrowser1` という名前の <xref:System.Windows.Forms.WebBrowser> コントロールをプロジェクトのメイン フォームに追加します。  
+  
+6.  プロジェクトのコード ファイルに次のコードを追加します。  
+  
+    > [!IMPORTANT]
+    >  `webBrowser1_DocumentCompleted` イベント ハンドラーが <xref:System.Windows.Forms.WebBrowser.DocumentCompleted> イベントのリスナーとして構成されていることを確認します。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] で、<xref:System.Windows.Forms.WebBrowser> コントロールをダブルクリックします。次に、テキスト エディターで、リスナーをプログラムで構成します。  
+  
+     [!code-csharp[ManagedDOMStyles#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ManagedDOMStyles/CS/Form1.cs#2)]
+     [!code-vb[ManagedDOMStyles#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ManagedDOMStyles/VB/Form1.vb#2)]  
+  
+7.  プロジェクトを実行します。  カーソルを最初の `DIV` 上に移動して、コードの効果を確認します。  
+  
+## 使用例  
+ `StyleGenerator` クラスの完全なコードを次のコード例に示します。このコードは、既存のスタイル値を解析し、スタイルの追加、変更、および削除をサポートし、変更要求に対応した新しいスタイル値を返します。  
+  
+ [!code-csharp[ManagedDOMStyles#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ManagedDOMStyles/CS/StyleGenerator.cs#1)]
+ [!code-vb[ManagedDOMStyles#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ManagedDOMStyles/VB/StyleGenerator.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.HtmlElement>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md
new file mode 100644
index 00000000000..12a7eee40dc
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-colordialog-component.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : Windows フォーム ColorDialog コンポーネントの表示形式を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色のダイアログ ボックス, 構成 (表示形式を)"
+  - "ColorDialog コンポーネント, 例"
+  - "ColorDialog コンポーネント, 書式指定 (外観を)"
+ms.assetid: bba4e262-1cd7-4f63-89cf-330a36f7b539
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム ColorDialog コンポーネントの表示形式を変更する
+複数のプロパティを使用して、Windows フォーム <xref:System.Windows.Forms.ColorDialog> コンポーネントの表示形式を設定できます。  ダイアログ ボックスは 2 つの部分に分かれています。基本色が表示される部分と、ユーザーがカスタム カラーを定義できる部分です。  
+  
+ ほとんどのプロパティでは、ユーザーがダイアログ ボックスで選択できる色が制限されています。  <xref:System.Windows.Forms.ColorDialog.AllowFullOpen%2A> プロパティが `true` に設定されている場合、ユーザーはカスタム カラーを定義できます。  <xref:System.Windows.Forms.ColorDialog.FullOpen%2A> プロパティは、カスタム カラーを定義するためにダイアログ ボックスが拡張されている場合に `true` になります。ダイアログ ボックスが拡張されていない場合、ユーザーは \[色の作成\] ボタンをクリックする必要があります。  <xref:System.Windows.Forms.ColorDialog.AnyColor%2A> プロパティが `true` に設定されていると、ダイアログ ボックスには基本色のセットの中で使用できるすべての色が表示されます。  <xref:System.Windows.Forms.ColorDialog.SolidColorOnly%2A> プロパティが `true` に設定されていると、ユーザーはディザー カラーを選択できず、純色だけを選択できます。  
+  
+ <xref:System.Windows.Forms.ColorDialog.ShowHelp%2A> プロパティが `true` に設定されていると、ダイアログ ボックスに \[ヘルプ\] ボタンが表示されます。  ユーザーが \[ヘルプ\] をクリックすると、<xref:System.Windows.Forms.ColorDialog> コンポーネントの <xref:System.Windows.Forms.CommonDialog.HelpRequest> イベントが発生します。  
+  
+### カラー ダイアログ ボックスの表示形式を設定するには  
+  
+1.  <xref:System.Windows.Forms.ColorDialog.AllowFullOpen%2A> プロパティ、<xref:System.Windows.Forms.ColorDialog.AnyColor%2A>、プロパティ、<xref:System.Windows.Forms.ColorDialog.SolidColorOnly%2A> プロパティ、および <xref:System.Windows.Forms.ColorDialog.ShowHelp%2A> プロパティを任意の値に設定します。  
+  
+    ```vb  
+    ColorDialog1.AllowFullOpen = True  
+    ColorDialog1.AnyColor = True  
+    ColorDialog1.SolidColorOnly = False  
+    ColorDialog1.ShowHelp = True  
+  
+    ```  
+  
+    ```csharp  
+    colorDialog1.AllowFullOpen = true;  
+    colorDialog1.AnyColor = true;  
+    colorDialog1.SolidColorOnly = false;  
+    colorDialog1.ShowHelp = true;  
+  
+    ```  
+  
+    ```cpp  
+    colorDialog1->AllowFullOpen = true;  
+    colorDialog1->AnyColor = true;  
+    colorDialog1->SolidColorOnly = false;  
+    colorDialog1->ShowHelp = true;  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ColorDialog>   
+ [ColorDialog コンポーネント](../../../../docs/framework/winforms/controls/colordialog-component-windows-forms.md)   
+ [ColorDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md
new file mode 100644
index 00000000000..012e33fe61b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md
@@ -0,0 +1,144 @@
+---
+title: "方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], LinkLabel コントロール"
+  - "LinkLabel コントロール [Windows フォーム], 変更 (リンクの表示形式を)"
+  - "LinkLabel コントロール [Windows フォーム], 例"
+  - "LinkLabel のプロパティ"
+  - "リンク, 変更 (表示形式を)"
+ms.assetid: fdc5854f-5162-4457-8cbe-1042feb2d132
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する
+<xref:System.Windows.Forms.LinkLabel> によって表示されるテキストは、さまざまな目的に合わせて変更できます。  たとえば、テキストに下線を付けて特定の色で表示されるように設定することにより、このテキストをクリックできることをユーザーに示します。  ユーザーがテキストをクリックすると、テキストは別の色に変わります。  この動作は、<xref:System.Windows.Forms.LinkLabel.LinkBehavior%2A>、<xref:System.Windows.Forms.LinkLabel.LinkArea%2A>、<xref:System.Windows.Forms.LinkLabel.LinkColor%2A>、<xref:System.Windows.Forms.LinkLabel.VisitedLinkColor%2A>、および <xref:System.Windows.Forms.LinkLabel.LinkVisited%2A> という 5 つの異なるプロパティを設定して制御できます。  
+  
+### LinkLabel コントロールの表示形式を変更するには  
+  
+1.  <xref:System.Windows.Forms.LinkLabel.LinkColor%2A> プロパティと <xref:System.Windows.Forms.LinkLabel.VisitedLinkColor%2A> プロパティに適切な色を設定します。  
+  
+     この処理は、プログラム実行時に行うことも、デザイン時に **\[プロパティ\]** ウィンドウで行うこともできます。  
+  
+    ```vb  
+    ' You can set the color using decimal values for red, green, and blue  
+    LinkLabel1.LinkColor = Color.FromArgb(0, 0, 255)  
+    ' Or you can set the color using defined constants  
+    LinkLabel1.VisitedLinkColor = Color.Purple  
+  
+    ```  
+  
+    ```csharp  
+    // You can set the color using decimal values for red, green, and blue  
+    linkLabel1.LinkColor = Color.FromArgb(0, 0, 255);  
+    // Or you can set the color using defined constants  
+    linkLabel1.VisitedLinkColor = Color.Purple;  
+  
+    ```  
+  
+    ```cpp  
+    // You can set the color using decimal values for red, green, and blue  
+    linkLabel1->LinkColor = Color::FromArgb(0, 0, 255);  
+    // Or you can set the color using defined constants  
+    linkLabel1->VisitedLinkColor = Color::Purple;  
+    ```  
+  
+2.  <xref:System.Windows.Forms.LinkLabel.Text%2A> プロパティに適切なキャプションを設定します。  
+  
+     この処理は、プログラム実行時に行うことも、デザイン時に **\[プロパティ\]** ウィンドウで行うこともできます。  
+  
+    ```vb  
+    LinkLabel1.Text = "Click here to see more."  
+  
+    ```  
+  
+    ```csharp  
+    linkLabel1.Text = "Click here to see more.";  
+  
+    ```  
+  
+    ```cpp  
+    linkLabel1->Text = "Click here to see more.";  
+    ```  
+  
+3.  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティを設定して、キャプションのどの部分をリンクとして表示するかを指定します。  
+  
+     <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> の値は、<xref:System.Windows.Forms.LinkArea> で表されます。このオブジェクトには、文字の開始位置と文字数を示す 2 つの数字が含まれます。  この処理は、プログラム実行時に行うことも、デザイン時に **\[プロパティ\]** ウィンドウで行うこともできます。  
+  
+    ```vb  
+    LinkLabel1.LinkArea = new LinkArea(6,4)  
+  
+    ```  
+  
+    ```csharp  
+    linkLabel1.LinkArea = new LinkArea(6,4);  
+  
+    ```  
+  
+    ```cpp  
+    linkLabel1->LinkArea = LinkArea(6,4);  
+    ```  
+  
+4.  <xref:System.Windows.Forms.LinkLabel.LinkBehavior%2A> プロパティを <xref:System.Windows.Forms.LinkBehavior>、<xref:System.Windows.Forms.LinkBehavior>、または <xref:System.Windows.Forms.LinkBehavior> に設定します。  
+  
+     このプロパティを <xref:System.Windows.Forms.LinkBehavior> に設定している場合は、<xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティで指定したキャプションの一部にマウス ポインターを置いた場合にだけ下線が付けられます。  
+  
+5.  <xref:System.Windows.Forms.LinkLabel.LinkClicked> イベント ハンドラー内で、<xref:System.Windows.Forms.LinkLabel.LinkVisited%2A> プロパティを `true` に設定します。  
+  
+     既にアクセス済みのリンクは、なんらかの方法で外観が変更されます。通常はリンクの色が変更されます。  テキストが <xref:System.Windows.Forms.LinkLabel.VisitedLinkColor%2A> プロパティで指定した色に変わります。  
+  
+    ```vb  
+    Protected Sub LinkLabel1_LinkClicked (ByVal sender As Object, _  
+       ByVal e As EventArgs) Handles LinkLabel1.LinkClicked  
+       ' Change the color of the link text  
+       ' by setting LinkVisited to True.  
+       LinkLabel1.LinkVisited = True  
+       ' Then do whatever other action is appropriate  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void LinkLabel1_LinkClicked(object sender, System.EventArgs e)  
+    {  
+       // Change the color of the link text by setting LinkVisited   
+       // to True.  
+       linkLabel1.LinkVisited = true;  
+       // Then do whatever other action is appropriate  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void linkLabel1_LinkClicked(System::Object ^  sender,  
+          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)  
+       {  
+          // Change the color of the link text by setting LinkVisited   
+          // to True.  
+          linkLabel1->LinkVisited = true;  
+          // Then do whatever other action is appropriate  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.LinkLabel.LinkArea%2A>   
+ <xref:System.Windows.Forms.LinkLabel.LinkColor%2A>   
+ <xref:System.Windows.Forms.LinkLabel.VisitedLinkColor%2A>   
+ <xref:System.Windows.Forms.LinkLabel.LinkVisited%2A>   
+ [LinkLabel コントロールの概要](../../../../docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする](../../../../docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md)   
+ [LinkLabel コントロール](../../../../docs/framework/winforms/controls/linklabel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md
new file mode 100644
index 00000000000..11ca42c7aca
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md
@@ -0,0 +1,80 @@
+---
+title: "方法 : Windows フォーム TabControl の表示形式を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ボタン, 表示 (タブを)"
+  - "アイコン, 表示 (タブに)"
+  - "TabControl コントロール [Windows フォーム], 変更 (ページの表示形式を)"
+  - "タブ, 制御 (外観を)"
+ms.assetid: 7c6cc443-ed62-4d26-b94d-b8913b44f773
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム TabControl の表示形式を変更する
+Windows フォーム内のタブの表示形式は、コントロールの各タブを構成する <xref:System.Windows.Forms.TabControl> オブジェクトおよび <xref:System.Windows.Forms.TabPage> オブジェクトのプロパティを使用して変更できます。  これらのプロパティを設定することにより、タブ上にイメージを表示したり、タブを横ではなく縦に並べたり、タブを複数の行に表示したり、プログラムによってタブを有効または無効にしたりできます。  
+  
+### タブのラベル部分にアイコンを表示するには  
+  
+1.  フォームに <xref:System.Windows.Forms.ImageList> コントロールを追加します。  
+  
+2.  イメージ リストにイメージを追加します。  
+  
+     イメージ リストの詳細については、「[ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)」および「[方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)」を参照してください。  
+  
+3.  <xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.ImageList%2A> プロパティを <xref:System.Windows.Forms.ImageList> コントロールに設定します。  
+  
+4.  <xref:System.Windows.Forms.TabPage> の <xref:System.Windows.Forms.TabPage.ImageIndex%2A> プロパティをリスト内の適切なイメージのインデックスに設定します。  
+  
+### タブを複数の行に表示するには  
+  
+1.  必要な数のタブ ページを追加します。  
+  
+2.  <xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.Multiline%2A> プロパティを `true` に設定します。  
+  
+3.  これでもタブが複数の行に表示されない場合は、<xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.Control.Width%2A> プロパティの値をすべてのタブの合計幅よりも小さい値に設定します。  
+  
+### タブをコントロールの横側に配置するには  
+  
+-   <xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.Alignment%2A> プロパティを <xref:System.Windows.Forms.TabAlignment> または <xref:System.Windows.Forms.TabAlignment> に設定します。  
+  
+### タブのすべてのコントロールをプログラムによって有効または無効にするには  
+  
+1.  <xref:System.Windows.Forms.TabPage> の <xref:System.Windows.Forms.TabPage.Enabled%2A> プロパティを `true` または `false` に設定します。  
+  
+    ```vb  
+    TabPage1.Enabled = False  
+  
+    ```  
+  
+    ```csharp  
+    tabPage1.Enabled = false;  
+  
+    ```  
+  
+    ```cpp  
+    tabPage1->Enabled = false;  
+    ```  
+  
+### タブをボタンとして表示するには  
+  
+-   <xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.Appearance%2A> プロパティを <xref:System.Windows.Forms.TabAppearance> または <xref:System.Windows.Forms.TabAppearance> に設定します。  
+  
+## 参照  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)   
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-appearance-of-toolstrip-text-and-images-in-windows-forms.md b/docs/framework/winforms/controls/how-to-change-the-appearance-of-toolstrip-text-and-images-in-windows-forms.md
new file mode 100644
index 00000000000..9013e3594b8
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-appearance-of-toolstrip-text-and-images-in-windows-forms.md
@@ -0,0 +1,96 @@
+---
+title: "方法 : Windows フォーム内の ToolStrip テキストとイメージの外観を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ツール バー [Windows フォーム], 外観"
+  - "ツール バー [Windows フォーム], イメージ"
+  - "ツール バー [Windows フォーム], テキスト"
+  - "ToolStrip コントロール [Windows フォーム], 外観"
+  - "ToolStrip コントロール [Windows フォーム], イメージ"
+  - "ToolStrip コントロール [Windows フォーム], テキスト"
+ms.assetid: d62dc9d1-2edd-4dfa-aed7-1335d6e13d86
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム内の ToolStrip テキストとイメージの外観を変更する
+テキストとイメージを <xref:System.Windows.Forms.ToolStripItem> に表示するかどうか、また、テキスト、イメージ、および <xref:System.Windows.Forms.ToolStrip> の相対位置を制御できます。  
+  
+### ToolStripItem に表示するものを定義するには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> プロパティに目的の値を設定します。  設定できる値は、`Image`、`ImageAndText`、`None`、および `Text` です。  既定値は、`ImageAndText` です。  
+  
+    ```vb  
+    ToolStripButton2.DisplayStyle = _  
+        System.Windows.Forms.ToolStripItemDisplayStyle.Image  
+  
+    ```  
+  
+    ```csharp  
+    toolStripButton2.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.Image;  
+  
+    ```  
+  
+### ToolStripItem 上でテキストを揃えるには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.TextAlign%2A> プロパティに目的の値を設定します。  設定できる値は、Top、Middle、Bottom と Left、Center、Right の組み合わせです。  既定値は、`MiddleCenter` です。  
+  
+    ```vb  
+    ToolStripSplitButton1.TextAlign = _  
+        System.Drawing.ContentAlignment.MiddleRight  
+  
+    ```  
+  
+    ```csharp  
+    toolStripSplitButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight;  
+  
+    ```  
+  
+### ToolStripItem 上でイメージを揃えるには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.ImageAlign%2A> プロパティに目的の値を設定します。  設定できる値は、Top、Middle、Bottom と Left、Center、Right の組み合わせです。  既定値は、`MiddleLeft` です。  
+  
+    ```vb  
+    ToolStripSplitButton1.ImageAlign = _  
+        System.Drawing.ContentAlignment.MiddleRight  
+  
+    ```  
+  
+    ```csharp  
+    toolStripSplitButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleRight;  
+  
+    ```  
+  
+### ToolStripItem のテキストとイメージの相対的な表示位置を定義するには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.TextImageRelation%2A> プロパティに目的の値を設定します。  設定できる値は、`ImageAboveText`、`ImageBeforeText`、`Overlay`、`TextAboveImage`、および `TextBeforeImage` です。  既定値は、`ImageBeforeText` です。  
+  
+    ```vb  
+    ToolStripButton1.TextImageRelation = _  
+        System.Windows.Forms.TextImageRelation.ImageAboveText  
+  
+    ```  
+  
+    ```csharp  
+    toolStripButton1.TextImageRelation = System.Windows.Forms.TextImageRelation.ImageAboveText;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md b/docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md
new file mode 100644
index 00000000000..9a5049d3b82
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツールヒント"
+  - "ToolTip コンポーネント [Windows フォーム], 遅延時間の値"
+  - "ツールヒント [Windows フォーム], 遅延時間の値"
+ms.assetid: 08979ba7-dd84-477b-ab17-8d06e759be99
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する
+Windows フォームの <xref:System.Windows.Forms.ToolTip> コンポーネントには、遅延時間を設定するプロパティが複数あります。  これらのプロパティの単位はすべてミリ秒です。  <xref:System.Windows.Forms.ToolTip.InitialDelay%2A> プロパティは、ツールヒント文字列が表示されるまでにユーザーがコントロールをポイントし続ける時間を決定します。  <xref:System.Windows.Forms.ToolTip.ReshowDelay%2A> プロパティは、1 つのコントロールから別のコントロールにマウスを移動したときに次のツールヒント文字列が表示されるまでにかかる時間を、ミリ秒単位で設定します。  <xref:System.Windows.Forms.ToolTip.AutoPopDelay%2A> プロパティは、ツールヒント文字列が表示されている時間の長さを決定します。  これらの値は個別に設定したり、<xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> プロパティの値で設定したりできます。他の遅延時間プロパティは、<xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> に割り当てた値に基づいて設定されます。  たとえば、<xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> の値を N に設定した場合、<xref:System.Windows.Forms.ToolTip.InitialDelay%2A> は N に、<xref:System.Windows.Forms.ToolTip.ReshowDelay%2A> は <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> の値を 5 で割った値 \(N\/5\) に、<xref:System.Windows.Forms.ToolTip.AutoPopDelay%2A> は <xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> プロパティの値に 5 を掛けた値 \(5N\) に設定されます。  
+  
+### 遅延時間を設定するには  
+  
+1.  次の例に示すように、各プロパティを設定します。  
+  
+    ```vb  
+    ToolTip1.InitialDelay = 500  
+    ToolTip1.ReshowDelay = 100  
+    ToolTip1.AutoPopDelay = 5000  
+  
+    ```  
+  
+    ```csharp  
+    ToolTip1.InitialDelay = 500;  
+    ToolTip1.ReshowDelay = 100;  
+    ToolTip1.AutoPopDelay = 5000;  
+  
+    ```  
+  
+    ```cpp  
+    toolTip1->InitialDelay = 500;  
+    toolTip1->ReshowDelay = 100;  
+    toolTip1->AutoPopDelay = 5000;  
+    ```  
+  
+## 参照  
+ [ToolTip コンポーネントの概要](../../../../docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md)   
+ [方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](../../../../docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)   
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..11bb969b601
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの列の順序を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 変更 (順序を)"
+  - "データ グリッド, 変更 (列の順序を)"
+  - "DataGridView コントロール [Windows フォーム], 列の順序"
+ms.assetid: 5e9ac3bc-b0f0-48cb-a3d5-b005af905395
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム DataGridView コントロールの列の順序を変更する
+<xref:System.Windows.Forms.DataGridView> を使用してデータをデータ ソースから表示する場合、データ ソースのスキーマの列が、表示したい順序で表示されないことがあります。  <xref:System.Windows.Forms.DataGridViewColumn> クラスの <xref:System.Windows.Forms.DataGridViewColumn.DisplayIndex%2A> プロパティを使用して、列の表示順序を変更できます。  
+  
+ 次のコード例は、Northwind サンプル データベース内の Customers テーブルにバインドするときに自動的に生成される列のいくつかを再配置します。  <xref:System.Windows.Forms.DataGridView> コントロールをデータベース テーブルにバインドする方法の詳細については、「[方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する](http://msdn.microsoft.com/library/hb1dk7ax\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#040](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#040)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#040](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#040)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   Northwind サンプル データベース内の `Customers` テーブルなど、示されている列の名前を持つテーブルにバインドされた、`customersDataGridView` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Windows.Forms?displayProperty=fullName>、<xref:System.Data?displayProperty=fullName>、および <xref:System.Xml?displayProperty=fullName> の各アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ <xref:System.Windows.Forms.DataGridViewColumn.DisplayIndex%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : データを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-change-the-spacing-and-alignment-of-toolstrip-items-in-windows-forms.md b/docs/framework/winforms/controls/how-to-change-the-spacing-and-alignment-of-toolstrip-items-in-windows-forms.md
new file mode 100644
index 00000000000..7e2c4dc7c5a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-change-the-spacing-and-alignment-of-toolstrip-items-in-windows-forms.md
@@ -0,0 +1,106 @@
+---
+title: "方法 : Windows フォーム内の ToolStrip 項目の間隔と配置を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ツール バー [Windows フォーム], 配置 (項目を)"
+  - "ToolStrip コントロール [Windows フォーム], 配置 (項目を)"
+ms.assetid: cd483466-0f49-43df-addf-e2b5fcd64027
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム内の ToolStrip 項目の間隔と配置を変更する
+<xref:System.Windows.Forms.ToolStrip> コントロールは、サイズ調整、<xref:System.Windows.Forms.ToolStripItem> コントロールの間隔、<xref:System.Windows.Forms.ToolStrip> 上へのコントロールの配置、および <xref:System.Windows.Forms.ToolStrip> に相対的なコントロールの間隔などのレイアウト機能を完全にサポートします。  
+  
+ <xref:System.Windows.Forms.ToolStripItem.AutoSize%2A> プロパティの既定値は `true` であるため、<xref:System.Windows.Forms.ToolStripItem.AutoSize%2A> プロパティを `false` に設定しない限り、コントロールのサイズは自動的に調整されます。  
+  
+### ToolStripItem のサイズを手動で調整するには  
+  
+1.  関連するコントロールの <xref:System.Windows.Forms.ToolStripItem.AutoSize%2A> プロパティを `false` に設定します。  
+  
+    ```vb  
+    ToolStripButton1.AutoSize = False  
+  
+    ```  
+  
+    ```csharp  
+    toolStripButton1.AutoSize = false;  
+  
+    ```  
+  
+2.  関連する <xref:System.Windows.Forms.ToolStripItem> の <xref:System.Windows.Forms.ToolStripItem.Size%2A> プロパティを任意の値に設定します。  
+  
+### ToolStripItem の間隔を設定するには  
+  
+1.  関連するコントロールの <xref:System.Windows.Forms.ToolStripItem.Margin%2A> プロパティに任意の値 \(ピクセル単位\) を挿入します。  
+  
+     <xref:System.Windows.Forms.ToolStripItem.Margin%2A> プロパティの値で、項目と隣接する項目の間隔 \(順に左、上、右、および下\) を指定します。  
+  
+    ```vb  
+    ToolStripTextBox1.Margin = New System.Windows.Forms.Padding _  
+        (3, 0, 3, 0)  
+  
+    ```  
+  
+    ```csharp  
+    toolStripTextBox1.Margin = new System.Windows.Forms.Padding   
+        (3, 0, 3, 0);  
+  
+    ```  
+  
+### ToolStripItem を ToolStrip の右側に配置するには  
+  
+1.  関連するコントロールの <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> プロパティを <xref:System.Windows.Forms.ToolStripItemAlignment> に設定します。  既定では、<xref:System.Windows.Forms.ToolStripItem.Alignment%2A> は <xref:System.Windows.Forms.ToolStripItemAlignment> に設定され、コントロールは <xref:System.Windows.Forms.ToolStrip> の左側に配置されます。  
+  
+    ```vb  
+    ToolStripSplitButton1.Alignment = _  
+        System.Windows.Forms.ToolStripItemAlignment.Right  
+  
+    ```  
+  
+    ```csharp  
+    toolStripSplitButton1.Alignment =   
+        System.Windows.Forms.ToolStripItemAlignment.Right;  
+  
+    ```  
+  
+### ToolStrip 上の ToolStrip 項目を並べ替えるには  
+  
+-   <xref:System.Windows.Forms.ToolStrip.LayoutStyle%2A> プロパティを任意の <xref:System.Windows.Forms.ToolStripLayoutStyle> の値に設定します。  
+  
+    ```vb  
+    ToolStripDropDown1.LayoutStyle = _  
+        System.Windows.Forms.ToolStripLayoutStyle.Flow  
+  
+    ```  
+  
+    ```csharp  
+    toolStripDropDown1.LayoutStyle =   
+        System.Windows.Forms.ToolStripLayoutStyle.Flow;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.Control.Layout>   
+ <xref:System.Windows.Forms.ToolStrip.LayoutCompleted>   
+ <xref:System.Windows.Forms.ToolStrip.LayoutSettings%2A>   
+ <xref:System.Windows.Forms.ToolStripItem.TextImageRelation%2A>   
+ <xref:System.Windows.Forms.ToolStripItem.Placement%2A>   
+ <xref:System.Windows.Forms.ToolStrip.CanOverflow%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md b/docs/framework/winforms/controls/how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md
new file mode 100644
index 00000000000..4ee38ab0c8e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-choose-folders-with-the-windows-forms-folderbrowserdialog-component.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : Windows フォーム FolderBrowserDialog コンポーネントを使用してフォルダーを選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ディレクトリ [Windows フォーム], 選択"
+  - "ディレクトリ [Windows フォーム], 選択"
+  - "FolderBrowserDialog コンポーネント [Windows フォーム], 選択 (ディレクトリを)"
+  - "フォルダー [Windows フォーム], 選択"
+  - "フォルダー [Windows フォーム], 選択"
+ms.assetid: 4593670e-7c7d-4661-b46b-4ffb63258adb
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォーム FolderBrowserDialog コンポーネントを使用してフォルダーを選択する
+Windows アプリケーションでは、ユーザーにフォルダーの選択を求めることがよくあります。最も一般的なのは、ファイルを保存する場合です。  Windows フォームの <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントを使用すると、この処理を簡単に実現できます。  
+  
+### FolderBrowserDialog コンポーネントでフォルダーを選択するには  
+  
+1.  プロシージャで、<xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントの <xref:System.Windows.Forms.Form.DialogResult%2A> プロパティを参照して、ダイアログ ボックスがどのように閉じられたかを確認し、<xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントの <xref:System.Windows.Forms.FolderBrowserDialog.SelectedPath%2A> プロパティの値を取得します。  
+  
+2.  ダイアログ ボックスのツリー ビューに表示される最上位のフォルダーを設定する必要がある場合は、<xref:System.Windows.Forms.FolderBrowserDialog.RootFolder%2A> プロパティを設定します。このプロパティには、[SpecialFolder](frlrfSystemEnvironmentSpecialFolderClassTopic) 列挙型のメンバーを指定します。  
+  
+3.  さらに、フォルダー ブラウザーのツリー ビューの上部に表示されるテキスト文字列を指定する <xref:System.Windows.Forms.FolderBrowserDialog.Description%2A> プロパティを設定できます。  
+  
+     <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントを使用してフォルダーを選択する方法を次に示します。この方法は、Visual Studio でのプロジェクトの作成時にプロジェクトの保存先フォルダーを選択する方法と同様です。  この例では、フォームの <xref:System.Windows.Forms.TextBox> コントロールにフォルダー名が表示されます。  エラーやその他の問題が発生したときにユーザーが選択内容を編集できるように、<xref:System.Windows.Forms.TextBox> コントロールなどの編集可能な領域にフォルダー名を表示することをお勧めします。  この例では、フォームに <xref:System.Windows.Forms.FolderBrowserDialog> コンポーネントと <xref:System.Windows.Forms.TextBox> コントロールがあると仮定しています。  
+  
+    ```vb  
+    Public Sub ChooseFolder()  
+        If FolderBrowserDialog1.ShowDialog() = DialogResult.OK Then  
+            TextBox1.Text = FolderBrowserDialog1.SelectedPath  
+        End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void ChooseFolder()  
+    {  
+        if (folderBrowserDialog1.ShowDialog() == DialogResult.OK)   
+        {  
+            textBox1.Text = folderBrowserDialog1.SelectedPath;  
+        }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void ChooseFolder()  
+       {  
+          if (folderBrowserDialog1->ShowDialog() == DialogResult::OK)  
+          {  
+             textBox1->Text = folderBrowserDialog1->SelectedPath;  
+          }  
+       }  
+    ```  
+  
+    > [!IMPORTANT]
+    >  このクラスを使用するには、アセンブリに [FileIOPermissionAttribute.PathDiscoveryProperty](frlrfSystemSecurityPermissionsFileIOPermissionAttributeClassPathDiscoveryTopic) プロパティで権限レベルを与える必要があります。このプロパティは、<xref:System.Security.Permissions.FileIOPermissionAccess> 列挙型の一部です。  部分的に信頼できるコンテキストで動作している場合は、権限が不十分なためにプロセスが例外をスローすることがあります。  詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+ ファイルを保存する方法については、「[方法 : SaveFileDialog コンポーネントを使用してファイルを保存する](../../../../docs/framework/winforms/controls/how-to-save-files-using-the-savefiledialog-component.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FolderBrowserDialog>   
+ [FolderBrowserDialog コンポーネントの概要 \(Windows フォーム\)](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-overview-windows-forms.md)   
+ [FolderBrowserDialog コンポーネント](../../../../docs/framework/winforms/controls/folderbrowserdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-configure-contextmenustrip-check-margins-and-image-margins.md b/docs/framework/winforms/controls/how-to-configure-contextmenustrip-check-margins-and-image-margins.md
new file mode 100644
index 00000000000..f28295d146a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-configure-contextmenustrip-check-margins-and-image-margins.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : ContextMenuStrip のチェックの余白とイメージの余白を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, 設定 (チェックの余白とイメージの余白を)"
+  - "ContextMenuStrips, 設定 (チェックの余白とイメージの余白を)"
+  - "マージン, 設定 (Windows フォームの ContextMenuStrips のチェックの余白とイメージの余白を)"
+ms.assetid: 3391c4c2-0c9e-4aa4-9492-13ff7644bdf2
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ContextMenuStrip のチェックの余白とイメージの余白を設定する
+<xref:System.Windows.Forms.ToolStripDropDownMenu.ShowImageMargin%2A> プロパティと <xref:System.Windows.Forms.ToolStripDropDownMenu.ShowCheckMargin%2A> プロパティをさまざまな組み合わせで設定することにより、<xref:System.Windows.Forms.ContextMenuStrip> をカスタマイズできます。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Forms.ContextMenuStrip> のチェックの余白とイメージの余白をカスタマイズする方法について説明します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#60)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#60)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.ToolStripDropDown>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする](../../../../docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-configure-menustrip-check-margins-and-image-margins.md b/docs/framework/winforms/controls/how-to-configure-menustrip-check-margins-and-image-margins.md
new file mode 100644
index 00000000000..583a0d9ea44
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-configure-menustrip-check-margins-and-image-margins.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : MenuStrip のチェックの余白とイメージの余白を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マージン, 設定 (MenuStrip コントロールの)"
+  - "メニュー, 設定 (マージンを)"
+  - "MenuStrip コントロール [Windows フォーム], 設定 (チェックの余白とイメージの余白を)"
+ms.assetid: 45a9075d-4bea-4ce2-9b2c-7619aa39f8ce
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : MenuStrip のチェックの余白とイメージの余白を設定する
+<xref:System.Windows.Forms.ToolStripDropDownMenu.ShowImageMargin%2A> プロパティと <xref:System.Windows.Forms.ToolStripDropDownMenu.ShowCheckMargin%2A> プロパティをさまざまな組み合わせで設定することにより、<xref:System.Windows.Forms.MenuStrip> をカスタマイズできます。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Forms.ContextMenuStrip> のチェックの余白とイメージの余白をカスタマイズする方法について説明します。  手順は <xref:System.Windows.Forms.ContextMenuStrip> または <xref:System.Windows.Forms.MenuStrip> と同じです。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#60)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#60)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.ToolStripDropDown>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする](../../../../docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md b/docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md
new file mode 100644
index 00000000000..486f9033b19
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カーソル位置, TextBox コントロール"
+  - "テキスト ボックス, 制御 (挿入ポイントを)"
+  - "TextBox コントロール [Windows フォーム], カーソル位置"
+ms.assetid: 5bee7d34-5121-429e-ab1f-d8ff67bc74c1
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する
+Windows フォーム <xref:System.Windows.Forms.TextBox> コントロールに最初にフォーカスが設定されたとき、テキスト ボックスの既定のカーソル位置は、既存テキストの左端になります。  キーボードまたはマウスを使用して、カーソル位置を移動できます。  テキスト ボックスからフォーカスが他に移され、再びフォーカスを受け取った場合は、最後にカーソルが置かれていた場所がカーソル位置となります。  
+  
+ 場合によっては、この動作により混乱することがあります。  ワード プロセッシング アプリケーションでは、新しい文字が既存テキストの後に表示されるという前提で作業します。  データ入力アプリケーションでは、新しい文字を入力すると既存の入力が置き換えられるという前提で作業します。  <xref:System.Windows.Forms.TextBoxBase.SelectionStart%2A> プロパティおよび <xref:System.Windows.Forms.TextBoxBase.SelectionLength%2A> プロパティを使用すると、用途に合わせて動作を変更できます。  
+  
+### TextBox コントロールのカーソル位置を制御するには  
+  
+1.  <xref:System.Windows.Forms.TextBoxBase.SelectionStart%2A> プロパティに適切な値を設定します。  0 に設定すると、最初の文字のすぐ左側がカーソル位置となります。  
+  
+2.  \(省略可能\) <xref:System.Windows.Forms.TextBoxBase.SelectionLength%2A> プロパティに、選択するテキストの長さを設定します。  
+  
+     次のコードでは、常にカーソル位置が 0 に戻されます。  `TextBox1_Enter` イベント ハンドラーは、コントロールにバインドする必要があります。詳細については、「[Windows フォーム内でのイベント ハンドラーの作成](../../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)」を参照してください。  
+  
+    ```vb  
+    Private Sub TextBox1_Enter(ByVal sender As Object, ByVal e As System.EventArgs) Handles TextBox1.Enter  
+       TextBox1.SelectionStart = 0  
+       TextBox1.SelectionLength = 0  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void textBox1_Enter(Object sender, System.EventArgs e) {  
+       textBox1.SelectionStart = 0;  
+       textBox1.SelectionLength = 0;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void textBox1_Enter(System::Object ^  sender,  
+          System::EventArgs ^  e)  
+       {  
+          textBox1->SelectionStart = 0;  
+          textBox1->SelectionLength = 0;  
+       }  
+    ```  
+  
+## 既定でのカーソル位置の表示  
+ <xref:System.Windows.Forms.TextBox> のカーソル位置は、<xref:System.Windows.Forms.TextBox> コントロールがタブ オーダーの最初にある場合にだけ、新しいフォーム上に既定で表示されます。  それ以外の場合、カーソル位置は、キーボードまたはマウスを使って <xref:System.Windows.Forms.TextBox> にフォーカスを移動した場合にだけ表示されます。  
+  
+#### 新しいフォーム上でテキスト ボックスのカーソル位置を既定で表示するには  
+  
+-   <xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> プロパティを `0` に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-copy-controls-between-windows-forms.md b/docs/framework/winforms/controls/how-to-copy-controls-between-windows-forms.md
new file mode 100644
index 00000000000..050baea98ed
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-copy-controls-between-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : Windows フォーム間でコントロールをコピーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], コピー"
+  - "Windows フォーム コントロール, コピー"
+ms.assetid: 106c1eb2-1fba-4f69-b2ec-9ea3fa182f1e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Windows フォーム間でコントロールをコピーする
+同じフォーム、プロジェクト内の別のフォーム、または他のソリューションで使用するクリップボードにコントロールをコピーできます。  
+  
+### コントロールをコピーするには  
+  
+1.  コントロールを選択し、**\[編集\]** メニューの **\[コピー\]** を選択します。  
+  
+ 選択した種類のコントロールを受け入れるフォームに、コントロールを貼り付けます。  このとき、コントロールはクリップボードにも追加されます。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [方法 : Windows フォームに ActiveX コントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)   
+ [方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-without-a-user-interface-to-windows-forms.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-copy-toolstripmenuitems.md b/docs/framework/winforms/controls/how-to-copy-toolstripmenuitems.md
new file mode 100644
index 00000000000..06823658a57
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-copy-toolstripmenuitems.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : ToolStripMenuItems をコピーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目、コピーと貼り付け"
+  - "MenuStrip コントロール [Windows フォーム]、項目を整理する"
+  - "ToolStripMenuItems、コピーと貼り付け"
+ms.assetid: 17ef4207-e92e-4db2-b648-27246e6517ad
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ToolStripMenuItems をコピーする
+デザイン時に、トップレベル メニュー全体とそのサブメニュー項目を、<xref:System.Windows.Forms.MenuStrip> の別の場所にコピーできます。 トップレベル メニュー間で個々のメニュー項目のコピーをすることも、またはメニュー内のメニュー項目の位置を変更することもできます。  
+  
+### トップレベル メニューとサブメニュー項目を別のトップレベルの場所にコピーするには  
+  
+1.  コピーするメニューを左クリックして、Ctrl \+ C キーを押します。または、メニューを右クリックして、ショートカット メニューから **\[コピー\]** を選びます。  
+  
+2.  移動先となる新しい場所の後ろにあるトップレベル メニューを左クリックし、Ctrl \+ V キーを押します。または、移動先となる新しい場所の前にあるトップレベル メニュー項目を右クリックし、ショートカット メニューから **\[貼り付け\]** を選びます。  
+  
+     選んだトップレベル メニューの前に、コピーしたメニューが挿入されます。  
+  
+### トップレベル メニューとサブメニュー項目をドロップダウンの場所にコピーするには  
+  
+1.  移動するメニューを左クリックして、Ctrl \+ C キーを押します。または、メニューを右クリックして、ショートカット メニューから **\[コピー\]** を選びます。  
+  
+2.  宛先のトップレベル メニューで、移動先となる新しい場所の上にあるサブメニュー項目を左クリックし、Ctrl \+ V キーを押します。または、移動先となる新しい場所の上にあるサブメニュー項目を右クリックし、ショートカット メニューから **\[貼り付け\]** を選びます。  
+  
+     選んだサブメニュー項目の前に、コピーしたメニューが挿入されます。  
+  
+### 別のメニューにサブメニュー項目をコピーするには  
+  
+1.  コピーするサブメニュー項目を左クリックして、Ctrl \+ C キーを押します。または、サブメニュー項目を右クリックして、ショートカット メニューから **\[コピー\]** を選びます。  
+  
+2.  切り取ったサブメニュー項目を格納するメニューを左クリックします。  
+  
+3.  移動先となる新しい場所の前にあるサブメニュー項目を左クリックし、Ctrl \+ V キーを押します。または、移動先となる新しい場所の前にあるサブメニュー項目を右クリックし、ショートカット メニューから **\[貼り付け\]** を選びます。  
+  
+     選んだサブメニュー項目の前に、コピーしたサブメニュー項目が挿入されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-border-around-a-windows-forms-control-using-padding.md b/docs/framework/winforms/controls/how-to-create-a-border-around-a-windows-forms-control-using-padding.md
new file mode 100644
index 00000000000..5dac773c509
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-border-around-a-windows-forms-control-using-padding.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 埋め込みを使用して Windows フォーム コントロールの周囲に境界線を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], Margin プロパティ"
+  - "コントロール [Windows フォーム], アウトライン"
+  - "コントロール [Windows フォーム], Padding プロパティ"
+  - "Margin プロパティ [Windows フォーム]"
+  - "マージン"
+  - "マージン, Windows フォーム"
+  - "Padding プロパティ [Windows フォーム]"
+  - "埋め込み, Windows フォーム"
+ms.assetid: bac7ed4d-a163-4259-98bd-155a36345890
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 埋め込みを使用して Windows フォーム コントロールの周囲に境界線を作成する
+<xref:System.Windows.Forms.RichTextBox> コントロールの周囲に境界線つまり外枠を作成する方法を次のコード例に示します。  この例では、<xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Padding> プロパティの値を 5 に設定し、子の <xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  <xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Control.BackColor%2A> は、<xref:System.Drawing.Color.Blue%2A> に設定します。これによって <xref:System.Windows.Forms.RichTextBox> コントロールの周囲に青い境界線が作成されます。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.Padding#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Padding/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.Padding#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Padding/VB/Form1.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.Padding>   
+ [Windows フォーム コントロールでのマージンと埋め込み](../../../../docs/framework/winforms/controls/margin-and-padding-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-lookup-table-with-the-windows-forms-bindingsource-component.md b/docs/framework/winforms/controls/how-to-create-a-lookup-table-with-the-windows-forms-bindingsource-component.md
new file mode 100644
index 00000000000..0740f935287
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-lookup-table-with-the-windows-forms-bindingsource-component.md
@@ -0,0 +1,107 @@
+---
+title: "方法 : Windows フォーム BindingSource コンポーネントを使用してルックアップ テーブルを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], 作成 (ルックアップ テーブルを)"
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "ルックアップ テーブル"
+  - "テーブル [Windows フォーム], 作成 (ルックアップ テーブルを)"
+ms.assetid: 622fce80-879d-44be-abbf-8350ec22ca2b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム BindingSource コンポーネントを使用してルックアップ テーブルを作成する
+ルックアップ テーブルは、関連するテーブル内のレコードのデータを表示する列を持つ、データ テーブルです。  以下の手順では、<xref:System.Windows.Forms.ComboBox> コントロールを使用して、親テーブルから子テーブルへの外部キー リレーションシップを持つフィールドを表示します。  
+  
+ これらの 2 つのテーブルとこの関係をわかりやすく視覚化するために、親テーブルと子テーブルの例を次に示します。  
+  
+ CustomersTable \(親テーブル\)  
+  
+|CustomerID|CustomerName|  
+|----------------|------------------|  
+|712|Paul Koch|  
+|713|Tamara Johnston|  
+  
+ OrdersTable \(子テーブル\)  
+  
+|OrderID|OrderDate|CustomerID|  
+|-------------|---------------|----------------|  
+|903|February 12, 2004|712|  
+|904|February 13, 2004|713|  
+  
+ このシナリオでは、一方のテーブル \(CustomersTable\) に、表示および保存する実際の情報を格納します。  ただし領域を節約するために、このテーブルには情報を明確化するデータは含まれていません。  もう一方のテーブル \(OrdersTable\) には、どの顧客 ID 番号がどの発注日および発注 ID に相当するか、について表示関連の情報のみが格納されます。  顧客名の記述は含まれません。  
+  
+ ルックアップ テーブルを作成するには、[ComboBox コントロール](../../../../docs/framework/winforms/controls/combobox-control-windows-forms.md) コントロールで次の 4 つの重要なプロパティを設定します。  
+  
+-   <xref:System.Windows.Forms.ComboBox.DataSource%2A> プロパティには、テーブルの名前が格納されます。  
+  
+-   <xref:System.Windows.Forms.ListControl.DisplayMember%2A> プロパティには、コントロール テキスト \(顧客名\) に対して表示する、テーブルのデータ列が格納されます。  
+  
+-   <xref:System.Windows.Forms.ListControl.ValueMember%2A> プロパティには、格納された情報 \(親テーブルの ID 番号\) を持つ、テーブルのデータ列が格納されます。  
+  
+-   <xref:System.Windows.Forms.ListControl.SelectedValue%2A> プロパティは、<xref:System.Windows.Forms.ListControl.ValueMember%2A> に基づいて子テーブルのルックアップ値を提供します。  
+  
+ 以下の手順では、フォームをルックアップ テーブルとしてレイアウトし、フォームのコントロールにデータをバインドする方法を示します。  この手順を完了するには、データ ソース、および前述の外部キー リレーションシップを持つ親テーブルと子テーブルから構成されるデータ ソースが必要です。  
+  
+### ユーザー インターフェイスを作成するには  
+  
+1.  **ツールボックス**から、<xref:System.Windows.Forms.ComboBox> コントロールをフォームにドラッグします。  
+  
+     このコントロールは、親テーブルの列を表示します。  
+  
+2.  子テーブルの詳細を表示する他のコントロールをドラッグします。  テーブル内のデータの形式によって、選択するコントロールが決まります。  詳細については、「[Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)」を参照してください。  
+  
+3.  <xref:System.Windows.Forms.BindingNavigator> コントロールをフォームにドラッグします。これにより、子テーブル内のデータを移動できるようになります。  
+  
+### データに接続し、コントロールにバインドするには  
+  
+1.  <xref:System.Windows.Forms.ComboBox> を選択し、スマート タスク グリフをクリックして \[スマート タスク\] ダイアログ ボックスを表示します。  
+  
+2.  **\[データ バインド項目を使用する\]** を選択します。  
+  
+3.  **\[データ ソース\]** ドロップダウン ボックスの横の矢印をクリックします。  プロジェクトまたはフォームに対してデータ ソースがすでに構成されている場合はデータ ソースが表示されますが、設定されていない場合は、次の手順を実行します \(この例では、Northwind サンプル データベースの Customers テーブルと Orders テーブルを使用します。これらのテーブルについては括弧の中で参照します\)。  
+  
+    1.  **\[プロジェクト データ ソースの追加\]** をクリックしてデータに接続し、データ ソースを作成します。  
+  
+    2.  **データ ソース構成ウィザード**の開始ページで **\[次へ\]** をクリックします。  
+  
+    3.  **\[データソースの種類を選択\]** ページで、**\[データベース\]** をクリックします。  
+  
+    4.  **\[データ接続の選択\]** ページの利用可能な接続の一覧から、データ接続を選択します。  目的のデータ接続を選択できない場合は、**\[新しい接続\]** を選択して新しいデータ接続を作成します。  
+  
+    5.  **\[次の名前で接続を保存する\]** をオンにして、接続文字列をアプリケーション構成ファイルに保存します。  
+  
+    6.  アプリケーションで使用するデータベース オブジェクトを選択します。  この場合、外部キー リレーションシップを持つ親テーブルと子テーブル \(Customers と Orders など\) を選択します。  
+  
+    7.  必要な場合は、既定のデータセット名を変更します。  
+  
+    8.  **\[完了\]** をクリックします。  
+  
+4.  **\[メンバの表示\]** ドロップダウン ボックスで、コンボ ボックスに表示する列名 \(ContactName など\) を選択します。  
+  
+5.  **\[値メンバ\]** ドロップダウン ボックスで、子テーブルでルックアップ操作を実行する列 \(CustomerID など\) を選択します。  
+  
+6.  **\[選択された値\]** ドロップダウン ボックスで **\[プロジェクト データ ソース\]** に移動し、親テーブルと子テーブルを含む、作成したばかりのデータセットに移動します。  親テーブルの Value Member に対応する、子テーブルのプロパティ \(Orders.CustomerID など\) を選択します。  適切な <xref:System.Windows.Forms.BindingSource>、データ セット、およびテーブル アダプタ コンポーネントが作成され、フォームに追加されます。  
+  
+7.  <xref:System.Windows.Forms.BindingNavigator> コントロールを子テーブルの <xref:System.Windows.Forms.BindingSource> \(`OrdersBindingSource` など\) にバインドします。  
+  
+8.  <xref:System.Windows.Forms.ComboBox> および <xref:System.Windows.Forms.BindingNavigator> コントロール以外のコントロールを、表示する子テーブルの <xref:System.Windows.Forms.BindingSource> \(`OrdersBindingSource` など\) の詳細フィールドにバインドします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [ComboBox コントロール](../../../../docs/framework/winforms/controls/combobox-control-windows-forms.md)   
+ [Visual Studio でのデータへのコントロールのバインド](../Topic/Bind%20controls%20to%20data%20in%20Visual%20Studio.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md b/docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md
new file mode 100644
index 00000000000..cdeeb1045af
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md
@@ -0,0 +1,194 @@
+---
+title: "方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ListView コントロール [Windows フォーム], 例"
+  - "Panel コントロール [Windows フォーム], 例"
+  - "RichTextBox コントロール [Windows フォーム], 例"
+  - "SplitContainer コントロール [Windows フォーム], 例"
+  - "Splitter コントロール [Windows フォーム], 例"
+  - "TreeView コントロール [Windows フォーム], 例"
+ms.assetid: e79f6bcc-3740-4d1e-b46a-c5594d9b7327
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する
+次の手順では、Microsoft Outlook で使用されているユーザー インターフェイスに似た**フォルダー**一覧、**メッセージ** ペイン、および**プレビュー** ペインを備えたマルチペイン ユーザー インターフェイスを作成します。  これは、主にコントロールをフォームにドッキングして作成します。  
+  
+ コントロールをドッキングするときは、どちらの親コンテナーの端にコントロールを固定するかを決定します。  <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定した場合、コントロールの右端が親コントロールの右端にドッキングされます。  さらに、コントロールがドッキングされた端は、そのコンテナー コントロールに合うようにサイズ変更されます。  <xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティの機能の詳細については、「[方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)」を参照してください。  
+  
+ この手順は、機能を追加してアプリケーションを Microsoft Outlook のようにするのではなく、フォーム上に <xref:System.Windows.Forms.SplitContainer> などのコントロールを配置します。  
+  
+ このユーザー インターフェイスを作成するには、左側のパネルに <xref:System.Windows.Forms.TreeView> コントロールを含む <xref:System.Windows.Forms.SplitContainer> コントロール内に、すべてのコントロールを配置します。  <xref:System.Windows.Forms.SplitContainer> コントロールの右側のパネルには、第 2 の <xref:System.Windows.Forms.SplitContainer> コントロールが含まれます。第 2 のコントロールでは、上部に <xref:System.Windows.Forms.ListView> コントロール、その下部に <xref:System.Windows.Forms.RichTextBox> コントロールが配置されます。  これらの <xref:System.Windows.Forms.SplitContainer> コントロールを使用すると、フォーム上の他のコントロールを個別にサイズ変更できます。  この手順に示される手法を応用して、独自のカスタム ユーザー インターフェイスを作成できます。  
+  
+### プログラムで Outlook スタイルのユーザー インターフェイスを作成するには  
+  
+1.  フォーム内で、ユーザー インターフェイスを構成する各コントロールを宣言します。  この例では、<xref:System.Windows.Forms.TreeView>、<xref:System.Windows.Forms.ListView>、<xref:System.Windows.Forms.SplitContainer>、および <xref:System.Windows.Forms.RichTextBox> の各コントロールを使用して、Microsoft Outlook のユーザー インターフェイスを模倣します。  
+  
+    ```vb  
+    Private WithEvents treeView1 As System.Windows.Forms.TreeView  
+    Private WithEvents listView1 As System.Windows.Forms.ListView  
+    Private WithEvents richTextBox1 As System.Windows.Forms.RichTextBox  
+    Private WithEvents splitContainer1 As _  
+        System.Windows.Forms.SplitContainer  
+    Private WithEvents splitContainer2 As _  
+        System.Windows.Forms.SplitContainer  
+  
+    ```  
+  
+    ```csharp  
+    private System.Windows.Forms.TreeView treeView1;  
+    private System.Windows.Forms.ListView listView1;  
+    private System.Windows.Forms.RichTextBox richTextBox1;  
+    private System.Windows.Forms. SplitContainer splitContainer2;  
+    private System.Windows.Forms. SplitContainer splitContainer1;  
+  
+    ```  
+  
+2.  ユーザー インターフェイスを定義するプロシージャを作成します。  次のコードは、フォームが Microsoft Outlook のユーザー インターフェイスに似た外観になるように、プロパティを設定しています。  ただし、他のコントロールを使用したり、異なる方法でコントロールをドッキングしたりすることによって、同じように柔軟性を持つ他のユーザー インターフェイスも簡単に作成できます。  
+  
+    ```vb  
+    Public Sub CreateOutlookUI()  
+        ' Create an instance of each control being used.  
+        Me.components = New System.ComponentModel.Container()  
+        Me.treeView1 = New System.Windows.Forms.TreeView()  
+        Me.listView1 = New System.Windows.Forms.ListView()  
+        Me.richTextBox1 = New System.Windows.Forms.RichTextBox()  
+        Me.splitContainer1 = New System.Windows.Forms.SplitContainer()  
+        Me.splitContainer2= New System.Windows.Forms. SplitContainer()  
+  
+        ' Should you develop this into a working application,  
+        ' use the AddHandler method to hook up event procedures here.  
+  
+        ' Set properties of TreeView control.  
+        ' Use the With statement to avoid repetitive code.  
+        With Me.treeView1  
+            .Dock = System.Windows.Forms.DockStyle.Fill  
+            .TabIndex = 0  
+            .Nodes.Add("treeView")  
+        End With  
+  
+    ' Set properties of ListView control.  
+       With Me.listView1  
+          .Dock = System.Windows.Forms.DockStyle.Top  
+          .TabIndex = 2  
+          .Items.Add("listView")  
+       End With  
+  
+    ' Set properties of RichTextBox control.  
+       With Me.richTextBox1  
+          .Dock = System.Windows.Forms.DockStyle.Fill  
+          .TabIndex = 3  
+          .Text = "richTextBox1"  
+       End With  
+  
+        ' Set properties of the first SplitContainer control.  
+        With Me.splitContainer1  
+            .Dock = System.Windows.Forms.DockStyle.Fill  
+            .TabIndex = 1  
+            .SplitterWidth = 4  
+            .SplitterDistance = 150  
+            .Orientation = Orientation.Horizontal  
+            .Panel1.Controls.Add(Me.listView1)  
+            .Panel2.Controls.Add(Me.richTextBox1)  
+    End With  
+  
+        ' Set properties of the second SplitContainer control.  
+        With Me.splitContainer2  
+            .Dock = System.Windows.Forms.DockStyle.Fill  
+            .TabIndex = 4  
+            .SplitterWidth = 4  
+            .SplitterDistance = 100  
+            .Panel1.Controls.Add(Me.treeView1)  
+            .Panel2.Controls.Add(Me.SplitContainer1)  
+    End With  
+  
+    ' Add the main SplitContainer control to the form.  
+        Me.Controls.Add(Me.splitContainer2)  
+        Me.Text = "Intricate UI Example"  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void createOutlookUI()  
+    {  
+        // Create an instance of each control being used.  
+        treeView1 = new System.Windows.Forms.TreeView();  
+        listView1 = new System.Windows.Forms.ListView();  
+        richTextBox1 = new System.Windows.Forms.RichTextBox();  
+        splitContainer2 = new System.Windows.Forms.SplitContainer();  
+        splitContainer1 = new System.Windows.Forms.SplitContainer();  
+  
+        // Insert code here to hook up event methods.  
+  
+        // Set properties of TreeView control.  
+        treeView1.Dock = System.Windows.Forms.DockStyle.Fill;  
+        treeView1.TabIndex = 0;  
+        treeView1.Nodes.Add("treeView");  
+  
+        // Set properties of ListView control.  
+        listView1.Dock = System.Windows.Forms.DockStyle.Top;  
+        listView1.TabIndex = 2;  
+        listView1.Items.Add("listView");  
+  
+        // Set properties of RichTextBox control.  
+        richTextBox1.Dock = System.Windows.Forms.DockStyle.Fill;  
+        richTextBox1.TabIndex = 3;  
+        richTextBox1.Text = "richTextBox1";  
+  
+        // Set properties of first SplitContainer control.  
+        splitContainer1.Dock = System.Windows.Forms.DockStyle.Fill;  
+        splitContainer2.TabIndex = 1;  
+        splitContainer2.SplitterWidth = 4;  
+        splitContainer2.SplitterDistance = 150;  
+        splitContainer2.Orientation = Orientation.Horizontal;  
+        splitContainer2.Panel1.Controls.Add(this.listView1);  
+        splitContainer2.Panel1.Controls.Add(this.richTextBox1);  
+  
+        // Set properties of second SplitContainer control.  
+        splitContainer2.Dock = System.Windows.Forms.DockStyle.Fill;  
+        splitContainer2.TabIndex = 4;  
+        splitContainer2.SplitterWidth = 4;  
+        splitContainer2.SplitterDistance = 100;  
+        splitContainer2.Panel1.Controls.Add(this.treeView1);  
+        splitContainer2.Panel1.Controls.Add(this.splitContainer1);  
+  
+        // Add the main SplitContainer control to the form.  
+        this.Controls.Add(this.splitContainer2);  
+        this.Text = "Intricate UI Example";  
+    }  
+  
+    ```  
+  
+3.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では、`New()` プロシージャで作成したプロシージャの呼び出しを追加します。  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] では、フォーム クラスのコンストラクターに次のコード行を追加します。  
+  
+    ```vb  
+    ' Add this to the New procedure.  
+    CreateOutlookUI()  
+  
+    ```  
+  
+    ```csharp  
+    // Add this to the form class's constructor.  
+    createOutlookUI();  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)   
+ [方法 : デザイナーを使用して Windows フォームでマルチペイン ユーザー インターフェイスを作成する](../../../../docs/framework/winforms/controls/create-a-multipane-user-interface-with-wf-using-the-designer.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md b/docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md
new file mode 100644
index 00000000000..e60e90f7c72
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "パスワード ボックス, 作成"
+  - "PasswordChar プロパティ (テキスト ボックスの)"
+  - "パスワード, 入力マスク"
+  - "パスワード, パスワード テキスト ボックス"
+  - "TextBox コントロール [Windows フォーム], 入力 (パスワードを)"
+ms.assetid: d105d6b9-3d50-44cd-80d8-2c0e2f486727
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する
+Windows フォーム テキスト ボックスの 1 つであるパスワード ボックスには、文字列を入力したときにプレースホルダー文字が表示されます。  
+  
+### パスワード テキスト ボックスを作成するには  
+  
+1.  <xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.TextBox.PasswordChar%2A> プロパティに特定の文字を設定します。  
+  
+     <xref:System.Windows.Forms.TextBox.PasswordChar%2A> プロパティでは、テキスト ボックスに表示する文字を指定します。  たとえば、パスワード ボックスにアスタリスク \(\*\) を表示する場合は、\[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.TextBox.PasswordChar%2A> プロパティに \* を指定します。  テキスト ボックスに入力した文字に関係なく、アスタリスクが表示されます。  
+  
+2.  \(省略可能\) <xref:System.Windows.Forms.TextBoxBase.MaxLength%2A> プロパティを設定します。  このプロパティでは、テキスト ボックスに入力できる文字数を指定します。  最大長を超えるとビープ音がなり、テキスト ボックスにそれ以上文字を入力できなくなります。  パスワードに最大長を設定するとハッカーがパスワードを推測しやすくなるため、このプロパティは必ずしも設定する必要はありません。  
+  
+     次のコード例では、14 文字までの文字列を入力でき、文字列の代わりにアスタリスクが表示されるテキスト ボックスを初期化します。  `InitializeMyControl` の手順では自動的に実装します ; これを呼び出す必要があります。  
+  
+    > [!IMPORTANT]
+    >  テキスト ボックスで <xref:System.Windows.Forms.TextBox.PasswordChar%2A> プロパティを使用すると、ユーザーがパスワードを入力するときに他の人に見られないようにできます。  このセキュリティ対策では、アプリケーションのロジックによって許可される可能性があるパスワードの保存や伝送を防止することはできません。  入力されたテキストはどのような方法でも暗号化されていないため、他の機密データと同様に扱う必要があります。  パスワードは、表示はされませんが、書式なしテキストの文字列として扱われています。ただし、他に追加のセキュリティ対策を講じている場合は除きます。  
+  
+    ```vb  
+    Private Sub InitializeMyControl()  
+       ' Set to no text.  
+       TextBox1.Text = ""  
+       ' The password character is an asterisk.  
+       TextBox1.PasswordChar = "*"  
+       ' The control will allow no more than 14 characters.  
+       TextBox1.MaxLength = 14  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void InitializeMyControl()  
+    {  
+       // Set to no text.  
+       textBox1.Text = "";  
+       // The password character is an asterisk.  
+       textBox1.PasswordChar = '*';  
+       // The control will allow no more than 14 characters.  
+       textBox1.MaxLength = 14;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void InitializeMyControl()  
+       {  
+          // Set to no text.  
+          textBox1->Text = "";  
+          // The password character is an asterisk.  
+          textBox1->PasswordChar = '*';  
+          // The control will allow no more than 14 characters.  
+          textBox1->MaxLength = 14;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-professionally-styled-toolstrip-control.md b/docs/framework/winforms/controls/how-to-create-a-professionally-styled-toolstrip-control.md
new file mode 100644
index 00000000000..ab25c43b274
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-professionally-styled-toolstrip-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : プロフェッショナル スタイルの ToolStrip コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripProfessionalRenderer クラス [Windows フォーム]"
+  - "ToolStripRenderer クラス [Windows フォーム]"
+ms.assetid: c208b2f6-8105-474b-9075-d582e1792870
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : プロフェッショナル スタイルの ToolStrip コントロールを作成する
+<xref:System.Windows.Forms.ToolStripProfessionalRenderer> 型から派生する独自のクラスを記述することで、アプリケーションの <xref:System.Windows.Forms.ToolStrip> コントロールにプロフェッショナルな外観と動作 \(操作性\) を与えることができます。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に、この機能の広範なサポートがあります。  
+  
+ [チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-a-professionally-styled-toolstrip-control.md).  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Forms.ToolStrip> コントロールを使用して、Microsoft® Outlook® の**ナビゲーション ウィンドウ**に似た複合コントロールを作成する方法について説明します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.StackView#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.StackView#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Drawing アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成](http://msdn.microsoft.com/library/ms233664\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [方法 : フォームに標準メニュー項目を追加する](../../../../docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md b/docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md
new file mode 100644
index 00000000000..86597b17356
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 読み取り専用テキスト ボックスを作成する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "読み取り専用テキスト ボックス"
+  - "テキスト ボックス, 読み取り専用"
+  - "TextBox コントロール [Windows フォーム], 読み取り専用"
+ms.assetid: 60baa9ab-fa57-44ad-bb7c-61b05aa64296
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 読み取り専用テキスト ボックスを作成する (Windows フォーム)
+編集可能な Windows フォーム テキスト ボックスを読み取り専用コントロールに変換できます。  たとえば、アプリケーションの状態によって、テキスト ボックスに、通常は編集されるが現在は編集しない値が表示される場合があります。  
+  
+### 読み取り専用テキスト ボックスを作成するには  
+  
+1.  <xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.TextBoxBase.ReadOnly%2A> プロパティを `true` に設定します。  このプロパティを `true` に設定した場合、テキスト ボックスのテキストは変更できませんが、スクロールおよび強調表示はできます。  テキスト ボックスでは、**\[コピー\]** は使用できますが、**\[切り取り\]** および **\[貼り付け\]** は使用できません。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.TextBoxBase.ReadOnly%2A> プロパティは、実行時のユーザーとの対話だけに影響します。  <xref:System.Windows.Forms.TextBox.Text%2A> プロパティを変更すると、実行時にプログラムによってテキスト ボックスの内容を変更できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-resizable-windows-form-for-data-entry.md b/docs/framework/winforms/controls/how-to-create-a-resizable-windows-form-for-data-entry.md
new file mode 100644
index 00000000000..5fb5329bb0b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-resizable-windows-form-for-data-entry.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : データ入力用のサイズ変更可能な Windows フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 作成 (サイズ変更可能)"
+  - "レイアウト [Windows フォーム], サイズ変更"
+  - "TableLayoutPanel コントロール [Windows フォーム]"
+  - "Windows フォーム, サイズ変更可能"
+ms.assetid: babdf198-404c-485d-a914-ed370c6ecd99
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : データ入力用のサイズ変更可能な Windows フォームを作成する
+レイアウトが優れていると、その親フォームの寸法の変更に柔軟に対応できます。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用すると、フォームの寸法の変更に応じて一貫した方法でコントロールの位置とサイズが変更されるように、フォームのレイアウトを調整できます。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、コントロールの内容の変更によってレイアウトの変更が生じる場合にも便利です。  この手順で説明するプロセスは、Visual Studio 環境内で実行できます。  「[チュートリアル: データ入力用のサイズ変更可能な Windows フォームの作成](http://msdn.microsoft.com/library/991eahec\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ ユーザーによるフォームのサイズ変更に適切に対応するレイアウトを <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用して作成する方法を次の例に示します。  また、ローカリゼーションに適切に対応するレイアウトも示します。  
+  
+ [!code-cpp[System.Windows.Forms.TableLayoutPanel.DataEntryForm#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.DataEntryForm/cpp/basicdataentryform.cpp#1)]
+ [!code-csharp[System.Windows.Forms.TableLayoutPanel.DataEntryForm#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.DataEntryForm/CS/basicdataentryform.cs#1)]
+ [!code-vb[System.Windows.Forms.TableLayoutPanel.DataEntryForm#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.DataEntryForm/VB/basicdataentryform.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする](../../../../docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md)   
+ [『Microsoft Windows User Experience, Official Guidelines for User Interface Developers and Designers』、Redmond、WA: Microsoft Press、1999 年。\(USBN: 0\-7356\-0566\-1\)](http://www.microsoft.com/mspress/southpacific/books/book11588.htm)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-windows-explorer-style-interface-on-a-windows-form.md b/docs/framework/winforms/controls/how-to-create-a-windows-explorer-style-interface-on-a-windows-form.md
new file mode 100644
index 00000000000..191caf2009d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-windows-explorer-style-interface-on-a-windows-form.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : Windows フォームで Windows エクスプローラー スタイルのインターフェイスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, Windows エクスプローラー形式"
+  - "SplitContainer コントロール [Windows フォーム], Explorer-style インターフェイス"
+  - "Windows エクスプローラー, 作成 (Windows フォームを使用して)"
+ms.assetid: 9a3d5f4f-5dda-4350-9ad5-57ce5976dc47
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームで Windows エクスプローラー スタイルのインターフェイスを作成する
+Windows エクスプローラーは、そのユーザー インターフェイスがなじみ深いことから、多くのアプリケーションで採用されています。  
+  
+ 基本的に Windows エクスプローラーとは、<xref:System.Windows.Forms.TreeView> コントロールと <xref:System.Windows.Forms.ListView> コントロールが独立したパネルに配置されたものです。  これらのパネルのサイズは、分割線で変更できます。  このようなコントロールの配置は、情報の表示と参照には非常に有効です。  
+  
+ 次の手順では、Windows エクスプローラーに似た形式でコントロールを配置する方法を示します。  この手順では、Windows エクスプローラー アプリケーションのファイル参照機能を追加する方法は示しません。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### Windows エクスプローラー スタイルの Windows フォームを作成するには  
+  
+1.  新しい Windows アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **\[ツールボックス\]** で次の操作を行います。  
+  
+    1.  <xref:System.Windows.Forms.SplitContainer> コントロールをフォームにドラッグします。  
+  
+    2.  <xref:System.Windows.Forms.TreeView> コントロールを **\[SplitterPanel1\]** \(**\[Panel1\]** とマークされた <xref:System.Windows.Forms.SplitContainer> コントロールのパネル\) にドラッグします。  
+  
+    3.  <xref:System.Windows.Forms.ListView> コントロールを **\[SplitterPanel2\]** \(**\[panel2\]** とマークされた <xref:System.Windows.Forms.SplitContainer> コントロールのパネル\) にドラッグします。  
+  
+3.  Ctrl キーを押しながら、これら 3 つのコントロールすべてを順番にクリックして選択します。  <xref:System.Windows.Forms.SplitContainer> コントロールを選択するときは、パネルではなく、分割バーをクリックします。  
+  
+    > [!NOTE]
+    >  **\[編集\]** メニューの **\[すべて選択\]** は使用しないでください。  このコマンドを使用すると、次の手順で必要なプロパティが **プロパティ** ウィンドウに表示されません。  
+  
+4.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.SplitContainer.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+5.  F5 キーを押してアプリケーションを実行します。  
+  
+     フォームには、Windows エクスプローラーで使用されるような 2 つの部分に分かれたユーザー インターフェイスが表示されます。  
+  
+    > [!NOTE]
+    >  分割線をドラッグすると、パネルのサイズが変更されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md)   
+ [方法 : 分割ウィンドウでのサイズ変更および位置指定動作を定義する](../../../../docs/framework/winforms/controls/how-to-define-resize-and-positioning-behavior-in-a-split-window.md)   
+ [方法 : ウィンドウを水平方向に分割する](../../../../docs/framework/winforms/controls/how-to-split-a-window-horizontally.md)   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md b/docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md
new file mode 100644
index 00000000000..894854ae06e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md
@@ -0,0 +1,103 @@
+---
+title: "方法 : 進行状況を示す Windows フォーム コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 作成"
+  - "コントロール [Windows フォーム], 進行状況の追跡"
+  - "FlashTrackBar カスタム コントロール"
+  - "進行状況, 報告 [Windows フォーム]"
+ms.assetid: 24c5a2e3-058c-4b8d-a217-c06e6a130c2f
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 進行状況を示す Windows フォーム コントロールを作成する
+アプリケーションのレベルまたは進行状況を表示するために使用できる `FlashTrackBar` というカスタム コントロールのコード例を次に示します。  このコントロールは、グラデーションを使用して進行状況を表示します。  
+  
+ `FlashTrackBar` コントロールには次のような機能が含まれます。  
+  
+-   カスタム プロパティの定義。  
+  
+-   カスタム イベントの定義  \(`FlashTrackBar` は `ValueChanged` イベントを定義します\)。  
+  
+-   コントロールを描画するロジックを提供するための、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドのオーバーライド。  
+  
+-   <xref:System.Windows.Forms.Control.ClientRectangle%2A> プロパティを使用した、コントロールの描画に利用できる領域の計算。  `FlashTrackBar` は、`OptimizedInvalidate` メソッドでこの計算を実行します。  
+  
+-   Windows フォーム デザイナー内でプロパティが変更されたときの、プロパティのシリアル化または永続化の実装。  `FlashTrackBar` は `StartColor` プロパティと `EndColor` プロパティをシリアル化するために、`ShouldSerializeStartColor` メソッドと `ShouldSerializeEndColor` メソッドを定義します。  
+  
+ `FlashTrackBar` によって定義されるカスタム プロパティを次の表に示します。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|`AllowUserEdit`|ユーザーがフラッシュ トラック バーをクリックまたはドラッグして値を変更できるかどうかを示します。|  
+|`EndColor`|トラック バーの終了色を指定します。|  
+|`DarkenBy`|前景のグラデーションを基準にして、背景のグラデーションをどの程度の濃さにするかを指定します。|  
+|`Max`|トラック バーの最大値を指定します。|  
+|`Min`|トラック バーの最小値を指定します。|  
+|`StartColor`|グラデーションの開始色を指定します。|  
+|`ShowPercentage`|グラデーションの上にパーセントを表示するかどうかを示します。|  
+|`ShowValue`|グラデーションの上に現在の値を表示するかどうかを示します。|  
+|`ShowGradient`|現在の値を表示した色のグラデーションをトラック バーに表示するかどうかを示します。|  
+|-   `Value`|トラック バーの現在の値を指定します。|  
+  
+ 次の表は、`FlashTrackBar` によって定義される追加メンバーである、プロパティ変更イベント、およびイベントを発生させるメソッドを示しています。  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|`ValueChanged`|トラック バーの `Value` プロパティが変更されたときに発生するイベント。|  
+|`OnValueChanged`|`ValueChanged` イベントを発生させるメソッド。|  
+  
+> [!NOTE]
+>  `FlashTrackBar` では、イベント データに <xref:System.EventArgs> クラスを使用し、イベント デリゲートに <xref:System.EventHandler> を使用します。  
+  
+ 対応する *EventName* イベントを処理するために、`FlashTrackBar` は <xref:System.Windows.Forms.Control?displayProperty=fullName> から継承した次のメソッドをオーバーライドします。  
+  
+-   <xref:System.Windows.Forms.Control.OnPaint%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnMouseDown%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnMouseMove%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnMouseUp%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnResize%2A>  
+  
+ 対応するプロパティ変更イベントを処理するために、`FlashTrackBar` は <xref:System.Windows.Forms.Control?displayProperty=fullName> から継承した次のメソッドをオーバーライドします。  
+  
+-   <xref:System.Windows.Forms.Control.OnBackColorChanged%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnBackgroundImageChanged%2A>  
+  
+-   <xref:System.Windows.Forms.Control.OnTextChanged%2A>  
+  
+## 使用例  
+ `FlashTrackBar` コントロールは、次のコード一覧に示すとおり、`FlashTrackBarValueEditor` と `FlashTrackBarDarkenByEditor` という 2 つの UI 型エディターを定義します。  `HostApp` クラスは、Windows フォームで `FlashTrackBar` コントロールを使用します。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#1)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#1)]  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBarDarkenByEditor.cs#10)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBarDarkenByEditor.vb#10)]  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBarValueEditor.cs#20)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBarValueEditor.vb#20)]  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/HostApp.cs#30)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/HostApp.vb#30)]  
+  
+## 参照  
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)   
+ [Windows フォーム コントロール開発の基本概念](../../../../docs/framework/winforms/controls/windows-forms-control-development-basics.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls-using-the-designer.md b/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls-using-the-designer.md
new file mode 100644
index 00000000000..f3743f89175
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls-using-the-designer.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム コントロールのアクセス キーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス キー, 作成 (コントロールの)"
+  - "アクセス キー, Windows フォーム"
+  - "ALT キー"
+  - "アンパサンド文字 (ショートカット キーの)"
+  - "Button コントロール [Windows フォーム], アクセス キー"
+  - "コントロール [Windows フォーム], アクセス キー"
+  - "ダイアログ ボックス コントロール, ニーモニック"
+  - "例 [Windows フォーム], コントロール"
+  - "ショートカット キー, 作成 (コントロールの)"
+  - "ニーモニック, 追加 (ダイアログ ボックス コントロールに)"
+  - "Text プロパティ, 指定 (コントロールのアクセス キーを)"
+  - "Windows フォーム コントロール, アクセス キー"
+ms.assetid: 4c374c4c-4ca9-4a68-ac96-9dc3ab0f518a
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : デザイナーを使用して Windows フォーム コントロールのアクセス キーを作成する
+*アクセス キー*は、メニュー、メニュー項目、コントロールのラベル \(ボタンなど\) のテキストに含まれている下線付きの文字です。  定義済みのアクセス キーを Alt キーと一緒に押すことにより、ユーザーはボタンを "クリック" できます。  たとえば、フォームを印刷するためのプロシージャを実行するボタンで、`Text` プロパティが "Print" に設定されている場合は、文字 "P" の前にアンパサンド \(&\) を追加すると、実行時にボタンのテキスト内で "P" に下線が引かれます。  ユーザーは、Alt キーを押しながら P キーを押すことにより、ボタンに関連付けられたコマンドを実行できます。  フォーカスを持つことができないコントロールに対しては、アクセス キーを定義できません。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールのアクセス キーを作成するには  
+  
+1.  **\[プロパティ\]** ウィンドウで、アクセス キーとして使用する文字の前にアンパサンド \(&\) を含む文字列に `Text` プロパティを設定します。  たとえば、文字 "P" をアクセス キーとして設定する場合は、グリッドに「&Print」と入力します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Button>   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md b/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md
new file mode 100644
index 00000000000..9d44e7ff2bd
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : Windows フォーム コントロールのアクセス キーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス キー, 作成 (コントロールの)"
+  - "アクセス キー, Windows フォーム"
+  - "ALT キー"
+  - "アンパサンド文字 (ショートカット キーの)"
+  - "Button コントロール [Windows フォーム], アクセス キー"
+  - "コントロール [Windows フォーム], アクセス キー"
+  - "ダイアログ ボックス コントロール, ニーモニック"
+  - "例 [Windows フォーム], コントロール"
+  - "ショートカット キー, 作成 (コントロールの)"
+  - "ニーモニック"
+  - "ニーモニック, 追加 (ダイアログ ボックス コントロールに)"
+  - "Text プロパティ, 指定 (コントロールのアクセス キーを)"
+  - "Windows フォーム コントロール, アクセス キー"
+ms.assetid: 4faa0991-28ec-4eca-91db-51dc2cd6a7ac
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム コントロールのアクセス キーを作成する
+*アクセス キー*は、メニュー、メニュー項目、コントロールのラベル \(ボタンなど\) のテキストに含まれている下線付きの文字です。  定義済みのアクセス キーを Alt キーと一緒に押すと、ボタンを "クリック" した場合と同じ結果になります。  たとえば、フォームを印刷するためのプロシージャを実行するボタンで、`Text` プロパティが "Print" に設定されている場合は、文字 "P" の前にアンパサンド \(&\) を追加すると、実行時にボタンのテキスト内で "P" に下線が引かれます。  ユーザーは、Alt キーを押しながら P キーを押すことにより、ボタンに関連付けられたコマンドを実行できます。  フォーカスを持つことができないコントロールに対しては、アクセス キーを定義できません。  
+  
+### コントロールのアクセス キーを作成するには  
+  
+1.  ショートカットとして使用する文字の前にアンパサンド \(&\) を含む文字列に `Text` プロパティを設定します。  
+  
+    ```vb  
+    ' Set the letter "P" as an access key.  
+    Button1.Text = "&Print"  
+  
+    ```  
+  
+    ```csharp  
+    // Set the letter "P" as an access key.  
+    button1.Text = "&Print";  
+  
+    ```  
+  
+    ```cpp  
+    // Set the letter "P" as an access key.  
+    button1->Text = "&Print";  
+    ```  
+  
+    > [!NOTE]
+    >  アンパサンドをアクセス キーを作成するための記号としてではなく、文字として表示する場合は、アンパサンドを 2 回続けて記述 \(&&\) します。  この場合、画面に表示されるアンパサンドは 1 個だけで、どの文字にも下線は付けられません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Button>   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md b/docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md
new file mode 100644
index 00000000000..74de6cd0740
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : Windows フォームの Label コントロールでアクセス キーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス キー, 作成 (コントロールの)"
+  - "アクセス キー, Windows フォーム"
+  - "コントロール [Windows フォーム], アクセス キー"
+  - "ダイアログ ボックス コントロール, ニーモニック"
+  - "ショートカット キー, 作成 (コントロールの)"
+  - "Label コントロール [Windows フォーム], 作成 (アクセス キーを)"
+  - "ニーモニック"
+  - "ニーモニック, 追加 (ダイアログ ボックス コントロールに)"
+  - "UseMnemonic プロパティ, Label コントロール"
+  - "Windows フォーム コントロール, アクセス キー"
+ms.assetid: 5ee8f823-80be-4a4f-96a4-412671e2e306
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームの Label コントロールでアクセス キーを作成する
+Windows フォーム <xref:System.Windows.Forms.Label> コントロールを使用すると、他のコントロールのアクセス キーを定義できます。  ラベル コントロールにアクセス キーを定義すると、**Alt** キーを押しながら指定した文字を押して、タブ オーダーで次に設定されているコントロールにフォーカスを移すことができます。  ラベルはフォーカスを受け取ることができないため、タブ オーダー内の次のコントロールに自動的にフォーカスが移ります。  この機能を使用して、テキスト ボックス、コンボ ボックス、リスト ボックス、およびデータ グリッドにアクセス キーを割り当てます。  
+  
+### ラベルを含むコントロールにアクセス キーを割り当てるには  
+  
+1.  まずラベルを描画し、次に他のコントロールを描画します。  
+  
+     または  
+  
+     任意の順序でコントロールを描画し、ラベルの <xref:System.Windows.Forms.Control.TabIndex%2A> プロパティにもう一方のコントロールより 1 つ小さい値を設定します。  
+  
+2.  ラベルの <xref:System.Windows.Forms.Label.UseMnemonic%2A> プロパティを `true` に設定します。  
+  
+3.  ラベルの <xref:System.Windows.Forms.Label.Text%2A> プロパティでアンパサンド \(&\) を使用して、ラベルにアクセス キーを割り当てます。  詳細については、「[Windows フォーム コントロールのアクセス キーの作成](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  アンパサンドでアクセス キーを作成するのではなく、ラベル コントロールにアンパサンドを表示することもできます。  この方法は、データにアンパサンドが含まれるレコードセット内で、フィールドにラベル コントロールを連結する場合に役立ちます。  ラベル コントロールにアンパサンドを表示するには、<xref:System.Windows.Forms.Label.UseMnemonic%2A> プロパティを `false` に設定します。  アンパサンド \(&\) を表示しながら、アクセス キーも設定する場合は、<xref:System.Windows.Forms.Label.UseMnemonic%2A> プロパティを `true` に設定して、アクセス キーは 1 つのアンパサンドで表し、アンパサンドは 2 つのアンパサンドで表します。  
+  
+    ```vb  
+    Label1.UseMnemonic = True  
+    Label1.Text = "&Print"  
+    Label2.UseMnemonic = True  
+    Label2.Text = "&Copy && Paste"  
+  
+    ```  
+  
+    ```csharp  
+    label1.UseMnemonic = true;  
+    label1.Text = "&Print";  
+    label2.UseMnemonic = true;  
+    label2.Text = "&Copy && Paste";  
+  
+    ```  
+  
+    ```cpp  
+    label1->UseMnemonic = true;  
+    label1->Text = "&Print";  
+    label2->UseMnemonic = true;  
+    label2->Text = "&Copy && Paste";  
+    ```  
+  
+## 参照  
+ [方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する](../../../../docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md)   
+ [Label コントロールの概要](../../../../docs/framework/winforms/controls/label-control-overview-windows-forms.md)   
+ [Label コントロール](../../../../docs/framework/winforms/controls/label-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md b/docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..39ef8f29cdd
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドキュメント ビューアー"
+  - "WebBrowser コントロール [Windows フォーム], 作成 (HTML ドキュメント ビューアーを)"
+  - "Windows フォーム, 作成 (ドキュメント ビューアーを)"
+ms.assetid: 6a6338fe-f7ee-4f5e-9d8f-0465c57e9039
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する
+<xref:System.Windows.Forms.WebBrowser> コントロールを使用すると、インターネット Web ブラウザーの全機能を使用することなく、HTML ドキュメントを表示および印刷できます。  このコントロールは、信頼できない Web コントロールや、悪意のあるスクリプト コードを含む可能性のある Web ページの読み込みをユーザーに許可することなく、HTML の書式設定機能を利用する場合に便利です。  このように、<xref:System.Windows.Forms.WebBrowser> コントロールの機能を制限して、HTML 電子メール ビューアーとして使用したり、アプリケーションで HTML 形式のヘルプを表示したりできます。  
+  
+### HTML ドキュメント ビューアーを作成するには  
+  
+1.  <xref:System.Windows.Forms.WebBrowser.AllowWebBrowserDrop%2A> プロパティを `false` に設定して、<xref:System.Windows.Forms.WebBrowser> コントロールにファイルをドロップしたときに、そのファイルが開かないようにします。  
+  
+     [!code-csharp[WebBrowserMisc#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/WebBrowserMisc/CS/WebBrowserMisc.cs#20)]
+     [!code-vb[WebBrowserMisc#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WebBrowserMisc/vb/WebBrowserMisc.vb#20)]  
+  
+2.  <xref:System.Windows.Forms.WebBrowser.Url%2A> プロパティを最初のファイルを表示する位置に設定します。  
+  
+     [!code-csharp[WebBrowserMisc#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/WebBrowserMisc/CS/WebBrowserMisc.cs#21)]
+     [!code-vb[WebBrowserMisc#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WebBrowserMisc/vb/WebBrowserMisc.vb#21)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `webBrowser1` という名前の <xref:System.Windows.Forms.WebBrowser> コントロール。  
+  
+-   `System` アセンブリおよび `System.Windows.Forms` アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ <xref:System.Windows.Forms.WebBrowser.AllowWebBrowserDrop%2A>   
+ <xref:System.Windows.Forms.WebBrowser.Url%2A>   
+ [WebBrowser コントロールの概要](../../../../docs/framework/winforms/controls/webbrowser-control-overview.md)   
+ [WebBrowser セキュリティ](../../../../docs/framework/winforms/controls/webbrowser-security.md)   
+ [方法 : WebBrowser コントロールで URL に移動する](../../../../docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md)   
+ [方法 : WebBrowser コントロールを使用して印刷する](../../../../docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md b/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md
new file mode 100644
index 00000000000..b20f6910221
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripPanel コントロール [Windows フォーム]"
+ms.assetid: 64992ed9-44af-4baf-b45f-863e6ab35711
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する
+<xref:System.Windows.Forms?displayProperty=fullName> 名前空間は、マルチ ドキュメント インターフェイス \(MDI\) アプリケーションをサポートし、<xref:System.Windows.Forms.MenuStrip> コントロールはメニューの結合をサポートします。  MDI フォームは、<xref:System.Windows.Forms.ToolStrip> コントロールもサポートします。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に、この機能の広範なサポートがあります。  
+  
+ 「[チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する](http://msdn.microsoft.com/library/ms233676\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStripPanel> コントロールを MDI フォームで使用する方法を示します。  フォームは、子メニューをマージするメニューもサポートしています。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.MdiForm#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.MdiForm/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.MdiForm#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.MdiForm/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ このコード例で必要な要素は次のとおりです。  
+  
+-   System.Drawing アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-toolstrippanel-controls.md b/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-toolstrippanel-controls.md
new file mode 100644
index 00000000000..59c5fb90afa
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-an-mdi-form-with-toolstrippanel-controls.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : ToolStripPanel コントロールを持つ MDI フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI フォーム"
+  - "MDI フォーム, 作成"
+  - "MDI, 作成 (フォームを)"
+  - "マルチ ドキュメント インターフェイス (MDI) フォーム"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripPanel コントロール [Windows フォーム]"
+ms.assetid: d198ef8e-f7c4-4b3f-a7f5-ce858cb90cec
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ToolStripPanel コントロールを持つ MDI フォームを作成する
+上下左右すべての側に <xref:System.Windows.Forms.ToolStrip> コントロールを配置したマルチ ドキュメント インターフェイス \(MDI\) フォームを作成できます。  
+  
+## 使用例  
+ 次のコード例は、ドッキングされた <xref:System.Windows.Forms.ToolStripPanel> コントロールを使用して、4 つの <xref:System.Windows.Forms.ToolStrip> コントロールを MDI ウィンドウの周囲に配置する方法を示します。  
+  
+ この例では、<xref:System.Windows.Forms.ToolStripPanel.Join%2A> メソッドにより、<xref:System.Windows.Forms.ToolStrip> コントロールを、対応する <xref:System.Windows.Forms.ToolStripPanel> コントロールにアタッチしています。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#10)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#10)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Drawing アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripPanel>   
+ <xref:System.Windows.Forms.ToolStripPanel.Join%2A>   
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md b/docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md
new file mode 100644
index 00000000000..c23754541d3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, 作成 (ウィンドウの一覧を)"
+  - "MenuStrip コントロール [Windows フォーム], 作成 (ウィンドウの一覧を)"
+ms.assetid: 04fb414b-811f-4a83-aab6-b4a24646dec5
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する (Windows フォーム)
+マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) を使用してアプリケーションを作成すると、複数のドキュメントを同時に開いて、ドキュメント間で内容のコピーおよび貼り付けを行うことができます。  
+  
+ ここでは、親フォームの \[ウィンドウ\] メニューに、すべてのアクティブな子フォームの一覧を作成する方法について説明します。  
+  
+### MDI ウィンドウの一覧を MenuStrip 上に作成するには  
+  
+1.  フォームを作成し、その <xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定します。  
+  
+2.  フォームに <xref:System.Windows.Forms.MenuStrip> を追加します。  
+  
+3.  2 つのトップレベル メニュー項目を <xref:System.Windows.Forms.MenuStrip> に追加し、その <xref:System.Windows.Forms.Control.Text%2A> プロパティをそれぞれ `&File` と `&Window` に設定します。  
+  
+4.  サブメニュー項目を `&File` メニュー項目に追加し、その <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティを `&Open` に設定します。  
+  
+5.  `&Window` <xref:System.Windows.Forms.ToolStripMenuItem> に <xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A> のプロパティを設定します。  
+  
+6.  プロジェクトにフォームを追加し、このフォームに必用なコントロール \(別の <xref:System.Windows.Forms.MenuStrip> など\) を追加します。  
+  
+7.  `&New` <xref:System.Windows.Forms.ToolStripMenuItem> の <xref:System.Windows.Forms.Control.Click> のイベントのイベント ハンドラーを作成します。  
+  
+8.  このイベント ハンドラー内に次のようなコードを挿入し、`Form1` の MDI 子フォームとして `Form2` の新しいインスタンスを作成および表示します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(ByVal sender As _  
+    System.Object, ByVal e As System.EventArgs) Handles _  
+    openToolStripMenuItem.Click  
+        Dim NewMDIChild As New Form2()  
+        'Set the parent form of the child window.  
+            NewMDIChild.MdiParent = Me  
+        'Display the new form.  
+            NewMDIChild.Show()  
+    End Sub  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void newToolStripMenuItem_Click(object sender, EventArgs e)  
+    {  
+        Form2 newMDIChild = new Form2();  
+        // Set the parent form of the child window.  
+            newMDIChild.MdiParent = this;  
+        // Display the new form.  
+            newMDIChild.Show();  
+    }  
+  
+    ```  
+  
+9. イベント ハンドラーを登録するに `&New`<xref:System.Windows.Forms.ToolStripMenuItem> に次のようなコードを配置します。  
+  
+    ```vb  
+    Private Sub newToolStripMenuItem_Click(sender As Object, e As _  
+    EventArgs) Handles newToolStripMenuItem.Click  
+  
+    ```  
+  
+    ```csharp  
+    this.newToolStripMenuItem.Click += new System.EventHandler(this.newToolStripMenuItem_Click);  
+  
+    ```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `Form1` と `Form2` という名前の 2 つの <xref:System.Windows.Forms.Form> コントロール。  
+  
+-   `menuStrip1` という名前の `Form1` の <xref:System.Windows.Forms.MenuStrip> コントロール、および `menuStrip2` という名前の `Form2` の <xref:System.Windows.Forms.MenuStrip> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..118ec85e926
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], バインドされていない"
+  - "DataGridView コントロール [Windows フォーム], 表示 (データ ソースにバインドせずにデータを)"
+  - "DataGridView コントロール [Windows フォーム], バインドされていないデータ"
+ms.assetid: b5d4b47d-9a28-4d88-9dba-0a3c90fba71d
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する
+<xref:System.Windows.Forms.DataGridView> コントロールをデータ ソースにバインドせずに、プログラムでデータを設定する方法を次のコード例に示します。  これは、少量のデータを表形式で表示する必要がある場合に便利です。  
+  
+ このコード例の詳細な説明については、「[チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-master-detail-lists-with-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-create-master-detail-lists-with-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..f92ad205ef5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-master-detail-lists-with-the-windows-forms-datagrid-control.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGrid コントロール [Windows フォーム], マスター/詳細リスト"
+  - "マスター/詳細リスト"
+  - "関連テーブル, 表示 (DataGrid コントロールで)"
+ms.assetid: 20388c6a-94f9-4d96-be18-8c200491247f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGrid コントロールを使用してマスター/詳細リストを作成する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Data.DataSet> に一連の互いに関連するテーブルが含まれている場合は、2 つの <xref:System.Windows.Forms.DataGrid> コントロールを使用してデータをマスター\/詳細形式で表示できます。  一方の <xref:System.Windows.Forms.DataGrid> をマスター グリッドに指定し、もう一方を詳細グリッドに指定します。  マスター リストのエントリを選択すると、関連するすべての子エントリが詳細リストに表示されます。  たとえば、<xref:System.Data.DataSet> に Customers テーブルおよび関連する Orders テーブルが含まれている場合は、Customers テーブルをマスター グリッドに指定し、Orders テーブルを詳細グリッドに指定します。  マスター グリッドから顧客が選択されると、Orders テーブル内でその顧客に関連するすべての注文が、詳細グリッドに表示されます。  
+  
+### プログラムでマスター\/詳細リレーションシップを設定するには  
+  
+1.  2 つの <xref:System.Windows.Forms.DataGrid> コントロールを新規作成し、そのプロパティを設定します。  
+  
+2.  データセットにテーブルを追加します。  
+  
+3.  作成するリレーションシップを表す <xref:System.Data.DataRelation> 型の変数を宣言します。  
+  
+4.  リレーションシップの名前と、2 つのテーブルを結び付けるテーブル、列、および項目を指定して、リレーションシップをインスタンス化します。  
+  
+5.  <xref:System.Data.DataSet> オブジェクトの <xref:System.Data.DataSet.Relations%2A> コレクションにリレーションシップを追加します。  
+  
+6.  <xref:System.Windows.Forms.DataGrid> の <xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用して、各グリッドを <xref:System.Data.DataSet> にバインドします。  
+  
+     次の例は、前に生成した <xref:System.Data.DataSet> \(`ds`\) 内の Customers テーブルと Orders テーブルの間にマスター\/詳細リレーションシップを設定する方法を示しています。  
+  
+    ```vb  
+    Dim myDataRelation As DataRelation  
+    myDataRelation = New DataRelation _  
+       ("CustOrd", ds.Tables("Customers").Columns("CustomerID"), _  
+       ds.Tables("Orders").Columns("CustomerID"))  
+    ' Add the relation to the DataSet.  
+    ds.Relations.Add(myDataRelation)  
+    GridOrders.SetDataBinding(ds, "Customers")  
+    GridDetails.SetDataBinding(ds, "Customers.CustOrd")  
+  
+    ```  
+  
+    ```csharp  
+    DataRelation myDataRelation;  
+    myDataRelation = new DataRelation("CustOrd", ds.Tables["Customers"].Columns["CustomerID"], ds.Tables["Orders"].Columns["CustomerID"]);  
+    // Add the relation to the DataSet.  
+    ds.Relations.Add(myDataRelation);  
+    GridOrders.SetDataBinding(ds,"Customers");  
+    GridDetails.SetDataBinding(ds,"Customers.CustOrd");  
+  
+    ```  
+  
+    ```cpp  
+    DataRelation^ myDataRelation;  
+    myDataRelation = gcnew DataRelation("CustOrd",  
+       ds->Tables["Customers"]->Columns["CustomerID"],  
+       ds->Tables["Orders"]->Columns["CustomerID"]);  
+    // Add the relation to the DataSet.  
+    ds->Relations->Add(myDataRelation);  
+    GridOrders->SetDataBinding(ds, "Customers");  
+    GridDetails->SetDataBinding(ds, "Customers.CustOrd");  
+    ```  
+  
+## 参照  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)   
+ [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-toggle-buttons-in-toolstrip-controls.md b/docs/framework/winforms/controls/how-to-create-toggle-buttons-in-toolstrip-controls.md
new file mode 100644
index 00000000000..e3fc82338bd
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-toggle-buttons-in-toolstrip-controls.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : ToolStrip コントロールにトグル ボタンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "トグル ボタン, 作成"
+  - "ToolStrip コントロール [Windows フォーム], 作成 (トグル ボタンを)"
+ms.assetid: d9c197df-4c65-43f2-beee-b68b52b2befc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ToolStrip コントロールにトグル ボタンを作成する
+ユーザーがトグル ボタンをクリックすると、ボタンはくぼんだように表示され、ユーザーがボタンをもう一度クリックするまでくぼんだ外観を保持します。  
+  
+### 切り替えのある ToolStripButton を作成するには  
+  
+-   次のようなコードを使用します。  このコードでは、フォームに <xref:System.Windows.Forms.ToolStrip> コントロールが含まれていること、およびその <xref:System.Windows.Forms.ToolStrip.Items%2A> コレクションに `toolStripButton1` という名前の <xref:System.Windows.Forms.ToolStripButton> が含まれていることを前提としています。  また、`toolStripButton1_CheckedChanged` という名前のイベント ハンドラーがあることも前提としています。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    toolStripButton1.CheckOnClick = True  
+    toolStripButton1.CheckedChanged AddressOf _  
+    EventHandler(toolStripButton1_CheckedChanged);  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    toolStripButton1.CheckOnClick = true;  
+    toolStripButton1.CheckedChanged += new _  
+    EventHandler(toolStripButton1_CheckedChanged);  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripButton>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-create-variable-sized-text-in-a-combobox-control.md b/docs/framework/winforms/controls/how-to-create-variable-sized-text-in-a-combobox-control.md
new file mode 100644
index 00000000000..fbbe22fa2d3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-create-variable-sized-text-in-a-combobox-control.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : ComboBox コントロールにサイズ変更可能なテキストを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンボ ボックス, 描画 (テキストを)"
+  - "ComboBox コントロール [Windows フォーム], 描画 (カスタム テキストを)"
+  - "ComboBox コントロール [Windows フォーム], 例 [C#]"
+  - "例 [Windows フォーム], ComboBox コントロール"
+  - "テキスト, 描画 (コンボ ボックスに)"
+ms.assetid: ce39b9ea-e626-49fe-bd5a-f567f6d157df
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ComboBox コントロールにサイズ変更可能なテキストを作成する
+この例では、<xref:System.Windows.Forms.ComboBox> コントロールでのテキストのカスタム描画の方法を示します。  項目が特定の基準を満たす場合、より大きなフォントで描画され赤色になります。  
+  
+## 使用例  
+  
+```vb  
+Private Sub ComboBox1_MeasureItem(ByVal sender As Object, ByVal e As _  
+System.Windows.Forms.MeasureItemEventArgs) Handles ComboBox1.MeasureItem  
+    Dim bFont As New Font("Arial", 8, FontStyle.Bold)  
+    Dim lFont As New Font("Arial", 12, FontStyle.Bold)  
+    Dim siText As SizeF  
+  
+    If ComboBox1.Items().Item(e.Index) = "Two" Then  
+        siText = e.Graphics.MeasureString(ComboBox1.Items().Item(e.Index), _  
+lFont)  
+    Else  
+        siText = e.Graphics.MeasureString(ComboBox1.Items().Item(e.Index), bFont)  
+    End If  
+  
+    e.ItemHeight = siText.Height  
+    e.ItemWidth = siText.Width  
+End Sub  
+  
+Private Sub ComboBox1_DrawItem(ByVal sender As Object, ByVal e As _  
+System.Windows.Forms.DrawItemEventArgs) Handles ComboBox1.DrawItem  
+    Dim g As Graphics = e.Graphics  
+    Dim bFont As New Font("Arial", 8, FontStyle.Bold)  
+    Dim lFont As New Font("Arial", 12, FontStyle.Bold)  
+  
+    If ComboBox1.Items().Item(e.Index) = "Two" Then  
+        g.DrawString(ComboBox1.Items.Item(e.Index), lfont, Brushes.Red, _  
+e.Bounds.X, e.Bounds.Y)  
+    Else  
+        g.DrawString(ComboBox1.Items.Item(e.Index), bFont, Brushes.Black, e.Bounds.X, e.Bounds.Y)  
+    End If  
+End Sub  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Windows フォーム。  
+  
+-   <xref:System.Windows.Forms.ComboBox.Items%2A> プロパティに 3 つの項目を持つ、 `ListBox1`  という名前の <xref:System.Windows.Forms.ComboBox> コントロール。  この例では、3 つの項目に  `"One", Two", and Three"` という名前が付けられています。   `ComboBox1`  の <xref:System.Windows.Forms.ComboBox.DrawMode%2A> プロパティを <xref:System.Windows.Forms.DrawMode> に設定する必要があります。  
+  
+    > [!NOTE]
+    >  この手法は <xref:System.Windows.Forms.ListBox> コントロールにも適用できます。その場合は、<xref:System.Windows.Forms.ComboBox> の代わりに <xref:System.Windows.Forms.ListBox> を使用します。  
+  
+-   <xref:System.Windows.Forms?displayProperty=fullName> 名前空間および <xref:System.Drawing?displayProperty=fullName> 名前空間への参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox.DrawItem>   
+ <xref:System.Windows.Forms.DrawItemEventArgs>   
+ <xref:System.Windows.Forms.ComboBox.MeasureItem>   
+ [組み込みのオーナー描画サポートを備えたコントロール](../../../../docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md)   
+ [ListBox コントロール](../../../../docs/framework/winforms/controls/listbox-control-windows-forms.md)   
+ [ComboBox コントロール](../../../../docs/framework/winforms/controls/combobox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-custom-draw-a-toolstrip-control.md b/docs/framework/winforms/controls/how-to-custom-draw-a-toolstrip-control.md
new file mode 100644
index 00000000000..16f03a9e4eb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-custom-draw-a-toolstrip-control.md
@@ -0,0 +1,162 @@
+---
+title: "方法 : ToolStrip コントロールをカスタム描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム描画"
+  - "描画, カスタム"
+  - "描画, オーナー"
+  - "例 [Windows フォーム], ツール バー"
+  - "オーナー描画"
+  - "ProfessionalColorTable クラス, オーバーライド"
+  - "RenderMode プロパティ"
+  - "ツール バー [Windows フォーム], 変更 (色を)"
+  - "ツール バー [Windows フォーム], カスタム描画"
+  - "ToolStrip コントロール [Windows フォーム], 変更 (色を)"
+  - "ToolStrip コントロール [Windows フォーム], 描画"
+  - "ToolStripProfessionalRenderer クラス"
+  - "ToolStripRenderer クラス"
+  - "ToolStripRenderMode クラス"
+  - "ToolStripSystemRenderer クラス"
+ms.assetid: 94e7d7bd-a752-441c-b5b3-7acf98881163
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ToolStrip コントロールをカスタム描画する
+<xref:System.Windows.Forms.ToolStrip> コントロールに、次のレンダリング \(描画\) クラスが関連付けられています。  
+  
+-   <xref:System.Windows.Forms.ToolStripSystemRenderer> は、オペレーティング システムの外観とスタイルを提供します。  
+  
+-   <xref:System.Windows.Forms.ToolStripProfessionalRenderer> は、Microsoft Office の外観とスタイルを提供します。  
+  
+-   <xref:System.Windows.Forms.ToolStripRenderer> は、その他の 2 つのレンダリング クラスの抽象基本クラスです。  
+  
+ <xref:System.Windows.Forms.ToolStrip> をカスタムで描画 \(オーナー描画\) するために、レンダラー クラスの 1 つをオーバーライドして表示ロジックの特定の側面を変更できます。  
+  
+ 次の手順は、カスタムの描画のさまざまな側面について説明します。  
+  
+### 設定されているレンダラー間で切り替えるには  
+  
+-   <xref:System.Windows.Forms.ToolStrip.RenderMode%2A> プロパティを任意の <xref:System.Windows.Forms.ToolStripRenderMode> の値に設定します。  
+  
+     <xref:System.Windows.Forms.ToolStripRenderMode> と共に、静的な <xref:System.Windows.Forms.ToolStrip.RenderMode%2A> がアプリケーションのレンダラーを決定します。  <xref:System.Windows.Forms.ToolStripRenderMode> のその他の値は、<xref:System.Windows.Forms.ToolStripRenderMode>、<xref:System.Windows.Forms.ToolStripRenderMode>、および <xref:System.Windows.Forms.ToolStripRenderMode> です。  
+  
+### Microsoft Office スタイルの境界を直線に変更するには  
+  
+-   <xref:System.Windows.Forms.ToolStripProfessionalRenderer.OnRenderToolStripBorder%2A?displayProperty=fullName> をオーバーライドしますが、基本クラスは呼び出しません。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStripRenderer>、<xref:System.Windows.Forms.ToolStripSystemRenderer>、および <xref:System.Windows.Forms.ToolStripProfessionalRenderer> に対して、このメソッドのバージョンがあります。  
+  
+### ProfessionalColorTable を変更するには  
+  
+-   <xref:System.Windows.Forms.ProfessionalColorTable> をオーバーライドして必要な色を変更します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As _  
+    System.EventArgs) Handles Me.Load  
+        Dim t As MyColorTable = New MyColorTable  
+        ToolStrip1.Renderer = New ToolStripProfessionalRenderer(t)  
+    End Sub  
+  
+    Class MyColorTable   
+    Inherits ProfessionalColorTable  
+  
+    Public Overrides ReadOnly Property ButtonPressedGradientBegin() As Color  
+        Get  
+            Return Color.Red  
+        End Get  
+    End Property  
+  
+    Public Overrides ReadOnly Property ButtonPressedGradientMiddle() _  
+    As System.Drawing.Color  
+        Get  
+            Return Color.Blue  
+        End Get  
+            End Property  
+  
+    Public Overrides ReadOnly Property ButtonPressedGradientEnd() _  
+    As System.Drawing.Color  
+        Get  
+            Return Color.Green  
+        End Get  
+    End Property  
+  
+    Public Overrides ReadOnly Property ButtonSelectedGradientBegin() _  
+    As Color  
+        Get  
+            Return Color.Yellow  
+        End Get  
+    End Property  
+  
+    Public Overrides ReadOnly Property ButtonSelectedGradientMiddle() As System.Drawing.Color  
+        Get  
+            Return Color.Orange  
+        End Get  
+    End Property  
+  
+    Public Overrides ReadOnly Property ButtonSelectedGradientEnd() _  
+    As System.Drawing.Color  
+        Get  
+            Return Color.Violet  
+        End Get  
+    End Property  
+    End Class  
+  
+    ```  
+  
+### アプリケーション内のすべての ToolStrip コントロールのレンダリングを変更するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripManager.RenderMode%2A?displayProperty=fullName> プロパティを使用して、設定されているレンダラーのいずれかを選択します。  
+  
+2.  <xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=fullName> を使用して、カスタム レンダラーを割り当てます。  
+  
+3.  <xref:System.Windows.Forms.ToolStrip.RenderMode%2A?displayProperty=fullName> が既定値の <xref:System.Windows.Forms.ToolStripRenderMode> に設定されていることを確認します。  
+  
+### アプリケーション全体で Microsoft Office の色をオフにするには  
+  
+-   <xref:System.Windows.Forms.ToolStripManager.VisualStylesEnabled%2A?displayProperty=fullName> を `false` に設定します。  
+  
+### 1 つの ToolStrip コントロールで Microsoft Office の色をオフにするには  
+  
+-   次のコード例に似たコードを使用します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Dim colorTable As ProfessionalColorTable()  
+    colorTable.UseSystemColors = True  
+    Dim toolStrip.Renderer As ToolStripProfessionalRenderer(colorTable)  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    ProfessionalColorTable colorTable = new ProfessionalColorTable();  
+    colorTable.UseSystemColors = true;  
+    toolStrip.Renderer = new ToolStripProfessionalRenderer(colorTable);  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripSystemRenderer>   
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer>   
+ <xref:System.Windows.Forms.ToolStripRenderer>   
+ [組み込みのオーナー描画サポートを備えたコントロール](../../../../docs/framework/winforms/controls/controls-with-built-in-owner-drawing-support.md)   
+ [方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する](../../../../docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md)   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-customize-colors-in-toolstrip-applications.md b/docs/framework/winforms/controls/how-to-customize-colors-in-toolstrip-applications.md
new file mode 100644
index 00000000000..b8d40cbd54c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-customize-colors-in-toolstrip-applications.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : ToolStrip アプリケーションの色をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, カスタマイズ (ToolStrip コントロールを) [Windows フォーム]"
+  - "ツール バー [Windows フォーム], カスタマイズ (色を)"
+  - "ToolStrip コントロール [Windows フォーム], 作成した色"
+ms.assetid: e2752fe2-1afb-489e-ab96-b7805acd96bc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ToolStrip アプリケーションの色をカスタマイズする
+<xref:System.Windows.Forms.ToolStripProfessionalRenderer> クラスを使用して、カスタマイズした色を使用すると、<xref:System.Windows.Forms.ToolStrip> の外観をカスタマイズできます。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStripProfessionalRenderer> を使用してカスタム カラーを実行時に定義する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#20)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#20)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripManager>   
+ <xref:System.Windows.Forms.ProfessionalColorTable>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..1b0dd18f79b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 変更 (DataGridView コントロール内の色を) [Windows フォーム]"
+  - "色, 変更 (DataGridView コントロール内の) [Windows フォーム]"
+  - "データ [Windows フォーム], 書式設定 (DataGridView コントロール内の)"
+  - "データ グリッド, 書式設定 (データを)"
+  - "DataGridView コントロール [Windows フォーム], セルのカスタマイズ"
+  - "DataGridView コントロール [Windows フォーム], セル スタイル"
+  - "DataGridView コントロール [Windows フォーム], 変更 (セルの色を)"
+  - "DataGridView コントロール [Windows フォーム], 書式設定 (データを)"
+  - "DataGridView コントロール [Windows フォーム], 置換 (表示するセル値を)"
+  - "Windows フォーム, 変更 (DataGridView セルの色を)"
+ms.assetid: a6e72c70-ce18-425f-828d-d57be6f96ab6
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする
+次のコード例は、列と値に応じてセルの表示方法を変更する<xref:System.Windows.Forms.DataGridView.CellFormatting?displayProperty=fullName> イベントのハンドラーを実装する方法について説明します。  
+  
+ 負の数値が含まれている `Balance` 列のセルは、赤の背景が指定されます。  これらのセルを通貨として書式設定し、負の値をかっこで囲んで表示することもできます。  詳細については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ `Priority` 列のセルは、対応するテキスト セル値の代わりにイメージを表示します。  <xref:System.Windows.Forms.DataGridViewCellFormattingEventArgs> の<xref:System.Windows.Forms.ConvertEventArgs.Value%2A> プロパティはテキストのセル値を取得して、対応するイメージの表示値に設定する場合に使用されます。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewCustomizeDataFormatting#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCustomizeDataFormatting/cs/customFormatting.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewCustomizeDataFormatting#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCustomizeDataFormatting/vb/customFormatting.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+-   `highPri.bmp`、`mediumPri.bmp`、および `lowPri.bmp` という名前の <xref:System.Drawing.Bitmap> イメージは、実行可能ファイルと同じディレクトリにあります。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ <xref:System.Drawing.Bitmap>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する](../../../../docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-customize-item-addition-with-the-windows-forms-bindingsource.md b/docs/framework/winforms/controls/how-to-customize-item-addition-with-the-windows-forms-bindingsource.md
new file mode 100644
index 00000000000..3c06ce4f557
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-customize-item-addition-with-the-windows-forms-bindingsource.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 新しい項目の作成"
+  - "BindingSource コンポーネント [Windows フォーム], 項目の追加のカスタマイズ"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+ms.assetid: 1aae11fc-6fb2-4cb9-b3d0-e0638fe77ef0
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム BindingSource を使用した項目の追加をカスタマイズする
+<xref:System.Windows.Forms.BindingSource> コンポーネントを使用して Windows フォーム コントロールをデータ ソースにバインドする場合、新しい項目の作成のカスタマイズが必要な場合があります。<xref:System.Windows.Forms.BindingSource> コンポーネントでは、通常は、バインドされたコントロールで新しい項目の作成が必要になる際に発生する <xref:System.Windows.Forms.BindingSource.AddingNew> イベントが提供されるため、これが簡単になります。 イベント ハンドラーは、カスタム動作が必要なものをすべて提供できます \(Web サービスでのメソッドの呼び出し、クラス ファクトリからの新しいオブジェクトの取得など\)。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.BindingSource.AddingNew> イベントを処理することで項目が追加された場合、追加をキャンセルすることはできません。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用して、<xref:System.Windows.Forms.DataGridView> コントロールをクラス ファクトリにバインドする方法を示します。 ユーザーが <xref:System.Windows.Forms.DataGridView> コントロールの新しい行をクリックすると、<xref:System.Windows.Forms.BindingSource.AddingNew> イベントが発生します。 イベント ハンドラーは新しい `DemoCustomer` オブジェクトを作成します。これは、<xref:System.ComponentModel.AddingNewEventArgs.NewObject%2A?displayProperty=fullName> プロパティに割り当てられます。 これにより、新しい `DemoCustomer` オブジェクトが <xref:System.Windows.Forms.BindingSource> コンポーネントの一覧に追加され、<xref:System.Windows.Forms.DataGridView> コントロールの新しい行に表示されます。  
+  
+ [!code-cpp[System.Windows.Forms.DataConnector.AddingNew#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.AddingNew/CPP/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.DataConnector.AddingNew#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.AddingNew/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnector.AddingNew#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.AddingNew/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。 また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  また、「[方法: 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..f35dfce5ab2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, カスタマイズ (並べ替えを)"
+  - "DataGridView コントロール [Windows フォーム], 並べ替え"
+  - "並べ替え, DataGridView コントロール"
+ms.assetid: 92fb5c14-afab-4cf5-a97e-924fd9cb99f5
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする
+<xref:System.Windows.Forms.DataGridView> コントロールは、自動並べ替え機能を提供しますが、ニーズに応じて、並べ替え操作をカスタマイズすることが必要な場合があります。  たとえば、プログラムによる並べ替え機能を使用して、代替のユーザー インターフェイス \(UI\) を作成することができます。  また、複数の列の並べ替えなど、並べ替え柔軟性を高めるために、<xref:System.Windows.Forms.DataGridView.SortCompare> イベントを処理したり、<xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(IComparer)` のオーバーロードを呼び出したりすることができます。  
+  
+ 次のコード例は、カスタムの並べ替えの 3 つの方法を示します。  詳細については、「[Windows フォーム DataGridView コントロール内の列の並べ替えモード](../../../../docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## プログラムによる並べ替え  
+ 次のコード例は、<xref:System.Windows.Forms.DataGridView.SortOrder%2A> プロパティと <xref:System.Windows.Forms.DataGridView.SortedColumn%2A> プロパティを使用して並べ替えの方向を判断し、<xref:System.Windows.Forms.DataGridViewColumnHeaderCell.SortGlyphDirection%2A> プロパティを使用してナラベカエグリフを手動で設定する、プログラムによる並べ替えを示しています。  <xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(DataGridViewColumn,ListSortDirection)` のオーバーロードは 1 つの列のみでのデータの並べ替えに使用します。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewProgrammaticSort#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewProgrammaticSort/CS/form1.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewProgrammaticSort#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewProgrammaticSort/VB/form1.vb#00)]  
+  
+## SortCompare イベントを使用したカスタムの並べ替え  
+ 次のコード例は、<xref:System.Windows.Forms.DataGridView.SortCompare> イベント ハンドラーを使用したカスタムの並べ替えを示しています。  選択した <xref:System.Windows.Forms.DataGridViewColumn> が並べ替えられて、列に重複する値がある場合は、最終的な順序を決定する、ID 列が使用されます。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridView.SortCompare#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.SortCompare/CS/form1.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridView.SortCompare#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.SortCompare/VB/form1.vb#00)]  
+  
+## IComparer インターフェイスを使用したカスタムの並べ替え  
+ 次のコード例は、複数列の並べ替えを実行する <xref:System.Collections.IComparer> インターフェイスの実装を取得する <xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの `Sort(IComparer)` のオーバーロードを使用したカスタムの並べ替えを示しています。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewIComparerSort#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewIComparerSort/CS/form1.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewIComparerSort#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewIComparerSort/VB/form1.vb#00)]  
+  
+## コードのコンパイル  
+ これらの例には次の項目が必要です。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこれらの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォームの DataGridView コントロールでのデータの並べ替え](../../../../docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロール内の列の並べ替えモード](../../../../docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する](../../../../docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button-using-the-designer.md b/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button-using-the-designer.md
new file mode 100644
index 00000000000..44a4e4d8a7b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button-using-the-designer.md
@@ -0,0 +1,57 @@
+---
+title: "方法 :デザイナーを使って ToolBar ボタンのアイコンを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ボタン [Windows フォーム], イメージ"
+  - "例 [Windows フォーム], ツール バー"
+  - "アイコン [Windows フォーム], ツール バー ボタン"
+  - "イメージ [Windows フォーム], ツール バー ボタン"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ボタンにアイコンを)"
+  - "ツール バー [Windows フォーム], 追加 (ボタンにアイコンを)"
+ms.assetid: d848f38e-67f2-49d4-8e88-01c845c06c02
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 :デザイナーを使って ToolBar ボタンのアイコンを定義する
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ <xref:System.Windows.Forms.ToolBar> のボタンには、ユーザーが簡単に識別できるようにアイコンを表示することができます。  そうするには、イメージを <xref:System.Windows.Forms.ImageList> コンポーネントに追加し、これを <xref:System.Windows.Forms.ToolBar> コントロールに関連付けます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ToolBar> コントロールと <xref:System.Windows.Forms.ImageList> コンポーネントが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にツール バー ボタンのアイコンを設定するには  
+  
+1.  イメージを <xref:System.Windows.Forms.ImageList> コンポーネントに追加します。  詳細については、「[方法 : デザイナーを使って ImageList イメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-imagelist-images-with-the-designer.md)」を参照してください。  
+  
+2.  フォームで <xref:System.Windows.Forms.ToolBar> コントロールを選択します。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.ToolBar> コントロールの <xref:System.Windows.Forms.ToolBar.ImageList%2A>プロパティの値を <xref:System.Windows.Forms.ImageList> に設定します。  
+  
+4.  <xref:System.Windows.Forms.ToolBar> コントロールの <xref:System.Windows.Forms.ToolBar.Buttons%2A> プロパティをクリックして選択し、省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして **ToolBarButton コレクション エディター**を開きます。  
+  
+5.  **\[追加\]** をクリックして <xref:System.Windows.Forms.ToolBar> コントロールにボタンを追加します。  
+  
+6.  **ToolBarButton コレクション エディター**の右側のペインに表示される **\[プロパティ\]** ウィンドウで、各ツール バー ボタンの <xref:System.Windows.Forms.ToolBarButton.ImageIndex%2A> プロパティに、一覧に表示されたいずれかの値を設定します。一覧の値は、<xref:System.Windows.Forms.ImageList> コンポーネントに追加したイメージから取得されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)   
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md b/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md
new file mode 100644
index 00000000000..0b700fb82ab
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md
@@ -0,0 +1,129 @@
+---
+title: "方法 : ツール バー ボタンのアイコンを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ボタン [Windows フォーム], アイコン"
+  - "例 [Windows フォーム], ツール バー"
+  - "アイコン [Windows フォーム], ツール バー ボタン"
+  - "イメージ [Windows フォーム], ツール バー ボタン"
+  - "ToolBar コントロール [Windows フォーム], 追加 (ボタンにアイコンを)"
+  - "ツール バー [Windows フォーム], 追加 (ボタンにアイコンを)"
+ms.assetid: 84db98b4-8566-49ce-b2c8-1fd66a5eb3a0
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ツール バー ボタンのアイコンを定義する
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ <xref:System.Windows.Forms.ToolBar> のボタンには、ユーザーが簡単に識別できるようにアイコンを表示することができます。  アイコンを表示するには、[ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md) コンポーネントにイメージを追加した後、<xref:System.Windows.Forms.ImageList> コンポーネントを <xref:System.Windows.Forms.ToolBar> コントロールに関連付けます。  
+  
+### プログラム実行時にツール バー ボタンのアイコンを設定するには  
+  
+1.  プロシージャで、<xref:System.Windows.Forms.ImageList> コンポーネントと <xref:System.Windows.Forms.ToolBar> コントロールをインスタンス化します。  
+  
+2.  同じプロシージャで、イメージを <xref:System.Windows.Forms.ImageList> コンポーネントに割り当てます。  
+  
+3.  同じプロシージャで、<xref:System.Windows.Forms.ImageList> コントロールを <xref:System.Windows.Forms.ToolBar> コントロールに割り当て、各ツール バー ボタンに <xref:System.Windows.Forms.ToolBarButton.ImageIndex%2A> プロパティを割り当てます。  
+  
+     次のコード例では、イメージの場所に対するパスとして **My Documents** フォルダーが設定されています。  これは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例は、既に <xref:System.Windows.Forms.PictureBox> コントロールが追加されたフォームを想定しています。  
+  
+     上記の手順に従った場合、コードは次のようになります。  
+  
+    ```vb  
+    Public Sub InitializeMyToolBar()  
+    ' Instantiate an ImageList component and a ToolBar control.  
+       Dim ToolBar1 as New ToolBar  
+       Dim ImageList1 as New ImageList  
+    ' Assign an image to the ImageList component.  
+    ' You should replace the bold image  
+    ' in the sample below with an icon of your own choosing.  
+       Dim myImage As System.Drawing.Image = _   
+          Image.FromFile Image.FromFile _  
+          (System.Environment.GetFolderPath _  
+          (System.Environment.SpecialFolder.Personal) _  
+          & "\Image.gif")  
+       ImageList1.Images.Add(myImage)  
+    ' Create a ToolBarButton.  
+       Dim ToolBarButton1 As New ToolBarButton()  
+    ' Add the ToolBarButton to the ToolBar.  
+       ToolBar1.Buttons.Add(toolBarButton1)  
+    ' Assign an ImageList to the ToolBar.  
+       ToolBar1.ImageList = ImageList1  
+    ' Assign the ImageIndex property of the ToolBarButton.  
+       ToolBarButton1.ImageIndex = 0  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void InitializeMyToolBar()  
+    {  
+       // Instantiate an ImageList component and a ToolBar control.  
+       ToolBar toolBar1 = new  ToolBar();   
+       ImageList imageList1 = new ImageList();  
+       // Assign an image to the ImageList component.  
+       // You should replace the bold image   
+       // in the sample below with an icon of your own choosing.  
+       // Note the escape character used (@) when specifying the path.  
+       Image myImage = Image.FromFile  
+       (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Image.gif");  
+       imageList1.Images.Add(myImage);  
+       // Create a ToolBarButton.  
+       ToolBarButton toolBarButton1 = new ToolBarButton();  
+       // Add the ToolBarButton to the ToolBar.  
+       toolBar1.Buttons.Add(toolBarButton1);  
+       // Assign an ImageList to the ToolBar.  
+       toolBar1.ImageList = imageList1;  
+       // Assign ImageIndex property of the ToolBarButton.  
+       toolBarButton1.ImageIndex = 0;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void InitializeMyToolBar()  
+       {  
+          // Instantiate an ImageList component and a ToolBar control.  
+          ToolBar ^ toolBar1 = gcnew  ToolBar();   
+          ImageList ^ imageList1 = gcnew ImageList();  
+          // Assign an image to the ImageList component.  
+          // You should replace the bold image   
+          // in the sample below with an icon of your own choosing.  
+          Image ^ myImage = Image::FromFile(String::Concat  
+             (System::Environment::GetFolderPath  
+             (System::Environment::SpecialFolder::Personal),  
+             "\\Image.gif"));  
+          imageList1->Images->Add(myImage);  
+          // Create a ToolBarButton.  
+          ToolBarButton ^ toolBarButton1 = gcnew ToolBarButton();  
+          // Add the ToolBarButton to the ToolBar.  
+          toolBar1->Buttons->Add(toolBarButton1);  
+          // Assign an ImageList to the ToolBar.  
+          toolBar1->ImageList = imageList1;  
+          // Assign ImageIndex property of the ToolBarButton.  
+          toolBarButton1->ImageIndex = 0;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)   
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-define-resize-and-positioning-behavior-in-a-split-window.md b/docs/framework/winforms/controls/how-to-define-resize-and-positioning-behavior-in-a-split-window.md
new file mode 100644
index 00000000000..e91e2f90c8f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-define-resize-and-positioning-behavior-in-a-split-window.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : 分割ウィンドウでのサイズ変更および位置指定動作を定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "分割ウィンドウ, サイズ変更"
+  - "SplitContainer コントロール [Windows フォーム], サイズ変更"
+  - "分割ウィンドウ, サイズ変更"
+ms.assetid: 9bf73f36-ed2d-4a02-b15a-0770eff4fdfa
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 分割ウィンドウでのサイズ変更および位置指定動作を定義する
+<xref:System.Windows.Forms.SplitContainer> コントロールのパネルは、ユーザーがサイズ変更や操作を行う場合にたいへん役立ちます。  しかし、分割線を配置する場所や分割線を移動できる程度について、プログラムで分割線を制御する場合もあります。  
+  
+ <xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A> プロパティなどのプロパティを使用すると、必要に応じてユーザー インターフェイスの動作を正確に制御できます。  これらのプロパティについては次の表に示します。  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.SplitContainer.IsSplitterFixed%2A> プロパティ|キーボードまたはマウスによって分割線が移動できるかどうかを決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterDistance%2A> プロパティ|左端または上端から移動できる分割バーまでの距離 \(ピクセル単位\) を決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A> プロパティ|ユーザーが分割線を移動できる最小距離 \(ピクセル単位\) を決定します。|  
+  
+ 次の例では、<xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A> プロパティを変更して、"分割線のスナップ" 効果を作り出します。ユーザーが分割線をドラッグすると、既定値の 1 ピクセルではなく、10 ピクセル単位で値が増加します。  
+  
+### SplitContainer コントロールのサイズ変更動作を定義するには  
+  
+1.  プロシージャで、分割線の "スナップ" 動作が得られるように、<xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A> プロパティに必要な値を設定します。  
+  
+     次のコード例では、フォームの <xref:System.Windows.Forms.Form.Load> イベント内で、<xref:System.Windows.Forms.SplitContainer> コントロール内の分割線がドラッグ時に 10 ピクセル単位でジャンプするように設定されています。  
+  
+    ```vb  
+    Private Sub Form1_Load(ByVal sender As System.Object, _  
+        ByVal e As System.EventArgs) Handles MyBase.Load  
+        Dim splitSnapper as new SplitContainer()  
+        splitSnapper.SplitterIncrement = 10  
+        splitSnapper.Dock = DockStyle.Fill  
+        splitSnapper.Parent = me  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void Form1_Load(System.Object sender, System.EventArgs e)  
+    {  
+        SplitContainer splitSnapper = new SplitContainer();  
+        splitSnapper.SplitterIncrement = 10;  
+        splitSnapper.Dock = DockStyle.Fill;  
+        splitSnapper.Parent = this;  
+    }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.Load += new System.EventHandler(this.Form1_Load);  
+    ```  
+  
+     分割線を左右に少しだけ移動しても、目に見える効果はありません。しかし、マウス ポインターをどちらかの方向に 10 ピクセル移動すると、分割線が新しい位置にスナップします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ <xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-define-z-ordering-of-docked-toolstrip-controls.md b/docs/framework/winforms/controls/how-to-define-z-ordering-of-docked-toolstrip-controls.md
new file mode 100644
index 00000000000..8bde5f378ce
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-define-z-ordering-of-docked-toolstrip-controls.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : ドッキングされた ToolStrip コントロールの Z オーダーを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム], 指定 (z オーダーを) "
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "z オーダー"
+ms.assetid: 8b595429-ba9f-46af-9c55-3d5cc53f7fff
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ドッキングされた ToolStrip コントロールの Z オーダーを定義する
+ドッキングを使用して <xref:System.Windows.Forms.ToolStrip> コントロールを正しく配置するには、フォームの z オーダーでコントロールを正しく配置する必要があります。  
+  
+## 使用例  
+ 次のコード例は、z オーダーを指定することで、<xref:System.Windows.Forms.ToolStrip> コントロールと、ドッキングされた <xref:System.Windows.Forms.MenuStrip> コントロールを調整する方法を示しています。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#21)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#21)]  
+  
+ Z オーダーは、<xref:System.Windows.Forms.ToolStrip> と <xref:System.Windows.Forms.MenuStrip> の順序によって決まります。  
+  
+ コントロールはフォームの <xref:System.Windows.Forms.Control.Controls%2A> コレクションに追加されます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#23)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#23)]  
+  
+ <xref:System.Windows.Forms.Control.ControlCollection.Add%2A> メソッドへのこれらの呼び出しの順序を反転し、レイアウトへの影響を示します。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.Control.ControlCollection.Add%2A>   
+ <xref:System.Windows.Forms.Control.Controls%2A>   
+ <xref:System.Windows.Forms.Control.Dock%2A>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..6ad426963d3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md
@@ -0,0 +1,137 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 削除 (データ グリッド内で)"
+  - "列 [Windows フォーム], 非表示"
+  - "データ グリッド, 削除 (列を)"
+  - "データ グリッド, 非表示 (列を)"
+  - "DataGrid コントロール [Windows フォーム], 削除 (列を)"
+  - "DataGrid コントロール [Windows フォーム], 非表示 (列を)"
+ms.assetid: bcd0dd96-6687-4c48-b0e1-d5287b93ac91
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGridTableStyle> クラスのメンバーである <xref:System.Windows.Forms.GridColumnStylesCollection> オブジェクトと <xref:System.Windows.Forms.DataGridColumnStyle> オブジェクトのプロパティおよびメソッドを使用して、Windows フォーム <xref:System.Windows.Forms.DataGrid> コントロールの列をプログラムで削除したり非表示にしたりできます。  
+  
+ 削除した列や非表示にした列は、グリッドが連結されているデータ ソースに引き続き含まれていて、プログラムでアクセスできます。  単にデータ グリッドに表示されないだけです。  
+  
+> [!NOTE]
+>  アプリケーションがデータの特定の列にアクセスせず、それらの列をデータ グリッドに表示する必要がないのであれば、通常はそれらの列をデータ ソースに含める必要性はありません。  
+  
+### プログラムで DataGrid から列を削除するには  
+  
+1.  フォームの宣言領域で、<xref:System.Windows.Forms.DataGridTableStyle> クラスの新しいインスタンスを宣言します。  
+  
+2.  <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A?displayProperty=fullName> プロパティに、スタイルを適用するデータ ソース内のテーブルを設定します。  次の例では、<xref:System.Windows.Forms.DataGrid.DataMember%2A?displayProperty=fullName> プロパティを使用しています。このプロパティは既に設定されていると仮定しています。  
+  
+3.  データ グリッドのテーブル スタイル コレクションに新しい <xref:System.Windows.Forms.DataGridTableStyle> オブジェクトを追加します。  
+  
+4.  削除する列の列インデックスを指定して、<xref:System.Windows.Forms.DataGrid> の <xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A> コレクションの <xref:System.Windows.Forms.GridColumnStylesCollection.RemoveAt%2A> メソッドを呼び出します。  
+  
+    ```vb  
+    ' Declare a new DataGridTableStyle in the  
+    ' declarations area of your form.  
+    Dim ts As DataGridTableStyle = New DataGridTableStyle()  
+  
+    Sub DeleteColumn()  
+       ' Set the DataGridTableStyle.MappingName property  
+       ' to the table in the data source to map to.  
+       ts.MappingName = DataGrid1.DataMember  
+  
+       ' Add it to the datagrid's TableStyles collection  
+       DataGrid1.TableStyles.Add(ts)  
+  
+       ' Delete the first column (index 0)  
+       DataGrid1.TableStyles(0).GridColumnStyles.RemoveAt(0)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    // Declare a new DataGridTableStyle in the  
+    // declarations area of your form.  
+    DataGridTableStyle ts = new DataGridTableStyle();  
+  
+    private void deleteColumn()  
+    {  
+       // Set the DataGridTableStyle.MappingName property  
+       // to the table in the data source to map to.  
+       ts.MappingName = dataGrid1.DataMember;  
+  
+       // Add it to the datagrid's TableStyles collection  
+       dataGrid1.TableStyles.Add(ts);  
+  
+       // Delete the first column (index 0)  
+       dataGrid1.TableStyles[0].GridColumnStyles.RemoveAt(0);  
+    }  
+    ```  
+  
+### プログラムで DataGrid の列を非表示にするには  
+  
+1.  フォームの宣言領域で、<xref:System.Windows.Forms.DataGridTableStyle> クラスの新しいインスタンスを宣言します。  
+  
+2.  <xref:System.Windows.Forms.DataGridTableStyle> の <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> プロパティに、スタイルを適用するデータ ソース内のテーブルを設定します。  次のコード例では、<xref:System.Windows.Forms.DataGrid.DataMember%2A?displayProperty=fullName> プロパティを使用しています。このプロパティは既に設定されていると仮定しています。  
+  
+3.  データ グリッドのテーブル スタイル コレクションに新しい <xref:System.Windows.Forms.DataGridTableStyle> オブジェクトを追加します。  
+  
+4.  非表示にする列の列インデックスを指定して `Width`  プロパティを 0 に設定すると、列が非表示になります。  
+  
+    ```vb  
+    ' Declare a new DataGridTableStyle in the  
+    ' declarations area of your form.  
+    Dim ts As DataGridTableStyle = New DataGridTableStyle()  
+  
+    Sub HideColumn()  
+       ' Set the DataGridTableStyle.MappingName property  
+       ' to the table in the data source to map to.  
+       ts.MappingName = DataGrid1.DataMember  
+  
+       ' Add it to the datagrid's TableStyles collection  
+       DataGrid1.TableStyles.Add(ts)  
+  
+       ' Hide the first column (index 0)  
+       DataGrid1.TableStyles(0).GridColumnStyles(0).Width = 0  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    // Declare a new DataGridTableStyle in the  
+    // declarations area of your form.  
+    DataGridTableStyle ts = new DataGridTableStyle();  
+  
+    private void hideColumn()  
+    {  
+       // Set the DataGridTableStyle.MappingName property  
+       // to the table in the data source to map to.  
+       ts.MappingName = dataGrid1.DataMember;  
+  
+       // Add it to the datagrid's TableStyles collection  
+       dataGrid1.TableStyles.Add(ts);  
+  
+       // Hide the first column (index 0)  
+       dataGrid1.TableStyles[0].GridColumnStyles[0].Width = 0;  
+    }  
+    ```  
+  
+## 参照  
+ [方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する](../../../../docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md)   
+ [方法 : Windows フォーム DataGrid コントロールにテーブルと列を追加する](../../../../docs/framework/winforms/controls/how-to-add-tables-and-columns-to-the-windows-forms-datagrid-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md b/docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md
new file mode 100644
index 00000000000..fde0401698b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーションのデザイン, ローカリゼーション"
+  - "ローカリゼーション, Windows フォームのレイアウト"
+  - "TableLayoutPanel コントロール [Windows フォーム]"
+  - "Windows フォーム, ローカリゼーション"
+ms.assetid: d13eff2d-701c-4b6e-8838-3885cbfb7223
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする
+ローカライズが可能なフォームを作成すると、各国市場向けの開発期間が大幅に短縮されます。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用すると、<xref:System.Windows.Forms.Control.Text%2A> プロパティ値の変更によってコントロールのサイズが変更された際に、これに適切に応答するレイアウトを実装できます  
+  
+## 使用例  
+ このフォームでは、表示される文字列値を他の言語に翻訳するときに、均等に調整されるレイアウトを作成する方法を示します。  この翻訳プロセスのことを*ローカリゼーション*といいます。  詳細については、「[ローカリゼーション](../../../../docs/standard/globalization-localization/localization.md)」を参照してください。  
+  
+ Visual Studio では、このタスクに対する広範なサポートが用意されています。  「[チュートリアル : ローカライズの際に均等に調整されるレイアウトの作成](http://msdn.microsoft.com/library/7k9fa71y\(v=vs.110\))」も参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.TableLayoutPanel.LocalizableForm#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.LocalizableForm/CS/localizableform.cs#1)]
+ [!code-vb[System.Windows.Forms.TableLayoutPanel.LocalizableForm#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TableLayoutPanel.LocalizableForm/VB/localizableform.vb#1)]  
+  
+1.  [方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する](http://msdn.microsoft.com/library/ms171688\(v=vs.110\))  
+  
+2.  [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/z9w7ek2f\(v=vs.110\))  
+  
+3.  [方法 : TableLayoutPanel コントロールの行と列を拡大する](http://msdn.microsoft.com/library/ms171687\(v=vs.110\))  
+  
+4.  [方法 : TableLayoutPanel コントロールの列と行を編集する](http://msdn.microsoft.com/library/ms171686\(v=vs.110\))  
+  
+5.  [チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行](http://msdn.microsoft.com/library/xhz359sc\(v=vs.110\))  
+  
+6.  [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/w4yc3e8c\(v=vs.110\))  
+  
+7.  [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](http://msdn.microsoft.com/library/3z3f9e8b\(v=vs.110\))  
+  
+8.  [方法 : AutoSize と TableLayoutPanel コントロールを使用して Windows フォームのローカリゼーションをサポートする](http://msdn.microsoft.com/library/1zkt8b33\(v=vs.110\))  
+  
+9. [チュートリアル: データ入力用のサイズ変更可能な Windows フォームの作成](http://msdn.microsoft.com/library/991eahec\(v=vs.110\))  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ [ローカリゼーション](../../../../docs/standard/globalization-localization/localization.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-accept-button.md b/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-accept-button.md
new file mode 100644
index 00000000000..9cdda078e26
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-accept-button.md
@@ -0,0 +1,63 @@
+---
+title: "方法 : Windows フォームの Button コントロールを承認ボタンとして指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "承認ボタン (Windows フォームの)"
+  - "Button コントロール [Windows フォーム], 指定 (既定として)"
+  - "ボタン, 既定 (Windows フォームでの)"
+  - "Windows フォーム コントロール, 既定のボタン (フォームの)"
+ms.assetid: 22cc9da6-b913-4e04-9554-dee443ac5c3a
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Windows フォームの Button コントロールを承認ボタンとして指定する
+すべての Windows フォーム上で、<xref:System.Windows.Forms.Button> コントロールを承認ボタン \(既定のボタンとも呼ばれます\) として指定できます。  ユーザーが **Enter** キーを押すと、フォームの他のコントロールにフォーカスがある場合でも、既定のボタンがクリックされます。  
+  
+> [!NOTE]
+>  ただし、複数行テキスト ボックス、または Enter キーをトラップするカスタム コントロールの場合は例外です。また、フォーカスのあるコントロールが承認ボタン以外のボタンである場合は、フォーカスのあるボタンがクリックされます。  
+  
+### 承認ボタンを指定するには  
+  
+1.  フォームの <xref:System.Windows.Forms.Form.AcceptButton%2A> プロパティを適切な <xref:System.Windows.Forms.Button> コントロールに設定します。  
+  
+    ```vb  
+    Private Sub SetDefault(ByVal myDefaultBtn As Button)  
+      Me.AcceptButton = myDefaultBtn   
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void SetDefault(Button myDefaultBtn)  
+    {  
+       this.AcceptButton = myDefaultBtn;  
+    }  
+    ```  
+  
+    ```cpp  
+    private:  
+       void SetDefault(Button ^ myDefaultBtn)  
+       {  
+          this->AcceptButton = myDefaultBtn;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Form.AcceptButton%2A>   
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : Windows フォームの Button コントロールをキャンセル ボタンとして指定する](../../../../docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-cancel-button.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-cancel-button.md b/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-cancel-button.md
new file mode 100644
index 00000000000..ecd66f2c002
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-cancel-button.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : Windows フォームの Button コントロールをキャンセル ボタンとして指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], 指定 (キャンセル ボタンとして)"
+  - "ボタン, キャンセル ボタン"
+ms.assetid: 252f0834-e54b-44d9-96f7-ee5f50e94f2c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Windows フォームの Button コントロールをキャンセル ボタンとして指定する
+すべての Windows フォーム上で、<xref:System.Windows.Forms.Button> コントロールをキャンセル ボタンとして指定できます。  ユーザーが Esc キーを押すと、フォームの他のコントロールにフォーカスがある場合でも、このキャンセル ボタンがクリックされます。  このようなボタンは、通常、ユーザーがどのアクションにもコミットせずに、すばやく操作を終了できるようにするために設定されます。  
+  
+### キャンセル ボタンを指定するには  
+  
+1.  フォームの <xref:System.Windows.Forms.Form.CancelButton%2A> プロパティを適切な <xref:System.Windows.Forms.Button> コントロールに設定します。  
+  
+    ```vb  
+    Private Sub SetCancelButton(ByVal myCancelBtn As Button)  
+       Me.CancelButton = myCancelBtn  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void SetCancelButton(Button myCancelBtn)  
+    {  
+       this.CancelButton = myCancelBtn;  
+    }  
+    ```  
+  
+    ```cpp  
+    private:  
+       void SetCancelButton(Button ^ myCancelBtn)  
+       {  
+          this->CancelButton = myCancelBtn;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Form.CancelButton%2A>   
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [方法 : Windows フォームの Button コントロールを承認ボタンとして指定する](../../../../docs/framework/winforms/controls/how-to-designate-a-windows-forms-button-as-the-accept-button.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-detect-when-the-mouse-pointer-is-over-a-toolstripitem.md b/docs/framework/winforms/controls/how-to-detect-when-the-mouse-pointer-is-over-a-toolstripitem.md
new file mode 100644
index 00000000000..0e07adfa6a4
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-detect-when-the-mouse-pointer-is-over-a-toolstripitem.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : マウス ポインターが ToolStripItem 上にあることを検出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マウス, 検出 (ツール バーでの動きを)"
+  - "ツール バー [Windows フォーム], 検出 (マウスの動きを)"
+  - "ToolStrip コントロール [Windows フォーム], 検出 (マウスの動きを)"
+  - "ToolStripItem クラス, 検出 (マウスの動きを)"
+ms.assetid: d38b5082-aba7-4f6c-841b-bd9714e307fd
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : マウス ポインターが ToolStripItem 上にあることを検出する
+マウス ポインターが <xref:System.Windows.Forms.ToolStripItem> 上にあることを検出するには、次の手順に従ってください。  
+  
+### ポインターが ToolStripItem 上にあることを検出するには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.CanSelect%2A> が `true` である項目に対して <xref:System.Windows.Forms.ToolStripItem.Selected%2A> プロパティを使用します。  
+  
+     これによって、<xref:System.Windows.Forms.ToolStripItem.MouseEnter> イベントと <xref:System.Windows.Forms.ToolStripItem.MouseLeave> イベントを同期する必要がなくなります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripItem.Selected%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md b/docs/framework/winforms/controls/how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md
new file mode 100644
index 00000000000..2e0509e41a6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-determine-checked-items-in-the-windows-forms-checkedlistbox-control.md
@@ -0,0 +1,124 @@
+---
+title: "方法 : Windows フォーム CheckedListBox コントロールでオンになっている項目を判断する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック ボックス, 判断 (チェック状態を)"
+  - "CheckedListBox コントロール [Windows フォーム], 判断 (チェック状態を)"
+ms.assetid: 178b477d-27c9-489c-8914-44a9623a4d41
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム CheckedListBox コントロールでオンになっている項目を判断する
+Windows フォームの <xref:System.Windows.Forms.CheckedListBox> コントロールにデータを表示する場合は、<xref:System.Windows.Forms.CheckedListBox.CheckedItems%2A> プロパティに格納されたコレクションに対して反復処理するか、または <xref:System.Windows.Forms.CheckedListBox.GetItemChecked%2A> メソッドを使用してリストをステップ処理することによって、どの項目がオンになっているかを判断できます。  <xref:System.Windows.Forms.CheckedListBox.GetItemChecked%2A> メソッドは、項目のインデックス番号を引数として、`true` または `false` を返します。  <xref:System.Windows.Forms.ListBox.SelectedItems%2A> プロパティおよび <xref:System.Windows.Forms.ListBox.SelectedIndices%2A> プロパティでは、オンになっている項目ではなく、強調表示された項目が判断されます。  
+  
+### CheckedListBox コントロールでチェック状態の項目を判断するには  
+  
+1.  <xref:System.Windows.Forms.CheckedListBox.CheckedItems%2A> コレクションに対して反復処理します。コレクションは配列が 0 から始まるため、0 から検索します。  このメソッドは、一覧全体ではなく、オンにされた項目の一覧について項目番号を取得します。  したがって、一覧の先頭の項目がオフで、2 番目の項目がオンの場合、以下のコードは "Checked Item 1 \= MyListItem2" のようなメッセージを表示します。  
+  
+    ```vb  
+    ' Determine if there are any items checked.  
+    If CheckedListBox1.CheckedItems.Count <> 0 Then  
+       ' If so, loop through all checked items and print results.  
+       Dim x As Integer  
+       Dim s As String = ""  
+       For x = 0 To CheckedListBox1.CheckedItems.Count - 1  
+          s = s & "Checked Item " & (x + 1).ToString & " = " & CheckedListBox1.CheckedItems(x).ToString & ControlChars.CrLf  
+       Next x  
+       MessageBox.Show(s)  
+    End If  
+  
+    ```  
+  
+    ```csharp  
+    // Determine if there are any items checked.  
+    if(checkedListBox1.CheckedItems.Count != 0)  
+    {  
+       // If so, loop through all checked items and print results.  
+       string s = "";  
+       for(int x = 0; x <= checkedListBox1.CheckedItems.Count - 1 ; x++)  
+       {  
+          s = s + "Checked Item " + (x+1).ToString() + " = " + checkedListBox1.CheckedItems[x].ToString() + "\n";  
+       }  
+    MessageBox.Show (s);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    // Determine if there are any items checked.  
+    if(checkedListBox1->CheckedItems->Count != 0)  
+    {  
+       // If so, loop through all checked items and print results.  
+       String ^ s = "";  
+       for(int x = 0; x <= checkedListBox1->CheckedItems->Count - 1; x++)  
+       {  
+          s = String::Concat(s, "Checked Item ", (x+1).ToString(),  
+             " = ", checkedListBox1->CheckedItems[x]->ToString(),  
+             "\n");  
+       }  
+       MessageBox::Show(s);  
+    }  
+    ```  
+  
+     または  
+  
+2.  <xref:System.Windows.Forms.CheckedListBox.Items%2A> コレクションをステップ処理します。コレクションは配列が 0 から始まるため、0 から検索します。各項目に対して <xref:System.Windows.Forms.CheckedListBox.GetItemChecked%2A> メソッドを呼び出します。  このメソッドは、一覧全体から項目番号を取得するため、一覧の先頭の項目がオフで、2 番目の項目がオンの場合、このコードは "Item 2 \= MyListItem2" とメッセージを表示します。  
+  
+    ```vb  
+    Dim i As Integer  
+    Dim s As String  
+    s = "Checked Items:" & ControlChars.CrLf  
+    For i = 0 To (CheckedListBox1.Items.Count - 1)  
+       If CheckedListBox1.GetItemChecked(i) = True Then  
+          s = s & "Item " & (i + 1).ToString & " = " & CheckedListBox1.Items(i).ToString & ControlChars.CrLf  
+       End If  
+    Next  
+    MessageBox.Show(s)  
+  
+    ```  
+  
+    ```csharp  
+    int i;  
+    string s;   
+    s = "Checked items:\n" ;  
+    for (i = 0; i <= (checkedListBox1.Items.Count-1); i++)  
+    {  
+       if (checkedListBox1.GetItemChecked(i))  
+       {  
+          s = s + "Item " + (i+1).ToString() + " = " + checkedListBox1.Items[i].ToString() + "\n";  
+       }  
+    }  
+    MessageBox.Show (s);  
+  
+    ```  
+  
+    ```cpp  
+    int i;  
+    String ^ s;   
+    s = "Checked items:\n" ;  
+    for (i = 0; i <= (checkedListBox1->Items->Count-1); i++)  
+    {  
+       if (checkedListBox1->GetItemChecked(i))  
+       {  
+          s = String::Concat(s, "Item ", (i+1).ToString(), " = ",  
+             checkedListBox1->Item[i]->ToString(), "\n");  
+       }  
+    }  
+    MessageBox::Show(s);  
+    ```  
+  
+## 参照  
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-determine-page-properties-using-the-pagesetupdialog-component.md b/docs/framework/winforms/controls/how-to-determine-page-properties-using-the-pagesetupdialog-component.md
new file mode 100644
index 00000000000..ea79d8599fb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-determine-page-properties-using-the-pagesetupdialog-component.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : PageSetupDialog コンポーネントを使用してページのプロパティを決定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ページのプロパティ"
+  - "ページ設定"
+  - "PageSetupDialog コンポーネント"
+ms.assetid: 6dae05bc-c0fd-4357-bb93-841a1631d98f
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : PageSetupDialog コンポーネントを使用してページのプロパティを決定する
+[PageSetupDialog](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md) コンポーネントは、レイアウト、用紙サイズ、およびその他のページ レイアウトの選択肢をドキュメントのユーザーに示します。  
+  
+ <xref:System.Drawing.Printing.PrintDocument> クラスのインスタンスを指定する必要があります。これは、印刷するドキュメントです。 さらに、ユーザーはコンピューターにローカル プリンターまたはネットワーク プリンターをインストールしておく必要があります。これを基にして、<xref:System.Windows.Forms.PageSetupDialog> コンポーネントはユーザーに示すページ書式設定選択肢の一部を決定します。  
+  
+ <xref:System.Windows.Forms.PageSetupDialog> コンポーネントを使用するときに重要なことは、<xref:System.Drawing.Printing.PageSettings> クラスとの対話方法です。<xref:System.Drawing.Printing.PageSettings> クラスは、用紙の向き、ページのサイズ、余白など、ページの印刷方法を変更する設定の指定に使用されます。 これらの各設定は、<xref:System.Drawing.Printing.PageSettings> クラスのプロパティとして表されます。<xref:System.Windows.Forms.PageSetupDialog> クラスは、ドキュメントに関連付けられている \(そして、<xref:System.Drawing.Printing.PrintDocument.DefaultPageSettings%2A> プロパティとして表されている\) <xref:System.Drawing.Printing.PageSettings> クラスの特定のインスタンスに対するこれらのプロパティ値を変更します。  
+  
+### PageSetupDialog コンポーネントを使用してページのプロパティを設定するには  
+  
+1.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用してダイアログ ボックスを表示し、使用する <xref:System.Drawing.Printing.PrintDocument> を指定します。  
+  
+     次の例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーが、<xref:System.Windows.Forms.PageSetupDialog> コンポーネントのインスタンスを開きます。 既存のドキュメントは <xref:System.Windows.Forms.PageSetupDialog.Document%2A> プロパティで指定され、その <xref:System.Drawing.Printing.PageSettings.Color%2A?displayProperty=fullName> プロパティは `false` に設定されます。  
+  
+     この例では、フォームには <xref:System.Windows.Forms.Button> コントロール、`myDocument` という名前の <xref:System.Drawing.Printing.PrintDocument> コンポーネント、および <xref:System.Windows.Forms.PageSetupDialog> コンポーネントがあるものとします。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+    ByVal e As System.EventArgs) Handles Button1.Click  
+       ' The print document 'myDocument' used below  
+       ' is merely for an example.  
+       'You will have to specify your own print document.  
+       PageSetupDialog1.Document = myDocument  
+       ' Sets the print document's color setting to false,  
+       ' so that the page will not be printed in color.  
+       PageSetupDialog1.Document.DefaultPageSettings.Color = False  
+       PageSetupDialog1.ShowDialog()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       // The print document 'myDocument' used below  
+       // is merely for an example.  
+       // You will have to specify your own print document.  
+       pageSetupDialog1.Document = myDocument;  
+       // Sets the print document's color setting to false,  
+       // so that the page will not be printed in color.  
+       pageSetupDialog1.Document.DefaultPageSettings.Color = false;  
+       pageSetupDialog1.ShowDialog();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void button1_Click(System::Object ^  sender,  
+          System::EventArgs ^  e)  
+       {  
+          // The print document 'myDocument' used below  
+          // is merely for an example.  
+          // You will have to specify your own print document.  
+          pageSetupDialog1->Document = myDocument;  
+          // Sets the print document's color setting to false,  
+          // so that the page will not be printed in color.  
+          pageSetupDialog1->Document->DefaultPageSettings->Color = false;  
+          pageSetupDialog1->ShowDialog();  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを追加して、イベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click += gcnew   
+       System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.PageSetupDialog>   
+ [方法 : 標準の Windows フォーム印刷ジョブを作成する](../../../../docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md)   
+ [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md b/docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md
new file mode 100644
index 00000000000..5db10e802e6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : クリックされた TreeView ノード (Windows フォーム) を判別する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TreeNode"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "ツリー ノード (TreeView コントロールの), 判断 (ノードのクリックを)"
+  - "TreeView コントロール [Windows フォーム], 判断 (ノードのクリックを)"
+ms.assetid: 06a4a191-d918-42af-9f49-956c93eff261
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : クリックされた TreeView ノード (Windows フォーム) を判別する
+Windows フォームの <xref:System.Windows.Forms.TreeView> コントロールを使用する場合に共通する作業は、クリックされたノードを判別し、適切に応答することです。  
+  
+### クリックされた TreeView ノードを判別するには  
+  
+1.  <xref:System.EventArgs> オブジェクトを使用して、クリックされたノード オブジェクトへの参照を返します。  
+  
+2.  イベントに関連するデータを格納している <xref:System.Windows.Forms.TreeViewEventArgs> クラスを調べて、どのノードがクリックされたかを確認します。  
+  
+    ```vb  
+    Private Sub TreeView1_AfterSelect(ByVal sender As System.Object, _  
+    ByVal e As System.Windows.Forms.TreeViewEventArgs) Handles TreeView1.AfterSelect  
+       ' Determine by checking the Node property of the TreeViewEventArgs.  
+       MessageBox.Show(e.Node.Text)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void treeView1_AfterSelect (object sender,   
+    System.Windows.Forms.TreeViewEventArgs e)  
+    {  
+       // Determine by checking the Text property.  
+       MessageBox.Show(e.Node.Text);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void treeView1_AfterSelect(System::Object ^  sender,  
+          System::Windows::Forms::TreeViewEventArgs ^  e)  
+       {  
+          // Determine by checking the Text property.  
+          MessageBox::Show(e->Node->Text);  
+       }  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control.MouseDown> または<xref:System.Windows.Forms.Control.MouseUp> イベントの <xref:System.Windows.Forms.MouseEventArgs> を使用して、クリックされた <xref:System.Drawing.Point> の <xref:System.Drawing.Point.X%2A> 座標値と <xref:System.Drawing.Point.Y%2A> 座標値を取得することもできます。  その後で、<xref:System.Windows.Forms.TreeView> コントロールの <xref:System.Windows.Forms.TreeView.GetNodeAt%2A> メソッドを使用して、どのノードがクリックされたかを確認します。  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md b/docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md
new file mode 100644
index 00000000000..e449350ac8e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md
@@ -0,0 +1,113 @@
+---
+title: "方法 : シンプルな Windows フォーム コントロールを開発する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Control クラス, Windows フォーム"
+  - "コントロール [Windows フォーム]"
+  - "カスタム コントロール [Windows フォーム], 作成 (コードを使用して簡単なコントロールを)"
+ms.assetid: 86cbe435-45b7-4cb4-9b5a-47418369758d
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : シンプルな Windows フォーム コントロールを開発する
+ここでは、カスタム Windows フォーム コントロールの作成手順を示します。  この手順では、<xref:System.Windows.Forms.Control.Text%2A> プロパティの配列を変更できるシンプルなコントロールを作成します。  このコントロールでは、イベントの発生や処理は行われません。  
+  
+### シンプルなカスタム コントロールを作成するには  
+  
+1.  <xref:System.Windows.Forms.Control?displayProperty=fullName> から派生するクラスを定義します。  
+  
+    ```vb  
+    Public Class FirstControl  
+       Inherits Control  
+  
+    End Class  
+    ```  
+  
+    ```csharp  
+    public class FirstControl:Control{}  
+    ```  
+  
+2.  プロパティを定義します。  コントロールは <xref:System.Windows.Forms.Control> クラスから多数のプロパティを継承するため、プロパティの定義は必須ではありません。ただし、ほとんどのカスタム コントロールでは追加プロパティを定義します。`TextAlignment`  というプロパティを定義するコード片を次に示します。このプロパティは、`FirstControl`  が、<xref:System.Windows.Forms.Control> から継承した <xref:System.Windows.Forms.Control.Text%2A> プロパティの表示形式を設定するときに使用するプロパティです。  プロパティの定義の詳細については、「[プロパティの概要](../Topic/Properties%20Overview.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.FirstControl#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/CS/FirstControl.cs#3)]
+     [!code-vb[System.Windows.Forms.FirstControl#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/VB/FirstControl.vb#3)]  
+  
+     コントロールのビジュアル表示を変更するプロパティを設定するには、<xref:System.Windows.Forms.Control.Invalidate%2A> メソッドを呼び出して、コントロールを再描画する必要があります。  <xref:System.Windows.Forms.Control.Invalidate%2A> は基本クラス <xref:System.Windows.Forms.Control> で定義されます。  
+  
+3.  <xref:System.Windows.Forms.Control> から継承された <xref:System.Windows.Forms.Control.OnPaint%2A> プロテクト メソッドをオーバーライドして、レンダリング ロジックをコントロールに追加します。  <xref:System.Windows.Forms.Control.OnPaint%2A> をオーバーライドしないと、作成するコントロールがそのコントロール自体を描画できません。  <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドが <xref:System.Windows.Forms.Control> から継承した <xref:System.Windows.Forms.Control.Text%2A> プロパティを、`alignmentValue` フィールドによって指定された配置で表示するコード片を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.FirstControl#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/CS/FirstControl.cs#4)]
+     [!code-vb[System.Windows.Forms.FirstControl#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/VB/FirstControl.vb#4)]  
+  
+4.  コントロールの属性を指定します。  デザイン時には、ビジュアル デザイナーではこれらの属性を使用して、コントロール、コントロールのプロパティとイベントが適切に表示されます。  `TextAlignment` プロパティに属性を適用するコード片を次に示します。  Visual Studio などのデザイナーでは、次のコード片に示されている <xref:System.ComponentModel.CategoryAttribute.Category%2A> 属性によって、プロパティが論理カテゴリの下に表示されます。  <xref:System.ComponentModel.DescriptionAttribute.Description%2A> 属性が適用されている場合には、`TextAlignment` プロパティが選択されると、**\[プロパティ\]** ウィンドウ下部に説明文字列が表示されます。  属性の詳細については、「[コンポーネントのデザイン時属性](../Topic/Design-Time%20Attributes%20for%20Components.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.FirstControl#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/CS/FirstControl.cs#5)]
+     [!code-vb[System.Windows.Forms.FirstControl#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/VB/FirstControl.vb#5)]  
+  
+5.  \(省略可能\) コントロールに対してリソースを指定します。  コントロールに対してビットマップなどのリソースを指定するには、コンパイラ オプション \(C\# の `/res` など\) を使用して、コントロールにリソースをパッケージ化します。  実行時には、<xref:System.Resources.ResourceManager> クラスのメソッドを使用してリソースを取得できます。  リソースの作成と使用の詳細については、「[デスクトップ アプリケーションのリソース](../../../../docs/framework/resources/index.md)」を参照してください。  
+  
+6.  コンパイルしてコントロールを配置します。  `FirstControl` をコンパイルして配置するには、次の手順に従います。  
+  
+    1.  次のサンプルのコードをソース ファイル \(FirstControl.cs または FirstControl.vb など\) に保存します。  
+  
+    2.  ソース コードをコンパイルして、アセンブリを生成します。アプリケーションのディレクトリにこのアセンブリを保存します。  この処理を行うには、ソース ファイルが格納されているディレクトリで次のコマンドを実行します。  
+  
+        ```vb  
+        vbc /t:library /out:[path to your application's directory]/CustomWinControls.dll /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll FirstControl.vb  
+        ```  
+  
+        ```csharp  
+        csc /t:library /out:[path to your application's directory]/CustomWinControls.dll /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll FirstControl.cs  
+        ```  
+  
+         `/t:library` コンパイラ オプションによって、作成するアセンブリが実行可能ファイルではなくライブラリであることがコンパイラに指示されます。  `/out` オプションには、アセンブリの名前とパスを指定します。  `/r` オプションには、コードがアセンブリを参照するときのアセンブリ名を指定します。  上記のコード例で作成されるアセンブリは、開発者が作成したアプリケーションだけで使用できるプライベート アセンブリです。  したがって、このアセンブリを各自のアプリケーションのディレクトリに保存する必要があります。  配布用にコントロールをパッケージ化および配置する方法の詳細については、「[配置](../../../../docs/framework/deployment/net-framework-and-applications.md)」を参照してください。  
+  
+ `FirstControl` のコードのサンプルを次に示します。  このコントロールは、`CustomWinControls` 名前空間に格納されています。  名前空間では、関連する型を論理的にグループ化できます。  コントロールを作成するには、既存の名前空間を使用するか、または名前空間を新規作成して使用します。  C\# では、`using` 宣言 \(Visual Basic の場合は `Imports`\) を使用すると、名前空間から型へアクセスするときに、型の完全限定名を使用する必要がありません。  次の例では、`using` 宣言によって、コードは完全修飾名 <xref:System.Windows.Forms.Control?displayProperty=fullName> を使用せずに単純に <xref:System.Windows.Forms.Control> として <xref:System.Windows.Forms?displayProperty=fullName> から <xref:System.Windows.Forms.Control> クラスにアクセスできます。  
+  
+ [!code-csharp[System.Windows.Forms.FirstControl#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/CS/FirstControl.cs#1)]
+ [!code-vb[System.Windows.Forms.FirstControl#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/VB/FirstControl.vb#1)]  
+  
+## フォームでのカスタム コントロールの使用  
+ `FirstControl` を使用するシンプルなフォームの例を次に示します。  この例では、`FirstControl` のインスタンスを 3 つ作成します。それぞれのインスタンスでは、`TextAlignment` プロパティに異なる値が設定されます。  
+  
+#### このサンプルをコンパイルして実行するには  
+  
+1.  次に示すサンプルのコードをソース ファイル \(SimpleForm.cs または SimpleForms.vb\) に保存します。  
+  
+2.  ソース ファイルが格納されているディレクトリで次のコマンドを実行することにより、実行可能アセンブリへソース コードをコンパイルします。  
+  
+    ```vb  
+    vbc /r:CustomWinControls.dll /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll SimpleForm.vb  
+    ```  
+  
+    ```csharp  
+    csc /r:CustomWinControls.dll /r:System.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll SimpleForm.cs  
+    ```  
+  
+     CustomWinControls.dll は、`FirstControl` クラスが含まれているアセンブリです。  フォームがこのアセンブリへアクセスできるように、このアセンブリはソース ファイル \(SimpleForm.cs または SimpleForms.vb\) と同じディレクトリに格納されている必要があります。  
+  
+3.  次に示すコマンドで SimpleForm.exe を実行します。  
+  
+    ```  
+    SimpleForm  
+    ```  
+  
+ [!code-csharp[System.Windows.Forms.FirstControl#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/CS/SimpleForm.cs#10)]
+ [!code-vb[System.Windows.Forms.FirstControl#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FirstControl/VB/SimpleForm.vb#10)]  
+  
+## 参照  
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)   
+ [Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-disable-tab-pages.md b/docs/framework/winforms/controls/how-to-disable-tab-pages.md
new file mode 100644
index 00000000000..07f79299c60
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-disable-tab-pages.md
@@ -0,0 +1,116 @@
+---
+title: "方法 : タブ ページを無効化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ ページ, 非表示 (フォーム内の)"
+  - "TabControl コントロール [Windows フォーム], 無効化 (ページを)"
+ms.assetid: adcc6618-8a34-4ee1-bbe3-47e732de6a59
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : タブ ページを無効化する
+状況によっては、Windows フォーム アプリケーション内で使用できるデータへのアクセスを制限する必要があります。  タブ コントロールのタブ ページに表示されるデータがその一例です。タブ ページの情報の中には、管理者がゲストや低いレベルのユーザーによるアクセスを制限する必要があると考える情報もあります。  
+  
+### タブ ページをプログラムで無効にするには  
+  
+1.  タブ コントロールの <xref:System.Windows.Forms.TabControl.SelectedIndexChanged> イベントを処理するコードを記述します。  このイベントは、ユーザーが 1 つのタブから次のタブに切り替えたときに発生します。  
+  
+2.  資格情報を確認します。  ユーザーに対してタブを表示する前に、提供される情報に応じて、そのユーザーがログインに使用したユーザー名や、その他の形式の資格情報を確認します。  
+  
+3.  ユーザーの資格情報が適切である場合は、クリックされたタブを表示します。  ユーザーが適切な資格情報を持っていない場合は、アクセス権がないことをメッセージ ボックスなどのユーザー インターフェイスで示し、最初のタブに戻ります。  
+  
+    > [!NOTE]
+    >  この機能を実際のアプリケーションに実装する場合には、この資格情報チェックをフォームの <xref:System.Windows.Forms.Form.Load> イベントで実行できます。  このイベントを実行すると、ユーザー インターフェイスが表示される前にタブを非表示にできます。こちらの方が洗練されたプログラミング方法です。  <xref:System.Windows.Forms.TabControl.SelectedIndexChanged> イベントで資格情報を確認してタブを無効にする次の手順は、説明のために示しています。  
+  
+4.  オプションとして、タブ ページが 3 つ以上ある場合には、元のタブ ページと異なるタブ ページを表示できます。  
+  
+     次の例では、タブにアクセスするための条件がアプリケーションによって異なるため、資格情報を確認する代わりに <xref:System.Windows.Forms.CheckBox> コントロールが使用されています。  <xref:System.Windows.Forms.TabControl.SelectedIndexChanged> イベントが発生すると、資格情報チェックが true であり \(つまり、チェック ボックスがオンであり\)、選択されたタブが `TabPage2` \(この例では機密情報を含むタブ\) である場合は、`TabPage2` が表示されます。  それ以外の場合は `TabPage3` が表示され、適切なアクセス権限がないことを示すメッセージ ボックスがユーザーに表示されます。  次のコードでは、フォームに <xref:System.Windows.Forms.CheckBox> コントロール \(`CredentialCheck`\) と、3 つのタブ ページを含む <xref:System.Windows.Forms.TabControl> コントロールがあると仮定しています。  
+  
+    ```vb  
+    Private Sub TabControl1_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles TabControl1.SelectedIndexChanged  
+       ' Check Credentials Here  
+  
+       If CredentialCheck.Checked = True And _   
+       TabControl1.SelectedTab Is TabPage2 Then  
+          TabControl1.SelectedTab = TabPage2  
+       ElseIf CredentialCheck.Checked = False _   
+       And TabControl1.SelectedTab Is TabPage2 Then  
+          MessageBox.Show _   
+         ("Unable to load tab. You have insufficient access privileges.")  
+          TabControl1.SelectedTab = TabPage3  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void tabControl1_SelectedIndexChanged(object sender, System.EventArgs e)  
+    {  
+        // Check Credentials Here  
+  
+        if ((CredentialCheck.Checked == true) && (tabControl1.SelectedTab == tabPage2))   
+        {  
+            tabControl1.SelectedTab = tabPage2;  
+        }  
+        else if ((CredentialCheck.Checked == false) && (tabControl1.SelectedTab == tabPage2))  
+        {  
+            MessageBox.Show("Unable to load tab. You have insufficient access privileges.");  
+            tabControl1.SelectedTab = tabPage3;  
+        }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void tabControl1_SelectedIndexChanged(  
+          System::Object ^ sender,  
+          System::EventArgs ^  e)  
+       {  
+          // Check Credentials Here  
+          if ((CredentialCheck->Checked == true) &&  
+              (tabControl1->SelectedTab == tabPage2))  
+          {  
+             tabControl1->SelectedTab = tabPage2;  
+          }  
+          else if ((CredentialCheck->Checked == false) &&  
+                   (tabControl1->SelectedTab == tabPage2))  
+          {  
+             MessageBox::Show(String::Concat("Unable to load tab. ",  
+                "You have insufficient access privileges."));  
+             tabControl1->SelectedTab = tabPage3;  
+          }  
+       }  
+    ```  
+  
+     \(Visual C\#、Visual C\+\+\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.tabControl1.SelectedIndexChanged +=   
+       new System.EventHandler(this.tabControl1_SelectedIndexChanged);  
+  
+    ```  
+  
+    ```cpp  
+    this->tabControl1->SelectedIndexChanged +=  
+       gcnew System::EventHandler(this, &Form1::tabControl1_SelectedIndexChanged);  
+    ```  
+  
+## 参照  
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)   
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)   
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems-using-the-designer.md b/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems-using-the-designer.md
new file mode 100644
index 00000000000..dd015902fc5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems-using-the-designer.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : デザイナーを使用して ToolStripMenuItems を無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目, 無効化"
+  - "メニュー, 無効化 (項目を)"
+  - "MenuStrip コントロール [Windows フォーム], 無効化 (メニュー項目をデザイナーで)"
+  - "ToolStripMenuItem, 無効化 (デザイナーで)"
+ms.assetid: 985e311e-7d67-4205-b5a3-d045b68a4a03
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : デザイナーを使用して ToolStripMenuItems を無効にする
+ユーザーのアクティビティに応じてメニュー項目を有効および無効にすることによって、ユーザーが実行できるコマンドを制限したり、増やしたりできます。  メニュー項目は作成時に既定で有効になっていますが、これは <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティを介して調整できます。  このプロパティはデザイン時に **\[プロパティ\]** ウィンドウで操作できます。また、コード内で設定することによりプログラムで操作できます。  詳細については、「[方法 : ToolStripMenuItems を無効にする](../../../../docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にメニュー項目を無効にするには  
+  
+1.  フォームのメニュー項目を選択して、<xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティを `false` に設定します。  
+  
+    > [!TIP]
+    >  メニュー内の最初の、つまりトップレベルのメニュー項目を無効にすると、そのメニューに含まれるすべてのメニュー項目が無効になります。  同様に、サブメニュー項目を持つメニュー項目を無効にすると、サブメニュー項目も無効になります。  指定したメニューのすべてのコマンドをユーザーが使用できない場合は、ユーザー インターフェイスを簡潔にするために、メニュー全体を非表示にし、無効にするようにプログラミングすることをお勧めします。  メニューを非表示にしただけの場合、ショートカット キーを使用してメニュー コマンドにアクセスできるため、メニューを非表示にして、さらに無効にする必要があります。  トップレベルのメニュー項目の <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定してメニュー全体を非表示にします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [方法 : ToolStripMenuItems を非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md)   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md b/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md
new file mode 100644
index 00000000000..762940e544f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : ToolStripMenuItems を無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "無効化 (メニュー項目を)"
+  - "メニュー項目, 無効化"
+  - "メニュー項目, 有効化"
+  - "メニュー, 無効化 (メニュー項目を)"
+  - "ToolStripMenuItem, 無効化"
+  - "ToolStripMenuItem, 有効化"
+ms.assetid: bcc1da84-50fd-41d2-8475-103b581d5654
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ToolStripMenuItems を無効にする
+ユーザーのアクティビティに応じてメニュー項目を有効および無効にすることによって、ユーザーが実行できるコマンドを制限したり、増やしたりできます。  メニュー項目は作成時に既定で有効になっていますが、これは <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティを介して調整できます。  このプロパティはデザイン時に **\[プロパティ\]** ウィンドウで操作できます。また、コード内で設定することによりプログラムで操作できます。  
+  
+### プログラムによって、メニュー項目を無効にするには  
+  
+-   メニュー項目のプロパティを設定するメソッド内で、コードを追加して <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティを `false` に設定します。  
+  
+    ```vb  
+    MenuItem1.Enabled = False  
+    ```  
+  
+    ```csharp  
+    menuItem1.Enabled = false;  
+    ```  
+  
+    ```cpp  
+    menuItem1->Enabled = false;  
+    ```  
+  
+    > [!TIP]
+    >  メニュー内の最初の、つまりトップレベルのメニュー項目を無効にすると、そのメニューに含まれるすべてのメニュー項目が非表示になります。ただし、無効にはなりません。  同様に、サブメニュー項目を持つメニュー項目を無効にすると、サブメニュー項目が非表示になりますが、無効にはなりません。  指定したメニューのすべてのコマンドをユーザーが使用できない場合は、ユーザー インターフェイスを簡潔にするために、メニュー全体を非表示にし、無効にするようにプログラミングすることをお勧めします。  メニューを非表示にしただけの場合、ショートカット キーを使用してメニュー コマンドにアクセスできるため、メニューを非表示にして無効にし、さらにメニュー内のすべての項目とサブメニュー項目を無効にする必要があります。  トップレベルのメニュー項目の <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定してメニュー全体を非表示にします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [方法 : ToolStripMenuItems を非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md)   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md b/docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md
new file mode 100644
index 00000000000..b0e087b6d0e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md
@@ -0,0 +1,43 @@
+---
+title: "方法: [ツールボックス アイテムの選択] ダイアログ ボックスにコントロールを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グローバル アセンブリ キャッシュ、[ツールボックス アイテムの選択] ダイアログ ボックス"
+  - "AssemblyFoldersEx、[ツールボックス アイテムの選択] ダイアログ ボックス"
+  - "コントロール、[ツールボックス アイテムの選択] ダイアログ ボックスでの表示"
+  - "アセンブリ フォルダー登録、[ツールボックス アイテムの選択] ダイアログ ボックス"
+  - "[ツールボックス アイテムの選択] ダイアログ ボックス、コントロールの表示"
+ms.assetid: 01ef6eba-d044-40f0-951d-78eff7ebd9a9
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法: [ツールボックス アイテムの選択] ダイアログ ボックスにコントロールを表示する
+コントロールを作成して配布するときに、**\[ツールボックス アイテムの選択\]** ダイアログ ボックスにコントロールを表示できます。このダイアログ ボックスは、**ツールボックス**を右クリックし、**\[アイテムの選択\]** をクリックすると表示されます。  このダイアログ ボックスにコントロールを表示できるようにするには、AssemblyFoldersEx 登録プロシージャを使用します。  
+  
+### \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示するには  
+  
+-   コントロール アセンブリをグローバル アセンブリ キャッシュにインストールします。  詳細については、「[方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする](../../../../docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md)」を参照してください。  
+  
+     または  
+  
+-   AssemblyFoldersEx 登録プロシージャを使用して、コントロールとそれに関連付けられているデザイン時アセンブリを登録します。  AssemblyFoldersEx は、サードパーティ ベンダーでサポートされているフレームワークの各バージョンのパスを格納するレジストリの位置です。  このレジストリの位置でデザイン時の解決を調べると、参照アセンブリを確認できます。  レジストリ スクリプトでツールボックスに表示するコントロールを指定できます。  詳細については、「[カスタム コントロールとデザイン時アセンブリの配置](http://msdn.microsoft.com/ja-jp/96158eb0-b691-4ae1-9e7b-3c65a1b798cb)」を参照してください。  
+  
+## 参照  
+ [Choose Toolbox Items Dialog Box \(Visual Studio\)](http://msdn.microsoft.com/ja-jp/bd07835f-18a8-433e-bccc-7141f65263bb)   
+ [カスタム コントロールとデザイン時アセンブリの配置](http://msdn.microsoft.com/ja-jp/96158eb0-b691-4ae1-9e7b-3c65a1b798cb)   
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)   
+ [方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする](../../../../docs/framework/app-domains/how-to-install-an-assembly-into-the-gac.md)   
+ [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md
new file mode 100644
index 00000000000..950765723b1
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : Windows フォーム ListView コントロールに挿入マークを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ, 挿入マーク"
+  - "グラフィックス, 挿入マーク"
+  - "挿入マーク"
+  - "ListView コントロール [Windows フォーム], ドラッグ操作"
+ms.assetid: 88d0a15b-25fd-4dc3-a685-297351311940
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム ListView コントロールに挿入マークを表示する
+<xref:System.Windows.Forms.ListView> コントロールの挿入マークは、ドラッグされた項目の挿入先となるポイントをユーザーに表示します。  ユーザーが項目をその他の 2 つの項目の間のポイントにドラッグすると、項目の予期される新しい場所に挿入マークが表示されます。  
+  
+> [!NOTE]
+>  挿入マーク機能は、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出した場合に、[!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] でのみ使用できます。  以前のオペレーティング システムでは、挿入マークに関連するすべてのコードは効果がなく、挿入マークは表示されません。  詳細については、「<xref:System.Windows.Forms.ListViewInsertionMark>」を参照してください。  
+  
+ 次の図は、挿入マークを示しています。  
+  
+ ![ListView 挿入記号](../../../../docs/framework/winforms/controls/media/listviewinsertion.gif "ListViewInsertion")  
+  
+ この機能の使用方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.ListView.InsertionMark#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ListView.InsertionMark/CPP/listviewinsertionmarkexample.cpp#1)]
+ [!code-csharp[System.Windows.Forms.ListView.InsertionMark#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListView.InsertionMark/CS/listviewinsertionmarkexample.cs#1)]
+ [!code-vb[System.Windows.Forms.ListView.InsertionMark#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListView.InsertionMark/VB/listviewinsertionmarkexample.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListView.InsertionMark%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ListViewInsertionMark>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)   
+ [チュートリアル : Windows フォームにおけるドラッグ アンド ドロップ操作の実行](../../../../docs/framework/winforms/advanced/walkthrough-performing-a-drag-and-drop-operation-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md
new file mode 100644
index 00000000000..76270e902ef
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム ListView コントロールのアイコンを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アイコン, 表示 (ListView コントロールの)"
+  - "ImageList コンポーネント [Windows フォーム], ListView コントロールを含む"
+  - "リスト ビュー, 表示 (アイコンを)"
+  - "一覧, 表示 (アイコンを)"
+  - "ListView コントロール [Windows フォーム], 表示 (アイコンを)"
+ms.assetid: 9d577542-8595-429b-99e5-078770ec9d35
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム ListView コントロールのアイコンを表示する
+Windows フォーム <xref:System.Windows.Forms.ListView> \(リスト ビュー\) コントロールには、3 つのイメージ リストからアイコンを表示できます。  List、Details、および SmallIcon ビューでは、<xref:System.Windows.Forms.ListView.SmallImageList%2A> プロパティに指定されたイメージ リストのイメージが表示されます。  LargeIcon \(大きいアイコン\) ビューでは、<xref:System.Windows.Forms.ListView.LargeImageList%2A> プロパティに指定されたイメージ リストのイメージが表示されます。  リスト ビューでは、大きいアイコンまたは小さいアイコンの横に、<xref:System.Windows.Forms.ListView.StateImageList%2A> プロパティに設定された別のアイコンを表示できます。  イメージ リストの詳細については、「[ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)」および「[方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)」を参照してください。  
+  
+### リスト ビューにイメージを表示するには  
+  
+1.  適切なプロパティ \(<xref:System.Windows.Forms.ListView.SmallImageList%2A>、<xref:System.Windows.Forms.ListView.LargeImageList%2A>、または <xref:System.Windows.Forms.ListView.StateImageList%2A>\) を、使用する既存の <xref:System.Windows.Forms.ImageList> コンポーネントに設定します。  
+  
+     これらのプロパティは、デザイナーの \[プロパティ\] ウィンドウで設定するか、またはコードで設定できます。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#41](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#41)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#41](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#41)]  
+  
+2.  アイコンが関連付けられているリスト項目のそれぞれに対して、<xref:System.Windows.Forms.ListViewItem.ImageIndex%2A> プロパティまたは <xref:System.Windows.Forms.ListViewItem.StateImageIndex%2A> プロパティを設定します。  
+  
+     これらのプロパティは、コードで設定するか、または **ListViewItem コレクション エディター**で設定できます。  **ListViewItem コレクション エディター**を開くには、**\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.ListView.Items%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#42)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#42)]  
+  
+## 参照  
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)   
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..39731103db2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 表示 (イメージを)"
+  - "データ グリッド, 表示 (セルにイメージを)"
+  - "データ グリッド, 表示 (グリッドに)"
+  - "DataGridView コントロール [Windows フォーム], 表示 (イメージを)"
+ms.assetid: 53b13d31-1b56-476d-9ab4-18bfac138a22
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する
+ピクチャまたはグラフィックは 1 行のデータに表示できる値の 1 つです。  多くの場合、これらのグラフィックスは従業員の写真や会社のロゴなどが使用されます。  
+  
+ データを <xref:System.Windows.Forms.DataGridView> コントロール内に表示する場合、ピクチャの取り込みは簡単です。  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Drawing.Image> クラスによってサポートされている任意のイメージ形式、および一部のデータベースで使用されている OLE ピクチャ形式をネイティブに処理します。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールのデータ ソースにイメージの列がある場合、これらは <xref:System.Windows.Forms.DataGridView> コントロールによって自動的に表示されます。  
+  
+ 埋め込みリソースからアイコンを抽出し、ビットマップに変換してイメージ列の各セルに表示する方法を次のコード例に示します。  テキストのセルを対応するイメージで置き換える例については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#050](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#050)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#050](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#050)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   `tree.ico` という埋め込まれたアイコン リソース。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Windows.Forms?displayProperty=fullName> アセンブリ、および <xref:System.Drawing?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-option-buttons-in-a-menustrip-windows-forms.md b/docs/framework/winforms/controls/how-to-display-option-buttons-in-a-menustrip-windows-forms.md
new file mode 100644
index 00000000000..6cb7cb7da88
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-option-buttons-in-a-menustrip-windows-forms.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : MenuStrip にオプション ボタンを表示する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "表示 (オプション ボタンを), MenuStrip [Windows フォーム]"
+  - "MenuStrip [Windows フォーム], 表示 (オプション ボタンを)"
+  - "オプション ボタン [Windows フォーム], 表示 (MenuStrip で)"
+ms.assetid: 8b596af2-9ff8-4f7b-93d7-cba830e167f4
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : MenuStrip にオプション ボタンを表示する (Windows フォーム)
+オプション ボタン \(ラジオ ボタンとも呼ばれます\) は、チェック ボックスと似ていますが、同時に選択できる項目が 1 つのみという点が異なります。  既定の <xref:System.Windows.Forms.ToolStripMenuItem> クラスにはオプション ボタンの動作はありませんが、チェック ボックスの動作が備わっています。この動作をカスタマイズすると、<xref:System.Windows.Forms.MenuStrip> コントロールのメニュー項目にオプション ボタンの動作を実装できます。  
+  
+ メニュー項目の <xref:System.Windows.Forms.ToolStripMenuItem.CheckOnClick%2A> プロパティを `true` にすると、クリックによってチェック マークの表示が切り替わる項目になります。  <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A> プロパティは、項目の現在の状態を示します。  基本のオプション ボタンの動作を実装するには、いずれかの項目が選択されたときに、直前に選択されていた項目の <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A> プロパティを `false` に設定する必要があります。  
+  
+ 次の手順では、<xref:System.Windows.Forms.ToolStripMenuItem> クラスを継承するクラスにこの機能と追加の機能を実装する方法を説明します。  `ToolStripRadioButtonMenuItem` クラスでは、<xref:System.Windows.Forms.ToolStripMenuItem.OnCheckedChanged%2A> や <xref:System.Windows.Forms.ToolStripMenuItem.OnPaint%2A> などのメンバーをオーバーライドして、オプション ボタンの選択動作と外観を実現します。  さらに、このクラスでは、親項目が選択されていない場合はサブメニューのオプションが無効になるように、<xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティをオーバーライドします。  
+  
+### オプション ボタンの選択動作を実装するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripMenuItem.CheckOnClick%2A> プロパティを `true` に初期化して、項目を選択できるようにします。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#110](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#110)]
+     [!code-vb[ToolStripRadioButtonMenuItem#110](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#110)]  
+  
+2.  <xref:System.Windows.Forms.ToolStripMenuItem.OnCheckedChanged%2A> メソッドをオーバーライドして、新しい項目が選択されたときに、直前に選択されていた項目の選択を解除します。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#120](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#120)]
+     [!code-vb[ToolStripRadioButtonMenuItem#120](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#120)]  
+  
+3.  <xref:System.Windows.Forms.ToolStripMenuItem.OnClick%2A> メソッドをオーバーライドして、既に選択されている項目をクリックしても選択が解除されないようにします。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#130](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#130)]
+     [!code-vb[ToolStripRadioButtonMenuItem#130](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#130)]  
+  
+### オプション ボタン項目の外観を変更するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripMenuItem.OnPaint%2A> メソッドをオーバーライドし、<xref:System.Windows.Forms.RadioButtonRenderer> クラスを使用して既定のチェックマークをオプション ボタンに置き換えます。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#140](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#140)]
+     [!code-vb[ToolStripRadioButtonMenuItem#140](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#140)]  
+  
+2.  <xref:System.Windows.Forms.ToolStripMenuItem.OnMouseEnter%2A>、<xref:System.Windows.Forms.ToolStripMenuItem.OnMouseLeave%2A>、<xref:System.Windows.Forms.ToolStripMenuItem.OnMouseDown%2A>、<xref:System.Windows.Forms.ToolStripMenuItem.OnMouseUp%2A> の各メソッドをオーバーライドして、マウスの状態を追跡し、<xref:System.Windows.Forms.ToolStripMenuItem.OnPaint%2A> メソッドで正しいオプション ボタンの状態が描画されるようにします。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#150](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#150)]
+     [!code-vb[ToolStripRadioButtonMenuItem#150](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#150)]  
+  
+### 親項目が選択されていない場合にサブメニューのオプションを無効にするには  
+  
+1.  <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A> プロパティをオーバーライドして、親項目の <xref:System.Windows.Forms.ToolStripMenuItem.CheckOnClick%2A> 値が `true` で <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A> 値が `false` の場合に項目が無効になるようにします。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#160](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#160)]
+     [!code-vb[ToolStripRadioButtonMenuItem#160](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#160)]  
+  
+2.  <xref:System.Windows.Forms.ToolStripMenuItem.OnOwnerChanged%2A> メソッドをオーバーライドして、親項目の <xref:System.Windows.Forms.ToolStripMenuItem.CheckedChanged> イベントにサブスクライブします。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#170](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#170)]
+     [!code-vb[ToolStripRadioButtonMenuItem#170](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#170)]  
+  
+3.  親項目の <xref:System.Windows.Forms.ToolStripMenuItem.CheckedChanged> イベントのハンドラーで項目を無効にして、新しい有効な状態で表示を更新します。  
+  
+     [!code-csharp[ToolStripRadioButtonMenuItem#180](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#180)]
+     [!code-vb[ToolStripRadioButtonMenuItem#180](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#180)]  
+  
+## 使用例  
+ 次のコード例では、完全な `ToolStripRadioButtonMenuItem` クラスを作成し、<xref:System.Windows.Forms.Form> クラスと `Program` クラスを使用してオプション ボタンの動作を確認します。  
+  
+ [!code-csharp[ToolStripRadioButtonMenuItem#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/cs/ToolStripRadioButtonMenuItem.cs#000)]
+ [!code-vb[ToolStripRadioButtonMenuItem#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripRadioButtonMenuItem/vb/ToolStripRadioButtonMenuItem.vb#000)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System、System.Drawing、System.Windows.Forms の各アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.CheckOnClick%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.Checked%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.OnCheckedChanged%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.OnPaint%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.RadioButtonRenderer>   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)   
+ [方法 : カスタムの ToolStripRenderer を実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-custom-toolstriprenderer.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-print-preview-in-windows-forms-applications.md b/docs/framework/winforms/controls/how-to-display-print-preview-in-windows-forms-applications.md
new file mode 100644
index 00000000000..84bcca335ae
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-print-preview-in-windows-forms-applications.md
@@ -0,0 +1,96 @@
+---
+title: "方法 : Windows フォーム アプリケーションに印刷プレビューを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], 印刷プレビュー"
+  - "印刷プレビュー, 表示"
+  - "印刷 [Windows フォーム], 印刷プレビュー"
+ms.assetid: e394134c-0886-4517-bd8d-edc4a3749eb5
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォーム アプリケーションに印刷プレビューを表示する
+<xref:System.Windows.Forms.PrintPreviewDialog> コントロールを使用すると、ユーザーは印刷前などにドキュメントを表示できます。  
+  
+ そのためには、<xref:System.Drawing.Printing.PrintDocument> クラスのインスタンスを指定する必要があります。これが印刷されるドキュメントです。  <xref:System.Drawing.Printing.PrintDocument> コンポーネントでの印刷プレビューの使用の詳細については、「[方法 : Windows フォームで印刷プレビューを使用して印刷する](../../../../docs/framework/winforms/advanced/how-to-print-in-windows-forms-using-print-preview.md)」を参照してください。  
+  
+> [!NOTE]
+>  実行時に <xref:System.Windows.Forms.PrintPreviewDialog> コントロールを使用するためには、ユーザーがコンピューター上にローカルで、またはネットワークを通じて、プリンターをインストールしている必要があります。<xref:System.Windows.Forms.PrintPreviewDialog> コンポーネントはこのプリンターに応じて、印刷時のドキュメントの外観を決定します。  
+  
+ <xref:System.Windows.Forms.PrintPreviewDialog> コントロールは <xref:System.Drawing.Printing.PrinterSettings> クラスを使用します。  また、<xref:System.Windows.Forms.PrintPreviewDialog> コントロールは <xref:System.Windows.Forms.PrintPreviewDialog> コンポーネントと同じように <xref:System.Drawing.Printing.PageSettings> クラスを使用します。  <xref:System.Windows.Forms.PrintPreviewDialog> コントロールの <xref:System.Windows.Forms.PrintPreviewControl.Document%2A> プロパティに指定された印刷ドキュメントは、<xref:System.Drawing.Printing.PrinterSettings> クラスと <xref:System.Drawing.Printing.PageSettings> クラスの両方のインスタンスを参照します。その両方を使用してプレビュー ウィンドウにドキュメントが表示されます。  
+  
+### PrintPreviewDialog コントロールを使用してページを表示するには  
+  
+-   <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用してダイアログ ボックスを表示します。このとき、使用する <xref:System.Drawing.Printing.PrintDocument> を指定します。  
+  
+     次のコード例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを使用して <xref:System.Windows.Forms.PrintPreviewDialog> コントロールのインスタンスを開いています。  印刷ドキュメントは、<xref:System.Windows.Forms.PrintDialog.Document%2A> プロパティに指定されます。  次の例では印刷ドキュメントが指定されていません。  
+  
+     このコード例では、フォームに <xref:System.Windows.Forms.Button> コントロール、`myDocument` という名前の <xref:System.Drawing.Printing.PrintDocument> コンポーネント、および <xref:System.Windows.Forms.PrintPreviewDialog> コントロールが必要です。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles Button1.Click  
+       ' The print document 'myDocument' used below  
+       ' is merely for an example.  
+       ' You will have to specify your own print document.  
+       PrintPreviewDialog1.Document = myDocument  
+       PrintPreviewDialog1.ShowDialog()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       // The print document 'myDocument' used below  
+       // is merely for an example.  
+       // You will have to specify your own print document.  
+       printPreviewDialog1.Document = myDocument;  
+       printPreviewDialog1.ShowDialog();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          // The print document 'myDocument' used below  
+          // is merely for an example.  
+          // You will have to specify your own print document.  
+          printPreviewDialog1->Document = myDocument;  
+          printPreviewDialog1->ShowDialog();  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click += gcnew  
+       System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ [PrintDocument コンポーネント](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md)   
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)   
+ [Windows フォーム](../../../../docs/framework/winforms/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-scroll-bars-in-the-windows-forms-richtextbox-control.md b/docs/framework/winforms/controls/how-to-display-scroll-bars-in-the-windows-forms-richtextbox-control.md
new file mode 100644
index 00000000000..f648d5b6874
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-scroll-bars-in-the-windows-forms-richtextbox-control.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールにスクロール バーを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "RichTextBox コントロール [Windows フォーム], 表示 (スクロール バーを)"
+  - "スクロール バー, 表示 (コントロールに)"
+  - "テキスト ボックス, 表示 (スクロール バーを)"
+ms.assetid: cdeb42e1-86e8-410c-ba46-18aec264ef5f
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームの RichTextBox コントロールにスクロール バーを表示する
+既定では、Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールには必要に応じて水平スクロール バーと垂直スクロール バーが表示されます。  <xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.RichTextBox.ScrollBars%2A> プロパティには、下の表に示す 7 つの値を使用できます。  
+  
+### RichTextBox コントロールにスクロール バーを表示するには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.Multiline%2A> プロパティを `true` に設定します。  <xref:System.Windows.Forms.RichTextBox.Multiline%2A> プロパティが `false` に設定されている場合、水平スクロール バーも含めてスクロール バーはまったく表示されません。  
+  
+2.  <xref:System.Windows.Forms.RichTextBox.ScrollBars%2A> プロパティを <xref:System.Windows.Forms.RichTextBoxScrollBars> 列挙体の適切な値に設定します。  
+  
+    |値|Description|  
+    |-------|-----------------|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars> \(既定値\)|テキストがコントロールの幅または長さを超えた場合にだけ、水平スクロール バーまたは垂直スクロール バー、またはその両方を表示します。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|どちらのスクロール バーも表示しません。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|テキストがコントロールの幅を超えた場合にだけ、水平スクロール バーを表示します。  <xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> プロパティを `false` に設定する必要があります。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|テキストがコントロールの高さを超えた場合にだけ、垂直スクロール バーを表示します。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|<xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> プロパティが `false` に設定されている場合に、水平スクロール バーを表示します。  テキストがコントロールの幅を超えていない場合、スクロール バーは淡色表示になります。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|垂直スクロール バーを常に表示します。  テキストがコントロールの高さを超えていない場合、スクロール バーは淡色表示になります。|  
+    |<xref:System.Windows.Forms.RichTextBoxScrollBars>|垂直スクロール バーを常に表示します。  <xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> プロパティが `false` に設定されている場合に、水平スクロール バーを表示します。  テキストがコントロールの幅または高さを超えていない場合、スクロール バーは淡色表示になります。|  
+  
+3.  <xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> プロパティに適切な値を設定します。  
+  
+    |値|Description|  
+    |-------|-----------------|  
+    |`false`|コントロールのテキストは、コントロールの幅に収まるように自動的に調整されないため、改行に達するまで右方向にスクロールされます。  この値は、ScrollBars プロパティの設定で、水平スクロール バーまたは両方のスクロール バーを表示するように選択した場合に使用します。|  
+    |`true` \(既定値\)|コントロール内のテキストは、コントロールの幅に収まるように自動的に調整されます。  水平スクロール バーは表示されません。  この値は、ScrollBars プロパティの設定で垂直スクロール バーを表示するか、どのスクロール バーも表示しないように選択した場合に使用して、1 つ以上の段落を表示します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBoxScrollBars>   
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-side-aligned-tabs-with-tabcontrol.md b/docs/framework/winforms/controls/how-to-display-side-aligned-tabs-with-tabcontrol.md
new file mode 100644
index 00000000000..ac94d55997c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-side-aligned-tabs-with-tabcontrol.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : TabControl を使用して側面に位置を合わせて表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "タブ ページ, 表示 (側面に位置を合わせたタブを)"
+  - "TabControl コントロール [Windows フォーム], 表示 (側面に位置を合わせたタブを)"
+  - "タブ, 表示 (側面に位置を合わせたタブを)"
+ms.assetid: 110d5abd-3ae3-4ded-95bf-778aaac798a0
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : TabControl を使用して側面に位置を合わせて表示する
+<xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.Alignment%2A> プロパティは、水平方向 \(コントロールの上部または下部\) ではなく、垂直方向 \(コントロールの左端または右端\) でのタブの表示をサポートします。  <xref:System.Windows.Forms.TabPage> オブジェクトの <xref:System.Windows.Forms.TabPage.Text%2A> プロパティは、視覚スタイルを有効にしたときにタブが表示されないため、既定では、この垂直方向の表示はユーザーの操作性が低下します。  また、タブ内のテキストの方向を制御する直接的な方法がありません。  この操作性を向上させるために、<xref:System.Windows.Forms.TabControl> でオーナー描画を使用できます。  
+  
+ 次の手順では、「オーナー描画」機能を使用して、タブのテキストが左から右に実行されているときに、右揃えのタブを表示する方法を示します。  
+  
+### 右揃えのタブを表示するには  
+  
+1.  <xref:System.Windows.Forms.TabControl> をフォームに追加します。  
+  
+2.  <xref:System.Windows.Forms.TabControl.Alignment%2A> プロパティを <xref:System.Windows.Forms.TabAlignment> に設定します。  
+  
+3.  <xref:System.Windows.Forms.TabControl.SizeMode%2A> プロパティを <xref:System.Windows.Forms.TabSizeMode> に設定して、すべてのタブが同じ幅になるようにします。  
+  
+4.  タブの <xref:System.Windows.Forms.TabControl.ItemSize%2A> プロパティを任意の固定サイズに設定します。  <xref:System.Windows.Forms.TabControl.ItemSize%2A> プロパティは、タブが右揃えでも、最上部にあるように機能することに注意してください。  その結果、タブを広くするには <xref:System.Drawing.Size.Height%2A> プロパティを変更する必要があり、高くするには <xref:System.Drawing.Size.Width%2A> プロパティを変更する必要があります。  
+  
+     次のコード例で最適な結果を得るには、タブの <xref:System.Drawing.Size.Width%2A> を 25 に設定し、<xref:System.Drawing.Size.Height%2A> を 100 に設定します。  
+  
+5.  <xref:System.Windows.Forms.TabControl.DrawMode%2A> プロパティを <xref:System.Windows.Forms.TabDrawMode> に設定します。  
+  
+6.  テキストを左から右に表示する <xref:System.Windows.Forms.TabControl> の <xref:System.Windows.Forms.TabControl.DrawItem> イベントのハンドラーを定義します。  
+  
+     [!code-csharp[TabControl.RightAlignedTabs#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/TabControl.RightAlignedTabs/CS/Form1.cs#1)]
+     [!code-vb[TabControl.RightAlignedTabs#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/TabControl.RightAlignedTabs/VB/Form1.vb#1)]  
+  
+## 参照  
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md
new file mode 100644
index 00000000000..1859a790583
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "詳細ビュー"
+  - "リスト項目"
+  - "ListView コントロール [Windows フォーム], 追加 (ListSubItems を)"
+  - "サブアイテム"
+ms.assetid: e465f044-cde7-4fd9-a687-788a73a0f554
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する
+Windows フォームの <xref:System.Windows.Forms.ListView> コントロールは、詳細ビュー モードの場合、各項目に対して追加のテキスト \(サブ項目\) を表示できます。  最初の列には、項目のテキスト \(従業員番号など\) が表示されます。  2 番目、3 番目、それ以降の列には、関連付けられた 1 番目、2 番目、それ以降のサブ項目が表示されます。  
+  
+### リスト項目にサブ項目を追加するには  
+  
+1.  必要な列を追加します。  最初の列には項目の <xref:System.Windows.Forms.ListView.Text%2A> プロパティが表示されるため、必要なサブ項目数よりも 1 つ多い数の列が必要です。  列の追加については、「[方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)」を参照してください。  
+  
+2.  項目の <xref:System.Windows.Forms.ListViewItem.SubItems%2A> プロパティから返されたコレクションの <xref:System.Windows.Forms.ListViewItem.ListViewSubItemCollection.Add%2A> メソッドを呼び出します。  リストの項目に対して従業員の名前と所属部門を設定するコードの例を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#61](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#61)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#61](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#61)]  
+  
+## 参照  
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-the-printdialog-component.md b/docs/framework/winforms/controls/how-to-display-the-printdialog-component.md
new file mode 100644
index 00000000000..0c8b35a2af9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-the-printdialog-component.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : PrintDialog コンポーネントを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[印刷] ダイアログ ボックス, 表示"
+  - "PrintDialog コンポーネント [Windows フォーム], 表示"
+  - "印刷 [Windows フォーム], 表示 (印刷ダイアログ ボックスを)"
+ms.assetid: 745a8db7-0526-4b21-b09d-18e13ed32014
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : PrintDialog コンポーネントを表示する
+<xref:System.Windows.Forms.PrintDialog> コンポーネントは、多くのユーザーにお馴染みの Windows の標準印刷ダイアログ ボックスです。  ユーザーが簡単に使用できるため、<xref:System.Windows.Forms.PrintDialog> コンポーネントを使用することをお勧めします。  
+  
+### PrintDialog コンポーネントを表示するには  
+  
+-   アプリケーションのコードから <xref:System.Windows.Forms.Form.ShowDialog%2A> メソッドを呼び出します。  
+  
+     コンポーネントが表示されると、ユーザーはそれを使用して印刷ジョブのプロパティを設定します。  この設定は、印刷ジョブに関連付けられている [PrinterSettings](frlrfSystemDrawingPrintingPrinterSettingsMembersTopic) クラス \(ユーザーが <xref:System.Windows.Forms.PrintDialog> コンポーネントを通じて [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md) にアクセスしている場合は [PageSettings](frlrfSystemDrawingPrintingPageSettingsMembersTopic) クラス\) に保存されます。  その後で、設定されたプロパティを呼び出して印刷ジョブの詳細を確認できます。  
+  
+## 参照  
+ [方法 : 標準の Windows フォーム印刷ジョブを作成する](../../../../docs/framework/winforms/advanced/how-to-create-standard-windows-forms-print-jobs.md)   
+ [方法 : 実行時に PrintDialog のユーザー入力をキャプチャする](../../../../docs/framework/winforms/advanced/how-to-capture-user-input-from-a-printdialog-at-run-time.md)   
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)   
+ [PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)   
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md b/docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md
new file mode 100644
index 00000000000..092c2338a7f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : DateTimePicker コントロールを使用して時間を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DateTimePicker コントロール [Windows フォーム], 表示 (時間を)"
+  - "例 [Windows フォーム], DateTimePicker コントロール"
+  - "時間, 表示 (DateTimePicker コントロール内に)"
+ms.assetid: 0c1c8b40-1b50-4301-a90c-39516775ccb1
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : DateTimePicker コントロールを使用して時間を表示する
+アプリケーションでユーザーが日付と時刻を選択して、指定された形式で日付と時刻を表示できるようにするには、<xref:System.Windows.Forms.DateTimePicker> コントロールを使用します。  次の手順は、<xref:System.Windows.Forms.DateTimePicker> コントロールを使用して時刻を表示する方法を示します。  
+  
+### 方法 : DateTimePicker コントロールを使用して時間を表示する  
+  
+1.  <xref:System.Windows.Forms.DateTimePicker.Format%2A> プロパティを <xref:System.Windows.Forms.DateTimePickerFormat> に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DateTimePickerTimeOnly#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.DateTimePickerTimeOnly#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/VB/Form1.vb#2)]  
+  
+2.  <xref:System.Windows.Forms.DateTimePicker> の <xref:System.Windows.Forms.DateTimePicker.ShowUpDown%2A> プロパティを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DateTimePickerTimeOnly#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.DateTimePickerTimeOnly#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/VB/Form1.vb#3)]  
+  
+## 使用例  
+ 次のコード サンプルは、ユーザーが時刻のみを選択できるようにする <xref:System.Windows.Forms.DateTimePicker> を作成する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.DateTimePickerTimeOnly#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DateTimePickerTimeOnly#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DateTimePickerTimeOnly/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  コードを新しいプロジェクトに貼り付けることで、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md b/docs/framework/winforms/controls/how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md
new file mode 100644
index 00000000000..073d9c46b0f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md
@@ -0,0 +1,134 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールを使用して Web スタイルのリンクを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], テキスト ボックス"
+  - "RichTextBox コントロール [Windows フォーム], リンク (Web ページに)"
+  - "テキスト ボックス, 表示 (Web リンクを)"
+ms.assetid: 95089a37-a202-4f7a-94ee-6ee312908851
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの RichTextBox コントロールを使用して Web スタイルのリンクを表示する
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールでは、Web リンクに色と下線を付けて表示できます。  リンクがクリックされたときにブラウザー ウィンドウを開いて、リンク テキストで指定されている Web サイトを表示するように、コードを記述できます。  
+  
+### RichTextBox コントロールで Web ページにリンクするには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.Text%2A> プロパティに、有効な URL \("http:\/\/www.microsoft.com\/japan" など\) を含む文字列を設定します。  
+  
+2.  <xref:System.Windows.Forms.RichTextBox.DetectUrls%2A> プロパティが `true` \(既定値\) に設定されていることを確認します。  
+  
+3.  <xref:System.Diagnostics.Process> オブジェクトの新しいグローバル インスタンスを作成します。  
+  
+4.  ブラウザーに目的のテキストを送信する <xref:System.Windows.Forms.RichTextBox.LinkClicked> イベントのイベント ハンドラーを記述します。  
+  
+     次の例では、<xref:System.Windows.Forms.RichTextBox.LinkClicked> イベントで Internet Explorer のインスタンスが開き、<xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.RichTextBox.Text%2A> プロパティに指定された URL にアクセスします。  この例では、フォームに <xref:System.Windows.Forms.RichTextBox> コントロールがあると仮定しています。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.Diagnostics.Process.Start%2A?displayProperty=fullName> メソッドを呼び出すと権限の不足により <xref:System.Security.SecurityException> 例外が発生します。  詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+    ```vb  
+    Public p As New System.Diagnostics.Process  
+    Private Sub RichTextBox1_LinkClicked _  
+       (ByVal sender As Object, ByVal e As _  
+       System.Windows.Forms.LinkClickedEventArgs) _  
+       Handles RichTextBox1.LinkClicked  
+          ' Call Process.Start method to open a browser  
+          ' with link text as URL.  
+          p = System.Diagnostics.Process.Start("IExplore.exe", e.LinkText)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public System.Diagnostics.Process p = new System.Diagnostics.Process();  
+  
+    private void richTextBox1_LinkClicked(object sender,   
+    System.Windows.Forms.LinkClickedEventArgs e)  
+    {  
+       // Call Process.Start method to open a browser  
+       // with link text as URL.  
+       p = System.Diagnostics.Process.Start("IExplore.exe", e.LinkText);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       System::Diagnostics::Process ^ p;  
+  
+    private:  
+       void richTextBox1_LinkClicked(System::Object ^  sender,  
+          System::Windows::Forms::LinkClickedEventArgs ^  e)  
+       {  
+          // Call Process.Start method to open a browser  
+          // with link text as URL.  
+          p = System::Diagnostics::Process::Start("IExplore.exe",  
+             e->LinkText);  
+       }  
+    ```  
+  
+     \([!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) プロセス `p` を初期化する必要があります。そのためには、フォームのコンストラクターに次のステートメントを挿入します。  
+  
+    ```cpp  
+    p = gcnew System::Diagnostics::Process();  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.richTextBox1.LinkClicked += new   
+       System.Windows.Forms.LinkClickedEventHandler  
+       (this.richTextBox1_LinkClicked);  
+  
+    ```  
+  
+    ```cpp  
+    this->richTextBox1->LinkClicked += gcnew  
+       System::Windows::Forms::LinkClickedEventHandler  
+       (this, &Form1::richTextBox1_LinkClicked);  
+    ```  
+  
+     作成したプロセスを実行したら、すぐにそれを停止することが重要です。  上に示したコードを参考にして、プロセスを停止するコードを次のように記述できます。  
+  
+    ```vb  
+    Public Sub StopWebProcess()  
+       p.Kill()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void StopWebProcess()  
+    {  
+       p.Kill();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public: void StopWebProcess()  
+    {  
+       p->Kill();  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox.DetectUrls%2A>   
+ <xref:System.Windows.Forms.RichTextBox.LinkClicked>   
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md b/docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md
new file mode 100644
index 00000000000..bd6fc64655a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : Windows フォーム上のコントロールをドッキングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], ドッキング"
+  - "Dock プロパティ"
+  - "エクスプローラー スタイル アプリケーション, 作成"
+  - "Windows フォーム コントロール, 設定 (クライアント領域を)"
+ms.assetid: bc11f2e4-e90a-4830-b0e2-f43b6e2b8bec
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム上のコントロールをドッキングする
+フォームの端にコントロールをドッキングしたり、コントロールのコンテナー \(フォームまたはコンテナー コントロール\) にコントロールを挿入したりできます。  たとえば、Windows エクスプローラーでは、ウィンドウの左側に <xref:System.Windows.Forms.TreeView> コントロールが、ウィンドウの右側に <xref:System.Windows.Forms.ListView> コントロールがドッキングされています。  表示されているすべての Windows フォーム コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを使用して、ドッキング モードに設定します。  
+  
+> [!NOTE]
+>  コントロールは反転した z オーダーでドッキングされます。  
+  
+ <xref:System.Windows.Forms.Control.Dock%2A> プロパティは <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティとやり取りします。  詳細については、「[AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)」を参照してください。  
+  
+### コントロールをドッキングするには  
+  
+1.  ドッキングするコントロールを選択します。  
+  
+2.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Control.Dock%2A> プロパティの右にある矢印をクリックします。  
+  
+     エディターが開き、フォームの端と中央を表す一連のボックスが表示されます。  
+  
+3.  コントロールをドッキングするフォームの端を表すボタンをクリックします。  コントロールのフォームまたはコンテナー コントロールの内容を入力するには、中央のボックスをクリックします。  **\[None\]** をクリックすると、ドッキングは無効になります。  
+  
+     コントロールは、ドッキングされた端の境界線に合わせて、自動的にサイズ変更されます。  
+  
+    > [!NOTE]
+    >  継承したコントロールをドッキングできるようにするには、`Protected` にする必要があります。  コントロールのアクセス レベルを変更するには、\[プロパティ\] ウィンドウで **Modifier** プロパティを設定します。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)   
+ [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)   
+ [方法 : Windows フォームにコントロールを固定する](../../../../docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-download-a-file-in-the-background.md b/docs/framework/winforms/controls/how-to-download-a-file-in-the-background.md
new file mode 100644
index 00000000000..f0798e68aa3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-download-a-file-in-the-background.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : バックグラウンドでファイルをダウンロードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "非同期パターン"
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "BackgroundWorker コンポーネント"
+  - "コンポーネント [Windows フォーム], 非同期"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+ms.assetid: 9b7bc5ae-051c-4904-9720-18f6667388bd
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : バックグラウンドでファイルをダウンロードする
+ファイルのダウンロードは一般的なタスクであり、時間のかかる可能性があるこの操作を別のスレッドで実行すると便利です。  ごくわずかなコードでこのタスクを実行するには、<xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用します。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用して、URL からの XML ファイルを読み込む方法を示しています。  ユーザーが **\[ダウンロード\]** ボタンをクリックすると、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーが <xref:System.ComponentModel.BackgroundWorker> コンポーネントの <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドを呼び出して、ダウンロード操作を開始します。  ダウンロード中はボタンが無効になり、ダウンロードが完了すると有効になります。  <xref:System.Windows.Forms.MessageBox> にファイルの内容が表示されます。  
+  
+ [!code-csharp[System.ComponentModel.BackgroundWorker.IsBusy#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/CS/Form1.cs#1)]
+ [!code-vb[System.ComponentModel.BackgroundWorker.IsBusy#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/VB/Form1.vb#1)]  
+  
+ **ファイルのダウンロード**  
+  
+ ファイルが <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーを実行する <xref:System.ComponentModel.BackgroundWorker> コンポーネントのワーカー スレッドにダウンロードされます。  このスレッドは、コードが <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドを呼び出すときに開始されます。  
+  
+ [!code-csharp[System.ComponentModel.BackgroundWorker.IsBusy#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/CS/Form1.cs#3)]
+ [!code-vb[System.ComponentModel.BackgroundWorker.IsBusy#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/VB/Form1.vb#3)]  
+  
+ **完了する BackgroundWorker を待機する**  
+  
+ `downloadButton_Click` イベント ハンドラーが <xref:System.ComponentModel.BackgroundWorker> コンポーネントの非同期タスクの終了を待機する方法を示します。  
+  
+ アプリケーションがイベントへの応答のみを実行し、バック グラウンド スレッドを待機している間にメイン スレッドでその他の作業を実行しないようにする場合は、ハンドラーを終了します。  
+  
+ メイン スレッドで処理を続行する場合は、<xref:System.ComponentModel.BackgroundWorker.IsBusy%2A> プロパティを使用して、<xref:System.ComponentModel.BackgroundWorker> スレッドをまだ実行するかどうかを決定します。  例では、ダウンロードの処理中に、進行状況バーが更新されます。  必ず <xref:System.Windows.Forms.Application.DoEvents%2A?displayProperty=fullName> メソッドを呼び出して、UI 応答性を維持してください。  
+  
+ [!code-csharp[System.ComponentModel.BackgroundWorker.IsBusy#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/CS/Form1.cs#2)]
+ [!code-vb[System.ComponentModel.BackgroundWorker.IsBusy#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/VB/Form1.vb#2)]  
+  
+ **結果の表示**  
+  
+ `backgroundWorker1_RunWorkerCompleted` メソッドは、<xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントを処理し、バック グラウンド操作が完了したときに呼び出されます。  このメソッドはまず、<xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A?displayProperty=fullName> プロパティを確認します。  <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A?displayProperty=fullName> が `null` の場合に、このメソッドはファイルの内容を表示します。  これで、ダウンロードを開始したときに無効になっていた \[ダウンロード\] ボタンが有効になり、進行状況バーがリセットされます。  
+  
+ [!code-csharp[System.ComponentModel.BackgroundWorker.IsBusy#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/CS/Form1.cs#4)]
+ [!code-vb[System.ComponentModel.BackgroundWorker.IsBusy#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/VB/Form1.vb#4)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Drawing、System.Windows.Forms、および System.Xml の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 信頼性の高いプログラミング  
+ <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーにより影響を受けている可能性がある <xref:System.ComponentModel.RunWorkerCompletedEventArgs.Result%2A?displayProperty=fullName> プロパティまたはその他のオブジェクトへのアクセスを試みる前に、常に <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーの <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A?displayProperty=fullName> プロパティを確認してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-edit-columns-and-rows-in-a-tablelayoutpanel-control.md b/docs/framework/winforms/controls/how-to-edit-columns-and-rows-in-a-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..c83e04f59b3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-edit-columns-and-rows-in-a-tablelayoutpanel-control.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : TableLayoutPanel コントロールの列と行を編集する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "net.ComponentModel.StyleCollectionEditor"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 編集"
+  - "行 [Windows フォーム], 編集"
+  - "TableLayoutPanel コントロール [Windows フォーム], 編集"
+ms.assetid: c367ed43-40dc-49eb-9e0f-ba70e83dfec0
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : TableLayoutPanel コントロールの列と行を編集する
+<xref:System.Windows.Forms.TableLayoutPanel> コントロールのコレクション エディター \(**\[列と行のスタイル\]** ダイアログ ボックス\) を使用して、コントロールの行と列を編集できます。  
+  
+> [!NOTE]
+>  コントロールが複数の行または列にわたるようにする場合は、コントロールの `RowSpan` プロパティおよび `ColumnSpan` プロパティを設定します。  詳細については、「[チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)」を参照してください。  
+>   
+>  コントロールをセル内に配置したり、コントロールをセル内で拡大したりする場合は、コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティを使用します。  詳細については、「[チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)」を参照してください。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 行と列を編集するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールのスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックし、**\[行および列の編集\]** をクリックして、**\[列と行のスタイル\]** ダイアログ ボックスを開きます。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを右クリックして、ショートカット メニューの **\[行および列の編集\]** をクリックすることもできます。  
+  
+3.  列を追加または削除するには、**\[型\]** ボックスの **\[列\]** をクリックします。  
+  
+4.  行を追加または削除するには、**\[型\]** ボックスの **\[行\]** をクリックします。  
+  
+5.  **\[追加\]** をクリックすると、行または列が **\[メンバー\]** 一覧の末尾に追加されます。  
+  
+6.  **\[挿入\]** をクリックすると、一覧で現在選択されている項目の前に行または列が追加されます。  
+  
+7.  行または列を追加する場合は、新しい行または列の **\[サイズの型\]** を選択します。  詳細については、「<xref:System.Windows.Forms.SizeType>」を参照してください。  
+  
+8.  行または列を削除するには、**\[削除\]** をクリックします。**\[メンバー\]** 一覧で現在選択されている項目が削除されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SizeType>   
+ [TableLayoutPanel コントロール](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-autocomplete-in-toolstrip-controls-in-windows-forms.md b/docs/framework/winforms/controls/how-to-enable-autocomplete-in-toolstrip-controls-in-windows-forms.md
new file mode 100644
index 00000000000..dae0bc18954
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-autocomplete-in-toolstrip-controls-in-windows-forms.md
@@ -0,0 +1,112 @@
+---
+title: "方法 : Windows フォームで ToolStrip コントロールの AutoComplete を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "AutoComplete, 有効化 (ツール バーで)"
+  - "AutoComplete, 例"
+  - "例 [Windows フォーム], ツール バー"
+  - "ツール バー [Windows フォーム], AutoComplete"
+  - "ToolStrip コントロール [Windows フォーム], AutoComplete"
+  - "ToolStripComboBox クラス, 例"
+ms.assetid: fd66d085-1af1-45d4-930a-cde944da2e16
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームで ToolStrip コントロールの AutoComplete を有効にする
+最近アクセスした Web サイトなど、項目の一覧を表示するためにドロップダウンできる <xref:System.Windows.Forms.ToolStripComboBox> を、<xref:System.Windows.Forms.ToolStripLabel> と組み合わせる手順を次に示します。  ユーザーが入力した文字が一覧のいずれかの項目の最初の文字と一致した場合は、その項目が直ちに表示されます。  
+  
+> [!NOTE]
+>  オートコンプリート機能は、<xref:System.Windows.Forms.ComboBox> や <xref:System.Windows.Forms.TextBox> などの従来のコントロールと同様に、`ToolStrip` コントロールでも使用できます。  
+  
+### ToolStrip コントロールで AutoComplete を有効にするには  
+  
+1.  <xref:System.Windows.Forms.ToolStrip> コントロールを作成して、項目を追加します。  
+  
+    ```vb  
+    ToolStrip1 = New System.Windows.Forms.ToolStrip  
+    ToolStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem()_  
+        {ToolStripLabel1, ToolStripComboBox1})  
+    ```  
+  
+    ```csharp  
+    toolStrip1 = new System.Windows.Forms.ToolStrip();  
+    toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[]   
+        {toolStripLabel1, toolStripComboBox1});  
+  
+    ```  
+  
+2.  フォームのサイズに関係なく一覧を常に使用できるように、ラベルとコンボ ボックスの <xref:System.Windows.Forms.ToolStripItem.Overflow%2A> プロパティを <xref:System.Windows.Forms.ToolStripItemOverflow> に設定します。  
+  
+    ```vb  
+    ToolStripLabel1.Overflow = _  
+        System.Windows.Forms.ToolStripItemOverflow.Never  
+    ToolStripComboBox1.Overflow = _  
+        System.Windows.Forms.ToolStripItemOverflow.Never  
+    ```  
+  
+    ```csharp  
+    toolStripLabel1.Overflow = _  
+        System.Windows.Forms.ToolStripItemOverflow.Never  
+    toolStripComboBox1.Overflow = System.Windows.Forms.ToolStripItemOverflow.Never  
+  
+    ```  
+  
+3.  <xref:System.Windows.Forms.ToolStripComboBox> コントロールの項目コレクションに単語を追加します。  
+  
+    ```vb  
+    ToolStripComboBox1.Items.AddRange(New Object() {"First Item", _  
+        "Second Item", "Third Item"})  
+  
+    ```  
+  
+    ```csharp  
+    toolStripComboBox1.Items.AddRange(new object[] {"First item", "Second item", "Third item"});  
+  
+    ```  
+  
+4.  コンボ ボックスの <xref:System.Windows.Forms.ComboBox.AutoCompleteMode%2A> プロパティを <xref:System.Windows.Forms.AutoCompleteMode> に設定します。  
+  
+    ```vb  
+    ToolStripComboBox1.AutoCompleteMode = _  
+        System.Windows.Forms.AutoCompleteMode.Append  
+    ```  
+  
+    ```csharp  
+    toolStripComboBox1.AutoCompleteMode = System.Windows.Forms.AutoCompleteMode.Append;  
+  
+    ```  
+  
+5.  コンボ ボックスの <xref:System.Windows.Forms.ComboBox.AutoCompleteSource%2A> プロパティを <xref:System.Windows.Forms.AutoCompleteSource> に設定します。  
+  
+    ```vb  
+    ToolStripComboBox1.AutoCompleteSource = _  
+        System.Windows.Forms.AutoCompleteSource.ListItems  
+    ```  
+  
+    ```csharp  
+    toolStripComboBox1.AutoCompleteSource = System.Windows.Forms.AutoCompleteSource.ListItems;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripLabel>   
+ <xref:System.Windows.Forms.ToolStripComboBox>   
+ <xref:System.Windows.Forms.ToolStripComboBox.AutoCompleteMode%2A>   
+ <xref:System.Windows.Forms.ToolStripComboBox.AutoCompleteSource%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md b/docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md
new file mode 100644
index 00000000000..70fcaf0e1c3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-check-margins-and-image-margins-in-contextmenustrip-controls.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip コントロール [Windows フォーム]"
+  - "ShowCheckMargin プロパティ [Windows フォーム]"
+  - "ShowImageMargin プロパティ [Windows フォーム]"
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: eb584e71-59da-4012-aaca-dbe1c7c7a156
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ContextMenuStrip コントロールでチェックの余白とイメージの余白を有効にする
+<xref:System.Windows.Forms.ToolStripMenuItem> コントロールの <xref:System.Windows.Forms.MenuStrip> オブジェクトを、チェック マークやカスタム イメージを付けてカスタマイズできます。  
+  
+## 使用例  
+ 次のコード例は、チェック マークとカスタム イメージを持つメニュー項目を作成する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#60)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#60](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#60)]  
+  
+ <xref:System.Windows.Forms.ToolStripDropDownMenu.ShowCheckMargin%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Forms.ToolStripDropDownMenu.ShowImageMargin%2A?displayProperty=fullName> プロパティを設定して、チェック マークとカスタム イメージがメニュー項目に表示されるタイミングを指定します。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ <xref:System.Windows.Forms.ToolStripDropDownMenu>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..6bfab9b0c41
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 並べ替え"
+  - "データ グリッド, 並べ替え (列を)"
+  - "DataGridView コントロール [Windows フォーム], 列の順序"
+ms.assetid: cc20eae3-e4db-493f-95ce-a4215e29472a
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする
+<xref:System.Windows.Forms.DataGridView> コントロールで列の並べ替えを有効にすると、ユーザーは列ヘッダーをマウスでドラッグすることにより列を新しい場所に移動できます。  <xref:System.Windows.Forms.DataGridView> コントロールでは、<xref:System.Windows.Forms.DataGridView.AllowUserToOrderColumns%2A?displayProperty=fullName> プロパティ値によってユーザーが列を別の場所に移動できるかどうかが決まります。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法: デザイナーを使用して Windows フォーム DataGridView コントロールの列の並び替えを有効にする](http://msdn.microsoft.com/library/8xwtyc86\(v=vs.110\))」も参照してください。  
+  
+### プログラムで列の並べ替えを有効にするには  
+  
+-   <xref:System.Windows.Forms.DataGridView.AllowUserToOrderColumns%2A?displayProperty=fullName> プロパティを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#060](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#060)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#060](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#060)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToOrderColumns%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-reordering-of-toolstrip-items-at-run-time-in-windows-forms.md b/docs/framework/winforms/controls/how-to-enable-reordering-of-toolstrip-items-at-run-time-in-windows-forms.md
new file mode 100644
index 00000000000..7f0073489d6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-reordering-of-toolstrip-items-at-run-time-in-windows-forms.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム内で実行時に ToolStrip 項目を並べ替えできるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "AllowItemReorder プロパティ"
+  - "例 [Windows フォーム], ツール バー"
+  - "ツール バー [Windows フォーム], 再整列 (コントロールを)"
+  - "ToolStrip コントロール [Windows フォーム], 例"
+  - "ToolStrip コントロール [Windows フォーム], 並べ替え (項目を)"
+ms.assetid: 8480b69a-379f-4dc2-8dcf-365ed93692b2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム内で実行時に ToolStrip 項目を並べ替えできるようにする
+ユーザーが <xref:System.Windows.Forms.ToolStrip> で <xref:System.Windows.Forms.ToolStripItem> コントロールを再整列できるようにできます。  
+  
+### 実行時での ToolStripItem の再整列を有効にするには  
+  
+-   <xref:System.Windows.Forms.ToolStrip.AllowItemReorder%2A> プロパティを `true` に設定します。  既定では、<xref:System.Windows.Forms.ToolStrip.AllowItemReorder%2A> は `false` に設定されています。  
+  
+     実行時には、ユーザーは Alt キーを押したままマウスの左ボタンをクリックして <xref:System.Windows.Forms.ToolStripItem> を <xref:System.Windows.Forms.ToolStrip> 上の別の場所にドラッグします。  
+  
+    ```vb  
+    toolStrip1.AllowItemReorder = True  
+  
+    ```  
+  
+    ```csharp  
+    toolStrip1.AllowItemReorder = true;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStrip.AllowItemReorder%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-the-tab-key-to-move-out-of-a-toolstrip-control.md b/docs/framework/winforms/controls/how-to-enable-the-tab-key-to-move-out-of-a-toolstrip-control.md
new file mode 100644
index 00000000000..5acd6958d8e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-the-tab-key-to-move-out-of-a-toolstrip-control.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : Tab キーで ToolStrip コントロールから移動できるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 移動"
+  - "TAB キー, 有効化"
+  - "ToolStrip コントロール [Windows フォーム], 移動"
+ms.assetid: 40f9e88b-09a3-428e-8da8-c00bb65079c6
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Tab キーで ToolStrip コントロールから移動できるようにする
+ユーザーが Tab キーを押して <xref:System.Windows.Forms.ToolStrip> からタブ オーダーの次のコントロールに移動できるようにするには、次の手順に従ってください。  
+  
+ ユーザーが Tab キーを最初に押すと、<xref:System.Windows.Forms.ToolStrip> がこれを受け入れます。ユーザーは方向キーで <xref:System.Windows.Forms.ToolStrip> 内の項目を選択できます。  ユーザーが Tab キーをもう一度押すと、タブ オーダーの次のコントロールに移動します。  
+  
+### ユーザーが Tab キーを押して ToolStrip から次のコントロールに移動できるようにするには  
+  
+-   <xref:System.Windows.Forms.ToolStrip> の <xref:System.Windows.Forms.ToolStrip.TabStop%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStrip.TabStop%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-enable-tile-view-in-a-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-enable-tile-view-in-a-windows-forms-listview-control.md
new file mode 100644
index 00000000000..6d5b02d94c0
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-enable-tile-view-in-a-windows-forms-listview-control.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォーム ListView コントロールの &quot;並べて表示&quot; ビューを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ListView コントロール [Windows フォーム], 並べて表示ビュー"
+  - "並べて表示ビュー機能"
+  - "タイリング"
+  - "Windows フォーム, コントロール"
+ms.assetid: c20e67a3-2d94-413d-9fcf-ecbd0fe251da
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : Windows フォーム ListView コントロールの &quot;並べて表示&quot; ビューを有効にする
+<xref:System.Windows.Forms.ListView> コントロールの並べて表示ビュー機能を使用すると、グラフィカルな情報とテキスト情報をバランスよく表示できます。  並べて表示ビューの項目で表示されるテキスト情報は、詳細ビュー用に定義されている列情報と同じ情報です。  並べて表示ビューは、<xref:System.Windows.Forms.ListView> コントロールのグループ化機能または挿入マーク機能のいずれかと組み合わせて使用できます。  
+  
+ 並べて表示ビューでは、サイズが 32 × 32 ピクセルのアイコンと数行のテキストが次の画像のように使用されます。  
+  
+ ![ListView コントロール内のタイル ビュー](../../../../docs/framework/winforms/controls/media/listviewtile.gif "ListViewTile")  
+並べて表示ビューのアイコンとテキスト  
+  
+ 並べて表示ビューを有効にするには、<xref:System.Windows.Forms.ListView.View%2A> プロパティを <xref:System.Windows.Forms.View> に設定します。  <xref:System.Windows.Forms.ListView.TileSize%2A> プロパティを設定するとタイトルのサイズを調整できます。また、<xref:System.Windows.Forms.ListView.Columns%2A> コレクションを調整すると、タイルに表示されるテキストの行数を指定できます。  
+  
+> [!NOTE]
+>  並べて表示ビューを [!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] で使用できるのは、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出した場合だけです。  旧バージョンのオペレーティング システムでは、並べて表示ビューに関するコードがすべて無効になり、<xref:System.Windows.Forms.ListView> コントロールは大きなアイコンのビューで表示されます。  詳細については、「<xref:System.Windows.Forms.ListView.View%2A?displayProperty=fullName>」を参照してください。  
+  
+### プログラムによって並べて表示ビューを設定するには  
+  
+1.  <xref:System.Windows.Forms.ListView> コントロールの <xref:System.Windows.Forms.View> 列挙体を使用します。  
+  
+    ```vb  
+    ListView1.View = View.Tile  
+    ```  
+  
+    ```csharp  
+    listView1.View = View.Tile;  
+    ```  
+  
+## 使用例  
+ 次の完全なコード例は、タイルに表示するテキストを 3 行に変更した並べて表示ビューを示しています。  行の折り返しが発生しないようにタイルのサイズを調整しました。  
+  
+ [!code-cpp[System.Windows.Forms.ListView.Tiling#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ListView.Tiling/CPP/listviewtilingexample.cpp#1)]
+ [!code-csharp[System.Windows.Forms.ListView.Tiling#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListView.Tiling/CS/listviewtilingexample.cs#1)]
+ [!code-vb[System.Windows.Forms.ListView.Tiling#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListView.Tiling/VB/listviewtilingexample.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+-   book.ico という名前のアイコン ファイルは、実行可能ファイルと同じディレクトリにあります。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListView.TileSize%2A>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-expose-properties-of-constituent-controls.md b/docs/framework/winforms/controls/how-to-expose-properties-of-constituent-controls.md
new file mode 100644
index 00000000000..a78ffe3e526
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-expose-properties-of-constituent-controls.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : 内在コントロールのプロパティを公開する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "内在コントロール"
+  - "コントロール [Windows フォーム], 内在"
+  - "カスタム コントロール [Windows フォーム], 公開 (プロパティを)"
+  - "ユーザー コントロール [Windows フォーム], 公開 (内在コントロールを)"
+ms.assetid: 5c1ec98b-aa48-4823-986e-4712551cfdf1
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 内在コントロールのプロパティを公開する
+複合コントロールを構成するコントロールを "*内在コントロール*" と呼びます。  これらのコントロールは、通常はプライベートとして宣言されるため、開発者がアクセスすることはできません。  このようなコントロールのプロパティを後で利用できるようにする場合は、プロパティを公開する必要があります。  内在コントロールのプロパティを公開するには、ユーザー コントロールにプロパティを作成し、そのプロパティの `get` アクセサーと `set` アクセサーを使用して、内在コントロールのプライベート プロパティに変更を反映します。  
+  
+ `MyButton` という名前の内在ボタンを持つ、仮想のユーザー コントロールを例に考えます。  この場合、ユーザーが `ConstituentButtonBackColor` プロパティを要求すると、`MyButton` の <xref:System.Windows.Forms.Control.BackColor%2A> プロパティに格納されている値が返されます。  ユーザーがこのプロパティに値を割り当てると、値は自動的に `MyButton` の <xref:System.Windows.Forms.Control.BackColor%2A> プロパティに渡され、`set` コードが実行されて `MyButton` の色を変更します。  
+  
+ 内在ボタンの <xref:System.Windows.Forms.Control.BackColor%2A> プロパティを公開する方法を次の例に示します。  
+  
+```vb  
+Public Property ButtonColor() as System.Drawing.Color  
+   Get  
+      Return MyButton.BackColor  
+   End Get  
+   Set(Value as System.Drawing.Color)  
+      MyButton.BackColor = Value  
+   End Set  
+End Property  
+```  
+  
+```csharp  
+public Color ButtonColor  
+{  
+   get  
+   {  
+      return(myButton.BackColor);  
+   }  
+   set  
+   {  
+      myButton.BackColor = value;  
+   }  
+}  
+```  
+  
+### 内在コントロールのプロパティを公開するには  
+  
+1.  ユーザー コントロールのパブリック プロパティを作成します。  
+  
+2.  プロパティの `get` セクションに、公開するプロパティの値を取得するコードを記述します。  
+  
+3.  プロパティの `set` セクションに、内在コントロールの公開されたプロパティにプロパティの値を渡すコードを記述します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.UserControl>   
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..1a0ab96a997
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-format-data-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,84 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, テキストの配置"
+  - "通貨値, 書式設定 (データ グリッド内で)"
+  - "データ [Windows フォーム], 書式設定 (DataGridView コントロール内の)"
+  - "データ グリッド, 通貨値"
+  - "データ グリッド, 日付値"
+  - "データ グリッド, 有効化 (ワード ラップを)"
+  - "データ グリッド, 書式設定 (データを)"
+  - "データ グリッド, テキストの配置"
+  - "DataGridView コントロール [Windows フォーム], 書式設定 (データを)"
+ms.assetid: 8c33543c-9c08-4636-a65a-fdf714a529b7
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム DataGridView コントロールのデータの書式を設定する
+<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A> プロパティを使用した、セル値の基本的な書式設定手順と、コントロール内の特定の列の基本的な書式設定手順を以下に示します。  高度なデータ書式設定については、「[方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+### 通貨値と日付値の書式を設定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A> プロパティを設定します。  列の <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A> プロパティを使用して、特定の列の書式を設定するコード例を次に示します。   `UnitPrice`  列の値は、現在のカルチャ固有の通貨書式で表示され、負の値はかっこで囲まれます。   `ShipDate`  列の値は、現在のカルチャ固有の短い日付形式で表示されます。  <xref:System.Windows.Forms.DataGridViewCellStyle.Format%2A> 値の詳細については、「[型の書式設定](../../../../docs/standard/base-types/formatting-types.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#071](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#071)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#071](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#071)]  
+  
+### null データベース値の表示をカスタマイズするには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.NullValue%2A> プロパティを設定します。  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを使用して、<xref:System.DBNull.Value?displayProperty=fullName> に等しい値を含むすべてのセルに "no entry" と表示するコード例を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#073](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#073)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#073](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#073)]  
+  
+### テキスト ベースのセルでワードラップを有効にするには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A> プロパティに <xref:System.Windows.Forms.DataGridViewTriState> 列挙値のいずれかを設定します。  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを使用して、コントロール全体にラップ モードを設定するコード例を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#074](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#074)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#074](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#074)]  
+  
+### DataGridView セルのテキスト配置を指定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.Alignment%2A> プロパティに <xref:System.Windows.Forms.DataGridViewContentAlignment> 列挙値のいずれかを設定します。  列の <xref:System.Windows.Forms.DataGridViewColumn.DefaultCellStyle%2A> プロパティを使用して、特定の列に配置方法を設定するコード例を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#072](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#072)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#072](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#072)]  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#070](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#070)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#070](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#070)]  
+  
+## コードのコンパイル  
+ これらの例では、次の項目が必要です。  
+  
+-   `UnitPrice`、`ShipDate`、`CustomerName` という 3 つの列を含む、`dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Drawing?displayProperty=fullName> アセンブリ、および <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ 最大のスケーラビリティを引き出すには、同じスタイルを使用している複数の行、列、またはセル間で <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを共有し、各要素に個別のスタイル プロパティを設定しないようにする必要があります。  詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータの書式設定](../../../../docs/framework/winforms/controls/data-formatting-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)   
+ [型の書式設定](../../../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control-using-the-designer.md
new file mode 100644
index 00000000000..94647061bcf
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control-using-the-designer.md
@@ -0,0 +1,114 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム DataGrid コントロールの書式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 適用 (DataGrid コントロールに)"
+  - "列 [Windows フォーム], DataGrid コントロール"
+  - "DataGrid コントロール [Windows フォーム], 既定のスタイル"
+  - "DataGrid コントロール [Windows フォーム], 書式指定"
+  - "書式設定 [Windows フォーム]"
+  - "テーブル [Windows フォーム], 書式指定 (DataGrid コントロールでの)"
+ms.assetid: 533b9814-6124-49dc-9fda-085f1502609f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : デザイナーを使って Windows フォーム DataGrid コントロールの書式を設定する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールの各部分に異なる色を付けると、コントロールの情報が読みやすく、解釈しやすくなります。  行および列の色を指定できます。  また、行および列の表示\/非表示を切り替えることもできます。  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールの書式設定には、3 つの基本的な段階があります。  
+  
+-   プロパティを設定して、データを表示する既定のスタイルを設定できます。  
+  
+-   設定したスタイルに基づいて、実行時に特定のテーブルを表示する方法をカスタマイズできます。  
+  
+-   最後に、データ グリッドに表示する列、および表示する色やその他の書式を変更できます。  
+  
+ データ グリッドの書式設定の最初の手順として、<xref:System.Windows.Forms.DataGrid> 自体のプロパティを設定できます。  ここで選択した色および書式を基本として、表示するデータ テーブルおよび列に応じた変更を加えることができます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGrid> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] では、既定で <xref:System.Windows.Forms.DataGrid> コントロールは**ツールボックス**に含まれていません。  詳細については、「[How to: Add Items to the Toolbox](http://msdn.microsoft.com/ja-jp/458e119e-17fe-450b-b889-e31c128bd7e0)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### DataGrid コントロールの既定のスタイルを設定するには  
+  
+1.  <xref:System.Windows.Forms.DataGrid> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、次のプロパティを適切に設定します。  
+  
+    |プロパティ|Description|  
+    |-----------|-----------------|  
+    |<xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A>|`BackColor` プロパティは、グリッドの偶数番号の行の色を定義します。  <xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A> プロパティを異なる色に設定すると、1 行おきにこの新しい色が設定されます \(行 1、3、5 など\)。|  
+    |<xref:System.Windows.Forms.DataGrid.BackColor%2A>|グリッドの偶数番号の行 \(行 0、2、4、6 など\) の背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.BackgroundColor%2A>|<xref:System.Windows.Forms.DataGrid.BackColor%2A> プロパティと <xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A> プロパティはグリッドの行の色を決定しますが、<xref:System.Windows.Forms.DataGrid.BackgroundColor%2A> プロパティは行領域の外の領域の色を決定します。この領域は、グリッドが一番下までスクロールされたときや、グリッドに数行しか含まれていない場合にだけ表示されます。|  
+    |<xref:System.Windows.Forms.DataGrid.BorderStyle%2A>|グリッドの境界線スタイル。<xref:System.Windows.Forms.BorderStyle> 列挙値の 1 つです。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionBackColor%2A>|グリッドのウィンドウ キャプションの背景色。ウィンドウ キャプションは、グリッドのすぐ上に表示されます。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionFont%2A>|グリッドの上部のキャプションのフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionForeColor%2A>|グリッドのウィンドウ キャプションの背景色。|  
+    |<xref:System.Windows.Forms.Control.Font%2A>|グリッドのテキストの表示に使用されるフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.ForeColor%2A>|データ グリッドの行に表示されるデータのフォントの色。|  
+    |<xref:System.Windows.Forms.DataGrid.GridLineColor%2A>|データ グリッドのグリッド線の色。|  
+    |<xref:System.Windows.Forms.DataGrid.GridLineStyle%2A>|グリッドのセル間の線のスタイル。<xref:System.Windows.Forms.DataGridLineStyle> 列挙値の 1 つです。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderBackColor%2A>|行ヘッダーと列ヘッダーの背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderFont%2A>|列ヘッダーに使用されるフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderForeColor%2A>|グリッドの列ヘッダーの前景色。列ヘッダーのテキストおよびプラス\/マイナス グリフも含まれます。プラス記号 \(\+\)\/マイナス記号 \(\-\) グリフは、複数の関連するテーブルが表示されているときに行を展開するために使用します。|  
+    |<xref:System.Windows.Forms.DataGrid.LinkColor%2A>|データ グリッド内のすべてのリンク テキストの色。子テーブル、リレーションシップ名などへのリンクが含まれます。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsBackColor%2A>|子テーブルに表示される親テーブルの行の背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsForeColor%2A>|子テーブルに表示される親テーブルの行の前景色。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsLabelStyle%2A>|親テーブルの行にテーブル名と列名が表示されるかどうかを決定します。<xref:System.Windows.Forms.DataGridParentRowsLabelStyle> 列挙型を使用します。|  
+    |<xref:System.Windows.Forms.DataGrid.PreferredColumnWidth%2A>|グリッドの列の既定の幅 \(ピクセル単位\)。  このプロパティは、<xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティと <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティをリセットする前に設定してください。リセットした後で設定しても無効です。これらのプロパティは、別個にリセットするか、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用してリセットします。<br /><br /> このプロパティは、0 未満の値には設定できません。|  
+    |<xref:System.Windows.Forms.DataGrid.PreferredRowHeight%2A>|グリッドの行の高さ \(ピクセル単位\)。  このプロパティは、<xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティと <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティをリセットする前に設定してください。リセットした後で設定しても無効です。これらのプロパティは、別個にリセットするか、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用してリセットします。<br /><br /> このプロパティは、0 未満の値には設定できません。|  
+    |<xref:System.Windows.Forms.DataGrid.RowHeaderWidth%2A>|グリッドの行ヘッダーの幅。|  
+    |<xref:System.Windows.Forms.DataGrid.SelectionBackColor%2A>|行またはセルが選択されたときの背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.SelectionForeColor%2A>|行またはセルが選択されたときの前景色。|  
+  
+    > [!NOTE]
+    >  コントロールの色をカスタマイズするときには、不適切な色の選択 \(赤と緑など\) によってコントロールがアクセスできなくなる可能性があることに注意してください。  この問題を避けるには、**\[システム カラー\]** パレットに含まれる色を使用します。  
+  
+     次のプロシージャには、データ テーブルにバインドされた <xref:System.Windows.Forms.DataGrid> コントロールが必要です。  詳細については、「[方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)」を参照してください。  
+  
+### デザイン時にデータ テーブルのテーブル スタイルと列スタイルを設定するには  
+  
+1.  フォームで <xref:System.Windows.Forms.DataGrid> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.DataGrid.TableStyles%2A> プロパティを選択し、**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+3.  **\[DataGridTableStyle コレクション エディター\]** ダイアログ ボックスの **\[追加\]** をクリックしてテーブル スタイルをコレクションに追加します。  
+  
+     **DataGridTableStyle コレクション エディター**では、テーブル スタイルの追加または削除、表示やレイアウトのプロパティの設定、テーブル スタイルのマッピング名の設定をすることができます。  
+  
+4.  <xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> プロパティを各テーブル スタイルのマッピング名に設定します。  
+  
+     マッピング名を使用して、どのテーブルでどのテーブル スタイルを使用するかを指定します。  
+  
+5.  **DataGridTableStyle コレクション エディター**で、<xref:System.Windows.Forms.DataGridTableStyle.GridColumnStyles%2A> プロパティを選択し、省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+6.  **\[DataGridColumnStyle コレクション エディター\]** ダイアログ ボックスで、作成したテーブル スタイルに列スタイルを追加します。  
+  
+     **DataGridColumnStyle コレクション エディター**では、列スタイルの追加または削除、表示やレイアウトのプロパティの設定、データ列のマッピング名および書式指定文字列の設定をすることができます。  
+  
+    > [!NOTE]
+    >  書式指定文字列の詳細については、「[型の書式設定](../../../../docs/standard/base-types/formatting-types.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.GridTableStylesCollection>   
+ <xref:System.Windows.Forms.GridColumnStylesCollection>   
+ <xref:System.Windows.Forms.DataGrid>   
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..247f7471363
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-format-the-windows-forms-datagrid-control.md
@@ -0,0 +1,168 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールの書式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色, 適用 (DataGrid コントロールに)"
+  - "列 [Windows フォーム], DataGrid コントロール"
+  - "列 [Windows フォーム], 書式指定 (DataGrid コントロールでの)"
+  - "DataGrid コントロール [Windows フォーム], 既定のスタイル"
+  - "DataGrid コントロール [Windows フォーム], 書式指定"
+  - "書式設定 [Windows フォーム]"
+  - "テーブル [Windows フォーム], 書式指定 (DataGrid コントロールでの)"
+ms.assetid: a50fcc3b-8abf-47ec-9029-7f268af4ddb1
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGrid コントロールの書式を設定する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールの各部分に異なる色を付けると、コントロールの情報が読みやすく、解釈しやすくなります。  行および列の色を指定できます。  また、行および列の表示\/非表示を切り替えることもできます。  
+  
+ <xref:System.Windows.Forms.DataGrid> コントロールの書式設定には、3 つの基本的な段階があります。  プロパティを設定して、データを表示する既定のスタイルを設定できます。  設定したスタイルに基づいて、実行時に特定のテーブルを表示する方法をカスタマイズできます。  最後に、データ グリッドに表示する列、および表示する色やその他の書式を変更できます。  
+  
+ データ グリッドの書式設定の最初の手順として、<xref:System.Windows.Forms.DataGrid> 自体のプロパティを設定できます。  ここで選択した色および書式を基本として、表示するデータ テーブルおよび列に応じた変更を加えることができます。  
+  
+### DataGrid コントロールの既定のスタイルを設定するには  
+  
+1.  必要に応じて次のプロパティを設定します。  
+  
+    |プロパティ|Description|  
+    |-----------|-----------------|  
+    |<xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A>|<xref:System.Windows.Forms.DataGrid.BackColor%2A> プロパティは、グリッドの偶数番号の行の色を定義します。  <xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A> プロパティを異なる色に設定すると、1 行おきにこの新しい色が設定されます \(行 1、3、5 など\)。|  
+    |<xref:System.Windows.Forms.DataGrid.BackColor%2A>|グリッドの偶数番号の行 \(行 0、2、4、6 など\) の背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.BackgroundColor%2A>|<xref:System.Windows.Forms.DataGrid.BackColor%2A> プロパティと <xref:System.Windows.Forms.DataGrid.AlternatingBackColor%2A> プロパティはグリッドの行の色を決定しますが、<xref:System.Windows.Forms.DataGrid.BackgroundColor%2A> プロパティは行以外の領域の色を決定します。この領域は、グリッドが一番下までスクロールされたときや、グリッドに数行しか含まれていない場合にだけ表示されます。|  
+    |<xref:System.Windows.Forms.DataGrid.BorderStyle%2A>|グリッドの境界線スタイル。<xref:System.Windows.Forms.BorderStyle> 列挙値の 1 つです。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionBackColor%2A>|グリッドのウィンドウ キャプションの背景色。ウィンドウ キャプションは、グリッドのすぐ上に表示されます。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionFont%2A>|グリッドの上部のキャプションのフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.CaptionForeColor%2A>|グリッドのウィンドウ キャプションの背景色。|  
+    |<xref:System.Windows.Forms.Control.Font%2A>|グリッドのテキストの表示に使用されるフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.ForeColor%2A>|データ グリッドの行に表示されるデータのフォントの色。|  
+    |<xref:System.Windows.Forms.DataGrid.GridLineColor%2A>|データ グリッドのグリッド線の色。|  
+    |<xref:System.Windows.Forms.DataGrid.GridLineStyle%2A>|グリッドのセル間の線のスタイル。<xref:System.Windows.Forms.DataGridLineStyle> 列挙値の 1 つです。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderBackColor%2A>|行ヘッダーと列ヘッダーの背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderFont%2A>|列ヘッダーに使用されるフォント。|  
+    |<xref:System.Windows.Forms.DataGrid.HeaderForeColor%2A>|グリッドの列ヘッダーの前景色。列ヘッダーのテキストおよびプラス\/マイナス グリフも含まれます。プラス\/マイナス グリフは、複数の関連するテーブルが表示されているときに行を展開するために使用します。|  
+    |<xref:System.Windows.Forms.DataGrid.LinkColor%2A>|データ グリッド内のすべてのリンク テキストの色。子テーブル、リレーションシップ名などへのリンクが含まれます。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsBackColor%2A>|子テーブルに表示される親テーブルの行の背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsForeColor%2A>|子テーブルに表示される親テーブルの行の前景色。|  
+    |<xref:System.Windows.Forms.DataGrid.ParentRowsLabelStyle%2A>|親テーブルの行にテーブル名と列名が表示されるかどうかを決定します。<xref:System.Windows.Forms.DataGridParentRowsLabelStyle> 列挙型を使用します。|  
+    |<xref:System.Windows.Forms.DataGrid.PreferredColumnWidth%2A>|グリッドの列の既定の幅 \(ピクセル単位\)。  このプロパティは、<xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティと <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティをリセットする前に設定してください。リセットした後で設定しても無効です。これらのプロパティは、別個にリセットするか、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用してリセットします。<br /><br /> このプロパティは、0 未満の値には設定できません。|  
+    |<xref:System.Windows.Forms.DataGrid.PreferredRowHeight%2A>|グリッドの行の高さ \(ピクセル単位\)。  このプロパティは、<xref:System.Windows.Forms.DataGrid.DataSource%2A> プロパティと <xref:System.Windows.Forms.DataGrid.DataMember%2A> プロパティをリセットする前に設定してください。リセットした後で設定しても無効です。これらのプロパティは、別個にリセットするか、<xref:System.Windows.Forms.DataGrid.SetDataBinding%2A> メソッドを使用してリセットします。<br /><br /> このプロパティは、0 未満の値には設定できません。|  
+    |<xref:System.Windows.Forms.DataGrid.RowHeaderWidth%2A>|グリッドの行ヘッダーの幅。|  
+    |<xref:System.Windows.Forms.DataGrid.SelectionBackColor%2A>|行またはセルが選択されたときの背景色。|  
+    |<xref:System.Windows.Forms.DataGrid.SelectionForeColor%2A>|行またはセルが選択されたときの前景色。|  
+  
+    > [!NOTE]
+    >  コントロールの色をカスタマイズするときには、不適切な色の選択 \(赤と緑など\) によってコントロールがアクセスできなくなる可能性があることに注意してください。  この問題を避けるには、\[システム カラー\] パレットに含まれる色を使用します。  
+  
+     次の手順では、データ テーブルにバインドされた <xref:System.Windows.Forms.DataGrid> コントロールがフォームに含まれると仮定しています。  詳細については、「[方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)」を参照してください。  
+  
+### プログラムでデータ テーブルのテーブル スタイルと列スタイルを設定するには  
+  
+1.  新しいテーブル スタイルを作成し、そのプロパティを設定します。  
+  
+2.  列スタイルを作成し、そのプロパティを設定します。  
+  
+3.  テーブル スタイルの列スタイル コレクションに列スタイルを追加します。  
+  
+4.  データ グリッドのテーブル スタイル コレクションにテーブル スタイルを追加します。  
+  
+5.  次の例では、新しい <xref:System.Windows.Forms.DataGridTableStyle> のインスタンスを作成し、<xref:System.Windows.Forms.DataGridTableStyle.MappingName%2A> プロパティを設定します。  
+  
+6.  **GridColumnStyle** の新しいインスタンスを作成し、その **MappingName** \(および他のいくつかのレイアウト プロパティと表示プロパティ\) を設定します。  
+  
+7.  作成する各列スタイルに対して、手順 2. ～ 6. を繰り返します。  
+  
+     列に名前を表示するために、<xref:System.Windows.Forms.DataGridTextBoxColumn> を作成する方法を次に示します。  また、テーブル スタイルの <xref:System.Windows.Forms.GridColumnStylesCollection> に列スタイルを追加し、データ グリッドの <xref:System.Windows.Forms.GridTableStylesCollection> にテーブル スタイルを追加します。  
+  
+    ```vb  
+    Private Sub CreateAuthorFirstNameColumn()  
+       ' Add a GridTableStyle and set the MappingName   
+       ' to the name of the DataTable.  
+       Dim TSAuthors As New DataGridTableStyle()  
+       TSAuthors.MappingName = "Authors"  
+  
+       ' Add a GridColumnStyle and set the MappingName   
+       ' to the name of a DataColumn in the DataTable.   
+       ' Set the HeaderText and Width properties.   
+       Dim TCFirstName As New DataGridTextBoxColumn()  
+       TCFirstName.MappingName = "AV_FName"  
+       TCFirstName.HeaderText = "First Name"  
+       TCFirstName.Width = 75  
+       TSAuthors.GridColumnStyles.Add(TCFirstName)  
+  
+       ' Add the DataGridTableStyle instance to   
+       ' the GridTableStylesCollection.   
+       myDataGrid.TableStyles.Add(TSAuthors)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void addCustomDataTableStyle()  
+    {  
+       // Add a GridTableStyle and set the MappingName   
+       // to the name of the DataTable.  
+       DataGridTableStyle TSAuthors = new DataGridTableStyle();  
+       TSAuthors.MappingName = "Authors";  
+  
+       // Add a GridColumnStyle and set the MappingName   
+       // to the name of a DataColumn in the DataTable.   
+       // Set the HeaderText and Width properties.   
+       DataGridColumnStyle TCFirstName = new DataGridTextBoxColumn();  
+       TCFirstName.MappingName = " AV_FName";  
+       TCFirstName.HeaderText = "First Name";  
+       TCFirstName.Width = 75;  
+       TSAuthors.GridColumnStyles.Add(TCFirstName);  
+  
+       // Add the DataGridTableStyle instance to   
+       // the GridTableStylesCollection.   
+       dataGrid1.TableStyles.Add(TSAuthors);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void addCustomDataTableStyle()  
+       {  
+          // Add a GridTableStyle and set the MappingName   
+          // to the name of the DataTable.  
+          DataGridTableStyle^ TSAuthors = new DataGridTableStyle();  
+          TSAuthors->MappingName = "Authors";  
+  
+          // Add a GridColumnStyle and set the MappingName   
+          // to the name of a DataColumn in the DataTable.   
+          // Set the HeaderText and Width properties.   
+          DataGridColumnStyle^ TCFirstName = gcnew DataGridTextBoxColumn();  
+          TCFirstName->MappingName = "AV_FName";  
+          TCFirstName->HeaderText = "First Name";  
+          TCFirstName->Width = 75;  
+          TSAuthors->GridColumnStyles->Add(TCFirstName);  
+  
+          // Add the DataGridTableStyle instance to   
+          // the GridTableStylesCollection.   
+          dataGrid1->TableStyles->Add(TSAuthors);  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.GridTableStylesCollection>   
+ <xref:System.Windows.Forms.GridColumnStylesCollection>   
+ <xref:System.Windows.Forms.DataGrid>   
+ [方法 : Windows フォーム DataGrid コントロールの列を削除するまたは非表示にする](../../../../docs/framework/winforms/controls/how-to-delete-or-hide-columns-in-the-windows-forms-datagrid-control.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..b02d031e965
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-freeze-columns-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの列を固定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 固定"
+  - "DataGridView コントロール [Windows フォーム], 列 (常に表示される)"
+  - "DataGridView コントロール [Windows フォーム], 固定 (列を)"
+ms.assetid: 2ef8b1de-782e-4867-af8d-58171ab5c106
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム DataGridView コントロールの列を固定する
+ユーザーが Windows フォームの <xref:System.Windows.Forms.DataGridView> コントロールに表示されるデータを確認するときに、1 つの列または列のセットを頻繁に参照しなければならないことがあります。  たとえば、多数の列を含む顧客情報のテーブルを表示するとき、顧客名を常に表示して、その他の列は表示領域外にスクロールするようにできると便利です。  
+  
+ この動作を実現するために、コントロールの列を固定することができます。  列を固定すると、左側 \(右から左へ記述する言語のスクリプトでは右側\) のすべての列も同様に固定されます。  固定された列は表示されたままになり、その他のすべての列はスクロールできます。  
+  
+> [!NOTE]
+>  列の並べ替えが有効な場合、固定された列は、固定されていない列とは異なるグループとして扱われます。  ユーザーは、どちらかのグループに列を再配置できますが、1 つのグループから別のグループに列を移動することはできません。  
+  
+ 列の <xref:System.Windows.Forms.DataGridViewColumn.Frozen%2A> プロパティは、列が常にグリッド内で表示されるかどうかを決定します。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する](http://msdn.microsoft.com/library/717ss6s6\(v=vs.110\))」も参照してください。  
+  
+### プログラムで列を固定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.Frozen%2A?displayProperty=fullName> プロパティを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#061](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#061)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#061](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#061)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `AddToCartButton` という名前の列を含む `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridViewColumn.Frozen%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](../../../../docs/framework/winforms/controls/how-to-enable-column-reordering-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md b/docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md
new file mode 100644
index 00000000000..a42fb8190e6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : コントロールに透明な背景を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 透明な背景"
+  - "透明度, Windows フォーム カスタム コントロール"
+  - "透明な背景, カスタム コントロール"
+ms.assetid: 32433e63-f4e9-4305-9857-6de3edeb944a
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : コントロールに透明な背景を指定する
+.NET Framework の従来のバージョンでは、あらかじめフォームのコンストラクターに <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを設定しておかないと、透明な背景色を設定できませんでした。 フレームワークの現在のバージョンでは、ほとんどのコントロールの背景色を、設計時に **\[プロパティ\]** ウィンドウで、またはフォームのコンストラクターのコードで、<xref:System.Drawing.Color.Transparent%2A> に設定できます。  
+  
+> [!NOTE]
+>  Windows フォーム コントロールは、完全な透過性はサポートしていません。 透明な Windows フォーム コントロールの背景は、その親によって描画されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ButtonBase.BackColor%2A> プロパティが <xref:System.Drawing.Color.Transparent%2A> に設定されている場合でも、<xref:System.Windows.Controls.Button> コントロールは透明な背景をサポートしません。  
+  
+### コントロールに透明な背景を設定するには  
+  
+-   \[プロパティ\] ウィンドウで <xref:System.Windows.Forms.ButtonBase.BackColor%2A> プロパティを選択し、<xref:System.Drawing.Color.Transparent%2A> に設定します。  
+  
+## 参照  
+ <xref:System.Drawing.Color.FromArgb%2A>   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)   
+ [方法 : 不透明な直線および半透明な直線を描画する](../../../../docs/framework/winforms/advanced/how-to-draw-opaque-and-semitransparent-lines.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-group-controls-with-the-windows-forms-groupbox-control.md b/docs/framework/winforms/controls/how-to-group-controls-with-the-windows-forms-groupbox-control.md
new file mode 100644
index 00000000000..d96a6057d7f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-group-controls-with-the-windows-forms-groupbox-control.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : Windows フォーム GroupBox コントロールを使用してコントロールをグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], グループ化"
+  - "GroupBox コントロール [Windows フォーム], グループ化 (コントロールを)"
+  - "Windows フォーム コントロール, グループ化"
+ms.assetid: 0bda316d-bd2a-43aa-ac73-342453303169
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォーム GroupBox コントロールを使用してコントロールをグループ化する
+Windows フォームの <xref:System.Windows.Forms.GroupBox> コントロールを使用すると、他のコントロールをグループ化できます。  コントロールのグループ化には、次の 3 つの利点があります。  
+  
+-   関連しているフォーム要素を視覚的にグループ化して、わかりやすいユーザー インターフェイスを提供します。  
+  
+-   オプション ボタンなどをグループ化してプログラミングできます。  
+  
+-   デザイン時に複数のコントロールをまとめて移動できます。  
+  
+### コントロールのグループを作成するには  
+  
+1.  フォームに <xref:System.Windows.Forms.GroupBox> コントロールを配置します。  
+  
+2.  グループ ボックスにほかのコントロールを追加し、それぞれグループ ボックス内に配置します。  
+  
+     既存のコントロールをグループ ボックスに追加する場合は、追加するすべてのコントロールを選択し、クリップボードに切り取ります。次に、<xref:System.Windows.Forms.GroupBox> コントロールを選択し、コントロールをグループ ボックスに貼り付けます。  コントロールをグループ ボックスにドラッグすることもできます。  
+  
+3.  グループ ボックスの <xref:System.Windows.Forms.GroupBox.Text%2A> プロパティに適切なキャプションを設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.GroupBox>   
+ [GroupBox コントロール](../../../../docs/framework/winforms/controls/groupbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control-using-the-designer.md
new file mode 100644
index 00000000000..92d5658c5c4
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control-using-the-designer.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム ListView コントロールの項目をグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グループ化"
+  - "グループ, Windows フォーム コントロールの"
+  - "ListView コントロール [Windows フォーム], グループ化 (項目を)"
+ms.assetid: 8b615000-69d9-4c64-acaf-b54fa09b69e3
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイナーを使って Windows フォーム ListView コントロールの項目をグループ化する
+<xref:System.Windows.Forms.ListView> コントロールのグループ化機能を使用すると、関連する複数の項目をグループ化して表示できます。  これらのグループは、画面上で、グループ タイトルを含む水平方向のグループ ヘッダーで区切られます。  <xref:System.Windows.Forms.ListView> グループを使って、項目をアルファベット順、日付順、またはその他の論理的なグループにまとめることにより、大きなリストの内部を移動することが簡単になります。  次のイメージは、グループ化した項目の例を示しています。  
+  
+ ![ListView グループ](../../../../docs/framework/winforms/controls/media/listviewgroups.gif "ListViewGroups")  
+  
+ 次の手順では、<xref:System.Windows.Forms.ListView> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+ グループ化を有効にするには、まず、デザイナーまたはプログラムで、1 つ以上の <xref:System.Windows.Forms.ListViewGroup> オブジェクトを作成します。  グループを定義した後で、それに項目を割り当てることができます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ListView> を [!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] で使用できるのは、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出した場合だけです。  以前のオペレーティング システムでは、グループに関連するコードは無効になり、グループは表示されません。  詳細については、「<xref:System.Windows.Forms.ListView.Groups%2A?displayProperty=fullName>」を参照してください。  
+>   
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーでグループを追加または削除するには  
+  
+1.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.ListView.Groups%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+     **ListViewGroup コレクション エディター**が表示されます。  
+  
+2.  グループを追加するには、**\[追加\]** をクリックします。  新規グループのプロパティ、たとえば <xref:System.Windows.Forms.ListViewGroup.Header%2A> プロパティや <xref:System.Windows.Forms.ListViewGroup.HeaderAlignment%2A> プロパティなどを設定します。  グループを削除するには、項目を選択し、**\[削除\]** をクリックします。  
+  
+### デザイナーでグループに項目を割り当てるには  
+  
+1.  **\[プロパティ\]** ウィンドウの <xref:System.Windows.Forms.ListView.Items%2A> プロパティの横にある**省略記号** \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックします。  
+  
+     **ListViewItem コレクション エディター**が表示されます。  
+  
+2.  項目を追加するには、**\[追加\]** をクリックします。  新規項目のプロパティ、たとえば <xref:System.Windows.Forms.ListViewItem.Text%2A> プロパティや <xref:System.Windows.Forms.ListViewItem.ImageIndex%2A> プロパティなどを設定します。  
+  
+3.  <xref:System.Windows.Forms.ListViewItem.Group%2A> プロパティをクリックして、ドロップダウン リストからグループを選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListView.Groups%2A>   
+ <xref:System.Windows.Forms.ListViewGroup>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md
new file mode 100644
index 00000000000..f3e90d5762d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォーム ListView コントロールの項目をグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グループ化"
+  - "グループ"
+  - "グループ, Windows フォーム コントロールの"
+  - "リスト ビュー, グループ化 (項目を)"
+  - "一覧, グループ化 (項目を)"
+  - "ListView コントロール [Windows フォーム], グループ化 (項目を)"
+ms.assetid: 610416a1-8da4-436c-af19-5f19e654769b
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム ListView コントロールの項目をグループ化する
+<xref:System.Windows.Forms.ListView> コントロールのグループ化機能を使用すると、関連する複数の項目をグループ化して表示できます。  これらのグループは、画面上で、グループ タイトルを含む水平方向のグループ ヘッダーで区切られます。  <xref:System.Windows.Forms.ListView> グループを使って、項目をアルファベット順、日付順、またはその他の論理的なグループにまとめることにより、大きなリストの内部を移動することが簡単になります。  次のイメージは、グループ化した項目の例を示しています。  
+  
+ ![ListView グループ](../../../../docs/framework/winforms/controls/media/listviewgroups.gif "ListViewGroups")  
+ListView でグループ化された項目  
+  
+ グループ化を有効にするには、まず、デザイナーまたはプログラムで、1 つ以上のグループを作成します。  グループを定義した後で、そのグループに <xref:System.Windows.Forms.ListView> 項目を割り当てることができます。  プログラムによって、項目を 1 つのグループから別のグループに移動することもできます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ListView> を [!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] で使用できるのは、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出した場合だけです。  以前のオペレーティング システムでは、グループに関連するコードは無効になり、グループは表示されません。  詳細については、「<xref:System.Windows.Forms.ListView.Groups%2A?displayProperty=fullName>」を参照してください。  
+  
+### グループを追加するには  
+  
+1.  <xref:System.Windows.Forms.ListView.Groups%2A> コレクションの <xref:System.Windows.Forms.ListViewGroupCollection.Add%2A> メソッドを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#21](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#21)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#21](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#21)]  
+  
+### グループを削除するには  
+  
+1.  <xref:System.Windows.Forms.ListView.Groups%2A> コレクションの <xref:System.Windows.Forms.ListViewGroupCollection.RemoveAt%2A> メソッドまたは <xref:System.Windows.Forms.ListViewGroupCollection.Clear%2A> メソッドを使用します。  
+  
+     <xref:System.Windows.Forms.ListViewGroupCollection.RemoveAt%2A> メソッドは 1 つのグループを削除します。<xref:System.Windows.Forms.ListViewGroupCollection.Clear%2A> メソッドはリストのすべてのグループを削除します。  
+  
+    > [!NOTE]
+    >  グループを削除しても、そのグループ内の項目は削除されません。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#22)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#22)]  
+  
+### 項目をグループに割り当てたりグループ間で項目を移動したりするには  
+  
+1.  個々の項目の <xref:System.Windows.Forms.ListViewItem.Group%2A?displayProperty=fullName> プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.ListViewLegacyTopics#23](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/CS/Class1.cs#23)]
+     [!code-vb[System.Windows.Forms.ListViewLegacyTopics#23](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListViewLegacyTopics/VB/Class1.vb#23)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListView.Groups%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ListViewGroup>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)   
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md b/docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md
new file mode 100644
index 00000000000..5ad52189a1f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : セットとして機能する Windows フォーム RadioButton コントロールをグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], グループ化"
+  - "オプション ボタン, グループ化"
+  - "RadioButton コントロール [Windows フォーム], グループ化"
+  - "Windows フォーム コントロール, グループ化"
+ms.assetid: 58f8fe34-50b7-49d8-a2be-c271be3c6b32
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : セットとして機能する Windows フォーム RadioButton コントロールをグループ化する
+Windows フォーム <xref:System.Windows.Forms.RadioButton> コントロールは、ユーザーが 2 つ以上の設定から 1 つだけを選択できるようにデザインされています。これらの設定は、プロシージャまたはオブジェクトに対して 1 つだけ割り当てることができます。  たとえば、<xref:System.Windows.Forms.RadioButton> コントロールのグループでは、1 つの注文に対して複数のパッケージ運送業者を表示できますが、使用する運送業者は 1 つだけです。  このため、機能グループの一部であっても、一度に選択できる <xref:System.Windows.Forms.RadioButton> は 1 つだけとなります。  
+  
+ <xref:System.Windows.Forms.Panel> コントロール、<xref:System.Windows.Forms.GroupBox> コントロール、フォームなどのコンテナーに配置することによって、オプション ボタンをグループ化します。  1 つのフォームに直接追加したすべてのオプション ボタンは、1 つのグループとなります。  異なるグループを追加するには、パネルまたはグループ ボックス内にグループを配置する必要があります。  パネルまたはグループ ボックスの詳細については、「[Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)」または「[GroupBox コントロールの概要](../../../../docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md)」を参照してください。  
+  
+### 独立した機能のセットとして RadioButton コントロールをグループ化するには  
+  
+1.  **\[ツールボックス\]** の **\[Windows フォーム\]** タブから <xref:System.Windows.Forms.GroupBox> コントロールまたは <xref:System.Windows.Forms.Panel> コントロールをフォームにドラッグします。  
+  
+2.  <xref:System.Windows.Forms.RadioButton> コントロールを <xref:System.Windows.Forms.GroupBox> または <xref:System.Windows.Forms.Panel> コントロールに配置します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RadioButton>   
+ [RadioButton コントロールの概要](../../../../docs/framework/winforms/controls/radiobutton-control-overview-windows-forms.md)   
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)   
+ [GroupBox コントロールの概要](../../../../docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md)   
+ [CheckBox コントロールの概要](../../../../docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md)   
+ [RadioButton コントロール](../../../../docs/framework/winforms/controls/radiobutton-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md b/docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md
new file mode 100644
index 00000000000..92dfd9cace5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : データ バインドで発生するエラーと例外を処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], 処理 (エラーと例外を)"
+  - "データ バインド, エラー処理"
+  - "データ バインド, 例"
+  - "エラー処理, データ バインド"
+  - "エラー処理, 例"
+  - "例 [Windows フォーム], エラー処理"
+ms.assetid: eddc5bad-9513-47df-ab28-f02d8dff7892
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : データ バインドで発生するエラーと例外を処理する
+基になるビジネス オブジェクトをコントロールにバインドするときに、それらのビジネス オブジェクトで例外やエラーが発生することがよくあります。  特定の <xref:System.Windows.Forms.Binding> コンポーネント、<xref:System.Windows.Forms.BindingSource> コンポーネント、または <xref:System.Windows.Forms.CurrencyManager> コンポーネントの <xref:System.Windows.Forms.Binding.BindingComplete> イベントを処理することにより、これらのエラーや例外をインターセプトし、回復したり、エラー情報をユーザーに渡したりできます。  
+  
+## 使用例  
+ データ バインディング操作時に発生するエラーと例外を処理する方法を次のコード例に示します。  ここでは、<xref:System.Windows.Forms.Binding> オブジェクトの <xref:System.Windows.Forms.Binding.BindingComplete?displayProperty=fullName> イベントを処理してエラーをインターセプトする方法を示します。  このイベントを処理してエラーと例外をインターセプトするには、バインディングの書式設定を有効にする必要があります。  バインディングの書式設定は、バインディングの作成時やバインディング コレクションへの追加時に有効にできます。また、<xref:System.Windows.Forms.Binding.FormattingEnabled%2A> プロパティを `true` に設定すると有効にできます。  
+  
+ [!code-cpp[System.Windows.Forms.DataConnectorBindingComplete#3](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorBindingComplete/CPP/form1.cpp#3)]
+ [!code-csharp[System.Windows.Forms.DataConnectorBindingComplete#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorBindingComplete/CS/form1.cs#3)]
+ [!code-vb[System.Windows.Forms.DataConnectorBindingComplete#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorBindingComplete/VB/form1.vb#3)]  
+  
+ コードの実行時に、部品名に空の文字列が入力されるか、部品番号に 100 未満の値が入力されると、メッセージ ボックスが表示されます。  これは、これらのテキスト ボックス バインディングの <xref:System.Windows.Forms.Binding.BindingComplete?displayProperty=fullName> イベントを処理した結果です。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Binding.BindingComplete?displayProperty=fullName>   
+ <xref:System.Windows.Forms.BindingSource.BindingComplete?displayProperty=fullName>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-handle-the-contextmenustrip-opening-event.md b/docs/framework/winforms/controls/how-to-handle-the-contextmenustrip-opening-event.md
new file mode 100644
index 00000000000..0917796ab5f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-handle-the-contextmenustrip-opening-event.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : ContextMenuStrip のオープン イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, イベント処理"
+  - "ContextMenuStrip コントロール [Windows フォーム]"
+  - "イベント処理, コンテキスト メニュー"
+  - "ショートカット メニュー, イベント処理"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: b661b3dd-7815-4cc2-a1aa-a9a391ab3427
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ContextMenuStrip のオープン イベントを処理する
+<xref:System.Windows.Forms.ToolStripDropDown.Opening> イベントを処理することにより、<xref:System.Windows.Forms.ContextMenuStrip> コントロールの動作をカスタマイズできます。  
+  
+## 使用例  
+ <xref:System.Windows.Forms.ToolStripDropDown.Opening> イベントを処理する方法を次のコード例に示します。  このイベント ハンドラーでは、<xref:System.Windows.Forms.ContextMenuStrip> コントロールに項目を動的に追加します。  完全なコード例については、「[方法 : ToolStrip の項目を動的に追加する](../../../../docs/framework/winforms/controls/how-to-add-toolstrip-items-dynamically.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#42](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#42)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#42](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#42)]  
+  
+ <xref:System.ComponentModel.CancelEventArgs.Cancel%2A?displayProperty=fullName> プロパティを `true` に設定して、メニューが開かないようにします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.ComponentModel.CancelEventArgs.Cancel%2A>   
+ <xref:System.Windows.Forms.ToolStripDropDown>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..6ed92bc4f6c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-hide-column-headers-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの列ヘッダーを非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列ヘッダー, 非表示"
+  - "列 [Windows フォーム], 非表示 (列ヘッダーを)"
+  - "DataGridView コントロール [Windows フォーム], 列ヘッダー"
+ms.assetid: e4ad5f68-50d2-4b9e-93ee-9d622423a8ab
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールの列ヘッダーを非表示にする
+<xref:System.Windows.Forms.DataGridView> を列ヘッダーなしで表示する必要が生じる場合があります。  <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.ColumnHeadersVisible%2A> プロパティ値を使用して、列ヘッダーを表示するかどうかを決定します。  
+  
+### 列ヘッダーを非表示にするには  
+  
+-   <xref:System.Windows.Forms.DataGridView.ColumnHeadersVisible%2A?displayProperty=fullName> プロパティを `false` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#062](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#062)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#062](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#062)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersVisible%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-hide-columns-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-hide-columns-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..ae4df4fd591
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-hide-columns-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールの列を非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 非表示"
+  - "データ グリッド, 非表示 (列を)"
+  - "DataGridView コントロール [Windows フォーム], 非表示 (列を)"
+ms.assetid: 3f94143a-2ef0-49a5-a22a-b2e6f9289642
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : Windows フォームの DataGridView コントロールの列を非表示にする
+Windows フォームの <xref:System.Windows.Forms.DataGridView> コントロールで使用できる列の一部のみを表示したいときがあります。  たとえば、管理の資格情報を持つユーザーには従業員の給与の列を表示し、その他のユーザーには非表示にしたいときがあります。  また、多数の列を含み、その一部のみを表示したいデータ ソースにコントロールをバインドすることもあります。  この場合、通常は列を非表示にするよりは、必要がない列を削除します。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールでは、列の <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A> プロパティの値により、その列が表示されているかどうかが決定されます。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする](http://msdn.microsoft.com/library/kaswfbes\(v=vs.110\))」も参照してください。  
+  
+### プログラムで列を非表示にするには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A?displayProperty=fullName> プロパティを `false` に設定します。  データのバインド中に自動的に生成された `CustomerID` 列を非表示にするには、<xref:System.Windows.Forms.DataGridView.DataBindingComplete> イベント ハンドラーに次のコードの列を配置します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#063](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#063)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#063](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#063)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `CustomerID` という名前の列を含む `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する](../../../../docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-order-of-columns-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems-using-the-designer.md b/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems-using-the-designer.md
new file mode 100644
index 00000000000..773daa99b55
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems-using-the-designer.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : デザイナーを使用して ToolStripMenuItems を非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目, 非表示"
+  - "MenuStrip コントロール [Windows フォーム], 非表示 (メニュー項目をデザイナーで)"
+  - "ToolStripMenuItem, 非表示 (メニュー項目をデザイナーで)"
+ms.assetid: 8f1b057e-3d8a-4f11-88df-935f7b29a836
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイナーを使用して ToolStripMenuItems を非表示にする
+メニュー項目を非表示にすると、アプリケーションのユーザー インターフェイス \(UI\) を制御したり、ユーザーが使用するコマンドを制限したりできます。  通常、メニュー項目がすべて使用不可能なメニューは、メニュー全体を非表示にする必要があります。  使用できないメニューを非表示にすることによって、ユーザーの混乱を避けることができます。  さらに、メニューまたはメニュー項目の非表示と無効化の両方が必要となることがあります。これは非表示にしただけでは、ショートカット キーを使用してメニュー コマンドにアクセスできてしまうためです。  メニュー項目を無効にする方法の詳細については、「[方法 : デザイナーを使用して ToolStripMenuItems を無効にする](../../../../docs/framework/winforms/controls/how-to-disable-toolstripmenuitems-using-the-designer.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### トップレベル メニュー項目とそのサブメニュー項目を非表示にするには  
+  
+1.  トップレベル メニュー項目を選択し、その <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティまたは <xref:System.Windows.Forms.ToolStripItem.Available%2A> プロパティを `false` に設定します。  
+  
+     トップレベル メニュー項目を非表示にすると、そのメニュー内のメニュー項目もすべて非表示になります。  <xref:System.Windows.Forms.ToolStripItem.Visible%2A> を `false` に設定した後で、<xref:System.Windows.Forms.MenuStrip> 以外をクリックすると、トップレベル メニュー項目全体とそのサブメニュー項目がフォームに表示されなくなるため、実行時のアクションの結果がわかります。  デザイン時に非表示のトップレベル メニューを表示するには、**\[コンポーネント トレイ\]**、**\[ドキュメント アウトライン\]**、またはプロパティ グリッドの上部にある <xref:System.Windows.Forms.MenuStrip> をクリックします。  
+  
+> [!NOTE]
+>  マージする場合のマルチ ドキュメント インターフェイス \(MDI\) の子メニュー以外に、メニュー全体を非表示にすることはほとんどありません。  
+  
+### サブメニュー項目を非表示にするには  
+  
+1.  サブメニュー項目を選択し、その <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定します。  
+  
+     サブメニュー項目を非表示にしても、デザイン時にはフォームにはそのまま表示されるため、その後の作業で簡単に選択できます。  実行時には実際に非表示になります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripItem.Visible%2A>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.Enabled%2A>   
+ <xref:System.Windows.Forms.ToolStripItem.Available%2A>   
+ <xref:System.Windows.Forms.ToolStripMenuItem.Overflow%2A>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)   
+ [方法 : デザイナーを使用して ToolStripMenuItems を無効にする](../../../../docs/framework/winforms/controls/how-to-disable-toolstripmenuitems-using-the-designer.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md b/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md
new file mode 100644
index 00000000000..fd42500a874
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : ToolStripMenuItems を非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "非表示 (メニュー項目を)"
+  - "メニュー項目, 非表示"
+  - "メニュー, 非表示 (メニュー項目を)"
+  - "MenuStrip コントロール [Windows フォーム], 非表示 (メニュー項目を)"
+  - "ToolStripMenuItem, 非表示"
+ms.assetid: 418a768f-808a-44cd-8cef-f4e161883621
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ToolStripMenuItems を非表示にする
+メニュー項目を非表示にすると、アプリケーションのユーザー インターフェイスを制御したり、ユーザーが使用するコマンドを制限したりできます。  通常、メニュー項目がすべて使用不可能なメニューは、メニュー全体を非表示にする必要があります。  使用できないメニューを非表示にすることによって、ユーザーの混乱を避けることができます。  さらに、メニューまたはメニュー項目の非表示と無効化の両方が必要となることがあります。これは非表示にしただけでは、ショートカット キーを使用してメニュー コマンドにアクセスできてしまうためです。  
+  
+### プログラムによって、メニュー項目を非表示にするには  
+  
+-   メニュー項目のプロパティを設定するメソッド内で、コードを追加して <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定します。  
+  
+    ```vb  
+    MenuItem3.Visible = False  
+  
+    ```  
+  
+    ```csharp  
+    menuItem3.Visible = false;  
+  
+    ```  
+  
+    ```cpp  
+    menuItem3->Visible = false;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripItem.Visible%2A>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)   
+ [方法 : ToolStripMenuItems を無効にする](../../../../docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md b/docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md
new file mode 100644
index 00000000000..48884ab4eca
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-host-controls-in-windows-forms-datagridview-cells.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : Windows フォーム DataGridView Cells でコントロールをホストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, ホスト (コントロールを)"
+  - "コントロール [Windows フォーム], ホスト (セルに)"
+  - "DataGridView コントロール [Windows フォーム], ホスト (セルにコントロールを)"
+ms.assetid: e79a9d4e-64ec-41f5-93ec-f5492633cbb2
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォーム DataGridView Cells でコントロールをホストする
+<xref:System.Windows.Forms.DataGridView> コントロールには数種類の列があり、ユーザーはさまざまな方法で値を入力し、編集できます。  ただし、これらの種類の列がデータ入力の要件を満たさない場合は、独自の種類の列を作成して、任意のコントロールをホストするセルを用意できます。  これを作成するには、<xref:System.Windows.Forms.DataGridViewColumn> および <xref:System.Windows.Forms.DataGridViewCell> から派生する各クラスを定義する必要があります。  また、<xref:System.Windows.Forms.Control> から派生し、<xref:System.Windows.Forms.IDataGridViewEditingControl> インターフェイスを実装するクラスを定義する必要もあります。  
+  
+ 予定表の列を作成する方法を次のコード例に示します。  この列のセルは、通常のテキスト ボックスのセルに日付を表示しますが、ユーザーがセルを編集するときには <xref:System.Windows.Forms.DateTimePicker> コントロールが表示されます。  テキスト ボックスの表示機能を再度実装しなくてもすむように、`CalendarCell` クラスは、<xref:System.Windows.Forms.DataGridViewCell> クラスを直接継承するのではなく <xref:System.Windows.Forms.DataGridViewTextBoxCell> クラスから派生します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridViewCell> や <xref:System.Windows.Forms.DataGridViewColumn> から派生したクラスに新しいプロパティを追加するときは、`Clone` メソッドをオーバーライドし、複製操作時に新しいプロパティをコピーする必要があります。  また、基底クラスの `Clone` メソッドを呼び出して、基底クラスのプロパティを新しいセルまたは列にコピーする必要もあります。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewCalendarColumn#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCalendarColumn/CS/datagridviewcalendarcolumn.cs#000)]
+ [!code-vb[System.Windows.Forms.DataGridViewCalendarColumn#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewCalendarColumn/VB/datagridviewcalendarcolumn.vb#000)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ <xref:System.Windows.Forms.DataGridViewCell>   
+ <xref:System.Windows.Forms.DataGridViewTextBoxCell>   
+ <xref:System.Windows.Forms.IDataGridViewEditingControl>   
+ <xref:System.Windows.Forms.DateTimePicker>   
+ [Windows フォーム DataGridView コントロールのカスタマイズ](../../../../docs/framework/winforms/controls/customizing-the-windows-forms-datagridview-control.md)   
+ [DataGridView コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/datagridview-control-architecture-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-implement-a-custom-layout-engine.md b/docs/framework/winforms/controls/how-to-implement-a-custom-layout-engine.md
new file mode 100644
index 00000000000..e231224ddb7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-implement-a-custom-layout-engine.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : カスタム レイアウト エンジンを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "FlowLayoutPanel コントロール [Windows フォーム], レイアウト エンジン"
+  - "レイアウト エンジン, カスタム"
+  - "レイアウト エンジン, 実装"
+  - "LayoutEngine クラス"
+  - "TableLayoutPanel コントロール [Windows フォーム], レイアウト エンジン"
+ms.assetid: f91aa91c-29f4-4089-95ca-5d48b774b00e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : カスタム レイアウト エンジンを実装する
+単純なフロー レイアウトを実行するカスタム レイアウト エンジンを作成する方法を次のコード例に示します。  このコード例では、`DemoFlowPanel` という名前のパネル コントロールを実装します。このパネル コントロールは <xref:System.Windows.Forms.Control.LayoutEngine%2A> プロパティをオーバーライドして `DemoFlowLayout` クラスのインスタンスを提供します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.Layout.LayoutEngine#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.Layout.LayoutEngine/cpp/DemoFlowLayout.cpp#1)]
+ [!code-csharp[System.Windows.Forms.Layout.LayoutEngine#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Layout.LayoutEngine/CS/DemoFlowLayout.cs#1)]
+ [!code-vb[System.Windows.Forms.Layout.LayoutEngine#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Layout.LayoutEngine/VB/DemoFlowLayout.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.Layout.LayoutEngine>   
+ <xref:System.Windows.Forms.Control.LayoutEngine%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-implement-a-custom-toolstriprenderer.md b/docs/framework/winforms/controls/how-to-implement-a-custom-toolstriprenderer.md
new file mode 100644
index 00000000000..77ad27b1268
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-implement-a-custom-toolstriprenderer.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : カスタムの ToolStripRenderer を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripRenderer クラス"
+ms.assetid: c66fd3f7-2377-4553-8f1b-006527f08f32
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : カスタムの ToolStripRenderer を実装する
+<xref:System.Windows.Forms.ToolStripRenderer> から派生するクラスを実装することで、<xref:System.Windows.Forms.ToolStrip> コントロールの外観をカスタマイズできます  これによって、<xref:System.Windows.Forms.ToolStripProfessionalRenderer> クラスや <xref:System.Windows.Forms.ToolStripSystemRenderer> クラスで提供される外観とは異なる外観を柔軟に作成できます。  
+  
+## 使用例  
+ 次のコード例は、カスタムの <xref:System.Windows.Forms.ToolStripRenderer> クラスを実装する方法を示しています  この例では、`GridStrip` コントロールでタイルをスライドさせるパズルを実装します。これは、ユーザーがテーブル レイアウト内のタイルを移動して 1 つの画像を作成するパズルです。  カスタムの <xref:System.Windows.Forms.ToolStrip> コントロールで、グリッド レイアウトの <xref:System.Windows.Forms.ToolStripButton> コントロールを並べ替えます。  レイアウトには空のセルが 1 つ含まれており、ユーザーは、ドラッグ アンド ドロップ操作を使用することにより、隣接するタイルを空のセルにスライドできます。  ユーザーが移動できるタイルは強調表示されます。  
+  
+ `GridStripRenderer` クラスでは `GridStrip` コントロールの外観を 3 つの点でカスタマイズしています。  
+  
+-   `GridStrip` の境界線  
+  
+-   <xref:System.Windows.Forms.ToolStripButton> の境界線  
+  
+-   <xref:System.Windows.Forms.ToolStripButton> のイメージ  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.GridStrip#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.GridStrip/CS/GridStrip.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.GridStrip#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.GridStrip/VB/GridStrip.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Drawing アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripRenderer>   
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer>   
+ <xref:System.Windows.Forms.ToolStripSystemRenderer>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md b/docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md
new file mode 100644
index 00000000000..88cea4f37a6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : バックグラウンド操作を使用するフォームを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "バックグラウンド スレッド"
+  - "BackgroundWorker コンポーネント"
+  - "コンポーネント [Windows フォーム], 非同期"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+  - "スレッド処理 [Windows フォーム], フォーム"
+ms.assetid: 9f483f93-1613-4be1-a021-b4934e9c78f3
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : バックグラウンド操作を使用するフォームを実装する
+次のサンプル プログラムは、フィボナッチの数列を計算するフォームを作成します。  計算では、ユーザー インターフェイス スレッドとは別にあるスレッドで実行されるので、ユーザー インターフェイスは引き続き、計算の進行に伴う遅延なしに実行されます。  
+  
+ Visual Studio では、このタスクに対する広範なサポートが用意されています。  
+  
+ 「[チュートリアル : バックグラウンド操作を使用するフォームの実装](http://msdn.microsoft.com/library/b2zk6580\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ [!code-cpp[System.ComponentModel.BackgroundWorker#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#1)]
+ [!code-csharp[System.ComponentModel.BackgroundWorker#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#1)]
+ [!code-vb[System.ComponentModel.BackgroundWorker#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 信頼性の高いプログラミング  
+  
+> [!CAUTION]
+>  どのような種類のマルチスレッドを使用している場合でも、非常に深刻で複雑なバグを引き起こしてしまう可能性があります。  マルチスレッドを使用するソリューションを実装する前に、「[Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ <xref:System.ComponentModel.DoWorkEventArgs>   
+ [Event\-based Asynchronous Pattern Overview](../../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)   
+ [Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..34329a6c539
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 管理 (大容量のデータセットを)"
+  - "DataGridView コントロール [Windows フォーム], 大容量のデータセット"
+  - "DataGridView コントロール [Windows フォーム], 仮想モード"
+  - "仮想モード"
+ms.assetid: 98236267-f08e-4918-bcf9-77acf050a3ca
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する
+次のコード例は、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティを `true` に設定した <xref:System.Windows.Forms.DataGridView> コントロールを使用して、大規模なデータ セットを管理する方法を示します。  
+  
+ このコード例の詳細な説明については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#000](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#000)]
+ [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#000)]
+ [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#000)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>   
+ <xref:System.Windows.Forms.DataGridView.CellValueNeeded>   
+ <xref:System.Windows.Forms.DataGridView.CellValuePushed>   
+ <xref:System.Windows.Forms.DataGridView.NewRowNeeded>   
+ <xref:System.Windows.Forms.DataGridView.RowValidated>   
+ <xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded>   
+ <xref:System.Windows.Forms.DataGridView.CancelRowEdit>   
+ <xref:System.Windows.Forms.DataGridView.UserDeletingRow>   
+ [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md b/docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md
new file mode 100644
index 00000000000..6886a8c3490
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md
@@ -0,0 +1,100 @@
+---
+title: "方法 : 既存の Windows フォーム コントロールから継承する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 継承"
+  - "継承, Windows フォーム カスタム コントロール"
+ms.assetid: 1e1fc8ea-c615-4cf0-a356-16d6df7444ab
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : 既存の Windows フォーム コントロールから継承する
+既存のコントロールの機能を拡張する場合は、継承によって既存のコントロールから派生したコントロールを作成します。  既存のコントロールから継承すると、そのコントロールのすべての機能およびビジュアル プロパティが引き継がれます。  たとえば、<xref:System.Windows.Forms.Button> から継承したコントロールを作成すると、新しいコントロールは標準の <xref:System.Windows.Forms.Button> コントロールと同じ外観を持ち、同じように機能します。  その後で、カスタム メソッドやカスタム プロパティの実装によって、新しいコントロールの機能を拡張または変更できます。  いくつかのコントロールでは、継承したコントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドして、外観を変更することもできます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 継承したコントロールを作成するには  
+  
+1.  新しい **Windows フォーム アプリケーション** プロジェクトを作成します。  
+  
+2.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  
+  
+     **\[新しい項目の追加\]** ダイアログ ボックスが表示されます。  
+  
+3.  **\[新しい項目の追加\]** ダイアログ ボックスの **\[カスタム コントロール\]** をダブルクリックします。  
+  
+     新しいカスタム コントロールがプロジェクトに追加されます。  
+  
+4.  Visual Basic を使用している場合は、**ソリューション エクスプローラー**の上部にある **\[すべてのファイルを表示\]** をクリックします。  CustomControl1.vb を展開し、コード エディターで CustomControl1.Designer.vb を開きます。  
+  
+5.  C\# を使用している場合は、コード エディターで CustomControl1.cs を開きます。  
+  
+6.  <xref:System.Windows.Forms.Control> から継承したクラス宣言を見つけます。  
+  
+7.  基本クラスを継承元のコントロールに変更します。  
+  
+     たとえば、<xref:System.Windows.Forms.Button> から継承する場合は、クラス宣言を次のように変更します。  
+  
+    ```vb  
+    Partial Class CustomControl1  
+        Inherits System.Windows.Forms.Button  
+    ```  
+  
+    ```csharp  
+    public partial class CustomControl1 : System.Windows.Forms.Button  
+    ```  
+  
+8.  Visual Basic を使用している場合は、CustomControl1.Designer.vb を保存して閉じます。  コード エディターで CustomControl1.vb を開きます。  
+  
+9. コントロールに含めるカスタム メソッドやカスタム プロパティを実装します。  
+  
+10. コントロールの外観を変更する場合は、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドします。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control.OnPaint%2A> をオーバーライドしても、すべてのコントロールの外観を変更できるわけではありません。  描画がすべて Windows によって行われるコントロール \(<xref:System.Windows.Forms.TextBox> など\) は、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを呼び出さないため、カスタム コードを使用しません。  <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを使用できるかどうかを確認するには、変更するコントロールのヘルプ ドキュメントを参照してください。  Windows フォーム コントロールの一覧については、「[Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)」を参照してください。  コントロールにメンバー メソッドとして <xref:System.Windows.Forms.Control.OnPaint%2A> がない場合、このメソッドをオーバーライドして外観を変更することはできません。  カスタム描画の詳細については、「[コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)」を参照してください。  
+  
+    ```vb  
+    Protected Overrides Sub OnPaint(ByVal e As _  
+       System.Windows.Forms.PaintEventArgs)  
+       MyBase.OnPaint(e)  
+       ' Insert code to do custom painting.   
+       ' If you want to completely change the appearance of your control,  
+       ' do not call MyBase.OnPaint(e).  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected override void OnPaint(PaintEventArgs pe)  
+    {  
+       base.OnPaint(pe);  
+       // Insert code to do custom painting.  
+       // If you want to completely change the appearance of your control,  
+       // do not call base.OnPaint(pe).  
+    }  
+    ```  
+  
+11. 保存してコントロールの動作確認を行います。  
+  
+## 参照  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)   
+ [方法 : コントロール クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md)   
+ [方法 : UserControl クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md)   
+ [方法 : Windows フォームのコントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md)   
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)   
+ [チュートリアル : Visual Basic による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md)   
+ [チュートリアル : Visual C\# による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md b/docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md
new file mode 100644
index 00000000000..52f9ffbaed8
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : コントロール クラスを継承する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Control クラス, 継承"
+  - "カスタム コントロール [Windows フォーム], 作成"
+  - "カスタム コントロール [Windows フォーム], 継承"
+  - "継承, Windows フォーム カスタム コントロール"
+  - "OnPaint メソッド [Windows フォーム]"
+ms.assetid: 46ba0df3-5cf7-443c-a3b4-a72660172476
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : コントロール クラスを継承する
+Windows フォームで使用する、完全なカスタム コントロールを作成する場合は、<xref:System.Windows.Forms.Control> クラスから継承する必要があります。  <xref:System.Windows.Forms.Control> クラスから継承する場合、多くの計画と実装が必要となりますが、非常に多様なオプションも用意されています。  <xref:System.Windows.Forms.Control> から継承すると、コントロールを動作させるためのごく基本的な機能だけが継承されます。  <xref:System.Windows.Forms.Control> クラス本来の機能は、キーボードやマウスによるユーザー入力の処理、コントロールの境界線およびサイズの定義、ウィンドウ ハンドルの提供、およびメッセージ処理とセキュリティの提供です。  描画機能、つまりこの場合はコントロールのグラフィカル インターフェイスを実際に表示する機能や、ユーザーとやり取りするための具体的な機能は含まれていません。  このような機能は、カスタム コードを記述して提供する必要があります。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### カスタム コントロールを作成するには  
+  
+1.  新しい **Windows アプリケーション** プロジェクトまたは **Windows コントロール ライブラリ** プロジェクトを作成します。  
+  
+2.  **\[プロジェクト\]** メニューの **\[クラスの追加\]** をクリックします。  
+  
+3.  **\[新しい項目の追加\]** ダイアログ ボックスにある **\[カスタム コントロール\]** をクリックします。  
+  
+     新しいカスタム コントロールがプロジェクトに追加されます。  
+  
+4.  F7 キーを押してカスタム コントロールの**コード エディター**を開きます。  
+  
+5.  <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを見つけます。このメソッドは、基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドの呼び出しを除いて、空白になっています。  
+  
+6.  コントロールで使用するカスタム描画を含むように、コードを修正します。  
+  
+     コントロールのグラフィックスを描画するコードの作成については、「[コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)」を参照してください。  
+  
+7.  コントロールに含めるカスタム メソッド、カスタム プロパティ、カスタム イベントを実装します。  
+  
+8.  保存してコントロールの動作確認を行います。  
+  
+## 参照  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)   
+ [方法 : UserControl クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md)   
+ [方法 : 既存の Windows フォーム コントロールから継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md)   
+ [方法 : Windows フォームのコントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md)   
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)   
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md b/docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md
new file mode 100644
index 00000000000..9f61b52bdc9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : UserControl クラスを継承する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール, 作成"
+  - "継承, Windows フォーム カスタム コントロール"
+  - "ユーザー コントロール [Windows フォーム], 作成"
+  - "UserControl クラス, 継承"
+ms.assetid: 67713625-e2e4-4f6a-bce7-0855ee5043d9
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : UserControl クラスを継承する
+1 つ以上の Windows フォーム コントロールの機能をカスタム コードと組み合わせるには、*ユーザー コントロール*を作成します。  ユーザー コントロールは、迅速なコントロール開発、標準の Windows フォーム コントロールの機能、およびカスタム プロパティやカスタム メソッドの柔軟性を兼ね備えています。  ユーザー コントロールの作成を開始すると、デザイナーが表示され、標準の Windows フォーム コントロールを配置できます。  これらのコントロールは、標準コントロールの外観と動作に加えて、継承した機能のすべてを保持します。  ただし、これらのコントロールをユーザー コントロールに組み込んだ場合、コードを介して使用することはできなくなります。  ユーザー コントロールは独自の描画を行い、標準コントロールに関連付けられた基本的な機能もすべて処理します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ユーザー コントロールを作成するには  
+  
+1.  新しい **Windows コントロール ライブラリ** プロジェクトを作成します。  
+  
+     空白のユーザー コントロールを持つ新しいプロジェクトが作成されます。  
+  
+2.  **ツールボックス**の **\[Windows フォーム\]** タブから、コントロールをデザイナーにドラッグします。  
+  
+3.  これらのコントロールは、最終的なユーザー コントロールに表示するときと同じように、配置およびデザインする必要があります。  開発者が内在コントロールにアクセスできるようにする場合は、内在コントロールをパブリックとして宣言するか、内在コントロールの選択したプロパティを公開します。  詳細については、「[方法 : 内在コントロールのプロパティを公開する](../../../../docs/framework/winforms/controls/how-to-expose-properties-of-constituent-controls.md)」を参照してください。  
+  
+4.  コントロールに含めるカスタム メソッドやカスタム プロパティを実装します。  
+  
+5.  F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+## 参照  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)   
+ [方法 : コントロール クラスを継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-the-control-class.md)   
+ [方法 : 既存の Windows フォーム コントロールから継承する](../../../../docs/framework/winforms/controls/how-to-inherit-from-existing-windows-forms-controls.md)   
+ [方法 : Windows フォームのコントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-controls-for-windows-forms.md)   
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)   
+ [方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md b/docs/framework/winforms/controls/how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md
new file mode 100644
index 00000000000..c00ea7d6ecb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md
@@ -0,0 +1,111 @@
+---
+title: "方法 : MDI ドロップダウン メニューに MenuStrip を挿入する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, マージ (メニュー項目を)"
+  - "MenuStrip コントロール [Windows フォーム], 挿入"
+  - "MenuStrip コントロール [Windows フォーム], マージ"
+ms.assetid: 0fad444e-26d9-49af-8860-044d9c10d608
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : MDI ドロップダウン メニューに MenuStrip を挿入する (Windows フォーム)
+アプリケーションの中には、マルチ ドキュメント インターフェイス \(MDI\) 子ウィンドウの種類が MDI 親ウィンドウと異なるものもあります。  たとえば、MDI 親がスプレッドシートで、MDI 子がグラフの場合があります。  そのような場合は、異なる種類の MDI 子ウィンドウがアクティブになったときに、MDI 子メニューの内容で MDI 親メニューの内容を更新する必要があります。  
+  
+ 次のプロシージャでは、<xref:System.Windows.Forms.Form.IsMdiContainer%2A>、<xref:System.Windows.Forms.ToolStrip.AllowMerge%2A>、<xref:System.Windows.Forms.MergeAction>、および <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> の各プロパティを使用して、MDI 子メニューのメニュー項目のグループを MDI 親メニューのドロップダウン部分に挿入します。  MDI 子ウィンドウを閉じると、挿入したメニュー項目が MDI 親ウィンドウから削除されます。  
+  
+### MenuStrip を MDI ドロップダウン メニューに挿入するには  
+  
+1.  フォームを作成し、その <xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定します。  
+  
+2.  <xref:System.Windows.Forms.MenuStrip> を `Form1` に追加し、<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> プロパティを `true` に設定します。  
+  
+3.  トップレベル メニュー項目を `Form1` <xref:System.Windows.Forms.MenuStrip> に追加し、その <xref:System.Windows.Forms.Control.Text%2A> プロパティを `&File` に設定します。  
+  
+4.  3 つのサブメニュー項目を `&File` メニュー項目に追加し、それらの <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティをそれぞれ `&Open`、`&Import from`、および `E&xit` に設定します。  
+  
+5.  2 つのサブメニュー項目を `&Import from` サブメニュー項目に追加し、それらの <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティをそれぞれ `&Word` と `&Excel` に設定します。  
+  
+6.  フォームをプロジェクトに追加し、<xref:System.Windows.Forms.MenuStrip> をフォームに追加して、`Form2` <xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> プロパティを `true` に設定します。  
+  
+7.  トップレベル メニュー項目を `Form2` <xref:System.Windows.Forms.MenuStrip> に追加し、その <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティを `&File` に設定します。  
+  
+8.  `Form2` の `&File` メニューにサブメニュー項目を追加します。追加する順番は、<xref:System.Windows.Forms.ToolStripSeparator>、`&Save`、`&Close` `and Save`、およびもう 1 つの <xref:System.Windows.Forms.ToolStripSeparator> となります。  
+  
+9. 次の表に示すように、`Form2` メニュー項目の <xref:System.Windows.Forms.MergeAction> プロパティと <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> プロパティを設定します。  
+  
+    |Form2 メニュー項目|MergeAction 値|MergeIndex 値|  
+    |------------------|-------------------|------------------|  
+    |File|MatchOnly|\-1|  
+    |\[Separator\]|\[挿入\]|2|  
+    |保存|\[挿入\]|3|  
+    |\[保存して閉じる\]|\[挿入\]|4|  
+    |\[Separator\]|\[挿入\]|5|  
+  
+10. `&Open` <xref:System.Windows.Forms.ToolStripMenuItem> の <xref:System.Windows.Forms.Control.Click> イベントのイベント ハンドラーを作成します。  
+  
+11. このイベント ハンドラー内に次のようなコード例を挿入し、`Form1` の MDI 子フォームとして `Form2` の新しいインスタンスを作成および表示します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(ByVal sender As System.Object, _  
+    ByVal e As System.EventArgs) Handles openToolStripMenuItem.Click  
+        Dim NewMDIChild As New Form2()  
+        'Set the parent form of the child window.  
+            NewMDIChild.MdiParent = Me  
+        'Display the new form.  
+            NewMDIChild.Show()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void openToolStripMenuItem_Click(object sender, EventArgs e)  
+    {  
+        Form2 newMDIChild = new Form2();  
+        // Set the parent form of the child window.  
+            newMDIChild.MdiParent = this;  
+        // Display the new form.  
+            newMDIChild.Show();  
+    }  
+  
+    ```  
+  
+12. 次のようなコードを `&Open` <xref:System.Windows.Forms.ToolStripMenuItem> に配置し、イベント ハンドラーを登録します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(sender As Object, e As _  
+    EventArgs) Handles openToolStripMenuItem.Click  
+  
+    ```  
+  
+    ```csharp  
+    this.openToolStripMenuItem.Click += new System.EventHandler(this.openToolStripMenuItem_Click);  
+  
+    ```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `Form1` と `Form2` という名前の 2 つの <xref:System.Windows.Forms.Form> コントロール。  
+  
+-   `menuStrip1` という名前の `Form1` の <xref:System.Windows.Forms.MenuStrip> コントロール、および `menuStrip2` という名前の `Form2` の <xref:System.Windows.Forms.MenuStrip> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md b/docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md
new file mode 100644
index 00000000000..4fa3527c090
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md
@@ -0,0 +1,135 @@
+---
+title: "方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "ツリー ノード (TreeView コントロールの), 反復処理"
+  - "TreeView コントロール [Windows フォーム], 反復処理 (ノードの)"
+ms.assetid: 427f8928-ebcf-4beb-887f-695b905d5134
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する
+ノードの値について何か処理を行うために、Windows フォーム <xref:System.Windows.Forms.TreeView> コントロールのすべてのノードをチェックすると役立つことがあります。  この操作は、ツリーの各コレクションの各ノードを反復処理する再帰プロシージャ \(C\# および C\+\+ における再帰メソッド\) を使用して実行できます。  
+  
+ ツリー ビューの各 <xref:System.Windows.Forms.TreeNode> オブジェクトには、ツリー ビューを移動するための <xref:System.Windows.Forms.TreeNode.FirstNode%2A> プロパティ、<xref:System.Windows.Forms.TreeNode.LastNode%2A> プロパティ、<xref:System.Windows.Forms.TreeNode.NextNode%2A> プロパティ、<xref:System.Windows.Forms.TreeNode.PrevNode%2A> プロパティ、および <xref:System.Windows.Forms.TreeNode.Parent%2A> プロパティがあります。  <xref:System.Windows.Forms.TreeNode.Parent%2A> プロパティの値には、現在のノードの親ノードが設定されます。  現在のノードに子ノードがある場合は、子ノードの一覧が <xref:System.Windows.Forms.TreeNode.Nodes%2A> プロパティに表示されます。  <xref:System.Windows.Forms.TreeView> コントロール自体には、ツリー ビュー全体のルート ノードを示す <xref:System.Windows.Forms.TreeView.TopNode%2A> プロパティがあります。  
+  
+### TreeView コントロールのすべてのノードを反復処理するには  
+  
+1.  各ノードをテストする再帰プロシージャ \(C\# および C\+\+ における再帰メソッド\) を作成します。  
+  
+2.  プロシージャを呼び出します。  
+  
+     各 <xref:System.Windows.Forms.TreeNode> オブジェクトの <xref:System.Windows.Forms.TreeNode.Text%2A> プロパティを出力する例を次に示します。  
+  
+    ```vb  
+    Private Sub PrintRecursive(ByVal n As TreeNode)  
+       System.Diagnostics.Debug.WriteLine(n.Text)  
+       MessageBox.Show(n.Text)  
+       Dim aNode As TreeNode  
+       For Each aNode In n.Nodes  
+          PrintRecursive(aNode)  
+       Next  
+    End Sub  
+  
+    ' Call the procedure using the top nodes of the treeview.  
+    Private Sub CallRecursive(ByVal aTreeView As TreeView)  
+       Dim n As TreeNode  
+       For Each n In aTreeView.Nodes  
+          PrintRecursive(n)  
+       Next  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void PrintRecursive(TreeNode treeNode)  
+    {  
+       // Print the node.  
+       System.Diagnostics.Debug.WriteLine(treeNode.Text);  
+       MessageBox.Show(treeNode.Text);  
+       // Print each node recursively.  
+       foreach (TreeNode tn in treeNode.Nodes)  
+       {  
+          PrintRecursive(tn);  
+       }  
+    }  
+  
+    // Call the procedure using the TreeView.  
+    private void CallRecursive(TreeView treeView)  
+    {  
+       // Print each node recursively.  
+       TreeNodeCollection nodes = treeView.Nodes;  
+       foreach (TreeNode n in nodes)  
+       {  
+          PrintRecursive(n);  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void PrintRecursive( TreeNode^ treeNode )  
+       {  
+          // Print the node.  
+          System::Diagnostics::Debug::WriteLine( treeNode->Text );  
+          MessageBox::Show( treeNode->Text );  
+  
+          // Print each node recursively.  
+          System::Collections::IEnumerator^ myNodes = (safe_cast<System::Collections::IEnumerable^>(treeNode->Nodes))->GetEnumerator();  
+          try  
+          {  
+             while ( myNodes->MoveNext() )  
+             {  
+                TreeNode^ tn = safe_cast<TreeNode^>(myNodes->Current);  
+                PrintRecursive( tn );  
+             }  
+          }  
+          finally  
+          {  
+             IDisposable^ disposable = dynamic_cast<System::IDisposable^>(myNodes);  
+             if ( disposable != nullptr )  
+                      disposable->Dispose();  
+          }  
+       }  
+  
+       // Call the procedure using the TreeView.  
+       void CallRecursive( TreeView^ treeView )  
+       {  
+          // Print each node recursively.  
+          TreeNodeCollection^ nodes = treeView->Nodes;  
+          System::Collections::IEnumerator^ myNodes = (safe_cast<System::Collections::IEnumerable^>(nodes))->GetEnumerator();  
+          try  
+          {  
+             while ( myNodes->MoveNext() )  
+             {  
+                TreeNode^ n = safe_cast<TreeNode^>(myNodes->Current);  
+                PrintRecursive( n );  
+             }  
+          }  
+          finally  
+          {  
+             IDisposable^ disposable = dynamic_cast<System::IDisposable^>(myNodes);  
+             if ( disposable != nullptr )  
+                      disposable->Dispose();  
+          }  
+       }  
+    ```  
+  
+## 参照  
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [Recursive Procedures](../Topic/Recursive%20Procedures%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-join-toolstrippanels.md b/docs/framework/winforms/controls/how-to-join-toolstrippanels.md
new file mode 100644
index 00000000000..4912f3b37d9
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-join-toolstrippanels.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ToolStripPanel を結合する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], 結合"
+  - "ToolStripPanel コントロール [Windows フォーム], 結合"
+ms.assetid: 4eadda6d-e3b8-4151-aaf2-a8d564fbe6b3
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ToolStripPanel を結合する
+実行時に <xref:System.Windows.Forms.ToolStrip> コントロールを <xref:System.Windows.Forms.ToolStripPanel> に結合でき、これによりマルチ ドキュメント インターフェイス \(MDI\) アプリケーションの柔軟性を提供します。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStrip> コントロールを <xref:System.Windows.Forms.ToolStripPanel> に結合する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#11)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#11)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripPanel>   
+ [方法 : ToolStripPanel を MDI で使用する](../../../../docs/framework/winforms/controls/how-to-use-toolstrippanels-for-mdi.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md b/docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md
new file mode 100644
index 00000000000..2cdc07af596
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : Windows フォーム上のオブジェクトをレイヤー化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], レイヤー化"
+  - "コントロール [Windows フォーム], 配置"
+  - "Windows フォーム コントロール, レイヤー化"
+  - "z オーダー"
+  - "z オーダー"
+ms.assetid: 1acc4281-2976-4715-86f4-bda68134baaf
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム上のオブジェクトをレイヤー化する
+複雑なユーザー インターフェイスを作成したり、マルチ ドキュメント インターフェイス \(MDI\) フォームを使用したりする場合は、コントロールと子フォームをレイヤー化する必要が生じることがよくあります。  グループのコンテキストで、コントロールとウィンドウを移動および制御するには、コントロールの z オーダーを操作します。  *Z オーダー*は、コントロールの視覚的な階層構造であり、フォームの z 軸 \(奥行\) に沿ってフォームに描かれます。  z オーダーのウィンドウは、ほかのすべてのウィンドウの上に重ねて、一番上に表示されます。  ほかのすべてのウィンドウは、z オーダーのウィンドウの下に重ねて表示されます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にコントロールをレイヤー化するには  
+  
+1.  レイヤー化するコントロールを選択します。  
+  
+2.  **\[書式\]** メニューの **\[順序\]** をポイントし、**\[最前面へ移動\]** または **\[最背面へ移動\]** をクリックします。  
+  
+### プログラムによってコントロールをレイヤー化するには  
+  
+-   <xref:System.Windows.Forms.Control.BringToFront%2A> メソッドおよび <xref:System.Windows.Forms.Control.SendToBack%2A> メソッドを使用して、コントロールの z オーダーを操作します。  
+  
+     たとえば、<xref:System.Windows.Forms.TextBox> コントロール `txtFirstName` が別のコントロールの下に表示されている場合は、次のコードを使用して、一番上に表示します。  
+  
+    ```vb  
+    txtFirstName.BringToFront()  
+  
+    ```  
+  
+    ```csharp  
+    txtFirstName.BringToFront();  
+  
+    ```  
+  
+    ```cpp  
+    txtFirstName->BringToFront();  
+    ```  
+  
+> [!NOTE]
+>  Windows フォームでは、*コントロール コンテインメント*をサポートしています。  コントロール コンテインメントとは、コンテナーであるコントロールに、さまざまなコントロールが配置されている状態です。たとえば、<xref:System.Windows.Forms.GroupBox> コントロールには、さまざまな <xref:System.Windows.Forms.RadioButton> コントロールが含まれています。  このとき、コンテナーであるコントロールでコントロールをレイヤー化できます。  グループ ボックスを移動すると、中に含まれているコントロールも移動されます。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md b/docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md
new file mode 100644
index 00000000000..2c1ce325895
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : デザイナーを使用してピクチャを読み込む (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォーム, 表示 (イメージを)"
+  - "イメージ [Windows フォーム], 表示 (Windows フォームに)"
+  - "ピクチャ形式"
+  - "PictureBox コントロール [Windows フォーム], 追加 (ピクチャを)"
+  - "ピクチャ, 表示"
+ms.assetid: 4dc7b973-afb1-4276-8322-20825af96655
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : デザイナーを使用してピクチャを読み込む (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.PictureBox> コントロールを使用すると、<xref:System.Windows.Forms.PictureBox.Image%2A> プロパティに有効なピクチャを設定することによって、デザイン時にピクチャをフォームに読み込み、表示できます。  受け入れ可能なファイルの種類を次に示します。  
+  
+|種類|ファイル名の拡張子|  
+|--------|---------------|  
+|ビットマップ|.bmp|  
+|Icon|.ico|  
+|GIF|.gif|  
+|メタファイル|.wmf|  
+|JPEG|.jpg|  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイン時にピクチャを表示するには  
+  
+1.  フォームに <xref:System.Windows.Forms.PictureBox> コントロールを配置します。  
+  
+2.  \[プロパティ\] ウィンドウで <xref:System.Windows.Forms.PictureBox.Image%2A> プロパティをクリックします。次に、\[...\] ボタンをクリックして、**\[ファイルを開く\]** ダイアログ ボックスを表示します。  
+  
+3.  .gif ファイルなど、特定のファイルの種類を検索する場合は、**\[ファイルの種類\]** ボックスでファイルの種類を選択します。  
+  
+4.  表示するファイルを選択します。  
+  
+### デザイン時にピクチャを消去するには  
+  
+1.  **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.PictureBox.Image%2A> プロパティを選択し、イメージ オブジェクトの名前の左側に表示されている小さなサムネイル イメージを右クリックします。  **\[リセット\]** を選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PictureBox>   
+ [PictureBox コントロールの概要](../../../../docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md)   
+ [方法 : 実行時にピクチャのサイズまたは配置を変更する](../../../../docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)   
+ [方法 : 実行時にピクチャを設定する](../../../../docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md)   
+ [PictureBox コントロール](../../../../docs/framework/winforms/controls/picturebox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-load-a-sound-asynchronously-within-a-windows-form.md b/docs/framework/winforms/controls/how-to-load-a-sound-asynchronously-within-a-windows-form.md
new file mode 100644
index 00000000000..01f5677af14
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-load-a-sound-asynchronously-within-a-windows-form.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : Windows フォーム内でサウンドを非同期的に読み込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サウンドを非同期的にロード SoundPlayer クラス"
+  - "サウンド、読み込み (個別のスレッドで)"
+  - "スレッド処理 [Windows フォーム]、サウンドします。"
+ms.assetid: 3b6a9296-1d5e-4d52-a4ba-94366d6fe302
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム内でサウンドを非同期的に読み込む
+次のコード例では、URL からサウンドを非同期的に読み込み、新しいスレッド上で再生します。  
+  
+## <a name="example"></a>例  
+ [!code-csharp[System.Media.SoundPlayer.LoadAsync#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Media.SoundPlayer.LoadAsync/CS/Form1.cs#1)]
+ [!code-vb[System.Media.SoundPlayer.LoadAsync#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Media.SoundPlayer.LoadAsync/VB/Form1.vb#1)]  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+-   ファイル名 `"http://www.tailspintoys.com/sounds/stop.wav"` を有効なファイル名に置き換えます。  
+  
+ この例のコマンドラインからのビルドについては[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)]または[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]を参照してください[コマンドラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)または[使用 csc.exe](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)します。 また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  参照してください[方法: コンパイルして、完全な Windows フォーム コードの例を使用して Visual Studio を実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))です。  
+  
+## <a name="robust-programming"></a>信頼性の高いプログラミング  
+ ファイルの操作は、適切な例外処理ブロックで囲む必要があります。  
+  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   パス名が不適切である場合。 たとえば、無効な文字が含まれていますか、空白だけが (<xref:System.ArgumentException>クラス)。  
+  
+-   パスは読み取り専用 (<xref:System.IO.IOException>クラス)。  
+  
+-   パス名が`Nothing`(<xref:System.ArgumentNullException>クラス)。  
+  
+-   パス名が長すぎます (<xref:System.IO.PathTooLongException>クラス)。  
+  
+-   パスが有効ではありません (<xref:System.IO.DirectoryNotFoundException>クラス)。  
+  
+-   パスがコロンのみ":"(<xref:System.NotSupportedException>クラス)。  
+  
+## <a name="net-framework-security"></a>.NET Framework セキュリティ  
+ ファイル名からファイルの内容を判断しないでください。 たとえば、`Form1.vb` というファイルは Visual Basic のソース ファイルではない可能性もあります。 アプリケーションでデータを使用する前に、入力をすべて検証してください。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Media.SoundPlayer.LoadAsync%2A>   
+ <xref:System.Media.SoundPlayer.LoadCompleted>   
+ <xref:System.Media.SoundPlayer.Play%2A>   
+ [方法: Windows フォームからサウンドを再生](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-load-files-into-the-windows-forms-richtextbox-control.md b/docs/framework/winforms/controls/how-to-load-files-into-the-windows-forms-richtextbox-control.md
new file mode 100644
index 00000000000..96daf241565
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-load-files-into-the-windows-forms-richtextbox-control.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールにファイルを読み込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト ボックス、ファイルの表示"
+  - "例 [Windows フォーム]、テキスト ボックス"
+  - ".rtf ファイル、RichTextBox コントロールで開く"
+  - "RTF ファイル、RichTextBox コントロールで開く"
+  - "テキスト ファイル、RichTextBox コントロールで表示"
+  - ".rtf ファイル、RichTextBox コントロールで表示"
+  - "RichTextBox コントロール [Windows フォーム], ファイルを開く"
+  - "RTF ファイル、RichTextBox コントロールで表示"
+ms.assetid: c03451be-f285-4428-a71a-c41e002cc919
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの RichTextBox コントロールにファイルを読み込む
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールには、プレーン テキスト、Unicode のプレーン テキスト、リッチ テキスト形式 \(RTF\) ファイルを表示できます。 それには、<xref:System.Windows.Forms.RichTextBox.LoadFile%2A> メソッドを呼び出します。 また、<xref:System.Windows.Forms.RichTextBox.LoadFile%2A> メソッドを使用してストリームからデータを読み込むこともできます。 詳細については、「<xref:System.Windows.Forms.RichTextBox.LoadFile%28System.IO.Stream%2CSystem.Windows.Forms.RichTextBoxStreamType%29>」を参照してください。  
+  
+### RichTextBox コントロールにファイルを読み込むには  
+  
+1.  <xref:System.Windows.Forms.OpenFileDialog> コンポーネントを使用して、開くファイルのパスを決定します。 概要については、「[OpenFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md)」を参照してください。  
+  
+2.  読み込むファイルと、必要に応じてファイルの種類を指定して、<xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.RichTextBox.LoadFile%2A> メソッドを呼び出します。 次の例では、読み込むファイルは <xref:System.Windows.Forms.OpenFileDialog> コンポーネントの <xref:System.Windows.Forms.FileDialog.FileName%2A> プロパティから取得されます。 引数にファイル名だけを指定してメソッドを呼び出すと、ファイルの種類は RTF と見なされます。 別の種類のファイルを指定するには、2 番目の引数として <xref:System.Windows.Forms.RichTextBoxStreamType> 列挙型の値を指定します。  
+  
+     次の例では、ボタンがクリックされたときに <xref:System.Windows.Forms.OpenFileDialog> コンポーネントが表示されます。 次に、選択されたファイルが開き、<xref:System.Windows.Forms.RichTextBox> コントロールに表示されます。 この例ではフォームにボタン `btnOpenFile` があることを前提としています。  
+  
+    ```vb  
+    Private Sub btnOpenFile_Click(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles btnOpenFile.Click  
+         If OpenFileDialog1.ShowDialog() = DialogResult.OK Then  
+           RichTextBox1.LoadFile(OpenFileDialog1.FileName, _  
+              RichTextBoxStreamType.RichText)  
+          End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void btnOpenFile_Click(object sender, System.EventArgs e)  
+    {  
+       if(openFileDialog1.ShowDialog() == DialogResult.OK)  
+       {  
+         richTextBox1.LoadFile(openFileDialog1.FileName, RichTextBoxStreamType.RichText);  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void btnOpenFile_Click(System::Object ^  sender,  
+          System::EventArgs ^  e)  
+       {  
+          if(openFileDialog1->ShowDialog() == DialogResult::OK)  
+          {  
+             richTextBox1->LoadFile(openFileDialog1->FileName,  
+                RichTextBoxStreamType::RichText);  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.btnOpenFile.Click += new System.EventHandler(this. btnOpenFile_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->btnOpenFile->Click += gcnew   
+       System::EventHandler(this, &Form1::btnOpenFile_Click);  
+    ```  
+  
+    > [!IMPORTANT]
+    >  このプロセスを実行するには、アセンブリに対して <xref:System.Security.Permissions.FileIOPermission?displayProperty=fullName> クラスで特権レベルが許可されていることが必要な場合があります。 部分的に信頼されたコンテキストで実行している場合、プロセスは、特権がないため例外をスローする可能性があります。 詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox.LoadFile%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-lock-controls-to-windows-forms.md b/docs/framework/winforms/controls/how-to-lock-controls-to-windows-forms.md
new file mode 100644
index 00000000000..44f395af6bc
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-lock-controls-to-windows-forms.md
@@ -0,0 +1,63 @@
+---
+title: "方法 : Windows フォームにコントロールをロックする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], locking"
+  - "Windows フォーム コントロール, locking"
+ms.assetid: 94efe0d2-c14e-4d14-b903-63ea9b07e290
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームにコントロールをロックする
+Windows アプリケーションのユーザー インターフェイス \(UI\) をデザインする場合、コントロールを正しく配置した後、他のプロパティを設定するときに誤って移動やサイズ変更をしないようにコントロールをロックできます。  
+  
+ また、フォームのすべてのコントロールを一度にロック、またはロック解除することもできます。フォームに数多くのコントロールがある場合は、一度にロックすると便利です。コントロールのロックを個々に解除することもできます。  フォームの任意の位置にコントロールを配置した後、誤って移動しないようにすべてのコントロールを適切な位置にロックします。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールをロックするには  
+  
+1.  **\[プロパティ\]** ウィンドウの **\[更新しない\]** プロパティをクリックし、`true` を選択します。  名前をダブルクリックすると、プロパティの設定値が切り替わります。  
+  
+     または、コントロールを右クリックし、**\[コントロールのロック\]** をクリックします。  
+  
+    > [!NOTE]
+    >  コントロールをロックすると、デザイン サーフェイス上でコントロールをドラッグしてサイズや位置を変更できなくなります。  ただし、**\[プロパティ\]** ウィンドウで設定したりコードを書き換えたりすることで、コントロールのサイズや位置を変更できます。  
+  
+### フォームのすべてのコントロールをロックするには  
+  
+1.  **\[書式\]** メニューの **\[コントロールのロック\]** をクリックします。  
+  
+    > [!NOTE]
+    >  フォームはコントロールであるため、\[コントロールのロック\] によってフォームのサイズもロックされます。  
+  
+### フォームのすべてのコントロールのロックを解除するには  
+  
+1.  **\[書式\]** メニューの **\[コントロールのロック\]** をクリックします。  
+  
+     フォーム上でロックされているコントロールはすべてロックが解除されます。  
+  
+### コントロールのロックを個別に解除するには  
+  
+1.  **\[プロパティ\]** ウィンドウの **\[更新しない\]** プロパティをクリックし、`false` を選択します。  名前をダブルクリックすると、プロパティの設定値が切り替わります。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-loop-a-sound-playing-on-a-windows-form.md b/docs/framework/winforms/controls/how-to-loop-a-sound-playing-on-a-windows-form.md
new file mode 100644
index 00000000000..1f3a029e3f7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-loop-a-sound-playing-on-a-windows-form.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : Windows フォームでサウンドの再生をループする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "再生 (サウンドを), ループ"
+  - "サウンド ループ"
+  - "SoundPlayer クラス, 再生ループ"
+  - "サウンド, ループ"
+ms.assetid: ea95dd46-10a3-46c0-8263-4b205f00df7f
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォームでサウンドの再生をループする
+サウンドを繰り返し再生するコード例を次に示します。  `stopPlayingButton_Click` イベント ハンドラー内のコードが実行されると、現在再生されているサウンドが停止します。  サウンドが再生されていない場合は、何も起こりません。  
+  
+## 使用例  
+ [!code-csharp[System.Media.SoundPlayer.PlayLooping#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Media.SoundPlayer.PlayLooping/CS/Form1.cs#1)]
+ [!code-vb[System.Media.SoundPlayer.PlayLooping#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Media.SoundPlayer.PlayLooping/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照  
+  
+-   ファイル名 `"c:\Windows\Media\chimes.wav"` を有効なファイル名に置き換えます。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 信頼性の高いプログラミング  
+ ファイルの操作は、適切な例外処理ブロックで囲む必要があります。  
+  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   パス名が不適切である場合。  たとえば、無効な文字が含まれている場合や、空白だけの場合などです \(<xref:System.ArgumentException> クラス\)。  
+  
+-   パスが読み取り専用である場合 \(<xref:System.IO.IOException> クラス\)。  
+  
+-   パス名が `Nothing` である場合 \(<xref:System.ArgumentNullException> クラス\)。  
+  
+-   パス名が長すぎる場合 \(<xref:System.IO.PathTooLongException> クラス\)。  
+  
+-   パスが無効である場合 \(<xref:System.IO.DirectoryNotFoundException> クラス\)。  
+  
+-   パスがコロン ":" のみである場合 \(<xref:System.NotSupportedException> クラス\)。  
+  
+## .NET Framework セキュリティ  
+ ファイル名からファイルの内容を判断しないでください。  たとえば、Form1.vb というファイルは Visual Basic のソース ファイルではない可能性もあります。  アプリケーションでデータを使用する前に、入力をすべて検証してください。  
+  
+## 参照  
+ <xref:System.Media.SoundPlayer.PlayLooping%2A>   
+ [方法 : Windows フォームからサウンドを再生する](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)   
+ [SoundPlayer クラスの概要](../../../../docs/framework/winforms/controls/soundplayer-class-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..11fd26e32a7
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 読み取り専用列"
+  - "DataGridView コントロール [Windows フォーム], 読み取り専用列"
+ms.assetid: 2bb73ebb-1a55-4362-9fda-e50574c087d5
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする
+すべてのデータが編集できるわけではありません。  <xref:System.Windows.Forms.DataGridView> コントロールでは、列の <xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A> プロパティの値はユーザーがその列のセルを編集できるかどうかを決定します。  コントロールを完全に読み取り専用にする方法については、「[方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)」を参照してください。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする](http://msdn.microsoft.com/library/xd4k3c7e\(v=vs.110\))」も参照してください。  
+  
+### プログラムで列を読み取り専用にするには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A?displayProperty=fullName> プロパティを `true` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#064](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#064)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#064](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#064)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `CompanyName` という名前の列を持つ `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.Columns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-make-thread-safe-calls-to-windows-forms-controls.md b/docs/framework/winforms/controls/how-to-make-thread-safe-calls-to-windows-forms-controls.md
new file mode 100644
index 00000000000..1e807e14c38
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-make-thread-safe-calls-to-windows-forms-controls.md
@@ -0,0 +1,120 @@
+---
+title: "方法 : Windows フォーム コントロールのスレッド セーフな呼び出しを行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "EHInvalidOperation.WinForms.IllegalCrossThreadCall"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "スレッド セーフ, 呼び出しコントロール [Windows フォーム]"
+  - "呼び出しコントロール, スレッド セーフ [Windows フォーム]"
+  - "CheckForIllegalCrossThreadCalls プロパティ [Windows フォーム]"
+  - "Windows フォーム コントロール, マルチスレッド処理"
+  - "BackgroundWorker クラス, 例"
+  - "スレッド処理 [Windows フォーム], スレッド間の呼び出し"
+  - "コントロール [Windows フォーム], マルチスレッド処理"
+ms.assetid: 138f38b6-1099-4fd5-910c-390b41cbad35
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム コントロールのスレッド セーフな呼び出しを行う
+マルチスレッドを使用して Windows フォーム アプリケーションのパフォーマンスを向上させる場合は、必ずスレッド セーフな方法でコントロールを呼び出してください。  
+  
+ Windows フォーム コントロールへのアクセスは、本質的にスレッド セーフではありません。 コントロールの状態を操作するスレッドが複数ある場合、コントロールが不整合な状態になる可能性があります。 競合状態やデッドロックなど、他のスレッド関連のバグが生じる可能性もあります。 コントロールへのアクセスがスレッド セーフな方法で実行されることを確認することが重要です。  
+  
+ <xref:System.Windows.Forms.Control.Invoke%2A> メソッドを使用せずにコントロールを作成したスレッド以外のスレッドからコントロールを呼び出すのは安全ではありません。 スレッド セーフでない呼び出しの例を次に示します。  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#6](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#6)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#6)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#6)]  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] は、スレッド セーフでない方法でコントロールにアクセスしていることを検出するのに役立ちます。 デバッガーでアプリケーションを実行しているときに、コントロールを作成したスレッド以外のスレッドがそのコントロールを呼び出そうとすると、デバッガーは <xref:System.InvalidOperationException> を発生させ、"コントロールが作成されたスレッド以外のスレッドからコントロール '*コントロール名*' がアクセスされました。" というメッセージが示されます。  
+  
+ この例外は、デバッグ時には確実に発生しますが、場合によっては実行時に発生することもあります。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] より前に [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] を使用して、作成したアプリケーションのデバッグを行う場合に、この例外が発生することがあります。 この問題が発生したら修正することを強くお勧めしますが、<xref:System.Windows.Forms.Control.CheckForIllegalCrossThreadCalls%2A> プロパティを `false` に設定して無効にすることもできます。 これによりコントロールは、Visual Studio .NET 2003 および [!INCLUDE[net_v11_short](../../../../includes/net-v11-short-md.md)] の下で実行しているかのように実行されます。  
+  
+> [!NOTE]
+>  フォームで ActiveX コントロールを使用している場合、デバッガー下で実行すると、スレッド間の <xref:System.InvalidOperationException> を受け取ることがあります。 これが発生した場合、ActiveX コントロールではマルチスレッドをサポートしていません。 Windows フォームでの ActiveX コントロールの使用の詳細については、「[Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)」を参照してください。 Visual Studio を使用している場合、Visual Studio ホスティング プロセスを無効にすることで、この例外を防止できます。「[方法 : ホスト プロセスを無効にする](../Topic/How%20to:%20Disable%20the%20Hosting%20Process.md)」を参照してください。  
+  
+## Windows フォーム コントロールのスレッド セーフな呼び出し  
+  
+#### Windows フォーム コントロールのスレッド セーフな呼び出しを行うには  
+  
+1.  コントロールの <xref:System.Windows.Forms.Control.InvokeRequired%2A> プロパティを照会します。  
+  
+2.  <xref:System.Windows.Forms.Control.InvokeRequired%2A> から `true` が返された場合は、デリゲートを使用して <xref:System.Windows.Forms.Control.Invoke%2A> を呼び出します。このデリゲートがコントロールへの実際の呼び出しを行います。  
+  
+3.  <xref:System.Windows.Forms.Control.InvokeRequired%2A> から `false` が返された場合は、コントロールを直接呼び出します。  
+  
+ 次のコード例では、スレッド セーフな呼び出しが `ThreadProcSafe` メソッドに実装されており、バックグラウンド スレッドによって実行されます。<xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.InvokeRequired%2A> から `true` が返された場合、`ThreadProcSafe` メソッドによって `SetTextCallback` のインスタンスが作成され、それがフォームの <xref:System.Windows.Forms.Control.Invoke%2A> メソッドに渡されます。 これにより、`SetText` メソッドが <xref:System.Windows.Forms.TextBox> コントロールを作成したスレッドで呼び出されます。また、このスレッド コンテキストで、<xref:System.Windows.Forms.Control.Text%2A> プロパティが直接設定されます。  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#7](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#7)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#7)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#7)]  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#3](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#3)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#3)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#3)]  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#8](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#8)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#8)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#8)]  
+  
+## BackgroundWorker を使用したスレッド セーフな呼び出し  
+ アプリケーションにマルチスレッドを実装する場合は、<xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用することをお勧めします。<xref:System.ComponentModel.BackgroundWorker> コンポーネントでは、マルチスレッドにイベント ドリブン モデルが使用されます。 バックグラウンド スレッドが <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーを実行し、コントロールを作成したスレッドが <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベント ハンドラーと <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーを実行します。<xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベント ハンドラーと <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーからコントロールを呼び出すことができます。  
+  
+#### BackgroundWorker を使用してスレッド セーフな呼び出しを行うには  
+  
+1.  バックグラウンド スレッドで行われるようにする作業を実行するメソッドを作成します。 このメソッドで、メイン メソッドにより作成されたコントロールは呼び出さないでください。  
+  
+2.  バックグラウンド作業の終了後にその結果を報告するメソッドを作成します。 このメソッドではメイン スレッドにより作成されたコントロールを呼び出すことができます。  
+  
+3.  手順 1 で作成したメソッドを <xref:System.ComponentModel.BackgroundWorker.DoWork> のインスタンスの <xref:System.ComponentModel.BackgroundWorker> イベントにバインドし、手順 2 で作成したメソッドを同じインスタンスの <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントにバインドします。  
+  
+4.  バックグラウンド スレッドを開始するには、<xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> インスタンスの <xref:System.ComponentModel.BackgroundWorker> メソッドを呼び出します。  
+  
+ 次のコード例では、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーが <xref:System.Threading.Thread.Sleep%2A> を使用して時間のかかる作業をシミュレートします。 フォームの <xref:System.Windows.Forms.TextBox> コントロールは呼び出しません。<xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティは <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーで直接設定されます。  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#5](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#5)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#5)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#5)]  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#9](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#9)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#9](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#9)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#9](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#9)]  
+  
+ <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントを使用して、バックグラウンド タスクの進行状況を報告することもできます。 そのイベントを組み込む例については、「<xref:System.ComponentModel.BackgroundWorker>」を参照してください。  
+  
+## 使用例  
+ 次のコード例は、3 つのボタンと 1 つのテキスト ボックスを持つフォームで構成される、完全な Windows フォーム アプリケーションです。 最初のボタンは安全でないスレッド間アクセスを示し、2 番目のボタンは <xref:System.Windows.Forms.Control.Invoke%2A> を使用した安全なアクセスを示し、3 番目のボタンは <xref:System.ComponentModel.BackgroundWorker> を使用した安全なアクセスを示します。  
+  
+> [!NOTE]
+>  この例の実行方法については、「[How to: Compile and Run a Complete Windows Forms Code Example Using Visual Studio](http://msdn.microsoft.com/ja-jp/cc447f7e-4c3b-4397-9d05-aeba3ca49416)」を参照してください。 この例では、System.Drawing アセンブリと System.Windows.Forms アセンブリへの参照が必要です。  
+  
+ [!code-cpp[System.Windows.Forms.CrossThreadCalls#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/cpp/Form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.CrossThreadCalls#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.CrossThreadCalls#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CrossThreadCalls/VB/Form1.vb#1)]  
+  
+ アプリケーションを実行し、**\[Unsafe Call\]** ボタンをクリックするとすぐに、テキスト ボックスに "Written by the main thread \(メイン スレッドで作成されました\)" と表示されます。 2 秒後、安全でない呼び出しが行われると、例外が発生したことが Visual Studio デバッガーにより示されます。 デバッガーは、テキスト ボックスに直接書き込もうとしたバックグラウンド スレッドの該当行で停止します。 他の 2 つのボタンをテストするには、アプリケーションを再起動する必要があります。**\[Safe Call\]** ボタンをクリックすると、テキスト ボックスに "Written by the main thread \(メイン スレッドで作成されました\)" と表示されます。 2 秒後、テキスト ボックスは "Written by the background thread \(Invoke\) \(バックグラウンド スレッドで書き込まれました \(呼び出し\)\)" に設定されます。これは、<xref:System.Windows.Forms.Control.Invoke%2A> メソッドが呼び出されたことを示します。**\[Safe BW Call\]** ボタンをクリックすると、テキスト ボックスに "Written by the main thread \(メイン スレッドで作成されました\)" と表示されます。 2 秒後、テキスト ボックスは "Written by the main thread after the background thread completed \(バックグラウンド スレッドの実行後にメイン スレッドで書き込まれました\)" に設定されます。これは、<xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> の <xref:System.ComponentModel.BackgroundWorker> イベントのハンドラーが呼び出されたことを示します。  
+  
+## 信頼性の高いプログラミング  
+  
+> [!CAUTION]
+>  どのようなマルチスレッドを使用する場合でも、コードで深刻かつ複雑なバグが発生する可能性があります。 詳細については、マルチスレッドを使用するソリューションを実装する前に、「[Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [Windows フォームとアンマネージ アプリケーション](../../../../docs/framework/winforms/advanced/windows-forms-and-unmanaged-applications.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-make-your-control-invisible-at-run-time.md b/docs/framework/winforms/controls/how-to-make-your-control-invisible-at-run-time.md
new file mode 100644
index 00000000000..f83669e3a08
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-make-your-control-invisible-at-run-time.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : 実行時にコントロールを非表示にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 非表示 (実行時に)"
+  - "カスタム コントロール [Windows フォーム], 非表示の"
+  - "非表示のコントロール"
+  - "実行時に, 非表示 (コントロールを)"
+  - "ユーザー コントロール [Windows フォーム], 非表示の"
+ms.assetid: 69eb2e72-32f5-4f79-a157-c2c5f60c1628
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 実行時にコントロールを非表示にする
+実行時には表示されないユーザー コントロールを作成することが必要な場合もあります。  たとえば、アラーム クロックなどは、音が鳴っている間以外は表示されないのが普通です。  この機能は <xref:System.Windows.Forms.Control.Visible%2A> プロパティによって簡単に実現できます。  <xref:System.Windows.Forms.Control.Visible%2A> プロパティを `true` に設定した場合、コントロールは通常どおりに表示されます。  `false` に設定した場合、コントロールは非表示になります。  コントロールが非表示のときでもコードの実行は継続されますが、ユーザー インターフェイスを介したコントロールとの対話はできません。  ユーザー入力 \(マウス クリックなど\) に応答できる状態でコントロールを非表示にするには、透過的なコントロールを作成します。  詳細については、「[コントロールへの透明な背景の適用](../../../../docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md)」を参照してください。  
+  
+### 実行時にコントロールを非表示にするには  
+  
+1.  <xref:System.Windows.Forms.Control.Visible%2A> プロパティを `false` に設定します。  
+  
+    ```vb  
+    ' To set the Visible property from within your object's own code.  
+    Me.Visible = False  
+    ' To set the Visible property from another object.  
+    myControl1.Visible = False  
+  
+    ```  
+  
+    ```csharp  
+    // To set the Visible property from within your object's own code.  
+    this.Visible = false;  
+    // To set the Visible property from another object.  
+    myControl1.Visible = false;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Visible%2A>   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [方法 : コントロールに透明な背景を指定する](../../../../docs/framework/winforms/controls/how-to-give-your-control-a-transparent-background.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-manage-toolstrip-overflow-in-windows-forms.md b/docs/framework/winforms/controls/how-to-manage-toolstrip-overflow-in-windows-forms.md
new file mode 100644
index 00000000000..ec8c38260b3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-manage-toolstrip-overflow-in-windows-forms.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : Windows フォームの ToolStrip オーバーフローを管理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CanOverflow プロパティ"
+  - "例 [Windows フォーム], ツール バー"
+  - "Overflow プロパティ"
+  - "ツール バー [Windows フォーム], 管理 (オーバーフローを)"
+  - "ToolStrip コントロール [Windows フォーム], 管理 (オーバーフローを)"
+ms.assetid: fa10e0ad-4cbf-4c0d-9082-359c2f855d4e
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームの ToolStrip オーバーフローを管理する
+<xref:System.Windows.Forms.ToolStrip> コントロールのすべての項目が割り当てられた領域に収まらないときは、その <xref:System.Windows.Forms.ToolStrip> に対してオーバーフロー機能を有効にして、特定の <xref:System.Windows.Forms.ToolStripItem> のオーバーフロー動作を指定できます。  
+  
+ フォームの現在のサイズを前提に <xref:System.Windows.Forms.ToolStrip> に割り当てられた領域を超える領域を必要とする <xref:System.Windows.Forms.ToolStripItem> を追加すると、<xref:System.Windows.Forms.ToolStrip> 上に <xref:System.Windows.Forms.ToolStripOverflowButton> が自動的に表示されます。  <xref:System.Windows.Forms.ToolStripOverflowButton> が表示されると、オーバーフローが有効になった項目がオーバーフローのドロップダウン メニューに移動します。  これによって、さまざまなフォーム サイズに合うように <xref:System.Windows.Forms.ToolStrip> 項目を調整する方法をカスタマイズし、優先順位を付けることができます。  また、<xref:System.Windows.Forms.ToolStripItem.Placement%2A> プロパティと <xref:System.Windows.Forms.ToolStripOverflow.DisplayedItems%2A?displayProperty=fullName> プロパティ、および <xref:System.Windows.Forms.ToolStrip.LayoutCompleted> イベントを使用することによって、オーバーフロー状態になったときの項目の外観を変更することもできます。  デザイン時または実行時にフォームを拡大すると、より多くの <xref:System.Windows.Forms.ToolStripItem> がメイン <xref:System.Windows.Forms.ToolStrip> に表示され、フォームのサイズを縮小しない限り <xref:System.Windows.Forms.ToolStripOverflowButton> は表示されないことがあります。  
+  
+### ToolStrip コントロールのオーバーフローを有効にするには  
+  
+-   <xref:System.Windows.Forms.ToolStrip> の <xref:System.Windows.Forms.ToolStrip.CanOverflow%2A> プロパティが `false` に設定されていないことを確認します。  既定値は、`True` です。  
+  
+     <xref:System.Windows.Forms.ToolStrip.CanOverflow%2A> が `True` \(既定値\) の場合、<xref:System.Windows.Forms.ToolStripItem> の内容が水平の <xref:System.Windows.Forms.ToolStrip> の幅または垂直の <xref:System.Windows.Forms.ToolStrip> の高さを超えると、<xref:System.Windows.Forms.ToolStripItem> がオーバーフローのドロップダウン メニューに送られます。  
+  
+### 特定の ToolStripItem のオーバーフロー動作を指定するには  
+  
+-   <xref:System.Windows.Forms.ToolStripItem> の <xref:System.Windows.Forms.ToolStripItem.Overflow%2A> プロパティを任意の値に設定します。  設定できる値は、`Always`、`Never`、および `AsNeeded` です。  既定値は `AsNeeded` です。  
+  
+    ```vb  
+    toolStripTextBox1.Overflow = _  
+    System.Windows.Forms.ToolStripItemOverflow.Never  
+  
+    ```  
+  
+    ```csharp  
+    toolStripTextBox1.Overflow = _  
+    System.Windows.Forms.ToolStripItemOverflow.Never;  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripOverflowButton>   
+ <xref:System.Windows.Forms.ToolStripItem.Overflow%2A>   
+ <xref:System.Windows.Forms.ToolStrip.CanOverflow%2A>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-manipulate-bands-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-manipulate-bands-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..7510c2ca668
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-manipulate-bands-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールのバンドを操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バンド, 操作 (Windows フォームで)"
+  - "データ グリッド, 操作 (バンドを)"
+  - "DataGridView コントロール [Windows フォーム], 操作 (バンドを)"
+ms.assetid: 1ea3470e-480f-4edc-bcbd-51373eca3856
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームの DataGridView コントロールのバンドを操作する
+次のコード例では、<xref:System.Windows.Forms.DataGridViewRow> クラスと <xref:System.Windows.Forms.DataGridViewColumn> クラスの派生元である <xref:System.Windows.Forms.DataGridViewBand> クラスのプロパティを使用して、<xref:System.Windows.Forms.DataGridView> の行と列を操作する様々な方法を示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.ButtonDemos#0](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CPP/DataGridViewBandDemo.cpp#0)]
+ [!code-csharp[System.Windows.Forms.DataGridView.ButtonDemos#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CS/DataGridViewBandDemo.cs#0)]
+ [!code-vb[System.Windows.Forms.DataGridView.ButtonDemos#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/VB/datagridviewbanddemo.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewBand>   
+ <xref:System.Windows.Forms.DataGridViewRow>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..dcfadf91383
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの列を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 操作"
+  - "データ グリッド, 操作 (列を)"
+  - "DataGridView コントロール [Windows フォーム], 操作 (列を)"
+ms.assetid: d8cfe6b3-bbab-4182-bec2-0517d9f1eaf6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォーム DataGridView コントロールの列を操作する
+<xref:System.Windows.Forms.DataGridViewColumn> クラスのプロパティを使用して <xref:System.Windows.Forms.DataGridView> の列を操作するさまざまな方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.ButtonDemos#100](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CPP/DataGridViewColumnDemo.cpp#100)]
+ [!code-csharp[System.Windows.Forms.DataGridView.ButtonDemos#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CS/DataGridViewColumnDemo.cs#100)]
+ [!code-vb[System.Windows.Forms.DataGridView.ButtonDemos#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/VB/datagridviewcolumndemo.vb#100)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewBand>   
+ <xref:System.Windows.Forms.DataGridViewRow>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-manipulate-rows-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-manipulate-rows-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..99373b7817c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-manipulate-rows-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールの行を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 操作 (行を)"
+  - "DataGridView コントロール [Windows フォーム], 操作 (行を)"
+  - "行, 操作 (Windows フォームの)"
+ms.assetid: 522d8944-e073-4488-9673-923f0a8d7214
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームの DataGridView コントロールの行を操作する
+<xref:System.Windows.Forms.DataGridViewRow> クラスのプロパティを使用して <xref:System.Windows.Forms.DataGridView> の行を操作するさまざまな方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.ButtonDemos#200](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CPP/DataGridViewRowDemo.cpp#200)]
+ [!code-csharp[System.Windows.Forms.DataGridView.ButtonDemos#200](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/CS/DataGridViewRowDemo.cs#200)]
+ [!code-vb[System.Windows.Forms.DataGridView.ButtonDemos#200](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ButtonDemos/VB/datagridviewrowdemo.vb#200)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewBand>   
+ <xref:System.Windows.Forms.DataGridViewRow>   
+ <xref:System.Windows.Forms.DataGridViewColumn>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md b/docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md
new file mode 100644
index 00000000000..4ce65aa7624
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : 実行時にピクチャのサイズまたは配置を変更する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], PictureBox コントロール"
+  - "イメージ [Windows フォーム], 制御 (PictureBox コントロール内の配置を) [Windows フォーム]"
+  - "PictureBox コントロール [Windows フォーム], ピクチャのサイズと配置"
+  - "ピクチャ, 制御 (PictureBox コントロール内の配置を) [Windows フォーム]"
+ms.assetid: d0b332a3-fae2-4891-957c-dc3e17743326
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 実行時にピクチャのサイズまたは配置を変更する (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.PictureBox> コントロールをフォームで使用している場合は、フォームの <xref:System.Windows.Forms.PictureBox.SizeMode%2A> プロパティを次のように設定できます。  
+  
+-   ピクチャの左上隅をコントロールの左上隅と揃えます。  
+  
+-   ピクチャをコントロールの中央に配置します。  
+  
+-   コントロールに表示されるピクチャに合わせて、コントロールのサイズを調整します。  
+  
+-   コントロールに合わせて、表示されるピクチャを伸縮します。  
+  
+ 特にビットマップ形式のピクチャの場合、伸縮するとイメージの画質が低下することがあります。  メタファイルは、イメージを実行時に描画するためのグラフィックス命令のリストであり、ビットマップよりも伸縮に適しています。  
+  
+### 実行時に SizeMode プロパティを設定するには  
+  
+1.  <xref:System.Windows.Forms.PictureBox.SizeMode%2A> を <xref:System.Windows.Forms.PictureBoxSizeMode> \(既定\)、<xref:System.Windows.Forms.PictureBoxSizeMode>、<xref:System.Windows.Forms.PictureBoxSizeMode>、または <xref:System.Windows.Forms.PictureBoxSizeMode> に設定します。  <xref:System.Windows.Forms.PictureBoxSizeMode> は、イメージがコントロールの左上隅に配置されることを示し、イメージがコントロールよりも大きい場合、ピクチャの下辺と右辺がクリップされます。  <xref:System.Windows.Forms.PictureBoxSizeMode> は、イメージがコントロール内の中央に配置されることを示し、イメージがコントロールよりも大きい場合、ピクチャの周囲の端がクリップされます。  <xref:System.Windows.Forms.PictureBoxSizeMode> は、コントロールのサイズがイメージのサイズに合わせて調整されることを示します。  <xref:System.Windows.Forms.PictureBoxSizeMode> はその逆で、イメージのサイズがコントロールのサイズに合わせて調整されることを示します。  
+  
+     次の例では、イメージの場所に対するパスとして **My Documents** フォルダーが設定されています。  これは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例は、既に <xref:System.Windows.Forms.PictureBox> コントロールが追加されたフォームを想定しています。  
+  
+    ```vb  
+    Private Sub StretchPic()  
+       ' Stretch the picture to fit the control.  
+       PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage  
+       ' Load the picture into the control.  
+       ' You should replace the bold image   
+       ' in the sample below with an icon of your own choosing.  
+       PictureBox1.Image = Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Image.gif")  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void StretchPic(){  
+       // Stretch the picture to fit the control.  
+       PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;  
+       // Load the picture into the control.  
+       // You should replace the bold image   
+       // in the sample below with an icon of your own choosing.  
+       // Note the escape character used (@) when specifying the path.  
+       PictureBox1.Image = Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       + @"\Image.gif")  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void StretchPic()  
+       {  
+          // Stretch the picture to fit the control.  
+          pictureBox1->SizeMode = PictureBoxSizeMode::StretchImage;  
+          // Load the picture into the control.  
+          // You should replace the bold image   
+          // in the sample below with an icon of your own choosing.  
+          pictureBox1->Image = Image::FromFile(String::Concat(  
+             System::Environment::GetFolderPath(  
+             System::Environment::SpecialFolder::Personal),  
+             "\\Image.gif"));  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.PictureBox>   
+ [方法 : デザイナーを使用してピクチャを読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md)   
+ [PictureBox コントロールの概要](../../../../docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md)   
+ [方法 : 実行時にピクチャを設定する](../../../../docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md)   
+ [PictureBox コントロール](../../../../docs/framework/winforms/controls/picturebox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md b/docs/framework/winforms/controls/how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md
new file mode 100644
index 00000000000..ae1d748e933
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : ToolStrip を ToolStripContainer からフォームに移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolStrip コントロール [Windows フォーム], 親 (フォームの)"
+  - "Windows フォーム, 親 (ToolStrip コントロールの)"
+ms.assetid: a1c94a7f-6fc5-4e4c-84cf-ff11dc573d33
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ToolStrip を ToolStripContainer からフォームに移動する
+<xref:System.Windows.Forms.ToolStrip> を <xref:System.Windows.Forms.ToolStripContainer> からフォームに移動するには、次の手順に従います。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ToolStrip を ToolStripContainer からフォームに移動するには  
+  
+1.  <xref:System.Windows.Forms.ToolStrip> を選択します。  
+  
+2.  Ctrl キーを押しながら X キーを押すか、または <xref:System.Windows.Forms.ToolStrip> を右クリックし、コンテキスト メニューの **\[切り取り\]** をクリックして、<xref:System.Windows.Forms.ToolStrip> を切り取ります。  
+  
+3.  フォームを選択します。  
+  
+4.  Ctrl キーを押しながら V キーを押すか、または **\[編集\]** メニューの **\[貼り付け\]** をクリックして <xref:System.Windows.Forms.ToolStrip> を貼り付けます。  
+  
+5.  <xref:System.Windows.Forms.ToolStrip> の <xref:System.Windows.Forms.ToolStrip.Dock%2A> プロパティを **\[Top\]** に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripContainer>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-move-toolstripmenuitems.md b/docs/framework/winforms/controls/how-to-move-toolstripmenuitems.md
new file mode 100644
index 00000000000..bb3145f6a55
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-move-toolstripmenuitems.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : ToolStripMenuItems を移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目, 切り取りと貼り付け"
+  - "メニュー項目, ドラッグ アンド ドロップ"
+  - "メニュー項目, 移動"
+  - "メニュー, 配置 (項目を)"
+  - "MenuStrip コントロール [Windows フォーム], 配置 (項目を)"
+  - "ToolStripMenuItem, 切り取りと貼り付け"
+  - "ToolStripMenuItem, ドラッグ アンド ドロップ"
+  - "ToolStripMenuItem, 移動"
+ms.assetid: cab9e03e-4edd-4c25-b3e3-bd1edc602bd9
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ToolStripMenuItems を移動する
+デザイン時には、トップレベル メニュー全体とそのメニュー項目を、<xref:System.Windows.Forms.MenuStrip> 上の別の位置に移動できます。  また、トップレベル メニュー間で個々のメニュー項目を移動したり、メニュー内でメニュー項目の位置を変更したりすることもできます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### トップレベル メニューとそのメニュー項目を別のトップレベル位置に移動するには  
+  
+1.  移動するメニューをクリックし、マウスの左ボタンを押したままにします。  
+  
+2.  移動先になる位置の前にあるトップレベル メニューまでカーソル位置をドラッグし、マウスの左ボタンを離します。  
+  
+     選択したメニューが、カーソル位置の右側に移動します。  
+  
+### トップレベル メニューとそのメニュー項目をドロップダウン位置に移動するには  
+  
+1.  移動するメニューを左クリックし、Ctrl キーを押しながら X キーを押すか、メニューを右クリックして、ショートカット メニューの **\[切り取り\]** を選択します。  
+  
+2.  移動先のトップレベル メニューで、移動先になる位置の上にあるメニュー項目を左クリックし、Ctrl キーを押しながら V キーを押すか、移動先になる位置の上にあるメニュー項目を右クリックし、ショートカット メニューの **\[貼り付け\]** をクリックします。  
+  
+     切り取ったメニューが、選択したメニュー項目の後に挿入されます。  
+  
+### 項目コレクション エディターを使用して、メニュー項目をメニュー内で移動するには  
+  
+1.  移動するメニュー項目を含むメニューを右クリックします。  
+  
+2.  ショートカット メニューの **\[DropDownItems の編集\]** をクリックします。  
+  
+3.  **項目コレクション エディター**で、移動するメニュー項目を左クリックします。  
+  
+4.  ↑キーまたは↓キーを押して、メニュー項目をメニュー内で移動します。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+### キーボードを使用して、メニュー項目をメニュー内で移動するには  
+  
+1.  Alt キーを押したままにします。  
+  
+2.  移動するメニュー項目をクリックし、マウスの左ボタンを押したままにします。  
+  
+3.  メニュー項目を新しい位置にドラッグし、マウスの左ボタンを離します。  
+  
+### メニュー項目を別のメニューに移動するには  
+  
+1.  移動するメニュー項目を左クリックし、Ctrl キーを押しながら X キーを押すか、メニュー項目を右クリックし、ショートカット メニューの **\[切り取り\]** をクリックします。  
+  
+2.  切り取ったメニュー項目の移動先になるメニューを左クリックします。  
+  
+3.  移動先になる位置の前にあるメニュー項目を左クリックし、Ctrl キーを押しながら V キーを押すか、移動先になる位置の前にあるメニュー項目を右クリックし、ショートカット メニューの **\[貼り付け\]** をクリックします。  
+  
+     切り取ったメニュー項目が、選択したメニュー項目の後に挿入されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md b/docs/framework/winforms/controls/how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md
new file mode 100644
index 00000000000..3d1fe407652
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-navigate-data-with-the-windows-forms-bindingnavigator-control.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingNavigator コントロール [Windows フォーム], 移動 (データ間を)"
+  - "データ [Windows フォーム], 移動"
+  - "データ間の移動"
+  - "例 [Windows フォーム], BindingNavigator コントロール"
+ms.assetid: 0e5d4f34-bc9b-47cf-9b8d-93acbb1f1dbb
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム BindingNavigator コントロールを使用してデータ間を移動する
+Windows フォームに <xref:System.Windows.Forms.BindingNavigator> コントロールが登場したことで、開発者はエンドユーザーに、作成したフォームにおける単純なデータ移動および操作のためのユーザー インターフェイスを提供できるようになります。  
+  
+ <xref:System.Windows.Forms.BindingNavigator> コントロールは、データセットの最初、最後、次、前のレコードへの移動が構成済みのボタンや、レコードを追加および削除するためのボタンを持つ <xref:System.Windows.Forms.ToolStrip> コントロールです。  <xref:System.Windows.Forms.BindingNavigator> コントロールへのボタンの追加は、<xref:System.Windows.Forms.ToolStrip> コントロールなので簡単です。  「[方法 : Windows フォーム BindingNavigator コントロールに \[Load\]、\[Save\]、\[Cancel\] の各ボタンを追加する](http://msdn.microsoft.com/library/safa4957\(v=vs.110\))」も参照してください。  
+  
+ <xref:System.Windows.Forms.BindingNavigator> コントロールの各ボタンについて、同じ機能をプログラムで許可する <xref:System.Windows.Forms.BindingSource> コンポーネントの対応するメンバーが存在します。  たとえば、<xref:System.Windows.Forms.BindingNavigator.MoveFirstItem%2A> ボタンは <xref:System.Windows.Forms.BindingSource> コンポーネントの <xref:System.Windows.Forms.BindingSource.MoveFirst%2A> メソッドに対応し、<xref:System.Windows.Forms.BindingNavigator.DeleteItem%2A> ボタンは <xref:System.Windows.Forms.BindingSource.RemoveCurrent%2A> メソッドに対応します。  その結果、データ レコード間を移動する <xref:System.Windows.Forms.BindingNavigator> コントロールを有効にするために必要なのは、<xref:System.Windows.Forms.BindingNavigator.BindingSource%2A> プロパティをフォームの適切な <xref:System.Windows.Forms.BindingSource> コンポーネントに設定するだけです。  
+  
+### BindingNavigator コントロールを設定するには  
+  
+1.  `bindingSource1` という名前の <xref:System.Windows.Forms.BindingSource> コンポーネントを 1 つ、`textBox1` と `textBox2` という名前の <xref:System.Windows.Forms.TextBox> コントロールを 2 つ追加します。  
+  
+2.  `bindingSource1`  をデータにバインドし、テキスト ボックス コントロールを `bindingSource1` にバインドします。  そのためには、以下のコードをフォームに貼り付け、フォームのコンストラクターまたは <xref:System.Windows.Forms.Form.Load> イベント処理メソッドから `LoadData` を呼び出します。  
+  
+     [!code-csharp[System.Windows.Forms.BindingNavigatorNavigate#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.BindingNavigatorNavigate#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/VB/Form1.vb#2)]  
+  
+3.  `bindingNavigator1` という名前の <xref:System.Windows.Forms.BindingNavigator> コントロールをフォームに追加します。  
+  
+4.  `bindingNavigator1` の <xref:System.Windows.Forms.BindingNavigator.BindingSource%2A> プロパティを `bindingSource1` に設定します。  これは、デザイナーを使用して、またはコード内で実行できます。  
+  
+     [!code-csharp[System.Windows.Forms.BindingNavigatorNavigate#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.BindingNavigatorNavigate#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/VB/Form1.vb#3)]  
+  
+## 使用例  
+ 次のコード例は、これまで説明した手順の完全な例です。  
+  
+ [!code-csharp[System.Windows.Forms.BindingNavigatorNavigate#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.BindingNavigatorNavigate#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingNavigatorNavigate/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、System.Windows.Forms、および System.Xml アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md b/docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md
new file mode 100644
index 00000000000..6e035813b9b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : WebBrowser コントロールで URL に移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WebBrowser.Navigate"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], WebBrowser コントロール"
+  - "URL, 移動"
+  - "WebBrowser コントロール [Windows フォーム], 例"
+  - "WebBrowser コントロール [Windows フォーム], 移動 (URL に)"
+ms.assetid: b3ec38cb-f509-4d0b-bd79-9f3611259c62
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : WebBrowser コントロールで URL に移動する
+次のコード例は、指定した URL に <xref:System.Windows.Forms.WebBrowser> コントロールで移動する方法を示しています。  
+  
+ 新しいドキュメントが完全に読み込まれたタイミングを判断するには、<xref:System.Windows.Forms.WebBrowser.DocumentCompleted> イベントを処理します。  このイベントの例については、「[方法 : WebBrowser コントロールを使用して印刷する](../../../../docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md)」を参照してください。  
+  
+## 使用例  
+  
+```vb  
+Me.webBrowser1.Navigate("http://www.microsoft.com")  
+```  
+  
+```csharp  
+this.webBrowser1.Navigate("http://www.microsoft.com");  
+```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `webBrowser1` という名前の <xref:System.Windows.Forms.WebBrowser> コントロール。  
+  
+-   `System` アセンブリおよび `System.Windows.Forms` アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ <xref:System.Windows.Forms.WebBrowser.DocumentCompleted?displayProperty=fullName>   
+ <xref:System.Windows.Forms.WebBrowser.Navigating?displayProperty=fullName>   
+ <xref:System.Windows.Forms.WebBrowser.Navigated?displayProperty=fullName>   
+ [WebBrowser コントロール](../../../../docs/framework/winforms/controls/webbrowser-control-windows-forms.md)   
+ [方法 : WebBrowser コントロールを使用して印刷する](../../../../docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-open-files-using-the-openfiledialog-component.md b/docs/framework/winforms/controls/how-to-open-files-using-the-openfiledialog-component.md
new file mode 100644
index 00000000000..d4c1aecf4fe
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-open-files-using-the-openfiledialog-component.md
@@ -0,0 +1,191 @@
+---
+title: "方法 : OpenFileDialog コンポーネントを使用してファイルを開く | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ファイル, 開く (OpenFileDialog コンポーネントを使用して)"
+  - "OpenFile メソッド"
+  - "OpenFile メソッド, OpenFileDialog コンポーネント"
+  - "OpenFileDialog コンポーネント, 開く (ファイルを)"
+ms.assetid: 9d88367a-cc21-4ffd-be74-89fd63767d35
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : OpenFileDialog コンポーネントを使用してファイルを開く
+<xref:System.Windows.Forms.OpenFileDialog> コンポーネントを使用すると、ユーザーは、自分のコンピューターやネットワーク上の任意のコンピューターのフォルダーを参照し、1 つ以上のファイルを選択して開くことができます。  このダイアログ ボックスは、ユーザーがダイアログ ボックス内で選択したファイルのパスと名前を返します。  
+  
+ ユーザーが開くファイルを選択したら、そのファイルを開く方法として 2 とおりのアプローチがあります。  ファイル ストリームを使用する場合は、<xref:System.IO.StreamReader> クラスのインスタンスを作成します。  もう 1 つの方法は、<xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドを使用して、選択されたファイルを開く方法です。  
+  
+ 次に示す最初の例には、<xref:System.Security.Permissions.FileIOPermission> のアクセス許可チェック \(以降の「セキュリティに関するメモ」を参照\) が含まれますが、許可されるのはファイル名へのアクセスです。  この手法は、ローカル コンピューター、イントラネット、およびインターネットの各ゾーンから利用できます。  2 番目の方法でも <xref:System.Security.Permissions.FileIOPermission> のアクセス許可チェックが行われますが、この方法はイントラネット ゾーンまたはインターネット ゾーンのアプリケーションに適しています。  
+  
+### OpenFileDialog コンポーネントを使用してファイルをストリームとして開くには  
+  
+1.  **\[ファイルを開く\]** ダイアログ ボックスを表示し、ユーザーによって選択されたファイルを開くメソッドを呼び出します。  
+  
+     1 つのアプローチとしては、<xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用して \[ファイルを開く\] ダイアログ ボックスを表示し、<xref:System.IO.StreamReader> クラスのインスタンスを使用してファイルを開きます。  
+  
+     次のコード例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを使用して <xref:System.Windows.Forms.OpenFileDialog> コンポーネントのインスタンスを開いています。  ファイルが選択され、ユーザーが **\[OK\]** をクリックすると、ダイアログ ボックスで選択されたファイルが開きます。  この場合、ファイルの内容はメッセージ ボックスに表示され、ファイル ストリームが読み取られたことが単に示されます。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.Windows.Forms.FileDialog.FileName%2A> プロパティを取得または設定するには、アセンブリに対して、<xref:System.Security.Permissions.FileIOPermission?displayProperty=fullName> クラスから特権レベルが与えられている必要があります。  完全には信頼できないコンテキストでプロセスを実行している場合は、権限不足のため例外がスローされることがあります。  詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+     この例のコードは、フォームに <xref:System.Windows.Forms.Button> コントロールと <xref:System.Windows.Forms.OpenFileDialog> コンポーネントがあることを想定して書かれています。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles Button1.Click  
+       If OpenFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then  
+         Dim sr As New System.IO.StreamReader(OpenFileDialog1.FileName)  
+         MessageBox.Show(sr.ReadToEnd)  
+         sr.Close()  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       if(openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK)  
+       {  
+          System.IO.StreamReader sr = new   
+             System.IO.StreamReader(openFileDialog1.FileName);  
+          MessageBox.Show(sr.ReadToEnd());  
+          sr.Close();  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          if(openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK)  
+          {  
+             System::IO::StreamReader ^ sr = gcnew  
+                System::IO::StreamReader(openFileDialog1->FileName);  
+             MessageBox::Show(sr->ReadToEnd());  
+             sr->Close();  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click += gcnew  
+       System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+    > [!NOTE]
+    >  ファイル ストリームからの読み取りの詳細については、「[FileStream.BeginRead メソッド](frlrfSystemIOFileStreamClassBeginReadTopic)」および「[FileStream.Read メソッド](https://msdn.microsoft.com/en-us/library/system.io.filestream.read.aspx)」を参照してください。  
+  
+### OpenFileDialog コンポーネントを使用してファイルをファイルとして開くには  
+  
+1.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用してダイアログ ボックスを表示し、<xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドを使用してファイルを開きます。  
+  
+     <xref:System.Windows.Forms.OpenFileDialog> コンポーネントの <xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドは、ファイルを構成するバイトを返します。  これらのバイトにより、読み取り元のストリームが提供されます。  次のコード例では、<xref:System.Windows.Forms.OpenFileDialog> コンポーネントが "カーソル" フィルターと共にインスタンス化され、ユーザーが拡張子 `.cur` のファイルだけを選択できるようになっています。  `.cur`  ファイルが選択されると、フォームのカーソルが選択されたカーソルに設定されます。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドを呼び出すには、アセンブリに対して <xref:System.Security.Permissions.FileIOPermission?displayProperty=fullName> クラスで特権レベルが許可されている必要があります。  完全には信頼できないコンテキストでプロセスを実行している場合は、権限不足のため例外がスローされることがあります。  詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+     この例のコードは、フォームに <xref:System.Windows.Forms.Button> コントロールがあることを想定して書かれています。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles Button1.Click  
+       ' Displays an OpenFileDialog so the user can select a Cursor.  
+       Dim openFileDialog1 As New OpenFileDialog()  
+       openFileDialog1.Filter = "Cursor Files|*.cur"  
+       openFileDialog1.Title = "Select a Cursor File"  
+  
+       ' Show the Dialog.  
+       ' If the user clicked OK in the dialog and   
+       ' a .CUR file was selected, open it.  
+       If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then  
+         ' Assign the cursor in the Stream to the Form's Cursor property.  
+         Me.Cursor = New Cursor(openFileDialog1.OpenFile())  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       // Displays an OpenFileDialog so the user can select a Cursor.  
+       OpenFileDialog openFileDialog1 = new OpenFileDialog();  
+       openFileDialog1.Filter = "Cursor Files|*.cur";  
+       openFileDialog1.Title = "Select a Cursor File";  
+  
+       // Show the Dialog.  
+       // If the user clicked OK in the dialog and  
+       // a .CUR file was selected, open it.  
+        if (openFileDialog1.ShowDialog() == System.Windows.Forms.DialogResult.OK)  
+       {  
+          // Assign the cursor in the Stream to the Form's Cursor property.  
+          this.Cursor = new Cursor(openFileDialog1.OpenFile());  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          // Displays an OpenFileDialog so the user can select a Cursor.  
+          OpenFileDialog ^ openFileDialog1 = new OpenFileDialog();  
+          openFileDialog1->Filter = "Cursor Files|*.cur";  
+          openFileDialog1->Title = "Select a Cursor File";  
+  
+          // Show the Dialog.  
+          // If the user clicked OK in the dialog and  
+          // a .CUR file was selected, open it.  
+          if (openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK)  
+          {  
+             // Assign the cursor in the Stream to  
+             // the Form's Cursor property.  
+             this->Cursor = gcnew  
+                System::Windows::Forms::Cursor(  
+                openFileDialog1->OpenFile());  
+          }  
+       }  
+  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click += gcnew  
+       System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.OpenFileDialog>   
+ [OpenFileDialog コンポーネント](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-opt-out-of-file-dialog-box-automatic-upgrade.md b/docs/framework/winforms/controls/how-to-opt-out-of-file-dialog-box-automatic-upgrade.md
new file mode 100644
index 00000000000..fdd4c2d3f1a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-opt-out-of-file-dialog-box-automatic-upgrade.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : ファイル関連のダイアログ ボックスの自動アップグレードを無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "自動アップグレード不参加 OpenFileDialog [Windows フォーム]"
+  - "[ファイル] ダイアログ ボックス [Windows フォーム] で、自動アップグレードを無効"
+  - "Windows Vista のファイル ダイアログ ボックスで、自動アップグレードを無効"
+  - "自動アップグレード不参加 SaveFileDialog [Windows フォーム]"
+  - "AutoUpgradeEnabled プロパティ"
+ms.assetid: 522e482e-cc01-48b1-8d59-9617dc2c4ac1
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ファイル関連のダイアログ ボックスの自動アップグレードを無効にする
+ときに、 <xref:System.Windows.Forms.OpenFileDialog>と<xref:System.Windows.Forms.SaveFileDialog>クラス、アプリケーションで使用して、その外観と動作は、アプリケーションが実行されている Windows のバージョンによって異なります。 アプリケーションで作成されたときに、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)]に表示される前または[!INCLUDE[wiprlhext](../../../../includes/wiprlhext-md.md)]、 <xref:System.Windows.Forms.OpenFileDialog>と<xref:System.Windows.Forms.SaveFileDialog>で自動的に表示されます、[!INCLUDE[wiprlhext](../../../../includes/wiprlhext-md.md)]外観と動作します。 以降では、 [!INCLUDE[net_v30_short](../../../../includes/net-v30-short-md.md)]、表示する自動アップグレードを避けることができます、 <xref:System.Windows.Forms.OpenFileDialog>と<xref:System.Windows.Forms.SaveFileDialog>で、 [!INCLUDE[winxp](../../../../includes/winxp-md.md)]-スタイルの外観と動作します。  
+  
+### <a name="to-opt-out-of-file-dialog-box-automatic-upgrade"></a>ファイル ダイアログ ボックスの自動アップグレードしないことを  
+  
+1.  設定、 <xref:System.Windows.Forms.FileDialog.AutoUpgradeEnabled%2A>の<xref:System.Windows.Forms.OpenFileDialog>または<xref:System.Windows.Forms.SaveFileDialog>に`false` ダイアログ ボックスを表示する前にします。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Forms.FileDialog>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-play-a-beep-from-a-windows-form.md b/docs/framework/winforms/controls/how-to-play-a-beep-from-a-windows-form.md
new file mode 100644
index 00000000000..6b82bd3f35c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-play-a-beep-from-a-windows-form.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Windows フォームからビープ音を再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サウンド、ビープ音"
+  - "Windows フォームでサウンド"
+  - "サウンドの再生"
+  - "フォームでサウンド"
+  - "サウンドの例 [Windows フォーム]"
+ms.assetid: 7ea5cded-4888-4f35-8f28-5cab1a55c973
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームからビープ音を再生する
+この例では、実行時にビープ音を再生します。  
+  
+## <a name="example"></a>例  
+  
+```vb  
+Public Sub OnePing()  
+    Beep()  
+End Sub  
+```  
+  
+```csharp  
+public void onePing()  
+{  
+    SystemSounds.Beep.Play();  
+}  
+```  
+  
+> [!NOTE]
+>  C# コード サンプルで再生するサウンドが基準、<xref:System.Media.SystemSounds.Beep%2A>システム サウンド設定します。 詳細については、次を参照してください。 <xref:System.Media.SystemSounds>します。  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+ C# の場合、この例への参照が必要です、 <xref:System.Media?displayProperty=fullName>名前空間。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:Microsoft.VisualBasic.Interaction.Beep%2A>   
+ <xref:System.Media.SoundPlayer>   
+ [方法: Windows フォームからシステム サウンドを再生します。](../../../../docs/framework/winforms/controls/how-to-play-a-system-sound-from-a-windows-form.md)   
+ [方法: Windows フォームからサウンドを再生](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-play-a-sound-embedded-in-a-resource-from-a-windows-form.md b/docs/framework/winforms/controls/how-to-play-a-sound-embedded-in-a-resource-from-a-windows-form.md
new file mode 100644
index 00000000000..7e9d23bb552
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-play-a-sound-embedded-in-a-resource-from-a-windows-form.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォームからリソースに埋め込まれたサウンドを再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サウンドの再生 (リソースから)"
+  - "サウンドの再生リソース [Windows フォーム]"
+  - "リソースからのサウンドの再生"
+  - "リソースからサウンドを再生 SoundPlayer クラス"
+ms.assetid: 7d148bb6-8a1e-47d7-a08d-35828d2e688f
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォームからリソースに埋め込まれたサウンドを再生する
+使用することができます、 <xref:System.Media.SoundPlayer>埋め込みリソースからサウンドを再生するクラス。  
+  
+## <a name="example"></a>例  
+ [!code-csharp[System.Windows.Forms.Sound#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.Sound/CS/soundtestform.cs#10)]
+ [!code-vb[System.Windows.Forms.Sound#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Sound/VB/soundtestform.vb#10)]  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+ インポート、 <xref:System.Media?displayProperty=fullName>名前空間。  
+  
+ プロジェクト内の埋め込みリソースとしてサウンド ファイルを含めることです。  
+  
+ 置換"<>\>"サウンド ファイルが埋め込まれているアセンブリの名前に置き換えます。 ".Dll"サフィックスを含めないでください。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Media.SoundPlayer>   
+ [方法: Windows フォームからサウンドを再生](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)   
+ [方法: Windows フォームでサウンドの再生をループ処理](../../../../docs/framework/winforms/controls/how-to-loop-a-sound-playing-on-a-windows-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md b/docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md
new file mode 100644
index 00000000000..84d4a0befce
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : Windows フォームからサウンドを再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォームのサウンドを再生"
+  - "サウンドの再生"
+  - "SoundPlayer クラス"
+  - "サウンド"
+  - "My.Computer.Audio オブジェクト、サウンドの再生"
+  - "サウンドの例 [Windows フォーム]"
+ms.assetid: 3d3350b7-1ebd-4e05-a738-48ca1160a19d
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームからサウンドを再生する
+この例では、実行時に指定されたパスでサウンドを再生します。  
+  
+## <a name="example"></a>例  
+  
+```vb  
+Sub PlaySimpleSound()  
+    My.Computer.Audio.Play("c:\Windows\Media\chimes.wav")  
+End Sub  
+```  
+  
+```csharp  
+private void playSimpleSound()  
+{  
+    SoundPlayer simpleSound = new SoundPlayer(@"c:\Windows\Media\chimes.wav");  
+    simpleSound.Play();  
+}  
+```  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   ファイル名 `"c:\Windows\Media\chimes.wav"` を有効なファイル名に置き換えます。  
+  
+-   (C#)参照、 <xref:System.Media?displayProperty=fullName>名前空間。  
+  
+## <a name="robust-programming"></a>信頼性の高いプログラミング  
+ ファイル操作は、適切な構造化例外処理ブロックで囲む必要があります。  
+  
+ 次の条件を満たす場合は、例外が発生する可能性があります。  
+  
+-   パス名が不適切である場合。 たとえば、無効な文字が含まれていますか、空白だけが (<xref:System.ArgumentException>クラス)。  
+  
+-   パスは読み取り専用 (<xref:System.IO.IOException>クラス)。  
+  
+-   パス名が`null`(<xref:System.ArgumentNullException>クラス)。  
+  
+-   パス名が長すぎます (<xref:System.IO.PathTooLongException>クラス)。  
+  
+-   パスが有効 (<xref:System.IO.DirectoryNotFoundException>クラス)。  
+  
+-   パスがコロンにのみ、":"(<xref:System.NotSupportedException>クラス)。  
+  
+## <a name="net-framework-security"></a>.NET Framework セキュリティ  
+ ファイル名からファイルの内容を判断しないでください。 たとえば、`Form1.vb` というファイルは Visual Basic のソース ファイルではない可能性もあります。 アプリケーションでデータを使用する前に、入力をすべて検証してください。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Media.SoundPlayer>   
+ [方法: Windows フォーム内で非同期的にサウンドを読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-sound-asynchronously-within-a-windows-form.md)   
+ 
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-play-a-system-sound-from-a-windows-form.md b/docs/framework/winforms/controls/how-to-play-a-system-sound-from-a-windows-form.md
new file mode 100644
index 00000000000..7b06bc05ce5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-play-a-system-sound-from-a-windows-form.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : Windows フォームからシステム サウンドを再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サウンド、システムのイベントの再生"
+  - "Windows フォームのサウンドを再生"
+  - "システム サウンドを再生 (Windows フォームから)"
+  - "システムのサウンドを再生"
+  - "SoundPlayer クラスでは、システム サウンド"
+  - "サウンドの再生"
+  - "サウンドの例 [Windows フォーム]"
+ms.assetid: afb206ff-4824-4804-a8d4-185bf5ad8e7c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームからシステム サウンドを再生する
+次のコード例の再生中、`Exclamation`実行時にシステム サウンドです。 システム サウンドの詳細については、次を参照してください。 <xref:System.Media.SystemSounds>します。  
+  
+## <a name="example"></a>例  
+  
+```vb  
+Public Sub PlayExclamation()  
+    SystemSounds.Exclamation.Play()  
+End Sub  
+  
+```  
+  
+```csharp  
+public void playExclamation()  
+{  
+    SystemSounds.Exclamation.Play();  
+}  
+```  
+  
+## <a name="compiling-the-code"></a>コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   参照、 <xref:System.Media?displayProperty=fullName>名前空間。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Media.SoundPlayer>   
+ <xref:System.Media.SystemSounds>   
+ [方法: Windows フォームからビープ音を再生します。](../../../../docs/framework/winforms/controls/how-to-play-a-beep-from-a-windows-form.md)   
+ [方法: Windows フォームからサウンドを再生](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-position-a-toolstripitem-on-a-toolstrip.md b/docs/framework/winforms/controls/how-to-position-a-toolstripitem-on-a-toolstrip.md
new file mode 100644
index 00000000000..912ea4b855b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-position-a-toolstripitem-on-a-toolstrip.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : ToolStrip に ToolStripItem を配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], 配置 (項目を)"
+  - "ToolStrip コントロール [Windows フォーム], 配置 (項目を)"
+ms.assetid: 11fd7c5b-ee5c-4993-9a11-89127ff0aa7a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ToolStrip に ToolStripItem を配置する
+<xref:System.Windows.Forms.ToolStripItem> は <xref:System.Windows.Forms.ToolStrip> の左側または右側に移動したり追加したりできます。  
+  
+### ToolStripItem を ToolStrip の左側に移動または追加するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripItem> の <xref:System.Windows.Forms.ToolStripItemAlignment> プロパティを <xref:System.Windows.Forms.ToolStripItemAlignment> に設定します。  
+  
+### ToolStripItem を ToolStrip の右側に移動または追加するには  
+  
+1.  <xref:System.Windows.Forms.ToolStripItem> の <xref:System.Windows.Forms.ToolStripItemAlignment> プロパティを <xref:System.Windows.Forms.ToolStripItemAlignment> に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripItemAlignment>   
+ <xref:System.Windows.Forms.ToolStripItemAlignment>   
+ <xref:System.Windows.Forms.ToolStripItemAlignment>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-position-controls-on-windows-forms.md b/docs/framework/winforms/controls/how-to-position-controls-on-windows-forms.md
new file mode 100644
index 00000000000..3dbdcd8a61c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-position-controls-on-windows-forms.md
@@ -0,0 +1,112 @@
+---
+title: "方法 : Windows フォーム上のコントロールを位置設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Location"
+  - "Location.Y"
+  - "Location.X"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム]"
+  - "コントロール [Windows フォーム], 移動"
+  - "コントロール [Windows フォーム], 配置"
+  - "スナップ線"
+ms.assetid: 4693977e-34a4-4f19-8221-68c3120c2b2b
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム上のコントロールを位置設定する
+コントロールを位置設定するには、Windows フォーム デザイナーを使用するか、<xref:System.Windows.Forms.Control.Location%2A> プロパティを指定します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### Windows フォーム デザイナーのデザイン サーフェイスに、コントロールを位置設定するには  
+  
+-   マウスを使用して、適切な位置にコントロールをドラッグします。  
+  
+    > [!NOTE]
+    >  コントロールを選択し、方向キーを使用してさらに正確に位置設定します。  また、*スナップ線*は、コントロールをフォーム内に精密に配置するために役立ちます。  詳細については、「[チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)」を参照してください。  
+  
+### \[プロパティ\] ウィンドウを使用して、コントロールを位置設定するには  
+  
+1.  位置設定するコントロールをクリックします。  
+  
+2.  **\[プロパティ\]** ウィンドウで、コンマで区切った<xref:System.Windows.Forms.Control.Location%2A> プロパティの値を入力して、コンテナー内のコントロール位置を指定します。  
+  
+     数字 \(X\) は、コンテナーの左の境界線からの距離を表します。数字 \(Y\) は、コンテナー領域の上部の境界線からの距離を表します。このとき、ピクセル単位で数値が示されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control.Location%2A> プロパティを展開して **\[X\]** 値および **\[Y\]** 値を個別に入力できます。  
+  
+### プログラムによって、コントロールを位置設定するには  
+  
+1.  コントロールの <xref:System.Windows.Forms.Control.Location%2A> プロパティを <xref:System.Drawing.Point> に設定します。  
+  
+    ```vb  
+    Button1.Location = New Point(100, 100)  
+    ```  
+  
+    ```csharp  
+    button1.Location = new Point(100, 100);  
+    ```  
+  
+    ```cpp  
+    button1->Location = Point(100, 100);  
+    ```  
+  
+2.  <xref:System.Windows.Forms.Control.Left%2A> サブプロパティを使用して、コントロールの位置の X 座標を変更します。  
+  
+    ```vb  
+    Button1.Left = 300  
+    ```  
+  
+    ```csharp  
+    button1.Left = 300;  
+    ```  
+  
+    ```cpp  
+    button1->Left = 300;  
+    ```  
+  
+### プログラムによって、コントロールの位置をインクリメントするには  
+  
+1.  <xref:System.Windows.Forms.Control.Left%2A> サブプロパティを設定して、コントロールの X 座標をインクリメントします。  
+  
+    ```vb  
+    Button1.Left += 200  
+    ```  
+  
+    ```csharp  
+    button1.Left += 200;  
+    ```  
+  
+    ```cpp  
+    button1->Left += 200;  
+    ```  
+  
+    > [!NOTE]
+    >  コントロールの X 座標および Y 座標を同時に設定するには、<xref:System.Windows.Forms.Control.Location%2A> プロパティを使用します。  位置をそれぞれ設定するには、コントロールの <xref:System.Windows.Forms.Control.Left%2A> \(**X**\) サブプロパティまたは <xref:System.Windows.Forms.Control.Top%2A> \(**Y**\) サブプロパティを使用します。  ボタンの位置を表す <xref:System.Drawing.Point> 構造体に含まれているのは、ボタンの座標のコピーであるため、X 座標および Y 座標を暗黙的に設定することはできません。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)   
+ [How to: Set the Screen Location of Windows Forms](http://msdn.microsoft.com/ja-jp/cb023ab7-dea7-4284-9aa6-8c03c59b60c6)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md b/docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md
new file mode 100644
index 00000000000..ccfdb53bedf
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : WebBrowser コントロールを使用して印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WebBrowser.Print"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], WebBrowser コントロール"
+  - "印刷 [Windows フォーム], Web ページ"
+  - "Web ページ, 印刷"
+  - "WebBrowser コントロール [Windows フォーム], 例"
+  - "WebBrowser コントロール [Windows フォーム], 印刷"
+ms.assetid: 3fb2a305-64ce-4b6c-9258-5330d3f21b6c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : WebBrowser コントロールを使用して印刷する
+次のコード例は、<xref:System.Windows.Forms.WebBrowser> コントロールを使用して、Web ページを表示しないで印刷する方法を示しています。  
+  
+## 使用例  
+ [!code-csharp[WebBrowserMisc#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/WebBrowserMisc/CS/WebBrowserMisc.cs#10)]
+ [!code-vb[WebBrowserMisc#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WebBrowserMisc/vb/WebBrowserMisc.vb#10)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `System` アセンブリおよび `System.Windows.Forms` アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ <xref:System.Windows.Forms.WebBrowser.Print%2A>   
+ <xref:System.Windows.Forms.WebBrowser.Url%2A>   
+ [方法 : WebBrowser コントロールで URL に移動する](../../../../docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md)   
+ [方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md)   
+ [方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md)   
+ [WebBrowser コントロールの概要](../../../../docs/framework/winforms/controls/webbrowser-control-overview.md)   
+ [WebBrowser セキュリティ](../../../../docs/framework/winforms/controls/webbrowser-security.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-provide-a-toolbox-bitmap-for-a-control.md b/docs/framework/winforms/controls/how-to-provide-a-toolbox-bitmap-for-a-control.md
new file mode 100644
index 00000000000..8352352762d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-provide-a-toolbox-bitmap-for-a-control.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : コントロールにツールボックス ビットマップを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], カスタム コントロール"
+  - "カスタム コントロール [Windows フォーム], ツールボックスのビットマップ"
+  - "ツールボックス [Windows フォーム], 追加 (カスタム コントロール用のビットマップを)"
+ms.assetid: 0ed0840a-616d-41ba-a27d-3573241932ad
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : コントロールにツールボックス ビットマップを指定する
+コントロールの特殊なアイコンを**ツールボックス**に表示させる場合は、<xref:System.Drawing.ToolboxBitmapAttribute> を使用して特定のイメージを指定します。  このクラスは*属性*であり、他のクラスに追加できる特殊なクラスです。  属性の詳細については、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の場合は「[NOT IN BUILD: Attributes Overview in Visual Basic](http://msdn.microsoft.com/ja-jp/0d0cff64-892d-4f57-83bd-bef388553d4f)」、[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] の場合は「[属性](../Topic/Attributes%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+ <xref:System.Drawing.ToolboxBitmapAttribute> を使用すると、16 x 16 ピクセルのビットマップのパスとファイル名を示す文字列を指定できます。  コントロールを**ツールボックス**に追加すると、このビットマップがコントロールの横に表示されます。  また、<xref:System.Type> を指定して、特定の種類に関連付けられたビットマップを読み込むようにすることもできます。  <xref:System.Type> と文字列の両方を指定すると、コントロールは、<xref:System.Type> パラメーターで指定された種類のイメージが含まれるアセンブリから、文字列パラメーターで指定された名前のイメージ リソースを検索します。  
+  
+### コントロールにツールボックス ビットマップを指定するには  
+  
+1.  コントロールのクラス宣言に <xref:System.Drawing.ToolboxBitmapAttribute> を追加します。[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] の場合は `Class` キーワードの前に、[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] の場合はクラス宣言の上に追加します。  
+  
+    ```vb  
+    ' Specifies the bitmap associated with the Button type.  
+    <ToolboxBitmap(GetType(Button))> Class MyControl1  
+    ' Specifies a bitmap file.  
+    End Class  
+    <ToolboxBitmap("C:\Documents and Settings\Joe\MyPics\myImage.bmp")> _  
+       Class MyControl2  
+    End Class  
+    ' Specifies a type that indicates the assembly to search, and the name   
+    ' of an image resource to look for.  
+    <ToolboxBitmap(GetType(MyControl), "MyControlBitmap")> Class MyControl  
+    End Class  
+    ```  
+  
+    ```csharp  
+    // Specifies the bitmap associated with the Button type.  
+    [ToolboxBitmap(typeof(Button))]  
+    class MyControl1 : UserControl  
+    {  
+    }  
+    // Specifies a bitmap file.  
+    [ToolboxBitmap(@"C:\Documents and Settings\Joe\MyPics\myImage.bmp")]  
+    class MyControl2 : UserControl  
+    {  
+    }  
+    // Specifies a type that indicates the assembly to search, and the name   
+    // of an image resource to look for.  
+    [ToolboxBitmap(typeof(MyControl), "MyControlBitmap")]  
+    class MyControl : UserControl  
+    {  
+    }  
+    ```  
+  
+2.  プロジェクトを再ビルドします。  
+  
+    > [!NOTE]
+    >  自動的に生成されたコントロールとコンポーネントのビットマップがツールボックスに表示されません。  ビットマップを表示するには、**\[ツールボックス アイテムの選択\]** ダイアログ ボックスを使用してコントロールを再読み込みします。  詳細については、「[チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Drawing.ToolboxBitmapAttribute>   
+ [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)   
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)   
+ [Attributes](../Topic/Attributes%20\(Visual%20Basic\)1.md)   
+ [属性](../Topic/Attributes%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md b/docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md
new file mode 100644
index 00000000000..a783dda95ee
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : フォームに標準メニュー項目を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目, 標準"
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: 75db9126-e70c-4e81-921d-b83c0a4a9f50
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : フォームに標準メニュー項目を追加する
+フォームの標準のメニューを <xref:System.Windows.Forms.MenuStrip> コントロールに提供できます。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に、この機能の広範なサポートがあります。  
+  
+ 「[チュートリアル : 標準メニュー項目をフォームに用意する](http://msdn.microsoft.com/library/ms233662\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ <xref:System.Windows.Forms.MenuStrip> コントロールを使用して標準メニューを持つフォームを作成する方法を、次のコード例に示します。  メニュー項目の選択は、<xref:System.Windows.Forms.StatusStrip> コントロールに表示されます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.StandardMenu#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.StandardMenu#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md b/docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md
new file mode 100644
index 00000000000..0b68254733b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : 文字列に引用符を挿入する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "引用符"
+  - "引用符, 追加 (テキスト ボックスの文字列に)"
+  - "TextBox コントロール [Windows フォーム], 表示 (引用符を)"
+ms.assetid: 68bdc3f3-4177-4eab-99cd-cac17a82b515
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 文字列に引用符を挿入する (Windows フォーム)
+テキストの文字列への引用符 \(" "\) の挿入が必要となることがあります。  次に例を示します。  
+  
+ She said, "You deserve a treat\!"  
+  
+ 代わりに、<xref:Microsoft.VisualBasic.ControlChars.Quote> フィールドを定数として使用することもできます。  
+  
+### コードの文字列に引用符を挿入するには  
+  
+1.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では、引用符が 2 つ並んでいる場合、埋め込み引用符として解釈されます。  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] と [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] では、エスケープ シーケンス \\" が埋め込み引用符として解釈されます。  たとえば、上記の文字列を作成するには、次のコードを使用します。  
+  
+    ```vb  
+    Private Sub InsertQuote()  
+       TextBox1.Text = "She said, ""You deserve a treat!"" "  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void InsertQuote(){  
+       textBox1.Text = "She said, \"You deserve a treat!\" ";  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void InsertQuote()  
+       {  
+          textBox1->Text = "She said, \"You deserve a treat!\" ";  
+       }  
+    ```  
+  
+     または  
+  
+2.  引用符に相当する ASCII 文字または Unicode 文字を挿入します。  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では、ASCII 文字 \(34\) を使用します。  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] では、Unicode 文字 \(\\u0022\) を使用します。  
+  
+    ```vb  
+    Private Sub InsertAscii()  
+       TextBox1.Text = "She said, " & Chr(34) & "You deserve a treat!" & Chr(34)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void InsertAscii(){  
+       textBox1.Text = "She said, " + '\u0022' + "You deserve a treat!" + '\u0022';  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  この例で \\u0022 を使用することはできません。これは、基本文字セットの文字を指定するユニバーサル文字名を使用できないためです。  使用した場合は、C3851 が発生します。  詳細については、「[コンパイラ エラー C3851](../Topic/Compiler%20Error%20C3851.md)」を参照してください。  
+  
+     または  
+  
+3.  文字に定数を定義し、必要に応じて使用することもできます。  
+  
+    ```vb  
+    Const quote As String = """"  
+    TextBox1.Text = "She said, " & quote & "You deserve a treat!" & quote  
+  
+    ```  
+  
+    ```csharp  
+    const string quote = "\"";  
+    textBox1.Text = "She said, " + quote +  "You deserve a treat!"+ quote ;  
+  
+    ```  
+  
+    ```cpp  
+    const String^ quote = "\"";  
+    textBox1->Text = String::Concat("She said, ",  
+       const_cast<String^>(quote), "You deserve a treat!",  
+       const_cast<String^>(quote));  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ <xref:Microsoft.VisualBasic.ControlChars.Quote>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md b/docs/framework/winforms/controls/how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md
new file mode 100644
index 00000000000..6bd8c3cc999
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], 発生 (変更通知を)"
+  - "変更通知"
+  - "変更通知, 発生"
+  - "データ バインド, 変更通知"
+  - "データ ソース, 検出 (変更を)"
+ms.assetid: ab8b4096-37ff-4e30-aabc-de79a2f2e972
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる
+コントロールのデータ ソースの中には、項目が変更、追加、または削除されても変更通知が発生しないものがあります。  <xref:System.Windows.Forms.BindingSource> コンポーネントを使用すると、そのようなデータ ソースをバインドし、コードから変更通知を発生させることができます。  
+  
+## 使用例  
+ このフォームは、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用してリストを <xref:System.Windows.Forms.DataGridView> コントロールにバインドする方法を示しています。  リストは変更通知を発生しないため、リスト内の項目が変更されると、<xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.ResetItem%2A> メソッドが呼び出されます。  .  
+  
+ [!code-cpp[System.Windows.Forms.DataConnector.ResetItem#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetItem/CPP/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.DataConnector.ResetItem#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetItem/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnector.ResetItem#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetItem/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-reassign-existing-controls-to-a-different-parent.md b/docs/framework/winforms/controls/how-to-reassign-existing-controls-to-a-different-parent.md
new file mode 100644
index 00000000000..3a679357fe5
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-reassign-existing-controls-to-a-different-parent.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 既存のコントロールを別の親に再配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンテナー コントロール、Windows フォーム"
+  - "レイアウト [Windows フォーム]、サイズ変更"
+  - "レイアウト [Windows フォーム]、子コントロール"
+ms.assetid: 5a5723ff-34e0-4b6f-a57b-be4ebe35cb34
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 既存のコントロールを別の親に再配置する
+フォームに存在するコントロールを新しいコンテナー コントロールに割り当てることができます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。 詳細については、「[Visual Studio での開発設定のカスタマイズ](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 既存のコントロールを別の親に再配置するには  
+  
+1.  **\[ツールボックス\]** から 3 つの <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグします。  
+  
+     これらを互いに近づけて配置しますが、整列はさせません。  
+  
+2.  **\[ツールボックス\]** で <xref:System.Windows.Forms.FlowLayoutPanel> コントロール アイコンをクリックします。  
+  
+     アイコンはフォームにドラッグしないでください。  
+  
+3.  マウス ポインターを 3 つの <xref:System.Windows.Forms.Button> コントロールに近づけます。  
+  
+     ポインターが <xref:System.Windows.Forms.FlowLayoutPanel> コントロール アイコンが付いた十字カーソルに変わります。  
+  
+4.  マウス ボタンを押したままにします。  
+  
+5.  マウス ポインターをドラッグして、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールのアウトラインを描画します。  
+  
+6.  3 つの <xref:System.Windows.Forms.Button> コントロールを囲むようにアウトラインを描画します。  
+  
+7.  マウスのボタンを離します。  
+  
+     これで、3 つの <xref:System.Windows.Forms.Button> コントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに挿入されました。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-remove-a-toolstripmenuitem-from-an-mdi-drop-down-menu-windows-forms.md b/docs/framework/winforms/controls/how-to-remove-a-toolstripmenuitem-from-an-mdi-drop-down-menu-windows-forms.md
new file mode 100644
index 00000000000..7d50b1938d3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-remove-a-toolstripmenuitem-from-an-mdi-drop-down-menu-windows-forms.md
@@ -0,0 +1,112 @@
+---
+title: "方法 : ToolStripMenuItem を MDI ドロップダウン メニューから削除する (Windows フォーム)  | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, マージ (メニュー項目を)"
+  - "メニュー項目, 削除 (MDI ドロップダウン メニューから)"
+  - "MenuStrip コントロール [Windows フォーム], マージ"
+  - "MenuStrip コントロール [Windows フォーム], 削除"
+ms.assetid: bdafe60d-82ee-45bc-97fe-eeefca6e54c1
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ToolStripMenuItem を MDI ドロップダウン メニューから削除する (Windows フォーム) 
+アプリケーションの中には、マルチ ドキュメント インターフェイス \(MDI\) 子ウィンドウの種類が MDI 親ウィンドウと異なるものもあります。  たとえば、MDI 親がスプレッドシートで、MDI 子がグラフの場合があります。  そのような場合は、異なる種類の MDI 子ウィンドウがアクティブになったときに、MDI 子メニューの内容で MDI 親メニューの内容を更新する必要があります。  
+  
+ 次のプロシージャでは、<xref:System.Windows.Forms.Form.IsMdiContainer%2A>、<xref:System.Windows.Forms.ToolStrip.AllowMerge%2A>、<xref:System.Windows.Forms.MergeAction>、および <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> の各プロパティを使用して、メニュー項目を MDI 親メニューのドロップダウン部分から削除します。  MDI 子ウィンドウを閉じると、削除したメニュー項目が MDI 親メニューに復元されます。  
+  
+### MenuStrip を MDI ドロップダウン メニューから削除するには  
+  
+1.  フォームを作成し、その <xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定します。  
+  
+2.  <xref:System.Windows.Forms.MenuStrip> を `Form1` に追加し、<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> プロパティを `true` に設定します。  
+  
+3.  トップレベル メニュー項目をに追加し`Form1`<xref:System.Windows.Forms.MenuStrip>`&File` に <xref:System.Windows.Forms.Control.Text%2A> のプロパティを設定します。  
+  
+4.  3 つのサブメニュー項目を `&File` メニュー項目に追加し、それらの <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティをそれぞれ `&Open`、`&Import from`、および `E&xit` に設定します。  
+  
+5.  2 つのサブメニュー項目を `&Import from` サブメニュー項目に追加し、それらの <xref:System.Windows.Forms.ToolStripItem.Text%2A> プロパティをそれぞれ `&Word` と `&Excel` に設定します。  
+  
+6.  プロジェクトにフォームを追加しそのフォームに <xref:System.Windows.Forms.MenuStrip> を追加し`true` に `Form2`<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> のプロパティを設定します。  
+  
+7.  トップレベル メニュー項目をに追加し`Form2`<xref:System.Windows.Forms.MenuStrip>`&File` に <xref:System.Windows.Forms.ToolStripItem.Text%2A> のプロパティを設定します。  
+  
+8.  `&Import from` サブメニュー項目を `Form2` の `&File` メニューに追加し、`&Word` サブメニュー項目を `&File` メニューに追加します。  
+  
+9. 次の表に示すように、`Form2` メニュー項目の <xref:System.Windows.Forms.MergeAction> プロパティと <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> プロパティを設定します。  
+  
+    |Form2 メニュー項目|MergeAction 値|MergeIndex 値|  
+    |------------------|-------------------|------------------|  
+    |File|MatchOnly|\-1|  
+    |Import from|MatchOnly|\-1|  
+    |Word|\[削除\]|\-1|  
+  
+10. `Form1` では`&Open`<xref:System.Windows.Forms.ToolStripMenuItem> の <xref:System.Windows.Forms.Control.Click> のイベントのイベント ハンドラーを作成します。  
+  
+11. このイベント ハンドラー内に次のようなコード例を挿入し、`Form1` の MDI 子フォームとして `Form2` の新しいインスタンスを作成および表示します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles openToolStripMenuItem.Click  
+        Dim NewMDIChild As New Form2()  
+        'Set the parent form of the child window.  
+            NewMDIChild.MdiParent = Me  
+        'Display the new form.  
+            NewMDIChild.Show()  
+    End Sub  
+  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void openToolStripMenuItem_Click(object sender, EventArgs e)  
+    {  
+        Form2 newMDIChild = new Form2();  
+        // Set the parent form of the child window.  
+            newMDIChild.MdiParent = this;  
+        // Display the new form.  
+            newMDIChild.Show();  
+    }  
+  
+    ```  
+  
+12. 次のようなイベント ハンドラーを登録するに `&Open`<xref:System.Windows.Forms.ToolStripMenuItem> にコードを配置します。  
+  
+    ```vb  
+    Private Sub openToolStripMenuItem_Click(sender As Object, e As _  
+    EventArgs) Handles openToolStripMenuItem.Click  
+  
+    ```  
+  
+    ```csharp  
+    this.openToolStripMenuItem.Click += new _  
+    System.EventHandler(this.openToolStripMenuItem_Click);  
+  
+    ```  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `Form1` と `Form2` という名前の 2 つの <xref:System.Windows.Forms.Form> コントロール。  
+  
+-   `menuStrip1` という名前の `Form1` の <xref:System.Windows.Forms.MenuStrip> コントロール、および `menuStrip2` という名前の `Form2` の <xref:System.Windows.Forms.MenuStrip> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-remove-items-from-windows-forms-domainupdown-controls.md b/docs/framework/winforms/controls/how-to-remove-items-from-windows-forms-domainupdown-controls.md
new file mode 100644
index 00000000000..18030c37a4b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-remove-items-from-windows-forms-domainupdown-controls.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : Windows フォームの DomainUpDown コントロールから項目を削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DomainUpDown コントロール [Windows フォーム], 削除 (項目を)"
+  - "スピン ボタン コントロール, 削除 (項目を)"
+ms.assetid: e70f5cbc-b497-41a9-975a-344c00e56ed2
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの DomainUpDown コントロールから項目を削除する
+<xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection> クラスの <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Remove%2A> メソッドまたは <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.RemoveAt%2A> メソッドを呼び出すことにより、Windows フォームの <xref:System.Windows.Forms.DomainUpDown> コントロールから項目を削除できます。  <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Remove%2A> メソッドは、特定の項目を削除します。<xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.RemoveAt%2A> メソッドは、指定された位置の項目を削除します。  
+  
+### 項目を削除するには  
+  
+-   <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection> クラスの <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Remove%2A> メソッドを使用して、指定した名前の項目を削除します。  
+  
+    ```vb  
+    DomainUpDown1.Items.Remove("noodles")  
+  
+    ```  
+  
+    ```csharp  
+    domainUpDown1.Items.Remove("noodles");  
+  
+    ```  
+  
+    ```cpp  
+    domainUpDown1->Items->Remove("noodles");  
+    ```  
+  
+     または  
+  
+-   <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.RemoveAt%2A> メソッドを使用して、指定した位置の項目を削除します。  
+  
+    ```vb  
+    ' Removes the first item in the list.  
+    DomainUpDown1.Items.RemoveAt(0)  
+  
+    ```  
+  
+    ```csharp  
+    // Removes the first item in the list.  
+    domainUpDown1.Items.RemoveAt(0);  
+  
+    ```  
+  
+    ```cpp  
+    // Removes the first item in the list.  
+    domainUpDown1->Items->RemoveAt(0);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.DomainUpDown>   
+ <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.Remove%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DomainUpDown.DomainUpDownItemCollection.RemoveAt%2A?displayProperty=fullName>   
+ [DomainUpDown コントロール](../../../../docs/framework/winforms/controls/domainupdown-control-windows-forms.md)   
+ [DomainUpDown コントロールの概要](../../../../docs/framework/winforms/controls/domainupdown-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-render-a-visual-style-element.md b/docs/framework/winforms/controls/how-to-render-a-visual-style-element.md
new file mode 100644
index 00000000000..2c31c89a12b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-render-a-visual-style-element.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : visual スタイル要素を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロフェッショナルな外観, 適用 (Windows フォーム アプリケーションの要素に)"
+  - "視覚スタイル, 描画 (Windows フォーム コントロールの)"
+  - "ビジュアル テーマ, 適用 (Windows フォーム アプリケーションの要素に)"
+ms.assetid: a207781b-1baa-4ce9-b788-1e951bd4b5df
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : visual スタイル要素を描画する
+<xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> 名前空間は、visual スタイルによってサポートされている Windows のユーザー インターフェイス \(UI\) を表す <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> オブジェクトを公開します。  このトピックでは、\[スタート\] メニューの **\[ログオフ\]** ボタンと **\[シャットダウン\]** ボタンを表す <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> を描画する <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> クラスの使用法を説明します。  
+  
+### visual スタイル要素を描画するには  
+  
+1.  <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> を作成し、これを描画対象の要素に設定します。  <xref:System.Windows.Forms.Application.RenderWithVisualStyles%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer.IsElementDefined%2A?displayProperty=fullName> メソッドの使用に注意してください。visual スタイルが無効にされている、または要素が未定義の場合、<xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer.%23ctor%2A> コンストラクターは例外をスローします。  
+  
+     [!code-cpp[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#4](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/cpp/form1.cpp#4)]
+     [!code-csharp[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/CS/form1.cs#4)]
+     [!code-vb[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/VB/form1.vb#4)]  
+  
+2.  <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer.DrawBackground%2A> メソッドを呼び出して <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> が現在表す要素を描画します。  
+  
+     [!code-cpp[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#6](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/cpp/form1.cpp#6)]
+     [!code-csharp[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/CS/form1.cs#6)]
+     [!code-vb[System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.VisualStyles.VisualStyleRenderer_Simple/VB/form1.vb#6)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   <xref:System.Windows.Forms.Control> クラスから派生したカスタム コントロール。  
+  
+-   カスタム コントロールをホストする <xref:System.Windows.Forms.Form>。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Drawing?displayProperty=fullName>、<xref:System.Windows.Forms?displayProperty=fullName>、および <xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> の各名前空間への参照。  
+  
+## 参照  
+ [visual スタイルが使用されているコントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md b/docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md
new file mode 100644
index 00000000000..62c83c2f85e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : Windows フォーム上のコントロールのサイズを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Size.Height"
+  - "Size.Width"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], サイズ変更"
+  - "サイズ, コントロール"
+  - "Windows フォーム コントロール, サイズ"
+ms.assetid: d2dba441-a8c0-4705-b8e8-2e5d86d6e7ec
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム上のコントロールのサイズを変更する
+コントロールのサイズは個別に変更することも、複数のコントロールのサイズを変更することもできます。複数のコントロールのサイズ変更では、コントロールの種類 \(<xref:System.Windows.Forms.Button> コントロールと <xref:System.Windows.Forms.GroupBox> コントロールなど\) に関係なく変更できます。  
+  
+### コントロールのサイズを変更するには  
+  
+1.  サイズ変更するコントロールをクリックし、8 つのサイズ ハンドルのうちの 1 つをドラッグします。  
+  
+    > [!NOTE]
+    >  コントロールを選択し、Shift キーを押しならが方向キーを押してコントロールのサイズを一度に 1 ピクセルずつ変更します。  コントロールのサイズを大幅に変更するには、Shift キーと Ctrl キーを押しながら ↓ キーまたは → キーを押します。  
+  
+### フォームで複数のコントロールのサイズを変更するには  
+  
+1.  Ctrl キーまたは Shift キーを押して、サイズを変更するコントロールを選択します。  最初に選択したコントロールのサイズが他のコントロールに使用されます。  
+  
+2.  **\[書式\]** メニューの **\[同じサイズに揃える\]** を選択し、4 つのオプションのいずれかを選択します。  最初の 3 つのコマンドでは、最初に選択されたコントロールに合わせてコントロールの大きさが変更されます。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)   
+ [How to: Resize Windows Forms Using the Designer](http://msdn.microsoft.com/ja-jp/3fe57c94-851c-45d7-a6f6-6b85f3c4a104)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-respond-to-clicks-in-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-respond-to-clicks-in-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..612f914c1fb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-respond-to-clicks-in-the-windows-forms-datagrid-control.md
@@ -0,0 +1,153 @@
+---
+title: "方法 : Windows フォーム DataGrid コントロールのクリックに応答する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 位置 (DataGrid での)"
+  - "Click イベント, 監視 (DataGrid コントロール内で)"
+  - "DataGrid コントロール [Windows フォーム], クリック イベント"
+  - "DataGrid コントロール [Windows フォーム], 例"
+  - "DataGrid コントロール [Windows フォーム], 返す (クリックされたセル値を)"
+  - "例 [Windows フォーム], DataGrid コントロール"
+ms.assetid: a0aa204b-8351-4d82-9933-ee21a5c9e409
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム DataGrid コントロールのクリックに応答する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォーム <xref:System.Windows.Forms.DataGrid> がデータベースに接続された後は、ユーザーがクリックしたセルを監視できます。  
+  
+### DataGrid のユーザーが別のセルを選択したことを検出するには  
+  
+-   <xref:System.Windows.Forms.DataGrid.CurrentCellChanged> イベント ハンドラーに、適切な応答用コードを記述します。  
+  
+    ```vb  
+    Private Sub myDataGrid_CurrentCellChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles myDataGrid.CurrentCellChanged  
+       MessageBox.Show("Col is " & myDataGrid.CurrentCell.ColumnNumber _  
+          & ", Row is " & myDataGrid.CurrentCell.RowNumber _  
+          & ", Value is " & myDataGrid.Item(myDataGrid.CurrentCell))  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void myDataGrid_CurrentCellChanged(object sender,   
+    System.EventArgs e)  
+    {  
+       MessageBox.Show ("Col is " + myDataGrid.CurrentCell.ColumnNumber  
+          + ", Row is " + myDataGrid.CurrentCell.RowNumber   
+          + ", Value is " + myDataGrid[myDataGrid.CurrentCell] );  
+    }  
+    ```  
+  
+     \(Visual C\#\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.myDataGrid.CurrentCellChanged += new  
+       System.EventHandler(this.myDataGrid_CurrentCellChanged);  
+    ```  
+  
+### ユーザーが DataGrid のどの部分をクリックしたかを決定するには  
+  
+-   <xref:System.Windows.Forms.Control.MouseDown> イベントや <xref:System.Windows.Forms.Control.Click> イベントなどの適切なイベント ハンドラーで <xref:System.Windows.Forms.DataGrid.HitTest%2A> メソッドを呼び出します。  
+  
+     <xref:System.Windows.Forms.DataGrid.HitTest%2A> メソッドは、クリックされた領域の行と列を含む <xref:System.Windows.Forms.DataGrid.HitTestInfo> オブジェクトを返します。  
+  
+    ```vb  
+    Private Sub myDataGrid_MouseDown(ByVal sender As Object, _  
+    ByVal e As MouseEventArgs) Handles myDataGrid.MouseDown  
+       Dim myGrid As DataGrid = CType(sender, DataGrid)  
+       Dim hti As System.Windows.Forms.DataGrid.HitTestInfo  
+       hti = myGrid.HitTest(e.X, e.Y)  
+       Dim message As String = "You clicked "  
+  
+       Select Case hti.Type  
+          Case System.Windows.Forms.DataGrid.HitTestType.None  
+             message &= "the background."  
+          Case System.Windows.Forms.DataGrid.HitTestType.Cell  
+             message &= "cell at row " & hti.Row & ", col " & hti.Column  
+          Case System.Windows.Forms.DataGrid.HitTestType.ColumnHeader  
+             message &= "the column header for column " & hti.Column  
+          Case System.Windows.Forms.DataGrid.HitTestType.RowHeader  
+             message &= "the row header for row " & hti.Row  
+          Case System.Windows.Forms.DataGrid.HitTestType.ColumnResize  
+             message &= "the column resizer for column " & hti.Column  
+          Case System.Windows.Forms.DataGrid.HitTestType.RowResize  
+             message &= "the row resizer for row " & hti.Row  
+          Case System.Windows.Forms.DataGrid.HitTestType.Caption  
+             message &= "the caption"  
+          Case System.Windows.Forms.DataGrid.HitTestType.ParentRows  
+             message &= "the parent row"  
+       End Select  
+  
+       Console.WriteLine(message)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void myDataGrid_MouseDown(object sender,   
+    System.Windows.Forms.MouseEventArgs e)  
+    {  
+       DataGrid myGrid = (DataGrid) sender;  
+       System.Windows.Forms.DataGrid.HitTestInfo hti;  
+       hti = myGrid.HitTest(e.X, e.Y);  
+       string message = "You clicked ";  
+  
+       switch (hti.Type)   
+       {  
+          case System.Windows.Forms.DataGrid.HitTestType.None :  
+             message += "the background.";  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.Cell :  
+             message += "cell at row " + hti.Row + ", col " + hti.Column;  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.ColumnHeader :  
+             message += "the column header for column " + hti.Column;  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.RowHeader :  
+             message += "the row header for row " + hti.Row;  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.ColumnResize :  
+             message += "the column resizer for column " + hti.Column;  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.RowResize :  
+             message += "the row resizer for row " + hti.Row;  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.Caption :  
+             message += "the caption";  
+             break;  
+          case System.Windows.Forms.DataGrid.HitTestType.ParentRows :  
+             message += "the parent row";  
+             break;  
+          }  
+  
+          Console.WriteLine(message);  
+    }  
+    ```  
+  
+     \(Visual C\#\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.myDataGrid.MouseDown += new  
+       System.Windows.Forms.MouseEventHandler  
+       (this.myDataGrid_MouseDown);  
+    ```  
+  
+## 参照  
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)   
+ [方法 : Windows フォーム DataGrid コントロールに表示されるデータを実行時に変更する](../../../../docs/framework/winforms/controls/change-displayed-data-at-run-time-wf-datagrid-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md b/docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md
new file mode 100644
index 00000000000..a56086f4c6b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : Windows フォームのボタンのクリックに応答する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], クリックに対する応答"
+  - "ボタン, 応答 (Click イベントに)"
+  - "Click イベント, Button コントロール"
+  - "Click イベント, 応答"
+  - "ダブルクリック"
+  - "イベント [Windows フォーム], Click イベント"
+  - "例 [Windows フォーム], コントロール"
+  - "MouseDown イベント"
+ms.assetid: 7a4951bd-369c-4662-b246-28ad83eda484
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームのボタンのクリックに応答する
+Windows フォームの <xref:System.Windows.Forms.Button> コントロールの最も基本的な使用法は、ボタンがクリックされたときにコードを実行することです。  
+  
+ <xref:System.Windows.Forms.Button> コントロールをクリックすると、<xref:System.Windows.Forms.Control.MouseEnter>、<xref:System.Windows.Forms.Control.MouseDown>、<xref:System.Windows.Forms.Control.MouseUp> などのさまざまなイベントも生成されます。  これらの関連するイベントにイベント ハンドラーを割り当てる場合は、イベント ハンドラー間で処理内容が矛盾しないように注意してください。  たとえば、ボタンをクリックするとユーザーがテキスト ボックスに入力した情報がクリアされる場合は、ボタン上にマウス ポインターを重ねたときに、削除された情報のツール ヒントが表示されないようにします。  
+  
+ ユーザーが <xref:System.Windows.Forms.Button> コントロールをダブルクリックした場合、このコントロールではダブルクリック イベントがサポートされていないため、それぞれのクリックが個別に処理されます。  
+  
+### ボタン クリックに応答するには  
+  
+-   ボタンの `Click` <xref:System.EventHandler> に、実行するコードを記述します。  `Button1_Click` はコントロールにバインドする必要があります。  詳細については、「[方法 : Windows フォームで実行時にイベント ハンドラーを作成する](../../../../docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md)」を参照してください。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+       MessageBox.Show("Button1 was clicked")  
+    End Sub  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       MessageBox.Show("button1 was clicked");  
+    }  
+    ```  
+  
+    ```cpp#  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          MessageBox::Show("button1 was clicked");  
+       }  
+    ```  
+  
+## 参照  
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [Windows フォームの Button コントロールを選択する方法](../../../../docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md b/docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md
new file mode 100644
index 00000000000..96e067bf4bf
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md
@@ -0,0 +1,151 @@
+---
+title: "方法 : Windows フォーム CheckBox のクリックに応答する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック ボックス, 応答 (イベントへの)"
+  - "CheckBox コントロール [Windows フォーム], Click イベント"
+  - "Click イベント, CheckBox コントロール"
+  - "ダブルクリック"
+  - "イベント [Windows フォーム], Click イベント"
+ms.assetid: c39f901e-8899-43b6-aa31-939cbf7089fb
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム CheckBox のクリックに応答する
+ユーザーが Windows フォームの <xref:System.Windows.Forms.CheckBox> コントロールをクリックすると、<xref:System.Windows.Forms.Control.Click> イベントが発生します。  チェック ボックスの状態に応じてアクションを実行するように、アプリケーションをプログラミングできます。  
+  
+### CheckBox のクリックに応答するには  
+  
+1.  <xref:System.Windows.Forms.Control.Click> イベント ハンドラー内で <xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティを使用してコントロールの状態を判断し、必要なアクションを実行します。  
+  
+    ```vb  
+    Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click  
+       ' The CheckBox control's Text property is changed each time the   
+       ' control is clicked, indicating a checked or unchecked state.  
+       If CheckBox1.Checked = True Then  
+          CheckBox1.Text = "Checked"  
+       Else  
+          CheckBox1.Text = "Unchecked"  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void checkBox1_Click(object sender, System.EventArgs e)  
+    {  
+       // The CheckBox control's Text property is changed each time the   
+       // control is clicked, indicating a checked or unchecked state.  
+       if (checkBox1.Checked)  
+       {  
+          checkBox1.Text = "Checked";  
+       }  
+       else  
+       {  
+          checkBox1.Text = "Unchecked";  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void checkBox1_CheckedChanged(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          if (checkBox1->Checked)  
+          {  
+             checkBox1->Text = "Checked";  
+          }  
+          else  
+          {  
+             checkBox1->Text = "Unchecked";  
+          }  
+       }  
+    ```  
+  
+    > [!NOTE]
+    >  ユーザーが <xref:System.Windows.Forms.CheckBox> コントロールをダブルクリックした場合、<xref:System.Windows.Forms.CheckBox> コントロールではダブルクリック イベントがサポートされていないため、それぞれのクリックが個別に処理されます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.CheckBox.AutoCheck%2A> プロパティが `true` \(既定\) に設定されている場合、<xref:System.Windows.Forms.CheckBox> をクリックすると、自動的にオンまたはオフになります。  それ以外の場合は、<xref:System.Windows.Forms.Control.Click> イベントの発生時に手動で <xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティを設定する必要があります。  
+  
+     また、<xref:System.Windows.Forms.CheckBox> コントロールを使用して、アクションの実行方法を決めることもできます。  
+  
+### チェック ボックスがクリックされた状態に応じて、アクションの実行方法を決定するには  
+  
+1.  case ステートメントを使用して <xref:System.Windows.Forms.CheckBox.CheckState%2A> プロパティの値を問い合わせ、アクションの実行方法を決定します。  <xref:System.Windows.Forms.CheckBox.ThreeState%2A> プロパティが `true` に設定されている場合、<xref:System.Windows.Forms.CheckBox.CheckState%2A> プロパティは、ボックスがオンの状態、ボックスがオフの状態、および中間状態を表す 3 つの値のいずれかを返します。中間状態では、ボックスが淡色表示されてオプションが無効であることが示されます。  
+  
+    ```vb  
+    Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click  
+       Select Case CheckBox1.CheckState  
+          Case CheckState.Checked  
+             ' Code for checked state.  
+          Case CheckState.Unchecked  
+             ' Code for unchecked state.  
+          Case CheckState.Indeterminate  
+             ' Code for indeterminate state.  
+       End Select   
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void checkBox1_Click(object sender, System.EventArgs e)  
+    {  
+       switch(checkBox1.CheckState)  
+       {  
+          case CheckState.Checked:  
+             // Code for checked state.  
+             break;  
+          case CheckState.Unchecked:  
+             // Code for unchecked state.  
+             break;  
+          case CheckState.Indeterminate:  
+             // Code for indeterminate state.  
+             break;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void checkBox1_CheckedChanged(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          switch(checkBox1->CheckState) {  
+             case CheckState::Checked:  
+                // Code for checked state.  
+                break;  
+             case CheckState::Unchecked:  
+                // Code for unchecked state.  
+                break;  
+             case CheckState::Indeterminate:  
+                // Code for indeterminate state.  
+                break;  
+          }  
+       }  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.CheckBox.ThreeState%2A> プロパティに `true` が設定されている場合、<xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティは <xref:System.Windows.Forms.CheckState> と <xref:System.Windows.Forms.CheckState> の両方に対して `true` を返します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.CheckBox>   
+ [CheckBox コントロールの概要](../../../../docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォームの CheckBox コントロールでオプションを設定する](../../../../docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md)   
+ [CheckBox コントロール](../../../../docs/framework/winforms/controls/checkbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md b/docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md
new file mode 100644
index 00000000000..682e175c90e
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : バックグラウンドで操作を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "バックグラウンド スレッド"
+  - "BackgroundWorker クラス, 例"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+ms.assetid: 5b56e2aa-dc05-444f-930c-2d7b23f9ad5b
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : バックグラウンドで操作を実行する
+完了に長い時間がかかる操作を実行しており、ユーザー インターフェイスで遅延が発生しないようにするには<xref:System.ComponentModel.BackgroundWorker> クラスを使用して別のスレッドで操作を実行できます。  
+  
+ 次のコード例は、バック グラウンドで時間のかかる操作を実行する方法を示します。  フォームに **\[開始\]** ボタンと **\[キャンセル\]** ボタンがあります。  非同期操作を実行するには、**\[開始\]** ボタンをクリックします。  実行中の非同期操作を停止するには、**\[キャンセル\]** ボタンをクリックします。  各操作の結果は、<xref:System.Windows.Forms.MessageBox> に表示されます。  
+  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] では、このタスクに対する広範なサポートが用意されています。  
+  
+ 「[チュートリアル : 操作をバックグラウンドで実行する](http://msdn.microsoft.com/library/ms233672\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.ComponentModel.BackgroundWorker.Example#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#1)]
+ [!code-vb[System.ComponentModel.BackgroundWorker.Example#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ <xref:System.ComponentModel.DoWorkEventArgs>   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-save-files-using-the-savefiledialog-component.md b/docs/framework/winforms/controls/how-to-save-files-using-the-savefiledialog-component.md
new file mode 100644
index 00000000000..8928f69b2dc
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-save-files-using-the-savefiledialog-component.md
@@ -0,0 +1,190 @@
+---
+title: "方法 : SaveFileDialog コンポーネントを使用してファイルを保存する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ファイル, 保存"
+  - "OpenFile メソッド, 保存 (ファイルを SaveFileDialog コンポーネントで)"
+  - "SaveFileDialog コンポーネント, 保存 (ファイルを)"
+  - "保存 (ファイルを)"
+ms.assetid: 02e8f409-b83f-4707-babb-e71f6b223d90
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : SaveFileDialog コンポーネントを使用してファイルを保存する
+<xref:System.Windows.Forms.SaveFileDialog> コンポーネントを使用すると、ユーザーはファイル システムを参照し、保存するファイルを選択できます。  このダイアログ ボックスは、ユーザーがダイアログ ボックス内で選択したファイルのパスと名前を返します。  ただし、ファイルを実際にディスクに書き込むためのコードを記述する必要があります。  
+  
+### SaveFileDialog コンポーネントを使用してファイルを保存するには  
+  
+-   **\[ファイルの保存\]** ダイアログ ボックスを表示し、ユーザーによって選択されたファイルを保存するメソッドを呼び出します。  
+  
+     <xref:System.Windows.Forms.SaveFileDialog> コンポーネントの <xref:System.Windows.Forms.SaveFileDialog.OpenFile%2A> メソッドを使用して、ファイルを保存します。  このメソッドにより、書き込み先となる <xref:System.IO.Stream> オブジェクトが提供されます。  
+  
+     次のコード例では、<xref:System.Windows.Forms.DialogResult> プロパティを使用してファイルの名前を取得し、<xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドを使用してファイルを保存しています。  <xref:System.Windows.Forms.SaveFileDialog.OpenFile%2A> メソッドにより、ファイルの書き込み先となるストリームが提供されます。  
+  
+     次のコード例では、<xref:System.Windows.Forms.Button> コントロールにイメージが割り当てられています。  このボタンをクリックすると、ファイルの種類として .gif、.jpeg、および .bmp を許可するフィルターと共に、<xref:System.Windows.Forms.SaveFileDialog> コンポーネントがインスタンス化されます。  \[ファイルの保存\] ダイアログ ボックスでこれらの種類のファイルが選択されると、ボタンのイメージが保存されます。  
+  
+    > [!IMPORTANT]
+    >  <xref:System.Windows.Forms.FileDialog.FileName%2A> プロパティを取得または設定するには、アセンブリに対して、<xref:System.Security.Permissions.FileIOPermission?displayProperty=fullName> クラスから特権レベルが与えられている必要があります。  完全には信頼できないコンテキストでプロセスを実行している場合は、権限不足のため例外がスローされることがあります。  詳細については、「[コード アクセス セキュリティの基礎](../../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+     この例のコードは、フォームに <xref:System.Windows.Forms.Button> コントロールがあり、その <xref:System.Windows.Forms.ButtonBase.Image%2A> プロパティが .gif、.jpeg、または .bmp のファイルに設定されていることを想定して書かれています。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.FileDialog> クラスの <xref:System.Windows.Forms.FileDialog.FilterIndex%2A> プロパティ \(継承により <xref:System.Windows.Forms.SaveFileDialog> クラスの一部\) では、1 から始まるインデックスが使用されます。  これは、ファイルをバイナリ形式ではなくプレーン テキストで保存する場合など、データを特定の形式で保存するコードを記述する場合に重要です。  このプロパティは、次のコード例に示されています。  
+  
+    ```vb  
+    Private Sub Button2_Click(ByVal sender As System.Object, _  
+    ByVal e As System.EventArgs) Handles Button2.Click  
+       ' Displays a SaveFileDialog so the user can save the Image  
+       ' assigned to Button2.  
+       Dim saveFileDialog1 As New SaveFileDialog()  
+       saveFileDialog1.Filter = "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif"  
+       saveFileDialog1.Title = "Save an Image File"  
+       saveFileDialog1.ShowDialog()  
+  
+       ' If the file name is not an empty string open it for saving.  
+       If saveFileDialog1.FileName <> "" Then  
+          ' Saves the Image via a FileStream created by the OpenFile method.  
+          Dim fs As System.IO.FileStream = Ctype _  
+             (saveFileDialog1.OpenFile(), System.IO.FileStream)  
+          ' Saves the Image in the appropriate ImageFormat based upon the  
+          ' file type selected in the dialog box.  
+          ' NOTE that the FilterIndex property is one-based.  
+          Select Case saveFileDialog1.FilterIndex  
+             Case 1  
+                Me.button2.Image.Save(fs, _  
+                   System.Drawing.Imaging.ImageFormat.Jpeg)  
+  
+             Case 2  
+                Me.button2.Image.Save(fs, _  
+                   System.Drawing.Imaging.ImageFormat.Bmp)  
+  
+             Case 3  
+                Me.button2.Image.Save(fs, _  
+                   System.Drawing.Imaging.ImageFormat.Gif)  
+           End Select  
+  
+           fs.Close()  
+        End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button2_Click(object sender, System.EventArgs e)  
+    {  
+       // Displays a SaveFileDialog so the user can save the Image  
+       // assigned to Button2.  
+       SaveFileDialog saveFileDialog1 = new SaveFileDialog();  
+       saveFileDialog1.Filter = "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif";  
+       saveFileDialog1.Title = "Save an Image File";  
+       saveFileDialog1.ShowDialog();  
+  
+       // If the file name is not an empty string open it for saving.  
+       if(saveFileDialog1.FileName != "")  
+       {  
+          // Saves the Image via a FileStream created by the OpenFile method.  
+          System.IO.FileStream fs =   
+             (System.IO.FileStream)saveFileDialog1.OpenFile();  
+          // Saves the Image in the appropriate ImageFormat based upon the  
+          // File type selected in the dialog box.  
+          // NOTE that the FilterIndex property is one-based.  
+          switch(saveFileDialog1.FilterIndex)  
+          {  
+             case 1 :   
+             this.button2.Image.Save(fs,   
+                System.Drawing.Imaging.ImageFormat.Jpeg);  
+             break;  
+  
+             case 2 :   
+             this.button2.Image.Save(fs,   
+                System.Drawing.Imaging.ImageFormat.Bmp);  
+             break;  
+  
+             case 3 :   
+             this.button2.Image.Save(fs,   
+                System.Drawing.Imaging.ImageFormat.Gif);  
+             break;  
+          }  
+  
+       fs.Close();  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       System::Void button2_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          // Displays a SaveFileDialog so the user can save the Image  
+          // assigned to Button2.  
+          SaveFileDialog ^ saveFileDialog1 = new SaveFileDialog();  
+          saveFileDialog1->Filter =   
+             "JPeg Image|*.jpg|Bitmap Image|*.bmp|Gif Image|*.gif";  
+          saveFileDialog1->Title = "Save an Image File";  
+          saveFileDialog1->ShowDialog();  
+          // If the file name is not an empty string, open it for saving.  
+          if(saveFileDialog1->FileName != "")  
+          {  
+             // Saves the Image through a FileStream created by  
+             // the OpenFile method.  
+             System::IO::FileStream ^ fs =   
+                safe_cast<System::IO::FileStream*>(  
+                saveFileDialog1->OpenFile());  
+             // Saves the Image in the appropriate ImageFormat based on  
+             // the file type selected in the dialog box.  
+             // Note that the FilterIndex property is one based.  
+             switch(saveFileDialog1->FilterIndex)  
+             {  
+                case 1 :  
+                   this->button2->Image->Save(fs,  
+                      System::Drawing::Imaging::ImageFormat::Jpeg);  
+                   break;  
+                case 2 :  
+                   this->button2->Image->Save(fs,   
+                      System::Drawing::Imaging::ImageFormat::Bmp);  
+                   break;  
+                case 3 :  
+                   this->button2->Image->Save(fs,   
+                      System::Drawing::Imaging::ImageFormat::Gif);  
+                   break;  
+             }  
+          fs->Close();  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button2.Click += new System.EventHandler(this.button2_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button2->Click += gcnew  
+       System::EventHandler(this, &Form1::button2_Click);  
+    ```  
+  
+     ファイル ストリームの書き込みの詳細については、「[FileStream.BeginWrite メソッド](frlrfSystemIOFileStreamClassBeginWriteTopic)」および「[FileStream.Write メソッド](https://msdn.microsoft.com/en-us/library/system.io.filestream.write.aspx)」を参照してください。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.RichTextBox> コントロールなど、一部のコントロールには、ファイルを保存する機能があります。  詳細については、MSDN オンライン ライブラリの技術文書「[Essential Code for Windows Forms Dialog Boxes](http://go.microsoft.com/fwlink/?LinkID=102575)」の「SaveFileDialog Component」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SaveFileDialog>   
+ [SaveFileDialog コンポーネント](../../../../docs/framework/winforms/controls/savefiledialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-save-files-with-the-windows-forms-richtextbox-control.md b/docs/framework/winforms/controls/how-to-save-files-with-the-windows-forms-richtextbox-control.md
new file mode 100644
index 00000000000..0d0a9662853
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-save-files-with-the-windows-forms-richtextbox-control.md
@@ -0,0 +1,101 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールを使用してファイルを保存する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - ".rtf ファイル, 保存 (RichTextBox コントロールで)"
+  - "例 [Windows フォーム], テキスト ボックス"
+  - "ファイル, 保存 (RichTextBox コントロールを使用して)"
+  - "RichTextBox コントロール [Windows フォーム], 保存 (ファイルを)"
+  - "RTF ファイル, 保存 (RichTextBox コントロールで)"
+  - "保存 (ファイルを)"
+  - "保存 (ファイルを), RichTextBox コントロール"
+  - "テキスト ファイル, 保存 (RichTextBox コントロールから)"
+ms.assetid: 4a58ec19-84d1-4383-9110-298c06adcfca
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームの RichTextBox コントロールを使用してファイルを保存する
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールでは、表示している情報を次のいずれかの形式でファイルに書き込むことができます。  
+  
+-   書式なしテキスト  
+  
+-   Unicode の書式なしテキスト  
+  
+-   リッチ テキスト形式 \(RTF: Rich Text Format\)  
+  
+-   OLE オブジェクトをスペースに置き換えた RTF  
+  
+-   OLE オブジェクトをテキストで表示した書式なしテキスト  
+  
+ ファイルを保存するには、<xref:System.Windows.Forms.RichTextBox.SaveFile%2A> メソッドを呼び出します。  また、**SaveFile** メソッドを使用してストリームにデータを保存することもできます。  詳細については、<xref:System.Windows.Forms.RichTextBox.SaveFile%28System.IO.Stream%2CSystem.Windows.Forms.RichTextBoxStreamType%29> のトピックを参照してください。  
+  
+### コントロールの内容をファイルに保存するには  
+  
+1.  保存するファイルのパスを決定します。  
+  
+     実際のアプリケーションでこれを行うには、通常、<xref:System.Windows.Forms.SaveFileDialog> コンポーネントを使用します。  概要については、「[SaveFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md)」を参照してください。  
+  
+2.  保存するファイルと、必要に応じてファイルの種類を指定して、<xref:System.Windows.Forms.RichTextBox> コントロールの <xref:System.Windows.Forms.RichTextBox.SaveFile%2A> メソッドを呼び出します。  引数にファイル名だけを指定してメソッドを呼び出すと、ファイルは RTF として保存されます。  別の種類のファイルを指定するには、2 番目の引数として <xref:System.Windows.Forms.RichTextBoxStreamType> 列挙型の値を指定します。  
+  
+     次の例では、リッチ テキスト ファイルの場所に対するパスとして **My Documents** フォルダーが設定されています。  この場所を使用するのは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、この場所を選択すると、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例は、既に <xref:System.Windows.Forms.RichTextBox> コントロールが追加されたフォームを想定しています。  
+  
+    ```vb  
+    Public Sub SaveFile()  
+       ' You should replace the bold file name in the   
+       ' sample below with a file name of your own choosing.  
+       RichTextBox1.SaveFile(System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Testdoc.rtf", _  
+          RichTextBoxStreamType.RichNoOleObjs)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void SaveFile()  
+    {  
+       // You should replace the bold file name in the   
+       // sample below with a file name of your own choosing.  
+       // Note the escape character used (@) when specifying the path.  
+       richTextBox1.SaveFile(System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Testdoc.rtf",  
+          RichTextBoxStreamType.RichNoOleObjs);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void SaveFile()  
+       {  
+          // You should replace the bold file name in the   
+          // sample below with a file name of your own choosing.  
+          richTextBox1->SaveFile(String::Concat  
+             (System::Environment::GetFolderPath  
+             (System::Environment::SpecialFolder::Personal),  
+             "\\Testdoc.rtf"), RichTextBoxStreamType::RichNoOleObjs);  
+       }  
+    ```  
+  
+    > [!IMPORTANT]
+    >  次のコード例では、ファイルが存在しない場合は新規にファイルを作成します。  アプリケーションでファイルを作成する必要がある場合は、フォルダーに対してファイルの作成アクセスが必要です。  アクセス許可は、アクセス制御リストを使用して設定します。  ファイルが既に存在する場合、アプリケーションに必要なのは、より低い権限である書き込みアクセス許可だけです。  可能な場合は、配置時にファイルを作成し、フォルダーにはファイルの作成アクセスを許可せず、1 つのファイルだけに読み取りアクセスを許可する方が安全です。  また、ルート フォルダーや Program Files フォルダーにデータを書き込むよりも、ユーザー フォルダーに書き込む方が安全です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox.SaveFile%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md b/docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md
new file mode 100644
index 00000000000..04e5f6e91af
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "予定表, 選択 (日付の範囲を)"
+  - "日付, 選択 (予定表コントロールから範囲を)"
+  - "例 [Windows フォーム], 予定表コントロール"
+  - "MonthCalendar コントロール [Windows フォーム], 選択 (日付の範囲を)"
+ms.assetid: 95d9ab95-b0f8-4c19-9f63-b5cd4593a5d0
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する
+ユーザーが日付の範囲を選択できる機能は、Windows フォームの <xref:System.Windows.Forms.MonthCalendar> コントロールが備える重要な機能です。  この機能は、単一の日付\/時間の値しか選択できない <xref:System.Windows.Forms.DateTimePicker> コントロールの日付選択機能を改善したものです。  <xref:System.Windows.Forms.MonthCalendar> コントロールのプロパティを使用すると、日付の範囲を設定したり、ユーザーが設定した選択範囲を取得できます。  選択範囲を設定する方法を次のコード例に示します。  
+  
+### 日付の範囲を選択するには  
+  
+1.  範囲内の最初の日付と最後の日付を表す <xref:System.DateTime> オブジェクトをそれぞれ作成します。  
+  
+    ```vb  
+    Dim projectStart As Date = New DateTime(2001, 2, 13)  
+    Dim projectEnd As Date = New DateTime(2001, 2, 28)  
+    ```  
+  
+    ```csharp  
+    DateTime projectStart = new DateTime(2001, 2, 13);  
+    DateTime projectEnd = new DateTime(2001, 2, 28);  
+    ```  
+  
+    ```cpp  
+    DateTime projectStart = DateTime(2001, 2, 13);  
+    DateTime projectEnd = DateTime(2001, 2, 28);  
+    ```  
+  
+2.  <xref:System.Windows.Forms.MonthCalendar.SelectionRange%2A> プロパティを設定します。  
+  
+    ```vb  
+    MonthCalendar1.SelectionRange = New SelectionRange(projectStart, projectEnd)  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.SelectionRange = new SelectionRange(projectStart, projectEnd);  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->SelectionRange = gcnew  
+       SelectionRange(projectStart, projectEnd);  
+    ```  
+  
+     または  
+  
+     <xref:System.Windows.Forms.MonthCalendar.SelectionStart%2A> プロパティおよび <xref:System.Windows.Forms.MonthCalendar.SelectionEnd%2A> プロパティを設定します。  
+  
+    ```vb  
+    MonthCalendar1.SelectionStart = projectStart  
+    MonthCalendar1.SelectionEnd = projectEnd  
+    ```  
+  
+    ```csharp  
+    monthCalendar1.SelectionStart = projectStart;  
+    monthCalendar1.SelectionEnd = projectEnd;  
+    ```  
+  
+    ```cpp  
+    monthCalendar1->SelectionStart = projectStart;  
+    monthCalendar1->SelectionEnd = projectEnd;  
+    ```  
+  
+## 参照  
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールの外観を変更する](../../../../docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する](../../../../docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md)   
+ [方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する](../../../../docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-select-an-item-in-the-windows-forms-listview-control.md b/docs/framework/winforms/controls/how-to-select-an-item-in-the-windows-forms-listview-control.md
new file mode 100644
index 00000000000..327c62713d4
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-select-an-item-in-the-windows-forms-listview-control.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : Windows フォーム ListView コントロール内の項目を選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ビュー, 選択 (項目の)"
+  - "一覧, 選択 (項目の)"
+  - "ListView コントロール [Windows フォーム], 選択 (項目の)"
+  - "選択, リスト ビュー内で"
+ms.assetid: ddea918e-1ddf-47f4-bd09-1e9b4c9d0c39
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Windows フォーム ListView コントロール内の項目を選択する
+次のコード例では、Windows フォームの <xref:System.Windows.Forms.ListView> コントロール内の項目をプログラムで選択します。  項目をプログラムで選択しても、フォーカスは自動的に <xref:System.Windows.Forms.ListView> コントロールには変更されません。  そのため、項目を選択するときは、通常、その項目をフォーカスがある状態に設定します。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.ListView.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ListView.Misc/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.ListView.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ListView.Misc/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   1 つ以上の項目を持つ、`listView1` という名前の <xref:System.Windows.Forms.ListView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> 名前空間および <xref:System.Windows.Forms?displayProperty=fullName> 名前空間への参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ <xref:System.Windows.Forms.ListViewItem.Selected%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md b/docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md
new file mode 100644
index 00000000000..abb53244a1f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : Windows フォーム TextBox コントロールでテキストを選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト ボックス, 選択 (プログラムを使用してテキストを)"
+  - "テキスト, 選択 (テキスト ボックスでプログラムを使用して)"
+  - "TextBox コントロール [Windows フォーム], 選択 (プログラムを使用してテキストを)"
+ms.assetid: 8c591546-6a01-45c7-8e03-f78431f903b1
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 方法 : Windows フォーム TextBox コントロールでテキストを選択する
+Windows フォーム <xref:System.Windows.Forms.TextBox> コントロールを使用すると、プログラムによってテキストを選択できます。  たとえば、テキストの特定の文字列を検索する関数を作成した場合は、テキストを選択し、検索した文字列の位置を視覚的に示すことができます。  
+  
+### プログラムによってテキストを選択するには  
+  
+1.  <xref:System.Windows.Forms.TextBoxBase.SelectionStart%2A> プロパティに、選択するテキストの開始位置を設定します。  
+  
+     <xref:System.Windows.Forms.TextBoxBase.SelectionStart%2A> プロパティは、テキスト文字列内のカーソル位置を示す数値であり、0 は左端の位置を表します。  <xref:System.Windows.Forms.TextBoxBase.SelectionStart%2A> プロパティにテキスト ボックスの文字数以上の値を設定した場合、カーソル位置は最後の文字の後に配置されます。  
+  
+2.  <xref:System.Windows.Forms.TextBoxBase.SelectionLength%2A> プロパティに、選択するテキストの長さを設定します。  
+  
+     <xref:System.Windows.Forms.TextBoxBase.SelectionLength%2A> プロパティは、カーソル位置からの選択範囲の長さを設定する数値です。  <xref:System.Windows.Forms.TextBoxBase.SelectionLength%2A> に 0 より大きい値を設定すると、現在のカーソル位置を基点とした文字数が選択されます。  
+  
+3.  \(省略可能\) <xref:System.Windows.Forms.TextBoxBase.SelectedText%2A> プロパティを使用して、選択したテキストにアクセスします。  
+  
+     次のコードを使用すると、コントロールの <xref:System.Windows.Forms.Control.Enter> イベントが発生したときに、テキスト ボックスの内容が選択されます。  この例では、テキスト ボックスの <xref:System.Windows.Forms.TextBox.Text%2A> プロパティの値が `null` または空の文字列でないかどうかを確認しています。  テキスト ボックスにフォーカスが移ると、テキスト ボックスの現在のテキストが選択されます。  `TextBox1_Enter` イベント ハンドラーは、コントロールにバインドする必要があります。詳細については、「[方法 : Windows フォームで実行時にイベント ハンドラーを作成する](../../../../docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md)」を参照してください。  
+  
+     この例をテストするには、テキスト ボックスにフォーカスが移るまで Tab キーを押します。  テキスト ボックス内をクリックすると、テキストの選択が解除されます。  
+  
+    ```vb  
+    Private Sub TextBox1_Enter(ByVal sender As Object, ByVal e As System.EventArgs) Handles TextBox1.Enter  
+       If (Not String.IsNullOrEmpty(TextBox1.Text)) Then  
+          TextBox1.SelectionStart = 0  
+          TextBox1.SelectionLength = TextBox1.Text.Length  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void textBox1_Enter(object sender, System.EventArgs e){  
+       if (!String.IsNullOrEmpty(textBox1.Text))  
+       {  
+          textBox1.SelectionStart = 0;  
+          textBox1.SelectionLength = textBox1.Text.Length;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void textBox1_Enter(System::Object ^ sender,  
+          System::EventArgs ^ e) {  
+       if (!System::String::IsNullOrEmpty(textBox1->Text))  
+       {  
+          textBox1->SelectionStart = 0;  
+          textBox1->SelectionLength = textBox1->Text->Length;  
+       }  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..9dd29e79db1
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 行のスタイル"
+  - "DataGridView コントロール [Windows フォーム], 行のスタイル"
+  - "行, データ グリッド"
+ms.assetid: 699ef759-458c-426d-ac87-7c7e71b018ae
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する
+表形式のデータは、多くの場合、行の背景色が交互に別の色になった、帳簿のような形式でユーザーに表示されます。  この形式を使用すると、多数の列がある幅の広いテーブルで、ユーザーが各行にあるセルを簡単に識別できるようになります。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールを使用すると、1 行おきの完全なスタイル情報を指定できます。  これにより、背景色だけでなく、前景色とフォントなどのスタイルの特性を使用して、交互の行を区別することができます。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](http://msdn.microsoft.com/library/3z9sk148\(v=vs.110\))」も参照してください。  
+  
+### 交互の行のスタイルをプログラムで設定する  
+  
+-   <xref:System.Windows.Forms.DataGridView> の <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A> プロパティと <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A> プロパティにより返される <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトのプロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#068](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#068)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#068](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#068)]  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A> プロパティと <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A> プロパティを使用して指定したスタイルは、列と <xref:System.Windows.Forms.DataGridView> のレベルで指定されたスタイルをオーバーライドしますが、個別の行とセルのレベルで設定されたスタイルによってオーバーライドされます。  詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Drawing?displayProperty=fullName>、および <xref:System.Windows.Forms?displayProperty=fullName> の各アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ 最大限のスケーラビリティを実現するには、各要素のスタイルのプロパティを個別に設定するのではなく、同じスタイルを使用する複数の行、列、またはセルで <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを共有してください。  詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md b/docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md
new file mode 100644
index 00000000000..8e6be8acc78
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-and-return-dates-with-the-windows-forms-datetimepicker-control.md
@@ -0,0 +1,86 @@
+---
+title: "方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "日付, 設定 (DateTimePicker の)"
+  - "DateTimePicker コントロール [Windows フォーム], 設定と取得 (日付の)"
+  - "例 [Windows フォーム], DateTimePicker コントロール"
+ms.assetid: a8a48d68-e4b5-426e-9764-51230fc9acd2
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォームの DateTimePicker コントロールを使用して日付を設定および取得する
+Windows フォーム <xref:System.Windows.Forms.DateTimePicker> コントロールで現在選択されている日付または時刻は、<xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティによって決定されます。  コントロールが表示される前 \(デザイン時またはフォームの <xref:System.Windows.Forms.Form.Load> イベントなど\) に <xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティを設定して、コントロールで最初に選択される日付を決定します。  既定では、コントロールの <xref:System.Windows.Forms.DateTimePicker.Value%2A> は現在の日付に設定されます。  コントロールの <xref:System.Windows.Forms.DateTimePicker.Value%2A> をコードで変更するには、フォームでコントロールが新しい設定を反映するよう自動的に更新されます。  
+  
+ <xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティは、値として <xref:System.DateTime> 構造を返します。  表示される日付に関する特定の情報を返す <xref:System.DateTime> 構造のプロパティはいくつかあります。  これらのプロパティは値を返す貯めにのみ使用でき、値の設定には使用しません。  
+  
+-   日付値の場合、<xref:System.DateTime.Month%2A>、<xref:System.DateTime.Day%2A>、および <xref:System.DateTime.Year%2A> の各プロパティは、選択した日付の時間単位の整数値を返します。  <xref:System.DateTime.DayOfWeek%2A> プロパティは、選択した日の曜日を示す値を返します \(指定できる値は <xref:System.DayOfWeek> 列挙型にリストされます\)。  
+  
+-   時間値の場合、<xref:System.DateTime.Hour%2A>、<xref:System.DateTime.Minute%2A>、<xref:System.DateTime.Second%2A>、および <xref:System.DateTime.Millisecond%2A> の各プロパティは、時間単位の整数値を返します。  時間を表示するコントロールを構成するには、「[方法 : DateTimePicker コントロールを使用して時間を表示する](../../../../docs/framework/winforms/controls/how-to-display-time-with-the-datetimepicker-control.md)」を参照してください。  
+  
+### コントロールの日付と時刻の値を設定するには  
+  
+-   <xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティを日付または時刻の値に設定します。  
+  
+    ```vb  
+    DateTimePicker1.Value = New DateTime(2001, 10, 20)  
+  
+    ```  
+  
+    ```csharp  
+    dateTimePicker1.Value = new DateTime(2001, 10, 20);  
+  
+    ```  
+  
+    ```cpp  
+    dateTimePicker1->Value = DateTime(2001, 10, 20);  
+    ```  
+  
+### 日付と時刻の値を返すには  
+  
+-   <xref:System.Windows.Forms.DateTimePicker.Text%2A> プロパティを呼び出して、コントロールで書式設定する全体の値を返すか、または <xref:System.Windows.Forms.DateTimePicker.Value%2A> プロパティの適切なメソッドを呼び出して、値の一部を返します。  <xref:System.Windows.Forms.DateTimePicker.ToString%2A> を使用して、ユーザーに表示される文字列に情報を変換します。  
+  
+    ```vb  
+    MessageBox.Show("The selected value is ", DateTimePicker1.Text)  
+    MessageBox.Show("The day of the week is ",   
+       DateTimePicker1.Value.DayOfWeek.ToString)  
+    MessageBox.Show("Millisecond is: ",   
+       DateTimePicker1.Value.Millisecond.ToString)  
+  
+    ```  
+  
+    ```csharp  
+    MessageBox.Show ("The selected value is " +   
+       dateTimePicker1.Text);  
+    MessageBox.Show ("The day of the week is " +   
+       dateTimePicker1.Value.DayOfWeek.ToString());  
+    MessageBox.Show("Millisecond is: " +   
+       dateTimePicker1.Value.Millisecond.ToString());  
+  
+    ```  
+  
+    ```cpp  
+    MessageBox::Show (String::Concat("The selected value is ",  
+       dateTimePicker1->Text));  
+    MessageBox::Show (String::Concat("The day of the week is ",  
+       dateTimePicker1->Value.DayOfWeek.ToString()));  
+    MessageBox::Show(String::Concat("Millisecond is: ",  
+       dateTimePicker1->Value.Millisecond.ToString()));  
+    ```  
+  
+## 参照  
+ [DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)   
+ [方法 : Windows フォームの DateTimePicker コントロールを使用してカスタム形式で日付を表示する](../../../../docs/framework/winforms/controls/display-a-date-in-a-custom-format-with-wf-datetimepicker-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..ef5f22ed12b
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, スタイル"
+  - "データ グリッド, セル スタイル"
+  - "DataGridView コントロール [Windows フォーム], セル スタイル"
+ms.assetid: 1aaaca43-5340-447e-99c0-9177d9776aa1
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する
+<xref:System.Windows.Forms.DataGridView> コントロールを使用して、コントロール全体、および特定の列と行の既定のセル スタイルを指定できます。  これらは既定でフィルターを下に移動し、コントロール レベルから列レベルへ、次に行レベルへ、その次にセル レベルへ移動します。  特定の <xref:System.Windows.Forms.DataGridViewCellStyle> プロパティがセル レベルで設定されていないと、行レベルで既定のプロパティの設定が使用されます。  行レベルでもプロパティが設定されていない場合、既定の列の設定が使用されます。  最後に、列レベルでもプロパティが設定されていない場合、既定の <xref:System.Windows.Forms.DataGridView> の設定が使用されます。  この設定により、複数のレベルでプロパティの設定を複製する必要がなくなります。  各レベルでは、上位のレベルとは異なるスタイルだけを指定します。  詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ Visual Studio では、このタスクに対する広範なサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する](http://msdn.microsoft.com/library/95y5fz2x\(v=vs.110\))」も参照してください。  
+  
+### 既定値のセル スタイルをプログラムで設定するには  
+  
+1.  <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティによって取得された <xref:System.Windows.Forms.DataGridViewCellStyle> のプロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#141](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#141)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#141](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#141)]  
+  
+2.  複数の行と列によって使用される新しい <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを作成して初期化します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#142](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#142)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#142](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#142)]  
+  
+3.  特定の行と列の `DefaultCellStyle` プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#143](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#143)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#143](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#143)]  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#140](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#140)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#140](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#140)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Drawing?displayProperty=fullName>、および <xref:System.Windows.Forms?displayProperty=fullName> の各アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ 非常に大きなデータ セットを処理するときに最大限のスケーラビリティを実現するには、各要素のスタイルのプロパティを個別に設定するのではなく、同じスタイルを使用する複数の行、列、またはセルで <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを共有してください。  さらに、<xref:System.Windows.Forms.DataGridViewRowCollection.SharedRow%2A?displayProperty=fullName> プロパティを使用して、共有された行を作成してアクセスする必要があります。  詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.DefaultCellStyle%2A?displayProperty=fullName>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-alternating-row-styles-for-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..753d58782ed
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 色のスタイル"
+  - "データ グリッド, カスタマイズ (セルを)"
+  - "データ グリッド, フォント スタイル"
+  - "DataGridView コントロール [Windows フォーム], セルのカスタマイズ"
+ms.assetid: 588f2c57-d963-41b1-9c1d-d02d71818113
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する
+<xref:System.Windows.Forms.DataGridViewCellStyle> クラスのプロパティを設定して、<xref:System.Windows.Forms.DataGridView> コントロール内のセルの外観を指定できます。  <xref:System.Windows.Forms.DataGridView> クラスとコンパニオン クラスのさまざまなプロパティからこのクラスのインスタンスを取得することも、これらのプロパティの割り当てに <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトをインスタンス化することもできます。  
+  
+ 次の手順は、<xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A> プロパティを使用したセルの外観の基本的なカスタマイズを示します。  コントロール内のすべてのセルは、列、行、またはセル レベルでオーバーライドされるのでない限り、このプロパティで指定されたスタイルを継承します。  スタイルの継承の例については、「[方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)」を参照してください。  <xref:System.Windows.Forms.DataGridViewCellStyle> クラスのその他の使用方法については、\[参照\] セクションの各トピックを参照してください。  
+  
+ Visual Studio では、このタスクに対する広範なサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する](http://msdn.microsoft.com/library/95y5fz2x\(v=vs.110\))」も参照してください。  
+  
+### DataGridView セルで使用されるフォントを指定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.Font%2A> プロパティを設定します。  次のコード例では、コントロール全体のフォントを設定する <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#101](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#101)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#101](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#101)]  
+  
+### DataGridView セルの前景色と背景色を指定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A> プロパティと <xref:System.Windows.Forms.DataGridViewCellStyle.BackColor%2A> プロパティを設定します。  次のコード例では、コントロール全体にこれらのスタイルを設定する <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#102](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#102)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#102](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#102)]  
+  
+### 選択された DataGridView セルの前景色と背景色を指定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.SelectionForeColor%2A> プロパティと <xref:System.Windows.Forms.DataGridViewCellStyle.SelectionBackColor%2A> プロパティを設定します。  次のコード例では、コントロール全体にこれらのスタイルを設定する <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName> プロパティを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#103](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#103)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#103](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#103)]  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#100)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#100)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Drawing?displayProperty=fullName>、および <xref:System.Windows.Forms?displayProperty=fullName> の各アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ 最大限のスケーラビリティを実現するには、各要素のスタイルのプロパティを個別に設定するのではなく、同じスタイルを使用する複数の行、列、またはセルで <xref:System.Windows.Forms.DataGridViewCellStyle> オブジェクトを共有してください。  詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView.DefaultCellStyle%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md b/docs/framework/winforms/controls/how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md
new file mode 100644
index 00000000000..f0dc452abd6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールのフォント属性を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - ".rtf ファイル, 書式指定 (RichTextBox コントロールで)"
+  - "フォント, 変更 (RichTextBox コントロールの属性を)"
+  - "書式設定 [Windows フォーム]"
+  - "RichTextBox コントロール [Windows フォーム], 設定 (フォント属性を)"
+  - "RTF ファイル, 書式指定 (RichTextBox コントロールで)"
+  - "テキスト [Windows フォーム]"
+  - "テキスト ボックス, 書式設定 (テキストの)"
+ms.assetid: 2bc23ddb-0529-4489-a1a2-ad253cb43f9a
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームの RichTextBox コントロールのフォント属性を設定する
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールには、表示するテキストの書式を設定する数多くのオプションがあります。  <xref:System.Windows.Forms.RichTextBox.SelectionFont%2A> プロパティを使用して、選択した文字を太字や斜体にしたり、下線を付けたりできます。  また、このプロパティを使用して、選択した文字のサイズやタイプフェイスも変更できます。  <xref:System.Windows.Forms.RichTextBox.SelectionColor%2A> プロパティを使用すると、選択した文字の色を変更できます。  
+  
+### 文字の外観を変更するには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.SelectionFont%2A> プロパティに適切なフォントを設定します。  
+  
+     アプリケーションでユーザーがフォント ファミリ、サイズ、およびタイプフェイスを設定できるようにするには、通常、<xref:System.Windows.Forms.FontDialog> コンポーネントを使用します。  概要については、「[FontDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/fontdialog-component-overview-windows-forms.md)」を参照してください。  
+  
+2.  <xref:System.Windows.Forms.RichTextBox.SelectionColor%2A> プロパティに適切な色を設定します。  
+  
+     アプリケーションでユーザーが色を設定できるようにするには、通常、<xref:System.Windows.Forms.ColorDialog> コンポーネントを使用します。  概要については、「[ColorDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/colordialog-component-overview-windows-forms.md)」を参照してください。  
+  
+    ```vb  
+    RichTextBox1.SelectionFont = New Font("Tahoma", 12, FontStyle.Bold)  
+    RichTextBox1.SelectionColor = System.Drawing.Color.Red  
+  
+    ```  
+  
+    ```csharp  
+    richTextBox1.SelectionFont = new Font("Tahoma", 12, FontStyle.Bold);  
+    richTextBox1.SelectionColor = System.Drawing.Color.Red;  
+  
+    ```  
+  
+    ```cpp  
+    richTextBox1->SelectionFont =  
+       gcnew System::Drawing::Font("Tahoma", 12, FontStyle::Bold);  
+    richTextBox1->SelectionColor = System::Drawing::Color::Red;  
+    ```  
+  
+    > [!NOTE]
+    >  これらのプロパティは、選択したテキストだけに適用されます。テキストが選択されていない場合は、現在のカーソル位置に入力されるテキストに適用されます。  テキストをプログラムで選択する方法については、「[Select メソッド](frlrfSystemWindowsFormsTextBoxBaseClassSelectTopic)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-grid-options-for-all-windows-forms.md b/docs/framework/winforms/controls/how-to-set-grid-options-for-all-windows-forms.md
new file mode 100644
index 00000000000..4af6a394a2a
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-grid-options-for-all-windows-forms.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : すべての Windows フォームにグリッド オプションを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グリッド, オプション (Windows フォームの)"
+  - "合わせる (グリッドに), Windows フォーム デザイナー"
+  - "スナップ線, Windows フォーム デザイナー"
+  - "Windows フォーム デザイナー"
+  - "Windows フォーム, グリッド オプション (デザイナーの)"
+ms.assetid: 36967466-1dfd-4fae-a7f1-7bf2cbc94048
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : すべての Windows フォームにグリッド オプションを設定する
+[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] の開発環境に慣れてくると、Windows フォーム デザイナーで使用するすべてのフォームおよびプロジェクトに基本設定ができるようになります。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### グローバルな Windows フォーム オプションを設定するには  
+  
+1.  **\[ツール\]** メニューの **\[オプション\]** をクリックします。  
+  
+2.  **\[オプション\]** ダイアログ ボックスの左ペインで、**\[Windows フォーム デザイナー\]** をクリックします。  
+  
+     右ペインの **\[レイアウト設定\]** 見出しの下で、作成するすべての新しいフォームに対して、既定のグリッドを設定できます。  この設定には、グリッドのサイズの設定が含まれます。また、コントロールをグリッドにスナップするかどうか、既定でグリッドを表示するかどうかなどの設定も含まれます。  また、**\[SnapToGrid\]** レイアウト モードと **\[SnapLines\]** レイアウト モードのいずれかを選択できます。  スナップ線の詳細については、「[チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)」を参照してください。  
+  
+## 参照  
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [General, Windows Forms Designer, Options Dialog Box](http://msdn.microsoft.com/ja-jp/8dd170af-72f0-4212-b04b-034ceee92834)   
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [方法 : Windows フォーム上のタブ オーダーを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-tab-order-on-windows-forms.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md b/docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md
new file mode 100644
index 00000000000..001697cd59c
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : Windows フォーム TreeView コントロールのアイコンを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], TreeView コントロール"
+  - "アイコン, 設定 (TreeView コントロールの)"
+  - "ImageList コンポーネント [Windows フォーム], 追加 (イメージを)"
+  - "ツリー ノード (TreeView コントロールの), アイコン"
+  - "TreeView コントロール [Windows フォーム], ノード アイコン"
+ms.assetid: c14ddcc0-e5a6-4c21-a2d5-6799fd491781
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム TreeView コントロールのアイコンを設定する
+Windows フォーム <xref:System.Windows.Forms.TreeView> \(ツリー ビュー\) コントロールでは、各ノードの横にアイコンを表示できます。  アイコンは、ノードのテキストのすぐ左に表示されます。  アイコンを表示するには、ツリー ビューに <xref:System.Windows.Forms.ImageList> コントロールを関連付ける必要があります。  イメージ リストの詳細については、「[ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)」および「[方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)」を参照してください。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.1 のバグによって、アプリケーションから <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> を呼び出すときに、画像が <xref:System.Windows.Forms.TreeView> ノードに表示されません。  このバグに対処するには、<xref:System.Windows.Forms.Application.EnableVisualStyles%2A> の呼び出し直後に `Main` メソッドで <xref:System.Windows.Forms.Application.DoEvents%2A?displayProperty=fullName> を呼び出します。  このバグは、[!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] で修正されています。  
+  
+### ツリー ビューにイメージを表示するには  
+  
+1.  <xref:System.Windows.Forms.TreeView> コントロールの <xref:System.Windows.Forms.TreeView.ImageList%2A> プロパティを使用する既存の <xref:System.Windows.Forms.ImageList> コントロールに設定します。  
+  
+     これらのプロパティは、デザイナーの \[プロパティ\] ウィンドウで設定するか、またはコードで設定できます。  
+  
+    ```vb  
+    TreeView1.ImageList = ImageList1  
+  
+    ```  
+  
+    ```csharp  
+    treeView1.ImageList = imageList1;  
+  
+    ```  
+  
+    ```cpp  
+    treeView1->ImageList = imageList1;  
+    ```  
+  
+2.  ノードの <xref:System.Windows.Forms.TreeNode.ImageIndex%2A> プロパティと <xref:System.Windows.Forms.TreeNode.SelectedImageIndex%2A> を設定します。  <xref:System.Windows.Forms.TreeNode.ImageIndex%2A> プロパティは、ノードが通常の状態のときや展開された状態のときに表示されるイメージを決定します。<xref:System.Windows.Forms.TreeNode.SelectedImageIndex%2A> プロパティは、ノードが選択された状態のときに表示されるイメージを決定します。  
+  
+     これらのプロパティは、コードで設定するか、または TreeNode エディターで設定できます。  TreeNode エディターを開くには、\[プロパティ\] ウィンドウの <xref:System.Windows.Forms.TreeView.Nodes%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+    ```vb  
+    ' (Assumes that ImageList1 contains at least two images and  
+    ' the TreeView control contains a selected image.)  
+    TreeView1.SelectedNode.ImageIndex = 0  
+    TreeView1.SelectedNode.SelectedImageIndex = 1  
+  
+    ```  
+  
+    ```csharp  
+    // (Assumes that imageList1 contains at least two images and  
+    // the TreeView control contains a selected image.)  
+    treeView1.SelectedNode.ImageIndex = 0;  
+    treeView1.SelectedNode.SelectedImageIndex = 1;  
+  
+    ```  
+  
+    ```cpp  
+    // (Assumes that imageList1 contains at least two images and  
+    // the TreeView control contains a selected image.)  
+    treeView1->SelectedNode->ImageIndex = 0;  
+    treeView1->SelectedNode->SelectedImageIndex = 1;  
+    ```  
+  
+## 参照  
+ [TreeView コントロールの概要](../../../../docs/framework/winforms/controls/treeview-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](../../../../docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md)   
+ [方法 : クリックされた TreeView ノードを判別する](../../../../docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md b/docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md
new file mode 100644
index 00000000000..009ab65de44
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-options-with-windows-forms-checkbox-controls.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : Windows フォームの CheckBox コントロールでオプションを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "checked"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェック ボックス, 使用 (オプションを設定するために)"
+  - "CheckBox コントロール [Windows フォーム], オンの状態"
+  - "CheckBox コントロール [Windows フォーム], 使用 (オプションを設定するために)"
+ms.assetid: 2ac70498-7e3e-4e07-8901-ccabaeb5fd3e
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの CheckBox コントロールでオプションを設定する
+Windows フォームの <xref:System.Windows.Forms.CheckBox> コントロールは、ユーザーが "True\/False" または "Yes\/No" のオプションを選択できるようにするために使用します。  選択したオプションにはチェック マークが付きます。  
+  
+### CheckBox コントロールでオプションを設定するには  
+  
+1.  <xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティの値を確認して状態を判断し、その値を使用してオプションを設定します。  
+  
+     次のコード例では、<xref:System.Windows.Forms.CheckBox> コントロールの <xref:System.Windows.Forms.CheckBox.CheckedChanged> イベントが発生したときにチェック ボックスがオンであれば、フォームの <xref:System.Windows.Forms.Control.AllowDrop%2A> プロパティが `false` に設定されます。  この機能は、ユーザーの操作を制限する必要がある場合に便利です。  
+  
+    ```vb  
+    Private Sub CheckBox1_CheckedChanged(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged  
+       ' Determine the CheckState of the check box.  
+       If CheckBox1.CheckState = CheckState.Checked Then  
+          ' If checked, do not allow items to be dragged onto the form.  
+          Me.AllowDrop = False  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void checkBox1_CheckedChanged(object sender, System.EventArgs e)  
+    {  
+       // Determine the CheckState of the check box.  
+       if (checkBox1.CheckState == CheckState.Checked)   
+       {  
+          // If checked, do not allow items to be dragged onto the form.  
+          this.AllowDrop = false;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void checkBox1_CheckedChanged(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          // Determine the CheckState of the check box.  
+          if (checkBox1->CheckState == CheckState::Checked)   
+          {  
+             // If checked, do not allow items to be dragged onto the form.  
+             this->AllowDrop = false;  
+          }  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.CheckBox>   
+ [CheckBox コントロールの概要](../../../../docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム CheckBox のクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-checkbox-clicks.md)   
+ [CheckBox コントロール](../../../../docs/framework/winforms/controls/checkbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md b/docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md
new file mode 100644
index 00000000000..71f2e4ee8c2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md
@@ -0,0 +1,115 @@
+---
+title: "方法 : 実行時にピクチャを設定する (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ビットマップ [Windows フォーム], 表示 (PictureBox コントロール内に) [Windows フォーム]"
+  - "例 [Windows フォーム], PictureBox コントロール"
+  - "イメージ [Windows フォーム], PictureBox コントロールの追加 [Windows フォーム]"
+  - "PictureBox コントロール [Windows フォーム], 追加 (イメージを)"
+  - "PictureBox コントロール [Windows フォーム], 追加 (ピクチャを)"
+  - "ピクチャ, 設定 (表示を)"
+ms.assetid: 18ca41d0-68a5-4660-985e-a6c1fbc01d76
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 実行時にピクチャを設定する (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PictureBox> コントロールで表示されるイメージをプログラムで設定できます。  
+  
+### プログラムによってピクチャを設定するには  
+  
+-   <xref:System.Drawing.Image> クラスの <xref:System.Drawing.Image.FromFile%2A> メソッドを使用して <xref:System.Windows.Forms.PictureBox.Image%2A> プロパティを設定します。  
+  
+     次の例では、イメージの場所に対するパスとして **My Documents** フォルダーが設定されています。  これは、Windows オペレーティング システムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。  また、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次の例は、既に <xref:System.Windows.Forms.PictureBox> コントロールが追加されたフォームを想定しています。  
+  
+    ```vb  
+    Private Sub LoadNewPict()  
+       ' You should replace the bold image   
+       ' in the sample below with an icon of your own choosing.  
+       PictureBox1.Image = Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.Personal) _  
+       & "\Image.gif")  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void LoadNewPict(){  
+       // You should replace the bold image   
+       // in the sample below with an icon of your own choosing.  
+       // Note the escape character used (@) when specifying the path.  
+       pictureBox1.Image = Image.FromFile  
+       (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Image.gif");  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void LoadNewPict()  
+       {  
+          // You should replace the bold image   
+          // in the sample below with an icon of your own choosing.  
+          pictureBox1->Image = Image::FromFile(String::Concat(  
+             System::Environment::GetFolderPath(  
+             System::Environment::SpecialFolder::Personal),  
+             "\\Image.gif"));  
+       }  
+    ```  
+  
+### グラフィックを消去するには  
+  
+-   最初にイメージによって使用されているメモリを解放してから、グラフィックを消去します。  メモリ管理で問題が発生した場合は、後でガベージ コレクションがメモリを解放します。  
+  
+    ```vb  
+    If Not (PictureBox1.Image Is Nothing) Then  
+       PictureBox1.Image.Dispose()  
+       PictureBox1.Image = Nothing  
+    End If  
+  
+    ```  
+  
+    ```csharp  
+    if (pictureBox1.Image != null)   
+    {  
+       pictureBox1.Image.Dispose();  
+       pictureBox1.Image = null;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    if (pictureBox1->Image != nullptr)  
+    {  
+       pictureBox1->Image->Dispose();  
+       pictureBox1->Image = nullptr;  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Drawing.Image.Dispose%2A> メソッドをこのように使用する理由の詳細については、「[Cleaning Up Unmanaged Resources](../../../../docs/standard/garbage-collection/unmanaged.md)」を参照してください。  
+  
+     このコードによって、デザイン時にコントロールにグラフィックが読み込まれた場合もイメージが消去されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PictureBox>   
+ <xref:System.Drawing.Image.FromFile%2A?displayProperty=fullName>   
+ [PictureBox コントロールの概要](../../../../docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md)   
+ [方法 : デザイナーを使用してピクチャを読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md)   
+ [方法 : 実行時にピクチャのサイズまたは配置を変更する](../../../../docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)   
+ [PictureBox コントロール](../../../../docs/framework/winforms/controls/picturebox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md b/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md
new file mode 100644
index 00000000000..f5bd5ee5aa2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : デザイナーを使って Windows フォーム パネルの背景を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "背景色, Windows フォーム Panel コントロール"
+  - "背景イメージ, Windows フォーム Panel コントロール"
+  - "色, Windows フォーム Panel コントロール"
+  - "Panel コントロール [Windows フォーム], バックグラウンド"
+ms.assetid: db83cf54-3c69-4b08-ac6c-25b9b5abb1b0
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : デザイナーを使って Windows フォーム パネルの背景を設定する
+Windows フォーム <xref:System.Windows.Forms.Panel> コントロールでは、背景色と背景イメージの両方を表示できます。  ラベルやオプション ボタンなど、パネルに含まれるコントロールの背景色を設定するには、<xref:System.Windows.Forms.Control.BackColor%2A> プロパティを使用します。  <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定していない場合は、<xref:System.Windows.Forms.Control.BackColor%2A> で選択した色でパネルが完全に塗りつぶされます。  <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定している場合は、パネルに含まれるコントロールの背景にイメージが表示されます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.Panel> コントロールが含まれているフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### Windows フォーム デザイナーで背景を設定するには  
+  
+1.  <xref:System.Windows.Forms.Panel> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.BackColor%2A> プロパティの横にある矢印をクリックして、3 つのタブを含むウィンドウを表示します。  
+  
+3.  **\[カスタム\]** タブをクリックして、カラー パレットを表示します。  
+  
+4.  **\[Web\]** タブまたは **\[システム\]** タブをクリックして、定義済みの色名の一覧を表示し、そこから色を選択します。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティの横にある矢印ボタンをクリックします。  
+  
+6.  **\[リソースの選択\]** ダイアログ ボックスで、表示するファイルを選択します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.BackColor%2A>   
+ <xref:System.Windows.Forms.Control.BackgroundImage%2A>   
+ [Panel コントロール](../../../../docs/framework/winforms/controls/panel-control-windows-forms.md)   
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)   
+ [方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する](../../../../docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md b/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md
new file mode 100644
index 00000000000..28df4ab3993
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : Windows フォーム パネルの背景を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "背景色, Windows フォーム Panel コントロール"
+  - "背景イメージ, Windows フォーム Panel コントロール"
+  - "色, Windows フォーム Panel コントロール"
+  - "Panel コントロール [Windows フォーム], バックグラウンド"
+ms.assetid: 096cbd8d-45cc-47b8-b1ef-a27f60ea8be0
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム パネルの背景を設定する
+Windows フォーム <xref:System.Windows.Forms.Panel> コントロールでは、背景色と背景イメージの両方を表示できます。  ラベルやオプション ボタンなど、表示されるコントロールの背景色を設定するには、<xref:System.Windows.Forms.Control.BackColor%2A> プロパティを使用します。  <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定していない場合は、<xref:System.Windows.Forms.Control.BackColor%2A> で選択した色でパネル全体が塗りつぶされます。  <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定している場合は、コントロールの背景にイメージが表示されます。  
+  
+### プログラムによって背景を設定するには  
+  
+1.  パネルの <xref:System.Windows.Forms.Control.BackColor%2A> プロパティに <xref:System.Drawing.Color?displayProperty=fullName> 型の値を設定します。  
+  
+    ```vb  
+    Panel1.BackColor = Color.AliceBlue  
+  
+    ```  
+  
+    ```csharp  
+    panel1.BackColor = Color.AliceBlue;  
+  
+    ```  
+  
+    ```cpp  
+    panel1->BackColor = Color::AliceBlue;  
+    ```  
+  
+2.  <xref:System.Drawing.Image?displayProperty=fullName> クラスの <xref:System.Drawing.Image.FromFile%2A> メソッドを使用して、パネルの <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定します。  
+  
+    ```vb  
+    ' You should replace the bolded image   
+    ' in the sample below with an image of your own choosing.  
+    Panel1.BackgroundImage = Image.FromFile _  
+        (System.Environment.GetFolderPath _  
+        (System.Environment.SpecialFolder.Personal) _  
+        & "\Image.gif")  
+  
+    ```  
+  
+    ```csharp  
+    // You should replace the bolded image   
+    // in the sample below with an image of your own choosing.  
+    // Note the escape character used (@) when specifying the path.  
+    panel1.BackgroundImage = Image.FromFile  
+       (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.Personal)  
+       + @"\Image.gif");  
+  
+    ```  
+  
+    ```cpp  
+    // You should replace the bolded image   
+    // in the sample below with an image of your own choosing.  
+    panel1->BackgroundImage = Image::FromFile(String::Concat(  
+       System::Environment::GetFolderPath  
+       (System::Environment::SpecialFolder::Personal),  
+       "\\Image.gif"));  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.BackColor%2A>   
+ <xref:System.Windows.Forms.Control.BackgroundImage%2A>   
+ [Panel コントロール](../../../../docs/framework/winforms/controls/panel-control-windows-forms.md)   
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md b/docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md
new file mode 100644
index 00000000000..90d71597916
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォームの NumericUpDown コントロールの書式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "NumericUpDown コントロール [Windows フォーム], 書式指定 (値を)"
+  - "アップダウン コントロール, 書式設定 (数値を)"
+ms.assetid: fa7c5557-6bfb-45b2-975d-8887b23b0ba0
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの NumericUpDown コントロールの書式を設定する
+Windows フォームの <xref:System.Windows.Forms.NumericUpDown> コントロールで値をどのように表示するかを設定できます。  <xref:System.Windows.Forms.NumericUpDown.DecimalPlaces%2A> プロパティは、小数点以下の桁数を指定します。既定値は 0 です。  <xref:System.Windows.Forms.NumericUpDown.ThousandsSeparator%2A> プロパティは、10 進値の 3 桁ごとに区切り記号を挿入するかどうかを指定します。既定値は `false` です。  <xref:System.Windows.Forms.NumericUpDown.Hexadecimal%2A> プロパティが `true` の場合、コントロールの値は 10 進形式ではなく 16 進形式で表示されます。既定では `false` です。  
+  
+### 数値の形式を指定するには  
+  
+-   <xref:System.Windows.Forms.NumericUpDown.DecimalPlaces%2A> プロパティを整数に設定し、<xref:System.Windows.Forms.NumericUpDown.ThousandsSeparator%2A> プロパティを `true` または `false` に設定して、10 進の値を表示します。  
+  
+    ```vb  
+    NumericUpDown1.DecimalPlaces = 2  
+    NumericUpDown1.ThousandsSeparator = True  
+  
+    ```  
+  
+    ```csharp  
+    numericUpDown1.DecimalPlaces = 2;  
+    numericUpDown1.ThousandsSeparator = true;  
+  
+    ```  
+  
+    ```cpp  
+    numericUpDown1->DecimalPlaces = 2;  
+    numericUpDown1->ThousandsSeparator = true;  
+    ```  
+  
+     または  
+  
+-   <xref:System.Windows.Forms.NumericUpDown.Hexadecimal%2A> プロパティを `true` に設定して、16 進の値を表示します。  
+  
+    ```vb  
+    NumericUpDown1.Hexadecimal = True  
+  
+    ```  
+  
+    ```csharp  
+    numericUpDown1.Hexadecimal = true;  
+  
+    ```  
+  
+    ```cpp  
+    numericUpDown1->Hexadecimal = true;  
+    ```  
+  
+    > [!NOTE]
+    >  フォーム上の値が 16 進で表示されている場合でも、<xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティに対して実行するテストはすべて 10 進の値をテストします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.NumericUpDown>   
+ [NumericUpDown コントロール](../../../../docs/framework/winforms/controls/numericupdown-control-windows-forms.md)   
+ [NumericUpDown コントロールの概要](../../../../docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control-using-the-designer.md
new file mode 100644
index 00000000000..350dc765311
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control-using-the-designer.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム コントロールによって表示されるイメージを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], イメージ"
+  - "コントロール [Windows フォーム], イメージ"
+  - "例 [Windows フォーム], コントロール"
+  - "イメージ [Windows フォーム], Windows フォーム コントロール"
+  - "設定 (イメージを), Windows フォーム コントロール"
+  - "Windows フォーム コントロール, イメージ"
+ms.assetid: ae80d07a-e469-4251-90ca-df71f5852454
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : デザイナーを使用して Windows フォーム コントロールによって表示されるイメージを設定する
+いくつかの Windows フォーム コントロールは、イメージを表示できます。  イメージの例としては、ボタン上のフロッピー ディスクのアイコンが **\[上書き保存\]** コマンドを示すように、コントロールの目的を明確にするアイコンがあります。  また、コントロールに特定の外観を与えるための背景イメージとしてのアイコンもあります。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールによって表示されるイメージを設定するには  
+  
+1.  **\[プロパティ\]** ウィンドウで、コントロールの **\[Image\]** または **\[BackgroundImage\]** プロパティを選択し、省略記号ボタン \(  
+  
+     ![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")  
+  
+     \) をクリックして **\[リソースの選択\]** ダイアログ ボックスを表示します。  
+  
+2.  表示するイメージを選択します。  
+  
+## 参照  
+ <xref:System.Drawing.Image.FromFile%2A>   
+ <xref:System.Drawing.Image>   
+ <xref:System.Windows.Forms.Control.BackgroundImage%2A>   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md b/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md
new file mode 100644
index 00000000000..2c949ad1b82
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : Windows フォーム コントロールによって表示されるイメージを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], イメージ"
+  - "コントロール [Windows フォーム], イメージ"
+  - "例 [Windows フォーム], コントロール"
+  - "イメージ [Windows フォーム], Windows フォーム コントロール"
+  - "Windows フォーム コントロール, イメージ"
+ms.assetid: 9445af8f-4f62-48b0-a3f6-068058964b9f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム コントロールによって表示されるイメージを設定する
+いくつかの Windows フォーム コントロールは、イメージを表示できます。  イメージの例としては、ボタン上のフロッピー ディスクのアイコンが**\[上書き保存\]** コマンドを示すように、コントロールの目的を明確にするアイコンがあります。  また、コントロールに特定の外観と動作を与えるための背景イメージとしてのアイコンもあります。  
+  
+### コントロールによって表示されるイメージを設定するには  
+  
+1.  コントロールの `Image` または `BackgroundImage` プロパティを <xref:System.Drawing.Image> 型のオブジェクトに設定します。  一般的に、ファイルからイメージを読み込む場合は、<xref:System.Drawing.Image.FromFile%2A> メソッドを使用します。  
+  
+     次のコード例では、イメージの場所に対するパスとして **\[マイ ピクチャ\]** フォルダーが設定されています。  Windows オペレーティング システムを実行するほとんどのコンピューターには、このディレクトリがあります。  また、ユーザーは最小限のシステム アクセス レベルでアプリケーションを安全に実行できます。  次のコード例では、既に <xref:System.Windows.Forms.PictureBox> コントロールが追加されたフォームが必要です。  
+  
+    ```vb  
+    ' Replace the image named below  
+    ' with an icon of your own choosing.  
+    PictureBox1.Image = Image.FromFile _  
+       (System.Environment.GetFolderPath _  
+       (System.Environment.SpecialFolder.MyPictures) _  
+       & "\Image.gif")  
+  
+    ```  
+  
+    ```csharp  
+    // Replace the image named below  
+    // with an icon of your own choosing.  
+    // Note the escape character used (@) when specifying the path.  
+    pictureBox1.Image = Image.FromFile  
+       (System.Environment.GetFolderPath  
+       (System.Environment.SpecialFolder.MyPictures)  
+       + @"\Image.gif");  
+  
+    ```  
+  
+    ```cpp  
+    // Replace the image named below  
+    // with an icon of your own choosing.  
+    pictureBox1->Image = Image::FromFile(String::Concat  
+       (System::Environment::GetFolderPath  
+       (System::Environment::SpecialFolder::MyPictures),  
+       "\\Image.gif"));  
+    ```  
+  
+## 参照  
+ <xref:System.Drawing.Image.FromFile%2A>   
+ <xref:System.Drawing.Image>   
+ <xref:System.Windows.Forms.Control.BackgroundImage%2A>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-input-mask.md b/docs/framework/winforms/controls/how-to-set-the-input-mask.md
new file mode 100644
index 00000000000..36759138193
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-input-mask.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : 定型入力を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "net.ComponentModel.MaskPropertyEditor"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MaskedTextBox コントロール [Windows フォーム]"
+ms.assetid: 779b3a12-cd74-4e58-b46e-04983bda5b2c
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 定型入力を設定する
+マスク付きテキスト ボックス コントロールは、ユーザー入力を受け入れまたは拒否するための宣言構文をサポートする、拡張されたテキスト ボックス コントロールです。  \[マスク\] プロパティを設定することにより、アプリケーション内にカスタム検証ロジックを記述しなくても、許容できるユーザー入力を指定できます。  詳細については、<xref:System.Windows.Forms.MaskedTextBox> クラスの「解説」を参照してください。  
+  
+## \[マスク\] プロパティの手動設定  
+ \[マスク\] プロパティがサポートする文字に精通している場合は、手動で入力できます。  \[マスク\] プロパティがサポートする文字の概要については、<xref:System.Windows.Forms.MaskedTextBox.Mask%2A> プロパティの「解説」を参照してください。  
+  
+#### \[マスク\] プロパティを手動で設定するには  
+  
+1.  **デザイン** ビューで、<xref:System.Windows.Forms.MaskedTextBox> を選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.MaskedTextBox.Mask%2A> プロパティを見つけます。  
+  
+3.  目的のマスクを入力します。  たとえば、「`###`」と入力します。  
+  
+## \[定型入力\] ダイアログ ボックスの使用  
+ \[定型入力\] ダイアログ ボックスには、定義済みの定型入力がいくつか用意されています。  定義済みのマスクを変更することも、独自のマスクを手動で入力することもできます。  
+  
+#### \[定型入力\] ダイアログ ボックスを開くには  
+  
+1.  **デザイン** ビューで、<xref:System.Windows.Forms.MaskedTextBox> を選択します。  
+  
+    1.  スマート タグをクリックして、**\[MaskedTextBox タスク\]** パネルを開きます。  
+  
+    2.  **\[マスクの設定\]** をクリックします。  
+  
+     または  
+  
+    1.  **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.MaskedTextBox.Mask%2A> プロパティを選択します。  
+  
+    2.  プロパティの値列の省略記号ボタンをクリックします。  
+  
+     **\[定型入力\]** ダイアログ ボックスが表示されます。  
+  
+#### \[定型入力\] ダイアログ ボックスを使用するには  
+  
+1.  \(省略可能\) 一覧の定義済みのマスクのいずれかを選択します。  
+  
+2.  \(省略可能\) **\[マスク\]** ボックスで定義済みマスクを編集します。  
+  
+3.  \(省略可能\) **\[マスク\]** ボックスに新しいマスクを入力します。  つまり、定義済みのマスクのいずれかを使用する必要はありません。  
+  
+    > [!NOTE]
+    >  プレビュー ボックスに、<xref:System.Windows.Forms.MaskedTextBox> に表示される文字 \(ユーザーが確認する文字\) が表示されます。  これらの文字は、ユーザーがデータを正確に入力するためのガイドの役割をします。  
+  
+4.  **\[ValidatingType を使用する\]** チェック ボックスをオンにするかオフにします。  **\[ValidatingType を使用する\]** チェック ボックスは、ユーザーによる入力データを、データ型を使用して検証するかどうかを指定します。  詳細については、<xref:System.Windows.Forms.MaskedTextBox.ValidatingType%2A> プロパティのトピックを参照してください。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+     **\[プロパティ\]** ウィンドウの **\[マスク\]** プロパティにマスクが入力されます。  
+  
+## 参照  
+ [チュートリアル : MaskedTextBox コントロールの使用](../../../../docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..267db58c3fc
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの選択モードを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 選択モード"
+  - "DataGridView コントロール [Windows フォーム], 選択モード"
+  - "選択, モード (DataGridView コントロール内の)"
+ms.assetid: 2f241643-7f82-4583-8757-03494f63b465
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールの選択モードを設定する
+次のコード例では、行内の任意の場所をクリックすると行全体が自動的に選択され、一度に 1 行だけ選択できるように <xref:System.Windows.Forms.DataGridView> コントロールを設定する方法を示します。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#065](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#065)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#065](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#065)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A>   
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A>   
+ <xref:System.Windows.Forms.DataGridViewSelectionMode>   
+ [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](../../../../docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの選択モード](../../../../docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md b/docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md
new file mode 100644
index 00000000000..5cbd1baf385
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md
@@ -0,0 +1,80 @@
+---
+title: "方法 : ステータス バー パネルのサイズを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "パネル, 設定 (ステータス バーでのサイズを)"
+  - "ステータス バー, 設定 (パネル サイズを)"
+  - "StatusBar コントロール [Windows フォーム], パネル サイズ"
+ms.assetid: a01bee43-d9eb-4954-84e6-45a93532d08d
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ステータス バー パネルのサイズを設定する
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ [StatusBar コントロール](../../../../docs/framework/winforms/controls/statusbar-control-windows-forms.md) コントロールに含まれる <xref:System.Windows.Forms.StatusBarPanel> クラスの各インスタンスには、実行時に幅およびサイズ変更の動作を決定する動的プロパティが多数用意されています。  
+  
+### パネルのサイズを設定するには  
+  
+1.  プロシージャで、ステータス バー パネルの <xref:System.Windows.Forms.StatusBarPanel.AutoSize%2A>、<xref:System.Windows.Forms.StatusBarPanel.MinWidth%2A>、および<xref:System.Windows.Forms.StatusBarPanel.Width%2A> の各プロパティ \(またはその中に含まれるサブセット\) を設定します。これには <xref:System.Windows.Forms.StatusBarPanel> コレクションの <xref:System.Windows.Forms.StatusBar.Panels%2A> プロパティを介して渡されるインデックスを使用します。  
+  
+    ```vb  
+    Public Sub SetStatusBarPanelSize()  
+    ' Create panel and set text property.  
+       StatusBar1.Panels.Add("One")  
+    ' Set properties of panels.  
+       StatusBar1.Panels(0).AutoSize = StatusBarPanelAutoSize.Spring  
+       StatusBar1.Panels(0).Width = 200  
+    ' Enable the StatusBar control to display panels.  
+       StatusBar1.ShowPanels = True  
+        End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void SetStatusBarPanelSize()  
+    {  
+       // Create panel and set text property.  
+       statusBar1.Panels.Add("One");  
+       // Set properties of panels.  
+       statusBar1.Panels[0].AutoSize = StatusBarPanelAutoSize.Spring;  
+       statusBar1.Panels[0].Width = 200;  
+       statusBar1.ShowPanels = true;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void SetStatusBarPanelSize()  
+       {  
+          // Create panel and set text property.  
+          statusBar1->Panels->Add("One");  
+          // Set properties of panels.  
+          statusBar1->Panels[0]->AutoSize =  
+             StatusBarPanelAutoSize::Spring;  
+          statusBar1->Panels[0]->Width = 200;  
+          statusBar1->ShowPanels = true;  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusBar>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ [チュートリアル : ステータス バー情報の実行時更新](../../../../docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md)   
+ [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](../../../../docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md)   
+ [StatusBar コントロールの概要](../../../../docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..a2c3ebc3889
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 設定 (サイズ変更モードを)"
+  - "DataGridView コントロール [Windows フォーム], サイズ変更モード"
+ms.assetid: e9ad15e6-b4bb-44aa-a767-3738e9db1651
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する
+次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールおよびコントロール内の特定の列に対して使用できるサイズ変更オプションをカスタマイズまたは組み合わせる一般的なシナリオを示します。  
+  
+### 固定幅の列を作成するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> に、<xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A> プロパティを <xref:System.Windows.Forms.DataGridViewTriState> に、<xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A> プロパティを `true` に、<xref:System.Windows.Forms.DataGridViewColumn.Width%2A> プロパティに適切な値をそれぞれ設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSizingScenarios#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/CS/sizingscenarios.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewSizingScenarios#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/vb/sizingscenarios.vb#10)]  
+  
+### コンテンツに合わせてサイズが調整される列を作成するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティを、コンテンツに基づくサイズ変更モードに設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSizingScenarios#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/CS/sizingscenarios.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewSizingScenarios#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/vb/sizingscenarios.vb#20)]  
+  
+### サイズと重要度が異なる値に対してフィル モードの列を作成するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A?displayProperty=fullName> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode> に設定し、この値をオーバーライドしないすべての列のサイズ変更モードを設定します。  列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティを、平均のコンテンツ幅に比例した値に設定します。  重要な列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> プロパティを設定して、コンテンツを部分的に表示できるようにします。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSizingScenarios#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/CS/sizingscenarios.cs#30)]
+     [!code-vb[System.Windows.Forms.DataGridViewSizingScenarios#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/vb/sizingscenarios.vb#30)]  
+  
+## 使用例  
+ ここで説明したサイズ変更オプションを理解するために役立つデモ アプリケーションを次の完全なコード例に示します。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridViewSizingScenarios#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/CS/sizingscenarios.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewSizingScenarios#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSizingScenarios/vb/sizingscenarios.vb#00)]  
+  
+ このデモ アプリケーションは、次のようにして使用します。  
+  
+-   フォームのサイズを変更します。  <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティ値で指定した比率を維持しながら、フィル モードの列の幅が変化する様子を確認します。  フォームが小さすぎる場合に、列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> より狭くは変更されない様子を確認します。  
+  
+-   マウスで列の区分線をドラッグして、列のサイズを変更します。  一部の列ではサイズ変更ができない様子、およびサイズ変更可能な列でも幅を最小幅よりも狭くできない様子を確認します。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Width%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-tab-order-on-windows-forms.md b/docs/framework/winforms/controls/how-to-set-the-tab-order-on-windows-forms.md
new file mode 100644
index 00000000000..b227b6271fa
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-tab-order-on-windows-forms.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : Windows フォーム上のタブ オーダーを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TabStop"
+  - "TabIndex"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 設定 (タブ オーダーを)"
+  - "タブ オーダー, コントロール (Windows フォームの)"
+  - "Windows フォーム コントロール, 設定 (タブ オーダーを)"
+  - "Windows フォーム, 設定 (タブ オーダーを)"
+ms.assetid: 71fa8e76-0472-414b-ad3c-0f90166e0ad7
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Windows フォーム上のタブ オーダーを設定する
+タブ オーダーとは、ユーザーが **Tab** キーを押して、コントロール間でフォーカスを移動する順序です。  フォームごとに、独自のタブ オーダーを設定できます。  既定では、タブ オーダーはコントロールを作成した順序と同じになります。  タブ オーダーの番号は 0 から始まります。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールのタブ オーダーを設定するには  
+  
+1.  **\[表示\]** メニューの **\[タブ オーダー\]** をクリックします。  
+  
+     フォームのタブ オーダーの選択モードが有効になります。  各コントロールの左上端に、<xref:System.Windows.Forms.Control.TabIndex%2A> プロパティを表す数字が表示されます。  
+  
+2.  コントロールを順にクリックして、タブ オーダーを設定します。  
+  
+    > [!NOTE]
+    >  タブ オーダーにおけるコントロールの位置は、0 以上の任意の値に設定できます。  重複が発生した場合は、2 つのコントロールの z オーダーが評価され、手前に表示されるコントロールに対して先にタブの移動が行われます。  \(z オーダーは、コントロールの視覚的な階層構造であり、フォームの z 軸 \(奥行\) に沿ってフォームに描かれます。  z オーダーによって、どのコントロールを手前に表示するかを決定します\)。z オーダーの詳細については、「[Windows フォームのオブジェクトの階層構造](../../../../docs/framework/winforms/controls/how-to-layer-objects-on-windows-forms.md)」を参照してください。  
+  
+3.  設定が終わると、**\[表示\]** メニューの **\[タブ オーダー\]** をもう一度クリックして、タブ オーダー モードを終了します。  
+  
+    > [!NOTE]
+    >  フォーカスを設定できないコントロールは、無効になったコントロールや表示されないコントロールと同様に、<xref:System.Windows.Forms.Control.TabIndex%2A> プロパティが設定されておらず、タブ オーダーに含まれません。  ユーザーが **Tab** キーを押すと、タブ オーダーに含まれないコントロールはスキップされます。  
+  
+ \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Control.TabIndex%2A> プロパティを使用してタブ オーダーを設定することもできます。  コントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> プロパティを設定すると、タブ オーダー内のコントロールの位置を指定できます。  既定では、最初に描画されたコントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> 値が 0 で、次のコントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> 値が 1、というように順に続きます。  
+  
+ また、既定では、<xref:System.Windows.Forms.GroupBox> コントロールに、独自の整数の <xref:System.Windows.Forms.Control.TabIndex%2A> 値が設定されています。  <xref:System.Windows.Forms.GroupBox> コントロール自体には、実行時にフォーカスを設定できません。  このため、<xref:System.Windows.Forms.GroupBox> 内の各コントロールには、0.0 の値から始まる独自の 10 進数の <xref:System.Windows.Forms.Control.TabIndex%2A> 値が設定されています。  <xref:System.Windows.Forms.GroupBox> コントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> がインクリメントすると、その中のコントロールの値も同様にインクリメントします。  <xref:System.Windows.Forms.Control.TabIndex%2A> 値を 5 から 6 に変更すると、グループの最初のコントロールの <xref:System.Windows.Forms.Control.TabIndex%2A> 値も自動的に 6.0 に変更され、ほかのコントロールの値も同様に順次変更されます。  
+  
+ また、フォームのさまざまなコントロールから、任意のコントロールのタブ オーダーをスキップできます。  通常、実行時に **Tab** キーを押すと、タブ オーダー内の各コントロールが選択されます。  <xref:System.Windows.Forms.Control.TabStop%2A> プロパティをオフにすると、フォームのコントロールのタブ オーダーをスキップするように設定できます。  
+  
+#### タブ オーダーからコントロールを削除するには  
+  
+1.  \[プロパティ\] ウィンドウで、コントロールの <xref:System.Windows.Forms.Control.TabStop%2A> プロパティを `false` に設定します。  
+  
+     コントロールの <xref:System.Windows.Forms.Control.TabStop%2A> プロパティを `false` に設定すると、タブ オーダーでのコントロールの順序はそのままですが、Tab キーでコントロールを順番に移動するときにコントロールがスキップされます。  
+  
+    > [!NOTE]
+    >  オプション ボタン グループでは、実行時のタブ ストップは 1 回です。  選択したボタン、つまり <xref:System.Windows.Forms.RadioButton.Checked%2A> プロパティを `true` に設定したボタンの場合、<xref:System.Windows.Forms.Control.TabStop%2A> プロパティが自動的に `true` に設定されますが、その他のボタンの <xref:System.Windows.Forms.Control.TabStop%2A> プロパティは `false` に設定されます。  <xref:System.Windows.Forms.RadioButton> コントロールのグループ化の詳細については、「[セットとして機能する Windows フォーム RadioButton コントロールのグループ化](../../../../docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [Windows フォーム コントロールの機能別一覧](../../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control-using-the-designer.md b/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control-using-the-designer.md
new file mode 100644
index 00000000000..6feb9b8ac05
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control-using-the-designer.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : Windows フォーム コントロールに表示するテキストをデザイナーで設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 設定 (キャプションを)"
+  - "Windows フォーム, 設定 (表示されるテキストを)"
+ms.assetid: 9d18e0e0-f17f-4074-837d-e67ceeeaa89d
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Windows フォーム コントロールに表示するテキストをデザイナーで設定する
+通常、Windows フォーム コントロールは、コントロールの主要な機能に関連したテキストを表示します。  たとえば、<xref:System.Windows.Forms.Button> コントロールは通常、ボタンがクリックされたときに実行されるアクションを示すキャプションを表示します。  どのコントロールでも、<xref:System.Windows.Forms.Control.Text%2A> プロパティを使用することでテキストを設定したり返したりできます。  フォントは <xref:System.Windows.Forms.Control.Font%2A> プロパティを使用して変更できます。  
+  
+### デザイナーを使ってテキストとフォントを設定するには  
+  
+1.  \[プロパティ\] ウィンドウで、コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティを適切な文字列に設定します。  
+  
+     下線の付いたショートカット キーを作成する場合は、ショートカット キーとして使用する文字の前にアンパサンド \(&\) を含めます。  
+  
+2.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Control.Font%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+     標準のフォントのダイアログ ボックスで、使用するフォント、フォント スタイル、サイズ、文字飾り \(取り消し線、下線など\)、およびスクリプトを選択します。  
+  
+## 参照  
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [フォントとテキストの使用](../../../../docs/framework/winforms/advanced/using-fonts-and-text.md)   
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md b/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md
new file mode 100644
index 00000000000..6d9555e247f
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : Windows フォーム コントロールによって表示されるテキストを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], ボタンのテキスト"
+  - "Button コントロール [Windows フォーム], テキスト表示"
+  - "ボタン, テキスト"
+  - "キャプション, 設定"
+  - "キャプション, Windows フォーム コントロール"
+  - "コントロール [Windows フォーム], キャプション"
+  - "例 [Windows フォーム], コントロール"
+  - "フォーム, キャプション"
+  - "ラベル, 追加 (CommandButton コントロールに)"
+  - "StdFont オブジェクトと CommandButton キャプション"
+  - "テキスト"
+  - "Text プロパティ, Windows フォーム コントロール"
+  - "テキスト, Windows フォーム コントロール"
+  - "Windows フォーム, キャプション"
+ms.assetid: 36b95bff-8780-479d-b86a-f1a0673653aa
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : Windows フォーム コントロールによって表示されるテキストを設定する
+Windows フォーム コントロールは、通常、コントロールの主な機能に関連するいくつかのテキストを表示します。  たとえば、<xref:System.Windows.Forms.Button> コントロールは、通常、ボタンがクリックされたときにどのようなアクションを実行するかを示すキャプションを表示します。  すべてのコントロールに対して、<xref:System.Windows.Forms.Control.Text%2A> プロパティを使用してテキストを設定または返すことができます。  <xref:System.Windows.Forms.Control.Font%2A> プロパティを使用して、フォントを変更することができます。  また、デザイナーを使用してテキストを設定することもできます。  「[方法 : デザイナーを使用して Windows フォーム コントロールのアクセス キーを作成する](http://msdn.microsoft.com/library/ms233673\(v=vs.110\))」、「[方法 : Windows フォーム コントロールに表示するテキストをデザイナーで設定する](http://msdn.microsoft.com/library/ms233665\(v=vs.110\))」、「[方法 : デザイナーを使用して Windows フォーム コントロールによって表示されるイメージを設定する](http://msdn.microsoft.com/library/ms233656\(v=vs.110\))」も参照してください。  
+  
+### コントロールによって表示されるテキストをプログラムで設定するには  
+  
+1.  <xref:System.Windows.Forms.Control.Text%2A> プロパティを文字列に設定します。  
+  
+     下線付きのアクセス キーを作成するには、アクセス キーにする文字の前にアンパサンド \(&\) を含めます。  
+  
+2.  <xref:System.Windows.Forms.Control.Font%2A> プロパティを型 <xref:System.Drawing.Font> のオブジェクトに設定します。  
+  
+    ```vb  
+    Button1.Text = "Click here to save changes"  
+    Button1.Font = New Font("Arial", 10, FontStyle.Bold, GraphicsUnit.Point)  
+    ```  
+  
+    ```csharp  
+    button1.Text = "Click here to save changes";  
+    button1.Font = new Font("Arial", 10, FontStyle.Bold,  
+       GraphicsUnit.Point);  
+    ```  
+  
+    ```cpp#  
+    button1->Text = "Click here to save changes";  
+    button1->Font = new System::Drawing::Font("Arial",  
+       10, FontStyle::Bold, GraphicsUnit::Point);  
+    ```  
+  
+    > [!NOTE]
+    >  エスケープ文字を使用すると、メニュー項目など、通常は別の解釈がなされるユーザー インターフェイス要素の特殊文字を表示できます。  たとえば、次のコード行は、メニュー項目のテキストが "& Now For Something Completely Different" と読めるように設定します。  
+  
+    ```vb  
+    MPMenuItem.Text = "&& Now For Something Completely Different"  
+    ```  
+  
+    ```csharp  
+    mpMenuItem.Text = "&& Now For Something Completely Different";  
+    ```  
+  
+    ```cpp#  
+    mpMenuItem->Text = "&& Now For Something Completely Different";  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Text%2A?displayProperty=fullName>   
+ [方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-at-run-time.md b/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-at-run-time.md
new file mode 100644
index 00000000000..c9f5f694fbf
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-at-run-time.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : 実行時に ToolStrip レンダラーを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripManager クラス [Windows フォーム]"
+  - "ToolStripProfessionalRenderer クラス [Windows フォーム]"
+ms.assetid: 525e2347-0804-49aa-b9a3-9b2cabbf1c35
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 実行時に ToolStrip レンダラーを設定する
+カスタムの `ProfessionalColorTable` クラスを作成することで、<xref:System.Windows.Forms.ToolStrip> コントロールの外観をカスタマイズできます。  
+  
+## 使用例  
+ 次のコード例は、カスタムの `ProfessionalColorTable` クラスを作成する方法を示しています  このクラスは、<xref:System.Windows.Forms.MenuStrip> コントロールと <xref:System.Windows.Forms.ToolStrip> コントロールのグラデーションを定義します。  
+  
+ このコード例を使用するには、アプリケーションをコンパイルして実行し、**\[色を変更\]** をクリックして、カスタムの `ProfessionalColorTable` クラスで定義されているグラデーションを適用します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#20)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#20)]  
+  
+## カスタム ProfessionalColorTable クラスを定義する  
+ カスタムのグラデーションは、`CustomProfessionalColors` クラスでで定義されます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#30)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#30)]  
+  
+## カスタム レンダラーの割り当て  
+ `CustomProfessionalColors` クラスを使用して `ToolStripProfessionalRenderer` を新規作成し、<xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=fullName> プロパティに割り当てます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#22](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#22)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#22](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#22)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripManager>   
+ <xref:System.Windows.Forms.ProfessionalColorTable>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-for-an-application.md b/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-for-an-application.md
new file mode 100644
index 00000000000..9fc120b3c47
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-for-an-application.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : アプリケーションの ToolStrip レンダラーを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip コントロール [Windows フォーム]"
+  - "Renderer プロパティ [Windows フォーム]"
+  - "ツール バー [Windows フォーム], カスタマイズ"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripProfessionalRenderer クラス [Windows フォーム]"
+ms.assetid: 46acef3e-9844-4ae8-9a2e-3006fe99cadf
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : アプリケーションの ToolStrip レンダラーを設定する
+<xref:System.Windows.Forms.ToolStrip> コントロールの外観を個別にカスタマイズすることも、アプリケーションのすべての <xref:System.Windows.Forms.ToolStrip> コントロールをカスタマイズすることもできます。  
+  
+## 使用例  
+ 次のコード例は、カスタムのレンダラーを <xref:System.Windows.Forms.ToolStrip> コントロールと <xref:System.Windows.Forms.MenuStrip> コントロールに選択的に適用する方法を示します。  
+  
+ このコード例を使用するには、アプリケーションをコンパイルして実行し、<xref:System.Windows.Forms.ComboBox> コントロールからのカスタム表示の範囲を選択します。  **適用** をクリックしてレンダラーを設定します。  
+  
+ カスタム メニュー項目の表示を確認するには、<xref:System.Windows.Forms.ComboBox> コントロールから <xref:System.Windows.Forms.MenuStrip> オプションを選択して、**\[適用\]** をクリックし、**\[ファイル\]** メニュー項目を開きます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#70](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#70)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#70](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#70)]  
+  
+ アプリケーションのすべての <xref:System.Windows.Forms.ToolStrip> コントロールにカスタム レンダラーを適用するよう <xref:System.Windows.Forms.ToolStripManager.Renderer%2A?displayProperty=fullName> プロパティを設定します。  
+  
+ カスタム レンダラーを各 <xref:System.Windows.Forms.ToolStrip> コントロールに適用するよう <xref:System.Windows.Forms.ToolStrip.Renderer%2A?displayProperty=fullName> プロパティを設定します。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripManager>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-the-value-displayed-by-the-windows-forms-progressbar-control.md b/docs/framework/winforms/controls/how-to-set-the-value-displayed-by-the-windows-forms-progressbar-control.md
new file mode 100644
index 00000000000..24e25153bf2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-the-value-displayed-by-the-windows-forms-progressbar-control.md
@@ -0,0 +1,244 @@
+---
+title: "方法 : Windows フォーム ProgressBar コントロールによって表示される値を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Increment メソッド"
+  - "PerformStep メソッド"
+  - "プログレス コントロール, 設定 (表示される値を)"
+  - "ProgressBar コントロール [Windows フォーム], 設定 (表示される値を)"
+  - "Step プロパティ"
+  - "Value プロパティ"
+ms.assetid: 0e5010ad-1e9a-4271-895e-5a3d24d37a26
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム ProgressBar コントロールによって表示される値を設定する
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.ToolStripProgressBar> コントロールは、<xref:System.Windows.Forms.ProgressBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ProgressBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、<xref:System.Windows.Forms.ProgressBar> コントロールに値を表示する方法として、いくつかの異なる方法があります。  どの方法を選択するかは、実行するタスクや解決しようとする問題によって決まります。  選択できる方法を次の表に示します。  
+  
+|方法|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ProgressBar> コントロールの値を直接設定する。|この方法は、データ ソースからレコードを読み取る場合など、測定する項目の合計数がわかっている場合に便利です。  また、値を 1 回か 2 回だけ設定すれば済む場合も、この方法が簡単です。  さらに、プログレス バーに表示される値を減らす必要がある場合にも、この方法を使用します。|  
+|<xref:System.Windows.Forms.ProgressBar> の表示を固定された値だけ増加させる。|この方法は、既知の総数から処理された経過時間やファイル数など、最小値と最大値の間の単純なカウントを表示する場合に便利です。|  
+|<xref:System.Windows.Forms.ProgressBar> の表示を可変の値だけ増加させる。|この方法は、表示される値を複数回、それぞれ異なる量だけ変化させる必要がある場合に便利です。  たとえば、ディスクにいくつかのファイルを書き込みながら、消費されたハード ディスク容量を表示する場合などです。|  
+  
+ プログレス バーに表示される値を設定する最も直接的な方法は、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを設定することです。  この操作は、デザイン時でも実行時でも実行できます。  
+  
+### ProgressBar の値を直接設定するには  
+  
+1.  <xref:System.Windows.Forms.ProgressBar> コントロールの <xref:System.Windows.Forms.ProgressBar.Minimum%2A> 値および <xref:System.Windows.Forms.ProgressBar.Maximum%2A> 値を設定します。  
+  
+2.  コードで、そのコントロールの <xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを、設定した最小値と最大値の間の整数値に設定します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを、<xref:System.Windows.Forms.ProgressBar.Minimum%2A> プロパティおよび <xref:System.Windows.Forms.ProgressBar.Maximum%2A> プロパティによって設定された範囲外に設定すると、コントロールが <xref:System.ArgumentException> 例外をスローします。  
+  
+     <xref:System.Windows.Forms.ProgressBar> の値を直接設定する方法を次のコード例に示します。  このコードは、データ ソースからレコードを読み取り、1 レコード読み取るごとにプログレス バーとラベルを更新します。  この例では、フォームに <xref:System.Windows.Forms.Label> コントロール、<xref:System.Windows.Forms.ProgressBar> コントロール、およびデータ テーブルがあり、データ テーブルの `CustomerRow`  という行に `FirstName`  および `Last Name`  というフィールドがあることが必須条件です。  
+  
+    ```vb  
+    Public Sub CreateNewRecords()  
+       ' Sets the progress bar's Maximum property to  
+       ' the total number of records to be created.  
+       ProgressBar1.Maximum = 20  
+  
+       ' Creates a new record in the dataset.  
+       ' NOTE: The code below will not compile, it merely  
+       ' illustrates how the progress bar would be used.  
+       Dim anyRow As CustomerRow = DatasetName.ExistingTable.NewRow  
+       anyRow.FirstName = "Stephen"  
+       anyRow.LastName = "James"  
+       ExistingTable.Rows.Add(anyRow)  
+  
+       ' Increases the value displayed by the progress bar.  
+       ProgressBar1.Value += 1  
+       ' Updates the label to show that a record was read.  
+       Label1.Text = "Records Read = " & ProgressBar1.Value.ToString()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void createNewRecords()  
+    {  
+       // Sets the progress bar's Maximum property to  
+       // the total number of records to be created.  
+       progressBar1.Maximum = 20;  
+  
+       // Creates a new record in the dataset.  
+       // NOTE: The code below will not compile, it merely  
+       // illustrates how the progress bar would be used.  
+       CustomerRow anyRow = DatasetName.ExistingTable.NewRow();  
+       anyRow.FirstName = "Stephen";  
+       anyRow.LastName = "James";  
+       ExistingTable.Rows.Add(anyRow);  
+  
+       // Increases the value displayed by the progress bar.  
+       progressBar1.Value += 1;  
+       // Updates the label to show that a record was read.  
+       label1.Text = "Records Read = " + progressBar1.Value.ToString();  
+    }  
+    ```  
+  
+     固定された間隔で増加する進行状況を表示する場合は、値を設定してから、その間隔で <xref:System.Windows.Forms.ProgressBar> コントロールの値を増加させるメソッドを呼び出します。  これは、タイマーなどのように、進行状況を全体に対する割合として表さない状況で便利です。  
+  
+### プログレス バーを固定された値だけ増加させるには  
+  
+1.  <xref:System.Windows.Forms.ProgressBar> コントロールの <xref:System.Windows.Forms.ProgressBar.Minimum%2A> 値および <xref:System.Windows.Forms.ProgressBar.Maximum%2A> 値を設定します。  
+  
+2.  コントロールの <xref:System.Windows.Forms.ProgressBar.Step%2A> プロパティに、プログレス バーの表示値を増加させる量を表す整数を設定します。  
+  
+3.  <xref:System.Windows.Forms.ProgressBar.PerformStep%2A> メソッドを呼び出して、表示される値を <xref:System.Windows.Forms.ProgressBar.Step%2A> プロパティに設定した量だけ変更します。  
+  
+     コピー操作中にプログレス バーにファイル数を表示させる方法を次のコード例に示します。  
+  
+     この例では、各ファイルがメモリに読み込まれるたびに、プログレス バーおよびラベルが、読み込んだファイルの合計数を反映するように更新されます。  この例では、フォームに <xref:System.Windows.Forms.Label> コントロールおよび <xref:System.Windows.Forms.ProgressBar> コントロールがあることが必須条件です。  
+  
+    ```vb  
+    Public Sub LoadFiles()  
+       ' Sets the progress bar's minimum value to a number representing  
+       ' no operations complete -- in this case, no files read.  
+       ProgressBar1.Minimum = 0  
+       ' Sets the progress bar's maximum value to a number representing  
+       ' all operations complete -- in this case, all five files read.  
+       ProgressBar1.Maximum = 5  
+       ' Sets the Step property to amount to increase with each iteration.  
+       ' In this case, it will increase by one with every file read.  
+       ProgressBar1.Step = 1  
+  
+       ' Dimensions a counter variable.  
+       Dim i As Integer  
+       ' Uses a For...Next loop to iterate through the operations to be  
+       ' completed. In this case, five files are to be copied into memory,  
+       ' so the loop will execute 5 times.  
+       For i = 0 To 4  
+          ' Insert code to copy a file  
+          ProgressBar1.PerformStep()  
+          ' Update the label to show that a file was read.  
+          Label1.Text = "# of Files Read = " & ProgressBar1.Value.ToString  
+       Next i  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void loadFiles()  
+    {  
+       // Sets the progress bar's minimum value to a number representing  
+       // no operations complete -- in this case, no files read.  
+       progressBar1.Minimum = 0;  
+       // Sets the progress bar's maximum value to a number representing  
+       // all operations complete -- in this case, all five files read.  
+       progressBar1.Maximum = 5;  
+       // Sets the Step property to amount to increase with each iteration.  
+       // In this case, it will increase by one with every file read.  
+       progressBar1.Step = 1;  
+  
+       // Uses a for loop to iterate through the operations to be  
+       // completed. In this case, five files are to be copied into memory,  
+       // so the loop will execute 5 times.  
+       for (int i = 0; i <= 4; i++)  
+       {  
+          // Inserts code to copy a file  
+          progressBar1.PerformStep();  
+          // Updates the label to show that a file was read.  
+          label1.Text = "# of Files Read = " + progressBar1.Value.ToString();  
+       }  
+    }  
+    ```  
+  
+     最後に、プログレス バーに表示される値をそのたびに異なる量だけ増加させる方法を説明します。  これは、異なるサイズのファイルをハード ディスクに書き込む場合や、進行状況を全体に対する割合で表す場合など、一連の操作を追跡する場合に便利です。  
+  
+### プログレス バーを動的な値だけ増加させるには  
+  
+1.  <xref:System.Windows.Forms.ProgressBar> コントロールの <xref:System.Windows.Forms.ProgressBar.Minimum%2A> 値および <xref:System.Windows.Forms.ProgressBar.Maximum%2A> 値を設定します。  
+  
+2.  <xref:System.Windows.Forms.ProgressBar.Increment%2A> メソッドを呼び出して、表示される値を指定した整数だけ変化させます。  
+  
+     コピー操作中に消費されたディスク容量をプログレス バーで計算する方法を次のコード例に示します。  
+  
+     この例では、各ファイルがハード ディスクに書き込まれるたびに、プログレス バーとラベルが更新され、使用できるハード ディスク容量が反映されます。  この例では、フォームに <xref:System.Windows.Forms.Label> コントロールおよび <xref:System.Windows.Forms.ProgressBar> コントロールがあることが必須条件です。  
+  
+    ```vb  
+    Public Sub ReadFiles()  
+       ' Sets the progress bar's minimum value to a number   
+       ' representing the hard disk space before the files are read in.  
+       ' You will most likely have to set this using a system call.  
+       ' NOTE: The code below is meant to be an example and  
+       ' will not compile.  
+       ProgressBar1.Minimum = AvailableDiskSpace()  
+       ' Sets the progress bar's maximum value to a number   
+       ' representing the total hard disk space.  
+       ' You will most likely have to set this using a system call.  
+       ' NOTE: The code below is meant to be an example   
+       ' and will not compile.  
+       ProgressBar1.Maximum = TotalDiskSpace()  
+  
+       ' Dimension a counter variable.  
+       Dim i As Integer  
+       ' Uses a For...Next loop to iterate through the operations to be  
+       ' completed. In this case, five files are to be written to the disk,  
+       ' so it will execute the loop 5 times.  
+       For i = 1 To 5  
+          ' Insert code to read a file into memory and update file size.  
+          ' Increases the progress bar's value based on the size of   
+          ' the file currently being written.  
+          ProgressBar1.Increment(FileSize)  
+          ' Updates the label to show available drive space.  
+          Label1.Text = "Current Disk Space Used = " &_   
+          ProgressBar1.Value.ToString()  
+       Next i  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void readFiles()  
+    {  
+       // Sets the progress bar's minimum value to a number   
+       // representing the hard disk space before the files are read in.  
+       // You will most likely have to set this using a system call.  
+       // NOTE: The code below is meant to be an example and   
+       // will not compile.  
+       progressBar1.Minimum = AvailableDiskSpace();  
+       // Sets the progress bar's maximum value to a number   
+       // representing the total hard disk space.  
+       // You will most likely have to set this using a system call.  
+       // NOTE: The code below is meant to be an example   
+       // and will not compile.  
+       progressBar1.Maximum = TotalDiskSpace();  
+  
+       // Uses a for loop to iterate through the operations to be  
+       // completed. In this case, five files are to be written  
+       // to the disk, so it will execute the loop 5 times.  
+       for (int i = 1; i<= 5; i++)  
+       {  
+          // Insert code to read a file into memory and update file size.  
+          // Increases the progress bar's value based on the size of   
+          // the file currently being written.  
+          progressBar1.Increment(FileSize);  
+          // Updates the label to show available drive space.  
+          label1.Text = "Current Disk Space Used = " + progressBar1.Value.ToString();  
+       }  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ProgressBar>   
+ <xref:System.Windows.Forms.ToolStripProgressBar>   
+ [ProgressBar コントロールの概要](../../../../docs/framework/winforms/controls/progressbar-control-overview-windows-forms.md)   
+ [ProgressBar コントロール](../../../../docs/framework/winforms/controls/progressbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md b/docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md
new file mode 100644
index 00000000000..8dcc436d992
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツールヒント"
+  - "ツールヒント [Windows フォーム], コントロールの"
+ms.assetid: c4b60637-4c0a-44c2-a103-f66dff887936
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する
+<xref:System.Windows.Forms.ToolTip> 文字列はコード、または Windows フォーム デザイナーで設定できます。  <xref:System.Windows.Forms.ToolTip> コンポーネントの詳細については、「[ToolTip コンポーネントの概要](../../../../docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### プログラムによってツールヒントを設定するには  
+  
+1.  ツールヒントを表示するコントロールを追加します。  
+  
+2.  <xref:System.Windows.Forms.ToolTip> コンポーネントの <xref:System.Windows.Forms.ToolTip.SetToolTip%2A> メソッドを使用します。  
+  
+    ```vb  
+    ' In this example, Button1 is the control to display the ToolTip.  
+    ToolTip1.SetToolTip(Button1, "Save changes")  
+  
+    ```  
+  
+    ```csharp  
+    // In this example, button1 is the control to display the ToolTip.  
+    toolTip1.SetToolTip(button1, "Save changes");  
+  
+    ```  
+  
+    ```cpp  
+    // In this example, button1 is the control to display the ToolTip.  
+    toolTip1->SetToolTip(button1, "Save changes");  
+    ```  
+  
+### デザイナーでツールヒントを設定するには  
+  
+1.  フォームに <xref:System.Windows.Forms.ToolTip> コンポーネントを追加します。  
+  
+2.  ツールヒントを表示するコントロールを選択するか、フォームにコントロールを追加します。  
+  
+3.  **\[プロパティ\]** ウィンドウで、**\[ToolTip1 の ToolTip\]** の値を適切な文字列に設定します。  
+  
+## 参照  
+ [ToolTip コンポーネントの概要](../../../../docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md)   
+ [方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)   
+ [ToolTip コンポーネント](../../../../docs/framework/winforms/controls/tooltip-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-set-up-automatic-menu-merging-for-mdi-applications.md b/docs/framework/winforms/controls/how-to-set-up-automatic-menu-merging-for-mdi-applications.md
new file mode 100644
index 00000000000..685ccaaf016
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-set-up-automatic-menu-merging-for-mdi-applications.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : MDI アプリケーションでメニューの自動マージを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip, マージ"
+  - "マージ, 自動メニュー"
+ms.assetid: 55e32cad-1141-4a56-aa33-d9543ca3d393
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : MDI アプリケーションでメニューの自動マージを設定する
+ここでは、<xref:System.Windows.Forms.MenuStrip> を使用して、マルチ ドキュメント インターフェイス \(MDI\) アプリケーションで自動マージを設定する基本的な手順を説明します。  
+  
+### メニューの自動マージを設定するには  
+  
+1.  <xref:System.Windows.Forms.Form.IsMdiContainer%2A> プロパティを `true` に設定して、MDI 親フォームを作成します。  
+  
+2.  MDI 親フォームに <xref:System.Windows.Forms.MenuStrip> を追加し、<xref:System.Windows.Forms.Form.MainMenuStrip%2A> プロパティをその <xref:System.Windows.Forms.MenuStrip> に設定します。  
+  
+3.  MDI 子フォームを作成し、その <xref:System.Windows.Forms.Form.MdiParent%2A> プロパティを親フォームの名前に設定します。  
+  
+4.  MDI 子フォームに <xref:System.Windows.Forms.MenuStrip> を追加します。  
+  
+5.  子フォームで、<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.ToolStripItem.Visible%2A> プロパティを `false` に設定します。  
+  
+6.  子フォームがアクティブ化されたときに親フォームの <xref:System.Windows.Forms.MenuStrip> にマージするメニュー項目を子フォームの <xref:System.Windows.Forms.MenuStrip> に追加します。  
+  
+7.  子フォームの <xref:System.Windows.Forms.MenuStrip> のメニュー項目で <xref:System.Windows.Forms.ToolStripItem.MergeAction%2A> プロパティを使用して、各項目を親フォームにマージする方法を制御します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-share-bound-data-across-forms-using-the-bindingsource-component.md b/docs/framework/winforms/controls/how-to-share-bound-data-across-forms-using-the-bindingsource-component.md
new file mode 100644
index 00000000000..2cec8b03788
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-share-bound-data-across-forms-using-the-bindingsource-component.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : BindingSource コンポーネントを使用してフォーム間でバインド データを共有する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "BindingSource, 使用 (複数のフォームで)"
+  - "データ バインド, 共有 (フォーム間でデータを)"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+ms.assetid: a1a49630-db9c-4485-b888-1f62a373a4f7
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : BindingSource コンポーネントを使用してフォーム間でバインド データを共有する
+<xref:System.Windows.Forms.BindingSource> コンポーネントを使用してフォーム間でデータを簡単に共有できます。  たとえば、データ ソースのデータを集計する 1 つの読み取り専用のフォームと、データ ソース内の現在選択されているアイテムについての詳細情報を含む別の編集可能なフォームを表示することがあります。  この例は、このシナリオを示しています。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.BindingSource> およびフォーム間でバインドされたデータを共有する方法を示しています。  この例で、共有された <xref:System.Windows.Forms.BindingSource> が子フォームのコンストラクターに渡されます。  子フォームでは、メイン フォームで現在選択されているアイテムのデータをユーザーが編集することができます。  
+  
+> [!NOTE]
+>  例の <xref:System.Windows.Forms.BindingSource> コンポーネントの <xref:System.Windows.Forms.BindingSource.BindingComplete> イベントは、2 つの形式が同期を保つために処理されます。  これを実行する理由の詳細については、「[方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ](../../../../docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.BindingSourceMultipleForms#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingSourceMultipleForms/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.BindingSourceMultipleForms#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingSourceMultipleForms/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Windows.Forms、System.Drawing、System.Data、および System.Xml アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [方法 : データ バインドで発生するエラーと例外を処理する](../../../../docs/framework/winforms/controls/how-to-handle-errors-and-exceptions-that-occur-with-databinding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-show-a-color-palette-with-the-colordialog-component.md b/docs/framework/winforms/controls/how-to-show-a-color-palette-with-the-colordialog-component.md
new file mode 100644
index 00000000000..aed708331b1
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-show-a-color-palette-with-the-colordialog-component.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : ColorDialog コンポーネントを使用してカラー パレットを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "色のダイアログ ボックス, 表示 (カラー パレットを)"
+  - "カラー パレット, ダイアログ ボックス"
+  - "カラー パレット, 表示 (ColorDialog コンポーネントで)"
+  - "Color プロパティ"
+  - "ColorDialog コンポーネント, 表示 (カラー パレットを)"
+  - "色, 許可 (ユーザーに選択を)"
+  - "色, 表示 (パレットを)"
+  - "パレット, 表示 (カラーを)"
+ms.assetid: ee050f61-dbc8-4436-ba22-51360981ab48
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ColorDialog コンポーネントを使用してカラー パレットを表示する
+[ColorDialog](../../../../docs/framework/winforms/controls/colordialog-component-windows-forms.md) コンポーネントは、色のパレットを表示し、ユーザーが選択した色を含むプロパティを返します。  
+  
+### ColorDialog コンポーネントを使用して色を選択するには  
+  
+1.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用してダイアログ ボックスを表示します。  
+  
+2.  <xref:System.Windows.Forms.DialogResult> プロパティを使用して、ダイアログ ボックスがどのように閉じられたかを確認します。  
+  
+3.  <xref:System.Windows.Forms.ColorDialog> コンポーネントの <xref:System.Windows.Forms.ColorDialog.Color%2A> プロパティを使用して、選択された色を設定します。  
+  
+     次のコード例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで <xref:System.Windows.Forms.ColorDialog> コンポーネントを開いています。  ユーザーが色を選択して **\[OK\]** をクリックすると、<xref:System.Windows.Forms.Button> コントロールの背景色が選択された色に設定されます。  この例のコードは、フォームに <xref:System.Windows.Forms.Button> コントロールと <xref:System.Windows.Forms.ColorDialog> コンポーネントがあることを想定して書かれています。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+    ByVal e As System.EventArgs) Handles Button1.Click  
+       If ColorDialog1.ShowDialog() = DialogResult.OK Then  
+          Button1.BackColor = ColorDialog1.Color  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       if(colorDialog1.ShowDialog() == DialogResult.OK)  
+       {  
+          button1.BackColor = colorDialog1.Color;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,   
+          System::EventArgs ^ e)  
+       {  
+          if(colorDialog1->ShowDialog() == DialogResult::OK)  
+          {  
+             button1->BackColor = colorDialog1->Color;  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)]、[!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    this->button1->Click +=   
+       gcnew System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ColorDialog>   
+ [ColorDialog コンポーネント](../../../../docs/framework/winforms/controls/colordialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-show-a-font-list-with-the-fontdialog-component.md b/docs/framework/winforms/controls/how-to-show-a-font-list-with-the-fontdialog-component.md
new file mode 100644
index 00000000000..1aa66039295
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-show-a-font-list-with-the-fontdialog-component.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : FontDialog コンポーネントを使用してフォントの一覧を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フォント ダイアログ ボックス, 表示"
+  - "Font プロパティ, 設定 (FontDialog コンポーネントで)"
+  - "FontDialog コンポーネント [Windows フォーム]"
+  - "フォント, 属性"
+  - "フォント, 選択"
+  - "フォント, 表示 (一覧を)"
+ms.assetid: 35692c1b-0937-4b7a-9207-1ae6bdc244a0
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : FontDialog コンポーネントを使用してフォントの一覧を表示する
+[FontDialog](../../../../docs/framework/winforms/controls/fontdialog-component-windows-forms.md) コンポーネントを使用すると、ユーザーはフォントを選択したり、フォントの幅やサイズなどの表示属性を変更したりできます。  
+  
+ ダイアログ ボックスで選択されたフォントは、<xref:System.Windows.Forms.FontDialog.Font%2A> プロパティに返されます。  そのため、ユーザーによって選択されたフォントは、プロパティを読み取るのと同じように簡単に利用できます。  
+  
+### FontDialog コンポーネントを使用してフォントのプロパティを選択するには  
+  
+1.  <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用してダイアログ ボックスを表示します。  
+  
+2.  <xref:System.Windows.Forms.DialogResult> プロパティを使用して、ダイアログ ボックスがどのように閉じられたかを確認します。  
+  
+3.  <xref:System.Windows.Forms.FontDialog.Font%2A> プロパティを使用して、目的のフォントを設定します。  
+  
+     次のコード例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで <xref:System.Windows.Forms.FontDialog> コンポーネントを開いています。  ユーザーがフォントを選択して **\[OK\]** をクリックすると、フォーム上の <xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.FontDialog.Font%2A> プロパティが、選択されたフォントに設定されます。  この例のコードは、フォームに <xref:System.Windows.Forms.Button> コントロールと <xref:System.Windows.Forms.TextBox> コントロール、および <xref:System.Windows.Forms.FontDialog> コンポーネントがあることを想定して書かれています。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, _  
+       ByVal e As System.EventArgs) Handles Button1.Click  
+       If FontDialog1.ShowDialog() = DialogResult.OK Then  
+          TextBox1.Font = FontDialog1.Font  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)  
+    {  
+       if(fontDialog1.ShowDialog() == DialogResult.OK)  
+       {  
+          textBox1.Font = fontDialog1.Font;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,  
+          System::EventArgs ^ e)  
+       {  
+          if(fontDialog1->ShowDialog() == DialogResult::OK)  
+          {  
+             textBox1->Font = fontDialog1->Font;  
+          }  
+       }  
+    ```  
+  
+     \([!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] および [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)]\) フォームのコンストラクターに次のコードを挿入してイベント ハンドラーを登録します。  
+  
+    ```csharp  
+    this.button1.Click += new System.EventHandler(this.button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    button1->Click += gcnew System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.FontDialog>   
+ [FontDialog コンポーネント](../../../../docs/framework/winforms/controls/fontdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md b/docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md
new file mode 100644
index 00000000000..f30a53014cd
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キャプション, サイズ変更"
+  - "Label コントロール [Windows フォーム], サイズ変更 (内容に合わせた)"
+  - "ラベル, サイズ変更 (内容に合わせた)"
+  - "サイズ, コントロール"
+  - "サイズ変更コントロール"
+ms.assetid: 99648964-63b2-438c-980e-d24103ad602b
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する
+Windows フォーム <xref:System.Windows.Forms.Label> コントロールは、単一行または複数行で作成できます。コントロールのサイズは、固定するか、またはキャプションに合わせて自動的に変更できます。  <xref:System.Windows.Forms.Label.AutoSize%2A> プロパティは、キャプションの大きさに合わせてコントロールのサイズを変更するときに役立ちます。キャプションが実行時に変化する場合は、このプロパティを使用すると便利です。  
+  
+### 内容に合わせて Label コントロールのサイズを動的に変更するには  
+  
+1.  <xref:System.Windows.Forms.Label.AutoSize%2A> プロパティを `true` に設定します。  
+  
+ <xref:System.Windows.Forms.Label.AutoSize%2A> プロパティを `false` に設定した場合、<xref:System.Windows.Forms.Label.Text%2A> プロパティに指定したテキストは、可能な場合は次の行に折り返されます。ただし、コントロールのサイズが大きくなることはありません。  
+  
+## 参照  
+ [方法 : Windows フォームの Label コントロールでアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md)   
+ [Label コントロールの概要](../../../../docs/framework/winforms/controls/label-control-overview-windows-forms.md)   
+ [Label コントロール](../../../../docs/framework/winforms/controls/label-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-span-rows-and-columns-in-a-tablelayoutpanel-control.md b/docs/framework/winforms/controls/how-to-span-rows-and-columns-in-a-tablelayoutpanel-control.md
new file mode 100644
index 00000000000..801acf9bfed
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-span-rows-and-columns-in-a-tablelayoutpanel-control.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : TableLayoutPanel コントロールの行と列を拡大する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "net.ComponentModel.StyleCollectionEditor.TLP.SpanRowsColumns"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, マージ"
+  - "列 [Windows フォーム], 拡張"
+  - "マージ (セルを)"
+  - "行 [Windows フォーム], 拡張"
+  - "TableLayoutPanel コントロール [Windows フォーム], 拡張 (行と列を)"
+ms.assetid: a8a2fdd3-a848-48b0-a4cd-4e85ebded87e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : TableLayoutPanel コントロールの行と列を拡大する
+<xref:System.Windows.Forms.TableLayoutPanel> コントロール内のコントロールは隣接する行と列に拡大できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 列と行を拡大するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールの左上のセルにドラッグします。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの **ColumnSpan** プロパティを 2 に設定します。  <xref:System.Windows.Forms.Button> コントロールは 1 番目と 2 番目の列にまたがります。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの **RowSpan** プロパティを 2 に設定します。  <xref:System.Windows.Forms.Button> コントロールは 1 番目と 2 番目の行にまたがります。  
+  
+5.  <xref:System.Windows.Forms.Button> コントロールの **ColumnSpan** プロパティを 1 に設定します。  <xref:System.Windows.Forms.Button> コントロールは最初の列に移動し、1 番目と 2 番目の行にまたがります。  
+  
+## 参照  
+ [TableLayoutPanel コントロール](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..67884fb321d
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-specify-the-edit-mode-for-the-windows-forms-datagridview-control.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの編集モードを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 編集モード"
+  - "DataGridView コントロール [Windows フォーム], 編集モード"
+ms.assetid: 93e117e8-94c4-411b-ba31-645e475ed85c
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム DataGridView コントロールの編集モードを指定する
+既定では、ユーザーが現在の <xref:System.Windows.Forms.DataGridView> テキスト ボックス セルの内容を編集するには、セル内に入力するか、F2 キーを押します。  次の条件をすべて満たしている場合は、この操作によって、セルは編集モードになります。  
+  
+-   基になるデータ ソースが編集をサポートしている。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールが有効である。  
+  
+-   <xref:System.Windows.Forms.DataGridView.EditMode%2A> プロパティ値が <xref:System.Windows.Forms.DataGridViewEditMode> ではない。  
+  
+-   セル、行、列、およびコントロールの `ReadOnly` プロパティがすべて `false` に設定されている。  
+  
+ 編集モードでは、ユーザーはセルの値を変更し、Enter キーを押して変更をコミットしたり、Esc キーを押してセルの値を元に戻したりできます。  
+  
+ 現在のセルになったときにすぐに編集モードになるように <xref:System.Windows.Forms.DataGridView> コントロールを構成できます。  この場合、Enter キーと Esc キーの動作は変更されませんが、値をコミットした後や元に戻した後も、セルは編集モードのままです。  ユーザーがセル内に入力した場合や、F2 キーを押した場合にのみ、セルが編集モードになるようにコントロールを構成することもできます。  また、<xref:System.Windows.Forms.DataGridView.BeginEdit%2A> メソッドを呼び出す場合を除き、セルが編集モードにならないように構成することもできます。  
+  
+### DataGridView コントロールの編集モードを変更するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.EditMode%2A?displayProperty=fullName> プロパティに適切な <xref:System.Windows.Forms.DataGridViewEditMode> 列挙値を設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#067](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#067)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#067](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#067)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System> アセンブリおよび <xref:System.Windows.Forms> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.EditMode%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-split-a-window-horizontally-using-the-designer.md b/docs/framework/winforms/controls/how-to-split-a-window-horizontally-using-the-designer.md
new file mode 100644
index 00000000000..c52972637f6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-split-a-window-horizontally-using-the-designer.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : デザイナーを使用してウィンドウを水平方向に分割する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "分割ウィンドウ, 水平"
+  - "SplitContainer コントロール [Windows フォーム], 水平方向の分割"
+  - "ウィンドウ, 分割 (水平方向に)"
+ms.assetid: 3872a176-891f-4c70-9779-b2ce85b0b102
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : デザイナーを使用してウィンドウを水平方向に分割する
+<xref:System.Windows.Forms.SplitContainer> コントロールを水平方向に分割する分割線を作成する例を次に示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティは、コントロール自体の方向ではなく、分割線の方向を指定します。  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### ウィンドウを水平方向に分割するには  
+  
+1.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティを <xref:System.Windows.Forms.Orientation> に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-split-a-window-horizontally.md b/docs/framework/winforms/controls/how-to-split-a-window-horizontally.md
new file mode 100644
index 00000000000..de8418616ca
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-split-a-window-horizontally.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : ウィンドウを水平方向に分割する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "SplitContainer コントロール [Windows フォーム], 水平分割線"
+  - "分割ウィンドウ, 変更 (分割線の向きを)"
+  - "分割ウィンドウ, 水平"
+  - "ウィンドウ, 分割 (水平方向に)"
+ms.assetid: a1f74f29-048c-4723-85fa-b9d375ab8f4b
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ウィンドウを水平方向に分割する
+<xref:System.Windows.Forms.SplitContainer> コントロールを水平方向に分割する分割線を作成するコード例を次に示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティは、コントロール自体の方向ではなく、分割線の方向を指定します。  
+  
+### ウィンドウを水平方向に分割するには  
+  
+1.  プロシージャ内で、<xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティに <xref:System.Windows.Forms.Orientation> を設定します。  
+  
+    ```vb  
+    Sub ShowSplitContainer()  
+        Dim splitContainer1 as new SplitContainer()  
+        splitContainer1.BorderStyle = BorderStyle.Fixed3D  
+        splitContainer1.Location = New System.Drawing.Point(74, 20)  
+        splitContainer1.Name = "DemoSplitContainer"  
+        splitContainer1.Size = New System.Drawing.Size(212, 435)  
+        splitContainer1.TabIndex = 0  
+        splitContainer1.Orientation = Orientation.Horizontal  
+        Controls.Add(splitContainer1)  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void showSplitContainer()  
+    {  
+        SplitContainer splitContainer1 = new SplitContainer ();  
+        splitContainer1.BorderStyle = BorderStyle.Fixed3D;  
+        splitContainer1.Location = new System.Drawing.Point (74, 20);  
+        splitContainer1.Name = "DemoSplitContainer";  
+        splitContainer1.Size = new System.Drawing.Size (212, 435);  
+        splitContainer1.TabIndex = 0;  
+        splitContainer1.Orientation = Orientation.Horizontal;  
+        this.Controls.Add (splitContainer1);  
+  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md b/docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md
new file mode 100644
index 00000000000..627aca10ea6
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : UserControl の実行時の動作をテストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール, テスト"
+  - "ユーザー コントロール [Windows フォーム], テスト"
+  - "UserControl クラス, 実行時の動作"
+  - "UserControl クラス, テスト"
+  - "UserControl テスト コンテナー"
+ms.assetid: 4e4d5c49-1346-40ac-9d96-40211b573583
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : UserControl の実行時の動作をテストする
+<xref:System.Windows.Forms.UserControl> を開発したときは、実行時の動作をテストする必要があります。  別個の Windows ベース アプリケーション プロジェクトを作成し、コントロールをテスト フォームに配置できますが、この手順は手間がかかります。  それよりも Visual Studio の **UserControl テスト コンテナー**を使用する方がすばやく簡単にテストできます。  このテスト コンテナーは、Windows コントロール ライブラリ プロジェクトから直接起動します。  
+  
+> [!IMPORTANT]
+>  テスト コンテナーに <xref:System.Windows.Forms.UserControl> を読み込むには、コントロールには少なくとも 1 つのパブリック コンストラクターが必要です。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+> [!NOTE]
+>  Visual C\+\+ コントロールは**ユーザー コントロール テスト コンテナー**でテストできません。  
+  
+### UserControl の実行時の動作をテストするには  
+  
+1.  TestContainerExample という名前の Windows コントロール ライブラリ プロジェクトを作成します。  詳細については、「[Windows Control Library Template](http://msdn.microsoft.com/ja-jp/722f4e2d-1310-4ed5-8f33-593337ab66b4)」を参照してください。  
+  
+2.  **Windows フォーム デザイナー**で、**ツールボックス**の <xref:System.Windows.Forms.Label> コントロールをコントロールのデザイン サーフェイスにドラッグします。  
+  
+3.  F5 キーを押してプロジェクトをビルドし、**UserControl テスト コンテナー**を実行します。  テスト コンテナーと <xref:System.Windows.Forms.UserControl> が**プレビュー** ペインに表示されます。  
+  
+4.  **プレビュー** ペインの右側の <xref:System.Windows.Forms.PropertyGrid> コントロールに表示されている <xref:System.Windows.Forms.Control.BackColor%2A> プロパティを選択します。  プロパティの値を `ControlDark` に変更します。  コントロールが暗い色に変化することを確認します。  他のプロパティ値も変更してみて、コントロールへの影響を観察します。  
+  
+5.  **プレビュー** ペインの下の **\[ユーザー コントロールの四辺にドッキング\]** チェック ボックスをクリックします。  コントロールのサイズがペイン全体に拡大することを確認します。  テスト コンテナーのサイズを変更し、ペインと共にコントロールのサイズが変更されることを確認します。  
+  
+6.  テスト コンテナーを閉じます。  
+  
+7.  TestContainerExample プロジェクトに別のユーザー コントロールを追加します。  詳細については、「[NIB:How to: Add Existing Items to a Project](http://msdn.microsoft.com/ja-jp/15f4cfb7-78ab-457f-9f14-099a25a6a2d3)」を参照してください。  
+  
+8.  **Windows フォーム デザイナー**で、**ツールボックス**の <xref:System.Windows.Forms.Button> コントロールをコントロールのデザイン サーフェイスにドラッグします。  
+  
+9. F5 キーを押してプロジェクトをビルドし、テスト コンテナーを実行します。  
+  
+10. **\[ユーザー コントロールの選択\]** <xref:System.Windows.Forms.ComboBox> をクリックし、2 つのユーザー コントロールを切り替えます。  
+  
+## 別のプロジェクトのユーザー コントロールのテスト  
+ 現在のプロジェクトのテスト コンテナーで、別のプロジェクトのユーザー コントロールをテストできます。  
+  
+#### 別のプロジェクトのユーザー コントロールをテストするには  
+  
+1.  TestContainerExample2 という名前の Windows コントロール ライブラリ プロジェクトを作成します。  詳細については、「[Windows Control Library Template](http://msdn.microsoft.com/ja-jp/722f4e2d-1310-4ed5-8f33-593337ab66b4)」を参照してください。  
+  
+2.  **Windows フォーム デザイナー**で、**ツールボックス**の <xref:System.Windows.Forms.RadioButton> コントロールをコントロールのデザイン サーフェイスにドラッグします。  
+  
+3.  F5 キーを押してプロジェクトをビルドし、テスト コンテナーを実行します。  テスト コンテナーと <xref:System.Windows.Forms.UserControl> が**プレビュー** ペインに表示されます。  
+  
+4.  **\[読み込み\]** をクリックします。  
+  
+5.  **\[ファイルを開く\]** ダイアログ ボックスで、前の手順でビルドした TestContainerExample.dll に移動します。  TestContainerExample.dll を選択し、**\[開く\]** をクリックしてユーザー コントロールを読み込みます。  
+  
+6.  **\[ユーザー コントロールの選択\]** <xref:System.Windows.Forms.ComboBox> を使用して、TestContainerExample プロジェクトの 2 つのユーザー コントロールを切り替えます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.UserControl>   
+ [方法 : 複合コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-composite-controls.md)   
+ [チュートリアル : Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)   
+ [チュートリアル : Visual C\# による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md)   
+ [User Control Designer](http://msdn.microsoft.com/ja-jp/2abb9eec-ba32-45cb-b73d-8b52a8bd6bf1)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md b/docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md
new file mode 100644
index 00000000000..54941eaf523
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md
@@ -0,0 +1,150 @@
+---
+title: "方法 : ツール バー ボタンのメニュー イベントをトリガーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], ツール バー"
+  - "ToolBar コントロール [Windows フォーム], クリック イベント ハンドラー"
+  - "ToolBar コントロール [Windows フォーム], コーディング (ボタン クリック イベントを)"
+  - "ツール バー [Windows フォーム], クリック イベント ハンドラー"
+ms.assetid: 98374f70-993d-4ca4-89fb-48fea6ce5b45
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ツール バー ボタンのメニュー イベントをトリガーする
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームにツール バー ボタン付きの <xref:System.Windows.Forms.ToolBar> コントロールを実装する場合は、ユーザーによってクリックされたボタンを判別することが必要な場合があります。  
+  
+ <xref:System.Windows.Forms.ToolBar> コントロールの <xref:System.Windows.Forms.ToolBar.ButtonClick> イベントが発生した時点で、<xref:System.Windows.Forms.ToolBarButtonClickEventArgs> クラスの <xref:System.Windows.Forms.ToolBarButtonClickEventArgs.Button%2A> プロパティを評価できます。  次の例では、クリックされたボタンを示すメッセージ ボックスが表示されます。  詳細については、「[MessageBox クラス](frlrfSystemWindowsFormsMessageBoxClassTopic)」を参照してください。  
+  
+ 次の例では、Windows フォームに <xref:System.Windows.Forms.ToolBar> コントロールが追加されていると仮定しています。  
+  
+### ツール バーの Click イベントを処理するには  
+  
+1.  プロシージャで、<xref:System.Windows.Forms.ToolBar> コントロールにツール バー ボタンを追加します。  
+  
+    ```vb  
+    Public Sub ToolBarConfig()  
+    ' Instantiate the toolbar buttons, set their Text properties  
+    ' and add them to the ToolBar control.  
+       ToolBar1.Buttons.Add(New ToolBarButton("One"))  
+       ToolBar1.Buttons.Add(New ToolBarButton("Two"))  
+       ToolBar1.Buttons.Add(New ToolBarButton("Three"))  
+    ' Add the event handler delegate.  
+       AddHandler ToolBar1.ButtonClick, AddressOf Me.ToolBar1_ButtonClick  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    public void ToolBarConfig()   
+    {  
+       toolBar1.Buttons.Add(new ToolBarButton("One"));  
+       toolBar1.Buttons.Add(new ToolBarButton("Two"));  
+       toolBar1.Buttons.Add(new ToolBarButton("Three"));  
+  
+       toolBar1.ButtonClick +=   
+          new ToolBarButtonClickEventHandler(this.toolBar1_ButtonClick);  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    public:  
+       void ToolBarConfig()  
+       {  
+          toolBar1->Buttons->Add(gcnew ToolBarButton("One"));  
+          toolBar1->Buttons->Add(gcnew ToolBarButton("Two"));  
+          toolBar1->Buttons->Add(gcnew ToolBarButton("Three"));  
+  
+          toolBar1->ButtonClick +=   
+             gcnew ToolBarButtonClickEventHandler(this,  
+             &Form1::toolBar1_ButtonClick);  
+       }  
+    ```  
+  
+2.  <xref:System.Windows.Forms.ToolBar> コントロールの <xref:System.Windows.Forms.ToolBar.ButtonClick> イベントにイベント ハンドラーを追加します。  ケース切り替えステートメントと <xref:System.Windows.Forms.ToolBarButtonClickEventArgs> クラスを使用して、クリックされたツール バー ボタンを判別します。  判別された結果に基づいて、適切なメッセージ ボックスが表示されます。  
+  
+    > [!NOTE]
+    >  この例では、プレースホルダーとしてメッセージ ボックスを使用しています。  ツール バー ボタンがクリックされたときに実行するコードは、適宜追加できます。  
+  
+    ```vb  
+    Protected Sub ToolBar1_ButtonClick(ByVal sender As Object, _  
+    ByVal e As ToolBarButtonClickEventArgs)  
+    ' Evaluate the Button property of the ToolBarButtonClickEventArgs  
+    ' to determine which button was clicked.  
+       Select Case ToolBar1.Buttons.IndexOf(e.Button)  
+         Case 0  
+           MessageBox.Show("First toolbar button clicked")  
+         Case 1  
+           MessageBox.Show("Second toolbar button clicked")  
+         Case 2  
+           MessageBox.Show("Third toolbar button clicked")  
+       End Select  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void toolBar1_ButtonClick(object sender,  
+    ToolBarButtonClickEventArgs e)  
+    {  
+       // Evaluate the Button property of the ToolBarButtonClickEventArgs  
+       // to determine which button was clicked.  
+       switch (toolBar1.Buttons.IndexOf(e.Button))  
+       {  
+          case 0 :  
+             MessageBox.Show("First toolbar button clicked");  
+             break;  
+          case 1 :  
+             MessageBox.Show("Second toolbar button clicked");  
+             break;  
+          case 2 :  
+             MessageBox.Show("Third toolbar button clicked");  
+             break;  
+       }  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    protected:  
+       void toolBar1_ButtonClick(System::Object ^ sender,  
+          ToolBarButtonClickEventArgs ^ e)  
+       {  
+         // Evaluate the Button property of the ToolBarButtonClickEventArgs  
+         // to determine which button was clicked.  
+          switch (toolBar1->Buttons->IndexOf(e->Button))  
+          {  
+             case 0 :  
+                MessageBox::Show("First toolbar button clicked");  
+                break;  
+             case 1 :  
+                MessageBox::Show("Second toolbar button clicked");  
+                break;  
+             case 2 :  
+                MessageBox::Show("Third toolbar button clicked");  
+                break;  
+          }  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [方法 : ツール バー コントロールにボタンを追加する](../../../../docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md)   
+ [方法 : ツール バー ボタンのアイコンを定義する](../../../../docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md)   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-use-a-background-thread-to-search-for-files.md b/docs/framework/winforms/controls/how-to-use-a-background-thread-to-search-for-files.md
new file mode 100644
index 00000000000..ac76c18a6d3
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-use-a-background-thread-to-search-for-files.md
@@ -0,0 +1,776 @@
+---
+title: "方法 : バックグラウンド スレッドを使用してファイルを検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], マルチスレッド"
+  - "カスタム コントロール [Windows フォーム], サンプル"
+  - "マルチスレッドの Windows フォーム コントロールのサンプル [Windows フォーム]"
+  - "スレッド処理 [Windows フォーム], カスタム コントロール"
+ms.assetid: 7fe3956f-5b8f-4f78-8aae-c9eb0b28f13a
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : バックグラウンド スレッドを使用してファイルを検索する
+<xref:System.ComponentModel.BackgroundWorker> コンポーネントは、<xref:System.Threading> 名前空間に代わると共に追加の機能を提供します。ただし、<xref:System.Threading> 名前空間は、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[BackgroundWorker コンポーネントの概要](../../../../docs/framework/winforms/controls/backgroundworker-component-overview.md)」を参照してください。  
+  
+ Windows フォームは、本来アパートメント スレッドであるネイティブな Win32 ウィンドウに基づいているため、シングルスレッド アパートメント \(STA\) モデルを使用します。  STA モデルでは、任意のスレッドでウィンドウを作成できますが、ウィンドウの作成後にスレッドを切り替えることはできません。したがって、ウィンドウに対するすべての関数呼び出しは、そのウィンドウを作成したスレッドで実行される必要があります。  .NET Framework のクラスは、Windows フォームの外側ではフリー スレッド モデルを使用します。  .NET Framework におけるスレッド処理の詳細については、「[Threading](../../../../docs/standard/threading/index.md)」を参照してください。  
+  
+ STA モデルでは、コントロールを作成したスレッドの外部から呼び出される必要があるすべてのメソッドを、そのコントロールの作成スレッドにマーシャリングする \(そのコントロールの作成スレッドで実行する\) 必要があります。  基本クラス <xref:System.Windows.Forms.Control> には、この目的のためにいくつかのメソッド \(<xref:System.Windows.Forms.Control.Invoke%2A>、<xref:System.Windows.Forms.Control.BeginInvoke%2A>、および <xref:System.Windows.Forms.Control.EndInvoke%2A>\) が用意されています。  <xref:System.Windows.Forms.Control.Invoke%2A> は同期メソッド呼び出しを行い、<xref:System.Windows.Forms.Control.BeginInvoke%2A> は非同期メソッド呼び出しを行います。  
+  
+ リソース集中型のタスクのためのコントロールにマルチスレッドを使用すると、バックグラウンド スレッドでリソース集中型の計算が実行されている間もユーザー インターフェイスの応答性を維持できます。  
+  
+ バックグラウンド スレッドを使用して、ディレクトリから特定の検索文字列に一致するファイルを再帰的に検索し、検索結果をリスト ボックスに表示するマルチスレッド Windows フォーム コントロールを次のサンプル \(`DirectorySearcher`\) に示します。  このサンプルで示されている主要な機能は次のとおりです。  
+  
+-   `DirectorySearcher` は、検索を実行するための新しいスレッドを開始します。  このスレッドは `ThreadProcedure` メソッドを実行し、ThreadProcedure メソッドは実際の検索を実行してリスト ボックスに結果を表示するヘルパー メソッド `RecurseDirectory` を呼び出します。  ただし、リスト ボックスに検索結果を表示するには、次の 2 つの項目で説明するように、スレッド間呼び出しを実行する必要があります。  
+  
+-   `DirectorySearcher` は、リスト ボックスにファイルを追加するために `AddFiles` メソッドを定義します。しかし、`AddFiles` は `DirectorySearcher` を作成した STA スレッドでしか実行できないため、`RecurseDirectory` が `AddFiles` を直接呼び出すことはできません。  
+  
+-   `RecurseDirectory` が `AddFiles` を呼び出すための唯一の方法は、スレッド間呼び出しを実行することです。つまり、<xref:System.Windows.Forms.Control.Invoke%2A> または <xref:System.Windows.Forms.Control.BeginInvoke%2A> を呼び出して `DirectorySearcher` の作成スレッドに `AddFiles` をマーシャリングします。  `RecurseDirectory` は、<xref:System.Windows.Forms.Control.BeginInvoke%2A> を使用して非同期の呼び出しを実行できるようにします。  
+  
+-   メソッドのマーシャリングには、関数ポインターまたはコールバックに相当する機能が必要です。  これは、.NET Framework のデリゲートを使用して実現できます。  <xref:System.Windows.Forms.Control.BeginInvoke%2A> は引数としてデリゲートを受け取ります。  したがって、`DirectorySearcher` はデリゲートを定義し \(`FileListDelegate`\) `AddFiles` をコンストラクターで `FileListDelegate` に関連付け、このデリゲート インスタンスを <xref:System.Windows.Forms.Control.BeginInvoke%2A> に渡します。  また、`DirectorySearcher` は、検索が完了した時点にマーシャリングされるイベント デリゲートも定義します。  
+  
+```vb  
+Option Strict  
+Option Explicit  
+  
+Imports System  
+Imports System.IO  
+Imports System.Threading  
+Imports System.Windows.Forms  
+  
+Namespace Microsoft.Samples.DirectorySearcher  
+   ' <summary>  
+   '      This class is a Windows Forms control that implements a simple directory searcher.  
+   '      You provide, through code, a search string and it will search directories on  
+   '      a background thread, populating its list box with matches.  
+   ' </summary>  
+   Public Class DirectorySearcher  
+      Inherits Control  
+      ' Define a special delegate that handles marshaling  
+      ' lists of file names from the background directory search  
+      ' thread to the thread that contains the list box.  
+      Delegate Sub FileListDelegate(files() As String, startIndex As Integer, count As Integer)  
+  
+      Private _listBox As ListBox  
+      Private _searchCriteria As String  
+      Private _searching As Boolean  
+      Private _deferSearch As Boolean  
+      Private _searchThread As Thread  
+      Private _fileListDelegate As FileListDelegate  
+      Private _onSearchComplete As EventHandler  
+  
+      Public Sub New()  
+         _listBox = New ListBox()  
+         _listBox.Dock = DockStyle.Fill  
+  
+         Controls.Add(_listBox)  
+  
+         _fileListDelegate = New FileListDelegate(AddressOf AddFiles)  
+         _onSearchComplete = New EventHandler(AddressOf OnSearchComplete)  
+      End Sub  
+  
+      Public Property SearchCriteria() As String  
+         Get  
+            Return _searchCriteria  
+         End Get  
+         Set  
+            ' If currently searching, abort  
+            ' the search and restart it after  
+            ' setting the new criteria.  
+            '  
+            Dim wasSearching As Boolean = Searching  
+  
+            If wasSearching Then  
+               StopSearch()  
+            End If  
+  
+            _listBox.Items.Clear()  
+            _searchCriteria = value  
+  
+            If wasSearching Then  
+               BeginSearch()  
+            End If  
+         End Set  
+      End Property  
+  
+      Public ReadOnly Property Searching() As Boolean  
+         Get  
+            Return _searching  
+         End Get  
+      End Property  
+  
+      Public Event SearchComplete As EventHandler  
+  
+      ' <summary>  
+      ' This method is called from the background thread.  It is called through  
+      ' a BeginInvoke call so that it is always marshaled to the thread that  
+      ' owns the list box control.  
+      ' </summary>  
+      ' <param name="files"></param>  
+      ' <param name="startIndex"></param>  
+      ' <param name="count"></param>  
+      Private Sub AddFiles(files() As String, startIndex As Integer, count As Integer)  
+         While count > 0  
+            count -= 1  
+            _listBox.Items.Add(files((startIndex + count)))  
+         End While  
+      End Sub  
+  
+      Public Sub BeginSearch()  
+         ' Create the search thread, which   
+         ' will begin the search.  
+         ' If already searching, do nothing.  
+         '  
+         If Searching Then  
+            Return  
+         End If  
+  
+         ' Start the search if the handle has  
+         ' been created. Otherwise, defer it until the  
+         ' handle has been created.  
+         If IsHandleCreated Then  
+            _searchThread = New Thread(New ThreadStart(AddressOf ThreadProcedure))  
+            _searching = True  
+            _searchThread.Start()  
+         Else  
+            _deferSearch = True  
+         End If  
+      End Sub  
+  
+      Protected Overrides Sub OnHandleDestroyed(e As EventArgs)  
+         ' If the handle is being destroyed and you are not  
+         ' recreating it, then abort the search.  
+         If Not RecreatingHandle Then  
+            StopSearch()  
+         End If  
+         MyBase.OnHandleDestroyed(e)  
+      End Sub  
+  
+      Protected Overrides Sub OnHandleCreated(e As EventArgs)  
+         MyBase.OnHandleCreated(e)  
+         If _deferSearch Then  
+            _deferSearch = False  
+            BeginSearch()  
+         End If  
+      End Sub  
+  
+      ' <summary>  
+      ' This method is called by the background thread when it has  
+      ' finished the search.  
+      ' </summary>  
+      ' <param name="sender"></param>  
+      ' <param name="e"></param>  
+      Private Sub OnSearchComplete(sender As Object, e As EventArgs)  
+         RaiseEvent SearchComplete(sender, e)  
+      End Sub  
+  
+      Public Sub StopSearch()  
+         If Not _searching Then  
+            Return  
+         End If  
+  
+         If _searchThread.IsAlive Then  
+            _searchThread.Abort()  
+            _searchThread.Join()  
+         End If  
+  
+         _searchThread = Nothing  
+         _searching = False  
+      End Sub  
+  
+      ' <summary>  
+      ' Recurses the given path, adding all files on that path to   
+      ' the list box. After it finishes with the files, it  
+      ' calls itself once for each directory on the path.  
+      ' </summary>  
+      ' <param name="searchPath"></param>  
+      Private Sub RecurseDirectory(searchPath As String)  
+         ' Split searchPath into a directory and a wildcard specification.  
+         '  
+         Dim directoryPath As String = Path.GetDirectoryName(searchPath)  
+         Dim search As String = Path.GetFileName(searchPath)  
+  
+         ' If a directory or search criteria are not specified, then return.  
+         '  
+         If directoryPath Is Nothing Or search Is Nothing Then  
+            Return  
+         End If  
+  
+         Dim files() As String  
+  
+         ' File systems like NTFS that have  
+         ' access permissions might result in exceptions  
+         ' when looking into directories without permission.  
+         ' Catch those exceptions and return.  
+         Try  
+            files = Directory.GetFiles(directoryPath, search)  
+         Catch e As UnauthorizedAccessException  
+            Return  
+         Catch e As DirectoryNotFoundException  
+            Return  
+         End Try  
+  
+         ' Perform a BeginInvoke call to the list box  
+         ' in order to marshal to the correct thread. It is not  
+         ' very efficient to perform this marshal once for every  
+         ' file, so batch up multiple file calls into one  
+         ' marshal invocation.  
+         Dim startingIndex As Integer = 0  
+         While startingIndex < files.Length  
+            ' Batch up 20 files at once, unless at the  
+            ' end.  
+            '  
+            Dim count As Integer = 20  
+            If count + startingIndex >= files.Length Then  
+               count = files.Length - startingIndex  
+            End If  
+            ' Begin the cross-thread call. Because you are passing  
+            ' immutable objects into this invoke method, you do not have to  
+            ' wait for it to finish. If these were complex objects, you would  
+            ' have to either create new instances of them or   
+            ' wait for the thread to process this invoke before modifying  
+            ' the objects.  
+            Dim r As IAsyncResult = BeginInvoke(_fileListDelegate, New Object() {files, startingIndex, count})  
+            startingIndex += count  
+         End While  
+         ' Now that you have finished the files in this directory, recurse  
+         ' for each subdirectory.  
+         Dim directories As String() = Directory.GetDirectories(directoryPath)  
+         Dim d As String  
+         For Each d In  directories  
+            RecurseDirectory(Path.Combine(d, search))  
+         Next d  
+      End Sub  
+  
+      '/ <summary>  
+      '/ This is the actual thread procedure. This method runs in a background  
+      '/ thread to scan directories. When finished, it simply exits.  
+      '/ </summary>  
+      Private Sub ThreadProcedure()  
+         ' Get the search string. Individual   
+         ' field assigns are atomic in .NET, so you do not  
+         ' need to use any thread synchronization to grab  
+         ' the string value here.  
+         Try  
+            Dim localSearch As String = SearchCriteria  
+  
+            ' Now, search the file system.  
+            '  
+            RecurseDirectory(localSearch)  
+         Finally  
+            ' You are done with the search, so update.  
+            '  
+            _searching = False  
+  
+            ' Raise an event that notifies the user that  
+            ' the search has terminated.    
+            ' You do not have to do this through a marshaled call, but  
+            ' marshaling is recommended for the following reason:  
+            ' Users of this control do not know that it is  
+            ' multithreaded, so they expect its events to   
+            ' come back on the same thread as the control.  
+            BeginInvoke(_onSearchComplete, New Object() {Me, EventArgs.Empty})  
+         End Try  
+      End Sub  
+   End Class  
+End Namespace  
+  
+```  
+  
+```csharp  
+namespace Microsoft.Samples.DirectorySearcher  
+{  
+   using System;  
+   using System.IO;  
+   using System.Threading;  
+   using System.Windows.Forms;  
+  
+   /// <summary>  
+   ///      This class is a Windows Forms control that implements a simple directory searcher.  
+   ///      You provide, through code, a search string and it will search directories on  
+   ///      a background thread, populating its list box with matches.  
+   /// </summary>  
+   public class DirectorySearcher : Control  
+   {  
+      // Define a special delegate that handles marshaling  
+      // lists of file names from the background directory search  
+      // thread to the thread that contains the list box.  
+      private delegate void FileListDelegate(string[] files, int startIndex, int count);  
+  
+      private ListBox listBox;  
+      private string  searchCriteria;  
+      private bool searching;  
+      private bool deferSearch;  
+      private Thread searchThread;  
+      private FileListDelegate fileListDelegate;  
+      private EventHandler onSearchComplete;  
+  
+      public DirectorySearcher()  
+      {  
+         listBox = new ListBox();  
+         listBox.Dock = DockStyle.Fill;  
+  
+         Controls.Add(listBox);  
+  
+         fileListDelegate = new FileListDelegate(AddFiles);  
+         onSearchComplete = new EventHandler(OnSearchComplete);  
+      }  
+  
+      public string SearchCriteria   
+      {  
+         get   
+         {  
+            return searchCriteria;  
+         }  
+         set   
+         {  
+            // If currently searching, abort  
+            // the search and restart it after  
+            // setting the new criteria.  
+            //  
+            bool wasSearching = Searching;  
+  
+            if (wasSearching)  
+            {  
+               StopSearch();  
+            }  
+  
+            listBox.Items.Clear();  
+            searchCriteria = value;  
+  
+            if (wasSearching)  
+            {  
+               BeginSearch();  
+            }  
+         }  
+      }  
+  
+      public bool Searching   
+      {  
+         get   
+         {  
+            return searching;  
+         }  
+      }  
+  
+      public event EventHandler SearchComplete;  
+  
+      /// <summary>  
+      /// This method is called from the background thread. It is called through  
+      /// a BeginInvoke call so that it is always marshaled to the thread that  
+      /// owns the list box control.  
+      /// </summary>  
+      /// <param name="files"></param>  
+      /// <param name="startIndex"></param>  
+      /// <param name="count"></param>  
+      private void AddFiles(string[] files, int startIndex, int count)  
+      {  
+         while(count-- > 0)  
+         {  
+            listBox.Items.Add(files[startIndex + count]);  
+         }  
+      }  
+  
+      public void BeginSearch()   
+      {  
+         // Create the search thread, which   
+         // will begin the search.  
+         // If already searching, do nothing.  
+         //  
+         if (Searching)  
+         {  
+            return;  
+         }  
+  
+         // Start the search if the handle has  
+         // been created. Otherwise, defer it until the  
+         // handle has been created.  
+         if (IsHandleCreated)  
+         {  
+            searchThread = new Thread(new ThreadStart(ThreadProcedure));  
+            searching = true;  
+            searchThread.Start();  
+         }  
+         else  
+         {  
+            deferSearch = true;  
+         }  
+      }  
+  
+      protected override void OnHandleDestroyed(EventArgs e)  
+      {  
+         // If the handle is being destroyed and you are not  
+         // recreating it, then abort the search.  
+         if (!RecreatingHandle)  
+         {  
+            StopSearch();  
+         }  
+         base.OnHandleDestroyed(e);  
+      }  
+  
+      protected override void OnHandleCreated(EventArgs e)   
+      {  
+         base.OnHandleCreated(e);  
+         if (deferSearch)  
+         {  
+            deferSearch = false;  
+            BeginSearch();  
+         }  
+      }  
+  
+      /// <summary>  
+      /// This method is called by the background thread when it has finished  
+      /// the search.  
+      /// </summary>  
+      /// <param name="sender"></param>  
+      /// <param name="e"></param>  
+      private void OnSearchComplete(object sender, EventArgs e)  
+      {  
+         if (SearchComplete != null)  
+         {  
+            SearchComplete(sender, e);  
+         }  
+      }  
+  
+      public void StopSearch()  
+      {  
+         if (!searching)  
+         {  
+            return;  
+         }  
+  
+         if (searchThread.IsAlive)  
+         {  
+            searchThread.Abort();  
+            searchThread.Join();  
+         }  
+  
+         searchThread = null;  
+         searching = false;  
+      }  
+  
+      /// <summary>  
+      /// Recurses the given path, adding all files on that path to   
+      /// the list box. After it finishes with the files, it  
+      /// calls itself once for each directory on the path.  
+      /// </summary>  
+      /// <param name="searchPath"></param>  
+      private void RecurseDirectory(string searchPath)  
+      {  
+         // Split searchPath into a directory and a wildcard specification.  
+         //  
+         string directory = Path.GetDirectoryName(searchPath);  
+         string search = Path.GetFileName(searchPath);  
+  
+         // If a directory or search criteria are not specified, then return.  
+         //  
+         if (directory == null || search == null)  
+         {  
+            return;  
+         }  
+  
+         string[] files;  
+  
+         // File systems like NTFS that have  
+         // access permissions might result in exceptions  
+         // when looking into directories without permission.  
+         // Catch those exceptions and return.  
+         try   
+         {  
+            files = Directory.GetFiles(directory, search);  
+         }  
+         catch(UnauthorizedAccessException)  
+         {  
+            return;  
+         }  
+         catch(DirectoryNotFoundException)  
+         {  
+            return;  
+         }  
+  
+         // Perform a BeginInvoke call to the list box  
+         // in order to marshal to the correct thread. It is not  
+         // very efficient to perform this marshal once for every  
+         // file, so batch up multiple file calls into one  
+         // marshal invocation.  
+         int startingIndex = 0;  
+  
+         while(startingIndex < files.Length)  
+         {  
+            // Batch up 20 files at once, unless at the  
+            // end.  
+            //  
+            int count = 20;  
+            if (count + startingIndex >= files.Length)  
+            {  
+               count = files.Length - startingIndex;  
+            }  
+  
+            // Begin the cross-thread call. Because you are passing  
+            // immutable objects into this invoke method, you do not have to  
+            // wait for it to finish. If these were complex objects, you would  
+            // have to either create new instances of them or   
+            // wait for the thread to process this invoke before modifying  
+            // the objects.  
+            IAsyncResult r = BeginInvoke(fileListDelegate, new object[] {files, startingIndex, count});  
+            startingIndex += count;  
+         }  
+  
+         // Now that you have finished the files in this directory, recurse for  
+         // each subdirectory.  
+         string[] directories = Directory.GetDirectories(directory);  
+         foreach(string d in directories)  
+         {  
+            RecurseDirectory(Path.Combine(d, search));  
+         }  
+      }  
+  
+      /// <summary>  
+      /// This is the actual thread procedure. This method runs in a background  
+      /// thread to scan directories. When finished, it simply exits.  
+      /// </summary>  
+      private void ThreadProcedure()  
+      {  
+         // Get the search string. Individual   
+         // field assigns are atomic in .NET, so you do not  
+         // need to use any thread synchronization to grab  
+         // the string value here.  
+         try   
+         {  
+            string localSearch = SearchCriteria;  
+  
+            // Now, search the file system.  
+            //  
+            RecurseDirectory(localSearch);  
+         }  
+         finally  
+         {  
+            // You are done with the search, so update.  
+            //  
+            searching = false;  
+  
+            // Raise an event that notifies the user that  
+            // the search has terminated.    
+            // You do not have to do this through a marshaled call, but  
+            // marshaling is recommended for the following reason:  
+            // Users of this control do not know that it is  
+            // multithreaded, so they expect its events to   
+            // come back on the same thread as the control.  
+            BeginInvoke(onSearchComplete, new object[] {this, EventArgs.Empty});  
+         }  
+      }  
+   }  
+}  
+```  
+  
+## フォームでのマルチスレッド コントロールの使用  
+ フォームでマルチスレッドの `DirectorySearcher` コントロールを使用する方法の例を次に示します。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports Microsoft.Samples.DirectorySearcher  
+Imports System  
+Imports System.Drawing  
+Imports System.Collections  
+Imports System.ComponentModel  
+Imports System.Windows.Forms  
+Imports System.Data  
+  
+Namespace SampleUsage  
+  
+   ' <summary>  
+   '      Summary description for Form1.  
+   ' </summary>  
+   Public Class Form1  
+      Inherits System.Windows.Forms.Form  
+      Private WithEvents directorySearcher As DirectorySearcher  
+      Private searchText As System.Windows.Forms.TextBox  
+      Private searchLabel As System.Windows.Forms.Label  
+      Private WithEvents searchButton As System.Windows.Forms.Button  
+  
+      Public Sub New()  
+         '  
+         ' Required for Windows Forms designer support.  
+         '  
+         InitializeComponent()  
+         '  
+         ' Add any constructor code after InitializeComponent call here.  
+         '  
+      End Sub  
+  
+      #Region "Windows Form Designer generated code"  
+      ' <summary>  
+      '      Required method for designer support. Do not modify  
+      '      the contents of this method with the code editor.  
+      ' </summary>  
+      Private Sub InitializeComponent()  
+         Me.directorySearcher = New Microsoft.Samples.DirectorySearcher.DirectorySearcher()  
+         Me.searchButton = New System.Windows.Forms.Button()  
+         Me.searchText = New System.Windows.Forms.TextBox()  
+         Me.searchLabel = New System.Windows.Forms.Label()  
+         Me.directorySearcher.Anchor = System.Windows.Forms.AnchorStyles.Top Or System.Windows.Forms.AnchorStyles.Bottom Or System.Windows.Forms.AnchorStyles.Left Or System.Windows.Forms.AnchorStyles.Right  
+         Me.directorySearcher.Location = New System.Drawing.Point(8, 72)  
+         Me.directorySearcher.SearchCriteria = Nothing  
+         Me.directorySearcher.Size = New System.Drawing.Size(271, 173)  
+         Me.directorySearcher.TabIndex = 2  
+         Me.searchButton.Location = New System.Drawing.Point(8, 16)  
+         Me.searchButton.Size = New System.Drawing.Size(88, 40)  
+         Me.searchButton.TabIndex = 0  
+         Me.searchButton.Text = "&Search"  
+         Me.searchText.Anchor = System.Windows.Forms.AnchorStyles.Top Or System.Windows.Forms.AnchorStyles.Left Or System.Windows.Forms.AnchorStyles.Right  
+         Me.searchText.Location = New System.Drawing.Point(104, 24)  
+         Me.searchText.Size = New System.Drawing.Size(175, 20)  
+         Me.searchText.TabIndex = 1  
+         Me.searchText.Text = "c:\*.cs"  
+         Me.searchLabel.ForeColor = System.Drawing.Color.Red  
+         Me.searchLabel.Location = New System.Drawing.Point(104, 48)  
+         Me.searchLabel.Size = New System.Drawing.Size(176, 16)  
+         Me.searchLabel.TabIndex = 3  
+         Me.ClientSize = New System.Drawing.Size(291, 264)  
+         Me.Controls.AddRange(New System.Windows.Forms.Control() {Me.searchLabel, Me.directorySearcher, Me.searchText, Me.searchButton})  
+         Me.Text = "Search Directories"  
+      End Sub  
+      #End Region  
+  
+      ' <summary>  
+      '    The main entry point for the application.  
+      ' </summary>  
+      <STAThread()> _  
+      Shared Sub Main()  
+         Application.Run(New Form1())  
+      End Sub  
+  
+      Private Sub searchButton_Click(sender As Object, e As System.EventArgs) Handles searchButton.Click  
+         directorySearcher.SearchCriteria = searchText.Text  
+         searchLabel.Text = "Searching..."  
+         directorySearcher.BeginSearch()  
+      End Sub  
+  
+      Private Sub directorySearcher_SearchComplete(sender As Object, e As System.EventArgs) Handles directorySearcher.SearchComplete  
+         searchLabel.Text = String.Empty  
+      End Sub  
+   End Class  
+End Namespace  
+  
+```  
+  
+```csharp  
+namespace SampleUsage  
+{  
+   using Microsoft.Samples.DirectorySearcher;  
+   using System;  
+   using System.Drawing;  
+   using System.Collections;  
+   using System.ComponentModel;  
+   using System.Windows.Forms;  
+   using System.Data;  
+  
+   /// <summary>  
+   ///      Summary description for Form1.  
+   /// </summary>  
+   public class Form1 : System.Windows.Forms.Form  
+   {  
+      private DirectorySearcher directorySearcher;  
+      private System.Windows.Forms.TextBox searchText;  
+      private System.Windows.Forms.Label searchLabel;  
+      private System.Windows.Forms.Button searchButton;  
+  
+      public Form1()  
+      {  
+         //  
+         // Required for Windows Forms designer support.  
+         //  
+         InitializeComponent();  
+  
+         //  
+         // Add any constructor code after InitializeComponent call here.  
+         //  
+      }  
+  
+      #region Windows Form Designer generated code  
+      /// <summary>  
+      ///      Required method for designer support. Do not modify  
+      ///      the contents of this method with the code editor.  
+      /// </summary>  
+      private void InitializeComponent()  
+      {  
+         this.directorySearcher = new Microsoft.Samples.DirectorySearcher.DirectorySearcher();  
+         this.searchButton = new System.Windows.Forms.Button();  
+         this.searchText = new System.Windows.Forms.TextBox();  
+         this.searchLabel = new System.Windows.Forms.Label();  
+         this.directorySearcher.Anchor = (((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)   
+            | System.Windows.Forms.AnchorStyles.Left)   
+            | System.Windows.Forms.AnchorStyles.Right);  
+         this.directorySearcher.Location = new System.Drawing.Point(8, 72);  
+         this.directorySearcher.SearchCriteria = null;  
+         this.directorySearcher.Size = new System.Drawing.Size(271, 173);  
+         this.directorySearcher.TabIndex = 2;  
+         this.directorySearcher.SearchComplete += new System.EventHandler(this.directorySearcher_SearchComplete);  
+         this.searchButton.Location = new System.Drawing.Point(8, 16);  
+         this.searchButton.Size = new System.Drawing.Size(88, 40);  
+         this.searchButton.TabIndex = 0;  
+         this.searchButton.Text = "&Search";  
+         this.searchButton.Click += new System.EventHandler(this.searchButton_Click);  
+         this.searchText.Anchor = ((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left)   
+            | System.Windows.Forms.AnchorStyles.Right);  
+         this.searchText.Location = new System.Drawing.Point(104, 24);  
+         this.searchText.Size = new System.Drawing.Size(175, 20);  
+         this.searchText.TabIndex = 1;  
+         this.searchText.Text = "c:\\*.cs";  
+         this.searchLabel.ForeColor = System.Drawing.Color.Red;  
+         this.searchLabel.Location = new System.Drawing.Point(104, 48);  
+         this.searchLabel.Size = new System.Drawing.Size(176, 16);  
+         this.searchLabel.TabIndex = 3;  
+         this.ClientSize = new System.Drawing.Size(291, 264);  
+         this.Controls.AddRange(new System.Windows.Forms.Control[] {this.searchLabel,  
+                                                        this.directorySearcher,  
+                                                        this.searchText,  
+                                                        this.searchButton});  
+         this.Text = "Search Directories";  
+  
+      }  
+      #endregion  
+  
+      /// <summary>  
+      ///    The main entry point for the application.  
+      /// </summary>  
+      [STAThread]  
+      static void Main()   
+      {  
+         Application.Run(new Form1());  
+      }  
+  
+      private void searchButton_Click(object sender, System.EventArgs e)  
+      {  
+         directorySearcher.SearchCriteria = searchText.Text;  
+         searchLabel.Text = "Searching...";  
+         directorySearcher.BeginSearch();  
+      }  
+  
+      private void directorySearcher_SearchComplete(object sender, System.EventArgs e)  
+      {  
+         searchLabel.Text = string.Empty;  
+      }  
+   }  
+}  
+```  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-use-a-control-rendering-class.md b/docs/framework/winforms/controls/how-to-use-a-control-rendering-class.md
new file mode 100644
index 00000000000..d6b416aac43
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-use-a-control-rendering-class.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : コントロールの描画クラスを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロフェッショナルな外観, 描画 (Windows フォーム コントロールの)"
+  - "視覚スタイル, 描画 (Windows フォーム コントロールの)"
+  - "ビジュアル テーマ, 適用 (Windows フォーム コントロールに)"
+ms.assetid: c0125e34-cd74-4c35-818c-3e40f462b0a3
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : コントロールの描画クラスを使用する
+<xref:System.Windows.Forms.ComboBoxRenderer> クラスを使用してコンボ ボックス コントロールのドロップダウン矢印を表示する方法を次の例に示します。  この例は単純なカスタム コントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドで構成されています。  <xref:System.Windows.Forms.ComboBoxRenderer.IsSupported%2A?displayProperty=fullName> プロパティを使用して、アプリケーション ウィンドウのクライアント領域で visual スタイルを有効にするかどうかを指定します。  visual スタイルをアクティブにすると、<xref:System.Windows.Forms.ComboBoxRenderer.DrawDropDownButton%2A?displayProperty=fullName> メソッドは、visual スタイルを使用してドロップダウン矢印を表示します。アクティブでない場合、<xref:System.Windows.Forms.ControlPaint.DrawComboButton%2A?displayProperty=fullName> メソッドは従来の Windows スタイルでドロップダウン矢印を表示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms_ControlRenderer#10](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms_ControlRenderer/cpp/form1.cpp#10)]
+ [!code-csharp[System.Windows.Forms_ControlRenderer#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms_ControlRenderer/CS/form1.cs#10)]
+ [!code-vb[System.Windows.Forms_ControlRenderer#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms_ControlRenderer/VB/form1.vb#10)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   <xref:System.Windows.Forms.Control> クラスから派生したカスタム コントロール。  
+  
+-   カスタム コントロールをホストする <xref:System.Windows.Forms.Form>。  
+  
+-   <xref:System?displayProperty=fullName>、<xref:System.Drawing?displayProperty=fullName>、<xref:System.Windows.Forms?displayProperty=fullName>、および <xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> の各名前空間への参照。  
+  
+## 参照  
+ [visual スタイルが使用されているコントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-use-the-spring-property-interactively-in-a-statusstrip.md b/docs/framework/winforms/controls/how-to-use-the-spring-property-interactively-in-a-statusstrip.md
new file mode 100644
index 00000000000..b7e64bbd6dc
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-use-the-spring-property-interactively-in-a-statusstrip.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : StatusStrip 内で Spring プロパティを対話的に使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Spring プロパティ [Windows フォーム]"
+  - "ステータス バー, 例"
+  - "StatusStrip コントロール [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: 18bde842-a93c-48dd-9db3-15738a1775ce
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : StatusStrip 内で Spring プロパティを対話的に使用する
+<xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> プロパティを使用して、<xref:System.Windows.Forms.StatusStrip> コントロールに <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールを配置できます。  <xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> プロパティは、<xref:System.Windows.Forms.ToolStripStatusLabel> コントロールが <xref:System.Windows.Forms.StatusStrip> コントロールの使用可能な領域を自動的に入力するかどうかを決定します。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> プロパティを使用して、<xref:System.Windows.Forms.StatusStrip> コントロールに <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールを配置する方法を示します。  <xref:System.Windows.Forms.ToolStripItem.Click> イベント ハンドラーは、exclusive\-or \(XOR\) 演算を実行して、<xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> プロパティの値を切り替えます。  
+  
+ このコード例を使用するには、アプリケーションをコンパイルして実行し、<xref:System.Windows.Forms.StatusStrip> コントロールの **\[中間 \(スプリング\)\]** をクリックして、<xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> プロパティの値を切り替えます。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#1)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#1)]  
+[!code-csharp[System.Windows.Forms.ToolStrip.Misc#50](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#50)]
+[!code-vb[System.Windows.Forms.ToolStrip.Misc#50](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#50)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripMenuItem>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-use-toolstrippanels-for-mdi.md b/docs/framework/winforms/controls/how-to-use-toolstrippanels-for-mdi.md
new file mode 100644
index 00000000000..1c36b614939
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-use-toolstrippanels-for-mdi.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ToolStripPanel を MDI で使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI, 使用 (ToolStripPanels を) [Windows フォーム]"
+  - "ツール バー [Windows フォーム], 使用 (MDI 用に)"
+  - "ToolStripPanel コントロール [Windows フォーム], 使用 (MDI 用に)"
+ms.assetid: d6b884fc-0846-465f-83c3-5dc0fe93b00f
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ToolStripPanel を MDI で使用する
+<xref:System.Windows.Forms.ToolStripPanel> では、<xref:System.Windows.Forms.ToolStripPanel.Join%2A> メソッドを使用することにより、マルチ ドキュメント インターフェイス \(MDI\) アプリケーションに柔軟に対応できます。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStripPanel> コントロールを MDI で使用する方法を示します。  
+  
+ [!code-csharp[System.Windows.Forms.ToolStrip.Misc#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/CS/Program.cs#10)]
+ [!code-vb[System.Windows.Forms.ToolStrip.Misc#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.Misc/VB/Program.vb#10)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System.Design、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripPanel>   
+ [方法 : ToolStripPanel を結合する](../../../../docs/framework/winforms/controls/how-to-join-toolstrippanels.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-use-tooltips-in-toolstrip-controls.md b/docs/framework/winforms/controls/how-to-use-tooltips-in-toolstrip-controls.md
new file mode 100644
index 00000000000..d768f9bf7eb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-use-tooltips-in-toolstrip-controls.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : ToolStrip コントロールにツールヒントを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], 追加 (ツールヒントを)"
+  - "ToolStrip コントロール [Windows フォーム], 追加 (ツールヒントを)"
+  - "ツールヒント [Windows フォーム], 追加"
+ms.assetid: c5d86024-a7c5-44ee-8b3f-2daf53d80d3e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : ToolStrip コントロールにツールヒントを使用する
+<xref:System.Windows.Forms.ToolStrip> コントロールの <xref:System.Windows.Forms.ToolStrip.ShowItemToolTips%2A> プロパティに `true` を設定することで、必要なコントロールに対して <xref:System.Windows.Forms.ToolTip> を表示できます。  
+  
+### ツールヒントを表示するには  
+  
+-   コントロールの <xref:System.Windows.Forms.ToolStrip.ShowItemToolTips%2A> プロパティを `true` に設定します。  
+  
+     <xref:System.Windows.Forms.ToolStrip.ShowItemToolTips%2A?displayProperty=fullName> の既定値は、`true` です。また、<xref:System.Windows.Forms.MenuStrip.ShowItemToolTips%2A?displayProperty=fullName> と <xref:System.Windows.Forms.StatusStrip.ShowItemToolTips%2A?displayProperty=fullName> の既定値は、`false` です。  
+  
+### ToolStripButton のツールヒント テキストに ToolTipText プロパティを使用するには  
+  
+1.  ボタンの <xref:System.Windows.Forms.ToolStrip.ShowItemToolTips%2A> プロパティを `true` に設定します。  
+  
+2.  ボタンの <xref:System.Windows.Forms.ToolStripButton.AutoToolTip%2A?displayProperty=fullName> プロパティを `false` に設定します。  
+  
+     <xref:System.Windows.Forms.ToolStripButton>、<xref:System.Windows.Forms.ToolStripDropDownButton>、および <xref:System.Windows.Forms.ToolStripSplitButton> の `AutoToolTip` プロパティは、既定では `true` です。  
+  
+     <xref:System.Windows.Forms.ToolStripButton> は、既定では、<xref:System.Windows.Forms.ToolTip> テキストに対してその `Text` プロパティを使用します。  <xref:System.Windows.Forms.ToolStripButton> <xref:System.Windows.Forms.ToolTip> にカスタム テキストを表示するには、この手順に従ってください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStripItemDisplayStyle> を <xref:System.Windows.Forms.ToolStripItemDisplayStyle> または <xref:System.Windows.Forms.ToolStripItemDisplayStyle> に設定すると、ボタンにテキストは表示されませんが、ツールヒントは変わらず表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip.ShowItemToolTips%2A>   
+ <xref:System.Windows.Forms.ToolStripButton>   
+ <xref:System.Windows.Forms.ToolStripDropDownButton>   
+ <xref:System.Windows.Forms.ToolStripSplitButton>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..453795350db
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのデータを検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 検証"
+  - "データ グリッド, 検証 (データを)"
+  - "データの妥当性検査, Windows フォーム"
+  - "DataGridView コントロール [Windows フォーム], データの妥当性検査"
+ms.assetid: d10aef35-701e-4a3c-a684-2a2ed1aeaca6
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : Windows フォーム DataGridView コントロールのデータを検証する
+ユーザーによって <xref:System.Windows.Forms.DataGridView> コントロールに入力されたデータを検証する方法を次のコード例に示します。  この例では、<xref:System.Windows.Forms.DataGridView> には、Northwind サンプル データベースの `Customers` テーブルの行が読み込まれます。  ユーザーが `CompanyName` 列内のセルを編集すると、値の有効性をテストするために、空ではないことが確認されます。  <xref:System.Windows.Forms.DataGridView.CellValidating> イベントのイベント ハンドラーによって値が空の文字列であることが検出されると、<xref:System.Windows.Forms.DataGridView> では、ユーザーが空ではない文字列を入力するまでそのセルから移動できなくなります。  
+  
+ このコード例の詳細な説明については、「[チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#00)]
+ [!code-vb[System.Windows.Forms.DataGridViewDataValidation#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#00)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Windows.Forms、および System.XML の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## .NET Framework セキュリティ  
+ 接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-validate-input-with-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/how-to-validate-input-with-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..d3b6945bea8
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-validate-input-with-the-windows-forms-datagrid-control.md
@@ -0,0 +1,100 @@
+---
+title: "方法 : Windows フォームの DataGrid コントロールを使用して入力データを検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGrid コントロール [Windows フォーム], 例"
+  - "DataGrid コントロール [Windows フォーム], 検証 (入力を)"
+  - "例 [Windows フォーム], DataGrid コントロール"
+  - "ユーザー入力, 検証"
+  - "検証, ユーザー入力"
+ms.assetid: f1e9c3a0-d0a1-4893-a615-b4b0db046c63
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームの DataGrid コントロールを使用して入力データを検証する
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロールで使用できる入力データの検証には 2 種類の方法があります。  ユーザーが適切でないデータ型 \(たとえば整数型のセルに文字列\) を入力した場合、その入力された無効な値は既存の有効な値に置き換えられます。  このような入力データの検証は自動的に行われ、カスタマイズはできません。  
+  
+ もう一方の入力データの検証は、不適切なデータをすべて拒否する場合に使用できます。たとえば 1 以上の値が必要なフィールドに 0 を入力しようとする場合や、適切でない文字列を入力しようとする場合にそのデータを拒否します。  <xref:System.Data.DataTable.ColumnChanging> イベントまたは <xref:System.Data.DataTable.RowChanging> イベントに対してイベント ハンドラーを記述することにより、データセット内で実施できます。  次に示す例では、<xref:System.Data.DataTable.ColumnChanging> イベントを使用しています。"Product" 列では特に不適切な値が許可されないためです。  <xref:System.Data.DataTable.RowChanging> イベントを使用すると、"End Date" 列の値が同一行の "Start Date" 列の値より後であることを確認できます。  
+  
+### ユーザー入力データを検証するには  
+  
+1.  適切なテーブルに対して <xref:System.Data.DataTable.ColumnChanging> イベントを処理するコードを記述します。  不適切な入力が検出された場合は、<xref:System.Data.DataRow> オブジェクトの <xref:System.Data.DataRow.SetColumnError%2A> メソッドを呼び出します。  
+  
+    ```vb  
+    Private Sub Customers_ColumnChanging(ByVal sender As Object, _  
+    ByVal e As System.Data.DataColumnChangeEventArgs)  
+       ' Only check for errors in the Product column  
+       If (e.Column.ColumnName.Equals("Product")) Then  
+          ' Do not allow "Automobile" as a product.  
+          If CType(e.ProposedValue, String) = "Automobile" Then  
+             Dim badValue As Object = e.ProposedValue  
+             e.ProposedValue = "Bad Data"  
+             e.Row.RowError = "The Product column contians an error"  
+             e.Row.SetColumnError(e.Column, "Product cannot be " & _  
+             CType(badValue, String))  
+          End If  
+       End If  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    //Handle column changing events on the Customers table  
+    private void Customers_ColumnChanging(object sender, System.Data.DataColumnChangeEventArgs e) {  
+  
+       //Only check for errors in the Product column  
+       if (e.Column.ColumnName.Equals("Product")) {  
+  
+          //Do not allow "Automobile" as a product  
+          if (e.ProposedValue.Equals("Automobile")) {  
+             object badValue = e.ProposedValue;  
+             e.ProposedValue = "Bad Data";  
+             e.Row.RowError = "The Product column contains an error";  
+             e.Row.SetColumnError(e.Column, "Product cannot be " + badValue);  
+          }  
+       }  
+    }  
+  
+    ```  
+  
+2.  イベントにイベント ハンドラーを接続します。  
+  
+     フォームの <xref:System.Windows.Forms.Form.Load> イベントまたはコンストラクターに、次のコードを記述します。  
+  
+    ```vb  
+    ' Assumes the grid is bound to a dataset called customersDataSet1  
+    ' with a table called Customers.  
+    ' Put this code in the form's Load event or its constructor.  
+    AddHandler customersDataSet1.Tables("Customers").ColumnChanging, AddressOf Customers_ColumnChanging  
+  
+    ```  
+  
+    ```csharp  
+    // Assumes the grid is bound to a dataset called customersDataSet1  
+    // with a table called Customers.  
+    // Put this code in the form's Load event or its constructor.  
+    customersDataSet1.Tables["Customers"].ColumnChanging += new DataColumnChangeEventHandler(this.Customers_ColumnChanging);  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGrid>   
+ <xref:System.Data.DataTable.ColumnChanging>   
+ <xref:System.Data.DataRow.SetColumnError%2A>   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md b/docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md
new file mode 100644
index 00000000000..034fcbf79bb
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md
@@ -0,0 +1,67 @@
+---
+title: "方法 : Windows フォーム TextBox コントロールで複数行を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "復帰"
+  - "CRLF"
+  - "行末"
+  - "ライン フィード"
+  - "MultiLine プロパティ (TextBox コントロールの)"
+  - "改行"
+  - "ScrollBars プロパティ, TextBox コントロールで"
+  - "TextBox コントロール [Windows フォーム], 表示 (複数行を)"
+  - "WordWrap プロパティ"
+ms.assetid: 43173201-0b74-4067-a472-605029ca5f35
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォーム TextBox コントロールで複数行を表示する
+既定の Windows フォーム <xref:System.Windows.Forms.TextBox> コントロールでは、単一行のテキストが表示され、スクロール バーは表示されません。  使用できる領域よりもテキストが長い場合は、テキストの一部だけが表示されます。  この既定の動作は、<xref:System.Windows.Forms.TextBox.Multiline%2A>、<xref:System.Windows.Forms.TextBoxBase.WordWrap%2A>、および <xref:System.Windows.Forms.TextBox.ScrollBars%2A> の各プロパティを適切な値に設定することにより変更できます。  
+  
+### TextBox コントロールに復帰を表示するには  
+  
+-   複数行 <xref:System.Windows.Forms.TextBox> に復帰を表示するには、<xref:System.Environment.NewLine%2A> プロパティを使用します。  
+  
+     エスケープ文字 \(\\\) の解釈は言語に固有であることに注意してください。  Visual Basic では、復帰とライン フィード文字の組み合わせを表すために `Chr$(13) & Chr$(10)` を使用します。  
+  
+### TextBox コントロールに複数行を表示するには  
+  
+1.  <xref:System.Windows.Forms.TextBox.Multiline%2A> プロパティを `true` に設定します。  <xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> を既定値である真 \(`true`\) に設定している場合、コントロールのテキストは 1 つ以上の段落として表示されます。真 \(true\) に設定していない場合、テキストはリストとして表示され、一部の行はコントロールの端で隠れてしまうことがあります。  
+  
+2.  <xref:System.Windows.Forms.TextBox.ScrollBars%2A> プロパティに適切な値を設定します。  
+  
+    |値|Description|  
+    |-------|-----------------|  
+    |<xref:System.Windows.Forms.ScrollBars>|テキストの段落が、ほぼ常にコントロールに適合する場合に使用します。  テキストが長すぎて一度にすべてを表示できない場合は、マウス ポインターを使用して、コントロールの内部を移動できます。|  
+    |<xref:System.Windows.Forms.ScrollBars>|<xref:System.Windows.Forms.TextBox> コントロールの幅よりも長い行のリストを表示する場合に使用します。|  
+    |<xref:System.Windows.Forms.ScrollBars>|リストがコントロールの高さよりも長い場合に使用します。|  
+  
+3.  <xref:System.Windows.Forms.TextBoxBase.WordWrap%2A> プロパティに適切な値を設定します。  
+  
+    |値|Description|  
+    |-------|-----------------|  
+    |`false`|コントロールのテキストは、自動的に折り返されないため、改行に到達するまで右方向にスクロールされます。  この値は、上記の <xref:System.Windows.Forms.ScrollBars> スクロール バーまたは <xref:System.Windows.Forms.ScrollBars> を選択した場合に使用します。|  
+    |`true` \(既定値\)|水平スクロール バーは表示されません。  この値は、上記の <xref:System.Windows.Forms.ScrollBars> スクロール バーまたは <xref:System.Windows.Forms.ScrollBars> を選択した場合に使用して、1 つ以上の段落を表示します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..c5af8fac0b2
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], イメージ列"
+  - "イメージ列"
+  - "イメージ列, Windows フォーム"
+ms.assetid: 8a37aa75-3c6e-4893-91d0-7a5f34bfe287
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する
+次のコード例は、対話型のユーザー インターフェイス \(UI\) で <xref:System.Windows.Forms.DataGridView> イメージ列を使用する方法を示しています。  例では、<xref:System.Windows.Forms.DataGridViewImageColumn> を使用したイメージのサイズとレイアウトの可能性も示しています。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.ImageColumn_TicTacToe#0](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ImageColumn_TicTacToe/CPP/tictactoe.cpp#0)]
+ [!code-csharp[System.Windows.Forms.DataGridView.ImageColumn_TicTacToe#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ImageColumn_TicTacToe/CS/tictactoe.cs#0)]
+ [!code-vb[System.Windows.Forms.DataGridView.ImageColumn_TicTacToe#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ImageColumn_TicTacToe/VB/tictactoe.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからのこの例のビルドについては、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewImageColumn>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)   
+ [方法 : Windows フォーム DataGridView コントロールのセルにイメージを表示する](../../../../docs/framework/winforms/controls/how-to-display-images-in-cells-of-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md b/docs/framework/winforms/controls/how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md
new file mode 100644
index 00000000000..01dfd07bfd8
--- /dev/null
+++ b/docs/framework/winforms/controls/how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : ToolStripControlHost を使用して Windows フォーム コントロールをラップする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], ラップ (コントロールを)"
+  - "ToolStrip コントロール [Windows フォーム], ホスト (コントロールを)"
+  - "ToolStrip コントロール [Windows フォーム], ラップ (コントロールを)"
+  - "ToolStripControlHost クラス"
+ms.assetid: e2ce4990-661d-4882-a116-8a9eb575dc84
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ToolStripControlHost を使用して Windows フォーム コントロールをラップする
+<xref:System.Windows.Forms.ToolStripControlHost> は、<xref:System.Windows.Forms.ToolStripControlHost> コンストラクターを使用するか、<xref:System.Windows.Forms.ToolStripControlHost> 自身を拡張することによって、任意の Windows フォーム コントロールをホストできるように設計されています。  より簡単にコントロールをラップするには、<xref:System.Windows.Forms.ToolStripControlHost> を拡張し、頻繁に使用するコントロールのプロパティとメソッドを公開するプロパティとメソッドを実装します。  コントロールのイベントを <xref:System.Windows.Forms.ToolStripControlHost> レベルで公開することもできます。  
+  
+### 派生により ToolStripControlHost でコントロールをホストするには  
+  
+1.  <xref:System.Windows.Forms.ToolStripControlHost> を拡張します。  必要なコントロールを渡して基底クラスのコンストラクターを呼び出す既定のコンストラクターを実装します。  
+  
+     [!code-cpp[System.Windows.Forms.ToolStripControlHost#10](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#10)]
+     [!code-csharp[System.Windows.Forms.ToolStripControlHost#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#10)]
+     [!code-vb[System.Windows.Forms.ToolStripControlHost#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#10)]  
+  
+2.  ラップされたコントロールと同じ型のプロパティを宣言し、プロパティのアクセサーに入れて正しい型のコントロールとして `Control` を返します。  
+  
+     [!code-cpp[System.Windows.Forms.ToolStripControlHost#11](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#11)]
+     [!code-csharp[System.Windows.Forms.ToolStripControlHost#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#11)]
+     [!code-vb[System.Windows.Forms.ToolStripControlHost#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#11)]  
+  
+3.  ラップされたコントロールで頻繁に使用される他のプロパティとメソッドを、拡張されたクラスのプロパティとメソッドを使用して公開します。  
+  
+     [!code-cpp[System.Windows.Forms.ToolStripControlHost#12](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#12)]
+     [!code-csharp[System.Windows.Forms.ToolStripControlHost#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#12)]
+     [!code-vb[System.Windows.Forms.ToolStripControlHost#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#12)]  
+  
+4.  必要に応じて、<xref:System.Windows.Forms.ToolStripControlHost.OnSubscribeControlEvents%2A> メソッドと <xref:System.Windows.Forms.ToolStripControlHost.OnUnsubscribeControlEvents%2A> メソッドをオーバーライドし、公開するコントロール イベントを追加します。  
+  
+     [!code-cpp[System.Windows.Forms.ToolStripControlHost#16](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#16)]
+     [!code-csharp[System.Windows.Forms.ToolStripControlHost#16](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#16)]
+     [!code-vb[System.Windows.Forms.ToolStripControlHost#16](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#16)]  
+  
+5.  公開するイベントに必要なラップを提供します。  
+  
+     [!code-cpp[System.Windows.Forms.ToolStripControlHost#17](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#17)]
+     [!code-csharp[System.Windows.Forms.ToolStripControlHost#17](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#17)]
+     [!code-vb[System.Windows.Forms.ToolStripControlHost#17](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#17)]  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.ToolStripControlHost#13](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CPP/form1.cpp#13)]
+ [!code-csharp[System.Windows.Forms.ToolStripControlHost#13](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/CS/form1.cs#13)]
+ [!code-vb[System.Windows.Forms.ToolStripControlHost#13](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStripControlHost/VB/form1.vb#13)]  
+  
+## コードのコンパイル  
+  
+-   この例で必要な要素は次のとおりです。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripControlHost>   
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-overview-windows-forms.md b/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-overview-windows-forms.md
new file mode 100644
index 00000000000..91a2524490d
--- /dev/null
+++ b/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-overview-windows-forms.md
@@ -0,0 +1,51 @@
+---
+title: "HScrollBar コントロールと VScrollBar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "HScrollBar"
+  - "VScrollBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "HScrollBar コントロール [Windows フォーム], HScrollBar の概要"
+  - "スクロール バー, スクロール バーの概要"
+  - "ScrollBar コントロール [Windows フォーム]"
+  - "ScrollBar コントロール [Windows フォーム], ScrollBar コントロールの概要"
+  - "VScrollBar コントロール [Windows フォーム], VScrollBar コントロールの概要"
+ms.assetid: 8b307679-1cae-41d8-99aa-3d1efd207cd6
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# HScrollBar コントロールと VScrollBar コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ScrollBar> コントロールを使用すると、アプリケーションまたはコントロール内で水平または垂直にスクロールすることにより、項目の長い一覧や大量の情報を簡単に見ることができるようになります。  スクロール バーは Windows インターフェイスの一般的な要素であるため、<xref:System.Windows.Forms.ScrollBar> コントロールは多くの場合、<xref:System.Windows.Forms.ScrollableControl> クラスから派生していないコントロールと共に使用されます。  同様に、多くの開発者は、独自のユーザー コントロールを作成するときに <xref:System.Windows.Forms.ScrollBar> コントロールを使用します。  
+  
+ <xref:System.Windows.Forms.HScrollBar> \(水平\) コントロールおよび <xref:System.Windows.Forms.VScrollBar> \(垂直\) コントロールは他のコントロールとは独立して動作し、独自のイベント、プロパティ、およびメソッドのセットを備えています。  <xref:System.Windows.Forms.ScrollBar> コントロールは、テキスト ボックス、リスト ボックス、コンボ ボックス、または MDI フォームに結び付けられている組み込みのスクロール バーとは異なります。<xref:System.Windows.Forms.TextBox> コントロールには、コントロールに結び付けられているスクロール バーを表示または非表示にするための <xref:System.Windows.Forms.TextBox.ScrollBars%2A> プロパティがあります。  
+  
+ <xref:System.Windows.Forms.ScrollBar> コントロールは、<xref:System.Windows.Forms.ScrollBar.Scroll> イベントを使用して、スクロール バーに沿ったスクロール ボックスの動きを監視します。スクロール ボックスは、"つまみ" とも呼ばれます。  <xref:System.Windows.Forms.ScrollBar.Scroll> イベントを使用すると、スクロール バーがドラッグされているときにスクロール バーの値にアクセスできます。  
+  
+## Value プロパティ  
+ <xref:System.Windows.Forms.ScrollBar.Value%2A> プロパティ \(既定では 0\) は、スクロール バー内でのスクロール ボックスの位置に対応する `integer` 値です。  スクロール ボックスの値が最小の場合、スクロール ボックスは水平スクロール バーの左端、または垂直スクロール バーの上端に移動します。  スクロール ボックスの値が最大の場合、スクロール ボックスは右端または下端に移動します。  同様に、最大と最小の中間の値では、スクロール ボックスの先端はスクロール バーの中央に位置します。  
+  
+ マウスをクリックしてスクロール バーの値を変更する以外に、ユーザーはスクロール ボックスをバー上の任意の位置にドラッグすることもできます。  結果の値はスクロール ボックスの位置によって決まりますが、常にユーザーによって設定された <xref:System.Windows.Forms.ScrollBar.Minimum%2A> プロパティから <xref:System.Windows.Forms.ScrollBar.Maximum%2A> プロパティまでの範囲内にあります。  
+  
+## LargeChange プロパティおよび SmallChange プロパティ  
+ ユーザーが PageUp キーか PageDown キーを押すか、またはスクロール ボックスのどちらかの側でスクロール バー領域をクリックすると、<xref:System.Windows.Forms.ScrollBar.LargeChange%2A> プロパティに設定された値に従って <xref:System.Windows.Forms.ScrollBar.Value%2A> プロパティが変化します。  
+  
+ ユーザーがいずれかの方向キーを押すか、またはスクロール バーのいずれかのボタンをクリックすると、<xref:System.Windows.Forms.ScrollBar.SmallChange%2A> プロパティに設定された値に従って <xref:System.Windows.Forms.ScrollBar.Value%2A> プロパティが変化します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.HScrollBar>   
+ <xref:System.Windows.Forms.VScrollBar>   
+ [Additions to Windows Forms for the .NET Framework 2.0](http://msdn.microsoft.com/ja-jp/c61a923d-3d6a-4c8c-820c-e94c83f3f9a8)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-windows-forms.md b/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-windows-forms.md
new file mode 100644
index 00000000000..ee9a2d5bbef
--- /dev/null
+++ b/docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "HScrollBar コントロールおよび VScrollBar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "HScrollBar コントロール [Windows フォーム]"
+  - "Scroll Bar コントロール [Windows フォーム]"
+  - "スクロール バー"
+  - "スクロール バー, Windows フォーム"
+  - "VScrollBar コントロール [Windows フォーム]"
+ms.assetid: f5e9cda7-d8f3-406b-b0e6-bdb4375d6eb0
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# HScrollBar コントロールおよび VScrollBar コントロール (Windows フォーム)
+Windows フォームのスクロール バー コントロールを使用すると、アプリケーションまたはコントロール内で水平または垂直にスクロールすることにより、項目の長い一覧や大量の情報を簡単にナビゲートできるようになります。  スクロール バーは、Windows インターフェイスの一般的な要素です。  
+  
+## このセクションの内容  
+ [HScrollBar コントロールと VScrollBar コントロールの概要](../../../../docs/framework/winforms/controls/hscrollbar-and-vscrollbar-controls-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.HScrollBar> コントロールと <xref:System.Windows.Forms.VScrollBar> コントロールの全般的な概念を説明します。これらのコントロールにより、ユーザーは大量の情報を水平および垂直にスクロールして見ることができます。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.HScrollBar>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.VScrollBar>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/imagelist-component-overview-windows-forms.md b/docs/framework/winforms/controls/imagelist-component-overview-windows-forms.md
new file mode 100644
index 00000000000..a8efcd43f58
--- /dev/null
+++ b/docs/framework/winforms/controls/imagelist-component-overview-windows-forms.md
@@ -0,0 +1,40 @@
+---
+title: "ImageList コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ImageList"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コレクション コントロール, イメージ"
+  - "アイコン リスト コントロール"
+  - "ImageList コンポーネント [Windows フォーム], ImageList コンポーネントの概要"
+ms.assetid: 7e25d89b-5633-40c1-afc3-82e0e301ffa2
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ImageList コンポーネントの概要 (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.ImageList> コンポーネントは、コントロールで表示するイメージの保存に使用します。  イメージ リストでは、一貫性のある 1 つのイメージのカタログのコードを記述することができます。  たとえば、ボタンの <xref:System.Windows.Forms.ButtonBase.ImageIndex%2A> プロパティまたは <xref:System.Windows.Forms.ButtonBase.ImageKey%2A> プロパティを変更するだけで、<xref:System.Windows.Forms.Button> コントロールによって表示されるイメージを回転できます。  同じイメージのリストを複数のコントロールに関連付けることもできます。  たとえば、<xref:System.Windows.Forms.ListView> コントロールと <xref:System.Windows.Forms.TreeView> コントロールの両方を使用して同じファイルのリストを表示する場合、イメージのリストでファイルのアイコンを変更すると、新しいアイコンが両方のビューに表示されます。  
+  
+## コントロールでの ImageList の使用  
+ `ImageList` プロパティを持つコントロール \(<xref:System.Windows.Forms.ListView> コントロールの場合は <xref:System.Windows.Forms.ListView.SmallImageList%2A> プロパティと <xref:System.Windows.Forms.ListView.LargeImageList%2A> プロパティ\) でイメージ リストを使用することができます。  イメージ リストに関連付けることができるコントロールは、<xref:System.Windows.Forms.ListView>、<xref:System.Windows.Forms.TreeView>、<xref:System.Windows.Forms.ToolBar>、<xref:System.Windows.Forms.TabControl>、<xref:System.Windows.Forms.Button>、<xref:System.Windows.Forms.CheckBox>、<xref:System.Windows.Forms.RadioButton>、および <xref:System.Windows.Forms.Label> の各コントロールです。  イメージ リストをコントロールに関連付けるには、コントロールの `ImageList` プロパティを <xref:System.Windows.Forms.ImageList> コンポーネントの名前に設定します。  
+  
+## キー プロパティ  
+ <xref:System.Windows.Forms.ImageList> コンポーネントのキー プロパティは <xref:System.Windows.Forms.ImageList.Images%2A> で、関連付けられたコントロールで使用される画像が含まれています。  各イメージは、そのインデックス値、またはそのキーを使用してアクセスできます。  <xref:System.Windows.Forms.ImageList.ColorDepth%2A> プロパティは、イメージをレンダリングする際の色の数を決定します。  イメージはすべて同じサイズで表示され、<xref:System.Windows.Forms.ImageList.ImageSize%2A> プロパティによって設定されます。  大きなイメージはサイズが合うように縮小されます。  
+  
+ [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] を使用している場合は、アプリケーションで使用する標準のイメージの大規模なライブラリにアクセスできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ImageList>   
+ [方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/imagelist-component-windows-forms.md b/docs/framework/winforms/controls/imagelist-component-windows-forms.md
new file mode 100644
index 00000000000..1814e5d528c
--- /dev/null
+++ b/docs/framework/winforms/controls/imagelist-component-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "ImageList コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ コントロール"
+  - "ImageList コンポーネント [Windows フォーム]"
+ms.assetid: 83b48634-782b-464d-9b7d-568dc6e0bef2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ImageList コンポーネント (Windows フォーム)
+Windows フォーム `ImageList` コンポーネントは、コントロールで表示するイメージの保存に使用します。  イメージ リストでは、一貫性のある 1 つのイメージのカタログのコードを記述することができます。  
+  
+## このセクションの内容  
+ [ImageList コンポーネントの概要](../../../../docs/framework/winforms/controls/imagelist-component-overview-windows-forms.md)  
+ このコンポーネントの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)  
+ イメージの一覧からイメージを追加および削除する方法を説明します。  
+  
+ 「[方法 : デザイナーを使って ImageList イメージを追加または削除する](http://msdn.microsoft.com/library/ms233674\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ImageList>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/implement-two-way-com-between-dhtml-and-client.md b/docs/framework/winforms/controls/implement-two-way-com-between-dhtml-and-client.md
new file mode 100644
index 00000000000..c9cbb181505
--- /dev/null
+++ b/docs/framework/winforms/controls/implement-two-way-com-between-dhtml-and-client.md
@@ -0,0 +1,120 @@
+---
+title: "方法 : DHTML コードとクライアント アプリケーション コード間の双方向の通信を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WebBrowser.ObjectForScripting"
+  - "WebBrowser.Document"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "通信, DHTML とクライアント アプリケーション"
+  - "DHTML, 埋め込み (Windows フォームに)"
+  - "例 [Windows フォーム], WebBrowser コントロール"
+  - "WebBrowser コントロール [Windows フォーム], 通信 (DHTML とクライアント アプリケーションの)"
+  - "WebBrowser コントロール [Windows フォーム], 例"
+ms.assetid: 55353a32-b09e-4479-a521-ff3a5ff9a708
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : DHTML コードとクライアント アプリケーション コード間の双方向の通信を実装する
+<xref:System.Windows.Forms.WebBrowser> コントロールを使用して、既存の動的 HTML \(DHTML\) Web アプリケーション コードを Windows フォーム クライアント アプリケーションに追加できます。  これは、DHTML ベースのコントロールの作成にかなりの開発時間を投資し、既存のコードを再作成せずに Windows フォームの機能が豊富なユーザー インターフェイスを利用したい場合に役立ちます。  
+  
+ <xref:System.Windows.Forms.WebBrowser> コントロールでは、<xref:System.Windows.Forms.WebBrowser.ObjectForScripting%2A> プロパティと <xref:System.Windows.Forms.WebBrowser.Document%2A> プロパティを通じて、クライアント アプリケーション コードと Web ページ内のスクリプト コードの間の双方向の通信を実装できます。  また、<xref:System.Windows.Forms.WebBrowser> コントロールを構成して、Web コントロールをアプリケーション フォームのその他のコントロールとシームレスに統合し、DHTML 実装を非表示にすることができます。  コントロールをシームレスに統合するには、背景色と視覚スタイルが残りのフォームと一致するように表示されるページの書式を設定し、<xref:System.Windows.Forms.WebBrowser.AllowWebBrowserDrop%2A>、<xref:System.Windows.Forms.WebBrowser.IsWebBrowserContextMenuEnabled%2A>、および <xref:System.Windows.Forms.WebBrowser.WebBrowserShortcutsEnabled%2A> の各プロパティを使用して標準的なブラウザーの機能を無効にします。  
+  
+### Windows フォーム アプリケーションで DHTML を埋め込むには  
+  
+1.  <xref:System.Windows.Forms.WebBrowser> コントロールの <xref:System.Windows.Forms.WebBrowser.AllowWebBrowserDrop%2A> プロパティを `false` に設定し、<xref:System.Windows.Forms.WebBrowser> コントロールがその上にドロップされたファイルを開かないようにします。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#1)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#1)]  
+  
+2.  コントロールの <xref:System.Windows.Forms.WebBrowser.IsWebBrowserContextMenuEnabled%2A> プロパティを `false` に設定し、ユーザーが右クリックしたときに、<xref:System.Windows.Forms.WebBrowser> コントロールでショートカット メニューが表示されないようにします。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#2)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#2)]  
+  
+3.  コントロールの <xref:System.Windows.Forms.WebBrowser.WebBrowserShortcutsEnabled%2A> プロパティを `false` に設定して、<xref:System.Windows.Forms.WebBrowser> コントロールがショートカット キーに応答しないようにします。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#3)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#3)]  
+  
+4.  フォームのコンストラクターまたは <xref:System.Windows.Forms.Form.Load> イベント ハンドラーの <xref:System.Windows.Forms.WebBrowser.ObjectForScripting%2A> プロパティを設定します。  
+  
+     次のコードは、スクリプト オブジェクトに、フォーム クラス自体を使用します。  
+  
+    > [!NOTE]
+    >  コンポーネント オブジェクト モデル \(COM\) は、スクリプト オブジェクトにアクセスできる必要があります。  フォームが COM から参照できるようにするには<xref:System.Runtime.InteropServices.ComVisibleAttribute> 属性をフォーム クラスに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#4)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#4)]  
+  
+5.  スクリプト コードが使用するアプリケーション コードにパブリック プロパティまたはメソッドを実装します。  
+  
+     たとえば、スクリプト オブジェクトにフォーム クラスを使用する場合、次のコードをフォーム クラスに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#5)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#5)]  
+  
+6.  指定されたオブジェクトのパブリック プロパティおよびメソッドへのアクセスには、スクリプト コードで `window.external` オブジェクトを使用します。  
+  
+     次の HTML コードは、ボタンのクリックからスクリプト オブジェクトでメソッドを呼び出す方法を示します。  コントロールの <xref:System.Windows.Forms.WebBrowser.Navigate%2A> メソッドを使用して読み込む、またはコントロールの <xref:System.Windows.Forms.WebBrowser.DocumentText%2A> プロパティに割り当てる HTML ドキュメントの BODY 要素に、このコードをコピーします。  
+  
+    ```  
+    <button onclick="window.external.Test('called from script code')">  
+        call client code from script code  
+    </button>  
+    ```  
+  
+7.  アプリケーション コードが使用するスクリプト コードに関数を実装します。  
+  
+     次の HTML SCRIPT 要素は、関数の例を提供しています。  コントロールの <xref:System.Windows.Forms.WebBrowser.Navigate%2A> メソッドを使用して読み込む、またはコントロールの <xref:System.Windows.Forms.WebBrowser.DocumentText%2A> プロパティに割り当てる HTML ドキュメントの HEAD 要素に、このコードをコピーします。  
+  
+    ```  
+    <script>  
+    function test(message) {   
+        alert(message);   
+    }  
+    </script>  
+    ```  
+  
+8.  <xref:System.Windows.Forms.WebBrowser.Document%2A> プロパティを使用して、クライアント アプリケーション コードからスクリプト コードにアクセスします。  
+  
+     たとえば、次のコードをボタンの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーに追加します。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#8](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#8)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#8](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#8)]  
+  
+9. DHTML のデバッグが完了したら、コントロールの <xref:System.Windows.Forms.WebBrowser.ScriptErrorsSuppressed%2A> プロパティを `true` に設定して、<xref:System.Windows.Forms.WebBrowser> コントロールがスクリプト コードの問題のエラー メッセージを表示しないようにします。  
+  
+     [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#9](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#9)]
+     [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#9](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#9)]  
+  
+## 使用例  
+ 次の完全なコード例は、この機能を理解するために使用できるデモ アプリケーションを示します。  HTML コードは、個別の HTML ファイルから読み込まれる代わりに、<xref:System.Windows.Forms.WebBrowser.DocumentText%2A> プロパティを通じて <xref:System.Windows.Forms.WebBrowser> コントロールに読み込まれます。  
+  
+ [!code-csharp[System.Windows.Forms.WebBrowser.ObjectForScripting#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.WebBrowser.ObjectForScripting#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.WebBrowser.ObjectForScripting/vb/form1.vb#0)]  
+  
+## コードのコンパイル  
+ このコードには、次が必要です。  
+  
+-   System アセンブリおよび System.Windows.Forms アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ <xref:System.Windows.Forms.WebBrowser.Document%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.WebBrowser.ObjectForScripting%2A?displayProperty=fullName>   
+ [WebBrowser コントロール](../../../../docs/framework/winforms/controls/webbrowser-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md b/docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md
new file mode 100644
index 00000000000..7de43b1e207
--- /dev/null
+++ b/docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md
@@ -0,0 +1,86 @@
+---
+title: "Windows フォーム DataGridView コントロールでの Just-In-Time データ読み込みによる仮想モードの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 管理 (大容量のデータセットを)"
+  - "DataGridView コントロール [Windows フォーム], 大容量のデータセット"
+  - "DataGridView コントロール [Windows フォーム], 仮想モード"
+  - "例 [Windows フォーム], Just-In-Time データ読み込み"
+  - "Just-In-Time データ読み込み"
+  - "仮想モード, Just-In-Time データ読み込み"
+ms.assetid: c2a052b9-423c-4ff7-91dc-d8c7c79345f6
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォーム DataGridView コントロールでの Just-In-Time データ読み込みによる仮想モードの実装
+<xref:System.Windows.Forms.DataGridView> コントロールで仮想モードを実装する 1 つの理由は、データを必要なときにのみ取得するためです。  これを *Just\-In\-Time データ読み込み*と言います。  
+  
+ たとえば、リモート データベースの大型のテーブルを操作する場合、表示に必要なデータのみを取得し、ユーザーが新しい行をスクロール表示したときにのみ追加のデータを取得して、スタートアップの遅延を避ける必要があります。  また、アプリケーションを実行するクライアント コンピューターで、データの保存に利用できるメモリの容量が制限されている場合には、データベースから新しい値を取得するときに不要なデータを破棄する必要もあります。  
+  
+ 以下のセクションでは、Just\-In\-Time キャッシュで <xref:System.Windows.Forms.DataGridView> コントロールを使用する方法について説明します。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : Windows フォーム DataGridView コントロールで Just\-In\-Time データ読み込みを使用して仮想モードを実装する](../../../../docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md)」を参照してください。  
+  
+## フォーム  
+ 次のコード例では、<xref:System.Windows.Forms.DataGridView.CellValueNeeded> イベント ハンドラー経由で `Cache` オブジェクトと対話する、読み取り専用の <xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを定義しています。  `Cache` オブジェクトは、ローカルに保存された値を管理し、`DataRetriever` オブジェクトを使用して、Northwind サンプル データベースの Orders テーブルから値を取得します。  また、`Cache` クラスで必要な `IDataPageRetriever` インターフェイスを実装する `DataRetriever` オブジェクトを使用して、<xref:System.Windows.Forms.DataGridView> コントロールの行と列を初期化します。  
+  
+ `IDataPageRetriever` 型、`DataRetriever` 型、および `Cache` 型については、このトピックの後半で説明します。  
+  
+> [!NOTE]
+>  接続文字列内にパスワードなどの機密情報を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridView.Virtual_lazyloading#100](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/CS/lazyloading.cs#100)]
+ [!code-vb[System.Windows.Forms.DataGridView.Virtual_lazyloading#100](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/VB/lazyloading.vb#100)]  
+  
+## IDataPageRetriever インターフェイス  
+ `DataRetriever` クラスによって実装される `IDataPageRetriever` インターフェイスを定義するコード例を次に示します。  このインターフェイスで宣言されているメソッドは、初期行インデックスと 1 ページのデータの行数を要求する `SupplyPageOfData` メソッドだけです。  これらの値は、データ ソースからデータのサブセットを取得する実装側で使用されます。  
+  
+ `Cache` オブジェクトは、このインターフェイスの実装を構築時に使用して、データの最初の 2 ページを読み込みます。  未キャッシュのデータが必要になると、キャッシュはこれらのページのいずれかを破棄し、`IDataPageRetriever` にその値を含む新しいページを要求します。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridView.Virtual_lazyloading#201](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/CS/lazyloading.cs#201)]
+ [!code-vb[System.Windows.Forms.DataGridView.Virtual_lazyloading#201](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/VB/lazyloading.vb#201)]  
+  
+## DataRetriever クラス  
+ 次に、`DataRetriever` クラスを定義するコード例を次に示します。このクラスは、データのページをサーバーから取得する `IDataPageRetriever` インターフェイスを実装します。  `DataRetriever` クラスは、`Columns` プロパティと `RowCount` プロパティも提供します。<xref:System.Windows.Forms.DataGridView> コントロールは、これらのプロパティを使用して、必要な列を作成し、適切な数の空の行を <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションに追加します。  空の行の追加は、テーブル内のデータがすべて存在するようにコントロールが動作するうえで必要です。  これにより、スクロール バーのスクロール ボックスが適切なサイズになり、ユーザーがテーブル内の任意の行にアクセスできるようになります。  行は、スクロール表示されたときにのみ、<xref:System.Windows.Forms.DataGridView.CellValueNeeded> イベント ハンドラーによって値が設定されます。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridView.Virtual_lazyloading#200](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/CS/lazyloading.cs#200)]
+ [!code-vb[System.Windows.Forms.DataGridView.Virtual_lazyloading#200](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/VB/lazyloading.vb#200)]  
+  
+## Cache クラス  
+ 次に、`Cache` クラスを定義するコード例を示します。このクラスは、`IDataPageRetriever` 実装によって設定される 2 ページのデータを管理します。  `Cache` クラスは、内側の `DataPage` 構造体を定義します。この構造体は、値を 1 つのキャッシュ ページに保存する <xref:System.Data.DataTable> を含み、ページの上下の境界を表す行インデックスを計算します。  
+  
+ `Cache` クラスは、構築時に 2 ページのデータを読み込みます。  <xref:System.Windows.Forms.DataGridView.CellValueNeeded> イベントが値を要求すると、`Cache` オブジェクトは、その 2 ページのいずれかに値が存在するかどうか確認し、値が存在する場合には返します。  値がローカルに存在しない場合、`Cache` は、2 つのページのうちで、現在表示されている行から遠い方のページを特定し、そのページを、要求されている値を含む新しいページと置き換えて、値を返します。  
+  
+ データ ページの行数と、画面に同時に表示できる行数が一致することを前提に、このモデルでは、テーブルをページングしているユーザーが、直前に表示されたページに効率的に復帰できます。  
+  
+ [!code-csharp[System.Windows.Forms.DataGridView.Virtual_lazyloading#300](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/CS/lazyloading.cs#300)]
+ [!code-vb[System.Windows.Forms.DataGridView.Virtual_lazyloading#300](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/VB/lazyloading.vb#300)]  
+  
+## その他の考慮事項  
+ 上記のコード例は、Just\-In\-Time データ読み込みの例として紹介されています。  そのため、最大の効率を確保するには、独自のニーズに合わせてコードを変更する必要があります。  少なくとも、キャッシュ内の 1 ページあたりのデータの行数として適切な値を選択する必要があります。  この値は、`Cache` コンストラクターに渡されます。  1 ページあたりの行数は、<xref:System.Windows.Forms.DataGridView> コントロールに同時に表示できる行数以上にする必要があります。  
+  
+ 最適な結果を得るには、パフォーマンス テストと操作性テストを実行し、システムとユーザーの要件を確認する必要があります。  考慮する必要がある要素には、アプリケーションを実行するクライアント コンピューターのメモリ容量、使用するネットワーク接続の有効帯域幅、使用するサーバーの待機時間などがあります。  帯域幅と待機時間は、ピーク使用時に測定する必要があります。  
+  
+ アプリケーションのスクロール性能を向上させるには、ローカルに保存されるデータ量を増やします。  ただし、起動時間を短縮するには、最初に過度のデータを読み込まないようにする必要があります。  `Cache` クラスを修正して、保存できるデータ ページ数を増大することもできます。  データ ページをより多く使用すると、スクロール効率を改善できますが、有効な帯域幅とサーバーの待機時間に応じて、データ ページの適切な行数を決める必要があります。  ページ数を少なくすると、サーバーへのアクセス頻度が増大しますが、要求したデータが返される時間が短縮します。  帯域幅よりも待機時間の方が問題になる場合は、データ ページを増やす必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールで Just\-In\-Time データ読み込みを使用して仮想モードを実装する](../../../../docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md b/docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md
new file mode 100644
index 00000000000..c67fb9f8991
--- /dev/null
+++ b/docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md
@@ -0,0 +1,146 @@
+---
+title: "チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 管理 (大容量のデータセットを)"
+  - "DataGridView コントロール [Windows フォーム], 大容量のデータセット"
+  - "DataGridView コントロール [Windows フォーム], 仮想モード"
+  - "仮想モード, チュートリアル"
+  - "チュートリアル [Windows フォーム], DataGridView コントロール"
+ms.assetid: 74eb5276-5ab8-4ce0-8005-dae751d85f7c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装
+非常に大きな表形式のデータを <xref:System.Windows.Forms.DataGridView> コントロールに表示するときは、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティを `true` に設定して、コントロールとデータ ストアとのやり取りを明示的に管理できます。  これにより、こうした状況でのコントロールのパフォーマンスを微調整できます。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールには、カスタム データ ストアとやり取りするために使用できるイベントが用意されています。  このチュートリアルでは、このようなイベント ハンドラーの実装手順を具体的に示します。  説明しやすくするために、ここで紹介するコード例は非常に単純なデータ ソースを使用しています。  実際のアプリケーションでは、通常は表示に必要な行だけをキャッシュに読み込み、<xref:System.Windows.Forms.DataGridView> イベントを処理して、キャッシュとのやり取りやキャッシュの更新を行います。  詳細については、「[Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)」を参照してください。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する](../../../../docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## フォームの作成  
+  
+#### 仮想モードを実装するには  
+  
+1.  <xref:System.Windows.Forms.Form> から派生したクラスを作成し、<xref:System.Windows.Forms.DataGridView> コントロールを含めます。  
+  
+     次のコードでは基本的な初期化を行います。  後の手順で使用する変数を宣言し、`Main` メソッドを定義し、クラス コンストラクターで単純なフォーム レイアウトを作成します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#001](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#001)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#001](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#001)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#001](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#001)]  
+    [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#002](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#002)]
+    [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#002](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#002)]
+    [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#002](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#002)]  
+  
+2.  フォームの <xref:System.Windows.Forms.Form.Load> イベントに対して、<xref:System.Windows.Forms.DataGridView> コントロールを初期化し、データ ストアにサンプルの値を格納するためのハンドラーを実装します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#110](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#110)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#110](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#110)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#110](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#110)]  
+  
+3.  <xref:System.Windows.Forms.DataGridView.CellValueNeeded> イベントに対して、要求されたセル値をデータ ストアまたは現在編集中の `Customer` オブジェクトから取得するためのハンドラーを実装します。  
+  
+     このイベントは、<xref:System.Windows.Forms.DataGridView> コントロールがセルを描画しなければならないときに毎回発生します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#120](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#120)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#120](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#120)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#120](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#120)]  
+  
+4.  <xref:System.Windows.Forms.DataGridView.CellValuePushed> イベントに対して、編集されたセル値を編集中の行を表す `Customer` オブジェクトに格納するためのハンドラーを実装します。  このイベントは、ユーザーがセル値の変更をコミットすると発生します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#130](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#130)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#130](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#130)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#130](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#130)]  
+  
+5.  <xref:System.Windows.Forms.DataGridView.NewRowNeeded> イベントに対して、新しく作成される行を表す `Customer` オブジェクトを作成するためのハンドラーを実装します。  
+  
+     このイベントは、ユーザーが新しいレコード用の行を入力すると発生します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#140](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#140)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#140](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#140)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#140](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#140)]  
+  
+6.  <xref:System.Windows.Forms.DataGridView.RowValidated> イベントに対して、新しい行または変更された行をデータ ストアに保存するためのハンドラーを実装します。  
+  
+     このイベントは、ユーザーが現在の行を変更すると発生します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#150](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#150)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#150](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#150)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#150](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#150)]  
+  
+7.  <xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded> イベントに対して、ユーザーが Esc キーを \(編集モードの場合は 2 回、編集モードでない場合は 1 回\) 押して行の復帰を指示したときに <xref:System.Windows.Forms.DataGridView.CancelRowEdit> イベントを発生させるかどうかを設定するハンドラーを実装します。  
+  
+     <xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded> イベント ハンドラー内で <xref:System.Windows.Forms.QuestionEventArgs.Response%2A?displayProperty=fullName> プロパティを `true` に設定していない場合は、現在行の中の任意のセルが修正されているときに行の復帰を指示すると、既定で <xref:System.Windows.Forms.DataGridView.CancelRowEdit> イベントが発生します。  このイベントは、コミットのスコープが実行時に決定される場合に役立ちます。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#160](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#160)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#160](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#160)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#160](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#160)]  
+  
+8.  <xref:System.Windows.Forms.DataGridView.CancelRowEdit> イベントに対して、現在行を表す `Customer` オブジェクトの値を破棄するためのハンドラーを実装します。  
+  
+     このイベントは、ユーザーが Esc キーを \(編集モードでは 2 回、編集モード以外では 1 回\) 押して行の復帰を指示したときに発生します。  このイベントは、現在行の中に変更されたセルがない場合や、<xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded> イベント ハンドラー内で <xref:System.Windows.Forms.QuestionEventArgs.Response%2A?displayProperty=fullName> プロパティの値が `false` に設定されている場合には発生しません。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#170](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#170)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#170](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#170)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#170](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#170)]  
+  
+9. <xref:System.Windows.Forms.DataGridView.UserDeletingRow> イベントに対して、既存の `Customer` オブジェクトをデータ ストアから削除したり、新しく作成された行を表す保存されていない `Customer` オブジェクトを破棄したりするためのハンドラーを実装します。  
+  
+     このイベントは、ユーザーが行ヘッダーをクリックした後に Del キーを押して行を削除すると発生します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#180](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#180)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#180](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#180)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#180](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#180)]  
+  
+10. このコード例で使用されるデータ項目を表す単純な `Customers` クラスを実装します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.VirtualMode#200](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CPP/virtualmode.cpp#200)]
+     [!code-csharp[System.Windows.Forms.DataGridView.VirtualMode#200](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/CS/virtualmode.cs#200)]
+     [!code-vb[System.Windows.Forms.DataGridView.VirtualMode#200](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.VirtualMode/VB/virtualmode.vb#200)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   アプリケーションをコンパイルして実行します。  
+  
+     3 件の顧客レコードを含んだ <xref:System.Windows.Forms.DataGridView> コントロールが表示されます。  行内の複数のセルの値を変更した後に、Esc キーを \(編集モードの場合は 2 回、編集モードでない場合は 1 回\) 押すと、行全体を元の値に戻すことができます。  コントロール内の行を変更、追加、または削除すると、データ ストア内の `Customer` オブジェクトも変更、追加、削除されます。  
+  
+## 次の手順  
+ このアプリケーションは、<xref:System.Windows.Forms.DataGridView> コントロールの仮想モードを実装するときに処理しなければならないイベントの基本を示しています。  このアプリケーションはさまざまな方法で改良できます。  
+  
+-   外部データベースから値をキャッシュするデータ ストアを実装します。  このキャッシュは必要に応じて値を取得および破棄するので、表示に必要なデータだけを格納し、クライアント コンピューターのメモリ消費量を抑えることができます。  
+  
+-   データ ストアのパフォーマンスを要件に合わせて微調整します。  たとえば、クライアント コンピューターのメモリの制限よりも、ネットワーク接続の遅さをカバーするためには、大きなサイズのキャッシュを使用して、データベース クエリの回数を最小限に抑えます。  
+  
+ 外部データベースから値をキャッシュする方法の詳細については、「[方法 : Windows フォーム DataGridView コントロールで Just\-In\-Time データ読み込みを使用して仮想モードを実装する](../../../../docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>   
+ <xref:System.Windows.Forms.DataGridView.CellValueNeeded>   
+ <xref:System.Windows.Forms.DataGridView.CellValuePushed>   
+ <xref:System.Windows.Forms.DataGridView.NewRowNeeded>   
+ <xref:System.Windows.Forms.DataGridView.RowValidated>   
+ <xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded>   
+ <xref:System.Windows.Forms.DataGridView.CancelRowEdit>   
+ <xref:System.Windows.Forms.DataGridView.UserDeletingRow>   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)   
+ [方法 : Windows フォーム DataGridView コントロールで仮想モードを実装する](../../../../docs/framework/winforms/controls/how-to-implement-virtual-mode-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/index.md b/docs/framework/winforms/controls/index.md
new file mode 100644
index 00000000000..b035f591213
--- /dev/null
+++ b/docs/framework/winforms/controls/index.md
@@ -0,0 +1,52 @@
+---
+title: "Windows フォーム コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム]"
+  - "Windows フォーム コントロール"
+  - "Windows フォーム コントロール, Windows フォーム コントロールの概要"
+ms.assetid: f050de8f-4ebd-4042-94b8-edf9a1dbd52a
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォーム コントロール
+Windows フォーム アプリケーションのユーザー インターフェイスをデザインしたり変更したりする場合は、コントロールを追加、配置、および位置設定する必要があります。  コントロールは、フォーム オブジェクトに含まれているオブジェクトです。  それぞれの種類のコントロールには、特定の目的に応じた独自のプロパティ、メソッド、およびイベントのセットが含まれています。  コントロールは、デザイナーで操作できます。また、コードを記述して、実行時に動的にコントロールを追加できます。  
+  
+## このセクションの内容  
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)  
+ フォームへのコントロールの追加に関連するリンクを示します。  
+  
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)  
+ フォーム上のコントロールの配置に関連するリンクを示します。  
+  
+ [各 Windows フォーム コントロールのラベル設定とショートカットの作成](../../../../docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md)  
+ ショートカット キー、コントロールのテキスト ラベル、および修飾子キーの使用法について説明します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォームで使用するコントロール、および各コントロールで実行できる基本的な処理の一覧を示します。  
+  
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)  
+ カスタムの Windows フォーム コントロールを開発するときに役立つ背景情報およびサンプルを示します。  
+  
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)  
+ デザインと継承によりカスタム コントロールを作成するための手法を説明します。  
+  
+## 関連項目  
+ [クライアント アプリケーション](../../../../docs/framework/develop-client-apps.md)  
+ Windows ベースのアプリケーションの開発の概要を説明します。  
+  
+ [Windows Forms Walkthroughs](http://msdn.microsoft.com/ja-jp/fd44d13d-4733-416f-aefc-32592e59e5d9)  
+ Windows フォームおよびコントロールに関するチュートリアルのトピックの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/keyboard-shortcuts-for-the-windows-forms-datagrid-control.md b/docs/framework/winforms/controls/keyboard-shortcuts-for-the-windows-forms-datagrid-control.md
new file mode 100644
index 00000000000..7884067abf0
--- /dev/null
+++ b/docs/framework/winforms/controls/keyboard-shortcuts-for-the-windows-forms-datagrid-control.md
@@ -0,0 +1,64 @@
+---
+title: "Windows フォームの DataGrid コントロール内の移動に使用できるキーボード ショートカット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGrid コントロール [Windows フォーム], 移動キー"
+  - "ショートカット キー, DataGrid コントロール"
+ms.assetid: a01780f9-20d5-4f5f-808f-c790c9a007a5
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームの DataGrid コントロール内の移動に使用できるキーボード ショートカット
+> [!NOTE]
+>  <xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGrid> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.DataGrid> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。  
+  
+ Windows フォームの <xref:System.Windows.Forms.DataGrid> コントロール内の移動に使用できるキーボード ショートカットの一覧を示します。  
+  
+|動作|Shortcut|  
+|--------|--------------|  
+|現在のセルへの入力を終了し、次のセルへ移動します。<br /><br /> フォーカスが子テーブルのリンクにある場合は、その子テーブルに移動します。|Enter|  
+|セル内が編集モードの場合は、セルの編集をキャンセルします。<br /><br /> マーキー選択の場合は、該当する行の編集をキャンセルします。|Esc|  
+|セルを編集するときに、カーソル位置の前にある文字列を削除します。|BackSpace|  
+|セルを編集するときに、カーソル位置の後にある文字列を削除します。|Del|  
+|現在の行にある最初のセルに移動します。|Home|  
+|現在の行にある最後のセルに移動します。|End|  
+|現在のセルの文字列を強調表示し、行の最後にカーソルを位置付けます。  セルをダブルクリックするのと同じ動作になります。|F2|  
+|セルにフォーカスがある場合は、同一行の次のセルに移動します。<br /><br /> フォーカスが行の最後のセルにある場合は、その行の最初の子テーブルへのリンクへ移動し、展開します。<br /><br /> 子リンクにフォーカスがある場合は、次の子リンクに移動します。<br /><br /> 最後の子リンクにフォーカスがある場合は、次の行の最初のセルに移動します。|Tab|  
+|セルにフォーカスがある場合は、同一行の 1 つ前のセルに移動します。<br /><br /> 行の最初のセルにフォーカスがある場合は、1 つ前の行の最後に展開された子テーブルへのリンク、または 1 つ前の行の最後のセルに移動します。<br /><br /> 子リンクにフォーカスがある場合は、1 つ前の子リンクに移動します。<br /><br /> 最初の子リンクにフォーカスがある場合は、1 つ前の行の最後のセルに移動します。|Shift \+ Tab|  
+|タブ オーダー内の次のコントロールに移動します。|Ctrl \+ Tab|  
+|タブ オーダー内の 1 つ前のコントロールに移動します。|Ctrl \+ Shift \+ Tab|  
+|子テーブル内の場合は、親テーブルへ移動します。  \[戻る\] をクリックするのと同じ動作になります。|Alt \+ ←|  
+|子テーブルへのリンクを展開します。  Alt キーを押しながら ↓ キーを押すと、選択されているリンクだけでなく、すべてのリンクが展開されます。|Alt \+ ↓ または Ctrl \+ プラス記号 \(\+\)|  
+|子テーブルへのリンクを折りたたみます。  Alt キーを押しながら ↑ キーを押すと、選択されているリンクだけでなく、すべてのリンクが折りたたまれます。|Alt \+ ↑ または Ctrl \+ マイナス記号 \(\-\)|  
+|矢印の方向にある最も遠い、空白でないセルへ移動します。|Ctrl \+ 方向キー|  
+|選択範囲を矢印の方向に 1 行分拡張します \(子テーブルのリンクは除外します\)。|Shift \+ ↑ または Shift \+ ↓|  
+|矢印の方向にある最も遠い、空白でない行まで選択範囲を拡張します \(子テーブルのリンクは除きます\)。|Ctrl \+ Shift \+ ↑ または Ctrl \+ Shift \+ ↓|  
+|左上のセルへ移動します。|Ctrl \+ Home|  
+|右下のセルへ移動します。|Ctrl \+ End|  
+|一番上の行まで選択範囲を拡張します。|Ctrl \+ Shift \+ Home|  
+|一番下の行まで選択範囲を拡張します。|Ctrl \+ Shift \+ End|  
+|現在の行を選択します \(子テーブルのリンクは除きます\)。|Shift \+ Space|  
+|グリッド全体を選択します \(子テーブルのリンクは除きます\)。|Ctrl \+ A|  
+|子テーブル内の場合は、親テーブルの行を表示します。|Ctrl \+ PageDown|  
+|子テーブル内の場合は、親テーブルの行を非表示にします。|Ctrl \+ PageUp|  
+|選択範囲を 1 画面分下に拡張します \(子テーブルのリンクは除きます\)。|Shift \+ PageDown|  
+|選択範囲を 1 画面分上に拡張します \(子テーブルのリンクは除きます\)。|Shift \+ PageUp|  
+|現在の行で <xref:System.Windows.Forms.DataGrid.EndEdit%2A> メソッドを呼び出します。|Ctrl \+ Enter|  
+|編集モードのときにセルに <xref:System.DBNull.Value?displayProperty=fullName> 値を入力します。|Ctrl \+ 0|  
+  
+## 参照  
+ [DataGrid コントロールの概要](../../../../docs/framework/winforms/controls/datagrid-control-overview-windows-forms.md)   
+ [DataGrid コントロール](../../../../docs/framework/winforms/controls/datagrid-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/known-folder-guids-for-file-dialog-custom-places.md b/docs/framework/winforms/controls/known-folder-guids-for-file-dialog-custom-places.md
new file mode 100644
index 00000000000..f0be2b5ecc0
--- /dev/null
+++ b/docs/framework/winforms/controls/known-folder-guids-for-file-dialog-custom-places.md
@@ -0,0 +1,300 @@
+---
+title: "ファイル ダイアログ ボックスのカスタム プレイス用既知のフォルダー GUID | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム プレイス, 既知のフォルダー GUID"
+  - "既知のフォルダー GUID, カスタム プレイス"
+  - "Windows Vista の既知のフォルダー GUID, カスタム プレイス"
+ms.assetid: d8d8b544-8b4d-4da5-ba3a-b05e93244778
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ファイル ダイアログ ボックスのカスタム プレイス用既知のフォルダー GUID
+<xref:System.Windows.Forms.FileDialog.CustomPlaces%2A> コレクションにフォルダーを追加する際、<xref:System.Guid> を使用して、[!INCLUDE[wiprlhext](../../../../includes/wiprlhext-md.md)] の既知のフォルダーを指定することができます。  既知のフォルダー GUID は大文字小文字の区別がなく、[!INCLUDE[winSDK](../../../../includes/winsdk-md.md)] 内の KnownFolders.h ファイルに定義されています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.FileDialogCustomPlacesCollection> に追加された既知のフォルダーが **\[お気に入りリンク\]** 領域に表示されない場合があります。  たとえば、指定した既知のフォルダーが、アプリケーションを実行しているコンピューター上にない場合、この既知のフォルダーは表示されません。  
+  
+## GUID の一覧  
+ [!INCLUDE[wiprlhext](../../../../includes/wiprlhext-md.md)] の既知のフォルダーと、それぞれに関連付けられている <xref:System.Guid> を次の表に示します。  
+  
+ AddNewPrograms  
+ DE61D971\-5EBC\-4F02\-A3A9\-6C82895E5C04  
+  
+ AdminTools  
+ 724EF170\-A42D\-4FEF\-9F26\-B60E846FBA4F  
+  
+ AppDataLow  
+ A520A1A4\-1780\-4FF6\-BD18\-167343C5AF16  
+  
+ AppUpdates  
+ A305CE99\-F527\-492B\-8B1A\-7E76FA98D6E4  
+  
+ CDBurning  
+ 9E52AB10\-F80D\-49DF\-ACB8\-4330F5687855  
+  
+ ChangeRemovePrograms  
+ DF7266AC\-9274\-4867\-8D55\-3BD661DE872D  
+  
+ CommonAdminTools  
+ D0384E7D\-BAC3\-4797\-8F14\-CBA229B392B5  
+  
+ CommonOEMLinks  
+ C1BAE2D0\-10DF\-4334\-BEDD\-7AA20B227A9D  
+  
+ CommonPrograms  
+ 0139D44E\-6AFE\-49F2\-8690\-3DAFCAE6FFB8  
+  
+ CommonStartMenu  
+ A4115719\-D62E\-491D\-AA7C\-E74B8BE3B067  
+  
+ CommonStartup  
+ 82A5EA35\-D9CD\-47C5\-9629\-E15D2F714E6E  
+  
+ CommonTemplates  
+ B94237E7\-57AC\-4347\-9151\-B08C6C32D1F7  
+  
+ Computer  
+ 0AC0837C\-BBF8\-452A\-850D\-79D08E667CA7  
+  
+ Conflict  
+ 4BFEFB45\-347D\-4006\-A5BE\-AC0CB0567192  
+  
+ Connections  
+ 6F0CD92B\-2E97\-45D1\-88FF\-B0D186B8DEDD  
+  
+ 連絡先  
+ 56784854\-C6CB\-462B\-8169\-88E350ACB882  
+  
+ ControlPanel  
+ 82A74AEB\-AEB4\-465C\-A014\-D097EE346D63  
+  
+ クッキー  
+ 2B0F765D\-C0E9\-4171\-908E\-08A611B84FF6  
+  
+ \[デスクトップ\]  
+ B4BFCC3A\-DB2C\-424C\-B029\-7FE99A87C641  
+  
+ ドキュメント  
+ FDD39AD0\-238F\-46AF\-ADB4\-6C85480369C7  
+  
+ ダウンロード  
+ 374DE290\-123F\-4565\-9164\-39C4925E467B  
+  
+ お気に入り  
+ 1777F761\-68AD\-4D8A\-87BD\-30B759FA33DD  
+  
+ フォント  
+ FD228CB7\-AE11\-4AE3\-864C\-16F3910AB8FE  
+  
+ Games  
+ CAC52C1A\-B53D\-4EDC\-92D7\-6B2E8AC19434  
+  
+ GameTasks  
+ 054FAE61\-4DD8\-4787\-80B6\-090220C4B700  
+  
+ 履歴  
+ D9DC8A3B\-B784\-432E\-A781\-5A1130A75963  
+  
+ インターネット  
+ 4D9F7874\-4E0C\-4904\-967B\-40B0D20C3E4B  
+  
+ InternetCache  
+ 352481E8\-33BE\-4251\-BA85\-6007CAEDCF9D  
+  
+ リンク  
+ BFB9D5E0\-C6A9\-404C\-B2B2\-AE6DB6AF4968  
+  
+ LocalAppData  
+ F1B32785\-6FBA\-4FCF\-9D55\-7B8E7F157091  
+  
+ LocalizedResourcesDir  
+ 2A00375E\-224C\-49DE\-B8D1\-440DF7EF3DDC  
+  
+ Music  
+ 4BD8D571\-6D19\-48D3\-BE97\-422220080E43  
+  
+ NetHood  
+ C5ABBF53\-E17F\-4121\-8900\-86626FC2C973  
+  
+ Network  
+ D20BEEC4\-5CA8\-4905\-AE3B\-BF251EA09B53  
+  
+ OriginalImages  
+ 2C36C0AA\-5812\-4B87\-BFD0\-4CD0DFB19B39  
+  
+ PhotoAlbums  
+ 69D2CF90\-FC33\-4FB7\-9A0C\-EBB0F0FCB43C  
+  
+ Pictures  
+ 33E28130\-4E1E\-4676\-835A\-98395C3BC3BB  
+  
+ Playlists  
+ DE92C1C7\-837F\-4F69\-A3BB\-86E631204A23  
+  
+ Printers  
+ 76FC4E2D\-D6AD\-4519\-A663\-37BD56068185  
+  
+ PrintHood  
+ 9274BD8D\-CFD1\-41C3\-B35E\-B13F55A758F4  
+  
+ Profile  
+ 5E6C858F\-0E22\-4760\-9AFE\-EA3317B67173  
+  
+ ProgramData  
+ 62AB5D82\-FDC1\-4DC3\-A9DD\-070D1D495D97  
+  
+ ProgramFiles  
+ 905E63B6\-C1BF\-494E\-B29C\-65B732D3D21A  
+  
+ ProgramFilesCommon  
+ F7F1ED05\-9F6D\-47A2\-AAAE\-29D317C6F066  
+  
+ ProgramFilesCommonX64  
+ 6365D5A7\-0F0D\-45E5\-87F6\-0DA56B6A4F7D  
+  
+ ProgramFilesCommonX86  
+ DE974D24\-D9C6\-4D3E\-BF91\-F4455120B917  
+  
+ ProgramFilesX64  
+ 6D809377\-6AF0\-444B\-8957\-A3773F02200E  
+  
+ ProgramFilesX86  
+ 7C5A40EF\-A0FB\-4BFC\-874A\-C0F2E0B9FA8E  
+  
+ プログラム  
+ A77F5D77\-2E2B\-44C3\-A6A2\-ABA601054A51  
+  
+ Public  
+ DFDF76A2\-C82A\-4D63\-906A\-5644AC457385  
+  
+ PublicDesktop  
+ C4AA340D\-F20F\-4863\-AFEF\-F87EF2E6BA25  
+  
+ PublicDocuments  
+ ED4824AF\-DCE4\-45A8\-81E2\-FC7965083634  
+  
+ PublicDownloads  
+ 3D644C9B\-1FB8\-4F30\-9B45\-F670235F79C0  
+  
+ PublicGameTasks  
+ DEBF2536\-E1A8\-4C59\-B6A2\-414586476AEA  
+  
+ PublicMusic  
+ 3214FAB5\-9757\-4298\-BB61\-92A9DEAA44FF  
+  
+ PublicPictures  
+ B6EBFB86\-6907\-413C\-9AF7\-4FC2ABF07CC5  
+  
+ PublicVideos  
+ 2400183A\-6185\-49FB\-A2D8\-4A392A602BA3  
+  
+ QuickLaunch  
+ 52A4F021\-7B75\-48A9\-9F6B\-4B87A210BC8F  
+  
+ 最近使用したファイル  
+ AE50C081\-EBD2\-438A\-8655\-8A092E34987A  
+  
+ RecordedTV  
+ BD85E001\-112E\-431E\-983B\-7B15AC09FFF1  
+  
+ RecycleBin  
+ B7534046\-3ECB\-4C18\-BE4E\-64CD4CB7D6AC  
+  
+ ResourceDir  
+ 8AD10C31\-2ADB\-4296\-A8F7\-E4701232C972  
+  
+ RoamingAppData  
+ 3EB685DB\-65F9\-4CF6\-A03A\-E3EF65729F3D  
+  
+ SampleMusic  
+ B250C668\-F57D\-4EE1\-A63C\-290EE7D1AA1F  
+  
+ SamplePictures  
+ C4900540\-2379\-4C75\-844B\-64E6FAF8716B  
+  
+ SamplePlaylists  
+ 15CA69B3\-30EE\-49C1\-ACE1\-6B5EC372AFB5  
+  
+ SampleVideos  
+ 859EAD94\-2E85\-48AD\-A71A\-0969CB56A6CD  
+  
+ SavedGames  
+ 4C5C32FF\-BB9D\-43B0\-B5B4\-2D72E54EAAA4  
+  
+ SavedSearches  
+ 7D1D3A04\-DEBB\-4115\-95CF\-2F29DA2920DA  
+  
+ SEARCH\_CSC  
+ EE32E446\-31CA\-4ABA\-814F\-A5EBD2FD6D5E  
+  
+ SEARCH\_MAPI  
+ 98EC0E18\-2098\-4D44\-8644\-66979315A281  
+  
+ SearchHome  
+ 190337D1\-B8CA\-4121\-A639\-6D472D16972A  
+  
+ SendTo  
+ 8983036C\-27C0\-404B\-8F08\-102D10DCFD74  
+  
+ SidebarDefaultParts  
+ 7B396E54\-9EC5\-4300\-BE0A\-2482EBAE1A26  
+  
+ SidebarParts  
+ A75D362E\-50FC\-4FB7\-AC2C\-A8BEAA314493  
+  
+ StartMenu  
+ 625B53C3\-AB48\-4EC1\-BA1F\-A1EF4146FC19  
+  
+ Startup  
+ B97D20BB\-F46A\-4C97\-BA10\-5E3608430854  
+  
+ SyncManager  
+ 43668BF8\-C14E\-49B2\-97C9\-747784D784B7  
+  
+ SyncResults  
+ 289A9A43\-BE44\-4057\-A41B\-587A76D7E7F9  
+  
+ SyncSetup  
+ 0F214138\-B1D3\-4A90\-BBA9\-27CBC0C5389A  
+  
+ システム  
+ 1AC14E77\-02E7\-4E5D\-B744\-2EB1AE5198B7  
+  
+ SystemX86  
+ D65231B0\-B2F1\-4857\-A4CE\-A8E7C6EA7D27  
+  
+ テンプレート  
+ A63293E8\-664E\-48DB\-A079\-DF759E0509F7  
+  
+ TreeProperties  
+ 5B3749AD\-B49F\-49C1\-83EB\-15370FBD4882  
+  
+ UserProfiles  
+ 0762D272\-C50A\-4BB0\-A382\-697DCD729B80  
+  
+ UsersFiles  
+ F3CE0F7C\-4901\-4ACC\-8648\-D5D44B04EF8F  
+  
+ ビデオ  
+ 18989B1D\-99B5\-455B\-841C\-AB7C74E4DDFC  
+  
+ ウィンドウ  
+ F38BF404\-1D43\-42F2\-9305\-67DE0B28FC23  
+  
+## 参照  
+ <xref:System.Windows.Forms.FileDialogCustomPlace>   
+ [方法 : よく使用する場所をファイル ダイアログ ボックスに追加する](../../../../docs/framework/winforms/controls/how-to-add-a-custom-place-to-a-file-dialog-box.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/label-control-overview-windows-forms.md b/docs/framework/winforms/controls/label-control-overview-windows-forms.md
new file mode 100644
index 00000000000..0d967fa922c
--- /dev/null
+++ b/docs/framework/winforms/controls/label-control-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "Label コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Label"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ [Windows フォーム], 表示 (ラベルに)"
+  - "Label コントロール [Windows フォーム], Label コントロールの概要"
+  - "ラベル"
+ms.assetid: dcad7f44-11b7-4c55-b0c0-d984ade43d7d
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Label コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.Label> コントロールを使用すると、ユーザーが編集できないテキストまたはイメージを表示できます。  Label コントロールでは、フォーム上のオブジェクトを識別します。このコントロールを使用して、特定のコントロールをクリックしたときの動作を記述したり、アプリケーションの実行時イベントやプロセスに応じた情報を表示したりできます。  たとえば、ラベルを使用して、テキスト ボックス、リスト ボックス、コンボ ボックスなどの説明テキストを追加します。  また、実行時にイベントに応じて表示されるテキストを変更するコードも記述できます。  たとえば、アプリケーションで変更を処理するのに数分かかる場合は、ラベルに処理状況のメッセージを表示します。  
+  
+## Label コントロールの操作  
+ <xref:System.Windows.Forms.Label> コントロールはフォーカスを受け取ることができないため、このコントロールを使用して他のコントロールのアクセス キーを作成できます。  ユーザーは、**Alt** キーを押しながらアクセス キーを押すことによって、コントロールを選択した場合と同様の操作ができます。  詳細については、「[Windows フォーム コントロールのアクセス キーの作成](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)」と「[方法 : Windows フォームの Label コントロールでアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md)」を参照してください。  
+  
+ ラベルに表示されるキャプションは、<xref:System.Windows.Forms.Label.Text%2A> プロパティに含まれています。  <xref:System.Windows.Forms.Label.TextAlign%2A> プロパティを使用すると、ラベル内のテキストの配置を設定できます。  詳細については、「[方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Label>   
+ [方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する](../../../../docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md)   
+ [方法 : Windows フォームの Label コントロールでアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/label-control-windows-forms.md b/docs/framework/winforms/controls/label-control-windows-forms.md
new file mode 100644
index 00000000000..0d9f4366423
--- /dev/null
+++ b/docs/framework/winforms/controls/label-control-windows-forms.md
@@ -0,0 +1,47 @@
+---
+title: "Label コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Label コントロール [Windows フォーム]"
+  - "ラベル"
+  - "LinkLabel コントロール [Windows フォーム]"
+ms.assetid: 2028bbe3-ffe2-43e8-8ae3-dec759d2ecec
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Label コントロール (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.ToolStripLabel> コントロールは、<xref:System.Windows.Forms.Label> コントロールに代わると共に追加の機能を提供します。  <xref:System.Windows.Forms.ToolStripLabel> は <xref:System.Windows.Forms.ToolStripDropDown> など他の新しいコントロールと共に使用できます。  ただし、<xref:System.Windows.Forms.Label> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されています。  
+  
+ Windows フォームの <xref:System.Windows.Forms.Label> コントロールを使用すると、ユーザーが編集できないテキストまたはイメージを表示できます。  Label コントロールでは、フォーム上のオブジェクトを識別します。このコントロールを使用して、特定のコントロールをクリックしたときの動作を記述したり、アプリケーションの実行時イベントやプロセスに応じた情報を表示したりできます。  <xref:System.Windows.Forms.Label> コントロールはフォーカスを受け取ることができないため、このコントロールを使用して他のコントロールのアクセス キーを作成できます。  
+  
+## このセクションの内容  
+ [Label コントロールの概要](../../../../docs/framework/winforms/controls/label-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォームの Label コントロールでアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-with-windows-forms-label-controls.md)  
+ ラベルを使用して、別のコントロールのアクセス キーを定義する方法について説明します。  
+  
+ [方法 : Windows フォーム Label コントロールのサイズを内容に合わせて変更する](../../../../docs/framework/winforms/controls/how-to-size-a-windows-forms-label-control-to-fit-its-contents.md)  
+ キャプションに合わせてラベル コントロールのサイズを調整する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Label>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md b/docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md
new file mode 100644
index 00000000000..861be5d13d4
--- /dev/null
+++ b/docs/framework/winforms/controls/labeling-individual-windows-forms-controls-and-providing-shortcuts-to-them.md
@@ -0,0 +1,46 @@
+---
+title: "各 Windows フォーム コントロールのラベル設定とショートカットの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], アクセス キー"
+  - "ショートカット キー, コントロール"
+  - "ショートカット, コントロール"
+  - "Windows フォーム コントロール, ラベル"
+ms.assetid: 6eaf868c-819f-4131-8f59-048e20c286f7
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 各 Windows フォーム コントロールのラベル設定とショートカットの作成
+Windows フォームに追加されたコントロールには、ユーザー操作をさらに特殊化するために使用されるプロパティとメソッドがあります。  ユーザーのニーズに合わせてユーザー インターフェイスをカスタマイズすることは、適切に設計された Windows アプリケーションにおいて非常に重要です。  
+  
+## このセクションの内容  
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)  
+ コントロールにテキスト ラベルを割り当てる方法について説明します。  
+  
+ [方法 : Windows フォーム コントロールによって表示されるイメージを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md)  
+ イメージを表示するためのコントロールを構成する方法について説明します。  
+  
+ [方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)  
+ 定義済みのキーボード ショートカットを作成する方法について説明します。  
+  
+ [Windows フォーム上のコントロールのユーザー補助情報の提供](../../../../docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md)  
+ コントロールでユーザー補助機能を使用できるようにする方法について説明します。  
+  
+## 関連項目  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ コントロールを使用して実行できる、その他の基本的な項目へのリンク。  
+  
+ 「[方法 : デザイナーを使用して Windows フォーム コントロールのアクセス キーを作成する](http://msdn.microsoft.com/library/ms233673\(v=vs.110\))」、「[方法 : Windows フォーム コントロールに表示するテキストをデザイナーで設定する](http://msdn.microsoft.com/library/ms233665\(v=vs.110\))」、「[方法 : デザイナーを使用して Windows フォーム コントロールによって表示されるイメージを設定する](http://msdn.microsoft.com/library/ms233656\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/layout-in-windows-forms-controls.md b/docs/framework/winforms/controls/layout-in-windows-forms-controls.md
new file mode 100644
index 00000000000..9b4eaa2471d
--- /dev/null
+++ b/docs/framework/winforms/controls/layout-in-windows-forms-controls.md
@@ -0,0 +1,57 @@
+---
+title: "Windows フォーム コントロールのレイアウト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "レイアウト [Windows フォーム]"
+  - "LayoutEngine クラス"
+  - "Margin プロパティ [Windows フォーム]"
+  - "Padding プロパティ [Windows フォーム]"
+  - "サイズ変更, 自動 [Windows フォーム]"
+ms.assetid: 99400e3a-720e-4f56-b68f-89df911a251c
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォーム コントロールのレイアウト
+フォーム上にコントロールを正確に配置することは、多くのアプリケーションで重要度の高い処理です。  <xref:System.Windows.Forms?displayProperty=fullName> 名前空間では、これを行うためのさまざまなレイアウト ツールを使用できます。  
+  
+## このセクションの内容  
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティとそのレイアウト上の役割について説明します。  
+  
+ [Windows フォーム コントロールでのマージンと埋め込み](../../../../docs/framework/winforms/controls/margin-and-padding-in-windows-forms-controls.md)  
+ <xref:System.Windows.Forms.Control.Margin%2A> プロパティと <xref:System.Windows.Forms.Control.Padding%2A> プロパティ、およびそれらのレイアウト上の役割について説明します。  
+  
+ [方法 : フォームの端に合わせてコントロールを配置する](../../../../docs/framework/winforms/controls/how-to-align-a-control-to-the-edges-of-forms.md)  
+ <xref:System.Windows.Forms.Control.Dock%2A> プロパティを使用して、フォーム上のコントロールをそのフォームの端に対して配置する方法を示します。  
+  
+ [方法 : 埋め込みを使用して Windows フォーム コントロールの周囲に境界線を作成する](../../../../docs/framework/winforms/controls/how-to-create-a-border-around-a-windows-forms-control-using-padding.md)  
+ <xref:System.Windows.Forms.Control.Padding%2A> プロパティを使用してコントロールの外枠を指定する方法を示します。  
+  
+ [方法 : カスタム レイアウト エンジンを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-custom-layout-engine.md)  
+ Windows フォーム コントロールの配置を行う <xref:System.Windows.Forms.Layout.LayoutEngine> を実装する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TableLayoutPanel>  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel>  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの参照ドキュメントを提供します。  
+  
+## 参照  
+ [方法 : FlowLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-flowlayoutpanel-control.md)   
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)   
+ [方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする](../../../../docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md)   
+ [TableLayoutPanel コントロールにおける AutoSize 動作](../../../../docs/framework/winforms/controls/autosize-behavior-in-the-tablelayoutpanel-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md b/docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md
new file mode 100644
index 00000000000..f691c6cdf17
--- /dev/null
+++ b/docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md
@@ -0,0 +1,43 @@
+---
+title: "Windows フォームの Timer コンポーネントの Interval プロパティの制限 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Interval プロパティ, 制限事項"
+  - "Timer コンポーネント [Windows フォーム], 制限事項 (Interval プロパティの)"
+  - "タイマー, イベントの間隔"
+  - "タイマー, Windows ベースの"
+ms.assetid: 7e5fb513-77e7-4046-a8e8-aab94e61ca0f
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォームの Timer コンポーネントの Interval プロパティの制限
+Windows フォームの <xref:System.Windows.Forms.Timer> コンポーネントの <xref:System.Windows.Forms.Timer.Interval%2A> プロパティは、1 つのタイマー イベントから次のタイマー イベントまでの時間間隔をミリ秒単位で指定します。  コンポーネントが無効にされない限り、タイマーはほぼ一定の間隔で <xref:System.Windows.Forms.Timer.Tick> イベントを受信し続けます。  
+  
+ このコンポーネントは、Windows フォーム環境で使用します。  サーバー環境に適したタイマーが必要な場合は、「[Introduction to Server\-Based Timers](http://msdn.microsoft.com/ja-jp/adc0bc0a-a519-4812-bafc-fb9d1a5801fc)」を参照してください。  
+  
+## Interval プロパティ  
+ <xref:System.Windows.Forms.Timer.Interval%2A> プロパティには、<xref:System.Windows.Forms.Timer> コンポーネントのプログラミング時に考慮する必要のあるいくつかの制限があります。  
+  
+-   実行しているアプリケーションまたは他のアプリケーションがシステムに対して重い負荷をかけている場合 \(長いループ、複雑な計算、ドライブ、ネットワーク、ポートへのアクセスなど\) は、アプリケーションがタイマー イベントを受け取る間隔が <xref:System.Windows.Forms.Timer.Interval%2A> プロパティで指定されたよりも長くなることがあります。  
+  
+-   間隔が厳密に時間どおりに経過することは保証されていません。  正確さを保つには、内部で蓄積された時間を追跡する代わりに、必要に応じてシステム時計をチェックします。  
+  
+-   <xref:System.Windows.Forms.Timer.Interval%2A> プロパティの精度はミリ秒単位です。  コンピューターによっては、ミリ秒以上の高分解能カウンターが用意されているものがあります。  このようなカウンターが使用可能かどうかは、コンピューターのプロセッサ ハードウェアによります。  詳細については、マイクロソフト サポート技術情報 \(http:\/\/support.microsoft.com\) の文書 172338「QueryPerformanceCounter を使用してコードの時間を計測する方法」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Timer>   
+ [Timer コンポーネント](../../../../docs/framework/winforms/controls/timer-component-windows-forms.md)   
+ [Timer コンポーネントの概要](../../../../docs/framework/winforms/controls/timer-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md b/docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md
new file mode 100644
index 00000000000..585cebfa971
--- /dev/null
+++ b/docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md
@@ -0,0 +1,196 @@
+---
+title: "方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], LinkLabel コントロール"
+  - "リンク, ほかのフォームへの"
+  - "LinkLabel コントロール [Windows フォーム], 例"
+  - "LinkLabel コントロール [Windows フォーム], リンク (オブジェクトまたは Web ページに)"
+  - "リンク, ほかのフォームへの"
+  - "Web ページ リンク コントロール"
+  - "Windows フォーム, リンク (オブジェクトに)"
+  - "Windows フォーム, リンク (Web ページに)"
+ms.assetid: 6c91c975-3cb7-4504-82f0-fc6255f8fb85
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする
+Windows フォーム <xref:System.Windows.Forms.LinkLabel> コントロールを使用すると、フォーム上に Web スタイルのリンクを作成できます。  リンクをクリックしたときに、そのリンクにアクセスしたことがわかるように色を変更できます。  色の変更の詳細については、「[方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md)」を参照してください。  
+  
+## 別のフォームへのリンク  
+  
+#### LinkLabel コントロールによって、別のフォームにリンクするには  
+  
+1.  <xref:System.Windows.Forms.LinkLabel.Text%2A> プロパティに適切なキャプションを設定します。  
+  
+2.  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティを設定して、キャプションのどの部分をリンクとして表示するかを指定します。  どのように表示するかは、リンク ラベルの表示形式に関連するプロパティによって異なります。  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> の値は、<xref:System.Windows.Forms.LinkLabel.LinkArea%2A> オブジェクトで表されます。このオブジェクトには、文字の開始位置と文字数を示す 2 つの数字が含まれています。  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティは、\[プロパティ\] ウィンドウで、または次のような方法でコード内で設定できます。  
+  
+    ```vb  
+    ' In this code example, the link area has been set to begin  
+    ' at the first character and extend for eight characters.  
+    ' You may need to modify this based on the text entered in Step 1.  
+    LinkLabel1.LinkArea = New LinkArea(0, 8)  
+  
+    ```  
+  
+    ```csharp  
+    // In this code example, the link area has been set to begin  
+    // at the first character and extend for eight characters.  
+    // You may need to modify this based on the text entered in Step 1.  
+    linkLabel1.LinkArea = new LinkArea(0,8);  
+  
+    ```  
+  
+    ```cpp  
+    // In this code example, the link area has been set to begin  
+    // at the first character and extend for eight characters.  
+    // You may need to modify this based on the text entered in Step 1.  
+    linkLabel1->LinkArea = LinkArea(0,8);  
+    ```  
+  
+3.  <xref:System.Windows.Forms.LinkLabel.LinkClicked> イベント ハンドラーで、<xref:System.Windows.Forms.Form.Show%2A> メソッドを呼び出してプロジェクトで別のフォームを開き、<xref:System.Windows.Forms.LinkLabel.LinkVisited%2A> プロパティを `true` に設定します。  
+  
+    > [!NOTE]
+    >  クリックされた <xref:System.Windows.Forms.LinkLabel> コントロールへの参照が <xref:System.Windows.Forms.LinkLabelLinkClickedEventArgs> クラスのインスタンスに含まれているため、`sender` オブジェクトをキャストする必要はありません。  
+  
+    ```vb  
+    Protected Sub LinkLabel1_LinkClicked(ByVal Sender As System.Object, _  
+       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _  
+       Handles LinkLabel1.LinkClicked  
+       ' Show another form.  
+       Dim f2 As New Form()  
+       f2.Show  
+       LinkLabel1.LinkVisited = True  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    protected void linkLabel1_LinkClicked(object sender, System. Windows.Forms.LinkLabelLinkClickedEventArgs e)  
+    {  
+       // Show another form.  
+       Form f2 = new Form();  
+       f2.Show();  
+       linkLabel1.LinkVisited = true;  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void linkLabel1_LinkClicked(System::Object ^  sender,  
+          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)  
+       {  
+          // Show another form.  
+          Form ^ f2 = new Form();  
+          f2->Show();  
+          linkLabel1->LinkVisited = true;  
+       }  
+    ```  
+  
+## Web ページへのリンク  
+ <xref:System.Windows.Forms.LinkLabel> コントロールを使用すると、既定のブラウザーで Web ページを表示することもできます。  
+  
+#### Internet Explorer を起動し、LinkLabel コントロールによって Web ページにリンクするには  
+  
+1.  <xref:System.Windows.Forms.LinkLabel.Text%2A> プロパティに適切なキャプションを設定します。  
+  
+2.  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティを設定して、キャプションのどの部分をリンクとして表示するかを指定します。  
+  
+3.  <xref:System.Windows.Forms.LinkLabel.LinkClicked> イベント ハンドラーの例外処理ブロック内で第 2 のプロシージャを呼び出します。このプロシージャでは、<xref:System.Windows.Forms.LinkLabel.LinkVisited%2A> プロパティを `true` に設定し、<xref:System.Diagnostics.Process.Start%2A> メソッドを使用して既定のブラウザーを該当の URL で起動します。  <xref:System.Diagnostics.Process.Start%2A> メソッドを使用するには、<xref:System.Diagnostics?displayProperty=fullName> 名前空間への参照を追加する必要があります。  
+  
+    > [!IMPORTANT]
+    >  部分的に信頼できる環境 \(共有ドライブなど\) で次のコードを実行した場合、`VisitLink` メソッドの呼び出し時に JIT コンパイラでエラーが発生します。  `System.Diagnostics.Process.Start` のステートメントが発生するリンク確認要求が発生します。  `VisitLink` メソッドの呼び出し時に例外をキャッチすると、次のコードで JIT コンパイラのエラーが発生しても正常に処理されるようになります。  
+  
+    ```vb  
+    Private Sub LinkLabel1_LinkClicked(ByVal sender As System.Object, _  
+       ByVal e As System.Windows.Forms.LinkLabelLinkClickedEventArgs) _  
+       Handles LinkLabel1.LinkClicked  
+       Try  
+          VisitLink()  
+       Catch ex As Exception  
+          ' The error message  
+          MessageBox.Show("Unable to open link that was clicked.")  
+       End Try  
+    End Sub  
+  
+    Sub VisitLink()  
+       ' Change the color of the link text by setting LinkVisited   
+       ' to True.  
+       LinkLabel1.LinkVisited = True  
+       ' Call the Process.Start method to open the default browser   
+       ' with a URL:  
+       System.Diagnostics.Process.Start("http://www.microsoft.com")  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void linkLabel1_LinkClicked(object sender, System.Windows.Forms.LinkLabelLinkClickedEventArgs e)  
+    {  
+       try  
+       {  
+          VisitLink();  
+       }  
+       catch (Exception ex )  
+       {  
+          MessageBox.Show("Unable to open link that was clicked.");  
+       }  
+    }  
+  
+    private void VisitLink()  
+    {  
+       // Change the color of the link text by setting LinkVisited   
+       // to true.  
+       linkLabel1.LinkVisited = true;  
+       //Call the Process.Start method to open the default browser   
+       //with a URL:  
+       System.Diagnostics.Process.Start("http://www.microsoft.com");  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void linkLabel1_LinkClicked(System::Object ^  sender,  
+          System::Windows::Forms::LinkLabelLinkClickedEventArgs ^  e)  
+       {  
+          try  
+          {  
+             VisitLink();  
+          }  
+          catch (Exception ^ ex)  
+          {  
+             MessageBox::Show("Unable to open link that was clicked.");  
+          }  
+       }  
+    private:  
+       void VisitLink()  
+       {  
+          // Change the color of the link text by setting LinkVisited   
+          // to true.  
+          linkLabel1->LinkVisited = true;  
+          // Call the Process.Start method to open the default browser   
+          // with a URL:  
+          System::Diagnostics::Process::Start("http://www.microsoft.com");  
+       }  
+    ```  
+  
+## 参照  
+ <xref:System.Diagnostics.Process.Start%2A?displayProperty=fullName>   
+ [LinkLabel コントロールの概要](../../../../docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md)   
+ [LinkLabel コントロール](../../../../docs/framework/winforms/controls/linklabel-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md b/docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md
new file mode 100644
index 00000000000..8c19fc2c654
--- /dev/null
+++ b/docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "LinkLabel コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "LinkLabel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Label コントロール [Windows フォーム], Label コントロールの概要"
+  - "LinkLabel コントロール [Windows フォーム], LinkLabel コントロールの概要"
+  - "リンク, LinkLabel コントロール"
+ms.assetid: 9e248549-10ca-43a3-bb5e-60f583d369f1
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# LinkLabel コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.LinkLabel> コントロールを使用すると、Web スタイルのリンクを Windows フォーム アプリケーションに追加できます。  <xref:System.Windows.Forms.LinkLabel> コントロールは、<xref:System.Windows.Forms.Label> コントロールを使用できるすべての項目に使用できます。テキストの一部をファイル、フォルダー、または Web ページへのリンクとして設定することもできます。  
+  
+## LinkLabel コントロールで可能なこと  
+ <xref:System.Windows.Forms.Label> コントロールには、<xref:System.Windows.Forms.LinkLabel> コントロールのすべてのプロパティ、メソッド、およびイベントに加えて、ハイパーリンクとリンクの色を設定するプロパティがあります。  <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティでは、リンクをアクティブにするテキストの領域を設定します。  <xref:System.Windows.Forms.LinkLabel.LinkColor%2A> プロパティ、<xref:System.Windows.Forms.LinkLabel.VisitedLinkColor%2A> プロパティ、および <xref:System.Windows.Forms.LinkLabel.ActiveLinkColor%2A> プロパティでは、リンクの色を設定します。  <xref:System.Windows.Forms.LinkLabel.LinkClicked> イベントでは、リンク テキストを選択したときの動作を指定します。  
+  
+ <xref:System.Windows.Forms.LinkLabel> コントロールの最も単純な用途は <xref:System.Windows.Forms.LinkLabel.LinkArea%2A> プロパティを使用した単一リンクの表示ですが、<xref:System.Windows.Forms.LinkLabel.Links%2A> プロパティを使用することによって複数のハイパーリンクを表示することもできます。  <xref:System.Windows.Forms.LinkLabel.Links%2A> プロパティを使用すると、リンクのコレクションにアクセスできます。  また、各 <xref:System.Windows.Forms.LinkLabel.Link> オブジェクトの <xref:System.Windows.Forms.LinkLabel.Link.LinkData%2A> プロパティ内にデータを指定することもできます。  <xref:System.Windows.Forms.LinkLabel.Link.LinkData%2A> プロパティの値は、表示するファイルの場所や Web サイトのアドレスを格納するために使用できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.LinkLabel>   
+ [Label コントロールの概要](../../../../docs/framework/winforms/controls/label-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする](../../../../docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md)   
+ [方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/linklabel-control-windows-forms.md b/docs/framework/winforms/controls/linklabel-control-windows-forms.md
new file mode 100644
index 00000000000..5f2dfe3f137
--- /dev/null
+++ b/docs/framework/winforms/controls/linklabel-control-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "LinkLabel コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Label コントロール [Windows フォーム]"
+  - "LinkLabel コントロール [Windows フォーム]"
+  - "リンク, 追加 (Windows フォームに)"
+  - "Web ページ リンク コントロール"
+  - "Windows フォーム, 追加 (リンクを)"
+ms.assetid: af1fd04e-e126-4fd7-9a4e-13b49010c5ca
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# LinkLabel コントロール (Windows フォーム)
+Windows フォームの `LinkLabel` コントロールを使用すると、Web スタイルのリンクを Windows フォーム アプリケーションに追加できます。  `LinkLabel` コントロールは、<xref:System.Windows.Forms.Label> コントロールを使用できるすべての項目に使用できます。テキストの一部をオブジェクトまたは Web ページへのリンクとして設定することもできます。  
+  
+## このセクションの内容  
+ [LinkLabel コントロールの概要](../../../../docs/framework/winforms/controls/linklabel-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム LinkLabel コントロールの表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-linklabel-control.md)  
+ リンク ラベルの Web スタイル リンクの色と下線を指定する方法の一覧を示します。  
+  
+ [方法 : Windows フォーム LinkLabel コントロールでオブジェクトまたは Web ページにリンクする](../../../../docs/framework/winforms/controls/link-to-an-object-or-web-page-with-wf-linklabel-control.md)  
+ リンクをクリックしてフォームまたは Web ページを開く手順について説明します。  
+  
+ [方法 : Windows フォームの LinkLabel コントロールから Web ページを表示する \(Visual Basic\)](../../../../docs/framework/winforms/controls/display-a-web-page-from-a-wf-linklabel-control-visual-basic.md)  
+ ユーザーが Windows フォームの `LinkLabel` コントロールをクリックしたときに、既定のブラウザーに Web ページを表示する方法を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.LinkLabel> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/listbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/listbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..575f2ea03dc
--- /dev/null
+++ b/docs/framework/winforms/controls/listbox-control-overview-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "ListBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ListBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ボックス, リスト ボックスの概要"
+  - "ListBox コントロール [Windows フォーム], ListBox コントロールの概要"
+ms.assetid: 37ea226b-6fc8-4c70-936a-c6af4e0cad4c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ListBox コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ListBox> コントロールを使用すると、リストが表示され、ユーザーは 1 つ以上の項目を選択できます。  項目の合計数が表示限度を超えた場合は、<xref:System.Windows.Forms.ListBox> コントロールにスクロール バーが自動的に追加されます。  <xref:System.Windows.Forms.ListBox.MultiColumn%2A> プロパティを `true` に設定した場合は、項目が複数列で表示され、水平スクロール バーが表示されます。  <xref:System.Windows.Forms.ListBox.MultiColumn%2A> プロパティを `false` に設定した場合は、項目が単一列で表示され、垂直スクロール バーが表示されます。  <xref:System.Windows.Forms.ListBox.ScrollAlwaysVisible%2A> を `true` に設定している場合は、項目数に関係なくスクロール バーが表示されます。  <xref:System.Windows.Forms.ListBox.SelectionMode%2A> プロパティでは、一度に選択できるリスト項目の数を指定します。  
+  
+## ListBox コントロールの変更方法  
+ <xref:System.Windows.Forms.ListBox.SelectedIndex%2A> プロパティは、リスト ボックス内で最初に選択した項目に対応する整数値を取得します。  コードの <xref:System.Windows.Forms.ListBox.SelectedIndex%2A> 値を変更することによって、選択した項目をプログラムで変更できます。リスト内の対応する項目が、Windows フォーム上に強調表示されます。  選択項目がない場合、<xref:System.Windows.Forms.ListBox.SelectedIndex%2A> 値は \-1 となります。  リストの最初の項目を選択した場合、<xref:System.Windows.Forms.ListBox.SelectedIndex%2A> 値は 0 となります。  複数の項目が選択されている場合、<xref:System.Windows.Forms.ListBox.SelectedIndex%2A> 値は、リストの最上位に表示される選択項目を表します。  <xref:System.Windows.Forms.ListBox.SelectedItem%2A> プロパティは <xref:System.Windows.Forms.ListBox.SelectedIndex%2A> に似ていますが、項目自体 \(通常は文字列値\) を返す点が異なります。  <xref:System.Windows.Forms.ListBox.ObjectCollection.Count%2A> プロパティは、リスト内の項目数を表します。<xref:System.Windows.Forms.ListBox.SelectedIndex%2A> はゼロから始まるため、<xref:System.Windows.Forms.ListBox.ObjectCollection.Count%2A> プロパティの値は、<xref:System.Windows.Forms.ListBox.SelectedIndex%2A> の最大値よりも常に 1 大きくなります。  
+  
+ <xref:System.Windows.Forms.ListBox> コントロールの項目を追加または削除するには、<xref:System.Windows.Forms.ListBox.ObjectCollection.Add%2A> メソッド、<xref:System.Windows.Forms.ListBox.ObjectCollection.Insert%2A> メソッド、<xref:System.Windows.Forms.ListBox.ObjectCollection.Clear%2A> メソッド、または <xref:System.Windows.Forms.ListBox.ObjectCollection.Remove%2A> メソッドを使用します。  デザイン時に <xref:System.Windows.Forms.ListBox.Items%2A> プロパティを使用して、リストに項目を追加することもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListBox>   
+ [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](../../../../docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)   
+ [方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする ](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md)   
+ [ComboBox コントロールの概要](../../../../docs/framework/winforms/controls/combobox-control-overview-windows-forms.md)   
+ [CheckedListBox コントロールの概要](../../../../docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する](../../../../docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/listbox-control-windows-forms.md b/docs/framework/winforms/controls/listbox-control-windows-forms.md
new file mode 100644
index 00000000000..eca60e7d702
--- /dev/null
+++ b/docs/framework/winforms/controls/listbox-control-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "ListBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ボックス コントロール"
+  - "リスト ボックス"
+  - "リスト ボックス, Windows フォーム コントロール"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+  - "ListBox コントロール [Windows フォーム]"
+ms.assetid: b0172473-c5f2-411e-aaa4-c8f17cb5eed4
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ListBox コントロール (Windows フォーム)
+Windows フォームの `ListBox` コントロールを使用すると、項目のリストが表示され、ユーザーは 1 つ以上の項目を選択できます。  
+  
+## このセクションの内容  
+ [ListBox コントロールの概要](../../../../docs/framework/winforms/controls/listbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ListBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)  
+ リスト ボックス、コンボ ボックス、およびチェックされたリスト ボックスの機能の一覧を提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/listview-control-overview-windows-forms.md b/docs/framework/winforms/controls/listview-control-overview-windows-forms.md
new file mode 100644
index 00000000000..fcf5c5088f2
--- /dev/null
+++ b/docs/framework/winforms/controls/listview-control-overview-windows-forms.md
@@ -0,0 +1,71 @@
+---
+title: "ListView コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ListView"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リスト ビュー"
+  - "一覧"
+  - "ListView コントロール [Windows フォーム], ListView コントロールの概要"
+ms.assetid: c9ef56c1-3bb1-4101-9f4e-e95e720f2756
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ListView コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ListView> コントロールは、項目をアイコンと一緒に一覧表示します。  リスト ビューを使用すると、Windows エクスプローラーの右側のペインのようなユーザー インターフェイスを作成できます。  このコントロールには、LargeIcon、SmallIcon、List、Details の 4 つのビュー モードがあります。  
+  
+## ListView コントロールで可能なこと  
+  
+> [!NOTE]
+>  新しく追加されたビュー モードである、並べて表示モードは、Windows XP と Windows Server 2003 の各オペレーティング システムでのみ使用できます。  詳細については、「[方法 : Windows フォーム ListView コントロールの "並べて表示" ビューを有効にする](../../../../docs/framework/winforms/controls/how-to-enable-tile-view-in-a-windows-forms-listview-control.md)」を参照してください。  
+  
+ LargeIcon モードでは、項目のテキストのそばに大きなアイコンが表示されます。コントロールが十分に大きい場合は、項目が複数の列に表示されます。  SmallIcon モードは、表示されるアイコンが小さい点を除けば LargeIcon モードと同じです。  List モードでは、小さなアイコンが表示されますが、項目は必ず 1 列で表示されます。  Details モードでは、各項目に関する情報が複数の列に表示されます。  詳細については、「[方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)」を参照してください。  ビュー モードは、<xref:System.Windows.Forms.ListView.View%2A> プロパティによって決定されます。  いずれのモードでも、イメージ リストのイメージを表示できます。  詳細については、「[方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)」を参照してください。  
+  
+ 次の表では、<xref:System.Windows.Forms.ListView> のメンバーの一部およびそれらが有効であるビューを一覧しています。  
+  
+|ListView メンバー|ビュー|  
+|-------------------|---------|  
+|<xref:System.Windows.Forms.ListView.Alignment%2A> プロパティ|<xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.AutoArrange%2A> プロパティ|<xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.AutoResizeColumn%2A> メソッド|<xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.Columns%2A> プロパティ|<xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.DrawSubItem> イベント|<xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.FindItemWithText%2A> メソッド|<xref:System.Windows.Forms.View>、<xref:System.Windows.Forms.View>、または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.FindNearestItem%2A> メソッド|<xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.GetItemAt%2A> メソッド|<xref:System.Windows.Forms.View> または <xref:System.Windows.Forms.View>|  
+|<xref:System.Windows.Forms.ListView.Groups%2A> プロパティ|<xref:System.Windows.Forms.View> 以外のすべてのビュー|  
+|<xref:System.Windows.Forms.ListView.HeaderStyle%2A> プロパティ|<xref:System.Windows.Forms.View>.|  
+|<xref:System.Windows.Forms.ListView.InsertionMark%2A> プロパティ|<xref:System.Windows.Forms.View>、<xref:System.Windows.Forms.View>、または <xref:System.Windows.Forms.View>|  
+  
+ <xref:System.Windows.Forms.ListView> コントロールの主要プロパティは <xref:System.Windows.Forms.ListView.Items%2A> です。このプロパティは、コントロールによって表示される項目を保持します。  <xref:System.Windows.Forms.ListView.SelectedItems%2A> プロパティは、コントロールで現在選択されている項目を保持します。  <xref:System.Windows.Forms.ListView.MultiSelect%2A> プロパティが `true` に設定されている場合、ユーザーは複数の項目を選択できます。たとえば、一度に複数の項目を別のコントロールにドラッグ アンド ドロップできます。  <xref:System.Windows.Forms.ListView.CheckBoxes%2A> プロパティが `true` に設定されている場合、<xref:System.Windows.Forms.ListView> コントロールでは、項目の横にチェック ボックスを表示できます。  
+  
+ <xref:System.Windows.Forms.ListView.Activation%2A> プロパティは、リスト内の項目をアクティブにするためにユーザーが実行する必要のある操作を決定します。指定できるオプションは、<xref:System.Windows.Forms.ItemActivation>、<xref:System.Windows.Forms.ItemActivation>、および <xref:System.Windows.Forms.ItemActivation> です。  アクティブ化する操作が <xref:System.Windows.Forms.ItemActivation> の場合、項目をアクティブにするにはシングル クリックする必要があります。  <xref:System.Windows.Forms.ItemActivation> の場合は、項目をアクティブにするには、ダブルクリックする必要があります。シングル クリックすると、項目テキストの色が変わります。  <xref:System.Windows.Forms.ItemActivation> の場合は、項目をアクティブにするには、ダブルクリックする必要がありますが、外観は変わりません。  
+  
+ <xref:System.Windows.Forms.ListView> コントロールでは、グループ化、並べて表示ビュー、挿入マークなど、Windows XP プラットフォームで使用できる visual スタイルなどの機能もサポートされています。  詳細については、「[Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ListView>   
+ [ListView コントロール](../../../../docs/framework/winforms/controls/listview-control-windows-forms.md)   
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロール内の項目を選択する](../../../../docs/framework/winforms/controls/how-to-select-an-item-in-the-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールの項目をグループ化する](../../../../docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md)   
+ [方法 : Windows フォーム ListView コントロールに挿入マークを表示する](../../../../docs/framework/winforms/controls/how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md)   
+ [方法 : ListView コントロールに検索機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)   
+ [方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/listview-control-windows-forms.md b/docs/framework/winforms/controls/listview-control-windows-forms.md
new file mode 100644
index 00000000000..a561b763b07
--- /dev/null
+++ b/docs/framework/winforms/controls/listview-control-windows-forms.md
@@ -0,0 +1,98 @@
+---
+title: "ListView コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェックされたリスト項目, Windows フォーム コントロール"
+  - "アイコン, 一覧 (項目を)"
+  - "リスト コントロール, リスト ビュー"
+  - "リスト ビュー"
+  - "一覧"
+  - "一覧, アイコン表示で項目を"
+  - "ListView コントロール [Windows フォーム]"
+  - "ユーザー インターフェイス, 作成"
+ms.assetid: 9f71cf5c-82da-488a-a04e-ef52c0817187
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# ListView コントロール (Windows フォーム)
+Windows フォーム `ListView` コントロールにはアイコン表示で項目の一覧が表示されます。  リスト ビューを使用すると、Windows エクスプローラーの右側のペインのようなユーザー インターフェイスを作成することができます。  
+  
+## このセクションの内容  
+ [ListView コントロールの概要](../../../../docs/framework/winforms/controls/listview-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム ListView コントロールで項目を追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-items-with-the-windows-forms-listview-control.md)  
+ リスト ビューから項目を追加または削除する方法について説明します。  
+  
+ [方法 : Windows フォーム ListView コントロールに列を追加する](../../../../docs/framework/winforms/controls/how-to-add-columns-to-the-windows-forms-listview-control.md)  
+ 各リスト項目に関する情報を表示するために列を作成する方法について説明します。  
+  
+ [方法 : Windows フォーム ListView コントロールのアイコンを表示する](../../../../docs/framework/winforms/controls/how-to-display-icons-for-the-windows-forms-listview-control.md)  
+ 大きいアイコンまたは小さいアイコンを表示するための適切なイメージ リストとリスト ビューを関連付ける方法について説明します。  
+  
+ [方法 : Windows フォーム ListView コントロールの列にサブ項目を表示する](../../../../docs/framework/winforms/controls/how-to-display-subitems-in-columns-with-the-windows-forms-listview-control.md)  
+ 列の各リスト項目に関する情報を表示する方法について説明します。  
+  
+ [方法 : Windows フォーム ListView コントロール内の項目を選択する](../../../../docs/framework/winforms/controls/how-to-select-an-item-in-the-windows-forms-listview-control.md)  
+ プログラムによって項目を選択する方法について説明します。  
+  
+ [方法 : Windows フォーム ListView コントロールの項目をグループ化する](../../../../docs/framework/winforms/controls/how-to-group-items-in-a-windows-forms-listview-control.md)  
+ カテゴリ別表示用のグループを作成して各グループに項目を割り当てる方法について説明します。  
+  
+ この機能は、[!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] でのみ使用できます。  
+  
+ [方法 : Windows フォーム ListView コントロールの "並べて表示" ビューを有効にする](../../../../docs/framework/winforms/controls/how-to-enable-tile-view-in-a-windows-forms-listview-control.md)  
+ 大きいアイコンと複数行のテキストで構成される項目のタイル表示の方法について説明します。  
+  
+ この機能は、[!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] でのみ使用できます。  
+  
+ [方法 : Windows フォーム ListView コントロールに挿入マークを表示する](../../../../docs/framework/winforms/controls/how-to-display-an-insertion-mark-in-a-windows-forms-listview-control.md)  
+ 挿入マークがマウス ポインターの位置ごとにドロップする場所を示す、ドラッグ アンド ドロップ操作のためのユーザー フィードバックを実装する方法について説明します。  
+  
+ この機能は、[!INCLUDE[WinXpFamily](../../../../includes/winxpfamily-md.md)] でのみ使用できます。  
+  
+ [方法 : ListView コントロールに検索機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-search-capabilities-to-a-listview-control.md)  
+ プログラムでいずれかのテキストの検索または画面座標を使用してアイテムを検索する方法について説明します。  
+  
+-   [方法 : デザイナーを使って Windows フォーム ListView コントロールの "並べて表示" ビューを有効にする](http://msdn.microsoft.com/library/ms233655\(v=vs.110\))  
+  
+-   [方法 : デザイナーで Windows フォーム ListView コントロールを使って項目を追加および削除する](http://msdn.microsoft.com/library/ms233671\(v=vs.110\))  
+  
+-   [方法 :デザイナーを使って Windows フォーム ListView コントロールに列を追加する](http://msdn.microsoft.com/library/ms233652\(v=vs.110\))  
+  
+-   [方法 : デザイナーを使って Windows フォーム ListView コントロールの項目をグループ化する](http://msdn.microsoft.com/library/ms233663\(v=vs.110\))  
+  
+-   [チュートリアル : デザイナーを使用した、ListView コントロールと TreeView コントロールを含むエクスプローラー スタイルのインターフェイスの作成](http://msdn.microsoft.com/library/ms171645\(v=vs.110\))  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ListView> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)  
+ リスト ビュー内のアイテムまたはツリー ビュー内のノードから継承して、必要なフィールド、メソッド、またはコンストラクターを追加するための手順を説明します。  
+  
+ [ImageList コンポーネント](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md)  
+ イメージ リストの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md)  
+ 複数のペインで Windows フォームのレイアウトを設定するための方法を説明します。  
+  
+ [Windows XP Features and Windows Forms Controls](http://msdn.microsoft.com/ja-jp/bc7fab94-fce9-4bf1-a8ad-a5837c91c3c0)  
+ <xref:System.Windows.Forms.ListView> コントロールに適用される、Windows XP に固有の機能を活用する方法について説明します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/load-save-and-cancel-bindingnavigator.md b/docs/framework/winforms/controls/load-save-and-cancel-bindingnavigator.md
new file mode 100644
index 00000000000..c8f4be03927
--- /dev/null
+++ b/docs/framework/winforms/controls/load-save-and-cancel-bindingnavigator.md
@@ -0,0 +1,135 @@
+---
+title: "方法 : Windows フォーム BindingNavigator コントロールに [Load]、[Save]、[Cancel] の各ボタンを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム]、操作"
+  - "BindingNavigator コントロール [Windows フォーム]、ボタンの追加"
+ms.assetid: faa33042-186e-4bb2-8798-17ceb987ec62
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム BindingNavigator コントロールに [Load]、[Save]、[Cancel] の各ボタンを追加する
+<xref:System.Windows.Forms.BindingNavigator> コントロールは、フォーム上のデータ バインド コントロールの移動や操作に用途が特化された <xref:System.Windows.Forms.ToolStrip> コントロールです。  
+  
+ <xref:System.Windows.Forms.BindingNavigator> コンポーネントは <xref:System.Windows.Forms.ToolStrip> コントロールであるため、簡単に変更でき、ユーザー向けの追加コマンドや代替コマンドを含めることができます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.TextBox> コントロールをデータにバインドし、フォームに追加した <xref:System.Windows.Forms.ToolStrip> コントロールを変更して、\[Load\]、\[Save\]、\[Cancel\] の各ボタンを追加します。  
+  
+### BindingNavigator コンポーネントに \[Load\] ボタン、\[Save\] ボタン、および \[Cancel\] ボタンを追加するには  
+  
+1.  フォームに <xref:System.Windows.Forms.TextBox> コントロールを追加します。  
+  
+2.  このコントロールを、データ ソースにバインドされている <xref:System.Windows.Forms.BindingSource> にバインドします。  この例では、<xref:System.Windows.Forms.BindingSource> はデータベースにバインドされています。  
+  
+3.  データセットとテーブル アダプターが生成されたら、<xref:System.Windows.Forms.BindingNavigator> コントロールをフォームにドラッグします。  
+  
+4.  <xref:System.Windows.Forms.BindingNavigator> コントロールの <xref:System.Windows.Forms.BindingNavigator.BindingSource%2A> プロパティを、コントロールにバインドされているフォーム上の <xref:System.Windows.Forms.BindingSource> に設定します。  
+  
+5.  <xref:System.Windows.Forms.BindingNavigator> コントロールを選択します。  
+  
+6.  スマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして **\[BindingNavigator タスク\]** ダイアログ ボックスを表示し、**\[項目の編集\]** をクリックします。  
+  
+     **項目コレクション エディター**が表示されます。  
+  
+7.  **項目コレクション エディター**で、次の手順を実行します。  
+  
+    1.  適切な型の <xref:System.Windows.Forms.ToolStripItem> を選択し、**\[追加\]** をクリックして、<xref:System.Windows.Forms.ToolStripSeparator> と 3 つの <xref:System.Windows.Forms.ToolStripButton> 項目を追加します。  
+  
+    2.  各ボタンの <xref:System.Windows.Forms.ToolStripItem.Name%2A> `` プロパティを、それぞれ `` LoadButton、SaveButton、CancelButton `` に設定します。  
+  
+    3.  各ボタンの <xref:System.Windows.Forms.ToolStripItem.Text%2A>プロパティを、それぞれ `` Load、Save、Cancel `` に設定します。  
+  
+    4.  各ボタンの <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> プロパティを `` Text に設定します。  または、このプロパティを `` Image `` または `` ImageAndText `` に設定し、<xref:System.Windows.Forms.ToolStripItem.Image%2A> プロパティでイメージが表示されるように設定することもできます。  
+  
+    5.  **\[OK\]** をクリックしてダイアログ ボックスを閉じます。各ボタンが <xref:System.Windows.Forms.ToolStrip> に追加されます。  
+  
+8.  フォームを右クリックし、**\[コードの表示\]** をクリックします。  
+  
+9. コード エディターで、テーブル アダプターにデータを読み込むコード行を見つけます。  このコードは、手順 2. でデータ バインディングを設定したときに生成されます。  たとえば、`TableAdapterName.Fill(DataSetName.TableName)` のようになります。  このコードは、一般にフォームの <xref:System.Windows.Forms.Form.Load> イベントに含まれます。  
+  
+10. 作成済みの `` **\[Load\]** `` <xref:System.Windows.Forms.ToolStripButton> の <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成し、データ読み込みコードをこのハンドラーに移動します。  
+  
+     コードは次のようになります。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub LoadButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles LoadButton.Click  
+        TableAdapterName.Fill(DataSetName.TableName)  
+    End Sub  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void LoadButton_Click(System.Object sender,   
+        System.EventArgs e)  
+    {  
+        TableAdapterName.Fill(DataSetName.TableName);  
+    }  
+    ```  
+  
+11. 作成済みの **\[Save\]** `` <xref:System.Windows.Forms.ToolStripButton> の <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成し、コントロールがバインドされている、テーブル内のデータを更新するコードを記述します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub SaveButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles SaveButton.Click  
+        TableAdapterName.Update(DataSetName.TableName)  
+    End Sub  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void SaveButton_Click(System.Object sender,   
+        System.EventArgs e)  
+    {  
+        TableAdapterName.Update(DataSetName.TableName);  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.BindingNavigator> コンポーネントには、既に `` **\[Save\]** ボタンが設定されている場合もありますが、Windows フォーム デザイナーによってコードは生成されていません。  このような場合は、<xref:System.Windows.Forms.ToolStrip> で新しいボタンを作成するのではなく、既存のボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベント ハンドラーに前述のコードを配置できます。  ただし、ボタンは既定で無効になっているため、ボタンの <xref:System.Windows.Forms.ToolBarButton.Enabled%2A> プロパティを `true` に設定し、ボタンが適切に機能するようにします。  
+  
+12. 作成済みの `` **\[Cancel\]** `` <xref:System.Windows.Forms.ToolStripButton> の <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成し、表示されているデータ レコードに対する変更をキャンセルするコードを記述します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub CancelButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CancelButton.Click  
+        BindingSourceName.CancelEdit()  
+    End Sub  
+    ```  
+  
+     \[C\#\]  
+  
+    ```  
+    private void CancelButton_Click(System.Object sender, System.EventArgs e)  
+    {  
+        BindingSourceName.CancelEdit();  
+    }  
+    ```  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.BindingSource.CancelEdit%2A> メソッドのスコープはデータ行です。  個々のレコードの表示中に行った変更は、次のレコードに移動する前に保存してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)   
+ [BindingSource コンポーネントの概要](../../../../docs/framework/winforms/controls/bindingsource-component-overview.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/mainmenu-component-overview-windows-forms.md b/docs/framework/winforms/controls/mainmenu-component-overview-windows-forms.md
new file mode 100644
index 00000000000..c9d39cc8dbc
--- /dev/null
+++ b/docs/framework/winforms/controls/mainmenu-component-overview-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "MainMenu コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "MenuItem"
+  - "MainMenu"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MainMenu コントロール [Windows フォーム], MainMenu コントロールの概要"
+  - "メニュー"
+ms.assetid: b41cc5a3-cc59-4996-aa3c-8dd9c17d3c90
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# MainMenu コンポーネントの概要 (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.MenuStrip> と <xref:System.Windows.Forms.ContextMenuStrip> は、以前のバージョンの <xref:System.Windows.Forms.MainMenu> コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、<xref:System.Windows.Forms.MainMenu> および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.MainMenu> コンポーネントを使用すると、実行時にメニューが表示されます。  メイン メニューに属するすべてのサブメニューおよび各項目は <xref:System.Windows.Forms.MenuItem> オブジェクトです。  
+  
+## 主要なプロパティ  
+ <xref:System.Windows.Forms.MenuItem.DefaultItem%2A> プロパティを `true` に設定することによって、メニュー項目を既定の項目として指定できます。  既定の項目は、メニューをクリックしたときに太字のテキストで表示されます。  メニュー項目の <xref:System.Windows.Forms.MenuItem.Checked%2A> プロパティは、`true` または `false` のいずれかの値となり、メニュー項目が選択されているかどうかを示します。  メニュー項目の <xref:System.Windows.Forms.MenuItem.RadioCheck%2A> プロパティは、選択されている項目の外観をカスタマイズします。<xref:System.Windows.Forms.MenuItem.RadioCheck%2A> が `true` に設定されている場合は、項目の横にオプション ボタンが表示され、<xref:System.Windows.Forms.MenuItem.RadioCheck%2A> が `false` に設定されている場合は、項目の横にチェック マークが表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MainMenu>   
+ <xref:System.Windows.Forms.Menu>   
+ <xref:System.Windows.Forms.MenuItem>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/mainmenu-component-windows-forms.md b/docs/framework/winforms/controls/mainmenu-component-windows-forms.md
new file mode 100644
index 00000000000..5bb81aec47e
--- /dev/null
+++ b/docs/framework/winforms/controls/mainmenu-component-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "MainMenu コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MainMenu コントロール [Windows フォーム]"
+ms.assetid: 7cd22f29-828b-42e8-9c88-f08aa4533850
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# MainMenu コンポーネント (Windows フォーム)
+> [!NOTE]
+>  `MenuStrip` と `ContextMenuStrip` は、以前のバージョンの `MainMenu` コントロールおよび <xref:System.Windows.Forms.ContextMenu> コントロールに代わると共に追加の機能を提供しますが、`MainMenu` および <xref:System.Windows.Forms.ContextMenu> は、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ Windows フォームの `MainMenu` コンポーネントを使用すると、実行時にメニューが表示されます。  
+  
+## このセクションの内容  
+ [MainMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/mainmenu-component-overview-windows-forms.md)  
+ このコンポーネントの用途、主な機能、およびプロパティについて説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.MainMenu>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/make-columns-read-only-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/make-columns-read-only-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..64a10fcc3c0
--- /dev/null
+++ b/docs/framework/winforms/controls/make-columns-read-only-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 読み取り専用"
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 読み取り専用列"
+  - "Windows フォーム, 列"
+ms.assetid: b4ef7a75-ab33-4ee3-b2cf-201530e454e9
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする
+既定では、ユーザーは Windows フォーム <xref:System.Windows.Forms.DataGridView> コントロールに表示されるテキストと数値データを変更できます。  表示するデータを変更できないようにする場合は、データを含む列を読み取り専用にする必要があります。  コントロールを完全に読み取り専用にする方法の詳細については、「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### デザイナーを使用して列を読み取り専用にするには  
+  
+1.  <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[列の編集\]** を選択します。  
+  
+2.  **\[選択された列\]** ボックスの一覧で列を選択します。  
+  
+3.  **\[列のプロパティ\]** グリッドで、<xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A> プロパティを `true` に設定します。  
+  
+    > [!NOTE]
+    >  **\[列の追加\]** ダイアログ ボックスの **\[読み取り専用\]** チェック ボックスをオンにすることによって、列の追加時に列を読み取り専用にすることもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.ReadOnly%2A?displayProperty=fullName>   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)   
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/margin-and-padding-in-windows-forms-controls.md b/docs/framework/winforms/controls/margin-and-padding-in-windows-forms-controls.md
new file mode 100644
index 00000000000..54ed6ce2860
--- /dev/null
+++ b/docs/framework/winforms/controls/margin-and-padding-in-windows-forms-controls.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォーム コントロールでのマージンと埋め込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "レイアウト [Windows フォーム], マージンと埋め込み"
+  - "Margin プロパティ [Windows フォーム]"
+  - "Padding プロパティ [Windows フォーム]"
+  - "Windows フォーム, レイアウト"
+ms.assetid: 3781b5a1-3085-4072-bed0-44670c23ffdc
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# Windows フォーム コントロールでのマージンと埋め込み
+フォーム上のコントロールを正確に配置することは、多くのアプリケーションで優先度の高い作業です。  <xref:System.Windows.Forms?displayProperty=fullName> 名前空間は、これを実現する多くのレイアウト機能を提供します。  最も重要な 2 つは、<xref:System.Windows.Forms.Control.Margin%2A> プロパティと <xref:System.Windows.Forms.Control.Padding%2A> プロパティです。  
+  
+ <xref:System.Windows.Forms.Control.Margin%2A> プロパティは、その他のコントロールで、コントロールの枠線からの指定された距離を保持するコントロールの周囲のスペースを定義します。  
+  
+ <xref:System.Windows.Forms.Control.Padding%2A> プロパティは、コントロールの内容 \(<xref:System.Windows.Forms.Control.Text%2A> プロパティの値など\) で、コントロールの枠線からの指定した距離を保持するコントロールの内部のスペースを定義します。  
+  
+ 次の図は、コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティと <xref:System.Windows.Forms.Control.Margin%2A> プロパティを示しています。  
+  
+ ![Windows フォーム コントロールのパディングとマージン](../../../../docs/framework/winforms/controls/media/vs-winformpadmargin.gif "VS\_WinFormPadMargin")  
+  
+ Visual Studio では、この機能のデザイン時サポートがあります。  「[チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](http://msdn.microsoft.com/library/3z3f9e8b\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.AutoSize%2A>   
+ <xref:System.Windows.Forms.Control.Margin%2A>   
+ <xref:System.Windows.Forms.Control.Padding%2A>   
+ <xref:System.Windows.Forms.Control.LayoutEngine%2A>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ <xref:System.Windows.Forms.FlowLayoutPanel>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md b/docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md
new file mode 100644
index 00000000000..1575fcef03c
--- /dev/null
+++ b/docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "MaskedTextBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "MaskedTextBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MaskedTextBox コントロール [Windows フォーム]"
+  - "テキスト ボックス, 検証 (ユーザー入力の)"
+  - "ユーザー入力, 検証 (Windows フォームで)"
+  - "検証 (ユーザー入力の), Windows フォーム"
+ms.assetid: 235d6121-027d-481d-8d59-4f6794d15d0c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# MaskedTextBox コントロール (Windows フォーム)
+このトピックでは、`MaskedTextBox` コントロールに関する他のトピックへのリンクを示します。  
+  
+## このセクションの内容  
+ [チュートリアル : MaskedTextBox コントロールの使用](../../../../docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md)  
+ `MaskedTextBox` コントロールの主な機能について説明します。  
+  
+ [方法 : MaskedTextBox コントロールにデータをバインドする](../../../../docs/framework/winforms/controls/how-to-bind-data-to-the-maskedtextbox-control.md)  
+ データベースのデータがマスク定義で予期される書式に一致しない場合に、データの書式を再設定する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.MaskedTextBox>  
+ マスク付きテキスト ボックス コントロールを実装する基本クラスです。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/media/cpdatacontainerctrl.gif b/docs/framework/winforms/controls/media/cpdatacontainerctrl.gif
new file mode 100644
index 00000000000..8fafc3d6c3d
Binary files /dev/null and b/docs/framework/winforms/controls/media/cpdatacontainerctrl.gif differ
diff --git a/docs/framework/winforms/controls/media/demomarqueecontrol.gif b/docs/framework/winforms/controls/media/demomarqueecontrol.gif
new file mode 100644
index 00000000000..822874de4f5
Binary files /dev/null and b/docs/framework/winforms/controls/media/demomarqueecontrol.gif differ
diff --git a/docs/framework/winforms/controls/media/listviewgroups.gif b/docs/framework/winforms/controls/media/listviewgroups.gif
new file mode 100644
index 00000000000..417345f5249
Binary files /dev/null and b/docs/framework/winforms/controls/media/listviewgroups.gif differ
diff --git a/docs/framework/winforms/controls/media/listviewinsertion.gif b/docs/framework/winforms/controls/media/listviewinsertion.gif
new file mode 100644
index 00000000000..051aa6b5da6
Binary files /dev/null and b/docs/framework/winforms/controls/media/listviewinsertion.gif differ
diff --git a/docs/framework/winforms/controls/media/listviewtile.gif b/docs/framework/winforms/controls/media/listviewtile.gif
new file mode 100644
index 00000000000..6ae8e977345
Binary files /dev/null and b/docs/framework/winforms/controls/media/listviewtile.gif differ
diff --git a/docs/framework/winforms/controls/media/net-bindsrcdatabindarch.gif b/docs/framework/winforms/controls/media/net-bindsrcdatabindarch.gif
new file mode 100644
index 00000000000..192c1714260
Binary files /dev/null and b/docs/framework/winforms/controls/media/net-bindsrcdatabindarch.gif differ
diff --git a/docs/framework/winforms/controls/media/vbcontrol1.gif b/docs/framework/winforms/controls/media/vbcontrol1.gif
new file mode 100644
index 00000000000..5c06417e409
Binary files /dev/null and b/docs/framework/winforms/controls/media/vbcontrol1.gif differ
diff --git a/docs/framework/winforms/controls/media/vs-tlpanchor3.gif b/docs/framework/winforms/controls/media/vs-tlpanchor3.gif
new file mode 100644
index 00000000000..c4c7b72e711
Binary files /dev/null and b/docs/framework/winforms/controls/media/vs-tlpanchor3.gif differ
diff --git a/docs/framework/winforms/controls/media/vs-winformpadmargin.gif b/docs/framework/winforms/controls/media/vs-winformpadmargin.gif
new file mode 100644
index 00000000000..8bb7202b2c0
Binary files /dev/null and b/docs/framework/winforms/controls/media/vs-winformpadmargin.gif differ
diff --git a/docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md b/docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md
new file mode 100644
index 00000000000..b06ef4b8899
--- /dev/null
+++ b/docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "MenuStrip コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "MenuStrip"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー, 作成"
+  - "MenuStrip コントロール [Windows フォーム], MenuStrip コントロールの概要"
+ms.assetid: f45516e5-bf01-4468-b851-d45f4c33c055
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# MenuStrip コントロールの概要 (Windows フォーム)
+メニューは、共通のテーマでグループ化されたコマンドを保持することによってユーザーにさまざまな機能を公開します。  
+  
+ <xref:System.Windows.Forms.MenuStrip> コントロールは、このバージョンの Visual Studio および .NET Framework で追加された新機能です。  このコントロールを使用すると、Microsoft Office に表示されるようなメニューを簡単に作成できます。  
+  
+ <xref:System.Windows.Forms.MenuStrip> コントロールは、マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) と、メニューのマージ、ツール ヒント、およびオーバーフローをサポートします。  アクセス キー、ショートカット キー、チェック マーク、イメージ、および区分線を追加してメニューの使いやすさと読みやすさを向上させることもできます。  
+  
+ <xref:System.Windows.Forms.MenuStrip> コントロールは、<xref:System.Windows.Forms.MainMenu> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.MainMenu> コントロールは、下位互換性を保持するため、および将来必要になったときに使用できるように保持されています。  
+  
+## MenuStrip コントロールの用途  
+ <xref:System.Windows.Forms.MenuStrip> コントロールを使用すると、次のことができます。  
+  
+-   簡単にカスタマイズでき、一般的に使用できるだけでなく、高度なユーザー インターフェイス機能とレイアウト機能 \(テキストとイメージの並べ替えと配置、ドラッグ アンド ドロップ操作、MDI、オーバーフロー、およびメニュー コマンドにアクセスするための代替モード\) をサポートするメニューを作成する。  
+  
+-   オペレーティング システムの標準的な外観と動作をサポートする。  
+  
+-   他のコントロールのイベント処理と同じように、コンテナーおよびコンテナーに含まれる項目のすべてを一貫して処理する。  
+  
+ <xref:System.Windows.Forms.MenuStrip> および関連クラスの特に重要なプロパティのいくつかを次の表に示します。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A>|MDI 子フォームの一覧を表示するために使用する <xref:System.Windows.Forms.ToolStripMenuItem> を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripItem.MergeAction%2A?displayProperty=fullName>|MDI アプリケーションの子メニューを親メニューにマージする方法を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A?displayProperty=fullName>|MDI アプリケーションのメニュー内のマージされた項目の位置を取得または設定します。|  
+|<xref:System.Windows.Forms.Form.IsMdiContainer%2A?displayProperty=fullName>|フォームが MDI 子フォームのコンテナーであるかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.MenuStrip.ShowItemToolTips%2A>|<xref:System.Windows.Forms.MenuStrip> に対してツール ヒントを表示するかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.MenuStrip.CanOverflow%2A>|<xref:System.Windows.Forms.MenuStrip> がオーバーフロー機能をサポートするかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripMenuItem.ShortcutKeys%2A>|<xref:System.Windows.Forms.ToolStripMenuItem> に関連付けられたショートカット キーを取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripMenuItem.ShowShortcutKeys%2A>|<xref:System.Windows.Forms.ToolStripMenuItem> に関連付けられたショートカット キーを <xref:System.Windows.Forms.ToolStripMenuItem> の横に表示するかどうかを示す値を取得または設定します。|  
+  
+ 重要な <xref:System.Windows.Forms.MenuStrip> コンパニオン クラスを次の表に示します。  
+  
+|Class|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripMenuItem>|<xref:System.Windows.Forms.MenuStrip> または <xref:System.Windows.Forms.ContextMenuStrip> に表示される選択可能なオプションを表します。|  
+|<xref:System.Windows.Forms.ContextMenuStrip>|ショートカット メニューを表します。|  
+|<xref:System.Windows.Forms.ToolStripDropDown>|<xref:System.Windows.Forms.ToolStripDropDownButton> または上位レベルのメニュー項目をクリックしたときに表示される一覧から特定の項目を選択できるようにするコントロールを表します。|  
+|<xref:System.Windows.Forms.ToolStripDropDownItem>|クリック時にドロップダウン項目を表示する、<xref:System.Windows.Forms.ToolStripItem> から派生するコントロールの基本機能を提供します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripDropDown>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/menustrip-control-windows-forms.md b/docs/framework/winforms/controls/menustrip-control-windows-forms.md
new file mode 100644
index 00000000000..d4148fe8a4d
--- /dev/null
+++ b/docs/framework/winforms/controls/menustrip-control-windows-forms.md
@@ -0,0 +1,93 @@
+---
+title: "MenuStrip コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー"
+  - "MenuStrip コントロール [Windows フォーム]"
+ms.assetid: e361bf98-eed8-4ed3-9dfb-5a2e865e3ce6
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# MenuStrip コントロール (Windows フォーム)
+このコントロールは、アプリケーション コマンドをグループ化して簡単にアクセスできるようにします。  
+  
+## このセクションの内容  
+ [MenuStrip コントロールの概要](../../../../docs/framework/winforms/controls/menustrip-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : ToolStripMenuItems に拡張機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-enhancements-to-toolstripmenuitems.md)  
+ メニューとメニュー コマンドにチェック マーク、イメージ、ショートカット キー、アクセス キー、および区分線を追加する方法について説明します。  
+  
+ [方法 : MenuStrip を MDI 親ウィンドウに追加する](../../../../docs/framework/winforms/controls/how-to-append-a-menustrip-to-an-mdi-parent-window-windows-forms.md)  
+ 複数のプロパティを設定して、マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) 子メニューを MDI 親メニューに追加する方法について説明します。  
+  
+ [方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md)  
+ 親フォームの \[ウィンドウ\] メニューに、すべてのアクティブな子フォームの一覧を作成する方法について説明します。  
+  
+ [方法 : ToolStripMenuItems を無効にする](../../../../docs/framework/winforms/controls/how-to-disable-toolstripmenuitems.md)  
+ メニュー全体と個々のメニュー コマンドの両方を無効にする方法について説明します。  
+  
+ [方法 : ToolStripMenuItems を非表示にする](../../../../docs/framework/winforms/controls/how-to-hide-toolstripmenuitems.md)  
+ メニュー全体と個々のメニュー コマンドの両方を非表示にする方法について説明します。  
+  
+ [方法 : MDI ドロップダウン メニューに MenuStrip を挿入する](../../../../docs/framework/winforms/controls/how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md)  
+ 複数のプロパティを設定して、MDI 子メニューのメニュー項目のグループを MDI 親メニューのドロップダウン部分に挿入する方法について説明します。  
+  
+ [方法 : ToolStripMenuItem を MDI ドロップダウン メニューから削除する](../../../../docs/framework/winforms/controls/how-to-remove-a-toolstripmenuitem-from-an-mdi-drop-down-menu-windows-forms.md)  
+ 複数のプロパティを設定して、MDI 親メニューのドロップダウン部分からメニュー項目を削除する方法について説明します。  
+  
+ [方法 : MenuStrip のチェックの余白とイメージの余白を設定する](../../../../docs/framework/winforms/controls/how-to-configure-menustrip-check-margins-and-image-margins.md)  
+ チェックとイメージの余白のプロパティをさまざまに設定することで <xref:System.Windows.Forms.MenuStrip> をカスタマイズする方法について説明します。  
+  
+ [方法 : フォームに標準メニュー項目を追加する](../../../../docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md)  
+ <xref:System.Windows.Forms.MenuStrip> コントロールを使用して標準的なメニューのあるフォームを作成する方法について説明します。  
+  
+ [方法 : MenuStrip にオプション ボタンを表示する](../../../../docs/framework/winforms/controls/how-to-display-option-buttons-in-a-menustrip-windows-forms.md)  
+ オプション ボタン \(またはラジオ ボタン\) の動作を <xref:System.Windows.Forms.ToolStripMenuItem> に実装する方法について説明します。  
+  
+ [Windows フォームの MenuStrip コントロールへのメニュー項目のマージ](../../../../docs/framework/winforms/controls/merging-menu-items-in-the-windows-forms-menustrip-control.md)  
+ メニューのマージに関する一般的な概念とメソッドについて説明します。  
+  
+ [方法 : MDI アプリケーションでメニューの自動マージを設定する](../../../../docs/framework/winforms/controls/how-to-set-up-automatic-menu-merging-for-mdi-applications.md)  
+ 実行時にメニュー項目を自動的にマージする方法について説明します。  
+  
+-   [MenuStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233625%20\(v=vs.110\))  
+  
+-   [方法: ToolStripMenuItems をコピーする](http://msdn.microsoft.com/library/ms171653%20\(v=vs.110\))  
+  
+-   [方法: デザイナーを使用して ToolStripMenuItems を非表示にする](http://msdn.microsoft.com/library/ms171658%20\(v=vs.110\))  
+  
+-   [方法: デザイナーを使用して ToolStripMenuItems を無効にする](http://msdn.microsoft.com/library/ms171656%20\(v=vs.110\))  
+  
+-   [方法: ToolStripMenuItems を移動する](http://msdn.microsoft.com/library/ms171660%20\(v=vs.110\))  
+  
+-   [チュートリアル : 標準メニュー項目をフォームに用意する](http://msdn.microsoft.com/library/ms233662\(v=vs.110\))  
+  
+-   [\[MenuStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233645%20\(v=vs.110\))  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.MenuStrip>  
+ フォームにメニュー システムを提供する <xref:System.Windows.Forms.MenuStrip> クラスの機能について説明します。  
+  
+ <xref:System.Windows.Forms.ContextMenuStrip>  
+ ショートカット メニューを表す <xref:System.Windows.Forms.ContextMenuStrip> の機能について説明します  
+  
+ <xref:System.Windows.Forms.ToolStripMenuItem>  
+ <xref:System.Windows.Forms.MenuStrip> または <xref:System.Windows.Forms.ContextMenuStrip> に表示される選択可能なオプションを表す <xref:System.Windows.Forms.ToolStripMenuItem> クラスの機能について説明します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/merging-menu-items-in-the-windows-forms-menustrip-control.md b/docs/framework/winforms/controls/merging-menu-items-in-the-windows-forms-menustrip-control.md
new file mode 100644
index 00000000000..77d7560ab29
--- /dev/null
+++ b/docs/framework/winforms/controls/merging-menu-items-in-the-windows-forms-menustrip-control.md
@@ -0,0 +1,70 @@
+---
+title: "Windows フォームの MenuStrip コントロールへのメニュー項目のマージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MenuStrip, マージ"
+  - "マージ, 一般的な概念"
+ms.assetid: 95e113ba-f362-4dda-8a76-6d95ddc45cee
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォームの MenuStrip コントロールへのメニュー項目のマージ
+マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) アプリケーションがある場合、子フォームのメニュー項目またはメニュー全体を親フォームのメニューにマージできます。  
+  
+ このトピックでは、MDI アプリケーションでメニュー項目のマージに関連する基本概念について説明します。  
+  
+## 一般的な概念  
+ マージ手順には、ターゲット コントロールとソース コントロールが関係します。  
+  
+-   ターゲットは、メニュー項目をマージするメイン フォームまたは MDI 親フォームの <xref:System.Windows.Forms.MenuStrip> コントロールです。  
+  
+-   ソースは、ターゲット メニューにマージするメニュー項目が含まれる MDI 子フォームの <xref:System.Windows.Forms.MenuStrip> コントロールです。  
+  
+ <xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A> プロパティは、作成するドロップダウン リストのメニュー項目を、現在の MDI 親フォームに対する MDI 子フォームのタイトルを使用して識別します。  たとえば、**\[ウィンドウ\]** メニューで現在開いている MDI の子フォームを列挙します。  
+  
+ <xref:System.Windows.Forms.ToolStripMenuItem.IsMdiWindowListEntry%2A> プロパティは、MDI 子フォームの <xref:System.Windows.Forms.MenuStrip> のどのメニュー項目を表示するかを指定します。  
+  
+ メニュー項目のマージは手動または自動で行うことができます。  どちらの方法でもメニュー項目は同様にマージされますが、マージをアクティブにする方法は異なります。詳細については、このトピックで後述する「手動マージ」と「自動マージ」を参照してください。  手動マージと自動マージのどちらでも、個々のマージ処理は次のマージ処理に影響します。  
+  
+ <xref:System.Windows.Forms.MenuStrip> のマージによって、ある <xref:System.Windows.Forms.ToolStrip> のメニュー項目を閉じずに他のメニュー項目に移動します。<xref:System.Windows.Forms.MainMenu> の場合と同様です。  
+  
+## MergeAction の値  
+ <xref:System.Windows.Forms.MergeAction> プロパティを使用してソース <xref:System.Windows.Forms.MenuStrip> のメニュー項目にマージ処理を設定します。  
+  
+ 次の表で、使用できるマージ処理の意味と一般的な使用法を説明します。  
+  
+|MergeAction の値|Description|一般的な用途|  
+|--------------------|-----------------|------------|  
+|<xref:System.Windows.Forms.MergeAction>|\(既定\) ターゲット項目のコレクションの末尾にソース項目を追加します。|プログラムの一部がアクティブな場合、メニューの末尾にメニュー項目を追加します。|  
+|<xref:System.Windows.Forms.MergeAction>|ターゲット項目のコレクションのうち、ソース項目に設定された <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> プロパティに相当する場所にソース項目を追加します。|プログラムの一部がアクティブな場合、メニューの中間または先頭にメニュー項目を追加します。<br /><br /> <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> 値がどちらのメニュー項目でも同じ場合、逆順で追加します。  元の順序を維持するには、<xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> を適切に設定します。|  
+|<xref:System.Windows.Forms.MergeAction>|一致するテキストを検索します。一致するテキストが見つからない場合は <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> 値を使用します。次に、この一致するターゲット メニュー項目をソース メニュー項目で置換します。|ターゲット メニュー項目を、名前は同じで何かが異なるソース メニュー項目で置換します。|  
+|<xref:System.Windows.Forms.MergeAction>|一致するテキストを検索します。一致するテキストが見つからない場合は <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> 値を使用します。次に、ソースのすべてのドロップダウン項目をターゲットに追加します。|メニュー項目をサブメニューに挿入または追加したり、メニュー項目をサブメニューから削除したりするメニュー構造を構築します。  たとえば、MDI 子フォームのメニュー項目をメインの <xref:System.Windows.Forms.MenuStrip> の **\[名前を付けて保存\]** メニューに追加できます。<br /><br /> <xref:System.Windows.Forms.MergeAction> を使用すると、処理を実行しなくてもメニュー構造内を検索できます。  これは、以降の項目を評価する 1 つの方法です。|  
+|<xref:System.Windows.Forms.MergeAction>|一致するテキストを検索します。一致するテキストが見つからない場合は <xref:System.Windows.Forms.ToolStripItem.MergeIndex%2A> 値を使用します。次に、ターゲットから項目を削除します。|ターゲットの <xref:System.Windows.Forms.MenuStrip> からメニュー項目を削除します。|  
+  
+## 手動マージ  
+ <xref:System.Windows.Forms.MenuStrip> コントロールのみが自動マージに参加します。  <xref:System.Windows.Forms.ToolStrip> や <xref:System.Windows.Forms.StatusStrip> など、他のコントロールの項目を結合するには、必要に応じて <xref:System.Windows.Forms.ToolStripManager.Merge%2A> メソッドと <xref:System.Windows.Forms.ToolStripManager.RevertMerge%2A> メソッドをコードで呼び出して、手動でマージする必要があります。  
+  
+## 自動マージ  
+ ソース フォームをアクティブにすることで、MDI アプリケーションの自動マージを使用できます。  MDI アプリケーションの <xref:System.Windows.Forms.MenuStrip> を使用するには、<xref:System.Windows.Forms.Form.MainMenuStrip%2A> プロパティをターゲットの <xref:System.Windows.Forms.MenuStrip> に設定します。これは、ソースの <xref:System.Windows.Forms.MenuStrip> で実行するマージ処理が、ターゲットの <xref:System.Windows.Forms.MenuStrip> に反映されるようにするためです。  
+  
+ MDI ソースで <xref:System.Windows.Forms.MenuStrip> をアクティブにすることで、自動マージをトリガーできます。  アクティブになると、ソース <xref:System.Windows.Forms.MenuStrip> は MDI のターゲットにマージされます。  新しいフォームがアクティブになると、前のフォームではマージが元の状態に戻り、新しいフォームでマージがトリガーされます。  この動作は、必要に応じて各 <xref:System.Windows.Forms.ToolStripItem> で <xref:System.Windows.Forms.ToolStripItem.MergeAction%2A> プロパティを設定する方法、および各 <xref:System.Windows.Forms.MenuStrip> で <xref:System.Windows.Forms.ToolStrip.AllowMerge%2A> プロパティを設定する方法で制御できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripManager>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)   
+ [方法 : MenuStrip を使用して MDI ウィンドウの一覧を作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-window-list-with-menustrip-windows-forms.md)   
+ [方法 : MDI アプリケーションでメニューの自動マージを設定する](../../../../docs/framework/winforms/controls/how-to-set-up-automatic-menu-merging-for-mdi-applications.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/method-implementation-in-custom-controls.md b/docs/framework/winforms/controls/method-implementation-in-custom-controls.md
new file mode 100644
index 00000000000..bb91b5284d0
--- /dev/null
+++ b/docs/framework/winforms/controls/method-implementation-in-custom-controls.md
@@ -0,0 +1,86 @@
+---
+title: "カスタム コントロールへのメソッドの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メソッドの実装のユーザー コントロール [Windows フォーム]"
+  - "メソッドのオーバー ロードのカスタム コントロール [Windows フォーム]"
+  - "カスタム コントロール [Windows フォーム] メソッドの実装"
+  - "メソッド [Windows フォーム]"
+  - "カスタム コントロールのメソッド [Windows フォーム]"
+ms.assetid: 35d14fca-4bb4-4a27-8211-1f7a98ea27de
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# カスタム コントロールへのメソッドの実装
+コントロールにメソッドを実装する方法は、他のコンポーネントにメソッドが実装する場合と同じです。  
+  
+ Visual Basic では、値を返す必要のあるメソッドは `Public Function` として実装されます。 値が返されない場合は、`Public Sub` として実装されます。 メソッドは次の構文で宣言します。  
+  
+```vb  
+Public Function ConvertMatterToEnergy(Matter as Integer) As Integer  
+   ' Conversion code goes here.  
+End Function  
+```  
+  
+ 関数は値を返すため、整数、文字列、オブジェクトなど、戻り値の型を指定する必要があります。 `Function` プロシージャや `Sub` プロシージャが引数をとる場合は、引数も指定する必要があります。  
+  
+ Visual Basic とは異なり、C# では関数とプロシージャが区別されません。 メソッドは値を返すか、または `void` を返します。 C# のパブリック メソッドを宣言する構文は次のとおりです。  
+  
+```csharp  
+public int ConvertMatterToEnergy(int matter)  
+{  
+   // Conversion code goes here.  
+}  
+```  
+  
+ メソッドを宣言する際、可能な限り、メソッドのすべての引数を明示的なデータ型として宣言します。 オブジェクト参照を使用する引数は、特定のクラス型として宣言される必要があります (例: `As Widget` ではなく、`As Object`)。 Visual Basic では、既定の設定 `Option Strict` によって自動的にこの規則が適用されます。  
+  
+ 型付き引数を使用することにより、開発者によるエラーの多くを、実行時ではなく、コンパイラによって検出できます。 コンパイラは常に多くのエラーを検出するのに対し、ランタイム テストは、テスト スイートと同程度の精度しかありません。  
+  
+## <a name="overloaded-methods"></a>オーバーロードされたメソッド  
+ コントロールのユーザーが、メソッドにさまざまなパラメーターの組み合わせを指定できるようにするには、明示的なデータ型を使用して、メソッドのオーバーロードを複数提供します。 テスト時にエラーが検出されない場合があるため、任意のデータ型を含めることのできる `As Object` として宣言するパラメーターは作成しないでください。  
+  
+> [!NOTE]
+>  共通言語ランタイムの汎用データ型は、`Object` ではなく、`Variant` です。 `Variant` は、言語から削除されました。  
+  
+ たとえば、`Spin` という仮想のコントロールに `Widget` メソッドがあり、スピンの方向と速度を直接指定するか、角運動量を吸収する他の `Widget` オブジェクトを指定できます。  
+  
+```vb  
+Overloads Public Sub Spin( _  
+   ByVal SpinDirection As SpinDirectionsEnum, _  
+   ByVal RevolutionsPerSecond As Double)  
+   ' Implementation code here.  
+End Sub  
+Overloads Public Sub Spin(ByVal Driver As Widget) _  
+   ' Implementation code here.  
+End Sub  
+```  
+  
+```csharp  
+public void Spin(SpinDirectionsEnum spinDirection, double revolutionsPerSecond)  
+{  
+   // Implementation code here.  
+}  
+  
+public void Spin(Widget driver)  
+{  
+   // Implementation code here.  
+}  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [イベント](../../../../docs/standard/events/index.md)   
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/monthcalendar-control-overview-windows-forms.md b/docs/framework/winforms/controls/monthcalendar-control-overview-windows-forms.md
new file mode 100644
index 00000000000..07e22c09a65
--- /dev/null
+++ b/docs/framework/winforms/controls/monthcalendar-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "MonthCalendar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "MonthCalendar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "予定表コントロール, Windows フォーム"
+  - "予定表, Windows フォーム コントロール"
+  - "MonthCalendar コントロール [Windows フォーム], 設定 (週の最初の曜日を)"
+ms.assetid: 788c5325-b721-44ec-95bf-9b680ba0f6a2
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# MonthCalendar コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.MonthCalendar> コントロールを使用すると、わかりやすいグラフィカル インターフェイスを使用して、日付情報を表示および設定できます。  このコントロールはカレンダー \(曜日の下に当月の日付が配列されたグリッド\) を表示します。日付の選択範囲が強調表示されます。  月表示のキャプションの両側にある矢印ボタンをクリックして、ほかの月を選択できます。  このコントロールでは、類似した <xref:System.Windows.Forms.DateTimePicker> コントロールとは異なり、複数の日付を選択できます。  <xref:System.Windows.Forms.DateTimePicker> コントロールの詳細については、「[DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)」を参照してください。  
+  
+## MonthCalendar コントロールの設定  
+ <xref:System.Windows.Forms.MonthCalendar> コントロールの外観には、さまざまな設定方法があります。  既定では、当日の日付が丸で囲まれて表示され、グリッドの下部にも表示されます。  この機能は、<xref:System.Windows.Forms.MonthCalendar.ShowToday%2A> プロパティと <xref:System.Windows.Forms.MonthCalendar.ShowTodayCircle%2A> プロパティに `false` を設定することで変更できます。  <xref:System.Windows.Forms.MonthCalendar.ShowWeekNumbers%2A> プロパティに `true` を設定して、カレンダーに週番号を表示することもできます。  <xref:System.Windows.Forms.MonthCalendar.CalendarDimensions%2A> プロパティの設定によって、複数の月を縦や横に並べて表示することもできます。  既定では週の始まりが日曜日になっていますが、<xref:System.Windows.Forms.MonthCalendar.FirstDayOfWeek%2A> プロパティで任意の曜日に変更できます。  
+  
+ 特定の日付を太字で表示することもできます。<xref:System.DateTime> オブジェクトを <xref:System.Windows.Forms.MonthCalendar.BoldedDates%2A> プロパティに追加すると、特定の日付が一度だけ太字で表示されます。<xref:System.Windows.Forms.MonthCalendar.AnnuallyBoldedDates%2A> プロパティに追加すると、毎年太字で表示されます。<xref:System.Windows.Forms.MonthCalendar.MonthlyBoldedDates%2A> プロパティに追加すると、毎月太字で表示されます。  詳細については、「[方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する](../../../../docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.MonthCalendar> コントロールの主要なプロパティは、<xref:System.Windows.Forms.MonthCalendar.SelectionRange%2A> プロパティです。このプロパティは、コントロールで選択された日付の範囲を表します。  <xref:System.Windows.Forms.MonthCalendar.SelectionRange%2A> には、<xref:System.Windows.Forms.MonthCalendar.MaxSelectionCount%2A> プロパティに設定された選択可能な日付の数を超える値は指定できません。  ユーザーが選択できる最も古い日付と最も新しい日付は、<xref:System.Windows.Forms.MonthCalendar.MaxDate%2A> プロパティと <xref:System.Windows.Forms.MonthCalendar.MinDate%2A> プロパティで決定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MonthCalendar>   
+ [MonthCalendar コントロール](../../../../docs/framework/winforms/controls/monthcalendar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/monthcalendar-control-windows-forms.md b/docs/framework/winforms/controls/monthcalendar-control-windows-forms.md
new file mode 100644
index 00000000000..3132d50771d
--- /dev/null
+++ b/docs/framework/winforms/controls/monthcalendar-control-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "MonthCalendar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "予定表コントロール"
+  - "予定表"
+  - "日付, コントロール"
+  - "MonthCalendar コントロール [Windows フォーム]"
+ms.assetid: 051c6518-e0ca-426b-855c-f9bf70972970
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# MonthCalendar コントロール (Windows フォーム)
+Windows フォームの `MonthCalendar` コントロールを使用すると、わかりやすいグラフィカル インターフェイスを使用して、日付情報を表示および設定できます。  このコントロールには、曜日の下に月の日付が配列されたグリッドがあります。  月表示のキャプションの両側にある矢印ボタンをクリックして、ほかの月を選択できます。  似た機能を持つ <xref:System.Windows.Forms.DateTimePicker> コントロールとは異なり、このコントロールでは日付の範囲を選択できます。ただし、<xref:System.Windows.Forms.DateTimePicker> コントロールでは日付のほかに時刻も設定できます。  
+  
+## このセクションの内容  
+ [MonthCalendar コントロールの概要](../../../../docs/framework/winforms/controls/monthcalendar-control-overview-windows-forms.md)  
+ `MonthCalendar` コントロールの全般的な概念を説明します。このコントロールにより、ユーザーはアプリケーションの日付情報を表示したり設定したりできます。  
+  
+ [方法 : Windows フォームの MonthCalendar コントロールの外観を変更する](../../../../docs/framework/winforms/controls/how-to-change-monthcalendar-control-appearance.md)  
+ `MonthCalendar` コントロールの表示形式をカスタマイズする方法について説明します。  
+  
+ [方法 : Windows フォームの MonthCalendar コントロールにおいて複数の月を表示する](../../../../docs/framework/winforms/controls/display-more-than-one-month-wf-monthcalendar-control.md)  
+ 同時に 2 か月以上を表示させるように `MonthCalendar` コントロールを設定する方法について説明します。  
+  
+ [方法 : Windows フォームの MonthCalendar コントロールを使用して特定の日付を太字で表示する](../../../../docs/framework/winforms/controls/display-specific-days-in-bold-with-wf-monthcalendar-control.md)  
+ 特定の日付を太字で表示させる方法を説明します。  
+  
+ [方法 : Windows フォームの MonthCalendar コントロールで日付の範囲を選択する](../../../../docs/framework/winforms/controls/how-to-select-a-range-of-dates-in-the-windows-forms-monthcalendar-control.md)  
+ `MonthCalendar` コントロールから特定範囲の日付をプログラムで選択する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.MonthCalendar>  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [DateTimePicker コントロール](../../../../docs/framework/winforms/controls/datetimepicker-control-windows-forms.md)  
+ <xref:System.Windows.Forms.MonthCalendar> と同様の機能を持つコントロールです。<xref:System.Windows.Forms.DateTimePicker> コントロールでは時刻を選択できますが、日付の範囲指定はできません。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/move-through-a-dataset-with-wf-bindingnavigator-control.md b/docs/framework/winforms/controls/move-through-a-dataset-with-wf-bindingnavigator-control.md
new file mode 100644
index 00000000000..ba7dc667ab9
--- /dev/null
+++ b/docs/framework/winforms/controls/move-through-a-dataset-with-wf-bindingnavigator-control.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : Windows フォームの BindingNavigator コントロールを使用して DataSet を移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingNavigator コントロール [Windows フォーム], 移動 (データセット内を)"
+  - "データセット [Windows フォーム], 移動"
+  - "例 [Windows フォーム], BindingNavigator コントロール"
+ms.assetid: 146d97be-3d97-400e-accb-860bbf47729d
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームの BindingNavigator コントロールを使用して DataSet を移動する
+データ ドリブン アプリケーションを作成するときに、ユーザーにデータのコレクションを表示する必要がある場合があります。  <xref:System.Windows.Forms.BindingNavigator> コントロールは、<xref:System.Windows.Forms.BindingSource> コンポーネントと組み合わせて、コレクションを移動して項目を順番に表示する、便利で拡張可能なソリューションを提供します。  
+  
+## 使用例  
+ <xref:System.Windows.Forms.BindingNavigator> コントロールを使用してデータ間を移動する方法を、次のコード例に示します。  セットは <xref:System.Data.DataView> に含まれ、<xref:System.Windows.Forms.BindingSource> コンポーネントを持つ <xref:System.Windows.Forms.TextBox> コントロールにバインドされます。  
+  
+> [!NOTE]
+>  接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.DataNavigator#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataNavigator/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataNavigator#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataNavigator/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、System.Windows.Forms、および System.Xml アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/multithreading-in-windows-forms-controls.md b/docs/framework/winforms/controls/multithreading-in-windows-forms-controls.md
new file mode 100644
index 00000000000..cdca3f126b9
--- /dev/null
+++ b/docs/framework/winforms/controls/multithreading-in-windows-forms-controls.md
@@ -0,0 +1,53 @@
+---
+title: "Windows フォーム コントロールのマルチスレッド処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BackgroundWorker コンポーネント"
+  - "BeginInvoke メソッド"
+  - "スレッド処理 [Windows フォーム], コントロール"
+ms.assetid: c311d652-0f26-45fa-bdcc-b1615d73ce4e
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Windows フォーム コントロールのマルチスレッド処理
+多くのアプリケーションでは、時間がかかる操作を別スレッドで実行することにより、ユーザー インターフェイス \(UI\) の反応を良くすることができます。  Windows フォーム コントロールでマルチスレッド処理を行うための手段はいくつか用意されています。たとえば、<xref:System.Threading> 名前空間、<xref:System.Windows.Forms.Control.BeginInvoke%2A?displayProperty=fullName> メソッド、および `BackgroundWorker` コンポーネントです。  
+  
+> [!NOTE]
+>  `BackgroundWorker` コンポーネントは、<xref:System.Threading> 名前空間および <xref:System.Windows.Forms.Control.BeginInvoke%2A?displayProperty=fullName> メソッドに代わるもので、また機能が追加されています。ただし、この名前空間とメソッドは、下位互換性を保つ目的、および必要に応じて将来使用する目的から、そのまま残されています。  詳細については、「[BackgroundWorker コンポーネントの概要](../../../../docs/framework/winforms/controls/backgroundworker-component-overview.md)」を参照してください。  
+  
+## このセクションの内容  
+ [方法 : Windows フォーム コントロールのスレッド セーフな呼び出しを行う](../../../../docs/framework/winforms/controls/how-to-make-thread-safe-calls-to-windows-forms-controls.md)  
+ Windows フォーム コントロールのスレッド セーフな呼び出しを行う方法を示します。  
+  
+ [方法 : バックグラウンド スレッドを使用してファイルを検索する](../../../../docs/framework/winforms/controls/how-to-use-a-background-thread-to-search-for-files.md)  
+ <xref:System.Threading> 名前空間および <xref:System.Windows.Forms.Control.BeginInvoke%2A> メソッドを使用して、ファイルを非同期で検索する方法を示します。  
+  
+## 関連項目  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ 非同期の操作用のワーカー スレッドをカプセル化するコンポーネントについて説明されています。  
+  
+ <xref:System.Media.SoundPlayer.LoadAsync%2A>  
+ サウンドを非同期で読み込む方法について説明されています。  
+  
+ <xref:System.Windows.Forms.PictureBox.LoadAsync%2A>  
+ イメージを非同期で読み込む方法について説明されています。  
+  
+## 関連項目  
+ [方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)  
+ 時間がかかる操作を <xref:System.ComponentModel.BackgroundWorker> コンポーネントで実行する方法を示します。  
+  
+ [BackgroundWorker コンポーネントの概要](../../../../docs/framework/winforms/controls/backgroundworker-component-overview.md)  
+ <xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用して非同期の操作を実行する方法を説明するトピックを示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md b/docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md
new file mode 100644
index 00000000000..e37300beba6
--- /dev/null
+++ b/docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "NotifyIcon コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "NotifyIcon"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "NotifyIcon コンポーネント, NotifyIcon コンポーネントの概要"
+  - "システム トレイのアイコン, システム トレイのアイコンについて"
+  - "システム トレイのアイコン, 使用 (Windows フォームで)"
+ms.assetid: 5b9189fa-d4ae-41a6-9b97-eb1f44bb1a69
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# NotifyIcon コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.NotifyIcon> コンポーネントは、通常、バックグラウンドで動作し、ユーザー インターフェイスに長時間表示されないプロセスのアイコンを表示する場合に使用されます。  たとえば、タスク バーの状態通知領域のアイコンをクリックしてアクセス可能なウイルス対策プログラムなどです。  
+  
+## NotifyIcons のキー プロパティ  
+ 各 <xref:System.Windows.Forms.NotifyIcon> コンポーネントは、ステータス領域に 1 つのアイコンを表示します。  3 つのバック グラウンド プロセスがあり、それぞれのアイコンを表示する必要がある場合は、3 つの <xref:System.Windows.Forms.NotifyIcon> コンポーネントをフォームに追加する必要があります。  <xref:System.Windows.Forms.NotifyIcon> コンポーネントのキー プロパティは、<xref:System.Windows.Forms.NotifyIcon.Icon%2A> および <xref:System.Windows.Forms.NotifyIcon.Visible%2A> です。  <xref:System.Windows.Forms.NotifyIcon.Icon%2A> プロパティは、ステータス領域に表示されるアイコンを設定します。  アイコンを表示するために、<xref:System.Windows.Forms.NotifyIcon.Visible%2A> プロパティを `true` に設定する必要があります。  
+  
+ [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] を使用している場合は、<xref:System.Windows.Forms.NotifyIcon> コントロールによって使用できる標準のイメージの大規模なライブラリにアクセスできます。  
+  
+## NotifyIcons オプション  
+ バルーン ヒント、ショートカット メニュー、およびツールヒントを <xref:System.Windows.Forms.NotifyIcon> に関連付けて、ユーザーを支援できます。  
+  
+ <xref:System.Windows.Forms.NotifyIcon.ShowBalloonTip%2A> メソッドを呼び出して、バルーンヒントを表示する期間を指定することで、<xref:System.Windows.Forms.NotifyIcon> のバルーン ヒントを表示できます。  テキスト、アイコン、およびとバルーン ヒントのタイトルを、それぞれ <xref:System.Windows.Forms.NotifyIcon.BalloonTipText%2A>、<xref:System.Windows.Forms.NotifyIcon.BalloonTipIcon%2A>、および <xref:System.Windows.Forms.NotifyIcon.BalloonTipTitle%2A> を使用して指定できます。  <xref:System.Windows.Forms.NotifyIcon> コンポーネントには、ツールヒントとショートカット メニューも関連付けることができます。  詳細については、「[ToolTip コンポーネントの概要](../../../../docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md)」および「[ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.NotifyIcon>   
+ [NotifyIcon コンポーネント](../../../../docs/framework/winforms/controls/notifyicon-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/notifyicon-component-windows-forms.md b/docs/framework/winforms/controls/notifyicon-component-windows-forms.md
new file mode 100644
index 00000000000..1e4b5a85db1
--- /dev/null
+++ b/docs/framework/winforms/controls/notifyicon-component-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "NotifyIcon コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション アイコン, バックグラウンド処理"
+  - "バックグラウンド プログラムのアイコン"
+  - "コンテキスト メニュー, バックグラウンド プロセスの"
+  - "NotifyIcon コンポーネント"
+  - "ステータス トレイのアイコン"
+  - "システム トレイのアイコン"
+  - "SysTray のアイコン"
+  - "ユーザー インターフェイス, バックグラウンド プロセスの"
+ms.assetid: 20312268-1d67-494a-8601-5c43b7f1b513
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# NotifyIcon コンポーネント (Windows フォーム)
+Windows フォームの `NotifyIcon` コンポーネントは、他にユーザー インターフェイスを持たない、バックグラウンドで動作するプロセスのために、タスク バーの状態通知領域にアイコンを表示します。  例としては、タスクバーの状態通知領域にあるアイコンをクリックしてアクセスできるウイルス防止プログラムなどがあります。  
+  
+## このセクションの内容  
+ [NotifyIcon コンポーネントの概要](../../../../docs/framework/winforms/controls/notifyicon-component-overview-windows-forms.md)  
+ `NotifyIcon` コンポーネントの全般的な概念を説明します。このコンポーネントは、ユーザー インターフェイスを持たない、バックグラウンドで動作するプロセスのためにアイコンを表示します。  
+  
+ [方法 : Windows フォームの NotifyIcon コンポーネントによってタスクバーにアプリケーション アイコンを追加する](../../../../docs/framework/winforms/controls/app-icons-to-the-taskbar-with-wf-notifyicon.md)  
+ `NotifyIcon` コンポーネントで表示するアイコンを設定する手順を説明します。  
+  
+ [方法 : ショートカット メニューを Windows フォーム NotifyIcon コンポーネントに関連付ける](../../../../docs/framework/winforms/controls/how-to-associate-a-shortcut-menu-with-a-windows-forms-notifyicon-component.md)  
+ `NotifyIcon` コンポーネントにショートカット メニューを追加する手順を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.NotifyIcon>  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md b/docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md
new file mode 100644
index 00000000000..a7fdfe04385
--- /dev/null
+++ b/docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "NumericUpDown コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "NumericUpDown"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "数値のスピン ボタン コントロール, Windows フォーム"
+  - "NumericUpDown コントロール [Windows フォーム], NumericUpDown コントロールの概要"
+  - "スピン ボタン コントロール, Windows フォーム"
+ms.assetid: cff3cf30-4d46-4381-87df-37bfe83c71c5
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# NumericUpDown コントロールの概要 (Windows フォーム)
+<xref:System.Windows.Forms.NumericUpDown> コントロールの外観は、テキスト ボックスと、数値を変更するための矢印で構成されています。  このコントロールでは、固定の数値の選択肢のリストから 1 つの数値を表示および設定します。  ユーザーは、上向きおよび下向きの矢印ボタンをクリックするか、↑キーと↓キーを押すことで、数値を増加または減少できます。また、コントロールのテキスト ボックス部分に数字を直接入力することもできます。  ↑キーをクリックすると最大値を上限に数値が増加し、↓キーをクリックすると最小値を下限に数値が減少します。  
+  
+ このコントロールは多用途の機能を備えるため、音楽再生アプリケーションのボリューム コントロールを作成する場合などに便利です。  <xref:System.Windows.Forms.NumericUpDown> コントロールは、Windows の多くのコントロール パネル アプリケーションで使用されています。  
+  
+## 主要なプロパティおよびメソッド  
+ コントロールのテキスト ボックスに表示する数値は、16 進数などさまざまな形式を使用できます。  詳細については、「[方法 : Windows フォームの NumericUpDown コントロールの書式を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md)」を参照してください。  コントロールの主なプロパティは、<xref:System.Windows.Forms.NumericUpDown.Value%2A>、<xref:System.Windows.Forms.NumericUpDown.Maximum%2A> \(既定値は 100\)、<xref:System.Windows.Forms.NumericUpDown.Minimum%2A> \(既定値は 0\)、および <xref:System.Windows.Forms.NumericUpDown.Increment%2A> \(既定値は 1\) です。  <xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティには、コントロールで現在選択している値を設定します。  <xref:System.Windows.Forms.NumericUpDown.Increment%2A> プロパティには、上向きの矢印または下向きの矢印を 1 回クリックするごとに増加または減少される数値を設定します。  コントロールからフォーカスが移動するときに、直接入力した値が最小数値および最大数値と照合され、妥当性が検査されます。  <xref:System.Windows.Forms.NumericUpDown.Accelerations%2A> プロパティを設定すると、ユーザーが連続的に上向きまたは下向きの矢印を押したときに、コントロールの数値が変化する速度を上げることができます。  コントロールの主要なメソッドは、<xref:System.Windows.Forms.NumericUpDown.UpButton%2A> および <xref:System.Windows.Forms.NumericUpDown.DownButton%2A> です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.NumericUpDown>   
+ [NumericUpDown コントロール](../../../../docs/framework/winforms/controls/numericupdown-control-windows-forms.md)   
+ [方法 : Windows フォームの NumericUpDown コントロールの書式を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/numericupdown-control-windows-forms.md b/docs/framework/winforms/controls/numericupdown-control-windows-forms.md
new file mode 100644
index 00000000000..c9790a03a02
--- /dev/null
+++ b/docs/framework/winforms/controls/numericupdown-control-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "NumericUpDown コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "NumericUpDown コントロール [Windows フォーム]"
+  - "スピン ボタン コントロール"
+  - "スピン ボタン コントロール, アップダウン コントロール"
+  - "アップダウン コントロール"
+  - "アップダウン コントロール, スピン ボタン コントロール"
+  - "Windows フォーム コントロール, NumericUpDown コントロール"
+ms.assetid: 32b0c20d-4f37-4aea-873d-faded741d2db
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# NumericUpDown コントロール (Windows フォーム)
+Windows フォームの `NumericUpDown` コントロールの外観は、テキスト ボックスと、数値を変更するための 2 つの矢印で構成されています。  このコントロールでは、選択肢のリストから 1 つの数値を表示したり設定したりします。  ユーザーは、上下矢印ボタンをクリックするか、方向キーを押すことで、数値を増加または減少できます。また、数字を直接入力することもできます。  上方向キーをクリックすると最大値を上限に値が増加し、下方向キーをクリックすると最小値を下限に値が減少します。  このコントロールは、ミュージック プレーヤーのボリューム コントロールなどに使用すると便利です。  **NumericUpDown** コントロールは、Windows コントロール パネルのいくつかのアプリケーションで使われています。  
+  
+## このセクションの内容  
+ [NumericUpDown コントロールの概要](../../../../docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md)  
+ `NumericUpDown` コントロールの全般的な概念を説明します。このコントロールは、ユーザーが参照して選択できる数値の一覧を表示します。  
+  
+ [方法 : Windows フォームの NumericUpDown コントロールを使用して数値を設定および取得する](../../../../docs/framework/winforms/controls/set-and-return-numeric-values-with-wf-numericupdown-control.md)  
+ コントロールの値をテストする方法について説明します。  
+  
+ [方法 : Windows フォームの NumericUpDown コントロールの書式を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-format-for-the-windows-forms-numericupdown-control.md)  
+ コントロールに値をどのように表示するかを設定する方法について説明します。  
+  
+## 関連項目  
+ [NumericUpDown クラス](frlrfSystemWindowsFormsNumericUpDownClassTopic)  
+ <xref:System.Windows.Forms.NumericUpDown> クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [DomainUpDown コントロール](../../../../docs/framework/winforms/controls/domainupdown-control-windows-forms.md)  
+ <xref:System.Windows.Forms.NumericUpDown> に似た <xref:System.Windows.Forms.DomainUpDown> コントロールについて説明します。ただし、このコントロールは数値の代わりに文字列を表示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..664e42179ce
--- /dev/null
+++ b/docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "OpenFileDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "OpenFileDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[ファイルを開く] ダイアログ ボックス, 表示 (Windows フォームで)"
+  - "OpenFileDialog コンポーネント, OpenFileDialog の概要"
+ms.assetid: cd717300-46b6-4f82-8207-b218fa7fa407
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# OpenFileDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.OpenFileDialog> コンポーネントは、定義済みのダイアログ ボックスです。  Windows オペレーティング システムの **\[ファイルを開く\]** ダイアログ ボックスと同じダイアログ ボックスです。  このコンポーネントは、<xref:System.Windows.Forms.CommonDialog> クラスを継承しています。  
+  
+## このコンポーネントの使用  
+ このコンポーネントは、独自のダイアログ ボックスを使用せずにファイル選択を行うための簡易ソリューションとして、Windows ベースのアプリケーション内で使用できます。  Windows の標準のダイアログ ボックスを使用して、一般的な基本機能を持つアプリケーションを作成できます。  ただし、<xref:System.Windows.Forms.OpenFileDialog> コンポーネントを使用する場合は、独自のファイル オープン ロジックを記述する必要があります。  
+  
+ <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用して、実行時にダイアログを表示します。  <xref:System.Windows.Forms.OpenFileDialog.Multiselect%2A> プロパティを使用すると、複数のファイルを選択して開くことができます。  また、<xref:System.Windows.Forms.OpenFileDialog.ShowReadOnly%2A> プロパティを使用すると、読み取り専用で開くためのチェック ボックスをダイアログ ボックスに表示するかどうかを指定できます。  <xref:System.Windows.Forms.OpenFileDialog.ReadOnlyChecked%2A> プロパティは、読み取り専用チェック ボックスがオンかオフかを示します。  <xref:System.Windows.Forms.FileDialog.Filter%2A> プロパティは、現在のファイル名フィルター文字列を設定します。この文字列で、ダイアログ ボックスの "ファイルの種類" で表示される選択肢を設定します。  
+  
+ フォームに登録すると、<xref:System.Windows.Forms.OpenFileDialog> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.OpenFileDialog>   
+ [OpenFileDialog コンポーネント](../../../../docs/framework/winforms/controls/openfiledialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/openfiledialog-component-windows-forms.md b/docs/framework/winforms/controls/openfiledialog-component-windows-forms.md
new file mode 100644
index 00000000000..d7d014538bd
--- /dev/null
+++ b/docs/framework/winforms/controls/openfiledialog-component-windows-forms.md
@@ -0,0 +1,46 @@
+---
+title: "OpenFileDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[ファイルを開く] ダイアログ ボックス"
+  - "OpenFileDialog コンポーネント"
+ms.assetid: d2efa832-a272-42ff-aa26-c4ac13ff59ba
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# OpenFileDialog コンポーネント (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.OpenFileDialog> コンポーネントは、事前構成済みのダイアログ ボックスです。  これは、Windows オペレーティング システムの \[**ファイルを開く**\] ダイアログ ボックスと同じです。  これは、<xref:System.Windows.Forms.CommonDialog> クラスを継承しています。  
+  
+## このセクションの内容  
+ [OpenFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/openfiledialog-component-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.OpenFileDialog> コンポーネントの全般的な概念を説明します。このコンポーネントにより、ユーザーがファイルを開くために使用する事前構成済みダイアログ ボックスを表示できます。  
+  
+ [方法 : OpenFileDialog コンポーネントを使用してファイルを開く](../../../../docs/framework/winforms/controls/how-to-open-files-using-the-openfiledialog-component.md)  
+ <xref:System.Windows.Forms.OpenFileDialog> コンポーネントのインスタンスを使用して実行時にファイルを開く方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.OpenFileDialog>  
+ <xref:System.Windows.Forms.OpenFileDialog> クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ ユーザーがアプリケーションまたはシステムと標準的な対話を実行できるようにする一連のコントロールおよびコンポーネントについて説明します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [Windows フォーム ダイアログ ボックスの重要コード](http://go.microsoft.com/fwlink/?LinkID=102575)  
+ Windows フォーム ダイアログ ボックスのコントロールとコンポーネント、基本的な機能を実行するために必要なコードについて説明します。  \(MSDN オンライン ライブラリの技術記事\)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/overriding-the-onpaint-method.md b/docs/framework/winforms/controls/overriding-the-onpaint-method.md
new file mode 100644
index 00000000000..89969bd2d4f
--- /dev/null
+++ b/docs/framework/winforms/controls/overriding-the-onpaint-method.md
@@ -0,0 +1,98 @@
+---
+title: "OnPaint メソッドのオーバーライド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "OnPaint メソッド, オーバーライド (Windows フォーム カスタム コントロール内の)"
+  - "Paint イベント, 処理 (Windows フォーム カスタム コントロール内の)"
+ms.assetid: e9ca2723-0107-4540-bb21-4f5ffb4a9906
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# OnPaint メソッドのオーバーライド
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で定義されているイベントをオーバーライドするための基本的な手順はすべてのイベントで同一です。次にこの手順を示します。  
+  
+#### 継承したイベントをオーバーライドするには  
+  
+1.  プロテクト メソッド `On`*EventName* をオーバーライドします。  
+  
+2.  オーバーライドされた `On`*EventName* メソッドから基本クラスの `On`*EventName* メソッドを呼び出します。その結果、登録デリゲートがイベントを受信します。  
+  
+ すべての Windows フォーム コントロールでは <xref:System.Windows.Forms.Control> から継承する <xref:System.Windows.Forms.Control.Paint> イベントをオーバーライドする必要があるため、<xref:System.Windows.Forms.Control.Paint> イベントについて詳しく説明します。  基本の <xref:System.Windows.Forms.Control> クラスは、派生するコントロールの描画方法については認識せず、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドでは描画ロジックを提供しません。  <xref:System.Windows.Forms.Control> の <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドは、<xref:System.Windows.Forms.Control.Paint> イベントを登録イベント レシーバーへディスパッチします。  
+  
+ [方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md) のサンプルで作業すると、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドのオーバーライド例を確認できます。  このサンプルの一部であるコード片を次に示します。  
+  
+```vb  
+Public Class FirstControl  
+   Inherits Control  
+  
+   Public Sub New()  
+   End Sub  
+  
+   Protected Overrides Sub OnPaint(e As PaintEventArgs)  
+      ' Call the OnPaint method of the base class.  
+      MyBase.OnPaint(e)  
+      ' Call methods of the System.Drawing.Graphics object.  
+      e.Graphics.DrawString(Text, Font, New SolidBrush(ForeColor), RectangleF.op_Implicit(ClientRectangle))  
+   End Sub  
+End Class   
+```  
+  
+```csharp  
+public class FirstControl : Control{  
+   public FirstControl() {}  
+   protected override void OnPaint(PaintEventArgs e) {  
+      // Call the OnPaint method of the base class.  
+      base.OnPaint(e);  
+      // Call methods of the System.Drawing.Graphics object.  
+      e.Graphics.DrawString(Text, Font, new SolidBrush(ForeColor), ClientRectangle);  
+   }   
+}   
+```  
+  
+ <xref:System.Windows.Forms.PaintEventArgs> クラスには、<xref:System.Windows.Forms.Control.Paint> イベントのデータが格納されます。  次のコードに示すように、**PaintEventArgs** クラスには 2 つのプロパティがあります。  
+  
+```vb  
+Public Class PaintEventArgs  
+   Inherits EventArgs  
+   ...  
+   Public ReadOnly Property ClipRectangle() As System.Drawing.Rectangle  
+      ...  
+   End Property  
+  
+   Public ReadOnly Property Graphics() As System.Drawing.Graphics  
+      ...  
+   End Property   
+   ...  
+End Class  
+```  
+  
+```csharp  
+public class PaintEventArgs : EventArgs {  
+...  
+    public System.Drawing.Rectangle ClipRectangle {}  
+    public System.Drawing.Graphics Graphics {}  
+...  
+}  
+```  
+  
+ <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> は、描画される四角形で、<xref:System.Windows.Forms.PaintEventArgs.Graphics%2A> プロパティは、<xref:System.Drawing.Graphics> を参照します。  <xref:System.Drawing?displayProperty=fullName> 名前空間のクラスは、新しい Windows グラフィック ライブラリである [!INCLUDE[ndptecgdiplus](../../../../includes/ndptecgdiplus-md.md)] の機能へのアクセスを提供するマネージ クラスです。  <xref:System.Drawing.Graphics> オブジェクトには、ポイント、文字列、線、曲線、楕円などのさまざまな形状を描画するメソッドがあります。  
+  
+ ビジュアル表示を変更する必要がある場合は、コントロールは常に <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを呼び出します。  呼び出された `OnPaint` メソッドは <xref:System.Windows.Forms.Control.Paint> イベントを発生させます。  
+  
+## 参照  
+ [イベント](../../../../docs/standard/events/index.md)   
+ [Windows フォーム コントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-a-windows-forms-control.md)   
+ [イベントの定義](../../../../docs/framework/winforms/controls/defining-an-event-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/overview-of-using-controls-in-windows-forms.md b/docs/framework/winforms/controls/overview-of-using-controls-in-windows-forms.md
new file mode 100644
index 00000000000..3feea68acda
--- /dev/null
+++ b/docs/framework/winforms/controls/overview-of-using-controls-in-windows-forms.md
@@ -0,0 +1,234 @@
+---
+title: "Windows フォームでのコントロールの使用方法の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム]"
+  - "カスタム コントロール [Windows フォーム]"
+  - "Windows フォーム, コントロール"
+ms.assetid: fddbe951-4485-459d-a5fd-665ea346dbc1
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォームでのコントロールの使用方法の概要
+このトピックでは、Windows フォーム アプリケーションの必須要素についての説明と Windows フォーム アプリケーションでコントロールを使用してイベントを処理する例を示します。  
+  
+## シンプルな Windows フォーム アプリケーション  
+ Windows フォーム アプリケーションには、次の要素が必ず含まれています。  
+  
+-   <xref:System.Windows.Forms.Form?displayProperty=fullName> から派生した 1 つ以上のクラス。  
+  
+-   `static` \(Visual Studio では `shared`\) の <xref:System.Windows.Forms.Application.Run%2A> メソッドを呼び出し、<xref:System.Windows.Forms.Form> インスタンスをそのメソッドに渡す、`Main` メソッド。  オペレーティング システムからアプリケーションへのメッセージを処理する <xref:System.Windows.Forms.Application.Run%2A> メソッド。  
+  
+ Windows フォーム アプリケーションの必須要素を記述したコード例を次に示します。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports System  
+Imports System.Windows.Forms  
+  
+Public Class MyForm  
+   Inherits Form  
+  
+   Public Sub New()  
+      Me.Text = "Hello World"  
+   End Sub 'New  
+  
+   <STAThread()> _  
+   Public Shared Sub Main()  
+      Dim aform As New MyForm()  
+      ' The Application.Run method processes messages from the operating system   
+      ' to your application. If you comment out the next line of code,   
+      ' your application will compile and execute, but because it is not in the  
+      ' message loop, it will exit after an instance of the form is created.  
+      Application.Run(aform)  
+   End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Windows.Forms;  
+  
+public class MyForm : Form {  
+  
+   public MyForm() {  
+      this.Text = "Hello World";  
+   }  
+   [STAThread]  
+   public static void Main(string[] args) {  
+     MyForm aform = new MyForm();  
+// The Application.Run method processes messages from the operating system   
+// to your application. If you comment out the next line of code,   
+// your application will compile and execute, but because it is not in the // message loop, it will exit after an instance of the form is created.  
+      Application.Run(aform);  
+   }  
+}  
+```  
+  
+## Windows フォーム アプリケーションでのコントロールの使用  
+ シンプルな Windows フォーム アプリケーションでコントロールを使用し、イベントを処理する過程を示すコード例を次に示します。  このコード例では、フォームに 3 つのボタンがあります。それぞれのボタンをクリックすると、背景色が変更されます。  
+  
+```vb  
+Option Explicit  
+Option Strict  
+  
+Imports System  
+Imports System.ComponentModel  
+Imports System.Windows.Forms  
+Imports System.Resources  
+Imports System.Drawing  
+  
+Public Class MyForm  
+   Inherits Form  
+   Private red As Button  
+   Private blue As Button  
+   Private green As Button  
+  
+   Public Sub New()  
+      InitializeComponent()  
+   End Sub  
+  
+   Protected Overloads Overrides Sub Dispose(disposing as Boolean)  
+      MyBase.Dispose(disposing)  
+   End Sub  
+  
+   ' InitializeComponent is a helper method for the constructor.   
+   ' It is included for consistency with code that is   
+   ' auto-generated by the Windows Forms designer in Visual Studio.   
+   Private Sub InitializeComponent()  
+  
+      ' Creates three buttons, sets their properties, and attaches  
+      ' an event handler to each button.  
+      red = New Button()  
+      red.Text = "Red"  
+      red.Location = New Point(100, 50)  
+      red.Size = New Size(50, 50)  
+      AddHandler red.Click, AddressOf button_Click  
+      Controls.Add(red)  
+  
+      blue = New Button()  
+      blue.Text = "Blue"  
+      blue.Location = New Point(100, 100)  
+      blue.Size = New Size(50, 50)  
+      AddHandler blue.Click, AddressOf button_Click  
+      Controls.Add(blue)  
+  
+      green = New Button()  
+      green.Text = "Green"  
+      green.Location = New Point(100, 150)  
+      green.Size = New Size(50, 50)  
+      AddHandler green.Click, AddressOf button_Click  
+      Controls.Add(green)  
+   End Sub  
+  
+   ' Event handler.  
+   Private Sub button_Click(sender As Object, e As EventArgs)  
+      If sender Is red Then  
+         Me.BackColor = Color.Red  
+      Else  
+         If sender Is blue Then  
+            Me.BackColor = Color.Blue  
+         Else  
+            Me.BackColor = Color.Green  
+         End If  
+      End If   
+   End Sub  
+  
+   ' The STAThreadAttribute informs the common language runtime that  
+   ' Windows Forms uses the single-threaded apartment model.  
+   <STAThread()> _  
+   Public Shared Sub Main()  
+      Application.Run(New MyForm())  
+   End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.ComponentModel;  
+using System.Windows.Forms;  
+using System.Resources;  
+using System.Drawing;  
+  
+public class MyForm : Form {  
+   private Button red;  
+   private Button blue;  
+   private Button green;  
+  
+   public MyForm() : base() {     
+      InitializeComponent();     
+   }  
+  
+   protected override void Dispose(bool disposing) {  
+      base.Dispose(disposing);  
+   }  
+  
+// InitializeComponent is a helper method for the constructor.   
+// It is included for consistency with code that is   
+// auto-generated by the Windows Forms designer in Visual Studio.   
+   private void InitializeComponent() {  
+  
+// A delegate for the click event of a button. The argument to   
+// the constructor contains a reference to the method that performs the   
+// event handling logic.  
+      EventHandler handler = new EventHandler(button_Click);  
+  
+// Creates three buttons, sets their properties, and attaches  
+// an event handler to each button.  
+  
+      red = new Button();  
+      red.Text = "Red";  
+      red.Location = new Point(100, 50);  
+      red.Size = new Size(50, 50);  
+      red.Click +=handler;  
+      Controls.Add(red);  
+  
+      blue = new Button();  
+      blue.Text = "Blue";  
+      blue.Location = new Point(100, 100);  
+      blue.Size = new Size(50, 50);  
+      blue.Click += handler;  
+      Controls.Add(blue);  
+  
+      green = new Button();  
+      green.Text = "Green";  
+      green.Location = new Point(100, 150);  
+      green.Size = new Size(50, 50);  
+      green.Click += handler;  
+      Controls.Add(green);        
+      }  
+  
+   // Event handler.  
+   private void button_Click(object sender, EventArgs e) {  
+            if (sender == red) this.BackColor = Color.Red ;  
+                  else if (sender == blue) this.BackColor = Color.Blue;  
+                  else this.BackColor = Color.Green;  
+        }  
+   // The STAThreadAttribute informs the common language runtime that  
+   // Windows Forms uses the single-threaded apartment model.  
+  [STAThread]  
+   public static void Main(string[] args) {  
+   Application.Run(new MyForm());  
+   }  
+  
+}  
+```  
+  
+## 参照  
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [Windows フォーム コントロール開発の基本概念](../../../../docs/framework/winforms/controls/windows-forms-control-development-basics.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/pagesetupdialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/pagesetupdialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..40167ffbd34
--- /dev/null
+++ b/docs/framework/winforms/controls/pagesetupdialog-component-overview-windows-forms.md
@@ -0,0 +1,36 @@
+---
+title: "PageSetupDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PageSetupDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[ページ設定] ダイアログ ボックス, 表示"
+  - "PageSetupDialog コンポーネント"
+ms.assetid: 791caacb-a5ca-4fca-bad9-1a5721ad697c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# PageSetupDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PageSetupDialog> コンポーネントは、Windows ベースのアプリケーションで印刷時のページ設定に使用する定義済みダイアログ ボックスです。  このコントロールは、独自のダイアログ ボックスを使用せずにページ設定を行うための簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  罫線と余白の調整、ヘッダーとフッター、および印刷の縦向きまたは横向きを設定できます。  Windows の標準のダイアログ ボックスを使用して、一般的な基本機能を持つアプリケーションを作成できます。  
+  
+## 主要なプロパティおよびメソッド  
+ <xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用して、実行時にダイアログを表示します。  このコンポーネントには、ページ単位で適用されるプロパティ \(<xref:System.Drawing.Printing.PrintDocument> クラス\) とすべてのドキュメントに適用されるプロパティ \(<xref:System.Drawing.Printing.PageSettings> クラス\) があります。  また、<xref:System.Windows.Forms.PageSetupDialog> コンポーネントを使用して、<xref:System.Drawing.Printing.PrinterSettings> クラスに格納される特定のプリンター設定を決定できます。  
+  
+ フォームに登録すると、<xref:System.Windows.Forms.PageSetupDialog> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PageSetupDialog>   
+ [PageSetupDialog コンポーネント](../../../../docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md b/docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md
new file mode 100644
index 00000000000..6c3ff8a8bc3
--- /dev/null
+++ b/docs/framework/winforms/controls/pagesetupdialog-component-windows-forms.md
@@ -0,0 +1,60 @@
+---
+title: "PageSetupDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "フッター, ページ設定オプション"
+  - "ヘッダー, 印刷"
+  - "横向き"
+  - "マージン, ページ設定オプション"
+  - "ページ フッター"
+  - "ページ ヘッダー"
+  - "ページのプロパティ"
+  - "ページ設定"
+  - "[ページ設定] ダイアログ ボックス"
+  - "PageSetupDialog コンポーネント"
+  - "用紙の向き"
+  - "縦向き"
+  - "印刷オプション, PageSetupDialog コンポーネント"
+  - "印刷 [Windows フォーム], 表示 (設定ダイアログ ボックスを)"
+  - "印刷 [Windows フォーム], ヘッダーとフッター"
+  - "印刷 [Windows フォーム], ページ設定"
+ms.assetid: 1c7ccb02-ac62-4fc8-8e4f-c67b01a86802
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# PageSetupDialog コンポーネント (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PageSetupDialog> コンポーネントは、Windows ベースのアプリケーションで印刷時のページ設定に使用する定義済みダイアログ ボックスです。  このコントロールは、独自のダイアログ ボックスを使用せずにページ設定を行うための簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  罫線と余白、ヘッダーとフッター、および印刷の向きを  設定できます。  Windows の標準のダイアログ ボックスを使用して、一般的な基本機能を持つアプリケーションを作成できます。  
+  
+## このセクションの内容  
+ [PageSetupDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/pagesetupdialog-component-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.PageSetupDialog> コンポーネントの全般的な概念を説明します。このコンポーネントにより、ユーザーがページ設定を操作するために使用する定義済みダイアログ ボックスを表示できます。  
+  
+ [方法 : PageSetupDialog コンポーネントを使用してページのプロパティを決定する](../../../../docs/framework/winforms/controls/how-to-determine-page-properties-using-the-pagesetupdialog-component.md)  
+ 実行時に <xref:System.Windows.Forms.PageSetupDialog> コンポーネントのインスタンスを使用してページのプロパティを設定する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.PageSetupDialog>  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ アプリケーションまたはシステムとの標準的なやり取りを可能にする一連のコントロールおよびコンポーネントについて説明します。  
+  
+ [Windows フォーム ダイアログ ボックスの重要コード](http://go.microsoft.com/fwlink/?LinkID=102575)  
+ Windows フォームのダイアログ ボックス コントロールとコンポーネント、および、これらの基本機能を実行するために必要なコードについて説明します。  \(MSDN オンライン ライブラリの技術文書\)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/panel-control-overview-windows-forms.md b/docs/framework/winforms/controls/panel-control-overview-windows-forms.md
new file mode 100644
index 00000000000..cf0aefd517e
--- /dev/null
+++ b/docs/framework/winforms/controls/panel-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "Panel コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Panel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "グループ化 (コントロールを), Panel コントロール"
+  - "Panel コントロール [Windows フォーム], Panel コントロールの概要"
+ms.assetid: b6b83636-2c39-4dad-89d6-f0fa41049a74
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Panel コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.Panel> コントロールを使用すると、他のコントロールと区別できるようにグループ化できます。  通常は、機能別にフォームを細分化するためにパネルを使用します。  たとえば、どの宅配業者を使用するかなどの発送情報を指定する注文フォームを作成できます。  すべてのオプションをパネルにグループ化することにより、論理的な関連性を視覚的に表現できます。  デザイン時に、すべてのコントロールを簡単に移動できます。<xref:System.Windows.Forms.Panel> コントロールを移動すると、そこに含まれるすべてのコントロールも一緒に移動します。  パネルにグループ化されたコントロールは <xref:System.Windows.Forms.Control.Controls%2A> プロパティを使ってアクセスできます。  このプロパティは <xref:System.Windows.Forms.Control> インスタンスのコレクションを返すため、通常は、このように取得したコントロールを特定の型にキャストする必要があります。  
+  
+## Panel と GroupBox  
+ <xref:System.Windows.Forms.Panel> コントロールは <xref:System.Windows.Forms.GroupBox> コントロールに似ていますが、スクロール バーを表示できるのは <xref:System.Windows.Forms.Panel> コントロールだけであり、キャプションを表示できるのは <xref:System.Windows.Forms.GroupBox> コントロールだけです。  
+  
+## 主要なプロパティ  
+ スクロール バーを表示するには、<xref:System.Windows.Forms.ScrollableControl.AutoScroll%2A> プロパティを真 \(`true`\) に設定します。  <xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.BackgroundImage%2A>、および<xref:System.Windows.Forms.Panel.BorderStyle%2A> の各プロパティを設定して、パネルの表示形式をカスタマイズすることもできます。  <xref:System.Windows.Forms.Control.BackColor%2A> プロパティおよび <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティの詳細については、「[方法 : パネルの背景を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md)」を参照してください。  <xref:System.Windows.Forms.Panel.BorderStyle%2A> プロパティを使用すると、パネルのアウトラインを非可視の境界線 \(<xref:System.Windows.Forms.BorderStyle>\)、単線 \(<xref:System.Windows.Forms.BorderStyle>\)、または影付き線 \(<xref:System.Windows.Forms.BorderStyle>\) のいずれかに設定できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Panel>   
+ [GroupBox コントロール](../../../../docs/framework/winforms/controls/groupbox-control-windows-forms.md)   
+ [方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する](../../../../docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md)   
+ [方法 : デザイナーを使って Windows フォーム パネルの背景を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/panel-control-windows-forms.md b/docs/framework/winforms/controls/panel-control-windows-forms.md
new file mode 100644
index 00000000000..95c3b0038c1
--- /dev/null
+++ b/docs/framework/winforms/controls/panel-control-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "Panel コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], グループ化"
+  - "グループ化 (コントロールを)"
+  - "Panel コントロール [Windows フォーム]"
+ms.assetid: 37c69803-5084-4347-b035-54cfbabdc310
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Panel コントロール (Windows フォーム)
+Windows フォームの `Panel` コントロールを使用すると、他のコントロールと区別できるようにグループ化できます。  通常は、機能別にフォームを細分化するためにパネルを使用します。  `Panel` コントロールは <xref:System.Windows.Forms.GroupBox> コントロールに似ていますが、スクロール バーを表示できるのは `Panel` コントロールだけであり、キャプションを表示できるのは <xref:System.Windows.Forms.GroupBox> コントロールだけです。  
+  
+## このセクションの内容  
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム Panel コントロールでコントロールをグループ化する](../../../../docs/framework/winforms/controls/group-controls-with-wf-panel-control-using-the-designer.md)  
+ デザイナーを使用してパネルでコントロールをグループ化する方法について説明します。  
+  
+ [方法 : デザイナーを使って Windows フォーム パネルの背景を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel-using-the-designer.md)  
+ デザイナーを使用してパネルの背景色および背景イメージを表示する方法について説明します。  
+  
+ [方法 : パネルの背景を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-background-of-a-windows-forms-panel.md)  
+ パネルの背景色および背景イメージを表示する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Panel>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [方法 : コントロールのコレクションに対して実行時にコントロールを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md)  
+ フォーム上の任意のコンテナー コントロールにコントロールを追加したり、コンテナーからコントロールを削除したりする方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md b/docs/framework/winforms/controls/perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md
new file mode 100644
index 00000000000..95cb065fc99
--- /dev/null
+++ b/docs/framework/winforms/controls/perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 検出 (変更を)"
+  - "データ グリッド, 検出 (セルの変更を)"
+  - "DataGridView コントロール [Windows フォーム], 検出 (セルの変更を)"
+ms.assetid: 7fa44d01-97f4-4ccb-a149-bc72628d2c36
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する
+<xref:System.Windows.Forms.DataGridView> コントロールには多数のイベントがあり、これらを使用して <xref:System.Windows.Forms.DataGridView> セルの状態の変更を検出できます。  最もよく使用されるイベントは <xref:System.Windows.Forms.DataGridView.CellValueChanged> イベントと <xref:System.Windows.Forms.DataGridView.CellStateChanged> イベントの 2 つです。  
+  
+### DataGridView セルの値の変更を検出するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.CellValueChanged> イベントのハンドラーを記述します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#130](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#130)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#130](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#130)]  
+  
+### DataGridView セルの状態の変更を検出するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.CellStateChanged> イベントのハンドラーを記述します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#135](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#135)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#135](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#135)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  C\# の場合は、イベント ハンドラーを対応するイベントに接続しておく必要があります。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.CellValueChanged?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.CellStateChanged?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング](../../../../docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査](../../../../docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..833cd0a5914
--- /dev/null
+++ b/docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,50 @@
+---
+title: "Windows フォーム DataGridView コントロールでのパフォーマンス チューニング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], パフォーマンス チューニング"
+  - "パフォーマンス チューニング, データ グリッド"
+  - "パフォーマンス, DataGridView コントロール"
+ms.assetid: 6ccbff28-a0ff-41e4-b601-61b31b61851d
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォーム DataGridView コントロールでのパフォーマンス チューニング
+`DataGridView` コントロールで大量のデータを扱うときは、慎重に使用しないと、オーバーヘッドのために大量のメモリが消費されることがあります。  クライアントのメモリが限られている場合は、メモリ消費の多い機能を使わないようにすることで、このオーバーヘッドをある程度回避できます。  また、仮想モードを使用して一部または全部のデータ保守タスクとデータ取得タスクを自力で管理すると、メモリ使用状況をシナリオに合わせてカスタマイズできます。  
+  
+## このセクションの内容  
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)  
+ 大量のデータを扱うときに、無用なメモリ消費とパフォーマンス低下を避けるような方法で `DataGridView` コントロールを使用するための詳細を説明します。  
+  
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)  
+ 仮想モードを使用して標準のデータ バインディング機構を補完する \(または置き換える\) 方法について説明します。  
+  
+ [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)  
+ いくつかの仮想モード イベントのハンドラーを実装する方法について説明します。  また、ユーザー編集に対する行レベルのロールバックとコミットを実装する方法の具体例を示します。  
+  
+ [Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)  
+ データを要求時に読み込む方法について説明します。この方法は、クライアント メモリに格納できないくらい多くのデータを表示しなければならないときに役立ちます。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>  
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティの参照ドキュメントを提供します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md b/docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md
new file mode 100644
index 00000000000..9f51df085f7
--- /dev/null
+++ b/docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md
@@ -0,0 +1,82 @@
+---
+title: "チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "デザイナー アクション"
+  - "DesignerAction オブジェクト モデル"
+  - "スマート タグ"
+ms.assetid: cac337e6-00f6-4584-80f4-75728f5ea113
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行
+Windows フォーム アプリケーションのフォームやコントロールを構成するときは、繰り返し実行するタスクが数多くあります。  そのような共通タスクには、次のようなものがあります。  
+  
+-   <xref:System.Windows.Forms.TabControl> へのタブの追加または削除  
+  
+-   親コントロールへのコントロールのドッキング  
+  
+-   <xref:System.Windows.Forms.SplitContainer> コントロールの方向の変更  
+  
+ 開発をスピードアップするために、多くのコントロールにはスマート タグが用意されています。スマート タグは、上記のような共通タスクをデザイン時に単一の操作で実行できるようにする状況依存のメニューです。  これらのタスクは、*スマートタグ動詞*と呼ばれています。  
+  
+ スマート タグは、デザイナーでコントロール インスタンスが有効な間、コントロール インスタンスに表示されいつでも使用できます。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   スマート タグの使用  
+  
+-   スマート タグの有効化と無効化  
+  
+ ここでは、これらの重要なレイアウト機能が果たす役割について理解します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  "SmartTagsExample" という名前の Windows ベース アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **Windows フォーム デザイナー**でフォームを選択します。  
+  
+## スマート タグの使用  
+ スマート タグを提供するコントロールでは、デザイン時にいつでもスマート タグを使用できます。  
+  
+#### スマート タグを使用するには  
+  
+1.  **ツールボックス**の <xref:System.Windows.Forms.TabControl> コントロールをフォームにドラッグします。  スマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) が <xref:System.Windows.Forms.TabControl> の横に表示されます。  
+  
+2.  スマート タグ グリフをクリックします。  グリフの横に表示されるショートカット メニューの **\[タブの追加\]** をクリックします。  新しいタブ ページが <xref:System.Windows.Forms.TabControl> に追加されることを確認してください。  
+  
+3.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+4.  スマート タグ グリフをクリックします。  グリフの横に表示されるショートカット メニューの **\[列の追加\]** をクリックします。  新しい列が <xref:System.Windows.Forms.TableLayoutPanel> コントロールに追加されることを確認してください。  
+  
+5.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.SplitContainer> コントロールをドラッグします。  
+  
+6.  スマート タグ グリフをクリックします。  グリフの横に表示されるショートカット メニューの **\[上下分割の方向\]** をクリックします。  <xref:System.Windows.Forms.SplitContainer> コントロールの分割バーが横向きになったことを確認してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ <xref:System.Windows.Forms.TabControl>   
+ <xref:System.Windows.Forms.SplitContainer>   
+ <xref:System.ComponentModel.Design.DesignerActionList>   
+ [Walkthrough: Adding Smart Tags to a Windows Forms Component](../Topic/Walkthrough:%20Adding%20Smart%20Tags%20to%20a%20Windows%20Forms%20Component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md b/docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..d2df8e3f9ff
--- /dev/null
+++ b/docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "PictureBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PictureBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ コントロール, イメージ コントロールの概要"
+  - "画像コントロール, 画像コントロールの概要"
+  - "PictureBox コントロール [Windows フォーム], PictureBox コントロールの概要"
+ms.assetid: e5befee7-dc29-4888-a7c4-3b177e394112
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# PictureBox コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PictureBox> コントロールを使用すると、ビットマップ、GIF、JPEG、メタファイル、またはアイコンの形式でグラフィックスを表示できます。  
+  
+## 主要なプロパティおよびメソッド  
+ 表示されるピクチャは、実行時またはデザイン時に設定できる <xref:System.Windows.Forms.PictureBox.Image%2A> プロパティによって決まります。  または、<xref:System.Windows.Forms.PictureBox.ImageLocation%2A> プロパティを設定してから、<xref:System.Windows.Forms.PictureBox.Load%2A> メソッドを使用してイメージを同期で読み込むか、または <xref:System.Windows.Forms.PictureBox.LoadAsync%2A> メソッドを使用してイメージを非同期で読み込むという方法でイメージを指定することもできます。  <xref:System.Windows.Forms.PictureBox.SizeMode%2A> プロパティでは、イメージとコントロールを相互に調整する方法を制御します。  詳細については、「[方法 : 実行時にピクチャのサイズまたは配置を変更する](../../../../docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PictureBox>   
+ [方法 : デザイナーを使用してピクチャを読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md)   
+ [方法 : 実行時にピクチャのサイズまたは配置を変更する](../../../../docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)   
+ [方法 : 実行時にピクチャを設定する](../../../../docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md)   
+ [PictureBox コントロール](../../../../docs/framework/winforms/controls/picturebox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/picturebox-control-windows-forms.md b/docs/framework/winforms/controls/picturebox-control-windows-forms.md
new file mode 100644
index 00000000000..0725037cf82
--- /dev/null
+++ b/docs/framework/winforms/controls/picturebox-control-windows-forms.md
@@ -0,0 +1,47 @@
+---
+title: "PictureBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イメージ コントロール [Windows フォーム]"
+  - "イメージ [Windows フォーム], 追加 (PictureBox コントロールに)"
+  - "PictureBox コントロール [Windows フォーム]"
+ms.assetid: f900eb93-25d5-40e5-b5df-b3cea0e831b6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# PictureBox コントロール (Windows フォーム)
+Windows フォームの `PictureBox` コントロールを使用すると、ビットマップ、GIF、JPEG、メタファイル、またはアイコンの形式でグラフィックスを表示できます。  
+  
+## このセクションの内容  
+ [PictureBox コントロールの概要](../../../../docs/framework/winforms/controls/picturebox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : 実行時にピクチャのサイズまたは配置を変更する](../../../../docs/framework/winforms/controls/how-to-modify-the-size-or-placement-of-a-picture-at-run-time-windows-forms.md)  
+ <xref:System.Windows.Forms.PictureBox.SizeMode%2A> プロパティの実行内容と設定方法について説明します。  
+  
+ [方法 : 実行時にピクチャを設定する](../../../../docs/framework/winforms/controls/how-to-set-pictures-at-run-time-windows-forms.md)  
+ 実行時にピクチャを表示およびクリアする方法について説明します。  
+  
+ [方法 : デザイナーを使用してピクチャを読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms.md)  
+ デザイン時にピクチャを読み込んでフォームに表示する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.PictureBox>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md b/docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md
new file mode 100644
index 00000000000..073797a004e
--- /dev/null
+++ b/docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ エントリ, 無効化 (グリッド内の)"
+  - "データ グリッド, 無効化 (データ入力を)"
+  - "DataGridView コントロール [Windows フォーム], 無効化 (データ入力を)"
+ms.assetid: ef9539ce-539b-404e-84b6-ac282b64b88c
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする
+場合によっては、ユーザーが <xref:System.Windows.Forms.DataGridView> コントロールに新しいデータ行を入力したり、既存の行を削除したりできないようにする必要があります。  <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A> プロパティは新しいレコードのための行がコントロールの一番下に存在しているかどうかを示し、<xref:System.Windows.Forms.DataGridView.AllowUserToDeleteRows%2A> プロパティは行を削除できるかどうかを示します。  次のコード例は、これらのプロパティを使用し、さらに <xref:System.Windows.Forms.DataGridView.ReadOnly%2A> プロパティも設定して、コントロール全体を読み取り専用にします。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](http://msdn.microsoft.com/library/k5c88sw3\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#090](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#090)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#090](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#090)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.ReadOnly%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToDeleteRows%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..499c314edd9
--- /dev/null
+++ b/docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 防止 (行の追加または削除を)"
+ms.assetid: a17722bd-9400-41e6-8dcc-c9c151f0a749
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする
+場合によっては、ユーザーが <xref:System.Windows.Forms.DataGridView> コントロールに新しいデータ行を入力したり、既存の行を削除したりしないようにする必要があります。  新しい行は、コントロールの下の新しいレコード用の特別な行に入力されます。  行の追加を無効にすると、新しいレコード用の行は表示されません。  行の削除とセルの編集を無効にすると、コントロールを完全に読み取り専用にできます。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 行が追加および削除されないようにするには  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールの右上隅にあるスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックして、**\[追加を有効にする\]** チェック ボックスおよび **\[削除を有効にする\]** チェック ボックスをオフにします。  
+  
+    > [!NOTE]
+    >  コントロールを完全に読み取り専用にするには、**\[編集を有効にする\]** チェック ボックスもオフにします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A?displayProperty=fullName>   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printdialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/printdialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..7d53a42d395
--- /dev/null
+++ b/docs/framework/winforms/controls/printdialog-component-overview-windows-forms.md
@@ -0,0 +1,36 @@
+---
+title: "PrintDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PrintDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[印刷] ダイアログ ボックス, 表示"
+  - "PrintDialog コンポーネント [Windows フォーム], PrintDialog コンポーネントの概要"
+ms.assetid: 8327b8ac-1017-4b5e-a88b-fea9dd56999c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# PrintDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの [PrintDialog](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md) コンポーネントは、Windows ベースのアプリケーションで出力先プリンターや印刷範囲などの印刷設定に使用する、定義済みダイアログ ボックスです。  このダイアログ ボックスは、独自のダイアログ ボックスを使用せずにプリンターなどの印刷設定を行うための簡易ソリューションとして使用します。  ドキュメント全体、選択したページ範囲、選択した部分など、さまざまな印刷範囲を指定できます。  Windows の標準のダイアログ ボックスを使用して、一般的な基本機能を持つアプリケーションを作成できます。  <xref:System.Windows.Forms.PrintDialog> コンポーネントは、<xref:System.Windows.Forms.CommonDialog> クラスを継承します。  
+  
+## コンポーネントの操作  
+ 実行時にダイアログ ボックスを表示するには、<xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用します。  このコンポーネントには、印刷ジョブ単位で適用されるプロパティ \(<xref:System.Drawing.Printing.PrintDocument> クラス\) とプリンター単位で適用されるプロパティ \(<xref:System.Drawing.Printing.PrinterSettings> クラス\) があります。  このいずれかを複数のプリンターで共有できます。  
+  
+ フォームに登録すると、<xref:System.Windows.Forms.PrintDialog> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PrintDialog>   
+ [PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printdialog-component-windows-forms.md b/docs/framework/winforms/controls/printdialog-component-windows-forms.md
new file mode 100644
index 00000000000..ae6ef5c8c99
--- /dev/null
+++ b/docs/framework/winforms/controls/printdialog-component-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "PrintDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷ダイアログ ボックス (デザイナーを使用)"
+  - "印刷オプション, PrintDialog コンポーネント (デザイナーを使用)"
+  - "PrintDialog コンポーネント [Windows フォーム]"
+  - "印刷 [Windows フォーム], 印刷オプション"
+  - "印刷 [Windows フォーム], PrintDialog コンポーネント (デザイナーを使用)"
+ms.assetid: 09b54db1-d7c7-42fa-b98a-840e6b80a9ad
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# PrintDialog コンポーネント (Windows フォーム)
+Windows フォーム `PrintDialog` コンポーネントは、構成済みのダイアログ ボックスであり、Windows ベースのアプリケーションのプリンターの選択、印刷するページの選択、およびその他の印刷関連の設定の確認に使用します。  独自のダイアログ ボックスを構成する代わりに、プリンターと印刷関連の設定の選択のための簡単なソリューションとして使用します。  ユーザーが自分のドキュメントのさまざまな部分 \(すべての印刷、指定したページ範囲の印刷、または、選択部分の印刷\) を印刷できるようにすることが可能です。  Windows の標準のダイアログ ボックスを使用して、ユーザーがすぐに慣れる基本的な機能を持つアプリケーションを作成します。  
+  
+## このセクションの内容  
+ [PrintDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/printdialog-component-overview-windows-forms.md)  
+ ユーザーがプリンターの選択、印刷するページの選択、および印刷関連の設定を決定するために使用できる構成済みのダイアログ ボックスを表示できる、`PrintDialog` コンポーネントの全般的な概要を紹介します。  
+  
+ [方法 : PrintDialog コンポーネントを表示する](../../../../docs/framework/winforms/controls/how-to-display-the-printdialog-component.md)  
+ ダイアログを表示する方法とプロパティが保存される場所について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.PrintDialog>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全なリストを、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printdocument-component-overview-windows-forms.md b/docs/framework/winforms/controls/printdocument-component-overview-windows-forms.md
new file mode 100644
index 00000000000..406ef064e1b
--- /dev/null
+++ b/docs/framework/winforms/controls/printdocument-component-overview-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "PrintDocument コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PrintDocument"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "PrintDocument コンポーネント [Windows フォーム], PrintDocument コンポーネントの概要"
+  - "印刷 [Windows フォーム], PrintDocument コンポーネント"
+ms.assetid: b59b4b60-dce5-42ca-8421-3a54a2f7bab0
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# PrintDocument コンポーネントの概要 (Windows フォーム)
+Windows フォームの [PrintDocument](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md) コンポーネントは、Windows ベースのアプリケーション内でドキュメントの印刷を行うために、印刷対象と機能を定義するプロパティを設定するときに使用します。  このコンポーネントを [PrintDialog](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md) コンポーネントと一緒に使用すると、ドキュメント印刷のすべての設定を制御できます。  
+  
+## PrintDocument コンポーネントの操作  
+ <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用するのは主に次の 2 つの場合です。  
+  
+-   簡易印刷ジョブ \(特定のテキスト ファイルを印刷する場合など\)。  簡易印刷ジョブの場合は、<xref:System.Drawing.Printing.PrintDocument> コンポーネントを Windows フォームに追加してから、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベント ハンドラーにファイル印刷のプログラミング ロジックを登録します。  このプログラミング ロジックでは、最後に <xref:System.Drawing.Printing.PrintDocument.Print%2A> メソッドを使用してドキュメントを印刷するようにします。  このメソッドは、<xref:System.Drawing.Printing.PrintPageEventArgs> クラスの <xref:System.Drawing.Printing.PrintPageEventArgs.Graphics%2A> プロパティに格納されている <xref:System.Drawing.Graphics> オブジェクトをプリンターに送信します。  <xref:System.Drawing.Printing.PrintDocument> コンポーネントを使用してテキスト ドキュメントを印刷する方法を示す例については、「[方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](../../../../docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md)」を参照してください。  
+  
+-   より複雑な印刷ジョブ \(作成した印刷ロジックを再利用する場合など\)。  作成した印刷ロジックを再利用する場合は、<xref:System.Drawing.Printing.PrintDocument> の派生コンポーネントを新規作成し、<xref:System.Drawing.Printing.PrintDocument.PrintPage> イベントをオーバーライドします。オーバーライドの詳細については、Visual Basic では [Overrides](../Topic/Overrides%20\(Visual%20Basic\).md)、C\# では [override](../Topic/override%20\(C%23%20Reference\).md) のトピックをそれぞれ参照してください。  
+  
+ フォームに登録すると、<xref:System.Drawing.Printing.PrintDocument> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Drawing.Graphics>   
+ <xref:System.Drawing.Printing.PrintDocument>   
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)   
+ [PrintDocument コンポーネント](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printdocument-component-windows-forms.md b/docs/framework/winforms/controls/printdocument-component-windows-forms.md
new file mode 100644
index 00000000000..ed525d76f52
--- /dev/null
+++ b/docs/framework/winforms/controls/printdocument-component-windows-forms.md
@@ -0,0 +1,46 @@
+---
+title: "PrintDocument コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "PrintDocument コンポーネント [Windows フォーム]"
+  - "印刷 [Windows フォーム], ドキュメント"
+ms.assetid: 5af6a51d-66f6-43cd-a8cd-d64eb18fe7e7
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# PrintDocument コンポーネント (Windows フォーム)
+Windows フォーム `PrintDocument` コンポーネントを使用して印刷する対象を記述するプロパティを設定し、Windows ベースのアプリケーション内でドキュメントを印刷します。  ドキュメント印刷のあらゆる側面を管理するために、<xref:System.Windows.Forms.PrintDialog> コンポーネントと組み合わせて使用することができます。  
+  
+## このセクションの内容  
+ [PrintDocument コンポーネントの概要](../../../../docs/framework/winforms/controls/printdocument-component-overview-windows-forms.md)  
+ 印刷する内容を記述し、Windows ベースのアプリケーションで印刷を起動するプロパティを設定できる `PrintDocument` コンポーネントの一般的な概念を紹介します。  
+  
+## 関連項目  
+ <xref:System.Drawing.Printing.PrintDocument>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)  
+ Windows フォームに関連する印刷のトピックの一覧を表示します。  
+  
+ [PrintDialog コンポーネント](../../../../docs/framework/winforms/controls/printdialog-component-windows-forms.md)  
+ ユーザーがプリンターの選択、印刷するページの選択、および印刷関連の設定を決定するために使用できる構成済みのダイアログ ボックスを表示できる、<xref:System.Windows.Forms.PrintDialog> コンポーネントの全般的な概要を紹介します。  
+  
+ [PrintPreviewControl コントロール](../../../../docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md)  
+ 独自の印刷プレビュー ダイアログ ボックスまたはコンポーネントの設計に使用できる、<xref:System.Windows.Forms.PrintPreviewControl> の一般的な概念を説明しています。  
+  
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)  
+ <xref:System.Windows.Forms.PrintPreviewDialog> コントロールの全般的な概念を説明します。このコントロールにより、ユーザーがドキュメントの印刷イメージを見るために使用する事前構成済みダイアログ ボックスを表示できます。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printpreviewcontrol-control-overview-windows-forms.md b/docs/framework/winforms/controls/printpreviewcontrol-control-overview-windows-forms.md
new file mode 100644
index 00000000000..37e7c33ff6c
--- /dev/null
+++ b/docs/framework/winforms/controls/printpreviewcontrol-control-overview-windows-forms.md
@@ -0,0 +1,36 @@
+---
+title: "PrintPreviewControl コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PrintPreviewControl"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷プレビュー"
+  - "PrintPreviewControl コントロール"
+ms.assetid: 4513c6c7-5e9b-4f4c-82ca-00f993a26955
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# PrintPreviewControl コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PrintPreviewControl> は、[PrintDocument](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md) を印刷時の状態で表示するために使用します。  <xref:System.Windows.Forms.PrintPreviewControl> にはボタンなどのユーザー インターフェイス要素がないため、通常は、独自の印刷プレビュー用ユーザー インターフェイスを作成する場合にだけ使用します。  標準のユーザー インターフェイスが必要な場合は、<xref:System.Windows.Forms.PrintPreviewDialog> コントロールを使用します。概要については「[PrintPreviewDialog コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md)」を参照してください。  
+  
+## 主要なプロパティ  
+ このコントロールの主要なプロパティは、プレビューするドキュメントを設定する <xref:System.Windows.Forms.PrintPreviewControl.Document%2A> プロパティです。  ドキュメントは、<xref:System.Drawing.Printing.PrintDocument> オブジェクトである必要があります。  印刷用ドキュメントの作成の概要については、「[PrintDocument コンポーネントの概要](../../../../docs/framework/winforms/controls/printdocument-component-overview-windows-forms.md)」と「[Windows フォームにおける印刷のサポート](../../../../docs/framework/winforms/advanced/windows-forms-print-support.md)」を参照してください。  <xref:System.Windows.Forms.PrintPreviewControl.Columns%2A> プロパティと <xref:System.Windows.Forms.PrintPreviewControl.Rows%2A> プロパティは、コントロール上で横方向および縦方向に表示されるページの数を決定します。  アンチエイリアシングを使用すると、文字の外観は滑らかになりますが、表示は遅くなります。使用する場合は、<xref:System.Windows.Forms.PrintPreviewControl.UseAntiAlias%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PrintPreviewControl>   
+ [PrintPreviewDialog コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md)   
+ [PrintPreviewControl コントロール](../../../../docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md)   
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md b/docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md
new file mode 100644
index 00000000000..5e50a135e31
--- /dev/null
+++ b/docs/framework/winforms/controls/printpreviewcontrol-control-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "PrintPreviewControl コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷プレビュー, カスタム インターフェイス (デザイナーを使用)"
+  - "印刷 [Windows フォーム], 印刷プレビュー"
+  - "PrintPreview コントロール (デザイナーを使用)"
+  - "PrintPreviewControl コントロール (デザイナーを使用)"
+ms.assetid: 3fdb2e46-92a3-4e26-bb8d-63a89087b337
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# PrintPreviewControl コントロール (Windows フォーム)
+Windows フォーム `PrintPreviewControl` は、印刷するときに表示されるドキュメントを表示するために使用されます。  このコントロールには、ボタンやその他のユーザー インターフェイスの要素がないため、通常は、独自の印刷プレビューのユーザー インターフェイスを作成する場合にのみ `PrintPreviewControl` を使用します。  標準のユーザー インターフェイスが必要な場合は、<xref:System.Windows.Forms.PrintPreviewDialog> コントロールを使用します。  
+  
+## このセクションの内容  
+ [PrintPreviewControl コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewcontrol-control-overview-windows-forms.md)  
+ 独自の印刷プレビュー ダイアログまたはコンポーネントの設計に使用できる、`PrintPreviewControl` の一般的な概念について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.PrintPreviewControl>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)  
+ 印刷プレビュー機能を作成する別の方法について説明します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md b/docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md
new file mode 100644
index 00000000000..c8898dbe9ba
--- /dev/null
+++ b/docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md
@@ -0,0 +1,37 @@
+---
+title: "PrintPreviewDialog コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "PrintPreviewDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "PrintPreviewDialog コントロール (デザイナーを使用), PrintPreviewDialog の概要"
+ms.assetid: efd4ee8d-6edd-47ec-88e4-4a4759bd2384
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# PrintPreviewDialog コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.PrintPreviewDialog> コントロールは、[PrintDocument](../../../../docs/framework/winforms/controls/printdocument-component-windows-forms.md) を印刷時の状態で表示する、定義済みダイアログ ボックスです。  このコントロールは、独自のダイアログ ボックスを使用しない簡易ソリューションとして、Windows ベースのアプリケーションで使用します。  このコントロールには、印刷を開始するボタン、ズーム イン用のボタン、1 ページまたは複数ページを表示するボタン、およびダイアログ ボックスを閉じるためのボタンがあります。  
+  
+## 主要なプロパティおよびメソッド  
+ このコントロールの主要なプロパティは、プレビューするドキュメントを設定する <xref:System.Windows.Forms.PrintPreviewDialog.Document%2A> プロパティです。  ドキュメントは、<xref:System.Drawing.Printing.PrintDocument> オブジェクトである必要があります。  ダイアログ ボックスを表示するには、コントロールの <xref:System.Windows.Forms.Form.ShowDialog%2A> メソッドを呼び出す必要があります。  アンチエイリアシングを使用すると、文字の外観は滑らかになりますが、表示は遅くなります。使用する場合は、<xref:System.Windows.Forms.PrintPreviewDialog.UseAntiAlias%2A> プロパティを `true` に設定します。  
+  
+ いくつかのプロパティは、<xref:System.Windows.Forms.PrintPreviewDialog> に含まれる <xref:System.Windows.Forms.PrintPreviewControl> を介して使用できます。  <xref:System.Windows.Forms.PrintPreviewControl> をフォームに追加する必要はありません。コントロールは、ダイアログをフォームに追加したときに自動的に <xref:System.Windows.Forms.PrintPreviewDialog> に含められます。<xref:System.Windows.Forms.PrintPreviewControl> を介して使用できるプロパティの例として、<xref:System.Windows.Forms.PrintPreviewControl.Columns%2A> プロパティおよび <xref:System.Windows.Forms.PrintPreviewControl.Rows%2A> プロパティがあります。これらのプロパティは、コントロール上で横方向および縦方向に表示されるページの数を決定します。  <xref:System.Windows.Forms.PrintPreviewControl.Columns%2A> プロパティには、[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では `PrintPreviewDialog1.PrintPreviewControl.Columns`、[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] では `printPreviewDialog1.PrintPreviewControl.Columns`、または [!INCLUDE[vcprvc](../../../../includes/vcprvc-md.md)] では `printPreviewDialog1->PrintPreviewControl->Columns` としてアクセスできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.PrintPreviewDialog>   
+ [PrintPreviewControl コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewcontrol-control-overview-windows-forms.md)   
+ [PrintPreviewDialog コントロール](../../../../docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md)   
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md b/docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md
new file mode 100644
index 00000000000..b58b8180082
--- /dev/null
+++ b/docs/framework/winforms/controls/printpreviewdialog-control-windows-forms.md
@@ -0,0 +1,51 @@
+---
+title: "PrintPreviewDialog コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷プレビュー, 既定のインターフェイス (デザイナーを使用)"
+  - "印刷 [Windows フォーム], 印刷プレビュー (デザイナーを使用)"
+  - "PrintPreview コントロール (デザイナーを使用)"
+  - "PrintPreviewDialog コントロール (デザイナーを使用)"
+ms.assetid: bfb5a3d7-021e-44f4-90f3-d435467f51d6
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# PrintPreviewDialog コントロール (Windows フォーム)
+Windows フォームの `PrintPreviewDialog` コントロールは、ドキュメントを印刷時の状態で表示するために使用される事前構成済みダイアログ ボックスです。  このコントロールは、独自のダイアログ ボックスを使用しない簡易ソリューションとして、Windows ベースのアプリケーションの中で使用します。  このコントロールには、印刷を開始するボタン、ズーム イン用のボタン、1 ページまたは複数ページを表示するボタン、およびダイアログ ボックスを閉じるためのボタンが含まれています。  
+  
+## このセクションの内容  
+ [PrintPreviewDialog コントロールの概要](../../../../docs/framework/winforms/controls/printpreviewdialog-control-overview-windows-forms.md)  
+ `PrintPreviewDialog` コントロールの全般的な概念を説明します。このコントロールにより、ユーザーがドキュメントの印刷イメージを見るために使用する事前構成済みダイアログ ボックスを表示できます。  
+  
+ [方法 : Windows フォーム アプリケーションに印刷プレビューを表示する](../../../../docs/framework/winforms/controls/how-to-display-print-preview-in-windows-forms-applications.md)  
+ 実行時に `PrintPreviewDialog` コントロールのインスタンスを使用して、印刷するページを表示する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.PrintPreviewDialog>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [Windows フォーム ダイアログ ボックスの重要コード](http://go.microsoft.com/fwlink/?LinkID=102575)  
+ Windows フォーム ダイアログ ボックスのコントロールとコンポーネント、基本的な機能を実行するために必要なコードについて説明します。  \(MSDN オンライン ライブラリの技術記事\)  
+  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ Windows フォームのさまざまなダイアログ ボックス コントロールについて説明します。  
+  
+ [Windows フォームのダイアログ ボックス](../../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)  
+ Windows フォームのダイアログ ボックスを作成する方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md b/docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md
new file mode 100644
index 00000000000..b19fe83e2fd
--- /dev/null
+++ b/docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md
@@ -0,0 +1,61 @@
+---
+title: "方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, サイズ変更 (内容に合わせて)"
+  - "データ グリッド, サイズ変更 (内容に合わせてセルを)"
+  - "DataGridView コントロール [Windows フォーム], サイズ変更 (セルを)"
+  - "グリッド, サイズ変更 (内容に合わせてセルを)"
+ms.assetid: 63d770dc-b3f5-462b-901a-3125b2753792
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する
+<xref:System.Windows.Forms.DataGridView> コントロールのさまざまなメソッドを使用すると、行、列、およびヘッダーのサイズを変更して、切り捨てることなく値の全体を表示することができます。  これらのメソッドを使用して、選択時に <xref:System.Windows.Forms.DataGridView> 要素のサイズを変更できます。  代わりに、コンテンツが変更されるたびに、これらの要素のサイズを自動的に変更するコントロールを構成することができます。  ただしこれは、大規模なデータ セットを処理しているときは、データが頻繁に変更されるときは、効率的ではありません。  詳細については、「[Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ 通常はデータ ソースから新しいデータを読み込むときや、ユーザーが値を編集するときにのみ、内容に合わせて <xref:System.Windows.Forms.DataGridView> 要素をプログラムで調整します。  これは、パフォーマンスを最適化するために便利ですが、ユーザーがマウスを使って行および列のサイズを手動で変更できるようにする場合にも便利です。  
+  
+ 次のコード例は、プログラムでのサイズ変更に使用できるオプションを示します。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.DataGridView.ProgrammaticResizing#0](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ProgrammaticResizing/CPP/programmaticsizing.cpp#0)]
+ [!code-csharp[System.Windows.Forms.DataGridView.ProgrammaticResizing#0](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ProgrammaticResizing/CS/programmaticsizing.cs#0)]
+ [!code-vb[System.Windows.Forms.DataGridView.ProgrammaticResizing#0](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.ProgrammaticResizing/VB/programmaticsizing.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumn%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumnHeadersHeight%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRow%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRows%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRowHeadersWidth%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeRowMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeRowsMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode>   
+ <xref:System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode>   
+ <xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode>   
+ [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](../../../../docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する](../../../../docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md b/docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md
new file mode 100644
index 00000000000..a3b29d57b2d
--- /dev/null
+++ b/docs/framework/winforms/controls/programming-with-cells-rows-and-columns-in-the-datagrid.md
@@ -0,0 +1,68 @@
+---
+title: "Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, データ グリッド"
+  - "列 [Windows フォーム], データ グリッド"
+  - "データ グリッド, 要素"
+  - "DataGridView コントロール [Windows フォーム], プログラミング (グリッド要素を使用して)"
+  - "行 [Windows フォーム], データ グリッド"
+ms.assetid: 0d76f7e4-4149-42c6-9118-bb37d6669dc5
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Windows フォーム DataGridView コントロールのセル、行、および列を使用したプログラミング
+ここでは、セル、行、列の各オブジェクトを使用したさまざまなプログラミング タスクの例を紹介するトピックを示します。  
+  
+## このセクションの内容  
+ [方法 : Windows フォーム DataGridView コントロールの各セルにツールヒントを追加する](../../../../docs/framework/winforms/controls/add-tooltips-to-individual-cells-in-a-wf-datagridview-control.md)  
+ <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントを使用してセルごとに異なるツールヒントを表示する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのセルの変更に基づいてカスタム動作を実行する](../../../../docs/framework/winforms/controls/perform-a-custom-action-based-on-changes-in-a-cell-of-a-datagrid.md)  
+ <xref:System.Windows.Forms.DataGridView.CellValueChanged> イベントと <xref:System.Windows.Forms.DataGridView.CellStateChanged> イベントを処理する方法について説明します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールのバンドを操作する](../../../../docs/framework/winforms/controls/how-to-manipulate-bands-in-the-windows-forms-datagridview-control.md)  
+ 行および列の基本型である <xref:System.Windows.Forms.DataGridViewBand> 型のオブジェクトを使用したプログラミングの方法について説明します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールの行を操作する](../../../../docs/framework/winforms/controls/how-to-manipulate-rows-in-the-windows-forms-datagridview-control.md)  
+ `DataGridViewRow` 型のオブジェクトを使用したプログラミングの方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの列を操作する](../../../../docs/framework/winforms/controls/how-to-manipulate-columns-in-the-windows-forms-datagridview-control.md)  
+ `DataGridViewColumn` 型のオブジェクトを使用したプログラミングの方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのイメージ列を操作する](../../../../docs/framework/winforms/controls/how-to-work-with-image-columns-in-the-windows-forms-datagridview-control.md)  
+ `DataGridViewImageColumn` クラスを使用したプログラミングの方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewCell>  
+ <xref:System.Windows.Forms.DataGridViewCell> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewRow>  
+ <xref:System.Windows.Forms.DataGridViewRow> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewColumn>  
+ <xref:System.Windows.Forms.DataGridViewColumn> クラスの参照ドキュメントを提供します。  
+  
+## 関連項目  
+ [Windows フォーム DataGridView コントロールでの列、行、およびセルの基本機能](../../../../docs/framework/winforms/controls/basic-column-row-and-cell-features-wf-datagridview-control.md)  
+ セル、行、および列の一般的なプロパティを説明するトピックを示します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/progressbar-control-overview-windows-forms.md b/docs/framework/winforms/controls/progressbar-control-overview-windows-forms.md
new file mode 100644
index 00000000000..3540627517b
--- /dev/null
+++ b/docs/framework/winforms/controls/progressbar-control-overview-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "ProgressBar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ProgressBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プログレス コントロール, プログレス コントロールの概要"
+  - "ProgressBar コントロール [Windows フォーム], ProgressBar コントロールの概要"
+ms.assetid: a05d9cba-3a6a-4f8f-94b8-8ec12799fb80
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ProgressBar コントロールの概要 (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.ToolStripProgressBar> コントロールは、<xref:System.Windows.Forms.ProgressBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ProgressBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.ProgressBar> コントロールは、水平のバーに複数の四角形を表示することで、処理の進行状況を表します。  処理が完了したときには、バーが四角形で埋められます。  プログレス バーは、通常、処理が完了するまでの待機時間をユーザーに示すために使用します。たとえば、大きなファイルの読み込み時に使用します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ProgressBar> コントロールは、フォーム上で水平方向にのみ配置できます。  
+  
+## 主要なプロパティおよびメソッド  
+ <xref:System.Windows.Forms.ProgressBar> コントロールの主要なプロパティは、<xref:System.Windows.Forms.ProgressBar.Value%2A>、<xref:System.Windows.Forms.ProgressBar.Minimum%2A>、および <xref:System.Windows.Forms.ProgressBar.Maximum%2A> です。  <xref:System.Windows.Forms.ProgressBar.Minimum%2A> プロパティおよび <xref:System.Windows.Forms.ProgressBar.Maximum%2A> プロパティは、プログレス バーに表示できる最大値と最小値を設定するために使用します。  <xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティは、操作が進行して完了した割合を表します。  コントロールに表示されるバーはブロックを並べて構成されるため、<xref:System.Windows.Forms.ProgressBar> コントロールによって示される値は、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティの現在の値の近似値にすぎません。  <xref:System.Windows.Forms.ProgressBar> コントロールのサイズに基づいて、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティで次のブロックがいつ表示されるかが決定されます。  
+  
+ 現在の進行状況の値を更新する最も一般的な方法は、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを設定するコードを記述することです。  たとえば、大きいファイルの読み込みを行うときは、最大値として、ファイルの大きさを KB 単位で設定します。  たとえば、<xref:System.Windows.Forms.ProgressBar.Maximum%2A> プロパティが 100 に設定され、<xref:System.Windows.Forms.ProgressBar.Minimum%2A> プロパティが 10 に設定され、さらに <xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティが 50 に設定されている場合は、5 つの四角形が表示されます。  これは、表示できる数の半分です。  
+  
+ ただし、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを直接設定する以外にも、<xref:System.Windows.Forms.ProgressBar> コントロールによって表示される値を変更する方法があります。  <xref:System.Windows.Forms.ProgressBar.Step%2A> プロパティを使用して、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティをインクリメントする幅を指定できます。  次に、<xref:System.Windows.Forms.ProgressBar.PerformStep%2A> メソッドを呼び出して値をインクリメントします。  インクリメント幅を変更する場合は、<xref:System.Windows.Forms.ProgressBar.Increment%2A> メソッドを使用して、<xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティをインクリメントする値を指定します。  
+  
+ 現在の処理状況をグラフィカルに表示するもう 1 つのコントロールは、<xref:System.Windows.Forms.StatusBar> コントロールです。  
+  
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.StatusStrip> コントロールと <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールは、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ProgressBar>   
+ [ProgressBar コントロール](../../../../docs/framework/winforms/controls/progressbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/progressbar-control-windows-forms.md b/docs/framework/winforms/controls/progressbar-control-windows-forms.md
new file mode 100644
index 00000000000..3c537e140eb
--- /dev/null
+++ b/docs/framework/winforms/controls/progressbar-control-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "ProgressBar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プログレス コントロール"
+  - "ProgressBar コントロール [Windows フォーム]"
+ms.assetid: 5be6b642-e8a6-4565-8ebd-ae73c7b10dc9
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ProgressBar コントロール (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.ToolStripProgressBar> コントロールは、<xref:System.Windows.Forms.ProgressBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ProgressBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.ProgressBar> コントロールでは、水平のバーに複数の四角形を表示することで、処理の進行状況を表します。  処理が完了したときには、バーが四角形で埋められます。  プログレス バーは、通常、時間のかかる処理が完了するまでの待ち時間をユーザーに示すために使用します。たとえば、大きなファイルの読み込み中に使用します。  
+  
+## このセクションの内容  
+ [ProgressBar コントロールの概要](../../../../docs/framework/winforms/controls/progressbar-control-overview-windows-forms.md)  
+ 処理の進行状況をグラフィカルに表示できる <xref:System.Windows.Forms.ProgressBar> コントロールの全般的な概念を説明します。  
+  
+ [方法 : Windows フォーム ProgressBar コントロールによって表示される値を設定する](../../../../docs/framework/winforms/controls/how-to-set-the-value-displayed-by-the-windows-forms-progressbar-control.md)  
+ <xref:System.Windows.Forms.ProgressBar> コントロールに表示される値を増加させる方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ProgressBar>  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/properties-in-windows-forms-controls.md b/docs/framework/winforms/controls/properties-in-windows-forms-controls.md
new file mode 100644
index 00000000000..f3e46fa3e47
--- /dev/null
+++ b/docs/framework/winforms/controls/properties-in-windows-forms-controls.md
@@ -0,0 +1,64 @@
+---
+title: "Windows フォーム コントロールのプロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], プロパティ"
+  - "カスタム コントロール [Windows フォーム], プロパティの概要 (コードを使用)"
+  - "プロパティ [Windows フォーム]"
+ms.assetid: 2785279b-fb57-4937-8f6b-2050e475db6f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Windows フォーム コントロールのプロパティ
+Windows フォーム コントロールは、基本クラス <xref:System.Windows.Forms.Control?displayProperty=fullName> から数多くのプロパティを継承しています。  こうしたプロパティには、<xref:System.Windows.Forms.Control.Font%2A>、<xref:System.Windows.Forms.Control.ForeColor%2A>、<xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.Bounds%2A>、<xref:System.Windows.Forms.Control.ClientRectangle%2A>、<xref:System.Windows.Forms.Control.DisplayRectangle%2A>、<xref:System.Windows.Forms.Control.Enabled%2A>、<xref:System.Windows.Forms.Control.Focused%2A>、<xref:System.Windows.Forms.Control.Height%2A>、<xref:System.Windows.Forms.Control.Width%2A>、<xref:System.Windows.Forms.Control.Visible%2A>、<xref:System.Windows.Forms.Control.AutoSize%2A> などがあります。  継承されるプロパティの詳細については、<xref:System.Windows.Forms.Control?displayProperty=fullName> に関するトピックを参照してください。  
+  
+ コントロールに継承されたプロパティをオーバーライドしたり、新しいプロパティを定義したりできます。  
+  
+## このセクションの内容  
+ [プロパティの定義](../../../../docs/framework/winforms/controls/defining-a-property-in-windows-forms-controls.md)  
+ カスタム コントロールまたはカスタム コンポーネントのプロパティを実装する方法と、そのプロパティをデザイン環境に統合する方法について説明します。  
+  
+ [ShouldSerialize メソッドと Reset メソッドによる既定値の定義](../../../../docs/framework/winforms/controls/defining-default-values-with-the-shouldserialize-and-reset-methods.md)  
+ カスタム コントロールまたはカスタム コンポーネントの既定のプロパティ値を定義する方法について説明します。  
+  
+ [プロパティ変更イベント](../../../../docs/framework/winforms/controls/property-changed-events.md)  
+ プロパティ値が変化したときにプロパティ変更通知を有効にする方法について説明します。  
+  
+ [方法 : 内在コントロールのプロパティを公開する](../../../../docs/framework/winforms/controls/how-to-expose-properties-of-constituent-controls.md)  
+ カスタム複合コントロール内の内在コントロールのプロパティを公開する方法について説明します。  
+  
+ [カスタム コントロールへのメソッドの実装](../../../../docs/framework/winforms/controls/method-implementation-in-custom-controls.md)  
+ カスタム コントロールおよびカスタム コンポーネントのメソッドを実装する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.UserControl>  
+ 複合コントロールを実装する基本クラスについて説明します。  
+  
+ <xref:System.ComponentModel.TypeConverterAttribute>  
+ カスタム プロパティの型に使用する <xref:System.ComponentModel.TypeConverter> を指定する属性について説明します。  
+  
+ <xref:System.ComponentModel.EditorAttribute>  
+ カスタム プロパティに使用する <xref:System.Drawing.Design.UITypeEditor> を指定する属性について説明します。  
+  
+## 関連項目  
+ [Windows フォーム コントロールの属性](../../../../docs/framework/winforms/controls/attributes-in-windows-forms-controls.md)  
+ カスタム コントロールとカスタム コンポーネントのプロパティやその他のメンバーに適用できる属性について説明します。  
+  
+ [コンポーネントのデザイン時属性](../Topic/Design-Time%20Attributes%20for%20Components.md)  
+ コンポーネントとコントロールに適用されるメタデータ属性の一覧を示します。メタデータ属性が適用されたコンポーネントとコントロールは、デザイン時にビジュアル デザイナーで適切に表示されます。  
+  
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)  
+ デザイン時サポートを提供するエディターやデザイナーなどのクラスを実装する方法を説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/property-changed-events.md b/docs/framework/winforms/controls/property-changed-events.md
new file mode 100644
index 00000000000..89acd518967
--- /dev/null
+++ b/docs/framework/winforms/controls/property-changed-events.md
@@ -0,0 +1,37 @@
+---
+title: "プロパティ変更イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], プロパティの変更 (コードを使用)"
+  - "プロパティ [Windows フォーム], 変更点"
+ms.assetid: 268039ec-5aaa-4d76-b902-acccb036c850
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# プロパティ変更イベント
+*PropertyName* というプロパティが変更されたときに、コントロールから通知が送信されるようにするには、*PropertyName*`Changed` というイベントと、イベントを発生させる `On`*PropertyName*`Changed` というメソッドを定義します。  Windows フォームの名前付け規則に従い、プロパティ名の前に *Changed* という単語が付け加えられます。  プロパティ変更イベントの型に関連付けられているイベント デリゲート型は <xref:System.EventHandler> であり、イベント データ型は <xref:System.EventArgs> です。  基本クラスの <xref:System.Windows.Forms.Control> は、<xref:System.Windows.Forms.Control.BackColorChanged>、<xref:System.Windows.Forms.Control.BackgroundImageChanged>、<xref:System.Windows.Forms.Control.FontChanged>、<xref:System.Windows.Forms.Control.LocationChanged> など、多くのプロパティ変更イベントを定義します。  イベントに関する背景情報については、「[イベント](../../../../docs/standard/events/index.md)」と「[Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)」を参照してください。  
+  
+ プロパティ変更イベントを使用すると、変更に反応するイベント ハンドラーをコントロールのコンシューマーが追加できるため、便利です。  コントロールが発生させたプロパティ変更イベントへこのコントロール自体が応答する必要がある場合には、デリゲートをイベントへアタッチする代わりに、対応する `On`*PropertyName*`Changed` メソッドをオーバーライドします。  通常、プロパティ変更イベントに対して応答するときに、コントロールは他のプロパティを更新するか、コントロールの描画面全体または一部を再描画します。  
+  
+ <xref:System.Windows.Forms.Control> から継承したプロパティ変更イベントの一部に対して `FlashTrackBar` カスタム コントロールが応答する部分を示す例を次に示します。  サンプル全体については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#2)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#2)]  
+  
+## 参照  
+ [イベント](../../../../docs/standard/events/index.md)   
+ [Windows フォーム コントロールのイベント](../../../../docs/framework/winforms/controls/events-in-windows-forms-controls.md)   
+ [Windows フォーム コントロールのプロパティ](../../../../docs/framework/winforms/controls/properties-in-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md b/docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md
new file mode 100644
index 00000000000..4f1b581efb4
--- /dev/null
+++ b/docs/framework/winforms/controls/providing-accessibility-information-for-controls-on-a-windows-form.md
@@ -0,0 +1,107 @@
+---
+title: "Windows フォーム上のコントロールのユーザー補助情報の提供 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム コントロール、アクセシビリティ"
+  - "コントロール [Windows フォーム], ユーザー補助"
+  - "アクセシビリティ、Windows フォーム コントロール"
+ms.assetid: 887dee6f-5059-4d57-957d-7c6fcd4acb10
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Windows フォーム上のコントロールのユーザー補助情報の提供
+ユーザー補助機能は専用のプログラムおよびデバイスで、障害を持つユーザーがコンピューターをより効果的に使用するよう助けます。 たとえば、視覚障碍者のためのスクリーン リーダーや、マウスまたはキーボードではなく音声コマンド入力を利用するユーザーのための音声入力ユーティリティがあります。 これらのユーザー補助機能は、Windows フォーム コントロールによって公開されているアクセシビリティのプロパティと連携します。 これらのプロパティとは:  
+  
+-   **AccessibilityObject**  
+  
+-   **AccessibleDefaultActionDescription**  
+  
+-   **AccessibleDescription**  
+  
+-   **AccessibleName**  
+  
+-   **AccessibleRole**  
+  
+## AccessibilityObject プロパティ  
+ この読み取り専用プロパティには [AccessibleObject クラス](frlrfSystemWindowsFormsAccessibleObjectClassTopic) インスタンスが含まれます。**AccessibleObject** は、コントロールの説明、画面上の位置、ナビゲーション能力、および値に関する情報を提供する <xref:Accessibility.IAccessible> インターフェイスを実装します。 デザイナーは、コントロールがフォームに追加されたときにこの値を設定します。  
+  
+## AccessibleDefaultActionDescription プロパティ  
+ この文字列は、コントロールの操作について説明します。 \[プロパティ\] ウィンドウには表示されず、コードでのみ設定できます。 次の例では、このプロパティをボタン コントロールに設定します。  
+  
+```  
+' Visual Basic  
+Button1.AccessibleDefaultActionDescription = _  
+   "Closes the application."  
+  
+// C#  
+Button1.AccessibleDefaultActionDescription =   
+   "Closes the application.";  
+  
+// C++  
+button1->AccessibleDefaultActionDescription =  
+   "Closes the application.";  
+```  
+  
+## AccessibleDescription プロパティ  
+ この文字列はコントロールについて説明します。 これは、\[プロパティ\] ウィンドウで、または次のようにコードで設定できます。  
+  
+```  
+' Visual Basic  
+Button1.AccessibleDescription = "A button with text 'Exit'."  
+  
+// C#  
+Button1.AccessibleDescription = "A button with text 'Exit'";  
+  
+// C++  
+button1->AccessibleDescription = "A button with text 'Exit'";  
+```  
+  
+## AccessibleName プロパティ  
+ これは、ユーザー補助機能に報告されたコントロールの名前です。 これは、\[プロパティ\] ウィンドウで、または次のようにコードで設定できます。  
+  
+```  
+' Visual Basic  
+Button1.AccessibleName = "Order"  
+  
+// C#  
+Button1.AccessibleName = "Order";  
+  
+// C++  
+button1->AccessibleName = "Order";  
+```  
+  
+## AccessibleRole プロパティ  
+ このプロパティには [AccessibleRole 列挙](frlrfSystemWindowsFormsAccessibleRoleClassTopic)列挙型が含まれており、コントロールのユーザー インターフェイスの役割について説明します。 新しいコントロールは値が `Default` に設定されています。 つまり、**ボタン** コントロールは既定値では**ボタン**として機能します。 コントロールに別の役割がある場合、このプロパティをリセットできます。 たとえば、**PictureBox** コントロールを **Chart** として使用する場合、**PictureBox** ではなく **Chart** としてユーザー補助機能が役割を報告するようにできます。 また、開発したカスタム コントロールにこのプロパティを指定することもできます。 このプロパティは、\[プロパティ\] ウィンドウで、または次のようにコードで設定できます。  
+  
+```  
+' Visual Basic  
+PictureBox1.AccessibleRole = AccessibleRole.Chart  
+  
+// C#  
+PictureBox1.AccessibleRole = AccessibleRole.Chart;  
+  
+// C++  
+pictureBox1->AccessibleRole = AccessibleRole::Chart;  
+```  
+  
+## 参照  
+ <xref:System.Windows.Forms.AccessibleObject>   
+ <xref:System.Windows.Forms.Control.AccessibilityObject%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.AccessibleDefaultActionDescription%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.AccessibleDescription%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.AccessibleName%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Control.AccessibleRole%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.AccessibleRole>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/putting-controls-on-windows-forms.md b/docs/framework/winforms/controls/putting-controls-on-windows-forms.md
new file mode 100644
index 00000000000..1d3d5fd44ec
--- /dev/null
+++ b/docs/framework/winforms/controls/putting-controls-on-windows-forms.md
@@ -0,0 +1,52 @@
+---
+title: "Windows フォームへのコントロールの追加 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ENV.Window.Toolbox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム コントロール, 追加 (フォームに)"
+ms.assetid: 997508f2-87e5-4bec-a78e-9eec8f1fb15b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォームへのコントロールの追加
+Windows フォームに追加できるコントロールには、アプリケーションのニーズに応じるために、さまざまな種類があります。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)  
+ フォームにコントロールを追加する手順を示します。  
+  
+ [方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-without-a-user-interface-to-windows-forms.md)  
+ ユーザー インターフェイスを使用せずに、アプリケーションにコントロールを追加する手順を示します。  
+  
+ [方法 : コントロールのコレクションに対して実行時にコントロールを追加または削除する](../../../../docs/framework/winforms/controls/how-to-add-to-or-remove-from-a-collection-of-controls-at-run-time.md)  
+ 実行時にパネルにコントロールを追加したり、パネルからコントロールを削除したりする方法について説明します。  
+  
+ [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)  
+ コンポーネントの作成後、**ツールボックス**にカスタム コンポーネントが自動的に表示されるようにする方法について説明します。  
+  
+ [方法 : Windows フォームに ActiveX コントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)  
+ レガシ ActiveX コントロールを使用する手順を示します。  
+  
+ [Windows フォームで ActiveX コントロールをホストする場合の考慮事項](../../../../docs/framework/winforms/controls/considerations-when-hosting-an-activex-control-on-a-windows-form.md)  
+ アプリケーションで ActiveX コントロールを使用する場合に考慮する点について説明します。  
+  
+## 関連項目  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ コントロールを紹介するトピック、およびコントロールを使用して実行できる処理を紹介するトピックへのリンクを示します。  
+  
+ [Windows フォームでのユーザー入力の検証](../../../../docs/framework/winforms/user-input-validation-in-windows-forms.md)  
+ Windows フォーム コントロールの内容の検証について、基本的な事項および背景にある理論を説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/radiobutton-control-overview-windows-forms.md b/docs/framework/winforms/controls/radiobutton-control-overview-windows-forms.md
new file mode 100644
index 00000000000..9451175d970
--- /dev/null
+++ b/docs/framework/winforms/controls/radiobutton-control-overview-windows-forms.md
@@ -0,0 +1,44 @@
+---
+title: "RadioButton コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "RadioButton"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "オプション ボタン, オプション ボタンの概要"
+  - "オプション ボタン, 判断 (状態を)"
+  - "RadioButton コントロール [Windows フォーム], RadioButton コントロールの概要"
+  - "RadioButton コントロール [Windows フォーム], 判断 (状態を)"
+ms.assetid: cd11f0c2-d098-4022-adf9-1455bc166a13
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# RadioButton コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.RadioButton> コントロールを使用すると、相互に排他的な選択項目を 2 つ以上含むセットを設定できます。  オプション ボタンとチェック ボックスは機能が似ているように見えますが、重要な違いがあります。ユーザーがオプション ボタンをクリックした場合、同じグループ内の他のオプション ボタンと同時にオンにすることはできません。  これに対し、チェック ボックスはいくつでもオンにできます。  オプション ボタン グループは、"内部で 1 つだけ選択できる選択項目のセット" と定義されます。  
+  
+## コントロールの使用  
+ <xref:System.Windows.Forms.RadioButton> コントロールをクリックすると、<xref:System.Windows.Forms.RadioButton.Checked%2A> プロパティが `true` に設定され、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーが呼び出されます。  <xref:System.Windows.Forms.RadioButton.CheckedChanged> イベントは、<xref:System.Windows.Forms.RadioButton.Checked%2A> プロパティの値が変更されるときに発生します。  <xref:System.Windows.Forms.RadioButton.AutoCheck%2A> プロパティを `true` \(既定\) に設定した場合、オプション ボタンをクリックすると、グループ内の他のすべての項目が自動的にオフにされます。  選択したオプション ボタンが有効なオプションであることを確認するための検証コードを使用する場合、通常はこのプロパティを `false` に設定します。  コントロールに表示されるテキストは、<xref:System.Windows.Forms.Control.Text%2A> プロパティによって設定します。このプロパティには、アクセス キー ショートカットが含まれることがあります。  ユーザーは、Alt キーを押しながらアクセス キーを押すことによって、コントロールを "クリック" した場合と同様の操作ができます。  詳細については、「[方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)」および「[方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.RadioButton> コントロールは、コマンド ボタンのように表示できます。<xref:System.Windows.Forms.RadioButton.Appearance%2A> プロパティが <xref:System.Windows.Forms.Appearance> に設定されている場合、選択されている状態では押し下げられているように表示されます。  <xref:System.Windows.Forms.ButtonBase.Image%2A> プロパティと <xref:System.Windows.Forms.ButtonBase.ImageList%2A> プロパティを使用すると、オプション ボタンでイメージを表示することもできます。  詳細については、「[方法 : Windows フォーム コントロールによって表示されるイメージを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-image-displayed-by-a-windows-forms-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RadioButton>   
+ [Panel コントロールの概要](../../../../docs/framework/winforms/controls/panel-control-overview-windows-forms.md)   
+ [GroupBox コントロールの概要](../../../../docs/framework/winforms/controls/groupbox-control-overview-windows-forms.md)   
+ [CheckBox コントロールの概要](../../../../docs/framework/winforms/controls/checkbox-control-overview-windows-forms.md)   
+ [方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)   
+ [方法 : Windows フォーム コントロールによって表示されるテキストを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-text-displayed-by-a-windows-forms-control.md)   
+ [方法 : セットとして機能する Windows フォーム RadioButton コントロールをグループ化する](../../../../docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md)   
+ [RadioButton コントロール](../../../../docs/framework/winforms/controls/radiobutton-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/radiobutton-control-windows-forms.md b/docs/framework/winforms/controls/radiobutton-control-windows-forms.md
new file mode 100644
index 00000000000..97746885c93
--- /dev/null
+++ b/docs/framework/winforms/controls/radiobutton-control-windows-forms.md
@@ -0,0 +1,43 @@
+---
+title: "RadioButton コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェックされたリスト項目, Windows フォーム コントロール"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+  - "オプション ボタン"
+  - "RadioButton コントロール [Windows フォーム]"
+ms.assetid: e895b2a5-9bcb-4486-b165-eaf4c3ea9644
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# RadioButton コントロール (Windows フォーム)
+Windows フォームの `RadioButton` コントロールを使用すると、相互に排他的な選択項目を 2 つ以上含むセットを設定できます。  オプション ボタンとチェック ボックスは機能が似ているように見えますが、重要な違いがあります。ユーザーがオプション ボタンをクリックした場合、同じグループ内の他のオプション ボタンと同時にオンにすることはできません。  
+  
+## このセクションの内容  
+ [RadioButton コントロールの概要](../../../../docs/framework/winforms/controls/radiobutton-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : セットとして機能する Windows フォーム RadioButton コントロールをグループ化する](../../../../docs/framework/winforms/controls/how-to-group-windows-forms-radiobutton-controls-to-function-as-a-set.md)  
+ 1 つのボタンだけをオンにできるセットとして、オプション ボタンをグループ化する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.RadioButton> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/raise-change-notifications--bindingsource.md b/docs/framework/winforms/controls/raise-change-notifications--bindingsource.md
new file mode 100644
index 00000000000..6f0ffb92227
--- /dev/null
+++ b/docs/framework/winforms/controls/raise-change-notifications--bindingsource.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], および IPropertyChange"
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "変更通知"
+  - "変更通知, 発生"
+  - "データ ソース, 検出 (変更を)"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+  - "INotifyPropertyChanged インターフェイス, 使用 (BindingSource と共に)"
+ms.assetid: 7fa2cf51-c09f-4375-adf0-e36c5617f099
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる
+データ ソースに含まれる型が <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装し、プロパティ値が変更されると <xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントを発生させる場合に、<xref:System.Windows.Forms.BindingSource> コンポーネントがデータ ソースの変更を自動的に検出します。  これは、データ ソースの値が変わると、<xref:System.Windows.Forms.BindingSource> にバインドされるコントロールが自動的に更新されるため便利です。  
+  
+> [!NOTE]
+>  データ ソースが <xref:System.ComponentModel.INotifyPropertyChanged> を実装し、非同期操作を実行している場合は、バック グラウンド スレッド上のデータ ソースを変更しないようにします。  代わりに、バック グラウンド スレッド上のデータを読み取り、UI スレッドでリストにデータをマージする必要があります。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスの簡単な実装を示します。  <xref:System.Windows.Forms.BindingSource> が <xref:System.ComponentModel.INotifyPropertyChanged> 型の一覧にバインドされるときに、<xref:System.Windows.Forms.BindingSource> がバインドされたコントロールにデータ ソースの変更を自動的に渡す方法も示します。  
+  
+ `CallerMemberName` 属性を使用する場合、`NotifyPropertyChanged` メソッドの呼び出しが、文字列引数としてプロパティ名を指定する必要はありません。  詳細については、「[呼び出し元情報](../Topic/Caller%20Information%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+ [!code-csharp[System.ComponentModel.IPropertyChangeExample#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IPropertyChangeExample/CS/Form1.cs#1)]
+ [!code-vb[System.ComponentModel.IPropertyChangeExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IPropertyChangeExample/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.INotifyPropertyChanged>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : BindingSource ResetItem メソッドを使用して変更通知を発生させる](../../../../docs/framework/winforms/controls/how-to-raise-change-notifications-using-the-bindingsource-resetitem-method.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md b/docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md
new file mode 100644
index 00000000000..45c138270c0
--- /dev/null
+++ b/docs/framework/winforms/controls/reflect-data-source-updates-in-a-wf-control-with-the-bindingsource.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingSource コンポーネント [Windows フォーム], 例"
+  - "BindingSource コンポーネント [Windows フォーム], 更新 (データ バインディングを)"
+  - "データ バインド, 更新"
+  - "データ ソース, 更新"
+  - "例 [Windows フォーム], BindingSource コンポーネント"
+ms.assetid: bd8bd9b2-af8a-4f11-a3d5-54eecbe2400b
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : BindingSource を使用して Windows フォーム コントロール内にデータ ソースの更新を反映させる
+データ バインド コントロールを使用する場合、データ ソースがリスト変更イベントを発生させないことがあります。そのようなケースで、データ ソース内の変更に応答する必要が生じることがあります。  <xref:System.Windows.Forms.BindingSource> コンポーネントを使用してデータ ソースを Windows フォーム コントロールにバインドすれば、データ ソースが変更されたことを <xref:System.Windows.Forms.BindingSource.ResetBindings%2A> メソッドを呼び出すことによってコントロールに通知できます。  
+  
+## 使用例  
+ 次のコード例では、バインドされたコントロールにデータ ソース内の更新について <xref:System.Windows.Forms.BindingSource.ResetBindings%2A> メソッドを使用して通知する方法を示します。  
+  
+ [!code-cpp[System.Windows.Forms.DataConnector.ResetBindings#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetBindings/CPP/form1.cpp#1)]
+ [!code-csharp[System.Windows.Forms.DataConnector.ResetBindings#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetBindings/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnector.ResetBindings#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnector.ResetBindings/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingNavigator>   
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [方法 : Windows フォーム コントロールを型にバインドする](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-control-to-a-type.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md b/docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md
new file mode 100644
index 00000000000..f8fd5b8681a
--- /dev/null
+++ b/docs/framework/winforms/controls/remove-autogenerated-columns-from-a-wf-datagridview-control.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], 削除"
+  - "DataGridView コントロール [Windows フォーム], 削除 (列を)"
+ms.assetid: 92e28d98-95a3-446c-9150-41b7c7e5be15
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールから自動生成された列を削除する
+データ ソースのデータに基づいて列を自動生成するように <xref:System.Windows.Forms.DataGridView> コントロールが設定されている場合、特定の列を任意に選択して省略できます。  この省略は、<xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションの <xref:System.Windows.Forms.DataGridViewColumnCollection.Remove%2A> メソッドを呼び出して実行できます。  これ以外に、<xref:System.Windows.Forms.DataGridViewColumn.Visible%2A> プロパティを `false` に設定することによってもビューから列を非表示にできます。  この手法は、特定の条件で非表示の列を表示する場合や、列内のデータに非表示にしたままアクセスする必要がある場合に便利です。  
+  
+### 自動生成された列を削除するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.Columns%2A> コレクションの <xref:System.Windows.Forms.DataGridViewColumnCollection.Remove%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#111](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#111)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#111](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#111)]  
+  
+### 自動生成された列を非表示するには  
+  
+-   列の <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A> プロパティを `false` に設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#112](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#112)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#112](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#112)]  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#110](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#110)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#110](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#110)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   Northwind サンプルデータベースの `Customers` テーブルなど、`Fax` 列と `CustomerID` 列を含むテーブルにバインドされている `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AutoGenerateColumns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.Columns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumnCollection.Remove%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/rendering-a-windows-forms-control.md b/docs/framework/winforms/controls/rendering-a-windows-forms-control.md
new file mode 100644
index 00000000000..630a76ff9a1
--- /dev/null
+++ b/docs/framework/winforms/controls/rendering-a-windows-forms-control.md
@@ -0,0 +1,127 @@
+---
+title: "Windows フォーム コントロールのレンダリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], グラフィックス リソース"
+  - "カスタム コントロール [Windows フォーム], 無効化と描画"
+  - "カスタム コントロール [Windows フォーム], 描画"
+  - "OnPaintBackground メソッド, 呼び出し (Windows フォーム カスタム コントロールで)"
+ms.assetid: aae8e1e6-4786-432b-a15e-f4c44760d302
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォーム コントロールのレンダリング
+レンダリングとは、ユーザーの画面にコントロールのビジュアル表現を作成する操作です。  Windows フォームは、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] \(新しい Windows グラフィックス ライブラリ\) を使用してレンダリングを行います。  [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] へのアクセスを提供するマネージ クラスは、<xref:System.Drawing?displayProperty=fullName> 名前空間とその下位名前空間に格納されています。  
+  
+ コントロールのレンダリングに使用される要素を次に示します。  
+  
+-   <xref:System.Windows.Forms.Control?displayProperty=fullName> 基本クラスによって提供される描画機能  
+  
+-   [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] グラフィックス ライブラリの必須要素。  
+  
+-   描画領域のジオメトリ  
+  
+-   グラフィック リソースを解放するためのプロシージャ  
+  
+## コントロールの描画機能  
+ <xref:System.Windows.Forms.Control> 基本クラスは、その <xref:System.Windows.Forms.Control.Paint> イベントを介して描画機能を提供します。  コントロールの表示を更新する必要がある場合は、このコントロールが常に <xref:System.Windows.Forms.Control.Paint> イベントを発生させます。  .NET Framework のイベントの詳細については、「[イベントの処理と発生](../../../../docs/standard/events/index.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.Control.Paint> イベントのイベント データ クラスである <xref:System.Windows.Forms.PaintEventArgs> は、コントロールの描画に必要なデータ、つまりグラフィックス オブジェクト、および描画する領域を表す四角形オブジェクトへのハンドルを維持します。  次のコード片では、これらのオブジェクトを太字で示します。  
+  
+```vb  
+Public Class PaintEventArgs  
+   Inherits EventArgs  
+   Implements IDisposable  
+  
+   Public ReadOnly Property ClipRectangle() As System.Drawing.Rectangle  
+      ...  
+   End Property  
+  
+   Public ReadOnly Property Graphics() As System.Drawing.Graphics  
+      ...  
+   End Property  
+   ' Other properties and methods.  
+   ...  
+End Class  
+```  
+  
+```csharp  
+public class PaintEventArgs : EventArgs, IDisposable {  
+public System.Drawing.Rectangle ClipRectangle {get;}  
+public System.Drawing.Graphics Graphics {get;}  
+// Other properties and methods.  
+...  
+}  
+```  
+  
+ <xref:System.Drawing.Graphics> は描画機能をカプセル化するマネージ クラスです。このクラスについては、このトピックの [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] のセクションで説明します。  <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> は <xref:System.Drawing.Rectangle> 構造体のインスタンスです。コントロールを描画するために使用できる領域を定義します。  コントロール開発者は、コントロールの <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> プロパティを使用して <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> を算出できます。これについては、このトピックの後半のジオメトリのセクションで説明します。  
+  
+ コントロールは、<xref:System.Windows.Forms.Control> から継承する <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドすることによって、レンダリング ロジックを提供する必要があります。  <xref:System.Windows.Forms.Control.OnPaint%2A> は、グラフィックス オブジェクトと四角形へアクセスし、渡された <xref:System.Windows.Forms.PaintEventArgs> インスタンスの <xref:System.Drawing.Design.PaintValueEventArgs.Graphics%2A> プロパティと <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> プロパティを使用してこれらのオブジェクトを描画します。  
+  
+```vb  
+Protected Overridable Sub OnPaint(pe As PaintEventArgs)  
+```  
+  
+```csharp  
+protected virtual void OnPaint(PaintEventArgs pe);  
+```  
+  
+ <xref:System.Windows.Forms.Control> 基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドは描画機能を実装しません。このメソッドは、<xref:System.Windows.Forms.Control.Paint> イベントに登録されているイベント デリゲートを呼び出すだけです。  <xref:System.Windows.Forms.Control.OnPaint%2A> をオーバーライドする場合は、登録デリゲートが <xref:System.Windows.Forms.Control.Paint> イベントを受信できるように、常に基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを呼び出す必要があります。  ただし描画面全体を描画するコントロールでは、基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> を呼び出すとちらつきが発生するため、これを呼び出さないようにします。  <xref:System.Windows.Forms.Control.OnPaint%2A> イベントのオーバーライドの例については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+> [!NOTE]
+>  コントロールから直接 <xref:System.Windows.Forms.Control.OnPaint%2A> を呼び出さないでください。<xref:System.Windows.Forms.Control> から継承された <xref:System.Windows.Forms.Control.Invalidate%2A> メソッドを呼び出すか、または <xref:System.Windows.Forms.Control.Invalidate%2A> を呼び出す他のメソッドを呼び出してください。  <xref:System.Windows.Forms.Control.Invalidate%2A> メソッドが <xref:System.Windows.Forms.Control.OnPaint%2A> を呼び出します。  <xref:System.Windows.Forms.Control.Invalidate%2A> メソッドはオーバーロードされます。また、<xref:System.Windows.Forms.Control.Invalidate%2A> メソッドに渡される引数によって、コントロールの描画領域が画面領域の全体または一部のどちらであるかが決まります。  
+  
+ <xref:System.Windows.Forms.Control> 基本クラスは、描画に役立つもう 1 つのメソッドである <xref:System.Windows.Forms.Control.OnPaintBackground%2A> メソッドを定義します。  
+  
+```vb  
+Protected Overridable Sub OnPaintBackground(pevent As PaintEventArgs)  
+```  
+  
+```csharp  
+protected virtual void OnPaintBackground(PaintEventArgs pevent);  
+```  
+  
+ <xref:System.Windows.Forms.Control.OnPaintBackground%2A> はウィンドウの背景 \(ウィンドウの形状\) を描画するメソッドであり、高速処理が保証されています。一方、<xref:System.Windows.Forms.Control.OnPaint%2A> は詳細を描画するメソッドです。個々の描画要求が 1 つの <xref:System.Windows.Forms.Control.Paint> イベントに結合されますが、このイベントは再描画する必要のある領域をすべてカバーしているため、このメソッドの処理には時間がかかることがあります。  たとえば、コントロールのグラデーション色の背景を描画するには、<xref:System.Windows.Forms.Control.OnPaintBackground%2A> を呼び出します。  
+  
+ <xref:System.Windows.Forms.Control.OnPaintBackground%2A> にはイベントに似た命名規則があり、`OnPaint` メソッドと同じ引数を受け取ります。ただし、<xref:System.Windows.Forms.Control.OnPaintBackground%2A> は厳密にはイベント メソッドではありません。  `PaintBackground` というイベントは存在せず、<xref:System.Windows.Forms.Control.OnPaintBackground%2A> はイベント デリゲートを呼び出しません。  <xref:System.Windows.Forms.Control.OnPaintBackground%2A> メソッドをオーバーライドする場合は、派生クラスがその基本クラスの <xref:System.Windows.Forms.Control.OnPaintBackground%2A> メソッドを呼び出す必要はありません。  
+  
+## GDI\+ の基本事項  
+ <xref:System.Drawing.Graphics> クラスには、テキストを表示するメソッドと同様に円形、三角形、円弧、楕円形などのさまざまな形状を描画するメソッドがあります。  形状 \(円形、四角形、円弧など\)、色、フォント、ブラシなどのグラフィックス要素をカプセル化したクラスは、<xref:System.Drawing?displayProperty=fullName> 名前空間とその下位名前空間に格納されています。  [!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] の詳細については、「[マネージ グラフィックス クラスの使用](../../../../docs/framework/winforms/advanced/using-managed-graphics-classes.md)」を参照してください。  また、[!INCLUDE[ndptecgdi](../../../../includes/ndptecgdi-md.md)] の基本については「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」にも説明されています。  
+  
+## 描画領域のジオメトリ  
+ <xref:System.Windows.Forms.PaintEventArgs> の <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> プロパティが実際に描画される領域を指定している一方、コントロールの <xref:System.Windows.Forms.Control.ClientRectangle%2A> プロパティはユーザーの画面上のコントロールに使用できる四角形の領域を指定します。  実際に描画が実行されるのは、<xref:System.Windows.Forms.PaintEventArgs> インスタンスを引数として受け取る <xref:System.Windows.Forms.Control.Paint> イベント メソッドです。  コントロールでは、使用できる領域の一部を描画するだけで済む場合があります。たとえば、コントロールの表示領域の一部だけが変更された場合などです。  このような場合、コントロールの開発者は実際に描画する領域を計算し、算出された値を <xref:System.Windows.Forms.Control.Invalidate%2A> へ渡す必要があります。  引数として <xref:System.Drawing.Rectangle> または <xref:System.Drawing.Region> を受け取る <xref:System.Windows.Forms.Control.Invalidate%2A> のオーバーロードされたバージョンでは、その引数を使用して <xref:System.Windows.Forms.PaintEventArgs> の <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> プロパティを生成します。  
+  
+ `FlashTrackBar` カスタム コントロールが、描画する四角形領域を計算する処理を次のコード片に示します。  `client` 変数は <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> プロパティを示します。  サンプル全体については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#6)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#6)]  
+  
+## グラフィック リソースの解放  
+ グラフィック オブジェクトはシステム リソースを消費するため、パフォーマンスへの影響が大きいオブジェクトです。  そのようなオブジェクトは、<xref:System.Drawing.Graphics?displayProperty=fullName> クラスのインスタンスに加えて、<xref:System.Drawing.Brush?displayProperty=fullName> クラス、<xref:System.Drawing.Pen?displayProperty=fullName> クラス、およびその他のグラフィックス クラスのインスタンスを含みます。  必要な場合にだけグラフィック リソースを作成し、リソースの利用が終わったらすぐにリソースを解放することが重要です。  <xref:System.IDisposable> インターフェイスを実装する型を作成する場合には、処理が完了したら、リソースを解放するために <xref:System.IDisposable.Dispose%2A> メソッドを呼び出します。  
+  
+ `FlashTrackBar` カスタム コントロールによる <xref:System.Drawing.Brush> リソースの作成と解放を、次のコード片に示します。  ソース コード全体については、「[方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)」を参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#5)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#5)]  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#4)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#4)]  
+  
+ [!code-csharp[System.Windows.Forms.FlashTrackBar#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/CS/FlashTrackBar.cs#3)]
+ [!code-vb[System.Windows.Forms.FlashTrackBar#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FlashTrackBar/VB/FlashTrackBar.vb#3)]  
+  
+## 参照  
+ [方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/rendering-controls-with-visual-styles.md b/docs/framework/winforms/controls/rendering-controls-with-visual-styles.md
new file mode 100644
index 00000000000..3d24a296a43
--- /dev/null
+++ b/docs/framework/winforms/controls/rendering-controls-with-visual-styles.md
@@ -0,0 +1,91 @@
+---
+title: "visual スタイルが使用されているコントロールのレンダリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロフェッショナルな外観, Windows フォーム コントロールでのレンダリング"
+  - "テーマ, XP の Visual スタイル (Window フォームでの)"
+  - "カスタム コントロール [Windows フォーム], レンダリング"
+  - "カスタム コントロール [Windows フォーム], 描画"
+  - "ビジュアル テーマ, レンダリング (Windows フォーム コントロールの)"
+  - "ユーザー コントロール [Windows フォーム], 描画"
+  - "ビジュアル テーマ, レンダリング (Windows フォーム コントロールの)"
+ms.assetid: a5b178ba-610e-46c4-a6c0-509c0886a744
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# visual スタイルが使用されているコントロールのレンダリング
+[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] は、視覚スタイルをサポートするオペレーティング システムでの、それらを使用したコントロールと他の Windows ユーザー インターフェイス \(UI\) 要素のレンダリングをサポートします。 このトピックでは、オペレーティング システムの現在の視覚スタイルを使用したコントロールと他の UI 要素のレンダリングに関して [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] でのいくつかのサポート レベルについて説明します。  
+  
+## 一般的なコントロールのクラスをレンダリングする  
+ コントロールのレンダリングとは、コントロールのユーザー インターフェイスを描画することを意味します。<xref:System.Windows.Forms?displayProperty=fullName> 名前空間は、いくつかの一般的な Windows フォーム コントロールをレンダリングするための <xref:System.Windows.Forms.ControlPaint> クラスを提供します。 ただし、このクラスは従来の Windows スタイルでコントロールを描画するため、視覚スタイルが有効になったアプリケーションでカスタム コントロールを描画する際の一貫した UI エクスペリエンスの維持が困難になる可能性があります。  
+  
+ [!INCLUDE[dnprdnlong](../../../../includes/dnprdnlong-md.md)] に含まれる <xref:System.Windows.Forms?displayProperty=fullName> 名前空間のクラスは、視覚スタイルを使用して一般的なコントロールのパーツと状態をレンダリングします。 これらの各クラスに含まれる `static` メソッドにより、オペレーティング システムの現在の視覚スタイルを使用して、特定の状態のコントロールまたはコントロールのパーツを描画します。  
+  
+ これらのクラスの一部は、視覚スタイルが使用可能かどうかに関係なく関連するコントロールを描画するように設計されています。 視覚スタイルが有効になっている場合、クラス メンバーは視覚スタイルを使用して関連するコントロールを描画します。視覚スタイルが無効になっている場合、クラス メンバーは、従来の Windows スタイルでコントロールを描画します。 次のようなクラスがこれに含まれます。  
+  
+-   <xref:System.Windows.Forms.ButtonRenderer>  
+  
+-   <xref:System.Windows.Forms.CheckBoxRenderer>  
+  
+-   <xref:System.Windows.Forms.GroupBoxRenderer>  
+  
+-   <xref:System.Windows.Forms.RadioButtonRenderer>  
+  
+ 他のクラスは、視覚スタイルが使用可能な場合にのみ関連するコントロールを描画することができ、視覚スタイルが無効になっている場合、それらのメンバーは例外をスローします。 次のようなクラスがこれに含まれます。  
+  
+-   <xref:System.Windows.Forms.ComboBoxRenderer>  
+  
+-   <xref:System.Windows.Forms.ProgressBarRenderer>  
+  
+-   <xref:System.Windows.Forms.ScrollBarRenderer>  
+  
+-   <xref:System.Windows.Forms.TabRenderer>  
+  
+-   <xref:System.Windows.Forms.TextBoxRenderer>  
+  
+-   <xref:System.Windows.Forms.TrackBarRenderer>  
+  
+ これらのクラスを使用したコントロールの描画の詳細については、「[方法 : コントロールの描画クラスを使用する](../../../../docs/framework/winforms/controls/how-to-use-a-control-rendering-class.md)」を参照してください。  
+  
+## 視覚スタイル要素とレンダリング クラス  
+ <xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> 名前空間に含まれるクラスを使用して、視覚スタイルによってサポートされる任意のコントロールまたは UI 要素を描画したり、それらに関する情報を取得したりすることができます。 サポートされるコントロールには、<xref:System.Windows.Forms?displayProperty=fullName> 名前空間のレンダリング クラスを使用する一般的なコントロール \(前のセクションを参照してください\)、およびタブ コントロールや rebar コントロールなどの他のコントロールが含まれます。 他のサポートされる UI 要素には、**\[スタート\]** メニュー、タスクバー、ウィンドウの非クライアント領域のパーツなどがあります。  
+  
+ <xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> 名前空間の主要なクラスは <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> と <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> です。<xref:System.Windows.Forms.VisualStyles.VisualStyleElement> は、視覚スタイルによってサポートされる任意のコントロールまたはユーザー インターフェイス要素を識別するための基盤クラスです。<xref:System.Windows.Forms.VisualStyles.VisualStyleElement> 自体に加えて、<xref:System.Windows.Forms.VisualStyles?displayProperty=fullName> 名前空間には、視覚スタイルによってサポートされるコントロール、コントロール パーツ、その他の UI 要素のすべての状態の <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> を返す `static` プロパティを持つ <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> の多くの入れ子になったクラスが含まれています。  
+  
+ <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> は、オペレーティング システムの現在の視覚スタイルによって定義される各 <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> を描画したり、それらに関する情報を取得したりするメソッドを提供します。 取得可能な要素に関する情報には、既定のサイズ、背景の種類、色の定義などが含まれます。<xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> は、Windows プラットフォーム SDK の Windows シェル部分からの視覚スタイル \(UxTheme\) API の機能をラップします。 詳細については、MSDN ライブラリ \([http:\/\/msdn.microsoft.com\/library](http://msdn.microsoft.com/library/)\) のプラットフォーム SDK 部分の「Windows XP ビジュアル スタイルの使用」を参照してください。  
+  
+ <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> と <xref:System.Windows.Forms.VisualStyles.VisualStyleElement> の使用方法の詳細については、「[方法 : visual スタイル要素を描画する](../../../../docs/framework/winforms/controls/how-to-render-a-visual-style-element.md)」を参照してください。  
+  
+## 視覚スタイルを有効にする  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] バージョン 1.0 用に作成されたアプリケーションの視覚スタイルを有効にするには、プログラマーが、ComCtl32.dll バージョン 6 以降をコントロールの描画に使用することを指定するアプリケーション マニフェストを含める必要があります。[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] バージョン 1.1 以降を使用してビルドされたアプリケーションは、<xref:System.Windows.Forms.Application> クラスの <xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを使用できます。  
+  
+## 視覚スタイルのサポートの確認  
+ <xref:System.Windows.Forms.Application> クラスの <xref:System.Windows.Forms.Application.RenderWithVisualStyles%2A> プロパティは、現在のアプリケーションが視覚スタイルを使用してコントロールを描画しているかどうかを示します。 カスタム コントロールを描画するときには、<xref:System.Windows.Forms.Application.RenderWithVisualStyles%2A> の値を確認して、コントロールのレンダリングに視覚スタイルを使用する必要があるかどうかを判断できます。 次の表に、<xref:System.Windows.Forms.Application.RenderWithVisualStyles%2A> が `true` を返すために満たす必要がある 4 つの条件を示します。  
+  
+|条件|ノート|  
+|--------|---------|  
+|オペレーティング システム視覚スタイルをサポートしている。|この条件を個別に確認するには、<xref:System.Windows.Forms.VisualStyles.VisualStyleInformation> クラスの <xref:System.Windows.Forms.VisualStyles.VisualStyleInformation.IsSupportedByOS%2A> プロパティを使用します。|  
+|ユーザーがオペレーティング システムで視覚スタイルを有効にしている。|この条件を個別に確認するには、<xref:System.Windows.Forms.VisualStyles.VisualStyleInformation> クラスの <xref:System.Windows.Forms.VisualStyles.VisualStyleInformation.IsEnabledByUser%2A> プロパティを使用します。|  
+|アプリケーションで視覚スタイルが有効になっている。|アプリケーションで視覚スタイルを有効にするには、<xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドを呼び出すか、ComCtl32.dll バージョン 6 以降をコントロールの描画に使用することを指定するアプリケーション マニフェストを使用します。|  
+|アプリケーション ウィンドウのクライアント領域を描画するために視覚スタイルが使用されている。|この条件を個別に確認するには、<xref:System.Windows.Forms.Application> クラスの <xref:System.Windows.Forms.Application.VisualStyleState%2A> プロパティを使用し、その値が <xref:System.Windows.Forms.VisualStyles.VisualStyleState?displayProperty=fullName> または <xref:System.Windows.Forms.VisualStyles.VisualStyleState?displayProperty=fullName> になっていることを確認します。|  
+  
+ ユーザーが視覚スタイルの有効と無効を切り替えたり、1 つの視覚スタイルから別の視覚スタイルに切り替えたりしたときに、それを確認するには、<xref:Microsoft.Win32.SystemEvents.UserPreferenceChanging?displayProperty=fullName> または <xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged?displayProperty=fullName> イベントのハンドラーの <xref:Microsoft.Win32.UserPreferenceCategory?displayProperty=fullName> 値を確認します。  
+  
+> [!IMPORTANT]
+>  ユーザーが視覚スタイルを有効にしたり切り替えたりしたときに、<xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> を使用してコントロールまたは UI 要素をレンダリングする場合は、<xref:Microsoft.Win32.SystemEvents.UserPreferenceChanging> イベントではなく <xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> イベントを処理するときにこの処理を実行してください。<xref:Microsoft.Win32.SystemEvents.UserPreferenceChanging> を処理するときに <xref:System.Windows.Forms.VisualStyles.VisualStyleRenderer> クラスを使用した場合は、例外がスローされます。  
+  
+## 参照  
+ [コントロールのカスタム描画およびレンダリング](../../../../docs/framework/winforms/controls/custom-control-painting-and-rendering.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..5ceaebfc2a3
--- /dev/null
+++ b/docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,53 @@
+---
+title: "Windows フォーム DataGridView コントロール内の列と行のサイズ変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], サイズ変更 (グリッドの)"
+  - "データ グリッド, サイズ変更 (列と行を)"
+  - "DataGridView コントロール [Windows フォーム], サイズ変更 (行と列を)"
+ms.assetid: 7532764d-e5c1-4943-a08b-6377a722d3b6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Windows フォーム DataGridView コントロール内の列と行のサイズ変更
+`DataGridView` コントロールには、列と行のサイズ変更の動作をカスタマイズするさまざまな機能が用意されています。  通常、`DataGridView` のセルは、内容に基づくサイズ変更を行いません。  セルのサイズよりも大きい表示値は、一部だけが表示されます。  文字列として表示可能な内容は、ツールヒント内に表示されます。  
+  
+ 既定では、行、列、およびヘッダーの区分線をユーザーがマウスでドラッグすることにより、より多くの情報を表示できるようになっています。  また、ユーザーが区分線をダブルクリックすると、関連する行、列、またはヘッダーのサイズは、内容に応じて自動的にサイズ変更されます。  
+  
+ `DataGridView` コントロールには、このようなすべてのユーザー操作をカスタマイズしたり無効にしたりするためのプロパティ、メソッド、およびイベントがあります。  また、プログラムによって、行、列、およびヘッダーのサイズを内容に基づいて変更したり、内容が変更されるたびに自動的にサイズ変更されるように設定したりすることもできます。  列の設定によって、使用できるコントロールの幅が指定した比率で自動的に分割されるようにもできます。  
+  
+## このセクションの内容  
+ [Windows フォーム DataGridView コントロールのサイズ変更オプション](../../../../docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md)  
+ 行、列、およびヘッダーのサイズ変更の機能について説明します。  また、サイズ変更関連のプロパティとメソッドの詳細を示し、一般的な使用シナリオを説明します。  
+  
+ [Windows フォーム DataGridView コントロールの列フィル モード](../../../../docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md)  
+ 列フィル モードについて詳しく説明し、列フィル モードおよびその他のモードを試すために使用できるデモ用のコードを示します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md)  
+ 一般的な用途でのサイズ変更モードの設定方法について説明します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールの内容に合わせてセルのサイズをプログラムで変更する](../../../../docs/framework/winforms/controls/programmatically-resize-cells-to-fit-content-in-the-datagrid.md)  
+ プログラミングによるサイズ変更を試すために使用できるデモ用のコードを示します。  
+  
+ [方法 : Windows フォームの DataGridView コントロールの内容変更時にセルのサイズを自動的に変更する](../../../../docs/framework/winforms/controls/automatically-resize-cells-when-content-changes-in-the-datagrid.md)  
+ 自動サイズ変更モードを試すために使用できるデモ用のコードを示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/richtextbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/richtextbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..0c5335f91fe
--- /dev/null
+++ b/docs/framework/winforms/controls/richtextbox-control-overview-windows-forms.md
@@ -0,0 +1,39 @@
+---
+title: "RichTextBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "RichTextBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "RichTextBox コントロール [Windows フォーム], RichTextBox コントロールの概要"
+  - "テキスト ボックス, テキスト ボックスの概要"
+ms.assetid: 95081194-3dd4-4b84-9545-dd373e491eca
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# RichTextBox コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールは、書式付きテキストの表示、入力、および操作を行うために使用されます。  <xref:System.Windows.Forms.RichTextBox> コントロールは、<xref:System.Windows.Forms.TextBox> コントロールのすべての機能を備えている他、フォント、色、およびリンクを表示したり、ファイルからテキストや埋め込みイメージを読み込んだり、指定した文字を検索したりできます。  通常、<xref:System.Windows.Forms.RichTextBox> コントロールは、Microsoft Word などのワード プロセッシング アプリケーションと同様のテキスト操作および表示機能を提供します。  <xref:System.Windows.Forms.TextBox> コントロールと同様に、<xref:System.Windows.Forms.RichTextBox> コントロールはスクロール バーを表示できます。ただし、<xref:System.Windows.Forms.TextBox> コントロールとは異なり、既定の設定では必要に応じて垂直スクロール バーと水平スクロール バーの両方が表示され、追加のスクロール バー設定もあります。  
+  
+## RichTextBox コントロールの操作  
+ <xref:System.Windows.Forms.TextBox> コントロールと同様に、表示されるテキストは <xref:System.Windows.Forms.RichTextBox.Text%2A> プロパティによって設定されます。  <xref:System.Windows.Forms.RichTextBox> コントロールには、テキストの書式を指定する多くのプロパティがあります。  各プロパティの詳細については、「[方法 : Windows フォームの RichTextBox コントロールのフォント属性を設定する](../../../../docs/framework/winforms/controls/how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md)」と「[方法 : Windows フォームの RichTextBox コントロールを使用してインデント、ぶら下げインデント、および箇条書き段落を設定する](../../../../docs/framework/winforms/controls/set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md)」を参照してください。  ファイルを操作するために、<xref:System.Windows.Forms.RichTextBox.LoadFile%2A> メソッドおよび <xref:System.Windows.Forms.RichTextBox.SaveFile%2A> メソッドを使用すると、プレーンテキスト、Unicode プレーンテキスト、リッチ テキスト形式 \(RTF\) などの複数のファイル形式を表示し、書き込むことができます。  使用できるファイル形式の一覧については、「[RichTextBoxStreamType 列挙](frlrfSystemWindowsFormsRichTextBoxStreamTypeClassTopic)」を参照してください。  <xref:System.Windows.Forms.RichTextBox.Find%2A> メソッドを使用すると、テキストの文字列や特定の文字を検索できます。  
+  
+ また、<xref:System.Windows.Forms.RichTextBox.DetectUrls%2A> プロパティを `true` に設定し、<xref:System.Windows.Forms.RichTextBox.LinkClicked> イベントを処理するコードを記述することで、Web スタイルのリンクに <xref:System.Windows.Forms.RichTextBox> コントロールを使用することもできます。  詳細については、「[方法 : Windows フォームの RichTextBox コントロールを使用して Web スタイルのリンクを表示する](../../../../docs/framework/winforms/controls/how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md)」を参照してください。  コントロール内のテキストの一部またはすべてをユーザーが操作できないようにするには、<xref:System.Windows.Forms.RichTextBox.SelectionProtected%2A> プロパティを `true` に設定します。  
+  
+ <xref:System.Windows.Forms.RichTextBox> コントロール内のほとんどの編集操作は、<xref:System.Windows.Forms.TextBoxBase.Undo%2A> メソッドおよび <xref:System.Windows.Forms.RichTextBox.Redo%2A> メソッドを呼び出すと、元に戻したりやり直したりできます。  <xref:System.Windows.Forms.RichTextBox.CanRedo%2A> メソッドを使用すると、ユーザーが最後に元に戻した動作をコントロールに再び適用できるかどうかを決定できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/richtextbox-control-windows-forms.md b/docs/framework/winforms/controls/richtextbox-control-windows-forms.md
new file mode 100644
index 00000000000..fa7fed10eb6
--- /dev/null
+++ b/docs/framework/winforms/controls/richtextbox-control-windows-forms.md
@@ -0,0 +1,65 @@
+---
+title: "RichTextBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "リッチ エディット コントロール"
+  - "RichTextBox コントロール [Windows フォーム]"
+  - "テキスト ボックス"
+ms.assetid: 3225f2ef-c6d9-4bd4-9d3e-2219e58edbf2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# RichTextBox コントロール (Windows フォーム)
+Windows フォームの `RichTextBox` コントロールは、書式付きテキストの表示、入力、および操作を行うために使用されます。  `RichTextBox` コントロールは、<xref:System.Windows.Forms.TextBox> コントロールのすべての機能を備えており、さらに、フォント、色、およびリンクを表示したり、ファイルからテキストや埋め込みイメージを読み込んだり、編集操作を取り消し\/やり直したり、指定した文字を検索したりできます。  通常、`RichTextBox` コントロールは、Microsoft Word などのワード プロセッシング アプリケーションと同様のテキスト操作および表示機能を提供します。  <xref:System.Windows.Forms.TextBox> コントロールと同様に、`RichTextBox` コントロールはスクロール バーを表示できます。ただし、<xref:System.Windows.Forms.TextBox> コントロールとは異なり、既定で垂直スクロール バーと水平スクロール バーの両方が表示され、追加のスクロール バー設定もあります。  
+  
+## このセクションの内容  
+ [RichTextBox コントロールの概要](../../../../docs/framework/winforms/controls/richtextbox-control-overview-windows-forms.md)  
+ `RichTextBox` コントロールの全般的な概念を説明します。このコントロールにより、ユーザーは書式オプションを使用してテキストを入力、表示、および操作できます。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールにおける書式属性の変更を確認する](../../../../docs/framework/winforms/controls/determine-when-formatting-attributes-change-wf-richtextbox-control.md)  
+ `RichTextBox` コントロールにおいて、フォントや段落書式の変更を追跡する方法を説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールにスクロール バーを表示する](../../../../docs/framework/winforms/controls/how-to-display-scroll-bars-in-the-windows-forms-richtextbox-control.md)  
+ `RichTextBox` コントロールのスクロール バーに関するさまざまな選択肢について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールを使用して Web スタイルのリンクを表示する](../../../../docs/framework/winforms/controls/how-to-display-web-style-links-with-the-windows-forms-richtextbox-control.md)  
+ `RichTextBox` コントロールから Web サイトにリンクする方法について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールにおけるドラッグ アンド ドロップ操作を有効にする](../../../../docs/framework/winforms/controls/enable-drag-and-drop-operations-with-wf-richtextbox-control.md)  
+ `RichTextBox` コントロールにデータをドラッグする方法について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールにファイルを読み込む](../../../../docs/framework/winforms/controls/how-to-load-files-into-the-windows-forms-richtextbox-control.md)  
+ `RichTextBox` コントロールに既存のファイルを読み込む方法について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールを使用してファイルを保存する](../../../../docs/framework/winforms/controls/how-to-save-files-with-the-windows-forms-richtextbox-control.md)  
+ `RichTextBox` コントロールの内容をファイルに保存する方法について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールのフォント属性を設定する](../../../../docs/framework/winforms/controls/how-to-set-font-attributes-for-the-windows-forms-richtextbox-control.md)  
+ `RichTextBox` コントロール内のテキストのフォント ファミリ、サイズ、スタイル、および色を設定する方法について説明します。  
+  
+ [方法 : Windows フォームの RichTextBox コントロールを使用してインデント、ぶら下げインデント、および箇条書き段落を設定する](../../../../docs/framework/winforms/controls/set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md)  
+ `RichTextBox` コントロール内の段落に書式を設定する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.RichTextBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。  
+  
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)  
+ <xref:System.Windows.Forms.TextBox> コントロールの全般的な概念を説明します。このコントロールにより、ユーザーは複数の行を入力して編集できます。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/run-procedures-at-set-intervals-with-wf-timer-component.md b/docs/framework/winforms/controls/run-procedures-at-set-intervals-with-wf-timer-component.md
new file mode 100644
index 00000000000..f1a13c0676c
--- /dev/null
+++ b/docs/framework/winforms/controls/run-procedures-at-set-intervals-with-wf-timer-component.md
@@ -0,0 +1,258 @@
+---
+title: "方法 : Windows フォームの Timer コンポーネントを使用して一定間隔でプロシージャを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "例 [Windows フォーム], タイマー"
+  - "初期化, Timer コンポーネント"
+  - "プロシージャ, 特定の時間間隔"
+  - "Timer コンポーネント [Windows フォーム], 初期化"
+  - "タイマー, イベントの間隔"
+  - "タイマー, Windows ベースの"
+ms.assetid: 8025247a-2de4-4d86-b8ab-a8cb8aeab2ea
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : Windows フォームの Timer コンポーネントを使用して一定間隔でプロシージャを実行する
+ループが完了するまで特定の間隔で実行するプロシージャや、設定した間隔が経過した時点で実行するプロシージャを作成することがあるかもしれません。  <xref:System.Windows.Forms.Timer> コンポーネントにより、このようなプロシージャが可能になります。  
+  
+ このコンポーネントは、Windows フォームの環境用に設計されています。  サーバー環境に適したタイマーが必要な場合は、「[Introduction to Server\-Based Timers](http://msdn.microsoft.com/ja-jp/adc0bc0a-a519-4812-bafc-fb9d1a5801fc)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.Timer> コンポーネントを使用する場合に、いくつかの制限があります。  詳細については、「[Windows フォームの Timer コンポーネントの Interval プロパティの制限](../../../../docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md)」を参照してください。  
+  
+### Timer コンポーネントで設定された間隔でプロシージャを実行するには  
+  
+1.  <xref:System.Windows.Forms.Timer> をフォームに追加します。  プログラムでこれを実行する方法については、次の例のセクションを参照してください。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] も、コンポーネントをフォームに追加する方法をサポートします。  「[方法 : ユーザー インターフェイスを持たないコントロールを Windows フォームに追加する](http://msdn.microsoft.com/library/becyw7bz\(v=vs.110\))」も参照してください。  
+  
+2.  タイマーの <xref:System.Windows.Forms.Timer.Interval%2A> プロパティ \(ミリ秒\) を設定します。  このプロパティは、プロシージャを再度実行する前に、経過する時間の長さを決定します。  
+  
+    > [!NOTE]
+    >  タイマー イベントの発生頻度が高いと、イベントに対応するときに使用されるプロセッサ時間も長くなります。  これにより、全体的なパフォーマンスが低下します。  必要な間隔よりも小さな値を設定しないでください。  
+  
+3.  <xref:System.Windows.Forms.Timer.Tick> イベント ハンドラーで適切なコードを作成します。  このイベントで記述したコードは、<xref:System.Windows.Forms.Timer.Interval%2A> プロパティで指定した間隔で実行されます。  
+  
+4.  <xref:System.Windows.Forms.Timer.Enabled%2A> プロパティを `true` に設定して、タイマーを開始します。  <xref:System.Windows.Forms.Timer.Tick> イベントの発生が開始され、プロシージャが指定された間隔で実行されます。  
+  
+5.  適切なタイミングで <xref:System.Windows.Forms.Timer.Enabled%2A> プロパティを `false` に設定し、プロシージャがもう一度実行されることがないようにします。  間隔を `0` に設定すると、タイマーの停止が発生しません。  
+  
+## 使用例  
+ この最初のコード例は、1 秒単位で 1 日の時間を追跡します。  フォーム上で <xref:System.Windows.Forms.Button>、<xref:System.Windows.Forms.Label>、および <xref:System.Windows.Forms.Timer> コンポーネントを使用します。  <xref:System.Windows.Forms.Timer.Interval%2A> プロパティが 1000 \(1 秒に等しい\) に設定されます。  <xref:System.Windows.Forms.Timer.Tick> イベントで、ラベルのキャプションが現在の時刻に設定されます。  ボタンをクリックしたときに、<xref:System.Windows.Forms.Timer.Enabled%2A> プロパティが `false` に設定されると、タイマーがラベルのキャプションを更新しなくなります。  次のコード例は、`Button1` という名前の <xref:System.Windows.Forms.Button> コントロール、`Timer1` という名前の <xref:System.Windows.Forms.Timer> コントロール、および `Label1` という名前の <xref:System.Windows.Forms.Label> コントロールがあるフォームを持っている必要があります。  
+  
+```vb  
+Private Sub InitializeTimer()  
+   ' Run this procedure in an appropriate event.  
+   ' Set to 1 second.  
+   Timer1.Interval = 1000  
+   ' Enable timer.  
+   Timer1.Enabled = True  
+   Button1.Text = "Enabled"  
+End Sub  
+x  
+Private Sub Timer1_Tick(ByVal Sender As Object, ByVal e As EventArgs) Handles Timer1.Tick  
+' Set the caption to the current time.  
+   Label1.Text = DateTime.Now  
+End Sub  
+  
+Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+      If Button1.Text = "Stop" Then  
+         Button1.Text = "Start"  
+         Timer1.Enabled = False  
+      Else  
+         Button1.Text = "Stop"  
+         Timer1.Enabled = True  
+      End If  
+End Sub  
+  
+```  
+  
+```csharp  
+private void InitializeTimer()  
+{  
+    // Call this procedure when the application starts.  
+    // Set to 1 second.  
+    Timer1.Interval = 1000;  
+    Timer1.Tick += new EventHandler(Timer1_Tick);  
+  
+    // Enable timer.  
+    Timer1.Enabled = true;  
+  
+    Button1.Text = "Stop";  
+    Button1.Click += new EventHandler(Button1_Click);  
+}  
+  
+private void Timer1_Tick(object Sender, EventArgs e)     
+{  
+   // Set the caption to the current time.  
+   Label1.Text = DateTime.Now.ToString();  
+}  
+  
+private void Button1_Click(object sender, EventArgs e)  
+{  
+  if ( Button1.Text == "Stop" )  
+  {  
+    Button1.Text = "Start";  
+    Timer1.Enabled = false;  
+  }  
+  else  
+  {  
+    Button1.Text = "Stop";  
+    Timer1.Enabled = true;  
+  }  
+}  
+  
+```  
+  
+```cpp  
+private:  
+   void InitializeTimer()  
+   {  
+      // Run this procedure in an appropriate event.  
+      // Set to 1 second.  
+      timer1->Interval = 1000;  
+      // Enable timer.  
+      timer1->Enabled = true;  
+      this->timer1->Tick += gcnew System::EventHandler(this,    
+                               &Form1::timer1_Tick);  
+  
+      button1->Text = S"Stop";  
+      this->button1->Click += gcnew System::EventHandler(this,   
+                               &Form1::button1_Click);  
+   }  
+  
+   void timer1_Tick(System::Object ^ sender,  
+      System::EventArgs ^ e)  
+   {  
+      // Set the caption to the current time.  
+      label1->Text = DateTime::Now.ToString();  
+   }  
+  
+   void button1_Click(System::Object ^ sender,  
+      System::EventArgs ^ e)  
+   {  
+      if ( button1->Text == "Stop" )  
+      {  
+         button1->Text = "Start";  
+         timer1->Enabled = false;  
+      }  
+      else  
+      {  
+         button1->Text = "Stop";  
+         timer1->Enabled = true;  
+      }  
+   }  
+  
+```  
+  
+## 使用例  
+ この 2 つ目のコード例は、ループが終了するまでにプロシージャを 600 ミリ秒ごとに実行します。  次のコード例は、`Button1` という名前の <xref:System.Windows.Forms.Button> コントロール、`Timer1` という名前の <xref:System.Windows.Forms.Timer> コントロール、および `Label1` という名前の <xref:System.Windows.Forms.Label> コントロールがあるフォームを持っている必要があります。  
+  
+```vb  
+' This variable will be the loop counter.  
+Private counter As Integer  
+  
+Private Sub InitializeTimer()  
+   ' Run this procedure in an appropriate event.  
+   counter = 0  
+   Timer1.Interval = 600  
+   Timer1.Enabled = True  
+End Sub  
+  
+Private Sub Timer1_Tick(ByVal sender As Object, ByVal e As System.EventArgs) Handles Timer1.Tick  
+   If counter => 10 Then  
+      ' Exit loop code.  
+      Timer1.Enabled = False  
+      counter = 0  
+   Else  
+      ' Run your procedure here.  
+      ' Increment counter.  
+      counter = counter + 1  
+      Label1.Text = "Procedures Run: " & counter.ToString  
+   End If  
+End Sub  
+  
+```  
+  
+```csharp  
+// This variable will be the loop counter.  
+private int counter;  
+  
+private void InitializeTimer()  
+{  
+   // Run this procedure in an appropriate event.  
+   counter = 0;  
+   timer1.Interval = 600;  
+   timer1.Enabled = true;  
+   // Hook up timer's tick event handler.  
+   this.timer1.Tick += new System.EventHandler(this.timer1_Tick);  
+}  
+  
+private void timer1_Tick(object sender, System.EventArgs e)     
+{  
+   if (counter >= 10)   
+   {  
+      // Exit loop code.  
+      timer1.Enabled = false;  
+      counter = 0;  
+   }  
+   else  
+   {  
+      // Run your procedure here.  
+      // Increment counter.  
+      counter = counter + 1;  
+      label1.Text = "Procedures Run: " + counter.ToString();  
+      }  
+}  
+  
+```  
+  
+```cpp  
+private:  
+   int counter;  
+  
+   void InitializeTimer()  
+   {  
+      // Run this procedure in an appropriate event.  
+      counter = 0;  
+      timer1->Interval = 600;  
+      timer1->Enabled = true;  
+      // Hook up timer's tick event handler.  
+      this->timer1->Tick += gcnew System::EventHandler(this, &Form1::timer1_Tick);  
+   }  
+  
+   void timer1_Tick(System::Object ^ sender,  
+      System::EventArgs ^ e)  
+   {  
+      if (counter >= 10)   
+      {  
+         // Exit loop code.  
+         timer1->Enabled = false;  
+         counter = 0;  
+      }  
+      else  
+      {  
+         // Run your procedure here.  
+         // Increment counter.  
+         counter = counter + 1;  
+         label1->Text = String::Concat("Procedures Run: ",  
+            counter.ToString());  
+      }  
+   }  
+```  
+  
+## 参照  
+ <xref:System.Windows.Forms.Timer>   
+ [Timer コンポーネント](../../../../docs/framework/winforms/controls/timer-component-windows-forms.md)   
+ [Timer コンポーネントの概要](../../../../docs/framework/winforms/controls/timer-component-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md b/docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md
new file mode 100644
index 00000000000..de2cb9e4ddf
--- /dev/null
+++ b/docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "SaveFileDialog コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "SaveFileDialog"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[ファイルの保存] ダイアログ ボックス, 表示"
+  - "SaveFileDialog コンポーネント, SaveFileDialog の概要"
+ms.assetid: be7a625f-46fd-4d06-9985-b613dcbf9bd2
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# SaveFileDialog コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.SaveFileDialog> コンポーネントは、定義済みのダイアログ ボックスです。  このダイアログ ボックスは、Windows で使用される標準の **\[ファイルの保存\]** ダイアログ ボックスと同じダイアログ ボックスです。  このコンポーネントは、<xref:System.Windows.Forms.CommonDialog> クラスを継承しています。  
+  
+## SaveFileDialog コンポーネントの操作  
+ このコントロールは、独自のダイアログ ボックスを設定せずにファイルの保存を行うための簡易ソリューションとして使用します。  Windows の標準のダイアログ ボックスを使用して、一般的な基本機能を持つアプリケーションを作成できます。  ただし、<xref:System.Windows.Forms.SaveFileDialog> コンポーネントを使用する場合は、独自のファイル保存ロジックを記述する必要があります。  
+  
+ 実行時にダイアログ ボックスを表示するには、<xref:System.Windows.Forms.CommonDialog.ShowDialog%2A> メソッドを使用します。  <xref:System.Windows.Forms.SaveFileDialog.OpenFile%2A> メソッドを使用して、ファイルを読み取り\/書き込みモードで開くことができます。  
+  
+ フォームに登録すると、<xref:System.Windows.Forms.SaveFileDialog> コンポーネントは Windows フォーム デザイナーの下部のトレイに表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SaveFileDialog>   
+ [SaveFileDialog コンポーネント](../../../../docs/framework/winforms/controls/savefiledialog-component-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/savefiledialog-component-windows-forms.md b/docs/framework/winforms/controls/savefiledialog-component-windows-forms.md
new file mode 100644
index 00000000000..f626a731ac1
--- /dev/null
+++ b/docs/framework/winforms/controls/savefiledialog-component-windows-forms.md
@@ -0,0 +1,46 @@
+---
+title: "SaveFileDialog コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "[ファイルの保存] ダイアログ ボックス"
+  - "SaveFileDialog コンポーネント"
+ms.assetid: 6f5d9321-37d7-4448-ac4c-a33c42b2a766
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# SaveFileDialog コンポーネント (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.SaveFileDialog> コンポーネントは、事前構成済みのダイアログ ボックスです。  これは、Windows で使用される標準の \[ファイルを保存\] ダイアログ ボックスと同じです。  これは、<xref:System.Windows.Forms.CommonDialog> クラスを継承しています。  
+  
+## このセクションの内容  
+ [SaveFileDialog コンポーネントの概要](../../../../docs/framework/winforms/controls/savefiledialog-component-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.SaveFileDialog> コンポーネントの全般的な概念を説明します。このコンポーネントにより、ユーザーがファイルを指定した場所に保存するために使用する事前構成済みダイアログを表示できます。  
+  
+ [方法 : SaveFileDialog コンポーネントを使用してファイルを保存する](../../../../docs/framework/winforms/controls/how-to-save-files-using-the-savefiledialog-component.md)  
+ <xref:System.Windows.Forms.SaveFileDialog> コンポーネントのインスタンスを使用して実行時にファイルを保存する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.SaveFileDialog> クラス  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ ユーザーがアプリケーションまたはシステムと標準的な対話を実行できるようにする一連のコントロールおよびコンポーネントについて説明します。  
+  
+ [Windows フォーム ダイアログ ボックスの重要コード](http://go.microsoft.com/fwlink/?LinkID=102575)  
+ Windows フォーム ダイアログ ボックスのコントロールとコンポーネント、基本的な機能を実行するために必要なコードについて説明します。  \(MSDN オンライン ライブラリの技術記事\)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/selected-cells-rows-and-columns-datagridview.md b/docs/framework/winforms/controls/selected-cells-rows-and-columns-datagridview.md
new file mode 100644
index 00000000000..607d8a04b59
--- /dev/null
+++ b/docs/framework/winforms/controls/selected-cells-rows-and-columns-datagridview.md
@@ -0,0 +1,71 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの選択されたセル、行、および列を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 取得 (選択項目を)"
+  - "取得 (選択項目を), DataGridView コントロール [Windows フォーム]"
+  - "選択, DataGridView コントロール [Windows フォーム]"
+ms.assetid: d93c4b5b-498e-49bc-982a-2229d61778e4
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : Windows フォーム DataGridView コントロールの選択されたセル、行、および列を取得する
+選択されたセル、行、または列を <xref:System.Windows.Forms.DataGridView> コントロールから取得するには、それぞれ <xref:System.Windows.Forms.DataGridView.SelectedCells%2A> プロパティ、<xref:System.Windows.Forms.DataGridView.SelectedRows%2A> プロパティ、または <xref:System.Windows.Forms.DataGridView.SelectedColumns%2A> プロパティを使用します。  次の手順では、選択されたセルを取得し、行インデックスと列インデックスを <xref:System.Windows.Forms.MessageBox> に表示します。  
+  
+### DataGridView コントロールの選択されたセルを取得するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectedCells%2A> プロパティを使用します。  
+  
+    > [!NOTE]
+    >  多数のセルが表示されないようにするには、<xref:System.Windows.Forms.DataGridView.AreAllCellsSelected%2A> メソッドを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSelectedCollections#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/CS/DataGridViewSelectedCollections.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewSelectedCollections#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/VB/DataGridViewSelectedCollections.vb#10)]  
+  
+### DataGridView コントロールの選択された行を取得するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectedRows%2A> プロパティを使用します。  ユーザーが行を選択できるようにするには、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定する必要があります。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSelectedCollections#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/CS/DataGridViewSelectedCollections.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewSelectedCollections#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/VB/DataGridViewSelectedCollections.vb#20)]  
+  
+### DataGridView コントロールの選択された列を取得するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.SelectedColumns%2A> プロパティを使用します。  ユーザーが列を選択できるようにするには、<xref:System.Windows.Forms.DataGridView.SelectionMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewSelectionMode> または <xref:System.Windows.Forms.DataGridViewSelectionMode> に設定する必要があります。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSelectedCollections#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/CS/DataGridViewSelectedCollections.cs#30)]
+     [!code-vb[System.Windows.Forms.DataGridViewSelectedCollections#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSelectedCollections/VB/DataGridViewSelectedCollections.vb#30)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   それぞれに <xref:System.Windows.Forms.Control.Click> イベントのハンドラーが割り当てられた、`selectedCellsButton`、`selectedRowsButton`、および `selectedColumnsButton` という名前の <xref:System.Windows.Forms.Button> コントロール。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Windows.Forms?displayProperty=fullName> アセンブリ、および <xref:System.Text?displayProperty=fullName> アセンブリへの参照。  
+  
+## 信頼性の高いプログラミング  
+ ここで説明するコレクションは、多数のセル、行、または列が選択されている場合は効率的に実行されません。  大量のデータを持つコレクションを使用する方法の詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A>   
+ <xref:System.Windows.Forms.DataGridView.AreAllCellsSelected%2A>   
+ <xref:System.Windows.Forms.DataGridView.SelectedCells%2A>   
+ <xref:System.Windows.Forms.DataGridView.SelectedRows%2A>   
+ <xref:System.Windows.Forms.DataGridView.SelectedColumns%2A>   
+ [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](../../../../docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..557557a25e8
--- /dev/null
+++ b/docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md
@@ -0,0 +1,65 @@
+---
+title: "Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セル, 選択 (グリッドの)"
+  - "クリップボードのトピック, DataGridView コントロール内の"
+  - "データ グリッド, 選択 (セルを)"
+  - "DataGridView コントロール [Windows フォーム], クリップボードの使用"
+  - "DataGridView コントロール [Windows フォーム], 選択 (セルを)"
+  - "選択, DataGridView コントロール内の"
+ms.assetid: 82cffcad-8b30-4897-bddb-c3a79d751b83
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用
+`DataGridView` コントロールには、セル、行、および列をユーザーが選択する方法を設定するさまざまなオプションが用意されています。  たとえば、単一選択または複数選択を有効にしたり、ユーザーがセルをクリックした場合に行全体または列全体が選択されるようにしたり、ユーザーがヘッダーをクリックした場合にだけ行全体または列全体が選択されるようにしてセル単位での選択も有効にしたりできます。  選択操作のための独自のユーザー インターフェイスを提供する必要がある場合は、通常の選択操作を無効にし、すべての選択をプログラムで処理できます。  また、選択されている値をクリップボードにコピーできるようにすることもできます。  
+  
+## このセクションの内容  
+ [Windows フォーム DataGridView コントロールの選択モード](../../../../docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md)  
+ コントロール内でのユーザーおよびプログラムによる選択のオプションについて説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの選択モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md)  
+ ユーザーがセルをクリックしたときに単一の行が選択されるようにコントロールを構成する方法について説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの選択されたセル、行、および列を取得する](../../../../docs/framework/winforms/controls/selected-cells-rows-and-columns-datagridview.md)  
+ 選択されているセル、行、および列のコレクションを操作する方法について説明します。  
+  
+ [方法 : ユーザーが、Windows フォーム DataGridView コントロールからクリップボードに複数のセルをコピーできるようにする](../../../../docs/framework/winforms/controls/enable-users-to-copy-multiple-cells-to-the-clipboard-datagridview.md)  
+ コントロールのクリップボード サポートを有効にする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A> プロパティの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.ClipboardCopyMode%2A>  
+ <xref:System.Windows.Forms.DataGridView.ClipboardCopyMode%2A> プロパティの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewSelectedCellCollection>  
+ <xref:System.Windows.Forms.DataGridViewSelectedCellCollection> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewSelectedRowCollection>  
+ <xref:System.Windows.Forms.DataGridViewSelectedRowCollection> クラスの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewSelectedColumnCollection>  
+ <xref:System.Windows.Forms.DataGridViewSelectedColumnCollection> クラスの参照ドキュメントを提供します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの既定のキーボード処理とマウス処理](../../../../docs/framework/winforms/controls/default-keyboard-and-mouse-handling-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..406274f0f08
--- /dev/null
+++ b/docs/framework/winforms/controls/selection-modes-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,62 @@
+---
+title: "Windows フォーム DataGridView コントロールの選択モード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 選択モード"
+  - "選択, モード (DataGridView コントロール内の)"
+ms.assetid: a3ebfd3d-0525-479d-9d96-d9e017289b36
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォーム DataGridView コントロールの選択モード
+作成したアプリケーションで実行するアクションを、<xref:System.Windows.Forms.DataGridView> コントロール内のユーザーの選択に基づいて決定する必要がある場合があります。  実行するアクションによっては、可能な選択の種類を制限することが必要になります。  たとえば、現在選択されているレコードに関するレポートを印刷できるアプリケーションを作成するとします。  この場合、行内の任意の場所をクリックすると必ず行全体が選択され、一度に 1 行だけ選択できるように <xref:System.Windows.Forms.DataGridView> コントロールを設定する必要があります。  
+  
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A?displayProperty=fullName> プロパティを次の <xref:System.Windows.Forms.DataGridViewSelectionMode> 列挙値のいずれかに設定すると、許可する選択を指定できます。  
+  
+|DataGridViewSelectionMode の値|Description|  
+|----------------------------------|-----------------|  
+|<xref:System.Windows.Forms.DataGridViewSelectionMode>|セルをクリックすると、そのセルが選択されます。  行ヘッダーおよび列ヘッダーを使用した選択はできません。|  
+|<xref:System.Windows.Forms.DataGridViewSelectionMode>|セルをクリックすると、そのセルが選択されます。  列ヘッダーをクリックすると、その列全体が選択されます。  列ヘッダーを使用した並べ替えはできません。|  
+|<xref:System.Windows.Forms.DataGridViewSelectionMode>|セルまたは列ヘッダーをクリックすると、その列全体が選択されます。  列ヘッダーを使用した並べ替えはできません。|  
+|<xref:System.Windows.Forms.DataGridViewSelectionMode>|セルまたは行ヘッダーをクリックすると、その行全体が選択されます。|  
+|<xref:System.Windows.Forms.DataGridViewSelectionMode>|既定の選択モードです。  セルをクリックすると、そのセルが選択されます。  行ヘッダーをクリックすると、その行全体が選択されます。|  
+  
+> [!NOTE]
+>  実行時に選択モードを変更すると、その時点での選択は自動的に解除されます。  
+  
+ 既定では、ユーザーは、選択範囲を拡大または変更する際に Ctrl キーまたは Shift キーを押しながらマウスをドラッグすることで、複数の行、列、またはセルを選択できます。また、左上隅のヘッダー セルをクリックすることで、コントロール内のすべてのセルを選択できます。  この動作を無効にするには、<xref:System.Windows.Forms.DataGridView.MultiSelect%2A> プロパティを `false` に設定します。  
+  
+ <xref:System.Windows.Forms.DataGridViewSelectionMode> モードおよび <xref:System.Windows.Forms.DataGridViewSelectionMode> モードでは、ユーザーは、行を選択して Del キーを押すことで、選択した行を削除できます。  ユーザーが行を削除できるのは、現在のセルが編集モードになっておらず、<xref:System.Windows.Forms.DataGridView.AllowUserToDeleteRows%2A> プロパティが `true` に設定されており、基になるデータ ソースでユーザーによる行の削除がサポートされている場合に限られます。  これらの設定に関係なく、プログラムからは行を削除できます。  
+  
+## プログラムによる選択  
+ ユーザーによる選択と同様、プログラムによる選択の動作も、現在の選択モードによって制限されます。  <xref:System.Windows.Forms.DataGridView> コントロール内のセル、行、または列の `Selected` プロパティを設定すると、プログラムから現在の選択を変更できます。  また、選択モードによっては、<xref:System.Windows.Forms.DataGridView.SelectAll%2A> メソッドによってコントロール内のすべてのセルを選択することもできます。  選択を解除するには、<xref:System.Windows.Forms.DataGridView.ClearSelection%2A> メソッドを使用します。  
+  
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A> プロパティが `true` に設定されている場合は、<xref:System.Windows.Forms.DataGridView> の要素の `Selected` プロパティを変更することにより、その要素を選択に追加したり、選択から解除したりできます。  それ以外の場合は、1 つの要素の `Selected` プロパティを `true` に設定すると、他の要素の選択は自動的に解除されます。  
+  
+ <xref:System.Windows.Forms.DataGridView.CurrentCell%2A> プロパティの値を変更しても、現在の選択は変更されません。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.SelectedCells%2A>、<xref:System.Windows.Forms.DataGridView.SelectedRows%2A>、および <xref:System.Windows.Forms.DataGridView.SelectedColumns%2A> の各プロパティから、現在選択されているセル、行、または列のコレクションを取得できます。  コントロール内のすべてのセルが選択されている場合は、これらのプロパティを使用するのは効率的ではありません。  このような場合のパフォーマンス低下を回避するには、先に <xref:System.Windows.Forms.DataGridView.AreAllCellsSelected%2A> メソッドを使用します。  また、選択されているセル、行、または列の数を調べる際にも、これらのコレクションを使用することは非効率的である場合があります。  代わりに、<xref:System.Windows.Forms.DataGridView.GetCellCount%2A>、<xref:System.Windows.Forms.DataGridViewRowCollection.GetRowCount%2A>、または <xref:System.Windows.Forms.DataGridViewColumnCollection.GetColumnCount%2A> の各メソッドを使用し、<xref:System.Windows.Forms.DataGridViewElementStates> の値を渡してください。  
+  
+> [!TIP]
+>  選択されているセルをプログラムで使用する方法を示すコード例は、<xref:System.Windows.Forms.DataGridView> クラスの概要にあります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.MultiSelect%2A>   
+ <xref:System.Windows.Forms.DataGridView.SelectionMode%2A>   
+ <xref:System.Windows.Forms.DataGridViewSelectionMode>   
+ [Windows フォーム DataGridView コントロールでの選択およびクリップボードの使用](../../../../docs/framework/winforms/controls/selection-and-clipboard-use-with-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの選択モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-selection-mode-of-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/serializing-collections-designerserializationvisibilityattribute.md b/docs/framework/winforms/controls/serializing-collections-designerserializationvisibilityattribute.md
new file mode 100644
index 00000000000..293a7f58ce5
--- /dev/null
+++ b/docs/framework/winforms/controls/serializing-collections-designerserializationvisibilityattribute.md
@@ -0,0 +1,159 @@
+---
+title: "チュートリアル : DesignerSerializationVisibilityAttribute を使用した、標準データ型のコレクションのシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コレクション, シリアル化"
+  - "コレクション, 標準の型"
+  - "DesiginerSerializationVisibilityAttribute クラス"
+  - "シリアル化, コレクション"
+  - "標準の型, コレクション"
+ms.assetid: 020c9df4-fdc5-4dae-815a-963ecae5668c
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# チュートリアル : DesignerSerializationVisibilityAttribute を使用した、標準データ型のコレクションのシリアル化
+カスタム コントロールは、コレクションをプロパティとして公開することがあります。  このチュートリアルでは、<xref:System.ComponentModel.DesignerSerializationVisibilityAttribute> クラスを使用して、デザイン時にコレクションのシリアル化を制御する方法について説明します。  コレクション プロパティに <xref:System.ComponentModel.DesignerSerializationVisibilityAttribute.Content> 値を適用すると、プロパティが確実にシリアル化されます。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[How to: Serialize Collections of Standard Types with the DesignerSerializationVisibilityAttribute](../Topic/How%20to:%20Serialize%20Collections%20of%20Standard%20Types%20with%20the%20DesignerSerializationVisibilityAttribute.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Visual Studio がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## シリアル化可能なコレクションを持つコントロールの作成  
+ 最初に、シリアル化可能なコレクションをプロパティとして持つコントロールを作成します。  このコレクションの内容は、**コレクション エディター**を使用して編集できます。コレクション エディターには、**\[プロパティ\]** ウィンドウがからアクセスできます。  
+  
+#### シリアル化可能なコレクションを持つコントロールを作成するには  
+  
+1.  `SerializationDemoControlLib` という名前の Windows コントロール ライブラリ プロジェクトを作成します。  詳細については、「[Windows Control Library Template](http://msdn.microsoft.com/ja-jp/722f4e2d-1310-4ed5-8f33-593337ab66b4)」を参照してください。  
+  
+2.  `UserControl1` の名前を `SerializationDemoControl` に変更します。  詳細については、「[How to: Rename Identifiers](http://msdn.microsoft.com/ja-jp/2430f732-2b70-4516-8cf6-a7bb71cc9724)」を参照してください。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.Padding.All%2A?displayProperty=fullName> プロパティの値を `10` に設定します。  
+  
+4.  <xref:System.Windows.Forms.TextBox> コントロールを `SerializationDemoControl` に配置します。  
+  
+5.  <xref:System.Windows.Forms.TextBox> コントロールを選択します。  **\[プロパティ\]** ウィンドウで、次のプロパティを設定します。  
+  
+    |プロパティ|変更後の値|  
+    |-----------|-----------|  
+    |**Multiline**|`true`|  
+    |**Dock**|<xref:System.Windows.Forms.DockStyle>|  
+    |**ScrollBars**|<xref:System.Windows.Forms.ScrollBars>|  
+    |**ReadOnly**|`true`|  
+  
+6.  **コード エディター**を使用して、`stringsValue` という名前の文字列配列フィールドを `SerializationDemoControl` で宣言します。  
+  
+     [!code-cpp[System.ComponentModel.DesignerSerializationVisibilityAttribute#4](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/cpp/form1.cpp#4)]
+     [!code-csharp[System.ComponentModel.DesignerSerializationVisibilityAttribute#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/CS/form1.cs#4)]
+     [!code-vb[System.ComponentModel.DesignerSerializationVisibilityAttribute#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/VB/form1.vb#4)]  
+  
+7.  `SerializationDemoControl` の `Strings` プロパティを定義します。  
+  
+> [!NOTE]
+>  <xref:System.ComponentModel.DesignerSerializationVisibilityAttribute.Content> 値を使用して、コレクションのシリアル化を有効にします。  
+  
+ [!code-cpp[System.ComponentModel.DesignerSerializationVisibilityAttribute#5](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/cpp/form1.cpp#5)]
+ [!code-csharp[System.ComponentModel.DesignerSerializationVisibilityAttribute#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/CS/form1.cs#5)]
+ [!code-vb[System.ComponentModel.DesignerSerializationVisibilityAttribute#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.DesignerSerializationVisibilityAttribute/VB/form1.vb#5)]  
+  
+1.  F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  
+  
+2.  **ユーザー コントロール テスト コンテナー**の <xref:System.Windows.Forms.PropertyGrid> で、`Strings` プロパティを探します。  `Strings` プロパティをクリックし、省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして、**文字列コレクション エディター**を開きます。  
+  
+3.  **文字列コレクション エディター**にいくつかの文字列を入力します。  各文字列の末尾で Enter キーを押して区切ります。  文字列を入力したら、**\[OK\]** をクリックします。  
+  
+> [!NOTE]
+>  入力した文字列が `SerializationDemoControl` の <xref:System.Windows.Forms.TextBox> に表示されます。  
+  
+## コレクション プロパティのシリアル化  
+ コントロールのシリアル化動作をテストするには、コントロールをフォームに配置し、**コレクション エディター**を使用してコレクションの内容を変更します。  シリアル化されたコレクションの状態は、**Windows フォーム デザイナー**によるコードの出力先となる特別なデザイナー ファイルで確認できます。  
+  
+#### コレクションをシリアル化するには  
+  
+1.  Windows アプリケーション プロジェクトをソリューションに追加します。  プロジェクトに `SerializationDemoControlTest` という名前を付けます。  
+  
+2.  **\[ツールボックス\]** で、**\[SerializationDemoControlLib コンポーネント\]** という名前のタブを見つけます。  このタブで、`SerializationDemoControl` を探します。  詳細については、「[チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)」を参照してください。  
+  
+3.  `SerializationDemoControl` をフォームに配置します。  
+  
+4.  **\[プロパティ\]** ウィンドウで、`Strings` プロパティを見つけます。  `Strings` プロパティをクリックし、省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして、**文字列コレクション エディター**を開きます。  
+  
+5.  **文字列コレクション エディター**にいくつかの文字列を入力します。  各文字列の末尾で Enter キーを押して区切ります。  文字列を入力したら、**\[OK\]** をクリックします。  
+  
+> [!NOTE]
+>  入力した文字列が `SerializationDemoControl` の <xref:System.Windows.Forms.TextBox> に表示されます。  
+  
+1.  **ソリューション エクスプローラー**の **\[すべてのファイルを表示\]** をクリックします。  
+  
+2.  **\[Form1\]** ノードを開きます。  このノードの下に、**Form1.Designer.cs** または **Form1.Designer.vb** というファイルが表示されます。  **Windows フォーム デザイナー**は、このファイルにフォームと子コントロールのデザイン時の状態を表すコードを出力します。  **コード エディター**でこのファイルを開きます。  
+  
+3.  **Windows Form Designer generated code** という領域を開き、**serializationDemoControl1** というラベルが付けられたセクションを見つけます。  このラベルの下が、コントロールのシリアル化状態を表すコードです。  手順 5. で入力した文字列が、`Strings` プロパティへの代入として表示されます。  たとえば、文字列として "red"、"orange"、および "yellow" を入力した場合には、次のようなコードが表示されます。  
+  
+4.  \[Visual Basic\]  
+  
+    ```  
+    Me.serializationDemoControl1.Strings = New String() {"red", "orange", "yellow"}  
+    ```  
+  
+5.  \[C\#\]  
+  
+    ```  
+    this.serializationDemoControl1.Strings = new string[] {  
+            "red",  
+            "orange",  
+            "yellow"};  
+    ```  
+  
+6.  **コード エディター**で、`Strings` プロパティの <xref:System.ComponentModel.DesignerSerializationVisibilityAttribute> の値を <xref:System.ComponentModel.DesignerSerializationVisibility> に変更します。  
+  
+7.  \[Visual Basic\]  
+  
+    ```  
+    <DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)> _  
+    ```  
+  
+8.  \[C\#\]  
+  
+    ```  
+    [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]  
+    ```  
+  
+9. ソリューションを再度ビルドし、手順 4. から 8. を繰り返します。  
+  
+> [!NOTE]
+>  この場合、**Windows フォーム デザイナー**は、`Strings` プロパティへの代入を出力しません。  
+  
+## 次の手順  
+ 標準データ型のコレクションをシリアル化する方法がわかったら、カスタム コントロールをデザイン時環境により深く統合することを検討してください。  以下のトピックでは、カスタム コントロールのデザイン時の統合を強化する方法について説明しています。  
+  
+-   [Design\-Time Architecture](../Topic/Design-Time%20Architecture.md)  
+  
+-   [Windows フォーム コントロールの属性](../../../../docs/framework/winforms/controls/attributes-in-windows-forms-controls.md)  
+  
+-   [Designer Serialization Overview](../Topic/Designer%20Serialization%20Overview.md)  
+  
+-   [チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](../../../../docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md)  
+  
+## 参照  
+ <xref:System.ComponentModel.DesignerSerializationVisibilityAttribute>   
+ [Designer Serialization Overview](../Topic/Designer%20Serialization%20Overview.md)   
+ [How to: Serialize Collections of Standard Types with the DesignerSerializationVisibilityAttribute](../Topic/How%20to:%20Serialize%20Collections%20of%20Standard%20Types%20with%20the%20DesignerSerializationVisibilityAttribute.md)   
+ [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md b/docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md
new file mode 100644
index 00000000000..20260cd4c7f
--- /dev/null
+++ b/docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示"
+  - "DataGridView コントロール [Windows フォーム], 行スタイル (交互の行)"
+  - "帳簿のような形式"
+  - "行, 交互の"
+  - "Windows フォーム, 行"
+ms.assetid: 02373442-bf94-4470-9f8a-e44c4a9d5b88
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する
+多くの場合、表形式データは、交互の行が異なる背景色を持つ帳簿のような形式で示されます。  この形式では、行とセルの位置関係を見極めやすく、列数が多く幅の広い表では特に便利です。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールを使用すると、交互の行に対して完全なスタイル情報を指定できます。  このコントロールでは、背景色だけでなく前景色やフォントなどのスタイル特性を使用して、交互の行を区別化できます。  詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ 次の手順では、<xref:System.Windows.Forms.DataGridView> コントロールを含むフォームを持つ **Windows アプリケーション** プロジェクトが必要です。  このプロジェクトの設定の詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」および「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 交互の行のスタイルの定義  
+  
+1.  デザイナーで <xref:System.Windows.Forms.DataGridView> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.DataGridView.AlternatingRowsDefaultCellStyle%2A> プロパティの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックします。  
+  
+3.  **\[CellStyle ビルダー\]** ダイアログ ボックスで、プロパティを設定してスタイルを定義し、**プレビュー** ペインを使用して選択内容を確定します。  指定するスタイルは、コントロールに表示される 2 番目の行以降、1 行おきに適用されます。  
+  
+4.  残りの行のスタイルを定義するには、<xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A> プロパティを使用して手順 2. と手順 3. を繰り返します。  
+  
+    > [!NOTE]
+    >  セルは複数のプロパティから継承したスタイルを使用して表示されます。  スタイルの継承の詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデザイナーの使用](../../../../docs/framework/winforms/controls/using-the-designer-with-the-windows-forms-datagridview-control.md)   
+ [How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)   
+ [方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/set-and-return-numeric-values-with-wf-numericupdown-control.md b/docs/framework/winforms/controls/set-and-return-numeric-values-with-wf-numericupdown-control.md
new file mode 100644
index 00000000000..64d838e2bb0
--- /dev/null
+++ b/docs/framework/winforms/controls/set-and-return-numeric-values-with-wf-numericupdown-control.md
@@ -0,0 +1,110 @@
+---
+title: "方法 : Windows フォームの NumericUpDown コントロールを使用して数値を設定および取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "数値, Windows フォーム"
+  - "NumericUpDown コントロール [Windows フォーム], 設定と取得 (値の)"
+  - "Windows フォーム コントロール, NumericUpDown"
+  - "Windows フォーム, 数値"
+ms.assetid: 5bd8f8cd-4c12-49ea-9cc3-2a647d064689
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォームの NumericUpDown コントロールを使用して数値を設定および取得する
+Windows フォームの <xref:System.Windows.Forms.NumericUpDown> コントロールの数値は、<xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティによって決定されます。  他のプロパティと同様に、このコントロールの値に対する条件テストを記述できます。  <xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティを設定した後は、プロパティを操作するコードを記述して値を直接調整するか、または、<xref:System.Windows.Forms.NumericUpDown.UpButton%2A> メソッドおよび <xref:System.Windows.Forms.NumericUpDown.DownButton%2A> メソッドを呼び出すことができます。  
+  
+### 数値を設定するには  
+  
+1.  コードまたは \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティに値を割り当てます。  
+  
+    ```vb  
+    NumericUpDown1.Value = 55  
+  
+    ```  
+  
+    ```csharp  
+    numericUpDown1.Value = 55;  
+  
+    ```  
+  
+    ```cpp  
+    numericUpDown1->Value = 55;  
+    ```  
+  
+     または  
+  
+2.  <xref:System.Windows.Forms.NumericUpDown.UpButton%2A> メソッドまたは <xref:System.Windows.Forms.NumericUpDown.DownButton%2A> メソッドを呼び出して、<xref:System.Windows.Forms.NumericUpDown.Increment%2A> プロパティに指定された量だけ値を増加または減少させます。  
+  
+    ```vb  
+    NumericUpDown1.UpButton()  
+  
+    ```  
+  
+    ```csharp  
+    numericUpDown1.UpButton();  
+  
+    ```  
+  
+    ```cpp  
+    numericUpDown1->UpButton();  
+    ```  
+  
+### 数値を取得するには  
+  
+-   コードで <xref:System.Windows.Forms.NumericUpDown.Value%2A> プロパティにアクセスします。  
+  
+    ```vb  
+    If NumericUpDown1.Value >= 65 Then  
+       MessageBox.Show("Age is: " & NumericUpDown1.Value.ToString)  
+    Else  
+       MessageBox.Show("The customer is ineligible for a senior citizen discount.")  
+    End If  
+  
+    ```  
+  
+    ```csharp  
+    if(numericUpDown1.Value >= 65)  
+    {  
+       MessageBox.Show("Age is: " + numericUpDown1.Value.ToString());  
+    }  
+    else  
+    {  
+       MessageBox.Show("The customer is ineligible for a senior citizen discount.");  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    if(numericUpDown1->Value >= 65)  
+    {  
+       MessageBox::Show(String::Concat("Age is: ",  
+          numericUpDown1->Value.ToString()));  
+    }  
+    else  
+    {  
+       MessageBox::Show  
+          ("The customer is ineligible for a senior citizen discount.");  
+    }  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.NumericUpDown>   
+ <xref:System.Windows.Forms.NumericUpDown.Value%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.NumericUpDown.Increment%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.NumericUpDown.UpButton%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.NumericUpDown.DownButton%2A?displayProperty=fullName>   
+ [NumericUpDown コントロール](../../../../docs/framework/winforms/controls/numericupdown-control-windows-forms.md)   
+ [NumericUpDown コントロールの概要](../../../../docs/framework/winforms/controls/numericupdown-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md b/docs/framework/winforms/controls/set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md
new file mode 100644
index 00000000000..a54b323d1d9
--- /dev/null
+++ b/docs/framework/winforms/controls/set-indents-hanging-indents-bulleted-paragraphs-with-wf-richtextbox.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : Windows フォームの RichTextBox コントロールを使用してインデント、ぶら下げインデント、および箇条書き段落を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - ".rtf ファイル, 書式指定 (RichTextBox コントロールで)"
+  - "例 [Windows フォーム], テキスト ボックス"
+  - "RichTextBox コントロール [Windows フォーム], 設定 (インデントと箇条書きを)"
+  - "RTF ファイル, 書式指定 (RichTextBox コントロールで)"
+  - "テキスト ボックス, 箇条書き"
+  - "テキスト ボックス, 設定 (インデントを)"
+ms.assetid: abfb40e6-5642-4691-8ec1-9d9ae91688dc
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォームの RichTextBox コントロールを使用してインデント、ぶら下げインデント、および箇条書き段落を設定する
+Windows フォームの <xref:System.Windows.Forms.RichTextBox> コントロールには、表示するテキストの書式を設定する数多くのオプションがあります。  <xref:System.Windows.Forms.RichTextBox.SelectionBullet%2A> プロパティを設定することにより、選択した段落を箇条書きとして設定できます。  また、<xref:System.Windows.Forms.RichTextBox.SelectionIndent%2A>、<xref:System.Windows.Forms.RichTextBox.SelectionRightIndent%2A>、および <xref:System.Windows.Forms.RichTextBox.SelectionHangingIndent%2A> の各プロパティを使用して、コントロールの左端または右端、およびテキストの他の行の左端を基準にして、段落のインデントを設定できます。  
+  
+### 段落を箇条書きに設定するには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.SelectionBullet%2A> プロパティを `true` に設定します。  
+  
+    ```vb  
+    RichTextBox1.SelectionBullet = True  
+  
+    ```  
+  
+    ```csharp  
+    richTextBox1.SelectionBullet = true;  
+  
+    ```  
+  
+    ```cpp  
+    richTextBox1->SelectionBullet = true;  
+    ```  
+  
+### 段落にインデントを設定するには  
+  
+1.  <xref:System.Windows.Forms.RichTextBox.SelectionIndent%2A> プロパティに、コントロールの左端とテキストの左端の間のピクセル数を示す整数を設定します。  
+  
+2.  <xref:System.Windows.Forms.RichTextBox.SelectionHangingIndent%2A> プロパティに、段落内のテキストの 1 行目の左端と同じ段落の 2 行目以降の左端の間のピクセル数を示す整数を設定します。  <xref:System.Windows.Forms.RichTextBox.SelectionHangingIndent%2A> プロパティの値は、1 行目の下で折り返されている段落の行にだけ適用されます。  
+  
+3.  <xref:System.Windows.Forms.RichTextBox.SelectionRightIndent%2A> プロパティに、コントロールの右端とテキストの右端の間のピクセル数を示す整数を設定します。  
+  
+    ```vb  
+    RichTextBox1.SelectionIndent = 8  
+    RichTextBox1.SelectionHangingIndent = 3  
+    RichTextBox1.SelectionRightIndent = 12  
+  
+    ```  
+  
+    ```csharp  
+    richTextBox1.SelectionIndent = 8;  
+    richTextBox1.SelectionHangingIndent = 3;  
+    richTextBox1.SelectionRightIndent = 12;  
+  
+    ```  
+  
+    ```cpp  
+    richTextBox1->SelectionIndent = 8;  
+    richTextBox1->SelectionHangingIndent = 3;  
+    richTextBox1->SelectionRightIndent = 12;  
+    ```  
+  
+    > [!NOTE]
+    >  これらのプロパティはすべて、選択したテキストを含む段落に適用されます。または、現在のカーソル位置から入力されるテキストに適用されます。  たとえば、ユーザーが段落内の 1 語を選択してインデントを調整すると、新しい設定はその語を含む段落全体に適用され、さらに、選択された段落の後に入力されるすべての段落にも適用されます。  テキストをプログラムで選択する方法については、「[TextBoxBase.Select メソッド](frlrfSystemWindowsFormsTextBoxBaseClassSelectTopic)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.RichTextBox>   
+ [RichTextBox コントロール](../../../../docs/framework/winforms/controls/richtextbox-control-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md b/docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md
new file mode 100644
index 00000000000..a7133e4d030
--- /dev/null
+++ b/docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 並べ替え (データの)"
+  - "DataGridView コントロール [Windows フォーム], 並べ替えモード"
+  - "並べ替え, データ グリッド"
+ms.assetid: 57dfed60-a608-40d5-86f9-d65686ffb325
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する
+<xref:System.Windows.Forms.DataGridView> コントロールでは、テキスト ボックスの列は既定で自動的に並べ替えられますが、その他のタイプの列は自動的には並べ替えられません。  これらの既定値をオーバーライドする必要が生じることがあります。  たとえば、テキスト、数値、または列挙型のセル値の代わりにイメージを表示できます。  イメージは並べ替えることができませんが、イメージが表す基になる値は並べ替えることができます。  
+  
+ <xref:System.Windows.Forms.DataGridView> コントロールでは、列の <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティ値によって、その列の並べ替え動作が決定されます。  
+  
+ 「[方法 : Windows フォーム DataGridView コントロールのデータの書式設定をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-data-formatting-in-the-windows-forms-datagridview-control.md)」の `Priority` 列の処理方法を次の手順に示します。  この列はイメージ列であり、既定では並べ替えられません。  ただし、実際には文字列であるセル値を含むため、自動的に並べ替えることができます。  
+  
+### 列に対して並べ替えモードを設定するには  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A?displayProperty=fullName> プロパティを設定します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewMisc#066](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#066)]
+     [!code-vb[System.Windows.Forms.DataGridViewMisc#066](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#066)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `Priority` という名前の列を含む `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A?displayProperty=fullName>   
+ [Windows フォームの DataGridView コントロールでのデータの並べ替え](../../../../docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロール内の列の並べ替えモード](../../../../docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..b0e40e974e4
--- /dev/null
+++ b/docs/framework/winforms/controls/sizing-options-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,168 @@
+---
+title: "Windows フォーム DataGridView コントロールのサイズ変更オプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 列のサイズ変更"
+  - "データ グリッド, 行のサイズ変更"
+  - "データ グリッド, サイズ変更オプション"
+  - "DataGridView コントロール [Windows フォーム], 列のサイズ変更"
+  - "DataGridView コントロール [Windows フォーム], 行のサイズ変更"
+  - "DataGridView コントロール [Windows フォーム], サイズ変更オプション"
+ms.assetid: a5620a9c-0d06-41e3-8934-c25ddb16c9e6
+caps.latest.revision: 29
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# Windows フォーム DataGridView コントロールのサイズ変更オプション
+<xref:System.Windows.Forms.DataGridView> の行、列、およびヘッダーのサイズは、さまざまな要因によって変更されることがあります。  次の表にその要因を示します。  
+  
+|要因|Description|  
+|--------|-----------------|  
+|ユーザーによるサイズ変更|ユーザーは、行、列、またはヘッダーの区分線をドラッグまたはダブルクリックすることで、サイズを調整できます。|  
+|コントロールのサイズ変更|列フィル モードでは、コントロールが親フォームにドッキングしたり、ユーザーがフォームのサイズを変更したりすることでコントロールの幅が変わると、列幅も変更されます。|  
+|セルの値の変更|内容に基づいて自動的にサイズ変更するモードでは、新しい表示値に合わせてサイズが変更されます。|  
+|メソッドの呼び出し|プログラムによって内容に基づくサイズ変更を行う場合、メソッド呼び出し時のセルの値に合わせてサイズが調整されます。|  
+|プロパティの設定|高さと幅に特定の値を設定することもできます。|  
+  
+ 既定では、ユーザーによるサイズ変更は有効、自動サイズ変更は無効になっており、列幅よりも幅が大きいセル値は欠けた状態で表示されます。  
+  
+ 次の表に、既定の動作を調整する場合や、特定の目的に合わせて各サイズ変更オプションを使用する場合のシナリオを示します。  
+  
+|シナリオ|実装|  
+|----------|--------|  
+|列フィル モードを使用して、水平スクロール バーが表示されないようにコントロールの幅全体に比較的少数の列をすべて表示し、同程度のサイズのデータを表示する場合。|<xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode> に設定します。|  
+|列フィル モードを使用して、さまざまなサイズの表示値を表示する場合。|<xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode> に設定します。  列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティを設定するか、コントロールにデータが入力された後でコントロールの <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A> メソッドを呼び出して、相対的な列幅を初期化します。|  
+|列フィル モードを使用して、さまざまな重要度の値を表示する場合。|<xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode> に設定します。  データの一部を常に表示する必要がある列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> に大きい値を設定するか、特定の列にフィル モード以外のサイズ変更オプションを使用します。|  
+|列フィル モードを使用して、コントロールの背景色が表示されないようにする場合。|最終列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> に設定し、それ以外の列には他のサイズ変更オプションを使用します。  他の列が使用可能な領域を大量に使用している場合、最終列の <xref:System.Windows.Forms.DataGridViewColumn.MinimumWidth%2A> プロパティを設定します。|  
+|アイコンや ID などの固定幅の列を表示する場合。|その列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> を <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> に、<xref:System.Windows.Forms.DataGridViewColumn.Resizable%2A> を <xref:System.Windows.Forms.DataGridViewTriState> に設定します。  <xref:System.Windows.Forms.DataGridViewColumn.Width%2A> プロパティを設定するか、コントロールにデータが入力された後でコントロールの <xref:System.Windows.Forms.DataGridView.AutoResizeColumn%2A> メソッドを呼び出して、列の幅を初期化します。|  
+|セルの内容が変更されるたびに、表示が欠けず、スペースが最も有効に使用されるように、サイズを自動的に調整する場合。|自動サイズ変更のプロパティに、内容に基づくサイズ変更モードを表す値を設定します。  大量のデータを処理する場合にパフォーマンス低下を避けるには、表示されている行のみを計算するサイズ変更モードを使用します。|  
+|多数の行を処理する際のパフォーマンス低下を避けるために、表示されている行の値に合わせてサイズを調整する場合。|自動サイズ変更またはプログラムによるサイズ変更を指定する、適切なサイズ変更モード列挙値を使用します。  スクロール操作で新しく表示された行の値に合わせてサイズを調整するには、<xref:System.Windows.Forms.DataGridView.Scroll> イベント ハンドラーでサイズ変更メソッドを呼び出します。  ユーザーのダブルクリックによるサイズ変更を、表示されている行の値のみに合わせて新しいサイズが決定されるようにカスタマイズするには、<xref:System.Windows.Forms.DataGridView.RowDividerDoubleClick> イベント ハンドラーまたは <xref:System.Windows.Forms.DataGridView.ColumnDividerDoubleClick> イベント ハンドラーでサイズ変更メソッドを呼び出します。|  
+|パフォーマンス低下を避けるため、またはユーザーによるサイズ変更を有効にするために、セルの内容に合わせたサイズ調整を特定の場合に限定する場合。|イベント ハンドラーで、内容に基づくサイズ変更のメソッドを呼び出します。  たとえば、<xref:System.Windows.Forms.DataGridView.DataBindingComplete> イベントを使用して、バインディング後にサイズを初期化し、<xref:System.Windows.Forms.DataGridView.CellValidated> を処理したり、<xref:System.Windows.Forms.DataGridView.CellValueChanged> イベントを使用して、ユーザーによる編集やバインドされたデータ ソースの変更に対応してサイズを調整したりします。|  
+|複数行にわたる内容を持つセルが含まれる行の高さを調整する場合。|列幅を段落テキストの表示に適切なサイズにし、行の高さを内容に基づく自動サイズ変更またはプログラムによるサイズ変更を使用して調整します。  また、複数行の内容を含むセルは、セル スタイル <xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A> に値 <xref:System.Windows.Forms.DataGridViewTriState> を使用して表示します。<br /><br /> 通常は、行の高さを調整する前に、列の自動サイズ変更モードを使用して列幅を操作するか、列幅に特定の値を設定します。|  
+  
+## マウス操作によるサイズ変更  
+ 既定では、ユーザーは、セルの値に基づく自動サイズ変更モードを使用していない行、列、およびヘッダーのサイズを変更できます。  列フィル モードなど、それ以外のモードの場合にユーザーがサイズ変更できないようにするには、<xref:System.Windows.Forms.DataGridView> の次の 1 つまたは複数のプロパティを設定します。  
+  
+-   <xref:System.Windows.Forms.DataGridView.AllowUserToResizeColumns%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AllowUserToResizeRows%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeightSizeMode%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowHeadersWidthSizeMode%2A>  
+  
+ また、特定の行または列の <xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> プロパティを設定して、それらの行または列をユーザーがサイズ変更できないようにすることもできます。  既定では、<xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> プロパティの値は、列の <xref:System.Windows.Forms.DataGridView.AllowUserToResizeColumns%2A> プロパティの値、および行の <xref:System.Windows.Forms.DataGridView.AllowUserToResizeRows%2A> プロパティの値に基づいています。  ただし、<xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> を <xref:System.Windows.Forms.DataGridViewTriState> または <xref:System.Windows.Forms.DataGridViewTriState> に明示的に設定すると、その行または列のコントロール値は指定した値でオーバーライドされます。  継承の状態に戻すには、<xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> を <xref:System.Windows.Forms.DataGridViewTriState> に設定します。  
+  
+ <xref:System.Windows.Forms.DataGridViewTriState> により、値は継承された状態に戻るので、その行または列が <xref:System.Windows.Forms.DataGridView> コントロールに追加されていない場合を除き、<xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> プロパティの値として <xref:System.Windows.Forms.DataGridViewTriState> が返されることはありません。  行または列の <xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> プロパティが継承されているかどうかを調べる必要がある場合は、<xref:System.Windows.Forms.DataGridViewElement.State%2A> プロパティを確認します。  <xref:System.Windows.Forms.DataGridViewElement.State%2A> 値に <xref:System.Windows.Forms.DataGridViewElementStates> フラグが含まれている場合、<xref:System.Windows.Forms.DataGridViewBand.Resizable%2A> プロパティの値は継承されていません。  
+  
+## 自動サイズ変更  
+ <xref:System.Windows.Forms.DataGridView> コントロールの自動サイズ変更には、列フィル モードと、内容に基づく自動サイズ変更の 2 種類があります。  
+  
+ 列フィル モードでは、コントロール内のすべての表示可能列が、コントロールの表示領域の幅を埋めるように表示されます。  このモードの詳細については、「[Windows フォーム DataGridView コントロールの列フィル モード](../../../../docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ また、セルの内容に合わせて自動的にサイズ調整されるように、行、列、およびヘッダーを設定することもできます。  この場合は、セルの内容が変わるたびにサイズ調整が発生します。  
+  
+> [!NOTE]
+>  仮想モードを使用してセルの値をカスタム データ キャッシュに格納する場合、自動サイズ変更は、セルの値を編集すると発生しますが、キャッシュされた値を <xref:System.Windows.Forms.DataGridView.CellValuePushed> イベント ハンドラーの外部で変更しても発生しません。  この場合、<xref:System.Windows.Forms.DataGridView.UpdateCellValue%2A> メソッドを呼び出すことにより、コントロールがセルの表示を更新し、現在の自動サイズ変更モードを適用するように強制できます。  
+  
+ 内容に基づく自動サイズ変更が 1 次元のみ有効 \(行のみ有効で列は無効、または列のみ有効で行は無効\) な状態でも、<xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A> が有効だと、無効な側の次元が変更された場合にもサイズ調整が発生します。  たとえば、自動サイズ変更が行については有効で列については無効な場合に、<xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A> が有効だと、ユーザーが列の区分線をドラッグして列幅を変更すると、セルの内容が完全に表示されるように行の高さが自動的に調整されます。  
+  
+ 内容に基づくサイズ変更を行と列の両方について設定し、<xref:System.Windows.Forms.DataGridViewCellStyle.WrapMode%2A> を有効にした場合は、セルの内容が変わるたびに <xref:System.Windows.Forms.DataGridView> コントロールで自動的にサイズが調整され、新しいサイズの計算時には最適なセルの高さと幅の比率が使用されます。  
+  
+ コントロールの値をオーバーライドしないでヘッダー、行、および列のサイズ変更モードを設定するには、次のいずれかの <xref:System.Windows.Forms.DataGridView> プロパティを設定します。  
+  
+-   <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeightSizeMode%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowHeadersWidthSizeMode%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoSizeRowsMode%2A>  
+  
+ 特定の列についてコントロールの列サイズ変更モードをオーバーライドするには、その列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティを <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> 以外の値に設定します。  列のサイズ変更モードは、実際にはその列の <xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A> プロパティによって決まります。  このプロパティの値は、列の <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A> プロパティの値に基づきますが、これが <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> の場合にはコントロールの <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A> 値が継承されます。  
+  
+ 内容に基づく自動サイズ変更の使用は、大量のデータを処理する場合には注意が必要です。  パフォーマンス低下を避けるには、コントロール内のすべての行を分析してサイズを計算する自動サイズ変更モードではなく、表示されている行のみに基づく自動サイズ変更モードを使用します。  パフォーマンスを最大にするには、プログラムによるサイズ変更を使用して、新しいデータが読み込まれた直後などのタイミングを指定してサイズ変更してください。  
+  
+ 内容に基づく自動サイズ変更モードは、行または列の <xref:System.Windows.Forms.DataGridViewBand.Visible%2A> プロパティ、あるいはコントロールの <xref:System.Windows.Forms.DataGridView.RowHeadersVisible%2A> プロパティまたは <xref:System.Windows.Forms.DataGridView.ColumnHeadersVisible%2A> プロパティを `false` に設定して非表示にしている行、列、またはヘッダーには機能しません。  たとえば、大きいセル値に合わせて列のサイズが自動的に変更された後でその列を非表示にすると、その大きいセル値を含む行が削除されても非表示列のサイズは変わりません。  表示と非表示を切り替えても自動サイズ変更は発生しません。したがって、列の <xref:System.Windows.Forms.DataGridViewColumn.Visible%2A> プロパティを `true` に戻しても、現在の内容に基づくサイズの再計算は行われません。  
+  
+ プログラムによって内容に基づくサイズ変更を行う場合、その変更は、表示されるかどうかに関係なく、行、列、およびヘッダーに作用します。  
+  
+## プログラムによるサイズ変更  
+ 自動サイズ変更が無効の場合、プログラムで次のプロパティを使用して、行、列、またはヘッダーの幅や高さを厳密に設定できます。  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowHeadersWidth%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeight%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.DataGridViewRow.Height%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.DataGridViewColumn.Width%2A?displayProperty=fullName>  
+  
+ また、プログラムで次のメソッドを使用して、行、列、およびヘッダーのサイズをその内容に合わせて変更できます。  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeColumn%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeColumnHeadersHeight%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeRow%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeRows%2A>  
+  
+-   <xref:System.Windows.Forms.DataGridView.AutoResizeRowHeadersWidth%2A>  
+  
+ これらのメソッドは、行、列、またはヘッダーのサイズを継続的に設定するのではなく、そのとき 1 度だけ変更します。  新しいサイズは、セルの内容すべてが欠けることなく表示されるように自動的に計算されます。  ただし、<xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A> プロパティの値が <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode> の列のサイズをプログラムによって変更すると、内容に基づいて計算された幅を使用して列の <xref:System.Windows.Forms.DataGridViewColumn.FillWeight%2A> プロパティの値の比率が調整され、実際の列幅は、その新しい比率に応じてすべての列がコントロールの表示可能領域に収まるように計算されます。  
+  
+ プログラムによるサイズ変更は、頻繁なサイズ変更によるパフォーマンス低下を避けるのに役立ちます。  また、ユーザーによる行、列、およびヘッダーのサイズ変更が可能な場合や、列フィル モードを使用する場合の初期サイズを決めるのにも役立ちます。  
+  
+ 通常、プログラムでは、特定のタイミングでサイズ変更のメソッドを呼び出します。  たとえば、データ読み込み直後にプログラムによってすべての列のサイズを変更したり、特定のセルの値が変更された後にプログラムによって行のサイズを変更したりします。  
+  
+## 内容に基づくサイズ変更動作のカスタマイズ  
+ 派生した <xref:System.Windows.Forms.DataGridView> のセル、行、および列の種類を操作する場合、サイズ変更の動作は、派生した <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridViewCell.GetPreferredSize%2A?displayProperty=fullName>、<xref:System.Windows.Forms.DataGridViewRow.GetPreferredHeight%2A?displayProperty=fullName>、または <xref:System.Windows.Forms.DataGridViewColumn.GetPreferredWidth%2A?displayProperty=fullName> の各メソッドをオーバーライドすることによって、またはコントロールのサイズ変更のプロテクト メソッドのオーバーロードを呼び出すことによって、カスタマイズできます。  サイズ変更のプロテクト メソッドのオーバーロードは、組み合わせて使用することでセルの高さと幅の最適な比率が得られるようにデザインされており、これによって極端に長いまたは高いセルが作成されることを回避できます。  たとえば、<xref:System.Windows.Forms.DataGridView.AutoResizeRows%2A> メソッドの `AutoResizeRows(DataGridViewAutoSizeRowsMode,Boolean)` オーバーロードを呼び出し、<xref:System.Boolean> パラメーターに `false` を渡すと、このオーバーロードはその行のセルの最適な高さと幅を計算しますが、行の高さだけを調整します。  計算された最適なサイズに列幅を調整するには、この後で <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A> メソッドを呼び出す必要があります。  
+  
+## 内容に基づくサイズ変更のオプション  
+ サイズ変更に関するプロパティとメソッドで使用する列挙体には、内容に基づくサイズ変更と同様の値が使用されます。  これらの値を使用して、適切なサイズを計算する際にどのセルを使用するかを制限できます。  サイズ変更の列挙体では、表示されているセルを表す名前の値を指定することで、サイズを計算する基準を表示されている行のセルに限定できます。  大量の行を処理する場合には、行を除外することはパフォーマンス低下を避けるのに役立ちます。  また、ヘッダーのセルまたはヘッダー以外のセルの値のみに計算を限定することもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToResizeColumns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AllowUserToResizeRows%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeightSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowHeadersWidthSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewBand.Resizable%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoSizeColumnsMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoSizeRowsMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.AutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.InheritedAutoSizeMode%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.RowHeadersWidth%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.ColumnHeadersHeight%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewRow.Height%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewColumn.Width%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumn%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumns%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeColumnHeadersHeight%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRow%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRows%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridView.AutoResizeRowHeadersWidth%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeRowMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeRowsMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnMode>   
+ <xref:System.Windows.Forms.DataGridViewAutoSizeColumnsMode>   
+ <xref:System.Windows.Forms.DataGridViewColumnHeadersHeightSizeMode>   
+ <xref:System.Windows.Forms.DataGridViewRowHeadersWidthSizeMode>   
+ [Windows フォーム DataGridView コントロール内の列と行のサイズ変更](../../../../docs/framework/winforms/controls/resizing-columns-and-rows-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールの列フィル モード](../../../../docs/framework/winforms/controls/column-fill-mode-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのサイズ変更モードを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-sizing-modes-of-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/sort-and-filter-ado-net-data-with-wf-bindingsource-component.md b/docs/framework/winforms/controls/sort-and-filter-ado-net-data-with-wf-bindingsource-component.md
new file mode 100644
index 00000000000..7fd4df766a4
--- /dev/null
+++ b/docs/framework/winforms/controls/sort-and-filter-ado-net-data-with-wf-bindingsource-component.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える/フィルター処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ADO.NET [Windows フォーム]"
+  - "BindingSource コンポーネント [Windows フォーム], 並べ替えとフィルター処理 (データを)"
+  - "データ [Windows フォーム], フィルター処理"
+  - "データ [Windows フォーム], 並べ替え"
+  - "データの並べ替え, ADO.NET"
+  - "フィルター処理 [Windows フォーム], ADO.NET"
+  - "並べ替え (データの)"
+ms.assetid: 6c206daf-d706-4602-9dbe-435343052063
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える/フィルター処理する
+<xref:System.Windows.Forms.BindingSource.Sort%2A> プロパティと <xref:System.Windows.Forms.BindingSource.Filter%2A> プロパティを使用して、<xref:System.Windows.Forms.BindingSource> コントロールの並べ替え機能とフィルター機能を公開できます。  基になるデータ ソースが <xref:System.ComponentModel.IBindingList> のときは単純な並べ替えを適用できます。また、データ ソースが <xref:System.ComponentModel.IBindingListView> のときはフィルター処理と高度な並べ替えを適用できます。  <xref:System.Windows.Forms.BindingSource.Sort%2A> プロパティは、標準の [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] 構文を必要とします。この構文では、データ ソース内のデータ列の名前を表す文字列に続けて、リストの並べ替えを昇順、降順のどちらで行うかを示す `ASC` または `DESC` を指定します。  高度な並べ替えや複数列の並べ替えを設定するには、コンマ \(区切り記号\) で各列を区切ります。  <xref:System.Windows.Forms.BindingSource.Filter%2A> プロパティには文字列式を設定します。  
+  
+> [!NOTE]
+>  接続文字列内にパスワードなどの機密情報を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+### BindingSource を使用してデータをフィルター処理するには  
+  
+-   <xref:System.Windows.Forms.BindingSource.Filter%2A> プロパティを任意の式に設定します。  
+  
+     列名とその列に指定する値を次のコード例に示します。  
+  
+ [!code-csharp[System.Windows.Forms.DataConnectorFilterAndSort#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/CS/form1.cs#11)]
+ [!code-vb[System.Windows.Forms.DataConnectorFilterAndSort#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/VB/form1.vb#11)]  
+  
+### BindingSource を使用してデータを並べ替えるには  
+  
+1.  <xref:System.Windows.Forms.BindingSource.Sort%2A> プロパティを設定します。任意の列名に続けて、昇順または降順を示す `ASC` または `DESC` を指定してください。  
+  
+2.  複数の列を指定するときは、コンマで区切ります。  
+  
+ [!code-csharp[System.Windows.Forms.DataConnectorFilterAndSort#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/CS/form1.cs#12)]
+ [!code-vb[System.Windows.Forms.DataConnectorFilterAndSort#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/VB/form1.vb#12)]  
+  
+## 使用例  
+ Northwind サンプル データベースの顧客テーブルから <xref:System.Windows.Forms.DataGridView> コントロールにデータを読み込み、表示データのフィルター処理および並べ替えを行う方法を次のコード例に示します。  
+  
+ [!code-csharp[System.Windows.Forms.DataConnectorFilterAndSort#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/CS/form1.cs#1)]
+ [!code-vb[System.Windows.Forms.DataConnectorFilterAndSort#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataConnectorFilterAndSort/VB/form1.vb#1)]  
+  
+## コードのコンパイル  
+ この例を実行するには、`BindingSource1` という名前の <xref:System.Windows.Forms.BindingSource> および `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> を含むフォームにコードを貼り付けます。  次に、フォームの <xref:System.Windows.Forms.Form.Load> イベントを処理し、Load イベント ハンドラー メソッド内で `InitializeSortedFilteredBindingSource` を呼び出します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.BindingSource.Sort%2A>   
+ <xref:System.Windows.Forms.BindingSource.Filter%2A>   
+ [方法 : サンプル データベースをインストールする](../Topic/How%20to:%20Install%20Sample%20Databases.md)   
+ [BindingSource コンポーネント](../../../../docs/framework/winforms/controls/bindingsource-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md b/docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md
new file mode 100644
index 00000000000..0c3a1fabdd3
--- /dev/null
+++ b/docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CheckedListBox コントロール [Windows フォーム], 並べ替え"
+  - "コンボ ボックス, 並べ替え (内容の)"
+  - "ComboBox コントロール [Windows フォーム], 並べ替え (内容の)"
+  - "リスト ボックス, 並べ替え (内容の)"
+  - "ListBox コントロール [Windows フォーム], 並べ替え (内容の)"
+ms.assetid: c268e387-3d1d-4d86-a940-19f6673c8d06
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える
+Windows フォームのコントロールは、データ連結されているときには並べ替えができません。  並べ替えたデータを表示するには、並べ替えがサポートされているデータ ソースを使用して、並べ替えを行います。  並べ替えがサポートされているデータ ソースには、データ ビュー、データ ビュー マネージャー、および並べ替えられた配列があります。  
+  
+ コントロールがデータ バインドされていない場合、並べ替えができます。  
+  
+### リストを並べ替えるには  
+  
+1.  `Sorted`  プロパティを `true` に設定します。  
+  
+     この設定によって、既存のリスト項目はすべて並べ替えの順序に従って移動されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ <xref:System.Windows.Forms.ListBox>   
+ <xref:System.Windows.Forms.CheckedListBox>   
+ [Windows フォームでのデータ バインド](../../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)   
+ [ListBox の代わりに Windows フォーム ComboBox を使用する場合](../../../../docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..840081209ed
--- /dev/null
+++ b/docs/framework/winforms/controls/sorting-data-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,53 @@
+---
+title: "Windows フォームの DataGridView コントロールでのデータの並べ替え | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 並べ替え (グリッド内の)"
+  - "データ グリッド, 並べ替え (データの)"
+  - "DataGridView コントロール [Windows フォーム], 並べ替え (データの)"
+ms.assetid: c1d4f24c-d961-4181-809d-5a5caa6122e4
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームの DataGridView コントロールでのデータの並べ替え
+既定では、`DataGridView` コントロールのデータは、テキスト ボックス列のヘッダーをユーザーがクリックすることによって並べ替えることができます。  必要性がある場合には、特定の列の `SortMode` プロパティを変更することにより、他の列型に基づいてユーザーが並べ替えを実行できるようになります。  また、任意の列または複数列に基づいて、データをプログラムで並べ替えることもできます。  
+  
+## このセクションの内容  
+ [Windows フォーム DataGridView コントロール内の列の並べ替えモード](../../../../docs/framework/winforms/controls/column-sort-modes-in-the-windows-forms-datagridview-control.md)  
+ コントロールのデータの並べ替えのオプションについて説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロール内の列の並べ替えモードを設定する](../../../../docs/framework/winforms/controls/set-the-sort-modes-for-columns-wf-datagridview-control.md)  
+ 既定では並べ替えできない列に基づいてユーザーが並べ替えを実行できるようにする方法を説明します。  
+  
+ [方法 : Windows フォーム DataGridView コントロールの並べ替え機能をカスタマイズする](../../../../docs/framework/winforms/controls/how-to-customize-sorting-in-the-windows-forms-datagridview-control.md)  
+ データをプログラムで並べ替える方法、および <xref:System.Windows.Forms.DataGridView.SortCompare?displayProperty=fullName> イベントの使用または <xref:System.Collections.IComparer> インターフェイスの実装によって並べ替えをカスタマイズする方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridView.Sort%2A?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridView.Sort%2A> メソッドの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A?displayProperty=fullName>  
+ <xref:System.Windows.Forms.DataGridViewColumn.SortMode%2A> プロパティの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.DataGridViewColumnSortMode>  
+ <xref:System.Windows.Forms.DataGridViewColumnSortMode> 列挙体の参照ドキュメントを提供します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)   
+ [Windows フォーム DataGridView コントロールの列型](../../../../docs/framework/winforms/controls/column-types-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/soundplayer-class-overview.md b/docs/framework/winforms/controls/soundplayer-class-overview.md
new file mode 100644
index 00000000000..4ad94013a13
--- /dev/null
+++ b/docs/framework/winforms/controls/soundplayer-class-overview.md
@@ -0,0 +1,48 @@
+---
+title: "SoundPlayer クラスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "SoundPlayer クラスのサウンドを再生"
+  - "SoundPlayer クラスの概要の SoundPlayer クラス"
+  - "サウンドの再生"
+ms.assetid: fcebb938-62b9-4677-9cbe-6465bc863e22
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# SoundPlayer クラスの概要
+<xref:System.Media.SoundPlayer>クラスでは、アプリケーションにサウンドを簡単に追加することができます。  
+  
+ <xref:System.Media.SoundPlayer>クラスは、.wav 形式、リソースとは UNC または HTTP の場所からのサウンド ファイルを再生できます。 さらに、 <xref:System.Media.SoundPlayer>クラスを使用すると、読み込みまたは非同期的にサウンドを再生します。  
+  
+ 使用することも、 <xref:System.Media.SystemSounds>ビープ音を含む、共通のシステム サウンドを再生するクラス。  
+  
+## <a name="commonly-used-properties-methods-and-events"></a>一般的に使用されるプロパティ、メソッド、およびイベント  
+  
+|名前|説明|  
+|----------|-----------------|  
+|<xref:System.Media.SoundPlayer.SoundLocation%2A>プロパティ|ファイル パスまたはサウンドの Web アドレス。 使用可能な値には、UNC または HTTP を指定できます。|  
+|<xref:System.Media.SoundPlayer.LoadTimeout%2A>プロパティ|プログラムが前に、サウンドの読み込みを待機するミリ秒数では、例外をスローします。 既定値は 10 秒です。|  
+|<xref:System.Media.SoundPlayer.IsLoadCompleted%2A>プロパティ|サウンドの読み込みが終了するかどうかを示すブール値。|  
+|<xref:System.Media.SoundPlayer.Load%2A>メソッド|サウンドを同期的に読み込まれます。|  
+|<xref:System.Media.SoundPlayer.LoadAsync%2A>メソッド|サウンドを非同期的に読み込みを開始します。 読み込みが完了したらを生成、 <xref:System.Media.SoundPlayer.OnLoadCompleted%2A>イベントです。|  
+|<xref:System.Media.SoundPlayer.Play%2A>メソッド|指定したサウンドを再生して、 <xref:System.Media.SoundPlayer.SoundLocation%2A>または<xref:System.Media.SoundPlayer.Stream%2A>新しいスレッドのプロパティです。|  
+|<xref:System.Media.SoundPlayer.PlaySync%2A>メソッド|指定したサウンドを再生して、 <xref:System.Media.SoundPlayer.SoundLocation%2A>または<xref:System.Media.SoundPlayer.Stream%2A>現在のスレッドのプロパティです。|  
+|<xref:System.Media.SoundPlayer.Stop%2A>メソッド|再生されているすべてのサウンドを停止します。|  
+|<xref:System.Media.SoundPlayer.LoadCompleted>イベント|サウンドの読み込みを試みた後に発生します。|  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Media.SoundPlayer>   
+ <xref:System.Media.SystemSounds>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/soundplayer-class.md b/docs/framework/winforms/controls/soundplayer-class.md
new file mode 100644
index 00000000000..3d165d3b47c
--- /dev/null
+++ b/docs/framework/winforms/controls/soundplayer-class.md
@@ -0,0 +1,64 @@
+---
+title: "SoundPlayer クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "SoundPlayer"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "SoundPlayer クラス"
+  - "サウンド, 再生"
+ms.assetid: f3945af9-045c-4e2d-b251-377c37ca2d77
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# SoundPlayer クラス
+`SoundPlayer` クラスを使用すると、アプリケーションにサウンドを簡単に組み込むことができます。  
+  
+ <xref:System.Media.SystemSounds> クラスを使用して、ビープ音を含む、共通のシステム サウンドを再生することもできます。  
+  
+## このセクションの内容  
+ [SoundPlayer クラスの概要](../../../../docs/framework/winforms/controls/soundplayer-class-overview.md)  
+ クラスの概要と、一般的に使用するプロパティ、メソッド、イベントについて説明します。  
+  
+ [方法 : Windows フォームからサウンドを再生する](../../../../docs/framework/winforms/controls/how-to-play-a-sound-from-a-windows-form.md)  
+ ファイル パス、UNC パス、または HTTP パスで指定したサウンドを再生するコードを示します。  
+  
+ [方法 : Windows フォームからビープ音を再生する](../../../../docs/framework/winforms/controls/how-to-play-a-beep-from-a-windows-form.md)  
+ コンピューターのビープ音を再生するコードを示します。  
+  
+ [方法 : Windows フォームからリソースに埋め込まれたサウンドを再生する](../../../../docs/framework/winforms/controls/how-to-play-a-sound-embedded-in-a-resource-from-a-windows-form.md)  
+ リソースからサウンドを再生するコードを示します。  
+  
+ [方法 : Windows フォームからシステム サウンドを再生する](../../../../docs/framework/winforms/controls/how-to-play-a-system-sound-from-a-windows-form.md)  
+ いずれかのシステム サウンドを再生するコードを示します。  
+  
+ [方法 : Windows フォーム内でサウンドを非同期的に読み込む](../../../../docs/framework/winforms/controls/how-to-load-a-sound-asynchronously-within-a-windows-form.md)  
+ URL からサウンドを非同期で読み込んで再生するコードを示します。  
+  
+ [方法 : Windows フォームでサウンドの再生をループする](../../../../docs/framework/winforms/controls/how-to-loop-a-sound-playing-on-a-windows-form.md)  
+ サウンドを繰り返し再生するコードを示します。  
+  
+## 関連項目  
+ <xref:System.Media.SoundPlayer>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ Windows フォーム専用にデザインされたコントロールに関するトピックへのリンクを示します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ 「[My.Computer オブジェクト](http://msdn.microsoft.com/library/11bxex12\(v=vs.110\))」または「[My.Computer オブジェクト](http://msdn.microsoft.com/library/11bxex12\(v=vs.120\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md b/docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md
new file mode 100644
index 00000000000..0748f368e31
--- /dev/null
+++ b/docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, 既定値 (新しい行の)"
+  - "DataGridView コントロール [Windows フォーム], データ エントリ"
+  - "DataGridView コントロール [Windows フォーム], 既定値 (新しい行の)"
+  - "行, 指定 (既定値を)"
+ms.assetid: 8d127963-d9f8-4e4e-9f7f-beb66688f1f2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する
+新しく追加された行にアプリケーションが既定値を読み込むことでデータ入力を簡素化できます。  <xref:System.Windows.Forms.DataGridView> クラスを使用すると、<xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded> イベントで既定値を読み込むことができます。  このイベントは、ユーザーが新しいレコード用の行を入力すると発生します。  コードでこのイベントを処理すると、任意のセルに任意に選択した値を読み込むことができます。  
+  
+ <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded> イベントを使用して新しい行に既定値を指定する方法を次のコード例に示します。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#120](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#120)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#120](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#120)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   一意の `CustomerID` 値を生成する `NewCustomerId` 関数。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールにおける新規レコード行の使用](../../../../docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/splitcontainer-control-overview-windows-forms.md b/docs/framework/winforms/controls/splitcontainer-control-overview-windows-forms.md
new file mode 100644
index 00000000000..bc658588eb0
--- /dev/null
+++ b/docs/framework/winforms/controls/splitcontainer-control-overview-windows-forms.md
@@ -0,0 +1,64 @@
+---
+title: "SplitContainer コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "SplitContainer"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "SplitContainer コントロール [Windows フォーム], SplitContainer コントロールの概要"
+ms.assetid: 6de5a5f7-97a5-402d-be6d-7e2785483db5
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# SplitContainer コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.SplitContainer> コントロールは、移動できるバーによって分割された 2 つのパネルから成る複合コントロールと考えることができます。  マウス ポインターをバーの上に置くと、ポインターが変形し、そのバーを移動できることが示されます。  
+  
+> [!IMPORTANT]
+>  **ツールボックス**では、以前のバージョンの [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] で使用されていた <xref:System.Windows.Forms.Splitter> コントロールが、<xref:System.Windows.Forms.SplitContainer> コントロールに置き換えられました。  <xref:System.Windows.Forms.SplitContainer> コントロールの優先度は、<xref:System.Windows.Forms.Splitter> コントロールよりもかなり高くなります。  <xref:System.Windows.Forms.Splitter> クラスは、既存のアプリケーションとの互換性を確保するために、引き続き [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] に含まれていますが、新しいプロジェクトに対しては、<xref:System.Windows.Forms.SplitContainer> コントロールを使用することを強くお勧めします。  
+  
+ <xref:System.Windows.Forms.SplitContainer> コントロールを使用すると、複雑なユーザー インターフェイスを作成できます。多くの場合、1 つのパネルで選択した項目によって、他のパネルで表示されるオブジェクトが決まります。  この配置は、情報の表示と参照には非常に有効です。  2 つのパネルを用意することで、領域に情報を集約でき、さらに、バーまたは "分割線" により、ユーザーが簡単にパネルのサイズを変更できます。  
+  
+ 第 2 の <xref:System.Windows.Forms.SplitContainer> コントロールを水平方向に配置した状態で、複数の <xref:System.Windows.Forms.SplitContainer> コントロールを入れ子にして、上部のパネルと下部のパネルを作成することもできます。  
+  
+ 既定では、<xref:System.Windows.Forms.SplitContainer> コントロールにはキーボードからアクセスできます。<xref:System.Windows.Forms.SplitContainer.IsSplitterFixed%2A> プロパティが `false` に設定されていれば、ユーザーは方向キーを押して分割線を移動できます。  
+  
+ <xref:System.Windows.Forms.SplitContainer> コントロールの <xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティは、コントロール自体の方向ではなく、分割線の方向を指定します。  そのため、このプロパティが <xref:System.Windows.Forms.Orientation> に設定されているときは、上から下に向かって分割線が作成され、左パネルと右パネルが作成されます。  
+  
+ また、<xref:System.Windows.Forms.SplitContainer.SplitterRectangle%2A> プロパティの値は、<xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティの値に応じて決定されることに注意してください。  詳細については、「<xref:System.Windows.Forms.SplitContainer.SplitterRectangle%2A> プロパティ」を参照してください。  
+  
+ <xref:System.Windows.Forms.SplitContainer> コントロールのサイズと移動を制限することもできます。  <xref:System.Windows.Forms.SplitContainer.FixedPanel%2A> プロパティでは、<xref:System.Windows.Forms.SplitContainer> コントロールのサイズを変更した後に同じサイズのままで維持するパネルが決定され、<xref:System.Windows.Forms.SplitContainer.IsSplitterFixed%2A> プロパティでは、分割線がキーボードまたはマウスによって移動できるかどうかが決定されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.SplitContainer.IsSplitterFixed%2A> プロパティが `true` に設定されている場合でも、<xref:System.Windows.Forms.SplitContainer.SplitterDistance%2A> プロパティを使用するなどの方法で、プログラムによって分割線を移動させることができます。  
+  
+ 最後に、<xref:System.Windows.Forms.SplitContainer> コントロールの各パネルには、個々のサイズを決定するプロパティが用意されています。  
+  
+## 一般的に使用されるプロパティ、メソッド、およびイベント  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.SplitContainer.FixedPanel%2A> プロパティ|<xref:System.Windows.Forms.SplitContainer> コントロールのサイズを変更した後に同じサイズのままで維持するパネルを決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.IsSplitterFixed%2A> プロパティ|分割線がキーボードまたはマウスによって移動できるかどうかを決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.Orientation%2A> プロパティ|分割線を垂直方向と水平方法のどちらで配置するかを決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterDistance%2A> プロパティ|左端または上端から移動できる分割バーまでの距離 \(ピクセル単位\) を決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterIncrement%2A> プロパティ|ユーザーが分割線を移動できる最小距離 \(ピクセル単位\) を決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterWidth%2A> プロパティ|分割線の幅 \(ピクセル単位\) を決定します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterMoving> イベント|分割線の移動中に発生します。|  
+|<xref:System.Windows.Forms.SplitContainer.SplitterMoved> イベント|分割線の移動後に発生します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [SplitContainer コントロール](../../../../docs/framework/winforms/controls/splitcontainer-control-windows-forms.md)   
+ [SplitContainer Control Sample](http://msdn.microsoft.com/ja-jp/9015fad0-7108-4d85-a83a-a72d038c4f65)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/splitcontainer-control-windows-forms.md b/docs/framework/winforms/controls/splitcontainer-control-windows-forms.md
new file mode 100644
index 00000000000..0a694e55fa5
--- /dev/null
+++ b/docs/framework/winforms/controls/splitcontainer-control-windows-forms.md
@@ -0,0 +1,56 @@
+---
+title: "SplitContainer コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "SplitContainer コントロール [Windows フォーム]"
+  - "分割ウィンドウ"
+ms.assetid: 2e36f17f-5c39-4fb4-bb09-7ce3ef823402
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# SplitContainer コントロール (Windows フォーム)
+Windows フォームの `SplitContainer` コントロールは複合と考えることができ、移動可能なバーで区切られた 2 つのパネルです。  マウス ポインターがバーの上に移動すると、ポインターの形が変わり、バーが移動可能であることを示します。  
+  
+> [!NOTE]
+>  **ツールボックス** では、このコントロールが以前のバージョンの Visual Studio に存在した <xref:System.Windows.Forms.Splitter> コントロールを置き換えます。  `SplitContainer` コントロールは <xref:System.Windows.Forms.Splitter> コントロールより優先されます。  <xref:System.Windows.Forms.Splitter> クラスは、既存のアプリケーションの互換性のために .NET Framework に含まれていますが、新しいプロジェクトでは `SplitContainer` コントロールを使用することを強くお勧めします。  
+  
+ `SplitContainer` コントロールでは複雑なユーザー インターフェイスを作成できます。多くの場合、1 つのパネルの選択項目が、もう一方のパネルに表示されるオブジェクトを決定します。  この配置は、情報の表示と参照に対して非常に効果的です。  2 つのパネルを使用することで、情報を領域に集約でき、バーまたは「分割」により、ユーザーがパネルを簡単にサイズ変更できます。  
+  
+## このセクションの内容  
+ [SplitContainer コントロールの概要](../../../../docs/framework/winforms/controls/splitcontainer-control-overview-windows-forms.md)  
+ `SplitContainer` コントロールを導入し、一般的に使用されるプロパティ、メソッド、およびイベントについて説明します。  
+  
+ [方法 : 分割ウィンドウでのサイズ変更および位置指定動作を定義する](../../../../docs/framework/winforms/controls/how-to-define-resize-and-positioning-behavior-in-a-split-window.md)  
+ `SplitContainer` コントロール内のスプリッターを制御する方法について説明します。  
+  
+ [方法 : ウィンドウを水平方向に分割する](../../../../docs/framework/winforms/controls/how-to-split-a-window-horizontally.md)  
+ `SplitContainer` コントロール内のスプリッターの方向を制御する方法について説明します。  
+  
+ [方法 : Windows フォームでマルチペイン ユーザー インターフェイスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-multipane-user-interface-with-windows-forms.md)  
+ Microsoft Outlook で使用されるような複数ペインのユーザー インターフェイスを作成します。  
+  
+ 「[方法 : デザイナーを使用してウィンドウを水平方向に分割する](http://msdn.microsoft.com/library/ms233667\(v=vs.110\))」、「[方法 : Windows フォームで Windows エクスプローラー スタイルのインターフェイスを作成する](http://msdn.microsoft.com/library/zh2fe5a5\(v=vs.110\))」、「[方法 : デザイナーを使用して Windows フォームでマルチペイン ユーザー インターフェイスを作成する](http://msdn.microsoft.com/library/ms233661\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.SplitContainer> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォーム コントロール](../../../../docs/framework/winforms/controls/index.md)  
+ Windows フォームでの操作専用に設計されているコントロールについてのトピックへのリンクを提供します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/splitter-control-overview-windows-forms.md b/docs/framework/winforms/controls/splitter-control-overview-windows-forms.md
new file mode 100644
index 00000000000..f971fe94226
--- /dev/null
+++ b/docs/framework/winforms/controls/splitter-control-overview-windows-forms.md
@@ -0,0 +1,37 @@
+---
+title: "Splitter コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Splitter"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Splitter コントロール [Windows フォーム], Splitter コントロールの概要"
+ms.assetid: e2b6ab83-dfdd-40ec-9762-850702c82dcb
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Splitter コントロールの概要 (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.SplitContainer> コントロールは、以前のバージョンの <xref:System.Windows.Forms.Splitter> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.Splitter> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.Splitter> コントロールを使用すると、ドッキングされたコントロールのサイズを実行時に変更できます。  通常、<xref:System.Windows.Forms.Splitter> コントロールは、さまざまな長さのデータが表示されるコントロールのあるフォーム上で使用します。たとえば、エクスプローラーのデータ ペインには、状況に応じて異なる幅の情報が含まれています。  
+  
+## Splitter コントロールの操作  
+ Splitter コントロールによってサイズ変更できるコントロール内で、ドッキングされていない端にユーザーがマウス ポインターを置くと、ポインターが変形し、このコントロールのサイズを変更できることが示されます。  Splitter コントロールを使用すると、そのすぐ前にあるドッキングされたコントロールをユーザーがサイズ変更できるようになります。  このため、ドッキングされたコントロールのサイズを実行時にユーザーが変更できるようにするには、サイズ変更するコントロールをコンテナーの端にドッキングしてから、コンテナーの同じ側に Splitter コントロールをドッキングする必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.SplitContainer>   
+ [方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)   
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/splitter-control-windows-forms.md b/docs/framework/winforms/controls/splitter-control-windows-forms.md
new file mode 100644
index 00000000000..fa42b481925
--- /dev/null
+++ b/docs/framework/winforms/controls/splitter-control-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "Splitter コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マルチ ビュー"
+  - "Splitter コントロール [Windows フォーム]"
+  - "ビュー, 複数 (フレームあたり)"
+ms.assetid: 6f287407-e895-4b07-a46a-a5bff8388d46
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Splitter コントロール (Windows フォーム)
+Windows フォームの `Splitter` コントロールを使用すると、ドッキングされたコントロールのサイズを実行時に変更できます。  通常、`Splitter` コントロールは、さまざまな長さのデータが表示されるコントロールのあるフォーム上で使用します。たとえば、エクスプローラーのデータ ペインには、状況に応じて異なる幅の情報が含まれています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.SplitContainer> コントロールは、以前のバージョンの `Splitter` コントロールに代わると共に追加の機能を提供します。ただし、`Splitter` コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+## このセクションの内容  
+ [Splitter コントロールの概要](../../../../docs/framework/winforms/controls/splitter-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Splitter> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md b/docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md
new file mode 100644
index 00000000000..deba4169f5e
--- /dev/null
+++ b/docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md
@@ -0,0 +1,40 @@
+---
+title: "StatusBar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "StatusBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー"
+  - "StatusBar コントロール [Windows フォーム], StatusBar コントロールの概要"
+ms.assetid: b7b9852c-633d-4416-bb2e-94852b989c6c
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# StatusBar コントロールの概要 (Windows フォーム)
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.StatusStrip> コントロールと <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールは、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ Windows フォームの [StatusBar コントロール](../../../../docs/framework/winforms/controls/statusbar-control-windows-forms.md) 、フォーム上で領域として使用され、通常はウィンドウの下端に表示されます。アプリケーションは、このコントロールにさまざまなステータス情報を表示できます。  <xref:System.Windows.Forms.StatusBar> コントロールでは、コントロール上にステータス バー パネルを用意できます。このパネルでは、状態を示すテキストやアイコン、またはプロセスが進行中であることを伝えるアニメーション化された一連のアイコンを表示します。たとえば、[!INCLUDE[ofprword](../../../../includes/ofprword-md.md)] では、文書が保存中であることが表示されます。  
+  
+## StatusBar コントロールの使用  
+ Internet Explorer では、マウスがハイパーリンクの上に置かれたときに、ステータス バーにページの URL が表示されます。[!INCLUDE[ofprword](../../../../includes/ofprword-md.md)] では、ページ番号、セクション番号、および、上書きや変更履歴などの編集モードの情報が表示されます。[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] では、ドッキング可能なウィンドウの操作方法 \(ドッキングと切り離し\) など、状況に応じた情報がステータス バーに表示されます。  
+  
+ <xref:System.Windows.Forms.StatusBar.ShowPanels%2A> プロパティに `false` \(既定値\) を設定し、表示するテキストをステータス バーの <xref:System.Windows.Forms.StatusBar.Text%2A> プロパティに設定することで、ステータス バーにメッセージを表示できます。  <xref:System.Windows.Forms.StatusBar.ShowPanels%2A> プロパティに `true` を設定し、<xref:System.Windows.Forms.StatusBar.StatusBarPanelCollection> の <xref:System.Windows.Forms.StatusBar.StatusBarPanelCollection.Add%2A> メソッドを使用することで、ステータス バーを複数のパネルに分割して、複数の種類の情報を表示できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusBar>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](../../../../docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/statusbar-control-windows-forms.md b/docs/framework/winforms/controls/statusbar-control-windows-forms.md
new file mode 100644
index 00000000000..d163bffa0b1
--- /dev/null
+++ b/docs/framework/winforms/controls/statusbar-control-windows-forms.md
@@ -0,0 +1,55 @@
+---
+title: "StatusBar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー, 作成"
+  - "StatusBar コントロール [Windows フォーム]"
+ms.assetid: 6f543e27-cf78-4b7f-b4d0-6a8030155d48
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# StatusBar コントロール (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.StatusBar> コントロールは、フォーム上で領域として使用され、通常はウィンドウの下端に表示されます。アプリケーションは、このコントロールにさまざまなステータス情報を表示できます。  <xref:System.Windows.Forms.StatusBar> コントロールでは、コントロール上にステータス バー パネルを用意できます。このパネルでは、状態を示すアイコン、またはプロセスが進行中であることを伝えるアニメーション化された一連のアイコンを表示します。たとえば、Microsoft Word では、文書が保存中であることが表示されます。  
+  
+## このセクションの内容  
+ [StatusBar コントロールの概要](../../../../docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md)  
+ <xref:System.Windows.Forms.StatusBar> コントロールの一般的な概念を紹介します。このコントロールにより、フォーカスが置かれたコントロールに関する情報を参照できます。  
+  
+ [方法 : StatusBar コントロールにパネルを追加する](../../../../docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md)  
+ プログラミング可能なパネルを <xref:System.Windows.Forms.StatusBar> コントロールに追加する方法について説明します。  
+  
+ [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](../../../../docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md)  
+ <xref:System.Windows.Forms.StatusBar> コントロールで発生した <xref:System.Windows.Forms.Control.Click> イベントを処理する方法について説明します。  
+  
+ [方法 : ステータス バー パネルのサイズを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-size-of-status-bar-panels.md)  
+ 実行時にステータス バー パネルの幅とサイズ変更の動作を制御するプロパティについて説明します。  
+  
+ [チュートリアル : ステータス バー情報の実行時更新](../../../../docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md)  
+ ステータス バー パネル内のデータをプログラムによって制御する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.StatusBar>  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+ <xref:System.Windows.Forms.ToolStripStatusLabel>  
+ <xref:System.Windows.Forms.StatusBar> コントロールに代わると共に追加の機能を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/statusstrip-control-overview.md b/docs/framework/winforms/controls/statusstrip-control-overview.md
new file mode 100644
index 00000000000..908e8e6569f
--- /dev/null
+++ b/docs/framework/winforms/controls/statusstrip-control-overview.md
@@ -0,0 +1,56 @@
+---
+title: "StatusStrip コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "StatusStrip"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー, ステータス バーの概要"
+  - "StatusStrip コントロール [Windows フォーム], StatusStrip コントロールの概要"
+ms.assetid: c0d9bcbb-f8b8-46ef-bae2-4146b8c8ce99
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# StatusStrip コントロールの概要
+<xref:System.Windows.Forms.StatusStrip> コントロールには、<xref:System.Windows.Forms.Form> に表示されているオブジェクト、そのオブジェクトのコンポーネント、またはそのオブジェクトのアプリケーション内での操作に関連するコンテキストについての情報を表示します。  通常、<xref:System.Windows.Forms.StatusStrip> コントロールは <xref:System.Windows.Forms.ToolStripStatusLabel> オブジェクトで構成され、それら各オブジェクトに、テキスト、アイコン、またはその両方が表示されます。  <xref:System.Windows.Forms.StatusStrip> には、<xref:System.Windows.Forms.ToolStripDropDownButton>、<xref:System.Windows.Forms.ToolStripSplitButton>、および <xref:System.Windows.Forms.ToolStripProgressBar> の各コントロールを組み込むこともできます。  
+  
+ 既定の <xref:System.Windows.Forms.StatusStrip> にはパネルがありません。  <xref:System.Windows.Forms.StatusStrip> にパネルを追加するには、<xref:System.Windows.Forms.ToolStripItemCollection.AddRange%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ <xref:System.Windows.Forms.StatusStrip> 項目と一般的なコマンドの処理に対しては、Visual Studio に広範なサポートが用意されています。  
+  
+ 「[StatusStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233631\(v=vs.110\))」、「[\[StatusStrip Tasks\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233642\(v=vs.110\))」も参照してください。  
+  
+ <xref:System.Windows.Forms.StatusStrip> コントロールは、以前のバージョンの <xref:System.Windows.Forms.StatusBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールも、下位互換性を保つ目的および必要に応じて将来使用する目的で保持されます。  
+  
+### StatusStrip の重要なメンバー  
+  
+|名前|説明|  
+|--------|--------|  
+|<xref:System.Windows.Forms.StatusStrip.CanOverflow%2A>|<xref:System.Windows.Forms.StatusStrip> がオーバーフロー機能をサポートするかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.StatusStrip.Stretch%2A>|<xref:System.Windows.Forms.StatusStrip> を <xref:System.Windows.Forms.ToolStripContainer> 内で端から端まで拡大するかどうかを示す値を取得または設定します。|  
+  
+### StatusStrip の重要なコンパニオン クラス  
+  
+|名前|説明|  
+|--------|--------|  
+|<xref:System.Windows.Forms.ToolStripStatusLabel>|<xref:System.Windows.Forms.StatusStrip> コントロールのパネルを表します。|  
+|<xref:System.Windows.Forms.ToolStripDropDownButton>|関連付けられた <xref:System.Windows.Forms.ToolStripDropDown> を表示します。そこからユーザーは、単一の項目を選択できます。|  
+|<xref:System.Windows.Forms.ToolStripSplitButton>|標準のボタンとドロップダウン メニューという 2 つの部分から成るコントロールを表します。|  
+|<xref:System.Windows.Forms.ToolStripProgressBar>|処理の完了状態を表示します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusStrip>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/statusstrip-control.md b/docs/framework/winforms/controls/statusstrip-control.md
new file mode 100644
index 00000000000..8cc7758fbe7
--- /dev/null
+++ b/docs/framework/winforms/controls/statusstrip-control.md
@@ -0,0 +1,44 @@
+---
+title: "StatusStrip コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー"
+  - "StatusStrip コントロール [Windows フォーム]"
+ms.assetid: eb1e59da-0a48-4ce5-af7d-13b8e75af4b1
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# StatusStrip コントロール
+Windows フォームの `StatusStrip` コントロールは、フォーム上で領域として使用され、通常はウィンドウの下端に表示されます。アプリケーションは、このコントロールにさまざまな種類のステータス情報を表示できます  `StatusStrip` コントロールには、通常は `ToolStripStatusLabel` コントロールを配置し、状態を示すためのテキストまたはアイコンや、処理の完了状態を視覚的に表示するための <xref:System.Windows.Forms.ToolStripProgressBar> を表示します。  
+  
+## このセクションの内容  
+ [StatusStrip コントロールの概要](../../../../docs/framework/winforms/controls/statusstrip-control-overview.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : StatusStrip 内で Spring プロパティを対話的に使用する](../../../../docs/framework/winforms/controls/how-to-use-the-spring-property-interactively-in-a-statusstrip.md)  
+ `Spring` プロパティを使用して、`ToolStripStatusLabel` を `StatusStrip` 内で対話式に中央揃えする方法を示します。  
+  
+ 「[StatusStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233631\(v=vs.110\))」、「[\[StatusStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233642\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.StatusStrip>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ <xref:System.Windows.Forms.ToolStripStatusLabel>  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/stretch-a-toolstriptextbox-to-fill-the-remaining-width-of-a-toolstrip-wf.md b/docs/framework/winforms/controls/stretch-a-toolstriptextbox-to-fill-the-remaining-width-of-a-toolstrip-wf.md
new file mode 100644
index 00000000000..f8e5c398b7d
--- /dev/null
+++ b/docs/framework/winforms/controls/stretch-a-toolstriptextbox-to-fill-the-remaining-width-of-a-toolstrip-wf.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ToolStripTextBox を拡大して ToolStrip の残りの幅に合わせる (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト ボックス, 拡大 (ToolStrip コントロールを) [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム], 拡大 (テキスト ボックスを)"
+ms.assetid: 0e610fbf-85fe-414c-900c-9704a5dd5cc6
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ToolStripTextBox を拡大して ToolStrip の残りの幅に合わせる (Windows フォーム)
+<xref:System.Windows.Forms.ToolStrip> コントロールの <xref:System.Windows.Forms.ToolStrip.Stretch%2A> プロパティを `true` に設定すると、コントロールはコンテナーのサイズに合わせて拡大されます。コンテナーのサイズを変更すると、コントロールのサイズも変更されます。  この構成は、<xref:System.Windows.Forms.ToolStripTextBox> などのコントロールの項目を拡大して使用できる領域に合わせる場合や、コントロールのサイズ変更時に項目のサイズを変更する場合に役立ちます。  コントロールの拡大は、Microsoft® Internet Explorer のアドレス バーに似た外観や動作を実装する場合に便利です。  
+  
+## 使用例  
+ 次のコード例は、<xref:System.Windows.Forms.ToolStripTextBox> から派生する `ToolStripSpringTextBox` というクラスを作成します。  このクラスでは、<xref:System.Windows.Forms.ToolStripTextBox.GetPreferredSize%2A> メソッドをオーバーライドして、親の <xref:System.Windows.Forms.ToolStrip> コントロールの幅から他のすべての項目の合計幅を引いた値を求め、使用できる領域の幅を計算します。  また、このコード例は、新しい動作を実行する <xref:System.Windows.Forms.Form> クラスと `Program` クラスも作成します。  
+  
+ [!code-csharp[ToolStripSpringTextBox#00](../../../../samples/snippets/csharp/VS_Snippets_Winforms/ToolStripSpringTextBox/cs/ToolStripSpringTextBox.cs#00)]
+ [!code-vb[ToolStripSpringTextBox#00](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/ToolStripSpringTextBox/vb/ToolStripSpringTextBox.vb#00)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System、System.Drawing、System.Windows.Forms の各アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.ToolStrip.Stretch%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.ToolStripTextBox>   
+ <xref:System.Windows.Forms.ToolStripTextBox.GetPreferredSize%2A?displayProperty=fullName>   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)   
+ [方法 : StatusStrip 内で Spring プロパティを対話的に使用する](../../../../docs/framework/winforms/controls/how-to-use-the-spring-property-interactively-in-a-statusstrip.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md b/docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md
new file mode 100644
index 00000000000..7ac3815eead
--- /dev/null
+++ b/docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md
@@ -0,0 +1,41 @@
+---
+title: "TabControl コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TabControl"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プロパティ ページ, Windows フォーム"
+  - "タブ ページ, タブ ページの概要"
+  - "TabControl コントロール [Windows フォーム], TabControl コントロールの概要"
+  - "Windows フォームのダイアログ ボックス, タブ"
+ms.assetid: 2b4ea784-a39d-463c-81d8-af74ce068476
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TabControl コントロールの概要 (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.TabControl> コントロールは、複数のタブを表示します。タブは、ノートの仕切りページやファイリング キャビネット内のフォルダーを分類するラベルのようなものです。  タブには画像やその他のコントロールを表示できます。  タブ コントロールを使用すると、複数のページを持つダイアログ ボックスを作成できます。このようなダイアログ ボックスは、Windows オペレーティング システムで数多く使用されています \(コントロール パネルから表示する \[画面のプロパティ\] ダイアログ ボックスなど\)。  さらに、<xref:System.Windows.Forms.TabControl> を使用して、関連プロパティをグループ化するためのプロパティ ページを作成できます。  
+  
+## TabControl の使用  
+ <xref:System.Windows.Forms.TabControl> の主要プロパティは <xref:System.Windows.Forms.TabControl.TabPages%2A> です。このプロパティは、個別のタブを保持します。  個別のタブは <xref:System.Windows.Forms.TabPage> オブジェクトです。  タブがクリックされると、その <xref:System.Windows.Forms.TabPage> オブジェクトの <xref:System.Windows.Forms.Control.Click> イベントが発生します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TabControl>   
+ [TabControl コントロール](../../../../docs/framework/winforms/controls/tabcontrol-control-windows-forms.md)   
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)   
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)   
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)   
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)   
+ [Windows フォームのダイアログ ボックス](../../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tabcontrol-control-windows-forms.md b/docs/framework/winforms/controls/tabcontrol-control-windows-forms.md
new file mode 100644
index 00000000000..f5a5ed69550
--- /dev/null
+++ b/docs/framework/winforms/controls/tabcontrol-control-windows-forms.md
@@ -0,0 +1,59 @@
+---
+title: "TabControl コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダイアログ ボックス, 作成 (マルチページ)"
+  - "マルチページのダイアログ ボックス"
+  - "プロパティ ページ, 作成"
+  - "タブ コントロール"
+  - "タブ コントロール, 作成"
+  - "タブ ダイアログ ボックス"
+  - "TabControl コントロール [Windows フォーム]"
+ms.assetid: 915091af-93ac-4d3d-8283-738dd2d21ea7
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# TabControl コントロール (Windows フォーム)
+Windows フォーム `TabControl` は、ノートの仕切りや書類キャビネットのフォルダー セットのラベルに似た、複数のタブを表示します。  タブには画像やその他のコントロールを含めることができます。  プロパティ ページを作成するには、`TabControl` を使用します。  
+  
+## このセクションの内容  
+ [TabControl コントロールの概要](../../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : タブ ページにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-tab-page.md)  
+ タブ ページにコントロールを表示するための手順を示します。  
+  
+ [方法 : Windows フォーム TabControl のタブを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-tabs-with-the-windows-forms-tabcontrol.md)  
+ デザイナーまたはコードのタブを追加および削除する方法を説明します。  
+  
+ [方法 : Windows フォーム TabControl の表示形式を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-the-windows-forms-tabcontrol.md)  
+ 個々のタブの外観に影響するプロパティを調整するための手順を示します。  
+  
+ [方法 : タブ ページを無効化する](../../../../docs/framework/winforms/controls/how-to-disable-tab-pages.md)  
+ ユーザーの資格情報に基づいて、タブのページへのアクセスを制限する方法について説明します。  
+  
+ 「[方法 : デザイナーで Windows フォーム TabControl を使ってタブを追加および削除する](http://msdn.microsoft.com/library/ms233654\(v=vs.110\))」、「[方法 : デザイナーを使ってタブ ページにコントロールを追加する](http://msdn.microsoft.com/library/ms233668\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TabControl> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームのダイアログ ボックス](../../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)  
+ 多くの場合、タブを表示するダイアログ ボックスのタスクの一覧を示します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tablelayoutpanel-control-overview.md b/docs/framework/winforms/controls/tablelayoutpanel-control-overview.md
new file mode 100644
index 00000000000..bffcdabe706
--- /dev/null
+++ b/docs/framework/winforms/controls/tablelayoutpanel-control-overview.md
@@ -0,0 +1,58 @@
+---
+title: "TableLayoutPanel コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TableLayoutPanel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], サイズ変更"
+  - "レイアウト [Windows フォーム], TableLayoutPanel コントロール"
+  - "サイズを変更できるコントロール"
+  - "TableLayoutPanel コントロール [Windows フォーム], TableLayoutPanel コントロールの概要"
+  - "Windows フォーム コントロール, 縦横比を維持したサイズ変更"
+  - "Windows フォーム, 縦横比を維持したサイズ変更 (コントロールの)"
+ms.assetid: 337661c8-61cb-44ee-93e0-3662bddec327
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TableLayoutPanel コントロールの概要
+<xref:System.Windows.Forms.TableLayoutPanel> コントロールは、内容をグリッドに整列させます。  レイアウトがデザイン時および実行時の両方で実行されるため、アプリケーション環境の変化に応じて動的に変更できます。  これにより、パネル内のコントロールを適切にサイズ変更することができるため、親コントロールのサイズ変更や、ローカライズによるテキスト長の変更などの変更に対応できます。  
+  
+ Windows フォーム コントロールは、<xref:System.Windows.Forms.TableLayoutPanel> の他のインスタンスを含めて、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの子にすることができます。  これにより、実行時の変化に適応する高度なレイアウトを構築することができます。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A>、<xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A>、および <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> プロパティの値に応じて、<xref:System.Windows.Forms.TableLayoutPanel> コントロールを追加するときに新しいコントロールに合わせて拡張できます。  <xref:System.Windows.Forms.TableLayoutPanel.RowCount%2A> プロパティまたは <xref:System.Windows.Forms.TableLayoutPanel.ColumnCount%2A> プロパティのいずれかを 0 の値に設定すると、<xref:System.Windows.Forms.TableLayoutPanel> が対応する方向にバインド解除されます。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールが完全に子コントロールになった後で、\(水平または垂直の\) 展開の方向を制御することもできます。  既定では、<xref:System.Windows.Forms.TableLayoutPanel> コントロールは行を追加することで下方向に拡張します。  
+  
+ 既定の動作とは異なる方法で行と列を動作させる場合は、<xref:System.Windows.Forms.TableLayoutPanel.RowStyles%2A> プロパティと <xref:System.Windows.Forms.TableLayoutPanel.ColumnStyles%2A> プロパティを使用して、行と列のプロパティを制御できます。  行または列のプロパティを個別に設定することができます。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、その子コントロールに `Cell`、`Column`、`Row`、`ColumnSpan`、および `RowSpan` の各プロパティを追加します。  
+  
+ 子コントロールで `ColumnSpan` プロパティまたは `RowSpan` プロパティを設定することで、<xref:System.Windows.Forms.TableLayoutPanel> コントロールのセルをマージできます。  
+  
+1.  [方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する](http://msdn.microsoft.com/library/ms171688\(v=vs.110\))  
+  
+2.  [方法 : TableLayoutPanel コントロールの行と列を拡大する](http://msdn.microsoft.com/library/ms171687\(v=vs.110\))  
+  
+3.  [方法 : TableLayoutPanel コントロールの列と行を編集する](http://msdn.microsoft.com/library/ms171686\(v=vs.110\))  
+  
+4.  [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/w4yc3e8c\(v=vs.110\))  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ <xref:System.Windows.Forms.TableLayoutSettings>   
+ [方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする](../../../../docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md)   
+ [方法 : データ入力用のサイズ変更可能な Windows フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-resizable-windows-form-for-data-entry.md)   
+ [TableLayoutPanel コントロールの推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md b/docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md
new file mode 100644
index 00000000000..cfbac841c1c
--- /dev/null
+++ b/docs/framework/winforms/controls/tablelayoutpanel-control-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "TableLayoutPanel コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サイズの自動調整"
+  - "コントロール [Windows フォーム], サイズ変更"
+  - "レイアウト [Windows フォーム]"
+  - "レイアウト [Windows フォーム], TableLayoutPanel コントロール"
+  - "サイズ変更, 自動"
+  - "TableLayoutPanel コントロール [Windows フォーム]"
+ms.assetid: f55175c6-424e-4782-a86e-3f79c1550235
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# TableLayoutPanel コントロール (Windows フォーム)
+<xref:System.Windows.Forms.TableLayoutPanel> コントロールは、その内容をグリッド内に配置します。  レイアウトはデザイン時と実行時の両方で行われるため、アプリケーション環境の変更に合わせて動的に変更できます。  また、パネル内のコントロールが適切にサイズ変更されるため、親コントロールのサイズ変更や、ローカリゼーションに伴うテキスト長の変更に対応できます。  
+  
+## このセクションの内容  
+ [TableLayoutPanel コントロールの概要](../../../../docs/framework/winforms/controls/tablelayoutpanel-control-overview.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールの全般的な概念を説明します。このコントロールを使用すると、行と列から成るレイアウトを構築できます。  
+  
+ [TableLayoutPanel コントロールの推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールのレイアウト機能を最大限に活用するために役立つ手法について、概要を示します。  
+  
+ [TableLayoutPanel コントロールにおける AutoSize 動作](../../../../docs/framework/winforms/controls/autosize-behavior-in-the-tablelayoutpanel-control.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールが自動サイズ変更の動作をどのようにサポートするかを説明します。  
+  
+ [方法 : TableLayoutPanel コントロールで子コントロールを固定およびドッキングする](../../../../docs/framework/winforms/controls/how-to-anchor-and-dock-child-controls-in-a-tablelayoutpanel-control.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールの子コントロールを固定およびドッキングする方法を示します。  
+  
+ [方法 : ローカリゼーションに対応した Windows フォーム レイアウトをデザインする](../../../../docs/framework/winforms/controls/how-to-design-a-windows-forms-layout-that-responds-well-to-localization.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用して、ローカリゼーションに適切に対応できるフォームを作成する例を示します。  
+  
+ [方法 : データ入力用のサイズ変更可能な Windows フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-resizable-windows-form-for-data-entry.md)  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用して、サイズ変更に適切に対応できるフォームを作成する例を示します。  
+  
+1.  [方法 : TableLayoutPanel コントロール内でコントロールを配置して伸縮する](http://msdn.microsoft.com/library/ms171688\(v=vs.110\))  
+  
+2.  [方法 : TableLayoutPanel コントロールの行と列を拡大する](http://msdn.microsoft.com/library/ms171687\(v=vs.110\))  
+  
+3.  [方法 : TableLayoutPanel コントロールの列と行を編集する](http://msdn.microsoft.com/library/ms171686\(v=vs.110\))  
+  
+4.  [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](http://msdn.microsoft.com/library/w4yc3e8c\(v=vs.110\))  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TableLayoutPanel>  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールのリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.TableLayoutSettings>  
+ <xref:System.Windows.Forms.TableLayoutSettings> 型のリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel>  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールのリファレンス ドキュメントを提供します。  
+  
+## 関連項目  
+ [ローカリゼーション](../../../../docs/standard/globalization-localization/localization.md)  
+ ローカリゼーションに関連するトピックの概要を示します。  
+  
+ 「[アプリケーションのローカライズ](http://msdn.microsoft.com/library/z68135h5%20\(v=vs.110\))」または「[アプリケーションのローカライズ](http://msdn.microsoft.com/library/z68135h5%20\(v=vs.120\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/textbox-control-overview-windows-forms.md b/docs/framework/winforms/controls/textbox-control-overview-windows-forms.md
new file mode 100644
index 00000000000..497915576ff
--- /dev/null
+++ b/docs/framework/winforms/controls/textbox-control-overview-windows-forms.md
@@ -0,0 +1,67 @@
+---
+title: "TextBox コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TextBox"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト ボックス, 追加"
+  - "TextBox コントロール [Windows フォーム], TextBox コントロールの概要"
+ms.assetid: d1a9c7f5-fa53-480a-a75c-158f8649ea2f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TextBox コントロールの概要 (Windows フォーム)
+Windows フォーム テキスト ボックスを使用すると、入力データを取得したりテキストを表示したりできます。  <xref:System.Windows.Forms.TextBox> コントロールは、通常は編集可能なテキストに使用しますが、読み取り専用にすることもできます。  テキスト ボックスでは、複数の行を表示したり、コントロールのサイズに合わせてテキストを折り返したりできます。基本的な書式を追加することもできます。  <xref:System.Windows.Forms.TextBox> コントロールには、表示用のテキストまたはコントロールから入力されたテキストに適用するための、単一の書式スタイルが用意されています。  書式が複数設定されたテキストを表示するには、<xref:System.Windows.Forms.RichTextBox> コントロールを使用します。  詳細については、「[RichTextBox コントロールの概要](../../../../docs/framework/winforms/controls/richtextbox-control-overview-windows-forms.md)」を参照してください。  
+  
+## TextBox コントロールの操作  
+ コントロールによって表示されるテキストは、<xref:System.Windows.Forms.TextBox.Text%2A> プロパティに含まれています。  既定では、最大 2,048 文字をテキスト ボックスに入力できます。  <xref:System.Windows.Forms.TextBox.Multiline%2A> プロパティを `true` に設定した場合は、32 KB までのテキストを入力できます。  <xref:System.Windows.Forms.TextBox.Text%2A> プロパティは、デザイン時に \[プロパティ\] ウィンドウで設定するか、実行時にコードで設定するか、または実行時にユーザー入力によって設定します。  テキスト ボックスの現在の内容は、実行時に <xref:System.Windows.Forms.TextBox.Text%2A> プロパティを読み取ることによって取得できます。  
+  
+ 実行時にテキストをコントロール内に設定するコード例を次に示します。  `InitializeMyControl` の手順では自動的に実装します ; これを呼び出す必要があります。  
+  
+```vb  
+Private Sub InitializeMyControl()  
+   ' Put some text into the control first.  
+   TextBox1.Text = "This is a TextBox control."  
+End Sub  
+  
+```  
+  
+```csharp  
+private void InitializeMyControl() {  
+   // Put some text into the control first.  
+   textBox1.Text = "This is a TextBox control.";  
+}  
+  
+```  
+  
+```cpp  
+private:  
+   void InitializeMyControl()  
+   {  
+      // Put some text into the control first.  
+      textBox1->Text = "This is a TextBox control.";  
+   }  
+```  
+  
+## 参照  
+ <xref:System.Windows.Forms.TextBox>   
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)   
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)   
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)   
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)   
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)   
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)   
+ [TextBox コントロール](../../../../docs/framework/winforms/controls/textbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/textbox-control-windows-forms.md b/docs/framework/winforms/controls/textbox-control-windows-forms.md
new file mode 100644
index 00000000000..3d157b63171
--- /dev/null
+++ b/docs/framework/winforms/controls/textbox-control-windows-forms.md
@@ -0,0 +1,55 @@
+---
+title: "TextBox コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "テキスト ボックス"
+  - "TextBox コントロール [Windows フォーム]"
+ms.assetid: e5a06987-8aec-4271-b196-2245ba992d62
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TextBox コントロール (Windows フォーム)
+Windows フォーム テキスト ボックスを使用すると、入力データを取得したりテキストを表示したりできます。  `TextBox` コントロールは、通常は編集可能なテキストに使用しますが、読み取り専用にすることもできます。  テキスト ボックスでは、複数の行を表示したり、コントロールのサイズに合わせてテキストを折り返したりできます。基本的な書式を追加することもできます。  `TextBox` コントロールでは、コントロールに表示または入力されるテキストに対して単一の書式を使用できます。  
+  
+## このセクションの内容  
+ [TextBox コントロールの概要](../../../../docs/framework/winforms/controls/textbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム TextBox コントロールでのカーソル位置を制御する](../../../../docs/framework/winforms/controls/how-to-control-the-insertion-point-in-a-windows-forms-textbox-control.md)  
+ エディット コントロールに最初にフォーカスが設定されたときに、カーソルを表示する位置を指定する手順について説明します。  
+  
+ [方法 : Windows フォームの TextBox コントロールを使用してパスワード テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-password-text-box-with-the-windows-forms-textbox-control.md)  
+ テキスト ボックスに入力するデータを非表示にする方法について説明します。  
+  
+ [方法 : 読み取り専用テキスト ボックスを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-read-only-text-box-windows-forms.md)  
+ テキスト ボックスの内容が変更されないようにする方法について説明します。  
+  
+ [方法 : 文字列に引用符を挿入する](../../../../docs/framework/winforms/controls/how-to-put-quotation-marks-in-a-string-windows-forms.md)  
+ テキスト ボックスの文字列に引用符を追加する方法について説明します。  
+  
+ [方法 : Windows フォーム TextBox コントロールでテキストを選択する](../../../../docs/framework/winforms/controls/how-to-select-text-in-the-windows-forms-textbox-control.md)  
+ テキスト ボックスのテキストを強調表示する方法について説明します。  
+  
+ [方法 : Windows フォーム TextBox コントロールで複数行を表示する](../../../../docs/framework/winforms/controls/how-to-view-multiple-lines-in-the-windows-forms-textbox-control.md)  
+ テキスト ボックスをスクロールできるようにする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TextBox> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/timer-component-overview-windows-forms.md b/docs/framework/winforms/controls/timer-component-overview-windows-forms.md
new file mode 100644
index 00000000000..c9235b8024c
--- /dev/null
+++ b/docs/framework/winforms/controls/timer-component-overview-windows-forms.md
@@ -0,0 +1,35 @@
+---
+title: "Timer コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Timer"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Timer コンポーネント [Windows フォーム], Timer コンポーネントの概要"
+  - "タイマー, タイマーの概要"
+ms.assetid: e672c05b-a8b6-4b26-9e4d-9223aa9e3873
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Timer コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.Timer> は、一定の間隔でイベントを発生させるコンポーネントです。  このコンポーネントは、Windows フォーム環境で使用します。  サーバー環境に適したタイマーが必要な場合は、「[Introduction to Server\-Based Timers](http://msdn.microsoft.com/ja-jp/adc0bc0a-a519-4812-bafc-fb9d1a5801fc)」を参照してください。  
+  
+## 主要なプロパティ、メソッド、およびイベント  
+ 間隔は <xref:System.Windows.Forms.Timer.Interval%2A> プロパティで定義し、値はミリ秒単位で指定します。  このコンポーネントを有効にすると、<xref:System.Windows.Forms.Timer.Tick> イベントが一定の間隔で発生します。  実行するコードは、ここに記述します。  詳細については、「[方法 : Windows フォームの Timer コンポーネントを使用して一定間隔でプロシージャを実行する](../../../../docs/framework/winforms/controls/run-procedures-at-set-intervals-with-wf-timer-component.md)」を参照してください。  <xref:System.Windows.Forms.Timer> コンポーネントの主要なメソッドは、タイマーをオンおよびオフにする <xref:System.Windows.Forms.Timer.Start%2A> と <xref:System.Windows.Forms.Timer.Stop%2A> です。  タイマーをオフにすると、タイマーはリセットされます。<xref:System.Windows.Forms.Timer> コンポーネントを一時停止する方法はありません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Timer>   
+ [Timer コンポーネント](../../../../docs/framework/winforms/controls/timer-component-windows-forms.md)   
+ [Windows フォームの Timer コンポーネントの Interval プロパティの制限](../../../../docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/timer-component-windows-forms.md b/docs/framework/winforms/controls/timer-component-windows-forms.md
new file mode 100644
index 00000000000..d3c04cecabb
--- /dev/null
+++ b/docs/framework/winforms/controls/timer-component-windows-forms.md
@@ -0,0 +1,50 @@
+---
+title: "Timer コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Timer コンポーネント [Windows フォーム]"
+  - "タイマー"
+  - "タイマー, 作成"
+ms.assetid: 6700e534-6382-43d5-98ed-14205435fff7
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Timer コンポーネント (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.Timer> は、一定の間隔でイベントを発生させるコンポーネントです。  このコンポーネントは、Windows フォームの環境用に設計されています。  
+  
+## このセクションの内容  
+ [Timer コンポーネントの概要](../../../../docs/framework/winforms/controls/timer-component-overview-windows-forms.md)  
+ アプリケーションが定期的なイベントに応答するよう設定できる <xref:System.Windows.Forms.Timer> コンポーネントの一般的な概念について説明しています。  
+  
+ [Windows フォームの Timer コンポーネントの Interval プロパティの制限](../../../../docs/framework/winforms/controls/limitations-of-the-timer-component-interval-property.md)  
+ タイマーの間隔で、使用方法に影響を与える可能性がある既知の制限事項について説明します。  
+  
+ [方法 : Windows フォームの Timer コンポーネントを使用して一定間隔でプロシージャを実行する](../../../../docs/framework/winforms/controls/run-procedures-at-set-intervals-with-wf-timer-component.md)  
+ 一定の時間間隔で Windows ベースのアプリケーションに応答する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Timer?displayProperty=fullName> クラス  
+ Windows フォームで使用されるクラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+ <xref:System.Timers.Timer?displayProperty=fullName> クラス  
+ サーバー ベースのタイマーによって使用される <xref:System.Timers.Timer?displayProperty=fullName> クラスのリファレンス情報について説明します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [Visual Basic 6.0 ユーザー向けの Timer コントロール](http://msdn.microsoft.com/ja-jp/38e5184a-1e50-45cf-b936-dae566c0cfc5)  
+ 以前のバージョンと比較して、Visual Basic のタイマー機能がどのように変更されたか説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md b/docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md
new file mode 100644
index 00000000000..89e23a9253e
--- /dev/null
+++ b/docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md
@@ -0,0 +1,47 @@
+---
+title: "ToolBar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolBar コントロール [Windows フォーム], ToolBar コントロールの概要"
+  - "ツール バー [Windows フォーム], ツール バーの概要"
+ms.assetid: d426b203-0216-4dbe-b834-1641e50a9c29
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ToolBar コントロールの概要 (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolBar> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォームの <xref:System.Windows.Forms.ToolBar> コントロールは、一連のドロップダウン メニューやコマンド実行用のビットマップ ボタンを表示する、フォーム上のコントロール バーとして使用します。  ツール バーのボタンをクリックして、メニュー コマンドを選択するのと同じ操作ができます。  ボタンは、プッシュ ボタン、ドロップダウン メニュー、または区切り記号として機能するように設定できます。  通常、ツール バーのボタンとメニューは、アプリケーションのメニュー構造の項目に対応し、使用頻度の高い関数やコマンドをすばやく実行します。  
+  
+## ToolBar コントロールの操作  
+ <xref:System.Windows.Forms.ToolBar> コントロールは、通常は親ウィンドウの上部に沿って "ドッキング" されますが、ウィンドウの上下左右のどこにでもドッキングできます。  ツール バーには、ユーザーがツール バー ボタンをマウス ポインターでポイントしたときに表示されるツール ヒントを実装できます。  ツール ヒントは、ボタンまたはメニューの用途を簡潔に説明するための、小さなポップアップ ウィンドウです。  ツールヒントを表示するには、<xref:System.Windows.Forms.ToolBar.ShowToolTips%2A> プロパティに `true` を設定します。  
+  
+> [!NOTE]
+>  一部のアプリケーションには、アプリケーション ウィンドウの上部に "浮遊" していて位置を変更できる、ツール バーによく似たコントロールがあります。  Windows フォームの ToolBar コントロールは、位置を変更できません。  
+  
+ <xref:System.Windows.Forms.ToolBar.Appearance%2A> プロパティに [Normal](frlrfSystemWindowsFormsToolBarAppearanceClassTopic) を設定すると、ツール バー ボタンが立体的に表示されます。  ツール バーの <xref:System.Windows.Forms.ToolBar.Appearance%2A> プロパティに <xref:System.Windows.Forms.ToolBarAppearance> を設定すると、ツール バーとボタンが平面的に表示されます。  平面表示されたボタンの上にマウス ポインターが置かれると、ボタンが立体的に表示されます。  ツール バー ボタンは、区切り記号で論理的なグループに分類できます。  区切り記号は、<xref:System.Windows.Forms.ToolBarButton.Style%2A> プロパティに [Separator](frlrfSystemWindowsFormsToolBarButtonStyleClassTopic) を設定したツール バー ボタンです。  ツール バー上では空の領域として表示されます。  ツール バーが平面表示されているときは、ボタン区切り記号は空の領域ではなく線で表示されます。  
+  
+ <xref:System.Windows.Forms.ToolBar> コントロールでは、<xref:System.Windows.Forms.Button> オブジェクトを <xref:System.Windows.Forms.ToolBar.Buttons%2A> コレクションに追加することにより、ツール バーを作成できます。  ボタンを <xref:System.Windows.Forms.ToolBar> コントロールに追加するときには、コレクション エディターを使用できます。各 <xref:System.Windows.Forms.Button> オブジェクトには、テキストまたはイメージを割り当てます \(両方を割り当てることもできます\)。  イメージは、関連付けられた [ImageList](../../../../docs/framework/winforms/controls/imagelist-component-windows-forms.md) コンポーネントによって提供されます。  実行時に <xref:System.Windows.Forms.ToolBar.ToolBarButtonCollection.Add%2A> メソッドや <xref:System.Windows.Forms.ToolBar.ToolBarButtonCollection.Remove%2A> メソッドを使用して、<xref:System.Windows.Forms.ToolBar.ToolBarButtonCollection> にボタンを登録したり、登録済みのボタンを削除したりできます。  <xref:System.Windows.Forms.ToolBar> のボタンをプログラミングするには、<xref:System.Windows.Forms.ToolBar> の <xref:System.Windows.Forms.ToolBar.ButtonClick> イベントにコードを追加します。クリックされたボタンの判別には、<xref:System.Windows.Forms.ToolBarButtonClickEventArgs> クラスの <xref:System.Windows.Forms.ToolBarButtonClickEventArgs.Button%2A> プロパティを使用します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolBar>   
+ [ToolBar コントロール](../../../../docs/framework/winforms/controls/toolbar-control-windows-forms.md)   
+ [方法 : ツール バー コントロールにボタンを追加する](../../../../docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md)   
+ [方法 : ツール バー ボタンのアイコンを定義する](../../../../docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md)   
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolbar-control-windows-forms.md b/docs/framework/winforms/controls/toolbar-control-windows-forms.md
new file mode 100644
index 00000000000..69997d01643
--- /dev/null
+++ b/docs/framework/winforms/controls/toolbar-control-windows-forms.md
@@ -0,0 +1,57 @@
+---
+title: "ToolBar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolBar コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム]"
+ms.assetid: 6b40e9ce-6a7a-4784-bfc9-7f1d36b7462e
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ToolBar コントロール (Windows フォーム)
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStrip> コントロールは、`ToolBar` コントロールに代わると共に追加の機能を提供します。ただし、`ToolBar` コントロールは、下位互換性を保つ目的および将来使用する目的で保持されます。  
+  
+ Windows フォーム `ToolBar` コントロールは、コマンドをアクティブ化するドロップダウン メニューとビットマップのボタンの行を表示するコントロール バーとしてフォームを使用します。  そのため、ツールバー ボタンのクリックは、メニュー コマンドと同じです。  ボタンは、プッシュ ボタン、ドロップダウン メニュー、または区切り記号として表示して機能するように構成できます。  通常、ツールバーには、アプリケーションのメニュー構造の項目に対応するボタンとメニューが含まれ、アプリケーションで最も頻繁に使用される関数やコマンドにすばやくアクセスできます。  
+  
+> [!NOTE]
+>  `ToolBar` コントロールの <xref:System.Windows.Forms.ToolBarButton.DropDownMenu%2A> プロパティは、<xref:System.Windows.Forms.ContextMenu> クラスのインスタンスを参照として取得します。  このプロパティは <xref:System.Windows.Forms.Menu> クラスから継承する任意のオブジェクトを受け入れるため、アプリケーションのツールバーにこの種類のボタンを実装する場合は、渡す参照を慎重に検討してください。  
+  
+## このセクションの内容  
+ [ToolBar コントロールの概要](../../../../docs/framework/winforms/controls/toolbar-control-overview-windows-forms.md)  
+ ユーザーが操作できるカスタム ツールバーを設計できる、`ToolBar` コントロールの一般的な概念について説明します。  
+  
+ [方法 : ツール バー コントロールにボタンを追加する](../../../../docs/framework/winforms/controls/how-to-add-buttons-to-a-toolbar-control.md)  
+ ボタンを `ToolBar` コントロールに追加する方法について説明します。  
+  
+ [方法 : ツール バー ボタンのアイコンを定義する](../../../../docs/framework/winforms/controls/how-to-define-an-icon-for-a-toolbar-button.md)  
+ アイコンを `ToolBar` コントロールのボタン内に表示する方法について説明します。  
+  
+ [方法 : ツール バー ボタンのメニュー イベントをトリガーする](../../../../docs/framework/winforms/controls/how-to-trigger-menu-events-for-toolbar-buttons.md)  
+ `ToolBar` コントロールでユーザーがクリックするボタンを解釈するコードの記述方法について説明します。  
+  
+ 「[方法 :デザイナーを使って ToolBar ボタンのアイコンを定義する](http://msdn.microsoft.com/library/ms233659\(v=vs.110\))」、「[方法 : デザイナーを使って ToolBar コントロールにボタンを追加する](http://msdn.microsoft.com/library/ms233650\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolBar> クラス  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)  
+ Windows フォーム アプリケーションでメニュー、コントロール、およびユーザー コントロールをホストするツールバーについて説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrip-control-architecture.md b/docs/framework/winforms/controls/toolstrip-control-architecture.md
new file mode 100644
index 00000000000..a8f16672744
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrip-control-architecture.md
@@ -0,0 +1,397 @@
+---
+title: "ToolStrip コントロールのアーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolStrip コントロール [Windows フォーム], アーキテクチャ"
+ms.assetid: 71df2d18-862e-4701-9ff9-c1fe606f94f2
+caps.latest.revision: 32
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 32
+---
+# ToolStrip コントロールのアーキテクチャ
+<xref:System.Windows.Forms.ToolStrip> クラスと <xref:System.Windows.Forms.ToolStripItem> クラスには、ツール バー項目、ステータス項目、およびメニュー項目を表示するための柔軟で拡張性のあるシステムが実装されています。  これらのクラスはすべて <xref:System.Windows.Forms> 名前空間に格納されており、通常、名前にはすべて "ToolStrip" プリフィックス \(<xref:System.Windows.Forms.ToolStripOverflow> など\) または "Strip" サフィックス \(<xref:System.Windows.Forms.MenuStrip> など\) が付きます。  
+  
+## ToolStrip  
+ このトピックでは、<xref:System.Windows.Forms.ToolStrip> およびこのクラスから派生するコントロールについて説明します。  
+  
+ <xref:System.Windows.Forms.ToolStrip> は、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.StatusStrip>、および <xref:System.Windows.Forms.ContextMenuStrip> の抽象基本クラスです。  次のオブジェクト モデルは、<xref:System.Windows.Forms.ToolStrip> 継承階層構造を示しています。  
+  
+ ![ToolStrip オブジェクト モデル](../../../../docs/framework/winforms/controls/media/toolstripobjectmodel.png "ToolStripObjectModel")  
+ToolStrip オブジェクト モデル  
+  
+ <xref:System.Windows.Forms.ToolStrip> に含まれているすべての項目には、<xref:System.Windows.Forms.ToolStrip.Items%2A> コレクションを介してアクセスできます。  <xref:System.Windows.Forms.ToolStripDropDownItem> に含まれているすべての項目には、<xref:System.Windows.Forms.ToolStripDropDownItem.DropDownItems%2A> コレクションを介してアクセスできます。  <xref:System.Windows.Forms.ToolStrip> の派生クラスでは、<xref:System.Windows.Forms.ToolStrip.DisplayedItems%2A> プロパティを使用して、現在表示されている項目のみにアクセスすることもできます。  これらは、現在オーバーフロー メニューにない項目です。  
+  
+ 次の項目は、すべての位置で <xref:System.Windows.Forms.ToolStripSystemRenderer> および <xref:System.Windows.Forms.ToolStripProfessionalRenderer> の両方とシームレスに連動するように特別にデザインされています。  これらは、<xref:System.Windows.Forms.ToolStrip> コントロールのデザイン時に既定で使用できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripButton>  
+  
+-   <xref:System.Windows.Forms.ToolStripSeparator>  
+  
+-   <xref:System.Windows.Forms.ToolStripLabel>  
+  
+-   <xref:System.Windows.Forms.ToolStripDropDownButton>  
+  
+-   <xref:System.Windows.Forms.ToolStripSplitButton>  
+  
+-   <xref:System.Windows.Forms.ToolStripTextBox>  
+  
+-   <xref:System.Windows.Forms.ToolStripComboBox>  
+  
+### MenuStrip  
+ <xref:System.Windows.Forms.MenuStrip> は、<xref:System.Windows.Forms.MainMenu> に代わる最上位のコンテナーです。  これには、キー処理機能とマルチ ドキュメント インターフェイス \(MDI\) 機能も用意されています。  <xref:System.Windows.Forms.ToolStripDropDownItem> および <xref:System.Windows.Forms.ToolStripMenuItem> は <xref:System.Windows.Forms.ToolStripItem> から派生していますが、機能的には、<xref:System.Windows.Forms.MenuStrip> と連動します。  
+  
+ 次の項目は、すべての位置で <xref:System.Windows.Forms.ToolStripSystemRenderer> および <xref:System.Windows.Forms.ToolStripProfessionalRenderer> の両方とシームレスに連動するように特別にデザインされています。  これらは、<xref:System.Windows.Forms.MenuStrip> コントロールのデザイン時に既定で使用できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripMenuItem>  
+  
+-   <xref:System.Windows.Forms.ToolStripTextBox>  
+  
+-   <xref:System.Windows.Forms.ToolStripComboBox>  
+  
+### StatusStrip  
+ <xref:System.Windows.Forms.StatusStrip> は <xref:System.Windows.Forms.StatusBar> コントロールを置き換えます。  <xref:System.Windows.Forms.StatusStrip> の特別な機能には、カスタムのテーブル レイアウトや、フォームのサイズ変更グリップと移動グリップのサポートがあります。また、使用可能な領域を <xref:System.Windows.Forms.ToolStripStatusLabel> で自動的に設定できる `Spring` プロパティもあります。  
+  
+ 次の項目は、すべての位置で <xref:System.Windows.Forms.ToolStripSystemRenderer> および <xref:System.Windows.Forms.ToolStripProfessionalRenderer> の両方とシームレスに連動するように特別にデザインされています。  これらは、<xref:System.Windows.Forms.StatusStrip> コントロールのデザイン時に既定で使用できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripStatusLabel>  
+  
+-   <xref:System.Windows.Forms.ToolStripDropDownButton>  
+  
+-   <xref:System.Windows.Forms.ToolStripSplitButton>  
+  
+-   <xref:System.Windows.Forms.ToolStripProgressBar>  
+  
+### ContextMenuStrip  
+ <xref:System.Windows.Forms.ContextMenuStrip> は <xref:System.Windows.Forms.ContextMenu> に代わるものです。  <xref:System.Windows.Forms.ContextMenuStrip> は任意のコントロールに関連付けることができ、関連付けたコントロールでは、マウスの右クリックで自動的にコンテキスト メニュー \(ショートカット メニュー\) が表示されます。  <xref:System.Windows.Forms.ToolStripDropDown.Show%2A> を使用して、<xref:System.Windows.Forms.ContextMenuStrip> をプログラムによって表示できます。  <xref:System.Windows.Forms.ContextMenuStrip> では、キャンセル可能な <xref:System.Windows.Forms.ToolStripDropDown.Opening> イベントと <xref:System.Windows.Forms.ToolStripDropDown.Closing> イベントがサポートされているため、動的な作成や複数クリックのシナリオを処理できます。  <xref:System.Windows.Forms.ContextMenuStrip> イメージ、メニュー項目のチェックの状態、テキスト、アクセス キー、ショートカット、およびカスケード メニューをサポートしています。  
+  
+ 次の項目は、すべての位置で <xref:System.Windows.Forms.ToolStripSystemRenderer> および <xref:System.Windows.Forms.ToolStripProfessionalRenderer> の両方とシームレスに連動するように特別にデザインされています。  これらは、<xref:System.Windows.Forms.ContextMenuStrip> コントロールのデザイン時に既定で使用できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripMenuItem>  
+  
+-   <xref:System.Windows.Forms.ToolStripSeparator>  
+  
+-   <xref:System.Windows.Forms.ToolStripTextBox>  
+  
+-   <xref:System.Windows.Forms.ToolStripComboBox>  
+  
+### ToolStrip の汎用機能  
+ このトピックでは、<xref:System.Windows.Forms.ToolStrip> と派生コントロールに共通の機能と動作について説明します。  
+  
+#### 描画  
+ <xref:System.Windows.Forms.ToolStrip> コントロールには、カスタム描画を行う方法がいくつかあります。  他の Windows フォーム コントロールと同様に、<xref:System.Windows.Forms.ToolStrip> と <xref:System.Windows.Forms.ToolStripItem> のどちらにも、オーバーライド可能な `OnPaint` メソッドと `Paint` イベントがあります。  通常の描画と同様に、座標系はコントロールのクライアント領域を基準としています。つまり、コントロールの左上角が 0, 0 になります。  <xref:System.Windows.Forms.ToolStripItem> の `Paint` イベントと `OnPaint` メソッドは、他のコントロール描画イベントと同じように動作します。  
+  
+ <xref:System.Windows.Forms.ToolStrip> コントロールでは、<xref:System.Windows.Forms.ToolStripRenderer> クラスを使用することにより、項目やコンテナーの描画の細部にアクセスすることもできます。このクラスには、<xref:System.Windows.Forms.ToolStrip> の背景、項目の背景、項目のイメージ、項目の矢印、項目のテキスト、および境界を描画するためのオーバーライド可能なメソッドがあります。  これらのメソッドのイベント引数は、四角形、色、テキスト形式など、目的に応じて調整できるいくつかのプロパティを公開します。  
+  
+ 項目が描画される方法についてのいくつかの側面を調整するには、通常、<xref:System.Windows.Forms.ToolStripRenderer> をオーバーライドします。  
+  
+ 新しい項目を作成していて、描画に関するすべての側面を制御する場合には、`OnPaint` メソッドをオーバーライドします。  `OnPaint` 内から、<xref:System.Windows.Forms.ToolStripRenderer> のメソッドを使用できます。  
+  
+ 既定では、<xref:System.Windows.Forms.ToolStrip> は <xref:System.Windows.Forms.ControlStyles> 設定を利用してダブル バッファリングを行います。  
+  
+#### ペアレンティング  
+ コンテナーの所有権とペアレンティングの概念は、他の Windows フォーム コンテナー コントロールよりも <xref:System.Windows.Forms.ToolStrip> コントロールの方が複雑です。  これは、オーバーフローなどの動的なシナリオをサポートし、複数の <xref:System.Windows.Forms.ToolStrip> 項目でドロップダウン項目を共有する場合や、コントロールからの <xref:System.Windows.Forms.ContextMenuStrip> の生成をサポートする場合に必要です。  
+  
+ 次の一覧は、ペアレンティングに関連するメンバーとその使用方法を示しています。  
+  
+-   <xref:System.Windows.Forms.ToolStripDropDown.OwnerItem%2A> は、ドロップダウン項目のソースの項目にアクセスします。  これは <xref:System.Windows.Forms.ContextMenuStrip.SourceControl%2A> に似ていますが、コントロールを返すのではなく、<xref:System.Windows.Forms.ToolStripItem> を返します。  
+  
+-   <xref:System.Windows.Forms.ContextMenuStrip.SourceControl%2A> は、複数のコントロールが同じ <xref:System.Windows.Forms.ContextMenuStrip> を共有している場合に、どのコントロールが <xref:System.Windows.Forms.ContextMenuStrip> のソースであるかを決定します。  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.GetCurrentParent%2A> は、<xref:System.Windows.Forms.ToolStripItem.Parent%2A> プロパティの読み取り専用アクセサーです。  親は所有者とは異なり、項目が表示される現在の <xref:System.Windows.Forms.ToolStrip> を表します。これはオーバーフロー領域の場合もあります。  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.Owner%2A> は、項目コレクションに現在の <xref:System.Windows.Forms.ToolStripItem> を含む <xref:System.Windows.Forms.ToolStrip> を返します。  この方法は、オーバーフローを処理する特別なコードを記述せずに、トップレベルの <xref:System.Windows.Forms.ToolStrip> で <xref:System.Windows.Forms.ToolStrip.ImageList%2A> や他のプロパティを参照するのに最適です。  
+  
+#### 継承したコントロールの動作  
+ 次のコントロールは、継承で使用されると常にロックされます。  
+  
+-   <xref:System.Windows.Forms.ToolStrip>  
+  
+-   <xref:System.Windows.Forms.MenuStrip>  
+  
+-   <xref:System.Windows.Forms.ContextMenuStrip>  
+  
+-   <xref:System.Windows.Forms.StatusStrip>  
+  
+-   <xref:System.Windows.Forms.ToolStripContainer> のパネルなどの <xref:System.Windows.Forms.ToolStripPanel> と個々の <xref:System.Windows.Forms.ToolStripPanel> コントロール  
+  
+ たとえば、前の一覧にあるコントロールの 1 つまたは複数を使用して、新しい Windows フォーム アプリケーションを作成します。  1 つ以上のコントロールのアクセス修飾子を `public` または `protected` に設定し、プロジェクトをビルドします。  最初のフォームから継承するフォームを追加し、継承したコントロールを選択します。  このコントロールはロックされた状態で表示され、アクセス修飾子が `private` であるかのように動作します。  
+  
+#### ToolStripContainer の継承のサポート  
+ <xref:System.Windows.Forms.ToolStripContainer> コントロールは、次の例のような限定された継承のシナリオをサポートしています。  
+  
+1.  新しい Windows フォームアプリケーションを作成します。  
+  
+2.  フォームに <xref:System.Windows.Forms.ToolStripContainer> を追加します。  
+  
+3.  <xref:System.Windows.Forms.ToolStripContainer> のアクセス修飾子を `public` または `protected` に設定します。  
+  
+4.  <xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.ContextMenuStrip> の各コントロールを任意に組み合わせて、<xref:System.Windows.Forms.ToolStripContainer> の <xref:System.Windows.Forms.ToolStripPanel> 領域に追加します。  
+  
+5.  プロジェクトをビルドします。  
+  
+6.  最初のフォームから継承するフォームを追加します。  
+  
+7.  継承した <xref:System.Windows.Forms.ToolStripContainer> をフォーム上で選択します。  
+  
+#### 子コントロールの継承の動作  
+ 前の手順を完了すると、次のような継承の動作が発生します。  
+  
+-   デザイナーには、継承したアイコンと一緒にコントロールが表示されます。  
+  
+-   <xref:System.Windows.Forms.ToolStripPanel> コントロールはロックされます。コンテンツの選択や再配置を行うことはできません。  
+  
+-   コントロールは、<xref:System.Windows.Forms.ToolStripContentPanel> に追加したり移動したりできます。また、<xref:System.Windows.Forms.ToolStripContentPanel> の子コントロールすることもできます。  
+  
+-   変更内容はフォームのビルド後も保持されます。  
+  
+    > [!NOTE]
+    >  削除する必要がある場合は、<xref:System.Windows.Forms.ToolStripContainer> に含まれているすべての <xref:System.Windows.Forms.ToolStripPanel> コントロールから、アクセス修飾子を削除してください。  この場合は、<xref:System.Windows.Forms.ToolStripContainer> のアクセス修飾子によってコントロール全体が制御されます。  
+  
+#### 部分信頼  
+ 部分的にしか信頼のない状況では、不用意に入力した個人情報が認証されていない個人やサービスから使われることのないように、`ToolStrip` に制限が適用されます。  次のような保護方法があります。  
+  
+-   `ToolStripDropDown` コントロールで <xref:System.Windows.Forms.ToolStripControlHost> の項目を表示するには、<xref:System.Security.Permissions.UIPermissionWindow> が必要です。  これは、<xref:System.Windows.Forms.ToolStripTextBox>、<xref:System.Windows.Forms.ToolStripComboBox>、<xref:System.Windows.Forms.ToolStripProgressBar> などの組み込みコントロールだけでなく、ユーザーが作成したコントロールにも適用されます。  この要件に適合しない場合、このような項目は表示されません。  例外をスローすることはありません。  
+  
+-   <xref:System.Windows.Forms.ToolStripDropDown.AutoClose%2A> プロパティを `false` に設定することはできません。また、キャンセル可能な <xref:System.Windows.Forms.ToolStripDropDown.Closing> イベント パラメーターは無視されます。  このため、ドロップダウン項目を表示したまま複数のキーストロークを入力することはできなくなります。  この要件に適合しない場合、このような項目は表示されません。  例外をスローすることはありません。  
+  
+-   <xref:System.Security.Permissions.UIPermissionWindow> 以外の部分信頼の状況でキーストロークが発生しても、多くのキーストローク処理イベントは生成されません。  
+  
+-   <xref:System.Security.Permissions.UIPermissionWindow> が付与されていない場合、アクセス キーは処理されません。  
+  
+#### 使用方法  
+ 次の使用パターンは、<xref:System.Windows.Forms.ToolStrip> のレイアウト、キーボードの対話的操作、およびエンド ユーザーの動作に影響します。  
+  
+-   <xref:System.Windows.Forms.ToolStripPanel> への追加  
+  
+     <xref:System.Windows.Forms.ToolStrip> は、<xref:System.Windows.Forms.ToolStripPanel> 内および <xref:System.Windows.Forms.ToolStripPanel> 間に移動できます。  `Dock` プロパティは無視されます。また、<xref:System.Windows.Forms.ToolStrip.Stretch%2A> プロパティが `false` の場合は、項目が <xref:System.Windows.Forms.ToolStripPanel> に追加されるたびに <xref:System.Windows.Forms.ToolStrip> のサイズが増加します。  通常、<xref:System.Windows.Forms.ToolStrip> はタブ オーダーに含められません。  
+  
+-   ドッキング  
+  
+     <xref:System.Windows.Forms.ToolStrip> はコンテナーの一辺の固定位置に配置され、サイズがドッキング対象の辺全体に拡張されます。  通常、<xref:System.Windows.Forms.ToolStrip> はタブ オーダーに含められません。  
+  
+-   絶対配置  
+  
+     他のコントロールと同様に、<xref:System.Windows.Forms.ToolStrip> は <xref:System.Windows.Forms.Control.Location%2A> プロパティによって配置され、サイズが固定され、通常はタブ オーダーに含められます。  
+  
+#### キーボードによる対話操作  
+  
+##### アクセス キー  
+ Alt キーと同時または Alt キーに続けてアクセス キーを入力する操作は、キーボードを使用してコントロールをアクティブ化する 1 つの方法です。  <xref:System.Windows.Forms.ToolStrip> では、明示的および暗黙的なアクセス キーの両方がサポートされます。  明示的な定義では、文字の前にアンパサンド \(&\) 文字を付けます。  暗黙的な定義では、指定された `Text` プロパティの文字の順序に基づいて、一致する項目を検出するアルゴリズムが使用されます。  
+  
+##### ショートカット キー  
+ <xref:System.Windows.Forms.MenuStrip> で使用するショートカット キーは、<xref:System.Windows.Forms.Keys> 列挙値 \(順序が特定されているわけではありません\) の組み合わせを使用して定義します。  また、<xref:System.Windows.Forms.ToolStripMenuItem.ShortcutKeyDisplayString%2A> プロパティを使用すると、テキストのみを使用してショートカット キーを表示できます。たとえば、"Delete" の代わりに "Del" と表示できます。  
+  
+##### Navigation  
+ Alt キーは、<xref:System.Windows.Forms.Form.MainMenuStrip%2A> で指定される <xref:System.Windows.Forms.MenuStrip> をアクティブ化します。  この状態で Ctrl \+ Tab キーを使用すると、`ToolStripPanel` 内の <xref:System.Windows.Forms.ToolStrip> コントロール間を移動できます。  Tab キーおよびテンキーの方向キーを使用すると、<xref:System.Windows.Forms.ToolStrip> の項目間を移動できます。  オーバーフロー領域の移動は、特別なアルゴリズムによって処理されます。  Space キーを押すと、<xref:System.Windows.Forms.ToolStripButton>、<xref:System.Windows.Forms.ToolStripDropDownButton>、または <xref:System.Windows.Forms.ToolStripSplitButton> が選択されます。  
+  
+##### フォーカスと検証  
+ Alt キーで <xref:System.Windows.Forms.MenuStrip> または <xref:System.Windows.Forms.ToolStrip> をアクティブ化しても、通常、現在フォーカスがあるコントロールからフォーカスが移動したり削除されたりすることはありません。  <xref:System.Windows.Forms.MenuStrip> 内でホストされているコントロールまたは <xref:System.Windows.Forms.MenuStrip> のドロップダウンがある場合、ユーザーが Tab キーを押すとコントロールはフォーカスを取得します。  一般的に、<xref:System.Windows.Forms.MenuStrip> の <xref:System.Windows.Forms.Control.GotFocus>、<xref:System.Windows.Forms.Control.LostFocus>、<xref:System.Windows.Forms.Control.Enter>、<xref:System.Windows.Forms.Control.Leave> の各イベントは、キーボードでアクティブ化した場合は発生しません。  このような場合は、代わりに <xref:System.Windows.Forms.MenuStrip.MenuActivate> イベントと <xref:System.Windows.Forms.MenuStrip.MenuDeactivate> イベントを使用します。  
+  
+ 既定では、<xref:System.Windows.Forms.ToolStrip.CausesValidation%2A> は `false` に設定されています。  検証を実行するには、フォームで明示的に <xref:System.Windows.Forms.ContainerControl.Validate%2A> を呼び出します。  
+  
+#### \[レイアウト\]  
+ <xref:System.Windows.Forms.ToolStrip> のレイアウトを制御するには、<xref:System.Windows.Forms.ToolStrip.LayoutStyle%2A> プロパティで <xref:System.Windows.Forms.ToolStripLayoutStyle> のメンバーの 1 つを選択します。  
+  
+##### スタック レイアウト  
+ スタックとは、<xref:System.Windows.Forms.ToolStrip> の両端が互いに密着するように項目を配置することです。  次の一覧に、スタック レイアウトの説明を示します。  
+  
+-   <xref:System.Windows.Forms.ToolStripLayoutStyle> が既定値です。  この設定により、<xref:System.Windows.Forms.ToolStrip> は、<xref:System.Windows.Forms.ToolStrip.Orientation%2A> プロパティに従ってそのレイアウトを自動的に変更し、ドラッグおよびドッキングのシナリオに対応します。  
+  
+-   <xref:System.Windows.Forms.ToolStripLayoutStyle> は、<xref:System.Windows.Forms.ToolStrip> の項目を縦方向に並べて描画します。  
+  
+-   <xref:System.Windows.Forms.ToolStripLayoutStyle> は、<xref:System.Windows.Forms.ToolStrip> の項目を横方向に並べて描画します。  
+  
+##### スタック レイアウトのその他の機能  
+ <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> は、項目が配置される <xref:System.Windows.Forms.ToolStrip> の末尾を決定します。  
+  
+ 項目が <xref:System.Windows.Forms.ToolStrip> 内に収まらない場合は、オーバーフロー ボタンが自動的に表示されます。  <xref:System.Windows.Forms.ToolStripItem.Overflow%2A> プロパティの設定によって、項目を常にオーバーフロー領域に表示する、必要な場合のみ表示する、または表示しないのいずれかに決定します。  
+  
+ <xref:System.Windows.Forms.ToolStrip.LayoutCompleted> イベントでは、<xref:System.Windows.Forms.ToolStripItem.Placement%2A> プロパティを調べ、項目がメインの <xref:System.Windows.Forms.ToolStrip> とオーバーフロー状態の <xref:System.Windows.Forms.ToolStrip> のどちらに配置されているか、または現在はまったく表示されていないかを確認できます。  項目が表示されない典型的な理由は、項目がメインの <xref:System.Windows.Forms.ToolStrip> に収まらず、その <xref:System.Windows.Forms.ToolStripItem.Overflow%2A> プロパティが <xref:System.Windows.Forms.ToolStripItemOverflow> に設定されていることです。  
+  
+ <xref:System.Windows.Forms.ToolStrip> を移動できるようにするには、これを <xref:System.Windows.Forms.ToolStripPanel> に配置し、その <xref:System.Windows.Forms.ToolStrip.GripStyle%2A> を <xref:System.Windows.Forms.ToolStripGripStyle> に設定します。  
+  
+##### その他のレイアウト オプション  
+ その他のレイアウト オプションとして、<xref:System.Windows.Forms.ToolStripLayoutStyle> および <xref:System.Windows.Forms.ToolStripLayoutStyle> があります。  
+  
+##### フロー レイアウト  
+ <xref:System.Windows.Forms.ContextMenuStrip>、<xref:System.Windows.Forms.ToolStripDropDownMenu>、および <xref:System.Windows.Forms.ToolStripOverflow> の場合は、<xref:System.Windows.Forms.ToolStripLayoutStyle> が既定のレイアウトです。  このレイアウトは、<xref:System.Windows.Forms.FlowLayoutPanel> に似ています。  <xref:System.Windows.Forms.ToolStripLayoutStyle> レイアウトの機能は次のとおりです。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.LayoutSettings%2A> プロパティによって、<xref:System.Windows.Forms.FlowLayoutPanel> のすべての機能が公開されています。  <xref:System.Windows.Forms.LayoutSettings> クラスを <xref:System.Windows.Forms.FlowLayoutSettings> クラスにキャストする必要があります。  
+  
+-   コード内で <xref:System.Windows.Forms.ToolStripItem.Dock%2A> プロパティおよび <xref:System.Windows.Forms.ToolStripItem.Anchor%2A> プロパティを使用して、項目を行内に配置できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> プロパティは無視されます。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.LayoutCompleted> イベントでは、<xref:System.Windows.Forms.ToolStripItem.Placement%2A> プロパティを調べ、項目がメインの <xref:System.Windows.Forms.ToolStrip> に配置されたか、収まらなかったかを確認できます。  
+  
+-   グリップが描画されないため、<xref:System.Windows.Forms.ToolStripPanel> にある <xref:System.Windows.Forms.ToolStripLayoutStyle> レイアウト スタイルの <xref:System.Windows.Forms.ToolStrip> を移動できません。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> オーバーフロー ボタンは描画されません。また、<xref:System.Windows.Forms.ToolStripItem.Overflow%2A> は無視されます。  
+  
+##### テーブル レイアウト  
+ <xref:System.Windows.Forms.StatusStrip> の場合は、<xref:System.Windows.Forms.ToolStripLayoutStyle> が既定のレイアウトです。  このレイアウトは、<xref:System.Windows.Forms.TableLayoutPanel> に似ています。  <xref:System.Windows.Forms.ToolStripLayoutStyle> レイアウトの機能は次のとおりです。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.LayoutSettings%2A> プロパティによって、<xref:System.Windows.Forms.TableLayoutPanel> のすべての機能が公開されています。  <xref:System.Windows.Forms.LayoutSettings> クラスを <xref:System.Windows.Forms.TableLayoutSettings> クラスにキャストする必要があります。  
+  
+-   コード内で <xref:System.Windows.Forms.ToolStripItem.Dock%2A> プロパティおよび <xref:System.Windows.Forms.ToolStripItem.Anchor%2A> プロパティを使用して、項目をテーブルのセル内に配置できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> プロパティは無視されます。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.LayoutCompleted> イベントでは、<xref:System.Windows.Forms.ToolStripItem.Placement%2A> プロパティを調べ、項目がメインの <xref:System.Windows.Forms.ToolStrip> に配置されたか、収まらなかったかを確認できます。  
+  
+-   グリップが描画されないため、<xref:System.Windows.Forms.ToolStripPanel> の <xref:System.Windows.Forms.ToolStripLayoutStyle> レイアウト スタイルでは <xref:System.Windows.Forms.ToolStrip> を削除できません。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> オーバーフロー ボタンは描画されません。また、<xref:System.Windows.Forms.ToolStripItem.Overflow%2A> は無視されます。  
+  
+## ToolStripItem  
+ このトピックでは、<xref:System.Windows.Forms.ToolStripItem> およびこのクラスから派生するコントロールについて説明します。  
+  
+ <xref:System.Windows.Forms.ToolStripItem> は、<xref:System.Windows.Forms.ToolStrip> に追加されるすべての項目に対する抽象基本クラスです。  次のオブジェクト モデルは、<xref:System.Windows.Forms.ToolStripItem> 継承階層構造を示しています。  
+  
+ ![ToolStripItem オブジェクト モデル](../../../../docs/framework/winforms/controls/media/toolstripitemobjectmodel.png "ToolStripItemObjectModel")  
+ToolStripItem オブジェクト モデル  
+  
+ <xref:System.Windows.Forms.ToolStripItem> クラスは、<xref:System.Windows.Forms.ToolStripItem> から直接継承するか、<xref:System.Windows.Forms.ToolStripControlHost> または <xref:System.Windows.Forms.ToolStripDropDownItem> を介して <xref:System.Windows.Forms.ToolStripItem> から間接的に継承します。  
+  
+ <xref:System.Windows.Forms.ToolStripItem> コントロールは、<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.StatusStrip>、または <xref:System.Windows.Forms.ContextMenuStrip> に格納される必要があり、フォームに直接追加できません。  <xref:System.Windows.Forms.ToolStripItem> コントロールの適切なサブセットを含むさまざまなコンテナー クラスが設計されています。  
+  
+ <xref:System.Windows.Forms.ToolStripItem> ストック コントロールおよびこれらのコントロールが最適に表示されるコンテナーを次の表に示します。  <xref:System.Windows.Forms.ToolStrip> 項目は <xref:System.Windows.Forms.ToolStrip> の派生コンテナーであればどれでもホストできますが、以下に示すコンテナー内で最適に表示されるように設計されています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.ToolStripDropDown> は、デザイナー ツールボックスには表示されません。  
+  
+|含まれる項目|ToolStrip|MenuStrip|ContextMenuStrip|StatusStrip|ToolStripDropDown|  
+|------------|---------------|---------------|----------------------|-----------------|-----------------------|  
+|<xref:System.Windows.Forms.ToolStripButton>|○|Ｘ|Ｘ|Ｘ|○|  
+|<xref:System.Windows.Forms.ToolStripComboBox>|○|○|○|Ｘ|○|  
+|<xref:System.Windows.Forms.ToolStripSplitButton>|○|Ｘ|Ｘ|○|○|  
+|<xref:System.Windows.Forms.ToolStripLabel>|○|Ｘ|Ｘ|○|○|  
+|<xref:System.Windows.Forms.ToolStripSeparator>|○|○|○|Ｘ|○|  
+|<xref:System.Windows.Forms.ToolStripDropDownButton>|○|Ｘ|Ｘ|○|○|  
+|<xref:System.Windows.Forms.ToolStripTextBox>|○|○|○|Ｘ|○|  
+|<xref:System.Windows.Forms.ToolStripMenuItem>|Ｘ|○|○|Ｘ|Ｘ|  
+|<xref:System.Windows.Forms.ToolStripStatusLabel>|Ｘ|Ｘ|Ｘ|○|Ｘ|  
+|<xref:System.Windows.Forms.ToolStripProgressBar>|○|Ｘ|Ｘ|○|Ｘ|  
+|<xref:System.Windows.Forms.ToolStripControlHost>|○|○|Ｘ|○|○|  
+  
+### ToolStripButton  
+ <xref:System.Windows.Forms.ToolStripButton> は <xref:System.Windows.Forms.ToolStrip> のボタン項目です。  さまざまな境界線スタイルで表示でき、操作状態を表したりアクティブ化したりするためにも使用できます。  既定でフォーカスが設定されるように定義することもできます。  
+  
+### ToolStripLabel  
+ <xref:System.Windows.Forms.ToolStripLabel> は、<xref:System.Windows.Forms.ToolStrip> コントロールにラベル機能を提供します。  <xref:System.Windows.Forms.ToolStripLabel> は <xref:System.Windows.Forms.ToolStripButton> と似ており、既定ではフォーカスが設定されず、押下または強調表示された状態として描画されることもありません。  
+  
+ ホストされる項目としての <xref:System.Windows.Forms.ToolStripLabel> では、アクセス キーがサポートされます。  
+  
+ <xref:System.Windows.Forms.ToolStrip> でリンク コントロールをサポートするには、<xref:System.Windows.Forms.ToolStripLabel> の <xref:System.Windows.Forms.LinkLabel.LinkColor%2A>、<xref:System.Windows.Forms.LinkLabel.LinkVisited%2A>、<xref:System.Windows.Forms.LinkLabel.LinkBehavior%2A> の各プロパティを使用します。  
+  
+### ToolStripStatusLabel  
+ <xref:System.Windows.Forms.ToolStripStatusLabel> は、<xref:System.Windows.Forms.StatusStrip> で使用するように特別に設計されたバージョンの <xref:System.Windows.Forms.ToolStripLabel> です。  固有の機能として、<xref:System.Windows.Forms.ToolStripStatusLabel.BorderStyle%2A>、<xref:System.Windows.Forms.ToolStripStatusLabel.BorderSides%2A>、および <xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A> があります。  
+  
+### ToolStripSeparator  
+ <xref:System.Windows.Forms.ToolStripSeparator> は、ツール バーまたはメニューの方向に応じて、縦線または横線を追加します。  メニュー項目など、項目間のグループ化や区切りに使用できます。  
+  
+ <xref:System.Windows.Forms.ToolStripSeparator> を追加するには、デザイン時にドロップダウン リストから選択します。  ただし、デザイナーのテンプレート ノードまたは <xref:System.Windows.Forms.ToolStripItemCollection.Add%2A> メソッドでハイフン \(\-\) を入力することで、自動的に <xref:System.Windows.Forms.ToolStripSeparator> を作成することもできます。  
+  
+### ToolStripControlHost  
+ <xref:System.Windows.Forms.ToolStripControlHost> は、<xref:System.Windows.Forms.ToolStripComboBox>、<xref:System.Windows.Forms.ToolStripTextBox>、および <xref:System.Windows.Forms.ToolStripProgressBar> の抽象基本クラスです。  <xref:System.Windows.Forms.ToolStripControlHost> は、カスタム コントロールを含む他のコントロールを次の 2 つの方法でホストできます。  
+  
+-   <xref:System.Windows.Forms.Control> から派生するクラスを使用して <xref:System.Windows.Forms.ToolStripControlHost> を構築します。  ホストされるコントロールおよびプロパティに完全にアクセスするには、<xref:System.Windows.Forms.ToolStripControlHost.Control%2A> プロパティをキャストして、このプロパティが表す実際のクラスに戻す必要があります。  
+  
+-   <xref:System.Windows.Forms.ToolStripControlHost> を拡張し、継承クラスの既定のコンストラクター内で、<xref:System.Windows.Forms.Control> から派生したクラスを渡す基本クラス コンストラクターを呼び出します。  このオプションを使用して一般的なコントロール メソッドとプロパティをラップすると、<xref:System.Windows.Forms.ToolStrip> 内でのアクセスが簡単になります。  
+  
+### ToolStripComboBox  
+ <xref:System.Windows.Forms.ToolStripComboBox> は、<xref:System.Windows.Forms.ToolStrip> でホストするために最適化された <xref:System.Windows.Forms.ComboBox> です。  ホストされるコントロールのプロパティとイベントのサブセットは <xref:System.Windows.Forms.ToolStripComboBox> レベルで公開されますが、基になる <xref:System.Windows.Forms.ComboBox> コントロールは <xref:System.Windows.Forms.ToolStripComboBox.ComboBox%2A> プロパティを使用して完全にアクセスできます。  
+  
+### ToolStripTextBox  
+ <xref:System.Windows.Forms.ToolStripTextBox> は、<xref:System.Windows.Forms.ToolStrip> でホストするために最適化された <xref:System.Windows.Forms.TextBox> です。  ホストされるコントロールのプロパティとイベントのサブセットは <xref:System.Windows.Forms.ToolStripTextBox> レベルで公開されますが、基になる <xref:System.Windows.Forms.TextBox> コントロールは <xref:System.Windows.Forms.ToolStripTextBox.TextBox%2A> プロパティを使用して完全にアクセスできます。  
+  
+### ToolStripProgressBar  
+ <xref:System.Windows.Forms.ToolStripProgressBar> は、<xref:System.Windows.Forms.ToolStrip> でホストするために最適化された <xref:System.Windows.Forms.ProgressBar> です。  ホストされるコントロールのプロパティとイベントのサブセットは <xref:System.Windows.Forms.ToolStripProgressBar> レベルで公開されますが、基になる <xref:System.Windows.Forms.ProgressBar> コントロールは <xref:System.Windows.Forms.ToolStripProgressBar.ProgressBar%2A> プロパティを使用して完全にアクセスできます。  
+  
+### ToolStripDropDownItem  
+ <xref:System.Windows.Forms.ToolStripDropDownItem> は、<xref:System.Windows.Forms.ToolStripMenuItem>、<xref:System.Windows.Forms.ToolStripDropDownButton>、および <xref:System.Windows.Forms.ToolStripSplitButton> の抽象基本クラスです。項目を直接ホストしたり、ドロップダウン コンテナーで追加項目をホストしたりできます。  これを実行するには、<xref:System.Windows.Forms.ToolStripDropDownItem.DropDown%2A> プロパティを <xref:System.Windows.Forms.ToolStripDropDown> に設定して、<xref:System.Windows.Forms.ToolStripDropDown> の <xref:System.Windows.Forms.ToolStrip.Items%2A> プロパティを設定します。  これらのドロップダウン項目には、<xref:System.Windows.Forms.ToolStripDropDownItem.DropDownItems%2A> プロパティを使用して直接アクセスできます。  
+  
+### ToolStripMenuItem  
+ <xref:System.Windows.Forms.ToolStripMenuItem> は、<xref:System.Windows.Forms.ToolStripDropDownMenu> や <xref:System.Windows.Forms.ContextMenuStrip> と連携して、メニューの特殊な強調表示、レイアウト、および列の配置を処理する <xref:System.Windows.Forms.ToolStripDropDownItem> です。  
+  
+### ToolStripDropDownButton  
+ <xref:System.Windows.Forms.ToolStripDropDownButton> は <xref:System.Windows.Forms.ToolStripButton> に似ていますが、ユーザーがクリックするとドロップダウン領域が表示される点が異なります。  <xref:System.Windows.Forms.ToolStripDropDownButton.ShowDropDownArrow%2A> プロパティを設定することで、ドロップダウン矢印を表示または非表示にできます。  <xref:System.Windows.Forms.ToolStripDropDownButton> は、<xref:System.Windows.Forms.ToolStrip> をオーバーフローする項目を表示する <xref:System.Windows.Forms.ToolStripOverflowButton> をホストします。  
+  
+### ToolStripSplitButton  
+ <xref:System.Windows.Forms.ToolStripSplitButton> は、ボタンとドロップダウン ボタンの機能を組み合わせます。  
+  
+ <xref:System.Windows.Forms.ToolStripSplitButton.DefaultItem%2A> プロパティを使用して、選択されたドロップダウン項目に対応する <xref:System.Windows.Forms.Control.Click> イベントと、ボタンに表示される項目とを同期します。  
+  
+### ToolStripItem の汎用機能  
+ <xref:System.Windows.Forms.ToolStripItem> には、次のように、継承するコントロールに共通の機能とオプションがあります。  
+  
+-   コア イベント  
+  
+-   イメージ処理  
+  
+-   \[配置\]  
+  
+-   テキストとイメージの関係  
+  
+-   表示スタイル  
+  
+#### コア イベント  
+ <xref:System.Windows.Forms.ToolStripItem> では、自身に対するクリック イベント、マウス イベント、および描画イベントを受け取り、なんらかのキーボードの前処理を実行することもできます。  
+  
+#### イメージ処理  
+ <xref:System.Windows.Forms.ToolStripItem.Image%2A>、<xref:System.Windows.Forms.ToolStripItem.ImageAlign%2A>、<xref:System.Windows.Forms.ToolStripItem.ImageIndex%2A>、<xref:System.Windows.Forms.ToolStripItem.ImageKey%2A>、<xref:System.Windows.Forms.ToolStripItem.ImageScaling%2A> の各プロパティは、イメージ処理のさまざまな要素に関連しています。  <xref:System.Windows.Forms.ToolStrip> コントロールでイメージを使用するには、これらのプロパティを手動で設定するか、実行時のみに有効な <xref:System.Windows.Forms.ToolStrip.ImageList%2A> プロパティを設定します。  
+  
+ イメージのスケーリングは、次のように、<xref:System.Windows.Forms.ToolStrip> および <xref:System.Windows.Forms.ToolStripItem> の両方のプロパティの相互作用によって決まります。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.ImageScalingSize%2A> は、イメージの <xref:System.Windows.Forms.ToolStripItem.ImageScaling%2A> の設定とコンテナーの <xref:System.Windows.Forms.ToolStrip.AutoSize%2A> の設定の組み合わせによって決まる、最終的なイメージのスケールです。  
+  
+    -   <xref:System.Windows.Forms.ToolStrip.AutoSize%2A> が `true` \(既定\) で <xref:System.Windows.Forms.ToolStripItemImageScaling> が <xref:System.Windows.Forms.ToolStripItemImageScaling> の場合、イメージの拡大と縮小は行われず、<xref:System.Windows.Forms.ToolStrip> のサイズは最大の項目と同じサイズまたは定義済みの最小サイズになります。  
+  
+    -   <xref:System.Windows.Forms.ToolStrip.AutoSize%2A> が `false` で <xref:System.Windows.Forms.ToolStripItemImageScaling> が <xref:System.Windows.Forms.ToolStripItemImageScaling> の場合、イメージや <xref:System.Windows.Forms.ToolStrip> の拡大と縮小は行われません。  
+  
+#### \[配置\]  
+ <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> プロパティの値は、項目を表示する <xref:System.Windows.Forms.ToolStrip> の辺を決定します。  <xref:System.Windows.Forms.ToolStripItem.Alignment%2A> プロパティが機能するのは、<xref:System.Windows.Forms.ToolStrip> のレイアウト スタイルがスタック オーバーフロー値のいずれかに設定されている場合のみです。  
+  
+ 項目は、項目コレクションに表示される順序で <xref:System.Windows.Forms.ToolStrip> に配置されます。  項目を配置する場所をプログラムで変更するには、<xref:System.Windows.Forms.ToolStripItemCollection.Insert%2A> メソッドを使用してコレクションの項目を移動します。  このメソッドは項目を移動しますが、複製はしません。  
+  
+#### テキストとイメージの関係  
+ <xref:System.Windows.Forms.ToolStripItem.TextImageRelation%2A> プロパティは、<xref:System.Windows.Forms.ToolStripItem> 上のテキストに対するイメージの相対的位置を定義します。  イメージ、テキスト、またはその両方がない項目は、<xref:System.Windows.Forms.ToolStripItem> で存在しない要素の代わりに空白が表示されないように、特別なケースとして扱われます。  
+  
+#### 表示スタイル  
+ <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> を使用すると、項目の Text プロパティと Image プロパティの値を設定して必要なものだけを表示できます。  これは通常、同じ項目を異なるコンテキストで表示するとき、表示スタイルだけを変更するために使用されます。  
+  
+## アクセサリ クラス  
+ 次のように、他にもさまざまな機能を実現するクラスがあります。  
+  
+-   <xref:System.Windows.Forms.ToolStripManager> は、アプリケーション全体について <xref:System.Windows.Forms.ToolStrip> 関連のタスクをサポートします。たとえば、マージ、設定、レンダラーのオプションなどがあります。  
+  
+-   <xref:System.Windows.Forms.ToolStripRenderer> を使用すると、特定のスタイルやテーマを簡単に <xref:System.Windows.Forms.ToolStrip> に適用できます。  
+  
+-   <xref:System.Windows.Forms.ToolStripProfessionalRenderer> は、置き換えることのできるカラー テーブル \(<xref:System.Windows.Forms.ProfessionalColorTable>\) に基づいてペンとブラシを作成します。  
+  
+-   <xref:System.Windows.Forms.ToolStripSystemRenderer> は、システム カラーとフラットな visual スタイルを <xref:System.Windows.Forms.ToolStrip> アプリケーションに適用します。  
+  
+-   <xref:System.Windows.Forms.ToolStripContainer> は <xref:System.Windows.Forms.SplitContainer> と似ています。  ドッキング対象の 4 つのサイド パネル \(<xref:System.Windows.Forms.ToolStripPanel> のインスタンス\) と、1 つのセントラル パネル \(<xref:System.Windows.Forms.ToolStripContentPanel> のインスタンス\) を使用して、一般的な配置が作成されます。  サイド パネルは削除できませんが、非表示にすることはできます。  セントラル パネルを削除または非表示にすることはできません。  1 つ以上の <xref:System.Windows.Forms.ToolStrip> コントロール、<xref:System.Windows.Forms.MenuStrip> コントロール、または <xref:System.Windows.Forms.StatusStrip> コントロールをサイド パネルに配置でき、他のコントロールにはセントラル パネルを使用できます。  <xref:System.Windows.Forms.ToolStripContentPanel> には、フォーム本体にレンダラーのサポートを取り入れ、一貫した状態で表示する方法も用意されています。  <xref:System.Windows.Forms.ToolStripContainer> はマルチ ドキュメント インターフェイス \(MDI\) をサポートしていません。  
+  
+-   <xref:System.Windows.Forms.ToolStripPanel> は、<xref:System.Windows.Forms.ToolStrip> コントロールを移動および配置する領域を作成します。  1 つのパネルだけを使用することもできますが、<xref:System.Windows.Forms.ToolStripPanel> は MDI のシナリオにも適しています。  
+  
+## 参照  
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)   
+ [StatusStrip コントロール](../../../../docs/framework/winforms/controls/statusstrip-control.md)   
+ [ContextMenuStrip コントロール](../../../../docs/framework/winforms/controls/contextmenustrip-control.md)   
+ [BindingNavigator コントロール](../../../../docs/framework/winforms/controls/bindingnavigator-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md b/docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md
new file mode 100644
index 00000000000..8dd9b30539d
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md
@@ -0,0 +1,97 @@
+---
+title: "ToolStrip コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Toolstrip"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム]"
+  - "ツール バー [Windows フォーム], 新機能 (Windows フォームの)"
+  - "ToolStrip コントロール [Windows フォーム], ToolStrip コントロールの概要"
+  - "新機能 [Windows フォーム], ツール バー"
+ms.assetid: 81d067ed-297c-4dad-90de-1bcac15336ec
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ToolStrip コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ToolStrip> コントロールと関連クラスには、ユーザー インターフェイス要素をツール バー、ステータス バー、およびメニューに組み込むための共通のフレームワークがあります。  <xref:System.Windows.Forms.ToolStrip> コントロールは、埋め込み先編集の有効化、カスタム レイアウト、およびラフティング \(水平スペースまたは垂直スペースを共有するツール バーの機能\) を含む豊富なデザイン時機能を提供します。  
+  
+ <xref:System.Windows.Forms.ToolStrip> コントロールは、以前のバージョンのコントロールに置き換わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolBar> コントロールは、下位互換性を保持するため、および将来必要になったときに使用できるように保持されています。  
+  
+## ToolStrip コントロールの機能  
+ <xref:System.Windows.Forms.ToolStrip> コントロールを使用すると、次のことができます。  
+  
+-   コンテナー間に共通のユーザー インターフェイスを提供する。  
+  
+-   カスタマイズでき、一般に使用できるだけでなく、高度なユーザー インターフェイス機能とレイアウト機能 \(ドッキング、ラフティング、テキストおよびイメージ付きボタン、ドロップダウン ボタンとドロップダウン コントロール、オーバーフロー ボタン、実行時の <xref:System.Windows.Forms.ToolStrip> 項目の並べ替えなど\) をサポートするツール バーを簡単に作成する。  
+  
+-   オーバーフローおよび実行時の項目の順序変更をサポートする。  オーバーフロー機能は、スペース不足で <xref:System.Windows.Forms.ToolStrip> に項目を表示できない場合に、項目をドロップダウン メニューに移動します。  
+  
+-   共通の描画モデルにより、オペレーティング システムの標準的な外観と動作をサポートする。  
+  
+-   他のコントロールのイベント処理と同じように、コンテナーおよびコンテナーに含まれる項目のすべてを一貫して処理する。  
+  
+-   複数の <xref:System.Windows.Forms.ToolStrip> 間、または特定の <xref:System.Windows.Forms.ToolStrip> 内で項目をドラッグする。  
+  
+-   高度なレイアウトを使用したドロップダウン コントロールおよびユーザー インターフェイス型エディターを <xref:System.Windows.Forms.ToolStripDropDown> で作成する。  
+  
+ <xref:System.Windows.Forms.ToolStripControlHost> クラスを使用して <xref:System.Windows.Forms.ToolStrip> 上で他のコントロールを使用し、それらの <xref:System.Windows.Forms.ToolStrip> 機能を取得します。  
+  
+ <xref:System.Windows.Forms.ToolStripRenderer>、<xref:System.Windows.Forms.ToolStripProfessionalRenderer>、および <xref:System.Windows.Forms.ToolStripManager> を <xref:System.Windows.Forms.ToolStripRenderMode> 列挙型および <xref:System.Windows.Forms.ToolStripManagerRenderMode> 列挙型と共に使用すると、機能を拡張して外観と動作を変更できます。  
+  
+ <xref:System.Windows.Forms.ToolStrip> コントロールは構成が簡単で、拡張性に優れています。また、外観と動作をカスタマイズするためのさまざまなプロパティ、メソッド、およびイベントを提供します。  以下に、いくつかの重要なメンバーを示します。  
+  
+### 重要な ToolStrip メンバー  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ToolStrip.Dock%2A>|<xref:System.Windows.Forms.ToolStrip> のドッキング先となる親コンテナーの端を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.AllowItemReorder%2A>|<xref:System.Windows.Forms.ToolStrip> クラスがドラッグ アンド ドロップおよび項目の並べ替えをプライベートで処理するかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.LayoutStyle%2A>|<xref:System.Windows.Forms.ToolStrip> が項目をレイアウトする方法を示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripItem.Overflow%2A>|<xref:System.Windows.Forms.ToolStripItem> を <xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.ToolStripOverflowButton> のどちらかに結び付けるか、または両者の間でフローティングできるかを取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.IsDropDown%2A>|<xref:System.Windows.Forms.ToolStripItem> をクリックしたときに、<xref:System.Windows.Forms.ToolStripItem> がドロップダウン リストに他の項目を表示するかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.OverflowButton%2A>|オーバーフローが有効になった <xref:System.Windows.Forms.ToolStrip> のオーバーフロー ボタンである <xref:System.Windows.Forms.ToolStripItem> を取得します。|  
+|<xref:System.Windows.Forms.ToolStrip.Renderer%2A>|<xref:System.Windows.Forms.ToolStrip> の外観と動作 \(ルック アンド フィール\) のカスタマイズに使用される <xref:System.Windows.Forms.ToolStripRenderer> を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.RenderMode%2A>|<xref:System.Windows.Forms.ToolStrip> に適用される描画スタイルを取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStrip.RendererChanged>|<xref:System.Windows.Forms.ToolStrip.Renderer%2A> プロパティが変更されると発生します。|  
+  
+ <xref:System.Windows.Forms.ToolStrip> コントロールの柔軟性は、多数のコンパニオン クラスを使用することによって実現されます。  以下に、最も重要なコンパニオン クラスを示します。  
+  
+### 重要な ToolStrip コンパニオン クラス  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.MenuStrip>|<xref:System.Windows.Forms.MainMenu> クラスに対して機能の置き換えと追加を行います。|  
+|<xref:System.Windows.Forms.StatusStrip>|<xref:System.Windows.Forms.StatusBar> クラスに対して機能の置き換えと追加を行います。|  
+|<xref:System.Windows.Forms.ContextMenuStrip>|<xref:System.Windows.Forms.ContextMenu> クラスに対して機能の置き換えと追加を行います。|  
+|<xref:System.Windows.Forms.ToolStripItem>|<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.ToolStripControlHost>、または <xref:System.Windows.Forms.ToolStripDropDown> に格納できるすべての要素のイベントとレイアウトを管理する抽象基本クラスです。|  
+|<xref:System.Windows.Forms.ToolStripContainer>|コントロールをさまざまな方法で配置できるパネルをフォームの両側に持つコンテナーを提供します。|  
+|<xref:System.Windows.Forms.ToolStripRenderer>|<xref:System.Windows.Forms.ToolStrip> オブジェクトの描画機能を処理します。|  
+|<xref:System.Windows.Forms.ToolStripProfessionalRenderer>|Microsoft Office スタイルの外観を提供します。|  
+|<xref:System.Windows.Forms.ToolStripManager>|<xref:System.Windows.Forms.ToolStrip> のレンダリングとラフティング、および <xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.ToolStripDropDownMenu>、<xref:System.Windows.Forms.ToolStripMenuItem> の各オブジェクトのマージを制御します。|  
+|<xref:System.Windows.Forms.ToolStripManagerRenderMode>|フォームに含まれる複数の <xref:System.Windows.Forms.ToolStrip> オブジェクトに適用される描画スタイル \(カスタム、Windows XP、または Microsoft Office Professional\) を指定します。|  
+|<xref:System.Windows.Forms.ToolStripRenderMode>|フォームに含まれる特定の <xref:System.Windows.Forms.ToolStrip> オブジェクトに適用される描画スタイル \(カスタム、Windows XP、または Microsoft Office Professional\) を指定します。|  
+|<xref:System.Windows.Forms.ToolStripControlHost>|厳密には <xref:System.Windows.Forms.ToolStrip> コントロールではないが、<xref:System.Windows.Forms.ToolStrip> 機能が必要な他のコントロールをホストします。|  
+|<xref:System.Windows.Forms.ToolStripItemPlacement>|<xref:System.Windows.Forms.ToolStripItem> をメイン <xref:System.Windows.Forms.ToolStrip> とオーバーフロー <xref:System.Windows.Forms.ToolStrip> のどちらにレイアウトするか、またはどちらにもレイアウトしないかを指定します。|  
+  
+ 詳細については、「[ToolStrip テクノロジの概要](../../../../docs/framework/winforms/controls/toolstrip-technology-summary.md)」および「[ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ContextMenuStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ <xref:System.Windows.Forms.ToolStripItem>   
+ <xref:System.Windows.Forms.ToolStripDropDown>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrip-control-windows-forms.md b/docs/framework/winforms/controls/toolstrip-control-windows-forms.md
new file mode 100644
index 00000000000..21356e6f59c
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrip-control-windows-forms.md
@@ -0,0 +1,109 @@
+---
+title: "ToolStrip コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: e5ef455a-e049-429c-8005-30c93132fb79
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# ToolStrip コントロール (Windows フォーム)
+<xref:System.Windows.Forms.ToolStrip> コントロールは、Windows フォーム アプリケーションでメニュー、コントロール、およびユーザー コントロールをホストするツール バーです。  
+  
+## このセクションの内容  
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : ToolStrip オーバーフローを管理する](../../../../docs/framework/winforms/controls/how-to-manage-toolstrip-overflow-in-windows-forms.md)  
+ オーバーフロー機能を有効にしてオーバーフロー動作を制御する方法について説明します。  
+  
+ [方法 : 実行時に ToolStrip 項目を並べ替えできるようにする](../../../../docs/framework/winforms/controls/how-to-enable-reordering-of-toolstrip-items-at-run-time-in-windows-forms.md)  
+ <xref:System.Windows.Forms.ToolStripItem> コントロールの実行時の再配置を有効にする方法について説明します。  
+  
+ [方法 : ToolStrip コントロールの AutoComplete を有効にする](../../../../docs/framework/winforms/controls/how-to-enable-autocomplete-in-toolstrip-controls-in-windows-forms.md)  
+ <xref:System.Windows.Forms.ToolStripComboBox> の自動補完機能について説明します。  
+  
+ [方法 : Windows フォーム内の ToolStrip 項目の間隔と配置を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-spacing-and-alignment-of-toolstrip-items-in-windows-forms.md)  
+ <xref:System.Windows.Forms.ToolStrip> 上で <xref:System.Windows.Forms.ToolStripItem> を並べ替えるためのさまざまな方法について説明します。  
+  
+ [方法 : Windows フォーム内の ToolStrip テキストとイメージの外観を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-appearance-of-toolstrip-text-and-images-in-windows-forms.md)  
+ <xref:System.Windows.Forms.ToolStripItem> コントロール上のテキストとイメージの配置を定義および変更する方法について説明します。  
+  
+ [方法 : ToolStripControlHost を使用して Windows フォーム コントロールをラップする](../../../../docs/framework/winforms/controls/how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md)  
+ <xref:System.Windows.Forms.ToolStripControlHost> で <xref:System.Windows.Forms.MonthCalendar> コントロールをホストする方法について説明します。  
+  
+ [方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する](../../../../docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md)  
+ <xref:System.Windows.Forms.ToolStrip> コントロール内で標準の描画およびカスタマイズされた描画を行う方法について説明します。  
+  
+ [方法 : ToolStrip コントロールをカスタム描画する](../../../../docs/framework/winforms/controls/how-to-custom-draw-a-toolstrip-control.md)  
+ <xref:System.Windows.Forms.ToolStrip> コントロールにおけるカスタム \(オーナー\) 描画のさまざまな側面について説明します。  
+  
+ [方法 : ToolStrip コントロールにトグル ボタンを作成する](../../../../docs/framework/winforms/controls/how-to-create-toggle-buttons-in-toolstrip-controls.md)  
+ 切り替え可能な <xref:System.Windows.Forms.ToolStripButton> を作成する方法について説明します。  
+  
+ [方法 : ToolStrip コントロールにツールヒントを使用する](../../../../docs/framework/winforms/controls/how-to-use-tooltips-in-toolstrip-controls.md)  
+ <xref:System.Windows.Forms.ToolStrip> 項目のツール ヒントを定義する方法について説明します。  
+  
+ [方法 : ToolStrip を ToolStripContainer からフォームに移動する](../../../../docs/framework/winforms/controls/how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md)  
+ コンテナーを持たないものの、フォームを持つ <xref:System.Windows.Forms.ToolStrip> を設定する方法について説明します。  
+  
+ [方法 : ToolStrip に ToolStripItem を配置する](../../../../docs/framework/winforms/controls/how-to-position-a-toolstripitem-on-a-toolstrip.md)  
+ <xref:System.Windows.Forms.ToolStrip> の左端または右端に <xref:System.Windows.Forms.ToolStripButton> を配置する方法について説明します。  
+  
+ [方法 : Tab キーで ToolStrip コントロールから移動できるようにする](../../../../docs/framework/winforms/controls/how-to-enable-the-tab-key-to-move-out-of-a-toolstrip-control.md)  
+ Tab キーを使用して、<xref:System.Windows.Forms.ToolStrip> 内および ToolStrip 外の次のタブ オーダーのコントロールに移動する方法について説明します。  
+  
+ [方法 : マウス ポインターが ToolStripItem 上にあることを検出する](../../../../docs/framework/winforms/controls/how-to-detect-when-the-mouse-pointer-is-over-a-toolstripitem.md)  
+ 各種マウス イベントを同期させることなく、項目上にマウスが配置されたことを検出するように <xref:System.Windows.Forms.ToolStrip> 項目をセットアップする方法について説明します。  
+  
+ [方法 : ToolStripPanel コントロールを持つ MDI フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-form-with-toolstrippanel-controls.md)  
+ <xref:System.Windows.Forms.ToolStripPanel> コントロールを使用して、複数のマルチ ドキュメント インターフェイス \(MDI\) フォームを作成する方法について説明します。  
+  
+ [方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)  
+ <xref:System.Windows.Forms.ToolStrip> コントロールとメニューのマージをサポートする MDI フォームを作成する方法について説明します。  
+  
+ [方法 : プロフェッショナル スタイルの ToolStrip コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-professionally-styled-toolstrip-control.md)  
+ <xref:System.Windows.Forms.ToolStripProfessionalRenderer> クラスを使用して、Microsoft® Outlook® の**ナビゲーション ウィンドウ**に似た複合コントロールを作成する方法について説明します。  
+  
+ [方法 : カスタムの ToolStripRenderer を実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-custom-toolstriprenderer.md)  
+ <xref:System.Windows.Forms.ToolStripRenderer> から派生するクラスを実装することによって、<xref:System.Windows.Forms.ToolStrip> コントロールの外観をカスタマイズする方法について説明します。  
+  
+-   [方法 : デザイナーを使用して標準アイテムで基本的な Windows フォーム ToolStrip を作成する](http://msdn.microsoft.com/library/571c1z99\(v=vs.110\))  
+  
+-   [方法 : ToolStrip を ToolStripContainer からフォームに移動する](http://msdn.microsoft.com/library/ms171701%20\(v=vs.110\))  
+  
+-   [チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成](http://msdn.microsoft.com/library/ms233664\(v=vs.110\))  
+  
+-   [チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する](http://msdn.microsoft.com/library/ms233676\(v=vs.110\))  
+  
+-   [\[ToolStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233648\(v=vs.110\))  
+  
+-   [ToolStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233643\(v=vs.110\))  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStrip> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.ToolStrip>  
+ <xref:System.Windows.Forms.ToolStrip> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.ToolStripItem>  
+ <xref:System.Windows.Forms.ToolStripItem> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrip-technology-summary.md b/docs/framework/winforms/controls/toolstrip-technology-summary.md
new file mode 100644
index 00000000000..5787c4a427a
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrip-technology-summary.md
@@ -0,0 +1,132 @@
+---
+title: "ToolStrip テクノロジの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー [Windows フォーム], テクノロジの概要"
+  - "ステータス バー, テクノロジの概要"
+  - "ツール バー [Windows フォーム], テクノロジの概要"
+  - "ToolStrip コントロール [Windows フォーム], テクノロジの概要"
+ms.assetid: e8d61973-7af9-429f-9df5-05a899c15a7b
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# ToolStrip テクノロジの概要
+ここでは、`ToolStrip` コントロールおよびその使用をサポートしているクラスの概要について説明します。  
+  
+ `ToolStrip` コントロールとその関連クラスは、ツール バー、ステータス バー、メニューを作成するための完全なソリューションを提供します。  
+  
+## 名前空間  
+ <xref:System.Windows.Forms?displayProperty=fullName>  
+  
+## 背景  
+ `ToolStrip` コントロールと関連クラスを使用すると、外観と動作に一貫性がある、プロフェッショナル レベルの高度なツール バー機能を作成できます。  `ToolStrip` コントロールとクラスでは、以前のコントロールから次の点が改善されました。  
+  
+-   より一貫性のあるイベント モデル。  
+  
+-   タスク一覧と項目コレクション エディターを含む、より一貫性のあるデザイン時動作。  
+  
+-   `ToolStripManager` と `ToolStripRenderer` を使用したカスタム描画。  
+  
+-   `ToolStripContainer` と `ToolStripPanel` を使用したビルトイン ラフティング \(ドッキング時にツール領域内の水平スペースと垂直スペースを共有すること\)。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.AllowItemReorder%2A> プロパティを使用した、デザイン時および実行時の項目の並べ替え。  
+  
+-   <xref:System.Windows.Forms.ToolStrip.CanOverflow%2A> プロパティを使用した、オーバーフロー メニューへの項目の再配置。  
+  
+-   `ToolStripContainer`、`ToolStripPanel`、`ToolStripContentPanel` を使用した、自由に構成可能なコントロール位置。  
+  
+-   `ToolStripControlHost` を使用した、`ToolStrip`、従来のコントロール、またはカスタム コントロールのホスト。  
+  
+-   `ToolStripPanel` を使用した `ToolStrip` コントロールのマージ。  
+  
+ `ToolStrip` は、`MenuStrip`、`ContextMenuStrip`、`StatusStrip` の拡張可能な基底クラスです。  これらのコントロールは、共通の動作とイベント処理を継承する <xref:System.Windows.Forms.ToolStripItem> コンテナーで、それぞれの実装で適切な動作を処理できるように拡張されています。  <xref:System.Windows.Forms.ToolStripItem> から派生するコントロールについて、次の表に示します。  `ToolStrip` 基底クラスでは、コントロールの描画、ユーザー入力、ドラッグ アンド ドロップの各イベントを処理します。  
+  
+ `ToolStrip`、`MenuStrip`、`ContextMenuStrip`、`StatusStrip` の各コントロールは、以前のツール バー、メニュー、ショートカット メニュー、ステータス バーの各コントロールに置き換わるものです。ただし、これらのコントロールも下位互換性の目的で保持されています。  
+  
+## ToolStrip のクラスの概要  
+ テクノロジ分野でグループ化した ToolStrip クラスを次の表に示します。  
+  
+|テクノロジ分野|クラス|  
+|-------------|---------|  
+|ツール バー、ステータス、メニューのコンテナー|<xref:System.Windows.Forms.ToolStrip><br /><br /> <xref:System.Windows.Forms.MenuStrip><br /><br /> <xref:System.Windows.Forms.ContextMenuStrip><br /><br /> <xref:System.Windows.Forms.StatusStrip><br /><br /> <xref:System.Windows.Forms.ToolStripDropDownMenu>|  
+|ToolStrip 項目|<xref:System.Windows.Forms.ToolStripLabel><br /><br /> <xref:System.Windows.Forms.ToolStripDropDownItem><br /><br /> <xref:System.Windows.Forms.ToolStripMenuItem><br /><br /> <xref:System.Windows.Forms.ToolStripButton><br /><br /> <xref:System.Windows.Forms.ToolStripStatusLabel><br /><br /> <xref:System.Windows.Forms.ToolStripSeparator><br /><br /> <xref:System.Windows.Forms.ToolStripControlHost><br /><br /> <xref:System.Windows.Forms.ToolStripComboBox><br /><br /> <xref:System.Windows.Forms.ToolStripTextBox><br /><br /> <xref:System.Windows.Forms.ToolStripProgressBar><br /><br /> <xref:System.Windows.Forms.ToolStripDropDownButton><br /><br /> <xref:System.Windows.Forms.ToolStripSplitButton>|  
+|場所|<xref:System.Windows.Forms.ToolStripContainer><br /><br /> <xref:System.Windows.Forms.ToolStripContentPanel><br /><br /> <xref:System.Windows.Forms.ToolStripPanel>|  
+|プレゼンテーションと描画|<xref:System.Windows.Forms.ToolStripManager><br /><br /> <xref:System.Windows.Forms.ToolStripRenderer><br /><br /> <xref:System.Windows.Forms.ToolStripProfessionalRenderer><br /><br /> <xref:System.Windows.Forms.ToolStripRenderMode><br /><br /> <xref:System.Windows.Forms.ToolStripManagerRenderMode>|  
+  
+## ToolStrip のデザイン時機能  
+ <xref:System.Windows.Forms.ToolStrip> ファミリのコントロールには、実用的なアプリケーションを短期間で作成できるように、埋め込み先での編集とユーザー インターフェイスの基盤の定義を行うための豊富なツールとテンプレートのセットが用意されています。  
+  
+### タスク ダイアログ ボックス  
+ Visual Studio のデザイナーでコントロールのスマート タグをクリックすると、タスク一覧が表示されます。タスク一覧からは、よく使用する多くのコマンドに簡単にアクセスできます。  
+  
+-   [\[MenuStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233645\(v=vs.110\))  
+  
+-   [\[ToolStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233648\(v=vs.110\))  
+  
+-   [\[ContextMenuStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233646\(v=vs.110\))  
+  
+-   [\[StatusStrip タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233642\(v=vs.110\))  
+  
+-   [\[ToolStripContainer タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233647\(v=vs.110\))  
+  
+### 項目コレクション エディター  
+ Visual Studio で、タスク一覧の \[**項目の編集**\] をクリックするか、コントロールを右クリックしてショートカット メニューの \[**項目の編集**\] を選択すると、そのコントロールのコレクション エディターが表示されます。  コレクション エディターを使用すると、コントロールに含まれる項目の追加、削除、並べ替えを行うことができます。  また、コントロールとコントロール項目のプロパティを表示および変更することもできます。  
+  
+-   [MenuStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233625\(v=vs.110\))  
+  
+-   [StatusStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233631\(v=vs.110\))  
+  
+-   [ContextMenuStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233641\(v=vs.110\))  
+  
+-   [ToolStrip Items コレクション エディター](http://msdn.microsoft.com/library/ms233643\(v=vs.110\))  
+  
+## コントロールのホスト  
+ <xref:System.Windows.Forms.ToolStripControlHost> クラスは、<xref:System.Windows.Forms.ToolStripComboBox> コントロール、<xref:System.Windows.Forms.ToolStripTextBox> コントロール、<xref:System.Windows.Forms.ToolStripProgressBar> コントロールのためのビルトイン ラッパーを提供します。  その他の既存のコントロールまたは COM コントロールを <xref:System.Windows.Forms.ToolStripControlHost> でホストすることもできます。  
+  
+ コントロール ホストの例については、[方法 : ToolStripControlHost を使用して Windows フォーム コントロールをラップする](../../../../docs/framework/winforms/controls/how-to-wrap-a-windows-forms-control-with-toolstripcontrolhost.md) を参照してください。  
+  
+## レンダリング  
+ <xref:System.Windows.Forms.ToolStrip> クラスでは、他の Windows フォーム コントロールとは大きく異なる描画スキームを実装します。  このスキームを使用すると、スタイルとテーマを簡単に適用できます。  
+  
+ <xref:System.Windows.Forms.ToolStrip> とそこに含まれるすべての <xref:System.Windows.Forms.ToolStripItem> オブジェクトにスタイルを適用する場合、<xref:System.Windows.Forms.ToolStripItem.Paint> イベントを項目ごとに処理する必要はありません。  代わりに、<xref:System.Windows.Forms.ToolStrip.RenderMode%2A> プロパティを <xref:System.Windows.Forms.ToolStripRenderMode> 値のいずれかに設定できます \(<xref:System.Windows.Forms.ToolStripRenderMode> を除きます\)。  さらに別の方法として、<xref:System.Windows.Forms.ToolStripRenderer> クラスを継承する任意のクラスに <xref:System.Windows.Forms.ToolStrip.Renderer%2A> を直接設定することもできます。  このプロパティを設定すると、<xref:System.Windows.Forms.ToolStrip.RenderMode%2A> が自動的に設定されます。  
+  
+ <xref:System.Windows.Forms.ToolStrip.RenderMode%2A> を <xref:System.Windows.Forms.ToolStripRenderMode> に設定し、<xref:System.Windows.Forms.ToolStripManager.RenderMode%2A> または <xref:System.Windows.Forms.ToolStripManager.Renderer%2A> プロパティをそれぞれ任意の <xref:System.Windows.Forms.ToolStripManagerRenderMode> または <xref:System.Windows.Forms.ToolStripRenderer> 値に設定すると、同じアプリケーション内の複数の <xref:System.Windows.Forms.ToolStrip> オブジェクトに同じスタイルを適用できます。  
+  
+ レンダリングの例については、[方法 : Windows フォームに ToolStrip コントロールのカスタム レンダラーを作成して設定する](../../../../docs/framework/winforms/controls/create-and-set-a-custom-renderer-for-the-toolstrip-control-in-wf.md) を参照してください。  
+  
+## スタイルとテーマ  
+ <xref:System.Windows.Forms.ToolStrip> とその関連クラスは、表示スタイルとカスタムの外観を容易にサポートします。この場合、<xref:System.Windows.Forms.ToolStripItem.OnPaint%2A> メソッドを項目ごとにオーバーライドする必要はありません。  <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> と、<xref:System.Windows.Forms.ToolStrip.RenderMode%2A> プロパティおよび <xref:System.Windows.Forms.ToolStrip.Renderer%2A> プロパティを使用します。  
+  
+## ラフティングとドッキング  
+ <xref:System.Windows.Forms.ToolStrip> コントロールは、ラフティング、ドッキング、または絶対位置を指定して配置できます。  <xref:System.Windows.Forms.ToolStrip> 項目は、コンテナーの <xref:System.Windows.Forms.ToolStrip.LayoutEngine%2A> によってレイアウトされます。  
+  
+ *ラフティング*は、水平スペースまたは垂直スペースを共有するためのツール バーの機能です。  Windows フォームでは、<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.StatusStrip> の各コントロールの配置とラフティングを行うときに、フォームの左側、右側、上側、下側にパネルを持つ <xref:System.Windows.Forms.ToolStripContainer> を使用できます。  複数の <xref:System.Windows.Forms.ToolStrip> コントロールを左右の <xref:System.Windows.Forms.ToolStripContainer> に配置すると、コントロールは垂直方向に積み重ねられます。  上または下の <xref:System.Windows.Forms.ToolStripContainer> に配置すると、コントロールは水平方向に積み重ねられます。  <xref:System.Windows.Forms.ToolStripContainer> の中央の <xref:System.Windows.Forms.ToolStripContentPanel> を使用すると、従来のコントロールをフォーム上に配置できます。  
+  
+ 一部または全部の <xref:System.Windows.Forms.ToolStripContainer> コントロールを、デザイン時に直接選択して削除できます。  <xref:System.Windows.Forms.ToolStripContainer> は展開および折りたたみが可能で、内部のコントロールに合わせてサイズ調整されます。  
+  
+ *ドッキング* は、コントロールの位置をフォームの左側、右側、上側、または下側に単純に指定することです。  
+  
+ ドッキングよりもラフティングの方が有利な点は、<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、<xref:System.Windows.Forms.StatusStrip> の各コントロールが他のコントロールと水平スペースまたは垂直スペースを共有できることです。  
+  
+ ほとんどの <xref:System.Windows.Forms.ToolStrip> コントロールは、他のコントロールと同様、ラフティングを使用せずにフォームにドッキングできます。  また、<xref:System.Windows.Forms.ToolStrip> コントロールを <xref:System.Windows.Forms.ToolStripContainer> 外に移動し、`Dock` プロパティを `None` に設定することによって、コントロールをフォーム上の任意の配置することもできます。また、それぞれの <xref:System.Windows.Forms.Control.Location%2A> プロパティを設定して、コントロールの絶対位置を指定することもできます。  「[方法 : ToolStrip を ToolStripContainer からフォームに移動する](../../../../docs/framework/winforms/controls/how-to-move-a-toolstrip-out-of-a-toolstripcontainer-onto-a-form.md)」を参照してください。  
+  
+ 1 つ以上の <xref:System.Windows.Forms.ToolStripPanel> コントロールを使用すると、柔軟性が高まります。特に、マルチ ドキュメント インターフェイス \(MDI: Multiple Document Interface\) アプリケーションの場合、または <xref:System.Windows.Forms.ToolStripContainer> が不要な場合には、これが当てはまります。  <xref:System.Windows.Forms.ToolStripPanel> には、<xref:System.Windows.Forms.ToolStrip> コントロールの配置とラフティングのためにドッキングできる領域が用意されていますが、従来のコントロールには用意されていません。  既定では、<xref:System.Windows.Forms.ToolStripPanel> はデザイナーの \[**ツールボックス**\] に表示されませんが、\[**ツールボックス**\] を右クリックして \[**アイテムの選択**\] をクリックすると配置できます。  また、他のクラスと同様に、<xref:System.Windows.Forms.ToolStripPanel> にプログラムからアクセスすることもできます。  
+  
+ <xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、および <xref:System.Windows.Forms.StatusStrip> を使用すると、項目はオーバーフローします。  これは、Microsoft Office ツール バーの項目の動作と似ています。  
+  
+## 参照  
+ [ToolStrip コントロールの概要](../../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [ToolStrip コントロールのアーキテクチャ](../../../../docs/framework/winforms/controls/toolstrip-control-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripcontainer-control-overview.md b/docs/framework/winforms/controls/toolstripcontainer-control-overview.md
new file mode 100644
index 00000000000..72812431d1b
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripcontainer-control-overview.md
@@ -0,0 +1,46 @@
+---
+title: "ToolStripContainer コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolStripContainer"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], ビルトイン ラフティング"
+  - "ToolStripContainer コントロール [Windows フォーム], ToolStripContainer コントロールの概要"
+ms.assetid: c7d63bff-64e2-4a63-bd89-d31bc96dacb8
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ToolStripContainer コントロールの概要
+<xref:System.Windows.Forms.ToolStripContainer> には、<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、および <xref:System.Windows.Forms.StatusStrip> の各コントロールの配置およびラフティングのためのパネルが、上下左右のそれぞれの側にあります。  複数の <xref:System.Windows.Forms.ToolStrip> コントロールを左右の <xref:System.Windows.Forms.ToolStripContainer> に配置すると、コントロールは垂直方向に積み重ねられます。  上または下の <xref:System.Windows.Forms.ToolStripContainer> に配置すると、コントロールは水平方向に積み重ねられます。  <xref:System.Windows.Forms.ToolStripContainer> の中央の <xref:System.Windows.Forms.ToolStripContentPanel> を使用すると、従来のコントロールをフォーム上に配置できます。  
+  
+ すべての <xref:System.Windows.Forms.ToolStripContainer> コントロールは、デザイン時に直接選択して削除できます。  <xref:System.Windows.Forms.ToolStripContainer> の各パネルは展開および折りたたみが可能で、内部のコントロールに合わせてサイズ調整されます。  
+  
+### ToolStripContainer の重要なメンバー  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripContainer.BottomToolStripPanel%2A>|<xref:System.Windows.Forms.ToolStripContainer> の下側パネルを取得します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.BottomToolStripPanelVisible%2A>|<xref:System.Windows.Forms.ToolStripContainer> の下パネルが表示されるかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.LeftToolStripPanel%2A>|<xref:System.Windows.Forms.ToolStripContainer> の左パネルを取得します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.LeftToolStripPanelVisible%2A>|<xref:System.Windows.Forms.ToolStripContainer> の左パネルが表示されるかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.RightToolStripPanel%2A>|<xref:System.Windows.Forms.ToolStripContainer> の右パネルを取得します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.RightToolStripPanelVisible%2A>|<xref:System.Windows.Forms.ToolStripContainer> の右パネルが表示されるかどうかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.TopToolStripPanel%2A>|<xref:System.Windows.Forms.ToolStripContainer> の上パネルを取得します。|  
+|<xref:System.Windows.Forms.ToolStripContainer.TopToolStripPanelVisible%2A>|<xref:System.Windows.Forms.ToolStripContainer> の上パネルが表示されるかどうかを示す値を取得または設定します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripContainer>   
+ <xref:System.Windows.Forms.ToolStripContentPanel>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripcontainer-control.md b/docs/framework/winforms/controls/toolstripcontainer-control.md
new file mode 100644
index 00000000000..3035a40cbd7
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripcontainer-control.md
@@ -0,0 +1,54 @@
+---
+title: "ToolStripContainer コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], ビルトイン ラフティング"
+  - "ToolStrip コントロール [Windows フォーム], ToolStripContainer"
+  - "ToolStripContainer コントロール [Windows フォーム]"
+ms.assetid: 378fa5b4-38e1-46f4-8e5c-d0c19dcd0200
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ToolStripContainer コントロール
+<xref:System.Windows.Forms.ToolStrip> コントロールは、<xref:System.Windows.Forms.ToolStripContainer> の使用による、ビルトイン ラフティング \(ドッキングされているときに、ツールの領域内の水平または垂直のスペースを共有\) を備えています。  
+  
+ このセクションのトピックでは、<xref:System.Windows.Forms.ToolStripContainer> の機能をアプリケーションに組み込むときに使用できる概念および手法について説明します。  
+  
+## このセクションの内容  
+ [ToolStripContainer コントロールの概要](../../../../docs/framework/winforms/controls/toolstripcontainer-control-overview.md)  
+ Windows フォームの <xref:System.Windows.Forms.ToolStripContainer> コントロールの目的および中心となる概念を説明するトピックを示します。  
+  
+ [方法 : フォームに ToolStripContainer を追加する](../../../../docs/framework/winforms/controls/how-to-add-a-toolstripcontainer-to-a-form.md)  
+ <xref:System.Windows.Forms.ToolStripContainer> のアプリケーションへの追加と、<xref:System.Windows.Forms.ToolStripContainer> の特定のパネルへのコントロールの追加を示します。  
+  
+ [方法 : ToolStripContentPanel にコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-a-control-to-a-toolstripcontentpanel.md)  
+ <xref:System.Windows.Forms.ToolStripContentPanel> へのコントロールの追加を示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStripContainer>  
+ <xref:System.Windows.Forms.ToolStripContainer> コントロールのリファレンス ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.ToolStripContentPanel>  
+ <xref:System.Windows.Forms.ToolStripContainer> コントロールの <xref:System.Windows.Forms.ToolStripContentPanel> のリファレンス ドキュメントを提供します。  
+  
+ 「[\[ToolStripContainer タスク\] ダイアログ ボックス](http://msdn.microsoft.com/library/ms233647\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStripPanel>  
+ <xref:System.Windows.Forms.ToolStripPanel> コントロールのリファレンス ドキュメントを提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrippanel-control-overview.md b/docs/framework/winforms/controls/toolstrippanel-control-overview.md
new file mode 100644
index 00000000000..b23fe6c472f
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrippanel-control-overview.md
@@ -0,0 +1,43 @@
+---
+title: "ToolStripPanel コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolStripPanel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム]"
+  - "ToolStripPanel コントロール [Windows フォーム], ToolStripPanel コントロールの概要"
+ms.assetid: ce54a60c-5eba-4b4c-bd77-cf0748a666cc
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# ToolStripPanel コントロールの概要
+<xref:System.Windows.Forms.ToolStripPanel> は、<xref:System.Windows.Forms.ToolStrip>、<xref:System.Windows.Forms.MenuStrip>、および <xref:System.Windows.Forms.StatusStrip> の各コントロールを配置およびラフティングするための単一の領域です。  <xref:System.Windows.Forms.ToolStripPanel> の <xref:System.Windows.Forms.ToolStripPanelRow.Orientation%2A> に基づいて、複数の <xref:System.Windows.Forms.ToolStrip> コントロールが垂直または水平に並びます。  
+  
+### ToolStripPanel の重要なメンバー  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripPanel.Orientation%2A>|<xref:System.Windows.Forms.ToolStripPanel> の向きが水平方向であるか垂直方向であるかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripPanel.Renderer%2A>|<xref:System.Windows.Forms.ToolStripPanel> の外観のカスタマイズに使用する <xref:System.Windows.Forms.ToolStripRenderer> を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripPanel.RenderMode%2A>|<xref:System.Windows.Forms.ToolStripPanel> に適用される描画スタイルを取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripPanel.RowMargin%2A>|<xref:System.Windows.Forms.ToolStripPanelRow> と <xref:System.Windows.Forms.ToolStripPanel> の間隔をピクセル単位で取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripPanel.Rows%2A>|この <xref:System.Windows.Forms.ToolStripPanel> の <xref:System.Windows.Forms.ToolStripPanelRow> を取得します。|  
+|<xref:System.Windows.Forms.ToolStripPanel.Join%2A>|<xref:System.Windows.Forms.ToolStrip> を <xref:System.Windows.Forms.ToolStripPanel> に追加します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripContainer>   
+ <xref:System.Windows.Forms.ToolStripContentPanel>   
+ [ToolStrip Sample](http://msdn.microsoft.com/ja-jp/b7352439-184a-4a3a-b2ad-07465d3af9ed)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstrippanel-control.md b/docs/framework/winforms/controls/toolstrippanel-control.md
new file mode 100644
index 00000000000..74b4d0a38fc
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstrippanel-control.md
@@ -0,0 +1,47 @@
+---
+title: "ToolStripPanel コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "水平スペース"
+  - "ツール領域 [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム], ToolStripPanel"
+  - "ToolStripPanel コントロール [Windows フォーム]"
+  - "垂直スペース"
+ms.assetid: aa47af39-1e71-40ee-bb75-2d2478f81bd0
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ToolStripPanel コントロール
+`ToolStripPanel` コントロールは、ドッキングしたときにツールの領域内の水平方向または縦方向のスペースを共有し、<xref:System.Windows.Forms.ToolStripContainer> の 4 つのパネルと中庸のパネルが必要ないときに <xref:System.Windows.Forms.ToolStrip> コントロールを調整することができます。  
+  
+ このセクションのトピックでは、`ToolStripPanel` の機能をアプリケーションに組み込むときに使用できる概念および手法について説明します。  
+  
+## このセクションの内容  
+ [ToolStripPanel コントロールの概要](../../../../docs/framework/winforms/controls/toolstrippanel-control-overview.md)  
+ Windows フォームの <xref:System.Windows.Forms.ToolStripContainer> コントロールの目的および中心となる概念を説明するトピックを示します。  
+  
+ [方法 : ToolStripPanel を結合する](../../../../docs/framework/winforms/controls/how-to-join-toolstrippanels.md)  
+ <xref:System.Windows.Forms.ToolStrip> コントロールを `ToolStripPanel` に追加する方法を示しています。  
+  
+ [方法 : ToolStripPanel を MDI で使用する](../../../../docs/framework/winforms/controls/how-to-use-toolstrippanels-for-mdi.md)  
+ マルチ ドキュメント インターフェイス アプリケーションの `ToolStripPanel` コントロールにより利用できる柔軟性を示しています。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStripPanel>  
+ <xref:System.Windows.Forms.ToolStripPanel> コントロールのリファレンス ドキュメントを提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripprogressbar-control-overview.md b/docs/framework/winforms/controls/toolstripprogressbar-control-overview.md
new file mode 100644
index 00000000000..996e2e1bcfc
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripprogressbar-control-overview.md
@@ -0,0 +1,44 @@
+---
+title: "ToolStripProgressBar コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolStripProgressBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プログレス コントロール"
+  - "ツール バー [Windows フォーム], プログレス バー"
+  - "ToolStripProgressBar コントロール [Windows フォーム], ToolStripProgressBar コントロール"
+ms.assetid: ec3ab522-5fe4-4b4d-a551-bc19e84f4774
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ToolStripProgressBar コントロールの概要
+<xref:System.Windows.Forms.ToolStripProgressBar> は、すべての <xref:System.Windows.Forms.ToolStrip> コントロールのラフティング機能および描画機能を、通常の処理追跡機能と組み合わせたものです。  <xref:System.Windows.Forms.ToolStripProgressBar> は、<xref:System.Windows.Forms.StatusStrip> によりホストされるのが一般的ですが、<xref:System.Windows.Forms.ToolStrip> によりホストされる場合もあります。  
+  
+ <xref:System.Windows.Forms.ToolStripProgressBar> コントロールは、以前のバージョンのコントロールに置き換わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.ToolStripProgressBar> コントロールは、下位互換性を保持するため、および将来必要になったときに使用できるように保持されています。  
+  
+### ToolStripProgressBar の重要なメンバー  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripProgressBar.MarqueeAnimationSpeed%2A>|<xref:System.Windows.Forms.ProgressBarStyle> の表示のそれぞれの更新の間隔をミリ秒単位で表す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ProgressBar.Maximum%2A>|この <xref:System.Windows.Forms.ToolStripProgressBar> に対して定義される範囲の上限を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripProgressBar.Minimum%2A>|この <xref:System.Windows.Forms.ToolStripProgressBar> に対して定義される範囲の下限を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripProgressBar.Style%2A>|<xref:System.Windows.Forms.ToolStripProgressBar> が操作の進行状況の表示に使用するスタイルを取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripProgressBar.Value%2A>|<xref:System.Windows.Forms.ToolStripProgressBar> コントロールの現在の値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripProgressBar.PerformStep%2A>|プログレス バーの現在位置を <xref:System.Windows.Forms.ToolStripProgressBar.Step%2A> プロパティの値の分だけ進めます。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripProgressBar>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripprogressbar-control.md b/docs/framework/winforms/controls/toolstripprogressbar-control.md
new file mode 100644
index 00000000000..101cfe68ad8
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripprogressbar-control.md
@@ -0,0 +1,41 @@
+---
+title: "ToolStripProgressBar コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "プログレス コントロール"
+  - "ツール バー [Windows フォーム], プログレス バー"
+  - "ToolStrip コントロール [Windows フォーム], ToolStripProgressBar"
+  - "ToolStripProgressBar コントロール [Windows フォーム]"
+ms.assetid: cb3eb0a8-60b1-483e-a03f-93b0b1351dae
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ToolStripProgressBar コントロール
+<xref:System.Windows.Forms.ToolStripProgressBar> は、<xref:System.Windows.Forms.ToolStrip> の描画機能およびラフティング機能と、一般的な処理追跡機能とを組み合わせたものです。  
+  
+## このセクションの内容  
+ [ToolStripProgressBar コントロールの概要](../../../../docs/framework/winforms/controls/toolstripprogressbar-control-overview.md)  
+ Windows フォームの <xref:System.Windows.Forms.ToolStripProgressBar> コントロールの用途と主要な概念を説明するトピックを示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStripPanel>  
+ <xref:System.Windows.Forms.ToolStripPanel> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.ToolStripProgressBar>  
+ <xref:System.Windows.Forms.ToolStripProgressBar> コントロールの参照ドキュメントを提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripstatuslabel-control-overview.md b/docs/framework/winforms/controls/toolstripstatuslabel-control-overview.md
new file mode 100644
index 00000000000..377713f372d
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripstatuslabel-control-overview.md
@@ -0,0 +1,38 @@
+---
+title: "ToolStripStatusLabel コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolStripStatusLabel"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー"
+  - "ToolStripStatusLabel コントロール [Windows フォーム], aboutToolStripStatusLabel コントロール"
+ms.assetid: 0b9c991e-a9fa-4609-9e1b-caadaef93821
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# ToolStripStatusLabel コントロールの概要
+<xref:System.Windows.Forms.ToolStripStatusLabel> は <xref:System.Windows.Forms.StatusStrip> 用のラベルです。  <xref:System.Windows.Forms.Label> や <xref:System.Windows.Forms.ToolStripLabel> と同様に、<xref:System.Windows.Forms.ToolStripStatusLabel> を使用すると、テキスト、イメージ、またはその両方にクリックできない表示領域を作成できます。  <xref:System.Windows.Forms.ToolStripStatusLabel> は <xref:System.Windows.Forms.StatusStrip> によってホストされます。  
+  
+### ToolStripStatusLabel の重要なメンバー  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.ToolStripStatusLabel.Spring%2A>|フォームのサイズが変更されたときに、<xref:System.Windows.Forms.ToolStripStatusLabel> が自動的に <xref:System.Windows.Forms.StatusStrip> 上の使用可能な領域を占めるかどうかを表す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripStatusLabel.BorderSides%2A>|<xref:System.Windows.Forms.ToolStripStatusLabel> のどちらの側に境界線を表示するかを示す値を取得または設定します。|  
+|<xref:System.Windows.Forms.ToolStripStatusLabel.BorderStyle%2A>|<xref:System.Windows.Forms.ToolStripStatusLabel> の境界線スタイルを取得または設定します。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolStripStatusLabel>
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/toolstripstatuslabel-control.md b/docs/framework/winforms/controls/toolstripstatuslabel-control.md
new file mode 100644
index 00000000000..59710a1a9ca
--- /dev/null
+++ b/docs/framework/winforms/controls/toolstripstatuslabel-control.md
@@ -0,0 +1,43 @@
+---
+title: "ToolStripStatusLabel コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ステータス バー"
+  - "ToolStrip コントロール [Windows フォーム], ToolStripStatusLabel"
+  - "ToolStripStatusLabel コントロール [Windows フォーム]"
+ms.assetid: 099bc74a-a29f-4f15-af0d-7c517ef50c7e
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# ToolStripStatusLabel コントロール
+<xref:System.Windows.Forms.ToolStripStatusLabel> は、テキスト、イメージ、またはその両方の <xref:System.Windows.Forms.StatusStrip> 内に表示領域を用意します。  
+  
+## このセクションの内容  
+ [ToolStripStatusLabel コントロールの概要](../../../../docs/framework/winforms/controls/toolstripstatuslabel-control-overview.md)  
+ Windows フォーム <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールの用途と主な概念について説明するトピックを示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolStripStatusLabel>  
+ <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.StatusStrip>  
+ <xref:System.Windows.Forms.StatusStrip> コントロールの参照ドキュメントを提供します。  
+  
+ <xref:System.Windows.Forms.ToolStripProgressBar>  
+ <xref:System.Windows.Forms.ToolStripProgressBar> コントロールの参照ドキュメントを提供します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md b/docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md
new file mode 100644
index 00000000000..ce3a8bb727c
--- /dev/null
+++ b/docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md
@@ -0,0 +1,37 @@
+---
+title: "ToolTip コンポーネントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ToolTip"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolTip コンポーネント [Windows フォーム], ToolTip コンポーネントの概要"
+  - "ツールヒント [Windows フォーム], ツールヒントの概要"
+ms.assetid: 3fbc6f08-c882-4acd-a960-a08efe3c7e6e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# ToolTip コンポーネントの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.ToolTip> コンポーネントは、ユーザーがコントロールをポイントしたときにテキストを表示します。  ツールヒントは、どのコントロールにも関連付けることができます。  たとえば、ボタンに小さなアイコンを表示し、ツールヒントでボタンの機能を説明することで、フォームのスペースを節約できます。  
+  
+## ToolTip コンポーネントの操作  
+ <xref:System.Windows.Forms.ToolTip> コンポーネントは、Windows フォームなどのコンテナーにある複数のコントロールに `ToolTip` プロパティを提供します。  たとえば、1 つの <xref:System.Windows.Forms.ToolTip> コンポーネントをフォームに配置して、<xref:System.Windows.Forms.TextBox> コントロールをポイントしたときに "ここに名前を入力してください" と表示したり、<xref:System.Windows.Forms.Button> コントロールをポイントしたときに "変更を保存するときはこのボタンをクリックしてください" と表示したりできます。  
+  
+ <xref:System.Windows.Forms.ToolTip> コンポーネントの主要なメソッドは、<xref:System.Windows.Forms.ToolTip.SetToolTip%2A> および <xref:System.Windows.Forms.ToolTip.GetToolTip%2A> です。  <xref:System.Windows.Forms.ToolTip.SetToolTip%2A> メソッドは、コントロールに対応するツールヒントを設定します。  詳細については、「[方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](../../../../docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)」を参照してください。  主要なプロパティは 2 つです。ツールヒントを表示するには <xref:System.Windows.Forms.ToolTip.Active%2A> プロパティを `true` に設定する必要があります。<xref:System.Windows.Forms.ToolTip.AutomaticDelay%2A> プロパティでは、ツールヒント文字列が表示される時間の長さ、ツールヒントが表示されるまでコントロールをポイントする必要がある時間、および後続のツールヒント ウィンドウが表示されるまでの時間を設定します。  詳細については、「[方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ToolTip>   
+ [方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](../../../../docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)   
+ [方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/tooltip-component-windows-forms.md b/docs/framework/winforms/controls/tooltip-component-windows-forms.md
new file mode 100644
index 00000000000..ed719fbb24c
--- /dev/null
+++ b/docs/framework/winforms/controls/tooltip-component-windows-forms.md
@@ -0,0 +1,46 @@
+---
+title: "ToolTip コンポーネント (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ToolTip コンポーネント [Windows フォーム]"
+  - "ツールヒント [Windows フォーム]"
+ms.assetid: 82e71dc3-0159-4f91-9f22-499224f004a0
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ToolTip コンポーネント (Windows フォーム)
+Windows フォーム <xref:System.Windows.Forms.ToolTip> コンポーネントは、ユーザーがコントロールをポイントしたときにテキストを表示します。  ツールヒントは任意のコントロールに関連付けることができます。  このコントロールの使用例: フォーム上の領域を節約するために、ボタンに小さなアイコンを表示して、ツールヒントを使用し、ボタンの機能について説明できます。  
+  
+## このセクションの内容  
+ [ToolTip コンポーネントの概要](../../../../docs/framework/winforms/controls/tooltip-component-overview-windows-forms.md)  
+ ユーザーがマウスをコントロールにポイントしたときにテキストを表示する <xref:System.Windows.Forms.ToolTip> コンポーネントの一般的な概要について説明します。  
+  
+ [方法 : デザイン時に Windows フォームのコントロールにツールヒントを設定する](../../../../docs/framework/winforms/controls/how-to-set-tooltips-for-controls-on-a-windows-form-at-design-time.md)  
+ コードまたはデザイナーでツールヒントを設定する方法について説明します。  
+  
+ [方法 : Windows フォームの ToolTip コンポーネントの遅延時間を変更する](../../../../docs/framework/winforms/controls/how-to-change-the-delay-of-the-windows-forms-tooltip-component.md)  
+ ツールヒントが表示されるまでの時間の長さ、および表示される時間を制御する値の設定方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.ToolTip> クラス  
+ クラスとそのメンバーに関するリファレンス情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。  
+  
+ [ツールヒントを使用したコントロールのヘルプ](../../../../docs/framework/winforms/advanced/control-help-using-tooltips.md)  
+ Windows フォームの各コントロール専用の簡潔なヘルプ メッセージを作成する方法としてのツールヒントについて説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/trackbar-control-overview-windows-forms.md b/docs/framework/winforms/controls/trackbar-control-overview-windows-forms.md
new file mode 100644
index 00000000000..87c532ffbb5
--- /dev/null
+++ b/docs/framework/winforms/controls/trackbar-control-overview-windows-forms.md
@@ -0,0 +1,37 @@
+---
+title: "TrackBar コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TrackBar"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "スライダー コントロール, スライダー コントロールの概要"
+  - "スライダー, スライダーの概要"
+  - "TrackBar コントロール [Windows フォーム], TrackBar コントロールの概要"
+ms.assetid: 95910ecb-8a4c-4776-89fa-206c89ed6973
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# TrackBar コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.TrackBar> コントロールは、"スライダー" コントロールとも呼ばれ、大量の情報内を移動する場合や、数値設定を視覚的に調整する場合などに使用します。  <xref:System.Windows.Forms.TrackBar> コントロールは、つまみ \(スライダー\) と軸目盛りという 2 つの部分で構成されます。  つまみは調整できます。  つまみの位置は <xref:System.Windows.Forms.TrackBar.Value%2A> プロパティに対応しています。  軸目盛りは、一定の間隔で区切られた視覚的なインジケーターです。  トラック バーは、指定した単位で移動し、水平または垂直に調整できます。  たとえば、トラック バーを使用して、システムのカーソル点滅速度やマウス速度を制御できます。  
+  
+## 主要なプロパティ  
+ <xref:System.Windows.Forms.TrackBar> コントロールの主要なプロパティは、<xref:System.Windows.Forms.TrackBar.Value%2A>、<xref:System.Windows.Forms.TrackBar.TickFrequency%2A>、<xref:System.Windows.Forms.TrackBar.Minimum%2A>、および <xref:System.Windows.Forms.TrackBar.Maximum%2A> です。  <xref:System.Windows.Forms.TrackBar.TickFrequency%2A> は、軸目盛りの間隔です。  <xref:System.Windows.Forms.TrackBar.Minimum%2A> および <xref:System.Windows.Forms.TrackBar.Maximum%2A> は、トラック バーに表示できる最小値および最大値です。  
+  
+ その他に、<xref:System.Windows.Forms.TrackBar.SmallChange%2A> と <xref:System.Windows.Forms.TrackBar.LargeChange%2A> という 2 つの重要なプロパティがあります。  <xref:System.Windows.Forms.TrackBar.SmallChange%2A> プロパティの値は、左右の方向キーを押したときにつまみが移動する目盛りの数です。  <xref:System.Windows.Forms.TrackBar.LargeChange%2A> プロパティの値は、PageUp キーまたは PageDown キーを押したとき、またはトラック バー上でつまみの左右をマウス クリックしたときに、つまみが移動する目盛りの数です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TrackBar>   
+ [TrackBar コントロール](../../../../docs/framework/winforms/controls/trackbar-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/trackbar-control-windows-forms.md b/docs/framework/winforms/controls/trackbar-control-windows-forms.md
new file mode 100644
index 00000000000..fed50fbbbf6
--- /dev/null
+++ b/docs/framework/winforms/controls/trackbar-control-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "TrackBar コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "スライダー コントロール"
+  - "スライダー"
+  - "TrackBar コントロール [Windows フォーム]"
+ms.assetid: 37d6aee3-7e8a-4a10-a99c-3a6e09199553
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# TrackBar コントロール (Windows フォーム)
+Windows フォームの `TrackBar` コントロールは、大量の情報内を移動する場合や、数値設定を視覚的に調整する場合などに使用します \("スライダー" コントロールとも呼ばれます\)。  `TrackBar` コントロールは、つまみ \(スライダー\) と軸目盛りという 2 つの部分で構成されます。  つまみは調整できます。  つまみの位置は <xref:System.Windows.Forms.TrackBar.Value%2A> プロパティに対応しています。  軸目盛りは、一定の間隔で区切られた視覚的なインジケーターです。  トラック バーは、指定した単位で移動し、水平または垂直に調整できます。  たとえば、トラック バーを使用して、カーソルの点滅速度やマウスの速度などが設定できます。  
+  
+## このセクションの内容  
+ [TrackBar コントロールの概要](../../../../docs/framework/winforms/controls/trackbar-control-overview-windows-forms.md)  
+ `TrackBar` コントロールの全般的な概念を説明します。このコントロールにより、ユーザーは数値設定を視覚的に調整して情報内を移動できます。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TrackBar> クラス  
+ クラスとそのメンバーに関する参照情報を提供します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/treeview-control-overview-windows-forms.md b/docs/framework/winforms/controls/treeview-control-overview-windows-forms.md
new file mode 100644
index 00000000000..5789a590880
--- /dev/null
+++ b/docs/framework/winforms/controls/treeview-control-overview-windows-forms.md
@@ -0,0 +1,38 @@
+---
+title: "TreeView コントロールの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TreeView"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "TreeView コントロール [Windows フォーム], TreeView コントロールの概要"
+ms.assetid: 0ece823a-9508-478a-bbdb-7d7c3bae51d5
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# TreeView コントロールの概要 (Windows フォーム)
+Windows フォームの <xref:System.Windows.Forms.TreeView> コントロールでは、Windows オペレーティング システムの Windows エクスプローラーの左側のウィンドウにファイルやフォルダーが表示されるのと同じように、ノードの階層をユーザーに表示することができます。  ツリー ビュー内の各ノードには、*子ノード*と呼ばれるその他のノードが含まれている可能性があります。  親ノード、または子ノードを含むノードを展開または折りたたんで表示できます。  また、ツリー ビューの <xref:System.Windows.Forms.TreeView.CheckBoxes%2A> プロパティを `true` に設定することで、ノードの横にチェック ボックスがあるツリー ビューを表示することもできます。  ノードの <xref:System.Windows.Forms.TreeNode.Checked%2A> プロパティを `true` または `false` に設定することにより、プログラムでノードをオンまたはオフにすることができます。  
+  
+## 主要プロパティ  
+ <xref:System.Windows.Forms.TreeView> コントロールの主要プロパティは、<xref:System.Windows.Forms.TreeView.Nodes%2A> および <xref:System.Windows.Forms.TreeView.SelectedNode%2A> です。  <xref:System.Windows.Forms.TreeView.Nodes%2A> プロパティには、ツリー ビューの最上位のノードの一覧が含まれています。  <xref:System.Windows.Forms.TreeView.SelectedNode%2A> プロパティは、現在選択されているノードを設定します。  ノードの横にあるアイコンを表示することができます。  コントロールはツリー ビューの <xref:System.Windows.Forms.TreeView.ImageList%2A> プロパティで <xref:System.Windows.Forms.ImageList> という名前のイメージを使用します。  <xref:System.Windows.Forms.TreeView.ImageIndex%2A> プロパティは、ツリー ビューでノードの既定のイメージを設定します。  イメージを表示する方法についての詳細については、「[方法 : Windows フォーム TreeView コントロールのアイコンを設定する](../../../../docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md)」を参照してください。  [!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] を使用している場合は、<xref:System.Windows.Forms.TreeView> コントロールによって使用できる標準のイメージの大規模なライブラリにアクセスできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.TreeView>   
+ [TreeView コントロール](../../../../docs/framework/winforms/controls/treeview-control-windows-forms.md)   
+ [方法 : Windows フォーム TreeView コントロールのアイコンを設定する](../../../../docs/framework/winforms/controls/how-to-set-icons-for-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)   
+ [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](../../../../docs/framework/winforms/controls/how-to-iterate-through-all-nodes-of-a-windows-forms-treeview-control.md)   
+ [方法 : クリックされた TreeView ノードを判別する](../../../../docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md)   
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/treeview-control-windows-forms.md b/docs/framework/winforms/controls/treeview-control-windows-forms.md
new file mode 100644
index 00000000000..6912672b6ae
--- /dev/null
+++ b/docs/framework/winforms/controls/treeview-control-windows-forms.md
@@ -0,0 +1,59 @@
+---
+title: "TreeView コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "チェックされたリスト項目, Windows フォーム コントロール"
+  - "リスト コントロール, Windows フォーム"
+  - "リスト項目, Windows フォーム コントロール (項目の表示)"
+  - "TreeView コントロール [Windows フォーム]"
+ms.assetid: 879438b4-4eac-45c6-b345-0229c9b21ab0
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# TreeView コントロール (Windows フォーム)
+Windows フォームの `TreeView` コントロールでは、Windows オペレーティング システムの Windows エクスプローラーの左側のウィンドウにファイルやフォルダーが表示されるのと同じように、ノードの階層を表示することができます。  
+  
+## このセクションの内容  
+ [TreeView コントロールの概要](../../../../docs/framework/winforms/controls/treeview-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [方法 : Windows フォーム TreeView コントロールでノードを追加および削除する](../../../../docs/framework/winforms/controls/how-to-add-and-remove-nodes-with-the-windows-forms-treeview-control.md)  
+ ツリー ビューにノードを追加または削除するための方法を説明します。  
+  
+ [方法 : TreeView コントロールまたは ListView コントロール \(Windows フォーム\) にカスタム情報を追加する](../../../../docs/framework/winforms/controls/add-custom-information-to-a-treeview-or-listview-control-wf.md)  
+ リスト ビュー内のアイテムまたはツリー ビュー内のノードを派生して、必要なフィールド、メソッド、またはコンストラクターを追加するための手順を説明します。  
+  
+ [方法 : クリックされた TreeView ノードを判別する](../../../../docs/framework/winforms/controls/how-to-determine-which-treeview-node-was-clicked-windows-forms.md)  
+ アプリケーションが適切に応答できるように、ツリー ビュー内のどのノードがクリックされたか判断する方法を説明します。  
+  
+ [方法 : Windows フォーム TreeView コントロールのすべてのノードを反復処理する](http://msdn.microsoft.com/ja-jp/427f8928-ebcf-4beb-887f-695b905d5134)  
+ ツリー ビュー内の各ノードを確認するための手順を説明します。  
+  
+ [方法 : Windows フォーム TreeView コントロールのアイコンを設定する](http://msdn.microsoft.com/ja-jp/c14ddcc0-e5a6-4c21-a2d5-6799fd491781)  
+ ツリー ビューのノードのアイコンを表示する方法について説明します。  
+  
+ [方法 : ショートカット メニューを TreeView ノードに追加する](../../../../docs/framework/winforms/controls/how-to-attach-a-shortcut-menu-to-a-treeview-node.md)  
+ ツリー ビュー ノードにショートカット メニューを追加する方法について説明します。  
+  
+ 「[方法 : デザイナーで Windows フォーム TreeView コントロールを使ってノードを追加および削除する](http://msdn.microsoft.com/library/ms233651\(v=vs.110\))」、「[方法 : デザイナーを使用して TreeNode にショートカット メニューを割り当てる](http://msdn.microsoft.com/library/ms171708\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.TreeView> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ Windows フォーム コントロールの完全な一覧を、使用に関する情報リンクと共に提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/troubleshooting-control-and-component-authoring.md b/docs/framework/winforms/controls/troubleshooting-control-and-component-authoring.md
new file mode 100644
index 00000000000..072e0fdde04
--- /dev/null
+++ b/docs/framework/winforms/controls/troubleshooting-control-and-component-authoring.md
@@ -0,0 +1,123 @@
+---
+title: "コントロールとコンポーネントの作成時のトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コンポーネント [Windows フォーム], トラブルシューティング"
+  - "コントロール [Windows フォーム], トラブルシューティング"
+  - "トラブルシューティング (コンポーネントの)"
+  - "トラブルシューティング (コントロール)"
+  - "Windows フォーム コントロール, デバッグ"
+ms.assetid: e9c8c099-2271-4737-882f-50f336c7a55e
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# コントロールとコンポーネントの作成時のトラブルシューティング
+このトピックでは、コンポーネントとコントロールの作成時に発生する次の一般的な問題について説明します。  詳細については、「[コンポーネントによるプログラミング](../Topic/Programming%20with%20Components.md)」を参照してください。  
+  
+-   ツールボックスにコントロールを追加できない  
+  
+-   Windows フォームのユーザー コントロールまたはコンポーネントをデバッグできない  
+  
+-   継承されたコントロールまたはコンポーネントでイベントが 2 回発生する  
+  
+-   デザイン時エラー : "コンポーネント '*コンポーネント名*' を生成できませんでした。"  
+  
+-   STAThreadAttribute  
+  
+-   コンポーネント アイコンがツールボックスに表示されない  
+  
+## ツールボックスにコントロールを追加できない  
+ 別のプロジェクトで作成したカスタム コントロールまたはサードパーティ コントロールを**ツールボックス**に追加する場合は、手動で追加する必要があります。  コントロールまたはコンポーネントが現在のプロジェクトに含まれているときは、**ツールボックス**に自動的に表示されます。  詳細については、「[チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)」を参照してください。  
+  
+#### コントロールをツールボックスに追加するには  
+  
+1.  **\[ツールボックス\]** を右クリックして、ショートカット メニューの **\[アイテムの選択\]** をクリックします。  
+  
+2.  **\[ツールボックス アイテムの選択\]** ダイアログ ボックスで、コンポーネントを追加します。  
+  
+    -   .NET Framework コンポーネントまたはコントロールを追加するには、**\[.NET Framework コンポーネント\]** タブをクリックします。  
+  
+         または  
+  
+    -   COM コンポーネントまたは ActiveX コントロールを追加するには、**\[COM コンポーネント\]** タブをクリックします。  
+  
+3.  ダイアログ ボックスにコントロールが一覧表示されたら、コントロールが選択されていることを確認して **\[OK\]** をクリックします。  
+  
+     コントロールが**ツールボックス**に追加されます。  
+  
+4.  ダイアログ ボックスにコントロールが一覧表示されない場合は、次の手順を実行します。  
+  
+    1.  **\[Browse\]** をクリックします。  
+  
+    2.  コントロールが入っている .dll ファイルが格納されたフォルダーを参照します。  
+  
+    3.  .dll ファイルを選択し、**\[開く\]** をクリックします。  
+  
+         ダイアログ ボックスにコントロールが表示されます。  
+  
+    4.  コントロールが選択されていることを確認して **\[OK\]** をクリックします。  
+  
+         コントロールが**ツールボックス**に追加されます。  
+  
+## Windows フォームのユーザー コントロールまたはコンポーネントをデバッグできない  
+ コントロールが <xref:System.Windows.Forms.UserControl> クラスから派生している場合は、テスト コンテナーで実行時の動作をデバッグできます。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+ その他のカスタム コントロールやカスタム コンポーネントはスタンドアロン プロジェクトではありません。  そのため、Windows フォーム プロジェクトなどのアプリケーションでホストする必要があります。  コントロールまたはコンポーネントをデバッグするには、Windows フォーム プロジェクトに追加する必要があります。  
+  
+#### コントロールまたはコンポーネントをデバッグするには  
+  
+1.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックしてソリューションをビルドします。  
+  
+2.  **\[ファイル\]** メニューで、**\[追加\]**、**\[新しいプロジェクト\]** の順にクリックして、アプリケーションにテスト プロジェクトを追加します。  
+  
+3.  **\[新しいプロジェクトの追加\]** ダイアログ ボックスで、プロジェクトの種類として **\[Windows アプリケーション\]** を選択します。  
+  
+4.  **ソリューション エクスプローラー**で、新しいプロジェクトの **\[参照設定\]** ノードを右クリックします。  ショートカット メニューの **\[参照の追加\]** をクリックして、コントロールまたはコンポーネントを含むプロジェクトへの参照を追加します。  
+  
+5.  コントロールまたはコンポーネントのインスタンスをテスト プロジェクトに作成します。  コンポーネントが**ツールボックス**に表示されている場合は、デザイナー画面にドラッグできます。または、次のコード例に示すように、プログラムによってインスタンスを作成できます。  
+  
+    ```vb  
+    Dim Component1 As New MyNeatComponent()  
+    ```  
+  
+    ```csharp  
+    MyNeatComponent Component1 = new MyNeatComponent();  
+    ```  
+  
+     これで、コントロールまたはコンポーネントを通常の方法でデバッグできるようになります。  
+  
+ デバッグの詳細については、「[Visual Studio でのデバッグ](../Topic/Debugging%20in%20Visual%20Studio.md)」および「[チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](../../../../docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md)」を参照してください。  
+  
+## 継承されたコントロールまたはコンポーネントでイベントが 2 回発生する  
+ `Handles` 句が重複していることが原因と考えられます。  詳細については、「[Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)」を参照してください。  
+  
+## デザイン時エラー : "コンポーネント 'コンポーネント名' を生成できませんでした。"  
+ コンポーネントやコントロールは、パラメーターなしの既定のコンストラクターを提供する必要があります。  デザイン環境は、コンポーネントやコントロールのインスタンスを作成するときに、パラメーターを受け取るコンストラクター オーバーロードにパラメーターを提供しません。  
+  
+## STAThreadAttribute  
+ <xref:System.STAThreadAttribute> は、Windows フォームがシングルスレッド アパートメント モデルを使用することを共通言語ランタイム \(CLR: Common Language Runtime\) に通知します。  この属性を Windows フォーム アプリケーションの `Main` メソッドに適用していない場合、意図しない動作が発生する場合があります。  たとえば、<xref:System.Windows.Forms.ListView> などのコントロールに背景イメージが表示されない場合があります。  また、一部のコントロールでオートコンプリート動作やドラッグ アンド ドロップ動作を正常に行うためには、この属性が必要になる場合があります。  
+  
+## コンポーネント アイコンがツールボックスに表示されない  
+ <xref:System.Drawing.ToolboxBitmapAttribute> を使用してアイコンをカスタム コンポーネントに関連付けた場合、自動的に生成されたコンポーネントのビットマップがツールボックスに表示されません。  ビットマップを表示するには、**\[ツールボックス アイテムの選択\]** ダイアログ ボックスを使用してコントロールを再読み込みします。  詳細については、「[方法 : コントロールにツールボックス ビットマップを指定する](../../../../docs/framework/winforms/controls/how-to-provide-a-toolbox-bitmap-for-a-control.md)」を参照してください。  
+  
+## 参照  
+ [デザイン時の Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)   
+ [チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定](../../../../docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md)   
+ [方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)   
+ [チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ](../../../../docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md)   
+ [コンポーネントの作成](../Topic/Component%20Authoring.md)   
+ [Troubleshooting Design\-Time Development](../Topic/Troubleshooting%20Design-Time%20Development.md)   
+ [コンポーネントによるプログラミング](../Topic/Programming%20with%20Components.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/unbound-column-to-a-data-bound-datagridview.md b/docs/framework/winforms/controls/unbound-column-to-a-data-bound-datagridview.md
new file mode 100644
index 00000000000..3b60acd44ec
--- /dev/null
+++ b/docs/framework/winforms/controls/unbound-column-to-a-data-bound-datagridview.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "列 [Windows フォーム], バインドされていないデータ"
+  - "データ グリッド, 追加 (バインドされていない列を)"
+  - "DataGridView コントロール [Windows フォーム], バインドされていないデータ"
+ms.assetid: f7bdc4d8-ba8e-421b-ad62-82d936f01372
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : データバインドされた Windows フォーム DataGridView コントロールに非バインド列を追加する
+<xref:System.Windows.Forms.DataGridView> コントロールに表示するデータは、通常なんらかのデータ ソースから取得されるデータですが、データ ソース以外からのデータの列を表示する必要が生じることがあります。  この種類の列は、非バインド列と呼ばれます。  非バインド列の形式はさまざまです。  しばしば、データ行の詳細へのアクセスに使用されます。  
+  
+ マスター\/詳細シナリオを実装する場合に、\[**Details**\] ボタンの非バインド列を作成して、親テーブルの特定の行に関連付けられた子テーブルを表示する方法を次のコード例に示します。  ボタンのクリックに応答するには、子テーブルを含むフォームを表示する <xref:System.Windows.Forms.DataGridView.CellClick?displayProperty=fullName> イベント ハンドラーを実装します。  
+  
+ Visual Studio では、このタスクに対するサポートが用意されています。  「[方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](http://msdn.microsoft.com/library/dyyesckz\(v=vs.110\))」も参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridViewMisc#010](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/CS/datagridviewmisc.cs#010)]
+ [!code-vb[System.Windows.Forms.DataGridViewMisc#010](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewMisc/VB/datagridviewmisc.vb#010)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリおよび <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md b/docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md
new file mode 100644
index 00000000000..1e2496406db
--- /dev/null
+++ b/docs/framework/winforms/controls/use-the-row-template-to-customize-rows-in-the-datagrid.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ グリッド, カスタマイズ (行を)"
+  - "DataGridView コントロール [Windows フォーム], カスタマイズ (行を)"
+ms.assetid: 6db61607-7e57-4a84-8d63-9d6a7ed7f9ff
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 行テンプレートを使用して Windows フォーム DataGridView コントロールの行をカスタマイズする
+<xref:System.Windows.Forms.DataGridView> コントロールは、コントロールに追加するすべての行の基礎として行テンプレートを使用します。これは、データ バインディングを使用する場合にも、使用する既存の行を指定せずに <xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A?displayProperty=fullName> メソッドを呼び出す場合にも当てはまります。  
+  
+ 行テンプレートを使用すると、<xref:System.Windows.Forms.DataGridView.RowsDefaultCellStyle%2A> プロパティを使用した場合よりも、行の外観および動作を厳密に制御できます。  行テンプレートでは、<xref:System.Windows.Forms.DataGridViewRow.DefaultCellStyle%2A> を含む任意の <xref:System.Windows.Forms.DataGridViewRow> プロパティを設定できます。  
+  
+ 特定の効果を実現するために、行テンプレートを使用しなければならないこともあります。  たとえば、行の高さの情報は <xref:System.Windows.Forms.DataGridViewCellStyle> に格納できないため、行テンプレートを使用して、すべての行の既定の高さを変更する必要があります。  行テンプレートは、<xref:System.Windows.Forms.DataGridViewRow> から派生した独自のクラスを作成して、新しい行をコントロールに追加するときにカスタム型を使用する場合にも役立ちます。  
+  
+> [!NOTE]
+>  行テンプレートを使用できるのは、行を追加する場合だけです。  既存の行は、行テンプレートを変更することによって変更できません。  
+  
+### 行テンプレートを使用するには  
+  
+-   <xref:System.Windows.Forms.DataGridView.RowTemplate%2A?displayProperty=fullName> プロパティから取得したオブジェクトの各プロパティを設定します。  
+  
+     [!code-cpp[System.Windows.Forms.DataGridView.RowTemplate#1](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.RowTemplate/CPP/datagridviewrowtemplate.cpp#1)]
+     [!code-csharp[System.Windows.Forms.DataGridView.RowTemplate#1](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.RowTemplate/CS/datagridviewrowtemplate.cs#1)]
+     [!code-vb[System.Windows.Forms.DataGridView.RowTemplate#1](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.RowTemplate/VB/datagridviewrowtemplate.vb#1)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   `dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView> コントロール。  
+  
+-   <xref:System?displayProperty=fullName> アセンブリ、<xref:System.Drawing?displayProperty=fullName> アセンブリ、および <xref:System.Windows.Forms?displayProperty=fullName> アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridViewCellStyle>   
+ <xref:System.Windows.Forms.DataGridViewRow>   
+ <xref:System.Windows.Forms.DataGridView.RowTemplate%2A?displayProperty=fullName>   
+ [Windows フォームの DataGridView コントロールの基本的な書式設定およびスタイル設定](../../../../docs/framework/winforms/controls/basic-formatting-and-styling-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/user-drawn-controls.md b/docs/framework/winforms/controls/user-drawn-controls.md
new file mode 100644
index 00000000000..d7d903e4da1
--- /dev/null
+++ b/docs/framework/winforms/controls/user-drawn-controls.md
@@ -0,0 +1,95 @@
+---
+title: "ユーザー描画コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], ユーザー描画"
+  - "OnPaint メソッド [Windows フォーム]"
+  - "ユーザー描画コントロール [Windows フォーム]"
+ms.assetid: 034af4b5-457f-4160-a937-22891817faa8
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ユーザー描画コントロール
+.NET Framework には、独自のコントロールを簡単に開発する機能が用意されています。  いくつかの標準コントロールをコードで結び付けることにより、ユーザー コントロールを作成できます。または、独自のコントロールを一から設計することもできます。  さらには、継承機能を利用して、既存のコントロールを継承するコントロールを作成し、本来の機能を拡張することもできます。  どのようなアプローチの場合でも、.NET Framework には、作成するコントロールに対してカスタム グラフィカル インターフェイスを描画する機能が用意されています。  
+  
+ コントロールの描画は、コントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドのコードを実行することで行われます。  <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドの引数は <xref:System.Windows.Forms.PaintEventArgs> オブジェクトであり、コントロールのレンダリングに必要な情報と機能をすべて提供します。  <xref:System.Windows.Forms.PaintEventArgs> はプロパティとして、コントロールのレンダリングで使用される 2 つの主要なオブジェクトを提供します。  
+  
+-   <xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> オブジェクト \- 描画されるコントロールの一部を表す四角形です。  コントロールの描画方法によって、コントロール全体またはコントロールの一部になります。  
+  
+-   <xref:System.Drawing.Graphics> オブジェクト \- コントロールを描画するために必要な機能を提供するいくつかのグラフィック指向オブジェクトとメソッドをカプセル化します。  
+  
+ <xref:System.Drawing.Graphics> オブジェクトとその使い方の詳細については、「[方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.Control.OnPaint%2A> イベントは、コントロールが描画されるか、表示が更新されるたびに発生します。<xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> オブジェクトは、コントロールが描画される四角形を表します。  コントロール全体を更新する必要がある場合、<xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> オブジェクトはコントロール全体のサイズを表します。  ただし、コントロールの一部だけを更新する必要がある場合、<xref:System.Windows.Forms.PaintEventArgs.ClipRectangle%2A> オブジェクトは再描画する必要のある領域だけを表します。  ユーザー インターフェイスで別のコントロールまたはフォームが重なっているためにコントロールの一部が見えない場合などはその一例です。  
+  
+ <xref:System.Windows.Forms.Control> クラスから継承する場合は、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドし、その中にグラフィック レンダリング コードを記述する必要があります。  ユーザー コントロールまたは継承したコントロールにカスタム グラフィカル インターフェイスを提供する場合も、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドします。  次に例を示します。  
+  
+```vb  
+Protected Overrides Sub OnPaint(ByVal pe As PaintEventArgs)  
+   ' Call the OnPaint method of the base class.  
+   MyBase.OnPaint(pe)  
+  
+   ' Declare and instantiate a drawing pen.  
+   Dim myPen As System.Drawing.Pen = New System.Drawing.Pen(Color.Aqua)  
+  
+   ' Draw an aqua rectangle in the rectangle represented by the control.  
+   pe.Graphics.DrawRectangle(myPen, New Rectangle(Me.Location, Me.Size))  
+End Sub  
+  
+```  
+  
+```csharp  
+protected override void OnPaint(PaintEventArgs pe)  
+{  
+   // Call the OnPaint method of the base class.  
+   base.OnPaint(pe);  
+  
+   // Declare and instantiate a new pen.  
+   System.Drawing.Pen myPen = new System.Drawing.Pen(Color.Aqua);  
+  
+   // Draw an aqua rectangle in the rectangle represented by the control.  
+   pe.Graphics.DrawRectangle(myPen, new Rectangle(this.Location,   
+      this.Size));  
+}  
+  
+```  
+  
+ この例は、単純なグラフィカル表示によってコントロールをレンダリングする方法を示しています。  このコードは基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを呼び出し、描画に使用する <xref:System.Drawing.Pen> オブジェクトを作成して、コントロールの <xref:System.Windows.Forms.Control.Location%2A> と <xref:System.Windows.Forms.Control.Size%2A> で指定された四角形に楕円を描画します。  ほとんどのレンダリング コードはこの例よりもかなり複雑ですが、この例は <xref:System.Windows.Forms.PaintEventArgs> オブジェクトに含まれる <xref:System.Drawing.Graphics> オブジェクトの使用方法を示しています。  <xref:System.Windows.Forms.UserControl> や <xref:System.Windows.Forms.Button> など、既にグラフィカル表示が使用されているクラスから継承し、そのグラフィカル表示をコントロールのレンダリングに使用しない場合は、基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドを呼び出さないでください。  
+  
+ コントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドのコードは、コントロールが最初に描画されるとき、および表示が更新されたときに実行されます。  サイズが変更されたときにコントロールが必ず再描画されるようにするには、コントロールのコンストラクターに次の行を追加する必要があります。  
+  
+```vb  
+SetStyle(ControlStyles.ResizeRedraw, True)  
+  
+```  
+  
+```csharp  
+SetStyle(ControlStyles.ResizeRedraw, true);  
+  
+```  
+  
+> [!NOTE]
+>  四角形以外のコントロールを実装するには、<xref:System.Windows.Forms.Control.Region%2A?displayProperty=fullName> プロパティを使用します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Region%2A>   
+ <xref:System.Windows.Forms.ControlStyles>   
+ <xref:System.Drawing.Graphics>   
+ <xref:System.Windows.Forms.Control.OnPaint%2A>   
+ <xref:System.Windows.Forms.PaintEventArgs>   
+ [方法 : 描画する Graphics オブジェクトを作成する](../../../../docs/framework/winforms/advanced/how-to-create-graphics-objects-for-drawing.md)   
+ [内在コントロール](../../../../docs/framework/winforms/controls/constituent-controls.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/using-the-designer-with-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/using-the-designer-with-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..acff03b8784
--- /dev/null
+++ b/docs/framework/winforms/controls/using-the-designer-with-the-windows-forms-datagridview-control.md
@@ -0,0 +1,67 @@
+---
+title: "Windows フォーム DataGridView コントロールでのデザイナーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], デザイナーのサポート"
+  - "書式設定 [Windows フォーム]"
+  - "テーブル [Windows フォーム]"
+ms.assetid: b66057a6-5983-4864-b4e7-8cbc88a7010c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォーム DataGridView コントロールでのデザイナーの使用
+Visual Studio には、コードを書かずに多くのセットアップ タスクを実行できる、`DataGridView` コントロール用のデザイナーが用意されています。  実行できるタスクは、データ ソースへのコントロールのバインド、データ表示用の列の変更、コントロールの外観および基本動作の調整などです。  
+  
+## このセクションの内容  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を追加および削除する](../../../../docs/framework/winforms/controls/add-and-remove-columns-in-the-datagrid-using-the-designer.md)  
+ **\[列の追加\]** ダイアログ ボックスおよび **\[列の編集\]** ダイアログ ボックスを使用して、列コレクションへのデータの読み込みや列コレクションの編集を行う方法について説明します。  
+  
+ [方法 : デザイナーを使用してデータを Windows フォーム DataGridView コントロールにバインドする](../../../../docs/framework/winforms/controls/bind-data-to-the-datagrid-using-the-designer.md)  
+ コントロールのスマート タグで **\[データ ソースの選択\]** オプションを使用して、データに接続する方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の順序を変更する](../../../../docs/framework/winforms/controls/change-the-order-of-columns-in-the-datagrid-using-the-designer.md)  
+ **\[列の編集\]** ダイアログ ボックスを使用して、列を並べ替える方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView 列の種類を変更する](../../../../docs/framework/winforms/controls/change-the-type-of-a-wf-datagridview-column-using-the-designer.md)  
+ **\[列の編集\]** ダイアログ ボックスを使用して、列の種類を変更する方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列の並べ替えを有効にする](../../../../docs/framework/winforms/controls/enable-column-reordering-in-the-datagrid-using-the-designer.md)  
+ コントロールのスマート タグを使用して、ユーザーが列を並べ替えることができるようにする方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を固定する](../../../../docs/framework/winforms/controls/freeze-columns-in-the-datagrid-using-the-designer.md)  
+ **\[列の編集\]** ダイアログ ボックスを使用して、特定の列がスクロールしないようにする方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの列を非表示にする](../../../../docs/framework/winforms/controls/hide-columns-in-the-datagrid-using-the-designer.md)  
+ **\[列の編集\]** ダイアログ ボックスを使用して、特定の列を非表示にする方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/make-columns-read-only-in-the-datagrid-using-the-designer.md)  
+ **\[列の編集\]** ダイアログ ボックスを使用して、特定の列の値をユーザーが編集できないようにする方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-in-the-datagrid-using-the-designer.md)  
+ コントロールのスマート タグを使用して、ユーザーがデータを追加したり削除したりできないようにする方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールに交互の行のスタイルを設定する](../../../../docs/framework/winforms/controls/set-alternating-row-styles-for-the-datagrid-using-the-designer.md)  
+ **\[CellStyle ビルダー\]** ダイアログ ボックスを使用して、コントロール内で帳簿のような外観を作成する方法について説明します。  
+  
+ [方法 : デザイナーを使用して Windows フォーム DataGridView コントロールの既定のセル スタイルとデータ形式を設定する](../../../../docs/framework/winforms/controls/default-cell-styles-datagridview.md)  
+ **\[CellStyle ビルダー\]** ダイアログ ボックスを使用して、コントロールの基本的な外観とデータ表示形式を設定する方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.DataGridView>  
+ <xref:System.Windows.Forms.DataGridView> コントロールの参照ドキュメントを提供します。  
+  
+## 参照  
+ [DataGridView コントロール](../../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/using-the-managed-html-document-object-model.md b/docs/framework/winforms/controls/using-the-managed-html-document-object-model.md
new file mode 100644
index 00000000000..ab6d5991c5f
--- /dev/null
+++ b/docs/framework/winforms/controls/using-the-managed-html-document-object-model.md
@@ -0,0 +1,53 @@
+---
+title: "マネージ HTML DOM (Document Object Model) の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マネージ HTML DOM"
+ms.assetid: a017dd5c-cd7b-47e4-952c-f4f54cb48409
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# マネージ HTML DOM (Document Object Model) の使用
+マネージ HTML DOM \(Document Object Model\) は、Internet Explorer によって公開される HTML クラスに対して、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] に基づくラッパーを提供します。  このクラスを使用して、<xref:System.Windows.Forms.WebBrowser> コントロール内でホストされる HTML ページを操作します。新しいページを最初から構築することもできます。  
+  
+## このセクションの内容  
+ [方法 : マネージ HTML DOM \(Document Object Model\) にアクセスする](../../../../docs/framework/winforms/controls/how-to-access-the-managed-html-document-object-model.md)  
+ Windows フォーム アプリケーション、または Internet Explorer でホストされる <xref:System.Windows.Forms.UserControl> から、<xref:System.Windows.Forms.HtmlDocument> の有効なインスタンスを取得する方法について説明します。  
+  
+ [方法 : マネージ HTML DOM \(Document Object Model\) の HTML ソースにアクセスする](../../../../docs/framework/winforms/controls/how-to-access-the-html-source-in-the-managed-html-document-object-model.md)  
+ 変更されていない元の HTML ソースを取得する方法、および DOM の現在の状態を反映する "実稼動" ソースを取得する方法について説明します。  
+  
+ [方法 : マネージ HTML DOM \(Document Object Model\) の要素のスタイルを変更する](../../../../docs/framework/winforms/controls/how-to-change-styles-on-an-element-in-the-managed-html-document-object-model.md)  
+ 要素のビジュアル表示を制御するために使用されるスタイルの操作方法について説明します。  
+  
+ [マネージ HTML DOM \(Document Object Model\) へのアクセス](../../../../docs/framework/winforms/controls/accessing-frames-in-the-managed-html-document-object-model.md)  
+ フレームとフレームセットの概要、およびフレームの DOM にアクセスする方法について説明します。  
+  
+ [マネージ HTML DOM \(Document Object Model\) の非公開メンバーへのアクセス](../../../../docs/framework/winforms/controls/accessing-unexposed-members-on-the-managed-html-document-object-model.md)  
+ マネージ バージョンを持たない、基になる DOM のメンバーにアクセスする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.HtmlDocument>  
+  
+ <xref:System.Windows.Forms.HtmlElement>  
+  
+ <xref:System.Windows.Forms.HtmlWindow>  
+  
+## 関連項目  
+ [WebBrowser コントロール](../../../../docs/framework/winforms/controls/webbrowser-control-windows-forms.md)  
+  
+## 参照  
+ [About the DHTML Object Model \(DHTML オブジェクト モデルについて\)](http://msdn.microsoft.com/library/default.asp?url=/workshop/author/om/doc_object.asp)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..ec57b107024
--- /dev/null
+++ b/docs/framework/winforms/controls/using-the-row-for-new-records-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,73 @@
+---
+title: "Windows フォーム DataGridView コントロールにおける新規レコード行の使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 追加 (新規レコード行を)"
+  - "DataGridView コントロール [Windows フォーム], データ エントリ"
+  - "行, 新規レコード"
+ms.assetid: 6110f1ea-9794-442c-a98a-f104a1feeaf4
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Windows フォーム DataGridView コントロールにおける新規レコード行の使用
+アプリケーションでデータを編集するために <xref:System.Windows.Forms.DataGridView> を使用するときは、多くの場合、新しいデータ行をデータ ストアに追加する機能をユーザーに提供します。  <xref:System.Windows.Forms.DataGridView> コントロールはこの機能をサポートし、追加される新しいレコード行は常に最後の行として表示されます。  この行のヘッダーには、アスタリスク \(\*\) の記号が表示されます。  以下のセクションでは、新規レコード行を有効にしてプログラミングするときの考慮事項について説明します。  
+  
+## 新規レコード行の表示  
+ <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A> プロパティを使用して、新規レコード行を表示するかどうかを指定します。  このプロパティの既定値は `true` です。  
+  
+ データがバインドされている場合、コントロールの <xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A> プロパティとデータ ソースの <xref:System.ComponentModel.IBindingList.AllowNew%2A?displayProperty=fullName> プロパティが共に `true` であると、新規レコード行が表示されます。  これらのプロパティのいずれかが `false` の場合、行は表示されません。  
+  
+## 新規レコード行への既定のデータの読み込み  
+ ユーザーが新規レコード行を現在の行として選択すると、<xref:System.Windows.Forms.DataGridView> コントロールは、<xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded> イベントを生成します。  
+  
+ このイベントは新しい <xref:System.Windows.Forms.DataGridViewRow> へのアクセスを可能にし、新しい行に既定のデータを読み込むことができるようにします。  詳細については、「[方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する](../../../../docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md)」を参照してください。  
+  
+## 行コレクション  
+ 新規レコード行は、<xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションに含まれますが、次の 2 つの点で動作の仕方が異なります。  
+  
+-   新規レコード行は、プログラムによって <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションから削除できません。  削除しようとすると、<xref:System.InvalidOperationException> がスローされます。  また、新規レコード行は、ユーザーが削除することもできません。  <xref:System.Windows.Forms.DataGridViewRowCollection.Clear%2A?displayProperty=fullName> メソッドは、この行を <xref:System.Windows.Forms.DataGridView.Rows%2A> コレクションから削除しません。  
+  
+-   新規レコード行の後に行を追加できません。  そのように設定しようとすると、<xref:System.InvalidOperationException> が生成されます。  このため、新規レコード行は、常に <xref:System.Windows.Forms.DataGridView> コントロールの最後の行になります。  行を追加する、<xref:System.Windows.Forms.DataGridViewRowCollection> のメソッド \(<xref:System.Windows.Forms.DataGridViewRowCollection.Add%2A>、<xref:System.Windows.Forms.DataGridViewRowCollection.AddCopy%2A>、および<xref:System.Windows.Forms.DataGridViewRowCollection.AddCopies%2A>\) はすべて、新規レコード行が存在するときに挿入メソッドを内部的に呼び出します。  
+  
+## 新規レコード行のビジュアル カスタマイズ  
+ 新規レコード行は、<xref:System.Windows.Forms.DataGridView.RowTemplate%2A> プロパティで指定された行に基づいて作成されます。  この行に指定されていないセル スタイルは、他のプロパティから継承されます。  セル スタイルの継承の詳細については、「[Windows フォーム DataGridView コントロールでのセルのスタイル](../../../../docs/framework/winforms/controls/cell-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+ 新規レコード行のセルに表示される初期値は、各セルの <xref:System.Windows.Forms.DataGridViewCell.DefaultNewRowValue%2A> プロパティから取得されます。  セルの種類が <xref:System.Windows.Forms.DataGridViewImageCell> の場合、このプロパティはプレースホルダー イメージを返します。  それ以外の場合は、`null` を返します。  このプロパティは、カスタム値を返すようにオーバーライドできます。  ただし、セルの初期値は、新規レコード行にフォーカスが入ったときに <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded> イベント ハンドラーによって置き換えることができます。  
+  
+ この行のヘッダーの標準アイコン \(矢印またはアスタリスク\) は公開されません。  このアイコンをカスタマイズする場合は、カスタムの <xref:System.Windows.Forms.DataGridViewRowHeaderCell> クラスを作成する必要があります。  
+  
+ 標準アイコンは、行ヘッダー セルで使用されている <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A> プロパティを使用します。  標準アイコンは、表示領域が不十分な場合は描画されません。  
+  
+ 行ヘッダー セルに文字列値が設定され、テキストとアイコンの両方を表示する十分な領域がない場合は、アイコンが最初に無効にされます。  
+  
+## 並べ替え  
+ 非バインド モードでは、ユーザーが <xref:System.Windows.Forms.DataGridView> のコンテンツを並べ替えた場合でも、新規レコードは常に <xref:System.Windows.Forms.DataGridView> の最後に追加されます。  行を正確な位置に並べ替えるには、再度並べ替えを適用する必要があります。この動作は、<xref:System.Windows.Forms.ListView> コントロールの動作に似ています。  
+  
+ データ バインド モードと仮想モードでは、並べ替えを適用したときの挿入動作は、データ モデルの実装によって異なります。  [!INCLUDE[vstecado](../../../../includes/vstecado-md.md)] では、行がすぐに正確な位置に並べ替えられます。  
+  
+## 新規レコード行に関するその他の注意  
+ この行の <xref:System.Windows.Forms.DataGridViewRow.Visible%2A> プロパティは、`false` に設定できません。  そのように設定しようとすると、<xref:System.InvalidOperationException> が生成されます。  
+  
+ 新規レコード行は、常に未選択の状態で作成されます。  
+  
+## 仮想モード  
+ 仮想モードを実装する場合は、新規レコード行がデータ モデルで必要になる時点と、新規レコード行の追加をロールバックする時点を監視する必要があります。  この機能の正確な実装は、データ モデルの実装とそのトランザクション セマンティクス \(たとえば、コミット スコープがセル レベルか、行レベルかなど\) によって異なります。  詳細については、「[Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.DefaultValuesNeeded?displayProperty=fullName>   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールの新しい行に既定値を指定する](../../../../docs/framework/winforms/controls/specify-default-values-for-new-rows-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/varieties-of-custom-controls.md b/docs/framework/winforms/controls/varieties-of-custom-controls.md
new file mode 100644
index 00000000000..423ca986cd8
--- /dev/null
+++ b/docs/framework/winforms/controls/varieties-of-custom-controls.md
@@ -0,0 +1,123 @@
+---
+title: "さまざまなカスタム コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール"
+  - "コントロール [Windows フォーム], 複合"
+  - "コントロール [Windows フォーム], 拡張"
+  - "コントロール [Windows フォーム], 型"
+  - "コントロール [Windows フォーム], ユーザー コントロール"
+  - "カスタム コントロール [Windows フォーム]"
+  - "拡張されたコントロール"
+  - "ユーザー コントロール [Windows フォーム]"
+ms.assetid: 3cea09e5-4344-4ccb-9858-b66ccac210ff
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# さまざまなカスタム コントロール
+.NET Framework では、新しいコントロールを開発および実装できます。  継承を通じて、使い慣れたユーザー コントロールや既存のコントロールの機能の拡張もできます。  また、それぞれ独自の描画を実行するカスタム コントロールを作成することもできます。  
+  
+ 作成するコントロールの種類を決めるときに、判断に迷うことがあります。  ここでは、継承できる各種コントロールの違いを明らかにし、プロジェクトに合わせて特定の種類のコントロールを選択する方法について説明します。  
+  
+> [!NOTE]
+>  Web フォームで使用するコントロールの作成については、「[Developing Custom ASP.NET Server Controls](../Topic/Developing%20Custom%20ASP.NET%20Server%20Controls.md)」を参照してください。  
+  
+## 基本コントロール クラス  
+ <xref:System.Windows.Forms.Control> クラスは、Windows フォーム コントロールの基本クラスです。  このクラスは、Windows フォーム アプリケーションでのビジュアル表示に必要なインフラストラクチャを提供します。  
+  
+ <xref:System.Windows.Forms.Control> クラスは、Windows フォーム アプリケーションでビジュアル表示を実現するために次のタスクを実行します。  
+  
+-   ウィンドウ ハンドルを公開する。  
+  
+-   メッセージ ルーティングを管理する。  
+  
+-   マウス イベントとキーボード イベントの他にさまざまなユーザー インターフェイス イベントを提供する。  
+  
+-   高度なレイアウト機能を提供する。  
+  
+-   <xref:System.Windows.Forms.Control.ForeColor%2A>、<xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.Height%2A>、<xref:System.Windows.Forms.Control.Width%2A> など、ビジュアル表示に固有のさまざまなプロパティを格納する。  
+  
+-   Windows フォーム コントロールが Microsoft® ActiveX® コントロールとして機能するのに必要なセキュリティとスレッドのサポートを提供する。  
+  
+ 基本クラスによってインフラストラクチャの大部分が提供されるため、Windows フォーム コントロールは比較的簡単に開発できます。  
+  
+## コントロールの種類  
+ Windows フォームは、*複合*、*拡張*、*カスタム*の 3 種類のユーザー定義コントロールをサポートします。  次の各セクションでは、それぞれのコントロールについて説明し、プロジェクトで使用する種類を選択する際の推奨事項を示します。  
+  
+### 複合コントロール  
+ 複合コントロールは、Windows フォーム コントロールのコレクションをコモン コンテナーにカプセル化したものです。  この種のコントロールは、*ユーザー コントロール*とも呼ばれます。  コンテナーに含まれているコントロールは、*内在コントロール*と言います。  
+  
+ 複合コントロールは、含まれる各 Windows フォーム コントロールに関連付けられている本来の機能をすべて保持し、選択したプロパティを公開および関連付けることができます。  また、開発者側の追加作業が不要な、既定のキーボード処理機能を数多く提供します。  
+  
+ たとえば、複合コントロールを作成して、データベースの顧客アドレス データを表示することもできます。  このコントロールには、データベース フィールドを表示するための <xref:System.Windows.Forms.DataGridView> コントロール、データ ソースへのバインディングを処理するための <xref:System.Windows.Forms.BindingSource> コントロール、およびレコード間を移動するための <xref:System.Windows.Forms.BindingNavigator> コントロールが含まれます。  データ バインディング プロパティを選択的に公開し、さらにコントロール全体をパッケージ化してアプリケーション間で再利用できます。  この種の複合コントロールの例については、「[方法 : Windows フォーム コントロールに属性を適用する](../../../../docs/framework/winforms/controls/how-to-apply-attributes-in-windows-forms-controls.md)」を参照してください。  
+  
+ 複合コントロールを作成するには、<xref:System.Windows.Forms.UserControl> クラスから派生します。  <xref:System.Windows.Forms.UserControl> 基本クラスは、子コントロールに対してキーボード ルーティング機能を提供し、複数の子コントロールを 1 つのグループとして機能させることができます。  詳細については、「[複合 Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md)」を参照してください。  
+  
+ **推奨事項**  
+  
+ <xref:System.Windows.Forms.UserControl> クラスからの継承は、次の場合に適しています。  
+  
+-   いくつかの Windows フォーム コントロールの機能を 1 つの再利用可能な単位に結合する場合。  
+  
+### 拡張コントロール  
+ 既存の Windows フォーム コントロールから継承したコントロールを派生できます。  この方法では、Windows フォーム コントロールの本来の機能をすべて保持しながら、カスタム プロパティやカスタム メソッドなどを追加して、それらの機能を拡張できます。  この方法では、基本コントロールの描画ロジックをオーバーライドし、そのユーザー インターフェイスの外観を変更して拡張できます。  
+  
+ たとえば、<xref:System.Windows.Forms.Button> コントロールから派生させることで、ユーザーがクリックした回数を追跡するコントロールを作成できます。  
+  
+ 一部のコントロールでは、基本クラスの <xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドすることにより、コントロールのグラフィカル ユーザー インターフェイスに独自の外観を与えることもできます。  クリックを追跡する拡張ボタンでは、<xref:System.Windows.Forms.Control.OnPaint%2A> メソッドをオーバーライドして <xref:System.Windows.Forms.Control.OnPaint%2A> の基本実装を呼び出し、<xref:System.Windows.Forms.Button> コントロールのクライアント領域の一角にクリック回数を描画できます。  
+  
+ **推奨事項**  
+  
+ Windows フォーム コントロールからの継承は、次の場合に適しています。  
+  
+-   必要な機能のほとんどが、既存の Windows フォーム コントロールの機能と同じである場合。  
+  
+-   独自のグラフィカル ユーザー インターフェイスが必要でない場合。または、既存のコントロールに新しいグラフィカル ユーザー インターフェイスをデザインする場合。  
+  
+### カスタム コントロール  
+ コントロールを作成する方法には、<xref:System.Windows.Forms.Control> から継承することにより、コントロールを最初から作成する方法もあります。  <xref:System.Windows.Forms.Control> クラスは、コントロールで必要とされるすべての基本的な機能 \(マウスやキーボードの処理イベントなど\) を提供しますが、コントロール固有の機能やグラフィカル インターフェイスは提供しません。  
+  
+ <xref:System.Windows.Forms.Control> クラスから継承してコントロールを作成する場合は、<xref:System.Windows.Forms.UserControl> コントロールや既存の Windows フォーム コントロールから継承する場合に比べて、より多くの検討と作業が必要です。  開発者に数多くの実装作業が委ねられるため、作成されるコントロールは、複合コントロールや拡張コントロールよりも柔軟で、ニーズにちょうど合うようコントロールを調整できます。  
+  
+ カスタム コントロールを実装するには、必要な機能別のコードだけでなく、コントロールの <xref:System.Windows.Forms.Control.OnPaint%2A> イベントのコードも記述する必要があります。  また、<xref:System.Windows.Forms.Control.WndProc%2A> メソッドをオーバーライドして、Windows メッセージを直接処理することもできます。  これは、最も強力なコントロールの作成方法ですが、この方法を活用するには、Microsoft Win32® API を十分に理解しておく必要があります。  
+  
+ カスタム コントロールの例として、アナログ時計の外観と動作を模した時計コントロールがあります。  カスタム描画を実行することにより、内部の <xref:System.Windows.Forms.Timer> コンポーネントからの <xref:System.Windows.Forms.Timer.Tick> イベントに応答して、時計の針を動かすことができます。  詳細については、「[方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md)」を参照してください。  
+  
+ **推奨事項**  
+  
+ <xref:System.Windows.Forms.Control> クラスからの継承は、次の場合に適しています。  
+  
+-   コンポーネントに独自のグラフィカル表示を使用する場合。  
+  
+-   標準のコントロールにはない、独自の機能を実装する必要がある場合。  
+  
+### ActiveX コントロール  
+ Windows フォーム インストラクチャは、Windows フォーム コントロールをホストするために最適化されていますが、代わりに ActiveX コントロールを使用することもできます。  Visual Studio では、このタスクに対するサポートが用意されています。  詳細については、「[方法 : Windows フォームに ActiveX コントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-activex-controls-to-windows-forms.md)」を参照してください。  
+  
+### ウィンドウなしのコントロール  
+ Microsoft Visual Basic® 6.0 と ActiveX テクノロジは、*ウィンドウなしの*コントロールをサポートします。  ウィンドウなしのコントロールは、Windows フォームではサポートされません。  
+  
+## カスタムのデザイン体験  
+ カスタムのデザイン時体験を実装する必要がある場合は、独自のデザイナーを作成できます。  複合コントロールの場合は、<xref:System.Windows.Forms.Design.ParentControlDesigner> クラスや <xref:System.Windows.Forms.Design.DocumentDesigner> クラスからカスタム デザイナー クラスを派生します。  拡張コントロールやカスタム コントロールの場合は、<xref:System.Windows.Forms.Design.ControlDesigner> クラスからカスタム デザイナー クラスを派生します。  
+  
+ <xref:System.ComponentModel.DesignerAttribute> を使用して、コントロールをデザイナーに関連付けます。  詳細については、「[Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)」および「[How to: Create a Windows Forms Control That Takes Advantage of Design\-Time Features](../Topic/How%20to:%20Create%20a%20Windows%20Forms%20Control%20That%20Takes%20Advantage%20of%20Design-Time%20Features.md)」を参照してください。  
+  
+## 参照  
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md)   
+ [複合 Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md)   
+ [Extending Design\-Time Support](../Topic/Extending%20Design-Time%20Support.md)   
+ [How to: Create a Windows Forms Control That Takes Advantage of Design\-Time Features](../Topic/How%20to:%20Create%20a%20Windows%20Forms%20Control%20That%20Takes%20Advantage%20of%20Design-Time%20Features.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md b/docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md
new file mode 100644
index 00000000000..009233dd110
--- /dev/null
+++ b/docs/framework/winforms/controls/view-errors-within-a-dataset-with-wf-errorprovider-component.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "エラー メッセージ, 表示 (データセット内の)"
+  - "ErrorProvider コンポーネント [Windows フォーム], データセット エラー"
+  - "エラー [Windows フォーム], データセット エラー"
+ms.assetid: cbae023f-d651-4210-bdea-bcc5f037e321
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Windows フォーム ErrorProvider コンポーネントで DataSet 内にエラーを表示する
+Windows フォームの <xref:System.Windows.Forms.ErrorProvider> コンポーネントを使用すると、データセットなどのデータ ソース内の列エラーを表示できます。  <xref:System.Windows.Forms.ErrorProvider> コンポーネントでデータ エラーをフォームに表示する場合、コンポーネントをコントロールに直接関連付ける必要はありません。  データ ソースに連結すると、そのデータ ソースに連結されたすべてのコントロールの隣に、エラー アイコンを表示できるようになります。  
+  
+> [!NOTE]
+>  エラー プロバイダーの <xref:System.Windows.Forms.ErrorProvider.DataSource%2A> プロパティおよび <xref:System.Windows.Forms.ErrorProvider.DataMember%2A> プロパティを実行時に変更する場合は、<xref:System.Windows.Forms.ErrorProvider.BindToDataAndErrors%2A> メソッドを使用して競合を避ける必要があります。  
+  
+### データ エラーを表示するには  
+  
+1.  データ テーブルの特定の列にコンポーネントを連結します。  
+  
+    ```vb  
+    ' Assumes existence of DataSet1, DataTable1  
+    TextBox1.DataBindings.Add("Text", DataSet1, "Customers.Name")  
+    ErrorProvider1.DataSource = DataSet1  
+    ErrorProvider1.DataMember = "Customers"  
+  
+    ```  
+  
+    ```csharp  
+    // Assumes existence of DataSet1, DataTable1  
+    textBox1.DataBindings.Add("Text", DataSet1, "Customers.Name");  
+    errorProvider1.DataSource = DataSet1;  
+    errorProvider1.DataMember = "Customers";  
+  
+    ```  
+  
+2.  <xref:System.Windows.Forms.ErrorProvider.ContainerControl%2A> プロパティをフォームに設定します。  
+  
+    ```vb  
+    ErrorProvider1.ContainerControl = Me  
+  
+    ```  
+  
+    ```csharp  
+    errorProvider1.ContainerControl = this;  
+  
+    ```  
+  
+3.  現在のレコードの位置に、列エラーのある行を設定します。  
+  
+    ```vb  
+    DataTable1.Rows(5).SetColumnError("Name", "Bad data in this row.")  
+    Me.BindingContext(DataTable1).Position = 5  
+  
+    ```  
+  
+    ```csharp  
+    DataTable1.Rows[5].SetColumnError("Name", "Bad data in this row.");  
+    this.BindingContext [DataTable1].Position = 5;  
+  
+    ```  
+  
+## 参照  
+ [ErrorProvider コンポーネントの概要](../../../../docs/framework/winforms/controls/errorprovider-component-overview-windows-forms.md)   
+ [方法 : Windows フォーム ErrorProvider コンポーネントを使用してフォーム妥当性検査でエラー アイコンを表示する](../../../../docs/framework/winforms/controls/display-error-icons-for-form-validation-with-wf-errorprovider.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..2fd79f558f7
--- /dev/null
+++ b/docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,80 @@
+---
+title: "Windows フォーム DataGridView コントロールでの仮想モード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "DataGridView コントロール [Windows フォーム], 仮想モード"
+ms.assetid: feae5d43-2848-4b1a-8ea7-77085dc415b5
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Windows フォーム DataGridView コントロールでの仮想モード
+仮想モードを使用すると、<xref:System.Windows.Forms.DataGridView> コントロールとカスタム データ キャッシュ間の対話を管理できます。  仮想モードを実装するには、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティを `true` に設定し、ここで説明するイベントのうち 1 つ以上のイベントを処理します。  通常、少なくとも `CellValueNeeded` イベントだけは処理します。このイベントにより、コントロールがデータ キャッシュの値を検索できます。  
+  
+## バインド モードと仮想モード  
+ 仮想モードは、バインド モードを補完したり、置き換えたりする場合にのみ必要になります。  バインド モードでは、<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティを設定すると、コントロールが、指定したソースからデータを自動的に読み込み、ユーザーが行った変更をソースに送り返します。  バインド モードでは、どのバインド列を表示するかを制御できます。並べ替えなどの操作は、通常、データ ソース自体が処理します。  
+  
+## バインド モードの補完  
+ バインド列と共に非バインド列を表示することによって、バインド モードを補完できます。  これは "混合モード" とも呼ばれ、計算値やユーザー インターフェイス \(UI\) コントロールなどの要素を表示するのに役立ちます。  
+  
+ 非バインド列は、データ ソースの外部に存在するので、データ ソースの並べ替え操作で無視されます。  そのため、混合モードでの並べ替えを有効にする場合は、非バインド データをローカル キャッシュで管理し、仮想モードを実装して <xref:System.Windows.Forms.DataGridView> コントロールがキャッシュと対話できるようにする必要があります。  
+  
+ 仮想モードを使用して非バインド列の値を保持する方法の詳細については、<xref:System.Windows.Forms.DataGridViewCheckBoxColumn.ThreeState%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Forms.DataGridViewComboBoxColumn?displayProperty=fullName> クラスのリファレンス トピックに記載されている例を参照してください。  
+  
+## バインド モードの置換  
+ バインド モードがパフォーマンス上のニーズに適合しない場合は、仮想モード イベント ハンドラーを通じて、カスタム キャッシュ内のすべてのデータを管理できます。  たとえば、仮想モードを使用すると、Just\-In\-Time データ読み込み機構を実装できます。この機構では、ネットワーク接続されたデータベースから必要なデータだけを取得することで最適なパフォーマンスを実現します。   これは、低速のネットワーク接続で大量のデータを操作したり、RAM 容量やストレージ領域が制限されたクライアント コンピューターで作業する場合に特に役立ちます。  
+  
+ Just\-In\-Time のシナリオにおける仮想モードの使用方法の詳細については、「[Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)」を参照してください。  
+  
+## 仮想モード イベント  
+ データが読み取り専用の場合は、`CellValueNeeded` イベントを処理するだけで済むことがあります。  その他の仮想モード イベントを使用すると、ユーザーによる編集、行の追加と削除、行レベルのトランザクションなど、特定の機能を有効にできます。  
+  
+ 一部の標準 <xref:System.Windows.Forms.DataGridView> イベント \(ユーザーが行を追加または削除したときに発生するイベントや、セル値の編集、解析、検証、または書式指定時に発生するイベントなど\) は、仮想モードでも役立ちます。  また、セルのツールヒント テキスト、セルと行のエラー テキスト、セルと行のショートカット メニュー データ、行の高さデータなど、一般にバインド データ ソースに保存されない値を保持できるようにするイベントも処理できます。  
+  
+ 行レベルのコミット スコープで読み書き両用データを管理するために仮想モードを実装する方法の詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+ セル レベルのコミット スコープで仮想モードを実装する例については、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティのリファレンス トピックを参照してください。  
+  
+ 次のイベントは、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティが `true` に設定されているときにのみ発生します。  
+  
+|Event|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.DataGridView.CellValueNeeded>|コントロールが、データ キャッシュからセル値を取得して表示するために使用します。  このイベントは、非バインド列のセルに対してのみ発生します。|  
+|<xref:System.Windows.Forms.DataGridView.CellValuePushed>|コントロールが、セルへのユーザー入力をデータ キャッシュにコミットするために使用します。  このイベントは、非バインド列のセルに対してのみ発生します。<br /><br /> <xref:System.Windows.Forms.DataGridView.CellValuePushed> イベント ハンドラーの外部でキャッシュ値を変更したときは、<xref:System.Windows.Forms.DataGridView.UpdateCellValue%2A> メソッドを呼び出して、現在値がコントロールで確実に表示されるようにし、現在有効な自動サイズ変更モードを適用します。|  
+|<xref:System.Windows.Forms.DataGridView.NewRowNeeded>|コントロールが、データ キャッシュで新しい行が必要かどうかを示すために使用します。|  
+|<xref:System.Windows.Forms.DataGridView.RowDirtyStateNeeded>|コントロールが、コミットされていない変更が行に存在するかどうかを判断するために使用します。|  
+|<xref:System.Windows.Forms.DataGridView.CancelRowEdit>|コントロールが、行をキャッシュ値に戻す必要があることを示すために使用します。|  
+  
+ 次のイベントは仮想モードで有効ですが、<xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティの設定と無関係に使用できます。  
+  
+|イベント|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.Forms.DataGridView.UserDeletingRow><br /><br /> <xref:System.Windows.Forms.DataGridView.UserDeletedRow><br /><br /> <xref:System.Windows.Forms.DataGridView.RowsRemoved><br /><br /> <xref:System.Windows.Forms.DataGridView.RowsAdded>|行が削除または追加されたことを示すためにコントロールが使用します。これに応じて、データ キャッシュを更新できます。|  
+|<xref:System.Windows.Forms.DataGridView.CellFormatting><br /><br /> <xref:System.Windows.Forms.DataGridView.CellParsing><br /><br /> <xref:System.Windows.Forms.DataGridView.CellValidating><br /><br /> <xref:System.Windows.Forms.DataGridView.CellValidated><br /><br /> <xref:System.Windows.Forms.DataGridView.RowValidating><br /><br /> <xref:System.Windows.Forms.DataGridView.RowValidated>|コントロールが、表示するセル値の書式を設定し、ユーザー入力を解析および検証するために使用します。|  
+|<xref:System.Windows.Forms.DataGridView.CellToolTipTextNeeded>|<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティが設定されているとき、または <xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティが `true` であるときに、コントロールがセルのツールヒント テキストを取得するために使用します。<br /><br /> セルのツールヒントは、<xref:System.Windows.Forms.DataGridView.ShowCellToolTips%2A> プロパティ値が `true` のときにのみ表示されます。|  
+|<xref:System.Windows.Forms.DataGridView.CellErrorTextNeeded><br /><br /> <xref:System.Windows.Forms.DataGridView.RowErrorTextNeeded>|<xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティが設定されているとき、または <xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティが `true` のときに、コントロールがセルまたは行のエラー テキストを取得するために使用します。<br /><br /> セルまたは行のエラー テキストを変更したときは、<xref:System.Windows.Forms.DataGridView.UpdateCellErrorText%2A> メソッドまたは <xref:System.Windows.Forms.DataGridView.UpdateRowErrorText%2A> メソッドを呼び出して、現在の値がコントロールに確実に表示されるようにします。<br /><br /> セルと行のエラー グリフは、<xref:System.Windows.Forms.DataGridView.ShowCellErrors%2A> プロパティと <xref:System.Windows.Forms.DataGridView.ShowRowErrors%2A> プロパティの値が `true` の場合に表示されます。|  
+|<xref:System.Windows.Forms.DataGridView.CellContextMenuStripNeeded><br /><br /> <xref:System.Windows.Forms.DataGridView.RowContextMenuStripNeeded>|コントロールの <xref:System.Windows.Forms.DataGridView.DataSource%2A> プロパティが設定されているとき、または <xref:System.Windows.Forms.DataGridView.VirtualMode%2A> プロパティが `true` のときに、コントロールがセルまたは行の <xref:System.Windows.Forms.ContextMenuStrip> を取得するために使用します。|  
+|<xref:System.Windows.Forms.DataGridView.RowHeightInfoNeeded><br /><br /> <xref:System.Windows.Forms.DataGridView.RowHeightInfoPushed>|コントロールが、行の高さ情報をデータ キャッシュから取得または保存するために使用します。  キャッシュされた行の高さ情報を <xref:System.Windows.Forms.DataGridView.RowHeightInfoPushed> イベント ハンドラーの外部で変更したときは、<xref:System.Windows.Forms.DataGridView.UpdateRowHeightInfo%2A> を呼び出して、現在の値がコントロールに確実に表示されるようにします。|  
+  
+## 仮想モードで推奨される手順  
+ 大量のデータを効率的に操作するために仮想モードを実装する場合は、<xref:System.Windows.Forms.DataGridView> コントロール自体も効率よく操作できるようにする必要があります。  セル スタイル、自動サイズ変更、選択、および行の共有の効果的な使い方の詳細については、「[Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールを拡張するための推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-scaling-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md b/docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md
new file mode 100644
index 00000000000..7ddfddb2553
--- /dev/null
+++ b/docs/framework/winforms/controls/virtual-mode-with-just-in-time-data-loading-in-the-datagrid.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : Windows フォーム DataGridView コントロールで Just-In-Time データ読み込みを使用して仮想モードを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 管理 (大容量のデータセットを)"
+  - "DataGridView コントロール [Windows フォーム], 大容量のデータセット"
+  - "DataGridView コントロール [Windows フォーム], 仮想モード"
+  - "例 [Windows フォーム], Just-In-Time データ読み込み"
+  - "Just-In-Time データ読み込み"
+  - "仮想モード, Just-In-Time データ読み込み"
+ms.assetid: 33825f92-7a22-40ee-86d9-9a2ed1ead7b7
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォーム DataGridView コントロールで Just-In-Time データ読み込みを使用して仮想モードを実装する
+次のコード例では、必要がある場合にのみ、サーバーからデータを読み込むデータ キャッシュを持つ <xref:System.Windows.Forms.DataGridView> コントロールで仮想モードを使用する方法を示しています。  この例は、「[Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)」で詳細に説明しています。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.DataGridView.Virtual_lazyloading#000](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/CS/lazyloading.cs#000)]
+ [!code-vb[System.Windows.Forms.DataGridView.Virtual_lazyloading#000](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridView.Virtual_lazyloading/VB/lazyloading.vb#000)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Xml、および System.Windows.Forms の各アセンブリへの参照。  
+  
+-   Northwind SQL Server サンプル データベースがインストールされているサーバーへのアクセス。  
+  
+ [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## .NET Framework セキュリティ  
+ 接続文字列内に機密情報 \(パスワードなど\) を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.DataGridView.VirtualMode%2A>   
+ <xref:System.Windows.Forms.DataGridView.CellValueNeeded>   
+ [Windows フォーム DataGridView コントロールでの Just\-In\-Time データ読み込みによる仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-jit-data-loading-in-the-datagrid.md)   
+ [Windows フォーム DataGridView コントロールでのパフォーマンス チューニング](../../../../docs/framework/winforms/controls/performance-tuning-in-the-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでの仮想モード](../../../../docs/framework/winforms/controls/virtual-mode-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md
new file mode 100644
index 00000000000..f961a1f1ea9
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md
@@ -0,0 +1,208 @@
+---
+title: "チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "FlowLayoutPanel コントロール [Windows フォーム]、チュートリアル"
+  - "Windows フォーム コントロール、配置"
+  - "コントロール [Windows フォーム]、FlowLayoutPanel を使用した配置"
+  - "レイアウト [Windows フォーム]、チュートリアル"
+ms.assetid: a1744323-0316-49c2-992e-ebfc0a976b85
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置
+アプリケーションによっては、フォームのサイズを変更したり、コンテンツのサイズが変化したりしたときに、それに応じて自動的にレイアウトを調整するフォームが必要です。 動的なレイアウトが必要であり、かつコードで <xref:System.Windows.Forms.Control.Layout> イベントを明示的に処理しない場合は、レイアウト パネルの使用をご検討ください。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールと <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用すると、コントロールをフォームに直感的な方法で配置できます。 これら 2 つのコントロールは、それぞれに含まれる子コントロールの相対位置を制御するための自動的で構成可能な機能を提供します。また、どちらも実行時に動的なレイアウト機能を提供するため、親フォームの寸法の変更に応じて子コントロールのサイズと位置を変更できます。 レイアウト パネルは他のレイアウト パネルの入れ子にすることができるため、高度なユーザー インターフェイスを実現できます。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> は、その内容をグリッドに配置し、HTML \<table\> 要素と同じような機能を提供します。 セルは行と列に配置され、それぞれに異なるサイズを設定できます。 詳細については、「[チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> はその内容を特定のフローの方向 \(水平または垂直\) に配置します。 ある行から次の行、またはある列から次の列に内容をラップすることができます。 また、ラップする代わりにクリップすることもできます。 このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   コントロールの水平配置と垂直配置  
+  
+-   フロー方向の変更  
+  
+-   フロー中断の挿入  
+  
+-   パディングと余白を使用したコントロールの配置  
+  
+-   ツールボックスでのダブルクリックによるコントロールの挿入  
+  
+-   アウトラインの描画によるコントロールの挿入  
+  
+-   キャレットを使用したコントロールの挿入  
+  
+-   別の親コントロールへの既存コントロールの再割り当て  
+  
+ 終了すると、これらの重要なレイアウト機能が果たす役割について理解できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。 設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。 詳細については、「[Visual Studio での開発設定のカスタマイズ](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  "FlowLayoutPanelExample" という名前の Windows ベース アプリケーション プロジェクトを作成します。 詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **フォーム デザイナー**でフォームを選びます。  
+  
+## コントロールの水平配置と垂直配置  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールでは、コントロールを行や列に沿って配置でき、各コントロールの位置を正確に指定する必要がありません。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールでは、親フォームの寸法の変更に応じて、子コントロールのサイズやフローを変更できます。  
+  
+#### FlowLayoutPanel を使用してコントロールを水平方向または垂直方向に配置するには  
+  
+1.  **ツールボックス**から <xref:System.Windows.Forms.FlowLayoutPanel> コントロールをフォームにドラッグします。  
+  
+2.  **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> にドラッグします。 このコントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの左上隅に自動的に移動されることにご注意ください。  
+  
+3.  **ツールボックス**から別の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> にドラッグします。<xref:System.Windows.Forms.Button> コントロールが、最初の <xref:System.Windows.Forms.Button> コントロールの横の位置に自動的に移動することにご注意ください。<xref:System.Windows.Forms.FlowLayoutPanel> が狭すぎて、2 つのコントロールが同じ行に入りきらない場合、新しい <xref:System.Windows.Forms.Button> コントロールは次の行に自動的に移動します。  
+  
+4.  **ツールボックス**からさらにいくつかの <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> にドラッグします。 次の行に折り返すまで、<xref:System.Windows.Forms.Button> コントロールを続けて配置します。  
+  
+5.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.FlowLayoutPanel.WrapContents%2A> プロパティの値を `false` に変更します。 子コントロールが次の行にフローしなくなることにご注意ください。 代わりに最初の行に移動してクリップされます。  
+  
+6.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.FlowLayoutPanel.WrapContents%2A> プロパティの値を `true` に変更します。 子コントロールがまた次の行に折り返されるようになることにご注意ください。  
+  
+7.  すべての <xref:System.Windows.Forms.Button> コントロールが最初の列に移動するまで、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの幅を縮小します。  
+  
+8.  すべての <xref:System.Windows.Forms.Button> コントロールが最初の行に移動するまで、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの幅を拡大します。 幅の拡大に対応できるように、フォームのサイズ変更が必要になる場合があります。  
+  
+## フロー方向の変更  
+ <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティを使用すると、コントロールの配置方向を変更できます。 子コントロールは左から右、右から左、上から下、または下から上に配置できます。  
+  
+#### FlowLayoutPanel のフロー方向を変更するには  
+  
+1.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティの値を <xref:System.Windows.Forms.FlowDirection> に変更します。 コントロールの高さに応じて、子コントロールが 1 つ以上の列に再配置されることにご注意ください。  
+  
+2.  <xref:System.Windows.Forms.FlowLayoutPanel> のサイズを変更し、その高さを <xref:System.Windows.Forms.Button> コントロールの列よりも小さくします。<xref:System.Windows.Forms.FlowLayoutPanel> が、子コントロールを次の列にフローするように再配置することにご注意ください。 引き続き高さを小さくしていくと、子コントロールが次の列にフローしていくことにご注意ください。<xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティの値を <xref:System.Windows.Forms.FlowDirection> に変更します。 子コントロールの位置が反転することにご注意ください。<xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティの値を <xref:System.Windows.Forms.FlowDirection> に変更したときのレイアウトをご確認ください。  
+  
+## フロー中断の挿入  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールでは、その子コントロールに FlowBreak プロパティを指定できます。 FlowBreak プロパティの値を `true` に設定することで、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールを現在のフロー方向のコントロールにレイアウトすること、および次の行または列にラップすることを停止します。  
+  
+#### フロー中断を挿入するには  
+  
+1.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> プロパティの値を <xref:System.Windows.Forms.FlowDirection> に変更します。  
+  
+2.  左端の列の中ほどにある、<xref:System.Windows.Forms.Button> コントロールの 1 つを選びます。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの FlowBreak プロパティの値を `true` に設定します。 列が区切られ、選んだ <xref:System.Windows.Forms.Button> コントロールよりも後のコントロールが次の列にフローすることにご注意ください。<xref:System.Windows.Forms.Button> コントロールの FlowBreak プロパティの値を `false` に設定すると、元の動作に戻ります。  
+  
+## ドッキングと固定を使用したコントロールの配置  
+ 子コントロールのドッキング動作と固定動作は、他のコンテナー コントロールの動作と異なります。 ドッキングも固定も、フロー方向で最も大きいコントロールを基準として機能します。  
+  
+#### ドッキングと固定を使用してコントロールを配置するには  
+  
+1.  <xref:System.Windows.Forms.Button> コントロールがすべて 1 列に配置されるまで、<xref:System.Windows.Forms.FlowLayoutPanel> のサイズを拡大します。  
+  
+2.  1 番上にある <xref:System.Windows.Forms.Button> コントロールを選びます。 幅を拡大して、他の <xref:System.Windows.Forms.Button> コントロールの約 2 倍の幅にします。  
+  
+3.  2 番目の <xref:System.Windows.Forms.Button> コントロールを選びます。<xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を <xref:System.Windows.Forms.AnchorStyles> に変更します。 選択したコントロールが移動し、その右側の境界線が 1 番目の <xref:System.Windows.Forms.Button> コントロールの右側の境界線と揃うことにご注意ください。  
+  
+4.  <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を <xref:System.Windows.Forms.AnchorStyles> および <xref:System.Windows.Forms.AnchorStyles> に変更します。 サイズが変更され、1 番目の <xref:System.Windows.Forms.Button> コントロールと同じ幅になることにご注意ください。  
+  
+5.  3 番目の <xref:System.Windows.Forms.Button> コントロールを選びます。<xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。 サイズが変更され、1 番目の <xref:System.Windows.Forms.Button> コントロールと同じ幅になることにご注意ください。  
+  
+## パディングと余白を使用したコントロールの配置  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールには、<xref:System.Windows.Forms.Control.Padding%2A> と <xref:System.Windows.Forms.Control.Margin%2A> のプロパティを変更してコントロールを配置することもできます。  
+  
+ <xref:System.Windows.Forms.Control.Padding%2A> プロパティを使用すると、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールのセル内でコントロールの配置を制御できます。 このプロパティは、子コントロールと <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの境界との間隔を指定します。  
+  
+ <xref:System.Windows.Forms.Control.Margin%2A> プロパティでは、コントロール間の間隔を制御できます。  
+  
+#### Padding プロパティと Margin プロパティを使用してコントロールを配置するには  
+  
+1.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。 フォームの大きさが十分にある場合、<xref:System.Windows.Forms.Button> コントロールは <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの最初の列に移動します。  
+  
+2.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの値を変更します。これを行うには、**\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Padding%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを **20** に設定します。 詳細については、「[チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)」を参照してください。 子コントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの中央に移動することにご注意ください。<xref:System.Windows.Forms.Control.Padding%2A> プロパティの値を大きくすると、子コントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの境界から離れます。  
+  
+3.  <xref:System.Windows.Forms.FlowLayoutPanel> 内の <xref:System.Windows.Forms.Button> コントロールをすべて選び、<xref:System.Windows.Forms.Control.Margin%2A> プロパティの値を **20** に設定します。<xref:System.Windows.Forms.Button> コントロール間の間隔が広がり、各コントロールが離れることにご注意ください。 すべての子コントロールを表示するには、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールのサイズを拡大する必要がある場合があります。  
+  
+## ツールボックスでのダブルクリックによるコントロールの挿入  
+ **ツールボックス**でコントロールをダブルクリックすると、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールに内容を挿入できます。  
+  
+#### ツールボックスでダブルクリックしてコントロールを挿入するには  
+  
+1.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをダブルクリックします。 新しい <xref:System.Windows.Forms.Button> コントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに表示されることにご注意ください。  
+  
+2.  **ツールボックス**でさらにいくつかのコントロールをダブルクリックします。 新しいコントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに順次表示されることにご注意ください。  
+  
+## アウトラインの描画によるコントロールの挿入  
+ セルにアウトラインを描画すると、コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに挿入し、サイズを指定できます。  
+  
+#### アウトラインを描画してコントロールを挿入するには  
+  
+1.  **ツールボックス**で <xref:System.Windows.Forms.Button> コントロール アイコンをクリックします。 フォームにドラッグしないでください。  
+  
+2.  <xref:System.Windows.Forms.FlowLayoutPanel> コントロールにマウス ポインターを置きます。 ポインターが <xref:System.Windows.Forms.Button> コントロール アイコンが付いた十字カーソルに変わることにご注意ください。  
+  
+3.  マウス ボタンを押したままにします。  
+  
+4.  マウス ポインターをドラッグして、<xref:System.Windows.Forms.Button> コントロールのアウトラインを描画します。 適切なサイズのアウトラインを描画したら、マウス ボタンを離します。<xref:System.Windows.Forms.FlowLayoutPanel> コントロール上の次の空き位置に <xref:System.Windows.Forms.Button> コントロールが作成されることにご注意ください。  
+  
+## 挿入バーを使用したコントロールの挿入  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールの特定の位置にコントロールを挿入できます。<xref:System.Windows.Forms.FlowLayoutPanel> コントロールのクライアント領域にコントロールをドラッグすると、コントロールの挿入位置を示す挿入バーが表示されます。  
+  
+#### キャレットを使用してコントロールを挿入するには  
+  
+1.  **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> コントロールにドラッグし、2 つの <xref:System.Windows.Forms.Button> コントロールの間の領域をポイントします。 挿入バーが描画され、<xref:System.Windows.Forms.Button> を <xref:System.Windows.Forms.FlowLayoutPanel> コントロールにドロップしたときに挿入される位置が示されることにご注意ください。 新しい <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> コントロールにドロップする前に、マウス ポインターを移動して、挿入バーがどのように移動するかを確認します。  
+  
+2.  新しい <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.FlowLayoutPanel> コントロールにドロップします。 新しい <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティの値が異なるため、他のコントロールとは位置が揃わないことにご注意ください。  
+  
+## 別の親コントロールへの既存コントロールの再割り当て  
+ フォームに存在するコントロールを新しい <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに割り当てることができます。  
+  
+#### 既存のコントロールの親を変更するには  
+  
+1.  **ツールボックス**から 3 つの <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグします。 これらを互いに近づけて配置しますが、整列はさせません。  
+  
+2.  **ツールボックス**で <xref:System.Windows.Forms.FlowLayoutPanel> コントロール アイコンをクリックします。 フォームにドラッグしないでください。  
+  
+3.  マウス ポインターを 3 つの <xref:System.Windows.Forms.Button> コントロールに近づけます。 ポインターが <xref:System.Windows.Forms.FlowLayoutPanel> コントロール アイコンが付いた十字カーソルに変わることにご注意ください。  
+  
+4.  マウス ボタンを押したままにします。  
+  
+5.  マウス ポインターをドラッグして、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールのアウトラインを描画します。 3 つの <xref:System.Windows.Forms.Button> コントロールを囲むようにアウトラインを描画します。  
+  
+6.  マウスのボタンを離します。 3 つの <xref:System.Windows.Forms.Button> コントロールが <xref:System.Windows.Forms.FlowLayoutPanel> コントロールに挿入されることにご注意ください。  
+  
+## 次の手順  
+ レイアウト パネルとコントロールを組み合わせて使用すると、複雑なレイアウトを作成できます。 さらに詳しく調べるための推奨事項を次に示します。  
+  
+-   いずれかの <xref:System.Windows.Forms.Button> コントロールのサイズを拡大して、レイアウトの変化を確認します。  
+  
+-   レイアウト パネルには、別のレイアウト パネルを含めることができます。<xref:System.Windows.Forms.TableLayoutPanel> コントロールを既存のコントロールにドロップしてみます。  
+  
+-   <xref:System.Windows.Forms.FlowLayoutPanel> コントロールを親フォームにドッキングします。 フォームのサイズを変更し、レイアウトの変化を確認します。  
+  
+-   いずれかのコントロールの <xref:System.Windows.Forms.Control.Visible%2A> プロパティを `false` に設定し、これに呼応して <xref:System.Windows.Forms.FlowLayoutPanel> のフローがどのように変化するか確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [Microsoft Windows User Experience, Official Guidelines for User Interface Developers and Designers. Redmond、WA: Microsoft Press、1999 年。 \(USBN: 0\-7356\-0566\-1\)](http://www.microsoft.com/mspress/southpacific/books/book11588.htm)   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)   
+ [方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)   
+ [方法 : Windows フォームにコントロールを固定する](../../../../docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md)   
+ [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md
new file mode 100644
index 00000000000..ec443143685
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md
@@ -0,0 +1,202 @@
+---
+title: "チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 配置 (TableLayoutPanel を使用した)"
+  - "TableLayoutPanel コントロール [Windows フォーム], チュートリアル"
+  - "Windows フォーム コントロール, 配置"
+ms.assetid: d474885e-12cc-4ab7-b997-2a23a643049b
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置
+アプリケーションによっては、フォームのサイズを変更したり、コンテンツのサイズが変化したりしたときに、それに応じて自動的にレイアウトを調整するフォームが必要です。  動的なレイアウトが必要であり、しかも <xref:System.Windows.Forms.Control.Layout> イベントをコードで明示的に処理しない場合は、レイアウト パネルの使用を検討してください。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> コントロールや <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用すると、コントロールをフォームに直観的に配置できます。  これら 2 つのコントロールは、それぞれに含まれる子コントロールの相対位置を制御するための自動的で設定可能な機能を提供します。また、実行時に動的なレイアウト機能を提供するため、親フォームの寸法の変更に応じて子コントロールのサイズと位置を変更できます。  また、レイアウト パネルは他のレイアウト パネルの入れ子にすることもできるため、高度なユーザー インターフェイスを実現できます。  
+  
+ <xref:System.Windows.Forms.FlowLayoutPanel> は、その内容を特定のフロー方向 \(水平または垂直方向\) に配置します。  このコントロールの内容は、ある行から次の行、またはある列から次の列に折り返すことができます。  また、折り返さずにクリップすることもできます。  詳細については、「[チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)」を参照してください。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> は、その内容をグリッドに配置し、HTML \<table\> 要素と同じような機能を提供します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールでは、コントロールをグリッド レイアウトに配置でき、個々のコントロールの位置を正確に指定する必要がありません。  このレイアウト パネルのセルは行と列に配置され、それぞれ異なったサイズを設定できます。  セルは、行や列にまたがって結合できます。  セルには、フォームに配置できるすべての要素を格納できる他、ほとんどの点でコンテナーとして動作します。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、実行時に比例的なサイズ変更機能を提供するため、フォームのサイズ変更に合わせてレイアウトを滑らかに変更できます。  このため、<xref:System.Windows.Forms.TableLayoutPanel> コントロールは、データ入力フォームやアプリケーションのローカライズなどに適しています。  詳細については、「[Walkthrough: Creating a Resizable Windows Form for Data Entry](http://msdn.microsoft.com/ja-jp/e193b4fc-912a-4917-b036-b76c7a6f58ab)」および「[Walkthrough: Creating a Localizable Windows Form](http://msdn.microsoft.com/ja-jp/c5240b6e-aaca-4286-9bae-778a416edb9c)」を参照してください。  
+  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、通常はレイアウト全体のコンテナーとして使用しないでください。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、レイアウトの各部に比例的なサイズ変更機能を提供するために使用してください。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   行と列へのコントロールの配置  
+  
+-   行と列のプロパティの設定  
+  
+-   複数行および複数列へのコントロールの拡大  
+  
+-   オーバーフローの自動処理  
+  
+-   ツールボックスでのダブルクリックによるコントロールの挿入  
+  
+-   アウトラインの描画によるコントロールの挿入  
+  
+-   別の親コントロールへの既存コントロールの再割り当て  
+  
+ ここでは、これらの重要なレイアウト機能が果たす役割について理解します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  "TableLayoutPanelExample" という名前の Windows アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **Windows** **フォーム デザイナー**でフォームを選択します。  
+  
+## 行と列へのコントロールの配置  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用すると、行や列にコントロールを簡単に配置できます。  
+  
+#### TableLayoutPanel を使用して、コントロールを行や列に配置するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  既定では、<xref:System.Windows.Forms.TableLayoutPanel> コントロールには 4 つのセルがあります。  
+  
+2.  **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールにドラッグし、セルのいずれかにドロップします。  選択したセル内に <xref:System.Windows.Forms.Button> コントロールが作成されます。  
+  
+3.  さらに 3 つの <xref:System.Windows.Forms.Button> コントロールを、**ツールボックス**から <xref:System.Windows.Forms.TableLayoutPanel> コントロールにドラッグし、各セルにボタンを配置します。  
+  
+4.  2 つの列の間にある垂直方向のサイズ変更ハンドルをドラッグして左に移動します。  1 列目の <xref:System.Windows.Forms.Button> コントロールの幅が縮小しますが、2 列目の <xref:System.Windows.Forms.Button> コントロールのサイズは変更されません。  
+  
+5.  2 つの列の間にある垂直方向のサイズ変更ハンドルをドラッグして右に移動します。  1 列目の <xref:System.Windows.Forms.Button> コントロールが元のサイズに戻り、2 列目の <xref:System.Windows.Forms.Button> コントロールが右側に移動します。  
+  
+6.  水平方向のサイズ変更ハンドルを上下に移動し、パネル内のコントロールが受ける影響を確認します。  
+  
+## ドッキングおよび固定を使用した、セル内のコントロールの配置  
+ <xref:System.Windows.Forms.TableLayoutPanel> の子コントロールの固定動作は、他のコンテナー コントロールの場合と異なります。  子コントロールのドッキング動作は、他のコンテナー コントロールと同じです。  
+  
+#### セル内のコントロールの配置  
+  
+1.  最初の <xref:System.Windows.Forms.Button> コントロールを選択します。  <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。  <xref:System.Windows.Forms.Button> コントロールがセル全体に拡大します。  
+  
+2.  他の <xref:System.Windows.Forms.Button> コントロールのいずれかを選択します。  <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を <xref:System.Windows.Forms.AnchorStyles> に変更します。  コントロールが移動し、その右側の境界線がセルの右側の境界線に近づきます。  境界間の距離は、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティとパネルの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの合計値です。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティの値を <xref:System.Windows.Forms.AnchorStyles> および <xref:System.Windows.Forms.AnchorStyles> に変更します。  コントロールのサイズが、<xref:System.Windows.Forms.Control.Margin%2A> 値と <xref:System.Windows.Forms.Control.Padding%2A> 値を考慮して、セルの幅に変更されます。  
+  
+4.  <xref:System.Windows.Forms.AnchorStyles> スタイルと <xref:System.Windows.Forms.AnchorStyles> スタイルを使用して、手順 2. と手順 3. を繰り返します。  
+  
+## 行と列のプロパティの設定  
+ <xref:System.Windows.Forms.TableLayoutPanel.RowStyles%2A> コレクションと <xref:System.Windows.Forms.TableLayoutPanel.ColumnStyles%2A> コレクションを使用して、行と列のプロパティを個別に設定できます。  
+  
+#### 行と列のプロパティを設定するには  
+  
+1.  **Windows フォーム デザイナー**で <xref:System.Windows.Forms.TableLayoutPanel> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、**\[列\]** エントリの横にある省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして <xref:System.Windows.Forms.TableLayoutPanel.ColumnStyles%2A> コレクションを開きます。  
+  
+3.  最初の列を選択し、<xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティの値を <xref:System.Windows.Forms.SizeType> に変更します。  **\[OK\]** をクリックして変更を適用します。  最初の列の幅が、<xref:System.Windows.Forms.Button> コントロールに合わせて縮小されます。  また、列の幅が変更できなくなっていることも確認してください。  
+  
+4.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.TableLayoutPanel.ColumnStyles%2A> コレクションを開き、最初の列を選択します。  <xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティの値を <xref:System.Windows.Forms.SizeType> に変更します。  **\[OK\]** をクリックして変更を適用します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの幅を拡大すると、最初の列の幅が拡大します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの幅を縮小すると、最初の列のボタンのサイズがセルに合わせて変更されます。  また、列の幅が変更できることも確認してください。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.TableLayoutPanel.ColumnStyles%2A> コレクションを開き、表示されているすべての列を選択します。  すべての <xref:System.Windows.Forms.TableLayoutStyle.SizeType%2A> プロパティの値を <xref:System.Windows.Forms.SizeType> に設定します。  **\[OK\]** をクリックして変更を適用します。  <xref:System.Windows.Forms.TableLayoutPanel.RowStyles%2A> コレクションでも、この手順を繰り返します。  
+  
+6.  隅のサイズ変更ハンドルのいずれかをドラッグして、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの幅と高さを共に変更します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールのサイズの変化に応じて、行と列のサイズが変更されます。  また、行と列は、水平方向と垂直方向のサイズ変更ハンドルを使用してサイズを変更できることも確認してください。  
+  
+## 複数行および複数列へのコントロールの拡大  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、デザイン時にいくつかの新しいプロパティをコントロールに追加します。  これらのプロパティのうちの 2 つが `RowSpan` と `ColumnSpan` です。  これら 2 つのプロパティを使用すると、コントロールを複数の行または列に拡大できます。  
+  
+#### コントロールを複数の行と列に拡大するには  
+  
+1.  最初の列の最初の行にある <xref:System.Windows.Forms.Button> コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウで、`ColumnSpan` プロパティの値を 2 に変更します。  <xref:System.Windows.Forms.Button> コントロールが最初の列と 2 番目の列を占有します。  また、この変更に対応するために新しい行が追加されていることも確認してください。  
+  
+3.  `RowSpan` プロパティに対して手順 2. を繰り返します。  
+  
+## ツールボックスでのダブルクリックによるコントロールの挿入  
+ **ツールボックス**でコントロールをダブルクリックすることにより、そのコントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールに挿入できます。  
+  
+#### ツールボックスでダブルクリックしてコントロールを挿入するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをダブルクリックします。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの最初のセルに新しいボタン コントロールが表示されます。  
+  
+3.  **ツールボックス**でさらにいくつかのコントロールを ダブルクリックします。  新しいコントロールが <xref:System.Windows.Forms.TableLayoutPanel> コントロールの未使用のセルに順次表示されます。  また、空のセルがない場合は、新しいコントロールを格納するために <xref:System.Windows.Forms.TableLayoutPanel> コントロールが拡大します。  
+  
+## オーバーフローの自動処理  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールにコントロールを挿入していくと、新しいコントロールを挿入する空のセルがなくなることがあります。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールは、セルの数を増やすことによってこのような状況に自動的に対処します。  
+  
+#### オーバーフローの自動処理を観察するには  
+  
+1.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールに空のセルがある場合は、<xref:System.Windows.Forms.TableLayoutPanel> コントロールがいっぱいになるまで、新しい <xref:System.Windows.Forms.Button> コントロールを挿入していきます。  
+  
+2.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールがいっぱいになったら、**ツールボックス**の <xref:System.Windows.Forms.Button> アイコンをダブルクリックして、新しい <xref:System.Windows.Forms.Button> コントロールを挿入します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールでは、新しいコントロールを格納する新しいセルが作成されます。  コントロールをさらにいくつか挿入し、サイズ変更動作を確認します。  
+  
+3.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの <xref:System.Windows.Forms.TableLayoutPanel.GrowStyle%2A> プロパティの値を <xref:System.Windows.Forms.TableLayoutPanelGrowStyle> に変更します。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールがいっぱいになるまで、**ツールボックス**の <xref:System.Windows.Forms.Button> アイコンをダブルクリックして、<xref:System.Windows.Forms.Button> コントロールを挿入します。  **ツールボックス**の <xref:System.Windows.Forms.Button> アイコンを再度ダブルクリックします。  追加の行と列を作成できないというエラー メッセージが **Windows フォーム デザイナー**によって表示されます。  
+  
+## アウトラインの描画によるコントロールの挿入  
+ セルにコントロールのアウトラインを描画することによって、コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールに挿入し、サイズを指定できます。  
+  
+#### アウトラインを描画してコントロールを挿入するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをクリックします。  フォームにドラッグしないでください。  
+  
+3.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールにマウス ポインターを置きます。  ポインターが <xref:System.Windows.Forms.Button> コントロール アイコンが付いた十字カーソルに変わります。  
+  
+4.  マウス ボタンを押したままにします。  
+  
+5.  マウス ポインターをドラッグして、<xref:System.Windows.Forms.Button> コントロールのアウトラインを描画します。  適切なサイズのアウトラインを描画したら、マウス ボタンを離します。  コントロールのアウトラインを描画したセルに <xref:System.Windows.Forms.Button> コントロールが作成されます。  
+  
+## 1 つのセルに配置できるコントロールの数  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールでは、セルごとに 1 つの子コントロールしか配置できません。  
+  
+#### セルに複数のコントロールを配置できないことを確認するには  
+  
+-   **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールにドラッグし、割り当て済みのセルのいずれかにドロップします。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールでは、割り当て済みのセルに <xref:System.Windows.Forms.Button> コントロールをドロップできないことを確認してください。  
+  
+## コントロールの交換  
+ <xref:System.Windows.Forms.TableLayoutPanel> コントロールでは、2 つの別個のセルに割り当てられているコントロールを交換できます。  
+  
+#### コントロールを交換するには  
+  
+-   割り当て済みのセルからいずれかの <xref:System.Windows.Forms.Button> コントロールをドラッグし、別の割り当て済みセルにドロップします。  2 つのコントロールがそれぞれ他方のセルに移動します。  
+  
+## 次の手順  
+ レイアウト パネルとコントロールを組み合わせて使用すると、複雑なレイアウトを作成できます。  次に行う作業の例を示します。  
+  
+-   いずれかの <xref:System.Windows.Forms.Button> コントロールのサイズを変更して、レイアウトの変化を確認します。  
+  
+-   選択した複数のコントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールに貼り付け、それらがどのように挿入されるかを確認します。  
+  
+-   レイアウト パネルには、別のレイアウト パネルを含めることができます。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールを既存のコントロールにドロップしてみます。  
+  
+-   <xref:System.Windows.Forms.TableLayoutPanel> コントロールを親フォームにドッキングします。  フォームのサイズを変更し、レイアウトの変化を確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FlowLayoutPanel>   
+ <xref:System.Windows.Forms.TableLayoutPanel>   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)   
+ [Microsoft Windows User Experience, Official Guidelines for User Interface Developers and Designers Redmond, WA: Microsoft Press, 1999. \(USBN: 0\-7356\-0566\-1\)](http://www.microsoft.com/mspress/southpacific/books/book11588.htm)   
+ [Walkthrough: Creating a Resizable Windows Form for Data Entry](http://msdn.microsoft.com/ja-jp/e193b4fc-912a-4917-b036-b76c7a6f58ab)   
+ [Walkthrough: Creating a Localizable Windows Form](http://msdn.microsoft.com/ja-jp/c5240b6e-aaca-4286-9bae-778a416edb9c)   
+ [TableLayoutPanel コントロールの推奨される手順](../../../../docs/framework/winforms/controls/best-practices-for-the-tablelayoutpanel-control.md)   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)   
+ [方法 : Windows フォーム上のコントロールをドッキングする](../../../../docs/framework/winforms/controls/how-to-dock-controls-on-windows-forms.md)   
+ [方法 : Windows フォームにコントロールを固定する](../../../../docs/framework/winforms/controls/how-to-anchor-controls-on-windows-forms.md)   
+ [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md
new file mode 100644
index 00000000000..2baccb6c1e5
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md
@@ -0,0 +1,256 @@
+---
+title: "チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 配置 (スナップ線を使用した)"
+  - "SnapLine クラス, チュートリアル"
+  - "スナップ線, 配置 (Windows フォーム コントロールを)"
+  - "Windows フォーム コントロール, 配置"
+ms.assetid: d5c9edc7-cf30-4a97-8ebe-201d569340f8
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置
+フォーム上にコントロールを正確に配置することは、多くのアプリケーションで重要度の高い処理です。  Windows フォーム デザイナーには、そのためのさまざまなレイアウト ツールが用意されています。  その中で最も重要なツールの 1 つが <xref:System.Windows.Forms.Design.Behavior.SnapLine> 機能です。  
+  
+ スナップ線は、コントロールを他のコントロールと整列させる位置を正確に示します。  また、Windows ユーザー インターフェイスのガイドラインで指定されている、コントロール間のマージンの推奨距離も示します。  詳細については、「[User Interface Design and Development \(ユーザー インターフェイスのデザインと開発\)](http://go.microsoft.com/FWLink/?LinkId=83878)」を参照してください。  
+  
+ スナップ線を使用すると、簡単にコントロールを整列させることができ、鮮明でプロフェッショナルな外観と動作を実現できます。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   スナップ線を使用したコントロールのスペーシングと配置  
+  
+-   フォームまたはコンテナーのマージンを使用した整列  
+  
+-   グループ化されたコントロールとの整列  
+  
+-   スナップ線を使用した、サイズのアウトラインによるコントロールの配置  
+  
+-   ツールボックスからコントロールをドラッグするときのスナップ線の使用  
+  
+-   スナップ線を使用したコントロールのサイズ変更  
+  
+-   コントロールのテキストとラベルの整列  
+  
+-   キーボードによる移動時のスナップ線の使用  
+  
+-   スナップ線とレイアウト パネル  
+  
+-   スナップ線の無効化  
+  
+ ここでは、スナップ線機能がレイアウトに果たす役割について理解します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  "SnaplineExample" という名前の Windows ベース アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  フォーム デザイナーでフォームを選択します。  
+  
+## スナップ線を使用したコントロールのスペーシングと配置  
+ スナップ線を使用すると、正確かつ直観的にコントロールをフォームに配置できます。  スナップ線は、選択した単数または複数のコントロールを、他のコントロールやコントロール セットと整列する位置の近くに移動すると表示されます。  選択したコントロールが他のコントロールを通過するとき、推奨位置に "スナップ" します。  
+  
+#### スナップ線を使用してコントロールを配置するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールをフォームの右下隅に移動します。  <xref:System.Windows.Forms.Button> コントロールがフォームの下側と右側の境界線に近づくと、スナップ線が表示されます。  これらのスナップ線は、コントロールの境界線からフォームの境界線までの推奨距離を表します。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールをフォームの境界線付近であちこちに移動し、スナップ線がどこで表示されるかを確認します。  この操作を終えたら、<xref:System.Windows.Forms.Button> コントロールをフォームの中心付近に移動します。  
+  
+4.  **ツールボックス**から別の <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグします。  
+  
+5.  この 2 つ目の <xref:System.Windows.Forms.Button> コントロールが、最初のコントロールとほぼ水平の位置関係になるように移動します。  両方のボタンのテキスト ベースラインにスナップ線が表示され、移動中のコントロールが、最初のコントロールの真横にスナップします。  
+  
+6.  2 つ目の <xref:System.Windows.Forms.Button> コントロールを最初のコントロールのすぐ上に移動します。  両方のボタンの左端と右端に沿ってスナップ線が表示され、移動中のコントロールが、最初のコントロールの真上にスナップします。  
+  
+7.  <xref:System.Windows.Forms.Button> コントロールのどちらかを選択し、もう 1 つのコントロールにほぼ接触するまで近づけます。  両方のコントロールの間にスナップ線が表示されます。  この距離が、これらのコントロールの境界間の推奨距離になります。  また、移動中のコントロールがこの位置にスナップすることも確認してください。  
+  
+8.  **ツールボックス**から 2 つの <xref:System.Windows.Forms.Panel> コントロールをフォームにドラッグします。  
+  
+9. 1 つの <xref:System.Windows.Forms.Panel> コントロールを、もう 1 つのコントロールとほぼ水平の位置関係になるように移動します。  両方のコントロールの上端と下端に沿ってスナップ線が表示され、移動中のコントロールが、もう 1 つのコントロールの真横にスナップします。  
+  
+## フォームまたはコンテナーのマージンを使用した整列  
+ スナップ線を使用すると、一貫した方法でフォームやコンテナーのマージンを使用してコントロールを整列させることができます。  
+  
+#### フォームやコンテナーのマージンを使用してコントロールを整列させるには  
+  
+1.  <xref:System.Windows.Forms.Button> コントロールを 1 つ選択し、スナップ線が表示されるまで、フォームの右側の境界線に近づけます。  右側の境界線とスナップ線の距離は、コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティ値とフォームの <xref:System.Windows.Forms.Control.Padding%2A> プロパティ値の合計です。  
+  
+> [!NOTE]
+>  フォームの <xref:System.Windows.Forms.Control.Padding%2A> プロパティを 0,0,0,0 に設定すると、Windows フォーム デザイナーでは、フォームの <xref:System.Windows.Forms.Control.Padding%2A> 値が暗黙的に 9,9,9,9 として解釈されます。  この動作をオーバーライドするには、0,0,0,0 以外の値を割り当てます。  
+  
+1.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティの値を変更します。これを行うには、**\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Margin%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 0 に設定します。  詳細については、「[チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)」を参照してください。  
+  
+2.  スナップ線が表示されるまで、<xref:System.Windows.Forms.Button> コントロールをフォームの右側の境界線に近づけます。  この距離は、フォームの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの値によって決まります。  
+  
+3.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.GroupBox> コントロールをドラッグします。  
+  
+4.  <xref:System.Windows.Forms.GroupBox> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの値を変更します。これを行うには、**\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Padding%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 10 に設定します。  
+  
+5.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.GroupBox> コントロールにドラッグします。  
+  
+6.  スナップ線が表示されるまで、<xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.GroupBox> コントロールの右側の境界線に近づけます。  <xref:System.Windows.Forms.GroupBox> コントロール内で <xref:System.Windows.Forms.Button> を移動し、スナップ線がどこで表示されるかを確認します。  
+  
+## グループ化されたコントロールとの整列  
+ スナップ線を使用すると、<xref:System.Windows.Forms.GroupBox> コントロール内の コントロールだけでなく、グループ化されたコントロールも整列させることができます。  
+  
+#### グループ化されたコントロールと整列させるには  
+  
+1.  フォーム上のコントロールを 2 つ選択します。  選択したコントロールをあちこちに移動し、選択したコントロールと他のコントロールの間に表示されるスナップ線を確認します。  
+  
+2.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.GroupBox> コントロールをドラッグします。  
+  
+3.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.GroupBox> コントロールにドラッグします。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの 1 つを選択し、<xref:System.Windows.Forms.GroupBox> コントロールの周囲であちこちに移動します。  <xref:System.Windows.Forms.GroupBox> コントロールの各端にスナップ線が表示されます。  また、<xref:System.Windows.Forms.GroupBox> コントロールに含まれている <xref:System.Windows.Forms.Button> コントロールの各端にもスナップ線が表示されます。  コンテナー コントロール内の子コントロールもスナップ線をサポートします。  
+  
+## スナップ線を使用した、サイズのアウトラインによるコントロールの配置  
+ スナップ線を使用すると、コントロールを初めてフォームに配置する際に簡単に整列させることができます。  
+  
+#### スナップ線を使用し、サイズのアウトラインを描いてコントロールを配置するには  
+  
+1.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをクリックします。  フォームにドラッグしないでください。  
+  
+2.  マウス ポインターをフォームのデザイン サーフェイスに置きます。  ポインターが <xref:System.Windows.Forms.Button> コントロール アイコンが付いた十字カーソルに変わります。  また、<xref:System.Windows.Forms.Button> コントロールの推奨整列位置を示すスナップ線も表示されます。  
+  
+3.  マウス ボタンを押したままにします。  
+  
+4.  マウス ポインターをフォーム上でドラッグします。  コントロールの位置とサイズを示すアウトラインが描画されます。  
+  
+5.  フォーム上の別のコントロールに整列する位置までポインターをドラッグします。  スナップ線が表示され、整列を示します。  
+  
+6.  マウスのボタンを離します。  アウトラインで示された位置とサイズでコントロールが作成されます。  
+  
+## ツールボックスからコントロールをドラッグするときのスナップ線の使用  
+ スナップ線を使用すると、**ツールボックス**からフォームにドラッグしたコントロールを簡単に整列させることができます。  
+  
+#### ツールボックスからコントロールをドラッグするときにスナップ線を使用するには  
+  
+1.  **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグし、マウス ボタンを押したままにします。  
+  
+2.  マウス ポインターをフォームのデザイン サーフェイスに置きます。  ポインターの形が変わり、新しい <xref:System.Windows.Forms.Button> コントロールが作成される位置を示します。  
+  
+3.  マウス ポインターをフォーム上でドラッグします。  <xref:System.Windows.Forms.Button> コントロールの推奨整列位置を示すスナップ線が表示されます。  他のコントロールと整列する位置を見つけます。  
+  
+4.  マウスのボタンを離します。  スナップ線で示された位置にコントロールが作成されます。  
+  
+## スナップ線を使用したコントロールのサイズ変更  
+ スナップ線を使用すると、コントロールのサイズを変更したときに簡単に整列させることができます。  
+  
+#### スナップ線を使用してコントロールのサイズを変更するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールの隅にあるサイズ変更ハンドルのいずれかをドラッグして、コントロールのサイズを変更します。  詳細については、「[方法 : Windows フォーム上のコントロールのサイズを変更する](../../../../docs/framework/winforms/controls/how-to-resize-controls-on-windows-forms.md)」を参照してください。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの境界線のいずれかが他のコントロールと整列するまでサイズ変更ハンドルをドラッグします。  スナップ線が表示されるのを確認します。  また、サイズ変更ハンドルがスナップ線で示された位置にスナップすることも確認します。  
+  
+4.  さまざまな方向に <xref:System.Windows.Forms.Button> コントロールのサイズを変更し、サイズ変更ハンドルを別のコントロールに整列させます。  スナップ線がさまざまな方向に表示されて、整列を示すことを確認してください。  
+  
+## コントロールのテキストとラベルの整列  
+ 一部のコントロールでは、スナップ線を利用して、他のコントロールを表示テキストに合わせて整列させることができます。  
+  
+#### ラベルとコントロールのテキストを整列させるには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TextBox> コントロールをドラッグします。  <xref:System.Windows.Forms.TextBox> コントロールをフォームにドロップしたら、スマート タグ グリフをクリックし、**\[textBox1 にテキストを設定\]** をクリックします。  詳細については、「[チュートリアル : Windows フォーム コントロールのスマート タグを使用した共通タスクの実行](../../../../docs/framework/winforms/controls/performing-common-tasks-using-smart-tags-on-wf-controls.md)」を参照してください。  
+  
+2.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Label> コントロールをドラッグします。  
+  
+3.  <xref:System.Windows.Forms.Label> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に変更します。  コントロールの境界線が表示テキストに合わせて調整されます。  
+  
+4.  <xref:System.Windows.Forms.Label> コントロールを <xref:System.Windows.Forms.TextBox> コントロールの左に移動し、<xref:System.Windows.Forms.TextBox> コントロールの下端に合わせて配置します。  2 つのコントロールの下端に沿ってスナップ線が表示されます。  
+  
+5.  <xref:System.Windows.Forms.Label> のテキストと <xref:System.Windows.Forms.TextBox> のテキストが整列するまで、<xref:System.Windows.Forms.Label> コントロールをわずかに上に移動します。  両方のコントロールのテキスト フィールドが整列すると、スタイルの異なるスナップ線が表示されます。  
+  
+## キーボードによる移動時のスナップ線の使用  
+ スナップ線を使用すると、キーボードの方向キーを使用してコントロールを配置するときに、コントロールを簡単に整列させることができます。  
+  
+#### キーボードによる移動時にスナップ線を使用するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  このコントロールをフォームの左上隅に配置します。  
+  
+2.  Ctrl キーを押しながら↓キーを押します。  コントロールがフォーム内で下に移動し、使用できる最初の整列位置に置かれます。  
+  
+3.  コントロールがフォームの下端に到達するまで、Ctrl キーを押しながら↓キーを押し続けます。  コントロールがフォーム内を下に移動するときに占有する位置を確認します。  
+  
+4.  Ctrl キーを押しながら→キーを押します。  コントロールがフォーム上で右に移動し、使用できる最初の整列位置に置かれます。  
+  
+5.  コントロールがフォームの右端に到達するまで、Ctrl キーを押しながら→キーを押し続けます。  コントロールがフォーム内を右に移動するときに占有する位置を確認します。  
+  
+6.  方向キーを組み合わせて使用してコントロールをフォーム上で移動します。  コントロールが占有する位置と表示されるスナップ線を確認します。  
+  
+7.  Shift キーを押しながら任意の方向キーを押して、<xref:System.Windows.Forms.Button> コントロールのサイズを 1 ピクセルずつ変更します。  
+  
+8.  Ctrl キーと Shift キーを押しながら任意の方向キーを押して、<xref:System.Windows.Forms.Button> コントロールのサイズをスナップ線のインクリメントで変更します。  
+  
+## スナップ線とレイアウト パネル  
+ スナップ線はレイアウト パネル内で無効にできます。  
+  
+#### スナップ線を選択的に無効にするには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.TableLayoutPanel> コントロールをドラッグします。  
+  
+2.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをダブルクリックします。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの最初のセルに新しいボタン コントロールが表示されます。  
+  
+3.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロール アイコンをさらに 2 回ダブルクリックします。  これで、<xref:System.Windows.Forms.TableLayoutPanel> コントロール内の空のセルは 1 つになります。  
+  
+4.  **ツールボックス**から <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.TableLayoutPanel> コントロールの空のセルにドラッグします。  スナップ線が表示されないことを確認します。  
+  
+5.  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの外に <xref:System.Windows.Forms.Button> コントロールをドラッグし、<xref:System.Windows.Forms.TableLayoutPanel> コントロールの周囲を移動します。  スナップ線が再び表示されるのを確認します。  
+  
+## スナップ線の無効化  
+ スナップ線は既定で有効です。  スナップ線は選択的に無効にすることも、デザイン環境で無効にすることもできます。  
+  
+#### スナップ線を選択的に無効にするには  
+  
+-   Alt キーを押しながらコントロールをフォーム上で移動します。  
+  
+     スナップ線が表示されず、コントロールが整列位置にスナップしないことを確認します。  
+  
+#### スナップ線をデザイン環境で無効にするには  
+  
+1.  **\[ツール\]** メニューから **\[オプション\]** ダイアログ ボックスを開きます。  \[Windows フォーム デザイナー\] ダイアログ ボックスを開きます。  詳細については、「[General, Windows Forms Designer, Options Dialog Box](http://msdn.microsoft.com/ja-jp/8dd170af-72f0-4212-b04b-034ceee92834)」を参照してください。  
+  
+2.  **\[全般\]** ノードを選択します。  **\[Layout Mode\]** セクションの選択項目を **\[SnapLines\]** から **\[SnapToGrid\]** に変更します。  
+  
+3.  \[OK\] をクリックして設定を適用します。  
+  
+4.  フォームでコントロールを選択し、他のコントロールの周囲で移動します。  スナップ線が表示されないことを確認します。  
+  
+## 次の手順  
+ スナップ線を使用すると、フォーム上でコントロールを直観的に整列させることができます。  次に行う作業の例を示します。  
+  
+-   <xref:System.Windows.Forms.GroupBox> コントロールに別の <xref:System.Windows.Forms.GroupBox> コントロールを入れ子にしてみます。  <xref:System.Windows.Forms.Button> コントロールを子 <xref:System.Windows.Forms.GroupBox> コントロールの中に配置し、別の Button コントロールを親 <xref:System.Windows.Forms.GroupBox> コントロールの中に配置します。  <xref:System.Windows.Forms.Button> コントロールをあちこちに移動して、スナップ線がコンテナーの境界線とどのように交差するかを確認します。  
+  
+-   <xref:System.Windows.Forms.TextBox> コントロールの列と、これに対応する <xref:System.Windows.Forms.Label> コントロールの列を作成します。  <xref:System.Windows.Forms.Label> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に設定します。  <xref:System.Windows.Forms.Label> コントロールの表示テキストと <xref:System.Windows.Forms.TextBox> コントロールのテキストが整列するように、スナップ線を使用して Label コントロールを移動します。  
+  
+ Windows ユーザー インターフェイスのデザインについては、書籍『*Microsoft Windows User Experience, Official Guidelines for User Interface Developers and Designers*』\(Redmond, WA: Microsoft Press, 1999.   \(USBN: 0\-7356\-0566\-1\)\) を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Design.Behavior.SnapLine>   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト](../../../../docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md)   
+ [Windows フォームでのコントロールの配置](../../../../docs/framework/winforms/controls/arranging-controls-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md b/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md
new file mode 100644
index 00000000000..80695bfc292
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md
@@ -0,0 +1,426 @@
+---
+title: "チュートリアル : Visual Basic による複合コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "複合コントロール, 作成"
+  - "コントロール [Windows フォーム], 複合コントロール"
+  - "カスタム コントロール [Visual Basic]"
+  - "カスタム コントロール [Windows フォーム], 作成"
+  - "ユーザー コントロール [Visual Basic]"
+  - "ユーザー コントロール [Windows フォーム], 作成 (Visual Basic を使用した)"
+  - "UserControl クラス, チュートリアル"
+ms.assetid: f50e270e-4db2-409a-8319-6db6ca5c7daf
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# チュートリアル : Visual Basic による複合コントロールの作成
+複合コントロールは、カスタム グラフィカル インターフェイスの作成と再利用のための手段を提供します。  複合コントロールは、基本的には表示できる形式を持つコンポーネントです。  そのため、ユーザー コントロールは、1 つ以上の Windows フォーム コントロール、コンポーネント、またはコードのブロックから構成でき、ユーザー入力を検査したり、表示プロパティを変更したり、作成者によって要求されるその他のタスクを実行したりすることで機能を拡張できます。  複合コントロールは、他のコントロールと同じ方法で Windows フォームに配置できます。  このチュートリアルの前半では、`ctlClock` という名前の単純な複合コントロールを作成します。  後半では、継承によって `ctlClock` の機能を拡張します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 新しいプロジェクトを作成するときには、その名前を指定することにより、ルート名前空間、アセンブリ名、およびプロジェクト名を設定し、既定のコンポーネントが正しい名前空間に含まれるようにします。  
+  
+#### ctlClockLib コントロール ライブラリおよび ctlClock コントロールを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックして **\[新しいプロジェクト\]** ダイアログ ボックスを表示します。  
+  
+2.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] プロジェクトの一覧の **\[Windows コントロール ライブラリ\]** プロジェクト テンプレートをクリックし、**\[プロジェクト名\]** ボックスに「`ctlClockLib`」と入力して、**\[OK\]** をクリックします。  
+  
+     プロジェクト名 `ctlClockLib` は、既定でルート名前空間にも割り当てられます。  ルート名前空間は、アセンブリ内のコンポーネント名の修飾に使用されます。  たとえば、`ctlClock` という名前のコンポーネントが 2 つのアセンブリに含まれる場合は、`ctlClockLib.ctlClock` という形で目的の `ctlClock` コンポーネントを指定できます。  
+  
+3.  ソリューション エクスプローラーで、**UserControl1.vb** を右クリックし、**\[名前の変更\]** をクリックします。  ファイル名を「`ctlClock.vb`」に変更します。  コード要素 "UserControl1" へのすべての参照の名前を変更するかどうかを確認するダイアログ ボックスが表示されたら、**\[はい\]** をクリックします。  
+  
+    > [!NOTE]
+    >  既定では、複合コントロールはシステムによって提供される <xref:System.Windows.Forms.UserControl> クラスを継承します。  <xref:System.Windows.Forms.UserControl> クラスは、すべての複合コントロールに必要な機能を提供し、標準のメソッドおよびプロパティを実装します。  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## 複合コントロールへの Windows コントロールおよびコンポーネントの追加  
+ ビジュアル インターフェイスは、複合コントロールの基本的な部分です。  このビジュアル インターフェイスは、デザイナー画面に 1 つ以上の Windows コントロールを追加することによって実装されます。  次の例では、複合コントロールに Windows コントロールを取り込んで、機能を実装するコードを記述します。  
+  
+#### 複合コントロールに Label と Timer を追加するには  
+  
+1.  ソリューション エクスプローラーで **ctlClock.vb** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+2.  ツールボックスの **\[コモン コントロール\]** ノードを展開し、**\[Label\]** をダブルクリックします。  
+  
+     `Label1` という名前の <xref:System.Windows.Forms.Label> がデザイナー画面のコントロールに追加されます。  
+  
+3.  デザイナーで **Label1** をクリックします。  プロパティ ウィンドウで、次のプロパティを設定します。  
+  
+    |プロパティ|変更後の値|  
+    |-----------|-----------|  
+    |**名前**|`lblDisplay`|  
+    |**テキスト**|`(空白)`|  
+    |**TextAlign**|`MiddleCenter`|  
+    |**Font.Size**|`14`|  
+  
+4.  **ツールボックス**の **\[コンポーネント\]** ノードを展開し、**\[Timer\]** をダブルクリックします。  
+  
+     <xref:System.Windows.Forms.Timer> はコンポーネントであるため、実行時には表示できる形式を持ちません。  このため、デザイナー画面にはコントロールと共には表示されず、コンポーネント デザイナー \(デザイナー画面の下部にあるトレイ\) に表示されます。  
+  
+5.  コンポーネント デザイナーで、**\[Timer1\]** をクリックし、<xref:System.Windows.Forms.Timer.Interval%2A> プロパティを `1000`、<xref:System.Windows.Forms.Timer.Enabled%2A> プロパティを `True` に設定します。  
+  
+     <xref:System.Windows.Forms.Timer.Interval%2A> プロパティは、タイマー コンポーネントが時を刻む頻度を制御します。  `Timer1` が時を刻むたびに、`Timer1_Tick` イベントのコードが実行されます。  このプロパティは、タイマーが何ミリ秒ごとに時を刻むかを表しています。  
+  
+6.  コンポーネント デザイナーで、**\[Timer1\]** をダブルクリックして、`ctlClock` の `Timer1_Tick` イベントに移動します。  
+  
+7.  コードを次のコード サンプルのように変更します。  アクセス修飾子を必ず `Private` から `Protected` に変更してください。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Protected Sub Timer1_Tick(ByVal sender As Object, ByVal e As _  
+        System.EventArgs) Handles Timer1.Tick  
+        ' Causes the label to display the current time.    
+        lblDisplay.Text = Format(Now, "hh:mm:ss")  
+    End Sub  
+    ```  
+  
+     このコードは、現在の時刻を `lblDisplay` に表示します。  `Timer1` の間隔は 1000 に設定されているため、このイベントは `1000` ミリ秒ごとに発生します。したがって、現在の時刻は 1 秒ごとに更新されます。  
+  
+8.  メソッドをオーバーライドできるように変更します。  詳細については、後の「ユーザー コントロールからの継承」を参照してください。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Protected Overridable Sub Timer1_Tick(ByVal sender As Object, ByVal _  
+        e As System.EventArgs) Handles Timer1.Tick  
+    ```  
+  
+9. **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## 複合コントロールへのプロパティの追加  
+ 現在、クロック コントロールは、それぞれが固有のプロパティ セットを持つ <xref:System.Windows.Forms.Label> コントロールと <xref:System.Windows.Forms.Timer> コンポーネントをカプセル化しています。  各コントロールのプロパティは、コントロールの後続のユーザーからはアクセスできませんが、適切なコード ブロックを作成することによってカスタム プロパティを作成および公開できます。  次の手順では、ユーザーが背景とテキストの色を変更できるようにするプロパティをコントロールに追加します。  
+  
+#### 複合コントロールにプロパティを追加するには  
+  
+1.  ソリューション エクスプローラーで **ctlClock.vb** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+     コントロールのコード エディターが表示されます。  
+  
+2.  `Public Class ctlClock` ステートメントを探します。  この行の直後に、次のコードを追加します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private colFColor as Color  
+    Private colBColor as Color  
+    ```  
+  
+     これらのステートメントは、作成するプロパティの値を格納するために使用するプライベート変数を作成します。  
+  
+3.  手順 2. の変数宣言の下に次のコードを挿入します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    ' Declares the name and type of the property.  
+    Property ClockBackColor() as Color  
+        ' Retrieves the value of the private variable colBColor.  
+        Get  
+            Return colBColor  
+        End Get  
+        ' Stores the selected value in the private variable colBColor, and   
+        ' updates the background color of the label control lblDisplay.  
+        Set(ByVal value as Color)  
+            colBColor = value  
+            lblDisplay.BackColor = colBColor     
+        End Set  
+  
+    End Property  
+    ' Provides a similar set of instructions for the foreground color.  
+    Property ClockForeColor() as Color  
+        Get  
+            Return colFColor  
+        End Get  
+        Set(ByVal value as Color)  
+            colFColor = value  
+            lblDisplay.ForeColor = colFColor  
+        End Set  
+    End Property  
+    ```  
+  
+     上記のコードは、`Property` ステートメントを呼び出すことにより、このコントロールを今後使用するユーザーが `ClockForeColor` および `ClockBackColor` という 2 つのカスタム プロパティを使用できるようにします。  `Get` ステートメントと `Set` ステートメントは、プロパティに適切な機能を実装するコードと共に、プロパティ値の格納と取得の機能を提供します。  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## コントロールのテスト  
+ コントロールはスタンドアロン プロジェクトではないため、コンテナーでホストする必要があります。  コントロールの実行時の動作をテストし、**ユーザー コントロール テスト コンテナー**でそのプロパティを実行します。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+#### コントロールをテストするには  
+  
+1.  F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  
+  
+2.  テスト コンテナーのプロパティ グリッドで、`ClockBackColor` プロパティを選択し、ドロップダウン矢印をクリックしてカラー パレットを表示します。  
+  
+3.  任意の色をクリックして選択します。  
+  
+     コントロールの背景色が、選択した色に変更されます。  
+  
+4.  同様なイベントのシーケンスを使用して、`ClockForeColor` プロパティが予想どおりに機能することを確認します。  
+  
+5.  **\[閉じる\]** をクリックして **\[ユーザー コントロール テスト コンテナー\]** を閉じます。  
+  
+     このセクションと前のセクションでは、コンポーネントと Windows コントロールをコードと結合し、複合コントロールの形式にパッケージ化してカスタム機能を提供する方法を説明しました。  複合コントロールのプロパティを公開し、完了後にコントロールをテストする方法を学びました。  次のセクションでは、`ctlClock` をベースとして継承した複合コントロールを構築する方法を学びます。  
+  
+## 複合コントロールからの継承  
+ 前のセクションでは、再利用可能な複合コントロールに Windows コントロール、コンポーネント、およびコードを組み込む方法を学びました。  この複合コントロールをベースにして、他のコントロールを作成できます。  基本クラスからクラスを派生するプロセスは*継承*と呼ばれます。  このセクションでは、`ctlAlarmClock` という名前の複合コントロールを作成します。  このコントロールは、親コントロールである `ctlClock` から派生します。  ここでは、親のメソッドをオーバーライドし、新しいメソッドおよびプロパティを追加することにより、`ctlClock` の機能を拡張する方法を学びます。  
+  
+ 継承コントロールの作成の最初の手順は、親コントロールからの派生です。  これにより、親コントロールのプロパティ、メソッド、およびグラフィカル特性をすべて持つ新しいコントロールが作成されます。このコントロールに基づいて、新しい機能を追加したり機能を変更したりできます。  
+  
+#### 継承コントロールを作成するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlClockLib\]** を右クリックします。**\[追加\]** をポイントし、**\[ユーザー コントロール\]** をクリックします。  
+  
+     **\[新しい項目の追加\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[継承されたユーザー コントロール\]** テンプレートを選択します。  
+  
+3.  **\[ファイル名\]** ボックスに「`ctlAlarmClock.vb`」と入力し、**\[追加\]** をクリックします。  
+  
+     **\[継承ピッカー\]** ダイアログ ボックスが表示されます。  
+  
+4.  **\[コンポーネント名\]** の **\[ctlClock\]** をダブルクリックします。  
+  
+5.  ソリューション エクスプローラーで、現在のプロジェクトを最後まで参照します。  
+  
+    > [!NOTE]
+    >  現在のプロジェクトに **ctlAlarmClock.vb** という名前のファイルが追加されています。  
+  
+### アラーム プロパティの追加  
+ 複合コントロールにプロパティを追加する場合と同じ方法で、継承コントロールにプロパティを追加できます。  ここでは、プロパティ宣言の構文を使用してコントロールに 2 つのプロパティを追加します。`AlarmTime` プロパティは、アラームを鳴らす日付と時刻の値を格納します。`AlarmSet` プロパティは、アラームが設定されているかどうかを示します。  
+  
+##### 複合コントロールにプロパティを追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlAlarmClock\]** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `Public Class ctlAlarmClock` として表示されている ctlAlarmClock コントロールのクラス宣言を探します。  クラス宣言に次のコードを挿入します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private dteAlarmTime As Date  
+    Private blnAlarmSet As Boolean  
+    ' These properties will be declared as Public to allow future   
+    ' developers to access them.  
+    Public Property AlarmTime() As Date  
+        Get  
+            Return dteAlarmTime  
+        End Get  
+        Set(ByVal value as Date)  
+            dteAlarmTime = value  
+        End Set  
+    End Property  
+    Public Property AlarmSet() As Boolean  
+        Get  
+            Return blnAlarmSet  
+        End Get  
+        Set(ByVal value as Boolean)  
+            blnAlarmSet = value  
+        End Set  
+    End Property  
+    ```  
+  
+### コントロールのグラフィカル インターフェイスへの追加  
+ 継承したコントロールには、継承元のコントロールと同じビジュアル インターフェイスがあります。  継承コントロールには親コントロールと同じ内在コントロールがありますが、内在コントロールのプロパティは特に公開されない限り使用できません。  継承した複合コントロールのグラフィカル インターフェイスも、他の複合コントロールと同じように拡張できます。  引き続き、アラーム クロックのビジュアル インターフェイスに、アラームが鳴ったときに点滅するラベル コントロールを追加します。  
+  
+##### ラベル コントロールを追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlAlarmClock\]** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+     `ctlAlarmClock` のデザイナーがメイン ウィンドウに表示されます。  
+  
+2.  `lblDisplay` \(コントロールの表示部分\) をクリックし、\[プロパティ\] ウィンドウを表示します。  
+  
+    > [!NOTE]
+    >  すべてのプロパティが表示されていますが、淡色表示になっています。  つまり、これらのプロパティは `lblDisplay` に対してネイティブであり、\[プロパティ\] ウィンドウでは変更もアクセスもできません。  既定では、複合コントロールに含まれているコントロールは `Private` であり、どのような方法によってもプロパティにアクセスできません。  
+  
+    > [!NOTE]
+    >  今後複合コントロールを使用するユーザーがその内部のコントロールにアクセスできるようにするには、内部のコントロールを `Public` または `Protected` として宣言します。  これにより、適切なコードを使用して、複合コントロールに含まれるコントロールのプロパティを設定したり変更したりできるようになります。  
+  
+3.  複合コントロールに <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+4.  マウスを使用して、<xref:System.Windows.Forms.Label> コントロールを表示ボックスのすぐ下にドラッグします。  プロパティ ウィンドウで、次のプロパティを設定します。  
+  
+    |プロパティ|設定|  
+    |-----------|--------|  
+    |**名前**|`lblAlarm`|  
+    |**テキスト**|Alarm\!|  
+    |**TextAlign**|`MiddleCenter`|  
+    |**Visible**|`False`|  
+  
+### アラーム機能の追加  
+ 前の手順では、複合コントロールでアラーム機能を有効にするためのプロパティおよびコントロールを追加しました。  この手順では、現在の時刻をアラーム設定時刻と比較して、一致した場合にはアラームを鳴らしてラベルを点滅させるコードを追加します。  `ctlClock` の `Timer1_Tick` メソッドをオーバーライドしてコードを追加することにより、`ctlClock` の固有の機能をすべて保持しながら `ctlAlarmClock` の機能を拡張できます。  
+  
+##### ctlClock の Timer1\_Tick メソッドをオーバーライドするには  
+  
+1.  ソリューション エクスプローラーで **ctlAlarmClock.vb** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `Private blnAlarmSet As Boolean` ステートメントを探します。  このステートメントの直後に、次のステートメントを追加します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Dim blnColorTicker as Boolean  
+    ```  
+  
+3.  ページの下部にある `End Class` ステートメントを探します。  `End Class` ステートメントの直前に、次のコードを追加します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Protected Overrides Sub Timer1_Tick(ByVal sender As Object, ByVal e _  
+        As System.EventArgs)  
+        ' Calls the Timer1_Tick method of ctlClock.  
+        MyBase.Timer1_Tick(sender, e)  
+        ' Checks to see if the Alarm is set.  
+        If AlarmSet = False Then  
+            Exit Sub  
+        End If  
+        ' If the date, hour, and minute of the alarm time are the same as  
+        ' now, flash and beep an alarm.   
+        If AlarmTime.Date = Now.Date And AlarmTime.Hour = Now.Hour And _  
+            AlarmTime.Minute = Now.Minute Then  
+            ' Sounds an audible beep.  
+            Beep()  
+            ' Sets lblAlarmVisible to True, and changes the background color based on the   
+            ' value of blnColorTicker. The background color of the label will   
+            ' flash once per tick of the clock.  
+            lblAlarm.Visible = True  
+            If blnColorTicker = False Then  
+                lblAlarm.BackColor = Color.PeachPuff  
+                blnColorTicker = True  
+            Else  
+                lblAlarm.BackColor = Color.Plum  
+                blnColorTicker = False  
+            End If  
+        Else  
+            ' Once the alarm has sounded for a minute, the label is made   
+            ' invisible again.  
+            lblAlarm.Visible = False  
+        End If  
+    End Sub  
+    ```  
+  
+     このコードを追加することで、いくつかのタスクが実行されます。  `Overrides` ステートメントは、基本コントロールから継承されたメソッドの代わりに、このメソッドを使用するようにコントロールに指示します。  このメソッドが呼び出されると、メソッドは `MyBase.Timer1_Tick` ステートメントを呼び出すことにより、オーバーライドするメソッドを呼び出します。その結果、元のコントロールに含まれるすべての機能がこのコントロールに継承されます。  メソッドは次に追加のコードを実行してアラーム機能を組み込みます。  アラームが発生すると、点滅するラベル コントロールが表示され、ビープ音が聞こえます。  
+  
+    > [!NOTE]
+    >  オーバーライドしているのは継承したイベント ハンドラーであるため、`Handles` キーワードでイベントを指定する必要はありません。  イベントは既にフックされています。  オーバーライドしているのはハンドラーの実装です。  
+  
+     これで、アラーム付き時計はほぼ完成です。  後は、アラームを止める手段を実装するだけです。  これを行うには、`lblAlarm_Click` メソッドにコードを追加します。  
+  
+##### アラームを止める手段を実装するには  
+  
+1.  ソリューション エクスプローラーで **ctlAlarmClock.vb** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+2.  デザイナーで **lblAlarm** をダブルクリックします。  **コード エディター**が開き、`Private Sub lblAlarm_Click` 行が表示されます。  
+  
+3.  このメソッドを次のコードのように変更します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub lblAlarm_Click(ByVal sender As Object, ByVal e As _  
+     System.EventArgs) Handles lblAlarm.Click  
+        ' Turns off the alarm.  
+        AlarmSet = False  
+        ' Hides the flashing label.  
+        lblAlarm.Visible = False  
+    End Sub  
+    ```  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+### フォームでの継承コントロールの使用  
+ 継承コントロールは、基本クラスである `ctlClock` のテストと同様の方法でテストできます。F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+ コントロールを使用できるようにするには、フォーム上でコントロールをホストする必要があります。  標準複合コントロールと同様に、継承複合コントロールはスタンドアロン型ではないため、フォームまたは他のコンテナーでホストする必要があります。  `ctlAlarmClock` は機能が拡張されているため、テストにも追加のコードが必要です。  次の手順では、`ctlAlarmClock` の機能をテストするための簡単なプログラムを記述します。  `ctlAlarmClock` の `AlarmTime` プロパティを設定および表示するコードを作成し、固有の機能をテストします。  
+  
+##### コントロールをビルドしてテスト フォームに追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlClockLib\]** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+2.  **\[ファイル\]** メニューの **\[追加\]** をポイントし、**\[新しいプロジェクト\]** をクリックします。  
+  
+3.  ソリューションに新しい **Windows アプリケーション** プロジェクトを追加し、「`Test`」という名前を付けます。  
+  
+     **Test** プロジェクトがソリューション エクスプローラーに追加されます。  
+  
+4.  ソリューション エクスプローラーで、\[`Test`\] プロジェクト ノードを右クリックし、**\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを表示します。  
+  
+5.  **\[プロジェクト\]** タブをクリックします。  **ctlClockLib** プロジェクトが **\[プロジェクト名\]** の下に表示されます。  **\[ctlClockLib\]** をダブルクリックして、テスト プロジェクトに参照を追加します。  
+  
+6.  ソリューション エクスプローラーで、**Test** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+7.  **ツールボックス**で、**\[ctlClockLib コンポーネント\]** ノードを展開します。  
+  
+8.  **\[ctlAlarmClock\]** をダブルクリックして、`ctlAlarmClock` のインスタンスをフォームに追加します。  
+  
+9. **ツールボックス**で、**\[DateTimePicker\]** を検索してダブルクリックし、<xref:System.Windows.Forms.DateTimePicker> コントロールをフォームに追加します。また、**\[Label\]** をダブルクリックして <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+10. マウスを使用して、フォーム上で各コントロールを使いやすい位置に移動します。  
+  
+11. コントロールのプロパティを次のように設定します。  
+  
+    |Control|プロパティ|値|  
+    |-------------|-----------|-------|  
+    |`label1`|**テキスト**|`(空白)`|  
+    ||**名前**|`lblTest`|  
+    |`dateTimePicker1`|**名前**|`dtpTest`|  
+    ||**書式**|<xref:System.Windows.Forms.DateTimePickerFormat>|  
+  
+12. デザイナーで、**\[dtpTest\]** をダブルクリックします。  
+  
+     **コード エディター**が開き、`Private Sub dtpTest_ValueChanged` が表示されます。  
+  
+13. コードを次のように変更します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Private Sub dtpTest_ValueChanged(ByVal sender As Object, ByVal e As _  
+        System.EventArgs) Handles dtpTest.ValueChanged  
+        ctlAlarmClock1.AlarmTime = dtpTest.Value  
+        ctlAlarmClock1.AlarmSet = True  
+        lblTest.Text = "Alarm Time is " & Format(ctlAlarmClock1.AlarmTime, _  
+            "hh:mm")  
+    End Sub  
+    ```  
+  
+14. ソリューション エクスプローラーで、**Test** を右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+15. **\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。  
+  
+     テスト プログラムが起動します。  `ctlAlarmClock` コントロールの現在時刻が更新され、<xref:System.Windows.Forms.DateTimePicker> コントロールに開始時刻が表示されます。  
+  
+16. <xref:System.Windows.Forms.DateTimePicker> で分が表示されている部分をクリックします。  
+  
+17. キーボードを使用して、`ctlAlarmClock` によって表示されている現在の時刻より 1 分後の値を設定します。  
+  
+     アラーム設定時刻は `lblTest` に表示されます。  表示時刻がアラームの設定時刻になるまで待ちます。  表示時刻がアラーム設定時刻になると、ビープ音が鳴り、`lblAlarm` が点滅します。  
+  
+18. `lblAlarm` をクリックしてアラームを止めます。  その後で、アラームを再び設定できます。  
+  
+     このチュートリアルでは、多数の重要な概念を扱いました。  複合コントロール コンテナーにコントロールやコンポーネントを組み込んで複合コントロールを作成する方法を学びました。  また、コントロールにプロパティを追加する方法や、カスタム機能を実装するコードを記述する方法も学びました。  最後のセクションでは、継承によって特定の複合コントロールの機能を拡張し、オーバーライドによりホストのメソッドの機能を変更する方法を学びました。  
+  
+## 参照  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)   
+ [方法 : 複合コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-author-composite-controls.md)   
+ [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](../../../../docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)   
+ [Component Authoring Walkthroughs](../Topic/Component%20Authoring%20Walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md b/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md
new file mode 100644
index 00000000000..6627790183f
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md
@@ -0,0 +1,437 @@
+---
+title: "チュートリアル : Visual C# による複合コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [C#]"
+  - "カスタム コントロール [Windows フォーム], 作成"
+  - "ユーザー コントロール [C#]"
+  - "ユーザー コントロール [Windows フォーム], 作成 (Visual C# を使用した)"
+  - "UserControl クラス, チュートリアル"
+ms.assetid: f88481a8-c746-4a36-9479-374ce5f2e91f
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# チュートリアル : Visual C# による複合コントロールの作成
+複合コントロールは、カスタム グラフィカル インターフェイスの作成と再利用のための手段を提供します。  複合コントロールは、基本的には表示できる形式を持つコンポーネントです。  そのため、ユーザー コントロールは、1 つ以上の Windows フォーム コントロール、コンポーネント、またはコードのブロックから構成でき、ユーザー入力を検査したり、表示プロパティを変更したり、作成者によって要求されるその他のタスクを実行したりすることで機能を拡張できます。  複合コントロールは、他のコントロールと同じ方法で Windows フォームに配置できます。  このチュートリアルの前半では、`ctlClock` という名前の単純な複合コントロールを作成します。  後半では、継承によって `ctlClock` の機能を拡張します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 新しいプロジェクトを作成するときには、その名前を指定することにより、ルート名前空間、アセンブリ名、およびプロジェクト名を設定し、既定のコンポーネントが正しい名前空間に含まれるようにします。  
+  
+#### ctlClockLib コントロール ライブラリおよび ctlClock コントロールを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックして **\[新しいプロジェクト\]** ダイアログ ボックスを表示します。  
+  
+2.  [!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] プロジェクトの一覧の **\[Windows フォーム コントロール ライブラリ\]** プロジェクト テンプレートをクリックし、**\[プロジェクト名\]** ボックスに「`ctlClockLib`」と入力し、**\[OK\]** をクリックします。  
+  
+     プロジェクト名 `ctlClockLib` は、既定でルート名前空間にも割り当てられます。  ルート名前空間は、アセンブリ内のコンポーネント名の修飾に使用されます。  たとえば、`ctlClock` という名前のコンポーネントが 2 つのアセンブリに含まれる場合は、`ctlClockLib.ctlClock` という形で目的の `ctlClock` コンポーネントを指定できます。  
+  
+3.  ソリューション エクスプローラーで、**UserControl1.cs** を右クリックし、**\[名前の変更\]** をクリックします。  ファイル名を「`ctlClock.cs`」に変更します。  コード要素 "UserControl1" へのすべての参照の名前を変更するかどうかを確認するダイアログ ボックスが表示されたら、**\[はい\]** をクリックします。  
+  
+    > [!NOTE]
+    >  既定では、複合コントロールはシステムによって提供される <xref:System.Windows.Forms.UserControl> クラスを継承します。  <xref:System.Windows.Forms.UserControl> クラスは、すべての複合コントロールに必要な機能を提供し、標準のメソッドおよびプロパティを実装します。  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## 複合コントロールへの Windows コントロールおよびコンポーネントの追加  
+ ビジュアル インターフェイスは、複合コントロールの基本的な部分です。  このビジュアル インターフェイスは、デザイナー画面に 1 つ以上の Windows コントロールを追加することによって実装されます。  次の例では、複合コントロールに Windows コントロールを取り込んで、機能を実装するコードを記述します。  
+  
+#### 複合コントロールに Label と Timer を追加するには  
+  
+1.  ソリューション エクスプローラーで **ctlClock.cs** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+2.  **ツールボックス**の **\[コモン コントロール\]** ノードを展開し、**\[Label\]** をダブルクリックします。  
+  
+     `label1` という名前の <xref:System.Windows.Forms.Label> がデザイナー画面のコントロールに追加されます。  
+  
+3.  デザイナーで、**\[label1\]** をクリックします。  プロパティ ウィンドウで、次のプロパティを設定します。  
+  
+    |プロパティ|変更後の値|  
+    |-----------|-----------|  
+    |**名前**|`lblDisplay`|  
+    |**テキスト**|`(空白)`|  
+    |**TextAlign**|`MiddleCenter`|  
+    |**Font.Size**|`14`|  
+  
+4.  **ツールボックス**の **\[コンポーネント\]** ノードを展開し、**\[Timer\]** をダブルクリックします。  
+  
+     <xref:System.Windows.Forms.Timer> はコンポーネントであるため、実行時には表示できる形式を持ちません。  このため、デザイナー画面にはコントロールと共には表示されず、**コンポーネント デザイナー** \(デザイナー画面の下部にあるトレイ\) に表示されます。  
+  
+5.  **コンポーネント デザイナー**で、**\[Timer1\]** をクリックし、<xref:System.Windows.Forms.Timer.Interval%2A> プロパティを `1000`、<xref:System.Windows.Forms.Timer.Enabled%2A> プロパティを `true` に設定します。  
+  
+     <xref:System.Windows.Forms.Timer.Interval%2A> プロパティは、<xref:System.Windows.Forms.Timer> コンポーネントが時を刻む頻度を制御します。  `timer1` が時を刻むたびに、`timer1_Tick` イベントのコードが実行されます。  このプロパティは、タイマーが何ミリ秒ごとに時を刻むかを表しています。  
+  
+6.  **コンポーネント デザイナー**で、**\[Timer1\]** をダブルクリックして、`ctlClock` の `timer1_Tick` イベントに移動します。  
+  
+7.  コードを次のコード サンプルのように変更します。  アクセス修飾子を必ず `private` から `protected` に変更してください。  
+  
+     \[C\#\]  
+  
+    ```  
+    protected void timer1_Tick(object sender, System.EventArgs e)  
+    {  
+        // Causes the label to display the current time.  
+        lblDisplay.Text = DateTime.Now.ToLongTimeString();   
+    }  
+    ```  
+  
+     このコードは、現在の時刻を `lblDisplay` に表示します。  `timer1` の間隔は 1000 に設定されているため、このイベントは `1000` ミリ秒ごとに発生します。したがって、現在の時刻は 1 秒ごとに更新されます。  
+  
+8.  `virtual` キーワードを使用して、メソッドをオーバーライドできるように変更します。  詳細については、後の「ユーザー コントロールからの継承」を参照してください。  
+  
+    ```  
+    protected virtual void timer1_Tick(object sender, System.EventArgs e)  
+    ```  
+  
+9. **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## 複合コントロールへのプロパティの追加  
+ 現在、クロック コントロールは、それぞれが固有のプロパティ セットを持つ <xref:System.Windows.Forms.Label> コントロールと <xref:System.Windows.Forms.Timer> コンポーネントをカプセル化しています。  各コントロールのプロパティは、コントロールの後続のユーザーからはアクセスできませんが、適切なコード ブロックを作成することによってカスタム プロパティを作成および公開できます。  次の手順では、ユーザーが背景とテキストの色を変更できるようにするプロパティをコントロールに追加します。  
+  
+#### 複合コントロールにプロパティを追加するには  
+  
+1.  ソリューション エクスプローラーで、**ctlClock.cs** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+     コントロールの**コード エディター**が表示されます。  
+  
+2.  `public partial class ctlClock` ステートメントを探します。  左中かっこ \(`{)` の下に次のコードを入力します。  
+  
+     \[C\#\]  
+  
+    ```  
+    private Color colFColor;  
+    private Color colBColor;  
+    ```  
+  
+     これらのステートメントは、作成するプロパティの値を格納するために使用するプライベート変数を作成します。  
+  
+3.  手順 2. の変数宣言の下に次のコードを入力します。  
+  
+     \[C\#\]  
+  
+    ```  
+    // Declares the name and type of the property.  
+    public Color ClockBackColor  
+    {  
+        // Retrieves the value of the private variable colBColor.  
+        get  
+        {  
+            return colBColor;  
+        }  
+        // Stores the selected value in the private variable colBColor, and   
+        // updates the background color of the label control lblDisplay.  
+        set  
+        {  
+            colBColor = value;  
+            lblDisplay.BackColor = colBColor;     
+        }  
+    }  
+    // Provides a similar set of instructions for the foreground color.  
+    public Color ClockForeColor  
+    {  
+        get  
+        {  
+            return colFColor;  
+        }  
+        set  
+        {  
+            colFColor = value;  
+            lblDisplay.ForeColor = colFColor;  
+        }  
+    }  
+    ```  
+  
+     上記のコードは、このコントロールを今後使用するユーザーが `ClockForeColor` および `ClockBackColor` という 2 つのカスタム プロパティを使用できるようにします。  `get` ステートメントと `set` ステートメントは、プロパティに適切な機能を実装するコードと共に、プロパティ値の格納と取得の機能を提供します。  
+  
+4.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+## コントロールのテスト  
+ コントロールはスタンドアロン アプリケーションではないため、コンテナーでホストする必要があります。  コントロールの実行時の動作をテストし、**ユーザー コントロール テスト コンテナー**でそのプロパティを実行します。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+#### コントロールをテストするには  
+  
+1.  F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  
+  
+2.  テスト コンテナーのプロパティ グリッドで、`ClockBackColor` プロパティを検索し、プロパティを選択してカラー パレットを表示します。  
+  
+3.  任意の色をクリックして選択します。  
+  
+     コントロールの背景色が、選択した色に変更されます。  
+  
+4.  同様なイベントのシーケンスを使用して、`ClockForeColor` プロパティが予想どおりに機能することを確認します。  
+  
+     このセクションと前のセクションでは、コンポーネントと Windows コントロールをコードと結合し、複合コントロールの形式にパッケージ化してカスタム機能を提供する方法を説明しました。  複合コントロールのプロパティを公開し、完了後にコントロールをテストする方法を学びました。  次のセクションでは、`ctlClock` をベースとして継承した複合コントロールを構築する方法を学びます。  
+  
+## 複合コントロールからの継承  
+ 前のセクションでは、再利用可能な複合コントロールに Windows コントロール、コンポーネント、およびコードを組み込む方法を学びました。  この複合コントロールをベースにして、他のコントロールを作成できます。  基本クラスからクラスを派生するプロセスは*継承*と呼ばれます。  このセクションでは、`ctlAlarmClock` という名前の複合コントロールを作成します。  このコントロールは、親コントロールである `ctlClock` から派生します。  ここでは、親のメソッドをオーバーライドし、新しいメソッドおよびプロパティを追加することにより、`ctlClock` の機能を拡張する方法を学びます。  
+  
+ 継承コントロールの作成の最初の手順は、親コントロールからの派生です。  これにより、親コントロールのプロパティ、メソッド、およびグラフィカル特性をすべて持つ新しいコントロールが作成されます。このコントロールに基づいて、新しい機能を追加したり機能を変更したりできます。  
+  
+#### 継承コントロールを作成するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlClockLib\]** を右クリックします。**\[追加\]** をポイントし、**\[ユーザー コントロール\]** をクリックします。  
+  
+     **\[新しい項目の追加\]** ダイアログ ボックスが表示されます。  
+  
+2.  **\[継承されたユーザー コントロール\]** テンプレートを選択します。  
+  
+3.  **\[ファイル名\]** ボックスに「`ctlAlarmClock.cs`」と入力し、**\[追加\]** をクリックします。  
+  
+     **\[継承ピッカー\]** ダイアログ ボックスが表示されます。  
+  
+4.  **\[コンポーネント名\]** の **\[ctlClock\]** をダブルクリックします。  
+  
+5.  ソリューション エクスプローラーで、現在のプロジェクトを最後まで参照します。  
+  
+    > [!NOTE]
+    >  現在のプロジェクトに **ctlAlarmClock.cs** という名前のファイルが追加されています。  
+  
+### アラーム プロパティの追加  
+ 複合コントロールにプロパティを追加する場合と同じ方法で、継承コントロールにプロパティを追加できます。  ここでは、プロパティ宣言の構文を使用してコントロールに 2 つのプロパティを追加します。`AlarmTime` プロパティは、アラームを鳴らす日付と時刻の値を格納します。`AlarmSet` プロパティは、アラームが設定されているかどうかを示します。  
+  
+##### 複合コントロールにプロパティを追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlAlarmClock\]** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  `public class` ステートメントを探します。  コントロールが `ctlClockLib.ctlClock` から継承される点に注意してください。  左中かっこ \(`{)` ステートメントの下に次のコードを入力します。  
+  
+     \[C\#\]  
+  
+    ```  
+    private DateTime dteAlarmTime;  
+    private bool blnAlarmSet;  
+    // These properties will be declared as public to allow future   
+    // developers to access them.  
+    public DateTime AlarmTime  
+    {  
+        get  
+        {  
+            return dteAlarmTime;  
+        }  
+        set  
+        {  
+            dteAlarmTime = value;  
+        }  
+    }  
+    public bool AlarmSet  
+    {  
+        get  
+        {  
+            return blnAlarmSet;  
+        }  
+        set  
+        {  
+            blnAlarmSet = value;  
+        }  
+    }  
+    ```  
+  
+### コントロールのグラフィカル インターフェイスへの追加  
+ 継承したコントロールには、継承元のコントロールと同じビジュアル インターフェイスがあります。  継承コントロールには親コントロールと同じ内在コントロールがありますが、内在コントロールのプロパティは特に公開されない限り使用できません。  継承した複合コントロールのグラフィカル インターフェイスも、他の複合コントロールと同じように拡張できます。  引き続き、アラーム クロックのビジュアル インターフェイスに、アラームが鳴ったときに点滅するラベル コントロールを追加します。  
+  
+##### ラベル コントロールを追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlAlarmClock\]** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+     `ctlAlarmClock` のデザイナーがメイン ウィンドウに表示されます。  
+  
+2.  コントロールの表示部分をクリックし、\[プロパティ\] ウィンドウを表示します。  
+  
+    > [!NOTE]
+    >  すべてのプロパティが表示されていますが、淡色表示になっています。  つまり、これらのプロパティは `lblDisplay` に対してネイティブであり、\[プロパティ\] ウィンドウでは変更もアクセスもできません。  既定では、複合コントロールに含まれているコントロールは `private` であり、どのような方法によってもプロパティにアクセスできません。  
+  
+    > [!NOTE]
+    >  複合コントロールを今後使用するユーザーがその内部のコントロールにアクセスできるようにするには、内部のコントロールを `public` または `protected` として宣言します。  これにより、適切なコードを使用して、複合コントロールに含まれるコントロールのプロパティを設定したり変更したりできるようになります。  
+  
+3.  複合コントロールに <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+4.  マウスを使用して、<xref:System.Windows.Forms.Label> コントロールを表示ボックスのすぐ下にドラッグします。  プロパティ ウィンドウで、次のプロパティを設定します。  
+  
+    |プロパティ|設定|  
+    |-----------|--------|  
+    |**名前**|`lblAlarm`|  
+    |**テキスト**|Alarm\!|  
+    |**TextAlign**|`MiddleCenter`|  
+    |**Visible**|`false`|  
+  
+### アラーム機能の追加  
+ 前の手順では、複合コントロールでアラーム機能を有効にするためのプロパティおよびコントロールを追加しました。  この手順では、現在の時刻とアラームの時刻を比較し、一致した場合は、アラームを点滅させるコードを追加します。  `ctlClock` の `timer1_Tick` メソッドをオーバーライドしてコードを追加することにより、`ctlClock` の固有の機能をすべて保持しながら `ctlAlarmClock` の機能を拡張できます。  
+  
+##### ctlClock の timer1\_Tick メソッドをオーバーライドするには  
+  
+1.  **コード エディター**で、`private bool blnAlarmSet;` ステートメントを検索します。  このステートメントの直後に、次のステートメントを追加します。  
+  
+     \[C\#\]  
+  
+    ```  
+    private bool blnColorTicker;  
+    ```  
+  
+2.  **コード エディター**で、クラスの末尾にある右中かっこ \(`})` を検索します。  中かっこの直前に、次のコードを追加します。  
+  
+     \[C\#\]  
+  
+    ```  
+    protected override void timer1_Tick(object sender, System.EventArgs e)  
+    {  
+        // Calls the Timer1_Tick method of ctlClock.  
+        base.timer1_Tick(sender, e);  
+        // Checks to see if the alarm is set.  
+        if (AlarmSet == false)  
+            return;  
+        else  
+            // If the date, hour, and minute of the alarm time are the same as  
+            // the current time, flash an alarm.   
+        {  
+            if (AlarmTime.Date == DateTime.Now.Date && AlarmTime.Hour ==   
+                DateTime.Now.Hour && AlarmTime.Minute == DateTime.Now.Minute)  
+            {  
+                // Sets lblAlarmVisible to true, and changes the background color based on  
+                // the value of blnColorTicker. The background color of the label   
+                // will flash once per tick of the clock.  
+                lblAlarm.Visible = true;  
+                if (blnColorTicker == false)   
+                {  
+                    lblAlarm.BackColor = Color.Red;  
+                    blnColorTicker = true;  
+                }  
+                else  
+                {  
+                    lblAlarm.BackColor = Color.Blue;  
+                    blnColorTicker = false;  
+                }  
+            }  
+            else  
+            {  
+                // Once the alarm has sounded for a minute, the label is made   
+                // invisible again.  
+                lblAlarm.Visible = false;  
+            }  
+        }  
+    }  
+    ```  
+  
+     このコードを追加することで、いくつかのタスクが実行されます。  `override` ステートメントは、基本コントロールから継承されたメソッドの代わりに、このメソッドを使用するようにコントロールに指示します。  このメソッドが呼び出されると、メソッドは `base.timer1_Tick` ステートメントを呼び出すことにより、オーバーライドするメソッドを呼び出します。その結果、元のコントロールに含まれるすべての機能がこのコントロールに継承されます。  メソッドは次に追加のコードを実行してアラーム機能を組み込みます。  アラームが発生すると、点滅するラベル コントロールが表示されます。  
+  
+     これで、アラーム付き時計はほぼ完成です。  後は、アラームを止める手段を実装するだけです。  これを行うには、`lblAlarm_Click` メソッドにコードを追加します。  
+  
+##### アラームを止める手段を実装するには  
+  
+1.  ソリューション エクスプローラーで、**ctlAlarmClock.cs** を右クリックし、**\[デザイナーの表示\]** をクリックします。  
+  
+     デザイナーが表示されます。  
+  
+2.  コントロールにボタンを追加します。  ボタンのプロパティを次のように設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |**名前**|`btnAlarmOff`|  
+    |**テキスト**|Disable Alarm|  
+  
+3.  デザイナーで、**\[btnAlarmOff\]** をダブルクリックします。  
+  
+     **コード エディター**が開き、`private void btnAlarmOff_Click` 行が表示されます。  
+  
+4.  このメソッドを次のコードのように変更します。  
+  
+     \[C\#\]  
+  
+    ```  
+    private void btnAlarmOff_Click(object sender, System.EventArgs e)  
+    {  
+        // Turns off the alarm.  
+        AlarmSet = false;  
+        // Hides the flashing label.  
+        lblAlarm.Visible = false;  
+    }  
+    ```  
+  
+5.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックして、プロジェクトを保存します。  
+  
+### フォームでの継承コントロールの使用  
+ 継承コントロールは、基本クラスである `ctlClock` のテストと同様の方法でテストできます。F5 キーを押してプロジェクトをビルドし、**ユーザー コントロール テスト コンテナー**でコントロールを実行します。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+ コントロールを使用できるようにするには、フォーム上でコントロールをホストする必要があります。  標準複合コントロールと同様に、継承複合コントロールはスタンドアロン型ではないため、フォームまたは他のコンテナーでホストする必要があります。  `ctlAlarmClock` は機能が拡張されているため、テストにも追加のコードが必要です。  次の手順では、`ctlAlarmClock` の機能をテストするための簡単なプログラムを記述します。  `ctlAlarmClock` の `AlarmTime` プロパティを設定および表示するコードを作成し、固有の機能をテストします。  
+  
+##### コントロールをビルドしてテスト フォームに追加するには  
+  
+1.  ソリューション エクスプローラーで、**\[ctlClockLib\]** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+2.  ソリューションに新しい **Windows アプリケーション** プロジェクトを追加し、「`Test`」という名前を付けます。  
+  
+3.  ソリューション エクスプローラーで、テスト プロジェクトの **\[参照設定\]** ノードを右クリックします。  **\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを表示します。  **\[プロジェクト\]** タブをクリックします。  `ctlClockLib` プロジェクトが **\[プロジェクト名\]** の下に表示されます。  プロジェクトをダブルクリックしてテスト プロジェクトへの参照を追加します。  
+  
+4.  ソリューション エクスプローラーで、**Test** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+5.  **ツールボックス**で、**\[ctlClockLib コンポーネント\]** ノードを展開します。  
+  
+6.  **\[ctlAlarmClock\]** をダブルクリックして、`ctlAlarmClock` をフォームにコピーします。  
+  
+7.  **ツールボックス**で、**\[DateTimePicker\]** を検索してダブルクリックし、<xref:System.Windows.Forms.DateTimePicker> コントロールをフォームに追加します。また、**\[Label\]** をダブルクリックして <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+8.  マウスを使用して、フォーム上で各コントロールを使いやすい位置に移動します。  
+  
+9. コントロールのプロパティを次のように設定します。  
+  
+    |Control|プロパティ|値|  
+    |-------------|-----------|-------|  
+    |`label1`|**テキスト**|`(空白)`|  
+    ||**名前**|`lblTest`|  
+    |`dateTimePicker1`|**名前**|`dtpTest`|  
+    ||**書式**|<xref:System.Windows.Forms.DateTimePickerFormat>|  
+  
+10. デザイナーで、**\[dtpTest\]** をダブルクリックします。  
+  
+     **コード エディター**が開き、`private void dtpTest_ValueChanged` が表示されます。  
+  
+11. コードを次のように変更します。  
+  
+     \[C\#\]  
+  
+    ```  
+    private void dtpTest_ValueChanged(object sender, System.EventArgs e)  
+    {  
+        ctlAlarmClock1.AlarmTime = dtpTest.Value;  
+        ctlAlarmClock1.AlarmSet = true;  
+        lblTest.Text = "Alarm Time is " +  
+            ctlAlarmClock1.AlarmTime.ToShortTimeString();  
+    }  
+    ```  
+  
+12. ソリューション エクスプローラーで、**Test** を右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+13. **\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。  
+  
+     テスト プログラムが起動します。  `ctlAlarmClock` コントロールの現在時刻が更新され、<xref:System.Windows.Forms.DateTimePicker> コントロールに開始時刻が表示されます。  
+  
+14. <xref:System.Windows.Forms.DateTimePicker> で分が表示されている部分をクリックします。  
+  
+15. キーボードを使用して、`ctlAlarmClock` によって表示されている現在の時刻より 1 分後の値を設定します。  
+  
+     アラーム設定時刻は `lblTest` に表示されます。  表示時刻がアラームの設定時刻になるまで待ちます。  表示時刻がアラームの設定時刻になったときに、`lblAlarm` が点滅します。  
+  
+16. `btnAlarmOff` をクリックしてアラームを止めます。  その後で、アラームを再び設定できます。  
+  
+     このチュートリアルでは、多数の重要な概念を扱いました。  複合コントロール コンテナーにコントロールやコンポーネントを組み込んで複合コントロールを作成する方法を学びました。  また、コントロールにプロパティを追加する方法や、カスタム機能を実装するコードを記述する方法も学びました。  最後のセクションでは、継承によって特定の複合コントロールの機能を拡張し、オーバーライドによりホストのメソッドの機能を変更する方法を学びました。  
+  
+## 参照  
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)   
+ [コンポーネントによるプログラミング](../Topic/Programming%20with%20Components.md)   
+ [Component Authoring Walkthroughs](../Topic/Component%20Authoring%20Walkthroughs.md)   
+ [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](../../../../docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)   
+ [チュートリアル : Visual C\# による Windows フォーム コントロールからの継承](../../../../docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md b/docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md
new file mode 100644
index 00000000000..2e9fac52cc5
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-automatically-populating-the-toolbox-with-custom-components.md
@@ -0,0 +1,111 @@
+---
+title: "チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コンポーネント, 追加 (ツールボックスに)"
+  - "IToolboxService インターフェイス"
+  - "ツールボックス [Windows フォーム], データの読み込み"
+ms.assetid: 2fa1e3e8-6b9f-42b2-97c0-2be57444dba4
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# チュートリアル : ツールボックスへのカスタム コンポーネントの自動設定
+現在開いているソリューションのプロジェクトで定義されたコンポーネントは、**\[ツールボックス\]** に自動的に表示され、独自の操作は必要ありません。  **\[ツールボックス\]** には、[Choose Toolbox Items Dialog Box \(Visual Studio\)](http://msdn.microsoft.com/ja-jp/bd07835f-18a8-433e-bccc-7141f65263bb) を使用してカスタム コンポーネントを手動で設定することもできますが、**\[ツールボックス\]** は、ソリューションのビルド出力で次の特徴をすべて備えた項目に対応します。  
+  
+-   <xref:System.ComponentModel.IComponent> を実装する。  
+  
+-   <xref:System.ComponentModel.ToolboxItemAttribute> が `false` に設定されていない。  
+  
+-   <xref:System.ComponentModel.DesignTimeVisibleAttribute> が `false` に設定されていない。  
+  
+> [!NOTE]
+>  **\[ツールボックス\]** は参照チェーンに従わないため、ソリューションのプロジェクトで構築されていない項目は表示されません。  
+  
+ このチュートリアルでは、構築されたカスタム コンポーネントが **\[ツールボックス\]** にどのように自動表示されるかについて説明します。  このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   カスタム コンポーネントの作成  
+  
+-   カスタム コンポーネントのインスタンスの作成  
+  
+-   カスタム コンポーネントのアンロードと再読み込み  
+  
+ このチュートリアルでは最終的に、作成したコンポーネントが **\[ツールボックス\]** に読み込まれていることを確認します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  `ToolboxExample` という名前の Windows ベース アプリケーション プロジェクトを作成します。  
+  
+     詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  プロジェクトに新しいコンポーネントを追加します。  このコンポーネントに「`DemoComponent`」という名前を付けます。  
+  
+     詳細については、「[NIB:How to: Add New Project Items](http://msdn.microsoft.com/ja-jp/63d3e16b-de6e-4bb5-a0e3-ecec762201ce)」を参照してください。  
+  
+3.  プロジェクトをビルドします。  
+  
+4.  **\[ツール\]** メニューの **\[オプション\]** 項目をクリックします。  **\[Windows フォーム デザイナー\]** 項目の **\[全般\]** をクリックし、**\[AutoToolboxPopulate\]** オプションが **\[True\]** に設定されていることを確認します。  
+  
+## カスタム コンポーネントのインスタンスの作成  
+ 次に、カスタム コンポーネントのインスタンスをフォームで作成します。  **\[ツールボックス\]** は新しいコンポーネントに自動的に対応するため、これは、他のコンポーネントやコントロールを作成するのと同じように簡単です。  
+  
+#### カスタム コンポーネントのインスタンスを作成するには  
+  
+1.  プロジェクトのフォームを**フォーム デザイナー**で開きます。  
+  
+2.  **\[ツールボックス\]** で、**\[ToolboxExample コンポーネント\]** という新しいタブをクリックします。  
+  
+     このタブをクリックすると、**\[DemoComponent\]** が表示されます。  
+  
+    > [!NOTE]
+    >  パフォーマンス上の理由により、**\[ツールボックス\]** の自動設定領域のコンポーネントはカスタム ビットマップを表示せず、<xref:System.Drawing.ToolboxBitmapAttribute> はサポートされません。  カスタム コンポーネントのアイコンを **\[ツールボックス\]** に表示するには、**\[ツールボックス アイテムの選択\]** ダイアログ ボックスを使用してコンポーネントを読み込みます。  
+  
+3.  コンポーネントをフォームにドラッグします。  
+  
+     コンポーネントのインスタンスが作成され、**\[コンポーネント トレイ\]** に追加されます。  
+  
+## カスタム コンポーネントのアンロードと再読み込み  
+ **\[ツールボックス\]** は、読み込まれた各プロジェクトのコンポーネントに対応し、プロジェクトがアンロードされると、プロジェクトのコンポーネントへの参照が削除されます。  
+  
+#### ツールボックスに対するコンポーネントのアンロードと再読み込みの影響を確認するには  
+  
+1.  プロジェクトをソリューションからアンロードします。  
+  
+     プロジェクトのアンロードの詳細については、「[NIB:How to: Unload and Reload Projects](http://msdn.microsoft.com/ja-jp/abc0155b-8fcb-4ffc-95b6-698518a7100b)」を参照してください。  保存するかどうかを確認するダイアログ ボックスが表示された場合は、**\[はい\]** をクリックします。  
+  
+2.  ソリューションに新しい **Windows アプリケーション** プロジェクトを追加します。  **デザイナー**でフォームを開きます。  
+  
+     前のプロジェクトの **\[ToolboxExample コンポーネント\]** タブは削除されています。  
+  
+3.  `ToolboxExample` プロジェクトを再読み込みします。  
+  
+     **\[ToolboxExample コンポーネント\]** タブが再表示されます。  
+  
+## 次の手順  
+ このチュートリアルでは、**\[ツールボックス\]** がプロジェクトのコンポーネントに対応することを説明してきましたが、**\[ツールボックス\]** は、コントロールにも対応します。  コントロール プロジェクトをソリューションに追加および削除して、独自のカスタム コントロールについても確認してみてください。  
+  
+## 参照  
+ [General, Windows Forms Designer, Options Dialog Box](http://msdn.microsoft.com/ja-jp/8dd170af-72f0-4212-b04b-034ceee92834)   
+ [How to: Manipulate Toolbox Tabs](http://msdn.microsoft.com/ja-jp/21285050-cadd-455a-b1f5-a2289a89c4db)   
+ [Choose Toolbox Items Dialog Box \(Visual Studio\)](http://msdn.microsoft.com/ja-jp/bd07835f-18a8-433e-bccc-7141f65263bb)   
+ [Windows フォームへのコントロールの追加](../../../../docs/framework/winforms/controls/putting-controls-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-creating-a-professionally-styled-toolstrip-control.md b/docs/framework/winforms/controls/walkthrough-creating-a-professionally-styled-toolstrip-control.md
new file mode 100644
index 00000000000..e2021666fba
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-creating-a-professionally-styled-toolstrip-control.md
@@ -0,0 +1,198 @@
+---
+title: "チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ツール バー [Windows フォーム], チュートリアル"
+  - "ToolStrip コントロール [Windows フォーム], 作成 (プロフェッショナル スタイルのコントロールを)"
+  - "ToolStripProfessionalRenderer クラス [Windows フォーム]"
+  - "ToolStripRenderer クラス [Windows フォーム]"
+ms.assetid: b52339ae-f1d3-494e-996e-eb455614098a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# チュートリアル : プロフェッショナル スタイルの ToolStrip コントロールの作成
+<xref:System.Windows.Forms.ToolStripProfessionalRenderer> 型から派生する独自のクラスを記述することで、アプリケーションの <xref:System.Windows.Forms.ToolStrip> コントロールにプロフェッショナルな外観と動作を与えることができます。  
+  
+ このチュートリアルでは、<xref:System.Windows.Forms.ToolStrip> コントロールを使用して、Microsoft® Outlook® の**ナビゲーション ペイン**に似た複合コントロールを作成する方法について説明します。  このチュートリアルでは、次のタスクについて説明します。  
+  
+-   新しい Windows コントロール ライブラリ プロジェクトを作成します。  
+  
+-   StackView コントロールをデザインします。  
+  
+-   カスタム レンダラーを割り当てます。  
+  
+ これらのタスクを終了すると、Microsoft Office® XP コントロールのプロフェッショナルな外観を備えた、再利用できるカスタム クライアント コントロールが作成されます。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : プロフェッショナル スタイルの ToolStrip コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-professionally-styled-toolstrip-control.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## コントロール ライブラリ プロジェクトの作成  
+ 最初に、コントロール ライブラリ プロジェクトを作成します。  
+  
+#### コントロール ライブラリ プロジェクトを作成するには  
+  
+1.  `StackViewLibrary` という新しい Windows コントロール ライブラリ プロジェクトを作成します。  
+  
+2.  **ソリューション エクスプローラー**で、選択した言語に応じて "UserControl1.cs" または "UserControl1.vb" という名前のソース ファイルを削除して、プロジェクトの既定のコントロールを削除します。  
+  
+     詳細については、「[NIB:How to: Remove, Delete, and Exclude Items](http://msdn.microsoft.com/ja-jp/6dffdc86-29c8-4eff-bcd8-e3a0dd9e9a73)」を参照してください。  
+  
+3.  新しい <xref:System.Windows.Forms.UserControl> アイテムを **StackViewLibrary** プロジェクトに追加します。  新しいソース ファイルに、"`StackView`" という基本名を付けます。  
+  
+## StackView コントロールのデザイン  
+ `StackView` コントロールは、1 つの子コントロール <xref:System.Windows.Forms.ToolStrip> を含む複合コントロールです。  複合コントロールの詳細については、「[さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)」を参照してください。  
+  
+#### StackView コントロールをデザインするには  
+  
+1.  **ツールボックス**からデザイン サーフェイスに <xref:System.Windows.Forms.ToolStrip> コントロールを追加します。  
+  
+2.  **プロパティ** ウィンドウで、次の表に従って <xref:System.Windows.Forms.ToolStrip> コントロールのプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |名前|`stackStrip`|  
+    |CanOverflow|`false`|  
+    |Dock|<xref:System.Windows.Forms.DockStyle>|  
+    |フォント|`Tahoma, 10pt, style=Bold`|  
+    |GripStyle|<xref:System.Windows.Forms.ToolStripGripStyle>|  
+    |LayoutStyle|<xref:System.Windows.Forms.ToolStripLayoutStyle>|  
+    |Padding|`0, 7, 0, 0`|  
+    |RenderMode|<xref:System.Windows.Forms.ToolStripRenderMode>|  
+  
+3.  Windows フォーム デザイナーで <xref:System.Windows.Forms.ToolStrip> コントロールの **\[追加\]** ボタンをクリックし、<xref:System.Windows.Forms.ToolStripButton> を `stackStrip` コントロールへ追加します。  
+  
+4.  **プロパティ** ウィンドウで、次の表に従って <xref:System.Windows.Forms.ToolStripButton> コントロールのプロパティを設定します。  
+  
+    |プロパティ|値|  
+    |-----------|-------|  
+    |名前|`mailStackButton`|  
+    |CheckOnClick|true|  
+    |CheckState|<xref:System.Windows.Forms.CheckState>|  
+    |DisplayStyle|<xref:System.Windows.Forms.ToolStripItemDisplayStyle>|  
+    |ImageAlign|<xref:System.Drawing.ContentAlignment>|  
+    |ImageScaling|<xref:System.Windows.Forms.ToolStripItemImageScaling>|  
+    |ImageTransparentColor|`238, 238, 238`|  
+    |Margin|`0, 0, 0, 0`|  
+    |Padding|`3, 3, 3, 3`|  
+    |テキスト|Mail|  
+    |TextAlign|<xref:System.Drawing.ContentAlignment>|  
+  
+5.  残りの 3 つの <xref:System.Windows.Forms.ToolStripButton> コントロールについても手順 7. を繰り返します。  
+  
+     `calendarStackButton` コントロール、`contactsStackButton` コントロール、および `tasksStackButton` コントロールに名前を付けます。  <xref:System.Windows.Forms.Control.Text%2A> プロパティの値を、それぞれ Calendar、Contacts、および Tasks に設定します。  
+  
+## イベントの処理  
+ `StackView` コントロールが適切に動作するようにするには、2 つのイベントが重要です。  コントロールの位置を適切に指定するには <xref:System.Windows.Forms.UserControl.Load> イベントを処理します。  `StackView` コントロールの状態を <xref:System.Windows.Forms.RadioButton> コントロールと似た動作にするには、<xref:System.Windows.Forms.ToolStripButton> ごとに <xref:System.Windows.Forms.ToolStripItem.Click> イベントを処理します。  
+  
+#### イベントを処理するには  
+  
+1.  Windows フォーム デザイナーで、`StackView` コントロールを選択します。  
+  
+2.  **\[プロパティ\]** ウィンドウ ツール バーの **\[イベント\]** をクリックします。  
+  
+3.  Load イベントをダブルクリックして、`StackView_Load` イベント ハンドラーを生成します。  
+  
+4.  次のコードをコピーし、`StackView_Load` イベント ハンドラーに貼り付けます。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#3)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#3)]  
+  
+5.  Windows フォーム デザイナーで、`mailStackButton` コントロールを選択します。  
+  
+6.  **\[プロパティ\]** ウィンドウ ツール バーの **\[イベント\]** をクリックします。  
+  
+7.  \[Click\] イベントをダブルクリックします。  
+  
+     Windows フォーム デザイナーで `mailStackButton_Click` イベント ハンドラーが生成されます。  
+  
+8.  `mailStackButton_Click` イベント ハンドラーの名前を `stackButton_Click` に変更します。  
+  
+     詳細については、「[How to: Rename an Identifier \(Visual Basic\)](http://msdn.microsoft.com/ja-jp/e5a5edf8-3dba-4119-81f4-fc2aba180e0c)」を参照してください。  
+  
+9. `stackButton_Click` イベント ハンドラー内に次のコードを挿入します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#4)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#4)]  
+  
+10. Windows フォーム デザイナーで、`calendarStackButton` コントロールを選択します。  
+  
+11. **\[プロパティ\]** ウィンドウで、Click イベントを `stackButton_Click` イベント ハンドラーに設定します。  
+  
+12. `contactsStackButton` コントロールと `tasksStackButton` コントロールについて、手順 10. と手順 11. を繰り返します。  
+  
+## アイコンの定義  
+ 各 `StackView` にはアイコンが関連付けられています。  わかりやすいように、各アイコンは Base64 でエンコードされた文字列で表されます。この文字列は、<xref:System.Drawing.Bitmap> を作成する前に逆シリアル化されます。  稼動環境では、ビットマップ データをリソースとして格納すると、Windows フォーム デザイナーにアイコンが表示されます。  詳細については、「[How to: Add Background Images to Windows Forms](http://msdn.microsoft.com/ja-jp/7a509ba2-055c-4ae6-b88a-54625c6d9aff)」を参照してください。  
+  
+#### アイコンを定義するには  
+  
+1.  コード エディターで、次のコードを `StackView` クラス定義に追加します。  このコードでは、<xref:System.Windows.Forms.ToolStripButton> アイコンのビットマップを初期化します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#2)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#2)]  
+  
+2.  `StackView` クラス コンストラクターに `InitializeImages` メソッドの呼び出しを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#5)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#5)]  
+  
+## カスタム レンダラーの実装  
+ <xref:System.Windows.Forms.ToolStripRenderer> クラスから派生するクラスを実装することによって、`StackView` コントロールでは、ほとんどの要素をカスタマイズできます。  この手順では、<xref:System.Windows.Forms.ToolStripButton> コントロールについて、グリップをカスタマイズし、グラデーションの背景を描画する <xref:System.Windows.Forms.ToolStripProfessionalRenderer> クラスを実装します。  
+  
+#### カスタム レンダラーを実装するには  
+  
+1.  `StackView` コントロール定義内に次のコードを挿入します。  
+  
+     これは `StackRenderer` クラスの定義です。この定義は、<xref:System.Windows.Forms.ToolStripRenderer.RenderGrip>、<xref:System.Windows.Forms.ToolStripRenderer.RenderToolStripBorder>、および <xref:System.Windows.Forms.ToolStripRenderer.RenderButtonBackground> の各メソッドをオーバーライドし、カスタムの外観を作成します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#10)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#10)]  
+  
+2.  `StackView` コントロールのコンストラクターで、`StackRenderer` クラスの新しいインスタンスを作成し、そのインスタンスを `stackStrip` コントロールの <xref:System.Windows.Forms.ToolStrip.Renderer%2A> プロパティに割り当てます。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StackView#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/CS/StackView.cs#5)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StackView#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StackView/VB/StackView.vb#5)]  
+  
+## StackView コントロールのテスト  
+ `StackView` コントロールは <xref:System.Windows.Forms.UserControl> クラスから派生します。  そのため、このコントロールは**UserControl Test Container**でテストできます。  詳細については、「[方法 : UserControl の実行時の動作をテストする](../../../../docs/framework/winforms/controls/how-to-test-the-run-time-behavior-of-a-usercontrol.md)」を参照してください。  
+  
+#### StackView コントロールをテストするには  
+  
+1.  F5 キーを押してプロジェクトをビルドし、**UserControl Test Container**を起動します。  
+  
+2.  `StackView` コントロールのボタンにマウス ポインターを移動し、ボタンをクリックすると、選択した状態の外観が表示されます。  
+  
+## 次の手順  
+ このチュートリアルでは、Office XP コントロールのプロフェッショナルな外観を備えた、再利用できるカスタム コントロールを作成しました。  <xref:System.Windows.Forms.ToolStrip> 系コントロールの用途は、他にもたくさんあります。  
+  
+-   <xref:System.Windows.Forms.ContextMenuStrip> を使って、コントロールにショートカット メニューを作成します。  詳細については、「[ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)」を参照してください。  
+  
+-   標準メニューに自動的に項目が設定されるフォームを作成します。  詳細については、「[チュートリアル : 標準メニュー項目をフォームに用意する](../../../../docs/framework/winforms/controls/walkthrough-providing-standard-menu-items-to-a-form.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> コントロールがドッキングされている、複数のマルチ ドキュメント インターフェイス \(MDI\) フォームを作成します。  詳細については、「[方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)   
+ [方法 : フォームに標準メニュー項目を追加する](../../../../docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-creating-an-mdi-form-with-menu-merging-and-toolstrip-controls.md b/docs/framework/winforms/controls/walkthrough-creating-an-mdi-form-with-menu-merging-and-toolstrip-controls.md
new file mode 100644
index 00000000000..afd6ce35792
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-creating-an-mdi-form-with-menu-merging-and-toolstrip-controls.md
@@ -0,0 +1,222 @@
+---
+title: "チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "MDI フォーム"
+  - "MDI フォーム, 作成"
+  - "MDI フォーム, チュートリアル"
+  - "MDI, 作成 (フォームを)"
+  - "マルチ ドキュメント インターフェイス (MDI) フォーム"
+  - "ツール バー [Windows フォーム]"
+  - "ToolStrip コントロール [Windows フォーム]"
+  - "ToolStripPanel コントロール [Windows フォーム]"
+ms.assetid: fbab4221-74af-42d0-bbf4-3c97f7b2e544
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する
+<xref:System.Windows.Forms?displayProperty=fullName> 名前空間は、複数のマルチ ドキュメント インターフェイス \(MDI\) アプリケーションをサポートし、<xref:System.Windows.Forms.MenuStrip> コントロールは、メニューのマージをサポートします。  MDI フォームでは、<xref:System.Windows.Forms.ToolStrip> コントロールも使用できます。  
+  
+ このチュートリアルでは、MDI フォームで <xref:System.Windows.Forms.ToolStripPanel> コントロールを使用する方法について説明します。  このフォームには、メニューを子メニューとマージする機能もあります。  このチュートリアルでは、次のタスクについて説明します。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   フォームのメイン メニューを作成   \(実際のメニュー名は異なります\)  
+  
+-   **ツールボックス**への <xref:System.Windows.Forms.ToolStripPanel> コントロールの追加  
+  
+-   子フォームの作成  
+  
+-   z オーダーによる <xref:System.Windows.Forms.ToolStripPanel> コントロールの並べ替え  
+  
+ すべてのタスクを完了すると、メニューのマージおよび移動可能な <xref:System.Windows.Forms.ToolStrip> コントロールをサポートする MDI フォームが完成します。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : メニューのマージと ToolStrip コントロールを使用して MDI フォームを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  MdiForm という名前の Windows アプリケーション プロジェクトを作成します。  
+  
+     詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  Windows フォーム デザイナーで、フォームを選択します。  
+  
+3.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Form.IsMdiContainer%2A> の値を `true` に設定します。  
+  
+## メイン メニューの作成  
+ 親 MDI フォームにはメイン メニューがあります。  メイン メニューには **\[ウィンドウ\]** というメニュー項目が 1 つあります。  **\[ウィンドウ\]** メニュー項目を使用して、子フォームを作成できます。  子フォームのメニュー項目は、メイン メニューにマージされます。  
+  
+#### メイン メニューを作成するには  
+  
+1.  **ツールボックス**から、フォームに <xref:System.Windows.Forms.MenuStrip> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.ToolStripMenuItem> を <xref:System.Windows.Forms.MenuStrip> コントロールに追加し、\[ウィンドウ\] と名付けます。  
+  
+3.  <xref:System.Windows.Forms.MenuStrip> コントロールを選択します。  
+  
+4.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A> プロパティの値を `ToolStripMenuItem1` に設定します。  
+  
+5.  サブ項目を **\[ウィンドウ\]** メニューに追加し、\[新規作成\] と名付けます。  
+  
+6.  \[プロパティ\] ウィンドウの **\[イベント\]** をクリックします。  
+  
+7.  <xref:System.Windows.Forms.ToolStripItem.Click> イベントをダブルクリックします。  
+  
+     Windows フォーム デザイナーが、<xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを生成します。  
+  
+8.  イベント ハンドラー内に次のコードを挿入します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.MdiForm#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.MdiForm/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.ToolStrip.MdiForm#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.MdiForm/VB/Form1.vb#2)]  
+  
+## ツールボックスへの ToolStripPanel コントロールの追加  
+ MDI フォームで <xref:System.Windows.Forms.MenuStrip> コントロールを使用するときは、<xref:System.Windows.Forms.ToolStripPanel> コントロールが必要です。  MDI フォームを Windows フォーム デザイナー内でビルドするために、<xref:System.Windows.Forms.ToolStripPanel> コントロールを**ツールボックス**に追加する必要があります。  
+  
+#### ToolStripPanel コントロールをツールボックスに追加するには  
+  
+1.  **ツールボックス**を開き、**\[すべての Windows フォーム\]** タブをクリックすると、使用できる Windows フォーム コントロールが表示されます。  
+  
+2.  コントロールを右クリックしてショートカット メニューを開き、**\[アイテムの選択\]** をクリックします。  
+  
+3.  **\[ツールボックス アイテムの選択\]** ダイアログ ボックスで、**\[ToolStripPanel\]** が表示されるまで **\[名前\]** 列をスクロールします。  
+  
+4.  **\[ToolStripPanel\]** チェック ボックスをオンにし、**\[OK\]** をクリックします。  
+  
+     <xref:System.Windows.Forms.ToolStripPanel> コントロールが**ツールボックス**に表示されます。  
+  
+## 子フォームの作成  
+ この手順では、別個の <xref:System.Windows.Forms.MenuStrip> コントロールを持つ独立した子フォーム クラスを定義します。  このフォームのメニュー項目は、親フォームのメニュー項目にマージされます。  
+  
+#### 子フォームを定義するには  
+  
+1.  `ChildForm` という名前の新規フォームをプロジェクトに追加します。  
+  
+     詳細については、「[How to: Add Windows Forms to a Project](http://msdn.microsoft.com/ja-jp/3d7bb25f-fd90-47cf-9378-fa0d764686c1)」を参照してください。  
+  
+2.  **ツールボックス**から、子フォームに <xref:System.Windows.Forms.MenuStrip> コントロールをドラッグします。  
+  
+3.  <xref:System.Windows.Forms.MenuStrip> コントロールのスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックし、**\[項目の編集\]** を選択します。  
+  
+4.  **\[項目コレクション エディター\]** ダイアログ ボックスで、ChildMenuItem という名前の新しい <xref:System.Windows.Forms.ToolStripMenuItem> を子メニューに追加します。  
+  
+     詳細については、「[ToolStrip Items Collection Editor](http://msdn.microsoft.com/ja-jp/e681f3ab-94ba-4b2b-ac64-1dfad46caa25)」を参照してください。  
+  
+## フォームのテスト  
+  
+#### フォームをテストするには  
+  
+1.  F5 キーを押して、フォームをコンパイルおよび実行します。  
+  
+2.  **\[ウィンドウ\]** メニュー項目をクリックしてメニューを開き、**\[新規作成\]** をクリックします。  
+  
+     新規の子フォームが、フォームの MDI クライアント領域に作成されます。  子フォームのメニューが、メイン メニューにマージされます。  
+  
+3.  子フォームを閉じます。  
+  
+     子フォームのメニューは、メイン メニューから削除されます。  
+  
+4.  **\[新規作成\]** を数回クリックします。  
+  
+     <xref:System.Windows.Forms.MenuStrip> コントロールの <xref:System.Windows.Forms.MenuStrip.MdiWindowListItem%2A> プロパティが割り当てられるため、複数の子フォームが自動的に **\[ウィンドウ\]** メニュー項目の下に表示されます。  
+  
+## ToolStrip サポートの追加  
+ この手順では、4 つの <xref:System.Windows.Forms.ToolStrip> コントロールを MDI 親フォームに追加します。  各 <xref:System.Windows.Forms.ToolStrip> コントロールは <xref:System.Windows.Forms.ToolStripPanel> コントロール内に追加され、このコントロールがフォームの端にドッキングされます。  
+  
+#### ToolStrip コントロールを MDI 親フォームに追加するには  
+  
+1.  **ツールボックス**から、フォームに <xref:System.Windows.Forms.ToolStripPanel> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.ToolStripPanel> コントロールを選択した状態で、**ツールボックス**内の <xref:System.Windows.Forms.ToolStrip> コントロールをダブルクリックします。  
+  
+     <xref:System.Windows.Forms.ToolStrip> コントロールが、<xref:System.Windows.Forms.ToolStripPanel> コントロール内に作成されます。  
+  
+3.  <xref:System.Windows.Forms.ToolStripPanel> コントロールを選択します。  
+  
+4.  \[プロパティ\] ウィンドウで、コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に変更します。  
+  
+     <xref:System.Windows.Forms.ToolStripPanel> コントロールがフォームの左側、メイン メニューの下にドッキングされます。  MDI クライアント領域は、<xref:System.Windows.Forms.ToolStripPanel> コントロールが収まるサイズに変更されます。  
+  
+5.  手順 1. ～ 4. を繰り返します。  
+  
+     新しい <xref:System.Windows.Forms.ToolStripPanel> コントロールは、フォームの上部にドッキングされます。  
+  
+     <xref:System.Windows.Forms.ToolStripPanel> コントロールはメイン メニューの下にドッキングされますが、今回は最初の <xref:System.Windows.Forms.ToolStripPanel> コントロールの右側に配置されます。  この手順は、<xref:System.Windows.Forms.ToolStripPanel> コントロールを適切に配置する際の z オーダーの役割をよく示しています。  
+  
+6.  さらに 2 つの <xref:System.Windows.Forms.ToolStripPanel> コントロールについて、手順 1. ～ 4. を繰り返します。  
+  
+     新規の <xref:System.Windows.Forms.ToolStripPanel> コントロールは、フォームの右側の下部にドッキングされます。  
+  
+## z オーダーによる ToolStripPanel コントロールの並べ替え  
+ MDI フォームにドッキングされる <xref:System.Windows.Forms.ToolStripPanel> コントロールの位置は、z オーダーにおけるそのコントロールの位置によって決定されます。  コントロールの z オーダーは、\[ドキュメント アウトライン\] ウィンドウで簡単に設定できます。  
+  
+#### z オーダーに従って ToolStripPanel コントロールを並べ替えるには  
+  
+1.  **\[表示\]** メニューの **\[その他のウィンドウ\]** をクリックし、**\[ドキュメント アウトライン\]** をクリックします。  
+  
+     前の手順で使用した <xref:System.Windows.Forms.ToolStripPanel> コントロールの順序は、標準の順序ではありません。  これは、z オーダーが正しくないためです。  \[ドキュメント アウトライン\] ウィンドウを使って、コントロールの z オーダーを変更します。  
+  
+2.  \[ドキュメント アウトライン\] ウィンドウで、**\[ToolStripPanel4\]** を選択します。  
+  
+3.  **\[ToolStripPanel4\]** が一覧の最後に移動するまで、下向きの矢印ボタンを繰り返しクリックします。  
+  
+     **\[ToolStripPanel4\]** コントロールは、フォームの下部に、他のコントロールの下になる配置でドッキングされます。  
+  
+4.  **\[ToolStripPanel2\]** を選択します。  
+  
+5.  下向き矢印ボタンを 1 度クリックして、リストで 3 番目のコントロールの位置を指定します。  
+  
+     **\[ToolStripPanel2\]** コントロールは、フォームの上部に、メイン メニューの下で他のコントロールの上になる配置でドッキングされます。  
+  
+6.  さまざまなコントロールを **\[ドキュメント アウトライン\]** ウィンドウで選択し、z オーダーの異なる位置に移動します。  z オーダーに従って、ドッキングされたコントロールの配置が変わることを確認してください。  Ctrl キーを押しながら Z キーを押すか、**\[編集\]** メニューの **\[元に戻す\]** をクリックすると、変更は元に戻ります。  
+  
+## チェックポイント  
+  
+#### フォームをテストするには  
+  
+1.  F5 キーを押して、フォームをコンパイルおよび実行します。  
+  
+2.  <xref:System.Windows.Forms.ToolStrip> コントロールのグリップをクリックし、コントロールをフォームの異なる位置へドラッグします。  
+  
+     <xref:System.Windows.Forms.ToolStrip> コントロールをある <xref:System.Windows.Forms.ToolStripPanel> コントロールからドラッグして別のコントロールへ移動できます。  
+  
+## 次の手順  
+ このチュートリアルでは、<xref:System.Windows.Forms.ToolStrip> コントロールとメニューのマージ機能を備えた MDI 親フォームを作成しました。  <xref:System.Windows.Forms.ToolStrip> 系コントロールの用途は、他にもたくさんあります。  
+  
+-   <xref:System.Windows.Forms.ContextMenuStrip> を使って、コントロールにショートカット メニューを作成します。  詳細については、「[ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)」を参照してください。  
+  
+-   標準メニューに自動的に項目が設定されるフォームを作成します。  詳細については、「[チュートリアル : 標準メニュー項目をフォームに用意する](../../../../docs/framework/winforms/controls/walkthrough-providing-standard-menu-items-to-a-form.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> コントロールにプロフェッショナルな外観を与えます。  詳細については、「[方法 : アプリケーションの ToolStrip レンダラーを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-for-an-application.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [方法 : MDI 親フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-parent-forms.md)   
+ [方法 : MDI 子フォームを作成する](../../../../docs/framework/winforms/advanced/how-to-create-mdi-child-forms.md)   
+ [方法 : MDI ドロップダウン メニューに MenuStrip を挿入する](../../../../docs/framework/winforms/controls/how-to-insert-a-menustrip-into-an-mdi-drop-down-menu-windows-forms.md)   
+ [ToolStrip コントロール](../../../../docs/framework/winforms/controls/toolstrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..e7b97fca9af
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-creating-an-unbound-windows-forms-datagridview-control.md
@@ -0,0 +1,105 @@
+---
+title: "チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 表示 (データ ソースにバインドせずに)"
+  - "データ [Windows フォーム], バインドされていない"
+  - "DataGridView コントロール [Windows フォーム], 表示 (データ ソースにバインドせずにデータを)"
+  - "DataGridView コントロール [Windows フォーム], バインドされていないデータ"
+  - "チュートリアル [Windows フォーム], DataGridView コントロール"
+ms.assetid: 5a8d6afa-1b4b-4b24-8db8-501086ffdebe
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# チュートリアル : バインドされていない Windows フォーム DataGridView コントロールの作成
+データベースから取得したものではないデータを表形式で表示しなければならない場合はよくあります。  たとえば、文字列の 2 次元配列の内容を表示する場合などです。  <xref:System.Windows.Forms.DataGridView> クラスは、データ ソースにバインドせずにデータを表示するための、簡単で高度にカスタマイズ可能な手段となります。  このチュートリアルでは、<xref:System.Windows.Forms.DataGridView> コントロールのデータを手動で作成し、行の追加と削除を非バインド モードで管理する方法を示します。  既定では、ユーザーが新しい行を追加できます。  行の追加を防ぐには、<xref:System.Windows.Forms.DataGridView.AllowUserToAddRows%2A> プロパティを `false` に設定します。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## フォームの作成  
+  
+#### バインドされていない DataGridView コントロールを使用するには  
+  
+1.  <xref:System.Windows.Forms.Form> から派生したクラスを作成し、次の変数宣言と `Main` メソッドを含めます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#01](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#01)]
+     [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#01](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#01)]  
+    [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#02](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#02)]
+    [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#02](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#02)]  
+  
+2.  フォームのクラス定義の中に、フォームのレイアウトをセットアップするための `SetupLayout` メソッドを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#20)]  
+  
+3.  <xref:System.Windows.Forms.DataGridView> の列とプロパティをセットアップするための `SetupDataGridView` メソッドを作成します。  
+  
+     このメソッドでは、まず <xref:System.Windows.Forms.DataGridView> コントロールをフォームの <xref:System.Windows.Forms.Control.Controls%2A> コレクションに追加します。  次に、<xref:System.Windows.Forms.DataGridView.ColumnCount%2A> プロパティを使用して、表示する列の数を設定します。  さらに、列ヘッダーの既定のスタイルを設定するために、<xref:System.Windows.Forms.DataGridView.ColumnHeadersDefaultCellStyle%2A> プロパティによって返される <xref:System.Windows.Forms.DataGridViewCellStyle> の <xref:System.Windows.Forms.DataGridViewCellStyle.BackColor%2A>、<xref:System.Windows.Forms.DataGridViewCellStyle.ForeColor%2A>、および <xref:System.Windows.Forms.DataGridViewCellStyle.Font%2A> プロパティを設定します。  
+  
+     レイアウトと外観に関するプロパティを設定したら、次は列名を割り当てます。  このメソッドが終了すると、<xref:System.Windows.Forms.DataGridView> コントロールにデータを追加できる状態になります。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#30)]
+     [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#30)]  
+  
+4.  <xref:System.Windows.Forms.DataGridView> コントロールに行を追加するための `PopulateDataGridView` メソッドを作成します。  
+  
+     各行は、歌とその関連情報を表しています。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#40](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#40)]
+     [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#40](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#40)]  
+  
+5.  ユーティリティ メソッドを定義したら、次はイベント ハンドラーを追加します。  
+  
+     **\[Add\]** ボタンと **\[Delete\]** ボタンの <xref:System.Windows.Forms.Control.Click> イベント、フォームの <xref:System.Windows.Forms.Form.Load> イベント、さらに <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントを処理します。  
+  
+     **\[Add\]** ボタンの <xref:System.Windows.Forms.Control.Click> イベントが発生したときは、新しい空の行を <xref:System.Windows.Forms.DataGridView> に追加します。  
+  
+     **\[Delete\]** ボタンの <xref:System.Windows.Forms.Control.Click> イベントが発生したときは、選択中の行が新規レコード用の行 \(ユーザーが新しい行を追加するときに使用\) でない限り、選択中の行を削除します。  この行は、必ず <xref:System.Windows.Forms.DataGridView> コントロールの最後の行になります。  
+  
+     フォームの <xref:System.Windows.Forms.Form.Load> イベントが発生したときは、`SetupLayout`、`SetupDataGridView`、`PopulateDataGridView` というユーティリティ メソッドを呼び出します。  
+  
+     <xref:System.Windows.Forms.DataGridView.CellFormatting> イベントが発生したときは、`Date` 列の各セルを長い形式の日付に書式設定します \(セルの値が解析できない場合を除く\)。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewSimpleUnbound#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/CS/simpleunbound.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewSimpleUnbound#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewSimpleUnbound/VB/simpleunbound.vb#10)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   F5 キーを押してアプリケーションを実行します。  
+  
+     `PopulateDataGridView` 内で指定した歌の一覧を含む <xref:System.Windows.Forms.DataGridView> コントロールが表示されます。  **\[Add Row\]** ボタンをクリックすると新しい行を追加でき、**\[Delete Row\]** ボタンをクリックすると選択中の行を削除できます。  このバインドされていない <xref:System.Windows.Forms.DataGridView> コントロールはそれ自体がデータ ストアであり、このデータは <xref:System.Data.DataSet> や配列などの外部ソースに依存していません。  
+  
+## 次の手順  
+ このアプリケーションでは、<xref:System.Windows.Forms.DataGridView> コントロールの機能について基本を理解できます。  次のような方法を使用すると、<xref:System.Windows.Forms.DataGridView> コントロールの外観および動作をカスタマイズできます。  
+  
+-   輪郭およびヘッダー スタイルを変更します。  詳細については、「[方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力の許可または制限。  詳細については、「[方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)」および「[方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   ユーザー入力に対するデータベース関連エラーの検査。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)」を参照してください。  
+  
+-   仮想モードを使用した大量のデータの処理。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+-   セルの外観をカスタマイズします。  詳細については、「[方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)」および「[方法 : Windows フォーム DataGridView コントロールの既定のセル スタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-default-cell-styles-for-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ [Windows フォーム DataGridView コントロールでのデータの表示](../../../../docs/framework/winforms/controls/displaying-data-in-the-windows-forms-datagridview-control.md)   
+ [方法 : 連結されていない Windows フォーム DataGridView コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-unbound-windows-forms-datagridview-control.md)   
+ [Windows フォーム DataGridView コントロールでのデータ表示モード](../../../../docs/framework/winforms/controls/data-display-modes-in-the-windows-forms-datagridview-control.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md b/docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md
new file mode 100644
index 00000000000..43d42dc80eb
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-debugging-custom-windows-forms-controls-at-design-time.md
@@ -0,0 +1,184 @@
+---
+title: "チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], デバッグ"
+  - "カスタム コントロール [Windows フォーム], デバッグ"
+  - "カスタム コントロール [Windows フォーム], チュートリアル"
+  - "デバッグ [Visual Studio], チュートリアル"
+  - "デバッグ [Visual Studio], Windows フォーム"
+  - "デザイナー"
+  - "デザイン時デバッグ"
+  - "ビジュアル エディター"
+  - "チュートリアル [Windows フォーム], デバッグ"
+ms.assetid: 1fd83ccd-3798-42fc-85a3-6cba99467387
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# チュートリアル : カスタム Windows フォーム コントロールのデザイン時のデバッグ
+カスタム コントロールを作成したときは、多くの場合、デザイン時動作のデバッグが必要になります。  特にカスタム コントロール用のカスタム デザイナーを作成した場合は、このようなデバッグが不可欠です。  詳細については、「[チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](../../../../docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md)」を参照してください。  
+  
+ カスタム コントロールは、他の .NET Framework クラスの場合と同じように Visual Studio を使用してデバッグできます。  ただし、カスタム コントロールの場合は、そのコードを実行する Visual Studio の別個のインスタンスをデバッグするという点が異なります。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   カスタム コントロールをホストする Windows フォーム プロジェクトの作成  
+  
+-   コントロール ライブラリ プロジェクトの作成  
+  
+-   カスタム コントロールへのプロパティの追加  
+  
+-   ホスト フォームへのカスタム コントロールの追加  
+  
+-   デザイン時デバッグのためのプロジェクト設定  
+  
+-   カスタム コントロールのデザイン時のデバッグ  
+  
+ ここでは、カスタム コントロールのデザイン時の動作のデバッグに必要なタスクについて理解します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にアプリケーション プロジェクトを作成します。  このプロジェクトを使用して、カスタム コントロールをホストするアプリケーションをビルドします。  
+  
+#### プロジェクトを作成するには  
+  
+-   "DebuggingExample" という名前の Windows アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+## コントロール ライブラリ プロジェクトの作成  
+ 次に、コントロール ライブラリ プロジェクトを作成し、カスタム コントロールを設定します。  
+  
+#### コントロール ライブラリ プロジェクトを作成するには  
+  
+1.  **Windows コントロール ライブラリ** プロジェクトをソリューションに追加します。  
+  
+2.  新しい **UserControl** アイテムを DebugControlLibrary プロジェクトに追加します。  詳細については、「[NIB:How to: Add New Project Items](http://msdn.microsoft.com/ja-jp/63d3e16b-de6e-4bb5-a0e3-ecec762201ce)」を参照してください。  新しいソース ファイルに、"DebugControl" という基本名を付けます。  
+  
+3.  **ソリューション エクスプローラー**を使用して、"`UserControl1`" という基本名のコード ファイルを削除することにより、プロジェクトの既定のコントロールを削除します。  詳細については、「[NIB:How to: Remove, Delete, and Exclude Items](http://msdn.microsoft.com/ja-jp/6dffdc86-29c8-4eff-bcd8-e3a0dd9e9a73)」を参照してください。  
+  
+4.  ソリューションをビルドします。  
+  
+## チェックポイント  
+ この時点で、カスタム コントロールが**ツールボックス**に表示されます。  
+  
+#### 進行状況を確認するには  
+  
+-   **\[DebugControlLibrary コンポーネント\]** という新しいタブを見つけ、クリックして選択します。  開いたタブには、コントロールが **\[DebugControl\]** としてリストされ、その横に既定のアイコンが表示されます。  
+  
+## カスタム コントロールへのプロパティの追加  
+ カスタム コントロールのコードがデザイン時に動作することを示すために、プロパティを追加し、そのプロパティを実装するコードにブレークポイントを設定します。  
+  
+#### カスタム コントロールにプロパティを追加するには  
+  
+1.  **コード エディター**で **\[DebugControl\]** を開きます。  次のコードをクラス定義に追加します。  
+  
+    ```vb  
+    Private demoStringValue As String = Nothing  
+    <BrowsableAttribute(true)>  
+    Public Property DemoString() As String  
+  
+        Get  
+            Return Me.demoStringValue  
+        End Get  
+  
+        Set(ByVal value As String)  
+            Me.demoStringValue = value  
+        End Set  
+  
+    End Property  
+    ```  
+  
+    ```csharp  
+    private string demoStringValue = null;  
+    [Browsable(true)]  
+    public string DemoString  
+    {  
+        get  
+        {  
+            return this.demoStringValue;  
+        }  
+        set  
+        {  
+            demoStringValue = value;  
+        }  
+    }  
+    ```  
+  
+2.  ソリューションをビルドします。  
+  
+## ホスト フォームへのカスタム コントロールの追加  
+ カスタム コントロールのデザイン時動作をデバッグするには、カスタム コントロール クラスのインスタンスをホスト フォームに配置します。  
+  
+#### ホスト フォームにカスタム コントロールを追加するには  
+  
+1.  "DebuggingExample" プロジェクトの Form1 を **Windows フォーム デザイナー**で開きます。  
+  
+2.  **\[ツールボックス\]** の **\[DebugControlLibrary コンポーネント\]** タブを開き、**\[DebugControl\]** インスタンスをフォームにドラッグします。  
+  
+3.  **\[プロパティ\]** ウィンドウで `DemoString` カスタム プロパティを見つけます。  このプロパティの値は、他のプロパティと同じように変更できます。  また、`DemoString` プロパティを選択すると、**\[プロパティ\]** ウィンドウの下部にプロパティの説明文字列が表示されます。  
+  
+## デザイン時デバッグのためのプロジェクト設定  
+ カスタム コントロールのデザイン時動作をデバッグするには、カスタム コントロールのコードを実行する Visual Studio の別個のインスタンスをデバッグします。  
+  
+#### デザイン時デバッグのためにプロジェクトを設定するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[DebugControlLibrary\]** プロジェクトを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+2.  **DebugControlLibrary** プロパティ シートの **\[デバッグ\]** タブをクリックします。  
+  
+     **\[開始動作\]** セクションで、**\[外部プログラムの開始\]** を選択します。  Visual Studio の別個のインスタンスをデバッグするので、省略記号 \(![VisualStudioEllipsesButton スクリーンショット](../../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) ボタンをクリックして、Visual Studio IDE を参照します。  実行可能ファイルの名前は **devenv.exe** で、既定の場所にインストールした場合、ファイルのパスは "%programfiles%\\Microsoft Visual Studio 9.0\\Common7\\IDE\\devenv.exe" になります。  
+  
+3.  **\[OK\]** をクリックし、ダイアログ ボックスを閉じます。  
+  
+4.  **\[DebugControlLibrary\]** プロジェクトを右クリックし、**\[スタートアップ プロジェクトに設定\]** をクリックして、このデバッグ構成を有効にします。  
+  
+## カスタム コントロールのデザイン時のデバッグ  
+ これで、カスタム コントロールをデザイン モードで実行しながらデバッグする準備ができました。  デバッグ セッションを開始すると、Visual Studio の新しいインスタンスが作成され、それを使って "DebuggingExample" ソリューションを読み込みます。  **フォーム デザイナー**で Form1 を開くと、カスタム コントロールのインスタンスが作成され、実行を開始します。  
+  
+#### カスタム コントロールをデザイン時にデバッグするには  
+  
+1.  **コード エディター**で **\[DebugControl\]** ソース ファイルを開き、`DemoString` プロパティの `Set` アクセサーにブレークポイントを配置します。  
+  
+2.  F5 キーを押してデバッグ セッションを開始します。  Visual Studio の新しいインスタンスが作成されることを確認してください。  各インスタンスは、次の 2 つの方法で識別できます。  
+  
+    -   デバッグ インスタンスのタイトル バーには、"**実行中**" という単語が表示されます。  
+  
+    -   デバッグ インスタンスの **\[デバッグ\]** ツール バーの **\[開始\]** ボタンは無効になります。  
+  
+     デバッグ インスタンスにブレークポイントが設定されます。  
+  
+3.  Visual Studio の新しいインスタンスで、"DebuggingExample" ソリューションを開きます。  **\[ファイル\]** メニューの **\[最近使ったプロジェクト\]** をクリックすると、ソリューションが簡単に見つかります。  "DebuggingExample.sln" ソリューション ファイルが、最後に使用したファイルとして表示されます。  
+  
+4.  **フォーム デザイナー**で Form1 を開き、**\[DebugControl\]** コントロールを選択します。  
+  
+5.  `DemoString` プロパティの値を変更します。  変更をコミットすると、Visual Studio のデバッグ インスタンスがフォーカスを取得し、ブレークポイントで実行が停止します。  プロパティ アクセサーは、他のコードと同じようにシングル ステップ実行できます。  
+  
+6.  デバッグ セッションが終了したら、Visual Studio のホスト インスタンスを閉じるか、デバッグ インスタンスの **\[デバッグの停止\]** をクリックして終了できます。  
+  
+## 次の手順  
+ これで、カスタム コントロールをデザイン時にデバッグできるようになりました。この後は、コントロールと Visual Studio IDE の対話をさまざまな方法で拡張できます。  
+  
+-   <xref:System.ComponentModel.Component> クラスの <xref:System.ComponentModel.Component.DesignMode%2A> プロパティを使用して、デザイン時にのみ動作するコードを記述できます。  詳細については、「<xref:System.ComponentModel.Component.DesignMode%2A>」を参照してください。  
+  
+-   カスタム コントロールとデザイナーの対話を操作するために、コントロールのプロパティに適用できる属性がいくつかあります。  これらの属性は、<xref:System.ComponentModel?displayProperty=fullName> 名前空間に含まれています。  
+  
+-   カスタム コントロール用のカスタム デザイナーを作成できます。  これにより、Visual Studio によって公開されている拡張性のあるデザイナー インフラストラクチャを使用して、デザイン手順を全面的に制御できます。  詳細については、「[チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](../../../../docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md)」を参照してください。  
+  
+## 参照  
+ [チュートリアル : Visual Studio のデザイン時機能を活用した Windows フォーム コントロールの作成](../../../../docs/framework/winforms/controls/creating-a-wf-control-design-time-features.md)   
+ [How to: Access Design\-Time Services](../Topic/How%20to:%20Access%20Design-Time%20Services.md)   
+ [How to: Access Design\-Time Support in Windows Forms](../Topic/How%20to:%20Access%20Design-Time%20Support%20in%20Windows%20Forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-implementing-a-form-that-uses-a-background-operation.md b/docs/framework/winforms/controls/walkthrough-implementing-a-form-that-uses-a-background-operation.md
new file mode 100644
index 00000000000..3da8016e45c
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-implementing-a-form-that-uses-a-background-operation.md
@@ -0,0 +1,178 @@
+---
+title: "チュートリアル : バックグラウンド操作を使用するフォームの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "BackgroundWorker コンポーネント"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+  - "スレッド処理 [Windows フォーム], フォーム"
+  - "スレッド処理 [Windows フォーム], チュートリアル"
+ms.assetid: 4691b796-9200-471a-89c3-ba4c7cc78c03
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# チュートリアル : バックグラウンド操作を使用するフォームの実装
+完了するまで時間がかかる操作があり、操作中にユーザー インターフェイス \(UI\) が応答を停止 \(つまり "ハングアップ"\) しないようにするには、<xref:System.ComponentModel.BackgroundWorker> クラスを使用して操作を別のスレッドで実行できます。  
+  
+ このチュートリアルでは、<xref:System.ComponentModel.BackgroundWorker> クラスを使用して、時間のかかる計算を "バックグラウンドで" 実行しながら、ユーザー インターフェイスの応答性を維持する方法について説明します。  ここでは、フィボナッチの数列を非同期的に計算するアプリケーションを作成します。  大きなフィボナッチ数の計算には、著しく時間がかかることがありますが、メイン UI スレッドは、この遅延によって中断されず、計算の間、フォームは応答性を維持します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows ベース アプリケーションの作成  
+  
+-   フォームでの <xref:System.ComponentModel.BackgroundWorker> の作成  
+  
+-   非同期イベント ハンドラーの追加  
+  
+-   進行状況の報告機能とキャンセルのサポートの追加  
+  
+ この例で使用するコードの完全な一覧については、「[方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### バックグラウンド操作を使用するフォームを作成するには  
+  
+1.  `BackgroundWorkerExample` という名前の Windows ベース アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **ソリューション エクスプローラー**で、**\[Form1\]** を右クリックし、ショートカット メニューの **\[名前の変更\]** をクリックします。  ファイル名を `FibonacciCalculator` に変更します。  コード要素 "`Form1`" へのすべての参照の名前を変更するかどうかを確認するダイアログ ボックスが表示されたら、**\[はい\]** をクリックします。  
+  
+3.  **\[ツールボックス\]** の <xref:System.Windows.Forms.NumericUpDown> コントロールをフォームにドラッグします。  <xref:System.Windows.Forms.NumericUpDown.Minimum%2A> プロパティを `1`、<xref:System.Windows.Forms.NumericUpDown.Maximum%2A> プロパティを `91` に設定します。  
+  
+4.  2 つの <xref:System.Windows.Forms.Button> コントロールをフォームに追加します。  
+  
+5.  一方の <xref:System.Windows.Forms.Button> コントロールの名前を `startAsyncButton` に変更し、<xref:System.Windows.Forms.Control.Text%2A> プロパティを `Start Async` に設定します。  もう一方の <xref:System.Windows.Forms.Button> コントロールの名前を `cancelAsyncButton` に変更し、<xref:System.Windows.Forms.Control.Text%2A> プロパティを `Cancel Async` に設定します。  <xref:System.Windows.Forms.Control.Enabled%2A> プロパティを `false` に設定します。  
+  
+6.  両方の <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントに対するイベント ハンドラーを作成します。  詳細については、「[How to: Create Event Handlers Using the Designer](http://msdn.microsoft.com/ja-jp/8461e9b8-14e8-406f-936e-3726732b23d2)」を参照してください。  
+  
+7.  **\[ツールボックス\]** の <xref:System.Windows.Forms.Label> コントロールをフォームにドラッグし、名前を `resultLabel` に変更します。  
+  
+8.  **\[ツールボックス\]** の <xref:System.Windows.Forms.ProgressBar> コントロールをフォームにドラッグします。  
+  
+## フォームでの BackgroundWorker の作成  
+ 非同期操作用の <xref:System.ComponentModel.BackgroundWorker> は、**Windows** **フォーム デザイナー** を使用して作成できます。  
+  
+#### デザイナーを使用して BackgroundWorker を作成するには  
+  
+-   **\[ツールボックス\]** の **\[コンポーネント\]** タブから、<xref:System.ComponentModel.BackgroundWorker> をフォームにドラッグします。  
+  
+## 非同期イベント ハンドラーの追加  
+ 以上で、<xref:System.ComponentModel.BackgroundWorker> コンポーネントの非同期イベント用のイベント ハンドラーを追加する準備ができました。  バックグラウンドで実行する、時間のかかるフィボナッチ数列の計算操作は、これらのうちいずれかのイベント ハンドラーによって呼び出されます。  
+  
+#### 非同期イベント ハンドラーを実装するには  
+  
+1.  **\[プロパティ\]** ウィンドウで <xref:System.ComponentModel.BackgroundWorker> コンポーネントが選択されている状態で、**\[イベント\]** ボタンをクリックします。  <xref:System.ComponentModel.BackgroundWorker.DoWork> イベントと <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントをダブルクリックして、イベント ハンドラーを作成します。  イベント ハンドラーの使用方法の詳細については、「[How to: Create Event Handlers Using the Designer](http://msdn.microsoft.com/ja-jp/8461e9b8-14e8-406f-936e-3726732b23d2)」を参照してください。  
+  
+2.  フォームで `ComputeFibonacci` という名前の新しいメソッドを作成します。  このメソッドが実際の操作を実行し、バックグラウンドで動作します。  このコードは、フィボナッチ アルゴリズムの反復実装を示しています。これは、著しく非効率な操作で、数が大きくなるにつれて、完了するまでにかかる時間が急激に長くなります。  アプリケーションで大きな遅延が発生する操作の例として、このコードを使用します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#10](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#10)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#10)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#10)]  
+  
+3.  <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーで、`ComputeFibonacci` メソッドの呼び出しを追加します。  `ComputeFibonacci` の最初のパラメーターを、<xref:System.ComponentModel.DoWorkEventArgs> の <xref:System.ComponentModel.DoWorkEventArgs.Argument%2A> プロパティから受け取ります。  <xref:System.ComponentModel.BackgroundWorker> パラメーターと <xref:System.ComponentModel.DoWorkEventArgs> パラメーターは、進行状況の報告機能とキャンセルのサポートのために後で使用します。  `ComputeFibonacci` の戻り値を <xref:System.ComponentModel.DoWorkEventArgs> の <xref:System.ComponentModel.DoWorkEventArgs.Result%2A> プロパティに代入します。  この結果は、<xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーで利用できるようになります。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーは、`backgroundWorker1` インスタンス変数を直接参照しません。直接参照すると、このイベント ハンドラーが <xref:System.ComponentModel.BackgroundWorker> の特定のインスタンスに結合されるためです。  代わりに、該当するイベントを生成した <xref:System.ComponentModel.BackgroundWorker> への参照は、`sender` パラメーターから復元します。  このことは、フォームが複数の <xref:System.ComponentModel.BackgroundWorker> をホストする場合に重要です。  また、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーでユーザー インターフェイス オブジェクトを操作しないようにしてください。  代わりに、<xref:System.ComponentModel.BackgroundWorker> のイベントを通じてユーザー インターフェイスと通信します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#5)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#5)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#5)]  
+  
+4.  `startAsyncButton` コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで、非同期操作を開始するコードを追加します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#13](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#13)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#13](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#13)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#13](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#13)]  
+  
+5.  <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーで、`resultLabel` コントロールに計算結果を代入します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#6](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#6)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#6)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#6)]  
+  
+## 進行状況の報告機能とキャンセルのサポートの追加  
+ 時間のかかる非同期操作では、進行状況をユーザーに報告し、ユーザーが操作をキャンセルできるようにすることが望まれます。  <xref:System.ComponentModel.BackgroundWorker> クラスには、バックグラウンド操作の進行状況を報告できるイベントが用意されています。  また、ワーカー コードで <xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> の呼び出しを検出し、ワーカー コード自体を中断できるようにするフラグも使用できます。  
+  
+#### 進行状況の報告機能を実装するには  
+  
+1.  **\[プロパティ\]** ウィンドウで `backgroundWorker1` を選択します。  <xref:System.ComponentModel.BackgroundWorker.WorkerReportsProgress%2A> プロパティと <xref:System.ComponentModel.BackgroundWorker.WorkerSupportsCancellation%2A> プロパティを `true` に設定します。  
+  
+2.  `FibonacciCalculator` フォームで 2 つの変数を宣言します。  これらの変数を使用して、進行状況を追跡します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#14](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#14)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#14](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#14)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#14](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#14)]  
+  
+3.  <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベントのイベント ハンドラーを追加します。  <xref:System.ComponentModel.BackgroundWorker.ProgressChanged> イベント ハンドラーで、<xref:System.ComponentModel.ProgressChangedEventArgs> パラメーターの <xref:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage%2A> プロパティを使用して、<xref:System.Windows.Forms.ProgressBar> を更新します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#7](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#7)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#7)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#7)]  
+  
+#### キャンセルのサポートを実装するには  
+  
+1.  `cancelAsyncButton` コントロールの <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで、非同期操作をキャンセルするコードを追加します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#4](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#4)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#4)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#4)]  
+  
+2.  進行状況を報告し、キャンセルをサポートする `ComputeFibonacci` メソッドのコード片を次に示します。  
+  
+     [!code-cpp[System.ComponentModel.BackgroundWorker#11](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#11)]
+     [!code-csharp[System.ComponentModel.BackgroundWorker#11](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#11)]
+     [!code-vb[System.ComponentModel.BackgroundWorker#11](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#11)]  
+    [!code-cpp[System.ComponentModel.BackgroundWorker#12](../../../../samples/snippets/cpp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CPP/fibonacciform.cpp#12)]
+    [!code-csharp[System.ComponentModel.BackgroundWorker#12](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/CS/fibonacciform.cs#12)]
+    [!code-vb[System.ComponentModel.BackgroundWorker#12](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb#12)]  
+  
+## チェックポイント  
+ この時点で、フィボナッチ電卓アプリケーションをコンパイルして実行できます。  
+  
+#### プロジェクトをテストするには  
+  
+-   F5 キーを押してアプリケーションをコンパイルおよび実行します。  
+  
+     計算がバックグラウンドで実行されている間、計算が完了するまでの進行状況が <xref:System.Windows.Forms.ProgressBar> に表示されます。  また、保留中の操作をキャンセルすることもできます。  
+  
+     小さい数の場合は計算に時間がかかりませんが、大きい数の場合は著しい遅延が生じます。  30 以上の値を入力した場合、コンピューターの処理速度によっては、数秒間の遅延が生じます。  値が 40 以上の場合は、計算が終了するまでに数分から数時間かかることがあります。  電卓が大きなフィボナッチ数を計算している間でも、フォームを自由に移動したり、拡大縮小したり、閉じたりすることもできるます。  これは、メイン UI スレッドが、計算の終了を待機していないからです。  
+  
+## 次の手順  
+ これで、バックグラウンドで計算を実行する <xref:System.ComponentModel.BackgroundWorker> コンポーネントを使用するフォームを実装できました。この後は、次のような非同期操作の他の可能性を検討してください。  
+  
+-   複数の <xref:System.ComponentModel.BackgroundWorker> オブジェクトを使用して、複数の同時操作を実行する。  
+  
+-   マルチスレッド アプリケーションをデバッグするには、「[方法 : \[スレッド\] ウィンドウを使用する](../Topic/How%20to:%20Use%20the%20Threads%20Window.md)」を参照してください。  
+  
+-   非同期プログラミング モデルをサポートする独自のコンポーネントを実装する。  詳細については、「[Event\-based Asynchronous Pattern Overview](../../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)」を参照してください。  
+  
+    > [!CAUTION]
+    >  どのような種類のマルチスレッドを使用している場合でも、非常に深刻で複雑なバグを引き起こしてしまう可能性があります。  マルチスレッドを使用するソリューションを実装する前に、「[Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [Managed Threading Best Practices](../../../../docs/standard/threading/managed-threading-best-practices.md)   
+ [コンポーネントのマルチスレッド](../Topic/Multithreading%20in%20Components.md)   
+ [NOT IN BUILD: Multithreading in Visual Basic](http://msdn.microsoft.com/ja-jp/c731a50c-09c1-4468-9646-54c86b75d269)   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [チュートリアル : 操作をバックグラウンドで実行する](../../../../docs/framework/winforms/controls/walkthrough-running-an-operation-in-the-background.md)   
+ [BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md b/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md
new file mode 100644
index 00000000000..3329d5b0683
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-basic.md
@@ -0,0 +1,165 @@
+---
+title: "チュートリアル : Visual Basic による Windows フォーム コントロールからの継承 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 継承"
+  - "継承, control"
+  - "継承, カスタム コントロール"
+  - "継承, チュートリアル"
+  - "Windows フォーム コントロール, 継承"
+ms.assetid: fb58d7c8-b702-4478-ad31-b00cae118882
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# チュートリアル : Visual Basic による Windows フォーム コントロールからの継承
+[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では、*継承*によって強力なカスタム コントロールを作成できます。  継承を使用すると、標準の Windows フォーム コントロールの固有の機能をすべて保持しながら、カスタム機能も組み込んだコントロールを作成できます。  このチュートリアルでは、`ValueButton` という名前の簡単な継承コントロールを作成します。  このボタンは、標準の Windows フォーム <xref:System.Windows.Forms.Button> コントロールの機能を継承し、`ButtonValue` というカスタム プロパティを公開します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 新しいプロジェクトを作成するときには、その名前を指定することにより、ルート名前空間、アセンブリ名、およびプロジェクト名を設定し、既定のコンポーネントが正しい名前空間に含まれるようにします。  
+  
+#### ValueButtonLib コントロール ライブラリおよび ValueButton コントロールを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックして **\[新しいプロジェクト\]** ダイアログ ボックスを開きます。  
+  
+2.  \[[!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] プロジェクト\] ボックスの一覧の **\[Windows フォーム コントロール ライブラリ\]** プロジェクト テンプレートを選択し、**\[プロジェクト名\]** ボックスに「`ValueButtonLib`」と入力します。  
+  
+     プロジェクト名 `ValueButtonLib` は、既定でルート名前空間にも割り当てられます。  ルート名前空間は、アセンブリ内のコンポーネント名の修飾に使用されます。  たとえば、`ValueButton` という名前のコンポーネントが 2 つのアセンブリに含まれる場合は、`ValueButtonLib.ValueButton` という形で目的の `ValueButton` コンポーネントを指定できます。  詳細については、「[Visual Basic における名前空間](../Topic/Namespaces%20in%20Visual%20Basic.md)」を参照してください。  
+  
+3.  **ソリューション エクスプローラー**で、**\[UserControl1.vb\]** を右クリックし、ショートカット メニューの **\[名前の変更\]** をクリックします。  ファイル名を「`ValueButton.vb`」に変更します。  コード要素 "UserControl1" へのすべての参照の名前を変更するかどうかを確認するダイアログ ボックスが表示されたら、**\[はい\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**の **\[すべてのファイルを表示\]** をクリックします。  
+  
+5.  **\[ValueButton.vb\]** ノードを開き、デザイナー生成のコード ファイルである **ValueButton.Designer.vb** を表示します。  **コード エディター**でこのファイルを開きます。  
+  
+6.  `Class` ステートメント、`Partial Public Class ValueButton` を検索し、このコントロールが継承した型を <xref:System.Windows.Forms.UserControl> から <xref:System.Windows.Forms.Button> に変更します。  これによって、継承されたコントロールは <xref:System.Windows.Forms.Button> コントロールのすべての機能を継承できます。  
+  
+7.  `InitializeComponent` メソッドを見つけ、<xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A> プロパティを割り当てる行を削除します。  このプロパティは、<xref:System.Windows.Forms.Button> コントロールには存在しません。  
+  
+8.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックしてプロジェクトを保存します。  
+  
+     ビジュアル デザイナーは使用できなくなりました。  <xref:System.Windows.Forms.Button> コントロールは独自の描画を実行するため、デザイナーでは表示を変更できません。  ビジュアル表示は、コードで変更しない限り、継承元のクラス \(つまり、<xref:System.Windows.Forms.Button>\) とまったく同じです。  
+  
+> [!NOTE]
+>  UI 要素のないコンポーネントをデザイン サーフェイスに追加することはできます。  
+  
+## 継承したコントロールへのプロパティの追加  
+ 継承した Windows フォーム コントロールの可能な用途の 1 つとして、標準の Windows フォーム コントロールと同じ外観と操作性を持ちながらカスタム プロパティを公開するコントロールを作成できます。  ここでは、コントロールに `ButtonValue` という名前のプロパティを追加します。  
+  
+#### Value プロパティを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[ValueButton.vb\]** を右クリックし、ショートカット メニューの **\[コードの表示\]** をクリックします。  
+  
+2.  `Public Class ValueButton` ステートメントを探します。  このステートメントの直後に、次のコードを追加します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    ' Creates the private variable that will store the value of your   
+    ' property.  
+    Private varValue as integer  
+    ' Declares the property.  
+    Property ButtonValue() as Integer  
+    ' Sets the method for retrieving the value of your property.  
+       Get  
+          Return varValue  
+       End Get  
+    ' Sets the method for setting the value of your property.  
+       Set(ByVal Value as Integer)  
+          varValue = Value  
+       End Set  
+    End Property  
+    ```  
+  
+     このコードは、`ButtonValue` プロパティの格納方法と取得方法を設定します。  `Get` ステートメントは、返された値をプライベート変数 `varValue` に格納されている値に設定します。`Set` ステートメントは、`Value` キーワードを使用してプライベート変数の値を設定します。  
+  
+3.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックしてプロジェクトを保存します。  
+  
+## コントロールのテスト  
+ コントロールはスタンドアロン プロジェクトではないため、コンテナーでホストする必要があります。  コントロールをテストするには、コントロールを実行するテスト プロジェクトを指定する必要があります。  また、コントロールをビルド \(コンパイル\) してテスト プロジェクトからもアクセスできるようにする必要があります。  ここでは、コントロールを作成し、Windows フォームでそのコントロールをテストします。  
+  
+#### コントロールをビルドするには  
+  
+1.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+     ビルドは、コンパイル エラーも警告もなしに完了します。  
+  
+#### テスト プロジェクトを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[追加\]** をポイントし、**\[新しいプロジェクト\]** をクリックして **\[新しいプロジェクトの追加\]** ダイアログ ボックスを表示します。  
+  
+2.  [!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] プロジェクト ノードを選択し、**\[Windows フォーム アプリケーション\]** をクリックします。  
+  
+3.  **\[プロジェクト名\]** ボックスに「`Test`」と入力します。  
+  
+4.  **ソリューション エクスプローラー**の **\[すべてのファイルを表示\]** をクリックします。  
+  
+5.  **ソリューション エクスプローラー**で、テスト プロジェクトの **\[参照設定\]** ノードを右クリックし、ショートカット メニューの **\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを表示します。  
+  
+6.  **\[プロジェクト\]** タブをクリックします。  
+  
+7.  **\[プロジェクト\]** タブをクリックします。  `ValueButtonLib` プロジェクトが **\[プロジェクト名\]** の下に表示されます。  プロジェクトをダブルクリックしてテスト プロジェクトへの参照を追加します。  
+  
+8.  **ソリューション エクスプローラー**で、**\[Test\]** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+#### フォームにコントロールを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[Form1.vb\]** を右クリックし、ショートカット メニューの **\[デザイナーの表示\]** をクリックします。  
+  
+2.  **ツールボックス**の **\[ValueButtonLib コンポーネント\]** をクリックします。  **\[ValueButton\]** をダブルクリックします。  
+  
+     **ValueButton** がフォームに表示されます。  
+  
+3.  **\[ValueButton\]** を右クリックし、ショートカット メニューの **\[プロパティ\]** をクリックします。  
+  
+4.  **\[プロパティ\]** ウィンドウで、このコントロールのプロパティを調べます。  標準のボタンによって公開されるのと同じプロパティの他に、追加のプロパティ `ButtonValue` が含まれています。  
+  
+5.  `ButtonValue` プロパティを `5` に設定します。  
+  
+6.  **ツールボックス**の **\[すべての Windows フォーム\]** タブで、**\[Label\]** をダブルクリックしてフォームに <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+7.  ラベルをフォームの中央に配置し直します。  
+  
+8.  `ValueButton1` をダブルクリックします。  
+  
+     **コード エディター**が開き、`ValueButton1_Click` イベントが表示されます。  
+  
+9. 次のコード行を入力します。  
+  
+     \[Visual Basic\]  
+  
+    ```  
+    Label1.Text = CStr(ValueButton1.ButtonValue)  
+    ```  
+  
+10. **ソリューション エクスプローラー**で、**\[Test\]** を右クリックし、ショートカット メニューの **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+11. **\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。  
+  
+     `Form1` が表示されます。  
+  
+12. \[`Valuebutton1`\] をクリックします。  
+  
+     `Label1` に数字 "5" が表示され、継承したコントロールの `ButtonValue` プロパティが `ValueButton1_Click` メソッドを介して `Label1` に渡されたことを示します。  このようにして、`ValueButton` コントロールは標準の Windows フォーム ボタンの機能をすべて継承しながら、追加のカスタム プロパティを公開します。  
+  
+## 参照  
+ [チュートリアル : Visual Basic による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-basic.md)   
+ [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](../../../../docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)   
+ [NOT IN BUILD: Inheritance in Visual Basic](http://msdn.microsoft.com/ja-jp/e5e6e240-ed31-4657-820c-079b7c79313c)   
+ [Component Authoring Walkthroughs](../Topic/Component%20Authoring%20Walkthroughs.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md b/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md
new file mode 100644
index 00000000000..42ab38c41cb
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-inheriting-from-a-windows-forms-control-with-visual-csharp.md
@@ -0,0 +1,161 @@
+---
+title: "チュートリアル : Visual C# による Windows フォーム コントロールからの継承 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], 継承"
+  - "継承, control"
+  - "継承, カスタム コントロール"
+  - "継承, チュートリアル"
+  - "Windows フォーム コントロール, 継承"
+ms.assetid: 09476da0-8d4c-4a4c-b969-649519dfb438
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# チュートリアル : Visual C# による Windows フォーム コントロールからの継承
+[!INCLUDE[csprcslong](../../../../includes/csprcslong-md.md)] では、*継承*によって強力なカスタム コントロールを作成できます。  継承を使用すると、標準の Windows フォーム コントロールの固有の機能をすべて保持しながら、カスタム機能も組み込んだコントロールを作成できます。  このチュートリアルでは、`ValueButton` という名前の簡単な継承コントロールを作成します。  このボタンは、標準の Windows フォーム <xref:System.Windows.Forms.Button> コントロールの機能を継承し、`ButtonValue` というカスタム プロパティを公開します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## プロジェクトの作成  
+ 新しいプロジェクトを作成するときには、その名前を指定することにより、ルート名前空間、アセンブリ名、およびプロジェクト名を設定し、既定のコンポーネントが正しい名前空間に含まれるようにします。  
+  
+#### ValueButtonLib コントロール ライブラリおよび ValueButton コントロールを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[新規作成\]** をポイントし、**\[プロジェクト\]** をクリックして **\[新しいプロジェクト\]** ダイアログ ボックスを開きます。  
+  
+2.  \[[!INCLUDE[csprcs](../../../../includes/csprcs-md.md)] プロジェクト\] ボックスの一覧の **\[Windows フォーム コントロール ライブラリ\]** プロジェクト テンプレートを選択し、**\[プロジェクト名\]** ボックスに「`ValueButtonLib`」と入力します。  
+  
+     プロジェクト名 `ValueButtonLib` は、既定でルート名前空間にも割り当てられます。  ルート名前空間は、アセンブリ内のコンポーネント名の修飾に使用されます。  たとえば、`ValueButton` という名前のコンポーネントが 2 つのアセンブリに含まれる場合は、`ValueButtonLib.ValueButton` という形で目的の `ValueButton` コンポーネントを指定できます。  詳細については、「[名前空間](../Topic/Namespaces%20\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+3.  **ソリューション エクスプローラー**で、**\[UserControl1.cs\]** を右クリックし、ショートカット メニューの **\[名前の変更\]** をクリックします。  ファイル名を「`ValueButton.cs`」に変更します。  コード要素 "`UserControl1`" へのすべての参照の名前を変更するかどうかを確認するダイアログ ボックスが表示されたら、**\[はい\]** をクリックします。  
+  
+4.  **ソリューション エクスプローラー**で **\[ValueButton.cs\]** を右クリックし、**\[コードの表示\]** をクリックします。  
+  
+5.  `class` ステートメント行 `public partial class ValueButton` を見つけ、このコントロールの継承元である種類を <xref:System.Windows.Forms.UserControl> から <xref:System.Windows.Forms.Button> に変更します。  これによって、継承されたコントロールは <xref:System.Windows.Forms.Button> コントロールのすべての機能を継承できます。  
+  
+6.  **ソリューション エクスプローラー**で、**\[ValueButton.cs\]** ノードを開き、**ValueButton.Designer.cs** というデザイナー生成のコード ファイルを表示します。  **コード エディター**でこのファイルを開きます。  
+  
+7.  `InitializeComponent` メソッドを見つけ、<xref:System.Windows.Forms.ContainerControl.AutoScaleMode%2A> プロパティを割り当てる行を削除します。  このプロパティは、<xref:System.Windows.Forms.Button> コントロールには存在しません。  
+  
+8.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックしてプロジェクトを保存します。  
+  
+    > [!NOTE]
+    >  ビジュアルなデザイナーは使用できなくなりました。  <xref:System.Windows.Forms.Button> コントロールは独自の描画を実行するため、デザイナーでは表示を変更できません。  ビジュアル表示は、コードで変更しない限り、継承元のクラス \(つまり、<xref:System.Windows.Forms.Button>\) とまったく同じです。  UI 要素のないコンポーネントをデザイン サーフェイスに追加することはできます。  
+  
+## 継承したコントロールへのプロパティの追加  
+ 継承した Windows フォーム コントロールの可能な用途の 1 つとして、標準の Windows フォーム コントロールと同じ外観と操作性を持ちながらカスタム プロパティを公開するコントロールを作成できます。  ここでは、コントロールに `ButtonValue` という名前のプロパティを追加します。  
+  
+#### Value プロパティを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[ValueButton.cs\]** を右クリックし、ショートカット メニューの **\[コードの表示\]** をクリックします。  
+  
+2.  `class` ステートメントを探します。  始まりの中かっこ \(`{`\) の直後に、次のコードを入力します。  
+  
+     \[C\#\]  
+  
+    ```  
+    // Creates the private variable that will store the value of your   
+    // property.  
+    private int varValue;  
+    // Declares the property.  
+    public int ButtonValue  
+    {  
+       // Sets the method for retrieving the value of your property.  
+       get  
+       {  
+          return varValue;  
+       }  
+       // Sets the method for setting the value of your property.  
+       set  
+       {  
+          varValue = value;  
+       }  
+    }  
+    ```  
+  
+     このコードは、`ButtonValue` プロパティの格納方法と取得方法を設定します。  `get` ステートメントは、返された値をプライベート変数 `varValue` に格納されている値に設定します。`set` ステートメントは、`value` キーワードを使用してプライベート変数の値を設定します。  
+  
+3.  **\[ファイル\]** メニューの **\[すべてを保存\]** をクリックしてプロジェクトを保存します。  
+  
+## コントロールのテスト  
+ コントロールはスタンドアロン プロジェクトではないため、コンテナーでホストする必要があります。  コントロールをテストするには、コントロールを実行するテスト プロジェクトを指定する必要があります。  また、コントロールをビルド \(コンパイル\) してテスト プロジェクトからもアクセスできるようにする必要があります。  ここでは、コントロールを作成し、Windows フォームでそのコントロールをテストします。  
+  
+#### コントロールをビルドするには  
+  
+1.  **\[ビルド\]** メニューの **\[ソリューションのビルド\]** をクリックします。  
+  
+     ビルドは、コンパイル エラーも警告もなしに完了します。  
+  
+#### テスト プロジェクトを作成するには  
+  
+1.  **\[ファイル\]** メニューの **\[追加\]** をポイントし、**\[新しいプロジェクト\]** をクリックして **\[新しいプロジェクトの追加\]** ダイアログ ボックスを表示します。  
+  
+2.  **\[Visual C\#\]** ノードの下の **\[Windows\]** ノードを選択し、**\[Windows フォーム アプリケーション\]** をクリックします。  
+  
+3.  **\[プロジェクト名\]** ボックスに「`Test`」と入力します。  
+  
+4.  **ソリューション エクスプローラー**で、テスト プロジェクトの **\[参照設定\]** ノードを右クリックし、ショートカット メニューの **\[参照の追加\]** をクリックして **\[参照の追加\]** ダイアログ ボックスを表示します。  
+  
+5.  **\[プロジェクト\]** タブをクリックします。  `ValueButtonLib` プロジェクトが **\[プロジェクト名\]** の下に表示されます。  プロジェクトをダブルクリックしてテスト プロジェクトへの参照を追加します。  
+  
+6.  **ソリューション エクスプローラー**で、**\[Test\]** を右クリックし、**\[ビルド\]** をクリックします。  
+  
+#### フォームにコントロールを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、**\[Form1.cs\]** を右クリックし、ショートカット メニューの **\[デザイナーの表示\]** をクリックします。  
+  
+2.  **ツールボックス**の **\[ValueButtonLib コンポーネント\]** をクリックします。  **\[ValueButton\]** をダブルクリックします。  
+  
+     **ValueButton** がフォームに表示されます。  
+  
+3.  **\[ValueButton\]** を右クリックし、ショートカット メニューの **\[プロパティ\]** をクリックします。  
+  
+4.  **\[プロパティ\]** ウィンドウで、このコントロールのプロパティを調べます。  標準のボタンによって公開されるのと同じプロパティの他に、追加のプロパティ `ButtonValue` が含まれています。  
+  
+5.  `ButtonValue` プロパティを `5` に設定します。  
+  
+6.  **ツールボックス**の **\[すべての Windows フォーム\]** タブで、**\[Label\]** をダブルクリックしてフォームに <xref:System.Windows.Forms.Label> コントロールを追加します。  
+  
+7.  ラベルをフォームの中央に配置し直します。  
+  
+8.  `valueButton1` をダブルクリックします。  
+  
+     **コード エディター**が開き、`valueButton1_Click` イベントが表示されます。  
+  
+9. 次のコード行を挿入します。  
+  
+     \[C\#\]  
+  
+    ```  
+    label1.Text = valueButton1.ButtonValue.ToString();  
+    ```  
+  
+10. **ソリューション エクスプローラー**で、**\[Test\]** を右クリックし、ショートカット メニューの **\[スタートアップ プロジェクトに設定\]** をクリックします。  
+  
+11. **\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックします。  
+  
+     `Form1` が表示されます。  
+  
+12. \[`valueButton1`\] をクリックします。  
+  
+     `label1` に数字 "5" が表示され、継承したコントロールの `ButtonValue` プロパティが `valueButton1_Click` メソッドを介して `label1` に渡されたことを示します。  このようにして、`ValueButton` コントロールは標準の Windows フォーム ボタンの機能をすべて継承しながら、追加のカスタム プロパティを公開します。  
+  
+## 参照  
+ [コンポーネントによるプログラミング](../Topic/Programming%20with%20Components.md)   
+ [Component Authoring Walkthroughs](../Topic/Component%20Authoring%20Walkthroughs.md)   
+ [方法: \[ツールボックス アイテムの選択\] ダイアログ ボックスにコントロールを表示する](../../../../docs/framework/winforms/controls/how-to-display-a-control-in-the-choose-toolbox-items-dialog-box.md)   
+ [チュートリアル : Visual C\# による複合コントロールの作成](../../../../docs/framework/winforms/controls/walkthrough-authoring-a-composite-control-with-visual-csharp.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-providing-standard-menu-items-to-a-form.md b/docs/framework/winforms/controls/walkthrough-providing-standard-menu-items-to-a-form.md
new file mode 100644
index 00000000000..e94b3e0f98b
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-providing-standard-menu-items-to-a-form.md
@@ -0,0 +1,134 @@
+---
+title: "チュートリアル : 標準メニュー項目をフォームに用意する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "メニュー項目, 標準"
+  - "StatusStrip コントロール [Windows フォーム]"
+  - "ツール バー [Windows フォーム], チュートリアル"
+  - "ToolStrip コントロール [Windows フォーム]"
+ms.assetid: dac37d98-589e-4d6d-9673-6437e8943122
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# チュートリアル : 標準メニュー項目をフォームに用意する
+<xref:System.Windows.Forms.MenuStrip> コントロールを使って、標準メニューをフォームに用意できます。  
+  
+ このチュートリアルでは、<xref:System.Windows.Forms.MenuStrip> コントロールを使って標準メニューを作成する方法について説明します。  このフォームは、メニュー項目が選択されたときにもそれに応答する動作を実行します。  このチュートリアルでは、次のタスクについて説明します。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   標準メニューの作成  
+  
+-   <xref:System.Windows.Forms.StatusStrip> コントロールの作成  
+  
+-   メニュー項目選択の処理  
+  
+ タスクを完了すると、<xref:System.Windows.Forms.StatusStrip> コントロール内のメニュー項目選択を表示する標準メニューがあるフォームが完成します。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : フォームに標準メニュー項目を追加する](../../../../docs/framework/winforms/controls/how-to-provide-standard-menu-items-to-a-form.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  StandardMenuForm という名前の Windows アプリケーション プロジェクトを作成します。  
+  
+     詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  Windows フォーム デザイナーで、フォームを選択します。  
+  
+## 標準メニューの作成  
+ Windows フォーム デザイナーは、自動的に <xref:System.Windows.Forms.MenuStrip> コントロールに標準のメニュー項目を設定します。  
+  
+#### 標準メニューを作成するには  
+  
+1.  **ツールボックス**から、フォームに <xref:System.Windows.Forms.MenuStrip> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.MenuStrip> コントロールのスマート タグ グリフ \(![スマート タグ グリフ](../../../../docs/framework/winforms/controls/media/vs-winformsmttagglyph.png "VS\_WinFormSmtTagGlyph")\) をクリックし、**\[標準項目の挿入\]** を選択します。  
+  
+     <xref:System.Windows.Forms.MenuStrip> コントロールに標準メニュー項目が設定されます。  
+  
+3.  **\[ファイル\]** メニュー項目をクリックして、既定のメニュー項目とアイコンを表示します。  
+  
+## StatusStrip コントロールの作成  
+ <xref:System.Windows.Forms.StatusStrip> メソッドを使って、Windows フォーム アプリケーションのステータスを表示します。  現在の例では、ユーザーが選択したメニュー項目が <xref:System.Windows.Forms.StatusStrip> コントロールに表示されます。  
+  
+#### StatusStrip コントロールを作成するには  
+  
+1.  **ツールボックス**から、フォームに <xref:System.Windows.Forms.StatusStrip> コントロールをドラッグします。  
+  
+     <xref:System.Windows.Forms.StatusStrip> は、自動的にフォームの下部にドッキングされます。  
+  
+2.  <xref:System.Windows.Forms.StatusStrip> コントロールのドロップダウン リストをクリックし、**\[StatusLabel\]** を選択して <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールを <xref:System.Windows.Forms.StatusStrip> コントロールに追加します。  
+  
+## アイテム選択の処理  
+ ユーザーがメニュー項目を選択したときに、<xref:System.Windows.Forms.ToolStripDropDownItem.DropDownItemClicked> イベントを処理してそれに応答します。  
+  
+#### 項目選択を処理するには  
+  
+1.  「標準メニューの作成」で作成した **\[ファイル\]** メニュー項目をクリックします。  
+  
+2.  **\[プロパティ\]** ウィンドウ ツール バーの **\[イベント\]** をクリックします。  
+  
+3.  <xref:System.Windows.Forms.ToolStripDropDownItem.DropDownItemClicked> イベントをダブルクリックします。  
+  
+     Windows フォーム デザイナーが、<xref:System.Windows.Forms.ToolStripDropDownItem.DropDownItemClicked> イベントのイベント ハンドラーを生成します。  
+  
+4.  イベント ハンドラー内に次のコードを挿入します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StandardMenu#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StandardMenu#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/VB/Form1.vb#3)]  
+  
+5.  `UpdateStatus` ユーティリティ メソッドの定義をフォームに挿入します。  
+  
+     [!code-csharp[System.Windows.Forms.ToolStrip.StandardMenu#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.ToolStrip.StandardMenu#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ToolStrip.StandardMenu/VB/Form1.vb#2)]  
+  
+## チェックポイント  
+  
+#### フォームをテストするには  
+  
+1.  F5 キーを押して、フォームをコンパイルおよび実行します。  
+  
+2.  **\[ファイル\]** メニュー項目をクリックしてメニューを開きます。  
+  
+3.  **\[ファイル\]** メニューで、次のいずれかの項目をクリックして選択します。  
+  
+     選択した項目が、<xref:System.Windows.Forms.StatusStrip> コントロールに表示されます。  
+  
+## 次の手順  
+ このチュートリアルでは、標準メニューを備えたフォームを作成しました。  <xref:System.Windows.Forms.ToolStrip> 系コントロールの用途は、他にもたくさんあります。  
+  
+-   <xref:System.Windows.Forms.ContextMenuStrip> を使って、コントロールにショートカット メニューを作成します。  詳細については、「[ContextMenu コンポーネントの概要](../../../../docs/framework/winforms/controls/contextmenu-component-overview-windows-forms.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> コントロールがドッキングされている、複数のマルチ ドキュメント インターフェイス \(MDI\) フォームを作成します。  詳細については、「[チュートリアル : メニューのマージと ToolStrip コントロールのある MDI フォームを作成する](../../../../docs/framework/winforms/controls/walkthrough-creating-an-mdi-form-with-menu-merging-and-toolstrip-controls.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.ToolStrip> コントロールにプロフェッショナルな外観を与えます。  詳細については、「[方法 : アプリケーションの ToolStrip レンダラーを設定する](../../../../docs/framework/winforms/controls/how-to-set-the-toolstrip-renderer-for-an-application.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.MenuStrip>   
+ <xref:System.Windows.Forms.ToolStrip>   
+ <xref:System.Windows.Forms.StatusStrip>   
+ [MenuStrip コントロール](../../../../docs/framework/winforms/controls/menustrip-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-running-an-operation-in-the-background.md b/docs/framework/winforms/controls/walkthrough-running-an-operation-in-the-background.md
new file mode 100644
index 00000000000..2d4fb64bc6e
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-running-an-operation-in-the-background.md
@@ -0,0 +1,114 @@
+---
+title: "チュートリアル : 操作をバックグラウンドで実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バックグラウンド操作"
+  - "バックグラウンド タスク"
+  - "バックグラウンド スレッド"
+  - "BackgroundWorker クラス, 例"
+  - "フォーム, バックグラウンド操作"
+  - "フォーム, マルチスレッド"
+  - "スレッド処理 [Windows フォーム], バックグラウンド操作"
+ms.assetid: 1b9a4e0a-f134-48ff-a1be-c461446a31ba
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# チュートリアル : 操作をバックグラウンドで実行する
+完了するまでに時間がかかる操作があり、ユーザー インターフェイスが遅くならないようにする場合は、<xref:System.ComponentModel.BackgroundWorker> クラスを使用して別のスレッドで操作を実行できます。  
+  
+ ここで使用するコード例の完全なリストについては、「[方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)」を参照してください。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### 操作をバックグラウンドで実行するには  
+  
+1.  Windows フォーム デザイナーでフォームをアクティブにした状態で、**ツールボックス**から 2 つの <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグし、ボタンの `Name` プロパティおよび <xref:System.Windows.Forms.Control.Text%2A> プロパティを以下の表のとおりに設定します。  
+  
+    |ボタン|名前|テキスト|  
+    |---------|--------|----------|  
+    |`button1`|`startBtn`|\[開始\]|  
+    |`button2`|`cancelBtn`|\[キャンセル\]|  
+  
+2.  **ツールボックス**を開き、**\[コンポーネント\]** タブをクリックします。次に、<xref:System.ComponentModel.BackgroundWorker> コンポーネントをフォームにドラッグします。  
+  
+     `backgroundWorker1` コンポーネントが、**コンポーネント トレイ**に表示されます。  
+  
+3.  **\[プロパティ\]** ウィンドウで、<xref:System.ComponentModel.BackgroundWorker.WorkerSupportsCancellation%2A> プロパティを `true` に設定します。  
+  
+4.  **\[プロパティ\]** ウィンドウの **\[イベント\]** ボタンをクリックし、<xref:System.ComponentModel.BackgroundWorker.DoWork> イベントおよび <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベントをダブルクリックしてイベント ハンドラーを作成します。  
+  
+5.  完了するまでに時間のかかるコードを <xref:System.ComponentModel.BackgroundWorker.DoWork> イベント ハンドラーに挿入します。  
+  
+6.  操作に必要なパラメーターを <xref:System.ComponentModel.DoWorkEventArgs> パラメーターの <xref:System.ComponentModel.DoWorkEventArgs.Argument%2A> プロパティから抽出します。  
+  
+7.  計算の結果を <xref:System.ComponentModel.DoWorkEventArgs> の <xref:System.ComponentModel.DoWorkEventArgs.Result%2A> プロパティに代入します。  
+  
+     この値は、<xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーで使用できます。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#2](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#2)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#2](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#2)]  
+  
+8.  操作の結果を取得するコードを <xref:System.ComponentModel.BackgroundWorker.RunWorkerCompleted> イベント ハンドラーに挿入します。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#3](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#3)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#3](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#3)]  
+  
+9. `TimeConsumingOperation` メソッドを実装します。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#4](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#4)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#4](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#4)]  
+  
+10. Windows フォーム デザイナーで `startButton` をダブルクリックして <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを作成します。  
+  
+11. `startButton` の <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで <xref:System.ComponentModel.BackgroundWorker.RunWorkerAsync%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#5](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#5)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#5](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#5)]  
+  
+12. Windows フォーム デザイナーで `cancelButton` をダブルクリックして <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを作成します。  
+  
+13. `cancelButton` の <xref:System.Windows.Forms.Control.Click> イベント ハンドラーで<xref:System.ComponentModel.BackgroundWorker.CancelAsync%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#6](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#6)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#6](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#6)]  
+  
+14. ファイルの先頭に System.ComponentModel and System.Threading 名前空間をインポートします。  
+  
+     [!code-csharp[System.ComponentModel.BackgroundWorker.Example#7](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/CS/Form1.cs#7)]
+     [!code-vb[System.ComponentModel.BackgroundWorker.Example#7](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.Example/VB/Form1.vb#7)]  
+  
+15. F6 を押してソリューションをビルドした後で、Ctrl キーを押しながら F5 キーを押してアプリケーションをデバッガーの外部で実行します。  
+  
+> [!NOTE]
+>  F5 キーを押してアプリケーションをデバッガーの内部で実行した場合、`TimeConsumingOperation` メソッド内で発生する例外がデバッガーにキャッチされ、表示されます。  アプリケーションをデバッガーの外部で実行すると、<xref:System.ComponentModel.BackgroundWorker> が例外を処理し、<xref:System.ComponentModel.RunWorkerCompletedEventArgs> の <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> プロパティにキャッシュします。  
+  
+1.  非同期操作を実行するには **\[開始\]** をクリックし、非同期操作の実行を停止するには **\[キャンセル\]** をクリックします。  
+  
+     各操作の結果は、<xref:System.Windows.Forms.MessageBox> に表示されます。  
+  
+## 次の手順  
+  
+-   非同期操作の進行状況を通知するフォームを実装します。  詳細については、「[方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)」を参照してください。  
+  
+-   コンポーネント向けの非同期パターンをサポートするクラスを実装します。  詳細については、「[Implementing the Event\-based Asynchronous Pattern](../../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.BackgroundWorker>   
+ <xref:System.ComponentModel.DoWorkEventArgs>   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [方法 : バックグラウンドで操作を実行する](../../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [BackgroundWorker コンポーネント](../../../../docs/framework/winforms/controls/backgroundworker-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md b/docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md
new file mode 100644
index 00000000000..93b1700efa4
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-updating-status-bar-information-at-run-time.md
@@ -0,0 +1,99 @@
+---
+title: "チュートリアル : ステータス バー情報の実行時更新 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "パネル, 最新表示 (ステータス バーを)"
+  - "ステータス バー, 最新表示 (パネルを)"
+  - "ステータス バー, 更新 (実行時に)"
+  - "StatusBar コントロール [Windows フォーム], 最新表示 (パネルを)"
+ms.assetid: cc2abb06-c082-49f7-a5a3-2fd1bbcb58d1
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# チュートリアル : ステータス バー情報の実行時更新
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.StatusStrip> コントロールと <xref:System.Windows.Forms.ToolStripStatusLabel> コントロールは、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールに代わると共に追加の機能を提供します。ただし、<xref:System.Windows.Forms.StatusBar> コントロールおよび <xref:System.Windows.Forms.StatusBarPanel> コントロールは、下位互換性を保つ目的および将来使用する目的で、必要に応じて保持できます。  
+  
+ アプリケーション状態やユーザーとの対話に応じて、実行時にステータス バー パネルの内容を更新することが必要な場合があります。  これは、**CapsLock** キー、**NumLock** キー、**ScrollLock** キーなどのキーが有効化されたことをユーザーに通知したり、日付や時刻を便利な情報として表示するためによく使用される方法です。  
+  
+ <xref:System.Windows.Forms.StatusBarPanel> クラスのインスタンスを使用して時計をホストする例を次に示します。  
+  
+### ステータス バーを更新できる状態にするには  
+  
+1.  新しい Windows フォームを作成します。  
+  
+2.  フォームに <xref:System.Windows.Forms.StatusBar> コントロールを追加します。  詳細については、「[方法 : Windows フォームにコントロールを追加する](../../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)」を参照してください。  
+  
+3.  ステータス バー パネルを <xref:System.Windows.Forms.StatusBar> コントロールに追加します。  詳細については、「[方法 : StatusBar コントロールにパネルを追加する](../../../../docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md)」を参照してください。  
+  
+4.  フォームに追加した <xref:System.Windows.Forms.StatusBar> コントロールで、<xref:System.Windows.Forms.StatusBar.ShowPanels%2A> プロパティを `true` に設定します。  
+  
+5.  Windows フォームの <xref:System.Windows.Forms.Timer> コンポーネントをフォームに追加します。  
+  
+    > [!NOTE]
+    >  Windows フォームの <xref:System.Windows.Forms.Timer?displayProperty=fullName> コンポーネントは、Windows フォーム環境向けにデザインされています。  サーバー環境に適したタイマーが必要な場合は、「[Introduction to Server\-Based Timers](http://msdn.microsoft.com/ja-jp/adc0bc0a-a519-4812-bafc-fb9d1a5801fc)」を参照してください。  
+  
+6.  <xref:System.Windows.Forms.Timer.Enabled%2A> プロパティを `true` に設定します。  
+  
+7.  <xref:System.Windows.Forms.Timer> の <xref:System.Windows.Forms.Timer.Interval%2A> プロパティを 30000 に設定します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Timer> コンポーネントの <xref:System.Windows.Forms.Timer.Interval%2A> プロパティは、正確な時間を表示時刻に反映するために、30 秒 \(30,000 ミリ秒\) に設定されます。  
+  
+### ステータス バーを更新するタイマーを実装するには  
+  
+1.  次のコードを <xref:System.Windows.Forms.Timer> コンポーネントのイベント ハンドラーに挿入して、<xref:System.Windows.Forms.StatusBar> コントロールのパネルを更新します。  
+  
+    ```vb  
+    Private Sub Timer1_Tick(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Timer1.Tick  
+       StatusBar1.Panels(0).Text = Now.ToShortTimeString  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void timer1_Tick(object sender, System.EventArgs e)  
+    {  
+       statusBar1.Panels[0].Text = DateTime.Now.ToShortTimeString();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+      System::Void timer1_Tick(System::Object ^ sender,  
+        System::EventArgs ^ e)  
+      {  
+        statusBar1->Panels[0]->Text =  
+          DateTime::Now.ToShortTimeString();  
+      }  
+    ```  
+  
+     この時点でアプリケーションを実行できる状態になるので、テータス バー パネルの時計の動作を確認します。  
+  
+### アプリケーションをテストするには  
+  
+1.  アプリケーションをデバッグし、F5 キーを押して実行します。  デバッグの詳細については、「[Visual Studio でのデバッグ](../Topic/Debugging%20in%20Visual%20Studio.md)」を参照してください。  
+  
+    > [!NOTE]
+    >  ステータス バーに時計が表示されるまでに、約 30 秒かかります。  これは、できるだけ正確な時刻を表示するためです。  逆に、時計を早く表示するには、上の手順 7. で <xref:System.Windows.Forms.Timer.Interval%2A> プロパティの設定値を小さくします。  
+  
+## 参照  
+ <xref:System.Windows.Forms.StatusBar>   
+ <xref:System.Windows.Forms.ToolStripStatusLabel>   
+ [方法 : StatusBar コントロールにパネルを追加する](../../../../docs/framework/winforms/controls/how-to-add-panels-to-a-statusbar-control.md)   
+ [方法 : Windows フォームの StatusBar コントロールでクリックされたパネルを確認する](../../../../docs/framework/winforms/controls/determine-which-panel-wf-statusbar-control-was-clicked.md)   
+ [StatusBar コントロールの概要](../../../../docs/framework/winforms/controls/statusbar-control-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md b/docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md
new file mode 100644
index 00000000000..c7a56cc6237
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-validating-data-in-the-windows-forms-datagridview-control.md
@@ -0,0 +1,103 @@
+---
+title: "チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 検証"
+  - "データ グリッド, 検証 (データを)"
+  - "データの妥当性検査, Windows フォーム"
+  - "DataGridView コントロール [Windows フォーム], データの妥当性検査"
+  - "検証 (データを), Windows フォーム"
+  - "チュートリアル [Windows フォーム], DataGridView コントロール"
+ms.assetid: a4f1d015-2969-430c-8ea2-b612d179c290
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# チュートリアル : Windows フォーム DataGridView コントロールのデータの妥当性検査
+データ入力機能をユーザーに表示する場合、フォームに入力されたデータの妥当性検査を行うことが必要になる場合があります。  <xref:System.Windows.Forms.DataGridView> クラスには、データがデータ ストアにコミットされる前に妥当性検査を実行できる便利な手段が用意されています。  現在のセルが変更されたときに <xref:System.Windows.Forms.DataGridView> で発生する <xref:System.Windows.Forms.DataGridView.CellValidating> イベントを処理することで、データの妥当性検査を行うことができます。  
+  
+ このチュートリアルでは、Northwind サンプル データベースの `Customers` テーブルから行を取得し、<xref:System.Windows.Forms.DataGridView> コントロールに表示します。  ユーザーが `CompanyName` 列のセルを編集し、そのセルから離れようとすると、<xref:System.Windows.Forms.DataGridView.CellValidating> イベント ハンドラーは新しい会社名文字列が空でないかどうかを確認し、新しい値が空の文字列の場合、<xref:System.Windows.Forms.DataGridView> は空でない文字列が入力されるまで、ユーザーのカーソルがそのセルから移動できないようにします。  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[方法 : Windows フォーム DataGridView コントロールのデータを検証する](../../../../docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Northwind SQL Server サンプル データベースがインストールされたサーバーへのアクセス  
+  
+## フォームの作成  
+  
+#### DataGridView に入力されたデータの妥当性検査を行うには  
+  
+1.  <xref:System.Windows.Forms.Form> から派生し、<xref:System.Windows.Forms.DataGridView> コントロールおよび <xref:System.Windows.Forms.BindingSource> コンポーネントを含むクラスを作成します。  
+  
+     次のコード例は、基本的な初期化処理を行い、`Main` メソッドを含みます。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#01](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#01)]
+     [!code-vb[System.Windows.Forms.DataGridViewDataValidation#01](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#01)]  
+    [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#02](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#02)]
+    [!code-vb[System.Windows.Forms.DataGridViewDataValidation#02](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#02)]  
+  
+2.  フォームのクラス定義に、データベースへの接続の詳細を処理するメソッドを実装します。  
+  
+     このコード例では、データが入力された <xref:System.Data.DataTable> オブジェクトを返す  `GetData`  メソッドを使用します。  `connectionString` 変数には、使用するデータベースに適した値を設定してください。  
+  
+    > [!IMPORTANT]
+    >  接続文字列内にパスワードなどの機密情報を格納すると、アプリケーションのセキュリティに影響を及ぼすことがあります。  データベースへのアクセスを制御する方法としては、Windows 認証 \(統合セキュリティとも呼ばれます\) を使用する方が安全です。  詳細については、「[接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#30](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#30)]
+     [!code-vb[System.Windows.Forms.DataGridViewDataValidation#30](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#30)]  
+  
+3.  <xref:System.Windows.Forms.DataGridView> と <xref:System.Windows.Forms.BindingSource> の初期化、およびデータ バインディングの設定を行うために、フォームの <xref:System.Windows.Forms.Form.Load> イベントのハンドラーを実装します。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#10](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#10)]
+     [!code-vb[System.Windows.Forms.DataGridViewDataValidation#10](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#10)]  
+  
+4.  <xref:System.Windows.Forms.DataGridView> コントロールの <xref:System.Windows.Forms.DataGridView.CellValidating> イベントおよび <xref:System.Windows.Forms.DataGridView.CellEndEdit> イベントのハンドラーを実装します。  
+  
+     <xref:System.Windows.Forms.DataGridView.CellValidating> イベント ハンドラーでは、`CompanyName` 列のセルの値が空であるかどうかを調べます。  セルの値が妥当性検査に合格しなかった場合は、<xref:System.Windows.Forms.DataGridViewCellValidatingEventArgs?displayProperty=fullName> クラスの <xref:System.ComponentModel.CancelEventArgs.Cancel%2A> プロパティを `true` に設定します。  これにより、<xref:System.Windows.Forms.DataGridView> コントロールはカーソルがそのセルから移動することを禁止します。  その行の <xref:System.Windows.Forms.DataGridViewRow.ErrorText%2A> プロパティに説明文字列を設定します。  これにより、エラー アイコンと、エラー テキストを含むツールヒントが表示されます。  <xref:System.Windows.Forms.DataGridView.CellEndEdit> イベント ハンドラーでは、行の <xref:System.Windows.Forms.DataGridViewRow.ErrorText%2A> プロパティに空の文字列を設定します。  <xref:System.Windows.Forms.DataGridView.CellEndEdit> イベントは、セルの編集モードが終了した場合にのみ発生します。そのためには、セルが妥当性検査に合格することが必要です。  
+  
+     [!code-csharp[System.Windows.Forms.DataGridViewDataValidation#20](../../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/CS/datavalidation.cs#20)]
+     [!code-vb[System.Windows.Forms.DataGridViewDataValidation#20](../../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DataGridViewDataValidation/VB/datavalidation.vb#20)]  
+  
+## アプリケーションのテスト  
+ フォームをテストして、期待どおりに動作することを確認します。  
+  
+#### フォームをテストするには  
+  
+-   アプリケーションをコンパイルして実行します。  
+  
+     <xref:System.Windows.Forms.DataGridView> に、`Customers` テーブルからのデータが入力されて表示されます。  `CompanyName` 列内のセルをダブルクリックすると、値を編集できます。  すべての文字を削除してから、Tab キーを押してそのセルから離れようとすると、<xref:System.Windows.Forms.DataGridView> によって阻止されます。  空でない文字列をセルに入力すると、<xref:System.Windows.Forms.DataGridView> コントロールはセルから離れることを許可します。  
+  
+## 次の手順  
+ このアプリケーションでは、<xref:System.Windows.Forms.DataGridView> コントロールの機能について基本を理解できます。  次のような方法を使用すると、<xref:System.Windows.Forms.DataGridView> コントロールの外観および動作をカスタマイズできます。  
+  
+-   輪郭およびヘッダー スタイルを変更します。  詳細については、「[方法 : Windows フォーム DataGridView コントロールの境界線とグリッド線のスタイルを変更する](../../../../docs/framework/winforms/controls/change-the-border-and-gridline-styles-in-the-datagrid.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.DataGridView> コントロールへのユーザー入力の許可または制限。  詳細については、「[方法 : Windows フォーム DataGridView コントロールで行が追加および削除されないようにする](../../../../docs/framework/winforms/controls/prevent-row-addition-and-deletion-datagridview.md)」および「[方法 : Windows フォームの DataGridView コントロールで列を読み取り専用にする](../../../../docs/framework/winforms/controls/how-to-make-columns-read-only-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+-   ユーザー入力に対するデータベース関連エラーの検査。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)」を参照してください。  
+  
+-   仮想モードを使用した大量のデータの処理。  詳細については、「[チュートリアル : Windows フォーム DataGridView コントロールでの仮想モードの実装](../../../../docs/framework/winforms/controls/implementing-virtual-mode-wf-datagridview-control.md)」を参照してください。  
+  
+-   セルの外観をカスタマイズします。  詳細については、「[方法 : Windows フォームの DataGridView コントロールのセルの外観をカスタマイズする](../../../../docs/framework/winforms/controls/customize-the-appearance-of-cells-in-the-datagrid.md)」および「[方法 : Windows フォーム DataGridView コントロールのフォントと色のスタイルを設定する](../../../../docs/framework/winforms/controls/how-to-set-font-and-color-styles-in-the-windows-forms-datagridview-control.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.DataGridView>   
+ <xref:System.Windows.Forms.BindingSource>   
+ [Windows フォーム DataGridView コントロールでのデータ入力](../../../../docs/framework/winforms/controls/data-entry-in-the-windows-forms-datagridview-control.md)   
+ [方法 : Windows フォーム DataGridView コントロールのデータを検証する](../../../../docs/framework/winforms/controls/how-to-validate-data-in-the-windows-forms-datagridview-control.md)   
+ [チュートリアル : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーの処理](../../../../docs/framework/winforms/controls/handling-errors-that-occur-during-data-entry-in-the-datagrid.md)   
+ [接続情報の保護](../../../../docs/framework/data/adonet/protecting-connection-information.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md b/docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md
new file mode 100644
index 00000000000..cac9a56546c
--- /dev/null
+++ b/docs/framework/winforms/controls/walkthrough-working-with-the-maskedtextbox-control.md
@@ -0,0 +1,137 @@
+---
+title: "チュートリアル : MaskedTextBox コントロールの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "入力, 制御 (検証するために)"
+  - "MaskedTextBox コントロール [Windows フォーム], 検証"
+  - "MaskedTextBox コントロール [Windows フォーム], チュートリアル"
+  - "テキスト, コントロール (入力の)"
+  - "ユーザー入力, 制御"
+ms.assetid: df60565e-5447-4110-92a6-be1f6ff5faa3
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# チュートリアル : MaskedTextBox コントロールの使用
+このチュートリアルでは、以下のタスクを行います。  
+  
+-   <xref:System.Windows.Forms.MaskedTextBox> コントロールを初期化します。  
+  
+-   <xref:System.Windows.Forms.MaskedTextBox.MaskInputRejected> イベント ハンドラーを使用して、文字がマスクに従っていない場合にユーザーに警告します。  
+  
+-   <xref:System.Windows.Forms.MaskedTextBox.ValidatingType%2A> プロパティに型を割り当て、<xref:System.Windows.Forms.MaskedTextBox.TypeValidationCompleted> イベント ハンドラーを使用して、ユーザーがコミットしようとした値がその型に対して有効でない場合にユーザーに警告します。  
+  
+## プロジェクトの作成とコントロールの追加  
+  
+#### MaskedTextBox コントロールをフォームに追加するには  
+  
+1.  <xref:System.Windows.Forms.MaskedTextBox> コントロールを配置するフォームを開きます。  
+  
+2.  **ツールボックス**からフォームに <xref:System.Windows.Forms.MaskedTextBox> コントロールをドラッグします。  
+  
+3.  コントロールを右クリックし、**\[プロパティ\]** をクリックします。  **\[プロパティ\]** ウィンドウの **\[マスク\]** プロパティを選択し、プロパティ名の横の **\[...\]** \(省略記号\) ボタンをクリックします。  
+  
+4.  **\[定型入力\]** ダイアログ ボックスで、**\[日付 \(和暦\)\]** マスクを選択し、**\[OK\]** をクリックします。  
+  
+5.  **\[プロパティ\]** ウィンドウで、<xref:System.Windows.Forms.MaskedTextBox.BeepOnError%2A> プロパティを `true` に設定します。  このプロパティを設定すると、マスク定義に違反する文字をユーザーが入力するたびに、短いビープ音が鳴ります。  
+  
+ \[マスク\] プロパティがサポートする文字の概要については、<xref:System.Windows.Forms.MaskedTextBox.Mask%2A> プロパティの「解説」を参照してください。  
+  
+## 入力エラーについてのユーザーへの警告  
+  
+#### マスク入力の拒否に対するバルーン ヒントの追加  
+  
+1.  **ツールボックス**に戻り、<xref:System.Windows.Forms.ToolTip> をフォームに追加します。  
+  
+2.  <xref:System.Windows.Forms.MaskedTextBox.MaskInputRejected> イベントに対するイベント ハンドラーを作成します。この中では、入力エラーが発生したときに <xref:System.Windows.Forms.ToolTip> を表示させます。  バルーン ヒントは、5 秒が経過するか、またはユーザーがクリックするまでは表示されたままとなります。  
+  
+    ```csharp  
+    public void Form1_Load(Object sender, EventArgs e)   
+    {  
+        ... // Other initialization code  
+        maskedTextBox1.Mask = "00/00/0000";  
+        maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected)  
+    }  
+  
+    void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e)  
+    {  
+        toolTip1.ToolTipTitle = "Invalid Input";  
+        toolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", maskedTextBox1, maskedTextBox1.Location, 5000);  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load  
+        Me.ToolTip1.IsBalloon = True  
+        Me.MaskedTextBox1.Mask = "00/00/0000"  
+    End Sub  
+  
+    Private Sub MaskedTextBox1_MaskInputRejected(sender as Object, e as MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected  
+        ToolTip1.ToolTipTitle = "Invalid Input"  
+        ToolTip1.Show("We're sorry, but only digits (0-9) are allowed in dates.", MaskedTextBox1, 5000)  
+    End Sub  
+  
+    ```  
+  
+## 有効でない型についてのユーザーへの警告  
+  
+#### 無効なデータ型に対するバルーン ヒントの追加  
+  
+1.  フォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラーで、<xref:System.DateTime> 型を表す <xref:System.Type> オブジェクトを、<xref:System.Windows.Forms.MaskedTextBox> コントロールの <xref:System.Windows.Forms.MaskedTextBox.ValidatingType%2A> プロパティに対して割り当てます。  
+  
+    ```csharp  
+    private void Form1_Load(Object sender, EventArgs e)  
+    {  
+        // Other code  
+        maskedTextBox1.ValidatingType = typeof(System.DateTime);  
+        maskedTextBox1.TypeValidationCompleted += new TypeValidationEventHandler(maskedTextBox1_TypeValidationCompleted);  
+    }  
+    ```  
+  
+    ```vb  
+    Private Sub Form1_Load(sender as Object, e as EventArgs)  
+        // Other code  
+        MaskedTextBox1.ValidatingType = GetType(System.DateTime)  
+    End Sub  
+    ```  
+  
+2.  <xref:System.Windows.Forms.MaskedTextBox.TypeValidationCompleted> イベントのイベント ハンドラーを追加します。  
+  
+    ```csharp  
+    public void maskedTextBox1_TypeValidationCompleted(object sender, TypeValidationEventArgs e)  
+    {  
+        if (!e.IsValidInput)  
+        {  
+           toolTip1.ToolTipTitle = "Invalid Date Value";  
+           toolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000);  
+           e.Cancel = true;  
+        }  
+    }  
+    ```  
+  
+    ```vb  
+    Public Sub MaskedTextBox1_TypeValidationCompleted(sender as Object, e as TypeValidationEventArgs)  
+        If Not e.IsValidInput Then  
+           ToolTip1.ToolTipTitle = "Invalid Date Value"  
+           ToolTip1.Show("We're sorry, but the value you entered is not a valid date. Please change the value.", maskedTextBox1, 5000)  
+           e.Cancel = True  
+        End If  
+    End Sub  
+  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.Forms.MaskedTextBox>   
+ [MaskedTextBox コントロール](../../../../docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md b/docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md
new file mode 100644
index 00000000000..e7f3580d5c7
--- /dev/null
+++ b/docs/framework/winforms/controls/ways-to-select-a-windows-forms-button-control.md
@@ -0,0 +1,43 @@
+---
+title: "Windows フォームの Button コントロールを選択する方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], 選択"
+ms.assetid: fe2fc058-5118-4f70-b264-6147d64a7a8d
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォームの Button コントロールを選択する方法
+Windows フォームのボタンは、次の方法で選択できます。  
+  
+-   マウスを使用してボタンをクリックします。  
+  
+-   コード内でボタンの <xref:System.Windows.Forms.Control.Click> イベントを呼び出します。  
+  
+-   **Tab** キーを押してボタンにフォーカスを移し、**Space** キーまたは **Enter** キーを押してボタンを選択します。  
+  
+-   ボタンに対応するアクセス キーを押します \(**Alt** キーを押しながら下線の付いた文字のキーを押します\)。  アクセス キーの詳細については、「[方法 : Windows フォーム コントロールのアクセス キーを作成する](../../../../docs/framework/winforms/controls/how-to-create-access-keys-for-windows-forms-controls.md)」を参照してください。  
+  
+-   ボタンがフォームの "承認" ボタンである場合は、Enter キーを押すとそのボタンが選択されます。フォーカスが他のコントロールにあっても、\(そのコントロールが承認ボタン以外のボタン、複数行のテキスト ボックス、または Enter キーをトラップするカスタム コントロールである場合を除き\) この方法でボタンを選択できます。  
+  
+-   ボタンがフォームの "キャンセル" ボタンである場合は、フォーカスが他のコントロールにあっても、**Esc** キーを押すとボタンが選択されます。  
+  
+-   <xref:System.Windows.Forms.Button.PerformClick%2A> メソッドを呼び出して、プログラムによってボタンを選択します。  
+  
+## 参照  
+ [Button コントロールの概要](../../../../docs/framework/winforms/controls/button-control-overview-windows-forms.md)   
+ [方法 : Windows フォームのボタンのクリックに応答する](../../../../docs/framework/winforms/controls/how-to-respond-to-windows-forms-button-clicks.md)   
+ [Button コントロール](../../../../docs/framework/winforms/controls/button-control-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/webbrowser-control-overview.md b/docs/framework/winforms/controls/webbrowser-control-overview.md
new file mode 100644
index 00000000000..85a667d7c20
--- /dev/null
+++ b/docs/framework/winforms/controls/webbrowser-control-overview.md
@@ -0,0 +1,69 @@
+---
+title: "WebBrowser コントロールの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "WebBrowser"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Web ページ, 表示 (アプリケーション内に)"
+  - "WebBrowser コントロール [Windows フォーム], 概要"
+ms.assetid: 6e3e1cc2-9c48-4136-9659-e99e4e60b7e9
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# WebBrowser コントロールの概要
+<xref:System.Windows.Forms.WebBrowser> コントロールは、WebBrowser ActiveX コントロール用のマネージ ラッパーを提供します。  マネージ ラッパーを使用すると、Windows フォーム クライアント アプリケーションで、Web ページを表示できます。  <xref:System.Windows.Forms.WebBrowser> コントロールを使用すると、アプリケーションで Internet Explorer の Web ブラウザー同様の機能を利用できます。または、Internet Explorer の既定の機能を無効にして、コントロールを単純な HTML ドキュメント ビューアーとして使用することもできます。  また、このコントロールを使用してフォームに DHTML ベースのユーザー インターフェイス要素を追加することによって、これらの機能が <xref:System.Windows.Forms.WebBrowser> コントロールでホストされているという事実を隠すこともできます。  この方法によって、Web コントロールと Windows フォーム コントロールとを 1 つのアプリケーションでシームレスに組み合わせることができます。  
+  
+## よく使用されるプロパティ、メソッド、およびイベント  
+ <xref:System.Windows.Forms.WebBrowser> コントロールには、Internet Explorer のコントロールを実装するために利用できる複数のプロパティ、メソッド、およびイベントがあります。  たとえば、`Navigate` メソッドを使用すると、アドレス バーを実装でき、`GoBack` メソッド、`GoForward` メソッド、`Stop` メソッド、および `Refresh` メソッドを使用すると、ツール バー上の移動ボタンを実装できます。  `Navigated` イベントを処理すると、`Url` プロパティの値でアドレス バーを更新したり、`DocumentTitle` プロパティの値でタイトル バーを更新したりできます。  
+  
+ アプリケーション内で独自のページ コンテンツを作成する場合は、`DocumentText` プロパティを設定します。  HTML ドキュメント オブジェクト モデル \(DOM\) の知識があれば、`Document` プロパティを使用して、現在の Web ページのコンテンツを操作することもできます。  このプロパティを使用すると、複数のファイルを移動しなくても、メモリ内でドキュメントの格納および変更を行うことができます。  
+  
+ `Document` プロパティは、Web ページのスクリプト コードで実装されているメソッドを、クライアント アプリケーション コードから呼び出す場合にも使用できます。  スクリプト コードからクライアント アプリケーション コードにアクセスするには、`ObjectForScripting` プロパティを設定します。  指定したオブジェクトは、`window.external` オブジェクトとしてスクリプト コードによってアクセスできます。  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Forms.WebBrowser.Document%2A> プロパティ|現在の Web ページの HTML ドキュメント オブジェクト モデル \(DOM\) へのアクセスを管理するオブジェクトを取得します。|  
+|<xref:System.Windows.Forms.WebBrowser.DocumentCompleted> イベント|Web ページの読み込みが完了した時点で発生します。|  
+|<xref:System.Windows.Forms.WebBrowser.DocumentText%2A> プロパティ|現在の Web ページから HTML コンテンツを取得または設定します。|  
+|<xref:System.Windows.Forms.WebBrowser.DocumentTitle%2A> プロパティ|現在の Web ページのタイトルを取得します。|  
+|<xref:System.Windows.Forms.WebBrowser.GoBack%2A> メソッド|履歴内の前のページに移動します。|  
+|<xref:System.Windows.Forms.WebBrowser.GoForward%2A> メソッド|履歴内の次のページに移動します。|  
+|<xref:System.Windows.Forms.WebBrowser.Navigate%2A> メソッド|指定した URL へ移動します。|  
+|<xref:System.Windows.Forms.WebBrowser.Navigating> イベント|移動を開始する前に発生し、アクションのキャンセルを可能にします。|  
+|<xref:System.Windows.Forms.WebBrowser.ObjectForScripting%2A> プロパティ|Web ページのスクリプト コードでアプリケーションと通信するために使用するオブジェクトを取得または設定します。|  
+|<xref:System.Windows.Forms.WebBrowser.Print%2A> メソッド|現在の Web ページを印刷します。|  
+|<xref:System.Windows.Forms.WebBrowser.Refresh%2A> メソッド|現在の Web ページを再読み込みします。|  
+|<xref:System.Windows.Forms.WebBrowser.Stop%2A> メソッド|現在の移動処理を中断し、サウンドやアニメーションなどの動的なページ要素を停止します。|  
+|<xref:System.Windows.Forms.WebBrowser.Url%2A> プロパティ|現在の Web ページの URL を取得または設定します。  このプロパティを設定すると、コントロールを新しい URL に移動できます。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ <xref:System.Windows.Forms.WebBrowserDocumentCompletedEventArgs>   
+ <xref:System.Windows.Forms.WebBrowserDocumentCompletedEventHandler>   
+ <xref:System.Windows.Forms.WebBrowserEncryptionLevel>   
+ <xref:System.Windows.Forms.WebBrowserNavigatedEventArgs>   
+ <xref:System.Windows.Forms.WebBrowserNavigatedEventHandler>   
+ <xref:System.Windows.Forms.WebBrowserNavigatingEventArgs>   
+ <xref:System.Windows.Forms.WebBrowserNavigatingEventHandler>   
+ <xref:System.Windows.Forms.WebBrowserProgressChangedEventArgs>   
+ <xref:System.Windows.Forms.WebBrowserReadyState>   
+ <xref:System.Windows.Forms.WebBrowserRefreshOption>   
+ [方法 : WebBrowser コントロールで URL に移動する](../../../../docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md)   
+ [方法 : WebBrowser コントロールを使用して印刷する](../../../../docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md)   
+ [方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md)   
+ [方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md)   
+ [方法 : DHTML コードとクライアント アプリケーション コード間の双方向の通信を実装する](../../../../docs/framework/winforms/controls/implement-two-way-com-between-dhtml-and-client.md)   
+ [WebBrowser セキュリティ](../../../../docs/framework/winforms/controls/webbrowser-security.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/webbrowser-control-windows-forms.md b/docs/framework/winforms/controls/webbrowser-control-windows-forms.md
new file mode 100644
index 00000000000..4e54ef8a40b
--- /dev/null
+++ b/docs/framework/winforms/controls/webbrowser-control-windows-forms.md
@@ -0,0 +1,91 @@
+---
+title: "WebBrowser コントロール (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Web ページ, ホスト (アプリケーション内に)"
+  - "Web ページ, Windows フォーム コントロール"
+  - "WebBrowser コントロール [Windows フォーム]"
+ms.assetid: 12667861-5b5b-46bc-8fb5-675e25264c9f
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# WebBrowser コントロール (Windows フォーム)
+Windows フォームの `WebBrowser` コントロールは、Web ページをホストして、Web ブラウズ機能をアプリケーションに提供します。  
+  
+## このセクションの内容  
+ [WebBrowser コントロールの概要](../../../../docs/framework/winforms/controls/webbrowser-control-overview.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [WebBrowser セキュリティ](../../../../docs/framework/winforms/controls/webbrowser-security.md)  
+ このコントロールに関連するセキュリティの問題を説明します。  
+  
+ [方法 : WebBrowser コントロールで URL に移動する](../../../../docs/framework/winforms/controls/how-to-navigate-to-a-url-with-the-webbrowser-control.md)  
+ このコントロールで特定の URL を表示する方法を示します。  
+  
+ [方法 : WebBrowser コントロールを使用して印刷する](../../../../docs/framework/winforms/controls/how-to-print-with-a-webbrowser-control.md)  
+ Web ページを表示しないで印刷する方法を示します。  
+  
+ [方法 : Windows フォーム アプリケーションに Web ブラウザーの機能を追加する](../../../../docs/framework/winforms/controls/how-to-add-web-browser-capabilities-to-a-windows-forms-application.md)  
+ Web ブラウザーとして使用するために、コントロールを初期化する方法を説明します。  
+  
+ [方法 : Windows フォーム アプリケーションで HTML ドキュメントビューアーを作成する](../../../../docs/framework/winforms/controls/how-to-create-an-html-document-viewer-in-a-windows-forms-application.md)  
+ HTML ビューアーとして使用するために、コントロールを初期化する方法を説明します。  
+  
+ [方法 : DHTML コードとクライアント アプリケーション コード間の双方向の通信を実装する](../../../../docs/framework/winforms/controls/implement-two-way-com-between-dhtml-and-client.md)  
+ アプリケーション コードとコントロールでホストされている Web ページ内の DHTML との間で双方向の通信を設定する方法を説明します。  
+  
+ [マネージ HTML DOM \(Document Object Model\) の使用](../../../../docs/framework/winforms/controls/using-the-managed-html-document-object-model.md)  
+ <xref:System.Windows.Forms.WebBrowser> でホストされる HTML ページを操作または作成する方法を説明するトピックを示します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.WebBrowser> クラス  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.WebBrowserDocumentCompletedEventArgs>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.WebBrowserDocumentCompletedEventHandler>  
+ このデリゲートについて説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserEncryptionLevel>  
+ この列挙体とそのすべての値について説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserNavigatedEventArgs>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.WebBrowserNavigatedEventHandler>  
+ このデリゲートについて説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserNavigatingEventArgs>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.WebBrowserNavigatingEventHandler>  
+ このデリゲートについて説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserProgressChangedEventArgs>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.WebBrowserProgressChangedEventHandler>  
+ このデリゲートについて説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserReadyState>  
+ この列挙体とそのすべての値について説明します。  
+  
+ <xref:System.Windows.Forms.WebBrowserRefreshOption>  
+ この列挙体とそのすべての値について説明します。  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/webbrowser-security.md b/docs/framework/winforms/controls/webbrowser-security.md
new file mode 100644
index 00000000000..60bb0298e43
--- /dev/null
+++ b/docs/framework/winforms/controls/webbrowser-security.md
@@ -0,0 +1,32 @@
+---
+title: "WebBrowser セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "セキュリティ [Windows フォーム], WebBrowser コントロール"
+  - "WebBrowser コントロール [Windows フォーム], セキュリティ"
+ms.assetid: 0968846e-48ee-485a-9797-65b5b9a622f8
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# WebBrowser セキュリティ
+<xref:System.Windows.Forms.WebBrowser> コントロールは、完全に信頼されている場合にのみ動作するようにデザインされています。  このコントロールでは、外部 Web サーバーからの HTML コンテンツを表示できるため、スクリプトや Web コントロールの形式でアンマネージ コードが含まれている可能性があります。  この場合に <xref:System.Windows.Forms.WebBrowser> コントロールを使用しても、Internet Explorer を使用する場合と同様に安全ですが、マネージ コントロールである <xref:System.Windows.Forms.WebBrowser> が、アンマネージ コードの実行を妨げることはありません。  
+  
+ 基になる ActiveX の `WebBrowser` コントロールに関するセキュリティ問題の詳細については、「[WebBrowser Control \(WebBrowser コントロール\)](http://go.microsoft.com/fwlink/?LinkId=198812)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.WebBrowser>   
+ [WebBrowser コントロールの概要](../../../../docs/framework/winforms/controls/webbrowser-control-overview.md)   
+ [WebBrowser Control \(WebBrowser コントロール\)](http://go.microsoft.com/fwlink/?LinkId=198812)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md b/docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md
new file mode 100644
index 00000000000..2bae1f315fd
--- /dev/null
+++ b/docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md
@@ -0,0 +1,43 @@
+---
+title: "ListBox の代わりに Windows フォーム ComboBox を使用する場合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, コンボ ボックス"
+  - "コンボ ボックス, 比較 (リスト ボックスと)"
+  - "ComboBox コントロール [Windows フォーム], 比較 (ListBox と)"
+  - "ListBox コントロール [Windows フォーム], アクセス (項目に)"
+  - "ListBox コントロール [Windows フォーム], 追加と削除 (項目を)"
+  - "ListBox コントロール [Windows フォーム], および ComboBox"
+  - "ListCount プロパティ"
+  - "ListIndex プロパティ"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: 7bcaea58-1cfa-46db-9baf-b75a69d8f9ec
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ListBox の代わりに Windows フォーム ComboBox を使用する場合
+<xref:System.Windows.Forms.ComboBox> コントロールと <xref:System.Windows.Forms.ListBox> コントロールは動作が似ており、置き換えることができる場合もあります。  ただし、各コントロールには、それぞれに適した用途があります。  
+  
+ 通常、コンボ ボックスは選択可能な値を単に示す場合に使用し、リスト ボックスは選択可能な値をリスト上の項目に限定する場合に使用します。  リストにない値を入力できるように、コンボ ボックスにはテキスト ボックス フィールドが含まれます。  ただし、<xref:System.Windows.Forms.ComboBox.DropDownStyle%2A> プロパティを <xref:System.Windows.Forms.ComboBoxStyle> に設定している場合は除きます。  その場合は、最初の文字を入力すると、コントロールによって項目が選択されます。  
+  
+ また、コンボ ボックスを使用すると、フォーム上の領域を節約できます。  ユーザーが下向きの矢印をクリックするまでリスト全体が表示されないため、リスト ボックスを配置できない小さな領域でも、コンボ ボックスを簡単に配置できます。  ただし、<xref:System.Windows.Forms.ComboBox.DropDownStyle%2A> プロパティが <xref:System.Windows.Forms.ComboBoxStyle> に設定されている場合、リスト全体が表示されるため、コンボ ボックスはリスト ボックスよりも大きい領域を占めることになります。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ComboBox>   
+ <xref:System.Windows.Forms.ListBox>   
+ [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)   
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](../../../../docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)   
+ [オプションのリストを表示するための Windows フォーム コントロール](../../../../docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/windows-forms-control-development-basics.md b/docs/framework/winforms/controls/windows-forms-control-development-basics.md
new file mode 100644
index 00000000000..0305ae1cce6
--- /dev/null
+++ b/docs/framework/winforms/controls/windows-forms-control-development-basics.md
@@ -0,0 +1,46 @@
+---
+title: "Windows フォーム コントロール開発の基本概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 作成"
+  - "カスタム コントロール [Windows フォーム], 派生型"
+  - "プログラミングの概念, Windows フォーム コントロール"
+ms.assetid: 6277bb81-90f7-4c5b-9f4b-b02bb42dd316
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォーム コントロール開発の基本概念
+Windows フォーム コントロールは、<xref:System.Windows.Forms.Control?displayProperty=fullName> から直接または間接的に派生するクラスです。  一般的な Windows フォーム コントロールの開発方法をまとめた一覧を次に示します。  
+  
+-   既存の複数のコントロールを組み合わせて、複合コントロールを作成します。  
+  
+     複合コントロールは、コントロールとして再利用できるユーザー インターフェイスをカプセル化します。  複合コントロールの例としては、テキスト ボックスとリセット ボタンで構成されるコントロールがあります。  ビジュアル デザイナーには、複合コントロールの作成をサポートするさまざまな機能があります。  複合コントロールを作成するには、<xref:System.Windows.Forms.UserControl?displayProperty=fullName> から派生します。  <xref:System.Windows.Forms.UserControl> 基本クラスは子コントロールに対してキーボード ルーティングを提供し、複数の子コントロールを 1 つのグループとして機能させることができます。  詳細については、「[複合 Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md)」を参照してください。  
+  
+-   コントロールを拡張します。コントロールをカスタマイズするか、またはコントロールに機能を追加します。  
+  
+     拡張コントロールの例としては、色を変更できないボタンや、クリック回数を追跡する追加プロパティが設定されているボタンがあります。  Windows フォーム コントロールをカスタマイズするには、コントロールからクラスを派生させて、プロパティ、メソッド、イベントを追加またはオーバーライドします。  
+  
+-   既存の複合コントロールや拡張コントロール以外のコントロールを作成します。  
+  
+     この場合、<xref:System.Windows.Forms.Control> 基本クラスからコントロールを派生させます。  基本クラスのプロパティ、メソッド、イベントをオーバーライドまたは追加できます。  開始するには、「[方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md)」を参照してください。  
+  
+ Windows フォーム コントロールの基本クラスである <xref:System.Windows.Forms.Control> には、クライアント側の Windows ベースのアプリケーションでのビジュアル表示に必要な内部機構が用意されています。  <xref:System.Windows.Forms.Control> には、ウィンドウ ハンドルがあり、メッセージ ルーティングを処理します。また、マウス イベントとキーボード イベントの他、多くのユーザー インターフェイス イベントが含まれています。  このクラスは、高度なレイアウトを提供し、<xref:System.Windows.Forms.Control.ForeColor%2A>、<xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.Height%2A>、<xref:System.Windows.Forms.Control.Width%2A> など、ビジュアル表示に関連する固有のプロパティを備えています。  さらに、セキュリティ、スレッド処理のサポート、ActiveX コントロールとの相互運用性を提供します。  基本クラスによってインフラストラクチャの大部分が提供されるため、Windows フォーム コントロールは比較的簡単に開発できます。  
+  
+## 参照  
+ [方法 : シンプルな Windows フォーム コントロールを開発する](../../../../docs/framework/winforms/controls/how-to-develop-a-simple-windows-forms-control.md)   
+ [複合 Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-a-composite-windows-forms-control.md)   
+ [方法 : 進行状況を示す Windows フォーム コントロールを作成する](../../../../docs/framework/winforms/controls/how-to-create-a-windows-forms-control-that-shows-progress.md)   
+ [さまざまなカスタム コントロール](../../../../docs/framework/winforms/controls/varieties-of-custom-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/windows-forms-controls-by-function.md b/docs/framework/winforms/controls/windows-forms-controls-by-function.md
new file mode 100644
index 00000000000..b4c10aebb28
--- /dev/null
+++ b/docs/framework/winforms/controls/windows-forms-controls-by-function.md
@@ -0,0 +1,98 @@
+---
+title: "Windows フォーム コントロールの機能別一覧 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], 関数による"
+  - "Windows フォーム コントロール, 一覧"
+  - "Windows フォーム, コントロールの機能別一覧"
+ms.assetid: 5e65a6c3-5d6f-480d-beb8-b28f865f07e3
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォーム コントロールの機能別一覧
+Windows フォームには、さまざまな機能を実行するコントロールとコンポーネントがあります。  次の表に、Windows フォームのコントロールとコンポーネントを機能ごとにまとめて示します。  同じ機能を提供するコントロールが複数ある場合は、推奨コントロールを示し、非推奨コントロールについての注釈を付けています。  さらに、非推奨コントロールとそれに対応する推奨コントロールの一覧を独立した表として示します。  
+  
+> [!NOTE]
+>  次の表は、Windows フォームで使用できるすべてのコントロールやコンポーネントを示しているわけではありません。完全な一覧については、「[Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)」を参照してください。  
+  
+## 推奨されるコントロールとコンポーネント \(機能別\)  
+  
+|Function|Control|Description|  
+|--------------|-------------|-----------------|  
+|データの表示|<xref:System.Windows.Forms.DataGridView> コントロール|<xref:System.Windows.Forms.DataGridView> コントロールには、データを表示するための、カスタマイズできるテーブルが用意されています。  <xref:System.Windows.Forms.DataGridView> クラスを使用すると、セル、行、列、罫線をカスタマイズできます。 **Note:**  <xref:System.Windows.Forms.DataGridView> コントロールには、<xref:System.Windows.Forms.DataGrid> コントロールにはない、さまざまな基本機能と高度な機能が用意されています。  詳細については、「[Windows フォームの DataGridView コントロールと DataGrid コントロールの違いについて](../../../../docs/framework/winforms/controls/differences-between-the-windows-forms-datagridview-and-datagrid-controls.md)」を参照してください。|  
+|データ バインディングとナビゲーション|<xref:System.Windows.Forms.BindingSource> コンポーネント|同時実行の管理、変更通知などのサービスを提供し、フォーム上のコントロールとデータとのバインディングを単純化します。|  
+||<xref:System.Windows.Forms.BindingNavigator> コントロール|フォーム上のデータをナビゲートしたり操作したりするためのツール バー形式のインターフェイスを実現します。|  
+|テキストの編集|<xref:System.Windows.Forms.TextBox> コントロール|デザイン時に入力されたテキストを表示します。このテキストは、実行時にユーザーが編集でき、また、プログラムでも変更できます。|  
+||<xref:System.Windows.Forms.RichTextBox> コントロール|書式なしテキスト形式または書式付きテキスト \(RTF\) 形式で書式指定されたテキストを表示できます。|  
+||<xref:System.Windows.Forms.MaskedTextBox> コントロール|ユーザー入力の形式に制約を適用します。|  
+|情報の表示 \(読み取り専用\)|<xref:System.Windows.Forms.Label> コントロール|ユーザーが直接編集できないテキストを表示します。|  
+||<xref:System.Windows.Forms.LinkLabel> コントロール|テキストを Web スタイルのリンクとして表示し、ユーザーが特定のテキストをクリックしたときにイベントを発生させます。  通常、このテキストは他のウィンドウまたは Web サイトへのリンクです。|  
+||<xref:System.Windows.Forms.StatusStrip> コントロール|フレーム付きの領域を使用してアプリケーションの現在の状態に関する情報を表示します。通常、親フォームの一番下に表示されます。|  
+||<xref:System.Windows.Forms.ProgressBar> コントロール|操作の現在の進行状況をユーザー向けに表示します。|  
+|Web ページの表示|<xref:System.Windows.Forms.WebBrowser> コントロール|ユーザーがフォーム内で Web ページをナビゲートできるようにします。|  
+|一覧からの選択|<xref:System.Windows.Forms.CheckedListBox> コントロール|スクロール可能な項目の一覧を表示します。各項目の横にチェック ボックスが表示されます。|  
+||<xref:System.Windows.Forms.ComboBox> コントロール|項目のドロップダウン リストを表示します。|  
+||<xref:System.Windows.Forms.DomainUpDown> コントロール|ユーザーが上下の矢印ボタンを使用してスクロールできる、テキスト項目の一覧を表示します。|  
+||<xref:System.Windows.Forms.ListBox> コントロール|テキスト項目およびグラフィカル項目 \(アイコン\) の一覧を表示します。|  
+||<xref:System.Windows.Forms.ListView> コントロール|4 つの異なるビューのうちの 1 つで項目を表示します。  ビューには、テキストだけ、テキストと小さいアイコン、テキストと大きいアイコン、および詳細ビューがあります。|  
+||<xref:System.Windows.Forms.NumericUpDown> コントロール|ユーザーが上下の矢印ボタンを使用してスクロールできる、数値の一覧を表示します。|  
+||<xref:System.Windows.Forms.TreeView> コントロール|テキストとオプションのチェック ボックスまたはアイコンから成るノード オブジェクトの階層的なコレクションを表示します。|  
+|グラフィックスの表示|<xref:System.Windows.Forms.PictureBox> コントロール|ビットマップやアイコンなどのグラフィカル ファイルをフレーム内に表示します。|  
+|グラフィックスの格納|<xref:System.Windows.Forms.ImageList> コントロール|イメージのリポジトリとして機能します。  <xref:System.Windows.Forms.ImageList> コントロールとそれに含まれるイメージは、異なるアプリケーション間で再利用できます。|  
+|値の設定|<xref:System.Windows.Forms.CheckBox> コントロール|チェック ボックスとテキストのラベルを表示します。  一般に、オプションの設定に使用されます。|  
+||<xref:System.Windows.Forms.CheckedListBox> コントロール|スクロール可能な項目の一覧を表示します。各項目の横にチェック ボックスが表示されます。|  
+||<xref:System.Windows.Forms.RadioButton> コントロール|オンまたはオフにできるボタンを表示します。|  
+||<xref:System.Windows.Forms.TrackBar> コントロール|ユーザーが目盛り上でつまみを動かして値を設定できるようにします。|  
+|日付の設定|<xref:System.Windows.Forms.DateTimePicker> コントロール|ユーザーが日付または時刻を選択できるグラフィカルなカレンダーを表示します。|  
+||<xref:System.Windows.Forms.MonthCalendar> コントロール|ユーザーが日付の範囲を選択できるグラフィカルなカレンダーを表示します。|  
+|ダイアログ ボックス|<xref:System.Windows.Forms.ColorDialog> コントロール|ユーザーがインターフェイス要素の色を設定できるカラー ピッカー ダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.FontDialog> コントロール|ユーザーがフォントとその属性を設定できるダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.OpenFileDialog> コントロール|ユーザーがファイルを参照して選択できるダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.PrintDialog> コントロール|ユーザーがプリンターを選択してその属性を設定できるダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.PrintPreviewDialog> コントロール|<xref:System.Drawing.Printing.PrintDocument> コンポーネントが印刷時にどのように表示されるかを示すダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.FolderBrowserDialog> コントロール|ユーザーがフォルダーを参照、作成して最終的に選択するためのダイアログ ボックスを表示します。|  
+||<xref:System.Windows.Forms.SaveFileDialog> コントロール|ユーザーがファイルを保存できるダイアログ ボックスを表示します。|  
+|メニュー コントロール|<xref:System.Windows.Forms.MenuStrip> コントロール|カスタム メニューを作成します。 **Note:**  <xref:System.Windows.Forms.MenuStrip> は <xref:System.Windows.Forms.MainMenu> コントロールを置き換えるためにデザインされたものです。|  
+||<xref:System.Windows.Forms.ContextMenuStrip> コントロール|カスタムのコンテキスト メニューを作成します。 **Note:**  <xref:System.Windows.Forms.ContextMenuStrip> は <xref:System.Windows.Forms.ContextMenu> コントロールを置き換えるためにデザインされたものです。|  
+|コマンド|<xref:System.Windows.Forms.Button> コントロール|プロセスの開始、停止、割り込み|  
+||<xref:System.Windows.Forms.LinkLabel> コントロール|テキストを Web スタイルのリンクとして表示し、ユーザーが特定のテキストをクリックしたときにイベントを発生させます。  通常、このテキストは他のウィンドウまたは Web サイトへのリンクです。|  
+||<xref:System.Windows.Forms.NotifyIcon> コントロール|タスクバーのステータス通知領域に、バックグラウンドで実行中のアプリケーションを示すアイコンを表示します。|  
+||<xref:System.Windows.Forms.ToolStrip> コントロール|Microsoft Windows XP、Microsoft Office、Microsoft Internet Explorer、またはカスタムのルック アンド フィールに装備できるツール バーを作成します。このツール バーはテーマを適用しても適用しなくてもよく、オーバーフローと実行時の項目並べ替えをサポートしています。 **Note:**  <xref:System.Windows.Forms.ToolStrip> コントロールは <xref:System.Windows.Forms.ToolBar> コントロールを置き換えるためにデザインされたものです。|  
+|ユーザー ヘルプ|<xref:System.Windows.Forms.HelpProvider> コンポーネント|コントロールのポップアップ ヘルプまたはオンライン ヘルプを提供します。|  
+||<xref:System.Windows.Forms.ToolTip> コンポーネント|ユーザーがポインターをコントロール上に移動したときに、コントロールの用途についての簡単な説明を表示するポップアップ ウィンドウを表します。|  
+|他のコントロールのグループ化|<xref:System.Windows.Forms.Panel> コントロール|ラベルのないスクロール可能なフレームに、コントロールのセットをグループ化します。|  
+||<xref:System.Windows.Forms.GroupBox> コントロール|ラベルの付いたスクロールできないフレームに、コントロール \(オプション ボタンなど\) のセットをグループ化します。|  
+||<xref:System.Windows.Forms.TabControl> コントロール|グループ化されたオブジェクトを効率的に整理してアクセスするためのタブ付きページを提供します。|  
+||<xref:System.Windows.Forms.SplitContainer> コントロール|移動可能なバーによって区切られた 2 つのパネルを表します。 **Note:**  <xref:System.Windows.Forms.SplitContainer> コントロールは <xref:System.Windows.Forms.Splitter> コントロールを置き換えるためにデザインされたものです。|  
+||<xref:System.Windows.Forms.TableLayoutPanel> コントロール|内容を行と列から成るグリッドに動的にレイアウトするパネルを表します。|  
+||<xref:System.Windows.Forms.FlowLayoutPanel> コントロール|内容を水平または垂直に動的にレイアウトするパネルを表します。|  
+|\[オーディオ\]|<xref:System.Media.SoundPlayer> コントロール|.wav 形式のサウンド ファイルを再生します。  サウンドは非同期に読み込みまたは再生できます。|  
+  
+## 推奨されないコントロールとコンポーネント \(機能別\)  
+  
+|Function|推奨されないコントロール|推奨されるコントロール|  
+|--------------|------------------|-----------------|  
+|データの表示|<xref:System.Windows.Forms.DataGrid>|<xref:System.Windows.Forms.DataGridView>|  
+|情報の表示 \(読み取り専用コントロール\)|<xref:System.Windows.Forms.StatusBar>|<xref:System.Windows.Forms.StatusStrip>|  
+|メニュー コントロール|<xref:System.Windows.Forms.ContextMenu>|<xref:System.Windows.Forms.ContextMenuStrip>|  
+||<xref:System.Windows.Forms.MainMenu>|<xref:System.Windows.Forms.MenuStrip>|  
+|コマンド|<xref:System.Windows.Forms.ToolBar>|<xref:System.Windows.Forms.ToolStrip>|  
+||<xref:System.Windows.Forms.StatusBar>|<xref:System.Windows.Forms.StatusStrip>|  
+|フォームのレイアウト|<xref:System.Windows.Forms.Splitter>|<xref:System.Windows.Forms.SplitContainer>|  
+  
+## 参照  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)   
+ [.NET Framework を使用したカスタム Windows フォーム コントロールの開発](../../../../docs/framework/winforms/controls/developing-custom-windows-forms-controls.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md b/docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md
new file mode 100644
index 00000000000..5427944890e
--- /dev/null
+++ b/docs/framework/winforms/controls/windows-forms-controls-padding-autosize.md
@@ -0,0 +1,204 @@
+---
+title: "チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Margin.Bottom"
+  - "Margin.Left"
+  - "Margin.Top"
+  - "Margin.All"
+  - "Margin.Right"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "AutoSize プロパティ, チュートリアル"
+  - "レイアウト [Windows フォーム], マージンと埋め込み"
+  - "Margin プロパティ [Windows フォーム], チュートリアル"
+  - "Padding プロパティ [Windows フォーム], チュートリアル"
+  - "チュートリアル [Windows フォーム], レイアウト"
+  - "Windows フォーム, レイアウト"
+ms.assetid: f8ae2a6b-db13-4630-8e25-d104091205c7
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# チュートリアル : Padding、Margin、および AutoSize プロパティを使用した Windows フォーム コントロールのレイアウト
+フォーム上にコントロールを正確に配置することは、多くのアプリケーションで重要度の高い処理です。  **Windows フォーム デザイナー**には、そのためのさまざまなレイアウト ツールが用意されています。  最も重要な 3 つのプロパティは、<xref:System.Windows.Forms.Control.Margin%2A>、<xref:System.Windows.Forms.Control.Padding%2A>、および <xref:System.Windows.Forms.Control.AutoSize%2A> です。これらは、すべての Windows フォーム コントロールに存在します。  
+  
+ <xref:System.Windows.Forms.Control.Margin%2A> プロパティは、コントロール周囲の空白領域を定義します。これによってコントロールの境界線と他のコントロールとの間で、指定した距離が保たれます。  
+  
+ <xref:System.Windows.Forms.Control.Padding%2A> プロパティはコントロールの内部の空白領域を定義します。これによって、コントロールの内容 \(たとえばその <xref:System.Windows.Forms.Control.Text%2A> プロパティの値\) とコントロールの境界線との間で、指定した距離が保たれます。  
+  
+ コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティと <xref:System.Windows.Forms.Control.Margin%2A> プロパティを次の図に示します。  
+  
+ ![Windows フォーム コントロールのパディングとマージン](../../../../docs/framework/winforms/controls/media/vs-winformpadmargin.gif "VS\_WinFormPadMargin")  
+  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを使用すると、コントロールのサイズが内容に合わせて自動的に調整されます。  コントロールは元の <xref:System.Windows.Forms.Control.Size%2A> プロパティの値よりも小さいサイズには自動調整されず、<xref:System.Windows.Forms.Control.Padding%2A> プロパティの値に対する領域を占めます。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム プロジェクトの作成  
+  
+-   コントロールのマージンの設定  
+  
+-   コントロールの埋め込みの設定  
+  
+-   コントロールの自動サイズ変更  
+  
+ ここでは、これらの重要なレイアウト機能が果たす役割について理解します。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Visual Studio がインストールされているコンピューターで、Windows フォーム アプリケーション プロジェクトを作成および実行するための十分なアクセス許可が付与されていること。  
+  
+## プロジェクトの作成  
+ 最初にプロジェクトを作成し、フォームを設定します。  
+  
+#### プロジェクトを作成するには  
+  
+1.  `LayoutExample` という名前の **Windows アプリケーション** プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  **Windows フォーム デザイナー**でフォームを選択します。  
+  
+## コントロールのマージンの設定  
+ <xref:System.Windows.Forms.Control.Margin%2A> プロパティを使用すると、コントロール間の既定の距離を設定できます。  別のコントロールのすぐ近くまでコントロールを移動すると、両方のコントロールのマージンを示すスナップ線が表示されます。  また、移動中のコントロールは、マージンで定義された距離にスナップします。  
+  
+#### Margin プロパティを使用してフォーム上にコントロールを配置するには  
+  
+1.  **ツールボックス**から 2 つの <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールのどちらかを選択し、もう 1 つのコントロールにほぼ接触するまで近づけます。  
+  
+     両方のコントロールの間にスナップ線が表示されることを確認します。  この距離は、この 2 つのコントロールの <xref:System.Windows.Forms.Control.Margin%2A> 値の合計です。  移動中のコントロールは、この距離にスナップします。  詳細については、「[チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)」を参照してください。  
+  
+3.  一方のコントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティを変更します。これを行うには **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Margin%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 20 に設定します。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールの一方を選択し、他方のコントロールに近づけます。  
+  
+     マージンの合計値を定義しているスナップ線が延長され、他方のコントロールからより遠い距離にコントロールがスナップします。  
+  
+5.  選択したコントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティを変更します。これを行うには **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Margin%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.Top%2A> プロパティを 5 に設定します。  
+  
+6.  選択したコントロールを他方のコントロールの下に移動し、スナップ線が短くなったことを確認します。  選択したコントロールを他方のコントロールの左に移動し、手順 4. で確認した値をスナップ線が維持していることを確認します。  
+  
+7.  <xref:System.Windows.Forms.Control.Margin%2A> プロパティの各要素 \(<xref:System.Windows.Forms.Padding.Left%2A>、<xref:System.Windows.Forms.Padding.Top%2A>、<xref:System.Windows.Forms.Padding.Right%2A>、<xref:System.Windows.Forms.Padding.Bottom%2A>\) を異なる値に設定できます。また、<xref:System.Windows.Forms.Padding.All%2A> プロパティを使用してすべての要素を同じ値に設定することもできます。  
+  
+## コントロールの埋め込みの設定  
+ アプリケーションに要求される正確なレイアウトを実現するために、コントロール内に子コントロールを含めることもあります。  子コントロールの境界線と親コントロールの境界線の間隔を指定するには、親コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティと子コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティを組み合わせて使用します。  <xref:System.Windows.Forms.Control.Padding%2A> プロパティは、コントロールの内容 \(たとえば、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティ\) と境界線の間隔を制御するためにも使用します。  
+  
+#### 埋め込みを使用してフォーム上にコントロールを配置するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に変更します。  
+  
+3.  <xref:System.Windows.Forms.Control.Padding%2A> プロパティを変更します。これを行うには **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Padding%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 5 に設定します。  
+  
+     コントロールが拡大され、新しい埋め込みのための領域が確保されます。  
+  
+4.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.GroupBox> コントロールをドラッグします。  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.GroupBox> コントロールにドラッグします。  <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.GroupBox> コントロールの右下隅に揃えて配置します。  
+  
+     <xref:System.Windows.Forms.Button> コントロールが <xref:System.Windows.Forms.GroupBox> コントロールの下側と右側の境界線に近づくと、スナップ線が表示されることを確認します。  これらのスナップ線は、<xref:System.Windows.Forms.Button> の <xref:System.Windows.Forms.Control.Margin%2A> プロパティに対応します。  
+  
+5.  <xref:System.Windows.Forms.GroupBox> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティを変更します。これを行うには **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Padding%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 20 に設定します。  
+  
+6.  <xref:System.Windows.Forms.GroupBox> コントロール内の <xref:System.Windows.Forms.Button> コントロールを選択し、<xref:System.Windows.Forms.GroupBox> の中心の方向に移動します。  
+  
+     <xref:System.Windows.Forms.GroupBox> コントロールの境界線からより遠い距離でスナップ線が表示されます。  この距離は、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティと <xref:System.Windows.Forms.GroupBox> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの合計です。  
+  
+## コントロールの自動サイズ変更  
+ アプリケーションによっては、デザイン時と実行時でコントロールのサイズが異なるものがあります。  たとえば、<xref:System.Windows.Forms.Button> コントロールのテキストはデータベースから取得されることがあり、その長さを事前に知ることはできません。  
+  
+ <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを `true` に設定すると、コントロールのサイズはその内容に合わせて自動的に調整されます。  詳細については、「[AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)」を参照してください。  
+  
+#### AutoSize プロパティを使用してフォーム上にコントロールを配置するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に変更します。  
+  
+3.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティを "This button has a long string for its Text property." に変更します。  
+  
+     この変更をコミットすると、<xref:System.Windows.Forms.Button> コントロールのサイズが新しいテキストに合わせて変更されます。  
+  
+4.  **ツールボックス**から別の <xref:System.Windows.Forms.Button> コントロールをフォームにドラッグします。  
+  
+5.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティを "This button has a long string for its Text property." に変更します。  
+  
+     この変更をコミットすると、<xref:System.Windows.Forms.Button> コントロールのサイズは自動的に調整されず、テキストがコントロールの右端でクリップされます。  
+  
+6.  <xref:System.Windows.Forms.Control.Padding%2A> プロパティを変更します。これを行うには **\[プロパティ\]** ウィンドウで <xref:System.Windows.Forms.Control.Padding%2A> エントリを展開し、<xref:System.Windows.Forms.Padding.All%2A> プロパティを 5 に設定します。  
+  
+     コントロールの内部のテキストが 4 辺でクリップされます。  
+  
+7.  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティを `true` に変更します。  
+  
+     <xref:System.Windows.Forms.Button> コントロールのサイズが自動的に変更され、文字列全体が囲まれます。  また、テキストの周囲に埋め込みが追加され、<xref:System.Windows.Forms.Button> コントロールが上下左右に拡大されます。  
+  
+8.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Button> コントロールをドラッグします。  フォームの右下隅付近に配置してください。  
+  
+9. <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に変更します。  
+  
+10. <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Anchor%2A> プロパティを <xref:System.Windows.Forms.AnchorStyles>、<xref:System.Windows.Forms.AnchorStyles> に設定します。  
+  
+11. <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティを "This button has a long string for its Text property." に変更します。  
+  
+     この変更をコミットすると、<xref:System.Windows.Forms.Button> コントロールのサイズが左方向に調整されます。  通常、自動サイズ変更により、コントロールは <xref:System.Windows.Forms.Control.Anchor%2A> プロパティ設定と反対の方向に拡大されます。  
+  
+## AutoSize プロパティと AutoSizeMode プロパティ  
+ 一部のコントロールは、`AutoSizeMode` プロパティをサポートしています。このプロパティにより、コントロールの自動サイズ変更動作をより細かく制御できます。  
+  
+#### AutoSizeMode プロパティを使用するには  
+  
+1.  **ツールボックス**からフォームに、<xref:System.Windows.Forms.Panel> コントロールをドラッグします。  
+  
+2.  <xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Control.AutoSize%2A> プロパティの値を `true` に設定します。  
+  
+3.  **ツールボックス**の <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.Panel> コントロールにドラッグします。  
+  
+4.  <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.Panel> コントロールの右下隅付近に配置します。  
+  
+5.  <xref:System.Windows.Forms.Panel> コントロールを選択し、右下のサイズ変更ハンドルをグラブします。  <xref:System.Windows.Forms.Panel> コントロールを拡大または縮小します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Panel> コントロールのサイズは自由に変更できますが、<xref:System.Windows.Forms.Button> コントロールの右下隅の位置を越えて縮小できません。  この動作は、`AutoSizeMode` プロパティの既定値である <xref:System.Windows.Forms.AutoSizeMode> で指定されます。  
+  
+6.  <xref:System.Windows.Forms.Panel> コントロールの `AutoSizeMode` プロパティの値を <xref:System.Windows.Forms.AutoSizeMode> に設定します。  
+  
+     <xref:System.Windows.Forms.Panel> コントロールのサイズが自動的に変更され、<xref:System.Windows.Forms.Button> コントロールが囲まれます。  <xref:System.Windows.Forms.Panel> コントロールのサイズは変更できません。  
+  
+7.  <xref:System.Windows.Forms.Button> コントロールを <xref:System.Windows.Forms.Panel> コントロールの左上隅の方向にドラッグします。  
+  
+     <xref:System.Windows.Forms.Button> コントロールの新しい位置に合わせて、<xref:System.Windows.Forms.Panel> コントロールのサイズが変更されます。  
+  
+## 次の手順  
+ Windows フォーム アプリケーションにコントロールを配置するためのレイアウト機能は、他にも数多くあります。  次のような組み合わせを試すことができます。  
+  
+-   <xref:System.Windows.Forms.TableLayoutPanel> コントロールを使用してフォームをビルドします。  詳細については、「[チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)」を参照してください。  <xref:System.Windows.Forms.TableLayoutPanel> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの値、およびその子コントロールの <xref:System.Windows.Forms.Control.Margin%2A> プロパティの値を変更してみてください。  
+  
+-   また、<xref:System.Windows.Forms.FlowLayoutPanel> コントロールを使用して同じ内容を試みます。  詳細については、「[チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)」を参照してください。  
+  
+-   <xref:System.Windows.Forms.Panel> コントロール内で子コントロールのドッキングを試みます。  <xref:System.Windows.Forms.Control.Padding%2A> プロパティは、<xref:System.Windows.Forms.ScrollableControl.DockPadding%2A> プロパティをより一般化したものです。機能を確認するには、<xref:System.Windows.Forms.Panel> コントロール内に子コントロールを配置し、その子コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  次に、<xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティをさまざまな値に変更して変化を確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.AutoSize%2A>   
+ <xref:System.Windows.Forms.ScrollableControl.DockPadding%2A>   
+ <xref:System.Windows.Forms.Control.Margin%2A>   
+ <xref:System.Windows.Forms.Control.Padding%2A>   
+ [AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)   
+ [チュートリアル : TableLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-tablelayoutpanel.md)   
+ [チュートリアル : FlowLayoutPanel を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-a-flowlayoutpanel.md)   
+ [チュートリアル : スナップ線を使用した Windows フォーム上のコントロールの配置](../../../../docs/framework/winforms/controls/walkthrough-arranging-controls-on-windows-forms-using-snaplines.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md b/docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md
new file mode 100644
index 00000000000..7e25a006e26
--- /dev/null
+++ b/docs/framework/winforms/controls/windows-forms-controls-used-to-list-options.md
@@ -0,0 +1,67 @@
+---
+title: "オプションのリストを表示するための Windows フォーム コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "オプションの一覧 (Windows フォームの)"
+  - "Windows フォーム コントロール, 一覧表示 (オプションを)"
+ms.assetid: 5bc064c7-bc1f-4b62-8f4b-252f864b118e
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# オプションのリストを表示するための Windows フォーム コントロール
+オプションのリストをユーザーが選択できるようにするには、Windows フォームにさまざまなコントロールを追加します。  ユーザーの入力をどれだけ制限するかに応じて、<xref:System.Windows.Forms.ListBox> コントロール、<xref:System.Windows.Forms.ComboBox> コントロール、または <xref:System.Windows.Forms.CheckedListBox> コントロールを追加できます。  どのコントロールが最適であるかを判断するには、以下のリンクを使用してください。  
+  
+## このセクションの内容  
+ [ListBox の代わりに Windows フォーム ComboBox を使用する場合](../../../../docs/framework/winforms/controls/when-to-use-a-windows-forms-combobox-instead-of-a-listbox.md)  
+ Windows フォームの制限とニーズに応じて適切なリスト ベース コントロールを推奨します。  
+  
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールの特定の項目にアクセスする](../../../../docs/framework/winforms/controls/access-specific-items-in-a-wf-combobox-listbox-or-checkedlistbox.md)  
+ リスト内のどの項目が指定された位置に表示されるかをプログラミングによって判断する方法について説明します。  
+  
+ [方法 : Windows フォームの ComboBox、ListBox、または CheckedListBox コントロールに項目を追加または削除する](../../../../docs/framework/winforms/controls/add-and-remove-items-from-a-wf-combobox.md)  
+ コントロールの項目のリスト内の項目を追加または削除する方法について説明します。  
+  
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールのルックアップ テーブルを作成する](../../../../docs/framework/winforms/controls/create-a-lookup-table-for-a-wf-combobox-listbox.md)  
+ フォーム データを使いやすい形式で表示および保持する方法について説明します。  
+  
+ [方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする ](../../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md)  
+ リスト ベースのコントロールをデータ ソースに連結する方法について説明します。  
+  
+ [方法 : Windows フォーム ComboBox、ListBox、または CheckedListBox コントロールを並べ替える](../../../../docs/framework/winforms/controls/sort-the-contents-of-a-wf-combobox-listbox-or-checkedlistbox-control.md)  
+ データ ソースにあるリスト データを並べ替える方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.CheckedListBox>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.ComboBox>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.ListBox>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [CheckedListBox コントロールの概要](../../../../docs/framework/winforms/controls/checkedlistbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [ComboBox コントロールの概要](../../../../docs/framework/winforms/controls/combobox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [ListBox コントロールの概要](../../../../docs/framework/winforms/controls/listbox-control-overview-windows-forms.md)  
+ このコントロールの用途、主な機能、およびプロパティについて説明します。  
+  
+ [Windows フォームで使用するコントロール](../../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)  
+ 使用方法に関する情報へのリンクを含む、Windows フォーム コントロールの完全なリストを提供します。
\ No newline at end of file
diff --git a/docs/framework/winforms/creating-a-new-windows-form.md b/docs/framework/winforms/creating-a-new-windows-form.md
new file mode 100644
index 00000000000..ec1cb54daca
--- /dev/null
+++ b/docs/framework/winforms/creating-a-new-windows-form.md
@@ -0,0 +1,52 @@
+---
+title: "新しい Windows フォームの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 作成 (新しいフォームを)"
+  - "Windows フォーム, はじめに"
+ms.assetid: c725559c-803e-4725-80fa-96aba93de29a
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 新しい Windows フォームの作成
+このトピックでは、初めての Windows フォーム アプリケーションを作成する方法について説明したトピックへのリンクを示します。  また、このセクションのトピックでは、Windows フォーム アプリケーションを作成する際に理解しておくべき基本的な用語とガイドラインもいくつか紹介します。  .  Windows フォーム アプリケーションとそこで使用できるコントロール、イベントとイベント処理、ユーザー入力の処理方法の詳細については、関連トピックの一覧を参照してください。  
+  
+## このセクションの内容  
+ [Windows フォームの座標](../../../docs/framework/winforms/windows-forms-coordinates.md)  
+ クライアント座標と画面座標について説明します。  
+  
+ [方法 : コマンド ラインから Windows フォーム アプリケーションを作成する](../../../docs/framework/winforms/how-to-create-a-windows-forms-application-from-the-command-line.md)  
+ 基本的な Windows フォームを作成し、コマンド ラインからコンパイルする方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Form>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.Windows.Forms.Control>  
+ このクラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [ユーザーの入力の処理](../../../docs/framework/winforms/controls/handling-user-input.md)  
+ Windows フォーム アプリケーションにおけるユーザー入力とその処理方法について説明したトピックへのリンクを示します。  
+  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)  
+ Windows フォーム アプリケーションでイベントを処理する方法について説明したトピックへのリンクを示します。  
+  
+ [Windows フォームの表示形式の変更](../../../docs/framework/winforms/changing-the-appearance-of-windows-forms.md)  
+ Windows フォーム アプリケーションの外観を変更する方法について説明したトピックへのリンクを示します。  
+  
+ [Windows フォーム コントロールの機能別一覧](../../../docs/framework/winforms/controls/windows-forms-controls-by-function.md)  
+ Windows フォーム アプリケーションで使用できるコントロールについて説明したトピックへのリンクを示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/creating-event-handlers-in-windows-forms.md b/docs/framework/winforms/creating-event-handlers-in-windows-forms.md
new file mode 100644
index 00000000000..ebb19f20355
--- /dev/null
+++ b/docs/framework/winforms/creating-event-handlers-in-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "Windows フォーム内でのイベント ハンドラーの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イベント ハンドラー [Windows フォーム]"
+  - "イベント処理 [Windows フォーム]"
+  - "イベント [Windows フォーム], イベント ハンドラー"
+  - "Windows フォーム コントロール, イベント処理"
+  - "Windows フォーム, イベント処理"
+ms.assetid: 6514e530-c6b8-489c-a8d2-eda7b7072701
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# Windows フォーム内でのイベント ハンドラーの作成
+イベント ハンドラーは、ユーザーがボタンをクリックする、またはメッセージ キューがメッセージを受信するなどのイベントが発生したときに実行するアクションを決定する、コード内の手順です。  イベントが発生すると、そのイベントを受信した一つまたは複数のイベント ハンドラーが実行されます。  イベントは複数のハンドラーに割り当てられ、特定のイベントを処理するメソッドは動的に変更できます。  イベント ハンドラーを作成するには、Windows フォーム デザイナーを使用することもできます。  
+  
+## このセクションの内容  
+ [イベントの概要](../../../docs/framework/winforms/events-overview-windows-forms.md)  
+ イベント モデルおよびデリゲートの役割を説明します。  
+  
+ [イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)  
+ イベントを処理する方法について説明します。  
+  
+ [方法 : Windows フォームで実行時にイベント ハンドラーを作成する](../../../docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md)  
+ システム イベントおよびユーザー イベントへの動的な応答の手順を説明します。  
+  
+ [方法 : Windows フォームの 1 つのイベント ハンドラーに複数のイベントを関連付ける](../../../docs/framework/winforms/how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md)  
+ イベントを通じて、複数のコントロールに同じ機能を割り当てる手順について説明します。  
+  
+ [Windows フォームのイベントの順序](../../../docs/framework/winforms/order-of-events-in-windows-forms.md)  
+ Windows フォーム コントロールで発生するイベントの順序について説明します。  
+  
+ [方法 : デザイナーを使用してイベント ハンドラーを作成する](http://msdn.microsoft.com/ja-jp/8461e9b8-14e8-406f-936e-3726732b23d2)  
+ Windows フォーム デザイナーを使用してイベント ハンドラーを作成する方法について説明します。  
+  
+## 関連項目  
+ [イベント](../../../docs/standard/events/index.md)  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用したイベントの処理および発生に関するトピックへのリンクを提供します。  
+  
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)  
+ 継承されたコンポーネントでイベント ハンドラーに生じる一般的な問題を一覧表示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/data-binding-and-windows-forms.md b/docs/framework/winforms/data-binding-and-windows-forms.md
new file mode 100644
index 00000000000..7c600f89773
--- /dev/null
+++ b/docs/framework/winforms/data-binding-and-windows-forms.md
@@ -0,0 +1,70 @@
+---
+title: "データ連結と Windows フォーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, Windows フォーム"
+  - "データ [Windows フォーム], 複合データ バインド"
+  - "データ [Windows フォーム], データ バインド"
+  - "データ [Windows フォーム], 単純データ バインディング"
+  - "データ バインド, Windows フォーム"
+  - "データ バインド コントロール, Windows フォーム"
+  - "ルックアップ テーブル, データ バインド"
+  - "マスター/詳細リスト"
+  - "レポート, Windows フォーム"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: 419aac5e-819b-4aad-88b0-73a2f8c0bd27
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# データ連結と Windows フォーム
+Windows フォームでは、従来のデータ ソースだけでなく、データを含むほぼすべての構造にバインドできます。  実行時に計算する値、ファイルから読み取る値、または他のコントロールの値から派生する値の配列にバインドできます。  
+  
+ さらに、任意のコントロールのプロパティをデータ ソースにバインドできます。  従来のデータ バインディングでは、通常は <xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティなどの表示プロパティをデータ ソースにバインドします。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用すると、バインディングによってその他のプロパティを設定することもできます。  バインディングを使用して、次のタスクを実行できます。  
+  
+-   イメージ コントロールのグラフィックの設定。  
+  
+-   1 つ以上のコントロールの背景色の設定。  
+  
+-   コントロール サイズの設定。  
+  
+ 基本的には、データ バインディングは、フォーム上の任意のコントロールの実行時にアクセス可能なプロパティを自動的に設定する方法です。  
+  
+## データ バインディングの種類  
+ Windows フォームでは、単純バインディングと複合バインディングの 2 種類のデータ バインディングを利用できます。  それぞれに異なる利点があります。  
+  
+|データ バインディングの種類|説明|  
+|--------------------|--------|  
+|単純データ バインディング|データセット テーブル内の列の値など、1 つのデータ要素にバインドするコントロールの機能。  これは、<xref:System.Windows.Forms.TextBox> コントロールや <xref:System.Windows.Forms.Label> コントロールなどのコントロールで一般的に使用される種類のバインディングです。これらのコントロールでは通常、1 つの値のみが表示されます。  実際には、コントロールのどのプロパティもデータベース内のフィールドにバインドできます。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] に、この機能の広範なサポートがあります。<br /><br /> 詳細については、次のトピックを参照してください。<br /><br /> -   [データ連結に関連するインターフェイス](../../../docs/framework/winforms/interfaces-related-to-data-binding.md)<br />-   [方法 : Windows フォームでデータ間を移動する](../../../docs/framework/winforms/how-to-navigate-data-in-windows-forms.md)<br />-   [方法 : Windows フォームに単純バインド コントロールを作成する](../../../docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md)|  
+|複合データ バインディング|複数のデータ要素、一般的にはデータベース内の複数のレコードにバインドするコントロールの機能。  複合バインディングは、リストベース バインディングとも呼ばれます。  複合バインディングをサポートするコントロールの例には、<xref:System.Windows.Forms.DataGridView>、<xref:System.Windows.Forms.ListBox>、および <xref:System.Windows.Forms.ComboBox> の各コントロールがあります。  複合データ バインディングの例については、「[方法 : Windows フォームの ComboBox または ListBox コントロールをデータにバインドする ](../../../docs/framework/winforms/controls/how-to-bind-a-windows-forms-combobox-or-listbox-control-to-data.md)」を参照してください。|  
+  
+## BindingSource コンポーネント  
+ データ バインディングを単純化するために、Windows フォームでは、データ ソースを <xref:System.Windows.Forms.BindingSource> コンポーネントにバインドしてから、コントロールを <xref:System.Windows.Forms.BindingSource> にバインドできます。  <xref:System.Windows.Forms.BindingSource> は、単純バインディングまたは複合バインディングのシナリオで使用できます。  いずれの場合も、<xref:System.Windows.Forms.BindingSource> はデータ ソースとバインドされたコントロールの間の媒介として機能し、変更通知、通貨管理などのサービスを提供します。  
+  
+## データ バインディングを使用する一般的なシナリオ  
+ ほぼすべての商用アプリケーションで、通常はデータ バインディングによってある種類のデータ ソースから別の種類のデータ ソースに読み取られた情報を使用します。  次のリストに、データの表示および操作の方法としてデータ バインディングを使用する最も一般的なシナリオをいくつか示します。  
+  
+|シナリオ|説明|  
+|----------|--------|  
+|レポート|レポートは、印刷された文書でデータを表示および集計する柔軟な方法を提供します。  データ ソースの選択したコンテンツを画面またはプリンターに出力するレポートを作成することは、非常に一般的に行われます。  一般的なレポートには、リスト、請求書、および概要などがあります。  通常、項目はリストの列として並べられ、サブ項目が各リスト項目に分類されますが、データに最も適したレイアウトをユーザーが選択する必要があります。|  
+|データ エントリ|大量の関連データを入力したり、ユーザーに情報の入力を求めたりする場合は、データ エントリ フォームを使用する方法が一般的です。  ユーザーは、テキスト ボックス、オプション ボタン、ドロップダウン リスト、およびチェック ボックスを使用して、情報を入力したり、オプションを選択したりできます。  情報は送信され、入力された情報に基づく構造を持つデータベースに格納されます。|  
+|マスター\/詳細リレーションシップ|マスター\/詳細アプリケーションは、関連データを表現するための形式の 1 つです。  具体的には、2 つのデータ テーブルと、それらを結合する関係があります。典型的なビジネスの例では、"顧客" テーブルと "注文" テーブルがあり、それらの間には、顧客とそれに対応する注文を結合する関係があります。  Windows フォームの 2 つの <xref:System.Windows.Forms.DataGridView> コントロールを持つマスター\/詳細アプリケーションの作成の詳細については、「[方法 : Windows フォームの 2 つの DataGridView コントロールを使用してマスター\/詳細形式のフォームを作成する](../../../docs/framework/winforms/controls/create-a-master-detail-form-using-two-datagrids.md)」を参照してください。|  
+|ルックアップ テーブル|別の一般的なデータ表示\/操作シナリオに、テーブル ルックアップがあります。  多くの場合、より大きなデータ表示の一部として、<xref:System.Windows.Forms.ComboBox> コントロールを使用してデータを表示および操作します。  重要な点は、<xref:System.Windows.Forms.ComboBox> コントロールで表示されるデータは、データベースに書き込まれるデータとは異なることです。  たとえば、食料品店から入手できる項目を表示する <xref:System.Windows.Forms.ComboBox> コントロールがあり、製品の名前 \(パン、牛乳、卵\) を表示するとします。  しかし、データベース内での情報の取得を容易にしたり、データベースを正規化したりするには、ある注文の特定の項目に関する情報を項目番号 \(\#501、\#603 など\) で格納する必要がある場合があります。  そのため、フォームの <xref:System.Windows.Forms.ComboBox> コントロールにある食料品項目の "わかりやすい名前" と、注文に表示される該当する項目番号との間には暗黙的なつながりがあります。  これがテーブル ルックアップの本質です。  詳細については、「[方法 : Windows フォーム BindingSource コンポーネントを使用してルックアップ テーブルを作成する](../../../docs/framework/winforms/controls/how-to-create-a-lookup-table-with-the-windows-forms-bindingsource-component.md)」を参照してください。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.Binding>   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [方法 : データ ソースに Windows フォーム DataGrid コントロールをバインドする](../../../docs/framework/winforms/controls/how-to-bind-the-windows-forms-datagrid-control-to-a-data-source.md)   
+ [BindingSource コンポーネント](../../../docs/framework/winforms/controls/bindingsource-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/data-sources-supported-by-windows-forms.md b/docs/framework/winforms/data-sources-supported-by-windows-forms.md
new file mode 100644
index 00000000000..8b8581af9d4
--- /dev/null
+++ b/docs/framework/winforms/data-sources-supported-by-windows-forms.md
@@ -0,0 +1,73 @@
+---
+title: "Windows フォームがサポートするデータ ソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "配列 [Windows フォーム]"
+  - "コレクション [Windows フォーム], バインド"
+  - "データ [Windows フォーム], データ プロバイダー"
+  - "データ プロバイダー [Windows フォーム]"
+  - "データ ソース [Windows フォーム]"
+  - "DataColumn クラス"
+  - "DataSet クラス, バインディングと Windows フォーム"
+  - "DataTable クラス, バインディングと Windows フォーム"
+  - "DataView クラス, バインディングと Windows フォーム"
+  - "DataViewManager クラス, バインディングと Windows フォーム"
+  - "OLE DB プロバイダー, Windows フォーム"
+  - "Windows フォーム, データ バインド"
+  - "Windows フォーム, ソース データ"
+ms.assetid: 3d2c43f6-462b-4d35-9c86-13e9afe012e1
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォームがサポートするデータ ソース
+従来、データ バインディングは、データベースに格納されたデータをアプリケーション内で利用するために使用されてきました。  Windows フォームのデータ バインディングでは、データベースのデータだけでなく、配列やコレクションなど、一定の条件を満たす他の構造のデータにもアクセスできます。  
+  
+## バインドできる構造  
+ Windows フォームでは、シンプル オブジェクトに対するバインド \(単純バインディング\) から、ADO.NET データ テーブルなどの複雑なリストに対するバインド \(複合バインディング\) まで、さまざまな構造にバインドできます。  単純バインディングでは、Windows フォームは、シンプル オブジェクトのパブリック プロパティに対するバインディングをサポートしています。  Windows フォームのリストベース バインディングでは、一般に、オブジェクトが <xref:System.Collections.IList> インターフェイスまたは <xref:System.ComponentModel.IListSource> インターフェイスをサポートしていることが必要です。  加えて、<xref:System.Windows.Forms.BindingSource> コンポーネントを通じてバインドする場合には、<xref:System.Collections.IEnumerable> インターフェイスをサポートするオブジェクトに対してバインドできます。  データ バインディングに関連するインターフェイスの詳細については、「[データ連結に関連するインターフェイス](../../../docs/framework/winforms/interfaces-related-to-data-binding.md)」を参照してください。  
+  
+ 次に示すのは、Windows フォームでバインドできる構造の一覧です。  
+  
+ <xref:System.Windows.Forms.BindingSource>  
+ <xref:System.Windows.Forms.BindingSource> は、Windows フォームのデータ ソースとしては最も一般的で、データ ソースと Windows フォーム コントロールの間のプロキシの役割を果たします。  <xref:System.Windows.Forms.BindingSource> の使用パターンとしては、コントロールを <xref:System.Windows.Forms.BindingSource> にバインドし、<xref:System.Windows.Forms.BindingSource> をデータ ソース \(たとえば、ADO.NET データ テーブルやビジネス オブジェクト\) にバインドするという形が一般的です。  <xref:System.Windows.Forms.BindingSource> は、データ バインディングのサポートを実現し、そのレベルを向上させるサービスを備えています。  たとえば、Windows フォームのリストベースのコントロール \(<xref:System.Windows.Forms.DataGridView> や <xref:System.Windows.Forms.ComboBox> など\) は、<xref:System.Collections.IEnumerable> データ ソースへのバインディングを直接的にはサポートしていませんが、<xref:System.Windows.Forms.BindingSource> を通じてバインドすることにより、それが可能になります。  この場合、<xref:System.Windows.Forms.BindingSource> はデータ ソースを <xref:System.Collections.IList> に変換します。  
+  
+ シンプル オブジェクト  
+ Windows フォームは、コントロールのプロパティをオブジェクト インスタンスのパブリック プロパティにバインドする、<xref:System.Windows.Forms.Binding> 型を使用したデータ バインディングをサポートします。  また、Windows フォームは、<xref:System.Windows.Forms.BindingSource> を使用したときには、リストベースのコントロール \(<xref:System.Windows.Forms.ListControl> など\) からオブジェクト インスタンスへのバインディングをサポートします。  
+  
+ 配列またはコレクション  
+ リストをデータ ソースとして使用するためには、<xref:System.Collections.IList> インターフェイスを実装する必要があります。その一例は、<xref:System.Array> クラスのインスタンスである配列です。  配列の詳細については、「[How to: Create an Array of Objects \(Visual Basic\)](http://msdn.microsoft.com/ja-jp/6b64e069-0387-400c-9081-3bdc581020c3)」を参照してください。  
+  
+ 一般に、データ バインディング用のオブジェクトのリストを作成するときは、<xref:System.ComponentModel.BindingList%601> を使用する必要があります。  <xref:System.ComponentModel.BindingList%601> は <xref:System.ComponentModel.IBindingList> インターフェイスのジェネリック バージョンです。  <xref:System.ComponentModel.IBindingList> インターフェイスは、<xref:System.Collections.IList> インターフェイスを拡張したもので、双方向のデータ バインディングに必要なプロパティ、メソッド、およびイベントが追加されています。  
+  
+ <xref:System.Collections.IEnumerable>  
+ Windows フォーム コントロールは、<xref:System.Windows.Forms.BindingSource> コンポーネントを通じてバインドする場合には、<xref:System.Collections.IEnumerable> インターフェイスのみをサポートするデータ ソースにバインドできます。  
+  
+ [!INCLUDE[vstecado](../../../includes/vstecado-md.md)] データ オブジェクト  
+ [!INCLUDE[vstecado](../../../includes/vstecado-md.md)] には、バインディングに適したデータ構造がいくつか用意されています。  各データ構造は、洗練の度合いと複雑さにおいてそれぞれ異なります。  
+  
+-   <xref:System.Data.DataColumn>.  1 つのテーブルは複数の列で構成されるという点で、<xref:System.Data.DataColumn> は <xref:System.Data.DataTable> の基本的なビルド ブロックです。  各 <xref:System.Data.DataColumn> オブジェクトには <xref:System.Data.DataColumn.DataType%2A> プロパティがあります。このプロパティは、列に保持されるデータの種類 \(自動車を表すテーブルの場合は自動車の型など\) を決定します。  データ テーブル内の列に、コントロール \(<xref:System.Windows.Forms.TextBox> コントロールの <xref:System.Windows.Forms.Control.Text%2A> プロパティなど\) を単純バインドできます。  
+  
+-   <xref:System.Data.DataTable>.  <xref:System.Data.DataTable> は、行と列で構成される、[!INCLUDE[vstecado](../../../includes/vstecado-md.md)] のテーブルの表現です。  データ テーブルは、<xref:System.Data.DataColumn> と <xref:System.Data.DataRow> という 2 つのコレクションを持ちます。前者は、当該のテーブルのデータの列を表し、そのテーブルに入力できるデータの種類は最終的にはこれにより決まります。後者は、当該のテーブルの行を表します。  データ テーブルに含まれる情報に対して、コントロールを複合バインドできます \(たとえば、<xref:System.Windows.Forms.DataGridView> コントロールからデータ テーブルに対するバインドなど\)。  ただし、<xref:System.Data.DataTable> にバインドすると、実際にはテーブルの既定のビューにバインドされます。  
+  
+-   <xref:System.Data.DataView>.  <xref:System.Data.DataView> は、1 つのデータ テーブルのカスタマイズされたビューであり、フィルター処理や並べ替えを行うことができます。  データ ビューは、複合連結コントロールで使用するデータの "スナップショット" です。  データ ビュー内のデータには単純バインドまたは複合バインドできますが、バインドしているのはクリーンな最新の状態のデータ ソースではなく、データの固定された "画像" であることに注意してください。  
+  
+-   <xref:System.Data.DataSet>.  <xref:System.Data.DataSet> は、データベース内のデータのテーブル、リレーションシップ、および制約のコレクションです。  データセット内のデータには単純バインドまたは複合バインドできますが、バインドしているのは <xref:System.Data.DataSet> の既定の <xref:System.Data.DataViewManager> \(次の項目を参照\) に対してであることに注意してください。  
+  
+-   <xref:System.Data.DataViewManager>.  <xref:System.Data.DataViewManager> は、<xref:System.Data.DataSet> 全体のカスタマイズされたビューです。<xref:System.Data.DataView> に似ていますが、リレーションシップが含まれています。  <xref:System.Data.DataViewManager.DataViewSettings%2A> コレクションを使用すると、指定したテーブルに対して <xref:System.Data.DataViewManager> に設定されているビューに、既定のフィルターや並べ替えオプションを設定できます。  
+  
+## 参照  
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/dialog-boxes-in-windows-forms.md b/docs/framework/winforms/dialog-boxes-in-windows-forms.md
new file mode 100644
index 00000000000..4a7fb790e32
--- /dev/null
+++ b/docs/framework/winforms/dialog-boxes-in-windows-forms.md
@@ -0,0 +1,56 @@
+---
+title: "Windows フォームのダイアログ ボックス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダイアログ ボックス, Windows フォーム"
+  - "ダイアログ, 使用 (Windows フォームで)"
+  - "Windows フォームのダイアログ ボックス"
+ms.assetid: d43d022b-451b-490d-9386-dc79d98fbf8a
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Windows フォームのダイアログ ボックス
+ダイアログ ボックスは、ユーザーとのやり取りおよび情報の取得のために使用します。  簡単に言えば、ダイアログ ボックスとは <xref:System.Windows.Forms.FormBorderStyle> 列挙値のプロパティが `FixedDialog` に設定されたフォームのことです。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の Windows フォーム デザイナーを使用して、独自のカスタム ダイアログ ボックスを作成できます。  `Label`、`Textbox`、および `Button` などのコントロールを追加し、ダイアログ ボックスを特定のニーズに合わせてカスタマイズできます。  また、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には \[**ファイルを開く**\] やメッセージ ボックスなどの定義済みダイアログ ボックスも用意されています。アプリケーションを開発するときに、これらの定義済みダイアログ ボックスを利用できます。  詳細については、「[ダイアログ ボックス コントロールおよびコンポーネント](../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)」を参照してください。  
+  
+## このセクションの内容  
+ [方法 : Windows フォームのダイアログ ボックスを表示する](../../../docs/framework/winforms/how-to-display-dialog-boxes-for-windows-forms.md)  
+ ダイアログ ボックスを表示する手順を示します。  
+  
+-   [方法 : 複数のプロパティを使用してダイアログ ボックス情報を個別に取得する](http://msdn.microsoft.com/library/56taefba\(v=vs.110\))  
+  
+-   [方法 : ダイアログ ボックスの親フォームから情報を取得する](http://msdn.microsoft.com/library/k70t19bb%20\(v=vs.110\))  
+  
+-   [ダイアログ ボックスへのユーザー入力](http://msdn.microsoft.com/library/1s9ws53w%20\(v=vs.110\))  
+  
+-   [方法 : ダイアログ ボックスの結果を取得する](http://msdn.microsoft.com/library/40x40td1%20\(v=vs.110\))  
+  
+-   [チュートリアル : オブジェクトによるダイアログ ボックス情報の一括取得](http://msdn.microsoft.com/library/cakx2hdw\(v=vs.110\))  
+  
+-   [方法 : ダイアログ ボックスを閉じて、ユーザー入力を保持する](http://msdn.microsoft.com/library/65ad5907%20\(v=vs.110\))  
+  
+-   [方法 : デザイン時にダイアログ ボックスを作成する](http://msdn.microsoft.com/library/55cz5x2c\(v=vs.110\))  
+  
+-   [方法: メッセージ ボックスを表示する](http://msdn.microsoft.com/library/3tt9e94f%20\(v=vs.110\))  
+  
+## 関連項目  
+ [ダイアログ ボックス コントロールおよびコンポーネント](../../../docs/framework/winforms/controls/dialog-box-controls-and-components-windows-forms.md)  
+ 定義済みダイアログ ボックス コントロールの一覧を示します。  
+  
+ [Windows フォームの表示形式の変更](../../../docs/framework/winforms/changing-the-appearance-of-windows-forms.md)  
+ Windows フォーム アプリケーションの外観を変更する方法について説明したトピックへのリンクを示します。  
+  
+ [TabControl コントロールの概要](../../../docs/framework/winforms/controls/tabcontrol-control-overview-windows-forms.md)  
+ ダイアログ ボックスにタブ コントロールを組み込む方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md b/docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md
new file mode 100644
index 00000000000..0c1f525b708
--- /dev/null
+++ b/docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md
@@ -0,0 +1,56 @@
+---
+title: "Windows フォームにおけるドラッグ アンド ドロップ機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ, Windows フォーム"
+  - "Windows フォーム, ドラッグ アンド ドロップ"
+ms.assetid: 65cd2c03-8782-474e-b958-cbe43eeb902c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームにおけるドラッグ アンド ドロップ機能
+Windows フォームには、ドラッグ アンド ドロップの動作を実装する一連のメソッド、イベント、およびクラスが含まれています。  このトピックでは、Windows フォームでのドラッグ アンド ドロップのサポートの概要について説明します。  「[ドラッグ アンド ドロップ操作とクリップボードのサポート](http://msdn.microsoft.com/library/fe5ebfwe\(v=vs.110\))」も参照してください。  
+  
+## ドラッグ アンド ドロップ操作の実行  
+ ドラッグ アンド ドロップ操作を実行するには、<xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.DoDragDrop%2A> メソッドを使用します。  ドラッグ アンド ドロップ操作の実行方法の詳細については、「<xref:System.Windows.Forms.Control.DoDragDrop%2A>」を参照してください。  ドラッグ アンド ドロップ操作が開始される前に、マウス ポインターがドラッグされる四角形を取得するには、<xref:System.Windows.Forms.SystemInformation> クラスの <xref:System.Windows.Forms.SystemInformation.DragSize%2A> プロパティを使用します。  
+  
+## ドラッグ アンド ドロップ操作に関連するイベント  
+ ドラッグ アンド ドロップ操作のイベントには、ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントと、ドラッグ アンド ドロップ操作のソースで発生するイベントの 2 つのカテゴリがあります。  
+  
+### 現在のターゲットでのイベント  
+ 次の表は、ドラッグ アンド ドロップ操作の現在のターゲットで発生するイベントを示します。  
+  
+|マウス イベント|説明|  
+|--------------|--------|  
+|<xref:System.Windows.Forms.Control.DragEnter>|このイベントは、オブジェクトがコントロールの境界内にドラッグされると発生します。  このイベントのハンドラーは、型 <xref:System.Windows.Forms.DragEventArgs> の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.DragOver>|このイベントは、マウス ポインターがコントロールの境界内にある間にオブジェクトがドラッグされるときに発生します。  このイベントのハンドラーは、型 <xref:System.Windows.Forms.DragEventArgs> の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.DragDrop>|このイベントは、ドラッグ アンド ドロップ操作が完了したときに発生します。  このイベントのハンドラーは、型 <xref:System.Windows.Forms.DragEventArgs> の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.DragLeave>|このイベントは、オブジェクトがコントロールの境界外にドラッグされたときに発生します。  このイベントのハンドラーは、型 <xref:System.EventArgs> の引数を受け取ります。|  
+  
+ <xref:System.Windows.Forms.DragEventArgs> クラスは、マウスのポインターの場所、マウス ボタンとキーボードの修飾子キーの現在の状態、ドラッグされているデータ、およびドラッグ イベントのソースによって許可される操作と操作に対するターゲットのドロップの効果を指定する <xref:System.Windows.Forms.DragDropEffects> の値を提供します。  
+  
+### ソースのイベント  
+ 次の表は、ドラッグ アンド ドロップ操作のソースで発生するイベントを示します。  
+  
+|マウス イベント|説明|  
+|--------------|--------|  
+|<xref:System.Windows.Forms.Control.GiveFeedback>|このイベントは、ドラッグ操作中に発生します。  マウス ポインターを変更するなど、ドラッグ アンド ドロップ操作が実行されていることを示す視覚上の手掛かりをユーザーに示す機会を提供します。  このイベントのハンドラーは、型 <xref:System.Windows.Forms.GiveFeedbackEventArgs> の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.QueryContinueDrag>|このイベントは、ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作をキャンセルする必要があるかどうかを決定できるようにします。  このイベントのハンドラーは、型 <xref:System.Windows.Forms.QueryContinueDragEventArgs> の引数を受け取ります。|  
+  
+ <xref:System.Windows.Forms.QueryContinueDragEventArgs> クラスは、マウス ボタンとキーボードの修飾子キーの現在の状態、ESC キーを押したかどうかを指定する値、およびドラッグ アンド ドロップ操作を続行するかどうかを指定するために設定できる <xref:System.Windows.Forms.DragAction> の値を提供します。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/ensure-the-selected-row-in-a-child-table-correct.md b/docs/framework/winforms/ensure-the-selected-row-in-a-child-table-correct.md
new file mode 100644
index 00000000000..bc892fb7b9f
--- /dev/null
+++ b/docs/framework/winforms/ensure-the-selected-row-in-a-child-table-correct.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : 子テーブルの選択行が現在位置を保持することを保証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キャッシュ [.NET Framework], 子の位置"
+  - "子の位置"
+  - "子テーブルの行の選択"
+  - "現在の子の位置"
+  - "データ バインディング [.NET Framework], 行の選択"
+  - "マスター/詳細ビュー [Windows フォーム]"
+  - "マスター/詳細ビュー"
+  - "親/子ビュー [Windows フォーム]"
+  - "リセット (子の位置を)"
+  - "行位置 [Windows フォーム]"
+ms.assetid: c5fa2562-43a4-46fa-a604-52d8526a87bd
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 子テーブルの選択行が現在位置を保持することを保証する
+多くの場合、Windows フォームでデータ バインディングを処理するときは、いわゆる親\/子ビューまたはマスター\/詳細ビューにデータを表示します。  これは、同一ソースのデータが、2 つのコントロールに表示されるデータ バインディング シナリオを示します。  片方のコントロールで選択を変更すると、他方のコントロールに表示されるデータが変化します。  たとえば、第 1 のコントロールに顧客リストが含まれ、第 2 のコントロールに、第 1 のコントロールで選択された顧客に関連する注文リストが含まれます。  
+  
+ .NET Framework Version 2.0 以降、親\/子ビューにデータを表示する場合は、子テーブルで現在選択されている行が、親テーブルの先頭行にリセットされないようにするために、追加の手順を実行する必要があります。  そのためには、子テーブルの位置をキャッシュし、親テーブルが変更された後で位置をリセットする必要があります。  通常、子テーブルのリセットは、親テーブルの行のフィールドが初めて変更されたときに発生します。  
+  
+### 子テーブルの現在位置をキャッシュするには  
+  
+1.  子リストの位置を格納する整数変数と、子の位置をキャッシュするかどうかを示すブール変数を宣言します。  
+  
+     [!code-csharp[System.Windows.Forms.CurrencyManagerReset#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.CurrencyManagerReset#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/VB/Form1.vb#4)]  
+  
+2.  バインディングの <xref:System.Windows.Forms.CurrencyManager> の <xref:System.Windows.Forms.CurrencyManager.ListChanged> イベントを処理し、<xref:System.ComponentModel.ListChangedType> の <xref:System.ComponentModel.ListChangedType> をチェックします。  
+  
+3.  <xref:System.Windows.Forms.CurrencyManager> の現在位置をチェックします。  それがリストの最初のエントリ \(通常は 0\) よりも大きい場合は、変数に保存します。  
+  
+     [!code-csharp[System.Windows.Forms.CurrencyManagerReset#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.CurrencyManagerReset#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/VB/Form1.vb#2)]  
+  
+4.  親リストの親現在位置マネージャーの <xref:System.Windows.Forms.BindingManagerBase.CurrentChanged> イベントを処理します。  ハンドラーで、キャッシュ シナリオではないことを示すブール値を設定します。  <xref:System.Windows.Forms.BindingManagerBase.CurrentChanged> が発生した場合、親の変更はリストの位置の変更であり、項目値の変更ではありません。  
+  
+     [!code-csharp[System.Windows.Forms.CurrencyManagerReset#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/CS/Form1.cs#5)]
+     [!code-vb[System.Windows.Forms.CurrencyManagerReset#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/VB/Form1.vb#5)]  
+  
+### 子の位置をリセットするには  
+  
+1.  子のバインディングの <xref:System.Windows.Forms.CurrencyManager> の <xref:System.Windows.Forms.BindingManagerBase.PositionChanged> イベントを処理します。  
+  
+2.  子テーブルの位置を、前の手順で保存したキャッシュ位置にリセットします。  
+  
+     [!code-csharp[System.Windows.Forms.CurrencyManagerReset#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.CurrencyManagerReset#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/VB/Form1.vb#3)]  
+  
+## 使用例  
+ 子テーブルの <xref:System.Windows.Forms.CurrencyManager> の現在位置を保存し、親テーブルの編集が完了した後でその位置をリセットする方法を次の例に示します。  この例には、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用して <xref:System.Data.DataSet> 内の 2 つのテーブルにバインドされた 2 つの <xref:System.Windows.Forms.DataGridView> コントロールが含まれます。  この 2 つのテーブルの間にリレーションシップが確立され、そのリレーションシップが <xref:System.Data.DataSet> に追加されます。  子テーブル内の位置は、デモを目的として、3 行目に初期設定されています。  
+  
+ [!code-csharp[System.Windows.Forms.CurrencyManagerReset#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.CurrencyManagerReset#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.CurrencyManagerReset/VB/Form1.vb#1)]  
+  
+ このコード例をテストするには、次の手順を実行します。  
+  
+1.  例を実行します。  
+  
+2.  \[**Cache and reset position**\] \(位置をキャッシュしてリセットする\) チェック ボックスがオンであることを確認します。  
+  
+3.  \[**Clear parent field**\] \(親フィールドのクリア\) ボタンをクリックして、親テーブルのフィールドを変更します。  子テーブル内の選択行が変更されないことに注目してください。  
+  
+4.  例をいったん閉じてから、例を再実行します。  リセット動作は親行が初めて変更された場合のみ発生するので、この操作を実行する必要があります。  
+  
+5.  \[**Cache and reset position**\] \(位置をキャッシュしてリセットする\) チェック ボックスをオフにします。  
+  
+6.  \[**Clear parent field**\] \(親フィールドのクリア\) ボタンをクリックします。  子テーブル内の選択行が 1 行目に変更されることに注目してください。  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Data、System.Drawing、System.Windows.Forms、および System.XML の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細は、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ](../../../docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md)   
+ [BindingSource コンポーネント](../../../docs/framework/winforms/controls/bindingsource-component.md)   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/event-handlers-overview-windows-forms.md b/docs/framework/winforms/event-handlers-overview-windows-forms.md
new file mode 100644
index 00000000000..e86e6f24c5a
--- /dev/null
+++ b/docs/framework/winforms/event-handlers-overview-windows-forms.md
@@ -0,0 +1,60 @@
+---
+title: "イベント ハンドラーの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イベント ハンドラー, イベント ハンドラーの概要"
+  - "イベント処理, Windows フォーム"
+  - "Windows フォーム, イベント処理"
+ms.assetid: 228112e1-1711-42ee-8ffa-ff3555bffe66
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# イベント ハンドラーの概要 (Windows フォーム)
+イベント ハンドラーは、イベントに関連付けられたメソッドです。  イベントが発生すると、イベント ハンドラーのコードが実行されます。  各イベント ハンドラーには、イベントを適切に処理するためのパラメーターが 2 つ用意されています。  <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントのイベント ハンドラーの例を次に示します。  
+  
+```vb  
+Private Sub button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button1.Click  
+  
+End Sub  
+  
+```  
+  
+```csharp  
+private void button1_Click(object sender, System.EventArgs e)   
+{  
+  
+}  
+  
+```  
+  
+```cpp  
+private:  
+  void button1_Click(System::Object ^ sender,  
+    System::EventArgs ^ e)  
+  {  
+  
+  }  
+```  
+  
+ 最初のパラメーターは`sender`イベントを発生させたオブジェクトへの参照を提供します。  2 番目のパラメーター `e`では、処理されるイベントに応じた特定のオブジェクトを渡します。  このオブジェクトのプロパティ \(場合によってはメソッド\) を参照すると、マウス イベントのマウスの位置や、ドラッグ アンド ドロップ イベントで転送されるデータなどの情報を取得できます。  
+  
+ 通常、イベントごとに生成されるイベント ハンドラーでは、2 番目に指定されるイベント オブジェクトの種類がそれぞれ異なります。  <xref:System.Windows.Forms.Control.MouseDown> イベントや <xref:System.Windows.Forms.Control.MouseUp> イベントなどのイベント ハンドラーでは、2 番目のパラメーターが同じオブジェクト型になっています。  この種類のイベントでは、同じイベント ハンドラーを使用して両方のイベントを処理できます。  
+  
+ また、同じイベント ハンドラーを使用して、異なるコントロールに対する同じイベントを処理することもできます。  たとえば、フォームに <xref:System.Windows.Forms.RadioButton> コントロールのグループがある場合は、<xref:System.Windows.Forms.Control.Click> イベントに対して 1 つのイベント ハンドラーを作成し、各コントロールの <xref:System.Windows.Forms.Control.Click> イベントをこの単独のイベント ハンドラーにバインドできます。  詳細については、「[方法 : Windows フォームの 1 つのイベント ハンドラーに複数のイベントを関連付ける](../../../docs/framework/winforms/how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)   
+ [イベントの概要](../../../docs/framework/winforms/events-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/events-overview-windows-forms.md b/docs/framework/winforms/events-overview-windows-forms.md
new file mode 100644
index 00000000000..53abcef86f5
--- /dev/null
+++ b/docs/framework/winforms/events-overview-windows-forms.md
@@ -0,0 +1,57 @@
+---
+title: "イベントの概要 (Windows フォーム) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "デリゲート [Windows フォーム], イベント"
+  - "デリゲート [Windows フォーム], マルチキャスト"
+  - "イベント [Windows フォーム], イベントの概要"
+  - "マルチキャスト イベント デリゲート"
+  - "Windows フォーム コントロール, イベント"
+  - "Windows フォーム, イベント処理"
+ms.assetid: 814a6a43-a312-4791-88d8-f75f9a4f8c4c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# イベントの概要 (Windows フォーム)
+イベントとは、プログラマが応答できる、つまり、コードを使って "処理" できるアクションのことです。  イベントは、マウスのクリックやキーを押すなどのユーザー アクション、プログラム コードまたはシステムによって生成されます。  
+  
+ イベント ドリブン アプリケーションでは、イベントに応答してコードが実行されます。  各フォームおよびコントロールは、定義済みのイベント セットを公開しており、プログラマはそれらに対応するプログラムを作成できます。  これらのイベントの 1 つが発生したときに、関連するイベント ハンドラーにコードがある場合は、そのコードが呼び出されます。  
+  
+ オブジェクトが発生させるイベントにはさまざまな種類がありますが、その多くがほとんどのコントロールで共通です。  たとえば、<xref:System.Windows.Forms.Control.Click> イベントは、ほとんどのオブジェクトで処理されます。  ユーザーがフォームをクリックすると、フォームの <xref:System.Windows.Forms.Control.Click> イベント ハンドラー内のコードが実行されます。  
+  
+> [!NOTE]
+>  イベントの多くは、他のイベントと共に発生します。  たとえば、<xref:System.Windows.Forms.Control.DoubleClick> イベントが発生する場合は、<xref:System.Windows.Forms.Control.MouseDown>、<xref:System.Windows.Forms.Control.MouseUp>、および <xref:System.Windows.Forms.Control.Click> の各イベントが発生します。  
+  
+ イベントを発生させて処理する方法については、「[イベント](../../../docs/standard/events/index.md)」を参照してください。  
+  
+## デリゲートとその役割  
+ デリゲートは、主にイベント処理機構をビルドするために、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] 内で使用されるクラスです。  デリゲートは、[!INCLUDE[vcprvc](../../../includes/vcprvc-md.md)] やその他のオブジェクト指向言語で一般的に使用される関数ポインターに似ています。  ただし、関数ポインターとは異なり、デリゲートはオブジェクト指向で、タイプ セーフで、安全です。  また、関数ポインターには特定の関数への参照だけが含まれていますが、デリゲートはオブジェクトへの参照、およびそのオブジェクト内の 1 つ以上のメソッドへの参照で構成されています。  
+  
+ このイベント モデルでは、*デリゲート*を使用してイベント処理に使用するメソッドにイベントを関連付けます。  デリゲートを使用すると、ハンドラーのメソッドを指定することにより、イベント通知のための他のクラスを登録できます。  イベントが発生すると、デリゲートは関連付けられたメソッドを呼び出します。  デリゲートを定義する方法の詳細については、「[イベント](../../../docs/standard/events/index.md)」を参照してください。  
+  
+ デリゲートは、単一のメソッドまたは複数のメソッドに関連付けることができます。後者は、マルチキャストと呼ばれます。  イベントのデリゲートを作成する場合は、通常、ユーザー \(Windows フォーム デザイナー\) がマルチキャスト イベントを作成します。  例外は、1 回のイベントで複数回実行されることが論理的にあり得ないような特定のプロシージャ \(ダイアログ ボックスの表示など\) を呼び出すイベントです。  マルチキャスト デリゲートを作成する方法については、「[方法 : デリゲートを結合する \(マルチキャスト デリゲート\)](../Topic/How%20to:%20Combine%20Delegates%20\(Multicast%20Delegates\)\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+ マルチキャスト デリゲートは、関連付けられたメソッドの呼び出しリストを保持します。  マルチキャスト デリゲートでは、呼び出しリストにメソッドを追加する <xref:System.Delegate.Combine%2A> メソッド、およびリストからメソッドを削除する <xref:System.Delegate.Remove%2A> メソッドがサポートされています。  
+  
+ アプリケーションによってイベントが記録されると、コントロールは、そのイベント用のデリゲートを呼び出すことによってイベントを発生させます。  次に、デリゲートによって、関連付けられたメソッドが呼び出されます。  ほとんどの場合、デリゲート \(通常はマルチキャスト デリゲート\) では、呼び出しリストにある関連付けされた各メソッドが順番に呼び出されるため、一対多通知を実行できます。  この方法では、すべての登録と通知がデリゲートによって処理されるため、コントロールでは、イベント通知の対象となるオブジェクトのリストを保持する必要がありません。  
+  
+ デリゲートでは、複数のイベントを同じメソッドに関連付けし、多対一通知を実行することもできます。  たとえば、ボタンとメニューコマンドのクリック イベントで、同じデリゲートを呼び出すことができます。呼び出されたデリゲートによって単一のメソッドが呼び出されるので、どちらのイベントも同じように処理されます。  
+  
+ デリゲートと共に使用される関連付けの機構は動的です。デリゲートは、シグネチャがイベント ハンドラのシグネチャと一致する任意のメソッドに実行時に関連付けできます。  この機能によって、状況に応じて関連付けるメソッドを設定または変更したり、イベント ハンドラをコントロールに動的に関連付けることができます。  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)   
+ [イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/getting-started-with-windows-forms.md b/docs/framework/winforms/getting-started-with-windows-forms.md
new file mode 100644
index 00000000000..de02ba4dd7e
--- /dev/null
+++ b/docs/framework/winforms/getting-started-with-windows-forms.md
@@ -0,0 +1,69 @@
+---
+title: "Windows フォームについて | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Designer_System.Windows.Forms.Design.FormDocumentDesigner"
+  - "vb.wfc.formdesigner"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "はじめに, Windows フォーム"
+  - "Windows フォーム, はじめに"
+ms.assetid: a031aa58-5027-4082-b590-df7c12c77dec
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォームについて
+Windows フォームを使用すると、Windows ベースのパワフルなアプリケーションを作成できます。  以下のトピックには、Windows フォームのパワーを利用してデータの表示やユーザー入力の処理を行う方法、およびアプリケーションを簡単に、またセキュリティを強力に保護しながら配置する方法が詳細に説明されています。  
+  
+## このセクションの内容  
+ [Windows フォームの概要](../../../docs/framework/winforms/windows-forms-overview.md)  
+ Windows フォームとスマート クライアント アプリケーションの概要を示します。  
+  
+ [新しい Windows フォームの作成](../../../docs/framework/winforms/creating-a-new-windows-form.md)  
+ Windows フォーム アプリケーションの作成における基本的な概念について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)  
+ Windows フォームのイベント ハンドラーを作成する方法を説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームのサイズとスケールを調整する](../../../docs/framework/winforms/adjusting-the-size-and-scale-of-windows-forms.md)  
+ Windows フォームのサイズとスケールを調節する方法について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームの表示形式の変更](../../../docs/framework/winforms/changing-the-appearance-of-windows-forms.md)  
+ Windows フォーム アプリケーションの外観を変更する方法について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォーム コントロール](../../../docs/framework/winforms/controls/index.md)  
+ Windows フォームのコンロトールとコンポーネントの使い方について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームでのユーザー入力](../../../docs/framework/winforms/user-input-in-windows-forms.md)  
+ Windows フォーム アプリケーションでユーザーからの入力を処理する方法について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームのダイアログ ボックス](../../../docs/framework/winforms/dialog-boxes-in-windows-forms.md)  
+ Windows フォームで使用できるさまざまなダイアログ ボックスについて説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)  
+ Windows フォームのデータ バインディング アーキテクチャについて、およびそれを Windows フォーム アプリケーションで使用する方法について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームのセキュリティ](../../../docs/framework/winforms/windows-forms-security.md)  
+ セキュリティが強化された Windows フォーム アプリケーションを作成する方法について説明したトピックへのリンクが用意されています。  
+  
+ [Windows フォームの ClickOnce 配置](../../../docs/framework/winforms/clickonce-deployment-for-windows-forms.md)  
+ Windows フォーム アプリケーションを簡単に配置する方法について説明したトピックへのリンクが用意されています。  
+  
+ [方法 : Windows フォームのコレクションにアクセス キーを指定する](../../../docs/framework/winforms/how-to-access-keyed-collections-in-windows-forms.md)  
+ インデックスではなくキーを使用してコレクションにアクセスする方法について説明します。  
+  
+## 関連項目  
+ [Windows フォーム アプリケーションの拡張](../../../docs/framework/winforms/advanced/index.md)  
+ Windows フォーム アプリケーションを作成するための高度な概念について説明したトピックへのリンクが用意されています。
\ No newline at end of file
diff --git a/docs/framework/winforms/how-keyboard-input-works.md b/docs/framework/winforms/how-keyboard-input-works.md
new file mode 100644
index 00000000000..fc70698a7a3
--- /dev/null
+++ b/docs/framework/winforms/how-keyboard-input-works.md
@@ -0,0 +1,86 @@
+---
+title: "キーボード入力のしくみ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード入力, キーボード入力の概要"
+  - "キーボード, キーボード入力"
+  - "Windows フォーム, キーボード入力"
+ms.assetid: 9a29433c-a180-49bb-b74c-d187786584c8
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# キーボード入力のしくみ
+Windows フォームは、Windows メッセージに応答してキーボード イベントを発生させることにより、キーボード入力を処理します。  多くの Windows フォーム アプリケーションは、キーボード イベントを処理することによってキーボード入力を排他的に処理します。  しかし、高度なキーボード入力のシナリオ \(キーがコントロールに到達する前にキーを受け取るなど\) を実装するためには、キーボード メッセージのしくみについて理解することが必要です。  このトピックでは Windows フォームが認識するキー データの種類について説明し、キーボード メッセージをルーティングする方法について概要を説明します。  キーボード イベントの詳細については、「[キーボード イベントの使用](../../../docs/framework/winforms/using-keyboard-events.md)」を参照してください。  
+  
+## キーの種類  
+ Windows フォームはキーボード入力を、ビット単位の <xref:System.Windows.Forms.Keys> 列挙値で表現される仮想キー コードとして識別します。  <xref:System.Windows.Forms.Keys> 列挙値を使用すると、入力された一連のキーを組み合わせて単一の値にできます。  これらの値は WM\_KEYDOWN および WM\_SYSKEYDOWN の Windows メッセージに付随する値になります。  ほとんどの物理的なキー入力は、<xref:System.Windows.Forms.Control.KeyDown> イベントまたは <xref:System.Windows.Forms.Control.KeyUp> イベントを処理することで検出できます。  文字キーは <xref:System.Windows.Forms.Keys> 列挙値のサブセットであり、WM\_CHAR および WM\_SYSCHAR の Windows メッセージに付随する値になります。  キー入力の組み合わせが文字になった場合は、<xref:System.Windows.Forms.Control.KeyPress> イベントを処理することでその文字を検出できます。  または、Visual Basic プログラミング インターフェイスによって公開される <xref:Microsoft.VisualBasic.Devices.Keyboard> を使用して、どのキーが押されたかの判断と、キーの送信を行うという方法もあります。  詳細については、「[Accessing the Keyboard](../Topic/Accessing%20the%20Keyboard%20\(Visual%20Basic\).md)」を参照してください。  
+  
+## キーボード イベントの順序  
+ 先に説明したとおり、コントロール上では 3 つのキーボード関連のイベントが発生します。  イベントは一般に次の順序で発生します。  
+  
+1.  ユーザーが "a" のキーを押すと、キーが前処理され、ディスパッチされて、<xref:System.Windows.Forms.Control.KeyDown> イベントが発生します。  
+  
+2.  ユーザーが "a" のキーを押し続けると、キーが前処理され、ディスパッチされて、<xref:System.Windows.Forms.Control.KeyPress> イベントが発生します。  
+  
+     このイベントはユーザーがキーを押し続けているとき複数回発生します。  
+  
+3.  ユーザーが "a" のキーを離すと、キーが前処理され、ディスパッチされて、<xref:System.Windows.Forms.Control.KeyUp> イベントが発生します。  
+  
+## キーの前処理  
+ 他のメッセージと同様に、キーボード メッセージもフォームやコントロールの <xref:System.Windows.Forms.Control.WndProc%2A> メソッドで処理されます。  ただし、キーボード メッセージが処理される前に、<xref:System.Windows.Forms.Control.PreProcessMessage%2A> メソッドが 1 つ以上のメソッドを呼び出します。これらのメソッドをオーバーライドすることで、特別な文字キーと物理キーの処理が可能になります。  これらのメソッドをオーバーライドすると、コントロールがメッセージを処理する前に、特定のキーを検出してフィルターできます。  次の表に、実行される処理と、そのとき呼び出されるメソッドを \(メソッドが呼び出される順に\) 示します。  
+  
+### KeyDown イベントの前処理  
+  
+|動作|メソッド|説明|  
+|--------|----------|--------|  
+|アクセラレータやメニュー ショートカットなどのコマンド キーの確認。|<xref:System.Windows.Forms.Control.ProcessCmdKey%2A>|このメソッドはコマンド キーを処理します。コマンド キーは通常のキーよりも優先順位が上です。  このメソッドが `true` を返した場合、キー メッセージはディスパッチされず、キー イベントも発生しません。  `false` を返した場合は、<xref:System.Windows.Forms.Control.IsInputKey%2A> が呼び出されます。|  
+|前処理を必要とする特別なキーか、または <xref:System.Windows.Forms.Control.KeyDown> イベントを発生させ、コントロールにディスパッチされる通常の文字キーかどうかの確認。|<xref:System.Windows.Forms.Control.IsInputKey%2A>|メソッドが `true` を返した場合は、コントロールが通常の文字であることを意味するため、<xref:System.Windows.Forms.Control.KeyDown> イベントが発生します。  `false` を返した場合は、<xref:System.Windows.Forms.Control.ProcessDialogKey%2A> が呼び出されます。 **Note:**  コントロールがキーまたはキーの組み合わせを確実に取得するためには、<xref:System.Windows.Forms.Control.PreviewKeyDown> イベントを処理し、そのキーの <xref:System.Windows.Forms.PreviewKeyDownEventArgs> の <xref:System.Windows.Forms.PreviewKeyDownEventArgs.IsInputKey%2A> に `true` を設定します。|  
+|移動キー \(Esc、Tab、Return、または方向キー\) の確認。|<xref:System.Windows.Forms.Control.ProcessDialogKey%2A>|このメソッドはコントロール内で特別な機能 \(コントロールとその親コントロールの間のフォーカスの切り替えなど\) を実行する物理キーを処理します。  このコントロールがキーを処理しない場合は、親コントロールで <xref:System.Windows.Forms.Control.ProcessDialogKey%2A> が呼び出されます。それでも処理しなければ、コントロールの呼び出しが階層構造の最上階のコントロールまで続けられます。  このメソッドが `true` を返した場合、前処理は完了し、キー イベントは生成されません。  `false` を返した場合は、<xref:System.Windows.Forms.Control.KeyDown> イベントが発生します。|  
+  
+### KeyPress イベントの前処理  
+  
+|動作|メソッド|説明|  
+|--------|----------|--------|  
+|キーがコントロールによって処理される通常の文字であるかどうかの確認|<xref:System.Windows.Forms.Control.IsInputChar%2A>|文字が通常の文字である場合は、このメソッドが `true` を返し、<xref:System.Windows.Forms.Control.KeyPress> イベントが発生します。それ以上の処理は行われません。  通常の文字でない場合は、<xref:System.Windows.Forms.Control.ProcessDialogChar%2A> が呼び出されます。|  
+|文字がニーモニック \(ボタン上の &OK など\) かどうかの確認|<xref:System.Windows.Forms.Control.ProcessDialogChar%2A>|このメソッドも <xref:System.Windows.Forms.Control.ProcessDialogKey%2A> と同様に、コントロールの階層構造を上に移動しながら呼び出されます。  コントロールがコンテナー コントロールである場合は、自身とその子コントロールから <xref:System.Windows.Forms.Control.ProcessMnemonic%2A> を呼び出すことによってニーモニックを確認します。  <xref:System.Windows.Forms.Control.ProcessDialogChar%2A> が `true` を返した場合、<xref:System.Windows.Forms.Control.KeyPress> イベントは発生しません。|  
+  
+## キーボード メッセージの処理  
+ キーボード メッセージは、フォームまたはコントロールの <xref:System.Windows.Forms.Control.WndProc%2A> メソッドに到達した後、オーバーライド可能な一連のメソッドによって処理されます。  これらの各メソッドは、キーボード メッセージが処理され、コントロールがそれを使用したかどうかを示す <xref:System.Boolean> 値を返します。  いずれかのメソッドが `true` を返した場合は、メッセージが処理されたと判断されるため、ベース コントロールまたは親コントロールにメッセージが渡されることはありません。  そうでない場合は、メッセージがメッセージ キューに残り、場合によってはそのコントロールのベースまたは親に含まれる別のメソッドで処理されます。  次の表に、キーボード メッセージを処理するメソッドを示します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Windows.Forms.Control.ProcessKeyMessage%2A>|このメソッドは、コントロールの <xref:System.Windows.Forms.Control.WndProc%2A> メソッドが受信するすべてのキーボード メッセージを処理します。|  
+|<xref:System.Windows.Forms.Control.ProcessKeyPreview%2A>|このメソッドは、キーボード メッセージを親コントロールに送信します。  <xref:System.Windows.Forms.Control.ProcessKeyPreview%2A> が `true` を返した場合、キー イベントは生成されません。そうでない場合は <xref:System.Windows.Forms.Control.ProcessKeyEventArgs%2A> が呼び出されます。|  
+|<xref:System.Windows.Forms.Control.ProcessKeyEventArgs%2A>|このメソッドは必要に応じて <xref:System.Windows.Forms.Control.KeyDown>、<xref:System.Windows.Forms.Control.KeyPress>、および <xref:System.Windows.Forms.Control.KeyUp> のイベントを発生させます。|  
+  
+## キーボード メソッドのオーバーライド  
+ キーボード メッセージを処理するためにオーバーライドできるメソッドは多数ありますが、どのメソッドを選ぶかが非常に重要です。  次の表に、実行するタスクと、キーボード メソッドをオーバーライドする最善の方法を示します。  メソッドのオーバーライドの詳細については、「[NOT IN BUILD: Overriding Properties and Methods](http://msdn.microsoft.com/ja-jp/2167e8f5-1225-4b13-9ebd-02591ba90213)」を参照してください。  
+  
+|タスク|メソッド|  
+|---------|----------|  
+|移動キーを受け取って <xref:System.Windows.Forms.Control.KeyDown> イベントを発生させる。  たとえば、テキスト ボックス内で Tab や Return を処理するなど。|<xref:System.Windows.Forms.Control.IsInputKey%2A> をオーバーライドします。 **Note:**  または、<xref:System.Windows.Forms.Control.PreviewKeyDown> イベントを処理し、そのキーの <xref:System.Windows.Forms.PreviewKeyDownEventArgs> の <xref:System.Windows.Forms.PreviewKeyDownEventArgs.IsInputKey%2A> に `true` を設定します。|  
+|コントロールで特別な入力処理や移動処理を実行する。  たとえば、リスト コントロールで方向キーを使用して選択項目を変更するなど。|<xref:System.Windows.Forms.Control.ProcessDialogKey%2A> をオーバーライドします。|  
+|移動キーを受け取って <xref:System.Windows.Forms.Control.KeyPress> イベントを発生させる。  たとえば、スピン ボックス コントロールで方向キーを複数回押して、項目の移動を加速するなど。|<xref:System.Windows.Forms.Control.IsInputChar%2A> をオーバーライドします。|  
+|<xref:System.Windows.Forms.Control.KeyPress> イベントの間に、特別な入力処理や移動処理を実行する。  たとえば、リスト コントロール内で "r" キーを押し続けると、r の文字で始まる項目にスキップするなど。|<xref:System.Windows.Forms.Control.ProcessDialogChar%2A> をオーバーライドします。|  
+|カスタムなニーモニックの処理を実行する。たとえば、ツール バーに配置されたオーナー描画ボタンのニーモニックを処理するなど。|<xref:System.Windows.Forms.Control.ProcessMnemonic%2A> をオーバーライドします。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.Keys>   
+ <xref:System.Windows.Forms.Control.WndProc%2A>   
+ <xref:System.Windows.Forms.Control.PreProcessMessage%2A>   
+ [My.Computer.Keyboard Object](../../../ocs/visual-basic/language-reference/objects/my-computer-keyboard-object.md)   
+ [Accessing the Keyboard](../Topic/Accessing%20the%20Keyboard%20\(Visual%20Basic\).md)   
+ [キーボード イベントの使用](../../../docs/framework/winforms/using-keyboard-events.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-mouse-input-works-in-windows-forms.md b/docs/framework/winforms/how-mouse-input-works-in-windows-forms.md
new file mode 100644
index 00000000000..82c10e78a76
--- /dev/null
+++ b/docs/framework/winforms/how-mouse-input-works-in-windows-forms.md
@@ -0,0 +1,67 @@
+---
+title: "Windows フォームにおけるマウス入力のしくみ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マウス, 入力"
+  - "Windows フォーム, マウス入力"
+ms.assetid: 48fc5240-75a6-44bf-9fce-6aa21b49705a
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォームにおけるマウス入力のしくみ
+マウス入力の受け取りと処理は、どの Windows アプリケーションでも重要です。  マウス イベントを処理してアプリケーションのアクションを実行したり、マウスの位置情報を使用してヒット テストなどのアクションを実行したりできます。  また、アプリケーションのコントロールがマウス入力を処理する方法を変更することもできます。  ここでは、マウス イベントの詳細と、マウスのシステム設定を取得して変更する方法について説明します。  マウス イベントで提供されるデータおよびマウスのクリック イベントの発生順序の詳細については、「[Windows フォームにおけるマウス イベント](../../../docs/framework/winforms/mouse-events-in-windows-forms.md)」を参照してください。  
+  
+## マウスの位置とヒット テスト  
+ ユーザーがマウスを動かすと、オペレーティング システムによってマウス ポインターが移動します。  マウス ポインターには "ホット スポット" と呼ばれる単一ピクセルの領域が含まれます。オペレーティング システムは、この領域を追跡することによってポインターの位置を認識します。  ユーザーがマウスを動かすか、マウス ボタンを押すと、<xref:System.Windows.Forms.Cursor.HotSpot%2A> を含む <xref:System.Windows.Forms.Control> が適切なマウス イベントを発生させます。  現在のマウスの位置を取得するには、マウス イベントの処理時に <xref:System.Windows.Forms.MouseEventArgs> の <xref:System.Windows.Forms.MouseEventArgs.Location%2A> プロパティを使用するか、<xref:System.Windows.Forms.Cursor> クラスの <xref:System.Windows.Forms.Cursor.Position%2A> プロパティを使用します。  その後、マウスの位置情報を使用してヒット テストを実行し、マウスの位置に基づいてアクションを実行できます。  ヒット テスト機能は、Windows フォームの複数のコントロール \(<xref:System.Windows.Forms.ListView>、<xref:System.Windows.Forms.TreeView>、<xref:System.Windows.Forms.MonthCalendar>、および <xref:System.Windows.Forms.DataGridView>\) に組み込まれています。  ヒット テストを適切なマウス イベント \(たとえば、<xref:System.Windows.Forms.Control.MouseHover> など\) と組み合わせて使用すると、特定のアクションをアプリケーションがいつ実行するかを決定する上で便利です。  
+  
+## マウス イベント  
+ マウス入力に応答する主な方法は、マウス イベントを処理することです。  マウス イベントの一覧と各マウス イベントの発生タイミングを次の表に示します。  
+  
+|マウス イベント|Description|  
+|--------------|-----------------|  
+|<xref:System.Windows.Forms.Control.Click>|このイベントは、マウス ボタンが離されると発生します。通常は、<xref:System.Windows.Forms.Control.MouseUp> イベントの前に発生します。  このイベントのハンドラーは、<xref:System.EventArgs> 型の引数を受け取ります。  クリックがいつ発生したかだけを判断する必要がある場合は、このイベントを処理します。|  
+|<xref:System.Windows.Forms.Control.MouseClick>|このイベントは、ユーザーがマウスでコントロールをクリックすると発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。  クリック発生時のマウスに関する情報を取得する必要がある場合は、このイベントを処理します。|  
+|<xref:System.Windows.Forms.Control.DoubleClick>|このイベントは、コントロールがダブルクリックされると発生します。  このイベントのハンドラーは、<xref:System.EventArgs> 型の引数を受け取ります。  ダブルクリックがいつ発生したかだけを判断する必要がある場合は、このイベントを処理します。|  
+|<xref:System.Windows.Forms.Control.MouseDoubleClick>|このイベントは、ユーザーがマウスでコントロールをダブルクリックすると発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。  ダブルクリック発生時のマウスに関する情報を取得する必要がある場合は、このイベントを処理します。|  
+|<xref:System.Windows.Forms.Control.MouseDown>|このイベントは、マウス ポインターがコントロール上にあるときに、ユーザーがマウス ボタンを押すと発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseEnter>|このイベントは、コントロールの種類に応じて、マウス ポインターがコントロールの境界またはクライアント領域に入ると発生します。  このイベントのハンドラーは、<xref:System.EventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseHover>|このイベントは、マウス ポインターがコントロール上で停止したままになると発生します。  このイベントのハンドラーは、<xref:System.EventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseLeave>|このイベントは、コントロールの種類に応じて、マウス ポインターがコントロールの境界またはクライアント領域から出ると発生します。  このイベントのハンドラーは、<xref:System.EventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseMove>|このイベントは、マウス ポインターがコントロール上にあるときに移動すると発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseUp>|このイベントは、マウス ポインターがコントロール上にあるときに、ユーザーがマウス ボタンを離すと発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。|  
+|<xref:System.Windows.Forms.Control.MouseWheel>|このイベントは、コントロールにフォーカスがあるときに、ユーザーがマウス ホイールを回転させると発生します。  このイベントのハンドラーは、<xref:System.Windows.Forms.MouseEventArgs> 型の引数を受け取ります。  <xref:System.Windows.Forms.MouseEventArgs> の <xref:System.Windows.Forms.MouseEventArgs.Delta%2A> プロパティを使用して、マウスでどれだけスクロールしたかを判断できます。|  
+  
+## マウス入力の変更とシステム設定の検出  
+ コントロールがマウス入力を処理する方法を検出して変更するには、コントロールから派生させ、<xref:System.Windows.Forms.Control.GetStyle%2A> メソッドと <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを使用します。  <xref:System.Windows.Forms.Control.SetStyle%2A> メソッドは、<xref:System.Windows.Forms.ControlStyles> 値のビットごとの組み合わせを受け取り、コントロールが標準のクリック動作とダブルクリック動作のどちらを行うか、またはコントロールが独自のマウス処理を行うかどうかを決定します。  また、<xref:System.Windows.Forms.SystemInformation> クラスは、マウスの機能を記述したプロパティを含み、マウスとオペレーティング システムの対話方法を指定します。  これらのプロパティの概要を次の表に示します。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Forms.SystemInformation.DoubleClickSize%2A>|2 回のクリックがオペレーティング システムによってダブルクリックであると認識されるために、ユーザーが 2 回クリックする必要がある領域の大きさ \(ピクセル単位\) を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.DoubleClickTime%2A>|オペレーティング システムによってマウス操作がダブルクリックであると認識されるための、1 回目のクリックと 2 回目のクリックの間の最大経過時間 \(ミリ秒単位\) を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseButtons%2A>|マウスのボタンの数を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseButtonsSwapped%2A>|左右のマウス ボタンの機能が入れ替わっているかどうかを示す値を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseHoverSize%2A>|マウス静止メッセージが生成されるためにマウス静止時間が経過するまでマウス ポインターをとどめておく必要がある四角形の領域の大きさ \(ピクセル単位\) を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseHoverTime%2A>|マウス静止メッセージが生成されるために静止領域内にマウス ポインターをとどめておく必要がある時間 \(ミリ秒単位\) を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MousePresent%2A>|マウスが取り付けられているかどうかを示す値を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseSpeed%2A>|現在のマウス速度を示す値 \(1 ～ 20\) を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseWheelPresent%2A>|マウス ホイール付きのマウスが取り付けられているかどうかを示す値を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseWheelScrollDelta%2A>|マウス ホイールの 1 目盛りの回転で増分される差分値を取得します。|  
+|<xref:System.Windows.Forms.SystemInformation.MouseWheelScrollLines%2A>|マウス ホイールを回転したときにスクロールする行数を取得します。|  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)   
+ [Windows フォームにおけるマウスのキャプチャ](../../../docs/framework/winforms/mouse-capture-in-windows-forms.md)   
+ [Windows フォームにおけるマウス ポインター](../../../docs/framework/winforms/mouse-pointers-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-access-keyed-collections-in-windows-forms.md b/docs/framework/winforms/how-to-access-keyed-collections-in-windows-forms.md
new file mode 100644
index 00000000000..68ed3157a00
--- /dev/null
+++ b/docs/framework/winforms/how-to-access-keyed-collections-in-windows-forms.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : Windows フォームのコレクションにアクセス キーを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コレクション, アクセス (キーを使用して)"
+  - "キーが指定されたコレクション [Windows フォーム]"
+ms.assetid: b9b79b8b-d9bf-4f8c-b9d6-9578bc3219d3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Windows フォームのコレクションにアクセス キーを指定する
+-   個々のコレクション項目にはキーでアクセスできます。  この機能は、Windows フォーム アプリケーションによって一般に使用される多数のコレクション クラスに追加されました。  アクセスできるキーが指定されたコレクションのあるコレクション クラスの一部を次の一覧に示します。  
+  
+-   <xref:System.Windows.Forms.ListView.ListViewItemCollection>  
+  
+-   <xref:System.Windows.Forms.ListViewItem.ListViewSubItemCollection>  
+  
+-   <xref:System.Windows.Forms.Control.ControlCollection>  
+  
+-   <xref:System.Windows.Forms.TabControl.TabPageCollection>  
+  
+-   <xref:System.Windows.Forms.TreeNodeCollection>  
+  
+ コレクションの項目に関連付けられるキーは、一般に項目名です。  次の手順では、コレクション クラスを使用し、一般的なタスクを実行する方法を説明します。  
+  
+### コントロール コレクションの中で入れ子のコントロールを検索し、フォーカスの移動先にします。  
+  
+-   <xref:System.Windows.Forms.Control.ControlCollection.Find%2A> メソッドと <xref:System.Windows.Forms.Control.Focus%2A> メソッドを使用し、検索してフォーカスの移動先にするコントロール名を指定します。  
+  
+     [!code-csharp[System.Windows.Forms.KeyedCollectionsEx#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/CS/Form1.cs#1)]
+     [!code-vb[System.Windows.Forms.KeyedCollectionsEx#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/VB/Form1.vb#1)]  
+  
+### イメージ コレクションのイメージにアクセスするには  
+  
+-   <xref:System.Windows.Forms.ImageList.ImageCollection.Item%2A> プロパティを使用して、アクセスするイメージ名を指定します。  
+  
+     [!code-csharp[System.Windows.Forms.KeyedCollectionsEx#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.KeyedCollectionsEx#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/VB/Form1.vb#2)]  
+  
+### タブ ページを選択済みのタブとして設定するには  
+  
+-   <xref:System.Windows.Forms.TabControl.SelectedTab%2A> プロパティと <xref:System.Windows.Forms.TabControl.TabPageCollection.Item%2A> プロパティを使用し、選択済みのタブとして設定するタブ ページ名を指定します。  
+  
+     [!code-csharp[System.Windows.Forms.KeyedCollectionsEx#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.KeyedCollectionsEx#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyedCollectionsEx/VB/Form1.vb#3)]  
+  
+## 参照  
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)   
+ [方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する](../../../docs/framework/winforms/controls/how-to-add-or-remove-images-with-the-windows-forms-imagelist-component.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md b/docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md
new file mode 100644
index 00000000000..d8585719378
--- /dev/null
+++ b/docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : PropertyNameChanged パターンを適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カスタム コントロール [Windows フォーム], プロパティの変更 (コードを使用)"
+  - "データ バインド, カスタム コントロール"
+  - "PropertyNameChanged パターン, 適用"
+ms.assetid: aa47ddf6-5223-40c4-833f-a78992194836
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : PropertyNameChanged パターンを適用する
+次のコード例では、*PropertyName*Changed パターンをカスタム コントロールに適用する方法を示します。  Windows フォーム データ バインディング エンジンと一緒に使用するカスタム コントロールを実装する場合は、このパターンを適用します。  
+  
+## 使用例  
+ [!code-csharp[System.Windows.Forms.ChangeNotification#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ChangeNotification/CS/Form1.cs#3)]
+ [!code-vb[System.Windows.Forms.ChangeNotification#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ChangeNotification/VB/Form1.vb#3)]  
+  
+## コードのコンパイル  
+ 上記のコード例をコンパイルするには  
+  
+-   コードを空白のコード ファイルに貼り付けます。  `Main` メソッドを含む Windows フォームで、カスタム コントロールを使用する必要があります。  
+  
+## 参照  
+ [方法 : INotifyPropertyChanged インターフェイスを実装する](../../../docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md)   
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-change-the-borders-of-windows-forms.md b/docs/framework/winforms/how-to-change-the-borders-of-windows-forms.md
new file mode 100644
index 00000000000..86fd2000bd9
--- /dev/null
+++ b/docs/framework/winforms/how-to-change-the-borders-of-windows-forms.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : Windows フォームの境界線を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, 変更 (境界線を)"
+ms.assetid: b3d5fa56-80c6-4b10-b505-f9672307ed55
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームの境界線を変更する
+Windows フォームの外観や動作を決定する際にはさまざまな境界線スタイルを選択できます。  <xref:System.Windows.Forms.Form.FormBorderStyle%2A> プロパティを変更して、フォームのサイズ変更動作を制御できます。  また、<xref:System.Windows.Forms.Form.FormBorderStyle%2A> を設定すると、キャプション バーの表示方法や、キャプション バーに表示されるボタンを変更できます。  詳細については、「<xref:System.Windows.Forms.FormBorderStyle>」を参照してください。  
+  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] では、このタスクに対する広範なサポートが用意されています。  
+  
+ 「[方法 : デザイナーを使用して Windows フォームの境界線を変更する](http://msdn.microsoft.com/library/yettzh3e%20\(v=vs.110\))」も参照してください。  
+  
+### プログラムで Windows フォームの境界線スタイルを設定するには  
+  
+-   <xref:System.Windows.Forms.Form.FormBorderStyle%2A> プロパティを任意のスタイルに設定します。  フォーム `DlgBx1`  の境界線スタイルを <xref:System.Windows.Forms.FormBorderStyle> に設定するコード例は、次のとおりです。  
+  
+    ```vb  
+    DlgBx1.FormBorderStyle = System.Windows.Forms.FormBorderStyle.FixedDialog  
+    ```  
+  
+    ```csharp  
+    DlgBx1.FormBorderStyle = System.Windows.Forms.FormBorderStyle.FixedDialog;  
+    ```  
+  
+    ```cpp  
+    DlgBx1->FormBorderStyle =  
+       System::Windows::Forms::FormBorderStyle::FixedDialog;  
+    ```  
+  
+     「[方法 : デザイン時にダイアログ ボックスを作成する](http://msdn.microsoft.com/library/55cz5x2c\(v=vs.110\))」も参照してください。  
+  
+     また、**\[最小化\]** ボタンまたは **\[最大化\]** ボタンをフォームに配置できる境界線スタイルを選択した場合は、この 2 つのボタンのいずれか、または両方の機能を有効にするかどうかを指定できます。  これらのボタンは、ユーザーの操作感を細かく調節する場合に便利です。  既定では、**\[最小化\]** ボタンと **\[最大化\]** ボタンが有効になっています。**\[プロパティ\]** ウィンドウで、これらの機能を有効にするかどうかを制御できます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.FormBorderStyle>   
+ <xref:System.Windows.Forms.FormBorderStyle>   
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md b/docs/framework/winforms/how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md
new file mode 100644
index 00000000000..49116d97cb6
--- /dev/null
+++ b/docs/framework/winforms/how-to-connect-multiple-events-to-a-single-event-handler-in-windows-forms.md
@@ -0,0 +1,72 @@
+---
+title: "方法 : Windows フォームの 1 つのイベント ハンドラーに複数のイベントを関連付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イベント ハンドラー [Windows フォーム], 接続 (イベントを)"
+  - "イベント [Windows フォーム], 接続 (単一のイベント ハンドラーに複数のイベントを)"
+  - "メニュー項目, マルチキャスティング (イベント処理メソッドの)"
+  - "メニュー, イベント処理メソッド (複数メニュー項目の)"
+  - "Windows フォーム コントロール, イベント"
+ms.assetid: 5a20749a-41b5-4acc-8eb1-9e5040b0a2c4
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームの 1 つのイベント ハンドラーに複数のイベントを関連付ける
+アプリケーションのデザインによっては、1 つのイベント ハンドラーを複数のイベントに対応付ける必要があります。つまり、複数のイベントから 1 つのプロシージャを起動するようにする必要があります。  たとえば、メニュー コマンドとフォームのボタンの機能が同じ場合は、メニュー コマンドからフォームのボタンと同じイベントが発生するようにすると、大幅に作業時間を短縮できます。  これを行うには、C\# では、\[プロパティ\] ウィンドウのイベント ビューを使用します。Visual Basic コード エディターでは、`Handles`  キーワードと、**\[クラス名\]** ボックスおよび **\[メソッド名\]** ボックスを使用します。  
+  
+### Visual Basic で 1 つのイベント ハンドラーに複数のイベントを関連付けるには  
+  
+1.  フォームを右クリックし、**\[コードの表示\]** をクリックします。  
+  
+2.  **\[クラス名\]** ボックスで、イベント ハンドラーが処理するコントロールを 1 つ選択します。  
+  
+3.  **\[メソッド名\]** ボックスで、イベント ハンドラーが処理するイベントを 1 つ選択します。  
+  
+4.  コード エディターによって適切なイベント ハンドラーが挿入され、対応するメソッド内にカーソルが移動します。  以下に <xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントの例を示します。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+    ' Add event-handler code here.  
+    End Sub  
+    ```  
+  
+5.  処理対象の他のイベントを `Handles` 句に追加します。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click, Button2.Click  
+    ' Add event-handler code here.  
+    End Sub  
+    ```  
+  
+6.  適切なコードをイベント ハンドラーに追加します。  
+  
+### C\# で 1 つのイベント ハンドラーに複数のイベントを関連付けるには  
+  
+1.  イベント ハンドラーを接続するコントロールを選択します。  
+  
+2.  \[プロパティ\] ウィンドウで、**\[イベント\]** ボタン \(![イベント ボタン](../../../docs/framework/winforms/media/vxeventsbutton-propertieswindow.png "vxEventsButton\_PropertiesWindow")\) をクリックします。  
+  
+3.  処理するイベントの名前をクリックします。  
+  
+4.  イベント名の横にある値セクションでドロップダウン ボタンをクリックすると、処理するイベントのメソッド シグネチャと一致する既存のイベント ハンドラーの一覧が表示されます。  
+  
+5.  一覧から、該当するイベント ハンドラーを選択します。  
+  
+     選択したイベントを既存のイベント ハンドラーに関連付けするコードが、フォームに追加されます。  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)   
+ [イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-create-a-bound-control-and-format-the-displayed-data.md b/docs/framework/winforms/how-to-create-a-bound-control-and-format-the-displayed-data.md
new file mode 100644
index 00000000000..377e0449a78
--- /dev/null
+++ b/docs/framework/winforms/how-to-create-a-bound-control-and-format-the-displayed-data.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : バインド コントロールを作成して表示データの書式を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール [Windows フォーム], 作成"
+  - "バインド コントロール [Windows フォーム], 書式設定 (データを)"
+  - "データ [Windows フォーム], 書式指定"
+ms.assetid: d5a56228-899d-41d9-8af8-87b3f4ec2f94
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : バインド コントロールを作成して表示データの書式を設定する
+Windows フォームのデータ バインディングでは、\[**フォーマットと詳細バインド**\] ダイアログ ボックスを使用してデータ バインド コントロールに表示されるデータの書式を設定できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールをバインドして表示データの書式を設定するには  
+  
+1.  データ ソースに接続します。  
+  
+     詳細については、「[データ ソースへの接続](../../../docs/framework/data/adonet/connecting-to-a-data-source.md)」を参照してください。  
+  
+2.  フォームでコントロールを選択し、\[プロパティ\] ウィンドウを開きます。  
+  
+3.  \[**\(DataBindings\)**\] プロパティを展開し、\[**\(詳細\)**\] ボックスの省略記号ボタン \(![VisualStudioEllipsesButton スクリーンショット](../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして、\[**フォーマットと詳細バインド**\] ダイアログ ボックスを表示します。このダイアログ ボックスには、そのコントロールのすべてのプロパティの一覧が表示されます。  
+  
+4.  バインドするプロパティを選択し、\[**バインド**\] の矢印をクリックします。  
+  
+     使用できるデータ ソースの一覧が表示されます。  
+  
+5.  目的の 1 つのデータ要素が見つかるまで、バインド先のデータ ソースを展開します。  
+  
+     たとえば、データセットのテーブル内の列の値にバインドする場合は、データセットの名前を展開し、次にテーブル名を展開して、列名を表示します。  
+  
+6.  バインド先の要素の名前をクリックします。  
+  
+7.  \[**形式の種類**\] ボックスで、コントロールに表示されるデータに適用する形式をクリックします。  
+  
+     どの形式でも、データ ソースに <xref:System.DBNull> が含まれている場合には、コントロールに表示する値を指定できます。  それ以外の場合、オプションは、選択する形式の種類に応じて多少変わります。  次の表に、形式の種類とオプションを示します。  
+  
+    |形式の種類|書式設定のオプション|  
+    |-----------|----------------|  
+    |書式設定なし|オプションはありません。|  
+    |数字|**\[小数点以下の桁数\]** アップダウン コントロールを使用して小数点以下の桁数を指定します。|  
+    |通貨|**\[小数点以下の桁数\]** アップダウン コントロールを使用して小数点以下の桁数を指定します。|  
+    |日付と時刻|**\[種類\]** 選択ボックス内の項目のいずれかを選択して、日付と時刻の表示方法を選択します。|  
+    |指数|**\[小数点以下の桁数\]** アップダウン コントロールを使用して小数点以下の桁数を指定します。|  
+    |カスタム|カスタム書式指定文字列を使用するように指定します。<br /><br /> 詳細については、「[型の書式設定](../../../docs/standard/base-types/formatting-types.md)」を参照してください。 **Note:**  カスタム書式指定文字列を使用した場合、データ ソースとバインド コントロールの間を往復したときにデータが正常に維持される保証はありません  その代わりに、バインディングで <xref:System.Windows.Forms.Binding.Parse> イベントまたは <xref:System.Windows.Forms.Binding.Format> イベントを処理し、イベント処理コードでカスタム書式を適用します。|  
+  
+8.  \[**OK**\] をクリックして \[**フォーマットと詳細バインド**\] ダイアログ ボックスを閉じ、\[プロパティ\] ウィンドウに戻ります。  
+  
+## 参照  
+ [方法 : Windows フォームに単純バインド コントロールを作成する](../../../docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md)   
+ [Windows フォームでのユーザー入力の検証](../../../docs/framework/winforms/user-input-validation-in-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md b/docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md
new file mode 100644
index 00000000000..f93af2ca195
--- /dev/null
+++ b/docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : Windows フォームに単純バインド コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ バインド, 単純データ バインディング"
+  - "Windows フォーム コントロール, データ バインド"
+ms.assetid: 3bcaded8-0f1a-4cc0-8830-f59be253bf4e
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォームに単純バインド コントロールを作成する
+*単純バインディング*を使用すると、データセット テーブルの列の値など、1 つのデータ要素をコントロールで表示できます。  コントロールの任意のプロパティをデータ値に単純連結できます。  
+  
+> [!NOTE]
+>  実際に画面に表示されるダイアログ ボックスとメニュー コマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。  設定を変更するには、**\[ツール\]** メニューの **\[設定のインポートとエクスポート\]** をクリックします。  詳細については、「[Customizing Development Settings in Visual Studio](http://msdn.microsoft.com/ja-jp/22c4debb-4e31-47a8-8f19-16f328d7dcd3)」を参照してください。  
+  
+### コントロールを単純連結するには  
+  
+1.  データ ソースに接続する。  詳細については、「[データ ソースへの接続](../../../docs/framework/data/adonet/connecting-to-a-data-source.md)」を参照してください。  
+  
+2.  フォームでコントロールを選択し、**\[プロパティ\]** ウィンドウを表示します。  
+  
+3.  **\(DataBindings\)** プロパティを展開します。  
+  
+     頻繁に連結されるプロパティが **\(DataBindings\)** プロパティの下に表示されます。  たとえば、ほとんどのコントロールでは、**Text** プロパティが最も頻繁に連結されます。  
+  
+4.  連結しようとしているプロパティが一般によく連結されるプロパティでない場合は、**\[詳細\]** ボックスの**省略記号ボタン** \(![VisualStudioEllipsesButton スクリーンショット](../../../docs/framework/winforms/media/vbellipsesbutton.png "vbEllipsesButton")\) をクリックして、**\[フォーマットと詳細バインド\]** ダイアログ ボックスを表示します。このダイアログ ボックスには、選択したコントロールのプロパティの完全な一覧が表示されます。  
+  
+5.  連結するプロパティを選択し、**\[バインド\]** の下にあるドロップダウン矢印をクリックします。  
+  
+     使用できるデータ ソースの一覧が表示されます。  
+  
+6.  目的の 1 つのデータ要素が見つかるまで、連結先のデータ ソースを展開します。  たとえば、データセットのテーブル内の列の値に連結する場合は、データセットの名前を展開し、次にテーブル名を展開して、列名を表示します。  
+  
+7.  連結先の要素の名前をクリックします。  
+  
+8.  **\[フォーマットと詳細バインド\]** ダイアログ ボックスで作業している場合は、**\[OK\]** をクリックして **\[プロパティ\]** ウィンドウに戻ります。  
+  
+9. コントロールのほかのプロパティも連結する場合は、手順 3 ～ 7 を繰り返します。  
+  
+    > [!NOTE]
+    >  単純連結コントロールは 1 つのデータ要素だけを表示するため、単純連結コントロールを含む Windows フォームにはデータ間で移動するためのロジックを含めるのが一般的です。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Binding>   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-create-a-windows-forms-application-from-the-command-line.md b/docs/framework/winforms/how-to-create-a-windows-forms-application-from-the-command-line.md
new file mode 100644
index 00000000000..f23d4bd2191
--- /dev/null
+++ b/docs/framework/winforms/how-to-create-a-windows-forms-application-from-the-command-line.md
@@ -0,0 +1,125 @@
+---
+title: "方法 : コマンド ラインから Windows フォーム アプリケーションを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, アプリケーション開発 (コマンド ラインからの)"
+  - "Windows フォーム, 作成 (基本フォームを)"
+  - "Windows フォーム, はじめに"
+ms.assetid: 45ad3f8b-1c26-4c9f-91a9-3bb0759a47a4
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : コマンド ラインから Windows フォーム アプリケーションを作成する
+次の手順では、コマンドラインから Windows フォーム アプリケーションを作成して実行するために完了する必要のある基本的な手順について説明します。  Visual Studio では、これらの手順に対する広範なサポートが用意されています。  「[チュートリアル : 簡単な Windows フォームの作成](http://msdn.microsoft.com/library/z9w2f38k\(v=vs.110\))」も参照してください。  
+  
+## プロシージャ  
+  
+#### フォームを作成するには  
+  
+1.  空のコード ファイルに、次の import ステートメントまたは using ステートメントを入力します。  
+  
+     [!code-csharp[System.Windows.Forms.BasicForm#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.BasicForm#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/VB/Form1.vb#2)]  
+  
+2.  フォーム クラスから継承する `Form1` という名前のクラスを宣言します。  
+  
+     [!code-csharp[System.Windows.Forms.BasicForm#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.BasicForm#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/VB/Form1.vb#3)]  
+  
+3.  `Form1` の既定のコンストラクターを作成します。  
+  
+     後続の手順で、コンストラクターにさらにコードを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.BasicForm#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.BasicForm#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/VB/Form1.vb#4)]  
+  
+4.  `Main` メソッドをクラスに追加します。  
+  
+    1.  <xref:System.STAThreadAttribute> を `Main` メソッドに適用し、Windows フォーム アプリケーションがシングル スレッド アパートメントであることを指定します。  
+  
+    2.  <xref:System.Windows.Forms.Application.EnableVisualStyles%2A> を呼び出して、アプリケーションを Windows XP の外観にします。  
+  
+    3.  フォームのインスタンスを作成して実行します。  
+  
+     [!code-csharp[System.Windows.Forms.BasicForm#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/CS/Form1.cs#5)]
+     [!code-vb[System.Windows.Forms.BasicForm#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BasicForm/VB/Form1.vb#5)]  
+  
+#### アプリケーションをコンパイルして実行するには  
+  
+1.  .NET Framework コマンド プロンプトで、`Form1` クラスを作成したディレクトリに移動します。  
+  
+2.  フォームをコンパイルします。  
+  
+    -   C\# を使用している場合は、`csc form1.cs` と入力します。  
+  
+         `または`  
+  
+    -   Visual Basic を使用している場合は、`vbc form1.vb /r:system.dll,system.drawing.dll,system.windows.forms.dll` と入力します。  
+  
+3.  コマンド プロンプトで、`Form1.exe` と入力します。  
+  
+## コントロールの追加とイベントの処理  
+ 前の手順は、コンパイルして実行する基本的な Windows フォームを作成する方法を示しました。  次の手順では、コントロールを作成してフォームに追加し、コントロールのイベントを処理する方法を示します。  Windows フォームに追加できるコントロールの詳細については、「[Windows フォーム コントロール](../../../docs/framework/winforms/controls/index.md)」を参照してください。  
+  
+ Windows フォーム アプリケーションを作成する方法を理解するだけでなく、イベント ベースのプログラミングとユーザー入力を処理する方法を理解する必要があります。  詳細については、「[Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)」および「[ユーザーの入力の処理](../../../docs/framework/winforms/controls/handling-user-input.md)」を参照してください。  
+  
+#### ボタン コントロールを宣言して、クリック イベントを処理するには  
+  
+1.  `button1` という名前のボタン コントロールを宣言します。  
+  
+2.  コンストラクターでボタンを作成し、<xref:System.Windows.Forms.Control.Size%2A>、<xref:System.Windows.Forms.Control.Location%2A>、および <xref:System.Windows.Forms.Control.Text%2A> の各プロパティを設定します。  
+  
+3.  フォームにボタンを追加します。  
+  
+     次のコード例は、ボタン コントロールを宣言する方法を示します。  
+  
+     [!code-csharp[System.Windows.Forms.FormWithButton#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.FormWithButton#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/VB/Form1.vb#2)]  
+  
+4.  ボタンで <xref:System.Windows.Forms.Control.Click> イベントを処理するメソッドを作成します。  
+  
+5.  クリック イベント ハンドラーで、メッセージ "Hello World" と共に <xref:System.Windows.Forms.MessageBox> を表示します。  
+  
+     次のコード例は、ボタン コントロールのクリック イベントを処理する方法を示します。  
+  
+     [!code-csharp[System.Windows.Forms.FormWithButton#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.FormWithButton#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/VB/Form1.vb#3)]  
+  
+6.  <xref:System.Windows.Forms.Control.Click> イベントを作成したメソッドに関連付けます。  
+  
+     次のコード例は、イベントをメソッドに関連付ける方法を示します。  
+  
+     [!code-csharp[System.Windows.Forms.FormWithButton#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.FormWithButton#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/VB/Form1.vb#4)]  
+  
+7.  前の手順で説明したように、アプリケーションをコンパイルして実行します。  
+  
+## 使用例  
+ 次のコード例は、前の手順の完全な例です。  
+  
+ [!code-csharp[System.Windows.Forms.FormWithButton#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.FormWithButton#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.FormWithButton/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   コードをコンパイルするには、アプリケーションをコンパイルして実行する方法を説明した、前述の手順に従います。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Form>   
+ <xref:System.Windows.Forms.Control>   
+ [Windows フォームの表示形式の変更](../../../docs/framework/winforms/changing-the-appearance-of-windows-forms.md)   
+ [Windows フォーム アプリケーションの拡張](../../../docs/framework/winforms/advanced/index.md)   
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md b/docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md
new file mode 100644
index 00000000000..59538d5cd62
--- /dev/null
+++ b/docs/framework/winforms/how-to-create-event-handlers-at-run-time-for-windows-forms.md
@@ -0,0 +1,87 @@
+---
+title: "方法 : Windows フォームで実行時にイベント ハンドラーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Button コントロール [Windows フォーム], イベント ハンドラー"
+  - "イベント ハンドラー, 作成"
+  - "例 [Windows フォーム], イベント処理"
+  - "実行時に, 作成 (イベント ハンドラーを)"
+  - "Windows フォーム, イベント処理"
+ms.assetid: 2e7c9e1a-61fe-444d-8113-3c5bacf1c8cb
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : Windows フォームで実行時にイベント ハンドラーを作成する
+Windows フォーム デザイナーを使用してイベント ハンドラーを作成する他に、実行時にもイベント ハンドラーを作成できます。  これによって、プログラムが最初に起動したときにイベント ハンドラーを接続する代わりに、コード内に記述されている条件に基づいて、実行時にイベント ハンドラーを接続できます。  
+  
+### 実行時にイベント ハンドラーを作成するには  
+  
+1.  コード エディターで、イベント ハンドラーを追加するフォームを開きます。  
+  
+2.  処理するイベントに対応するメソッド シグネチャを持つメソッドをフォームに追加します。  
+  
+     たとえば、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントを処理する場合は、次のようなメソッドを作成します。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)  
+       ' Add event handler code here.  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)   
+    {  
+    // Add event handler code here.  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:  
+       void button1_Click(System::Object ^ sender,   
+          System::EventArgs ^ e)  
+       {  
+          // Add event handler code here.  
+       }  
+    ```  
+  
+3.  アプリケーションの必要に応じて、イベント ハンドラーにコードを追加します。  
+  
+4.  イベント ハンドラーをどのフォームまたはコントロールに対して作成するかを指定します。  
+  
+5.  フォームのクラスのメソッドに、イベントを処理するためのイベント ハンドラーを指定するコードを追加します。  たとえば、次のコードは、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントを処理する `button1_Click` イベント ハンドラーを指定します。  
+  
+    ```vb  
+    AddHandler Button1.Click, AddressOf Button1_Click  
+  
+    ```  
+  
+    ```csharp  
+    button1.Click += new EventHandler(button1_Click);  
+  
+    ```  
+  
+    ```cpp  
+    button1->Click += gcnew System::EventHandler(this, &Form1::button1_Click);  
+    ```  
+  
+     上の Visual Basic コードの <xref:System.ComponentModel.EventHandlerList.AddHandler%2A> メソッドは、ボタンに対するクリック イベント ハンドラーを作成しています。  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)   
+ [イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)   
+ [Troubleshooting Inherited Event Handlers in Visual Basic](../Topic/Troubleshooting%20Inherited%20Event%20Handlers%20in%20Visual%20Basic.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-determine-which-modifier-key-was-pressed.md b/docs/framework/winforms/how-to-determine-which-modifier-key-was-pressed.md
new file mode 100644
index 00000000000..a3da9ab432b
--- /dev/null
+++ b/docs/framework/winforms/how-to-determine-which-modifier-key-was-pressed.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : どの修飾子キーが押されたかを判断する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Alt キー"
+  - "Ctrl キー"
+  - "イベント [Windows フォーム], キーボード"
+  - "イベント [Windows フォーム], マウス"
+  - "キーボード入力"
+  - "キーボード, キーボード入力"
+  - "キー, Alt キー"
+  - "キー, Ctrl キー"
+  - "キー, 判断 (最後に押された)"
+  - "キー, 修飾子キー"
+  - "キー, Shift キー"
+  - "Keys.Alt 列挙型メンバー"
+  - "Keys.ControlKey 列挙型メンバー"
+  - "Keys.Shift 列挙型メンバー"
+  - "修飾子キー"
+  - "Shift キー"
+  - "ユーザー入力, チェック (キーボードを)"
+ms.assetid: 1e184048-0ae3-4067-a200-d4ba31dbc2cb
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : どの修飾子キーが押されたかを判断する
+ユーザーのキーストロークを受け付けるアプリケーションを作成するときに、Shift、Alt、Ctrl などの修飾子キーの監視が必要になる場合があります。  他のキーまたはマウスのクリックと組み合わせて修飾子キーが押された場合、アプリケーションはそれに応じて適切な処理を実行できます。  たとえば、S キーを押した場合は単に画面上に "s" が表示されますが、Ctrl キーを押しながら S キーを押した場合は現在のドキュメントが保存されます。  <xref:System.Windows.Forms.Control.KeyDown> イベントを処理する場合、イベント ハンドラーが受け取る <xref:System.Windows.Forms.KeyEventArgs> の <xref:System.Windows.Forms.KeyEventArgs.Modifiers%2A> プロパティは、どの修飾子キーが押されたかを指定します。  また、<xref:System.Windows.Forms.KeyEventArgs> の <xref:System.Windows.Forms.KeyEventArgs.KeyData%2A> プロパティは、押された文字およびビットごとの OR と結合された修飾子キーを指定します。  ただし、<xref:System.Windows.Forms.Control.KeyPress> イベントやマウス イベントを処理する場合、イベント ハンドラーはこの情報を受け取りません。  その場合は、<xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.ModifierKeys%2A> プロパティを使用する必要があります。  いずれの場合も、適切な <xref:System.Windows.Forms.Keys> 値とテスト対象の値について、ビットごとの AND を実行する必要があります。  <xref:System.Windows.Forms.Keys> 列挙型には修飾子キーごとのバリエーションが用意されているため、正しい値を使用してビットごとの AND を実行することが重要です。  たとえば、Shift キーは、<xref:System.Windows.Forms.Keys>、<xref:System.Windows.Forms.Keys>、<xref:System.Windows.Forms.Keys>、および <xref:System.Windows.Forms.Keys> で表されます。修飾子キーとしての Shift キーをテストするための正しい値は <xref:System.Windows.Forms.Keys> です。  同様に、修飾子キーとしての Ctrl キーおよび Alt キーをテストするには、それぞれ <xref:System.Windows.Forms.Keys> 値および <xref:System.Windows.Forms.Keys> 値を使用する必要があります。  
+  
+> [!NOTE]
+>  Visual Basic プログラマは <xref:Microsoft.VisualBasic.Devices.Computer.Keyboard%2A> プロパティを介してキー情報にアクセスすることもできます。  
+  
+### どの修飾キーが押されたかを判断するには  
+  
+-   特定の修飾子キーが押されたかどうかを判断するには、ビットごとの `AND` 演算子を <xref:System.Windows.Forms.Control.ModifierKeys%2A> プロパティおよび <xref:System.Windows.Forms.Keys> 列挙型の値と組み合わせて使用します。  <xref:System.Windows.Forms.Control.KeyPress> イベント ハンドラー内で Shift キーが押されたかどうかを判断する方法を次のコード例に示します。  
+  
+     [!code-cpp[System.Windows.Forms.DetermineModifierKey#5](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.DetermineModifierKey/cpp/form1.cpp#5)]
+     [!code-csharp[System.Windows.Forms.DetermineModifierKey#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.DetermineModifierKey/CS/form1.cs#5)]
+     [!code-vb[System.Windows.Forms.DetermineModifierKey#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.DetermineModifierKey/VB/form1.vb#5)]  
+  
+## 参照  
+ <xref:System.Windows.Forms.Keys>   
+ <xref:System.Windows.Forms.Control.ModifierKeys%2A>   
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)   
+ [How to: Determine If CapsLock is On in Visual Basic](http://msdn.microsoft.com/ja-jp/91e60f5c-dd61-4222-ba5f-39af803afd8c)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-display-dialog-boxes-for-windows-forms.md b/docs/framework/winforms/how-to-display-dialog-boxes-for-windows-forms.md
new file mode 100644
index 00000000000..06bec4b720c
--- /dev/null
+++ b/docs/framework/winforms/how-to-display-dialog-boxes-for-windows-forms.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : Windows フォームのダイアログ ボックスを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ダイアログ ボックス, 表示 (Windows フォームの)"
+  - "Windows フォームのダイアログ ボックス, 表示"
+  - "Windows フォーム, 呼び出し (フォームからの他のフォームの)"
+  - "Windows フォーム, 表示"
+ms.assetid: aaac1b38-c651-495a-8d3d-5a9bfb32fee3
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Windows フォームのダイアログ ボックスを表示する
+ダイアログ ボックスは、アプリケーションで表示されるその他のフォームと同じ方法で表示されます。  スタートアップ フォームは、アプリケーションの実行時に自動的に読み込まれます。  別のフォームまたはダイアログ ボックスをアプリケーションで表示するには、フォームまたはダイアログ ボックスを読み込んで表示するコードを作成します。  同様に、フォームまたはダイアログ ボックスを非表示にするには、アンロードまたは非表示にするコードを作成します。  
+  
+### ダイアログ ボックスを表示するには  
+  
+1.  ダイアログ ボックスを開くために使用するイベント ハンドラーに移動します。  ダイアログ ボックスを開くイベントは、メニュー コマンドが選択されたとき、ボタンがクリックされたとき、または他のイベントが発生したときに発生します。  
+  
+2.  イベント ハンドラーに、ダイアログ ボックスを表示するコードを追加します。  次の例では、ボタン クリック イベントを使用してダイアログ ボックスを表示します。  
+  
+    ```vb  
+    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click  
+       Dim dlg1 as new Form()  
+       dlg1.ShowDialog()  
+    End Sub  
+  
+    ```  
+  
+    ```csharp  
+    private void button1_Click(object sender, System.EventArgs e)   
+    {  
+       Form dlg1 = new Form();  
+       dlg1.ShowDialog();  
+    }  
+  
+    ```  
+  
+    ```cpp  
+    private:   
+      void button1_Click(System::Object ^ sender,  
+        System::EventArgs ^ e)  
+      {  
+        Form ^ dlg1 = gcnew Form();  
+        dlg1->ShowDialog();  
+      }  
+    ```
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-distinguish-between-clicks-and-double-clicks.md b/docs/framework/winforms/how-to-distinguish-between-clicks-and-double-clicks.md
new file mode 100644
index 00000000000..16ea9c09a83
--- /dev/null
+++ b/docs/framework/winforms/how-to-distinguish-between-clicks-and-double-clicks.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : クリックとダブルクリックを識別する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マウス クリック, シングルとダブルの比較"
+  - "マウス, クリック"
+  - "マウス, ダブルクリック"
+ms.assetid: d836ac8c-85bc-4f3a-a761-8aee03dc682c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : クリックとダブルクリックを識別する
+通常、1 回の*クリック*によってユーザー インターフェイス \(UI\) のアクションが開始され、*ダブルクリック*によってそのアクションが拡張されます。  たとえば、通常、1 回のクリックで項目が選択され、ダブルクリックでその項目が編集されます。  ただし、Windows フォームのクリック イベントでは、クリックとダブルクリックによって矛盾するアクションが実行されるようなシナリオには簡単に対応できません。それは、<xref:System.Windows.Forms.Control.Click> イベントや <xref:System.Windows.Forms.Control.MouseClick> イベントに結び付けられたアクションが、<xref:System.Windows.Forms.Control.DoubleClick> イベントや <xref:System.Windows.Forms.Control.MouseDoubleClick> イベントに結び付けられたアクションの前に実行されるためです。  ここでは、この問題の 2 つの解決方法について説明します。  1 つの解決方法は、ダブルクリック イベントを処理し、クリック イベントの処理のアクションをロールバックすることです。  まれに、クリック動作およびダブルクリック動作のシミュレートが必要になることがあります。その場合は、<xref:System.Windows.Forms.Control.MouseDown> イベントを処理し、<xref:System.Windows.Forms.SystemInformation> クラスの <xref:System.Windows.Forms.SystemInformation.DoubleClickTime%2A> プロパティと <xref:System.Windows.Forms.SystemInformation.DoubleClickSize%2A> プロパティを使用します。  クリック間の時間を測定し、<xref:System.Windows.Forms.SystemInformation.DoubleClickTime%2A> の値に到達する前に 2 回目のクリックが発生しており、かつ <xref:System.Windows.Forms.SystemInformation.DoubleClickSize%2A> によって定義された四角形内でクリックが行われている場合は、ダブルクリック アクションが実行されます。それ以外の場合は、クリック アクションが実行されます。  
+  
+### クリック アクションをロールバックするには  
+  
+-   対象のコントロールに標準のダブルクリック動作が含まれることを確認します。  含まれない場合は、<xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを使用してコントロールでダブルクリックを有効にします。  ダブルクリック イベントを処理して、ダブルクリック アクションを実行するだけでなく、クリック アクションをロールバックします。  ダブルクリックが有効になっているカスタム ボタンを作成する方法と、ダブルクリック イベント処理コード内でクリック アクションをロールバックする方法を次のコード例に示します。  
+  
+     [!code-csharp[System.Windows.Forms.ButtonDoubleClick#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.ButtonDoubleClick/CS/Form1.cs#1)]
+     [!code-vb[System.Windows.Forms.ButtonDoubleClick#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.ButtonDoubleClick/VB/Form1.vb#1)]  
+  
+### MouseDown イベントでのクリックを区別するには  
+  
+-   <xref:System.Windows.Forms.Control.MouseDown> イベントを処理し、適切な <xref:System.Windows.Forms.SystemInformation> プロパティと <xref:System.Windows.Forms.Timer> コンポーネントを使用して、クリックが発生した場所および間隔を確認します。  クリックとダブルクリックのどちらが発生したかに応じて、適切なアクションを実行します。  これを実行する方法を次のコード例に示します。  
+  
+     [!code-cpp[System.Windows.Forms.SingleVersusDoubleClick#0](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.SingleVersusDoubleClick/cpp/form1.cpp#0)]
+     [!code-csharp[System.Windows.Forms.SingleVersusDoubleClick#0](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.SingleVersusDoubleClick/CS/form1.cs#0)]
+     [!code-vb[System.Windows.Forms.SingleVersusDoubleClick#0](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.SingleVersusDoubleClick/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ これらの例には次の項目が必要です。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこれらの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-handle-keyboard-input-at-the-form-level.md b/docs/framework/winforms/how-to-handle-keyboard-input-at-the-form-level.md
new file mode 100644
index 00000000000..31ea3e5cd58
--- /dev/null
+++ b/docs/framework/winforms/how-to-handle-keyboard-input-at-the-form-level.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : キーボード入力をフォーム レベルで処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード入力, フォーム レベルでの"
+  - "キーボード, フォーム レベルの入力"
+  - "Windows フォーム, 処理 (キーボード入力を)"
+ms.assetid: d7f8b390-dc91-42d2-ae0f-2ffa388127ad
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : キーボード入力をフォーム レベルで処理する
+Windows フォームでは、キーボード メッセージがコントロールに到達する前に、それらのメッセージをフォーム レベルで処理できます。  ここでは、このタスクを実行する方法について説明します。  
+  
+### キーボード入力をフォーム レベルで処理するには  
+  
+-   スタートアップ フォームの <xref:System.Windows.Forms.Control.KeyPress> イベントまたは <xref:System.Windows.Forms.Control.KeyDown> イベントを処理し、このフォームの <xref:System.Windows.Forms.Form.KeyPreview%2A> プロパティを `true` に設定して、キーボード メッセージがフォーム上のコントロールに到達する前にフォームによって受け取られるようにします。  次のコード例では、<xref:System.Windows.Forms.Control.KeyPress> イベントを処理して、すべての数値キーを検出し、"1"、"4"、および "7" の各キーを使用します。  
+  
+     [!code-cpp[System.Windows.Forms.KeyboardInputForm#10](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/cpp/form1.cpp#10)]
+     [!code-csharp[System.Windows.Forms.KeyboardInputForm#10](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/CS/form1.cs#10)]
+     [!code-vb[System.Windows.Forms.KeyboardInputForm#10](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/VB/form1.vb#10)]  
+  
+## 使用例  
+ 次のコード例は、上の例の完全なアプリケーションです。  このアプリケーションには、<xref:System.Windows.Forms.TextBox> の他に、<xref:System.Windows.Forms.TextBox> からフォーカスを移動できるようにするいくつかのコントロールが含まれています。  メイン <xref:System.Windows.Forms.Form> の <xref:System.Windows.Forms.Control.KeyPress> イベントは "1"、"4"、および "7" の各キーを使用し、<xref:System.Windows.Forms.TextBox> の <xref:System.Windows.Forms.Control.KeyPress> イベントは "2"、"5"、および "8" の各キーを使用します。残りのキーは表示されるだけです。  <xref:System.Windows.Forms.TextBox> にフォーカスがあるときに数値キーを押すと生成される <xref:System.Windows.Forms.MessageBox> 出力と、他のコントロールのいずれかにフォーカスがあるときに数値キーを押すと生成される <xref:System.Windows.Forms.MessageBox> 出力を比較してください。  
+  
+ [!code-cpp[System.Windows.Forms.KeyBoardInputForm#0](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/cpp/form1.cpp#0)]
+ [!code-csharp[System.Windows.Forms.KeyBoardInputForm#0](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.KeyBoardInputForm#0](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInputForm/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-handle-user-input-events-in-windows-forms-controls.md b/docs/framework/winforms/how-to-handle-user-input-events-in-windows-forms-controls.md
new file mode 100644
index 00000000000..9193561e639
--- /dev/null
+++ b/docs/framework/winforms/how-to-handle-user-input-events-in-windows-forms-controls.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : Windows フォーム コントロールでユーザー入力イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ユーザー入力, Windows フォーム コントロール"
+  - "Windows フォーム コントロール, ユーザー入力"
+ms.assetid: 3de74dcf-fae3-42d0-92b5-bc04a61a6888
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォーム コントロールでユーザー入力イベントを処理する
+この例では、Windows フォーム コントロールで発生する可能性がある、ほとんどのキーボード、マウス、フォーカス、および検証イベントを処理する方法を示します。  `TextBoxInput` という名前のテキスト ボックスは、フォーカスがあるときにイベントを受け取り、各イベントに関する情報は、イベントが発生する順序で、`TextBoxOutput` という名前のテキスト ボックスに書き込まれます。  アプリケーションには、レポートするイベントをフィルター処理するために使用できるチェック ボックスのセットも含まれています。  
+  
+## 使用例  
+ [!code-cpp[System.Windows.Forms.UserInputWalkthrough#0](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.UserInputWalkthrough/cpp/form1.cpp#0)]
+ [!code-csharp[System.Windows.Forms.UserInputWalkthrough#0](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.UserInputWalkthrough/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.UserInputWalkthrough#0](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.UserInputWalkthrough/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォームでのユーザー入力](../../../docs/framework/winforms/user-input-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-implement-the-ilistsource-interface.md b/docs/framework/winforms/how-to-implement-the-ilistsource-interface.md
new file mode 100644
index 00000000000..23944b68f82
--- /dev/null
+++ b/docs/framework/winforms/how-to-implement-the-ilistsource-interface.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : IListSource インターフェイスを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ バインド, 実装"
+  - "IListSource インターフェイス"
+ms.assetid: 63ce27aa-2e23-4fbd-8228-0c1726f6c421
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : IListSource インターフェイスを実装する
+<xref:System.Collections.IList> を実装する代わりに別の場所からリストを提供する、バインドできるクラスを作成するには、<xref:System.ComponentModel.IListSource> インターフェイスを実装します。  
+  
+## 使用例  
+ <xref:System.ComponentModel.IListSource> インターフェイスを実装する方法を次のコード例に示します。  `EmployeeListSource` というコンポーネントは、<xref:System.ComponentModel.IListSource.GetList%2A> メソッドを実装することにより、データ バインディングの <xref:System.Collections.IList> を公開します。  
+  
+ [!code-csharp[System.ComponentModel.IListSource#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IListSource/CS/EmployeeListSource.cs#1)]
+ [!code-vb[System.ComponentModel.IListSource#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IListSource/VB/EmployeeListSource.vb#1)]  
+  
+ [!code-csharp[System.ComponentModel.IListSource#10](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IListSource/CS/Employee.cs#10)]
+ [!code-vb[System.ComponentModel.IListSource#10](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IListSource/VB/Employee.vb#10)]  
+  
+ [!code-csharp[System.ComponentModel.IListSource#100](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IListSource/CS/BusinessObjectBase.cs#100)]
+ [!code-vb[System.ComponentModel.IListSource#100](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IListSource/VB/BusinessObjectBase.vb#100)]  
+  
+ [!code-csharp[System.ComponentModel.IListSource#1000](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IListSource/CS/Form1.cs#1000)]
+ [!code-vb[System.ComponentModel.IListSource#1000](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IListSource/VB/Form1.vb#1000)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Drawing アセンブリと System.Windows.Forms アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.ComponentModel.IListSource>   
+ <xref:System.ComponentModel.ITypedList>   
+ <xref:System.ComponentModel.BindingList%601>   
+ <xref:System.ComponentModel.IBindingList>   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md b/docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md
new file mode 100644
index 00000000000..dc953ae1bb8
--- /dev/null
+++ b/docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : INotifyPropertyChanged インターフェイスを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "INotifyPropertyChanged インターフェイス, 実装"
+ms.assetid: eac428af-b43b-46ac-80d9-1a5f88658725
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : INotifyPropertyChanged インターフェイスを実装する
+<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する方法を次のコード例に示します。  このインターフェイスを Windows フォーム データ バインディングで使用されるビジネス オブジェクトに実装します。  実装すると、インターフェイスは、ビジネス オブジェクトでのバインド コントロールのプロパティの変更内容と通信します。  
+  
+## 使用例  
+ [!code-csharp[System.ComponentModel.IPropertyChangeExample#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.IPropertyChangeExample/CS/Form1.cs#1)]
+ [!code-vb[System.ComponentModel.IPropertyChangeExample#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.IPropertyChangeExample/VB/Form1.vb#1)]  
+  
+## 参照  
+ [方法 : PropertyNameChanged パターンを適用する](../../../docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)   
+ [方法 : BindingSource と INotifyPropertyChanged の各インターフェイスを使用して変更通知を発生させる](../../../docs/framework/winforms/controls/raise-change-notifications--bindingsource.md)   
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-implement-the-itypedlist-interface.md b/docs/framework/winforms/how-to-implement-the-itypedlist-interface.md
new file mode 100644
index 00000000000..5f8a6bffdfd
--- /dev/null
+++ b/docs/framework/winforms/how-to-implement-the-itypedlist-interface.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : ITypedList インターフェイスを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "BindingList(Of T) クラス"
+  - "データ バインド, 実装"
+  - "IBindingList インターフェイス"
+  - "ITypedList インターフェイス"
+ms.assetid: 834cc15c-50bc-4a8b-a610-313d6a217357
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ITypedList インターフェイスを実装する
+バインドできるリストのスキーマを検出できるようにするには、<xref:System.ComponentModel.ITypedList> インターフェイスを実装します。  
+  
+## 使用例  
+ <xref:System.ComponentModel.ITypedList> インターフェイスを実装する方法を次のコード例に示します。  `SortableBindingList` というジェネリック型は、<xref:System.ComponentModel.BindingList%601> クラスから派生し、<xref:System.ComponentModel.ITypedList> インターフェイスを実装します。  `Customer` という単純なクラスは、<xref:System.Windows.Forms.DataGridView> コントロールのヘッダーにバインドされるデータを提供します。  
+  
+ [!code-csharp[System.ComponentModel.ITypedList#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.ITypedList/CS/SortableBindingList.cs#1)]
+ [!code-vb[System.ComponentModel.ITypedList#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.ITypedList/VB/SortableBindingList.vb#1)]  
+  
+ [!code-csharp[System.ComponentModel.ITypedList#10](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.ITypedList/CS/Customer.cs#10)]
+ [!code-vb[System.ComponentModel.ITypedList#10](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.ITypedList/VB/Customer.vb#10)]  
+  
+ [!code-csharp[System.ComponentModel.ITypedList#100](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.ITypedList/CS/Form1.cs#100)]
+ [!code-vb[System.ComponentModel.ITypedList#100](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.ITypedList/VB/Form1.vb#100)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Drawing アセンブリと System.Windows.Forms アセンブリへの参照。  
+  
+## 参照  
+ <xref:System.ComponentModel.ITypedList>   
+ <xref:System.ComponentModel.BindingList%601>   
+ <xref:System.ComponentModel.IBindingList>   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-modify-keyboard-input-to-a-standard-control.md b/docs/framework/winforms/how-to-modify-keyboard-input-to-a-standard-control.md
new file mode 100644
index 00000000000..8c7f336f188
--- /dev/null
+++ b/docs/framework/winforms/how-to-modify-keyboard-input-to-a-standard-control.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : キーボード入力を標準コントロールに変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード入力, 変更"
+  - "キーボード, キーボード入力"
+  - "変更 (キーボード入力を)"
+  - "Windows フォーム, 変更 (キーボード入力を)"
+ms.assetid: 626d3712-d866-4988-bcda-a2d5b36ec0ba
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : キーボード入力を標準コントロールに変更する
+Windows フォームは、キーボードの入力を使用して変更する機能を提供します。  キーの使用とは、メッセージ キューのさらに下のその他のメソッドとイベントが、キーの値を受信しないようにメソッドまたはイベント ハンドラー内のキーを処理することを表します。  キーの変更とは、メッセージ キューのさらに下のメソッドとイベント ハンドラーが、異なるキーの値を受け取るようにキーの値を変更することを表します。  このトピックでは、これらのタスクを実行する方法について説明します。  
+  
+### キーを使用するには  
+  
+-   <xref:System.Windows.Forms.Control.KeyPress> イベント ハンドラーで、<xref:System.Windows.Forms.KeyPressEventArgs> クラスの <xref:System.Windows.Forms.KeyPressEventArgs.Handled%2A> プロパティを `true` に設定します。  
+  
+     または  
+  
+     <xref:System.Windows.Forms.Control.KeyDown> イベント ハンドラーで、<xref:System.Windows.Forms.KeyEventArgs> クラスの <xref:System.Windows.Forms.KeyEventArgs.Handled%2A> プロパティを `true` に設定します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control.KeyDown> イベント ハンドラーで <xref:System.Windows.Forms.KeyEventArgs.Handled%2A> プロパティを設定すると、<xref:System.Windows.Forms.Control.KeyPress> イベントと <xref:System.Windows.Forms.Control.KeyUp> イベントが現在のキー入力から発生しないようにすることができます。  この目的には、<xref:System.Windows.Forms.KeyEventArgs.SuppressKeyPress%2A> プロパティを使用します。  
+  
+     次の例は、<xref:System.Windows.Forms.Control.KeyPress> イベント ハンドラーによって受信された <xref:System.Windows.Forms.KeyPressEventArgs> の <xref:System.Windows.Forms.KeyPressEventArgs.KeyChar%2A> プロパティを検査する `switch` ステートメントの抜粋です。  このコードは、'A' と 'a' 文字のキーを使用します。  
+  
+     [!code-csharp[System.Windows.Forms.KeyBoardInput#6](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/CS/form1.cs#6)]
+     [!code-vb[System.Windows.Forms.KeyBoardInput#6](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/VB/form1.vb#6)]  
+  
+### 標準の文字のキーを変更するには  
+  
+-   <xref:System.Windows.Forms.Control.KeyPress> イベント ハンドラーで、<xref:System.Windows.Forms.KeyPressEventArgs> クラスの <xref:System.Windows.Forms.KeyPressEventArgs.KeyChar%2A> プロパティを新しい文字のキーの値に設定します。  
+  
+     次の例は、'B' を 'A' に変更して、'b' を 'a' に変更する `switch` ステートメントの抜粋です。  <xref:System.Windows.Forms.KeyPressEventArgs> パラメーターの <xref:System.Windows.Forms.KeyPressEventArgs.Handled%2A> のプロパティが `false` に設定され、新しいキーの値が、メッセージ キューの他のメソッドとイベントに反映されることに注意してください。  
+  
+     [!code-csharp[System.Windows.Forms.KeyBoardInput#7](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/CS/form1.cs#7)]
+     [!code-vb[System.Windows.Forms.KeyBoardInput#7](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/VB/form1.vb#7)]  
+  
+### 非文字キーを変更するには  
+  
+-   Windows メッセージを処理する <xref:System.Windows.Forms.Control> メソッドをオーバーライドして、WM\_KEYDOWN または WM\_SYSKEYDOWN のメッセージを検出し、<xref:System.Windows.Forms.Message> パラメーターの <xref:System.Windows.Forms.Message.WParam%2A> プロパティを、新しい非文字キーを表す <xref:System.Windows.Forms.Keys> 値に設定します。  
+  
+     次のコード例は、F1 から F9 のキーを検出して、F3 キーを押したときに F1 に変更するよう、コントロールの <xref:System.Windows.Forms.Control.PreProcessMessage%2A> メソッドをオーバーライドする方法を示しています、  キーボードのメッセージを代行受信するようにオーバーライドできる <xref:System.Windows.Forms.Control> メソッドの詳細については、「[Windows フォーム アプリケーションにおけるユーザー入力](../../../docs/framework/winforms/user-input-in-a-windows-forms-application.md)」と「[キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)」を参照してください。  
+  
+     [!code-csharp[System.Windows.Forms.KeyBoardInput#12](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/CS/form1.cs#12)]
+     [!code-vb[System.Windows.Forms.KeyBoardInput#12](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/VB/form1.vb#12)]  
+  
+## 使用例  
+ 次のコード例は、前のセクションのコード例の完全なアプリケーションです。  アプリケーションは、<xref:System.Windows.Forms.TextBox> クラスから派生したカスタム コントロールを使用して、キーボードの入力を使用して変更します。  
+  
+ [!code-csharp[System.Windows.Forms.KeyBoardInput#0](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.KeyBoardInput#0](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.KeyboardInput/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  「[方法 : 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)   
+ [Windows フォーム アプリケーションにおけるユーザー入力](../../../docs/framework/winforms/user-input-in-a-windows-forms-application.md)   
+ [キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-navigate-data-in-windows-forms.md b/docs/framework/winforms/how-to-navigate-data-in-windows-forms.md
new file mode 100644
index 00000000000..df8f440180a
--- /dev/null
+++ b/docs/framework/winforms/how-to-navigate-data-in-windows-forms.md
@@ -0,0 +1,63 @@
+---
+title: "方法 : Windows フォームでデータ間を移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "CurrencyManager クラス, 移動 (Windows フォームのデータを)"
+  - "カーソル, データ ソース"
+  - "データ [Windows フォーム], 移動"
+  - "データ ソース, Windows フォーム"
+  - "Windows フォーム, 移動"
+ms.assetid: 97360f7b-b181-4084-966a-4c62518f735b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Windows フォームでデータ間を移動する
+Windows アプリケーションで、データ ソースのレコード間を最も簡単な方法で移動するには、<xref:System.Windows.Forms.BindingSource> コンポーネントをデータ ソースにバインドし、その <xref:System.Windows.Forms.BindingSource> にコントロールをバインドします。  その後で、<xref:System.Windows.Forms.BindingSource> の組み込みの移動メソッド \(たとえば、<xref:System.Windows.Forms.BindingSource.MoveNext%2A>、<xref:System.Windows.Forms.BindingSource.MoveLast%2A>、<xref:System.Windows.Forms.BindingSource.MovePrevious%2A>、および <xref:System.Windows.Forms.BindingSource.MoveFirst%2A>\) を使用します。  これらのメソッドを使用すると、<xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.Position%2A> プロパティおよび <xref:System.Windows.Forms.BindingSource.Current%2A> プロパティが適切に調整されます。  また、<xref:System.Windows.Forms.BindingSource.Position%2A> プロパティを設定すると、検索した項目を現在の項目として設定できます。  
+  
+### データ ソース内での位置をインクリメントするには  
+  
+1.  バインドされているデータの <xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.Position%2A> プロパティを、移動先のレコード位置に設定します。  次に示す例では、`nextButton` がクリックされたときに、<xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.MoveNext%2A> メソッドを使用して <xref:System.Windows.Forms.BindingSource.Position%2A> プロパティをインクリメントします。  <xref:System.Windows.Forms.BindingSource> は、データセット `Northwind` の `Customers` テーブルに関連付けられています。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.BindingSource.Position%2A> プロパティを最初または最後のレコードを超える値に設定してもエラーにはなりません。これは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では位置をリストの範囲外の値に設定できないためです。  アプリケーションで最初または最後のレコードを超えたかどうかを知る必要がある場合は、データ要素数を超えるかどうかをテストするロジックを追加します。  
+  
+     [!code-csharp[System.Windows.Forms.NavigatingData#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.NavigatingData#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/VB/Form1.vb#4)]  
+  
+### 最初または最後を超えたかどうかを確認するには  
+  
+1.  <xref:System.Windows.Forms.BindingSource.PositionChanged> イベントのイベント ハンドラーを作成します。  このハンドラーで、指定された位置の値が実際のデータ要素数を超えているかどうかをテストできます。  
+  
+     最後のデータ要素に達したかどうかをテストする方法の例を次に示します。  この例では、最後の要素に達している場合は、フォームの **\[Next\]** ボタンが無効になります。  
+  
+    > [!NOTE]
+    >  コード内を移動するリストを変更する場合は、ユーザーが新しいリスト全体を移動できるように、**\[次へ\]** ボタンをもう一度有効にする必要があるので注意してください。  また、扱う対象となる特定の <xref:System.Windows.Forms.BindingSource> の上記の <xref:System.Windows.Forms.BindingSource.PositionChanged> イベントを、イベント処理メソッドと関連付ける必要がある点にも注意してください。  <xref:System.Windows.Forms.BindingSource.PositionChanged> イベントを処理するメソッドの例を次に示します。  
+  
+     [!code-csharp[System.Windows.Forms.NavigatingData#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.NavigatingData#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/VB/Form1.vb#3)]  
+  
+### 項目を検索し、現在の項目として設定するには  
+  
+1.  現在の項目として設定するレコードを検索します。  <xref:System.ComponentModel.IBindingList> を実装しているデータ ソースの場合には、<xref:System.Windows.Forms.BindingSource> の <xref:System.Windows.Forms.BindingSource.Find%2A> メソッドを使用して検索を実行できます。  <xref:System.ComponentModel.IBindingList> を実装しているデータ ソースの例としては、<xref:System.ComponentModel.BindingList%601> および <xref:System.Data.DataView> があります。  
+  
+     [!code-csharp[System.Windows.Forms.NavigatingData#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.NavigatingData#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.NavigatingData/VB/Form1.vb#2)]  
+  
+## 参照  
+ [Windows フォームがサポートするデータ ソース](../../../docs/framework/winforms/data-sources-supported-by-windows-forms.md)   
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)   
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-resize-windows-forms.md b/docs/framework/winforms/how-to-resize-windows-forms.md
new file mode 100644
index 00000000000..f6d8bab0185
--- /dev/null
+++ b/docs/framework/winforms/how-to-resize-windows-forms.md
@@ -0,0 +1,132 @@
+---
+title: "方法 : Windows フォームのサイズを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "サイズ変更 (Windows フォームを)"
+  - "Windows フォーム, サイズ変更"
+ms.assetid: 5d9dd47e-e68c-48c9-a0a3-a9ff34ba009d
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Windows フォームのサイズを変更する
+Windows フォームのサイズは、いくつかの方法で指定できます。  <xref:System.Windows.Forms.Form.Size%2A> プロパティに新しい値を設定したり、<xref:System.Windows.Forms.Control.Height%2A> プロパティまたは <xref:System.Windows.Forms.Control.Width%2A> プロパティを個別に調整したりすることで、フォームの高さと幅の両方をプログラムで変更できます。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用している場合は、Windows フォーム デザイナーを使用してサイズを変更することができます。  「[方法 : デザイナーを使用して Windows フォームのサイズを変更する](http://msdn.microsoft.com/library/37k2zkwx\(v=vs.110\))」も参照してください。  
+  
+### プログラムによってフォームのサイズを変更するには  
+  
+-   フォームの <xref:System.Windows.Forms.Form.Size%2A> プロパティを設定して、実行時にフォームのサイズを定義します。  
+  
+     次のコード例では、フォームのサイズを 100 × 100 ピクセルに設定します。  
+  
+    ```vb  
+    Form1.Size = New System.Drawing.Size(100, 100)  
+  
+    ```  
+  
+    ```csharp  
+    Form1.Size = new System.Drawing.Size(100, 100);  
+  
+    ```  
+  
+    ```cpp  
+    Form1->Size = System::Drawing::Size(100, 100);  
+    ```  
+  
+### フォームの幅と高さをプログラムで変更するには  
+  
+-   <xref:System.Windows.Forms.Form.Size%2A> を定義した後で、<xref:System.Windows.Forms.Control.Width%2A> プロパティまたは <xref:System.Windows.Forms.Control.Height%2A> プロパティを使用して、フォームの高さと幅のいずれかを変更します。  
+  
+     次のコード例は、フォームの幅を、フォームの左端から 300 ピクセルに設定し、高さは一定のままにする方法を示しています。  
+  
+    ```vb  
+    Form1.Width = 300  
+  
+    ```  
+  
+    ```csharp  
+    Form1.Width = 300;  
+  
+    ```  
+  
+    ```cpp  
+    Form1->Width = 300;  
+    ```  
+  
+     または  
+  
+     <xref:System.Windows.Forms.Form.Size%2A> プロパティを設定して、<xref:System.Drawing.Size.Width%2A> または <xref:System.Drawing.Size.Height%2A> を変更します。  
+  
+     ただし、次のコード例が示すように、この方法は、<xref:System.Windows.Forms.Control.Width%2A> プロパティまたは <xref:System.Windows.Forms.Control.Height%2A> プロパティをただ設定する方法よりも煩雑になります。  
+  
+    ```vb  
+    Form1.Size = New Size(300, Form1.Size.Height)  
+  
+    ```  
+  
+    ```csharp  
+    Form1.Size = new Size(300, Form1.Size.Height);  
+  
+    ```  
+  
+    ```cpp  
+    Form1->Size = System::Drawing::Size(300, Form1->Size.Height);  
+    ```  
+  
+### フォームのサイズをプログラムで増分して変更するには  
+  
+-   フォームのサイズを増分するには、<xref:System.Drawing.Size.Width%2A> プロパティと <xref:System.Drawing.Size.Height%2A> プロパティを設定します。  
+  
+     次のコード例は、フォームの幅を、現在の設定より 200 ピクセル広くする方法を示しています。  
+  
+    ```vb  
+    Form1.Width += 200  
+  
+    ```  
+  
+    ```csharp  
+    Form1.Width += 200;  
+  
+    ```  
+  
+    ```cpp  
+    Form1->Width += 200;  
+    ```  
+  
+    > [!CAUTION]
+    >  <xref:System.Windows.Forms.Form.Size%2A> プロパティを新しい <xref:System.Drawing.Size> 構造に設定することにより高さと幅の両方のディメンションを同時に設定するというのでない限り、フォームのディメンションを変更するには、常に <xref:System.Drawing.Size.Height%2A> プロパティまたは <xref:System.Drawing.Size.Width%2A> プロパティを使用します。  <xref:System.Windows.Forms.Form.Size%2A> プロパティは、値型である <xref:System.Drawing.Size> 構造を返します。  値型のプロパティに新しい値を割り当てることはできません。  このため、次のコード例はコンパイルされません。  
+  
+    ```vb  
+    ' NOTE: CODE WILL NOT COMPILE  
+    Dim f As New Form()  
+    f.Size.Width += 100  
+  
+    ```  
+  
+    ```csharp  
+    // NOTE: CODE WILL NOT COMPILE  
+    Form f = new Form();  
+    f.Size.Width += 100;  
+  
+    ```  
+  
+    ```cpp  
+    // NOTE: CODE WILL NOT COMPILE  
+    Form^ f = gcnew Form();  
+    f->Size->X += 100;  
+    ```  
+  
+## 参照  
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)   
+ [Windows フォーム アプリケーションの拡張](../../../docs/framework/winforms/advanced/index.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-respond-to-font-scheme-changes-in-a-windows-forms-application.md b/docs/framework/winforms/how-to-respond-to-font-scheme-changes-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..4d327ce1ad7
--- /dev/null
+++ b/docs/framework/winforms/how-to-respond-to-font-scheme-changes-in-a-windows-forms-application.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : Windows フォーム アプリケーションでのフォント パターンの変更に応答する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, フォント パターンの変更"
+ms.assetid: 4db27702-22e7-43bf-a07d-9a004549853c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Windows フォーム アプリケーションでのフォント パターンの変更に応答する
+Windows オペレーティング システムでは、システム全体のフォント設定を変更して、既定のフォントの表示サイズを大きくしたり、小さくしたりできます。  このようなフォント設定の変更は、視覚障害があり、画面上のテキストを読み取る際に比較的大きめの活字を必要とするユーザーにとって重要です。  Windows フォーム アプリケーションを、このような変更に合わせて調整するには、フォント パターンが変更されたときにフォームとフォームに含まれるすべてのテキストのサイズを拡大または縮小します。  フォント サイズの変更にフォームが動的に対応するようにする場合は、フォームにコードを追加します。  
+  
+ 通常、Windows フォームで使用される既定のフォントは、<xref:Microsoft.Win32> 名前空間での `GetStockObject(DEFAULT_GUI_FONT)` への呼び出しで返されたフォントです。  この呼び出しで返されたフォントは、画面の解像度を変更したときにのみ変更されます。  次の手順に示すように、フォント サイズの変更に応答するには、コードによって既定のフォントを <xref:System.Drawing.SystemFonts.IconTitleFont%2A> に変更する必要があります。  
+  
+### デスクトップ フォントを使用して、フォント パターンの変更に応答するには  
+  
+1.  フォームを作成し、必要なコントロールを追加します。  詳細については、「[方法 : コマンド ラインから Windows フォーム アプリケーションを作成する](../../../docs/framework/winforms/how-to-create-a-windows-forms-application-from-the-command-line.md)」および「[Windows フォームで使用するコントロール](../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)」を参照してください。  
+  
+2.  <xref:Microsoft.Win32> 名前空間への参照をコードに追加します。  
+  
+     [!code-csharp[WinFormsAutoScaling#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/WinFormsAutoScaling/CS/Form1.cs#2)]
+     [!code-vb[WinFormsAutoScaling#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WinFormsAutoScaling/VB/Form1.vb#2)]  
+  
+3.  必要なイベント ハンドラーをフックし、フォームで使用する既定のフォントを変更するために、次のコードをフォームのコンストラクターに追加します。  
+  
+     [!code-csharp[WinFormsAutoScaling#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/WinFormsAutoScaling/CS/Form1.cs#3)]
+     [!code-vb[WinFormsAutoScaling#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WinFormsAutoScaling/VB/Form1.vb#3)]  
+  
+4.  <xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> イベントのハンドラーを実装します。これにより、<xref:Microsoft.Win32.UserPreferenceCategory> カテゴリが変更されたときにフォームが自動的にスケーリングされます。  
+  
+     [!code-csharp[WinFormsAutoScaling#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/WinFormsAutoScaling/CS/Form1.cs#4)]
+     [!code-vb[WinFormsAutoScaling#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WinFormsAutoScaling/VB/Form1.vb#4)]  
+  
+5.  最後に、<xref:Microsoft.Win32.SystemEvents.UserPreferenceChanged> イベント ハンドラーをデタッチする、<xref:System.Windows.Forms.Form.FormClosing> イベントのハンドラーを実装します。  
+  
+> [!IMPORTANT]
+>  このコードを追加しないと、アプリケーションでメモリ リークが発生します。  
+  
+ [!code-csharp[WinFormsAutoScaling#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/WinFormsAutoScaling/CS/Form1.cs#5)]
+ [!code-vb[WinFormsAutoScaling#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WinFormsAutoScaling/VB/Form1.vb#5)]  
+  
+1.  コードをコンパイルして実行します。  
+  
+### Windows XP でフォント パターンを手動で変更するには  
+  
+1.  Windows フォーム アプリケーションを実行しているときに Windows のデスクトップを右クリックし、ショートカット メニューの **\[プロパティ\]** をクリックします。  
+  
+2.  **\[画面のプロパティ\]** ダイアログ ボックスの **\[デザイン\]** タブをクリックします。  
+  
+3.  **\[フォント サイズ\]** ボックスで、新しいフォント サイズを選択します。  
+  
+     フォームは、デスクトップ フォント パターンの実行時の変更に対応します。  ユーザーが **\[標準\]**、**\[大\]**、または **\[特大\]** のいずれかに変更すると、フォームのフォントとスケールが適切に変更されます。  
+  
+## 使用例  
+ [!code-csharp[WinFormsAutoScaling#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/WinFormsAutoScaling/CS/Form1.cs#1)]
+ [!code-vb[WinFormsAutoScaling#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/WinFormsAutoScaling/VB/Form1.vb#1)]  
+  
+ 次のコード例に示されているコンストラクターには、Visual Studio で新しい Windows フォームを作成するときに定義される `InitializeComponent` への呼び出しが含まれています。  アプリケーションをコマンド ラインで作成する場合は、このコード行を削除してください。  
+  
+## 参照  
+ <xref:System.Windows.Forms.ContainerControl.PerformAutoScale%2A>   
+ [Windows フォームにおける自動スケーリング](../../../docs/framework/winforms/automatic-scaling-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/how-to-simulate-mouse-and-keyboard-events-in-code.md b/docs/framework/winforms/how-to-simulate-mouse-and-keyboard-events-in-code.md
new file mode 100644
index 00000000000..0e97c0a1fb4
--- /dev/null
+++ b/docs/framework/winforms/how-to-simulate-mouse-and-keyboard-events-in-code.md
@@ -0,0 +1,98 @@
+---
+title: "方法 : マウス イベントとキーボード イベントをコードでシミュレートする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード, イベントのシミュレート"
+  - "ユーザー入力, シミュレート"
+  - "SendKeys, 使用"
+  - "マウス クリック, シミュレート"
+  - "マウス, イベントのシミュレート"
+ms.assetid: 6abcb67e-3766-4af2-9590-bf5dabd17e41
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : マウス イベントとキーボード イベントをコードでシミュレートする
+Windows フォームは、プログラムでマウスおよびキーボード入力をシミュレートするためのいくつかのオプションを提供します。 ここでは、これらのオプションの概要について説明します。  
+  
+## マウス入力のシミュレート  
+ マウス イベントをシミュレートする最善の方法は、`On`*EventName* メソッドを呼び出して、シミュレートの対象となるマウス イベントを発生させる方法です。 このオプションは、イベントを発生させるメソッドが保護され、コントロールまたはフォームの外部にアクセスできないため、通常はカスタム コントロールおよびフォーム内でのみ可能です。 たとえば、次の手順は、コードでマウスの右ボタンのクリックをシミュレートする方法を示しています。  
+  
+#### プログラムでマウスの右ボタンをクリックするには  
+  
+1.  <xref:System.Windows.Forms.MouseEventArgs.Button%2A> プロパティが <xref:System.Windows.Forms.MouseButtons?displayProperty=fullName> 値に設定された <xref:System.Windows.Forms.MouseEventArgs> を作成します。  
+  
+2.  この <xref:System.Windows.Forms.MouseEventArgs> を持つ <xref:System.Windows.Forms.Control.OnMouseClick%2A> メソッドを引数として呼び出します。  
+  
+ カスタム コントロールの詳細については、「[デザイン時の Windows フォーム コントロールの開発](../../../docs/framework/winforms/controls/developing-windows-forms-controls-at-design-time.md)」をご覧ください。  
+  
+ マウス入力をシミュレートする方法はほかにもあります。 たとえば、マウス入力によって標準的に設定する状態を表すコントロールのプロパティをプログラムで設定したり \(<xref:System.Windows.Forms.CheckBox> コントロールの <xref:System.Windows.Forms.CheckBox.Checked%2A> プロパティなど\)、シミュレートの対象イベントにアタッチされているデリゲートを直接呼び出したりできます。  
+  
+## キーボード入力のシミュレート  
+ 前述のマウス入力に関する戦略を使用することで、キーボード入力をシミュレートできますが、Windows フォームはアクティブなアプリケーションにキー入力を送信するための <xref:System.Windows.Forms.SendKeys> クラスも提供します。  
+  
+> [!CAUTION]
+>  アプリケーションが国際対応し、さまざまなキーボードの使用を想定している場合は、<xref:System.Windows.Forms.SendKeys.Send%2A?displayProperty=fullName> の使用により予期しない結果になる可能性があるため、回避する必要があります。  
+  
+> [!NOTE]
+>  .NET Framework 3.0 の <xref:System.Windows.Forms.SendKeys> クラスが更新され、Windows Vista で実行されるアプリケーションで使用できるようになりました。 Windows Vista の強化されたセキュリティ、\(ユーザー アカウント制御または UAC と呼ばれます\) により、前の実装は想定どおり機能できません。  
+>   
+>  <xref:System.Windows.Forms.SendKeys> クラスはタイミングの問題が発生する可能性があり、一部の開発者は回避策を取る必要がありました。 更新された実装は、引き続きタイミングの問題が発生する可能性がありますが、速度が少し向上し、回避策の変更が必要となる可能性があります。<xref:System.Windows.Forms.SendKeys> クラスは、最初に前の実装を使用しようとし、失敗した場合に、新しい実装を使用します。 その結果、<xref:System.Windows.Forms.SendKeys> クラスが別のオペレーティング システムと異なる動作を取る可能性があります。 さらに、<xref:System.Windows.Forms.SendKeys> クラスは、新しい実装を使用した場合、<xref:System.Windows.Forms.SendKeys.SendWait%2A> メソッドが別のプロセスに送信されたときにメッセージの処理を待機しません。  
+>   
+>  アプリケーションが、オペレーティング システムに関係なく一貫した動作に依存する場合、app.config ファイルに次のアプリケーション設定を追加することで、<xref:System.Windows.Forms.SendKeys> クラスが新しい実装を使用するよう強制することができます。  
+>   
+>  `<appSettings>`  
+>   
+>  `<add key="SendKeys" value="SendInput"/>`  
+>   
+>  `</appSettings>`  
+>   
+>  <xref:System.Windows.Forms.SendKeys> クラスが前の実装を使用するよう強制するには、代わりに値 `"JournalHook"` を使用します。  
+  
+#### 同じアプリケーションにキーストロークを送信するには  
+  
+1.  <xref:System.Windows.Forms.SendKeys> クラスの <xref:System.Windows.Forms.SendKeys.Send%2A> メソッドまたは <xref:System.Windows.Forms.SendKeys.SendWait%2A> メソッドを呼び出します。 指定されたキーストロークは、アプリケーションのアクティブなコントロールによって受信されます。 次のコード例では、<xref:System.Windows.Forms.SendKeys.Send%2A> を使用して、ユーザーがフォームのサーフェイスをダブルクリックしたときに、ENTER キーを押す操作をシミュレートします。 この例では、0 のタブ インデックスを持つ単一の <xref:System.Windows.Forms.Button> コントロールがある <xref:System.Windows.Forms.Form> を想定しています。  
+  
+     [!code-cpp[System.Windows.Forms.SimulateKeyPress#10](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/cpp/form1.cpp#10)]
+     [!code-csharp[System.Windows.Forms.SimulateKeyPress#10](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/CS/form1.cs#10)]
+     [!code-vb[System.Windows.Forms.SimulateKeyPress#10](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/VB/form1.vb#10)]  
+  
+#### 別のアプリケーションにキーストロークを送信するには  
+  
+1.  キー入力を受信するアプリケーション ウィンドウをアクティブ化し、<xref:System.Windows.Forms.SendKeys.Send%2A> メソッドまたは <xref:System.Windows.Forms.SendKeys.SendWait%2A> メソッドを呼び出します。 別のアプリケーションをアクティブ化するマネージ メソッドがないため、ネイティブ Windows メソッドを使用して他のアプリケーションにフォーカスを設定する必要があります。 次のコード例は、プラットフォーム呼び出しを使用して `FindWindow` メソッドと `SetForegroundWindow` メソッドを呼び出し、電卓アプリケーションのウィンドウをアクティブ化してから、<xref:System.Windows.Forms.SendKeys.SendWait%2A> を呼び出して電卓アプリケーションに一連の計算を発行します。  
+  
+    > [!NOTE]
+    >  電卓アプリケーションを特定する `FindWindow` 呼び出しの適切なパラメーターは、Windows のバージョンに応じて異なります。  次のコードでは、[!INCLUDE[win7](../../../includes/win7-md.md)] の電卓アプリケーションを検索します。[!INCLUDE[windowsver](../../../includes/windowsver-md.md)] では、最初のパラメーターを「SciCalc」に変更します。 Visual Studio に付属の Spy\+\+ ツールを使用して、適切なパラメーターを特定します。  
+  
+     [!code-cpp[System.Windows.Forms.SimulateKeyPress#5](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/cpp/form1.cpp#5)]
+     [!code-csharp[System.Windows.Forms.SimulateKeyPress#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/CS/form1.cs#5)]
+     [!code-vb[System.Windows.Forms.SimulateKeyPress#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/VB/form1.vb#5)]  
+  
+## 使用例  
+ 次のコード例は、前のコード例の完全なアプリケーションです。  
+  
+ [!code-cpp[System.Windows.Forms.SimulateKeyPress#0](../../../samples/snippets/cpp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/cpp/form1.cpp#0)]
+ [!code-csharp[System.Windows.Forms.SimulateKeyPress#0](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/CS/form1.cs#0)]
+ [!code-vb[System.Windows.Forms.SimulateKeyPress#0](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.SimulateKeyPress/VB/form1.vb#0)]  
+  
+## コードのコンパイル  
+ この例で必要な要素は次のとおりです。  
+  
+-   System、System.Drawing、および System.Windows.Forms の各アセンブリへの参照。  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のコマンド ラインからこの例をビルドする方法については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」または「[csc.exe を使用したコマンド ラインからのビルド](../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。 また、コードを新しいプロジェクトに貼り付けることにより、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でこの例をビルドすることもできます。  また、「[方法: 完成した Windows フォーム コードの例を Visual Studio を使ってコンパイルして実行する](http://msdn.microsoft.com/library/Bb129228\(v=vs.110\))」も参照してください。  
+  
+## 参照  
+ [Windows フォームでのユーザー入力](../../../docs/framework/winforms/user-input-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/index.md b/docs/framework/winforms/index.md
new file mode 100644
index 00000000000..3668445076b
--- /dev/null
+++ b/docs/framework/winforms/index.md
@@ -0,0 +1,64 @@
+---
+title: "Windows フォーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ユーザー インターフェイス"
+  - "ユーザー インターフェイス, フォーム"
+  - "Windows フォーム"
+ms.assetid: 627df1e9-b254-41af-bbac-9a4f02810c54
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# Windows フォーム
+フォームはアプリケーションの基本単位であるため、機能とデザインにある程度の配慮を与えることが重要です。  フォームは、最終的には開発者がユーザー インターフェイスを作成するコントロールとデータを操作するコードを拡張する白紙状態です。  そのために、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] はコード作成を支援する統合開発環境 \(IDE\) や、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] を使用して作成された豊富なコントロール セットを提供します。  これらのコントロールの機能をコードに補完することにより、必要なソリューションを簡単に素早く開発できます。  
+  
+## このセクションの内容  
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)  
+ データの表示、ユーザー入力の処理、アプリケーションの簡単で堅牢なセキュリティを使用した配置のために、Windows フォームの機能を利用する方法に関するトピックへのリンクを提供します。  
+  
+ [Windows フォーム アプリケーションの拡張](../../../docs/framework/winforms/advanced/index.md)  
+ Windows フォームでのさまざまな機能を拡張する方法に関するトピックへのリンクを提供します。  
+  
+## 関連項目  
+ [Windows フォーム コントロール](../../../docs/framework/winforms/controls/index.md)  
+ Windows フォーム コントロールの説明および、その実装方法について説明するトピックへのリンクが含まれます。  
+  
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)  
+ Windows フォームのデータ バインディング アーキテクチャについて説明するトピックへのリンクが含まれます。  
+  
+ [グラフィックスの概要](../../../docs/framework/winforms/advanced/graphics-overview-windows-forms.md)  
+ Windows のグラフィック デザイン インターフェイスの高度な実装を使用して、オブジェクトとして、グラフィックスを作成、テキストを描画、および、画像を操作する方法について説明します。  
+  
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)  
+ ClickOnce 配置の基本原則について説明します。  
+  
+ [Visual Basic 6.0 ユーザー向けのフォームのタスク](http://msdn.microsoft.com/ja-jp/c3e8f7cf-456b-41df-b5a5-e0370039e525)  
+ フォームが新しいバージョンでどのように変更されたかについて説明します。  
+  
+ [Windows フォームと MFC のプログラミング上の違い](../Topic/Windows%20Forms-MFC%20Programming%20Differences.md)  
+ MFC アプリケーションと Windows フォームの違いについて説明します。  
+  
+ [Visual Studio でのデータへのアクセス](../Topic/Accessing%20data%20in%20Visual%20Studio.md)  
+ アプリケーションにデータ アクセス機能を取り込む方法について説明します。  
+  
+ [Windows フォーム アプリケーション](../Topic/Debugging%20Preparation:%20Windows%20Forms%20Applications.md)  
+ Windows アプリケーション プロジェクト テンプレートを使用して作成されたアプリケーションのデバッグのプロセス、およびデバッグ構成とリリース構成を変更する方法について説明します。  
+  
+ [アプリケーション、サービス、およびコンポーネントの配置](../Topic/Deploying%20Applications,%20Services,%20and%20Components.md)  
+ 完成したアプリケーションやコンポーネントを他のコンピューターにインストールできるように配布するためのプロセスについて説明します。  
+  
+ [コンソール アプリケーションの構築](../../../docs/standard/building-console-apps.md)  
+ <xref:System.Console> クラスを使用したコンソール アプリケーションの作成の基本について説明します。
\ No newline at end of file
diff --git a/docs/framework/winforms/interfaces-related-to-data-binding.md b/docs/framework/winforms/interfaces-related-to-data-binding.md
new file mode 100644
index 00000000000..59bbe621743
--- /dev/null
+++ b/docs/framework/winforms/interfaces-related-to-data-binding.md
@@ -0,0 +1,164 @@
+---
+title: "データ連結に関連するインターフェイス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], データ バインディング インターフェイス"
+  - "データ バインド, インターフェイス"
+  - "IBindingList インターフェイス, Windows フォームのデータ バインディング"
+  - "IBindingListView インターフェイス"
+  - "IDataErrorInfo インターフェイス, Windows フォームのデータ バインディング"
+  - "IEditableObject インターフェイス, Windows フォームのデータ バインディング"
+  - "IList インターフェイス, Windows フォームのデータ バインディング"
+  - "INotifyPropertyChanged インターフェイス"
+  - "インターフェイス, Windows フォームのデータ バインディング"
+ms.assetid: 14e49a2e-3e46-47ca-b491-70d546333277
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# データ連結に関連するインターフェイス
+[!INCLUDE[vstecado](../../../includes/vstecado-md.md)] では、アプリケーションで必要なバインディングや、処理する対象のデータに合わせて、さまざまなデータ構造を作成できます。  Windows フォームでデータを提供または利用するための独自のクラスを作成すると役立つ場合があります。  これらのオブジェクトはさまざまなレベルの機能を提供でき、複雑さもそれぞれに異なります。基本的なデータ バインディングを提供するもの、デザイン時のサポート、エラー チェック機能、または変更通知機能を提供するもの、さらには、データ自体に加えられた変更の構造化されたロールバックをサポートするものまであります。  
+  
+## データ バインディング インターフェイスのコンシューマー  
+ 以下のセクションでは、インターフェイス オブジェクトを 2 つのグループに分けて説明します。  1 つ目のグループは、データ ソース作成者がデータ ソースに実装するインターフェイスの一覧です。  これらのインターフェイスは、データ ソース コンシューマーによって利用されるようにデザインされています。データ ソース コンシューマーは、通常は Windows フォーム コントロールまたはコンポーネントです。  2 つ目のグループは、コンポーネント作成者によって利用されるようデザインされているインターフェイスの一覧です。  Windows フォーム データ バインディング エンジンが利用する、データ バインディングをサポートするコンポーネントを作成するときに、コンポーネント作成者はこれらのインターフェイスを使用します。  フォームに関連付けられたクラス内にこれらのインターフェイスを実装することで、データ バインディングを有効にできます。つまり、データとの対話を実現するインターフェイスを実装したクラスを作成できます。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の Rapid Application Development \(RAD\) データ デザイン体験ツールでは、この機能が既に活用されています。  
+  
+### データ ソース作成者が実装するインターフェイス  
+ 以下のインターフェイスは、Windows フォーム コントロールによって利用されるようにデザインされています。  
+  
+-   <xref:System.Collections.IList> インターフェイスの使い方  
+  
+     <xref:System.Collections.IList> インターフェイスを実装するクラスには、<xref:System.Array>、<xref:System.Collections.ArrayList>、および <xref:System.Collections.CollectionBase> があります。  これらは、<xref:System.Object> 型の項目のインデックス付きリストです。  これらのリストは、同じ型のみを格納できます。インデックスの先頭の項目によって型が決定されるためです。  <xref:System.Collections.IList> は、実行時にのみバインディングに利用できます。  
+  
+    > [!NOTE]
+    >  Windows フォームとのバインディングのために、ビジネス オブジェクトのリストを作成する場合には、<xref:System.ComponentModel.BindingList%601> の使用を検討する必要があります。  <xref:System.ComponentModel.BindingList%601> は、双方向の Windows フォーム データ バインディングに必要となる主要なインターフェイスが実装された、拡張性のあるクラスです。  
+  
+-   <xref:System.ComponentModel.IBindingList> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IBindingList> インターフェイスを実装するクラスは、はるかに高いレベルのデータ バインディング機能を提供します。  この実装は、基本的な並べ替え機能と変更通知機能を持ちます。変更通知機能では、リスト項目が変更されたとき \(たとえば、顧客リストの 3 番目の項目で Address フィールドが変更されたとき\) とリスト自体が変更されたとき \(たとえば、リスト内の項目の数が増減したとき\) の両方について変更が通知されます。  変更通知は、複数のコントロールを同じデータにバインドする予定のときに、1 つのコントロールで行ったデータ変更を他のバインド コントロールにも反映させる場合に重要です。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.IBindingList> インターフェイスの変更通知は <xref:System.ComponentModel.IBindingList.SupportsChangeNotification%2A> プロパティで有効にされます。このプロパティが `true` の場合には <xref:System.ComponentModel.IBindingList.ListChanged> イベントが発生し、リストまたはその中の項目が変更されたことが示されます。  
+  
+     変更の種類は、<xref:System.ComponentModel.ListChangedEventArgs> パラメーターの <xref:System.ComponentModel.ListChangedType> プロパティで示されます。  したがって、データ モデルが更新されたときには、それに依存するビュー \(たとえば、同じデータ ソースにバインドされた他のコントロール\) も更新されます。  ただし、リストが <xref:System.ComponentModel.IBindingList.ListChanged> イベントを発生させるためには、リスト内に含まれるオブジェクトが変更されたときに、それをリストに通知する必要があります。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.BindingList%601> は、<xref:System.ComponentModel.IBindingList> インターフェイスの汎用実装です。  
+  
+-   <xref:System.ComponentModel.IBindingListView> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IBindingListView> インターフェイスを実装するクラスは、<xref:System.ComponentModel.IBindingList> の実装が持つすべての機能に加えて、フィルター処理機能および高度な並べ替え機能を持ちます。  この実装は、文字列ベースのフィルター処理、およびプロパティ記述子と方向のペアによる複数列の並べ替え機能を提供します。  
+  
+-   <xref:System.ComponentModel.IEditableObject> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IEditableObject> インターフェイスを実装するクラスを使用すると、オブジェクトへの変更を永続化するタイミングをオブジェクトが制御できるようになります。  この実装により、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A>、<xref:System.ComponentModel.IEditableObject.EndEdit%2A>、および <xref:System.ComponentModel.IEditableObject.CancelEdit%2A> の各メソッドを使用できるようになり、それによってオブジェクトへの変更をロールバックできます。  次に示すのは、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A>、<xref:System.ComponentModel.IEditableObject.EndEdit%2A>、および <xref:System.ComponentModel.IEditableObject.CancelEdit%2A> の各メソッドの機能と、データに対して加えられた変更のロールバックを実現するためのこれら各メソッドの連係についての簡単な説明です。  
+  
+    -   <xref:System.ComponentModel.IEditableObject.BeginEdit%2A> メソッドはオブジェクトの編集の開始を示します。  このインターフェイスを実装するオブジェクトは、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A> メソッドの呼び出し後に加えられたすべての更新を格納して、<xref:System.ComponentModel.IEditableObject.CancelEdit%2A> メソッドが呼び出されたときに破棄できるようにする必要があります。  Windows フォームのデータ バインディングでは、1 つの編集トランザクションのスコープ内で <xref:System.ComponentModel.IEditableObject.BeginEdit%2A> を複数回呼び出すことができます \(たとえば、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A>、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A>、<xref:System.ComponentModel.IEditableObject.EndEdit%2A>\)。  <xref:System.ComponentModel.IEditableObject> の実装では、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A> が既に呼び出されたかどうかを追跡し、それ以降の <xref:System.ComponentModel.IEditableObject.BeginEdit%2A> の呼び出しを無視する必要があります。  このメソッドは複数回呼び出すことができるため、同じメソッドの以降の呼び出しが破壊的でないことが重要です。つまり、以降の <xref:System.ComponentModel.IEditableObject.BeginEdit%2A> の呼び出しでは、既に加えられている更新を破棄したり、最初の <xref:System.ComponentModel.IEditableObject.BeginEdit%2A> 呼び出し時に保存されたデータを変更したりすることはできません。  
+  
+    -   <xref:System.ComponentModel.IEditableObject.EndEdit%2A> メソッドは、基になるオブジェクトが現在編集モードである場合に、<xref:System.ComponentModel.IEditableObject.BeginEdit%2A> の呼び出し後に加えられた変更をオブジェクトに反映します。  
+  
+    -   <xref:System.ComponentModel.IEditableObject.CancelEdit%2A> メソッドは、オブジェクトに加えられた変更を破棄します。  
+  
+     <xref:System.ComponentModel.IEditableObject.BeginEdit%2A>、<xref:System.ComponentModel.IEditableObject.EndEdit%2A>、および <xref:System.ComponentModel.IEditableObject.CancelEdit%2A> の各メソッドの機能の詳細については、「[データセットのデータの保存](../Topic/Save%20data%20back%20to%20the%20database.md)」を参照してください。  
+  
+     データ機能のこのトランザクションの概念は、<xref:System.Windows.Forms.DataGridView> コントロールで使用されています。  
+  
+-   <xref:System.ComponentModel.ICancelAddNew> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.ICancelAddNew> インターフェイスを実装するクラスには、<xref:System.ComponentModel.IBindingList> インターフェイスも実装するのが一般的で、<xref:System.ComponentModel.IBindingList.AddNew%2A> メソッドでデータ ソースに対して行われた追加をロールバックできるようにします。  データ ソースに <xref:System.ComponentModel.IBindingList> インターフェイスを実装する場合には、<xref:System.ComponentModel.ICancelAddNew> インターフェイスも実装する必要があります。  
+  
+-   <xref:System.ComponentModel.IDataErrorInfo> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IDataErrorInfo> インターフェイスを実装するクラスでは、オブジェクトからバインド コントロールに対してカスタムのエラー情報を次のように提供できます。  
+  
+    -   <xref:System.ComponentModel.IDataErrorInfo.Error%2A> プロパティは、一般的なエラー メッセージ テキスト \(たとえば、"An error has occurred"\) を返します。  
+  
+    -   <xref:System.ComponentModel.IDataErrorInfo.Item%2A> プロパティは、列からの具体的なエラー メッセージを含む文字列 \(たとえば、"The value in the `State` column is invalid"\) を返します。  
+  
+-   <xref:System.Collections.IEnumerable> インターフェイスの使い方  
+  
+     <xref:System.Collections.IEnumerable> インターフェイスを実装するクラスは、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] によって利用されるのが一般的です。  このインターフェイスに対する Windows フォームのサポートは、<xref:System.Windows.Forms.BindingSource> コンポーネントを通じてのみ利用できます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.BindingSource> コンポーネントは、バインディングのために、すべての <xref:System.Collections.IEnumerable> 項目を別個のリストにコピーします。  
+  
+-   <xref:System.ComponentModel.ITypedList> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.ITypedList> インターフェイスを実装するコレクション クラスは、バインド コントロールに対して公開するプロパティの順序と組み合わせを制御する機能を持ちます。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.ITypedList.GetItemProperties%2A> メソッドを実装するとき、<xref:System.ComponentModel.PropertyDescriptor> 配列が null でない場合には、配列の最後のエントリは、他の項目リストであるリスト プロパティを説明するプロパティ記述子です。  
+  
+-   <xref:System.ComponentModel.ICustomTypeDescriptor> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.ICustomTypeDescriptor> インターフェイスを実装するクラスは、自らに関する動的な情報を提供します。  このインターフェイスは <xref:System.ComponentModel.ITypedList> に似ていますが、リストではなくオブジェクトに対して使用されます。  このインターフェイスは、<xref:System.Data.DataRowView> によって、基になる行のスキーマを反映するために使用されます。  <xref:System.ComponentModel.ICustomTypeDescriptor> の単純な実装は <xref:System.ComponentModel.CustomTypeDescriptor> クラスにより提供されています。  
+  
+    > [!NOTE]
+    >  <xref:System.ComponentModel.ICustomTypeDescriptor> を実装する型に対するデザイン時バインディングをサポートするためには、その型に <xref:System.ComponentModel.IComponent> も実装し、フォーム上にインスタンスとして配置する必要があります。  
+  
+-   <xref:System.ComponentModel.IListSource> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IListSource> インターフェイスを実装するクラスでは、非リスト オブジェクトへのリストベース バインディングが可能になります。  <xref:System.ComponentModel.IListSource> の <xref:System.ComponentModel.IListSource.GetList%2A> メソッドを使用すると、<xref:System.Collections.IList> を継承していないオブジェクトから、バインドできるリストを取得できます。  <xref:System.ComponentModel.IListSource> は <xref:System.Data.DataSet> クラスで使用されます。  
+  
+-   <xref:System.ComponentModel.IRaiseItemChangedEvents> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.IRaiseItemChangedEvents> インターフェイスを実装するクラスは、<xref:System.ComponentModel.IBindingList> インターフェイスも実装する、バインドできるリストです。  このインターフェイスは、<xref:System.ComponentModel.ListChangedType> 型の <xref:System.ComponentModel.IBindingList.ListChanged> イベントを発生させる型かどうかを <xref:System.ComponentModel.IRaiseItemChangedEvents.RaisesItemChangedEvents%2A> プロパティを通じて示すために使用されます。  
+  
+    > [!NOTE]
+    >  データ ソースが、前述のリスト イベント変換を行うプロパティを持ち、<xref:System.Windows.Forms.BindingSource> コンポーネントとやり取りする場合には、<xref:System.ComponentModel.IRaiseItemChangedEvents> を実装する必要があります。  その他の場合は、<xref:System.Windows.Forms.BindingSource> がリスト イベント変換のためのプロパティを実行し、結果としてパフォーマンスが低下します。  
+  
+-   <xref:System.ComponentModel.ISupportInitialize> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.ISupportInitialize> インターフェイスを実装するコンポーネントは、プロパティの設定、および互いに依存するプロパティの初期化のために、バッチ最適化を活用します。  <xref:System.ComponentModel.ISupportInitialize> は次の 2 つのメソッドを持ちます。  
+  
+    -   <xref:System.ComponentModel.ISupportInitialize.BeginInit%2A> は、オブジェクトの初期化の開始を通知します。  
+  
+    -   <xref:System.ComponentModel.ISupportInitialize.EndInit%2A> は、オブジェクトの初期化の終了を通知します。  
+  
+-   <xref:System.ComponentModel.ISupportInitializeNotification> インターフェイスの使い方  
+  
+     <xref:System.ComponentModel.ISupportInitializeNotification> インターフェイスを実装するコンポーネントは <xref:System.ComponentModel.ISupportInitialize> インターフェイスも実装します。  このインターフェイスを使用すると、他の <xref:System.ComponentModel.ISupportInitialize> コンポーネントに対して初期化の完了を通知できます。  <xref:System.ComponentModel.ISupportInitializeNotification> インターフェイスは次の 2 つのメンバーを持ちます。  
+  
+    -   <xref:System.ComponentModel.ISupportInitializeNotification.IsInitialized%2A> は、コンポーネントが初期化されているかどうかを示す `boolean` 値を返します。  
+  
+    -   <xref:System.ComponentModel.ISupportInitializeNotification.Initialized> は、<xref:System.ComponentModel.ISupportInitialize.EndInit%2A> が呼び出されたときに発生します。  
+  
+-   <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスの使い方  
+  
+     このインターフェイスを実装するクラスは、いずれかのプロパティ値が変更されたときにイベントを発生させる型です。  このインターフェイスは、コントロールの各プロパティに対して変更イベントを用意するパターンを置き換えるようにデザインされています。  <xref:System.ComponentModel.BindingList%601> で使用する場合、ビジネス オブジェクトは <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する必要があり、BindingList\`1 は <xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントを <xref:System.ComponentModel.ListChangedType> 型の <xref:System.ComponentModel.BindingList%601.ListChanged> イベントに変換します。  
+  
+    > [!NOTE]
+    >  バインド クライアントとデータ ソースとの間のバインディングで変更通知が行われるためには、バインドされるデータ ソース型に <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装するか、またはバインドされる型に *propertyName*`Changed` イベントを用意するかのいずれか一方を行う必要があります。両方を行うことはできません \(前者を行うことをお勧めします\)。  
+  
+### コンポーネント作成者が実装するインターフェイス  
+ 以下のインターフェイスは、Windows フォームのデータ バインディング エンジンによって利用されるようデザインされています。  
+  
+-   <xref:System.Windows.Forms.IBindableComponent> インターフェイスの使い方  
+  
+     このインターフェイスを実装するクラスは、データ バインディングをサポートする非コントロール コンポーネントです。  このクラスは、このインターフェイスの <xref:System.Windows.Forms.IBindableComponent.DataBindings%2A> プロパティおよび <xref:System.Windows.Forms.IBindableComponent.BindingContext%2A> プロパティを通じて、コンポーネントのデータ バインディングおよびバインディング コンテキストを返します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control> を継承するコンポーネントの場合は、<xref:System.Windows.Forms.IBindableComponent> インターフェイスを実装する必要はありません。  
+  
+-   <xref:System.Windows.Forms.ICurrencyManagerProvider> インターフェイスの使い方  
+  
+     <xref:System.Windows.Forms.ICurrencyManagerProvider> インターフェイスを実装するクラスは、この特定のコンポーネントに関連付けられたバインディングを管理するための独自の <xref:System.Windows.Forms.CurrencyManager> を持つコンポーネントです。  カスタムの <xref:System.Windows.Forms.CurrencyManager> へは <xref:System.Windows.Forms.ICurrencyManagerProvider.CurrencyManager%2A> プロパティからアクセスできます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.Control> を継承するクラスでは、バインディングは <xref:System.Windows.Forms.Control.BindingContext%2A> プロパティを通じて自動的に管理されます。そのため、<xref:System.Windows.Forms.ICurrencyManagerProvider> の実装が必要なケースはきわめてまれです。  
+  
+## 参照  
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)   
+ [方法 : Windows フォームに単純バインド コントロールを作成する](../../../docs/framework/winforms/how-to-create-a-simple-bound-control-on-a-windows-form.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md b/docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..a0f7a8ee817
--- /dev/null
+++ b/docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md
@@ -0,0 +1,42 @@
+---
+title: "Windows フォーム アプリケーションにおけるキーボード入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード入力, 使用 (Windows フォームで)"
+  - "キーボード, キーボード入力"
+  - "Windows フォーム, キーボード入力"
+ms.assetid: 68f5bc70-14d5-45c9-b288-7d7b1493ee79
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Windows フォーム アプリケーションにおけるキーボード入力
+Windows フォームは標準のキーボード イベントを備えており、これを使用すると、特定のキーの押下に応答できます。また、アプリケーション、フォーム、およびコントロールの各レベルで、キーの押下を受け取ったり、変更したり、処理したりする手段も備えています。  
+  
+## このセクションの内容  
+ [キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)  
+ キーボード メッセージを処理し、キーボード イベントに変換する方法について説明します。  
+  
+ [キーボード イベントの使用](../../../docs/framework/winforms/using-keyboard-events.md)  
+ キーボード イベントの種類と、キーボード イベント ハンドラーが受け取る情報について説明します。  
+  
+ [方法 : キーボード入力を標準コントロールに変更する](../../../docs/framework/winforms/how-to-modify-keyboard-input-to-a-standard-control.md)  
+ キー値がコントロールに達する前にキー値を変更する方法を示すコード例です。  
+  
+ [方法 : どの修飾子キーが押されたかを判断する](../../../docs/framework/winforms/how-to-determine-which-modifier-key-was-pressed.md)  
+ Shift、Alt、または Ctrl キーが別のキーと一緒に押されたかどうかを見つける方法を示します。  
+  
+ [方法 : キーボード入力をフォーム レベルで処理する](../../../docs/framework/winforms/how-to-handle-keyboard-input-at-the-form-level.md)  
+ キー値がコントロールに達する前にキーを受け取る方法を示すコード例です。
\ No newline at end of file
diff --git a/docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md b/docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md
new file mode 100644
index 00000000000..8920216dfb3
--- /dev/null
+++ b/docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md
@@ -0,0 +1,375 @@
+---
+title: "Windows フォームにおけるファイルおよびデータへのより安全なアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "データ [Windows フォーム], 安全なアクセス"
+  - "データ アクセス [Windows フォーム]"
+  - "データベース アクセス (Windows フォームのセキュリティ)"
+  - "ファイル アクセス [Windows フォーム]"
+  - "レジストリ [Windows フォーム]"
+  - "セキュリティ [Windows フォーム], データ アクセス"
+  - "セキュリティ [Windows フォーム], ファイル アクセス"
+ms.assetid: 3cd3e55b-2f5e-40dd-835d-f50f7ce08967
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Windows フォームにおけるファイルおよびデータへのより安全なアクセス
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、リソースとデータを保護できるアクセス許可を使用します。  アプリケーションでデータを読み取りまたは書き込みできる場所は、アプリケーションに付与されるアクセス許可に依存します。  部分信頼環境でアプリケーションを実行すると、データにアクセス許可がないか、またはデータにアクセスする方法を変更しなければならない可能性があります。  
+  
+ セキュリティの制限が発生した場合、アクセス許可をアサートする \(アプリケーションに付与されていると仮定した場合\)、または部分信頼で動作するよう作成されたバージョンの機能を使用するという 2 つのオプションがあります。  次のセクションでは、部分信頼環境で実行されているアプリケーションからファイル、データベース、およびレジストリ アクセスを操作する方法について説明します。  
+  
+> [!NOTE]
+>  既定では、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の配置を生成するツールは、これらの配置が、実行するコンピューターから完全信頼を要求するよう既定で設定されます。  部分信頼での動作のセキュリティ強化の利点が必要だと判断した場合は、この既定値を [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] または [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] ツール \(Mage.exe または MageUI.exe\) のいずれかに変更する必要があります。  Windows フォームのセキュリティと、アプリケーションの適切な信頼レベルを決定する方法の詳細については、「[Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)」を参照してください。  
+  
+## ファイル アクセス  
+ <xref:System.Security.Permissions.FileIOPermission> クラスは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のファイルとフォルダーへのアクセスを制御します。  既定では、セキュリティ システムは、ローカルのイントラネットやインターネット ゾーンなどの部分信頼環境に <xref:System.Security.Permissions.FileIOPermission> を付与しません。  ただし、ファイルへのアクセスを必要とするアプリケーションは、アプリケーションの設計を変更するかファイルにアクセスする別の方法を使用すると、引き続きこれらの環境で機能することが可能です。  既定では、ローカル イントラネット ゾーンに、同じサイトと同じディレクトリにアクセスして、その起点のサイトに接続し、インストール ディレクトリから読み取るための権限が付与されます。  既定では、インターネット ゾーンは、起点のサイトに接続する権限のみが付与されます。  
+  
+### ユーザー指定のファイル  
+ ファイルへのアクセス許可を持たないときに処理する方法の 1 つは、<xref:System.Windows.Forms.OpenFileDialog> クラスまたは <xref:System.Windows.Forms.SaveFileDialog> クラスを使用して、特定のファイル情報の入力をユーザーに求める方法です。  このユーザーの操作では、アプリケーションが悪意を持ってプライベート ファイルを読み込んだり、重要なファイルを上書きしたりできないことを、ある程度保証できます。  <xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドと <xref:System.Windows.Forms.SaveFileDialog.OpenFile%2A> メソッドは、ユーザーが指定したファイルのファイル ストリームを開くことで、ファイルの読み取りアクセスと書き込みアクセスを提供します。  メソッドは、ファイルのパスを隠すことで、ユーザーのファイルの保護にも役立ちます。  
+  
+> [!NOTE]
+>  これらのアクセス許可は、アプリケーションが、インターネット ゾーン内かイントラネット ゾーン内かに応じて異なります。  インターネット ゾーンのアプリケーションは <xref:System.Windows.Forms.OpenFileDialog> のみを使用できますが、イントラネット アプリケーションは、無制限のファイル ダイアログのアクセス許可を持っています。  
+  
+ <xref:System.Security.Permissions.FileDialogPermission> クラスは、アプリケーションで使用できるファイル ダイアログ ボックスの種類を指定します。  次の表は、各 <xref:System.Windows.Forms.FileDialog> クラスを使用するために必要な値を示しています。  
+  
+|クラス|必要なアクセス権の値|  
+|---------|----------------|  
+|<xref:System.Windows.Forms.OpenFileDialog>|<xref:System.Security.Permissions.FileDialogPermissionAccess>|  
+|<xref:System.Windows.Forms.SaveFileDialog>|<xref:System.Security.Permissions.FileDialogPermissionAccess>|  
+  
+> [!NOTE]
+>  <xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドが実際に呼び出されるまでは、特定のアクセス許可は要求されません。  
+  
+ ファイル ダイアログ ボックスを表示するためのアクセス許可は、<xref:System.Windows.Forms.FileDialog>、<xref:System.Windows.Forms.OpenFileDialog>、および <xref:System.Windows.Forms.SaveFileDialog> の各クラスのすべてのメンバーに対するフルアクセスをアプリケーションに付与しません。  各メソッドを呼び出すために必要とされる正確なアクセス許可については、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] クラス ライブラリのドキュメントのそのメソッドに関するリファレンス トピックを参照してください。  
+  
+ 次のコード例では、<xref:System.Windows.Forms.OpenFileDialog.OpenFile%2A> メソッドを使用して、ユーザーが指定したファイルを <xref:System.Windows.Forms.RichTextBox> コントロールに開きます。  この例では、<xref:System.Security.Permissions.FileDialogPermission> および関連付けられた <xref:System.Security.Permissions.FileDialogPermissionAttribute.Open%2A> 列挙値が必要です。  例では、保存機能を無効にする必要があるかどうかを判断するために、<xref:System.Security.SecurityException> を処理する方法を示しています。  この例では、<xref:System.Windows.Forms.Form> が `ButtonOpen` という名前の <xref:System.Windows.Forms.Button> コントロールと、`RtfBoxMain` という名前の <xref:System.Windows.Forms.RichTextBox> コントロールを必要とします。  
+  
+> [!NOTE]
+>  保存機能のプログラミング ロジックは、この例では表示されません。  
+  
+```vb  
+Private Sub ButtonOpen_Click(ByVal sender As System.Object, _  
+    ByVal e As System.EventArgs) Handles ButtonOpen.Click   
+  
+    Dim editingFileName as String = ""  
+    Dim saveAllowed As Boolean = True  
+  
+    ' Displays the OpenFileDialog.  
+    If (OpenFileDialog1.ShowDialog() = DialogResult.OK) Then  
+        Dim userStream as System.IO.Stream  
+        Try   
+            ' Opens the file stream for the file selected by the user.  
+            userStream =OpenFileDialog1.OpenFile()   
+            Me.RtfBoxMain.LoadFile(userStream, _  
+                RichTextBoxStreamType.PlainText)  
+        Finally  
+            userStream.Close()  
+        End Try  
+  
+        ' Tries to get the file name selected by the user.  
+        ' Failure means that the application does not have  
+        ' unrestricted permission to the file.  
+        Try   
+            editingFileName = OpenFileDialog1.FileName  
+        Catch ex As Exception  
+            If TypeOf ex Is System.Security.SecurityException Then   
+                ' The application does not have unrestricted permission   
+                ' to the file so the save feature will be disabled.  
+                saveAllowed = False   
+            Else   
+                Throw ex  
+            End If  
+        End Try  
+    End If  
+End Sub  
+  
+```  
+  
+```csharp  
+private void ButtonOpen_Click(object sender, System.EventArgs e)   
+{  
+    String editingFileName = "";  
+    Boolean saveAllowed = true;  
+  
+    // Displays the OpenFileDialog.  
+    if (openFileDialog1.ShowDialog() == DialogResult.OK)   
+    {  
+        // Opens the file stream for the file selected by the user.  
+        using (System.IO.Stream userStream = openFileDialog1.OpenFile())   
+        {  
+            this.RtfBoxMain.LoadFile(userStream,  
+                RichTextBoxStreamType.PlainText);  
+            userStream.Close();  
+        }  
+  
+        // Tries to get the file name selected by the user.  
+        // Failure means that the application does not have  
+        // unrestricted permission to the file.  
+        try   
+        {  
+            editingFileName = openFileDialog1.FileName;  
+        }   
+        catch (Exception ex)   
+        {  
+            if (ex is System.Security.SecurityException)   
+            {  
+                // The application does not have unrestricted permission   
+                // to the file so the save feature will be disabled.  
+                saveAllowed = false;   
+            }   
+            else   
+            {  
+                throw ex;  
+            }  
+        }  
+    }  
+}  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] では、イベント ハンドラーを有効にするコードを追加することを確認します。  前の例でのコードを使用することで、次のコードではイベント ハンドラー `this.ButtonOpen.Click += newSystem.Windows.Forms.EventHandler(this.ButtonOpen_Click);` を有効にする方法を示します。  
+  
+### その他のファイル  
+ 場合によって、アプリケーション設定を保存しなければならないという場合など、ユーザーが指定しないファイルへの読み取りまたは書き込みを実行する必要があります。  ローカルのイントラネット ゾーンとインターネット ゾーンでは、アプリケーションにローカル ファイルにデータを格納するためのアクセス許可がありません。  ただし、アプリケーションが分離ストレージにデータを格納できるようにします。  分離ストレージは \(特定の記憶場所ではなく\) 抽象的なデータ コンパートメントであり、データが保存される実際のディレクトリの場所を含む、ストアと呼ばれる 1 つ以上の分離ストレージ ファイルが含まれます。  <xref:System.Security.Permissions.FileIOPermission> のようなファイルのアクセス許可は必要なく、代わりに <xref:System.Security.Permissions.IsolatedStoragePermission> クラスが分離ストレージのアクセス許可を制御します。  既定では、ローカル イントラネット ゾーンとインターネット ゾーンで実行されているアプリケーションが、分離ストレージを使用してデータを格納できます。ただし、ディスク クォータのように設定が変わることがあります。  分離ストレージの詳細については、「[分離ストレージ](../../../docs/standard/io/isolated-storage.md)」を参照してください。  
+  
+ 次の例では、分離ストレージを使用して、ストアにあるファイルにデータを書き込みます。  この例では、<xref:System.Security.Permissions.IsolatedStorageFilePermission> および <xref:System.Security.Permissions.IsolatedStorageContainment> 列挙値が必要です。  例では、分離ストレージ内のファイルに対する、<xref:System.Windows.Forms.Button> コントロールの特定のプロパティ値の読み取りと書き込みを示しています。  `Read` 関数はアプリケーションの起動後に呼び出され、`Write` 関数はアプリケーションの終了前に呼び出されます。  例では、`Read` 関数と `Write` 関数が、`MainButton` という名前の <xref:System.Windows.Forms.Button> コントロールを含む <xref:System.Windows.Forms.Form> のメンバーとして存在していることが必要です。  
+  
+```vb  
+' Reads the button options from the isolated storage. Uses Default values   
+' for the button if the options file does not exist.  
+Public Sub Read()   
+    Dim isoStore As System.IO.IsolatedStorage.IsolatedStorageFile = _  
+        System.IO.IsolatedStorage.IsolatedStorageFile. _   
+        GetUserStoreForDomain()  
+  
+    Dim filename As String = "options.txt"  
+    Try  
+        ' Checks to see if the options.txt file exists.  
+        If (isoStore.GetFileNames(filename).GetLength(0) <> 0) Then  
+  
+            ' Opens the file because it exists.  
+            Dim isos As New System.IO.IsolatedStorage.IsolatedStorageFileStream _   
+                 (filename, IO.FileMode.Open,isoStore)  
+            Dim reader as System.IO.StreamReader  
+            Try   
+                reader = new System.IO.StreamReader(isos)  
+  
+                ' Reads the values stored.  
+                Dim converter As System.ComponentModel.TypeConverter  
+                converter = System.ComponentModel.TypeDescriptor.GetConverter _   
+                    (GetType(Color))  
+  
+                Me.MainButton.BackColor = _   
+                        CType(converter.ConvertFromString _   
+                         (reader.ReadLine()), Color)  
+                me.MainButton.ForeColor = _  
+                        CType(converter.ConvertFromString _   
+                         (reader.ReadLine()), Color)  
+  
+                converter = System.ComponentModel.TypeDescriptor.GetConverter _   
+                    (GetType(Font))  
+                me.MainButton.Font = _  
+                        CType(converter.ConvertFromString _   
+                         (reader.ReadLine()), Font)  
+  
+            Catch ex As Exception  
+                Debug.WriteLine("Cannot read options " + _  
+                    ex.ToString())  
+            Finally  
+                reader.Close()  
+            End Try  
+        End If  
+  
+    Catch ex As Exception  
+        Debug.WriteLine("Cannot read options " + ex.ToString())  
+    End Try  
+End Sub  
+  
+' Writes the button options to the isolated storage.  
+Public Sub Write()   
+    Dim isoStore As System.IO.IsolatedStorage.IsolatedStorageFile = _  
+        System.IO.IsolatedStorage.IsolatedStorageFile. _   
+        GetUserStoreForDomain()  
+  
+    Dim filename As String = "options.txt"  
+    Try   
+        ' Checks if the file exists, and if it does, tries to delete it.  
+        If (isoStore.GetFileNames(filename).GetLength(0) <> 0) Then  
+            isoStore.DeleteFile(filename)  
+        End If  
+    Catch ex As Exception  
+        Debug.WriteLine("Cannot delete file " + ex.ToString())  
+    End Try  
+  
+    ' Creates the options.txt file and writes the button options to it.  
+    Dim writer as System.IO.StreamWriter  
+    Try   
+        Dim isos As New System.IO.IsolatedStorage.IsolatedStorageFileStream _   
+             (filename, IO.FileMode.CreateNew, isoStore)  
+  
+        writer = New System.IO.StreamWriter(isos)  
+        Dim converter As System.ComponentModel.TypeConverter  
+  
+        converter = System.ComponentModel.TypeDescriptor.GetConverter _   
+           (GetType(Color))  
+        writer.WriteLine(converter.ConvertToString( _  
+            Me.MainButton.BackColor))  
+        writer.WriteLine(converter.ConvertToString( _  
+            Me.MainButton.ForeColor))  
+  
+        converter = System.ComponentModel TypeDescriptor.GetConverter _   
+           (GetType(Font))  
+        writer.WriteLine(converter.ConvertToString( _  
+            Me.MainButton.Font))  
+  
+    Catch ex as Exception  
+        Debug.WriteLine("Cannot write options " + ex.ToString())  
+  
+    Finally  
+        writer.Close()  
+    End Try  
+End Sub  
+  
+```  
+  
+```csharp  
+// Reads the button options from the isolated storage. Uses default values   
+// for the button if the options file does not exist.  
+public void Read()   
+{  
+    System.IO.IsolatedStorage.IsolatedStorageFile isoStore =   
+        System.IO.IsolatedStorage.IsolatedStorageFile.  
+        GetUserStoreForDomain();  
+  
+    string filename = "options.txt";  
+    try  
+    {  
+        // Checks to see if the options.txt file exists.  
+        if (isoStore.GetFileNames(filename).GetLength(0) != 0)   
+        {  
+            // Opens the file because it exists.  
+            System.IO.IsolatedStorage.IsolatedStorageFileStream isos =   
+                new System.IO.IsolatedStorage.IsolatedStorageFileStream  
+                    (filename, System.IO.FileMode.Open,isoStore);  
+            System.IO.StreamReader reader = null;  
+            try   
+            {  
+                reader = new System.IO.StreamReader(isos);  
+  
+                // Reads the values stored.  
+                TypeConverter converter ;  
+                converter = TypeDescriptor.GetConverter(typeof(Color));  
+  
+                this.MainButton.BackColor =   
+                 (Color)(converter.ConvertFromString(reader.ReadLine()));  
+                this.MainButton.ForeColor =   
+                 (Color)(converter.ConvertFromString(reader.ReadLine()));  
+  
+                converter = TypeDescriptor.GetConverter(typeof(Font));  
+                this.MainButton.Font =   
+                  (Font)(converter.ConvertFromString(reader.ReadLine()));  
+            }  
+            catch (Exception ex)  
+            {   
+                System.Diagnostics.Debug.WriteLine  
+                     ("Cannot read options " + ex.ToString());  
+            }  
+            finally  
+            {  
+                reader.Close();  
+            }  
+        }  
+    }   
+    catch (Exception ex)   
+    {  
+        System.Diagnostics.Debug.WriteLine  
+            ("Cannot read options " + ex.ToString());  
+    }  
+}  
+  
+// Writes the button options to the isolated storage.  
+public void Write()   
+{  
+    System.IO.IsolatedStorage.IsolatedStorageFile isoStore =   
+        System.IO.IsolatedStorage.IsolatedStorageFile.  
+        GetUserStoreForDomain();  
+  
+    string filename = "options.txt";  
+    try   
+    {  
+        // Checks if the file exists and, if it does, tries to delete it.  
+        if (isoStore.GetFileNames(filename).GetLength(0) != 0)   
+        {  
+            isoStore.DeleteFile(filename);  
+        }  
+    }  
+    catch (Exception ex)   
+    {  
+        System.Diagnostics.Debug.WriteLine  
+            ("Cannot delete file " + ex.ToString());  
+    }  
+  
+    // Creates the options file and writes the button options to it.  
+    System.IO.StreamWriter writer = null;  
+    try   
+    {  
+        System.IO.IsolatedStorage.IsolatedStorageFileStream isos = new   
+            System.IO.IsolatedStorage.IsolatedStorageFileStream(filename,   
+            System.IO.FileMode.CreateNew,isoStore);  
+  
+        writer = new System.IO.StreamWriter(isos);  
+        TypeConverter converter ;  
+  
+        converter = TypeDescriptor.GetConverter(typeof(Color));  
+        writer.WriteLine(converter.ConvertToString(  
+            this.MainButton.BackColor));  
+        writer.WriteLine(converter.ConvertToString(  
+            this.MainButton.ForeColor));  
+  
+        converter = TypeDescriptor.GetConverter(typeof(Font));  
+        writer.WriteLine(converter.ConvertToString(  
+            this.MainButton.Font));  
+  
+    }  
+    catch (Exception ex)  
+    {   
+        System.Diagnostics.Debug.WriteLine  
+           ("Cannot write options " + ex.ToString());  
+    }  
+    finally  
+    {  
+        writer.Close();  
+    }  
+}  
+```  
+  
+## データベースへのアクセス  
+ データベースにアクセスするために必要なアクセス許可は、データベース プロバイダーに応じて異なります。ただし、適切なアクセス許可で実行されているアプリケーションのみがデータ接続を使用してデータベースにアクセスできます。  データベースへのアクセスに必要なアクセス許可の詳細については、「[コード アクセス セキュリティと ADO.NET](../../../docs/framework/data/adonet/code-access-security.md)」を参照してください。  
+  
+ アプリケーションを部分信頼で実行するためにデータベースに直接アクセスできない場合は、データにアクセスする別の方法として Web サービスを使用することができます。  Web サービスは、ネットワーク経由でプログラムでアクセスできるソフトウェアです。  Web サービスを使用すると、アプリケーションはコード グループのゾーンにまたがるデータを共有できます。  既定では、ローカル イントラネット ゾーンとインターネット ゾーンのアプリケーションに、元のサイトへのアクセス権が付与され、同じサーバーにホストされる Web サービスを呼び出すことができます。  詳細については、「[ASP.NET AJAX の Web サービス](http://msdn.microsoft.com/ja-jp/8290e543-7eff-47a4-aace-681f3c07229b)」または「[Windows Communication Foundation](http://msdn.microsoft.com/library/ms735119.aspx)」を参照してください。  
+  
+## レジストリへのアクセス  
+ <xref:System.Security.Permissions.RegistryPermission> クラスは、オペレーティング システムのレジストリへのアクセスを制御します。  既定では、ローカルで実行されているアプリケーションのみが、レジストリにアクセスできます。  <xref:System.Security.Permissions.RegistryPermission> はレジストリにアクセスしようとする権利のみをアプリケーションに付与します。オペレーティング システムは、引き続きレジストリのセキュリティを強制するため、アクセスが成功するかどうかは保証されません。  
+  
+ 部分信頼の下のレジストリにアクセスすることはできないため、データを格納するその他のメソッドを検索する必要がある場合があります。  アプリケーション設定を保存する場合、レジストリの代わりに分離ストレージを使用します。  また、分離ストレージを使用して、その他のアプリケーション固有のファイルを格納することもできます。  既定では、アプリケーションの発生元のサイトへのアクセスがアプリケーションに付与されているため、サーバーまたは元のサイトに関するグローバルなアプリケーションの情報を格納することもできます。  
+  
+## 参照  
+ [Windows フォームでのより安全な印刷](../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)   
+ [Windows フォームのセキュリティに関するその他の考慮事項](../../../docs/framework/winforms/additional-security-considerations-in-windows-forms.md)   
+ [Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)   
+ [Windows フォームのセキュリティ](../../../docs/framework/winforms/windows-forms-security.md)   
+ [Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)   
+ [MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/more-secure-printing-in-windows-forms.md b/docs/framework/winforms/more-secure-printing-in-windows-forms.md
new file mode 100644
index 00000000000..c725d2e46b3
--- /dev/null
+++ b/docs/framework/winforms/more-secure-printing-in-windows-forms.md
@@ -0,0 +1,42 @@
+---
+title: "Windows フォームでのより安全な印刷 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "印刷 [Windows フォーム], セキュリティ"
+  - "PrintingPermission クラス, Windows フォームのセキュリティ"
+  - "セキュリティ [Windows フォーム], 印刷"
+  - "Windows フォーム, 印刷"
+ms.assetid: 48fd36ac-872f-4de0-902a-e52969cd4367
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Windows フォームでのより安全な印刷
+多くの Windows フォーム アプリケーションは、印刷機能を備えています。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、<xref:System.Drawing.Printing.PrintingPermission> クラスを使用して印刷機能へのアクセスを制御し、これに関連付けられている <xref:System.Drawing.Printing.PrintingPermissionLevel> 列挙値を使用してアクセスのレベルを示します。  \[イントラネット\] ゾーンと \[インターネット\] ゾーンでは、既定で印刷が有効になっています。ただし、アクセスのレベルはどちらのゾーンも制限されています。  アプリケーションが印刷を実行できるか、ユーザーとの対話が必要か、または印刷を実行できないかは、アプリケーションに与えられているアクセス許可の値によって異なります。  既定では、\[イントラネット\] ゾーンでは <xref:System.Drawing.Printing.PrintingPermissionLevel> アクセスが許可され、\[インターネット\] ゾーンでは <xref:System.Drawing.Printing.PrintingPermissionLevel> アクセスが許可されます。  
+  
+ 各印刷アクセス許可レベルで使用できる機能を次の表に示します。  
+  
+|PrintingPermissionLevel|Description|  
+|-----------------------------|-----------------|  
+|<xref:System.Drawing.Printing.PrintingPermissionLevel>|インストールされているすべてのプリンターに対して完全なアクセス権限が与えられます。|  
+|<xref:System.Drawing.Printing.PrintingPermissionLevel>|既定のプリンターへのプログラムによる印刷、および制限付きの印刷ダイアログ ボックスを使用した安全な印刷を有効にします。  <xref:System.Drawing.Printing.PrintingPermissionLevel> は <xref:System.Drawing.Printing.PrintingPermissionLevel> のサブセットです。|  
+|<xref:System.Drawing.Printing.PrintingPermissionLevel>|より制限されたダイアログ ボックスからの印刷だけが許可されます。  <xref:System.Drawing.Printing.PrintingPermissionLevel> は <xref:System.Drawing.Printing.PrintingPermissionLevel> のサブセットです。|  
+|<xref:System.Drawing.Printing.PrintingPermissionLevel>|プリンターへのアクセスを防止します。  <xref:System.Drawing.Printing.PrintingPermissionLevel> は <xref:System.Drawing.Printing.PrintingPermissionLevel> のサブセットです。|  
+  
+## 参照  
+ [Windows フォームにおけるファイルおよびデータへのより安全なアクセス](../../../docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md)   
+ [Windows フォームのセキュリティに関するその他の考慮事項](../../../docs/framework/winforms/additional-security-considerations-in-windows-forms.md)   
+ [Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)   
+ [Windows フォームのセキュリティ](../../../docs/framework/winforms/windows-forms-security.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/mouse-capture-in-windows-forms.md b/docs/framework/winforms/mouse-capture-in-windows-forms.md
new file mode 100644
index 00000000000..851da7d2496
--- /dev/null
+++ b/docs/framework/winforms/mouse-capture-in-windows-forms.md
@@ -0,0 +1,34 @@
+---
+title: "Windows フォームにおけるマウスのキャプチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "マウス, キャプチャ"
+ms.assetid: 8911d4b0-a4f8-4f93-8246-371aebd27d0c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Windows フォームにおけるマウスのキャプチャ
+*マウスのキャプチャ*とは、コントロールがすべてのマウス入力のコマンドを受け取ることを意味します。  コントロールがマウスをキャプチャしている場合は、マウス ポインターが境界内にあるかどうかにかかわらず、マウス入力を受け取ります。  
+  
+## マウスのキャプチャの設定  
+ Windows フォーム内では、マウスは、ユーザーがコントロール上でマウス ボタンを押した時にコントロールによってキャプチャされ、ユーザーがマウス ボタンを離したときにコントロールによって解放されます。  
+  
+ <xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.Capture%2A> プロパティは、コントロールがマウスをキャプチャしているかどうかを指定します。  コントロールがマウスのキャプチャをいつ失ったかを判断するには、<xref:System.Windows.Forms.Control.MouseCaptureChanged> イベントを処理します。  
+  
+ 手前のウィンドウだけがマウスをキャプチャできます。  背面のウィンドウがマウスをキャプチャしようとすると、ウィンドウは、マウス ポインターがウィンドウの表示部分内にあるときに発生したマウス イベントのメッセージだけを受け取ります。  また、前面のウィンドウがマウスをキャプチャした場合でも、ユーザーは別のウィンドウをクリックすると、そのウィンドウを前面に表示できます。  マウスがキャプチャされると、ショートカット キーは動作しません。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/mouse-events-in-windows-forms.md b/docs/framework/winforms/mouse-events-in-windows-forms.md
new file mode 100644
index 00000000000..1563ba1e06d
--- /dev/null
+++ b/docs/framework/winforms/mouse-events-in-windows-forms.md
@@ -0,0 +1,154 @@
+---
+title: "Windows フォームにおけるマウス イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Click イベント, 発生順序"
+  - "イベント [Windows フォーム], マウス"
+  - "マウス, イベント"
+  - "MouseClick イベント"
+  - "MouseDoubleClick イベント"
+  - "MouseDown イベント"
+  - "MouseEnter イベント"
+  - "MouseHover イベント"
+  - "MouseLeave イベント"
+  - "MouseMove イベント"
+  - "MouseUp イベント"
+  - "Windows フォーム コントロール, クリック イベント"
+ms.assetid: 8cf0070d-793b-4876-b09e-d20d28280fab
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォームにおけるマウス イベント
+マウス入力を処理する場合、通常はマウスのポインターの位置とマウス ボタンの状態を確認しようとします。  このトピックでは、マウスのイベントからこの情報を取得する方法について詳しく説明し、Windows フォーム コントロールでマウス クリック イベントが発生する順序について説明します。  すべてのマウス イベントのリストと説明は、「[Windows フォームにおけるマウス入力のしくみ](../../../docs/framework/winforms/how-mouse-input-works-in-windows-forms.md)」を参照してください。  「[イベント ハンドラーの概要 \(Windows フォーム\)](http://msdn.microsoft.com/library/be6fx1bb\(v=vs.110\))」、「[イベントの概要 \(Windows フォーム\)](http://msdn.microsoft.com/library/1h12f09z\(v=vs.110\))」も参照してください。  
+  
+## マウスの情報  
+ <xref:System.Windows.Forms.MouseEventArgs> は、マウス ボタンのクリック、およびマウスの動きの追跡に関連するマウス イベントのハンドラーに送信します。  <xref:System.Windows.Forms.MouseEventArgs> は、マウスのボタンが押された、およびマウスのホイールがスクロールされたといった、クライアント座標のマウス ポインターの場所を含む、マウスの現在の状態に関する情報を提供します。  マウス ポインターがコントロールの境界内に入った、または境界から出たときの通知など、いくつかのマウスイベントは、それ以上の情報はなしで <xref:System.EventArgs> をイベント ハンドラーに送信します。  
+  
+ マウス ボタン、または、マウス ポインターの位置の現在の状態を確認して、マウス イベントの処理を回避する場合は、<xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.MouseButtons%2A> プロパティと <xref:System.Windows.Forms.Control.MousePosition%2A> プロパティも使用できます。  <xref:System.Windows.Forms.Control.MouseButtons%2A> は現在押されているマウス ボタンに関する情報を返します。  <xref:System.Windows.Forms.Control.MousePosition%2A> はマウス ポインターの画面の座標を返しますが、<xref:System.Windows.Forms.Cursor.Position%2A> によって返される値と同じです。  
+  
+## 画面の座標とクライアント座標の間の変換  
+ マウスの位置情報は、クライアント座標の場合と画面の座標の場合があるため、ポインターの座標システムの変換が必要になることがあります。  これは、<xref:System.Windows.Forms.Control> クラスで利用できる <xref:System.Windows.Forms.Control.PointToClient%2A> メソッドと <xref:System.Windows.Forms.Control.PointToScreen%2A> メソッドを使用して簡単に実行できます。  
+  
+## 標準のクリック イベントの動作  
+ マウスのクリック イベントを適切な順序で処理する場合は、Windows フォーム コントロールでクリック イベントが発生した順序を知る必要があります。  Windows フォームのコントロールは、すべて、\(どちらのマウス ボタンかは関係なく\) マウス ボタンを押したときと離したときに同じ順序でクリック イベントを発生させますが、各コントロールについて、次のリストに記載する例外があります。  マウス ボタンのシングル クリックに対して発生したイベントの順序を次に示します。  
+  
+1.  <xref:System.Windows.Forms.Control.MouseDown> イベント。  
+  
+2.  <xref:System.Windows.Forms.Control.Click> イベント。  
+  
+3.  <xref:System.Windows.Forms.Control.MouseClick> イベント。  
+  
+4.  <xref:System.Windows.Forms.Control.MouseUp> イベント。  
+  
+ マウス ボタンのダブル クリックに対して発生したイベントの順序を次に示します。  
+  
+1.  <xref:System.Windows.Forms.Control.MouseDown> イベント。  
+  
+2.  <xref:System.Windows.Forms.Control.Click> イベント。  
+  
+3.  <xref:System.Windows.Forms.Control.MouseClick> イベント。  
+  
+4.  <xref:System.Windows.Forms.Control.MouseUp> イベント。  
+  
+5.  <xref:System.Windows.Forms.Control.MouseDown> イベント。  
+  
+6.  <xref:System.Windows.Forms.Control.DoubleClick> イベント。  \(これは、問題のコントロールで <xref:System.Windows.Forms.ControlStyles> スタイルのビットが `true` に設定されているかどうかに応じて異なる可能性があります。  <xref:System.Windows.Forms.ControlStyles> のビットの設定方法の詳細については、<xref:System.Windows.Forms.Control.SetStyle%2A> メソッドを参照してください。\)  
+  
+7.  <xref:System.Windows.Forms.Control.MouseDoubleClick> イベント。  
+  
+8.  <xref:System.Windows.Forms.Control.MouseUp> イベント。  
+  
+ マウス クリック イベントの順序を示すコード例については、「[方法 : Windows フォーム コントロールでユーザー入力イベントを処理する](../../../docs/framework/winforms/how-to-handle-user-input-events-in-windows-forms-controls.md)」を参照してください。  
+  
+### 個別のコントロール  
+ 次のコントロールは、標準のマウス クリック イベントの動作に準拠していません。  
+  
+-   <xref:System.Windows.Forms.Button>、<xref:System.Windows.Forms.CheckBox>、<xref:System.Windows.Forms.ComboBox>、および <xref:System.Windows.Forms.RadioButton> の各コントロール  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Forms.ComboBox> コントロールについて、ユーザーが編集フィールド、ボタン、またはリスト内の項目をクリックすると、後述するイベントの動作が発生します。  
+  
+    -   左クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   右クリック : クリック イベントは発生しません  
+  
+    -   左ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   右ダブルクリック : クリック イベントは発生しません  
+  
+-   <xref:System.Windows.Forms.TextBox>、<xref:System.Windows.Forms.RichTextBox>、<xref:System.Windows.Forms.ListBox>、<xref:System.Windows.Forms.MaskedTextBox> および <xref:System.Windows.Forms.CheckedListBox> の各コントロール  
+  
+    > [!NOTE]
+    >  ユーザーがこれらのコントロール内で任意の場所をクリックすると、後述するイベントの動作が発生します。  
+  
+    -   左クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   右クリック : クリック イベントは発生しません  
+  
+    -   左ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.DoubleClick>、<xref:System.Windows.Forms.Control.MouseDoubleClick>  
+  
+    -   右ダブルクリック : クリック イベントは発生しません  
+  
+-   <xref:System.Windows.Forms.ListView> コントロール  
+  
+    > [!NOTE]
+    >  ユーザーが <xref:System.Windows.Forms.ListView> コントロールの項目をクリックした場合のみ、後述するイベントの動作が発生します。  コントロールのその他の場所をクリックした場合、イベントは発生しません。  後述するイベントに加えて、<xref:System.Windows.Forms.ListView.BeforeLabelEdit> と <xref:System.Windows.Forms.ListView.AfterLabelEdit> のイベントがあり、<xref:System.Windows.Forms.ListView> コントロールによる検証を使用する場合のためにまとめておきます。  
+  
+    -   左クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   右クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   左ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.DoubleClick>、<xref:System.Windows.Forms.Control.MouseDoubleClick>  
+  
+    -   右ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.DoubleClick>、<xref:System.Windows.Forms.Control.MouseDoubleClick>  
+  
+-   <xref:System.Windows.Forms.TreeView> コントロール  
+  
+    > [!NOTE]
+    >  ユーザーが項目自体をクリックするか、<xref:System.Windows.Forms.TreeView> コントロールの項目の右側をクリックした場合にのみ、後述するイベントの動作が発生します。  コントロールのその他の場所をクリックした場合、イベントは発生しません。  後述するイベントに加えて、<xref:System.Windows.Forms.TreeView.BeforeCheck>、<xref:System.Windows.Forms.TreeView.BeforeSelect>、<xref:System.Windows.Forms.TreeView.BeforeLabelEdit>、<xref:System.Windows.Forms.TreeView.AfterSelect>、<xref:System.Windows.Forms.TreeView.AfterCheck>、および <xref:System.Windows.Forms.TreeView.AfterLabelEdit> の各イベントがあり、<xref:System.Windows.Forms.TreeView> コントロールを持つ検証を使用する場合のためにまとめておきます。  
+  
+    -   左クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   右クリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>  
+  
+    -   左ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.DoubleClick>、<xref:System.Windows.Forms.Control.MouseDoubleClick>  
+  
+    -   右ダブルクリック : <xref:System.Windows.Forms.Control.Click>、<xref:System.Windows.Forms.Control.MouseClick>、<xref:System.Windows.Forms.Control.DoubleClick>、<xref:System.Windows.Forms.Control.MouseDoubleClick>  
+  
+### 切り替えコントロールの描画の動作  
+ <xref:System.Windows.Forms.ButtonBase> クラスから派生するコントロールなど、切り替えコントロールには、次のようなマウス クリック イベントと組み合わせた独自の描画の動作があります。  
+  
+1.  ユーザーがマウス ボタンを押します。  
+  
+2.  押された状態で、コントロールが描画します。  
+  
+3.  <xref:System.Windows.Forms.Control.MouseDown> イベントが発生します。  
+  
+4.  ユーザーがマウス ボタンを離します。  
+  
+5.  離した状態でコントロールが描画します。  
+  
+6.  <xref:System.Windows.Forms.Control.Click> イベントが発生します。  
+  
+7.  <xref:System.Windows.Forms.Control.MouseClick> イベントが発生します。  
+  
+8.  <xref:System.Windows.Forms.Control.MouseUp> イベントが発生します。  
+  
+    > [!NOTE]
+    >  マウス ボタンが押されているときにユーザーがポインターを切り替えコントロールの外に移動した \(例 : <xref:System.Windows.Forms.Button> コントロールを押しているときにマウスを移動した\) 場合、離された状態で切り替えコントロールが描画し、<xref:System.Windows.Forms.Control.MouseUp> イベントのみが発生します。  <xref:System.Windows.Forms.Control.Click> イベントまたは <xref:System.Windows.Forms.Control.MouseClick> イベントは、このような状況では発生しません。  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/mouse-input-in-a-windows-forms-application.md b/docs/framework/winforms/mouse-input-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..1a8f3d48fd1
--- /dev/null
+++ b/docs/framework/winforms/mouse-input-in-a-windows-forms-application.md
@@ -0,0 +1,47 @@
+---
+title: "Windows フォーム アプリケーションにおけるマウス入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, マウス入力"
+ms.assetid: 743c2f3c-219e-4a52-b6b8-2657096a2da6
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows フォーム アプリケーションにおけるマウス入力
+Windows フォームは、さまざまなマウス イベントを備えており、カスタマイズされたマウス カーソル、マウスのキャプチャ、およびドラッグ アンド ドロップ動作もサポートします。  
+  
+## このセクションの内容  
+ [Windows フォームにおけるマウス入力のしくみ](../../../docs/framework/winforms/how-mouse-input-works-in-windows-forms.md)  
+ マウス イベントについて説明し、マウスの現在の情報とシステム設定を取得する方法について説明します。  
+  
+ [Windows フォームにおけるマウス イベント](../../../docs/framework/winforms/mouse-events-in-windows-forms.md)  
+ マウス イベントが発生する順序と、特定のコントロール内でマウス イベントが発生する方法について説明します。  
+  
+ [方法 : クリックとダブルクリックを識別する](../../../docs/framework/winforms/how-to-distinguish-between-clicks-and-double-clicks.md)  
+ シングルクリックとダブルクリックを使って互換性のない動作を開始する方法を示します。  
+  
+ [Windows フォームにおけるマウス ポインター](../../../docs/framework/winforms/mouse-pointers-in-windows-forms.md)  
+ マウス カーソルを変更する方法について説明します。  
+  
+ [Windows フォームにおけるマウスのキャプチャ](../../../docs/framework/winforms/mouse-capture-in-windows-forms.md)  
+ コントロールがマウスをキャプチャする方法について説明します。  
+  
+ [Windows フォームにおけるドラッグ アンド ドロップ機能](../../../docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md)  
+ ドラッグ アンド ドロップ動作を実装する方法について説明します。  
+  
+## 関連項目  
+ [Accessing the Mouse](../Topic/Accessing%20the%20Mouse%20\(Visual%20Basic\).md)  
+ Visual Basic を使用したマウスへのアクセスについて説明するトピックの一覧を示します。
\ No newline at end of file
diff --git a/docs/framework/winforms/mouse-pointers-in-windows-forms.md b/docs/framework/winforms/mouse-pointers-in-windows-forms.md
new file mode 100644
index 00000000000..740ec67268b
--- /dev/null
+++ b/docs/framework/winforms/mouse-pointers-in-windows-forms.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォームにおけるマウス ポインター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "カーソル, 設定 [Windows フォーム]"
+  - "マウス カーソル"
+  - "マウス ポインター"
+  - "マウス ポインター, 設定 [Windows フォーム]"
+  - "マウス, カーソル"
+  - "ポインター, 設定 [Windows フォーム]"
+ms.assetid: c3400d85-de5b-42e8-abc3-d6088d69ee53
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Windows フォームにおけるマウス ポインター
+カーソルとも呼ばれるマウス *ポインター*は、マウスでユーザー入力できるように画面上のフォーカス ポイントを指定するビットマップです。  ここでは、Windows フォームにおけるマウス ポインターについて概説し、マウス ポインターを変更および制御する方法をいくつか示します。  
+  
+## マウス ポインターへのアクセス  
+ マウス ポインターは <xref:System.Windows.Forms.Cursor> クラスで表され、各 <xref:System.Windows.Forms.Control> にはそのコントロールのポインターを指定する <xref:System.Windows.Forms.Control.Cursor%2A?displayProperty=fullName> プロパティがあります。  <xref:System.Windows.Forms.Cursor> クラスには、ポインターを記述するプロパティ \(<xref:System.Windows.Forms.Cursor.Position%2A> プロパティや <xref:System.Windows.Forms.Cursor.HotSpot%2A> プロパティなど\) およびポインターの外観を変更できるメソッド \(<xref:System.Windows.Forms.Cursor.Show%2A> メソッド、<xref:System.Windows.Forms.Cursor.Hide%2A> メソッド、および <xref:System.Windows.Forms.Cursor.DrawStretched%2A> メソッドなど\) が含まれます。  
+  
+## マウス ポインターの制御  
+ マウス ポインターの使用領域の制限やマウスの位置の変更が必要になることがあります。  <xref:System.Windows.Forms.Cursor> の <xref:System.Windows.Forms.Cursor.Position%2A> プロパティを使用すると、マウスの現在位置を取得または設定できます。  また、<xref:System.Windows.Forms.Cursor.Clip%2A> プロパティを設定することにより、マウス ポインターの使用領域を制限することもできます。  既定では、クリップ領域は画面全体です。  
+  
+## マウス ポインターの変更  
+ マウス ポインターの変更は、ユーザーにフィードバックを提供するための重要な手段です。  たとえば、<xref:System.Windows.Forms.Control.MouseEnter> イベントおよび <xref:System.Windows.Forms.Control.MouseLeave> イベントのハンドラー内でマウス ポインターを変更することにより、計算を実行中であることをユーザーに通知し、コントロールでのユーザー操作を制限できます。  アプリケーションに対してドラッグ アンド ドロップ操作が行われた場合など、システム イベントによってマウス ポインターが変更されることもあります。  
+  
+ マウス ポインターを変更するための主な方法は、コントロールの <xref:System.Windows.Forms.Control.Cursor%2A?displayProperty=fullName> プロパティまたは <xref:System.Windows.Forms.Control.DefaultCursor%2A> プロパティを新しい <xref:System.Windows.Forms.Cursor> に設定することです。  マウス ポインターの変更例については、<xref:System.Windows.Forms.Cursor> クラスのコード例を参照してください。  また、<xref:System.Windows.Forms.Cursors> クラスでは、手の形をしたポインターなど、さまざまな種類のポインターを表す <xref:System.Windows.Forms.Cursor> オブジェクトのセットが公開されています。  マウス ポインターがコントロール上にあるときに砂時計の形をした待機ポインターを表示するには、<xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.UseWaitCursor%2A> プロパティを使用します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Cursor>   
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)   
+ [Windows フォームにおけるドラッグ アンド ドロップ機能](../../../docs/framework/winforms/drag-and-drop-functionality-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md b/docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md
new file mode 100644
index 00000000000..45fbef2da87
--- /dev/null
+++ b/docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "コントロール [Windows フォーム], バインド (複数を)"
+  - "コントロール [Windows フォーム], 同期 (データ ソースとの)"
+ms.assetid: c2f0ecc6-11e6-4c2c-a1ca-0759630c451e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ
+Windows フォームでデータ バインディングを操作するときには、複数のコントロールを 1 つのデータ ソースにバインドすることがよくあります。  場合によっては、コントロールのバインド プロパティを他のコントロールやデータ ソースと同期した状態を保つために、追加の手順が必要になります。  追加の手順が必要となるケースとして、次の 2 つが挙げられます。  
+  
+-   データ ソースが <xref:System.ComponentModel.IBindingList> を実装していないため、<xref:System.ComponentModel.ListChangedType> 型の <xref:System.ComponentModel.IBindingList.ListChanged> イベントを生成する場合。  
+  
+-   データ ソースが <xref:System.ComponentModel.IEditableObject> を実装している場合。  
+  
+ 前者の場合、<xref:System.Windows.Forms.BindingSource> を使用してコントロールにデータ ソースをバインドできます。  後者の場合、<xref:System.Windows.Forms.BindingSource> を使用して <xref:System.Windows.Forms.BindingSource.BindingComplete> イベントを処理し、バインドされた <xref:System.Windows.Forms.BindingManagerBase> で <xref:System.Windows.Forms.BindingManagerBase.EndCurrentEdit%2A> を呼び出します。  
+  
+## 使用例  
+ 次のコード例は、3 つのコントロール \(2 つのテキスト ボックスと 1 つの <xref:System.Windows.Forms.DataGridView> コントロール\) について、<xref:System.Windows.Forms.BindingSource> コンポーネントを使用して <xref:System.Data.DataSet> の同じ列にバインドする方法を示します。  この例は、<xref:System.Windows.Forms.BindingSource.BindingComplete> イベントを処理して、1 つのテキスト ボックスのテキスト値が変更されると、その他のテキスト ボックスと <xref:System.Windows.Forms.DataGridView> コントロールを適切な値で更新する方法を示しています。  
+  
+ この例では、<xref:System.Windows.Forms.BindingSource> を使用してデータ ソースとコントロールをバインドします。  または、コントロールをデータ ソースに直接バインドし、フォームの <xref:System.Windows.Forms.Control.BindingContext%2A> からバインディングの <xref:System.Windows.Forms.BindingManagerBase> を取得した後、<xref:System.Windows.Forms.BindingManagerBase> の <xref:System.Windows.Forms.BindingManagerBase.BindingComplete> イベントを処理することもできます。  この処理方法の例については、<xref:System.Windows.Forms.BindingManagerBase> の <xref:System.Windows.Forms.BindingManagerBase.BindingComplete> イベントに関するヘルプ ページを参照してください。  
+  
+ [!code-csharp[System.Windows.Forms.BindingSourceMultipleControls#1](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.BindingSourceMultipleControls/CS/Form1.cs#1)]
+ [!code-vb[System.Windows.Forms.BindingSourceMultipleControls#1](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.BindingSourceMultipleControls/VB/Form1.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   このコード例で必要な要件は次のとおりです。  
+  
+-   <xref:System> アセンブリ、<xref:System.Windows.Forms> アセンブリ、および <xref:System.Drawing> アセンブリへの参照。  
+  
+-   <xref:System.Windows.Forms.Form.Load> イベントを処理するフォーム。このフォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラーから、コード例の `InitializeControlsAndDataSource` メソッドを呼び出す必要があります。  
+  
+## 参照  
+ [方法 : BindingSource コンポーネントを使用してフォーム間でバインド データを共有する](../../../docs/framework/winforms/controls/how-to-share-bound-data-across-forms-using-the-bindingsource-component.md)   
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)   
+ [データ連結に関連するインターフェイス](../../../docs/framework/winforms/interfaces-related-to-data-binding.md)   
+ [Windows フォームでのデータ バインド](../../../docs/framework/winforms/windows-forms-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/order-of-events-in-windows-forms.md b/docs/framework/winforms/order-of-events-in-windows-forms.md
new file mode 100644
index 00000000000..b5d6657da80
--- /dev/null
+++ b/docs/framework/winforms/order-of-events-in-windows-forms.md
@@ -0,0 +1,93 @@
+---
+title: "Windows フォームのイベントの順序 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アプリケーション終了イベントの順序"
+  - "アプリケーション起動イベントの順序"
+  - "イベント [Windows フォーム], 順序"
+  - "フォーカス イベントの順序"
+  - "手順, イベントの"
+  - "検証イベント, 順序"
+ms.assetid: e81db09b-4453-437f-b78a-62d7cd5c9829
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォームのイベントの順序
+Windows フォーム アプリケーションでイベントが発生する順序は、各イベントを順番に処理する必要がある開発者にとって重要な問題です。  フォームの構成要素を再描画するときなど、イベント処理に細心の注意が必要な状況では、実行時におけるイベントの正確な発生順序に気を配る必要があります。  このトピックでは、アプリケーションとコントロールの有効期間におけるいくつかの重要な段階での、イベントの順序について詳しく説明します。  マウス入力イベントの順序の詳細については、「[Windows フォームにおけるマウス イベント](../../../docs/framework/winforms/mouse-events-in-windows-forms.md)」を参照してください。  Windows フォームのイベントの概要については、「[イベントの概要](../../../docs/framework/winforms/events-overview-windows-forms.md)」を参照してください。  イベント ハンドラーの構成の詳細については、「[イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)」を参照してください。  
+  
+## アプリケーションのスタートアップ イベントとシャットダウン イベント。  
+ <xref:System.Windows.Forms.Form> クラスおよび <xref:System.Windows.Forms.Control> クラスは、アプリケーションのスタートアップおよびシャットダウンに関連する一連のイベントを公開しています。  Windows フォーム アプリケーションが起動すると、メイン フォームのスタートアップ イベントが次の順序で発生します。  
+  
+-   <xref:System.Windows.Forms.Control.HandleCreated?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Control.BindingContextChanged?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.Load?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Control.VisibleChanged?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.Activated?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.Shown?displayProperty=fullName>  
+  
+ アプリケーションを閉じると、メイン フォームのシャットダウン イベントが次の順序で発生します。  
+  
+-   <xref:System.Windows.Forms.Form.Closing?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.FormClosing?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.Closed?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.FormClosed?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Forms.Form.Deactivate?displayProperty=fullName>  
+  
+ <xref:System.Windows.Forms.Application> クラスの <xref:System.Windows.Forms.Application.ApplicationExit> イベントは、メイン フォームのシャットダウン イベントの後に発生します。  
+  
+> [!NOTE]
+>  Visual Basic 2005 には、追加のアプリケーション イベント \(<xref:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.Startup?displayProperty=fullName> や <xref:Microsoft.VisualBasic.ApplicationServices.WindowsFormsApplicationBase.Shutdown?displayProperty=fullName> など\) があります。  
+  
+## フォーカス イベントと検証イベント  
+ キーボード \(Tab、Shift \+ Tab など\) を使用するか、<xref:System.Windows.Forms.Control.Select%2A> メソッドまたは <xref:System.Windows.Forms.Control.SelectNextControl%2A> メソッドを呼び出すか、<xref:System.Windows.Forms.ContainerControl.ActiveControl%2A> プロパティを現在のフォームに設定してフォーカスを変更すると、次の順序で <xref:System.Windows.Forms.Control> クラスのフォーカス イベントが発生します。  
+  
+-   <xref:System.Windows.Forms.Control.Enter>  
+  
+-   <xref:System.Windows.Forms.Control.GotFocus>  
+  
+-   <xref:System.Windows.Forms.Control.Leave>  
+  
+-   <xref:System.Windows.Forms.Control.Validating>  
+  
+-   <xref:System.Windows.Forms.Control.Validated>  
+  
+-   <xref:System.Windows.Forms.Control.LostFocus>  
+  
+ マウスの使用、または <xref:System.Windows.Forms.Control.Focus%2A> メソッドの呼び出しによってフォーカスを変更すると、次の順序で <xref:System.Windows.Forms.Control> クラスのフォーカス イベントが発生します。  
+  
+-   <xref:System.Windows.Forms.Control.Enter>  
+  
+-   <xref:System.Windows.Forms.Control.GotFocus>  
+  
+-   <xref:System.Windows.Forms.Control.LostFocus>  
+  
+-   <xref:System.Windows.Forms.Control.Leave>  
+  
+-   <xref:System.Windows.Forms.Control.Validating>  
+  
+-   <xref:System.Windows.Forms.Control.Validated>  
+  
+## 参照  
+ [Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/security-in-windows-forms-overview.md b/docs/framework/winforms/security-in-windows-forms-overview.md
new file mode 100644
index 00000000000..d05c9aab464
--- /dev/null
+++ b/docs/framework/winforms/security-in-windows-forms-overview.md
@@ -0,0 +1,98 @@
+---
+title: "Windows フォームのセキュリティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス制御, Windows フォーム"
+  - "コード アクセス セキュリティ, Windows フォーム"
+  - "アクセス許可, Windows フォーム"
+  - "セキュリティ [Windows フォーム], セキュリティの概要"
+  - "Windows フォーム, セキュリティ"
+ms.assetid: 4810dc9f-ea23-4ce1-8ea1-657f0ff1d820
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォームのセキュリティの概要
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のリリース以前、ユーザーのコンピューターで実行されているすべてのコードは、リソースにアクセスするために、そのコンピューターのユーザーが持っていたのと同じ権限またはアクセス許可を持っていました。  たとえば、ユーザーにファイル システムへのアクセスが許可されている場合は、コードにファイル システムへのアクセスが許可され、ユーザーにデータベースへのアクセスが許可されている場合は、コードにデータベースへのアクセスが許可されていました。  これらの権限やアクセス許可は、ユーザーがローカル コンピューターに明示的にインストールした実行可能ファイルのコードに対しては受け入れることができますが、インターネットやローカル イントラネットからの悪意のある可能性があるコードに対しては受け入れることができません。  このコードは、アクセス許可がないユーザーのコンピューター リソースにアクセスすべきではありません。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、アクセス許可または権限について、コードが持つものとユーザーが持つものを区別できる、コード アクセス セキュリティと呼ばれるインフラストラクチャを導入しています。  既定では、インターネットとイントラネットからのコードは、部分信頼と呼ばれるものでのみ実行できます。  部分信頼では、アプリケーションに一連の制限が適用されます。特に、アプリケーションはローカルのハード ディスクへのアクセスが制限され、アンマネージ コードを実行することができません。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、送信元、[厳密な名前付きアセンブリ](../../../docs/framework/app-domains/strong-named-assemblies.md)を持っているかどうか、証明書で署名されているかどうかなど、そのコードの身元に基づいて、コードのアクセスが許可されるリソースを制御します。  
+  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] テクノロジは、Windows フォーム アプリケーションの配置に使用しますが、部分信頼で実行するアプリケーションを、完全信頼や、昇格されたアクセス許可を持つ部分信頼で簡単に開発できるようにします。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] は、アクセス許可の昇格や、信頼されたアプリケーション配置などの機能を提供し、アプリケーションが完全信頼やアクセス許可の昇格をローカル ユーザーから実行可能な方法で要求できます。  
+  
+## .NET Framework のセキュリティについて  
+ コード アクセス セキュリティにより、コードの発生元や、そのコードの身元を示すその他の基準に基づいて、コードをさまざまなレベルで信頼できます。  共通言語ランタイムがセキュリティ ポリシーを決定するために使用する証拠の詳細については、「[証拠](http://msdn.microsoft.com/ja-jp/64ceb7c8-a0b4-46c4-97dc-6c22da0539da)」を参照してください。  悪意のあるコードからコンピューター システムを保護できるだけでなく、セキュリティの意図的または偶然の侵害から信頼されているコードを保護できます。  また、コード アクセス セキュリティは、アプリケーションが実行できるアクションに対して詳細に制御できます。これは、アプリケーションが持っている必要があるアクセス許可のみを指定できるためです。  コード アクセス セキュリティは、コードが単一のコード アクセス セキュリティのアクセス許可のチェックをしない場合でも、共通言語ランタイムを対象とするすべてのマネージ コードに影響を与えます。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のセキュリティの詳細については、「[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)」と「[コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)」を参照してください。  
+  
+ ユーザーが Windows フォームの実行可能ファイルを Web サーバーまたはファイル共有から直接実行する場合、アプリケーションに付与される信頼の度合いは、コードが存在する場所や開始方法によって異なります。  アプリケーションを実行すると、自動的に評価され、共通言語ランタイムから、名前付き権限セットを受け取ります。  既定では、ローカル コンピューターからのコードに完全信頼のアクセス許可セットが付与され、ローカル ネットワークからのコードには、ローカル イントラネットのアクセス許可セットが付与され、インターネットからのコードには、インターネットのアクセス許可セットが付与されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] バージョン 1.0 Service Pack 1 と Service Pack 2 では、インターネット ゾーンのコード グループが何もしないアクセス許可セットを受け取ります。  その他のすべてのリリースの [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、インターネット ゾーンのコード グループは、インターネットのアクセス許可セットを受け取ります。  
+>   
+>  これらのアクセス許可セットのそれぞれに付与されている既定のアクセス許可の一覧は、「[既定のセキュリティ ポリシー](http://msdn.microsoft.com/ja-jp/2c086873-0894-4f4d-8f7e-47427c1a3b55)」のトピックにあります。  アプリケーションが受け取るアクセス許可に応じて、正常に実行されるか、またはセキュリティ例外が生成されます。  
+>   
+>  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] を使用して、多数の Windows フォーム アプリケーションが配置されます。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の配置を生成するために使用されるツールは、これまでの説明とは異なる既定のセキュリティを持っています。  詳細については、次の説明を参照してください。  
+  
+ アプリケーションに付与される実際のアクセス許可は、セキュリティ ポリシーが変更される可能性があるため、既定値とは異なる可能性があります。つまり、アプリケーションが、あるコンピューターではアクセス許可を持ち、別のコンピューターでは持たない可能性があることを意味します。  
+  
+## より安全な Windows フォーム アプリケーションの開発  
+ セキュリティは、アプリケーション開発のすべての手順で重要です。  まず「[安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)」を確認して従います。  
+  
+ 次に、アプリケーションを完全信頼で実行する必要があるのか、または部分信頼で実行する必要があるのかを決定します。  完全信頼でアプリケーションを実行することで、ローカル コンピューター上のリソースへのアクセスが簡単になりますが、「安全なコーディングのガイドライン」のトピックに厳密に従ってアプリケーションを設計および開発しない場合、ユーザーとアプリケーションを高いセキュリティ リスクに晒すことになります。  部分信頼でアプリケーションを実行すると、より安全なアプリケーションをより簡単に開発でき、リスクを大幅に軽減しますが、特定の機能の実装方法について、より詳細な計画が必要になります。  
+  
+ 部分信頼 \(つまり、インターネットまたはローカル イントラネットのアクセス許可セットのいずれか\) を選択する場合は、アプリケーションがこの環境で動作する方法を決定します。  Windows フォームでは、信頼度の低い環境で、より安全に機能を実装する代わりの方法を提供します。  データ アクセスなど、アプリケーションの特定の部分が、部分信頼および完全信頼の両方の環境で異なる設計と作成がなされる場合があります。  アプリケーション設定など、一部の Windows フォームの機能は、部分信頼で動作するよう設計されています。  詳細については、「[アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)」を参照してください。  
+  
+ アプリケーションが部分信頼で許可するより多くのアクセス許可を必要とするが、完全信頼モードで実行したくない場合は、部分信頼で実行しながら、必要な追加のアクセス許可のみをアサートすることができます。  たとえば、部分信頼で実行するが、ユーザーのファイル システム上のディレクトリに、アプリケーションの読み取り専用のアクセス許可を付与する必要がある場合、そのディレクトリのみに対して <xref:System.Security.Permissions.FileIOPermission> を要求することができます。  適切に使用すると、このアプローチによってアプリケーションの機能が増加し、ユーザーのセキュリティ上のリスクを最小限に抑えることができます。  
+  
+ 部分信頼で実行されるアプリケーションを開発するときに、アプリケーションが実行する必要があるアクセス許可と、アプリケーションがオプションで使用できるアクセス許可を管理してください。  すべてのアクセス許可がわかっている場合、アプリケーション レベルでアクセス許可について宣言型の要求をする必要があります。  アクセス許可を要求すると、アプリケーションが必要とするアクセス許可、および特に必要ないアクセス許可について、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のランタイムに通知します。  アクセス許可の要求の詳細については、「[アクセス許可の要求](http://msdn.microsoft.com/ja-jp/0447c49d-8cba-45e4-862c-ff0b59bebdc2)」を参照してください。  
+  
+ オプションのアクセス許可を要求するときに、アプリケーションに付与されていないアクセス許可が必要なアクションを実行する場合に生成されるセキュリティ例外を処理する必要があります。  <xref:System.Security.SecurityException> を適切に処理することで、アプリケーションを続行できます。  アプリケーションは例外を使用して、ユーザーに対して機能を無効にする必要があるかどうかを判断できます。  たとえば、必要なファイルのアクセス許可が付与されていない場合、アプリケーションが **\[保存\]** メニュー オプションを無効にすることができます。  
+  
+ 場合によっては、すべての適切なアクセス許可をアサートしたかどうかを確認することが難しい場合があります。  たとえば、表面的には影響のないように見えるメソッドの呼び出しが、実行中のある時点でファイル システムにアクセスすることがあります。  必要なアクセス許可をすべて使用してアプリケーションを配置しない場合は、デスクトップでデバッグしている間は問題なくテストでき、配置のときに失敗する可能性があります。  [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] SDK と [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] の両方に、それぞれ MT.exe のコマンド ライン ツールと、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のアクセス許可の検出機能という、アプリケーションに必要なアクセス許可を検出するためのツールが含まれています。  
+  
+ 次のトピックでは、Windows フォームの追加のセキュリティ機能について説明します。  
+  
+|トピック|説明|  
+|----------|--------|  
+|-   [Windows フォームにおけるファイルおよびデータへのより安全なアクセス](../../../docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md)|部分信頼環境でファイルとデータにアクセスする方法について説明します。|  
+|-   [Windows フォームでのより安全な印刷](../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)|部分信頼環境で印刷機能にアクセスする方法について説明します。|  
+|-   [Windows フォームのセキュリティに関するその他の考慮事項](../../../docs/framework/winforms/additional-security-considerations-in-windows-forms.md)|部分信頼環境でのウィンドウ操作の実行、クリップボードの使用、およびアンマネージ コードへの呼び出しについて説明します。|  
+  
+### 適切なアクセス許可を持つアプリケーションの配置  
+ クライアント コンピューターに Windows フォーム アプリケーションを配置する最も一般的な方法は、アプリケーションが実行する必要があるすべてのコンポーネントを記述する配置テクノロジの [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] を使用することです。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] は、マニフェストと呼ばれる XML ファイルを使用して、アプリケーションを構成するアセンブリとファイル、およびアプリケーションに必要なアクセス許可を記述します。  
+  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] は、クライアント コンピューターでアクセス許可の昇格を要求するための 2 つのテクノロジを持っています。  どちらのテクノロジも、Authenticode 証明書の使用に依存します。  証明書は、アプリケーションが信頼できる発行元からのものであることをユーザーにある程度保証するのに役立ちます。  
+  
+ 次の表では、それらのテクノロジについて説明します。  
+  
+|昇格されたアクセス許可のテクノロジ|説明|  
+|-----------------------|--------|  
+|アクセス許可の昇格|アプリケーションを最初に実行するときにセキュリティ ダイアログ ボックスをユーザーに表示します。  **\[アクセス許可の昇格\]** ダイアログ ボックスは、アプリケーションをだれが公開したのかについてユーザーに通知するので、ユーザーが追加の信頼を付与するかどうかについて、十分な情報を検討したうえで決定できます。|  
+|信頼されたアプリケーションの配置|システム管理者がクライアント コンピューターで、発行元の Authenticode 証明書のインストールを 1 回実行する必要があります。  その時点から、その証明書で署名されたアプリケーションは信頼済みとみなされ、追加メッセージを表示せずに、ローカル コンピューター上で完全信頼で実行できます。|  
+  
+ どのテクノロジを選択するかは、配置環境に応じて異なります。  詳細については、「[ClickOnce 配置ストラテジの選択](../Topic/Choosing%20a%20ClickOnce%20Deployment%20Strategy.md)」を参照してください。  
+  
+ 既定では、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] または [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] SDK ツール \(Mage.exe および MageUI.exe\) のいずれかを使用して配置された [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションは、完全信頼を持つクライアント コンピューターで実行するよう構成されます。  部分信頼を使用して、またはいくつか追加のアクセス許可のみを使用して、アプリケーションを配置している場合、この既定を変更する必要があります。  配置を構成するときに、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] または [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] SDK ツールの MageUI.exe のいずれかを使用して構成できます。  MageUI.exe を使用する方法の詳細については、「チュートリアル : コマンドラインから ClickOnce アプリケーションを配置する」を参照してください。  「[方法 : ClickOnce アプリケーションのカスタム アクセス許可を設定する](http://msdn.microsoft.com/library/hafybdaa\(v=vs.110\))」または「[方法 : ClickOnce アプリケーションのカスタム アクセス許可を設定する](http://msdn.microsoft.com/library/hafybdaa\(v=vs.120\))」も参照してください。  
+  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] とアクセス許可の昇格のセキュリティ面の詳細については、「[ClickOnce アプリケーションのセキュリティ](../Topic/Securing%20ClickOnce%20Applications.md)」を参照してください。  信頼されたアプリケーションの配置の詳細については、「[信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)」を参照してください。  
+  
+### アプリケーションのテスト  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用して Windows フォーム アプリケーションを配置した場合は、開発環境から、部分信頼または制限されたアクセス許可セットでのデバッグを有効にできます。  「[方法 : アクセス許可が制限された ClickOnce アプリケーションをデバッグする](http://msdn.microsoft.com/library/593zkfdf\(v=vs.110\))」または「[方法 : アクセス許可が制限された ClickOnce アプリケーションをデバッグする](http://msdn.microsoft.com/library/593zkfdf\(v=vs.120\))」も参照してください。  
+  
+## 参照  
+ [Windows フォームのセキュリティ](../../../docs/framework/winforms/windows-forms-security.md)   
+ [コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)   
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)   
+ [信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)   
+ [Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)   
+ [MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/user-input-in-a-windows-forms-application.md b/docs/framework/winforms/user-input-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..e14e2371988
--- /dev/null
+++ b/docs/framework/winforms/user-input-in-a-windows-forms-application.md
@@ -0,0 +1,45 @@
+---
+title: "Windows フォーム アプリケーションにおけるユーザー入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows フォーム, ユーザー入力"
+ms.assetid: 9d61fa96-70f7-4754-885a-49a4a6316bdb
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Windows フォーム アプリケーションにおけるユーザー入力
+Windows フォームでのユーザー入力は、Windows メッセージの形式でアプリケーションに送られます。  これらのメッセージは、オーバーライドできる一連のメソッドにより、アプリケーション、フォーム、コントロールの各レベルで処理されます。  これらのメソッドがマウス メッセージやキーボード メッセージを受け取るとイベントが発生し、このイベントを処理することで、マウス入力やキーボード入力に関する情報を取得できます。  多くの場合、Windows フォーム アプリケーションは、これらのイベントを処理するだけですべてのユーザー入力を処理できますが、  アプリケーションによっては、アプリケーション、フォーム、またはコントロールよりも前に特定のメッセージを受け取ることができるように、メッセージを処理するメソッドのいずれかをオーバーライドする必要がある場合もあります。  
+  
+## マウス イベントとキーボード イベント  
+ すべての Windows フォーム コントロールは、マウス入力とキーボード入力に関連するイベント セットを継承します。  たとえば、コントロールは、<xref:System.Windows.Forms.Control.KeyPress> イベントを処理して、押されたキーの文字コードを判別したり、<xref:System.Windows.Forms.Control.MouseClick> イベントを処理して、マウス クリックの位置を特定したりできます。  マウス イベントとキーボード イベントの詳細については、「[キーボード イベントの使用](../../../docs/framework/winforms/using-keyboard-events.md)」および「[Windows フォームにおけるマウス イベント](../../../docs/framework/winforms/mouse-events-in-windows-forms.md)」を参照してください。  
+  
+## ユーザー入力メッセージを処理するメソッド  
+ フォームとコントロールは、<xref:System.Windows.Forms.IMessageFilter> インターフェイスと、メッセージ キュー内のさまざまな位置で Windows メッセージを処理する、オーバーライドできる一連のメソッドにアクセスできます。  これらのメソッドはすべて、Windows メッセージの下位の詳細情報をカプセル化する <xref:System.Windows.Forms.Message> パラメーターを使用します。  これらのメソッドを実装またはオーバーライドしてメッセージを調べてから、メッセージを使用したり、メッセージ キュー内の次のコンシューマーにメッセージを渡したりできます。  Windows フォームですべての Windows メッセージを処理するメソッドを次の表に示します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Windows.Forms.IMessageFilter.PreFilterMessage%2A>|キューに追加された \(またはポストされた\) Windows メッセージをアプリケーション レベルで受け取ります。|  
+|<xref:System.Windows.Forms.Control.PreProcessMessage%2A>|Windows メッセージが処理される前に、フォーム レベルまたはコントロール レベルでメッセージを受け取ります。|  
+|<xref:System.Windows.Forms.Control.WndProc%2A>|Windows メッセージをフォーム レベルまたはコントロール レベルで処理します。|  
+|<xref:System.Windows.Forms.Control.DefWndProc%2A>|Windows メッセージの既定の処理をフォーム レベルまたはコントロール レベルで実行します。  ウィンドウの最小限の機能を提供します。|  
+|<xref:System.Windows.Forms.Control.OnNotifyMessage%2A>|メッセージが処理された後に、フォーム レベルまたはコントロール レベルでメッセージを受け取ります。  このメソッドが呼び出されるようにするには、<xref:System.Windows.Forms.ControlStyles> スタイル ビットを設定する必要があります。|  
+  
+ キーボード メッセージとマウス メッセージは、これらのメッセージの種類に固有の、オーバーライドできる追加のメソッドによっても処理されます。  詳細については、「[キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)」および「[Windows フォームにおけるマウス入力のしくみ](../../../docs/framework/winforms/how-mouse-input-works-in-windows-forms.md)」を参照してください。  
+  
+## 参照  
+ [Windows フォームでのユーザー入力](../../../docs/framework/winforms/user-input-in-windows-forms.md)   
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)   
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/user-input-in-windows-forms.md b/docs/framework/winforms/user-input-in-windows-forms.md
new file mode 100644
index 00000000000..d4ac9e4ee6c
--- /dev/null
+++ b/docs/framework/winforms/user-input-in-windows-forms.md
@@ -0,0 +1,49 @@
+---
+title: "Windows フォームでのユーザー入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "キーボード入力, 使用 (Windows フォームで)"
+  - "キーボード, キーボード入力"
+  - "マウス入力, 使用 (Windows フォームで)"
+  - "Windows フォーム, ユーザー入力"
+ms.assetid: 1486075f-1e06-4c9e-82c6-f948331db6d6
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Windows フォームでのユーザー入力
+Windows フォームには、関連する Windows メッセージの処理中に発生するイベントに基づくユーザーの入力モデルが含まれています。  特定のタスクを実行する方法を示すコード例を含む、マウスとキーボードのユーザー入力については、このセクションのトピックで説明します。  
+  
+## このセクションの内容  
+ [Windows フォーム アプリケーションにおけるユーザー入力](../../../docs/framework/winforms/user-input-in-a-windows-forms-application.md)  
+ ユーザーの入力イベント、および Windows メッセージを処理するメソッドの概要を示します。  
+  
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)  
+ キーボードのメッセージ処理、様々な種類のキー、およびキーボード イベントについて説明します。  
+  
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)  
+ マウスのカーソルとマウスのキャプチャなど、マウス イベントやその他のマウスに関連する機能の情報を提供します。  
+  
+ [方法 : マウス イベントとキーボード イベントをコードでシミュレートする](../../../docs/framework/winforms/how-to-simulate-mouse-and-keyboard-events-in-code.md)  
+ プログラムでマウスおよびキーボード入力をシミュレートするいくつかの方法を示します。  
+  
+ [方法 : Windows フォーム コントロールでユーザー入力イベントを処理する](../../../docs/framework/winforms/how-to-handle-user-input-events-in-windows-forms-controls.md)  
+ ほとんどのユーザーの入力イベントを処理し、各イベントに関する情報をレポートするコード例を表示します。  
+  
+ [Windows フォームでのユーザー入力の検証](../../../docs/framework/winforms/user-input-validation-in-windows-forms.md)  
+ Windows フォーム アプリケーションでユーザー入力を検証する方法について説明します。  
+  
+## 関連項目  
+ 「[Windows フォーム内でのイベント ハンドラーの作成](http://msdn.microsoft.com/library/dacysss4\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/user-input-validation-in-windows-forms.md b/docs/framework/winforms/user-input-validation-in-windows-forms.md
new file mode 100644
index 00000000000..26254ca12c0
--- /dev/null
+++ b/docs/framework/winforms/user-input-validation-in-windows-forms.md
@@ -0,0 +1,107 @@
+---
+title: "Windows フォームでのユーザー入力の検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "ユーザー入力, 検証 (Windows フォームで)"
+  - "検証 (ユーザー入力の), Windows フォーム"
+  - "検証, Windows フォームのユーザー入力"
+  - "Windows フォーム, 検証 (ユーザー入力の)"
+ms.assetid: 4ec07681-1dee-4bf9-be5e-718f635a33a1
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Windows フォームでのユーザー入力の検証
+ユーザーがアプリケーションにデータを入力する場合、アプリケーションがそのデータを使用する前に、データが有効であるかどうかの検証が必要になることがあります。  たとえば、テキスト フィールドの長さがゼロでないこと、フィールドの形式が電話番号や他の形式のデータとして適していること、または、文字列に、データベースのセキュリティに危険を与える可能性がある安全でない文字が含まれていないことを確認したりします。  Windows フォームは、アプリケーションでの入力を検証するさまざまな方法を提供します。  
+  
+## MaskedTextBox コントロールによる検証  
+ 電話番号や部品番号のように特定の形式でユーザーがデータを入力する必要がある場合は、<xref:System.Windows.Forms.MaskedTextBox> コントロールを使用することで、これを簡単に、かつ最小限のコードで実現できます。  *マスク*は、テキスト ボックス内の所定の位置に入力できる文字を指定する、マスキング言語の文字から成る文字列です。  コントロールは、ユーザーに対して一連のプロンプトを表示します。  数字が要求される場所に文字を入力しようとするなど、ユーザーが正しくないエントリを入力すると、コントロールは自動的に入力を拒否します。  
+  
+ <xref:System.Windows.Forms.MaskedTextBox> で使用されるマスク言語は非常に柔軟性があり、  必須文字、オプション文字、ハイフンやかっこなどのリテラル文字、通貨記号、および日付の区切り記号を指定できます。  コントロールは、データ ソースとバインドしている場合にも適切に動作します。  データ バインディングに対して <xref:System.Windows.Forms.Binding.Format> イベントを使用すると、受信データをマスクに合わせて再設定できます。<xref:System.Windows.Forms.Binding.Parse> イベントを使用すると、データ フィールドの指定に合わせて送信データを再設定できます。  
+  
+ 詳細については、「[MaskedTextBox コントロール](../../../docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md)」を参照してください。  
+  
+## イベント ドリブン検証  
+ プログラムで検証を完全に制御する場合、または、複雑な検証チェックを実行する必要がある場合は、大部分の Windows フォーム コントロールに組み込まれている検証イベントを使用します。  自由形式のユーザー入力を受け取る各コントロールは <xref:System.Windows.Forms.Control.Validating> イベントを備えており、、コントロールがデータ検証を要求するとこのイベントが発生します。  <xref:System.Windows.Forms.Control.Validating> イベント処理メソッドを使用すると、ユーザーの入力をさまざまな方法で検証できます。  たとえば、郵便番号を入力するテキスト ボックスがある場合、次のような方法で検証を実行できます。  
+  
+-   そこに特定のグループに属する郵便番号を入力する必要がある場合、入力値に対して文字列比較を実行し、ユーザーの入力データを検証できます。  たとえば、{10001, 10002, 10003} という集合に含まれる郵便番号を入力する必要がある場合、文字列比較を使用してデータを検証できます。  
+  
+-   特定の形式で郵便番号を入力する必要がある場合は、正規表現を使用してユーザーの入力データを検証できます。  たとえば、`#####` または `#####-####` という形式を検証する場合、正規表現 `^(\d{5})(-\d{4})?$` を使用できます。  `A#A #A#` という形式を検証するには、正規表現 `[A-Z]\d[A-Z] \d[A-Z]\d` を使用できます。  正規表現の詳細については、「[.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)」および「[正規表現の例](../../../docs/standard/base-types/regular-expression-examples.md)」を参照してください。  
+  
+-   有効なアメリカ合衆国郵便番号を入力する必要がある場合、郵便番号の Web サービスを呼び出して、ユーザーの入力データを検証することもできます。  
+  
+ <xref:System.Windows.Forms.Control.Validating> イベントには、<xref:System.ComponentModel.CancelEventArgs> 型のオブジェクトを提供します。  コントロールのデータが有効でないと判断した場合は、このオブジェクトの <xref:System.ComponentModel.CancelEventArgs.Cancel%2A> プロパティを `true` に設定することによって、<xref:System.Windows.Forms.Control.Validating> イベントをキャンセルできます。  <xref:System.ComponentModel.CancelEventArgs.Cancel%2A> プロパティが設定されない場合は、そのコントロールの検証が正常終了したものと見なされ、<xref:System.Windows.Forms.Control.Validated> イベントが発生します。  
+  
+ <xref:System.Windows.Controls.TextBox> で電子メール アドレスを検証するコード例については、<xref:System.Windows.Forms.Control.Validating> のトピックを参照してください。  
+  
+### データ バインディングおよびイベント ドリブン検証  
+ コントロールがデータベース テーブルなどのデータ ソースにバインドされている場合、検証は非常に効果的です。  検証を使用すると、コントロールのデータがデータ ソースに適した形式であることや、安全でない可能性がある引用符やバック スラッシュなどの特殊文字を含まないことを確認できます。  
+  
+ データ バインディングを使用すると、コントロール内のデータは、<xref:System.Windows.Forms.Control.Validating> イベントの実行中、データ ソースと同期します。  <xref:System.Windows.Forms.Control.Validating> イベントをキャンセルすると、データはデータ ソースと同期しません。  
+  
+> [!IMPORTANT]
+>  <xref:System.Windows.Forms.Control.Validating> イベントの後に実行するカスタム検証の場合は、データ バインディングに影響しません。  たとえば、<xref:System.Windows.Forms.Control.Validated> イベント内にデータ バインディングをキャンセルするコードがある場合でも、データ バインディングは発生します。  この場合、<xref:System.Windows.Forms.Control.Validated> イベント内で検証を実行するには、コントロールの **\[データ ソース更新モード\]** プロパティ \(**\[\(Databindings\)\]**\\**\[\(詳細\)\]** の下\) を **\[OnValidation\]** から **\[Never\]** に変更し、検証コードに *Control*`.DataBindings["`*\<YOURFIELD\>*`"].WriteValue()` を追加します。  
+  
+### 暗黙の検証と明示的な検証  
+ では、コントロールのデータはいつ検証を受けるのでしょうか。  その答えは、開発者しだいです。  アプリケーションの必要性に応じて、暗黙の検証と明示的な検証のいずれかを使用できます。  
+  
+#### 暗黙の検証  
+ 暗黙の検証は、ユーザーがデータを入力するたびに検証する方法です。  キーの押下を読み取って、コントロールに入力されるデータを検証することもできますが、さらに一般的な方法としては、ユーザーがあるコントロールから次へ入力フォーカスを移動したときにデータを検証できます。  この方法は、入力中のデータについて、ユーザーに対して直ちにフィードバックを返す場合に有効です。  
+  
+ あるコントロールに対する暗黙の検証を使用する場合、そのコントロールの <xref:System.Windows.Forms.ContainerControl.AutoValidate%2A> プロパティを `true` に設定します。  <xref:System.Windows.Forms.Control.Validating> イベントをキャンセルした場合、コントロールの動作は <xref:System.Windows.Forms.ContainerControl.AutoValidate%2A> に割り当てた値によって決定されます。  <xref:System.Windows.Forms.AutoValidate> を割り当てた場合は、イベントをキャンセルしても、<xref:System.Windows.Forms.Control.Validated> イベントが発生しません。  ユーザーが有効なデータを入力するまで、入力フォーカスは現在のコントロールから移動しません。  <xref:System.Windows.Forms.AutoValidate> を割り当てた場合は、イベントをキャンセルしても <xref:System.Windows.Forms.Control.Validated> イベントは発生せず、フォーカスはそのまま次のコントロールに移ります。  
+  
+ <xref:System.Windows.Forms.ContainerControl.AutoValidate%2A> プロパティに <xref:System.Windows.Forms.AutoValidate> を割り当てると、暗黙の検証がまったく行われません。  コントロールを検証するには、明示的な検証を使用する必要があります。  
+  
+#### 明示的な検証  
+ 明示的な検証は、データを 1 回で検証する方法です。  あるユーザー アクションが発生したとき \(\[保存\] ボタンや \[次へ\] リンクをクリックするなど\) に、データを検証することができます。  そのユーザー アクションが発生したときに明示的な検証をトリガーするには、次のいずれかを実行します。  
+  
+-   <xref:System.Windows.Forms.ContainerControl.Validate%2A> を呼び出して、最後のコントロールがフォーカスを失ったことを確認します。  
+  
+-   <xref:System.Windows.Forms.ContainerControl.ValidateChildren%2A> を呼び出して、フォーム コントロールまたはコンテナー コントロールのすべての子コントロールを検証します。  
+  
+-   カスタム メソッドを呼び出して、コントロールのデータを手動で検証します。  
+  
+#### Windows フォーム コントロールにおける既定の暗黙の検証動作  
+ Windows フォーム コントロールの <xref:System.Windows.Forms.ContainerControl.AutoValidate%2A> プロパティの既定値は、種類によってそれぞれ異なります。  最も一般的なコントロールとその既定値を次の表に示します。  
+  
+|Control|既定の検証動作|  
+|-------------|-------------|  
+|<xref:System.Windows.Forms.ContainerControl>|<xref:System.Windows.Forms.AutoValidate>|  
+|<xref:System.Windows.Forms.Form>|<xref:System.Windows.Forms.AutoValidate>|  
+|<xref:System.Windows.Forms.PropertyGrid>|Visual Studio の中でプロパティは公開されない|  
+|<xref:System.Windows.Forms.ToolStripContainer>|Visual Studio の中でプロパティは公開されない|  
+|<xref:System.Windows.Forms.SplitContainer>|<xref:System.Windows.Forms.AutoValidate>|  
+|<xref:System.Windows.Forms.UserControl>|<xref:System.Windows.Forms.AutoValidate>|  
+  
+## フォームを閉じて検証をオーバーライドする  
+ データが無効なためにフォーカスがコントロールに維持される場合、次のような通常の方法でフォームを閉じようとしても、親フォームを閉じることができません。  
+  
+-   **\[閉じる\]** をクリックする。  
+  
+-   **\[システム\]** メニューの **\[閉じる\]** をクリックする。  
+  
+-   プログラムで <xref:System.Windows.Forms.Form.Close%2A> メソッドを呼び出す。  
+  
+ ただし、場合によっては、コントロール内の値が有効かどうかにかかわらず、ユーザーがフォームを閉じることができるようにする必要があります。  フォームの <xref:System.Windows.Forms.Form.Closing> イベントのハンドラーを作成することにより、検証をオーバーライドして、無効なデータを含んでいるフォームを閉じることができます。  このイベント内で、<xref:System.ComponentModel.CancelEventArgs.Cancel%2A> プロパティを `false` に設定します。  これにより、フォームが強制的に閉じられます。  詳細および使用例については、「<xref:System.Windows.Forms.Form.Closing?displayProperty=fullName>」を参照してください。  
+  
+> [!NOTE]
+>  フォームをこのように強制的に閉じると、そのフォームのコントロール内の保存されていないデータはすべて失われます。  また、モーダル フォームは、閉じられるときにコントロールの内容を検証しません。  コントロールの検証を使用してフォーカスをコントロールにロックすることはできますが、フォームを閉じるときの動作を考慮する必要はありません。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.Validating?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Form.Closing?displayProperty=fullName>   
+ <xref:System.ComponentModel.CancelEventArgs?displayProperty=fullName>   
+ [MaskedTextBox コントロール](../../../docs/framework/winforms/controls/maskedtextbox-control-windows-forms.md)   
+ [正規表現の例](../../../docs/standard/base-types/regular-expression-examples.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/using-keyboard-events.md b/docs/framework/winforms/using-keyboard-events.md
new file mode 100644
index 00000000000..b489f98d548
--- /dev/null
+++ b/docs/framework/winforms/using-keyboard-events.md
@@ -0,0 +1,53 @@
+---
+title: "キーボード イベントの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "イベント [Windows フォーム], キーボード"
+  - "キーボード イベント"
+  - "キーボード, キーボード イベント"
+  - "KeyDown イベント"
+  - "KeyPress イベント"
+  - "KeyUp イベント"
+ms.assetid: d3f3e14b-a459-4ee6-9875-8957e34f8ee9
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# キーボード イベントの使用
+多くの Windows フォーム プログラムは、キーボード イベントを処理することによってキーボード入力を処理します。  ここでは、どのような場合に各キーボード イベントを使用するか、また各イベントがどのようなデータを提供するかについての詳細を含め、キーボード イベントの概要について説明します。  「[イベント ハンドラーの概要 \(Windows フォーム\)](http://msdn.microsoft.com/library/be6fx1bb\(v=vs.110\))」、「[イベントの概要 \(Windows フォーム\)](http://msdn.microsoft.com/library/1h12f09z\(v=vs.110\))」も参照してください。  
+  
+## キーボード イベント  
+ Windows フォームは、ユーザーがキーボードのキーを押したときに発生する 2 つのイベントと、キーボードのキーを離したときに発生する 1 つのイベントを提供します。これらのイベントは次のとおりです。  
+  
+-   <xref:System.Windows.Forms.Control.KeyDown> イベント。キーを押したときに 1 回発生します。  
+  
+-   <xref:System.Windows.Forms.Control.KeyPress> イベント。ユーザーが同じキーを押したままにすると、繰り返し発生する可能性があります。  
+  
+-   <xref:System.Windows.Forms.Control.KeyUp> イベント。ユーザーがキーを離したときに 1 回発生します。  
+  
+ ユーザーがキーを押すと、Windows フォームは、キーボード メッセージが文字キーまたは物理キーのどちらを示しているかに基づいて、発生させるイベントを決定します。  文字キーと物理キーの詳細については、「[キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)」を参照してください。  
+  
+ 上の 3 つのキーボード イベントに関する説明を次の表に示します。  
+  
+|キーボード イベント|説明|結果|  
+|----------------|--------|--------|  
+|<xref:System.Windows.Forms.Control.KeyDown>|このイベントは、ユーザーが物理キーを押すと発生します。|<xref:System.Windows.Forms.Control.KeyDown> のハンドラーは、次の項目を受け取ります。<br /><br /> <ul><li><xref:System.Windows.Forms.KeyEventArgs> パラメーター。このパラメーターは、物理キーボード ボタンを示す <xref:System.Windows.Forms.KeyEventArgs.KeyCode%2A> プロパティを提供します。</li><li><xref:System.Windows.Forms.KeyEventArgs.Modifiers%2A> プロパティ \(Shift、Ctrl、または Alt キー\)。</li><li><xref:System.Windows.Forms.KeyEventArgs.KeyData%2A> プロパティ \(キー コードと修飾子を組み合わせます\)。  また、<xref:System.Windows.Forms.KeyEventArgs> パラメーターは、次のプロパティを提供します。<br /><br /> <ul><li><xref:System.Windows.Forms.KeyEventArgs.Handled%2A> プロパティ。基となるコントロールがキーを受け取らないように設定できます。</li><li><xref:System.Windows.Forms.KeyEventArgs.SuppressKeyPress%2A> プロパティ。これを使用すると、特定のキーストロークで <xref:System.Windows.Forms.Control.KeyPress> イベントと <xref:System.Windows.Forms.Control.KeyUp> イベントが発生しないようにすることができます。</li></ul></li></ul>|  
+|<xref:System.Windows.Forms.Control.KeyPress>|このイベントは、1 つまたは複数のキーを押すことにより文字が出力された場合に発生します。  たとえば、Shift キーを押しながら小文字の "a" キーを押すと、大文字の "A" が出力されます。|<xref:System.Windows.Forms.Control.KeyPress> は、<xref:System.Windows.Forms.Control.KeyDown> の後に発生します。<br /><br /> <ul><li><xref:System.Windows.Forms.Control.KeyPress> のハンドラーは、次の項目を受け取ります。</li><li><xref:System.Windows.Forms.KeyPressEventArgs> パラメーター。このパラメーターには、押したキーの文字コードが入ります。  この文字コードは、文字キーと修飾子キーの組み合わせごとに一意です。<br /><br />     たとえば、"A" キーは次の文字コードを生成します。<br /><br /> <ul><li>文字コード 65 \(Shift キーまたは Caps Lock キーと一緒に押した場合\)</li><li>97 \(単独で押した場合\)</li><li>1 \(Ctrl キーと一緒に押した場合\)</li></ul></li></ul>|  
+|<xref:System.Windows.Forms.Control.KeyUp>|このイベントは、ユーザーが物理キーを離すと発生します。|<xref:System.Windows.Forms.Control.KeyUp> のハンドラーは、次の項目を受け取ります。<br /><br /> <ul><li><xref:System.Windows.Forms.KeyEventArgs> パラメーターの値。次のプロパティを提供します。<br /><br /> <ul><li><xref:System.Windows.Forms.KeyEventArgs.KeyCode%2A> プロパティ \(物理キーボード ボタンを示します\)。</li><li><xref:System.Windows.Forms.KeyEventArgs.Modifiers%2A> プロパティ \(Shift、Ctrl、または Alt キー\)。</li><li><xref:System.Globalization.SortKey.KeyData%2A> プロパティ \(キー コードと修飾子を組み合わせます\)。</li></ul></li></ul>|  
+  
+## 参照  
+ [Windows フォーム アプリケーションにおけるキーボード入力](../../../docs/framework/winforms/keyboard-input-in-a-windows-forms-application.md)   
+ [キーボード入力のしくみ](../../../docs/framework/winforms/how-keyboard-input-works.md)   
+ [Windows フォーム アプリケーションにおけるマウス入力](../../../docs/framework/winforms/mouse-input-in-a-windows-forms-application.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/windows-forms-coordinates.md b/docs/framework/winforms/windows-forms-coordinates.md
new file mode 100644
index 00000000000..4b30304baea
--- /dev/null
+++ b/docs/framework/winforms/windows-forms-coordinates.md
@@ -0,0 +1,42 @@
+---
+title: "Windows フォームの座標 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "クライアント座標"
+  - "座標, Windows フォーム"
+  - "画面座標"
+  - "Windows フォームの座標"
+ms.assetid: cc06e61f-43b6-4408-a676-2542dcfcd96e
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# Windows フォームの座標
+Windows フォームの座標系はデバイス座標に基づいています。Windows フォームを描画するときの基本測定単位はデバイス単位 \(通常、ピクセル\) です。  画面上の点は x 座標と y 座標の組み合わせで表され、x 座標は右に行くほど大きくなり、y 座標は下に行くほど大きくなります。  画面上の原点の位置は、画面座標かクライアント座標のいずれを指定しているかによって異なります。  
+  
+## 画面座標  
+ Windows フォーム アプリケーションでは、画面上のウィンドウの位置を画面座標で指定します。  画面座標の場合、原点は画面の左上隅になります。  ウィンドウの完全な位置は、多くの場合、ウィンドウの左上隅と右下隅を定義する 2 点の画面座標を含む <xref:System.Drawing.Rectangle> 構造体によって表されます。  
+  
+## クライアント座標  
+ Windows フォーム アプリケーションでは、フォームやコントロール内の点の位置をクライアント座標で指定します。  クライアント座標の原点は、コントロールやフォームのクライアント領域の左上隅になります。  クライアント座標により、アプリケーションでフォームやコントロールを描画するときに、画面上の位置とは無関係に一貫した座標値を使用できます。  
+  
+ クライアント領域の寸法も、その領域のクライアント座標を含む <xref:System.Drawing.Rectangle> 構造体によって表されます。  常に四角形の左上の座標がクライアント領域に含まれ、右下の座標は除外されます。  グラフィックス操作には、クライアント領域の右辺と下辺が含まれません。  たとえば、<xref:System.Drawing.Graphics.FillRectangle%2A> メソッドは、指定した四角形の右辺と下辺まで塗りつぶしますが、これらの辺を含みません。  
+  
+## 座標の種類の変換  
+ 画面座標からクライアント座標への変換が必要になることがあります。  この変換は、<xref:System.Windows.Forms.Control> クラスの <xref:System.Windows.Forms.Control.PointToClient%2A> メソッドや <xref:System.Windows.Forms.Control.PointToScreen%2A> メソッドを使用して簡単に行うことができます。  たとえば、<xref:System.Windows.Forms.Control> の <xref:System.Windows.Forms.Control.MousePosition%2A> プロパティは画面座標で報告されますが、クライアント座標に変換することもできます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Control.PointToClient%2A>   
+ <xref:System.Windows.Forms.Control.PointToScreen%2A>
\ No newline at end of file
diff --git a/docs/framework/winforms/windows-forms-data-binding.md b/docs/framework/winforms/windows-forms-data-binding.md
new file mode 100644
index 00000000000..3cc7a0b13dc
--- /dev/null
+++ b/docs/framework/winforms/windows-forms-data-binding.md
@@ -0,0 +1,80 @@
+---
+title: "Windows フォームでのデータ バインド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "バインド コントロール, Windows フォーム"
+  - "データ [Windows フォーム]"
+  - "データ [Windows フォーム], アーキテクチャ"
+  - "Windows フォーム コントロール, データ バインディング"
+  - "Windows フォーム, データ バインディング"
+ms.assetid: c3826d8e-ea25-4ad4-a669-45bfb19192aa
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# Windows フォームでのデータ バインド
+Windows フォームでのデータ バインドは、データ ソースの情報をフォーム上のコントロールで表示したり変更したりする手段を提供します。  従来のデータ ソースに対してだけでなく、データを格納したほとんどすべての構造に対してバインドできます。  
+  
+## このセクションの内容  
+ [データ連結と Windows フォーム](../../../docs/framework/winforms/data-binding-and-windows-forms.md)  
+ Windows フォームのデータ バインドの概要を説明します。  
+  
+ [Windows フォームがサポートするデータ ソース](../../../docs/framework/winforms/data-sources-supported-by-windows-forms.md)  
+ Windows フォームで使用できるデータ ソースについて説明します。  
+  
+ [データ連結に関連するインターフェイス](../../../docs/framework/winforms/interfaces-related-to-data-binding.md)  
+ Windows フォームのデータ バインドで使用されるいくつかのインターフェイスについて説明します。  
+  
+ [方法 : Windows フォームでデータ間を移動する](../../../docs/framework/winforms/how-to-navigate-data-in-windows-forms.md)  
+ データ ソースの項目間を移動する方法を示します。  
+  
+ [Windows フォーム データ バインドの変更通知](../../../docs/framework/winforms/change-notification-in-windows-forms-data-binding.md)  
+ Windows フォーム データ バインドの異なる種類の変更通知について説明します。  
+  
+ [方法 : INotifyPropertyChanged インターフェイスを実装する](../../../docs/framework/winforms/how-to-implement-the-inotifypropertychanged-interface.md)  
+ <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する方法について説明します。  インターフェイスは、バインドしたコントロールを通してビジネス オブジェクトのプロパティの変更内容を通信します。  
+  
+ [方法 : PropertyNameChanged パターンを適用する](../../../docs/framework/winforms/how-to-apply-the-propertynamechanged-pattern.md)  
+ Windows フォームのユーザー コントロールのプロパティに *PropertyName*Changed パターンを適用する方法について説明します。  
+  
+ [方法 : ITypedList インターフェイスを実装する](../../../docs/framework/winforms/how-to-implement-the-itypedlist-interface.md)  
+ <xref:System.ComponentModel.ITypedList> インターフェイスを実装して、バインドできるリストのスキーマを検出できるようにする方法について説明します。  
+  
+ [方法 : IListSource インターフェイスを実装する](../../../docs/framework/winforms/how-to-implement-the-ilistsource-interface.md)  
+ <xref:System.ComponentModel.IListSource> インターフェイスを実装して、<xref:System.Collections.IList> を実装する代わりに別の場所からリストを提供する、バインドできるクラスを作成する方法について説明します。  
+  
+ [方法 : 複数のコントロールを 1 つのデータ ソースにバインドして同期状態を保つ](../../../docs/framework/winforms/multiple-controls-bound-to-data-source-synchronized.md)  
+ <xref:System.Windows.Forms.BindingSource.BindingComplete> イベントを処理して、データ ソースにバインドされているすべてのコントロールの同期を保つ方法について説明します。  
+  
+ [方法 : 子テーブルの選択行が現在位置を保持することを保証する](../../../docs/framework/winforms/ensure-the-selected-row-in-a-child-table-correct.md)  
+ 親テーブルのフィールドが変更された場合に、子テーブルの選択行が変更されないことを保証する方法について説明しています。  
+  
+ 「[データ バインディングに関連するインターフェイス](http://msdn.microsoft.com/library/41e17s4b\(v=vs.110\))」、「[方法 : Windows フォームでデータ間を移動する](http://msdn.microsoft.com/library/b63ha24w\(v=vs.110\))」、「[方法 : Windows フォームに単純バインド コントロールを作成する](http://msdn.microsoft.com/library/sw223a62\(v=vs.110\))」も参照してください。  
+  
+## 関連項目  
+ <xref:System.Windows.Forms.Binding?displayProperty=fullName>  
+ バインドできるコンポーネントとデータ ソースの間のバインディングを表すクラスについて説明します。  
+  
+ <xref:System.Windows.Forms.BindingSource?displayProperty=fullName>  
+ コントロールにバインドするためにデータ ソースをカプセル化するクラスについて説明します。  
+  
+## 関連項目  
+ [BindingSource コンポーネント](../../../docs/framework/winforms/controls/bindingsource-component.md)  
+ <xref:System.Windows.Forms.BindingSource> コンポーネントの使用方法の例を示すトピックの一覧を示します。  
+  
+ [DataGridView コントロール](../../../docs/framework/winforms/controls/datagridview-control-windows-forms.md)  
+ バインドできるデータ グリッド コントロールの使用方法の例を示すトピックの一覧を示します。  
+  
+ 「[Visual Studio でのデータへのアクセス](http://msdn.microsoft.com/library/wzabh8c4\(v=vs.110\))」または「[Visual Studio でのデータへのアクセス](http://msdn.microsoft.com/library/wzabh8c4\(v=vs.110\))」も参照してください。
\ No newline at end of file
diff --git a/docs/framework/winforms/windows-forms-overview.md b/docs/framework/winforms/windows-forms-overview.md
new file mode 100644
index 00000000000..0e7adb22ffd
--- /dev/null
+++ b/docs/framework/winforms/windows-forms-overview.md
@@ -0,0 +1,111 @@
+---
+title: "Windows フォームの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "スマート クライアント"
+  - "Windows フォーム, Windows フォームの概要"
+ms.assetid: 3a2b6284-c8d6-4e1c-8c69-0bed38f38cd4
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# Windows フォームの概要
+次の概要では、スマート クライアント アプリケーションの利点、Windows フォームのプログラミングの主な機能について説明し、Windows フォームを使用して今日の企業とエンドユーザーのニーズを満たすスマート クライアントを構築する方法を示します。  
+  
+## Windows フォームとスマート クライアント アプリケーション  
+ Windows フォームを使用して、スマート クライアントを開発します。  *スマート クライアント*は、展開と更新が容易で、インターネットに接続したときも切断しているときも動作し、従来の Windows ベースのアプリケーションよりも安全な方法でローカル コンピューター上のリソースにアクセスできる、リッチなグラフィックスのアプリケーションです。  
+  
+### リッチで対話型のユーザー インターフェイスの構築  
+ Windows フォームは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のためのスマート クライアント テクノロジであり、ファイル システムへの読み書きなど、アプリケーションの一般的なタスクを簡略化するマネージ ライブラリのセットです。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] などの開発環境を使用する場合、情報を表示して、ユーザーからの入力を要求し、ネットワーク経由でリモート コンピューターと通信する Windows フォームのスマート クライアント アプリケーションを作成できます。  
+  
+ Windows フォームでは、*フォーム*はユーザーに情報を表示するビジュアル サーフェイスです。  通常は、コントロールをフォームに追加して、マウスのクリックやキーの押下などのユーザー アクションへの応答を開発することで、Windows フォーム アプリケーションを開発します。  *コントロール* は、データを表示したりデータ入力を受け入れたりする独立したユーザー インターフェイス \(UI\) 要素です。  
+  
+ ユーザーがフォームまたはそのコントロールのいずれかにアクションを実行すると、そのアクションがイベントを生成します。  アプリケーションは、コードを使用してこれらのイベントに反応し、イベントが発生したときにそのイベントを処理します。  詳細については、「[Windows フォーム内でのイベント ハンドラーの作成](../../../docs/framework/winforms/creating-event-handlers-in-windows-forms.md)」を参照してください。  
+  
+ Windows フォームには、テキスト ボックス、ボタン、ドロップダウン ボックス、ラジオ ボタン、Web ページなどを表示するコントロールなど、フォームに追加できるさまざまなコントロールが含まれています。  フォーム上で使用できるすべてのコントロールの一覧は、「[Windows フォームで使用するコントロール](../../../docs/framework/winforms/controls/controls-to-use-on-windows-forms.md)」を参照してください。  既存のコントロールがニーズを満たしていない場合に、Windows フォームは <xref:System.Windows.Forms.UserControl> クラスを使用した独自のカスタム コントロールの作成もサポートしています。  
+  
+ Windows フォームには、Microsoft Office のようなハイエンド アプリケーションの機能をエミュレートする豊富な UI コントロールが用意されています。  <xref:System.Windows.Forms.ToolStrip> コントロールと <xref:System.Windows.Forms.MenuStrip> コントロールを使用する場合、テキストとイメージを含むツールバーとメニューを作成したり、サブメニューを表示したり、テキスト ボックスやコンボ ボックスなど、その他のコントロールをホストしたりできます。  
+  
+ Windows フォーム デザイナーで [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] をドラッグ アンド ドロップすると、Windows フォーム アプリケーションを簡単に作成できます。  コントロールをカーソルで選択して、フォームの任意の場所に追加するだけです。  デザイナーがグリッド線やスナップ線などのツールを提供するので、コントロールの調整が楽になります。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] を使用する場合も、コマンド ラインでコンパイルする場合も、<xref:System.Windows.Forms.FlowLayoutPanel>、<xref:System.Windows.Forms.TableLayoutPanel>、および <xref:System.Windows.Forms.SplitContainer> の各コントロールを使用して、短時間で高度なフォーム レイアウトを作成できます。  
+  
+ 最後に、独自のカスタム UI 要素を作成する必要がある場合は、<xref:System.Drawing> 名前空間に、線、円、およびその他の図形をフォーム上に直接表示するクラスが多数含まれています。  
+  
+> [!NOTE]
+>  Windows フォーム コントロールは、アプリケーション ドメイン間でマーシャリングするよう設計されていません。  このため、<xref:System.MarshalByRefObject> の <xref:System.Windows.Controls.Control> 基本型で可能であるように見えても、Microsoft は、<xref:System.AppDomain> 境界間の Windows フォーム コントロールの引き渡しはサポートしていません。  複数のアプリケーション ドメインを持つ Windows フォーム アプリケーションは、Windows フォーム コントロールがアプリケーション ドメインの境界を越えて渡されない限りサポートされます。  
+  
+#### フォームとコントロールの作成に関するヘルプ  
+ これらの機能を使用する方法の手順を追った説明については、次のヘルプ トピックを参照してください。  
+  
+|説明|ヘルプ トピック|  
+|--------|--------------|  
+|フォーム上のコントロールを使用する|[方法 : Windows フォームにコントロールを追加する](../../../docs/framework/winforms/controls/how-to-add-controls-to-windows-forms.md)|  
+|<xref:System.Windows.Forms.ToolStrip> コントロールを使用する|[方法 : デザイナーを使用して標準アイテムで基本的な ToolStrip を作成する](../../../docs/framework/winforms/controls/create-a-basic-wf-toolstrip-with-standard-items-using-the-designer.md)|  
+|<xref:System.Drawing> を使用してグラフィックスを作成する|[グラフィックス プログラミングについて](../../../docs/framework/winforms/advanced/getting-started-with-graphics-programming.md)|  
+|カスタム コントロールの作成|[方法 : UserControl クラスを継承する](../../../docs/framework/winforms/controls/how-to-inherit-from-the-usercontrol-class.md)|  
+  
+### データの表示と操作  
+ 多くのアプリケーションは、データベース、XML ファイル、XML Web サービス、またはその他のデータ ソースからデータを表示する必要があります。  Windows フォームは、従来の行と列の形式である、表形式のデータを表示するために、<xref:System.Windows.Forms.DataGridView> コントロールという名前の柔軟なコントロールを提供しているため、すべてのデータが独自のセルを占有します。  <xref:System.Windows.Forms.DataGridView> を使用すると、個別のセルの外観のカスタマイズ、任意の列と行のその場でのロック、セルの内部の複雑なコントロールの表示や、その他の機能が可能になります。  
+  
+ ネットワーク経由のデータ ソースへの接続は、Windows フォームのスマート クライアントを使用すればシンプルなタスクです。  <xref:System.Windows.Forms.BindingSource> コンポーネントは、[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] と [!INCLUDE[dnprdnlong](../../../includes/dnprdnlong-md.md)] の新しい Windows フォームであり、データ ソースへの接続を表し、データをコントロールにバインドするためのメソッドの公開、前または次のレコードへの移動、レコードの編集、元のソースへの変更の保存を実行します。  <xref:System.Windows.Forms.BindingNavigator> コントロールは、ユーザーがレコード間を移動する <xref:System.Windows.Forms.BindingSource> コンポーネントに対して、シンプルなインターフェイスを提供します。  
+  
+ \[データ ソース\] ウィンドウを使用すると、データ バインド コントロールを簡単に作成できます。  ウィンドウには、プロジェクト内のデータベース、Web サービス、オブジェクトなどのデータ ソースが表示されます。  このウィンドウからプロジェクトのフォームに項目をドラッグして、データ バインド コントロールを作成できます。  また、\[データ ソース\] ウィンドウから既存のコントロールにオブジェクトをドラッグして、データに既存のコントロールをバインドすることもできます。  
+  
+ Windows フォームで管理できる別の種類のデータ バインディングは*設定*です。  ほとんどのスマート クライアント アプリケーションは、フォームの前回のサイズなどの実行時の状態に関する情報を保持し、保存されたファイルの既定の場所などのユーザー設定のデータを保持する必要があります。  アプリケーション設定機能は、クライアント コンピューターに両方の種類の設定を保存する簡単な方法を提供することで、こうした要件に対応します。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] またはコード エディターを使用してこれらの設定を定義したら、設定は XML として永続化され、実行時に自動的にメモリに読み取られます。  
+  
+#### データの表示と操作に関するヘルプ  
+ これらの機能を使用する方法の手順を追った説明については、次のヘルプ トピックを参照してください。  
+  
+|説明|ヘルプ トピック|  
+|--------|--------------|  
+|<xref:System.Windows.Forms.BindingSource> コンポーネントを使用する|[方法 : デザイナーを使用して Windows フォーム コントロールを BindingSource コンポーネントにバインドする](../../../docs/framework/winforms/controls/bind-wf-controls-with-the-bindingsource.md)|  
+|[!INCLUDE[vstecado](../../../includes/vstecado-md.md)] データ ソースを操作する|[方法 : Windows フォーム BindingSource コンポーネントで ADO.NET データを並べ替える\/フィルター処理する](../../../docs/framework/winforms/controls/sort-and-filter-ado-net-data-with-wf-bindingsource-component.md)|  
+|\[データ ソース\] ウィンドウを使用する|[チュートリアル: Windows フォームでのデータの表示](../Topic/Walkthrough:%20Displaying%20Data%20on%20a%20Windows%20Form.md)|  
+|アプリケーション設定を使用する|[方法 : アプリケーション設定を作成する](../../../docs/framework/winforms/advanced/how-to-create-application-settings.md)|  
+  
+### クライアント コンピューターにアプリケーションを配置する  
+ アプリケーションを作成した後、ユーザーにアプリケーションを送信して、独自のクライアント コンピューターにインストールして実行できるようにする必要があります。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] テクノロジを使用する場合、数回クリックするだけで、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の中からアプリケーションを配置して、Web 上のアプリケーションを指す URL をユーザーに提供することができます。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] は、アプリケーションのすべての要素と依存関係を管理し、クライアント コンピューターにアプリケーションが正しくインストールされていることを確認します。  
+  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] アプリケーションは、ユーザーがネットワークに接続されている場合にのみ実行するか、オンラインとオフラインの両方で実行するかを構成することができます。  アプリケーションがオフライン操作をサポートするよう指定すると、[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] はユーザーの **\[スタート\]** メニューにアプリケーションへのリンクを追加します。  ユーザーは、URL を使用せずにアプリケーションを開くことができます。  
+  
+ アプリケーションを更新するときに、新しい配置マニフェストとアプリケーションの新しいコピーを Web サーバーに発行します。  [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] は、使用可能な更新プログラムがあることを検出し、ユーザーのインストールをアップグレードします。古いアセンブリを更新するのに、カスタム プログラミングは必要ありません。  
+  
+#### ClickOnce アプリケーションの配置に関するヘルプ  
+ [!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の完全な概要については、「[ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)」を参照してください。  これらの機能を使用する方法の手順を追った説明については、次のヘルプ トピックを参照してください。  
+  
+|説明|ヘルプ トピック|  
+|--------|--------------|  
+|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] を使用してアプリケーションを配置する|[方法: 発行ウィザードを使用して ClickOnce アプリケーションを発行する](../Topic/How%20to:%20Publish%20a%20ClickOnce%20Application%20using%20the%20Publish%20Wizard.md)<br /><br /> [チュートリアル : ClickOnce アプリケーションを手動で配置する](../Topic/Walkthrough:%20Manually%20Deploying%20a%20ClickOnce%20Application.md)|  
+|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] の配置を更新する|[方法 : ClickOnce アプリケーションの更新プログラムを管理する](../Topic/How%20to:%20Manage%20Updates%20for%20a%20ClickOnce%20Application.md)|  
+|[!INCLUDE[ndptecclick](../../../includes/ndptecclick-md.md)] を使用してセキュリティを管理する|[方法 : ClickOnce のセキュリティ設定を有効にする](../Topic/How%20to:%20Enable%20ClickOnce%20Security%20Settings.md)|  
+  
+### その他のコントロールおよび機能  
+ Windows フォームには、ダイアログ ボックスの作成、ヘルプやドキュメントの印刷や追加、アプリケーションの複数言語へのローカライズのサポートなど、一般的なタスクを高速で簡単に実装できる機能が他にも多数あります。  さらに、Windows フォームは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の堅牢なセキュリティ システムを利用しています。  このシステムを使用することで、顧客により安全なアプリケーションをリリースできます。  
+  
+#### その他のコントロールや機能の実装に関するヘルプ  
+ これらの機能を使用する方法の手順を追った説明については、次のヘルプ トピックを参照してください。  
+  
+|説明|ヘルプ トピック|  
+|--------|--------------|  
+|フォームの内容を印刷する|[方法 : Windows フォームでグラフィックスを印刷する](../../../docs/framework/winforms/advanced/how-to-print-graphics-in-windows-forms.md)<br /><br /> [方法 : Windows フォームで複数ページのテキスト ファイルを印刷する](../../../docs/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms.md)|  
+|Windows フォームのセキュリティについての詳細|[Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)|  
+  
+## 参照  
+ [Windows フォームについて](../../../docs/framework/winforms/getting-started-with-windows-forms.md)   
+ [新しい Windows フォームの作成](../../../docs/framework/winforms/creating-a-new-windows-form.md)   
+ [ToolStrip コントロールの概要](../../../docs/framework/winforms/controls/toolstrip-control-overview-windows-forms.md)   
+ [DataGridView コントロールの概要](../../../docs/framework/winforms/controls/datagridview-control-overview-windows-forms.md)   
+ [BindingSource コンポーネントの概要](../../../docs/framework/winforms/controls/bindingsource-component-overview.md)   
+ [アプリケーション設定の概要](../../../docs/framework/winforms/advanced/application-settings-overview.md)   
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)
\ No newline at end of file
diff --git a/docs/framework/winforms/windows-forms-security.md b/docs/framework/winforms/windows-forms-security.md
new file mode 100644
index 00000000000..6120949abe6
--- /dev/null
+++ b/docs/framework/winforms/windows-forms-security.md
@@ -0,0 +1,70 @@
+---
+title: "Windows フォームのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-winforms"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス制御, Windows フォーム"
+  - "デザイナーのアクセスのセキュリティ"
+  - "アクセス許可, Windows フォーム"
+  - "セキュリティ [Windows フォーム]"
+  - "セキュリティ ポリシー, Windows フォーム"
+  - "Windows フォーム, セキュリティ"
+ms.assetid: 932d438a-5285-46d8-a958-8c93d0ad6cae
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Windows フォームのセキュリティ
+Windows フォームには、コード ベースのセキュリティ モデルが使用されています。コードを実行するユーザーに関係なく、セキュリティ レベルはコードに対して設定されます。  これは、コンピューター システム上に既に用意されている任意のセキュリティ スキーマに追加して使用されます。  既に用意されているセキュリティ スキーマには、ブラウザーのセキュリティ スキーマ \(Internet Explorer で使用されるゾーン ベースのセキュリティなど\) とオペレーティング システムのセキュリティ スキーマ \(Windows NT の資格情報ベースのセキュリティなど\) があります。  
+  
+## このセクションの内容  
+ [Windows フォームのセキュリティの概要](../../../docs/framework/winforms/security-in-windows-forms-overview.md)  
+ .NET Framework のセキュリティ モデルについて簡単に説明し、アプリケーション内の Windows フォームの安全性を確保するための基本的な手順を示します。  
+  
+ [Windows フォームにおけるファイルおよびデータへのより安全なアクセス](../../../docs/framework/winforms/more-secure-file-and-data-access-in-windows-forms.md)  
+ やや信頼度の低い環境でファイルとデータにアクセスする方法について説明します。  
+  
+ [Windows フォームでのより安全な印刷](../../../docs/framework/winforms/more-secure-printing-in-windows-forms.md)  
+ やや信頼度の低い環境で印刷機能にアクセスする方法について説明します。  
+  
+ [Windows フォームのセキュリティに関するその他の考慮事項](../../../docs/framework/winforms/additional-security-considerations-in-windows-forms.md)  
+ 信頼度の低い環境におけるウィンドウ操作の実行、クリップボードの使用、およびアンマネージ コードの呼び出しについて説明します。  
+  
+## 関連項目  
+ [NIB: Default Security Policy](http://msdn.microsoft.com/ja-jp/2c086873-0894-4f4d-8f7e-47427c1a3b55)  
+ Full Trust、Local Intranet、および Internet の各アクセス許可セットで許可される既定のアクセス許可の一覧を示します。  
+  
+ [NIB: General Security Policy Administration](http://msdn.microsoft.com/ja-jp/5121fe35-f0e3-402c-94ab-4f35b0a87b4b)  
+ .NET Framework のセキュリティ ポリシーの管理、およびアクセス許可の度合いを高める方法について説明します。  
+  
+ [危険なアクセス許可とポリシー管理](../../../docs/framework/misc/dangerous-permissions-and-policy-administration.md)  
+ セキュリティ システムが回避される可能性のある .NET Framework のアクセス許可の例について説明します。  
+  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)  
+ .NET Framework に対して安全なコードを記述するために推奨される方法を説明したトピックへのリンクを提供します。  
+  
+ [NIB: Requesting Permissions](http://msdn.microsoft.com/ja-jp/0447c49d-8cba-45e4-862c-ff0b59bebdc2)  
+ コードの実行に必要なアクセス許可をランタイムに通知するために属性を使用する方法を説明します。  
+  
+ [セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)  
+ コードのセキュリティに関する基本的な事項を説明したトピックへのリンクを提供します。  
+  
+ [コード アクセス セキュリティの基礎](../../../docs/framework/misc/code-access-security-basics.md)  
+ .NET Framework の実行時セキュリティ ポリシーを使用するための基本的な事項について説明します。  
+  
+ [NIB: Determining When to Modify Security Policy](http://msdn.microsoft.com/ja-jp/af749b17-e461-409d-84b9-a3d44789db16)  
+ アプリケーションが既定のセキュリティ ポリシーから逸脱する必要がある場合の判断の方法について説明します。  
+  
+ [NIB: Deploying Security Policy](http://msdn.microsoft.com/ja-jp/f936c1e5-033b-4bd9-a3bd-a39ba733a681)  
+ セキュリティ ポリシーの変更を配置するための推奨される方法について説明します。
\ No newline at end of file
diff --git a/docs/framework/wpf/TOC.md b/docs/framework/wpf/TOC.md
new file mode 100644
index 00000000000..9c9704433cf
--- /dev/null
+++ b/docs/framework/wpf/TOC.md
@@ -0,0 +1,7 @@
+# [Windows Presentation Foundation](index.md)
+# [WPF 部分信頼セキュリティ](wpf-partial-trust-security.md)
+# [セキュリティ](security-wpf.md)
+# [クラス ライブラリ](class-library-wpf.md)
+# [WPF のセキュリティ方針 - プラットフォーム セキュリティ](wpf-security-strategy-platform-security.md)
+# [WPF のサンプル](wpf-samples.md)
+# [WPF のセキュリティ方針 - セキュリティ エンジニアリング](wpf-security-strategy-security-engineering.md)
diff --git a/docs/framework/wpf/advanced/TOC.md b/docs/framework/wpf/advanced/TOC.md
new file mode 100644
index 00000000000..cd5257edcbb
--- /dev/null
+++ b/docs/framework/wpf/advanced/TOC.md
@@ -0,0 +1,268 @@
+# [ビジュアルにテキストを描画する](how-to-draw-text-to-a-visual.md)
+# [WPF の双方向機能の概要](bidirectional-features-in-wpf-overview.md)
+# [チュートリアル : ハイブリッド アプリケーションのローカライズ](walkthrough-localizing-a-hybrid-application.md)
+# [オブジェクトの有効期間イベント](object-lifetime-events.md)
+# [インクの回転](how-to-rotate-ink.md)
+# [依存関係プロパティのメタデータをオーバーライドする](how-to-override-metadata-for-a-dependency-property.md)
+# [XamlWriter.Save のシリアル化の制限](serialization-limitations-of-xamlwriter-save.md)
+# [DependencyObject の安全なコンストラクター パターン](safe-constructor-patterns-for-dependencyobjects.md)
+# [TypeConverters および XAML](typeconverters-and-xaml.md)
+# [手書き認識](handwriting-recognition.md)
+# [ハイブリッド アプリケーションのトラブルシューティング](troubleshooting-hybrid-applications.md)
+# [読み取り専用の依存関係プロパティ](read-only-dependency-properties.md)
+# [アプリケーションの起動時間](application-startup-time.md)
+# [テキストの高度な書式設定](advanced-text-formatting.md)
+# [インク データにカスタム データを追加する](how-to-add-custom-data-to-ink-data.md)
+# [方法のトピック](flow-content-elements-how-to-topics.md)
+# [フロー ドキュメントの概要](flow-document-overview.md)
+# [アニメーションをテキストに適用する](how-to-apply-animations-to-text.md)
+# [入力の概要](input-overview.md)
+# [依存関係プロパティの所有者の種類を追加する](how-to-add-an-owner-type-for-a-dependency-property.md)
+# [添付プロパティを登録する](how-to-register-an-attached-property.md)
+# [ローカリゼーション属性とコメント](localization-attributes-and-comments.md)
+# [Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](performance-considerations-for-direct3d9-and-wpf-interoperability.md)
+# [RowGroups プロパティを介してテーブルの行グループを操作する](how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
+# [グローバライズとローカライズ](globalization-and-localization.md)
+# [WPF のツリー](trees-in-wpf.md)
+# [弱いイベント パターン](weak-event-patterns.md)
+# [WPF における XAML とカスタム クラス](xaml-and-custom-classes-for-wpf.md)
+# [カスタム依存関係プロパティ](custom-dependency-properties.md)
+# [タイポグラフィ](typography.md)
+# [データ形式がデータ オブジェクトに存在するかどうかを判別する](how-to-determine-if-a-data-format-is-present-in-a-data-object.md)
+# [プログラムによってテーブルをビルドする](how-to-build-a-table-programmatically.md)
+# [印刷ダイアログ ボックスを呼び出す](how-to-invoke-a-print-dialog.md)
+# [2D グラフィックスとイメージング](optimizing-performance-2d-graphics-and-imaging.md)
+# [方法のトピック](properties-how-to-topics.md)
+# [WPF アプリケーションのリアルタイムなスタイラス入力を無効にする](disable-the-realtimestylus-for-wpf-applications.md)
+# [テキストのトリミングを有効にする](how-to-enable-text-trimming.md)
+# [プリンターを複製する](how-to-clone-a-printer.md)
+# [アプリケーションでのフォントのパッケージング](packaging-fonts-with-applications.md)
+# [コマンドをサポートしないコントロールにコマンドをフックする](how-to-hook-up-a-command-to-a-control-with-no-command-support.md)
+# [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](walkthrough-caching-application-data-in-a-wpf-application.md)
+# [カスタム コントロールでインクを消去する](how-to-erase-ink-on-a-custom-control.md)
+# [コマンドを有効にする](how-to-enable-a-command.md)
+# [プロパティ値の継承](property-value-inheritance.md)
+# [プロパティ](properties-wpf.md)
+# [ComponentResourceKey マークアップ拡張機能](componentresourcekey-markup-extension.md)
+# [チュートリアル: 初めてのタッチ アプリケーションの作成](walkthrough-creating-your-first-touch-application.md)
+# [移行と相互運用性](migration-and-interoperability.md)
+# [プリンターのステータスをリモート操作で調査する](how-to-remotely-survey-the-status-of-printers.md)
+# [グリフ](glyphs.md)
+# [アプリケーション ジェスチャを認識する](how-to-recognize-application-gestures.md)
+# [FrameworkElement のサイズをアニメーション化する](how-to-animate-the-size-of-a-frameworkelement.md)
+# [分析のヒントに従ってインクを分析する](how-to-analyze-ink-with-analysis-hints.md)
+# [イベント](events-wpf.md)
+# [フロー コンテンツ](flow-content.md)
+# [マージされたリソース ディクショナリ](merged-resource-dictionaries.md)
+# [依存関係プロパティの概要](dependency-properties-overview.md)
+# [依存関係プロパティのセキュリティ](dependency-property-security.md)
+# [デジタル インク](digital-ink.md)
+# [TextElement コンテンツ モデルの概要](textelement-content-model-overview.md)
+# [読み取り専用の Freezable の書き込み可能なコピーを取得する](how-to-obtain-a-writable-copy-of-a-read-only-freezable.md)
+# [パフォーマンスに関するその他の推奨事項](optimizing-performance-other-recommendations.md)
+# [依存関係プロパティのメタデータ](dependency-property-metadata.md)
+# [要素を名前で検索する](how-to-find-an-element-by-its-name.md)
+# [文字の装飾を作成する](how-to-create-a-text-decoration.md)
+# [チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化](walkthrough-enabling-drag-and-drop-on-a-user-control.md)
+# [印刷キューのサブセットを列挙する](how-to-enumerate-a-subset-of-print-queues.md)
+# [Blocks プロパティを介して FlowDocument を操作する](how-to-manipulate-a-flowdocument-through-the-blocks-property.md)
+# [アプリケーション パフォーマンスの計画](planning-for-application-performance.md)
+# [インク スレッド モデル](the-ink-threading-model.md)
+# [FlowDocument の列区切り属性を使用する](how-to-use-flowdocument-column-separating-attributes.md)
+# [パフォーマンス](performance.md)
+# [方法のトピック](globalization-and-localization-how-to-topics.md)
+# [インク入力コントロールの作成](creating-an-ink-input-control.md)
+# [方法のトピック](digital-ink-how-to-topics.md)
+# [リソースとコード](resources-and-code.md)
+# [ハードウェアの活用](optimizing-performance-taking-advantage-of-hardware.md)
+# [チュートリアル : ElementHost コントロールを使用したプロパティの割り当て](walkthrough-mapping-properties-using-the-elementhost-control.md)
+# [コマンド実行の概要](commanding-overview.md)
+# [リソースを定義および参照する](how-to-define-and-reference-a-resource.md)
+# [技術領域の概要](technology-regions-overview.md)
+# [カスタム ルーティング イベントを作成する](how-to-create-a-custom-routed-event.md)
+# [プレビュー イベント](preview-events.md)
+# [方法のトピック](fonts-how-to-topics.md)
+# [書式設定されたテキストの描画](drawing-formatted-text.md)
+# [問題のある印刷ジョブを診断する](how-to-diagnose-problematic-print-job.md)
+# [Blocks プロパティを介してフロー コンテンツ要素を操作する](how-to-manipulate-flow-content-elements-through-the-blocks-property.md)
+# [Visual Basic と WPF のイベント処理](visual-basic-and-wpf-event-handling.md)
+# [mc:Ignorable 属性](mc-ignorable-attribute.md)
+# [WPF アプリケーションのパフォーマンスの最適化](optimizing-wpf-application-performance.md)
+# [高度なインク処理](advanced-ink-handling.md)
+# [自動レイアウト用のグリッドを使用する](how-to-use-a-grid-for-automatic-layout.md)
+# [RoutedCommand を作成する](how-to-create-a-routedcommand.md)
+# [ThemeDictionary のマークアップ拡張機能](themedictionary-markup-extension.md)
+# [注釈スキーマ](annotations-schema.md)
+# [XAML の概要 (WPF)](xaml-overview-wpf.md)
+# [チュートリアル: WPF での Win32 コントロールのホスト](walkthrough-hosting-a-win32-control-in-wpf.md)
+# [Enter キーが押されたことを検出する](how-to-detect-when-the-enter-key-pressed.md)
+# [特定のデータ形式でデータを取得する](how-to-retrieve-data-in-a-particular-data-format.md)
+# [方法のトピック](input-and-commands-how-to-topics.md)
+# [XAML で特殊文字を使用する](how-to-use-special-characters-in-xaml.md)
+# [UIElement を透明または半透明にする](how-to-make-a-uielement-transparent-or-semi-transparent.md)
+# [インクの格納](storing-ink.md)
+# [チュートリアル: WPF での Windows フォーム コントロールの配置](walkthrough-arranging-windows-forms-controls-in-wpf.md)
+# [方法のトピック](resources-how-to-topics.md)
+# [WPF と Windows フォームの相互運用性](wpf-and-windows-forms-interoperation.md)
+# [WPF における分離コードと XAML](code-behind-and-xaml-in-wpf.md)
+# [チュートリアル: WPF での Windows フォーム コントロールのホスト](walkthrough-hosting-a-windows-forms-control-in-wpf.md)
+# [配置、余白、パディングの概要](alignment-margins-and-padding-overview.md)
+# [入力](input-wpf.md)
+# [コレクション型依存関係プロパティ](collection-type-dependency-properties.md)
+# [Windows フォームと WPF プロパティの割り当て](windows-forms-and-wpf-property-mapping.md)
+# [フレームワーク プロパティ メタデータ](framework-property-metadata.md)
+# [プログラムでテキストに要素を挿入する](how-to-insert-an-element-into-text-programmatically.md)
+# [StaticResource のマークアップ拡張機能](staticresource-markup-extension.md)
+# [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)
+# [自動レイアウトを使用してボタンを作成する](how-to-use-automatic-layout-to-create-a-button.md)
+# [方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする](how-to-enable-visual-styles-in-a-hybrid-application.md)
+# [データ オブジェクトへ複数のデータ形式を格納する](how-to-store-multiple-data-formats-in-a-data-object.md)
+# [インクをドラッグ アンド ドロップする](how-to-drag-and-drop-ink.md)
+# [Freezable が固定されているかどうかを判別する](how-to-determine-whether-a-freezable-is-frozen.md)
+# [XAML リソース](xaml-resources.md)
+# [要素のツリーおよびシリアル化](element-tree-and-serialization.md)
+# [コマンドをサポートするコントロールにコマンドをフックする](how-to-hook-up-a-command-to-a-control-with-command-support.md)
+# [InkCanvas にデータをバインドする](how-to-data-bind-to-an-inkcanvas.md)
+# [Windows フォーム コントロールおよび同等の WPF コントロール](windows-forms-controls-and-equivalent-wpf-controls.md)
+# [Freezable オブジェクトの概要](freezable-objects-overview.md)
+# [イベント ハンドラーでソース要素を検索する](how-to-find-the-source-element-in-an-event-handler.md)
+# [WPF アーキテクチャ](wpf-architecture.md)
+# [依存関係プロパティを実装する](how-to-implement-a-dependency-property.md)
+# [XAML を使用してテーブルを定義する](how-to-define-a-table-with-xaml.md)
+# [バインドのマークアップ拡張機能](binding-markup-extension.md)
+# [方法のトピック](typography-how-to-topics.md)
+# [現在、印刷ジョブが印刷可能であるかどうかを検出する](how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md)
+# [フォーカス イベントを使用して要素の色を変更する](how-to-change-the-color-of-an-element-using-focus-events.md)
+# [ClearType の概要](cleartype-overview.md)
+# [段落間の間隔を調整する](how-to-adjust-spacing-between-paragraphs.md)
+# [ドキュメント](documents.md)
+# [オブジェクト ツリーに存在しないオブジェクト要素の初期化](initialization-for-object-elements-not-in-an-object-tree.md)
+# [スタイラスからの入力のインターセプト](intercepting-input-from-the-stylus.md)
+# [ContextMenuOpening イベントを処理する](how-to-handle-the-contextmenuopening-event.md)
+# [コントロールのフォーカスのスタイルと FocusVisualStyle](styling-for-focus-in-controls-and-focusvisualstyle.md)
+# [ドラッグ アンド ドロップ](drag-and-drop.md)
+# [システム パラメーター キーを使用する](how-to-use-system-parameters-keys.md)
+# [インクの概要](getting-started-with-ink.md)
+# [添付プロパティの概要](attached-properties-overview.md)
+# [チュートリアル : WindowsFormsHost 要素を使用したプロパティの割り当て](walkthrough-mapping-properties-using-the-windowsformshost-element.md)
+# [GlyphRun オブジェクトと Glyphs 要素の概要](introduction-to-the-glyphrun-object-and-glyphs-element.md)
+# [ICommandSource を実装する](how-to-implement-icommandsource.md)
+# [オブジェクトの動作](optimizing-performance-object-behavior.md)
+# [DynamicResource のマークアップ拡張機能](dynamicresource-markup-extension.md)
+# [注釈の概要](annotations-overview.md)
+# [フロー コンテンツ要素を使用する](how-to-use-flow-content-elements.md)
+# [要素およびコントロールのマージンを設定する](how-to-set-margins-of-elements-and-controls.md)
+# [自動レイアウトの使用の概要](use-automatic-layout-overview.md)
+# [XAML 読み込みと依存関係プロパティ](xaml-loading-and-dependency-properties.md)
+# [WPF のドキュメント](documents-in-wpf.md)
+# [フォント](fonts-wpf.md)
+# [Freezable を読み取り専用にする](how-to-make-a-freezable-read-only.md)
+# [RichTextBox コントロール上にドロップしたファイルを開く](how-to-open-a-file-that-is-dropped-on-a-richtextbox-control.md)
+# [影付きテキストを作成する](how-to-create-text-with-a-shadow.md)
+# [インライン スタイルおよびテンプレート](inline-styles-and-templates.md)
+# [コントロールの背景にテキストを描画する](how-to-draw-text-to-a-control-background.md)
+# [XAML 構文の詳細](xaml-syntax-in-detail.md)
+# [マークアップの互換性 (mc:) 言語機能](markup-compatibility-mc-language-features.md)
+# [Text](optimizing-performance-text.md)
+# [インクの収集](collecting-ink.md)
+# [カスタム レンダリング インク](custom-rendering-ink.md)
+# [印刷および印刷システムの管理](printing-and-print-system-management.md)
+# [アプリケーション リソース](optimizing-performance-application-resources.md)
+# [マークアップ拡張機能と WPF XAML](markup-extensions-and-wpf-xaml.md)
+# [チュートリアル : WPF での Direct3D9 コンテンツのホスト](walkthrough-hosting-direct3d9-content-in-wpf.md)
+# [方法のトピック](printing-how-to-topics.md)
+# [カスタム コントロールからインクを選択する](how-to-select-ink-from-a-custom-control.md)
+# [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](marking-routed-events-as-handled-and-class-handling.md)
+# [WPF XAML 拡張機能](wpf-xaml-extensions.md)
+# [テーブルの概要](table-overview.md)
+# [概要](digital-ink-overviews.md)
+# [WPF の XAML](xaml-in-wpf.md)
+# [XAML 名前空間および WPF XAML の名前空間の割り当て](xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)
+# [データとデータ オブジェクト](data-and-data-objects.md)
+# [DateTime XAML 構文](datetime-xaml-syntax.md)
+# [詳細設定](index.md)
+# [方法 : グリフを使用してテキストを描画する](draw-text-using-glyphs.md)
+# [インク オブジェクト モデル : Windows フォームおよび COM と WPF の比較](the-ink-object-model-windows-forms-and-com-versus-wpf.md)
+# [ClearType レジストリの設定](cleartype-registry-settings.md)
+# [WPF のグローバリゼーションおよびローカリゼーションの概要](wpf-globalization-and-localization-overview.md)
+# [OpenType フォント パックのサンプル](sample-opentype-font-pack.md)
+# [方法のトピック](drag-and-drop-how-to-topics.md)
+# [チュートリアル: Win32 での WPF クロックのホスト](walkthrough-hosting-a-wpf-clock-in-win32.md)
+# [基本要素](base-elements.md)
+# [WPF XAML 名前スコープ](wpf-xaml-namescopes.md)
+# [ThicknessConverter オブジェクトを使用する](how-to-use-a-thicknessconverter-object.md)
+# [Inlines プロパティを介してフロー コンテンツ要素を操作する](how-to-manipulate-flow-content-elements-through-the-inlines-property.md)
+# [オブジェクトをマウス ポインターに追従させる](how-to-make-an-object-follow-the-mouse-pointer.md)
+# [アプリケーション リソースを使用する](how-to-use-application-resources.md)
+# [アプリケーションをローカライズする](how-to-localize-an-application.md)
+# [PrintTickets を検証およびマージする](how-to-validate-and-merge-printtickets.md)
+# [中抜きの文字列を作成する](how-to-create-outlined-text.md)
+# [依存関係プロパティのコールバックと検証](dependency-property-callbacks-and-validation.md)
+# [チュートリアル: Windows フォームでの 3D WPF 複合コントロールのホスト](walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md)
+# [ドキュメントのシリアル化および保存](document-serialization-and-storage.md)
+# [コントロール](optimizing-performance-controls.md)
+# [WPF のグローバリゼーション](globalization-for-wpf.md)
+# [リフレクションを使用せずに印刷システム オブジェクトのプロパティを取得する](how-to-get-print-system-object-properties-without-reflection.md)
+# [OpenType フォントの機能](opentype-font-features.md)
+# [Columns プロパティによってテーブルの列を操作する](how-to-manipulate-table-columns-through-the-columns-property.md)
+# [SystemFonts を使用する](how-to-use-systemfonts.md)
+# [レイアウト](layout.md)
+# [WPF での Win32 コンテンツのホスト](hosting-win32-content-in-wpf.md)
+# [WindowsFormsHost 要素のレイアウトに関する考慮事項](layout-considerations-for-the-windowsformshost-element.md)
+# [イベントを使用してロールオーバー効果を作成する](how-to-create-a-rollover-effect-using-events.md)
+# [FontSizeConverter クラスを使用する](how-to-use-the-fontsizeconverter-class.md)
+# [Win32 と WPF 間でのメッセージ ループの共有](sharing-message-loops-between-win32-and-wpf.md)
+# [ハイパーリンクに下線を引くかどうかを指定する](how-to-specify-whether-a-hyperlink-is-underlined.md)
+# [PresentationOptions:Freeze 属性](presentationoptions-freeze-attribute.md)
+# [チュートリアル: Win32 での WPF コンテンツのホスト](walkthrough-hosting-wpf-content-in-win32.md)
+# [システム フォントを列挙する](how-to-enumerate-system-fonts.md)
+# [FocusVisualStyle をコントロールに適用する](how-to-apply-a-focusvisualstyle-to-a-control.md)
+# [TextWrapping プロパティをプログラムにより変更する](how-to-change-the-textwrapping-property-programmatically.md)
+# [方法のトピック](element-tree-and-serialization-how-to-topics.md)
+# [基本要素の概要](base-elements-overview.md)
+# [添付イベントの概要](attached-events-overview.md)
+# [チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成](walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md)
+# [RelativeSource のマークアップ拡張機能](relativesource-markupextension.md)
+# [コードを使用してイベント ハンドラーを追加する](how-to-add-an-event-handler-using-code.md)
+# [mc:ProcessContent 属性](mc-processcontent-attribute.md)
+# [コメント](annotations.md)
+# [依存関係プロパティ値の優先順位](dependency-property-value-precedence.md)
+# [TemplateBinding のマークアップ拡張機能](templatebinding-markup-extension.md)
+# [WPF と Direct3D9 の相互運用性](wpf-and-direct3d9-interoperation.md)
+# [チュートリアル: WPF での、XAML を使用した Windows フォーム コントロールのホスト](walkthrough-hosting-a-windows-forms-control-in-wpf-by-using-xaml.md)
+# [ドラッグ アンド ドロップの概要](drag-and-drop-overview.md)
+# [ルーティング イベントの概要](routed-events-overview.md)
+# [ResourceDictionary を使用してローカライズ可能な文字列リソースを管理する](how-to-use-a-resourcedictionary-to-manage-localizable-string-resources.md)
+# [テキストの文字体裁を変更する](how-to-alter-the-typography-of-text.md)
+# [チュートリアル: WPF での ActiveX コントロールのホスト](walkthrough-hosting-an-activex-control-in-wpf.md)
+# [データ オブジェクト内のデータ形式の一覧を表示する](how-to-list-the-data-formats-in-a-data-object.md)
+# [チュートリアル : ハイブリッド アプリケーションでのデータへのバインディング](walkthrough-binding-to-data-in-hybrid-applications.md)
+# [ColorConvertedBitmap のマークアップ拡張機能](colorconvertedbitmap-markup-extension.md)
+# [ルーティング イベントのクラス処理を追加する](how-to-add-class-handling-for-a-routed-event.md)
+# [ルーティング イベントを処理する](how-to-handle-a-routed-event.md)
+# [データ バインド](optimizing-performance-data-binding.md)
+# [リソース](resources-wpf.md)
+# [WPF と Win32 の相互運用性](wpf-and-win32-interoperation.md)
+# [Windows フォームと WPF の相互運用性入力アーキテクチャ](windows-forms-and-wpf-interoperability-input-architecture.md)
+# [PropertyPath の XAML 構文](propertypath-xaml-syntax.md)
+# [印刷の概要](printing-overview.md)
+# [テキストに変換を適用する](how-to-apply-transforms-to-text.md)
+# [読み込まれたイベントを処理する](how-to-handle-a-loaded-event.md)
+# [XPS ファイルをプログラムにより印刷する](how-to-programmatically-print-xps-files.md)
+# [論理ツリーをオーバーライドする](how-to-override-the-logical-tree.md)
+# [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
+# [プロパティ変更イベント](property-change-events.md)
+# [方法のトピック](base-elements-how-to-topics.md)
+# [グラフィックスの描画層](graphics-rendering-tiers.md)
+# [カーソルの種類を変更する](how-to-change-the-cursor-type.md)
+# [ローカライズ可能アプリケーションでリソースを使用する](how-to-use-resources-in-localizable-applications.md)
+# [WPF のタイポグラフィ](typography-in-wpf.md)
+# [システム フォント キーを使用する](how-to-use-system-fonts-keys.md)
+# [プログラムによってコンテンツの FlowDirection を変更する](how-to-change-the-flowdirection-of-content-programmatically.md)
+# [SystemParameters を使用する](how-to-use-systemparameters.md)
+# [スレッド モデル](threading-model.md)
+# [UIElement を左右または上下に反転させる](how-to-flip-a-uielement-horizontally-or-vertically.md)
+# [フォーカスの概要](focus-overview.md)
+# [データ オブジェクトを作成する](how-to-create-a-data-object.md)
+# [レイアウトとデザイン](optimizing-performance-layout-and-design.md)
+# [方法のトピック](events-how-to-topics.md)
diff --git a/docs/framework/wpf/advanced/advanced-ink-handling.md b/docs/framework/wpf/advanced/advanced-ink-handling.md
new file mode 100644
index 00000000000..276bfa938e0
--- /dev/null
+++ b/docs/framework/wpf/advanced/advanced-ink-handling.md
@@ -0,0 +1,36 @@
+---
+title: "高度なインク処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "クラス, System.Windows.Input.StylusPlugIns"
+  - "インク, 高度な処理"
+  - "InkCanvas コントロール"
+  - "StylusPlugIns クラス"
+  - "System.Windows.Input.StylusPlugIns クラス"
+ms.assetid: abc8481a-f983-416f-b051-9168ac8b2ba3
+caps.latest.revision: 52
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# 高度なインク処理
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には <xref:System.Windows.Controls.InkCanvas> が付属しており、この要素をアプリケーションに導入すると、インクの収集および表示をすぐに開始できます。  ただし、<xref:System.Windows.Controls.InkCanvas> コントロールの提供する制御レベルが十分でない場合は、<xref:System.Windows.Input.StylusPlugIns> を使用するインク コレクション クラスおよびインク レンダリング クラスをカスタマイズすることで、より高度な制御を保持できます。  
+  
+ <xref:System.Windows.Input.StylusPlugIns> クラスは、<xref:System.Windows.Input.Stylus> 入力および動的なレンダリング インクに対して低レベルの制御を実装するための機構を提供します。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> クラスは、最適なパフォーマンスを実現するために、カスタム動作を実装し、その動作をスタイラス デバイスから取得されるデータのストリームに適用するための機構を提供します。  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は、特殊な <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> で、インク データの動的なレンダリングをリアルタイムにカスタマイズできます。つまり、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は、<xref:System.Windows.Input.StylusPoint> データが生成されると直ちにデジタル インクを描画し、このインクはスタイラス デバイスから "流れる" ように表示されます。  
+  
+## このセクションの内容  
+ [カスタム レンダリング インク](../../../../docs/framework/wpf/advanced/custom-rendering-ink.md)  
+ [スタイラスからの入力のインターセプト](../../../../docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md)  
+ [インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)  
+ [インク スレッド モデル](../../../../docs/framework/wpf/advanced/the-ink-threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/advanced-text-formatting.md b/docs/framework/wpf/advanced/advanced-text-formatting.md
new file mode 100644
index 00000000000..d622fe0e4a5
--- /dev/null
+++ b/docs/framework/wpf/advanced/advanced-text-formatting.md
@@ -0,0 +1,103 @@
+---
+title: "テキストの高度な書式設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式設定 [WPF]"
+  - "テキスト [WPF]"
+  - "タイポグラフィ, テキストの書式設定"
+ms.assetid: f0a7986e-f5b2-485c-a27d-f8e922022212
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# テキストの高度な書式設定
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] には、アプリケーションにテキストを含めるための信頼性の高い一連の [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] が用意されています。  <xref:System.Windows.Controls.TextBlock> などのレイアウトおよび[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、テキスト表示において最も共通して一般的に使用される要素を提供します。  <xref:System.Windows.Media.GlyphRunDrawing> や <xref:System.Windows.Media.FormattedText> などの描画 [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] では、書式設定されたテキストを描画に含めることができます。  最も高度なレベルでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] により、テキスト ストアの管理、テキスト ランの書式設定の管理、埋め込みオブジェクトの管理などの、テキスト表示のあらゆる面の制御を行う拡張性のあるテキスト書式設定エンジンが提供されます。  
+  
+ ここでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] におけるテキスト書式設定の概要を説明します。  特に、クライアントの実装と [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のテキスト書式設定エンジンの使用を重点的に説明します。  
+  
+> [!NOTE]
+>  このドキュメント内のすべてのコード例は、[テキストの高度な書式設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=159965)にあります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prereq"></a>   
+## 必要条件  
+ ここでは、テキスト表示に使用する高いレベルの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] に精通していることを前提として説明を進めます。  ほとんどのユーザーの場合、ここで説明する [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の高度なテキスト書式設定は必要ありません。  別のテキスト [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の概要については、「[WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)」を参照してください。  
+  
+<a name="section1"></a>   
+## テキストの高度な書式設定  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のテキスト レイアウトおよび [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] コントロールは、アプリケーションに書式設定されたテキストを簡単に含めることができる書式設定プロパティを提供します。  これらのコントロールは、テキストの書体、サイズ、色などのテキスト表示を処理するためのさまざまなプロパティを公開します。  通常の場合は、これらのコントロールでアプリケーション内のテキスト表示の大半を処理できます。  ただし、一部の高度な処理の場合、テキスト表示に加えてテキスト保存のコントロールも必要となります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では拡張可能なテキスト書式設定エンジンを使用できます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の高度なテキスト書式設定機能は、テキスト書式設定エンジン、テキスト ストア、テキスト ラン、および書式設定プロパティで構成されています。  テキスト書式設定エンジンである <xref:System.Windows.Media.TextFormatting.TextFormatter> により、表示用のテキスト行が作成されます。  これは、行書式設定プロセスを開始し、テキスト フォーマッタの <xref:System.Windows.Media.TextFormatting.TextFormatter.FormatLine%2A> を呼び出すことにより実行されます。  テキスト フォーマッタは、テキスト ストアの <xref:System.Windows.Media.TextFormatting.TextSource.GetTextRun%2A> メソッドを呼び出すことにより、そのストアからテキスト ランを取得します。  次に、テキスト フォーマッタにより <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトから <xref:System.Windows.Media.TextFormatting.TextLine> オブジェクトが作成され、検査または表示用にアプリケーションに渡されます。  
+  
+<a name="section2"></a>   
+## テキスト フォーマッタの使用  
+ <xref:System.Windows.Media.TextFormatting.TextFormatter> は [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のテキスト書式設定エンジンであり、テキスト行の書式指定および改行のサービスを提供します。  テキスト フォーマッタは異なるテキスト文字形式および段落スタイルを処理でき、国際的なテキスト レイアウトがサポートされています。  
+  
+ 従来のテキスト [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] とは異なり、<xref:System.Windows.Media.TextFormatting.TextFormatter> は一連のコールバック メソッドを使用して、テキスト レイアウト クライアントと対話します。  このテキスト フォーマッタを使用するには、クライアントが <xref:System.Windows.Media.TextFormatting.TextSource> クラスの実装にこれらのメソッドを提供している必要があります。  クライアント アプリケーションと <xref:System.Windows.Media.TextFormatting.TextFormatter> の間のテキスト レイアウトの対話を次の図に示します。  
+  
+ ![テキスト レイアウト クライアントと TextFormatter のダイアグラム](../../../../docs/framework/wpf/advanced/media/textformatter01.png "TextFormatter01")  
+アプリケーションと TextFormatter の対話  
+  
+ テキスト フォーマッタは、<xref:System.Windows.Media.TextFormatting.TextSource> の実装であるテキスト ストアから書式設定されたテキスト行を取得するために使用されます。  これは、最初に <xref:System.Windows.Media.TextFormatting.TextFormatter.Create%2A> メソッドを使用してテキスト フォーマッタのインスタンスを作成することにより実行されます。  このメソッドによりテキスト フォーマッタのインスタンスが作成され、行の最大高と最大幅が設定されます。  テキスト フォーマッタのインスタンスが作成されると直ちに、<xref:System.Windows.Media.TextFormatting.TextFormatter.FormatLine%2A> メソッドを呼び出すことにより、行作成プロセスが開始されます。  <xref:System.Windows.Media.TextFormatting.TextFormatter> によりテキストのソースが呼び戻され、行を形成する一続きのテキストの、テキストと書式設定パラメーターが取得されます。  
+  
+ 次の例では、テキスト ストアを書式設定するプロセスを示します。  <xref:System.Windows.Media.TextFormatting.TextFormatter> オブジェクトを使用してテキスト ストアからテキスト行が取得され、<xref:System.Windows.Media.DrawingContext> に描画するテキスト行が書式設定されます。  
+  
+ [!code-csharp[TextFormatterExample#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextFormatterExample/CSharp/Window1.xaml.cs#100)]
+ [!code-vb[TextFormatterExample#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextFormatterExample/VisualBasic/Window1.xaml.vb#100)]  
+  
+<a name="section3"></a>   
+## クライアント テキスト ストアの実装  
+ テキスト書式設定エンジンを拡張する場合は、テキスト ストアをすべての面で実装および管理する必要があります。  これは単純な作業ではありません。  テキスト ストアの役割は、テキスト ランのプロパティ、段落プロパティ、埋め込みオブジェクト、およびその他の類似したコンテンツを追跡することです。  また、テキスト ストアは、<xref:System.Windows.Media.TextFormatting.TextLine> オブジェクトを作成するときにテキスト フォーマッタが使用する、個々の <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトをテキスト フォーマッタに提供します。  
+  
+ テキスト ストアの仮想化を処理する場合は、テキスト ストアが <xref:System.Windows.Media.TextFormatting.TextSource> から派生している必要があります。  <xref:System.Windows.Media.TextFormatting.TextSource> では、テキスト フォーマッタがテキスト ストアからテキスト ランを取得するために使用するメソッドが定義されています。  <xref:System.Windows.Media.TextFormatting.TextSource.GetTextRun%2A> は、行の書式設定に使用されるテキスト ランを取得するためにテキスト フォーマッタが使用するメソッドです。  次のいずれかの条件が発生するまで、<xref:System.Windows.Media.TextFormatting.TextSource.GetTextRun%2A> はテキスト フォーマッタによって繰り返し呼び出されます。  
+  
+-   <xref:System.Windows.Media.TextFormatting.TextEndOfLine> またはサブクラスが返された場合。  
+  
+-   テキスト ランの累積幅が、テキスト フォーマッタを作成する呼び出し、またはテキスト フォーマッタの <xref:System.Windows.Media.TextFormatting.TextFormatter.FormatLine%2A> メソッドのいずれかに指定されている行の最大幅を超えた場合。  
+  
+-   "CF"、"LF"、または "CRLF" などの [!INCLUDE[TLA#tla_unicode](../../../../includes/tlasharptla-unicode-md.md)] 改行シーケンスが返された場合。  
+  
+<a name="section4"></a>   
+## テキスト ランの提供  
+ テキスト フォーマッタとテキスト ストアの間の対話は、テキスト書式設定プロセスにおける中核となります。  <xref:System.Windows.Media.TextFormatting.TextSource> を実装することにより、テキスト フォーマッタに <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトおよびテキスト ランの書式設定に使用されるプロパティが提供されます。  この対話は、テキスト フォーマッタによって呼び出される <xref:System.Windows.Media.TextFormatting.TextSource.GetTextRun%2A> メソッドによって処理されます。  
+  
+ 定義済みの <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトの一部を次の表に示します。  
+  
+|TextRun 型|使用方法|  
+|---------------|----------|  
+|<xref:System.Windows.Media.TextFormatting.TextCharacters>|テキスト フォーマッタに文字グリフの表示を戻すために使用される、特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextEmbeddedObject>|ボタン、テキスト内の画像などの、測定、ヒット テスト、描画がすべて実行されるコンテンツを提供するために使用される、特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextEndOfLine>|行の終わりを示すために使用される、特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextEndOfParagraph>|段落の終わりを示すために使用される、特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextEndOfSegment>|前の <xref:System.Windows.Media.TextFormatting.TextModifier> 実行の影響を受けるスコープを終了する場合のように、セグメントの終わりを示すために使用される特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextHidden>|隠し文字の範囲を示すために使用される特殊なテキスト ランです。|  
+|<xref:System.Windows.Media.TextFormatting.TextModifier>|スコープ内のテキスト ランのプロパティを変更するために使用される、特殊なテキスト ランです。  この範囲は、次に一致する <xref:System.Windows.Media.TextFormatting.TextEndOfSegment> のテキスト ラン、または次の <xref:System.Windows.Media.TextFormatting.TextEndOfParagraph> まで拡張されます。|  
+  
+ 定義済みの <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトは、すべてサブクラス化できます。  これにより、カスタム データを含むテキスト ランをテキスト ソースからテキスト フォーマッタに提供できます。  
+  
+ <xref:System.Windows.Media.TextFormatting.TextSource.GetTextRun%2A> メソッドの例を次に示します。  このテキスト ストアは、次のテキスト フォーマッタに <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトを返して処理を行います。  
+  
+ [!code-csharp[TextFormatterExample#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextFormatterExample/CSharp/CustomTextSource.cs#101)]
+ [!code-vb[TextFormatterExample#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextFormatterExample/VisualBasic/CustomTextSource.vb#101)]  
+  
+> [!NOTE]
+>  この例では、テキスト ストアによりすべてのテキストに対して同じテキスト プロパティが提供されます。  高度なテキスト ストアの場合、個々の文字に異なるプロパティを持たせるために、それぞれのテキスト ストア の範囲管理を実装する必要があります。  
+  
+<a name="section5"></a>   
+## 書式設定プロパティの指定  
+ <xref:System.Windows.Media.TextFormatting.TextRun> オブジェクトは、テキスト ストアによって提供されるプロパティを使用して書式設定されます。  このようなプロパティには、<xref:System.Windows.Media.TextFormatting.TextParagraphProperties> と <xref:System.Windows.Media.TextFormatting.TextRunProperties> の 2 つの型があります。  <xref:System.Windows.Media.TextFormatting.TextParagraphProperties> は、<xref:System.Windows.TextAlignment> や <xref:System.Windows.FlowDirection> などの、段落の包括的なプロパティを処理します。  <xref:System.Windows.Media.TextFormatting.TextRunProperties> は、前景ブラシ、<xref:System.Windows.Media.Typeface>、およびフォント サイズなどの、段落内のそれぞれのテキスト ランで異なるプロパティです。  カスタム段落プロパティ型およびカスタム テキスト ラン プロパティ型を実装するには、アプリケーションでそれぞれ <xref:System.Windows.Media.TextFormatting.TextParagraphProperties> および <xref:System.Windows.Media.TextFormatting.TextRunProperties> から派生するクラスを作成する必要があります。  
+  
+## 参照  
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md b/docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md
new file mode 100644
index 00000000000..0fc30e3915c
--- /dev/null
+++ b/docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md
@@ -0,0 +1,157 @@
+---
+title: "配置、余白、パディングの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エイリアスの使用"
+  - "クラス, FrameworkElement"
+  - "FrameworkElement クラス"
+  - "マージン"
+  - "埋め込み"
+ms.assetid: 9c6a2009-9b86-4e40-8605-0a2664dc3973
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 配置、余白、パディングの概要
+<xref:System.Windows.FrameworkElement> クラスは、子要素を正確に配置するために使用する複数のプロパティを公開します。  ここでは、最も重要な 4 つのプロパティ、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、<xref:System.Windows.FrameworkElement.Margin%2A>、<xref:System.Windows.Controls.Border.Padding%2A>、および <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> について説明します。  これらのプロパティは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーション内での要素の位置を制御するための基本機能を提供するため、その効果について理解しておくことが重要です。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="wcpsdk_layout_amp_introduction"></a>   
+## 要素の配置の概要  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用して要素を配置する方法はいくつもあります。  ただし、適切な <xref:System.Windows.Controls.Panel> 要素を選択するだけでは、理想的なレイアウトを実現することはできません。  配置をきめ細かく制御するには、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、<xref:System.Windows.FrameworkElement.Margin%2A>、<xref:System.Windows.Controls.Border.Padding%2A>、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> の各プロパティについて理解する必要があります。  
+  
+ 複数の配置プロパティを利用するレイアウト シナリオを次の図に示します。  
+  
+ ![WPF 位置決めのプロパティのサンプル](../../../../docs/framework/wpf/advanced/media/layout-margins-padding-alignment-graphic1.png "layout\_margins\_padding\_alignment\_graphic1")  
+  
+ 一見すると、この図の <xref:System.Windows.Controls.Button> 要素は無作為に配置されているように見えます。  しかし、実際には、これらの要素の位置は、余白、配置、およびパディングの組み合わせを使用して正確に制御されています。  
+  
+ 前の図のレイアウトを作成する方法を次の例に示します。  <xref:System.Windows.Controls.Border> 要素は親の <xref:System.Windows.Controls.StackPanel> をカプセル化しており、<xref:System.Windows.Controls.Border.Padding%2A> の値は 15 [デバイス非依存ピクセル](GTMT)に設定されています。  これは、子 <xref:System.Windows.Controls.StackPanel> を囲む狭い <xref:System.Windows.Media.Brushes.LightBlue%2A> の帯の部分を説明しています。  <xref:System.Windows.Controls.StackPanel> の子要素は、このトピックで詳しく説明するさまざまな配置プロパティを示すために使用されます。  3 つの <xref:System.Windows.Controls.Button> 要素を使用して、<xref:System.Windows.FrameworkElement.Margin%2A> プロパティと <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティの効果を示します。  
+  
+ [!code-csharp[MPALayoutSampleIntro#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MPALayoutSampleIntro/CSharp/MPA_Layout_Sample_Intro.cs#1)]
+ [!code-vb[MPALayoutSampleIntro#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MPALayoutSampleIntro/VisualBasic/MPALayoutIntro.vb#1)]  
+  
+ 次の図では、上の例で使用されているさまざまな配置プロパティを拡大して示します。  以下では、各配置プロパティの使用方法を詳しく説明します。  
+  
+ ![画面コールアウトを含む位置決めプロパティ](../../../../docs/framework/wpf/advanced/media/layout-margins-padding-alignment-graphic2.png "layout\_margins\_padding\_alignment\_graphic2")  
+  
+<a name="wcpsdk_layout_amp_alignment_properties"></a>   
+## 配置プロパティの理解  
+ <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティと <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティは、親要素の割り当てられたレイアウト領域内で子要素を配置する方法を記述します。  これらのプロパティを一緒に使用することで、子要素を正確に配置できます。  たとえば、<xref:System.Windows.Controls.DockPanel> の子要素の水平方向の配置については、<xref:System.Windows.HorizontalAlignment>、<xref:System.Windows.HorizontalAlignment>、<xref:System.Windows.HorizontalAlignment>、または <xref:System.Windows.HorizontalAlignment> の 4 種類を指定できます。  垂直方向の配置についても同様の値を指定できます。  
+  
+> [!NOTE]
+>  要素に対して明示的に設定された <xref:System.Windows.FrameworkElement.Height%2A> プロパティと <xref:System.Windows.FrameworkElement.Width%2A> プロパティは、<xref:System.Windows.HorizontalAlignment> プロパティの値より優先されます。  <xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、および `Stretch` の <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> の値を設定しようとしても、`Stretch` 要求は無視されます。  
+  
+<a name="wcpsdk_layout_amp_horizontalalignment_properties"></a>   
+### HorizontalAlignment プロパティ  
+ <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティは、子要素に適用する水平方向の配置の特性を宣言します。  次の表は、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティに指定できる値を示します。  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.HorizontalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の左端に配置します。|  
+|<xref:System.Windows.HorizontalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の中央に配置します。|  
+|<xref:System.Windows.HorizontalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の右端に配置します。|  
+|<xref:System.Windows.HorizontalAlignment> \(既定値\)|子要素を、親要素に割り当てられているレイアウト空間全体に引き伸ばして配置します。  明示的に指定した <xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> の値が優先されます。|  
+  
+ 次の例は、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティを <xref:System.Windows.Controls.Button> 要素に適用する方法を示しています。  さまざまなレンダリング動作をわかりやすく図示するために、各属性の値を表示します。  
+  
+ [!code-csharp[MPALayoutHorizontalAlignment#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MPALayoutHorizontalAlignment/CSharp/MPA_Layout_HorizontalAlignment.cs#2)]
+ [!code-vb[MPALayoutHorizontalAlignment#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MPALayoutHorizontalAlignment/VisualBasic/MPA_Layout_HorizontalAlignment.vb#2)]  
+  
+ 上記のコードの結果、レイアウトは次の図のようになります。  各 <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> の値によって要素がどのように配置されるかを図示しています。  
+  
+ ![HorizontalAlignment のサンプル](../../../../docs/framework/wpf/advanced/media/layout-horizontal-alignment-graphic.png "layout\_horizontal\_alignment\_graphic")  
+  
+<a name="wcpsdk_layout_amp_verticalalignment_properties"></a>   
+### VerticalAlignment プロパティ  
+ <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティは、子要素に適用する垂直方向の配置の特性を記述します。  次の表は、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティに指定できる値を示します。  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.VerticalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の上端に配置します。|  
+|<xref:System.Windows.VerticalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の中央に配置します。|  
+|<xref:System.Windows.VerticalAlignment>|子要素を、親要素に割り当てられているレイアウト空間の下端に配置します。|  
+|<xref:System.Windows.VerticalAlignment> \(既定値\)|子要素を、親要素に割り当てられているレイアウト空間全体に引き伸ばして配置します。  明示的に指定した <xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> の値が優先されます。|  
+  
+ 次の例は、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティを <xref:System.Windows.Controls.Button> 要素に適用する方法を示しています。  さまざまなレンダリング動作をわかりやすく図示するために、各属性の値を表示します。  このサンプルでは、ガイドラインを表示した <xref:System.Windows.Controls.Grid> 要素を親として使用し、各プロパティ値のレイアウト動作がよくわかるようにします。  
+  
+ [!code-csharp[MPALayoutVerticalAlignment#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MPALayoutVerticalAlignment/CSharp/MPA_Layout_VerticalAlignment.cs#2)]
+ [!code-vb[MPALayoutVerticalAlignment#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MPALayoutVerticalAlignment/VisualBasic/MPA_Layout_VerticalAlignment.vb#2)]
+ [!code-xml[MPALayoutVerticalAlignment#2](../../../../samples/snippets/xaml/VS_Snippets_Wpf/MPALayoutVerticalAlignment/XAML/default.xaml#2)]  
+  
+ 上記のコードの結果、レイアウトは次の図のようになります。  各 <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> の値によって要素がどのように配置されるかを図示しています。  
+  
+ ![VerticalAlignment プロパティのサンプル](../../../../docs/framework/wpf/advanced/media/layout-vertical-alignment-graphic.png "layout\_vertical\_alignment\_graphic")  
+  
+<a name="wcpsdk_layout_amp_margin_properties"></a>   
+## 余白プロパティの理解  
+ <xref:System.Windows.FrameworkElement.Margin%2A> プロパティは、要素とその子 \(またはピア\) との間の距離を表します。  `Margin="20"` のような構文を使用することで、<xref:System.Windows.FrameworkElement.Margin%2A> の値を均一にできます。  この構文では、20 [デバイス非依存ピクセル](GTMT)という均一の <xref:System.Windows.FrameworkElement.Margin%2A> が、要素に適用されます。  また、<xref:System.Windows.FrameworkElement.Margin%2A> の値には、`Margin="0,10,5,25"` のような 4 つの値から成る形式を使用することもできます。各値は、左、上、右、下に \(この順序で\) 適用する余白を示します。  <xref:System.Windows.FrameworkElement.Margin%2A> プロパティを適切に使用することで、要素のレンダリング位置、および近隣の要素や子のレンダリング位置を、非常に細かく制御できます。  
+  
+> [!NOTE]
+>  ゼロ以外の余白は、要素の <xref:System.Windows.FrameworkElement.ActualWidth%2A> および <xref:System.Windows.FrameworkElement.ActualHeight%2A> の外側の領域に適用されます。  
+  
+ <xref:System.Windows.Controls.Button> 要素のグループの周囲に均一の余白を適用する方法を次の例に示します。  <xref:System.Windows.Controls.Button> 要素は、各方向に 10 ピクセルの余白を設けて等間隔に配置されます。  
+  
+ [!code-cpp[MarginPaddingAlignmentSample#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CPP/Margin_Padding_Alignment_Sample.cpp#1)]
+ [!code-csharp[MarginPaddingAlignmentSample#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CSharp/Margin_Padding_Alignment_Sample.cs#1)]
+ [!code-vb[MarginPaddingAlignmentSample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MarginPaddingAlignmentSample/VisualBasic/MarginPaddingAlignment.vb#1)]
+ [!code-xml[MarginPaddingAlignmentSample#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/MarginPaddingAlignmentSample/XAML/default.xaml#1)]  
+  
+ 多くのインスタンスでは、均一の余白は適切ではありません。  このような場合は、不均一の間隔を適用できます。  次の例では、子要素に不均一の余白を適用する方法を示します。  余白は、左、上、右、下の順序で記述されています。  
+  
+ [!code-cpp[MarginPaddingAlignmentSample#2](../../../../samples/snippets/cpp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CPP/Margin_Padding_Alignment_Sample.cpp#2)]
+ [!code-csharp[MarginPaddingAlignmentSample#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CSharp/Margin_Padding_Alignment_Sample.cs#2)]
+ [!code-vb[MarginPaddingAlignmentSample#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MarginPaddingAlignmentSample/VisualBasic/MarginPaddingAlignment.vb#2)]
+ [!code-xml[MarginPaddingAlignmentSample#2](../../../../samples/snippets/xaml/VS_Snippets_Wpf/MarginPaddingAlignmentSample/XAML/default.xaml#2)]  
+  
+<a name="wcpsdk_layout_amp_padding_properties"></a>   
+## パディング プロパティの理解  
+ パディングは、多くの点で <xref:System.Windows.FrameworkElement.Margin%2A> に似ています。  パディング プロパティは少数のクラスでのみ、主に利便性向上のため、公開されています。パディング プロパティを公開しているクラスの例としては、<xref:System.Windows.Documents.Block>、<xref:System.Windows.Controls.Border>、<xref:System.Windows.Controls.Control>、<xref:System.Windows.Controls.TextBlock> などがあります。  <xref:System.Windows.Controls.Border.Padding%2A> プロパティは、指定した <xref:System.Windows.Thickness> の値だけ子要素の実質的なサイズを拡大します。  
+  
+ <xref:System.Windows.Controls.Border.Padding%2A> を親 <xref:System.Windows.Controls.Border> 要素に適用する方法を次の例に示します。  
+  
+ [!code-cpp[MarginPaddingAlignmentSample#3](../../../../samples/snippets/cpp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CPP/Margin_Padding_Alignment_Sample.cpp#3)]
+ [!code-csharp[MarginPaddingAlignmentSample#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CSharp/Margin_Padding_Alignment_Sample.cs#3)]
+ [!code-vb[MarginPaddingAlignmentSample#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MarginPaddingAlignmentSample/VisualBasic/MarginPaddingAlignment.vb#3)]
+ [!code-xml[MarginPaddingAlignmentSample#3](../../../../samples/snippets/xaml/VS_Snippets_Wpf/MarginPaddingAlignmentSample/XAML/default.xaml#3)]  
+  
+<a name="wcpsdk_layout_amp_summary"></a>   
+## アプリケーションでの配置、余白、パディングの使用  
+ <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、<xref:System.Windows.FrameworkElement.Margin%2A>、<xref:System.Windows.Controls.Border.Padding%2A>、および <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> は、複雑な[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成するために必要なコントロールの配置機能を提供します。  各プロパティの効果を使用して子要素の配置を変更し、動的なアプリケーションやユーザー環境を柔軟に作成できます。  
+  
+ このトピックで詳しく説明した各概念の例を次に示します。  このトピックの最初のサンプルで示したインフラストラクチャを基にして、この例では、最初のサンプルの <xref:System.Windows.Controls.Border> の子として <xref:System.Windows.Controls.Grid> 要素を追加します。  <xref:System.Windows.Controls.Border.Padding%2A> を親の <xref:System.Windows.Controls.Border> 要素に適用します。  <xref:System.Windows.Controls.Grid> を使用して、3 つの子 <xref:System.Windows.Controls.StackPanel> 要素の間の領域を分割します。  再び <xref:System.Windows.Controls.Button> 要素を使用して、<xref:System.Windows.FrameworkElement.Margin%2A> と <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> のさまざまな効果を示します。  各 <xref:System.Windows.Controls.ColumnDefinition> に <xref:System.Windows.Controls.TextBlock> 要素を追加し、各列の <xref:System.Windows.Controls.Button> 要素に適用するさまざまなプロパティを定義しやすくします。  
+  
+ [!code-cpp[MarginPaddingAlignmentSample#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CPP/Margin_Padding_Alignment_Sample.cpp#4)]
+ [!code-csharp[MarginPaddingAlignmentSample#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarginPaddingAlignmentSample/CSharp/Margin_Padding_Alignment_Sample.cs#4)]
+ [!code-vb[MarginPaddingAlignmentSample#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MarginPaddingAlignmentSample/VisualBasic/MarginPaddingAlignment.vb#4)]
+ [!code-xml[MarginPaddingAlignmentSample#4](../../../../samples/snippets/xaml/VS_Snippets_Wpf/MarginPaddingAlignmentSample/XAML/default.xaml#4)]  
+  
+ コンパイルすると、前のアプリケーションからは次の図に示すような [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が生成されます。  さまざまなプロパティ値の効果が要素間の間隔に示されており、各列の要素に対する重要なプロパティ値は <xref:System.Windows.Controls.TextBlock> 要素内に示されています。  
+  
+ ![1 つのアプリケーション内の複数の位置決めプロパティ](../../../../docs/framework/wpf/advanced/media/layout-margins-padding-aligment-graphic3.png "layout\_margins\_padding\_aligment\_graphic3")  
+  
+<a name="wcpsdk_layout_amp_alignment_whatsnext"></a>   
+## 次の内容  
+ <xref:System.Windows.FrameworkElement> クラスで定義されている配置プロパティを使用すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内の要素の配置をきめ細かく制御できます。  これまでに説明したいくつかの手法を使用すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用して、要素をより適切に配置できます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のレイアウトについてさらに詳細に説明するソースが他にもあります。  「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」トピックでは、さまざまな <xref:System.Windows.Controls.Panel> 要素についてさらに詳しく説明されています。  「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」トピックでは、レイアウト要素を使用してコンポーネントを配置し、そのアクションをデータ ソースにバインドする、高度な手法が紹介されています。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement>   
+ <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>   
+ <xref:System.Windows.FrameworkElement.VerticalAlignment%2A>   
+ <xref:System.Windows.FrameworkElement.Margin%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [WPF レイアウト ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160054)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/annotations-overview.md b/docs/framework/wpf/advanced/annotations-overview.md
new file mode 100644
index 00000000000..97ea58bb753
--- /dev/null
+++ b/docs/framework/wpf/advanced/annotations-overview.md
@@ -0,0 +1,83 @@
+---
+title: "注釈の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 注釈"
+  - "強調表示"
+  - "付箋"
+ms.assetid: 716bf474-29bd-4c74-84a4-8e0744bdad62
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 注釈の概要
+紙に印刷されたドキュメントにメモやコメントを書き込むことは、当然のように行われる一般的な行為です。  これらのメモやコメントは、後で参照するために、情報に目印を付けたり、関心のある項目を強調するためにドキュメントに追加する "注釈" です。  印刷されたドキュメントにメモを書き込むことは簡単で一般的ですが、電子ドキュメントに個人的なコメントを追加する機能は、利用できるとしても、通常は非常に限られています。  
+  
+ ここでは、いくつかの一般的な種類の注釈、特に付箋と強調表示について説明し、[!INCLUDE[TLA#tla_caf](../../../../includes/tlasharptla-caf-md.md)] で [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] ドキュメント表示コントロールを使用することにより、アプリケーションでこれらの種類の注釈を使用できるようにする方法を示します。  注釈をサポートする [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ドキュメント表示コントロールには、<xref:System.Windows.Controls.FlowDocumentReader> や <xref:System.Windows.Controls.FlowDocumentScrollViewer> などがあり、また、<xref:System.Windows.Controls.Primitives.DocumentViewerBase> から派生した <xref:System.Windows.Controls.DocumentViewer> や <xref:System.Windows.Controls.FlowDocumentPageViewer> などのコントロールも含まれます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="caf1_type_stickynotes"></a>   
+## 付箋  
+ 通常の付箋の場合は、色の付いた小さな用紙に情報を書き込み、それをドキュメントに貼り付けます。  デジタル付箋は、電子ドキュメントに対する同様の機能を提供しますが、入力したテキスト、手書きのメモ \(たとえば [!INCLUDE[TLA#tla_tpc](../../../../includes/tlasharptla-tpc-md.md)] の "インク" ストローク\)、Web リンクなど、さまざまな種類のコンテンツを格納できる柔軟性も備えています。  
+  
+ 強調表示、テキスト付箋、およびインク付箋による注釈の例を次の図に示します。  
+  
+ ![強調表示、テキストとインク付箋注釈。](../../../../docs/framework/wpf/advanced/media/caf-stickynote.jpg "CAF\_StickyNote")  
+  
+ アプリケーションで注釈のサポートを有効にするために使用できる方法を次の例に示します。  
+  
+ [!code-csharp[DocViewerAnnotationsXml#DocViewXmlStartAnnotations](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DocViewerAnnotationsXml/CSharp/Window1.xaml.cs#docviewxmlstartannotations)]
+ [!code-vb[DocViewerAnnotationsXml#DocViewXmlStartAnnotations](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DocViewerAnnotationsXml/visualbasic/window1.xaml.vb#docviewxmlstartannotations)]  
+  
+<a name="caf1_type_callouts"></a>   
+## 強調表示  
+ 多くの人は、紙に印刷されたドキュメントに印を付ける場合、関心のある項目を目立たせるために、下線を引く、蛍光ペンで強調する、文中の単語を丸で囲む、余白に記号や注釈を書き込むなど、さまざまな方法を工夫して使用します。  [!INCLUDE[TLA#tla_caf](../../../../includes/tlasharptla-caf-md.md)] での強調表示による注釈は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ドキュメント表示コントロールに表示された情報に印を付けるための、同様の機能を提供します。  
+  
+ 強調表示による注釈の例を次の図に示します。  
+  
+ ![注釈の強調表示](../../../../docs/framework/wpf/advanced/media/caf-callouts.png "CAF\_Callouts")  
+  
+ 通常、ユーザーが注釈を作成する場合には、最初にテキストまたは関心のある項目を選択し、次に右クリックして、注釈オプションの <xref:System.Windows.Controls.ContextMenu> を表示します。  ユーザーが注釈を作成および管理するためにアクセスできるルーティング コマンドを格納した <xref:System.Windows.Controls.ContextMenu> を宣言するために使用できる [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を次の例に示します。  
+  
+ [!code-xml[DocViewerAnnotationsXps#CreateDeleteAnnotations](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DocViewerAnnotationsXps/CSharp/Window1.xaml#createdeleteannotations)]  
+  
+<a name="caf1_framework_data_anchoring"></a>   
+## データ アンカー  
+ [!INCLUDE[TLA2#tla_caf](../../../../includes/tla2sharptla-caf-md.md)] では、注釈は、表示ビュー上の位置に対してだけでなく、ユーザーが選択したデータに対してもバインドされます。  そのため、ドキュメント ビューが変更された場合 \(ユーザーが表示ウィンドウをスクロールまたはサイズ変更した場合など\) でも、注釈はそれがバインドされているデータ選択を保持します。  たとえば、次の図は、ユーザーがテキストを選択して行った注釈を示しています。  ドキュメント ビューが変更 \(スクロール、サイズ変更、スケーリング、または移動\) されると、強調表示による注釈は、元のデータ選択と共に移動します。  
+  
+ ![注釈データ固定](../../../../docs/framework/wpf/advanced/media/caf-dataanchoring.png "CAF\_DataAnchoring")  
+  
+<a name="matching_annotations_with_annotated_objects"></a>   
+## 注釈と注釈先オブジェクトの対応付け  
+ 注釈と、それに応じた注釈先オブジェクトとを対応付けることができます。  たとえば、コメント ペインを持つ簡単なドキュメント リーダー アプリケーションがあるとします。  そのコメント ペインは、そのドキュメントにアンカーされている注釈のリストのテキストを表示するリスト ボックスです。  ユーザーがリスト ボックスの項目を選択すると、対応する注釈オブジェクトがアンカーされているドキュメント内の段落が表示されます。  
+  
+ このようなコメント ペインとして使用するリスト ボックスのイベント ハンドラーを実装する方法を次の例に示します。  
+  
+ [!code-csharp[FlowDocumentAnnotatedViewer#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentAnnotatedViewer/CSharp/Window1.xaml.cs#handler)]
+ [!code-vb[FlowDocumentAnnotatedViewer#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentAnnotatedViewer/visualbasic/window1.xaml.vb#handler)]  
+  
+ 別のサンプル シナリオとしては、ドキュメント リーダー間で注釈および付箋を電子メールで交換できるアプリケーションが考えられます。  この機能があるアプリケーションでは、交換した注釈を含むページにリーダーを移動できます。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Primitives.DocumentViewerBase>   
+ <xref:System.Windows.Controls.DocumentViewer>   
+ <xref:System.Windows.Controls.FlowDocumentPageViewer>   
+ <xref:System.Windows.Controls.FlowDocumentScrollViewer>   
+ <xref:System.Windows.Controls.FlowDocumentReader>   
+ <xref:System.Windows.Annotations.IAnchorInfo>   
+ [注釈スキーマ](../../../../docs/framework/wpf/advanced/annotations-schema.md)   
+ [ContextMenu の概要](../../../../docs/framework/wpf/controls/contextmenu-overview.md)   
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [How to: Add a Command to a MenuItem](http://msdn.microsoft.com/ja-jp/013d68a0-5373-4a68-bd91-5de574307370)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/annotations-schema.md b/docs/framework/wpf/advanced/annotations-schema.md
new file mode 100644
index 00000000000..2c2c32f8735
--- /dev/null
+++ b/docs/framework/wpf/advanced/annotations-schema.md
@@ -0,0 +1,606 @@
+---
+title: "注釈スキーマ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 注釈"
+  - "Microsoft Annotations Framework"
+  - "XML スキーマ定義 (XSD)"
+ms.assetid: a893442b-e220-4603-bf6a-b01fefcb4b37
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 注釈スキーマ
+ここでは、Microsoft Annotations Framework でユーザーの注釈データを保存および取得するために使用される XML スキーマ定義 \(XSD\) について説明します。  
+  
+ [!INCLUDE[TLA2#tla_caf](../../../../includes/tla2sharptla-caf-md.md)] は、注釈データを内部表現から XML 形式に[シリアル化](GTMT)します。  変換に使用される XML 形式は、[!INCLUDE[TLA2#tla_caf](../../../../includes/tla2sharptla-caf-md.md)] XSD スキーマによって記述されます。  スキーマは、アプリケーション間で注釈データを交換するために使用できる、実装に依存しない XML 形式を定義します。  
+  
+ [!INCLUDE[TLA2#tla_caf](../../../../includes/tla2sharptla-caf-md.md)] の XML スキーマ定義は、次の 2 つのサブスキーマで構成されます。  
+  
+-   注釈 XML コア スキーマ \(コア スキーマ\)  
+  
+-   注釈 XML 基本スキーマ \(基本スキーマ\)  
+  
+ コア スキーマ は、<xref:System.Windows.Annotations.Annotation> の主要な XML 構造を定義します。  コア スキーマ内で定義される XML 要素の多くは、<xref:System.Windows.Annotations> 名前空間の型に対応します。  コア スキーマは、アプリケーションが独自の XML データを追加できる 3 つの拡張ポイントを公開します。  この拡張ポイントは、<xref:System.Windows.Annotations.Annotation.Authors%2A>、<xref:System.Windows.Annotations.ContentLocatorPart>、および "Content" です   \(Content 要素は、<xref:System.Xml.XmlElement> リストの形式で提供されます\)。  
+  
+ ここで説明する基本スキーマは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] の初期のリリースに含まれている <xref:System.Windows.Annotations.Annotation.Authors%2A>、<xref:System.Windows.Annotations.ContentLocatorPart> および Content の各型の拡張を定義します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [注釈 XML コア スキーマ](#CoreSchema)  
+  
+-   [注釈 XML 基本スキーマ](#BaseSchema)  
+  
+-   [注釈 XmlStreamStore によって作成される XML のサンプル](#SampleXML)  
+  
+<a name="CoreSchema"></a>   
+## 注釈 XML コア スキーマ  
+ 注釈 XML コア スキーマは、<xref:System.Windows.Annotations.Annotation> オブジェクトの格納に使用される XML 構造を定義します。  
+  
+```  
+<xsd:schema elementFormDefault="qualified" attributeFormDefault="unqualified"  
+            blockDefault="#all"  
+            xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
+            targetNamespace="http://schemas.microsoft.com/windows/annotations/2003/11/core"  
+            xmlns:anc="http://schemas.microsoft.com/windows/annotations/2003/11/core">  
+  
+  <!--  The Annotations element groups a number of annotations.  -->  
+  <xsd:element name="Annotations" type="anc:AnnotationsType" />  
+  
+  <xsd:complexType name="AnnotationsType">  
+    <xsd:sequence>  
+      <xsd:element name="Annotation" minOccurs="0" maxOccurs="unbounded"  
+                   type="anc:AnnotationType" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <!-- AnnotationType defines the structure of the Annotation element. -->  
+  <xsd:complexType name="AnnotationType">  
+    <xsd:sequence>  
+  
+      <!-- List of 0 or more authors. -->  
+      <xsd:element name="Authors" minOccurs="0" maxOccurs="1"  
+                   type="anc:AuthorListType" />  
+  
+      <!-- List of 0 or more anchors. -->  
+      <xsd:element name="Anchors" minOccurs="0" maxOccurs="1"  
+                   type="anc:ResourceListType" />  
+  
+      <!-- List of 0 or more cargos. -->  
+      <xsd:element name="Cargos" minOccurs="0" maxOccurs="1"  
+                   type="anc:ResourceListType" />  
+  
+    </xsd:sequence>  
+  
+    <!-- Unique annotation ID. -->  
+    <xsd:attribute name="Id" type="xsd:string" use="required" />  
+  
+    <!-- Annotation "Type" is used to map the annotation to an annotation  
+         component that takes care of the visual representation of the  
+         annotation.  WPF V1 recognizes three annotation types:  
+  http://schemas.microsoft.com/windows/annotations/2003/11/base:Highlight  
+  http://schemas.microsoft.com/windows/annotations/2003/11/base:TextStickyNote  
+  http://schemas.microsoft.com/windows/annotations/2003/11/base:InkStickyNote  
+    -->  
+    <xsd:attribute name="Type" type="xsd:QName" use="required" />  
+  
+    <!--  Time when the annotation was last modified.  -->  
+    <xsd:attribute name="LastModificationTime" use="optional"  
+                   type="xsd:dateTime" />  
+  
+    <!--  Time when the annotation was created.  -->  
+    <xsd:attribute name="CreationTime" use="optional"  
+                   type="xsd:dateTime" />  
+  </xsd:complexType>  
+  
+  <!-- "Authors" consists of 0 or more elements that represent an author. -->  
+  <xsd:complexType name="AuthorListType">  
+    <xsd:sequence minOccurs="0" maxOccurs="unbounded">  
+      <xsd:element ref="anc:Author" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <!-- The core schema allows any author type. Supported author types  
+       in version 1 (V1) are described in the base schema. -->  
+  <xsd:element name="Author" abstract="true" block="extension restriction"/>  
+  
+  <!-- Both annotation anchor and annotation cargo are represented by the  
+       ResourceListType which contains 0 or more "Resource" elements. -->  
+  <xsd:complexType name="ResourceListType">  
+    <xsd:sequence>  
+      <xsd:element name="Resource" minOccurs="0" maxOccurs="unbounded"  
+                   type="anc:ResourceType" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <!-- Resource groups identification, location  
+       and/or content of some information.  -->  
+  <xsd:complexType name="ResourceType">  
+    <xsd:choice minOccurs="0" maxOccurs="unbounded" >  
+      <xsd:choice>  
+        <xsd:element name="ContentLocator" type="anc:ContentLocatorType" />  
+        <xsd:element name="ContentLocatorGroup" type="anc:ContentLocatorGroupType" />  
+      </xsd:choice>  
+      <xsd:element ref="anc:Content"/>  
+    </xsd:choice>  
+  
+    <!-- Unique resource identifier. -->  
+    <xsd:attribute name="Id" type="xsd:string" use="required" />  
+  
+    <!-- Optional resource name. -->  
+    <xsd:attribute name="Name" type="xsd:string" use="optional" />  
+  </xsd:complexType>  
+  
+  <!-- ContentLocatorGroup contains a set of ContentLocators -->  
+  <xsd:complexType name="ContentLocatorGroupType">  
+    <xsd:sequence>  
+      <xsd:element name="ContentLocator" minOccurs="1" maxOccurs="unbounded"  
+                   type="anc:ContentLocatorType" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <!-- A ContentLocator describes the location or the identification  
+       of particular data within some context.  The ContentLocator consists  
+       of one or more ContentLocatorParts.  Each ContentLocatorPart needs to  
+       be successively applied to the context to arrive at the data.  What  
+       "applying", "context", and "data" mean is application dependent.  
+  -->  
+  <xsd:complexType name="ContentLocatorType">  
+    <xsd:sequence minOccurs="1" maxOccurs="unbounded">  
+      <xsd:element ref="anc:ContentLocatorPart" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <!-- A ContentLocatorPart is a set of "Item" elements.  Each "Item" element  
+       has "Name" and "Value" attributes that define a name/value pair.  
+       ContentLocatorPart is an abstract type that must be restricted for each  
+       concrete ContentLocatorPart definition.  This restriction should define  
+       allowed names and values for the concrete ContentLocatorPart type. That  
+       way the application can define its own way of locating information. The   
+       ContentLocatorPartTypes that are allowed in version 1 (V1) of WPF are  
+       defined in the Annotations Base Schema.  
+  -->  
+  <xsd:element name="ContentLocatorPart" type="anc:ContentLocatorPartType"  
+               abstract="true" />  
+  
+  <xsd:complexType name="ContentLocatorPartType" abstract="true"  
+                   block="restriction">  
+    <xsd:sequence minOccurs="0" maxOccurs="unbounded">  
+      <xsd:element name="Item" type="anc:ItemType" />  
+    </xsd:sequence>  
+  </xsd:complexType>  
+  
+  <xsd:complexType name="ItemType" abstract="true" >  
+    <xsd:attribute name="Name" type='xsd:string' use="required" />  
+    <xsd:attribute name="Value" type='xsd:string' use="optional" />  
+  </xsd:complexType>  
+  
+  <!-- Content describes the underlying content of a resource.  This is an  
+       abstract type that should be redefined for each concrete content type  
+       through restriction.  Allowed content types in WPF version 1 are  
+       defined in the Annotations Base Schema.  
+  -->  
+  <xsd:element name="Content" abstract="true" block="extension restriction"/>  
+  
+</xsd:schema>  
+```  
+  
+<a name="BaseSchema"></a>   
+## 注釈 XML 基本スキーマ  
+ 基本スキーマは、コア スキーマで定義される 3 つの抽象要素 \(<xref:System.Windows.Annotations.Annotation.Authors%2A>、<xref:System.Windows.Annotations.ContentLocatorPart>、および <xref:System.Windows.Annotations.AnnotationResource.Contents%2A>\) の XML 構造を定義します。  
+  
+```  
+<xsd:schema elementFormDefault="qualified" attributeFormDefault="unqualified"  
+     blockDefault="#all"  
+     xmlns:xsd="http://www.w3.org/2001/XMLSchema"  
+     targetNamespace="http://schemas.microsoft.com/windows/annotations/2003/11/base"  
+     xmlns:anb="http://schemas.microsoft.com/windows/annotations/2003/11/base"   
+     xmlns:anc="http://schemas.microsoft.com/windows/annotations/2003/11/core">  
+  
+  <xsd:import schemaLocation="AnnotationCoreV1.xsd"  
+       namespace="http://schemas.microsoft.com/windows/annotations/2003/11/core"/>  
+  
+  <!-- ***** Author ***** -->  
+  <!-- Simple DisplayName Author -->  
+  <xsd:complexType name="StringAuthorType">  
+    <xsd:simpleContent >  
+      <xsd:extension base='xsd:string' />  
+    </xsd:simpleContent>  
+  </xsd:complexType>  
+  <xsd:element name="StringAuthor" type="anb:StringAuthorType"  
+               substitutionGroup="anc:Author"/>  
+  
+  <!-- ***** LocatorParts ***** -->  
+  
+  <!-- Helper types -->  
+  
+  <!-- CountItemNameType - helper type to define count item -->  
+  <xsd:simpleType name="CountItemNameType">  
+    <xsd:restriction base='xsd:string'>  
+      <xsd:pattern value="Count" />  
+    </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- NumberType - helper type to define segment count item -->  
+  <xsd:simpleType name="NumberType">  
+    <xsd:restriction base='xsd:string'>  
+      <xsd:pattern value="\d*" />  
+    </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- SegmentNameType: helper type to define possible segment name types -->  
+  <xsd:simpleType name="SegmentItemNameType">  
+    <xsd:restriction base='xsd:string'>  
+      <xsd:pattern value="Segment\d*" />  
+    </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- Flow Locator Part -->  
+  
+  <!-- FlowSegmentValueItemType: helper type to define flow segment values -->  
+  <xsd:simpleType name="FlowSegmentItemValueType">  
+    <xsd:restriction base='xsd:string'>  
+      <xsd:pattern value=" \d*,\d*" />  
+    </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- FlowItemType -->  
+  <xsd:complexType name="FlowItemType" abstract = "true">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anc:ItemType">  
+      </xsd:restriction>  
+   </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- FlowSegmentItemType -->  
+  <xsd:complexType name="FlowSegmentItemType">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anb:FlowItemType">  
+        <xsd:attribute name="Name" use="required"  
+                       type="anb:SegmentItemNameType"/>  
+        <xsd:attribute name="Value" use="required"  
+                       type="anb:FlowSegmentItemValueType"/>  
+       </xsd:restriction>  
+    </xsd:complexContent>  
+ </xsd:complexType>  
+  
+  <!-- FlowCountItemType -->  
+  <xsd:complexType name="FlowCountItemType">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anb:FlowItemType">  
+        <xsd:attribute name="Name" type="anb:CountItemNameType" use="required"/>  
+        <xsd:attribute name="Value" type="anb:NumberType" use="required"/>  
+       </xsd:restriction>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- CharacterRangeType is an extension of ContentLocatorPartType that locates  
+  *    part of the content within a FlowDocument. CharacterRangeType contains one  
+  *    "Item" element with name "Count" and value the number(N) of "SegmentXX"  
+  *    elements that this ContentLocatorPart has.  It also contains N "Item"  
+  *    elements with name "SegmentXX" where XX is a number from 0 to N-1. The  
+  *    value of each "SegmnetXX" element is a string in the form "offset, length"  
+  *    which locates one sequence of symbols in the FlowDocument. Example:  
+  
+  *        <anb:CharacterRange>  
+  *          <anc:Item Name="Count" Value="2" />  
+  *          <anc:Item Name="Segment0" Value="5,10" />  
+  *          <anc:Item Name="Segment1" Value="25,2" />  
+  *        </anb:ChacterRange>  
+  -->  
+  <xsd:complexType name="CharacterRangeType">  
+    <xsd:complexContent>  
+      <xsd:extension base="anc:ContentLocatorPartType">  
+        <xsd:sequence minOccurs="1" maxOccurs="unbounded">  
+          <xsd:element name="Item" type="anb:FlowItemType" />  
+        </xsd:sequence>  
+      </xsd:extension>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- CharacterRange element substitutes ContentLocatorPart element -->  
+  <xsd:element name="CharacterRange" type="anb:CharacterRangeType"  
+               substitutionGroup="anc:ContentLocatorPart"/>  
+  
+  <!-- Fixed LocatorPart -->  
+  
+  <!-- Helper type – FixedItemType -->  
+  <xsd:complexType name="FixedItemType" abstract = "true">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anc:ItemType">  
+      </xsd:restriction>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- Helper type – FixedCountItemType: ContentLocatorPart items count -->  
+  <xsd:complexType name="FixedCountItemType">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anb:FixedItemType">  
+        <xsd:attribute name="Name" type="anb:CountItemNameType" use="required"/>  
+        <xsd:attribute name="Value" type="anb:NumberType" use="required"/>  
+      </xsd:restriction>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- Helper type -FixedSegmentValue: Defines possible fixed segment values -->  
+  <xsd:simpleType name="FixedSegmentItemValueType">  
+     <xsd:restriction base='xsd:string'>  
+        <xsd:pattern value="\d*,\d*,\d*,\d*" />  
+     </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- Helper type - FixedSegmentItemType -->  
+  <xsd:complexType name="FixedSegmentItemType">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anb:FixedItemType">  
+        <xsd:attribute name="Name" use="required"  
+                       type="anb:SegmentItemNameType"/>  
+        <xsd:attribute name="Value" use="required"  
+                       type="anb:FixedSegmentItemValueType "/>  
+      </xsd:restriction>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- FixedTextRangeType is an extension of ContentLocatorPartType that locates  
+  *    content within a FixedDocument.  It contains one "Item" element with name  
+  *    "Count" and value the number (N) of "Item" elements with name "SegmentXX"  
+  *    that this ContentLocatorPart has.  FixedTextRange locator part also  
+  *    contains N "Item" elements with one attribute Name="SegmentXX" where XX is  
+  *    a number from 0 to N-1 and one attribute "Value" in the form "X1, Y1, X2,  
+  *    Y2".  Here X1,Y1 are the coordinates of the start symbol in this segment,  
+  *    X2,Y2 are the coordinates of the end symbol in this segment.  Example:  
+  *  
+  *        <anb:FixedTextRange>  
+  *          <anc:Item Name="Count" Value="2" />  
+  *          <anc:Item Name="Segment0" Value="10,5,20,5" />  
+  *          <anc:Item Name="Segment1" Value="25,15, 25,20" />  
+  *        </anb:FixedTextRange>  
+  -->  
+  <xsd:complexType name="FixedTextRangeType">  
+     <xsd:complexContent>  
+        <xsd:extension base="anc:ContentLocatorPartType">  
+           <xsd:sequence minOccurs="1" maxOccurs="unbounded">  
+              <xsd:element name="Item" type="anb:FixedItemType" />  
+           </xsd:sequence>  
+       </xsd:extension>  
+     </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- FixedTextRange element substitutes ContentLocatorPart element -->  
+  <xsd:element name="FixedTextRange" type="anb:FixedTextRangeType"  
+               substitutionGroup="anc:ContentLocatorPart"/>  
+  
+  <!-- DataId -->  
+  
+  <!-- ValueItemNameType: helper type to define value item -->  
+  <xsd:simpleType name="ValueItemNameType">  
+    <xsd:restriction base='xsd:string'>  
+      <xsd:pattern value="Value" />  
+    </xsd:restriction>  
+  </xsd:simpleType>  
+  
+  <!-- StringValueItemType -->  
+  <xsd:complexType name="StringValueItemType">  
+     <xsd:complexContent>  
+        <xsd:restriction base="anc:ItemType">  
+           <xsd:attribute name="Name" type="anb:ValueItemNameType" use="required"/>  
+        <xsd:attribute name="Value" type="xsd:string" use="required"/>  
+        </xsd:restriction>  
+     </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <xsd:complexType name="StringValueLocatorPartType">  
+    <xsd:complexContent>  
+      <xsd:extension base="anc:ContentLocatorPartType">  
+        <xsd:sequence minOccurs="1" maxOccurs="1">  
+          <xsd:element name="Item" type="anb:ValueItemType" />  
+        </xsd:sequence>  
+      </xsd:extension>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <!-- DataId element substitutes ContentLocatorPart and is used to locate a  
+  *    subtree in the logical tree.  Including DataId locator part in a  
+  *    ContentLocator helps to narrow down the search for a particular content.  
+  *    Examle of DataId ContentLocatorPart:  
+  *      
+  *        <anb:DataId>  
+  *          <anc:Item Name="Value" Value="FlowDocument" />  
+  *        </anb:DataId>  
+  -->  
+  
+  <xsd:element name="DataId" type="anb: StringValueLocatorPartType "  
+               substitutionGroup="anc:ContentLocatorPart"/>  
+  
+  <!-- PageNumber -->  
+  
+  <!-- NumberValueItemType -->  
+  <xsd:complexType name="NumberValueItemType">  
+    <xsd:complexContent>  
+      <xsd:restriction base="anc:ItemType">  
+        <xsd:attribute name="Name" type="anb:ValueItemNameType" use="required"/>  
+        <xsd:attribute name="Value" type="anb:NumberType" use="required"/>  
+      </xsd:restriction>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <xsd:complexType name="NumberValueLocatorPartType">  
+    <xsd:complexContent>  
+      <xsd:extension base="anc:ContentLocatorPartType">  
+        <xsd:sequence minOccurs="1" maxOccurs="1">  
+          <xsd:element name="Item" type="anb:ValueItemType" />  
+        </xsd:sequence>  
+      </xsd:extension>  
+    </xsd:complexContent>  
+  </xsd:complexType>  
+  
+  <-- PageNumber element substitutes ContentLocatorPart and is used to locate a  
+  *  page in a FixedDocument.  PageNumber ContentLocatorPart is used in  
+  *   conjunction with the FixedTextRange ContentLocatorPart and it shows on with  
+  *   page are the coordinates defined in the FixedTextRange.  
+  *   Example of a PageNumber ContentLocatorPart:  
+  *     
+  *       <anb:PageNumber>  
+  *         <anc:Item Name="Value" Value="1" />  
+  *       </anb:PageNumber>  
+  -->  
+  <xsd:element name="PageNumber" type="anb:NumbnerValueLocatorPartType"  
+               substitutionGroup="anc:ContentLocatorPart"/>  
+  
+  <!-- ***** Content ***** -->  
+  <!-- Highlight colors – defines highlight color for annotations of type  
+  *    Highlight or normal and active anchor colors for annotations of type  
+  *    TextStickyNote and InkStickyNote.   
+  -->  
+  <xsd:complexType name="ColorsContentType">  
+    <xsd:attribute name="Background" type='xsd:string' use="required" />  
+    <xsd:attribute name="ActiveBackground" type='xsd:string' use="optional" />  
+  </xsd:complexType>  
+  
+  <xsd:element name="Colors" type="anb:ColorsContentType"  
+               substitutionGroup="anc:Content"/>  
+  
+  <!-- RTB Text –contains XAML representing StickyNote Reach Text Box text.  
+  *    Used in annotations of type TextStickyNote. -->  
+  <xsd:complexType name="TextContentType">  
+    <!-- See XAML schema for RTB content -->  
+  </xsd:complexType>  
+  
+  <xsd:element name="Text" type="anb:TextContentType"  
+               substitutionGroup="anc:Content"/>  
+  
+  <-- Ink – contains XAML representing Sticky Note ink.  
+  *   Used in annotations of type InkStickyNote. -->  
+  <xsd:complexType name="InkContentType">  
+    <!-- See XAML schema for Ink content -->  
+  </xsd:complexType>  
+  
+  <xsd:element name="Ink" type="anb:InkContentType"  
+               substitutionGroup="anc:Content"/>  
+  
+  <!-- SN Metadata – defines StickyNote attributes as position width, height,  
+  *    etc.  Used in annotations of type TextStickyNote and InkStickyNote. -->  
+  <xsd:complexType name="MetadataContentType">  
+    <xsd:attribute name="Left" type='xsd:decimal' use="optional"  />  
+    <xsd:attribute name="Top" type='xsd:decimal' use="optional" />  
+    <xsd:attribute name="Width" type='xsd:decimal' use="optional" />  
+    <xsd:attribute name="Height" type='xsd:decimal' use="optional" />  
+    <xsd:attribute name="XOffset" type='xsd:decimal' use="optional" />  
+    <xsd:attribute name="YOffset" type='xsd:decimal' use="optional" />  
+    <xsd:attribute name="ZOrder" type='xsd:decimal' use="optional" />  
+  </xsd:complexType>  
+  
+  <xsd:element name="Metadata" type="anb:MetadataContentType"   
+               substitutionGroup="anc:Content"/>  
+  
+</xsd:schema>  
+```  
+  
+<a name="SampleXML"></a>   
+## 注釈 XmlStreamStore によって作成される XML のサンプル  
+ 次に示す XML は、注釈 <xref:System.Windows.Annotations.Storage.XmlStreamStore> の出力と、3 つの注釈 \(強調表示、テキストの付箋、インク付箋\) を含むサンプル ファイルの編成を示しています。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<anc:Annotations  
+     xmlns:anc="http://schemas.microsoft.com/windows/annotations/2003/11/core"  
+     xmlns:anb="http://schemas.microsoft.com/windows/annotations/2003/11/base">  
+  
+  <anc:Annotation Id="d308ea9b-36eb-4cc4-94d0-97634f10f7a2"  
+                  CreationTime="2006-09-13T18:28:51.4465702-07:00"  
+                  LastModificationTime="2006-09-13T18:28:51.4465702-07:00"  
+                  Type="anb:Highlight">  
+    <anc:Anchors>  
+      <anc:Resource Id="4f53661b-7328-4673-8e3f-c53f08b9cd94">  
+        <anc:ContentLocator>  
+          <anb:DataId>  
+            <anc:Item Name="Value" Value="FlowDocument" />  
+          </anb:DataId>  
+          <anb:CharacterRange>  
+            <anc:Item Name="Segment0" Value="600,609" />  
+            <anc:Item Name="Count" Value="1" />  
+          </anb:CharacterRange>  
+        </anc:ContentLocator>  
+      </anc:Resource>  
+    </anc:Anchors>  
+  </anc:Annotation>  
+  
+  <anc:Annotation Id="d7a8d271-387e-4144-9f8b-bc3c97816e5f"  
+                  CreationTime="2006-09-13T18:28:56.7903202-07:00"  
+                  LastModificationTime="2006-09-13T18:28:56.8996952-07:00"  
+                  Type="anb:TextStickyNote">  
+    <anc:Authors>  
+      <anb:StringAuthor>Denise Smith</anb:StringAuthor>  
+    </anc:Authors>  
+  
+    <anc:Anchors>  
+      <anc:Resource Id="dab2560e-6ebd-4ad0-80f9-483356a3be0b">  
+        <anc:ContentLocator>  
+          <anb:DataId>  
+            <anc:Item Name="Value" Value="FlowDocument" />  
+          </anb:DataId>  
+          <anb:CharacterRange>  
+            <anc:Item Name="Segment0" Value="787,801" />  
+            <anc:Item Name="Count" Value="1" />  
+          </anb:CharacterRange>  
+        </anc:ContentLocator>  
+      </anc:Resource>  
+    </anc:Anchors>  
+  
+    <anc:Cargos>  
+      <anc:Resource Id="ea4dbabd-b400-4cf9-8908-5716b410f9e4" Name="Meta Data">  
+        <anb:MetaData anb:ZOrder="0" />  
+      </anc:Resource>  
+    </anc:Cargos>  
+  </anc:Annotation>  
+  
+  <anc:Annotation Id="66803c69-b0d7-4cc3-bdff-cacc1955e806"  
+                  CreationTime="2006-09-13T18:29:03.6653202-07:00"  
+                  LastModificationTime="2006-09-13T18:29:03.7121952-07:00"  
+                  Type="anb:InkStickyNote">  
+    <anc:Authors>  
+      <anb:StringAuthor>Mike Nash</anb:StringAuthor>  
+    </anc:Authors>  
+  
+    <anc:Anchors>  
+      <anc:Resource Id="52251c53-8eeb-4fd7-b8f3-94e78dfc25fa">  
+        <anc:ContentLocator>  
+          <anb:DataId>  
+            <anc:Item Name="Value" Value="FlowDocument" />  
+          </anb:DataId>  
+          <anb:CharacterRange>  
+            <anc:Item Name="Segment0" Value="880,884" />  
+            <anc:Item Name="Count" Value="1" />  
+          </anb:CharacterRange>  
+        </anc:ContentLocator>  
+      </anc:Resource>  
+    </anc:Anchors>  
+  
+    <anc:Cargos>  
+      <anc:Resource Id="11e50b97-8d91-4ff9-82c3-16607b2b552b" Name="Meta Data">  
+        <anb:MetaData anb:ZOrder="1" />  
+      </anc:Resource>  
+    </anc:Cargos>  
+  </anc:Annotation>  
+  
+</anc:Annotations>  
+```  
+  
+## 参照  
+ <xref:System.Windows.Annotations>   
+ <xref:System.Windows.Annotations.Storage>   
+ <xref:System.Windows.Annotations.Annotation>   
+ <xref:System.Windows.Annotations.Storage.AnnotationStore>   
+ <xref:System.Windows.Annotations.Storage.XmlStreamStore>   
+ [注釈の概要](../../../../docs/framework/wpf/advanced/annotations-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/annotations.md b/docs/framework/wpf/advanced/annotations.md
new file mode 100644
index 00000000000..328c38e601e
--- /dev/null
+++ b/docs/framework/wpf/advanced/annotations.md
@@ -0,0 +1,37 @@
+---
+title: "コメント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 注釈"
+  - "強調表示"
+  - "付箋"
+ms.assetid: 232ad0d7-2264-4bed-aae3-10dfde116a9c
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# コメント
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、注釈のドキュメント コンテンツをサポートするドキュメント表示コントロールを提供します。  
+  
+## このセクションの内容  
+ [注釈の概要](../../../../docs/framework/wpf/advanced/annotations-overview.md)  
+ [注釈スキーマ](../../../../docs/framework/wpf/advanced/annotations-schema.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Annotations.Annotation>  
+ <xref:System.Windows.Annotations.AnnotationService>  
+ <xref:System.Windows.Controls.DocumentViewer>  
+  
+## 関連項目  
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/application-startup-time.md b/docs/framework/wpf/advanced/application-startup-time.md
new file mode 100644
index 00000000000..d3582dab87d
--- /dev/null
+++ b/docs/framework/wpf/advanced/application-startup-time.md
@@ -0,0 +1,139 @@
+---
+title: "アプリケーションの起動時間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーションの起動 [WPF]"
+  - "パフォーマンス [WPF], 起動時間"
+  - "スプラッシュ スクリーン [WPF], 起動時間"
+  - "起動時間 [WPF]"
+  - "WPF, 起動時間"
+ms.assetid: f0ec58d8-626f-4d8a-9873-c20f95e08b96
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# アプリケーションの起動時間
+WPF アプリケーションの起動に必要な時間は、大幅に変動する可能性があります。  このトピックでは、Windows Presentation Foundation \(WPF\) アプリケーションの認識される起動時間と実際の起動時間を短縮する方法について説明します。  
+  
+## コールド スタートとウォーム スタートについて  
+ コールド スタートは、システムの再起動後にアプリケーションを初めて起動するとき、またはアプリケーションを起動して閉じた後、時間をおいて再び起動するときに発生します。  アプリケーションが起動するときに、必要なページ \(コード、静的データ、レジストリなど\) が Windows メモリ マネージャーのスタンバイ リストに存在しない場合、ページ フォールトが発生します。  これらのページをメモリに読み込むには、ディスクにアクセスする必要があります。  
+  
+ ウォーム スタートは、主要な共通言語ランタイム \(CLR: Common Language Runtime\) コンポーネント用のページのほとんどが、既にメモリに読み込まれているときに発生し、貴重なディスク アクセス時間が節約されます。  このため、マネージ アプリケーションを再度実行すると、初回よりも短い時間で起動します。  
+  
+## スプラッシュ スクリーンの実装  
+ アプリケーションの起動から最初の UI が表示されるまでにかなりの時間がかかることが避けられない場合は、*スプラッシュ スクリーン*を使用することで、認識される起動時間を最適化します。  この方法により、ユーザーがアプリケーションを起動すると、すぐにイメージが表示されます。  アプリケーションが最初の UI を表示する準備が整うと、スプラッシュ スクリーンはフェード アウトします。  [!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] 以降、<xref:System.Windows.SplashScreen> クラスを使用して、スプラッシュ スクリーンを実装できます。  詳細については、「[スプラッシュ スクリーンを WPF アプリケーションに追加する](../../../../docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md)」を参照してください。  
+  
+ ネイティブな Win32 グラフィックスを使用することで、独自のスプラッシュ スクリーンを実装することもできます。  独自の実装は、<xref:System.Windows.Application.Run%2A> メソッドが呼び出される前に表示します。  
+  
+## 起動コードの分析  
+ コールド スタートに時間がかかる理由を特定します。  ディスク I\/O が原因である可能性がありますが、常にそうとは限りません。  通常は、ネットワーク、Web サービス、ディスクなどの外部リソースの使用を最小限に抑えてください。  
+  
+ テストを始める前に、実行中のアプリケーションやサービスが、マネージ コードまたは WPF コードを使用していないことを確認してください。  
+  
+ 再起動したら、直ちに WPF アプリケーションを起動し、表示されるまでの時間を計測します。  この後、同じアプリケーションを複数回起動し \(ウォーム スタート\)、各回の起動時間が初回よりも短ければ、コールド スタートの問題の原因は I\/O であると判断できます。  
+  
+ アプリケーションのコールド スタートの問題に I\/O が無関係である場合は、アプリケーションが長時間かかる初期化や計算を実行しているか、イベントの完了を待機しているか、起動時に大量の JIT コンパイルを必要としている可能性があります。  以下のセクションでは、これらの状況のいくつかについてさらに詳しく説明します。  
+  
+## モジュールの読み込みの最適化  
+ プロセス エクスプローラー \(Procexp.exe\) や Tlist.exe などのツールを使用して、アプリケーションが読み込むモジュールを調べます。  `Tlist <pid>` コマンドは、プロセスによって読み込まれるすべてのモジュールを表示します。  
+  
+ たとえば、Web に接続しないにもかかわらず System.Web.dll が読み込まれている場合は、アプリケーション内にこのアセンブリを参照するモジュールが含まれています。  この参照が本当に必要かどうかを検討します。  
+  
+ アプリケーションに複数のモジュールがある場合は、それらをマージして単一のモジュールにします。  この方法により、CLR によるアセンブリ読み込みのオーバーヘッドが減少します。  アセンブリ数の減少は、CLR が管理する状態も減少することも意味します。  
+  
+## 初期化処理の延期  
+ メイン アプリケーション ウィンドウが表示されるまで初期化コードの実行を延期することを考慮します。  
+  
+ 初期化はクラス コンストラクター内で実行される場合があり、初期化コードが他のクラスを参照している場合は、多数のクラス コンストラクターが次々に実行される可能性があることに注意してください。  
+  
+## アプリケーションの構成の回避  
+ アプリケーションの構成を回避することを考慮します。  たとえば、アプリケーションの構成要件が単純であるときに、非常に短時間で起動する必要がある場合は、起動時間を短縮する方法として、構成の代わりにレジストリ エントリまたは単純な INI ファイルを使用できます。  
+  
+## GAC の活用  
+ アセンブリがグローバル アセンブリ キャッシュ \(GAC: Global Assembly Cache\) にインストールされていない場合、厳密な名前付きアセンブリのハッシュ検証と Ngen イメージ検証 \(コンピューター上のネイティブ イメージを使用できる場合\) が原因で遅延が発生します。  厳密な名前の検証は、GAC にインストールされているアセンブリに対してはスキップされます。  詳細については、「[Gacutil.exe \(グローバル アセンブリ キャッシュ ツール\)](../../../../docs/framework/tools/gacutil-exe-gac-tool.md)」を参照してください。  
+  
+## Ngen.exe の使用  
+ アプリケーションでのネイティブ イメージ ジェネレーター \(Ngen.exe\) の使用を考慮します。  Ngen.exe の使用は、CPU 消費が減少する代わりにディスク アクセスが増えることを意味します。これは、Ngen.exe によって生成されるネイティブ イメージの方が、MSIL イメージよりも容量が大きい場合が多いためです。  
+  
+ ウォーム スタートの起動時間を短縮するには、アプリケーションで Ngen.exe を常に使用します。これは、アプリケーション コードの JIT コンパイルにかかる CPU コストを回避するためです。  
+  
+ コールド スタートの場合も、Ngen.exe を使用すると有効なことがあります。  これは、JIT コンパイラ \(mscorjit.dll\) を読み込む必要がないためです。  
+  
+ Ngen と JIT モジュールを併用すると、最悪の影響が生じる可能性があります。  これは、mscorjit.dll を読み込む必要があることに加え、JIT コンパイラがアプリケーション コードを処理するためにアセンブリのメタデータを読み込む際に、Ngen イメージ内の多数のページにアクセスする必要があるためです。  
+  
+### Ngen と ClickOnce  
+ アプリケーションの配置方法も、読み込み時間に影響する可能性があります。  [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] によるアプリケーションの配置では、Ngen のサポートはありません。  アプリケーションで Ngen.exe を使用する場合は、Windows インストーラーなどの他の配置機構を使用する必要があります。  
+  
+ 詳細については、「[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../../docs/framework/tools/ngen-exe-native-image-generator.md)」を参照してください。  
+  
+### ベース変更と DLL アドレスの衝突  
+ Ngen.exe を使用する場合は、ネイティブ イメージがメモリに読み込まれる際にベース変更が発生する可能性があることに注意してください。  希望するベース アドレスに DLL を読み込もうとしたときに、そのアドレス範囲が既に割り当て済みであるために DLL を読み込めない場合、Windows ローダーは、その DLL を別のアドレスに読み込みます。これは時間がかかる処理になる可能性があります。  
+  
+ 仮想アドレス ダンプ \(Vadump.exe\) ツールを使用して、すべてのページがプライベートであるモジュールが存在するかどうかを調べることができます。  これに該当する場合、そのモジュールは、別のアドレスにベース変更されている可能性があります。  したがって、それらのページは共有できません。  
+  
+ ベース アドレスを設定する方法の詳細については、「[Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../../docs/framework/tools/ngen-exe-native-image-generator.md)」を参照してください。  
+  
+## Authenticode の最適化  
+ Authenticode 検証によって起動時間は長くなります。  Authenticode 署名があるアセンブリは、証明機関 \(CA: Certification Authority\) を使用して検証する必要があります。  この検証では、最新の証明書失効リストをダウンロードするためにネットワークに複数回接続する必要があるので、時間がかかる可能性があります。  検証では、信頼できるルートに至るパス上の証明書がすべて有効であることも確認します。  これにより、アセンブリの読み込み中に、数秒間の遅延が発生します。  
+  
+ CA 証明書をクライアント コンピューターにインストールするか、可能な場合は Authenticode を使用しないことを考慮します。  アプリケーションが発行者の証拠を必要としないことが明らかな場合は、署名を検証する手間をかける必要はありません。  
+  
+ [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] 以降、Authenticode 検証のバイパスを可能にする構成オプションが用意されています。  これを行うには、次の設定を app.exe.config ファイルに追加します。  
+  
+```  
+<configuration>  
+    <runtime>  
+        <generatePublisherEvidence enabled="false"/>   
+    </runtime>  
+</configuration>  
+```  
+  
+ 詳細については、「[\<generatePublisherEvidence\> 要素](../../../../docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md)」を参照してください。  
+  
+## Windows Vista でのパフォーマンスの比較  
+ Windows Vista のメモリ マネージャーには、SuperFetch というテクノロジが組み込まれています。  SuperFetch は、時間の経過に伴うメモリ使用パターンを分析して、特定のユーザーに適したメモリの内容を決定し、  その内容を常に維持するように動作します。  
+  
+ これは、Windows XP で使用されているプリフェッチ手法とは異なります。プリフェッチでは、使用パターンを分析せずに、データをメモリにプリロードします。  ユーザーが WPF アプリケーションを Windows Vista で頻繁に使用する場合、時間の経過と共に、アプリケーションのコールド スタートの起動時間が短縮される可能性があります。  
+  
+## AppDomains の効率的な使用  
+ 可能な場合はアセンブリをドメイン中立コード領域に読み込み、ネイティブ イメージが存在するのであれば、アプリケーションで作成されるすべての AppDomains でそのネイティブ イメージが使用されるようにします。  
+  
+ 最大限のパフォーマンスを得るには、ドメイン間呼び出しを減らしてドメイン間通信を効率化します。  可能であれば、引数のない呼び出し、または引数がプリミティブ型である呼び出しを使用します。  
+  
+## NeutralResourcesLanguage 属性の使用  
+ <xref:System.Resources.NeutralResourcesLanguageAttribute> を使用して、<xref:System.Resources.ResourceManager> のニュートラル カルチャを指定します。  この方法を使用すると、アセンブリのルックアップの失敗が回避されます。  
+  
+## シリアル化での BinaryFormatter クラスの使用  
+ シリアル化を使用する必要がある場合は、<xref:System.Xml.Serialization.XmlSerializer> クラスの代わりに <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> クラスを使用します。  <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> クラスは、mscorlib.dll アセンブリの基本クラス ライブラリ \(BCL: Base Class Library\) に実装されます。  <xref:System.Xml.Serialization.XmlSerializer> は System.Xml.dll アセンブリに実装されますが、追加の DLL が読み込まれる場合があります。  
+  
+ <xref:System.Xml.Serialization.XmlSerializer> クラスを使用する必要がある場合は、シリアル化アセンブリを事前に生成することで、パフォーマンスを向上させることができます。  
+  
+## 起動後に更新プログラムをチェックする ClickOnce の構成  
+ アプリケーションで [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] を使用する場合は、アプリケーションの起動後に配置サイトの更新プログラムをチェックするように [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] を構成することで、ネットワーク アクセスを回避します。  
+  
+ XAML ブラウザー アプリケーション \(XBAP: XAML Browser Application\) モデルを使用する場合、[!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] は、XBAP が既に [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] のキャッシュに存在する場合でも、配置サイトの更新プログラムのチェックが行われることに注意してください。  詳細については、「[ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)」を参照してください。  
+  
+## PresentationFontCache サービスの自動起動の構成  
+ 再起動後に最初に実行される WPF アプリケーションは PresentationFontCache サービスです。  このサービスは、システム フォントをキャッシュしてフォント アクセスを高速化することで、全体のパフォーマンスを向上させます。  このサービスの起動にはオーバーヘッドが伴うので、一部の制御された環境では、システムの再起動時にこのサービスを自動起動するように構成することを考慮します。  
+  
+## データ バインディングのプログラムによる設定  
+ XAML を使用してメイン ウィンドウの <xref:System.Windows.FrameworkElement.DataContext%2A> を宣言によって設定する代わりに、<xref:System.Windows.Application.OnActivated%2A> メソッドでプログラムによって設定することを考慮します。  
+  
+## 参照  
+ <xref:System.Windows.SplashScreen>   
+ <xref:System.AppDomain>   
+ <xref:System.Resources.NeutralResourcesLanguageAttribute>   
+ <xref:System.Resources.ResourceManager>   
+ [スプラッシュ スクリーンを WPF アプリケーションに追加する](../../../../docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md)   
+ [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../../../docs/framework/tools/ngen-exe-native-image-generator.md)   
+ [\<generatePublisherEvidence\> 要素](../../../../docs/framework/configure-apps/file-schema/runtime/generatepublisherevidence-element.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/attached-events-overview.md b/docs/framework/wpf/advanced/attached-events-overview.md
new file mode 100644
index 00000000000..be38944c672
--- /dev/null
+++ b/docs/framework/wpf/advanced/attached-events-overview.md
@@ -0,0 +1,101 @@
+---
+title: "添付イベントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付イベント [WPF], 定義"
+  - "添付イベント [WPF], シナリオ"
+  - "添付イベントとルーティング イベント [WPF]"
+  - "サポート (添付イベントをルーティング イベントで) [WPF]"
+  - "定義 (添付イベントをルーティング イベントとして) [WPF]"
+  - "処理 (添付イベントを) [WPF]"
+ms.assetid: 2c40eae3-80e4-4a45-ae09-df6c9ab4d91e
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 添付イベントの概要
+[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] は、言語コンポーネントと、*添付イベント*と呼ばれる種類のイベントも定義します。  添付イベントの概念によって、特定のイベントのハンドラーを、実際にそのイベントを定義または継承する要素ではなく任意の要素に追加することができます。  この場合、イベントを発生させる可能性のあるオブジェクトでも、インスタンスを処理する添付先でも、そのイベントを定義したり "所有" したりしません。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックは、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」および「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を既に通読していることを前提としています。  
+  
+<a name="Syntax"></a>   
+## 添付イベントの構文  
+ 添付イベントには [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文を使用します。また、添付イベントの使用に対応できるように、関連するコードでは特定のコーディング パターンを使用する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文では、添付イベントはイベント名だけでなく、所有している型とイベント名をドット \(.\) で区切って指定します。  イベント名にそれが所有する型が付加されるため、添付イベントの構文では、インスタンス化できる任意の要素に添付イベントをアタッチすることができます。  
+  
+ たとえば、ハンドラーをカスタムの `NeedsCleaning` 添付イベントにアタッチする [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文の例を次に示します。  
+  
+ [!code-xml[WPFAquariumSln#AE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquarium/Window1.xaml#ae)]  
+  
+ `aqua:` プレフィクスがあることに注意してください。この例の添付イベントは独自にマップされた xmlns によるカスタム イベントであるため、このプレフィクスが必要です。  
+  
+<a name="WPFImplements"></a>   
+## WPF の添付イベント実装方法  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、添付イベントは <xref:System.Windows.RoutedEvent> フィールドによってサポートされ、発生後はツリーを通じてルーティングされます。  通常、添付イベントの発生元 \(イベントを発生させたオブジェクト\) はシステムまたはサービスのオブジェクトです。したがって、イベントを発生させるコードを実行するオブジェクトは要素ツリーの直接の構成部分ではありません。  
+  
+<a name="Scenarios"></a>   
+## 添付イベントのシナリオ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で添付イベントがよく使用されるのは、サービス レベルでの抽象化が含まれる機能で、これは静的 <xref:System.Windows.Input.Mouse> クラスまたは <xref:System.Windows.Controls.Validation> クラスによって有効にされるイベントなどのためです。  サービスと対話したりサービスを使用したりするクラスでは、イベントを添付イベント構文で使用するか、添付イベントをルーティング イベントとしてクラスによるサービス機能統合の一部とすることができます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には多くの添付イベントが定義されていますが、添付イベントを直接使用または処理するシナリオは限られます。  一般に添付イベントは、アーキテクチャ上の目的を満たしてから、非添付の \([!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベント "ラッパー" によってサポートされる\) ルーティング イベントに転送されます。  
+  
+ たとえば、基になる添付イベント <xref:System.Windows.Input.Mouse.MouseDown?displayProperty=fullName> を特定の <xref:System.Windows.UIElement> でより簡単に処理するには、添付イベント構文を [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] またはコードで使用するのではなく、その <xref:System.Windows.UIElement> で <xref:System.Windows.UIElement.MouseDown> を使用します。  添付イベントは、入力デバイスを将来的に拡張することを可能にすることから、アーキテクチャ上の目的を満たします。  この架空のデバイスは、マウスからの入力をシミュレートする目的で <xref:System.Windows.Input.Mouse.MouseDown?displayProperty=fullName> を発生させるためだけに必要であり、それを行うために <xref:System.Windows.Input.Mouse> から派生する必要はありません。  ただし、このシナリオでは、イベントを処理するコードが必要であり、添付イベントを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で処理することは不適切です。  
+  
+<a name="Handling"></a>   
+## WPF の添付イベント処理  
+ 添付イベントを処理するプロセスと作成するハンドラー コードは、基本的にはルーティング イベントの場合と同じです。  
+  
+ 一般に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付イベントは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のルーティング イベントと大差ありません。  違いは、イベントが発生する場所とクラスからメンバーとして公開される方法 \(これは [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ハンドラー構文にも影響する\) です。  
+  
+ ただし、既に触れたとおり、既存の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 添付イベントは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で処理されることを特に意図していません。  多くの場合、イベントの目的は、複合要素から複合の親要素に状態を報告できるようにすることです。このとき、一般にイベントはコードで発生し、関連する親クラスのクラス処理にも依存します。  たとえば、<xref:System.Windows.Controls.Primitives.Selector> 内の項目は添付 <xref:System.Windows.Controls.Primitives.Selector.Selected> イベントを生成すると見なされます。このイベントは <xref:System.Windows.Controls.Primitives.Selector> クラスによってクラス処理されてから、おそらくは <xref:System.Windows.Controls.Primitives.Selector> クラスによって別のルーティング イベント <xref:System.Windows.Controls.Primitives.Selector.SelectionChanged> に変換されます。  ルーティング イベントとクラス処理の詳細については、「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+<a name="Custom"></a>   
+## 独自の添付イベントをルーティング イベントとして定義する  
+ 共通の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 基本クラスから派生する場合、特定のパターンのメソッドをクラスに含め、基本クラスに既に提供されているユーティリティ メソッドを使用することにより、独自の添付イベントを実装することができます。  
+  
+ パターンは次のとおりです。  
+  
+-   2 つのパラメーターを指定した `Add*Handler` メソッド。  1 番目のパラメーターにはイベントを識別する情報を指定します。イベントの名前は、メソッド名の "\*" 部分に一致する必要があります。  2 番目のパラメーターは、追加するハンドラーです。  メソッドは、戻り値のないパブリックで静的なメソッドである必要があります。  
+  
+-   2 つのパラメーターを指定した `Remove*Handler` メソッド。  1 番目のパラメーターにはイベントを識別する情報を指定します。イベントの名前は、メソッド名の "\*" 部分に一致する必要があります。  2 番目のパラメーターは、削除するハンドラーです。  メソッドは、戻り値のないパブリックで静的なメソッドである必要があります。  
+  
+ `Add*Handler` アクセサー メソッドは、添付イベント ハンドラーの属性が要素で宣言されているときに [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の処理を手助けします。  `Add*Handler` メソッドと `Remove*Handler` メソッドも、添付イベントのイベント ハンドラー ストアにアクセスする手段となります。  
+  
+ この一般的なパターンは、まだフレームワークとして実装するほど厳密なものではありません。というのも、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リーダー実装では、基になるイベントを識別するためにサポート言語とアーキテクチャによって異なる方式が使用される場合があるためです。  これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が添付イベントをルーティング イベントとして実装する理由の 1 つです。イベント \(<xref:System.Windows.RoutedEvent>\) に使用する識別子は、既に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント システムに定義されています。  また、ルーティング イベントは、添付イベントの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 言語レベルの概念においては実装の自然な拡張です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 添付イベントの `Add*Handler` 実装は、ルーティング イベントとハンドラーを引数として指定する <xref:System.Windows.UIElement.AddHandler%2A> 呼び出しで構成されます。  
+  
+ この実装方式とルーティング イベント システム全般では、添付イベントを処理できるのは <xref:System.Windows.UIElement> 派生クラスまたは <xref:System.Windows.ContentElement> 派生クラスに限定されます。これらのクラスのみが <xref:System.Windows.UIElement.AddHandler%2A> を持つことがその理由です。  
+  
+ たとえば、次のコードでは、添付イベントをルーティング イベントとして宣言する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 添付イベント方式を使用して、`NeedsCleaning` 添付イベントを所有者クラス `Aquarium` に定義しています。  
+  
+ [!code-csharp[WPFAquariumSln#AECode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#aecode)]
+ [!code-vb[WPFAquariumSln#AECode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#aecode)]  
+  
+ 添付イベントの識別子フィールド <xref:System.Windows.EventManager.RegisterRoutedEvent%2A> を確立するために使用されるメソッドが、非添付ルーティング イベントを登録するために使用されるメソッドと実際には同じことに注意してください。  すべての添付イベントとルーティング イベントは、一元化された内部ストアに登録されます。  このイベント ストアの実装によって、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」で説明されている "インターフェイスとしてのイベント" という概念が実現されます。  
+  
+<a name="Raising"></a>   
+## WPF 添付イベントの発生  
+ 通常は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に定義された既存の添付イベントをコードから発生させる必要はありません。  これらのイベントは一般的な "サービス" 概念モデルに従い、<xref:System.Windows.Input.InputManager> などのサービス クラスがイベントを発生させる処理を担います。  
+  
+ ただし、<xref:System.Windows.RoutedEvent> を基にする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付イベント モデルに基づいてカスタムの添付イベントを定義する場合は、<xref:System.Windows.UIElement.RaiseEvent%2A> を使用して添付イベントを任意の <xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> から発生させることができます。  ルーティング イベント \(添付または非添付\) を発生させるには、特定の要素をイベント ソースとして要素ツリー内で宣言する必要があります。このソースが <xref:System.Windows.UIElement.RaiseEvent%2A> 呼び出し元として報告されます。  ツリー内のどの要素が発生元として報告されるかを決定することは、作成するサービスの役目です。  
+  
+## 参照  
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)   
+ [WPF における XAML とカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/attached-properties-overview.md b/docs/framework/wpf/advanced/attached-properties-overview.md
new file mode 100644
index 00000000000..2aabea283f8
--- /dev/null
+++ b/docs/framework/wpf/advanced/attached-properties-overview.md
@@ -0,0 +1,151 @@
+---
+title: "添付プロパティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付プロパティ [WPF デザイナー]"
+ms.assetid: 75928354-dc01-47e8-a018-8409aec1f32d
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# 添付プロパティの概要
+添付プロパティはXAML で定義されている概念です。  添付プロパティの目的は、任意のオブジェクトに対して設定可能な一種のグローバル プロパティとして使用することです。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では添付プロパティは従来のプロパティ 「ラッパー」を持たない依存関係プロパティの特殊な形式で一般に定義されます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスの既存の依存関係プロパティの使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  このトピックの例に従うには[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] するアプリケーションの作成方法を XAML を理解していることも必要です。  
+  
+<a name="attached_properties_usage"></a>   
+## 添付プロパティを使用する理由  
+ 添付プロパティの目的の 1 つは、実際には親要素で定義されるプロパティについて、子要素がそれぞれ別の値を指定できるようにすることです。  このシナリオは、たとえば、子要素を[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] にどのように表示するかを子要素から親要素に通知させるという状況に応用されます。  <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> プロパティがその一例です。  <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> プロパティが添付プロパティとして作成されるのは、このプロパティが <xref:System.Windows.Controls.DockPanel> 自体ではなく <xref:System.Windows.Controls.DockPanel> に含まれる要素に対して設定するように設計されているためです。  <xref:System.Windows.Controls.DockPanel> クラスでは、<xref:System.Windows.Controls.DockPanel.DockProperty> という名前の静的 <xref:System.Windows.DependencyProperty> フィールドが定義されており、[添付プロパティ](GTMT)のパブリック アクセサーとして <xref:System.Windows.Controls.DockPanel.GetDock%2A> メソッドと <xref:System.Windows.Controls.DockPanel.SetDock%2A> メソッドが定義されています。  
+  
+<a name="attached_properties_xaml"></a>   
+## XAML での添付プロパティ  
+ XAML では、*AttachedPropertyProvider*.*PropertyName* という構文を使用して添付プロパティを設定します。  
+  
+ 次の XAML <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> を設定する例を示しています :  
+  
+ [!code-xml[PropertiesOvwSupport#APBasicUsage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml#apbasicusage)]  
+  
+ 使用方法が静的プロパティに少し似ていることに注意してください。名前で指定されたインスタンスを参照するのではなく、[添付プロパティ](GTMT)を所有および登録する <xref:System.Windows.Controls.DockPanel> 型を常に参照します。  
+  
+ また構成操作のみですXAML の添付プロパティがマークアップに設定した属性であるためです。  スタイル トリガーなどの値を比較する間接的機能があります \(詳細については" " [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md) を直接 XAML のプロパティを取得できません。  
+  
+### WPF での添付プロパティの実装  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ではUI 表示に関連する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の型になる添付プロパティのほとんどは依存関係プロパティとして実装されます。  添付プロパティは依存関係プロパティが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の概念でありXAML の概念です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付プロパティが依存関係プロパティであるためプロパティ メタデータなどの依存関係プロパティの概念やの既定値をプロパティ メタデータ サポートします。  
+  
+<a name="howused"></a>   
+## 所有する型が添付プロパティを使用する方法  
+ 添付プロパティはどのオブジェクトに対しても設定可能ですが、プロパティを設定することで具体的な結果が得られたり、その値が他のオブジェクトから使用されたりするわけではありません。  大まかにいって、添付プロパティの目的は、さまざまなクラス階層または論理上のリレーションシップから発生するオブジェクトのそれぞれが、添付プロパティを定義する型に対して共通の情報を報告できるようにすることです。  添付プロパティを定義する型は一般に、次のいずれかのモデルに従います。  
+  
+-   添付プロパティを定義する型は、添付プロパティの値を設定する要素の親要素になることができるように設計されています。  この型は、なんらかのオブジェクト ツリー構造に対して内部ロジックを通じて自身の子オブジェクトを反復処理し、値を取得し、その値に対するなんらかの処理を行います。  
+  
+-   添付プロパティを定義する型は、さまざまな親要素およびコンテンツ モデルの子要素として使用されます。  
+  
+-   添付プロパティを定義する型は、サービスを表します。  その他の型は、添付プロパティの値を設定します。  プロパティを設定する要素がサービスのコンテキスト内で評価されるときに、サービス クラスの内部ロジックを通じて添付プロパティの値が取得されます。  
+  
+### 親要素で定義された添付プロパティの例  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が添付プロパティを定義する最も一般的なシナリオは、親要素が子要素のコレクションをサポートすると同時に、親要素が実装した動作の詳細を子要素ごとに別個に報告させるというものです。  
+  
+ <xref:System.Windows.Controls.DockPanel> では <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 添付プロパティが定義され、<xref:System.Windows.Controls.DockPanel> のレンダリング ロジックの一部としてクラス レベルのコードが設定されています \(具体的には <xref:System.Windows.Controls.DockPanel.MeasureOverride%2A> と <xref:System.Windows.Controls.DockPanel.ArrangeOverride%2A>\)。  <xref:System.Windows.Controls.DockPanel> のインスタンスは、直接の子要素が <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> の値を設定しているかどうかを常に確認します。  設定されている場合は、その値を入力とするレンダリング ロジックを、その子要素に適用します。  入れ子になった <xref:System.Windows.Controls.DockPanel> インスタンスは、それぞれ自身の直接の子要素のコレクションを扱いますが、その動作は実装で <xref:System.Windows.Controls.DockPanel> が <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 値を処理する方法によって異なります。  直接の親以外の要素に作用する添付プロパティも、理論的には可能です。  <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 添付プロパティが設定されている要素が、作用対象の <xref:System.Windows.Controls.DockPanel> 親要素を持たない場合も、エラーや例外は発生しません。  これは、グローバル プロパティ値が設定されたけれども、その情報を利用できる親 <xref:System.Windows.Controls.DockPanel> が現在存在しないことを意味します。  
+  
+<a name="attached_properties_code"></a>   
+## コードでの添付プロパティ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付プロパティには、get および set のアクセスを容易にするための標準的な [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] "ラッパー" メソッドはありません。  これは、添付プロパティが設定されたインスタンスの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 名前空間に、その添付プロパティが属しているとは限らないからです。  ただしXAML プロセッサが XAML の解析時にこれらの値を設定する必要があります。  有効な添付プロパティの使用方法をサポートするには添付プロパティの所有者型がフォーム `Get`*PropertyName* と `Set`*PropertyName* の専用アクセサー メソッドを実装する必要があります。  この専用アクセサー メソッドは、コードで添付プロパティを取得または設定するときにも役立ちます。  コードの観点から言うと、添付プロパティは、プロパティ アクセサーではなくメソッド アクセサーを持つバッキング フィールドに似ています。そしてそのバッキング フィールドは、任意のオブジェクトに存在し得るもので、具体的な定義を必要とするものではありません。  
+  
+ コードで添付プロパティを設定する方法を次の例に示します。  この例では、`myCheckBox` は <xref:System.Windows.Controls.CheckBox> クラスのインスタンスです。  
+  
+ [!code-csharp[PropertiesOvwSupport#APCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#apcode)]
+ [!code-vb[PropertiesOvwSupport#APCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#apcode)]  
+  
+ `myCheckBox` がコードの 3 行目で `myDockPanel` の子要素として追加されていない XAML の例と同様にコードの 4 行目も例外は発生しませんがプロパティ値は <xref:System.Windows.Controls.DockPanel> の親と対話していないため何も行われません。  子要素で <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 値が設定されていて、親要素の <xref:System.Windows.Controls.DockPanel> が存在する場合にのみ、レンダリングされたアプリケーション内で有効な動作が実行されます。  この場合、添付プロパティを設定した後でツリーにアタッチすることも、  ツリーにアタッチした後で添付プロパティを設定することもできます。  どちらの操作順序でも結果は同じになります。  
+  
+<a name="attached_properties_metadata"></a>   
+## 添付プロパティのメタデータ  
+ プロパティを登録するときに、<xref:System.Windows.FrameworkPropertyMetadata> を設定してプロパティの特性を指定します。たとえば、プロパティがレンダリングやサイズ測定に影響を及ぼすかどうかを指定します。  通常、[添付プロパティ](GTMT)のメタデータは、[依存プロパティ](GTMT)のメタデータと違いはありません。  オーバーライドで添付プロパティ メタデータに既定値を指定した場合、その値は、オーバーライドしたクラスのインスタンスの暗黙の添付プロパティの既定値となります。  具体的には、なんらかのプロセスが、`Get` メソッド アクセサーを通じて添付プロパティの値をクエリするときに、メタデータを設定したクラスのインスタンスを指定した場合、その添付プロパティの値が他では特に設定されていないときには、既定値が通知されます。  
+  
+ プロパティ値の継承を有効にするときには、添付プロパティ以外の依存関係プロパティではなく、添付プロパティを使用する必要があります。  詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+<a name="custom"></a>   
+## カスタム添付プロパティ  
+  
+<a name="create_attached_properties"></a>   
+### いつ添付プロパティを作成するか  
+ [添付プロパティ](GTMT)を作成するのは、プロパティを定義するクラス以外のクラスでプロパティを設定するための機構が必要な場合です。  この最も一般的なシナリオはレイアウトです。  既存のレイアウト プロパティの例としては、<xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName>、<xref:System.Windows.Controls.Panel.ZIndex%2A?displayProperty=fullName>、<xref:System.Windows.Controls.Canvas.Top%2A?displayProperty=fullName> などがあります。  これによって実現するシナリオは、レイアウト制御要素の子要素として存在する要素が、レイアウト親要素に対して個別にレイアウト要件を表現するというものです。親が添付プロパティとして定義したプロパティ値を、個々の子要素が設定します。  
+  
+ 添付プロパティを使用するシナリオには、この他に、クラスによってサービスを表す場合に、クラスとサービスとをより透過的に統合できるようにするというものがあります。  
+  
+ さらに別のシナリオとしては、[!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)] の [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]のサポート \(**\[プロパティ\]** ウィンドウでの編集など\) に対応するというものもあります。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+ 既に述べたように、プロパティ値の継承を使用する場合には、添付プロパティとして登録する必要があります。  
+  
+<a name="how_do_i_create_attached_properties"></a>   
+### 添付プロパティの作成方法  
+ クラスで定義する[添付プロパティ](GTMT)が、他の型での使用のみを目的としている場合は、このクラスが <xref:System.Windows.DependencyObject> から派生していなくてもかまいません。  ただし添付プロパティの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の全体的なモデルには依存関係プロパティと <xref:System.Windows.DependencyObject> から派生している必要があります。  
+  
+ 添付プロパティを依存関係プロパティとして定義するには、<xref:System.Windows.DependencyProperty> 型の `public` `static` `readonly` フィールドを宣言します。  このフィールドを定義するには、<xref:System.Windows.DependencyProperty.RegisterAttached%2A> メソッドの戻り値を使用します。  フィールド名は、添付プロパティと同じ名前に文字列 `Property` を付加したものである必要があります。識別するフィールドとそのフィールドが表すプロパティに関する、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で確立された命名パターンに従うためです。  添付プロパティ プロバイダーは添付プロパティのアクセサーとして *PropertyName* と `Set`*PropertyName* の静的 `Get` メソッドを提供する必要があります。; 添付プロパティを使用してプロパティ システムでこの操作を行うとが発生します。  
+  
+> [!NOTE]
+>  添付プロパティの get アクセサーを省略すると、そのプロパティのデータ バインディングは、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] や Expression Blend などのデザイン ツールで動作しません。  
+  
+#### Get アクセサー  
+ *PropertyName* アクセサーのシグネチャの `Get` 形式は次のとおりです。:  
+  
+ `public static object Get` *PropertyName* `(object`  `target` `)`  
+  
+-   `target` オブジェクトは、実装内で具体的な型として指定できます。  たとえば、<xref:System.Windows.Controls.DockPanel.GetDock%2A?displayProperty=fullName> メソッドでは、このパラメーターの型が <xref:System.Windows.UIElement> となっています。これは、添付プロパティが <xref:System.Windows.UIElement> インスタンスに対してのみ設定されることになっているからです。  
+  
+-   戻り値は、実装内で具体的な型として指定できます。  たとえば、<xref:System.Windows.Controls.DockPanel.GetDock%2A> メソッドの戻り値の型は <xref:System.Windows.Controls.Dock> ですが、この値はその列挙体にのみ設定可能だからです。  
+  
+#### Set アクセサー  
+ *PropertyName* アクセサーのシグネチャの `Set` 形式は次のとおりです。:  
+  
+ `public static void Set` *PropertyName* `(object`  `target` `, object`  `value` `)`  
+  
+-   `target` オブジェクトは、実装内で具体的な型として指定できます。  たとえば、<xref:System.Windows.Controls.DockPanel.SetDock%2A> メソッドのこのオブジェクトの型は <xref:System.Windows.UIElement> となっています。これは、添付プロパティが <xref:System.Windows.UIElement> インスタンスに対してのみ設定されることになっているからです。  
+  
+-   `value` オブジェクトは、実装の中で具体的な型として指定できます。  たとえば、<xref:System.Windows.Controls.DockPanel.SetDock%2A> メソッドのこのパラメーターの型は <xref:System.Windows.Controls.Dock> となっています。この値は、その列挙体にのみ設定可能だからです。  マークアップの添付プロパティの添付プロパティが検出されたときにこのメソッドの値はXAML ローダーからの入力であることに注意してください。  入力はマークアップで XAML 属性値として指定される値です。  したがって、属性値 \(最終的には文字列\) から適切な型を作成するには、使用する型でサポートされる型変換、値のシリアライザー、またはマークアップ拡張機能が必要です。  
+  
+ 次の例では依存関係プロパティの登録 \(<xref:System.Windows.DependencyProperty.RegisterAttached%2A> のメソッドを使用\) と*PropertyName* と `Get` `Set`*PropertyName* のアクセサーを示します。  この例では、添付プロパティ名は `IsBubbleSource` です。  したがって、アクセサーの名前は `GetIsBubbleSource` および `SetIsBubbleSource` となります。  
+  
+ [!code-csharp[WPFAquariumSln#RegisterAttachedBubbler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#registerattachedbubbler)]
+ [!code-vb[WPFAquariumSln#RegisterAttachedBubbler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#registerattachedbubbler)]  
+  
+#### 添付プロパティの属性  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_netframewkattr#plural](../../../../includes/tla2sharptla-netframewkattrsharpplural-md.md)] がいくつか定義されています。これらは、リフレクション プロセス、およびリフレクションとプロパティ情報の一般的なユーザー \(デザイナーなど\) に対して、添付プロパティについての情報を提供することを目的としています。  添付プロパティはスコープの型であるためを XAML を使用する特定の技術の実装で定義されているすべての添付プロパティのグローバル リストを含む圧倒的なユーザーを回避する方法が必要です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が添付プロパティに対して定義する [!INCLUDE[TLA2#tla_netframewkattr#plural](../../../../includes/tla2sharptla-netframewkattrsharpplural-md.md)] を使用することで、特定の添付プロパティをプロパティ ウィンドウに表示するかどうかという状況に対応できます。  これらの属性は、独自のカスタム添付プロパティに適用することもできます。  [!INCLUDE[TLA2#tla_netframewkattr#plural](../../../../includes/tla2sharptla-netframewkattrsharpplural-md.md)] の目的と構文については、以下の該当するリファレンス ページを参照してください。  
+  
+-   <xref:System.Windows.AttachedPropertyBrowsableAttribute>  
+  
+-   <xref:System.Windows.AttachedPropertyBrowsableForChildrenAttribute>  
+  
+-   <xref:System.Windows.AttachedPropertyBrowsableForTypeAttribute>  
+  
+-   <xref:System.Windows.AttachedPropertyBrowsableWhenAttributePresentAttribute>  
+  
+<a name="more"></a>   
+## 添付プロパティの詳細情報  
+  
+-   添付プロパティの作成方法の詳細については[添付プロパティを登録する](../../../../docs/framework/wpf/advanced/how-to-register-an-attached-property.md) を参照してください。  
+  
+-   依存関係プロパティと添付プロパティの使用方法のより高度なシナリオについては、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+-   プロパティを添付プロパティおよび依存関係プロパティとして登録するけれども "ラッパー" 実装も公開するということも可能です。  この場合プロパティは XAML の添付プロパティの構文によって設定するとその要素または要素のです。  標準の使用法と添付での使用法の両方について適切なシナリオを持つプロパティの例が、<xref:System.Windows.FrameworkElement.FlowDirection%2A?displayProperty=fullName> です。  
+  
+## 参照  
+ <xref:System.Windows.DependencyProperty>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [添付プロパティを登録する](../../../../docs/framework/wpf/advanced/how-to-register-an-attached-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/base-elements-how-to-topics.md b/docs/framework/wpf/advanced/base-elements-how-to-topics.md
new file mode 100644
index 00000000000..8d18096cc50
--- /dev/null
+++ b/docs/framework/wpf/advanced/base-elements-how-to-topics.md
@@ -0,0 +1,48 @@
+---
+title: "基本要素に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "基本要素"
+ms.assetid: 09f3a88d-b132-4505-a8bb-55cbfc6bb55a
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# 基本要素に関する「方法」トピック
+このセクションのトピックでは、WPF の 4 つの基本要素である <xref:System.Windows.UIElement>、<xref:System.Windows.ContentElement>、<xref:System.Windows.FrameworkElement>、および <xref:System.Windows.FrameworkContentElement> の使用方法について説明します。  
+  
+## このセクションの内容  
+ [UIElement を透明または半透明にする](../../../../docs/framework/wpf/advanced/how-to-make-a-uielement-transparent-or-semi-transparent.md)  
+ [FrameworkElement のサイズをアニメーション化する](../../../../docs/framework/wpf/advanced/how-to-animate-the-size-of-a-frameworkelement.md)  
+ [Freezable が固定されているかどうかを判別する](../../../../docs/framework/wpf/advanced/how-to-determine-whether-a-freezable-is-frozen.md)  
+ [読み込まれたイベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-a-loaded-event.md)  
+ [要素およびコントロールのマージンを設定する](../../../../docs/framework/wpf/advanced/how-to-set-margins-of-elements-and-controls.md)  
+ [Freezable を読み取り専用にする](../../../../docs/framework/wpf/advanced/how-to-make-a-freezable-read-only.md)  
+ [読み取り専用の Freezable の書き込み可能なコピーを取得する](../../../../docs/framework/wpf/advanced/how-to-obtain-a-writable-copy-of-a-read-only-freezable.md)  
+ [UIElement を左右または上下に反転させる](../../../../docs/framework/wpf/advanced/how-to-flip-a-uielement-horizontally-or-vertically.md)  
+ [ThicknessConverter オブジェクトを使用する](../../../../docs/framework/wpf/advanced/how-to-use-a-thicknessconverter-object.md)  
+ [ContextMenuOpening イベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-the-contextmenuopening-event.md)  
+  
+## 関連項目  
+ <xref:System.Windows.UIElement>  
+  
+ <xref:System.Windows.ContentElement>  
+  
+ <xref:System.Windows.FrameworkElement>  
+  
+ <xref:System.Windows.FrameworkContentElement>  
+  
+## 関連項目  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/base-elements-overview.md b/docs/framework/wpf/advanced/base-elements-overview.md
new file mode 100644
index 00000000000..fe1ea5c50f1
--- /dev/null
+++ b/docs/framework/wpf/advanced/base-elements-overview.md
@@ -0,0 +1,112 @@
+---
+title: "基本要素の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "基本要素"
+ms.assetid: 2c997092-72c6-4767-bc84-74267f4eee72
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 基本要素の概要
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のクラスの大部分は、[!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] のドキュメントで一般に基本要素クラスと呼ばれている 4 つのクラスから派生しています。  このようなクラスとしては、<xref:System.Windows.UIElement>、<xref:System.Windows.FrameworkElement>、<xref:System.Windows.ContentElement>、および <xref:System.Windows.FrameworkContentElement> があります。  <xref:System.Windows.DependencyObject> クラスも関連がありますが、これは <xref:System.Windows.UIElement> と <xref:System.Windows.ContentElement> の両方に共通する基本クラスであるためです。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="base_apis"></a>   
+## WPF クラスの基本要素 API  
+ <xref:System.Windows.UIElement> および <xref:System.Windows.ContentElement> は、どちらも <xref:System.Windows.DependencyObject> から派生していますが、その方法は多少異なります。  このレベルでの相違点は、<xref:System.Windows.UIElement> や <xref:System.Windows.ContentElement> がユーザー インターフェイスで使用される方法と、それらがアプリケーション内で使用される目的に関するものです。  <xref:System.Windows.UIElement> のクラス階層構造内には <xref:System.Windows.Media.Visual> も存在します。これは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の基礎となる低レベルのグラフィックス サポートを公開するクラスです。  <xref:System.Windows.Media.Visual> は、独立した四角形の画面領域を定義することにより、レンダリングのフレームワークを提供します。  実際には、<xref:System.Windows.UIElement> は比較的大きなオブジェクト モデルをサポートし、四角形の画面領域として記述できる領域にレンダリングおよびレイアウトされるように設計されている要素のためのものです。そのコンテンツ モデルは、さまざまな要素の組み合わせが可能なように、意図的にオープンに作られています。  <xref:System.Windows.ContentElement> は <xref:System.Windows.Media.Visual> から派生していません。そのモデルでは、<xref:System.Windows.ContentElement> は、リーダーやビューアーなど、他のものによって処理されます。これらのリーダーやビューアーなどは、要素を解釈し、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] が処理する完全な <xref:System.Windows.Media.Visual> を生成します。  一部の <xref:System.Windows.UIElement> クラスは、コンテンツ ホストとなるように設計されています。それらのクラスは、1 つ以上の <xref:System.Windows.ContentElement> クラスに対して、ホスティングとレンダリングを提供します \(そのようなクラスの例として、<xref:System.Windows.Controls.DocumentViewer> があります\)。  <xref:System.Windows.ContentElement> は、比較的小さなオブジェクト モデルを持ち、<xref:System.Windows.UIElement> 内にホストされるテキスト、情報、またはドキュメントのコンテンツ向けに使用されることの多い要素の基本クラスとして使用されます。  
+  
+### フレームワークレベルとコアレベル  
+ <xref:System.Windows.UIElement> は、<xref:System.Windows.FrameworkElement> の基本クラスとして使用され、<xref:System.Windows.ContentElement> は、<xref:System.Windows.FrameworkContentElement> の基本クラスとして使用されます。  この第 2 レベルのクラスが存在する理由は、[WPF フレームワーク レベル](GTMT)とは異なる [WPF コア レベル](GTMT)をサポートすることです。この区分は、PresentationCore と PresentationFramework アセンブリ間での [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の区分にも存在します。  [WPF フレームワーク レベル](GTMT)は、表示のためのレイアウト マネージャーの実装など、アプリケーションの基本的ニーズに対して、より完全なソリューションを提供します。  [WPF コア レベル](GTMT)は、アセンブリの追加によるオーバーヘッドを引き起こすことなく [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の大部分を使用する方法を提供します。  これらのレベルの区別は、ほとんどの通常のアプリケーション開発シナリオでほとんど問題になりません。一般には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を 1 つのものと見なして、[WPF フレームワーク レベル](GTMT)と [WPF コア レベル](GTMT)の違いについて意識する必要はありません。  アプリケーション設計で [WPF フレームワーク レベル](GTMT)の機能の大部分を置き換えることにした場合、たとえば開発中のソリューション全体に、独自の [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の構成およびレイアウトが既に実装されている場合には、これらのレベルの区分に関する理解が必要となる可能性があります。  
+  
+<a name="subclassing_elements"></a>   
+## 派生元の要素を選択する  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を拡張したカスタム クラスを作成するための最も実際的な方法は、既存のクラス階層から必要な機能を可能な限り得ることのできる、いずれかの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラスから派生させることです。  このセクションでは、継承元とするクラスの選択に役立つように、最も重要な要素クラスのうちの 3 つのクラスが提供する機能を示します。  
+  
+ コントロールを実装する場合には \([!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラスから派生させる理由としてはこれが実際のところ最も一般的なものですが\)、実用的なコントロールであるクラス、コントロール ファミリの基本クラス、または少なくとも <xref:System.Windows.Controls.Control> 基本クラスから派生させるのが一般的です。  いくつかのガイドラインと実際の例については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+ コントロールを作成しているのではなく、階層の上位にあるクラスから派生する必要がある場合は、各基本要素クラスに定義された特性に関するガイドを意図した、以下のセクションを参照してください。  
+  
+ <xref:System.Windows.DependencyObject> から派生するクラスを作成すると、次の機能が継承されます。  
+  
+-   <xref:System.Windows.DependencyObject.GetValue%2A> と <xref:System.Windows.DependencyObject.SetValue%2A> のサポート、およびプロパティ システム全体のサポート。  
+  
+-   [依存関係プロパティ](GTMT)と、[依存関係プロパティ](GTMT)として実装されている[添付プロパティ](GTMT)を使用する機能。  
+  
+ <xref:System.Windows.UIElement> から派生するクラスを作成する場合は、<xref:System.Windows.DependencyObject> によって提供される機能以外に、次の機能を継承します。  
+  
+-   アニメーション化されたプロパティ値の基本的なサポート。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+-   基本的な入力イベントのサポートと、コマンド実行のサポート。  詳細については、「[入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)」および「[コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)」を参照してください。  
+  
+-   レイアウト システムに情報を提供するためにオーバーライドできる仮想メソッド。  
+  
+ <xref:System.Windows.FrameworkElement> から派生するクラスを作成する場合は、<xref:System.Windows.UIElement> によって提供される機能以外に、次の機能を継承します。  
+  
+-   スタイル設定とストーリーボードのサポート。  詳細については、「<xref:System.Windows.Style>」および「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+-   データ バインディングのサポート。  詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+-   動的リソース参照のサポート。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+-   プロパティ値継承のサポート、および、データ バインディング、スタイル、またはレイアウトのフレームワークの実装などのフレームワーク サービスのプロパティに関する条件をレポートする場合に役立つ、メタデータ内の他のフラグ。  詳細については、「[フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)」を参照してください。  
+  
+-   [論理ツリー](GTMT)の概念。  詳細については、「[WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)」を参照してください。  
+  
+-   レイアウトに影響を与えるプロパティの変更を検出できる <xref:System.Windows.FrameworkElement.OnPropertyChanged%2A> オーバーライドなど、レイアウト システムの実際的な [WPF フレームワーク レベル](GTMT)の実装のサポート。  
+  
+ <xref:System.Windows.ContentElement> から派生するクラスを作成する場合は、<xref:System.Windows.DependencyObject> によって提供される機能以外に、次の機能を継承します。  
+  
+-   アニメーションのサポート。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+-   基本的な入力イベントのサポートと、コマンド実行のサポート。  詳細については、「[入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)」および「[コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.FrameworkContentElement> から派生するクラスを作成する場合は、<xref:System.Windows.ContentElement> によって提供される機能以外に、次の機能を使用できます。  
+  
+-   スタイル設定とストーリーボードのサポート。  詳細については、「<xref:System.Windows.Style>」および「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+-   データ バインディングのサポート。  詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+-   動的リソース参照のサポート。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+-   プロパティ値継承のサポート、および、データ バインディング、スタイル、またはレイアウトのフレームワークの実装などのフレームワーク サービスのプロパティに関する条件をレポートする場合に役立つ、メタデータ内の他のフラグ。  詳細については、「[フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)」を参照してください。  
+  
+-   レイアウト システムの変更 \(たとえば <xref:System.Windows.FrameworkElement.ArrangeOverride%2A>\) へのアクセスは継承されません。  レイアウト システムの実装は、<xref:System.Windows.FrameworkElement> でのみ利用できます。  ただし、レイアウトに影響を与えるプロパティの変更を検出し、それらの変更を任意のコンテンツ ホストに報告できる <xref:System.Windows.FrameworkElement.OnPropertyChanged%2A> オーバーライドは継承されます。  
+  
+ さまざまなクラスに関してコンテンツ モデルが文書化されています。  派生元として適切なクラスを見つける必要がある場合、クラスのコンテンツ モデルは、考慮する必要がある項目の候補の 1 つです。  詳細については、「[WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)」を参照してください。  
+  
+<a name="other_base_classes"></a>   
+## 他の基本クラス  
+  
+### DispatcherObject  
+ <xref:System.Windows.Threading.DispatcherObject> は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] スレッド処理モデルのサポートを提供し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのために作成されたすべてのオブジェクトが <xref:System.Windows.Threading.Dispatcher> に関連付けられるようにします。  <xref:System.Windows.UIElement>、<xref:System.Windows.DependencyObject>、または <xref:System.Windows.Media.Visual> から派生しない場合でも、このスレッド処理モデルのサポートを可能にするために <xref:System.Windows.Threading.DispatcherObject> から派生することを検討してください。  詳細については、「[スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)」を参照してください。  
+  
+### Visual  
+ <xref:System.Windows.Media.Visual> は、四角形に近い表示形式を必要とする 2D オブジェクトの概念を実装します。  <xref:System.Windows.Media.Visual> の実際の描画は他のクラスで行われます \(単一のクラスですべての操作が完結しません\) が、<xref:System.Windows.Media.Visual> クラスは、描画プロセスのさまざまなレベルで使用される既知の型を提供します。  <xref:System.Windows.Media.Visual> はヒット テストを実装しますが、ヒット テストの結果を報告するイベントは公開しません \(このイベントは <xref:System.Windows.UIElement> にあります\)。  詳細については、「[ビジュアル層のプログラミング](../../../../docs/framework/wpf/graphics-multimedia/visual-layer-programming.md)」を参照してください。  
+  
+### Freezable  
+ <xref:System.Windows.Freezable> は、変更できないオブジェクトが必要なときやパフォーマンス上の理由で望ましいときにオブジェクトのコピーを生成する手段を提供することにより、変更できるオブジェクト上で不変性をシミュレートします。  <xref:System.Windows.Freezable> 型は、ジオメトリ、ブラシ、アニメーションなどの特定のグラフィックス要素に使用できる共通の基盤です。  <xref:System.Windows.Freezable> は <xref:System.Windows.Media.Visual> ではありません。これには、別のオブジェクトのプロパティ値を設定するために <xref:System.Windows.Freezable> が適用されるときにサブプロパティとなるプロパティを格納できます。これらのサブプロパティは、描画に影響することがあります。  詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.Animation.Animatable>  
+  
+ <xref:System.Windows.Media.Animation.Animatable> は、<xref:System.Windows.Freezable> 派生クラスであり、このクラスによってアニメーション コントロール層とユーティリティ メンバーが追加され、現在のアニメーション プロパティを非アニメーション プロパティから区別できるようになります。  
+  
+### Control  
+ <xref:System.Windows.Controls.Control> は、あるテクノロジではコントロールと呼ばれ、別のテクノロジではコンポーネントと呼ばれる種類のオブジェクトの基本クラスとして意図されています。  一般に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール クラスは、UI コントロールを直接表すクラスか、コントロールの複合に密接に参加するクラスです。  <xref:System.Windows.Controls.Control> が主に提供する機能は、コントロールのテンプレート作成です。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Control>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)   
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/base-elements.md b/docs/framework/wpf/advanced/base-elements.md
new file mode 100644
index 00000000000..d947dfbb631
--- /dev/null
+++ b/docs/framework/wpf/advanced/base-elements.md
@@ -0,0 +1,50 @@
+---
+title: "基本要素 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "基本要素"
+ms.assetid: 55034aa5-3c1d-442a-8293-f4692d8ea6ae
+caps.latest.revision: 70
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# 基本要素
+4 つの主要クラス、<xref:System.Windows.UIElement>、<xref:System.Windows.ContentElement>、<xref:System.Windows.FrameworkElement>、および <xref:System.Windows.FrameworkContentElement> は、WPF プログラミングで使用できる共通要素の機能の大部分を実装しています。  この SDK では、これら 4 つのクラスは基本要素クラスと呼ばれます。  
+  
+## このセクションの内容  
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)  
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)  
+ [配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/base-elements-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.UIElement>  
+  
+ <xref:System.Windows.ContentElement>  
+  
+ <xref:System.Windows.FrameworkElement>  
+  
+ <xref:System.Windows.FrameworkContentElement>  
+  
+## 関連項目  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [WPF の XAML](../../../../docs/framework/wpf/advanced/xaml-in-wpf.md)  
+ [要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)  
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)  
+ [イベント](../../../../docs/framework/wpf/advanced/events-wpf.md)  
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)  
+ [リソース](../../../../docs/framework/wpf/advanced/resources-wpf.md)  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/bidirectional-features-in-wpf-overview.md b/docs/framework/wpf/advanced/bidirectional-features-in-wpf-overview.md
new file mode 100644
index 00000000000..90f5624f4eb
--- /dev/null
+++ b/docs/framework/wpf/advanced/bidirectional-features-in-wpf-overview.md
@@ -0,0 +1,288 @@
+---
+title: "WPF の双方向機能の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "双方向機能"
+  - "FlowDirection プロパティ"
+  - "FlowDocument プロパティ"
+  - "Span 要素"
+ms.assetid: fd850e25-7dba-408c-b521-8873e51dc968
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# WPF の双方向機能の概要
+他のどの開発プラットフォームとも異なり、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には双方向コンテンツ \(たとえば、同じドキュメント内で左から右へ記述される情報と右から左へ記述される情報が混在している状態\) の迅速な開発をサポートする多数の機能があります。  また [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、アラビア語やヘブライ語を扱うユーザーなど双方向機能を必要とするユーザーにとって、操作性が優れています。  
+  
+ 以降のセクションでは、多数の双方向機能と双方向コンテンツを最適に表示した例について説明します。  この概念は [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] コードまたは [!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] コードに容易に適用できますが、ほとんどのサンプルでは [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] を使用します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="FlowDirection"></a>   
+## FlowDirection  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでのコンテンツのフロー方向を定義する基本プロパティが <xref:System.Windows.FrameworkElement.FlowDirection%2A> です。  このプロパティは 2 つの列挙値のいずれか、つまり <xref:System.Windows.FlowDirection> または <xref:System.Windows.FlowDirection> に設定できます。  このプロパティは、<xref:System.Windows.FrameworkElement> を継承するすべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素に対して使用できます。  
+  
+ 以下の例は、<xref:System.Windows.Controls.TextBox> 要素のフロー方向を設定したものです。  
+  
+ **左から右へ記述するフロー方向**  
+  
+ [!code-xml[LTRRTL#LTR](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LTRRTL/CS/Pane1.xaml#ltr)]  
+  
+ **右から左へ記述するフロー方向**  
+  
+ [!code-xml[LTRRTL#RTL](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LTRRTL/CS/Pane1.xaml#rtl)]  
+  
+ 次の図は、前のコードがどのように表示されるのかを示します。  
+  
+ **FlowDirection を示す図**  
+  
+ ![TextBlock 配置](../../../../docs/framework/wpf/advanced/media/lefttorightrighttoleft.png "LefttoRightRighttoLeft")  
+  
+ [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] ツリー内の要素が <xref:System.Windows.FrameworkElement.FlowDirection%2A> をそのコンテナーから継承します。  次の例では、<xref:System.Windows.Controls.TextBlock> が、<xref:System.Windows.Window> に存在する <xref:System.Windows.Controls.Grid> 内にあります。  <xref:System.Windows.Window> に対して <xref:System.Windows.FrameworkElement.FlowDirection%2A> を設定することは、<xref:System.Windows.Controls.Grid> と <xref:System.Windows.Controls.TextBlock> に対しても設定することを意味します。  
+  
+ 次の例では、<xref:System.Windows.FrameworkElement.FlowDirection%2A> の設定を示します。  
+  
+ [!code-xml[FlowDirection#FlowDirection](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDirection/CS/Window1.xaml#flowdirection)]  
+  
+ また、最上位の <xref:System.Windows.Window> には <xref:System.Windows.FlowDirection> <xref:System.Windows.FlowDirection> があるため、これに格納されているすべての要素も同じ <xref:System.Windows.FrameworkElement.FlowDirection%2A> を継承します。  要素が指定された <xref:System.Windows.FrameworkElement.FlowDirection%2A> を上書きするためには、前の例で <xref:System.Windows.FlowDirection> に変更された 2 番目の <xref:System.Windows.Controls.TextBlock> などの明示的な方向変更を追加する必要があります。  <xref:System.Windows.FrameworkElement.FlowDirection%2A> が定義されていない場合、既定の <xref:System.Windows.FlowDirection> が適用されます。  
+  
+ 前の例の出力を次の図に示します。  
+  
+ **明示的に割り当てられた FlowDirection を示す図**  
+  
+ ![フロー方向の図](../../../../docs/framework/wpf/advanced/media/flowdir.png "FlowDir")  
+  
+<a name="FlowDocument"></a>   
+## FlowDocument  
+ [!INCLUDE[TLA#tla_html](../../../../includes/tlasharptla-html-md.md)]、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)]、Java などの多数の開発プラットフォームは、双方向コンテンツ開発を特別にサポートしています。  [!INCLUDE[TLA#tla_html](../../../../includes/tlasharptla-html-md.md)] などのマークアップ言語では、コンテンツの作成者が任意の必要な方向にテキストを表示するために必要なマークアップを使用できます。たとえば "rtl" または "ltr" を値として解釈する [!INCLUDE[TLA#tla_html](../../../../includes/tlasharptla-html-md.md)] 4.0 タグの "dir" などです。  このタグは <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティに似ていますが、<xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティはテキスト コンテンツのレイアウトに対する機能がより拡張されていて、テキスト以外のコンテンツでも使用できます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Documents.FlowDocument> がテキスト、テーブル、イメージ、および他の要素の組み合わせをホストできる、柔軟性のある [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素となります。  以下のセクションのサンプルでは、この要素を使用します。  
+  
+ <xref:System.Windows.Documents.FlowDocument> へのテキストの追加には、複数の方法があります。  単純な方法は、テキストなどのコンテンツのグループ化に使用するブロック レベル要素の <xref:System.Windows.Documents.Paragraph> を用いることです。  サンプルでは、インライン レベルの要素にテキストを追加するために、<xref:System.Windows.Documents.Span> と <xref:System.Windows.Documents.Run> が使用されています。  <xref:System.Windows.Documents.Span> は他のインライン要素のグループ化に使用されるインライン レベルのフロー コンテンツ要素で、<xref:System.Windows.Documents.Run> は書式設定されていない一連のテキストを格納するためのインライン レベルのフロー コンテンツ要素です。  1 つの <xref:System.Windows.Documents.Span> に、複数の <xref:System.Windows.Documents.Run> 要素を含めることができます。  
+  
+ 最初のドキュメント例には、いくつかのネットワーク共有名 \(たとえば `\\server1\folder\file.ext`\) がある文書が含まれます。  このネットワーク リンクがアラビア語または英語のいずれの文書にあっても、常に同じように表示する必要があります。  次の図は、アラビア語の <xref:System.Windows.FlowDirection> ドキュメントのリンクを示します。  
+  
+ **Span 要素の使用を示す図**  
+  
+ ![右から左に読むドキュメント](../../../../docs/framework/wpf/advanced/media/flowdocument.png "FlowDocument")  
+  
+ テキストは <xref:System.Windows.FlowDirection> であるため、"\\" などのすべての特殊文字でテキストを右から左の順序で区切ります。  この場合、リンクが正しい順序で表示されません。したがって、この問題を解決するためにテキストを埋め込んで、フロー方向が <xref:System.Windows.FlowDirection> の <xref:System.Windows.Documents.Run> を個別に残す必要があります。  言語ごとに <xref:System.Windows.Documents.Run> を作成するのではなく、頻繁には使用しない英語のテキストは大きなアラビア語の <xref:System.Windows.Documents.Span> に埋め込むのがより良い問題の解決法です。  
+  
+ 次の図にこれを示します。  
+  
+ **Span 要素に埋め込んだ実行要素の使用を示す図**  
+  
+ ![XamlPad スクリーンショット](../../../../docs/framework/wpf/advanced/media/runspan.png "RunSpan")  
+  
+ 次の例は、<xref:System.Windows.Documents.Run> と <xref:System.Windows.Documents.Span> 要素をドキュメントで使用する方法を示します。  
+  
+ [!code-xml[RunSpan#RunSpan](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RunSpan/CS/Window1.xaml#runspan)]  
+  
+<a name="SpanElements"></a>   
+## Span 要素  
+ <xref:System.Windows.Documents.Span> 要素は、フロー方向が異なるテキストの境界区切り記号の役割を果たします。  フロー方向が同じ <xref:System.Windows.Documents.Span> 要素でも、双方向スコープは異なると見なされます。これは、コンテナーの <xref:System.Windows.FlowDirection> 中で <xref:System.Windows.Documents.Span> 要素が順序付けられているということです。<xref:System.Windows.Documents.Span> 要素内のコンテンツのみが <xref:System.Windows.Documents.Span> の <xref:System.Windows.FlowDirection> に従います。  
+  
+ 次の図は、複数の <xref:System.Windows.Controls.TextBlock> 要素のフロー方向を示します。  
+  
+ **複数の TextBlock 要素での FlowDirection を示す図**  
+  
+ ![フロー方向が異なるテキスト ブロック](../../../../docs/framework/wpf/advanced/media/span.png "Span")  
+  
+ 次の例には、前の図で表示された結果を作成するために <xref:System.Windows.Documents.Span> 要素と <xref:System.Windows.Documents.Run> 要素を使用する方法を示します。  
+  
+ [!code-xml[Span#Span](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Span/CS/Window1.xaml#span)]  
+  
+ サンプルの <xref:System.Windows.Controls.TextBlock> 要素では、<xref:System.Windows.Documents.Span> 要素は親の <xref:System.Windows.FlowDirection> に従って配置されます。ただし、各 <xref:System.Windows.Documents.Span> 要素内のテキストはそれ自体の <xref:System.Windows.FlowDirection> に従って流れます。  これは、ラテン語やアラビア語だけでなく、他のどの言語にも当てはまります。  
+  
+### xml:lang の追加  
+ 次の図は、`"200.0+21.4=221.4"` などの番号と算術式を使用する別の例を示します。  <xref:System.Windows.FlowDirection> だけが設定されることに注意してください。  
+  
+ **FlowDirection のみを使用して数値を表示する図**  
+  
+ ![右から左に読む数字](../../../../docs/framework/wpf/advanced/media/langattribute.png "LangAttribute")  
+  
+ 残念ながらこのアプリケーションの出力では、<xref:System.Windows.FlowDirection> が正しいにもかかわらず、数字がアラビア数字の形状になりません。  
+  
+ XAML 要素には、各要素の言語を定義する [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] 属性 \(`xml:lang`\) を含めることができます。  また、XAML では、ツリーの親要素に `xml:lang` 値を適用すると、子要素にもその属性が適用されるという [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 言語の原則も遵守されます。  前の例では、<xref:System.Windows.Documents.Run> 要素に対しても、その最上位要素に対しても言語が定義されていないため、`xml:lang` の既定値 \(XAML では `en-US`\) が適用されています。  また、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の内部数字形成アルゴリズムによって、対応する言語 \(この場合は英語\) の数字が選択されます。  アラビア数字を正しく表示するためには、`xml:lang` を設定する必要があります。  
+  
+ 次の図は、`xml:lang` を追加した例を示しています。  
+  
+ **xml:lang 属性の使用を示す図**  
+  
+ ![右から左に読むアラビア数字](../../../../docs/framework/wpf/advanced/media/langattribute2.png "LangAttribute2")  
+  
+ 次の例では、アプリケーションに `xml:lang` が追加されています。  
+  
+ [!code-xml[LangAttribute#LangAttribute](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LangAttribute/CS/Window1.xaml#langattribute)]  
+  
+ 多くの言語では、対象となる地域に応じて異なる `xml:lang` 値があります。たとえば、`"ar-SA"` と `"ar-EG"` はアラビア語の 2 つのバリエーションです。  前の例は、`xml:lang` と <xref:System.Windows.FlowDirection> の両方の値を定義する必要があることを示しています。  
+  
+<a name="FlowDirectionNontext"></a>   
+## 非テキスト要素のある FlowDirection  
+ <xref:System.Windows.FlowDirection> は、テキストのテキスト要素内でのフロー方向だけでなく、他のほぼすべての [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素の流れ方も定義します。  次の図は、背景を描画するために、水平 <xref:System.Windows.Media.LinearGradientBrush> で使用する <xref:System.Windows.Controls.ToolBar> を示します。  
+  
+ **左から右へのグラデーションを付けたツール バーを示す図**  
+  
+ ![グラデーションのスクリーンショット](../../../../docs/framework/wpf/advanced/media/gradient.png "Gradient")  
+  
+ <xref:System.Windows.FlowDirection> に <xref:System.Windows.FlowDirection> を設定すると、<xref:System.Windows.Controls.ToolBar> ボタンが右から左に整列されるだけでなく、<xref:System.Windows.Media.LinearGradientBrush> によりそのオフセットが右から左に移動するように調整されます。  
+  
+ 次の図は、再構成された <xref:System.Windows.Media.LinearGradientBrush> を示します。  
+  
+ **右から左へのグラデーションを付けたツール バーを示す図**  
+  
+ ![右から左に読むグラデーション](../../../../docs/framework/wpf/advanced/media/gradient2-wpf.png "Gradient2\_WPF")  
+  
+ <xref:System.Windows.FlowDirection> <xref:System.Windows.Controls.ToolBar> を作成する例を次に示します。  \(左から右に描画するには、<xref:System.Windows.Controls.ToolBar> に対する <xref:System.Windows.FlowDirection> 属性を削除します。  
+  
+ [!code-xml[Gradient#Gradient](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Gradient/CS/Window1.xaml#gradient)]  
+  
+<a name="FlowDirectionExceptions"></a>   
+### FlowDirection の例外  
+ <xref:System.Windows.FlowDirection> が期待どおりに動作しない場合があります。  ここでは、そのような例外を 2 つ取り上げて説明します。  
+  
+ **Image**  
+  
+ <xref:System.Windows.Controls.Image> は、イメージを表示するコントロールを表します。  [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] では、表示する <xref:System.Windows.Controls.Image> の [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] を定義する <xref:System.Windows.Controls.Image.Source%2A> プロパティと合わせてこのコントロールを使用できます。  
+  
+ 他の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素とは異なり、<xref:System.Windows.Controls.Image> はコンテナーから <xref:System.Windows.FlowDirection> を継承しません。  ただし、<xref:System.Windows.FlowDirection> が <xref:System.Windows.FlowDirection> に明示的に設定されると、<xref:System.Windows.Controls.Image> は左右反転して表示されます。  これは、双方向コンテンツの開発者にとって便利な機能として実装されています。場合によっては、イメージを左右反転して表示することで必要な効果が得られるためです。  
+  
+ 次の図は、反転された <xref:System.Windows.Controls.Image> を示します。  
+  
+ **反転されたイメージを示す図**  
+  
+ ![XamlPad スクリーンショット](../../../../docs/framework/wpf/advanced/media/image.png "Image")  
+  
+ 次の例は、<xref:System.Windows.Controls.Image> が、それが含まれる <xref:System.Windows.Controls.StackPanel> からの <xref:System.Windows.FlowDirection> の継承に失敗することを示します。  **メモ** この例を実行するには、C:\\ ドライブに  **ms logo.jpg** という名前のファイルが必要です。  
+  
+ [!code-xml[Image#Image](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Image/CS/Window1.xaml#image)]  
+  
+ **メモ** ダウンロード ファイルには、**Ms logo.jpg** ファイルが含まれています。  コードは、この .jpg ファイルがプロジェクト内ではなく、C:\\ ドライブ上にあることを前提としています。  プロジェクト内のファイルを検索するためには、プロジェクト ファイルから C:\\ドライブに .jpg をコピーするかコードを変更する必要があります。  これを行うには、`Source="file://c:/ms_logo.jpg"` を `Source="ms_logo.jpg"` に変更します。  
+  
+ **パス**  
+  
+ <xref:System.Windows.Controls.Image> のほかに興味深い要素は <xref:System.Windows.Shapes.Path> です。  Pathは、接続された一連の線と曲線を描画できるオブジェクトです。  <xref:System.Windows.FlowDirection> に関しては <xref:System.Windows.Controls.Image> と同様に動作します。たとえば <xref:System.Windows.FlowDirection> <xref:System.Windows.FlowDirection> は <xref:System.Windows.FlowDirection> を水平方向に反転したものです。  ただし、<xref:System.Windows.Controls.Image> とは異なり、<xref:System.Windows.Shapes.Path> は <xref:System.Windows.FlowDirection> をコンテナーから継承し、明示的に指定する必要がありません。  
+  
+ 次の例では、3 本の線を用いて単純な矢印を描画します。  最初の矢印は、始点と終点が右側を起点として計測されるように、<xref:System.Windows.Controls.StackPanel> から <xref:System.Windows.FlowDirection> フロー方向を継承します。  明示的な <xref:System.Windows.FlowDirection> <xref:System.Windows.FlowDirection> を持つ 2 番目の矢印も右側を起点とします。  ただし、3 番目の矢印の起点は左側です。  描画の詳細については、「<xref:System.Windows.Media.LineGeometry>」および「<xref:System.Windows.Media.GeometryGroup>」を参照してください。  
+  
+ [!code-xml[Paths#Paths](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Paths/CS/Window1.xaml#paths)]  
+  
+ 前の例の出力を次の図に示します。  
+  
+ **Path 要素を使用して描画した矢印の図**  
+  
+ ![パス](../../../../docs/framework/wpf/advanced/media/paths.png "Paths")  
+  
+ <xref:System.Windows.Controls.Image> と <xref:System.Windows.Shapes.Path> は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] による <xref:System.Windows.FlowDirection> の使用方法を示す 2 つの例です。  <xref:System.Windows.FlowDirection> は、コンテナー内の特定の方向に [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を配置する他に、サーフェイス上にインクをレンダリングする <xref:System.Windows.Controls.InkPresenter>、<xref:System.Windows.Media.RadialGradientBrush>、および <xref:System.Windows.Media.LinearGradientBrush> などの要素と合わせて使用できます。  左から右への動作を模したコンテンツに対して右から左への動作が必要な場合、またはその逆の場合には、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] を使用すれば可能です。  
+  
+<a name="NumberSubstitution"></a>   
+## 数字代替  
+ 従来から、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] は、同じ数字をカルチャによって異なる形状で表現できるようにすると同時に、ロケールが異なってもこれらの数字の内部ストレージを統一する \(たとえば、数字をごく一般的な 16 進値である 0x40 や 0x41 で格納しながら、表示は選択された言語で行う\) ことによって、数字代替をサポートしてきました。  
+  
+ これによって、言語間での変換を行わなくてもアプリケーションが数値を処理することができます。たとえば、ローカライズされたアラビア語 [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の [!INCLUDE[TLA#tla_xl](../../../../includes/tlasharptla-xl-md.md)] スプレッドシートを開いて、アラビア語の形状の数字を表示することができますが、このスプレッドシートを [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] のヨーロッパ言語バージョンで開き同じ数字のヨーロッパ語表現を表示することもできます。  これは、コンマ区切りやパーセント記号などの他の記号でも必要です。これらの記号は、通常同じドキュメント内で数字を伴っているからです。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は引き続きこの機能を備え、代替を用いるタイミングと方法をユーザーがより広く制御できるようにこの機能を改善してゆきます。  この機能はどの言語に対しても有効ですが、アプリケーションが使用されるカルチャが多岐にわたるために特定の言語に合わせて数字の形状を設定することがアプリケーション開発者にとってに問題となる双方向コンテンツに対して特に有用です。  
+  
+ 数字代替の [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] での機能を制御する中核のプロパティは、<xref:System.Windows.Media.NumberSubstitution.Substitution%2A> 依存プロパティです。  <xref:System.Windows.Media.NumberSubstitution> クラスは、テキストでの数字の表示方法を指定します。  動作を定義する 3 つのパブリック プロパティがあります。  以下は、各プロパティの概要です。  
+  
+ **CultureSource:**  
+  
+ このプロパティは、数字のカルチャを確認する方法を指定します。  3 つの <xref:System.Windows.Media.NumberCultureSource> 列挙値のいずれかをとります。  
+  
+-   Override: 数字カルチャは、<xref:System.Windows.Media.NumberSubstitution.CultureOverride%2A> プロパティの数字カルチャです。  
+  
+-   Text: 数字カルチャは、テキスト ランのカルチャです。  マークアップでは、これは `xml:lang`、つまりエイリアスである `Language` プロパティ \(<xref:System.Windows.FrameworkElement.Language%2A> または <xref:System.Windows.FrameworkContentElement.Language%2A>\) です。  <xref:System.Windows.FrameworkContentElement> から派生しているクラスの既定でもあります。  こうしたクラスには、<xref:System.Windows.Documents.Paragraph?displayProperty=fullName>、<xref:System.Windows.Documents.Table?displayProperty=fullName>、<xref:System.Windows.Documents.TableCell?displayProperty=fullName> などが含まれます。  
+  
+-   User: 数字カルチャは、現在のスレッドのカルチャです。  このプロパティは、<xref:System.Windows.Controls.Page>、<xref:System.Windows.Window>、および <xref:System.Windows.Controls.TextBlock> などの <xref:System.Windows.FrameworkElement> のすべてのサブクラスの既定です。  
+  
+ **CultureOverride** :  
+  
+ <xref:System.Windows.Media.NumberSubstitution.CultureOverride%2A> プロパティが使用されるのは <xref:System.Windows.Media.NumberCultureSource> が <xref:System.Windows.Media.NumberSubstitution.CultureSource%2A> プロパティに設定されている場合のみで、それ以外の場合は無視されます。  このプロパティは、数字カルチャを指定します。  既定値である `null` の値は、en\-US として解釈されます。  
+  
+ **代替** :  
+  
+ このプロパティは、実行する数字代替の種類を指定します。  次の <xref:System.Windows.Media.NumberSubstitutionMethod> 列挙値のいずれかをとります。  
+  
+-   <xref:System.Windows.Media.NumberSubstitutionMethod>: 数字カルチャの <xref:System.Globalization.NumberFormatInfo.DigitSubstitution%2A?displayProperty=fullName> プロパティ値に基づいて代替方法が決定されます。  これは、既定の設定です。  
+  
+-   <xref:System.Windows.Media.NumberSubstitutionMethod>: 数字カルチャがアラビアまたはペルシアのカルチャである場合に、数字がコンテキストに応じて使用されるように指定します。  
+  
+-   <xref:System.Windows.Media.NumberSubstitutionMethod>: 数字は常にヨーロッパ数字として描画されます。  
+  
+-   <xref:System.Windows.Media.NumberSubstitutionMethod>: カルチャの <xref:System.Globalization.CultureInfo.NumberFormat%2A> プロパティで指定された、数字カルチャに対応する国の数字を使って、数字が描画されます。  
+  
+-   <xref:System.Windows.Media.NumberSubstitutionMethod>: 数字カルチャの通常の数字を使用して数字を描画することを指定します。  ほとんどのカルチャで、これは <xref:System.Windows.Media.NumberSubstitutionMethod> と同じです。  ただし、<xref:System.Windows.Media.NumberSubstitutionMethod> では一部のアラビア カルチャでラテン数字が表示されますが、Traditional ではすべてのアラビア カルチャでアラビア数字が表示されます。  
+  
+ これらの値は双方向コンテンツ開発者にとってどういった意味があるのでしょうか。  ほとんどの場合、開発者は <xref:System.Windows.FlowDirection> と各テキスト [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素の言語 \(たとえば `Language="ar-SA"`\) を定義するだけでよく、数字の表示は、<xref:System.Windows.Media.NumberSubstitution> ロジックにより、各 [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] に応じて行われます。  次の例は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] のアラビア語版で実行されている [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでアラビア数字と英語数字を使用する方法を示します。  
+  
+ [!code-xml[Numbers#Numbers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Numbers/CS/Window1.xaml#numbers)]  
+  
+ 次の図は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] のアラビア語版を実行している場合の、前のサンプルの出力を示します。  
+  
+ **表示されたアラビア数字と英語数字を示す図**  
+  
+ ![数字を含む XamlPad のスクリーンショット](../../../../docs/framework/wpf/advanced/media/numbers.png "Numbers")  
+  
+ この場合、代わりに <xref:System.Windows.FlowDirection> に <xref:System.Windows.FlowDirection> を設定するとヨーロッパ数字が生成されていたため、<xref:System.Windows.FlowDirection> が重要でした。  以下のセクションでは、ドキュメント全体で数字の表示を統一する方法について説明します。  この例では、アラビア語版 Windows で実行されていなければ、すべての数字がヨーロッパ数字として表示されます。  
+  
+ **代替ルールの定義**  
+  
+ 実際のアプリケーションでは、プログラムでの言語設定が必要となる場合があります。  たとえば、`xml:lang` 属性をシステムの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] により使用されている属性と同じものに設定する場合もありますし、アプリケーション状態に応じて言語を変更する場合もあります。  
+  
+ アプリケーションの状態に基づいて変更を行う場合には、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] が備えている他の機能を使用してください。  
+  
+ アプリケーション コンポーネントの `NumberSubstitution.CultureSource="Text"` を最初に設定します。  この設定を使用すると、<xref:System.Windows.Controls.TextBlock> などの既定値が "User" であるテキスト要素の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] から設定が取得されることはありません。  
+  
+ 次に例を示します。  
+  
+||  
+|-|  
+|`<TextBlock`<br /><br /> `Name="text1" NumberSubstitution.CultureSource="Text">`<br /><br /> `1234+5679=6913`<br /><br /> `</TextBlock>`|  
+  
+ 対応する [!INCLUDE[TLA2#tla_lhcshrp](../../../../includes/tla2sharptla-lhcshrp-md.md)] コードで、`Language` プロパティを `"ar-SA"` などに設定します。  
+  
+||  
+|-|  
+|`text1.Language =`<br /><br /> `System.Windows.Markup.XmlLanguage.GetLanguage("ar-SA");`|  
+  
+ 現在のユーザーの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 言語に `Language` プロパティを設定する必要がある場合、次のコードを使用します。  
+  
+||  
+|-|  
+|`text1.Language =`<br /><br /> `System.Windows.Markup.XmlLanguage.GetLanguage(`<br /><br /> `System.Globalization.CultureInfo.CurrentUICulture.IetfLanguageTag);`|  
+  
+ <xref:System.Globalization.CultureInfo.CurrentCulture%2A> は、実行時に現在のスレッドによって使用される現在のカルチャを表します。  
+  
+ 最終的な [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] 例は、次の例に似たものになります。  
+  
+ [!code-xml[Numbers2#Numbers2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Numbers2/CS/Window1.xaml#numbers2)]  
+  
+ 最終的な [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] 例は、次のようなものになります。  
+  
+ [!code-csharp[NumbersCSharp#NumbersCSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NumbersCSharp/CSharp/Window1.xaml.cs#numberscsharp)]  
+  
+ 次の図は、いずれかのプログラミング言語に対するウィンドウの外観を示します。  
+  
+ **アラビア数字を表示した図**  
+  
+ ![アラビア数字](../../../../docs/framework/wpf/advanced/media/numbers2.png "Numbers2")  
+  
+ **Substitution プロパティの使用**  
+  
+ 数字代替の [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] での機能は、テキスト要素の言語と <xref:System.Windows.FlowDirection> の両方によって異なります。  <xref:System.Windows.FlowDirection> が左から右の場合、ヨーロッパ数字が表示されます。  ただし、アラビア語のテキストが前にある場合、または言語が "ar" に設定されており、<xref:System.Windows.FlowDirection> が <xref:System.Windows.FlowDirection> の場合には、代わりにアラビア数字が描画されます。  
+  
+ ただし、たとえばすべてのユーザーに対してヨーロッパ数字を表示するなどの、統一されたアプリケーションを作成する必要のある場合もあります。  また、特定の <xref:System.Windows.Style> で <xref:System.Windows.Documents.Table> セルにアラビア数字を表示する必要のある場合もあります。  これを行う簡単な方法の 1 つは、<xref:System.Windows.Media.NumberSubstitution.Substitution%2A> プロパティを使用することです。  
+  
+ 次の例で、最初の <xref:System.Windows.Controls.TextBlock> には <xref:System.Windows.Media.NumberSubstitution.Substitution%2A> プロパティ セットがないため、予想されるようにアルゴリズムによってアラビア数字が表示されます。  ただし、2 番目の <xref:System.Windows.Controls.TextBlock> では、代替がヨーロッパ言語に設定されて、既定のアラビア数字への代替がオーバーライドされているため、ヨーロッパ数字が表示されます。  
+  
+ [!code-xml[Numbers3#Numbers3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Numbers3/CS/Window1.xaml#numbers3)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/binding-markup-extension.md b/docs/framework/wpf/advanced/binding-markup-extension.md
new file mode 100644
index 00000000000..a4d664dc82e
--- /dev/null
+++ b/docs/framework/wpf/advanced/binding-markup-extension.md
@@ -0,0 +1,136 @@
+---
+title: "バインドのマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Binding"
+helpviewer_keywords: 
+  - "バインディングのマークアップ拡張機能"
+  - "XAML, バインディングのマークアップ拡張機能"
+ms.assetid: 83d6e2a4-1b0c-4fc8-bd96-b5e98800ab63
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# バインドのマークアップ拡張機能
+プロパティ値を、データ バインドされた値として指定できるようにします。中間の式オブジェクトを作成し、実行時に要素とそのバインディングに適用されるデータ コンテキストを解釈します。  
+  
+## Binding 式の使用方法  
+  
+```  
+<object property="{Binding}" .../>  
+-or-  
+<object property="{Binding  bindProp1=value1[, bindPropN=valueN]*}" ...  
+/>  
+-or-  
+<object property="{Binding path}" .../>  
+-or  
+<object property="{Binding path[, bindPropN=valueN]*}" .../>  
+```  
+  
+## 構文についてのメモ  
+ これらの構文の `[]` と `*` は、リテラルではありません。  0 個以上の *bindProp*`=`*value* ペアを使用できることを示す表記法の一部です。先行する *bindProp*`=`*value* ペアとの区切り記号には `,` が使用されます。  
+  
+ 「バインディング拡張で設定できるバインディング プロパティ」に示すプロパティはいずれも、<xref:System.Windows.Data.Binding> オブジェクト要素の属性を使用して設定することもできます。  ただしそれは、実際には <xref:System.Windows.Data.Binding> のマークアップ拡張機能の使用方法ではなく、CLR <xref:System.Windows.Data.Binding> クラスのプロパティを設定する属性の一般的な XAML 処理にすぎません。  つまり、`<Binding` *bindProp1*`="`*value1*`"[` *bindPropN*`="`*valueN*`"]*/>` は、`Binding` 式の使用方法ではなく、<xref:System.Windows.Data.Binding> オブジェクト要素の属性を使用した同等の構文です。  <xref:System.Windows.Data.Binding> の特定のプロパティの XAML 属性の使用方法の詳細については、.NET Framework クラス ライブラリで、<xref:System.Windows.Data.Binding> の該当するプロパティの「XAML 属性の使用方法」を参照してください。  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`bindProp1, bindPropN`|設定対象の <xref:System.Windows.Data.Binding> プロパティまたは <xref:System.Windows.Data.BindingBase> プロパティの名前。  <xref:System.Windows.Data.Binding> のすべてのプロパティを `Binding` 拡張を使用して設定できるとは限りません。また、プロパティによっては、マークアップ拡張機能をさらに入れ子にしなければ `Binding` 式の中では設定できません。  「バインディング拡張で設定できるバインディング プロパティ」を参照してください。|  
+|`value1, valueN`|プロパティに設定する値。  属性値の処理は、最終的には、設定される特定の <xref:System.Windows.Data.Binding> プロパティの型とロジックによって決まります。|  
+|`path`|暗黙的な <xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> プロパティを設定するパス文字列。  [PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md) も参照してください。|  
+  
+## 非修飾の {Binding}  
+ 「Binding 式の使用方法」に示した `{Binding}` という使用方法では、既定値 \(`null` の初期値 <xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> など\) を使用して <xref:System.Windows.Data.Binding> オブジェクトが作成されます。  それでも、さまざまなシナリオで役に立ちます。作成される <xref:System.Windows.Data.Binding> は、実行時のデータ コンテキストで設定される主要なデータ バインディング プロパティ \(<xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> や <xref:System.Windows.Data.Binding.Source%2A?displayProperty=fullName> など\) に依存する可能性があるためです。  データ コンテキストの概念の詳細については、「[データ バインディング](../../../../docs/framework/wpf/data/data-binding-wpf.md)」を参照してください。  
+  
+## 暗黙のパス  
+ `Binding` マークアップ拡張機能では、<xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> を概念的な "既定のプロパティ" として使用します。そのため、`Path=` を式で指定する必要はありません。  暗黙的なパスを含む `Binding` 式を指定する場合は、その暗黙的なパスを式で最初に \(<xref:System.Windows.Data.Binding> プロパティを名前で指定する他の `bindProp`\=`value` ペアより先に\) 指定する必要があります   \(例: `{Binding PathString}` \(`PathString` は、マークアップ拡張機能の使用方法によって作成される <xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> の値に評価される文字列\)\)。  暗黙のパスの後に、他の名前付きプロパティをコンマで区切って追加することもできます。たとえば、`{Binding LastName, Mode=TwoWay}` のように指定します。  
+  
+## バインディング拡張で設定できるバインディング プロパティ  
+ ここに示す構文では、`bindProp`\=`value` という一般的な形式を使用します。`Binding` マークアップ拡張機能\/式の構文を使用して設定可能な、<xref:System.Windows.Data.BindingBase> や <xref:System.Windows.Data.Binding> の読み書き可能なプロパティは多数あるためです。  暗黙的な <xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName> 以外は、設定する順序は自由です   \(`Path=` を明示的に指定することもできます。その場合は、このプロパティを自由な順序で設定できます\)。  基本的に、下の一覧に示したプロパティのうち 0 個以上を、`bindProp`\=`value` ペアの形式で、コンマで区切って設定します。  
+  
+ これらのプロパティ値のいくつかは、要求しているオブジェクト型が XAML のテキスト構文からのネイティブ型変換をサポートしていないので、さらに属性値として設定するためにマークアップ拡張機能が必要です。  詳細については、.NET Framework クラス ライブラリで各プロパティの「XAML 属性の使用方法」を参照してください。さらなるマークアップ拡張機能の使用を含む場合も含まない場合も、XAML 属性構文で使用する文字列は、`Binding` 式で指定する値と基本的に同じです。違いは、`Binding` 式では各 `bindProp`\=`value` を引用符で囲まないことだけです。  
+  
+-   <xref:System.Windows.Data.BindingBase.BindingGroupName%2A>: バインディング グループの候補を示す文字列。  これは比較的高度なバインディング概念です。詳細については、<xref:System.Windows.Data.BindingBase.BindingGroupName%2A> のリファレンス ページを参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.BindsDirectlyToSource%2A>: ブール値。`true` と `false` のいずれかです。  既定値は、`false` です。  
+  
+-   <xref:System.Windows.Data.Binding.Converter%2A>: `bindProp`\=`value` の文字列として式で設定できますが、そのためには値のオブジェクト参照 \([StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)など\) が必要です。  この場合の値は、カスタム コンバーター クラスのインスタンスです。  
+  
+-   <xref:System.Windows.Data.Binding.ConverterCulture%2A>: 標準ベースの識別子として式で設定できます。<xref:System.Windows.Data.Binding.ConverterCulture%2A> のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.ConverterParameter%2A>: `bindProp`\=`value` の文字列として式で設定できますが、渡されるパラメーターの型に依存します。  値に参照型を渡す場合、この使用方法では入れ子になった [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)などのオブジェクト参照が必要です。  
+  
+-   <xref:System.Windows.Data.Binding.ElementName%2A>: このプロパティと <xref:System.Windows.Data.Binding.RelativeSource%2A> および <xref:System.Windows.Data.Binding.Source%2A> は同時に使用できません。これらの各バインディング プロパティは特定のバインディング方法を表します。  「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+-   <xref:System.Windows.Data.BindingBase.FallbackValue%2A>: `bindProp`\=`value` の文字列として式で設定できますが、渡される値の型に依存します。  参照型を渡す場合は、入れ子になった [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)などのオブジェクト参照が必要です。  
+  
+-   <xref:System.Windows.Data.Binding.IsAsync%2A>: ブール値。`true` と `false` のいずれかです。  既定値は、`false` です。  
+  
+-   <xref:System.Windows.Data.Binding.Mode%2A>: *value* は <xref:System.Windows.Data.BindingMode> 列挙体の定数名です。  たとえば、`{Binding Mode=OneWay}` のようにします。  
+  
+-   <xref:System.Windows.Data.Binding.NotifyOnSourceUpdated%2A>: ブール値。`true` または `false` のいずれかです。  既定値は、`false` です。  
+  
+-   <xref:System.Windows.Data.Binding.NotifyOnTargetUpdated%2A>: ブール値。`true` と `false` のいずれかです。  既定値は、`false` です。  
+  
+-   <xref:System.Windows.Data.Binding.NotifyOnValidationError%2A>: ブール値。`true` または `false` のいずれかです。  既定値は、`false` です。  
+  
+-   <xref:System.Windows.Data.Binding.Path%2A>: データ オブジェクトまたは汎用オブジェクト モデルへのパスを表す文字列。  ここで詳しく説明することはできませんが、この形式は、オブジェクト モデルを走査するための複数の異なる規約に対応しています。  「[PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md)」を参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.RelativeSource%2A>: このプロパティと <xref:System.Windows.Data.Binding.ElementName%2A> および <xref:System.Windows.Data.Binding.Source%2A> は同時に使用できません。これらの各バインディング プロパティは特定のバインディング方法を表します。  「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  値を指定するには、入れ子になった [RelativeSource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/relativesource-markupextension.md)の使用が必要です。  
+  
+-   <xref:System.Windows.Data.Binding.Source%2A>: このプロパティと <xref:System.Windows.Data.Binding.RelativeSource%2A> および <xref:System.Windows.Data.Binding.ElementName%2A> は同時に使用できません。これらの各バインディング プロパティは特定のバインディング方法を表します。  「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  入れ子になった拡張機能の使用 \(通常は、キーを持つリソース ディクショナリのオブジェクト データ ソースを参照する [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)\) が必要です。  
+  
+-   <xref:System.Windows.Data.BindingBase.StringFormat%2A>: バインドされたデータの文字列書式指定規則を表す文字列。  これは比較的高度なバインディング概念です。詳細については、<xref:System.Windows.Data.BindingBase.StringFormat%2A> のリファレンス ページを参照してください。  
+  
+-   <xref:System.Windows.Data.BindingBase.TargetNullValue%2A>: `bindProp`\=`value` の文字列として式で設定できますが、渡されるパラメーターの型に依存します。  値に参照型を渡す場合は、入れ子になった [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)などのオブジェクト参照が必要です。  
+  
+-   <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A>: *value* は <xref:System.Windows.Data.UpdateSourceTrigger> 列挙体の定数名です。  たとえば、`{Binding UpdateSourceTrigger=LostFocus}` のようにします。  特定のコントロールには、このバインディング プロパティに対して別の既定値がある可能性があります。  「<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A>」を参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.ValidatesOnDataErrors%2A>: ブール値。`true` と `false` のいずれかです。  既定値は、`false` です。  「解説」を参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.ValidatesOnExceptions%2A>: ブール値。`true` と `false` のいずれかです。  既定値は、`false` です。  「解説」を参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.XPath%2A>: XML データ ソースの XMLDOM へのパスを表す文字列。  「[XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)」を参照してください。  
+  
+ 次に示す <xref:System.Windows.Data.Binding> のプロパティは、`Binding` マークアップ拡張機能\/`{Binding}` 式の形式を使用して設定することはできません。  
+  
+-   <xref:System.Windows.Data.Binding.UpdateSourceExceptionFilter%2A>: このプロパティには、コールバック実装への参照が必要です。  コールバック\/イベント ハンドラー以外のメソッドは、XAML 構文で参照できません。  
+  
+-   <xref:System.Windows.Data.Binding.ValidationRules%2A>: このプロパティは、<xref:System.Windows.Controls.ValidationRule> オブジェクトのジェネリック コレクションを受け取ります。  <xref:System.Windows.Data.Binding> オブジェクト要素のプロパティ要素として表現することもできますが、`Binding` 式ですぐに使用できる属性解析方法がありません。  <xref:System.Windows.Data.Binding.ValidationRules%2A> のリファレンス トピックを参照してください。  
+  
+-   <xref:System.Windows.Data.Binding.XmlNamespaceManager%2A>  
+  
+## 解説  
+  
+> [!IMPORTANT]
+>  依存関係プロパティの優先順位という点では、`Binding` 式はローカルで設定される値と同等です。  `Binding` 式を持っているプロパティに対してローカル値を設定すると、`Binding` は完全に削除されます。  詳細については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+ ここでは、基本レベルでのデータ バインディングについては説明しません。  「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Data.MultiBinding> および <xref:System.Windows.Data.PriorityBinding> は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 拡張構文をサポートしません。代わりに、プロパティ要素を使用します。  <xref:System.Windows.Data.MultiBinding> および <xref:System.Windows.Data.PriorityBinding> のリファレンス トピックを参照してください。  
+  
+ XAML のブール値は、大文字と小文字を区別しません。  たとえば、`{Binding NotifyOnValidationError=true}` または `{Binding NotifyOnValidationError=True}` のように指定できます。  
+  
+ 通常、データ検証を伴うバインディングは、`{Binding ...}` 式としてではなく、明示的な `Binding` 要素で指定され、<xref:System.Windows.Data.Binding.ValidatesOnDataErrors%2A> または <xref:System.Windows.Data.Binding.ValidatesOnExceptions%2A> を式で設定することは一般的ではありません。  これは、コンパニオン プロパティである <xref:System.Windows.Data.Binding.ValidationRules%2A> を式の形式で容易に設定できないためです。  詳細については、「[バインディングの検証の実装](../../../../docs/framework/wpf/data/how-to-implement-binding-validation.md)」を参照してください。  
+  
+ `Binding` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに属性が追加される型コンバーターにとどまらない場合です。  XAML のすべてのマークアップ拡張機能では、それぞれの属性構文で `{` と `}` の 2 つの記号を使用します。これは規約であり、これに従って XAML プロセッサは、マークアップ拡張機能で文字列の内容を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+ `Binding` が他のマークアップ拡張機能と異なる点は、WPF の XAML 実装のこの拡張機能を実装する <xref:System.Windows.Data.Binding> クラスが、XAML に関連しないその他のいくつかのメソッドやプロパティも実装することです。  他のメンバーの目的は、<xref:System.Windows.Data.Binding> を汎用性の高い、自己完結型のクラスにすることです。これによって、XAML マークアップ拡張機能としての機能に加え、さまざまなデータ バインディング シナリオに対応できるようになります。  
+  
+## 参照  
+ <xref:System.Windows.Data.Binding>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/cleartype-overview.md b/docs/framework/wpf/advanced/cleartype-overview.md
new file mode 100644
index 00000000000..cf7c95e37f5
--- /dev/null
+++ b/docs/framework/wpf/advanced/cleartype-overview.md
@@ -0,0 +1,78 @@
+---
+title: "ClearType の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ClearType, テクノロジ"
+  - "タイポグラフィ, ClearType テクノロジ"
+ms.assetid: 7e2392e0-75dc-463d-a716-908772782431
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ClearType の概要
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA#tla_ct](../../../../includes/tlasharptla-ct-md.md)] テクノロジの概要について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overview"></a>   
+## テクノロジの概要  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、ラップトップや Pocket PC の画面、フラット パネル モニターなど、既存の LCD \(液晶ディスプレイ\) でのテキストの読みやすさを向上させるために [!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] が開発したソフトウェア テクノロジです。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、LCD 画面の各ピクセル内の個々の垂直カラー ストライプ要素にアクセスすることによって機能します。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] が開発されるまでは、コンピューターで表示可能な最小の詳細レベルは 1 ピクセルでしたが、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] を LCD モニターで使用すると、テキストの各部分の幅が 1 ピクセルよりも小さくても表示できるようになります。  解像度が上がるとテキスト表示の微細部のシャープさが向上するため、長時間にわたって読んでも苦になりません。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] で利用可能な [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、[!INCLUDE[TLA#tla_gdi](../../../../includes/tlasharptla-gdi-md.md)] に含まれるバージョンに多数の改良を加えた [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の最新バージョンです。  
+  
+<a name="sub-pixel_positioning"></a>   
+## サブピクセル ポジショニング  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の旧バージョンから大きく改善された点の 1 つに、サブピクセル ポジショニングの使用があります。  [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] に含まれている [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] 実装とは異なり、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] では、ピクセルの境界から開始するグリフだけでなく、ピクセルの途中から開始するグリフも表示できます。  グリフの配置の解像度が上がることにより、グリフの間隔や比率の正確さや一貫性が増します。  
+  
+ 次の 2 つの例は、サブピクセル ポジショニングを使用した場合にサブピクセル境界でグリフを開始できることを示しています。  左側の例は、サブピクセル ポジショニングが採用されていない、旧バージョンの [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レンダラーを使用してレンダリングしたものです。  右側の例は、新しいバージョンの [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レンダラーで、サブピクセル ポジショニングを使用してレンダリングしたものです。  右側のイメージの **e** と **l** が、それぞれ異なるサブピクセルから開始しているために若干異なってレンダリングされていることに注意してください。  グリフ イメージはハイ コントラストであるので、テキストを標準サイズで画面に表示したときは、この違いはわかりません。  これは、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] に組み込まれている高度なカラー フィルター処理によってのみ実現します。  
+  
+ ![2 つのバージョンの ClearType を使用して表示されるテキスト](../../../../docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-01.png "wcpsdk\_mmgraphics\_text\_cleartype\_overview\_01")  
+ClearType の旧バージョンおよび新バージョンによる表示テキスト  
+  
+ 次の 2 つの例では、旧バージョンの [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レンダラーでの出力と新バージョンの [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レンダラーの出力を比較しています。  右側に示したサブピクセル ポジショニングでは、画面上の文字の間隔が大きく改善されています。特に、サブピクセル 1 個とピクセル 1 個の差がグリフの幅に占める割合の大きい、小さなサイズの場合によくわかります。  2 番目のイメージの方が、文字の間隔が均等に近くなっています。  サブピクセル ポジショニングによるさまざまなメリットがテキスト画面全体の外観に及ぼす効果は大幅に増加しましたが、これは [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] テクノロジが大きく進歩したことを表しています。  
+  
+ ![以前のバージョンの ClearType を使用して表示されるテキスト](../../../../docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-02.png "wcpsdk\_mmgraphics\_text\_cleartype\_overview\_02")  
+ClearType の旧バージョンおよび新バージョンによるテキスト  
+  
+<a name="y-direction_antialiasing"></a>   
+## Y 方向のアンチエイリアス  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] のもう 1 つの改善点は、y 方向のアンチエイリアシングです。  y 方向のアンチエイリアシングを行わない [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] では、x 軸上では高い解像度を得られますが、y 軸上では解像度が低くなります。  緩やかな曲線部分の上下では、端がぎざぎざになって読みにくくなります。  
+  
+ 次の例では、y 方向のアンチエイリアシングを使用しない場合の効果を示します。  この場合、文字の上下で端がぎざぎざになっていることがよくわかります。  
+  
+ ![緩やかな曲線上にギザギザした境界が付いたテキスト](../../../../docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-03.png "wcpsdk\_mmgraphics\_text\_cleartype\_overview\_03")  
+滑らかな曲線部分で端がぎざぎざになっているテキスト  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] には、ぎざぎざになっている輪郭を滑らかにする y 方向レベルのアンチエイリアシング機能があります。  これは、東アジア言語を読みやすくするために特に重要です。これらの言語の表意文字では、緩やかな曲線の量が水平方向と垂直方向でほぼ同じであるからです。  
+  
+ 次の例では、y 方向のアンチエイリアシングの効果を示します。  文字の上下の曲線が滑らかに表示されています。  
+  
+ ![ClearType y 方向アンチエイリアシングを含むテキスト](../../../../docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-04.png "wcpsdk\_mmgraphics\_text\_cleartype\_overview\_04")  
+ClearType の y 方向アンチエイリアシングを適用したテキスト  
+  
+<a name="hardware_acceleration"></a>   
+## ハードウェアの高速化  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、ハードウェア アクセラレーションを利用してパフォーマンスを向上させ、CPU の負荷および必要なシステム メモリを削減します。  グラフィックス カードのピクセル シェーダーおよびビデオ メモリを使用することにより、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] では特にアニメーション使用時のテキストのレンダリングが速くなります。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] によって、システム全体の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] 設定が変更されることはありません。  [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] を無効にすると、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のアンチエイリアシングがグレースケール モードに設定されます。また、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] によって、[ClearType Tuner PowerToy](http://www.microsoft.com/typography/ClearTypePowerToy.mspx) の設定が変更されることはありません。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のアーキテクチャ設計における決定事項の 1 つに、解像度に依存しないレイアウトによる高解像度 DPI モニターのサポート向上があります。高解像度モニターの普及は進みつつあるからです。  この決定を受けて、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ではエイリアス化されたテキスト レンダリングや、一部の東アジア言語フォントのビットマップをサポートしないことになりました。これらはどちらも解像度に依存するためです。  
+  
+<a name="further_information"></a>   
+## 詳細情報  
+ [ClearType Information \(ClearType の情報\)](http://www.microsoft.com/typography/ClearTypeInfo.mspx)  
+  
+ [ClearType Tuner PowerToy \(ClearType Tuner PowerToy\)](http://www.microsoft.com/typography/ClearTypePowerToy.mspx)  
+  
+## 参照  
+ [ClearType レジストリの設定](../../../../docs/framework/wpf/advanced/cleartype-registry-settings.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/cleartype-registry-settings.md b/docs/framework/wpf/advanced/cleartype-registry-settings.md
new file mode 100644
index 00000000000..cebabbe408a
--- /dev/null
+++ b/docs/framework/wpf/advanced/cleartype-registry-settings.md
@@ -0,0 +1,127 @@
+---
+title: "ClearType レジストリの設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ClearType, レジストリ設定"
+  - "タイポグラフィ, ClearType レジストリの設定"
+ms.assetid: 56f314bb-b30b-4f67-8492-8b8a9fa432ae
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ClearType レジストリの設定
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで使用される [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA#tla_ct](../../../../includes/tlasharptla-ct-md.md)] レジストリ設定の概要について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overview"></a>   
+## テクノロジの概要  
+ ディスプレイ デバイスにテキストをレンダリングする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] 機能を使用して読みやすさを拡張します。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、ラップトップや Pocket PC の画面、フラット パネル モニターなど、既存の LCD \(液晶ディスプレイ\) でのテキストの読みやすさを向上させるために [!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] が開発したソフトウェア テクノロジです。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、LCD 画面の各ピクセル内の個々の垂直カラー ストライプ要素にアクセスすることによって機能します。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の詳細については、「[ClearType の概要](../../../../docs/framework/wpf/advanced/cleartype-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] でレンダリングされるテキストの表示は、表示先のディスプレイ デバイスによって大きく異なります。  たとえば、一般的な赤、緑、青 \([!INCLUDE[TLA#tla_rgb](../../../../includes/tlasharptla-rgb-md.md)]\) の順ではなく青、緑、赤の順でカラー ストライプ要素を実装するモニターもわずかに存在します。  
+  
+ また、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] でレンダリングされるテキストの表示は、各個人の色の感度レベルによっても大きく異なります。  他の人よりも色のわずかな違いを見分ける能力に長けている人もいます。  
+  
+ それぞれの場合において、各個人が最も読みやすい表示を実現するために、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] 機能を変更する必要があります。  
+  
+<a name="registry_settings"></a>   
+## レジストリ設定  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の機能を制御するための 4 つのレジストリ設定が用意されています。  
+  
+|設定|Description|  
+|--------|-----------------|  
+|[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベル|[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の色の鮮明度を示します。|  
+|ガンマ レベル|ディスプレイ デバイスのピクセル カラー コンポーネントのレベルを示します。|  
+|ピクセル構造|ディスプレイ デバイスのピクセルの配置を示します。|  
+|テキストのコントラスト レベル|表示されるテキストのコントラストのレベルを示します。|  
+  
+ これらの設定には、所定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レジストリ設定の参照方法を認識している外部構成ユーティリティを使用してアクセスできます。  また、これらの設定は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] レジストリ エディターを使用して値に直接アクセスして作成または変更することもできます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レジストリ設定が設定されていない場合 \(既定の状態\)、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、フォント スムージング設定について [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] システム パラメーター情報に照会します。  
+  
+> [!NOTE]
+>  ディスプレイ デバイス名の列挙については、`SystemParametersInfo` [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 関数を参照してください。  
+  
+<a name="ClearType_level"></a>   
+## ClearType レベル  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルを設定すると、個人の色の感度および知覚に基づいてテキストのレンダリングを調整できます。人によっては、最高レベルの [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] を使用するテキストのレンダリングでは最も読みやすい表示が実現されない場合があります。  
+  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルは、0 ～ 100 の範囲の整数値です。  既定のレベルは 100 です。これは、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] でディスプレイ デバイスの最大限のカラー ストライプ要素が使用されることを意味します。  ただし、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルが 0 の場合、テキストはグレースケールでレンダリングされます。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルを 0 ～ 100 の間に設定することで、個人の色の感度に適した中間レベルを実現できます。  
+  
+### レジストリ設定  
+ [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルのレジストリ設定は、特定のディスプレイ デバイス名に対応する個別のユーザー設定の場所にあります。  
+  
+ `HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics\<displayName>`  
+  
+ ユーザのディスプレイ デバイス名ごとに `ClearTypeLevel` の DWORD 値が定義されます。  次のスクリーンショットは、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] レベルのレジストリ エディターの設定を示しています。  
+  
+ ![レジストリ エディターの ClearType 設定](../../../../docs/framework/wpf/advanced/media/cleartyperegistry01.png "ClearTypeRegistry01")  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、[!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] を使用する場合と使用しない場合のいずれかのモードでテキストがレンダリングされます。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] を使用しないテキストのレンダリングは、グレースケール レンダリングと呼ばれます。  
+  
+<a name="gamma_level"></a>   
+## ガンマ レベル  
+ ガンマ レベルとは、ピクセル値とルミナンス間の非線形リレーションシップのことです。  ガンマ レベル設定は、ディスプレイ デバイスの物理特性に対応する必要があります。対応していない場合、レンダリング出力にゆがみが発生する場合があります。  たとえば、テキストの表示が広すぎたり細すぎたりする場合や、色縁がグリフの縦線の端に表示される場合などがあります。  
+  
+ ガンマ レベルは、1000 ～ 2200 の範囲の整数値です。  既定のレベルは 1900 です。  
+  
+### レジストリ設定  
+ ガンマ レベルのレジストリ設定は、特定のディスプレイ デバイス名に対応するローカル マシン設定の場所にあります。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Avalon.Graphics\<displayName>`  
+  
+ ユーザのディスプレイ デバイス名ごとに `GammaLevel` の DWORD 値が定義されます。  次のスクリーンショットは、ガンマ レベルのレジストリ エディターの設定を示しています。  
+  
+ ![レジストリ エディターの ClearType 設定](../../../../docs/framework/wpf/advanced/media/cleartyperegistry02.png "ClearTypeRegistry02")  
+  
+<a name="pixel_structure"></a>   
+## ピクセル構造  
+ ピクセル構造は、ディスプレイ デバイスを構成するピクセルの種類を示します。  ピクセル構造は、次の 3 種類のいずれかとして定義されます。  
+  
+|種類|値|Description|  
+|--------|-------|-----------------|  
+|フラット|0|ディスプレイ デバイスにピクセル構造がありません。  つまり、各色の光源がピクセル領域に均等に拡散しています。これは、グレースケール レンダリングと呼ばれます。  標準のディスプレイ デバイスはこのようにして機能します。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] はレンダリングされたテキストに適用されません。|  
+|RGB|1|ディスプレイ デバイスのピクセルは、赤、緑、青の順の 3 つのストライプで構成されます。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] がレンダリングされたテキストに適用されます。|  
+|BGR|2|ディスプレイ デバイスのピクセルは、青、緑、赤の順の 3 つのストライプで構成されます。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] がレンダリングされたテキストに適用されます。  順序が RGB の場合の逆であることに注目してください。|  
+  
+ ピクセル構造は、0 ～ 2 の範囲の整数値に対応します。  既定のレベルは 0 です。これは、フラット ピクセル構造を表します。  
+  
+> [!NOTE]
+>  ディスプレイ デバイス名の列挙については、`EnumDisplayDevices` [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 関数を参照してください。  
+  
+### レジストリ設定  
+ ピクセル構造のレジストリ設定は、特定のディスプレイ デバイス名に対応するローカル マシン設定の場所にあります。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Avalon.Graphics\<displayName>`  
+  
+ ユーザのディスプレイ デバイス名ごとに `PixelStructure` の DWORD 値が定義されます。  次のスクリーンショットは、ピクセル構造のレジストリ エディターの設定を示しています。  
+  
+ ![レジストリ エディターの ClearType 設定](../../../../docs/framework/wpf/advanced/media/cleartyperegistry02.png "ClearTypeRegistry02")  
+  
+<a name="text_contrast_level"></a>   
+## テキストのコントラスト レベル  
+ テキストのコントラスト レベルを設定すると、グリフの縦線の幅に基づいてテキストのレンダリングを調整できます。  テキストのコントラスト レベルは、0 ～ 6 の範囲の整数値です。整数値を大きくすると、縦線の幅が広くなります。  既定のレベルは 1 です。  
+  
+### レジストリ設定  
+ テキストのコントラスト レベルのレジストリ設定は、特定のディスプレイ デバイス名に対応する個別のユーザー設定の場所にあります。  
+  
+ `HKEY_CURRENT_USER\Software\Microsoft\Avalon.Graphics\<displayName>`  
+  
+ ユーザのディスプレイ デバイス名ごとに `TextContrastLevel` の DWORD 値が定義されます。  次のスクリーンショットは、テキストのコントラスト レベルのレジストリ エディターの設定を示しています。  
+  
+ ![レジストリ エディターの ClearType 設定](../../../../docs/framework/wpf/advanced/media/cleartyperegistry01.png "ClearTypeRegistry01")  
+  
+## 参照  
+ [ClearType の概要](../../../../docs/framework/wpf/advanced/cleartype-overview.md)   
+ [ClearType アンチエイリアシング](_win32_ClearType_Antialiasing)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md b/docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md
new file mode 100644
index 00000000000..d49b61d376d
--- /dev/null
+++ b/docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md
@@ -0,0 +1,72 @@
+---
+title: "WPF における分離コードと XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "分離コード ファイル, XAML"
+  - "XAML, 分離コード"
+ms.assetid: 9df6d3c9-aed3-471c-af36-6859b19d999f
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# WPF における分離コードと XAML
+<a name="introduction"></a> 分離コードとは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページがマークアップ コンパイルされる際に、マークアップ定義オブジェクトによって結合されるコードを表す用語です。  ここでは、分離コードの要件と、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 内のコードの代替インライン コード機構について説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [必要条件](#Prerequisites)  
+  
+-   [分離コードと XAML 言語](#codebehind_and_the_xaml_language)  
+  
+-   [WPF における分離コード、イベント ハンドラー、および部分クラスの要件](#Code_behind__Event_Handler__and_Partial_Class)  
+  
+-   [x:Code](#x_Code)  
+  
+-   [インライン コードの制限](#Inline_Code_Limitations)  
+  
+<a name="Prerequisites"></a>   
+## 必要条件  
+ このトピックでは、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を通読していることと、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] およびオブジェクト指向プログラミングに関する基礎知識があることを前提にしています。  
+  
+<a name="codebehind_and_the_xaml_language"></a>   
+## 分離コードと XAML 言語  
+ XAML 言語には、コード ファイルをマークアップ ファイル側からマークアップ ファイルに関連付けることのできる言語レベルの機能が含まれています。  具体的には、XAML 言語で [x:Class ディレクティブ](../../../../docs/framework/xaml-services/x-class-directive.md)、[x:Subclass ディレクティブ](../../../../docs/framework/xaml-services/x-subclass-directive.md) および [x:ClassModifier ディレクティブ](../../../../docs/framework/xaml-services/x-classmodifier-directive.md) という言語機能が定義されています。  XAML 言語は、コードの生成方法、およびマークアップとコードの統合方法を正確に指定するものではありません。  コードの統合方法、アプリケーションとプログラミング モデルでの XAML の使用方法、これらの操作に必要なビルド アクションまたは他のサポート機能の判別は、WPF などのフレームワークで行います。  
+  
+<a name="Code_behind__Event_Handler__and_Partial_Class"></a>   
+## WPF における分離コード、イベント ハンドラー、および部分クラスの要件  
+  
+-   部分クラスは、ルート要素をサポートする型から派生する必要があります。  
+  
+-   マークアップ コンパイルによるビルド アクションの既定の動作では、分離コード側の部分クラス定義における派生を空白のままにできます。  コンパイル結果は、指定されていない場合でも、ページ ルートのバッキング型が部分クラスの基礎になると仮定されます。  ただし、この動作に依存することはお勧めしません。  
+  
+-   分離コードで記述したイベント ハンドラーは、インスタンス メソッドである必要があります。静的メソッドにすることはできません。  これらのメソッドは、`x:Class` で識別される CLR 名前空間内の部分クラスによって定義される必要があります。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサがイベント ハンドラーの検索を異なるクラス スコープ内のイベント接続で行うように、イベント ハンドラーの名前を修飾することはできません。  
+  
+-   ハンドラーは、バッキング型システム内の適切なイベントのデリゲートと一致する必要があります。  
+  
+-   [!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] 言語の場合に限り、言語固有の `Handles` キーワードを使用すると、ハンドラーを、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 内の属性に関連付ける代わりに、ハンドラー宣言内のインスタンスとイベントに関連付けることができます。  ただし、この手法にはいくつかの制限もあります。一定のルーティング イベント シナリオや添付イベントなど、`Handles` キーワードでサポートできない [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント システムの特定機能が存在するためです。  詳細については、「[Visual Basic と WPF のイベント処理](../../../../docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md)」を参照してください。  
+  
+<a name="x_Code"></a>   
+## x:Code  
+ [x:Code](../../../../docs/framework/xaml-services/x-code-intrinsic-xaml-type.md) は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義されるディレクティブ要素です。`x:Code` ディレクティブ要素には、インラインのプログラミング コードを含めることができます。  インラインで定義されたコードは、同一ページ上の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] と対話できます。  [!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] のインライン コードを次の例に示します。  コードは `x:Code` 要素内に含まれており、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] のコンテンツをエスケープする `<CDATA[`...`]]>` でコードを囲んでいるのは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサ \([!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] スキーマまたは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] スキーマを解釈\) がこのコンテンツをリテラルに [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] として解釈しないようにする必要があるためです。  
+  
+ [!code-xml[XAMLOvwSupport#ButtonWithInlineCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page4.xaml#buttonwithinlinecode)]  
+  
+<a name="Inline_Code_Limitations"></a>   
+## インライン コードの制限  
+ インライン コードを使用しないようにするか、限定的に使用することを考慮する必要があります。  アーキテクチャおよびコーディングの原理という点では、マークアップと分離コードを切り離しておくことによって、デザイナーと開発者の役割もはっきりと区別できます。  より技術的なレベルで言えば、インライン コードとして作成するコードは記述が面倒な場合があります。常に [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に生成された部分クラス内に記述することとなり、既定の XML 名前空間のマッピングしか使用できないためです。  `using` ステートメントを追加できないため、作成する [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] 呼び出しの多くを完全に修飾する必要があります。  既定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マッピングには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アセンブリ内に存在する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 名前空間のほとんどが含まれますが、すべての名前空間が含まれるのではありません。他の CLR 名前空間内に含まれる型とメンバーへの呼び出しを完全に修飾することが必要になります。  また、インライン コードでは部分クラス以外を定義することはできません。参照するすべてのユーザー コード エンティティが、生成された部分クラス内のメンバーまたは変数として存在する必要があります。  マクロ、グローバル変数やビルド変数に対する `#ifdef` など、言語固有のその他のプログラミング機能も使用できません。  詳細については、「[x:Code 組み込み XAML 型](../../../../docs/framework/xaml-services/x-code-intrinsic-xaml-type.md)」を参照してください。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [x:Code 組み込み XAML 型](../../../../docs/framework/xaml-services/x-code-intrinsic-xaml-type.md)   
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)   
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/collecting-ink.md b/docs/framework/wpf/advanced/collecting-ink.md
new file mode 100644
index 00000000000..4ef4c8d158c
--- /dev/null
+++ b/docs/framework/wpf/advanced/collecting-ink.md
@@ -0,0 +1,87 @@
+---
+title: "インクの収集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "収集 (デジタル インクを)"
+  - "DefaultDrawingAttributes プロパティ"
+  - "デジタル インク, 収集"
+  - "DrawingAttributes プロパティ"
+  - "インク, 収集"
+  - "InkCanvas 要素"
+  - "プロパティ, DefaultDrawingAttributes"
+  - "プロパティ, DrawingAttributes"
+ms.assetid: 66a3129d-9577-43eb-acbd-56c147282016
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# インクの収集
+[Windows Presentation Foundation](../../../../docs/framework/wpf/index.md) プラットフォームでは、その機能の中核としてデジタル インクが収集されます。  ここでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] でのインクの収集方法について説明します。  
+  
+## 必要条件  
+ 以降に示す例を使用するには、まず [!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] と [!INCLUDE[TLA2#tla_winfxsdk](../../../../includes/tla2sharptla-winfxsdk-md.md)] をインストールする必要があります。  また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に対応するアプリケーションの作成方法も理解しておく必要があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の概要については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  
+  
+## InkCanvas 要素の使用  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で最も簡単にインクを収集する方法は、<xref:System.Windows.Controls.InkCanvas> 要素を使用することです。  <xref:System.Windows.Controls.InkCanvas> 要素は、[!INCLUDE[TLA2#tla_tpclssdk](../../../../includes/tla2sharptla-tpclssdk-md.md)] 以前のバージョンの <xref:Microsoft.Ink.InkOverlay> オブジェクトに似ています。  
+  
+ <xref:System.Windows.Controls.InkCanvas> 要素は、インク入力を受け取って表示するために使用します。  インクは一般的に、スタイラスを使用して入力します。スタイラスはデジタイザーとの対話により、インク ストロークを生成します。  また、スタイラスの代わりにマウスを使用することもできます。  生成されたストロークは <xref:System.Windows.Ink.Stroke> オブジェクトとして表され、プログラムとユーザー入力の両方によって操作できます。  <xref:System.Windows.Controls.InkCanvas> を使用すると、ユーザーは既存の <xref:System.Windows.Ink.Stroke> を選択、変更、または削除することができます。  
+  
+ XAML を使用して、`InkCanvas` 要素をツリーに追加するだけで簡単にインク収集を設定できます。  次の例では、[!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] で作成された既定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロジェクトに <xref:System.Windows.Controls.InkCanvas> を追加します。  
+  
+ [!code-xml[DigitalInkTopics#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window2.xaml#6)]  
+  
+ `InkCanvas` 要素には子要素を含めることもできます。これにより、ほとんどすべての XAML 要素にインク注釈機能を追加できます。  たとえば、インク処理機能をテキスト要素に追加するには、単にその要素を <xref:System.Windows.Controls.InkCanvas> の子にします。  
+  
+ [!code-xml[DigitalInkTopics#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window2.xaml#5)]  
+  
+ インクを使用したイメージのマークアップのサポートも、簡単に追加できます。  
+  
+ [!code-xml[DigitalInkTopics#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window2.xaml#7)]  
+  
+### InkCollection モード  
+ <xref:System.Windows.Controls.InkCanvas> は、<xref:System.Windows.Controls.InkCanvas.EditingMode%2A> プロパティを使用してさまざまな入力モードをサポートします。  
+  
+### インクの操作  
+ <xref:System.Windows.Controls.InkCanvas> は、さまざまなインク編集操作をサポートしています。  たとえば、<xref:System.Windows.Controls.InkCanvas> は、ペンの消しゴム ツールによる消去をサポートします。この機能を要素に追加するために、追加コードは必要ありません。  
+  
+#### Selection  
+ 選択モードは、<xref:System.Windows.Controls.InkCanvasEditingMode> プロパティを **Select** に設定するだけで、簡単に設定できます。  次のコードは、<xref:System.Windows.Forms.CheckBox> の値に基づいて編集モードを設定します。  
+  
+ [!code-csharp[DigitalInkTopics#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml.cs#8)]
+ [!code-vb[DigitalInkTopics#8](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DigitalInkTopics/VisualBasic/Window1.xaml.vb#8)]  
+  
+#### DrawingAttributes  
+ <xref:System.Windows.Ink.Stroke.DrawingAttributes%2A> プロパティは、インク ストロークの外観を変更するために使用します。  たとえば、<xref:System.Windows.Ink.DrawingAttributes> の <xref:System.Windows.Ink.DrawingAttributes.Color%2A> メンバーは、描画される <xref:System.Windows.Ink.Stroke> の色を設定します。  選択されたストロークの色を赤に変更する方法を次の例に示します。  
+  
+ [!code-csharp[DigitalInkTopics#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml.cs#9)]
+ [!code-vb[DigitalInkTopics#9](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DigitalInkTopics/VisualBasic/Window1.xaml.vb#9)]  
+  
+### DefaultDrawingAttributes  
+ <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A> プロパティを使用すると、<xref:System.Windows.Controls.InkCanvas> で作成されるストロークの高さ、幅、色などのプロパティにアクセスできます。  <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A> を変更すると、それ以降に <xref:System.Windows.Controls.InkCanvas> に入力されるストロークはすべて新しいプロパティ値を使用して描画されます。  
+  
+ 分離コード ファイルでの <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A> の変更に加えて、XAML 構文を使用した <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A> プロパティの指定もできます。  <xref:System.Windows.Ink.DrawingAttributes.Color%2A> プロパティを設定する方法を次の XAML コードに示します。  このコードを使用するには、Visual Studio 2005 で "HelloInkCanvas" という新しい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロジェクトを作成します。  Window1.xaml ファイルのコードを次のコードに置き換えます。  
+  
+ [!code-xml[HelloInkCanvas#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HelloInkCanvas/CSharp/Window1.xaml#1)]  
+  
+ 次に、以下のボタン イベント ハンドラーを、分離コード ファイルの Window1 クラス内に追加します。  
+  
+ [!code-csharp[HelloInkCanvas#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HelloInkCanvas/CSharp/Window1.xaml.cs#2)]  
+  
+ このコードのコピー後に、Microsoft Visual Studio 2005 で F5 キーを押し、デバッガーでプログラムを実行します。  
+  
+ <xref:System.Windows.Controls.StackPanel> によってボタンが <xref:System.Windows.Controls.InkCanvas> の上に配置されることに注目してください。  ボタンの上でインク処理を実行しようとすると、<xref:System.Windows.Controls.InkCanvas> によってインクがボタンの背後で収集および描画されます。  これは、ボタンが <xref:System.Windows.Controls.InkCanvas> の子ではなく兄弟であるためです。  また、ボタンは z オーダーの上位に位置するため、インクはその背後で描画されます。  
+  
+## 参照  
+ <xref:System.Windows.Ink.DrawingAttributes>   
+ <xref:System.Windows.InkCanvas.DefaultDrawingAttributes%2A>   
+ <xref:System.Windows.Ink>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/collection-type-dependency-properties.md b/docs/framework/wpf/advanced/collection-type-dependency-properties.md
new file mode 100644
index 00000000000..6edb2f93b31
--- /dev/null
+++ b/docs/framework/wpf/advanced/collection-type-dependency-properties.md
@@ -0,0 +1,71 @@
+---
+title: "コレクション型依存関係プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション型プロパティ"
+  - "依存関係プロパティ"
+  - "プロパティ, コレクション型"
+  - "プロパティ, 依存関係"
+ms.assetid: 99f96a42-3ab7-4f64-a16b-2e10d654e97c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# コレクション型依存関係プロパティ
+ここでは、プロパティの型がコレクション型である場合に[依存関係プロパティ](GTMT)を実装する方法についての、ガイダンスと推奨されるパターンを示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="implementing"></a>   
+## コレクション型依存関係プロパティの実装  
+ 一般に、依存関係プロパティの場合、使用する実装パターンは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティ ラッパーを定義するものです。この場合、そのプロパティは、フィールドや他の構造ではなく <xref:System.Windows.DependencyProperty> 識別子によってサポートされます。  コレクション型プロパティを実装するときは、これと同じパターンに従います。  ただし、コレクションに含まれる型それ自体が <xref:System.Windows.DependencyObject> または <xref:System.Windows.Freezable> の派生クラスである場合は常に、コレクション型プロパティを使用することでパターンは複雑になります。  
+  
+<a name="initializing"></a>   
+## 既定値を上回るコレクションの初期化  
+ 依存関係プロパティを作成するときは、初期フィールド値としてプロパティの既定値を指定しません。  代わりに、依存関係プロパティのメタデータを使用して既定値を指定します。  プロパティが参照型の場合、依存関係プロパティのメタデータで指定する既定値はインスタンスごとの既定値ではありません。その型のすべてのインスタンスに適用される既定値です。  したがって、コレクション プロパティ メタデータによって定義される単一の静的コレクションを、その型の新しく作成されるインスタンスの作業既定値として使用しないように注意してください。  代わりに、クラス コンストラクターのロジックの一部として、コレクションの値に一意 \(インスタンス\) のコレクションを意図的に設定する必要があります。  それ以外の場合は、意図しないシングルトン クラスを作成することになります。  
+  
+ 例を次に示します。  この例は、`Aquarium` クラスの定義を示しています。  このクラスで定義されているコレクション型依存関係プロパティ `AquariumObjects` は、<xref:System.Windows.FrameworkElement> 型の制約でジェネリック <xref:System.Collections.Generic.List%601> 型を使用します。  依存関係プロパティに対する <xref:System.Windows.DependencyProperty.Register%28System.String%2CSystem.Type%2CSystem.Type%2CSystem.Windows.PropertyMetadata%29> の呼び出しでは、メタデータが、既定値を新しいジェネリック <xref:System.Collections.Generic.List%601> に設定します。  
+  
+ [!code-csharp[PropertiesOvwSupport#CollectionProblemDefinition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#collectionproblemdefinition)]
+ [!code-vb[PropertiesOvwSupport#CollectionProblemDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#collectionproblemdefinition)]  
+[!code-csharp[PropertiesOvwSupport#CollectionProblemEndB](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#collectionproblemendb)]
+[!code-vb[PropertiesOvwSupport#CollectionProblemEndB](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#collectionproblemendb)]  
+  
+ ただし、コードをこのままにすると、単一のリストの既定値が `Aquarium` のすべてのインスタンスで共有されます。  次のテスト コードは、2 つの異なる `Aquarium` インスタンスをインスタンス化し、それぞれに単一の異なる `Fish` を追加する方法を示していますが、これを実行すると、想定外の結果になります。  
+  
+ [!code-csharp[PropertiesOvwSupport#CollectionProblemTestCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#collectionproblemtestcode)]
+ [!code-vb[PropertiesOvwSupport#CollectionProblemTestCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#collectionproblemtestcode)]  
+  
+ 各コレクションのカウントが 1 になるのではなく、いずれのコレクションもカウントが 2 になります。  これは、各 `Aquarium` は `Fish` を既定値のコレクションに追加しますが、その基になっているのはメタデータでの単一のコンストラクター呼び出しであり、したがってすべてのインスタンス間で共有されるためです。  これは望ましい状況ではありません。  
+  
+ この問題を回避するには、クラス コンストラクターの呼び出しの一部として、コレクションの依存関係プロパティの値を一意のインスタンスにリセットする必要があります。  プロパティは読み取り専用の依存関係プロパティであるため、クラス内だけでアクセスできる <xref:System.Windows.DependencyPropertyKey> を使用し、<xref:System.Windows.DependencyObject.SetValue%28System.Windows.DependencyPropertyKey%2CSystem.Object%29> メソッドを使用して設定します。  
+  
+ [!code-csharp[PropertiesOvwSupport#CollectionProblemCtor](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#collectionproblemctor)]
+ [!code-vb[PropertiesOvwSupport#CollectionProblemCtor](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#collectionproblemctor)]  
+  
+ 再びテスト コードを実行すると、結果は期待したものに近くなり、各 `Aquarium` が独自の一意のコレクションをサポートします。  
+  
+ コレクション プロパティを読み取り\/書き込みにすると、このパターンには若干のバリエーションが発生します。  この場合は、コンストラクターからパブリック set アクセサーを呼び出して初期化を行うことができ、パブリック <xref:System.Windows.DependencyProperty> 識別子を使用して、set ラッパー内でキーなしのシグネチャの <xref:System.Windows.DependencyObject.SetValue%28System.Windows.DependencyProperty%2CSystem.Object%29> を呼び出します。  
+  
+## コレクション プロパティからのバインディング値変更の報告  
+ それ自体が依存関係プロパティであるコレクション プロパティは、変更をサブプロパティに自動的には報告しません。  コレクションにバインディングを作成している場合は、これによってバインディングが変更を報告しないことがあり、一部のデータ バインディング シナリオが無効になります。  ただし、コレクション型として <xref:System.Windows.FreezableCollection%601> を使用している場合は、コレクションに含まれる要素に対するサブプロパティの変更は正しく報告され、バインディングは意図したとおりに動作します。  
+  
+ 依存関係オブジェクト コレクションでサブプロパティのバインディングを有効にするには、<xref:System.Windows.FreezableCollection%601> 型としてコレクション プロパティを作成し、そのコレクションの型制約を <xref:System.Windows.DependencyObject> 派生クラスに指定します。  
+  
+## 参照  
+ <xref:System.Windows.FreezableCollection%601>   
+ [WPF における XAML とカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/colorconvertedbitmap-markup-extension.md b/docs/framework/wpf/advanced/colorconvertedbitmap-markup-extension.md
new file mode 100644
index 00000000000..89e5fbf490e
--- /dev/null
+++ b/docs/framework/wpf/advanced/colorconvertedbitmap-markup-extension.md
@@ -0,0 +1,49 @@
+---
+title: "ColorConvertedBitmap のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ColorConvertedBitmap マークアップ拡張機能"
+  - "XAML, ColorConvertedBitmap マークアップ拡張機能"
+ms.assetid: 18321c18-c898-4470-93fa-a702b47770c1
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ColorConvertedBitmap のマークアップ拡張機能
+埋め込まれたプロファイルのないビットマップ ソースを指定する方法を提供します。  カラー コンテキスト\/プロファイルは、イメージ リソース [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] と同じように [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] で指定されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{ColorConvertedBitmap imageSource sourceIIC destinationIIC}" .../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`imageSource`|プロファイルになっていないビットマップの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。|  
+|`sourceIIC`|ソース プロファイル構成の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。|  
+|`destinationIIC`|変換先プロファイル構成の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。|  
+  
+## 解説  
+ このマークアップ拡張機能は、<xref:System.Windows.Media.Imaging.BitmapImage.UriSource%2A> などの関連するイメージ ソース プロパティ値のセットを塗りつぶすためのものです。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `ColorConvertedBitmap` \(または `ColorConvertedBitmapExtension`\) は、プロパティ要素構文では使用できません。これは、値は初期コンストラクターの値としてのみ設定でき、拡張機能の識別子に従う文字列であるためです。  
+  
+ `ColorConvertedBitmap` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のすべてのマークアップ拡張機能では、それぞれの属性構文で { と } の 2 つの記号を使用します。これは規約であり、これに従って [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Imaging.BitmapImage.UriSource%2A>   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/commanding-overview.md b/docs/framework/wpf/advanced/commanding-overview.md
new file mode 100644
index 00000000000..2bca0bc6cee
--- /dev/null
+++ b/docs/framework/wpf/advanced/commanding-overview.md
@@ -0,0 +1,200 @@
+---
+title: "コマンド実行の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, CommandBinding"
+  - "コマンド ライブラリ"
+  - "CommandBindings"
+  - "コマンド実行"
+  - "CommandManager"
+  - "コマンド, 定義"
+  - "ICommandSource インターフェイス"
+  - "インターフェイス, ICommandSource"
+ms.assetid: bc208dfe-367d-426a-99de-52b7e7511e81
+caps.latest.revision: 35
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# コマンド実行の概要
+<a name="introduction"></a> コマンド実行は、デバイス入力よりも意味を持つレベルで入力を処理する [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の入力機構です。  コマンドの例としては、多くのアプリケーションで目にする **\[コピー\]**、**\[切り取り\]**、**\[貼り付け\]** などの操作があります。  
+  
+ ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] にはどんなコマンドがあるか、コマンド実行モデルに含まれるクラス、およびアプリケーションでコマンドを使用および作成する方法について説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [コマンドとは](#commands_at_10000_feet)  
+  
+-   [WPF の簡単なコマンドの例](#simple_command)  
+  
+-   [WPF のコマンド実行の 4 つの主要な概念](#Four_main_Concepts)  
+  
+-   [コマンド ライブラリ](#Command_Library)  
+  
+-   [カスタム コマンドの作成](#creating_commands)  
+  
+<a name="commands_at_10000_feet"></a>   
+## コマンドとは  
+ コマンドにはいくつかの目的があります。  最初の目的は、コマンドを呼び出すセマンティクスとオブジェクトを、コマンドを実行するロジックから分離することです。  これにより、複数のさまざまなソースで同じコマンド ロジックを呼び出せるようになり、コマンド ロジックをさまざまな対象用にカスタマイズできるようになります。  たとえば、多くのアプリケーションで目にする **\[コピー\]**、**\[切り取り\]**、**\[貼り付け\]** の編集操作は、コマンドを使用して実装されていれば、複数の異なるユーザー アクションから呼び出すことができます。  アプリケーションでは、ボタンのクリック、メニューの項目の選択、または Ctrl \+ X などのショートカット キーの使用によって、選択したオブジェクトまたはテキストを切り取ることができます。  コマンドを使用すると、各種類のユーザー アクションを同じロジックにバインドできます。  
+  
+ コマンドには、アクションが使用可能かどうかを示すという目的もあります。  オブジェクトまたはテキストの切り取りの例を続けると、アクションは何かが選択されているときにのみ効果があります。  ユーザーが何も選択せずにオブジェクトまたはテキストを切り取ろうとしても、何も行われません。  これをユーザーに示すために、多くのアプリケーションでは、ボタンとメニュー項目を無効にして、アクションを実行できるかどうかがわかるようにしています。  コマンドは、<xref:System.Windows.Input.ICommand.CanExecute%2A> メソッドを実装することで、アクションが使用可能かどうかを示すことができます。  ボタンでは、<xref:System.Windows.Input.ICommand.CanExecuteChanged> イベントにサブスクライブし、<xref:System.Windows.Input.ICommand.CanExecute%2A> が `false` を返す場合に無効にし、<xref:System.Windows.Input.ICommand.CanExecute%2A> が `true` を返す場合に有効にすることができます。  
+  
+ コマンドのセマンティクスはアプリケーションおよびクラスの間で一貫していますが、アクションのロジックは実行される特定のオブジェクトに固有です。  Ctrl \+ X というショートカット キーは、テキスト クラス、イメージ クラス、および Web ブラウザーで **\[切り取り\]** コマンドを呼び出しますが、**\[切り取り\]** 操作を実行するための実際のロジックは、切り取りを実行するアプリケーションによって定義されます。  <xref:System.Windows.Input.RoutedCommand> は、クライアントによるロジックの実装を可能にします。  テキスト オブジェクトでは選択されたテキストをクリップボードに切り取る一方で、イメージ オブジェクトでは選択されたイメージを切り取ることができます。  アプリケーションは、<xref:System.Windows.Input.CommandManager.Executed> イベントを処理する場合に、コマンドのターゲットにアクセスし、ターゲットの種類に応じて適切なアクションを実行できます。  
+  
+<a name="simple_command"></a>   
+## WPF の簡単なコマンドの例  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でコマンドを使用する最も簡単な方法は、コマンド ライブラリ クラスのいずれかから定義済みの <xref:System.Windows.Input.RoutedCommand> を使用すること、コマンドの処理をネイティブにサポートしているコントロールを使用すること、およびコマンドの呼び出しをネイティブにサポートしているコントロールを使用することです。  <xref:System.Windows.Input.ApplicationCommands.Paste%2A> コマンドは、<xref:System.Windows.Input.ApplicationCommands> クラスの定義済みコマンドの 1 つです。  <xref:System.Windows.Controls.TextBox> コントロールには、<xref:System.Windows.Input.ApplicationCommands.Paste%2A> コマンドを処理するためのロジックが組み込まれており、  <xref:System.Windows.Controls.MenuItem> クラスは、コマンドの呼び出しをネイティブにサポートしています。  
+  
+ <xref:System.Windows.Controls.TextBox> にキーボード フォーカスがある場合に、<xref:System.Windows.Controls.MenuItem> がクリックされると <xref:System.Windows.Controls.TextBox> で <xref:System.Windows.Input.ApplicationCommands.Paste%2A> コマンドを呼び出すように <xref:System.Windows.Controls.MenuItem> を設定する方法を次の例に示します。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewSimpleCommand](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewsimplecommand)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcommandtargetcodebehind)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcommandtargetcodebehind)]  
+  
+<a name="Four_main_Concepts"></a>   
+## WPF のコマンド実行の 4 つの主要な概念  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のルーティング コマンド モデルは、コマンド、コマンド ソース、コマンドの対象、およびコマンド バインディングの 4 つの主要な概念に分けることができます。  
+  
+-   *コマンド*は、実行されるアクションです。  
+  
+-   *コマンド ソース*は、コマンドを呼び出すオブジェクトです。  
+  
+-   *コマンドの対象*は、コマンドが実行されているオブジェクトです。  
+  
+-   *コマンド バインディング*は、コマンド ロジックをコマンドに割り当てるオブジェクトです。  
+  
+ 前の例では、<xref:System.Windows.Input.ApplicationCommands.Paste%2A> コマンドがコマンド、<xref:System.Windows.Controls.MenuItem> がコマンド ソース、<xref:System.Windows.Controls.TextBox> がコマンドの対象であり、コマンド バインディングは <xref:System.Windows.Controls.TextBox> コントロールによって提供されています。  ただし、<xref:System.Windows.Input.CommandBinding> が、コマンドの対象クラスであるコントロールによって必ず提供されるとは限らないことに注意してください。  アプリケーション開発者が <xref:System.Windows.Input.CommandBinding> を作成する必要がある場合や、<xref:System.Windows.Input.CommandBinding> をコマンドの対象の親に割り当てる場合も多くあります。  
+  
+<a name="Commands"></a>   
+### コマンド  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコマンドを作成するには、<xref:System.Windows.Input.ICommand> インターフェイスを実装します。  <xref:System.Windows.Input.ICommand> は、<xref:System.Windows.Input.ICommand.Execute%2A> および <xref:System.Windows.Input.ICommand.CanExecute%2A> という 2 つのメソッドと、<xref:System.Windows.Input.ICommand.CanExecuteChanged> イベントを公開します。  <xref:System.Windows.Input.ICommand.Execute%2A> はコマンドに関連するアクションを実行します。<xref:System.Windows.Input.ICommand.CanExecute%2A> は現在のコマンドの対象でコマンドを実行できるかどうかを決定します。  <xref:System.Windows.Input.ICommand.CanExecuteChanged> は、コマンド実行操作を集中管理するコマンド マネージャーが、発生済みだがコマンド バインディングによってまだ実行されていないコマンドを無効にする可能性がある変更をコマンド ソース内で検出した場合に発生します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] での <xref:System.Windows.Input.ICommand> の実装は <xref:System.Windows.Input.RoutedCommand> クラスです。この概要ではこのクラスを中心に説明しています。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の主な入力ソースは、マウス、キーボード、インク、およびルーティング コマンドです。  よりデバイス指向の入力では、<xref:System.Windows.RoutedEvent> を使用して、入力イベントが発生したアプリケーション ページ内のオブジェクトを通知します。  <xref:System.Windows.Input.RoutedCommand> も同じです。  <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.RoutedCommand.Execute%2A> メソッドと <xref:System.Windows.Input.RoutedCommand.CanExecute%2A> メソッドには、コマンドのアプリケーション ロジックは含まれませんが、<xref:System.Windows.Input.CommandBinding> を持つオブジェクトを検出するまで、要素ツリー内をトンネリングおよびバブリングするルーティング イベントを発生させます。  <xref:System.Windows.Input.CommandBinding> にはこれらのイベントのハンドラーが含まれ、このハンドラーがコマンドを実行するハンドラーとなります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内でのイベント ルーティングの詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.RoutedCommand.Execute%2A> メソッドは、コマンドの対象で <xref:System.Windows.Input.CommandManager.PreviewExecuted> イベントと <xref:System.Windows.Input.CommandManager.Executed> イベントを発生させます。  <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.RoutedCommand.CanExecute%2A> メソッドは、コマンドの対象で <xref:System.Windows.Input.CommandManager.CanExecute> イベントと <xref:System.Windows.Input.CommandManager.PreviewCanExecute> イベントを発生させます。  これらのイベントは、その特定のコマンドの <xref:System.Windows.Input.CommandBinding> を持つオブジェクトを検出するまで、要素ツリー内をトンネリングおよびバブリングします。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、複数のクラスに散在する一連の一般的なルーティング コマンドである <xref:System.Windows.Input.MediaCommands>、<xref:System.Windows.Input.ApplicationCommands>、<xref:System.Windows.Input.NavigationCommands>、<xref:System.Windows.Input.ComponentCommands>、および <xref:System.Windows.Documents.EditingCommands> を提供します。  これらのクラスは、<xref:System.Windows.Input.RoutedCommand> オブジェクトのみで構成され、コマンドの実装ロジックは含まれません。  実装ロジックは、コマンドが実行されているオブジェクトに含まれます。  
+  
+<a name="Command_Sources"></a>   
+### コマンド ソース  
+ コマンド ソースは、コマンドを呼び出すオブジェクトです。  コマンド ソースには、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Input.KeyGesture> などがあります。  
+  
+ 通常 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコマンド ソースは、<xref:System.Windows.Input.ICommandSource> インターフェイスを実装します。  
+  
+ <xref:System.Windows.Input.ICommandSource> は、<xref:System.Windows.Input.ICommandSource.Command%2A>、<xref:System.Windows.Input.ICommandSource.CommandTarget%2A>、および <xref:System.Windows.Input.ICommandSource.CommandParameter%2A> の 3 つのプロパティを公開します。  
+  
+-   <xref:System.Windows.Input.ICommandSource.Command%2A> は、コマンド ソースが呼び出されると実行されるコマンドです。  
+  
+-   <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> は、コマンドが実行される対象オブジェクトです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Input.ICommandSource> の <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> プロパティは、<xref:System.Windows.Input.ICommand> が <xref:System.Windows.Input.RoutedCommand> の場合にのみ適用されることに注意してください。  <xref:System.Windows.Input.ICommandSource> で <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> が設定されていても、対応するコマンドが <xref:System.Windows.Input.RoutedCommand> でない場合は、コマンドの対象は無視されます。  <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> が設定されていない場合は、キーボード フォーカスを持つ要素がコマンドの対象になります。  
+  
+-   <xref:System.Windows.Input.ICommandSource.CommandParameter%2A> は、コマンドを実装するハンドラーに情報を渡すために使用されるユーザー定義のデータ型です。  
+  
+ <xref:System.Windows.Input.ICommandSource> を実装する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のクラスには、<xref:System.Windows.Controls.Primitives.ButtonBase>、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Documents.Hyperlink>、および <xref:System.Windows.Input.InputBinding> があります。  <xref:System.Windows.Controls.Primitives.ButtonBase>、<xref:System.Windows.Controls.MenuItem>、および <xref:System.Windows.Documents.Hyperlink> は、クリックされるとコマンドを呼び出し、<xref:System.Windows.Input.InputBinding> は、それに関連付けられている <xref:System.Windows.Input.InputGesture> が実行されるとコマンドを呼び出します。  
+  
+ <xref:System.Windows.Controls.ContextMenu> 内の <xref:System.Windows.Controls.MenuItem> を、<xref:System.Windows.Input.ApplicationCommands.Properties%2A> コマンドのコマンド ソースとして使用する方法を次の例に示します。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewCmdSourceXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewcmdsourcexaml)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCmdSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcmdsource)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCmdSource](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcmdsource)]  
+  
+ 通常、コマンド ソースは、<xref:System.Windows.Input.RoutedCommand.CanExecuteChanged> イベントをリッスンします。  このイベントは、現在のコマンドの対象でコマンドを実行できるかどうかが変更された可能性があることをコマンド ソースに通知します。  コマンド ソースは、<xref:System.Windows.Input.RoutedCommand.CanExecute%2A> メソッドを使用して <xref:System.Windows.Input.RoutedCommand> の現在のステータスを照会できます。  コマンドが実行できない場合は、コマンド ソースそのものが無効になります。  コマンドを実行できない場合に灰色表示される <xref:System.Windows.Controls.MenuItem> は、この一例です。  
+  
+ <xref:System.Windows.Input.InputGesture> は、コマンド ソースとして使用できます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の入力ジェスチャには、<xref:System.Windows.Input.KeyGesture> と <xref:System.Windows.Input.MouseGesture> の 2 種類があります。  <xref:System.Windows.Input.KeyGesture> は Ctrl \+ C などのキーボード ショートカットと考えることができます。  <xref:System.Windows.Input.KeyGesture> は、<xref:System.Windows.Input.Key>と、<xref:System.Windows.Input.ModifierKeys> のセットで構成されています。  <xref:System.Windows.Input.MouseGesture> は、<xref:System.Windows.Input.MouseAction> と、オプションの <xref:System.Windows.Input.ModifierKeys> のセットで構成されています。  
+  
+ <xref:System.Windows.Input.InputGesture> をコマンド ソースとして機能させるには、コマンドに関連付ける必要があります。  これを実現するには、いくつかの方法があります。  1 つは、<xref:System.Windows.Input.InputBinding> を使用する方法です。  
+  
+ <xref:System.Windows.Input.KeyGesture> と <xref:System.Windows.Input.RoutedCommand> の間に <xref:System.Windows.Input.KeyBinding> を作成する方法を次の例に示します。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewXAMLKeyBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewxamlkeybinding)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewKeyBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewkeybinding)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewKeyBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewkeybinding)]  
+  
+ <xref:System.Windows.Input.InputGesture> を <xref:System.Windows.Input.RoutedCommand> に関連付ける別の方法は、<xref:System.Windows.Input.InputGesture> を <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.InputGestureCollection> に追加する方法です。  
+  
+ <xref:System.Windows.Input.KeyGesture> を <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.InputGestureCollection> に追加する方法を次の例に示します。  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewKeyGestureOnCmd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewkeygestureoncmd)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewKeyGestureOnCmd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewkeygestureoncmd)]  
+  
+<a name="Command_Binding"></a>   
+### CommandBinding  
+ <xref:System.Windows.Input.CommandBinding> は、コマンドを実装するイベント ハンドラーにコマンドを関連付けます。  
+  
+ <xref:System.Windows.Input.CommandBinding> クラスには、<xref:System.Windows.Input.CommandBinding.Command%2A> プロパティと、<xref:System.Windows.Input.CommandBinding.PreviewExecuted>、<xref:System.Windows.Input.CommandBinding.Executed>、<xref:System.Windows.Input.CommandBinding.PreviewCanExecute>、および <xref:System.Windows.Input.CommandBinding.CanExecute> イベントが含まれます。  
+  
+ <xref:System.Windows.Input.CommandBinding.Command%2A> は、<xref:System.Windows.Input.CommandBinding> が関連付けられているコマンドです。  <xref:System.Windows.Input.CommandBinding.PreviewExecuted> イベントと <xref:System.Windows.Input.CommandBinding.Executed> イベントに割り当てられたイベント ハンドラーは、コマンド ロジックを実装します。  <xref:System.Windows.Input.CommandBinding.PreviewCanExecute> イベントと <xref:System.Windows.Input.CommandBinding.CanExecute> イベントに割り当てられたイベント ハンドラーは、コマンドが現在のコマンドの対象で実行可能かどうかを判断します。  
+  
+ アプリケーションのルート <xref:System.Windows.Window> で <xref:System.Windows.Input.CommandBinding> を作成する方法を次の例に示します。  <xref:System.Windows.Input.CommandBinding> は、<xref:System.Windows.Input.ApplicationCommands.Open%2A> コマンドを <xref:System.Windows.Input.CommandManager.Executed> ハンドラーおよび <xref:System.Windows.Input.CommandBinding.CanExecute> ハンドラーに関連付けます。  
+  
+ [!code-xml[commandwithhandler#CommandHandlerCommandBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml#commandhandlercommandbinding)]  
+  
+ [!code-csharp[CommandHandlerProcedural#CommandHandlerBindingInit](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandHandlerProcedural/CSharp/Window1.xaml.cs#commandhandlerbindinginit)]
+ [!code-vb[CommandHandlerProcedural#CommandHandlerBindingInit](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandHandlerProcedural/visualbasic/window1.xaml.vb#commandhandlerbindinginit)]  
+  
+ 次に、<xref:System.Windows.Input.ExecutedRoutedEventHandler> および <xref:System.Windows.Input.CanExecuteRoutedEventHandler> を作成します。  <xref:System.Windows.Input.ExecutedRoutedEventHandler> は、コマンドが実行されたことを知らせる文字列を表示する <xref:System.Windows.MessageBox> を開きます。  <xref:System.Windows.Input.CanExecuteRoutedEventHandler> は、<xref:System.Windows.Input.CanExecuteRoutedEventArgs.CanExecute%2A> プロパティを `true` に設定します。  
+  
+ [!code-csharp[commandwithhandler#CommandHandlerExecutedHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml.cs#commandhandlerexecutedhandler)]
+ [!code-vb[commandwithhandler#CommandHandlerExecutedHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/commandWithHandler/VisualBasic/Window1.xaml.vb#commandhandlerexecutedhandler)]  
+  
+ [!code-csharp[commandwithhandler#CommandHandlerCanExecuteHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml.cs#commandhandlercanexecutehandler)]
+ [!code-vb[commandwithhandler#CommandHandlerCanExecuteHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/commandWithHandler/VisualBasic/Window1.xaml.vb#commandhandlercanexecutehandler)]  
+  
+ <xref:System.Windows.Input.CommandBinding> は、アプリケーションまたはコントロールのルート <xref:System.Windows.Window> などの特定のオブジェクトに割り当てられます。  <xref:System.Windows.Input.CommandBinding> が割り当てられたオブジェクトは、バインディングのスコープを定義します。  たとえば、コマンドの対象の先祖に割り当てられた <xref:System.Windows.Input.CommandBinding> には、<xref:System.Windows.Input.CommandBinding.Executed> イベントによって到達できますが、コマンドの対象の子孫に割り当てられた <xref:System.Windows.Input.CommandBinding> には到達できません。  これは、イベントを発生させるオブジェクトから <xref:System.Windows.RoutedEvent> がトンネリングおよびバブリングするというしくみが直接影響するからです。  
+  
+ 場合によっては、<xref:System.Windows.Input.CommandBinding> は、<xref:System.Windows.Controls.TextBox> クラスに対する <xref:System.Windows.Input.ApplicationCommands.Cut%2A>、<xref:System.Windows.Input.ApplicationCommands.Copy%2A>、<xref:System.Windows.Input.ApplicationCommands.Paste%2A> の各コマンドのように、コマンドの対象自体に割り当てられます。  ただし、<xref:System.Windows.Input.CommandBinding> は、特に同じ <xref:System.Windows.Input.CommandBinding> を複数のコマンドの対象で使用できる場合には、メイン <xref:System.Windows.Window> やアプリケーション オブジェクトなど、コマンドの対象の先祖に割り当てる方が便利な場合がよくあります。  これらは、コマンド実行インフラストラクチャの作成時に検討される設計上の決定事項です。  
+  
+<a name="Commane_Target"></a>   
+### コマンドの対象  
+ コマンドの対象は、コマンドが実行される要素です。  <xref:System.Windows.Input.RoutedCommand> のコマンドの対象は、<xref:System.Windows.Input.CommandManager.Executed> および <xref:System.Windows.Input.CommandManager.CanExecute> のルーティングが開始される要素です。  前に述べたように、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Input.ICommandSource> の <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> プロパティは、<xref:System.Windows.Input.ICommand> が <xref:System.Windows.Input.RoutedCommand> の場合にのみ適用されます。  <xref:System.Windows.Input.ICommandSource> で <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> が設定されていても、対応するコマンドが <xref:System.Windows.Input.RoutedCommand> でない場合は、コマンドの対象は無視されます。  
+  
+ コマンド ソースは、コマンドの対象を明示的に設定できます。  コマンドの対象が定義されていない場合は、キーボード フォーカスを持つ要素がコマンドの対象として使用されます。  キーボード フォーカスを持つ要素をコマンドの対象として使用する利点の 1 つは、アプリケーション開発者が同じコマンド ソースを使用して、コマンドの対象を追跡せずにコマンドを複数の対象で呼び出すことができることです。  たとえば、<xref:System.Windows.Controls.MenuItem> が <xref:System.Windows.Controls.TextBox> コントロールと <xref:System.Windows.Controls.PasswordBox> コントロールを持つアプリケーションで **\[貼り付け\]** コマンドを呼び出した場合、その対象は、キーボード フォーカスのあるコントロールに応じて <xref:System.Windows.Controls.TextBox> または <xref:System.Windows.Controls.PasswordBox> にすることができます。  
+  
+ マークアップと分離コードでコマンドの対象を明示的に設定する方法を次の例に示します。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewXAMLCommandTarget](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewxamlcommandtarget)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcommandtargetcodebehind)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcommandtargetcodebehind)]  
+  
+<a name="Command_Manager"></a>   
+### CommandManager  
+ <xref:System.Windows.Input.CommandManager> は、多数のコマンド関連機能を提供します。  <xref:System.Windows.Input.CommandManager.PreviewExecuted>、<xref:System.Windows.Input.CommandManager.Executed>、<xref:System.Windows.Input.CommandManager.PreviewCanExecute>、および <xref:System.Windows.Input.CommandManager.CanExecute> の各イベント ハンドラーを特定の要素に対して追加および削除するための一連の静的メソッドを提供します。  <xref:System.Windows.Input.CommandBinding> オブジェクトと <xref:System.Windows.Input.InputBinding> オブジェクトを特定のクラスに登録する手段を提供します。  また、<xref:System.Windows.Input.CommandManager> は、<xref:System.Windows.Input.CommandManager.RequerySuggested> イベントを介して、<xref:System.Windows.Input.ICommand.CanExecuteChanged> イベントを発生させるタイミングをコマンドに通知する方法も提供します。  
+  
+ <xref:System.Windows.Input.CommandManager.InvalidateRequerySuggested%2A> メソッドは、<xref:System.Windows.Input.CommandManager> に <xref:System.Windows.Input.CommandManager.RequerySuggested> イベントを強制的に発生させます。  これは、コマンドを無効または有効にする必要がある場合に役立ちますが、<xref:System.Windows.Input.CommandManager> が認識しない場合には使用しません。  
+  
+<a name="Command_Library"></a>   
+## コマンド ライブラリ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、一連の定義済みコマンドを提供します。  コマンド ライブラリは、<xref:System.Windows.Input.ApplicationCommands>、<xref:System.Windows.Input.NavigationCommands>、<xref:System.Windows.Input.MediaCommands>、<xref:System.Windows.Documents.EditingCommands>、および <xref:System.Windows.Input.ComponentCommands> の各クラスから構成されます。  これらのクラスは、<xref:System.Windows.Input.ApplicationCommands.Cut%2A>、<xref:System.Windows.Input.NavigationCommands.BrowseBack%2A> と <xref:System.Windows.Input.NavigationCommands.BrowseForward%2A>、<xref:System.Windows.Input.MediaCommands.Play%2A>、<xref:System.Windows.Input.MediaCommands.Stop%2A>、<xref:System.Windows.Input.MediaCommands.Pause%2A> などのコマンドを提供します。  
+  
+ これらのコマンドの多くには、一連の既定の入力バインディングが含まれます。  たとえば、アプリケーションでコピー コマンドを処理するように指定した場合、キーボード バインディング "Ctrl\+C" が自動的に取得されます。[!INCLUDE[TLA2#tla_tpc](../../../../includes/tla2sharptla-tpc-md.md)] ペン ジェスチャや音声情報など、他の入力デバイスのバインディングも取得されます。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用してさまざまなコマンド ライブラリ内のコマンドを参照する場合、通常は、静的コマンド プロパティを公開するライブラリ クラスのクラス名を省略できます。  一般に、コマンド名は文字列としてあいまいではなく、所有する型は、コマンドを論理的にグループ化するために存在し、あいまいさを排除するために必要なわけではありません。  たとえば、冗長な `Command="ApplicationCommands.Cut"` ではなく、`Command="Cut"` と指定できます。  これは、コマンドの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサに組み込まれている便利なメカニズムであり \(もっと正確に言えば、これは <xref:System.Windows.Input.ICommand> の型コンバーターの動作です\)、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサが読み込み時に参照します。  
+  
+<a name="creating_commands"></a>   
+## カスタム コマンドの作成  
+ コマンド ライブラリ クラス内のコマンドが目的に合っていない場合は、独自のコマンドを作成できます。  カスタム コマンドを作成するには 2 とおりの方法があります。  1 つは、最初から作成する方法で <xref:System.Windows.Input.ICommand> インターフェイスを実装します。  もう 1 つは、<xref:System.Windows.Input.RoutedCommand> または <xref:System.Windows.Input.RoutedUICommand> を作成する方法で、こちらの方が一般的です。  
+  
+ カスタム <xref:System.Windows.Input.RoutedCommand> の作成の例については、[カスタム RoutedCommand の作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159980)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Input.RoutedCommand>   
+ <xref:System.Windows.Input.CommandBinding>   
+ <xref:System.Windows.Input.InputBinding>   
+ <xref:System.Windows.Input.CommandManager>   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [ICommandSource を実装する](../../../../docs/framework/wpf/advanced/how-to-implement-icommandsource.md)   
+ [How to: Add a Command to a MenuItem](http://msdn.microsoft.com/ja-jp/013d68a0-5373-4a68-bd91-5de574307370)   
+ [カスタム RoutedCommand の作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159980)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/componentresourcekey-markup-extension.md b/docs/framework/wpf/advanced/componentresourcekey-markup-extension.md
new file mode 100644
index 00000000000..580eeeb6b0a
--- /dev/null
+++ b/docs/framework/wpf/advanced/componentresourcekey-markup-extension.md
@@ -0,0 +1,89 @@
+---
+title: "ComponentResourceKey マークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ComponentResourceKey"
+  - "ComponentResourceKeyExtension"
+helpviewer_keywords: 
+  - "ComponentResourceKey マークアップ拡張機能"
+  - "XAML, ComponentResourceKey マークアップ拡張機能"
+ms.assetid: d6bcdbe6-61b3-40a7-b381-4e02185b5a85
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ComponentResourceKey マークアップ拡張機能
+外部アセンブリから読み込まれるリソースのキーを定義および参照します。  これにより、アセンブリ内またはクラスで明示的にリソース ディクショナリを指定する代わりに、リソース ルックアップによってアセンブリ内の対象の型を指定することが可能になります。  
+  
+## XAML 属性の使用方法 \(キー設定、コンパクト\)  
+  
+```  
+<object x:Key="{ComponentResourceKey {x:Type targetTypeName}, targetID}" .../>  
+```  
+  
+## XAML 属性の使用方法 \(キー設定、詳細\)  
+  
+```  
+<object x:Key="{ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}" .../>  
+```  
+  
+## XAML 属性の使用方法 \(リソース要求、コンパクト\)  
+  
+```  
+<object property="{DynamicResource {ComponentResourceKey {x:Type targetTypeName}, targetID}}" .../>  
+```  
+  
+## XAML 属性の使用方法 \(リソース要求、詳細\)  
+  
+```  
+<object property="{DynamicResource {ComponentResourceKey TypeInTargetAssembly={x:Type targetTypeName}, ResourceID=targetID}}" .../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`targetTypeName`|リソース アセンブリ内で定義されているパブリック[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] 型の名前。|  
+|`targetID`|リソースのキー。  リソースを検索する場合、`targetID` はそのリソースの [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)と類似しています。|  
+  
+## 解説  
+ 上記の使用方法に示すように、{`ComponentResourceKey`} マークアップ拡張機能は次の 2 か所で使用されています。  
+  
+-   コントロールの作成者が指定したテーマ リソース ディクショナリ内のキーの定義  
+  
+-   アセンブリからテーマ リソースへのアクセス \(コントロールに対してテンプレートの再設定を行っているが、コントロールのテーマによって指定されたリソースからのプロパティ値を使用する場合\)  
+  
+ テーマからのコンポーネント リソースを参照するには、通常 `{StaticResource}` ではなく `{DynamicResource}` を使用することをお勧めします。  これは使用方法で示されています。  テーマ自体はユーザーが変更できるため、`{DynamicResource}` が推奨されます。  テーマのサポートに関するコントロールの作成者の意図に最も合ったコンポーネント リソースが必要な場合は、コンポーネント リソース参照を動的にできるようにする必要もあります。  
+  
+ <xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly%2A> は、そのリソースが実際に定義されている対象アセンブリに存在している型を識別します。  `ComponentResourceKey` は、<xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly%2A> がどこで定義されているかが正確にわかっていない場合でも定義して使用できますが、最終的には、参照されているアセンブリによって型を解決する必要があります。  
+  
+ <xref:System.Windows.ComponentResourceKey> の一般的な使用方法は、後にクラスのメンバーとして公開するキーを定義することです。  この方法で使用する場合は、マークアップ拡張機能ではなく、<xref:System.Windows.ComponentResourceKey> クラス コンストラクターを使用します。  詳細については、<xref:System.Windows.ComponentResourceKey> または「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」の「テーマ リソース用のキーの定義と参照」セクションを参照してください。  
+  
+ キーを確立するときとキーを持つリソースを参照するときには、`ComponentResourceKey` マークアップ拡張機能には一般に属性構文が使用されます。  
+  
+ 前に示したコンパクトな構文は、<xref:System.Windows.ComponentResourceKey.%23ctor%2A?displayProperty=fullName> コンストラクター シグネチャおよびマークアップ拡張機能の位置指定パラメーターの使用に依存します。  `targetTypeName` と `targetID` を設定する順序が重要です。  詳細な構文は、既定のコンストラクターである <xref:System.Windows.ComponentResourceKey.%23ctor%2A?displayProperty=fullName> に依存し、オブジェクト要素の実際の属性構文と同様の方法で <xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly%2A> と <xref:System.Windows.ComponentResourceKey.ResourceId%2A> を設定します。  詳細な構文では、各プロパティを設定する順序は重要ではありません。  これら 2 つの方法 \(コンパクトと詳細\) の関係および機構の詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+ 技術的には、`targetID` の値は任意のオブジェクトにすることができ、文字列にする必要はありません。  ただし、WPF での最も一般的な使用方法は、`targetID` 値を文字列であるフォームに合わせることです。このような文字列は、[XamlName の文法](../../../../docs/framework/xaml-services/xamlname-grammar.md)で有効です。  
+  
+ `ComponentResourceKey` は、オブジェクト要素構文で使用できます。  この場合、拡張機能を正しく初期化するには、<xref:System.Windows.ComponentResourceKey.TypeInTargetAssembly%2A> プロパティと <xref:System.Windows.ComponentResourceKey.ResourceId%2A> プロパティの両方の値を指定する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リーダー実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.ComponentResourceKey> クラスによって定義されます。  
+  
+ `ComponentResourceKey` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のすべてのマークアップ拡張機能では、それぞれの属性構文で { と } の 2 つの記号を使用します。これは規約であり、これに従って [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.ComponentResourceKey>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/creating-an-ink-input-control.md b/docs/framework/wpf/advanced/creating-an-ink-input-control.md
new file mode 100644
index 00000000000..35027695740
--- /dev/null
+++ b/docs/framework/wpf/advanced/creating-an-ink-input-control.md
@@ -0,0 +1,110 @@
+---
+title: "インク入力コントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "収集 (インク ストロークを)"
+  - "DynamicRenderer オブジェクト"
+  - "インク入力コントロール"
+  - "インク ストローク, 収集"
+  - "インク ストローク, 管理"
+  - "インク, 描画"
+  - "入力 (マウスから), 受け入れ"
+  - "管理 (インク ストロークを)"
+  - "マウス入力, 受け入れ"
+  - "レンダリング インク"
+  - "StylusPlugIn オブジェクト"
+ms.assetid: c31f3a67-cb3f-4ded-af9e-ed21f6575b26
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# インク入力コントロールの作成
+インクのレンダリングを動的にも静的にも行うカスタム コントロールを作成できます。  つまり、ユーザーがストロークを描画したときに、タブレット ペンから "流れる" ようにインクが表示されるようにインクをレンダリングしたり、タブレット ペンからの入力、クリップボードからの貼り付け、ファイルからの読み込みのいずれかによってインクをコントロールに追加した後にそのインクを表示したりします。  インクを動的にレンダリングするには、コントロールが <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を使用する必要があります。  インクを静的にレンダリングするには、スタイラス イベント メソッド \(<xref:System.Windows.UIElement.OnStylusDown%2A>、<xref:System.Windows.UIElement.OnStylusMove%2A>、および <xref:System.Windows.UIElement.OnStylusUp%2A>\) をオーバーライドして、<xref:System.Windows.Input.StylusPoint> データの収集、ストロークの作成、これらのメソッドの \(コントロール上でインクをレンダリングする\) <xref:System.Windows.Controls.InkPresenter> への追加を行う必要があります。  
+  
+ このトピックは、次の内容で構成されています。  
+  
+-   [方法 : スタイラス ポイント データを収集してインク ストロークを作成する](#CollectingStylusPointDataAndCreatingInkStrokes)  
+  
+-   [方法 : コントロールでマウスからの入力を受け付けられるようにする](#EnablingYourControlToAcceptInputTromTheMouse)  
+  
+-   [スタイラスおよびマウス双方からの入力](#PuttingItTogether)  
+  
+-   [追加のプラグインと DynamicRenderer の使用](#UsingAdditionalPluginsAndDynamicRenderers)  
+  
+-   [まとめ](#AdvancedInkHandling_Conclusion)  
+  
+<a name="CollectingStylusPointDataAndCreatingInkStrokes"></a>   
+## 方法 : スタイラス ポイント データを収集してインク ストロークを作成する  
+ インク ストロークを収集して管理するコントロールを作成するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Controls.Control> のクラス、または <xref:System.Windows.Controls.Control> の派生クラスのいずれか \(<xref:System.Windows.Controls.Label> など\) を派生します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#20)]  
+    [!code-csharp[AdvancedInkTopicsSamples#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControlSnippets.cs#14)]  
+    [!code-csharp[AdvancedInkTopicsSamples#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControlSnippets.cs#15)]  
+  
+2.  <xref:System.Windows.Controls.InkPresenter> をそのクラスに追加し、<xref:System.Windows.Controls.ContentControl.Content%2A> プロパティを新しい <xref:System.Windows.Controls.InkPresenter> に設定します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControlSnippets.cs#16)]  
+  
+3.  <xref:System.Windows.Controls.InkPresenter.AttachVisuals%2A> メソッドを呼び出して <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.RootVisual%2A> を <xref:System.Windows.Controls.InkPresenter> に割り当て、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに追加します。  これにより、コントロールによってスタイラス ポイント データが収集されたとおりに <xref:System.Windows.Controls.InkPresenter> がインクを表示できるようになります。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#17](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControlSnippets.cs#17)]  
+    [!code-csharp[AdvancedInkTopicsSamples#18](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControlSnippets.cs#18)]  
+  
+4.  <xref:System.Windows.UIElement.OnStylusDown%2A> メソッドをオーバーライドします。  このメソッドでは、<xref:System.Windows.Input.Stylus.Capture%2A> を呼び出してスタイラスをキャプチャします。  スタイラスをキャプチャすることにより、コントロールは、スタイラスがコントロールの境界を離れても <xref:System.Windows.UIElement.StylusMove> イベントおよび <xref:System.Windows.UIElement.StylusUp> イベントを継続して受け取ります。  これは、厳密には必須ではありませんが、快適なユーザー エクスペリエンスのためには、たいてい必要です。  新しい <xref:System.Windows.Input.StylusPointCollection> を作成し、<xref:System.Windows.Input.StylusPoint> データを収集します。  最後に、<xref:System.Windows.Input.StylusPoint> データの最初のセットを <xref:System.Windows.Input.StylusPointCollection> に追加します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#7)]  
+  
+5.  <xref:System.Windows.UIElement.OnStylusMove%2A> メソッドをオーバーライドし、<xref:System.Windows.Input.StylusPoint> データを、作成しておいた <xref:System.Windows.Input.StylusPointCollection> オブジェクトに追加します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#8)]  
+  
+6.  <xref:System.Windows.UIElement.OnStylusUp%2A> メソッドをオーバーライドし、<xref:System.Windows.Input.StylusPointCollection> データを持つ新しい <xref:System.Windows.Ink.Stroke> を作成します。  作成した新しい <xref:System.Windows.Ink.Stroke> を <xref:System.Windows.Controls.InkPresenter> の <xref:System.Windows.Controls.InkPresenter.Strokes%2A> コレクションに追加し、スタイラス キャプチャを解放します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#10)]  
+  
+<a name="EnablingYourControlToAcceptInputTromTheMouse"></a>   
+## 方法 : コントロールでマウスからの入力を受け付けられるようにする  
+ 前の例で作成したコントロールをアプリケーションに追加して実行した場合に、マウスを入力デバイスとして使用すると、ストロークが永続化されないことがわかります。  マウスを入力デバイスとして使用する場合にもストロークを永続化するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.UIElement.OnMouseLeftButtonDown%2A> をオーバーライドし、新しい <xref:System.Windows.Input.StylusPointCollection> を作成します。イベント発生時のマウスの位置を取得し、そのポイント データを使用して <xref:System.Windows.Input.StylusPoint> を作成して、その <xref:System.Windows.Input.StylusPoint> を <xref:System.Windows.Input.StylusPointCollection> に追加します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#11)]  
+  
+2.  <xref:System.Windows.UIElement.OnMouseMove%2A> メソッドをオーバーライドします。  イベント発生時のマウスの位置を取得し、そのポイント データを使用して <xref:System.Windows.Input.StylusPoint> を作成します。  <xref:System.Windows.Input.StylusPoint> を作成しておいた <xref:System.Windows.Input.StylusPointCollection> オブジェクトに追加します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#12)]  
+  
+3.  <xref:System.Windows.UIElement.OnMouseLeftButtonUp%2A> メソッドをオーバーライドします。  <xref:System.Windows.Input.StylusPointCollection> データを持つ新しい <xref:System.Windows.Ink.Stroke> を作成し、作成したその新しい <xref:System.Windows.Ink.Stroke> を <xref:System.Windows.Controls.InkPresenter> の <xref:System.Windows.Controls.InkPresenter.Strokes%2A> コレクションに追加します。  
+  
+     [!code-csharp[AdvancedInkTopicsSamples#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#13)]  
+  
+<a name="PuttingItTogether"></a>   
+## スタイラスおよびマウス双方からの入力  
+ ユーザーがマウスまたはペンのいずれかを使用した場合にインクを収集するカスタム コントロールの例を次に示します。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#20)]  
+[!code-csharp[AdvancedInkTopicsSamples#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/StylusControl.cs#6)]  
+  
+<a name="UsingAdditionalPluginsAndDynamicRenderers"></a>   
+## 追加のプラグインと DynamicRenderer の使用  
+ InkCanvas と同様に、カスタム コントロールでも、カスタム <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> オブジェクトや追加の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> オブジェクトを使用できます。  これらのオブジェクトを <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに追加します。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> 内での <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> オブジェクトの順番は、インクが描画されるときの外観に影響します。  たとえば、`dynamicRenderer` という <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> およびタブレット ペンのインクをオフセットする `translatePlugin` というカスタムの <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> があるとします。  `translatePlugin` が <xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> 内の最初の <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> で、`dynamicRenderer` が 2 番目の場合、ユーザーがペンを動かすと、"流れる" インクがオフセットされます。  `dynamicRenderer` が最初で、`translatePlugin` が 2 番目の場合、インクは、ユーザーがペンを持ち上げるまでオフセットされません。  
+  
+<a name="AdvancedInkHandling_Conclusion"></a>   
+## まとめ  
+ スタイラス イベント メソッドのオーバーライドにより、インクを収集してレンダリングするカスタム コントロールを作成できます。  独自のコントロールを作成し、独自の <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> クラスを派生させ、それらのクラスを <xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> に挿入することにより、デジタル インクで想定できるすべての動作を事実上実装できます。  生成されたとおりの <xref:System.Windows.Input.StylusPoint> データにアクセスできるため、アプリケーションの必要に応じて <xref:System.Windows.Input.Stylus> 入力をカスタマイズし、画面上にレンダリングすることができるようになります。  <xref:System.Windows.Input.StylusPoint> データにそのように低いレベルでアクセスできるため、インク コレクションの実装とアプリケーションに最適なパフォーマンスでのレンダリングを実現できます。  
+  
+## 参照  
+ [高度なインク処理](../../../../docs/framework/wpf/advanced/advanced-ink-handling.md)   
+ [Accessing and Manipulating Pen Input \(ペン入力のアクセスと操作\)](http://go.microsoft.com/fwlink/?LinkId=50752&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/custom-dependency-properties.md b/docs/framework/wpf/advanced/custom-dependency-properties.md
new file mode 100644
index 00000000000..c14e228793f
--- /dev/null
+++ b/docs/framework/wpf/advanced/custom-dependency-properties.md
@@ -0,0 +1,171 @@
+---
+title: "カスタム依存関係プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム依存関係プロパティ"
+  - "依存関係プロパティ, カスタム"
+  - "実装, ラッパー"
+  - "メタデータ, プロパティ"
+  - "プロパティ, メタデータ"
+  - "プロパティ, 登録"
+  - "登録 (プロパティを)"
+  - "ラッパー, 実装"
+ms.assetid: e6bfcfac-b10d-4f58-9f77-a864c2a2938f
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# カスタム依存関係プロパティ
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションの開発者とコンポーネント作成者に対して、カスタム[依存関係](GTMT)の作成を推奨する理由を説明し、その実装手順と共に、プロパティのパフォーマンス、操作性、または汎用性の向上につながるいくつかの実装オプションを示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラスの既存の依存関係プロパティの使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  このトピックの例を理解するには、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] についての理解があり、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの記述方法を理解していることも必要です。  
+  
+<a name="whatis"></a>   
+## 依存関係プロパティとは  
+ 通常なら[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティになるプロパティを[依存関係プロパティ](GTMT)として実装すると、そのプロパティでスタイル設定、データ バインディング、継承、アニメーション、および既定値をサポートできるようになります。  依存関係プロパティは、<xref:System.Windows.DependencyProperty.Register%2A> メソッド \(または <xref:System.Windows.DependencyProperty.RegisterReadOnly%2A>\) を呼び出すことによって [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムに登録され、<xref:System.Windows.DependencyProperty> 識別子フィールドによって補足されるプロパティです。  依存関係プロパティを使用できるのは <xref:System.Windows.DependencyObject> 型のみですが、<xref:System.Windows.DependencyObject> は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラス階層の中で非常に高い位置にあるため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で使用できるクラスの大多数は依存関係プロパティをサポートすることができます。  依存関係プロパティと、この [!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] で依存関係プロパティの説明に使用している一部の用語と規則の詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+<a name="example_dp"></a>   
+## 依存関係プロパティの例  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のクラスに実装されている依存関係プロパティは多数あり、その例として <xref:System.Windows.Controls.Control.Background%2A> プロパティ、<xref:System.Windows.FrameworkElement.Width%2A> プロパティ、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティなどが挙げられます。  クラスによって公開される依存関係プロパティにはそれぞれ <xref:System.Windows.DependencyProperty> 型の public static フィールドが対応付けられ、その同じクラスで公開されます。これは、依存関係プロパティの識別子です。  この識別子には、名前付け規則に従って、[依存関係プロパティ](GTMT)の名前に文字列 `Property` を加えた名前が付けられます。  たとえば、<xref:System.Windows.Controls.Control.Background%2A> プロパティに対応する <xref:System.Windows.DependencyProperty> 識別子フィールドの名前は <xref:System.Windows.Controls.Control.BackgroundProperty> になります。  識別子には[依存関係プロパティ](GTMT)に関する登録情報が格納され、後に[依存関係プロパティ](GTMT)関連のその他の操作 \(<xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しなど\) に使用されます。  
+  
+ 「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」で説明しているとおり、"ラッパー" の実装のため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の依存関係プロパティ \(大部分の[添付プロパティ](GTMT)は除く\) はいずれも [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティを兼ねます。  したがって、他の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティを使用するときと同様にラッパーを定義する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] アクセサーをコードから呼び出すことによって、依存関係プロパティを取得または設定することができます。  通常、確立された依存関係プロパティのコンシューマーは、基になるプロパティ システムへのコネクション ポイントである <xref:System.Windows.DependencyObject> の <xref:System.Windows.DependencyObject.GetValue%2A> メソッドや <xref:System.Windows.DependencyObject.SetValue%2A> メソッドは使用しません。  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティの既存の実装により、識別子フィールドが適切に使用され、プロパティの `get` ラッパーと `set` ラッパーの実装内で <xref:System.Windows.DependencyObject.GetValue%2A> と <xref:System.Windows.DependencyObject.SetValue%2A> があらかじめ呼び出されるようになっています。  カスタム依存関係プロパティを自分で実装する場合は、同様の方法でラッパーを定義することになります。  
+  
+<a name="backing_with_dp"></a>   
+## 依存関係プロパティの実装が必要になるケース  
+ プロパティをクラスに実装する場合、対象となるクラスが <xref:System.Windows.DependencyObject> から派生したものであれば、そのプロパティを <xref:System.Windows.DependencyProperty> 識別子で補足することによって依存関係プロパティにするという選択肢があります。  プロパティを依存関係プロパティにする必要性や妥当性の有無は、それぞれのシナリオのニーズによって異なります。  プロパティをプライベート フィールドで補足する通常の手法で十分な場合もあります。  ただし、プロパティで次のいずれか 1 つ以上の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 機能がサポートされるようにするには、必ず[依存関係プロパティ](GTMT)として実装する必要があります。  
+  
+-   プロパティをスタイル内で設定する機能。  詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+-   プロパティでデータ バインディングをサポートする機能。  依存関係プロパティのデータ バインディングの詳細については、「[2 つのコントロールのプロパティをバインドする](../../../../docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md)」を参照してください。  
+  
+-   プロパティを動的リソース参照で設定する機能。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+-   プロパティ値を要素ツリー内の親要素から自動的に継承する機能。  この場合、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] アクセス用のプロパティ ラッパーを作成する場合でも、<xref:System.Windows.DependencyProperty.RegisterAttached%2A> メソッドで登録します。  詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+-   プロパティをアニメーション化する機能。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+-   プロパティの以前の値がプロパティ システムのアクション、環境、ユーザー、またはスタイルの読み込みや使用によって変更された場合に、プロパティ システムから報告を受ける機能。  プロパティのメタデータを使用することによって、プロパティでコールバック メソッドを指定し、プロパティ システムがプロパティ値の決定的な変更を確認するたびに、そのメソッドが呼び出されるようにすることができます。  関連する概念として、プロパティ値の強制型変換があります。  詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  
+  
+-   プロパティ値の変更に伴ってレイアウト システムで要素のビジュアルの再構成が必要になるかどうかの報告を受けるなど、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロセスでも使用される、確立されたメタデータ規則を使用する機能。  または、メタデータのオーバーライドを使用して、メタデータに基づいた既定値などの特性を派生クラスで変更する機能。  
+  
+-   カスタム コントロールのプロパティが、**\[プロパティ\]** ウィンドウの編集など、[!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)] [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]のサポートを受ける機能。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+ これらのシナリオを検討するときは、まったく新しいプロパティを実装するのではなく、既存の[依存関係プロパティ](GTMT)のメタデータをオーバーライドすることによって、自分のシナリオを実現できるかどうかも考慮する必要があります。  メタデータのオーバーライドが実際的かどうかはシナリオに依存し、そのシナリオが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既存の依存関係プロパティおよびクラスとどの程度似ているかにもよります。  既存のプロパティのメタデータをオーバーライドする方法の詳細については、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+<a name="checklist"></a>   
+## 依存関係プロパティを定義する場合のチェックリスト  
+ 依存関係プロパティの定義は、4 つの概念で構成されています。  これらの概念は、実装内では 1 行のコードで表されるものもあるため、必ずしも厳密な手順というわけではありません。  
+  
+-   \(オプション\) 依存関係プロパティのプロパティ メタデータを作成します。  
+  
+-   プロパティ システムにプロパティ名を登録します。その際、所有者型およびプロパティ値の型を指定します。  また、プロパティ メタデータを使用する場合は、併せて指定します。  
+  
+-   所有者型に <xref:System.Windows.DependencyProperty> 識別子を `public` `static` `readonly` フィールドとして定義します。  
+  
+-   依存関係プロパティと同じ名前で、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] の "ラッパー" プロパティを定義します。  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] の "ラッパー" プロパティの `get` および `set` アクセサーを、基になる依存関係プロパティと連係するように実装します。  
+  
+<a name="registering"></a>   
+### プロパティ システムへのプロパティの登録  
+ プロパティを[依存関係プロパティ](GTMT)にするには、そのプロパティをプロパティ システムによって保持されるテーブルに登録し、以降のプロパティ システム操作で修飾子として使用される一意の識別子を付与する必要があります。  これらの操作は内部操作の場合もあれば、独自のコードによるプロパティ システム [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の呼び出しの場合もあります。  プロパティを登録するには、クラスの本文 \(クラス内のメンバー定義以外の部分\) で <xref:System.Windows.DependencyProperty.Register%2A> メソッドを呼び出します。  <xref:System.Windows.DependencyProperty.Register%2A> メソッドを呼び出すと、その戻り値として識別子フィールドも提供されます。  <xref:System.Windows.DependencyProperty.Register%2A> の呼び出しを他のメンバー定義の外で行うのは、この戻り値を使用して、<xref:System.Windows.DependencyProperty> 型の `public` `static` `readonly` フィールドをクラスの一部として割り当てて作成するためです。  このフィールドは、依存関係プロパティの識別子になります。  
+  
+ [!code-csharp[WPFAquariumSln#RegisterAG](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#registerag)]
+ [!code-vb[WPFAquariumSln#RegisterAG](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#registerag)]  
+  
+<a name="nameconventions"></a>   
+### 依存関係プロパティの名前付け規則  
+ 依存関係プロパティに関しては確立された名前付け規則があり、例外的な状況を除いて必ずその規則に従う必要があります。  
+  
+ 依存関係プロパティ自体の基本的な名前 \(この例では "AquariumGraphic"\) を、<xref:System.Windows.DependencyProperty.Register%2A> の最初のパラメーターとして指定します。  その名前は、それぞれの登録型の中で一意である必要があります。  基本型を通じて継承される依存関係プロパティは、既に登録型の一部であると見なされ、継承されたプロパティの名前を再び登録することはできません。  ただし、その依存関係プロパティが継承されていない場合でも、依存関係プロパティの所有者として、クラスを追加する方法はあります。詳細については、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+ 識別子フィールドを作成するときは、プロパティの登録名にサフィックス `Property` を加えた名前を付けます。  このフィールドは依存関係プロパティの識別子であり、ラッパー内で行う <xref:System.Windows.DependencyObject.SetValue%2A> と <xref:System.Windows.DependencyObject.GetValue%2A> の呼び出しの入力として、また、独自のコード、許可した外部コード、プロパティ システム、および場合によっては [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサによるプロパティへのその他のコード アクセスの入力として、後で使用されます。  
+  
+> [!NOTE]
+>  通常の実装ではクラスの本文で依存関係プロパティを定義しますが、クラスの静的コンストラクターで依存関係プロパティを定義することも可能です。  依存関係プロパティを初期化するために複数のコード行が必要な場合は、この方法が理にかなっています。  
+  
+<a name="wrapper1"></a>   
+### "ラッパー" の実装  
+ ラッパー実装では、`get` の実装で <xref:System.Windows.DependencyObject.GetValue%2A> を呼び出し、`set` の実装で <xref:System.Windows.DependencyObject.SetValue%2A> を呼び出します \(ここでは、わかりやすくするために元の登録呼び出しとフィールドを示しています\)。  
+  
+ 例外的な状況を除いて、ラッパー実装は、<xref:System.Windows.DependencyObject.GetValue%2A> と <xref:System.Windows.DependencyObject.SetValue%2A> の処理をそれぞれ実行します。  その理由については、「[XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のクラスに用意されている既存のパブリック依存関係プロパティは、この単純なラッパー実装モデルを使用します。依存関係プロパティのしくみの複雑さは、プロパティ システムの動作に内在するものか、プロパティ メタデータによる強制やプロパティ変更コールバックなどの他の概念に由来するものがほとんどです。  
+  
+ [!code-csharp[WPFAquariumSln#AGWithWrapper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#agwithwrapper)]
+ [!code-vb[WPFAquariumSln#AGWithWrapper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#agwithwrapper)]  
+  
+ 繰り返しますが、ラッパー プロパティの名前は通常、プロパティを登録する際に <xref:System.Windows.DependencyProperty.Register%2A> の呼び出しの最初のパラメーターとして選択し、指定した名前と同じである必要があります。  この規則に従わないとプロパティが完全に使用できなくなるわけではありませんが、注意を要するいくつかの問題が発生します。  
+  
+-   スタイルとテンプレートの一部が機能しません。  
+  
+-   ほとんどのツールとデザイナーでは、名前付け規則への準拠が [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の適切なシリアル化やプロパティ単位のデザイナー環境支援の条件となっています。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ローダーの現在の実装は、属性を処理するときにラッパーを完全にバイパスし、名前付け規則に依存します。  詳細については、「[XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)」を参照してください。  
+  
+<a name="metadata"></a>   
+### 新しい依存関係プロパティのプロパティ メタデータ  
+ 依存関係プロパティを登録すると、プロパティ システムを通じた登録によって、プロパティ特性を格納するメタデータ オブジェクトが作成されます。  これらの特性の多くは、プロパティが <xref:System.Windows.DependencyProperty.Register%2A> の簡易署名で登録された場合に設定される既定値を持っています。  <xref:System.Windows.DependencyProperty.Register%2A> のその他の署名を使用すると、必要なメタデータをプロパティの登録時に指定することができます。  依存関係プロパティに対して指定する最も一般的なメタデータは、そのプロパティを使用する新しいインスタンスに適用する既定値を指定します。  
+  
+ <xref:System.Windows.FrameworkElement> の派生クラスに存在する依存関係プロパティを作成する場合は、基本クラス <xref:System.Windows.PropertyMetadata> ではなく、より特化したメタデータ クラス <xref:System.Windows.FrameworkPropertyMetadata> を使用できます。  <xref:System.Windows.FrameworkPropertyMetadata> クラスのコンストラクターには、さまざまなメタデータ特性を組み合わせて指定できる署名がいくつか存在します。  既定値のみを指定する場合は、<xref:System.Object> 型の単一のパラメーターを受け取る署名を使用します。  そのオブジェクト パラメーターをプロパティの型固有の既定値として渡します \(指定する既定値の型は、<xref:System.Windows.DependencyProperty.Register%2A> の呼び出しで `propertyType` パラメーターとして指定した型である必要があります\)。  
+  
+ <xref:System.Windows.FrameworkPropertyMetadata> の場合は、プロパティのメタデータ オプション フラグを指定することもできます。  これらのフラグは、登録後にプロパティ メタデータの個々のプロパティに変換され、特定の条件を、レイアウト エンジンなど、他のプロセスに伝えるのに使用されます。  
+  
+#### 適切なメタデータ フラグの設定  
+  
+-   プロパティ \(またはその値の変更\) が[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に影響を及ぼす場合、特に、レイアウト システムが要素をページ内にレイアウトする際のサイズ設定と描画に影響する場合は、<xref:System.Windows.FrameworkPropertyMetadataOptions>、<xref:System.Windows.FrameworkPropertyMetadataOptions>、<xref:System.Windows.FrameworkPropertyMetadataOptions> のいずれか 1 つ以上のフラグを設定します。  
+  
+    -   <xref:System.Windows.FrameworkPropertyMetadataOptions> は、このプロパティの変更に伴って [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] レンダリングの変更が必要になり、格納オブジェクトが親の内部に必要とする領域が増減する可能性があることを示します。  たとえば、"Width" プロパティにはこのフラグを設定する必要があります。  
+  
+    -   <xref:System.Windows.FrameworkPropertyMetadataOptions> は、このプロパティの変更に伴って [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] レンダリングの変更が必要になり、その変更が、通常は専用領域の変更は必要としないものの、領域内の配置変更を示唆することを示します。  たとえば、"Alignment" プロパティにはこのフラグを設定する必要があります。  
+  
+    -   <xref:System.Windows.FrameworkPropertyMetadataOptions> は、その他の何らかの変更が発生しており、レイアウトと測定値には影響しないものの、新たに描画する必要があることを示します。  例としては、既存の要素の色を変更する "Background" などのプロパティが挙げられます。  
+  
+    -   多くの場合、これらのフラグは、独自に行うプロパティ システムのオーバーライド実装やレイアウト コールバックのメタデータでプロトコルとして使用されます。  <xref:System.Windows.DependencyObject.OnPropertyChanged%2A> コールバックを例にとると、インスタンスのいずれかのプロパティで値の変更が報告され、そのメタデータで <xref:System.Windows.FrameworkPropertyMetadata.AffectsArrange%2A> が `true` になっていることを条件として、<xref:System.Windows.UIElement.InvalidateArrange%2A> を呼び出すことができます。  
+  
+-   一部のプロパティは、それが含まれている親要素のレンダリング特性に対し、前述した必要サイズの変更以上の影響を及ぼす可能性があります。  その例としては、フロー ドキュメント モデルで使用される <xref:System.Windows.Documents.Paragraph.MinOrphanLines%2A> プロパティが挙げられます。このプロパティが変更されると、該当する段落を含むフロー ドキュメントの全体的なレンダリングに変更が生じる可能性があります。  独自のプロパティで同様のケースを識別するには、<xref:System.Windows.FrameworkPropertyMetadataOptions> または <xref:System.Windows.FrameworkPropertyMetadataOptions> を使用します。  
+  
+-   既定では、依存関係プロパティはデータ バインディングをサポートします。  データ バインディングの現実的なシナリオがない場合や、大きなオブジェクトに対するデータ バインディングのパフォーマンスが問題として認識されている場合には、データ バインディングを意図的に無効にすることができます。  
+  
+-   既定では、依存関係プロパティのデータ バインディング <xref:System.Windows.Data.Binding.Mode%2A> の既定値は <xref:System.Windows.Data.BindingMode> になっています。  バインディングは、バインディング インスタンスごとにいつでも <xref:System.Windows.Data.BindingMode> に変更できます。詳細については、「[バインディングの方向を指定する](../../../../docs/framework/wpf/data/how-to-specify-the-direction-of-the-binding.md)」を参照してください。  ただし、依存関係プロパティの作成者の判断で、プロパティの既定のバインディング モードを <xref:System.Windows.Data.BindingMode> にすることもできます。  既存の依存関係プロパティの例として、<xref:System.Windows.Controls.MenuItem.IsSubmenuOpen%2A?displayProperty=fullName> が挙げられます。このプロパティについては、<xref:System.Windows.Controls.MenuItem.IsSubmenuOpen%2A> 設定ロジックと <xref:System.Windows.Controls.MenuItem> の複合が既定のテーマ スタイルと対話するシナリオが想定されています。  <xref:System.Windows.Controls.MenuItem.IsSubmenuOpen%2A> プロパティ ロジックは、データ バインディングをネイティブに使用し、他の状態プロパティおよびメソッド呼び出しに応じてプロパティの状態を保持します。  既定で <xref:System.Windows.Data.BindingMode> のバインディングを行うプロパティのもう 1 つの例は <xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> です。  
+  
+-   <xref:System.Windows.FrameworkPropertyMetadataOptions> フラグを設定することによって、カスタム依存関係プロパティでプロパティの継承を有効にすることもできます。  プロパティの継承は、親要素と子要素に共通のプロパティがあるシナリオで役立ちます。子要素がその特定のプロパティ値を親と同じ値に設定することは理にかなっています。  継承可能なプロパティの例としては、<xref:System.Windows.FrameworkElement.DataContext%2A> が挙げられます。このプロパティは、データの表示に関する重要なマスター詳細シナリオを実現するためのバインディング操作に使用されます。  <xref:System.Windows.FrameworkElement.DataContext%2A> を継承可能にすると、そのデータ コンテキストもすべての子要素に継承されます。  プロパティ値の継承により、ページまたはアプリケーションのルートでデータ コンテキストを指定すると、あらゆる子要素内のバインディングについて改めて指定しなくても済むようになります。  <xref:System.Windows.FrameworkElement.DataContext%2A> は、継承によって既定値がオーバーライドされるものの、特定の子要素で常にローカルに設定できることを示す例としても適しています。詳細については、「[階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)」を参照してください。  プロパティ値の継承はパフォーマンスの低下につながる可能性があるため、多用は避けてください。詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+-   依存関係プロパティがナビゲーション履歴サービスで検出または使用されるようにするかどうかを示すには、<xref:System.Windows.FrameworkPropertyMetadataOptions> フラグを設定します。  例としては、<xref:System.Windows.Controls.Primitives.Selector.SelectedIndex%2A> プロパティが挙げられます。選択コントロールで選択された項目は、ジャーナル履歴のナビゲーション時に保持する必要があります。  
+  
+<a name="RODP"></a>   
+## 読み取り専用の依存関係プロパティ  
+ 読み取り専用の依存関係プロパティを定義することができます。  ただし、プロパティを読み取り専用として定義する理由に関するシナリオは、これらをプロパティ システムに登録し、識別子を公開する手順同様に、少し異なります。  詳細については、「[読み取り専用の依存関係プロパティ](../../../../docs/framework/wpf/advanced/read-only-dependency-properties.md)」を参照してください。  
+  
+<a name="CTDP"></a>   
+## コレクション型依存関係プロパティ  
+ コレクション型依存関係プロパティには、別途考慮する必要のある実装上の問題がいくつかあります。  詳細については、「[コレクション型依存関係プロパティ](../../../../docs/framework/wpf/advanced/collection-type-dependency-properties.md)」を参照してください。  
+  
+<a name="SecurityC"></a>   
+## 依存関係プロパティに関するセキュリティ上の考慮事項  
+ 依存関係プロパティは、パブリック プロパティとして宣言する必要があります。  依存関係プロパティの識別子フィールドは、public static フィールドとして宣言する必要があります。  他のアクセス レベル \(保護など\) を宣言しようとしても、依存関係プロパティには、識別子とプロパティ システム [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の組み合わせを使用して常にアクセスできます。  <xref:System.Windows.LocalValueEnumerator> など、プロパティ システムに組み込まれているメタデータ報告や値決定の [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] により、保護された識別子フィールドにもアクセスできる可能性があります。  詳細については、「[依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)」を参照してください。  
+  
+<a name="DPCtor"></a>   
+## 依存関係プロパティとクラス コンストラクター  
+ マネージ コード プログラミングでは、\(通例 FxCop などのコード分析ツールによって適用される\) 一般的な方針として、クラス コンストラクターで仮想メソッドを呼び出すことは避ける必要があります。  これは、コンストラクターは派生クラスのコンストラクターの基本の初期化として呼び出すことができ、コンストラクターを通じた仮想メソッドの入力は、構築中のオブジェクト インスタンスの初期化が不完全な状態で実行される可能性があるためです。  <xref:System.Windows.DependencyObject> の派生クラスからさらに派生させる場合は、仮想メソッドの呼び出しと公開をプロパティ システム自体が内部的に行う点に注意が必要です。  これらの仮想メソッドは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムのサービスの一部です。  メソッドをオーバーライドすると、派生クラスが値の決定に参加できるようになります。  ランタイムの初期化で問題が発生するのを避けるため、特定のコンストラクター パターンに従わない限り、依存関係プロパティの値はクラスのコンストラクター内で定義しないでください。  詳細については、「[DependencyObject の安全なコンストラクター パターン](../../../../docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md)」を参照してください。  
+  
+## 参照  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)   
+ [コレクション型依存関係プロパティ](../../../../docs/framework/wpf/advanced/collection-type-dependency-properties.md)   
+ [依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)   
+ [XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)   
+ [DependencyObject の安全なコンストラクター パターン](../../../../docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/custom-rendering-ink.md b/docs/framework/wpf/advanced/custom-rendering-ink.md
new file mode 100644
index 00000000000..55b8651a4bb
--- /dev/null
+++ b/docs/framework/wpf/advanced/custom-rendering-ink.md
@@ -0,0 +1,104 @@
+---
+title: "カスタム レンダリング インク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, DynamicRenderer"
+  - "クラス, InkCanvas"
+  - "クラス, ストローク"
+  - "カスタム レンダリング インク"
+  - "DynamicRenderer クラス"
+  - "インク, カスタム レンダリング"
+  - "InkCanvas クラス"
+  - "Stroke クラス"
+ms.assetid: 65c978a7-0ee0-454f-ac7f-b1bd2efecac5
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# カスタム レンダリング インク
+ストロークの <xref:System.Windows.Ink.Stroke.DrawingAttributes%2A> プロパティを使用すると、ストロークのサイズ、色、形状などの外観を指定できますが、<xref:System.Windows.Ink.Stroke.DrawingAttributes%2A> で可能な指定以上の外観にカスタマイズする必要が生じる場合もあります。  インクの外観は、エアブラシや油絵の具などのさまざまな効果の外観でレンダリングすることでカスタマイズできます。  [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] では、カスタムの <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> オブジェクトと <xref:System.Windows.Ink.Stroke> オブジェクトを実装することで、インクのカスタム レンダリングを実行できます。  
+  
+ このトピックは、次の内容で構成されています。  
+  
+-   [アーキテクチャ](#Architecture)  
+  
+-   [動的レンダラーの実装](#ImplementingADynamicRenderer)  
+  
+-   [Implementing a Custom Stroke](#ImplementingACustomStroke)  
+  
+-   [カスタム InkCanvas の実装](#ImplementingACustomInkCanvas)  
+  
+-   [まとめ](#Conclusion)  
+  
+<a name="Architecture"></a>   
+## アーキテクチャ  
+ インクのレンダリングは 2 回行われます。ユーザーがインクをインク サーフェイスに書き込んだときと、ストロークがインク対応サーフェイスに追加された後です。  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> はユーザーがタブレット ペンをデジタイザー上で動かしたときにインクをレンダリングし、<xref:System.Windows.Ink.Stroke> は要素に追加されたときにレンダリングされます。  
+  
+ インクを動的にレンダリングするときに実装するクラスは 3 つあります。  
+  
+1.  **DynamicRenderer** : <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> から派生するクラスを実装します。  このクラスは、ストロークを描画されたとおりにレンダリングする特殊な <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> です。  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は個別のスレッドでレンダリングを実行するため、アプリケーションのユーザー インターフェイス \(UI\) スレッドがブロックされても、インクを収集するためにインク サーフェイスが表示されます。  スレッド処理モデルの詳細については、「[インク スレッド モデル](../../../../docs/framework/wpf/advanced/the-ink-threading-model.md)」を参照してください。  ストロークの動的レンダリングをカスタマイズするには、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.OnDraw%2A> メソッドをオーバーライドします。  
+  
+2.  **Stroke** : <xref:System.Windows.Ink.Stroke> から派生するクラスを実装します。  このクラスは、<xref:System.Windows.Input.StylusPoint> データが <xref:System.Windows.Ink.Stroke> オブジェクトに変換された後に、そのデータの静的レンダリングを実行します。  ストロークの静的レンダリングが動的レンダリングと一貫するようにするには、<xref:System.Windows.Ink.Stroke.DrawCore%2A> メソッドをオーバーライドします。  
+  
+3.  **InkCanvas** : <xref:System.Windows.Controls.InkCanvas> から派生するクラスを実装します。  カスタマイズされた <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を <xref:System.Windows.Controls.InkCanvas.DynamicRenderer%2A> プロパティに割り当てます。  <xref:System.Windows.Controls.InkCanvas.OnStrokeCollected%2A> メソッドをオーバーライドし、カスタム ストロークを <xref:System.Windows.Controls.InkCanvas.Strokes%2A> プロパティに追加します。  これにより、インクの外観の一貫性が確保されます。  
+  
+<a name="ImplementingADynamicRenderer"></a>   
+## 動的レンダラーの実装  
+ <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> クラスは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の標準クラスですが、特殊なレンダリングを実行するには、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> から派生したカスタマイズ動的レンダラーを作成し、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.OnDraw%2A> メソッドをオーバーライドする必要があります。  
+  
+ 線形グラデーション ブラシ効果を使用してインクを描画するカスタマイズされた <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> の例を次に示します。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#19)]
+ [!code-vb[AdvancedInkTopicsSamples#19](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#19)]  
+[!code-csharp[AdvancedInkTopicsSamples#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#1)]
+[!code-vb[AdvancedInkTopicsSamples#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#1)]  
+  
+<a name="ImplementingCustomStrokes"></a>   
+## カスタム ストロークの実装  
+ <xref:System.Windows.Ink.Stroke> から派生するクラスを実装します。  このクラスは、<xref:System.Windows.Input.StylusPoint> データが <xref:System.Windows.Ink.Stroke> オブジェクトに変換された後に、そのデータのレンダリングを実行します。  実際の描画を実行するには、<xref:System.Windows.Ink.Stroke.DrawCore%2A> クラスをオーバーライドします。  
+  
+ <xref:System.Windows.Ink.Stroke.AddPropertyData%2A> メソッドを使用して、Stroke クラスにカスタム データを格納することもできます。  このデータは、永続化される場合、ストローク データと共に格納されます。  
+  
+ <xref:System.Windows.Ink.Stroke> クラスは、ヒット テストを実行することもできます。  また、現在のクラスで <xref:System.Windows.Ink.Stroke.HitTest%2A> メソッドをオーバーライドして、独自のヒット テスト アルゴリズムを実装することもできます。  
+  
+ 次の C\# のコードは、<xref:System.Windows.Input.StylusPoint> データを 3\-D ストロークとしてレンダリングするカスタムの <xref:System.Windows.Ink.Stroke> クラスを示しています。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#19)]
+ [!code-vb[AdvancedInkTopicsSamples#19](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#19)]  
+[!code-csharp[AdvancedInkTopicsSamples#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#2)]
+[!code-vb[AdvancedInkTopicsSamples#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#2)]  
+  
+<a name="ImplementingACustomInkCanvas"></a>   
+## カスタム InkCanvas の実装  
+ カスタマイズされた <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> およびストロークの最も簡単な使用方法は、<xref:System.Windows.Controls.InkCanvas> から派生するクラスを実装して使用することです。  <xref:System.Windows.Controls.InkCanvas> には、ユーザーがストロークを描画しているときにそのストロークをどのようにレンダリングするかを指定する <xref:System.Windows.Controls.InkCanvas.DynamicRenderer%2A> プロパティがあります。  
+  
+ <xref:System.Windows.Controls.InkCanvas> でストロークのカスタム レンダリングを行うには、次の操作を実行します。  
+  
+-   <xref:System.Windows.Controls.InkCanvas> から派生するクラスを作成します。  
+  
+-   カスタマイズされた <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を <xref:System.Windows.Controls.InkCanvas.DynamicRenderer%2A?displayProperty=fullName> プロパティに割り当てます。  
+  
+-   <xref:System.Windows.Controls.InkCanvas.OnStrokeCollected%2A> メソッドをオーバーライドします。  このメソッドで、InkCanvas に追加された元のストロークを削除します。  次に、カスタム ストロークを作成して <xref:System.Windows.Controls.InkCanvas.Strokes%2A> プロパティに追加し、カスタム ストロークを含む新しい <xref:System.Windows.Controls.InkCanvasStrokeCollectedEventArgs> を使用して基本クラスを呼び出します。  
+  
+ 次の C\# のコードは、カスタマイズされた <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を使用してカスタム ストロークを収集するカスタムの <xref:System.Windows.Controls.InkCanvas> クラスを示しています。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/Window1.xaml.cs#9)]  
+  
+ <xref:System.Windows.Controls.InkCanvas> には、複数の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> を追加できます。  複数の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> オブジェクトを <xref:System.Windows.Controls.InkCanvas> に追加するには、それらのオブジェクトを <xref:System.Windows.UIElement.StylusPlugIns%2A> プロパティに追加します。  
+  
+<a name="Conclusion"></a>   
+## まとめ  
+ インクの外観をカスタマイズするには、独自の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer>、<xref:System.Windows.Ink.Stroke>、および <xref:System.Windows.Controls.InkCanvas> クラスを派生させます。  これらのクラスを合わせて、ユーザーがストロークを描画したときとそのストロークが収集された後のストロークの外観の一貫性を確保することができます。  
+  
+## 参照  
+ [高度なインク処理](../../../../docs/framework/wpf/advanced/advanced-ink-handling.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/data-and-data-objects.md b/docs/framework/wpf/advanced/data-and-data-objects.md
new file mode 100644
index 00000000000..544aff2a2ff
--- /dev/null
+++ b/docs/framework/wpf/advanced/data-and-data-objects.md
@@ -0,0 +1,101 @@
+---
+title: "データとデータ オブジェクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ転送 [WPF], ドラッグ アンド ドロップ"
+  - "DataFormats クラス [WPF]"
+  - "DataObject クラス [WPF]"
+ms.assetid: 5967d557-1867-420f-a524-ae3af78402da
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# データとデータ オブジェクト
+ドラッグ アンド ドロップ操作の一部として転送されるデータは、データ オブジェクトに格納されます。  概念上、データ オブジェクトは、次の項目の 1 つ以上のペアで構成されます。  
+  
+-   実際のデータを格納する <xref:System.Object>。  
+  
+-   対応するデータ形式の識別子。  
+  
+ データ自体は、基本 <xref:System.Object> として表すことができる任意の項目で構成できます。  対応するデータ形式は、データの形式に関するヒントを提供する文字列または <xref:System.Type> です。  データ オブジェクトは、データとデータ形式の複数ペアのホストをサポートします。これにより、単一のデータ オブジェクトでデータを複数の形式で提供できます。  
+  
+<a name="Data_and_Data_Objects"></a>   
+## データ オブジェクト  
+ すべてのデータ オブジェクトで、<xref:System.Windows.IDataObject> インターフェイスを実装する必要があります。このインターフェイスは、データ転送を可能にし、容易にする次の標準メソッド セットを提供します。  
+  
+|メソッド|概要|  
+|----------|--------|  
+|<xref:System.Windows.IDataObject.GetData%2A>|データ オブジェクトを指定したデータ形式で取得します。|  
+|<xref:System.Windows.IDataObject.GetDataPresent%2A>|データが指定した形式で使用可能かどうか、または指定した形式に変換可能かどうかをチェックします。|  
+|<xref:System.Windows.IDataObject.GetFormats%2A>|このデータ オブジェクトのデータが格納されているか、または変換可能である形式のリストを返します。|  
+|<xref:System.Windows.IDataObject.SetData%2A>|指定したデータをこのデータ オブジェクトに格納します。|  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Windows.DataObject> クラスの <xref:System.Windows.IDataObject> の基本実装を提供します。  多くの一般的なデータ転送シナリオでは、標準の <xref:System.Windows.DataObject> クラスで十分です。  
+  
+ ビットマップ、CSV、ファイル、HTML、RTF、文字列、テキスト、オーディオなど、複数の定義済みの形式があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で提供される定義済みのデータ形式については、<xref:System.Windows.DataFormats> クラスのリファレンス トピックを参照してください。  
+  
+ 一般的に、データ オブジェクトには、データの抽出時にある形式で格納されているデータを別の形式に自動的に変換する機能が含まれています。この機能は自動変換と呼ばれます。  データ オブジェクトで使用できるデータ形式を照会するときに、<xref:System.Windows.DataObject.GetFormats%28System.Boolean%29> メソッドまたは <xref:System.Windows.DataObject.GetDataPresent%28System.String%2CSystem.Boolean%29> メソッドを呼び出して `autoConvert` パラメーターを `false` に指定することで、自動変換可能なデータ形式をネイティブ データ形式からフィルター処理することができます。  <xref:System.Windows.DataObject.SetData%28System.String%2CSystem.Object%2CSystem.Boolean%29> メソッドを使用してデータをデータ オブジェクトに追加する場合、`autoConvert` パラメーターを `false` に設定してデータの自動変換を禁止することができます。  
+  
+<a name="Working_with_Data_Objects"></a>   
+## データ オブジェクトの操作  
+ ここでは、データ オブジェクトを作成および操作する一般的な手法について説明します。  
+  
+### 新しいデータ オブジェクトの作成  
+ <xref:System.Windows.DataObject> クラスは、新しい <xref:System.Windows.DataObject> インスタンスに単一のデータとデータ形式のペアを容易に設定できるようにするいくつかのオーバーロードされたコンストラクターを提供します。  
+  
+ 新しいデータ オブジェクトを作成し、オーバーロードされたこのコンストラクター <xref:System.Windows.DataObject.%23ctor%2A> \(<xref:System.Windows.DataObject.%23ctor%28System.String%2CSystem.Object%29>\) のいずれかを使用して、文字列と指定したデータ形式でデータ オブジェクトを初期化するコード例を次に示します。  ここでは、データ形式は文字列によって指定されます。<xref:System.Windows.DataFormats> クラスは、事前定義されている一連の型文字列を提供します。  既定では、格納されるデータの自動変換が有効です。  
+  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_typestring)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_typestring)]  
+  
+ データ オブジェクトを作成するコードの例については、「[データ オブジェクトを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-data-object.md)」を参照してください。  
+  
+### 複数の形式のデータの格納  
+ 単一のデータ オブジェクトに複数の形式でデータを格納できます。  単一のデータ オブジェクト内で複数のデータ形式を戦略的に使用すると、単一のデータ形式のみを表す場合よりも、データ オブジェクトを幅広いドロップ ターゲットで使用できる可能性が高くなります。  通常、ドラッグ ソースは潜在的なドロップ ターゲットで使用できるデータ形式に依存しない必要があることに注意してください。  
+  
+ 次の例は、<xref:System.Windows.DataObject.SetData%28System.String%2CSystem.Object%29> メソッドを使用してデータを複数の形式のデータ オブジェクトに追加する方法を示しています。  
+  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_StoreMultipleFormats](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_storemultipleformats)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_StoreMultipleFormats](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_storemultipleformats)]  
+  
+### データ オブジェクトで使用可能な形式の照会  
+ 単一のデータ オブジェクトに任意の数のデータ形式を含めることができるため、データ オブジェクトには、使用可能なデータ形式のリストを取得する機能が含まれています。  
+  
+ <xref:System.Windows.DataObject.GetFormats%2A> オーバーロードを使用して、データ オブジェクトで使用可能なすべてのデータ形式 \(ネイティブおよび自動変換の両方で使用可能\) を示す一連の文字列を取得するコード例を次に示します。  
+  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getalldataformats)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getalldataformats)]  
+  
+ データ オブジェクトで使用可能なデータ形式を照会するコードの例については、「[データ オブジェクト内のデータ形式の一覧を表示する](../../../../docs/framework/wpf/advanced/how-to-list-the-data-formats-in-a-data-object.md)」を参照してください。  特定のデータ形式が存在するかどうかをデータ オブジェクトに照会する例については、「[データ形式がデータ オブジェクトに存在するかどうかを判別する](../../../../docs/framework/wpf/advanced/how-to-determine-if-a-data-format-is-present-in-a-data-object.md)」を参照してください。  
+  
+### データ オブジェクトからのデータの取得  
+ データ オブジェクトから特定の形式のデータを取得するには、単に <xref:System.Windows.DataObject.GetData%2A> メソッドのいずれかを呼び出して目的のデータ形式を指定します。  <xref:System.Windows.DataObject.GetDataPresent%2A> メソッドのいずれかを使用すると、特定のデータ形式が存在するかどうかを確認できます。  <xref:System.Windows.DataObject.GetData%2A> は、<xref:System.Object> 内のデータを返します。データ形式に応じて、このオブジェクトを型固有のコンテナーにキャストできます。  
+  
+ <xref:System.Windows.DataObject.GetDataPresent%28System.String%29> オーバーロードを使用して、指定したデータ形式が \(ネイティブで、または自動変換により\) 使用可能かどうかを確認するコード例を次に示します。  指定した形式が使用可能な場合は、<xref:System.Windows.DataObject.GetData%28System.String%29> メソッドを使用してデータを取得します。  
+  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getspecificdataformat)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getspecificdataformat)]  
+  
+ データ オブジェクトからデータを取得するコードの例については、「[特定のデータ形式でデータを取得する](../../../../docs/framework/wpf/advanced/how-to-retrieve-data-in-a-particular-data-format.md)」を参照してください。  
+  
+### データ オブジェクトからのデータの削除  
+ データは、データ オブジェクトから直接削除できません。  データ オブジェクトからデータを事実上削除するには、次の手順に従います。  
+  
+1.  保持するデータのみを含む新しいデータ オブジェクトを作成します。  
+  
+2.  古いデータ オブジェクトから新しいデータ オブジェクトに目的のデータを "コピー" します。  データをコピーするには、<xref:System.Windows.DataObject.GetData%2A> メソッドのいずれかを使用して未処理データを含む <xref:System.Object> を取得し、<xref:System.Windows.DataObject.SetData%2A> メソッドのいずれかを使用してデータを新しいデータ オブジェクトに追加します。  
+  
+3.  古いデータ オブジェクトを新しいデータ オブジェクトに置き換えます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.DataObject.SetData%2A> メソッドは、データ オブジェクトへのデータの追加のみを行います。データとデータ形式が前回の呼び出しとまったく同じ場合でも、データの置換は行いません。  同じデータとデータ形式に対して <xref:System.Windows.DataObject.SetData%2A> を 2 回呼び出すと、そのデータとデータ形式がデータ オブジェクトに 2 回存在することになります。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/datetime-xaml-syntax.md b/docs/framework/wpf/advanced/datetime-xaml-syntax.md
new file mode 100644
index 00000000000..a119933a0dd
--- /dev/null
+++ b/docs/framework/wpf/advanced/datetime-xaml-syntax.md
@@ -0,0 +1,86 @@
+---
+title: "DateTime XAML 構文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DateTime XAML 構文 [WPF]"
+  - "DateTime XAML 構文 [WPF], 書式指定文字列"
+  - "DateTime XAML 構文 [WPF], 文字列"
+  - "DateTime XAML 構文 [WPF], 使用される状況"
+  - "DateTime XAML テキスト [WPF]"
+  - "短い日付形式 [WPF], DateTime"
+ms.assetid: 5901710a-609b-40c8-9d65-f0016cd9090b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# DateTime XAML 構文
+<xref:System.Windows.Controls.Calendar> や <xref:System.Windows.Controls.DatePicker> など、一部のコントロールには、<xref:System.DateTime> 型を使用したプロパティが存在します。  これらのコントロールに対する日付または時刻の初期値は、分離コードで実行時に指定するのが一般的です。ただし、日付または時刻の初期値を XAML で指定することもできます。  WPF XAML パーサーが組み込みの XAML テキスト構文を使用して、<xref:System.DateTime> の値を解析します。  このトピックでは、<xref:System.DateTime> の XAML テキスト構文の指定方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="where_datetime_xaml_syntax_is_used"></a>   
+## DateTime XAML 構文が使用される状況  
+ 日付は必ずしも XAML で設定する必要はありません。また、XAML で設定することが適切とは言えない場合もあります。  たとえば、<xref:System.DateTime.Now%2A?displayProperty=fullName> プロパティを使用すると、実行時に日付を初期化できます。また、カレンダーに対する日付の調整も、ユーザーの入力に基づいて分離コードですべて行うことができます。  ただし、コントロール テンプレートの中で、<xref:System.Windows.Controls.Calendar> や <xref:System.Windows.Controls.DatePicker> に対して日付をハードコーディングすることが必要となる場合もあります。  このようなシナリオでは、<xref:System.DateTime> XAML 構文を使用する必要があります。  
+  
+### DateTime XAML 構文はネイティブの動作  
+ <xref:System.DateTime> は、CLR の基本クラス ライブラリで定義されているクラスです。  基本クラス ライブラリと CLR の他のライブラリとの関連性のため、<xref:System.ComponentModel.TypeConverterAttribute> をクラスに適用し、型コンバーターを使用して XAML 文字列を処理し、ランタイム オブジェクト モデルの <xref:System.DateTime> に変換することはできません。  変換動作を提供する `DateTimeConverter` クラスは存在しません。このトピックで説明する変換動作は、WPF XAML パーサーのネイティブな動作です。  
+  
+<a name="format_strings_for_datetime_xaml_syntax"></a>   
+## DateTime XAML 構文の書式指定文字列  
+ <xref:System.DateTime> の形式は、書式指定文字列で指定できます。  書式指定文字列は、値を作成するときに使用できるテキスト構文を形式化します。  既存の WPF コントロールの <xref:System.DateTime> 値では、一般に、<xref:System.DateTime> の日付要素のみを使用し、時刻要素は使用しません。  
+  
+ <xref:System.DateTime> XAML で指定する場合、どの書式指定文字列でも代用できます。  
+  
+ また、このトピックで特に示されていない形式および書式指定文字列も使用できます。  技術的には、<xref:System.DateTime> 値を XAML で指定する場合、WPF XAML パーサーによって解析されるときに <xref:System.DateTime.Parse%2A?displayProperty=fullName> に対して内部的な呼び出しを使用します。したがって、XAML 入力では <xref:System.DateTime.Parse%2A?displayProperty=fullName> で受け取ることのできる任意の文字列を使用できます。  詳細については、「<xref:System.DateTime.Parse%2A?displayProperty=fullName>」を参照してください。  
+  
+> [!IMPORTANT]
+>  DateTime XAML 構文でネイティブ変換を行う場合は、常に `en-us` を <xref:System.Globalization.CultureInfo> として使用します。  このことは、XAML 内の <xref:System.Windows.FrameworkElement.Language%2A> 値または `xml:lang` 値による影響を受けません。XAML の属性レベルでの型変換は、コンテキストなしでも動作するためです。  日や月を表示する順序などにはカルチャによる違いがあるため、ここで示した書式指定文字列は補完しないでください。  ここで示した書式指定文字列は、その他のカルチャ設定に関係なく、XAML を解析する場合に適しています。  
+  
+ 以降のセクションでは、<xref:System.DateTime> の一般的な書式指定文字列について説明します。  
+  
+### 短い形式の日付パターン \("d"\)  
+ XAML における <xref:System.DateTime> の短い日付形式は次のとおりです。  
+  
+ `M/d/YYYY`  
+  
+ これは、WPF コントロールでの一般的な使用法で、必要なすべての情報を指定するための最も簡単な形式です。タイム ゾーン オフセットと時刻要素を誤って指定した場合でも影響を受けないため、他の形式ではなく、この形式の使用をお勧めします。  
+  
+ たとえば、2010 年 6 月 1 日を指定するには、次の文字列を使用します。  
+  
+ `3/1/2010`  
+  
+ 詳細については、「<xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A?displayProperty=fullName>」を参照してください。  
+  
+### 並べ替えできる DateTime のパターン \("s"\)  
+ XAML における並べ替え可能な <xref:System.DateTime> のパターンを次に示します。  
+  
+ `yyyy'-'MM'-'dd'T'HH':'mm':'ss`  
+  
+ たとえば、2010 年 6 月 1 日を指定するには、次の文字列を使用します \(時刻要素はすべて 0 として入力されます\)。  
+  
+ `2010-06-01T000:00:00`  
+  
+### RFC1123 パターン \("r"\)  
+ RFC1123 パターンの利点は、カルチャに依存しないために、RFC1123 パターンが使用されている他の日付ジェネレーターから入力された文字列を使用できることです。  XAML における RFC1123 の <xref:System.DateTime> パターンを次に示します。  
+  
+ `ddd, dd MMM yyyy HH':'mm':'ss 'UTC'`  
+  
+ たとえば、2010 年 6 月 1 日を指定するには、次の文字列を使用します \(時刻要素はすべて 0 として入力されます\)。  
+  
+ `Mon, 01 Jun 2010 00:00:00 UTC`  
+  
+### その他の形式とパターン  
+ 既に説明したように、XAML における <xref:System.DateTime> では、<xref:System.DateTime.Parse%2A?displayProperty=fullName> に対する入力として受け取ることのできる任意の文字列を指定できます。  これには、その他の形式化された形式 \(例: <xref:System.Globalization.DateTimeFormatInfo.UniversalSortableDateTimePattern%2A>\) および特定の <xref:System.Globalization.DateTimeFormatInfo> フォームとして形式化されていない形式が含まれます。  たとえば、`YYYY/mm/dd` フォームを <xref:System.DateTime.Parse%2A?displayProperty=fullName> の入力として使用できます。  このトピックでは、使用可能な形式の一部を説明します。標準的な使用手順としては、短い形式の日付パターンをお勧めします。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dependency-properties-overview.md b/docs/framework/wpf/advanced/dependency-properties-overview.md
new file mode 100644
index 00000000000..7ef023fee99
--- /dev/null
+++ b/docs/framework/wpf/advanced/dependency-properties-overview.md
@@ -0,0 +1,224 @@
+---
+title: "依存関係プロパティの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付プロパティ"
+  - "データ バインディング"
+  - "依存関係プロパティ"
+  - "プロパティ, 添付"
+  - "プロパティ, 概要"
+  - "リソース, 参照"
+  - "スタイル"
+ms.assetid: d119d00c-3afb-48d6-87a0-c4da4f83dee5
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# 依存関係プロパティの概要
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティの機能を拡張するために使用できる一連のサービスが用意されています。  通常、これらのサービスをまとめて [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムと呼びます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムによってサポートされるプロパティは、[依存関係プロパティ](GTMT)と呼ばれています。ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムについて、および[依存関係プロパティ](GTMT)の機能について説明します。この説明では、既存の[依存関係プロパティ](GTMT)を XAML およびコードで使用する方法を示します。  また、依存関係プロパティ メタデータなどの依存関係プロパティの特殊な側面や、カスタム クラスで独自の依存関係プロパティを作成する方法についても説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ ここでは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] およびオブジェクト指向プログラミングに関する基礎知識があることを前提にしています。  このトピックの例に従うには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] について理解し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの作成方法に精通している必要があります。  詳細については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  
+  
+<a name="why_dependency_properties"></a>   
+## 依存関係プロパティおよび CLR プロパティ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では通常、プロパティは[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティとして公開されます。  基本的なレベルでは、これらのプロパティと直接対話でき、これらのプロパティが[依存関係](GTMT)として実装されることを認識することはありません。  ただし、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムの一部またはすべての機能を利用できるように、これらの機能に精通しておく必要があります。  
+  
+ [依存関係プロパティ](GTMT)の目的は、他の入力の値に基づいてプロパティの値を計算する方法を提供することです。  他の入力には、テーマやユーザー設定などのシステム プロパティ、データ バインディングやアニメーション\/ストーリーボードなどのジャスト イン タイム プロパティ判定機構、リソースやスタイルなどの多目的のテンプレート、要素ツリー内の他の要素との親子のリレーションシップから判断される値などがあります。  また、[依存関係プロパティ](GTMT)を実装して、自己完結型の検証、既定値、他のプロパティに対する変更を監視するコールバック、およびランタイム情報の可能性がある情報に基づいてプロパティ値を強制するシステムを提供できます。  既存のプロパティの実際の実装をオーバーライドしたり新しいプロパティを作成したりするのではなく、依存関係プロパティ メタデータをオーバーライドすることによって、派生クラスで既存のプロパティの特定の特性を変更することもできます。  
+  
+ SDK リファレンスで、プロパティのマネージ リファレンス ページの「依存関係プロパティの情報」セクションの有無によって、どのプロパティが依存関係プロパティかを特定できます。  「依存関係プロパティの情報」セクションにはその依存関係プロパティの <xref:System.Windows.DependencyProperty> 識別子フィールドへのリンクがあり、そのプロパティに設定されるメタデータ オプションのリスト、クラスごとのオーバーライド情報、およびその他の詳細も示されています。  
+  
+<a name="back_dependency_properties"></a>   
+## 依存関係プロパティによる CLR プロパティの補足  
+ [依存関係プロパティ](GTMT)および [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムは、プライベート フィールドでプロパティをサポートする標準パターンの代替実装として、プロパティをサポートする型を提供することによって、プロパティ機能を拡張します。  この型の名前は <xref:System.Windows.DependencyProperty> です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムを定義するもう 1 つの重要な型は <xref:System.Windows.DependencyObject> です。<xref:System.Windows.DependencyObject> は、[依存関係プロパティ](GTMT)を登録および所有できる基本クラスを定義します。  
+  
+ [依存関係プロパティ](GTMT)について説明するときにこの[!INCLUDE[TLA#tla_sdk](../../../../includes/tlasharptla-sdk-md.md)] ドキュメントで使用する用語の概要を次に示します。  
+  
+-   **依存関係プロパティ** : <xref:System.Windows.DependencyProperty> によってサポートされるプロパティ。  
+  
+-   **依存関係プロパティの識別子**: [依存関係プロパティ](GTMT)の登録時に戻り値として取得され、クラスの静的メンバーとして格納される <xref:System.Windows.DependencyProperty> インスタンス。  この識別子は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムと対話する多くの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] でパラメーターとして使用されます。  
+  
+-   **CLR "ラッパー"** : プロパティの実際の get および set 実装。  これらの実装は、依存関係プロパティの識別子を <xref:System.Windows.DependencyObject.GetValue%2A> および <xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しで使用し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムを使用してプロパティの補足を提供することによって、その識別子を組み込みます。  
+  
+ 次の例では、`IsSpinning` [依存関係プロパティ](GTMT)を定義し、<xref:System.Windows.DependencyProperty> 識別子とサポートされるプロパティの関係を示します。  
+  
+ [!code-csharp[PropertiesOvwSupport#DPFormBasic](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#dpformbasic)]
+ [!code-vb[PropertiesOvwSupport#DPFormBasic](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page4.xaml.vb#dpformbasic)]  
+[!code-csharp[PropertiesOvwSupport#DPFormBasic2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml.cs#dpformbasic2)]  
+  
+ プロパティとそれを補足する <xref:System.Windows.DependencyProperty> フィールドの名前付け規則は重要です。  フィールドの名前は常にプロパティの名前であり、サフィックス `Property` が追加されます。  この規則とその理由の詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+<a name="setting_property_values"></a>   
+## プロパティ値の設定  
+ コードまたは XAML でプロパティを設定できます。  
+  
+<a name="local_property_values"></a>   
+### XAML でのプロパティ値の設定  
+ ボタンの背景色を赤に指定する方法を次の XAML の例に示します。  この例では、生成されたコードで XAML 属性の単純な文字列値が WPF XAML パーサーによって [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 型 \(<xref:System.Windows.Media.SolidColorBrush> を使用した <xref:System.Windows.Media.Color>\) に型変換される場合を示します。  
+  
+ [!code-xml[PropertiesOvwSupport#MostBasicProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/Page1.xaml#mostbasicproperty)]  
+  
+ XAML は、プロパティを設定するためのさまざまな構文形式をサポートします。  特定のプロパティに対してどの構文を使用するかは、プロパティで使用される値型、および型コンバーターの有無などのその他の要素によって決定されます。  プロパティ設定の XAML 構文の詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」および「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+ 属性以外の構文の例として、別のボタンの背景を次の XAML の例に示します。  今回は単純な純色を設定するのではなく、背景をイメージに設定し、そのイメージおよびそのイメージのソースを表す要素を、入れ子にした要素の属性として指定します。  これは、プロパティ要素構文の例です。  
+  
+ [!code-xml[PropertiesOvwSupport#PESyntaxProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/Page1.xaml#pesyntaxproperty)]  
+  
+<a name="setting_properties_code"></a>   
+### コードでのプロパティの設定  
+ [依存関係プロパティ](GTMT)の値をコードで設定するには、通常、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] "ラッパー" によって公開される set 実装を呼び出すだけで済みます。  
+  
+ [!code-csharp[PropertiesOvwSupport#ProceduralPropertySet](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/Page1.xaml.cs#proceduralpropertyset)]
+ [!code-vb[PropertiesOvwSupport#ProceduralPropertySet](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page1.xaml.vb#proceduralpropertyset)]  
+  
+ プロパティ値を取得する場合も、基本的に get "ラッパー" 実装を呼び出します。  
+  
+ [!code-csharp[PropertiesOvwSupport#ProceduralPropertyGet](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/Page1.xaml.cs#proceduralpropertyget)]
+ [!code-vb[PropertiesOvwSupport#ProceduralPropertyGet](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page1.xaml.vb#proceduralpropertyget)]  
+  
+ また、プロパティ システム [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] <xref:System.Windows.DependencyObject.GetValue%2A> および <xref:System.Windows.DependencyObject.SetValue%2A> を直接呼び出すこともできます。  これは通常、既存のプロパティを使用する場合は不要ですが \(ラッパーの方が便利で、開発者ツール用のより優れたプロパティが公開されます\)、[!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を直接呼び出す方法は、特定のシナリオに適しています。  
+  
+ プロパティは、XAML で設定してから分離コードを介してコードでアクセスすることもできます。  詳細については、「[WPF における分離コードと XAML](../../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)」を参照してください。  
+  
+<a name="functionality"></a>   
+## 依存関係プロパティによって提供されるプロパティ機能  
+ 依存関係プロパティは、フィールドによって補足されるプロパティとは対照的に、プロパティの機能を拡張する機能を提供します。  多くの場合、このような機能のそれぞれが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 全体の機能セットの特定の機能を表したりサポートしたりします。  
+  
+-   [リソース](#setting_properties_resources)  
+  
+-   [データ バインディング](#setting_properties_data_binding)  
+  
+-   [スタイル](#setting_properties_styles)  
+  
+-   [アニメーション](#animations)  
+  
+-   [メタデータのオーバーライド](#metadata)  
+  
+-   [プロパティ値の継承](#setting_properties_inheritance)  
+  
+-   [WPF デザイナーの統合](#vs2008_integration)  
+  
+<a name="setting_properties_resources"></a>   
+### リソース  
+ 依存関係プロパティの値は、リソースを参照することによって設定できます。  リソースは通常、ページのルート要素またはアプリケーションの `Resources` プロパティ値として指定されます \(これらの場所を使用することが、リソースにアクセスするのに最も便利な方法です\)。  <xref:System.Windows.Media.SolidColorBrush> リソースを定義する方法を次の例に示します。  
+  
+ [!code-xml[PropertiesOvwSupport#ResourcesResource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page2.xaml#resourcesresource)]  
+  
+ リソースを定義すると、リソースを参照し、そのリソースを使用してプロパティ値を指定できるようになります。  
+  
+ [!code-xml[PropertiesOvwSupport#ResourcesReference](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page2.xaml#resourcesreference)]  
+  
+ この特定のリソースは、[DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md) として参照されます \(WPF XAML では、静的リソース参照または動的リソース参照を使用できます\)。  動的リソース参照を使用するには、依存関係プロパティに設定している必要があるため、これは具体的には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムによって有効になる動的リソース参照の使用方法になります。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+> [!NOTE]
+>  リソースはローカル値として扱われます。つまり、別のローカル値を設定すると、リソース参照がなくなります。  詳細については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+<a name="setting_properties_data_binding"></a>   
+### データ バインディング  
+ 依存関係プロパティは、データ バインディングを介して値を参照できます。  データ バインドは、XAML で特定のマークアップ拡張機能構文を介して機能するか、コードで <xref:System.Windows.Data.Binding> オブジェクトを介して機能します。  データ バインディングを使用すると、プロパティ値の最終的な決定が、データ ソースから値が取得される実行時まで延期されます。  
+  
+ XAML で宣言されたバインディングを使用して、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティを設定する例を次に示します。  バインディングでは、継承されたデータ コンテキストおよび <xref:System.Windows.Data.XmlDataProvider> データ ソース \(この例には示されていません\) が使用されます。  バインディング自体は、データ ソース内で <xref:System.Windows.Data.Binding.XPath%2A> によって目的のソース プロパティを指定します。  
+  
+ [!code-xml[PropertiesOvwSupport#BasicInlineBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#basicinlinebinding)]  
+  
+> [!NOTE]
+>  バインディングはローカル値として扱われます。つまり、別のローカル値を設定すると、バインディングがなくなります。  詳細については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+ 依存関係プロパティまたは <xref:System.Windows.DependencyObject> クラスは、データ バインディング操作に対応する <xref:System.Windows.DependencyObject> ソース プロパティ値の変更の通知を生成する <xref:System.ComponentModel.INotifyPropertyChanged> をネイティブ サポートしません。  データ バインディング ターゲットに対する変更を報告できる、データ バインディングで使用するためのプロパティを作成する方法の詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+<a name="setting_properties_styles"></a>   
+### スタイル  
+ スタイルおよびテンプレートは、依存関係プロパティの使用に関する 2 つの主なシナリオです。  スタイルは、アプリケーション [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を定義するプロパティを設定する際に特に役立ちます。  通常、スタイルは XAML のリソースとして定義されます。  スタイルには通常、特定のプロパティの "setter" および別のプロパティのリアルタイム値に基づいてプロパティ値を変更する "トリガー" が含まれるため、スタイルはプロパティ システムと対話します。  
+  
+ 非常に単純なスタイル \(<xref:System.Windows.FrameworkElement.Resources%2A> ディクショナリ内で定義されますが、この例には示されていません\) を作成し、そのスタイルを <xref:System.Windows.Controls.Button> の <xref:System.Windows.FrameworkElement.Style%2A> プロパティに直接適用する例を次に示します。  スタイル内の setter によって、スタイルが適用された <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> プロパティが緑色に設定されます。  
+  
+ [!code-xml[PropertiesOvwSupport#SimpleStyleDef](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#simplestyledef)]  
+  
+ [!code-xml[PropertiesOvwSupport#SimpleStyle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#simplestyle)]  
+  
+ 詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+<a name="animations"></a>   
+### アニメーション  
+ 依存関係プロパティは、アニメーション化することができます。  アニメーションが適用されて実行されると、アニメーション化された値は、それ以外の場合のプロパティの値 \(ローカル値など\) よりも高い優先順位で動作します。  
+  
+ <xref:System.Windows.Controls.Button> プロパティの <xref:System.Windows.Controls.Control.Background%2A> をアニメーション化する例を次に示します \(技術的には、<xref:System.Windows.Controls.Control.Background%2A> はプロパティ要素構文を使用して空白の <xref:System.Windows.Media.SolidColorBrush> を <xref:System.Windows.Controls.Control.Background%2A> として指定することでアニメーション化され、その <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティが、直接アニメーション化されるプロパティになります\)。  
+  
+ [!code-xml[PropertiesOvwSupport#MiniAnimate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#minianimate)]  
+  
+ プロパティのアニメーション化の詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」および「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+<a name="metadata"></a>   
+### メタデータのオーバーライド  
+ [依存関係プロパティ](GTMT)の特定の動作は、[依存関係プロパティ](GTMT)を最初に登録したクラスから派生させるときにプロパティのメタデータをオーバーライドすることで変更できます。  メタデータのオーバーライドは、<xref:System.Windows.DependencyProperty> 識別子に依存します。  メタデータのオーバーライドでは、プロパティを再実装する必要はありません。  メタデータの変更は、プロパティ システムでネイティブに処理されます。各クラスは、基本クラスから継承したすべてのプロパティに対して、型ごとに個別のメタデータを保持する可能性があります。  
+  
+ 依存関係プロパティ <xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> のメタデータをオーバーライドする例を次に示します。  この特定の依存関係プロパティ メタデータのオーバーライドは、テーマから既定のスタイルを使用できるコントロールを作成する実装パターンの一部です。  
+  
+ [!code-csharp[PropertiesOvwSupport#OverrideMetadata](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml.cs#overridemetadata)]
+ [!code-vb[PropertiesOvwSupport#OverrideMetadata](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page3.xaml.vb#overridemetadata)]  
+  
+ プロパティ メタデータをオーバーライドまたは取得する方法の詳細については、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+<a name="setting_properties_inheritance"></a>   
+### プロパティ値の継承  
+ 要素は、オブジェクト ツリー内の親から依存関係プロパティの値を継承できます。  
+  
+> [!NOTE]
+>  プロパティ値の継承動作は、すべての依存関係プロパティにグローバルに有効にはなりません。これは、継承の計算時間がパフォーマンスに影響するからです。  プロパティ値の継承は通常、特定のシナリオでプロパティ値の継承が適切であると示されるプロパティに対してのみ有効にします。  SDK リファレンスで、依存関係プロパティの「依存関係プロパティの情報」セクションを調べて、依存関係プロパティで継承を行うかどうかを決定できます。  
+  
+ 次の例ではバインディングを示し、前述のバインディングの例では示されていなかったバインディングのソースを指定する <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを設定します。  子オブジェクトの以降のバインディングではソースを指定する必要はなく、親 <xref:System.Windows.Controls.StackPanel> オブジェクトの <xref:System.Windows.FrameworkElement.DataContext%2A> から継承された値を使用できます   \(または、子オブジェクトが独自の <xref:System.Windows.FrameworkElement.DataContext%2A> または <xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.Binding.Source%2A> を直接指定し、そのバインディングのデータ コンテキストに継承された値を意図的に使用しないようにすることもできます\)。  
+  
+ [!code-xml[PropertiesOvwSupport#InheritanceContext](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#inheritancecontext)]  
+  
+ 詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+<a name="vs2008_integration"></a>   
+### WPF デザイナーの統合  
+ 依存関係プロパティとして実装されるプロパティを使用するカスタム コントロールは、適切な [!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] のサポートを受けます。  1 つの例として、**\[プロパティ\]** ウィンドウで、直接依存関係プロパティと添付依存関係プロパティを編集できる機能が挙げられます。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+<a name="value_determination"></a>   
+## 依存関係プロパティ値の優先順位  
+ [依存関係プロパティ](GTMT)の値を取得する場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムに関係する他のプロパティに基づく入力のいずれかを介して、そのプロパティに設定された値を取得する可能性があります。  プロパティの値の取得方法に関するさまざまなシナリオが予測可能な方法で相互作用できるように、依存関係プロパティ値の優先順位が存在しています。  
+  
+ 例を次に示します。  この例には、すべてのボタンおよびそれらの <xref:System.Windows.Controls.Control.Background%2A> プロパティに適用されるスタイルが含まれていますが、<xref:System.Windows.Controls.Control.Background%2A> 値がローカルに設定されているボタンも 1 つ指定されています。  
+  
+> [!NOTE]
+>  SDK ドキュメントでは、依存関係プロパティについて説明するときに、"ローカル値" または "ローカルに設定された値" という用語が使用される場合があります。  ローカルに設定された値は、コードでオブジェクト インスタンスに直接設定されたプロパティ値または XAML で要素の属性として設定されたプロパティ値です。  
+  
+ 原則として、最初のボタンではプロパティが 2 回設定されますが、適用される値は 1 つだけで、優先順位が最も高い値が適用されます。  ローカルに設定された値の優先順位が最も高いため \(実行中のアニメーションを除きますが、この例ではアニメーションは適用されていません\)、最初のボタンの背景に対するスタイル setter の値ではなくローカルに設定された値が使用されます。  2 番目のボタンにはローカル値が設定されていないため \(また、優先順位がスタイル setter より高い値が他にないため\)、そのボタンの背景はスタイル setter に基づきます。  
+  
+ [!code-xml[PropertiesOvwSupport#MiniPrecedence](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml#miniprecedence)]  
+  
+### 依存関係プロパティの優先順位が存在する理由  
+ 通常、スタイルを常に適用し、個別の要素のローカルに設定された値を無効にすることは望ましくありません \(また、一般に、スタイルまたは要素の使用は非常に困難です\)。  そのため、スタイルに基づく値は、ローカルに設定された値よりも低い優先順位で動作します。  依存関係プロパティの詳細なリストおよび依存関係プロパティの有効値を決める要因については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素で定義されるプロパティには、依存関係プロパティではないものが多数あります。  概してプロパティは、プロパティ システムによって可能になる 1 つ以上のシナリオ \(データ バインディング、スタイル設定、アニメーション、既定値のサポート、継承、添付プロパティ、または無効化\) をサポートする必要がある場合にのみ依存関係プロパティとして実装されます。  
+  
+<a name="dp_implement_roadmap"></a>   
+## 依存関係プロパティの詳細情報  
+  
+-   [添付プロパティ](GTMT)は、XAML で特殊な構文をサポートするプロパティの一種です。  多くの場合、添付プロパティは[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティと 1 対 1 で対応せず、[依存関係プロパティ](GTMT)であるとは限りません。  [添付プロパティ](GTMT)の一般的な目的は、親要素と子要素がどちらも、クラス メンバー リストの一部としてそのプロパティを処理しない場合でも、子要素が親要素にプロパティ値を報告できるようにすることです。  主なシナリオは、子要素から親要素に [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] でどのように表示するかを通知できるようにすることです。例については、<xref:System.Windows.Controls.DockPanel.Dock%2A> または <xref:System.Windows.Controls.Canvas.Left%2A> を参照してください。  詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+-   コンポーネントまたはアプリケーションの開発者は、データ バインディングやスタイルのサポートなどの機能を有効にするために、または無効化および値の強制のサポートのために、独自の[依存関係プロパティ](GTMT)を作成できます。  詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+-   依存関係プロパティは通常、インスタンスにアクセスできる呼び出し元がアクセス可能か、少なくとも検出可能なパブリック プロパティと見なされます。  詳細については、「[依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)」を参照してください。  
+  
+## 参照  
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [読み取り専用の依存関係プロパティ](../../../../docs/framework/wpf/advanced/read-only-dependency-properties.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md b/docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md
new file mode 100644
index 00000000000..a7a646d4548
--- /dev/null
+++ b/docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md
@@ -0,0 +1,90 @@
+---
+title: "依存関係プロパティのコールバックと検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コールバック, 検証"
+  - "強制値コールバック"
+  - "依存関係プロパティ, コールバック"
+  - "依存関係プロパティ, 検証"
+  - "検証 (依存関係プロパティの)"
+ms.assetid: 48db5fb2-da7f-49a6-8e81-3540e7b25825
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 依存関係プロパティのコールバックと検証
+このトピックでは、検証による判定、プロパティの有効値が変更されたときに呼び出されるコールバック、値の決定への外部的影響のオーバーライドなど、プロパティ関連機能の代替カスタム実装を使用して依存関係プロパティを作成する方法について説明します。  また、これらの手法を用いてプロパティ システムの既定の動作を拡張することが適切であるシナリオについても説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、依存プロパティの実装の基本シナリオとカスタム依存プロパティへのメタデータの適用方法を理解していることを前提とします。  詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」および「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+<a name="Validation_Callbacks"></a>   
+## 検証コールバック  
+ 検証コールバックは、最初の登録時に依存関係プロパティに割り当てることができます。  検証コールバックは、プロパティ メタデータの一部ではなく、<xref:System.Windows.DependencyProperty.Register%2A> メソッドの直接入力です。  したがって、依存関係プロパティの検証コールバックを作成した後で、その検証コールバックを新しい実装でオーバーライドすることはできません。  
+  
+ [!code-csharp[DPCallbackOverride#CurrentDefinitionWithWrapper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DPCallbackOverride/CSharp/SDKSampleLibrary/class1.cs#currentdefinitionwithwrapper)]
+ [!code-vb[DPCallbackOverride#CurrentDefinitionWithWrapper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DPCallbackOverride/visualbasic/sdksamplelibrary/class1.vb#currentdefinitionwithwrapper)]  
+  
+ 検証コールバックは、オブジェクト値を受け取るように実装されます。  指定された値がプロパティに対して有効である場合は `true` を、有効でない場合は `false` を返します。  プロパティの型はプロパティ システムに登録済みの適切な型であると想定されます。したがって、通常の場合、コールバック内での型チェックは行われません。  検証コールバックは、プロパティ システムが実行するさまざまな操作で使用されます。  たとえば、最初に型を既定値で初期化したり、<xref:System.Windows.DependencyObject.SetValue%2A> を呼び出してプログラムで値を変更したり、指定された新しい既定値でメタデータをオーバーライドする場合などに使用されます。  これらの操作で呼び出された検証コールバックが `false` を返す場合、例外が発生します。  アプリケーションの作成者はこれらの例外を処理する必要があります。  検証コールバックは、列挙値の検証や、プロパティの測定値がゼロ以上に設定されている場合に integer 型または double 型の値を制限するときによく使用されます。  
+  
+ 検証コールバックは、インスタンスではなくクラスを検証するためのものです。  検証コールバックのパラメーターは、検証対象のプロパティが設定されている特定の <xref:System.Windows.DependencyObject> を通知しません。  したがって、検証コールバックを使用して、プロパティ値に影響を及ぼす可能性がある "依存関係" \(インスタンス固有のプロパティ値が他のインスタンス固有のプロパティ値や実行時の状態などの要因に依存する関係\) を強制することはできません。  
+  
+ 非常に簡単な検証コールバック シナリオのコード例を次に示します。この例では、<xref:System.Double> プリミティブ型として型指定されているプロパティが <xref:System.Double.PositiveInfinity> または <xref:System.Double.NegativeInfinity> でないことを検証します。  
+  
+ [!code-csharp[DPCallbackOverride#ValidateValueCallback](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DPCallbackOverride/CSharp/SDKSampleLibrary/class1.cs#validatevaluecallback)]
+ [!code-vb[DPCallbackOverride#ValidateValueCallback](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DPCallbackOverride/visualbasic/sdksamplelibrary/class1.vb#validatevaluecallback)]  
+  
+<a name="Coerce_Value_Callbacks_and_Property_Changed_Events"></a>   
+## 強制値コールバックとプロパティ変更イベント  
+ 強制値コールバックは、依存関係プロパティの値が変更されるたびにプロパティ システムによって呼び出される <xref:System.Windows.PropertyChangedCallback> 実装と同様に、プロパティの特定の <xref:System.Windows.DependencyObject> インスタンスを渡します。  これら 2 つのコールバックを組み合わせて使用すると、あるプロパティが変更されたときに他のプロパティに自動的に強制または再評価が適用される一連のプロパティを要素に作成することができます。  
+  
+ 依存関係プロパティ間の関連は、最小値、最大値、および実際の値 \(または現在の値\) を表す 3 つのプロパティが要素に含まれる場合において、ユーザー インターフェイス ドリブン プロパティがあるときによく使用されます。  ここで、最大値が現在の値より小さい値に調整された場合、現在の値を新しい最大値以下の値に強制する必要があります。現在の値と最小値についても同様の関係が成り立ちます。  
+  
+ 次の、3 つの依存関係プロパティの 1 つを示す非常に簡単なコード例は、こうした関係を表しています。  この例は、3 つの関連する Reading プロパティ \(Min、Max、Current\) のうちの 1 つである `CurrentReading` プロパティの登録方法を示しています。  ここでは、前のセクションで説明した検証を使用しています。  
+  
+ [!code-csharp[DPCallbackOverride#CurrentDefinitionWithWrapper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DPCallbackOverride/CSharp/SDKSampleLibrary/class1.cs#currentdefinitionwithwrapper)]
+ [!code-vb[DPCallbackOverride#CurrentDefinitionWithWrapper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DPCallbackOverride/visualbasic/sdksamplelibrary/class1.vb#currentdefinitionwithwrapper)]  
+  
+ Current のプロパティ変更コールバックを使用して、他の依存関係プロパティに対して登録されている強制値コールバックを明示的に呼び出すことにより、変更を他のプロパティに伝播します。  
+  
+ [!code-csharp[DPCallbackOverride#OnPCCurrent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DPCallbackOverride/CSharp/SDKSampleLibrary/class1.cs#onpccurrent)]
+ [!code-vb[DPCallbackOverride#OnPCCurrent](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DPCallbackOverride/visualbasic/sdksamplelibrary/class1.vb#onpccurrent)]  
+  
+ 強制値コールバックは、Current プロパティが依存している可能性があるプロパティの値を検証し、必要に応じて現在の値に強制を機能させます。  
+  
+ [!code-csharp[DPCallbackOverride#CoerceCurrent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DPCallbackOverride/CSharp/SDKSampleLibrary/class1.cs#coercecurrent)]
+ [!code-vb[DPCallbackOverride#CoerceCurrent](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DPCallbackOverride/visualbasic/sdksamplelibrary/class1.vb#coercecurrent)]  
+  
+> [!NOTE]
+>  プロパティの既定値は強制されません。  プロパティ値が初期既定値を保持している場合、または <xref:System.Windows.DependencyObject.ClearValue%2A> を使用して他の値を消去した場合、プロパティ値が既定値に等しくなる可能性があります。  
+  
+ 強制値コールバックとプロパティ変更コールバックはプロパティ メタデータの一部です。  したがって、特定の依存関係プロパティを所有する型から派生させた型に存在するその特定の依存関係プロパティのコールバックは、派生させた型でプロパティのメタデータをオーバーライドすることで変更できます。  
+  
+<a name="Advanced"></a>   
+## 高度な強制とコールバック シナリオ  
+  
+### 制約と目的の値  
+ プロパティ システムは、<xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> コールバックを使用して、開発者が宣言したロジックに従って値に強制を機能させます。ただし、ローカルに設定されたプロパティの、強制が機能している値は、"目的の値" を内部で保持します。  制約がアプリケーションの有効期間内に動的に変更される可能性があるプロパティ値に基づいている場合、強制の制約も動的に変更されます。そして、制約されているプロパティは、指定された新しい制約の下で、その値を目的の値にできる限り近づけることができます。  制約がすべて解除された場合、値は目的の値になります。  相互に循環的に依存する複数のプロパティを使用している場合、非常に複雑な依存関係シナリオを導入することができます。  たとえば、Min\/Max\/Current シナリオでは、Minimum と Maximum をユーザー設定可能なプロパティにすることができます。  その場合、Maximum が常に Minimum より大きくなり、Minimum が常に Maximum より小さくなるように強制しなければならないことがあります。  ただし、この強制を有効にし、Maximum が Minimum に強制された場合、Current が未設定の状態になります。なぜなら、Currenct は Maximum と Minimum の両方に依存し、両者の値の間の範囲内 \(この場合はゼロ\) に制約されるからです。  その後、Maximum または Minimum が調整された場合、Current はいずれかの値を "追跡" すると考えられます。なぜなら、Current の目的の値が依然として保持されており、制約が緩和されると Current が目的の値に到達しようとするからです。  
+  
+ 複雑な依存関係に関する技術的な問題はありません。ただし、多数の再評価が必要になる場合、パフォーマンスが若干低下することがあります。また、UI に直接影響する場合は、ユーザーの混乱につながることもあります。  プロパティ変更コールバックおよび強制値コールバックについては注意が必要です。試行中の強制ができる限り明確に処理されること、およびその制約が "過剰制約" ではないことを確認してください。  
+  
+### CoerceValue を使用した値変更の取り消し  
+ プロパティ システムは、<xref:System.Windows.DependencyProperty.UnsetValue> 値を返すすべての <xref:System.Windows.CoerceValueCallback> を特殊なケースとして処理します。  この特殊なケースは、<xref:System.Windows.CoerceValueCallback> 呼び出しの原因となったプロパティの変更がプロパティ システムによって拒否され、代わりにプロパティの直前の値がプロパティ システムによって報告されることを意味します。  このメカニズムは、非同期に開始されたプロパティの変更が現在のオブジェクトの状態に対して依然として有効であるかどうかをチェックし、有効でない場合はその変更を抑制する場合に役立ちます。  考えられるもう 1 つのシナリオとして、プロパティ値の決定におけるどの構成要素が報告されるプロパティ値を決定するかに応じて値を選択的に抑制することもできます。  これを行うには、コールバックで渡された <xref:System.Windows.DependencyProperty> とプロパティ識別子を <xref:System.Windows.DependencyPropertyHelper.GetValueSource%2A> への入力として使用し、次に <xref:System.Windows.ValueSource> を処理します。  
+  
+## 参照  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dependency-property-metadata.md b/docs/framework/wpf/advanced/dependency-property-metadata.md
new file mode 100644
index 00000000000..869477d6165
--- /dev/null
+++ b/docs/framework/wpf/advanced/dependency-property-metadata.md
@@ -0,0 +1,107 @@
+---
+title: "依存関係プロパティのメタデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "API, メタデータ"
+  - "依存関係プロパティ, メタデータ"
+  - "メタデータ, 依存関係プロパティ"
+  - "オーバーライド (メタデータを)"
+ms.assetid: d01ed009-b722-41bf-b82f-fe1a8cdc50dd
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 依存関係プロパティのメタデータ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] プロパティ システムには、リフレクションや一般的な [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] 特性から得られる以上の詳細なプロパティ情報を提供するメタデータ報告システムが含まれています。  [依存関係プロパティ](GTMT)のメタデータは、[依存関係プロパティ](GTMT)を定義するクラスで個別に割り当てることも、[依存関係プロパティ](GTMT)を別のクラスに追加する際に変更することもできます。また、[依存関係プロパティ](GTMT)をその定義元の基本クラスから継承するすべての派生クラスで明確にオーバーライドすることもできます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスの既存の依存関係プロパティの使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  このトピックの例に従うには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] について理解し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの作成方法に精通している必要があります。  
+  
+<a name="dp_metadata_contents"></a>   
+## 依存関係プロパティのメタデータの使用方法  
+ 依存関係プロパティのメタデータは、依存プロパティの特性を照会して調べることができるオブジェクトとして存在します。  また、プロパティ システムは、特定の依存関係プロパティを処理する際に、このメタデータに頻繁にアクセスします。  依存関係プロパティのメタデータ オブジェクトには、次のような情報が格納されます。  
+  
+-   依存関係プロパティの既定値 \(ローカル値、スタイル、継承などによってその他の依存関係プロパティ値が指定されない場合\)。  依存関係プロパティの値を割り当てる際の、既定値と、プロパティ システムで使用される優先順位の関係に関する詳細な説明については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+-   所有者型に基づく強制または変更通知の動作に影響を与えるコールバック実装への参照。  多くの場合、これらのコールバックは非パブリックなアクセス レベルで定義されます。したがって、参照が、許可されたアクセス スコープ内にない限り、一般にメタデータから実際の参照を取得することはできません。  依存関係プロパティのコールバックの詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  
+  
+-   対象の依存関係プロパティが [WPF フレームワーク レベル](GTMT)のプロパティと見なされる場合、[WPF フレームワーク レベル](GTMT)の依存関係プロパティ特性がメタデータに含まれる可能性があります。これは、[WPF フレームワーク レベル](GTMT)のレイアウト エンジンやプロパティ継承ロジックなどのサービスの情報および状態を報告します。  この内容に関する依存関係プロパティのメタデータの詳細については、「[フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)」を参照してください。  
+  
+<a name="APIs"></a>   
+## メタデータ API  
+ プロパティ システムで使用されるほとんどのメタデータ情報を報告する型は <xref:System.Windows.PropertyMetadata> クラスです。  メタデータ インスタンスは、依存関係プロパティをプロパティ システムに登録する際に必要に応じて指定されます。それ自体を所有者として追加する追加の型、または基本クラスの依存関係プロパティ定義から継承したメタデータをオーバーライドする追加の型に再度指定することもできます   \(プロパティ登録でメタデータが指定されない場合は、そのクラスの既定値を使用して既定の <xref:System.Windows.PropertyMetadata> が作成されます\)。<xref:System.Windows.DependencyObject> インスタンスの依存関係プロパティからメタデータを取得するさまざまな <xref:System.Windows.DependencyProperty.GetMetadata%2A> オーバーロードを呼び出すと、登録されているメタデータが <xref:System.Windows.PropertyMetadata> として返されます。  
+  
+ <xref:System.Windows.PropertyMetadata> クラスは、[WPF フレームワーク レベル](GTMT) クラスなどのアーキテクチャ区分に対してより具体的なメタデータを提供するために派生されます。  <xref:System.Windows.UIPropertyMetadata> は、アニメーション報告を追加し、<xref:System.Windows.FrameworkPropertyMetadata> は、前のセクションで説明した [WPF フレームワーク レベル](GTMT) プロパティを提供します。  依存関係プロパティを登録すると、これらの <xref:System.Windows.PropertyMetadata> 派生クラスにその依存関係プロパティを登録できるようになります。  メタデータを検査すると、基本 <xref:System.Windows.PropertyMetadata> 型が派生クラスにキャストされる場合があります。これにより、より具体的な情報プロパティを検査することができます。  
+  
+> [!NOTE]
+>  このドキュメントでは、<xref:System.Windows.FrameworkPropertyMetadata> で指定できるプロパティ特性を "フラグ" と呼ぶことがあります。  依存関係プロパティの登録やメタデータのオーバーライドで使用するメタデータ インスタンスを新しく作成する場合、フラグ列挙体である <xref:System.Windows.FrameworkPropertyMetadataOptions> を使用してこれらの値を指定し、この列挙体の値 \(連結された値である可能性があります\) を <xref:System.Windows.FrameworkPropertyMetadata> コンストラクターに渡します。  ただし、メタデータが構築されると、これらのオプション特性は、構築元の列挙値ではなく、一連のブール型プロパティとして <xref:System.Windows.FrameworkPropertyMetadata> 内で公開されます。  これらのブール型プロパティを使用すると、目的の情報を取得するためにフラグ列挙値に対してマスクを適用することなく、各条件をチェックすることができます。  コンストラクターは、コンストラクター シグネチャを適切な長さに保つために、連結された <xref:System.Windows.FrameworkPropertyMetadataOptions> を使用します。一方、実際に構築されたメタデータは、より直感的な方法でメタデータを照会できるようにするために、プロパティを個別に公開します。  
+  
+<a name="override_or_subclass"></a>   
+## メタデータをオーバーライドする場合、クラスを派生する場合  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムには、依存関係プロパティを完全に再実装することなく、依存関係プロパティの一部の特性を変更するための機能が用意されています。  これは、特定の型に存在する依存関係プロパティについて、そのプロパティ メタデータの別のインスタンスを構築することで実現されます。  既存の依存関係プロパティの大部分は仮想プロパティではありません。したがって、厳密には、継承クラスでの依存関係プロパティの "再実装" は、既存のメンバーをシャドウすることによってのみ実現されます。  
+  
+ 型の依存関係プロパティに対して有効にしようとしているシナリオが、既存の依存関係プロパティの特性の変更では実現できない場合、派生クラスを作成し、その派生クラスでカスタム依存関係プロパティを宣言することが必要になる場合があります。  カスタム依存関係プロパティは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] で定義されている依存関係プロパティとまったく同じように動作します。  カスタム依存関係プロパティの詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+ オーバーライドすることができない依存関係プロパティの代表的な特性の 1 つは、依存関係プロパティの値型です。  目的の動作にほぼ合致する依存関係プロパティを継承していても、その依存関係プロパティに別の型が必要な場合には、カスタム依存関係プロパティを実装し、型変換またはカスタム クラスのその他の実装を通じてプロパティをリンクする必要があります。  また、既存の <xref:System.Windows.ValidateValueCallback> を置換することはできません。このコールバックが、そのメタデータ内ではなく、登録フィールド自体に存在するためです。  
+  
+<a name="scenarios"></a>   
+## 既存のメタデータを変更するシナリオ  
+ 既存の依存関係プロパティのメタデータを使用している場合、依存関係プロパティのメタデータを変更する一般的なシナリオの 1 つは、既定値を変更することです。  プロパティ システム コールバックの変更または追加は、より高度なシナリオです。  依存関係プロパティ間の異なる相互関係が派生クラスの実装に含まれている場合は、プロパティ システム コールバックの変更または追加が必要になることがあります。  コードと宣言的な使用方法の両方をサポートするプログラミング モデルを使用する条件の 1 つとして、プロパティを任意の順序で設定できる必要があります。  したがって、依存関係プロパティはすべて、コンテキストを使用せずにジャスト イン タイムで設定する必要があります。また、設定順序 \(コンストラクター内の順序など\) に依存することもできません。  この内容に関するプロパティ システムの詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  検証コールバックは、メタデータの一部ではなく、依存関係プロパティ識別子の一部であることに注意してください。  したがって、検証コールバックは、メタデータのオーバーライドでは変更できません。  
+  
+ 既存の依存関係プロパティに対して、[WPF フレームワーク レベル](GTMT)のプロパティのメタデータ オプションの変更が必要になる場合があります。  これらのオプションは、[WPF フレームワーク レベル](GTMT)のプロパティに関する特定の既知の条件を、レイアウト システムなどの他の [WPF フレームワーク レベル](GTMT)のプロセスに伝達します。  通常、これらのオプションを設定するのは、新しい依存関係プロパティを登録するときだけです。ただし、<xref:System.Windows.DependencyProperty.OverrideMetadata%2A> 呼び出しまたは <xref:System.Windows.DependencyProperty.AddOwner%2A> 呼び出しの一部として [WPF フレームワーク レベル](GTMT)のプロパティのメタデータを変更することもできます。  使用する具体的な値および詳細については、「[フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)」を参照してください。  新しく登録した依存関係プロパティに対してこれらのオプションを設定する方法の詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+<a name="dp_override_metadata"></a>   
+### メタデータのオーバーライド  
+ メタデータのオーバーライドの主な目的は、型に存在する依存関係プロパティに適用される、メタデータから派生したさまざまな動作を変更できるようにすることです。  この理由については、「[メタデータ](#dp_metadata_contents)」セクションで詳しく説明します。  コード例を含む詳細については、「[依存関係プロパティのメタデータをオーバーライドする](../../../../docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md)」を参照してください。  
+  
+ プロパティのメタデータは、登録 \(<xref:System.Windows.DependencyProperty.Register%2A>\) の呼び出し時に依存関係プロパティに対して指定できます。  ただし、多くの場合、その依存関係プロパティを継承するクラスに対して、型固有のメタデータを提供する必要があります。  これを行うには、<xref:System.Windows.DependencyProperty.OverrideMetadata%2A> メソッドを呼び出します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の例では、<xref:System.Windows.UIElement.Focusable%2A> 依存関係プロパティを最初に登録する型は <xref:System.Windows.FrameworkElement> クラスです。  ただし、<xref:System.Windows.Controls.Control> クラスは、この依存関係プロパティのメタデータをオーバーライドし、それ自体の初期既定値を `false` から `true` に変更して提供します。オーバーライドしない場合は、元の <xref:System.Windows.UIElement.Focusable%2A> 実装を再利用します。  
+  
+ メタデータをオーバーライドすると、さまざまなメタデータ特性がマージされるか置き換えられます。  
+  
+-   <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> はマージされます。  新しい <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> を追加すると、そのコールバックがメタデータに格納されます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。  
+  
+-   <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> の実際のプロパティ システム動作では、階層内のすべてのメタデータ所有者用の実装が維持されてテーブルに追加されます。プロパティ システムによる実行順序としては、派生回数の最も多いクラスのコールバックが最初に呼び出されます。  
+  
+-   <xref:System.Windows.PropertyMetadata.DefaultValue%2A> は置き換えられます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.DefaultValue%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.DefaultValue%2A> の値は、メタデータでそれを指定した最も近い先祖によって決まります。  
+  
+-   <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> 実装は置き換えられます。  新しい <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> を追加すると、そのコールバックがメタデータに格納されます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。  
+  
+-   プロパティ システム動作では、直接のメタデータ内の <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> だけが呼び出されます。  階層内の他の <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> 実装への参照は行われません。  
+  
+ この動作は <xref:System.Windows.PropertyMetadata.Merge%2A> によって実装され、派生メタデータ クラス上でオーバーライドできます。  
+  
+#### 添付プロパティのメタデータのオーバーライド  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、[添付プロパティ](GTMT)は依存関係プロパティとして実装されます。  このことは、添付プロパティもプロパティ メタデータを持ち、これを個々のクラスでオーバーライドできることを意味します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付プロパティのスコープでは、通常、任意の <xref:System.Windows.DependencyObject> に、添付プロパティを設定できます。  したがって、クラスのインスタンスで設定されている場合、<xref:System.Windows.DependencyObject> 派生クラスは添付プロパティのメタデータをオーバーライドできます。  オーバーライドできるのは、既定値、コールバック、または [WPF フレームワーク レベル](GTMT)の特性報告プロパティです。  添付プロパティがクラスのインスタンスで設定されている場合、そのオーバーライド プロパティ メタデータ特性が適用されます。  たとえば、プロパティが他では特に指定されていないときには、オーバーライド値がクラスのインスタンス上の添付プロパティの値として報告されるように、既定値をオーバーライドできます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.FrameworkPropertyMetadata.Inherits%2A> プロパティは、添付プロパティに関係しません。  
+  
+<a name="dp_add_owner"></a>   
+### 既存の依存関係プロパティの所有者としてのクラスの追加  
+ クラスは、<xref:System.Windows.DependencyProperty.AddOwner%2A> メソッドを使用することで、それ自体を登録済みの依存関係プロパティの所有者として追加できます。  これにより、当初は別の型に対して登録された依存関係プロパティをクラスで使用できるようになります。  通常、追加するクラスは、所有者としてその依存関係プロパティを最初に登録した型の派生クラスではありません。  これにより、元の所有者クラスと追加するクラスが同一のクラス階層内にない場合でも、クラスとその派生クラスで[依存関係プロパティ](GTMT)の実装を "継承" することが事実上可能になります。  また、追加するクラスとすべての派生クラスでは、型固有のメタデータを元の依存関係プロパティに提供することができます。  
+  
+ 追加するクラスは、プロパティ システムのユーティリティ メソッドを介してそれ自体を所有者として追加するだけでなく、追加のパブリック メンバーをそれ自体で宣言する必要があります。これは、[依存関係プロパティ](GTMT)を完全な形でプロパティ システムに登録し、コードとマークアップの両方に対して公開するためです。  既存の依存関係プロパティを追加するクラスは、その依存関係プロパティのオブジェクト モデルを公開する限り、新しいカスタム依存関係プロパティを定義するクラスと同様の役割を負います。  これらのメンバーの中で最初に公開するのは、依存関係プロパティの識別子フィールドです。  このフィールドは、<xref:System.Windows.DependencyProperty.AddOwner%2A> 呼び出しの戻り値に割り当てられる、<xref:System.Windows.DependencyProperty> 型の `public static readonly` フィールドである必要があります。  2 番目に定義するメンバーは、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] の "ラッパー" プロパティです。  ラッパーを使用すると、コード内での依存関係プロパティの操作がずっと簡単になります \(<xref:System.Windows.DependencyObject.SetValue%2A> を毎回呼び出す必要がなくなり、ラッパー内で 1 回呼び出すだけで済むようになります\)。  このラッパーの実装方法は、カスタム[依存関係プロパティ](GTMT)を登録する場合の実装方法とまったく同じです。  [依存関係プロパティ](GTMT)の実装の詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」および「[依存関係プロパティの所有者の種類を追加する](../../../../docs/framework/wpf/advanced/how-to-add-an-owner-type-for-a-dependency-property.md)」を参照してください。  
+  
+#### AddOwner および添付プロパティ  
+ 所有者クラスで添付プロパティとして定義されている依存関係プロパティに対して、<xref:System.Windows.DependencyProperty.AddOwner%2A> を呼び出すことができます。  通常、これは、以前の添付プロパティを非添付の依存関係プロパティとして公開する目的で行います。  次に、<xref:System.Windows.DependencyProperty.AddOwner%2A> の戻り値を、依存関係プロパティの識別子として使用される `public static readonly` フィールドとして公開し、プロパティがメンバー テーブルに表示され、クラス内で非添付プロパティを使用できるように、適切な "ラッパー" プロパティを定義します。  
+  
+## 参照  
+ <xref:System.Windows.PropertyMetadata>   
+ <xref:System.Windows.DependencyObject>   
+ <xref:System.Windows.DependencyProperty>   
+ <xref:System.Windows.DependencyProperty.GetMetadata%2A>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dependency-property-security.md b/docs/framework/wpf/advanced/dependency-property-security.md
new file mode 100644
index 00000000000..b97c20d8220
--- /dev/null
+++ b/docs/framework/wpf/advanced/dependency-property-security.md
@@ -0,0 +1,51 @@
+---
+title: "依存関係プロパティのセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係プロパティ, access"
+  - "依存関係プロパティ, セキュリティ"
+  - "セキュリティ, 依存関係プロパティ"
+  - "セキュリティ, ラッパー"
+  - "検証, 依存関係プロパティ"
+  - "ラッパー, access"
+  - "ラッパー, セキュリティ"
+ms.assetid: d10150ec-90c5-4571-8d35-84bafa2429a4
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 依存関係プロパティのセキュリティ
+依存関係プロパティは一般に、パブリック プロパティと見なす必要があります。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] プロパティ システムの性質上、依存関係プロパティ値については、セキュリティは保証されません。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="AccessSecurity"></a>   
+## ラッパーと依存関係プロパティのアクセスとセキュリティ  
+ 通常、依存関係プロパティは、インスタンスのプロパティの取得や設定を簡素化する "ラッパー" [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティと共に実装されます。  ただし、ラッパーは、依存関係プロパティと対話する場合に使用される基になる <xref:System.Windows.DependencyObject.GetValue%2A> および <xref:System.Windows.DependencyObject.SetValue%2A> の各静的呼び出しを実装する便利な方法です。  別な観点で考えると、プロパティは、プライベート フィールドではなく依存関係プロパティによって偶然にサポートされている[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティとして公開されています。  ラッパーに適用されるセキュリティ機構は、基になる依存関係プロパティに関するプロパティ システムの動作およびアクセスと同等ではありません。  ラッパーに対してセキュリティを要求しても、この便利な方法が使用できなくなるだけで、<xref:System.Windows.DependencyObject.GetValue%2A> や <xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しは阻止されません。  同様に、ラッパーに保護またはプライベート アクセス レベルを設定しても、効果的なセキュリティは実現されません。  
+  
+ 独自の依存関係プロパティを記述する場合は、ラッパーと <xref:System.Windows.DependencyProperty> 識別子フィールドをパブリック メンバーとして宣言する必要があります。そうすることで、呼び出し元がそのプロパティの実際のアクセス レベルに関する、誤りの原因となる情報を取得することを防止できます \(そのストアが依存関係プロパティとして実装されているため\)。  
+  
+ カスタム依存関係プロパティの場合、そのプロパティを読み取り専用の依存関係プロパティとして登録できます。これは、そのプロパティの <xref:System.Windows.DependencyPropertyKey> への参照を保持していなくてもだれでもプロパティを設定できるのを防ぐ有効な手段となります。  詳細については、「[読み取り専用の依存関係プロパティ](../../../../docs/framework/wpf/advanced/read-only-dependency-properties.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.DependencyProperty> 識別子フィールドをプライベートとして宣言することは、禁止されていないだけでなく、カスタム クラスの直接公開名前空間を減らすのに役立つ可能性もあります。ただし、このようなプロパティは、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] 言語定義と同じ意味で "プライベート" であると見なすことはできません。その理由は次のセクションで説明します。  
+  
+<a name="PropertySystemExposure"></a>   
+## 依存関係プロパティのプロパティ システムによる公開  
+ <xref:System.Windows.DependencyProperty> をパブリック以外のアクセス レベルとして宣言することは、一般的には役に立たず、誤りの原因となる可能性もあります。  このようなアクセス レベル設定を行っても、宣言しているクラスからインスタンスへの参照を取得できなくなるだけです。  しかしプロパティ システムには、クラスのインスタンスや派生クラスのインスタンスに存在する特定のプロパティを識別する手段として <xref:System.Windows.DependencyProperty> を返すいくつかの局面があり、この識別子は、元の静的識別子がパブリック以外として宣言されていた場合でも、<xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しで使用できます。  また、<xref:System.Windows.DependencyObject.OnPropertyChanged%2A> 仮想メソッドは、値が変更された既存の依存関係プロパティに関する情報を受け取ります。  さらに、<xref:System.Windows.DependencyObject.GetLocalValueEnumerator%2A> メソッドは、値がローカルに設定されたインスタンスのプロパティに関する識別子を返します。  
+  
+### 検証とセキュリティ  
+ <xref:System.Windows.DependencyProperty.ValidateValueCallback%2A> に対して要求を発行し、要求エラーの発生時に検証エラーでプロパティの設定を回避する方法は、十分なセキュリティ機構ではありません。  <xref:System.Windows.DependencyProperty.ValidateValueCallback%2A> による設定値の無効化も、悪意のある呼び出し元がアプリケーション ドメイン内で動作している場合には、これらの呼び出し元によって抑制される可能性があります。  
+  
+## 参照  
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dependency-property-value-precedence.md b/docs/framework/wpf/advanced/dependency-property-value-precedence.md
new file mode 100644
index 00000000000..0ca2cfb7ed8
--- /dev/null
+++ b/docs/framework/wpf/advanced/dependency-property-value-precedence.md
@@ -0,0 +1,142 @@
+---
+title: "依存関係プロパティ値の優先順位 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, 所有者 (依存関係プロパティの)"
+  - "依存関係プロパティ, クラス (所有者としての)"
+  - "依存関係プロパティ, メタデータ"
+  - "メタデータ, 依存関係プロパティ"
+ms.assetid: 1fbada8e-4867-4ed1-8d97-62c07dad7ebc
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# 依存関係プロパティ値の優先順位
+<a name="introduction"></a> ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] プロパティ システムの機能が[依存関係プロパティ](GTMT)の値にどのように影響する可能性があるかについて説明し、プロパティ システムの側面がプロパティの有効値に適用される際の優先順位を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラスの既存の依存関係プロパティの使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  このトピックの例を実行するには、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] について理解し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの記述に精通している必要があります。  
+  
+<a name="intro"></a>   
+## WPF プロパティ システム  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムは、依存関係プロパティの値をさまざまな要素に基づいて決定するための強力な方法を提供し、リアルタイムのプロパティ検証や遅延バイディングなどの機能を実現すると共に、関連するプロパティに他のプロパティの値の変更について通知します。  依存関係プロパティの値を決定するために使用される厳密な順序とロジックは、かなり複雑です。  この順序を理解することにより、不必要なプロパティ設定を回避できると同時に、依存関係プロパティ値を変更または取得する操作を行ったにもかかわらず最終的に想定どおりの値が設定されなかった場合、その原因を究明できます。  
+  
+<a name="multiple_sets"></a>   
+## 複数の場所に "設定" 可能な依存関係プロパティ  
+ 1 つのプロパティ \(<xref:System.Windows.Controls.Control.Background%2A>\) に、値に影響を与える可能性がある 3 つの異なる "設定" 操作がある場合の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 例を次に示します。  
+  
+ [!code-xml[PropertiesOvwSupport#DPPrecedence](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page4.xaml#dpprecedence)]  
+  
+ ここでは、赤色、緑色、青色のうち、どの色が適用されるかを考えます。  
+  
+ アニメーション化された値および強制を除き、ローカルのプロパティ セットが最も高い優先順位で設定されます。  任意のスタイルまたはコントロール テンプレートの上に設定した場合でも、ローカルに値を設定すると、この値が適用されると想定できます。  この例では、<xref:System.Windows.Controls.Control.Background%2A> が Red としてローカルに設定されています。  したがって、このスコープ内で定義されるスタイルは、これ以外の場合にはそのスコープ内のその型のすべての要素に適用される暗黙のスタイルであっても、<xref:System.Windows.Controls.Control.Background%2A> プロパティに値を指定する際には最高の優先順位を持ちません。  Button インスタンスから Red のローカル値を削除した場合は、スタイルが優先され、ボタンはスタイルから Background 値を取得します。  スタイル内ではトリガーが優先されるため、マウスが置かれるとボタンは青色になり、それ以外の場合は緑色になります。  
+  
+<a name="listing"></a>   
+## 依存関係プロパティ設定の優先順位リスト  
+ 依存関係プロパティのランタイム値を割り当てる際に、最終的にプロパティ システムで使用される順序を次に示します。  優先順位の高いものから順に示します。  このリストは、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」で取り上げた一般化を一部拡張したものです。  
+  
+1.  **プロパティ システムの強制型変換。**強制型変換の詳細については、このトピックの「[強制型変換、アニメーション、および基本値](#animations)」を参照してください。  
+  
+2.  **アクティブなアニメーション、または Hold 動作を使用したアニメーション。**実際的な効果を持たせるためには、プロパティのアニメーションは値がローカルに設定されている場合でも、その基本 \(アニメーション化されていない\) 値よりも優先される必要があります。  詳細については、このトピックの「[強制型変換、アニメーション、および基本値](#animations)」を参照してください。  
+  
+3.  **ローカル値。**ローカル値は "ラッパー" プロパティの利点を利用して設定できます。これは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]内で属性またはプロパティ要素として設定することと同じです。また、特定のインスタンスのプロパティを使用して <xref:System.Windows.DependencyObject.SetValue%2A> [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] を呼び出すことによって設定することもできます。  バインディングまたはリソースを使用してローカル値を設定すると、優先順位に関しては値を直接設定した場合と同じように扱われます。  
+  
+4.  **TemplatedParent テンプレート プロパティ。**テンプレート \(<xref:System.Windows.Controls.ControlTemplate> または <xref:System.Windows.DataTemplate>\) の一部として作成された要素には、<xref:System.Windows.FrameworkElement.TemplatedParent%2A> が含まれます。  これが当てはまる状況については、このトピックの「[TemplatedParent](#templatedparent)」を参照してください。  テンプレート内では、次の優先順位が適用されます。  
+  
+    1.  <xref:System.Windows.FrameworkElement.TemplatedParent%2A> テンプレートからのトリガー。  
+  
+    2.  <xref:System.Windows.FrameworkElement.TemplatedParent%2A> テンプレート内のプロパティ セット \(通常は [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 属性によって提供される\)。  
+  
+5.  **暗黙のスタイル。** `Style` プロパティにだけ適用されます。  `Style` プロパティには、その要素の種類に一致するキーを持つスタイル リソースが設定されます。  このスタイル リソースは、ページまたはアプリケーション内に存在する必要があります。暗黙のスタイル リソースの検索はテーマまで進行しません。  
+  
+6.  **スタイルのトリガー。**ページまたはアプリケーションからのスタイル内トリガー \(スタイルは明示または暗黙のスタイルですが、優先順位の低い既定のスタイルではありません\)。  
+  
+7.  **テンプレートのトリガー。**スタイル内のテンプレートの任意のトリガー、または直接適用されたテンプレート。  
+  
+8.  **スタイルの setter。**ページまたはアプリケーションからのスタイル内 <xref:System.Windows.Setter> の値。  
+  
+9. **既定の \(テーマ\) スタイル。**これが適用される状況とテーマ スタイル内でのテーマ スタイルとテンプレートの関連付けの詳細については、このトピックの「[既定の \(テーマ\) スタイル](#themestyles)」を参照してください。  既定のスタイル内では、次の優先順位が適用されます。  
+  
+    1.  テーマ スタイル内のアクティブなトリガー。  
+  
+    2.  テーマ スタイル内の setter。  
+  
+10. **継承。**いくつかの依存関係プロパティは、アプリケーション全体で各要素に明確に設定しなくて済むように、親要素から子要素に値が継承されます。  詳細については、[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md) を参照してください。  
+  
+11. **依存関係プロパティのメタデータの既定値。**依存関係プロパティは、その特定のプロパティのプロパティ システム登録によって設定された既定値を持つ場合があります。  また、依存関係プロパティを継承する派生クラスは、型ごとにそのメタデータ \(既定値を含む\) をオーバーライドすることができます。  詳細については、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  継承されたプロパティについては、既定値の前に継承がチェックされるため、親要素の既定値が子要素よりも優先されます。  このため、継承可能なプロパティがどこにも設定されていない場合は、子要素の既定値の代わりにルートまたは親に指定された既定値が使用されます。  
+  
+<a name="templatedparent"></a>   
+## TemplatedParent  
+ 優先順位項目としての TemplatedParent は、標準のアプリケーション マークアップに直接宣言した要素のプロパティには適用されません。  TemplatedParent の概念は、テンプレートのアプリケーションを通じて成立するビジュアル ツリー内の下位項目に対してのみ存在します。  プロパティ システムが値の <xref:System.Windows.FrameworkElement.TemplatedParent%2A> テンプレートを検索する場合は、その要素を作成したテンプレートが検索されます。  一般に、<xref:System.Windows.FrameworkElement.TemplatedParent%2A> テンプレートのプロパティ値は、下位要素のローカル値として設定されている場合と同様に機能します。ただし、テンプレートは共有されている可能性があるため、優先順位はローカル値よりも下位である必要があります。  詳細については、「<xref:System.Windows.FrameworkElement.TemplatedParent%2A>」を参照してください。  
+  
+<a name="style_property"></a>   
+## Style プロパティ  
+ 前に説明した検索の順序は、<xref:System.Windows.FrameworkElement.Style%2A> プロパティを除く、存在するすべての依存関係プロパティに適用されます。  <xref:System.Windows.FrameworkElement.Style%2A> プロパティは、それ自体のスタイルを設定できないという特異なプロパティであるため、優先順位の項目 5 ～ 8 は適用されません。  また、<xref:System.Windows.FrameworkElement.Style%2A> のアニメーションまたは強制型変換は推奨されません \(<xref:System.Windows.FrameworkElement.Style%2A> のアニメーションにはカスタムのアニメーション クラスが必要になります\)。  <xref:System.Windows.FrameworkElement.Style%2A> プロパティを設定する方法として、残されたのは次の 3 つです。  
+  
+-   **明示的なスタイル。** <xref:System.Windows.FrameworkElement.Style%2A> プロパティを直接設定します。  ほとんどのシナリオでは、スタイルをインラインで定義するのではなくリソースとして明示的なキーにより参照します。  この場合、Style プロパティ自体はローカル値であるかのように動作します \(優先順位の項目 3\)。  
+  
+-   **暗黙のスタイル。** <xref:System.Windows.FrameworkElement.Style%2A> プロパティを直接設定しません。  ただし、<xref:System.Windows.FrameworkElement.Style%2A> はリソース検索シーケンスのどれかのレベル \(ページ、アプリケーション\) に存在し、適用対象のスタイルの種類に一致するリソース キーによりキーが設定されます。  この場合、<xref:System.Windows.FrameworkElement.Style%2A> プロパティ自体はシーケンス内で優先順位の項目 5 となるように動作します。  この情報は、<xref:System.Windows.FrameworkElement.Style%2A> プロパティに <xref:System.Windows.DependencyPropertyHelper> を使用し、その結果で <xref:System.Windows.BaseValueSource> を検索することによって確認できます。  
+  
+-   **既定のスタイル** \(別名**テーマ スタイル**\)。<xref:System.Windows.FrameworkElement.Style%2A> プロパティは直接設定しません。実行時までは、プロパティを読み取ると `null` が返されます。  この方法では、スタイルは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プレゼンテーション エンジンの一部である実行時テーマ評価処理によって生成されます。  
+  
+ テーマ内にない暗黙のスタイルの場合、型は正確に一致する必要があります。たとえば、`Button` 派生クラス `MyButton` では、`Button` のスタイルは暗黙的には使用されません。  
+  
+<a name="themestyles"></a>   
+## 既定の \(テーマ\) スタイル。  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属するコントロールには既定のスタイルがあります。  既定のスタイルはテーマによって異なる可能性があります。既定のスタイルがテーマ スタイルとも呼ばれるのは、このような理由があるためです。  
+  
+ コントロールの既定のスタイルに含まれる最も重要な情報は、コントロール テンプレートです。このテンプレートは、テーマ スタイルでは <xref:System.Windows.Controls.Control.Template%2A> プロパティの setter として存在します。  既定のスタイルにテンプレートがなかったとしたら、カスタム スタイルの一部としてカスタム テンプレートを持たないコントロールは、表示形式をまったく持たないことになります。  既定のスタイルのテンプレートによって、コントロールの表示形式に基本構造が与えられ、テンプレートのビジュアル ツリーに定義されたプロパティとそれに対応するコントロール クラスが適切に接続されます。  コントロールからは、テンプレートを完全に置き換えなくてもコントロールの表示形式を変更できる一連のプロパティが提供されます。  たとえば、<xref:System.Windows.Controls.Primitives.Thumb> コントロールの既定の表示形式を例として説明します。このコントロールは、<xref:System.Windows.Controls.Primitives.ScrollBar> のコンポーネントです。  
+  
+ <xref:System.Windows.Controls.Primitives.Thumb> は、特定のカスタマイズしたプロパティを持ちます。  <xref:System.Windows.Controls.Primitives.Thumb> の既定のテンプレートによって、傾斜して表示されるいくつかの入れ子になった <xref:System.Windows.Controls.Border> コンポーネントから成る基本構造とビジュアル ツリーが作成されます。  テンプレートの一部であるプロパティを <xref:System.Windows.Controls.Primitives.Thumb> クラスによってカスタマイズされることを意図して公開する場合は、テンプレート内で [TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) を使用してそのプロパティを公開する必要があります。  <xref:System.Windows.Controls.Primitives.Thumb> では、これらの境界のさまざまなプロパティは <xref:System.Windows.Controls.Border.Background%2A> や <xref:System.Windows.Controls.Border.BorderThickness%2A> などのプロパティへのテンプレート バインディングを共有します。  しかし、他の特定のプロパティやビジュアル配置は、コントロール テンプレート内にハードコーディングされるかテーマに直接設定された値にバインドされており、テンプレート全体を置き換えるには不十分であるため変更できません。  一般にプロパティが、テンプレート化されている親に由来し、テンプレート バインディングから公開されない場合、対象をこのプロパティに設定する簡単な方法がないため、スタイルを使用して調整することはできません。  しかし、このプロパティも、適用されるテンプレートのプロパティ値継承による、または既定値による影響を受けます。  
+  
+ テーマ スタイルの定義では、データ型がキーとして使用されます。  ただし、テーマを特定の要素インスタンスに適用すると、この型に対するテーマの検索は、コントロールの <xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> プロパティをチェックすることにより実行されます。  これは、暗黙のスタイルでリテラル型が使用されるのと対照的です。  <xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> の値は、実装側で変更されない場合でも派生クラスに継承されます \(プロパティを変更する方法として意図されているのは、プロパティ レベルでオーバーライドすることではなく、既定値をプロパティ メタデータで変更することです\)。  このような間接的な方法を使うことにより、基本クラスでは、他の方法ではスタイルを持つことがない \(さらに重要なことには、そのスタイル内にテンプレートを持たないため既定の表示形式をまったく持つことがない\) 派生要素にテーマ スタイルを定義できます。  そのため、`MyButton` を <xref:System.Windows.Controls.Button> から派生でき、さらに <xref:System.Windows.Controls.Button> 既定テンプレートを取得できます。  `MyButton` コントロールの作成者が別の動作を必要とする場合は、別のキーを返すよう <xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> の依存関係プロパティのメタデータを `MyButton` でオーバーライドし、`MyButton` コントロールにパッケージ化する必要がある `MyButton` 用テンプレートなどを関連テーマ スタイルに定義できます。  テーマ、スタイル、およびコントロールの作成の詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+<a name="resources"></a>   
+## 動的リソース参照とバインディング  
+ 動的リソース参照とバインディング操作では、設定された場所の優先順位が優先されます。  たとえば、ローカル値に適用される動的リソースは優先順位の項目 3 に準拠し、テーマ スタイル内のプロパティ setter のバインディングは優先順位の項目 9 で適用されます。  動的リソース参照とバインディングはどちらも、アプリケーションの実行時の状態から値を取得できる必要があります。このため、指定された任意のプロパティに対してプロパティ値の優先順位を決定する実際のプロセスは、実行時まで拡張されます。  
+  
+ 動的リソース参照は、厳密にはプロパティ システムの一部ではありませんが、前に述べた順序に関連する独自の検索順序を持ちます。  この優先順位の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  この優先順位は、簡単に要約すると、ページ ルート、アプリケーション、テーマ、システムに対する要素です。  
+  
+ 動的リソース参照とバインディング操作は設定された場所の優先順位を持ちますが、その値は遅延されます。  このため、動的リソースまたはバインディングをローカル値に設定した場合、このローカル値を変更すると動的バインディングまたはバインディング全体が完全に置き換えられます。  ローカルに設定された値を消去するために <xref:System.Windows.DependencyObject.ClearValue%2A> メソッドを呼び出した場合でも、動的リソースまたはバインディングは復元されません。  実際、動的リソースまたはバインディングが指定されたプロパティ \(リテラルのローカル値ではない\) で <xref:System.Windows.DependencyObject.ClearValue%2A> を呼び出した場合、これらもこの <xref:System.Windows.DependencyObject.ClearValue%2A> の呼び出しによって消去されます。  
+  
+<a name="setcurrentvalue"></a>   
+## SetCurrentValue  
+ <xref:System.Windows.DependencyObject.SetCurrentValue%2A> メソッドはプロパティを設定するためのもう 1 つの方法ですが、プロパティの設定は優先順位の順に行われません。  <xref:System.Windows.DependencyObject.SetCurrentValue%2A> を使用すると、前の値のソースを上書きすることなくプロパティ値を変更できます。  <xref:System.Windows.DependencyObject.SetCurrentValue%2A> は、ローカル値の優先順位を与えずに値を設定する場合にいつでも使用できます。  たとえば、トリガーによってプロパティが設定され、<xref:System.Windows.DependencyObject.SetCurrentValue%2A> を介してこのプロパティに別の値が割り当てられた場合、プロパティ システムはトリガーを考慮するため、トリガーのアクションが発生するとプロパティは変更されます。  <xref:System.Windows.DependencyObject.SetCurrentValue%2A> を使用すると、高い優先順位を持つソースを与えることなくプロパティ値を変更できます。  同様に、<xref:System.Windows.DependencyObject.SetCurrentValue%2A> を使用すると、バインディングを上書きすることなくプロパティ値を変更できます。  
+  
+<a name="animations"></a>   
+## 強制、アニメーション、および基本値  
+ 強制とアニメーションはどちらも、この [!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] 全体で "基本値" と呼ばれる値に基づいて機能します。  基本値は、項目 2 に達するまで項目を上方に評価することによって決定される値です。  
+  
+ アニメーションでは、特定の動作に "From" と "To" の両方を指定していない場合、またはアニメーションが完了すると基本値に戻るようにする場合に、基本値はアニメーション化される値に影響を与えます。  これを実際に確かめるには、[アニメーションのターゲット値 \(From、To、および By\) のサンプル](http://go.microsoft.com/fwlink/?LinkID=159988)を実行します。  ローカル値の初期値をアニメーション内の "From" とは異なる値にするために、例の中で四角形の高さを示すローカル値を設定してください。  アニメーションは "From" 値を使用して直ちに開始され、開始後にこの基本値を置き換えます。  アニメーションは、Stop <xref:System.Windows.Media.Animation.FillBehavior> を指定してアニメーションを完了した後、アニメーションの前に見つかった値に戻るように指定できます。  それ以降、基本値の決定には通常の優先順位が使用されます。  
+  
+ 1 つのプロパティに複数のアニメーションが適用され、アニメーションごとに値の優先順位に関する定義が異なる場合が考えられます。  この場合は、単に優先順位が高いアニメーションを適用するのではなく、アニメーションでそれらの値を組み合わせることがあります。  これは、アニメーションが実際にどのように定義されているか、およびアニメーション化される値の型によって異なります。  プロパティのアニメーション化の詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ 強制は、最高レベルで適用されます。  既に実行中のアニメーションでも、値の強制に制約されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内の既存の依存関係プロパティの中には、組み込みの強制を持つものがあります。  カスタム依存関係プロパティの場合は、プロパティの作成時に <xref:System.Windows.CoerceValueCallback> を記述し、メタデータの一部としてコールバックを渡すことにより、カスタム依存関係プロパティの強制動作を定義します。  また、派生クラス内のそのプロパティでメタデータをオーバーライドすることにより、既存のプロパティの強制動作をオーバーライドすることもできます。  強制の制約がその時点の制約として適用されるが基本値は引き続き保持されるという形で、強制は基本値と関係しています。  したがって、その後で強制の制約が解除されると、強制はその基本値に最も近い値を返し、制約がすべて解除された場合には、強制のプロパティへの影響は直ちになくなる可能性があります。  強制型変換の動作の詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  
+  
+<a name="triggers"></a>   
+## トリガー動作  
+ 多くの場合、コントロールは、トリガー動作をテーマ内の既定のスタイルの一部として定義します。  コントロールにローカル プロパティを設定すると、ユーザーによる表示上または動作上のイベントに対してトリガーが応答できなくなる場合があります。  プロパティ トリガーは、最も一般的には、コントロール プロパティや <xref:System.Windows.Controls.Primitives.Selector.IsSelected%2A> などの状態プロパティのために使用されます。  たとえば、既定で <xref:System.Windows.Controls.Button> が無効な場合 \(<xref:System.Windows.UIElement.IsEnabled%2A> のトリガーが `false` の場合\)、テーマ スタイル内の <xref:System.Windows.Controls.Control.Foreground%2A> 値によってコントロールは "灰色表示" されます。  ただし、ローカルの <xref:System.Windows.Controls.Control.Foreground%2A> 値を設定している場合は、プロパティがトリガーされるというこのシナリオでも、ローカル プロパティ セットが通常の灰色表示よりも優先されます。  テーマ レベルのトリガー動作が含まれるプロパティの値の設定は慎重に行い、そのコントロールで意図されるユーザー エクスペリエンスに過度に干渉しないようにしてください。  
+  
+<a name="clearvalue"></a>   
+## ClearValue および値の優先順位  
+ <xref:System.Windows.DependencyObject.ClearValue%2A> メソッドは、要素に設定される[依存関係プロパティ](GTMT)からローカルに適用された値を消去するのに役立つ方法を提供します。  ただし、<xref:System.Windows.DependencyObject.ClearValue%2A> を呼び出しても、プロパティの登録時にメタデータ内に設定された既定値が新しい有効値になることは保証されません。  値の優先順位に関係するその他すべての値は依然としてアクティブです。  ローカルに設定された値のみが、一連の優先順位から削除されています。  たとえば、テーマ スタイルによっても設定されているプロパティで <xref:System.Windows.DependencyObject.ClearValue%2A> を呼び出すと、テーマ値はメタデータに基づいた既定値ではなく新しい値として適用されます。  プロセスから関連するすべてのプロパティ値を取得して、登録されたメタデータの既定値に値を設定する場合は、依存関係プロパティのメタデータを照会することによって明確に既定値を取得でき、さらにこの既定値を使用し、<xref:System.Windows.DependencyObject.SetValue%2A> を呼び出してプロパティをローカルに設定できます。  
+  
+## 参照  
+ <xref:System.Windows.DependencyObject>   
+ <xref:System.Windows.DependencyProperty>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/digital-ink-how-to-topics.md b/docs/framework/wpf/advanced/digital-ink-how-to-topics.md
new file mode 100644
index 00000000000..d3212e17c78
--- /dev/null
+++ b/docs/framework/wpf/advanced/digital-ink-how-to-topics.md
@@ -0,0 +1,34 @@
+---
+title: "デジタル インクに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "デジタル インク"
+  - "インク, デジタル"
+ms.assetid: c29f8728-bfcb-4af7-9fbc-8169e180109f
+caps.latest.revision: 40
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# デジタル インクに関する「方法」トピック
+## このセクションの内容  
+ [カスタム コントロールからインクを選択する](../../../../docs/framework/wpf/advanced/how-to-select-ink-from-a-custom-control.md)  
+ [インク データにカスタム データを追加する](../../../../docs/framework/wpf/advanced/how-to-add-custom-data-to-ink-data.md)  
+ [カスタム コントロールでインクを消去する](../../../../docs/framework/wpf/advanced/how-to-erase-ink-on-a-custom-control.md)  
+ [アプリケーション ジェスチャを認識する](../../../../docs/framework/wpf/advanced/how-to-recognize-application-gestures.md)  
+ [インクをドラッグ アンド ドロップする](../../../../docs/framework/wpf/advanced/how-to-drag-and-drop-ink.md)  
+ [InkCanvas にデータをバインドする](../../../../docs/framework/wpf/advanced/how-to-data-bind-to-an-inkcanvas.md)  
+ [分析のヒントに従ってインクを分析する](../../../../docs/framework/wpf/advanced/how-to-analyze-ink-with-analysis-hints.md)  
+ [インクの回転](../../../../docs/framework/wpf/advanced/how-to-rotate-ink.md)  
+ [Journal ファイルを読み取る](../Topic/How%20to:%20Read%20a%20Journal%20File.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/digital-ink-overviews.md b/docs/framework/wpf/advanced/digital-ink-overviews.md
new file mode 100644
index 00000000000..74944582d0a
--- /dev/null
+++ b/docs/framework/wpf/advanced/digital-ink-overviews.md
@@ -0,0 +1,31 @@
+---
+title: "デジタル インクの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "デジタル インク"
+  - "インク, デジタル"
+ms.assetid: 5ddb23a6-7813-4058-b59d-29ff3341638c
+caps.latest.revision: 39
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 39
+---
+# デジタル インクの概要
+## このセクションの内容  
+ [インクの概要](../../../../docs/framework/wpf/advanced/getting-started-with-ink.md)  
+ [インクの収集](../../../../docs/framework/wpf/advanced/collecting-ink.md)  
+ [手書き認識](../../../../docs/framework/wpf/advanced/handwriting-recognition.md)  
+ [インクの格納](../../../../docs/framework/wpf/advanced/storing-ink.md)  
+ [インク オブジェクト モデル : Windows フォームおよび COM と WPF の比較](../../../../docs/framework/wpf/advanced/the-ink-object-model-windows-forms-and-com-versus-wpf.md)  
+ [高度なインク処理](../../../../docs/framework/wpf/advanced/advanced-ink-handling.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/digital-ink.md b/docs/framework/wpf/advanced/digital-ink.md
new file mode 100644
index 00000000000..74b82fce30a
--- /dev/null
+++ b/docs/framework/wpf/advanced/digital-ink.md
@@ -0,0 +1,32 @@
+---
+title: "デジタル インク | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "デジタル インク"
+  - "インク, デジタル"
+ms.assetid: d0d6df69-daf9-4cf3-b7f9-ffee588037a3
+caps.latest.revision: 39
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 39
+---
+# デジタル インク
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのデジタル インクの使用について説明します。  デジタル インクは、これまでは Tablet PC SDK のみに含まれていましたが、Windows Presentation Foundation の主要部分でも使用可能になりました。  そのため、Windows Presentation Foundation の機能を使用して、本格的な Tablet PC アプリケーションの開発が可能になりました。  
+  
+## このセクションの内容  
+ [概要](../../../../docs/framework/wpf/advanced/digital-ink-overviews.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/digital-ink-how-to-topics.md)  
+  
+## 関連項目  
+ [Windows Presentation Foundation](../../../../docs/framework/wpf/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/disable-the-realtimestylus-for-wpf-applications.md b/docs/framework/wpf/advanced/disable-the-realtimestylus-for-wpf-applications.md
new file mode 100644
index 00000000000..8239be0516e
--- /dev/null
+++ b/docs/framework/wpf/advanced/disable-the-realtimestylus-for-wpf-applications.md
@@ -0,0 +1,63 @@
+---
+title: "WPF アプリケーションのリアルタイムなスタイラス入力を無効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e0525309-5ede-4782-837d-dbf6e5554859
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# WPF アプリケーションのリアルタイムなスタイラス入力を無効にする
+Windows Presentation Foundation \(WPF\) には Windows 7 のタッチ入力処理をサポートする機能が組み込まれています。スタイラス入力を <xref:System.Windows.UIElement.OnStylusDown%2A> イベント、<xref:System.Windows.UIElement.OnStylusUp%2A> イベントおよび <xref:System.Windows.UIElement.OnStylusMove%2A> イベントとして、タブレットからリアルタイムに実行できるようにします。  また、Windows 7 ではマルチタッチ入力による Win32 WM\_TOUCH ウィンドウ メッセージにも対応しています。  これらの 2 つの API を、同じ HWND で同時に使用することはできません。  タブレットからのタッチ入力を有効にすると \(WPF アプリケーションの既定\)、WM\_TOUCH messages は無効になります。  そのため、WM\_TOUCH を使用して WPF ウィンドウからタッチ メッセージを受信する場合には、WPF に組み込まれているスタイラス入力のサポートを無効にする必要があります。  この状況に該当するのは、WM\_TOUCH を使用するコンポーネントをホストしている WPF ウィンドウなどです。  
+  
+ WPF でのスタイラス入力の待機を無効にするには、WPF ウィンドウで追加されたタブレットのサポートをすべて削除します。  
+  
+## 使用例  
+ 次に示すサンプル コードでは、リフレクションを使って既定のタブレット入力のサポートを削除する方法を示しています。  
+  
+```  
+public static void DisableWPFTabletSupport()  
+{  
+    // Get a collection of the tablet devices for this window.    
+    TabletDeviceCollection devices = System.Windows.Input.Tablet.TabletDevices;  
+  
+    if (devices.Count > 0)  
+    {     
+        // Get the Type of InputManager.  
+        Type inputManagerType = typeof(System.Windows.Input.InputManager);  
+  
+        // Call the StylusLogic method on the InputManager.Current instance.  
+        object stylusLogic = inputManagerType.InvokeMember("StylusLogic",  
+                    BindingFlags.GetProperty | BindingFlags.Instance | BindingFlags.NonPublic,  
+                    null, InputManager.Current, null);  
+  
+        if (stylusLogic != null)  
+        {  
+            //  Get the type of the stylusLogic returned from the call to StylusLogic.  
+            Type stylusLogicType = stylusLogic.GetType();  
+  
+            // Loop until there are no more devices to remove.  
+            while (devices.Count > 0)  
+            {  
+                // Remove the first tablet device in the devices collection.  
+                stylusLogicType.InvokeMember("OnTabletRemoved",  
+                        BindingFlags.InvokeMethod | BindingFlags.Instance | BindingFlags.NonPublic,  
+                        null, stylusLogic, new object[] { (uint)0 });  
+            }                  
+        }  
+  
+    }  
+}  
+```  
+  
+## 参照  
+ [スタイラスからの入力のインターセプト](../../../../docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/document-serialization-and-storage.md b/docs/framework/wpf/advanced/document-serialization-and-storage.md
new file mode 100644
index 00000000000..632590dbf30
--- /dev/null
+++ b/docs/framework/wpf/advanced/document-serialization-and-storage.md
@@ -0,0 +1,90 @@
+---
+title: "ドキュメントのシリアル化および保存 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, シリアル化"
+  - "ドキュメント, storage"
+  - "シリアル化 (ドキュメントの)"
+  - "保存 (ドキュメントを)"
+ms.assetid: 4839cd87-e206-4571-803f-0200098ad37b
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# ドキュメントのシリアル化および保存
+[!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] は、高品質なドキュメントを作成および表示するための強力な環境を提供します。  固定ドキュメントとフロー ドキュメントの両方をサポートする拡張機能、高度な表示コントロール、および 2D や 3D の強力なグラフィックス機能を組み合わせることにより、[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションの品質とユーザー エクスペリエンスをさらに向上させることができます。  ドキュメントのメモリ内表現を柔軟に管理するための機能は [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] の重要な機能の 1 つであり、データ ストアからドキュメントを効率的に保存して読み込むための機能はほとんどのアプリケーションで必要になります。  内部のメモリ内表現から外部のデータ ストアにドキュメントを変換するプロセスは、[シリアル化](GTMT)と呼ばれます。  データ ストアを読み込んで元のメモリ内インスタンスを再作成する逆のプロセスは、逆シリアル化と呼ばれます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="AboutSerialization"></a>   
+## ドキュメントのシリアル化について  
+ 理想的には、メモリ内のドキュメントを[シリアル化](GTMT)および逆シリアル化してメモリに戻すプロセスは、アプリケーションから透過的に実行されます。  アプリケーションは、シリアライザーの "write" メソッドを呼び出してドキュメントを保存します。一方、デシリアライザーの "read" メソッドは、データ ストアにアクセスして元のインスタンスをメモリ内に再作成します。  シリアル化および逆シリアル化によってドキュメントが元の形式に再作成される限り、通常、データの特定の保存形式はアプリケーションにとって重要ではありません。  
+  
+ 多くのアプリケーションには複数のシリアル化オプションが用意されています。これは、ドキュメントを異なるメディアや異なる形式に保存できるようにするためです。  たとえば、ディスク ファイル、データベース、または Web サービスにドキュメントを保存するための "名前を付けて保存" オプションがアプリケーションに用意されていることがあります。  同様に、複数のシリアライザーを使用することで、HTML、RTF、XML、XPS などさまざまな形式でドキュメントを保存できます。また、サードパーティの形式に保存することもできます。  シリアル化は、アプリケーションに対し、ストレージ メディアの詳細を各シリアライザーの実装内に分離するインターフェイスを定義します。  [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] <xref:System.Windows.Documents.Serialization> [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] には、ストレージ詳細のカプセル化という利点に加えて、いくつかの重要な機能が用意されています。  
+  
+### .NET Framework 3.0 ドキュメント シリアライザーの機能  
+  
+-   高レベルのドキュメント オブジェクト \([論理ツリー](GTMT)およびビジュアル\) への直接アクセス。この機能により、自動修正されたコンテンツ、2D\/3D 要素、イメージ、メディア、ハイパーリンク、注釈、およびその他のサポート コンテンツを効率的に保存できます。  
+  
+-   [同期](GTMT)操作と[非同期](GTMT)操作。  
+  
+-   次の拡張機能を持つプラグイン シリアライザーのサポート。  
+  
+    -   すべての [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションで使用される、システム全体へのアクセス。  
+  
+    -   アプリケーション プラグインの簡単な検出。  
+  
+    -   サードパーティのカスタム プラグインの簡単な配置、インストール、および更新。  
+  
+    -   ランタイム設定およびオプションをカスタマイズするためのユーザー インターフェイス サポート。  
+  
+### XPS 印刷パス  
+ [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] 印刷パスもまた、印刷出力を介してドキュメントを書き込むための拡張性の高い機能を提供します。  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] は、ドキュメントのファイル形式および [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] のネイティブな印刷スプール形式として使用されます。  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ドキュメントは、[!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] 互換プリンターに直接送信できます。中間形式に変換する必要はありません。  印刷パスの出力オプションおよび機能の詳細については、「[印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)」を参照してください。  
+  
+<a name="PluginSerializers"></a>   
+## プラグイン シリアライザー  
+ <xref:System.Windows.Documents.Serialization> API は、プラグイン シリアライザーとリンクされたシリアライザーの両方をサポートします。これらのシリアライザーは、アプリケーションから別々にインストールされ、実行時にバインドされます。これらのシリアライザーにアクセスする際には、<xref:System.Windows.Documents.Serialization.SerializerProvider> の検出機構が使用されます。  プラグイン シリアライザーには、配置およびシステム全体での使用を容易にするための拡張機能が用意されています。  リンクされたシリアライザーは、プラグイン シリアライザーにアクセスできない [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] などの[部分信頼](GTMT)環境にも実装できます。  リンクされたシリアライザーは、<xref:System.Windows.Documents.Serialization.SerializerWriter> クラスの派生実装に基づいており、アプリケーション内に直接コンパイルおよびリンクされます。  プラグイン シリアライザーとリンクされたシリアライザーは、同一のパブリック メソッドおよびイベントを介して動作します。これにより、いずれかまたは両方のシリアライザーを同じアプリケーション内で容易に使用することができます。  
+  
+ プラグイン シリアライザーは、新しいストレージ設計およびファイル形式に拡張機能を提供します。これにより、ビルド時に使用される可能性があるすべての形式に対してコードを直接記述する必要がなくなるため、アプリケーション開発者の負担が軽減されます。  また、プラグイン シリアライザーでは、カスタム ファイル形式または専用のファイル形式のためのシステム アクセス可能なプラグインを標準的な方法で配置、インストール、および更新できます。これにより、サードパーティの開発者の負担も軽減されます。  
+  
+### プラグイン シリアライザーの使用  
+ プラグイン シリアライザーは簡単に使用できます。  <xref:System.Windows.Documents.Serialization.SerializerProvider> クラスは、システムにインストールされている各プラグインの <xref:System.Windows.Documents.Serialization.SerializerDescriptor> オブジェクトを列挙します。  <xref:System.Windows.Documents.Serialization.SerializerDescriptor.IsLoadable%2A> プロパティは、現在の構成に基づいてインストール済みのプラグインをフィルター処理し、アプリケーションによるシリアライザーの読み込みおよび使用が可能であるかどうかを検証します。  <xref:System.Windows.Documents.Serialization.SerializerDescriptor> は、<xref:System.Windows.Documents.Serialization.SerializerDescriptor.DisplayName%2A> や <xref:System.Windows.Documents.Serialization.SerializerDescriptor.DefaultFileExtension%2A> などその他のプロパティも提供します。アプリケーションは、これらのプロパティを使用して、使用可能な出力形式のシリアライザーの選択をユーザーに求めることができます。  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] の既定のプラグイン シリアライザーは [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] によって提供されます。このシリアライザーは必ず列挙されます。  ユーザーが出力形式を選択したら、<xref:System.Windows.Documents.Serialization.SerializerProvider.CreateSerializerWriter%2A> メソッドを使用してその形式に対応する <xref:System.Windows.Documents.Serialization.SerializerWriter> を作成します。  次に、<xref:System.Windows.Documents.Serialization.SerializerWriter>.<xref:System.Windows.Documents.Serialization.SerializerWriter.Write%2A> メソッドを呼び出して、ドキュメント ストリームをデータ ストアに出力できます。  
+  
+ "PlugInFileFilter" プロパティ内で <xref:System.Windows.Documents.Serialization.SerializerProvider> メソッドを使用するアプリケーションの例を次に示します。  PlugInFileFilter は、インストール済みのプラグインを列挙し、使用可能なファイル オプションを使用してフィルター文字列を作成します。このフィルター文字列は <xref:Microsoft.Win32.SaveFileDialog> で使用されます。  
+  
+ [!code-csharp[DocumentSerialize#DocSerializeFileFilter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DocumentSerialize/CSharp/ThumbViewer.cs#docserializefilefilter)]  
+  
+ ユーザーが出力ファイル名を選択した後、<xref:System.Windows.Documents.Serialization.SerializerProvider.CreateSerializerWriter%2A> メソッドを使用して、指定したドキュメントを指定した形式で保存する例を次に示します。  
+  
+ [!code-csharp[DocumentSerialize#DocSerializePlugIn](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DocumentSerialize/CSharp/ThumbViewer.cs#docserializeplugin)]  
+  
+<a name="InstallingPluginSerializers"></a>   
+### プラグイン シリアライザーのインストール  
+ <xref:System.Windows.Documents.Serialization.SerializerProvider> クラスは、プラグイン シリアライザーの検出およびアクセスに使用される、上位レベルのアプリケーション インターフェイスを提供します。  <xref:System.Windows.Documents.Serialization.SerializerProvider> は、システムにインストールされているアクセスできるシリアライザーを検索し、その一覧をアプリケーションに提供します。  インストール済みのシリアライザーの詳細は、レジストリ設定で定義されます。  <xref:System.Windows.Documents.Serialization.SerializerProvider.RegisterSerializer%2A> メソッドを使用すると、プラグイン シリアライザーをレジストリに追加することができます。[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がまだインストールされていない場合は、プラグインのインストール スクリプトでレジストリの値を直接設定できます。  <xref:System.Windows.Documents.Serialization.SerializerProvider.UnregisterSerializer%2A> メソッドを使用すると、以前にインストールされたプラグインを削除できます。アンインストール スクリプトでレジストリ設定をリセットすることもできます。  
+  
+### プラグイン シリアライザーの作成  
+ プラグイン シリアライザーとリンクされたシリアライザーは、公開されている同一のパブリック メソッドおよびイベントを使用します。また、同様の方法で[同期的](GTMT)または[非同期的](GTMT)に動作するように設計できます。  プラグイン シリアライザーを作成する場合、通常は次の 3 つの基本手順に従います。  
+  
+1.  まず、リンクされたシリアライザーとしてシリアライザーを実装およびデバッグします。  最初にテスト アプリケーション内でシリアライザーを直接コンパイルおよびリンクして作成すると、ブレークポイントや、テストに役立つその他のデバッグ サービスへの完全なアクセスが提供されます。  
+  
+2.  シリアライザーのテストが完了したら、<xref:System.Windows.Documents.Serialization.ISerializerFactory> インターフェイスを追加してプラグインを作成します。  <xref:System.Windows.Documents.Serialization.ISerializerFactory> インターフェイスにより、論理ツリー、<xref:System.Windows.UIElement> オブジェクト、<xref:System.Windows.Documents.IDocumentPaginatorSource>、<xref:System.Windows.Media.Visual> 要素などすべての [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] オブジェクトへのフル アクセスが可能になります。  さらに、<xref:System.Windows.Documents.Serialization.ISerializerFactory> は、リンクされたシリアライザーによって使用される同一の同期および非同期のメソッドとイベントを提供します。  サイズの大きいドキュメントは出力に時間がかかる場合があるので、ユーザー操作の応答性を維持するために非同期操作を使用するようお勧めします。また、データ ストアに問題が発生した場合に備えて "キャンセル" オプションを用意してください。  
+  
+3.  プラグイン シリアライザーを作成したら、プラグインの配布、インストール、およびアンインストールのためのインストール スクリプトを実装します \(前の「[プラグイン シリアライザーのインストール](#InstallingPluginSerializers)」を参照してください\)。  
+  
+## 参照  
+ <xref:System.Windows.Documents.Serialization>   
+ <xref:System.Windows.Xps.XpsDocumentWriter>   
+ <xref:System.Windows.Xps.Packaging.XpsDocument>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [XML Paper Specification: 概要](http://go.microsoft.com/fwlink?LinkID=106246)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/documents-in-wpf.md b/docs/framework/wpf/advanced/documents-in-wpf.md
new file mode 100644
index 00000000000..3085339a708
--- /dev/null
+++ b/docs/framework/wpf/advanced/documents-in-wpf.md
@@ -0,0 +1,158 @@
+---
+title: "WPF のドキュメント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラウザーで表示可能なドキュメント"
+  - "ドキュメント, ブラウザーで表示可能"
+  - "ドキュメント, コントロール"
+  - "ドキュメント, パッケージ化"
+  - "ドキュメント, テキストのレイアウト"
+  - "ドキュメント, 型"
+  - "ドキュメント, XPS"
+  - "パッケージ化 (ドキュメントを)"
+  - "XPS ドキュメント"
+ms.assetid: 6e8db7bc-050a-4070-aa72-bb8c46e87ff8
+caps.latest.revision: 36
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# WPF のドキュメント
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の前の世代よりも簡単にアクセスおよび読み取りを行うことができるように設計されている、忠実性の高いコンテンツの作成を可能にするさまざまなドキュメント機能を提供します。  拡張された機能と品質に加えて、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、ドキュメントの表示、パッケージ化、およびセキュリティの統合されたサービスも提供します。  ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のドキュメントの種類とドキュメントのパッケージ化の概要を説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="types_of_documents"></a>   
+## ドキュメントの種類  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ドキュメントは用途に基づいて大きく 2 つのカテゴリに分けられます。これらのドキュメントのカテゴリは "固定ドキュメント" および "フロー ドキュメント" と呼ばれます。  
+  
+ 固定ドキュメントは、使用されるディスプレイまたはプリンター ハードウェアに関係なく、正確な [!INCLUDE[TLA#tla_wys](../../../../includes/tlasharptla-wys-md.md)] プレゼンテーションを必要とするアプリケーションを対象に用意されています。  固定ドキュメントの一般的な用途としては、元のページ デザインに準拠していることが重要になるデスクトップ パブリッシング、ワード プロセッシング、およびフォーム レイアウトなどがあります。  レイアウトの一部として、固定ドキュメントでは、使用中のディスプレイまたは印刷デバイスに依存しないコンテンツ要素の正確な配置位置が保持されます。  たとえば、96 dpi のディスプレイに表示される固定ドキュメント ページは、600 dpi のレーザー プリンターに出力される場合に、4800 dpi の写真植字に出力される場合とまったく同じように表示されます。  ドキュメントの品質は各デバイスの機能に応じて最大化されますが、ページ レイアウトはすべての場合において同じになります。  
+  
+ これに対して、フロー ドキュメントは、表示と読みやすさを最適化するように設計されており、ドキュメントが主に読みやすさを目的としている場合に最適です。  フロー ドキュメントは、1 つの定義済みのレイアウトに設定するのではなく、ウィンドウのサイズ、デバイスの解像度、省略可能なユーザー設定など、ランタイム変数に基づいてコンテンツを動的に調整したり再配置したりします。  Web ページは、そのコンテンツが現在のウィンドウに収まるように動的にフォーマットされるフロー ドキュメントの簡単な例です。  フロー ドキュメントは、ランタイム環境に基づいて、ユーザーにとっての表示と読みやすさを最適化します。  たとえば、同じフロー ドキュメントでも、高解像度の 19 インチ ディスプレイなのか、小型の 2x3 インチの PDA 画面なのかに応じて、最も読みやすくなるように書式設定が動的に変更されます。  また、フロー ドキュメントには、検索、読みやすさを最適化するモードの表示、およびフォントのサイズと外観を変更する機能を含むさまざまな組み込み済みの機能があります。  フロー ドキュメントの図、例、および詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  
+  
+<a name="document_viewer"></a>   
+## ドキュメント コントロールおよびテキスト レイアウト  
+ [!INCLUDE[TLA2#tla_avalonwinfx](../../../../includes/tla2sharptla-avalonwinfx-md.md)] には、アプリケーション内の固定ドキュメント、フロー ドキュメント、および一般的なテキストの使用を簡略化する、事前にビルドされたコントロールのセットが用意されています。  固定ドキュメントのコンテンツの表示は、<xref:System.Windows.Controls.DocumentViewer> コントロールを使用してサポートされます。  フロー ドキュメントのコンテンツの表示は、異なるユーザー シナリオに割り当てられている <xref:System.Windows.Controls.FlowDocumentReader>、<xref:System.Windows.Controls.FlowDocumentPageViewer>、および <xref:System.Windows.Controls.FlowDocumentScrollViewer> という 3 つの異なるコントロールによってサポートされます \(後のセクションを参照してください\)。  その他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールでは、一般的なテキストの使用をサポートする簡略化されたレイアウトが提供されます \(後の「[ユーザー インターフェイスのテキスト](#text_in_the_user_interface)」を参照してください\)。  
+  
+### 固定ドキュメント コントロール \- DocumentViewer  
+ <xref:System.Windows.Controls.DocumentViewer> コントロールは <xref:System.Windows.Documents.FixedDocument> コンテンツを表示するように設計されています。  <xref:System.Windows.Controls.DocumentViewer> コントロールは、印刷出力、クリップボードへのコピー、拡大、およびテキスト検索の機能を含む共通の操作へのサポートが組み込まれている直感的なユーザー インターフェイスを提供します。  コントロールは、使い慣れたスクロール機構を使用してコンテンツのページへのアクセスを提供します。  すべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールと同様に、<xref:System.Windows.Controls.DocumentViewer> は、事実上すべてのアプリケーションまたは環境に視覚的にコントロールを統合できるようにする、完全なスタイル変更または一部のスタイル変更をサポートします。  
+  
+ <xref:System.Windows.Controls.DocumentViewer> は、読み取り専用の形でコンテンツを表示するように設計されています。コンテンツの編集または変更は行うことはできず、サポートされていません。  
+  
+<a name="flow_document"></a>   
+### フロー ドキュメント コントロール  
+ **メモ :** フロー ドキュメント機能の詳細、およびフロー ドキュメントの作成方法については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  
+  
+ フロー ドキュメントのコンテンツの表示は、<xref:System.Windows.Controls.FlowDocumentReader>、<xref:System.Windows.Controls.FlowDocumentPageViewer>、および <xref:System.Windows.Controls.FlowDocumentScrollViewer> という 3 つのコントロールによってサポートされます。  
+  
+#### FlowDocumentReader  
+ <xref:System.Windows.Controls.FlowDocumentReader> には、単一ページ \(一度に 1 ページ\) 表示モード、2 ページ \(読書形式\) 表示モード、連続スクロール \(ボトムレス\) 表示モードなど、さまざまな表示モードをユーザーが動的に選択できるようにするための機能が用意されています。  これらの表示モードの詳細については、<xref:System.Windows.Controls.FlowDocumentReaderViewingMode> を参照してください。  表示モードを動的に切り替える必要がない場合は、<xref:System.Windows.Controls.FlowDocumentPageViewer> および <xref:System.Windows.Controls.FlowDocumentScrollViewer> を使用すると便利です。これらは、特定の表示モードに固定された軽量のコンテンツ ビューアーです。  
+  
+#### FlowDocumentPageViewer と FlowDocumentScrollViewer  
+ <xref:System.Windows.Controls.FlowDocumentPageViewer> は、コンテンツを一度に 1 ページずつ表示し、<xref:System.Windows.Controls.FlowDocumentScrollViewer> はコンテンツを連続したスクロール モードで表示します。  <xref:System.Windows.Controls.FlowDocumentPageViewer> および <xref:System.Windows.Controls.FlowDocumentScrollViewer> は、いずれも特定の表示モードに固定されています。  <xref:System.Windows.Controls.FlowDocumentReader> と比較してください。このリーダーでは、<xref:System.Windows.Controls.FlowDocumentReaderViewingMode> 列挙体により各種表示モードを動的に切り替えることができますが、<xref:System.Windows.Controls.FlowDocumentPageViewer> や <xref:System.Windows.Controls.FlowDocumentScrollViewer> よりも多くのリソースを消費します。  
+  
+ 既定では、垂直スクロール バーは常に表示され、水平スクロール バーは必要に応じて表示されます。  <xref:System.Windows.Controls.FlowDocumentScrollViewer> の既定の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] にはツール バーが含まれませんが、<xref:System.Windows.Controls.FlowDocumentScrollViewer.IsToolBarVisible%2A> プロパティを使用して組み込みツール バーを有効にできます。  
+  
+<a name="text_in_the_user_interface"></a>   
+### ユーザー インターフェイスのテキスト  
+ ドキュメントへのテキストの追加だけでなく、テキストはもちろん、フォームなどのアプリケーション UI で使用できます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、画面にテキストを描画するための複数のコントロールが含まれています。  各コントロールは、異なるシナリオを対象にしており、それぞれに一連の機能と制限があります。  一般的に、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] で短い文を使用するなど、限定的なテキストのサポートが必要な場合は、<xref:System.Windows.Controls.TextBlock> 要素を使用する必要があります。  最小限のテキスト サポートが必要な場合には、<xref:System.Windows.Controls.Label> を使用できます。  詳細については、「[TextBlock の概要](../../../../docs/framework/wpf/controls/textblock-overview.md)」を参照してください。  
+  
+<a name="packaging"></a>   
+## ドキュメントのパッケージ化  
+ <xref:System.IO.Packaging> の [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、簡単にアクセスでき、移植可能で、配布しやすい単一のコンテナー内のアプリケーション データ、ドキュメント コンテンツ、および関連リソースを編成するための効率的な方法を提供します。  ZIP ファイルは、複数のオブジェクトを 1 つの単位として保持することができる <xref:System.IO.Packaging.Package> の種類の 1 例です。  パッケージ化の [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、XML ファイルおよび ZIP ファイル アーキテクチャと共に Open Packaging Conventions 標準を使用して、既定の <xref:System.IO.Packaging.ZipPackage> 実装を提供します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のパッケージ化 [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、パッケージの作成、およびパッケージへのオブジェクトの格納とそれらのオブジェクトへのアクセスを簡単にします。  <xref:System.IO.Packaging.Package> に格納されたオブジェクトは <xref:System.IO.Packaging.PackagePart> \("パーツ"\) と呼ばれます。  パッケージには、パーツの発行元を識別し、パッケージのコンテンツが変更されていないことを検証するのに使用できる署名されたデジタル証明書を含めることもできます。  パッケージには、追加情報をパッケージに追加できたり、既存のパーツのコンテンツを実際に変更することなく特定のパーツに関連付けたりすることができる、<xref:System.IO.Packaging.PackageRelationship> 機能も含まれます。  パッケージ サービスでは、[!INCLUDE[TLA#tla_rm](../../../../includes/tlasharptla-rm-md.md)] もサポートされます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] パッケージ アーキテクチャは、さまざまな重要な技術の基盤として機能します。  
+  
+-   [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] に準拠する [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ドキュメント。  
+  
+-   Microsoft Office "12" Open XML Formats のドキュメント \(.docx\)。  
+  
+-   独自のアプリケーション設計のカスタム保存形式。  
+  
+ パッケージ化 API に基づいて、<xref:System.Windows.Xps.Packaging.XpsDocument> は、特に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 固定コンテンツ ドキュメントを格納するために設計されています。  <xref:System.Windows.Xps.Packaging.XpsDocument> は、ビューアーで開き、<xref:System.Windows.Controls.DocumentViewer> コントロールに表示し、印刷スプールにルーティングし、[!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] と互換性のあるプリンターに直接出力することができる、自己完結型ドキュメントです。  
+  
+ 以下のセクションでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で提供されている <xref:System.IO.Packaging.Package> および <xref:System.Windows.Xps.Packaging.XpsDocument> [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] について追加情報を示します。  
+  
+<a name="packages"></a>   
+### パッケージ コンポーネント  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] パッケージ化 API は、アプリケーション データとドキュメントを 1 つの移植可能な単位に編成できるようにします。  ZIP ファイルは、最もよく使用されるパッケージの種類の 1 つであり、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で用意されている既定のパッケージの種類です。  <xref:System.IO.Packaging.Package> 自体は、<xref:System.IO.Packaging.ZipPackage> が標準のオープン XML および ZIP ファイル アーキテクチャを使用して実装される元となる抽象クラスです。  <xref:System.IO.Packaging.Package.Open%2A> メソッドは、既定では <xref:System.IO.Packaging.ZipPackage> を使用して ZIP ファイルを作成および使用します。  パッケージには、次の 3 種類の基本的な項目を含めることができます。  
+  
+|||  
+|-|-|  
+|<xref:System.IO.Packaging.PackagePart>|アプリケーション コンテンツ、データ、ドキュメント、およびリソース ファイル。|  
+|<xref:System.IO.Packaging.PackageDigitalSignature>|識別、認証、および検証のための [X.509 証明書](GTMT)。|  
+|<xref:System.IO.Packaging.PackageRelationship>|パッケージまたは特定のパーツに関連する追加された情報。|  
+  
+<a name="PackageParts"></a>   
+#### PackageParts  
+ <xref:System.IO.Packaging.PackagePart> \("パーツ"\) は <xref:System.IO.Packaging.Package> に格納されたオブジェクトを参照する抽象クラスです。  ZIP ファイルでは、パッケージ パーツは ZIP ファイル内に格納された個別のファイルに対応します。  <xref:System.IO.Packaging.ZipPackagePart> は、<xref:System.IO.Packaging.ZipPackage> 内に格納されるシリアル化可能なオブジェクトに対する既定の実装を提供します。  ファイル システムと同様に、パッケージに含まれているパーツは、階層的ディレクトリまたは "フォルダー スタイル" 編成で格納されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] パッケージ化 API を使用すると、アプリケーションは、単一の ZIP ファイル コンテナーを使用して、複数の <xref:System.IO.Packaging.PackagePart> オブジェクトの書き込み、格納、および読み取りを行うことができます。  
+  
+<a name="PackageDigitalSignatures"></a>   
+#### PackageDigitalSignatures  
+ セキュリティ保護のために、パッケージ内のパーツに <xref:System.IO.Packaging.PackageDigitalSignature> \("デジタル署名"\) を関連付けることができます。  <xref:System.IO.Packaging.PackageDigitalSignature> には、次の 2 つの機能を提供する [509](GTMT) が組み込まれています。  
+  
+1.  パーツの発行元を識別および認証します。  
+  
+2.  パーツが変更されていないことを検証します。  
+  
+ デジタル署名はパーツを変更できなくするものではありません。しかし、パーツが何らかの方法で変更されている場合、デジタル署名に対する検証チェックは失敗します。  その後、アプリケーションでは適切なアクションを実行することができます。たとえば、パーツを開く操作をブロックしたり、パーツが変更されていて安全ではないことをユーザーに知らせたりすることができます。  
+  
+<a name="PackageRelationships"></a>   
+#### PackageRelationships  
+ <xref:System.IO.Packaging.PackageRelationship> \("リレーションシップ"\) は、追加情報をパッケージまたはパッケージ内のパーツに関連付けるための機構を提供します。  リレーションシップは、実際のパーツのコンテンツを変更することなく追加情報をパーツに関連付けることができるパッケージ レベルの機能です。  パーツのコンテンツに新しいデータを直接挿入するのは、次のように多くの場合において実用的ではありません。  
+  
+-   パーツの実際の種類およびそのコンテンツ スキーマが不明な場合。  
+  
+-   わかっていたとしても、コンテンツ スキーマが新しい情報を追加する方法を提供しない可能性がある場合。  
+  
+-   パーツが、デジタル署名されたり、暗号化されたり、変更できなくされたりする可能性がある場合。  
+  
+ パッケージ リレーションシップは、追加情報を個別のパーツまたはパッケージ全体に追加または関連付けるための検出可能な方法を提供します。  パッケージ リレーションシップは、次の 2 つの主要な機能のために使用されます。  
+  
+1.  1 つのパーツから別のパーツへの依存関係の定義。  
+  
+2.  メモまたはパーツに関連したその他のデータを追加する情報リレーションシップの定義。  
+  
+ <xref:System.IO.Packaging.PackageRelationship> は、依存関係を定義し、パッケージのパーツまたはパッケージ全体に関連付けられたその他の情報を追加するための、すばやく検出可能な方法を提供します。  
+  
+<a name="Dependency_Relationships"></a>   
+##### 依存関係  
+ 依存関係は、1 つのパーツによって他のパーツに対して作成される依存関係を記述するために使用されます。  たとえば、パッケージには、1 つ以上の \<img\> イメージ タグを含む HTML パーツが含まれている場合があります。  イメージ タグは、パッケージの内部またはパッケージの外部 \(インターネット経由でアクセスできる場合など\) にあるその他のパーツとして配置されているイメージを参照します。  HTML ファイルに関連付けられている <xref:System.IO.Packaging.PackageRelationship> を作成すると、依存リソースの検出およびアクセスがすばやく簡単になります。  ブラウザーまたはビューアー アプリケーションは、パーツ リレーションシップに直接アクセスし、スキーマが不明であったりドキュメントの解析を行わない状態で依存リソースをすぐにアセンブルできます。  
+  
+<a name="Information_Relationships"></a>   
+##### 情報リレーションシップ  
+ メモまたは注釈と同様に、<xref:System.IO.Packaging.PackageRelationship> は、実際にパーツのコンテンツ自体を変更することなく、パーツに関連付けられるその他の種類の情報を格納するために使用することもできます。  
+  
+<a name="XPS_Documents"></a>   
+## XPS ドキュメント  
+ [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ドキュメントは、レンダリングのために必要なすべてのリソースおよび情報と共に 1 つ以上の固定ドキュメントを格納するパッケージです。  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] はネイティブな [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] 印刷スプール ファイル形式でもあります。  An <xref:System.Windows.Xps.Packaging.XpsDocument> は、標準 ZIP データセットに格納され、イメージ ファイルやフォント ファイルなどのバイナリ コンポーネントと XML コンポーネントを組み合わせて格納できます。[PackageRelationships](#PackageRelationships) は、ドキュメントを完全にレンダリングするために必要なコンテンツとリソースの間の依存関係を定義するために使用されます。  <xref:System.Windows.Xps.Packaging.XpsDocument> の設計は、次のような複数の用途をサポートする忠実性の高い単一のドキュメント ソリューションを提供します。  
+  
+-   単一の移植可能で配布しやすいファイルとして、固定ドキュメント コンテンツおよびリソースを読み取り、書き込み、および格納する。  
+  
+-   [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ビューアー アプリケーションを使用してドキュメントを表示する。  
+  
+-   [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] のネイティブな印刷スプール出力形式でドキュメントを出力する。  
+  
+-   [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] と互換性があるプリンターにドキュメントを直接ルーティングする。  
+  
+## 参照  
+ <xref:System.Windows.Documents.FixedDocument>   
+ <xref:System.Windows.Documents.FlowDocument>   
+ <xref:System.Windows.Xps.Packaging.XpsDocument>   
+ <xref:System.IO.Packaging.ZipPackage>   
+ <xref:System.IO.Packaging.ZipPackagePart>   
+ <xref:System.IO.Packaging.PackageRelationship>   
+ <xref:System.Windows.Controls.DocumentViewer>   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [ドキュメントのシリアル化および保存](../../../../docs/framework/wpf/advanced/document-serialization-and-storage.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/documents.md b/docs/framework/wpf/advanced/documents.md
new file mode 100644
index 00000000000..10ffff4a6cb
--- /dev/null
+++ b/docs/framework/wpf/advanced/documents.md
@@ -0,0 +1,39 @@
+---
+title: "ドキュメント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ドキュメント"
+  - "ドキュメント, 機能"
+ms.assetid: 7bf37ccb-5d09-4eae-9661-929582aeb259
+caps.latest.revision: 86
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 86
+---
+# ドキュメント
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、開発するアプリケーションにおける高度なドキュメント機能の利用と読みやすさの向上のための、多様なコンポーネントがあります。  豊富な機能と品質の高さに加えて、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、ドキュメントのパッケージ化、セキュリティ、および保存を容易にする各種管理サービスもあります。  
+  
+## このセクションの内容  
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)  
+ [ドキュメントのシリアル化および保存](../../../../docs/framework/wpf/advanced/document-serialization-and-storage.md)  
+ [コメント](../../../../docs/framework/wpf/advanced/annotations.md)  
+ [フロー コンテンツ](../../../../docs/framework/wpf/advanced/flow-content.md)  
+ [タイポグラフィ](../../../../docs/framework/wpf/advanced/typography.md)  
+ [印刷および印刷システムの管理](../../../../docs/framework/wpf/advanced/printing-and-print-system-management.md)  
+  
+## 参照  
+ <xref:System.Windows.Controls.DocumentViewer>   
+ <xref:System.Windows.Documents.FlowDocument>   
+ <xref:System.Windows.Xps>   
+ [isXPS.exe \(isXPS 適合性ツール\)](../Topic/isXPS.exe%20\(isXPS%20Conformance%20Tool\).md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/drag-and-drop-how-to-topics.md b/docs/framework/wpf/advanced/drag-and-drop-how-to-topics.md
new file mode 100644
index 00000000000..40e81f11134
--- /dev/null
+++ b/docs/framework/wpf/advanced/drag-and-drop-how-to-topics.md
@@ -0,0 +1,35 @@
+---
+title: "ドラッグ アンド ドロップに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ [WPF], 方法トピック"
+ms.assetid: 559c0804-c62a-4640-b6b9-cbd2aa9fb99c
+caps.latest.revision: 80
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 80
+---
+# ドラッグ アンド ドロップに関する「方法」トピック
+次の例では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ドラッグ アンド ドロップ フレームワークを使用して一般的なタスクを実行する方法を示します。  
+  
+## このセクションの内容  
+ [RichTextBox コントロール上にドロップしたファイルを開く](../../../../docs/framework/wpf/advanced/how-to-open-a-file-that-is-dropped-on-a-richtextbox-control.md)  
+ [データ オブジェクトを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-data-object.md)  
+ [データ形式がデータ オブジェクトに存在するかどうかを判別する](../../../../docs/framework/wpf/advanced/how-to-determine-if-a-data-format-is-present-in-a-data-object.md)  
+ [データ オブジェクト内のデータ形式の一覧を表示する](../../../../docs/framework/wpf/advanced/how-to-list-the-data-formats-in-a-data-object.md)  
+ [特定のデータ形式でデータを取得する](../../../../docs/framework/wpf/advanced/how-to-retrieve-data-in-a-particular-data-format.md)  
+ [データ オブジェクトへ複数のデータ形式を格納する](../../../../docs/framework/wpf/advanced/how-to-store-multiple-data-formats-in-a-data-object.md)  
+  
+## 参照  
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/drag-and-drop-overview.md b/docs/framework/wpf/advanced/drag-and-drop-overview.md
new file mode 100644
index 00000000000..10e255507b4
--- /dev/null
+++ b/docs/framework/wpf/advanced/drag-and-drop-overview.md
@@ -0,0 +1,228 @@
+---
+title: "ドラッグ アンド ドロップの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ転送 [WPF], ドラッグ アンド ドロップ"
+  - "ドラッグ ソース [WPF], ドラッグ アンド ドロップ"
+  - "ドラッグ アンド ドロップ [WPF], バージョン情報"
+  - "ドラッグ アンド ドロップ [WPF], イベント"
+  - "ドラッグ アンド ドロップ [WPF], 実装"
+  - "ドロップ ターゲット [WPF], ドラッグ アンド ドロップ"
+ms.assetid: 1a5b27b0-0ac5-4cdf-86c0-86ac0271fa64
+caps.latest.revision: 31
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# ドラッグ アンド ドロップの概要
+このトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでのドラッグ アンド ドロップのサポートの概要について説明します。  一般的に、ドラッグ アンド ドロップとは、マウス \(または何らかのポインティング デバイス\) を使用して 1 つ以上のオブジェクトを選択し、これらのオブジェクトを [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の目的のドロップ先までドラッグしてからドロップするデータ転送方式をいいます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Drag_and_Drop_Support"></a>   
+## WPF でのドラッグ アンド ドロップのサポート  
+ ドラッグ アンド ドロップ操作には、一般に、ドラッグするオブジェクトがドラッグを始めるドラッグ元と、ドロップするオブジェクトを受け取るドロップ先という 2 者があります。  ドラッグ元とドロップ先は、同じアプリケーションまたは異なるアプリケーションの UI 要素になることがあります。  
+  
+ ドラッグ アンド ドロップで操作できるオブジェクトの種類と数は、まったく任意です。  たとえば、ファイル、フォルダー、およびコンテンツの選択項目は、ドラッグ アンド ドロップ操作を介して操作する、より一般的なオブジェクトの一部です。  
+  
+ ドラッグ アンド ドロップ操作中に実行される特定の操作はアプリケーション固有で、多くの場合コンテキストによって決定されます。  たとえば、同じストレージ デバイスで選択したファイルをあるフォルダーから別のフォルダーにドラッグすると、既定ではファイルが移動します。一方、[!INCLUDE[TLA#tla_unc](../../../../includes/tlasharptla-unc-md.md)] 共有からローカル フォルダーにファイルをドラッグすると、既定ではファイルがコピーされます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が提供するドラッグ アンド ドロップ機能は、さまざまなドラッグ アンド ドロップのシナリオをサポートするよう、非常に柔軟かつカスタマイズできるように設計されています。  ドラッグ アンド ドロップでは、1 つのアプリケーション内で、または異なるアプリケーションの間でのオブジェクトの操作をサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションと他の [!INCLUDE[TLA2#tla_win](../../../../includes/tla2sharptla-win-md.md)] アプリケーションの間でのドラッグ アンド ドロップも完全にサポートされています。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、任意の <xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> がドラッグ アンド ドロップに参加できます。  ドラッグ アンド ドロップ操作に必要なイベントとメソッドは、<xref:System.Windows.DragDrop> クラスで定義されています。  <xref:System.Windows.UIElement> と <xref:System.Windows.ContentElement> クラスには、<xref:System.Windows.DragDrop> のアタッチ済みのイベントのエイリアスが含まれています。これにより、<xref:System.Windows.UIElement> や <xref:System.Windows.ContentElement> が基本要素として継承されるときに、イベントがクラスのメンバーとして表示されます。  これらのイベントにアタッチされたイベント ハンドラーは、基になる <xref:System.Windows.DragDrop> のアタッチ済みのイベントにアタッチされ、同じイベント データのインスタンスを受信します。  詳細については、<xref:System.Windows.UIElement.Drop?displayProperty=fullName> イベントを参照してください。  
+  
+> [!IMPORTANT]
+>  OLE のドラッグ アンド ドロップは、インターネット ゾーンにある間は機能しません。  
+  
+<a name="Data_Transfer"></a>   
+## データ転送  
+ ドラッグ アンド ドロップは、より一般的な領域のデータ転送の一部です。  データ転送には、ドラッグ アンド ドロップ操作およびコピーと貼り付けの操作があります。  ドラッグ アンド ドロップ操作は、システムのクリップボードを使用して、あるオブジェクトまたはアプリケーションから別のオブジェクトまたはアプリケーションへのデータ転送に使用する、コピーと貼り付け操作または切り取りと貼り付け操作に似ています。  いずれの種類の操作でも、次のものが必要です。  
+  
+-   データを提供するソース オブジェクト。  
+  
+-   転送されたデータを一時的に格納する方法。  
+  
+-   データを受け取るターゲット オブジェクト。  
+  
+ コピーと貼り付け操作では、システムのクリップボードを使用して、転送されたデータを一時的に保存します。ドラッグ アンド ドロップ操作では、<xref:System.Windows.DataObject> を使用してデータを格納します。  データ オブジェクトは、概念的に、実際のデータと対応するデータ形式の識別子を格納する 1 組以上の <xref:System.Object> で構成されています。  
+  
+ ドラッグ元では、静的な <xref:System.Windows.DragDrop.DoDragDrop%2A?displayProperty=fullName> メソッドを呼び出して、転送するデータをそのメソッドに渡すことでドラッグ アンド ドロップ操作を開始します。  必要な場合、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドは <xref:System.Windows.DataObject> にデータを自動的にラップします。  データ形式の制御を拡大するには、データを <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドに渡す前に <xref:System.Windows.DataObject> にラップします。  ドロップ先は、<xref:System.Windows.DataObject> からデータを抽出する役割を務めます。  データ オブジェクトの操作の詳細については、「[データとデータ オブジェクト](../../../../docs/framework/wpf/advanced/data-and-data-objects.md)」を参照してください。  
+  
+ ドラッグ アンド ドロップ操作のソースとターゲットは UI 要素ですが、一般に、実際に転送されているデータには視覚的表現はありません。  Windows エクスプローラーでファイルをドラッグするときに起こるような視覚的表現を、ドラッグするデータで実行するように、コードを記述することができます。  既定では、データを移動するのかコピーするのかなど、ドラッグ アンド ドロップ操作によりデータに起こる効果を表すようにカーソルを変更して、ユーザーにフィードバックします。  
+  
+### ドラッグ アンド ドロップの効果  
+ ドラッグ アンド ドロップ操作には、転送するデータにさまざまな効果を持たせることができます。  たとえば、データをコピーしたり、データを移動したりできるなどです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ドラッグ アンド ドロップ操作の効果を指定するために使用できる <xref:System.Windows.DragDropEffects> 列挙体を定義します。  ドラッグ元では、ソースが <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドで許可する効果を指定できます。  ドロップ先では、<xref:System.Windows.DragEventArgs> クラスの <xref:System.Windows.DragEventArgs.Effects%2A> プロパティでターゲットの目的の効果を指定できます。  <xref:System.Windows.DragDrop.DragOver> イベントでドロップ先の目的の効果を指定した場合、その情報が <xref:System.Windows.DragDrop.GiveFeedback> イベントのドラッグ元に渡されます。  ドラッグ元では、この情報を使用して、ドロップ先がデータにどのような効果を起こそうとしているかをユーザーに伝えます。  データがドロップされると、ドロップ先では <xref:System.Windows.DragDrop.Drop> イベントでの実際の効果を指定します。  この情報は、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドの戻り値としてドラッグ元に渡されます。  ドラッグ元の `allowedEffects` の一覧にない効果をドロップ先が返す場合、ドラッグ アンド ドロップ操作は取り消され、データ転送は発生しません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ドラッグ アンド ドロップ操作の効果に関しては、<xref:System.Windows.DragDropEffects> 値はドラッグ元とドロップ先間の通信にのみ使用されるということを覚えておくのは重要です。  ドラッグ アンド ドロップ操作の実際の効果は、アプリケーションで適切なコードを記述することに依存します。  
+  
+ たとえば、ドロップ先では、ドロップ先にデータをドロップすることはデータが移動することと指定される可能性があります。  ただし、データを移動するには、データがターゲット要素に追加されるとともに、ソース要素から削除される必要があります。  ソース要素は、データの移動を許可していますが、ソース要素からデータを削除するコードを指定しない場合、最終的にデータは移動ではなく、コピーされるという結果になります。  
+  
+<a name="Drag_and_Drop_Events"></a>   
+## ドラッグ アンド ドロップのイベント  
+ ドラッグ アンド ドロップの操作は、イベント ドリブン モデルをサポートしています。  ドラッグ元とドロップ先の両方でイベントの標準セットを使用して、ドラッグ アンド ドロップの操作を処理します。  次の表は、標準のドラッグ アンド ドロップのイベントをまとめたものです。  これらは、<xref:System.Windows.DragDrop> クラスでアタッチされるイベントです。  アタッチされるイベントの詳細については、「[添付イベントの概要](../../../../docs/framework/wpf/advanced/attached-events-overview.md)」を参照してください。  
+  
+### ドラッグ元のイベント  
+  
+|イベント|概要|  
+|----------|--------|  
+|<xref:System.Windows.DragDrop.GiveFeedback>|このイベントは、ドラッグ アンド ドロップ操作中に継続的に発生し、ドロップ ソースがユーザーに情報をフィードバックできるようにします。  このフィードバックは、通常、マウス ポインターの外観を変えて、ドロップ先が許可する効果を示すことで実行されます。  これは、 [バブリング](GTMT) イベントです。|  
+|<xref:System.Windows.DragDrop.QueryContinueDrag>|このイベントは、ドラッグ アンド ドロップ操作時にキーボードやマウス ボタンの状態が変化し、ドロップ ソースがキーやボタンの状態によってドラッグ アンド ドロップ操作の取り消しができるようになったときに発生します。  これは、 バブリング イベントです。|  
+|<xref:System.Windows.DragDrop.PreviewGiveFeedback>|[トンネリング](GTMT) バージョンの <xref:System.Windows.DragDrop.GiveFeedback> です。|  
+|<xref:System.Windows.DragDrop.PreviewQueryContinueDrag>|トンネリング バージョンの <xref:System.Windows.DragDrop.QueryContinueDrag> です。|  
+  
+### ドロップ先のイベント  
+  
+|イベント|概要|  
+|----------|--------|  
+|<xref:System.Windows.DragDrop.DragEnter>|このイベントは、オブジェクトがドロップ先の境界の中にドラッグされるときに発生します。  これは、 バブリング イベントです。|  
+|<xref:System.Windows.DragDrop.DragLeave>|このイベントは、オブジェクトがドロップ先の境界の外にドラッグされるときに発生します。  これは、 バブリング イベントです。|  
+|<xref:System.Windows.DragDrop.DragOver>|このイベントは、オブジェクトがドロップ先の境界内でドラッグ \(移動\) する間、継続的に発生します。  これは、 バブリング イベントです。|  
+|<xref:System.Windows.DragDrop.Drop>|このイベントは、オブジェクトがドロップ先にドロップするときに発生します。  これは、バブリング イベントです。|  
+|<xref:System.Windows.DragDrop.PreviewDragEnter>|トンネリング バージョンの <xref:System.Windows.DragDrop.DragEnter> です。|  
+|<xref:System.Windows.DragDrop.PreviewDragLeave>|トンネリング バージョンの <xref:System.Windows.DragDrop.DragLeave> です。|  
+|<xref:System.Windows.DragDrop.PreviewDragOver>|トンネリング バージョンの <xref:System.Windows.DragDrop.DragOver> です。|  
+|<xref:System.Windows.DragDrop.PreviewDrop>|トンネリング バージョンの <xref:System.Windows.DragDrop.Drop> です。|  
+  
+ オブジェクトのインスタンスのドラッグ アンド ドロップ イベントを処理するには、前述の表に一覧表示されたイベントにハンドラーを追加します。  クラス レベルでドラッグ アンド ドロップ イベントを処理するには、対応する仮想 On\*Event イベントおよび On\*PreviewEvent メソッドをオーバーライドします。  詳細については、「[制御の基底クラスによるルーティング イベントのクラスの処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md#Class_Handling_of_Routed_Events)」を参照してください。  
+  
+<a name="Implementing_Drag_And_Drop"></a>   
+## ドラッグ アンド ドロップの実装  
+ UI 要素は、ドラッグ元、ドロップ先、またはその両方になれます。  基本的なドラッグ アンド ドロップを実装するには、ドラッグ アンド ドロップ操作を開始して、ドロップしたデータを処理するコードを記述します。  オプションのドラッグ アンド ドロップ イベントを処理すると、ドラッグ アンド ドロップの操作性を拡張できます。  
+  
+ 基本的なドラッグ アンド ドロップを実装するには、次のタスクを実行します。  
+  
+-   ドラッグ元となる要素を特定します。  ドラッグ元には <xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> を指定できます。  
+  
+-   ドラッグ アンド ドロップ操作を開始するドラッグ元のイベント ハンドラーを作成します。  通常、イベントは <xref:System.Windows.UIElement.MouseMove> イベントです。  
+  
+-   ドラッグ アンド ドロップ操作を開始するには、ドラッグ元のイベント ハンドラーで <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドを呼び出します。  <xref:System.Windows.DragDrop.DoDragDrop%2A> の呼び出しで、ドラッグ元、転送するデータ、および許可される効果を指定します。  
+  
+-   ドロップ先となる要素を特定します。  ドロップ先には、<xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> を指定できます。  
+  
+-   ドロップ先で、<xref:System.Windows.UIElement.AllowDrop%2A> プロパティを `true` に設定します。  
+  
+-   ドロップ先で、ドロップしたデータを処理する <xref:System.Windows.DragDrop.Drop> イベント ハンドラーを作成します。  
+  
+-   <xref:System.Windows.DragDrop.Drop> イベント ハンドラーで、<xref:System.Windows.DataObject.GetDataPresent%2A> メソッドと <xref:System.Windows.DataObject.GetData%2A> メソッドを使用して、<xref:System.Windows.DragEventArgs> からデータを抽出します。  
+  
+-   <xref:System.Windows.DragDrop.Drop> イベント ハンドラーで、データを使用して、目的のドラッグ アンド ドロップ操作を実行します。  
+  
+ 次のタスクに示すように、カスタム <xref:System.Windows.DataObject> を作成し、オプションのドラッグ元とドロップ先のイベントを処理すると、ドラッグ アンド ドロップの実装を拡張できます。  
+  
+-   カスタム データまたは複数のデータ項目を転送するには、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドに渡す <xref:System.Windows.DataObject> を作成します。  
+  
+-   ドラッグ中に他の操作を実行するには、ドロップ先で <xref:System.Windows.DragDrop.DragEnter>、<xref:System.Windows.DragDrop.DragOver>、および <xref:System.Windows.DragDrop.DragLeave> イベントを処理します。  
+  
+-   マウス ポインターの外観を変更するには、ドラッグ元で <xref:System.Windows.DragDrop.GiveFeedback> イベントを処理します。  
+  
+-   ドラッグ アンド ドロップ操作の取り消し方法を変更するには、ドラッグ元で <xref:System.Windows.DragDrop.QueryContinueDrag> イベントを処理します。  
+  
+<a name="Drag_And_Drop_Example"></a>   
+## ドラッグ アンド ドロップの例  
+ このセクションでは、<xref:System.Windows.Shapes.Ellipse> 要素のドラッグ アンド ドロップを実装する方法について説明します。  <xref:System.Windows.Shapes.Ellipse> はドラッグ元とドロップ先の両方です。  転送されるデータは、楕円の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティの文字列表現です。  次の XAML は、<xref:System.Windows.Shapes.Ellipse> 要素と、XAML が処理するドラッグ アンド ドロップ関連のイベントを示しています。  ドラッグ アンド ドロップの実装方法の完全な手順については、「[チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化](../../../../docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md)」を参照してください。  
+  
+ [!code-xml[DragDropSnippets#EllipseXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml#ellipsexaml)]  
+  
+### 要素がドラッグ元になるようにする  
+ ドラッグ元であるオブジェクトは次の役割を務めます。  
+  
+-   いつドラッグが発生するかを識別する。  
+  
+-   ドラッグ アンド ドロップ操作を開始する。  
+  
+-   転送するデータを特定する。  
+  
+-   ドラッグ アンド ドロップ操作によってデータ転送時に起こすことができる効果を指定する。  
+  
+ ドラッグ元には、許可される操作 \(移動、コピー、なし\) に関してユーザーにフィードバックすることもできます。また、ドラッグ中に Esc キーを押すなどのユーザーの追加の入力に基づいて、ドラッグ アンド ドロップ操作を取り消すことができます。  
+  
+ いつドラッグが発生したかを判断してから、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドを呼び出してドラッグ アンド ドロップ操作を開始することは、アプリケーションの役割です。  通常、これはマウス ボタンが押されている間に、要素上で <xref:System.Windows.UIElement.MouseMove> イベントが発生してドラッグする場合です。  次の例は、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.UIElement.MouseMove> イベント ハンドラーからドラッグ アンド ドロップ操作を開始してドラッグ元にする方法を示しています。  転送されるデータは、楕円の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティの文字列表現です。  
+  
+ [!code-csharp[DragDropSnippets#DoDragDrop](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dodragdrop)]
+ [!code-vb[DragDropSnippets#DoDragDrop](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dodragdrop)]  
+  
+ <xref:System.Windows.UIElement.MouseMove> イベント ハンドラー内で、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドを呼び出して、ドラッグ アンド ドロップ操作を開始します。  <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドは 3 つのパラメーターを受け取ります。  
+  
+-   `dragSource` – 転送されたデータのソースである依存関係オブジェクトへの参照。通常、これは <xref:System.Windows.UIElement.MouseMove> イベントのソースです。  
+  
+-   `data` \- <xref:System.Windows.DataObject> にラップされる転送済みデータを含むオブジェクト。  
+  
+-   `allowedEffects` \- ドラッグ アンド ドロップ操作の許可される効果を指定する <xref:System.Windows.DragDropEffects> 列挙値の 1 つ。  
+  
+ シリアル化可能なオブジェクトはすべて `data` パラメーターに渡すことができます。  データがまだ <xref:System.Windows.DataObject> にラップされていない場合、データは新しい <xref:System.Windows.DataObject> に自動的にラップされます。  複数のデータ項目を渡すには、自分で <xref:System.Windows.DataObject> を作成し、<xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドに渡す必要があります。  詳細については、「[データとデータ オブジェクト](../../../../docs/framework/wpf/advanced/data-and-data-objects.md)」を参照してください。  
+  
+ `allowedEffects` パラメーターを使用すると、ドラッグ元が、ドロップ先に対して、データの転送時に何を行えるかを指定できます。  ドラッグ元の一般的な値は <xref:System.Windows.DragDropEffects>、<xref:System.Windows.DragDropEffects>、および <xref:System.Windows.DragDropEffects> です。  
+  
+> [!NOTE]
+>  ドロップ先でも、ドロップされたデータに対応してどのような効果を意図するか指定できます。  たとえば、ドロップ先がドロップするデータ型を認識しない場合、許可された効果を <xref:System.Windows.DragDropEffects> に設定してデータを拒否することができます。  これは通常、 <xref:System.Windows.DragDrop.DragOver> イベント ハンドラーで実行します。  
+  
+ ドラッグ元は、オプションで <xref:System.Windows.DragDrop.GiveFeedback> イベントと <xref:System.Windows.DragDrop.QueryContinueDrag> イベントを処理できます。  これらのイベントには、イベントを処理済みとマークしない限り使用される既定のハンドラーがあります。  既定の動作を変更する特定のニーズがない限り、通常はこれらのイベントを無視します。  
+  
+ ドラッグ元がドラッグされている間、<xref:System.Windows.DragDrop.GiveFeedback> イベントは継続的に発生します。  このイベントの既定のハンドラーは、ドラッグ元が有効なドロップ先の上にドラッグしているかどうかを確認します。  有効である場合は、このハンドラーは、ドロップ先の許可された効果を確認します。  その後、許可されているドロップ効果に関してエンドユーザーにフィードバックします。  通常は、マウス カーソルを非ドロップ、コピー、または移動のカーソルに変更してこれを実行します。  カスタムのカーソルを使用してユーザーにフィードバックする必要がある場合のみ、このイベントを処理する必要があります。  このイベントを処理する場合は、既定のハンドラーが自作のハンドラーをオーバーライドしないよう、必ずイベントを処理済みとマークしてください。  
+  
+ ドラッグ元がドラッグされている間、<xref:System.Windows.DragDrop.QueryContinueDrag> イベントは継続的に発生します。  このイベントを処理すると、Esc、Shift、Ctrl、および Alt の各キーの状態に加えて、マウス ボタンの状態に基づいて、どのアクションがドラッグ アンド ドロップ操作を終了させるかを決定することができます。  このイベントの既定のハンドラーは、Esc キーを押した場合はドラッグ アンド ドロップ操作を取り消し、マウス ボタンを放した場合はデータをドロップします。  
+  
+> [!CAUTION]
+>  これらのイベントは、ドラッグ アンド ドロップ操作中に継続的に発生します。  そのため、イベント ハンドラーではリソースを集中的に使用するタスクを避ける必要があります。  たとえば、<xref:System.Windows.DragDrop.GiveFeedback> イベントが発生するたびに新しいカーソルを作成するのではなく、キャッシュされたカーソルを使用します。  
+  
+### 要素がドロップ先になるようにする  
+ ドロップ先であるオブジェクトは次の役割を務めます。  
+  
+-   有効なドロップ先であることを指定する。  
+  
+-   ドラッグ元に対して、ターゲットの上にドラッグしたときに応答する。  
+  
+-   転送されたデータが受信できる形式であることを確認する。  
+  
+-   ドロップしたデータを処理する。  
+  
+ 要素がドロップ先であることを指定するには、<xref:System.Windows.UIElement.AllowDrop%2A> プロパティを `true` に設定します。  ドロップ先のイベントが要素で発生して、処理できるようになります。  ドラッグ アンド ドロップ操作中に、次の一連のイベントがドロップ先で発生します。  
+  
+1.  <xref:System.Windows.DragDrop.DragEnter>  
+  
+2.  <xref:System.Windows.DragDrop.DragOver>  
+  
+3.  <xref:System.Windows.DragDrop.DragLeave> または <xref:System.Windows.DragDrop.Drop>  
+  
+ <xref:System.Windows.DragDrop.DragEnter> イベントは、データがドロップ先の境界の中にドラッグされるときに発生します。  通常は、アプリケーションに適していれば、ドラッグ アンド ドロップ操作の効果のプレビューを提供するように、このイベントを処理します。  <xref:System.Windows.DragDrop.DragEnter> イベントで <xref:System.Windows.DragEventArgs.Effects%2A?displayProperty=fullName> プロパティを設定しないでください。このプロパティは <xref:System.Windows.DragDrop.DragOver> イベントで上書きされるためです。  
+  
+ 次の例は、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.DragDrop.DragEnter> イベント ハンドラーを示しています。  このコードでは、現在の <xref:System.Windows.Shapes.Shape.Fill%2A> ブラシを保存して、ドラッグ アンド ドロップ操作の効果をプレビューします。  続いて、<xref:System.Windows.DataObject.GetDataPresent%2A> メソッドを使用して、楕円の上にドラッグした <xref:System.Windows.DataObject> に、<xref:System.Windows.Media.Brush> に変換できる文字列データが含まれているかどうかを確認します。   含まれている場合、データは <xref:System.Windows.DataObject.GetData%2A> メソッドによって抽出されます。  その後、データは <xref:System.Windows.Media.Brush> に変換されて、楕円に適用されます。  変更は <xref:System.Windows.DragDrop.DragLeave> イベント ハンドラーで元に戻ります。  データが <xref:System.Windows.Media.Brush> に変換できない場合、アクションは実行されません。  
+  
+ [!code-csharp[DragDropSnippets#DragEnter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragenter)]
+ [!code-vb[DragDropSnippets#DragEnter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragenter)]  
+  
+ <xref:System.Windows.DragDrop.DragOver> イベントは、データがドロップ先の上にドラッグされる間、継続的に発生します。  このイベントはドラッグ元の <xref:System.Windows.DragDrop.GiveFeedback> イベントとペアになります。  <xref:System.Windows.DragDrop.DragOver> イベント ハンドラーでは、通常は <xref:System.Windows.DataObject.GetDataPresent%2A> メソッドと <xref:System.Windows.DataObject.GetData%2A> メソッドを使用して、転送されたデータがドロップ先で処理できる形式であるかどうかを確認します。  また、いずれかの修飾キーが押されたかどうかも確認できます。修飾キーは、通常、ユーザーが移動またはコピー操作を意図しているかどうかを示します。  これらの確認を行った後、<xref:System.Windows.DragEventArgs.Effects%2A?displayProperty=fullName> プロパティを、データをドロップするとどのような効果が起こるかをドラッグ元に通知するように設定します。  ドラッグ元は、<xref:System.Windows.DragDrop.GiveFeedback> のイベント引数でこの情報を受信し、適切なカーソルを設定してユーザーにフィードバックします。  
+  
+ 次の例は、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.DragDrop.DragOver> イベント ハンドラーを示しています。  このコードは、楕円の上にドラッグされている <xref:System.Windows.DataObject> に、<xref:System.Windows.Media.Brush> に変換できる文字列データが含まれているかどうかを確認します。   含まれている場合、<xref:System.Windows.DragEventArgs.Effects%2A?displayProperty=fullName> プロパティを <xref:System.Windows.DragDropEffects> に設定します。  これにより、ドラッグ元に対して、データが楕円にコピーできることを示します。  データが <xref:System.Windows.Media.Brush> に変換できない場合、<xref:System.Windows.DragEventArgs.Effects%2A?displayProperty=fullName> プロパティは <xref:System.Windows.DragDropEffects> に設定されます。  これにより、ドラッグ元に対して、楕円はデータの有効なドロップ先ではないことを示します。  
+  
+ [!code-csharp[DragDropSnippets#DragOver](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragover)]
+ [!code-vb[DragDropSnippets#DragOver](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragover)]  
+  
+ <xref:System.Windows.DragDrop.DragLeave> イベントは、データがドロップされることなくターゲットの境界の外にドラッグされるときに発生します。  このイベントを処理すると、<xref:System.Windows.DragDrop.DragEnter> イベント ハンドラーで行ったことをすべて元に戻すことができます。  
+  
+ 次の例は、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.DragDrop.DragLeave> イベント ハンドラーを示しています。  このコードは、保存された <xref:System.Windows.Media.Brush> を楕円に適用することで、<xref:System.Windows.DragDrop.DragEnter> イベント ハンドラーで行ったプレビュー内容を元に戻します。  
+  
+ [!code-csharp[DragDropSnippets#DragLeave](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#dragleave)]
+ [!code-vb[DragDropSnippets#DragLeave](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#dragleave)]  
+  
+ <xref:System.Windows.DragDrop.Drop> イベントは、データがドロップ先にドロップされると発生します。既定では、これはマウス ボタンが放されたときに発生します。  <xref:System.Windows.DragDrop.Drop> イベント ハンドラーでは、<xref:System.Windows.DataObject.GetData%2A> メソッドを使用して <xref:System.Windows.DataObject> から転送されたデータを抽出し、アプリケーションが必要とするデータ処理を実行します。  <xref:System.Windows.DragDrop.Drop> イベントは、ドラッグ アンド ドロップ操作を終了します。  
+  
+ 次の例は、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.DragDrop.Drop> イベント ハンドラーを示しています。  このコードは、ドラッグ アンド ドロップ操作の効果を適用します。<xref:System.Windows.DragDrop.DragEnter> イベント ハンドラーのコードと似ています。  このコードは、楕円の上にドラッグされている <xref:System.Windows.DataObject> に、<xref:System.Windows.Media.Brush> に変換できる文字列データが含まれているかどうかを確認します。   含まれている場合は、 <xref:System.Windows.Media.Brush> は楕円に適用されます。  データが <xref:System.Windows.Media.Brush> に変換できない場合、アクションは実行されません。  
+  
+ [!code-csharp[DragDropSnippets#Drop](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#drop)]
+ [!code-vb[DragDropSnippets#Drop](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#drop)]  
+  
+## 参照  
+ <xref:System.Windows.Clipboard>   
+ [チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化](../../../../docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/drag-and-drop-how-to-topics.md)   
+ [ドラッグ アンド ドロップ](../../../../docs/framework/wpf/advanced/drag-and-drop.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/drag-and-drop.md b/docs/framework/wpf/advanced/drag-and-drop.md
new file mode 100644
index 00000000000..de7fa646c2a
--- /dev/null
+++ b/docs/framework/wpf/advanced/drag-and-drop.md
@@ -0,0 +1,42 @@
+---
+title: "ドラッグ アンド ドロップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "データ [WPF], ドラッグ アンド ドロップ"
+  - "ドラッグ アンド ドロップ [WPF]"
+  - "ドラッグ アンド ドロップ [WPF]"
+ms.assetid: 77c48920-8c8b-41eb-8fe8-b411962c8623
+caps.latest.revision: 85
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 85
+---
+# ドラッグ アンド ドロップ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のドラッグ アンド ドロップ インフラストラクチャは非常に柔軟性が高く、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内だけでなく、他の [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] アプリケーション内でのデータのドラッグ アンド ドロップもサポートします。  
+  
+## このセクションの内容  
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)  
+ [データとデータ オブジェクト](../../../../docs/framework/wpf/advanced/data-and-data-objects.md)  
+ [チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化](../../../../docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/drag-and-drop-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.DataFormat>  
+ <xref:System.Windows.DataObject>  
+ <xref:System.Windows.DragDrop>  
+ <xref:System.Windows.DragDropEffects>  
+ <xref:System.Windows.DragEventHandler>  
+ <xref:System.Windows.TextDataFormat>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/draw-text-using-glyphs.md b/docs/framework/wpf/advanced/draw-text-using-glyphs.md
new file mode 100644
index 00000000000..019f44a64b2
--- /dev/null
+++ b/docs/framework/wpf/advanced/draw-text-using-glyphs.md
@@ -0,0 +1,36 @@
+---
+title: "グリフを使用したテキストの描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "テキストの描画 (Glyphs オブジェクトで)"
+  - "Glyphs オブジェクト、テキストの描画"
+  - "文字体裁、Glyphs オブジェクト"
+ms.assetid: 587ab17e-a419-4ad5-b6da-8933a8e83d97
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# グリフを使用したテキストの描画
+ここで、低レベルの使用方法について説明<xref:System.Windows.Documents.Glyphs>テキストを表示するオブジェクト[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]します。  
+  
+## <a name="example"></a>例  
+ 次の例は、プロパティを定義する方法を示して、<xref:System.Windows.Documents.Glyphs>オブジェクト[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]します。 <xref:System.Windows.Documents.Glyphs>オブジェクトの出力を表す、 <xref:System.Windows.Media.GlyphRun>で[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。 例では、Arial、Courier New および Times New Roman フォントが、ローカル コンピューター上の C:\WINDOWS\Fonts フォルダーにインストールされているものとします。  
+  
+ [!code-xml[GlyphsOvwSample1#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlyphsOvwSample1/CS/default.xaml#1)]  
+  
+ この例は、その他のプロパティを定義する方法を示します<xref:System.Windows.Documents.Glyphs>内のオブジェクト[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。  
+  
+ [!code-xml[GlyphsOvwSamp2#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlyphsOvwSamp2/CS/default.xaml#1)]  
+  
+## <a name="see-also"></a>関連項目  
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/drawing-formatted-text.md b/docs/framework/wpf/advanced/drawing-formatted-text.md
new file mode 100644
index 00000000000..0b18ebda759
--- /dev/null
+++ b/docs/framework/wpf/advanced/drawing-formatted-text.md
@@ -0,0 +1,138 @@
+---
+title: "書式設定されたテキストの描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "描画, 書式設定テキスト"
+  - "書式設定テキスト [WPF]"
+  - "テキスト [WPF]"
+  - "タイポグラフィ, 描画 (書式設定されたテキストを)"
+ms.assetid: b1d851c1-331c-4814-9964-6fe769db6f1f
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 書式設定されたテキストの描画
+ここでは、<xref:System.Windows.Media.FormattedText> オブジェクトの機能の概要について説明します。  このオブジェクトは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでのテキストの描画に対する低レベルの制御を提供します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="technology_overview"></a>   
+## テクノロジの概要  
+ <xref:System.Windows.Media.FormattedText> オブジェクトを使用すると、複数行のテキストを描画できます。このテキストでは、テキスト内の各文字を個々に書式設定できます。  複数の書式が適用されたテキストを次の例に示します。  
+  
+ ![FormattedText オブジェクトを使用して表示されるテキスト](../../../../docs/framework/wpf/advanced/media/formattedtext01.png "FormattedText01")  
+FormattedText メソッドを使用して表示されたテキスト  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] API から移行する開発者のために、「[Win32 の移行](#win32_migration)」の表に [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText フラグと [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] におけるほぼ同等のものを示します。  
+  
+### 書式設定されたテキストを使用する理由  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、画面にテキストを描画するための複数のコントロールが含まれています。  各コントロールは、異なるシナリオを対象にしており、それぞれに一連の機能と制限があります。  一般的に、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] で短い文を使用するなど、限定的なテキストのサポートが必要な場合は、<xref:System.Windows.Controls.TextBlock> 要素を使用する必要があります。  最小限のテキスト サポートが必要な場合には、<xref:System.Windows.Controls.Label> を使用できます。  詳細については、「[WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.FormattedText> オブジェクトは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] テキスト コントロールよりも強力なテキスト書式設定機能を提供し、テキストを装飾的要素として使用する場合に役立ちます。詳細については、後の「[書式設定されたテキストのジオメトリへの変換](#converting_formatted_text)」を参照してください。  
+  
+ また、<xref:System.Windows.Media.FormattedText> オブジェクトは、テキスト指向の <xref:System.Windows.Media.DrawingVisual> 派生オブジェクトを作成する場合に役立ちます。  <xref:System.Windows.Media.DrawingVisual> は、図形、イメージ、またはテキストのレンダリングに使用する軽量の描画クラスです。  詳細については、[DrawingVisuals を使用したヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159994)を参照してください。  
+  
+<a name="using_the_formattedtext_object"></a>   
+## FormattedText オブジェクトの使用  
+ 書式設定されたテキストを作成するには、<xref:System.Windows.Media.FormattedText.%23ctor%2A> コンストラクターを呼び出して <xref:System.Windows.Media.FormattedText> オブジェクトを作成します。  最初の書式設定済みテキスト文字列を作成したら、書式スタイルの範囲を適用できます。  
+  
+ テキストを特定の幅に制限するには、<xref:System.Windows.Media.FormattedText.MaxTextWidth%2A> プロパティを使用します。  テキストは、指定された幅を超えないように自動的に折り返されます。  テキストを特定の高さに制限するには、<xref:System.Windows.Media.FormattedText.MaxTextHeight%2A> プロパティを使用します。  テキストは、指定された高さを超えた部分に省略記号 "…" を表示します。  
+  
+ ![FormattedText オブジェクトを使用して表示されるテキスト](../../../../docs/framework/wpf/advanced/media/formattedtext02.png "FormattedText02")  
+折り返しと省略記号を示す表示テキスト  
+  
+ 複数の書式スタイルを 1 つ以上の文字に適用できます。  たとえば、<xref:System.Windows.Media.FormattedText.SetFontSize%2A> メソッドと <xref:System.Windows.Media.FormattedText.SetForegroundBrush%2A> メソッドの両方を呼び出して、テキストの最初の 5 文字の書式設定を変更できます。  
+  
+ <xref:System.Windows.Media.FormattedText> オブジェクトを作成し、複数の書式設定スタイルをテキストに適用するコード例を次に示します。  
+  
+ [!code-csharp[FormattedTextSnippets#FormattedTextSnippets1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FormattedTextSnippets/CSharp/Window1.xaml.cs#formattedtextsnippets1)]
+ [!code-vb[FormattedTextSnippets#FormattedTextSnippets1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FormattedTextSnippets/visualbasic/window1.xaml.vb#formattedtextsnippets1)]  
+  
+### フォント サイズの測定単位  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションの他のテキスト オブジェクトと同様に、<xref:System.Windows.Media.FormattedText> オブジェクトでは、測定単位としてデバイス非依存ピクセルが使用されます。  ただし、ほとんどの [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] アプリケーションでは、測定単位としてポイントが使用されます。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでポイント単位の表示テキストを使用する場合は、[!INCLUDE[TLA#tla_dipixel#plural](../../../../includes/tlasharptla-dipixelsharpplural-md.md)] をポイントに変換する必要があります。  この変換を実行する方法を次のコード例に示します。  
+  
+ [!code-csharp[FormattedTextSnippets#FormattedTextSnippets2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FormattedTextSnippets/CSharp/Window1.xaml.cs#formattedtextsnippets2)]
+ [!code-vb[FormattedTextSnippets#FormattedTextSnippets2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FormattedTextSnippets/visualbasic/window1.xaml.vb#formattedtextsnippets2)]  
+  
+<a name="converting_formatted_text"></a>   
+### 書式設定されたテキストのジオメトリへの変換  
+ 書式設定したテキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換し、人の目をひきつける他の種類のテキストを作成することができます。  たとえば、テキスト文字列のアウトラインに基づいて <xref:System.Windows.Media.Geometry> オブジェクトを作成できます。  
+  
+ ![線形グラデーション ブラシを使用するテキスト アウトライン](../../../../docs/framework/wpf/advanced/media/outlinedtext02.png "OutlinedText02")  
+線形グラデーション ブラシを使用したテキスト アウトライン  
+  
+ 変換されたテキストのストローク、塗りつぶし、および強調表示を変更して、人の目をひく視覚効果を作成するいくつかの方法を次の例に示します。  
+  
+ ![塗りつぶしとストロークに別の色を使用するテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext03.png "OutlinedText03")  
+ストロークおよび塗りつぶしを別々の色に設定した例  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext04.png "OutlinedText04")  
+ストロークに適用したイメージ ブラシの例  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext05.png "OutlinedText05")  
+ストロークおよび強調表示に適用したイメージ ブラシの例  
+  
+ テキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換すると、テキストは文字の集まりではなくなります。つまり、文字列内の文字を変更することはできません。  ただし、変換されたテキストのストロークおよび塗りつぶしのプロパティを変更することで、テキストの外観を変えることができます。  ストロークは、変換したテキストのアウトラインを参照します。塗りつぶしは、変換したテキストのアウトラインの内側の領域を参照します。  詳細については、「[中抜きの文字列を作成する](../../../../docs/framework/wpf/advanced/how-to-create-outlined-text.md)」を参照してください。  
+  
+ 書式設定されたテキストを <xref:System.Windows.Media.PathGeometry> オブジェクトに変換し、そのオブジェクトをテキストの強調表示に使用することもできます。  たとえば、<xref:System.Windows.Media.PathGeometry> オブジェクトに 1 つのアニメーションを適用することができ、これによりアニメーションは書式設定されたテキストのアウトラインに従うようになります。  
+  
+ 次の例は、<xref:System.Windows.Media.PathGeometry> オブジェクトに変換された書式付きテキストを示しています。  アニメーション化された楕円は、レンダリングされたテキストのストロークのパスに従います。  
+  
+ ![テキストのパス ジオメトリに続く球](../../../../docs/framework/wpf/advanced/media/textpathgeometry01.png "TextPathGeometry01")  
+テキストのパス図形座標に従う球体  
+  
+ 詳細については、「[How to: Create a PathGeometry Animation for Text](http://msdn.microsoft.com/ja-jp/29f8051e-798a-463f-a926-a099a99e9c67)」を参照してください。  
+  
+ 書式設定したテキストを <xref:System.Windows.Media.PathGeometry> オブジェクトに変換したら、他の有意義な効果を作成することができます。  たとえば、ビデオをクリップしてテキスト内に表示することができます。  
+  
+ ![テキストのパス ジオメトリに表示されるビデオ](../../../../docs/framework/wpf/advanced/media/videotextdemo01.png "VideoTextDemo01")  
+テキストのパス図形座標に表示されるビデオ  
+  
+<a name="win32_migration"></a>   
+## Win32 の移行  
+ テキストを描画するための <xref:System.Windows.Media.FormattedText> の機能は、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText 関数の機能に似ています。  [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] API から移行する開発者のために、次の表に [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText フラグと [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] におけるほぼ同等のものを示します。  
+  
+|DrawText フラグ|同等の WPF 操作|説明|  
+|------------------|----------------|--------|  
+|DT\_BOTTOM|<xref:System.Windows.Media.FormattedText.Height%2A>|適切な [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText の 'y' 位置を計算するには、<xref:System.Windows.Media.FormattedText.Height%2A> プロパティを使用します。|  
+|DT\_CALCRECT|<xref:System.Windows.Media.FormattedText.Height%2A>, <xref:System.Windows.Media.FormattedText.Width%2A>|出力四角形を計算するには、<xref:System.Windows.Media.FormattedText.Height%2A> プロパティおよび <xref:System.Windows.Media.FormattedText.Width%2A> プロパティを使用します。|  
+|DT\_CENTER|<xref:System.Windows.Media.FormattedText.TextAlignment%2A>|<xref:System.Windows.Media.FormattedText.TextAlignment%2A> プロパティを使用して値を <xref:System.Windows.TextAlignment> に設定します。|  
+|DT\_EDITCONTROL|なし|必要ありません。  スペースの幅および最後の行のレンダリングは、フレームワークのエディット コントロールと同じです。|  
+|DT\_END\_ELLIPSIS|<xref:System.Windows.Media.FormattedText.Trimming%2A>|<xref:System.Windows.Media.FormattedText.Trimming%2A> プロパティを使用して値を <xref:System.Windows.TextTrimming> に設定します。<br /><br /> <xref:System.Windows.TextTrimming> を使用して、DT\_WORD\_ELIPSIS の末尾の省略記号が設定された [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DT\_END\_ELLIPSIS を取得します。この場合、省略記号は 1 行に収まらない単語にのみ表示されます。|  
+|DT\_EXPAND\_TABS|なし|必要ありません。  タブは自動的に全角 4 文字分ごとに展開されます。これは、言語非依存文字の約 8 文字分の幅です。|  
+|DT\_EXTERNALLEADING|なし|必要ありません。  外部レディングは、常に行間隔に含まれます。  <xref:System.Windows.Media.FormattedText.LineHeight%2A> プロパティを使用して、ユーザー定義の行間隔を作成します。|  
+|DT\_HIDEPREFIX|なし|サポートされていません。  <xref:System.Windows.Media.FormattedText> オブジェクトを構築する前に、文字列から '&' を削除します。|  
+|DT\_LEFT|<xref:System.Windows.Media.FormattedText.TextAlignment%2A>|これは、テキストの配置の既定値です。  <xref:System.Windows.Media.FormattedText.TextAlignment%2A> プロパティを使用して値を <xref:System.Windows.TextAlignment> に設定します   \(WPF のみ\)。|  
+|DT\_MODIFYSTRING|なし|サポートされていません。|  
+|DT\_NOCLIP|<xref:System.Windows.Media.Visual.VisualClip%2A>|クリッピングは自動的には行われません。  テキストをクリップする場合は、<xref:System.Windows.Media.Visual.VisualClip%2A> プロパティを使用します。|  
+|DT\_NOFULLWIDTHCHARBREAK|なし|サポートされていません。|  
+|DT\_NOPREFIX|なし|必要ありません。  文字列内の '&' 文字は、常に通常の文字として扱われます。|  
+|DT\_PATHELLIPSIS|なし|<xref:System.Windows.Media.FormattedText.Trimming%2A> プロパティを使用して値を <xref:System.Windows.TextTrimming> に設定します。|  
+|DT\_PREFIX|なし|サポートされていません。  アクセラレータ キーやリンクなどのテキストにアンダースコアを使用する場合は、<xref:System.Windows.Media.FormattedText.SetTextDecorations%2A> メソッドを使用します。|  
+|DT\_PREFIXONLY|なし|サポートされていません。|  
+|DT\_RIGHT|<xref:System.Windows.Media.FormattedText.TextAlignment%2A>|<xref:System.Windows.Media.FormattedText.TextAlignment%2A> プロパティを使用して値を <xref:System.Windows.TextAlignment> に設定します   \(WPF のみ\)。|  
+|DT\_RTLREADING|<xref:System.Windows.Media.FormattedText.FlowDirection%2A>|<xref:System.Windows.Media.FormattedText.FlowDirection%2A> プロパティを <xref:System.Windows.FlowDirection> に設定します。|  
+|DT\_SINGLELINE|なし|必要ありません。  <xref:System.Windows.Media.FormattedText.MaxTextWidth%2A> プロパティが設定されていない場合、またはテキストに改行コード \(CR\/LF\) が含まれていない場合、<xref:System.Windows.Media.FormattedText> オブジェクトは単一行コントロールとして動作します。|  
+|DT\_TABSTOP|なし|ユーザー定義のタブ位置はサポートされていません。|  
+|DT\_TOP|<xref:System.Windows.Media.FormattedText.Height%2A>|必要ありません。  上端揃えが既定値です。  その他の垂直方向の配置の値を定義するには、<xref:System.Windows.Media.FormattedText.Height%2A> プロパティを使用して、適切な [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText の 'y' 位置を計算します。|  
+|DT\_VCENTER|<xref:System.Windows.Media.FormattedText.Height%2A>|適切な [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] DrawText の 'y' 位置を計算するには、<xref:System.Windows.Media.FormattedText.Height%2A> プロパティを使用します。|  
+|DT\_WORDBREAK|なし|必要ありません。  単語の区切りは、<xref:System.Windows.Media.FormattedText> オブジェクトで自動的に行われます。  無効にすることはできません。|  
+|DT\_WORD\_ELLIPSIS|<xref:System.Windows.Media.FormattedText.Trimming%2A>|<xref:System.Windows.Media.FormattedText.Trimming%2A> プロパティを使用して値を <xref:System.Windows.TextTrimming> に設定します。|  
+  
+## 参照  
+ <xref:System.Windows.Media.FormattedText>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [中抜きの文字列を作成する](../../../../docs/framework/wpf/advanced/how-to-create-outlined-text.md)   
+ [How to: Create a PathGeometry Animation for Text](http://msdn.microsoft.com/ja-jp/29f8051e-798a-463f-a926-a099a99e9c67)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/dynamicresource-markup-extension.md b/docs/framework/wpf/advanced/dynamicresource-markup-extension.md
new file mode 100644
index 00000000000..36e7699979e
--- /dev/null
+++ b/docs/framework/wpf/advanced/dynamicresource-markup-extension.md
@@ -0,0 +1,89 @@
+---
+title: "DynamicResource のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "DynamicResource"
+  - "DynamicResourceExtension"
+helpviewer_keywords: 
+  - "DynamicResource のマークアップ拡張機能"
+  - "XAML, DynamicResource マークアップ拡張機能"
+ms.assetid: 7324f243-03af-4c2b-b0db-26ac6cdfcbe4
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# DynamicResource のマークアップ拡張機能
+定義されたリソースに対する参照になる値を優先させることによって、任意の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロパティ属性の値を指定します。  そのリソースに関する検索動作は、実行時検索に似ています。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{DynamicResource key}" .../>  
+```  
+  
+## XAML プロパティ要素の使用方法  
+  
+```  
+<object>  
+  <object.property>  
+    <DynamicResource ResourceKey="key" .../>  
+  </object.property>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`key`|要求したリソースのキー。  リソースがマークアップで作成された場合、このキーは [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)によって最初に割り当てられたものです。リソースがコードで作成された場合は、<xref:System.Windows.ResourceDictionary.Add%2A?displayProperty=fullName> を呼び出すときに `key` パラメーターで指定されたものです。|  
+  
+## 解説  
+ `DynamicResource` は、初期コンパイル中に一時的な式を作成し、それによって、要求されたリソース値がオブジェクトを構成するために実際に必要になるまで、リソースに関する検索を遅延します。  これは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページが読み込まれた後になる可能性があります。  リソース値は、すべてのアクティブなリソース ディクショナリに対して、現在のページ スコープを開始点としてキー検索を実行することで検出され、コンパイル時に設定されたプレースホルダー式と置き換えられます。  
+  
+> [!IMPORTANT]
+>  依存関係プロパティの優先順位という点では、`DynamicResource` 式は、動的リソース参照が適用される位置と同じになります。  以前に `DynamicResource` 式をローカル値として持っていたプロパティにローカル値を設定すると、`DynamicResource` は完全に削除されます。  詳細については、「[依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)」を参照してください。  
+  
+ ある種のリソース アクセス シナリオは、[StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)とは対照的に、`DynamicResource` に特に適しています。  `DynamicResource` と `StaticResource` のメリットの比較、およびパフォーマンスへの影響の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ 指定した <xref:System.Windows.DynamicResourceExtension.ResourceKey%2A> は、ページ、アプリケーション、使用可能なコントロール テーマと外部リソース、またはシステム リソースで [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)によって指定された既存のリソースに対応するキーでなければなりません。また、リソースのルックアップはキーの指定順に行われます。  静的リソースと動的リソースのリソース検索の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ リソース キーは、[XamlName の文法](../../../../docs/framework/xaml-services/xamlname-grammar.md)で定義されている任意の文字列にすることができます。  <xref:System.Type> などの他のオブジェクト型にすることもできます。  <xref:System.Type> キーは、コントロールをテーマごとにどのようにデザインするかを決定するのに重要です。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+ リソース値の検索に使用する <xref:System.Windows.FrameworkElement.FindResource%2A> などの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、`DynamicResource` で使用されるものと同じリソース検索ロジックに従います。  
+  
+ これとは別の、リソース参照の宣言的手段には、[StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)を使用する方法があります。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `DynamicResource` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.DynamicResourceExtension> 拡張クラスの <xref:System.Windows.DynamicResourceExtension.ResourceKey%2A> 値として割り当てられます。  
+  
+ `DynamicResource` は、オブジェクト要素構文で使用できます。  この場合、<xref:System.Windows.DynamicResourceExtension.ResourceKey%2A> プロパティの値の指定は必須です。  
+  
+ `DynamicResource` は、<xref:System.Windows.DynamicResourceExtension.ResourceKey%2A> プロパティをプロパティおよび値のペアとして指定する詳細出力属性使用でも使用できます。  
+  
+```  
+<object property="{DynamicResource ResourceKey=key}" .../>  
+```  
+  
+ 詳細出力の使用は、複数の設定可能プロパティを持つ拡張機能や、一部のプロパティがオプションである場合に役立ちます。  `DynamicResource` には、必須の設定可能プロパティが 1 つしか存在しないため、このような詳細出力の使用は一般的ではありません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサ実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.DynamicResourceExtension> クラスによって定義されます。  
+  
+ `DynamicResource` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のすべてのマークアップ拡張機能では、それぞれの属性構文で { と } の 2 つの記号を使用します。これは規約であり、これに従って [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [リソースとコード](../../../../docs/framework/wpf/advanced/resources-and-code.md)   
+ [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/element-tree-and-serialization-how-to-topics.md b/docs/framework/wpf/advanced/element-tree-and-serialization-how-to-topics.md
new file mode 100644
index 00000000000..9f3bf41b0db
--- /dev/null
+++ b/docs/framework/wpf/advanced/element-tree-and-serialization-how-to-topics.md
@@ -0,0 +1,38 @@
+---
+title: "要素のツリーおよびシリアル化に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "要素ツリー"
+  - "シリアル化"
+ms.assetid: 2d8ef436-d559-4c3e-86de-5a160d5f87d2
+caps.latest.revision: 74
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 74
+---
+# 要素のツリーおよびシリアル化に関する「方法」トピック
+このセクションのトピックでは、WPF 要素ツリーの使用方法について説明します。  
+  
+## このセクションの内容  
+ [要素を名前で検索する](../../../../docs/framework/wpf/advanced/how-to-find-an-element-by-its-name.md)  
+ [論理ツリーをオーバーライドする](../../../../docs/framework/wpf/advanced/how-to-override-the-logical-tree.md)  
+  
+## 関連項目  
+ <xref:System.Windows.LogicalTreeHelper>  
+  
+ <xref:System.Windows.Media.VisualTreeHelper>  
+  
+ <xref:System.Windows.Markup>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/element-tree-and-serialization.md b/docs/framework/wpf/advanced/element-tree-and-serialization.md
new file mode 100644
index 00000000000..077fbcd0fe3
--- /dev/null
+++ b/docs/framework/wpf/advanced/element-tree-and-serialization.md
@@ -0,0 +1,50 @@
+---
+title: "要素のツリーおよびシリアル化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "要素ツリー"
+  - "シリアル化"
+  - "ツリー [WPF]"
+ms.assetid: 8f57e879-180b-421f-b3d0-ac007ff2ce80
+caps.latest.revision: 71
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# 要素のツリーおよびシリアル化
+WPF プログラミングの各要素は、多くの場合、ある種の相互ツリー リレーションシップにあります。  たとえば、XAML で作成するアプリケーション UI は、オブジェクト ツリーとして概念化できます。  要素のツリーはさらに、[論理ツリー](GTMT)と[ビジュアル ツリー](GTMT)という 2 つのツリーに分割できます。これらのツリーは異なるものですが、同時に並列関係である場合もありまます。  WPF でのシリアル化には、これら 2 つのツリーの状態およびアプリケーション状態の保存と、ファイル \(通常は XAML\) へのその書き込みが含まれます。  
+  
+## このセクションの内容  
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)  
+ [XamlWriter.Save のシリアル化の制限](../../../../docs/framework/wpf/advanced/serialization-limitations-of-xamlwriter-save.md)  
+ [オブジェクト ツリーに存在しないオブジェクト要素の初期化](../../../../docs/framework/wpf/advanced/initialization-for-object-elements-not-in-an-object-tree.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/element-tree-and-serialization-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Markup>  
+  
+ <xref:System.Windows.LogicalTreeHelper>  
+  
+ <xref:System.Windows.Media.VisualTreeHelper>  
+  
+## 関連項目  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [WPF の XAML](../../../../docs/framework/wpf/advanced/xaml-in-wpf.md)  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)  
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)  
+ [イベント](../../../../docs/framework/wpf/advanced/events-wpf.md)  
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)  
+ [リソース](../../../../docs/framework/wpf/advanced/resources-wpf.md)  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/events-how-to-topics.md b/docs/framework/wpf/advanced/events-how-to-topics.md
new file mode 100644
index 00000000000..b574b5a9d4d
--- /dev/null
+++ b/docs/framework/wpf/advanced/events-how-to-topics.md
@@ -0,0 +1,40 @@
+---
+title: "イベントに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "イベント, 方法トピック"
+ms.assetid: 00463181-36eb-4be0-bfa2-452854cce642
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# イベントに関する「方法」トピック
+このセクションのトピックでは、WPF でイベントを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [コードを使用してイベント ハンドラーを追加する](../../../../docs/framework/wpf/advanced/how-to-add-an-event-handler-using-code.md)  
+ [ルーティング イベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-a-routed-event.md)  
+ [カスタム ルーティング イベントを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md)  
+ [イベント ハンドラーでソース要素を検索する](../../../../docs/framework/wpf/advanced/how-to-find-the-source-element-in-an-event-handler.md)  
+ [ルーティング イベントのクラス処理を追加する](../../../../docs/framework/wpf/advanced/how-to-add-class-handling-for-a-routed-event.md)  
+  
+## 関連項目  
+ <xref:System.Windows.RoutedEvent>  
+  
+ <xref:System.Windows.EventManager>  
+  
+ <xref:System.Windows.RoutingStrategy>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/events-wpf.md b/docs/framework/wpf/advanced/events-wpf.md
new file mode 100644
index 00000000000..a38c1be9081
--- /dev/null
+++ b/docs/framework/wpf/advanced/events-wpf.md
@@ -0,0 +1,56 @@
+---
+title: "イベント (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "イベント, ウィンドウ"
+  - "Windows Presentation Foundation, イベント"
+  - "WPF, イベント"
+ms.assetid: d3b93c6f-aa6b-486d-a010-d097ea8a516b
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 72
+---
+# イベント (WPF)
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、アプリケーションの要素ツリー内のさまざまなリスナー上に存在するハンドラーを呼び出すことができる[ルーティング イベント](GTMT)が導入されています。  
+  
+## このセクションの内容  
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)  
+ [添付イベントの概要](../../../../docs/framework/wpf/advanced/attached-events-overview.md)  
+ [オブジェクトの有効期間イベント](../../../../docs/framework/wpf/advanced/object-lifetime-events.md)  
+ [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)  
+ [プレビュー イベント](../../../../docs/framework/wpf/advanced/preview-events.md)  
+ [プロパティ変更イベント](../../../../docs/framework/wpf/advanced/property-change-events.md)  
+ [Visual Basic と WPF のイベント処理](../../../../docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md)  
+ [弱いイベント パターン](../../../../docs/framework/wpf/advanced/weak-event-patterns.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/events-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.RoutedEvent>  
+  
+ <xref:System.Windows.EventManager>  
+  
+ <xref:System.Windows.RoutingStrategy>  
+  
+## 関連項目  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [WPF の XAML](../../../../docs/framework/wpf/advanced/xaml-in-wpf.md)  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)  
+ [要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)  
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)  
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)  
+ [リソース](../../../../docs/framework/wpf/advanced/resources-wpf.md)  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ [WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)  
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md b/docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md
new file mode 100644
index 00000000000..457b5d99435
--- /dev/null
+++ b/docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md
@@ -0,0 +1,50 @@
+---
+title: "フロー コンテンツ要素に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ドキュメント, フロー コンテンツ参照"
+  - "フロー コンテンツ要素 [WPF], 方法トピック"
+ms.assetid: ef5175df-6ab9-4096-be0c-804003b44c64
+caps.latest.revision: 62
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 62
+---
+# フロー コンテンツ要素に関する「方法」トピック
+このセクションのトピックでは、さまざまなフロー コンテンツ要素とその関連する機能を使用して一般的なタスクを行う方法について説明します。  
+  
+## このセクションの内容  
+ [段落間の間隔を調整する](../../../../docs/framework/wpf/advanced/how-to-adjust-spacing-between-paragraphs.md)  
+ [プログラムによってテーブルをビルドする](../../../../docs/framework/wpf/advanced/how-to-build-a-table-programmatically.md)  
+ [プログラムによってコンテンツの FlowDirection を変更する](../../../../docs/framework/wpf/advanced/how-to-change-the-flowdirection-of-content-programmatically.md)  
+ [TextWrapping プロパティをプログラムにより変更する](../../../../docs/framework/wpf/advanced/how-to-change-the-textwrapping-property-programmatically.md)  
+ [XAML を使用してテーブルを定義する](../../../../docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md)  
+ [テキストの文字体裁を変更する](../../../../docs/framework/wpf/advanced/how-to-alter-the-typography-of-text.md)  
+ [テキストのトリミングを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-text-trimming.md)  
+ [プログラムでテキストに要素を挿入する](../../../../docs/framework/wpf/advanced/how-to-insert-an-element-into-text-programmatically.md)  
+ [Blocks プロパティを介してフロー コンテンツ要素を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-blocks-property.md)  
+ [Inlines プロパティを介してフロー コンテンツ要素を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-inlines-property.md)  
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)  
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)  
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)  
+ [フロー コンテンツ要素を使用する](../../../../docs/framework/wpf/advanced/how-to-use-flow-content-elements.md)  
+ [FlowDocument の列区切り属性を使用する](../../../../docs/framework/wpf/advanced/how-to-use-flowdocument-column-separating-attributes.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Documents.FlowDocument>  
+ <xref:System.Windows.Documents.Block>  
+ <xref:System.Windows.Documents.Inline>  
+  
+## 関連項目  
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/flow-content.md b/docs/framework/wpf/advanced/flow-content.md
new file mode 100644
index 00000000000..3b0af716694
--- /dev/null
+++ b/docs/framework/wpf/advanced/flow-content.md
@@ -0,0 +1,49 @@
+---
+title: "フロー コンテンツ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ドキュメント, フロー コンテンツ参照"
+  - "フロー コンテンツ参照"
+ms.assetid: d32501af-0bac-4b80-8a20-61a6996753fe
+caps.latest.revision: 70
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# フロー コンテンツ
+フロー コンテンツ要素は、<xref:System.Windows.Documents.FlowDocument> でホストするのに適したフロー コンテンツを作成するためのビルド ブロックを提供します。  
+  
+## このセクションの内容  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)  
+ [TextElement コンテンツ モデルの概要](../../../../docs/framework/wpf/advanced/textelement-content-model-overview.md)  
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Documents.FlowDocument>  
+ <xref:System.Windows.Documents.Block>  
+ <xref:System.Windows.Documents.List>  
+ <xref:System.Windows.Documents.Paragraph>  
+ <xref:System.Windows.Documents.Section>  
+ <xref:System.Windows.Documents.Table>  
+ <xref:System.Windows.Documents.Figure>  
+ <xref:System.Windows.Documents.Floater>  
+ <xref:System.Windows.Documents.Hyperlink>  
+ <xref:System.Windows.Documents.Inline>  
+ <xref:System.Windows.Documents.Run>  
+ <xref:System.Windows.Documents.Span>  
+ <xref:System.Windows.Documents.ListItem>  
+  
+## 関連項目  
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/flow-document-overview.md b/docs/framework/wpf/advanced/flow-document-overview.md
new file mode 100644
index 00000000000..051173837ca
--- /dev/null
+++ b/docs/framework/wpf/advanced/flow-document-overview.md
@@ -0,0 +1,364 @@
+---
+title: "フロー ドキュメントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテンツ スキーマ"
+  - "ドキュメント, フロー ドキュメント"
+  - "フロー コンテンツ要素 [WPF], フロー ドキュメント"
+  - "フロー ドキュメント"
+ms.assetid: ef236a50-d44f-43c8-ba7c-82b0c733c0b7
+caps.latest.revision: 39
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# フロー ドキュメントの概要
+フロー ドキュメントは、表示と読みやすさを最適化するように設計されたドキュメントです。  フロー ドキュメントは、1 つの定義済みのレイアウトに設定するのではなく、ウィンドウのサイズ、デバイスの解像度、省略可能なユーザー設定など、ランタイム変数に基づいてコンテンツを動的に調整したり再配置したりします。  また、フロー ドキュメントは、改ページ位置の自動修正や列などの高度なドキュメント機能を提供します。  ここでは、フロー ドキュメントの概要およびフロー ドキュメントの作成方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="what_is_a_flow_document"></a>   
+## フロー ドキュメントとは  
+ フロー ドキュメントは、ウィンドウ サイズ、デバイスの解像度、およびその他の環境変数に応じて "コンテンツを再配置" するために設計されています。  また、フロー ドキュメントには、検索、読みやすさを最適化するモードの表示、およびフォントのサイズと外観を変更する機能を含むさまざまな組み込み済みの機能があります。  フロー ドキュメントは、主なドキュメントの使用シナリオが読みやすさである場合に最適です。  これに対し、固定ドキュメントは、静的なプレゼンテーションを行うように設計されています。  ソース コンテンツの忠実性が重要である場合は、固定ドキュメントが適しています。  各種ドキュメントの詳細については、「[WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)」を参照してください。  
+  
+ さまざまなサイズの複数のウィンドウで表示されるサンプルのフロー ドキュメントを次の図に示します。  表示領域が変わると、コンテンツはスペースを最大限に利用できるように再配置されます。  
+  
+ ![フロー ドキュメントの内容のフロー変更](../../../../docs/framework/wpf/advanced/media/edocs-flowdocument.png "eDocs\_FlowDocument")  
+  
+ 上のイメージに示すように、フロー コンテンツには、段落、リスト、図などの複数のコンポーネントを含めることができます。  これらのコンポーネントは、マークアップでの要素と手順コードでのオブジェクトに対応します。  これらのクラスの詳細については、この概要の「[フロー関連のクラス](#flow_related_classes)」でもう一度説明します。  ここでは、太字テキストとリストが含まれている段落で構成されているフロー ドキュメントを作成する単純なコード例を示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SimpleFlowExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/SimpleFlowExample.xaml#simpleflowexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#SimpleFlowCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/SimpleFlowExample.cs#simpleflowcodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#SimpleFlowCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/SimpleFlowExample.vb#simpleflowcodeonlyexamplewholepage)]  
+  
+ 次の図は、このコード スニペットの結果を示したものです。  
+  
+ ![スクリーンショット: 表示される FlowDocument の例](../../../../docs/framework/wpf/advanced/media/flow-ovw-first-example.png "Flow\_Ovw\_First\_Example")  
+  
+ この例では、<xref:System.Windows.Controls.FlowDocumentReader> コントロールはフロー コンテンツをホストするために使用されています。  コントロールをホストしているフロー コンテンツの詳細については、「[フロー ドキュメントの種類](#flow_document_types)」を参照してください。  <xref:System.Windows.Documents.Paragraph>、<xref:System.Windows.Documents.List>、<xref:System.Windows.Documents.ListItem>、および <xref:System.Windows.Documents.Bold> 要素は、マークアップでの順序に基づいて、コンテンツの書式設定を制御するために使用されます。  たとえば、<xref:System.Windows.Documents.Bold> 要素は、段落内のテキストの部分のみにまたがっています。結果として、その部分のみが太字のテキストになります。  HTML を使用したことがある場合、これは慣れ親しまれているでしょう。  
+  
+ 上の図が示すように、フロー ドキュメントには、いくつかの機能が組み込まれています。  
+  
+-   検索 : ユーザーがドキュメント全体のフルテキスト検索を実行できるようにします。  
+  
+-   表示モード : ユーザーは、単一ページ \(一度に 1 ページ\) 表示モード、2 ページ \(読書形式\) 表示モード、および連続したスクロール \(ボトムレス\) 表示モードなど、各自に適切な表示モードを選択できます。  これらの表示モードの詳細については、<xref:System.Windows.Controls.FlowDocumentReaderViewingMode> を参照してください。  
+  
+-   ページ ナビゲーション コントロール : ドキュメントの表示モードでページを使用する場合、ページ ナビゲーション コントロールには、次のページへのジャンプ用ボタン \(下向き矢印\)、前のページへのジャンプ用ボタン \(上向き矢印\)、および現在のページ番号と総ページ数のインジケーターが含まれます。  ページ間の移動は、キーボードの方向キーを使用して行うこともできます。  
+  
+-   ズーム : ユーザーはプラス \(\+\) ボタンまたはマイナス \(\-\) ボタンをクリックして、ズーム レベルを上げたり下げたりできます。  ズーム コントロールには、ズーム レベルの調整用スライダーも含まれます。  詳細については、「<xref:System.Windows.Controls.FlowDocumentReader.Zoom%2A>」を参照してください。  
+  
+ これらの機能は、フロー コンテンツをホストするために使用されるコントロールに基づいて変更できます。  次のセクションでは、さまざまなコントロールについて説明します。  
+  
+<a name="flow_document_types"></a>   
+## フロー ドキュメントの種類  
+ フロー ドキュメント コンテンツの表示、およびそれがどのように表示されるかは、どのようなオブジェクトがフロー コンテンツをホストするために使用されるかに依存します。  <xref:System.Windows.Controls.FlowDocumentReader>, <xref:System.Windows.Controls.FlowDocumentPageViewer>、<xref:System.Windows.Controls.RichTextBox>、および <xref:System.Windows.Controls.FlowDocumentScrollViewer> の 4 つのコントロールがフロー コンテンツの表示をサポートします。  これらのコントロールについて、以下に簡単に説明します。  
+  
+ **メモ :**  <xref:System.Windows.Documents.FlowDocument> はフロー コントロールを直接ホストするために必要であるため、これらのすべての表示コントロールでは <xref:System.Windows.Documents.FlowDocument> を使用してフロー コンテンツのホストを可能にします。  
+  
+### FlowDocumentReader  
+ <xref:System.Windows.Controls.FlowDocumentReader> には、単一ページ \(一度に 1 ページ\) 表示モード、2 ページ \(読書形式\) 表示モード、連続スクロール \(ボトムレス\) 表示モードなど、さまざまな表示モードをユーザーが動的に選択できるようにするための機能が用意されています。  これらの表示モードの詳細については、<xref:System.Windows.Controls.FlowDocumentReaderViewingMode> を参照してください。  表示モードを動的に切り替える必要がない場合は、<xref:System.Windows.Controls.FlowDocumentPageViewer> および <xref:System.Windows.Controls.FlowDocumentScrollViewer> を使用すると便利です。これらは、特定の表示モードに固定された軽量のコンテンツ ビューアーです。  
+  
+### FlowDocumentPageViewer と FlowDocumentScrollViewer  
+ <xref:System.Windows.Controls.FlowDocumentPageViewer> は、コンテンツを一度に 1 ページずつ表示し、<xref:System.Windows.Controls.FlowDocumentScrollViewer> はコンテンツを連続したスクロール モードで表示します。  <xref:System.Windows.Controls.FlowDocumentPageViewer> および <xref:System.Windows.Controls.FlowDocumentScrollViewer> は、いずれも特定の表示モードに固定されています。  <xref:System.Windows.Controls.FlowDocumentReader> と比較してください。このリーダーでは、<xref:System.Windows.Controls.FlowDocumentReaderViewingMode> 列挙体により各種表示モードを動的に切り替えることができますが、<xref:System.Windows.Controls.FlowDocumentPageViewer> や <xref:System.Windows.Controls.FlowDocumentScrollViewer> よりも多くのリソースを消費します。  
+  
+ 既定では、垂直スクロール バーは常に表示され、水平スクロール バーは必要に応じて表示されます。  <xref:System.Windows.Controls.FlowDocumentScrollViewer> の既定の UI にはツール バーが含まれませんが、<xref:System.Windows.Controls.FlowDocumentScrollViewer.IsToolBarVisible%2A> プロパティを使用して組み込みツール バーを有効にできます。  
+  
+### RichTextBox  
+ ユーザーがフロー コンテンツを編集できるようにする場合は、<xref:System.Windows.Controls.RichTextBox> を使用します。  たとえば、表、斜体や太字の書式設定などをユーザーが操作できるようにするエディターを作成する必要がある場合は、<xref:System.Windows.Controls.RichTextBox> を使用します。  詳細については、「[RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)」を参照してください。  
+  
+ **メモ :** <xref:System.Windows.Controls.RichTextBox> 内のフロー コンテンツの動作は、他のコントロールに格納されたフロー コンテンツの動作とは異なる場合があります。  たとえば、<xref:System.Windows.Controls.RichTextBox> 内には列が存在しないため、自動サイズ変更動作もありません。  また、検索、表示モード、ページ ナビゲーション、およびズームなどのフロー コンテンツの通常の組み込み機能も、<xref:System.Windows.Controls.RichTextBox> 内では使用できません。  
+  
+<a name="creating_flow_content"></a>   
+## フロー コンテンツの作成  
+ フロー コンテンツは、テキスト、イメージ、テーブル、およびコントロールのような <xref:System.Windows.UIElement> 派生クラスを含むさまざまな要素で構成された複雑になものにすることができます。  複雑なフロー コンテンツを作成する方法を理解するには、次の点が重要です。  
+  
+-   **フロー関連のクラス** : フロー コンテンツ内で使用される各クラスには特定の目的があります。  また、フロー クラス間の階層型の関係により、それらがどのように使用されるかが理解しやすくなっています。  たとえば、<xref:System.Windows.Documents.Inline> から派生したクラスは表示されるオブジェクトを格納しますが、<xref:System.Windows.Documents.Block> クラスから派生したクラスは他のオブジェクトを格納するために使用されます。  
+  
+-   **コンテンツ スキーマ** : フロー ドキュメントには、多くの入れ子になった要素が必要になる場合があります。  コンテンツ スキーマは、使用可能な要素間の親子のリレーションシップを指定します。  
+  
+ 以下のセクションでは、これらの点のそれぞれについて詳しく説明します。  
+  
+<a name="flow_related_classes"></a>   
+## フロー関連のクラス  
+ 次の図は、フロー コンテンツで最も一般的に使用されるオブジェクトを示します。  
+  
+ ![ダイアグラム: フロー コンテンツ要素クラス階層](../../../../docs/framework/wpf/advanced/media/flow-class-hierarchy.png "Flow\_Class\_Hierarchy")  
+  
+ フロー コンテンツのために、2 つの重要なカテゴリがあります。  
+  
+1.  **Block の派生クラス** : "Block コンテンツ要素" または単に "Block 要素" とも呼ばれます。  <xref:System.Windows.Documents.Block> を継承する要素は、要素を共通の親の下にグループ化したり、共通の属性をグループに適用したりするために使用できます。  
+  
+2.  **Inline の派生クラス** : "Inline コンテンツ要素" または単に "Inline 要素" とも呼ばれます。  <xref:System.Windows.Documents.Inline> から継承する要素は、Block 要素または別の Inline 要素内に格納されます。  Inline 要素は、多くの場合、画面にレンダリングされるコンテンツの直接のコンテナーとして使用されます。  たとえば、<xref:System.Windows.Documents.Paragraph> \(Block 要素\) には <xref:System.Windows.Documents.Run> \(Inline 要素\) を格納することができますが、<xref:System.Windows.Documents.Run> には実際には画面にレンダリングされるテキストが格納されます。  
+  
+ これらの 2 つのカテゴリの各クラスについて、以下に簡単に説明します。  
+  
+### Block の派生クラス  
+ **Paragraph**  
+  
+ <xref:System.Windows.Documents.Paragraph> は、通常、コンテンツを 1 つの段落にグループ化するために使用されます。  Paragraph の最も単純かつ一般的な用途は、テキストの段落の作成です。  
+  
+ [!code-xml[FlowOvwSnippets_snip#ParagraphExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/ParagraphExample.xaml#paragraphexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#ParagraphCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/ParagraphExample.cs#paragraphcodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#ParagraphCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/ParagraphExample.vb#paragraphcodeonlyexamplewholepage)]  
+  
+ ただし、次に示すように、他の Inline の派生要素を格納することもできます。  
+  
+ **セクション**  
+  
+ <xref:System.Windows.Documents.Section> は、他の <xref:System.Windows.Documents.Block> の派生要素を格納するためにのみ使用されます。  格納している要素に対して、既定の書式設定を適用することはありません。  ただし、<xref:System.Windows.Documents.Section> で設定されたプロパティ値は、その子要素に適用されます。  セクションでは、プログラムで子コレクションを反復処理することもできます。  <xref:System.Windows.Documents.Section> は、HTML の \<DIV\> タグと同じように使用されます。  
+  
+ 次の例では、3 つの段落は、1 つの <xref:System.Windows.Documents.Section> で定義されます。  このセクションには、<xref:System.Windows.Documents.TextElement.Background%2A> プロパティ値である Red があるため、段落の背景色も赤になります。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SectionExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/SectionExample.xaml#sectionexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#SectionCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/SectionExample.cs#sectioncodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#SectionCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/SectionExample.vb#sectioncodeonlyexamplewholepage)]  
+  
+ **BlockUIContainer**  
+  
+ <xref:System.Windows.Documents.BlockUIContainer> は、<xref:System.Windows.UIElement> 要素 \(  <xref:System.Windows.Controls.Button> など\) を Block の派生フロー コンテンツに埋め込むことができるようにします。  <xref:System.Windows.Documents.InlineUIContainer> \(以下を参照\) は Inline の派生フロー コンテンツに <xref:System.Windows.UIElement> 要素を埋め込むために使用されます。  <xref:System.Windows.Documents.BlockUIContainer> および <xref:System.Windows.Documents.InlineUIContainer> は、これらの 2 つの要素のいずれかの中に格納されない限り、フロー コンテンツで <xref:System.Windows.UIElement> を使用する方法は他にないため重要です。  
+  
+ <xref:System.Windows.Documents.BlockUIContainer> 要素を使用してフロー コンテンツ内に <xref:System.Windows.UIElement> オブジェクトをホストする方法を次の例に示します。  
+  
+ [!code-xml[SpanSnippets#_BlockUIXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml#_blockuixaml)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: フロー コンテンツに埋め込まれた UIElement](../../../../docs/framework/wpf/advanced/media/blockuicontainer.png "BlockUIContainer")  
+  
+ **リスト**  
+  
+ <xref:System.Windows.Documents.List> は、箇条書きリストまたは番号リストを作成するために使用されます。  <xref:System.Windows.Documents.List.MarkerStyle%2A> プロパティを <xref:System.Windows.TextMarkerStyle> 列挙値に設定して、リストのスタイルを決定します。  簡単なリストを作成する方法を次の例に示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#ListExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/ListExample.xaml#listexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#ListCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/ListExample.cs#listcodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#ListCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/ListExample.vb#listcodeonlyexamplewholepage)]  
+  
+ **メモ :** <xref:System.Windows.Documents.List> だけが <xref:System.Windows.Documents.ListItemCollection> を使用して子要素を管理するフロー要素です。  
+  
+ **テーブル**  
+  
+ <xref:System.Windows.Documents.Table> は、テーブルを作成するために使用されます。  <xref:System.Windows.Documents.Table> は、<xref:System.Windows.Controls.Grid> 要素と似ていますが、より多くの機能を備えています。そのため、さらに多くのリソースのオーバーヘッドを必要とします。  <xref:System.Windows.Controls.Grid> は <xref:System.Windows.UIElement> であるため、<xref:System.Windows.Documents.BlockUIContainer> または <xref:System.Windows.Documents.InlineUIContainer> に格納されない限り、フロー コンテンツで使用できません。  <xref:System.Windows.Documents.Table> の詳細については、「[テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)」を参照してください。  
+  
+### Inline の派生クラス  
+ **\[実行\]**  
+  
+ <xref:System.Windows.Documents.Run> は、書式なしテキストを格納するために使用されます。  フロー コンテンツでは <xref:System.Windows.Documents.Run> オブジェクトを広範に使用することを想定している場合がありますが、  マークアップでは <xref:System.Windows.Documents.Run> 要素を明示的に使用する必要はありません。  <xref:System.Windows.Documents.Run> は、コードを使用してフロー ドキュメントを作成または操作するときに使用する必要があります。  たとえば、次のマークアップでは、最初の <xref:System.Windows.Documents.Paragraph> は <xref:System.Windows.Documents.Run> 要素を明示的に指定しますが、2 番目の Paragraph は Run 要素を明示的に指定しません。  両方の段落は、同じ出力を生成します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#RunExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/RunSnippetsExample.xaml#runexample1)]  
+  
+ **メモ:** [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] 以降では、<xref:System.Windows.Documents.Run> オブジェクトの <xref:System.Windows.Documents.Run.Text%2A> プロパティは依存関係プロパティです。  <xref:System.Windows.Documents.Run.Text%2A> プロパティを <xref:System.Windows.Controls.TextBlock> などのデータ ソースにバインドできます。  <xref:System.Windows.Documents.Run.Text%2A> プロパティは、一方向のバインディングを完全にサポートしています。  また、<xref:System.Windows.Documents.Run.Text%2A> プロパティは、<xref:System.Windows.Controls.RichTextBox> を除く双方向のバインディングもサポートしています。  例については、<xref:System.Windows.Documents.Run.Text%2A?displayProperty=fullName> のトピックを参照してください。  
+  
+ **Span**  
+  
+ <xref:System.Windows.Documents.Span> は他のインライン コンテンツ要素をグループ化します。  継承されたレンダリングは、<xref:System.Windows.Documents.Span> 要素内のコンテンツには適用されません。  ただし、<xref:System.Windows.Documents.Hyperlink>、<xref:System.Windows.Documents.Bold>、<xref:System.Windows.Documents.Italic>、および <xref:System.Windows.Documents.Underline> を含む <xref:System.Windows.Documents.Span> から継承する要素は、テキストに書式設定を適用します。  
+  
+ テキスト、<xref:System.Windows.Documents.Bold> 要素、および <xref:System.Windows.Controls.Button> を含むインライン コンテンツを格納するために使用されている <xref:System.Windows.Documents.Span> の例を次に示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SpanExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/SpanExample.xaml#spanexamplewholepage)]  
+  
+ 次のスクリーンショットは、この例がどのようにレンダリングされるかを示しています。  
+  
+ ![スクリーンショット: 表示される Span の例](../../../../docs/framework/wpf/advanced/media/flow-spanexample.png "Flow\_SpanExample")  
+  
+ **InlineUIContainer**  
+  
+ <xref:System.Windows.Documents.InlineUIContainer> は、<xref:System.Windows.UIElement> 要素 \(  <xref:System.Windows.Controls.Button> のようなコントロール\) を <xref:System.Windows.Documents.Inline> コンテンツ要素に埋め込むことができるようにします。  この要素は、前に説明した <xref:System.Windows.Documents.BlockUIContainer> と等価のインラインです。  <xref:System.Windows.Documents.Paragraph> に <xref:System.Windows.Controls.Button> インラインを挿入するために <xref:System.Windows.Documents.InlineUIContainer> を使用する例を次に示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#InlineUIContainerExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/InlineUIContainerExample.xaml#inlineuicontainerexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#InlineUIContainerCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/InlineUIContainerExample.cs#inlineuicontainercodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#InlineUIContainerCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/InlineUIContainerExample.vb#inlineuicontainercodeonlyexamplewholepage)]  
+  
+ **メモ :** <xref:System.Windows.Documents.InlineUIContainer> は、マークアップでは明示的に使用する必要はありません。  これを省略した場合、コードがコンパイルされると <xref:System.Windows.Documents.InlineUIContainer> が作成されます。  
+  
+ ****Figure および Floater****  
+  
+ <xref:System.Windows.Documents.Figure> および <xref:System.Windows.Documents.Floater> は、主要コンテンツ フローとは別にカスタマイズできる配置プロパティを持つフロー ドキュメント内にコンテンツを埋め込むために使用されます。  多くの場合、<xref:System.Windows.Documents.Figure> 要素または <xref:System.Windows.Documents.Floater> 要素は、コンテンツの一部を強調表示したり目立たせたりするため、コンテンツのメイン フロー内のサポート イメージや他のコンテンツをホストするため、または広告などの関連の薄いコンテンツを挿入するために使用されます。  
+  
+ テキストの段落に <xref:System.Windows.Documents.Figure> を埋め込む方法を次の例に示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#FigureExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/FigureExample.xaml#figureexamplewholepage)]  
+  
+ [!code-csharp[FlowOvwSnippets_procedural_snip#FigureCodeOnlyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/CSharp/FigureExample.cs#figurecodeonlyexamplewholepage)]
+ [!code-vb[FlowOvwSnippets_procedural_snip#FigureCodeOnlyExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowOvwSnippets_procedural_snip/VisualBasic/FigureExample.vb#figurecodeonlyexamplewholepage)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 図形の例](../../../../docs/framework/wpf/advanced/media/flow-ovw-figure-example.png "Flow\_Ovw\_Figure\_Example")  
+  
+ <xref:System.Windows.Documents.Figure> と <xref:System.Windows.Documents.Floater> にはいくつか違いがあり、それぞれ異なる場面で使用されます。  
+  
+ ****Figure:****  
+  
+-   配置可能です。水平方向および垂直方向のアンカーを設定することによって、ページ、コンテンツ、列、または段落に対して相対的にドッキングできます。  <xref:System.Windows.Documents.Figure.HorizontalOffset%2A> プロパティおよび <xref:System.Windows.Documents.Figure.VerticalOffset%2A> プロパティを使用して、任意のオフセットを指定することもできます。  
+  
+-   複数の列にまたがるサイズ指定が可能です。<xref:System.Windows.Documents.Figure> の高さと幅は、ページ、コンテンツ、または列の高さや幅の倍数に設定できます。  ページおよびコンテンツの場合は、1 より大きい倍数は指定できない点に注意してください。  たとえば、<xref:System.Windows.Documents.Figure> の幅を「0.5 ページ」、「0.25 コンテンツ」、「2 列」のように設定できます。  高さと幅は、絶対ピクセル値で指定することもできます。  
+  
+-   改ページ位置の自動修正は行いません。<xref:System.Windows.Documents.Figure> の内側のコンテンツが <xref:System.Windows.Documents.Figure> 内に収まらない場合は、収まる部分のみが表示され、残りの部分は失われます。  
+  
+ ****Floater:****  
+  
+-   位置の指定はできず、必要なスペースを確保できる場所に描画されます。  <xref:System.Windows.Documents.Floater> のオフセットやアンカーを設定することはできません。  
+  
+-   複数の列にまたがるサイズ指定はできません。<xref:System.Windows.Documents.Floater> の既定サイズは 1 列です。  絶対ピクセル値で指定できる <xref:System.Windows.Documents.Floater.Width%2A> プロパティがありますが、設定値が 1 列の幅より大きいと無視されるため、その場合の浮遊要素のサイズは 1 列になります。  正しいピクセル幅を設定することによってサイズを 1 列未満にすることはできますが、列を基準とした相対的なサイズ指定はできないため、<xref:System.Windows.Documents.Floater> の幅に関しては "0.5 列" という表現は有効ではありません。  <xref:System.Windows.Documents.Floater> には高さのプロパティはなく、高さを設定することはできません。高さはコンテンツに依存します。  
+  
+-   <xref:System.Windows.Documents.Floater> は改ページ位置の自動修正を行います。指定した幅のコンテンツが複数列の高さまで拡張されると、浮遊要素は分割されて、次の列、次のページなどに改ページ位置が自動修正されます。  
+  
+ <xref:System.Windows.Documents.Figure> は、サイズや位置の制御が求められ、指定サイズに収まることが確実な単体のコンテンツを配置する場合に適しています。  <xref:System.Windows.Documents.Floater> は、メイン ページのコンテンツと同様にフローする流動性の高いコンテンツを、メイン ページのコンテンツとは別に配置する場合に適しています。  
+  
+ ****LineBreak****  
+  
+ <xref:System.Windows.Documents.LineBreak> はフロー コンテンツの改行の原因となります。  次の例は <xref:System.Windows.Documents.LineBreak> の使い方を示しています。  
+  
+ [!code-xml[FlowOvwSnippets_snip#LineBreakExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/LineBreakExample.xaml#linebreakexamplewholepage)]  
+  
+ 次のスクリーンショットは、この例がどのようにレンダリングされるかを示しています。  
+  
+ ![スクリーンショット: LineBreak の例](../../../../docs/framework/wpf/advanced/media/flow-ovw-linebreakexample.png "Flow\_Ovw\_LineBreakExample")  
+  
+### フロー コレクションの要素  
+ 上記の例の多くでは、プログラムでフロー コンテンツを構築するために <xref:System.Windows.Documents.BlockCollection> および <xref:System.Windows.Documents.InlineCollection> が使用されています。  たとえば、要素を <xref:System.Windows.Documents.Paragraph> に追加するには、次の構文を使用できます。  
+  
+ `…`  
+  
+ `myParagraph.Inlines.Add(new Run("Some text"));`  
+  
+ `…`  
+  
+ これは、<xref:System.Windows.Documents.Run> を <xref:System.Windows.Documents.Paragraph> の <xref:System.Windows.Documents.InlineCollection> に追加します。  これは、マークアップの <xref:System.Windows.Documents.Paragraph> の内部にある暗黙の <xref:System.Windows.Documents.Run> と同じです。  
+  
+ `…`  
+  
+ `<Paragraph>`  
+  
+ `Some Text`  
+  
+ `</Paragraph>`  
+  
+ `…`  
+  
+ <xref:System.Windows.Documents.BlockCollection> の使用例として、次の例では、新しい <xref:System.Windows.Documents.Section> を作成してから、**Add** メソッドを使用して新しい <xref:System.Windows.Documents.Paragraph> を <xref:System.Windows.Documents.Section> コンテンツに追加します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksAdd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblocksadd)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksAdd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblocksadd)]  
+  
+ フロー コレクションへの項目の追加に加えて、項目を削除できます。  次の例では、<xref:System.Windows.Documents.Span> 内の最後の <xref:System.Windows.Documents.Inline> 要素を削除します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesremovelast)]
+ [!code-vb[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesremovelast)]  
+  
+ 次の例では、<xref:System.Windows.Documents.Span> からすべての内容 \(<xref:System.Windows.Documents.Inline> 要素\) を消去します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesclear)]
+ [!code-vb[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesclear)]  
+  
+ フロー コンテンツをプログラムによって操作する場合、これらのコレクションを広く活用する可能性があります。  
+  
+ フロー要素が子要素を格納するために <xref:System.Windows.Documents.InlineCollection> \(インライン\) または <xref:System.Windows.Documents.BlockCollection> \(ブロック\) を使用するかどうかは、親が格納できる子要素の種類 \(<xref:System.Windows.Documents.Block> または <xref:System.Windows.Documents.Inline>\) によって異なります。  フロー コンテンツ要素の格納規則については、次のセクションのコンテンツ スキーマで説明します。  
+  
+ **メモ :** フロー コンテンツと共に使用されるコレクションの 3 つ目の種類は <xref:System.Windows.Documents.ListItemCollection> ですが、このコレクションは <xref:System.Windows.Documents.List> と共にしか使用されません。  また、<xref:System.Windows.Documents.Table> と共に使用されるいくつかのコレクションがあります。  詳細については、「[テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)」を参照してください。  
+  
+<a name="content_schema"></a>   
+## コンテンツ スキーマ  
+ 多数のさまざまなフロー コンテンツ要素が指定されると、要素が格納できる子要素の種類を追跡できなくなる可能性があります。  フロー要素の格納規則をまとめたものを次の図に示します。  矢印は、使用可能な親子のリレーションシップを表します。  
+  
+ ![ダイアグラム: フロー コンテンツ コンテインメント スキーマ](../../../../docs/framework/wpf/advanced/media/flow-content-schema.png "Flow\_Content\_Schema")  
+  
+ 上の図からわかるように、要素で許容される子は、必ずしもそれが <xref:System.Windows.Documents.Block> 要素と <xref:System.Windows.Documents.Inline> 要素のどちらであるかによって決まるわけではありません。  たとえば、<xref:System.Windows.Documents.Span> \(<xref:System.Windows.Documents.Inline> 要素\) は <xref:System.Windows.Documents.Inline> 子要素だけを持つことができるのに対し、<xref:System.Windows.Documents.Figure> \(同じく <xref:System.Windows.Documents.Inline> 要素\) は <xref:System.Windows.Documents.Block> 子要素だけを持つことができます。  そのため、どの要素を別の要素に含めることができるかをすばやく判断するには、図が役立ちます。  例として、<xref:System.Windows.Controls.RichTextBox> のフロー コンテンツを構築する方法を、上の図を使用して判断してみましょう。  
+  
+ **1.** <xref:System.Windows.Controls.RichTextBox> は <xref:System.Windows.Documents.FlowDocument> を含んでいる必要があり、<xref:System.Windows.Documents.FlowDocument> は <xref:System.Windows.Documents.Block> の派生オブジェクトを含んでいる必要があります。  上の図でこれに対応する部分を次に示します。  
+  
+ ![ダイアグラム: RichTextBox コンテインメント規則](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough1.png "Flow\_Ovw\_SchemaWalkThrough1")  
+  
+ この段階では、マークアップは次のようになります。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SchemaWalkThrough1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/MiscSnippets.xaml#schemawalkthrough1)]  
+  
+ **2.**上の図によると、<xref:System.Windows.Documents.Block> 要素には、<xref:System.Windows.Documents.Paragraph>、<xref:System.Windows.Documents.Section>、<xref:System.Windows.Documents.Table>、<xref:System.Windows.Documents.List>、および <xref:System.Windows.Documents.BlockUIContainer> を含む、いくつかの選択肢があります \(図の Block の派生クラスを参照\)。  ここで、<xref:System.Windows.Documents.Table> が必要だとします。  上の図によると、<xref:System.Windows.Documents.Table> は <xref:System.Windows.Documents.TableRowGroup> を含んでおり、これは <xref:System.Windows.Documents.TableRow> 要素を含んでいます。さらにこれは <xref:System.Windows.Documents.TableCell> 要素を含んでおり、これは <xref:System.Windows.Documents.Block> の派生オブジェクトを含んでいます。  上の図で、<xref:System.Windows.Documents.Table> に対応する部分を次に示します。  
+  
+ ![ダイアグラム: テーブルの親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough2.png "Flow\_Ovw\_SchemaWalkThrough2")  
+  
+ 以下は、これに対応するマークアップです。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SchemaWalkThrough2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/MiscSnippets.xaml#schemawalkthrough2)]  
+  
+ **3.**さらに、<xref:System.Windows.Documents.TableCell> の下にも、1 つ以上の <xref:System.Windows.Documents.Block> 要素が必要です。  簡単にするために、セル内にいくつかのテキストを配置することにします。  これを行うには、<xref:System.Windows.Documents.Paragraph> を <xref:System.Windows.Documents.Run> 要素と組み合わせて使用します。  上の図でこれに対応する部分を次に示します。ここには、<xref:System.Windows.Documents.Paragraph> が <xref:System.Windows.Documents.Inline> 要素を取ることができ、<xref:System.Windows.Documents.Run> \(<xref:System.Windows.Documents.Inline> 要素の 1 つ\) がプレーン テキストのみを取ることができることが示されています。  
+  
+ ![ダイアグラム: 段落の親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough3.png "Flow\_Ovw\_SchemaWalkThrough3")  
+  
+ ![ダイアグラム: 実行の親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough4.png "Flow\_Ovw\_SchemaWalkThrough4")  
+  
+ 以下は、マークアップによる例の全体です。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SchemaExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/SchemaExample.xaml#schemaexamplewholepage)]  
+  
+<a name="customizing_text"></a>   
+## テキストのカスタマイズ  
+ 通常、テキストは、フロー ドキュメントで最も一般的なコンテンツの種類です。  上で導入されたオブジェクトは、テキストをレンダリングする方法のほとんどの側面を制御するために使用できますが、このセクションで説明されるテキストのカスタマイズ用にその他のメソッドがいくつか存在します。  
+  
+### 文字装飾  
+ 文字装飾によって、下線、上線、ベースライン、および取り消し線の効果をテキストに適用できます \(下図を参照\)。  これらの装飾は、<xref:System.Windows.Documents.Inline>、<xref:System.Windows.Documents.Paragraph>、<xref:System.Windows.Controls.TextBlock>、および <xref:System.Windows.Controls.TextBox> を含む複数のオブジェクトによって公開される <xref:System.Windows.Documents.Inline.TextDecorations%2A> プロパティを使用して追加されます。  
+  
+ <xref:System.Windows.Documents.Paragraph> の <xref:System.Windows.Documents.Paragraph.TextDecorations%2A> プロパティを設定する方法を次の例に示します。  
+  
+ [!code-xml[InlineSnippets#_Paragraph_TextDecXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InlineSnippets/CSharp/Window1.xaml#_paragraph_textdecxaml)]  
+  
+ [!code-csharp[InlineSnippets#_Paragraph_TextDec](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InlineSnippets/CSharp/Window1.xaml.cs#_paragraph_textdec)]
+ [!code-vb[InlineSnippets#_Paragraph_TextDec](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InlineSnippets/visualbasic/window1.xaml.vb#_paragraph_textdec)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 既定の取り消し線が適用されたテキスト](../../../../docs/framework/wpf/advanced/media/inline-textdec-strike.png "Inline\_TextDec\_Strike")  
+  
+ 次の図は、それぞれ**上線**、**標準**、**下線**の各装飾の表示結果を示しています。  
+  
+ ![スクリーンショット: TextDecorator の上に線を引く](../../../../docs/framework/wpf/advanced/media/inline-textdec-over.png "Inline\_TextDec\_Over")  
+  
+ ![スクリーンショット: テキストに対する既定のベースライン効果](../../../../docs/framework/wpf/advanced/media/inline-textdec-base.png "Inline\_TextDec\_Base")  
+  
+ ![スクリーンショット: 既定の下線が適用されたテキスト](../../../../docs/framework/wpf/advanced/media/inline-textdec-under.png "Inline\_TextDec\_Under")  
+  
+### タイポグラフィ  
+ <xref:System.Windows.Documents.TextElement.Typography%2A> プロパティは、<xref:System.Windows.Documents.TextElement>、<xref:System.Windows.Documents.FlowDocument>、<xref:System.Windows.Controls.TextBlock>、および <xref:System.Windows.Controls.TextBox> を含むほとんどのフロー関連のコンテンツによって公開されます。  このプロパティは、テキストの文字体裁の特性またはバリエーション \(  小さい大文字か大きい大文字か、上付き文字と下付き文字の作成など\) を制御するために使用されます。  
+  
+ 要素として <xref:System.Windows.Documents.Paragraph> を使用して、<xref:System.Windows.Documents.TextElement.Typography%2A> 属性を設定する方法を次の例に示します。  
+  
+ [!code-xml[TextElementSnippets#_TextElement_TypogXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextElementSnippets/CSharp/Window1.xaml#_textelement_typogxaml)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 変更されたタイポグラフィを含むテキスト](../../../../docs/framework/wpf/advanced/media/textelement-typog.png "TextElement\_Typog")  
+  
+ 既定の文字体裁プロパティを設定した同様の例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 変更されたタイポグラフィを含むテキスト](../../../../docs/framework/wpf/advanced/media/textelement-typog-default.png "TextElement\_Typog\_Default")  
+  
+ <xref:System.Windows.Controls.TextBox.Typography%2A> プロパティをプログラムによって設定する方法を次の例に示します。  
+  
+ [!code-csharp[TextElementSnippets#_TextElement_Typog](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextElementSnippets/CSharp/Window1.xaml.cs#_textelement_typog)]
+ [!code-vb[TextElementSnippets#_TextElement_Typog](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextElementSnippets/visualbasic/window1.xaml.vb#_textelement_typog)]  
+  
+ 文字体裁の詳細については、「[WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)」を参照してください。  
+  
+## 参照  
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md)   
+ [TextElement コンテンツ モデルの概要](../../../../docs/framework/wpf/advanced/textelement-content-model-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)   
+ [注釈の概要](../../../../docs/framework/wpf/advanced/annotations-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/focus-overview.md b/docs/framework/wpf/advanced/focus-overview.md
new file mode 100644
index 00000000000..e51c5a04403
--- /dev/null
+++ b/docs/framework/wpf/advanced/focus-overview.md
@@ -0,0 +1,129 @@
+---
+title: "フォーカスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, フォーカス"
+  - "フォーカスを設定 (アプリケーションに)"
+ms.assetid: 0230c4eb-0c8a-462b-ac4b-ae3e511659f4
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# フォーカスの概要
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、キーボード フォーカスと論理フォーカスという、フォーカスに関する 2 つの主要な概念があります。  キーボード フォーカスはキーボード入力を受け取る要素を表し、論理フォーカスはフォーカスを持つフォーカス範囲内の要素を表します。  これらの概念については、この概要で詳しく説明します。  フォーカスを取得可能な領域を複数持つ複雑なアプリケーションを作成する場合は、これらの概念の違いを理解することが重要です。  
+  
+ フォーカス管理に関与する主要なクラスには、<xref:System.Windows.Input.Keyboard> クラス、<xref:System.Windows.Input.FocusManager> クラス、および <xref:System.Windows.UIElement> や <xref:System.Windows.ContentElement> などの基本要素クラスがあります。  基本要素の詳細については、「[基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Input.Keyboard> クラスは主にキーボード フォーカスに関連し、<xref:System.Windows.Input.FocusManager> は主に論理フォーカスに関連しますが、これは絶対的な区別ではありません。  キーボード フォーカスを持つ要素は論理フォーカスも持ちますが、論理フォーカスを持つ要素は必ずしもキーボード フォーカスを持ちません。  <xref:System.Windows.Input.Keyboard> クラスを使用してキーボード フォーカスを持つ要素を設定したときには、要素に論理フォーカスも設定されるので、この違いがよくわかります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Keyboard_Focus"></a>   
+## キーボード フォーカス  
+ キーボード フォーカスは、現在キーボード入力を受け取っている要素を指します。  キーボード フォーカスを持つ要素は、デスクトップ全体で 1 つしかありません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、キーボード フォーカスを持つ要素の <xref:System.Windows.IInputElement.IsKeyboardFocused%2A> は `true` に設定されます。  <xref:System.Windows.Input.Keyboard> クラスの静的プロパティ <xref:System.Windows.Input.Keyboard.FocusedElement%2A> は、現在キーボード フォーカスを持っている要素を取得します。  
+  
+ 要素でキーボード フォーカスを取得するためには、基本要素で <xref:System.Windows.UIElement.Focusable%2A> プロパティと <xref:System.Windows.UIElement.IsVisible%2A> プロパティを `true` に設定する必要があります。  <xref:System.Windows.Controls.Panel> 基本クラスなど一部のクラスでは <xref:System.Windows.UIElement.Focusable%2A> の既定値は `false` です。したがって、このような要素がキーボード フォーカスを取得できるようにする場合は、<xref:System.Windows.UIElement.Focusable%2A> を `true` に設定する必要があります。  
+  
+ キーボード フォーカスは、要素への Tab キーでの移動や特定の要素でのマウスのクリックなど、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] でのユーザー操作を通じて取得できます。  キーボード フォーカスは、<xref:System.Windows.Input.Keyboard> クラスで <xref:System.Windows.Input.Keyboard.Focus%2A> メソッドを使用してプログラムにより取得することもできます。  <xref:System.Windows.Input.Keyboard.Focus%2A> メソッドは、指定された要素にキーボード フォーカスを設定しようとします。  返される要素はキーボード フォーカスが設定された要素ですが、古いフォーカス オブジェクトまたは新しいフォーカス オブジェクトが要求をブロックする場合は、要求された要素とは異なる可能性があります。  
+  
+ <xref:System.Windows.Input.Keyboard.Focus%2A> メソッドを使用して、キーボード フォーカスを <xref:System.Windows.Controls.Button> に設定する例を次に示します。  
+  
+ [!code-csharp[focussample#FocusSampleSetFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSample/CSharp/Window1.xaml.cs#focussamplesetfocus)]
+ [!code-vb[focussample#FocusSampleSetFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSample/visualbasic/window1.xaml.vb#focussamplesetfocus)]  
+  
+ 基本要素クラスの <xref:System.Windows.UIElement.IsKeyboardFocused%2A> プロパティは、要素にキーボード フォーカスがあるかどうかを示す値を取得します。  基本要素クラスの <xref:System.Windows.UIElement.IsKeyboardFocusWithin%2A> プロパティは、要素またはいずれかの子ビジュアル要素にキーボード フォーカスがあるかどうかを示す値を取得します。  
+  
+ アプリケーションの起動時に初期フォーカスを設定する場合、フォーカスを受け取る要素は、アプリケーションによって読み込まれる初期ウィンドウのビジュアル ツリーに含まれていて、<xref:System.Windows.UIElement.Focusable%2A> と <xref:System.Windows.UIElement.IsVisible%2A> が `true` に設定されている必要があります。  初期フォーカスを設定する場所は、<xref:System.Windows.FrameworkElement.Loaded> イベント ハンドラー内にすることをお勧めします。  <xref:System.Windows.Threading.Dispatcher> コールバックは、<xref:System.Windows.Threading.Dispatcher.Invoke%2A> または <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A> を呼び出して使用することもできます。  
+  
+<a name="Logical_Focus"></a>   
+## 論理フォーカス  
+ 論理フォーカスとは、フォーカス範囲内の <xref:System.Windows.Input.FocusManager.FocusedElement%2A?displayProperty=fullName> を意味します。  フォーカス範囲とは、その範囲内の <xref:System.Windows.Input.FocusManager.FocusedElement%2A> を追跡する要素です。  キーボード フォーカスがフォーカス範囲を離れると、フォーカスがある要素はキーボード フォーカスを失いますが、論理フォーカスは引き続き保持します。  キーボード フォーカスがフォーカス範囲に戻ると、フォーカスがある要素はキーボード フォーカスを得ます。  これにより、キーボード フォーカスが複数のフォーカス範囲間で変更されても、フォーカスがフォーカス範囲に戻ると、そのフォーカス範囲内のフォーカスがある要素はキーボード フォーカスを取り戻すことができます。  
+  
+ アプリケーションでは、複数の要素が論理フォーカスを持つことがありますが、特定のフォーカス範囲で論理フォーカスを持つ要素は 1 つだけに限られます。  
+  
+ キーボード フォーカスを持つ要素は、その要素が属するフォーカス範囲の論理フォーカスを持ちます。  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、<xref:System.Windows.Input.FocusManager> の添付プロパティ <xref:System.Windows.Input.FocusManager.IsFocusScope%2A> を `true` に設定することにより、要素をフォーカス範囲にすることができます。  コードでは、<xref:System.Windows.Input.FocusManager.SetIsFocusScope%2A> を呼び出して、要素をフォーカス範囲にすることができます。  
+  
+ <xref:System.Windows.Input.FocusManager.IsFocusScope%2A> 添付プロパティを設定して、<xref:System.Windows.Controls.StackPanel> をフォーカス範囲にする例を次に示します。  
+  
+ [!code-xml[MarkupSnippets#MarkupIsFocusScopeXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupisfocusscopexaml)]  
+  
+ [!code-csharp[FocusSnippets#FocusSetIsFocusScope](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSnippets/CSharp/Window1.xaml.cs#focussetisfocusscope)]
+ [!code-vb[FocusSnippets#FocusSetIsFocusScope](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSnippets/visualbasic/window1.xaml.vb#focussetisfocusscope)]  
+  
+ <xref:System.Windows.Input.FocusManager.GetFocusScope%2A> は、指定した要素のフォーカス範囲を返します。  
+  
+ 既定でフォーカス範囲になる、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のクラスは、<xref:System.Windows.Window>、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Controls.ToolBar>、および <xref:System.Windows.Controls.ContextMenu> です。  
+  
+ <xref:System.Windows.Input.FocusManager.GetFocusedElement%2A> は、指定したフォーカス範囲のフォーカスを持つ要素を取得します。  <xref:System.Windows.Input.FocusManager.SetFocusedElement%2A> は、指定したフォーカス範囲でフォーカスを持つ要素を設定します。  <xref:System.Windows.Input.FocusManager.SetFocusedElement%2A> は、通常、最初にフォーカスを得る要素を設定するために使用します。  
+  
+ フォーカス範囲にフォーカスを持つ要素を設定し、フォーカス範囲のフォーカスを持つ要素を取得する例を次に示します。  
+  
+ [!code-csharp[FocusSnippets#FocusGetSetFocusedElement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSnippets/CSharp/Window1.xaml.cs#focusgetsetfocusedelement)]
+ [!code-vb[FocusSnippets#FocusGetSetFocusedElement](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSnippets/visualbasic/window1.xaml.vb#focusgetsetfocusedelement)]  
+  
+<a name="Keyboard_Navigation"></a>   
+## キーボード ナビゲーション  
+ <xref:System.Windows.Input.KeyboardNavigation> クラスは、ナビゲーション キーのいずれかが押されたときに、既定のキーボード フォーカスのナビゲーションを実装します。  ナビゲーション キーとは、Tab、Shift \+ Tab、Ctrl \+ Tab、Ctrl \+ Shift \+ Tab、上方向、下方向、左方向、および右方向の各キーを指します。  
+  
+ ナビゲーション コンテナーのナビゲーション動作は、添付 <xref:System.Windows.Input.KeyboardNavigation> プロパティの <xref:System.Windows.Input.KeyboardNavigation.TabNavigation%2A>、<xref:System.Windows.Input.KeyboardNavigation.ControlTabNavigation%2A>、および <xref:System.Windows.Input.KeyboardNavigation.DirectionalNavigation%2A> を設定することにより変更できます。  これらのプロパティは <xref:System.Windows.Input.KeyboardNavigationMode> 型であり、指定可能な値は <xref:System.Windows.Input.KeyboardNavigationMode>、<xref:System.Windows.Input.KeyboardNavigationMode>、<xref:System.Windows.Input.KeyboardNavigationMode>、<xref:System.Windows.Input.KeyboardNavigationMode>、<xref:System.Windows.Input.KeyboardNavigationMode>、および <xref:System.Windows.Input.KeyboardNavigationMode> です。  既定値は <xref:System.Windows.Input.KeyboardNavigationMode> です。これは、要素がナビゲーション コンテナーではないことを意味します。  
+  
+ 複数の <xref:System.Windows.Controls.MenuItem> オブジェクトを使用して <xref:System.Windows.Controls.Menu> を作成する例を次に示します。  <xref:System.Windows.Controls.Menu> で、<xref:System.Windows.Input.KeyboardNavigation.TabNavigation%2A> 添付プロパティが <xref:System.Windows.Input.KeyboardNavigationMode> に設定されます。  <xref:System.Windows.Controls.Menu> 内で Tab キーを使用してフォーカスを変更すると、各要素間をフォーカスが移動し、最後の要素に達すると最初の要素にフォーカスが戻ります。  
+  
+ [!code-xml[MarkupSnippets#MarkupKeyboardNavigationTabNavigationXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupkeyboardnavigationtabnavigationxaml)]  
+  
+ [!code-csharp[MarkupSnippets#MarkupKeyboardNavigationTabNavigationCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml.cs#markupkeyboardnavigationtabnavigationcode)]
+ [!code-vb[MarkupSnippets#MarkupKeyboardNavigationTabNavigationCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MarkupSnippets/visualbasic/window1.xaml.vb#markupkeyboardnavigationtabnavigationcode)]  
+  
+<a name="Manipulating_Focus_Programmatically"></a>   
+## プログラムによるフォーカスのナビゲーション  
+ フォーカスを操作するための追加の [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] には、<xref:System.Windows.UIElement.MoveFocus%2A> と <xref:System.Windows.UIElement.PredictFocus%2A> があります。  
+  
+ <xref:System.Windows.FrameworkElement.MoveFocus%2A> は、アプリケーション内の次の要素にフォーカスを変更します。  <xref:System.Windows.Input.TraversalRequest> は、方向を指定するために使用されます。  <xref:System.Windows.UIElement.MoveFocus%2A> に渡された <xref:System.Windows.Input.FocusNavigationDirection> は、<xref:System.Windows.Input.FocusNavigationDirection>、<xref:System.Windows.Input.FocusNavigationDirection>、<xref:System.Windows.Input.FocusNavigationDirection>、<xref:System.Windows.Input.FocusNavigationDirection> などの、フォーカスを移動できる方向を指定します。  
+  
+ <xref:System.Windows.FrameworkElement.MoveFocus%2A> を使用してフォーカスがある要素を変更する例を次に示します。  
+  
+ [!code-csharp[focussample#FocusSampleMoveFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSample/CSharp/Window1.xaml.cs#focussamplemovefocus)]
+ [!code-vb[focussample#FocusSampleMoveFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSample/visualbasic/window1.xaml.vb#focussamplemovefocus)]  
+  
+ <xref:System.Windows.FrameworkElement.PredictFocus%2A> は、フォーカスが変更された場合にフォーカスを受け取るオブジェクトを返します。  現在、<xref:System.Windows.FrameworkElement.PredictFocus%2A> でサポートされているのは、<xref:System.Windows.Input.FocusNavigationDirection>、<xref:System.Windows.Input.FocusNavigationDirection>、<xref:System.Windows.Input.FocusNavigationDirection>、および <xref:System.Windows.Input.FocusNavigationDirection> だけです。  
+  
+<a name="Focus_Events"></a>   
+## フォーカス イベント  
+ キーボード フォーカスに関連するイベントには、<xref:System.Windows.Input.Keyboard.PreviewGotKeyboardFocus> と <xref:System.Windows.Input.Keyboard.GotKeyboardFocus>、および <xref:System.Windows.Input.Keyboard.PreviewLostKeyboardFocus> と <xref:System.Windows.Input.Keyboard.LostKeyboardFocus> があります。  イベントは、<xref:System.Windows.Input.Keyboard> クラスで添付イベントとして定義されますが、基本要素クラスで等価なルーティング イベントして簡単にアクセスできます。  イベントの詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Input.Keyboard.GotKeyboardFocus> は、要素がキーボード フォーカスを受け取ったときに発生します。  <xref:System.Windows.Input.Keyboard.LostKeyboardFocus> は、要素がキーボード フォーカスを失ったときに発生します。  <xref:System.Windows.Input.Keyboard.PreviewGotKeyboardFocus> イベントまたは <xref:System.Windows.Input.Keyboard.PreviewLostKeyboardFocusEvent> イベントが処理され、<xref:System.Windows.RoutedEventArgs.Handled%2A> が `true` に設定されると、フォーカスは変更されなくなります。  
+  
+ <xref:System.Windows.UIElement.GotKeyboardFocus> イベント ハンドラーと <xref:System.Windows.UIElement.LostKeyboardFocus> イベント ハンドラーを <xref:System.Windows.Controls.TextBox> に添付する例を次に示します。  
+  
+ [!code-xml[keyboardsample#KeyboardSampleXAMLHandlerHookup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml#keyboardsamplexamlhandlerhookup)]  
+  
+ <xref:System.Windows.Controls.TextBox> がキーボード フォーカスを取得すると、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.Controls.Control.Background%2A> プロパティが <xref:System.Windows.Media.Brushes.LightBlue%2A> に変更されます。  
+  
+ [!code-csharp[keyboardsample#KeyboardSampleGotFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplegotfocus)]
+ [!code-vb[keyboardsample#KeyboardSampleGotFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplegotfocus)]  
+  
+ <xref:System.Windows.Controls.TextBox> がキーボード フォーカスを失うと、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.Controls.Control.Background%2A> プロパティが白に戻ります。  
+  
+ [!code-csharp[keyboardsample#KeyboardSampleLostFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyboardSample/CSharp/Window1.xaml.cs#keyboardsamplelostfocus)]
+ [!code-vb[keyboardsample#KeyboardSampleLostFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/KeyboardSample/visualbasic/window1.xaml.vb#keyboardsamplelostfocus)]  
+  
+ 論理フォーカスに関連するイベントには、<xref:System.Windows.UIElement.GotFocus> および <xref:System.Windows.UIElement.LostFocus> があります。  これらのイベントは、<xref:System.Windows.Input.FocusManager> で添付イベントとして定義されますが、<xref:System.Windows.Input.FocusManager> は CLR イベント ラッパーを公開しません。  これらのイベントは、<xref:System.Windows.UIElement> と <xref:System.Windows.ContentElement> によって、より使いやすい形で公開されます。  
+  
+## 参照  
+ <xref:System.Windows.Input.FocusManager>   
+ <xref:System.Windows.UIElement>   
+ <xref:System.Windows.ContentElement>   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/fonts-how-to-topics.md b/docs/framework/wpf/advanced/fonts-how-to-topics.md
new file mode 100644
index 00000000000..87fca87235a
--- /dev/null
+++ b/docs/framework/wpf/advanced/fonts-how-to-topics.md
@@ -0,0 +1,34 @@
+---
+title: "フォントに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "フォント [WPF]"
+ms.assetid: b4a97c97-7f88-4a89-b1d1-cf2c0d087955
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# フォントに関する「方法」トピック
+このセクションのトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] に含まれるフォント機能を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [システム フォントを列挙する](../../../../docs/framework/wpf/advanced/how-to-enumerate-system-fonts.md)  
+ [FontSizeConverter クラスを使用する](../../../../docs/framework/wpf/advanced/how-to-use-the-fontsizeconverter-class.md)  
+  
+## 参照  
+ <xref:System.Windows.FontStyle>   
+ <xref:System.Windows.SystemFonts>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/fonts-wpf.md b/docs/framework/wpf/advanced/fonts-wpf.md
new file mode 100644
index 00000000000..899579f7fb9
--- /dev/null
+++ b/docs/framework/wpf/advanced/fonts-wpf.md
@@ -0,0 +1,36 @@
+---
+title: "フォント (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "フォント [WPF]"
+ms.assetid: 6c766a95-ad03-475e-a36f-2243e9495941
+caps.latest.revision: 82
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 82
+---
+# フォント (WPF)
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントを使用する多彩なテキスト表示をサポートします。  [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントのサンプル パックは [!INCLUDE[TLA2#tla_lhsdk](../../../../includes/tla2sharptla-lhsdk-md.md)] に含まれています。  
+  
+## このセクションの内容  
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)  
+ [アプリケーションでのフォントのパッケージング](../../../../docs/framework/wpf/advanced/packaging-fonts-with-applications.md)  
+ [OpenType フォント パックのサンプル](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/fonts-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.FontStyle>   
+ <xref:System.Windows.SystemFonts>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/framework-property-metadata.md b/docs/framework/wpf/advanced/framework-property-metadata.md
new file mode 100644
index 00000000000..8a245c848c6
--- /dev/null
+++ b/docs/framework/wpf/advanced/framework-property-metadata.md
@@ -0,0 +1,86 @@
+---
+title: "フレームワーク プロパティ メタデータ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フレームワーク プロパティ メタデータ"
+  - "メタデータ, フレームワーク プロパティ"
+ms.assetid: 9962f380-b885-4b61-a62e-457397083fea
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# フレームワーク プロパティ メタデータ
+フレームワーク プロパティ メタデータのオプションは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アーキテクチャの [WPF フレームワーク レベル](GTMT)にあると見なされるオブジェクト要素のプロパティに対して報告されます  一般に、[WPF フレームワーク レベル](GTMT)が指定されている場合、レンダリング、データ バインディング、プロパティ システムの調整などの機能が、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプレゼンテーション [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] と実行可能ファイルによって処理されます。  フレームワーク プロパティ メタデータがこれらのシステムによって照会されて、特定の要素プロパティに対する機能固有の特性が決まります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスの既存の[依存関係プロパティ](GTMT)の使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  また、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を通読している必要もあります。  
+  
+<a name="What_Is_Communicated_by_Framework_Property"></a>   
+## フレームワーク プロパティ メタデータによる通知内容  
+ フレームワーク プロパティ メタデータは、次のように分類できます。  
+  
+-   要素に影響するレイアウト プロパティ \(<xref:System.Windows.FrameworkPropertyMetadata.AffectsArrange%2A>、<xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A>、<xref:System.Windows.FrameworkPropertyMetadata.AffectsRender%2A>\) の報告。  プロパティがそれぞれの側面に影響する場合、メタデータにこれらのフラグを設定できます。また、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> \/ <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドをクラスに実装して、特定のレンダリングの動作と情報をレイアウト システムに指定します。  通常、そのような実装では、依存関係プロパティのメタデータでこれらのレイアウト プロパティのいずれかが true であると、プロパティの無効化があるかどうかがチェックされます。無効化があった場合にのみ、新しいレイアウト パスの要求が必要となります。  
+  
+-   要素の親要素に影響するレイアウト プロパティ \(<xref:System.Windows.FrameworkPropertyMetadata.AffectsParentArrange%2A>、<xref:System.Windows.FrameworkPropertyMetadata.AffectsParentMeasure%2A>\) の報告。  これらのフラグが既定で設定される例として、<xref:System.Windows.Documents.FixedPage.Left%2A?displayProperty=fullName> と <xref:System.Windows.Documents.Paragraph.KeepWithNext%2A?displayProperty=fullName> があります。  
+  
+-   <xref:System.Windows.FrameworkPropertyMetadata.Inherits%2A>.  既定では、依存関係プロパティは値を継承しません。  <xref:System.Windows.FrameworkPropertyMetadata.OverridesInheritanceBehavior%2A> を使用すると、継承のパスがビジュアル ツリー内を通ることもできるようになります。コントロールを複合する一部のシナリオでは、このような必要が生じることがあります。  
+  
+    > [!NOTE]
+    >  プロパティ値のコンテキストにおける "継承" という用語は、依存関係プロパティに固有の事項を意味します。つまり、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムの [WPF フレームワーク レベル](GTMT)の機能によって、実際の依存関係プロパティ値を子要素が親要素から継承できることを意味します。  派生型を通じたマネージ コードの型およびメンバーの継承とは、直接関係がありません。  詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+-   データ バインディング特性 \(<xref:System.Windows.FrameworkPropertyMetadata.IsNotDataBindable%2A>、<xref:System.Windows.FrameworkPropertyMetadata.BindsTwoWayByDefault%2A>\) の報告。  既定では、フレームワークの依存関係プロパティは、一方向のバインディング動作を持つデータ バインディングをサポートします。  必要がない場合はデータ バインディングを無効にできます \(柔軟性と拡張性を目的とするため、既定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] にそのようなプロパティの例は多くありません\)。  複数のコンポーネント間でコントロールの動作を関連付けるプロパティ \(<xref:System.Windows.Controls.MenuItem.IsSubmenuOpen%2A> など\) や、ユーザーにとって双方向のバインディングが一般的かつ期待されるシナリオであるプロパティ \(<xref:System.Windows.Controls.TextBox.Text%2A> など\) に対しては、双方向のバインディングを既定として設定できます。  データ バインディング関連のメタデータを変更した場合に影響を受けるのは既定値だけです。この既定値は、バインディングごとにいつでも変更できます。  バインディング モードおよびバインディング全般の詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+-   履歴作成をサポートするアプリケーションまたはサービスによって、プロパティの履歴を作成するかどうか \(<xref:System.Windows.FrameworkPropertyMetadata.Journal%2A>\) の報告。  一般的な要素に対しては、履歴作成が既定で有効にされることはありません。特定のユーザー入力コントロールに対して、選択的に有効にします。  これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の履歴作成の実装を含む、履歴サービスによって読み取られるプロパティです。通常、複数のナビゲーション段階にわたって永続化する必要があるユーザー コントロール \(一覧におけるユーザー選択など\) に設定します。  履歴の詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+<a name="Reading_FrameworkPropertyMetadata"></a>   
+## FrameworkPropertyMetadata の読み取り  
+ 上記にリンクを示した各プロパティは、<xref:System.Windows.FrameworkPropertyMetadata> によって直接の基本クラス <xref:System.Windows.UIPropertyMetadata> に追加される特定のプロパティです。  これらのプロパティの既定値はいずれも `false` です。  これらのプロパティの値を知るためにメタデータを要求する場合は、返されたメタデータを <xref:System.Windows.FrameworkPropertyMetadata> にキャストしてから、必要に応じて個々のプロパティの値を確認する必要があります。  
+  
+<a name="Specifying_Metadata"></a>   
+## メタデータの指定  
+ 新しい依存関係プロパティの登録にメタデータを適用する目的で、メタデータ インスタンスを新しく作成するときは、基本メタデータ クラス <xref:System.Windows.PropertyMetadata> を使用するか、<xref:System.Windows.FrameworkPropertyMetadata> などの派生クラスを使用するかを選択できます。  通常は <xref:System.Windows.FrameworkPropertyMetadata> を使用します。特に、プロパティがプロパティ システムと対話する場合や、レイアウトやデータ バインディングなどの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 機能と対話する場合は、このクラスを使用します。  より高度なシナリオでは、<xref:System.Windows.FrameworkPropertyMetadata> から派生して独自のメタデータ報告クラスを作成し、メンバーに追加情報が含まれるようにします。  <xref:System.Windows.PropertyMetadata> または <xref:System.Windows.UIPropertyMetadata> を使用して、実装の機能をサポートする度合いを通知することもできます。  
+  
+ 既存のプロパティ \(<xref:System.Windows.DependencyProperty.AddOwner%2A> 呼び出しまたは <xref:System.Windows.DependencyProperty.OverrideMetadata%2A> 呼び出し\) は必ず、元の登録で使用されているメタデータ型でオーバーライドします。  
+  
+ <xref:System.Windows.FrameworkPropertyMetadata> のインスタンスを作成する場合、フレームワーク プロパティの特性を通知する特定のプロパティの値をそのメタデータに読み込むには、次の 2 つの方法があります。  
+  
+1.  `flags` パラメーターを使用可能な <xref:System.Windows.FrameworkPropertyMetadata> コンストラクター シグネチャを使用します。  このパラメーターには、<xref:System.Windows.FrameworkPropertyMetadataOptions> 列挙体フラグの結合された値を、必要に応じすべて指定します。  
+  
+2.  `flags` パラメーターを持たないシグネチャのいずれかを使用し、各特性の任意の変更について、<xref:System.Windows.FrameworkPropertyMetadata> 上の報告する各 Boolean プロパティを `true` に設定します。  この場合、この依存関係プロパティを持つすべての要素の構築前に、これらのプロパティを設定する必要があります。`flags` パラメーターを使用せずにメタデータを読み込めるよう、これらの Boolean プロパティは読み書き可能な状態ですが、プロパティ使用前にメタデータを事実上シールする必要があります。  そのため、メタデータの要求後にこれらのプロパティを設定しようとすると、無効な操作となります。  
+  
+<a name="Framework_Property_Metadata_Merge_Behavior"></a>   
+## フレームワーク プロパティ メタデータのマージ動作  
+ フレームワーク プロパティ メタデータをオーバーライドすると、さまざまなメタデータ特性が、マージされるか置き換えられます。  
+  
+-   <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> はマージされます。  新しい <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> を追加すると、そのコールバックがメタデータに格納されます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。  
+  
+-   <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> の実際のプロパティ システム動作では、階層内のすべてのメタデータ所有者用の実装が維持されてテーブルに追加されます。プロパティ システムによる実行順序としては、最派生クラスのコールバックが最初に呼び出されます。  継承されたコールバックは、それらをメタデータに配置したクラスによって所有されていると見なされ、それぞれ 1 回だけ実行されます。  
+  
+-   <xref:System.Windows.PropertyMetadata.DefaultValue%2A> は置き換えられます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.PropertyChangedCallback%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.DefaultValue%2A> の値は、メタデータでそれを指定した最も近い先祖によって決まります。  
+  
+-   <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> 実装は置き換えられます。  新しい <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> を追加すると、そのコールバックがメタデータに格納されます。  オーバーライド時に <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> を指定しないと、<xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> の値が昇格され、メタデータでそれを指定した最も近い先祖からの参照となります。  
+  
+-   プロパティ システム動作では、直接のメタデータ内の <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> だけが呼び出されます。  階層内の他の <xref:System.Windows.PropertyMetadata.CoerceValueCallback%2A> 実装への参照は行われません。  
+  
+-   <xref:System.Windows.FrameworkPropertyMetadataOptions> 列挙体のフラグは、ビットごとの OR 演算として組み合わされます。  <xref:System.Windows.FrameworkPropertyMetadataOptions> を指定しても、元のオプションは上書きされません。  オプションを変更するには、<xref:System.Windows.FrameworkPropertyMetadata> で対応するプロパティを設定します。  たとえば、元の <xref:System.Windows.FrameworkPropertyMetadata> オブジェクトが <xref:System.Windows.FrameworkPropertyMetadataOptions?displayProperty=fullName> フラグを設定している場合は、<xref:System.Windows.FrameworkPropertyMetadata.IsNotDataBindable%2A?displayProperty=fullName> を `false` に設定することでこのフラグを変更できます。  
+  
+ この動作は <xref:System.Windows.FrameworkPropertyMetadata.Merge%2A> によって実装され、派生メタデータ クラス上でオーバーライドできます。  
+  
+## 参照  
+ <xref:System.Windows.DependencyProperty.GetMetadata%2A>   
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/freezable-objects-overview.md b/docs/framework/wpf/advanced/freezable-objects-overview.md
new file mode 100644
index 00000000000..c63db81bdc5
--- /dev/null
+++ b/docs/framework/wpf/advanced/freezable-objects-overview.md
@@ -0,0 +1,175 @@
+---
+title: "Freezable オブジェクトの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, Freezable"
+  - "Freezable オブジェクト, description"
+  - "固定解除 (Freezable オブジェクトを)"
+ms.assetid: 89c71692-4f43-4057-b611-67c6a8a863a2
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# Freezable オブジェクトの概要
+ここでは、アプリケーションのパフォーマンス向上のための特別な機能を備えた <xref:System.Windows.Freezable> オブジェクトの、効率的な使用方法および作成方法について説明します。  フリーズ可能オブジェクトには、ブラシ、ペン、変換、ジオメトリ、アニメーションなどがあります。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="whatisafreezable"></a>   
+## Freezable \(フリーズ可能\) とは  
+ <xref:System.Windows.Freezable> は、非フリーズとフリーズの 2 つの状態を持つ特殊な型のオブジェクトです。  フリーズしていない <xref:System.Windows.Freezable> は、他のオブジェクトと同様に動作しているように見えます。  <xref:System.Windows.Freezable> をフリーズすると、変更できなくなります。  
+  
+ <xref:System.Windows.Freezable> には、オブジェクトの変更を監視者に通知するための <xref:System.Windows.Freezable.Changed> イベントがあります。  <xref:System.Windows.Freezable> をフリーズすると、変更通知のためのリソースが不要になるので、パフォーマンスが向上します。  また、フリーズされた <xref:System.Windows.Freezable> はスレッド間で共有できますが、フリーズされていない <xref:System.Windows.Freezable> は共有できません。  
+  
+ <xref:System.Windows.Freezable> クラスはさまざまな目的に使用できますが、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の <xref:System.Windows.Freezable> オブジェクトのほとんどは、グラフィックス サブシステムに関連するものです。  
+  
+ <xref:System.Windows.Freezable> クラスを使用すると、特定のグラフィックス システムのオブジェクトが使いやすくなり、アプリケーション パフォーマンスを向上させることができます。  <xref:System.Windows.Freezable> から継承するクラスには、<xref:System.Windows.Media.Brush>、<xref:System.Windows.Media.Transform>、<xref:System.Windows.Media.Geometry> などがあります。  このようなクラスにはアンマネージ リソースが格納されているので、システムはオブジェクトが変更されたかどうかを監視する必要があります。元のオブジェクトに変更があった場合は、対応するアンマネージ リソースを更新します。  実際にはグラフィックス システムのオブジェクトが変更されることがなくても、万一の変更に備えて、システムはオブジェクトの監視用にリソースの一部を消費しなければなりません。  
+  
+ たとえば、<xref:System.Windows.Media.SolidColorBrush> ブラシを作成して、ボタンの背景の塗りつぶしに使用するとします。  
+  
+ [!code-csharp[freezablesample_procedural#FrozenExamplePart1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#frozenexamplepart1)]
+ [!code-vb[freezablesample_procedural#FrozenExamplePart1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#frozenexamplepart1)]  
+  
+ ボタンがレンダリングされるとき、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のグラフィックス サブシステムは指定された情報を使用してピクセルのグループを塗りつぶし、ボタンの外観を作成します。  ボタンの描画方法を示すために単色のブラシを指定したとしても、この単色のブラシが実際に塗りつぶしを行うわけではありません。  グラフィックス システムによって、ボタンおよびブラシの高速かつ低レベルのオブジェクトが生成され、実際に画面に表示されます。  
+  
+ ブラシに変更を加える場合は、このような低レベルのオブジェクトの再生成が必要です。  Freezable クラスとは、ブラシに、自身に対応する生成済みの低レベル オブジェクトを検出して自身が変更されたときにそのオブジェクトを更新するという能力を与えるものです。  この機能が有効化されているときは、ブラシは "フリーズされていない" といいます。  
+  
+ フリーズ可能オブジェクトの <xref:System.Windows.Freezable.Freeze%2A> は、この自己更新機能を無効化するためのメソッドです。  このメソッドを使用すると、ブラシを "フリーズ" 状態、つまり変更不可能にすることができます。  
+  
+> [!NOTE]
+>  すべての Freezable オブジェクトをフリーズできるわけではありません。  <xref:System.InvalidOperationException> がスローされることを避けるには、Freezable オブジェクトをフリーズする前に <xref:System.Windows.Freezable.CanFreeze%2A> プロパティの値を調べて、フリーズ可能かどうかを判断します。  
+  
+ [!code-csharp[freezablesample_procedural#FrozenExamplePart2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#frozenexamplepart2)]
+ [!code-vb[freezablesample_procedural#FrozenExamplePart2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#frozenexamplepart2)]  
+  
+ フリーズ可能オブジェクトを変更する必要がなくなった場合は、フリーズすることによってパフォーマンスが向上します。  この例では、ブラシをフリーズすると、グラフィックス システムがブラシの変更を監視する必要はなくなります。  グラフィックス システムはこのブラシが変更されないことを認識しているので、その他の最適化も実行できるようになります。  
+  
+> [!NOTE]
+>  便宜を図るために、フリーズ可能オブジェクトは、明示的にフリーズされない限り非フリーズ状態を維持します。  
+  
+<a name="frozenfreezables"></a>   
+## Freezable の使用  
+ フリーズされていないフリーズ可能オブジェクトの使用は、その他の種類のオブジェクトの使用に似ています。  次のコード例では、<xref:System.Windows.Media.SolidColorBrush> の色をボタンの背景塗りつぶしに使用した後で、黄色から赤に変更します。  グラフィックス システムが内部的処理を行い、画面が次回更新されたときにボタンを黄色から赤に自動的に変更します。  
+  
+ [!code-csharp[freezablesample_procedural#UnFrozenExampleShort](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#unfrozenexampleshort)]
+ [!code-vb[freezablesample_procedural#UnFrozenExampleShort](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#unfrozenexampleshort)]  
+  
+### Freezable のフリーズ  
+ <xref:System.Windows.Freezable> を変更不可にするには、その<xref:System.Windows.Freezable.Freeze%2A> メソッドを呼び出します。  フリーズ可能オブジェクトを格納するオブジェクトをフリーズすると、格納されているオブジェクトもフリーズされます。  たとえば、<xref:System.Windows.Media.PathGeometry> をフリーズすると、格納されている数字およびセグメントもフリーズされます。  
+  
+ 次のいずれかに当てはまる場合は、Freezable をフリーズすることはできません。  
+  
+-   アニメーション化されたプロパティ、またはデータ バインドされたプロパティがある。  
+  
+-   プロパティが動的リソースによって設定されている   \(動的リソースの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください\)。  
+  
+-   <xref:System.Windows.Freezable> に格納されているサブオブジェクトがフリーズ不可能である。  
+  
+ これらの条件に該当しない場合に、それ以降 <xref:System.Windows.Freezable> を変更しないことが明らかならば、既に説明したように、パフォーマンスを向上させるためにオブジェクトをフリーズしてください。  
+  
+ フリーズ可能オブジェクトの <xref:System.Windows.Freezable.Freeze%2A> メソッドをいったん呼び出すと、そのオブジェクトは変更できなくなります。  フリーズされたオブジェクトを変更しようとすると、<xref:System.InvalidOperationException> がスローされます。  次のコードでは、ブラシをフリーズした後に変更しようとしているので、例外がスローされます。  
+  
+ [!code-csharp[freezablesample_procedural#ExceptionExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#exceptionexample)]
+ [!code-vb[freezablesample_procedural#ExceptionExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#exceptionexample)]  
+  
+ この例外がスローされるのを避けるには、<xref:System.Windows.Freezable.IsFrozen%2A> メソッドを使用して、<xref:System.Windows.Freezable> がフリーズされているかどうかを判断します。  
+  
+ [!code-csharp[freezablesample_procedural#CheckIsFrozenExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#checkisfrozenexample)]
+ [!code-vb[freezablesample_procedural#CheckIsFrozenExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#checkisfrozenexample)]  
+  
+ 前のコード例では、フリーズされたオブジェクトの変更可能なコピーを、<xref:System.Windows.Freezable.Clone%2A> メソッドを使用して作成しました。  複製の詳細については、次のセクションで説明します。  
+  
+ **メモ** フリーズされたフリーズ可能オブジェクトはアニメーション化できないので、<xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーション化しようとすると、フリーズされた <xref:System.Windows.Freezable> オブジェクトの変更可能な複製がアニメーション システムによって自動的に作成されます。  複製によって生じるパフォーマンス オーバーヘッドを回避するために、オブジェクトをアニメーション化する場合は非フリーズ状態のままにしてください。  ストーリーボードを使用したアニメーションの詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+### マークアップからのフリーズ  
+ マークアップで宣言された <xref:System.Windows.Freezable> オブジェクトをフリーズするには、`PresentationOptions:Freeze` 属性を使用します。  次の例では、<xref:System.Windows.Media.SolidColorBrush> を、フリーズされたページ リソースとして宣言します。  次に、このブラシを使用してボタンの背景を設定します。  
+  
+ [!code-xml[FreezableSample#FreezeFromMarkupWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FreezableSample/CS/FreezeFromMarkupExample.xaml#freezefrommarkupwholepage)]  
+  
+ `Freeze` 属性を使用するには、表示オプション名前空間 `http://schemas.microsoft.com/winfx/2006/xaml/presentation/options` に割り当てる必要があります。  この名前空間を割り当てるときの推奨プレフィックスは `PresentationOptions` です。  
+  
+```  
+xmlns:PresentationOptions="http://schemas.microsoft.com/winfx/2006/xaml/presentation/options"   
+```  
+  
+ すべての XAML リーダーがこの属性を認識するとは限らないので、[mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)を使用して、`Presentation:Freeze` 属性が無視可能であると指定することをお勧めします。  
+  
+```  
+xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+mc:Ignorable="PresentationOptions"  
+```  
+  
+ 詳細については、[mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)のページを参照してください。  
+  
+### Freezable の "フリーズ解除"  
+ <xref:System.Windows.Freezable> をフリーズすると、変更やフリーズ解除はできなくなりますが、<xref:System.Windows.Freezable.Clone%2A> メソッドまたは <xref:System.Windows.Freezable.CloneCurrentValue%2A> メソッドを使用すると、フリーズされていない複製を作成できます。  
+  
+ 次の例では、ブラシを使用してボタンの背景を設定してから、そのブラシをフリーズします。  <xref:System.Windows.Freezable.Clone%2A> メソッドを使用して、ブラシのフリーズされていない複製を作成します。  この複製を変更し、使用して、ボタンの背景を黄色から赤に変更します。  
+  
+ [!code-csharp[freezablesample_procedural#CloneExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#cloneexample)]
+ [!code-vb[freezablesample_procedural#CloneExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#cloneexample)]  
+  
+> [!NOTE]
+>  使用する Clone メソッドにかかわらず、アニメーションが新しい <xref:System.Windows.Freezable> にコピーされることはありません。  
+  
+ <xref:System.Windows.Freezable.Clone%2A> メソッドと <xref:System.Windows.Freezable.CloneCurrentValue%2A> メソッドは、フリーズ可能オブジェクトの深いコピーを生成します。  フリーズ可能オブジェクトに、他のフリーズされたフリーズ可能オブジェクトが格納されている場合は、格納されるオブジェクトも複製されて、変更可能になります。  たとえば、フリーズされた <xref:System.Windows.Media.PathGeometry> を複製して変更可能にする場合は、格納されている数字およびセグメントもコピーされ、変更可能な状態になります。  
+  
+<a name="createyourownfreezableclass"></a>   
+## 独自の Freezable クラスの作成  
+ <xref:System.Windows.Freezable> から派生するクラスには、次の機能が与えられます。  
+  
+-   特殊な状態 : 読み取り専用 \(フリーズ\) 状態と書き込み可能状態。  
+  
+-   スレッド セーフ : フリーズされた <xref:System.Windows.Freezable> は、スレッド間で共有できます。  
+  
+-   詳細な変更通知 : 他の <xref:System.Windows.DependencyObject> とは異なり、Freezable オブジェクトは、サブプロパティの値が変更されたときに変更通知を提供します。  
+  
+-   容易な複製 : Freezable クラスは、深い複製を作成するためのメソッドを既に実装しています。  
+  
+ <xref:System.Windows.Freezable> は、<xref:System.Windows.DependencyObject> の一種であるので、依存関係プロパティ システムを使用します。  作成するクラスのプロパティが依存関係プロパティである必要はありませんが、<xref:System.Windows.Freezable> クラスは依存関係プロパティを想定して設計されているので、依存関係プロパティを使用すれば、プログラミングに必要なコードの量が少なくて済みます。  依存関係プロパティ システムの詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Freezable> のすべてのサブクラスで <xref:System.Windows.Freezable.CreateInstanceCore%2A> メソッドをオーバーライドする必要があります。  作成するクラスで、すべてのデータについて依存関係プロパティを使用する場合は、これで完了です。  
+  
+ クラスに依存関係プロパティ以外のデータ メンバーが含まれている場合は、次のメソッドもオーバーライドする必要があります。  
+  
+-   <xref:System.Windows.Freezable.CloneCore%2A>  
+  
+-   <xref:System.Windows.Freezable.CloneCurrentValueCore%2A>  
+  
+-   <xref:System.Windows.Freezable.GetAsFrozenCore%2A>  
+  
+-   <xref:System.Windows.Freezable.GetCurrentValueAsFrozenCore%2A>  
+  
+-   <xref:System.Windows.Freezable.FreezeCore%2A>  
+  
+ また、依存関係プロパティではないデータ メンバーへのアクセスおよび書き込みについては、次のルールに従う必要があります。  
+  
+-   依存関係プロパティ以外のデータ メンバーを読み取る [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] の開始時に、<xref:System.Windows.Freezable.ReadPreamble%2A> メソッドを呼び出します。  
+  
+-   依存関係プロパティ以外のデータ メンバーを書き込む API の開始時に、<xref:System.Windows.Freezable.WritePreamble%2A> メソッドを呼び出します   \([!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の中で <xref:System.Windows.Freezable.WritePreamble%2A> を呼び出した後は、依存関係プロパティ以外のデータ メンバーを読み取る場合も、<xref:System.Windows.Freezable.ReadPreamble%2A> を改めて呼び出す必要はありません\)。  
+  
+-   依存関係プロパティ以外のデータ メンバーに書き込みを行うメソッドを終了する前に、<xref:System.Windows.Freezable.WritePostscript%2A> メソッドを呼び出します。  
+  
+ 作成するクラスに含まれる、依存関係プロパティ以外のデータ メンバーの中に <xref:System.Windows.DependencyObject> オブジェクトがある場合は、そのメンバーの値を変更するたびに <xref:System.Windows.Freezable.OnFreezablePropertyChanged%2A> メソッドも呼び出す必要があります \(そのメンバーを `null` に設定する場合も\)。  
+  
+> [!NOTE]
+>  オーバーライドする <xref:System.Windows.Freezable> の各メソッドの先頭で基本実装を呼び出すことが非常に重要です。  
+  
+ カスタム <xref:System.Windows.Freezable> クラスの例については、[カスタム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=159981)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Freezable>   
+ [カスタム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=159981)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/getting-started-with-ink.md b/docs/framework/wpf/advanced/getting-started-with-ink.md
new file mode 100644
index 00000000000..f40e9e84ff6
--- /dev/null
+++ b/docs/framework/wpf/advanced/getting-started-with-ink.md
@@ -0,0 +1,88 @@
+---
+title: "インクの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, グラデーション ブラシの色"
+  - "ブラシ, アニメーション化 (色を)"
+  - "グラデーション ブラシ, アニメーション化 (色を)"
+  - "XAML の代わりに手続き型コードを使用"
+  - "XAML, 代わりに手続き型コードを使用"
+ms.assetid: 760332dd-594a-475d-865b-01659db8cab7
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# インクの概要
+アプリケーションへのデジタル インクの組み込みは、今までになく容易になりました。  COM および Windows フォームによるプログラミング手法の付随的な存在であったインクは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に完全に統合されるまでに発展しました。  個別の SDK や、ランタイム ライブラリをインストールする必要はありません。  
+  
+## 必要条件  
+ 以降に示す例を使用するには、まず Microsoft Visual Studio 2005 および [!INCLUDE[TLA2#tla_winfxsdk](../../../../includes/tla2sharptla-winfxsdk-md.md)] をインストールする必要があります。  また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に対応するアプリケーションの作成方法も理解しておく必要があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の概要については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  
+  
+## クイック スタート  
+ ここでは、インクを収集する簡単な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを作成する方法を説明します。  
+  
+ Microsoft Visual Studio 2005 および [!INCLUDE[TLA#tla_winfxsdk](../../../../includes/tlasharptla-winfxsdk-md.md)] をまだインストールしていない場合はインストールしてください。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを表示するには、その全体が [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で構成されている場合でも、通常はあらかじめコンパイルしておく必要があります。  また、[!INCLUDE[TLA#tla_winfxsdk](../../../../includes/tlasharptla-winfxsdk-md.md)] には、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ベースの UI の実装作業を迅速化するために設計された、XamlPad というアプリケーションが付属しています。  このアプリケーションを使用して、このドキュメントの最初にあるいくつかのサンプルを表示し、いろいろと変更してみるとよいでしょう。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] からコンパイルされたアプリケーションを作成する作業については、このドキュメントで後に説明します。  
+  
+ XAMLPad を起動するには、\[スタート\] ボタンをクリックし、\[すべてのプログラム\] をポイントします。次に、\[Microsoft Windows SDK\] をポイントし、\[Tools\] をポイントして、\[XAMLPad\] をクリックします。  XAMLPad のレンダリング ペインには、コード ペインで作成された XAML コードがレンダリングされます。  XAML コードを編集すると、変更は直ちにレンダリング ペインに反映されます。  
+  
+#### インクを取得する  
+ インクをサポートする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを初めて作成するには、次の手順を実行します。  
+  
+1.  Microsoft Visual Studio 2005 を開きます。  
+  
+2.  新しい Windows アプリケーション \(WPF\) を作成します。  
+  
+3.  2 つの `<Grid>` タグの間に「`<InkCanvas/>`」と入力します。  
+  
+4.  デバッガーでアプリケーションを起動するために、**F5** キーを押します。  
+  
+5.  スタイラスまたはマウスを使用して、ウィンドウに「hello world」と書き込みます。  
+  
+ "hello world" アプリケーションに相当するインクが、わずか 12 回のキーストロークで書き込まれました。  
+  
+#### アプリケーションを改良する  
+ 次に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のいくつかの機能を利用してみましょう。  開始タグ \<Window\> と終了タグ \<\/Window\> の間にあるすべてのコードを、次に示すマークアップで置き換えてください。インク サーフェイスに、グラデーション ブラシによる背景が表示されます。  
+  
+ [!code-xml[DigitalInkTopics#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml#1)]  
+[!code-xml[DigitalInkTopics#1a](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml#1a)]  
+  
+#### アニメーションを使用する  
+ 今度は、グラデーション ブラシの色をアニメーション化してみましょう。  次に示す [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を、終了タグ `</InkCanvas>` と終了タグ `</Page>` の間に追加します。  
+  
+ [!code-xml[DigitalInkTopics#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml#2)]  
+  
+#### XAML に分離コードを追加する  
+ XAML を使用すると、ユーザー インターフェイスの設計は非常に簡単になりますが、実際のアプリケーションには、イベントを処理するコードを追加する必要があります。  マウスが右クリックされたときにインクを拡大表示する簡単な例を次に示します。  
+  
+ 作成した [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の中で、次のように `MouseRightButtonUp` ハンドラーを設定します。  
+  
+ [!code-xml[DigitalInkTopics#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window2.xaml#3)]  
+  
+ Visual Studio のソリューション エクスプローラーで Windows1.xaml を展開し、分離コード ファイル Window1.xaml.cs \(Visual Basic を使用している場合は Window1.xaml.vb\) を開きます。  次に示すイベント ハンドラー コードを追加します。  
+  
+ [!code-csharp[DigitalInkTopics#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window2.xaml.cs#4)]
+ [!code-vb[DigitalInkTopics#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DigitalInkTopics/VisualBasic/Window2.xaml.vb#4)]  
+  
+ ここで、アプリケーションを実行します。  いくつかのインクを追加してから、マウスで右クリックするか、またはスタイラスを使用して同等の操作であるプレス アンド ホールドを実行します。  
+  
+#### XAML の代わりに手順コードを使用する  
+ 手順コードからは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のすべての機能にアクセスできます。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を一切使用しない [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の "Hello Ink World" アプリケーションを次に示します。  Visual Studio で、次に示すコードを空のコンソール アプリケーションに貼り付けます。  PresentationCore、PresentationFramework、および WindowsBase の各アセンブリへの参照を追加し、**F5** キーを押してアプリケーションをビルドします。  
+  
+ [!code-csharp[InkCanvasConsoleApp#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkCanvasConsoleApp/CSharp/Program.cs#1)]
+ [!code-vb[InkCanvasConsoleApp#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InkCanvasConsoleApp/VisualBasic/Module1.vb#1)]  
+  
+## 参照  
+ [デジタル インク](../../../../docs/framework/wpf/advanced/digital-ink.md)   
+ [インクの収集](../../../../docs/framework/wpf/advanced/collecting-ink.md)   
+ [手書き認識](../../../../docs/framework/wpf/advanced/handwriting-recognition.md)   
+ [インクの格納](../../../../docs/framework/wpf/advanced/storing-ink.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/globalization-and-localization-how-to-topics.md b/docs/framework/wpf/advanced/globalization-and-localization-how-to-topics.md
new file mode 100644
index 00000000000..d0f301a40f8
--- /dev/null
+++ b/docs/framework/wpf/advanced/globalization-and-localization-how-to-topics.md
@@ -0,0 +1,43 @@
+---
+title: "グローバリゼーションおよびローカリゼーションに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グローバリゼーション, 機能"
+  - "ローカリゼーション, 機能"
+ms.assetid: c4b484fb-bc90-4186-a08d-f081e7109cad
+caps.latest.revision: 71
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 71
+---
+# グローバリゼーションおよびローカリゼーションに関する「方法」トピック
+このセクションのトピックでは、国際対応アプリケーションを開発する方法について説明します。  
+  
+## このセクションの内容  
+ [アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)  
+ [自動レイアウトを使用してボタンを作成する](../../../../docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md)  
+ [自動レイアウト用のグリッドを使用する](../../../../docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md)  
+ [ResourceDictionary を使用してローカライズ可能な文字列リソースを管理する](../../../../docs/framework/wpf/advanced/how-to-use-a-resourcedictionary-to-manage-localizable-string-resources.md)  
+ [ローカライズ可能アプリケーションでリソースを使用する](../../../../docs/framework/wpf/advanced/how-to-use-resources-in-localizable-applications.md)  
+  
+## 関連項目  
+ <xref:System.Globalization>  
+  
+ <xref:System.Windows.FrameworkElement.FlowDirection%2A>  
+  
+ <xref:System.Resources.NeutralResourcesLanguageAttribute>  
+  
+ [XAML における xml:lang の処理](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md)  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/globalization-and-localization.md b/docs/framework/wpf/advanced/globalization-and-localization.md
new file mode 100644
index 00000000000..ddbe0ca718c
--- /dev/null
+++ b/docs/framework/wpf/advanced/globalization-and-localization.md
@@ -0,0 +1,48 @@
+---
+title: "グローバライズとローカライズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グローバリゼーション [WPF]"
+  - "ローカリゼーション [WPF]"
+  - "Windows Presentation Foundation, グローバリゼーション"
+  - "Windows Presentation Foundation, ローカリゼーション"
+  - "WPF, グローバリゼーション"
+  - "WPF, ローカリゼーション"
+ms.assetid: e96f9764-4e3f-4d1c-bf20-3fb890118aae
+caps.latest.revision: 77
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# グローバライズとローカライズ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、国際対応アプリケーション開発の拡張サポートが備わっています。  
+  
+## このセクションの内容  
+ [WPF のグローバリゼーションおよびローカリゼーションの概要](../../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)  
+ [WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)  
+ [自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)  
+ [ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)  
+ [WPF の双方向機能の概要](../../../../docs/framework/wpf/advanced/bidirectional-features-in-wpf-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/globalization-and-localization-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Globalization>  
+  
+ <xref:System.Windows.FrameworkElement.FlowDirection%2A>  
+  
+ <xref:System.Resources.NeutralResourcesLanguageAttribute>  
+  
+ [XAML における xml:lang の処理](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md)  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/globalization-for-wpf.md b/docs/framework/wpf/advanced/globalization-for-wpf.md
new file mode 100644
index 00000000000..2f587d51381
--- /dev/null
+++ b/docs/framework/wpf/advanced/globalization-for-wpf.md
@@ -0,0 +1,192 @@
+---
+title: "WPF のグローバリゼーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グローバリゼーション"
+  - "各国対応ユーザー インターフェイス, XAML"
+  - "XAML, グローバリゼーション"
+  - "XAML, 各国対応ユーザー インターフェイス"
+ms.assetid: 4571ccfe-8a60-4f06-9b37-7ac0b1c2d10f
+caps.latest.revision: 35
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# WPF のグローバリゼーション
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションをグローバル市場向けに作成する際の注意点について説明します。  グローバリゼーションのプログラミング要素は、[!INCLUDE[TLA#tla_net](../../../../includes/tlasharptla-net-md.md)] の `System.Globalization` に定義されています。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="xaml_globalization"></a>   
+## XAML のグローバリゼーション  
+ [!INCLUDE[TLA#tla_xaml#initcap](../../../../includes/tlasharptla-xamlsharpinitcap-md.md)] は [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] に基づいており、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 仕様で定義されているグローバリゼーション サポートを利用します。  以下のセクションでは、注意する必要がある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 機能について説明します。  
+  
+<a name="char_reference"></a>   
+### 文字参照コード  
+ 文字参照コードは、それによって表される特定の [!INCLUDE[TLA#tla_unicode](../../../../includes/tlasharptla-unicode-md.md)] 文字の番号を 10 進形式または 16 進形式で指定します。  10 進形式の文字参照コードの例を次に示します。  
+  
+```  
+Ϩ  
+```  
+  
+ 次の例は、16 進形式の文字参照コードを示しています。  16 進数の前に **x** が付いていることに注意してください。  
+  
+```  
+Ϩ  
+```  
+  
+<a name="encoding"></a>   
+### エンコーディング  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、[!INCLUDE[TLA#tla_ascii](../../../../includes/tlasharptla-ascii-md.md)]、[!INCLUDE[TLA2#tla_unicode](../../../../includes/tla2sharptla-unicode-md.md)]、UTF\-16、および UTF\-8 のエンコードがサポートされています。  エンコード ステートメントは [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ドキュメントの先頭にあります。  エンコード属性が存在せず、バイト順がない場合、パーサーは既定で UTF\-8 に設定されます。  優先されるエンコードは UTF\-8 と UTF\-16 です。  UTF\-7 はサポートされていません。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルで UTF\-8 エンコードを指定する方法を次の例に示します。  
+  
+```  
+?xml encoding="UTF-8"?  
+```  
+  
+<a name="lang_attrib"></a>   
+### Language 属性  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、[xml:lang](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md) を使用して要素の言語属性を表します。  <xref:System.Globalization.CultureInfo> クラスを利用するには、言語属性の値が <xref:System.Globalization.CultureInfo> で定義済みのカルチャ名である必要があります。  [xml:lang](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md) は要素ツリーでの継承が可能で \(XML 規則では、依存関係プロパティが継承されるため必ずしも継承可能ではない\)、明示的に割り当てられていない場合の既定値は空の文字列です。  
+  
+ 言語属性は、方言を指定する場合にとても便利です。  たとえばフランス語では、フランス、ケベック、ベルギー、およびスイスで、スペル、語彙、および発音がそれぞれ異なります。  また、中国語、日本語、および韓国語は、[!INCLUDE[TLA2#tla_unicode](../../../../includes/tla2sharptla-unicode-md.md)] のコード ポイントを共有していますが、文字の形状が異なるため、まったく異なるフォントを使用します。  
+  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、`fr-CA` 言語属性を使用してカナダ フランス語を指定しています。  
+  
+```  
+<TextBlock xml:lang="fr-CA">Découvrir la France</TextBlock>  
+```  
+  
+<a name="unicode"></a>   
+### Unicode  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は、サロゲートを含むすべての [!INCLUDE[TLA2#tla_unicode](../../../../includes/tla2sharptla-unicode-md.md)] 機能をサポートしています。  [!INCLUDE[TLA2#tla_unicode](../../../../includes/tla2sharptla-unicode-md.md)] にマッピングできる文字セットはすべてサポートされます。  たとえば、GB18030 によって導入される文字は、CJK \(Chinese, Japanese, and Korean\) 統合漢字拡張 A および B とサロゲート ペアにマッピングされるため、GB18030 は完全にサポートされます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで <xref:System.Globalization.StringInfo> を使用すると、文字列にサロゲート ペアや組み合わせ文字があるかどうかに関係なく文字列を操作できます。  
+  
+<a name="design_intl_ui_with_xaml"></a>   
+## XAML による各国対応ユーザー インターフェイスの設計  
+ ここでは、アプリケーションを作成する際に考慮する必要がある[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] 機能について説明します。  
+  
+<a name="intl_text"></a>   
+### 各国対応テキスト  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] でサポートされているすべての書記体系の処理が組み込まれています。  
+  
+ 現在サポートされている書記体系を次に示します。  
+  
+-   アラビア語  
+  
+-   ベンガル語  
+  
+-   デバナガリ  
+  
+-   キリル語  
+  
+-   ギリシャ語  
+  
+-   グジャラート語  
+  
+-   グルムキー  
+  
+-   ヘブライ語  
+  
+-   表意文字  
+  
+-   カナラ語  
+  
+-   ラオス語  
+  
+-   ラテン語  
+  
+-   マラヤラム語  
+  
+-   モンゴル語  
+  
+-   オディア語  
+  
+-   シリア語  
+  
+-   タミル語  
+  
+-   テルグ語  
+  
+-   ターナ  
+  
+-   タイ語\*  
+  
+-   チベット語  
+  
+ \* このリリースでは、タイ語テキストの表示と編集はサポートされていますが、単語の区切りはサポートされていません。  
+  
+ 現在サポートされていない書記体系を次に示します。  
+  
+-   クメール語  
+  
+-   韓国語の古ハングル  
+  
+-   ミャンマー  
+  
+-   シンハラ語  
+  
+ すべての書記体系エンジンで [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントがサポートされています。  [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォントには [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] レイアウト テーブルを含めることができるため、フォント作成者は、各国対応が強化された高品質なタイポグラフィ フォントをデザインすることができます。  [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォント レイアウト テーブルには、グリフ代替、グリフの配置、両端揃え、およびベースラインの配置に関する情報が含まれています。これにより、テキスト処理アプリケーションによるテキスト レイアウトが強化されます。  
+  
+ [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォントでは、[!INCLUDE[TLA2#tla_unicode](../../../../includes/tla2sharptla-unicode-md.md)] エンコードを使用して大きなグリフ セットを処理することができます。  こうしたエンコードにより、グリフの文字体裁のバリエーションだけでなく、各国対応の幅も広がります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のテキスト レンダリングには、解像度に依存しないレンダリングをサポートする [!INCLUDE[TLA#tla_ct](../../../../includes/tlasharptla-ct-md.md)] サブピクセル テクノロジが利用されています。  これにより読みやすさが大幅に向上し、すべての書記体系で高品質な雑誌スタイルのドキュメントをサポートできるようになります。  
+  
+<a name="intl_layout"></a>   
+### 各国対応レイアウト  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、横型、縦型、および双方向のレイアウトをサポートするための非常に便利な方法が用意されています。  プレゼンテーション フレームワークで、<xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティを使用してレイアウトを定義できます。  フロー方向のパターンは次のとおりです。  
+  
+-   *LeftToRight* : ラテン言語や東アジア言語などの横型レイアウト。  
+  
+-   *RightToLeft* : アラビア語やヘブライ語などの双方向レイアウト。  
+  
+<a name="developing_localizable_apps"></a>   
+## ローカライズ可能なアプリケーションの開発  
+ 世界各国で使用されるアプリケーションを作成する際には、アプリケーションがローカライズ可能でなければならないということを念頭に置く必要があります。  以下のトピックでは、その際に考慮する必要がある点について説明します。  
+  
+<a name="mui"></a>   
+### 複数言語ユーザー インターフェイス  
+ [!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] では、MUI \(Multilingual User Interface\) によって言語間での [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] の切り替えをサポートしています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、アセンブリ モデルを使用して MUI をサポートします。  1 つのアプリケーションに、言語に依存しないアセンブリと、言語に依存するサテライト リソース アセンブリが含まれます。  エントリ ポイントはメイン アセンブリのマネージ .EXE です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] リソース ローダーは、[!INCLUDE[TLA2#tla_netframewk](../../../../includes/tla2sharptla-netframewk-md.md)] のリソース マネージャーを利用して、リソースのルックアップとフォールバックをサポートします。  複数の言語サテライト アセンブリが同じメイン アセンブリで動作します。  読み込まれるリソース アセンブリは、現在のスレッドの <xref:System.Globalization.CultureInfo.CurrentUICulture%2A> によって決まります。  
+  
+<a name="localizable_ui"></a>   
+### ローカライズ可能なユーザー インターフェイス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を定義します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、一連のプロパティとロジックを持つオブジェクトの階層を指定することができます。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は主に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの開発に使用されますが、任意の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトの階層を指定することもできます。  ほとんどの開発者は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用してアプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を指定し、[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] などのプログラミング言語を使用してユーザー操作に応答します。  
+  
+ リソースの観点から見た場合、言語に依存しない [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を記述するために作成された [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルはリソース要素であるため、各国の言語をサポートするためには、最終的にローカライズ可能な形式で配布する必要があります。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] はイベントを処理できないため、多くの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] アプリケーションにはそのためのコードが含まれています。  詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルが XAML の BAML 形式にトークン化されると、コードが取り除かれて別のバイナリにコンパイルされます。XAML の BAML 形式のファイル、イメージ、およびその他の種類のマネージ リソース オブジェクトは、他の言語にローカライズできるようにサテライト リソース アセンブリに埋め込まれるか、ローカリゼーションが不要な場合にはメイン アセンブリに埋め込まれます。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、文字列テーブルやイメージなどを含むすべての [!INCLUDE[TLA2#tla_netframewk](../../../../includes/tla2sharptla-netframewk-md.md)] [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] リソースをサポートしています。  
+  
+<a name="building_localizable_apps"></a>   
+### ローカライズ可能なアプリケーションのビルド  
+ ローカリゼーションとは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を異なるカルチャに適合させることを意味します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションをローカライズ可能にするには、ローカライズ可能なすべてのリソースをリソース アセンブリに組み込む必要があります。  リソース アセンブリはさまざまな言語にローカライズされ、分離コードがリソース管理 [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] を使用して読み込みます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに必要なファイルの 1 つはプロジェクト ファイル \(.proj\) です。  プロジェクト ファイルには、アプリケーションで使用するすべてのリソースを含める必要があります。  .csproj ファイルの場合の例を次に示します。  
+  
+```  
+<Resource Include="data\picture1.jpg"/>  
+<EmbeddedResource Include="data\stringtable.en-US.restext"/>  
+```  
+  
+ アプリケーションでリソースを使用するには、<xref:System.Resources.ResourceManager> をインスタンス化し、使用するリソースを読み込みます。  この方法を次の例に示します。  
+  
+ [!code-csharp[LocalizationResources#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationResources/CSharp/page1.xaml.cs#2)]  
+  
+<a name="using_clickonce"></a>   
+## ローカライズされたアプリケーションでの ClickOnce の使用  
+ ClickOnce は Windows フォームの新しい配置テクノロジで、[!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] で利用できます。  これにより、アプリケーションのインストールや Web アプリケーションのアップグレードを行うことができます。  ClickOnce で配置されたアプリケーションをローカライズした場合、ローカライズしたカルチャ以外では表示できません。  たとえば、配置されたアプリケーションを日本語にローカライズすると、日本語の [!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] でしか表示できなくなります \(英語の [!INCLUDE[TLA2#tla_win](../../../../includes/tla2sharptla-win-md.md)] では表示できません\)。  日本のユーザーが英語版の [!INCLUDE[TLA2#tla_win](../../../../includes/tla2sharptla-win-md.md)] を実行するケースは珍しくないため、これは問題になります。  
+  
+ この問題を解決するには、ニュートラル言語フォールバック属性を設定します。  アプリケーション開発者は、リソースをメイン アセンブリから削除して、特定のカルチャに対応するサテライト アセンブリにそのリソースを置くように指定することができます。  この処理を制御するには、<xref:System.Resources.NeutralResourcesLanguageAttribute> を使用します。  <xref:System.Resources.NeutralResourcesLanguageAttribute> クラスのコンストラクターには 2 つのシグネチャがあります。そのうちの 1 つは、<xref:System.Resources.ResourceManager> がフォールバック リソースを抽出する場所 \(メイン アセンブリかサテライト アセンブリか\) を指定する <xref:System.Resources.UltimateResourceFallbackLocation> パラメーターを受け取ります。  この属性を使用する方法の例を次に示します。  このコードでは、最終フォールバック位置について、現在実行しているアセンブリのディレクトリの "de" サブディレクトリからリソースを検索するように <xref:System.Resources.ResourceManager> に指示しています。  
+  
+```  
+[assembly: NeutralResourcesLanguageAttribute(  
+    "de" , UltimateResourceFallbackLocation.Satellite)]  
+  
+```  
+  
+## 参照  
+ [WPF のグローバリゼーションおよびローカリゼーションの概要](../../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/glyphs.md b/docs/framework/wpf/advanced/glyphs.md
new file mode 100644
index 00000000000..0c44487ea83
--- /dev/null
+++ b/docs/framework/wpf/advanced/glyphs.md
@@ -0,0 +1,39 @@
+---
+title: "グリフ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "GlyphRun オブジェクト"
+  - "GlyphRunDrawing オブジェクト"
+  - "グリフ [WPF]"
+  - "Glyphs 要素"
+  - "テキスト, グリフ"
+ms.assetid: d5d9274c-23b3-4859-8869-6e64403c9ca7
+caps.latest.revision: 54
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 54
+---
+# グリフ
+グリフは、画面上に描画される文字の低レベルの表現です。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、ユーザーが書式設定後にテキストを途中受信して保持できるように、グリフへの直接アクセスをサポートします。  
+  
+## このセクションの内容  
+ [GlyphRun オブジェクトと Glyphs 要素の概要](../../../../docs/framework/wpf/advanced/introduction-to-the-glyphrun-object-and-glyphs-element.md)  
+ [方法 : グリフを使用してテキストを描画する](../../../../docs/framework/wpf/advanced/draw-text-using-glyphs.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.GlyphRun>   
+ <xref:System.Windows.Media.DrawingContext.DrawText%2A>   
+ <xref:System.Windows.Documents.Glyphs>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/graphics-rendering-tiers.md b/docs/framework/wpf/advanced/graphics-rendering-tiers.md
new file mode 100644
index 00000000000..47168fe8064
--- /dev/null
+++ b/docs/framework/wpf/advanced/graphics-rendering-tiers.md
@@ -0,0 +1,145 @@
+---
+title: "グラフィックスの描画層 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックスの描画層"
+  - "グラフィックス, パフォーマンス"
+  - "グラフィックス, 描画層"
+  - "描画 (グラフィックスを)"
+  - "描画層"
+ms.assetid: 08dd1606-02a2-4122-9351-c0afd2ec3a70
+caps.latest.revision: 44
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 43
+---
+# グラフィックスの描画層
+描画層は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを実行するデバイスのグラフィックス ハードウェアの機能およびパフォーマンスのレベルを定義します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="graphics_hardware"></a>   
+## グラフィックス ハードウェア  
+ 描画層のレベルに大きく影響するグラフィックス ハードウェアの機能は、次のとおりです。  
+  
+-   **ビデオ RAM** グラフィックス ハードウェアのビデオ メモリの量によって、グラフィックスを合成する際に使用できるバッファーのサイズと数が決まります。  
+  
+-   **ピクセル シェーダー** ピクセル シェーダーは、ピクセル単位で効果を計算するグラフィックス処理関数です。  表示するグラフィックスの解像度によっては、各表示フレームの処理に数百万ピクセルが必要な場合もあります。  
+  
+-   **頂点シェーダー** 頂点シェーダーは、オブジェクトの頂点データの算術演算を実行するグラフィックス処理関数です。  
+  
+-   **マルチテクスチャのサポート** マルチテクスチャがサポートされていると、3D グラフィックス オブジェクトのブレンド操作を行うときに、2 つ以上の別個のテクスチャを適用できます。  マルチテクスチャのサポートの度合いは、グラフィックス ハードウェアのマルチテクスチャ ユニットの数によって決まります。  
+  
+<a name="rendering_tier_definitions"></a>   
+## 描画層の定義  
+ グラフィックス ハードウェアの機能によって、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの表示能力が決まります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] システムは、次の 3 つの描画階層を定義します。  
+  
+-   **描画層 0** グラフィックス ハードウェアの加速が使用されません。  すべてのグラフィックス機能で、ソフトウェア アクセラレータを使用します。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは Version 9.0 未満です。  
+  
+-   **描画層 1** 一部のグラフィックス機能で、グラフィックス ハードウェア アクセラレータを使用します。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは Version 9.0 以上です。  
+  
+-   **描画層 2** ほとんどのグラフィックス機能でグラフィックス ハードウェアの加速を使用します。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは Version 9.0 以上です。  
+  
+ <xref:System.Windows.Media.RenderCapability.Tier%2A?displayProperty=fullName> プロパティを使用すると、アプリケーションの実行時に描画層を取得できます。  描画層を使用すると、特定のハードウェア アクセラレータ グラフィックス機能がデバイスでサポートされているかどうかを確認できます。  アプリケーションは、デバイスでサポートされている描画層に応じて、実行時に異なるコード パスを受け取ることができます。  
+  
+### 描画層 0  
+ 描画層の値 0 は、デバイスのアプリケーションに使用できるグラフィックス ハードウェア アクセラレータがないことを示します。  この描画層では、すべてのグラフィックスがハードウェア アクセラレータを使用せずにソフトウェアで描画されることを想定する必要があります。  この層の機能は、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] の 9.0 未満の Version に対応します。  
+  
+### 描画層 1 および描画層 2  
+  
+> [!NOTE]
+>  .NET Framework 4 以降、描画層 1 は、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 以降をサポートするグラフィックス ハードウェアのみを含むように再定義されています。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 7 または 8 をサポートするグラフィックス ハードウェアは、描画層 0 と定義されています。  
+  
+ 描画層の値 1 または 2 は、必要なシステム リソースが使用可能であり、枯渇していない場合に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のほとんどのグラフィックス機能がハードウェア アクセラレータを使用することを示します。  これは、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] の 9.0 以上の Version に対応します。  
+  
+ 描画層 1 と描画層 2 のグラフィックス ハードウェア要件の違いを次の表に示します。  
+  
+|機能|層 1|層 2|  
+|--------|---------|---------|  
+|[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン|9.0 以上であることが必要です。|9.0 以上であることが必要です。|  
+|ビデオ RAM|60 MB 以上であることが必要です。|120 MB 以上であることが必要です。|  
+|ピクセル シェーダー|バージョン レベルは、2.0 以上であることが必要です。|バージョン レベルは、2.0 以上であることが必要です。|  
+|頂点シェーダー|要件は特にありません。|バージョン レベルは、2.0 以上であることが必要です。|  
+|マルチテクスチャ単位|要件は特にありません。|単位数は、4 以上であることが必要です。|  
+  
+ 描画層 1 および描画層 2 では、以下の機能がハードウェア アクセラレータによって加速されます。  
+  
+|機能|説明|  
+|--------|--------|  
+|2D レンダリング|ほとんどの 2D レンダリングがサポートされています。|  
+|3D ラスタライズ|ほとんどの 3D ラスタライズがサポートされています。|  
+|3D 異方性フィルタリング|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、3D コンテンツの描画時に異方性フィルタリングの使用が試行されます。  異方性フィルタリングとは、カメラから遠く、視線角度のきつい位置にあるサーフェイス上のテクスチャの画質を向上させる手法です。|  
+|3D ミップマップ|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、3D コンテンツの描画時にミップマップの使用が試行されます。ミップマップを使用すると、テクスチャが <xref:System.Windows.Controls.Viewport3D> の狭い視野を占める場合にテクスチャの描画品質が向上します。|  
+|放射状グラデーション|サポートされますが、大きなオブジェクトでは <xref:System.Windows.Media.RadialGradientBrush> を使用しないでください。|  
+|3D の光源計算|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、頂点ごとの光源処理を実行します。そのため、メッシュに適用されている各素材の頂点ごとに光の強さを計算する必要があります。|  
+|テキストの描画|サブピクセル フォントの描画では、グラフィックス ハードウェアで利用可能なピクセル シェーダーを使用します。|  
+  
+ 描画層 2 に対してのみ、以下の機能がハードウェア アクセラレータによって加速されます。  
+  
+|機能|説明|  
+|--------|--------|  
+|3D アンチエイリアシング|3D アンチエイリアシングは、Windows Display Driver Model \(WDDM\) をサポートするオペレーティング システム \([!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)]、[!INCLUDE[win7](../../../../includes/win7-md.md)] など\) でのみサポートされます。|  
+  
+ 以下の機能はハードウェア アクセラレータによって加速されません。  
+  
+|機能|説明|  
+|--------|--------|  
+|印刷されるコンテンツ|印刷されるすべてのコンテンツが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ソフトウェア パイプラインによって表示されます。|  
+|<xref:System.Windows.Media.Imaging.RenderTargetBitmap> を使用する、ラスタライズされたコンテンツ|すべてのコンテンツが、<xref:System.Windows.Media.Imaging.RenderTargetBitmap> の <xref:System.Windows.Media.Imaging.RenderTargetBitmap.Render%2A> メソッドによって描画されます。|  
+|<xref:System.Windows.Media.TileBrush> を使用する、並べて表示されるコンテンツ|すべての並べて表示されるコンテンツにおいて <xref:System.Windows.Media.TileBrush> の <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティが <xref:System.Windows.Media.TileMode> に設定されます。|  
+|グラフィックス ハードウェアの最大テクスチャ サイズを超えるサーフェイス。|ほとんどのグラフィックス ハードウェアでは、大型のサーフェイスのサイズは 2048 x 2048 ピクセルまたは 4096 x 4096 ピクセルです。|  
+|必要なビデオ RAM 容量がグラフィックス ハードウェアのメモリ容量を上回るすべての操作|Windows SDK の [WPF Performance Suite](../Topic/WPF%20Performance%20Suite.md) に付属する Perforator ツールを使用して、アプリケーション ビデオ RAM の使用量を監視できます。|  
+|レイヤード ウィンドウ|レイヤード ウィンドウを使用すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで、コンテンツを四角形以外のウィンドウの画面に描画できます。  Windows Display Driver Model \(WDDM\) をサポートするオペレーティング システム \([!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)]、[!INCLUDE[win7](../../../../includes/win7-md.md)] など\) では、レイヤード ウィンドウはハードウェア アクセラレータによって加速されます。  [!INCLUDE[winxp](../../../../includes/winxp-md.md)] などのその他のシステムでは、レイヤード ウィンドウはハードウェア アクセラレータを使用せずにソフトウェアで描画されます。<br /><br /> [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でレイヤード ウィンドウを有効にするには、<xref:System.Windows.Window> の次のプロパティを設定します。<br /><br /> -   <xref:System.Windows.Window.WindowStyle%2A> \= <xref:System.Windows.WindowStyle><br />-   <xref:System.Windows.Window.AllowsTransparency%2A> \= `true`<br />-   <xref:System.Windows.Controls.Control.Background%2A> \= <xref:System.Windows.Media.Brushes.Transparent%2A>|  
+  
+<a name="other_resources"></a>   
+## その他のリソース  
+ 次の技術情報は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのパフォーマンス特性の分析に役立ちます。  
+  
+### グラフィックス レンダリングのレジストリ設定  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のレンダリングを制御するために 4 つのレジストリ設定が用意されています。  
+  
+|設定|Description|  
+|--------|-----------------|  
+|**Disable Hardware Acceleration Option**|ハードウェア アクセラレータを有効にするかどうかを指定します。|  
+|**Maximum Multisample Value**|[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] コンテンツのアンチエイリアシングのマルチサンプリングの度合いを指定します。|  
+|**Required Video Driver Date Setting**|2004 年 11 月より前にリリースされたドライバーに対してハードウェア アクセラレータをシステムで無効にするかどうかを指定します。|  
+|**Use Reference Rasterizer Option**|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でリファレンス ラスタライザーを使用するかどうかを指定します。|  
+  
+ これらの設定には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レジストリ設定の参照方法を認識している外部構成ユーティリティを使用してアクセスできます。  また、これらの設定は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] レジストリ エディターを使用して値に直接アクセスして作成または変更することもできます。  詳細については、「[グラフィックス レンダリングのレジストリ設定](../../../../docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md)」を参照してください。  
+  
+### WPF パフォーマンス プロファイリング ツール  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、アプリケーションの実行時の動作を分析したり、適用可能なパフォーマンス最適化の種類を決定できるパフォーマンス プロファイリング ツール スイートを提供します。  [!INCLUDE[TLA2#tla_lhsdk](../../../../includes/tla2sharptla-lhsdk-md.md)] ツール \(WPF Performance Suite\) に含まれるパフォーマンス プロファイリング ツールを次の表に示します。  
+  
+|ツール|Description|  
+|---------|-----------------|  
+|Perforator|レンダリング動作の分析に使用します。|  
+|ビジュアル プロファイラー|ビジュアル ツリーの要素による [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] サービス \(レイアウトやイベント処理など\) の使用状況に関するプロファイリングで使用します。|  
+  
+ WPF Performance Suite では、パフォーマンス データを多彩なグラフィカル ビューで表示できます。  WPF のパフォーマンス ツールの詳細については、「[WPF Performance Suite](../Topic/WPF%20Performance%20Suite.md)」を参照してください。  
+  
+### DirectX 診断ツール  
+ [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 診断ツール \(Dxdiag.exe\) は、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 関連の問題のトラブルシューティングを支援します。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 診断ツールの既定のインストール フォルダーは次のとおりです。  
+  
+ `~\Windows\System32`  
+  
+ [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 診断ツールを実行すると、メイン ウィンドウに一連のタブが表示され、これらのタブを使用して [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] 関連の情報を表示および診断することができます。  たとえば、\[システム\] タブにはコンピューターに関するシステム情報が表示され、コンピューターにインストールされている [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョンが示されます。  
+  
+ ![スクリーンショット: DirectX 診断ツール](../../../../docs/framework/wpf/advanced/media/directxdiagnostictool-01.png "DirectXDiagnosticTool\_01")  
+DirectX 診断ツールのメイン ウィンドウ  
+  
+## 参照  
+ <xref:System.Windows.Media.RenderCapability>   
+ <xref:System.Windows.Media.RenderOptions>   
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [WPF Performance Suite](../Topic/WPF%20Performance%20Suite.md)   
+ [グラフィックス レンダリングのレジストリ設定](../../../../docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md)   
+ [アニメーションのヒントとテクニック](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/handwriting-recognition.md b/docs/framework/wpf/advanced/handwriting-recognition.md
new file mode 100644
index 00000000000..85df287f0c0
--- /dev/null
+++ b/docs/framework/wpf/advanced/handwriting-recognition.md
@@ -0,0 +1,43 @@
+---
+title: "手書き認識 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "手書き認識"
+  - "認識 (手書きの)"
+ms.assetid: f4e8576d-e731-4bac-9818-22e2ae636636
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 手書き認識
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プラットフォームでのデジタル インクに関連した認識の基礎について説明します。  
+  
+## 認識ソリューション  
+ <xref:System.Windows.Ink.InkAnalyzer> を使用してインクを認識する方法を次の例に示します。  
+  
+> [!NOTE]
+>  このサンプルでは、手書き認識エンジンをシステムにインストールする必要があります。  
+  
+ Visual Studio 2005 で、InkRecognition という新しい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション プロジェクトを作成します。  Window1.xaml ファイルの内容を次の XAML コードに置き換えます。  このコードは、アプリケーションのユーザー インターフェイスを表示します。  
+  
+ [!code-xml[InkRecognition#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkRecognition/CSharp/Window1.xaml#1)]  
+  
+ WPF インク分析アセンブリ \(IAWinFX.dll、IACore.dll、および IALoader.dll\) への参照を追加します。これらのファイルは、\\Program Files\\Reference Assemblies\\Microsoft\\Tablet PC\\v1.7 にあります。  この分離コード ファイルの内容を次のコードに置き換えます。  
+  
+ [!code-csharp[InkRecognition#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkRecognition/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[InkRecognition#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InkRecognition/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Ink.InkAnalyzer>   
+ <xref:System.Windows.Ink.AnalysisStatus>   
+ <xref:System.Windows.Controls.InkCanvas>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/hosting-win32-content-in-wpf.md b/docs/framework/wpf/advanced/hosting-win32-content-in-wpf.md
new file mode 100644
index 00000000000..95368326b29
--- /dev/null
+++ b/docs/framework/wpf/advanced/hosting-win32-content-in-wpf.md
@@ -0,0 +1,375 @@
+---
+title: "WPF での Win32 コンテンツのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "相互運用性 [WPF], チュートリアル"
+  - "相互運用性 [WPF], Win32"
+  - "Win32 コード, WPF 相互運用"
+ms.assetid: 3cc8644a-34f3-4082-9ddc-77623e4df2d8
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# WPF での Win32 コンテンツのホスト
+## 必須コンポーネント  
+ 「[WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)」を参照してください。  
+  
+## Windows Presentation Framework \(HwndHost\) 内の Win32 のチュートリアル  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内で [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンテンツを再利用するには、<xref:System.Windows.Interop.HwndHost> を使用します。<xref:System.Windows.Interop.HwndHost> は、HWND を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのように見せるコントロールです。  <xref:System.Windows.Interop.HwndSource> と同様に、<xref:System.Windows.Interop.HwndHost> は簡単に使用できます。<xref:System.Windows.Interop.HwndHost> から派生し、`BuildWindowCore` メソッドと `DestroyWindowCore` メソッドを実装して、<xref:System.Windows.Interop.HwndHost> 派生クラスをインスタンス化し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内に配置します。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ロジックが既にコントロールとしてパッケージ化されている場合、`BuildWindowCore` 実装は、`CreateWindow` の呼び出しとほとんど変わりません。  たとえば、[!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] で [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] LISTBOX コントロールを作成するには、次のようにします。  
+  
+```  
+virtual HandleRef BuildWindowCore(HandleRef hwndParent) override {  
+    HWND handle = CreateWindowEx(0, L"LISTBOX",   
+    L"this is a Win32 listbox",  
+    WS_CHILD | WS_VISIBLE | LBS_NOTIFY  
+    | WS_VSCROLL | WS_BORDER,  
+    0, 0, // x, y  
+    30, 70, // height, width  
+    (HWND) hwndParent.Handle.ToPointer(), // parent hwnd  
+    0, // hmenu  
+    0, // hinstance  
+    0); // lparam  
+  
+    return HandleRef(this, IntPtr(handle));  
+}  
+  
+virtual void DestroyWindowCore(HandleRef hwnd) override {  
+    // HwndHost will dispose the hwnd for us  
+}  
+```  
+  
+ しかし、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードがあまり自己完結的ではないこともあります。  その場合は、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ダイアログ ボックスを作成して、そのコンテンツをより大きい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに埋め込みます。  サンプルでは、これを [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] と [!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] で示していますが、別の言語またはコマンド ラインで実行することも可能です。  
+  
+ まず、[!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] プロジェクトにコンパイルされる単純なダイアログから始めます。  
+  
+ 次に、より大きい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションにダイアログを導入します。  
+  
+-   [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] をマネージとしてコンパイルします \(`/clr`\)。  
+  
+-   ダイアログをコントロールに変換します。  
+  
+-   <xref:System.Windows.Interop.HwndHost> の派生クラスを `BuildWindowCore` メソッドと `DestroyWindowCore` メソッドで定義します。  
+  
+-   `TranslateAccelerator` メソッドをオーバーライドして、ダイアログ キーを処理します。  
+  
+-   `TabInto` メソッドをオーバーライドして、Tab キーによる移動をサポートします。  
+  
+-   `OnMnemonic` メソッドをオーバーライドして、ニーモニックをサポートします。  
+  
+-   <xref:System.Windows.Interop.HwndHost> サブクラスをインスタンス化し、それを適切な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の下に置きます。  
+  
+### ダイアログをコントロールに変換します。  
+ WS\_CHILD スタイルと DS\_CONTROL スタイルを使用して、ダイアログ ボックスを子 HWND に変換できます。  ダイアログが定義されているリソース ファイル \(.rc\) に移動し、次のようなダイアログ定義の先頭を見つけます。  
+  
+```  
+IDD_DIALOG1 DIALOGEX 0, 0, 303, 121  
+STYLE DS_SETFONT | DS_MODALFRAME | DS_FIXEDSYS | WS_POPUP | WS_CAPTION | WS_SYSMENU  
+```  
+  
+ 2 行目を次のように変更します。  
+  
+```  
+STYLE DS_SETFONT | WS_CHILD | WS_BORDER | DS_CONTROL  
+```  
+  
+ この操作では、ダイアログが自己完結的なコントロールに完全にパッケージ化されることはありません。[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] が特定のメッセージを処理できるように、`IsDialogMessage()` を呼び出す必要があります。ただし、コントロールを変更すると、それらのコントロールを別の HWND に簡単に置くことができます。  
+  
+## サブクラス HwndHost  
+ 次の名前空間をインポートします。  
+  
+```  
+namespace ManagedCpp  
+{  
+    using namespace System;  
+    using namespace System::Windows;  
+    using namespace System::Windows::Interop;  
+    using namespace System::Windows::Input;  
+    using namespace System::Windows::Media;  
+    using namespace System::Runtime::InteropServices;  
+```  
+  
+ 次に、<xref:System.Windows.Interop.HwndHost> の派生クラスを作成し、`BuildWindowCore` メソッドと `DestroyWindowCore` メソッドをオーバーライドします。  
+  
+```  
+public ref class MyHwndHost : public HwndHost, IKeyboardInputSink {  
+    private:  
+        HWND dialog;  
+  
+    protected:   
+        virtual HandleRef BuildWindowCore(HandleRef hwndParent) override {  
+            InitializeGlobals();   
+            dialog = CreateDialog(hInstance,   
+                MAKEINTRESOURCE(IDD_DIALOG1),   
+                (HWND) hwndParent.Handle.ToPointer(),  
+                (DLGPROC) About);   
+            return HandleRef(this, IntPtr(dialog));  
+        }  
+  
+        virtual void DestroyWindowCore(HandleRef hwnd) override {  
+            // hwnd will be disposed for us  
+        }  
+```  
+  
+ ここでは、`CreateDialog` を使用して実際のコントロールであるダイアログ ボックスを作成します。  これは、[!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] 内で最初に呼び出されるメソッドの 1 つであるため、後から定義する、`InitializeGlobals()` という名前の関数を呼び出して標準の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 初期化を実行することも必要です。  
+  
+```  
+bool initialized = false;  
+    void InitializeGlobals() {  
+        if (initialized) return;  
+        initialized = true;  
+  
+        // TODO: Place code here.  
+        MSG msg;  
+        HACCEL hAccelTable;  
+  
+        // Initialize global strings  
+        LoadString(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);  
+        LoadString(hInstance, IDC_TYPICALWIN32DIALOG, szWindowClass, MAX_LOADSTRING);  
+        MyRegisterClass(hInstance);  
+  
+```  
+  
+### TranslateAccelerator Method のオーバーライドによるダイアログ キーの処理  
+ このサンプルをこのまま実行すると、ダイアログ コントロールは表示されますが、ダイアログ ボックスが実際に使用できるようになるためのキーボード処理は、すべて無視されます。  ここでは、\(<xref:System.Windows.Interop.HwndHost> が実装するインターフェイスである `IKeyboardInputSink` から取得する\) `TranslateAccelerator` 実装をオーバーライドする必要があります。  このメソッドは、アプリケーションが WM\_KEYDOWN および WM\_SYSKEYDOWN を受け取ったときに呼び出されます。  
+  
+```  
+  
+#undef TranslateAccelerator  
+        virtual bool TranslateAccelerator(System::Windows::Interop::MSG% msg,   
+            ModifierKeys modifiers) override   
+        {  
+            ::MSG m = ConvertMessage(msg);  
+  
+            // Win32's IsDialogMessage() will handle most of our tabbing, but doesn't know   
+            // what to do when it reaches the last tab stop  
+            if (m.message == WM_KEYDOWN && m.wParam == VK_TAB) {  
+                HWND firstTabStop = GetDlgItem(dialog, IDC_EDIT1);  
+                HWND lastTabStop = GetDlgItem(dialog, IDCANCEL);  
+                TraversalRequest^ request = nullptr;  
+  
+                if (GetKeyState(VK_SHIFT) && GetFocus() == firstTabStop) {  
+                    // this code should work, but there’s a bug with interop shift-tab in current builds                      
+                    request = gcnew TraversalRequest(FocusNavigationDirection::Last);  
+                }  
+                else if (!GetKeyState(VK_SHIFT) && GetFocus() == lastTabStop) {  
+                    request = gcnew TraversalRequest(FocusNavigationDirection::Next);  
+                }  
+  
+                if (request != nullptr)  
+                    return ((IKeyboardInputSink^) this)->KeyboardInputSite->OnNoMoreTabStops(request);  
+  
+            }  
+  
+            // Only call IsDialogMessage for keys it will do something with.  
+            if (msg.message == WM_SYSKEYDOWN || msg.message == WM_KEYDOWN) {  
+                switch (m.wParam) {  
+                    case VK_TAB:  
+                    case VK_LEFT:  
+                    case VK_UP:  
+                    case VK_RIGHT:  
+                    case VK_DOWN:  
+                    case VK_EXECUTE:  
+                    case VK_RETURN:  
+                    case VK_ESCAPE:  
+                    case VK_CANCEL:  
+                        IsDialogMessage(dialog, &m);  
+                        // IsDialogMessage should be called ProcessDialogMessage --  
+                        // it processes messages without ever really telling you  
+                        // if it handled a specific message or not  
+                        return true;  
+                }  
+            }  
+  
+            return false; // not a key we handled  
+        }  
+```  
+  
+ この例には多くのコードが含まれているため、そのいくつかについて詳しく説明します。  最初に、[!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] および [!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] のマクロを使用するコードについて、`TranslateAccelerator` という名前のマクロが既に存在し、winuser.h で次のように定義されていることに注意する必要があります。  
+  
+```  
+#define TranslateAccelerator  TranslateAcceleratorW  
+```  
+  
+ このため、`TranslateAcceleratorW` メソッドではなく `TranslateAccelerator` メソッドを定義する必要があります。  
+  
+ 同様に、アンマネージ winuser.h MSG とマネージ `Microsoft::Win32::MSG` struct の両方が存在します。  [!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] `::` 演算子を使用して、この 2 つの MSG のあいまいさを解消できます。  
+  
+```  
+  
+virtual bool TranslateAccelerator(System::Windows::Interop::MSG% msg,   
+    ModifierKeys modifiers) override   
+{  
+    ::MSG m = ConvertMessage(msg);  
+```  
+  
+ 2 つの MSG のデータは同じですが、アンマネージ定義を使用した方が簡単な場合があるため、このサンプルでは次のように明確な変換ルーチンを定義できます。  
+  
+```  
+::MSG ConvertMessage(System::Windows::Interop::MSG% msg) {  
+    ::MSG m;  
+    m.hwnd = (HWND) msg.hwnd.ToPointer();  
+    m.lParam = (LPARAM) msg.lParam.ToPointer();  
+    m.message = msg.message;  
+    m.wParam = (WPARAM) msg.wParam.ToPointer();  
+  
+    m.time = msg.time;  
+  
+    POINT pt;  
+    pt.x = msg.pt_x;  
+    pt.y = msg.pt_y;  
+    m.pt = pt;  
+  
+    return m;  
+}  
+```  
+  
+ `TranslateAccelerator` に戻ります。  基本的な原則は、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 関数 `IsDialogMessage` を呼び出して、できる限り多くの作業を実行することですが、`IsDialogMessage` はダイアログ外のものには一切アクセスできません。ユーザーがダイアログ内を Tab キーで移動し、Tab キーがダイアログ内の最後のコントロールを超える場合は、`IKeyboardInputSite::OnNoMoreStops` を呼び出してフォーカスを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の部分に設定する必要があります。  
+  
+```  
+// Win32's IsDialogMessage() will handle most of the tabbing, but doesn't know   
+// what to do when it reaches the last tab stop  
+if (m.message == WM_KEYDOWN && m.wParam == VK_TAB) {  
+    HWND firstTabStop = GetDlgItem(dialog, IDC_EDIT1);  
+    HWND lastTabStop = GetDlgItem(dialog, IDCANCEL);  
+    TraversalRequest^ request = nullptr;  
+  
+    if (GetKeyState(VK_SHIFT) && GetFocus() == firstTabStop) {  
+        request = gcnew TraversalRequest(FocusNavigationDirection::Last);  
+    }  
+    else if (!GetKeyState(VK_SHIFT) && GetFocus() ==  lastTabStop) { {  
+        request = gcnew TraversalRequest(FocusNavigationDirection::Next);  
+    }  
+  
+    if (request != nullptr)  
+        return ((IKeyboardInputSink^) this)->KeyboardInputSite->OnNoMoreTabStops(request);  
+}  
+```  
+  
+ 最後に、`IsDialogMessage` を呼び出します。  ただし、`TranslateAccelerator` メソッドが行う処理の 1 つは、キーストロークを処理しているかどうかを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に伝えることです。  キーストロークを処理していない場合、入力イベントはアプリケーションの残りをトンネリングおよびバブリングできます。  ここで、キーボード メッセージ処理の特性と、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の入力アーキテクチャの性質を公開します。  `IsDialogMessage` は、特定のキーストロークを処理しているかどうかの値を返しません。  さらに、処理する必要のないキーストロークで `DispatchMessage()` を呼び出します。  このため、`IsDialogMessage` をリバースエンジニアリングして、処理することがわかっているキーに対してのみ `IsDialogMessage` を呼び出す必要があります。  
+  
+```  
+// Only call IsDialogMessage for keys it will do something with.  
+if (msg.message == WM_SYSKEYDOWN || msg.message == WM_KEYDOWN) {  
+    switch (m.wParam) {  
+        case VK_TAB:  
+        case VK_LEFT:  
+        case VK_UP:  
+        case VK_RIGHT:  
+        case VK_DOWN:  
+        case VK_EXECUTE:  
+        case VK_RETURN:  
+        case VK_ESCAPE:  
+        case VK_CANCEL:  
+            IsDialogMessage(dialog, &m);  
+            // IsDialogMessage should be called ProcessDialogMessage --  
+            // it processes messages without ever really telling you  
+            // if it handled a specific message or not  
+            return true;  
+    }  
+```  
+  
+### TabInto メソッドのオーバーライドによる Tab キーによる移動のサポート  
+ `TranslateAccelerator` の実装が完了したので、ユーザーはダイアログ ボックス内を Tab キーで移動し、ダイアログ ボックスからより大きい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションへ移動することができます。  ただし、ユーザーはダイアログ ボックスに Tab キーで戻ることができません。  この問題を解決するためには、`TabInto` をオーバーライドします。  
+  
+```  
+  
+public:   
+    virtual bool TabInto(TraversalRequest^ request) override {  
+        if (request->FocusNavigationDirection == FocusNavigationDirection::Last) {  
+            HWND lastTabStop = GetDlgItem(dialog, IDCANCEL);  
+            SetFocus(lastTabStop);  
+        }  
+        else {  
+            HWND firstTabStop = GetDlgItem(dialog, IDC_EDIT1);  
+            SetFocus(firstTabStop);  
+        }  
+        return true;  
+    }  
+  
+```  
+  
+ `TraversalRequest` パラメーターは、Tab キーのアクションが Tab キーであるか Shift \+ Tab キーであるかを示します。  
+  
+### OnMnemonic メソッドのオーバーライドによるニーモニックのサポート  
+ キーボード処理はほぼ完了ですが、1 つ残っている処理があります。それはニーモニックが機能しないという点です。  ユーザーが Alt キーを押しながら F キーを押しても、\[First name:\] ボックスにはジャンプしません。  このため、`OnMnemonic` メソッドを次のようにオーバーライドします。  
+  
+```  
+virtual bool OnMnemonic(System::Windows::Interop::MSG% msg, ModifierKeys modifiers) override {  
+    ::MSG m = ConvertMessage(msg);  
+  
+    // If it's one of our mnemonics, set focus to the appropriate hwnd  
+    if (msg.message == WM_SYSCHAR && GetKeyState(VK_MENU /*alt*/)) {  
+        int dialogitem = 9999;  
+        switch (m.wParam) {  
+            case 's': dialogitem = IDOK; break;  
+            case 'c': dialogitem = IDCANCEL; break;  
+            case 'f': dialogitem = IDC_EDIT1; break;  
+            case 'l': dialogitem = IDC_EDIT2; break;  
+            case 'p': dialogitem = IDC_EDIT3; break;  
+            case 'a': dialogitem = IDC_EDIT4; break;  
+            case 'i': dialogitem = IDC_EDIT5; break;  
+            case 't': dialogitem = IDC_EDIT6; break;  
+            case 'z': dialogitem = IDC_EDIT7; break;  
+        }  
+        if (dialogitem != 9999) {  
+            HWND hwnd = GetDlgItem(dialog, dialogitem);  
+            SetFocus(hwnd);  
+            return true;  
+        }  
+    }  
+    return false; // key unhandled  
+};  
+```  
+  
+ ここでは、なぜ `IsDialogMessage` を呼び出さないのでしょうか。  前述したとおり、コードがキーストロークを処理したかどうかを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に伝える必要があるにもかかわらず、`IsDialogMessage` はそれを実行できません。  また、フォーカスがある HWND がダイアログ ボックス内にない場合、ニーモニックの処理を `IsDialogMessage` が拒否するという問題もあります。  
+  
+### HwndHost 派生クラスのインスタンス化  
+ 最後に、すべてのキーと Tab キーがサポートされるようになったので、<xref:System.Windows.Interop.HwndHost> をより大きい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに入れることができます。  メインのアプリケーションが [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で記述される場合、<xref:System.Windows.Interop.HwndHost> を正しい場所に入れる最も簡単な方法は、<xref:System.Windows.Interop.HwndHost> を入れる空の <xref:System.Windows.Controls.Border> 要素を残しておくことです。  ここで、`insertHwndHostHere` という名前の <xref:System.Windows.Controls.Border> を作成します。  
+  
+```  
+<Window x:Class="WPFApplication1.Window1"  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    Title="Windows Presentation Framework Application"  
+    Loaded="Window1_Loaded"  
+    >  
+    <StackPanel>  
+        <Button Content="WPF button"/>  
+        <Border Name="insertHwndHostHere" Height="200" Width="500"/>  
+        <Button Content="WPF button"/>  
+    </StackPanel>  
+</Window>  
+```  
+  
+ 後は、コード シーケンス内で <xref:System.Windows.Interop.HwndHost> をインスタンス化するのに適した場所を見つけ、それを <xref:System.Windows.Controls.Border> に接続するだけです。  この例では、<xref:System.Windows.Window> 派生クラスのコンストラクター内に入れます。  
+  
+```  
+public partial class Window1 : Window {  
+    public Window1() {  
+    }  
+  
+    void Window1_Loaded(object sender, RoutedEventArgs e) {  
+        HwndHost host = new ManagedCpp.MyHwndHost();  
+        insertHwndHostHere.Child = host;  
+    }  
+}  
+```  
+  
+ 次のような画面が表示されます。  
+  
+ ![WPF アプリケーションのスクリーンショット](../../../../docs/framework/wpf/advanced/media/interoparch09.png "InteropArch09")  
+  
+## 参照  
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-add-an-event-handler-using-code.md b/docs/framework/wpf/advanced/how-to-add-an-event-handler-using-code.md
new file mode 100644
index 00000000000..31ce83816ef
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-add-an-event-handler-using-code.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : コードを使用してイベント ハンドラーを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ハンドラー, 追加"
+  - "XAML, 追加 (イベント ハンドラーを)"
+ms.assetid: 269c61e0-6bd9-4291-9bed-1c5ee66da486
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : コードを使用してイベント ハンドラーを追加する
+コードを使用して要素にイベント ハンドラーを追加する方法を次の例に示します。  
+  
+ イベント ハンドラーを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 要素に追加する際に、その要素を含むマークアップ ページが既に読み込まれている場合は、コードを使用してハンドラーを追加する必要があります。  また、コードのみを使用してアプリケーションの要素ツリーを構築し、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して要素の宣言をしない場合は、特定のメソッドを呼び出して、構築された要素ツリーにイベント ハンドラーを追加することができます。  
+  
+## 使用例  
+ 最初に定義した既存のページに、新しい <xref:System.Windows.Controls.Button> を追加する [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] での例を次に示します。  分離コード ファイルはイベント ハンドラー メソッドを実装し、そのメソッドを新しいイベント ハンドラーとして <xref:System.Windows.Controls.Button> に追加します。  
+  
+ [!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] の例では、`+=` 演算子を使用してイベントにハンドラーを割り当てます。  これは、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] のイベント処理モデルでハンドラーを割り当てる際に使用する演算子と同じです。  [!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] では、イベント ハンドラーを追加する手段としてこの演算子はサポートされていません。  代わりに、次の 2 つの手法のいずれかを使用する必要があります。  
+  
+-   <xref:System.Windows.UIElement.AddHandler%2A> メソッドを `AddressOf` 演算子と共に使用して、イベント ハンドラー実装を参照します。  
+  
+-   イベント ハンドラー定義の一部として `Handles` キーワードを使用します。  この方法はここでは説明しません。「[Visual Basic と WPF のイベント処理](../../../../docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md)」を参照してください。  
+  
+ [!code-xml[RoutedEventAddRemoveHandler#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventAddRemoveHandler/CSharp/default.xaml#xaml)]  
+  
+ [!code-csharp[RoutedEventAddRemoveHandler#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventAddRemoveHandler/CSharp/default.xaml.cs#handler)]
+ [!code-vb[RoutedEventAddRemoveHandler#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RoutedEventAddRemoveHandler/VisualBasic/default.xaml.vb#handler)]  
+  
+> [!NOTE]
+>  最初に解析した [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページでイベント ハンドラーを追加すると、非常に簡単です。  イベント ハンドラーを追加するオブジェクト要素内で、処理するイベント名と一致する属性を追加します。  次に、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページの分離コード ファイルで定義したイベント ハンドラー メソッドの名前として、その属性の値を指定します。  詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」または「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+## 参照  
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/events-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-add-an-owner-type-for-a-dependency-property.md b/docs/framework/wpf/advanced/how-to-add-an-owner-type-for-a-dependency-property.md
new file mode 100644
index 00000000000..8b976e8e2ca
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-add-an-owner-type-for-a-dependency-property.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 依存関係プロパティの所有者の種類を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, 追加 (依存関係プロパティの所有者として)"
+  - "依存関係プロパティ, 追加 (クラスを所有者として)"
+ms.assetid: edcce050-0576-4edb-a31a-3f909637b452
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 依存関係プロパティの所有者の種類を追加する
+この例では、異なる型に対して登録された依存プロパティの所有者としてクラスを追加する方法を示します。  これにより、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リーダーとプロパティ システムの両方が、プロパティの追加の所有者としてクラスを認識できるようになります。  さらに所有者として追加することで、追加するクラスが型固有のメタデータを提供できるようになります。  
+  
+ 次の例では、`StateProperty` は `MyStateControl` クラスによって登録されるプロパティです。  `UnrelatedStateControl` クラスは、<xref:System.Windows.DependencyProperty.AddOwner%2A> メソッドを使用し、追加する型に存在する依存関係プロパティの新しいメタデータで使用可能なシグネチャを明示的に使用して、`StateProperty` の所有者として自分自身を追加します。  このとき、「[依存関係プロパティを実装する](../../../../docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md)」の例に示すようなプロパティの[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] アクセサーを提供し、さらに、所有者として追加されるクラスに対する依存プロパティ識別子を再公開する必要がある点に注意してください。  
+  
+ ラッパーがなくても、プログラムによるアクセスという観点からは、依存プロパティは <xref:System.Windows.DependencyObject.GetValue%2A> または <xref:System.Windows.DependencyObject.SetValue%2A> を使用して動作できます。  ただし通常は、このプロパティシステム動作を [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティ ラッパーと合わせる必要があります。  ラッパーを使用すると、プログラムでの依存関係プロパティの設定が容易になり、プロパティを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 属性として設定できるようになります。  
+  
+ 既定のメタデータをオーバーライドする方法については、「[依存関係プロパティのメタデータをオーバーライドする](../../../../docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertySystemEsoterics/CSharp/SDKSampleLibrary/class1.cs#mystatecontrol)]
+ [!code-vb[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertySystemEsoterics/visualbasic/sdksamplelibrary/class1.vb#mystatecontrol)]  
+[!code-csharp[PropertySystemEsoterics#UnrelatedStateControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertySystemEsoterics/CSharp/SDKSampleLibrary/class1.cs#unrelatedstatecontrol)]
+[!code-vb[PropertySystemEsoterics#UnrelatedStateControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertySystemEsoterics/visualbasic/sdksamplelibrary/class1.vb#unrelatedstatecontrol)]  
+  
+## 参照  
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-add-class-handling-for-a-routed-event.md b/docs/framework/wpf/advanced/how-to-add-class-handling-for-a-routed-event.md
new file mode 100644
index 00000000000..f971a31422f
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-add-class-handling-for-a-routed-event.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ルーティング イベントのクラス処理を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス ハンドラー, ルーティング イベント"
+  - "ルーティング イベント, クラス ハンドラー"
+  - "task_core_add_class_handling_routed_event"
+ms.assetid: 15b7b06c-9112-4ee5-b30a-65d10c5c5df6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ルーティング イベントのクラス処理を追加する
+ルーティング イベントは、クラス ハンドラーまたはルート内の特定のノードにあるインスタンスで処理できます。  クラス ハンドラーが最初に呼び出され、このクラス ハンドラーをクラス実装が使用してインスタンス処理からのイベントの出力を抑制したり、基本クラスが所有するイベントに他のイベント固有の動作を導入できます。  次の例では、クラス ハンドラーを実装するための、非常に密接に関連する 2 つの手法を示します。  
+  
+## 使用例  
+ この例では、<xref:System.Windows.Controls.Canvas> パネルに基づくカスタム クラスを使用します。  子要素クラスまたはその上にあるインスタンス ハンドラーが呼び出される前に、左のマウス ボタンのすべてのクリックをインターセプトし、それらを処理済みとしてマークするなど、カスタム クラスがその子要素に動作を導入していることが、アプリケーションの基本前提になります。  
+  
+ <xref:System.Windows.UIElement> クラスは、<xref:System.Windows.UIElement.PreviewMouseLeftButtonDown> イベントを単純にオーバーライドして、そのイベントでクラス処理を有効にする仮想メソッドを公開します。  これは、仮想メソッドがクラスの階層内のどこかで使用できる場合の、最も単純なクラス処理の実装方法です。  次のコードは、<xref:System.Windows.Controls.Canvas> から派生した "MyEditContainer" での <xref:System.Windows.UIElement.OnPreviewMouseLeftButtonDown%2A> の実装を示します。  この実装では、引数でイベントを処理済みとしてマークしてから、ソース要素に基本的な表示変更を与えるコードを追加します。  
+  
+ [!code-csharp[ClassHandling#OnStarClassHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ClassHandling/CSharp/SDKSampleLibrary/class1.cs#onstarclasshandler)]
+ [!code-vb[ClassHandling#OnStarClassHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ClassHandling/visualbasic/sdksamplelibrary/class1.vb#onstarclasshandler)]  
+  
+ 基本クラスまたはその特定のメソッドに対して仮想メソッドが使用できない場合、クラス処理は <xref:System.Windows.EventManager> クラスのユーティリティ メソッド <xref:System.Windows.EventManager.RegisterClassHandler%2A> を使用して直接追加できます。  このメソッドは、クラス処理を追加しているクラスの静的な初期化内でのみ呼び出す必要があります。  この例では、<xref:System.Windows.UIElement.PreviewMouseLeftButtonDown> の別のハンドラーを追加します。この場合、登録済みのクラスがカスタム クラスになります。  これに対し、仮想メソッドを使用している場合は、登録済みのクラスは実際に <xref:System.Windows.UIElement> の基本クラスになります。  基本クラスとサブクラスがそれぞれクラス処理を登録している場合、サブクラスのハンドラーが最初に呼び出されます。  この場合のアプリケーションの動作は、まずこのハンドラーにそのメッセージ ボックスが表示されてから、仮想メソッドのハンドラーのビジュアルな変更が示されます。  
+  
+ [!code-csharp[ClassHandling#StaticAndRegisterClassHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ClassHandling/CSharp/SDKSampleLibrary/class1.cs#staticandregisterclasshandler)]
+ [!code-vb[ClassHandling#StaticAndRegisterClassHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ClassHandling/visualbasic/sdksamplelibrary/class1.vb#staticandregisterclasshandler)]  
+  
+## 参照  
+ <xref:System.Windows.EventManager>   
+ [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)   
+ [ルーティング イベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-a-routed-event.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-add-custom-data-to-ink-data.md b/docs/framework/wpf/advanced/how-to-add-custom-data-to-ink-data.md
new file mode 100644
index 00000000000..6ed45e610df
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-add-custom-data-to-ink-data.md
@@ -0,0 +1,90 @@
+---
+title: "方法 : インク データにカスタム データを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インク データ, 追加 (カスタム データを)"
+  - "InkCanvas, 表示"
+ms.assetid: f02aac6f-3436-4f7c-b6ea-0452cba5332c
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : インク データにカスタム データを追加する
+インクが Ink Serialized Format \(ISF\) として保存されるときに保存されるインクにカスタム データを追加できます。  カスタム データは、<xref:System.Windows.Ink.DrawingAttributes>、<xref:System.Windows.Ink.StrokeCollection>、または <xref:System.Windows.Ink.Stroke> に保存できます。  3 つのオブジェクトにカスタム データを保存できるため、データを保存する最善の場所を選択することが可能になります。  カスタム データの格納とアクセスに使用するメソッドは、3 つのいずれのクラスでもほぼ同じです。  
+  
+ カスタム データとして保存できるのは、次の型だけです。  
+  
+-   <xref:System.Boolean>  
+  
+-   <xref:System.Boolean>\[\]  
+  
+-   <xref:System.Byte>  
+  
+-   <xref:System.Byte>\[\]  
+  
+-   <xref:System.Char>  
+  
+-   <xref:System.Char>\[\]  
+  
+-   <xref:System.DateTime>  
+  
+-   <xref:System.DateTime>\[\]  
+  
+-   <xref:System.Decimal>  
+  
+-   <xref:System.Decimal>\[\]  
+  
+-   <xref:System.Double>  
+  
+-   <xref:System.Double>\[\]  
+  
+-   <xref:System.Int16>  
+  
+-   <xref:System.Int16>\[\]  
+  
+-   <xref:System.Int32>  
+  
+-   <xref:System.Int32>\[\]  
+  
+-   <xref:System.Int64>  
+  
+-   <xref:System.Int64>\[\]  
+  
+-   <xref:System.Single>  
+  
+-   <xref:System.Single>\[\]  
+  
+-   <xref:System.String>  
+  
+-   <xref:System.UInt16>  
+  
+-   <xref:System.UInt16>\[\]  
+  
+-   <xref:System.UInt32>  
+  
+-   <xref:System.UInt32>\[\]  
+  
+-   <xref:System.UInt64>  
+  
+-   <xref:System.UInt64>\[\]  
+  
+## 使用例  
+ <xref:System.Windows.Ink.StrokeCollection> にカスタム データを追加したり、そこからカスタム データを取得したりする方法を次の例に示します。  
+  
+ [!code-csharp[HowToAddCustomDataToInk#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToAddCustomDataToInk/CSharp/Window1.xaml.cs#1)]  
+  
+ 次の例では、<xref:System.Windows.Controls.InkCanvas> と 2 つのボタンを表示するアプリケーションを作成します。  `switchAuthor` ボタンを使用すると、2 人の作成者がそれぞれ異なるペンを使用できます。  `changePenColors` ボタンは、作成者に応じて <xref:System.Windows.Controls.InkCanvas> 上の各ストロークの色を変更します。  このアプリケーションでは、2 つの <xref:System.Windows.Ink.DrawingAttributes> オブジェクトを定義し、<xref:System.Windows.Ink.Stroke> を描画した作成者を示すカスタム プロパティをそれぞれに追加します。  ユーザーが `changePenColors` をクリックすると、アプリケーションは、カスタム プロパティの値に従ってストロークの外観を変更します。  
+  
+ [!code-xml[HowToAddCustomDataToInk#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToAddCustomDataToInk/CSharp/Window1.xaml#2)]  
+  
+ [!code-csharp[HowToAddCustomDataToInk#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToAddCustomDataToInk/CSharp/Window1.xaml.cs#3)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-adjust-spacing-between-paragraphs.md b/docs/framework/wpf/advanced/how-to-adjust-spacing-between-paragraphs.md
new file mode 100644
index 00000000000..ff1a909334e
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-adjust-spacing-between-paragraphs.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : 段落間の間隔を調整する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 調整 (段落間の間隔を)"
+  - "段落, 間隔"
+  - "間隔 (段落間の)"
+ms.assetid: 7cd2f2ac-0e19-4587-bfb6-7f5b18c9536e
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : 段落間の間隔を調整する
+フロー コンテンツ内の段落間の間隔を調整する、または間隔をなくす方法を次の例に示します。  
+  
+ フロー コンテンツの段落間に余分な間隔が空くのは、段落にマージンが設定されているからです。したがって、段落間の間隔を制御するには、段落のマージンを調整します。  2 つの段落間の余分な間隔を完全になくすには、段落のマージンを **0** に設定します。  <xref:System.Windows.Documents.FlowDocument> の全体にわたって段落間の間隔を均一にするには、スタイルを使用して、<xref:System.Windows.Documents.FlowDocument> のすべての段落に対して均一のマージン値を設定します。  
+  
+ 2 つの隣接する段落のマージンは、縮小されて、大きい方だけが残ることに注意してください。2 つのマージンが足されるのではありません。  したがって、2 つの隣接する段落のマージンがそれぞれ 20 ピクセルと 40 ピクセルならば、段落間の間隔は、2 つのマージン値のうち大きい方である 40 ピクセルになります。  
+  
+## 使用例  
+ <xref:System.Windows.Documents.FlowDocument> のすべての <xref:System.Windows.Documents.Paragraph> 要素のマージンを **0** に設定するスタイルを使用して <xref:System.Windows.Documents.FlowDocument> の段落間の余分な間隔を実質的に除去する例を次に示します。  
+  
+ [!code-xml[BlockSnippets#_ParagraphSpacingXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BlockSnippets/CSharp/Window1.xaml#_paragraphspacingxaml)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-alter-the-typography-of-text.md b/docs/framework/wpf/advanced/how-to-alter-the-typography-of-text.md
new file mode 100644
index 00000000000..93ffe30c43d
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-alter-the-typography-of-text.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : テキストの文字体裁を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "設定 (Typography 属性を)"
+  - "Typography 属性, 設定"
+ms.assetid: 19a3b49b-60a2-4c11-a786-e26b4c965588
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法 : テキストの文字体裁を変更する
+要素として <xref:System.Windows.Documents.Paragraph> を使用して、<xref:System.Windows.Documents.TextElement.Typography%2A> 属性を設定する方法を次の例に示します。  
+  
+## 使用例  
+ [!code-xml[TextElementSnippets#_TextElement_TypogXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextElementSnippets/CSharp/Window1.xaml#_textelement_typogxaml)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 変更されたタイポグラフィを含むテキスト](../../../../docs/framework/wpf/advanced/media/textelement-typog.png "TextElement\_Typog")  
+  
+ 既定の文字体裁プロパティを設定した同様の例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 変更されたタイポグラフィを含むテキスト](../../../../docs/framework/wpf/advanced/media/textelement-typog-default.png "TextElement\_Typog\_Default")  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TextBox.Typography%2A> プロパティをプログラムによって設定する方法を次の例に示します。  
+  
+ [!code-csharp[TextElementSnippets#_TextElement_Typog](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextElementSnippets/CSharp/Window1.xaml.cs#_textelement_typog)]
+ [!code-vb[TextElementSnippets#_TextElement_Typog](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextElementSnippets/visualbasic/window1.xaml.vb#_textelement_typog)]  
+  
+## 参照  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-analyze-ink-with-analysis-hints.md b/docs/framework/wpf/advanced/how-to-analyze-ink-with-analysis-hints.md
new file mode 100644
index 00000000000..abdef4aeb2a
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-analyze-ink-with-analysis-hints.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : 分析のヒントに従ってインクを分析する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AnalysisHintNode オブジェクト"
+  - "分析 (インクを)"
+  - "インク, AnalysisHintNode オブジェクト"
+  - "インク, 分析"
+ms.assetid: d4421ed4-77f5-4640-829e-9f1de50b2ff2
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : 分析のヒントに従ってインクを分析する
+<xref:System.Windows.Ink.AnalysisHintNode> は、結合先の <xref:System.Windows.Ink.InkAnalyzer> にヒントを提供します。  ヒントは、<xref:System.Windows.Ink.AnalysisHintNode> の <xref:System.Windows.Ink.ContextNode.Location%2A> プロパティで指定された領域に適用され、インク アナライザーに追加のコンテキストを提供します。これにより、認識の正確さが向上します。  <xref:System.Windows.Ink.InkAnalyzer> は、ヒントの領域内から取得したインクを分析するときにこのコンテキスト情報を適用します。  
+  
+## 使用例  
+ インク入力を受け入れるフォームの <xref:System.Windows.Ink.AnalysisHintNode> オブジェクトを複数使用するアプリケーションを次の例に示します。  このアプリケーションは、<xref:System.Windows.Ink.AnalysisHintNode.Factoid%2A> プロパティを使用して、フォームの各エントリにコンテキスト情報を提供します。  このアプリケーションは、バックグラウンド分析を使用してインクを分析し、ユーザーがインクの追加を停止した 5 秒後にフォームのすべてのインクを消去します。  
+  
+ [!code-xml[HowToAnalyzeInk#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToAnalyzeInk/CSharp/FormAnalyzer.xaml#1)]  
+  
+ [!code-csharp[HowToAnalyzeInk#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToAnalyzeInk/CSharp/FormAnalyzer.xaml.cs#2)]
+ [!code-vb[HowToAnalyzeInk#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToAnalyzeInk/VisualBasic/FormAnalyzer.xaml.vb#2)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-animate-the-size-of-a-frameworkelement.md b/docs/framework/wpf/advanced/how-to-animate-the-size-of-a-frameworkelement.md
new file mode 100644
index 00000000000..a0d1e593379
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-animate-the-size-of-a-frameworkelement.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : FrameworkElement のサイズをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, FrameworkElement のサイズ"
+  - "FrameworkElement, アニメーション化 (サイズを)"
+ms.assetid: d4cd5a13-c20d-4a6f-a2ba-14f2c9ce4cef
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : FrameworkElement のサイズをアニメーション化する
+<xref:System.Windows.FrameworkElement> のサイズをアニメーション化するには、その <xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティをアニメーション化するか、アニメーション化された <xref:System.Windows.Media.ScaleTransform> を使用します。  
+  
+ 次の例では、この 2 つの方法を使用して 2 つのボタンのサイズをアニメーション化します。  <xref:System.Windows.FrameworkElement.Width%2A> プロパティをアニメーション化することで一方のボタンのサイズを変更し、<xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用される <xref:System.Windows.Media.ScaleTransform> をアニメーション化することでもう一方のボタンのサイズを変更します。  各ボタンにはテキストが含まれています。  最初は、両方のボタンでテキストが同じように表示されますが、ボタンのサイズを変更すると、2 番目のボタンのテキストがゆがめられます。  
+  
+## 使用例  
+ [!code-xml[transformanimations_snip#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/transformanimations_snip/XAML/AnimatingSizeExample.xaml#1)]  
+  
+ 要素を変換すると、要素全体とそのコンテンツが変換されます。  最初のボタンのように、要素のサイズを直接変更した場合、要素のサイズと位置が親要素のサイズに依存していない限り、要素のコンテンツのサイズは変更されません。  
+  
+ アニメーション化された変換を <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用して要素のサイズをアニメーション化すると、その要素の <xref:System.Windows.FrameworkElement.Width%2A> と <xref:System.Windows.FrameworkElement.Height%2A> を直接アニメーション化するよりもパフォーマンスが向上します。これは、<xref:System.Windows.UIElement.RenderTransform%2A> プロパティがレイアウト パスをトリガーしないためです。  
+  
+ プロパティのアニメーション化の詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  トランザクションの詳細については、「[変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-apply-a-focusvisualstyle-to-a-control.md b/docs/framework/wpf/advanced/how-to-apply-a-focusvisualstyle-to-a-control.md
new file mode 100644
index 00000000000..03cf31218b4
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-apply-a-focusvisualstyle-to-a-control.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : FocusVisualStyle をコントロールに適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "FocusVisualStyle プロパティ"
+  - "プロパティ, FocusVisualStyle"
+ms.assetid: 363de99e-8ecc-438c-ac4a-f9147432ebd6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : FocusVisualStyle をコントロールに適用する
+この例では、<xref:System.Windows.FrameworkElement.FocusVisualStyle%2A> プロパティを使用して、フォーカス表示スタイルをリソース内で作成し、このスタイルをコントロールに適用する方法を示しています。  
+  
+## 使用例  
+ 次の例では、コントロールが [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] 内でキーボードのフォーカスを受け取ったときにのみ適用される追加のコントロール複合を作成するスタイルを定義しています。  これを行うには、<xref:System.Windows.Controls.ControlTemplate> を使用してスタイルを定義し、<xref:System.Windows.FrameworkElement.FocusVisualStyle%2A> プロパティを設定する際に、そのスタイルをリソースとして参照します。  
+  
+ 境界線に似た外部四角形を四角形領域の外側に配置します。  他の部分を変更しない限り、スタイルのサイズ指定には、フォーカス表示スタイルが適用される四角形コントロールの <xref:System.Windows.FrameworkElement.ActualHeight%2A> および <xref:System.Windows.FrameworkElement.ActualWidth%2A> が使用されます。  次の例では、<xref:System.Windows.FrameworkElement.Margin%2A>\> に負の値を設定して、フォーカスされたコントロールの少し外側に境界線を表示しています。  
+  
+ [!code-xml[FEFocusVisualStyle#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEFocusVisualStyle/CS/page1.xaml#xaml)]  
+  
+ <xref:System.Windows.FrameworkElement.FocusVisualStyle%2A> は、明示的なスタイルまたはテーマ スタイルに由来するコントロール テンプレート スタイルに付け加えるスタイルです。コントロールの主なスタイルは、<xref:System.Windows.Controls.ControlTemplate> を使用し、このスタイルを <xref:System.Windows.FrameworkElement.Style%2A> プロパティに設定することにより作成できます。  
+  
+ フォーカス表示スタイルは、フォーカス可能な要素ごとに別のスタイルを使用するのではなく、テーマまたは UI 全体で一貫して同じスタイルを使用する必要があります。  詳細については、「[コントロールのフォーカスのスタイルと FocusVisualStyle](../../../../docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.FocusVisualStyle%2A>   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [コントロールのフォーカスのスタイルと FocusVisualStyle](../../../../docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-apply-animations-to-text.md b/docs/framework/wpf/advanced/how-to-apply-animations-to-text.md
new file mode 100644
index 00000000000..7f23098d135
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-apply-animations-to-text.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : アニメーションをテキストに適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, テキスト"
+  - "タイポグラフィ, アニメーション"
+ms.assetid: eec3d26c-0a21-420f-8012-671621c47089
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : アニメーションをテキストに適用する
+アニメーションを使用すると、アプリケーション内のテキストの表示と外観を変えることができます。  次の例では、 <xref:System.Windows.Controls.TextBlock> コントロール内のテキストの表示に影響を及ぼす、異なる種類のアニメーションを使用しています。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用してテキスト ブロックの幅をアニメーション化しています。  10 秒間で幅の値がテキスト ブロックの幅から 0 まで変化してから、幅の値が逆に戻る変化が繰り返されます。  この種類のアニメーションにより、ワイプ効果がもたらされます。  
+  
+ [!code-xml[TextAnimationSample#TextAnimationSample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextAnimationSample/CS/Window1.xaml#textanimationsample1)]  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用してテキスト ブロックの不透明度をアニメーション化しています。  5 秒間で不透明度の値が 1.0 から 0 まで変化してから、その不透明度の値が逆行する変化が繰り返されます。  
+  
+ [!code-xml[TextAnimationSample#TextAnimationSample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextAnimationSample/CS/Window1.xaml#textanimationsample2)]  
+  
+ <xref:System.Windows.Media.Animation.Timeline.Duration%2A> で定義されている 5 秒間に不透明度が `1.00` から `0.00` まで変化する <xref:System.Windows.Controls.TextBlock> コントロールの効果を次の図に示します。  
+  
+ ![不透明度を 1.00 から 0.00 に変更するテキスト](../../../../docs/framework/wpf/advanced/media/fadedtext01.png "FadedText01")  
+1.00 から 0.00 まで変更するテキストの不透明度  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.ColorAnimation> を使用してテキスト ブロックの前景色をアニメーション化しています。  5 秒間で前景色の値がある色から別の色に変化してから、その色の値が逆行する変化が繰り返されます。  
+  
+ [!code-xml[TextAnimationSample#TextAnimationSample3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextAnimationSample/CS/Window1.xaml#textanimationsample3)]  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用してテキスト ブロックを回転させています。  20 秒間でテキスト ブロックが完全に回転してから、回転が繰り返されます。  
+  
+ [!code-xml[TextAnimationSample#TextAnimationSample4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextAnimationSample/CS/Window1.xaml#textanimationsample4)]  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-apply-transforms-to-text.md b/docs/framework/wpf/advanced/how-to-apply-transforms-to-text.md
new file mode 100644
index 00000000000..254a5f5aa70
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-apply-transforms-to-text.md
@@ -0,0 +1,79 @@
+---
+title: "方法 : テキストに変換を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "回転したテキスト"
+  - "スケーリングされたテキスト"
+  - "影付きテキスト"
+  - "傾斜させたテキスト"
+  - "変換 (テキスト)"
+  - "変換されたテキスト"
+  - "タイポグラフィ, 回転したテキスト"
+  - "タイポグラフィ, スケーリングされたテキスト"
+  - "タイポグラフィ, 影付きテキスト"
+  - "タイポグラフィ, 傾斜させたテキスト"
+  - "タイポグラフィ, 変換"
+  - "タイポグラフィ, 変換されたテキスト"
+ms.assetid: 0d61678a-4185-4f2a-85c6-c1d020f96fa0
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : テキストに変換を適用する
+変換を適用して、アプリケーションでのテキストの表示を変更できます。  次の例では、異なる種類の描画変換を使用して、<xref:System.Windows.Controls.TextBlock> コントロール内のテキストの表示を変更します。  
+  
+## 使用例  
+ 指定した点を中心として、2 次元の x\-y 平面上で回転したテキストの例を次に示します。  
+  
+ ![RotateTransform を使用して回転したテキスト](../../../../docs/framework/wpf/advanced/media/transformedtext01.png "TransformedText01")  
+90 度回転したテキストの例  
+  
+ 次のコード例では、<xref:System.Windows.Media.RotateTransform> を使用してテキストを回転します。  <xref:System.Windows.Media.RotateTransform.Angle%2A> の値を 90 にすると、要素が時計回りに 90 度回転します。  
+  
+ [!code-xml[TextTransformSample#TextTransformSample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTransformSample/CS/Window1.xaml#texttransformsample1)]  
+  
+ テキストの 2 行目を x 軸に沿って 150% 拡大し、3 行目を y 軸に沿って 150% 拡大した例を次に示します。  
+  
+ ![ScaleTransform を使用してスケールされたテキスト](../../../../docs/framework/wpf/advanced/media/transformedtext02.png "TransformedText02")  
+拡大したテキストの例  
+  
+ 次のコード例では、<xref:System.Windows.Media.ScaleTransform> を使用してテキストを元のサイズから拡大します。  
+  
+ [!code-xml[TextTransformSample#TextTransformSample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTransformSample/CS/Window1.xaml#texttransformsample2)]  
+  
+> [!NOTE]
+>  テキストの拡大は、テキストのフォント サイズを大きくする操作と同一ではありません。  フォント サイズは、異なるサイズで最適な解像度を得るために、各サイズが個別に計算されます。  一方、拡大したテキストでは、元のサイズのテキストの縦横比が維持されます。  
+  
+ x 軸に沿って傾斜させたテキストの例を次に示します。  
+  
+ ![SkewTransform を使用して傾斜させたテキスト](../../../../docs/framework/wpf/advanced/media/transformedtext03.png "TransformedText03")  
+傾斜させたテキストの例  
+  
+ 次のコード例では、<xref:System.Windows.Media.SkewTransform> を使用してテキストを傾斜させます。  傾斜とは、座標空間を不均等に拡大する変換のことで、シアとも呼ばれます。  この例では、2 つのテキスト文字列を x 座標に沿って –30 度または 30 度傾斜させています。  
+  
+ [!code-xml[TextTransformSample#TextTransformSample3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTransformSample/CS/Window1.xaml#texttransformsample3)]  
+  
+ x 軸および y 軸に沿って平行移動させたテキストの例を次に示します。  
+  
+ ![TranslateTransform を使用するテキスト オフセット](../../../../docs/framework/wpf/advanced/media/transformedtext04.png "TransformedText04")  
+平行移動させたテキストの例  
+  
+ <xref:System.Windows.Media.TranslateTransform> を使用してテキストをオフセットするコード例を次に示します。  この例では、主要なテキストの下のわずかにオフセットされたテキストのコピーにより、シャドウ効果が作成されます。  
+  
+ [!code-xml[TextTransformSample#TextTransformSample4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTransformSample/CS/Window1.xaml#texttransformsample4)]  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Effects.DropShadowBitmapEffect> は、シャドウ効果を実現する豊富な機能群を備えています。  詳細については、「[影付きテキストを作成する](../../../../docs/framework/wpf/advanced/how-to-create-text-with-a-shadow.md)」を参照してください。  
+  
+## 参照  
+ [アニメーションをテキストに適用する](../../../../docs/framework/wpf/advanced/how-to-apply-animations-to-text.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-build-a-table-programmatically.md b/docs/framework/wpf/advanced/how-to-build-a-table-programmatically.md
new file mode 100644
index 00000000000..2e2b59515d5
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-build-a-table-programmatically.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : プログラムによってテーブルをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成, テーブル (プログラムを使用)"
+  - "ドキュメント, プログラムで作成 (テーブルを)"
+  - "テーブル, 作成 (プログラムによる)"
+ms.assetid: e3ca88f3-6e94-4b61-82fc-42104c10b761
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : プログラムによってテーブルをビルドする
+次の例は、プログラムで <xref:System.Windows.Documents.Table> を作成してデータを格納する方法を示しています。  テーブルの内容は、5 行 \(<xref:System.Windows.Documents.Table.RowGroups%2A> オブジェクトに含まれる <xref:System.Windows.Documents.TableRow> オブジェクトで指定\) と 6 列 \(<xref:System.Windows.Documents.TableColumn> オブジェクトで指定\) に配分されます。  行はさまざまな表示目的に使用されます。たとえば、タイトル行はテーブル全体のタイトルの設定に使用され、ヘッダー行はテーブル内のデータ列の説明、フッター行は要約情報の格納に使用されます。  "タイトル"、"ヘッダー"、および "フッター" 行の概念はテーブルに固有のものではなく、単純に異なる特性を持つ行です。  テーブルのセルには実際の内容が格納されます。テキスト、画像、またはその他のほとんどすべての [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] 要素を格納できます。  
+  
+## 使用例  
+ まず、<xref:System.Windows.Documents.Table> を格納する <xref:System.Windows.Documents.FlowDocument> を作成し、新しい <xref:System.Windows.Documents.Table> を作成して <xref:System.Windows.Documents.FlowDocument> に追加します。  
+  
+ [!code-csharp[TableSnippets#_TableCreate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tablecreate)]
+ [!code-vb[TableSnippets#_TableCreate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tablecreate)]  
+  
+## 使用例  
+ 次に、6 つの <xref:System.Windows.Documents.TableColumn> オブジェクトを作成してテーブルの <xref:System.Windows.Documents.Table.Columns%2A> コレクションに追加し、書式を適用します。  
+  
+> [!NOTE]
+>  テーブルの <xref:System.Windows.Documents.Table.Columns%2A> コレクションでは、標準のゼロから始まるインデックスを使用します。  
+  
+ [!code-csharp[TableSnippets#_TableCreateColumns](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tablecreatecolumns)]
+ [!code-vb[TableSnippets#_TableCreateColumns](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tablecreatecolumns)]  
+  
+## 使用例  
+ 次に、タイトル行を作成してテーブルに追加し、書式を適用します。  タイトル行には、テーブルの 6 つの列にまたがる 1 つのセルが格納されます。  
+  
+ [!code-csharp[TableSnippets#_TableAddTitleRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddtitlerow)]
+ [!code-vb[TableSnippets#_TableAddTitleRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddtitlerow)]  
+  
+## 使用例  
+ 次に、ヘッダー行を作成してテーブルに追加し、ヘッダー行のセルを作成してデータを格納します。  
+  
+ [!code-csharp[TableSnippets#_TableAddHeaderRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddheaderrow)]
+ [!code-vb[TableSnippets#_TableAddHeaderRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddheaderrow)]  
+  
+## 使用例  
+ 次に、データ行を作成してテーブルに追加し、この行のセルを作成してデータを格納します。  この行の作成は、ヘッダー行の作成に似ていますが、適用する書式が少し異なります。  
+  
+ [!code-csharp[TableSnippets#_TableAddDataRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableadddatarow)]
+ [!code-vb[TableSnippets#_TableAddDataRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableadddatarow)]  
+  
+## 使用例  
+ 最後に、フッター行を作成して追加し、書式を設定します。  タイトル行と同様に、フッター行には、テーブルの 6 つの列にまたがる 1 つのセルが格納されます。  
+  
+ [!code-csharp[TableSnippets#_TableAddFooterRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddfooterrow)]
+ [!code-vb[TableSnippets#_TableAddFooterRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddfooterrow)]  
+  
+## 参照  
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-change-the-color-of-an-element-using-focus-events.md b/docs/framework/wpf/advanced/how-to-change-the-color-of-an-element-using-focus-events.md
new file mode 100644
index 00000000000..150e8c587ba
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-change-the-color-of-an-element-using-focus-events.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : フォーカス イベントを使用して要素の色を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "色 (要素の), 変更"
+  - "要素, 変更 (色を)"
+  - "フォーカス イベント, 変更 (要素の色を)"
+ms.assetid: 7e246802-3625-47a7-ae9d-c8a2a40fd040
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : フォーカス イベントを使用して要素の色を変更する
+要素がフォーカスを取得したときや失ったときに <xref:System.Windows.UIElement.GotFocus> イベントおよび <xref:System.Windows.UIElement.LostFocus> イベントを使用してその要素の色を変更する方法を次の例に示します。  
+  
+ この例は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルと分離コード ファイルで構成されています。  
+  
+## 使用例  
+ 次に示す [!INCLUDE[TLA2#tla_titlexaml](../../../../includes/tla2sharptla-titlexaml-md.md)] では、2 つの <xref:System.Windows.Controls.Button> オブジェクトで構成されるユーザー インターフェイスを作成し、<xref:System.Windows.UIElement.GotFocus> イベントと <xref:System.Windows.UIElement.LostFocus> イベントのイベント ハンドラーを <xref:System.Windows.Controls.Button> オブジェクトに結び付けます。  
+  
+ [!code-xml[gotfocusLostfocusEffectUsingEvent#GotLostFocusSampleXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gotfocusLostfocusEffectUsingEvent/CSharp/Window1.xaml#gotlostfocussamplexaml)]  
+  
+ 次の分離コードでは、<xref:System.Windows.UIElement.GotFocus> および <xref:System.Windows.UIElement.LostFocus> イベント ハンドラーを作成します。  <xref:System.Windows.Controls.Button> がキーボード フォーカスを取得すると、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> が赤に変更されます。  <xref:System.Windows.Controls.Button> がキーボード フォーカスを失うと、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> が白に変更されます。  
+  
+ [!code-csharp[gotfocusLostfocusEffectUsingEvent#GotLostFocusSampleEventHandlers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gotfocusLostfocusEffectUsingEvent/CSharp/Window1.xaml.cs#gotlostfocussampleeventhandlers)]
+ [!code-vb[gotfocusLostfocusEffectUsingEvent#GotLostFocusSampleEventHandlers](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/gotfocusLostfocusEffectUsingEvent/VisualBasic/Window1.xaml.vb#gotlostfocussampleeventhandlers)]  
+  
+## 参照  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-change-the-cursor-type.md b/docs/framework/wpf/advanced/how-to-change-the-cursor-type.md
new file mode 100644
index 00000000000..1f56f63fa91
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-change-the-cursor-type.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : カーソルの種類を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カーソル (マウス ポインター)"
+  - "マウス ポインター (カーソル), カーソルの種類"
+ms.assetid: 08c945a7-8ab0-4320-acf3-0b4955a344c2
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : カーソルの種類を変更する
+特定の要素およびアプリケーションに対してマウス ポインターの <xref:System.Windows.Input.Cursor> を変更する方法を次の例に示します。  
+  
+ この例は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルと分離コード ファイルで構成されています。  
+  
+## 使用例  
+ この例で作成されるユーザー インターフェイスは、目的の <xref:System.Windows.Input.Cursor> を選択するための <xref:System.Windows.Controls.ComboBox>、カーソルの変更を単一の要素のみまたはアプリケーション全体のどちらに適用するかを決定する一組の <xref:System.Windows.Controls.RadioButton> オブジェクト、および新しいカーソルの適用対象の要素である <xref:System.Windows.Controls.Border> で構成されます。  
+  
+ [!code-xml[cursors#ChangeCursorsXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/cursors/CSharp/Window1.xaml#changecursorsxaml)]  
+  
+ 次の分離コードでは、<xref:System.Windows.Controls.ComboBox> でカーソルの種類を変更すると呼び出される <xref:System.Windows.Controls.Primitives.Selector.SelectionChanged> イベント ハンドラーを作成します。  switch ステートメントは、カーソル名でフィルター処理を行って、*DisplayArea* という名前の <xref:System.Windows.Controls.Border> の <xref:System.Windows.FrameworkElement.Cursor%2A> プロパティを設定します。  
+  
+ カーソルの変更の適用対象が "Entire Application \(アプリケーション全体\)" に設定されている場合は、<xref:System.Windows.Input.Mouse.OverrideCursor%2A> プロパティが、<xref:System.Windows.Controls.Border> コントロールの <xref:System.Windows.FrameworkElement.Cursor%2A> プロパティに設定されます。  これにより、カーソルの変更がアプリケーション全体に適用されます。  
+  
+ [!code-csharp[cursors#ChangeCursorsSample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/cursors/CSharp/Window1.xaml.cs#changecursorssample)]
+ [!code-vb[cursors#ChangeCursorsSample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/cursors/VisualBasic/Window1.xaml.vb#changecursorssample)]  
+  
+## 参照  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-change-the-flowdirection-of-content-programmatically.md b/docs/framework/wpf/advanced/how-to-change-the-flowdirection-of-content-programmatically.md
new file mode 100644
index 00000000000..0a85b308774
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-change-the-flowdirection-of-content-programmatically.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : プログラムによってコンテンツの FlowDirection を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 変更 (FlowDirection プロパティをプログラムで)"
+  - "FlowDirection プロパティ, 変更 (プログラムで)"
+ms.assetid: 02f5a8ba-f8c0-4e5a-84b9-4c5bf12922a2
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : プログラムによってコンテンツの FlowDirection を変更する
+この例では、<xref:System.Windows.Controls.FlowDocumentReader> の <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティをプログラムで変更する方法を示します。  
+  
+## 使用例  
+ 2 つの <xref:System.Windows.Controls.Button> 要素が作成され、それぞれが <xref:System.Windows.FlowDirection> の有効値の 1 つを表しています。  ボタンをクリックすると、関連付けられたプロパティ値が、`tf1` という名前の <xref:System.Windows.Controls.FlowDocumentReader> のコンテンツに適用されます。  プロパティ値は、`txt1` という名前の <xref:System.Windows.Controls.TextBlock> にも書き込まれます。  
+  
+ [!code-xml[FlowDirectionSnippets#_FlowDirectionXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDirectionSnippets/CSharp/Window1.xaml#_flowdirectionxaml)]  
+  
+## 使用例  
+ 上で定義されているボタン クリックに関連付けられたイベントは、[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] の分離コード ファイルで処理されます。  
+  
+ [!code-csharp[FlowDirectionSnippets#_FlowDirection](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDirectionSnippets/CSharp/Window1.xaml.cs#_flowdirection)]
+ [!code-vb[FlowDirectionSnippets#_FlowDirection](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDirectionSnippets/VisualBasic/Window1.xaml.vb#_flowdirection)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-change-the-textwrapping-property-programmatically.md b/docs/framework/wpf/advanced/how-to-change-the-textwrapping-property-programmatically.md
new file mode 100644
index 00000000000..eb8fa228547
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-change-the-textwrapping-property-programmatically.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : TextWrapping プロパティをプログラムにより変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 変更 (TextWrapping プロパティをプログラムで)"
+  - "TextWrapping プロパティ, 変更 (プログラムで)"
+ms.assetid: 30d25554-4c82-4df9-a8d6-35683a4a13bb
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : TextWrapping プロパティをプログラムにより変更する
+## 使用例  
+ <xref:System.Windows.Controls.TextBlock.TextWrapping%2A> プロパティの値を、プログラムによって変更する方法を、次のコード例に示します。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で、3 つの <xref:System.Windows.Controls.Button> 要素を 1 つの <xref:System.Windows.Controls.StackPanel> 要素内に配置しています。<xref:System.Windows.Controls.Button> の各 <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントは、コード内のイベント ハンドラーに対応しています。  ボタンがクリックされると、イベント ハンドラーは `txt2` に適用する <xref:System.Windows.Controls.TextBlock.TextWrapping%2A> 値と同じ名前を使用します。  また、`txt1` 内のテキスト \([!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に表示されない <xref:System.Windows.Controls.TextBlock>\) は、プロパティの変更を反映するように更新されます。  
+  
+ [!code-xml[TextWrapProperty#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextWrapProperty/VisualBasic/Pane1.xaml#1)]  
+  
+ [!code-csharp[TextWrapProperty#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextWrapProperty/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[TextWrapProperty#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextWrapProperty/VisualBasic/Pane1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.TextBlock.TextWrapping%2A>   
+ <xref:System.Windows.TextWrapping>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-clone-a-printer.md b/docs/framework/wpf/advanced/how-to-clone-a-printer.md
new file mode 100644
index 00000000000..107159cd0e8
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-clone-a-printer.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : プリンターを複製する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複製 (印刷キューを)"
+  - "複製 (プリンターを)"
+  - "印刷キュー"
+  - "印刷キュー, クローンの作成"
+  - "プリンター, クローンの作成"
+ms.assetid: dd6997c9-fe04-40f8-88a6-92e3ac0889eb
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : プリンターを複製する
+ほとんどの企業は、ある時点で、同じモデルのプリンターを複数購入します。  通常、これらのプリンターはすべて、ほぼ同一の構成設定でインストールされます。  プリンターを個別にインストールすると、時間がかかったりエラーが発生したりすることがあります。  [!INCLUDE[TLA#tla_avalonwinfx](../../../../includes/tlasharptla-avalonwinfx-md.md)] で公開されている <xref:System.Printing.IndexedProperties?displayProperty=fullName> 名前空間と <xref:System.Printing.PrintServer.InstallPrintQueue%2A> クラスを使用すると、既存の印刷キューから複製した任意の数の追加印刷キューを直ちにインストールすることができます。  
+  
+## 使用例  
+ 次の例の 2 番目の印刷キューは、既存の印刷キューから複製したものです。  2 番目の印刷キューと最初の印刷キューの違いは、名前、場所、ポート、および共有状態だけです。  主な実行手順は次のとおりです。  
+  
+1.  複製する既存のプリンターの <xref:System.Printing.PrintQueue> オブジェクトを作成します。  
+  
+2.  <xref:System.Printing.PrintQueue> の <xref:System.Printing.PrintSystemObject.PropertiesCollection%2A> から <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> を作成します。  このディクショナリの各エントリの <xref:System.Collections.DictionaryEntry.Value%2A> プロパティは、<xref:System.Printing.IndexedProperties.PrintProperty> から派生した型の 1 つのオブジェクトです。  このディクショナリのエントリの値を設定するには、2 つの方法があります。  
+  
+    -   ディクショナリの **Remove** メソッドと <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.Add%2A> メソッドを使用してエントリを削除し、目的の値を追加し直します。  
+  
+    -   ディクショナリの <xref:System.Printing.IndexedProperties.PrintPropertyDictionary.SetProperty%2A> メソッドを使用します。  
+  
+     両方の方法を次の例に示します。  
+  
+3.  <xref:System.Printing.IndexedProperties.PrintBooleanProperty> オブジェクトを作成し、その <xref:System.Printing.IndexedProperties.PrintProperty.Name%2A> を "IsShared" に、<xref:System.Printing.IndexedProperties.PrintBooleanProperty.Value%2A> を `true` にそれぞれ設定します。  
+  
+4.  <xref:System.Printing.IndexedProperties.PrintBooleanProperty> オブジェクトを <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> の "IsShared" エントリの値として使用します。  
+  
+5.  <xref:System.Printing.IndexedProperties.PrintStringProperty> オブジェクトを作成し、その <xref:System.Printing.IndexedProperties.PrintProperty.Name%2A> を "ShareName" に、<xref:System.Printing.IndexedProperties.PrintStringProperty.Value%2A> を適切な <xref:System.String> にそれぞれ設定します。  
+  
+6.  <xref:System.Printing.IndexedProperties.PrintStringProperty> オブジェクトを <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> の "ShareName" エントリの値として使用します。  
+  
+7.  <xref:System.Printing.IndexedProperties.PrintStringProperty> オブジェクトをもう 1 つ作成し、その <xref:System.Printing.IndexedProperties.PrintProperty.Name%2A> を "Location" に、<xref:System.Printing.IndexedProperties.PrintStringProperty.Value%2A> を適切な <xref:System.String> にそれぞれ設定します。  
+  
+8.  2 番目の <xref:System.Printing.IndexedProperties.PrintStringProperty> オブジェクトを <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> の "Location" エントリの値として使用します。  
+  
+9. <xref:System.String> の配列を作成します。  各項目は、サーバー上のポートの名前です。  
+  
+10. <xref:System.Printing.PrintServer.InstallPrintQueue%2A> を使用して、新しいプリンターを新しい値でインストールします。  
+  
+ 次に例を示します。  
+  
+ [!code-csharp[ClonePrinter#ClonePrinter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ClonePrinter/CSharp/Program.cs#cloneprinter)]
+ [!code-vb[ClonePrinter#ClonePrinter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ClonePrinter/visualbasic/program.vb#cloneprinter)]  
+  
+## 参照  
+ <xref:System.Printing.IndexedProperties>   
+ <xref:System.Printing.IndexedProperties.PrintPropertyDictionary>   
+ <xref:System.Printing.LocalPrintServer>   
+ <xref:System.Printing.PrintQueue>   
+ <xref:System.Collections.DictionaryEntry>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md b/docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md
new file mode 100644
index 00000000000..eafe9634b26
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : カスタム ルーティング イベントを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成, ルーティング イベント"
+  - "イベント, ルーティング"
+  - "ルーティング イベント, 作成"
+ms.assetid: b79f459a-1c3f-4045-b2d4-1659cc8eaa3c
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : カスタム ルーティング イベントを作成する
+カスタム イベントが[イベント ルーティング](GTMT)をサポートするには、<xref:System.Windows.EventManager.RegisterRoutedEvent%2A> メソッドを使用して <xref:System.Windows.RoutedEvent> を登録する必要があります。  この例では、カスタム ルーティング イベントを作成するときの基本を示します。  
+  
+## 使用例  
+ 次の例に示すように、まず、<xref:System.Windows.EventManager.RegisterRoutedEvent%2A> メソッドを使用して <xref:System.Windows.RoutedEvent> を登録します。  通常、<xref:System.Windows.RoutedEvent> の静的フィールド名は、サフィックスの ***Event*** で終わる必要があります。  この例では、イベントの名前は `Tap` で、イベントのルーティング方法は <xref:System.Windows.RoutingStrategy> です。  登録呼び出しの後、追加および削除の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] イベント アクセサーをイベントに提供できます。  
+  
+ ここに示す例では、イベントは `OnTap` 仮想メソッドによって発生しますが、イベントを発生させる方法やイベントを変更に応答させる方法は必要に応じて決まることに注意してください。  
+  
+ この例では、基本的に <xref:System.Windows.Controls.Button> のサブクラス全体を実装していることに注意してください。また、このサブクラスは、個別のアセンブリとして作成され、個別の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ページでカスタム クラスとしてインスタンス化されています。  これは概念として、サブクラス化されたコントロールは、他のコントロールで構成されるツリーに挿入でき、このような場合、このコントロールのカスタム イベントは、ネイティブな [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 要素とまったく同じイベント ルーティング機能を備えるということを示しています。  
+  
+ [!code-csharp[RoutedEventCustom#CustomClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventCustom/CSharp/SDKSampleLibrary/class1.cs#customclass)]
+ [!code-vb[RoutedEventCustom#CustomClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RoutedEventCustom/VB/SDKSampleLibrary/Class1.vb#customclass)]  
+  
+ [!code-xml[RoutedEventCustom#Page](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventCustom/CSharp/RoutedEventCustomApp/default.xaml#page)]  
+  
+ トンネル イベントも同じように作成されますが、登録呼び出しで <xref:System.Windows.RoutedEvent.RoutingStrategy%2A> は <xref:System.Windows.RoutingStrategy> に設定される点が異なります。  通常、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、トンネル イベントに "Preview" がプレフィックスとして付加されます。  
+  
+ バブル イベントの動作についての例を確認するには、「[ルーティング イベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-a-routed-event.md)」を参照してください。  
+  
+## 参照  
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-a-data-object.md b/docs/framework/wpf/advanced/how-to-create-a-data-object.md
new file mode 100644
index 00000000000..06a0e4f54ab
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-a-data-object.md
@@ -0,0 +1,91 @@
+---
+title: "方法 : データ オブジェクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ オブジェクト [WPF], 作成"
+  - "DataObject クラス [WPF], 作成"
+  - "ドラッグ アンド ドロップ [WPF], 作成 (データ オブジェクトを)"
+ms.assetid: 022fa142-717d-4fea-a53c-3b52e9d91aff
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : データ オブジェクトを作成する
+<xref:System.Windows.DataObject> クラスによって提供されるコンストラクターを使用してデータ オブジェクトを作成するためのさまざまな方法を次の例に示します。  
+  
+## 例  
+  
+### Description  
+ 新しいデータ オブジェクトを作成し、オーバーロードされたコンストラクターのいずれか \(<xref:System.Windows.DataObject.%23ctor%28System.Object%29>\) を使用して、文字列でデータ オブジェクトを初期化するコード例を次に示します。  ここでは、格納されているデータの型に応じて適切なデータ形式が自動的に判別されます。既定では、格納されるデータの自動変換が有効です。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Simple](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_simple)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Simple](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_simple)]  
+  
+### Description  
+ 次のコード例は、上記のコードの縮小バージョンです。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Simple_Condensed](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_simple_condensed)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Simple_Condensed](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_simple_condensed)]  
+  
+## 例  
+  
+### Description  
+ 新しいデータ オブジェクトを作成し、オーバーロードされたこのコンストラクターのいずれか \(<xref:System.Windows.DataObject.%23ctor%28System.String%2CSystem.Object%29>\) を使用して、文字列と指定したデータ形式でデータ オブジェクトを初期化するコード例を次に示します。  ここでは、データ形式は文字列によって指定されます。<xref:System.Windows.DataFormats> クラスは、事前定義されている一連の型文字列を提供します。  既定では、格納されるデータの自動変換が有効です。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_typestring)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_typestring)]  
+  
+### Description  
+ 次のコード例は、上記のコードの縮小バージョンです。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString_Condensed](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_typestring_condensed)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_TypeString_Condensed](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_typestring_condensed)]  
+  
+## 例  
+  
+### Description  
+ 新しいデータ オブジェクトを作成し、オーバーロードされたこのコンストラクターのいずれか \(<xref:System.Windows.DataObject.%23ctor%2A>\) を使用して、文字列と指定したデータ形式でデータ オブジェクトを初期化するコード例を次に示します。  この場合、データ形式は <xref:System.Type> パラメーターによって指定されます。  既定では、格納されるデータの自動変換が有効です。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Type](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_type)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Type](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_type)]  
+  
+### Description  
+ 次のコード例は、上記のコードの縮小バージョンです。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Type_Condensed](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_type_condensed)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_Type_Condensed](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_type_condensed)]  
+  
+## 例  
+  
+### Description  
+ 新しいデータ オブジェクトを作成し、オーバーロードされたこのコンストラクターのいずれか \(<xref:System.Windows.DataObject.%23ctor%28System.String%2CSystem.Object%2CSystem.Boolean%29>\) を使用して、文字列と指定したデータ形式でデータ オブジェクトを初期化するコード例を次に示します。  ここでは、データ形式は文字列によって指定されます。<xref:System.Windows.DataFormats> クラスは、事前定義されている一連の型文字列を提供します。  この特定のコンストラクター オーバーロードにより、呼び出し元で自動変換を有効にするかどうかを指定できます。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_AutoConvert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_autoconvert)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_AutoConvert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_autoconvert)]  
+  
+### Description  
+ 次のコード例は、上記のコードの縮小バージョンです。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_AutoConvert_Condensed](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_createdataobject_autoconvert_condensed)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_CreateDataObject_AutoConvert_Condensed](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_createdataobject_autoconvert_condensed)]  
+  
+## 参照  
+ <xref:System.Windows.IDataObject>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-a-rollover-effect-using-events.md b/docs/framework/wpf/advanced/how-to-create-a-rollover-effect-using-events.md
new file mode 100644
index 00000000000..7063dd15a8c
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-a-rollover-effect-using-events.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : イベントを使用してロールオーバー効果を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "色 (要素の), 変更"
+  - "要素の色, 変更"
+  - "ロールオーバー効果"
+ms.assetid: 3b20d028-6f1c-4b25-95d2-fa68cefbdb4c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : イベントを使用してロールオーバー効果を作成する
+この例では、ある要素が占める領域にマウス ポインターが出入りするのに合わせて、要素の色を変更する方法を示します。  
+  
+ この例は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルと分離コード ファイルで構成されています。  
+  
+> [!NOTE]
+>  この例ではイベントを使用する方法を示しますが、これと同じ効果を実現するには、スタイルで <xref:System.Windows.Trigger> を使用する方法が推奨されます。  詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA2#tla_titlexaml](../../../../includes/tla2sharptla-titlexaml-md.md)] は、<xref:System.Windows.Controls.Border> で囲まれた <xref:System.Windows.Controls.TextBlock> で構成されるユーザー インターフェイスを作成し、<xref:System.Windows.Input.Mouse.MouseEnter> および <xref:System.Windows.UIElement.MouseLeave> イベント ハンドラーを <xref:System.Windows.Controls.Border> に結合します。  
+  
+ [!code-xml[mouseenterMouseleave#MouseEnterLeaveSampleXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/mouseenterMouseleave/CSharp/Window1.xaml#mouseenterleavesamplexaml)]  
+  
+ 次の分離コードでは、<xref:System.Windows.UIElement.MouseEnter> および <xref:System.Windows.UIElement.MouseLeave> イベント ハンドラーを作成します。  マウス ポインターが <xref:System.Windows.Controls.Border> に入ると、<xref:System.Windows.Controls.Border> の背景が赤に変わります。  マウス ポインターが <xref:System.Windows.Controls.Border> から出ると、<xref:System.Windows.Controls.Border> の背景は白に戻ります。  
+  
+ [!code-csharp[mouseenterMouseleave#MouseEnterLeaveSampleEventHandlers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/mouseenterMouseleave/CSharp/Window1.xaml.cs#mouseenterleavesampleeventhandlers)]
+ [!code-vb[mouseenterMouseleave#MouseEnterLeaveSampleEventHandlers](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/mouseenterMouseleave/VisualBasic/Window1.xaml.vb#mouseenterleavesampleeventhandlers)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-a-routedcommand.md b/docs/framework/wpf/advanced/how-to-create-a-routedcommand.md
new file mode 100644
index 00000000000..1e424f7011a
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-a-routedcommand.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : RoutedCommand を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, RoutedCommand, 作成"
+  - "作成, RoutedCommand クラス"
+  - "RoutedCommand クラス, 作成"
+ms.assetid: aaf6979f-69ab-406f-979f-5766daa85fa0
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : RoutedCommand を作成する
+この例では、カスタム <xref:System.Windows.Input.RoutedCommand> を作成する方法、および <xref:System.Windows.Input.ExecutedRoutedEventHandler> と <xref:System.Windows.Input.CanExecuteRoutedEventHandler> を作成して <xref:System.Windows.Input.CommandBinding> に割り当てることによってカスタム コマンドを実装する方法について説明します。  コマンド実行の詳細については、「[コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)」を参照してください。  
+  
+## 使用例  
+ <xref:System.Windows.Input.RoutedCommand> の作成の最初の手順は、コマンドを定義してインスタンス化することです。  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCommandDefinition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcommanddefinition)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCommandDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcommanddefinition)]  
+  
+ コマンドをアプリケーションで使用するには、コマンドの実行内容を定義するイベント ハンドラーを作成する必要があります。  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewExecuted](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewexecuted)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewExecuted](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewexecuted)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCanExecute](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcanexecute)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCanExecute](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcanexecute)]  
+  
+ 次に、コマンドをイベント ハンドラーに関連付ける <xref:System.Windows.Input.CommandBinding> が作成されます。  特定のオブジェクトで <xref:System.Windows.Input.CommandBinding> が作成されます。  このオブジェクトは、要素ツリー内の <xref:System.Windows.Input.CommandBinding> のスコープを定義します。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewWindowCommandBindingXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewwindowcommandbindingxaml)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCustomCommandBindingCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcustomcommandbindingcodebehind)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCustomCommandBindingCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcustomcommandbindingcodebehind)]  
+  
+ 最後の手順では、コマンドを呼び出します。  コマンドを呼び出す方法の 1 つとして、<xref:System.Windows.Controls.Button> などの <xref:System.Windows.Input.ICommandSource> にコマンドを関連付ける方法があります。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewCustomCommandSourceXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewcustomcommandsourcexaml)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCustomCommandSourceCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcustomcommandsourcecodebehind)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCustomCommandSourceCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcustomcommandsourcecodebehind)]  
+  
+ ボタンがクリックされると、カスタム <xref:System.Windows.Input.RoutedCommand> の <xref:System.Windows.Input.RoutedCommand.Execute%2A> メソッドが呼び出されます。  <xref:System.Windows.Input.RoutedCommand> は、<xref:System.Windows.Input.CommandManager.PreviewExecuted> および <xref:System.Windows.Input.CommandManager.Executed> の各ルーティング イベントを発生させます。  これらのイベントは、この特定のコマンドの <xref:System.Windows.Input.CommandBinding> を要素ツリー内で検索します。  <xref:System.Windows.Input.CommandBinding> が見つかった場合は、<xref:System.Windows.Input.CommandBinding> に関連付けられた <xref:System.Windows.Input.ExecutedRoutedEventHandler> が呼び出されます。  
+  
+## 参照  
+ <xref:System.Windows.Input.RoutedCommand>   
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-a-text-decoration.md b/docs/framework/wpf/advanced/how-to-create-a-text-decoration.md
new file mode 100644
index 00000000000..8fcfb3291a3
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-a-text-decoration.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : 文字の装飾を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ベースライン タイプ"
+  - "フォント, ベースライン"
+  - "フォント, 上線"
+  - "フォント, 取り消し線"
+  - "フォント, 下線"
+  - "上線タイプ"
+  - "取り消し線タイプ"
+  - "テキスト, 装飾"
+  - "タイポグラフィ, 文字の装飾"
+  - "下線タイプ"
+ms.assetid: cf3cb4e7-782a-4be7-b2d4-e0935e21e4e0
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 文字の装飾を作成する
+<xref:System.Windows.TextDecoration> オブジェクトは、テキストに追加できる視覚的な装飾です。  文字装飾には、下線、ベースライン、取り消し線、および上線の 4 種類あります。  テキストに対する文字装飾の位置を次の例に示します。  
+  
+ ![テキスト装飾位置のダイアグラム](../../../../docs/framework/wpf/advanced/media/textdecoration01.png "TextDecoration01")  
+文字装飾の種類の例  
+  
+ テキストに文字装飾を追加するには、<xref:System.Windows.TextDecoration> オブジェクトを作成し、そのプロパティを変更します。  下線などの文字装飾を表示する位置を指定するには、<xref:System.Windows.TextDecoration.Location%2A> プロパティを使用します。  塗りつぶしの純色やグラデーション カラーなどの文字装飾の外観を指定するには、<xref:System.Windows.TextDecoration.Pen%2A> プロパティを使用します。  <xref:System.Windows.TextDecoration.Pen%2A> プロパティに値を指定しない場合、装飾は既定でテキストと同じ色になります。  <xref:System.Windows.TextDecoration> オブジェクトを定義したら、それを目的のテキスト オブジェクトの <xref:System.Windows.TextDecorations> コレクションに追加します。  
+  
+ 線形グラデーション ブラシと破線のペンによってスタイルが設定されている文字装飾の例を次に示します。  
+  
+ ![線形グラデーション下線を使用したテキスト装飾](../../../../docs/framework/wpf/advanced/media/textdecoration02.png "TextDecoration02")  
+線形グラデーション ブラシと破線のペンによってスタイルが設定された下線の例  
+  
+ <xref:System.Windows.Documents.Hyperlink> オブジェクトはインラインレベルのフロー コンテンツ要素であり、これを使用すると、フロー コンテンツ内でハイパーリンクをホストできます。  既定では、<xref:System.Windows.Documents.Hyperlink> は、下線を表示するために、<xref:System.Windows.TextDecoration> オブジェクトを使用します。  <xref:System.Windows.TextDecoration> オブジェクトは、インスタンス化するために、パフォーマンスに大きな負荷をかけることがあります。特に、多数の <xref:System.Windows.Documents.Hyperlink> オブジェクトを使用する場合には、大きな負荷をかけます。  <xref:System.Windows.Documents.Hyperlink> 要素を広く使用する場合は、<xref:System.Windows.ContentElement.MouseEnter> イベントのようなイベントが発生したときにだけ下線を表示することを、検討する必要があります。  
+  
+ 次の例では、"My MSN" リンクの下線は動的であり、<xref:System.Windows.ContentElement.MouseEnter> イベントが発生したときにのみ表示されます。  
+  
+ ![TextDecorations を表示するハイパーリンク](../../../../docs/framework/wpf/advanced/media/textdecoration03.png "TextDecoration03")  
+TextDecorations が定義されたハイパーリンク  
+  
+ 詳細については、「[ハイパーリンクに下線を引くかどうかを指定する](../../../../docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md)」を参照してください。  
+  
+## 使用例  
+ 次のコード例では、下線の文字装飾で既定のフォント値が使用されています。  
+  
+ [!code-csharp[TextDecorationSnippets#TextDecorationSnippets1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml.cs#textdecorationsnippets1)]
+ [!code-vb[TextDecorationSnippets#TextDecorationSnippets1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextDecorationSnippets/visualbasic/window1.xaml.vb#textdecorationsnippets1)]
+ [!code-xml[TextDecorationSnippets#TextDecorationSnippets1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml#textdecorationsnippets1)]  
+  
+ 次のコード例では、純色のブラシをペンとして使用した下線の文字装飾が作成されます。  
+  
+ [!code-csharp[TextDecorationSnippets#TextDecorationSnippets2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml.cs#textdecorationsnippets2)]
+ [!code-vb[TextDecorationSnippets#TextDecorationSnippets2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextDecorationSnippets/visualbasic/window1.xaml.vb#textdecorationsnippets2)]
+ [!code-xml[TextDecorationSnippets#TextDecorationSnippets2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml#textdecorationsnippets2)]  
+  
+ 次のコード例では、破線のペン用の線形グラデーション ブラシによって下線の文字装飾が作成されます。  
+  
+ [!code-csharp[TextDecorationSnippets#TextDecorationSnippets3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml.cs#textdecorationsnippets3)]
+ [!code-vb[TextDecorationSnippets#TextDecorationSnippets3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextDecorationSnippets/visualbasic/window1.xaml.vb#textdecorationsnippets3)]
+ [!code-xml[TextDecorationSnippets#TextDecorationSnippets3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextDecorationSnippets/CSharp/Window1.xaml#textdecorationsnippets3)]  
+  
+## 参照  
+ <xref:System.Windows.TextDecoration>   
+ <xref:System.Windows.Documents.Hyperlink>   
+ [ハイパーリンクに下線を引くかどうかを指定する](../../../../docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-outlined-text.md b/docs/framework/wpf/advanced/how-to-create-outlined-text.md
new file mode 100644
index 00000000000..fcaed987af2
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-outlined-text.md
@@ -0,0 +1,65 @@
+---
+title: "方法 : 中抜きの文字列を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラデーション ブラシ"
+  - "線形グラデーション ブラシ"
+  - "中抜きの文字列"
+  - "タイポグラフィ, 線形グラデーション ブラシ"
+  - "タイポグラフィ, 中抜き効果"
+ms.assetid: 4aa3cf6e-1953-4f26-8230-7c1409e5f28d
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 中抜きの文字列を作成する
+通常、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでテキスト文字列に装飾を追加する場合は、別個の文字、つまりグリフのコレクションとしてのテキストを使用します。  たとえば、線形グラデーション ブラシを作成し、それを <xref:System.Windows.Controls.TextBox> オブジェクトの <xref:System.Windows.Controls.Control.Foreground%2A> プロパティに適用できます。  テキスト ボックスを表示または編集すると、テキスト文字列の現在の文字セットに、線形グラデーション ブラシが自動的に適用されます。  
+  
+ ![線形グラデーション ブラシで表示されるテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext01.png "OutlinedText01")  
+テキスト ボックスに適用された線形グラデーション ブラシの例  
+  
+ テキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換し、人の目をひきつける他の種類のテキストを作成することもできます。  たとえば、テキスト文字列のアウトラインに基づいて <xref:System.Windows.Media.Geometry> オブジェクトを作成できます。  
+  
+ ![線形グラデーション ブラシを使用するテキスト アウトライン](../../../../docs/framework/wpf/advanced/media/outlinedtext02.png "OutlinedText02")  
+アウトライン ジオメトリのテキストに適用された線形グラデーション ブラシの例  
+  
+ テキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換すると、テキストは文字の集まりではなくなります。つまり、文字列内の文字を変更することはできません。  ただし、変換されたテキストのストロークおよび塗りつぶしのプロパティを変更することで、テキストの外観を変えることができます。  ストロークは、変換したテキストのアウトラインを参照します。塗りつぶしは、変換したテキストのアウトラインの内側の領域を参照します。  
+  
+ 変換されたテキストのストロークおよび塗りつぶしを変更して、視覚効果を作成するいくつかの方法を次の例に示します。  
+  
+ ![塗りつぶしとストロークに別の色を使用するテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext03.png "OutlinedText03")  
+ストロークおよび塗りつぶしを別々の色に設定した例  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext04.png "OutlinedText04")  
+ストロークに適用したイメージ ブラシの例  
+  
+ 変換されたテキストの境界ボックスの四角形または強調表示を変更することもできます。  変換されたテキストのストロークおよび強調表示を変更して、視覚効果を作成する方法の一例を次に示します。  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext05.png "OutlinedText05")  
+ストロークおよび強調表示に適用したイメージ ブラシの例  
+  
+## 使用例  
+ テキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換する場合の要点は、<xref:System.Windows.Media.FormattedText> オブジェクトを使用することです。  このオブジェクトを作成したら、<xref:System.Windows.Media.FormattedText.BuildGeometry%2A> メソッドと <xref:System.Windows.Media.FormattedText.BuildHighlightGeometry%2A> メソッドを使用して、テキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換できます。  最初のメソッドは、書式設定されたテキストのジオメトリを返します。2 番目のメソッドは、書式設定されたテキストの境界ボックスのジオメトリを返します。  <xref:System.Windows.Media.FormattedText> オブジェクトを作成し、書式設定されたテキストとその境界ボックスのジオメトリを取得する方法を次のコード例に示します。  
+  
+ [!code-csharp[OutlineTextControlViewer#CreateText](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OutlineTextControlViewer/CSharp/OutlineTextControl.cs#createtext)]
+ [!code-vb[OutlineTextControlViewer#CreateText](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/OutlineTextControlViewer/visualbasic/outlinetextcontrol.vb#createtext)]  
+  
+ 取得された <xref:System.Windows.Media.Geometry> オブジェクトを表示するには、変換されたテキストを表示しているオブジェクトの <xref:System.Windows.Media.DrawingContext> にアクセスする必要があります。  これらのコード例では、ユーザー定義のレンダリングをサポートするクラスの派生カスタム コントロール オブジェクトを作成することで、これを行います。  
+  
+ カスタム コントロールで <xref:System.Windows.Media.Geometry> オブジェクトを表示するには、<xref:System.Windows.UIElement.OnRender%2A> メソッドのオーバーライドを提供します。  オーバーライドしたメソッドでは、<xref:System.Windows.Media.DrawingContext.DrawGeometry%2A> メソッドを使用して <xref:System.Windows.Media.Geometry> オブジェクトを描画する必要があります。  
+  
+ [!code-csharp[OutlineTextControlViewer#OnRender](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OutlineTextControlViewer/CSharp/OutlineTextControl.cs#onrender)]
+ [!code-vb[OutlineTextControlViewer#OnRender](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/OutlineTextControlViewer/visualbasic/outlinetextcontrol.vb#onrender)]  
+  
+## 参照  
+ [書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-create-text-with-a-shadow.md b/docs/framework/wpf/advanced/how-to-create-text-with-a-shadow.md
new file mode 100644
index 00000000000..88997620b1a
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-create-text-with-a-shadow.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : 影付きテキストを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "シャドウ効果 (テキストの)"
+  - "テキスト, 'Shadows' を実行"
+  - "タイポグラフィ, シャドウ効果"
+ms.assetid: 6ab9c754-6001-4708-b479-5367f2fd1a35
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : 影付きテキストを作成する
+このセクションの例では、表示テキストのシャドウ効果を作成する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Effects.DropShadowEffect> オブジェクトを使用すると、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] オブジェクトのさまざまなドロップ シャドウ効果を作成できます。  テキストにドロップ シャドウ効果が適用されている例を次に示します。  ここでは、影はソフト シャドウで、影の色にぼかしが使用されています。  
+  
+ ![ぼかし &#61; 0.25 のテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext01.png "ShadowText01")  
+ソフト シャドウを適用したテキストの例  
+  
+ <xref:System.Windows.Media.Effects.DropShadowEffect.ShadowDepth%2A> プロパティを設定して、影の幅を制御できます。  値 `4.0` は、影の幅が 4 ピクセルであることを示します。  <xref:System.Windows.Media.Effects.DropShadowEffect.BlurRadius%2A> プロパティを変更して、影のぼかしを制御できます。  値 `0.0` は、ぼかしがないことを示します。  ソフト シャドウを作成する方法を次のコード例に示します。  
+  
+ [!code-xml[TextShadowSnippets#TextShadowSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextShadowSnippets/CS/SingleShadows.xaml#textshadowsnippet1)]  
+  
+> [!NOTE]
+>  シャドウ効果は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] テキスト レンダリング パイプラインを経由しません。  そのため、シャドウ効果を使用する場合、ClearType は無効です。  
+  
+ テキストにハード ドロップ シャドウ効果が適用されている例を次に示します。  ここでは、影のぼかしは使用されません。  
+  
+ ![ぼかし &#61; 0 のテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext02.png "ShadowText02")  
+ハード シャドウを適用したテキストの例  
+  
+ <xref:System.Windows.Media.Effects.DropShadowEffect.BlurRadius%2A> プロパティを `0.0` に設定することで、ぼかしはまったく使用されなくなり、ハード シャドウを作成できます。  <xref:System.Windows.Media.Effects.DropShadowEffect.Direction%2A> プロパティを変更して、影の方向を制御できます。  このプロパティの方向の値を `0` から `360` の間の角度に設定します。  <xref:System.Windows.Media.Effects.DropShadowEffect.Direction%2A> プロパティで設定する方向の値を次の図に示します。  
+  
+ ![シャドウの DropShadow 度の設定](../../../../docs/framework/wpf/advanced/media/shadowtext08.png "ShadowText08")  
+DropShadow 方向の図  
+  
+ ハード シャドウを作成する方法を次のコード例に示します。  
+  
+ [!code-xml[TextShadowSnippets#TextShadowSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextShadowSnippets/CS/SingleShadows.xaml#textshadowsnippet2)]  
+  
+## ぼかし効果の使用  
+ <xref:System.Windows.Media.Effects.BlurBitmapEffect> を使用すると、影のような効果を作成して、テキスト オブジェクトの後ろに適用できます。  テキストに適用されるぼかしビットマップ効果は、テキストのすべての方向へ均等に、ぼかしを適用します。  
+  
+ テキストにぼかし効果が適用されている例を次に示します。  
+  
+ ![BlurBitmapEffect を使用するテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext06.png "ShadowText06")  
+ぼかし効果を適用したテキストの例  
+  
+ ぼかし効果を作成する方法を次のコード例に示します。  
+  
+ [!code-xml[TextShadowSnippets#TextShadowSnippet6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextShadowSnippets/CS/BlurShadows.xaml#textshadowsnippet6)]  
+  
+## TranslateTransform の使用  
+ <xref:System.Windows.Media.TranslateTransform> を使用すると、影のような効果を作成して、テキスト オブジェクトの後ろに適用できます。  
+  
+ <xref:System.Windows.Media.TranslateTransform> を使用してテキストをオフセットするコード例を次に示します。  この例では、主要なテキストの下のわずかにオフセットされたテキストのコピーにより、シャドウ効果が作成されます。  
+  
+ ![TranslateTransform を使用するテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext07.png "ShadowText07")  
+シャドウ効果への変換を使用しているテキストの例  
+  
+ シャドウ効果への変換を作成する方法を次のコード例に示します。  
+  
+ [!code-xml[TextShadowSnippets#TextShadowSnippet7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextShadowSnippets/CS/TransformShadows.xaml#textshadowsnippet7)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-data-bind-to-an-inkcanvas.md b/docs/framework/wpf/advanced/how-to-data-bind-to-an-inkcanvas.md
new file mode 100644
index 00000000000..f1b9e64e7fb
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-data-bind-to-an-inkcanvas.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : InkCanvas にデータをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "InkCanvas へのデータ バインディング"
+  - "InkCanvas へのデータ バインディング"
+ms.assetid: 8d6b4d9e-ea7f-4412-ba83-3feccec5a515
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : InkCanvas にデータをバインドする
+## <a name="example"></a>例  
+ 次の例では、バインド、<xref:System.Windows.Controls.InkCanvas.Strokes%2A>のプロパティ、 <xref:System.Windows.Controls.InkCanvas>間<xref:System.Windows.Controls.InkCanvas>します。  
+  
+ [!code-xml[InkCanvasBindingSnippet#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkCanvasBindingSnippet/CS/Window2.xaml#2)]  
+  
+ 次の例では、バインド、 <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A>プロパティをデータ ソース。  
+  
+ [!code-xml[InkCanvasBindingSnippet#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkCanvasBindingSnippet/CS/Window2.xaml#3)]  
+[!code-xml[InkCanvasBindingSnippet#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkCanvasBindingSnippet/CS/Window2.xaml#4)]  
+  
+ 次の例で&2; つ<xref:System.Windows.Controls.InkCanvas> XAML 内のオブジェクトし、他のデータ ソース間のデータ バインドを確立します。  最初の<xref:System.Windows.Controls.InkCanvas>という`ic`、2 つのデータ ソースにバインドします。  <xref:System.Windows.Controls.InkCanvas.EditingMode%2A>と<xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A>プロパティを`ic`にバインドされた<xref:System.Windows.Controls.ListBox>さらに、XAML で定義されている配列にバインドされているオブジェクト。  <xref:System.Windows.Controls.InkCanvas.EditingMode%2A>、 <xref:System.Windows.Controls.InkCanvas.DefaultDrawingAttributes%2A>と<xref:System.Windows.Controls.InkCanvas.Strokes%2A>、2 番目のプロパティ<xref:System.Windows.Controls.InkCanvas>バインドは、最初に<xref:System.Windows.Controls.InkCanvas>、`ic`です。  
+  
+ [!code-xml[InkCanvasBindingSnippet#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkCanvasBindingSnippet/CS/Window1.xaml#1)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md b/docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md
new file mode 100644
index 00000000000..33aea27fc4b
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md
@@ -0,0 +1,31 @@
+---
+title: "方法 : XAML を使用してテーブルを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 定義 (XAML でテーブルを)"
+  - "テーブル, 定義 (XAML で)"
+  - "XAML, 定義 (テーブルを)"
+ms.assetid: 83f2dc58-437e-4cdc-b5dd-0019810c7a85
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : XAML を使用してテーブルを定義する
+この例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して <xref:System.Windows.Documents.Table> を定義する方法を示します。  例で定義するテーブルには、4 つの列 \(<xref:System.Windows.Documents.TableColumn> 要素によって表される\) といくつかの行 \(<xref:System.Windows.Documents.TableRow> 要素によって表される\) があり、データの他にタイトル、ヘッダー、およびフッターの情報を格納します。  行は、<xref:System.Windows.Documents.TableRowGroup> 要素に格納する必要があります。  テーブルの各行は、1 つ以上のセル \(<xref:System.Windows.Documents.TableCell> 要素によって表される\) で構成されます。  テーブルのセル内のコンテンツは、<xref:System.Windows.Documents.Block> 要素に格納する必要があります。この例では、<xref:System.Windows.Documents.Paragraph> 要素を使用しています。  このテーブルには、ハイパーリンク \(<xref:System.Windows.Documents.Hyperlink> 要素で表される\) もフッター行内にあります。  
+  
+## 使用例  
+ [!code-xml[TableSnippetsXAML#_TableXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippetsXAML/CS/Window1.xaml#_tablexaml)]  
+  
+ この例で定義されたテーブルのレンダリング結果を次の図に示します。  
+  
+ ![描画されたテーブル。](../../../../docs/framework/wpf/advanced/media/tableeg.png "TableEG")
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-define-and-reference-a-resource.md b/docs/framework/wpf/advanced/how-to-define-and-reference-a-resource.md
new file mode 100644
index 00000000000..41e52ff3f5f
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-define-and-reference-a-resource.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : リソースを定義および参照する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "定義 (リソースを)"
+  - "参照 (リソースを)"
+  - "リソース, 定義"
+  - "リソース, 参照"
+ms.assetid: b86b876b-0a10-489b-9a5d-581ea9b32406
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : リソースを定義および参照する
+この例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 内の属性を使用して、リソースを定義および参照する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.SolidColorBrush> リソースおよびいくつかの <xref:System.Windows.Style> リソースの、2 つの種類のリソースを定義する例を次に示します。  <xref:System.Windows.Media.SolidColorBrush> リソースの `MyBrush` を使用して、<xref:System.Windows.Media.Brush> 型の値を取得するいくつかのプロパティの値を提供します。  <xref:System.Windows.Style> リソースの `PageBackground`、 `TitleText`、`Label` は、それぞれ特定のコントロール型をターゲットにします。  スタイル リソースをリソース キーで参照し、そのスタイル リソースを使用して [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義するいくつかの特定のコントロール要素の <xref:System.Windows.FrameworkElement.Style%2A> プロパティを設定するとき、スタイルは、対象のコントロールのさまざまなプロパティを設定します。  
+  
+ `Label` スタイルの setter 内のプロパティの 1 つは、先に定義した `MyBrush` リソースも参照していることに注意してください。  これは一般的な手法ですが、リソースは、指定した順に解析されリソース ディクショナリに追加されます。  [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)を使用して別のリソース内から参照する場合、リソースは、ディクショナリ内で見つかった順序で要求されます。  参照するリソースは、そのリソースが要求されるよりも先に、リソース コレクション内ですべて定義しておく必要があります。  必要に応じて、代わりに [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)を使用してリソースを実行時に参照することで、このリソース参照の厳密な作成手順を回避できますが、この DynamicResource 手法はパフォーマンスを低下させることに注意してください。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ [!code-xml[FEResource#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEResource/CS/default.xaml#xaml)]  
+  
+## 参照  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-detect-when-the-enter-key-pressed.md b/docs/framework/wpf/advanced/how-to-detect-when-the-enter-key-pressed.md
new file mode 100644
index 00000000000..0f476f121f7
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-detect-when-the-enter-key-pressed.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : Enter キーが押されたことを検出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Enter キー, 検出"
+  - "キー, Enter"
+ms.assetid: a66f39d2-ef4a-43a5-b454-a4ea0fe88655
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Enter キーが押されたことを検出する
+キーボードで <xref:System.Windows.Input.Key> キーが押されたことを検出する方法を次の例に示します。  
+  
+ この例は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルと分離コード ファイルで構成されています。  
+  
+## 使用例  
+ ユーザーが <xref:System.Windows.Controls.TextBox> で <xref:System.Windows.Input.Key> キーを押すと、テキスト ボックスに入力された内容が[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の別の領域に表示されます。  
+  
+ 次の [!INCLUDE[TLA2#tla_titlexaml](../../../../includes/tla2sharptla-titlexaml-md.md)] は、<xref:System.Windows.Controls.StackPanel>、<xref:System.Windows.Controls.TextBlock>、および <xref:System.Windows.Controls.TextBox> で構成されるユーザー インターフェイスを作成します。  
+  
+ [!code-xml[keydown#KeyDownUI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyDown/CSharp/Window1.xaml#keydownui)]  
+  
+ 次の分離コードでは、<xref:System.Windows.UIElement.KeyDown> イベント ハンドラーを作成します。  押されたキーが <xref:System.Windows.Input.Key> キーの場合は、<xref:System.Windows.Controls.TextBlock> にメッセージが表示されます。  
+  
+ [!code-csharp[keydown#KeyDownSample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyDown/CSharp/Window1.xaml.cs#keydownsample)]
+ [!code-vb[keydown#KeyDownSample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/KeyDown/VisualBasic/Window1.xaml.vb#keydownsample)]  
+  
+## 参照  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-determine-if-a-data-format-is-present-in-a-data-object.md b/docs/framework/wpf/advanced/how-to-determine-if-a-data-format-is-present-in-a-data-object.md
new file mode 100644
index 00000000000..10b3bb3d692
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-determine-if-a-data-format-is-present-in-a-data-object.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : データ形式がデータ オブジェクトに存在するかどうかを判別する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ形式 [WPF], 判断 (存在するかどうかを)"
+  - "DataFormats クラス [WPF]"
+  - "ドラッグ アンド ドロップ [WPF], 存在するデータ形式"
+ms.assetid: e487a454-c9fc-4e53-aeaa-c458d059ad4c
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : データ形式がデータ オブジェクトに存在するかどうかを判別する
+さまざまな <xref:System.Windows.DataObject.GetDataPresent%2A> メソッドのオーバーロードを使用して、特定のデータ形式がデータ オブジェクトに存在するかどうかを照会する方法を次の例に示します。  
+  
+## 例  
+  
+### Description  
+ <xref:System.Windows.DataObject.GetDataPresent%28System.String%29> オーバーロードを使用して、記述子文字列ごとに特定のデータ形式の存在を照会するコード例を次に示します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_String](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_querydataformats_string)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_String](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_querydataformats_string)]  
+  
+## 例  
+  
+### Description  
+ <xref:System.Windows.DataObject.GetDataPresent%28System.Type%29> オーバーロードを使用して、型ごとに特定のデータ形式の存在を照会するコード例を次に示します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_Type](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_querydataformats_type)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_Type](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_querydataformats_type)]  
+  
+## 例  
+  
+### Description  
+ <xref:System.Windows.DataObject.GetDataPresent%28System.String%2CSystem.Boolean%29> オーバーロードを使用して記述子文字列ごとにデータを照会し、自動変換が可能なデータ形式の処理方法を指定するコード例を次に示します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_Autoconvert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_querydataformats_autoconvert)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_QueryDataFormats_Autoconvert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_querydataformats_autoconvert)]  
+  
+## 参照  
+ <xref:System.Windows.IDataObject>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-determine-whether-a-freezable-is-frozen.md b/docs/framework/wpf/advanced/how-to-determine-whether-a-freezable-is-frozen.md
new file mode 100644
index 00000000000..9a85c2903bb
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-determine-whether-a-freezable-is-frozen.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : Freezable が固定されているかどうかを判別する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Freezable オブジェクト, 判断 (固定されているかどうかを)"
+  - "IsFrozen プロパティ"
+ms.assetid: 92e58baa-ee12-4a9e-ac3a-ca458807a8b2
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Freezable が固定されているかどうかを判別する
+この例では、<xref:System.Windows.Freezable> オブジェクトが固定されているかどうかを判別する方法を示します。  固定された <xref:System.Windows.Freezable> オブジェクトを変更しようとすると、<xref:System.InvalidOperationException> がスローされます。  この例外がスローされるのを避けるには、<xref:System.Windows.Freezable> オブジェクトの <xref:System.Windows.Freezable.IsFrozen%2A> プロパティを使用して、オブジェクトが固定されているかどうかを判別します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.SolidColorBrush> を固定した後、<xref:System.Windows.Freezable.IsFrozen%2A> プロパティを使用してテストし、固定されているかどうかを判別する例を次に示します。  
+  
+ [!code-csharp[freezablesample_procedural#CheckIsFrozenExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#checkisfrozenexample)]
+ [!code-vb[freezablesample_procedural#CheckIsFrozenExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#checkisfrozenexample)]  
+  
+ <xref:System.Windows.Freezable> オブジェクトの詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Freezable>   
+ <xref:System.Windows.Freezable.IsFrozen%2A>   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/base-elements-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-diagnose-problematic-print-job.md b/docs/framework/wpf/advanced/how-to-diagnose-problematic-print-job.md
new file mode 100644
index 00000000000..4ea17f333cd
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-diagnose-problematic-print-job.md
@@ -0,0 +1,94 @@
+---
+title: "方法 : 問題のある印刷ジョブを診断する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "印刷ジョブ, 診断 (問題を)"
+  - "印刷ジョブ, トラブルシューティング"
+  - "トラブルシューティング (印刷ジョブに関する問題を)"
+ms.assetid: b081a170-84c6-48f9-a487-5766a8d58a82
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 問題のある印刷ジョブを診断する
+ネットワーク管理者は、印刷ジョブで印刷を実行できない、印刷速度が遅いなどのユーザーからの苦情を処理することがよくあります。  [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] の [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] で公開されているさまざまな印刷ジョブのプロパティには、印刷ジョブを迅速にリモート診断する手段が用意されています。  
+  
+## 使用例  
+ このようなユーティリティを作成する主な手順は次のとおりです。  
+  
+1.  ユーザーから苦情が出ている印刷ジョブを特定します。  多くの場合、ユーザーはそのジョブを正確に特定できません。  プリント サーバーまたはプリンターの名前がわからない場合があります。  プリンターの場所を、<xref:System.Printing.PrintQueue.Location%2A> プロパティの設定に使用した用語とは異なる用語で説明する場合もあります。  したがって、ユーザーが現在送信しているジョブのリストを生成することをお勧めします。  ジョブが複数存在する場合は、ユーザーと印刷システム管理者間の通信を使用して、問題のあるジョブを特定できます。  その手順は次のとおりです。  
+  
+    1.  すべてのプリント サーバーのリストを取得します。  
+  
+    2.  印刷キューを照会するためにサーバーをループします。  
+  
+    3.  サーバー ループの各パス内で、ジョブを照会するためにすべてのサーバーのキューをループします。  
+  
+    4.  キュー ループの各パス内でジョブをループして、苦情を訴えているユーザーが送信したジョブに関する識別情報を収集します。  
+  
+2.  問題のある印刷ジョブを特定したら、関連するプロパティを調べて問題を確認します。  たとえば、ジョブがエラー状態になっていないか、キューにサービスを提供しているプリンターがジョブの印刷前にオフラインになっていないかなどを確認します。  
+  
+ 一連のコード例を次のコードに示します。  最初のコード例には、印刷キューのループが示されています   \(前の 手順 1c. を参照\)。変数 `myPrintQueues` は、現在のプリント サーバーの <xref:System.Printing.PrintQueueCollection> オブジェクトです。  
+  
+ このコード例では、まず <xref:System.Printing.PrintQueue.Refresh%2A?displayProperty=fullName> を使用して、現在の印刷キューのオブジェクトを更新します。  これにより、オブジェクトのプロパティが、オブジェクトに示される物理プリンターの状態を正確に表すようになります。  次に、アプリケーションが <xref:System.Printing.PrintQueue.GetPrintJobInfoCollection%2A> を使用して、現在印刷キューに存在する印刷ジョブのコレクションを取得します。  
+  
+ 次に、アプリケーションは <xref:System.Printing.PrintSystemJobInfo> コレクションをループし、各 <xref:System.Printing.PrintSystemJobInfo.Submitter%2A> プロパティと苦情を訴えているユーザーのエイリアスを比較します。  一致した場合、アプリケーションは、ジョブに関する識別情報を表示される文字列に追加します   \(変数 `userName` および `jobList` は、これより前にアプリケーションで初期化されています\)。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#EnumerateJobsInQueues](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#enumeratejobsinqueues)]
+ [!code-csharp[DiagnoseProblematicPrintJob#EnumerateJobsInQueues](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#enumeratejobsinqueues)]
+ [!code-vb[DiagnoseProblematicPrintJob#EnumerateJobsInQueues](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#enumeratejobsinqueues)]  
+  
+ 次のコード例では、手順 2. のアプリケーションを取り上げます   \(前の説明を参照\)。問題のあるジョブが特定され、その識別情報の入力を求めるメッセージがアプリケーションから表示されます。  この情報から、<xref:System.Printing.PrintServer>、<xref:System.Printing.PrintQueue>、および <xref:System.Printing.PrintSystemJobInfo> の各オブジェクトが作成されます。  
+  
+ この時点で、アプリケーションには次の印刷ジョブのステータスを確認する 2 つの方法に対応する分岐構造があります。  
+  
+-   <xref:System.Printing.PrintJobStatus> 型の <xref:System.Printing.PrintSystemJobInfo.JobStatus%2A> プロパティのフラグを読み取ることができる。  
+  
+-   <xref:System.Printing.PrintSystemJobInfo.IsBlocked%2A> や <xref:System.Printing.PrintSystemJobInfo.IsInError%2A> などの各関連プロパティを読み取ることができる。  
+  
+ この例では両方の方法を示すため、ユーザーは使用する方法に関して入力を求められ、<xref:System.Printing.PrintSystemJobInfo.JobStatus%2A> プロパティのフラグを使用する場合は「Y」と応答しています。  2 つの方法の詳細については、以下を参照してください。  最後に、アプリケーションは **ReportQueueAndJobAvailability** というメソッドを使用して、現時点でジョブを印刷できるかどうかを報告します。  このメソッドについては、「[現在、印刷ジョブが印刷可能であるかどうかを検出する](../../../../docs/framework/wpf/advanced/how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md)」で説明しています。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#IdentifyAndDiagnoseProblematicJob](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#identifyanddiagnoseproblematicjob)]
+ [!code-csharp[DiagnoseProblematicPrintJob#IdentifyAndDiagnoseProblematicJob](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#identifyanddiagnoseproblematicjob)]
+ [!code-vb[DiagnoseProblematicPrintJob#IdentifyAndDiagnoseProblematicJob](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#identifyanddiagnoseproblematicjob)]  
+  
+ <xref:System.Printing.PrintSystemJobInfo.JobStatus%2A> プロパティのフラグを使用して印刷ジョブのステータスを確認するには、各関連フラグが設定されているかどうかを確認します。  1 ビットがビット フラグ セットで設定されているかどうかを確認するには、通常、フラグ セットを 1 つのオペランドとし、フラグ自体をもう 1 つのオペランドとして、論理 AND 演算を行います。  フラグ自体には 1 ビットのみが設定されているため、論理 AND を実行すると、最大でもその同じビットが設定されます。  該当するかどうかを確認するには、論理 AND の結果とフラグ自体を比較します。  詳細については、<xref:System.Printing.PrintJobStatus>、[& 演算子 \(C\# リファレンス\)](../Topic/&%20Operator%20\(C%23%20Reference\).md)、および <xref:System.FlagsAttribute> を参照してください。  
+  
+ 次のコードでは、ビットが設定されている属性ごとにこの報告をコンソール画面に表示し、場合によっては応答方法を示します   \(ジョブまたはキューが一時停止されている場合に呼び出される **HandlePausedJob** メソッドについては、後で説明します\)。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#SpotTroubleUsingJobAttributes](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#spottroubleusingjobattributes)]
+ [!code-csharp[DiagnoseProblematicPrintJob#SpotTroubleUsingJobAttributes](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#spottroubleusingjobattributes)]
+ [!code-vb[DiagnoseProblematicPrintJob#SpotTroubleUsingJobAttributes](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#spottroubleusingjobattributes)]  
+  
+ 個別のプロパティを使用して印刷ジョブのステータスを確認するには、単に各プロパティを読み取り、プロパティが `true` の場合は報告をコンソール画面に表示し、場合によっては応答方法を示します   \(ジョブまたはキューが一時停止されている場合に呼び出される **HandlePausedJob** メソッドについては、後で説明します\)。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#SpotTroubleUsingJobProperties](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#spottroubleusingjobproperties)]
+ [!code-csharp[DiagnoseProblematicPrintJob#SpotTroubleUsingJobProperties](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#spottroubleusingjobproperties)]
+ [!code-vb[DiagnoseProblematicPrintJob#SpotTroubleUsingJobProperties](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#spottroubleusingjobproperties)]  
+  
+ **HandlePausedJob** メソッドを使用すると、アプリケーションのユーザーは、一時停止されているジョブをリモートで再開することができます。  印刷キューの一時停止に正当な理由がある可能性もあるため、このメソッドはまず、再開するかどうかの決定をユーザーに求めるプロンプトを表示します。  「Y」と応答すると、<xref:System.Printing.PrintQueue.Resume%2A?displayProperty=fullName> メソッドが呼び出されます。  
+  
+ 次に、ジョブが印刷キューとは関係なく一時停止されている場合のために、ユーザーはジョブ自体を再開するかどうかを決定するように求められます   \(<xref:System.Printing.PrintQueue.IsPaused%2A?displayProperty=fullName> と <xref:System.Printing.PrintSystemJobInfo.IsPaused%2A?displayProperty=fullName> を比較してください\)。「Y」と応答すると、<xref:System.Printing.PrintSystemJobInfo.Resume%2A?displayProperty=fullName> が呼び出されます。それ以外の場合は、<xref:System.Printing.PrintSystemJobInfo.Cancel%2A> が呼び出されます。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#HandlePausedJob](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#handlepausedjob)]
+ [!code-csharp[DiagnoseProblematicPrintJob#HandlePausedJob](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#handlepausedjob)]
+ [!code-vb[DiagnoseProblematicPrintJob#HandlePausedJob](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#handlepausedjob)]  
+  
+## 参照  
+ <xref:System.Printing.PrintJobStatus>   
+ <xref:System.Printing.PrintSystemJobInfo>   
+ <xref:System.FlagsAttribute>   
+ <xref:System.Printing.PrintQueue>   
+ [& 演算子 \(C\# リファレンス\)](../Topic/&%20Operator%20\(C%23%20Reference\).md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md b/docs/framework/wpf/advanced/how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md
new file mode 100644
index 00000000000..8d172e23111
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md
@@ -0,0 +1,85 @@
+---
+title: "方法 : 現在、印刷ジョブが印刷可能であるかどうかを検出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "印刷ジョブ, タイミング"
+  - "印刷キュー, タイミング"
+  - "プリンター, 可用性"
+ms.assetid: 7e9c8ec1-abf6-4b3d-b1c6-33b35d3c4063
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 現在、印刷ジョブが印刷可能であるかどうかを検出する
+印刷キューは、24 時間常に使用できるわけではありません。  印刷キューには開始時刻と終了時刻のプロパティがあり、特定の時間帯にキューを使用不可能にする場合にこれらを設定します。  この機能は、たとえば、特定の部門が午後 5 時以降にプリンターを独占使用するための予約を行うときに使用できます。  この部門は、プリンターにサービスを提供するキューとして、他の部門が使用するキューとは異なるキューを使用します。  この部門用のキューは常に使用できるように設定し、他の部門のキューは午後 5 時以降は使用できなくなるように設定します。  
+  
+ さらに、印刷ジョブ自体を、指定した時間の間だけ印刷できるように設定できます。  
+  
+ [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] の [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] で公開される <xref:System.Printing.PrintQueue> クラスおよび <xref:System.Printing.PrintSystemJobInfo> クラスは、特定の印刷ジョブが特定のキューで現在印刷可能かどうかをリモートで確認するときに利用できます。  
+  
+## 使用例  
+ 次の例は、印刷ジョブに関する問題を診断できるサンプルです。  
+  
+ この種の関数の主な手順は次の 2 つです。  
+  
+1.  <xref:System.Printing.PrintQueue> の <xref:System.Printing.PrintQueue.StartTimeOfDay%2A> プロパティおよび <xref:System.Printing.PrintQueue.UntilTimeOfDay%2A> プロパティを読み取って、現在の時刻がこの 2 つの間であるかどうかを判断します。  
+  
+2.  <xref:System.Printing.PrintSystemJobInfo> の <xref:System.Printing.PrintSystemJobInfo.StartTimeOfDay%2A> プロパティおよび <xref:System.Printing.PrintSystemJobInfo.UntilTimeOfDay%2A> プロパティを読み取って、現在の時刻がこの 2 つの間であるかどうかを判断します。  
+  
+ ただし、これらのプロパティは <xref:System.DateTime> オブジェクトではないことに注意してください。  これらのプロパティは、時刻を午前 0 時からの経過時間 \(分\) として表す <xref:System.Int32> オブジェクトです。  さらに、これは、現在のタイム ゾーンでの午前 0 時ではなく、UTC \(世界協定時刻\) の午前 0 時です。  
+  
+ 最初のコード例に示す静的メソッド **ReportQueueAndJobAvailability** では、<xref:System.Printing.PrintSystemJobInfo> を受け取り、ヘルパー メソッドを呼び出して、ジョブが現時点で印刷できるかどうかと、できない場合はいつ印刷できるかを判断します。  <xref:System.Printing.PrintQueue> はメソッドに渡されないことに注意してください。  これは、キューに対する参照が、<xref:System.Printing.PrintSystemJobInfo> の <xref:System.Printing.PrintSystemJobInfo.HostingPrintQueue%2A> プロパティに格納されているからです。  
+  
+ 下位メソッドの 1 つに、オーバーロードされた **ReportAvailabilityAtThisTime** メソッドがあり、このメソッドはパラメーターとして <xref:System.Printing.PrintQueue> または <xref:System.Printing.PrintSystemJobInfo> を受け取ります。  また、**TimeConverter.ConvertToLocalHumanReadableTime** もあります。  これらのすべてのメソッドについては、後で説明します。  
+  
+ **ReportQueueAndJobAvailability** メソッドは、最初に、現時点でキューまたは印刷ジョブが使用不可能になっているかどうかを確認します。  どちらかが使用不可能の場合は、次に、キューが使用不可能かどうかを確認します。  使用不可能の場合は、このことと、いつキューが再び使用可能になるかを報告します。  次に、ジョブを確認し、使用不可能の場合は、ジョブが印刷可能になる時間帯を報告します。  最後に、このジョブが最短でいつ印刷可能になるかを報告します。  これは、次の 2 つのうち、遅い方の時刻です。  
+  
+-   印刷キューが次回使用可能になる時刻。  
+  
+-   印刷ジョブが次回使用可能になる時刻。  
+  
+ 時刻を報告するときに、<xref:System.DateTime.ToShortTimeString%2A> メソッドも呼び出します。これは、年月日が出力されないようにするためです。  印刷キューと印刷ジョブのどちらも、使用可能な期間として特定の年、月、または日を指定することはできません。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#ReportQueueAndJobAvailability](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#reportqueueandjobavailability)]
+ [!code-csharp[DiagnoseProblematicPrintJob#ReportQueueAndJobAvailability](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#reportqueueandjobavailability)]
+ [!code-vb[DiagnoseProblematicPrintJob#ReportQueueAndJobAvailability](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#reportqueueandjobavailability)]  
+  
+ **ReportAvailabilityAtThisTime** メソッドの 2 つのオーバーロードは、渡される型を除いて同一であるので、<xref:System.Printing.PrintQueue> バージョンだけを後に示します  
+  
+> [!NOTE]
+>  これらのメソッドが型以外は同一であるにもかかわらず、このサンプルでジェネリック メソッド **ReportAvailabilityAtThisTime\<T\>** を作成しない理由について次に説明します。  このようなメソッドでは、メソッドが呼び出す **StartTimeOfDay** プロパティと **UntilTimeOfDay** プロパティを持つクラスを限定する必要がありますが、ジェネリック メソッドでは限定できるクラスは 1 つだけであるにもかかわらず、継承ツリー内の <xref:System.Printing.PrintQueue> と <xref:System.Printing.PrintSystemJobInfo> の両方に共通の唯一のクラス <xref:System.Printing.PrintSystemObject> には、これらのプロパティはありません。  
+  
+ **ReportAvailabilityAtThisTime** メソッド \(後のコード例に示します\) は、最初に、<xref:System.Boolean> 型のセンティネル変数を `true` に初期化します。  この変数は、キューが使用不可能の場合に `false` に再設定されます。  
+  
+ 次に、開始時刻と終了 \(until\) 時刻が同一であるかどうかを確認します。  同一ならば、キューは常時使用できるので `true` を返します。  
+  
+ キューが常時使用可能ではない場合は、静的プロパティ <xref:System.DateTime.UtcNow%2A> を使用して、現在の時刻を <xref:System.DateTime> オブジェクトとして取得します   \(<xref:System.Printing.PrintQueue.StartTimeOfDay%2A> および <xref:System.Printing.PrintQueue.UntilTimeOfDay%2A> プロパティ自体が UTC 時間なのでローカル時刻は必要ありません\)。  
+  
+ ただし、この 2 つのプロパティは <xref:System.DateTime> オブジェクトではありません。  これらは、時刻を UTC の午前 0 時からの経過時間 \(分\) として表す <xref:System.Int32> です。  したがって、<xref:System.DateTime> オブジェクトを、午前 0 時からの経過時間 \(分\) に変換する必要があります。  その後で、現在の時刻 \(now\) がキューの開始時刻 \(start\) と終了時刻 \(until\) の間であるかどうかを調べ、現在の時刻が 2 つの時刻の間ではない場合は、センティネル変数を false に設定して返します。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#PrintQueueStartUntil](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#printqueuestartuntil)]
+ [!code-csharp[DiagnoseProblematicPrintJob#PrintQueueStartUntil](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#printqueuestartuntil)]
+ [!code-vb[DiagnoseProblematicPrintJob#PrintQueueStartUntil](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#printqueuestartuntil)]  
+  
+ **TimeConverter.ConvertToLocalHumanReadableTime** メソッド \(後のコード例に示します\) では、[!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] で導入されたメソッドを使用していないので、詳しい説明は省略します。  このメソッドは、二重の変換を行います。午前 0 時からの経過時間 \(分\) 表す整数を受け取って、人間可読な時刻に変換し、この時刻をローカル時刻に変換する必要があります。  このことを実現するために、最初に UTC 午前 0 時に設定された <xref:System.DateTime> オブジェクトを作成し、<xref:System.DateTime.AddMinutes%2A> メソッドを使用して、メソッドに渡された午前 0 時からの経過時間 \(分\) を加算します。  このメソッドからは、渡された元の時刻を表す新しい <xref:System.DateTime> が返されます。  次に、<xref:System.DateTime.ToLocalTime%2A> メソッドを使用してこの時刻をローカル時刻に変換します。  
+  
+ [!code-cpp[DiagnoseProblematicPrintJob#TimeConverter](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CPP/Program.cpp#timeconverter)]
+ [!code-csharp[DiagnoseProblematicPrintJob#TimeConverter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/CSharp/Program.cs#timeconverter)]
+ [!code-vb[DiagnoseProblematicPrintJob#TimeConverter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DiagnoseProblematicPrintJob/visualbasic/program.vb#timeconverter)]  
+  
+## 参照  
+ <xref:System.DateTime>   
+ <xref:System.Printing.PrintSystemJobInfo>   
+ <xref:System.Printing.PrintQueue>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-drag-and-drop-ink.md b/docs/framework/wpf/advanced/how-to-drag-and-drop-ink.md
new file mode 100644
index 00000000000..54f4f9ea2e3
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-drag-and-drop-ink.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : インクをドラッグ アンド ドロップする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ (インクを)"
+  - "ドラッグ (インクを)"
+  - "ドロップ (インクを)"
+  - "インク, ドラッグ アンド ドロップ"
+  - "インク, ドラッグ"
+  - "インク, ドロップ"
+ms.assetid: 932dc410-2bf3-4486-ab31-13487ba59f60
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : インクをドラッグ アンド ドロップする
+## 使用例  
+ 選択したストロークを異なる <xref:System.Windows.Controls.InkCanvas> の間でドラッグできるアプリケーションを作成する例を次に示します。  
+  
+ [!code-xml[InkDragDrop#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkDragDrop/CSharp/Window1.xaml#1)]  
+  
+ [!code-csharp[InkDragDrop#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InkDragDrop/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[InkDragDrop#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InkDragDrop/VisualBasic/Window1.xaml.vb#2)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-draw-text-to-a-control-background.md b/docs/framework/wpf/advanced/how-to-draw-text-to-a-control-background.md
new file mode 100644
index 00000000000..23ab55e4468
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-draw-text-to-a-control-background.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : コントロールの背景にテキストを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "背景, 描画 (テキストを)"
+  - "コントロール, 描画 (背景にテキストを)"
+  - "描画, コントロールの背景に対するテキスト"
+  - "テキスト, 描画 (コントロールの背景に)"
+  - "タイポグラフィ, 描画 (コントロールの背景にテキストを)"
+ms.assetid: 686d8fba-f61c-4974-a871-c635d67a7f69
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : コントロールの背景にテキストを描画する
+テキスト文字列を <xref:System.Windows.Media.FormattedText> オブジェクトに変換し、そのオブジェクトをコントロールの <xref:System.Windows.Media.DrawingContext> に描画することにより、コントロールの背景にテキストを直接描画できます。  この手法は、<xref:System.Windows.Controls.Canvas> や <xref:System.Windows.Controls.StackPanel> などの <xref:System.Windows.Controls.Panel> から派生したオブジェクトの背景への描画にも使用できます。  
+  
+ ![テキストを背景として表示するコントロール](../../../../docs/framework/wpf/advanced/media/drawtext2background01.png "DrawText2Background01")  
+カスタム テキスト背景のコントロールの例  
+  
+## 使用例  
+ コントロールの背景に描画するには、新しい <xref:System.Windows.Media.DrawingBrush> オブジェクトを作成して、変換したテキストをオブジェクトの <xref:System.Windows.Media.DrawingContext> に描画します。  次に、新しい <xref:System.Windows.Media.DrawingBrush> をコントロールの Background プロパティに割り当てます。  
+  
+ <xref:System.Windows.Media.FormattedText> オブジェクトを作成し、<xref:System.Windows.Controls.Label> オブジェクトと <xref:System.Windows.Controls.Button> オブジェクトの背景に描画する方法を次のコード例に示します。  
+  
+ [!code-csharp[DrawTextToControlBackground#DrawTextToControlBackground1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawTextToControlBackground/CSHARP/Window1.xaml.cs#drawtexttocontrolbackground1)]  
+  
+## 参照  
+ <xref:System.Windows.Media.FormattedText>   
+ [書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-draw-text-to-a-visual.md b/docs/framework/wpf/advanced/how-to-draw-text-to-a-visual.md
new file mode 100644
index 00000000000..80176eaa6ad
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-draw-text-to-a-visual.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : ビジュアルにテキストを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "描画, テキストをビジュアルに"
+  - "テキスト, 描画 (ビジュアルに)"
+  - "タイポグラフィ, 描画 (テキストをビジュアルに)"
+  - "ビジュアル, 描画 (テキストを)"
+ms.assetid: fee4003c-e8a6-46ec-babd-2c7f4231a101
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ビジュアルにテキストを描画する
+<xref:System.Windows.Media.DrawingContext> オブジェクトを使用して <xref:System.Windows.Media.DrawingVisual> にテキストを描画する方法を次の例に示します。  描画コンテキストは、<xref:System.Windows.Media.DrawingVisual> オブジェクトの <xref:System.Windows.Media.DrawingVisual.RenderOpen%2A> メソッドを呼び出すことによって返されます。  描画コンテキストにグラフィックスとテキストを描画することができます。  
+  
+ 描画コンテキストにテキストを描画するには、<xref:System.Windows.Media.DrawingContext> オブジェクトの <xref:System.Windows.Media.DrawingContext.DrawText%2A> メソッドを使用します。  描画コンテキストへのコンテンツの描画が完了したら、<xref:System.Windows.Media.DrawingContext.Close%2A> メソッドを呼び出して描画コンテキストを閉じ、コンテンツを保持します。  
+  
+## 使用例  
+ [!code-csharp[DrawingVisualSample#110](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#110)]
+ [!code-vb[DrawingVisualSample#110](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#110)]  
+  
+> [!NOTE]
+>  前のコード例を含むコード サンプル全体については、[DrawingVisual を使用したヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159994)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-enable-a-command.md b/docs/framework/wpf/advanced/how-to-enable-a-command.md
new file mode 100644
index 00000000000..e112e087fec
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-enable-a-command.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : コマンドを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CommandBindings"
+  - "コマンド実行"
+ms.assetid: d8016266-58d9-48f7-8298-a86b7ed49fbd
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : コマンドを有効にする
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でコマンド実行を使用する方法を次の例に示します。  この例では、<xref:System.Windows.Input.RoutedCommand> を <xref:System.Windows.Controls.Button> に関連付け、<xref:System.Windows.Input.CommandBinding> を作成して、<xref:System.Windows.Input.RoutedCommand> を実装するイベント ハンドラーを作成する方法を示しています。  コマンド実行の詳細については、「[コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)」を参照してください。  
+  
+## 使用例  
+ コードの最初のセクションでは、<xref:System.Windows.Controls.Button> と <xref:System.Windows.Controls.StackPanel> から構成される[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成し、コマンド ハンドラーと <xref:System.Windows.Input.RoutedCommand> を関連付ける <xref:System.Windows.Input.CommandBinding> を作成しています。  
+  
+ <xref:System.Windows.Controls.Button> の <xref:System.Windows.Input.ICommandSource.Command%2A> プロパティは、<xref:System.Windows.Input.ApplicationCommands.Close%2A> コマンドに関連付けられています。  
+  
+ <xref:System.Windows.Input.CommandBinding> は、ルート <xref:System.Windows.Window> の <xref:System.Windows.Input.CommandBindingCollection> に追加されます。  <xref:System.Windows.Input.CommandBinding.Executed> および <xref:System.Windows.Input.CommandBinding.CanExecute> イベント ハンドラーは、このバインディングに結び付けられ、<xref:System.Windows.Input.ApplicationCommands.Close%2A> コマンドに関連付けられます。  
+  
+ <xref:System.Windows.Input.CommandBinding> を使用しない場合、コマンド ロジックは実装されず、コマンドを呼び出す機構だけが実行されます。  <xref:System.Windows.Controls.Button> がクリックされると、コマンドの対象で <xref:System.Windows.Input.CommandManager.PreviewExecuted> <xref:System.Windows.RoutedEvent> が発生し、続いて <xref:System.Windows.Input.CommandManager.Executed> <xref:System.Windows.RoutedEvent> が発生します。  これらのイベントは、その特定のコマンドの <xref:System.Windows.Input.CommandBinding> を要素ツリー内で検索します。  <xref:System.Windows.RoutedEvent> は要素ツリー内をトンネリングおよびバブリングするため、<xref:System.Windows.Input.CommandBinding> を配置する場所には注意が必要です。  <xref:System.Windows.Input.CommandBinding> をコマンドの対象の兄弟、または <xref:System.Windows.RoutedEvent> のルート上にない他のノードに配置すると、<xref:System.Windows.Input.CommandBinding> にはアクセスできません。  
+  
+ [!code-xml[EnableCloseCommand#CloseCommandBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EnableCloseCommand/CSharp/Window1.xaml#closecommandbinding)]  
+  
+ [!code-csharp[EnableCloseCommand#CloseCommandBindingCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EnableCloseCommand/CSharp/Window1.xaml.cs#closecommandbindingcodebehind)]
+ [!code-vb[EnableCloseCommand#CloseCommandBindingCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EnableCloseCommand/VisualBasic/Window1.xaml.vb#closecommandbindingcodebehind)]  
+  
+ コードの次のセクションでは、<xref:System.Windows.Input.CommandManager.Executed> および <xref:System.Windows.Input.CommandBinding.CanExecute> イベント ハンドラーを実装しています。  
+  
+ <xref:System.Windows.Input.CommandManager.Executed> ハンドラーは、開いているファイルを閉じるメソッドを呼び出します。  <xref:System.Windows.Input.CommandBinding.CanExecute> ハンドラーは、ファイルが開いているかどうかを判別するメソッドを呼び出します。  ファイルが開いている場合、<xref:System.Windows.Input.CanExecuteRoutedEventArgs.CanExecute%2A> は `true` に設定されます。それ以外の場合は `false` に設定されます。  
+  
+ [!code-csharp[EnableCloseCommand#CloseCommandHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EnableCloseCommand/CSharp/Window1.xaml.cs#closecommandhandler)]
+ [!code-vb[EnableCloseCommand#CloseCommandHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EnableCloseCommand/VisualBasic/Window1.xaml.vb#closecommandhandler)]  
+  
+## 参照  
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-enable-text-trimming.md b/docs/framework/wpf/advanced/how-to-enable-text-trimming.md
new file mode 100644
index 00000000000..9882419b25e
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-enable-text-trimming.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : テキストのトリミングを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, トリミング (テキストを)"
+  - "テキスト, トリム"
+  - "トリミング (テキストを)"
+ms.assetid: dd8c9191-d2be-45fd-9fb4-3c75b65578c5
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : テキストのトリミングを有効にする
+この例では、<xref:System.Windows.TextTrimming> 列挙体で使用可能な値の使用方法と効果を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Controls.TextBlock.TextTrimming%2A> 属性セットを使用して <xref:System.Windows.Controls.TextBlock> 要素を定義します。  
+  
+ [!code-xml[TextTrimmingSnippets#_TextTrimmingXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTrimmingSnippets/CSharp/Window1.xaml#_texttrimmingxaml)]  
+  
+## 使用例  
+ 次の例では、対応する <xref:System.Windows.TextTrimming> プロパティをコード内で設定します。  
+  
+ [!code-csharp[TextTrimmingSnippets#_TextTrimmingSetTextTrimming](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextTrimmingSnippets/CSharp/Window1.xaml.cs#_texttrimmingsettexttrimming)]
+ [!code-vb[TextTrimmingSnippets#_TextTrimmingSetTextTrimming](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextTrimmingSnippets/VisualBasic/Window1.xaml.vb#_texttrimmingsettexttrimming)]  
+  
+ 現在、テキストのトリミングでは、**CharacterEllipsis**、**WordEllipsis**、および **None** の 3 つのオプションを使用できます。  
+  
+ <xref:System.Windows.Controls.TextBlock.TextTrimming%2A> を **CharacterEllipsis** に設定した場合、テキストが切り取られ、トリミング エッジに最も近い文字の位置に省略記号が挿入されます。  この設定では、トリミング境界により近い位置でテキストが切り取られます。ただし、単語の一部が切り取られる可能性があります。  次の図は、上記で定義したものと同様の <xref:System.Windows.Controls.TextBlock> にこの設定を適用した場合の効果を示しています。  
+  
+ ![例: TextTrimming.CharacterEllipsis](../../../../docs/framework/wpf/advanced/media/texttrimming-character.png "TextTrimming\_Character")  
+  
+ <xref:System.Windows.Controls.TextBlock.TextTrimming%2A> を **WordEllipsis** に設定した場合、テキストが切り取られ、トリミング エッジに最も近い位置にある最初の完全な単語の後に省略記号が挿入されます。  この設定では、部分的に切り取られた単語は表示されません。ただし、**CharacterEllipsis** 設定よりもトリミング エッジから離れた位置でテキストが切り取られます。  次の図は、上記で定義した <xref:System.Windows.Controls.TextBlock> にこの設定を適用した場合の効果を示しています。  
+  
+ ![例 : TextTrimming.WordEllipsis](../../../../docs/framework/wpf/advanced/media/texttrimming-word.png "TextTrimming\_Word")  
+  
+ <xref:System.Windows.Controls.TextBlock.TextTrimming%2A> を **None** に設定した場合、テキストのトリミングは実行されません。  この場合、テキストは親テキスト コンテナーの境界にトリミングされるだけです。  次の図は、上記で定義したものと同様の <xref:System.Windows.Controls.TextBlock> にこの設定を適用した場合の効果を示しています。  
+  
+ ![例 : TextTrimming.None](../../../../docs/framework/wpf/advanced/media/texttrimming-none.png "TextTrimming\_None")
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md b/docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md
new file mode 100644
index 00000000000..e461710e8b1
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ハイブリッド アプリケーション [WPF 相互運用性]"
+  - "視覚スタイル [Windows フォーム]"
+ms.assetid: 95de9b9c-d804-405c-b2d1-49a88c1e0fe1
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションでホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールで [!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] の視覚スタイルを有効にする方法を示します。  
+  
+ アプリケーションが <xref:System.Windows.Forms.Application.EnableVisualStyles%2A> メソッドを呼び出すと、ほとんどの [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、アプリケーションが [!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] で実行されるときの視覚スタイルを自動的に使用します。  詳細については、「[visual スタイルが使用されているコントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)」を参照してください。  
+  
+ このトピックで示すタスクの完全なコード一覧については、[ハイブリッド アプリケーションでの視覚スタイルの有効化のサンプル](http://go.microsoft.com/fwlink/?LinkID=159986)を参照してください。  
+  
+## Windows フォーム視覚スタイルの有効化  
+  
+#### Windows フォーム視覚スタイルを有効にするには  
+  
+1.  `HostingWfWithVisualStyles` という名前の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション プロジェクトを作成します。  
+  
+2.  ソリューション エクスプローラーで、次のアセンブリへの参照を追加します。  
+  
+    -   WindowsFormsIntegration  
+  
+    -   System.Windows.Forms  
+  
+3.  ツールボックスで、<xref:System.Windows.Controls.Grid> アイコンをダブルクリックして、<xref:System.Windows.Controls.Grid> 要素をデザイン サーフェイスに配置します。  
+  
+4.  \[プロパティ\] ウィンドウで、<xref:System.Windows.FrameworkElement.Height%2A> プロパティと <xref:System.Windows.FrameworkElement.Width%2A> プロパティの値を **Auto** に設定します。  
+  
+5.  デザイン ビューまたは XAML で、<xref:System.Windows.Window> を選択します。  
+  
+6.  プロパティ ウィンドウの **\[イベント\]** タブをクリックします。  
+  
+7.  <xref:System.Windows.FrameworkElement.Loaded> イベントをダブルクリックします。  
+  
+8.  MainWindow.xaml.vb または MainWindow.xaml.cs で、<xref:System.Windows.FrameworkElement.Loaded> イベントを処理する次のコードを挿入します。  
+  
+     [!code-csharp[HostingWfWithVisualStyles#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWfWithVisualStyles/CSharp/HostingWfWithVisualStyles/Window1.xaml.cs#11)]
+     [!code-vb[HostingWfWithVisualStyles#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HostingWfWithVisualStyles/VisualBasic/HostingWfWithVisualStyles/Window1.xaml.vb#11)]  
+  
+9. F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+     [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが、視覚スタイルで塗りつぶされます。  
+  
+## Windows フォーム視覚スタイルの無効化  
+ 視覚スタイルを無効にするには、<xref:System.Windows.Forms.Application.EnableVisualStyles%2A> メソッドの呼び出しを削除します。  
+  
+#### Windows フォーム視覚スタイルを無効にするには  
+  
+1.  コード エディターで MainWindow.xaml.vb または MainWindow.xaml.cs を開きます。  
+  
+2.  <xref:System.Windows.Forms.Application.EnableVisualStyles%2A> メソッドの呼び出しをコメント化します。  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+     [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが既定のシステム スタイルで塗りつぶされます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Application.EnableVisualStyles%2A>   
+ <xref:System.Windows.Forms.VisualStyles>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [visual スタイルが使用されているコントロールのレンダリング](../../../../docs/framework/winforms/controls/rendering-controls-with-visual-styles.md)   
+ [チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-enumerate-a-subset-of-print-queues.md b/docs/framework/wpf/advanced/how-to-enumerate-a-subset-of-print-queues.md
new file mode 100644
index 00000000000..553e42e904c
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-enumerate-a-subset-of-print-queues.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : 印刷キューのサブセットを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙, 印刷キューのサブセット"
+  - "印刷キュー, 列挙 (サブセットを)"
+ms.assetid: cc4a1b5b-d46f-4c5e-bc26-22c226e4bee0
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 印刷キューのサブセットを列挙する
+企業全体のプリンターを管理する情報テクノロジ \(IT\) 専門家は、特定の特性を持つプリンターのリストを生成しなければならない状況に直面することがしばしばあります。  この機能は、<xref:System.Printing.PrintServer> オブジェクトの <xref:System.Printing.PrintServer.GetPrintQueues%2A> メソッドと、<xref:System.Printing.EnumeratedPrintQueueTypes> 列挙体によって提供されます。  
+  
+## 使用例  
+ 次の例のコードでは、まず最初に、リストする印刷キューの特性を指定するフラグの配列を作成しています。  この例では、プリント サーバーにローカルにインストールされ、共有されている印刷キューを検索しています。  <xref:System.Printing.EnumeratedPrintQueueTypes> 列挙体には、他にもさまざまな使用方法があります。  
+  
+ 次にこのコードでは、<xref:System.Printing.PrintServer> の派生クラスである <xref:System.Printing.LocalPrintServer> オブジェクトを作成しています。  ローカル プリント サーバーは、このアプリケーションを実行中のコンピューターです。  
+  
+ 最後の重要な手順は、配列を <xref:System.Printing.PrintServer.GetPrintQueues%2A> メソッドに渡すことです。  
+  
+ 最後に、結果をユーザーに表示します。  
+  
+ [!code-cpp[EnumerateSubsetOfPrintQueues#ListSubsetOfPrintQueues](../../../../samples/snippets/cpp/VS_Snippets_Wpf/EnumerateSubsetOfPrintQueues/CPP/Program.cpp#listsubsetofprintqueues)]
+ [!code-csharp[EnumerateSubsetOfPrintQueues#ListSubsetOfPrintQueues](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EnumerateSubsetOfPrintQueues/CSharp/Program.cs#listsubsetofprintqueues)]
+ [!code-vb[EnumerateSubsetOfPrintQueues#ListSubsetOfPrintQueues](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EnumerateSubsetOfPrintQueues/visualbasic/program.vb#listsubsetofprintqueues)]  
+  
+ この例は、各印刷キューをステップ スルーしてさらに絞り込む `foreach` ループを追加することにより拡張できます。  たとえば、このループで各印刷キューの <xref:System.Printing.PrintQueue.GetPrintCapabilities%2A> メソッドを呼び出し、戻り値を検査して両面印刷のサポートの有無を調べることで、両面印刷をサポートしないプリンターを除外することができます。  
+  
+## 参照  
+ <xref:System.Printing.PrintServer.GetPrintQueues%2A>   
+ <xref:System.Printing.PrintServer>   
+ <xref:System.Printing.LocalPrintServer>   
+ <xref:System.Printing.EnumeratedPrintQueueTypes>   
+ <xref:System.Printing.PrintQueue>   
+ <xref:System.Printing.PrintQueue.GetPrintCapabilities%2A>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [Microsoft XPS Document Writer \(Microsoft XPS ドキュメント ライター\)](http://go.microsoft.com/fwlink/?LinkId=147319)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-enumerate-system-fonts.md b/docs/framework/wpf/advanced/how-to-enumerate-system-fonts.md
new file mode 100644
index 00000000000..32e7cca57d8
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-enumerate-system-fonts.md
@@ -0,0 +1,31 @@
+---
+title: "方法 : システム フォントを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙, システム フォント"
+  - "フォント, 列挙"
+  - "システム フォント, 列挙"
+  - "タイポグラフィ, 列挙 (システム フォントを)"
+ms.assetid: 36e37791-55b9-4f01-a496-5cc10335e6a6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : システム フォントを列挙する
+## 使用例  
+ 次の例では、システム フォント コレクション内のフォントを列挙する方法を示しています。  <xref:System.Windows.Media.Fonts.SystemFontFamilies%2A> 内の各 <xref:System.Windows.Media.FontFamily> のフォント ファミリ名は、コンボ ボックスに項目として追加されます。  
+  
+ [!code-csharp[TextOverview#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextOverview/CSharp/Window1.xaml.cs#100)]
+ [!code-vb[TextOverview#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextOverview/visualbasic/window1.xaml.vb#100)]  
+  
+ 同じフォント ファミリの複数のバージョンが同じディレクトリに存在する場合、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のフォント列挙体は、そのフォントの最新のバージョンを返します。  バージョン情報で解決できない場合は、タイムスタンプが最新のフォントが返されます。  タイムスタンプ情報が同じである場合は、アルファベット順で最初のフォント ファイルが返されます。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-erase-ink-on-a-custom-control.md b/docs/framework/wpf/advanced/how-to-erase-ink-on-a-custom-control.md
new file mode 100644
index 00000000000..8fc83e0fc64
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-erase-ink-on-a-custom-control.md
@@ -0,0 +1,29 @@
+---
+title: "方法 : カスタム コントロールでインクを消去する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム コントロール, 消去 (インクを)"
+  - "インク, 消去 (カスタム コントロールで)"
+ms.assetid: d88c50f9-b4d8-4962-a28b-67d6a15a5fe0
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : カスタム コントロールでインクを消去する
+<xref:System.Windows.Ink.IncrementalStrokeHitTester> は、現在描画されているストロークが他のストロークと交差しているかどうかを判別します。  これは、ユーザーがストロークの一部を消去する際に使用するコントロールの作成に役立ちます。ユーザーがこの消去処理を <xref:System.Windows.Controls.InkCanvas> で行うには、<xref:System.Windows.Controls.InkCanvas.EditingMode%2A> を <xref:System.Windows.Controls.InkCanvasEditingMode> に設定する必要があります。  
+  
+## 使用例  
+ ユーザーがストロークの一部を消去する際に使用するカスタム コントロールの作成例を次に示します。  この例では、初期化時にインクを含むコントロールを作成します。  インクを収集するコントロールの作成方法については、「[インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)」を参照してください。  
+  
+ [!code-csharp[HowToEraseInk#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToEraseInk/CSharp/InkEraser.cs#1)]
+ [!code-vb[HowToEraseInk#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToEraseInk/VisualBasic/InkEraser.vb#1)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-find-an-element-by-its-name.md b/docs/framework/wpf/advanced/how-to-find-an-element-by-its-name.md
new file mode 100644
index 00000000000..484ffd39816
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-find-an-element-by-its-name.md
@@ -0,0 +1,29 @@
+---
+title: "方法 : 要素を名前で検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "要素, 検索 (名前で)"
+  - "FindName メソッド"
+ms.assetid: cfa7cf35-8aa2-4060-9454-872ed4af3f0e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 要素を名前で検索する
+<xref:System.Windows.FrameworkElement.FindName%2A> メソッドを使用して要素をその <xref:System.Windows.FrameworkElement.Name%2A> 値で検索する方法を次の例に示します。  
+  
+## 使用例  
+ この例では、特定の要素をその名前で検索するメソッドを、ボタンのイベント ハンドラーとして作成しています。  `stackPanel` は、検索対象のルート <xref:System.Windows.FrameworkElement> の <xref:System.Windows.FrameworkElement.Name%2A> で、この例のメソッドは、見つかった要素を <xref:System.Windows.Controls.TextBlock> としてキャストし、<xref:System.Windows.Controls.TextBlock> で表示可能な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] プロパティの 1 つを変更することで、視覚的に示します。  
+  
+ [!code-csharp[FEFindName#Find](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEFindName/CSharp/default.xaml.cs#find)]
+ [!code-vb[FEFindName#Find](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FEFindName/VisualBasic/default.xaml.vb#find)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-find-the-source-element-in-an-event-handler.md b/docs/framework/wpf/advanced/how-to-find-the-source-element-in-an-event-handler.md
new file mode 100644
index 00000000000..c1a06ef0e10
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-find-the-source-element-in-an-event-handler.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : イベント ハンドラーでソース要素を検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ハンドラー, 検索 (ソース要素を)"
+  - "ソース要素 (イベント ハンドラー内の)"
+ms.assetid: 85f71c5a-b714-4c65-9711-7d905c2bbe98
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : イベント ハンドラーでソース要素を検索する
+この例では、イベント ハンドラーの中でソース要素を見つける方法を示します。  
+  
+## 使用例  
+ 次の例に示す、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーは、分離コード ファイルの中で宣言されているものです。  ハンドラーが結び付けられているボタンをユーザーがクリックすると、ハンドラーによってプロパティ値が変更されます。  ハンドラー コードは、イベント引数として報告されたルーティング イベント データの <xref:System.Windows.RoutedEventArgs.Source%2A> プロパティを使用して、<xref:System.Windows.RoutedEventArgs.Source%2A> 要素の <xref:System.Windows.FrameworkElement.Width%2A> プロパティの値を変更します。  
+  
+ [!code-xml[RoutedEventSource#XAMLHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventSource/CSharp/default.xaml#xamlhandler)]  
+  
+ [!code-csharp[RoutedEventSource#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventSource/CSharp/default.xaml.cs#handler)]
+ [!code-vb[RoutedEventSource#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RoutedEventSource/VisualBasic/default.xaml.vb#handler)]  
+  
+## 参照  
+ <xref:System.Windows.RoutedEventArgs>   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/events-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-flip-a-uielement-horizontally-or-vertically.md b/docs/framework/wpf/advanced/how-to-flip-a-uielement-horizontally-or-vertically.md
new file mode 100644
index 00000000000..624d7bc1582
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-flip-a-uielement-horizontally-or-vertically.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : UIElement を左右または上下に反転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "回転 (UIElements を)"
+  - "UIElements, 回転"
+ms.assetid: 02c6730f-65c0-40d5-a553-4cb663721882
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : UIElement を左右または上下に反転させる
+この例では、<xref:System.Windows.Media.ScaleTransform> を使用して <xref:System.Windows.UIElement> を左右または上下に反転させる方法について説明します。  この例では、<xref:System.Windows.Controls.Button> コントロール \(<xref:System.Windows.UIElement> 型\) を、その <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.ScaleTransform> を適用することによって反転します。  
+  
+## 使用例  
+ 次の図は、反転する対象のボタンを示しています。  
+  
+ ![変換のないボタン](../../../../docs/framework/wpf/advanced/media/graphicsmm-buttonflipbeforeflip.png "graphicsmm\_buttonflipbeforeflip")  
+反転対象の UIElement  
+  
+ ボタンを作成するコードを次に示します。  
+  
+ [!code-xml[Transforms_snip#GraphicsMMButtonWithoutFlip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/FlipExample.xaml#graphicsmmbuttonwithoutflip)]  
+  
+## 使用例  
+ ボタンを左右に反転するには、<xref:System.Windows.Media.ScaleTransform> を作成し、その <xref:System.Windows.Media.ScaleTransform.ScaleX%2A> プロパティに \-1 を設定します。  この <xref:System.Windows.Media.ScaleTransform> をボタンの <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用します。  
+  
+ [!code-xml[Transforms_snip#GraphicsMMFlipButtonExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/FlipExample.xaml#graphicsmmflipbuttonexample1)]  
+  
+ ![&#40;0,0&#41; の周りで水平方向に反転されるボタン](../../../../docs/framework/wpf/advanced/media/graphicsmm-buttonfliphorizontalflip-displaced.png "graphicsmm\_buttonfliphorizontalflip\_displaced")  
+ScaleTransform を適用した後のボタン  
+  
+## 使用例  
+ 上の図を見るとわかるように、ボタンは反転しただけでなく、位置も変わりました。  これは、ボタンをその左上隅を中心に反転させたためです。  ボタンをその場で反転させるには、ボタンの隅ではなく中心に <xref:System.Windows.Media.ScaleTransform> を適用する必要があります。  <xref:System.Windows.Media.ScaleTransform> をボタンの中心に適用する簡単な方法は、ボタンの <xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティを 0.5, 0.5 に設定することです。  
+  
+ [!code-xml[Transforms_snip#GraphicsMMFlipButtonExample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/FlipExample.xaml#graphicsmmflipbuttonexample2)]  
+  
+ ![中心の周りで水平方向に反転されるボタン](../../../../docs/framework/wpf/advanced/media/graphicsmm-buttonfliphorizontalflip-inplace.png "graphicsmm\_buttonfliphorizontalflip\_inplace")  
+RenderTransformOrigin を 0.5, 0.5 に設定したボタン  
+  
+## 使用例  
+ ボタンを上下に反転するには、<xref:System.Windows.Media.ScaleTransform> オブジェクトの <xref:System.Windows.Media.ScaleTransform.ScaleX%2A> プロパティではなく <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> プロパティを設定します。  
+  
+ [!code-xml[Transforms_snip#GraphicsMMVerticalFlipButtonExample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/FlipExample.xaml#graphicsmmverticalflipbuttonexample2)]  
+  
+ ![中心の周りで垂直方向に反転されるボタン](../../../../docs/framework/wpf/advanced/media/graphicsmm-buttonflipverticalflip-inplace.png "graphicsmm\_buttonflipverticalflip\_inplace")  
+上下に反転させたボタン  
+  
+## 参照  
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-get-print-system-object-properties-without-reflection.md b/docs/framework/wpf/advanced/how-to-get-print-system-object-properties-without-reflection.md
new file mode 100644
index 00000000000..74a06836a8c
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-get-print-system-object-properties-without-reflection.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : リフレクションを使用せずに印刷システム オブジェクトのプロパティを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PrintSystemObject, 取得 (プロパティを)"
+ms.assetid: 43560f28-183d-41c1-b9d1-de7c2552273e
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : リフレクションを使用せずに印刷システム オブジェクトのプロパティを取得する
+リフレクションを使用してオブジェクトのプロパティ \(およびプロパティの型\) を取得すると、アプリケーションのパフォーマンスが低下する可能性があります。  <xref:System.Printing.IndexedProperties> 名前空間には、リフレクションを使用せずにこの情報を取得するための手段が用意されています。  
+  
+## 使用例  
+ 実行手順は次のとおりです。  
+  
+1.  型のインスタンスを作成します。  次の例では、型は [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] で提供されている <xref:System.Printing.PrintQueue> 型ですが、<xref:System.Printing.PrintSystemObject> から派生した型に対しても、ほぼ同じコードを使用できます。  
+  
+2.  型の <xref:System.Printing.PrintSystemObject.PropertiesCollection%2A> から <xref:System.Printing.IndexedProperties.PrintPropertyDictionary> を作成します。  このディクショナリの各エントリの <xref:System.Collections.DictionaryEntry.Value%2A> プロパティは、<xref:System.Printing.IndexedProperties.PrintProperty> から派生した型の 1 つのオブジェクトです。  
+  
+3.  ディクショナリのメンバーを列挙します。  各メンバーに対し、以下を行います。  
+  
+4.  各エントリの値を <xref:System.Printing.IndexedProperties.PrintProperty> にアップキャストし、それを使用して <xref:System.Printing.IndexedProperties.PrintProperty> オブジェクトを作成します。  
+  
+5.  各 <xref:System.Printing.IndexedProperties.PrintProperty> オブジェクトの <xref:System.Printing.IndexedProperties.PrintProperty.Value%2A> の型を取得します。  
+  
+ [!code-csharp[GetPrintObjectPropertyTypesWithoutReflection#ShowPropertyTypesWithoutReflection](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GetPrintObjectPropertyTypesWithoutReflection/CSharp/Program.cs#showpropertytypeswithoutreflection)]
+ [!code-vb[GetPrintObjectPropertyTypesWithoutReflection#ShowPropertyTypesWithoutReflection](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GetPrintObjectPropertyTypesWithoutReflection/visualbasic/program.vb#showpropertytypeswithoutreflection)]  
+  
+## 参照  
+ <xref:System.Printing.IndexedProperties.PrintProperty>   
+ <xref:System.Printing.PrintSystemObject>   
+ <xref:System.Printing.IndexedProperties>   
+ <xref:System.Printing.IndexedProperties.PrintPropertyDictionary>   
+ <xref:System.Printing.LocalPrintServer>   
+ <xref:System.Printing.PrintQueue>   
+ <xref:System.Collections.DictionaryEntry>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-handle-a-loaded-event.md b/docs/framework/wpf/advanced/how-to-handle-a-loaded-event.md
new file mode 100644
index 00000000000..380ad9b0bef
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-handle-a-loaded-event.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 読み込まれたイベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント, 読み込み"
+  - "Loaded イベント"
+  - "XAML, Loaded イベント"
+ms.assetid: 0cf8d003-8441-4df4-807a-6db09347e829
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 読み込まれたイベントを処理する
+この例では、<xref:System.Windows.FrameworkElement.Loaded?displayProperty=fullName> イベントを処理する方法と、このイベントの処理に適したシナリオを示します。  ページが読み込まれると、ハンドラーは <xref:System.Windows.Controls.Button> を作成します。  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を分離コード ファイルと共に使用します。  
+  
+ [!code-xml[FELoaded#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FELoaded/CSharp/default.xaml#xaml)]  
+  
+ [!code-csharp[FELoaded#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FELoaded/CSharp/default.xaml.cs#handler)]
+ [!code-vb[FELoaded#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FELoaded/VisualBasic/default.xaml.vb#handler)]  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement>   
+ [オブジェクトの有効期間イベント](../../../../docs/framework/wpf/advanced/object-lifetime-events.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/base-elements-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-handle-a-routed-event.md b/docs/framework/wpf/advanced/how-to-handle-a-routed-event.md
new file mode 100644
index 00000000000..d0c540c86bb
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-handle-a-routed-event.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : ルーティング イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バブル イベント"
+  - "ルーティング イベント, 処理"
+ms.assetid: 157787b4-f469-4047-8777-5b034145f32e
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# 方法 : ルーティング イベントを処理する
+[バブル](GTMT) イベントの動作と、[ルーティング イベント](GTMT) データを処理できるハンドラーを作成する方法を次の例に示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、要素は、[要素ツリー](GTMT)構造体に配置されます。  親要素は、要素ツリー内で最初に子要素が発生させたイベントの処理に参加できます。  これは、[イベント ルーティング](GTMT)により可能です。  
+  
+ ルーティング イベントは通常、[バブル](GTMT)または[トンネル](GTMT)の 2 つのルーティング方法のいずれかに従います。  この例では、[バブル](GTMT) イベントに焦点を当て、<xref:System.Windows.Controls.Primitives.ButtonBase.Click?displayProperty=fullName> イベントを使用してルーティングの動作を示します。  
+  
+ 次の例では、2 つの <xref:System.Windows.Controls.Button> コントロールを作成し、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 属性構文を使用してイベント ハンドラーを共通の親要素 \(この例では <xref:System.Windows.Controls.StackPanel>\) にアタッチします。  この例では、各 <xref:System.Windows.Controls.Button> 子要素の個々のイベント ハンドラーをアタッチするのではなく、属性構文を使用してイベント ハンドラーを <xref:System.Windows.Controls.StackPanel> 親要素にアタッチします。  このイベント処理パターンは、ハンドラーがアタッチされる要素の数を減らすための手法としてイベント ルーティングを使用する方法を示します。  各 <xref:System.Windows.Controls.Button> のすべての[バブル](GTMT) イベントが親要素を通じてルーティングされます。  
+  
+ 親 <xref:System.Windows.Controls.StackPanel> 要素では、属性として指定された <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント名は、<xref:System.Windows.Controls.Button> クラスに名前を付けて部分的に修飾されます。  <xref:System.Windows.Controls.Button> クラスは、そのメンバーの一覧に <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを持つ <xref:System.Windows.Controls.Primitives.ButtonBase> 派生クラスです。  イベント ハンドラーをアタッチするためのこの部分修飾手法が必要になるのは、ルーティング イベント ハンドラーがアタッチされる要素のメンバー一覧に、処理されているイベントが存在しない場合です。  
+  
+ [!code-xml[RoutedEventHandle#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventHandle/CSharp/default.xaml#xaml)]  
+  
+ <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理する例を次に示します。  この例では、イベントを処理する要素とイベントを発生させる要素を報告します。  ユーザーがいずれかのボタンをクリックすると、イベント ハンドラーが実行されます。  
+  
+ [!code-csharp[RoutedEventHandle#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventHandle/CSharp/default.xaml.cs#handler)]
+ [!code-vb[RoutedEventHandle#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RoutedEventHandle/VisualBasic/MainWindow.xaml.vb#handler)]  
+  
+## 参照  
+ <xref:System.Windows.RoutedEvent>   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/events-how-to-topics.md)   
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-handle-the-contextmenuopening-event.md b/docs/framework/wpf/advanced/how-to-handle-the-contextmenuopening-event.md
new file mode 100644
index 00000000000..c67833dff69
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-handle-the-contextmenuopening-event.md
@@ -0,0 +1,69 @@
+---
+title: "方法 : ContextMenuOpening イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ContextMenuOpening イベント"
+ms.assetid: 789652fb-1951-4217-934a-7843e355adf4
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : ContextMenuOpening イベントを処理する
+イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> プロパティを `true` に設定すると、アプリケーション内で <xref:System.Windows.FrameworkElement.ContextMenuOpening> イベントを処理することによって、既存のコンテキスト メニューを表示前に調整したり、表示されないようにしたりすることができます。  一般に、イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定するのは、メニュー全体を新しい <xref:System.Windows.Controls.ContextMenu> オブジェクトに置き換えるために行い、これには操作の取り消しと新しいオープン操作の開始が必要になることがあります。  <xref:System.Windows.FrameworkElement.ContextMenuOpening> イベントのハンドラーを作成する場合、<xref:System.Windows.Controls.ContextMenu> コントロールと、コントロール全般のコンテキスト メニューのオープンと配置に応答するサービスとの間のタイミングの問題について理解している必要があります。  このトピックでは、コンテキスト メニューのさまざまな開き方に対応するコード テクニックを示し、タイミングの問題が関係する状況について説明します。  
+  
+ <xref:System.Windows.FrameworkElement.ContextMenuOpening> イベントの処理には、次のようなシナリオがあります。  
+  
+-   表示前にメニュー項目を調整する。  
+  
+-   表示前にメニュー全体を置き換える。  
+  
+-   既存のどのコンテキスト メニューも表示されないようにする。  
+  
+## 使用例  
+  
+## 表示前にメニュー項目を調整する  
+ 既存のメニュー項目の調整は比較的単純で、最も一般的なシナリオです。  アプリケーションの現在の状態の情報や、コンテキスト メニューの対象となるオブジェクトのプロパティとして取得される特定の状態情報に応じて、コンテキスト メニューのオプションを増減する場合に行います。  
+  
+ 一般的な方法は、まずイベントのソース \(右クリックされた特定のコントロール\) を取得し、そのソースの <xref:System.Windows.FrameworkElement.ContextMenu%2A> プロパティを取得する方法です。  通常、<xref:System.Windows.Controls.ItemsControl.Items%2A> コレクションを調べてコンテキスト メニュー内にどのメニュー項目が既に存在するかを確認し、このコレクションに適切な新しいメニュー項目 <xref:System.Windows.Controls.MenuItem> を追加するか、このコレクションからメニュー項目を削除します。  
+  
+ [!code-csharp[ContextMenuOpeningHandlers#AddItemNoHandle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuOpeningHandlers/CSharp/Pane1.xaml.cs#additemnohandle)]  
+  
+## 表示前にメニュー全体を置き換える  
+ もう 1 つのシナリオは、コンテキスト メニュー全体を置き換える場合です。  もちろん、前の方法を応用して、既存のコンテキスト メニューからすべてのメニュー項目を削除し、新しいメニュー項目を項目 0 から順に追加することもできます。  しかし、コンテキスト メニューのすべての項目を置き換えるよりわかりやすい方法は、新しい <xref:System.Windows.Controls.ContextMenu> を作成してこれに新しい項目を追加してから、コントロールの <xref:System.Windows.FrameworkElement.ContextMenu%2A?displayProperty=fullName> プロパティを、作成した新しい <xref:System.Windows.Controls.ContextMenu> になるように設定することです。  
+  
+ 次のコードは、<xref:System.Windows.Controls.ContextMenu> を置き換える単純なハンドラーのコードです。  このコードで参照しているカスタムの `BuildMenu` メソッドが分離されているのは、複数のサンプル ハンドラーからこれを呼び出すためです。  
+  
+ [!code-csharp[ContextMenuOpeningHandlers#ReplaceNoReopen](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuOpeningHandlers/CSharp/Pane1.xaml.cs#replacenoreopen)]  
+  
+ [!code-csharp[ContextMenuOpeningHandlers#BuildMenu](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuOpeningHandlers/CSharp/Pane1.xaml.cs#buildmenu)]  
+  
+ ただし、この手法を <xref:System.Windows.FrameworkElement.ContextMenuOpening> のハンドラーに適用する場合は、<xref:System.Windows.Controls.ContextMenu> を設定するオブジェクトに既存のコンテキスト メニューが存在しないと、タイミングの問題が発生することがあります。  ユーザーがコントロールを右クリックすると、既存の <xref:System.Windows.Controls.ContextMenu> が空または null の場合も <xref:System.Windows.FrameworkElement.ContextMenuOpening> が発生します。  しかし、このような場合は、ソース要素に設定した新しい <xref:System.Windows.Controls.ContextMenu> の取得が遅れるので、表示に間に合いません。  また、ユーザーがここで再度右クリックすると、今度は新しい <xref:System.Windows.Controls.ContextMenu> が表示され、値は null でなくなり、ハンドラーの 2 回目の実行でメニューが正しく置き換えられて表示されます。  これを回避するには、次の 2 つの方法が考えられます。  
+  
+1.  <xref:System.Windows.FrameworkElement.ContextMenuOpening> ハンドラーが実行されるコントロールには常に <xref:System.Windows.Controls.ContextMenu> のプレースホルダーが少なくとも 1 個存在するようにし、このプレースホルダーをハンドラー コードで置き換えます。  この場合、前の例のハンドラーを使用できますが、通常は、最初のマークアップでプレースホルダー <xref:System.Windows.Controls.ContextMenu> を割り当てる必要があります。  
+  
+     [!code-xml[ContextMenuOpeningHandlers#XAMLWithInitCM](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuOpeningHandlers/CSharp/Pane1.xaml#xamlwithinitcm)]  
+  
+2.  事前のロジックに基づいて、<xref:System.Windows.Controls.ContextMenu> の初期値が null である場合を想定します。  <xref:System.Windows.Controls.ContextMenu> が null であるかを調べることもでき、また、ハンドラーが少なくとも 1 回は実行されているかどうかを示すフラグをコード内で使用するという方法もあります。  <xref:System.Windows.Controls.ContextMenu> が表示されるものと想定した場合、ハンドラーでイベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定します。  コンテキスト メニューの表示に応答する <xref:System.Windows.Controls.ContextMenuService> に対し、イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> の値 `true` は、そのイベントを発生させたコンテキスト メニューおよびコントロールの組み合わせの表示取り消し要求を表します。  
+  
+ これで、問題のありそうなコンテキスト メニューは表示しないようにしたので、次は、新しいコンテキスト メニューを設定してそれを表示します。  新しいコンテキスト メニューの設定は、基本的には前のハンドラーと同じです。新しい <xref:System.Windows.Controls.ContextMenu> を作成し、コントロールのソースの <xref:System.Windows.FrameworkElement.ContextMenu%2A?displayProperty=fullName> プロパティに設定します。  この場合、最初の表示処理を取り消しているので、新しいコンテキスト メニューを強制的に表示する追加手順が必要になります。  強制的に表示するには、ハンドラー内で <xref:System.Windows.Controls.Primitives.Popup.IsOpen%2A?displayProperty=fullName> プロパティを `true` に設定します。  この場合、ハンドラー内でコンテキスト メニューを開くと <xref:System.Windows.FrameworkElement.ContextMenuOpening> イベントが再度発生することになるので、注意が必要です。  ハンドラーに再入すると無限再帰を引き起こします。  <xref:System.Windows.FrameworkElement.ContextMenuOpening> イベント ハンドラー内からコンテキスト メニューを開く場合に必ず、`null` かどうかを調べたり、フラグを使用したりする必要があるのはこのためです。  
+  
+## 既存のどのコンテキスト メニューも表示されないようにする  
+ メニューを一切表示しないようにするハンドラーの作成という最後のシナリオは、一般的ではありません。  あるコントロールでコンテキスト メニューを表示しないようにする場合、ユーザーが要求したときにそのメニューが表示されないようにするよりも他に適切な方法があると考えられます。  それでも、ハンドラーを使用してコンテキスト メニューが一切表示されないようにする場合は、ハンドラーでイベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定するだけでできます。  コンテキスト メニューの表示に応答する <xref:System.Windows.Controls.ContextMenuService> は、コントロールに関して発生したイベントのイベント データを調べます。  いずれかの時点でそのイベントの <xref:System.Windows.RoutedEventArgs.Handled%2A> がオンになっていた場合、そのイベントを発生させたコンテキスト メニューのオープン操作は抑制されます。  
+  
+ [!code-csharp[ContextMenuOpeningHandlers#ReplaceReopen](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenuOpeningHandlers/CSharp/Pane1.xaml.cs#replacereopen)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ContextMenu>   
+ <xref:System.Windows.FrameworkElement.ContextMenu%2A?displayProperty=fullName>   
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)   
+ [ContextMenu の概要](../../../../docs/framework/wpf/controls/contextmenu-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-command-support.md b/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-command-support.md
new file mode 100644
index 00000000000..351722b0de7
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-command-support.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : コマンドをサポートするコントロールにコマンドをフックする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール クラス、RoutedCommand をアタッチします。"
+  - "クラス、コントロール、RoutedCommand をアタッチします。"
+  - "RoutedCommand クラス、コントロールへのアタッチ"
+  - "クラス、RoutedCommand、コントロールへのアタッチ"
+ms.assetid: 8d8592ae-0c91-469e-a1cd-d179c4544548
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : コマンドをサポートするコントロールにコマンドをフックする
+次の例をフックする方法を示しています、 <xref:System.Windows.Input.RoutedCommand>に、<xref:System.Windows.Controls.Control>コマンドのサポートが組み込まれています。  複数のソースにコマンドをフックする完全なサンプルを参照してください、[カスタム RoutedCommand サンプルを作成する](http://go.microsoft.com/fwlink/?LinkID=159980)サンプルです。  
+  
+## <a name="example"></a>例  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]アプリケーション プログラマが定期的に発生する一般的なコマンドのライブラリを提供します。  コマンド ライブラリを構成するクラスは、: <xref:System.Windows.Input.ApplicationCommands>、 <xref:System.Windows.Input.ComponentCommands>、 <xref:System.Windows.Input.NavigationCommands>、 <xref:System.Windows.Input.MediaCommands>、および<xref:System.Windows.Documents.EditingCommands>します。  
+  
+ 静的な<xref:System.Windows.Input.RoutedCommand>コマンド ロジックを指定しないこれらのクラスを構成するオブジェクト。  コマンドのロジックは、コマンドに関連付け、 <xref:System.Windows.Input.CommandBinding>します。  一部のコントロールがいくつかのコマンド用に CommandBindings で構築します。  このメカニズムにより、実際の実装は、同じのままにするためのコマンドのセマンティクスを変更することができます。  A <xref:System.Windows.Controls.TextBox>などを処理、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>コントロールにイメージをサポートするために設計されていますが、何かを貼り付けることの基本的な考え方は同じままよりも、異なるコマンドです。  コマンドのロジックは、コマンドで指定することはできませんではなく、コントロールまたはアプリケーションが提供する必要があります。  
+  
+ 多くのコントロール[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]組み込みコマンド ライブラリ内のコマンドの一部のサポートの操作を行います。  <xref:System.Windows.Controls.TextBox>など多くのアプリケーションの編集コマンドなどをサポート<xref:System.Windows.Input.ApplicationCommands.Paste%2A>、<xref:System.Windows.Input.ApplicationCommands.Copy%2A>、<xref:System.Windows.Input.ApplicationCommands.Cut%2A>、<xref:System.Windows.Input.ApplicationCommands.Redo%2A>、および<xref:System.Windows.Input.ApplicationCommands.Undo%2A>します。  アプリケーション開発者は、これらのコントロールを使用するこれらのコマンドを取得する特別な必要はありません。  場合、 <xref:System.Windows.Controls.TextBox>コマンドの対象を使用して、コマンドが処理するコマンドを実行すると、 <xref:System.Windows.Input.CommandBinding>コントロールに組み込まれているものです。  
+  
+ 使用する方法を次に示します、 <xref:System.Windows.Controls.MenuItem>コマンドのソースとして、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>コマンド、場所、 <xref:System.Windows.Controls.TextBox>コマンドのターゲットであります。  すべてのロジックを定義する方法、 <xref:System.Windows.Controls.TextBox>を実行に貼り付けが組み込まれている、 <xref:System.Windows.Controls.TextBox>コントロールです。  
+  
+ A <xref:System.Windows.Controls.MenuItem>が作成されることで、<xref:System.Windows.Controls.MenuItem.Command%2A>にプロパティが設定されている、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>コマンドです。  <xref:System.Windows.Controls.MenuItem.CommandTarget%2A>に明示的に設定されていない、 <xref:System.Windows.Controls.TextBox>オブジェクトです。  ときに、 <xref:System.Windows.Controls.MenuItem.CommandTarget%2A>が設定されていないターゲット コマンドがキーボード フォーカスのある要素。  キーボード フォーカスを持つ要素がサポートしないかどうか、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>コマンドまたは (クリップボードが空など) に貼り付けコマンドを実行できません現在、 <xref:System.Windows.Controls.MenuItem>要素ができます。  
+  
+ [!code-xml[MenuItemCommandTask_XAML#MenuItemCommanding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuItemCommandTask_XAML/CS/Window1.xaml#menuitemcommanding)]  
+  
+ [!code-csharp[MenuItemCommandTask#MenuItemCommandingCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuItemCommandTask/CSharp/Window1.xaml.cs#menuitemcommandingcodebehind)]
+ [!code-vb[MenuItemCommandTask#MenuItemCommandingCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MenuItemCommandTask/VisualBasic/Window1.xaml.vb#menuitemcommandingcodebehind)]  
+  
+## <a name="see-also"></a>関連項目  
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)   
+ [コマンドをサポートしないコントロールにコマンドをフックします。](../../../../docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-no-command-support.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-no-command-support.md b/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-no-command-support.md
new file mode 100644
index 00000000000..48861ae0396
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-no-command-support.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : コマンドをサポートしないコントロールにコマンドをフックする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, コントロール, 添付 (RoutedCommand を)"
+  - "クラス, RoutedCommand, 添付 (コントロールに)"
+  - "Control クラス, 添付 (RoutedCommand を)"
+  - "RoutedCommand クラス, 添付 (コントロールに)"
+ms.assetid: dad08f64-700b-46fb-ad3f-fbfee95f0dfe
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : コマンドをサポートしないコントロールにコマンドをフックする
+コマンドのサポートが組み込まれていない <xref:System.Windows.Controls.Control> に <xref:System.Windows.Input.RoutedCommand> をフックする方法を次の例に示します。  コマンドを複数のソースにフックするサンプル全体については、[カスタム RoutedCommand の作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159980)を参照してください。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、アプリケーション プログラマがよく使用する一般的なコマンドのライブラリが用意されています。  このコマンド ライブラリには、<xref:System.Windows.Input.ApplicationCommands>、<xref:System.Windows.Input.ComponentCommands>、<xref:System.Windows.Input.NavigationCommands>、<xref:System.Windows.Input.MediaCommands>、および <xref:System.Windows.Documents.EditingCommands> クラスが含まれています。  
+  
+ これらのクラスを構成する静的な <xref:System.Windows.Input.RoutedCommand> オブジェクトには、コマンド ロジックが用意されていません。  コマンドのロジックは、<xref:System.Windows.Input.CommandBinding> でコマンドに関連付けられます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の多くのコントロールには、コマンド ライブリにある一部のコマンドのサポートが組み込まれています。  たとえば、<xref:System.Windows.Controls.TextBox> は、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>、<xref:System.Windows.Input.ApplicationCommands.Copy%2A>、<xref:System.Windows.Input.ApplicationCommands.Cut%2A>、<xref:System.Windows.Input.ApplicationCommands.Redo%2A>、<xref:System.Windows.Input.ApplicationCommands.Undo%2A> などの多くのアプリケーション編集コマンドをサポートしています。  アプリケーション開発者は、コントロールで使用するこれらのコマンドを取得するのに特別な作業を行う必要はありません。  <xref:System.Windows.Controls.TextBox> がコマンド ターゲットである場合は、コマンドを実行すると、コントロールに組み込まれている <xref:System.Windows.Input.CommandBinding> を使用してコマンドを処理します。  
+  
+ <xref:System.Windows.Controls.Button> を <xref:System.Windows.Input.ApplicationCommands.Open%2A> コマンドのコマンド ソースとして使用する方法を次に示します。  指定した <xref:System.Windows.Input.CanExecuteRoutedEventHandler> と、<xref:System.Windows.Input.RoutedCommand> を持つ <xref:System.Windows.Input.CanExecuteRoutedEventHandler> を関連付ける <xref:System.Windows.Input.CommandBinding> を作成します。  
+  
+ 最初に、コマンド ソースを作成します。  コマンド ソースには、<xref:System.Windows.Controls.Button> を使用します。  
+  
+ [!code-xml[commandWithHandler#CommandHandlerCommandSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml#commandhandlercommandsource)]  
+  
+ [!code-csharp[CommandHandlerProcedural#CommandHandlerButtonCommandSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandHandlerProcedural/CSharp/Window1.xaml.cs#commandhandlerbuttoncommandsource)]
+ [!code-vb[CommandHandlerProcedural#CommandHandlerButtonCommandSource](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandHandlerProcedural/visualbasic/window1.xaml.vb#commandhandlerbuttoncommandsource)]  
+  
+ 次に、<xref:System.Windows.Input.ExecutedRoutedEventHandler> および <xref:System.Windows.Input.CanExecuteRoutedEventHandler> を作成します。  <xref:System.Windows.Input.ExecutedRoutedEventHandler> は、コマンドが実行されたことを知らせるために、<xref:System.Windows.MessageBox> を開くだけです。  <xref:System.Windows.Input.CanExecuteRoutedEventHandler> は、<xref:System.Windows.Input.CanExecuteRoutedEventArgs.CanExecute%2A> プロパティを `true` に設定します。  通常、実行可能ハンドラーは、そのコマンドが現在のコマンドの対象で実行可能かどうかについて、より信頼性の高いチェックを実行します。  
+  
+ [!code-csharp[commandWithHandler#CommandHandlerBothHandlers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml.cs#commandhandlerbothhandlers)]
+ [!code-vb[commandWithHandler#CommandHandlerBothHandlers](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/commandWithHandler/VisualBasic/Window1.xaml.vb#commandhandlerbothhandlers)]  
+  
+ 最後に、アプリケーションのルート <xref:System.Windows.Window> で、ルーティング イベント ハンドラーを <xref:System.Windows.Input.ApplicationCommands.Open%2A> コマンドに関連付ける <xref:System.Windows.Input.CommandBinding> を作成します。  
+  
+ [!code-xml[commandWithHandler#CommandHandlerCommandBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/commandWithHandler/CSharp/Window1.xaml#commandhandlercommandbinding)]  
+  
+ [!code-csharp[CommandHandlerProcedural#CommandHandlerBindingInit](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandHandlerProcedural/CSharp/Window1.xaml.cs#commandhandlerbindinginit)]
+ [!code-vb[CommandHandlerProcedural#CommandHandlerBindingInit](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandHandlerProcedural/visualbasic/window1.xaml.vb#commandhandlerbindinginit)]  
+  
+## 参照  
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)   
+ [コマンドをサポートするコントロールにコマンドをフックする](../../../../docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-command-support.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md b/docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md
new file mode 100644
index 00000000000..773499d674b
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : 依存関係プロパティを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係プロパティ, 補足 (プロパティ)"
+  - "プロパティ, 補足 (依存関係プロパティで)"
+ms.assetid: 855fd6d7-19ac-493c-bf5e-2f40b57cdc92
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : 依存関係プロパティを実装する
+この例では、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] のプロパティを <xref:System.Windows.DependencyProperty> フィールドで補足する方法、つまり[依存関係プロパティ](GTMT)を定義する方法を示します。  独自に定義したプロパティが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のさまざまな機能、たとえばスタイル、データ バインディング、継承、アニメーション、既定値をサポートできるようにするには、そのプロパティを[依存関係プロパティ](GTMT)として実装します。  
+  
+## 使用例  
+ 次に示す例では、最初に <xref:System.Windows.DependencyProperty.Register%2A> メソッドを呼び出して[依存関係プロパティ](GTMT)を登録します。  [依存関係プロパティ](GTMT)の名前と特性を格納するときに使用する識別子フィールドの名前は、<xref:System.Windows.DependencyProperty.Register%2A> の呼び出し時に依存関係プロパティに対して選択した <xref:System.Windows.DependencyProperty.Name%2A> でなければなりません。これに、リテラル文字列 `Property` が付加されます。  たとえば、登録する依存関係プロパティの <xref:System.Windows.DependencyProperty.Name%2A> が `Location` ならば、この依存関係プロパティに対して定義する識別子フィールドの名前は `LocationProperty` とする必要があります。  
+  
+ この例では、[依存関係プロパティ](GTMT)とその [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] アクセサーの名前は `State`、識別子フィールドは `StateProperty`、プロパティの型は <xref:System.Boolean>、[依存関係プロパティ](GTMT)を登録する型は `MyStateControl` です。  
+  
+ このパターンに従って名前が付けられていない場合は、定義したプロパティがデザイナーから正しく報告されず、プロパティ システムのスタイル適用の一部が予期したとおりに動作しなくなる可能性があります。  
+  
+ [依存関係プロパティ](GTMT)の既定のメタデータを指定することもできます。  `State` [依存関係プロパティ](GTMT)の既定値を `false` として登録する例を次に示します。  
+  
+ [!code-csharp[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertySystemEsoterics/CSharp/SDKSampleLibrary/class1.cs#mystatecontrol)]
+ [!code-vb[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertySystemEsoterics/visualbasic/sdksamplelibrary/class1.vb#mystatecontrol)]  
+  
+ 単にプライベート フィールドを使用して [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティを補足するのではなく[依存関係プロパティ](GTMT)を実装する理由とその方法の詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+## 参照  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/properties-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-implement-icommandsource.md b/docs/framework/wpf/advanced/how-to-implement-icommandsource.md
new file mode 100644
index 00000000000..b67b4987030
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-implement-icommandsource.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : ICommandSource を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ICommandSource インターフェイス, 実装"
+  - "インターフェイス, ICommandSource, 実装"
+ms.assetid: 7452dd39-6e11-44bf-806a-31d87f3772ac
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ICommandSource を実装する
+この例では、<xref:System.Windows.Input.ICommandSource> を実装してコマンド ソースを作成する方法を示します。  コマンド ソースは、コマンドを呼び出す方法を認識しているオブジェクトです。  <xref:System.Windows.Input.ICommandSource> インターフェイスは、<xref:System.Windows.Input.ICommandSource.Command%2A>、<xref:System.Windows.Input.ICommandSource.CommandParameter%2A>、および <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> の 3 つのメンバーを公開します。  <xref:System.Windows.Input.ICommandSource.Command%2A> は、呼び出されるコマンドです。  <xref:System.Windows.Input.ICommandSource.CommandParameter%2A> は、コマンド ソースからコマンドを処理するメソッドに渡されるユーザー定義のデータ型です。  <xref:System.Windows.Input.ICommandSource.CommandTarget%2A> は、コマンドが実行されているオブジェクトです。  
+  
+ この例では、<xref:System.Windows.Controls.Slider> コントロールをサブクラス化し、<xref:System.Windows.Input.ICommandSource> を実装するクラスが作成されます。  
+  
+## 使用例  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Controls.ListBoxItem> などの <xref:System.Windows.Input.ICommandSource> を実装するさまざまなクラスを提供します。  コマンド ソースは、コマンドを呼び出す方法を定義します。  <xref:System.Windows.Controls.Button> および <xref:System.Windows.Controls.MenuItem> は、クリックされるとコマンドを呼び出します。  <xref:System.Windows.Controls.ListBoxItem> は、ダブルクリックされるとコマンドを呼び出します。  これらのクラスは、<xref:System.Windows.Input.ICommandSource.Command%2A> プロパティが設定されている場合にのみコマンド ソースになります。  
+  
+ この例では、スライダーが移動したときにコマンドを呼び出します。正確には、<xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> プロパティが変更されたときにコマンドを呼び出します。  
+  
+ クラス定義を次に示します。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandSourceClassDefinition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandsourceclassdefinition)]
+ [!code-vb[ImplementICommandSource#ImplementICommandSourceClassDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandsourceclassdefinition)]  
+  
+ 次に、<xref:System.Windows.Input.ICommandSource> メンバーを実装します。  この例では、プロパティは <xref:System.Windows.DependencyProperty> オブジェクトとして実装されます。  これにより、プロパティでデータ バインディングを使用できるようになります。  <xref:System.Windows.DependencyProperty> クラスの詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  データ バインディングの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Input.ICommandSource.Command%2A> プロパティのみを次に示します。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandSourceCommandPropertyDefinition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandsourcecommandpropertydefinition)]
+ [!code-vb[ImplementICommandSource#ImplementICommandSourceCommandPropertyDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandsourcecommandpropertydefinition)]  
+  
+ <xref:System.Windows.DependencyProperty> 変更コールバックを次に示します。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandSourceCommandChanged](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandsourcecommandchanged)]
+ [!code-vb[ImplementICommandSource#ImplementICommandSourceCommandChanged](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandsourcecommandchanged)]  
+  
+ 次に、コマンド ソースに関連付けられているコマンドを追加および削除します。  <xref:System.Windows.Input.ICommandSource.Command%2A> プロパティは、新しいコマンドを追加しても上書きできません。これは、前のコマンドに関連付けられているイベント ハンドラーが存在する場合、まずそのハンドラーを削除する必要があるためです。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandSourceHookUnHookCommands](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandsourcehookunhookcommands)]
+ [!code-vb[ImplementICommandSource#ImplementICommandSourceHookUnHookCommands](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandsourcehookunhookcommands)]  
+  
+ 最後に、<xref:System.Windows.Input.ICommand.CanExecuteChanged> ハンドラーおよび <xref:System.Windows.Input.ICommand.Execute%2A> メソッドのロジックを作成します。  
+  
+ 現在のコマンド ターゲットでコマンドを実行できるかどうかが変更された可能性があることが、<xref:System.Windows.Input.ICommand.CanExecuteChanged> イベントによってコマンド ソースに通知されます。  通常、このイベントを受け取ると、コマンド ソースがコマンドで <xref:System.Windows.Input.ICommand.CanExecute%2A> メソッドを呼び出します。  コマンドが現在のコマンド ターゲットで実行できない場合、通常はコマンド ソースが無効になります。  コマンドが現在のコマンド ターゲットで実行できる場合、通常はコマンド ソースが有効になります。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandCanExecuteChanged](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandcanexecutechanged)]
+ [!code-vb[ImplementICommandSource#ImplementICommandCanExecuteChanged](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandcanexecutechanged)]  
+  
+ 最後の手順は、<xref:System.Windows.Input.ICommand.Execute%2A> メソッドです。  コマンドが <xref:System.Windows.Input.RoutedCommand> の場合は、<xref:System.Windows.Input.RoutedCommand> <xref:System.Windows.Input.RoutedCommand.Execute%2A> メソッドが呼び出されます。それ以外の場合は、<xref:System.Windows.Input.ICommand> <xref:System.Windows.Input.ICommand.Execute%2A> メソッドが呼び出されます。  
+  
+ [!code-csharp[ImplementICommandSource#ImplementICommandExecute](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImplementICommandSource/CSharp/CommandSlider.cs#implementicommandexecute)]
+ [!code-vb[ImplementICommandSource#ImplementICommandExecute](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImplementICommandSource/visualbasic/commandslider.vb#implementicommandexecute)]  
+  
+## 参照  
+ <xref:System.Windows.Input.ICommandSource>   
+ <xref:System.Windows.Input.ICommand>   
+ <xref:System.Windows.Input.RoutedCommand>   
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-insert-an-element-into-text-programmatically.md b/docs/framework/wpf/advanced/how-to-insert-an-element-into-text-programmatically.md
new file mode 100644
index 00000000000..b70506be2a1
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-insert-an-element-into-text-programmatically.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : プログラムでテキストに要素を挿入する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "要素, 挿入 (テキストに)"
+  - "挿入 (テキストに要素を)"
+  - "テキスト アニメーションのサンプル"
+  - "テキスト, 挿入 (要素を)"
+  - "TextPointer オブジェクト"
+ms.assetid: 97bd950a-25ac-4e42-a311-94b6420d4136
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : プログラムでテキストに要素を挿入する
+次の例では、2 つの <xref:System.Windows.Documents.TextPointer> オブジェクトを使用して、<xref:System.Windows.Documents.Span> 要素を適用するテキスト内の範囲を指定する方法を示します。  
+  
+## 使用例  
+ [!code-csharp[FlowMiscSnippets_procedural_snip#InsertInlineIntoTextExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowMiscSnippets_procedural_snip/CSharp/InsertInlineIntoTextExample.cs#insertinlineintotextexamplewholepage)]
+ [!code-vb[FlowMiscSnippets_procedural_snip#InsertInlineIntoTextExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowMiscSnippets_procedural_snip/VisualBasic/InsertInlineIntoTextExample.vb#insertinlineintotextexamplewholepage)]  
+  
+ 次の図は、この例の結果を示したものです。  
+  
+ ![テキストの範囲に適用される Span 要素](../../../../docs/framework/wpf/advanced/media/flow-insertelementintotextprogrammatically.png "Flow\_InsertElementIntoTextProgrammatically")  
+  
+## 参照  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md b/docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md
new file mode 100644
index 00000000000..f22ed5d8c5c
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 印刷ダイアログ ボックスを呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "呼び出し (印刷ダイアログ ボックスを)"
+  - "印刷ダイアログ ボックス, 呼び出し"
+ms.assetid: e3a2c84c-74fe-45a4-8501-5813f9dbfed2
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 印刷ダイアログ ボックスを呼び出す
+アプリケーションからの印刷機能は、<xref:System.Windows.Controls.PrintDialog> オブジェクトを作成して開くだけで提供できます。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.PrintDialog> コントロールは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]、構成、および [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ジョブ送信のための単一エントリ ポイントを提供します。  このコントロールは使いやすく、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] マークアップまたはコードを使用してインスタンス化できます。  コードでコントロールをインスタンス化して開き、そのコントロールから印刷する方法を次の例に示します。  また、ダイアログ ボックスを使用してユーザーがページの特定範囲を設定できるようにする方法も示します。  このコード例は、C: ドライブのルートに FixedDocumentSequence.xps というファイルがあることを前提としています。  
+  
+ [!code-csharp[printdialog#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrintDialog/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[printdialog#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrintDialog/visualbasic/window1.xaml.vb#1)]  
+  
+ ダイアログ ボックスを開くと、ユーザーは各自のコンピューターにインストールされているプリンターの中からプリンターを選択することができます。  また、印刷する代わりに [Microsoft XPS ドキュメント ライター](http://go.microsoft.com/fwlink/?LinkId=147319)を選択して [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ファイルを作成することもできます。  
+  
+> [!NOTE]
+>  このトピックで説明する [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の <xref:System.Windows.Controls.PrintDialog?displayProperty=fullName> コントロールを [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)]の <xref:System.Windows.Forms.PrintDialog?displayProperty=fullName> コンポーネントと混同しないようにしてください。  
+  
+ 厳密には、ダイアログを開かないで <xref:System.Windows.Controls.PrintDialog.PrintDocument%2A> メソッドを使用できます。  この意味で、このコントロールは非表示の印刷コンポーネントとして使用できます。  ただし、パフォーマンス上の理由から、<xref:System.Printing.PrintQueue.AddJob%2A> メソッドまたは <xref:System.Windows.Xps.XpsDocumentWriter> の複数の <xref:System.Windows.Xps.XpsDocumentWriter.Write%2A> メソッドおよび <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A> メソッドのいずれかを使用することをお勧めします。  この詳細については、「[XPS ファイルをプログラムにより印刷する](../../../../docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.PrintDialog>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [Microsoft XPS Document Writer \(Microsoft XPS ドキュメント ライター\)](http://go.microsoft.com/fwlink/?LinkId=147319)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-list-the-data-formats-in-a-data-object.md b/docs/framework/wpf/advanced/how-to-list-the-data-formats-in-a-data-object.md
new file mode 100644
index 00000000000..eb93dae412e
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-list-the-data-formats-in-a-data-object.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : データ オブジェクト内のデータ形式の一覧を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ形式 [WPF], リスト"
+  - "DataFormats クラス [WPF]"
+  - "ドラッグ アンド ドロップ [WPF], 一覧表示 (データ形式を)"
+ms.assetid: 18e7ba4b-ccef-4815-ae2d-3a32891010c0
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : データ オブジェクト内のデータ形式の一覧を表示する
+<xref:System.Windows.DataObject.GetFormats%2A> メソッドのオーバーロードを使用して、データ オブジェクトで使用可能な各データ形式を示す文字列の配列を取得する方法を次の例に示します。  
+  
+## 例  
+  
+### Description  
+ <xref:System.Windows.DataObject.GetFormats%2A> オーバーロードを使用して、データ オブジェクトで使用可能なすべてのデータ形式 \(ネイティブおよび自動変換可能の両方\) を示す一連の文字列を取得するコード例を次に示します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getalldataformats)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getalldataformats)]  
+  
+## 例  
+  
+### Description  
+ <xref:System.Windows.DataObject.GetFormats%2A> オーバーロードを使用して、データ オブジェクトで使用できるデータ形式のみを示す一連の文字列を取得するコード例を次に示します \(自動変換可能なデータ形式はフィルター処理されます\)。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats_NativeOnly](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getalldataformats_nativeonly)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetAllDataFormats_NativeOnly](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getalldataformats_nativeonly)]  
+  
+## 参照  
+ <xref:System.Windows.IDataObject>   
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-localize-an-application.md b/docs/framework/wpf/advanced/how-to-localize-an-application.md
new file mode 100644
index 00000000000..017fe066206
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-localize-an-application.md
@@ -0,0 +1,221 @@
+---
+title: "方法 : アプリケーションをローカライズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, ローカライズ"
+  - "ローカリゼーション, アプリケーション"
+  - "LocBaml ツール"
+ms.assetid: 5001227e-9326-48a4-9dcd-ba1b89ee6653
+caps.latest.revision: 37
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# 方法 : アプリケーションをローカライズする
+このチュートリアルでは、LocBaml ツールを使用して、ローカライズされたアプリケーションを作成する方法について説明します。  
+  
+> [!NOTE]
+>  LocBaml ツールは、実稼働可能なアプリケーションではありません。  それはローカリゼーション API の一部を使用するサンプルとして提供されており、ローカリゼーション ツールを記述する方法を例示します。  
+>   
+>  [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Introduction"></a>   
+## 概要  
+ この説明では、アプリケーションのローカリゼーションの手順を段階を追って示します。  最初に、翻訳されるテキストを抽出できるようにアプリケーションを準備します。  テキストの翻訳後、翻訳されたテキストを元のアプリケーションの新しいコピーにマージします。  
+  
+<a name="Requirements"></a>   
+## 必要条件  
+ この説明の過程で、コマンド ラインから実行するコンパイラである [!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] を使用します。  
+  
+ また、プロジェクト ファイルを使用するよう指示されます。  [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] とプロジェクト ファイルの使用方法の説明については、「[ビルドと配置](../../../../docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md)」を参照してください。  
+  
+ この説明のすべての例では、カルチャとして en\-US \(英語\-米国\) を使用します。  別の言語をインストールしなくても、この例の手順全体の作業を行えます。  
+  
+<a name="create_sample_app"></a>   
+## サンプルのアプリケーションの作成  
+ このステップでは、ローカリゼーション用のアプリケーションを準備します。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のサンプルでは、この説明のコード サンプルで使用される HelloApp のサンプルが提供されています。  このサンプルを使用する場合は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] のファイルを [LocBaml ツール サンプル](http://go.microsoft.com/fwlink/?LinkID=160016)」からダウンロードします。  
+  
+1.  ローカリゼーションを開始するポイントまで、アプリケーションを開発します。  
+  
+2.  [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] がメイン アセンブリとサテライト アセンブリ \(.resources.dll の拡張子が付いたファイル\) を生成してニュートラルな言語リソースを含めるように、プロジェクト ファイルの開発言語を指定します。  HelloApp サンプルのプロジェクト ファイルは HelloApp.csproj です。  このファイルに、以下のように特定される開発言語があります。  
+  
+     `<UICulture>en-US</UICulture>`  
+  
+3.  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルに UID を追加します。  UID は、ファイルへの変更を追跡して、翻訳する必要がある項目を識別するために使用されます。  UID をファイルに追加するには、プロジェクト ファイルで **updateuid** を実行します。  
+  
+     **msbuild \/t:updateuid helloapp.csproj**  
+  
+     不足している UID または重複する UID がないことを確認するには、**checkuid** を実行します。  
+  
+     **msbuild \/t:checkuid helloapp.csproj**  
+  
+     **updateuid** の実行後、ファイルには UID が含まれている必要があります。  たとえば、HelloApp の Pane1.xaml ファイルに、以下の内容があるはずです。  
+  
+     `<StackPanel x:Uid="StackPanel_1">`  
+  
+     `<TextBlock x:Uid="TextBlock_1">Hello World</TextBlock>`  
+  
+     `<TextBlock x:Uid="TextBlock_2">Goodbye World</TextBlock>`  
+  
+     `</StackPanel>`  
+  
+<a name="create_dll"></a>   
+## ニュートラル言語リソースのサテライト アセンブリを作成する  
+ ニュートラル言語リソースのサテライト アセンブリを生成するようにアプリケーションを構成した後、アプリケーションをビルドします。  これにより、メイン アプリケーション アセンブリだけでなく、ローカリゼーションで LocBaml が必要とするニュートラル言語リソースのサテライト アセンブリが生成されます。  アプリケーションをビルドするには  
+  
+1.  HelloApp をコンパイルして [!INCLUDE[TLA#tla_dll](../../../../includes/tlasharptla-dll-md.md)] を作成します。  
+  
+     **msbuild helloapp.csproj**  
+  
+2.  新規作成されたメインのアプリケーション アセンブリ HelloApp.exe は、次のフォルダーに作成されます。  
+  
+     `C:\HelloApp\Bin\Debug\`  
+  
+3.  新規作成されたニュートラル言語リソースのサテライト アセンブリ HelloApp.resources.dll は次のフォルダーに作成されます。  
+  
+     `C:\HelloApp\Bin\Debug\en-US\`  
+  
+<a name="build_locbaml"></a>   
+## LocBaml ツールをビルドする  
+  
+1.  LocBaml のビルドに必要なすべてのファイルは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] サンプルに配置されています。  [!INCLUDE[TLA#tla_lhcshrp](../../../../includes/tlasharptla-lhcshrp-md.md)] のファイルを「[LocBaml ツール サンプル](http://go.microsoft.com/fwlink/?LinkID=160016)」からダウンロードします。  
+  
+2.  ツールをビルドするには、コマンド ラインでプロジェクト ファイル \(locbaml.csproj\) を実行します。  
+  
+     **msbuild locbaml.csproj**  
+  
+3.  新しく作成された実行可能ファイル \(locbaml.exe\) を検索するには、bin \\release ディレクトリに移動します。  例: C:\\LocBaml\\Bin\\Release\\locbaml.exe  
+  
+4.  LocBaml を実行するときに指定できるオプションは、次のとおりです。  
+  
+    -   **parse** または **\-p:** : Baml、リソース、または [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] ファイルを解析して、.csv または .txt ファイルを生成します。  
+  
+    -   **generate** または **\-g:** : 翻訳されたファイルを使用して、ローカライズされたバイナリ ファイルを生成します。  
+  
+    -   **out** または **\-o** \[*filedirectory*\]**:** : 出力ファイルの名前。  
+  
+    -   **culture** または **\-cul** \[*culture*\]**:** : 出力アセンブリのロケール。  
+  
+    -   **translation** または **\-trans** \[*translation.csv*\]**:** : 翻訳またはローカライズされたファイル。  
+  
+    -   **asmpath** または **\-asmpath:** \[*filedirectory*\]**:** : [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] コードにカスタム コントロールが含まれている場合、カスタム コントロール アセンブリに **asmpath** を指定する必要があります。  
+  
+    -   **nologo:** : ロゴまたは著作権情報は表示されません。  
+  
+    -   **verbose:** : 詳細モードの情報が表示されます。  
+  
+    > [!NOTE]
+    >  このツールを実行しているときにオプションの一覧が必要な場合は、**LocBaml.exe** を入力してから ENTER キーを押します。  
+  
+<a name="parse_dll"></a>   
+## LocBaml を使用してファイルを解析する  
+ LocBaml ツールが作成されたので、これを使用して HelloApp.resources.dll を解析し、ローカライズするテキスト コンテンツを抽出できる状態になりました。  
+  
+1.  LocBaml.exe を、メインのアプリケーション アセンブリが作成された、アプリケーションの bin \\debug フォルダーにコピーします。  
+  
+2.  サテライト アセンブリ ファイルを解析して、.csv ファイルとして出力を格納するには、次のコマンドを使用します。  
+  
+     **LocBaml.exe \/parse HelloApp.resources.dll \/out:Hello.csv**  
+  
+    > [!NOTE]
+    >  入力ファイル HelloApp.resources.dll が LocBaml.exe と同じディレクトリに存在しない場合は、いずれかのファイルを移動して両方のファイルが同じディレクトリにあるようにします。  
+  
+3.  LocBaml を実行してファイルを解析する際、出力はコンマ区切り \(.csv ファイル\) またはタブ区切り \(.txt ファイル\) された 7 つのフィールドで構成されます。  HelloApp.resources.dll の解析済みの .csv ファイルを次に示します。  
+  
+    ||  
+    |-|  
+    |HelloApp.g.en\-US.resources:window1.baml,Stack1:System.Windows.Controls.StackPanel.$Content,Ignore,FALSE, FALSE,,\#Text1;\#Text2;|  
+    |HelloApp.g.en\-US.resources:window1.baml,Text1:System.Windows.Controls.TextBlock.$Content,None,TRUE, TRUE,,Hello World|  
+    |HelloApp.g.en\-US.resources:window1.baml,Text2:System.Windows.Controls.TextBlock.$Content,None,TRUE, TRUE,,Goodbye World|  
+  
+     7 つのフィールドは、次のとおりです。  
+  
+    1.  **BAML 名**。  ソース言語のサテライト アセンブリに関する BAML リソースの名前。  
+  
+    2.  **リソース キー**。  ローカライズされたリソースの識別子。  
+  
+    3.  **カテゴリ**。  値の型です。  「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+    4.  **読みやすさ**。  ローカライザーによって値が読み取れるかどうか。  「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+    5.  **変更可能性**。  ローカライザーによって値が変更できるかどうか。  「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+    6.  **コメント**。  値をローカライズする方法を決定するための値の追加の説明。  「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+    7.  **値**。  目的のカルチャに翻訳するテキストの値。  
+  
+     次の表は、.csv ファイルの区切り記号付きの値にこれらのフィールドをマップする方法を示しています。  
+  
+    |BAML 名|リソース キー|カテゴリ|読みやすさ|変更可能性|コメント|値|  
+    |------------|-------------|----------|-----------|-----------|----------|-------|  
+    |HelloApp.g.en\-US.resources:window1.baml|Stack1:System.Windows.Controls.StackPanel.$Content|Ignore|FALSE|FALSE||\#Text1;\#Text2|  
+    |HelloApp.g.en\-US.resources:window1.baml|Stack1:System.Windows.Controls.StackPanel.$Content|なし|TRUE|TRUE||Hello World|  
+    |HelloApp.g.en\-US.resources:window1.baml|Stack1:System.Windows.Controls.StackPanel.$Content|なし|TRUE|TRUE||Goodbye World|  
+  
+     **\[コメント\]** フィールドのすべての値に値が含まれていないことに注意してください。フィールドに値がない場合、フィールドは空です。  また、最初の行の項目は、読み取り可能でも変更可能でもありませんが、**\[カテゴリ\]** の値として "Ignore" が含まれていることにも注意してください。これらはすべて、値がローカライズ可能ではないことを示します。  
+  
+4.  解析済みのファイルでローカライズ可能な項目の検出を容易にするためには、項目を**カテゴリ**、**読みやすさ**、および**変更可能性**で並べ替えるかフィルター処理します。  たとえば、読み取りも変更もできない値をフィルター処理することができます。  
+  
+<a name="translate_loc_content"></a>   
+## ローカライズ可能なコンテンツを翻訳する  
+ 抽出されたコンテンツを翻訳するために使用可能な任意のツールを使用します。  これを行う良い方法は、リソースを .csv ファイルに記述し、それらを [!INCLUDE[TLA#tla_xl](../../../../includes/tlasharptla-xl-md.md)] に表示して、翻訳の変更内容を最後の列 \(値\) にすることです。  
+  
+<a name="merge_translations"></a>   
+## LocBaml を使用して新しい .resources.dll ファイルを生成する  
+ LocBaml で HelloApp.resources.dll を解析して識別されたコンテンツは翻訳済みであり、元のアプリケーションにマージする必要があります。  新しい .resources.dll ファイルを生成するには、**generate** または **\-g** オプションを使用します。  
+  
+1.  新しい HelloApp.resources.dll ファイルを生成するには、次の構文を使用します。  カルチャを en\-US \(\/cul:en\-US\) としてマークします。  
+  
+     **LocBaml.exe \/generate HelloApp.resources.dll \/trans:Hello.csv \/out:c:\\ \/cul:en\-US**  
+  
+    > [!NOTE]
+    >  入力ファイル Hello.csv が実行可能ファイル LocBaml.exe と同じディレクトリに存在しない場合は、いずれかのファイルを移動して、両方のファイルが同じディレクトリにあるようにします。  
+  
+2.  C:\\HelloApp\\Bin\\Debug\\en\-US\\HelloApp.resources.dll ディレクトリにある古い HelloApp.resources.dll ファイルを新規作成した HelloApp.resources.dll ファイルに置き換えます。  
+  
+3.  ここで "Hello World" と "Goodbye World" をアプリケーション内で翻訳する必要があります。  
+  
+4.  別のカルチャに翻訳するには、翻訳先の言語のカルチャを使用します。  フランス語 \(カナダ\) に翻訳する方法の例を次に示します。  
+  
+     **LocBaml.exe \/generate HelloApp.resources.dll \/trans:Hellofr\-CA.csv \/out:c:\\ \/cul:fr\-CA**  
+  
+5.  メイン アプリケーション アセンブリと同じアセンブリで、新しいサテライト アセンブリを格納するために、新しいカルチャ固有のフォルダーを作成します。  フランス語 \(カナダ\) のフォルダーは "fr\-CA" となります。  
+  
+6.  新しいフォルダーに生成されたサテライト アセンブリをコピーします。  
+  
+7.  新しいサテライト アセンブリをテストするには、アプリケーションが実行するカルチャを変更する必要があります。  2 つの方法のいずれかでこれを行うことができます。  
+  
+    -   オペレーティング システムの地域設定を変更する \(**スタート** &#124; **コントロール パネル** &#124; **地域と言語のオプション**\)。  
+  
+    -   アプリケーションで、次のコードを App.xaml.cs に追加します。  
+  
+         [!code-xml[LocBamlChangeCultureSnippets#LocBamlChangeCultureMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocBamlChangeCultureSnippets/CSharp/App.xaml#locbamlchangeculturemarkup)]  
+  
+         [!code-csharp[LocBamlChangeCultureSnippets#LocBamlChangeCultureCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocBamlChangeCultureSnippets/CSharp/App.xaml.cs#locbamlchangeculturecodebehind)]
+         [!code-vb[LocBamlChangeCultureSnippets#LocBamlChangeCultureCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/LocBamlChangeCultureSnippets/VisualBasic/Application.xaml.vb#locbamlchangeculturecodebehind)]  
+  
+<a name="Some_Tips_for_Using_LocBaml"></a>   
+## LocBaml を使用するためのヒント  
+  
+-   カスタム コントロールを定義するすべての依存アセンブリを LocBaml のローカル ディレクトリにコピーするか、GAC にインストールする必要があります。  ローカリゼーション API は、[!INCLUDE[TLA#tla_baml](../../../../includes/tlasharptla-baml-md.md)] を読み取るときに、依存アセンブリにアクセスできる必要があるため、これが必要になります。  
+  
+-   メインのアセンブリが署名済みの場合は、生成されたリソース DLL も読み込むために署名されている必要があります。  
+  
+-   ローカライズされたリソースの DLL は、メインのアセンブリと同期する必要があります。  
+  
+<a name="Whats_Next"></a>   
+## 次の内容  
+ これで、LocBaml ツールの使用方法に関する基本的な知識が得られました。  UID を含むファイルを作成できるようになりました。  LocBaml ツールを使用することで、ローカライズ可能なコンテンツを抽出するファイルを解析できます。コンテンツを翻訳すると、翻訳済みのコンテンツをマージする .resources.dll ファイルを生成できます。  このトピックには、可能性のあるすべての詳細情報は含まれていませんが、LocBaml を使用してアプリケーションをローカライズするために必要な知識は得られました。  
+  
+## 参照  
+ [WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)   
+ [自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-make-a-freezable-read-only.md b/docs/framework/wpf/advanced/how-to-make-a-freezable-read-only.md
new file mode 100644
index 00000000000..369d8e6e0c5
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-make-a-freezable-read-only.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : Freezable を読み取り専用にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Freezable オブジェクト, 読み取り専用にする"
+ms.assetid: 6c544b7d-d3c9-4736-aa90-4b8728234ccb
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Freezable を読み取り専用にする
+この例では、<xref:System.Windows.Freezable.Freeze%2A> メソッドを呼び出して、<xref:System.Windows.Freezable> を読み取り専用にする方法を示します。  
+  
+ 次に示す条件が 1 つでも `true` である場合は、<xref:System.Windows.Freezable> オブジェクトを固定できません。  
+  
+-   アニメーション化されたプロパティ、またはデータ バインドされたプロパティがある。  
+  
+-   動的リソースによって設定されたプロパティがある。  動的リソースの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+-   固定できない <xref:System.Windows.Freezable> のサブオブジェクトが含まれている。  
+  
+ <xref:System.Windows.Freezable> オブジェクトに関してこれらの条件が `false` であり、オブジェクトを変更しない場合は、オブジェクトを固定して、性能の向上を図ることをお勧めします。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Freezable> オブジェクトの一種の <xref:System.Windows.Media.SolidColorBrush> を固定します。  
+  
+ [!code-csharp[freezablesample_procedural#FreezeExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#freezeexample1)]
+ [!code-vb[freezablesample_procedural#FreezeExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#freezeexample1)]  
+  
+ <xref:System.Windows.Freezable> オブジェクトの詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Freezable>   
+ <xref:System.Windows.Freezable.CanFreeze%2A>   
+ <xref:System.Windows.Freezable.Freeze%2A>   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/base-elements-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-make-a-uielement-transparent-or-semi-transparent.md b/docs/framework/wpf/advanced/how-to-make-a-uielement-transparent-or-semi-transparent.md
new file mode 100644
index 00000000000..cb1cd2c5d28
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-make-a-uielement-transparent-or-semi-transparent.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : UIElement を透明または半透明にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "不透明, UIElement"
+  - "透過性 (UIElement の)"
+  - "UIElements, 不透明"
+  - "UIElements, 透過性"
+ms.assetid: a49fc8d6-7b32-4f28-9122-39b632a19b4b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : UIElement を透明または半透明にする
+<xref:System.Windows.UIElement> を透明または半透明にする方法を次の例に示します。  要素を透明または半透明にするには、その <xref:System.Windows.UIElement.Opacity%2A> プロパティを設定します。  値 `0.0` は、要素が完全に透明であることを示し、値 `1.0` は、要素が完全に不透明であることを示します。  値 `0.5` は、この要素の不透明度が 50% であることを示します。他も同様です。  既定では、要素の <xref:System.Windows.UIElement.Opacity%2A> は `1.0` に設定されます。  
+  
+## 使用例  
+ 次の例では、ボタンの <xref:System.Windows.UIElement.Opacity%2A> を `0.25` に設定することにより、ボタンとそのコンテンツ \(この例ではボタンのテキスト\) の不透明度を 25% にしています。  
+  
+ [!code-xml[brushsamples_snip#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/OpacityExample.xaml#2)]  
+  
+ [!code-csharp[brushsamples_procedural_snip#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_procedural_snip/CSharp/OpacityExample.cs#2)]  
+  
+ 要素のコンテンツに独自の <xref:System.Windows.UIElement.Opacity%2A> が設定されている場合は、それらの値と、含まれている要素の <xref:System.Windows.UIElement.Opacity%2A> が乗算されます。  
+  
+ ボタンの <xref:System.Windows.UIElement.Opacity%2A> を `0.25` に設定し、そのボタンに含まれている <xref:System.Windows.Controls.Image> コントロールの <xref:System.Windows.UIElement.Opacity%2A> を `0.5` に設定する例を次に示します。  結果として、イメージは 12.5% \(0.25 × 0.5 \= 0.125\) の不透明度で表示されます。  
+  
+ [!code-xml[brushsamples_snip#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/OpacityExample.xaml#3)]  
+  
+ [!code-csharp[brushsamples_procedural_snip#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_procedural_snip/CSharp/OpacityExample.cs#3)]  
+  
+ 要素の不透明度は、要素を描画する <xref:System.Windows.Media.Brush> の不透明度を設定することによって制御することもできます。  この方法を使用すると、1 つの要素の各部分の不透明度を選択して変更でき、要素の <xref:System.Windows.UIElement.Opacity%2A> プロパティを使用するよりもパフォーマンスが向上します。  ボタンの <xref:System.Windows.Controls.Control.Background%2A> を描画するために使用される <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.Brush.Opacity%2A> を `0.25` に設定する例を次に示します。  結果として、ブラシの背景の不透明度は 25% になりますが、そのコンテンツ \(ボタンのテキスト\) の不透明度は 100% のままです。  
+  
+ [!code-xml[brushsamples_snip#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/OpacityExample.xaml#4)]  
+  
+ [!code-csharp[brushsamples_procedural_snip#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_procedural_snip/CSharp/OpacityExample.cs#4)]  
+  
+ また、ブラシ内の個々の色の不透明度を制御することもできます。  色とブラシの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  要素の不透明度をアニメーション化する方法の例については、「[要素またはブラシの不透明度をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-opacity-of-an-element-or-brush.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-make-an-object-follow-the-mouse-pointer.md b/docs/framework/wpf/advanced/how-to-make-an-object-follow-the-mouse-pointer.md
new file mode 100644
index 00000000000..88a3d006a15
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-make-an-object-follow-the-mouse-pointer.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : オブジェクトをマウス ポインターに追従させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カーソル (マウス ポインター), 追従させる (オブジェクトを)"
+  - "マウス ポインター (カーソル) の追従"
+  - "マウス ポインター (カーソル), 追従させる (オブジェクトを)"
+ms.assetid: 50b20415-14bc-405c-baf3-2fb254fffde3
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : オブジェクトをマウス ポインターに追従させる
+マウス ポインターが画面上で移動したときにオブジェクトのサイズを変更する方法を次の例に示します。  
+  
+ この例には、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成する [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルと、イベント ハンドラーを作成する分離コード ファイルが含まれます。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA2#tla_titlexaml](../../../../includes/tla2sharptla-titlexaml-md.md)] が作成する [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、<xref:System.Windows.Controls.StackPanel> の内部の <xref:System.Windows.Shapes.Ellipse> で構成され、<xref:System.Windows.UIElement.MouseMove> イベントのイベント ハンドラーを結合しています。  
+  
+ [!code-xml[mouseMoveWithPointer#MouseMoveWithPointerXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/mouseMoveWithPointer/CSharp/Window1.xaml#mousemovewithpointerxaml)]  
+  
+ 次の分離コードでは、<xref:System.Windows.UIElement.MouseMove> イベント ハンドラーを作成します。  マウス ポインターが移動すると、<xref:System.Windows.Shapes.Ellipse> の高さと幅が増減します。  
+  
+ [!code-csharp[mouseMoveWithPointer#MouseMovePointerGetPosition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/mouseMoveWithPointer/CSharp/Window1.xaml.cs#mousemovepointergetposition)]
+ [!code-vb[mouseMoveWithPointer#MouseMovePointerGetPosition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/mouseMoveWithPointer/VisualBasic/Window1.xaml.vb#mousemovepointergetposition)]  
+  
+## 参照  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md b/docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md
new file mode 100644
index 00000000000..74f2dd87c49
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : Blocks プロパティを介して FlowDocument を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Blocks プロパティ, 操作 (FlowDocument を)"
+  - "ドキュメント, 操作 (Blocks プロパティを介して FlowDocument を)"
+  - "FlowDocument, 操作 (Blocks プロパティを介して)"
+  - "プロパティ, ブロック, 操作 (FlowDocument を)"
+ms.assetid: cbb7291e-3f1b-433e-9e16-f4d93ced14e8
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Blocks プロパティを介して FlowDocument を操作する
+以下の例では、<xref:System.Windows.Documents.FlowDocument.Blocks%2A> プロパティを使用して <xref:System.Windows.Documents.FlowDocument> で実行できる一般的な操作を示します。  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.FlowDocument> を作成した後、新しい <xref:System.Windows.Documents.Paragraph> 要素をその <xref:System.Windows.Documents.FlowDocument> に追加しています。  
+  
+ [!code-csharp[FlowDocumentSnippets#_FlowDocumentBlocksAdd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_flowdocumentblocksadd)]
+ [!code-vb[FlowDocumentSnippets#_FlowDocumentBlocksAdd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_flowdocumentblocksadd)]  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.Paragraph> 要素を作成して <xref:System.Windows.Documents.FlowDocument> の先頭に挿入します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_FlowDocumentBlocksInsert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_flowdocumentblocksinsert)]
+ [!code-vb[FlowDocumentSnippets#_FlowDocumentBlocksInsert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_flowdocumentblocksinsert)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.FlowDocument> に含まれているトップレベルの <xref:System.Windows.Documents.Block> 要素の数を取得します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_FlowDocumentBlocksCount](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_flowdocumentblockscount)]
+ [!code-vb[FlowDocumentSnippets#_FlowDocumentBlocksCount](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_flowdocumentblockscount)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.FlowDocument> 内の最後の <xref:System.Windows.Documents.Block> 要素を削除します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_FlowDocumentBlocksRemoveLast](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_flowdocumentblocksremovelast)]
+ [!code-vb[FlowDocumentSnippets#_FlowDocumentBlocksRemoveLast](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_flowdocumentblocksremovelast)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.FlowDocument> からすべての内容 \(<xref:System.Windows.Documents.Block> 要素\) を消去します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_FlowDocumentBlocksClear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_flowdocumentblocksclear)]
+ [!code-vb[FlowDocumentSnippets#_FlowDocumentBlocksClear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_flowdocumentblocksclear)]  
+  
+## 参照  
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)   
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-blocks-property.md b/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-blocks-property.md
new file mode 100644
index 00000000000..09bf40cf943
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-blocks-property.md
@@ -0,0 +1,76 @@
+---
+title: "方法 : Blocks プロパティを介してフロー コンテンツ要素を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Blocks プロパティ, 操作 (フロー コンテンツ要素を)"
+  - "ドキュメント, 操作 (Blocks プロパティを介してフロー コンテンツ要素を)"
+  - "フロー コンテンツ要素, 操作 (Blocks プロパティを介して)"
+  - "プロパティ, ブロック, 操作 (フロー コンテンツ要素を)"
+ms.assetid: aeda4ece-b979-4818-a093-ef938e908751
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Blocks プロパティを介してフロー コンテンツ要素を操作する
+ここでは、**Blocks** プロパティを使用してフロー コンテンツ要素に対して実行できるいくつかの一般的な操作を示します。  このプロパティは、<xref:System.Windows.Documents.BlockCollection> の項目を追加および削除するために使用します。  **Blocks** プロパティを備えたフロー コンテンツ要素には、以下のものがあります。  
+  
+-   <xref:System.Windows.Documents.Figure>  
+  
+-   <xref:System.Windows.Documents.Floater>  
+  
+-   <xref:System.Windows.Documents.ListItem>  
+  
+-   <xref:System.Windows.Documents.Section>  
+  
+-   <xref:System.Windows.Documents.TableCell>  
+  
+ このトピックの例では、フロー コンテンツ要素として <xref:System.Windows.Documents.Section> を使用していますが、フロー コンテンツ要素コレクションをホストするすべての要素に同じ手法を適用できます。  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.Section> を作成し、**Add** メソッドを使用して **Section** コンテンツに新しい Paragraph を追加します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksAdd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblocksadd)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksAdd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblocksadd)]  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.Paragraph> 要素を作成して <xref:System.Windows.Documents.Section> の先頭に挿入します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksInsert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblocksinsert)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksInsert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblocksinsert)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Section> に含まれているトップレベルの <xref:System.Windows.Documents.Block> 要素の数を取得します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksCount](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblockscount)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksCount](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblockscount)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Section> 内の最後の <xref:System.Windows.Documents.Block> 要素を削除します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksRemoveLast](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblocksremovelast)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksRemoveLast](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblocksremovelast)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Section> からすべての内容 \(<xref:System.Windows.Documents.Block> 要素\) を消去します。  
+  
+ [!code-csharp[FlowDocumentSnippets#_SectionBlocksClear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml.cs#_sectionblocksclear)]
+ [!code-vb[FlowDocumentSnippets#_SectionBlocksClear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FlowDocumentSnippets/visualbasic/window1.xaml.vb#_sectionblocksclear)]  
+  
+## 参照  
+ <xref:System.Windows.Documents.BlockCollection>   
+ <xref:System.Windows.Documents.InlineCollection>   
+ <xref:System.Windows.Documents.ListItemCollection>   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)   
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-inlines-property.md b/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-inlines-property.md
new file mode 100644
index 00000000000..b50620555da
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-inlines-property.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : Inlines プロパティを介してフロー コンテンツ要素を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 操作 (Inlines プロパティを介してフロー コンテンツ要素を)"
+  - "フロー コンテンツ要素, 操作 (Inlines プロパティを介して)"
+  - "Inlines プロパティ, 操作 (フロー コンテンツ要素を)"
+  - "プロパティ, Inlines, 操作 (フロー コンテンツ要素を)"
+ms.assetid: 510780d2-3da1-4360-8763-7054bda22ea3
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : Inlines プロパティを介してフロー コンテンツ要素を操作する
+以下の例では、**Inlines** プロパティを使用してインライン フロー コンテンツ要素 \(およびこのような要素の <xref:System.Windows.Controls.TextBlock> などのコンテナー\) に対して実行できるいくつかの一般的な操作を示します。  このプロパティは、<xref:System.Windows.Documents.InlineCollection> の項目を追加および削除するために使用します。  **Inlines** プロパティを備えたフロー コンテンツ要素には、以下のものがあります。  
+  
+-   <xref:System.Windows.Documents.Bold>  
+  
+-   <xref:System.Windows.Documents.Hyperlink>  
+  
+-   <xref:System.Windows.Documents.Italic>  
+  
+-   <xref:System.Windows.Documents.Paragraph>  
+  
+-   <xref:System.Windows.Documents.Span>  
+  
+-   <xref:System.Windows.Documents.Underline>  
+  
+ このトピックの例では、フロー コンテンツ要素として <xref:System.Windows.Documents.Span> を使用していますが、<xref:System.Windows.Documents.InlineCollection> コレクションをホストするすべての要素またはコントロールに同じ手法を適用できます。  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.Span> オブジェクトを作成した後、**Add** メソッドを使用して、2 つのテキスト ランを <xref:System.Windows.Documents.Span> のコンテンツの子として追加します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesAdd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesadd)]
+ [!code-vb[SpanSnippets#_SpanInlinesAdd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesadd)]  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.Run> 要素を作成して <xref:System.Windows.Documents.Span> の先頭に挿入します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesInsert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesinsert)]
+ [!code-vb[SpanSnippets#_SpanInlinesInsert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesinsert)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Span> に含まれているトップレベルの <xref:System.Windows.Documents.Inline> 要素の数を取得します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesCount](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinescount)]
+ [!code-vb[SpanSnippets#_SpanInlinesCount](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinescount)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Span> 内の最後の <xref:System.Windows.Documents.Inline> 要素を削除します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesremovelast)]
+ [!code-vb[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesremovelast)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.Span> からすべての内容 \(<xref:System.Windows.Documents.Inline> 要素\) を消去します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesclear)]
+ [!code-vb[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesclear)]  
+  
+## 参照  
+ <xref:System.Windows.Documents.BlockCollection>   
+ <xref:System.Windows.Documents.InlineCollection>   
+ <xref:System.Windows.Documents.ListItemCollection>   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)   
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md b/docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md
new file mode 100644
index 00000000000..1e42a831dd0
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md
@@ -0,0 +1,78 @@
+---
+title: "方法 : Columns プロパティによってテーブルの列を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Columns プロパティ"
+  - "ドキュメント, 操作 (テーブルの列を)"
+  - "プロパティ, 列, 操作 (テーブルの列を)"
+  - "テーブル, 操作 (列を)"
+ms.assetid: 3f8884f4-7e1f-456b-be06-fbd3cf469bf3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Columns プロパティによってテーブルの列を操作する
+この例では、<xref:System.Windows.Documents.Table.Columns%2A> プロパティを使用してテーブルの列に対して実行できるいくつかの一般的な操作を示します。  
+  
+## 使用例  
+ 次の例では、新しいテーブルを作成し、<xref:System.Windows.Documents.TableColumnCollection.Add%2A> メソッドを使用してテーブルの <xref:System.Windows.Documents.Table.Columns%2A> コレクションに列を追加します。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_Add](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_add)]
+ [!code-vb[TableSnippets2#_Table_Columns_Add](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_add)]  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.TableColumn> を挿入します。  新しい列をインデックス位置 0 に挿入し、その列をテーブルの新しい先頭列にしています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.TableColumnCollection> コレクションは、標準のゼロから始まるインデックスを使用します。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_Insert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_insert)]
+ [!code-vb[TableSnippets2#_Table_Columns_Insert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_insert)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Documents.TableColumnCollection> コレクションの特定の列をインデックスで参照し、その列の任意のプロパティにアクセスしています。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_Manip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_manip)]
+ [!code-vb[TableSnippets2#_Table_Columns_Manip](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_manip)]  
+  
+## 使用例  
+ 次の例では、テーブルで現在ホストされている列の数を取得しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_Count](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_count)]
+ [!code-vb[TableSnippets2#_Table_Columns_Count](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_count)]  
+  
+## 使用例  
+ 次の例では、参照によって特定の列を削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_DelRef](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_delref)]
+ [!code-vb[TableSnippets2#_Table_Columns_DelRef](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_delref)]  
+  
+## 使用例  
+ 次の例では、インデックスによって特定の列を削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_DelIndex](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_delindex)]
+ [!code-vb[TableSnippets2#_Table_Columns_DelIndex](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_delindex)]  
+  
+## 使用例  
+ 次の例では、テーブルの列コレクションからすべての列を削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_Columns_Clear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_columns_clear)]
+ [!code-vb[TableSnippets2#_Table_Columns_Clear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_columns_clear)]  
+  
+## 参照  
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)   
+ [XAML を使用してテーブルを定義する](../../../../docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md)   
+ [プログラムによってテーブルをビルドする](../../../../docs/framework/wpf/advanced/how-to-build-a-table-programmatically.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)   
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md b/docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md
new file mode 100644
index 00000000000..e12c2c4edb7
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md
@@ -0,0 +1,93 @@
+---
+title: "方法 : RowGroups プロパティを介してテーブルの行グループを操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, 操作 (RowGroups プロパティを介して行グループを)"
+  - "プロパティ, RowGroups, 操作 (行グループを)"
+  - "行グループ, 操作 (RowGroups プロパティを介して)"
+  - "RowGroups プロパティ, 操作 (行グループを)"
+ms.assetid: ea61440f-08ae-44ed-b314-5716aaaae3ed
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : RowGroups プロパティを介してテーブルの行グループを操作する
+この例では、<xref:System.Windows.Documents.Table.RowGroups%2A> プロパティを使用してテーブルの行グループに対して実行できるいくつかの一般的な操作を示します。  
+  
+## 使用例  
+ 次の例では、新しいテーブルを作成し、<xref:System.Windows.Documents.TableRowGroupCollection.Add%2A> メソッドを使用してテーブルの <xref:System.Windows.Documents.Table.RowGroups%2A> コレクションに列を追加します。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_Add](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_add)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_Add](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_add)]  
+  
+## 使用例  
+ 次の例では、新しい <xref:System.Windows.Documents.TableRowGroup> を挿入します。  新しい行グループをインデックス位置 0 に挿入し、それをテーブルの新しい先頭行グループにしています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.TableRowGroupCollection> コレクションは、標準のゼロから始まるインデックスを使用します。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_Insert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_insert)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_Insert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_insert)]  
+  
+## 使用例  
+ 次の例では、テーブル内の特定の <xref:System.Windows.Documents.TableRowGroup> \(インデックスで指定\) に、複数の行を追加しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_AddRows](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_addrows)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_AddRows](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_addrows)]  
+  
+## 使用例  
+ 次の例では、テーブルの最初の行グループに含まれる行の任意のプロパティにアクセスしています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_ManipRows](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_maniprows)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_ManipRows](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_maniprows)]  
+  
+## 使用例  
+ 次の例では、テーブル内の特定の <xref:System.Windows.Documents.TableRow> \(インデックスで指定\) に、複数のセルを追加しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_AddCells](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_addcells)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_AddCells](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_addcells)]  
+  
+## 使用例  
+ 次の例では、最初の行グループの先頭行のセルの任意のメソッドとプロパティにアクセスしています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_ManipCells](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_manipcells)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_ManipCells](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_manipcells)]  
+  
+## 使用例  
+ 次の例では、テーブルでホストされている <xref:System.Windows.Documents.TableRowGroup> 要素の数を返しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_Count](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_count)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_Count](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_count)]  
+  
+## 使用例  
+ 次の例では、参照によって特定の行グループを削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_DelRef](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_delref)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_DelRef](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_delref)]  
+  
+## 使用例  
+ 次の例では、インデックスによって特定の行グループを削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_DelIndex](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_delindex)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_DelIndex](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_delindex)]  
+  
+## 使用例  
+ 次の例では、テーブルの行グループ コレクションからすべての行グループを削除しています。  
+  
+ [!code-csharp[TableSnippets2#_Table_RowGroups_Clear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml.cs#_table_rowgroups_clear)]
+ [!code-vb[TableSnippets2#_Table_RowGroups_Clear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets2/visualbasic/window1.xaml.vb#_table_rowgroups_clear)]  
+  
+## 参照  
+ [How\-to: Manipulate Flow Content Elements through the Inlines Property](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)   
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)   
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-obtain-a-writable-copy-of-a-read-only-freezable.md b/docs/framework/wpf/advanced/how-to-obtain-a-writable-copy-of-a-read-only-freezable.md
new file mode 100644
index 00000000000..34825e0cd65
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-obtain-a-writable-copy-of-a-read-only-freezable.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 読み取り専用の Freezable の書き込み可能なコピーを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複製 (Freezable オブジェクトを)"
+  - "Freezable オブジェクト, 変更可能な複製"
+ms.assetid: d028de61-bbe9-4d62-b656-8fe3b1b2ca24
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 読み取り専用の Freezable の書き込み可能なコピーを取得する
+<xref:System.Windows.Freezable.Clone%2A> メソッドを使用して読み取り専用の <xref:System.Windows.Freezable> の書き込み可能なコピーを作成する方法を次の例に示します。  
+  
+ <xref:System.Windows.Freezable> オブジェクトは、読み取り専用 \("固定"\) としてマークされた後には変更できません。  ただし、<xref:System.Windows.Freezable.Clone%2A> メソッドを使用して、固定されたオブジェクトの変更可能な複製を作成できます。  
+  
+## 使用例  
+ 次の例では、固定された <xref:System.Windows.Media.SolidColorBrush> オブジェクトの変更可能な複製を作成します。  
+  
+ [!code-csharp[freezablesample_procedural#CloneExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/freezablesample_procedural/CSharp/freezablesample.cs#cloneexample)]
+ [!code-vb[freezablesample_procedural#CloneExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/freezablesample_procedural/visualbasic/freezablesample.vb#cloneexample)]  
+  
+ <xref:System.Windows.Freezable> オブジェクトの詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Freezable>   
+ <xref:System.Windows.Freezable.CloneCurrentValue%2A>   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/base-elements-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-open-a-file-that-is-dropped-on-a-richtextbox-control.md b/docs/framework/wpf/advanced/how-to-open-a-file-that-is-dropped-on-a-richtextbox-control.md
new file mode 100644
index 00000000000..103defe5438
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-open-a-file-that-is-dropped-on-a-richtextbox-control.md
@@ -0,0 +1,39 @@
+---
+title: "方法: RichTextBox コントロール上にドロップしたファイルを開く | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ [WPF], 開く (ドロップされたファイルを)"
+  - "ドラッグ アンド ドロップ [WPF], RichTextBox"
+  - "RichTextBox [WPF], ドラッグ アンド ドロップ"
+ms.assetid: 6bb8bb54-f576-41db-a9a7-24102ddeb490
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: RichTextBox コントロール上にドロップしたファイルを開く
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、<xref:System.Windows.Controls.TextBox>、<xref:System.Windows.Controls.RichTextBox>、および <xref:System.Windows.Documents.FlowDocument> のすべてのコントロールにドラッグ アンド ドロップの機能が組み込まれています。  この組み込み機能により、コントロール内およびコントロール間でのテキストのドラッグ アンド ドロップが有効になります。  ただし、コントロールでファイルをドロップしても、そのファイルを開くことはできません。  また、これらのコントロールは、ドラッグ アンド ドロップ イベントを処理済みとしてマークします。  したがって、既定では、独自のイベント ハンドラーを追加して、ドロップしたファイルを開く機能を設定することはできません。  
+  
+ これらのコントロールでドラッグ アンド ドロップ イベントに関するその他の処理ができるようにするには、<xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> メソッドを使用して、ドラッグ アンド ドロップ イベント用のイベント ハンドラーを追加します。  イベント ルート上の他の要素により既に処理済みとしてマークされているルーティング イベントに対し、指定したハンドラーが呼び出されるようにするには、`handledEventsToo` パラメーターを `true` に設定します。  
+  
+> [!TIP]
+>  ドラッグ アンド ドロップ イベントのプレビュー バージョンを処理し、プレビュー イベントを処理済みとしてマークすることにより、<xref:System.Windows.Controls.TextBox>、<xref:System.Windows.Controls.RichTextBox>、および <xref:System.Windows.Documents.FlowDocument> に組み込まれたドラッグ アンド ドロップの機能を置き換えることができます。  ただし、この操作により組み込みのドラッグ アンド ドロップ機能が無効になるので、この操作はお勧めできません。  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Controls.RichTextBox> で <xref:System.Windows.DragDrop.DragOver> イベントおよび <xref:System.Windows.DragDrop.Drop> イベント用のハンドラーを追加する方法を示します。  この例では、<xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> メソッドを使用し、`handledEventsToo` パラメーターを `true` に設定することにより、<xref:System.Windows.Controls.RichTextBox> がこれらのイベントを処理済みとしてマークした場合でも、イベント ハンドラーが呼び出されるようにします。  イベント ハンドラーのコードにより、<xref:System.Windows.Controls.RichTextBox> でドロップしたテキスト ファイルを開く機能が加わります。  
+  
+ この例をテストするには、テキスト ファイルまたはリッチ テキスト形式 \(RTF\) のファイルを、Windows エクスプローラーから <xref:System.Windows.Controls.RichTextBox> にドラッグします。  ファイルが <xref:System.Windows.Controls.RichTextBox> で開きます。  ファイルをドロップする前に Shift キーを押すと、そのファイルはプレーンテキストとして開きます。  
+  
+ [!code-xml[DragDropSnippets#RtbXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml#rtbxaml)]  
+  
+ [!code-csharp[DragDropSnippets#RtbHandlers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/dragdropsnippets/cs/mainwindow.xaml.cs#rtbhandlers)]
+ [!code-vb[DragDropSnippets#RtbHandlers](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/dragdropsnippets/vb/mainwindow.xaml.vb#rtbhandlers)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md b/docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md
new file mode 100644
index 00000000000..9381f084f1e
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 依存関係プロパティのメタデータをオーバーライドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係プロパティ, オーバーライド (メタデータを)"
+  - "メタデータ, オーバーライド (依存関係プロパティの)"
+  - "オーバーライド (依存関係プロパティのメタデータを)"
+ms.assetid: f90f026e-60d8-428a-933d-edf0dba4441f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 依存関係プロパティのメタデータをオーバーライドする
+この例では、継承したクラスの既定の依存関係プロパティのメタデータを、<xref:System.Windows.DependencyProperty.OverrideMetadata%2A> メソッドを呼び出して型固有のメタデータを提供することで、オーバーライドする方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.PropertyMetadata> を定義することにより、クラスで[依存関係プロパティ](GTMT)の動作 \(既定値、プロパティ システム コールバックなど\) を定義できます。  多くの依存関係プロパティ クラスで、登録プロセスの一部として既定のメタデータが既に確立されています。  これには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の一部である依存関係プロパティが含まれます。  クラス継承により依存関係プロパティを継承するクラスは、メタデータで変更できるプロパティの特性がサブクラス固有の要件に合致するように、元のメタデータをオーバーライドできます。  
+  
+ 依存関係プロパティでのメタデータのオーバーライドは、そのプロパティがプロパティ システムによって使用される \(プロパティを登録するオブジェクトの特定のインスタンスがインスタンス化されるタイミングに相当\) 前に実行する必要があります。  <xref:System.Windows.DependencyProperty.OverrideMetadata%2A> の呼び出しは、自身を <xref:System.Windows.DependencyProperty.OverrideMetadata%2A> の `forType` パラメーターとして提供する型の静的なコンストラクター内で実行される必要があります。  所有者型のインスタンスが存在する場合にメタデータを変更しようとすると、例外は発生しませんが、プロパティ システムに不整合な動作が発生します。  また、メタデータは 1 つの型につき 1 回しかオーバーライドできません。  それ以降に同じ型のメタデータをオーバーライドしようとすると、例外が発生します。  
+  
+ 次の例では、`MyAdvancedStateControl` カスタム クラスが、`MyAdvancedStateControl` によって `StateProperty` に提供されるメタデータを、新しいプロパティ メタデータでオーバーライドします。  たとえば、新しく構築された `MyAdvancedStateControl` インスタンスでプロパティが照会されると、`StateProperty` の既定値は `true` となります。  
+  
+ [!code-csharp[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertySystemEsoterics/CSharp/SDKSampleLibrary/class1.cs#mystatecontrol)]
+ [!code-vb[PropertySystemEsoterics#MyStateControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertySystemEsoterics/visualbasic/sdksamplelibrary/class1.vb#mystatecontrol)]  
+[!code-csharp[PropertySystemEsoterics#MyAdvancedStateControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertySystemEsoterics/CSharp/SDKSampleLibrary/class1.cs#myadvancedstatecontrol)]
+[!code-vb[PropertySystemEsoterics#MyAdvancedStateControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertySystemEsoterics/visualbasic/sdksamplelibrary/class1.vb#myadvancedstatecontrol)]  
+  
+## 参照  
+ <xref:System.Windows.DependencyProperty>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/properties-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-override-the-logical-tree.md b/docs/framework/wpf/advanced/how-to-override-the-logical-tree.md
new file mode 100644
index 00000000000..57adaeb88cf
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-override-the-logical-tree.md
@@ -0,0 +1,30 @@
+---
+title: "方法: 論理ツリーをオーバーライドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "論理ツリー, オーバーライド"
+  - "オーバーライド (論理ツリーを)"
+ms.assetid: 0ae4d074-8113-4b06-b4fa-e0f39d4967a6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: 論理ツリーをオーバーライドする
+ほとんどの場合は必要ありませんが、高度なコントロールを作成する場合は、必要に応じて[論理ツリー](GTMT)をオーバーライドできます。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.StackPanel> をサブクラス化して論理ツリーをオーバーライドする方法を次の例に示します。この例では、パネルが子要素を 1 つだけ持つことができ、その子要素だけをレンダリングするという動作を強制的に適用しています。  これは実際的には必ずしも好ましい動作ではありませんが、ここでは要素の通常の論理ツリーをオーバーライドするシナリオを説明するための手段として示します。  
+  
+ [!code-csharp[LogicalOverride#SingletonPanel](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LogicalOverride/CSharp/SDKSampleLibrary/class1.cs#singletonpanel)]  
+  
+ 論理ツリーの詳細については、「[WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md b/docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md
new file mode 100644
index 00000000000..d9f6dfae4dc
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : XPS ファイルをプログラムにより印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "印刷 (XPS ファイルをプログラムで)"
+  - "XPS ファイル, 印刷 (プログラムで)"
+ms.assetid: 0b1c0a3f-b19e-43d6-bcc9-eb3ec4e555ad
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : XPS ファイルをプログラムにより印刷する
+<xref:System.Printing.PrintQueue.AddJob%2A> メソッドの 1 つのオーバーロードを使用すると、<xref:System.Windows.Controls.PrintDialog> や、原則としてはその他の[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を一切開くことなく、[!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ファイルを印刷することができます。  
+  
+ また、<xref:System.Windows.Xps.XpsDocumentWriter> の多くの <xref:System.Windows.Xps.XpsDocumentWriter.Write%2A> メソッドや <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A> メソッドを使用して、[!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ファイルを印刷することもできます。  この詳細については、「[Printing an XPS Document](http://msdn.microsoft.com/ja-jp/849555c8-0c4e-48c0-86bc-a5494c69b36c)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] の印刷は、<xref:System.Windows.Controls.PrintDialog> コントロールの <xref:System.Windows.Controls.PrintDialog.PrintDocument%2A> メソッドまたは <xref:System.Windows.Controls.PrintDialog.PrintVisual%2A> メソッドを使用しても実行できます。  「[印刷ダイアログ ボックスを呼び出す](../../../../docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md)」を参照してください。  
+  
+## 使用例  
+ 3 つのパラメーターをとる <xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> メソッドを使用する主な手順は次のとおりです。  詳細は、下記の例に示します。  
+  
+1.  プリンターが XPSDrv プリンターであるかどうかを確認します   \(XPSDrv の詳細については、「[印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)」を参照してください\)。  
+  
+2.  プリンターが XPSDrv プリンターでない場合は、スレッドのアパートメントをシングル スレッドに設定します。  
+  
+3.  プリント サーバーと印刷キューのオブジェクトをインスタンス化します。  
+  
+4.  ジョブ名、印刷するファイル、およびプリンターが XPSDrv プリンターであるかどうかを示す <xref:System.Boolean> フラグを指定して、メソッドを呼び出します。  
+  
+ ディレクトリ内のすべての [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ファイルをバッチ印刷する方法を次の例に示します。  アプリケーションはユーザーにディレクトリの指定を求めますが、3 つのパラメーターをとる <xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> メソッドは[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を必要としません。  このメソッドは、そのメソッドに渡すことができる [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ファイル名とパスが記述された任意のコード パスで使用できます。  
+  
+ <xref:System.Printing.PrintQueue.AddJob%2A> の 3 つのパラメーターをとる <xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> オーバーロードは、<xref:System.Boolean> パラメーターが `false` の場合 \(XPSDrv 以外のプリンターが使用されている場合\) は必ずシングル スレッドで実行する必要があります。  ただし、[!INCLUDE[TLA#tla_net](../../../../includes/tlasharptla-net-md.md)] の既定のアパートメントの状態は、マルチ スレッドです。  この例では XPSDrv 以外のプリンターを前提にしているため、この既定の状態を逆にする必要があります。  
+  
+ 既定の状態を変更する方法は 2 つあります。  1 つは、単純に <xref:System.STAThreadAttribute> \(つまり "`[System.STAThreadAttribute()]`"\) をアプリケーションの `Main` メソッド \(通常は "`static void Main(string[] args)`"\) のすぐ上に追加する方法です。  ただし、多くのアプリケーションは、`Main` メソッドのアパートメントの状態がマルチ スレッドであることを必要とするため、もう 1 つの方法が用意されています。それは、<xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> の呼び出しを、そのアパートメントの状態が <xref:System.Threading.Thread.SetApartmentState%2A> で <xref:System.Threading.ApartmentState> に設定されている個別のスレッドで行う方法です。  次に示す例では、この 2 番目の方法を使用します。  
+  
+ したがって、この例では、最初に <xref:System.Threading.Thread> オブジェクトをインスタンス化し、そのオブジェクトを **PrintXPS** メソッドに <xref:System.Threading.ThreadStart> パラメーターとして渡します   \(**PrintXPS** メソッドは例の後半で定義されます\)。次に、そのスレッドをシングル スレッド アパートメントに設定します。  それ以降の `Main` メソッドのコードでは、この新しいスレッドを開始します。  
+  
+ この例の要点は、`static` **BatchXPSPrinter.PrintXPS** メソッド内にあります。  プリント サーバーとキューを作成した後、このメソッドによって、[!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ファイルを含むディレクトリの指定を求めるプロンプトが表示されます。  ディレクトリの有無と、そのディレクトリに \*.xps ファイルがあるかどうかを確認した後に、各ファイルが印刷キューに追加されます。  この例では、プリンターが XPSDrv 以外のプリンターであることが前提になっているため、<xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> メソッドの最後のパラメーターに `false` を渡しています。  このため、このメソッドはファイル内の [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] マークアップを検証してから、そのマークアップをプリンターのページ記述言語に変換しようとします。  検証に失敗すると、例外がスローされます。  このコード例では、その例外をキャッチし、ユーザーに例外の発生を通知してから、次の [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ファイルの処理に進みます。  
+  
+ [!code-csharp[BatchPrintXPSFiles#BatchPrintXPSFiles](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BatchPrintXPSFiles/CSharp/Program.cs#batchprintxpsfiles)]
+ [!code-vb[BatchPrintXPSFiles#BatchPrintXPSFiles](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BatchPrintXPSFiles/visualbasic/program.vb#batchprintxpsfiles)]  
+  
+ XPSDrv プリンターを使用している場合は、最後のパラメーターを `true` に設定できます。  その場合、[!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] はプリンターのページ記述言語であるため、メソッドはファイルの検証や別のページ記述言語への変換を行わずにファイルをプリンターに送ります。  アプリケーションが XPSDrv プリンターを使用するかどうかがデザイン時に不明な場合は、<xref:System.Printing.PrintQueue.IsXpsDevice%2A> プロパティを読み込んで、その検出内容に従って分岐するようにアプリケーションを変更できます。  
+  
+ [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] および [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] のリリースの直後には XPSDrv プリンターの普及率が低いことが想定されるため、場合によっては、XPSDrv プリンターではないプリンターを XPSDrv プリンターに見せかける必要があります。  そのためには、アプリケーションを実行しているコンピューターで、以下のレジストリ キーのファイルの一覧に Pipelineconfig.xml を追加します。  
+  
+ HKEY\_LOCAL\_MACHINE\\SYSTEM\\CurrentControlSet\\Control\\Print\\Environments\\Windows NT x86\\Drivers\\Version\-3\\*\<PseudoXPSPrinter\>*\\DependentFiles  
+  
+ *\<PseudoXPSPrinter\>* は任意の印刷キューです。  変更後に、コンピューターを再起動する必要があります。  
+  
+ このように見せかけることで、例外を発生させることなく、<xref:System.Printing.PrintQueue.AddJob%28System.String%2CSystem.String%2CSystem.Boolean%29> の最後のパラメーターとして `true` を渡すことができますが、*\<PseudoXPSPrinter\>* は実際には XPSDrv プリンターではないため、正しく印刷されません。  
+  
+ **メモ** 上記の例では、単純化のため、\*.xps 拡張子の有無でファイルが [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] かどうかを確認していますが、  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ファイルには、この拡張子を付ける必要はありません。  [isXPS.exe \(isXPS 適合性ツール\)](../Topic/isXPS.exe%20\(isXPS%20Conformance%20Tool\).md)は、ファイルが [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] かどうかをテストする 1 つの手段です。  
+  
+## 参照  
+ <xref:System.Printing.PrintQueue>   
+ <xref:System.Printing.PrintQueue.AddJob%2A>   
+ <xref:System.Threading.ApartmentState>   
+ <xref:System.STAThreadAttribute>   
+ [XPS \(XPS\)](http://www.microsoft.com/japan/whdc/xps/default.mspx)   
+ [Printing an XPS Document](http://msdn.microsoft.com/ja-jp/849555c8-0c4e-48c0-86bc-a5494c69b36c)   
+ [Managed and Unmanaged Threading](http://msdn.microsoft.com/ja-jp/db425c20-4b2f-4433-bf96-76071c7881e5)   
+ [isXPS.exe \(isXPS 適合性ツール\)](../Topic/isXPS.exe%20\(isXPS%20Conformance%20Tool\).md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-recognize-application-gestures.md b/docs/framework/wpf/advanced/how-to-recognize-application-gestures.md
new file mode 100644
index 00000000000..bd796465c2f
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-recognize-application-gestures.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : アプリケーション ジェスチャを認識する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ジェスチャ, 認識"
+  - "ジェスチャ, 認識"
+ms.assetid: d58b740f-5192-4a3e-af59-7aa162e6ca15
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : アプリケーション ジェスチャを認識する
+ユーザーが <xref:System.Windows.Controls.InkCanvas> で <xref:System.Windows.Ink.ApplicationGesture> ジェスチャを作成した場合に、インクを消去する方法を次の例に示します。  この例では、`inkCanvas1` という名前の <xref:System.Windows.Controls.InkCanvas> が、XAML ファイル内で宣言されていることを前提としています。  
+  
+## 使用例  
+ [!code-csharp[HowToRecognizeGestures#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToRecognizeGestures/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[HowToRecognizeGestures#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToRecognizeGestures/VisualBasic/Window1.xaml.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Ink.ApplicationGesture>   
+ <xref:System.Windows.Controls.InkCanvas>   
+ <xref:System.Windows.Controls.InkCanvas.Gesture>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-register-an-attached-property.md b/docs/framework/wpf/advanced/how-to-register-an-attached-property.md
new file mode 100644
index 00000000000..9eb6b821c7f
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-register-an-attached-property.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 添付プロパティを登録する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付プロパティ, 登録"
+  - "登録 (添付プロパティを)"
+ms.assetid: eb47bd94-0451-4f8d-8fb6-95f7812ac05b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 添付プロパティを登録する
+この例では、[添付プロパティ](GTMT)を登録する方法、および [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] とコードの両方でプロパティを使用できるようにパブリック アクセサーを提供する方法を示します。  添付プロパティは、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で定義されている構文の概念です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の型のほとんどの添付プロパティは、[依存関係プロパティ](GTMT)としても実装されます。  任意の <xref:System.Windows.DependencyObject> 型で[依存関係プロパティ](GTMT)を使用できます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.DependencyProperty.RegisterAttached%2A> メソッドを使用して添付プロパティを依存関係プロパティとして登録する方法を示します。  プロバイダー クラスは、プロパティの既定のメタデータを提供するオプションを持っています。この既定値は、別のクラスに対してプロパティが使用されるときに適用されます \(そのクラスがメタデータをオーバーライドしない場合\)。  この例では、`IsBubbleSource` プロパティの既定値は `false` に設定されています。  
+  
+ 添付プロパティ \(依存関係プロパティとして登録されていなくても\) のプロバイダー クラスは、`Set`*\[AttachedPropertyName\]* および `Get`*\[AttachedPropertyName\]* の名前付け規則に従う静的な get および set アクセサーを提供する必要があります。これらのアクセサーは、機能している [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リーダーがプロパティを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の属性として認識し、適切な型を解決できるために必要です。  
+  
+ [!code-csharp[WPFAquariumSln#RegisterAttachedBubbler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#registerattachedbubbler)]
+ [!code-vb[WPFAquariumSln#RegisterAttachedBubbler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#registerattachedbubbler)]  
+  
+## 参照  
+ <xref:System.Windows.DependencyProperty>   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/properties-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-remotely-survey-the-status-of-printers.md b/docs/framework/wpf/advanced/how-to-remotely-survey-the-status-of-printers.md
new file mode 100644
index 00000000000..ae02bc59311
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-remotely-survey-the-status-of-printers.md
@@ -0,0 +1,92 @@
+---
+title: "方法 : プリンターのステータスをリモート操作で調査する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プリンターのステータス, 調査 (リモート操作で)"
+  - "リモート操作で調査 (プリンターのステータスを)"
+  - "ステータス, プリンター, 調査 (リモート操作で)"
+  - "調査 (プリンターのステータスをリモート操作で)"
+ms.assetid: d6324759-8292-4c23-9584-9c708887dc94
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : プリンターのステータスをリモート操作で調査する
+中企業および大企業では、任意の時点において、紙詰まりや用紙切れなどの問題が発生したために動作していないプリンターが複数存在する場合があります。  [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] の [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] で公開されているさまざまなプリンター プロパティには、プリンターの状態を迅速に調査する手段が用意されています。  
+  
+## 使用例  
+ このようなユーティリティを作成する主な手順は次のとおりです。  
+  
+1.  すべてのプリント サーバーのリストを取得します。  
+  
+2.  印刷キューを照会するためにサーバーをループします。  
+  
+3.  サーバー ループの各パス内で、すべてのサーバーのキューをループし、キューが現在動作していないことを示している各プロパティを読み取ります。  
+  
+ 一連のスニペットを次のコードに示します。  この例では、単純化のため、CRLF で区切られたプリント サーバーのリストがあると想定します。  `fileOfPrintServers` 変数は、このファイルの <xref:System.IO.StreamReader> オブジェクトです。  各サーバー名はそれぞれ独自の行に含まれているため、<xref:System.IO.StreamReader.ReadLine%2A> を呼び出すと、次のサーバーの名前が取得され、<xref:System.IO.StreamReader> のカーソルが次の行の先頭に移動します。  
+  
+ このコードは、外側のループ内で、最新のプリント サーバーの <xref:System.Printing.PrintServer> オブジェクトを作成し、アプリケーションがサーバーに対する管理権限を持つことを指定します。  
+  
+> [!NOTE]
+>  サーバーが多数存在する場合は、必要なプロパティのみを初期化する [PrintServer\(String, String\<xref:System.Printing.PrintServer.%23ctor%28System.String%2CSystem.String%5B%5D%2CSystem.Printing.PrintSystemDesiredAccess%29> コンストラクターを使用することで、パフォーマンスを向上させることができます。  
+  
+ この例では、次に <xref:System.Printing.PrintServer.GetPrintQueues%2A> を使用してサーバーのすべてのキューのコレクションを作成し、これらのキューのループを開始します。  この内側のループには、プリンターのステータスを確認する 2 つの方法に対応する分岐構造が含まれています。  
+  
+-   <xref:System.Printing.PrintQueueStatus> 型の <xref:System.Printing.PrintQueue.QueueStatus%2A> プロパティのフラグを読み取ることができる。  
+  
+-   <xref:System.Printing.PrintQueue.IsOutOfPaper%2A> や <xref:System.Printing.PrintQueue.IsPaperJammed%2A> などの各関連プロパティを読み取ることができる。  
+  
+ この例では両方の方法を示すため、ユーザーは使用する方法に関して入力を求められ、<xref:System.Printing.PrintQueue.QueueStatus%2A> プロパティのフラグを使用する場合は「y」と応答しています。  2 つの方法の詳細については、以下を参照してください。  
+  
+ 最後に、結果をユーザーに表示します。  
+  
+ [!code-cpp[PrinterStatusSurvey#SurveyQueues](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PrinterStatusSurvey/CPP/Program.cpp#surveyqueues)]
+ [!code-csharp[PrinterStatusSurvey#SurveyQueues](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrinterStatusSurvey/CSharp/Program.cs#surveyqueues)]
+ [!code-vb[PrinterStatusSurvey#SurveyQueues](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrinterStatusSurvey/visualbasic/program.vb#surveyqueues)]  
+  
+ <xref:System.Printing.PrintQueue.QueueStatus%2A> プロパティのフラグを使用してプリンターのステータスを確認するには、各関連フラグが設定されているかどうかを確認します。  1 ビットがビット フラグ セットで設定されているかどうかを確認するには、通常、フラグ セットを 1 つのオペランドとし、フラグ自体をもう 1 つのオペランドとして、論理 AND 演算を行います。  フラグ自体には 1 ビットのみが設定されているため、論理 AND を実行すると、最大でもその同じビットが設定されます。  該当するかどうかを確認するには、論理 AND の結果とフラグ自体を比較します。  詳細については、<xref:System.Printing.PrintQueueStatus>、[& 演算子 \(C\# リファレンス\)](../Topic/&%20Operator%20\(C%23%20Reference\).md)、および <xref:System.FlagsAttribute> のトピックを参照してください。  
+  
+ 次のコードでは、ビットが設定されている属性ごとに、ユーザーに表示される最終レポートに警告を追加します   \(コードの最後で呼び出している **ReportAvailabilityAtThisTime** メソッドについては以下で説明します\)。  
+  
+ [!code-cpp[PrinterStatusSurvey#SpotTroubleUsingQueueAttributes](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PrinterStatusSurvey/CPP/Program.cpp#spottroubleusingqueueattributes)]
+ [!code-csharp[PrinterStatusSurvey#SpotTroubleUsingQueueAttributes](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrinterStatusSurvey/CSharp/Program.cs#spottroubleusingqueueattributes)]
+ [!code-vb[PrinterStatusSurvey#SpotTroubleUsingQueueAttributes](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrinterStatusSurvey/visualbasic/program.vb#spottroubleusingqueueattributes)]  
+  
+ 各プロパティを使用してプリンターのステータスを確認するには、各プロパティを読み取り、プロパティが `true` の場合にユーザーに表示される最終レポートに警告を追加するだけです   \(コードの最後で呼び出している **ReportAvailabilityAtThisTime** メソッドについては以下で説明します\)。  
+  
+ [!code-cpp[PrinterStatusSurvey#SpotTroubleUsingQueueProperties](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PrinterStatusSurvey/CPP/Program.cpp#spottroubleusingqueueproperties)]
+ [!code-csharp[PrinterStatusSurvey#SpotTroubleUsingQueueProperties](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrinterStatusSurvey/CSharp/Program.cs#spottroubleusingqueueproperties)]
+ [!code-vb[PrinterStatusSurvey#SpotTroubleUsingQueueProperties](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrinterStatusSurvey/visualbasic/program.vb#spottroubleusingqueueproperties)]  
+  
+ **ReportAvailabilityAtThisTime** メソッドは、現在の時刻にキューが使用可能かどうかを確認する必要がある場合に備えて作成されたものです。  
+  
+ <xref:System.Printing.PrintQueue.StartTimeOfDay%2A> プロパティと <xref:System.Printing.PrintQueue.UntilTimeOfDay%2A> プロパティが等しい場合、このメソッドは何も実行しません。なぜなら、その場合、プリンターは常に使用可能だからです。  それぞれのプロパティが異なる場合、このメソッドは現在の時刻を取得します。次に、この時刻を午前 0 時からの合計分数に変換する必要があります。これは、<xref:System.Printing.PrintQueue.StartTimeOfDay%2A> プロパティと <xref:System.Printing.PrintQueue.UntilTimeOfDay%2A> プロパティが <xref:System.DateTime> オブジェクトではなく、午前 0 時以降の分数を表す <xref:System.Int32> であるためです。  最後に、このメソッドは、現在の時刻が開始時刻と "終了" 時刻の間であるかどうかを確認します。  
+  
+ [!code-cpp[PrinterStatusSurvey#UsingStartAndUntilTimes](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PrinterStatusSurvey/CPP/Program.cpp#usingstartanduntiltimes)]
+ [!code-csharp[PrinterStatusSurvey#UsingStartAndUntilTimes](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrinterStatusSurvey/CSharp/Program.cs#usingstartanduntiltimes)]
+ [!code-vb[PrinterStatusSurvey#UsingStartAndUntilTimes](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrinterStatusSurvey/visualbasic/program.vb#usingstartanduntiltimes)]  
+  
+## 参照  
+ <xref:System.Printing.PrintQueue.StartTimeOfDay%2A>   
+ <xref:System.Printing.PrintQueue.UntilTimeOfDay%2A>   
+ <xref:System.DateTime>   
+ <xref:System.Printing.PrintQueueStatus>   
+ <xref:System.FlagsAttribute>   
+ <xref:System.Printing.PrintServer.GetPrintQueues%2A>   
+ <xref:System.Printing.PrintServer>   
+ <xref:System.Printing.LocalPrintServer>   
+ <xref:System.Printing.EnumeratedPrintQueueTypes>   
+ <xref:System.Printing.PrintQueue>   
+ [& 演算子 \(C\# リファレンス\)](../Topic/&%20Operator%20\(C%23%20Reference\).md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-retrieve-data-in-a-particular-data-format.md b/docs/framework/wpf/advanced/how-to-retrieve-data-in-a-particular-data-format.md
new file mode 100644
index 00000000000..0f883457d47
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-retrieve-data-in-a-particular-data-format.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 特定のデータ形式でデータを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataFormats クラス [WPF], 取得 (データを)"
+  - "DataObject クラス [WPF], 取得 (データを)"
+  - "ドラッグ アンド ドロップ [WPF], 取得 (データを)"
+ms.assetid: a625acf3-1144-44cd-add7-456aefc3859f
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 特定のデータ形式でデータを取得する
+指定された形式でデータ オブジェクトからデータを取得する方法を次の例に示します。  
+  
+## 例  
+  
+### Description  
+ 次のコード例では、<xref:System.Windows.DataObject.GetDataPresent%28System.String%29> オーバーロードを使用して、指定したデータ形式が \(ネイティブで、または自動変換により\) 使用可能かどうかを最初に確認します。指定した形式が使用可能な場合は、<xref:System.Windows.DataObject.GetData%28System.String%29> メソッドを使用してデータを取得します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getspecificdataformat)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getspecificdataformat)]  
+  
+## 例  
+  
+### Description  
+ 次のコード例では、<xref:System.Windows.DataObject.GetDataPresent%28System.String%2CSystem.Boolean%29> オーバーロードを使用して、指定したデータ形式がネイティブで使用可能かどうか \(自動変換可能なデータ形式はフィルター処理されます\) を最初に確認します。指定した形式が使用可能な場合は、<xref:System.Windows.DataObject.GetData%28System.String%29> メソッドを使用してデータを取得します。  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat_Native](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_getspecificdataformat_native)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_GetSpecificDataFormat_Native](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_getspecificdataformat_native)]  
+  
+## 参照  
+ <xref:System.Windows.IDataObject>   
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-rotate-ink.md b/docs/framework/wpf/advanced/how-to-rotate-ink.md
new file mode 100644
index 00000000000..544216e19f5
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-rotate-ink.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : インクを回転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インク, 回転"
+  - "回転 (インクを)"
+ms.assetid: fac36cc9-dd01-41ca-9bde-9d33e3790bbe
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : インクを回転させる
+## 使用例  
+ <xref:System.Windows.Controls.InkCanvas> から <xref:System.Windows.Controls.InkPresenter> を含む <xref:System.Windows.Controls.Canvas> へインクをコピーする例を次に示します。  アプリケーションはインクをコピーするときに、インクを時計回りに 90 度回転させます。  
+  
+ [!code-xml[HowToRotateInk#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToRotateInk/CSharp/Window1.xaml#1)]  
+  
+ [!code-csharp[HowToRotateInk#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToRotateInk/CSharp/Window1.xaml.cs#2)]  
+  
+## 使用例  
+ <xref:System.Windows.Controls.InkPresenter> 上のストロークを回転させるカスタム <xref:System.Windows.Documents.Adorner> を次の例に示します。  
+  
+ [!code-csharp[AdornerForStrokes#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornerForStrokes/CSharp/RotatingAdornerForStrokes.cs#1)]
+ [!code-vb[AdornerForStrokes#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornerForStrokes/VisualBasic/RotatingAdornerForStrokes.vb#1)]  
+  
+ 次の例は、<xref:System.Windows.Controls.InkPresenter> を定義してインクを挿入する [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルです。  `Window_Loaded` イベント ハンドラーは、カスタム装飾を <xref:System.Windows.Controls.InkPresenter> に追加します。  
+  
+ [!code-xml[AdornerForStrokes#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornerForStrokes/CSharp/Window1.xaml#2)]  
+  
+ [!code-csharp[AdornerForStrokes#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornerForStrokes/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[AdornerForStrokes#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornerForStrokes/VisualBasic/Window1.xaml.vb#3)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-select-ink-from-a-custom-control.md b/docs/framework/wpf/advanced/how-to-select-ink-from-a-custom-control.md
new file mode 100644
index 00000000000..ee412ea9b58
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-select-ink-from-a-custom-control.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : カスタム コントロールからインクを選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, インクの選択"
+  - "カスタム コントロール, インクの選択"
+  - "インク, 選択 (カスタム コントロールから)"
+ms.assetid: 5f3a45c6-6d40-4017-9b47-933f134ceba3
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : カスタム コントロールからインクを選択する
+<xref:System.Windows.Ink.IncrementalLassoHitTester> をカスタム コントロールに追加することで、<xref:System.Windows.Controls.InkCanvas> がなげなわを使用してインクを選択するのと同様に、ユーザーがなげなわツールを使用してインクを選択できるようにコントロールを有効にすることができます。  
+  
+ この例は、インク対応カスタム コントロールの作成に精通していることを前提としています。  インク入力対応のカスタム コントロールを作成するには、「[インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)」を参照してください。  
+  
+## 使用例  
+ ユーザーがなげなわを描画すると、<xref:System.Windows.Ink.IncrementalLassoHitTester> は、ユーザーがなげなわを完了したときに、どのストロークがなげなわのパスの境界内に入っているかを予測します。  なげなわのパスの境界内に入っていることが特定されたストロークは、選択されているものと考えることができます。  また、選択されたストロークは、選択解除される場合もあります。  たとえば、ユーザーがなげなわを描画しながら方向を反転させた場合、<xref:System.Windows.Ink.IncrementalLassoHitTester> は、一部のストロークを選択解除します。  
+  
+ <xref:System.Windows.Ink.IncrementalLassoHitTester> は <xref:System.Windows.Ink.IncrementalLassoHitTester.SelectionChanged> イベントを発生させ、ユーザーがなげなわを描画している間でも、カスタム コントロールが応答できるようにします。  たとえば、ユーザーの選択および選択解除に合わせて、ストロークの外観を変更することができます。  
+  
+## インク モードの管理  
+ コントロール上でなげなわとインクが異なって表示されると、ユーザーにとって便利です。  これを実現するには、ユーザーがインクを書き込んでいるのか選択しているのかを、カスタム コントロールが追跡する必要があります。  このような動作を実行する最も簡単な方法は、2 つの値を持つ列挙体を宣言することです。1 つはユーザーがインクを書き込んでいることを示し、もう 1 つはユーザーがインクを選択していることを示します。  
+  
+ [!code-csharp[HowToSelectInk#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#2)]
+ [!code-vb[HowToSelectInk#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#2)]  
+  
+ 次に、2 つの <xref:System.Windows.Ink.DrawingAttributes> をクラスに追加します。1 つはユーザーがインクを書き込んでいる場合に使用し、もう 1 つはユーザーがインクを選択している場合に使用します。  コンストラクターで <xref:System.Windows.Ink.DrawingAttributes> を初期化し、両方の <xref:System.Windows.Ink.DrawingAttributes.AttributeChanged> イベントを同じイベント ハンドラーに結合します。  次に、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.DrawingAttributes%2A> プロパティを、インクの <xref:System.Windows.Ink.DrawingAttributes> に設定します。  
+  
+ [!code-csharp[HowToSelectInk#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#3)]
+ [!code-vb[HowToSelectInk#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#3)]  
+[!code-csharp[HowToSelectInk#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#4)]
+[!code-vb[HowToSelectInk#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#4)]  
+  
+ 選択モードを公開するプロパティを追加します。  ユーザーが選択モードを変更したら、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> の <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.DrawingAttributes%2A> プロパティを適切な <xref:System.Windows.Ink.DrawingAttributes> オブジェクトに設定し、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.RootVisual%2A> プロパティを <xref:System.Windows.Controls.InkPresenter> に再度結び付けます。  
+  
+ [!code-csharp[HowToSelectInk#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#5)]
+ [!code-vb[HowToSelectInk#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#5)]  
+  
+ <xref:System.Windows.Ink.DrawingAttributes> をプロパティとして公開し、アプリケーションがインク ストロークおよび選択ストロークの外観を決定できるようにします。  
+  
+ [!code-csharp[HowToSelectInk#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#6)]
+ [!code-vb[HowToSelectInk#6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#6)]  
+  
+ <xref:System.Windows.Ink.DrawingAttributes> オブジェクトのプロパティが変更された場合は、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.RootVisual%2A> を <xref:System.Windows.Controls.InkPresenter> に再度結び付ける必要があります。  <xref:System.Windows.Ink.DrawingAttributes.AttributeChanged> イベントのイベント ハンドラーで、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer.RootVisual%2A> を <xref:System.Windows.Controls.InkPresenter> に再度結び付けます。  
+  
+ [!code-csharp[HowToSelectInk#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#7)]
+ [!code-vb[HowToSelectInk#7](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#7)]  
+  
+## IncrementalLassoHitTester の使用  
+ 選択されたストロークを含む <xref:System.Windows.Ink.StrokeCollection> を作成および初期化します。  
+  
+ [!code-csharp[HowToSelectInk#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#8)]
+ [!code-vb[HowToSelectInk#8](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#8)]  
+  
+ ユーザーが、インクまたはなげなわのいずれかのストロークの描画を開始したら、選択されている任意のストロークを選択解除します。  次に、ユーザーがなげなわを描画している場合は、<xref:System.Windows.Ink.StrokeCollection.GetIncrementalLassoHitTester%2A> を呼び出して <xref:System.Windows.Ink.IncrementalLassoHitTester> を作成し、<xref:System.Windows.Ink.IncrementalLassoHitTester.SelectionChanged> イベントにサブスクライブして、<xref:System.Windows.Ink.IncrementalHitTester.AddPoints%2A> を呼び出します。  このコードは独立したメソッドとして、<xref:System.Windows.UIElement.OnStylusDown%2A> および <xref:System.Windows.UIElement.OnMouseDown%2A> メソッドから呼び出すことができます。  
+  
+ [!code-csharp[HowToSelectInk#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#9)]
+ [!code-vb[HowToSelectInk#9](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#9)]  
+  
+ ユーザーがなげなわを描画している間に、スタイラス ポイントを <xref:System.Windows.Ink.IncrementalLassoHitTester> に追加します。  次のメソッドを、<xref:System.Windows.UIElement.OnStylusMove%2A>、<xref:System.Windows.UIElement.OnStylusUp%2A>、<xref:System.Windows.UIElement.OnMouseMove%2A>、<xref:System.Windows.UIElement.OnMouseLeftButtonUp%2A> の各メソッドから呼び出します。  
+  
+ [!code-csharp[HowToSelectInk#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#10)]
+ [!code-vb[HowToSelectInk#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#10)]  
+  
+ ユーザーがストロークを選択および選択解除したときに、<xref:System.Windows.Ink.IncrementalLassoHitTester.SelectionChanged?displayProperty=fullName> イベントを処理して応答します。  <xref:System.Windows.Ink.LassoSelectionChangedEventArgs> クラスには <xref:System.Windows.Ink.LassoSelectionChangedEventArgs.SelectedStrokes%2A> および <xref:System.Windows.Ink.LassoSelectionChangedEventArgs.DeselectedStrokes%2A> プロパティが用意されており、それぞれ選択および選択解除されたストロークを取得します。  
+  
+ [!code-csharp[HowToSelectInk#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#11)]
+ [!code-vb[HowToSelectInk#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#11)]  
+  
+ ユーザーがなげなわの描画を完了したら、<xref:System.Windows.Ink.IncrementalLassoHitTester.SelectionChanged> イベントからサブスクライブを解除し、<xref:System.Windows.Ink.IncrementalHitTester.EndHitTesting%2A> を呼び出します。  
+  
+ [!code-csharp[HowToSelectInk#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#12)]
+ [!code-vb[HowToSelectInk#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#12)]  
+  
+## すべての要素を取り入れる  
+ 次の例は、ユーザーがなげなわを使用してインクを選択できるようにするカスタム コントロールを示しています。  
+  
+ [!code-csharp[HowToSelectInk#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToSelectInk/CSharp/InkSelector.cs#1)]
+ [!code-vb[HowToSelectInk#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToSelectInk/VisualBasic/InkSelector.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Ink.IncrementalLassoHitTester>   
+ <xref:System.Windows.Ink.StrokeCollection>   
+ <xref:System.Windows.Input.StylusPointCollection>   
+ [インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-set-margins-of-elements-and-controls.md b/docs/framework/wpf/advanced/how-to-set-margins-of-elements-and-controls.md
new file mode 100644
index 00000000000..17385cb13c7
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-set-margins-of-elements-and-controls.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : 要素およびコントロールのマージンを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Margin プロパティ, 設定"
+  - "プロパティ, Margin プロパティ"
+  - "設定, Margin プロパティ"
+ms.assetid: 70ebee01-6f87-4352-8dd4-402c65eaaed6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 要素およびコントロールのマージンを設定する
+この例では、分離コードでマージンに関する既存のプロパティ値を変更することで、<xref:System.Windows.FrameworkElement.Margin%2A> プロパティを設定する方法を説明します。  <xref:System.Windows.FrameworkElement.Margin%2A> プロパティは <xref:System.Windows.FrameworkElement> 基本要素のプロパティであるため、各種コントロールやその他の要素によって継承されます。  
+  
+ この例は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で記述され、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] が参照する分離コード ファイルを使用して作成されています。  分離コードは、[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] と [!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] の両方のバージョンで示されています。  
+  
+## 使用例  
+ [!code-xml[FEMarginProgrammatic#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEMarginProgrammatic/CSharp/default.xaml#xaml)]  
+  
+ [!code-csharp[FEMarginProgrammatic#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEMarginProgrammatic/CSharp/default.xaml.cs#handler)]
+ [!code-vb[FEMarginProgrammatic#Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FEMarginProgrammatic/VisualBasic/default.xaml.vb#handler)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md b/docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md
new file mode 100644
index 00000000000..8b866cb5c0b
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md
@@ -0,0 +1,45 @@
+---
+title: "方法: ハイパーリンクに下線を引くかどうかを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, TextDecoration"
+  - "ハイパーリンク コントロール型"
+  - "TextDecoration クラス"
+ms.assetid: 3996cfe6-1dac-4835-aeb3-c719ce9cfee5
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: ハイパーリンクに下線を引くかどうかを指定する
+<xref:System.Windows.Documents.Hyperlink> オブジェクトはインラインレベルのフロー コンテンツ要素であり、これを使用すると、フロー コンテンツ内でハイパーリンクをホストできます。  既定では、<xref:System.Windows.Documents.Hyperlink> は、下線を表示するために、<xref:System.Windows.TextDecoration> オブジェクトを使用します。  <xref:System.Windows.TextDecoration> オブジェクトは、インスタンス化するために、パフォーマンスに大きな負荷をかけることがあります。特に、多数の <xref:System.Windows.Documents.Hyperlink> オブジェクトを使用する場合には、大きな負荷をかけます。  <xref:System.Windows.Documents.Hyperlink> 要素を広く使用する場合は、<xref:System.Windows.ContentElement.MouseEnter> イベントのようなイベントが発生したときにだけ下線を表示することを、検討する必要があります。  
+  
+ 次の例では、"My MSN" リンクの下線は動的であり、<xref:System.Windows.ContentElement.MouseEnter> イベントが発生したときにのみ表示されます。  
+  
+ ![TextDecorations を表示するハイパーリンク](../../../../docs/framework/wpf/advanced/media/textdecoration03.png "TextDecoration03")  
+TextDecorations が定義されたハイパーリンク  
+  
+## 使用例  
+ 下線付きおよび下線なしで定義されている <xref:System.Windows.Documents.Hyperlink> のマークアップのサンプルを次に示します。  
+  
+ [!code-xml[Performance#PerformanceSnippet11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Hyperlink.xaml#performancesnippet11)]  
+  
+ 次のコード サンプルでは、<xref:System.Windows.Documents.Hyperlink> の下線を <xref:System.Windows.ContentElement.MouseEnter> イベントで表示し、<xref:System.Windows.ContentElement.MouseLeave> イベントで消去する方法を示します。  
+  
+ [!code-csharp[Performance#PerformanceSnippet15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Hyperlink.xaml.cs#performancesnippet15)]
+ [!code-vb[Performance#PerformanceSnippet15](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/hyperlink.xaml.vb#performancesnippet15)]  
+  
+## 参照  
+ <xref:System.Windows.TextDecoration>   
+ <xref:System.Windows.Documents.Hyperlink>   
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [文字の装飾を作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-text-decoration.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-store-multiple-data-formats-in-a-data-object.md b/docs/framework/wpf/advanced/how-to-store-multiple-data-formats-in-a-data-object.md
new file mode 100644
index 00000000000..73a3bd4d7af
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-store-multiple-data-formats-in-a-data-object.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : データ オブジェクトへ複数のデータ形式を格納する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataFormats クラス [WPF], 格納 (複数の形式を)"
+  - "DataObject クラス [WPF], 格納 (複数の形式を)"
+  - "ドラッグ アンド ドロップ [WPF], 格納 (複数の形式を)"
+ms.assetid: 941ace29-29c4-4c26-b75b-ea7d06aa0d69
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : データ オブジェクトへ複数のデータ形式を格納する
+次の例は、<xref:System.Windows.DataObject.SetData%28System.String%2CSystem.Object%29> メソッドを使用してデータを複数の形式のデータ オブジェクトに追加する方法を示しています。  
+  
+## 例  
+  
+### Description  
+  
+### コード  
+ [!code-csharp[DragDrop_DragDropMiscCode#_DragDrop_StoreMultipleFormats](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/CSharp/Window1.xaml.cs#_dragdrop_storemultipleformats)]
+ [!code-vb[DragDrop_DragDropMiscCode#_DragDrop_StoreMultipleFormats](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDrop_DragDropMiscCode/visualbasic/window1.xaml.vb#_dragdrop_storemultipleformats)]  
+  
+## 参照  
+ <xref:System.Windows.IDataObject>   
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md b/docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md
new file mode 100644
index 00000000000..f294a28f710
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : 自動レイアウト用のグリッドを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "自動レイアウト, グリッドの使用"
+  - "グリッド, 自動レイアウト"
+ms.assetid: ab9de407-e0c1-4047-bdf0-24951bf73879
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 自動レイアウト用のグリッドを使用する
+この例では、自動レイアウトの方法でグリッドを使用してローカライズ可能なアプリケーションを作成する方法について説明します。  
+  
+ [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] のローカライズには時間がかかる場合があります。  ローカライザーは、多くの場合、テキストの翻訳だけでなく要素のサイズ変更や位置変更も行う必要があります。  これまでは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が翻訳された言語を調整する必要がありました。  現在では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の機能により、調整する必要性の少ない要素をデザインできます。  サイズ変更や位置変更がより簡単になるアプリケーション作成方法は、`auto layout` と呼ばれます。  
+  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 例では、グリッドを使用してボタンとテキストを配置する方法を示しています。  セルの高さと幅は `Auto` に設定されているため、イメージを持つボタンを含むセルがイメージに合わせて調整されることに注意してください。  <xref:System.Windows.Controls.Grid> 要素はコンテンツに合わせて調整できるため、ローカライズ可能なアプリケーションの設計に自動レイアウト方法を採用した場合に便利です。  
+  
+## 使用例  
+ グリッドを使用する方法を次の例に示します。  
+  
+ [!code-xml[LocalizationGrid#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationGrid/CS/Pane1.xaml#1)]  
+  
+ コード サンプルによる出力を次の図に示します。  
+  
+ ![グリッドの例](../../../../docs/framework/wpf/advanced/media/glob-grid.png "glob\_grid")  
+\[グリッド\]  
+  
+## 参照  
+ [自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)   
+ [自動レイアウトを使用してボタンを作成する](../../../../docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-a-resourcedictionary-to-manage-localizable-string-resources.md b/docs/framework/wpf/advanced/how-to-use-a-resourcedictionary-to-manage-localizable-string-resources.md
new file mode 100644
index 00000000000..f1e2d5eae27
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-a-resourcedictionary-to-manage-localizable-string-resources.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : ResourceDictionary を使用してローカライズ可能な文字列リソースを管理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ローカリゼーション [WPF], パッケージ化 (文字列リソースを)"
+  - "パッケージ化 (文字列リソースを)"
+  - "ResourceDictionary [WPF]"
+  - "リソース [WPF], パッケージ化 (文字列リソースを)"
+ms.assetid: 19e7d9a5-20df-4ad3-b157-fe6515902e5e
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ResourceDictionary を使用してローカライズ可能な文字列リソースを管理する
+この例では、<xref:System.Windows.ResourceDictionary> を使用して、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] 用にローカライズ可能な文字列リソースをパッケージ化する方法を示します。  
+  
+### ResourceDictionary を使用してローカライズ可能な文字列リソースを管理するには  
+  
+1.  ローカライズする文字列を含む <xref:System.Windows.ResourceDictionary> を作成します。  次に例を示します。  
+  
+     [!code-xml[StringLocalizationSample#StringResourceDictionary](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StringLocalizationSample/CSharp/StringResources.xaml#stringresourcedictionary)]  
+  
+     このコードでは、mscorlib.dll の <xref:System> 名前空間で <xref:System.String> 型の文字列リソース `localizedMessage` を定義しています。  
+  
+2.  次のコードを使用して、<xref:System.Windows.ResourceDictionary> をアプリケーションに追加します。  
+  
+     [!code-xml[StringLocalizationSample#ReferencingStringResourceDictionary](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StringLocalizationSample/CSharp/App.xaml#referencingstringresourcedictionary)]  
+  
+3.  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を次のように使用して、文字列リソースをマークアップから使用します。  
+  
+     [!code-xml[StringLocalizationSample#GetLocalizedResourceFromMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StringLocalizationSample/CSharp/MainWindow.xaml#getlocalizedresourcefrommarkup)]  
+  
+4.  次のようなコード使用して、文字列リソースを分離コードから使用します。  
+  
+     [!code-csharp[StringLocalizationSample#GetLocalizedResourceFromCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StringLocalizationSample/CSharp/MainWindow.xaml.cs#getlocalizedresourcefromcode)]
+     [!code-vb[StringLocalizationSample#GetLocalizedResourceFromCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StringLocalizationSample/VisualBasic/MainWindow.xaml.vb#getlocalizedresourcefromcode)]  
+  
+5.  アプリケーションをローカライズします。  詳細については、「[アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-a-thicknessconverter-object.md b/docs/framework/wpf/advanced/how-to-use-a-thicknessconverter-object.md
new file mode 100644
index 00000000000..c91e3360b14
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-a-thicknessconverter-object.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ThicknessConverter オブジェクトを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "境界線の太さ"
+  - "ThicknessConverter オブジェクト"
+ms.assetid: 52682194-d7fd-499c-8005-73fcc84e7b2c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ThicknessConverter オブジェクトを使用する
+## 使用例  
+ この例では、<xref:System.Windows.ThicknessConverter> のインスタンスを作成し、それを使用して境界線の太さを変更する方法を説明します。  
+  
+ この例では、`changeThickness` という名前のカスタム メソッドを定義します。このメソッドは、まず別の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルで定義されている <xref:System.Windows.Controls.ListBoxItem> のコンテンツを <xref:System.Windows.Thickness> のインスタンスに変換し、次にそのコンテンツを <xref:System.String> に変換します。  このメソッドは、<xref:System.Windows.Controls.ListBoxItem> を <xref:System.Windows.ThicknessConverter> オブジェクトに渡します。このオブジェクトは、<xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.Windows.Thickness> のインスタンスに変換します。  その後、この値は、<xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Border.BorderThickness%2A> プロパティの値として戻されます。  
+  
+ この例は実行できません。  
+  
+ [!code-csharp[ThicknessConverter#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThicknessConverter/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[ThicknessConverter#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThicknessConverter/VisualBasic/Window1.xaml.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Thickness>   
+ <xref:System.Windows.ThicknessConverter>   
+ <xref:System.Windows.Controls.Border>   
+ [How to: Change the Margin Property](http://msdn.microsoft.com/ja-jp/8a313efd-5f99-4097-b4c1-8fa49d8379a2)   
+ [How to: Convert a ListBoxItem to a new Data Type](http://msdn.microsoft.com/ja-jp/7a080b88-184e-4b27-bb61-d42bafba9727)   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-application-resources.md b/docs/framework/wpf/advanced/how-to-use-application-resources.md
new file mode 100644
index 00000000000..01f63ebe519
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-application-resources.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : アプリケーション リソースを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション リソース"
+  - "リソース, アプリケーション リソース"
+ms.assetid: 507ea937-5191-406b-8797-0a3d9f94156d
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : アプリケーション リソースを使用する
+アプリケーション リソースを使用する方法を次の例に示します。  
+  
+## 使用例  
+ 次の例では、アプリケーション定義ファイルを示します。  アプリケーション定義ファイルでは、リソース セクション \(<xref:System.Windows.Application.Resources%2A> プロパティの値\) が定義されています。  アプリケーション レベルで定義されているリソースには、そのアプリケーションの一部であるその他すべてのページがアクセスできます。  この例では、リソースは宣言済みのスタイルです。  コントロール テンプレートを含む完全なスタイルは長くなる場合があるので、この例では、スタイルの <xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> プロパティの setter で定義されているコントロール テンプレートは省略してあります。  
+  
+ [!code-xml[ResourcesApplication#PreTemplateResource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ResourcesApplication/CS/app.xaml#pretemplateresource)]  
+[!code-xml[ResourcesApplication#PostTemplateResource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ResourcesApplication/CS/app.xaml#posttemplateresource)]  
+  
+ 次の例では、前の例で定義されているアプリケーション レベルのリソースを参照する [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを示します。  リソースを参照するには、要求するリソースの一意のリソース キーを指定する [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md) を使用します。  "GelButton" というキーを持つリソースが現在のページには見つからないので、要求されているリソースのリソース ルックアップ スコープは、現在のページを越えて、定義されているアプリケーション レベルのリソースまで継続されます。  
+  
+ [!code-xml[ResourcesApplication#ConsumingPage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ResourcesApplication/CS/page1.xaml#consumingpage)]  
+  
+## 参照  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/resources-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md b/docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md
new file mode 100644
index 00000000000..e68be2b4514
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 自動レイアウトを使用してボタンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "自動レイアウト, 作成 (ボタンを)"
+  - "ボタン コントロール, 作成 (自動レイアウトによる)"
+  - "作成, 作成 (自動レイアウトでボタンを)"
+ms.assetid: 96c206d0-9e77-4784-9d2d-5045aed2021c
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 自動レイアウトを使用してボタンを作成する
+この例では、自動レイアウトの方法を使用して、ローカライズ可能なアプリケーションにボタンを作成する方法について説明します。  
+  
+ [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] のローカライズには時間がかかる場合があります。  ローカライザーには、多くの場合、テキストの翻訳だけでなく要素のサイズ変更や位置変更が必要になります。  これまでは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が翻訳された言語を調整する必要がありました。  現在では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の機能により、調整する必要性の少ない要素をデザインできます。  サイズ変更や位置変更がより簡単になるアプリケーション作成方法は、`自動レイアウト` と呼ばれます。  
+  
+ 次の 2 つの [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、ボタンをインスタンス化するアプリケーションを作成します。1 つでは英語のテキストを使用し、もう 1 つではスペイン語のテキストを使用します。  テキストを除き、コードは同じであることに注目してください。ボタンがテキストに合わせて調整されます。  
+  
+## 使用例  
+ [!code-xml[LocalizationBtn_snip#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationBtn_snip/CS/Pane1.xaml#1)]  
+  
+ [!code-xml[LocalizationBtn#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationBtn/CS/Pane1.xaml#1)]  
+  
+ コード サンプルによる出力を次の図に示します。  
+  
+ ![テキストの言語が異なる同じボタン](../../../../docs/framework/wpf/advanced/media/globalizationbutton.png "GlobalizationButton")  
+自動サイズ変更可能なボタン  
+  
+## 参照  
+ [自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)   
+ [自動レイアウト用のグリッドを使用する](../../../../docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-flow-content-elements.md b/docs/framework/wpf/advanced/how-to-use-flow-content-elements.md
new file mode 100644
index 00000000000..d4fa3aeccbf
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-flow-content-elements.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : フロー コンテンツ要素を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, フロー コンテンツ要素"
+  - "フロー コンテンツ要素"
+ms.assetid: 70fa11cd-5fa7-4872-a1cc-04d80f1132be
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : フロー コンテンツ要素を使用する
+各種のフロー コンテンツ要素および関連付けられた属性の宣言的な使用方法を次の例に示します。  例で使用される要素および属性には、次のものが含まれます。  
+  
+-   <xref:System.Windows.Documents.Bold> 要素  
+  
+-   <xref:System.Windows.Documents.Block.BreakPageBefore%2A> 属性  
+  
+-   <xref:System.Windows.Documents.TextElement.FontSize%2A> 属性  
+  
+-   <xref:System.Windows.Documents.Italic> 要素  
+  
+-   <xref:System.Windows.Documents.LineBreak> 要素  
+  
+-   <xref:System.Windows.Documents.List> 要素  
+  
+-   <xref:System.Windows.Documents.ListItem> 要素  
+  
+-   <xref:System.Windows.Documents.Paragraph> 要素  
+  
+-   <xref:System.Windows.Documents.Run> 要素  
+  
+-   <xref:System.Windows.Documents.Section> 要素  
+  
+-   <xref:System.Windows.Documents.Span> 要素  
+  
+-   <xref:System.Windows.Documents.Typography.Variants%2A> 属性 \(上付き文字と下付き文字\)  
+  
+-   <xref:System.Windows.Documents.Underline> 要素  
+  
+## 使用例  
+ [!code-xml[FlowDocInlineSnippets#_InlineElementsXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocInlineSnippets/CS/document.xaml#_inlineelementsxaml)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-flowdocument-column-separating-attributes.md b/docs/framework/wpf/advanced/how-to-use-flowdocument-column-separating-attributes.md
new file mode 100644
index 00000000000..759479c6f38
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-flowdocument-column-separating-attributes.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : FlowDocument の列区切り属性を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列区切り属性"
+  - "ドキュメント, FlowDocument の列区切り属性"
+  - "FlowDocument の列区切り属性"
+ms.assetid: c7a822f8-aeca-45bd-a258-2852ff28005c
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : FlowDocument の列区切り属性を使用する
+この例では、<xref:System.Windows.Documents.FlowDocument> の列区切り機能の使用方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Documents.FlowDocument> を定義し、<xref:System.Windows.Documents.FlowDocument.ColumnGap%2A>、<xref:System.Windows.Documents.FlowDocument.ColumnRuleBrush%2A>、および <xref:System.Windows.Documents.FlowDocument.ColumnRuleWidth%2A> 属性を設定する例を次に示します。  この <xref:System.Windows.Documents.FlowDocument> には、サンプル コンテンツの単一の段落が含まれています。  
+  
+ [!code-xml[FlowDocumentSnippets#_FlowDocumentColumnStuffXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowDocumentSnippets/CSharp/Window1.xaml#_flowdocumentcolumnstuffxaml)]  
+  
+ 描画された <xref:System.Windows.Documents.FlowDocument> の <xref:System.Windows.Documents.FlowDocument.ColumnGap%2A>、<xref:System.Windows.Documents.FlowDocument.ColumnRuleBrush%2A>、および <xref:System.Windows.Documents.FlowDocument.ColumnRuleWidth%2A> 属性の効果を次の図に示します。  
+  
+ ![スクリーンショット: FlowDocument Intra 列](../../../../docs/framework/wpf/advanced/media/flowdocumentintracolumn.png "FlowDocumentIntraColumn")
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-resources-in-localizable-applications.md b/docs/framework/wpf/advanced/how-to-use-resources-in-localizable-applications.md
new file mode 100644
index 00000000000..862cb4483ec
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-resources-in-localizable-applications.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : ローカライズ可能アプリケーションでリソースを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, ローカライズ可能"
+  - "ローカライズ可能なアプリケーション"
+ms.assetid: 08539ad6-7fca-4f34-b82b-ff439e11dfa7
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ローカライズ可能アプリケーションでリソースを使用する
+ローカリゼーションとは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を異なるカルチャに適合させることを意味します。  そのためには、タイトル、キャプション、リスト ボックス項目などのテキストを翻訳する必要があります。  翻訳しやすいように、翻訳が必要な項目はリソース ファイルにまとめられています。  ローカライゼーション用のリソース ファイルの作成方法については、「[アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)」を参照してください。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションをローカライズ可能にするには、ローカライズ可能なすべてのリソースをリソース アセンブリに組み込む必要があります。  リソース アセンブリはさまざまな言語にローカライズされ、分離コードがリソース管理 [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] を使用して読み込みます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに必要なファイルの 1 つはプロジェクト ファイル \(.proj\) です。  プロジェクト ファイルには、アプリケーションで使用するすべてのリソースを含める必要があります。  そのコード例を次に示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]  
+  
+ `<Resource Include="data\picture1.jpg"/>`  
+  
+ `<EmbeddedResource Include="data\stringtable.en-US.restext"/>`  
+  
+ アプリケーションでリソースを使用するには、<xref:System.Resources.ResourceManager> をインスタンス化し、使用するリソースを読み込みます。  その方法を次に示します。  
+  
+ [!code-csharp[LocalizationResources#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationResources/CSharp/page1.xaml.cs#2)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-special-characters-in-xaml.md b/docs/framework/wpf/advanced/how-to-use-special-characters-in-xaml.md
new file mode 100644
index 00000000000..c434cd6794b
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-special-characters-in-xaml.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : XAML で特殊文字を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "文字, 特殊"
+  - "特殊文字"
+  - "タイポグラフィ, 特殊文字"
+  - "Unicode UTF-8 ファイル形式"
+  - "UTF-8 ファイル形式"
+ms.assetid: a57776d1-f353-4794-afa0-bfa3c712ed1c
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法 : XAML で特殊文字を使用する
+[!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] で作成されたマークアップ ファイルは、自動的に [!INCLUDE[TLA#tla_unicode](../../../../includes/tlasharptla-unicode-md.md)] UTF\-8 ファイル形式で保存されます。つまり、アクセント マークなど、ほとんどの特殊文字が正しくエンコードされます。  ただし、一般的に使用される一連の特殊文字で、別の方法で処理されるものがあります。  これらの特殊文字は、エンコーディングに関する [!INCLUDE[TLA#tla_w3c](../../../../includes/tlasharptla-w3c-md.md)] [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] 標準に従います。  
+  
+ この一連の特殊文字をエンコードするための構文を次の表に示します。  
+  
+|文字|構文|Description|  
+|--------|--------|-----------------|  
+|\<|`<`|より小さい記号|  
+|\>|`>`|より大きい記号|  
+|&|`&`|アンパサンド記号|  
+|"|`"`|二重引用符記号|  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] メモ帳などのテキスト エディターを使用してマークアップ ファイルを作成する場合は、エンコードされた特殊文字を保持するためにファイルを [!INCLUDE[TLA#tla_unicode](../../../../includes/tlasharptla-unicode-md.md)] UTF\-8 ファイル形式で保存する必要があります。  
+  
+ マークアップを作成するときにテキストで特殊文字を使用する方法を次の例に示します。  
+  
+## 使用例  
+ [!code-xml[SpecialCharsSnippets#SpecialCharsSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpecialCharsSnippets/CS/Window1.xaml#specialcharssnippet1)]
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-system-fonts-keys.md b/docs/framework/wpf/advanced/how-to-use-system-fonts-keys.md
new file mode 100644
index 00000000000..93893d7a4b2
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-system-fonts-keys.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : システム フォント キーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, SystemFonts"
+  - "リソース キー, SystemFonts クラス"
+  - "SystemFonts クラス"
+ms.assetid: 036ebea7-5677-4f60-8ba4-56c9f9d9b8bd
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : システム フォント キーを使用する
+システム リソースは、システム設定との一貫性のあるビジュアルを作成できるようにするために、数多くのシステム メトリックをリソースとして公開します。  <xref:System.Windows.SystemFonts> は、システム パラメーター値とその値にバインドされるリソース キー \(たとえば <xref:System.Windows.SystemFonts.CaptionFontFamily%2A> と <xref:System.Windows.SystemFonts.CaptionFontFamilyKey%2A>\) の両方を含むクラスです。  
+  
+ システム フォント メトリックは、静的なリソースとしても、動的なリソースとしても使用できます。  アプリケーションの実行中にフォント メトリックを自動的に更新する場合は、動的リソースを使用します。それ以外の場合は、静的リソースを使用します。  
+  
+> [!NOTE]
+>  動的リソースのプロパティ名には、キーワード *Key* が追加されています。  
+  
+ システム フォント動的リソースにアクセスして使用し、ボタンのスタイルを設定したり、ボタンをカスタマイズする方法を次の例に示します。  この [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例では、ボタンに <xref:System.Windows.SystemFonts> 値を割り当てるボタン スタイルを作成します。  
+  
+## 使用例  
+ [!code-xml[SystemRes_snip#FontDynamicResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/MyApp.xaml#fontdynamicresources)]  
+  
+## 参照  
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)   
+ [SystemParameters を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemparameters.md)   
+ [SystemFonts を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemfonts.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-system-parameters-keys.md b/docs/framework/wpf/advanced/how-to-use-system-parameters-keys.md
new file mode 100644
index 00000000000..d085dd25dc3
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-system-parameters-keys.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : システム パラメーター キーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, SystemParameters"
+  - "リソース キー, SystemParameters クラス"
+  - "SystemParameters クラス"
+ms.assetid: 77571283-d16c-45bb-9f69-cafbbf72b21e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : システム パラメーター キーを使用する
+システム リソースは、システム設定との一貫性のあるビジュアルを作成できるようにするために、数多くのシステム メトリックをリソースとして公開します。  <xref:System.Windows.SystemParameters> は、システム パラメーター値とそれらの値にバインドされるリソース キー \(<xref:System.Windows.SystemParameters.FullPrimaryScreenHeight%2A>、<xref:System.Windows.SystemParameters.FullPrimaryScreenHeightKey%2A> など\) の両方を含むクラスです。  システム パラメーター メトリックは、静的なリソースとしても、動的なリソースとしても使用できます。  アプリケーションの実行中にパラメーター メトリックを自動的に更新する場合は、動的リソースを使用します。それ以外の場合は、静的リソースを使用します。  
+  
+> [!NOTE]
+>  動的リソースのプロパティ名には、キーワード *Key* が追加されています。  
+  
+ システム パラメーター動的リソースにアクセスして、ボタンのスタイルの設定やボタンのカスタマイズに使用する方法を次の例に示します。  この [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例では、ボタンの幅と高さに <xref:System.Windows.SystemParameters> の値を割り当ててボタンのサイズを設定します。  
+  
+## 使用例  
+ [!code-xml[SystemRes_snip#ParameterDynamicResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/MyApp.xaml#parameterdynamicresources)]  
+  
+## 参照  
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)   
+ [SystemFonts を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemfonts.md)   
+ [SystemParameters を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemparameters.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-systemfonts.md b/docs/framework/wpf/advanced/how-to-use-systemfonts.md
new file mode 100644
index 00000000000..7303f5d01d2
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-systemfonts.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : SystemFonts を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, SystemFonts"
+  - "フォント, システム フォント"
+  - "システム フォント"
+  - "SystemFonts クラス"
+ms.assetid: 3f46a4ec-2225-408a-8123-8838a8f7057a
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 方法 : SystemFonts を使用する
+この例では、ボタンをスタイル設定またはカスタマイズするために <xref:System.Windows.SystemFonts> クラスの静的リソースを使用する方法を示します。  
+  
+## 使用例  
+ システム リソースは、システム設定との一貫性のあるビジュアルを作成できるようにするために、いくつかのシステムによって決定される値をリソースおよびプロパティの両方として公開します。  <xref:System.Windows.SystemFonts> は、システム フォント値を静的プロパティとして含む他、実行時にこれらの値に動的にアクセスするためのリソース キーを参照するプロパティを含むクラスです。  たとえば、<xref:System.Windows.SystemFonts.CaptionFontFamily%2A> は <xref:System.Windows.SystemFonts> 値であり、<xref:System.Windows.SystemFonts.CaptionFontFamilyKey%2A> は対応するリソース キーです。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.SystemFonts> のメンバーを、静的プロパティまたは動的リソース参照 \(キーとして静的プロパティ値を使用\) として使用できます。  アプリケーションの実行中にフォント メトリックを自動的に更新する場合は、動的リソース参照を使用します。それ以外の場合は、静的な値参照を使用します。  
+  
+> [!NOTE]
+>  リソース キーの名前は、プロパティ名に "Key" というサフィックスが付いたものになります。  
+  
+ 静的な値である <xref:System.Windows.SystemFonts> のプロパティにアクセスして使用し、ボタンのスタイルを設定したり、ボタンをカスタマイズしたりする方法を次の例に示します。  このマークアップの例では、ボタンに <xref:System.Windows.SystemFonts> 値を割り当てます。  
+  
+ [!code-xml[SystemRes_snip#FontStaticResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/Pane1.xaml#fontstaticresources)]  
+  
+ コードで <xref:System.Windows.SystemFonts> の値を使用する場合は、静的な値も動的リソース参照も使用する必要はありません。  代わりに、<xref:System.Windows.SystemFonts> クラスのキー以外のプロパティを使用します。  キー以外のプロパティは静的プロパティのように定義されますが、システムでホストされた [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の実行時の動作では、リアルタイムでプロパティが再評価され、ユーザーによるシステム値の変更が正しく反映されます。  ボタンのフォント設定を指定する方法を次の例に示します。  
+  
+ [!code-csharp[SystemRes_snip#FontResourcesCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/Pane1.xaml.cs#fontresourcescode)]
+ [!code-vb[SystemRes_snip#FontResourcesCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SystemRes_snip/VisualBasic/Pane1.xaml.vb#fontresourcescode)]  
+  
+## 参照  
+ <xref:System.Windows.SystemFonts>   
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)   
+ [SystemParameters を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemparameters.md)   
+ [システム フォント キーを使用する](../../../../docs/framework/wpf/advanced/how-to-use-system-fonts-keys.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/resources-how-to-topics.md)   
+ [x:Static のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-static-markup-extension.md)   
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-systemparameters.md b/docs/framework/wpf/advanced/how-to-use-systemparameters.md
new file mode 100644
index 00000000000..814fbeb0cad
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-systemparameters.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : SystemParameters を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, SystemParameters"
+  - "SystemParameters クラス"
+ms.assetid: 02e7a5de-94eb-4953-b91c-52e6c872ad5b
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : SystemParameters を使用する
+この例では、ボタンのスタイルを設定したりボタンをカスタマイズするために、<xref:System.Windows.SystemParameters> のプロパティにアクセスして使用する方法を示します。  
+  
+## 使用例  
+ システム リソースは、システム設定との一貫性のあるビジュアルを作成できるようにするために、いくつかのシステムに基づく設定をリソースとして公開します。  <xref:System.Windows.SystemParameters> は、システム パラメーターの値プロパティ、それらの値にバインドされるリソース キーの両方を含むクラスです。  たとえば、<xref:System.Windows.SystemParameters.FullPrimaryScreenHeight%2A> は <xref:System.Windows.SystemParameters> プロパティ値であり、<xref:System.Windows.SystemParameters.FullPrimaryScreenHeightKey%2A> は対応するリソース キーです。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.SystemParameters> のメンバーを、静的プロパティまたは動的リソース参照 \(キーとして静的プロパティ値を使用\) として使用できます。  アプリケーションの実行中にシステムに基づく値を自動的に更新する場合は、動的リソース参照を使用します。それ以外の場合は、静的参照を使用します。  リソース キーの名前は、プロパティ名に `Key` というサフィックスが付いたものになります。  
+  
+ <xref:System.Windows.SystemParameters> の静的な値にアクセスして使用し、ボタンのスタイルを設定したり、ボタンをカスタマイズする方法を次の例に示します。  このマークアップ例では、ボタンに <xref:System.Windows.SystemParameters> 値を適用してボタンのサイズを設定します。  
+  
+ [!code-xml[SystemRes_snip#ParameterStaticResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/Pane1.xaml#parameterstaticresources)]  
+  
+ コードで <xref:System.Windows.SystemParameters> の値を使用する場合は、静的参照も動的リソース参照も使用する必要がありません。  代わりに、<xref:System.Windows.SystemParameters> クラスの値を使用します。  キー以外のプロパティは静的プロパティのように定義されますが、システムでホストされた [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の実行時の動作では、リアルタイムでプロパティが再評価され、ユーザーによるシステム値の変更が正しく反映されます。<xref:System.Windows.SystemParameters> 値を使用してボタンの幅と高さを設定する方法を次の例に示します。  
+  
+ [!code-csharp[SystemRes_snip#ParameterResourcesCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SystemRes_snip/CSharp/Pane1.xaml.cs#parameterresourcescode)]
+ [!code-vb[SystemRes_snip#ParameterResourcesCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SystemRes_snip/VisualBasic/Pane1.xaml.vb#parameterresourcescode)]  
+  
+## 参照  
+ <xref:System.Windows.SystemParameters>   
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)   
+ [SystemFonts を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemfonts.md)   
+ [システム パラメーター キーを使用する](../../../../docs/framework/wpf/advanced/how-to-use-system-parameters-keys.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/resources-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-use-the-fontsizeconverter-class.md b/docs/framework/wpf/advanced/how-to-use-the-fontsizeconverter-class.md
new file mode 100644
index 00000000000..52e6158e98b
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-use-the-fontsizeconverter-class.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : FontSizeConverter クラスを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "FontSizeConverter オブジェクト"
+  - "タイポグラフィ, FontSizeConverter オブジェクト"
+ms.assetid: 3b0592bd-7223-4860-a108-a5d72f3a9178
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : FontSizeConverter クラスを使用する
+## 使用例  
+ この例では、<xref:System.Windows.FontSizeConverter> のインスタンスを作成し、それを使用してフォント サイズを変更する方法を説明します。  
+  
+ この例では、`changeSize` という名前のカスタム メソッドを定義します。このメソッドは、別の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルで定義されている <xref:System.Windows.Controls.ListBoxItem> のコンテンツを、まず <xref:System.Double> のインスタンスに変換し、その後で <xref:System.String> に変換します。  このメソッドは <xref:System.Windows.Controls.ListBoxItem> を <xref:System.Windows.FontSizeConverter> オブジェクトに渡します。このオブジェクトは、<xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.Double> のインスタンスに変換します。  その後、この値は、<xref:System.Windows.Controls.TextBlock> 要素の <xref:System.Windows.Controls.TextBlock.FontSize%2A> プロパティの値として戻されます。  
+  
+ また、この例では、`changeFamily` という名前の第 2 のカスタム メソッドも定義されています。  このメソッドは、<xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.String> に変換した後、その値を <xref:System.Windows.Controls.TextBlock> 要素の <xref:System.Windows.Controls.TextBlock.FontFamily%2A> プロパティに渡します。  
+  
+ この例は実行できません。  
+  
+ [!code-csharp[FontSizeConverter#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSizeConverter/CSharp/Window1.xaml.cs#1)]  
+  
+## 参照  
+ <xref:System.Windows.FontSizeConverter>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/how-to-validate-and-merge-printtickets.md b/docs/framework/wpf/advanced/how-to-validate-and-merge-printtickets.md
new file mode 100644
index 00000000000..f2a8d194540
--- /dev/null
+++ b/docs/framework/wpf/advanced/how-to-validate-and-merge-printtickets.md
@@ -0,0 +1,73 @@
+---
+title: "方法 : PrintTickets を検証およびマージする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "マージ (PrintTicket を)"
+  - "PrintTicket, マージ"
+  - "PrintTicket, 検証"
+  - "検証 (PrintTicket の)"
+ms.assetid: 4fe2d501-d0b0-4fef-86af-6ffe6c162532
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : PrintTickets を検証およびマージする
+[!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] [印刷スキーマ](http://go.microsoft.com/fwlink/?LinkId=186397)には、柔軟で拡張性に優れた <xref:System.Printing.PrintCapabilities> 要素と <xref:System.Printing.PrintTicket> 要素が含まれています。  前者は印刷デバイスの機能を明細化し、後者はデバイスが特定のドキュメントのシーケンス、個々のドキュメント、または個々のページに対してこれらの機能を使用する方法を指定します。  
+  
+ 印刷をサポートするアプリケーションの一般的な一連のタスクは次のとおりです。  
+  
+1.  プリンターの機能を確認します。  
+  
+2.  その機能を使用するように <xref:System.Printing.PrintTicket> を構成します。  
+  
+3.  <xref:System.Printing.PrintTicket> を検証します。  
+  
+ この記事では、この実行方法を示します。  
+  
+## 使用例  
+ 次の簡単な例では、プリンターで二面印刷 \(両面印刷\) がサポートされるかどうかにのみ焦点を当てています。  主な手順は次のとおりです。  
+  
+1.  <xref:System.Printing.PrintQueue.GetPrintCapabilities%2A> メソッドを使用して、<xref:System.Printing.PrintCapabilities> オブジェクトを取得します。  
+  
+2.  必要な機能が存在するかどうかをテストします。  次の例では、<xref:System.Printing.PrintCapabilities> オブジェクトの <xref:System.Printing.PrintCapabilities.DuplexingCapability%2A> プロパティをテストして、用紙の長辺に沿って "ページをめくり"、用紙の両面に印刷する機能が存在するかどうかを確認します。  <xref:System.Printing.PrintCapabilities.DuplexingCapability%2A> はコレクションであるので、<xref:System.Collections.ObjectModel.ReadOnlyCollection%601> の `Contains` メソッドを使用します。  
+  
+    > [!NOTE]
+    >  この手順は、厳密には必要ありません。  以下で使用される <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A> メソッドによって、<xref:System.Printing.PrintTicket> の各要求がプリンターの機能と照合されます。  要求された機能がプリンターでサポートされていない場合、プリンター ドライバーによってメソッドから返される <xref:System.Printing.PrintTicket> の代替要求に置き換えられます。  
+  
+3.  プリンターで両面印刷がサポートされている場合、サンプル コードによって両面印刷を要求する <xref:System.Printing.PrintTicket> が作成されます。  ただし、アプリケーションでは、<xref:System.Printing.PrintTicket> 要素で使用可能なあらゆるプリンター設定が指定されるわけではありません。  プログラマとプログラムの時間の両方にとって無駄な処理となるためです。  代わりに、コードによって両面印刷要求のみが設定され、この <xref:System.Printing.PrintTicket> と既存の完全に構成および検証された <xref:System.Printing.PrintTicket> \(この場合はユーザーの既定の <xref:System.Printing.PrintTicket>\) がマージされます。  
+  
+4.  したがって、サンプルによって <xref:System.Printing.PrintQueue.MergeAndValidatePrintTicket%2A> メソッドが呼び出され、新しい最小限の <xref:System.Printing.PrintTicket> とユーザーの既定の <xref:System.Printing.PrintTicket> がマージされます。  これにより、新しい <xref:System.Printing.PrintTicket> をプロパティの 1 つとして含む <xref:System.Printing.ValidationResult> が返されます。  
+  
+5.  次に、サンプルによって新しい <xref:System.Printing.PrintTicket> が両面印刷を要求するかどうかがテストされます。  要求する場合、その印刷チケットがユーザーの新しい既定の印刷チケットになります。  前の手順 2. を省略した場合、プリンターで長辺とじ両面印刷がサポートされないと、テストは `false` になります   \(上記のメモを参照してください\)。  
+  
+6.  最後の重要な手順は、<xref:System.Printing.PrintQueue.Commit%2A> メソッドを使用して、変更を <xref:System.Printing.PrintQueue> の <xref:System.Printing.PrintQueue.UserPrintTicket%2A> プロパティにコミットすることです。  
+  
+ [!code-csharp[PrintTicketManagment#UsingMergeAndValidate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrintTicketManagment/CSharp/printticket.cs#usingmergeandvalidate)]
+ [!code-vb[PrintTicketManagment#UsingMergeAndValidate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrintTicketManagment/visualbasic/printticket.vb#usingmergeandvalidate)]  
+  
+ この例を迅速にテストできるように、その残りの部分を次に示します。  プロジェクトおよび名前空間を作成し、この記事の両方のコード スニペットを名前空間ブロックに貼り付けます。  
+  
+ [!code-csharp[PrintTicketManagment#UIForMergeAndValidatePTUtility](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PrintTicketManagment/CSharp/printticket.cs#uiformergeandvalidateptutility)]
+ [!code-vb[PrintTicketManagment#UIForMergeAndValidatePTUtility](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PrintTicketManagment/visualbasic/printticket.vb#uiformergeandvalidateptutility)]  
+  
+## 参照  
+ <xref:System.Printing.PrintCapabilities>   
+ <xref:System.Printing.PrintTicket>   
+ <xref:System.Printing.PrintServer.GetPrintQueues%2A>   
+ <xref:System.Printing.PrintServer>   
+ <xref:System.Printing.EnumeratedPrintQueueTypes>   
+ <xref:System.Printing.PrintQueue>   
+ <xref:System.Printing.PrintQueue.GetPrintCapabilities%2A>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [Print Schema \(印刷スキーマ\)](http://go.microsoft.com/fwlink/?LinkId=186397)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/index.md b/docs/framework/wpf/advanced/index.md
new file mode 100644
index 00000000000..498a1487c1b
--- /dev/null
+++ b/docs/framework/wpf/advanced/index.md
@@ -0,0 +1,42 @@
+---
+title: "(Windows Presentation Foundation) の詳細 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ モデル [WPF]"
+  - "WPF のコンテンツ モデル"
+  - "WPF プログラミング モデル"
+  - "XAML [WPF] コンテンツ モデル"
+ms.assetid: 58843391-b28c-4d32-adf5-87acaf6578a1
+caps.latest.revision: 82
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 82
+---
+# (Windows Presentation Foundation) の詳細
+このセクションでは、WPF の高度な領域について説明します。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)  
+ [要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)  
+ [ドラッグ アンド ドロップ](../../../../docs/framework/wpf/advanced/drag-and-drop.md)  
+ [ドキュメント](../../../../docs/framework/wpf/advanced/documents.md)  
+ [グローバリゼーションとローカリゼーション](../../../../docs/framework/wpf/advanced/globalization-and-localization.md)  
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)  
+ [パフォーマンス](../../../../docs/framework/wpf/advanced/performance.md)  
+ [スレッド処理モデル](../../../../docs/framework/wpf/advanced/threading-model.md)  
+ [WPF のアドインの概要](../../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)  
+ [WPF のアンマネージ API リファレンス](../../../../ocs/framework/wpf/advanced/wpf-unmanaged-api-reference.md)  
+  
+## <a name="related-sections"></a>関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/initialization-for-object-elements-not-in-an-object-tree.md b/docs/framework/wpf/advanced/initialization-for-object-elements-not-in-an-object-tree.md
new file mode 100644
index 00000000000..ea095e51c29
--- /dev/null
+++ b/docs/framework/wpf/advanced/initialization-for-object-elements-not-in-an-object-tree.md
@@ -0,0 +1,52 @@
+---
+title: "オブジェクト ツリーに存在しないオブジェクト要素の初期化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "要素, 初期化"
+  - "初期化 (要素を)"
+  - "論理ツリー"
+  - "ビジュアル ツリー"
+ms.assetid: 7b8dfc9b-46ac-4ce8-b7bb-035734d688b7
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# オブジェクト ツリーに存在しないオブジェクト要素の初期化
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] における初期化処理を委託されるプロセスの中には、その要素が[論理ツリー](GTMT)または[ビジュアル ツリー](GTMT)のいずれかに接続されていることを前提とするものがあります。  ここでは、どちらのツリーにも接続されていない要素を初期化するために必要となる可能性のある手順について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## 要素と論理ツリー  
+ コード内で [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスのインスタンスを作成するときは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスのオブジェクト初期化処理の一部が、クラス コンストラクターの呼び出し時に実行されるコードから意図的に除外されていることに注意してください。  特に、コントロール クラスの場合は、コントロールの視覚的表現の大部分が、コンストラクターではなく  コントロールのテンプレートによって定義されます。  このテンプレートのソースにはさまざまなものがありますが、ほとんどの場合はテーマ スタイルから取得されます。  テンプレートは、実質的には遅延バインディングです。必要なテンプレートがコントロールに結び付けられるのは、そのコントロールがレイアウト可能になったときです。  コントロールがレイアウト可能になるのは、ルートでレンダリング サーフェイスに接続される論理ツリーに結び付けられたときです。  このルート レベル要素によって、論理ツリーで定義されているすべての子要素のレンダリングが行われます。  
+  
+ このプロセスには、ビジュアル ツリーも関与します。  テンプレートによってビジュアル ツリーに組み込まれる要素も、接続されなければ完全にはインスタンス化されません。  
+  
+ この動作の影響で、要素の視覚的特性がすべて揃っていることを前提とする操作には追加の手順が必要になります。  既に構築されているがまだツリーに関連付けられていないクラスの視覚的特性を取得する場合などがそうです。  たとえば、<xref:System.Windows.Media.Imaging.RenderTargetBitmap> に対して <xref:System.Windows.Media.Imaging.RenderTargetBitmap.Render%2A> を呼び出すときに、渡そうとしているビジュアルがツリーに接続されていない要素である場合は、追加の初期化手順が実行されるまでその要素の視覚的特性は揃いません。  
+  
+### BeginInit と EndInit を使用して要素を初期化する  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のさまざまなクラスに、<xref:System.ComponentModel.ISupportInitialize> インターフェイスが実装されています。  このインターフェイスの <xref:System.ComponentModel.ISupportInitialize.BeginInit%2A> メソッドと <xref:System.ComponentModel.ISupportInitialize.EndInit%2A> メソッドを使用して、コード内の初期化手順 \(たとえばレンダリングに影響を与えるプロパティ値の設定\) の部分を示します。  シーケンス内で <xref:System.ComponentModel.ISupportInitialize.EndInit%2A> が呼び出された後に、レイアウト システムは要素を処理し、暗黙的なスタイルの検索を開始します。  
+  
+ プロパティ設定対象の要素が <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> 派生クラスである場合は、<xref:System.ComponentModel.ISupportInitialize> にキャストする代わりに、クラス バージョンの <xref:System.Windows.FrameworkElement.BeginInit%2A> と <xref:System.Windows.FrameworkElement.EndInit%2A> を呼び出します。  
+  
+### サンプル コード  
+ 次のコンソール アプリケーションのサンプル コードでは、Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルのレンダリング [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] および <xref:System.Windows.Markup.XamlReader.Load%28System.IO.Stream%29?displayProperty=fullName> を使用して、<xref:System.Windows.FrameworkElement.BeginInit%2A> と <xref:System.Windows.FrameworkElement.EndInit%2A> の正しい配置方法を示します。これらのメソッドは、レンダリングに影響を与えるプロパティを調整する他の [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] 呼び出しを囲むように配置します。  
+  
+ この例では、Main 関数のみを示します。  関数 `Rasterize` および `Save` \(この例には示していません\) は、イメージ処理および入出力を扱うユーティリティ関数です。  
+  
+ [!code-csharp[InitializeElements#Main](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InitializeElements/CSharp/initializeelements.cs#main)]
+ [!code-vb[InitializeElements#Main](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InitializeElements/VisualBasic/initializeelements.vb#main)]  
+  
+## 参照  
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/inline-styles-and-templates.md b/docs/framework/wpf/advanced/inline-styles-and-templates.md
new file mode 100644
index 00000000000..b26f028b656
--- /dev/null
+++ b/docs/framework/wpf/advanced/inline-styles-and-templates.md
@@ -0,0 +1,47 @@
+---
+title: "インライン スタイルおよびテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インライン スタイル"
+  - "インライン テンプレート"
+  - "スタイル, inline"
+  - "テンプレート, inline"
+ms.assetid: 69a1a3f9-acb5-4e2c-9c43-2e376c055ac4
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# インライン スタイルおよびテンプレート
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、<xref:System.Windows.Style> オブジェクトとテンプレート オブジェクト \(<xref:System.Windows.FrameworkTemplate> サブクラス\) を、要素の外観をリソースで定義する方法として提供するので、これらのオブジェクトは複数回数使用できます。  このため、型 <xref:System.Windows.Style> および型 <xref:System.Windows.FrameworkTemplate> を取る [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の属性は、ほとんどの場合、新たにインラインで定義するのではなく、既存のスタイルとテンプレートへのリソース参照を作成します。  
+  
+## インライン スタイルおよびテンプレートの制限  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、スタイル プロパティとテンプレート プロパティを、技術的に次のいずれかの方法で設定できます。  属性構文を使用して、リソース内で定義されたスタイルを参照できます。たとえば、`<`*object*`Style="{StaticResource`*myResourceKey*`}" .../>` とします。  または、プロパティ要素構文を使用して、スタイル インラインを定義できます。次はその例です。  
+  
+ `<` *object* `>`  
+  
+ `<` *object* `.Style>`  
+  
+ `<` `Style`  `.../>`  
+  
+ `</` *object* `.Style>`  
+  
+ `</` *object* `>`  
+  
+ 属性の使用方法は、さらに一般的です。  インラインで定義され、リソースでは定義されないスタイルは、必然的に、含まれる要素のみに有効範囲が限定されます。また、リソース キーを持たないため、簡単には再利用できません。  一般に、リソースで定義されるスタイルは、汎用性と有用性が高く、コードでのプログラム ロジックとマークアップでのデザインを分離する一般的な [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] プログラミング モデルの方針により合っています。  
+  
+ 通常、その場所でスタイルまたはテンプレートを使用するだけの場合でも、スタイルやテンプレートをインラインで設定する必要はありません。  ほとんどの要素は、スタイルまたはテンプレートを取ることができ、また、コンテンツ プロパティとコンテンツ モデルをサポートします。  スタイルまたはテンプレートで作成する論理ツリーを一度使用するだけの場合、マークアップで、同等の子要素によってコンテンツ プロパティを直接設定するだけの方がよりいっそう簡単です。  これは、スタイル機構とテンプレート機構を完全にバイパスします。  
+  
+ オブジェクトを返すマークアップ拡張機能によって有効となる他の構文も、スタイルおよびテンプレートには可能です。  考えられるシナリオを持つ 2 つの拡張機能として、[TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) と <xref:System.Windows.Data.Binding> があります。  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/input-and-commands-how-to-topics.md b/docs/framework/wpf/advanced/input-and-commands-how-to-topics.md
new file mode 100644
index 00000000000..5a54048f53e
--- /dev/null
+++ b/docs/framework/wpf/advanced/input-and-commands-how-to-topics.md
@@ -0,0 +1,55 @@
+---
+title: "入力およびコマンドに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コマンド実行"
+  - "入力 API"
+ms.assetid: a5c266b6-969c-4049-a471-ddca7b10fb89
+caps.latest.revision: 76
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 76
+---
+# 入力およびコマンドに関する「方法」トピック
+このセクションの各トピックでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] で入力およびコマンド実行インフラストラクチャを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [コマンドを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-a-command.md)  
+ [カーソルの種類を変更する](../../../../docs/framework/wpf/advanced/how-to-change-the-cursor-type.md)  
+ [フォーカス イベントを使用して要素の色を変更する](../../../../docs/framework/wpf/advanced/how-to-change-the-color-of-an-element-using-focus-events.md)  
+ [FocusVisualStyle をコントロールに適用する](../../../../docs/framework/wpf/advanced/how-to-apply-a-focusvisualstyle-to-a-control.md)  
+ [Enter キーが押されたことを検出する](../../../../docs/framework/wpf/advanced/how-to-detect-when-the-enter-key-pressed.md)  
+ [イベントを使用してロールオーバー効果を作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-rollover-effect-using-events.md)  
+ [オブジェクトをマウス ポインターに追従させる](../../../../docs/framework/wpf/advanced/how-to-make-an-object-follow-the-mouse-pointer.md)  
+ [RoutedCommand を作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-routedcommand.md)  
+ [ICommandSource を実装する](../../../../docs/framework/wpf/advanced/how-to-implement-icommandsource.md)  
+ [コマンドをサポートしないコントロールにコマンドをフックする](../../../../docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-no-command-support.md)  
+ [コマンドをサポートするコントロールにコマンドをフックする](../../../../docs/framework/wpf/advanced/how-to-hook-up-a-command-to-a-control-with-command-support.md)  
+  
+## 関連項目  
+ <xref:System.Windows.UIElement>  
+  
+ <xref:System.Windows.FrameworkElement>  
+  
+ <xref:System.Windows.ContentElement>  
+  
+ <xref:System.Windows.FrameworkContentElement>  
+  
+ <xref:System.Windows.Input.Keyboard>  
+  
+ <xref:System.Windows.Input.Mouse>  
+  
+ <xref:System.Windows.Input.FocusManager>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/input-overview.md b/docs/framework/wpf/advanced/input-overview.md
new file mode 100644
index 00000000000..1d53a4c7bdd
--- /dev/null
+++ b/docs/framework/wpf/advanced/input-overview.md
@@ -0,0 +1,405 @@
+---
+title: "入力の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コマンド [WPF]"
+  - "入力 [WPF], 概要"
+  - "キーボード フォーカス [WPF]"
+  - "キーボード入力 [WPF]"
+  - "タッチ イベント [WPF]"
+  - "イベント ルーティング [WPF]"
+  - "タッチ入力 [WPF]"
+  - "操作 [WPF]"
+  - "論理フォーカス [WPF]"
+  - "スタイラス入力 [WPF]"
+  - "テキスト入力 [WPF]"
+  - "処理する入力イベント [WPF]"
+  - "WPF では、入力の概要"
+  - "操作イベント [WPF]"
+  - "マウス入力 [WPF]"
+  - "マウス キャプチャ [WPF]"
+  - "フォーカス [WPF]"
+  - "マウスの位置 [WPF]"
+ms.assetid: ee5258b7-6567-415a-9b1c-c0cbe46e79ef
+caps.latest.revision: 50
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 50
+---
+# 入力の概要
+<a name="introduction"></a>[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]サブシステムは、強力な[!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)]マウス、キーボード、タッチ、およびスタイラスなどのさまざまなデバイスからの入力を取得します。 このトピックの説明が提供するサービス[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]し、入力システムのアーキテクチャについて説明します。  
+  
+  
+<a name="input_api"></a>   
+## <a name="input-api"></a>入力 API  
+ 主な入力[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]露出が要素の基本クラスが見つかりました: <xref:System.Windows.UIElement>、 <xref:System.Windows.ContentElement>、 <xref:System.Windows.FrameworkElement>、および<xref:System.Windows.FrameworkContentElement>します。  基本要素の詳細については、次を参照してください。[基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)します。  これらのクラスは、キーの押下、マウス ボタン、マウス ホイール、マウスの動きをフォーカス管理、およびマウスのキャプチャなどに関連する入力イベントの機能を提供します。 入力を配置することで[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]基本要素で扱うのではなくすべての入力イベントをサービスとして、入力のアーキテクチャは、UI では、特定のオブジェクトによって明らかにして、複数の要素が入力イベントを処理するには、イベント ルーティング方法をサポートするために、入力イベントを有効にします。 多くの入力イベントでは、それらに関連付けられているイベントのペアを持っています。  たとえば、上下のイベントに関連付けられている、 <xref:System.Windows.Input.Keyboard.KeyDown>と<xref:System.Windows.Input.Keyboard.PreviewKeyDown>イベントです。  これらのイベントの違いは、ターゲット要素へのルーティング方法でです。  プレビュー イベントは、ターゲット要素にはルート要素から要素ツリーの下位トンネリングします。  バブル イベントは、ルート要素に、ターゲット要素からバブルアップします。  イベントのルーティングで[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]しこの概要の後で、詳細に説明した、[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。  
+  
+### <a name="keyboard-and-mouse-classes"></a>キーボードとマウス クラス  
+ 入力だけでなく[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]、基本要素のクラスで、<xref:System.Windows.Input.Keyboard>クラスと<xref:System.Windows.Input.Mouse>クラスを追加提供[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]キーボードとマウスの入力を操作するためです。  
+  
+ 入力の例[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]に、<xref:System.Windows.Input.Keyboard>クラスは、<xref:System.Windows.Input.Keyboard.Modifiers%2A>を返すプロパティ、<xref:System.Windows.Input.ModifierKeys>現在押されて、 <xref:System.Windows.Input.Keyboard.IsKeyDown%2A>メソッドで、指定したキーが押されたかどうかを決定します。  
+  
+ 次の例では、 <xref:System.Windows.Input.Keyboard.GetKeyStates%2A>メソッドかどうかを<xref:System.Windows.Input.Key>停止状態にします。  
+  
+ [!code-csharp[keyargssnippetsample#KeyEventArgsKeyBoardGetKeyStates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/KeyArgsSnippetSample/CSharp/Window1.xaml.cs#keyeventargskeyboardgetkeystates)]
+ [!code-vb[keyargssnippetsample#KeyEventArgsKeyBoardGetKeyStates](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/KeyArgsSnippetSample/visualbasic/window1.xaml.vb#keyeventargskeyboardgetkeystates)]  
+  
+ 入力の例として[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]上、<xref:System.Windows.Input.Mouse>クラスが<xref:System.Windows.Input.Mouse.MiddleButton%2A>、マウスの中央ボタンの状態の取得元と<xref:System.Windows.Input.Mouse.DirectlyOver%2A>、経由では現在マウス ポインターの要素を取得します。  
+  
+ 次の例を確認するかどうか、 <xref:System.Windows.Input.Mouse.LeftButton%2A>では、マウスは、 <xref:System.Windows.Input.MouseButtonState>状態です。  
+  
+ [!code-csharp[mouserelatedsnippets#MouseRelatedSnippetsGetLeftButtonMouse](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MouseRelatedSnippets/CSharp/Window1.xaml.cs#mouserelatedsnippetsgetleftbuttonmouse)]
+ [!code-vb[mouserelatedsnippets#MouseRelatedSnippetsGetLeftButtonMouse](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MouseRelatedSnippets/visualbasic/window1.xaml.vb#mouserelatedsnippetsgetleftbuttonmouse)]  
+  
+ <xref:System.Windows.Input.Mouse>と<xref:System.Windows.Input.Keyboard>クラスは、この概要で詳細に説明します。  
+  
+### <a name="stylus-input"></a>スタイラスからの入力  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]サポートが統合されて、<xref:System.Windows.Input.Stylus>します。  <xref:System.Windows.Input.Stylus>によって普及したペン入力は、[!INCLUDE[TLA#tla_tpc](../../../../includes/tlasharptla-tpc-md.md)]です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションは、マウスを使用して、マウスとしてスタイラスを処理することができます[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]が[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]もキーボードとマウスのようなモデルを使用するスタイラス デバイス抽象クラスを公開します。  スタイラスに関連する[!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)]「スタイラス」という単語が含まれています。  
+  
+ スタイラス動作できるため、マウスとして、マウスの入力だけをサポートするアプリケーションことができますまだスタイラス サポートのいくつかのレベルを自動的に取得します。 このような方法でスタイラスを使用すると、アプリケーションは、適切なスタイラス イベントを処理する機会が与えられ、対応するマウス イベントを処理します。 さらに、上位レベル サービスのインク入力などもスタイラス デバイスの抽象化を通じて利用できます。  入力としてのインクの使用に関する詳細については、次を参照してください。[インクの概要](../../../../docs/framework/wpf/advanced/getting-started-with-ink.md)します。  
+  
+<a name="event_routing"></a>   
+## <a name="event-routing"></a>イベントのルーティング  
+ A <xref:System.Windows.FrameworkElement>要素のツリーを形成する、コンテンツ モデル内の子要素としての他の要素を含めることができます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、親要素は、イベントを処理してその子要素またはその他の子孫に対する入力に参加できます。 これは、小さいコントロールからコントロールの「コントロール合成に」または「合成」と呼ばれるプロセスを構築するために特に便利です。 要素ツリーおよび要素ツリーがイベントのルートに関連付ける方法の詳細については、次を参照してください。 [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)します。  
+  
+ イベント ルーティング、複数の要素にイベントを転送するプロセスは、特定のオブジェクトまたは経路上の要素は、別の要素によって供給される場合があるイベントを (処理を介して) 重要な応答を提供するを選択できるようにします。  ルーティングされたイベントを使用して次の&3; つのルーティング メカニズムのいずれか: 直接、バブル、トンネリングします。  直接ルーティングでは、ソース要素は、通知を受け取る、唯一の要素と、イベントは、他の要素にルーティングします。 ただし、直接ルーティングされたイベントは、追加機能が標準ではなくルーティング イベントの存在のみをいくつかまだを[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]イベントです。 最初に通知し、イベントのソース要素と親要素で、要素ツリーをバブルは機能します。  トンネリングでは、要素ツリーのルートから開始し、元のソース要素で終わるダウンしている動作します。  ルーティングされたイベントの詳細については、次を参照してください。[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]入力イベントは、通常、トンネル イベントおよびバブル イベントから成るペアになっています。  トンネル イベントには、バブル イベント「プレビュー」プレフィックスでは区別されます。  たとえば、 <xref:System.Windows.Input.Mouse.PreviewMouseMove>マウス移動イベントのトンネルのバージョンと<xref:System.Windows.Input.Mouse.MouseMove>バブル バージョンは、このイベントは、です。 要素レベルで実装があり、固有の機能のではない規則は、このイベントを組み合わせる、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]イベント システムです。 詳細については、入力イベントを WPF」セクションを参照してください。[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。  
+  
+<a name="handling_input_events"></a>   
+## <a name="handling-input-events"></a>入力イベントの処理  
+ 要素に入力を提供するには、イベント ハンドラーがその特定のイベントに関連付けられたあります。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]これは簡単です。 このイベントを待機する要素の属性として、イベントの名前を参照します。  次に、デリゲートに基づいて、定義するイベント ハンドラーの名前に属性の値を設定します。  イベント ハンドラーをなど、コードで記述する必要があります[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)]分離コード ファイルに含めることができます。  
+  
+ キーボード イベントは、オペレーティング システムがある要素にキーボード フォーカスがあるときに発生した主なアクションをレポートするときに発生します。 マウスおよびスタイラス イベントはそれぞれが&2; つのカテゴリに分類されます。 ポインターの位置が、要素に相対的な変更を報告するイベントとデバイスのボタンの状態の変更を報告するイベントです。  
+  
+### <a name="keyboard-input-event-example"></a>キーボード入力イベントの例  
+ 次の例は、左矢印キーを押すを待機します。  A <xref:System.Windows.Controls.StackPanel>が作成されるが、<xref:System.Windows.Controls.Button>します。  左矢印キーを押すに接続されているを待機するイベント ハンドラー、<xref:System.Windows.Controls.Button>インスタンス。  
+  
+ 例では、最初のセクションを作成、 <xref:System.Windows.Controls.StackPanel>と<xref:System.Windows.Controls.Button>のイベント ハンドラーをアタッチし、 <xref:System.Windows.UIElement.KeyDown>します。  
+  
+ [!code-xml[InputOvw#Input_OvwKeyboardExampleXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml#input_ovwkeyboardexamplexaml)]  
+  
+ [!code-csharp[InputOvw#Input_OvwKeyboardExampleUICodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwkeyboardexampleuicodebehind)]
+ [!code-vb[InputOvw#Input_OvwKeyboardExampleUICodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwkeyboardexampleuicodebehind)]  
+  
+ 2 番目のセクションでは、コードで記述し、イベント ハンドラーを定義します。  左方向キーが押されたとき、 <xref:System.Windows.Controls.Button>キーボード フォーカス、ハンドラーが実行されますと<xref:System.Windows.Controls.Control.Background%2A>の色、<xref:System.Windows.Controls.Button>が変更されました。  場合は、キーが押されたが、左矢印キーではありません、<xref:System.Windows.Controls.Control.Background%2A>の色、<xref:System.Windows.Controls.Button>開始色に変更します。  
+  
+ [!code-csharp[InputOvw#Input_OvwKeyboardExampleHandlerCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwkeyboardexamplehandlercodebehind)]
+ [!code-vb[InputOvw#Input_OvwKeyboardExampleHandlerCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwkeyboardexamplehandlercodebehind)]  
+  
+### <a name="mouse-input-event-example"></a>マウス入力イベントの例  
+ 次の例では、<xref:System.Windows.Controls.Control.Background%2A>の色、<xref:System.Windows.Controls.Button>は、マウス ポインターが入ったときに変更、<xref:System.Windows.Controls.Button>します。  <xref:System.Windows.Controls.Control.Background%2A>色が復元されるは、マウスが離れるときに、<xref:System.Windows.Controls.Button>します。  
+  
+ 例では、最初のセクションを作成、 <xref:System.Windows.Controls.StackPanel>と<xref:System.Windows.Controls.Button>を制御し、イベント ハンドラーをアタッチ、 <xref:System.Windows.UIElement.MouseEnter>と<xref:System.Windows.UIElement.MouseLeave>イベントを<xref:System.Windows.Controls.Button>します。  
+  
+ [!code-xml[InputOvw#Input_OvwMouseExampleXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml#input_ovwmouseexamplexaml)]  
+  
+ [!code-csharp[InputOvw#Input_OvwMouseExampleUICodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwmouseexampleuicodebehind)]
+ [!code-vb[InputOvw#Input_OvwMouseExampleUICodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwmouseexampleuicodebehind)]  
+  
+ 例では、2 番目のセクションでは、コードで記述し、イベント ハンドラーを定義します。  マウスを移動したときに、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.Control.Background%2A>の色、<xref:System.Windows.Controls.Button>に変更されます[<xref:System.Windows.Media.Brushes.SlateGray%2A>します。  マウスが離れるときに、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.Control.Background%2A>の色、<xref:System.Windows.Controls.Button>に変更<xref:System.Windows.Media.Brushes.AliceBlue%2A>します。  
+  
+ [!code-csharp[InputOvw#Input_OvwMouseExampleEneterHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwmouseexampleeneterhandler)]
+ [!code-vb[InputOvw#Input_OvwMouseExampleEneterHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwmouseexampleeneterhandler)]  
+  
+ [!code-csharp[InputOvw#Input_OvwMouseExampleLeaveHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwmouseexampleleavehandler)]
+ [!code-vb[InputOvw#Input_OvwMouseExampleLeaveHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwmouseexampleleavehandler)]  
+  
+<a name="text_input"></a>   
+## <a name="text-input"></a>テキスト入力  
+ <xref:System.Windows.ContentElement.TextInput>イベントでは、デバイスに依存しない方法でテキストの入力をリッスンすることができます。 キーボードは、テキストの入力、音声認識、手書きの主要な手段と他の入力デバイスにもテキスト入力を生成できます。  
+  
+ キーボード入力を[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]まず送信して、適切な<xref:System.Windows.ContentElement.KeyDown>/<xref:System.Windows.ContentElement.KeyUp>イベントです。 これらのイベントが処理されないと、キーが (方向矢印などのコントロール キー) またはファンクション キーではなくテキスト、 <xref:System.Windows.ContentElement.TextInput>イベントが発生します。  常に単純な一対一マッピングの間ではない<xref:System.Windows.ContentElement.KeyDown>/<xref:System.Windows.ContentElement.KeyUp>と<xref:System.Windows.ContentElement.TextInput>イベントのため、複数のキーが入力されたテキストの単一文字を生成し、単一のキー操作で複数の文字の文字列を生成できます。  これを使用して、中国語、日本語、韓国語などの言語の場合に特に[!INCLUDE[TLA#tla_ime#plural](../../../../includes/tlasharptla-imesharpplural-md.md)]を対応するアルファベットで使用可能な文字数千を生成します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]送信、 <xref:System.Windows.ContentElement.KeyUp>/<xref:System.Windows.ContentElement.KeyDown>イベント、<xref:System.Windows.Input.KeyEventArgs.Key%2A>に設定されている<xref:System.Windows.Input.Key?displayProperty=fullName>場合は、キーストロークがの一部になる可能性があります、 <xref:System.Windows.ContentElement.TextInput>イベント (alt キーを押しながら S キーが押された場合、たとえば)。 これにより、コードで、 <xref:System.Windows.ContentElement.KeyDown>をチェックするイベント ハンドラー <xref:System.Windows.Input.Key?displayProperty=fullName>し見つかると、発生した後のハンドラーの処理のままの場合は、 <xref:System.Windows.ContentElement.TextInput>イベントです。 これらのケースのさまざまなプロパティで、 <xref:System.Windows.Input.TextCompositionEventArgs>を引数の使用を元のキー入力を特定します。 同様に場合、[!INCLUDE[TLA2#tla_ime](../../../../includes/tla2sharptla-ime-md.md)]アクティブになっている<xref:System.Windows.Input.Key>プロパティの値を持つ<xref:System.Windows.Input.Key?displayProperty=fullName>、および<xref:System.Windows.Input.KeyEventArgs.ImeProcessedKey%2A>元のキーストロークやキー入力を提供します。  
+  
+ 次の例のハンドラーを定義する、 <xref:System.Windows.Controls.Primitives.ButtonBase.Click>イベントとハンドラーを<xref:System.Windows.UIElement.KeyDown>イベントです。  
+  
+ コードまたはマークアップの最初のセグメントでは、ユーザー インターフェイスを作成します。  
+  
+ [!code-xml[InputOvw#Input_OvwTextInputXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml#input_ovwtextinputxaml)]  
+  
+ [!code-csharp[InputOvw#Input_OvwTextInputUICodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwtextinputuicodebehind)]
+ [!code-vb[InputOvw#Input_OvwTextInputUICodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwtextinputuicodebehind)]  
+  
+ コードの&2; つ目のセグメントには、イベント ハンドラーが含まれています。  
+  
+ [!code-csharp[InputOvw#Input_OvwTextInputHandlersCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml.cs#input_ovwtextinputhandlerscodebehind)]
+ [!code-vb[InputOvw#Input_OvwTextInputHandlersCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/InputOvw/VisualBasic/Page1.xaml.vb#input_ovwtextinputhandlerscodebehind)]  
+  
+ 入力イベントがイベントのルーティングをバブルアップため、 <xref:System.Windows.Controls.StackPanel>のどの要素に関係なくキーボード フォーカスがある入力を受け取ります。 <xref:System.Windows.Controls.TextBox>コントロールが最初に通知と`OnTextInputKeyDown`場合にのみ、ハンドラーが呼び出されます、 <xref:System.Windows.Controls.TextBox>入力を処理できませんでした。 場合、 <xref:System.Windows.UIElement.PreviewKeyDown>の代わりにイベントを使用、 <xref:System.Windows.UIElement.KeyDown> 、イベント、`OnTextInputKeyDown`ハンドラーが最初に呼び出されます。  
+  
+ この例では、処理ロジックの&2; 倍が書かれて —&1; つと時刻を ctrl キーを押しながら O、もう一度ボタンのイベント をクリックします。 入力イベントを直接処理する代わりに、コマンドを使用して、簡素化できます。  この概要と、コマンドが説明した[コマンドの実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)します。  
+  
+<a name="touch_and_manipulation"></a>   
+## <a name="touch-and-manipulation"></a>タッチと操作  
+ 新しいハードウェアと Windows 7 オペレーティング システム内の API は、アプリケーションに同時に複数のタッチからの入力を受信する機能を提供します。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]検出し、タッチが行われたときにイベントを発生させることによって、マウスやキーボードなど、他の入力に応答する場合と同様に、タッチ対応のアプリケーションを有効にします。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]タッチが発生したときのイベントの&2; つの型を公開します。 タッチ イベントと操作イベントです。 タッチ イベントでは、タッチ スクリーンとその動きにそれぞれの指の生データを提供します。 操作イベントは、入力を特定のアクションとして解釈されます。 イベントの両方の種類については、このセクションで説明します。  
+  
+### <a name="prerequisites"></a>必須コンポーネント  
+ タッチに応答するアプリケーションを開発する次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_ext](../../../../includes/vs-dev10-ext-md.md)]。  
+  
+-   Windows 7 です。  
+  
+-   Windows タッチをサポートするタッチ スクリーンなどのデバイス。  
+  
+### <a name="terminology"></a>用語  
+ 次の用語は、タッチが説明されているときに使用されます。  
+  
+-   **タッチ**は Windows 7 で認識されるユーザー入力の型です。 通常は、タッチは、タッチを検知画面に指を配置することによって開始されます。 ラップトップ コンピューターで一般的なタッチ パッドなどのデバイスはサポートしていないことタッチ デバイスは、指の位置とマウス入力の動きに単に変換する場合に注意してください。  
+  
+-   **マルチタッチ**同時に複数のポイントから行われるタッチです。 Windows 7 と[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]マルチタッチをサポートしています。 タッチのドキュメントで説明するときに[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]マルチタッチに概念を適用します。  
+  
+-   A**操作**タッチがオブジェクトに適用されている物理操作として解釈されるときに発生します。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、操作イベントは、変換、拡張、または回転操作としての入力を解釈します。  
+  
+-   A`touch device`タッチ スクリーンで&1; 本の指など、タッチ入力を生成するデバイスを表します。  
+  
+### <a name="controls-that-respond-to-touch"></a>タッチに応答するコントロール  
+ 次のコントロールにスクロールされて見えないコンテンツがある場合、コントロール全体に指をドラッグしてスクロールできます。  
+  
+-   <xref:System.Windows.Controls.ComboBox>  
+  
+-   <xref:System.Windows.Controls.ContextMenu>  
+  
+-   <xref:System.Windows.Controls.DataGrid>  
+  
+-   <xref:System.Windows.Controls.ListBox>  
+  
+-   <xref:System.Windows.Controls.ListView>  
+  
+-   <xref:System.Windows.Controls.MenuItem>  
+  
+-   <xref:System.Windows.Controls.TextBox>  
+  
+-   <xref:System.Windows.Controls.ToolBar>  
+  
+-   <xref:System.Windows.Controls.TreeView>  
+  
+ <xref:System.Windows.Controls.ScrollViewer>を定義、 <xref:System.Windows.Controls.ScrollViewer.PanningMode%2A?displayProperty=fullName>添付プロパティが有効かどうかタッチ パンは、水平、垂直方向に、これらの両方またはどちらも指定することができます。 <xref:System.Windows.Controls.ScrollViewer.PanningDeceleration%2A?displayProperty=fullName>プロパティは、どの程度の速度、スクロール速度が低下し、ユーザーがタッチ スクリーンから指を離したときを指定します。 <xref:System.Windows.Controls.ScrollViewer.PanningRatio%2A?displayProperty=fullName>添付プロパティは、スクロール オフセット平行移動操作オフセットとの比率を指定します。  
+  
+### <a name="touch-events"></a>タッチ イベント  
+ 基本クラス<xref:System.Windows.UIElement>、 <xref:System.Windows.UIElement3D>、および<xref:System.Windows.ContentElement>、サブスクライブしていることができますので、アプリケーションが応答する、タッチ イベントを定義します。 タッチ イベントは、アプリケーション オブジェクトの操作以外のものとしてタッチを解釈する場合に便利です。 たとえば、アプリケーションを&1; つまたは複数の指を描くには、ユーザーの使用は、タッチ イベントにサブスクライブです。  
+  
+ 次の&3; つのすべてのクラスは、次のイベントを定義するクラスに関係なく同じように、動作を定義します。  
+  
+-   <xref:System.Windows.UIElement.TouchDown>  
+  
+-   <xref:System.Windows.UIElement.TouchMove>  
+  
+-   <xref:System.Windows.UIElement.TouchUp>  
+  
+-   <xref:System.Windows.UIElement.TouchEnter>  
+  
+-   <xref:System.Windows.UIElement.TouchLeave>  
+  
+-   <xref:System.Windows.UIElement.PreviewTouchDown>  
+  
+-   <xref:System.Windows.UIElement.PreviewTouchMove>  
+  
+-   <xref:System.Windows.UIElement.PreviewTouchUp>  
+  
+-   <xref:System.Windows.UIElement.GotTouchCapture>  
+  
+-   <xref:System.Windows.UIElement.LostTouchCapture>  
+  
+ キーボードとマウス イベントと同様には、タッチ イベントは、ルーティングされたイベントです。 始まるイベント`Preview`で始まるイベントとイベントにトンネリング`Touch`バブリング イベントです。 ルーティングされたイベントの詳細については、次を参照してください。[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。 これらのイベントを処理する場合を呼び出して、任意の要素を基準とした、入力の位置を取得できます、 <xref:System.Windows.Input.TouchEventArgs.GetTouchPoint%2A>または<xref:System.Windows.Input.TouchEventArgs.GetIntermediateTouchPoints%2A>メソッドです。  
+  
+ タッチ イベント間の相互作用を理解するには、シナリオを考えます、ユーザーを要素に&1; 本の指を設定、要素では、指を動かした要素から指を離したします。 次の図は、バブル イベント (トンネルのイベントは、わかりやすくするため省略される) の実行を示しています。  
+  
+ ![タッチ イベントのシーケンス。](../../../../docs/framework/wpf/advanced/media/ndp-touchevents.png "NDP_TouchEvents")  
+タッチ イベント  
+  
+ 次の一覧では、上の図でイベントの順序について説明します。  
+  
+1.  <xref:System.Windows.UIElement.TouchEnter>イベントを要素にユーザーが指を設定すると、1 回発生します。  
+  
+2.  <xref:System.Windows.UIElement.TouchDown>イベント&1; 回発生します。  
+  
+3.  <xref:System.Windows.UIElement.TouchMove>要素内で指を動かしたときにイベントが複数回を発生します。  
+  
+4.  <xref:System.Windows.UIElement.TouchUp>イベント、ユーザーが、要素から指を離したときに&1; 回発生します。  
+  
+5.  <xref:System.Windows.UIElement.TouchLeave>イベント&1; 回発生します。  
+  
+ 複数の&2; 本の指を使用している場合、それぞれの指のイベントが発生します。  
+  
+### <a name="manipulation-events"></a>操作イベント  
+ アプリケーションが、オブジェクトを操作するユーザーを有効の場合、 <xref:System.Windows.UIElement>クラスは、操作イベントを定義します。 タッチの位置のレポートを簡単にタッチ イベントとは異なり、操作イベントは、入力の解釈方法を報告します。 ストアには、操作、変換、拡張、および回転の&3; 種類があります。 次の一覧では、3 種類の操作を呼び出す方法について説明します。  
+  
+-   オブジェクト上に指を置き、平行移動操作を呼び出すためのタッチ スクリーンで指を移動します。 これは通常、オブジェクトを移動します。  
+  
+-   オブジェクトに&2; 本の指を配置し、離したり近づけたり拡大と縮小操作を呼び出すために、指を移動します。 通常、これのサイズは、オブジェクトを変更します。  
+  
+-   オブジェクトを&2; 本の指を保存し、本の指の周りの回転操作を呼び出すために互いを回転します。 これは通常、オブジェクトを回転します。  
+  
+ 操作の&1; つ以上の型に同時に発生します。  
+  
+ オブジェクトを操作に応答すると、オブジェクトが、慣性があることができます。 物理世界をシミュレーションして、オブジェクトがあることがあります。 たとえば、ハードにプッシュする場合に、テーブル上でブックをプッシュした場合はすぎると、書籍は引き続き、リリース後に移動します。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]オブジェクトからユーザーの指を離した後に操作イベントを発生させることによってこの動作をシミュレートできます。  
+  
+ ユーザーが移動、サイズ変更、およびオブジェクトを回転させることができるアプリケーションを作成する方法については、次を参照してください。[チュートリアル: 初めてのタッチ アプリケーションの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-your-first-touch-application.md)します。  
+  
+ <xref:System.Windows.UIElement>次の操作イベントを定義します。  
+  
+-   <xref:System.Windows.UIElement.ManipulationStarting>  
+  
+-   <xref:System.Windows.UIElement.ManipulationStarted>  
+  
+-   <xref:System.Windows.UIElement.ManipulationDelta>  
+  
+-   <xref:System.Windows.UIElement.ManipulationInertiaStarting>  
+  
+-   <xref:System.Windows.UIElement.ManipulationCompleted>  
+  
+-   <xref:System.Windows.UIElement.ManipulationBoundaryFeedback>  
+  
+ 既定では、 <xref:System.Windows.UIElement>これらの操作イベントを受信しません。 操作イベントを受信する、 <xref:System.Windows.UIElement>、 <xref:System.Windows.UIElement.IsManipulationEnabled%2A?displayProperty=fullName>に`true`します。  
+  
+#### <a name="the-execution-path-of-manipulation-events"></a>操作イベントの実行パス  
+ ここでユーザー「オブジェクトをスロー」シナリオを検討してください。 短距離間のタッチ スクリーンで指を移動するユーザー、オブジェクト上に指を置きし、移動中に指を離します。 この結果は、オブジェクトがユーザーの指の下に移動し、ユーザーが指を離した後を移動しているです。  
+  
+ 次の図は、操作イベントと各イベントに関する重要な情報の実行パスを示します。  
+  
+ ![操作イベントのシーケンス。](../../../../docs/framework/wpf/advanced/media/ndp-manipulationevents.png "NDP_ManipulationEvents")  
+操作イベント  
+  
+ 次の一覧では、上の図でイベントの順序について説明します。  
+  
+1.  <xref:System.Windows.UIElement.ManipulationStarting>イベント オブジェクトのユーザーが指を置いたときに発生します。 このイベントでは特に、使用する設定、 <xref:System.Windows.Input.ManipulationStartingEventArgs.ManipulationContainer%2A>プロパティです。 後続のイベントで、操作の位置が基準にでは、 <xref:System.Windows.Input.ManipulationStartingEventArgs.ManipulationContainer%2A>します。 以外のイベントで<xref:System.Windows.UIElement.ManipulationStarting>、このプロパティは読み取り専用ため、 <xref:System.Windows.UIElement.ManipulationStarting>イベントは、このプロパティを設定するだけの時間。  
+  
+2.  <xref:System.Windows.UIElement.ManipulationStarted>イベントが次に発生します。 このイベントは、操作の始点を報告します。  
+  
+3.  <xref:System.Windows.UIElement.ManipulationDelta>イベントがタッチ スクリーンでユーザーの指の移動として複数回に発生します。 <xref:System.Windows.Input.ManipulationDeltaEventArgs.DeltaManipulation%2A>のプロパティ、 <xref:System.Windows.Input.ManipulationDeltaEventArgs>クラスは、操作が、移動、拡張、または平行移動として解釈されるかどうかを報告します。 これは、ほとんどのオブジェクトを操作するための作業を実行する場所です。  
+  
+4.  <xref:System.Windows.UIElement.ManipulationInertiaStarting>イベント、ユーザーの指のオブジェクトとの接続が失われるときに発生します。 このイベントでは、慣性による処理中の操作の減速を指定することができます。 これは、オブジェクトから選択した場合、別の物理領域または属性をエミュレートできますのでです。 たとえば、アプリケーションには、現実世界のアイテムを表す&2; つのオブジェクトが含まれているし、もう一方よりも&1; つです。 重いオブジェクトを軽量のオブジェクトよりも高速減速を行うことができます。  
+  
+5.  <xref:System.Windows.UIElement.ManipulationDelta>慣性を実行すると、イベントが複数回を発生します。 このイベントは発生、ユーザーの指がタッチ スクリーンの間で移動するとき、およびメモ[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]慣性をシミュレートします。 つまり、 <xref:System.Windows.UIElement.ManipulationDelta>前に、と後に発生する、 <xref:System.Windows.UIElement.ManipulationInertiaStarting>イベントです。 <xref:System.Windows.Input.ManipulationDeltaEventArgs.IsInertial%2A?displayProperty=fullName>プロパティ レポートかどうか、 <xref:System.Windows.UIElement.ManipulationDelta>そのプロパティをチェックし、その値に応じて、さまざまなアクションを実行できるように、イベントが、慣性の中に発生します。  
+  
+6.  <xref:System.Windows.UIElement.ManipulationCompleted>イベントが発生して、慣性の操作が終了した場合。 後のすべて、 <xref:System.Windows.UIElement.ManipulationDelta>イベントが発生する、 <xref:System.Windows.UIElement.ManipulationCompleted>イベントは、操作が完了したことを通知するために発生します。  
+  
+ <xref:System.Windows.UIElement>も定義して、 <xref:System.Windows.UIElement.ManipulationBoundaryFeedback>イベントです。 このイベントが発生したときに、 <xref:System.Windows.Input.ManipulationDeltaEventArgs.ReportBoundaryFeedback%2A>メソッドが呼び出される、 <xref:System.Windows.UIElement.ManipulationDelta>イベントです。 <xref:System.Windows.UIElement.ManipulationBoundaryFeedback>イベント オブジェクトの境界に達すると、視覚的なフィードバックを提供するには、アプリケーションまたはコンポーネントを有効にします。 たとえば、<xref:System.Windows.Window>クラスのハンドル、 <xref:System.Windows.UIElement.ManipulationBoundaryFeedback>を若干移動の端が発生した場合にウィンドウが発生するイベントです。  
+  
+ 呼び出して、操作を取り消すことができます、<xref:System.Windows.Input.ManipulationStartingEventArgs.Cancel%2A>メソッドを除く任意の操作イベントのイベント引数を<xref:System.Windows.UIElement.ManipulationBoundaryFeedback>イベントです。 呼び出すと<xref:System.Windows.Input.ManipulationStartingEventArgs.Cancel%2A>操作イベントが発生した不要になった、およびタッチのマウス イベントが発生します。 次の表では、時間が、操作が取り消されると発生するマウス イベント間のリレーションシップについて説明します。  
+  
+|キャンセルが呼び出されるイベント|入力が既に発生したために発生するマウス イベント|  
+|----------------------------------------|-----------------------------------------------------------------|  
+|<xref:System.Windows.UIElement.ManipulationStarting>と<xref:System.Windows.UIElement.ManipulationStarted>|マウス ダウン イベント。|  
+|<xref:System.Windows.UIElement.ManipulationDelta>|マウス ボタンを押す、マウス イベントに移動します。|  
+|<xref:System.Windows.UIElement.ManipulationInertiaStarting>と<xref:System.Windows.UIElement.ManipulationCompleted>|マウスの移動、およびマウス イベント アップ ダウン マウスです。|  
+  
+ 呼び出す場合<xref:System.Windows.Input.ManipulationStartingEventArgs.Cancel%2A>メソッドが返す操作は、慣性が、`false`入力では、マウス イベントは発生しません。  
+  
+### <a name="the-relationship-between-touch-and-manipulation-events"></a>タッチと操作イベント間のリレーションシップ  
+ A <xref:System.Windows.UIElement>タッチ イベントを常に表示されることができます。 ときに、 <xref:System.Windows.UIElement.IsManipulationEnabled%2A>にプロパティが設定されている`true`、 <xref:System.Windows.UIElement>タッチと操作の両方のイベントを受け取ることができます。  場合、<xref:System.Windows.UIElement.TouchDown>イベントが処理されない (つまり、 <xref:System.Windows.RoutedEventArgs.Handled%2A>プロパティは、 `false`)、操作のロジックが要素にタッチをキャプチャし、操作イベントを生成します。 場合、 <xref:System.Windows.RoutedEventArgs.Handled%2A>にプロパティが設定されている`true`で、<xref:System.Windows.UIElement.TouchDown>イベント、操作のロジックが操作イベントを生成しません。 次の図は、タッチ イベントと操作イベント間のリレーションシップを示しています。  
+  
+ ![タッチ イベントと操作イベント間のリレーションシップ](../../../../docs/framework/wpf/advanced/media/ndp-touchmanipulateevents.png "NDP_TouchManipulateEvents")  
+タッチ イベントと操作イベント  
+  
+ 次の一覧では、前の図に示されているタッチ、および操作のイベント間の関係について説明します。  
+  
+-   最初のタッチ デバイスが生成するとき、<xref:System.Windows.UIElement.TouchDown>でイベントを<xref:System.Windows.UIElement>、操作のロジックが、 <xref:System.Windows.UIElement.CaptureTouch%2A>を生成するメソッド、 <xref:System.Windows.UIElement.GotTouchCapture>イベントです。  
+  
+-   ときに、 <xref:System.Windows.UIElement.GotTouchCapture>発生すると、操作のロジックが、 <xref:System.Windows.Input.Manipulation.AddManipulator%2A?displayProperty=fullName>を生成するメソッド、 <xref:System.Windows.UIElement.ManipulationStarting>イベントです。  
+  
+-   ときに、 <xref:System.Windows.UIElement.TouchMove>イベントが発生した、操作のロジックを生成、 <xref:System.Windows.UIElement.ManipulationDelta>する前に発生するイベント、 <xref:System.Windows.UIElement.ManipulationInertiaStarting>イベントです。  
+  
+-   最後デバイスをタッチすると、要素を発生させます、<xref:System.Windows.UIElement.TouchUp>イベント、操作のロジックを生成、 <xref:System.Windows.UIElement.ManipulationInertiaStarting>イベントです。  
+  
+<a name="focus"></a>   
+## <a name="focus"></a>フォーカス  
+ フォーカスに関連する&2; つの主要な概念がある[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]: キーボード フォーカスと論理フォーカスします。  
+  
+### <a name="keyboard-focus"></a>キーボード フォーカス  
+ キーボード フォーカスはキーボード入力を受け取る要素を指します。  1 つだけ要素デスクトップ全体でキーボード フォーカスがあることができます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、キーボード フォーカスを持つ要素がある<xref:System.Windows.IInputElement.IsKeyboardFocused%2A>設定`true`します。  静的な<xref:System.Windows.Input.Keyboard>メソッド<xref:System.Windows.Input.Keyboard.FocusedElement%2A>キーボード フォーカスされている要素を返します。  
+  
+ 要素のタブ オーダーをかなど、特定の要素上にマウス ポインターをクリックして、キーボード フォーカスを取得できます、 <xref:System.Windows.Controls.TextBox>します。  キーボード フォーカスを使用してプログラムを使用して取得も可能、<xref:System.Windows.Input.Keyboard.Focus%2A>メソッドを<xref:System.Windows.Input.Keyboard>クラスです。  <xref:System.Windows.Input.Keyboard.Focus%2A>キーボード フォーカスの指定した要素を提供しようとします。  によって返される要素<xref:System.Windows.Input.Keyboard.Focus%2A>キーボード フォーカスされている要素です。  
+  
+ キーボード フォーカスを取得する要素の順序で、 <xref:System.Windows.UIElement.Focusable%2A>プロパティおよび<xref:System.Windows.UIElement.IsVisible%2A>にプロパティを設定する必要があります**true**します。  などのいくつかのクラス<xref:System.Windows.Controls.Panel>が<xref:System.Windows.UIElement.Focusable%2A>に設定`false`既定ではこのため、ありますこのプロパティを設定する`true`する場合はその要素にフォーカスを取得できません。  
+  
+ 次の例では使用<xref:System.Windows.Input.Keyboard.Focus%2A>キーボード フォーカスを設定する、<xref:System.Windows.Controls.Button>します。  アプリケーションの初期フォーカスを設定することをお勧めの場所は、 <xref:System.Windows.FrameworkElement.Loaded>イベント ハンドラーです。  
+  
+ [!code-csharp[focussample#FocusSampleSetFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSample/CSharp/Window1.xaml.cs#focussamplesetfocus)]
+ [!code-vb[focussample#FocusSampleSetFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSample/visualbasic/window1.xaml.vb#focussamplesetfocus)]  
+  
+ キーボード フォーカスの詳細については、次を参照してください。[フォーカス概要](../../../../docs/framework/wpf/advanced/focus-overview.md)します。  
+  
+### <a name="logical-focus"></a>論理フォーカス  
+ 論理フォーカスとは、 <xref:System.Windows.Input.FocusManager.FocusedElement%2A?displayProperty=fullName>フォーカス範囲内です。  アプリケーションでは、論理フォーカスのある複数の要素がありますされる可能性しますが、ありますのみ特定のフォーカスの範囲で論理フォーカスのある&1; つの要素。  
+  
+ フォーカス範囲を追跡するコンテナー要素とは、 <xref:System.Windows.Input.FocusManager.FocusedElement%2A>そのスコープ内で。  フォーカスは、フォーカスの範囲を離れる、フォーカスがある要素にキーボード フォーカスは失われますが、論理フォーカスを保持します。  フォーカスのスコープに戻ると、フォーカスがある要素はキーボード フォーカスを取得します。  これにより、複数のフォーカス範囲の間で変更にキーボード フォーカスが、フォーカス範囲内でフォーカスがある要素がフォーカスが戻るときに、フォーカスがある要素がすることを保証します。  
+  
+ フォーカスの範囲内に要素を変換できます[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]を設定して、 <xref:System.Windows.Input.FocusManager>添付プロパティ<xref:System.Windows.Input.FocusManager.IsFocusScope%2A>に`true`、またはコードを使用して添付プロパティを設定して、 <xref:System.Windows.Input.FocusManager.SetIsFocusScope%2A>メソッドです。  
+  
+ 次の例では、 <xref:System.Windows.Controls.StackPanel>を設定してフォーカス スコープ内に、 <xref:System.Windows.Input.FocusManager.IsFocusScope%2A>添付プロパティです。  
+  
+ [!code-xml[MarkupSnippets#MarkupIsFocusScopeXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MarkupSnippets/CSharp/Window1.xaml#markupisfocusscopexaml)]  
+  
+ [!code-csharp[FocusSnippets#FocusSetIsFocusScope](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FocusSnippets/CSharp/Window1.xaml.cs#focussetisfocusscope)]
+ [!code-vb[FocusSnippets#FocusSetIsFocusScope](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FocusSnippets/visualbasic/window1.xaml.vb#focussetisfocusscope)]  
+  
+ 内のクラス[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]は既定でフォーカス範囲である<xref:System.Windows.Window>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.ToolBar>、および<xref:System.Windows.Controls.ContextMenu>します。  
+  
+ キーボード フォーカスを持つ要素には、; に属しているフォーカス範囲の論理フォーカスがあります。したがって、と共に要素にフォーカスを設定する、<xref:System.Windows.Input.Keyboard.Focus%2A>メソッドを<xref:System.Windows.Input.Keyboard>要素キーボード フォーカス、論理フォーカスを提供するクラスまたは基本要素クラスを試みます。  
+  
+ フォーカスの範囲内のフォーカスがある要素を調べるには使用<xref:System.Windows.Input.FocusManager.GetFocusedElement%2A>します。 フォーカスのスコープにフォーカスがある要素を変更するには、使用<xref:System.Windows.Input.FocusManager.SetFocusedElement%2A>します。  
+  
+ 論理フォーカスの詳細については、次を参照してください。[フォーカス概要](../../../../docs/framework/wpf/advanced/focus-overview.md)します。  
+  
+<a name="mouse_position"></a>   
+## <a name="mouse-position"></a>マウスの位置  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]入力[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]の座標空間に関して役に立つ情報を提供します。  たとえば、調整`(0,0)`は左上隅の座標が、ツリー内のどの要素の左上隅ですか? 入力先である要素。 イベント ハンドラーに関連付けられている要素ですか。 または、別のものですか。 混乱を避けるために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]入力[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]マウス経由で取得した座標に使用する場合は、参照、フレームを指定することが必要です。 <xref:System.Windows.Input.Mouse.GetPosition%2A>メソッドは、指定した要素に相対的なマウス ポインターの座標を返します。  
+  
+<a name="mouse_capture"></a>   
+## <a name="mouse-capture"></a>マウスのキャプチャ  
+ 具体的には、マウス デバイスは、マウスのキャプチャと呼ばれるモーダル特性を保持します。 マウスのキャプチャはその他の操作画面に表示される、基準に関連するマウス ポインターの位置が必ずしも行われないように、ドラッグ アンド ドロップ操作が開始されると、入力の遷移状態を維持するために使用されます。 ドラッグ中に、ユーザーは、ドラッグ アンド ドロップ、マウスのキャプチャがドラッグ元によって保持されている間、ほとんどのマウスを置いたときのキューを不適切なためを中止せずクリックしてできません。 入力システムを公開[!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)]マウスのキャプチャの状態を決定するだけでなく[!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)]強制的に特定の要素をマウスのキャプチャまたはマウスのキャプチャ状態をオフにすることができます。 ドラッグ アンド ドロップ操作の詳細については、次を参照してください。[ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)します。  
+  
+<a name="commands"></a>   
+## <a name="commands"></a>コマンド  
+ コマンドは、デバイスの入力よりもより意味的なレベルでの入力の処理を有効にします。  コマンドは、単純なディレクティブなど`Cut`、 `Copy`、 `Paste`、または`Open`です。  コマンドは、コマンド ロジックを集中管理するために便利です。  アクセスできるように、同じコマンド、<xref:System.Windows.Controls.Menu>の<xref:System.Windows.Controls.ToolBar>、または、ショートカット キー。 コマンドには、コマンドが使用できなくなったときに、コントロールを無効にするためのメカニズムも提供します。  
+  
+ <xref:System.Windows.Input.RoutedCommand>は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]の実装<xref:System.Windows.Input.ICommand>します。  ときに、 <xref:System.Windows.Input.RoutedCommand>が実行される、 <xref:System.Windows.Input.CommandManager.PreviewExecuted>と<xref:System.Windows.Input.CommandManager.Executed>イベントがどのトンネルおよび要素ツリーでバブルのようなその他の入力のコマンドのターゲットで発生します。  コマンド ターゲットが設定されていない場合は、キーボード フォーカスを持つ要素がコマンドの対象となります。  コマンドを実行するロジックに接続されている、 <xref:System.Windows.Input.CommandBinding>します。  ときに、 <xref:System.Windows.Input.CommandManager.Executed>イベントに達すると、 <xref:System.Windows.Input.CommandBinding> 、特定のコマンド、 <xref:System.Windows.Input.ExecutedRoutedEventHandler>で、 <xref:System.Windows.Input.CommandBinding>が呼び出されます。  このハンドラーは、コマンドの操作を実行します。  
+  
+ コマンド実行の詳細については、次を参照してください。[コマンドの実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]構成される一般的なコマンドのライブラリが用意されて<xref:System.Windows.Input.ApplicationCommands>、 <xref:System.Windows.Input.MediaCommands>、 <xref:System.Windows.Input.ComponentCommands>、 <xref:System.Windows.Input.NavigationCommands>、および<xref:System.Windows.Documents.EditingCommands>、独自に定義することもできます。  
+  
+ 次の例を設定する方法を示しています、 <xref:System.Windows.Controls.MenuItem>が呼び出すことがクリックされたとき、<xref:System.Windows.Input.ApplicationCommands.Paste%2A>コマンドを<xref:System.Windows.Controls.TextBox>と見なし、 <xref:System.Windows.Controls.TextBox>キーボード フォーカスがあります。  
+  
+ [!code-xml[CommandingOverviewSnippets#CommandingOverviewSimpleCommand](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml#commandingoverviewsimplecommand)]  
+  
+ [!code-csharp[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#commandingoverviewcommandtargetcodebehind)]
+ [!code-vb[CommandingOverviewSnippets#CommandingOverviewCommandTargetCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#commandingoverviewcommandtargetcodebehind)]  
+  
+ 内のコマンドの詳細については[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]を参照してください[コマンドの実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)します。  
+  
+<a name="the_input_system_and_base_elements"></a>   
+## <a name="the-input-system-and-base-elements"></a>入力システムと基本要素  
+ 入力イベントによって定義された接続されているイベントなど、<xref:System.Windows.Input.Mouse>、<xref:System.Windows.Input.Keyboard>、および<xref:System.Windows.Input.Stylus>クラスが入力システムによって生成され、ヒット実行時に、ビジュアル ツリーをテストに基づくオブジェクト モデルの特定の位置に挿入します。  
+  
+ 各イベントを<xref:System.Windows.Input.Mouse>、<xref:System.Windows.Input.Keyboard>、および<xref:System.Windows.Input.Stylus>基本要素のクラスはアタッチされるイベントを再公開も、定義<xref:System.Windows.UIElement>と<xref:System.Windows.ContentElement>として新しいルーティングされたイベント。 基本要素のルーティング イベントは、元のアタッチされるイベントを処理し、イベント データを再利用するクラスによって生成されます。  
+  
+ 入力イベントは、基本要素の入力イベントの実装を通じて特定のソース要素に関連付けられてになるは、論理とビジュアル ツリーのオブジェクトの組み合わせに基づいており、アプリケーション コードで処理できるイベント ルートの残りの部分を介してルーティングすることができます。  一般に、各デバイスに関連する入力イベント処理にルーティングされたイベントを使用する方が便利です<xref:System.Windows.UIElement>と<xref:System.Windows.ContentElement>より直感的なイベント ハンドラーの構文両方で使用できるため、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]およびコード。 代わりに、プロセスを開始した、接続されているイベントを処理することもできますが、いくつかの問題が発生するとします。 基本要素のクラス処理によって、添付されたイベントをマークすると、アタッチされるイベントのハンドラーを接続するために実際のイベントの構文ではなく、アクセサー メソッドを使用する必要があります。  
+  
+<a name="whats_next"></a>   
+## <a name="whats-next"></a>次の内容  
+ いくつかの手法の入力を処理するようになりましたがある[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]です。  さまざまな種類の入力イベント、およびによって使用されるルーティングされたイベント メカニズムをよりよく把握も必要[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]します。  
+  
+ その他のリソースがあることを説明する[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]フレームワーク要素やイベントの詳細にルーティングします。 詳細については、次の概要を参照して[コマンドの実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)、[フォーカス概要](../../../../docs/framework/wpf/advanced/focus-overview.md)、 [Base 要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)、 [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)、および[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [フォーカスの概要](../../../../docs/framework/wpf/advanced/focus-overview.md)   
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)   
+ [ルーティングされたイベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)   
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/input-wpf.md b/docs/framework/wpf/advanced/input-wpf.md
new file mode 100644
index 00000000000..b673463b75a
--- /dev/null
+++ b/docs/framework/wpf/advanced/input-wpf.md
@@ -0,0 +1,53 @@
+---
+title: "入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コマンド実行"
+  - "入力 API"
+ms.assetid: 9a7ccd30-095b-4f34-b284-8fb7e8f95a9b
+caps.latest.revision: 72
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 72
+---
+# 入力
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は入力の型のサポートが含まれます。  この値はテキストタッチ イベントマウス イベントコマンドフォーカスタッチドラッグ アンド ドロップおよびデジタル インクが含まれています。  ここではWPF に入るために関するトピックについて説明します。  
+  
+## このセクションの内容  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)  
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)  
+ [フォーカスの概要](../../../../docs/framework/wpf/advanced/focus-overview.md)  
+ [コントロールのフォーカスのスタイルと FocusVisualStyle](../../../../docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md)  
+ [チュートリアル: 初めてのタッチ アプリケーションの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-your-first-touch-application.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/input-and-commands-how-to-topics.md)  
+ [デジタル インク](../../../../docs/framework/wpf/advanced/digital-ink.md)  
+  
+## 関連項目  
+ <xref:System.Windows.UIElement>  
+  
+ <xref:System.Windows.FrameworkElement>  
+  
+ <xref:System.Windows.ContentElement>  
+  
+ <xref:System.Windows.FrameworkContentElement>  
+  
+ <xref:System.Windows.Input.Keyboard>  
+  
+ <xref:System.Windows.Input.Mouse>  
+  
+ <xref:System.Windows.Input.FocusManager>  
+  
+## 関連項目  
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)  
+ [イベント](../../../../docs/framework/wpf/advanced/events-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md b/docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md
new file mode 100644
index 00000000000..805f253f8fc
--- /dev/null
+++ b/docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md
@@ -0,0 +1,80 @@
+---
+title: "スタイラスからの入力のインターセプト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アーキテクチャ, System.Windows.Input.StylusPlugIns"
+  - "InkCanvas, 追加 (プラグインを)"
+  - "プラグイン, スタイラス"
+  - "StylusPlugIns アーキテクチャ"
+  - "System.Windows.Input.StylusPlugIns アーキテクチャ"
+ms.assetid: 791bb2f0-4e5c-4569-ac3c-211996808d44
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# スタイラスからの入力のインターセプト
+<xref:System.Windows.Input.StylusPlugIns> アーキテクチャは、<xref:System.Windows.Input.Stylus> 入力およびデジタル インクの <xref:System.Windows.Ink.Stroke> オブジェクトの作成に対する低レベルの制御を実装するための機構です。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> クラスは、カスタム動作を実装し、その動作をスタイラス デバイスから取得されるデータのストリームに適用するための機構で、最高のパフォーマンスを実現するように作られています。  
+  
+ このトピックは、次の内容で構成されています。  
+  
+-   [アーキテクチャ](#Architecture)  
+  
+-   [スタイラス プラグインを実装する](#ImplementingStylusPlugins)  
+  
+-   [InkCanvas にプラグインを追加する](#AddingYourPluginToAnInkCanvas)  
+  
+-   [まとめ](#Conclusion)  
+  
+<a name="Architecture"></a>   
+## アーキテクチャ  
+ <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> は、[StylusInput](http://go.microsoft.com/fwlink/?LinkId=50753&clcid=0x409) の API を発展させたものです。この API については、「[Microsoft Windows XP Tablet PC Edition Software Development Kit 1.7](http://go.microsoft.com/fwlink/?linkid=11782&clcid=0x409)」の「[Accessing and Manipulating Pen Input](http://go.microsoft.com/fwlink/?LinkId=50752&clcid=0x409)」を参照してください。  
+  
+ 各 <xref:System.Windows.UIElement> には、<xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> である <xref:System.Windows.UIElement.StylusPlugIns%2A> プロパティがあります。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> を要素の <xref:System.Windows.UIElement.StylusPlugIns%2A> プロパティに追加することにより、<xref:System.Windows.Input.StylusPoint> データをその生成時に操作できます。  <xref:System.Windows.Input.StylusPoint> データは、<xref:System.Windows.Input.StylusPoint.X%2A> および <xref:System.Windows.Input.StylusPoint.Y%2A> のポイント データや <xref:System.Windows.Input.StylusPoint.PressureFactor%2A> データなどの、システム デジタイザーでサポートされるすべてのプロパティから構成されます。  
+  
+ <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> を <xref:System.Windows.UIElement.StylusPlugIns%2A> プロパティに追加すると、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> オブジェクトは <xref:System.Windows.Input.Stylus> デバイスから取得されるデータのストリームに直接挿入されます。  プラグインを <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに追加する順序によって、プラグインが <xref:System.Windows.Input.StylusPoint> データを受信する順序が決まります。  たとえば、入力を特定の領域に制限するフィルター プラグインを追加した後に、書き込まれるジェスチャを認識するプラグインを追加した場合は、ジェスチャを認識するプラグインが受け取るデータは既にフィルター処理された <xref:System.Windows.Input.StylusPoint> データです。  
+  
+<a name="ImplementingStylusPlugins"></a>   
+## スタイラス プラグインを実装する  
+ プラグインを実装するには、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> の派生クラスを作成します。  このクラスは、<xref:System.Windows.Input.Stylus> からのデータのストリームに適用されます。  このクラスの中で、<xref:System.Windows.Input.StylusPoint> データの値を変更できます。  
+  
+> [!CAUTION]
+>  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> が例外をスローまたは発生させた場合、アプリケーションは終了します。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> を使用するコントロールを十分にテストし、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> が例外をスローしないことが確実な場合だけ、コントロールを使用するようにしてください。  
+  
+ <xref:System.Windows.Input.Stylus> デバイスから受け取る <xref:System.Windows.Input.StylusPoint> データの <xref:System.Windows.Input.StylusPoint.X%2A> と <xref:System.Windows.Input.StylusPoint.Y%2A> の値を変更することでスタイラス入力を制限するプラグインの例を次に示します。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#19)]
+ [!code-vb[AdvancedInkTopicsSamples#19](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#19)]  
+[!code-csharp[AdvancedInkTopicsSamples#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/DynamicRenderer.cs#3)]
+[!code-vb[AdvancedInkTopicsSamples#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdvancedInkTopicsSamples/VisualBasic/DynamicRenderer.vb#3)]  
+  
+<a name="AddingYourPluginToAnInkCanvas"></a>   
+## InkCanvas にプラグインを追加する  
+ カスタム プラグインを使用するための最も簡単方法は、InkCanvas から派生するクラスを実装し、<xref:System.Windows.UIElement.StylusPlugIns%2A> プロパティに追加することです。  
+  
+ インクをフィルター処理するカスタム <xref:System.Windows.Controls.InkCanvas> の例を次に示します。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/Window1.xaml.cs#4)]  
+  
+ `FilterInkCanvas` をアプリケーションに追加して実行すると、ユーザーがストロークを完了するまでインクは一定の領域に制限されないことがわかります。  これは、<xref:System.Windows.Controls.InkCanvas> には <xref:System.Windows.Controls.InkCanvas.DynamicRenderer%2A> プロパティがあり、このプロパティは <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> で、既に <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションのメンバーであるためです。  <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに追加したカスタム <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> は、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> が <xref:System.Windows.Input.StylusPoint> データを受信した後に、そのデータを受信します。  その結果、<xref:System.Windows.Input.StylusPoint> データがフィルター処理されるのは、ユーザーがペンを持ち上げてストロークを完了したときとなります。  ユーザーがインクを描画した時点でインクをフィルター処理するには、`FilterPlugin` を <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> の前に挿入する必要があります。  
+  
+ 次の C\# コードは、インク描画時にフィルター処理するカスタム <xref:System.Windows.Controls.InkCanvas> を示しています。  
+  
+ [!code-csharp[AdvancedInkTopicsSamples#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdvancedInkTopicsSamples/CSharp/Window1.xaml.cs#5)]  
+  
+<a name="Conclusion"></a>   
+## まとめ  
+ 独自の <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> クラスを派生させて <xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> コレクションに挿入することで、デジタル インクの動作を大幅に向上させることができます。  <xref:System.Windows.Input.StylusPoint> データが生成された時点でアクセスできるので、<xref:System.Windows.Input.Stylus> 入力をカスタマイズできるようになります。  このような、低レベルでの <xref:System.Windows.Input.StylusPoint> データへのアクセスが可能であることから、アプリケーションでのインク収集およびレンダリングの実装のパフォーマンスが最大になります。  
+  
+## 参照  
+ [高度なインク処理](../../../../docs/framework/wpf/advanced/advanced-ink-handling.md)   
+ [Accessing and Manipulating Pen Input \(ペン入力のアクセスと操作\)](http://go.microsoft.com/fwlink/?LinkId=50752&clcid=0x409)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/introduction-to-the-glyphrun-object-and-glyphs-element.md b/docs/framework/wpf/advanced/introduction-to-the-glyphrun-object-and-glyphs-element.md
new file mode 100644
index 00000000000..c29cf5b3c2a
--- /dev/null
+++ b/docs/framework/wpf/advanced/introduction-to-the-glyphrun-object-and-glyphs-element.md
@@ -0,0 +1,108 @@
+---
+title: "GlyphRun オブジェクトと Glyphs 要素の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "文字体裁、Glyphs 要素"
+  - "Glyphs 要素"
+  - "GlyphRun オブジェクト"
+  - "テキスト、グリフ"
+  - "グリフ [WPF]"
+  - "文字体裁、GlyphRun オブジェクト"
+ms.assetid: 746ca769-a331-4435-9b95-f72a883b67c1
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# GlyphRun オブジェクトと Glyphs 要素の概要
+このトピックの説明、 <xref:System.Windows.Media.GlyphRun>オブジェクトおよび<xref:System.Windows.Documents.Glyphs>要素。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="text_glyphrunovw_intro"></a>   
+## <a name="introduction-to-glyphrun"></a>GlyphRun の概要  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]では、高度なテキストに直接アクセスできるグリフ レベルのマークアップを含む<xref:System.Windows.Documents.Glyphs>を途中受信してテキストの書式設定後は保持しお客様にします。 これらの機能要件を指定する重要なサポート、別のテキストのレンダリングの各シナリオを次にします。  
+  
+1.  固定形式のドキュメントの画面表示されます。  
+  
+2.  シナリオを印刷します。  
+  
+    -   [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]デバイスのプリンター言語です。  
+  
+    -   [!INCLUDE[TLA#tla_mxdw](../../../../includes/tlasharptla-mxdw-md.md)]。  
+  
+    -   出力元の以前のプリンター ドライバー[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)]固定形式のアプリケーションです。  
+  
+    -   印刷スプール形式です。  
+  
+3.  固定形式のドキュメントの表示、以前のバージョンのクライアントを含む[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]やその他のコンピューティング デバイスです。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.Glyphs>と<xref:System.Windows.Media.GlyphRun>固定形式のドキュメントの表示と印刷のシナリオ用に設計されています。                      [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]いくつかの要素は、一般的なレイアウトと[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]などのシナリオ<xref:System.Windows.Controls.Label>と<xref:System.Windows.Controls.TextBlock>します。 レイアウトについての詳細と[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]シナリオを参照して、 [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)します。  
+  
+<a name="text_glyphrunovw_glyphrunobject"></a>   
+## <a name="the-glyphrun-object"></a>GlyphRun オブジェクト  
+ <xref:System.Windows.Media.GlyphRun>オブジェクトは、1 つのサイズに&1; つの描画スタイルで、1 つのフォントの書体のグリフのシーケンスを表します。  
+  
+ <xref:System.Windows.Media.GlyphRun>グリフ両方フォント詳細が含まれます<xref:System.Windows.Documents.Glyphs.Indices%2A>と個々 のグリフの位置。 元も含まれています。[!INCLUDE[TLA#tla_unicode](../../../../includes/tlasharptla-unicode-md.md)]コード ポイントの文字のグリフのバッファー オフセット マッピングの情報、および文字単位とグリフのフラグから生成された実行します。  
+  
+ <xref:System.Windows.Media.GlyphRun>高レベルに対応しています<xref:System.Windows.FrameworkElement>、<xref:System.Windows.Documents.Glyphs>します。                  <xref:System.Windows.Documents.Glyphs>要素ツリーを使用できます[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]を表すマークアップ<xref:System.Windows.Media.GlyphRun>出力します。  
+  
+<a name="text_glyphrunovw_glyphselement"></a>   
+## <a name="the-glyphs-element"></a>Glyphs 要素  
+ <xref:System.Windows.Documents.Glyphs>要素の出力を表す、 <xref:System.Windows.Media.GlyphRun>で[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。 次のマークアップ構文を説明するため、<xref:System.Windows.Documents.Glyphs>要素。  
+  
+ [!code-xml[GlyphsOvwSample1#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlyphsOvwSample1/CS/default.xaml#1)]  
+  
+ 次のプロパティの定義は、サンプルのマークアップ内の最初の&4; つの属性に対応します。  
+  
+|プロパティ|説明|  
+|--------------|-----------------|  
+|<xref:System.Windows.Documents.Glyphs.FontUri%2A>|リソース識別子を指定します。 ファイル名を Web [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)]、またはアプリケーションの .exe またはコンテナー リソース参照します。|  
+|<xref:System.Windows.Documents.Glyphs.FontRenderingEmSize%2A>|描画サーフェイスの単位 (既定値は.96 インチ) では、フォント サイズを指定します。|  
+|<xref:System.Windows.Documents.Glyphs.StyleSimulations%2A>|太字や斜体のスタイルのフラグを指定します。|  
+|<xref:System.Windows.Documents.Glyphs.BidiLevel%2A>|双方向のレイアウトのレベルを指定します。 偶数ゼロの値が左から右のレイアウトを示すもので、奇数の値は、右から左のレイアウトを意味します。|  
+  
+<a name="text_glyphrunovw_indicesproperty"></a>   
+### <a name="indices-property"></a>インデックスのプロパティ  
+ <xref:System.Windows.Documents.Glyphs.Indices%2A>プロパティは、グリフの仕様の文字列です。 一連のグリフは、1 つのクラスターを形成、クラスター内の最初のグリフの仕様は、グリフの数の仕様とコード ポイントの数は、クラスターを形成する結合によって前します。 <xref:System.Windows.Documents.Glyphs.Indices%2A>プロパティでは、次のプロパティを&1; つの文字列内に収集します。  
+  
+-   グリフのインデックス  
+  
+-   グリフのアドバンス幅  
+  
+-   グリフの添付ファイルのベクトルを組み合わせる  
+  
+-   コード ポイントからグリフへのクラスターのマッピング  
+  
+-   グリフ フラグ  
+  
+ それぞれのグリフの仕様では、次の形式があります。  
+  
+ `[GlyphIndex][,[Advance][,[uOffset][,[vOffset][,[Flags]]]]]`  
+  
+<a name="text_glyphrunovw_glyphmetrics"></a>   
+## <a name="glyph-metrics"></a>グリフのメトリック  
+ 各グリフ指定は、その他のメトリックを定義する<xref:System.Windows.Documents.Glyphs>します。 次の図では、2 文字の種類のグリフの印刷用のさまざまな特性を定義します。  
+  
+ ![グリフ単位のダイアグラム](../../../../docs/framework/wpf/advanced/media/glyph-example.png "glyph_example")  
+  
+<a name="text_glyphrunovw_glyphsmarkup"></a>   
+## <a name="glyphs-markup"></a>グリフのマークアップ  
+ 次のコード例のさまざまなプロパティを使用する方法を示しています、<xref:System.Windows.Documents.Glyphs>内の要素[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。  
+  
+ [!code-xml[GlyphsOvwSamp2#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlyphsOvwSamp2/CS/default.xaml#1)]  
+  
+## <a name="see-also"></a>関連項目  
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md b/docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md
new file mode 100644
index 00000000000..6740eb1f598
--- /dev/null
+++ b/docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md
@@ -0,0 +1,114 @@
+---
+title: "WindowsFormsHost 要素のレイアウトに関する考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デバイスに依存しないピクセル"
+  - "動的レイアウト [WPF 相互運用性]"
+  - "相互運用性 [WPF], Windows フォーム"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+  - "WindowsFormsHost 要素のレイアウトに関する考慮事項"
+ms.assetid: 3c574597-bbde-440f-95cc-01371f1a5d9d
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# WindowsFormsHost 要素のレイアウトに関する考慮事項
+ここでは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト システムの対話方法を説明します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] および [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]は、フォームまたはページでの要素のサイズ設定や配置について、違いはあっても似ているロジックをサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールをホストするハイブリッド ユーザー インターフェイス \(UI\) を作成する場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素により 2 つのレイアウト スキームが統合されます。  
+  
+## WPF と Windows のフォームのレイアウトの違い  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、解像度に依存しないレイアウトを使用します。  すべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウトのサイズは、デバイス非依存ピクセルを使用して指定されます。  デバイス非依存ピクセルのサイズは 1\/96 インチで、解像度に依存しないため、出力先が 72 dpi モニターであっても 19,200 dpi プリンターであっても、同様の結果を得ることができます。  
+  
+ また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は*動的レイアウト*に基づきます。  つまり、UI 要素は、そのコンテンツ、親レイアウト コンテナー、および使用できる画面サイズに合わせて自身をフォームまたはページ上に配置します。  動的レイアウトは、ローカリゼーションを容易にするために、UI 要素に含まれる文字列の長さが変わると、その要素のサイズと位置を自動的に調整します。  
+  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のレイアウトはデバイスに依存し、多くの場合、静的です。  通常、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールは、ハードウェア ピクセルで指定されたサイズを使用してフォーム上の絶対的な位置に配置されます。  ただし、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]は動的レイアウト機能もいくつかサポートします。これらのレイアウト機能について、次の表で簡単に説明します。  
+  
+|レイアウト機能|説明|  
+|-------------|--------|  
+|自動サイズ変更|一部の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールは、コンテンツが正しく表示されるように自身のサイズを変更します。  詳細については、「[AutoSize プロパティの概要](../../../../docs/framework/winforms/controls/autosize-property-overview.md)」を参照してください。|  
+|アンカーとドッキング|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールは、親コンテナーに基づく配置とサイズ設定をサポートします。  詳細については、「<xref:System.Windows.Forms.Control.Anchor%2A?displayProperty=fullName>」および「<xref:System.Windows.Forms.Control.Dock%2A?displayProperty=fullName>」を参照してください。|  
+|自動スケーリング|コンテナー コントロールは、出力デバイスの解像度、または既定のコンテナー フォントのサイズ \(ピクセル単位\) に基づいて自身とその子のサイズを変更します。  詳細については、「[Windows フォームにおける自動スケーリング](../../../../docs/framework/winforms/automatic-scaling-in-windows-forms.md)」を参照してください。|  
+|レイアウト コンテナー|<xref:System.Windows.Forms.FlowLayoutPanel> コントロールと <xref:System.Windows.Forms.TableLayoutPanel> コントロールはその子コンテンツを配置し、そのコンテンツに合わせて自身のサイズを設定します。|  
+  
+## レイアウトの制限  
+ 一般的に、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で可能な程度までスケーリングおよび変換することはできません。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素がホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]のレイアウト システムに統合する際の既知の制限を次のリストに示します。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、サイズを変更できなかったり、特定のサイズにしか設定できない場合があります。  たとえば、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] <xref:System.Windows.Forms.ComboBox> コントロールは、コントロールのフォント サイズで定義されている 1 つの高さしかサポートしていません。  要素を垂直方向に伸縮できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の動的レイアウトでも、ホストされている <xref:System.Windows.Forms.ComboBox> コントロールは同様に伸縮することはできません。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは回転または斜めにすることはできません。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、傾斜または回転変換が適用されると、<xref:System.Windows.Forms.Integration.WindowsFormsHost.LayoutError> イベントを発生させます。  この <xref:System.Windows.Forms.Integration.WindowsFormsHost.LayoutError> イベントを処理しないと、<xref:System.InvalidOperationException> が発生します。  
+  
+-   ほとんどの場合、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、比率を保持したまま拡大縮小することはできません。  コントロール全体のサイズは拡大縮小されますが、コントロールの子コントロールやコンポーネント要素のサイズは希望どおりに変更できません。  この制限は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] の各コントロールで拡大縮小をどの程度サポートしているかに依存します。  また、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールを 0 ピクセルのサイズまで縮小することはできません。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールは自動スケーリングをサポートし、フォームは自身とそのコントロールのサイズをフォントのサイズに基づいて自動的に変更します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ユーザー インターフェイスでは、フォント サイズを変更しても、レイアウト全体のサイズは変わりません。ただし、個々の要素は動的にサイズを変更できます。  
+  
+### z オーダー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ユーザー インターフェイスでは、要素の z オーダーを変更して重複を制御できます。  ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは別の HWND で描画されるため、常に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の一番上に描画されます。  
+  
+ また、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは <xref:System.Windows.Documents.Adorner> 要素の上に描画されます。  
+  
+## レイアウトの動作  
+ 次のセクションでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールをホストしているときのレイアウト動作の固有の側面について説明します。  
+  
+### スケーリング、単位変換、およびデバイス非依存  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素が [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] や [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のサイズに関連する操作を実行する場合には、常に 2 つの座標系が関連します。この 2 つの座標系は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] についてはデバイス非依存ピクセル、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]についてはハードウェア ピクセルです。  したがって、一貫性のあるレイアウトを実現するためには、正しい単位変換とスケーリング変換を適用する必要があります。  
+  
+ 座標系間の変換は、現在のデバイスの解像度、および <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素やその先祖に適用されたレイアウトまたはレンダリングの変換に基づいて行われます。  
+  
+ 出力デバイスが 96 dpi で、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素にスケーリングが適用されていない場合、1 デバイス非依存ピクセルは 1 ハードウェア ピクセルと等しくなります。  
+  
+ 他のすべての場合には、座標系のスケーリングが必要です。  ホストされているコントロールのサイズは変更されません。  代わりに、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、ホストされているコントロールと、そのすべての子コントロールをスケーリングしようとします。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]はスケーリングを完全にはサポートしないため、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、特定のコントロールがサポートする水準までスケーリングされます。  
+  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost.ScaleChild%2A> メソッドをオーバーライドして、ホスト対象の [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールにカスタムのスケーリング動作を提供します。  
+  
+ スケーリングに加えて、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、次の表で説明するように丸めおよびオーバーフローを処理します。  
+  
+|変換の問題|説明|  
+|-----------|--------|  
+|丸め|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のデバイス非依存ピクセルのサイズは `double` として指定され、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] のハードウェア ピクセルのサイズは `int` として指定されます。  `double` に基づくサイズが `int` に基づくサイズに変換される場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は標準の丸めを使用して、0.5 未満の小数値を 0 に切り下げます。|  
+|オーバーフロー|<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素が、`double` 値から `int` 値に変換されると、オーバーフローが発生する可能性があります。  <xref:System.Int32.MaxValue> よりも大きい値は、<xref:System.Int32.MaxValue> に設定されます。|  
+  
+### レイアウト関連のプロパティ  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素のレイアウト関連の動作を制御するプロパティは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素によって正しくマップされます。  詳細については、「[Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)」を参照してください。  
+  
+### ホストされているコントロールのレイアウトの変更  
+ ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのレイアウトの変更は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に伝達されて、レイアウトの更新をトリガーします。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> の <xref:System.Windows.UIElement.InvalidateMeasure%2A> メソッドにより、ホストされているコントロールでレイアウトが変更されると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト エンジンが実行されます。  
+  
+### 連続的にサイズ設定される Windows フォーム コントロール  
+ 連続的なスケーリングをサポートする [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト システムと全面的に対話します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、通常どおり <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドと <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドを使用して、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのサイズを設定し、配置します。  
+  
+### サイズ設定アルゴリズム  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、次の手順を使用して、ホストされているコントロールのサイズを設定します。  
+  
+1.  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドと <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドをオーバーライドします。  
+  
+2.  ホストされているコントロールのサイズを決定するために、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドは、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドに渡された制約から変換された制約を使用して、ホストされているコントロールの <xref:System.Windows.Forms.Control.GetPreferredSize%2A> メソッドを呼び出します。  
+  
+3.  <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドは、ホストされているコントロールを指定されたサイズ制約に設定しようとします。  
+  
+4.  ホストされているコントロールの <xref:System.Windows.Forms.Control.Size%2A> プロパティが指定された制約に一致すると、ホストされたコントロールのサイズは、その制約に合わせて設定されます。  
+  
+ 指定された制約に <xref:System.Windows.Forms.Control.Size%2A> プロパティが一致しない場合、ホストされているコントロールは連続的なサイズ設定をサポートしません。  たとえば、<xref:System.Windows.Forms.MonthCalendar> コントロールは不連続のサイズのみを許可します。  このコントロールで許可されるサイズは、高さと幅の両方について整数 \(月数を表す\) で構成されます。  このような場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は次のように動作します。  
+  
+-   指定された制約よりも大きいサイズを <xref:System.Windows.Forms.Control.Size%2A> プロパティが返す場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素はホストされているコントロールをクリップします。  高さと幅は別個に処理されるため、ホストされているコントロールはいずれの方向にもクリップされる可能性があります。  
+  
+-   指定された制約よりも小さいサイズを <xref:System.Windows.Forms.Control.Size%2A> プロパティが返す場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> はこのサイズ値を受け入れて、その値を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト システムに返します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [チュートリアル: WPF での Windows フォーム コントロールの配置](../../../../docs/framework/wpf/advanced/walkthrough-arranging-windows-forms-controls-in-wpf.md)   
+ [WPF 個の Windows フォームのコントロールの階層化](http://go.microsoft.com/fwlink/?LinkID=159971)   
+ [Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/layout.md b/docs/framework/wpf/advanced/layout.md
new file mode 100644
index 00000000000..bf0ccac674e
--- /dev/null
+++ b/docs/framework/wpf/advanced/layout.md
@@ -0,0 +1,160 @@
+---
+title: "レイアウト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], レイアウト システム"
+  - "レイアウト システム [WPF]"
+  - "WPF レイアウト システム"
+ms.assetid: 3eecdced-3623-403a-a077-7595453a9221
+caps.latest.revision: 31
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# レイアウト
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のレイアウト システムについて説明します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でユーザー インターフェイスを作成するには、レイアウトの計算が行われる方法とタイミングを理解することが重要です。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [要素の境界ボックス](#LayoutSystem_BoundingBox)  
+  
+-   [レイアウト システム](#LayoutSystem_Overview)  
+  
+-   [子のサイズ測定と配置](#LayoutSystem_Measure_Arrange)  
+  
+-   [パネル要素とカスタム レイアウトの動作](#LayoutSystem_PanelsCustom)  
+  
+-   [レイアウト パフォーマンスに関する留意事項](#LayoutSystem_Performance)  
+  
+-   [サブピクセル レンダリングとレイアウトの丸め](#LayoutSystem_LayoutRounding)  
+  
+-   [次の内容](#LayoutSystem_whatsnext)  
+  
+<a name="LayoutSystem_BoundingBox"></a>   
+## 要素の境界ボックス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのレイアウトについて考えるときは、すべての要素を囲む境界ボックスを理解することが重要です。  レイアウト システムで処理される各 <xref:System.Windows.FrameworkElement> は、レイアウトに組み込まれる四角形として考えることができます。  要素のレイアウト割り当て \(スロット\) の境界を返す <xref:System.Windows.Controls.Primitives.LayoutInformation> クラスが公開されています。  四角形のサイズは、使用可能な画面スペース、制約のサイズ、余白やパディングなどのレイアウト固有のプロパティ、および親 <xref:System.Windows.Controls.Panel> 要素の個々の動作を計算して決定されます。  このデータを処理して、レイアウト システムは特定の <xref:System.Windows.Controls.Panel> のすべての子の位置を計算できます。  親要素で定義されたサイズ設定特性 \(<xref:System.Windows.Controls.Border> など\) は、その子に影響するという点に注意することが重要です。  
+  
+ 次の図は、単純な配置を表しています。  
+  
+ ![一般的なグリッド、重ね合わせる境界ボックスなし。](../../../../docs/framework/wpf/advanced/media/boundingbox1.png "boundingbox1")  
+  
+ このレイアウトは、次の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して実現できます。  
+  
+ [!code-xml[LayoutInformation#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LayoutInformation/CSharp/Window1.xaml#1)]  
+  
+ 1 つの <xref:System.Windows.Controls.TextBlock> 要素が <xref:System.Windows.Controls.Grid> 内にホストされています。  テキストは配置先の列の左上隅だけを占めていますが、実際にはそれよりもかなり大きいスペースが <xref:System.Windows.Controls.TextBlock> に割り当てられています。  <xref:System.Windows.Controls.Primitives.LayoutInformation.GetLayoutSlot%2A> メソッドを使用して、任意の <xref:System.Windows.FrameworkElement> の境界ボックスを取得できます。  次の図は、<xref:System.Windows.Controls.TextBlock> 要素の境界ボックスを示しています。  
+  
+ ![TextBlock の境界ボックスが表示されます。](../../../../docs/framework/wpf/advanced/media/boundingbox2.png "boundingbox2")  
+  
+ 黄色い四角形で示すように、<xref:System.Windows.Controls.TextBlock> 要素には、実際には外観よりかなり大きいスペースが割り当てられています。  <xref:System.Windows.Controls.Grid> に要素が追加されると、この割り当ては、追加された要素の型やサイズに応じて縮小または拡張されます。  
+  
+ <xref:System.Windows.Controls.TextBlock> のレイアウト スロットは、<xref:System.Windows.Controls.Primitives.LayoutInformation.GetLayoutSlot%2A> メソッドを使用して、<xref:System.Windows.Shapes.Path> に変換されます。  この方法は、要素の境界ボックスを表示する場合に便利です。  
+  
+ [!code-csharp[LayoutInformation#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LayoutInformation/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[LayoutInformation#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/LayoutInformation/VisualBasic/Window1.xaml.vb#2)]  
+  
+<a name="LayoutSystem_Overview"></a>   
+## レイアウト システム  
+ 簡単に言うと、レイアウトは、要素のサイズ測定、配置、および描画を繰り返す再帰的なシステムです。  具体的には、レイアウトとは、<xref:System.Windows.Controls.Panel> 要素の <xref:System.Windows.Controls.Panel.Children%2A> コレクションのメンバーを測定し位置を決定するプロセスを表します。  レイアウトは、負荷の高いプロセスです。  <xref:System.Windows.Controls.Panel.Children%2A> コレクションが大きくなるにつれ、実行が必要な計算の数も多くなります。  コレクションを所有する <xref:System.Windows.Controls.Panel> 要素で定義されるレイアウト動作のために、複雑になる場合もあります。  <xref:System.Windows.Controls.Canvas> などの比較的単純な <xref:System.Windows.Controls.Panel> では、<xref:System.Windows.Controls.Grid> などのより複雑な <xref:System.Windows.Controls.Panel> に比べて、大幅に優れたパフォーマンスを実現できます。  
+  
+ 子 <xref:System.Windows.UIElement> の位置が変更されるたびに、レイアウト システムによって新しいパスがトリガーされる可能性があります。  したがって、不要な呼び出しによってアプリケーションのパフォーマンスが低下する可能性があるので、レイアウト システムを呼び出す可能性があるイベントを理解しておくことが重要です。  次に示すのは、レイアウト システムが呼び出されたときに発生するプロセスです。  
+  
+1.  子 <xref:System.Windows.UIElement> は、最初にそのコア プロパティを測定して、レイアウト プロセスを開始します。  
+  
+2.  <xref:System.Windows.FrameworkElement.Width%2A>、<xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.Margin%2A> など、<xref:System.Windows.FrameworkElement> で定義されるサイズ設定プロパティが評価されます。  
+  
+3.  <xref:System.Windows.Controls.Dock> 方向やスタック <xref:System.Windows.Controls.StackPanel.Orientation%2A> など、<xref:System.Windows.Controls.Panel> 固有のロジックが適用されます。  
+  
+4.  すべての子が測定された後、コンテンツが配置されます。  
+  
+5.  <xref:System.Windows.Controls.Panel.Children%2A> コレクションが画面に描画されます。  
+  
+6.  <xref:System.Windows.Controls.Panel.Children%2A> がコレクションに追加された場合、<xref:System.Windows.FrameworkElement.LayoutTransform%2A> が適用された場合、または <xref:System.Windows.UIElement.UpdateLayout%2A> メソッドが呼び出された場合は、プロセスが再度呼び出されます。  
+  
+ このプロセス、およびプロセスが呼び出される方法については、以降のセクションで詳しく定義します。  
+  
+<a name="LayoutSystem_Measure_Arrange"></a>   
+## 子のサイズ測定と配置  
+ レイアウト システムは、<xref:System.Windows.Controls.Panel.Children%2A> コレクションのメンバーごとに、測定パスと配置パスという 2 つのパスを実行します。  各子 <xref:System.Windows.Controls.Panel> では、それぞれ固有のレイアウト動作を実現するために、独自の <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドと <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドが用意されています。  
+  
+ 測定パスの実行中に、<xref:System.Windows.Controls.Panel.Children%2A> コレクションの各メンバーが評価されます。  このプロセスは、<xref:System.Windows.UIElement.Measure%2A> メソッドの呼び出しで開始されます。  このメソッドは、親 <xref:System.Windows.Controls.Panel> 要素の実装内で呼び出され、レイアウトを実行するために明示的に呼び出す必要はありません。  
+  
+ 最初に、<xref:System.Windows.UIElement.Clip%2A>、<xref:System.Windows.UIElement.Visibility%2A> などの <xref:System.Windows.UIElement> のネイティブ サイズ プロパティが評価されます。  これにより、<xref:System.Windows.FrameworkElement.MeasureCore%2A> に渡される `constraintSize` という値が生成されます。  
+  
+ 次に、<xref:System.Windows.FrameworkElement> で定義されたフレームワーク プロパティが処理され、`constraintSize` の値に反映されます。  これらのプロパティは、一般に、<xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、<xref:System.Windows.FrameworkElement.Margin%2A>、<xref:System.Windows.FrameworkElement.Style%2A> など、基になる <xref:System.Windows.UIElement> のサイズ特性を表しています。  これらの各プロパティにより、要素の表示に必要な領域が変更されることがあります。  続いて、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> が `constraintSize` と共にパラメーターとして呼び出されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.FrameworkElement.Height%2A> および <xref:System.Windows.FrameworkElement.Width%2A> と <xref:System.Windows.FrameworkElement.ActualHeight%2A> および <xref:System.Windows.FrameworkElement.ActualWidth%2A> の各プロパティには違いがあります。  たとえば、<xref:System.Windows.FrameworkElement.ActualHeight%2A> プロパティは、他の高さの入力やレイアウト システムを基に計算された値です。  この値は、実際の描画パスに基づいて、レイアウト システム自体によって設定されるため、入力変更の基準となる <xref:System.Windows.FrameworkElement.Height%2A> などのプロパティの設定値よりも少し遅れることがあります。  
+>   
+>  <xref:System.Windows.FrameworkElement.ActualHeight%2A> は計算値であるため、レイアウト システムによるさまざまな操作の結果として、複数または追加の変更がレポートされる可能性があることに注意してください。  子要素、親要素による制約などに必要な測度空間をレイアウト システムが計算している場合があります。  
+  
+ 測定パスの最終的な目標は、子の <xref:System.Windows.UIElement.DesiredSize%2A> が決定されることです。これは、<xref:System.Windows.FrameworkElement.MeasureCore%2A> の呼び出し時に行われます。  この <xref:System.Windows.UIElement.DesiredSize%2A> 値は、<xref:System.Windows.UIElement.Measure%2A> に格納され、コンテンツの配置パスで使用されます。  
+  
+ 配置パスは、<xref:System.Windows.UIElement.Arrange%2A> メソッドの呼び出しで開始されます。  配置パスでは、親 <xref:System.Windows.Controls.Panel> 要素から、子の境界を表す四角形が生成されます。  この値は、<xref:System.Windows.FrameworkElement.ArrangeCore%2A> メソッドに渡されて処理されます。  
+  
+ <xref:System.Windows.FrameworkElement.ArrangeCore%2A> メソッドは子の <xref:System.Windows.UIElement.DesiredSize%2A> を評価し、その要素の表示サイズに影響を与える余白が他にあるかどうかを評価します。  <xref:System.Windows.FrameworkElement.ArrangeCore%2A> が `arrangeSize` を生成し、<xref:System.Windows.Controls.Panel> の <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドにパラメーターとして渡されます。  <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> が子の `finalSize` を生成します。  最後に、<xref:System.Windows.FrameworkElement.ArrangeCore%2A> メソッドが余白や配置などのオフセット プロパティの最終的な評価を行い、レイアウト スロット内に子を配置します。  子は、割り当てられた領域全体を占める必要はなく、実際に、全体を占めないことも珍しくありません。  次に、制御が親 <xref:System.Windows.Controls.Panel> に戻されて、レイアウト プロセスが完了します。  
+  
+<a name="LayoutSystem_PanelsCustom"></a>   
+## パネル要素とカスタム レイアウトの動作  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、<xref:System.Windows.Controls.Panel> から派生した要素のグループが含まれています。  これらの <xref:System.Windows.Controls.Panel> 要素により、多くの複雑なレイアウトができます。  たとえば、要素のスタックは <xref:System.Windows.Controls.StackPanel> 要素を使用して簡単に実現できますが、<xref:System.Windows.Controls.Canvas> を使用すると、より複雑で流動性の高いレイアウトを実現できます。  
+  
+ 次の表に、使用可能なレイアウトの <xref:System.Windows.Controls.Panel> 要素をまとめています。  
+  
+|パネル名|Description|  
+|----------|-----------------|  
+|<xref:System.Windows.Controls.Canvas>|<xref:System.Windows.Controls.Canvas> 領域に対する座標により子要素を明示的に配置できる領域を定義します。|  
+|<xref:System.Windows.Controls.DockPanel>|子要素を互いに水平方向または垂直方向に整列する領域を定義します。|  
+|<xref:System.Windows.Controls.Grid>|列と行で構成される柔軟なグリッド領域を定義します。|  
+|<xref:System.Windows.Controls.StackPanel>|単一行に子要素を整列します。行は水平方向または垂直方向にできます。|  
+|<xref:System.Windows.Controls.VirtualizingPanel>|子データ コレクションを仮想化する <xref:System.Windows.Controls.Panel> 要素のフレームワークを提供します。  これは抽象クラスです。|  
+|<xref:System.Windows.Controls.WrapPanel>|左から右へ順に子要素を配置し、ボックスの端で改行してコンテンツを次の行に送ります。  後続の配置は、<xref:System.Windows.Controls.WrapPanel.Orientation%2A> プロパティの値に応じて、上から下または右から左に向かって行われます。|  
+  
+ アプリケーションで必要なレイアウトが、定義されたどの <xref:System.Windows.Controls.Panel> 要素を使用しても実現できない場合は、<xref:System.Windows.Controls.Panel> からの継承と、<xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドおよび <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドのオーバーライドにより、カスタムのレイアウト動作を実現できます。  例については、[カスタム放射状パネルのサンプル](http://go.microsoft.com/fwlink/?LinkID=159982)を参照してください。  
+  
+<a name="LayoutSystem_Performance"></a>   
+## レイアウト パフォーマンスに関する留意事項  
+ レイアウトは、再帰プロセスです。  <xref:System.Windows.Controls.Panel.Children%2A> コレクション内の各子要素は、レイアウト システムの各呼び出しによって処理されます。  そのため、レイアウト システムのトリガーは、できるだけ避ける必要があります。  次に示す考慮事項は、より優れたパフォーマンスを実現するうえで役に立ちます。  
+  
+-   プロパティ値をどのように変更するとレイアウト システムの再帰的な更新が実行されるかに注意します。  
+  
+     依存関係プロパティの値によってレイアウト システムが初期化される可能性がある場合、そのプロパティはパブリック フラグでマークされます。  <xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A> および <xref:System.Windows.FrameworkPropertyMetadata.AffectsArrange%2A> は、どのプロパティ値の変更によってレイアウト システムの再帰的な更新が実行されるかを判断する手掛かりになります。  一般的に、要素の境界ボックスのサイズに影響を与える可能性があるプロパティでは、<xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A> フラグが true に設定されている必要があります。  詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+-   可能な場合は、<xref:System.Windows.FrameworkElement.LayoutTransform%2A> の代わりに <xref:System.Windows.UIElement.RenderTransform%2A> を使用します。  
+  
+     <xref:System.Windows.FrameworkElement.LayoutTransform%2A> は、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] のコンテンツに影響を与えるための非常に便利な手段です。  ただし、変換の結果を他の要素の配置に影響させる必要がない場合は、代わりに <xref:System.Windows.UIElement.RenderTransform%2A> を使用することをお勧めします。<xref:System.Windows.UIElement.RenderTransform%2A> はレイアウト システムを呼び出さないためです。  <xref:System.Windows.FrameworkElement.LayoutTransform%2A> はその変換を適用し、再帰的なレイアウトの更新を強制的に実行して、影響を受ける要素の新しい配置に反映させます。  
+  
+-   <xref:System.Windows.UIElement.UpdateLayout%2A> の不要な呼び出しは避けてください。  
+  
+     この <xref:System.Windows.UIElement.UpdateLayout%2A> メソッドは、再帰的なレイアウトの更新を強制的に実行しますが、多くの場合は必要ありません。  全面的な更新が必要でない限り、このメソッドの呼び出しはレイアウト システムに任せてください。  
+  
+-   大きい <xref:System.Windows.Controls.Panel.Children%2A> コレクションで作業する場合は、通常の <xref:System.Windows.Controls.StackPanel> の代わりに、<xref:System.Windows.Controls.VirtualizingStackPanel> の使用をお勧めします。  
+  
+     子コレクションを仮想化することで、<xref:System.Windows.Controls.VirtualizingStackPanel> は、現在、親の [ViewPort](GTMT) 内に存在するオブジェクトのみをメモリ内に維持します。  その結果、パフォーマンスは多くのシナリオで大幅に向上します。  
+  
+<a name="LayoutSystem_LayoutRounding"></a>   
+## サブピクセル レンダリングとレイアウトの丸め  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のグラフィックス システムでは、解像度およびデバイスに依存しないようにするために、デバイスに依存しない単位が使用されます。  デバイスに依存しない各ピクセルは、システムの [!INCLUDE[TLA#tla_dpi](../../../../includes/tlasharptla-dpi-md.md)] 設定に従って自動的にスケーリングされます。  これにより、さまざまな [!INCLUDE[TLA2#tla_dpi](../../../../includes/tla2sharptla-dpi-md.md)] 設定で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションが適切にスケーリングされ、アプリケーションが自動的に [!INCLUDE[TLA2#tla_dpi](../../../../includes/tla2sharptla-dpi-md.md)] に対応するようになります。  
+  
+ ただし、この [!INCLUDE[TLA2#tla_dpi](../../../../includes/tla2sharptla-dpi-md.md)] に依存しない方法では、アンチエイリアシングによる端の描画にむらが生じる可能性があります。  このような不鮮明な表示 \(半透明のエッジ\) は、端がデバイス ピクセル間ではなく、1 つのデバイス ピクセル内に位置するときに発生する場合があります。  レイアウト システムでは、このような場合の調整方法として、レイアウトの丸めが用意されています。  レイアウトの丸めでは、レイアウト パスの実行中に整数以外のピクセル値が見つかった場合、レイアウト システムによって丸め処理が行われます。  
+  
+ レイアウトの丸めは既定では無効になっています。  レイアウトの丸めを有効にするには、<xref:System.Windows.FrameworkElement.UseLayoutRounding%2A> プロパティを <xref:System.Windows.FrameworkElement> のいずれかで `true` に設定します。  これは依存関係プロパティであるため、値はビジュアル ツリー内のすべての子に反映されます。  UI 全体でレイアウトの丸めを有効にするには、ルート コンテナーで <xref:System.Windows.FrameworkElement.UseLayoutRounding%2A> を `true` に設定します。  例については、「<xref:System.Windows.FrameworkElement.UseLayoutRounding%2A>」を参照してください。  
+  
+<a name="LayoutSystem_whatsnext"></a>   
+## 次の内容  
+ 要素の測定および配置方法を理解することが、レイアウトを理解する第一歩です。  使用可能な <xref:System.Windows.Controls.Panel> 要素の詳細については、「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」を参照してください。  レイアウトに影響する可能性がある各配置プロパティをさらに詳しく理解するには、「[配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)」を参照してください。  カスタム <xref:System.Windows.Controls.Panel> 要素の例については、[カスタム放射状パネルのサンプル](http://go.microsoft.com/fwlink/?LinkID=159982)を参照してください。  軽量アプリケーションにすべての要素を取り入れる準備ができている場合は、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement>   
+ <xref:System.Windows.UIElement>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/localization-attributes-and-comments.md b/docs/framework/wpf/advanced/localization-attributes-and-comments.md
new file mode 100644
index 00000000000..e48a4b8ae2c
--- /dev/null
+++ b/docs/framework/wpf/advanced/localization-attributes-and-comments.md
@@ -0,0 +1,113 @@
+---
+title: "ローカリゼーション属性とコメント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ローカリゼーション, 属性"
+  - "ローカリゼーション, コメント"
+ms.assetid: ead2d9ac-b709-4ec1-a924-39927a29d02f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ローカリゼーション属性とコメント
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ローカリゼーション コメントは、ローカライズの規則やヒントを示すために、開発者が [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] ソース コード内に記述するプロパティです。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ローカリゼーション コメントには、ローカライズ属性と自由な書式のローカリゼーション コメントの 2 組の情報が含まれます。  localizability 属性は、どのリソースがローカライズ対象かを示すために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ローカリゼーション API により使用されます。  自由な書式のコメントには、アプリケーション作成者が必要に応じて任意の情報を記述できます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Localizer_Comments_"></a>   
+## ローカリゼーション コメント  
+ [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] 内の特定の要素について、テキストの長さ、フォント ファミリ、フォント サイズなどの制約がある場合、マークアップ アプリケーション作成者は [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] コード内のコメントを使用して、この情報をローカライザーに伝えることができます。  ソース コードにコメントを追加するためのプロセスは、次のとおりです。  
+  
+1.  アプリケーション開発者が、[!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] ソース コードにローカリゼーション コメントを追加します。  
+  
+2.  ビルド プロセスの間に、アセンブリ内に自由な書式のローカリゼーション コメントを残すか、コメントの一部を取り除くか、またはすべてのコメントを取り除くかどうかを、.proj ファイル内に指定できます。  取り除かれたコメントは、別のファイル内に保存されます。  `LocalizationDirectivesToLocFile` タグを使用してオプションを指定します。以下にその例を示します。  
+  
+     `<LocalizationDirectivesToLocFile>` *value* `</LocalizationDirectivesToLocFile>`  
+  
+3.  指定できる値は次のとおりです。  
+  
+    -   **None** \- コメントと属性の両方がアセンブリ内に残され、別ファイルは生成されません。  
+  
+    -   **CommentsOnly** \- アセンブリからコメントだけが削除され、別の LocFile 内に保存されます。  
+  
+    -   **All** \- コメントと属性の両方がアセンブリから削除され、別の LocFile 内に保存されます。  
+  
+4.  [!INCLUDE[TLA2#tla_baml](../../../../includes/tla2sharptla-baml-md.md)] からローカライズ可能リソースが抽出されるときに、[!INCLUDE[TLA2#tla_baml](../../../../includes/tla2sharptla-baml-md.md)] ローカリゼーション API により、localizability 属性に応じた処理が実行されます。  
+  
+5.  自由な書式のコメントだけを格納したローカリゼーション コメント ファイルは、ローカリゼーション プロセスに後から組み込まれます。  
+  
+ [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] ファイルにローカリゼーション コメントを追加する方法を次の例に\_示します。  
+  
+ `<TextBlock x:Id = "text01"`  
+  
+ `FontFamily = "Microsoft Sans Serif"`  
+  
+ `FontSize = "12"`  
+  
+ `Localization.Attributes = "$Content (Unmodifiable Readable Text)`  
+  
+ `FontFamily (Unmodifiable Readable)"`  
+  
+ `Localization.Comments = "$Content (Trademark)`  
+  
+ `FontSize (Trademark font size)" >`  
+  
+ `Microsoft`  
+  
+ `</TextBlock>`  
+  
+ この例では、Localization.Attributes セクションにローカリゼーション属性が、Localization.Comments セクションに自由な書式のコメントが記述されています。  次の表は、各属性とコメント、およびその意味を示したものです。  
+  
+|ローカリゼーション属性|説明|  
+|-----------------|--------|  
+|$Content \(Unmodifiable Readable Text\)|TextBlock 要素の内容は変更不能 \(Unmodifiable\) です。  ローカライザーは、「Microsoft」という単語を変更することはできません。  内容はローカライザーによる読み取りが可能 \(Readable\) です。  内容のカテゴリはテキストです。|  
+|FontFamily \(Unmodifiable Readable\)|TextBlock 要素のフォント ファミリ プロパティは変更不能ですが、ローカライザーによる読み取りは可能です。|  
+  
+|自由な書式のローカリゼーション コメント|説明|  
+|--------------------------|--------|  
+|$Content \(Trademark\)|TextBlock 要素の内容が商標であることを示します。|  
+|FontSize \(Trademark font size\)|フォント サイズ プロパティが標準の商標サイズに従う必要があることを示します。|  
+  
+### ローカライズ属性  
+ Localization.Attributes セクション内の情報は、ターゲットの値名および関連付けられた localizability 値のペアのリストで構成されます。  ターゲット名には、プロパティ名または $Content 名のいずれかを指定します。  プロパティ名を指定した場合は、ターゲット値はプロパティの値になります。  $Content を指定した場合は、ターゲット値は要素の内容になります。  
+  
+ 属性には次の 3 種類があります。  
+  
+-   **Category**。  値をローカライザー ツールで変更できる必要があるかどうかを指定します。  <xref:System.Windows.LocalizabilityAttribute.Category%2A> を参照してください。  
+  
+-   **Readability**。  ローカライザー ツールが値を読み取る \(および表示する\) 必要があるかどうかを指定します。  <xref:System.Windows.LocalizabilityAttribute.Readability%2A> を参照してください。  
+  
+-   **Modifiability**。  ローカライザー ツールが値の変更を許可するかどうかを指定します。  <xref:System.Windows.LocalizabilityAttribute.Modifiability%2A> を参照してください。  
+  
+ これらの属性は、スペースで区切って任意の順番で指定できます。  同じ属性を重複して指定した場合は、最後に記述した属性が優先されます。  たとえば、Localization.Attributes \= "Unmodifiable Modifiable" と指定すると、最後の値である Modifiable が設定されます。  
+  
+ 変更可能性と読み取り可能性については、説明は不要でしょう。  カテゴリ属性は、ローカライザーがテキストを翻訳する際の参考となるように、定義済みのカテゴリを示します。  Text、Label、Title などのカテゴリは、ローカライザーがテキストの翻訳方法を判断するうえで役立ちます。  さらに、None、Inherit、Ignore、NeverLocalize などの特別なカテゴリもあります。  
+  
+ 特別なカテゴリの意味を次の表に示します。  
+  
+|\[カテゴリ\]|説明|  
+|--------------|--------|  
+|なし|ターゲット値には、定義されたカテゴリがありません。|  
+|Inherit|ターゲット値は、親からカテゴリを継承します。|  
+|\[無視\]|ターゲット値は、ローカリゼーション プロセスで無視されます。  Ignore は現在の値だけに影響します。  子ノードへの影響はありません。|  
+|NeverLocalize|現在の値は、ローカライズ不能です。  このカテゴリは要素の子にも継承されます。|  
+  
+<a name="Localization_Comments"></a>   
+## ローカリゼーション コメント  
+ Localization.Comments セクションには、ターゲット値に関する自由な書式の文字列が含まれます。  アプリケーション開発者は、アプリケーション テキストの翻訳に関するヒントをローカライザーに伝える追加情報をここに記述します。  コメントには "\(\)" で囲んだ任意の文字列を記述できます。  文字のエスケープには '\\' を使用します。  
+  
+## 参照  
+ [WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)   
+ [自動レイアウトを使用してボタンを作成する](../../../../docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md)   
+ [自動レイアウト用のグリッドを使用する](../../../../docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md)   
+ [アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md b/docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md
new file mode 100644
index 00000000000..f798f806861
--- /dev/null
+++ b/docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md
@@ -0,0 +1,112 @@
+---
+title: "ルーティング イベントの処理済みとしてのマーキング、およびクラス処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バブル イベント"
+  - "クラス リスナー"
+  - "複合コントロール"
+  - "コントロール, 複合"
+  - "イベント, バブル"
+  - "イベント, 非表示"
+  - "イベント, トンネル"
+  - "インスタンス リスナー"
+  - "リスナー"
+  - "プレビュー ルーティング イベント"
+  - "ルーティング イベント, マーキング (処理済みとして)"
+  - "ルーティング イベント, プレビュー"
+  - "非表示イベント"
+  - "トンネル イベント"
+ms.assetid: 5e745508-4861-4b48-b5f6-5fc7ce5289d2
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# ルーティング イベントの処理済みとしてのマーキング、およびクラス処理
+ルーティング イベントのハンドラーでは、イベント データ内で、イベントを処理済みとしてマークできます。  イベントを処理すると、ルートが事実上短縮されます。  クラス処理は、ルーティング イベントでサポートされているプログラミング概念です。  クラス ハンドラーでは、特定のルーティング イベントをクラス レベルのハンドラーで処理することができます。このハンドラーは、そのクラスのどのインスタンスのどのインスタンス ハンドラーよりも先に呼び出されます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ ここでは、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」で紹介した概念を詳しく説明します。  
+  
+<a name="When_to_Mark_Events_as_Handled"></a>   
+## イベントを処理済みとしてマークする場合  
+ ルーティング イベントのイベント データで <xref:System.Windows.RoutedEventArgs.Handled%2A> プロパティの値を `true` に設定することを、"イベントを処理済みとしてマークする" と言います。  アプリケーションの作成者や、既存のルーティング イベントへの応答や新しいルーティング イベントの実装を行うコントロールの作成者が、どのような場合にイベントを処理済みとしてマークするかについては、絶対的な規則はありません。  ほとんどにおいて、ルーティング イベントのイベント データで運ばれる "処理済み" の概念は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] で公開されているさまざまなルーティング イベントや、カスタム ルーティング イベントに対するアプリケーションの応答のための限定的なプロトコルとして使用する必要があります。  また、"処理済み" の問題のもう 1 つの考え方として、ルーティング イベントに対するコードの応答が重要かつ比較的完全な形で行われた場合は、一般にルーティング イベントを処理済みとしてマークする必要があります。通常は、1 つのルーティング イベント発生に対して、異なるハンドラー実装を必要とする複数の重要な応答があることは好ましくありません。  複数の応答が必要な場合は、ルーティング イベント システムを使用して転送するのではなく、単一のハンドラー内で一連のアプリケーション ロジックとして必要なコードを実装する必要があります。  また、何が "重要" かと考えるかも主観的なもので、アプリケーションやコードに応じて異なります。  一般的に、"重要な応答" の例には、フォーカスの設定、パブリックな状態の変更、ビジュアル表現に影響するプロパティの設定、他の新しいイベントの発生などがあります。  重要でない応答には、プライベートな状態の変更 \(ビジュアル表現への影響やプログラムによる表現を伴わない変更\) や、イベントのログへの記録などがあります。イベントの引数を確認して応答しないように選択する場合もこれに含まれます。  
+  
+ ルーティング イベントのこの "処理済み" 状態を使用するための "重要な応答" モデルは、ルーティング イベント システムの動作によって支えられています。[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] や <xref:System.Windows.UIElement.AddHandler%2A> の一般的なシグネチャで追加されたハンドラーは、イベント データが処理済みとしてマークされているルーティング イベントに対しては呼び出されないからです。  それまでのイベント ルートの処理によって、処理済みとしてマークされているルーティング イベントを処理するには、`handledEventsToo` パラメーター バージョン \(<xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29>\) を使用してハンドラーを追加する必要があります。  
+  
+ 場合によっては、コントロール自体が特定のルーティング イベントを処理済みとしてマークすることもあります。  ルーティング イベントが処理済みとマークされた場合、ルーティング イベントへの応答としてコントロールが行ったアクションは、コントロールの実装の一部として重要または完全なもので、そのイベントにはそれ以上の処理は必要ない、と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの作成者が判断したことを表しています。  これは通常、イベントのクラス ハンドラーを追加するか、基本クラスに存在するクラス ハンドラー仮想メソッドをオーバーライドすることによって行われます。  このイベント処理は、必要に応じて回避することもできます。詳細については、このトピックの「[コントロールによるイベント抑制の回避](#WorkingAroundEventSuppressionByControls)」を参照してください。  
+  
+<a name="Preview_Events_vs__Bubbling_Events_and_Handling"></a>   
+## "Preview" \(トンネル\) イベントとバブル イベントのイベント処理  
+ プレビュー ルーティング イベントは、要素ツリーの[トンネル](GTMT) ルートをたどるイベントです。  名前付け規則に含まれる "Preview" は、対応するバブル ルーティング イベントより前にプレビュー \(トンネル\) ルーティング イベントが発生するという入力イベントの原則を表しています。  また、トンネルとバブルのペアを持つ入力ルーティング イベントは、別個の処理ロジックを持ちます。  トンネル\/プレビュー ルーティング イベントがイベント リスナーによって処理済みとしてマークされた場合、バブル ルーティング イベントは処理済みとしてマークされます。これは、バブル ルーティング イベントのリスナーがそのイベントを受け取る前であっても変わりません。  トンネル ルーティング イベントとバブル ルーティング イベントは、厳密には別個のイベントですが、この動作を実現するために、同じイベント データのインスタンスをあえて共有しています。  
+  
+ このトンネル ルーティング イベントとバブル ルーティング イベントの間の関連は、任意の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クラスで宣言されたルーティング イベントの発生方法の内部実装によって実現されます。これは入力ルーティング イベントのペアにも当てはまります。  このクラスレベルの実装が存在しなければ、名前付けスキームを共有するトンネル ルーティング イベントとバブル ルーティング イベントの間に関連はありません。つまり、そのような実装がなければ、それらは 2 つのまったく別のルーティング イベントとなり、連続して発生することや、イベント データを共有することはなくなります。  
+  
+ カスタム クラスでトンネル\/バブル入力ルーティング イベントのペアを実装する方法の詳細については、「[カスタム ルーティング イベントを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md)」を参照してください。  
+  
+<a name="Class_Handlers_and_Instance_Handlers"></a>   
+## クラス ハンドラーとインスタンス ハンドラー  
+ ルーティング イベントでは、クラス リスナーとインスタンス リスナーという 2 種類のイベント リスナーが考慮されます。  クラス リスナーが存在するのは、型の静的コンストラクターで特殊な <xref:System.Windows.EventManager> [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の <xref:System.Windows.EventManager.RegisterClassHandler%2A> が呼び出されたか、要素の基本クラスのクラス ハンドラー仮想メソッドがオーバーライドされた場合です。  インスタンス リスナーは特定のクラス インスタンス\/要素で、<xref:System.Windows.UIElement.AddHandler%2A> の呼び出しによって 1 つ以上のハンドラーがルーティング イベントにアタッチされています。既存の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ルーティング イベントは、そのイベントの [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] イベント ラッパーの add{} と remove{} の実装の一部として、<xref:System.Windows.UIElement.AddHandler%2A> を呼び出します。属性構文によってイベント ハンドラーをアタッチする単純な [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の機構も、この方法で実現されています。  したがって、単純な [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の使用方法も、究極的には <xref:System.Windows.UIElement.AddHandler%2A> の呼び出しと同じことになります。  
+  
+ 登録されたハンドラー実装があるかどうか、ビジュアル ツリー内の要素がチェックされます。  ハンドラーはルート全体で呼び出される可能性があり、その順序は、ルーティング イベントのルーティング方法によってあらかじめ決まっています。  たとえばバブル ルーティング イベントでは、イベントを発生させた要素と同じ要素にアタッチされているハンドラーが最初に呼び出されます。  その後、ルーティング イベントは次の親要素に "浮上して" 到達します。アプリケーションのルート要素に到達するまでこれが繰り返されます。  
+  
+ バブル ルートのルート要素の観点から見ると、イベント引数を処理済みとしてマークするハンドラーが、クラス処理や、よりルーティング イベント ソースに近い要素によって呼び出された場合、ルート要素のハンドラーは呼び出されません。これにより、イベント ルートは、ルート要素に到達する前に事実上短縮されます。  ただし、イベント ルートが完全に停止するわけではありません。クラス ハンドラーやインスタンス ハンドラーによってルーティング イベントが処理済みとしてマークされた場合にも呼び出されるように、特別な条件を使用してハンドラーが追加されている可能性があるためです。  詳細については、このトピックの「[イベントが処理済みとしてマークされていても呼び出されるインスタンス ハンドラーの追加](#AddingInstanceHandlersthatAreRaisedEvenWhenEventsareMarkedHandled)」を参照してください。  
+  
+ イベント ルートより深いレベルでは、クラスのインスタンスに対して、複数のクラス ハンドラーが作用している可能性があります。  なぜなら、ルーティング イベントのクラス処理モデルでは、クラスの階層構造に属するすべてのクラスが、各ルーティング イベントに対して独自のクラス ハンドラーをそれぞれ登録できるためです。  各クラス ハンドラーは内部ストアに追加され、アプリケーションのイベント ルートが構築されたときには、すべてのクラス ハンドラーがイベント ルートに追加されます。  クラス ハンドラーは、最派生クラスのクラス ハンドラーが最初に呼び出され、以下それぞれの基本クラスのクラス ハンドラーが順に呼び出されていくように、ルートに追加されます。  一般に、クラス ハンドラーは、処理済みとしてマークされているルーティング イベントにも反応するようには登録されません。  したがって、このクラス処理のしくみでは、次の 2 つの方法のいずれかが考えられます。  
+  
+-   派生クラスで、ルーティング イベントを処理済みとしてマークしないハンドラーを追加することで、基本クラスから継承されたクラス処理を補完できます。派生クラス ハンドラーの後のいずれかの時点で、基本クラス ハンドラーが呼び出されるためです。  
+  
+-   派生クラスで、ルーティング イベントを処理済みとしてマークするクラス ハンドラーを追加することで、基本クラスのクラス処理を置き換えることができます。  この方法を使用する場合には注意が必要です。外観、状態のロジック、入力処理、コマンド処理などの部分で、基本コントロールが意図したデザインと変わってしまう可能性があります。  
+  
+<a name="Class_Handling_of_Routed_Events"></a>   
+## コントロールの基本クラスでのルーティング イベントのクラス処理  
+ イベント ルートの各要素ノードでは、その要素のどのインスタンス リスナーよりも先にクラス リスナーに、ルーティング イベントに応答する機会が与えられます。  このため、特定のコントロール クラス実装ではそれ以上伝播しないルーティング イベントを抑制したり、ルーティング イベントに対してそのクラスの機能である特別な処理を提供したりするために、クラス ハンドラーが使用されることもあります。  たとえば、特定のクラスのコンテキストでユーザー入力の状態が持つ意味についてより具体的な情報を含む、クラス固有の独自のイベントを発生させることができます。  この場合、そのクラス実装によって、より一般的なルーティング イベントが処理済みとしてマークされます。  通常、クラス ハンドラーは、共有されているイベント データが既に処理済みとしてマークされているルーティング イベントに対しては呼び出されないように追加されます。ただし、例外的なケースのために、<xref:System.Windows.EventManager.RegisterClassHandler%28System.Type%2CSystem.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> には、ルーティング イベントが処理済みとしてマークされている場合にも呼び出されるようにクラス ハンドラーを登録するシグネチャもあります。  
+  
+### クラス ハンドラー仮想メソッド  
+ 一部の要素 \(特に、<xref:System.Windows.UIElement> などの基本要素\) では、その一連のパブリック ルーティング イベントに対応する空の "On\*Event" および "OnPreview\*Event" の各仮想メソッドが公開されています。  これらの仮想メソッドをオーバーライドして、そのルーティング イベントに対するクラス ハンドラーを実装することができます。  基本要素クラスでは、上で説明したように <xref:System.Windows.EventManager.RegisterClassHandler%28System.Type%2CSystem.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> を使用して、これらの仮想メソッドが、各ルーティング イベントのクラス ハンドラーとして登録されています。  On\*Event 仮想メソッドを使用すると、関連するルーティング イベントのクラス処理の実装が大幅に簡略化され、それぞれの型の静的コンストラクターで特別な初期化を行う必要がなくなります。  たとえば、<xref:System.Windows.UIElement.OnDragEnter%2A> 仮想メソッドをオーバーライドすることによって、任意の <xref:System.Windows.UIElement> 派生クラスで <xref:System.Windows.UIElement.DragEnter> イベントのクラス処理を追加することができます。  オーバーライドの中では、ルーティング イベントを処理する、他のイベントを発生させる、インスタンスの要素プロパティを変更する可能性があるクラス固有のロジックを開始するなどのアクションや、それらのアクションの組み合わせを、自由に選択できます。  一般に、こうしたオーバーライドでは、イベントを処理済みとしてマークする場合でも基本実装を呼び出す必要があります。  基本実装を呼び出すことが強く推奨されるのは、これらの仮想メソッドは基本クラスで定義されているためです。  プロテクト仮想メソッドの標準的な呼び出しパターンでは、それぞれの仮想メソッドから、基本実装を呼び出す形になります。これは、ルーティング イベントのクラス処理の固有のしくみ \(任意のインスタンスに対して、最派生クラスのハンドラーから基本クラスのハンドラーへという順で、クラス階層構造のすべてのクラスのクラス ハンドラーが呼び出される\) を実質的に置き換え、同様の処理を実現することになります。  基本実装を呼び出さないようにするのは、基本クラスの処理ロジックを意図的に変更する必要がある場合だけです。  基本実装をオーバーライド コードの前と後のどちらに呼び出すかは、それぞれの実装の性質によって異なります。  
+  
+#### 入力イベントのクラス処理  
+ すべてのクラス ハンドラー仮想メソッドは、処理済みとしてマークされている共有イベント データがない場合にのみ呼び出されるように登録されます。  また、入力イベントを一意にするために、トンネル バージョンとバブル バージョンは一般に連続して発生し、イベント データを共有します。  このため、一方がトンネル バージョンでもう一方がバブル バージョンの入力イベントのクラス ハンドラーのペアに対しては、イベントがすぐに処理済みとしてマークされないようにする必要があります。  イベントを処理済みとしてマークするようにトンネル クラス処理仮想メソッドを実装すると、バブル クラス ハンドラーが呼び出されなくなります \(トンネル イベントやバブル イベントに対して通常の方法で登録されたインスタンス ハンドラーも呼び出されません\)。  
+  
+ ノードのクラス処理が完了すると、インスタンス リスナーが考慮されます。  
+  
+<a name="AddingInstanceHandlersthatAreRaisedEvenWhenEventsareMarkedHandled"></a>   
+## イベントが処理済みとしてマークされていても呼び出されるインスタンス ハンドラーの追加  
+ <xref:System.Windows.UIElement.AddHandler%2A> メソッドには、既に他のハンドラーによってイベント データが調整され、イベントが処理済みとしてマークされていても、イベントがルートでその処理要素に到達するたびに必ずイベント システムによって呼び出されるハンドラーを追加できる、特殊なオーバーロードがあります。  この方法は通常は使用されません。  一般にハンドラーは、イベントが要素ツリーのどこで処理されるかに関係なく、そのイベントによって影響を受ける可能性があるアプリケーション コードのすべての領域を調整するように作成することができます。これは、複数の結果が求められる場合でも同じです。  また、通常は、そのイベントに応答する必要がある要素は 1 つだけなので、適切なアプリケーション ロジックが既に発生していることになります。  しかし、イベントが要素ツリーやコントロール複合の他の要素によって既に処理済みとしてマークされていても、要素ツリーのもっと上 \(ルートによってはもっと下\) にある他の要素のハンドラーを呼び出す必要がある場合もあります。そうした例外的なケースに対しては、`handledEventsToo` オーバーロードを使用することができます。  
+  
+#### 処理済みのイベントを未処理としてマークする場合  
+ 一般には、処理済みとしてマークされているルーティング イベントを未処理としてマークする \(<xref:System.Windows.RoutedEventArgs.Handled%2A> の設定を `false` に戻す\) ことは推奨されません。これは、`handledEventsToo` で動作するハンドラーの場合も変わりません。  しかし、一部の入力イベントでは、高レベルのイベント表現と低レベルのイベント表現が重複することがあります。ツリー内のある位置では高レベルのイベントが取得され、別の位置では低レベルのイベントが取得される場合です。  たとえば、子要素が高レベルのキー イベント \(<xref:System.Windows.UIElement.TextInput> など\) をリッスンし、親要素が低レベルのイベント \(<xref:System.Windows.UIElement.KeyDown> など\) をリッスンしているとします。  親要素が低レベルのイベントを処理した場合、直感的には子要素が先にイベントを処理するはずであるにもかかわらず、高レベルのイベントが抑制されてしまうことがあります。  
+  
+ このような状況では、親要素と子要素の両方に低レベルのイベントのハンドラーを追加する必要があります。  この場合、子要素のハンドラー実装によって低レベルのイベントが処理済みとしてマークされる可能性がありますが、親要素のハンドラー実装がそれを再び未処理に設定して、ツリーのもっと上にある要素 \(および高レベルのイベント\) がそのイベントに応答できるようにします。  この状況は通常はあまりありません。  
+  
+<a name="Deliberately_Suppressing_Input_Events_for_Control"></a>   
+## コントロール複合の入力イベントの意図的な抑制  
+ ルーティング イベントのクラス処理は、主に入力イベントと複合コントロールに対して使用されます。  複合コントロールは、その名のとおり、複数の実際的なコントロールまたはコントロールの基本クラスで構成されています。  コントロールを作成する際に、それらの各サブコンポーネントで発生するすべての入力イベントを 1 つにまとめて、コントロール全体が 1 つのイベント ソースとして報告されるようにする場合があります。  また、コンポーネントからのイベントを完全に抑制する場合や、コンポーネントで定義された別のイベント \(より多くの情報を含むイベントや、より具体的な動作を表すイベント\) に置き換える場合もあります。  ここでは、コンポーネント作成者ならだれもが目にする典型的な例として、すべてのボタンに含まれる直感的なイベントである <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントに最終的に対応付けられるマウス イベントが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の <xref:System.Windows.Controls.Button> によって処理されるしくみを見てみます。  
+  
+ <xref:System.Windows.Controls.Button> 基本クラス \(<xref:System.Windows.Controls.Primitives.ButtonBase>\) は、<xref:System.Windows.Controls.Control> から派生します。<xref:System.Windows.Controls.Control> はさらに、<xref:System.Windows.FrameworkElement> と <xref:System.Windows.UIElement> から派生します。コントロールの入力の処理に必要なイベント インフラストラクチャの大半は、<xref:System.Windows.UIElement> のレベルにあります。  具体的に言うと、<xref:System.Windows.UIElement> は、その境界内でマウス カーソルのヒット テストを処理する一般的な <xref:System.Windows.Input.Mouse> イベントを処理し、ほとんどの一般的なボタン アクション \(<xref:System.Windows.UIElement.MouseLeftButtonDown> など\) のための個々のイベントを提供します。  また、<xref:System.Windows.UIElement> は、<xref:System.Windows.UIElement.MouseLeftButtonDown> の登録済みクラス ハンドラーとして、空の仮想メソッド <xref:System.Windows.UIElement.OnMouseLeftButtonDown%2A> を提供します。これを <xref:System.Windows.Controls.Primitives.ButtonBase> がオーバーライドします。  同様に、<xref:System.Windows.Controls.Primitives.ButtonBase> は <xref:System.Windows.UIElement.MouseLeftButtonUp> のクラス ハンドラーを使用します。  このオーバーライドでは、イベント データが渡されますが、その <xref:System.Windows.RoutedEventArgs> インスタンスを処理済みとしてマークします \(<xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定します\)。その同じイベント データが残りのルートで使用され、他のクラス ハンドラーや、インスタンス ハンドラーやイベント setter に渡されます。  また、<xref:System.Windows.Controls.Primitives.ButtonBase.OnMouseLeftButtonUp%2A> のオーバーライドは、その後 <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを発生させます。  その結果、ほとんどのリスナーにとっては、<xref:System.Windows.UIElement.MouseLeftButtonDown> イベントおよび <xref:System.Windows.UIElement.MouseLeftButtonUp> イベントが "消滅" し、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> に置き換えられたことになります。このイベントは、ボタンの複合の一部やまったく別の要素からではなく本当のボタンから発生したものとして認識されるため、より多くの意味を持つと言えます。  
+  
+<a name="WorkingAroundEventSuppressionByControls"></a>   
+### コントロールによるイベント抑制の回避  
+ 個々のコントロール内で行われるこのイベントの抑制の動作が、アプリケーションのイベント処理ロジックの全体的な目的の妨げになることがあります。  たとえば、なんらかの理由でアプリケーションのルート要素に <xref:System.Windows.UIElement.MouseLeftButtonDown> のハンドラーが配置されていた場合、ボタンをマウスでクリックしてもルート レベルの <xref:System.Windows.UIElement.MouseLeftButtonDown> ハンドラーや <xref:System.Windows.UIElement.MouseLeftButtonUp> ハンドラーは呼び出されなくなります。  イベント自体は実際に "浮上" します \(既に説明したように、処理済みとしてマークされた後、イベント ルートは終了するのではなく、ルーティング イベント システムによってハンドラー呼び出しの動作が変更されます\)。  ルーティング イベントがボタンに到達すると、より多くの意味を持つ <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントに置き換えるために、<xref:System.Windows.Controls.Primitives.ButtonBase> のクラス処理によって <xref:System.Windows.UIElement.MouseLeftButtonDown> が処理済みとしてマークされます。  その結果、ルートのさらに上にある標準の <xref:System.Windows.UIElement.MouseLeftButtonDown> ハンドラーは呼び出されなくなります。  このような状況でもハンドラーが呼び出されるようにするには 2 つの方法があります。  
+  
+ 1 つ目は、<xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> の `handledEventsToo` シグネチャを使用して意図的にハンドラーを追加する方法です。  この方法には、イベント ハンドラーの追加をコードからしか行えず、マークアップからは行うことができないという制限があります。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でイベント属性の値としてイベント ハンドラー名を指定する単純な構文では、この動作は実現できません。  
+  
+ 2 つ目の方法は、トンネル バージョンとバブル バージョンのルーティング イベントがペアになっている入力イベントでのみ使用できます。  これらのルーティング イベントでは、対応するプレビュー\/[トンネル](GTMT) ルーティング イベントに、ハンドラーを追加することができます。  そのルーティング イベントはルートからトンネリングを開始するため、アプリケーション要素ツリーの先祖要素のレベルでプレビュー ハンドラーがアタッチされていれば、イベントがボタン クラス処理コードによって遮断されなくなります。  この方法を使用する場合は、プレビュー イベントを処理済みとしてマークする際に注意が必要です。  <xref:System.Windows.UIElement.PreviewMouseLeftButtonDown> をルート要素で処理する例で言うと、ハンドラー実装でイベントを <xref:System.Windows.RoutedEventArgs.Handled%2A> としてマークすると、実際には <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントが抑制されます。  通常これは望ましくない動作です。  
+  
+## 参照  
+ <xref:System.Windows.EventManager>   
+ [プレビュー イベント](../../../../docs/framework/wpf/advanced/preview-events.md)   
+ [カスタム ルーティング イベントを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/markup-compatibility-mc-language-features.md b/docs/framework/wpf/advanced/markup-compatibility-mc-language-features.md
new file mode 100644
index 00000000000..68fdd98bf4c
--- /dev/null
+++ b/docs/framework/wpf/advanced/markup-compatibility-mc-language-features.md
@@ -0,0 +1,31 @@
+---
+title: "マークアップの互換性 (mc:) 言語機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "マークアップの互換性"
+  - "名前空間, XML"
+  - "XAML 名前空間"
+  - "XAML, 名前空間"
+  - "XML, mc 名前空間プレフィックス"
+  - "XML, 名前空間"
+ms.assetid: 67992d76-8bcc-456c-8232-03807803d69e
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# マークアップの互換性 (mc:) 言語機能
+## このセクションの内容  
+ [mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)  
+ [mc:ProcessContent 属性](../../../../docs/framework/wpf/advanced/mc-processcontent-attribute.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md b/docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md
new file mode 100644
index 00000000000..e7577d56c82
--- /dev/null
+++ b/docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md
@@ -0,0 +1,139 @@
+---
+title: "マークアップ拡張機能と WPF XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "*Extension クラス"
+  - "バインディングのマークアップ拡張機能"
+  - "中かっこ文字"
+  - "文字, 中かっこ"
+  - "クラス, MarkupExtension"
+  - "中かっこ文字 ({})"
+  - "DynamicResource のマークアップ拡張機能"
+  - "リテラル中かっこ文字 ({})"
+  - "マークアップ拡張機能"
+  - "MarkupExtension クラス"
+  - "入れ子 (拡張構文の)"
+  - "RelativeSource のマークアップ拡張機能"
+  - "StaticResource のマークアップ拡張機能"
+  - "TemplateBinding のマークアップ拡張機能"
+  - "XAML, マークアップ拡張機能"
+ms.assetid: 618dc745-8b14-4886-833f-486d2254bb78
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# マークアップ拡張機能と WPF XAML
+ここでは、構文規則、目的、およびその基になるクラス オブジェクト モデルを含む XAML のマークアップ拡張機能の概念について説明します。  マークアップ拡張機能は、XAML 言語、および XAML サービスの .NET 実装の一般的な機能です。  ここでは、WPF XAML で使用するマークアップ拡張機能について特に詳しく説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="XAML_Processors_and_Markup_Extensions"></a>   
+## XAML プロセッサとマークアップ拡張機能  
+ 一般に、XAML パーサーは、属性値を、プリミティブに変換できるリテラル文字列として解釈するか、いくつかの方法でオブジェクトに変換できます。  そのような方法の 1 つは、型コンバーターを参照することです。この方法については、「[TypeConverters および XAML](../../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)」で説明しています。  しかし、シナリオによっては、別の動作が必要な場合もあります。  たとえば、XAML プロセッサに対して、ある属性値がオブジェクト グラフの新しいオブジェクトにならないように指示することがあります。  この場合、属性は、オブジェクト グラフの別の部分にある既に構築したオブジェクト、または静的オブジェクトを参照するオブジェクト グラフにする必要があります。  別のシナリオとして、XAML プロセッサに対して、オブジェクトのコンストラクターに既定以外の引数を渡す構文を使用するように指示する場合もあります。このような種類のシナリオは、マークアップ拡張機能によって解決できます。  
+  
+<a name="Basic_Markup_Extension_Syntax"></a>   
+## 基本的なマークアップ拡張構文  
+ マークアップ拡張機能は、属性使用のプロパティ、プロパティ要素使用のプロパティ、またはこれらの両方に値を指定するために実装できます。  
+  
+ 属性値を指定するために使用するときは、XAML プロセッサに対してマークアップ拡張機能を区別する構文として、始め中かっこと終わり中かっこ \({ および }\) が使用されます。  マークアップ拡張機能の種類は、次の始め中かっこの直後の文字列トークンによって識別されます。  
+  
+ プロパティ要素構文で使用する場合、マークアップ拡張機能は、プロパティ要素値を指定するために使用されるその他の要素と表示上は同じになります。つまり、山かっこ \(\<\>\) で囲まれたマークアップ拡張機能クラスを要素として参照する XAML 要素宣言になります。  
+  
+<a name="XAML_Defined_Markup_Extensions"></a>   
+## XAML で定義されたマークアップ拡張機能  
+ XAML の WPF 実装に固有ではなく、言語としての XAML の組み込みまたは機能の実装であるマークアップ拡張機能がいくつか存在します。  これらのマークアップ拡張機能は、一般的な .NET Framework XAML サービスの一部として System.Xaml アセンブリに実装され、XAML 言語の XAML 名前空間内にあります。  これらのマークアップ拡張機能は、一般的なマークアップの使用方法では、通常 `x:` プレフィックスで識別できます。  <xref:System.Windows.Markup.MarkupExtension> 基本クラス \(これも System.Xaml で定義されています\) には、WPF XAML に含まれる XAML リーダーと XAML ライターでマークアップ拡張機能がサポートされるようにするために、すべてのマークアップ拡張機能で使用する必要のあるパターンが用意されています。  
+  
+-   `x:Type` は、指定した型の <xref:System.Type> オブジェクトを示します。  この機能は、スタイルとテンプレートで最もよく使用されます。  詳細については、「[x:Type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)」を参照してください。  
+  
+-   `x:Static` は、静的な値を生成します。  この値は、直接的にはプロパティの値の型ではなくても、その型に評価することができる値型コード エンティティから生成されます。  詳細については、「[x:Static のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-static-markup-extension.md)」を参照してください。  
+  
+-   `x:Null` は、プロパティの値として `null` を指定し、属性またはプロパティ要素の値として使用できます。  詳細については、「[x:Null のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-null-markup-extension.md)」を参照してください。  
+  
+-   `x:Array` は、XAML の構文での一般的な配列の作成をサポートします。WPF 基本要素とコントロール モデルで提供されているコレクションのサポートをあえて使用しない場合に使用します。  詳細については、「[x:Array のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-array-markup-extension.md)」を参照してください。  
+  
+> [!NOTE]
+>  `x:` プレフィックスは、XAML ファイルまたは稼働環境のルート要素において、組み込み XAML 言語の一般的な XAML 名前空間の割り当てに使用されます。  たとえば、WPF アプリケーション用の [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] テンプレートは、この `x:` の割り当てを使用して XAML ファイルを開始します。  独自の XAML 名前空間の割り当てで別のプレフィックスを選択できますが、このドキュメントでは、既定の WPF 名前空間、または特定のフレームワークに無関係である他の XAML 名前空間ではなく、XAML 言語用の XAML 名前空間の定義済みの部分であるエンティティを識別する方法として、既定の `x:` の割り当てを想定しています。  
+  
+<a name="WPF_Specific_Markup_Extensions"></a>   
+## WPF 固有のマークアップ拡張機能  
+ WPF プログラミングで最も一般的なマークアップ拡張機能には、リソース参照 \(`StaticResource` と `DynamicResource`\) をサポートする拡張機能と、データ バインディング \(`Binding`\) をサポートする拡張機能があります。  
+  
+-   `StaticResource` は、既に定義されているリソースの値を置き換えることによって、プロパティの値を指定します。  `StaticResource` の評価は、最終的に XAML 読み込み時に行われ、実行時にはオブジェクト グラフにアクセスできません。詳細については、「[StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)」を参照してください。  
+  
+-   `DynamicResource` は、リソースへの実行時参照として値の決定を遅延することによって、プロパティの値を指定します。  動的リソース参照では、このようなリソースにアクセスするたびに、強制的に新しいルックアップが行われ、実行時にオブジェクト グラフにアクセスできます。  このようにアクセスできるようにするために、`DynamicResource` の概念が、WPF プロパティ システムの依存関係プロパティ、および評価された式でサポートされます。  したがって、`DynamicResource` は依存関係プロパティ ターゲットにのみ使用できます。  詳細については、「[DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)」を参照してください。  
+  
+-   `Binding` は、実行時に親オブジェクトに適用されるデータ コンテキストを使用して、プロパティのデータ バインドされた値を指定します。  このマークアップ拡張機能では、データ バインディングを指定するためのインライン構文を大量に使用できるようになるため、比較的複雑です。  詳細については、「[バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)」を参照してください。  
+  
+-   `RelativeSource` は、ランタイム オブジェクト ツリーに存在する可能性のあるいくつかの関係をナビゲーションできる <xref:System.Windows.Data.Binding> に、ソース情報を指定します。  これにより、多目的のテンプレートで作成されるバインディング、または周囲のオブジェクト ツリーを完全には把握していないコードで作成されるバインディングのために、特殊なソース指定を行うことができます。  詳細については、「[RelativeSource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/relativesource-markupextension.md)」を参照してください。  
+  
+-   `TemplateBinding` は、コントロール テンプレートが、テンプレートを使用するクラスのオブジェクト モデル定義プロパティから取得される、テンプレートが適用されたプロパティの値を使用できるようにします。  つまり、テンプレート定義内のプロパティから、テンプレートが適用されたときしか存在しないコンテキストにアクセスできます。  詳細については、「[TemplateBinding のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md)」を参照してください。  `TemplateBinding` の実際の使用方法の詳細については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+-   `ColorConvertedBitmap` は、比較的高度なイメージング シナリオをサポートします。  詳細については、「[ColorConvertedBitmap のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/colorconvertedbitmap-markup-extension.md)」を参照してください。  
+  
+-   `ComponentResourceKey` および `ThemeDictionary` は、リソース ルックアップをサポートします。特に、カスタム コントロールと共にパッケージ化されるリソースおよびテーマを対象としています。  詳細については、「[ComponentResourceKey マークアップ拡張機能](../../../../docs/framework/wpf/advanced/componentresourcekey-markup-extension.md)」、「[ThemeDictionary のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/themedictionary-markup-extension.md)」、または「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+<a name="StarExtension"></a>   
+## \*Extension クラス  
+ 一般的な XAML 言語でも WPF 固有のマークアップ拡張機能でも、各マークアップ拡張機能の動作は、<xref:System.Windows.Markup.MarkupExtension> から派生する `*Extension` クラスを通じて XAML プロセッサに識別され、<xref:System.Windows.Markup.StaticExtension.ProvideValue%2A> メソッドの実装を提供します。  各拡張機能が実装するこのメソッドは、マークアップ拡張機能の評価時に返されるオブジェクトを提供します。  返されるオブジェクトは、通常、マークアップ拡張機能に渡されたさまざまな文字列トークンに基づいて評価されます。  
+  
+ たとえば、<xref:System.Windows.StaticResourceExtension> クラスは、実際のリソース検索の外見的な実装を提供するため、その <xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> 実装は必要なオブジェクトを返します。その際入力として、その実装の `x:Key` によってリソースを検索するために使用される文字列を使用します。  既存のマークアップ拡張機能を使用する場合は、この実装の詳細の大部分は重要ではありません。  
+  
+ 一部のマークアップ拡張機能では、文字列トークン引数は使用されません。  これは、そのマークアップ拡張機能では静的な値や一貫した値が返されるため、または返される値のコンテキストが `serviceProvider` パラメーターを介して渡されるサービスの 1 つから得られるためです。  
+  
+ `*Extension` 名前付けパターンは、便宜上のものであり、一貫性を確保するためのものです。  XAML プロセッサがマークアップ拡張機能のサポートとしてそのクラスを識別するためには必要ではありません。  コードベースが System.Xaml を含んでいて、.NET Framework XAML サービスの実装を使用している限り、XAML マークアップ拡張機能として認識されるための要件は、<xref:System.Windows.Markup.MarkupExtension> から派生することと、構築構文をサポートすることだけです。  WPF には、`*Extension` 名前付けパターンに従わないマークアップ拡張機能対応のクラス \(たとえば <xref:System.Windows.Data.Binding>\) が定義されています。  通常、その理由は、クラスが純粋なマークアップ拡張機能のサポート以外のシナリオをサポートするためです。  <xref:System.Windows.Data.Binding> の場合、そのクラスは、XAML. とは無関係なシナリオにおけるオブジェクトのメソッドとプロパティへの実行時アクセスをサポートします。  
+  
+### 初期化テキストの拡張クラスの解釈  
+ マークアップ拡張機能名の後に続き、まだ中かっこの中にある文字列トークンは、次の方法のいずれかで XAML プロセッサに解釈されます。  
+  
+-   コンマは常に個別のトークンの区切りまたは区切り記号を表します。  
+  
+-   個別の区切られたトークンに、等号が含まれない場合は、各トークンはコンストラクター引数として扱われます。  各コンストラクター パラメーターは、その署名で想定される型として、その署名で想定される適切な順序で指定する必要があります。  
+  
+    > [!NOTE]
+    >  XAML プロセッサは、ペアの数の引数の数に一致するコンストラクターを呼び出す必要があります。  このため、カスタム マークアップ拡張機能を実装する場合は、複数のパラメーターに同じ引数の数を指定しないでください。  パラメーターの数が同じマークアップ拡張機能コンストラクター パスが複数存在する場合の XAML プロセッサの動作は定義されていません。ただし、マークアップ拡張機能の型定義がこのような状態になっていると、使用法に関する例外が XAML プロセッサーからスローされる可能性があることを想定しておく必要があります。  
+  
+-   個別の区切られたトークンに等号が含まれている場合、XAML プロセッサは最初にマークアップ拡張機能の既定のコンストラクターを呼び出します。  その後、各 "名前\=値" のペアは、マークアップ拡張機能に存在するプロパティ名、およびそのプロパティに割り当てられる値として解釈されます。  
+  
+-   マークアップ拡張機能において、コンストラクターの動作とプロパティの設定の動作に類似点がある場合は、どちらの動作を使用しても問題はありません。  複数の設定可能なプロパティを持つマークアップ拡張機能では、"*プロパティ*`=`*値*" のペアの方がよく使用されます。単に、その方がマークアップの意図が明確になり、コンストラクター パラメーターを間違って入れ替える可能性も低いためです   \("プロパティ\=値" のペアを指定した場合、それらのプロパティは任意の順序になります\)。また、マークアップ拡張機能によって、設定可能なプロパティのすべてを設定するコンストラクター パラメーターが提供されるという保証はありません。  たとえば、<xref:System.Windows.Data.Binding> は、多数のプロパティを持つマークアップ拡張機能であり、それらのプロパティは "*プロパティ*`=`*値*" の形式で拡張機能を使用することで設定できますが、<xref:System.Windows.Data.Binding> がサポートするコンストラクターは、既定のコンストラクターと初期パスを設定するコンストラクターの 2 つだけです。  
+  
+-   リテラルのコンマは、エスケープせずにマークアップ拡張機能に渡すことはできません。  
+  
+<a name="EscapeSequences"></a>   
+## エスケープ シーケンスとマークアップ拡張機能  
+ XAML プロセッサで処理する属性は、マークアップ拡張シーケンスのインジケーターとして中かっこを使用します。  必要に応じて、空の中かっこのペアとその後に続くリテラル中かっこを使用したエスケープ シーケンスを入力することによって、リテラル中かっこ文字属性値を生成することもできます。  「[{} エスケープ シーケンス\/マークアップ拡張機能](../../../../docs/framework/xaml-services/escape-sequence-markup-extension.md)」を参照してください。  
+  
+<a name="Nesting"></a>   
+## XAML の使用におけるマークアップ拡張機能の入れ子  
+ 複数のマークアップ拡張機能を入れ子にすることができ、各マークアップ拡張は、最も深いものが最初に評価されます。  たとえば、次のような使用方法があります。  
+  
+```  
+<Setter Property="Background"  
+  Value="{DynamicResource {x:Static SystemColors.ControlBrushKey}}" />  
+  
+```  
+  
+ この使用方法では、`x:Static` ステートメントが最初に評価され、文字列を返します。  この文字列が、`DynamicResource` の引数として使用されます。  
+  
+## マークアップ拡張機能とプロパティ要素の構文  
+ マークアップ拡張機能クラスは、プロパティ要素値を設定するオブジェクト要素として使用した場合、XAML で使用可能な通常の型に基づくオブジェクト要素と見た目上は区別できません。  通常のオブジェクト要素とマークアップ拡張機能の実用上の違いは、マークアップ拡張機能は、型指定された値に評価されるか、または式として処理が遅延されることです。  したがって、マークアップ拡張機能のプロパティ値について発生する可能性のある型エラーのメカニズムは異なります。これは、他のプログラミング モデルにおける遅延バインディング プロパティの処理方法と似ています。  通常のオブジェクト要素では、XAML が解析されるとき、その要素で設定しているターゲット プロパティに対して型の一致が評価されます。  
+  
+ ほとんどのマークアップ拡張機能は、プロパティ要素を指定するオブジェクト要素構文で使用される場合、内側にコンテンツや他のプロパティ要素の構文を含みません。  このため、オブジェクト要素タグを閉じ、子要素は指定しません。  オブジェクト要素が XAML プロセッサで検出されるたびに、そのクラスのコンストラクターが呼び出され、解析された要素から作成されたオブジェクトをインスタンス化します。  マークアップ拡張機能クラスも同じです。マークアップ拡張機能をオブジェクト要素構文で使用できるようにする場合は、既定のコンストラクターを用意する必要があります。  既存のマークアップ拡張機能の中には、有効な初期化のために指定する必要のある必須プロパティ値を少なくとも 1 つ持っているものがあります。  その場合、通常、そのプロパティ値はオブジェクト要素のプロパティ属性として指定されます。  「[XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)」および「[WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)」の各リファレンス ページで、必須プロパティを持つマークアップ拡張機能 \(および必須プロパティの名前\) について説明します。  リファレンス ページでは、オブジェクト要素構文と属性構文のどちらかが特定のマークアップ拡張機能に対して許可されない場合についても説明します。  特に注意する必要があるケースは、[x:Array のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-array-markup-extension.md)です。この場合、その配列の内容をタグ設定でコンテンツとして指定する必要があるため、属性構文をサポートできません。  配列の内容は一般的なオブジェクトとして扱われるため、属性の既定の型コンバーターは使用できません。  また、[x:Array のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-array-markup-extension.md)には `type` パラメーターが必要です。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)   
+ [WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)   
+ [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)   
+ [バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)   
+ [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)   
+ [x:Type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/mc-ignorable-attribute.md b/docs/framework/wpf/advanced/mc-ignorable-attribute.md
new file mode 100644
index 00000000000..42c66254bee
--- /dev/null
+++ b/docs/framework/wpf/advanced/mc-ignorable-attribute.md
@@ -0,0 +1,79 @@
+---
+title: "mc:Ignorable 属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "mc XML 名前空間プレフィックス"
+  - "mc:Ignorable 属性"
+  - "mc:ProcessContent 属性"
+  - "XAML, mc:Ignorable 属性"
+  - "XAML, mc:ProcessContent 属性"
+  - "XML, mc 名前空間プレフィックス"
+ms.assetid: acd9a6ef-b7ca-4146-abb6-60f3b366e9ec
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# mc:Ignorable 属性
+マークアップ ファイル内で検出された [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間プレフィックスのうち、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサで無視してよいものを指定します。  `mc:Ignorable` 属性はカスタム ネームスペースのマッピングと [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] バージョン管理のための互換性のあるマークアップをサポートします。  
+  
+## XAML 属性の使用方法 \(1 つのプレフィックス\)  
+  
+```  
+<object  
+  xmlns:ignorablePrefix="ignorableUri"  
+  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+  mc:Ignorable="ignorablePrefix"...>  
+    <ignorablePrefix1:ThisElementCanBeIgnored/>  
+</object>  
+```  
+  
+## XAML 属性の使用方法 \(2 つのプレフィックス\)  
+  
+```  
+<object  
+  xmlns:ignorablePrefix1="ignorableUri"  
+  xmlns:ignorablePrefix2="ignorableUri2"  
+  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+  mc:Ignorable="ignorablePrefix1 ignorablePrefix2"...>  
+    <ignorablePrefix1:ThisElementCanBeIgnored/>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|**ignorablePrefix、ignorablePrefix1* など*|XML 1.0 仕様ごとの有効なプレフィックス文字列。|  
+|**ignorableUri**|XML 1.0 仕様ごとに名前空間を指定する有効な URI。|  
+|**ThisElementCanBeIgnored**|基になる型を解決できない場合に、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] プロセッサ実装により無視できる要素。|  
+  
+## 解説  
+ この `mc` [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間プレフィックスは、互換性のある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の名前空間 [!INCLUDE[TLA#tla_mcxmlnsv1](../../../../includes/tlasharptla-mcxmlnsv1-md.md)] を割り当てるときに使用する推奨プレフィックス規則です。  
+  
+ 要素名のプレフィックス部分が `mc:Ignorable` として識別される要素または属性は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサで処理されるとき、エラーを発生しません。  その属性を基になる型またはプログラミング構成体に解決できない場合、その要素は無視されます。  ただし、無視された要素は、その未処理の影響である追加要素の要件に関して、追加の解析エラーを生成する可能性もあるので注意してください。  たとえば、特定の要素のコンテンツ モデルが 1 つだけの子要素を必要とするときに、指定された子要素が `mc:Ignorable` プレフィックスにあると型に解決できないので、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサはエラーを発生させる場合があります。  
+  
+ `mc:Ignorable` は、識別子文字列への名前空間の割り当てにのみ適用されます。  `mc:Ignorable` は、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 名前空間およびアセンブリ \(または、既定でアセンブリとして現在実行可能なファイル\) を指定する、アセンブリへの名前空間の割り当てには適用されません。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサを実装する場合、プロセッサの実装では、`mc:Ignorable` として識別されるプレフィックスが修飾する要素または属性の型解決について、解析エラーまたは処理エラーを発生させることはできません。  ただし、プロセッサの実装では例外が発生することもあり、この例外は、前述した 1 つの子要素の例のように、要素の読み込みまたは処理の失敗の 2 次的な結果です。  
+  
+ 既定では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、無視された要素内のコンテンツを無視します。  ただし、追加属性、つまり [mc:ProcessContent 属性](../../../../docs/framework/wpf/advanced/mc-processcontent-attribute.md)を指定して、次に使用可能な親要素による無視された要素内のコンテンツの継続処理を要求できます。  
+  
+ 複数のプレフィックスは、たとえば、`mc:Ignorable="ignore1 ignore2"` のように 1 つ以上の空白文字を区切り記号として使用して、属性内で指定できます。  
+  
+ [!INCLUDE[TLA#tla_mcxmlnsv1](../../../../includes/tlasharptla-mcxmlnsv1-md.md)] 名前空間は、[!INCLUDE[TLA#tla_sdk](../../../../includes/tlasharptla-sdk-md.md)] のこの領域には記載されていないその他の要素や属性を定義します。  詳細については、「[XML マークアップの互換性の仕様](http://go.microsoft.com/fwlink/?LinkId=73824)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Markup.XamlReader>   
+ [PresentationOptions:Freeze 属性](../../../../docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/mc-processcontent-attribute.md b/docs/framework/wpf/advanced/mc-processcontent-attribute.md
new file mode 100644
index 00000000000..cedd5f2831a
--- /dev/null
+++ b/docs/framework/wpf/advanced/mc-processcontent-attribute.md
@@ -0,0 +1,58 @@
+---
+title: "mc:ProcessContent 属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "mc:ProcessContent 属性"
+  - "XAML, mc:ProcessContent 属性"
+ms.assetid: 2689b2c8-b4dc-4b71-b9bd-f95e619122d7
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# mc:ProcessContent 属性
+[mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)の指定によって直接の親要素が [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサで無視された場合でも、関連する親要素によってコンテンツを処理する [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 要素を指定します。  `mc:ProcessContent` 属性はカスタム ネームスペースのマッピングと [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] バージョン管理のための互換性のあるマークアップをサポートします。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object  
+  xmlns:ignorablePrefix="ignorableUri"  
+  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+  mc:Ignorable="ignorablePrefix"...  
+  mc:ProcessContent="ignorablePrefix:ThisElementCanBeIgnored"  
+>  
+    <ignorablePrefix:ThisElementCanBeIgnored>  
+        [content]  
+    </ignorablePrefix:ThisElementCanBeIgnored>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|**ignorablePrefix**|XML 1.0 仕様ごとの有効なプレフィックス文字列。|  
+|**ignorableUri**|XML 1.0 仕様ごとに名前空間を指定する有効な URI。|  
+|**ThisElementCanBeIgnored**|基になる型を解決できない場合に、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] プロセッサ実装により無視できる要素。|  
+|**\[content\]**|*ThisElementCanBeIgnored* は、無視可能とマークされます。  プロセッサがその要素を無視した場合、*\[content\]* は *object* によって処理されます。|  
+  
+## 解説  
+ 既定では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、無視された要素内のコンテンツを無視します。  `mc:ProcessContent` によって特定の要素を指定することにより、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサで無視された要素内のコンテンツを引き続き処理することができます。  これは通常、コンテンツが複数のタグ内で入れ子になっており、無視できるものと無視できないものがそれぞれ少なくとも 1 つある場合に使用されます。  
+  
+ 属性内では、`mc:ProcessContent="ignore:Element1 ignore:Element2"` のようにスペースで区切ることによって複数のプレフィックスを指定できます。  
+  
+ [!INCLUDE[TLA#tla_mcxmlnsv1](../../../../includes/tlasharptla-mcxmlnsv1-md.md)] 名前空間は、[!INCLUDE[TLA#tla_sdk](../../../../includes/tlasharptla-sdk-md.md)] のこの領域には記載されていないその他の要素や属性を定義します。  詳細については、「[XML マークアップの互換性の仕様](http://go.microsoft.com/fwlink/?LinkId=73824)」を参照してください。  
+  
+## 参照  
+ [mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/media/caf-callouts.png b/docs/framework/wpf/advanced/media/caf-callouts.png
new file mode 100644
index 00000000000..a99a89c489b
Binary files /dev/null and b/docs/framework/wpf/advanced/media/caf-callouts.png differ
diff --git a/docs/framework/wpf/advanced/media/caf-dataanchoring.png b/docs/framework/wpf/advanced/media/caf-dataanchoring.png
new file mode 100644
index 00000000000..8cb3e0c5458
Binary files /dev/null and b/docs/framework/wpf/advanced/media/caf-dataanchoring.png differ
diff --git a/docs/framework/wpf/advanced/media/caf-stickynote.jpg b/docs/framework/wpf/advanced/media/caf-stickynote.jpg
new file mode 100644
index 00000000000..8db8accfeec
Binary files /dev/null and b/docs/framework/wpf/advanced/media/caf-stickynote.jpg differ
diff --git a/docs/framework/wpf/advanced/media/cleartyperegistry01.png b/docs/framework/wpf/advanced/media/cleartyperegistry01.png
new file mode 100644
index 00000000000..c3fabec7e5f
Binary files /dev/null and b/docs/framework/wpf/advanced/media/cleartyperegistry01.png differ
diff --git a/docs/framework/wpf/advanced/media/cleartyperegistry02.png b/docs/framework/wpf/advanced/media/cleartyperegistry02.png
new file mode 100644
index 00000000000..825996df041
Binary files /dev/null and b/docs/framework/wpf/advanced/media/cleartyperegistry02.png differ
diff --git a/docs/framework/wpf/advanced/media/d3dimage-buffers.png b/docs/framework/wpf/advanced/media/d3dimage-buffers.png
new file mode 100644
index 00000000000..4051059de86
Binary files /dev/null and b/docs/framework/wpf/advanced/media/d3dimage-buffers.png differ
diff --git a/docs/framework/wpf/advanced/media/directxdiagnostictool-01.png b/docs/framework/wpf/advanced/media/directxdiagnostictool-01.png
new file mode 100644
index 00000000000..b55b282c8d2
Binary files /dev/null and b/docs/framework/wpf/advanced/media/directxdiagnostictool-01.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-content-schema.png b/docs/framework/wpf/advanced/media/flow-content-schema.png
new file mode 100644
index 00000000000..1c426a522a2
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-content-schema.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-ovw-first-example.png b/docs/framework/wpf/advanced/media/flow-ovw-first-example.png
new file mode 100644
index 00000000000..50c255fd2aa
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-ovw-first-example.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough1.png b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough1.png
new file mode 100644
index 00000000000..6daff9731c5
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough1.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough2.png b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough2.png
new file mode 100644
index 00000000000..b2db85d1dd9
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough2.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough3.png b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough3.png
new file mode 100644
index 00000000000..32a2c4cf912
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough3.png differ
diff --git a/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough4.png b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough4.png
new file mode 100644
index 00000000000..e4c52724256
Binary files /dev/null and b/docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough4.png differ
diff --git a/docs/framework/wpf/advanced/media/formattedtext02.png b/docs/framework/wpf/advanced/media/formattedtext02.png
new file mode 100644
index 00000000000..c86de38702e
Binary files /dev/null and b/docs/framework/wpf/advanced/media/formattedtext02.png differ
diff --git a/docs/framework/wpf/advanced/media/glyph-example.png b/docs/framework/wpf/advanced/media/glyph-example.png
new file mode 100644
index 00000000000..5c7729f1e5e
Binary files /dev/null and b/docs/framework/wpf/advanced/media/glyph-example.png differ
diff --git a/docs/framework/wpf/advanced/media/ink-stylusevents.png b/docs/framework/wpf/advanced/media/ink-stylusevents.png
new file mode 100644
index 00000000000..81ea051fdf8
Binary files /dev/null and b/docs/framework/wpf/advanced/media/ink-stylusevents.png differ
diff --git a/docs/framework/wpf/advanced/media/ink-stylusplugins.png b/docs/framework/wpf/advanced/media/ink-stylusplugins.png
new file mode 100644
index 00000000000..12c6eb1a693
Binary files /dev/null and b/docs/framework/wpf/advanced/media/ink-stylusplugins.png differ
diff --git a/docs/framework/wpf/advanced/media/inkthreading-drawingink.png b/docs/framework/wpf/advanced/media/inkthreading-drawingink.png
new file mode 100644
index 00000000000..411ed89d320
Binary files /dev/null and b/docs/framework/wpf/advanced/media/inkthreading-drawingink.png differ
diff --git a/docs/framework/wpf/advanced/media/inkthreading-plugincallbacks.png b/docs/framework/wpf/advanced/media/inkthreading-plugincallbacks.png
new file mode 100644
index 00000000000..82a2f58e687
Binary files /dev/null and b/docs/framework/wpf/advanced/media/inkthreading-plugincallbacks.png differ
diff --git a/docs/framework/wpf/advanced/media/inkthreading-pluginorder.png b/docs/framework/wpf/advanced/media/inkthreading-pluginorder.png
new file mode 100644
index 00000000000..61aa46dda54
Binary files /dev/null and b/docs/framework/wpf/advanced/media/inkthreading-pluginorder.png differ
diff --git a/docs/framework/wpf/advanced/media/inkthreading-visualtree.png b/docs/framework/wpf/advanced/media/inkthreading-visualtree.png
new file mode 100644
index 00000000000..79eae23799d
Binary files /dev/null and b/docs/framework/wpf/advanced/media/inkthreading-visualtree.png differ
diff --git a/docs/framework/wpf/advanced/media/localizationworkflow.png b/docs/framework/wpf/advanced/media/localizationworkflow.png
new file mode 100644
index 00000000000..d37adcb8d15
Binary files /dev/null and b/docs/framework/wpf/advanced/media/localizationworkflow.png differ
diff --git a/docs/framework/wpf/advanced/media/localizationworkflow2.png b/docs/framework/wpf/advanced/media/localizationworkflow2.png
new file mode 100644
index 00000000000..0e96f939eb2
Binary files /dev/null and b/docs/framework/wpf/advanced/media/localizationworkflow2.png differ
diff --git a/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle01.png b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle01.png
new file mode 100644
index 00000000000..9346557c213
Binary files /dev/null and b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle01.png differ
diff --git a/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle02.png b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle02.png
new file mode 100644
index 00000000000..c42ea919cd6
Binary files /dev/null and b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle02.png differ
diff --git a/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle03.png b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle03.png
new file mode 100644
index 00000000000..004b01a36f1
Binary files /dev/null and b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle03.png differ
diff --git a/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle04.png b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle04.png
new file mode 100644
index 00000000000..a0ea4b9ffdc
Binary files /dev/null and b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle04.png differ
diff --git a/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle05.png b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle05.png
new file mode 100644
index 00000000000..420e871509d
Binary files /dev/null and b/docs/framework/wpf/advanced/media/migrationinteroparchitectarticle05.png differ
diff --git a/docs/framework/wpf/advanced/media/ndp-manipulationevents.png b/docs/framework/wpf/advanced/media/ndp-manipulationevents.png
new file mode 100644
index 00000000000..e003bd12e7e
Binary files /dev/null and b/docs/framework/wpf/advanced/media/ndp-manipulationevents.png differ
diff --git a/docs/framework/wpf/advanced/media/ndp-touchevents.png b/docs/framework/wpf/advanced/media/ndp-touchevents.png
new file mode 100644
index 00000000000..a022d42fc76
Binary files /dev/null and b/docs/framework/wpf/advanced/media/ndp-touchevents.png differ
diff --git a/docs/framework/wpf/advanced/media/ndp-touchmanipulateevents.png b/docs/framework/wpf/advanced/media/ndp-touchmanipulateevents.png
new file mode 100644
index 00000000000..00fe55192f6
Binary files /dev/null and b/docs/framework/wpf/advanced/media/ndp-touchmanipulateevents.png differ
diff --git a/docs/framework/wpf/advanced/media/textdecoration02.png b/docs/framework/wpf/advanced/media/textdecoration02.png
new file mode 100644
index 00000000000..e208cc069f9
Binary files /dev/null and b/docs/framework/wpf/advanced/media/textdecoration02.png differ
diff --git a/docs/framework/wpf/advanced/media/textdecoration03.png b/docs/framework/wpf/advanced/media/textdecoration03.png
new file mode 100644
index 00000000000..9ee7680e05f
Binary files /dev/null and b/docs/framework/wpf/advanced/media/textdecoration03.png differ
diff --git a/docs/framework/wpf/advanced/media/textformatter01.png b/docs/framework/wpf/advanced/media/textformatter01.png
new file mode 100644
index 00000000000..92cb0f81eef
Binary files /dev/null and b/docs/framework/wpf/advanced/media/textformatter01.png differ
diff --git a/docs/framework/wpf/advanced/media/threadingdispatcherqueue.PNG b/docs/framework/wpf/advanced/media/threadingdispatcherqueue.PNG
new file mode 100644
index 00000000000..810e82af7ed
Binary files /dev/null and b/docs/framework/wpf/advanced/media/threadingdispatcherqueue.PNG differ
diff --git a/docs/framework/wpf/advanced/media/threadingprimenumberscreenshot.PNG b/docs/framework/wpf/advanced/media/threadingprimenumberscreenshot.PNG
new file mode 100644
index 00000000000..1d55c464efc
Binary files /dev/null and b/docs/framework/wpf/advanced/media/threadingprimenumberscreenshot.PNG differ
diff --git a/docs/framework/wpf/advanced/media/threadingreentrancy.png b/docs/framework/wpf/advanced/media/threadingreentrancy.png
new file mode 100644
index 00000000000..3b35825a4ab
Binary files /dev/null and b/docs/framework/wpf/advanced/media/threadingreentrancy.png differ
diff --git a/docs/framework/wpf/advanced/media/typographyinwpf-04.png b/docs/framework/wpf/advanced/media/typographyinwpf-04.png
new file mode 100644
index 00000000000..b97cdc4bb49
Binary files /dev/null and b/docs/framework/wpf/advanced/media/typographyinwpf-04.png differ
diff --git a/docs/framework/wpf/advanced/media/typographyinwpf01.png b/docs/framework/wpf/advanced/media/typographyinwpf01.png
new file mode 100644
index 00000000000..534c4d6a225
Binary files /dev/null and b/docs/framework/wpf/advanced/media/typographyinwpf01.png differ
diff --git a/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-01.png b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-01.png
new file mode 100644
index 00000000000..25574d03faa
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-01.png differ
diff --git a/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-02.png b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-02.png
new file mode 100644
index 00000000000..0c648042def
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-02.png differ
diff --git a/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-03.png b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-03.png
new file mode 100644
index 00000000000..6c9129f3410
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-03.png differ
diff --git a/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-04.png b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-04.png
new file mode 100644
index 00000000000..105891325a5
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wcpsdk-mmgraphics-text-cleartype-overview-04.png differ
diff --git a/docs/framework/wpf/advanced/media/wcsdkcoreinputevents.png b/docs/framework/wpf/advanced/media/wcsdkcoreinputevents.png
new file mode 100644
index 00000000000..b86bdde4176
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wcsdkcoreinputevents.png differ
diff --git a/docs/framework/wpf/advanced/media/wfhost.png b/docs/framework/wpf/advanced/media/wfhost.png
new file mode 100644
index 00000000000..54042ceb4fa
Binary files /dev/null and b/docs/framework/wpf/advanced/media/wfhost.png differ
diff --git a/docs/framework/wpf/advanced/media/xpsprint.PNG b/docs/framework/wpf/advanced/media/xpsprint.PNG
new file mode 100644
index 00000000000..dfdfcc9b7cc
Binary files /dev/null and b/docs/framework/wpf/advanced/media/xpsprint.PNG differ
diff --git a/docs/framework/wpf/advanced/merged-resource-dictionaries.md b/docs/framework/wpf/advanced/merged-resource-dictionaries.md
new file mode 100644
index 00000000000..2fcae1287f1
--- /dev/null
+++ b/docs/framework/wpf/advanced/merged-resource-dictionaries.md
@@ -0,0 +1,65 @@
+---
+title: "マージされたリソース ディクショナリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "マージされたリソース ディクショナリ"
+  - "マージされたリソース ディクショナリ"
+ms.assetid: d159531f-05d4-49fd-b951-c332de51e5bc
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# マージされたリソース ディクショナリ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]リソースでは、マージされたリソース ディクショナリ機能をサポートします。 この機能の resources の部分を定義する方法を提供する、 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 、コンパイル済みの外部でアプリケーション[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]アプリケーションです。 アプリケーション間でリソースを共有することができますしもより簡単に分離ローカリゼーション用です。  
+  
+## <a name="introducing-a-merged-resource-dictionary"></a>マージされたリソース ディクショナリの概要  
+ マークアップでは、次の構文を使用して、ページにマージされたリソース ディクショナリを導入します。  
+  
+ [!code-xml[ResourceMergeDictionary#MergedXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ResourceMergeDictionary/CS/default.xaml#mergedxaml)]  
+  
+ 注意してください、 <xref:System.Windows.ResourceDictionary>要素がありません、 [X:key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)が、一般に必要なリソース コレクション内のすべての項目。 なく他<xref:System.Windows.ResourceDictionary>内を参照、 <xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>コレクションは特別な場合は、このマージされたリソース ディクショナリのシナリオ用に予約されています。 <xref:System.Windows.ResourceDictionary>マージを導入するリソース ディクショナリを使用できない、 [X:key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)します。 通常、各<xref:System.Windows.ResourceDictionary>内で、 <xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>コレクションの指定、<xref:System.Windows.ResourceDictionary.Source%2A>属性です。 値<xref:System.Windows.ResourceDictionary.Source%2A>する必要があります、[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)]マージするリソース ファイルの場所を解決します。 保存先[!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]別にする必要があります[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルと<xref:System.Windows.ResourceDictionary>ルート要素です。  
+  
+> [!NOTE]
+>  内のリソースを定義することは、 <xref:System.Windows.ResourceDictionary>のいずれかを指定する代わりとして、マージされたディクショナリとして指定されている<xref:System.Windows.ResourceDictionary.Source%2A>、またはネイティブ コードに加えて、指定されたソースからすべてのリソースが含まれています。 ただし、これは一般的なシナリオマージされたディクショナリの主なシナリオでは、外部ファイルの場所からリソースをマージします。 ページのマークアップ内のリソースを指定する場合は、する必要があります通常これら定義のメイン<xref:System.Windows.ResourceDictionary>マージされたディクショナリではなく。  
+  
+## <a name="merged-dictionary-behavior"></a>マージされたディクショナリの動作  
+ マージされたディクショナリ内のリソースは、直後にマージされますメイン リソース ディクショナリのスコープには、リソースの検索スコープ内の位置を占有します。 リソース キーは、個々 のディクショナリ内で一意であるが、キーは、マージされたディクショナリのセットに複数回を配置できます。 返されるリソースは最後のディクショナリで順が見つかりませんでしたから取得する場合は、 <xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>コレクションです。 場合、 <xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>コレクションが定義された[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]マークアップで提供されているため、マージされたディクショナリ コレクション内の順序は、要素の順序。 キーは、プライマリ辞書およびマージされたディクショナリに定義されているが場合、返されるリソースは、プライマリ ディクショナリから取得されます。 これらのスコープ規則に同じように適用静的リソース参照と動的なリソースの両方の参照。  
+  
+### <a name="merged-dictionaries-and-code"></a>マージされたディクショナリとコード  
+ マージされたディクショナリに追加できる、`Resources`ディクショナリをコードします。 既定値、最初は空<xref:System.Windows.ResourceDictionary>のいずれかに存在する`Resources`プロパティにも既定では、最初は空<xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>コレクション プロパティです。 コードをマージされたディクショナリを追加するには、目的のプライマリへの参照を取得<xref:System.Windows.ResourceDictionary>、取得、 <xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>プロパティの値、および呼び出し`Add`のジェネリック`Collection`に格納されている<xref:System.Windows.ResourceDictionary.MergedDictionaries%2A>します。 新しいオブジェクトを追加する必要があります<xref:System.Windows.ResourceDictionary>します。 コードでは、設定しない、<xref:System.Windows.ResourceDictionary.Source%2A>プロパティです。 代わりに、取得する必要があります、 <xref:System.Windows.ResourceDictionary>をいずれか&1; つを作成するか、読み込むオブジェクト。 既存のロードに&1; つの方法<xref:System.Windows.ResourceDictionary>を呼び出す<xref:System.Windows.Markup.XamlReader.Load%2A?displayProperty=fullName> 、既存の[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイル ストリームを持つ、 <xref:System.Windows.ResourceDictionary>キャストし、ルート、 <xref:System.Windows.Markup.XamlReader.Load%2A?displayProperty=fullName>に値を返す<xref:System.Windows.ResourceDictionary>します。  
+  
+### <a name="merged-resource-dictionary-uris"></a>マージされたリソース ディクショナリの Uri  
+ 示される、マージされたリソース ディクショナリをインクルードする方法のいくつかの手法がある、[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)]が使用する形式。 大まかに言えば、これらの手法に分類できます&2; つのカテゴリ: リソース、プロジェクトの一部としてコンパイルされますと、プロジェクトの一部としてコンパイルされません。  
+  
+ リソースについては、プロジェクトの一部としてコンパイルされるリソースの場所を参照する相対パスを使用することができます。 相対パスは、コンパイル時に評価されます。 リソースは、ビルド アクションがリソースとしてプロジェクトの一部として定義する必要があります。 リソースとしてプロジェクトにリソースの .xaml ファイルを含める場合リソース ファイルを出力ディレクトリにコピーする必要はありません、リソースが、コンパイルされたアプリケーション内に含まれています。 コンテンツのビルド アクションを使用することもできますが、出力ディレクトリにファイルをコピーし、実行可能ファイルにも同じパスのリレーションシップのリソース ファイルを展開する必要があります。  
+  
+> [!NOTE]
+>  埋め込まれたリソースのビルド アクションを使用しないでください。 ビルド アクション自体はサポートされて[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、アプリケーションがの解像度<xref:System.Windows.ResourceDictionary.Source%2A>取り込みません<xref:System.Resources.ResourceManager>、し、そのため、ストリームから個々 のリソースを分離することはできません。 その他の目的でも使用される限り、埋め込まれたリソースを引き続き使用できます<xref:System.Resources.ResourceManager>リソースにアクセスします。  
+  
+ 関連する手法は、パック URI を使用する、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルを開き、ソースとしてそれを参照してください。 パック URI には、参照アセンブリおよびその他の手法のコンポーネントへの参照ができるようにします。 パッケージの Uri の詳細については、次を参照してください。 [WPF アプリケーションのリソース、コンテンツ、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)します。  
+  
+ プロジェクトの一部としてコンパイルされないリソースの URI は実行時に評価されます。 ファイルなど、共通の URI トランスポートを使用することができます。 または http: リソース ファイルを参照します。 コンパイルされないリソース方法を使用する欠点は、そのファイル: その他の展開手順、および http アクセスが必要です: へのアクセスは、インターネット セキュリティ ゾーンを意味します。  
+  
+### <a name="reusing-merged-dictionaries"></a>マージされたディクショナリを再利用します。  
+ 再利用したりを通じて参照できるリソース ディクショナリをマージするために、アプリケーション間でマージされたリソース ディクショナリを共有できる有効な[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)]です。 この方法は、アプリケーションの展開戦略に依存しているアプリケーション モデルと正確に従います。 前述の Pack URI の方法でソースとしてマージされたリソースの複数のプロジェクト間で開発中にアセンブリ参照を共有することによってする手段を提供します。 このシナリオでは、リソースはまだ、クライアントによって配布され、少なくとも&1; つのアプリケーションの参照先アセンブリを展開する必要があります。 Http プロトコルを使用して配布 URI によってマージされたリソースを参照することもできます。  
+  
+ ローカル アプリケーションは、ファイルや、ローカルの共有記憶域にもう&1; つの可能なマージされたディクショナリは、マージされたディクショナリを作成/アプリケーション展開シナリオです。  
+  
+### <a name="localization"></a>ローカリゼーション  
+ リソースをローカライズする必要がある場合はプライマリ ディクショナリにマージされ、緩やかな保持されているディクショナリに分離して[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、これらのファイルを個別にローカライズすることができます。 この手法は、サテライト リソース アセンブリをローカライズする代わりに軽量です。 詳細については、「 [WPF のグローバリゼーションおよびローカリゼーションの概要](../../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.ResourceDictionary>   
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [リソースとコード](../../../../docs/framework/wpf/advanced/resources-and-code.md)   
+ [WPF アプリケーションのリソース、コンテンツ、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/migration-and-interoperability.md b/docs/framework/wpf/advanced/migration-and-interoperability.md
new file mode 100644
index 00000000000..982f5f1b2cc
--- /dev/null
+++ b/docs/framework/wpf/advanced/migration-and-interoperability.md
@@ -0,0 +1,48 @@
+---
+title: "移行と相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF 相互運用性]"
+  - "相互運用性 [WPF]"
+  - "移行 [WPF]"
+  - "Windows フォーム コントロール [WPF 相互運用性]"
+  - "Windows Presentation Foundation, 相互運用性"
+  - "Windows Presentation Foundation, 移行"
+  - "WPF, 相互運用性"
+  - "WPF, 移行"
+ms.assetid: d655de05-bf63-4814-bc64-6b3be01c70a2
+caps.latest.revision: 41
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 41
+---
+# 移行と相互運用性
+このページには、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションと、他の種類の [!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] アプリケーションの相互運用を実装する方法を説明したドキュメントへのリンクが含まれています。  
+  
+## このセクションの内容  
+ [WPF と Windows フォームの相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md)  
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)  
+ [WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)  
+  
+## 関連項目  
+  
+|語句|定義|  
+|--------|--------|  
+|<xref:System.Windows.Forms.Integration.WindowsFormsHost>|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページの要素としてホストできるようにする要素。|  
+|<xref:System.Windows.Forms.Integration.ElementHost>|[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] コントロールのホストに使用できる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロール。|  
+|<xref:System.Windows.Interop.HwndSource>|[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーション内の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 領域をホストします。|  
+|<xref:System.Windows.Interop.HwndHost>|<xref:System.Windows.Forms.Integration.WindowsFormsHost> の基本クラス。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでホストされる場合に、HWND ベースの技術がすべて使用する基本機能を定義します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション内で [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウをホストするには、これをサブクラス化します。|  
+|<xref:System.Windows.Interop.BrowserInteropHelper>|ブラウザーがホストする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのブラウザー環境の状態を報告するヘルパー クラス。|  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/object-lifetime-events.md b/docs/framework/wpf/advanced/object-lifetime-events.md
new file mode 100644
index 00000000000..24d929cebb2
--- /dev/null
+++ b/docs/framework/wpf/advanced/object-lifetime-events.md
@@ -0,0 +1,90 @@
+---
+title: "オブジェクトの有効期間イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Activated イベント"
+  - "アプリケーション オブジェクト, 有効期間イベント"
+  - "クラス, フレーム"
+  - "クラス, NavigationWindow"
+  - "Closed イベント"
+  - "Closing イベント"
+  - "ContentRendered イベント"
+  - "Deactivated イベント"
+  - "イベント, Activated"
+  - "イベント, 終了"
+  - "イベント, Closing"
+  - "イベント, ContentRendered"
+  - "イベント, Deactivated"
+  - "イベント, 初期化済み"
+  - "イベント, 読み込み"
+  - "イベント, アンロードされました"
+  - "終了イベント"
+  - "Frame クラス"
+  - "Initialized イベント"
+  - "オブジェクトの有効期間イベント"
+  - "Loaded イベント"
+  - "NavigationWindow クラス"
+  - "オブジェクトの有効期間イベント"
+  - "起動イベント"
+  - "Unloaded イベント"
+ms.assetid: face6fc7-465b-4502-bfe5-e88d2e729a78
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# オブジェクトの有効期間イベント
+ここでは、オブジェクトの作成、使用、および破棄の有効期間におけるステージを示す特定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベントについて説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、ユーザーが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] クラスの既存の[依存関係プロパティ](GTMT)の使用という観点から依存関係プロパティを理解し、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」トピックを通読していることを前提としています。  このトピックの例を理解するには、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] についての理解があり \(「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照\)、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの記述方法を理解していることも必要です。  
+  
+<a name="intro"></a>   
+## オブジェクトの有効期間イベント  
+ [!INCLUDE[TLA#tla_netframewk](../../../../includes/tlasharptla-netframewk-md.md)] マネージ コードのオブジェクトはすべて、作成、使用、および破棄という一連の有効期間のステージを経由します。  また、多くのオブジェクトには、破棄フェーズの一環として発生する有効期間の終了ステージがあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] オブジェクト \(具体的には [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が要素として識別するビジュアル オブジェクト\) にも、共通する一連のオブジェクト有効期間ステージがあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プログラミングおよびアプリケーション モデルでは、これらのステージが一連のイベントとして公開されます。  有効期間イベントに関しては、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に、全般的要素、ウィンドウ要素、ナビゲーション ホスト、およびアプリケーション オブジェクトの 4 種類の主要オブジェクトがあります。  ウィンドウ要素とナビゲーション ホストは、さらに大きなビジュアル オブジェクト \(要素\) のグループ内にも存在します。  このトピックでは、すべての要素に共通する有効期間イベントについて説明し、次にアプリケーション定義、ウィンドウ要素、またはナビゲーション ホストに適用される特定の有効期間イベントについて説明します。  
+  
+<a name="common_events"></a>   
+## 要素に関する共通の有効期間イベント  
+ 任意の [WPF フレームワーク レベル](GTMT)要素 \(<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> から派生しているオブジェクト\) には、次の 3 つの共通する有効期間イベントがあります。それらは、<xref:System.Windows.FrameworkElement.Initialized>、<xref:System.Windows.FrameworkElement.Loaded>、および <xref:System.Windows.FrameworkElement.Unloaded> です。  
+  
+### 初期化  
+ <xref:System.Windows.FrameworkElement.Initialized> が最初に発生し、コンストラクターの呼び出しによって、オブジェクトの初期化に大まかに対応します。  イベントは初期化に応答して発生するため、オブジェクトのすべてのプロパティが設定されることが保証されます   \(例外は、動的リソースまたはバインディングなどの評価されない式の使用です\)。すべてのプロパティが設定されるという要件の結果として、マークアップで定義される入れ子にした要素によって発生する一連の <xref:System.Windows.FrameworkElement.Initialized> は、要素ツリーの最下位の要素からルート方向の親要素への順序で発生するように見えます。  この順序は親子のリレーションシップおよびコンテインメントがプロパティであるためで、親のプロパティを設定する子要素も完全に初期化されるまで、親は初期化を報告できません。  
+  
+ <xref:System.Windows.FrameworkElement.Initialized> イベントへの応答としてハンドラーを記述する際は、ハンドラーが添付される周辺の要素ツリー \([論理ツリー](GTMT)または[ビジュアル ツリー](GTMT)\) 内に他のすべての要素、特に親要素が作成されているという保証がないことを考慮する必要があります。  メンバー変数が null であるか、データ ソースが基になるバインディングによってまだ設定されていない可能性があります \(式レベルでも\)。  
+  
+### 読み込み済み  
+ <xref:System.Windows.FrameworkElement.Loaded> が次に発生します。  <xref:System.Windows.FrameworkElement.Loaded> イベントは、最終的な描画の前に発生しますが、それはレイアウト システムが描画に必要なすべての値を計算した後です。  <xref:System.Windows.FrameworkElement.Loaded> は、要素を含む論理ツリーが完全である場合にのみ発生し、HWND とレンダリング サーフェイスを提供するプレゼンテーション ソースに接続されています。  標準データ バインディング \(他のプロパティや直接定義したデータ ソースなどのローカル ソースへのバインディング\) は、<xref:System.Windows.FrameworkElement.Loaded> の前に発生しています。  非同期データ バインディング \(外部ソースまたは動的ソース\) が発生している可能性もありますが、非同期であるという性質の定義から、その保証はできません。  
+  
+ <xref:System.Windows.FrameworkElement.Loaded> イベントを発生させる機構は、<xref:System.Windows.FrameworkElement.Initialized> とは異なります。  <xref:System.Windows.FrameworkElement.Initialized> イベントは、要素単位で発生し、完全な要素ツリーによる直接の調整はありません。  これに対し、<xref:System.Windows.FrameworkElement.Loaded> イベントは、要素ツリー \(特に、[論理ツリー](GTMT)\) 全体にわたる調整動作として発生します。  ツリーのすべての要素が読み込まれたと見なされる状態にあると、<xref:System.Windows.FrameworkElement.Loaded> イベントは、最初にルート要素で発生します。  次に、<xref:System.Windows.FrameworkElement.Loaded> イベントは、各子要素で連続して発生します。  
+  
+> [!NOTE]
+>  この動作は、表面上は、[ルーティング イベント](GTMT)のトンネリングに似ているとも言えます。  ただし、イベントからイベントへと伝達される情報はありません。  各要素は常に <xref:System.Windows.FrameworkElement.Loaded> イベントを処理することができ、イベント データを処理済みとしてマークしても、その要素以外への影響はありません。  
+  
+### アンロード  
+ 最後に <xref:System.Windows.FrameworkElement.Unloaded> が発生し、プレゼンテーション ソースまたは削除されているビジュアル親によって開始されます。  <xref:System.Windows.FrameworkElement.Unloaded> が発生して処理される際、\(<xref:System.Windows.FrameworkElement.Parent%2A> プロパティによって決定される\) イベント ソースの親または、論理ツリーまたはビジュアル ツリー内にある任意の要素が既に設定解除されている可能性があります。これは、データ バインディング、リソース参照、およびスタイルが、通常または前回のランタイム値に設定されていない可能性があることを意味します。  
+  
+<a name="application_model_elements"></a>   
+## 有効期間イベント アプリケーション モデルの要素  
+ 要素の共通する有効期間イベントに基づいて構築されたアプリケーション モデル要素には、<xref:System.Windows.Application>、<xref:System.Windows.Window>、<xref:System.Windows.Controls.Page>、<xref:System.Windows.Navigation.NavigationWindow>、および <xref:System.Windows.Controls.Frame> があります。  これらの要素は、共通する有効期間イベントを、特定の目的に関する追加イベントで拡張します。  これらの詳細については、次のトピックで説明しています。  
+  
+-   <xref:System.Windows.Application>: [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md).  
+  
+-   <xref:System.Windows.Window>: [WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md).  
+  
+-   <xref:System.Windows.Controls.Page>、<xref:System.Windows.Navigation.NavigationWindow>、および <xref:System.Windows.Controls.Frame>: [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)  
+  
+## 参照  
+ [依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/opentype-font-features.md b/docs/framework/wpf/advanced/opentype-font-features.md
new file mode 100644
index 00000000000..1cf01ad1b15
--- /dev/null
+++ b/docs/framework/wpf/advanced/opentype-font-features.md
@@ -0,0 +1,372 @@
+---
+title: "OpenType フォントの機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "OpenType フォント"
+  - "文字体裁、OpenType フォント テクノロジ"
+  - "OpenType フォント テクノロジ"
+ms.assetid: 4061a9d1-fe8b-4921-9e17-18ec7d2e3ea2
+caps.latest.revision: 38
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# OpenType フォントの機能
+このトピックのいくつかの主な機能の概要を示します[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]でフォント技術[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overview"></a>   
+## <a name="opentype-font-format"></a>OpenType フォントの書式  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントの書式はの拡張機能、[!INCLUDE[TLA#tla_truetype](../../../../includes/tlasharptla-truetype-md.md)]フォントの書式、PostScript フォント データに対するサポートを追加します。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントの書式が共同で開発された[!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)]および Adobe Corporation します。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントおよびオペレーティング システム サービスのどのサポート[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]、フォントが含まれているかどうかのフォントがインストールして、フォントを使用する簡単な方法をユーザーに提供[!INCLUDE[TLA2#tla_truetype](../../../../includes/tla2sharptla-truetype-md.md)]アウトライン] または [CFF (PostScript) について説明します。  
+  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントの書式の次の開発者の課題に対処します。  
+  
+-   広範なマルチプラット フォームのサポート。  
+  
+-   国際文字セットのサポートが強化されます。  
+  
+-   フォント データを保護します。  
+  
+-   フォントの分布をより効率的にファイルのサイズを小さくします。  
+  
+-   高度なテキスト編集コントロールを幅広くサポートします。  
+  
+> [!NOTE]
+>  Windows SDK には、サンプルのセットが含まれています。[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]で使用できるフォント[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]アプリケーションです。 これらのフォントは、このトピックの残りの部分で説明する機能のほとんどを提供します。 詳細については、次を参照してください。[サンプル OpenType フォント パック](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)します。  
+  
+ 参照してください、 [OpenType 仕様](http://go.microsoft.com/fwlink/?LinkId=96731)の詳細については、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントの書式。  
+  
+### <a name="advanced-typographic-extensions"></a>高度な印刷用の拡張機能  
+ 高度な印刷用のテーブル ([!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]レイアウト テーブル) いずれかを使用するフォントの機能を拡張[!INCLUDE[TLA2#tla_truetype](../../../../includes/tla2sharptla-truetype-md.md)]または CFF について説明します。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]レイアウトのフォントには、高品質の国際文字体裁をサポートするために、フォントの機能を拡張する追加の情報が含まれます。 ほとんど[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォント全体のサブセットのみを公開する[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]利用可能な機能です。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、次の機能を提供します。  
+  
+-   文字と合字、位置指定のフォーム、修正候補一覧, およびその他のフォント代替表をサポートするグリフの間の充実したマッピング。  
+  
+-   2 次元配置とグリフの結合をサポートします。  
+  
+-   明示的なスクリプトと言語の情報、フォントに含まれているため、テキスト処理アプリケーションでは、その動作を必要に応じて調整できます。  
+  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]レイアウト テーブルがで詳しく説明されている、 [「フォント ファイル テーブル」](http://www.microsoft.com/typography/otspec/otff.htm)のセクションで、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]仕様です。  
+  
+ この概要の残りの部分では、幅と、視覚的に対象のいくつかの柔軟性が導入されています[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]のプロパティによって公開されている機能、<xref:System.Windows.Documents.Typography>オブジェクトです。 このオブジェクトの詳細については、次を参照してください。[文字体裁クラス](#typography_class)します。  
+  
+<a name="variants"></a>   
+## <a name="variants"></a>バリアント  
+ バリアントを使用して、上付き文字と下付きなどのさまざまなタイポグラフィ スタイルを表示します。  
+  
+### <a name="superscripts-and-subscripts"></a>上付き/下付きの文字  
+ <xref:System.Windows.Documents.Typography.Variants%2A>プロパティでは、上付き文字と下付き文字の値を設定することができます、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォント。  
+  
+ 次のテキストは、Palatino Linotype フォントの上付き文字を表示します。  
+  
+ ![OpenType の上付き文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont14.png "opentypefont14")  
+OpenType の上付き文字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Palatino Linotype フォントの上付き文字を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#12)]  
+  
+ 次のテキストには、Palatino Linotype フォントの添字が表示されます。  
+  
+ ![OpenType の下付き文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont15.png "opentypefont15")  
+OpenType の下付き文字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Palatino Linotype フォントの添字を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#13)]  
+  
+### <a name="decorative-uses-of-superscripts-and-subscripts"></a>上付き文字と下付き文字の装飾的な用途には  
+ 混在したテキストの装飾的な効果を作成するのに、上付き文字と下付きを使用することもできます。 次のテキストは、Palatino Linotype フォントの上付き文字と下付き文字のテキストを表示します。 大文字の影響がないことに注意してください。  
+  
+ ![OpenType の上付き文字と下付き文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont16.png "opentypefont16")  
+OpenType の上付き文字と下付き文字を使用するテキスト  
+  
+ 次のマークアップの例は、上付き文字と下付きのプロパティを使用するフォントを定義する方法を示します、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#14)]  
+  
+<a name="capitals"></a>   
+## <a name="capitals"></a>大文字  
+ 大文字に変換は、大文字のスタイルのグリフのテキストをレンダリングする文字体裁のフォームのセットです。 通常、テキストがすべて大文字で表示されると、文字間隔が表示されますあまりにも堅く太さと決して大きな文字の比率。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]小文字に変換する小型英大文字を含め、超小型英大文字、タイトル、および大文字スペーシングのさまざまなスタイルの形式をサポートしています。 これらのスタイル形式を使用して、英大文字の外観を制御できます。  
+  
+ 次のテキストには、「小型英大文字」と"AllSmallCaps"スタイルを指定の文字の後に、Pescadero フォントの標準の大文字が表示されます。 この場合は、同じフォント サイズは、次の&3; つすべての単語です。  
+  
+ ![OpenType の大文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont11.png "opentypefont11")  
+OpenType の大文字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pescadero フォントの大文字に変換を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。 「小型英大文字」形式を使用する場合は、先頭の大文字は無視されます。  
+  
+ [!code-xml[OpenTypeFontSamples#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#9)]  
+  
+### <a name="titling-capitals"></a>タイトル用大文字  
+ タイトル用大文字は、重みと縦横比に明るくおよび通常の大文字より洗練された外観を指定する設計です。 通常、タイトル用大文字は見出しとして大きなフォント サイズで使用されます。 次のテキストを表示 Pescadero フォントの標準およびタイトル用大文字に変換します。 2 番目の行のテキストの幅の狭い縦線の幅を確認します。  
+  
+ ![OpenType のタイトル大文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont20.png "OpenTypeFont20")  
+OpenType のタイトル大文字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pescadero フォントのタイトル用大文字を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet17](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#opentypefontsnippet17)]  
+  
+### <a name="capital-spacing"></a>大文字スペーシング  
+ 大文字間隔は、テキストをすべて大文字を使用する場合は、間隔を設けることができるようにする機能です。 通常、英大文字は小文字とブレンドする設計されます。 間で魅力的な間隔を表示し、大文字と小文字をあまりにも堅く見えますすべて大文字を使用するとします。 次のテキストには、Pescadero フォントの標準と資本の間隔が表示されます。  
+  
+ ![OpenType の大文字スペーシングを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont21.png "OpenTypeFont21")  
+OpenType の大文字スペーシングを使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pescadero フォントの大文字スペーシングを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet18](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#opentypefontsnippet18)]  
+  
+<a name="ligatures"></a>   
+## <a name="ligatures"></a>合字  
+ 合字とは、1 つのグリフを形成し、読み取り可能または魅力的なテキストを作成するために&2; つまたは複数の字形です。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、合字の&4; つの種類をサポートします。  
+  
+-   **標準合字**します。 読みやすさを高めるよう設計。 標準合字には、"fi"、"fl"および"ff"が含まれます。  
+  
+-   **コンテキスト合字**します。 合字を構成する文字の間の結合の動作を提供することによって、読みやすさを高めるよう設計。  
+  
+-   **随意合字**します。 装飾、読みやすくするために設計されたされるようにするために設計されています。  
+  
+-   **歴史的合字**します。 履歴、読みやすくするために設計されたされるようにするために設計されています。  
+  
+ 次のテキストには、Pericles フォントの標準合字のグリフが表示されます。  
+  
+ ![OpenType の標準合字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont04.png "opentypefont04")  
+OpenType の標準合字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pericles フォントの標準合字のグリフを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#4)]  
+  
+ 次のテキストには、Pericles フォントの随意合字のグリフが表示されます。  
+  
+ ![OpenType の随意合字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont05.png "opentypefont05")  
+OpenType の随意合字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pericles フォントの随意合字のグリフを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#5)]  
+  
+ 既定では、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]で複数のフォント[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]標準合字を有効にします。 たとえば、Palatino Linotype フォントを使用する場合の標準合字"fi"、"ff"および"fl"として表示されます、組み合わせ文字のグリフ。 各標準合字の文字のペアが互いに接触することに注意してください。  
+  
+ ![OpenType の標準合字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont06.png "opentypefont06")  
+OpenType の標準合字を使用するテキスト  
+  
+ ただし、"ff"などの標準合字は、結合された文字のグリフではなくとして&2; つの別個のグリフが表示されるように、標準合字機能が無効にできます。  
+  
+ ![OpenType の標準合字のテキストを使用して無効になっています](../../../../docs/framework/wpf/advanced/media/opentypefont07.png "opentypefont07")  
+OpenType の無効な標準合字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Palatino Linotype フォントの標準合字のグリフを無効にする方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#6)]  
+  
+<a name="swashes"></a>   
+## <a name="swashes"></a>巻き髭  
+ 巻き髭は、多くの場合、カリグラフィに関連付けられている手の込んだ装飾を使用して装飾的なグリフです。 次のテキストには、標準グリフと飾り付きグリフ Pescadero フォントが表示されます。  
+  
+ ![OpenType の標準と飾り付きグリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont08.png "opentypefont08")  
+OpenType の標準グリフと飾り付きグリフを使用するテキスト  
+  
+ 巻き髭は、イベントのお知らせなどの短い語句で装飾的な要素としてよく使用されます。 次のテキストでは、巻き髭を使用して、イベントの名前の大文字を強調します。  
+  
+ ![OpenType の巻き髭を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont09.png "opentypefont09")  
+OpenType の巻き髭を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、フォントの巻き髭を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#7)]  
+  
+### <a name="contextual-swashes"></a>コンテキスト巻き髭  
+ スワッシュ グリフの特定の組み合わせには、隣接する文字の重なり合ったディセンダーなどの魅力的ではありません外観可能性があります。 コンテキスト飾り付きを使用するには、優れた外観を生成する代替飾り付きグリフを使用することができます。 次のテキストは前に、とコンテキストの飾り付きの適用後に、同じ単語を示します。  
+  
+ ![OpenType のコンテキスト巻き髭を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont19.png "OpenTypeFont19")  
+OpenType のコンテキスト巻き髭を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pescadero フォントのコンテキストの飾り付きを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#opentypefontsnippet16)]  
+  
+<a name="alternates"></a>   
+## <a name="alternates"></a>代替  
+ 代替文字は、標準的なグリフの代わりに使用できますです。 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]次の例で使用される Pericles フォントなどのフォントは、異なる外観のテキストを作成に使用できる代替グリフを含めることができます。 次のテキストには、Pericles フォントの標準グリフが表示されます。  
+  
+ ![OpenType の標準グリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont01.png "opentypefont01")  
+OpenType の標準グリフを使用するテキスト  
+  
+ Pericles[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、一連の標準グリフをデザインのバリエーションを提供する追加のグリフを格納します。 次のテキストのスタイル代替グリフを表示します。  
+  
+ ![OpenType のスタイル代替グリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont02.png "opentypefont02")  
+OpenType のスタイル代替グリフを使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pericles フォントのスタイル代替グリフを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#2)]  
+  
+ 次のテキストには、いくつか他のスタイル代替グリフの Pericles フォントが表示されます。  
+  
+ ![OpenType のスタイル代替グリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont03.png "opentypefont03")  
+OpenType のスタイル代替グリフを使用するテキスト  
+  
+ 次のマークアップの例では、これら他のスタイル代替グリフを定義する方法を示します。  
+  
+ [!code-xml[OpenTypeFontSamples#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#3)]  
+  
+### <a name="random-contextual-alternates"></a>ランダムなコンテキスト代替  
+ ランダムなコンテキスト代替は、単一の文字の複数の代替グリフを提供します。 スクリプトの種類のフォントで実装された場合、この機能は、ランダムに選択したグリフの外観にわずかな相違点のセットを使用して、手書きをシミュレートできます。 次のテキストは、ランダムなコンテキスト代替を Lindsey フォントを使用します。 注意して、文字"a"がわずかに異なって表示  
+  
+ ![OpenType のランダムなコンテキスト代替を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont23.png "OpenTypeFont23")  
+OpenType のランダムなコンテキスト代替を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Lindsey フォントのランダムなコンテキスト代替を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/Window1.xaml#opentypefontsnippet20)]  
+  
+### <a name="historical-forms"></a>履歴フォーム  
+ 歴史的形式は、過去に一般的であった表記規則です。 次のテキストには、「ボストン, マサチューセッツ州」という語句が表示されます。 Palatino Linotype フォントのグリフの履歴フォームを使用します。  
+  
+ ![OpenType の履歴フォームを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont10.png "opentypefont10")  
+OpenType の履歴フォームを使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Palatino Linotype フォントの履歴フォームを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#8)]  
+  
+<a name="numerical_styles"></a>   
+## <a name="numerical-styles"></a>数値のスタイル  
+ OpenType フォントでは、大量のテキスト内の数値で使用できる機能をサポートします。  
+  
+### <a name="fractions"></a>1 秒未満部分  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、小数、スラッシュや積み上げなどのスタイルをサポートします。  
+  
+ 次のテキストは、分数 Palatino Linotype フォントのスタイルを表示します。  
+  
+ ![OpenType を使用するテキストの削減し、分数を上下に並べて](../../../../docs/framework/wpf/advanced/media/opentypefont12.png "opentypefont12")  
+OpenType の分数 (横) と分数 (縦) を使用するテキスト  
+  
+ 次のマークアップの例は、分数スタイルのプロパティを使用して、Palatino Linotype フォントを定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#10)]  
+  
+### <a name="old-style-numerals"></a>古いスタイルの数字  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、古いスタイルの数字形式をサポートします。 この形式は、標準になっているスタイルの数字を表示するのに便利です。 次のテキストは、Palatino Linotype フォントの標準および古いスタイルの数字形式で 18 世紀日付を表示します。  
+  
+ ![OpenType の古いスタイルの数字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont24.png "OpenTypeFont24")  
+OpenType の古いスタイルの数字を使用するテキスト  
+  
+ 次のテキストには、古いスタイルの数字に続いて、Palatino Linotype フォントの標準の数字が表示されます。  
+  
+ ![OpenType 古いスタイルの数字セットを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont13.png "opentypefont13")  
+OpenType の古いスタイルの数字セットを使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Palatino Linotype フォントの古いスタイルの数字を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#11)]  
+  
+### <a name="proportional-and-tabular-figures"></a>比例と表形式の数値  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、数字を使用するときに、幅の調整を制御するプロポーショナルおよび表形式の図の機能をサポートします。 プロポーショナル数字では、各数字を扱うさまざまな幅を持つものとして、「1」の「5」で使われています。 表形式の図は、位置が揃う縦方向に財務型情報を読みやすくできるように、等幅の数字として扱われます。  
+  
+ 次のテキストは、Miramonte フォントを使用して最初の列に&2; つのプロポーショナル数字を表示します。 「5」と「1」数字の幅の違いに注意してください。 2 番目の列では、表形式の図の機能を使用して調整幅と同じ&2; つの数値が表示されます。  
+  
+ ![OpenType の比例 >/documents/report1.rdl」の表形式の数字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont22.png "OpenTypeFont22")  
+OpenType のプロポーショナルおよび表形式の数字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Miramonte フォントでのプロポーショナルおよび表形式の数値を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/Window1.xaml#opentypefontsnippet19)]  
+  
+### <a name="slashed-zero"></a>スラッシュ ゼロ  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントは、サポート、スラッシュ文字"O"と数字の「0」の違いを強調するために、ゼロの数字形式。 スラッシュ ゼロ、財務およびビジネス情報の識別子によく使用されます。  
+  
+ 次のテキストは、Miramonte フォントを使用してサンプル発注 id を表示します。 最初の行では、標準の数字を使用します。 使用する&2; 番目の線はスラッシュ ゼロ コントラストを提供する優れた大文字の"O"とします。  
+  
+ ![0 個のスラッシュを付きの OpenType を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont17.png "OpenTypeFont17")  
+OpenType のスラッシュ付きのゼロを使用するテキスト  
+  
+ 次のマークアップの例を定義する方法を示しています。 スラッシュ付きのゼロのプロパティを使用して、Miramonte フォント、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+ [!code-xml[OpenTypeFontSamples#OpenTypeFontSnippet15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#opentypefontsnippet15)]  
+  
+<a name="typography_class"></a>   
+## <a name="typography-class"></a>文字体裁クラス  
+ <xref:System.Windows.Documents.Typography>オブジェクトは、一連の機能を公開する、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]フォントをサポートしています。 プロパティを設定して<xref:System.Windows.Documents.Typography>マークアップでは、活用するためのドキュメントを作成することができます簡単に[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)]機能します。  
+  
+ 次のテキストには、「小型英大文字」と"AllSmallCaps"スタイルを指定の文字の後に、Pescadero フォントの標準の大文字が表示されます。 この場合は、同じフォント サイズは、次の&3; つすべての単語です。  
+  
+ ![OpenType の大文字を使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont11.png "opentypefont11")  
+OpenType の大文字を使用するテキスト  
+  
+ 次のマークアップの例のプロパティを使用して、Pescadero フォントの大文字に変換を定義する方法を示しています、<xref:System.Windows.Documents.Typography>オブジェクトです。 「小型英大文字」形式を使用する場合は、先頭の大文字は無視されます。  
+  
+ [!code-xml[OpenTypeFontSamples#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontSamples/CS/PageOne.xaml#9)]  
+  
+ 次のコード例では、前のマークアップの例と同じタスクを実行します。  
+  
+ [!code-csharp[TypographyCodeSnippets#TypographyCodeSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TypographyCodeSnippets/CSharp/Page1.xaml.cs#typographycodesnippet1)]
+ [!code-vb[TypographyCodeSnippets#TypographyCodeSnippet1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TypographyCodeSnippets/visualbasic/page1.xaml.vb#typographycodesnippet1)]  
+  
+### <a name="typography-class-properties"></a>文字体裁クラスのプロパティ  
+ 次の表は、プロパティ、値、および既定の設定、<xref:System.Windows.Documents.Typography>オブジェクトです。  
+  
+|プロパティ|[値]|既定値|  
+|--------------|----------------|-------------------|  
+|<xref:System.Windows.Documents.Typography.AnnotationAlternates%2A>|数値 - バイト|0|  
+|<xref:System.Windows.Documents.Typography.Capitals%2A>|<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals> |<xref:System.Windows.FontCapitals>|<xref:System.Windows.FontCapitals?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.CapitalSpacing%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.CaseSensitiveForms%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.ContextualAlternates%2A>|<xref:System.Boolean>|`true`|  
+|<xref:System.Windows.Documents.Typography.ContextualLigatures%2A>|<xref:System.Boolean>|`true`|  
+|<xref:System.Windows.Documents.Typography.ContextualSwashes%2A>|数値 - バイト|0|  
+|<xref:System.Windows.Documents.Typography.DiscretionaryLigatures%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.EastAsianExpertForms%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.EastAsianLanguage%2A>|<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage> |<xref:System.Windows.FontEastAsianLanguage>|<xref:System.Windows.FontEastAsianLanguage>|<xref:System.Windows.FontEastAsianLanguage>|<xref:System.Windows.FontEastAsianLanguage?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.EastAsianWidths%2A>|<xref:System.Windows.FontEastAsianWidths> |<xref:System.Windows.FontEastAsianWidths> |<xref:System.Windows.FontEastAsianWidths> |<xref:System.Windows.FontEastAsianWidths>|<xref:System.Windows.FontEastAsianWidths> |<xref:System.Windows.FontEastAsianWidths>|<xref:System.Windows.FontEastAsianWidths?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.Fraction%2A>|<xref:System.Windows.FontFraction>|<xref:System.Windows.FontFraction> |<xref:System.Windows.FontFraction>|<xref:System.Windows.FontFraction?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.HistoricalForms%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.HistoricalLigatures%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.Kerning%2A>|<xref:System.Boolean>|`true`|  
+|<xref:System.Windows.Documents.Typography.MathematicalGreek%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.NumeralAlignment%2A>|<xref:System.Windows.FontNumeralAlignment>|<xref:System.Windows.FontNumeralAlignment>|<xref:System.Windows.FontNumeralAlignment>|<xref:System.Windows.FontNumeralAlignment?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.NumeralStyle%2A>|<xref:System.Boolean>|<xref:System.Windows.FontNumeralStyle?displayProperty=fullName>|  
+|<xref:System.Windows.Documents.Typography.SlashedZero%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StandardLigatures%2A>|<xref:System.Boolean>|`true`|  
+|<xref:System.Windows.Documents.Typography.StandardSwashes%2A>|数値-バイト|0|  
+|<xref:System.Windows.Documents.Typography.StylisticAlternates%2A>|数値-バイト|0|  
+|<xref:System.Windows.Documents.Typography.StylisticSet1%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet2%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet3%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet4%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet5%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet6%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet7%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet8%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet9%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet10%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet11%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet12%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet13%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet14%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet15%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet16%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet17%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet18%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet19%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.StylisticSet20%2A>|<xref:System.Boolean>|`false`|  
+|<xref:System.Windows.Documents.Typography.Variants%2A>|<xref:System.Windows.FontVariants>|<xref:System.Windows.FontVariants> |<xref:System.Windows.FontVariants> |<xref:System.Windows.FontVariants> |<xref:System.Windows.FontVariants> |<xref:System.Windows.FontVariants>|<xref:System.Windows.FontVariants?displayProperty=fullName>|  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Documents.Typography>   
+ [OpenType の仕様](http://go.microsoft.com/fwlink/?LinkId=96731)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [OpenType フォント パックのサンプル](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)   
+ [アプリケーションでフォントのパッケージング](../../../../docs/framework/wpf/advanced/packaging-fonts-with-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md b/docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md
new file mode 100644
index 00000000000..9bc8b8e299e
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md
@@ -0,0 +1,117 @@
+---
+title: "パフォーマンスの最適化 : 2D グラフィックスとイメージング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "2-D グラフィックス"
+  - "描画, 最適化 (パフォーマンスの)"
+  - "グラフィックス, パフォーマンス"
+  - "イメージ, 最適化 (パフォーマンスの)"
+  - "イメージング, 最適化 (パフォーマンスの)"
+  - "形状, 最適化 (パフォーマンスの)"
+ms.assetid: e335601e-28c8-4d64-ba27-778fffd55f72
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# パフォーマンスの最適化 : 2D グラフィックスとイメージング
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、アプリケーションの要件に合わせて最適化できる広範な 2D グラフィックス機能とイメージング機能が用意されています。  このトピックでは、この領域でのパフォーマンスの最適化に関する情報を提供します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Drawing_and_Shapes"></a>   
+## 描画と図形  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、グラフィカルな描画コンテンツを表現するために <xref:System.Windows.Media.Drawing> と <xref:System.Windows.Shapes.Shape> の両方のオブジェクトが用意されています。  ただし、<xref:System.Windows.Media.Drawing> オブジェクトの方が <xref:System.Windows.Shapes.Shape> オブジェクトより単純で、パフォーマンス特性に優れています。  
+  
+ <xref:System.Windows.Shapes.Shape> を使用すると、画面にグラフィカルな図形を描画できます。  <xref:System.Windows.Shapes.Shape> オブジェクトは、<xref:System.Windows.FrameworkElement> クラスから派生するため、パネルおよびほとんどのコントロール内で使用できます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、グラフィックス サービスやレンダリング サービスへのアクセスのレイヤーがいくつか用意されています。  <xref:System.Windows.Shapes.Shape> オブジェクトは最上位レイヤーで使いやすく、レイアウトやイベント処理などの便利な機能を多数提供します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、すぐに使用できるさまざまな図形オブジェクトが用意されています。  すべての図形オブジェクトは <xref:System.Windows.Shapes.Shape> クラスから継承されます。  使用可能な図形オブジェクトには、<xref:System.Windows.Shapes.Ellipse>、<xref:System.Windows.Shapes.Line>、<xref:System.Windows.Shapes.Path>、<xref:System.Windows.Shapes.Polygon>、<xref:System.Windows.Shapes.Polyline>、<xref:System.Windows.Shapes.Rectangle> などがあります。  
+  
+ 一方、<xref:System.Windows.Media.Drawing> オブジェクトは <xref:System.Windows.FrameworkElement> クラスから派生していません。<xref:System.Windows.Media.Drawing> オブジェクトは、図形、イメージ、およびテキストを描画するためのより軽量な実装を提供します。  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトには次の 4 つの種類があります。  
+  
+-   <xref:System.Windows.Media.GeometryDrawing> – 図形を描画します。  
+  
+-   <xref:System.Windows.Media.ImageDrawing> – イメージを描画します。  
+  
+-   <xref:System.Windows.Media.GlyphRunDrawing> – テキストを描画します。  
+  
+-   <xref:System.Windows.Media.DrawingGroup> – その他の描画を描画します。  他の描画を 1 つの複合描画に結合するには、描画グループを使用します。  
+  
+ <xref:System.Windows.Media.GeometryDrawing> オブジェクトは、ジオメトリ コンテンツを描画するために使用されます。  <xref:System.Windows.Media.Geometry> クラスと、そこから派生する具象クラス \(<xref:System.Windows.Media.CombinedGeometry>、<xref:System.Windows.Media.EllipseGeometry>、<xref:System.Windows.Media.PathGeometry> など\) は、2D グラフィックスを描画するための手段を提供します。ヒット テストやクリッピングもサポートされています。  ジオメトリ オブジェクトを使用すると、たとえば、コントロールの領域を定義したり、イメージに適用するクリップ領域を定義したりすることができます。  ジオメトリ オブジェクトは、四角形や円などの単純な領域にすることも、2 つ以上のジオメトリ オブジェクトから作成された複合的な領域にすることもできます。  さらに複雑な幾何学領域を作成するには、<xref:System.Windows.Media.ArcSegment>、<xref:System.Windows.Media.BezierSegment>、<xref:System.Windows.Media.QuadraticBezierSegment> などの <xref:System.Windows.Media.PathSegment> 派生オブジェクトの組み合わせを使用します。  
+  
+ 表面的には、<xref:System.Windows.Media.Geometry> クラスと <xref:System.Windows.Shapes.Shape> クラスはよく似ています。  いずれのクラスも 2D グラフィックスの描画に使用され、それぞれのクラスから派生する具象クラスも似ています \(<xref:System.Windows.Media.EllipseGeometry> と <xref:System.Windows.Shapes.Ellipse> など\)。  ただし、この 2 つのクラスのセットの間には重要な違いがいくつかあります。  その 1 つとして、<xref:System.Windows.Media.Geometry> クラスには、<xref:System.Windows.Shapes.Shape> クラスの一部の機能 \(図形そのものを描画する機能など\) がありません。  ジオメトリ オブジェクトを描画するには、DrawingContext、Drawing、Path \(Path が Shape であることは注目に値します\) などの別のクラスを使用して描画操作を実行する必要があります。  塗りつぶし、ストローク、ストロークの太さなどの描画プロパティは、ジオメトリ オブジェクトを描画するクラスにあります。一方、図形オブジェクトにはこれらのプロパティが含まれています。  この違いは、ジオメトリ オブジェクトが円などの領域を定義するのに対し、図形オブジェクトは領域を定義し、領域の塗りつぶしやアウトラインを定義し、レイアウト システムに参加する、と考えることができます。  
+  
+ <xref:System.Windows.Shapes.Shape> オブジェクトは <xref:System.Windows.FrameworkElement> クラスから派生するため、<xref:System.Windows.Shapes.Shape> オブジェクトを使用するとアプリケーションのメモリ消費が大幅に増加する可能性があります。  使用するグラフィカル コンテンツで <xref:System.Windows.FrameworkElement> の機能がまったく必要ない場合は、より軽量な <xref:System.Windows.Media.Drawing> オブジェクトを使用することを検討してください。  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+<a name="StreamGeometry_Objects"></a>   
+## StreamGeometry オブジェクト  
+ <xref:System.Windows.Media.StreamGeometry> オブジェクトは、幾何学図形を作成するための <xref:System.Windows.Media.PathGeometry> の代替となる軽量なものです。  <xref:System.Windows.Media.StreamGeometry> は、複雑なジオメトリを作成する必要がある場合に使用します。  <xref:System.Windows.Media.StreamGeometry> は、多数の <xref:System.Windows.Media.PathGeometry> オブジェクトを処理することを想定して最適化されているため、多数の <xref:System.Windows.Media.PathGeometry> オブジェクトを個別に使用する場合に比べてパフォーマンスが向上します。  
+  
+ 次の例では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で属性構文を使用して三角形の <xref:System.Windows.Media.StreamGeometry> を作成します。  
+  
+ [!code-xml[GeometriesMiscSnippets_snip#StreamGeometryTriangleExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GeometriesMiscSnippets_snip/XAML/StreamGeometryExample.xaml#streamgeometrytriangleexamplewholepage)]  
+  
+ <xref:System.Windows.Media.StreamGeometry> オブジェクトの詳細については、「[StreamGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md)」を参照してください。  
+  
+<a name="DrawingVisual_Objects"></a>   
+## DrawingVisual オブジェクト  
+ <xref:System.Windows.Media.DrawingVisual> オブジェクトは、図形、イメージ、またはテキストの描画に使用する軽量の描画クラスです。  このクラスが軽量と見なされる理由は、レイアウトやイベントの処理を行わないため、パフォーマンスが向上するからです。  このため、背景やクリップ アートの描画に適しています。  詳細については、「[DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)」を参照してください。  
+  
+<a name="Images"></a>   
+## \[イメージ\]  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のイメージング機能は、以前のバージョンの [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] のイメージング機能から大幅に強化されています。  イメージング機能 \(ビットマップの表示や一般的なコントロール上でのイメージの使用など\) は、以前は主に Microsoft Windows Graphics Device Interface \(GDI\) または Microsoft Windows GDI\+ のアプリケーション プログラミング インターフェイス \(API\) によって処理されていました。  これらの API では、基本的なイメージング機能は提供されていましたが、コーデック拡張機能のサポートや忠実性の高いイメージのサポートなどの機能は含まれていませんでした。  WPF Imaging API は、GDI および GDI\+ の欠点を克服し、アプリケーション内でイメージを表示および使用するための新しい API のセットを提供するために再設計されています。  
+  
+ イメージを使用する際には、パフォーマンスを向上させるために以下の推奨事項を考慮してください。  
+  
+-   アプリケーションでサムネイル イメージを表示する必要がある場合は、縮小版のイメージを作成することを検討してください。  既定では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は読み込んだイメージを本来のサイズにデコードします。  サムネイル バージョンのイメージのみが必要な場合は、イメージを本来のサイズにデコードしてからサムネイル サイズに縮小するという無駄が生じます。  この不要なオーバーヘッドを回避するには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に対して、イメージをサムネイル サイズにデコードするように要求するか、サムネイル サイズのイメージを読み込むように要求します。  
+  
+-   イメージは常に、既定のサイズではなく必要なサイズにデコードするようにしてください。  上で説明したように、既定の実際のサイズではなく必要なサイズにイメージをデコードするように [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に要求します。  これにより、アプリケーションの作業セットを縮小できるだけでなく、実行速度も向上します。  
+  
+-   可能であれば、複数のイメージを 1 つに結合します \(複数のイメージから成るフィルム ストリップなど\)。  
+  
+-   詳細については、「[イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)」を参照してください。  
+  
+### BitmapScalingMode  
+ ビットマップのスケーリングをアニメーション化する場合、既定の高品質イメージの再サンプリング アルゴリズムは、フレーム レートを低下させるほどシステム リソースを消費する場合があり、実際にはアニメーションの動きが滑らかでなくなることがあります。  <xref:System.Windows.Media.RenderOptions> オブジェクトの <xref:System.Windows.Media.RenderOptions.BitmapScalingMode%2A> プロパティを <xref:System.Windows.Media.BitmapScalingMode> に設定することにより、ビットマップをスケーリングするときに、より滑らかなアニメーションを作成できます。  <xref:System.Windows.Media.BitmapScalingMode> モードは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のレンダリング エンジンに対して、イメージを処理するときに品質重視のアルゴリズムから速度重視のアルゴリズムに切り替えるように指示します。  
+  
+ イメージ オブジェクトの <xref:System.Windows.Media.BitmapScalingMode> を設定する方法を次の例に示します。  
+  
+ [!code-csharp[RenderOptions#RenderOptionsSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RenderOptions/CSharp/Window1.xaml.cs#renderoptionssnippet2)]
+ [!code-vb[RenderOptions#RenderOptionsSnippet2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RenderOptions/visualbasic/window1.xaml.vb#renderoptionssnippet2)]  
+  
+### CachingHint  
+ 既定では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Windows.Media.TileBrush> オブジェクト \(<xref:System.Windows.Media.DrawingBrush> や <xref:System.Windows.Media.VisualBrush> など\) の描画された内容をキャッシュしません。  シーンで <xref:System.Windows.Media.TileBrush> の内容も使用状況も変化することのない静的なシナリオでは、ビデオ メモリが節約されるため、この動作には意味があります。  静的な内容の <xref:System.Windows.Media.TileBrush> を静的でない方法で使用する場合には、あまり意味はありません。たとえば、静的な <xref:System.Windows.Media.DrawingBrush> や <xref:System.Windows.Media.VisualBrush> が回転する 3D オブジェクトのサーフェイスにマップされている場合などです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既定の動作では、内容が変化しない場合でも、<xref:System.Windows.Media.DrawingBrush> または <xref:System.Windows.Media.VisualBrush> のすべてのフレームの内容全体が再描画されます。  
+  
+ <xref:System.Windows.Media.RenderOptions> オブジェクトの <xref:System.Windows.Media.RenderOptions.CachingHint%2A> プロパティを <xref:System.Windows.Media.CachingHint> に設定すると、並べて表示されたブラシ オブジェクトのキャッシュ バージョンを使用してパフォーマンスを向上させることができます。  
+  
+ <xref:System.Windows.Media.RenderOptions.CacheInvalidationThresholdMinimum%2A> および <xref:System.Windows.Media.RenderOptions.CacheInvalidationThresholdMaximum%2A> の各プロパティ値は、スケールの変化に伴って <xref:System.Windows.Media.TileBrush> オブジェクトをいつ再生成する必要があるかを決定する相対的なサイズ値です。  たとえば、<xref:System.Windows.Media.RenderOptions.CacheInvalidationThresholdMaximum%2A> プロパティを 2.0 に設定すると、<xref:System.Windows.Media.TileBrush> のキャッシュ サイズが現在のキャッシュ サイズの倍を超えた場合にだけ、キャッシュを再生成すれば済みます。  
+  
+ <xref:System.Windows.Media.DrawingBrush> のキャッシュ ヒント オプションの使用方法を次の例に示します。  
+  
+ [!code-csharp[RenderOptions#RenderOptionsSnippet3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RenderOptions/CSharp/Window1.xaml.cs#renderoptionssnippet3)]
+ [!code-vb[RenderOptions#RenderOptionsSnippet3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RenderOptions/visualbasic/window1.xaml.vb#renderoptionssnippet3)]  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)   
+ [アニメーションのヒントとテクニック](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-application-resources.md b/docs/framework/wpf/advanced/optimizing-performance-application-resources.md
new file mode 100644
index 00000000000..92a1027f2b0
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-application-resources.md
@@ -0,0 +1,61 @@
+---
+title: "パフォーマンスの最適化 : アプリケーション リソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション リソース, パフォーマンス"
+  - "ブラシ, パフォーマンス"
+  - "リソース, パフォーマンス"
+  - "共有 (コピーせずにブラシを)"
+  - "共有 (リソースを)"
+  - "静的リソース"
+ms.assetid: 62b88488-c08e-4804-b7de-a1c34fbe929c
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# パフォーマンスの最適化 : アプリケーション リソース
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、アプリケーション リソースを共有して、同じような種類の要素の間で外観や動作の一貫性を維持することができます。  このトピックでは、アプリケーションのパフォーマンス向上に役立つリソース関連の推奨事項について説明します。  
+  
+ リソースの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+## リソースの共有  
+ アプリケーションでカスタム コントロールを使用していて、<xref:System.Windows.ResourceDictionary> \(または XAML Resources ノード\) でリソースを定義している場合は、<xref:System.Windows.Application> オブジェクトまたは <xref:System.Windows.Window> オブジェクトのレベルで定義するか、カスタム コントロールの既定のテーマで定義することをお勧めします。  カスタム コントロールの <xref:System.Windows.ResourceDictionary> でリソースを定義すると、そのコントロールのすべてのインスタンスにパフォーマンスの影響が及びます。  たとえば、負荷の高いブラシ操作がカスタム コントロールとその多くのインスタンスのリソース定義の一部として定義されていると、アプリケーションの作業セットが大幅に増大します。  
+  
+ これを実際の例で考えてみましょう。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用してトランプ ゲームを開発するとします。  ほとんどのトランプ ゲームでは、それぞれ異なる面を持つ 52 枚のカードが必要です。  そのためにカード カスタム コントロールを実装することにして、そのリソースで 52 のブラシを定義します \(各ブラシはそれぞれカードの面を表します\)。  メイン アプリケーションでは、最初にこのカード カスタム コントロールの 52 のインスタンスを作成します。  カード カスタム コントロールの各インスタンスでは、それぞれ <xref:System.Windows.Media.Brush> オブジェクトの 52 のインスタンスが生成されます。その結果、全部で 52 × 52 の <xref:System.Windows.Media.Brush> オブジェクトがアプリケーションに存在することになります。  ブラシをカード カスタム コントロールのリソースから <xref:System.Windows.Application> オブジェクトまたは <xref:System.Windows.Window> オブジェクトのレベルに移動するか、カスタム コントロールの既定のテーマで定義すると、カード コントロールの 52 のインスタンスの間で 52 のブラシが共有されるようになるため、アプリケーションの作業セットが縮小されます。  
+  
+## ブラシはコピーせずに共有する  
+ 同じ <xref:System.Windows.Media.Brush> オブジェクトを使用する複数の要素がある場合は、ブラシを [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] でインラインで定義するのではなく、リソースとして定義して参照するようにします。  この方法を使用すると、1 つのインスタンスを作成してそれを再利用することができます。一方、ブラシを [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] でインラインで定義した場合は、各要素に対して新しいインスタンスが作成されます。  
+  
+ この例を次のマークアップ サンプルに示します。  
+  
+ [!code-xml[Performance#PerformanceSnippet7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/BrushResource.xaml#performancesnippet7)]  
+  
+## 可能な限り静的リソースを使用する  
+ 静的リソースは、既に定義されたリソースに対する参照を検索することによって、任意の XAML プロパティ属性の値を指定します。  そのリソースに関する検索動作は、コンパイル時の検索に似ています。  
+  
+ 一方、動的リソースは、初期コンパイル中に一時的な式を作成し、それによって、要求されたリソース値がオブジェクトを構成するために実際に必要になるまで、リソースに関する検索を遅延します。  そのリソースに関する検索動作は、実行時検索に似ています。これはパフォーマンスに影響します。  アプリケーションでは可能な限り静的リソースを使用し、動的リソースを使用するのは必要な場合だけにしてください。  
+  
+ 次のマークアップ サンプルでは、この両方の種類のリソースが使用されています。  
+  
+ [!code-xml[Performance#PerformanceSnippet8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/DynamicResource.xaml#performancesnippet8)]  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-controls.md b/docs/framework/wpf/advanced/optimizing-performance-controls.md
new file mode 100644
index 00000000000..3bfc28a6ea0
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-controls.md
@@ -0,0 +1,91 @@
+---
+title: "パフォーマンスの最適化 : コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテナーのリサイクル"
+  - "コントロール [WPF], 向上 (パフォーマンスを)"
+  - "ユーザー インターフェイスの仮想化"
+ms.assetid: 45a31c43-ea8a-4546-96c8-0631b9934179
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# パフォーマンスの最適化 : コントロール
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、大半の Windows アプリケーションで使用される一般的なユーザー インターフェイス \(UI: User Interface\) コンポーネントが多数含まれています。  このトピックでは、UI のパフォーマンスを向上させる方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Displaying"></a>   
+## 大容量のデータ セットの表示  
+ アプリケーションで項目リストを表示するには、<xref:System.Windows.Controls.ListView> や <xref:System.Windows.Controls.ComboBox> などの WPF コントロールが使用されます。  表示するリストが大きい場合、アプリケーションのパフォーマンスに影響する可能性があります。  これは、標準的なレイアウト システムでは、リスト コントロールに関連付けられた項目ごとにレイアウト コンテナーを作成した後、コンテナーのレイアウト サイズと位置を計算するためです。  通常、すべての項目を同時に表示する必要はありません。その代わりに項目のサブセットが表示され、ユーザーはリストをスクロールすることで、すべての項目を確認します。  このような場合は、UI の*仮想化*が役に立ちます。これは、項目に対する項目コンテナーの生成と関連するレイアウトの計算を、項目が表示されるまで遅らせることを意味します。  
+  
+ UI の仮想化は、リスト コントロールにとって重要な処理です。  UI の仮想化とデータの仮想化を混同しないでください。  UI の仮想化では、表示される項目だけをメモリに格納しますが、データのバインディングがある場合はデータ構造体のすべてがメモリに格納されます。  これに対し、データの仮想化では、画面上に表示されているデータ項目だけがメモリに格納されます。  
+  
+ 既定では、UI の仮想化は、<xref:System.Windows.Controls.ListView> コントロールと <xref:System.Windows.Controls.ListBox> コントロールで、それぞれのリスト項目がデータにバインドされる場合は有効になっています。  <xref:System.Windows.Controls.TreeView> の仮想化は、<xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A?displayProperty=fullName> 添付プロパティを `true` に設定することで有効にできます。  <xref:System.Windows.Controls.ItemsControl> から派生するカスタム コントロール、または <xref:System.Windows.Controls.StackPanel> クラスを使用する既存のコントロール \(<xref:System.Windows.Controls.ComboBox> など\) で UI の仮想化を有効にする場合は、<xref:System.Windows.Controls.ItemsControl.ItemsPanel%2A> を <xref:System.Windows.Controls.VirtualizingStackPanel> に設定し、<xref:System.Windows.Controls.VirtualizingPanel.IsVirtualizing%2A> を`true` に設定します。  ただし、これらのコントロールに対する UI の仮想化は、仮想化を実現せずに無効にできます。  UI の仮想化を無効にする条件を一覧で示します。  
+  
+-   項目コンテナーが <xref:System.Windows.Controls.ItemsControl> に直接的に追加される。  たとえば、アプリケーションで <xref:System.Windows.Controls.ListBoxItem> オブジェクトが <xref:System.Windows.Controls.ListBox> に明示的に追加される場合、<xref:System.Windows.Controls.ListBox> は <xref:System.Windows.Controls.ListBoxItem> オブジェクトを仮想化しません。  
+  
+-   <xref:System.Windows.Controls.ItemsControl> に含まれる項目コンテナーの種類が異なる。  たとえば、<xref:System.Windows.Controls.Separator> オブジェクトを使用する <xref:System.Windows.Controls.Menu> では、項目のリサイクルを実装できません。これは、<xref:System.Windows.Controls.Menu> には、<xref:System.Windows.Controls.Separator> 型のオブジェクトと <xref:System.Windows.Controls.MenuItem> 型のオブジェクトが含まれるからです。  
+  
+-   <xref:System.Windows.Controls.ScrollViewer.CanContentScroll%2A> を `false` に設定する。  
+  
+-   <xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A> を `false` に設定する。  
+  
+ コンテナー項目を仮想化する際の重要な考慮事項は項目が属する項目コンテナーに関連付けられた追加の状態情報の有無です。  その場合は、追加状態を保存する必要があります。  たとえば、<xref:System.Windows.Controls.Expander> コントロールに含まれる項目で、<xref:System.Windows.Controls.Expander.IsExpanded%2A> 状態が、項目自体ではなく、項目コンテナーにバインドされている場合があります。  このコンテナーが新しい項目に対して再利用される場合、新しい項目には <xref:System.Windows.Controls.Expander.IsExpanded%2A> の現在の値が使用されます。  さらに、古い項目は、正しい <xref:System.Windows.Controls.Expander.IsExpanded%2A> 値を失います。  
+  
+ 現時点では、データの仮想化のサポートが組み込まれている WPF コントロールはありません。  
+  
+<a name="Container"></a>   
+## コンテナーのリサイクル  
+ .NET Framework 3.5 SP1 で、<xref:System.Windows.Controls.ItemsControl> から継承するコントロール用として追加された UI の仮想化に対する最適化は*コンテナーのリサイクル*です。コンテナーのリサイクルによってスクロールのパフォーマンスも向上します。  UI の仮想化を使用する <xref:System.Windows.Controls.ItemsControl> が設定されると、項目をスクロールして表示するたびに項目コンテナーが作成され、項目をスクロールして非表示にするたびに項目コンテナーが破棄されます。  *コンテナーのリサイクル*では、異なるデータ項目用の既存の項目コンテナーをコントロールが再利用できるので、ユーザーが <xref:System.Windows.Controls.ItemsControl> をスクロールするたびに項目コンテナーの作成と破棄が常に行われることはありません。  <xref:System.Windows.Controls.VirtualizationMode> に <xref:System.Windows.Controls.VirtualizingPanel.VirtualizationMode%2A> の添付プロパティを設定することにより項目のリサイクルを有効にすることができます。  
+  
+ 仮想化をサポートするすべての <xref:System.Windows.Controls.ItemsControl> で、コンテナーのリサイクルを使用できます。  <xref:System.Windows.Controls.ListBox> でコンテナーのリサイクルを有効にする方法の例については、「[ListBox のスクロール速度を向上させる](../../../../docs/framework/wpf/controls/how-to-improve-the-scrolling-performance-of-a-listbox.md)」を参照してください。  
+  
+<a name="Supporting"></a>   
+## 双方向仮想化のサポート  
+ <xref:System.Windows.Controls.VirtualizingStackPanel> には、水平または垂直のいずれかの方向での UI の仮想化のサポートが組み込まれています。  コントロールに対して双方向の仮想化を使用する場合は、<xref:System.Windows.Controls.VirtualizingStackPanel> クラスを拡張するカスタム パネルを実装する必要があります。  <xref:System.Windows.Controls.VirtualizingStackPanel> クラスは、<xref:System.Windows.Controls.VirtualizingStackPanel.OnViewportSizeChanged%2A>、<xref:System.Windows.Controls.VirtualizingStackPanel.LineUp%2A>、<xref:System.Windows.Controls.VirtualizingStackPanel.PageUp%2A>、<xref:System.Windows.Controls.VirtualizingStackPanel.MouseWheelUp%2A> などの仮想メソッドを公開します。これらの仮想メソッドを使用して、リストの表示部分の変更を検出し、変更に応じた処理を実行できます。  
+  
+<a name="Optimizing"></a>   
+## テンプレートの最適化  
+ ビジュアル ツリーには、アプリケーションのすべてのビジュアル要素が含まれます。  直接的に作成されたオブジェクトに加え、テンプレートの拡張によって追加されたオブジェクトも含まれます。  たとえば、<xref:System.Windows.Controls.Button> を作成すると、ビジュアル ツリーには、<xref:Microsoft.Windows.Themes.ClassicBorderDecorator> オブジェクトと <xref:System.Windows.Controls.ContentPresenter> オブジェクトも取得されます。  コントロール テンプレートを最適化していない場合、必要のない余分なオブジェクトがビジュアル ツリーの中に多数作成される可能性があります。  ビジュアル ツリーの詳細については、「[WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)」を参照してください。  
+  
+<a name="Deferred"></a>   
+## 遅延スクロール  
+ 既定では、ユーザーがスクロールバーのつまみをドラッグすると、コンテンツ ビューが連続的に更新されます。  コントロールのスクロールが遅い場合は、遅延スクロールの使用を検討してください。  遅延スクロールでは、コンテンツは、ユーザーがつまみを離したときにのみ更新されます。  
+  
+ 遅延スクロールを実装するには、<xref:System.Windows.Controls.ScrollViewer.IsDeferredScrollingEnabled%2A> プロパティを `true` に設定します。  <xref:System.Windows.Controls.ScrollViewer.IsDeferredScrollingEnabled%2A> は添付プロパティであり、<xref:System.Windows.Controls.ScrollViewer> と、コントロール テンプレート内に <xref:System.Windows.Controls.ScrollViewer> が含まれているすべてのコントロールに設定できます。  
+  
+<a name="Controls"></a>   
+## パフォーマンス機能を実装するコントロール  
+ 次の表は、データを表示するための一般的なコントロールと、各コントロールのパフォーマンス機能に対するサポートを示しています。  これらの機能を有効にする方法については、前のセクションを参照してください。  
+  
+|Control|仮想化|コンテナーのリサイクル|遅延スクロール|  
+|-------------|---------|-----------------|-------------|  
+|<xref:System.Windows.Controls.ComboBox>|有効にできます。|有効にできます。|有効にできます。|  
+|<xref:System.Windows.Controls.ContextMenu>|有効にできます。|有効にできます。|有効にできます。|  
+|<xref:System.Windows.Controls.DocumentViewer>|使用できません。|使用できません。|有効にできます。|  
+|<xref:System.Windows.Controls.ListBox>|既定値|有効にできます。|有効にできます。|  
+|<xref:System.Windows.Controls.ListView>|既定値|有効にできます。|有効にできます。|  
+|<xref:System.Windows.Controls.TreeView>|有効にできます。|有効にできます。|有効にできます。|  
+|<xref:System.Windows.Controls.ToolBar>|使用できません。|使用できません。|有効にできます。|  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.TreeView> に対する仮想化とコンテナーのリサイクルを有効にする方法の例については、「[TreeView のパフォーマンスを改善する](../../../../docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md)」を参照してください。  
+  
+## 参照  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-data-binding.md b/docs/framework/wpf/advanced/optimizing-performance-data-binding.md
new file mode 100644
index 00000000000..349ed346d2b
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-data-binding.md
@@ -0,0 +1,94 @@
+---
+title: "パフォーマンスの最適化 : データ バインド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), パフォーマンス"
+  - "データ バインド, パフォーマンス"
+ms.assetid: 1506a35d-c009-43db-9f1e-4e230ad5be73
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# パフォーマンスの最適化 : データ バインド
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] データ バインディングは、アプリケーションがデータを提示し、データと対話するための簡単で一貫性のある方法を提供します。  要素は、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトや [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] の形式のさまざまなデータ ソースのデータにバインドできます。  
+  
+ このトピックでは、データ バインディングのパフォーマンスに関する推奨事項について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="HowDataBindingReferencesAreResolved"></a>   
+## データ バインディングの参照が解決されるしくみ  
+ データ バインディングのパフォーマンスの問題に入る前に、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のデータ バインディング エンジンがバインディングのオブジェクト参照をどのように解決するのかを説明します。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のデータ バインディングでは、任意の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトをソースとして使用して、  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトのプロパティ、サブプロパティ、またはインデクサーにバインドできます。  バインディング参照は、[!INCLUDE[TLA#tla_avalonwinfx](../../../../includes/tlasharptla-avalonwinfx-md.md)] のリフレクションか <xref:System.ComponentModel.ICustomTypeDescriptor> を使用して解決されます。  次に、バインディングのオブジェクト参照を解決するための 3 つの方法について説明します。  
+  
+ 1 つ目は、リフレクションを使用する方法です。  この場合は、<xref:System.Reflection.PropertyInfo> オブジェクトを使用してプロパティの属性を検出し、プロパティ メタデータにアクセスします。  <xref:System.ComponentModel.ICustomTypeDescriptor> インターフェイスを使用している場合は、データ バインディング エンジンはこのインターフェイスを使用してプロパティ値にアクセスします。  <xref:System.ComponentModel.ICustomTypeDescriptor> インターフェイスは、オブジェクトに静的なプロパティのセットがない場合に特に便利です。  
+  
+ <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する、または <xref:System.ComponentModel.TypeDescriptor> に関連付けられている変更通知を使用することによって、プロパティ変更通知を提供できます。  ただし、プロパティ変更通知を実装するには <xref:System.ComponentModel.INotifyPropertyChanged> を使用することをお勧めします。  
+  
+ ソース オブジェクトが [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトでソース プロパティが [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティの場合、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のデータ バインディング エンジンでは、最初にソース オブジェクトでリフレクションを使用して <xref:System.ComponentModel.TypeDescriptor> を取得してから <xref:System.ComponentModel.PropertyDescriptor> を照会する必要があります。  パフォーマンスの観点から見た場合、このリフレクション操作のシーケンスには時間がかかる可能性があります。  
+  
+ オブジェクト参照を解決するための 2 つ目の方法は、ソース オブジェクトが <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトで、ソース プロパティが [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティの場合に使用されます。  この場合、データ バインディング エンジンは、ソースの型に対してリフレクションを直接使用して必要なプロパティを取得します。  この方法も最適な方法とは言えませんが、最初の方法よりは作業セットの要件の負荷が小さくなります。  
+  
+ オブジェクト参照を解決するための 3 つ目の方法は、ソース オブジェクトが <xref:System.Windows.DependencyObject> で、ソース プロパティが <xref:System.Windows.DependencyProperty> の場合に使用されます。  この場合、データ バインディング エンジンはリフレクションを使用する必要はありません。  代わりに、プロパティ エンジンとデータ バインディング エンジンが連携してプロパティ参照を個別に解決します。  これが、データ バインディングに使用されているオブジェクト参照を解決するための最適な方法です。  
+  
+ これらの方法を使用して 1000 個の <xref:System.Windows.Controls.TextBlock> 要素の <xref:System.Windows.Controls.TextBlock.Text%2A> プロパティのデータ バインディングを行ったときの速度の比較を次の表に示します。  
+  
+|**TextBlock の Text プロパティのバインド先**|**バインディング時間 \(ミリ秒\)**|**レンダリング時間 \-\- バインディングを含む \(ミリ秒\)**|  
+|--------------------------------------|---------------------------|------------------------------------------|  
+|[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトのプロパティ|115|314|  
+|<xref:System.ComponentModel.INotifyPropertyChanged> を実装する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトのプロパティ|115|305|  
+|<xref:System.Windows.DependencyObject> の <xref:System.Windows.DependencyProperty>|90|263|  
+  
+<a name="Binding_to_Large_CLR_Objects"></a>   
+## 大きな CLR オブジェクトへのバインディング  
+ 何千ものプロパティを持つ 1 つの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトへのデータ バインディングは、パフォーマンスに大きな影響を及ぼします。  この影響を最小限に抑えるには、その 1 つのオブジェクトを複数の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトに分割して、個々のオブジェクトのプロパティの数を減らします。  次の表は、1 つの大きな [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトへのデータ バインディングと複数の小さなオブジェクトへのデータ バインディングのバインディング時間とレンダリング時間を示しています。  
+  
+|**1000 個の TextBlock オブジェクトのデータ バインディングのバインド先**|**バインディング時間 \(ミリ秒\)**|**レンダリング時間 \-\- バインディングを含む \(ミリ秒\)**|  
+|----------------------------------------------------|---------------------------|------------------------------------------|  
+|1000 個のプロパティを持つ 1 つの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト|950|1200|  
+|1 つのプロパティを持つ 1000 個の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト|115|314|  
+  
+<a name="Binding_to_an_ItemsSource"></a>   
+## ItemsSource へのバインディング  
+ <xref:System.Windows.Controls.ListBox> に表示する従業員リストを保持する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] <xref:System.Collections.Generic.List%601> オブジェクトがあるとします。  この 2 つのオブジェクトの間に対応関係を作成するには、従業員リストを <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティにバインドします。  ここで、グループに新しい従業員が加わったとします。  バインドされた <xref:System.Windows.Controls.ListBox> 値にその新しい従業員を挿入するには、の従業員を従業員リストに追加するだけで、その変更が自動的にデータ バインディング エンジンに認識されると思われがちです。  しかし、実際にはそうはならず、その変更は <xref:System.Windows.Controls.ListBox> に自動的には反映されません。  これは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] <xref:System.Collections.Generic.List%601> オブジェクトはコレクション変更イベントを自動的に発生させないからです。  <xref:System.Windows.Controls.ListBox> に変更を反映するには、従業員リストを再作成し、再度 <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティに割り当てる必要があります。  この解決方法で問題は解決されますが、パフォーマンスへの影響はきわめて大きくなります。  <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> を新しいオブジェクトに割り当てるたびに、<xref:System.Windows.Controls.ListBox> はまず前の項目を削除し、その後にリスト全体を再生成します。  <xref:System.Windows.Controls.ListBox> が複雑な <xref:System.Windows.DataTemplate> にマップされている場合、パフォーマンスへの影響はさらに大きくなります。  
+  
+ この問題は、従業員リストを <xref:System.Collections.ObjectModel.ObservableCollection%601> にすることによってきわめて効率的に解決することができます。  <xref:System.Collections.ObjectModel.ObservableCollection%601> オブジェクトは変更通知を発生させるため、それをデータ バインディング エンジンで受け取ることができます。  このイベントにより、リスト全体を再生成する必要なく、<xref:System.Windows.Controls.ItemsControl> の項目を追加または削除できます。  
+  
+ 次の表は、項目を 1 つ追加した場合に <xref:System.Windows.Controls.ListBox> の更新にかかる時間を示しています \(UI の仮想化はオフ\)。  1 行目の数字は、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] <xref:System.Collections.Generic.List%601> オブジェクトが <xref:System.Windows.Controls.ListBox> 要素の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> にバインドされている場合の経過時間を表しています。  2 行目の数字は、<xref:System.Collections.ObjectModel.ObservableCollection%601> が <xref:System.Windows.Controls.ListBox> 要素の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> にバインドされている場合の経過時間を表しています。  <xref:System.Collections.ObjectModel.ObservableCollection%601> のデータ バインディング方法を使用すると時間を大幅に節約できることがわかります。  
+  
+|**ItemsSource のデータ バインディングのバインド先**|**1 項目の更新時間 \(ミリ秒\)**|  
+|----------------------------------------|---------------------------|  
+|[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] <xref:System.Collections.Generic.List%601> オブジェクト|1656|  
+|<xref:System.Collections.ObjectModel.ObservableCollection%601>|20|  
+  
+<a name="Binding_IList_to_ItemsControl_not_IEnumerable"></a>   
+## IEnumerable ではなく IList を ItemsControl にバインドする  
+ <xref:System.Windows.Controls.ItemsControl> オブジェクトに <xref:System.Collections.Generic.IList%601> または <xref:System.Collections.IEnumerable> のどちらもバインドできる場合は、<xref:System.Collections.Generic.IList%601> オブジェクトを使用してください。  <xref:System.Collections.IEnumerable> を <xref:System.Windows.Controls.ItemsControl> にバインドすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でラッパー <xref:System.Collections.Generic.IList%601> オブジェクトが作成されます。これにより、追加のオブジェクトの不要なオーバーヘッドが発生するため、パフォーマンスに影響します。  
+  
+<a name="Do_not_Convert_CLR_objects_to_Xml_Just_For_Data_Binding"></a>   
+## データ バインディングのためだけに CLR オブジェクトを XML に変換しない  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] コンテンツへのデータ バインディングが可能です。ただし、[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] コンテンツへのデータ バインディングは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトへのデータ バインディングに比べて低速です。  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトのデータをデータ バインディングのためだけに XML に変換しないでください。  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md b/docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md
new file mode 100644
index 00000000000..5e5298eecbc
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md
@@ -0,0 +1,86 @@
+---
+title: "パフォーマンスの最適化 : レイアウトとデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デザインの考慮事項"
+  - "レイアウト パス"
+  - "レイアウト, 最適化 (パフォーマンスを)"
+ms.assetid: 005f4cda-a849-448b-916b-38d14d9a96fe
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# パフォーマンスの最適化 : レイアウトとデザイン
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの設計によっては、レイアウトの計算やオブジェクト参照の検証で不要なオーバーヘッドが発生して、パフォーマンスに影響が及ぶことがあります。  オブジェクトの作成 \(特に起動時の作成\) はアプリケーションのパフォーマンス特性に影響する可能性があります。  
+  
+ このトピックでは、このようなパフォーマンスに関する推奨事項について説明します。  
+  
+## \[レイアウト\]  
+ "レイアウト パス" という用語は、<xref:System.Windows.Controls.Panel> 派生オブジェクトの子のコレクションのメンバーを測定および配置して、それらを画面上に描画するプロセスを表します。  レイアウト パスは数学的に増大するプロセスで、コレクション内の子の数が多くなれば、必要な計算の数も多くなります。  たとえば、コレクション内の子 <xref:System.Windows.UIElement> オブジェクトがその位置を変更するたびに、レイアウト システムによる新しいパスがトリガーされる可能性があります。  オブジェクトの特性とレイアウトの動作の間には密接な関係があるため、レイアウト システムを呼び出すことができるイベントの種類を把握することが重要です。  レイアウト パスの不要な呼び出しをできるだけ減らすことで、アプリケーションのパフォーマンスを向上させることができます。  
+  
+ レイアウト システムは、コレクションの子メンバーごとに、測定パスと配置パスという 2 つのパスを実行します。  各子オブジェクトは、それぞれ固有のレイアウト動作を提供するために、<xref:System.Windows.UIElement.Measure%2A> メソッドと <xref:System.Windows.UIElement.Arrange%2A> メソッドの独自のオーバーライドされた実装を提供します。  簡単に言うと、レイアウトは、要素のサイズ測定、配置、および画面上への描画を繰り返す再帰的なシステムです。  
+  
+-   子 <xref:System.Windows.UIElement> オブジェクトは、最初にそのコア プロパティを測定して、レイアウト プロセスを開始します。  
+  
+-   オブジェクトのサイズに関連する <xref:System.Windows.FrameworkElement> プロパティ \(<xref:System.Windows.FrameworkElement.Width%2A>、<xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.Margin%2A> など\) が評価されます。  
+  
+-   <xref:System.Windows.Controls.DockPanel> の <xref:System.Windows.Controls.DockPanel.Dock%2A> プロパティや <xref:System.Windows.Controls.StackPanel> の <xref:System.Windows.Controls.StackPanel.Orientation%2A> プロパティなど、<xref:System.Windows.Controls.Panel> 固有のロジックが適用されます。  
+  
+-   すべての子オブジェクトが測定された後、コンテンツが配置されます。  
+  
+-   子オブジェクトのコレクションが画面に描画されます。  
+  
+ 以下のアクションが発生すると、再びレイアウト パス プロセスが呼び出されます。  
+  
+-   子オブジェクトがコレクションに追加された場合。  
+  
+-   子オブジェクトに <xref:System.Windows.FrameworkElement.LayoutTransform%2A> が適用された場合。  
+  
+-   子オブジェクトに対して <xref:System.Windows.UIElement.UpdateLayout%2A> メソッドが呼び出された場合。  
+  
+-   測定パスや配置パスに影響を与えるものとしてメタデータでマークされている[依存関係プロパティ](GTMT)の値が変更された場合。  
+  
+### 可能な場合は最も効率的なパネルを使用する  
+ 使用する <xref:System.Windows.Controls.Panel> 派生要素のレイアウト動作はレイアウト プロセスの複雑さに直接影響します。  たとえば、<xref:System.Windows.Controls.Grid> コントロールや <xref:System.Windows.Controls.StackPanel> コントロールには <xref:System.Windows.Controls.Canvas> コントロールよりはるかに多くの機能が用意されていますが、  その代償として、パフォーマンスへの負荷も高くなります。  <xref:System.Windows.Controls.Grid> コントロールに用意されている機能が必要ない場合は、<xref:System.Windows.Controls.Canvas> やカスタム パネルなど、パフォーマンスへの負荷が低いコントロールを代わりに使用するようにしてください。  
+  
+ 詳細については、「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」を参照してください。  
+  
+### RenderTransform は置き換えずに更新する  
+ <xref:System.Windows.UIElement.RenderTransform%2A> プロパティの値として、<xref:System.Windows.Media.Transform> を置き換えずに更新できる場合があります。  アニメーションを含むシナリオでは特にこれが当てはまります。  既存の <xref:System.Windows.Media.Transform> を更新すると、不要なレイアウト計算が開始されるのを防ぐことができます。  
+  
+### ツリーはトップダウンで作成する  
+ [論理ツリー](GTMT)のノードが追加または削除されると、ノードの親とそのすべての子でプロパティの無効化が行われます。  このため、常にトップダウンの作成パターンに従って、検証済みのノードで無駄に無効化が行われないようにする必要があります。  ツリーをトップダウンで作成した場合とボトムアップで作成した場合の実行速度の違いを次の表に示します。このツリーには 150 のレベルがあり、各レベルに <xref:System.Windows.Controls.TextBlock> と <xref:System.Windows.Controls.DockPanel> が 1 つずつ含まれています。  
+  
+|**動作**|**ツリーの作成 \(ミリ秒\)**|**レンダリング — ツリーの作成を含む \(ミリ秒\)**|  
+|------------|------------------------|------------------------------------|  
+|ボトムアップ|366|454|  
+|トップダウン|11|96|  
+  
+ ツリーをトップダウンで作成する方法を次のコード例に示します。  
+  
+ [!code-csharp[Performance#PerformanceSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet1)]
+ [!code-vb[Performance#PerformanceSnippet1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet1)]  
+  
+ 論理ツリーの詳細については、「[WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)」を参照してください。  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-object-behavior.md b/docs/framework/wpf/advanced/optimizing-performance-object-behavior.md
new file mode 100644
index 00000000000..155883067cb
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-object-behavior.md
@@ -0,0 +1,126 @@
+---
+title: "パフォーマンスの最適化 : オブジェクトの動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係プロパティ, パフォーマンス"
+  - "イベント ハンドラー [WPF]"
+  - "Freezable オブジェクト, パフォーマンス"
+  - "オブジェクト パフォーマンスに関する留意事項"
+  - "ユーザー インターフェイスの仮想化"
+ms.assetid: 73aa2f47-1d73-439a-be1f-78dc4ba2b5bd
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# パフォーマンスの最適化 : オブジェクトの動作
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] オブジェクトに固有の動作を理解することは、機能とパフォーマンスのバランスを見極めるうえで役に立ちます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Not_Removing_Event_Handlers"></a>   
+## オブジェクトのイベント ハンドラーを削除しないとオブジェクトが維持される可能性がある  
+ オブジェクトがそのイベントに渡すデリゲートは、事実上そのオブジェクトへの参照です。  このため、イベント ハンドラーによってオブジェクトが本来より長く維持される可能性があります。  オブジェクトのイベントをリッスンするように登録されているオブジェクトのクリーンアップを実行するときには、オブジェクトを解放する前にそのデリゲートを削除することが重要です。  不要なオブジェクトが残っていると、アプリケーションのメモリ使用量が増加します。  これは、オブジェクトが[論理ツリー](GTMT)や[ビジュアル ツリー](GTMT)のルートである場合には特に重要になります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって導入される弱いイベント リスナー パターンは、ソースとリスナーのオブジェクト有効期間の関係の追跡が困難な場合に役に立ちます。  一部の既存の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベントはこのパターンを使用します。  カスタム イベントを持つオブジェクトを実装する場合に、このパターンが役に立つこともあります。  詳細については、「[弱いイベント パターン](../../../../docs/framework/wpf/advanced/weak-event-patterns.md)」を参照してください。  
+  
+ CLR プロファイラーや作業セット ビューアーなど、特定のプロセスのメモリ使用量に関する情報を入手できるツールもいくつかあります。  CLR プロファイラーには、割り当てられた型のヒストグラム、割り当てグラフと呼び出しグラフ、さまざまなジェネレーションのガベージ コレクションとその結果のマネージ ヒープの状態を示す時系列、メソッドごとの割り当てとアセンブリの読み込みを示す呼び出しツリーなど、非常に便利な割り当てプロファイルのビューがいくつか含まれています。  詳細については、[.NET Framework Developer Center](http://go.microsoft.com/fwlink/?LinkId=117435) を参照してください。  
+  
+<a name="DPs_and_Objects"></a>   
+## 依存関係プロパティと依存関係オブジェクト  
+ 一般に、<xref:System.Windows.DependencyObject> の[依存関係プロパティ](GTMT)へのアクセスが [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティへのアクセスに比べて遅いということはありません。  プロパティ値の設定には多少のパフォーマンス オーバーヘッドがありますが、値の取得は、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティから取得する場合と同じくらい高速です。  この小さなパフォーマンス オーバーヘッドがある代わりに、[依存関係プロパティ](GTMT)では、データ バインディング、アニメーション、継承、スタイル設定などの堅牢な機能がサポートされています。  詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+### DependencyProperty の最適化  
+ アプリケーションで[依存関係プロパティ](GTMT)を定義するときには注意が必要です。  定義する <xref:System.Windows.DependencyProperty> が描画型のメタデータ オプションにしか影響しない場合 \(<xref:System.Windows.FrameworkPropertyMetadata.AffectsMeasure%2A> などのその他のメタデータ オプションには影響しない場合\) は、メタデータをオーバーライドしてそのようにマークする必要があります。  プロパティ メタデータをオーバーライドまたは取得する方法の詳細については、「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+ すべてのプロパティ変更が実際に測定、配置、および描画に影響するわけではない場合は、測定、配置、および描画の各パスを、プロパティ変更ハンドラーによって手動で無効にした方が効率的な場合もあります。  たとえば、設定した制限値より値が大きい場合にのみ背景を再描画する場合は、  設定した制限値を値が超えていた場合にのみプロパティ変更ハンドラーで描画を無効にします。  
+  
+### DependencyProperty を継承可能にするとパフォーマンスへの負荷が発生する  
+ 既定では、登録した[依存関係プロパティ](GTMT)は継承不可になります。  ただし、プロパティはどれでも明示的に継承可能にすることができます。  この機能は便利ですが、プロパティを継承可能にすると、プロパティの無効化の時間が増加して、パフォーマンスに影響します。  
+  
+### RegisterClassHandler は慎重に使用する  
+ <xref:System.Windows.EventManager.RegisterClassHandler%2A> を呼び出すと、インスタンスの状態を保存することができます。ただし、このハンドラーはすべてのインスタンスで呼び出されるということを認識しておく必要があります。これはパフォーマンス上問題になる可能性があります。  <xref:System.Windows.EventManager.RegisterClassHandler%2A> を使用するのは、アプリケーションでインスタンスの状態を保存する必要がある場合だけにしてください。  
+  
+### DependencyProperty の既定値は登録時に設定する  
+ 既定値を必要とする <xref:System.Windows.DependencyProperty> を作成するときには、<xref:System.Windows.DependencyProperty> の <xref:System.Windows.DependencyProperty.Register%2A> メソッドにパラメーターとして渡される既定のメタデータを使用してその値を設定します。  コンストラクターや要素の各インスタンスでプロパティ値を設定するのではなく、この方法を使用するようにしてください。  
+  
+### Register を使用して PropertyMetadata の値を設定する  
+ <xref:System.Windows.DependencyProperty> を作成する場合、<xref:System.Windows.PropertyMetadata> を設定するには、<xref:System.Windows.DependencyProperty.Register%2A> メソッドを使用する方法と <xref:System.Windows.DependencyProperty.OverrideMetadata%2A> メソッドを使用する方法があります。  オブジェクトの静的コンストラクターで <xref:System.Windows.DependencyProperty.OverrideMetadata%2A> を呼び出すこともできますが、これは最適な解決方法とは言えず、パフォーマンスに影響します。  最適なパフォーマンスを得るためには、<xref:System.Windows.DependencyProperty.Register%2A> の呼び出しの際に <xref:System.Windows.PropertyMetadata> を設定します。  
+  
+<a name="Freezable_Objects"></a>   
+## Freezable オブジェクト  
+ <xref:System.Windows.Freezable> は、非フリーズとフリーズの 2 つの状態を持つ特殊な型のオブジェクトです。  可能な場合は常にオブジェクトを固定するようにすると、アプリケーションのパフォーマンスが向上し、作業セットを縮小できます。  詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ 各 <xref:System.Windows.Freezable> には、オブジェクトが変更されるたびに発生する <xref:System.Windows.Freezable.Changed> イベントがあります。  ただし、変更通知はアプリケーションのパフォーマンスに影響を与えます。  
+  
+ たとえば、次の例では、各 <xref:System.Windows.Shapes.Rectangle> が同じ <xref:System.Windows.Media.Brush> オブジェクトを使用しています。  
+  
+ [!code-csharp[Performance#PerformanceSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet2)]
+ [!code-vb[Performance#PerformanceSnippet2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet2)]  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、<xref:System.Windows.Media.SolidColorBrush> オブジェクトの <xref:System.Windows.Freezable.Changed> イベントに対するイベント ハンドラーが既定で用意されており、それを使用して <xref:System.Windows.Shapes.Rectangle> オブジェクトの <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを無効にすることができます。  この場合、<xref:System.Windows.Media.SolidColorBrush> では、<xref:System.Windows.Freezable.Changed> イベントを発生させる必要が生じるたびに、各 <xref:System.Windows.Shapes.Rectangle> のコールバック関数を呼び出す必要があります。このコールバック関数の呼び出しが積み重なると、パフォーマンスが大幅に低下します。  さらに、この時点でハンドラーを追加または削除すると、アプリケーションでリスト全体を検査しなければならなくなるため、パフォーマンスに大きく影響します。  アプリケーションのシナリオで <xref:System.Windows.Media.SolidColorBrush> が変更されることがない場合は、<xref:System.Windows.Freezable.Changed> イベント ハンドラーの維持に無駄な負荷を費やすことになります。  
+  
+ <xref:System.Windows.Freezable> を固定すると、変更通知の維持にリソースを費やす必要がなくなるため、パフォーマンスが向上します。  次の表は、単純な <xref:System.Windows.Media.SolidColorBrush> について、<xref:System.Windows.Freezable.IsFrozen%2A> プロパティを `true` に設定した場合とそうでない場合のサイズの比較を示しています。  ここでは、10 の <xref:System.Windows.Shapes.Rectangle> オブジェクトの <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティに 1 つのブラシを適用する場合を想定しています。  
+  
+|**状態**|**サイズ**|  
+|------------|-------------|  
+|固定された <xref:System.Windows.Media.SolidColorBrush>|212 バイト|  
+|固定されていない <xref:System.Windows.Media.SolidColorBrush>|972 バイト|  
+  
+ この概念の例を次のコード サンプルに示します。  
+  
+ [!code-csharp[Performance#PerformanceSnippet3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet3)]
+ [!code-vb[Performance#PerformanceSnippet3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet3)]  
+  
+### 固定されていない Freezable の Changed ハンドラーによってオブジェクトが維持される可能性がある  
+ <xref:System.Windows.Freezable> オブジェクトの <xref:System.Windows.Freezable.Changed> イベントにオブジェクトが渡すデリゲートは、事実上そのオブジェクトへの参照です。  このため、<xref:System.Windows.Freezable.Changed> イベント ハンドラーによってオブジェクトが本来より長く維持される可能性があります。  <xref:System.Windows.Freezable> オブジェクトの <xref:System.Windows.Freezable.Changed> イベントをリッスンするように登録されているオブジェクトのクリーンアップを実行するときには、オブジェクトを解放する前にそのデリゲートを削除することが重要です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Freezable.Changed> イベントが内部でもフックされます。  たとえば、<xref:System.Windows.Freezable> を値として受け取るすべての[依存関係プロパティ](GTMT)は、自動的に <xref:System.Windows.Freezable.Changed> イベントをリッスンします。  この概念の例として、<xref:System.Windows.Media.Brush> を受け取る <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを次に示します。  
+  
+ [!code-csharp[Performance#PerformanceSnippet4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet4)]
+ [!code-vb[Performance#PerformanceSnippet4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet4)]  
+  
+ `myRectangle.Fill` に `myBrush` を割り当てると、その <xref:System.Windows.Shapes.Rectangle> オブジェクトを指すデリゲートが <xref:System.Windows.Media.SolidColorBrush> オブジェクトの <xref:System.Windows.Freezable.Changed> イベントに追加されます。  このため、次のコードを使用しても、`myRect` は実際にはガベージ コレクションの対象にはなりません。  
+  
+ [!code-csharp[Performance#PerformanceSnippet5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet5)]
+ [!code-vb[Performance#PerformanceSnippet5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet5)]  
+  
+ この場合、`myBrush` は `myRectangle` を引き続き維持し、それを <xref:System.Windows.Freezable.Changed> イベントを発生させるときにコールバックします。  `myBrush` を新しい <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティに割り当てても、`myBrush` にイベント ハンドラーがさらに追加されるだけです。  
+  
+ この種のオブジェクトをクリーンアップするための推奨される方法としては、<xref:System.Windows.Shapes.Shape.Fill%2A> プロパティから <xref:System.Windows.Media.Brush> を削除します。これにより、<xref:System.Windows.Freezable.Changed> イベント ハンドラーも削除されます。  
+  
+ [!code-csharp[Performance#PerformanceSnippet6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml.cs#performancesnippet6)]
+ [!code-vb[Performance#PerformanceSnippet6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/window1.xaml.vb#performancesnippet6)]  
+  
+<a name="User_Interface_Virtualization"></a>   
+## ユーザー インターフェイスの仮想化  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] もデータ バインド子コンテンツを自動的に "仮想化する" <xref:System.Windows.Controls.StackPanel> 要素のバリエーションを提供します。  ここで、"仮想化" は、どの項目を画面に表示するかに基づいて、オブジェクトのサブセットを多数のデータ項目から生成する手法を指します。  特定の時間に画面に UI 要素が少ししか表示されていない場合に多数の UI 要素を生成すると、メモリおよびプロセッサの両方に負荷がかかります。  <xref:System.Windows.Controls.VirtualizingStackPanel> は、<xref:System.Windows.Controls.VirtualizingPanel> で提供される機能を通じて、表示される項目を計算し、<xref:System.Windows.Controls.ItemsControl> \(<xref:System.Windows.Controls.ListBox> や <xref:System.Windows.Controls.ListView> など\) の <xref:System.Windows.Controls.ItemContainerGenerator> と共に機能することで、表示される項目に対応する要素だけを作成します。  
+  
+ パフォーマンスの最適化の一環として、これらの項目のビジュアル オブジェクトは、画面に表示される場合にのみ生成または維持されます。  既にコントロールの表示可能領域にないビジュアル オブジェクトは削除される可能性があります。  これをデータの仮想化と混同しないようにしてください。データの仮想化では、すべてのデータ オブジェクトがローカル コレクションに存在するのではなく、データ オブジェクトが必要に応じてストリームされます。  
+  
+ 次の表は、5000 の <xref:System.Windows.Controls.TextBlock> 要素を <xref:System.Windows.Controls.StackPanel> と <xref:System.Windows.Controls.VirtualizingStackPanel> に追加して描画した場合の経過時間を示しています。  このシナリオの測定値は、テキスト文字列を <xref:System.Windows.Controls.ItemsControl> オブジェクトの <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティに割り当ててから、パネル要素にそのテキスト文字列が表示されるまでの時間を表します。  
+  
+|**ホスト パネル**|**レンダリング時間 \(ミリ秒\)**|  
+|-----------------|--------------------------|  
+|<xref:System.Windows.Controls.StackPanel>|3210|  
+|<xref:System.Windows.Controls.VirtualizingStackPanel>|46|  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md b/docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md
new file mode 100644
index 00000000000..4328b8dc08e
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md
@@ -0,0 +1,88 @@
+---
+title: "パフォーマンスの最適化 : その他の推奨事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, パフォーマンス"
+  - "ヒットテスト (オブジェクトの) [WPF]"
+  - "不透明"
+  - "ScrollBarVisibility 列挙体"
+  - "ターミナル サービスのレンダリング"
+ms.assetid: d028cc65-7e97-4a4f-9859-929734eaf40d
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# パフォーマンスの最適化 : その他の推奨事項
+<a name="introduction"></a> このトピックでは、「[WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)」のトピックで説明されている推奨事項を補足するパフォーマンスに関する推奨事項について説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [ブラシの Opacity と要素の Opacity](#Opacity)  
+  
+-   [オブジェクトへの移動](#Navigation_Objects)  
+  
+-   [大きな 3D サーフェイスのヒット テスト](#Hit_Testing)  
+  
+-   [CompositionTarget.Rendering イベント](#CompositionTarget_Rendering_Event)  
+  
+-   [ScrollBarVisibility\=Auto は使用しない](#Avoid_Using_ScrollBarVisibility)  
+  
+-   [Font Cache サービスの構成による起動時間の短縮](#FontCache)  
+  
+<a name="Opacity"></a>   
+## ブラシの Opacity と要素の Opacity  
+ <xref:System.Windows.Media.Brush> を使用して要素の <xref:System.Windows.Shapes.Shape.Fill%2A> や <xref:System.Windows.Shapes.Shape.Stroke%2A> を設定するときには、要素の <xref:System.Windows.UIElement.Opacity%2A> プロパティを設定するより <xref:System.Windows.Media.Brush.Opacity%2A?displayProperty=fullName> 値を設定することをお勧めします。  要素の <xref:System.Windows.UIElement.Opacity%2A> プロパティを変更すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって一時的なサーフェイスが作成される可能性があります。  
+  
+<a name="Navigation_Objects"></a>   
+## オブジェクトへの移動  
+ <xref:System.Windows.Navigation.NavigationWindow> オブジェクトは <xref:System.Windows.Window> から派生し、コンテンツ ナビゲーションのサポートでウィンドウを拡張します。この拡張は、主に <xref:System.Windows.Navigation.NavigationService> と履歴を統合することによって行われます。  <xref:System.Windows.Navigation.NavigationWindow> のクライアント領域は、[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] またはオブジェクトを指定することによって更新できます。  この両方の方法を次のサンプルに示します。  
+  
+ [!code-csharp[Performance#PerformanceSnippet14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/TestNavigation.xaml.cs#performancesnippet14)]
+ [!code-vb[Performance#PerformanceSnippet14](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Performance/visualbasic/testnavigation.xaml.vb#performancesnippet14)]  
+  
+ 各 <xref:System.Windows.Navigation.NavigationWindow> オブジェクトには、そのウィンドウのユーザーのナビゲーションを記録する履歴があります。  履歴の目的の 1 つは、ユーザーが自分の来た道を戻れるようにすることです。  
+  
+ [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] を使用して移動した場合、履歴には [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] の参照のみが格納されます。  したがって、ページに戻るたびにそのページが動的に再構築されることになり、ページの複雑さによってはかなりの時間がかかることもあります。  この場合、履歴の格納の負荷は低い反面、ページの再構築にかかる時間が長くなる可能性があります。  
+  
+ オブジェクトを使用して移動した場合は、オブジェクトのビジュアル ツリー全体が履歴に格納されます。  したがって、ページに戻るたびにページを再構築する必要はなく、ページがすぐに描画されます。  この場合、履歴の格納の負荷は高くなりますが、ページの再構築にかかる時間は短くて済みます。  
+  
+ <xref:System.Windows.Navigation.NavigationWindow> オブジェクトを使用するときには、履歴のサポートがアプリケーションのパフォーマンスにどのように影響するのかを念頭に置いておく必要があります。  詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+<a name="Hit_Testing"></a>   
+## 大きな 3D サーフェイスのヒット テスト  
+ 大きな 3D サーフェイスのヒット テストは、CPU 消費の面でパフォーマンスへの影響が非常に大きくなります。  3D サーフェイスがアニメーション化されている場合には特にその傾向が強くなります。  そのようなサーフェイスでヒット テストを行う必要がない場合は、ヒット テストを無効にしてください。  <xref:System.Windows.UIElement> から派生したオブジェクトでは、<xref:System.Windows.UIElement.IsHitTestVisible%2A> プロパティを `false` に設定することによってヒット テストを無効にできます。  
+  
+<a name="CompositionTarget_Rendering_Event"></a>   
+## CompositionTarget.Rendering イベント  
+ <xref:System.Windows.Media.CompositionTarget.Rendering?displayProperty=fullName> イベントは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を常にアニメーション化します。  このイベントを使用する場合は、毎回デタッチしてください。  
+  
+<a name="Avoid_Using_ScrollBarVisibility"></a>   
+## ScrollBarVisibility\=Auto は使用しない  
+ できる限り、<xref:System.Windows.Controls.ScrollBarVisibility?displayProperty=fullName> 値を `HorizontalScrollBarVisibility` プロパティと `VerticalScrollBarVisibility` プロパティでは使用しないでください。  これらのプロパティは、<xref:System.Windows.Controls.RichTextBox>、<xref:System.Windows.Controls.ScrollViewer>、<xref:System.Windows.Controls.TextBox>、<xref:System.Windows.Controls.ListBox> の各オブジェクトで定義されています。  代わりに、<xref:System.Windows.Controls.ScrollBarVisibility> を <xref:System.Windows.Controls.ScrollBarVisibility>、<xref:System.Windows.Controls.ScrollBarVisibility>、または <xref:System.Windows.Controls.ScrollBarVisibility> に設定します。  
+  
+ <xref:System.Windows.Controls.ScrollBarVisibility> 値は、スペースが限られていて、スクロール バーを必要なときにだけ表示する場合に使用するための値です。  <xref:System.Windows.Controls.ScrollBarVisibility> 値の使用は、たとえば、数百行のテキストを含む <xref:System.Windows.Controls.TextBox> ではなく、30 の項目を含む <xref:System.Windows.Controls.ListBox> で役に立ちます。  
+  
+<a name="FontCache"></a>   
+## Font Cache サービスの構成による起動時間の短縮  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] Font Cache サービスは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーション間でフォント データを共有します。  このサービスがまだ実行されていない場合は、実行する最初の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションによって開始されます。  [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] を使用している場合は、\[[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] Font Cache 3.0.0.0\] サービスの設定を \[手動\] \(既定\) から \[自動 \(遅延開始\)\] に変更することで、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの最初の起動時間を短縮できます。  
+  
+## 参照  
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [アニメーションのヒントとテクニック](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md b/docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md
new file mode 100644
index 00000000000..ff258377aac
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md
@@ -0,0 +1,73 @@
+---
+title: "パフォーマンスの最適化 : ハードウェアの活用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックスの描画層"
+  - "グラフィックス, パフォーマンス"
+  - "グラフィックス, 描画層"
+  - "ハードウェア レンダリング パイプライン"
+  - "描画層"
+  - "ソフトウェア レンダリング パイプライン"
+ms.assetid: bfb89bae-7aab-4cac-a26c-a956eda8fce2
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# パフォーマンスの最適化 : ハードウェアの活用
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の内部アーキテクチャには、ハードウェアとソフトウェアの 2 つのレンダリング パイプラインがあります。  このトピックでは、レンダリング パイプラインに関して、アプリケーションのパフォーマンスの最適化に関する判断に役立つ情報を提供します。  
+  
+## ハードウェア レンダリング パイプライン  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のパフォーマンスを決定する最も重要な要因の 1 つは、それがレンダリング制約であるということです。つまり、描画するピクセルが増えるほどパフォーマンスへの負荷が大きくなります。  ただし、[!INCLUDE[TLA#tla_gpu](../../../../includes/tlasharptla-gpu-md.md)] にオフロードできるレンダリングが増えれば、その分パフォーマンスが向上します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのハードウェア レンダリング パイプラインは、[!INCLUDE[TLA#tla_dx](../../../../includes/tlasharptla-dx-md.md)] Version 7.0 以上をサポートするハードウェアの [!INCLUDE[TLA#tla_dx](../../../../includes/tlasharptla-dx-md.md)] 機能を最大限に活用します。  [!INCLUDE[TLA#tla_dx](../../../../includes/tlasharptla-dx-md.md)] Version 7.0 と PixelShader 2.0\+ の機能をサポートするハードウェアでは、さらなる最適化を実現できます。  
+  
+## ソフトウェア レンダリング パイプライン  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のソフトウェア レンダリング パイプラインは完全に CPU 制約です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、CPU の SSE\/SSE2 命令セットを活用して、最適化されたフル機能のソフトウェア ラスタライザーを実装します。  ハードウェア レンダリング パイプラインを使用して実行できないアプリケーション機能のレンダリングは、シームレスにソフトウェア レンダリングに戻ります。  
+  
+ ソフトウェア モードでのレンダリングにおけるパフォーマンスの最大の問題は、塗りつぶし速度に関連する問題です。塗りつぶし速度は、描画するピクセルの数として定義されます。  ソフトウェア レンダリング モードでのパフォーマンスに懸念がある場合は、ピクセルの再描画の回数をできるだけ減らすようにしてください。  たとえば、アプリケーションに青い背景があり、その上にやや透明のイメージを描画する場合は、アプリケーションのすべてのピクセルが 2 回描画されることになります。  その結果、アプリケーションにイメージが含まれている場合は、青い背景のみの場合に比べて描画に 2 倍の時間がかかることになります。  
+  
+### グラフィックスの描画層  
+ アプリケーションが実行されるハードウェア構成を予測するのは非常に難しい場合があります。  ただし、異なるハードウェアで実行された場合にシームレスに機能を切り替えられるようにアプリケーションを設計することもできます。これにより、アプリケーションでそれぞれのハードウェア構成を最大限に活用できます。  
+  
+ そのために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] にはシステムのグラフィックス機能を実行時に判別する機能が用意されています。  グラフィックス機能の判別は、ビデオ カードを 3 つの描画層に分類することによって行われます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が公開する [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] を使用して描画層を照会することにより、  アプリケーションは、ハードウェアでサポートされている描画層に応じて、実行時に異なるコード パスを受け取ることができます。  
+  
+ 描画層のレベルに大きく影響するグラフィックス ハードウェアの機能は、次のとおりです。  
+  
+-   **ビデオ RAM** グラフィックス ハードウェアのビデオ メモリの量によって、グラフィックスを合成する際に使用できるバッファーのサイズと数が決まります。  
+  
+-   **ピクセル シェーダー** ピクセル シェーダーは、ピクセル単位で効果を計算するグラフィックス処理関数です。  表示するグラフィックスの解像度によっては、各表示フレームの処理に数百万ピクセルが必要な場合もあります。  
+  
+-   **頂点シェーダー** 頂点シェーダーは、オブジェクトの頂点データの算術演算を実行するグラフィックス処理関数です。  
+  
+-   **マルチテクスチャのサポート** マルチテクスチャがサポートされていると、3D グラフィックス オブジェクトのブレンド操作を行うときに、2 つ以上の別個のテクスチャを適用できます。  マルチテクスチャのサポートの度合いは、グラフィックス ハードウェアのマルチテクスチャ ユニットの数によって決まります。  
+  
+ ピクセル シェーダー、頂点シェーダー、およびマルチテクスチャの各機能を使用して、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] の特定のバージョン レベルを定義し、次にこのバージョン レベルを使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のさまざまな描画層を定義します。  
+  
+ グラフィックス ハードウェアの機能によって、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの表示能力が決まります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] システムは、次の 3 つの描画階層を定義します。  
+  
+-   **描画層 0** グラフィックス ハードウェアの加速が使用されません。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは Version 7.0 未満です。  
+  
+-   **描画層 1** グラフィックス ハードウェアの加速が部分的に使用されます。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは、Version 7.0 以上で Version 9.0 未満です。  
+  
+-   **描画層 2** ほとんどのグラフィックス機能でグラフィックス ハードウェアの加速を使用します。  [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] のバージョン レベルは Version 9.0 以上です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レンダリング層の詳細については、「[グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)」を参照してください。  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-performance-text.md b/docs/framework/wpf/advanced/optimizing-performance-text.md
new file mode 100644
index 00000000000..82048a96bdf
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-performance-text.md
@@ -0,0 +1,177 @@
+---
+title: "パフォーマンスの最適化 : テキスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "レンダリング (テキストの)"
+  - "ハイパーリンク"
+  - "書式設定テキスト [WPF]"
+  - "テキスト、パフォーマンス"
+  - "グリフ"
+ms.assetid: 66b1b9a7-8618-48db-b616-c57ea4327b98
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# パフォーマンスの最適化 : テキスト
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]豊富な機能を使用してテキストの内容の表示のサポートが含まれています[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]コントロールです。 一般に&3; つの層でのテキスト表示に分けることができます。  
+  
+1.  使用して、<xref:System.Windows.Documents.Glyphs>と<xref:System.Windows.Media.GlyphRun>オブジェクトを直接します。  
+  
+2.  使用して、 <xref:System.Windows.Media.FormattedText>オブジェクトです。  
+  
+3.  などの高度なコントロールを使用して、 <xref:System.Windows.Controls.TextBlock>と<xref:System.Windows.Documents.FlowDocument>オブジェクトです。  
+  
+ このトピックは、テキストのレンダリングのパフォーマンスに関する推奨事項を提供します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Glyph_Level"></a>   
+## <a name="rendering-text-at-the-glyph-level"></a>グリフ レベルでのテキストのレンダリング  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]では、高度なテキストに直接アクセスできるグリフ レベルのマークアップを含む<xref:System.Windows.Documents.Glyphs>を途中受信してテキストの書式設定後は保持しお客様にします。 これらの機能要件を指定する重要なサポート別のテキストのレンダリングの各シナリオを次にします。  
+  
+-   固定形式のドキュメントの画面表示されます。  
+  
+-   シナリオを印刷します。  
+  
+    -   [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]デバイスのプリンター言語です。  
+  
+    -   [!INCLUDE[TLA#tla_mxdw](../../../../includes/tlasharptla-mxdw-md.md)]。  
+  
+    -   出力元の以前のプリンター ドライバー[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)]固定形式のアプリケーションです。  
+  
+    -   印刷スプール形式です。  
+  
+-   固定形式のドキュメントの表示、以前のバージョンのクライアントを含む[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]やその他のコンピューティング デバイスです。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.Glyphs>と<xref:System.Windows.Media.GlyphRun>固定形式のドキュメントの表示と印刷のシナリオ用に設計されています。 [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]いくつかの要素は、一般的なレイアウトと[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]などのシナリオ<xref:System.Windows.Controls.Label>と<xref:System.Windows.Controls.TextBlock>します。 レイアウトについての詳細と[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]シナリオを参照して、 [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)します。  
+  
+ 次の例は、プロパティを定義する方法を示して、<xref:System.Windows.Documents.Glyphs>オブジェクト[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]します。 <xref:System.Windows.Documents.Glyphs>オブジェクトの出力を表す、 <xref:System.Windows.Media.GlyphRun>で[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。 例に Arial、Courier New および Times New Roman フォントがインストールされているものと、 **C:\WINDOWS\Fonts**ローカル コンピューター上のフォルダーです。  
+  
+ [!code-xml[GlyphsOvwSample1#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlyphsOvwSample1/CS/default.xaml#1)]  
+  
+### <a name="using-drawglyphrun"></a>DrawGlyphRun を使用します。  
+ カスタム コントロールがあり、グリフをレンダリングを使用する場合、 <xref:System.Windows.Media.DrawingContext.DrawGlyphRun%2A>メソッドです。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]カスタム書式を使用するとの下位レベル サービスも提供、 <xref:System.Windows.Media.FormattedText>オブジェクトです。 最も効率的な方法でテキストのレンダリングの[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]、グリフを使用してレベルでテキストの内容を生成することによって、<xref:System.Windows.Documents.Glyphs>と<xref:System.Windows.Media.GlyphRun>します。 ただし、この効率性の低下が簡単に使用されるリッチ テキスト書式、組み込まれている機能の損失はの[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]などのコントロール<xref:System.Windows.Controls.TextBlock>と<xref:System.Windows.Documents.FlowDocument>します。  
+  
+<a name="FormattedText_Object"></a>   
+## <a name="formattedtext-object"></a>FormattedText オブジェクト  
+ <xref:System.Windows.Media.FormattedText>オブジェクトをテキスト内の各文字形式指定できる個別に、複数行のテキストを描画することができます。 詳細については、次を参照してください。[形式のテキストを描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)します。  
+  
+ 書式設定されたテキストを作成するには、 <xref:System.Windows.Media.FormattedText.%23ctor%2A>コンス トラクターを作成する、 <xref:System.Windows.Media.FormattedText>オブジェクトです。 最初の書式設定されたテキスト文字列を作成した後は、さまざまな書式設定スタイルを適用できます。 アプリケーションが独自のレイアウトを実装する場合、 <xref:System.Windows.Media.FormattedText>オブジェクトは、コントロールを使用してよりも適した選択肢<xref:System.Windows.Controls.TextBlock>します。 詳細については、 <xref:System.Windows.Media.FormattedText>オブジェクトは、「[形式テキストを描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)します。  
+  
+ <xref:System.Windows.Media.FormattedText>オブジェクトは低レベルな書式設定機能を提供します。 1 つまたは複数の文字には、複数の書式スタイルを適用できます。 たとえば、両方を呼び出すことが、 <xref:System.Windows.Media.FormattedText.SetFontSize%2A>と<xref:System.Windows.Media.FormattedText.SetForegroundBrush%2A>テキストの最初の&5; つの文字の書式を変更する方法です。  
+  
+ 次のコード例を作成、 <xref:System.Windows.Media.FormattedText>オブジェクトし、それをレンダリングします。  
+  
+ [!code-csharp[formattedtextsnippets#FormattedTextSnippets1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FormattedTextSnippets/CSharp/Window1.xaml.cs#formattedtextsnippets1)]
+ [!code-vb[formattedtextsnippets#FormattedTextSnippets1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FormattedTextSnippets/visualbasic/window1.xaml.vb#formattedtextsnippets1)]  
+  
+<a name="FlowDocument_TextBlock_Label"></a>   
+## <a name="flowdocument-textblock-and-label-controls"></a>FlowDocument、TextBlock、およびラベル コントロール  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]画面にテキストを描画するための複数のコントロールが含まれます。 各コントロールには別のシナリオを対象として、独自の機能と制限事項のリストを持ちます。  
+  
+### <a name="flowdocument-impacts-performance-more-than-textblock-or-label"></a>FlowDocument TextBlock またはラベルよりも多くのパフォーマンスに影響  
+ 一般に、 <xref:System.Windows.Controls.TextBlock>制限付きのテキストのサポートが必要な場合で、簡単な文など、要素を使用する必要があります、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]です。 <xref:System.Windows.Controls.Label>テキストが最小限のサポートが必要なときに使用できます。 <xref:System.Windows.Documents.FlowDocument>要素は、コンテンツのリッチ プレゼンテーションで使用できる再 flowable のドキュメントのコンテナーであり、そのため、使用するよりも大きい、パフォーマンスに影響を持つ、 <xref:System.Windows.Controls.TextBlock>または<xref:System.Windows.Controls.Label>コントロールです。  
+  
+ 詳細については<xref:System.Windows.Documents.FlowDocument>を参照してください[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)します。  
+  
+### <a name="avoid-using-textblock-in-flowdocument"></a>FlowDocument の TextBlock を使用しないでください。  
+ <xref:System.Windows.Controls.TextBlock>から派生した要素が<xref:System.Windows.UIElement>します。 <xref:System.Windows.Documents.Run>から派生した要素が<xref:System.Windows.Documents.TextElement>を使用するより低コストである、 <xref:System.Windows.UIElement>-派生オブジェクト。 可能であれば、使用<xref:System.Windows.Documents.Run>なく<xref:System.Windows.Controls.TextBlock> 、テキスト コンテンツを表示するため、 <xref:System.Windows.Documents.FlowDocument>します。  
+  
+ 次のマークアップのサンプル内のテキスト コンテンツの設定の&2; つの方法を示しています、 <xref:System.Windows.Documents.FlowDocument>:  
+  
+ [!code-xml[Performance#PerformanceSnippet13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/FlowDocument.xaml#performancesnippet13)]  
+  
+### <a name="avoid-using-run-to-set-text-properties"></a>テキストのプロパティを設定する実行を使用しないでください。  
+ 一般を使用して、<xref:System.Windows.Documents.Run>内で、 <xref:System.Windows.Controls.TextBlock>明示的なを使用していないよりもパフォーマンスにはありません<xref:System.Windows.Documents.Run>すべてのオブジェクトします。 使用している場合、<xref:System.Windows.Documents.Run>テキストのプロパティを設定するためにこれらのプロパティを設定に直接、 <xref:System.Windows.Controls.TextBlock>代わりにします。  
+  
+ この場合は、text プロパティを設定するこれら&2; つの方法を説明する次のマークアップ サンプル、 <xref:System.Windows.Controls.TextBlock.FontWeight%2A>プロパティ。  
+  
+ [!code-xml[Performance#PerformanceSnippet12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Window1.xaml#performancesnippet12)]  
+  
+ 次の表に、1000 を表示するのにかかるコスト<xref:System.Windows.Controls.TextBlock>オブジェクトとそうでない明示的な<xref:System.Windows.Documents.Run>します。  
+  
+|**TextBlock 型**|**作成時間 (ミリ秒)**|**レンダリング時間 (ミリ秒)**|  
+|------------------------|------------------------------|----------------------------|  
+|テキストのプロパティの設定を実行します。|146|540|  
+|TextBlock の text プロパティの設定|43|453|  
+  
+### <a name="avoid-databinding-to-the-labelcontent-property"></a>Label.Content プロパティへのデータ バインドを避ける  
+ 存在するシナリオを想像してみてください、<xref:System.Windows.Controls.Label>から頻繁に更新されるオブジェクト、<xref:System.String>ソース。 ときにデータ バインド、<xref:System.Windows.Controls.Label>要素の<xref:System.Windows.Controls.ContentControl.Content%2A>プロパティを<xref:System.String>ソース オブジェクト、パフォーマンスの低下が発生する可能性があります。 たびに、ソース<xref:System.String>が更新されると、古い<xref:System.String>オブジェクトが破棄され、新しい<xref:System.String>が再作成されます: ため、<xref:System.String>オブジェクトは変更できない、変更することはできません。 これにより、 <xref:System.Windows.Controls.ContentPresenter>の<xref:System.Windows.Controls.Label>オブジェクトの古い内容を破棄し、新しい表示を新しいコンテンツを再生成<xref:System.String>します。  
+  
+ この問題の解決策は単純です。 場合、<xref:System.Windows.Controls.Label>カスタムに設定されていない<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A>値で置き換えます、<xref:System.Windows.Controls.Label>で、 <xref:System.Windows.Controls.TextBlock>とデータ バインド、<xref:System.Windows.Controls.TextBlock.Text%2A>プロパティをソース文字列にします。  
+  
+|**データ バインドされたプロパティ**|**更新時間 (ミリ秒)**|  
+|-----------------------------|----------------------------|  
+|Label.Content|835|  
+|TextBlock.Text|242|  
+  
+<a name="Hyperlink"></a>   
+## <a name="hyperlink"></a>ハイパーリンク  
+ <xref:System.Windows.Documents.Hyperlink>オブジェクトがインライン レベルのフロー コンテンツ要素フロー コンテンツ内のハイパーリンクをホストすることができます。  
+  
+### <a name="combine-hyperlinks-in-one-textblock-object"></a>1 つの TextBlock オブジェクト内のハイパーリンクを結合します。  
+ 複数の使用を最適化する<xref:System.Windows.Documents.Hyperlink>要素内で同じ化する<xref:System.Windows.Controls.TextBlock>します。 これで、アプリケーションを作成するオブジェクトの数を最小限に抑えるのに役立ちます。 たとえば、次のような複数のハイパーリンクを表示します。  
+  
+ MSN ホーム |MSN  
+  
+ 次のマークアップの例に示します複数<xref:System.Windows.Controls.TextBlock>ハイパーリンクを表示するための要素。  
+  
+ [!code-xml[Performance#PerformanceSnippet9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Hyperlink.xaml#performancesnippet9)]  
+  
+ 次のマークアップの例を表示するハイパーリンク、今回は、1 つを使用してより効率的な方法について説明<xref:System.Windows.Controls.TextBlock>:  
+  
+ [!code-xml[Performance#PerformanceSnippet10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Hyperlink.xaml#performancesnippet10)]  
+  
+### <a name="showing-underlines-on-hyperlinks-only-on-mouseenter-events"></a>MouseEnter イベントにのみハイパーリンクに下線を表示  
+ A <xref:System.Windows.TextDecoration>オブジェクトがビジュアルの装飾のテキストに追加することができます。 ただし、パフォーマンスをインスタンス化する処理を要するがあります。 広範な利用を加えた場合<xref:System.Windows.Documents.Hyperlink>など、イベントをトリガーする場合にのみ下線を表示、要素を検討、 <xref:System.Windows.ContentElement.MouseEnter>イベントです。 詳細については、次を参照してください。[を指定するかどうか、ハイパーリンクに下線が引かれた](../../../../docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md)です。  
+  
+ ![TextDecorations を表示します。](../../../../docs/framework/wpf/advanced/media/textdecoration03.png "TextDecoration03")  
+MouseEnter に表示されるハイパーリンク  
+  
+ 次のマークアップのサンプルでは、<xref:System.Windows.Documents.Hyperlink>下線の有無を定義します。  
+  
+ [!code-xml[Performance#PerformanceSnippet11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Performance/CSharp/Hyperlink.xaml#performancesnippet11)]  
+  
+ 次の表には、1000 を表示するパフォーマンス コストが示されます。<xref:System.Windows.Documents.Hyperlink>かつ下線のない要素です。  
+  
+|**ハイパーリンク**|**作成時間 (ミリ秒)**|**レンダリング時間 (ミリ秒)**|  
+|-------------------|------------------------------|----------------------------|  
+|下線付きで|289|1130|  
+|下線なし|299|776|  
+  
+<a name="Text_Formatting_Features"></a>   
+## <a name="text-formatting-features"></a>テキストの書式設定機能  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]リッチ テキスト形式の自動ハイフネーションが行わなどのサービスを提供します。 これらのサービスでは、アプリケーションのパフォーマンスに影響を与える可能性があり、必要な場合にのみ使用します。  
+  
+### <a name="avoid-unnecessary-use-of-hyphenation"></a>ハイフネーションの不要な使用を避ける  
+ 自動ハイフネーション、テキストの行のハイフンのブレークポイントを検索し、内の行の追加の改行位置ことができます<xref:System.Windows.Controls.TextBlock>と<xref:System.Windows.Documents.FlowDocument>オブジェクトです。 既定では、自動ハイフネーション機能は、これらのオブジェクトで無効になります。 オブジェクトの IsHyphenationEnabled プロパティを設定してこの機能を有効にすることができます`true`します。 しかし、この機能を有効にすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]を開始する[!INCLUDE[TLA#tla_com](../../../../includes/tlasharptla-com-md.md)]相互運用性、アプリケーションのパフォーマンスに影響を与えることができます。 必要な場合は、ハイフネーションを使用しないことをお勧めします。  
+  
+### <a name="use-figures-carefully"></a>図表を慎重に使用します。  
+ A<xref:System.Windows.Documents.Figure>要素がコンテンツのページ内で絶対位置は、フロー コンテンツの一部を示します。 場合によって、<xref:System.Windows.Documents.Figure>されていなかったり、既にコンテンツとの位置が衝突する場合に自動的に再フォーマットをページ全体が発生する可能性があります。 グループ化して、不要な再フォーマットの可能性を最小限に抑えることができます<xref:System.Windows.Documents.Figure>固定ページ サイズのシナリオでのコンテンツの最上部の宣言、または横にある要素。  
+  
+### <a name="optimal-paragraph"></a>段落の最適化  
+ 段落の最適化機能、 <xref:System.Windows.Documents.FlowDocument>空白をできる限り均等に分散されるように、オブジェクトが段落をレイアウトします。 既定では、段落の最適化機能は無効です。 この機能を有効にするには、オブジェクトのできます<xref:System.Windows.Documents.FlowDocument.IsOptimalParagraphEnabled%2A>プロパティを`true`します。 ただし、この機能を有効にすると、アプリケーションのパフォーマンスが影響します。 必要な場合は、段落の最適化機能を使用しないことをお勧めします。  
+  
+## <a name="see-also"></a>関連項目  
+ [WPF アプリケーションのパフォーマンスを最適化します。](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [アプリケーションのパフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [データ バインディング](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [その他のパフォーマンスの推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/optimizing-wpf-application-performance.md b/docs/framework/wpf/advanced/optimizing-wpf-application-performance.md
new file mode 100644
index 00000000000..5de0503a21c
--- /dev/null
+++ b/docs/framework/wpf/advanced/optimizing-wpf-application-performance.md
@@ -0,0 +1,71 @@
+---
+title: "WPF アプリケーションのパフォーマンスの最適化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーションの最適化"
+  - "アプリケーションの描画, パフォーマンス"
+  - "アプリケーション, 最適化"
+  - "WPF アプリケーション, 最適化"
+ms.assetid: ac8c6aa3-3c68-4a24-9827-3b6c829c1ebf
+caps.latest.revision: 45
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 45
+---
+# WPF アプリケーションのパフォーマンスの最適化
+このセクションは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションのパフォーマンスを改善する方法を探している開発者にリファレンス情報を提供することを目的にしています。  [!INCLUDE[TLA#tla_avalonwinfx](../../../../includes/tlasharptla-avalonwinfx-md.md)] や [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を初めて使用する開発者は、先にこの 2 つのプラットフォームについてよく学ぶ必要があります。  このセクションは、両方のプラットフォームの実践的な知識があり、既に実行可能なアプリケーションを作成できるプログラマを対象としています。  
+  
+> [!NOTE]
+>  このセクションで紹介するパフォーマンス データは、512 MB の RAM と ATI Radeon 9700 グラフィックス カードを搭載した 2.8 GHz の PC で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを実行した場合のデータです。  
+  
+## このセクションの内容  
+ [アプリケーション パフォーマンスの計画](../../../../docs/framework/wpf/advanced/planning-for-application-performance.md)  
+  
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)  
+  
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)  
+  
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)  
+  
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)  
+  
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)  
+  
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)  
+  
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)  
+  
+ [コントロール](../../../../docs/framework/wpf/advanced/optimizing-performance-controls.md)  
+  
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)  
+  
+ [アプリケーションの起動時間](../../../../docs/framework/wpf/advanced/application-startup-time.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.RenderOptions>   
+ <xref:System.Windows.Media.RenderCapability>   
+ [グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)   
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)   
+ [アニメーションのヒントとテクニック](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)   
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/packaging-fonts-with-applications.md b/docs/framework/wpf/advanced/packaging-fonts-with-applications.md
new file mode 100644
index 00000000000..2ab5dfecf04
--- /dev/null
+++ b/docs/framework/wpf/advanced/packaging-fonts-with-applications.md
@@ -0,0 +1,183 @@
+---
+title: "アプリケーションでのフォントのパッケージング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, パッケージ化 (フォントを)"
+  - "フォント, パッケージ化 (アプリケーションで)"
+  - "パッケージ化 (アプリケーションでフォントを)"
+  - "タイポグラフィ, パッケージ化 (アプリケーションでフォントを)"
+ms.assetid: db15ee48-4d24-49f5-8b9d-a64460865286
+caps.latest.revision: 29
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# アプリケーションでのフォントのパッケージング
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでフォントをパッケージ化する方法の概要について説明します。  
+  
+> [!NOTE]
+>  多くの種類のソフトウェアと同様に、フォント ファイルは、販売されるのではなくライセンスされます。  フォントの使用を管理するライセンスはベンダーによって異なりますが、[!INCLUDE[TLA#tla_ms#initcap](../../../../includes/tlasharptla-mssharpinitcap-md.md)] がアプリケーションや [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] で提供しているフォントをカバーするライセンスも含めて、通常、ほとんどのライセンスは、フォントをアプリケーションに埋め込んだり、別の方法で再頒布したりすることを許可していません。  したがって、アプリケーションに埋め込む、または別の方法で再頒布するフォントについて、必要なライセンス権限を取得することは、開発者であるユーザーの責任で行ってください。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="introduction_to_packaging_fonts"></a>   
+## フォントのパッケージングの概要  
+ ユーザー インターフェイスのテキストやその他の種類のテキスト ベースのコンテンツを表示するために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のリソースとしてフォントを簡単にパッケージ化できます。  フォントは、アプリケーションのアセンブリ ファイルと別にすることも、アセンブリ ファイル内に埋め込むこともできます。  また、アプリケーションで参照できる、リソース専用のフォント ライブラリを作成することもできます。  
+  
+ [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] および [!INCLUDE[TLA#tla_truetype](../../../../includes/tlasharptla-truetype-md.md)] フォントには、各フォントにおけるフォント埋め込みのライセンス権限を示す、型フラグ fsType が含まれています。  ただし、この型フラグはドキュメントに格納された埋め込みフォントのみを参照し、アプリケーションに埋め込まれたフォントは参照しません。  フォントの埋め込み権限を取得するには、<xref:System.Windows.Media.GlyphTypeface> オブジェクトを作成し、その <xref:System.Windows.Media.GlyphTypeface.EmbeddingRights%2A> プロパティを参照します。  fsType フラグの詳細については、[OpenType 仕様](http://www.microsoft.com/typography/otspec/os2.htm)の「OS\/2 and Windows Metrics」を参照してください。  
+  
+ 特定のフォント ベンダーまたはカスタム作業のフォント ベンダーを探す際に役立つ連絡先情報については、[Microsoft の文字体裁](http://www.microsoft.com/typography/links/)の Web サイトを参照してください。  
+  
+<a name="adding_fonts_as_content_items"></a>   
+## コンテンツ項目としてのフォントの追加  
+ フォントは、アプリケーションのアセンブリ ファイルとは別のプロジェクト コンテンツ項目としてアプリケーションに追加できます。  つまり、コンテンツ項目はアセンブリ内にリソースとして埋め込まれません。  コンテンツ項目を定義する方法を次のプロジェクト ファイル例に示します。  
+  
+```  
+<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
+  <!-- Other project build settings ... -->  
+  
+  <ItemGroup>  
+    <Content Include="Peric.ttf" />  
+    <Content Include="Pericl.ttf" />  
+  </ItemGroup>  
+</Project>  
+```  
+  
+ アプリケーションが実行時にフォントを使用できるようにするには、アプリケーションの展開ディレクトリでフォントをアクセス可能にする必要があります。  アプリケーションのプロジェクト ファイルの `<CopyToOutputDirectory>` 要素を使用すると、ビルド プロセスでアプリケーション展開ディレクトリにフォントを自動的にコピーできます。  展開ディレクトリにフォントをコピーする方法を次のプロジェクト ファイル例に示します。  
+  
+```  
+<ItemGroup>  
+  <Content Include="Peric.ttf">  
+    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>  
+  </Content>  
+  <Content Include="Pericl.ttf">  
+    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>  
+  </Content>  
+</ItemGroup>  
+```  
+  
+ 次のコード例は、アプリケーションのフォントをコンテンツ項目として参照する方法を示しています。参照されるコンテンツ項目は、アプリケーションのアセンブリ ファイルと同じディレクトリ内に存在する必要があります。  
+  
+ [!code-xml[FontSnippets#FontPackageSnippet8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontPackageSnippets.xaml#fontpackagesnippet8)]  
+  
+<a name="adding_fonts_as_resource_items"></a>   
+## リソース項目としてのフォントの追加  
+ フォントは、アプリケーションのアセンブリ ファイルに埋め込まれたプロジェクト リソース項目としてアプリケーションに追加できます。  リソース用に個別のサブディレクトリを使用して、アプリケーションのプロジェクト ファイルを編成できます。  個別のサブディレクトリ内のリソース項目としてフォントを定義する方法を次のプロジェクト ファイル例に示します。  
+  
+```  
+<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
+  <!-- Other project build settings ... -->  
+  
+  <ItemGroup>  
+    <Resource Include="resources\Peric.ttf" />  
+    <Resource Include="resources\Pericl.ttf" />  
+  </ItemGroup>  
+</Project>  
+```  
+  
+> [!NOTE]
+>  アプリケーションにリソースとしてフォントを追加する場合は、アプリケーションのプロジェクト ファイルに `<EmbeddedResource>` 要素ではなく、`<Resource>` 要素を設定していることを確認してください。  ビルド アクションで `<EmbeddedResource>` 要素はサポートされません。  
+  
+ アプリケーションのフォント リソースを参照する方法を次のマークアップ例に示します。  
+  
+ [!code-xml[FontSnippets#FontPackageSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontPackageSnippets.xaml#fontpackagesnippet1)]  
+  
+### コードからのフォント リソース項目の参照  
+ コードからフォント リソース項目を参照するには、基本[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] と、フォントの場所の参照との 2 つの部分で構成される、フォント リソース参照を指定する必要があります。  これらの値は、<xref:System.Windows.Media.FontFamily.%23ctor%2A> メソッドのパラメーターして使用されます。  プロジェクトの `resources` というサブディレクトリにある、アプリケーションのフォント リソースを参照する方法を次のコード例に示します。  
+  
+ [!code-csharp[FontSnippets#FontPackageSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontPackageSnippets.xaml.cs#fontpackagesnippet2)]
+ [!code-vb[FontSnippets#FontPackageSnippet2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FontSnippets/visualbasic/fontpackagesnippets.xaml.vb#fontpackagesnippet2)]  
+  
+ 基本[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] には、フォント リソースが存在する、アプリケーションのサブディレクトリを含めることができます。  この場合、フォントの場所の参照でディレクトリを指定する必要はありませんが、先頭に "`./`" を付けて、基本[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] で指定するディレクトリと同じディレクトリ内のフォント リソースであることを示す必要があります。  次のコード例は、フォント リソース項目を参照する別の方法を示しています。これは前のコード例と同等です。  
+  
+ [!code-csharp[FontSnippets#FontPackageSnippet5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontPackageSnippets.xaml.cs#fontpackagesnippet5)]
+ [!code-vb[FontSnippets#FontPackageSnippet5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FontSnippets/visualbasic/fontpackagesnippets.xaml.vb#fontpackagesnippet5)]  
+  
+### 同じアプリケーション サブディレクトリからのフォントの参照  
+ アプリケーションのコンテンツとリソース ファイルは、アプリケーション プロジェクトのユーザー定義の同じサブディレクトリに配置できます。  同じサブディレクトリで定義されたコンテンツ ページとフォント リソースを次のプロジェクト ファイル例に示します。  
+  
+```  
+<ItemGroup>  
+  <Page Include="pages\HomePage.xaml" />  
+</ItemGroup>  
+<ItemGroup>  
+  <Resource Include="pages\Peric.ttf" />  
+  <Resource Include="pages\Pericl.ttf" />  
+</ItemGroup>  
+```  
+  
+ アプリケーションのコンテンツとフォントが同じディレクトリにあるため、フォント参照はアプリケーションのコンテンツに関連しています。  フォントがアプリケーションと同じディレクトリにある場合に、アプリケーションのフォント リソースを参照する方法を次の例に示します。  
+  
+ [!code-xml[FontSnippets#FontPackageSnippet3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/pages/HomePage.xaml#fontpackagesnippet3)]  
+  
+ [!code-csharp[FontSnippets#FontPackageSnippet4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/pages/HomePage.xaml.cs#fontpackagesnippet4)]
+ [!code-vb[FontSnippets#FontPackageSnippet4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FontSnippets/visualbasic/pages/homepage.xaml.vb#fontpackagesnippet4)]  
+  
+### アプリケーションでのフォントの列挙  
+ アプリケーション内のリソース項目としてフォントを列挙するには、<xref:System.Windows.Media.Fonts.GetFontFamilies%2A> または <xref:System.Windows.Media.Fonts.GetTypefaces%2A> メソッドを使用します。  次の例は、<xref:System.Windows.Media.Fonts.GetFontFamilies%2A> メソッドを使用して、アプリケーション フォントの場所から <xref:System.Windows.Media.FontFamily> のコレクションを返す方法を示しています。  ここでは、アプリケーションに "resources" という名前のサブディレクトリが含まれています。  
+  
+ [!code-csharp[FontSnippets#FontsSnippet3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontFamilySnippets.xaml.cs#fontssnippet3)]
+ [!code-vb[FontSnippets#FontsSnippet3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FontSnippets/visualbasic/fontfamilysnippets.xaml.vb#fontssnippet3)]  
+  
+ 次の例は、<xref:System.Windows.Media.Fonts.GetTypefaces%2A> メソッドを使用して、アプリケーション フォントの場所から <xref:System.Windows.Media.Typeface> のコレクションを返す方法を示しています。  ここでは、アプリケーションに "resources" という名前のサブディレクトリが含まれています。  
+  
+ [!code-csharp[FontSnippets#FontsSnippet7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FontSnippets/CSharp/FontFamilySnippets.xaml.cs#fontssnippet7)]
+ [!code-vb[FontSnippets#FontsSnippet7](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FontSnippets/visualbasic/fontfamilysnippets.xaml.vb#fontssnippet7)]  
+  
+<a name="creating_a_font_resource_library"></a>   
+## フォント リソース ライブラリの作成  
+ フォントのみを含むリソース専用ライブラリを作成できます。この種類のライブラリ プロジェクトにはコードは含まれません。  リソース専用ライブラリの作成は、リソースを使用するアプリケーション コードからリソースを切り離すための一般的な手法です。  また、これにより、複数のアプリケーション プロジェクトでこのライブラリ アセンブリを組み込むことができます。  リソース専用ライブラリ プロジェクトの主要部分を次のプロジェクト ファイル例に示します。  
+  
+```  
+<PropertyGroup>  
+  <AssemblyName>FontLibrary</AssemblyName>  
+  <OutputType>library</OutputType>  
+  ...  
+</PropertyGroup>  
+...  
+<ItemGroup>  
+  <Resource Include="Kooten.ttf" />  
+  <Resource Include="Pesca.ttf" />  
+</ItemGroup  
+```  
+  
+### リソース ライブラリ内のフォントの参照  
+ アプリケーションからリソース ファイル内のフォントを参照するには、フォント参照の前にライブラリ アセンブリの名前を付加する必要があります。  ここでは、フォント リソース アセンブリは "FontLibrary" です。  アセンブリ名をアセンブリ内の参照と区切るために、';' 文字を使用します。  キーワード "Component" の後にフォント名への参照を続けて追加すると、フォント ライブラリのリソースへの完全参照が完成します。  リソース ライブラリ アセンブリ内のフォントを参照する方法を次のコード例に示します。  
+  
+ [!code-xml[OpenTypeFontsSample#OpenTypeFontsSample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpenTypeFontsSample/CS/Kootenay.xaml#opentypefontssample1)]  
+  
+> [!NOTE]
+>  この SDK には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで使用できる一連の [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントがサンプルとして用意されています。  フォントは、リソース専用ライブラリで定義されています。  詳細については、「[OpenType フォント パックのサンプル](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)」を参照してください。  
+  
+<a name="limitations_on_font_usage"></a>   
+## フォントの使用に関する制限事項  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでのフォントのパッケージングおよび使用に関するいくつかの制限事項を次に示します。  
+  
+-   **フォント埋め込みアクセス許可情報** : [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、フォント埋め込みアクセス許可情報をチェックまたは強制しません。  詳細については、「[フォントのパッケージングの概要](#introduction_to_packaging_fonts)」を参照してください。  
+  
+-   **フォントの起点サイト** : [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、http または ftp の [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] へのフォント参照は許可されていません。  
+  
+-   **pack: 表記を使用した絶対 URI** : [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、フォントへの絶対 [!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] 参照の一部として "pack:" を使用してプログラムで <xref:System.Windows.Media.FontFamily> オブジェクトを作成することはできません。  たとえば、`"pack://application:,,,/resources/#Pericles Light"` は無効なフォント参照です。  
+  
+-   **自動フォント埋め込み** : デザイン時に、アプリケーションのフォントの使用を検索したり、アプリケーションのリソースにフォントを自動的に埋め込んだりすることはサポートされていません。  
+  
+-   **フォント サブセット** : [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、固定ドキュメント以外でフォント サブセットの作成はサポートされていません。  
+  
+-   正しくない参照がある場合、アプリケーションは使用可能なフォントの使用に戻ります。  
+  
+## 参照  
+ <xref:System.Windows.Documents.Typography>   
+ <xref:System.Windows.Media.FontFamily>   
+ [Microsoft Typography: Links, News, and Contacts \(Microsoft タイポグラフィ: リンク、ニュース、連絡先\)](http://www.microsoft.com/typography/links/)   
+ [OpenType Specification \(OpenType の仕様\)](http://www.microsoft.com/typography/otspec/)   
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)   
+ [OpenType フォント パックのサンプル](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md b/docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md
new file mode 100644
index 00000000000..512d09107a9
--- /dev/null
+++ b/docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md
@@ -0,0 +1,73 @@
+---
+title: "Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Direct3D9 [WPF 相互運用性], パフォーマンス"
+  - "WPF, Direct3D9 相互運用パフォーマンス"
+ms.assetid: ea8baf91-12fe-4b44-ac4d-477110ab14dd
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項
+<xref:System.Windows.Interop.D3DImage> クラスを使用して、Direct3D9 コンテンツをホストできます。  Direct3D9 コンテンツをホストすると、アプリケーションのパフォーマンスに影響することがあります。  このトピックでは、Windows Presentation Foundation \(WPF\) アプリケーションで Direct3D9 コンテンツをホストする場合に、パフォーマンスを最適化するベスト プラクティスについて説明します。  これらのベスト プラクティスでは、<xref:System.Windows.Interop.D3DImage> の使用方法と、Windows Vista、Windows XP、およびマルチモニター ディスプレイを使用する場合のベスト プラクティスを紹介します。  
+  
+> [!NOTE]
+>  これらのベスト プラクティスを示すコード例については、「[WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)」を参照してください。  
+  
+## 最小限の D3DImage の使用  
+ <xref:System.Windows.Interop.D3DImage> インスタンスでホストされる Direct3D9 コンテンツは、純粋な Direct3D アプリケーションでホストされる場合よりも表示が遅くなります。  サーフェイスのコピーおよびコマンド バッファーのフラッシュに時間がかかることがあります。  <xref:System.Windows.Interop.D3DImage> インスタンスの数が増えると、フラッシュの回数が多くなり、パフォーマンスが低下します。  したがって、<xref:System.Windows.Interop.D3DImage> の使用を最小限にする必要があります。  
+  
+## Windows Vista のベスト プラクティス  
+ ディスプレイが Windows Display Driver Model \(WDDM\) を使用するように構成されている Windows Vista で最大限のパフォーマンスを得るには、Direct3D9 サーフェイスを `IDirect3DDevice9Ex` デバイス上に作成します。  これにより、サーフェイスを共有できるようになります。  ビデオカードは、Windows Vista の `D3DDEVCAPS2_CAN_STRETCHRECT_FROM_TEXTURES` および `D3DCAPS2_CANSHARERESOURCE` というドライバーの機能をサポートしている必要があります。  その他の設定では、サーフェイスがソフトウェアを通してコピーされ、パフォーマンスが大幅に低下します。  
+  
+> [!NOTE]
+>  Windows Vista に、Windows XP Display Driver Model \(XDDM\) を使用するように構成されているディスプレイがある場合は、設定にかかわらず、サーフェイスが常にソフトウェアを通じてコピーされます。  適切な設定とビデオ カードがあれば、サーフェイスのコピーはハードウェアで実行されるため、WDDM を使用するときに Windows Vista のパフォーマンスが向上します。  
+  
+## Windows XP のベスト プラクティス  
+ Windows XP Display Driver Model \(XDDM\) を使用する Windows XP でパフォーマンスを最適にするために、`IDirect3DSurface9::GetDC` メソッドが呼び出されたときに正しく動作するロック可能なサーフェイスを作成します。  内部的に、`BitBlt` メソッドはハードウェアのデバイス間でサーフェイスを転送します。  `GetDC` メソッドは、常に XRGB サーフェイス上で動作します。  ただし、クライアント コンピューターで Windows XP SP3 または SP2 が実行されており、レイヤード ウィンドウ機能の修正プログラムも適用されている場合、このメソッドは ARGB サーフェイス上でのみ動作します。  ビデオ カードは、`D3DDEVCAPS2_CAN_STRETCHRECT_FROM_TEXTURES` ドライバー機能をサポートする必要があります。  
+  
+ 16 ビット デスクトップ表示深度を使用すると、パフォーマンスが大幅に低下することがあります。  32 ビット デスクトップをお勧めします。  
+  
+ Windows Vista および Windows XP で開発している場合は、Windows XP 上でパフォーマンスをテストします。  Windows XP のビデオ メモリが不足することは問題です。  また、Windows XP 上の <xref:System.Windows.Interop.D3DImage> では、余分なビデオ メモリ コピーが必要なため、Windows Vista WDDM よりも多くのビデオ メモリと帯域幅を使用します。  したがって、同じビデオ ハードウェアの場合は Windows Vista よりも Windows XP の方がパフォーマンスが低いと予想されます。  
+  
+> [!NOTE]
+>  XDDM は、Windows XP と Windows Vista の両方で使用できますが、WDDM は Windows Vista でのみ使用できます。  
+  
+## 一般的なベスト プラクティス  
+ デバイスを作成する場合は、`D3DCREATE_MULTITHREADED` 作成フラグを使用します。  これにより、パフォーマンスが低下しますが、WPF レンダリング システムは、別のスレッドからこのデバイスに対してメソッドを呼び出します。  ロック プロトコルに正しく従い、2 つのスレッドがデバイスに同時にアクセスしないようにしてください。  
+  
+ レンダリングが WPF マネージ スレッドで実行される場合は、`D3DCREATE_FPU_PRESERVE` 作成フラグを使用してデバイスを作成することを強くお勧めします。  この設定がないと、D3D レンダリングによって、WPF の倍精度演算の精度が低下し、レンダリングの問題が発生することがあります。  
+  
+ ハードウェア サポートがない状態で非 pow2 サーフェイスを並べて表示するのでない場合、または、<xref:System.Windows.Interop.D3DImage> を含む <xref:System.Windows.Media.DrawingBrush> か <xref:System.Windows.Media.VisualBrush> を並べて表示する場合は、<xref:System.Windows.Interop.D3DImage> を並べて表示するのが高速です。  
+  
+## マルチモニター ディスプレイのベスト プラクティス  
+ 複数のモニターがあるコンピューターを使用している場合は、前に説明したベスト プラクティスに従う必要があります。  マルチモニター構成に関する追加のパフォーマンス考慮事項もいくつかあります。  
+  
+ バック バッファーを作成する場合は、特定のデバイスおよびアダプターに作成されますが、WPF は任意のアダプターのフロント バッファーを表示する場合があります。  アダプター間でコピーしてフロント バッファーを更新すると、非常にコストが高くなる可能性があります。  複数のビデオ カードと `IDirect3DDevice9Ex` デバイスと共に WDDM を使用するように構成されている Windows Vista では、フロント バッファーが別のアダプターにあっても、同じビデオ カードである場合は、パフォーマンスの低下はありません。  ただし、Windows XP と複数のビデオ カードのある XDDM では、フロント バッファーがバック バッファーとは異なるアダプターに表示される場合にパフォーマンスが大幅に低下します。  詳細については、「[WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)」を参照してください。  
+  
+## パフォーマンスの概要  
+ 次の表に、オペレーティング システムの機能、ピクセル形式、およびサーフェイスのロック可能性としてのフロント バッファー更新のパフォーマンスを示します。  フロント バッファーとバック バッファーは、同じアダプター上にあることが前提です。  アダプター構成に応じて、ハードウェア更新は、一般にソフトウェア更新よりもはるかに高速です。  
+  
+|サーフェイスのピクセル形式|Windows Vista、WDDM、および 9Ex|その他の Windows Vista 構成|修正プログラムを適用した Windows XP SP3 または SP2|Windows XP SP2|  
+|-------------------|--------------------------------|---------------------------|-----------------------------------------|--------------------|  
+|D3DFMT\_X8R8G8B8 \(ロック不能\)|**ハードウェアのアップデート**|ソフトウェアのアップデート|ソフトウェアのアップデート|ソフトウェアのアップデート|  
+|D3DFMT\_X8R8G8B8 \(ロック可能\)|**ハードウェアのアップデート**|ソフトウェアのアップデート|**ハードウェアのアップデート**|**ハードウェアのアップデート**|  
+|D3DFMT\_A8R8G8B8 \(ロック不能\)|**ハードウェアのアップデート**|ソフトウェアのアップデート|ソフトウェアのアップデート|ソフトウェアのアップデート|  
+|D3DFMT\_A8R8G8B8 \(ロック可能\)|**ハードウェアのアップデート**|ソフトウェアのアップデート|**ハードウェアのアップデート**|ソフトウェアのアップデート|  
+  
+## 参照  
+ <xref:System.Windows.Interop.D3DImage>   
+ [WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)   
+ [チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md)   
+ [チュートリアル : WPF での Direct3D9 コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/performance.md b/docs/framework/wpf/advanced/performance.md
new file mode 100644
index 00000000000..c71a4802e92
--- /dev/null
+++ b/docs/framework/wpf/advanced/performance.md
@@ -0,0 +1,40 @@
+---
+title: "パフォーマンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "パフォーマンス"
+  - "Windows Presentation Foundation, パフォーマンス"
+  - "WPF, パフォーマンス"
+ms.assetid: c649a20f-8b7e-4a38-9b80-74839298d406
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# パフォーマンス
+最適なアプリケーション パフォーマンスを実現するためには、アプリケーションのデザイン時に十分な検討を行い、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーション開発のベスト プラクティスを理解する必要があります。  このセクションのトピックでは、高いパフォーマンスの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを構築するための追加情報を提供します。  
+  
+## このセクションの内容  
+ [グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)  
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.RenderCapability>  
+  
+ <xref:System.Windows.Media.RenderCapability.Tier%2A>  
+  
+ <xref:System.Diagnostics.PresentationTraceSources>  
+  
+## 参照  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [アニメーションのヒントとテクニック](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/planning-for-application-performance.md b/docs/framework/wpf/advanced/planning-for-application-performance.md
new file mode 100644
index 00000000000..80c39e7a56f
--- /dev/null
+++ b/docs/framework/wpf/advanced/planning-for-application-performance.md
@@ -0,0 +1,51 @@
+---
+title: "アプリケーション パフォーマンスの計画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, 最適化"
+  - "WPF アプリケーション, 最適化"
+ms.assetid: c91bd0c5-a193-46ff-9da1-eb7a3a76a3b3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# アプリケーション パフォーマンスの計画
+パフォーマンスの目標を達成できるかどうかは、適切なパフォーマンス計画を立てられるかどうかにかかっています。  すべての製品の開発は計画から始まります。  このトピックでは、適切なパフォーマンス計画を立てるためのごく簡単なルールをいくつか紹介します。  
+  
+## シナリオの観点から考える  
+ シナリオを利用して、アプリケーションの重要なコンポーネントに的を絞ることができます。  シナリオは、顧客や競合製品から導き出されるのが一般的です。  常に顧客をよく観察し、顧客が自分たちの製品や競合他社の製品のどこに引き付けられているのかを解明します。  顧客のフィードバックは、アプリケーションの主要なシナリオを特定するうえで役に立ちます。  たとえば、起動時に使用されるコンポーネントを設計している場合は、そのコンポーネントが呼び出されるのは一般にアプリケーションの起動時の 1 回だけであるため、  起動時間がキー シナリオになります。  そのほか、一連のアニメーションの目的のフレーム レートや、アプリケーションの最大作業セットなどがキー シナリオになる場合もあります。  
+  
+## 目標を定義する  
+ 目標は、アプリケーションのパフォーマンスが高いか低いかの判断に役立ちます。  すべてのシナリオで目標を定義する必要があります。  パフォーマンスの目標はすべて、顧客の期待に基づいて定義します。  アプリケーション開発サイクルの早い段階では未解決の問題もまだ多く、パフォーマンスの目標を設定するのが困難な場合もあります。  しかし、まったく目標を設定しないよりは、初期目標を設定してそれを後から修正する方が良いと言えます。  
+  
+## プラットフォームを理解する  
+ アプリケーション開発サイクルでは、測定、調査、改良\/修正というサイクルを常に維持します。  開発サイクルの始めから終わりまで、信頼できる安定した環境でアプリケーションのパフォーマンスを測定する必要があります。  外部要因による変動は避けるようにしてください。  たとえば、パフォーマンスをテストするときには、ウイルス対策ソフトウェアや自動更新 \(SMS など\) を無効にして、それらがパフォーマンス テストの結果に影響しないようにする必要があります。  アプリケーションのパフォーマンスの測定が完了したら、最大の効果を得るにはどこを変更すればよいのかを特定します。  アプリケーションに変更を加えた後、再び同じサイクルを開始します。  
+  
+## パフォーマンス チューニングを反復プロセスにする  
+ 使用する各機能の相対負荷を知る必要があります。  たとえば、[!INCLUDE[TLA#tla_avalonwinfx](../../../../includes/tlasharptla-avalonwinfx-md.md)] のリフレクションを使用すると、一般にコンピューティング リソースの面でパフォーマンスへの影響が大きくなります。したがって、この機能は適切な判断に基づいて使用する必要があります。  リフレクションを使用しないようにするということではありません。ただ、アプリケーションのパフォーマンスの要件と、使用する機能のパフォーマンスへの影響とのバランスに注意する必要があるということです。  
+  
+## 豊かなグラフィックスを目指す  
+ スケーラブルなアプローチで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのパフォーマンスの目標を達成するための主な手法の 1 つとして、豊かで複雑なグラフィックスを目指します。  最初は常に、パフォーマンスへの影響が最も少ないリソースを使用してシナリオの目標を達成します。  それらの目標を達成できたら、今度は、パフォーマンスへの影響が大きい機能を使用して豊かなグラフィックスを目指します。シナリオの目標は常に念頭に置いておきます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] はきわめて機能豊富なプラットフォームであり、多彩なグラフィックス機能が用意されています。  パフォーマンスへの影響が大きい機能を何も考えずに使用すると、アプリケーション全体のパフォーマンスが低下する可能性があります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールは本質的に拡張性が高く、コントロールの動作を変えずに外観を広範にカスタマイズすることができます。  スタイル、データ テンプレート、およびコントロール テンプレートを活用することにより、パフォーマンスの要件に対応したカスタマイズ可能な[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成し、徐々に発展させていくことができます。  
+  
+## 参照  
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)   
+ [ハードウェアの活用](../../../../docs/framework/wpf/advanced/optimizing-performance-taking-advantage-of-hardware.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [オブジェクトの動作](../../../../docs/framework/wpf/advanced/optimizing-performance-object-behavior.md)   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md b/docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md
new file mode 100644
index 00000000000..0f32b42befc
--- /dev/null
+++ b/docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md
@@ -0,0 +1,54 @@
+---
+title: "PresentationOptions:Freeze 属性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Freezable 要素"
+  - "Freeze 属性"
+  - "PresentationOptions プレフィックス"
+ms.assetid: 391032dd-2fba-4804-bb8a-3b071797a9f4
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# PresentationOptions:Freeze 属性
+含まれている <xref:System.Windows.Freezable> 要素に対して <xref:System.Windows.Freezable.IsFrozen%2A> 状態を `true` に設定します。  `PresentationOptions:Freeze` 属性を指定していない状態での <xref:System.Windows.Freezable> の既定の動作は、読み込み時には <xref:System.Windows.Freezable.IsFrozen%2A> が `false` となり、実行時には一般的な <xref:System.Windows.Freezable> の動作に依存します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object  
+  xmlns:PresentationOptions="http://schemas.microsoft.com/winfx/2006/xaml/presentation/options"  
+  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+  mc:Ignorable="PresentationOptions">  
+    <freezableElement PresentationOptions:Freeze="true"/>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`PresentationOptions`|XML 名前空間プレフィックス。XML 1.0 仕様で定められている有効な任意のプレフィックス文字列を指定できます。  プレフィックス `PresentationOptions` は、このドキュメントでの識別のために使用します。|  
+|`freezableElement`|<xref:System.Windows.Freezable> の任意の派生クラスをインスタンス化する要素。|  
+  
+## 解説  
+ `Freeze` 属性は、属性および他のプログラミング要素の中で唯一、`http://schemas.microsoft.com/winfx/2006/xaml/presentation/options` XML 名前空間で定義されています。  `Freeze` 属性がこの特殊な名前空間に置かれているのは、ルート要素宣言の一部として [mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md) を使用して、明確に無視可能と指定できるようにするためです。  `Freeze` を無視できるようにする必要があるのは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサの実装の中には、読み込み時に <xref:System.Windows.Freezable> を固定できないものがあるためです。この機能は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の仕様には含まれていません。  
+  
+ `Freeze` 属性を処理する機能は、コンパイル済みアプリケーション用に [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を処理する [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサに明確に組み込まれています。  この属性はどのクラスによってもサポートされず、属性の構文を拡張または変更することはできません。  独自の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサを実装する場合は、1 つの選択肢として、読み込み時に <xref:System.Windows.Freezable> 要素の `Freeze` 属性を処理する際に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサの固定動作を並行して行うことができます。  
+  
+ `Freeze` 属性に `true` \(大文字と小文字は区別されません\) 以外の値を指定すると、読み込み時にエラーが発生します。  `Freeze` 属性に `false` を指定してもエラーにはなりませんが、この値は既定値なので、`false` を設定しても何も行われません。  
+  
+## 参照  
+ <xref:System.Windows.Freezable>   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [mc:Ignorable 属性](../../../../docs/framework/wpf/advanced/mc-ignorable-attribute.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/preview-events.md b/docs/framework/wpf/advanced/preview-events.md
new file mode 100644
index 00000000000..b9842aa938a
--- /dev/null
+++ b/docs/framework/wpf/advanced/preview-events.md
@@ -0,0 +1,41 @@
+---
+title: "プレビュー イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント, プレビュー"
+  - "イベント, 非表示"
+  - "プレビュー イベント"
+  - "非表示イベント"
+ms.assetid: b5032308-aa9c-4d02-af11-630ecec8df7e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# プレビュー イベント
+プレビュー イベントはトンネル イベントとも呼ばれ、アプリケーション ルートから、イベントの発生元でありイベント データでソースとして報告される要素へ向かって経路をたどるルーティング イベントです。  すべてのイベント シナリオが、プレビュー イベントをサポートする、または必要とするわけではありません。このトピックでは、プレビュー イベントが存在する状況、アプリケーションまたはコンポーネントによるプレビュー イベントの処理方法、およびカスタム コンポーネントまたはカスタム クラスにプレビュー イベントを作成することが適切な状況について説明します。  
+  
+## プレビュー イベントと入力  
+ 一般に、Preview イベントを処理する場合、イベント データでイベントを処理済みとしてマークする際に注意が必要です。  Preview イベントを発生元 \(イベント データで発生元として報告される要素\) 以外の要素で処理すると、そのイベントを発生元の要素で処理する機会がなくなります。  このような状態が目的である場合もあります。複合コントロール内の要素間の場合などです。  
+  
+ 特に入力イベントでは、Preview イベントは、イベント データのインスタンスを対のバブル イベントと共有もします。  Preview イベントのクラス ハンドラーを使用して入力イベントを処理済みとしてマークすると、そのバブル入力イベントのクラス ハンドラーは呼び出されません。  また、Preview イベントのインスタンス ハンドラーを使用してイベントを処理済みとしてマークすると、通常、そのバブル イベントのハンドラーは呼び出されません。  イベントが処理済みとしてマークされてもクラス ハンドラーまたはインスタンス ハンドラーが呼び出されるようにこれらを登録またはアタッチするオプションもありますが、この手法は一般には使用されません。  
+  
+ クラス処理、およびクラス処理と Preview イベントの関係性の詳細については、「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+### コントロールによるイベント抑制の回避  
+ Preview イベントがよく使用されるシナリオの 1 つは、複合コントロールで入力イベントを処理する場合です。  コントロールの作成者は、特定のイベントがコントロールから生成されるのを抑制し、コンポーネントで定義された別のイベント \(より多くの情報を含むイベントや、より具体的な動作を表すイベント\) に置き換える場合もあります。  たとえば、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] <xref:System.Windows.Controls.Button> は、<xref:System.Windows.Controls.Button> またはその複合要素によって発生する <xref:System.Windows.UIElement.MouseLeftButtonDown> および <xref:System.Windows.UIElement.MouseLeftButtonDown> バブル イベントを抑制し、マウスをキャプチャすることと、常にその <xref:System.Windows.Controls.Button> 自体で発生する <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを発生させることを優先します。  イベントおよびそのそのデータはルートに沿ったままですが、<xref:System.Windows.Controls.Button> においてイベント データが <xref:System.Windows.RoutedEventArgs.Handled%2A> としてマークされるので、`handledEventsToo` の場合に動作するように指定されているイベントのハンドラーのみが呼び出されます。  アプリケーションのルートに近い方の他の要素で、コントロールで抑制されたイベントをまた処理する必要がある場合、1 つの代替手段は、`handledEventsToo` を `true` として指定して、コードでハンドラーをアタッチすることです。  ただし通常は、ルーティング方向を変更して、入力イベントに対応する Preview になるように処理する方がより簡単です。  たとえば、コントロールで <xref:System.Windows.UIElement.MouseLeftButtonDown> を抑制する場合、代わりに、ハンドラーを <xref:System.Windows.UIElement.PreviewMouseLeftButtonDown> へアタッチしてみてください。  この方法が有効なのは、<xref:System.Windows.UIElement.MouseLeftButtonDown> のような基本要素入力イベントの場合のみです。  これらの入力イベントはトンネル\/バブルのペアを使用し、両方のイベントを発生させ、イベント データを共有します。  
+  
+ これらの方法には、それぞれ悪影響や制限事項があります。  Preview イベントを処理する場合の悪影響は、その時点でイベントを処理すると、バブル イベントを処理するハンドラーが無効になる可能性がある点です。したがって、通常は、イベント ルートの Preview 部分で処理された時点ではまだ、イベントを処理済みとしてマークしない方がよいという点が制限となります。  `handledEventsToo` 手法の制限は、`handledEventsToo` ハンドラーは [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で属性として指定できない点です。このようなイベント ハンドラーは、アタッチ対象の要素へのオブジェクト参照を取得してからコードを使用して登録する必要があります。  
+  
+## 参照  
+ [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/printing-and-print-system-management.md b/docs/framework/wpf/advanced/printing-and-print-system-management.md
new file mode 100644
index 00000000000..878283982fe
--- /dev/null
+++ b/docs/framework/wpf/advanced/printing-and-print-system-management.md
@@ -0,0 +1,37 @@
+---
+title: "印刷および印刷システムの管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "印刷システム管理"
+  - "印刷"
+ms.assetid: 637911b3-0c78-4493-a4fb-91db56d767cd
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 印刷および印刷システムの管理
+[!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] と [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] には、[!INCLUDE[TLA#tla_gdi](../../../../includes/tlasharptla-gdi-md.md)] 印刷に代わる、新しい印刷パスと印刷システム管理 [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] の大幅な拡張セットが導入されています。  
+  
+## このセクションの内容  
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)  
+ 新しい印刷パスと新しい [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] についての説明です。  
+  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/printing-how-to-topics.md)  
+ 新しい印刷パスと新しい [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] の使用方法を示す一連の記事です。  
+  
+## 参照  
+ <xref:System.Printing>   
+ <xref:System.Printing.IndexedProperties>   
+ <xref:System.Printing.Interop>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [XML Paper Specification: 概要](http://www.microsoft.com/japan/whdc/xps/default.mspx)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/printing-how-to-topics.md b/docs/framework/wpf/advanced/printing-how-to-topics.md
new file mode 100644
index 00000000000..06209e7500e
--- /dev/null
+++ b/docs/framework/wpf/advanced/printing-how-to-topics.md
@@ -0,0 +1,62 @@
+---
+title: "印刷に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "印刷システム管理"
+  - "印刷"
+ms.assetid: 5f3d391a-4afd-49ee-ad99-ceb737c0c8a8
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 印刷に関する「方法」トピック
+このセクションのトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] および新しい [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] 印刷パスに含まれる印刷機能と印刷システム管理機能の使用方法について説明します。  
+  
+## このセクションの内容  
+ [印刷ダイアログ ボックスを呼び出す](../../../../docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md)  
+ XAML マークアップで [!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] 印刷ダイアログ ボックス オブジェクトを宣言する手順と、コードを使用してダイアログ ボックスを [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーション内から呼び出す手順です。  
+  
+ [プリンターを複製する](../../../../docs/framework/wpf/advanced/how-to-clone-a-printer.md)  
+ 2 番目の印刷キューを、既存の印刷キューとまったく同じプロパティでインストールする手順です。  
+  
+ [問題のある印刷ジョブを診断する](../../../../docs/framework/wpf/advanced/how-to-diagnose-problematic-print-job.md)  
+ 印刷キューと印刷ジョブのプロパティを使用して、停止中の印刷ジョブを診断する手順です。  
+  
+ [現在、印刷ジョブが印刷可能であるかどうかを検出する](../../../../docs/framework/wpf/advanced/how-to-discover-whether-a-print-job-can-be-printed-at-this-time-of-day.md)  
+ 印刷キューと印刷ジョブのプロパティを使用して、ジョブを印刷できる時刻をプログラムで検出する手順です。  
+  
+ [印刷キューのサブセットを列挙する](../../../../docs/framework/wpf/advanced/how-to-enumerate-a-subset-of-print-queues.md)  
+ 特定の特性を持つプリンターの一覧を生成する手順です。  
+  
+ [NOTINBUILD: How to: Extend the Print Schema and Create New Print System Classes](http://msdn.microsoft.com/ja-jp/a3600218-1ea5-478a-9853-6560464f2885)  
+ マネージ コード プログラマが、印刷スキーマを、新しい機能または一般的でない機能を持つ専門的な印刷デバイスやプリンターへ拡張する方法についての広範な説明です。  
+  
+ [リフレクションを使用せずに印刷システム オブジェクトのプロパティを取得する](../../../../docs/framework/wpf/advanced/how-to-get-print-system-object-properties-without-reflection.md)  
+ 印刷システム オブジェクトのプロパティとそのプロパティの型を実行時に検出する手順です。  
+  
+ [XPS ファイルをプログラムにより印刷する](../../../../docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md)  
+ [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を必要とせずに、[!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ファイルを迅速に印刷する手順です。  
+  
+ [プリンターのステータスをリモート操作で調査する](../../../../docs/framework/wpf/advanced/how-to-remotely-survey-the-status-of-printers.md)  
+ プリンターを調査して、紙詰まりまたはその他の問題のあるプリンターを検出するユーティリティを作成する手順です。  
+  
+ [PrintTickets を検証およびマージする](../../../../docs/framework/wpf/advanced/how-to-validate-and-merge-printtickets.md)  
+ 印刷チケットの有効性、および印刷チケットの要求がプリンターでサポートされているものかどうかをチェックする手順です。  
+  
+## 参照  
+ <xref:System.Printing>   
+ <xref:System.Printing.IndexedProperties>   
+ <xref:System.Printing.Interop>   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [XML Paper Specification: 概要](http://www.microsoft.com/japan/whdc/xps/default.mspx)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/printing-overview.md b/docs/framework/wpf/advanced/printing-overview.md
new file mode 100644
index 00000000000..0355523e49c
--- /dev/null
+++ b/docs/framework/wpf/advanced/printing-overview.md
@@ -0,0 +1,169 @@
+---
+title: "印刷の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, PrintCapabilities"
+  - "クラス, PrintQueue"
+  - "クラス, PrintServer"
+  - "クラス, PrintTicket"
+  - "GDI 印刷パス"
+  - "印刷パス, XPS"
+  - "PrintCapabilities クラス"
+  - "プリンター, XPSDrv ベースの"
+  - "印刷"
+  - "PrintQueue クラス PrintServer クラス"
+  - "PrintTicket クラス"
+  - "XML Paper Specification (XPS) ファイル形式"
+  - "XPS (XML Paper Specification) ファイル形式"
+  - "XPSDrv ベースのプリンター"
+ms.assetid: 0de8ac41-9aa6-413d-a121-7aa6f41539b1
+caps.latest.revision: 35
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# 印刷の概要
+[!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] によって、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] を使用するアプリケーション開発者は、豊富な新しい印刷および印刷システムの管理 [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] の一式を得られます。  また、[!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] によって、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーションを作成する開発者と、アンマネージ コードを使用する開発者も、これらの印刷システム拡張機能の一部を使用できます。  この新しい機能の中核となるのが、新しい [!INCLUDE[TLA#tla_xps](../../../../includes/tlasharptla-xps-md.md)] ファイル形式と [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] 印刷パスです。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [XPS について](#introduction_to_XPS)  
+  
+-   [XPS 印刷パス](#XPS_print_path_intro)  
+  
+-   [GDI 印刷パス](#GDI_Print_Path_intro)  
+  
+-   [XPSDrv ドライバー モデル](#XPS_Driver_Model_intro)  
+  
+-   [関連トピック](#seeAlso_Toggle)  
+  
+<a name="introduction_to_XPS"></a>   
+## XPS について  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] は、電子ドキュメント形式、スプール ファイル形式、およびページ記述言語です。  [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)]、[!INCLUDE[TLA#tla_opc](../../../../includes/tlasharptla-opc-md.md)]、その他の業界標を使用してクロス プラットフォームのドキュメントを作成する OpenDocument 形式の 1 つです。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] は、デジタル ドキュメントの作成、共有、印刷、表示、アーカイブを行うプロセスを簡略化します。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の追加情報については、[XPS Web サイト](http://www.microsoft.com/xps)を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用した [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ベースのコンテンツの印刷手法のいくつかは、「[XPS ファイルをプログラムにより印刷する](../../../../docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md)」で説明しています。  このトピックに含まれるコンテンツの確認中にこれらのサンプルを参照すると、役に立つ場合があります。\(アンマネージ コードの開発者は、*Microsoft XPS Document Converter のプリンター エスケープ*のヘルプを参照することをお勧めします。  [!INCLUDE[TLA2#tla_winforms#initcap](../../../../includes/tla2sharptla-winformssharpinitcap-md.md)] の開発者は、<xref:System.Drawing.Printing> 名前空間の [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] を使用する必要があります。この名前空間は、完全な [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] 印刷パスをサポートしていませんが、ハイブリッドの GDI\-XPS 印刷パスをサポートしています。  以下の**印刷パスのアーキテクチャ**を参照してください。\)  
+  
+<a name="XPS_print_path_intro"></a>   
+## XPS 印刷パス  
+ [!INCLUDE[TLA#tla_metro](../../../../includes/tlasharptla-metro-md.md)] 印刷パスは、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] アプリケーションでの印刷の処理方法を再定義する [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の新機能です。  [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] は、ドキュメントのプレゼンテーション言語 \(RTF など\)、印刷スプーラの形式 \(WMF など\)、およびページ記述言語 \(PCLや Postscript など\) に置き換えることができるため、新しい印刷パスは、アプリケーションの公開から印刷ドライバーまたはデバイスでの最終処理まで、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式を維持します。  
+  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] のプリンター ドライバー モデル \(XPSDrv\) 上に構築されています。XPSDrv により、開発者は [!INCLUDE[TLA#tla_wys](../../../../includes/tlasharptla-wys-md.md)] の印刷、色のサポートの向上、および印刷のパフォーマンスの大幅な向上など、いくつかの利点を得られます。  \(XPSDrv の詳細については、「[Microsoft API とリファレンスのカタログ](http://msdn.microsoft.com/library/default.asp?url=/library/dnanchor/html/DeviceDriver.asp)」を参照してください。\)  
+  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントの印刷スプーラの操作は、基本的に [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] の以前のバージョンと同じです。  ただし、既存の [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 印刷パスに加えて [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスをサポートするように強化されました。  新しい印刷パスは、ネイティブに [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] スプール ファイルを使用します。  [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の以前のバージョン向けに記述されたユーザー モードのプリンター ドライバーは引き続き機能しますが、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスを使用するためには、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) が必要になります。  
+  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスには大きな利点があります。それは次のとおりです。  
+  
+-   [!INCLUDE[TLA2#tla_wys](../../../../includes/tla2sharptla-wys-md.md)] の印刷のサポート。  
+  
+-   高度なカラー プロファイルのネイティブ サポート \(1 チャンネルあたり 32 ビット \(bpc\)、CMYK、名前付きの色、n インクなど\)、および透明度とグラデーションのネイティブ サポート。  
+  
+-   [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] と [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] ベースのアプリケーションの両方における印刷パフォーマンスの向上。  
+  
+-   業界標準の [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式。  
+  
+ 基本的な印刷シナリオでは、ユーザー インターフェイス、構成、およびジョブの送信用の 1 つのエントリ ポイントで、簡単かつ直感的な [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] を使用できます。  高度なシナリオ用に、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] のカスタマイズ \(または [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] がまったくない\)、同期または非同期の印刷、および一括印刷の機能のサポートが追加されました。  いずれのオプションでも、完全または部分的な信頼モードでの印刷のサポートを提供します。  
+  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] は、拡張性を考慮して設計されています。  機能拡張フレームワークを使用して、機能を [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] にモジュール形式で追加できます。  拡張機能は、次のとおりです。  
+  
+-   印刷スキーマ。  パブリックのスキーマは定期的に更新され、デバイスの機能を迅速に拡張することができます。  \(下記の「**PrintTicket と PrintCapabilities**」をご覧ください。\)  
+  
+-   拡張可能なフィルター パイプライン。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) フィルター パイプラインは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントの直接的および拡張性の高い印刷を可能にするように作られています。  \(「[Microsoft API とリファレンスのカタログ](http://msdn.microsoft.com/library/default.asp?url=/library/dnanchor/html/DeviceDriver.asp)」で "XPSDrv" を検索してください。\)  
+  
+### 印刷パスのアーキテクチャ  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションはいずれも [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] をサポートします。一方、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーションは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) 用に [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の書式設定されたコンテンツを作成するため、[!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] から [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] への変換を使用します。  これらのアプリケーションでは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスを使用する必要はなく、[!INCLUDE[TLA#tla_emf](../../../../includes/tlasharptla-emf-md.md)] ベースの印刷を引き続き使用できます。  ただし、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の機能と拡張機能のほとんどは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスを対象としたアプリケーション以外では使用できません。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションと [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーションで XPSDrv ベースのプリンターを使用できるようにするため、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) は [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 形式から [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式への変換をサポートしています。XPSDrv モデルには、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式から [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 形式へのコンバーターも備えられています。これにより、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションは [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ドキュメントを印刷できます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションでは、書き込み操作の対象の印刷キューに XPSDrv ドライバーがない場合は常に、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式から [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 形式への変換は、<xref:System.Windows.Xps.XpsDocumentWriter> クラスの <xref:System.Windows.Xps.XpsDocumentWriter.Write%2A> メソッドと <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A> メソッドで自動的に実行されます。\([!INCLUDE[TLA2#tla_winforms#initcap](../../../../includes/tla2sharptla-winformssharpinitcap-md.md)] アプリケーションは [!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ドキュメントを印刷できません。\)  
+  
+ 次の図は、印刷サブシステムを示すとともに、[!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] が提供する部分、およびソフトウェアとハードウェアのベンダーが定義する部分を定義しています。  
+  
+ ![XPS 印刷システム](../../../../docs/framework/wpf/advanced/media/xpsprint.PNG "XPSPrint")  
+  
+### XPS の基本的な印刷  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、基本的および高度な [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] の両方を定義します。  広範な印刷のカスタマイズや完全な [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の機能セットへのアクセスを必要としないアプリケーションでは、基本的な印刷サポートを使用できます。  基本的な印刷サポートは、最小構成を必要とし、使い慣れた [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を特長とする印刷ダイアログ コントロールを介して公開されます。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の機能の多くは、この簡略化された印刷モデルによって使用できます。  
+  
+#### PrintDialog  
+ <xref:System.Windows.Controls.PrintDialog?displayProperty=fullName> コントロールには、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]、構成、および [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ジョブの送信用の 1 つのエントリ ポイントが用意されています。  コントロールのインスタンス化および使用方法については、「[印刷ダイアログ ボックスを呼び出す](../../../../docs/framework/wpf/advanced/how-to-invoke-a-print-dialog.md)」を参照してください。  
+  
+### 高度な XPS の印刷  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 機能の完全なセットにアクセスするには、高度な印刷の [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] を使用する必要があります。  いくつかの関連する [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] について、以下で詳しく説明します。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の印刷パス [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の完全な一覧については、<xref:System.Windows.Xps> と <xref:System.Printing> の名前空間のリファレンスを参照してください。  
+  
+#### PrintTicket と PrintCapabilities  
+ <xref:System.Printing.PrintTicket> クラスと <xref:System.Printing.PrintCapabilities> クラスは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の高度な機能の基盤となります。  いずれの種類のオブジェクトも、照合順序、両面印刷、ホチキス止めなど、[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] 形式の印刷向け機能の構造になっています。  これらの構造は、印刷スキーマによって定義されます。  <xref:System.Printing.PrintTicket> は、プリンターに印刷ジョブの処理方法を指示します。  <xref:System.Printing.PrintCapabilities> クラスは、プリンターの機能を定義します。  プリンターの機能のクエリを実行すると、プリンターのサポート機能を最大限に活用する <xref:System.Printing.PrintTicket> を作成できます。  同様に、サポートされていない機能を回避できます。  
+  
+ 次の例は、プリンターの <xref:System.Printing.PrintCapabilities> でクエリを実行する方法と、コードを使用した <xref:System.Printing.PrintTicket> の作成方法を示しています。  
+  
+ [!code-cpp[xpscreate#PrinterCapabilities](../../../../samples/snippets/cpp/VS_Snippets_Wpf/XpsCreate/CPP/XpsCreate.cpp#printercapabilities)]
+ [!code-csharp[xpscreate#PrinterCapabilities](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XpsCreate/CSharp/XpsCreate.cs#printercapabilities)]
+ [!code-vb[xpscreate#PrinterCapabilities](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XpsCreate/visualbasic/xpscreate.vb#printercapabilities)]  
+  
+#### PrintServer と PrintQueue  
+ <xref:System.Printing.PrintServer> クラスはネットワーク プリント サーバーを表し、<xref:System.Printing.PrintQueue> クラスはプリンターとそれに関連付けられた出力ジョブのキューを表します。  これらの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を併用すると、サーバーの印刷ジョブを高度に管理できます。  <xref:System.Printing.PrintServer>、またはその派生クラスのいずれかを使用すると、<xref:System.Printing.PrintQueue> を管理できます。  新しい印刷ジョブをキューに挿入するには、<xref:System.Printing.PrintQueue.AddJob%2A> メソッドを使用します。  
+  
+ 次の例は、コードを使用して <xref:System.Printing.LocalPrintServer> を作成し、既定の <xref:System.Printing.PrintQueue> にアクセスする方法を示しています。  
+  
+ [!code-csharp[xpsprint#PrintQueueSnip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XpsPrint/CSharp/XpsPrintHelper.cs#printqueuesnip)]
+ [!code-vb[xpsprint#PrintQueueSnip](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XpsPrint/visualbasic/xpsprinthelper.vb#printqueuesnip)]  
+  
+#### XpsDocumentWriter  
+ <xref:System.Windows.Xps.XpsDocumentWriter> を \(その多くの <xref:System.Windows.Xps.XpsDocumentWriter.Write%2A> メソッドおよび <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A> メソッドと共に\) 使用すると、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントを <xref:System.Printing.PrintQueue> に書き込むことができます。  たとえば、<xref:System.Windows.Xps.XpsDocumentWriter.Write%28System.Windows.Documents.FixedPage%2CSystem.Printing.PrintTicket%29> メソッドを使用すると、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントと <xref:System.Printing.PrintTicket> を同期的に出力できます。  <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%28System.Windows.Documents.FixedDocument%2CSystem.Printing.PrintTicket%29> メソッドを使用すると、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントと <xref:System.Printing.PrintTicket> を非同期的に出力できます。  
+  
+ 次の例は、コードを使用して <xref:System.Windows.Xps.XpsDocumentWriter> を作成する方法を示しています。  
+  
+ [!code-csharp[XpsPrint#PrintQueueSnip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XpsPrint/CSharp/XpsPrintHelper.cs#printqueuesnip)]
+ [!code-vb[XpsPrint#PrintQueueSnip](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XpsPrint/visualbasic/xpsprinthelper.vb#printqueuesnip)]  
+  
+ さらに <xref:System.Printing.PrintQueue.AddJob%2A> メソッドは印刷方法を提供します。  「[XPS ファイルをプログラムにより印刷する](../../../../docs/framework/wpf/advanced/how-to-programmatically-print-xps-files.md)」を参照してください。  詳細について。  
+  
+<a name="GDI_Print_Path_intro"></a>   
+## GDI 印刷パス  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションはネイティブに [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスをサポートします。一方、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーションも一部の [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の機能を活用できます。  [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) は、[!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] ベースの出力を [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 形式に変換できます。  高度なシナリオ用に、[Microsoft XPS Document Converter プリンター エスケープ](_win32_MXDC_ESCAPE)を使用した、コンテンツのカスタムの変換がサポートされています。  同様に、 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは、<xref:System.Windows.Xps.XpsDocumentWriter> クラスの <xref:System.Windows.Xps.XpsDocumentWriter.Write%2A> メソッドまたは <xref:System.Windows.Xps.XpsDocumentWriter.WriteAsync%2A> メソッドのいずれかを呼び出し、対象の印刷キューとして XpsDrv 以外のプリンターを指定することにより、[!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 印刷パスに出力することもできます。  
+  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の機能またはサポートを必要としないアプリケーションでは、現在の [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 印刷パスは変更されません。  
+  
+-   [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] 印刷パスとさまざまな [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] の変換オプションに関するその他の関連資料については、「[Microsoft XPS Document Converter プリンター エスケープ](_win32_MXDC_ESCAPE)」および「[Microsoft API とリファレンスのカタログ](http://msdn.microsoft.com/library/default.asp?url=/library/dnanchor/html/DeviceDriver.asp)」にある "XPSDrv" を参照してください。  
+  
+<a name="XPS_Driver_Model_intro"></a>   
+## XPSDrv ドライバー モデル  
+ [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスでは、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 対応のプリンターまたはドライバーに出力する場合に、ネイティブの印刷スプール形式として [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] を使用すると、スプーラの効率性が高まります。  スプール処理の簡略化により、ドキュメントをスプールする前に、[!INCLUDE[TLA2#tla_emf](../../../../includes/tla2sharptla-emf-md.md)] データ ファイルなどの中間スプール ファイルを生成する必要がなくなります。  スプール ファイルのサイズを小さくすると、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] 印刷パスのネットワーク トラフィックが減少し、印刷のパフォーマンスが向上します。  
+  
+ [!INCLUDE[TLA2#tla_emf](../../../../includes/tla2sharptla-emf-md.md)] は、サービスのレンダリングのために、アプリケーションの出力を [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] に対する一連の呼び出しとして表すクローズ形式です。  [!INCLUDE[TLA2#tla_emf](../../../../includes/tla2sharptla-emf-md.md)] と異なり、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] スプール形式では、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ベースのプリンター ドライバー \(XPSDrv\) に出力する際、さらに解釈する必要なく、実際のドキュメントを表します。  ドライバーは、その形式のデータを直接操作できます。  この機能により、[!INCLUDE[TLA2#tla_emf](../../../../includes/tla2sharptla-emf-md.md)] ファイルと [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] ベースの印刷ドライバーを使用する際の、データと色空間の変換が必要なくなります。  
+  
+ 同等の [!INCLUDE[TLA2#tla_emf](../../../../includes/tla2sharptla-emf-md.md)] と比較すると、[!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] プリンター ドライバー \(XPSDrv\) を対象とする [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントを使用する際、通常はスプール ファイルのサイズが減少します。ただし、例外もあります。  
+  
+-   ベクター グラフィックが非常に複雑で、複数の階層があるか、非効率的に記述されている場合、同じグラフィックスのビットマップ形式のバージョンよりもサイズが大きくなることがあります。  
+  
+-   画面表示の目的で、XPS ファイルにはデバイス フォントおよびコンピューター ベースのフォントが埋め込まれます。一方、GDI のスプール ファイルにはデバイス フォントは埋め込まれません。  しかし、両方の種類のフォントがサブセット化されているため \(下記参照\)、プリンター ドライバーは、ファイルをプリンターに送信する前にデバイス フォントを削除することができます。  
+  
+ スプール サイズの削減は、いくつかのメカニズムを通じて行われます。  
+  
+-   **フォントのサブセット化**。  実際のドキュメント内で使用される文字のみが [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ファイルに格納されます。  
+  
+-   **高度なグラフィックスのサポート**。  透過性とグラデーションのプリミティブのネイティブ サポートにより、[!INCLUDE[TLA2#tla_xps](../../../../includes/tla2sharptla-xps-md.md)] ドキュメントの内容のラスタライズを回避できます。  
+  
+-   **共通のリソースの識別**。  複数回使用するリソース \(会社のロゴを表す画像など\) は共有リソースとして扱われ、一度だけ読み込まれます。  
+  
+-   **ZIP 圧縮**。  すべての [!INCLUDE[TLA2#tla_metro](../../../../includes/tla2sharptla-metro-md.md)] ドキュメントで ZIP 圧縮を使用します。  
+  
+## 参照  
+ <xref:System.Windows.Controls.PrintDialog>   
+ <xref:System.Windows.Xps.XpsDocumentWriter>   
+ <xref:System.Windows.Xps.Packaging.XpsDocument>   
+ <xref:System.Printing.PrintTicket>   
+ <xref:System.Printing.PrintCapabilities>   
+ <xref:System.Printing.PrintServer>   
+ <xref:System.Printing.PrintQueue>   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/printing-how-to-topics.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [XPS](http://www.microsoft.com/xps)   
+ [ドキュメントのシリアル化および保存](../../../../docs/framework/wpf/advanced/document-serialization-and-storage.md)   
+ [Microsoft XPS Document Converter プリンター エスケープ](_win32_MXDC_ESCAPE)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/properties-how-to-topics.md b/docs/framework/wpf/advanced/properties-how-to-topics.md
new file mode 100644
index 00000000000..c6c832a7b26
--- /dev/null
+++ b/docs/framework/wpf/advanced/properties-how-to-topics.md
@@ -0,0 +1,42 @@
+---
+title: "プロパティに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "依存関係プロパティ"
+  - "プロパティ, 依存関係"
+  - "プロパティ, 方法トピック"
+ms.assetid: e16dd710-1530-4462-81a2-43719b973970
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# プロパティに関する「方法」トピック
+## このセクションの内容  
+ [依存関係プロパティを実装する](../../../../docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md)  
+ [依存関係プロパティの所有者の種類を追加する](../../../../docs/framework/wpf/advanced/how-to-add-an-owner-type-for-a-dependency-property.md)  
+ [添付プロパティを登録する](../../../../docs/framework/wpf/advanced/how-to-register-an-attached-property.md)  
+ [依存関係プロパティのメタデータをオーバーライドする](../../../../docs/framework/wpf/advanced/how-to-override-metadata-for-a-dependency-property.md)  
+  
+## 関連項目  
+ <xref:System.Windows.DependencyProperty>  
+  
+ <xref:System.Windows.PropertyMetadata>  
+  
+ <xref:System.Windows.FrameworkPropertyMetadata>  
+  
+ <xref:System.Windows.DependencyObject>  
+  
+## 関連項目  
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/properties-wpf.md b/docs/framework/wpf/advanced/properties-wpf.md
new file mode 100644
index 00000000000..8a747ba7987
--- /dev/null
+++ b/docs/framework/wpf/advanced/properties-wpf.md
@@ -0,0 +1,63 @@
+---
+title: "プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "プロパティ [WPF]"
+  - "プロパティ [WPF], プロパティの概要"
+  - "Windows Presentation Foundation, プロパティ"
+  - "WPF, プロパティ"
+ms.assetid: d6e0197f-f2c4-48ed-b45b-b9cdb64aab1c
+caps.latest.revision: 72
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 71
+---
+# プロパティ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティの機能を拡張するために使用できる一連のサービスが用意されています。  通常、これらのサービスをまとめて WPF プロパティ システムと呼びます。  [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] プロパティ システムによってサポートされるプロパティは、[依存関係プロパティ](GTMT)として知られています。  
+  
+## このセクションの内容  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)  
+ [添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)  
+ [依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)  
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)  
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)  
+ [フレームワーク プロパティ メタデータ](../../../../docs/framework/wpf/advanced/framework-property-metadata.md)  
+ [依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)  
+ [読み取り専用の依存関係プロパティ](../../../../docs/framework/wpf/advanced/read-only-dependency-properties.md)  
+ [プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)  
+ [依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)  
+ [DependencyObject の安全なコンストラクター パターン](../../../../docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md)  
+ [コレクション型依存関係プロパティ](../../../../docs/framework/wpf/advanced/collection-type-dependency-properties.md)  
+ [XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/properties-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.DependencyProperty>  
+  
+ <xref:System.Windows.PropertyMetadata>  
+  
+ <xref:System.Windows.FrameworkPropertyMetadata>  
+  
+ <xref:System.Windows.DependencyObject>  
+  
+## 関連項目  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [WPF の XAML](../../../../docs/framework/wpf/advanced/xaml-in-wpf.md)  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)  
+ [要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)  
+ [イベント](../../../../docs/framework/wpf/advanced/events-wpf.md)  
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)  
+ [リソース](../../../../docs/framework/wpf/advanced/resources-wpf.md)  
+ [WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)  
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/property-change-events.md b/docs/framework/wpf/advanced/property-change-events.md
new file mode 100644
index 00000000000..4dc00db5c9b
--- /dev/null
+++ b/docs/framework/wpf/advanced/property-change-events.md
@@ -0,0 +1,73 @@
+---
+title: "プロパティ変更イベント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変更イベント [WPF], プロパティ"
+  - "作成 (プロパティ トリガーを) [WPF]"
+  - "依存関係プロパティ [WPF], 変更イベント"
+  - "イベント [WPF], プロパティ値の変更"
+  - "識別 (プロパティ変更イベントを) [WPF]"
+  - "プロパティ変更イベント [WPF]"
+  - "プロパティ変更イベント [WPF], 型"
+  - "プロパティ トリガー [WPF]"
+  - "プロパティ トリガー [WPF], 定義"
+  - "プロパティ値の変更 [WPF]"
+ms.assetid: 0a7989df-9674-4cc1-bc50-5d8ef5d9c055
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# プロパティ変更イベント
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、プロパティ値の変更に応答して発生するさまざまなイベントが定義されています。  通常、プロパティは[依存関係プロパティ](GTMT)です。  イベント自体は、[ルーティング イベント](GTMT)のこともあれば、標準の [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] イベントのこともあります。  要素ツリーを通じて適切にルーティングされるプロパティ変更もあれば、プロパティが変更されたオブジェクトにのみ関係するプロパティ変更もあるため、イベントの定義は状況によって異なります。  
+  
+## プロパティ変更イベントの識別  
+ シグニチャ パターンまたは名前付けパターンに基づいてプロパティ変更を報告するすべてのイベントが、プロパティ変更イベントとして明示的に識別されるわけではありません。  通常、[!INCLUDE[TLA#tla_sdk](../../../../includes/tlasharptla-sdk-md.md)] ドキュメント内のイベントの説明では、イベントがプロパティ値の変更に直接結び付くものであるかどうかが示されており、プロパティとイベントのクロス リファレンスが提供されます。  
+  
+### RoutedPropertyChanged イベント  
+ 特定のイベントでは、プロパティ変更イベントで明示的に使用されるイベント データ型とデリゲートを使用します。  イベント データ型は <xref:System.Windows.RoutedPropertyChangedEventArgs%601> であり、デリゲートは <xref:System.Windows.RoutedPropertyChangedEventHandler%601> です。  イベント データもデリゲートも、ジェネリック型パラメーターを使用します。これは、ハンドラーを定義するときに、変更するプロパティの実際の型を指定するために使用されるものです。  イベント データは <xref:System.Windows.RoutedPropertyChangedEventArgs%601.OldValue%2A> および <xref:System.Windows.RoutedPropertyChangedEventArgs%601.NewValue%2A> という 2 つのプロパティを持ち、これらはイベント データ内で型引数として渡されます。  
+  
+ 名前の "Routed" 部分は、プロパティ変更イベントがルーティング イベントして登録されることを示しています。  プロパティ変更イベントのルーティングには、子要素 \(コントロールの複合部分\) のプロパティが値を変更した場合に、コントロールのトップレベルがプロパティ変更イベントを受信できるというメリットがあります。  たとえば、<xref:System.Windows.Controls.Slider> など、<xref:System.Windows.Controls.Primitives.RangeBase> コントロールが組み込まれたコントロールを作成するとします。  スライダー部分で <xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> プロパティの値が変わった場合、その部分ではなく親コントロールでその変更を処理する必要がある場合があります。  
+  
+ 古い値と新しい値があるため、このイベント ハンドラーがプロパティ値の検証コントロールとして使用される可能性があります。  しかし、プロパティ変更イベントの多くは、このような目的で設計されているわけではありません。  通常、値の提供は、他のロジックのコードでその値を処理するために行われます。しかし、イベント ハンドラー内から値を実際に変更することはお勧めできません。また、ハンドラーの実装方法によっては、意図しない再帰が生じることもあります。  
+  
+ プロパティがカスタム依存関係プロパティの場合、または、インスタンス化コードを定義した派生クラスで操作している場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムには、プロパティ変更を追跡する優れたメカニズムが組み込まれています。それは、<xref:System.Windows.CoerceValueCallback> および <xref:System.Windows.PropertyChangedCallback> というプロパティ システム コールバックです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムを使用して検証および強制型変換を行う方法の詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」および「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+### DependencyPropertyChanged イベント  
+ プロパティ変更イベントのシナリオには、<xref:System.Windows.DependencyPropertyChangedEventArgs> と <xref:System.Windows.DependencyPropertyChangedEventHandler> のペアも含まれます。  これらのプロパティ変更のイベントはルーティングされません。これらは、標準の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントです。  <xref:System.Windows.DependencyPropertyChangedEventArgs> は、<xref:System.EventArgs> から派生したものではなく、特殊なイベント データ レポート型です。<xref:System.Windows.DependencyPropertyChangedEventArgs> は構造体であり、クラスではありません。  
+  
+ <xref:System.Windows.DependencyPropertyChangedEventArgs> と <xref:System.Windows.DependencyPropertyChangedEventHandler> を使用するイベントは、`RoutedPropertyChanged` イベントより多少一般的です。  <xref:System.Windows.UIElement.IsMouseCapturedChanged> は、これらの種類を使用するイベントの例です。  
+  
+ <xref:System.Windows.RoutedPropertyChangedEventArgs%601> と同様、<xref:System.Windows.DependencyPropertyChangedEventArgs> も、プロパティの古い値と新しい値を報告します。  そのため、値を使用して行う操作に関して同じ注意が当てはまります。イベントに応答して送信元で値を変更することは、一般的にはお勧めできません。  
+  
+## プロパティ トリガー  
+ プロパティ変更イベントに密接に関係する概念がプロパティ トリガーです。  プロパティ トリガーはスタイルまたはテンプレート内に作成され、プロパティ トリガーが割り当てられるプロパティの値に基づく条件付きの動作を作成できます。  
+  
+ プロパティ トリガーのプロパティは、依存関係プロパティです。  これは \(多くの場合\) 読み取り専用の依存関係プロパティです。  コントロールによって公開される依存関係プロパティが、プロパティ トリガーになるように少なくとも部分的に設計されている場合の良い指標が、プロパティ名の先頭が "Is" がどうかということです。  この名前付けがされたプロパティは、多くの場合、読み取り専用のブール型の依存関係プロパティです。このプロパティの主要なシナリオは、リアルタイム UI に影響を及ぼす可能性があるためにプロパティ トリガーの候補である、レポート コントロール ステートです。  
+  
+ これらのプロパティの一部は、専用のプロパティ変更イベントも持ちます。  たとえば、プロパティ <xref:System.Windows.UIElement.IsMouseCaptured%2A> は、プロパティ変更イベント <xref:System.Windows.UIElement.IsMouseCapturedChanged> を持ちます。  プロパティ自体は読み取り専用であり、その値は入力システムによって調整され、入力システムがリアルタイムの変更のたびに <xref:System.Windows.UIElement.IsMouseCapturedChanged> を発生します。  
+  
+ プロパティ トリガーを使用してプロパティの変更に対処する場合は、本当のプロパティ変更イベントに比べ、いくつかの制限があります。  
+  
+ プロパティ トリガーは、完全一致ロジックを通じて動作します。  プロパティと、トリガーが処理する特定の値を示す値を指定します。  次に例を示します。`<Setter Property="IsMouseCaptured" Value="true"> ... </Setter>` この制限のため、ほとんどのプロパティ トリガーの使用は、ブール型のプロパティか、有効な値の範囲が管理可能で、各ケースに対してトリガーを定義できる専用の列挙値を使用するプロパティが対象です。  または、プロパティ トリガーは、項目のカウントがゼロに達した場合など、特別な値に対してのみ存在する可能性があります。プロパティ値がゼロから再び変更するケースに対処するトリガーはありません \(すべてのケースに対応するトリガーではなく、コード イベント ハンドラー、または、値がゼロ以外のときにトリガー状態を再び元に戻す既定の動作が必要です\)。  
+  
+ プロパティ トリガーの構文は、プログラミングの "if" ステートメントに似ています。  トリガー条件が true の場合、プロパティ トリガーの "本体" が "実行" されます。  プロパティ トリガーの "本体" はコードではなく、マークアップです。  そのマークアップは、1 つ以上の <xref:System.Windows.Setter> 要素を使用して、スタイルやテンプレートが適用されているオブジェクトの他のプロパティを設定するように制限されています。  
+  
+ さまざまな有効値から成るプロパティ トリガーの "if" 条件をオフセットするには、一般には、<xref:System.Windows.Setter> を使用して同じプロパティ値を既定値に設定することをお勧めします。  こうすることで、トリガー条件が true の場合は、<xref:System.Windows.Trigger> が含む setter が優先され、トリガー条件が false の場合は、<xref:System.Windows.Trigger> 内にない <xref:System.Windows.Setter> が優先されます。  
+  
+ プロパティ トリガーは、通常、1 つ以上の外観プロパティが、同じ要素の別のプロパティの状態に基づいて変更されるシナリオに適しています。  
+  
+ プロパティ トリガーの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+## 参照  
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/property-value-inheritance.md b/docs/framework/wpf/advanced/property-value-inheritance.md
new file mode 100644
index 00000000000..70cf3dcc8d8
--- /dev/null
+++ b/docs/framework/wpf/advanced/property-value-inheritance.md
@@ -0,0 +1,54 @@
+---
+title: "プロパティ値の継承 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "継承, プロパティ値"
+  - "プロパティ, 値の継承"
+  - "値の継承"
+ms.assetid: d7c338f9-f2bf-48ed-832c-7be58ac390e4
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# プロパティ値の継承
+プロパティ値の継承は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] プロパティ システムの機能です。  プロパティ値の継承により、要素のツリー内の子要素は、親要素から特定のプロパティの値を取得できます。これは、最も近い親要素のいずれかにこのプロパティ値が既に設定されているため、その値を継承することで行われます。  親要素もプロパティ値の継承を通じてその値を取得している場合があるため、システムはページ ルートまで再帰している可能性があります。  プロパティ値の継承は、プロパティ システムの既定の動作ではありません。あるプロパティに子要素でのプロパティ値の継承を実行させるには、そのプロパティに特定のメタデータを設定する必要があります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Property_Value_Inheritance_is_Containment_Inheritance"></a>   
+## プロパティ値の継承は包含継承である  
+ ここで言う "継承" は、型や一般的なオブジェクト指向プログラミングのコンテキストにおける継承 \(派生クラスがその基本クラスからメンバー定義を継承する\) とは若干異なる概念です。  この一般的な意味での継承は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でも使用されます。さまざまな基本クラスで定義されたプロパティは、要素として使用される場合の派生 [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] クラスの属性として、およびコードのメンバーとして公開されます。  プロパティ値の継承は、要素のツリー内の親子のリレーションシップに基づいて、ある要素から別の要素にプロパティ値が継承されるしくみに特に関連します。  要素のツリーが最も直接的に認識されるのは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップでアプリケーションを定義する際にさまざまな要素を別の要素内に入れ子にする場合です。  オブジェクトのツリーはプログラムで作成することもできます。これを行うには、指定したオブジェクトのコレクションに別のオブジェクトを追加します。完成したツリーでも、実行時にプロパティ値の継承が同様に動作します。  
+  
+<a name="Practical_Applications_of_Property_Value_Inheritance"></a>   
+## プロパティ値の継承を実際に適用する  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] には、プロパティの継承が有効なプロパティがいくつか含まれています。  これらのプロパティの一般的なシナリオは次のとおりです。これらのプロパティは、ページごとに一度だけ設定するのが適していますが、いずれかの基本要素クラスのメンバーでもあるため、ほとんどの子要素にも存在することになります。  たとえば、<xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティは、フロー コンテンツをページ上に表示および配置する方向を制御します。  通常、テキスト フローの概念は、すべての子要素で一貫して処理される必要があります。  要素ツリーのあるレベルにおいて、何らかの理由でユーザーまたは環境の操作によってフロー方向がリセットされた場合は、一般に要素全体でリセットする必要があります。  <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティを継承すると、アプリケーション内の各ページの表示ニーズをすべて含む要素ツリー内のレベルで、値を 1 回設定またはリセットするだけで済むようになります。  初期既定値さえも同様の方法で値を継承します。  プロパティ値の継承モデルでは、要素の値を個別にリセットすることもできます。これは、複数のフロー方向の混在を意図したまれなケースに対応するためです。  
+  
+<a name="Making_a_Custom_Property_Inheritable"></a>   
+## カスタム プロパティを継承可能にする  
+ カスタム プロパティのメタデータを変更することで、独自のカスタム プロパティを継承可能にすることもできます。  ただし、プロパティを継承可能にする場合は、パフォーマンスについて考慮する必要があります。  ローカル値や、スタイル、テンプレート、またはデータ バインディングから取得した値がそのプロパティに設定されていない場合、継承可能なプロパティは、それ自身に割り当てられた値を論理ツリー内のすべての子要素に提供します。  
+  
+ プロパティを値の継承に参加させるには、「[添付プロパティを登録する](../../../../docs/framework/wpf/advanced/how-to-register-an-attached-property.md)」の説明に従ってカスタム添付プロパティを作成します。  メタデータ \(<xref:System.Windows.FrameworkPropertyMetadata>\) を指定してプロパティを登録し、そのメタデータ内のオプション設定で "継承" オプションを指定します。  また、値が継承されるようになったため、プロパティに既定値が設定されていることも確認します。  プロパティを添付プロパティとして登録しましたが、"非添付" の[依存関係プロパティ](GTMT)の場合と同様に、所有者型で get アクセスおよび set アクセスのプロパティ "ラッパー" を作成することもできます。  これにより、所有者型または派生型で直接プロパティ ラッパーを使用して、または、<xref:System.Windows.DependencyObject> で添付プロパティ構文を使用して、継承可能なプロパティを設定できます。  
+  
+ 添付プロパティは概念的にはグローバル プロパティに似ており、任意の <xref:System.Windows.DependencyObject> の値をチェックし、有効な結果を取得できます。  添付プロパティの典型的なシナリオとして、子要素のプロパティ値を設定する場合があります。このシナリオは、該当のプロパティが、ツリー内の各要素 \(<xref:System.Windows.DependencyObject>\) の添付プロパティとして常に暗黙的に存在する添付プロパティの場合に、さらに効果的です。  
+  
+> [!NOTE]
+>  プロパティ値の継承は、非添付依存関係プロパティのために機能しているように見えることがありますが、ランタイム ツリーでの特定の要素の境界を介する非添付プロパティの継承動作は定義されていません。  メタデータで <xref:System.Windows.FrameworkPropertyMetadata.Inherits%2A> を指定した場合は、必ず <xref:System.Windows.DependencyProperty.RegisterAttached%2A> を使用してプロパティを登録します。  
+  
+<a name="InheritanceContext"></a>   
+## ツリー境界を越えてプロパティ値を継承する  
+ プロパティの継承は、要素のツリーを走査して行われます。  多くの場合、このツリーは論理ツリーに対応します。  しかし、要素ツリーを定義するマークアップ内に、<xref:System.Windows.Media.Brush> など、[WPF コア レベル](GTMT)のオブジェクトを含めると、連続しない論理ツリーが作成されます。  論理ツリーは [WPF フレームワーク レベル](GTMT)の概念であるため、本当の論理ツリーは、<xref:System.Windows.Media.Brush> を通じて概念的に拡張されません。  <xref:System.Windows.LogicalTreeHelper> のメソッドを使用すると、これが反映された結果を確認できます。  ただし、継承可能なプロパティが添付プロパティとして登録されており、意図的な継承ブロッキング境界 \(<xref:System.Windows.Controls.Frame> など\) がない限り、プロパティ値の継承は、論理ツリー内のこのギャップを埋めることができ、継承された値を渡すことができます。  
+  
+## 参照  
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)   
+ [添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)   
+ [依存関係プロパティ値の優先順位](../../../../docs/framework/wpf/advanced/dependency-property-value-precedence.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/propertypath-xaml-syntax.md b/docs/framework/wpf/advanced/propertypath-xaml-syntax.md
new file mode 100644
index 00000000000..b6b10439b40
--- /dev/null
+++ b/docs/framework/wpf/advanced/propertypath-xaml-syntax.md
@@ -0,0 +1,210 @@
+---
+title: "PropertyPath の XAML 構文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PropertyPath オブジェクト"
+  - "XAML, PropertyPath オブジェクト"
+ms.assetid: 0e3cdf07-abe6-460a-a9af-3764b4fd707f
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# PropertyPath の XAML 構文
+<xref:System.Windows.PropertyPath> オブジェクトは、<xref:System.Windows.PropertyPath> 型を値として使用する各種プロパティを設定するうえで、複雑な [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] インライン構文をサポートします。  このトピックでは、バインディング構文とアニメーション構文に適用される <xref:System.Windows.PropertyPath> 構文について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="where"></a>   
+## PropertyPath を使用する場所  
+ <xref:System.Windows.PropertyPath> は、さまざまな [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 機能で使用される共通のオブジェクトです。  共通の <xref:System.Windows.PropertyPath> を使用してプロパティ パス情報を伝えるにもかかわらず、<xref:System.Windows.PropertyPath> を型として使用する各機能の使用法はそれぞれ異なります。  そのため、機能ごとに構文を説明する方が実際的です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は主に、<xref:System.Windows.PropertyPath> を使用して、オブジェクト データ ソースのプロパティを走査するオブジェクト モデル パスを記述し、ターゲット アニメーションのターゲット パスを記述します。  
+  
+ <xref:System.Windows.Setter.Property%2A?displayProperty=fullName> など一部のスタイル プロパティやテンプレート プロパティでは、一見すると <xref:System.Windows.PropertyPath> と似ているプロパティの修飾名が使用されます。  しかし、これは実際の <xref:System.Windows.PropertyPath> ではなく、<xref:System.Windows.DependencyProperty> の型コンバーターと組み合わせて WPF [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサで有効化される、*owner.property* の修飾文字列形式の使用法です。  
+  
+<a name="databinding_s"></a>   
+## データ バインディングにおけるオブジェクトの PropertyPath  
+ データ バインディングは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の機能であり、[依存関係プロパティ](GTMT)のターゲット値にバインドできます。  ただし、このようなデータ バインディングのソースが[依存関係プロパティ](GTMT)である必要はなく、適切なデータ プロバイダーで認識される任意のプロパティ型でかまいません。  プロパティ パスは特に <xref:System.Windows.Data.ObjectDataProvider> で使用され、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトのバインディング ソースとそのプロパティを取得するのに使用されます。  
+  
+ [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] へのデータ バインディングでは、<xref:System.Windows.PropertyPath> が使用されないことに注意してください。これは、<xref:System.Windows.Data.Binding> 内で <xref:System.Windows.Data.Binding.Path%2A> を使用しないためです。  代わりに、<xref:System.Windows.Data.Binding.XPath%2A> を使用して、有効な XPath 構文をデータの [!INCLUDE[TLA#tla_xmldom](../../../../includes/tlasharptla-xmldom-md.md)] に指定します。  <xref:System.Windows.Data.Binding.XPath%2A> も文字列として指定されますが、ここでは説明しません。「[XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)」を参照してください。  
+  
+ データ バインディングにおけるプロパティ パスを理解するうえで鍵となるのは、個々のプロパティ値をバインドの対象にすることも、リストまたはコレクションを使用するターゲット プロパティにバインドすることもできるということです。  コレクションをバインドする場合 \(コレクション内のデータ項目の数に応じて拡張される <xref:System.Windows.Controls.ListBox> をバインドする場合など\)、プロパティ パスは個々のコレクション項目を参照するのではなく、コレクション オブジェクトを参照する必要があります。  データ バインディング エンジンは、データ ソースとして使用されるコレクションをバインディング ターゲットの型に自動的に一致させます。その結果、<xref:System.Windows.Controls.ListBox> への項目配列の読み込みなどの処理が行われます。  
+  
+<a name="singlecurrent"></a>   
+### データ コンテキストとしての直接のオブジェクト上の単一のプロパティ  
+  
+```  
+<Binding Path="propertyName" .../>  
+```  
+  
+ *propertyName* は、<xref:System.Windows.Data.Binding.Path%2A> の使用に対して、現在の <xref:System.Windows.FrameworkElement.DataContext%2A> 内にあるプロパティの名前に解決される必要があります。  バインディングがソースを更新する場合、そのプロパティは読み書き可能であり、ソース オブジェクトは変更可能である必要があります。  
+  
+<a name="singleindex"></a>   
+### データ コンテキストとしての直接のオブジェクト上の単一のインデクサー  
+  
+```  
+<Binding Path="[key]" .../>  
+```  
+  
+ `key` には、ディクショナリまたはハッシュ テーブルの型指定されたインデックス、または配列の整数インデックスを指定する必要があります。  また、キーの値は、適用先のプロパティに直接バインドできる型である必要があります。  たとえば、文字列キーと文字列値が含まれるハッシュ テーブルをこのように使用することで、<xref:System.Windows.Controls.TextBox> の Text にバインドできます。  キーがコレクションまたはサブインデックスを指す場合は、この構文を使用して、ターゲット コレクション プロパティにバインドできます。  それ以外の場合は、`<Binding Path="[``key``].``propertyName``" .../>` などの構文を通じて、特定のプロパティを参照する必要があります。  
+  
+ 必要に応じて、インデックスの型を指定できます。  インデックス付きプロパティ パスのこの特徴の詳細については、「<xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName>」を参照してください。  
+  
+<a name="multipleindirect"></a>   
+### 複数プロパティ \(間接的なプロパティの対象化\)  
+  
+```  
+<Binding Path="propertyName.propertyName2" .../>  
+```  
+  
+ `propertyName` は、現在の <xref:System.Windows.FrameworkElement.DataContext%2A> であるプロパティの名前に解決される必要があります。  パス プロパティ `propertyName` および `propertyName2` は、リレーションシップ内に存在する任意のプロパティにすることができます。`propertyName2` は、`propertyName` の値である型に存在するプロパティです。  
+  
+<a name="singleattached"></a>   
+### 添付または型修飾された単一のプロパティ  
+  
+```  
+<object property="(ownerType.propertyName)" .../>  
+```  
+  
+ かっこは、<xref:System.Windows.PropertyPath> 内のこのプロパティを、部分修飾を使用して構築する必要があることを示します。  XML 名前空間を使用して、適切なマッピングを含む型を検出できます。  `ownerType` は、各アセンブリ内の <xref:System.Windows.Markup.XmlnsDefinitionAttribute> 宣言を通じて、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサがアクセスできる型を検索します。  ほとんどのアプリケーションは、[!INCLUDE[TLA#tla_wpfxmlnsv1](../../../../includes/tlasharptla-wpfxmlnsv1-md.md)] 名前空間に対応付けられた既定の XML 名前空間を持ちます。そのため、プレフィックスは通常、カスタム型や、名前空間の外部の型に限って必要です。  `propertyName` は、`ownerType` に存在するプロパティの名前に解決される必要があります。  この構文は、通常、次のいずれかの場合に使用されます。  
+  
+-   指定されたターゲット型を持たないスタイルまたはテンプレート内の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でパスが指定されている場合。  通常、これ以外のケースでの修飾子の使用は無効です。スタイルやテンプレート以外のケースでは、プロパティは型ではなくインスタンス上に存在します。  
+  
+-   プロパティが添付プロパティの場合。  
+  
+-   静的プロパティにバインドしている場合。  
+  
+ ストーリーボード ターゲットとして使用する場合、`propertyName` として指定されるプロパティは、<xref:System.Windows.DependencyProperty> にする必要があります。  
+  
+<a name="sourcetraversal"></a>   
+### ソースの走査 \(コレクションの階層のバインディング\)  
+  
+```  
+<object Path="propertyName/propertyNameX" .../>  
+```  
+  
+ この構文内の \/ を使用して階層的なデータ ソース オブジェクト内を移動し、後続する \/ 文字で階層への複数ステップがサポートされます。  ソースの走査は現在のレコード ポインター位置に対応しており、これはデータをビューの UI と同期することによって決定されます。  階層的なデータ ソース オブジェクトのバインディング、およびデータ バインディングにおける現在のレコード ポインターの概念の詳細については、「[階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)」または「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  この構文は、一見すると [!INCLUDE[TLA2#tla_xpath](../../../../includes/tla2sharptla-xpath-md.md)] に似ています。  [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データ ソースにバインドするための実際の [!INCLUDE[TLA2#tla_xpath](../../../../includes/tla2sharptla-xpath-md.md)] 式は <xref:System.Windows.Data.Binding.Path%2A> 値としては使用されず、代わりに、同時には指定できない <xref:System.Windows.Data.Binding.XPath%2A> プロパティで使用される必要があります。  
+  
+### コレクション ビュー  
+ 名前付きコレクション ビューを参照するには、コレクション ビュー名の前にハッシュ記号 \(`#`\) を付けます。  
+  
+### 現在のレコード ポインター  
+ コレクション ビューまたはマスター詳細データ バインディング シナリオの現在のレコード ポインターを参照するには、パス文字列の先頭にスラッシュ \(`/`\) を追加します。  スラッシュより後ろのパスは、現在のレコード ポインターから開始して走査されます。  
+  
+### 複数のインデクサー  
+  
+```  
+<object Path="[index1,index2...]" .../>  
+or  
+<object Path="propertyName[index,index2...]" .../>  
+```  
+  
+ あるオブジェクトが複数のインデクサーをサポートする場合、そのインデクサーは、配列参照構文のように、順番に指定できます。  当該のオブジェクトは、現在のコンテキスト、または複数のインデクサー オブジェクトが含まれるプロパティの値です。  
+  
+ 既定では、インデクサー値は、基になるオブジェクトの特性を使用して型指定されます。  必要に応じて、インデックスの型を指定できます。  インデクサーの型指定の詳細については、「<xref:System.Windows.Data.Binding.Path%2A?displayProperty=fullName>」を参照してください。  
+  
+<a name="mixing"></a>   
+### 構文の混合  
+ 上記の各構文は、混在させることができます。  たとえば、<xref:System.Windows.Media.SolidColorBrush> オブジェクトのピクセル グリッド配列が含まれる、`ColorGrid` プロパティの特定の x、y にある色へのプロパティ パスを作成する例を次に示します。  
+  
+```  
+<Rectangle Fill="{Binding ColorGrid[20,30].SolidColorBrushResult}" .../>  
+```  
+  
+### プロパティ パス文字列のエスケープ  
+ 特定のビジネス オブジェクトでは、正しく解析するために、プロパティ パス文字列にエスケープ シーケンスが必要な場合があります。  このような文字の多くには、通常ビジネス オブジェクトを定義するために使用される言語において、名前付けの相互作用に関する同様の問題があるので、エスケープが必要になることはほとんどありません。  
+  
+-   インデクサー \(\[ \]\) 内では、キャレット文字 \(^\) は次の文字をエスケープします。  
+  
+-   XML 言語定義で特別な意味を持つ特定の文字を \(XML エンティティを使用して\) エスケープする必要があります。  文字 "&" をエスケープするには、`&` を使用します。  タグの終了を示す "\>" をエスケープするには、`>` を使用します。  
+  
+-   マークアップ拡張機能の処理に関する WPF XAML パーサーの動作で特別な意味を持つ文字を、\(バックスラッシュ `\` を使用して\) エスケープする必要があります。  
+  
+    -   バックスラッシュ \(`\`\) は、それ自体がエスケープ文字です。  
+  
+    -   等号 \(`=`\) は、プロパティ名とプロパティ値を区切ります。  
+  
+    -   コンマ \(`,`\) は、複数のプロパティを区切ります。  
+  
+    -   右中かっこ \(`}`\) は、マークアップ拡張機能の終了を示します。  
+  
+> [!NOTE]
+>  厳密に言うと、これらのエスケープはストーリーボードのプロパティ パスに役立ちますが、通常は既存の WPF オブジェクトのオブジェクト モデルを走査するので、エスケープは不要です。  
+  
+<a name="databinding_sa"></a>   
+## アニメーション ターゲットの PropertyPath  
+ アニメーションのターゲット プロパティは[依存関係プロパティ](GTMT)であり、<xref:System.Windows.Freezable> またはプリミティブ型を使用します。  ただし、型のターゲット プロパティと最終的なアニメーション プロパティは異なるオブジェクト上に存在できます。  アニメーションの場合は、プロパティ パスを使用して、プロパティ値内のオブジェクトとプロパティのリレーションシップを調べることによって、名前付きのアニメーション ターゲット オブジェクトのプロパティと目的のターゲット アニメーション プロパティの間の接続が定義されます。  
+  
+<a name="general"></a>   
+### アニメーションに関するオブジェクトとプロパティの一般的な注意事項  
+ 一般的なアニメーションの概念の詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」および「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ アニメーション化される値型またはプロパティは、<xref:System.Windows.Freezable> 型またはプリミティブである必要があります。  パスを開始するプロパティは、指定された <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> 型に存在する[依存関係プロパティ](GTMT)の名前に解決される必要があります。  
+  
+ 既にフリーズしている <xref:System.Windows.Freezable> のアニメーションの複製をサポートするには、<xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> が、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> 派生クラスである必要があります。  
+  
+<a name="singlestepanim"></a>   
+### ターゲット オブジェクト上の単一プロパティ  
+  
+```  
+<animation Storyboard.TargetProperty="propertyName" .../>  
+```  
+  
+ `propertyName` は、指定された <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> 型に存在する[依存関係プロパティ](GTMT)の名前に解決される必要があります。  
+  
+<a name="indirectanim"></a>   
+### 間接的なプロパティの対象化  
+  
+```  
+<animation Storyboard.TargetProperty="propertyName.propertyName2" .../>  
+```  
+  
+ `propertyName` は、指定された <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> 型に存在する、<xref:System.Windows.Freezable> 値型またはプリミティブのプロパティである必要があります。  
+  
+ `propertyName2` は、`propertyName` の値であるオブジェクトに存在する[依存関係プロパティ](GTMT)の名前に解決される必要があります。  言い換えると、`propertyName2` は、`propertyName` <xref:System.Windows.DependencyProperty.PropertyType%2A> 型の依存関係プロパティとして存在する必要があります。  
+  
+ 適用されるスタイルとテンプレートにより、アニメーションの間接的な対象化が必要です。  アニメーションを対象にするには、ターゲット オブジェクトの <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> が必要であり、その名前は [x:Name](../../../../docs/framework/xaml-services/x-name-directive.md) または <xref:System.Windows.FrameworkElement.Name%2A> によって設定されます。  テンプレート要素とスタイル要素にも名前を設定できますが、その名前は、スタイルとテンプレートの名前スコープ内でのみ有効です   \(テンプレートとスタイルがアプリケーション マークアップと名前スコープを共有していない場合、名前は一意ではありません。  スタイルとテンプレートはインスタンス間で完全に共有されており、重複する名前が永続化されます\)。このため、アニメーション化する要素の個々のプロパティがスタイルやテンプレートに基づく場合は、スタイル テンプレートに基づかない、名前付きの要素インスタンスで操作を開始し、スタイルまたはテンプレートのビジュアル ツリーに対象を移動し、アニメーション化する目的のプロパティにアクセスします。  
+  
+ たとえば、<xref:System.Windows.Controls.Panel> の <xref:System.Windows.Controls.Panel.Background%2A> プロパティは、テーマ テンプレートに基づく完全な <xref:System.Windows.Media.Brush> \(実際には <xref:System.Windows.Media.SolidColorBrush>\) です。  <xref:System.Windows.Media.Brush> を完全にアニメーション化するには、BrushAnimation \(多くの場合、<xref:System.Windows.Media.Brush> 型ごとに 1 つ\) であることが必要ですが、このような型はありません。  Brush をアニメーション化するには、代わりに、特定の <xref:System.Windows.Media.Brush> 型のプロパティをアニメーション化します。  <xref:System.Windows.Media.SolidColorBrush> からその <xref:System.Windows.Media.SolidColorBrush.Color%2A> までを取得して、<xref:System.Windows.Media.Animation.ColorAnimation> を適用します。  この例のプロパティ パスは `Background.Color` です。  
+  
+<a name="attachedanim"></a>   
+### 添付プロパティ  
+  
+```  
+<animation Storyboard.TargetProperty="(ownerType.propertyName)" .../>  
+```  
+  
+ かっこは、<xref:System.Windows.PropertyPath> 内のこのプロパティを、部分修飾を使用して構築する必要があることを示します。  XML 名前空間を使用して型を検出できます。  `ownerType` は、各アセンブリ内の <xref:System.Windows.Markup.XmlnsDefinitionAttribute> 宣言を通じて、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサがアクセスできる型を検索します。  ほとんどのアプリケーションは、[!INCLUDE[TLA#tla_wpfxmlnsv1](../../../../includes/tlasharptla-wpfxmlnsv1-md.md)] 名前空間に対応付けられた既定の XML 名前空間を持ちます。そのため、プレフィックスは通常、カスタム型や、名前空間の外部の型に限って必要です。  `propertyName` は、`ownerType` に存在するプロパティの名前に解決される必要があります。  `propertyName` として指定されるプロパティは、<xref:System.Windows.DependencyProperty> にする必要があります   \(すべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 添付プロパティは、依存関係プロパティとして実装されます。そのため、この問題は、カスタム添付プロパティにのみ関係します\)。  
+  
+<a name="indexanim"></a>   
+### インデクサー  
+  
+```  
+<animation Storyboard.TargetProperty="propertyName.propertyName2[index].propertyName3" .../>  
+```  
+  
+ ほとんどの依存関係プロパティまたは <xref:System.Windows.Freezable> 型は、インデクサーをサポートしていません。  そのため、アニメーション パス内でインデクサーを使用するのは、名前付きターゲット上でチェーンを開始するプロパティと、最終的にアニメーション化されるプロパティの間の中間位置に限られます。  提供される構文の中で、これは `propertyName2` です。  たとえば、`RenderTransform.Children[1].Angle` などのプロパティ パス内で、中間プロパティが <xref:System.Windows.Media.TransformGroup> などのコレクションの場合は、インデクサーの使用が必要になることがあります。  
+  
+<a name="ppincode"></a>   
+## コード内の PropertyPath  
+ <xref:System.Windows.PropertyPath> を構築する方法を含めて、<xref:System.Windows.PropertyPath> をコードで使用する方法については、<xref:System.Windows.PropertyPath> の参照トピックを参照してください。  
+  
+ 一般に、<xref:System.Windows.PropertyPath> は、バインディングでの使用と単純なアニメーションでの使用を目的とするコンストラクター、および複雑なアニメーションでの使用を目的とするコンストラクターの、2 種類のコンストラクターを使用するように設計されています。  オブジェクトが文字列であるバインディング使用の場合は、<xref:System.Windows.PropertyPath.%23ctor%28System.Object%29> シグネチャを使用します。  オブジェクトが <xref:System.Windows.DependencyProperty> である 1 ステップのアニメーション パスの場合は、<xref:System.Windows.PropertyPath.%23ctor%28System.Object%29> シグネチャを使用します。  複雑なアニメーションの場合は、[PropertyPath\(String, Object\<xref:System.Windows.PropertyPath.%23ctor%28System.String%2CSystem.Object%5B%5D%29> シグネチャを使用します。  後者のコンストラクターでは、先頭のパラメーター用のトークン文字列と、トークン文字列内の位置に設定されるオブジェクトの配列を使用して、プロパティ パスのリレーションシップを定義します。  
+  
+## 参照  
+ <xref:System.Windows.PropertyPath>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/read-only-dependency-properties.md b/docs/framework/wpf/advanced/read-only-dependency-properties.md
new file mode 100644
index 00000000000..3a2559e8a35
--- /dev/null
+++ b/docs/framework/wpf/advanced/read-only-dependency-properties.md
@@ -0,0 +1,56 @@
+---
+title: "読み取り専用の依存関係プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係プロパティ, 読み取り専用"
+  - "読み取り専用の依存関係プロパティ"
+ms.assetid: f23d6ec9-3780-4c09-a2ff-b2f0a2deddf1
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 読み取り専用の依存関係プロパティ
+ここでは、既存の読み取り専用依存関係プロパティ、カスタムの読み取り専用依存関係プロパティを作成するシナリオと手法など、読み取り専用依存関係プロパティについて説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、依存プロパティの実装の基本シナリオとカスタム依存プロパティへのメタデータの適用方法を理解していることを前提とします。  詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」および「[依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)」を参照してください。  
+  
+<a name="existing"></a>   
+## 既存の読み取り専用依存関係プロパティ  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] フレームワークで定義されている依存関係プロパティの一部は読み取り専用です。  読み取り専用依存関係プロパティを指定する一般的な理由は、状態決定に使用する必要のあるプロパティがあるけれども、その状態は多くの要因から影響を受け、プロパティをその状態に設定するだけでは、ユーザー インターフェイス設計の観点から望ましくないためです。  たとえば、<xref:System.Windows.UIElement.IsMouseOver%2A> プロパティは、実際にはマウス入力から決定される単なるサーフェイス状態です。  実際にマウス入力を行わずにプログラムでこの値を設定しようとすると、結果は予想できず、不整合が発生する可能性があります。  
+  
+ 設定可能ではないため、読み取り専用の依存関係プロパティは、依存関係プロパティがソリューションを通常提供するシナリオの多くには適切ではありません \(データ バインディング、直接スタイル設定可能な値、検証、アニメーション、継承など\)。  それでも、設定不可能な読み取り専用依存関係プロパティには、プロパティ システムの依存関係プロパティによってサポートされるいくつかの追加機能があります。  最も重要な機能は、読み取り専用依存関係プロパティはスタイルのプロパティ トリガーとして使用できることです。  通常の [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティではトリガーを有効にできません。依存関係プロパティであることが必要です。  上で挙げた <xref:System.Windows.UIElement.IsMouseOver%2A> プロパティは、コントロールのスタイルを定義するために便利なシナリオのよい例です。背景、前景、またはコントロール内の複合要素の同種のプロパティなどの一部の表示プロパティは、コントロールの定義済み領域にユーザーがマウスを置くと変化します。  読み取り専用依存関係プロパティの変化は、プロパティ システム固有の検証プロセスによって検出して報告することもでき、これは実際にはプロパティ トリガー機能を内部的にサポートします。  
+  
+<a name="new"></a>   
+## 読み取り専用のカスタム依存プロパティの作成  
+ 多くの一般的な依存関係プロパティのシナリオで読み取り専用依存関係プロパティが機能しない理由に関する前のセクションを参照してください。  ただし、適切なシナリオがある場合は、独自の読み取り専用依存関係プロパティを作成してもかまいません。  
+  
+ 読み取り専用依存関係プロパティを作成するプロセスのほとんどは、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」および「[依存関係プロパティを実装する](../../../../docs/framework/wpf/advanced/how-to-implement-a-dependency-property.md)」の説明と同じです。  ただし、次の 3 つの重要な違いがあります。  
+  
+-   プロパティを登録するときは、プロパティ登録用の通常の <xref:System.Windows.DependencyProperty.Register%2A> メソッドではなく、<xref:System.Windows.DependencyProperty.RegisterReadOnly%2A> メソッドを呼び出します。  
+  
+-   [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] の "ラッパー" プロパティを実装するときは、ラッパーにも set 実装をしないようにして、公開するパブリック ラッパーの読み取り専用状態が矛盾しないようにする必要があります。  
+  
+-   読み取り専用の登録によって返されるオブジェクトは、<xref:System.Windows.DependencyProperty> ではなく <xref:System.Windows.DependencyPropertyKey> です。  やはりこのフィールドをメンバーとして格納する必要がありますが、通常は、型のパブリック メンバーにはしません。  
+  
+ 読み取り専用依存関係プロパティを補足するために使用するプライベートのフィールドまたは値はすべて、適当なロジックを使用して完全に書き込み可能にしてかまいません。  ただし、初期化で、またはランタイム ロジックの一部として、プロパティを設定する最も簡単な方法は、プロパティ システムを使用しないでプライベートな補足フィールドを直接設定するのではなく、プロパティ システムの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を使用する方法です。  具体的には、<xref:System.Windows.DependencyPropertyKey> 型のパラメーターを受け取る <xref:System.Windows.DependencyObject.SetValue%2A> のシグネチャがあります。  アプリケーション ロジック内でプログラムによってこの値を設定する方法と場所により、依存関係プロパティを最初に登録したときに作成される <xref:System.Windows.DependencyPropertyKey> に対するアクセスの設定方法が影響を受けます。  このロジックすべてをクラス内で処理する場合はプライベートにでき、アセンブリの他の部分から設定する必要がある場合は内部に設定します。  1 つの方法は、格納されているプロパティ値の変更が必要であることをクラスのインスタンスに通知する関連イベントのクラス イベント ハンドラー内で、<xref:System.Windows.DependencyObject.SetValue%2A> を呼び出すというものです。  もう 1 つの方法は、登録の際にプロパティのメタデータの一部として、ペアになった <xref:System.Windows.PropertyChangedCallback> コールバックと <xref:System.Windows.CoerceValueCallback> コールバックを使用して、依存関係プロパティを結び付けるというものです。  
+  
+ <xref:System.Windows.DependencyPropertyKey> はプライベートであり、コードの外部のプロパティ システムによっては伝達されないので、読み取り専用依存関係プロパティの方が、読み取り\/書き込み依存関係プロパティより設定のセキュリティが優れています。  読み取り\/書き込み依存関係プロパティの場合は、識別するフィールドは明示的または暗黙的にパブリックであり、したがってプロパティは広範に設定可能です。  詳細については、「[依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)」を参照してください。  
+  
+## 参照  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/relativesource-markupextension.md b/docs/framework/wpf/advanced/relativesource-markupextension.md
new file mode 100644
index 00000000000..f3bc8868b20
--- /dev/null
+++ b/docs/framework/wpf/advanced/relativesource-markupextension.md
@@ -0,0 +1,120 @@
+---
+title: "RelativeSource のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "RelativeSource"
+helpviewer_keywords: 
+  - "RelativeSource のマークアップ拡張機能"
+  - "XAML, RelativeSource マークアップ拡張機能"
+ms.assetid: 26be4721-49b5-4717-a92e-7d54ad0d3a81
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# RelativeSource のマークアップ拡張機能
+[バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)内で使用されるか、または XAML で設定された <xref:System.Windows.Data.Binding> 要素の <xref:System.Windows.Data.Binding.RelativeSource%2A> プロパティの設定時に使用される、<xref:System.Windows.Data.RelativeSource> バインディング ソースのプロパティを指定します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<Binding RelativeSource="{RelativeSource modeEnumValue}" .../>  
+```  
+  
+## XAML 属性の使用方法 \(バインディング拡張内で入れ子にした場合\)  
+  
+```  
+<object property="{Binding RelativeSource={RelativeSource modeEnumValue} ...}" .../>  
+```  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<Binding>  
+  <Binding.RelativeSource>  
+    <RelativeSource Mode="modeEnumValue"/>  
+  </Binding.RelativeSource>  
+</Binding>  
+- or   
+<Binding>  
+  <Binding.RelativeSource>  
+    <RelativeSource  
+      Mode="FindAncestor"  
+      AncestorType="{x:Type typeName}"  
+      AncestorLevel="intLevel"  
+    />  
+  </Binding.RelativeSource>  
+</Binding>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`modeEnumValue`|次のいずれかになります。<br /><br /> -   文字列トークン `Self`。<xref:System.Windows.Data.RelativeSource> に対応し、<xref:System.Windows.Data.RelativeSource.Mode%2A> プロパティは <xref:System.Windows.Data.RelativeSourceMode> に設定されます。<br />-   文字列トークン `TemplatedParent`。<xref:System.Windows.Data.RelativeSource> に対応し、<xref:System.Windows.Data.RelativeSource.Mode%2A> プロパティは <xref:System.Windows.Data.RelativeSourceMode> に設定されます。<br />-   文字列トークン `PreviousData`。<xref:System.Windows.Data.RelativeSource> に対応し、<xref:System.Windows.Data.RelativeSource.Mode%2A> プロパティは <xref:System.Windows.Data.RelativeSourceMode> に設定されます。<br />-   `FindAncestor` については、以下を参照してください。|  
+|`FindAncestor`|文字列トークン `FindAncestor`。  このトークンを使用すると、`RelativeSource` によって先祖の型およびオプションで先祖レベルを指定するモードになります。  これは、<xref:System.Windows.Data.RelativeSource.Mode%2A> プロパティが <xref:System.Windows.Data.RelativeSourceMode> に設定された状態で作成された <xref:System.Windows.Data.RelativeSource> に対応します。|  
+|`typeName`|`FindAncestor` モードで必要です。  <xref:System.Windows.Data.RelativeSource.AncestorType%2A> プロパティに指定する型の名前。|  
+|`intLevel`|`FindAncestor` モードのオプションです。  論理ツリー内で親の方向に向けて数えた先祖レベル。|  
+  
+## 解説  
+ `{RelativeSource TemplatedParent}` バインディングの用法は、コントロールの UI とロジックを分離するという、より大きな構想を解決するための鍵となる手法です。  これによって、テンプレートが適用される親 \(テンプレートが適用されるランタイム オブジェクト インスタンス\) へのバインディングをテンプレート定義内から行うことができます。  この場合、[TemplateBinding のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) は、実際には、`{Binding RelativeSource={RelativeSource TemplatedParent}}` というバインディング式を略したものです。  `TemplateBinding` と `{RelativeSource TemplatedParent}` の使用法はどちらも、テンプレートを定義する XAML 内でのみ意味を持ちます。  詳細については、「[TemplateBinding のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md)」を参照してください。  
+  
+ `{RelativeSource FindAncestor}` の主な用途は、コントロール テンプレート内または予測可能な独立した UI 合成です。特定の先祖の型のビジュアル ツリー内にコントロールが常に存在することがわかっているケースで使用されます。  たとえば、項目コントロールの各項目は `FindAncestor` を使用して、その項目コントロールの親先祖のプロパティにバインドすることができます。  または、テンプレート内のコントロール合成に参加している要素は、同じ合成体系の親要素に対して `FindAncestor` バインディングを使用できます。  
+  
+ XAML 構文のセクションに示した `FindAncestor` モードのオブジェクト要素構文では、2 番目のオブジェクト要素構文は `FindAncestor` モード向けに使用されます。  `FindAncestor` モードでは、<xref:System.Windows.Data.RelativeSource.AncestorType%2A> 値が必要です。  検索する先祖の型への [x:Type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)参照を使用して、<xref:System.Windows.Data.RelativeSource.AncestorType%2A> を属性として設定する必要があります。  <xref:System.Windows.Data.RelativeSource.AncestorType%2A> 値は、実行時にバインディング要求を処理する際に使用されます。  
+  
+ `FindAncestor` モードでは、オプションの <xref:System.Windows.Data.RelativeSource.AncestorLevel%2A> プロパティは、要素ツリー内に型の先祖が複数存在する可能性がある場合に、先祖の検索のあいまいさを解消するのに役立ちます。  
+  
+ `FindAncestor` モードの使用方法の詳細については、「<xref:System.Windows.Data.RelativeSource>」を参照してください。  
+  
+ `{RelativeSource Self}` は、特定のインスタンスのプロパティが同じインスタンスの別のプロパティの値に依存しており、その 2 つのプロパティ間に通常の依存関係プロパティの関係 \(強制変換など\) が存在しない状況で活用できます。  まったく同じ値、まったく同じ型を持つ 2 つのプロパティが 1 つのオブジェクトに存在することはまれですが、`{RelativeSource Self}` を持つバインディングに `Converter` パラメーターを適用し、そのコンバーターを使用してソースとターゲットの型変換を行うこともできます。  `{RelativeSource Self}` は、<xref:System.Windows.MultiDataTrigger> の一部として活用することもできます。  
+  
+ たとえば、`<Rectangle Width="200" Height="{Binding RelativeSource={RelativeSource Self}, Path=Width}" .../>` という XAML は、<xref:System.Windows.Shapes.Rectangle> 要素を定義します。<xref:System.Windows.FrameworkElement.Width%2A> にどのような値が入力されても、<xref:System.Windows.Shapes.Rectangle> は常に正方形となります。  
+  
+ `{RelativeSource PreviousData}` は、データ テンプレートで活用できるほか、バインディングにデータ ソースのコレクションを使用する場合にも役立ちます。  `{RelativeSource PreviousData}` を使用すると、コレクション内の隣接するデータ項目どうしの関係に注目することができます。  これと関連して、データ ソース内の現在の項目と直前の項目との間に <xref:System.Windows.Data.MultiBinding> を確立し、そのバインディング上のコンバーターを使用して、2 つの項目 \(およびそれらのプロパティ\) 間の相違を特定する手法もあります。  
+  
+ 次の例の項目テンプレートに出現する 1 つ目の <xref:System.Windows.Controls.TextBlock> は、現在の数値を表示します。  2 つ目の <xref:System.Windows.Controls.TextBlock> バインディングは、<xref:System.Windows.Data.MultiBinding> で、通常 2 つの <xref:System.Windows.Data.Binding> 構成要素を持ちます \(現在のレコードと、`{RelativeSource PreviousData}` を使用して直前のデータ レコードを意図的に使用するバインディング\)。  <xref:System.Windows.Data.MultiBinding> 上のコンバーターが、両者の差を計算し、バインディングに返します。  
+  
+```  
+<ListBox Name="fibolist">  
+    <ListBox.ItemTemplate>  
+        <DataTemplate>  
+            <StackPanel Orientation="Horizontal">  
+            <TextBlock Text="{Binding}"/>  
+            <TextBlock>, difference = </TextBlock>  
+                <TextBlock>  
+                    <TextBlock.Text>  
+                        <MultiBinding Converter="{StaticResource DiffConverter}">  
+                            <Binding/>  
+                            <Binding RelativeSource="{RelativeSource PreviousData}"/>  
+                        </MultiBinding>  
+                    </TextBlock.Text>  
+                </TextBlock>  
+            </StackPanel>  
+            </DataTemplate>  
+    </ListBox.ItemTemplate>  
+```  
+  
+ ここで説明されていないデータ バインディングの概念については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] XAML プロセッサ実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.Data.RelativeSource> クラスによって定義されます。  
+  
+ `RelativeSource` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  XAML のすべてのマークアップ拡張機能では、それぞれの属性構文で `{` と `}` の 2 つの記号を使用します。これは規約であり、これに従って XAML プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Data.Binding>   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [バインディング宣言の概要](../../../../docs/framework/wpf/data/binding-declarations-overview.md)   
+ [x:Type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/resources-and-code.md b/docs/framework/wpf/advanced/resources-and-code.md
new file mode 100644
index 00000000000..678407d8de3
--- /dev/null
+++ b/docs/framework/wpf/advanced/resources-and-code.md
@@ -0,0 +1,55 @@
+---
+title: "リソースとコード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キー, 使用 (オブジェクトを)"
+  - "手続き型コード, アクセス (リソースに)"
+  - "手続き型コード, 作成 (リソースを)"
+  - "リソース, アクセス (手続き型コードから)"
+  - "リソース, 作成 (手続き型コードで)"
+ms.assetid: c1cfcddb-e39c-41c8-a7f3-60984914dfae
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# リソースとコード
+ここでは、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 構文ではなくコードを使用して、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のリソースにアクセスする方法またはリソースを作成する方法について説明します。  一般的なリソースの使用方法と [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文の観点から見たリソースの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="accessing"></a>   
+## コードからリソースにアクセスする  
+ リソースを識別するキーは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義されていれば、コードでリソースを要求する際にも特定のリソースの取得に使用されます。  コードからリソースを取得する最も簡単な方法は、アプリケーションのフレームワーク レベルのオブジェクトから <xref:System.Windows.FrameworkElement.FindResource%2A> または <xref:System.Windows.FrameworkElement.TryFindResource%2A> メソッドを呼び出すことです。  これらのメソッドは、要求したキーが見つからなかった場合の動作に違いがあります。  <xref:System.Windows.FrameworkElement.FindResource%2A> では例外が発生し、<xref:System.Windows.FrameworkElement.TryFindResource%2A> では例外は発生しませんが `null` が返されます。  各メソッドは、入力パラメーターとしてリソース キーを受け取り、弱く型指定されたオブジェクトを返します。  通常、リソース キーは文字列ですが、文字列以外を使用することもあります。詳細については、「[オブジェクトをキーとして使用する](#objectaskey)」を参照してください。  通常は、返されたオブジェクトを、リソースの要求時に設定するプロパティで必要な型にキャストします。  コードのリソース解決の検索ロジックは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の動的リソース参照の場合と同じです。  リソースの検索は、呼び出し元の要素から開始され、[論理ツリー](GTMT)内の連続する親要素へと続きます。  その後、必要に応じて、アプリケーション リソース、テーマ、およびシステム リソースへと検索が続きます。  コードによるリソースの要求では、リソース ディクショナリが [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で読み込まれた後に行われた実行時の変更と、リアルタイムのシステム リソースの変更が適切に考慮されます。  
+  
+ キーによってリソースを検索し、戻り値を使用してプロパティを設定する簡単なコード例を次に示します。これは <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーとして実装されます。  
+  
+ [!code-csharp[PropertiesOvwSupport#ResourceProceduralGet](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertiesOvwSupport/CSharp/page3.xaml.cs#resourceproceduralget)]
+ [!code-vb[PropertiesOvwSupport#ResourceProceduralGet](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertiesOvwSupport/visualbasic/page3.xaml.vb#resourceproceduralget)]  
+  
+ リソース参照を割り当てる別のメソッドには、<xref:System.Windows.FrameworkElement.SetResourceReference%2A> があります。  このメソッドは、リソースのキーと、リソース値を割り当てる要素インスタンスに存在する特定の依存関係プロパティの識別子の 2 つのパラメーターを受け取ります。  このメソッドは機能的には前のメソッドと同じですが、戻り値をキャストしなくて済むという利点があります。  
+  
+ 他にも、プログラムによってリソースにアクセスする方法として、ディクショナリとしての <xref:System.Windows.FrameworkElement.Resources%2A> プロパティのコンテンツにアクセスする方法があります。  このプロパティによって格納されたディクショナリにアクセスする方法は、新しいリソースを既存のコレクションに追加する方法、指定したキー名がコレクション既に取得されたかどうかを確認する方法などのその他のディクショナリ\/コレクション操作でもあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション全体をコードで記述する場合は、コレクション全体もコードで作成して、これにキーを割り当て、完了したコレクションを設定されている要素の <xref:System.Windows.FrameworkElement.Resources%2A> プロパティに割り当てることができます。  これについては、次のセクションを参照してください。  
+  
+ インデックスとして特定のキーを使用して、特定の <xref:System.Windows.FrameworkElement.Resources%2A> コレクション内にインデックスを設定できますが、この方法でリソースにアクセスした場合は、リソース解決で既定の実行時のルールに従っていないことに注意してください。  その特定のコレクションにのみアクセスしています。  要求したキーで有効なオブジェクトが見つからなかった場合、リソース検索がその範囲を超えてルートまたはアプリケーションを走査することはありません。  ただし、この方法はキーの検索範囲がより限定されるため、場合によっては確実にパフォーマンスが向上します。  リソース ディクショナリを直接操作する方法の詳細については、<xref:System.Windows.ResourceDictionary> クラスを参照してください。  
+  
+<a name="creating"></a>   
+## コードでリソースを作成する  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション全体をコードで作成する場合は、そのアプリケーション内のリソースもコードで作成する必要があります。  これを実現するには、新しい <xref:System.Windows.ResourceDictionary> インスタンスを作成し、<xref:System.Windows.ResourceDictionary.Add%2A?displayProperty=fullName> を連続して呼び出すことによりすべてのリソースをディクショナリに追加します。  次に、作成された <xref:System.Windows.ResourceDictionary> を使用して、ページ スコープまたは <xref:System.Windows.Application.Resources%2A?displayProperty=fullName> 内にある要素の <xref:System.Windows.FrameworkElement.Resources%2A> プロパティを設定します。  <xref:System.Windows.ResourceDictionary> は、要素に追加せずにスタンドアロン オブジェクトとして保持することもできます。  ただし、これを行う場合は、ジェネリック ディクショナリの場合と同様に、項目のキーによって内部のリソースにアクセスする必要があります。  要素の `Resources` プロパティに割り当てられていない <xref:System.Windows.ResourceDictionary> は、要素ツリーの一部として存在することはなく、一連の検索で <xref:System.Windows.FrameworkElement.FindResource%2A> および関連メソッドによって使用できるスコープがありません。  
+  
+<a name="objectaskey"></a>   
+## オブジェクトをキーとして使用する  
+ 通常、リソースを使用する場合、リソースのキーは文字列として設定されます。  ただし、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の各種機能の中にはキーを指定する際に意図的に文字列型を使用しないで、このパラメーターにオブジェクトを使用するものもあります。  オブジェクトによってリソースにキーを設定するには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのスタイルおよびテーマの適用のサポートを利用します。  スタイルが設定されていないコントロールの既定のスタイルとなるテーマのスタイルには、適用されるコントロールの <xref:System.Type> によってそれぞれキーが設定されます。  型によってキーが設定されると、各コントロール型の既定のインスタンスで機能する信頼できる検索機構が実現され、型はリフレクションによって検索できるようになり、派生型に既定のスタイルが設定されていない場合でも派生クラスのスタイルを設定する際に使用できます。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義されたリソースの <xref:System.Type> キーは、[x:Type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)を使用して指定できます。  他にも [ComponentResourceKey マークアップ拡張機能](../../../../docs/framework/wpf/advanced/componentresourcekey-markup-extension.md)など、文字列以外のキーの使用で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 機能をサポートする同様の拡張機能があります。  
+  
+## 参照  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/resources-how-to-topics.md b/docs/framework/wpf/advanced/resources-how-to-topics.md
new file mode 100644
index 00000000000..028695a8de1
--- /dev/null
+++ b/docs/framework/wpf/advanced/resources-how-to-topics.md
@@ -0,0 +1,46 @@
+---
+title: "リソースに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "リソース"
+  - "再利用 (一般的に定義されるオブジェクトを)"
+  - "再利用 (リソースを)"
+ms.assetid: 9f986a6d-7cc8-45ac-bb0f-43177a57649d
+caps.latest.revision: 74
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 74
+---
+# リソースに関する「方法」トピック
+このセクションのトピックでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] リソースを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [リソースを定義および参照する](../../../../docs/framework/wpf/advanced/how-to-define-and-reference-a-resource.md)  
+ [アプリケーション リソースを使用する](../../../../docs/framework/wpf/advanced/how-to-use-application-resources.md)  
+ [SystemFonts を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemfonts.md)  
+ [システム フォント キーを使用する](../../../../docs/framework/wpf/advanced/how-to-use-system-fonts-keys.md)  
+ [SystemParameters を使用する](../../../../docs/framework/wpf/advanced/how-to-use-systemparameters.md)  
+ [システム パラメーター キーを使用する](../../../../docs/framework/wpf/advanced/how-to-use-system-parameters-keys.md)  
+  
+## 関連項目  
+ <xref:System.Windows.FrameworkTemplate.Resources%2A>  
+  
+ <xref:System.Windows.SystemColors>  
+  
+ <xref:System.Windows.SystemParameters>  
+  
+ <xref:System.Windows.SystemFonts>  
+  
+## 関連項目  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/resources-wpf.md b/docs/framework/wpf/advanced/resources-wpf.md
new file mode 100644
index 00000000000..723420fdfbe
--- /dev/null
+++ b/docs/framework/wpf/advanced/resources-wpf.md
@@ -0,0 +1,43 @@
+---
+title: "リソース (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "リソース"
+  - "再利用 (一般的に定義されるオブジェクトを)"
+  - "再利用 (リソースを)"
+ms.assetid: 12ae4b67-cd0c-4c4d-a188-2c3de173bbb9
+caps.latest.revision: 77
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# リソース (WPF)
+リソースはアプリケーション内のさまざまな場所で再利用できるオブジェクトです。  WPF はリソースの種類をサポートします。  これらのリソースはリソース \(主に 2 種類です : XAML リソースとリソース データ ファイル。  XAML リソースにはブラシとスタイルが含まれます。  リソース データ ファイルは非実行可能データ ファイルアプリケーションに必要です。  
+  
+## このセクションの内容  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)  
+ [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)  
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)  
+  
+## 関連項目  
+ <xref:System.Windows.ResourceDictionary>  
+  
+ [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)  
+  
+ [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)  
+  
+ [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)  
+  
+## 関連項目  
+ [WPF の XAML](../../../../docs/framework/wpf/advanced/xaml-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/routed-events-overview.md b/docs/framework/wpf/advanced/routed-events-overview.md
new file mode 100644
index 00000000000..0fff0629135
--- /dev/null
+++ b/docs/framework/wpf/advanced/routed-events-overview.md
@@ -0,0 +1,264 @@
+---
+title: "ルーティング イベントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付イベント"
+  - "バブル"
+  - "ボタン セット, グループ化"
+  - "イベント, 添付"
+  - "イベント, ルーティング"
+  - "グループ化されたボタン セット"
+  - "ルーティング イベント"
+  - "ルーティング方法 (イベントの)"
+  - "トンネル"
+ms.assetid: 1a2189ae-13b4-45b0-b12c-8de2e49c29d2
+caps.latest.revision: 29
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# ルーティング イベントの概要
+このトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でのルーティング イベントの概念について説明します。  ここでは、ルーティング イベントの用語を定義し、要素ツリーを通じたイベントのルーティング方法、ルーティング イベントの処理方法、およびカスタム ルーティング イベントの作成方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ ここでの説明は、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)]、オブジェクト指向プログラミング、およびツリー形式として概念化できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素間のリレーションシップに関する基礎知識を前提にしています。  このトピックの例に従うには、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] について理解し、ごく基本的な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションまたはページを作成できる必要があります。  詳細については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」および「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+<a name="routing"></a>   
+## ルーティング イベントとは  
+ ルーティング イベントについては、機能または実装の観点から考えることができます。  どちらを便利と感じるかは個人によって異なるため、ここでは両方の見方を提示します。  
+  
+ 観点を機能に置いた場合、ルーティング イベントは、イベントを生成したオブジェクト上だけでなく、要素ツリー内の複数のリスナー上でハンドラーを呼び出すことができる種類のイベントです。  
+  
+ 観点を実装に置いた場合、[ルーティング イベント](GTMT)は、<xref:System.Windows.RoutedEvent> クラスのインスタンスによってサポートされる [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントであり、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] イベント システムによって処理されます。  
+  
+ 一般的な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションには、多数の要素が含まれます。  コードで作成したか [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の宣言によって作成したかにかかわらず、これらの要素は互いに要素ツリー リレーションシップにあります。  イベントのルーティングは、イベント定義に従って 2 つの方向のいずれかをたどることができますが、一般にはルーティングは発生元要素から要素ツリーに沿って "浮上" し、最終的には要素ツリーのルート \(通常はページまたはウィンドウ\) に到達します。  このバブルの概念は、DHTML オブジェクト モデルで使用される概念と似ています。  
+  
+ たとえば、次のような単純な要素ツリーがあるとします。  
+  
+ [!code-xml[EventOvwSupport#GroupButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml#groupbutton)]  
+  
+ この要素ツリーでは、次のようなものが生成されます。  
+  
+ ![&#91;はい&#93;、&#91;いいえ&#93;、および &#91;キャンセル&#93; ボタン](../../../../docs/framework/wpf/advanced/media/routedevent-ovw-1.png "RoutedEvent\_ovw\_1")  
+  
+ この簡素化した要素ツリーでは、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントのソースは <xref:System.Windows.Controls.Button> 要素の 1 つであり、どの <xref:System.Windows.Controls.Button> がクリックされてもそれがイベントを処理する機会を得る最初の要素です。  しかし、イベントを処理するハンドラーが <xref:System.Windows.Controls.Button> にアタッチされていない場合は、イベントが要素ツリー内の <xref:System.Windows.Controls.Button> の親要素、つまり <xref:System.Windows.Controls.StackPanel> に到達します。  イベントは <xref:System.Windows.Controls.Border> に到達する可能性があり、その後は要素ツリーのページ ルートを越えて先へ進みます \(この例では省きました\)。  
+  
+ つまり、この <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントのイベント ルーティングは次のように進みます。  
+  
+ Button \-\-\> StackPanel \-\-\> Border \-\-\>...  
+  
+### ルーティング イベントのトップレベルのシナリオ  
+ ルーティング イベントの概念が生まれる契機となったシナリオと、このシナリオに通常の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントが適していない理由について簡単に説明します。  
+  
+ **コントロールの複合とカプセル化 :** [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のさまざまなコントロールには、多機能のコンテンツ モデルが採用されています。  たとえば、<xref:System.Windows.Controls.Button> の内部にイメージを格納できます。これにより、ボタンのビジュアル ツリーが事実上拡張されます。  ただし、追加したイメージによって、ボタンがそのコンテンツの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> に応答するためのヒット テスト動作が妨げられないようにする必要があります。これは、技術的にはイメージの一部であるピクセルがクリックされる場合にも当てはまります。  
+  
+ **単一のハンドラー アタッチ ポイント :** [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] では、複数の要素から発生する可能性があるイベントを処理するために同じハンドラーを複数回アタッチする必要があります。  ルーティング イベントを使用すると、前の例に示したとおり、ハンドラーを一度だけアタッチし、必要に応じてハンドラーのロジックを使用してイベントの発生元を特定することができます。  たとえば、前に示した [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では次のようなハンドラーを使用します。  
+  
+ [!code-csharp[EventOvwSupport#GroupButtonCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml.cs#groupbuttoncodebehind)]
+ [!code-vb[EventOvwSupport#GroupButtonCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EventOvwSupport/visualbasic/default.xaml.vb#groupbuttoncodebehind)]  
+  
+ **クラス処理 :** ルーティング イベントでは、クラスに定義した静的ハンドラーを使用できます。  このクラス ハンドラーでは、アタッチされたどのインスタンス ハンドラーよりも先にイベントを処理できます。  
+  
+ **リフレクションを使用しないイベント参照 :** 特定のコードやマークアップのテクニックでは、特定のイベントを識別する機能が必要とされます。  ルーティング イベントによって識別子として作成される <xref:System.Windows.RoutedEvent> は、信頼性の高いイベント識別テクニックとして利用でき、静的または実行時のリフレクションを必要としません。  
+  
+### ルーティング イベントの実装方法  
+ [ルーティング イベント](GTMT)とは、<xref:System.Windows.RoutedEvent> クラスのインスタンスによってサポートされ、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント システムに登録されている [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントです。  通常、登録から取得された <xref:System.Windows.RoutedEvent> インスタンスは、ルーティング イベントを登録して "所有" するクラスの `public` `static` `readonly` フィールドのメンバーとして保持されます。  一意の名前を持つ [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベント \("ラッパー" イベントとも呼ばれます\) への接続は、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントの `add` 実装と `remove` 実装をオーバーライドすることにより得られます。  通常、`add` と `remove` は、暗黙の既定のままにされ、そのイベントのハンドラーの追加や削除に言語固有の適切なイベント構文が使用されます。  ルーティング イベントのサポートと接続のしくみは、[依存関係プロパティ](GTMT)が、<xref:System.Windows.DependencyProperty> クラスによってサポートされ、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムに登録されている [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティであることと、概念的に似ています。  
+  
+ <xref:System.Windows.RoutedEvent> 識別子フィールドと `Tap` [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントの `add` 実装および `remove` 実装の登録と公開を含む、カスタムの `Tap` ルーティング イベントの宣言を次の例に示します。  
+  
+ [!code-csharp[RoutedEventCustom#AddRemoveHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RoutedEventCustom/CSharp/SDKSampleLibrary/class1.cs#addremovehandler)]
+ [!code-vb[RoutedEventCustom#AddRemoveHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RoutedEventCustom/VB/SDKSampleLibrary/Class1.vb#addremovehandler)]  
+  
+### ルーティング イベント ハンドラーと XAML  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用してイベントのハンドラーを追加するには、イベント リスナーである要素の属性としてイベント名を宣言します。  属性の値は、実装したハンドラー メソッドの名前です。このメソッドは、分離コード ファイルの部分クラス内に存在する必要があります。  
+  
+ [!code-xml[EventOvwSupport#SimplestSyntax](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml#simplestsyntax)]  
+  
+ 標準の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベント ハンドラーを追加する [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文は、ルーティング ハンドラーを追加する構文と同じです。これは、実際にはハンドラーを [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベント ラッパーに追加しているためです。このラッパーの内部にルーティング イベント実装が存在します。  イベンド ハンドラーを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で追加する方法の詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+<a name="routing_strategies"></a>   
+## ルーティング方法  
+ ルーティング イベントは、3 つのルーティング方法のいずれかを使用します。  
+  
+-   **バブル :** イベント ソースのイベント ハンドラーが呼び出されます。  ルーティング イベントは、次に、要素ツリー ルートに到達するまで、連続する親要素にルーティングします。  ほとんどのルーティング イベントでは、このバブル ルーティング方法を使用します。  バブル ルーティング イベントは、一般に個別のコントロールまたはその他の UI 要素からの入力や状態変化を報告するために使用されます。  
+  
+-   **直接 :** ソース要素自体のみに、応答としてハンドラーを呼び出す機会が与えられます。  これは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] がイベントに使用する "ルーティング" と似ています。  ただし、標準の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントとは異なり、直接ルーティング イベントはクラス処理をサポートし、<xref:System.Windows.EventSetter> および <xref:System.Windows.EventTrigger> で使用できます \(クラス処理については後のセクションで説明します\)。  
+  
+-   **トンネル :** 要素ツリー ルートのイベント ハンドラーが最初に呼び出されます。  ルーティング イベントは、次に、経路沿いにルーティング イベント ソース \(ルーティング イベントを発生させた要素\) のノード要素まで、連続する子要素間の経路をたどります。  多くの場合にトンネル ルーティング イベントは、コントロールの複合部分として使用または処理されます。たとえば、複合部分で発生したイベントは、完全なコントロールに固有のイベントによって意図的に抑止されるか置き換えられます。  多くの場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] から提供される入力イベントはトンネル\/バブル ペアとして実装されます。  トンネル イベントは、このペアに使用される名前付け規則から、プレビュー イベントと呼ばれることもあります。  
+  
+<a name="why_use"></a>   
+## ルーティング イベントを使用する理由  
+ アプリケーションを開発するときに、処理するイベントがルーティング イベントとして実装されていることを常に知る必要や気を配る必要はありません。  ルーティング イベントの動作は独特ですが、イベントを発生元の要素で処理する限り、動作はあまり表面には見えません。  
+  
+ ルーティング イベントが効果を発揮するのは、共通ハンドラーを共通ルートに定義する、独自のコントロールを複合化する、カスタム コントロール クラスを定義するなどの、特定のシナリオの場合です。  
+  
+ ルーティング イベント リスナーとルーティング イベント ソースは、階層内で共通イベントを共有する必要はありません。  <xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> は、どのルーティング イベントのイベント リスナーであってもかまいません。  したがって、作業 [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] セットで使用可能なすべてのルーティング イベントを概念的 "インターフェイス" として使用できます。これにより、アプリケーション内の異なる要素間でイベント情報を交換できます。  ルーティング イベントのこの "インターフェイス" 概念は、特に入力イベントに当てはまります。  
+  
+ また、ルーティング イベントは、要素ツリー間の通信にも使用できます。これは、イベントのイベント データが経路上の各要素に永続的に保持されるためです。  ある要素でイベント データの一部を変更した場合、この変更は経路上の次の要素で使用できます。  
+  
+ 観点をルーティングに置かない場合でも、特定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベントを標準の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントではなくルーティング イベントとして実装する理由が他に 2 つあります。  独自のイベントを実装している場合は、次の原則も考慮します。  
+  
+-   <xref:System.Windows.EventSetter> や <xref:System.Windows.EventTrigger> などの特定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] スタイル指定機能およびテンプレート機能では、参照先のイベントがルーティング イベントである必要があります。  これは、前に説明したイベント識別子シナリオです。  
+  
+-   ルーティング イベントは、クラス処理機構をサポートしています。この機構により、クラスに静的メソッドを指定して、登録されたインスタンス ハンドラーがルーティング イベントにアクセスする前にこの静的メソッドでイベントを処理することができます。  インスタンスでのイベント処理によって誤って抑止されずにイベント駆動のクラス動作を適用できるため、これはコントロールをデザインするときに便利です。  
+  
+ 前に示した一連の考慮事項については、このトピックのセクションで個別に説明します。  
+  
+<a name="event_handing"></a>   
+## ルーティング イベントのイベント ハンドラーの追加と実装  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でイベント ハンドラーを追加するには、次の例に示すように、単にイベント名を要素に属性として追加し、属性の値として、適切なデリゲートを実装するイベント ハンドラーの名前を設定します。  
+  
+ [!code-xml[EventOvwSupport#SimplestSyntax](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml#simplestsyntax)]  
+  
+ `b1SetColor`  は、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理するコードが含まれる実装済みハンドラーの名前です。  `b1SetColor`  は、<xref:System.Windows.RoutedEventHandler> デリゲート、つまり <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント用のイベント ハンドラー デリゲートと同じ署名を持つ必要があります。  すべてのルーティング イベント ハンドラー デリゲートの 1 番目のパラメーターでは、イベント ハンドラーの追加先の要素を指定し、2 番目のパラメーターでは、イベントのデータを指定します。  
+  
+ [!code-csharp[EventOvwSupport#SimpleHandlerA](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml.cs#simplehandlera)]
+ [!code-vb[EventOvwSupport#SimpleHandlerA](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EventOvwSupport/visualbasic/default.xaml.vb#simplehandlera)]  
+[!code-csharp[EventOvwSupport#SimpleHandlerB](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml.cs#simplehandlerb)]
+[!code-vb[EventOvwSupport#SimpleHandlerB](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EventOvwSupport/visualbasic/default.xaml.vb#simplehandlerb)]  
+  
+ <xref:System.Windows.RoutedEventHandler> は、基本的なルーティング イベント ハンドラー デリゲートです。  特定のコントロールやシナリオに特化したルーティング イベントの場合、ルーティング イベント ハンドラーに使用するデリゲートも、より特化したものとなることがあるため、特別なイベント データを転送できます。  たとえば、一般的な入力のシナリオで、<xref:System.Windows.UIElement.DragEnter> ルーティング イベントを処理することがあります。  ハンドラーでは、<xref:System.Windows.DragEventHandler> デリゲートを実装する必要があります。  最も限定的なデリゲートを使用することにより、<xref:System.Windows.DragEventArgs> をハンドラーで処理して、ドラッグ操作のクリップボード ペイロードが含まれる <xref:System.Windows.DragEventArgs.Data%2A> プロパティを読み取ることができます。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用してイベント ハンドラーを要素に追加する方法の詳細な例については、「[ルーティング イベントを処理する](../../../../docs/framework/wpf/advanced/how-to-handle-a-routed-event.md)」を参照してください。  
+  
+ コードで作成されたアプリケーションでルーティング イベントのハンドラーを追加するのは簡単です。  ルーティング イベントのハンドラーは、いつでもヘルパー メソッド <xref:System.Windows.UIElement.AddHandler%2A> \(`add` のサポート呼び出しに使用される既存のメソッドと同じもの\) を使用して追加できます。ただし、一般に既存の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ルーティング イベントは `add` と `remove` のロジックのサポート実装を持つため、言語固有のイベント構文でルーティング イベントにハンドラーを追加できます。ヘルパー メソッドを使用するよりも、この構文の方が分かりやすく処理できます。  ヘルパー メソッドの使用例を次に示します。  
+  
+ [!code-csharp[EventOvwSupport#AddHandlerCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml.cs#addhandlercode)]
+ [!code-vb[EventOvwSupport#AddHandlerCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EventOvwSupport/visualbasic/default.xaml.vb#addhandlercode)]  
+  
+ [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] の演算子構文を次の例に示します \([!INCLUDE[TLA2#tla_visualb](../../../../includes/tla2sharptla-visualb-md.md)] の演算子構文は逆参照を処理するため少し異なります\)。  
+  
+ [!code-csharp[EventOvwSupport#AddHandlerPlusEquals](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml.cs#addhandlerplusequals)]
+ [!code-vb[EventOvwSupport#AddHandlerPlusEquals](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/EventOvwSupport/visualbasic/default.xaml.vb#addhandlerplusequals)]  
+  
+ コードでイベント ハンドラーを追加する方法の例については、「[コードを使用してイベント ハンドラーを追加する](../../../../docs/framework/wpf/advanced/how-to-add-an-event-handler-using-code.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_visualb](../../../../includes/tla2sharptla-visualb-md.md)] を使用する場合、`Handles` キーワードを使用して、ハンドラー宣言の一部としてハンドラーを追加することもできます。  詳細については、「[Visual Basic と WPF のイベント処理](../../../../docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md)」を参照してください。  
+  
+<a name="concept_handled"></a>   
+### 処理済みの概念  
+ すべてのルーティング イベントは、共通のイベント データ基本クラス <xref:System.Windows.RoutedEventArgs> を共有します。  <xref:System.Windows.RoutedEventArgs> は、ブール値を取る <xref:System.Windows.RoutedEventArgs.Handled%2A> プロパティを定義します。  <xref:System.Windows.RoutedEventArgs.Handled%2A> プロパティの目的は、<xref:System.Windows.RoutedEventArgs.Handled%2A> の値を `true` に設定することにより、経路上の任意のイベント ハンドラーでルーティング イベントを*処理済み*としてマークできるようにすることです。  経路上の 1 つの要素のハンドラーで処理された後、共有イベント データが経路上の各リスナーに報告されます。  
+  
+ <xref:System.Windows.RoutedEventArgs.Handled%2A> の値は、ルーティング イベントが経路をたどる過程でどのように報告または処理されるかに影響します。  ルーティング イベントのイベント データで <xref:System.Windows.RoutedEventArgs.Handled%2A> が `true` の場合、その特定のイベント インスタンスでは以後、他の要素上でそのルーティング イベントをリッスンするハンドラーが呼び出されることがありません。  これは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でアタッチされたハンドラーの場合も、`+=` や `Handles` など、言語固有のイベント ハンドラー アタッチ構文によって追加されたハンドラーの場合も同様です。  最も一般的なハンドラーのシナリオでは、<xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定してイベントを処理済みとしてマークすると、トンネル ルーティングやバブル ルーティングだけでなく経路上でクラス ハンドラーによって処理されるすべてのイベントにもルーティングが "停止" されます。  
+  
+ ただし、イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> が `true` であるルーティング イベントへの応答としてリスナーがハンドラーを実行できる "handledEventsToo" 機構も存在します。  つまり、イベント データを処理済みとしてマークしてもイベントのルーティングは完全には停止されません。  handledEventsToo 機構は、コードまたは <xref:System.Windows.EventSetter> でのみ使用できます。  
+  
+-   コードの場合、一般的な [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントで機能する言語固有のイベント構文の代わりに、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] メソッド <xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> を呼び出してハンドラーを追加します。  `handledEventsToo` の値として `true` を指定します。  
+  
+-   <xref:System.Windows.EventSetter> の場合、<xref:System.Windows.EventSetter.HandledEventsToo%2A> 属性に `true` を設定します。  
+  
+ <xref:System.Windows.RoutedEventArgs.Handled%2A> の概念は、<xref:System.Windows.RoutedEventArgs.Handled%2A> 状態がルーティング イベントに生成する動作だけでなく、アプリケーションの設計方法およびイベント ハンドラー コードの記述方法にも影響します。  <xref:System.Windows.RoutedEventArgs.Handled%2A> は、ルーティング イベントによって公開される単純なプロトコルと見なすことができます。  このプロトコルの具体的な使用方法に決まりはありませんが、<xref:System.Windows.RoutedEventArgs.Handled%2A> の値の使用方法として意図された概念設計は次のとおりです。  
+  
+-   ルーティング イベントが処理済みとしてマークされている場合、このイベントを経路上の他の要素で再度処理する必要はありません。  
+  
+-   ルーティング イベントが処理済みとしてマークされていない場合、経路上の前方に位置する他のリスナーがハンドラーを登録しないよう選択したか、登録済みハンドラーがイベント データを操作しないよう選択し、<xref:System.Windows.RoutedEventArgs.Handled%2A> を `true` に設定したかのどちらかです   \(または、現在のリスナーが経路上の出発点である可能性もあります\)。現在のリスナーのハンドラーでは、次の 3 つのアクションを選択できます。  
+  
+    -   なにもアクションを行いません。イベントは未処理のまま、次のリスナーにルーティングされます。  
+  
+    -   イベントに応答してコードを実行しますが、イベントを処理済みとしてマークするのに十分なアクションを実行したことは確定しません。  イベントは次のリスナーにルーティングされます。  
+  
+    -   イベントに応答してコードを実行します。  実行したアクションはイベントを処理済みとしてマークするのに十分と考えられるため、ハンドラーに渡されたイベント データでイベントを処理済みとしてマークします。  イベントは次のリスナーにルーティングされますが、イベント データに <xref:System.Windows.RoutedEventArgs.Handled%2A>\=`true` があるため、他のハンドラーを呼び出す機会が与えられるのは `handledEventsToo` リスナーだけです。  
+  
+ この概念設計は、前に説明したルーティング動作により補強されます。そのため、経路上の前方のハンドラーによって <xref:System.Windows.RoutedEventArgs.Handled%2A> が `true` に既に設定されている状況で、ルーティング イベントに対して呼び出されるルーティング イベントのハンドラーをアタッチすることは、さらに難しくなります \(ただしコードやスタイルでは可能\)。  
+  
+ <xref:System.Windows.RoutedEventArgs.Handled%2A>、ルーティング イベントのクラス処理、およびルーティング イベントを <xref:System.Windows.RoutedEventArgs.Handled%2A> としてマークするのに適したタイミングの詳細については、「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+ アプリケーションでは、バブル ルーティング イベントを発生元のオブジェクトで処理するのが一般的であり、イベントのルーティング特性についてはまったく考慮されません。  ただし、その場合でも、イベント データでルーティング イベントを処理済みとしてマークして、要素ツリーの後方にある要素でそれと同じルーティング イベントにハンドラーがアタッチされている場合に起こりうる予期しない副作用を回避することをお勧めします。  
+  
+<a name="class_handlers"></a>   
+## クラス ハンドラー  
+ <xref:System.Windows.DependencyObject> から派生したクラスを定義する場合、クラスに宣言または継承されたイベント メンバーであるルーティング イベントのクラス ハンドラーを定義およびアタッチすることもできます。  ルーティング イベントが経路上の要素インスタンスに到達すると、クラスのインスタンスにアタッチされたどのインスタンス リスナー ハンドラーよりも先に、クラス ハンドラーが呼び出されます。  
+  
+ 一部の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールには、特定のルーティング イベントに対する固有のクラス処理が存在します。  このため、ルーティング イベントが発生していないように見えても、実際にはクラス処理されている場合があります。また、特定の手法を使用した場合、インスタンス ハンドラーでも処理される可能性があります。  また、多くの基本クラスとコントロールからは、クラス処理の動作をオーバーライドするために使用できる仮想メソッドが提供されています。  望ましくないクラス処理の回避方法とカスタム クラスを使った独自のクラス処理定義方法の詳細については、「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+<a name="attached_events"></a>   
+## WPF の添付イベント  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 言語は、*添付イベント*と呼ばれる特殊な種類のイベントも定義します。  添付イベントを使用して、任意の要素に特定のイベントのハンドラーを追加できます。  イベントを処理する要素が添付イベントを定義または継承する必要はありません。また、イベントを発生させる可能性のあるオブジェクトでも、インスタンスを処理する添付先でも、そのイベントを定義したりクラス メンバーとして "所有" したりする必要はありません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 入力システムでは、添付イベントを多用します。  ただし、ほとんどすべての添付イベントは基本要素間で転送されます。  入力イベントは、基本要素クラスのメンバーである、非添付のルーティング イベントに等しいものとして表されます。  たとえば、基になる添付イベント <xref:System.Windows.Input.Mouse.MouseDown?displayProperty=fullName> を特定の <xref:System.Windows.UIElement> でより簡単に処理するには、添付イベント構文を [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] またはコードで使用するのではなく、その <xref:System.Windows.UIElement> で <xref:System.Windows.UIElement.MouseDown> を使用します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の添付イベントの詳細については、「[添付イベントの概要](../../../../docs/framework/wpf/advanced/attached-events-overview.md)」を参照してください。  
+  
+<a name="Qualifying_Event_Names_in_XAML_for_Anticipated_Routing"></a>   
+## XAML の修飾イベント名  
+ *typename*.*eventname* 添付イベント構文に似ているが厳密に言えば添付イベントではない、もう 1 つの構文使用方法では、子要素で発生したルーティング イベントのハンドラーをアタッチします。  対応するルーティング イベントが共通の親要素にメンバーとして含まれない場合でも、共通の親要素にハンドラーをアタッチしてイベントのルーティングを利用します。  次の例をもう一度検討します。  
+  
+ [!code-xml[EventOvwSupport#GroupButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/default.xaml#groupbutton)]  
+  
+ ここでは、ハンドラーがアタッチされている親要素のリスナーは <xref:System.Windows.Controls.StackPanel> です。  ただし、追加しているのは、<xref:System.Windows.Controls.Button> クラスで宣言され生成されるルーティング イベントのハンドラーです \(実際には <xref:System.Windows.Controls.Primitives.ButtonBase> ですが、継承により <xref:System.Windows.Controls.Button> に使用できます\)。  <xref:System.Windows.Controls.Button> がこのイベントを "所有" しますが、ルーティング イベント システムでは、任意のルーティング イベントのハンドラーを任意の <xref:System.Windows.UIElement> インスタンス リスナー、またはそれ以外の場合であれば [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] イベントのリスナーをアタッチできる <xref:System.Windows.ContentElement> インスタンス リスナーにアタッチすることが許可されています。  これらの修飾イベント属性名の既定の xmlns 名前空間は、通常、既定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] xmlns 名前空間ですが、カスタム ルーティング イベント用のプレフィックスを持つ名前空間や名前スコープを指定することもできます。  xmlns の詳細については、「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照してください。  
+  
+<a name="how_event_processing_works"></a>   
+## WPF の入力イベント  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プラットフォームにおけるルーティング イベントの主な使用例として、入力イベントがあります。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、トンネル ルーティング イベントの名前に "Preview" をプレフィックスとして付加するのが慣例です。  入力イベントは、多くの場合、バブル イベントとトンネル イベントが対になって構成されます。  たとえば、<xref:System.Windows.ContentElement.KeyDown> イベントと <xref:System.Windows.ContentElement.PreviewKeyDown> イベントは同じ署名を持ち、前者がバブル入力イベント、後者がトンネル入力イベントです。  入力イベントによっては、バブル形式だけ、または直接ルーティング形式だけを持つ場合もあります。  このドキュメント内のルーティング イベントに関するトピックでは、他のルーティング方法を使用する類似ルーティング イベントがある場合は相互参照を示します。またマネージ リファレンス ページでは、各ルーティング イベントのルーティング方法について説明します。  
+  
+ 対になった [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 入力イベントを実装する場合、マウス ボタンを押すなどの入力による 1 つのユーザー操作で、対になった両方のルーティング イベントが順次発生するようにします。  まず、トンネル イベントが発生し、その経路をたどります。  次に、バブル イベントが発生し、その経路をたどります。  2 つのイベントは、文字どおり同じイベント データ インスタンスを共有します。これは、バブル イベントを発生させた実装クラスの <xref:System.Windows.UIElement.RaiseEvent%2A> メソッド呼び出しでは、トンネル イベントからのイベント データがリッスンされ、このデータが新たに発生するイベントで再利用されるためです。  トンネル イベントのハンドラーを持つリスナーは、ルーティング イベントを処理済みとしてマークする機会を最初に与えられます \(最初がクラス ハンドラーで、その次がインスタンス ハンドラーです\)。  トンネル経路上の要素がルーティング イベントを処理済みとしてマークした場合、処理済みイベントのデータがバブル イベントに送信され、同等のバブル入力イベントにアタッチされた標準のハンドラーは呼び出されません。  外部からは、処理済みのバブル イベントが発生しなかったように見えます。  この処理動作が便利なのは、コントロールの複合化の場合です。この場合、すべてのヒット テスト ベースの入力イベントまたはフォーカス ベースの入力イベントが、コントロールの複合部分ではなく最終的なコントロールから報告される必要があるためです。  最終的なコントロール要素は、複合のルート近くにあるため、トンネル イベントを最初にクラス処理し、コントロール クラスをサポートするコードの一部としてそのルーティング イベントをコントロール固有のイベントで "置き換える" 機会があります。  
+  
+ 入力イベント処理のしくみを説明するため、次の入力イベント例について考えます。  次のツリー図の `leaf element #2` は、`PreviewMouseDown` と `MouseDown` の両方のイベントの発生元です。  
+  
+ ![イベント ルーティング ダイアグラム](../../../../docs/framework/wpf/advanced/media/wcsdkcoreinputevents.png "wcsdkCoreInputEvents")  
+入力イベントのバブルとトンネル  
+  
+ 次の順序でイベントが処理されます。  
+  
+1.  ルート要素の `PreviewMouseDown` \(トンネル\)。  
+  
+2.  中間要素 \#1 の `PreviewMouseDown` \(トンネル\)。  
+  
+3.  ソース要素 \#2 の `PreviewMouseDown` \(トンネル\)。  
+  
+4.  ソース要素 \#2 の `MouseDown` \(バブル\)。  
+  
+5.  中間要素 \#1 の `MouseDown` \(バブル\)。  
+  
+6.  ルート要素の `MouseDown` \(バブル\)。  
+  
+ ルーティング イベント ハンドラー デリゲートは、2 つのオブジェクトへの参照を提供します。その 2 つは、イベントを発生したオブジェクトと、ハンドラーが呼び出されたオブジェクトです。  ハンドラーが呼び出されたオブジェクトは、`sender` パラメーターによって報告されるオブジェクトです。  イベントが最初に発生したオブジェクトは、イベント データの <xref:System.Windows.RoutedEventArgs.Source%2A> プロパティによって報告されます。  ルーティング イベントを発生させるオブジェクトと処理するオブジェクトが同じ場合もあります。その場合、`sender` と <xref:System.Windows.RoutedEventArgs.Source%2A> は同じです \(前のイベント処理例の手順 3. と手順 4. がこれに該当します\)。  
+  
+ トンネルとバブルにより、親要素は、<xref:System.Windows.RoutedEventArgs.Source%2A> がその子要素のいずれかである入力イベントを受け取ります。  どれがソース要素であるかを知る必要がある場合、<xref:System.Windows.RoutedEventArgs.Source%2A> プロパティにアクセスするとソース要素を特定できます。  
+  
+ 通常、いったん入力イベントが <xref:System.Windows.RoutedEventArgs.Handled%2A> としてマークされると、ハンドラーはそれ以上呼び出されません。  一般に、入力イベントの意味のアプリケーション固有の論理処理を担当するハンドラーが呼び出されたら、直ちに入力イベントを処理済みとしてマークする必要があります。  
+  
+ <xref:System.Windows.RoutedEventArgs.Handled%2A> 状態に関するこの一般論に対する例外として、イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> 状態を意図的に無視するよう登録された入力イベント ハンドラーは、どちらの経路上でも呼び出されます。  詳細については、「[プレビュー イベント](../../../../docs/framework/wpf/advanced/preview-events.md)」または「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+ トンネル イベントとバブル イベント間の共有イベント データ モデルの概念も、トンネル イベントとバブル イベントの順次発生の概念も、すべてのルーティング イベントに当てはまるとは限りません。  そうした動作は、対になった入力イベントを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 入力デバイスがどのように発生させ接続するよう選択するかによって、個別に実装されます。  独自の入力イベントの実装は高度なシナリオですが、独自の入力イベントでそうしたモデルを採用することもできます。  
+  
+ 一部のクラスでは、特定の入力イベントをクラス処理します。通常、その目的は、ユーザーによる特定の入力イベントの意味をそのコントロール内で再定義して、新しいイベントを発生させることです。  詳細については、「[ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)」を参照してください。  
+  
+ 入力と一般的なアプリケーション シナリオにおける入力とイベントの対話方法の詳細については、「[入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)」を参照してください。  
+  
+<a name="events_styles"></a>   
+## EventSetter と EventTrigger  
+ <xref:System.Windows.EventSetter> を使用すると、スタイルのマークアップ内に、あらかじめ宣言された [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] イベント処理構文を含めることができます。  そのスタイルを適用すると、参照されているハンドラーが、スタイルが適用されるインスタンスに追加されます。  <xref:System.Windows.EventSetter> は、ルーティング イベントに対してのみ宣言できます。  例を次に示します。  ここで参照されている `b1SetColor` メソッドは、分離コード ファイル内にあります。  
+  
+ [!code-xml[EventOvwSupport#XAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EventOvwSupport/CSharp/page2.xaml#xaml2)]  
+  
+ ここでの利点は、スタイルに、アプリケーションの任意のボタンに適用可能なその他の情報が大量に含まれている可能性があることです。そのスタイルに <xref:System.Windows.EventSetter> を含めることによって、マークアップ レベルでもコードの再利用が促進されます。  また、<xref:System.Windows.EventSetter> によって、一般的なアプリケーションやページのマークアップよりも一歩進んだハンドラーのメソッド名の抽出化が実現されます。  
+  
+ ルーティング イベントと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーション機能を結合したもう 1 つの特別な構文が、<xref:System.Windows.EventTrigger> です。  <xref:System.Windows.EventSetter> と同様、<xref:System.Windows.EventTrigger> にもルーティング イベントのみを使用できます。通常、<xref:System.Windows.EventTrigger> はスタイルの一部として宣言しますが、<xref:System.Windows.EventTrigger> をページ レベルの要素で <xref:System.Windows.FrameworkElement.Triggers%2A> コレクションの一部として \(つまり <xref:System.Windows.Controls.ControlTemplate> 内で\) 宣言することもできます。<xref:System.Windows.EventTrigger> を使用すると、ルーティング イベントに対する <xref:System.Windows.EventTrigger> を宣言した要素にそのイベントが経路で到達するたびに <xref:System.Windows.Media.Animation.Storyboard> が実行されるよう指定できます。  単にイベントを処理して既存のストーリーボードが開始されるようにする方法と比べて <xref:System.Windows.EventTrigger> が優れている点は、<xref:System.Windows.EventTrigger> の方がストーリーボードとそのランタイム動作をよりよく制御できることです。詳細については、「[開始後のストーリーボードをイベント トリガーを使用して制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)」を参照してください。  
+  
+<a name="more_about"></a>   
+## ルーティング イベントの詳細  
+ このトピックの主な目的は、ルーティング イベントの基本概念を説明し、さまざまな基本要素や基本コントロール内の既存のルーティング イベントに応答する方法とタイミングについて解説することです。  しかし、独自のルーティング イベントを、特殊なイベント データ クラスやデリゲートなど、必要な支援機能と共に、カスタム クラスに作成することもできます。  ルーティング イベントの所有者はどのクラスでもかまいませんが、利便性のため、ルーティング イベントの発生と処理は <xref:System.Windows.UIElement> または <xref:System.Windows.ContentElement> の派生クラスで行われる必要があります。  カスタム イベントの詳細については、「[カスタム ルーティング イベントを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.EventManager>   
+ <xref:System.Windows.RoutedEvent>   
+ <xref:System.Windows.RoutedEventArgs>   
+ [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [コマンド実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)   
+ [弱いイベント パターン](../../../../docs/framework/wpf/advanced/weak-event-patterns.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md b/docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md
new file mode 100644
index 00000000000..876c0083122
--- /dev/null
+++ b/docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md
@@ -0,0 +1,127 @@
+---
+title: "DependencyObject の安全なコンストラクター パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "依存関係オブジェクトのコンストラクター パターン"
+  - "依存関係オブジェクト, コンストラクター パターン"
+  - "FXCop ツール"
+ms.assetid: f704b81c-449a-47a4-ace1-9332e3cc6d60
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# DependencyObject の安全なコンストラクター パターン
+通常、クラスのコンストラクターでは、仮想メソッドやデリゲートなどのコールバックは呼び出しません。コンストラクターは派生クラスのコンストラクターの基底の初期化として呼び出されることがあるためです。  対象のオブジェクトの初期化が不完全な状態で仮想メソッドに入る可能性があります。  ただし、プロパティ システム自体は依存関係プロパティ システムの一部としてコールバックを呼び出し、内部的に公開します。  <xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しによって依存関係プロパティの値を設定するような簡単な演算には、決定のどこかにコールバックが潜在的に含まれます。  この理由から、使用する型が基本クラスとして使われる場合に、コンストラクターの本文で依存関係プロパティの値を設定すると問題が起こる可能性があるため、注意する必要があります。  <xref:System.Windows.DependencyObject> コンストラクターを実装するときには、依存関係プロパティの状態および付随するコールバックに関する固有の問題を回避するための特定のパターンがあります。ここでは、そのパターンについて説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Property_System_Virtual_Methods"></a>   
+## プロパティ システムの仮想メソッド  
+ 依存関係プロパティの値を設定する <xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しの計算中には、<xref:System.Windows.ValidateValueCallback>、<xref:System.Windows.PropertyChangedCallback>、<xref:System.Windows.CoerceValueCallback>、<xref:System.Windows.DependencyObject.OnPropertyChanged%2A> の各仮想メソッドまたはコールバックが潜在的に呼び出されます。  これらの仮想メソッドまたはコールバックは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のプロパティ システムと依存関係プロパティの汎用性を高めるうえで、それぞれ特定の目的を果たします。  これらの仮想メソッドを使用してプロパティ値の決定をカスタマイズする方法については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  
+  
+### FXCop のルール強制とプロパティ システムの仮想メソッドの比較  
+ ビルド プロセスの一部として Microsoft ツールの FXCop を使用している場合、基本コンストラクターを呼び出す特定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] フレームワーク クラスを派生させるとき、または派生クラスで独自の依存関係プロパティを実装するときに、FXCop の特定のルール違反が発生することがあります。  この違反に対する名前文字列は、次のとおりです。  
+  
+ `DoNotCallOverridableMethodsInConstructors`  
+  
+ このルールは、FXCop に設定されている既定のパブリック ルールの一部です。  このルールによって報告されるのは、依存関係プロパティ システムの仮想メソッドを最終的に呼び出す、依存関係プロパティ システム内のトレースです。  このルール違反は、このトピックで説明されている推奨コンストラクター パターンに従っている場合も表示され続けるため、FXCop のルール セット設定でこのルールを無効にするか抑制する必要があります。  
+  
+### 既存のクラスの使用ではなくクラスの派生が大半の原因  
+ このルールによって報告される問題は、コンストラクターで仮想メソッドを呼び出すように実装したクラスが派生される場合に発生します。  クラスをシールする場合、クラスが派生されないとわかっている場合、またはクラスが派生されないように強制する場合は、ここで説明する内容や FXCop のルールによって起こる問題は該当しません。  ただし、テンプレートや拡張可能なコントロール ライブラリのセットを作成する場合などのように、基本クラスとして使用されることを想定したクラスを作成する場合は、ここで説明されているコンストラクターの推奨パターンに従う必要があります。  
+  
+### 既定のコンストラクターにおいて、コールバックによって要求されるすべての値の初期化の必要性  
+ 任意のクラスのオーバーライドまたはコールバック \(「プロパティ システムの仮想メソッド」の一覧のコールバック\) によって使用されるすべてのインスタンス メンバーは、クラスの既定のコンストラクターで初期化する必要があります。これは、既定以外のコンストラクターのパラメーターによって値の一部に "実際の" 値が入る場合も同様です。  
+  
+ 次のコード例 \(および以降の例\) は、この規則に違反する擬似 C\# コードの例であり、問題を説明しています。  
+  
+```  
+public class MyClass : DependencyObject  
+{  
+    public MyClass() {}  
+    public MyClass(object toSetWobble)  
+        : this()  
+    {  
+        Wobble = toSetWobble; //this is backed by a DependencyProperty  
+        _myList = new ArrayList();    // this line should be in the default ctor  
+    }  
+    public static readonly DependencyProperty WobbleProperty =   
+        DependencyProperty.Register("Wobble", typeof(object), typeof(MyClass));  
+    public object Wobble  
+    {  
+        get { return GetValue(WobbleProperty); }  
+        set { SetValue(WobbleProperty, value); }  
+    }  
+    protected override void OnPropertyChanged(DependencyPropertyChangedEventArgs e)  
+    {  
+        int count = _myList.Count;    // null-reference exception  
+    }  
+    private ArrayList _myList;  
+}  
+```  
+  
+ アプリケーション コードによって `new MyClass(objectvalue)` が呼び出されると、既定のコンストラクターと基本クラスのコンストラクターが呼び出されます。  次に、`Property1 = object1` が設定されると、対応する `MyClass` <xref:System.Windows.DependencyObject> の仮想メソッドの `OnPropertyChanged` が呼び出されます。  オーバーライドは、まだ初期化されていない `_myList` を参照します。  
+  
+ これらの問題を回避する方法の 1 つは、コールバックが他の依存関係プロパティだけを使用し、それぞれの使用する依存関係プロパティが、登録済みのメタデータの一部として確立された既定値を持つようにすることです。  
+  
+<a name="Safe_Constructor_Patterns"></a>   
+## 安全なコンストラクター パターン  
+ クラスが基本クラスとして使用される場合の不完全な初期化のリスクを回避するには、次のパターンに従います。  
+  
+#### 基本の初期化を呼び出す既定のコンストラクター  
+ 次の例では、これらのコンストラクターを実装して、基本の初期化を呼び出します。  
+  
+```  
+public MyClass : SomeBaseClass {  
+    public MyClass() : base() {  
+        // ALL class initialization, including initial defaults for   
+        // possible values that other ctors specify or that callbacks need.  
+    }  
+}  
+```  
+  
+#### 既定外の \(簡易\) コンストラクター \(すべての基本シグネチャと一致しない場合\)  
+ これらのコンストラクターがパラメーターを使用して初期化の依存関係プロパティを設定する場合は、最初に初期化のための独自のクラスの既定のコンストラクターを呼び出し、次にパラメーターを使用して依存関係プロパティを設定します。  この場合、クラスによって定義された依存関係プロパティ、または基本クラスから継承された依存関係プロパティのどちらかを使用できますが、いずれの場合も次のパターンを使用します。  
+  
+```  
+public MyClass : SomeBaseClass {  
+    public MyClass(object toSetProperty1) : this() {  
+        // Class initialization NOT done by default.  
+        // Then, set properties to values as passed in ctor parameters.  
+        Property1 = toSetProperty1;  
+    }  
+}  
+```  
+  
+#### 既定外の \(簡易\) コンストラクター \(基本シグネチャと一致しない場合\)  
+ 同じパラメーター化を使用して基本コンストラクターを呼び出す代わりに、独自のクラスの既定のコンストラクターを再び呼び出します。  基本初期化子を呼び出さないでください。代わりに、`this()` を呼び出す必要があります。  次に、渡されたパラメーターを関連するプロパティを設定する値として使用し、元のコンストラクターの動作を複製します。  特定のパラメーターを設定するプロパティを決定する場合は、元の基本コンストラクターのドキュメントを参考に使用します。  
+  
+```  
+public MyClass : SomeBaseClass {  
+    public MyClass(object toSetProperty1) : this() {  
+        // Class initialization NOT done by default.  
+        // Then, set properties to values as passed in ctor parameters.  
+        Property1 = toSetProperty1;  
+    }  
+}  
+```  
+  
+#### すべてのシグネチャを一致させる必要性  
+ 基本型が複数のシグネチャを持つ場合は、すべての可能なシグネチャを、さらにプロパティを設定する前に、クラスの既定のコンストラクターを呼び出す推奨パターンを使用する独自のコンストラクターの実装に意図的に一致させる必要があります。  
+  
+#### SetValue による依存関係プロパティの設定  
+ プロパティの設定の利便性のためにラッパーを持たないプロパティを設定し、<xref:System.Windows.DependencyObject.SetValue%2A> を使用して値を設定する場合は、同じパターンが適用されます。  コンストラクター パラメーターを介して渡される <xref:System.Windows.DependencyObject.SetValue%2A> の呼び出しもまた、初期化のためのクラスの既定のコンストラクターを呼び出します。  
+  
+## 参照  
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/sample-opentype-font-pack.md b/docs/framework/wpf/advanced/sample-opentype-font-pack.md
new file mode 100644
index 00000000000..40854981303
--- /dev/null
+++ b/docs/framework/wpf/advanced/sample-opentype-font-pack.md
@@ -0,0 +1,67 @@
+---
+title: "OpenType フォント パックのサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フォント, OpenType フォント パック"
+  - "OpenType フォント パック"
+  - "タイポグラフィ, OpenType フォント パック"
+ms.assetid: 56b46fa1-a44e-419b-8f14-25ad51c715c3
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# OpenType フォント パックのサンプル
+ここでは、[!INCLUDE[TLA2#tla_wcsdk](../../../../includes/tla2sharptla-wcsdk-md.md)] で配布されている、サンプルの [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントの概要について説明します。  サンプル フォントは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションで使用可能な拡張 [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] 機能をサポートしています。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overview"></a>   
+## OpenType フォント パックのフォント  
+ [!INCLUDE[TLA2#tla_wcsdk](../../../../includes/tla2sharptla-wcsdk-md.md)] には、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションの作成に使用できる一連の [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントがサンプルとして用意されています。  サンプル フォントは、Ascender Corporation のライセンスを受けて提供されています。  これらのフォントには、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] 形式で定義されているすべての機能のサブセットだけが実装されています。  次の表に、サンプルの [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォント名の一覧を示します。  
+  
+|**名前**|**File**|  
+|------------|--------------|  
+|Kootenay|Kooten.ttf|  
+|Lindsey|Linds.ttf|  
+|Miramonte|Miramo.ttf|  
+|Miramonte Bold|Miramob.ttf|  
+|Pericles|Peric.ttf|  
+|Pericles Light|Pericl.ttf|  
+|Pescadero|Pesca.ttf|  
+|Pescadero Bold|Pescab.ttf|  
+  
+ 次に示すのは、サンプルの [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントです。  
+  
+ ![サンプル フォント パック内のフォント名の一覧](../../../../docs/framework/wpf/advanced/media/samplefontpack01.png "samplefontpack01")  
+OpenType フォント パックのフォント  
+  
+ サンプル フォントは、Ascender Corporation のライセンスを受けて提供されています。  Ascender は高度なフォント製品を提供する企業です。  サンプル フォントの拡張版またはカスタム版のライセンスを受けるには、[Ascender Corporation の Web サイト](http://go.microsoft.com/fwlink/?LinkId=182627)を参照してください。  
+  
+> [!NOTE]
+>  アプリケーションに埋め込む、または別の方法で再頒布するフォントについて、必要なライセンス権限を取得することは、開発者であるユーザーの責任で行ってください。  
+  
+<a name="installing_the_fonts"></a>   
+## フォントのインストール  
+ サンプルの [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントは、既定の [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] フォント ディレクトリ **\\WINDOWS\\Fonts** にインストールできます。  フォントをインストールするには、コントロール パネルの \[フォント\] を使用します。  これらのフォントをコンピューターにインストールすると、既定の [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] フォントを参照するすべてのアプリケーションからアクセスできるようになります。フォント ファイルの名前をダブルクリックすることで、各フォントの文字をさまざまなサイズで表示して確認することができます。  次のスクリーン ショットは、Lindsey フォント ファイル \(Linds.ttf\) を表示したものです。  
+  
+ ![Lindsey フォント &#40;OpenType&#41;](../../../../docs/framework/wpf/advanced/media/typographyinwpf-04.png "TypographyInWPF\_04")  
+Lindsey フォントの表示  
+  
+<a name="using_the_fonts"></a>   
+## フォントの使用  
+ アプリケーションでフォントを使用するには、2 とおりの方法があります。  フォントは、アセンブリにリソースとして埋め込まれていないプロジェクト コンテンツ項目としてアプリケーションに追加できます。  フォントは、アプリケーションのアセンブリ ファイルに埋め込まれたプロジェクト リソース項目としてアプリケーションに追加することもできます。  詳細については、「[アプリケーションでのフォントのパッケージング](../../../../docs/framework/wpf/advanced/packaging-fonts-with-applications.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Documents.Typography>   
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)   
+ [アプリケーションでのフォントのパッケージング](../../../../docs/framework/wpf/advanced/packaging-fonts-with-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/serialization-limitations-of-xamlwriter-save.md b/docs/framework/wpf/advanced/serialization-limitations-of-xamlwriter-save.md
new file mode 100644
index 00000000000..d6cea4ee2fb
--- /dev/null
+++ b/docs/framework/wpf/advanced/serialization-limitations-of-xamlwriter-save.md
@@ -0,0 +1,52 @@
+---
+title: "XamlWriter.Save のシリアル化の制限 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "制限 (XamlWriter.Save の)"
+  - "シリアル化の制限 (XamlWriter.Save の)"
+  - "XamlWriter.Save, シリアル化の制限"
+ms.assetid: f86acc91-2b67-4039-8555-505734491d36
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# XamlWriter.Save のシリアル化の制限
+[!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] <xref:System.Windows.Markup.XamlWriter.Save%2A> を使用して、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションの内容を [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルとしてシリアル化できます。  ただし、シリアル化される対象には注意すべき制限がいくつかあります。  このトピックでは、これらの制限と全般的な考慮事項をいくつか説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Run_Time__Not_Design_Time_Representation"></a>   
+## ランタイム \(非デザイン タイム\) 表現  
+ <xref:System.Windows.Markup.XamlWriter.Save%2A> の呼び出しによるシリアル化の基本概念は、実行時にシリアル化されているオブジェクトが結果として表れることです。  元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルのデザイン タイム プロパティの多くは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]がメモリ内オブジェクトとして読み込まれる時点で既に最適化されているか、失われている可能性があり、シリアル化するために<xref:System.Windows.Markup.XamlWriter.Save%2A>を呼び出したときには保持されていません。  シリアル化された結果は、アプリケーションの構築された論理ツリーを効率的に表していますが、必ずしも、これを生成した元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のものではありません。  これらの問題により、広範な [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] デザイン サーフェイスの一部として <xref:System.Windows.Markup.XamlWriter.Save%2A> のシリアル化を使用することが極めて困難になります。  
+  
+<a name="Serialization_is_Self_Contained"></a>   
+## シリアル化の内部格納  
+ <xref:System.Windows.Markup.XamlWriter.Save%2A> のシリアル化された出力は内部格納されます。つまり、シリアル化されたものはすべて、単一ルート要素と共に [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の単一ページ内に含まれ、[!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] 以外による外部参照はされません。  たとえば、ページがアプリケーション リソースからリソースを参照した場合、これらのリソースは、シリアル化されているページのコンポーネントであるかのように表示されます。  
+  
+<a name="Extension_References_are_Dereferenced"></a>   
+## 拡張参照の参照解除  
+ さまざまなマークアップ エクステンション形式によって作成されたオブジェクトの一般的な参照 \(`StaticResource`、`Binding` など\) は、シリアル化プロセスによって参照解除されます。  これらは、メモリ内のオブジェクトがアプリケーション ランタイムによって作成された時点で既に参照解除されており、<xref:System.Windows.Markup.XamlWriter.Save%2A> ロジックは、このようなシリアル化された出力の参照を復元するために、元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を再確認することはありません。  これにより、データ バインディングされた値または取得されたリソース値はすべて、ランタイム表現により前回使用された値に潜在的に固定され、ローカルに設定された他の値とこのような値を区別するための限定的または間接的な機能だけを持ちます。  また、プロジェクト内にイメージが存在するので、イメージも、元のソース参照としてではなくイメージへのオブジェクト参照としてシリアル化され、元々参照されていたいかなるファイル名または [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] も失われます。  同一ページ内で宣言されたリソースも、これらが参照されたポイントにシリアル化され、リソース コレクションのキーとしては保持されません。  
+  
+<a name="Event_Handling_is_Not_Preserved"></a>   
+## 保持されないイベント処理  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を介して追加されたイベント ハンドラーがシリアル化されない場合、これらは保持されません。  分離コード \(および関連 x:Code 機能\) を持たない [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は、ランタイム手続きロジックをシリアル化する方法がありません。  シリアル化は内蔵されていて、論理ツリーに制限されているため、イベント ハンドラーを格納するための機能がありません。  その結果、イベント ハンドラー属性 \(属性自体とハンドラーの名前を表す文字列共\) は、出力 [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] から削除されます。  
+  
+<a name="Realistic_Scenarios_for_Use_of_XAMLWriter_Save"></a>   
+## XAMLWriter.Save を使用するための現実的なシナリオ  
+ ここに示された制限は相当な量ですが、<xref:System.Windows.Markup.XamlWriter.Save%2A> をシリアル化に使用するための適切なシナリオがいくつかあります。  
+  
+-   ベクターまたはグラフィカル出力 : レンダリングされた領域の出力を使用して、再読み込みの際に同じベクターまたはグラフィックスを再現できます。  
+  
+-   リッチ テキストとフロー ドキュメント : テキストと要素の書式およびその中に含まれる要素のコンテインメントはすべて、出力に保持されます。  これは、クリップボードに近似した機能に役立つ場合があります。  
+  
+-   ビジネス オブジェクト データの保持 : ビジネス オブジェクトが基本的な [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 規則 \(カスタム コンストラクターと変換に対し参照ごとのプロパティ値を提供する、など\) に従う限り、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データなどのデータをカスタム要素に格納した場合、これらのビジネス オブジェクトはシリアル化によって永続的なものになります。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/sharing-message-loops-between-win32-and-wpf.md b/docs/framework/wpf/advanced/sharing-message-loops-between-win32-and-wpf.md
new file mode 100644
index 00000000000..6c26f62154b
--- /dev/null
+++ b/docs/framework/wpf/advanced/sharing-message-loops-between-win32-and-wpf.md
@@ -0,0 +1,76 @@
+---
+title: "Win32 と WPF 間でのメッセージ ループの共有 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "相互運用性 [WPF], Win32"
+  - "メッセージ ループ [WPF]"
+  - "共有 (メッセージ ループを)"
+  - "Win32 コード, 共有 (メッセージ ループを)"
+ms.assetid: 39ee888c-e5ec-41c8-b11f-7b851a554442
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Win32 と WPF 間でのメッセージ ループの共有
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] と相互運用するようにメッセージ ループを実装する方法について説明します。<xref:System.Windows.Threading.Dispatcher> で公開されている既存のメッセージ ループを使用する方法と、相互運用コードの [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] 側で別のメッセージ ループを作成する方法があります。  
+  
+## ComponentDispatcher とメッセージ ループ  
+ 相互運用とキーボード イベント サポートの一般的なシナリオでは、<xref:System.Windows.Interop.IKeyboardInputSink> を実装するか、<xref:System.Windows.Interop.IKeyboardInputSink> を既に実装している <xref:System.Windows.Interop.HwndSource> や <xref:System.Windows.Interop.HwndHost> などのクラスからサブクラス化します。  しかし、キーボード シンク サポートは、相互運用の境界にまたがるメッセージ送受信時のメッセージ ループの要件のすべてに対応しているとは限りません。  アプリケーションのメッセージ ループ アーキテクチャの形式化を支援するために、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、メッセージ ループが従う単純なプロトコルを定義する <xref:System.Windows.Interop.ComponentDispatcher> クラスが用意されています。  
+  
+ <xref:System.Windows.Interop.ComponentDispatcher> は、複数のメンバーを公開する静的クラスです。  各メソッドのスコープは、呼び出し元のスレッドに暗黙的に関連付けられます。  メッセージ ループでは、重要な局面 \(次のセクションで定義されています\) で、それらの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] のいくつかを呼び出す必要があります。  
+  
+ <xref:System.Windows.Interop.ComponentDispatcher> から提供されるイベントは、他のコンポーネント \(キーボード シンクなど\) でリッスンできます。  <xref:System.Windows.Threading.Dispatcher> クラスは、すべての適切な <xref:System.Windows.Interop.ComponentDispatcher> メソッドを適切な順序で呼び出します。  独自のメッセージ ループを実装する場合は、コードで同様に <xref:System.Windows.Interop.ComponentDispatcher> メソッドを呼び出す必要があります。  
+  
+ スレッドで <xref:System.Windows.Interop.ComponentDispatcher> メソッドを呼び出すと、そのスレッドに登録されたイベント ハンドラーだけが呼び出されます。  
+  
+## メッセージ ループの記述  
+ 独自のメッセージ ループを記述する場合に使用する <xref:System.Windows.Interop.ComponentDispatcher> メンバーのチェック リストを次に示します。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.PushModal%2A>: 独自のメッセージ ループで、スレッドがモーダルであることを示す際に呼び出す必要があります。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.PopModal%2A>: 独自のメッセージ ループで、スレッドがモーダルでなくなったことを示す際に呼び出す必要があります。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.RaiseIdle%2A>: 独自のメッセージ ループで、<xref:System.Windows.Interop.ComponentDispatcher> が <xref:System.Windows.Interop.ComponentDispatcher.ThreadIdle> イベントを発生させる必要があることを示す際に呼び出す必要があります。  <xref:System.Windows.Interop.ComponentDispatcher.IsThreadModal%2A> が `true` の場合、<xref:System.Windows.Interop.ComponentDispatcher> は <xref:System.Windows.Interop.ComponentDispatcher.ThreadIdle> を発生させません。しかし、モーダル状態であるために <xref:System.Windows.Interop.ComponentDispatcher> が応答できない場合でも、メッセージ ループは <xref:System.Windows.Interop.ComponentDispatcher.RaiseIdle%2A> を呼び出すことができます。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.RaiseThreadMessage%2A>: 独自のメッセージ ループで、新しいメッセージが使用できることを示す際に呼び出す必要があります。  戻り値は、<xref:System.Windows.Interop.ComponentDispatcher> イベントのリスナーによってメッセージが処理されたかどうかを示します。  <xref:System.Windows.Interop.ComponentDispatcher.RaiseThreadMessage%2A> が `true` \(処理済み\) を返す場合、ディスパッチャーはそのメッセージをこれ以上処理する必要がありません。  戻り値が `false` の場合、ディスパッチャーは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 関数 `TranslateMessage` を呼び出し、次に `DispatchMessage` を呼び出します。  
+  
+## ComponentDispatcher と既存のメッセージ処理の使用  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既存のメッセージ ループを利用する場合に使用する <xref:System.Windows.Interop.ComponentDispatcher> メンバーのチェックリストを次に示します。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.IsThreadModal%2A>: アプリケーションがモーダルになったかどうか \(モーダル メッセージ ループがプッシュされたなど\) を返します。  <xref:System.Windows.Interop.ComponentDispatcher> は、メッセージ ループからの <xref:System.Windows.Interop.ComponentDispatcher.PushModal%2A> 呼び出しと <xref:System.Windows.Interop.ComponentDispatcher.PopModal%2A> 呼び出しの回数を保持するため、この状態を追跡できます。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage> イベントと <xref:System.Windows.Interop.ComponentDispatcher.ThreadPreprocessMessage> イベントは、デリゲート呼び出しの標準規則に従います。  デリゲートは不特定の順番で呼び出され、最初のデリゲートがメッセージを処理済みとしてマークしても、すべてのデリゲートが呼び出されます。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.ThreadIdle>: アイドル処理を行うのに適切かつ効率的なタイミング \(保留状態の他のメッセージがスレッドに存在しない\) を示します。  スレッドがモーダルの場合、<xref:System.Windows.Interop.ComponentDispatcher.ThreadIdle> は発生しません。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage>: メッセージ ポンプが処理するすべてのメッセージに対して発生します。  
+  
+-   <xref:System.Windows.Interop.ComponentDispatcher.ThreadPreprocessMessage>: <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage> の間に処理されなかったすべてのメッセージに対して発生します。  
+  
+ <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage> イベントまたは <xref:System.Windows.Interop.ComponentDispatcher.ThreadPreprocessMessage> イベントの後に参照渡しされる、イベント データの `handled` パラメーターが `true` の場合、メッセージは処理済みであると見なされます。  `handled` が `true` の場合は、他のイベント ハンドラーが先にそのメッセージを処理したことを意味するため、ハンドラーはそのメッセージを無視する必要があります。  どちらのイベントに対するイベント ハンドラーも、メッセージを変更する可能性があります。  ディスパッチャーは、変更前の元のメッセージではなく、変更後のメッセージをディスパッチする必要があります。  <xref:System.Windows.Interop.ComponentDispatcher.ThreadPreprocessMessage> はすべてのリスナーに配信されます。ただし、アーキテクチャでは、メッセージの対象の HWND を含むトップレベルのウィンドウだけがメッセージに応じてコードを呼び出すことが意図されています。  
+  
+## HwndSource による ComponentDispatcher イベントの処理方法  
+ <xref:System.Windows.Interop.HwndSource> は、トップレベルのウィンドウである \(親 HWND を持たない\) 場合、<xref:System.Windows.Interop.ComponentDispatcher> に登録されます。  <xref:System.Windows.Interop.ComponentDispatcher.ThreadPreprocessMessage> が発生し、そのメッセージの対象が <xref:System.Windows.Interop.HwndSource> または子ウィンドウの場合、<xref:System.Windows.Interop.HwndSource> はその <xref:System.Windows.Interop.HwndSource.System%23Windows%23Interop%23IKeyboardInputSink%23TranslateAccelerator%2A>、<xref:System.Windows.Interop.IKeyboardInputSink.TranslateChar%2A>、<xref:System.Windows.Interop.IKeyboardInputSink.OnMnemonic%2A> のキーボード シンク シーケンスを呼び出します。  
+  
+ <xref:System.Windows.Interop.HwndSource> がトップレベルのウィンドウではない \(親 HWND を持つ\) 場合、処理は行われません。  トップレベルのウィンドウだけが処理の実行を求められます。また、どのようなシナリオの相互運用でも、キーボード シンクをサポートするトップレベルのウィンドウが存在することが求められます。  
+  
+ 適切なキーボード シンク メソッドが先に呼び出されずに <xref:System.Windows.Interop.HwndHost.WndProc%2A> が <xref:System.Windows.Interop.HwndSource> に対して呼び出された場合、アプリケーションは <xref:System.Windows.UIElement.KeyDown> などの上位のキーボード イベントを受け取ります。  ただし、キーボード シンク メソッドは呼び出されません。これにより、アクセス キー サポートなどの適切なキーボード入力モデルが迂回されます。  メッセージ ループが <xref:System.Windows.Interop.ComponentDispatcher> の適切なスレッドへの通知を正しく行わなかった場合、または親 HWND が正しいキーボード シンク応答を呼び出さなかった場合に、これが発生することがあります。  
+  
+ キーボード シンクに送られるメッセージに <xref:System.Windows.Interop.HwndSource.AddHook%2A> を使用してフックを追加した場合、このメッセージは HWND に送信されないことがあります。  このメッセージは、メッセージ パンプ レベルで直接処理され、`DispatchMessage` 関数に送信されないことがあります。  
+  
+## 参照  
+ <xref:System.Windows.Interop.ComponentDispatcher>   
+ <xref:System.Windows.Interop.IKeyboardInputSink>   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)   
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)   
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/staticresource-markup-extension.md b/docs/framework/wpf/advanced/staticresource-markup-extension.md
new file mode 100644
index 00000000000..00018fb708e
--- /dev/null
+++ b/docs/framework/wpf/advanced/staticresource-markup-extension.md
@@ -0,0 +1,82 @@
+---
+title: "StaticResource のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "StaticResource"
+  - "StaticResourceExtension"
+helpviewer_keywords: 
+  - "StaticResource のマークアップ拡張機能"
+  - "XAML, StaticResource マークアップ拡張機能"
+ms.assetid: 97af044c-71f1-4617-9a94-9064b68185d2
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# StaticResource のマークアップ拡張機能
+既に定義されたリソースに対する参照を検索することによって、任意の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロパティ属性の値を指定します。  そのリソースに関する検索動作は、読み込み時検索に似ています。現在の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページのマークアップとその他のアプリケーション ソースとから既に読み込まれているリソースを検索し、ランタイム オブジェクト内のプロパティ値としてそのリソース値を生成します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{StaticResource key}" .../>  
+```  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<object>  
+  <object.property>  
+<StaticResource ResourceKey="key" .../>  
+  </object.property>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`key`|要求したリソースのキー。  リソースがマークアップで作成された場合、このキーは [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)によって最初に割り当てられたものです。リソースがコードで作成された場合は、<xref:System.Windows.ResourceDictionary.Add%2A?displayProperty=fullName> を呼び出すときに `key` パラメーターで指定されたものです。|  
+  
+## 解説  
+  
+> [!IMPORTANT]
+>  `StaticResource` では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル内の後方で語彙的に定義されているリソースに対する前方参照を行わないようにします。  この操作はサポートされていません。前方参照を試行すると、参照に失敗しなくても、<xref:System.Windows.ResourceDictionary> を示す内部ハッシュ テーブルが検索されるために読み込み時パフォーマンスが低下します。  リソース ディクショナリの構成を調整して、前方参照を回避できるようにすることをお勧めします。  前方参照を使用する必要がある場合は、代わりに [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)を使用してください。  
+  
+ 指定した <xref:System.Windows.StaticResourceExtension.ResourceKey%2A> は、ページ、アプリケーション、使用可能なコントロール テーマと外部リソース、またはシステム リソースで [x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)によって識別された、既存のリソースに対応するキーでなければなりません。  リソースの検索はその順序で行われます。  静的リソースと動的リソースのリソース検索動作の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ リソース キーは、[XamlName の文法](../../../../docs/framework/xaml-services/xamlname-grammar.md)で定義されている任意の文字列にすることができます。  <xref:System.Type> などの他のオブジェクト型にすることもできます。  <xref:System.Type> キーは、暗黙のスタイル キーを通して、コントロールをテーマごとにどのようにデザインするかを決定するのに重要です。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」を参照してください。  
+  
+ これとは別の、リソース参照の宣言的手段には、[DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)を使用する方法があります。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `StaticResource` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.StaticResourceExtension> 拡張クラスの <xref:System.Windows.StaticResourceExtension.ResourceKey%2A> 値として割り当てられます。  
+  
+ `StaticResource` は、オブジェクト要素構文で使用できます。  この場合、<xref:System.Windows.StaticResourceExtension.ResourceKey%2A> プロパティの値の指定は必須です。  
+  
+ `StaticResource` は、<xref:System.Windows.StaticResourceExtension.ResourceKey%2A> プロパティをプロパティおよび値のペアとして指定する詳細出力属性使用でも使用できます。  
+  
+```  
+<object property="{StaticResource ResourceKey=key}" .../>  
+```  
+  
+ 詳細出力の使用は、複数の設定可能プロパティを持つ拡張機能や、一部のプロパティがオプションである場合に役立ちます。  `StaticResource` には、必須の設定可能プロパティが 1 つしか存在しないため、このような詳細出力の使用は一般的ではありません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサ実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.StaticResourceExtension> クラスによって定義されます。  
+  
+ `StaticResource` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のすべてのマークアップ拡張機能では、それぞれの属性構文で { と } の 2 つの記号を使用します。これは規約であり、これに従って [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [リソースとコード](../../../../docs/framework/wpf/advanced/resources-and-code.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/storing-ink.md b/docs/framework/wpf/advanced/storing-ink.md
new file mode 100644
index 00000000000..89d9ae187f3
--- /dev/null
+++ b/docs/framework/wpf/advanced/storing-ink.md
@@ -0,0 +1,43 @@
+---
+title: "インクの格納 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Ink Serialized Format (ISF)"
+  - "インク, 格納"
+  - "ISF (Ink Serialized Format)"
+  - "取得 (インクを)"
+  - "格納 (インクを)"
+ms.assetid: a3f6d16b-d682-4680-9965-907332b4d2b8
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# インクの格納
+<xref:System.Windows.Ink.StrokeCollection.Save%2A> メソッドは、インクを ISF \(Ink Serialized Format\) として格納するためのサポートを提供します。  <xref:System.Windows.Ink.StrokeCollection> クラスのコンストラクターは、インク データを読み取るためのサポートを提供します。  
+  
+## インクの格納と取得  
+ ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プラットフォームでインクを格納および取得する方法について説明します。  
+  
+ ボタン クリックのイベント ハンドラーを実装する例を次に示します。ここでは、\[名前を付けて保存\] ダイアログ ボックスをユーザーに示し、<xref:System.Windows.Controls.InkCanvas> からのインクをファイルに保存します。  
+  
+ [!code-csharp[DigitalInkTopics#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml.cs#12)]
+ [!code-vb[DigitalInkTopics#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DigitalInkTopics/VisualBasic/Window1.xaml.vb#12)]  
+  
+ ボタン クリックのイベント ハンドラーを実装する例を次に示します。ここでは、\[File Open\] ダイアログ ボックスをユーザーに示し、ファイルから <xref:System.Windows.Controls.InkCanvas> 要素へインクを読み込みます。  
+  
+ [!code-csharp[DigitalInkTopics#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DigitalInkTopics/CSharp/Window1.xaml.cs#13)]
+ [!code-vb[DigitalInkTopics#13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DigitalInkTopics/VisualBasic/Window1.xaml.vb#13)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.InkCanvas>   
+ [Windows Presentation Foundation](../../../../docs/framework/wpf/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md b/docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md
new file mode 100644
index 00000000000..dc9abaee4d3
--- /dev/null
+++ b/docs/framework/wpf/advanced/styling-for-focus-in-controls-and-focusvisualstyle.md
@@ -0,0 +1,105 @@
+---
+title: "コントロールのフォーカスのスタイルと FocusVisualStyle | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キーボード フォーカス"
+  - "フォーカスの外観のスタイル設定"
+  - "フォーカス表示スタイルのスタイル"
+ms.assetid: 786ac576-011b-4d72-913b-558deccb9b35
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# コントロールのフォーカスのスタイルと FocusVisualStyle
+\<?xml version="1.0" encoding="utf-8"?>
+\<developerConceptualDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddue.schemas.microsoft.com/authoring/2003/5 http://dduestorage.blob.core.windows.net/ddueschema/developer.xsd">
+  <introduction>
+    <para>
+      <token>相互</token>がキーボード フォーカスを受け取ったときに、コントロールの外観を変更するための&2; つの並列メカニズムを提供します。最初のメカニズムはなどのプロパティをプロパティ set アクセス操作子を使用して、 <codeEntityReference autoUpgrade="true">P:System.Windows.UIElement.IsKeyboardFocused</codeEntityReference>スタイルまたはコントロールに適用されているテンプレート内で。2 番目の機構の値として個別のスタイルを提供する、 <codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.FocusVisualStyle</codeEntityReference>プロパティ「フォーカス表示スタイル」、置換することで、コントロールまたはその他の UI 要素のビジュアル ツリーを変更するのではなく、コントロールの上に描画される装飾には別個のビジュアル ツリーを作成します。このトピックでは、これらのメカニズムが適切なシナリオについて説明します。</para> 
+    <para>
+      <token>アウトラインの自動作成</token>
+    </para>
+  </introduction>
+  <section address="Purpose">
+    <title>目的のフォーカス表示スタイル</title>
+    <content>
+      <para>フォーカス表示スタイル機能は、UI 要素にキーボード ナビゲーションに基づいてビジュアルのユーザーからのフィードバックを導入するため共通「オブジェクト モデル」を提供します。新しいテンプレートをコントロールに適用するか、特定のテンプレート構成を知ることがなく可能です。</para>
+      <para>フォーカス表示スタイル機能は、コントロール テンプレートを知らなくても機能するために正確にフォーカス表示スタイルを使用してコントロールの表示可能な視覚的なフィードバックが制限とは限りません。コントロールの描画、テンプレートを通じてによって作成されたビジュアル ツリーの上に別のビジュアル ツリー (装飾) をオーバーレイには、機能が実際にです。この次の値を格納するスタイルを使用して別個のビジュアル ツリーを定義する、 <codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.FocusVisualStyle</codeEntityReference>プロパティです。</para>
+    </content>
+  </section>
+  <section address="Default">
+    <title>既定のフォーカス ビジュアル スタイル動作</title>
+    <content>
+      <para>のみフォーカス操作が開始されたとき、キーボードでフォーカス表示スタイルの機能です。マウス操作やプログラムでのフォーカスが変更には、フォーカス表示スタイルのモードが無効にします。フォーカスのモードの違いの詳細については、次を参照してください\<link xlink:href="0230c4eb-0c8a-462b-ac4b-ae3e511659f4">フォーカス概要</link>。</para> 。
+      <para>コントロールのテーマには、テーマでのすべてのコントロールのフォーカス表示スタイルになる既定フォーカス表示スタイルの動作が含まれます。このテーマ スタイルは、静的なキーの値によって識別される<codeEntityReference autoUpgrade="true">P:System.Windows.SystemParameters.FocusVisualStyleKey</codeEntityReference>します。アプリケーション レベルで、独自のフォーカス表示スタイルを宣言するときに、この既定のスタイルの動作のテーマからを置き換えます。または、全体のテーマを定義する場合は、テーマ全体の既定の動作の線のスタイルを定義するこれと同じキーを使用する必要があります。</para>
+      <para>テーマ、既定のフォーカス表示スタイルが一般に非常にシンプルです。おおよその近似値を次に示します。</para>
+      <code>&lt;Style x:Key="{x:Static SystemParameters.FocusVisualStyleKey}"&gt;
+  &lt;Setter Property="Control.Template"&gt;
+    &lt;Setter.Value&gt;
+      &lt;ControlTemplate&gt;
+        &lt;Rectangle StrokeThickness="1"
+          Stroke="Black"
+          StrokeDashArray="1 2"
+          SnapsToDevicePixels="true"/&gt;
+      &lt;/ControlTemplate&gt;
+    &lt;/Setter.Value&gt;
+  &lt;/Setter&gt;
+&lt;/Style&gt;</code>
+    </content>
+  </section>
+  <section address="When">
+    <title>フォーカスの Visual スタイルを使用するタイミング</title>
+    <content>
+      <para>概念的には、コントロールに適用されるフォーカス表示スタイルの外観はで一貫しているコントロールをします。一貫性を実現する&1; つの方法では、コントロールから、テーマで定義されている各コントロールを取得、まったく同じフォーカス表示スタイル、またはスタイルのいくつかのバリエーションのいずれかを全体のテーマを作成する場合にのみ、visual スタイルが関連する視覚的にフォーカスをコントロールに変更します。ページや UI にキーボード フォーカスのすべての要素のスタイルを設定する同じスタイル (または同様のスタイル) を使用する場合があります。</para>
+      <para>設定<codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.FocusVisualStyle</codeEntityReference>テーマの一部ではない個別のコントロールのスタイルでは、フォーカスの使用目的ではない視覚スタイル。これは、コントロール間の一貫性のない visual 動作は、キーボード フォーカスに関してユーザー エクスペリエンスに混乱する可能性があるためです。トリガー (スタイルの) などを使用して入力の状態をそれぞれのプロパティをはるかに優れた方法は、意図的に不整合があるテーマにわたって、キーボード フォーカス コントロール固有の動作をコントロールする場合<codeEntityReference autoUpgrade="true">において</codeEntityReference>または<codeEntityReference autoUpgrade="true">P:System.Windows.UIElement.IsKeyboardFocused</codeEntityReference>.</para>
+      <para>フォーカス表示スタイルがキーボード フォーカス専用の機能です。そのため、フォーカス表示スタイルは、ユーザー補助機能の種類です。マウスを使用しているかどうか、フォーカスの任意の型の UI の変更をする場合はフォーカス表示スタイルを使用しないでくださいし、set アクセス操作子とスタイルやなどの全般的な焦点プロパティの値から作業するテンプレート内のトリガーを使用する必要がありますキーボード、またはプログラムを使用して、次を<languageKeyword>IsFocused</languageKeyword>または<languageKeyword>IsFocusWithin</languageKeyword>します。</para>
+    </content>
+  </section>
+  <section address="How">
+    <title>フォーカス表示スタイルを作成する方法</title>
+    <content>
+      <para>フォーカス表示スタイルがある用に作成する、スタイル、<codeEntityReference autoUpgrade="true">見ると</codeEntityReference>の<codeEntityReference autoUpgrade="true">動作</codeEntityReference>します。スタイルがの主要な要素で構成する必要があります、<codeEntityReference autoUpgrade="true">由来</codeEntityReference>します。フォーカス表示スタイルが割り当てられている型となる対象の型を指定しない、 <codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.FocusVisualStyle</codeEntityReference>.</para>
+      <para>対象の型は常にため<codeEntityReference autoUpgrade="true">動作</codeEntityReference>、すべてのコントロールに共通するプロパティを使用してスタイルを設定する必要があります (のプロパティを使用して、<codeEntityReference autoUpgrade="true">動作</codeEntityReference>クラスとその基本クラス)。UI 要素にオーバーレイとして正しく機能して、コントロールの機能領域を隠さないテンプレートを作成する必要があります。一般に、この表示を意味する、視覚的なフィードバック必要がありますコントロールのマージンの外部またはコントロールのヒット テストがブロックされていない一時的または控え目な効果としてフォーカス表示スタイルが適用されます。テンプレート バインディングで使用できるサイズ変更とオーバーレイ テンプレートの配置を決定するのに便利なプロパティには、 <codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.ActualHeight</codeEntityReference>、 <codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.ActualWidth</codeEntityReference>、<codeEntityReference autoUpgrade="true">子</codeEntityReference>、および<codeEntityReference autoUpgrade="true">もう&1; つ</codeEntityReference>します。</para>
+    </content>
+  </section>
+  <section address="Alternatives">
+    <title>フォーカス表示スタイルを使用に代わる方法</title>
+    <content>
+      <para>フォーカス表示スタイルを使用してがない場合、適切ないずれかをスタイルを設定するための単一のコントロールまたはコントロール テンプレートをより細かく制御する必要があるためにがあるその他の多くのアクセス可能なプロパティやフォーカスのある変更に応じて、視覚的な動作を作成できる手法</para>。
+      <para>トリガー、set アクセス操作子、およびイベントの set アクセス操作子がすべてで詳しく説明されている\<link xlink:href="481765e5-5467-4a75-9f7b-e10e2ac410d9">スタイルとテンプレート</link>します。ルーティング イベントの処理は、後ほど\<link xlink:href="1a2189ae-13b4-45b0-b12c-8de2e49c29d2">ルーティング イベントの概要</link>します。</para>
+    </content>
+    <sections>
+      <section>
+        <title>IsKeyboardFocused</title>
+        <content>
+          <para>にキーボード フォーカスを具体的には興味がある場合、 <codeEntityReference autoUpgrade="true">P:System.Windows.UIElement.IsKeyboardFocused</codeEntityReference>プロパティに対して依存関係プロパティを使用できる<codeEntityReference autoUpgrade="true">T:System.Windows.Trigger</codeEntityReference>します。スタイルまたはテンプレートのプロパティ トリガーは、1 つのコントロールについて非常に具体的には、必ずしも視覚的に一致しない他のコントロールのキーボード フォーカスの動作は、キーボード フォーカスの動作を定義するための適切な手法です。</para>
+          <para>別のような依存関係プロパティが<codeEntityReference autoUpgrade="true">P:System.Windows.UIElement.IsKeyboardFocusWithin</codeEntityReference>、どこかに合成内またはコントロールの機能領域内では、視覚的に、そのキーボード フォーカスを呼び出そうとする場合に使用する適切なする必要があります。たとえば、配置することがあります、 <codeEntityReference autoUpgrade="true">P:System.Windows.UIElement.IsKeyboardFocusWithin</codeEntityReference>そのパネル内の個々 の要素上にあることなど、いくつかのコントロールをグループ化するパネルれる場合でも、キーボード フォーカスがより正確に可能性がありますが、異なるトリガー</para> 。
+          <para>イベントを使用することもできます。 <codeEntityReference autoUpgrade="true">E:System.Windows.UIElement.GotKeyboardFocus</codeEntityReference>と<codeEntityReference autoUpgrade="true">E:System.Windows.UIElement.LostKeyboardFocus</codeEntityReference> (と同様に、プレビューの同等)。基準として、これらのイベントを使用することができます、<codeEntityReference autoUpgrade="true">可能な</codeEntityReference>、分離コードで、イベントのハンドラーを記述することもできます。</para>
+        </content>
+      </section>
+      <section>
+        <title>その他のフォーカス プロパティ</title>
+        <content>
+          <para>は setter を基本やをトリガーする必要がありますフォーカスを変更するすべての考えられる原因、視覚的な動作を作成する場合は、<codeEntityReference autoUpgrade="true">において</codeEntityReference>依存関係プロパティまたは上、<codeEntityReference autoUpgrade="true">また</codeEntityReference>または<codeEntityReference autoUpgrade="true">E:System.Windows.UIElement.LostFocus</codeEntityReference>に使用されるイベント、<codeEntityReference autoUpgrade="true">可能な</codeEntityReference>です。</para>
+        </content>
+      </section>
+    </sections>
+  </section>
+  <relatedTopics>
+\<link xlink:href="481765e5-5467-4a75-9f7b-e10e2ac410d9">スタイルとテンプレート</link>
+\<link xlink:href="0230c4eb-0c8a-462b-ac4b-ae3e511659f4">フォーカスの概要</link>
+\<link xlink:href="ee5258b7-6567-415a-9b1c-c0cbe46e79ef">入力の概要</link>
+<codeEntityReference autoUpgrade="true">P:System.Windows.FrameworkElement.FocusVisualStyle</codeEntityReference>
+\<legacyLink xlink:href="e7ec856e-41ee-47b1-9d57-b75a3dad088c">ユーザー補助機能</legacyLink>
+</relatedTopics>
+</developerConceptualDocument>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/table-overview.md b/docs/framework/wpf/advanced/table-overview.md
new file mode 100644
index 00000000000..2a3b5c4dd58
--- /dev/null
+++ b/docs/framework/wpf/advanced/table-overview.md
@@ -0,0 +1,186 @@
+---
+title: "テーブルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, テーブル"
+  - "フロー コンテンツ要素 [WPF], テーブル"
+  - "テーブル"
+ms.assetid: 5e1105f4-8fc4-473a-ba55-88c8e71386e6
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# テーブルの概要
+<xref:System.Windows.Documents.Table> は、フロー ドキュメント コンテンツのグリッド式の表示をサポートする、ブロック レベルの要素です。  この要素は、その柔軟性により非常に便利ですが、正しく理解して使用するのが難しいとも言えます。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [テーブルの基本](#table_basics)  
+  
+-   [テーブルとグリッドの相違点](#table_vs_Grid)  
+  
+-   [テーブルの基本構造](#basic_table_structure)  
+  
+-   [テーブルの内容](#table_containment)  
+  
+-   [行のグループ化](#row_groupings)  
+  
+-   [背景のレンダリングの優先順位](#rednering_precedence)  
+  
+-   [複数の行または列にまたがるセル](#spanning_rows_or_columns)  
+  
+-   [テーブルとコードのバインディング](#building_a_table_with_code)  
+  
+-   [関連トピック](#see_also)  
+  
+<a name="table_basics"></a>   
+## テーブルの基本  
+  
+<a name="table_vs_Grid"></a>   
+### テーブルとグリッドの相違点  
+ <xref:System.Windows.Documents.Table> と <xref:System.Windows.Controls.Grid> には共通の機能がいくつかありますが、それぞれが最も適している状況は異なります。  <xref:System.Windows.Documents.Table> は、フロー コンテンツ内で使用するために設計されています \(フロー コンテンツの詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください\)。  グリッドは、フォーム内 \(基本的にはフロー コンテンツ外の任意の場所\) で使用するのに最適です。  <xref:System.Windows.Documents.FlowDocument> 内では、<xref:System.Windows.Documents.Table> は改ページ位置の自動修正、列の再配置、およびコンテンツの選択をサポートしますが、<xref:System.Windows.Controls.Grid> はサポートしません。  一方、<xref:System.Windows.Controls.Grid> は、さまざまな理由から <xref:System.Windows.Documents.FlowDocument> の外で使用するのに適しています。たとえば、<xref:System.Windows.Controls.Grid> は行と列のインデックスに基づいて要素を追加しますが、<xref:System.Windows.Documents.Table> は追加しません。  <xref:System.Windows.Controls.Grid> 要素により、子のコンテンツのレイヤーを表示でき、1 つの "セル" 内に複数の要素を含むことができます。<xref:System.Windows.Documents.Table> は、レイヤー表示をサポートしません。  <xref:System.Windows.Controls.Grid> の子要素は、"セル" 境界の領域に対して絶対位置で配置できます。  <xref:System.Windows.Documents.Table> は、この機能をサポートしていません。  最後に、<xref:System.Windows.Controls.Grid> は <xref:System.Windows.Documents.Table> よりもリソースの使用量が少ないため、パフォーマンスを向上させるには <xref:System.Windows.Controls.Grid> の使用をお勧めします。  
+  
+<a name="basic_table_structure"></a>   
+### テーブルの基本構造  
+ <xref:System.Windows.Documents.Table> は、列 \(<xref:System.Windows.Documents.TableColumn> 要素で表されます\) と行 \(<xref:System.Windows.Documents.TableRow> 要素で表されます\) で構成されたグリッド式の表示を提供します。  <xref:System.Windows.Documents.TableColumn> 要素はコンテンツをホストせず、単に列と列の特性を定義します。  <xref:System.Windows.Documents.TableRow> 要素は、<xref:System.Windows.Documents.TableRowGroup> 要素でホストされる必要があり、これによってテーブルの行のグループ化が定義されます。  <xref:System.Windows.Documents.TableCell> 要素はテーブルで表示される実際のコンテンツを格納し、<xref:System.Windows.Documents.TableRow> 要素でホストされる必要があります。  <xref:System.Windows.Documents.TableCell> には、<xref:System.Windows.Documents.Block> から派生した要素しか格納できません。  <xref:System.Windows.Documents.TableCell> に対する有効な子要素は次のとおりです。  
+  
+-   <xref:System.Windows.Documents.BlockUIContainer>  
+  
+-   <xref:System.Windows.Documents.List>  
+  
+-   <xref:System.Windows.Documents.Paragraph>  
+  
+-   <xref:System.Windows.Documents.Section>  
+  
+-   <xref:System.Windows.Documents.Table>  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.TableCell> 要素は、テキスト コンテンツを直接ホストすることはできません。  <xref:System.Windows.Documents.TableCell> など、フロー コンテンツ要素の格納規則の詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.Table> は、<xref:System.Windows.Controls.Grid> 要素と似ていますが、より多くの機能を備えています。そのため、さらに多くのリソースのオーバーヘッドを必要とします。  
+  
+ 次の例では、[!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] を使用して単純な 2 × 3 のテーブルを定義しています。  
+  
+ [!code-xml[TableSnippets2#_Table_BasicLayout](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml#_table_basiclayout)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 基本的なテーブルの描画](../../../../docs/framework/wpf/advanced/media/basictablerrender.png "BasicTablerRender")  
+  
+<a name="table_containment"></a>   
+### テーブルの内容  
+ <xref:System.Windows.Documents.Table> は <xref:System.Windows.Documents.Block> 要素から派生し、<xref:System.Windows.Documents.Block> レベル要素の共通規則に従います。  <xref:System.Windows.Documents.Table> 要素は、次の要素に含めることができます。  
+  
+-   <xref:System.Windows.Documents.FlowDocument>  
+  
+-   <xref:System.Windows.Documents.TableCell>  
+  
+-   <xref:System.Windows.Controls.ListBoxItem>  
+  
+-   <xref:System.Windows.Controls.ListViewItem>  
+  
+-   <xref:System.Windows.Documents.Section>  
+  
+-   <xref:System.Windows.Documents.Floater>  
+  
+-   <xref:System.Windows.Documents.Figure>  
+  
+<a name="row_groupings"></a>   
+### 行のグループ化  
+ <xref:System.Windows.Documents.TableRowGroup> 要素を使用すると、テーブル内の行を任意にグループ化できます。この場合、テーブル内のすべての行は行グループに属する必要があります。  多くの場合、行グループ内の行は共通の目的を共有しており、1 つのグループとしてスタイルを設定できます。  一般に、行のグループ化は、テーブルに格納された主要コンテンツから、特別な目的を持つ行 \(タイトル行、ヘッダー行、フッター行など\) を分離するために使用します。  
+  
+ 次の例では [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] を使用して、スタイルが設定されたヘッダー行とフッター行を使用したテーブルを定義しています。  
+  
+ [!code-xml[TableSnippets2#_Table_RowGroups](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml#_table_rowgroups)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: テーブル行グループ](../../../../docs/framework/wpf/advanced/media/table-rowgroups.png "Table\_RowGroups")  
+  
+<a name="renderning_precedence"></a>   
+### 背景のレンダリングの優先順位  
+ テーブル要素は、次の順序で \([z オーダー](GTMT) の低い項目から高い項目へ\) レンダリングされます。  この順序は変更できません。  たとえば、これらの要素には、確立された順序をオーバーライドするための "Z オーダー" プロパティは用意されていません。  
+  
+1.  <xref:System.Windows.Documents.Table>  
+  
+2.  <xref:System.Windows.Documents.TableColumn>  
+  
+3.  <xref:System.Windows.Documents.TableRowGroup>  
+  
+4.  <xref:System.Windows.Documents.TableRow>  
+  
+5.  <xref:System.Windows.Documents.TableCell>  
+  
+ テーブル内のこれらの各要素に対して背景色を定義する例を次に示します。  
+  
+ [!code-xml[TableSnippets2#_Table_ZOrder](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml#_table_zorder)]  
+  
+ 次の図は、この例の表示結果 \(背景色のみ表示\) を示したものです。  
+  
+ ![スクリーンショット: テーブル z オーダー](../../../../docs/framework/wpf/advanced/media/table-zorder.png "Table\_ZOrder")  
+  
+<a name="spanning_rows_or_columns"></a>   
+### 複数の行または列にまたがるセル  
+ テーブルのセルは、複数の行または列にまたがるように構成することができます。この場合、それぞれ <xref:System.Windows.Documents.TableCell.RowSpan%2A> 属性または <xref:System.Windows.Documents.TableCell.ColumnSpan%2A> 属性を使用します。  
+  
+ 3 つの列にまたがるセルの例を次に示します。  
+  
+ [!code-xml[TableSnippets2#_Table_ColumnSpan](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets2/CSharp/Window1.xaml#_table_columnspan)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![スクリーンショット: 3 つの列すべてにまたがるセル](../../../../docs/framework/wpf/advanced/media/table-columnspan.png "Table\_ColumnSpan")  
+  
+<a name="building_a_table_with_code"></a>   
+## テーブルとコードのバインディング  
+ 次の例は、プログラムで <xref:System.Windows.Documents.Table> を作成してデータを格納する方法を示しています。  テーブルの内容は、5 行 \(<xref:System.Windows.Documents.Table.RowGroups%2A> オブジェクトに含まれる <xref:System.Windows.Documents.TableRow> オブジェクトで指定\) と 6 列 \(<xref:System.Windows.Documents.TableColumn> オブジェクトで指定\) に配分されます。  行はさまざまな表示目的に使用されます。たとえば、タイトル行はテーブル全体のタイトルの設定に使用され、ヘッダー行はテーブル内のデータ列の説明、フッター行は要約情報の格納に使用されます。  "タイトル"、"ヘッダー"、および "フッター" 行の概念はテーブルに固有のものではなく、単純に異なる特性を持つ行です。  テーブルのセルには実際の内容が格納されます。テキスト、画像、またはその他のほとんどすべての [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] 要素を格納できます。  
+  
+ まず、<xref:System.Windows.Documents.Table> を格納する <xref:System.Windows.Documents.FlowDocument> を作成し、新しい <xref:System.Windows.Documents.Table> を作成して <xref:System.Windows.Documents.FlowDocument> に追加します。  
+  
+ [!code-csharp[TableSnippets#_TableCreate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tablecreate)]
+ [!code-vb[TableSnippets#_TableCreate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tablecreate)]  
+  
+ 次に、6 つの <xref:System.Windows.Documents.TableColumn> オブジェクトを作成してテーブルの <xref:System.Windows.Documents.Table.Columns%2A> コレクションに追加し、書式を適用します。  
+  
+> [!NOTE]
+>  テーブルの <xref:System.Windows.Documents.Table.Columns%2A> コレクションでは、標準のゼロから始まるインデックスを使用します。  
+  
+ [!code-csharp[TableSnippets#_TableCreateColumns](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tablecreatecolumns)]
+ [!code-vb[TableSnippets#_TableCreateColumns](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tablecreatecolumns)]  
+  
+ 次に、タイトル行を作成してテーブルに追加し、書式を適用します。  タイトル行には、テーブルの 6 つの列にまたがる 1 つのセルが格納されます。  
+  
+ [!code-csharp[TableSnippets#_TableAddTitleRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddtitlerow)]
+ [!code-vb[TableSnippets#_TableAddTitleRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddtitlerow)]  
+  
+ 次に、ヘッダー行を作成してテーブルに追加し、ヘッダー行のセルを作成してデータを格納します。  
+  
+ [!code-csharp[TableSnippets#_TableAddHeaderRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddheaderrow)]
+ [!code-vb[TableSnippets#_TableAddHeaderRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddheaderrow)]  
+  
+ 次に、データ行を作成してテーブルに追加し、この行のセルを作成してデータを格納します。  この行の作成は、ヘッダー行の作成に似ていますが、適用する書式が少し異なります。  
+  
+ [!code-csharp[TableSnippets#_TableAddDataRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableadddatarow)]
+ [!code-vb[TableSnippets#_TableAddDataRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableadddatarow)]  
+  
+ 最後に、フッター行を作成して追加し、書式を設定します。  タイトル行と同様に、フッター行には、テーブルの 6 つの列にまたがる 1 つのセルが格納されます。  
+  
+ [!code-csharp[TableSnippets#_TableAddFooterRow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TableSnippets/CSharp/Table.cs#_tableaddfooterrow)]
+ [!code-vb[TableSnippets#_TableAddFooterRow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TableSnippets/VisualBasic/Table.vb#_tableaddfooterrow)]  
+  
+## 参照  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [XAML を使用してテーブルを定義する](../../../../docs/framework/wpf/advanced/how-to-define-a-table-with-xaml.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [フロー コンテンツ要素を使用する](../../../../docs/framework/wpf/advanced/how-to-use-flow-content-elements.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/technology-regions-overview.md b/docs/framework/wpf/advanced/technology-regions-overview.md
new file mode 100644
index 00000000000..5495a636498
--- /dev/null
+++ b/docs/framework/wpf/advanced/technology-regions-overview.md
@@ -0,0 +1,73 @@
+---
+title: "技術領域の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "空域"
+  - "相互運用性 [WPF], 空域"
+  - "Win32 コード, 空域"
+  - "Win32 コード, ウィンドウ領域"
+  - "Win32 コード, WPF 相互運用"
+  - "ウィンドウ領域"
+ms.assetid: b7cc350f-b9e2-48b1-be14-60f3d853222e
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 技術領域の概要
+WPF、Win32、DirectX など、複数のプレゼンテーション テクノロジを 1 つのアプリケーションで使用する場合、それらのテクノロジでは共通のトップレベル ウィンドウ内のレンダリング領域を共有する必要があります。  このトピックでは、WPF 相互運用アプリケーションのプレゼンテーションや入力に影響を与える可能性がある問題について説明します。  
+  
+## 領域  
+ トップレベル ウィンドウ内では、相互運用アプリケーションのテクノロジの 1 つを構成する HWND のそれぞれに独自の領域 \("空域" とも呼ばれます\) がある、と考えることができます。  ウィンドウ内の各ピクセルはただ 1 つの HWND に属しており、これがその HWND の領域を構成します   \(厳密に言えば、複数の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] HWND が存在する場合には複数の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 領域が存在しますが、ここでは説明しやすくするために、存在する領域は 1 つだけであると仮定します\)。  領域は、アプリケーションの有効期間中にそのピクセルの上に描画を試行するすべての層またはその他のウィンドウが、同じ描画レベル テクノロジの一部である必要があることを意味しています。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 上で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ピクセルを描画しようとすると、望ましくない結果が生じるため、相互運用 [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] によって可能な限り禁止されています。  
+  
+### 領域の例  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)]、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)]、および [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が混在するアプリケーションを次の図に示します。  それぞれのテクノロジは別個の、重複しないピクセルのセットを使用しているので、領域の問題は発生しません。  
+  
+ ![空域の問題がないウィンドウ](../../../../docs/framework/wpf/advanced/media/migrationinteroparchitectarticle01.png "MigrationInteropArchitectArticle01")  
+  
+ このアプリケーションでマウス ポインターの位置を使用して、これら 3 つのどの領域の上にも描画を試みるアニメーションを作成するとします。  アニメーション自体をどのテクノロジが担当するとしても、そのテクノロジは他の 2 つの領域に違反することになります。  Win32 の領域の上に WPF の円の描画を試みる場合を次の図に示します。  
+  
+ ![相互運用ダイアグラム](../../../../docs/framework/wpf/advanced/media/migrationinteroparchitectarticle02.png "MigrationInteropArchitectArticle02")  
+  
+ 領域の違反は、異なるテクノロジの間で透明度\/アルファ ブレンドを使用した場合にも発生します。  次の図では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のボックスが [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] の領域に違反しています。  この [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ボックス内のピクセルは半透明であるため、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の両方によって共通に所有されている必要がありますが、それは不可能です。  したがって、これも領域の違反となり、作成できません。  
+  
+ ![相互運用ダイアグラム](../../../../docs/framework/wpf/advanced/media/migrationinteroparchitectarticle03.png "MigrationInteropArchitectArticle03")  
+  
+ 前の 3 つの例では四角形領域を使用しましたが、別の形状を使用することもできます。  たとえば、領域に穴を使用できます。  四角形の穴がある [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の領域を次の図に示します。これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] の領域を結合したサイズです。  
+  
+ ![相互運用ダイアグラム](../../../../docs/framework/wpf/advanced/media/migrationinteroparchitectarticle04.png "MigrationInteropArchitectArticle04")  
+  
+ 領域は、次の図のように、まったく四角形でない図形や、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の HRGN \(領域\) で記述できる任意の図形にすることもできます。  
+  
+ ![相互運用ダイアグラム](../../../../docs/framework/wpf/advanced/media/migrationinteroparchitectarticle05.png "MigrationInteropArchitectArticle05")  
+  
+## 透過性とトップレベル ウィンドウ  
+ Windows でのウィンドウ マネージャーは、実際には [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の HWND のみを処理します。  したがって、それぞれの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Window> は HWND です。  <xref:System.Windows.Window> HWND は、すべての HWND の一般規則に従う必要があります。  その HWND 内で、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コードは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] 全体がサポートすることであれば、すべて実行できます。  しかし、デスクトップ上で他の HWND と対話する場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の処理と描画の規則に従う必要があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の非四角形ウィンドウ用 HRGN と、ピクセルごとのアルファ情報をサポートするレイヤード ウィンドウを使用することで、四角形以外のウィンドウをサポートします。  
+  
+ 一定のアルファおよびカラー キーはサポートされません。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] のレイヤード ウィンドウの機能は、プラットフォームによって異なります。  
+  
+ レイヤード ウィンドウでは、ウィンドウ内のすべてのピクセルに適用するアルファ値を指定することで、ウィンドウ全体を半透明にすることができます   \([!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] は実際にはピクセルごとのアルファをサポートしていますが、このモードでは、ダイアログやドロップダウンなどを含むすべての子 HWND を開発者自身で描画する必要があるため、これを実用プログラムで使用することは非常に困難です\)。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は HRGN をサポートしますが、この機能に対応するマネージ [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] はありません。  プラットフォーム呼び出しおよび <xref:System.Windows.Interop.HwndSource> を使用すると、関連する [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を呼び出すことができます。  詳細については、「[マネージ コードからのネイティブ関数の呼び出し](../Topic/Calling%20Native%20Functions%20from%20Managed%20Code.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイヤード ウィンドウの機能は、オペレーティング システムによってさまざまに異なります。  これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では描画に [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] が使用されますが、レイヤード ウィンドウは [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] レンダリングではなく、主に [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] レンダリング用に設計されているためです。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、[!INCLUDE[TLA#tla_longhorn](../../../../includes/tlasharptla-longhorn-md.md)] 以降では、ハードウェアで加速されたレイヤード ウィンドウをサポートします。  ハードウェアで加速されたレイヤード ウィンドウを [!INCLUDE[TLA2#tla_winxp](../../../../includes/tla2sharptla-winxp-md.md)] 上で使用するには、[!INCLUDE[TLA#tla_dx](../../../../includes/tlasharptla-dx-md.md)] によるサポートが必要となるため、この機能は、実行するマシンの [!INCLUDE[TLA#tla_dx](../../../../includes/tlasharptla-dx-md.md)] のバージョンに依存します。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、特にレンダリングがハードウェアで加速されている場合、要求された正確な色を描画することを保証できないため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、透明度カラー キーをサポートしません。  
+  
+-   アプリケーションを [!INCLUDE[TLA2#tla_winxp](../../../../includes/tla2sharptla-winxp-md.md)] で実行している場合、レイヤード ウィンドウを [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] サーフェイス上で実行すると、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] アプリケーションでの描画時に、ちらつきが発生します   \(実際のレンダリング シーケンスでは、まず [!INCLUDE[TLA#tla_gdi](../../../../includes/tlasharptla-gdi-md.md)] がレイヤード ウィンドウを非表示にし、次に [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] が描画を実行した後、[!INCLUDE[TLA#tla_gdi](../../../../includes/tlasharptla-gdi-md.md)] がレイヤード ウィンドウを元に戻します\)。  この制限は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 以外のレイヤード ウィンドウでも同じです。  
+  
+## 参照  
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)   
+ [チュートリアル: Win32 での WPF クロックのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-clock-in-win32.md)   
+ [WPF での Win32 コンテンツのホスト](../../../../docs/framework/wpf/advanced/hosting-win32-content-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/templatebinding-markup-extension.md b/docs/framework/wpf/advanced/templatebinding-markup-extension.md
new file mode 100644
index 00000000000..cc0331a700d
--- /dev/null
+++ b/docs/framework/wpf/advanced/templatebinding-markup-extension.md
@@ -0,0 +1,77 @@
+---
+title: "TemplateBinding のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "TemplateBinding"
+  - "TemplateBindingExtension"
+helpviewer_keywords: 
+  - "TemplateBinding のマークアップ拡張機能"
+  - "XAML, TemplateBinding マークアップ拡張機能"
+ms.assetid: 1d25bbfc-dbc2-499d-9f12-419d23d4ac6a
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# TemplateBinding のマークアップ拡張機能
+コントロール テンプレート内のプロパティの値を、template 宣言されたコントロールの別のプロパティの値にリンクします。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{TemplateBinding sourceProperty}" .../>  
+```  
+  
+## XAML 属性の使用方法 \(テンプレートまたはスタイルの Setter プロパティの場合\)  
+  
+```  
+<Setter Property="propertyName" Value="{TemplateBinding sourceProperty}" .../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`propertyName`|Setter 構文で設定されるプロパティの <xref:System.Windows.DependencyProperty.Name%2A?displayProperty=fullName>。|  
+|`sourceProperty`|template 宣言された型に存在する、<xref:System.Windows.DependencyProperty.Name%2A?displayProperty=fullName> によって指定された別の依存関係プロパティ。<br /><br /> または<br /><br /> template 宣言された対象の型とは異なる型で定義されている "ドットダウン" プロパティ名。  これは、実際には <xref:System.Windows.PropertyPath> です。  「[PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md)」を参照してください。|  
+  
+## 解説  
+ `TemplateBinding` は、テンプレート シナリオに合わせて最適化された形態の[バインディング](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)であり、`{Binding RelativeSource={RelativeSource TemplatedParent}}` を使用して構築された `Binding` に類似します。  関連するプロパティが既定で双方向のバインディングの場合でも、`TemplateBinding` は常に一方向のバインディングです。  関連する両方のプロパティは、依存関係プロパティである必要があります。  
+  
+ [RelativeSource](../../../../docs/framework/wpf/advanced/relativesource-markupextension.md) もマークアップ拡張機能の 1 つであり、テンプレート内で相対プロパティ バインディングを実行するために、`TemplateBinding` と組み合わせて使用されたり、TemplateBinding の代わりに使用されることがあります。  
+  
+ ここでは説明されていないコントロール テンプレートの概念については、「[コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)」を参照してください。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `TemplateBinding` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.TemplateBindingExtension> 拡張クラスの <xref:System.Windows.TemplateBindingExtension.Property%2A> 値として割り当てられます。  
+  
+ オブジェクト要素構文を使用することもできますが、現実的な用途がないためここでは触れません。  `TemplateBinding` は、評価された式を使用して setter 内で値を埋め込むために使用され、`TemplateBinding` を使用する場合、TemplateBinding が `<Setter.Property>` プロパティ要素構文を埋め込むためのオブジェクト要素構文は、必要以上に詳細です。  
+  
+ `TemplateBinding` は、<xref:System.Windows.TemplateBindingExtension.Property%2A> プロパティをプロパティおよび値のペアとして指定する詳細出力属性使用でも使用できます。  
+  
+```  
+<object property="{TemplateBinding Property=sourceProperty}" .../>  
+```  
+  
+ 詳細出力の使用は、複数の設定可能プロパティを持つ拡張機能や、一部のプロパティがオプションである場合に役立ちます。  `TemplateBinding` には、必須の設定可能プロパティが 1 つしか存在しないため、このような詳細出力の使用は一般的ではありません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] XAML プロセッサ実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.TemplateBindingExtension> クラスによって定義されます。  
+  
+ `TemplateBinding` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  XAML のすべてのマークアップ拡張機能では、それぞれの属性構文で `{` と `}` の 2 つの記号を使用します。これは規約であり、これに従って XAML プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Style>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [RelativeSource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/relativesource-markupextension.md)   
+ [バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/textelement-content-model-overview.md b/docs/framework/wpf/advanced/textelement-content-model-overview.md
new file mode 100644
index 00000000000..f94e8a0ef89
--- /dev/null
+++ b/docs/framework/wpf/advanced/textelement-content-model-overview.md
@@ -0,0 +1,115 @@
+---
+title: "TextElement コンテンツ モデルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドキュメント, フロー ドキュメント"
+  - "フロー コンテンツ要素 [WPF], TextElement コンテンツ モデル"
+  - "フロー ドキュメント"
+  - "TextElement コンテンツ モデル"
+ms.assetid: d0a7791c-b090-438c-812f-b9d009d83ee9
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# TextElement コンテンツ モデルの概要
+このコンテンツ モデルの概要では、<xref:System.Windows.Documents.TextElement> でサポートされるコンテンツについて説明します。  <xref:System.Windows.Documents.Paragraph> クラスは、<xref:System.Windows.Documents.TextElement> の一種です。  コンテンツ モデルは、他のオブジェクトや要素に含めることのできるオブジェクトや要素を記述します。  ここでは、<xref:System.Windows.Documents.TextElement> から派生したオブジェクトに対して使用するコンテンツ モデルの概要を示します。  詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="text_element_classes"></a>   
+## コンテンツ モデルの図  
+ <xref:System.Windows.Documents.TextElement> から派生したクラスのコンテンツ モデルと、このモデルがその他の `TextElement` 以外のクラスにどのように適用されるかについてまとめたものを次の図に示します。  
+  
+ ![ダイアグラム: フロー コンテンツ コンテインメント スキーマ](../../../../docs/framework/wpf/advanced/media/flow-content-schema.png "Flow\_Content\_Schema")  
+  
+ 上の図からわかるように、要素で許容される子は、必ずしもクラスが <xref:System.Windows.Documents.Block> クラスと <xref:System.Windows.Documents.Inline> クラスのどちらから派生したかによって決まるわけではありません。  たとえば、<xref:System.Windows.Documents.Span> \(<xref:System.Windows.Documents.Inline> の派生クラス\) は <xref:System.Windows.Documents.Inline> 子要素だけを持つことができるのに対し、<xref:System.Windows.Documents.Figure> \(同じく <xref:System.Windows.Documents.Inline> の派生クラス\) は <xref:System.Windows.Documents.Block> 子要素だけを持つことができます。  そのため、どの要素を別の要素に含めることができるかをすばやく判断するには、図が役立ちます。  例として、<xref:System.Windows.Controls.RichTextBox> のフロー コンテンツを構築する方法を、上の図を使用して判断してみましょう。  
+  
+1.  <xref:System.Windows.Controls.RichTextBox> は <xref:System.Windows.Documents.FlowDocument> を含んでいる必要があり、<xref:System.Windows.Documents.FlowDocument> は <xref:System.Windows.Documents.Block> の派生オブジェクトを含んでいる必要があります。  上の図に対応するセグメントを次に示します。  
+  
+     ![ダイアグラム: RichTextBox コンテインメント規則](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough1.png "Flow\_Ovw\_SchemaWalkThrough1")  
+  
+     この段階では、マークアップは次のようになります。  
+  
+     [!code-xml[FlowOvwSnippets_snip#SchemaWalkThrough1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/MiscSnippets.xaml#schemawalkthrough1)]  
+  
+2.  上の図によると、<xref:System.Windows.Documents.Block> 要素には、<xref:System.Windows.Documents.Paragraph>、<xref:System.Windows.Documents.Section>、<xref:System.Windows.Documents.Table>、<xref:System.Windows.Documents.List>、および <xref:System.Windows.Documents.BlockUIContainer> を含む、いくつかの選択肢があります \(上の図の Block の派生クラスを参照\)。  ここで、<xref:System.Windows.Documents.Table> が必要だとします。  上の図によると、<xref:System.Windows.Documents.Table> は <xref:System.Windows.Documents.TableRowGroup> を含んでおり、これは <xref:System.Windows.Documents.TableRow> 要素を含んでいます。さらにこれは <xref:System.Windows.Documents.TableCell> 要素を含んでおり、これは <xref:System.Windows.Documents.Block> の派生オブジェクトを含んでいます。  上の図の <xref:System.Windows.Documents.Table> に対応する部分を次に示します。  
+  
+     ![ダイアグラム: テーブルの親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough2.png "Flow\_Ovw\_SchemaWalkThrough2")  
+  
+     対応するマークアップは次のとおりです。  
+  
+     [!code-xml[FlowOvwSnippets_snip#SchemaWalkThrough2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/MiscSnippets.xaml#schemawalkthrough2)]  
+  
+3.  さらに、<xref:System.Windows.Documents.TableCell> の下にも、1 つ以上の <xref:System.Windows.Documents.Block> 要素が必要です。  簡単にするために、セル内にいくつかのテキストを配置することにします。  これを行うには、<xref:System.Windows.Documents.Paragraph> を <xref:System.Windows.Documents.Run> 要素と組み合わせて使用します。  上の図でこれに対応する部分を次に示します。ここには、<xref:System.Windows.Documents.Paragraph> が <xref:System.Windows.Documents.Inline> 要素を取ることができ、<xref:System.Windows.Documents.Run> \(<xref:System.Windows.Documents.Inline> 要素の 1 つ\) がプレーンテキストのみを取ることができることが示されています。  
+  
+     ![ダイアグラム: 段落の親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough3.png "Flow\_Ovw\_SchemaWalkThrough3")  
+  
+     ![ダイアグラム: 実行の親&#47;子スキーマ](../../../../docs/framework/wpf/advanced/media/flow-ovw-schemawalkthrough4.png "Flow\_Ovw\_SchemaWalkThrough4")  
+  
+ 例全体をマークアップで次に示します。  
+  
+ [!code-xml[FlowOvwSnippets_snip#SchemaExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FlowOvwSnippets_snip/CS/SchemaExample.xaml#schemaexamplewholepage)]  
+  
+<a name="Using_the_Content_Property"></a>   
+## TextElement のコンテンツをプログラムで操作する  
+ <xref:System.Windows.Documents.TextElement> のコンテンツはコレクションで構成されているため、<xref:System.Windows.Documents.TextElement> オブジェクトのコンテンツをプログラムで操作するには、これらのコレクションを操作すればよいことになります。  <xref:System.Windows.Documents.TextElement> の派生クラスで使用されるコレクションには、次の 3 種類があります。  
+  
+-   <xref:System.Windows.Documents.InlineCollection>: <xref:System.Windows.Documents.Inline> 要素のコレクションを表します。  <xref:System.Windows.Documents.InlineCollection> は、<xref:System.Windows.Documents.Paragraph>、<xref:System.Windows.Documents.Span>、および <xref:System.Windows.Controls.TextBlock> 要素で許容される子コンテンツを定義します。  
+  
+-   <xref:System.Windows.Documents.BlockCollection>: <xref:System.Windows.Documents.Block> 要素のコレクションを表します。  <xref:System.Windows.Documents.BlockCollection> は、<xref:System.Windows.Documents.FlowDocument>、<xref:System.Windows.Documents.Section>、<xref:System.Windows.Documents.ListItem>、<xref:System.Windows.Documents.TableCell>、<xref:System.Windows.Documents.Floater>、および <xref:System.Windows.Documents.Figure> 要素で許容される子コンテンツを定義します。  
+  
+-   <xref:System.Windows.Documents.ListItemCollection> : 順序付きまたは順序の付いていない <xref:System.Windows.Documents.List> 内の特定のコンテンツ項目を表すフロー コンテンツ要素。  
+  
+ これらのコレクションを操作 \(項目を追加または削除\) するには、それぞれ **Inlines**、**Blocks**、および **ListItems** プロパティを使用します。  Span のコンテンツを **Inlines** プロパティを使用して操作する方法を次の例に示します。  
+  
+> [!NOTE]
+>  Table では、コンテンツの操作にいくつかのコレクションが使用されますが、これらのコレクションについてはここでは取り上げません。  詳細については、「[テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)」を参照してください。  
+  
+ 次の例では、新しい <xref:System.Windows.Documents.Span> オブジェクトを作成した後、`Add` メソッドを使用して、2 つのテキスト ランを <xref:System.Windows.Documents.Span> のコンテンツの子として追加します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesAdd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesadd)]
+ [!code-vb[SpanSnippets#_SpanInlinesAdd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesadd)]  
+  
+ 次の例では、新しい <xref:System.Windows.Documents.Run> 要素を作成して <xref:System.Windows.Documents.Span> の先頭に挿入します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesInsert](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesinsert)]
+ [!code-vb[SpanSnippets#_SpanInlinesInsert](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesinsert)]  
+  
+ 次の例では、<xref:System.Windows.Documents.Span> 内の最後の <xref:System.Windows.Documents.Inline> 要素を削除します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesremovelast)]
+ [!code-vb[SpanSnippets#_SpanInlinesRemoveLast](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesremovelast)]  
+  
+ 次の例では、<xref:System.Windows.Documents.Span> からすべての内容 \(<xref:System.Windows.Documents.Inline> 要素\) を消去します。  
+  
+ [!code-csharp[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SpanSnippets/CSharp/Window1.xaml.cs#_spaninlinesclear)]
+ [!code-vb[SpanSnippets#_SpanInlinesClear](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SpanSnippets/visualbasic/window1.xaml.vb#_spaninlinesclear)]  
+  
+<a name="Types_that_Share_this_Content_Model"></a>   
+## このコンテンツ モデルを共有する型  
+ 次に示す型は、<xref:System.Windows.Documents.TextElement> クラスから継承され、この概要で説明したコンテンツを表示するために使用できます。  
+  
+ <xref:System.Windows.Documents.Bold>, <xref:System.Windows.Documents.Figure>, <xref:System.Windows.Documents.Floater>, <xref:System.Windows.Documents.Hyperlink>, <xref:System.Windows.Documents.InlineUIContainer>, <xref:System.Windows.Documents.Italic>, <xref:System.Windows.Documents.LineBreak>, <xref:System.Windows.Documents.List>, <xref:System.Windows.Documents.ListItem>, <xref:System.Windows.Documents.Paragraph>, <xref:System.Windows.Documents.Run>, <xref:System.Windows.Documents.Section>, <xref:System.Windows.Documents.Span>, <xref:System.Windows.Documents.Table>, <xref:System.Windows.Documents.Underline>.  
+  
+ この一覧には、[!INCLUDE[TLA2#tla_winfxsdk](../../../../includes/tla2sharptla-winfxsdk-md.md)] と共に配布される非抽象型しか含まれていません。  <xref:System.Windows.Documents.TextElement> を継承するその他の種類も使用できます。  
+  
+<a name="Types_that_Can_Contain_ContentControl_Objects"></a>   
+## TextElement オブジェクトを含むことのできる型  
+ 「[WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)」を参照してください。  
+  
+## 参照  
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)   
+ [Blocks プロパティを介してフロー コンテンツ要素を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-flow-content-elements-through-the-blocks-property.md)   
+ [Blocks プロパティを介して FlowDocument を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-a-flowdocument-through-the-blocks-property.md)   
+ [Columns プロパティによってテーブルの列を操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-columns-through-the-columns-property.md)   
+ [RowGroups プロパティを介してテーブルの行グループを操作する](../../../../docs/framework/wpf/advanced/how-to-manipulate-table-row-groups-through-the-rowgroups-property.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/the-ink-object-model-windows-forms-and-com-versus-wpf.md b/docs/framework/wpf/advanced/the-ink-object-model-windows-forms-and-com-versus-wpf.md
new file mode 100644
index 00000000000..1add98c6967
--- /dev/null
+++ b/docs/framework/wpf/advanced/the-ink-object-model-windows-forms-and-com-versus-wpf.md
@@ -0,0 +1,108 @@
+---
+title: "インク オブジェクト モデル : Windows フォームおよび COM と WPF の比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "有効化 (インクを)"
+  - "イベント, タブレット ペン"
+  - "インク オブジェクト モデル"
+  - "インク, 有効化"
+  - "InkCanvas コントロール"
+  - "タブレット ペン, イベント"
+ms.assetid: 577835be-b145-4226-8570-1d309e9b3901
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# インク オブジェクト モデル : Windows フォームおよび COM と WPF の比較
+基本的に、デジタル インクをサポートするプラットフォームは、Tablet PC Windows フォーム プラットフォーム、Tablet PC COM プラットフォーム、および [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] プラットフォームの 3 つです。  Windows フォームと COM プラットフォームは同じようなオブジェクト モデルを共有しますが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラットフォームのオブジェクト モデルは大きく異なります。  ここでは、一方のオブジェクト モデルを操作したことがある開発者が他方のオブジェクト モデルをよりよく理解できるように、その違いについて大まかに説明します。  
+  
+## アプリケーションでのインクの有効化  
+ 3 つのすべてのプラットフォームには、アプリケーションがタブレット ペンから入力を受け取ることができるようにするオブジェクトおよびコントロールが付属しています。  Windows フォームおよび COM プラットフォームには、<xref:Microsoft.Ink.InkPicture>、<xref:Microsoft.Ink.InkEdit>、<xref:Microsoft.Ink.InkOverlay>、および <xref:Microsoft.Ink.InkCollector> クラスが付属しています。  <xref:Microsoft.Ink.InkPicture> および <xref:Microsoft.Ink.InkEdit> は、インクを収集するためにアプリケーションに追加できるコントロールです。  <xref:Microsoft.Ink.InkOverlay> および <xref:Microsoft.Ink.InkCollector> は、ウィンドウおよびカスタム コントロールをインク対応にするために既存のウィンドウに結合できます。  
+  
+ WPF プラットフォームには、<xref:System.Windows.Controls.InkCanvas> コントロールが含まれています。  <xref:System.Windows.Controls.InkCanvas> をアプリケーションに追加して、インクの収集を直ちに開始することができます。  <xref:System.Windows.Controls.InkCanvas> を使用すると、ユーザーはインクのコピー、選択、およびサイズ変更を実行できます。  他のコントロールを <xref:System.Windows.Controls.InkCanvas> に追加すると、ユーザーはそれらのコントロールに対して手書きを行うことができます。  <xref:System.Windows.Controls.InkPresenter> を追加してスタイラス ポイントを収集することで、インク対応カスタム コントロールを作成できます。  
+  
+ アプリケーションでのインクの有効化に関する詳細の参照先を次の表に示します。  
+  
+|目的|WPF プラットフォームの場合|Windows フォームおよび COM プラットフォームの場合|  
+|--------|---------------------|-------------------------------------|  
+|アプリケーションへのインク対応コントロールの追加|「[インクの概要](../../../../docs/framework/wpf/advanced/getting-started-with-ink.md)」を参照してください。|「[Auto Claims Form Sample](http://msdn.microsoft.com/ja-jp/bec4333a-62ca-4254-a39b-04bc2c556992)」を参照してください。|  
+|カスタム コントロールでのインクの有効化|「[インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)」を参照してください。|「[Ink Clipboard Sample](http://msdn.microsoft.com/ja-jp/a0c42f1c-543d-44f8-83d9-fe810de410ff)」を参照してください。|  
+  
+## インク データ  
+ Windows フォームおよび COM プラットフォームでは、<xref:Microsoft.Ink.InkCollector>、<xref:Microsoft.Ink.InkOverlay>、<xref:Microsoft.Ink.InkEdit>、および <xref:Microsoft.Ink.InkPicture> がそれぞれ <xref:Microsoft.Ink.Ink?displayProperty=fullName> オブジェクトを公開します。  <xref:Microsoft.Ink.Ink> オブジェクトは 1 つ以上の <xref:Microsoft.Ink.Stroke?displayProperty=fullName> オブジェクトのデータを格納し、これらのストロークを管理および操作するための共通のメソッドとプロパティを公開します。  <xref:Microsoft.Ink.Ink> オブジェクトは、そのオブジェクト内のストロークの有効期間を管理し、所有するストロークを作成および削除します。  各 <xref:Microsoft.Ink.Stroke> には、その親 <xref:Microsoft.Ink.Ink> オブジェクト内で一意の識別子があります。  
+  
+ WPF プラットフォームでは、<xref:System.Windows.Ink.Stroke?displayProperty=fullName> クラスがその有効期間を所有および管理します。  <xref:System.Windows.Ink.Stroke> オブジェクトのグループを <xref:System.Windows.Ink.StrokeCollection> 内に収集できます。このコレクションは、インクのヒット テスト、消去、変換、シリアル化などの一般的なインク データ管理操作のためのメソッドを提供します。  <xref:System.Windows.Ink.Stroke> は、どの時点でも 0 個以上の <xref:System.Windows.Ink.StrokeCollection> オブジェクトに属することができます。  <xref:System.Windows.Controls.InkCanvas> および <xref:System.Windows.Controls.InkPresenter> には、<xref:Microsoft.Ink.Ink?displayProperty=fullName> オブジェクトではなく <xref:System.Windows.Ink.StrokeCollection?displayProperty=fullName> が含まれます。  
+  
+ 次の 1 組の図で、インク データのオブジェクト モデルを比較します。  Windows フォームおよび COM プラットフォームでは、<xref:Microsoft.Ink.Ink?displayProperty=fullName> オブジェクトが <xref:Microsoft.Ink.Stroke?displayProperty=fullName> オブジェクトの有効期間を制限し、スタイラス パケットが個別のストロークに属しています。  次の図に示すように、複数のストロークが 1 つの <xref:Microsoft.Ink.DrawingAttributes?displayProperty=fullName> オブジェクトを参照することができます。  
+  
+ ![COM&#47;Winforms のインク オブジェクト モデルのダイアグラム。](../../../../docs/framework/wpf/advanced/media/ink-inkownsstrokes.png "Ink\_InkOwnsStrokes")  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、各 <xref:System.Windows.Ink.Stroke?displayProperty=fullName> は、参照される限り存在する共通言語ランタイム オブジェクトです。  各 <xref:System.Windows.Ink.Stroke> は <xref:System.Windows.Input.StylusPointCollection> および <xref:System.Windows.Ink.DrawingAttributes?displayProperty=fullName> オブジェクトを参照します。これらのオブジェクトも共通言語ランタイム オブジェクトです。  
+  
+ ![WPF のインク オブジェクト モデルのダイアグラム。](../../../../docs/framework/wpf/advanced/media/ink-wpfinkobjectmodel.png "Ink\_WPFInkObjectModel")  
+  
+ 次の表では、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラットフォームと Windows フォームおよび COM プラットフォームで、いくつかの共通のタスクを実行する方法を比較します。  
+  
+|タスク|Windows Presentation Foundation|Windows フォームおよび COM|  
+|---------|-------------------------------------|-------------------------|  
+|インクの保存|<xref:System.Windows.Ink.StrokeCollection.Save%2A>|<xref:Microsoft.Ink.Ink.Save%2A>|  
+|インクの読み込み|<xref:System.Windows.Ink.StrokeCollection.%23ctor%28System.IO.Stream%29?displayProperty=fullName> コンストラクターで <xref:System.Windows.Ink.StrokeCollection> を作成します。|[M:Microsoft.Ink.Ink.Load\(System.Byte\<xref:Microsoft.Ink.Ink.Load%2A>|  
+|ヒット テスト|<xref:System.Windows.Ink.StrokeCollection.HitTest%2A>|<xref:Microsoft.Ink.Ink.HitTest%2A>|  
+|インクのコピー|<xref:System.Windows.Controls.InkCanvas.CopySelection%2A>|<xref:Microsoft.Ink.Ink.ClipboardCopy%2A>|  
+|インクの貼り付け|<xref:System.Windows.Controls.InkCanvas.Paste%2A>|<xref:Microsoft.Ink.Ink.ClipboardPaste%2A>|  
+|ストロークのコレクションのカスタム プロパティへのアクセス|<xref:System.Windows.Ink.StrokeCollection.AddPropertyData%2A> \(プロパティは内部的に格納され、<xref:System.Windows.Ink.StrokeCollection.AddPropertyData%2A>、<xref:System.Windows.Ink.StrokeCollection.RemovePropertyData%2A>、および <xref:System.Windows.Ink.StrokeCollection.ContainsPropertyData%2A> をとおしてアクセスされます。\)|<xref:Microsoft.Ink.Ink.ExtendedProperties%2A> を使用します。|  
+  
+### プラットフォーム間でのインクの共有  
+ 各プラットフォームでインク データのオブジェクト モデルは異なりますが、プラットフォーム間でのデータの共有は非常に簡単です。  Windows フォーム アプリケーションのインクを保存して Windows Presentation Foundation アプリケーションに読み込む方法を次の例に示します。  
+  
+ [!code-csharp[WinFormWPFInk#UsingWinforms](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#usingwinforms)]
+ [!code-vb[WinFormWPFInk#UsingWinforms](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#usingwinforms)]  
+[!code-csharp[WinFormWPFInk#SaveWinforms](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#savewinforms)]
+[!code-vb[WinFormWPFInk#SaveWinforms](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#savewinforms)]  
+  
+ [!code-csharp[WinFormWPFInk#UsingWPF](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#usingwpf)]
+ [!code-vb[WinFormWPFInk#UsingWPF](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#usingwpf)]  
+[!code-csharp[WinFormWPFInk#LoadWPF](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#loadwpf)]
+[!code-vb[WinFormWPFInk#LoadWPF](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#loadwpf)]  
+  
+ Windows Presentation Foundation アプリケーションのインクを保存して Windows フォーム アプリケーションに読み込む方法を次の例に示します。  
+  
+ [!code-csharp[WinFormWPFInk#UsingWPF](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#usingwpf)]
+ [!code-vb[WinFormWPFInk#UsingWPF](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#usingwpf)]  
+[!code-csharp[WinFormWPFInk#SaveWPF](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#savewpf)]
+[!code-vb[WinFormWPFInk#SaveWPF](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#savewpf)]  
+  
+ [!code-csharp[WinFormWPFInk#UsingWinforms](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#usingwinforms)]
+ [!code-vb[WinFormWPFInk#UsingWinforms](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#usingwinforms)]  
+[!code-csharp[WinFormWPFInk#LoadWinforms](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WinformWPFInk/CSharp/Program.cs#loadwinforms)]
+[!code-vb[WinFormWPFInk#LoadWinforms](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WinformWPFInk/VisualBasic/Module1.vb#loadwinforms)]  
+  
+## タブレット ペンからのイベント  
+ Windows フォームおよび COM プラットフォームの <xref:Microsoft.Ink.InkOverlay>、<xref:Microsoft.Ink.InkCollector>、および <xref:Microsoft.Ink.InkPicture> は、ユーザーがペン データを入力するとイベントを受信します。  <xref:Microsoft.Ink.InkOverlay> または <xref:Microsoft.Ink.InkCollector> はウィンドウまたはコントロールに結合され、タブレット入力データによって発生するイベントにサブスクライブできます。  このようなイベントが発生するスレッドは、イベントがペン、マウス、またはプログラムのいずれの方法で発生するかによって異なります。  これらのイベントに関するスレッド処理の詳細については、「[General Threading Considerations](http://msdn.microsoft.com/ja-jp/cf35724f-5f80-4b3e-992a-a9d5ea99aae9)」および「[Threads on Which an Event Can Fire](http://msdn.microsoft.com/ja-jp/d1a5ab9b-d474-4ed7-9aa8-b5bdb771934f)」を参照してください。  
+  
+ Windows Presentation Foundation プラットフォームでは、<xref:System.Windows.UIElement> クラスにペン入力のイベントがあります。  これは、すべてのコントロールがスタイラス イベントの完全なセットを公開することを意味します。  スタイラス イベントはトンネル イベントとバブル イベントのペアを含み、常にアプリケーション スレッドで発生します。  詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+ 次の図で、スタイラス イベントを発生させるクラスのオブジェクト モデルを比較します。  Windows Presentation Foundation オブジェクト モデルはバブル イベントのみを示し、対応するトンネル イベントは示していません。  
+  
+ ![WPF と Winforms のスタイラス イベントのダイアグラム。](../../../../docs/framework/wpf/advanced/media/ink-stylusevents.png "Ink\_StylusEvents")  
+  
+## ペン データ  
+ 3 つのすべてのプラットフォームで、タブレット ペンからのデータを途中受信および操作する方法が用意されています。  Windows フォームおよび COM プラットフォームでは、これを行うために、<xref:Microsoft.StylusInput.RealTimeStylus> を作成してウィンドウまたはコントロールと結合し、<xref:Microsoft.StylusInput.IStylusSyncPlugin> または <xref:Microsoft.StylusInput.IStylusAsyncPlugin> インターフェイスを実装するクラスを作成します。  次に、カスタム プラグインが <xref:Microsoft.StylusInput.RealTimeStylus> のプラグイン コレクションに追加されます。  このオブジェクト モデルの詳細については、「[Architecture of the StylusInput APIs](http://msdn.microsoft.com/ja-jp/88bab0ab-df9f-4813-9a9f-9a137813f0b4)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラットフォームでは、<xref:System.Windows.UIElement> クラスによって、<xref:Microsoft.StylusInput.RealTimeStylus> と似た設計のプラグインのコレクションが公開されます。  ペン データを途中受信するには、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> を継承するクラスを作成し、オブジェクトを <xref:System.Windows.UIElement> の <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに追加します。  この操作の詳細については、「[スタイラスからの入力のインターセプト](../../../../docs/framework/wpf/advanced/intercepting-input-from-the-stylus.md)」を参照してください。  
+  
+ すべてのプラットフォームで、スレッド プールがスタイラス イベントを介してインク データを受信し、アプリケーション スレッドに送信します。  COM プラットフォームおよび Windows プラットフォームでのスレッド処理の詳細については、「[Threading Considerations for the StylusInput APIs](http://msdn.microsoft.com/ja-jp/5d98768a-c60b-4bb0-8640-9bf38254d41f)」を参照してください。  Windows Presentation Foundation でのスレッド処理の詳細については、「[インク スレッド モデル](../../../../docs/framework/wpf/advanced/the-ink-threading-model.md)」を参照してください。  
+  
+ 次の図で、ペン スレッド プールでペン データを受信するクラスのオブジェクト モデルを比較します。  
+  
+ ![StylusPlugin モデル WPF と Winforms のダイアグラム。](../../../../docs/framework/wpf/advanced/media/ink-stylusplugins.png "Ink\_StylusPlugins")
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/the-ink-threading-model.md b/docs/framework/wpf/advanced/the-ink-threading-model.md
new file mode 100644
index 00000000000..6a3e92bee2e
--- /dev/null
+++ b/docs/framework/wpf/advanced/the-ink-threading-model.md
@@ -0,0 +1,107 @@
+---
+title: "インク スレッド モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション ユーザー インターフェイス スレッド"
+  - "動的レンダリング スレッド"
+  - "インク コレクション プラグイン"
+  - "インク スレッド モデル"
+  - "インク, 描画"
+  - "ペン スレッド"
+  - "プラグイン, インク"
+  - "レンダリング インク"
+  - "スタイラス プラグイン"
+  - "スレッド化モデル"
+ms.assetid: c85fcad1-cb50-4431-847c-ac4145a35c89
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# インク スレッド モデル
+Tablet PC でインクを使用することの利点の 1 つは、通常のペンと用紙を使用して書いている感覚に非常に近いことです。  これを実現するために、タブレット ペンはマウスよりも非常に高いレートで入力データを収集し、ユーザーが書いたとおりにインクを描画します。  アプリケーションのユーザー インターフェイス \(UI\) スレッドは、ブロックされる可能性があるため、ペンのデータを収集し、インクを描画するためには十分ではありません。  これを解決するために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでは、ユーザーがインクを書く際に、2 つの追加スレッドを使用します。  
+  
+ デジタル インクの収集および描画に関与するスレッドを次のリストに示します。  
+  
+-   ペン スレッド \- スタイラスから入力を取得するスレッド   \(これは実際にはスレッド プールですが、ここではペン スレッドと呼びます\)。  
+  
+-   アプリケーション ユーザー インターフェイス スレッド \- アプリケーションのユーザー インターフェイスを制御するスレッド。  
+  
+-   動的レンダリング スレッド \- ユーザーがストロークを描画している間にインクを描画するスレッド。  動的レンダリング スレッドは、アプリケーションの他の UI 要素を描画するスレッドとは別のものです。詳細については、Window Presentation Foundation の「[スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)」を参照してください。  
+  
+ インク モデルは、アプリケーションが <xref:System.Windows.Controls.InkCanvas> を使用している場合でも、「[インク入力コントロールの作成](../../../../docs/framework/wpf/advanced/creating-an-ink-input-control.md)」で示したようなカスタム コントロールを使用している場合でも同じです。  ここでは、<xref:System.Windows.Controls.InkCanvas> でのスレッドについて説明していますが、カスタム コントロールを作成する場合でも、同じ概念が当てはまります。  
+  
+## スレッド処理の概要  
+ ユーザーがストロークを描画する場合のスレッド モデルを次の図に示します。  
+  
+ ![ストローク描画中のスレッド処理モデル。](../../../../docs/framework/wpf/advanced/media/inkthreading-drawingink.png "InkThreading\_DrawingInk")  
+  
+1.  ユーザーがストロークを描画している間に発生するアクション  
+  
+    1.  ユーザーがストロークを描画すると、スタイラス ポイントはペン スレッドに入ります。  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> などのスタイラス プラグインは、ペン スレッドでスタイラス ポイントを受け入れ、<xref:System.Windows.Controls.InkCanvas> が受け取る前にそれらのポイントを変更することができます。  
+  
+    2.  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> が、動的レンダリング スレッドでスタイラス ポイントを描画します。  これは、前の手順と同時に行われます。  
+  
+    3.  <xref:System.Windows.Controls.InkCanvas> が、UI スレッドでスタイラス ポイントを受け取ります。  
+  
+2.  ユーザーがストロークを終了した後に発生するアクション  
+  
+    1.  ユーザーがストロークの描画を終了すると、<xref:System.Windows.Controls.InkCanvas> が <xref:System.Windows.Ink.Stroke> オブジェクトを作成し、それを静的に描画する <xref:System.Windows.Controls.InkPresenter> に追加します。  
+  
+    2.  UI スレッドはストロークが静的に描画されることを <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> に通知し、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> はストロークの視覚的表現を削除します。  
+  
+## インク コレクションとスタイラス プラグイン  
+ 各 <xref:System.Windows.UIElement> には、<xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> があります。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> の <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> オブジェクトは、ペン スレッドでスタイラス ポイントを受け取り、それを変更することができます。  <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> オブジェクトは、<xref:System.Windows.Input.StylusPlugIns.StylusPlugInCollection> での順序に従って、スタイラス ポイントを受け取ります。  
+  
+ <xref:System.Windows.UIElement> の <xref:System.Windows.UIElement.StylusPlugIns%2A> コレクションに、`stylusPlugin1`、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer>、および `stylusPlugin2` がこの順序で含まれていると仮定した場合の状況を次の図に示します。  
+  
+ ![スタイラス プラグインの順序は出力に影響します。](../../../../docs/framework/wpf/advanced/media/inkthreading-pluginorder.png "InkThreading\_PluginOrder")  
+  
+ この図では、次の動作が実行されます。  
+  
+1.  `StylusPlugin1` が、x と y の値を変更します。  
+  
+2.  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> が、変更されたスタイラス ポイントを受け取り、それらを動的レンダリング スレッドで描画します。  
+  
+3.  `StylusPlugin2` が、変更されたスタイラス ポイントを受け取り、x と y の値をさらに変更します。  
+  
+4.  アプリケーションはスタイラス ポイントを収集し、ユーザーがストロークを終了すると、ストロークを静的に描画します。  
+  
+ `stylusPlugin1` がスタイラス ポイントを四角形に制限し、`stylusPlugin2` がスタイラス ポイントを右に平行移動するとします。  前のシナリオでは、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は制限されたスタイラス ポイントを受け取りますが、平行移動されたスタイラス ポイントは受け取りません。  ユーザーがストロークを描画すると、そのストロークは四角形の境界内に描画されますが、ユーザーがペンを持ち上げるまで平行移動されません。  
+  
+### UI スレッドでスタイラス プラグインを使用した操作を実行する  
+ ペン スレッドでは正確なヒット テストを実行できないため、場合によっては、一部の要素が他の要素を対象としたスタイラス入力を受け取ることがあります。  操作を実行する前に、入力が正しくルーティングされていることを確認する必要がある場合は、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn.OnStylusDownProcessed%2A>、<xref:System.Windows.Input.StylusPlugIns.StylusPlugIn.OnStylusMoveProcessed%2A>、または <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn.OnStylusUpProcessed%2A> の各メソッドにサブスクライブし、そのメソッド内で操作を実行します。  これらのメソッドは、正確なヒット テストが実行された後に、アプリケーション スレッドによって呼び出されます。  これらのメソッドにサブスクライブするには、ペン スレッドで実行されるメソッド内で <xref:System.Windows.Input.StylusPlugIns.RawStylusInput.NotifyWhenProcessed%2A> メソッドを呼び出します。  
+  
+ <xref:System.Windows.Input.StylusPlugIns.StylusPlugIn> のスタイラス イベントに関連した、ペン スレッドと UI スレッドの関係を次の図に示します。  
+  
+ ![インク スレッド処理モデル &#40;UI およびペン&#41;](../../../../docs/framework/wpf/advanced/media/inkthreading-plugincallbacks.png "InkThreading\_PluginCallbacks")  
+  
+## インクのレンダリング  
+ ユーザーがストロークを描画すると、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> はインクを別スレッドで描画するため、UI スレッドがビジー状態であっても、インクはペンから "流れ出る" ように見えます。  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は、スタイラス ポイントを収集しながら、動的レンダリング スレッドでビジュアル ツリーを構築します。  ユーザーがストロークを終了すると、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> は、アプリケーションが次の描画パスを実行する際に通知するように要求します。  アプリケーションが次の描画パスを完了した後、<xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> はビジュアル ツリーをクリーンアップします。  このプロセスを説明する図を次に示します。  
+  
+ ![インク スレッド処理のダイアグラム](../../../../docs/framework/wpf/advanced/media/inkthreading-visualtree.png "InkThreading\_VisualTree")  
+  
+1.  ユーザーがストロークを開始したとき。  
+  
+    1.  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> がビジュアル ツリーを作成します。  
+  
+2.  ユーザーがストロークを描画している間。  
+  
+    1.  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> がビジュアル ツリーを構築します。  
+  
+3.  ユーザーがストロークを終了したとき。  
+  
+    1.  <xref:System.Windows.Controls.InkPresenter> がストロークを自分のビジュアル ツリーに追加します。  
+  
+    2.  メディア統合レイヤー \(MIL\) がストロークを静的に描画します。  
+  
+    3.  <xref:System.Windows.Input.StylusPlugIns.DynamicRenderer> がビジュアルをクリーンアップします。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/themedictionary-markup-extension.md b/docs/framework/wpf/advanced/themedictionary-markup-extension.md
new file mode 100644
index 00000000000..a32546c53ca
--- /dev/null
+++ b/docs/framework/wpf/advanced/themedictionary-markup-extension.md
@@ -0,0 +1,77 @@
+---
+title: "ThemeDictionary のマークアップ拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "ThemeDictionaryExtension"
+  - "ThemeDictionary"
+helpviewer_keywords: 
+  - "ThemeDictionary マークアップ拡張機能"
+  - "XAML, ThemeDictionary マークアップ拡張機能"
+ms.assetid: aa75e10b-13dd-4989-972d-51bab63a05e2
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ThemeDictionary のマークアップ拡張機能
+カスタム コントロールの作成者やサードパーティ コントロールを組み込むアプリケーションに、テーマ固有のリソース ディクショナリを読み込んでコントロールのスタイル設定に使用する方法を提供します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{ThemeDictionary assemblyUri}" .../>  
+```  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<object>  
+  <object.property>  
+    <ThemeDictionary AssemblyName="assemblyUri"/>  
+  <object.property>  
+<object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`assemblyUri`|テーマ情報を格納するアセンブリの[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)]。  通常、これはより大きなパッケージ内のアセンブリを参照するパッケージの URI です。  アセンブリ リソースとパッケージの URI により、展開の問題が単純化されます。  詳細については、「[WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)」を参照してください。|  
+  
+## 解説  
+ この拡張機能は、1 つの特定のプロパティ値 \(<xref:System.Windows.ResourceDictionary.Source%2A?displayProperty=fullName> の値\) のみを設定するためのものです。  
+  
+ この拡張機能を使用することにより、いくつかのスタイルを含むリソースのみのアセンブリを 1 つだけ指定し、一部のスタイルはユーザーのシステムに [!INCLUDE[TLA#tla_aero](../../../../includes/tlasharptla-aero-md.md)] テーマが適用されている場合にのみ使用し、一部のスタイルは Luna テーマがアクティブの場合に使用するということが可能になります。  また、必要に応じて、コントロール固有のリソース ディクショナリのコンテンツを自動的に無効化したり再度読み込んだりして、別のテーマに固有なコンテンツにすることもできます。  
+  
+ `assemblyUri` 文字列 \(<xref:System.Windows.ThemeDictionaryExtension.AssemblyName%2A> プロパティ値\) は、特定のテーマに適用するディクショナリを識別する名前付け規則の基礎です。  `ThemeDictionary` の <xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> ロジックは、プリコンパイル済みのリソース アセンブリに格納されている特定のテーマ ディクショナリ バリアントを指す[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] を生成することにより、この規則を完成させます。  この名前付け規則や、テーマの一般的なコントロールのスタイル設定およびページ\/アプリケーション レベルのスタイル設定の操作に関する概念については、ここでは一部しか説明していません。  `ThemeDictionary` を使用する基本シナリオは、アプリケーション レベルで宣言された `ResourceDictionary` の <xref:System.Windows.ResourceDictionary.Source%2A> プロパティを指定することです。  直接 [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を指定するのではなく、`ThemeDictionary` 拡張機能を介してアセンブリの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を指定した場合は、システムのテーマが変更されるたびに適用される無効化ロジックが拡張機能のロジックから提供されます。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `ThemeDictionary` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.ThemeDictionaryExtension> 拡張クラスの <xref:System.Windows.ThemeDictionaryExtension.AssemblyName%2A> 値として割り当てられます。  
+  
+ `ThemeDictionary` は、オブジェクト要素構文でも使用できます。  この場合、<xref:System.Windows.ThemeDictionaryExtension.AssemblyName%2A> プロパティの値の指定は必須です。  
+  
+ `ThemeDictionary` は、<xref:System.Windows.Markup.StaticExtension.Member%2A> プロパティをプロパティおよび値のペアとして指定する詳細出力属性使用でも使用できます。  
+  
+```  
+<object property="{ThemeDictionary AssemblyName=assemblyUri}" .../>  
+```  
+  
+ 詳細出力の使用は、複数の設定可能プロパティを持つ拡張機能や、一部のプロパティがオプションである場合に役立ちます。  `ThemeDictionary` には、必須の設定可能プロパティが 1 つしか存在しないため、このような詳細出力の使用は一般的ではありません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサ実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.ThemeDictionaryExtension> クラスによって定義されます。  
+  
+ `ThemeDictionary` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のすべてのマークアップ拡張機能では、それぞれの属性構文で { と } の 2 つの記号を使用します。これは規約であり、これに従って [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップ拡張機能で属性を処理する必要があることを認識します。  詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/threading-model.md b/docs/framework/wpf/advanced/threading-model.md
new file mode 100644
index 00000000000..ed7671b7876
--- /dev/null
+++ b/docs/framework/wpf/advanced/threading-model.md
@@ -0,0 +1,229 @@
+---
+title: "スレッド モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "更新ボタンのテキスト"
+  - "メッセージの処理、入れ子になった"
+  - "ブロック (操作を)"
+  - "Dispatcher クラス"
+  - "共通言語ランタイム (CLR)、ロック機構"
+  - "共通言語ランタイム (CLR) のロック機構"
+  - "スレッド化モデル"
+  - "DependencyObject クラス"
+  - "Word のスペル チェック"
+  - "ボタンのテキストを更新"
+  - "スペル チェック (Word)"
+  - "非同期動作を公開します。"
+  - "DependencyObject クラス"
+  - "入れ子になったメッセージ処理"
+  - "ディスパッチャー クラス"
+  - "再入"
+ms.assetid: 02d8fd00-8d7c-4604-874c-58e40786770b
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 32
+---
+# スレッド モデル
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]スレッド処理の難しさから開発者を保存する設計されています。 その結果、ほとんどの[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]開発者は、1 つ以上のスレッドを使用するインターフェイスを作成する必要はありません。 マルチ スレッド プログラムは複雑で、デバッグが困難であるため、シングル スレッドのソリューションが存在する場合、避けてください。  
+  
+ 関係なくどの程度設計、ただし、いいえ[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]フレームワークが問題のすべての種類のシングル スレッドのソリューションを提供できることもできます。              [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]閉じるには複数のスレッドを向上させるような状況はまだあります[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]応答性またはアプリケーションのパフォーマンス。 いくつかの背景情報の資料を紹介した後は、このホワイト ペーパーは、このような状況をいくつか解説しでいくつかの低レベルの詳細に説明し、終了します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+> [!NOTE]
+>  このトピックでは、スレッドを使用して、 <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>非同期呼び出しのメソッドです。 呼び出して、非同期呼び出しを作成することも、 <xref:System.Windows.Threading.Dispatcher.InvokeAsync%2A>メソッドで、実行、<xref:System.Action>または<xref:System.Func%601>をパラメーターとして。  <xref:System.Windows.Threading.Dispatcher.InvokeAsync%2A>メソッドが返される、 <xref:System.Windows.Threading.DispatcherOperation>または<xref:System.Windows.Threading.DispatcherOperation%601>を持つ、<xref:System.Windows.Threading.DispatcherOperation.Task%2A>プロパティです。 使用することができます、`await`いずれかのキーワード、 <xref:System.Windows.Threading.DispatcherOperation>または関連付けられた<xref:System.Threading.Tasks.Task>します。 同期的に待機する必要がある場合、<xref:System.Threading.Tasks.Task>によって返される、 <xref:System.Windows.Threading.DispatcherOperation>または<xref:System.Windows.Threading.DispatcherOperation%601>を呼び出す、 <xref:System.Windows.Threading.TaskExtensions.DispatcherOperationWait%2A>拡張メソッド。  呼び出す<xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName>デッドロックが発生します。 使用の詳細については、<xref:System.Threading.Tasks.Task>非同期操作を実行するタスクの並列化を参照してください。  <xref:System.Windows.Threading.Dispatcher.Invoke%2A>メソッドも使用するオーバー ロードを持つ、<xref:System.Action>または<xref:System.Func%601>をパラメーターとして。  使用することができます、 <xref:System.Windows.Threading.Dispatcher.Invoke%2A> 、デリゲートを渡すことによって同期するメソッドを呼び出す<xref:System.Action>または<xref:System.Func%601>します。  
+  
+<a name="threading_overview"></a>   
+## <a name="overview-and-the-dispatcher"></a>概要と、ディスパッチャー  
+ 通常、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションは&2; つのスレッドで開始: レンダリングおよび管理するための別の処理に&1; つずつ、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]です。 レンダリング スレッドが効率的に実行中にバック グラウンドで非表示、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドの入力を受け取り、イベントを処理、画面の描画およびアプリケーション コードを実行します。 ほとんどのアプリケーションは、1 つを使用して[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドがいくつかの状況ではいくつかの使用を推奨します。 この例を使用して後で説明します。  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドのキューの作業と呼ばれるオブジェクト内の項目、<xref:System.Windows.Threading.Dispatcher>します。 <xref:System.Windows.Threading.Dispatcher>優先度ごとに作業項目を選択し、完了までの&1; つずつ実行します。  すべて[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドは少なくとも&1; つである必要があります<xref:System.Windows.Threading.Dispatcher>、および各<xref:System.Windows.Threading.Dispatcher>ただ&1; つのスレッドでの作業項目を実行することができます。  
+  
+ 応答性の高い、使いやすいアプリケーションを構築する秘訣は最大化する、<xref:System.Windows.Threading.Dispatcher>小さな作業項目を保持することでスループットです。 により、この項目は達しません内に留まっている古い、<xref:System.Windows.Threading.Dispatcher>キュー処理待機しています。 入力と応答の間に遅延は、ユーザーに不満ことができます。  
+  
+ どのような方法は[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションが大規模な操作を処理することになっているでしょうか。 場合、コードを使用するか、大規模な計算では、または、リモート サーバー上のデータベースを照会する必要がありますか。 通常は、それには、大規模なまま、別のスレッドで操作を処理、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッド内の項目に傾向が無料、<xref:System.Windows.Threading.Dispatcher>キューです。 その結果を報告できる大きな操作が完了したらに戻す、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドを表示するためです。  
+  
+ 従来、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]により[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]を作成したスレッドのみがアクセスする要素。 つまりが完了すると、いくつかの実行時間の長いタスクを担当するバック グラウンド スレッドにテキスト ボックスを更新できません。                  [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]これは、整合性を保つため[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]コンポーネントです。 リスト ボックスは、その内容が描画中にバック グラウンド スレッドによって更新された場合は奇妙に見える可能性があります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]この調整を適用する組み込みの相互排除メカニズムを備えています。 ほとんどのクラス[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]から派生<xref:System.Windows.Threading.DispatcherObject>します。 構築時、 <xref:System.Windows.Threading.DispatcherObject>への参照を格納、<xref:System.Windows.Threading.Dispatcher>現在実行中のスレッドにリンクします。 実際には、 <xref:System.Windows.Threading.DispatcherObject>が作成したスレッドに関連付けられます。 プログラムの実行中、 <xref:System.Windows.Threading.DispatcherObject>そのパブリックを呼び出すことができます<xref:System.Windows.Threading.DispatcherObject.VerifyAccess%2A>メソッドです。                  <xref:System.Windows.Threading.DispatcherObject.VerifyAccess%2A>を調べ、<xref:System.Windows.Threading.Dispatcher> 、現在のスレッドに関連付けられているし、比較、<xref:System.Windows.Threading.Dispatcher>構築中に格納されている参照します。 ハッシュが一致しない場合<xref:System.Windows.Threading.DispatcherObject.VerifyAccess%2A>例外をスローします。                  <xref:System.Windows.Threading.DispatcherObject.VerifyAccess%2A>に属するすべてのメソッドの開始時に呼び出されるものでは、 <xref:System.Windows.Threading.DispatcherObject>します。  
+  
+ 1 つのスレッドを変更できるだけの場合、 [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]、方法はバック グラウンド スレッドと対話するユーザーですか? バック グラウンド スレッドを問い合わせることができます、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドの代わりに操作を実行します。 これは作業項目を登録することによって、<xref:System.Windows.Threading.Dispatcher>の[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 <xref:System.Windows.Threading.Dispatcher>クラスは作業項目を登録するための&2; つのメソッドを提供します。 <xref:System.Windows.Threading.Dispatcher.Invoke%2A>と<xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>します。 どちらの方法では、デリゲートの実行をスケジュールします。                  <xref:System.Windows.Threading.Dispatcher.Invoke%2A>– の同期呼び出しは、まで返されなくては、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドが実際にはデリゲートの実行を終了します。                  <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>は非同期制御を戻しません。  
+  
+ <xref:System.Windows.Threading.Dispatcher>優先順位によって、キューに要素を並べ替えます。 要素を追加するときに指定できる&10; のレベルがある、<xref:System.Windows.Threading.Dispatcher>キューです。 これらの優先順位を管理、 <xref:System.Windows.Threading.DispatcherPriority>列挙します。 に関する詳細情報<xref:System.Windows.Threading.DispatcherPriority>レベルを参照して、[!INCLUDE[TLA2#tla_winfxsdk](../../../../includes/tla2sharptla-winfxsdk-md.md)]ドキュメントです。  
+  
+<a name="samples"></a>   
+## <a name="threads-in-action-the-samples"></a>実際のスレッド: サンプル  
+  
+<a name="prime_number"></a>   
+### <a name="a-single-threaded-application-with-a-long-running-calculation"></a>実行時間の長い計算をシングル スレッド アプリケーション  
+ ほとんど[!INCLUDE[TLA#tla_gui#plural](../../../../includes/tlasharptla-guisharpplural-md.md)]のユーザーの操作への応答で生成されるイベントの待機中にアイドル時間の大部分を費やしています。 慎重なプログラミング アイドル時間する建設的に使用できますの応答性に影響を与えず、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]です。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]で起こっているか、操作を中断する入力を許可しないスレッド モデル、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 つまりに戻ることを確認する必要があります、<xref:System.Windows.Threading.Dispatcher>古いに到達する前に、入力イベントの保留中の処理を定期的にします。  
+  
+ 次に例を示します。  
+  
+ ![含まれる素数のスクリーン ショット](../../../../docs/framework/wpf/advanced/media/threadingprimenumberscreenshot.PNG "ThreadingPrimeNumberScreenShot")  
+  
+ このシンプルなアプリケーションは、素数を検索して&3; から上方向にカウントします。 ユーザーがクリックしたとき、**開始** ボタンをクリック、検索を開始します。 プログラムは、素数を検出すると、その探索でユーザー インターフェイスを更新します。 任意の時点では、ユーザーは、検索を停止できます。  
+  
+ 単純なので、素数の検索はいくつかの問題について説明する無限に移動でした。  ボタンのクリック イベント ハンドラー内全体の検索、処理した場合は与えられません、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドが他のイベントを処理します。 [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]入力やプロセスに対応できないというメッセージです。 再描画し、ボタンのクリックに応答しません。  
+  
+ 別のスレッドでの素数の検索を実際に実行できますが、同期の問題に対処する必要がありますが。 シングル スレッドのアプローチで検出された最大の素数を一覧表示するラベルを直接更新ことができます。  
+  
+ 管理しやすいチャンクに計算のタスクを分割して定期的に戻ることが、<xref:System.Windows.Threading.Dispatcher>およびイベントを処理します。 紹介[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]を再描画し、入力を処理することです。  
+  
+ 計算とイベント処理の間での処理時間を分割する最善の方法は、計算を管理する、<xref:System.Windows.Threading.Dispatcher>します。 使用して、 <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>メソッド内の素数のチェックはスケジュールを同じキュー[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]からイベントを描画します。 この例では、一度に&1; つの素数のチェックのみをスケジュールします。 素数のチェックが完了したら、すぐに次のチェックをスケジュールします。 このチェックが保留中の実行後にのみ[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]イベントが処理されました。  
+  
+ ![ディスパッチャー キューの図](../../../../docs/framework/wpf/advanced/media/threadingdispatcherqueue.PNG "ThreadingDispatcherQueue")  
+  
+ [!INCLUDE[TLA#tla_word](../../../../includes/tlasharptla-word-md.md)]このメカニズムを使用してのスペル チェックは実行できます。 スペル チェックのアイドル時間を使用してバック グラウンドで行われますが、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 コードを見てみましょう。  
+  
+ 次の例では、ユーザー インターフェイスを作成する XAML を示します。  
+  
+ [!code-xml[ThreadingPrimeNumbers#ThreadingPrimeNumberXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingPrimeNumbers/CSharp/Window1.xaml#threadingprimenumberxaml)]  
+  
+ 次の例では、分離コードを示します。  
+  
+ [!code-csharp[ThreadingPrimeNumbers#ThreadingPrimeNumberCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingPrimeNumbers/CSharp/Window1.xaml.cs#threadingprimenumbercodebehind)]
+ [!code-vb[ThreadingPrimeNumbers#ThreadingPrimeNumberCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingPrimeNumbers/visualbasic/mainwindow.xaml.vb#threadingprimenumbercodebehind)]  
+  
+ 次の例では、対応するイベント ハンドラー、<xref:System.Windows.Controls.Button>します。  
+  
+ [!code-csharp[ThreadingPrimeNumbers#ThreadingPrimeNumberStartOrStop](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingPrimeNumbers/CSharp/Window1.xaml.cs#threadingprimenumberstartorstop)]
+ [!code-vb[ThreadingPrimeNumbers#ThreadingPrimeNumberStartOrStop](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingPrimeNumbers/visualbasic/mainwindow.xaml.vb#threadingprimenumberstartorstop)]  
+  
+ 上のテキストを更新するだけでなく、<xref:System.Windows.Controls.Button>、デリゲートを追加することで、最初の素数のチェックをスケジュールするため、このハンドラは、<xref:System.Windows.Threading.Dispatcher>キューです。 このイベント ハンドラーには、その作業が完了した後、<xref:System.Windows.Threading.Dispatcher>このデリゲートの実行を選択します。  
+  
+ 前に述べたよう<xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>は、<xref:System.Windows.Threading.Dispatcher>メンバー デリゲートの実行をスケジュールするために使用します。 この場合は、選択、 <xref:System.Windows.Threading.DispatcherPriority>優先度。 <xref:System.Windows.Threading.Dispatcher>を処理する重要なイベントがない場合にのみこのデリゲートを実行します。                          [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]応答性は番号チェックよりも重要です。 番号のチェックのルーチンを表す新しいデリゲートを渡します。  
+  
+ [!code-csharp[ThreadingPrimeNumbers#ThreadingPrimeNumberCheckNextNumber](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingPrimeNumbers/CSharp/Window1.xaml.cs#threadingprimenumberchecknextnumber)]
+ [!code-vb[ThreadingPrimeNumbers#ThreadingPrimeNumberCheckNextNumber](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingPrimeNumbers/visualbasic/mainwindow.xaml.vb#threadingprimenumberchecknextnumber)]  
+  
+ このメソッドでは、次の数が奇数の素数を確認します。 メソッドを直接更新を準備している場合、 `bigPrime` <xref:System.Windows.Controls.TextBlock>探索を反映するようにします。 これは、コンポーネントの作成に使用された同じスレッドで計算が行われているため実行できます。 計算用の個別のスレッドの使用を選択したより複雑な同期メカニズムを使用し、更新プログラムを実行する必要が、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 次に、このような状況を紹介します。  
+  
+ このサンプルの完全なソース コードについては、[シングル スレッド アプリケーションの実行時間の長い計算のサンプル](http://go.microsoft.com/fwlink/?LinkID=160038)  
+  
+<a name="weather_sim"></a>   
+### <a name="handling-a-blocking-operation-with-a-background-thread"></a>バック グラウンド スレッドでブロック操作の処理  
+ グラフィカル アプリケーションでのブロック操作の処理は難しくなります。 停止したように、アプリケーションが表示されますので、イベント ハンドラーからブロッキング メソッドを呼び出すたくはありません。 別のスレッドを使用してこれらの操作の処理しますが、完了したら、私たちと同期する、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドの直接変更できないため、[!INCLUDE[TLA2#tla_gui](../../../../includes/tla2sharptla-gui-md.md)]ワーカー スレッドからです。 使用して<xref:System.Windows.Threading.Dispatcher.Invoke%2A>または<xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A>にデリゲートを挿入する、<xref:System.Windows.Threading.Dispatcher>の[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 変更する権限を持つこれらのデリゲートを実行する最終的には、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]要素。  
+  
+ この例では、天気予報を取得するリモート プロシージャ コールを模倣します。 この呼び出しを実行する別のワーカー スレッドを使用し、スケジュールで更新メソッド、<xref:System.Windows.Threading.Dispatcher>の[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドの構成が完了します。  
+  
+ ![UI のスクリーン ショットを気象](../../../../docs/framework/wpf/advanced/media/threadingweatheruiscreenshot.png "ThreadingWeatherUIScreenShot")  
+  
+ [!code-csharp[ThreadingWeatherForecast#ThreadingWeatherCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingWeatherForecast/CSharp/Window1.xaml.cs#threadingweathercodebehind)]
+ [!code-vb[ThreadingWeatherForecast#ThreadingWeatherCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingWeatherForecast/visualbasic/window1.xaml.vb#threadingweathercodebehind)]  
+  
+ 記録する詳細情報の一部を次に示します。  
+  
+-   ボタンのハンドラーを作成します。  
+  
+     [!code-csharp[ThreadingWeatherForecast#ThreadingWeatherButtonHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingWeatherForecast/CSharp/Window1.xaml.cs#threadingweatherbuttonhandler)]
+     [!code-vb[ThreadingWeatherForecast#ThreadingWeatherButtonHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingWeatherForecast/visualbasic/window1.xaml.vb#threadingweatherbuttonhandler)]  
+  
+ ボタンをクリックすると、時計の図を表示し、起動してアニメーション化します。 私たちには、ボタンが無効にします。 `FetchWeatherFromServer`メソッドで新しいスレッドとし、戻り値を許可する、<xref:System.Windows.Threading.Dispatcher>天気予報を収集するを待つためにイベントを処理します。  
+  
+-   天気の取得  
+  
+     [!code-csharp[ThreadingWeatherForecast#ThreadingWeatherFetchWeather](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingWeatherForecast/CSharp/Window1.xaml.cs#threadingweatherfetchweather)]
+     [!code-vb[ThreadingWeatherForecast#ThreadingWeatherFetchWeather](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingWeatherForecast/visualbasic/window1.xaml.vb#threadingweatherfetchweather)]  
+  
+ わかりやすく、この例ではネットワーク用のコードでは、実際がありません。 代わりに、新しいスレッドを&4; 秒間スリープ状態に配置することでネットワーク アクセスの遅延をシミュレートします。 このとき、元の[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドがまだ実行していると、イベントに応答しています。 アニメーションの実行と、最小化したまま、このメッセージを表示し、最大化するには、ボタンも引き続き機能します。  
+  
+ 遅延時間が完了したら、際、天気予報をランダムに選択しましたに時間を報告するは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 呼び出しをスケジュールすることによって、これを行って`UpdateUserInterface`で、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]そのスレッドを使用してスレッド<xref:System.Windows.Threading.Dispatcher>します。 このスケジュールされたメソッド呼び出しに天気予報を記述する文字列を渡します。  
+  
+-   更新、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]  
+  
+     [!code-csharp[ThreadingWeatherForecast#ThreadingWeatherUpdateUI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingWeatherForecast/CSharp/Window1.xaml.cs#threadingweatherupdateui)]
+     [!code-vb[ThreadingWeatherForecast#ThreadingWeatherUpdateUI](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingWeatherForecast/visualbasic/window1.xaml.vb#threadingweatherupdateui)]  
+  
+ ときに、<xref:System.Windows.Threading.Dispatcher>で、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドに時間がある、スケジュール済みの呼び出しが実行される`UpdateUserInterface`します。 このメソッドは、時計のアニメーションを停止し、天気を表す画像を選択します。 イメージが表示され、「フェッチ予測」ボタンを復元します。  
+  
+<a name="multi_browser"></a>   
+### <a name="multiple-windows-multiple-threads"></a>複数のウィンドウ、複数のスレッド  
+ いくつか[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションが複数のトップレベル ウィンドウを必要とします。 1 つのスレッドも、まったく問題である/<xref:System.Windows.Threading.Dispatcher>の組み合わせを複数のウィンドウが複数のスレッドも管理がより良いジョブを実行します。 これは、windows の&1; つが、スレッドを独占れる可能性がある場合は特に当てはまります。  
+  
+ [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]エクスプ ローラーは、このような方法で機能します。 各新しいエクスプ ローラー ウィンドウが元のプロセスに属するが、その、独立したスレッドの制御下に作成します。  
+  
+ 使用して、 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]<xref:System.Windows.Controls.Frame>コントロール、ページを表示することができます。 単純な簡単に作成できます[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)]置き換えてください。 まず重要な機能: 新しいエクスプ ローラー ウィンドウを開始することです。 ユーザーが「新規ウィンドウ」をクリックするとボタン、別のスレッドでウィンドウのコピーを起動します。 これにより、windows のいずれかで実行時間の長いまたはブロックしている操作は、他のすべての windows をロックしません。  
+  
+ 実際には、Web ブラウザーのモデルは、独自の複雑なスレッド モデルを持ちます。 ほとんどの読者に精通していることがあるため選択しています。  
+  
+ 次の例では、コードを示します。  
+  
+ [!code-xml[ThreadingMultipleBrowsers#ThreadingMultiBrowserXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingMultipleBrowsers/CSharp/Window1.xaml#threadingmultibrowserxaml)]  
+  
+ [!code-csharp[ThreadingMultipleBrowsers#ThreadingMultiBrowserCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingMultipleBrowsers/CSharp/Window1.xaml.cs#threadingmultibrowsercodebehind)]
+ [!code-vb[ThreadingMultipleBrowsers#ThreadingMultiBrowserCodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingMultipleBrowsers/VisualBasic/Window1.xaml.vb#threadingmultibrowsercodebehind)]  
+  
+ このコードの次のスレッド部分は、最も重要な部分では、このコンテキストです。  
+  
+ [!code-csharp[ThreadingMultipleBrowsers#ThreadingMultiBrowserNewWindow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingMultipleBrowsers/CSharp/Window1.xaml.cs#threadingmultibrowsernewwindow)]
+ [!code-vb[ThreadingMultipleBrowsers#ThreadingMultiBrowserNewWindow](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingMultipleBrowsers/VisualBasic/Window1.xaml.vb#threadingmultibrowsernewwindow)]  
+  
+ このメソッドが呼び出されます「新しいウィンドウ」ボタンをクリックします。 新しいスレッドを作成し、非同期に開始します。  
+  
+ [!code-csharp[ThreadingMultipleBrowsers#ThreadingMultiBrowserThreadStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ThreadingMultipleBrowsers/CSharp/Window1.xaml.cs#threadingmultibrowserthreadstart)]
+ [!code-vb[ThreadingMultipleBrowsers#ThreadingMultiBrowserThreadStart](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ThreadingMultipleBrowsers/VisualBasic/Window1.xaml.vb#threadingmultibrowserthreadstart)]  
+  
+ このメソッドは、新しいスレッドの開始点です。 このスレッドの制御下で新しいウィンドウを作成します。                          [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]自動的に、新たに作成<xref:System.Windows.Threading.Dispatcher>を新しいスレッドを管理します。 ウィンドウを機能させるために行うには開始する、<xref:System.Windows.Threading.Dispatcher>します。  
+  
+<a name="stumbling_points"></a>   
+## <a name="technical-details-and-stumbling-points"></a>技術的な詳細と障害ポイント  
+  
+### <a name="writing-components-using-threading"></a>スレッドを使用するコンポーネントを記述  
+ [!INCLUDE[TLA#tla_netframewk](../../../../includes/tlasharptla-netframewk-md.md)]開発者ガイド 』 は、パターン、コンポーネントがそのクライアントに非同期の動作を公開する方法についてを説明 (を参照してください[非同期パターンの概要をイベントに基づく](../../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md))。 たとえばより一層理解をパッケージ化、`FetchWeatherFromServer`メソッドを再利用可能なノングラフィック コンポーネントにします。 次の標準的な[!INCLUDE[TLA#tla_netframewk](../../../../includes/tlasharptla-netframewk-md.md)]パターンでは、これは次のようなります。  
+  
+ [!code-csharp[CommandingOverviewSnippets#ThreadingArticleWeatherComponent1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#threadingarticleweathercomponent1)]
+ [!code-vb[CommandingOverviewSnippets#ThreadingArticleWeatherComponent1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#threadingarticleweathercomponent1)]  
+  
+ `GetWeatherAsync`使用して、バック グラウンド スレッドの作成など、前に説明する手法の&1; つの作業を非同期に実行呼び出し元のスレッドをブロックしていません。  
+  
+ このパターンの最も重要な部分の&1; つを呼び出して、 *MethodName* `Completed`メソッドを呼び出した同じスレッドを*MethodName* `Async`で始まるメソッド。 この方法を使用して[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]格納することで非常に簡単に<xref:System.Windows.Threading.Dispatcher.CurrentDispatcher%2A>— しノングラフィック コンポーネントのみで使用できますが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションではなく[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]または[!INCLUDE[TLA#tla_aspnet](../../../../includes/tlasharptla-aspnet-md.md)]プログラムです。  
+  
+ <xref:System.Windows.Threading.DispatcherSynchronizationContext>クラスがこのニーズに対処 — の簡略化されたバージョンとしてないということ<xref:System.Windows.Threading.Dispatcher>他と連動する[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]フレームワークもします。  
+  
+ [!code-csharp[CommandingOverviewSnippets#ThreadingArticleWeatherComponent2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CommandingOverviewSnippets/CSharp/Window1.xaml.cs#threadingarticleweathercomponent2)]
+ [!code-vb[CommandingOverviewSnippets#ThreadingArticleWeatherComponent2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CommandingOverviewSnippets/visualbasic/window1.xaml.vb#threadingarticleweathercomponent2)]  
+  
+### <a name="nested-pumping"></a>ポンプ入れ子になっています。  
+ ない完全にロック可能な場合があります、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 考えてみましょう、<xref:System.Windows.MessageBox.Show%2A>のメソッド、<xref:System.Windows.MessageBox>クラスです。                          <xref:System.Windows.MessageBox.Show%2A>ユーザーが [ok] ボタンをクリックするまで返されません。 ただしは、対話型にするためにメッセージ ループが必要なウィンドウが作成します。 ユーザーが [ok] をクリックするを待つ、中に、元のアプリケーション ウィンドウはユーザー入力に応答しません。 描画メッセージを処理すること、ただし、引き続き。 元のウィンドウには、取り除いたときにそれ自体が再描画します。  
+  
+ ![[OK] ボタンを含む MessageBox](../Image/ThreadingNestedPumping.png "ThreadingNestedPumping")  
+  
+ 一部のスレッドは、メッセージ ボックス ウィンドウを担当する必要があります。                          [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]メッセージ ボックス ウィンドウにのみ新しいスレッドを作成できますが、このスレッドは元のウィンドウで無効になっている要素を描画することはできません (相互排他を適用前の説明を思い出してください)。 代わりに、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]入れ子になったメッセージが処理システムを使用します。 <xref:System.Windows.Threading.Dispatcher>クラスと呼ばれる特殊なメソッドが含まれています。 <xref:System.Windows.Threading.Dispatcher.PushFrame%2A>、新しいメッセージ ループを開始し、アプリケーションの現在の実行ポイントを格納します。 入れ子になったメッセージ ループが終了すると、元の後に実行が再開されます。 <xref:System.Windows.Threading.Dispatcher.PushFrame%2A>呼び出します。  
+  
+ この場合、 <xref:System.Windows.Threading.Dispatcher.PushFrame%2A>への呼び出しでプログラムのコンテキストを維持<xref:System.Windows.MessageBox>します。                         <xref:System.Windows.MessageBox.Show%2A>をバック グラウンド ウィンドウを再描画し、メッセージ ボックス ウィンドウへの入力を処理する新しいメッセージ ループを開始します。 入れ子になったループが終了してコントロールを呼び出しの後に再開ユーザーは、[ok] をクリックするし、ポップアップ ウィンドウをクリア、<xref:System.Windows.MessageBox.Show%2A>します。  
+  
+### <a name="stale-routed-events"></a>古いルーティング イベント  
+ ルーティングされたイベント システム[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]イベントが発生したときに、ツリー全体を通知します。  
+  
+ [!code-xml[InputOvw#ThreadingArticleStaticRoutedEvent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/InputOvw/CSharp/Page1.xaml#threadingarticlestaticroutedevent)]  
+  
+ 楕円の上でマウスの左ボタンが押されたときに`handler2`を実行します。 後に`handler2`が終了したら、イベントに渡されます、<xref:System.Windows.Controls.Canvas>を使用してオブジェクト`handler1`を処理します。 これは、場合にのみ`handler2`は明示的にマーク イベント オブジェクトを処理済みとします。  
+  
+ 可能であればを`handler2`多大なこのイベントの処理時間がかかります。                          `handler2`使用して<xref:System.Windows.Threading.Dispatcher.PushFrame%2A>を返さないため、時間、入れ子になったメッセージ ループを開始します。 場合`handler2`イベント時に、このメッセージ ループが処理するように完了のマークは非常に古いでも、ツリーをイベントが渡されます。  
+  
+### <a name="reentrancy-and-locking"></a>再入およびロック  
+ ロック機構、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)]とまったく同じ動作が&1; つご想像; ロックを要求するときに完全に操作を中断するスレッドは返しません。 実際には、スレッドは優先度の高いメッセージを受信して処理が続行されます。 これにより、デッドロックを回避し、インターフェイスの最小応答が、軽度のバグの可能性を紹介します。  まれな状況でが、これについての知識がなくても、時間の大部分 (通常、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)]ウィンドウ メッセージまたは COM STA コンポーネント) これは、知っておくと便利です。  
+  
+ 開発者は、あると仮定して作業するために、ほとんどのインターフェイスはスレッド セーフを考慮してビルドされていないこと、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]が複数のスレッドによってアクセスされることはありません。 この場合は、1 つのスレッドが予期しないタイミングで環境が変更を行うことがあります、不正を引き起こしている効果、 <xref:System.Windows.Threading.DispatcherObject>相互排除メカニズムは、解決するはずです。 次の擬似コードを考慮してください。  
+  
+ ![スレッド処理再入のダイアグラム](../../../../docs/framework/wpf/advanced/media/threadingreentrancy.png "ThreadingReentrancy")  
+  
+ 適切な処理はほとんどの場合があります [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]このような予期しない再入を本当に問題が発生します。 特定のキー時刻に[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]呼び出し<xref:System.Windows.Threading.Dispatcher.DisableProcessing%2A>を使用するには、そのスレッドのロックの命令を変更する、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]ではなく、通常の再入可能性を必要としないロック[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]ロックします。  
+  
+ では、なぜでした、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]チームは、この動作を選択でしょうか。 COM STA オブジェクトとファイナライザーのスレッドを実行する必要があります。 オブジェクトがガベージ コレクトされるときにその`Finalize`メソッドがない実行専用のファイナライザー スレッドで、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 その中に問題があります、オブジェクトの COM STA で作成された、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]だけでスレッドを破棄できます、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドです。 [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]等しく、 <xref:System.Windows.Threading.Dispatcher.BeginInvoke%2A> (この例で使用して Win32 の`SendMessage`)。 しかし、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]スレッドがビジー状態、ファイナライザー スレッドが停止しているし、深刻なメモリ リークが発生した COM STA オブジェクトを破棄できません。 したがって、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]チームが、大変な発信する呼び出しの使用方法は、ロックが行われています。  
+  
+ タスクの[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]させず、メモリ リークは、すべての場所での再入をブロックしない理由は、予期しない再入を避けることができます。  
+  
+## <a name="see-also"></a>関連項目  
+ [実行時間の長い計算のサンプルでのシングル スレッド アプリケーション](http://go.microsoft.com/fwlink/?LinkID=160038)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/trees-in-wpf.md b/docs/framework/wpf/advanced/trees-in-wpf.md
new file mode 100644
index 00000000000..2abcc6d0d09
--- /dev/null
+++ b/docs/framework/wpf/advanced/trees-in-wpf.md
@@ -0,0 +1,101 @@
+---
+title: "WPF のツリー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "要素ツリー"
+  - "論理ツリー"
+  - "ビジュアル ツリー"
+ms.assetid: e83f25e5-d66b-4fc7-92d2-50130c9a6649
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# WPF のツリー
+多くのテクノロジでは、要素およびコンポーネントはツリー構造で編成され、開発者はこのツリー内のオブジェクト ノードを直接操作してアプリケーションのレンダリングまたは動作に影響を与えます。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でも各種のツリー構造というメタファを使用してプログラム要素間のリレーションシップを定義します。  ほとんどの場合、WPF 開発者は、オブジェクト ツリー メタファについて概念的に考えながらアプリケーションをコードで作成したりアプリケーションの一部を XAML で定義したりすることができますが、そのためには、XML DOM で使用するような一般的なオブジェクト ツリー操作 API ではなく特定の API を呼び出したり特定のマークアップを使用したりします。  WPF では、ツリー メタファ ビューを提供する <xref:System.Windows.LogicalTreeHelper> と <xref:System.Windows.Media.VisualTreeHelper> の 2 つのヘルパー クラスを公開しています。  ビジュアル ツリーおよび論理ツリーという用語も WPF のドキュメントで使用されます。これらの同じツリーは、特定の主要な WPF 機能の動作を理解するうえで役立つためです。  ここでは、ビジュアル ツリーおよび論理ツリーが表す項目を定義し、これらのツリーがオブジェクト ツリーの全体的な概念とどのように関連するかについて説明し、<xref:System.Windows.LogicalTreeHelper> および <xref:System.Windows.Media.VisualTreeHelper> について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="element_tree"></a>   
+## WPF のツリー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の最も完全なツリー構造はオブジェクト ツリーです。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でアプリケーション ページを定義し、その [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を読み込むと、マークアップ内の要素の入れ子のリレーションシップに基づいてツリー構造が作成されます。  コードでアプリケーションまたはアプリケーションの一部を定義した場合、ツリー構造は、指定したオブジェクトのコンテンツ モデルを実装するプロパティにプロパティ値を割り当てる方法に基づいて作成されます。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、完全なオブジェクト ツリーを概念化し、パブリック API にレポートできるようにする方法として、論理ツリーとビジュアル ツリーの 2 つが用意されています。  論理ツリーとビジュアル ツリーの違いは必ずしも重要とは限りませんが、特定の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] サブシステムでは問題が生じることがあり、マークアップやコード内での選択に影響することがあります。  
+  
+ 論理ツリーやビジュアル ツリーを直接操作するとは限らない場合でも、ツリーの操作方法の概念を理解することは、WPF をテクノロジとして理解するうえで役立ちます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのプロパティの継承やイベント ルーティングを理解するためには、WPF をある種のツリー メタファとして考えることも重要です。  
+  
+> [!NOTE]
+>  オブジェクト ツリーは実際の API というよりは概念なので、この概念について考える別の方法としてオブジェクト グラフがあります。  実際には、ツリー メタファが分割される実行時のオブジェクト間にリレーションシップがあります。  ただし、特に XAML で定義された UI では、ツリー メタファは十分に関連性があるため、ほとんどの WPF のドキュメントではこの一般的な概念を指す場合にオブジェクト ツリーという用語が使用されます。  
+  
+<a name="logical_tree"></a>   
+## 論理ツリー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、要素を支援するオブジェクトのプロパティを設定することで UI 要素にコンテンツを追加します。  たとえば、<xref:System.Windows.Controls.ListBox> コントロールに項目を追加するには、<xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティを操作します。  これにより、<xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティの値である <xref:System.Windows.Controls.ItemCollection> に項目を配置することになります。  同様に、<xref:System.Windows.Controls.DockPanel> にオブジェクトを追加するには、<xref:System.Windows.Controls.Panel.Children%2A> プロパティ値を操作します。  この場合は、<xref:System.Windows.Controls.UIElementCollection> にオブジェクトを追加することになります。  コード例については、「[Add an Element Dynamically](http://msdn.microsoft.com/ja-jp/d00f258a-7973-4de7-bc54-a3fc1f638419)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、次の例に示すように、<xref:System.Windows.Controls.ListBox> にリスト項目を配置する場合、あるいは <xref:System.Windows.Controls.DockPanel> にコントロールまたは他の UI 要素を配置する場合は、<xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティと <xref:System.Windows.Controls.Panel.Children%2A> プロパティも明示的または暗黙的に使用します。  
+  
+ [!code-xml[TreeOvwsSupport#AllCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeOvwsSupport/CS/page1.xaml#allcode)]  
+  
+ この XAML を XML としてドキュメント オブジェクト モデルで処理する場合、"implicit" としてコメント アウトされているタグを含めたとすると \(これも有効な形式です\)、結果として得られる XML DOM ツリーには、`<ListBox.Items>` および他の暗黙的な項目に対応する要素が含まれると予想されます。  しかし、マークアップを読み込んでオブジェクトに出力する時点では、XAML はそのようには処理されず、結果のオブジェクト グラフには指定したとおりの `ListBox.Items` は含まれません。  ただし、<xref:System.Windows.Controls.ItemCollection> を格納する `Items` という名前の <xref:System.Windows.Controls.ListBox> プロパティは含まれます。その <xref:System.Windows.Controls.ItemCollection> は、<xref:System.Windows.Controls.ListBox> の XAML の処理時に初期化されますが空です。  その後、パーサーによる `ItemCollection.Add` の呼び出しによって、<xref:System.Windows.Controls.ListBox> のコンテンツとして存在する各子オブジェクト要素が <xref:System.Windows.Controls.ItemCollection> に追加されます。  このオブジェクト ツリーへの XAML の処理例は、これまでのところ、作成されたオブジェクト ツリーが基本的に論理ツリーである例のように見えます。  
+  
+ ただし、論理ツリーは、XAML の暗黙的な構文項目が除外されている場合でも、実行時のアプリケーション UI に対して存在するオブジェクト グラフ全体ではありません。  この主な理由は、ビジュアルとテンプレートです。  たとえば <xref:System.Windows.Controls.Button> について考えます。  論理ツリーでは、<xref:System.Windows.Controls.Button> オブジェクトがレポートされ、文字列 `Content` もレポートされます。  ただし、ランタイム オブジェクト ツリーにはこのボタン以上のものが表示されます。  特に、特定の <xref:System.Windows.Controls.Button> コントロール テンプレートが適用されたので、ボタンは画面上にその状態でのみ表示されます。  実行時に論理ツリーを参照している場合でも \(表示される UI からの入力イベントを処理して論理ツリーを読み取るなど\)、適用されたテンプレートから取得されたビジュアル \(ビジュアル ボタンを囲むテンプレートで定義された濃い灰色の <xref:System.Windows.Controls.Border> など\) は論理ツリーではレポートされません。  テンプレートのビジュアルを確認するには、ビジュアル ツリーを調べる必要があります。  
+  
+ 作成されるオブジェクト グラフおよび XAML の暗黙的な構文に [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 構文が対応付けられる方法の詳細については、「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」または「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+<a name="tree_property_inheritance_event_routing"></a>   
+### 論理ツリーの目的  
+ 論理ツリーは、コンテンツ モデルが、使用可能な子オブジェクトを簡単に反復処理できること、およびコンテンツ モデルの拡張を目的としています。  論理ツリーは、論理ツリー内のすべてのオブジェクトがいつ読み込まれるかなど、特定の通知のフレームワークも提供します。  基本的に、論理ツリーは、ビジュアルを除外したフレームワーク レベルではランタイム オブジェクト グラフに近いと言えますが、独自のランタイム アプリケーションのコンポジションに対する多くのクエリ操作では論理ツリーで十分です。  
+  
+ また、静的リソース参照と動的リソース参照はどちらも、最初は要求元のオブジェクト、次は論理ツリーの上方で <xref:System.Windows.FrameworkElement.Resources%2A> コレクションの論理ツリーを介した上方への検索を行って、<xref:System.Windows.ResourceDictionary> を格納し、場合によってはそのキーを格納する別の `Resources` 値の各 <xref:System.Windows.FrameworkElement> \(または <xref:System.Windows.FrameworkContentElement>\) をチェックすることによって解決されます。  論理ツリーとビジュアル ツリーの両方が存在する場合は、論理ツリーがリソースの検索に使用されます。  リソース ディクショナリおよび検索の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+<a name="composition"></a>   
+### 論理ツリーのコンポジション  
+ 論理ツリーは、[WPF フレームワーク レベル](GTMT)で定義されます。つまり、論理ツリーの操作に最も関連する WPF 基本要素は <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> です。  ただし、実際に <xref:System.Windows.LogicalTreeHelper> API を使用するとわかるように、論理ツリーには <xref:System.Windows.FrameworkElement> でも <xref:System.Windows.FrameworkContentElement> でもないノードが含まれる場合があります。  たとえば、論理ツリーでは、文字列である <xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Text%2A> 値がレポートされます。  
+  
+<a name="override_logical_tree"></a>   
+### 論理ツリーのオーバーライド  
+ 高度なコントロールを作成するときには、論理ツリーをオーバーライドできます。そのためには、一般的なオブジェクトやコンテンツ モデルで論理ツリー内のオブジェクトを追加または削除する方法を定義している、いくつかの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] をオーバーライドします。  論理ツリーのオーバーライド例については、「[論理ツリーをオーバーライドする](../../../../docs/framework/wpf/advanced/how-to-override-the-logical-tree.md)」を参照してください。  
+  
+<a name="pvi"></a>   
+### プロパティ値の継承  
+ プロパティ値の継承は、ハイブリッド ツリーを通じて行われます。  プロパティの継承を有効化する <xref:System.Windows.FrameworkPropertyMetadata.Inherits%2A> プロパティが含まれる実際のメタデータは、[WPF フレームワーク レベル](GTMT)の <xref:System.Windows.FrameworkPropertyMetadata> クラスです。  このため、元の値を保持する親とその値を継承する子オブジェクトの両方が <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> であり、両方が、ある論理ツリーに含まれている必要があります。  ただし、プロパティの継承をサポートする既存の WPF プロパティでは、プロパティ値の継承は、論理ツリーにない、介在するオブジェクトを通じて存続できます。  これは主に、template 宣言されたインスタンスまたはさらに上位レベルのページ レベル コンポジション \(論理ツリー内の上位\) で設定されている継承されたプロパティ値をテンプレート要素で使用することに関連します。  プロパティ値の継承が、このような境界を越えて変わらず動作するためには、継承するプロパティを添付プロパティとして登録する必要があります。また、プロパティの継承動作を使用してカスタム依存関係プロパティを定義する場合は、このパターンに従う必要があります。  プロパティの継承で使用する正確なツリーを、実行時であっても、ヘルパー クラス ユーティリティ メソッドで完全に予測することができません。  詳細については、「[プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)」を参照してください。  
+  
+<a name="two_trees"></a>   
+## ビジュアル ツリー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、論理ツリーの概念に加えて、[ビジュアル ツリー](GTMT)の概念も存在します。  ビジュアル ツリーは、<xref:System.Windows.Media.Visual> 基本クラスによって表されるビジュアル オブジェクトの構造を示します。  コントロールのテンプレートを作成する場合は、そのコントロールに適用するビジュアル ツリーを定義または再定義します。  ビジュアル ツリーは、パフォーマンスの向上および最適化のために、描画に対して低レベルの制御が必要な開発者にとっても非常に有用です。  従来の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのプログラミングの一環としてビジュアル ツリーについて公開されていることの 1 つは、[ルーティング イベント](GTMT)のイベント ルートは、通常、論理ツリーではなくビジュアル ツリーをたどるということです。  ルーティング イベントの動作の細部は、コントロールの作成者でない限り、すぐにはわからない場合があります。  ビジュアル ツリーを介したルーティング イベントにより、ビジュアルのレベルで構成を実装するコントロールによってイベントを処理したり、イベント setter を作成したりできるようになります。  
+  
+<a name="trees_content"></a>   
+## ツリー、コンテンツ要素、およびコンテンツ ホスト  
+ コンテンツ要素 \(<xref:System.Windows.ContentElement> から派生するクラス\) はビジュアル ツリーには含まれません。これらは <xref:System.Windows.Media.Visual> を継承しておらず、視覚的表現を持ちません。  UI に表示するには、<xref:System.Windows.Media.Visual> であり、論理ツリーの参加要素でもあるコンテンツ ホスト内で、<xref:System.Windows.ContentElement> をホストする必要があります。  通常、このようなオブジェクトは <xref:System.Windows.FrameworkElement> です。  コンテンツ ホストは、コンテンツにとって "ブラウザー" のようなものであり、ホストが制御する画面領域内でそのコンテンツの表示方法を選択するものと考えることができます。  コンテンツがホストされると、このコンテンツは、ビジュアル ツリーに通常関連付けられている特定のツリー プロセスで 1 つの要因になることができます。  一般に、<xref:System.Windows.FrameworkElement> ホスト クラスには、ホストされるコンテンツが実際にはビジュアル ツリーに含まれない場合でも、コンテンツの論理ツリーのサブノードを介して、ホストされる <xref:System.Windows.ContentElement> をイベント ルートに追加する実装コードが含まれます。  これは、<xref:System.Windows.ContentElement> が、自身以外の要素にルーティングするルーティング イベントを調達できるようにするために必要です。  
+  
+<a name="tree_traversal"></a>   
+## ツリーの走査  
+ <xref:System.Windows.LogicalTreeHelper> クラスには、論理ツリーの走査用に <xref:System.Windows.LogicalTreeHelper.GetChildren%2A>、<xref:System.Windows.LogicalTreeHelper.GetParent%2A>、および <xref:System.Windows.LogicalTreeHelper.FindLogicalNode%2A> の各メソッドが用意されています。  これらのコントロールはほとんど常に論理上の子要素を専用のコレクション プロパティとして公開し、`Add`、インデクサーなどのコレクション アクセスをサポートしているため、多くの場合、既存のコントロールの論理ツリーを移動する必要はありません。  ツリーの移動が使用される主なシナリオは、コントロール作成者が、コレクション プロパティが定義済みの <xref:System.Windows.Controls.ItemsControl> や <xref:System.Windows.Controls.Panel> など、対象とするコントロール パターンから派生することを選択しない場合や、コレクション プロパティを独自にサポートする場合です。  
+  
+ ビジュアル ツリーも、ビジュアル ツリーの走査に使用できるヘルパー クラス <xref:System.Windows.Media.VisualTreeHelper> をサポートしています。  ビジュアル ツリーでは、コントロール固有のプロパティを使用した便利な移動方法は公開されていないため、プログラミング シナリオで必要な場合には、ビジュアル ツリーを移動する方法として <xref:System.Windows.Media.VisualTreeHelper> クラスが推奨されます。  詳細については、「[WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  場合によっては、適用されたテンプレートのビジュアル ツリーを調べる必要が生じることがあります。  この方法を使用するときには注意が必要です。  テンプレートを定義するコントロールのビジュアル ツリーを走査する場合でも、コントロールのコンシューマーは、インスタンスで <xref:System.Windows.Controls.Control.Template%2A> プロパティを設定することで常にテンプレートを変更でき、エンド ユーザーでさえシステム テーマを変更することで適用されたテンプレートに影響を与えることができます。  
+  
+<a name="routes"></a>   
+## "ツリー" としてのルーティング イベントのルート  
+ 前述のように、特定のルーティング イベントのルートは、ビジュアル ツリーと論理ツリーの表現を組み合わせたツリーの単一の定義済みパスをたどります。  イベント ルートは、トンネル ルーティング イベントかバブル ルーティング イベントかに応じて、ツリーを上方向または下方向へ移動できます。  イベント ルートの概念では、実際にルーティングするイベントの発生とは無関係にイベント ルートを "移動する" のに使用される、ヘルパー クラスを直接にはサポートしていません。  ルートを表す <xref:System.Windows.EventRoute> クラスはありますが、そのクラスのメソッドは、通常、内部でのみ使用されています。  
+  
+<a name="resourcesandtrees"></a>   
+## リソース ディクショナリとツリー  
+ ページで定義されているすべての `Resources` に対するリソース ディクショナリ検索では、基本的に、論理ツリーが走査されます。  論理ツリーにないオブジェクトもキーを持つリソースを参照できますが、リソース検索シーケンスは、そのオブジェクトが論理ツリーに接続している場所から開始されます。  WPF では、論理ツリー ノードのみが <xref:System.Windows.ResourceDictionary> を含む `Resources` プロパティを使用できるため、<xref:System.Windows.ResourceDictionary> からのキーを持つリソースの検索時にビジュアル ツリーを走査しても利点はありません。  
+  
+ ただし、リソース検索も、直接の論理ツリーを超えて拡張できます。  アプリケーション マークアップの場合、アプリケーション レベルのリソース ディクショナリ、テーマ サポート、および静的プロパティまたはキーとして参照されるシステム値へとリソース検索が続きます。  リソース参照が動的な場合は、テーマ自体も、テーマ論理ツリーの外部にあるシステム値を参照できます。  リソース ディクショナリおよび検索ロジックの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+## 参照  
+ [入力の概要](../../../../docs/framework/wpf/advanced/input-overview.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [オブジェクト ツリーに存在しないオブジェクト要素の初期化](../../../../docs/framework/wpf/advanced/initialization-for-object-elements-not-in-an-object-tree.md)   
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/troubleshooting-hybrid-applications.md b/docs/framework/wpf/advanced/troubleshooting-hybrid-applications.md
new file mode 100644
index 00000000000..4f78a0217ad
--- /dev/null
+++ b/docs/framework/wpf/advanced/troubleshooting-hybrid-applications.md
@@ -0,0 +1,133 @@
+---
+title: "ハイブリッド アプリケーションのトラブルシューティング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ハイブリッド アプリケーション [WPF 相互運用性]"
+  - "相互運用性 [WPF], Windows フォーム"
+  - "メッセージ ループ [WPF]"
+  - "重複するコントロール"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+ms.assetid: f440c23f-fa5d-4d5a-852f-ba61150e6405
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# ハイブリッド アプリケーションのトラブルシューティング
+<a name="introduction"></a> ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の両方のテクノロジを使用するハイブリッド アプリケーションを作成するときに発生する可能性のある一般的な問題について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overlapping_controls"></a>   
+## コントロールの重複  
+ コントロールが意図したように重ならない場合があります。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] は、コントロールごとに異なる HWND を使用します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、ページ上のすべてのコンテンツに 1 つの HWND を使用します。  このような実装の違いにより、意図したものとは異なる重なり方になります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、常に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツの一番上に表示されます。  
+  
+ <xref:System.Windows.Forms.Integration.ElementHost> コントロールでホストされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの z オーダーで表示されます。  <xref:System.Windows.Forms.Integration.ElementHost> コントロールを重ねることはできますが、ホストされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは相互に結合または対話しません。  
+  
+<a name="child_property"></a>   
+## 子プロパティ  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスおよび <xref:System.Windows.Forms.Integration.ElementHost> クラスがホストできる子コントロールまたは要素は 1 つだけです。  複数のコントロールまたは要素をホストするには、子コンテンツとしてコンテナーを使用する必要があります。  たとえば、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のボタン コントロールとチェック ボックス コントロールを <xref:System.Windows.Forms.Panel?displayProperty=fullName> コントロールに追加し、パネルを <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールの <xref:System.Windows.Forms.Integration.WindowsFormsHost.Child%2A> プロパティに割り当てることはできます。  しかし、ボタン コントロールとチェック ボックス コントロールを個別に同じ <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールに追加することはできません。  
+  
+<a name="scaling"></a>   
+## スケーリング  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]では、スケーリング モデルが異なります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のスケーリング変換には、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに対して意味のあるものと意味のないものがあります。  たとえば、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの 0 へのスケーリングは機能しますが、同じコントロールを 0 以外の値にスケーリングして戻そうとしても、コントロールのサイズは 0 のままです。  詳細については、「[WindowsFormsHost 要素のレイアウトに関する考慮事項](../../../../docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md)」を参照してください。  
+  
+<a name="adapter"></a>   
+## アダプター  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスと <xref:System.Windows.Forms.Integration.ElementHost> クラスには非表示のコンテナーが含まれるため、これらを使用する際には混乱が生じる場合があります。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスと <xref:System.Windows.Forms.Integration.ElementHost> クラスはどちらもアダプターと呼ばれる非表示のコンテナーを持っており、コンテンツをホストするために使用します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の場合、アダプターは <xref:System.Windows.Forms.ContainerControl?displayProperty=fullName> クラスから派生します。  <xref:System.Windows.Forms.Integration.ElementHost> コントロールの場合、アダプターは <xref:System.Windows.Controls.DockPanel> 要素から派生します。  このコンテナーについては、相互運用性に関する他のトピックでアダプターに関する説明を参照してください。  
+  
+<a name="nesting"></a>   
+## 入れ子  
+ <xref:System.Windows.Forms.Integration.ElementHost> コントロールの内部への <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の入れ子は、サポートされていません。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の内部への <xref:System.Windows.Forms.Integration.ElementHost> コントロールの入れ子も、サポートされていません。  
+  
+<a name="focus"></a>   
+## フォーカス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]ではフォーカスの動作が異なり、ハイブリッド アプリケーションではフォーカスに関する問題が発生する可能性があります。  たとえば、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の内部にフォーカスがある場合、ページを最小化して元に戻すと、またはモーダル ダイアログ ボックスを表示すると、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の内部のフォーカスが失われる可能性があります。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素はまだフォーカスを保持していますが、内部のコントロールはフォーカスを失う場合があります。  
+  
+ データの検証も、フォーカスによって影響されます。  検証は <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の中では機能しますが、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素から外へ Tab キーで移動する場合や、2 つの異なる <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の間では、検証が機能しません。  
+  
+<a name="property_mapping"></a>   
+## プロパティの割り当て  
+ 一部のプロパティの割り当てでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] テクノロジと [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] テクノロジの間の異なる実装をブリッジするために、広範な解釈が必要になります。  プロパティの割り当てを使用すると、フォント、色、およびその他のプロパティの変更にコードで対応できます。  一般に、プロパティの割り当ては、*Property*Changed イベントまたは On*Property*Changed 呼び出しをリッスンし、子コントロールまたはそのアダプターで適切なプロパティを設定することで機能します。  詳細については、「[Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)」を参照してください。  
+  
+<a name="layoutrelated_properties_on_hosted_content"></a>   
+## ホストされるコンテンツでのレイアウト関連のプロパティ  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost.Child%2A?displayProperty=fullName> プロパティまたは <xref:System.Windows.Forms.Integration.ElementHost.Child%2A?displayProperty=fullName> プロパティを割り当てると、ホストされるコンテンツで複数のレイアウト関連プロパティが自動的に設定されます。  これらのコンテンツ プロパティを変更すると、予期しないレイアウト動作が発生する場合があります。  
+  
+ ホストされるコンテンツは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> および親の <xref:System.Windows.Forms.Integration.ElementHost> を埋めるようにドッキングされます。  この動作を有効にするため、子プロパティを設定すると複数のプロパティが設定されます。  <xref:System.Windows.Forms.Integration.ElementHost> クラスおよび <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスによって設定されるコンテンツ プロパティを次の表に示します。  
+  
+|ホスト クラス|コンテンツ プロパティ|  
+|-------------|-----------------|  
+|<xref:System.Windows.Forms.Integration.ElementHost>|<xref:System.Windows.FrameworkElement.Height%2A><br /><br /> <xref:System.Windows.FrameworkElement.Width%2A><br /><br /> <xref:System.Windows.FrameworkElement.Margin%2A><br /><br /> <xref:System.Windows.FrameworkElement.VerticalAlignment%2A><br /><br /> <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>|  
+|<xref:System.Windows.Forms.Integration.WindowsFormsHost>|<xref:System.Windows.Forms.Control.Margin%2A><br /><br /> <xref:System.Windows.Forms.Control.Dock%2A><br /><br /> <xref:System.Windows.Forms.Control.AutoSize%2A><br /><br /> <xref:System.Windows.Forms.Control.Location%2A><br /><br /> <xref:System.Windows.Forms.Control.MaximumSize%2A>|  
+  
+ ホストされるコンテンツで、これらのプロパティを直接設定しないでください。  詳細については、「[WindowsFormsHost 要素のレイアウトに関する考慮事項](../../../../docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md)」を参照してください。  
+  
+<a name="navigation_applications"></a>   
+## ナビゲーション アプリケーション  
+ ナビゲーション アプリケーションが、ユーザーの状態を保持しない場合があります。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、ナビゲーション アプリケーションで使用されると、コントロールを再作成します。  ユーザーが <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素をホストするページから移動した後、そのページに戻ると、子コントロールの再作成が発生します。  ユーザーがそれまでに入力したコンテンツは失われます。  
+  
+<a name="message_loop_interoperation"></a>   
+## メッセージ ループの相互運用  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のメッセージ ループを使用するとき、メッセージが意図したように処理されない場合があります。  <xref:System.Windows.Forms.Integration.WindowsFormsHost.EnableWindowsFormsInterop%2A> メソッドは <xref:System.Windows.Forms.Integration.WindowsFormsHost> コンストラクターによって呼び出されます。  このメソッドは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のメッセージ ループにメッセージ フィルターを追加します。  このフィルターは、<xref:System.Windows.Forms.Control?displayProperty=fullName> がメッセージの送信先であった場合は <xref:System.Windows.Forms.Control.PreProcessMessage%2A?displayProperty=fullName> メソッドを呼び出し、メッセージを変換およびディスパッチします。  
+  
+ <xref:System.Windows.Forms.Application.Run%2A?displayProperty=fullName> で [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のメッセージ ループ内の <xref:System.Windows.Window> を表示した場合、<xref:System.Windows.Forms.Integration.ElementHost.EnableModelessKeyboardInterop%2A> メソッドを呼び出さない限り、何も入力できません。  <xref:System.Windows.Forms.Integration.ElementHost.EnableModelessKeyboardInterop%2A> メソッドは <xref:System.Windows.Window> を受け取り、キー関連のメッセージ再ルーティングする <xref:System.Windows.Forms.IMessageFilter?displayProperty=fullName> を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のメッセージ ループに追加します。  詳細については、「[Windows フォームと WPF の相互運用性入力アーキテクチャ](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-interoperability-input-architecture.md)」を参照してください。  
+  
+<a name="opacity_and_layering"></a>   
+## 不透明度とレイヤー表示  
+ <xref:System.Windows.Interop.HwndHost> クラスは、レイヤー表示をサポートしません。  つまり、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素で <xref:System.Windows.UIElement.Opacity%2A> プロパティを設定しても何の効果もなく、<xref:System.Windows.Window.AllowsTransparency%2A> が `true` に設定されている他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ウィンドウとのブレンド操作は行われません。  
+  
+<a name="dispose"></a>   
+## Dispose  
+ クラスを適切に破棄しないと、リソースがリークする可能性があります。  ハイブリッド アプリケーションでは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスと <xref:System.Windows.Forms.Integration.ElementHost> クラスを確実に破棄してください。そうしないと、リソースがリークする可能性があります。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] は、モーダルではない親の <xref:System.Windows.Forms.Form> が閉じると、<xref:System.Windows.Forms.Integration.ElementHost> コントロールを破棄します。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、アプリケーションがシャットダウンすると <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を破棄します。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のメッセージ ループ内の <xref:System.Windows.Window> で <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を表示する場合があります。  この場合は、アプリケーションがシャットダウンしているという通知をコードが受け取らない可能性があります。  
+  
+<a name="enabling_visual_styles"></a>   
+## visual スタイルの有効化  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールで [!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] の視覚スタイルが有効にならない場合があります。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーションのテンプレートでは、<xref:System.Windows.Forms.Application.EnableVisualStyles%2A?displayProperty=fullName> メソッドが呼び出されます。  この方法は既定で名前はされず、プロジェクトを作成する場合は [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] を使用すると Comctl32.dll Version 6.0 が使用可能な場合は、[!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] にコントロールの外観を取得します。処理がスレッドで作成する前に <xref:System.Windows.Forms.Application.EnableVisualStyles%2A> 方法を追加する必要があります。  詳細については、「[方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md)」を参照してください。  
+  
+<a name="licensed_controls"></a>   
+## ライセンスされたコントロール  
+ メッセージ ボックスでライセンス情報を表示するライセンスされた [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、ハイブリッド アプリケーションでは予期しない動作を示す場合があります。  ライセンスされたコントロールの中には、ハンドルの作成に対してダイアログ ボックスを表示するものがあります。  たとえば、ライセンスされたコントロールは、ライセンスが必要なことや、コントロールの残りの試用ライセンスが 3 つであることなどを、ユーザーに通知する場合があります。  
+  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は <xref:System.Windows.Interop.HwndHost> クラスから派生し、子コントロールのハンドルは <xref:System.Windows.Forms.Integration.WindowsFormsHost.BuildWindowCore%2A> メソッドの内部で作成されます。  <xref:System.Windows.Interop.HwndHost> クラスは <xref:System.Windows.Forms.Integration.WindowsFormsHost.BuildWindowCore%2A> メソッドでのメッセージの処理を許可しませんが、ダイアログ ボックスを表示するとメッセージが送信されます。  このライセンス シナリオを有効にするには、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の子としてコントロールを割り当てる前に、コントロールで <xref:System.Windows.Forms.Control.CreateControl%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+<a name="wpf_designer"></a>   
+## WPF デザイナー  
+ WPF コンテンツは、[!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] を使用してデザインできます。  以下では、[!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]でハイブリッド アプリケーションを作成するときに発生する可能性のある一般的な問題について説明します。  
+  
+### デザイン時に無視される BackColorTransparent  
+ <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> プロパティは、デザイン時には意図したとおりに動作しない場合があります。  
+  
+ WPF コントロールが表示される親の上にない場合、WPF ランタイムは <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> の値を無視します。  <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> が無視されることがあるのは、<xref:System.Windows.Forms.Integration.ElementHost> オブジェクトが異なる <xref:System.AppDomain> 内に作成されるためです。  ただし、アプリケーションの実行時には、<xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> は意図したとおりに動作します。  
+  
+### obj フォルダーが削除されると表示されるデザイン時エラー一覧  
+ obj フォルダーが削除されると、デザイン時エラー一覧が表示されます。  
+  
+ <xref:System.Windows.Forms.Integration.ElementHost> を使用してデザインを行うとき、Windows フォーム デザイナーは、プロジェクトの obj フォルダー内の Debug フォルダーまたは Release フォルダーに生成されるファイルを使用します。  これらのファイルを削除すると、デザイン時エラー一覧が表示されます。  この問題を解決するには、プロジェクトをリビルドします。  詳細については、「[Windows フォーム デザイナーでのデザイン時エラー](../../../../docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md)」を参照してください。  
+  
+<a name="elementhost_and_ime"></a>   
+## ElementHost と IME  
+ <xref:System.Windows.Forms.Integration.ElementHost> でホストされる WPF コントロールは、現在、<xref:System.Windows.Forms.Control.ImeMode%2A> プロパティをサポートしていません。  <xref:System.Windows.Forms.Control.ImeMode%2A> を変更しても、ホストされているコントロールでは無視されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナーの相互運用性](http://msdn.microsoft.com/ja-jp/2cb7c1ca-2a75-463b-8801-fba81e2b7042)   
+ [Windows フォームと WPF の相互運用性入力アーキテクチャ](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-interoperability-input-architecture.md)   
+ [方法 : ハイブリッド アプリケーションで視覚スタイルを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-visual-styles-in-a-hybrid-application.md)   
+ [WindowsFormsHost 要素のレイアウトに関する考慮事項](../../../../docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md)   
+ [Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)   
+ [Windows フォーム デザイナーでのデザイン時エラー](../../../../docs/framework/winforms/controls/design-time-errors-in-the-windows-forms-designer.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/typeconverters-and-xaml.md b/docs/framework/wpf/advanced/typeconverters-and-xaml.md
new file mode 100644
index 00000000000..d71101bb82f
--- /dev/null
+++ b/docs/framework/wpf/advanced/typeconverters-and-xaml.md
@@ -0,0 +1,130 @@
+---
+title: "TypeConverters および XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, TypeConverter"
+  - "TypeConverter クラス"
+  - "XAML, TypeConverter クラス"
+ms.assetid: f6313e4d-e89d-497d-ac87-b43511a1ae4b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# TypeConverters および XAML
+ここでは、XAML 言語の一般的な機能である文字列からの型変換の目的について説明します。  .NET Framework において、<xref:System.ComponentModel.TypeConverter> クラスは、XAML の属性でプロパティ値として使用できるカスタムのマネージ クラスの実装の一部として、特別な役割を果たします。  カスタム クラスを作成し、そのクラスのインスタンスを XAML の設定できる属性値として使用できるようにするには、そのクラスに <xref:System.ComponentModel.TypeConverterAttribute> を適用するか、カスタムの <xref:System.ComponentModel.TypeConverter> クラスを作成するかのいずれか、または両方を行う必要があります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## 型変換の概念  
+  
+### XAML と文字列値  
+ XAML ファイルで属性値を設定するとき、その値の初期型はピュア テキストの文字列です。  <xref:System.Double> などの他のプリミティブ型であっても、XAML プロセッサにとっては最初はテキスト文字列です。  
+  
+ 属性値を処理するために、XAML プロセッサは 2 つの情報を必要とします。  第 1 の情報は、設定するプロパティの値型です。  属性値を定義し、XAML で処理される文字列値はすべて、最終的にその型の値に変換 \(解決\) される必要があります。  その値が XAML パーサーで認識されるプリミティブ \(数値など\) である場合は、文字列の直接的な変換が試みられます。  値が列挙体の場合は、文字列を使用して、その列挙体で一致する名前付き定数がチェックされます。  値がパーサーで認識されるプリミティブでも列挙体でもない場合、その値の型は、変換される文字列に基づいて、型のインスタンス \(値\) も提供できるようにする必要があります。  これは、型コンバーター クラスを指定することによって行われます。  型コンバーターは、XAML で使用する場合や、.NET コードでコード呼び出しを行う場合には、実質的に他のクラスの値を生成するためのヘルパー クラスとして機能します。  
+  
+### XAML における既存の型変換動作の使用  
+ XAML の基礎概念に対する開発者の理解度によっては、基本的なアプリケーション XAML で気付かないうちに既に型変換動作を使用している場合もあります。  たとえば、WPF では、<xref:System.Windows.Point> 型の値を格納するプロパティが、文字どおり数百種類も定義されています。  <xref:System.Windows.Point> は、2 次元の座標空間における座標を表す値で、実際に <xref:System.Windows.Point.X%2A> および <xref:System.Windows.Point.Y%2A> という 2 つの重要なプロパティだけが定義されています。  XAML でポイントを指定するときは、指定する <xref:System.Windows.Point.X%2A> 値と <xref:System.Windows.Point.Y%2A> 値の間に区切り文字 \(通常はコンマ\) を挿入した文字列として指定します。  たとえば、`<LinearGradientBrush StartPoint="0,0" EndPoint="1,1">` のように指定します。  
+  
+ <xref:System.Windows.Point> のように単純な型は、XAML における使用方法も簡単ですが、このような場合でも型コンバーターが使用されます。  この場合、型コンバーターは <xref:System.Windows.PointConverter> クラスです。  
+  
+ <xref:System.Windows.Point> の型コンバーターはクラス レベルで定義されているため、<xref:System.Windows.Point> を格納するプロパティは、すべて簡単なマークアップ形式で指定できます。  型コンバーターが定義されていない場合、前に示した例では、次のように非常に複雑なマークアップが必要となります。  
+  
+ `<LinearGradientBrush>`  
+  
+ `<LinearGradientBrush.StartPoint>`  
+  
+ `<Point X="0" Y="0"/>`  
+  
+ `</LinearGradientBrush.StartPoint>`  
+  
+ `<LinearGradientBrush.EndPoint>`  
+  
+ `<Point X="1" Y="1"/>`  
+  
+ `</LinearGradientBrush.EndPoint>`  
+  
+ `<LinearGradientBrush>`  
+  
+ 型変換文字列と、より複雑な同等の構文のどちらを使用するかは、多くの場合、コーディングのスタイルによって異なります。  また、XAML ツールのワークフローも、値の設定方法に影響する場合があります。  一部の XAML ツールは、非常に複雑な形式のマークアップを作成する傾向があります。これは、デザイナー ビューまたはそのシリアル化メカニズムへのラウンド トリップが簡単なためです。  
+  
+ WPF 型および .NET Framework 型の既存の型コンバーターの検出は、通常、クラス \(またはプロパティ\) に <xref:System.ComponentModel.TypeConverterAttribute> が適用されているかどうかを調べることによって行われます。  この属性は、XAML やその他の目的で型を使用するときのために、その型の値に対応するサポートされている型コンバーターを表すクラスを指定します。  
+  
+### 型コンバーターとマークアップ拡張機能  
+ マークアップ拡張機能と型コンバーターは、XAML プロセッサの動作とこれらが適用されるシナリオの観点で直交的な役割を果たします。  マークアップ拡張機能の使用時にはコンテキストを利用できますが、マークアップ拡張機能が値を提供するプロパティの型変換動作は一般にマークアップ拡張機能の実装ではチェックされません。  つまり、マークアップ拡張機能が `ProvideValue` 出力としてテキスト文字列を返す場合でも、特定のプロパティまたはプロパティの値型に適用される、対象の文字列に対する型変換動作は呼び出されません。一般に、マークアップ拡張機能の目的は、型コンバーターを呼び出すことなく、文字列を処理し、オブジェクトを返すことです。  
+  
+ 型コンバーターではなくマークアップ拡張機能が必要となる典型的な状況の 1 つとして、既存のオブジェクトへの参照が挙げられます。  状態非依存の型コンバーターは、必要とは限らない新しいインスタンスを生成するだけです。  マークアップ拡張機能の詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+### ネイティブな型コンバーター  
+ XAML パーサーの WPF および .NET Framework 実装には、ネイティブな型変換処理を定義しているが、従来ならばプリミティブ型として扱うことができなかった型があります。  このような型の例として、<xref:System.DateTime> が挙げられます。  その理由は、.NET Framework アーキテクチャがどのように機能するかに基づいています。<xref:System.DateTime> 型は、.NET の最も基本的なライブラリである mscorlib で定義されています。  <xref:System.DateTime> の属性は、依存関係を伴う他のアセンブリの属性では指定できないため \(<xref:System.ComponentModel.TypeConverterAttribute> は System の属性\)、属性を使用した通常の型コンバーター検出機構は使用できません。  代わりに、このようなネイティブな処理が必要な型の一覧が XAML パーサーに用意されており、XAML パーサーは、これらの型を通常のプリミティブ型と同様の方法で処理します。  <xref:System.DateTime> の場合、これは <xref:System.DateTime.Parse%2A> への呼び出しに相当します。  
+  
+<a name="Implementing_a_Type_Converter"></a>   
+## 型コンバーターの実装  
+  
+### TypeConverter  
+ 前に示した <xref:System.Windows.Point> の例で、<xref:System.Windows.PointConverter> というクラスについて触れました。  XAML の .NET 実装では、XAML で使用されるすべての型コンバーターは、<xref:System.ComponentModel.TypeConverter> 基本クラスからの派生クラスです。  <xref:System.ComponentModel.TypeConverter> クラスは、XAML が登場する前のバージョンの .NET Framework にもありました。このクラスの元来の目的の 1 つは、ビジュアルなデザイナーでプロパティ ダイアログの文字列変換を行うことでした。  XAML では、<xref:System.ComponentModel.TypeConverter> の役割が拡張され、文字列への変換と文字列からの変換のための基本クラスとなりました。これにより、文字列の属性値を解析することや、特定のオブジェクト プロパティの実行時の値を文字列に再変換して、属性としてシリアル化することができるようになっています。  
+  
+ <xref:System.ComponentModel.TypeConverter> には、XAML の処理を目的とした文字列の変換に関係する、次の 4 つのメンバーが定義されています。  
+  
+-   <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.ConvertTo%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A>  
+  
+ これらのうち、最も重要なメソッドは <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> です。  このメソッドは、入力文字列を必要なオブジェクト型に変換します。  厳密に言うと、<xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> メソッドは、より多くの型をコンバーターの目的の型に変換するように実装することができるため、XAML 以外の目的 \(実行時の変換に対するサポートなど\) にも使用できます。ただし、XAML では、対象となる <xref:System.String> 入力を処理するためのコード パスにすぎません。  
+  
+ 次に重要なメソッドは <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> です。  アプリケーションをマークアップ表現に変換する場合 \(アプリケーションを XAML にファイルとして保存する場合など\)、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> は、マークアップ表現の生成を行います。  この場合、XAML に関係するコード パスは、<xref:System.String> の `destinationType` を渡すときです。  
+  
+ <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> と <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A> は、<xref:System.ComponentModel.TypeConverter> 実装の機能をサービスが照会するときに使用されるサポート メソッドです。  これらのメソッドは、コンバーターの対応する変換メソッドが、型固有の状況をサポートしている場合に、`true` を返すように実装する必要があります。  XAML では、通常、<xref:System.String> 型について true が返されます。  
+  
+### カルチャ情報と XAML の型コンバーター  
+ 各 <xref:System.ComponentModel.TypeConverter> の実装には、変換に有効な文字列の構成内容に関する独自の解釈を含めることができます。また、パラメーターとして渡された型説明を使用したり無視したりすることもできます。  カルチャと XAML の型変換については、重要な考慮事項があります。  XAML では、ローカライズできる文字列を属性値として全面的に使用できます。  ただし、そのローカライズできる文字列を、特定のカルチャ要件と共に型コンバーターの入力として使用することはできません。これは、XAML 属性値の型コンバーターには、必ず特定の言語の解析動作 \(`en-US` カルチャを使用\) が組み込まれているためです。  この制限に関する設計上の理由の詳細については、XAML 言語仕様  \(「[\[MS\-XAML \(MS\-XAML\)\]](http://go.microsoft.com/fwlink/?LinkId=114525)」\) を参照してください。  
+  
+ カルチャが問題となる例として、一部のカルチャで数値の小数点記号にコンマが使用されていることが挙げられます。  これは、多くの WPF XAML 型コンバーターで定義されているコンマを区切り文字として使用する動作 \(一般的な "X,Y" 形式やコンマ区切りリストなど従来の慣習を基準とした動作\) と重複します。  周囲の XAML でカルチャを指定しても \(`Language` または `xml:lang` を、コンマを小数点記号として使用するカルチャの 1 つである `sl-SI` に設定しても\)、問題は解決しません。  
+  
+### ConvertFrom の実装  
+ XAML をサポートする <xref:System.ComponentModel.TypeConverter> の実装としてコンバーターを使用できるようにするためには、そのコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> メソッドが、`value` パラメーターとして文字列を受け入れる必要があります。  文字列が有効な形式であり、<xref:System.ComponentModel.TypeConverter> 実装で変換できる場合、返されるオブジェクトは、プロパティで予想される型へのキャストをサポートしている必要があります。  それ以外の場合は、<xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> 実装は `null` を返す必要があります。  
+  
+ 各 <xref:System.ComponentModel.TypeConverter> の実装には、変換に有効な文字列の構成内容に関する独自の解釈を含めることができます。また、パラメーターとして渡された型説明やカルチャ情報を使用したり無視したりすることもできます。  ただし、WPF XAML 処理が、値を型説明コンテキストに渡さない場合があり、`xml:lang` に基づくカルチャを渡さない場合もあります。  
+  
+> [!NOTE]
+>  文字列の書式の要素として、中かっこ文字、特に { は使用しないでください。  これらの文字は、マークアップ拡張シーケンスの開始および終了を示す文字として予約されています。  
+  
+### ConvertTo の実装  
+ <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> はシリアル化のサポートで使用される場合があります。  <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> を使用したカスタム型およびその型コンバーターのシリアル化のサポートは、絶対要件ではありません。  ただし、コントロールを実装する場合、またはクラスの機能または設計の一部としてシリアル化を使用する場合は、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> を実装する必要があります。  
+  
+ XAML をサポートする <xref:System.ComponentModel.TypeConverter> の実装としてコンバーターを使用できるようにするためには、そのコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> メソッドが、`value` パラメーターとして、サポートされる型のインスタンス \(または値\) を受け入れる必要があります。  `destinationType` パラメーターが <xref:System.String> 型の場合は、返されるオブジェクトは <xref:System.String> にキャストできる必要があります。  返される文字列は、`value` のシリアル化された値を表す必要があります。  理想的には、選択するシリアル化形式は、その文字列が同じコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> の実装に渡された場合に、情報の大きな損失が発生することなく、同じ値を生成できる必要があります。  
+  
+ 値をシリアル化できない場合、またはコンバーターがシリアル化をサポートしていない場合は、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> の実装は `null` を返す必要があり、この場合に例外をスローすることもできます。  ただし、例外をスローする場合は、<xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> の実装の一部として変換を使用できないことを示すことにより、事前に <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> を確認して例外の発生を回避するというベスト プラクティスに対応する必要があります。  
+  
+ `destinationType` パラメーターが <xref:System.String> 型でない場合は、独自のコンバーターの処理を選択できます。  通常は、基本実装の処理 \(基本の <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> では特定の例外が発生する\) に戻ることになります。  
+  
+### CanConvertTo の実装  
+ <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> の実装は、`destinationType` が <xref:System.String> 型の場合には `true` を返し、それ以外の場合は基本実装に任せるようにする必要があります。  
+  
+### CanConvertFrom の実装  
+ <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A> の実装は、<xref:System.String> 型の `sourceType` に対しては `true` を返し、それ以外の場合は基本実装に任せます。  
+  
+<a name="Applying_the_TypeConverterAttribute"></a>   
+## TypeConverterAttribute の適用  
+ カスタムの型コンバーターがカスタム クラス用の型コンバーターとして XAML プロセッサで実際に使用されるようにするには、[!INCLUDE[TLA#tla_netframewkattr](../../../../includes/tlasharptla-netframewkattr-md.md)] <xref:System.ComponentModel.TypeConverterAttribute> をクラス定義に適用する必要があります。  属性で指定する <xref:System.ComponentModel.TypeConverterAttribute.ConverterTypeName%2A> は、カスタム型コンバーターの型名である必要があります。  この属性を適用すると、プロパティの型としてカスタム クラス型が使用される場合に、XAML プロセッサが値を処理する際、入力文字列を処理して、オブジェクト インスタンスを返すことができます。  
+  
+ また、プロパティごとに型コンバーターを提供することもできます。  クラス定義に [!INCLUDE[TLA#tla_netframewkattr](../../../../includes/tlasharptla-netframewkattr-md.md)] <xref:System.ComponentModel.TypeConverterAttribute> を適用する代わりに、プロパティ定義 \(メイン定義内の `get`\/`set` 実装ではなくメイン定義自体\) に適用します。  プロパティの型は、カスタム型コンバーターによって処理される型と一致する必要があります。  この属性を適用すると、そのプロパティの値を XAML プロセッサが処理する際に、入力文字列を処理して、オブジェクト インスタンスを返すことができます。  プロパティごとの型コンバーターは、[!INCLUDE[TLA#tla_netframewk](../../../../includes/tlasharptla-netframewk-md.md)] のプロパティ型を使用する場合、またはクラス定義を制御できず、<xref:System.ComponentModel.TypeConverterAttribute> を適用できない他のライブラリのプロパティ型を使用する場合に、特に役立ちます。  
+  
+## 参照  
+ <xref:System.ComponentModel.TypeConverter>   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/typography-how-to-topics.md b/docs/framework/wpf/advanced/typography-how-to-topics.md
new file mode 100644
index 00000000000..0cde35db558
--- /dev/null
+++ b/docs/framework/wpf/advanced/typography-how-to-topics.md
@@ -0,0 +1,40 @@
+---
+title: "文字体裁に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "タイポグラフィ, 方法トピック"
+ms.assetid: 82d50325-7cb2-4975-aea3-027c00e6bbfc
+caps.latest.revision: 90
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 90
+---
+# 文字体裁に関する「方法」トピック
+このセクションのトピックでは、アプリケーションで多彩なテキスト表示を実現するための [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] によるサポートについて説明します。  
+  
+## このセクションの内容  
+ [文字の装飾を作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-text-decoration.md)  
+ [ハイパーリンクに下線を引くかどうかを指定する](../../../../docs/framework/wpf/advanced/how-to-specify-whether-a-hyperlink-is-underlined.md)  
+ [テキストに変換を適用する](../../../../docs/framework/wpf/advanced/how-to-apply-transforms-to-text.md)  
+ [アニメーションをテキストに適用する](../../../../docs/framework/wpf/advanced/how-to-apply-animations-to-text.md)  
+ [影付きテキストを作成する](../../../../docs/framework/wpf/advanced/how-to-create-text-with-a-shadow.md)  
+ [中抜きの文字列を作成する](../../../../docs/framework/wpf/advanced/how-to-create-outlined-text.md)  
+ [コントロールの背景にテキストを描画する](../../../../docs/framework/wpf/advanced/how-to-draw-text-to-a-control-background.md)  
+ [ビジュアルにテキストを描画する](../../../../docs/framework/wpf/advanced/how-to-draw-text-to-a-visual.md)  
+ [XAML で特殊文字を使用する](../../../../docs/framework/wpf/advanced/how-to-use-special-characters-in-xaml.md)  
+  
+## 参照  
+ <xref:System.Windows.Documents.Typography>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/typography-in-wpf.md b/docs/framework/wpf/advanced/typography-in-wpf.md
new file mode 100644
index 00000000000..fb9b22bf9f8
--- /dev/null
+++ b/docs/framework/wpf/advanced/typography-in-wpf.md
@@ -0,0 +1,185 @@
+---
+title: "WPF のタイポグラフィ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タイポグラフィ, タイポグラフィの概要"
+ms.assetid: 06cbf17b-6eff-4fe5-949d-2dd533e4e1f4
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# WPF のタイポグラフィ
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の主要な文字体裁の機能について説明します。  これらの機能には、テキスト レンダリングの品質とパフォーマンスの向上、[!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントのサポート、各国対応テキストの強化、フォントのサポートの強化、新しいテキスト API \(アプリケーション プログラミング インターフェイス\) が含まれます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Improved_Quality_and_Performance_of_Text"></a>   
+## テキストの品質およびパフォーマンスの向上  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のテキストは、テキストのわかりやすさと読みやすさを高める [!INCLUDE[TLA#tla_ct](../../../../includes/tlasharptla-ct-md.md)] を使用して描画されます。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、ラップトップや Pocket PC の画面、フラット パネル モニターなど、既存の LCD \(液晶ディスプレイ\) でのテキストの読みやすさを向上させるために [!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] が開発したソフトウェア テクノロジです。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] は、ピクセルの画素レベルで文字を表示調整することで実際の形状を忠実に再現したテキストを表示できる、サブピクセル レンダリングを採用しています。  解像度が上がるとテキスト表示の微細部のシャープさが向上するため、長時間にわたって読んでも苦になりません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] での [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] のもう 1 つの改良点は、y 方向のアンチエイリアシングです。これにより、テキスト文字の緩やかな曲線部の上下が滑らかになります。  [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] の機能の詳細については、「[ClearType の概要](../../../../docs/framework/wpf/advanced/cleartype-overview.md)」を参照してください。  
+  
+ ![ClearType y 方向アンチエイリアシングを含むテキスト](../../../../docs/framework/wpf/advanced/media/typographyinwpf02.png "TypographyInWPF02")  
+ClearType の y 方向アンチエイリアシングを適用したテキスト  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、コンピューターがハードウェアの最小要件を満たしている限り、テキスト レンダリング パイプライン全体をハードウェアによって加速できます。  ハードウェアを使用して実行できないレンダリングは、ソフトウェア レンダリングとなります。  ハードウェアによる加速は、個々のグリフの格納から始まり、グリフ実行への複数のグリフの合成、効果の適用、最終的な表示出力への [!INCLUDE[TLA2#tla_ct](../../../../includes/tla2sharptla-ct-md.md)] ブレンディング アルゴリズムの適用まで、テキスト レンダリング パイプラインのすべてのフェーズに影響します。  ハードウェアによる加速の詳細については、「[グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)」を参照してください。  
+  
+ ![パイプラインを描画するテキストのダイアグラム](../../../../docs/framework/wpf/advanced/media/typographyinwpf01.png "TypographyInWPF01")  
+パイプ ラインをレンダリングするテキスト図  
+  
+ また、アニメーション化されたテキストは、文字とグリフのいずれによる場合でも、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で有効化されているグラフィックス ハードウェア機能をすべて利用することができます。  これにより、テキスト アニメーションが滑らかになります。  
+  
+<a name="Rich_Typography"></a>   
+## 多彩な文字体裁  
+ [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォント形式は、[!INCLUDE[TLA#tla_truetype](../../../../includes/tlasharptla-truetype-md.md)] フォント形式の拡張です。  [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォント形式は、[!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] と Adobe が共同で開発したもので、高度な文字体裁機能を豊富に備えています。  <xref:System.Windows.Documents.Typography> オブジェクトは、スタイル上の代替文字や巻きひげ文字など、[!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォントの高度な機能の多くを公開します。  [!INCLUDE[TLA2#tla_lhsdk](../../../../includes/tla2sharptla-lhsdk-md.md)] には、Pericles フォントや Pescadero フォントなど、豊富な機能を持つ [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォント サンプルが用意されています。  詳細については、「[OpenType フォント パックのサンプル](../../../../docs/framework/wpf/advanced/sample-opentype-font-pack.md)」を参照してください。  
+  
+ Pericles [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] フォントには、標準グリフ セットにスタイル上の代替を提供する追加グリフが含まれています。  次のテキストでは、スタイル上の代替グリフが表示されています。  
+  
+ ![OpenType のスタイル代替グリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont02.png "opentypefont02")  
+OpenType 代替スタイル グリフを使用するテキスト  
+  
+ 巻きひげは装飾的なグリフで、カリグラフィを連想させることがよくある、手の込んだ装飾が使用されます。  次のテキストは、Pescadero フォントの標準グリフと巻きひげグリフを示したものです。  
+  
+ ![OpenType の標準グリフと飾り付きグリフを使用するテキスト](../../../../docs/framework/wpf/advanced/media/opentypefont08.png "opentypefont08")  
+OpenType 標準グリフおよび巻き髭グリフを使用するテキスト  
+  
+ [!INCLUDE[TLA2#tla_opentype](../../../../includes/tla2sharptla-opentype-md.md)] の機能の詳細については、「[OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)」を参照してください。  
+  
+<a name="Enhanced_International_Text_Support"></a>   
+## 各国対応テキストのサポートの強化  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、次の機能を提供することで、各国対応テキストのサポートを強化しています。  
+  
+-   すべての書記体系における、適用可能な単位を使用した自動行間隔設定。  
+  
+-   各国対応テキストの幅広いサポート。  詳細については、「[WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)」を参照してください。  
+  
+-   言語に合わせた改行、ハイフネーション、および両端揃え。  
+  
+<a name="Enhanced_Font_Support"></a>   
+## フォントのサポートの強化  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、次の機能を提供することで、フォントのサポートを強化しています。  
+  
+-   すべてのテキストに対応する Unicode。  フォントの動作や選択に文字セットやコードページが不要になりました。  
+  
+-   システム ロケールなど、グローバル設定に左右されないフォント動作。  
+  
+-   <xref:System.Windows.Media.FontFamily> を定義するための個別の <xref:System.Windows.FontWeight>、 <xref:System.Windows.FontStretch>、および <xref:System.Windows.FontStyle> 型。  これにより、斜体および太字のブール値の組み合わせでフォント ファミリを定義する [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] プログラミングよりも優れた柔軟性が提供されます。  
+  
+-   フォント名とは関係なく処理される書き込み方向 \(横書きまたは縦書き\)。  
+  
+-   複合フォント技術を使用した、移植可能な [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] ファイルにおけるフォント リンクとフォントの代替。  複合フォントは、完全な多言語フォントの構築を可能にします。  また、複合フォントは、欠落グリフの表示を防ぐ機能も備えています。  詳細については、<xref:System.Windows.Media.FontFamily> クラスの「解説」を参照してください。  
+  
+-   単一言語フォントのグループを使用した、複合フォントから構築される各国対応フォント。  これにより、複数言語に対応するフォントの開発時にリソースのコストを節約できます。  
+  
+-   ドキュメントに埋め込まれ、ドキュメントに移植性を提供する複合フォント。  詳細については、<xref:System.Windows.Media.FontFamily> クラスの「解説」を参照してください。  
+  
+<a name="New_Text_APIs"></a>   
+## 新しいテキスト API \(アプリケーション プログラミング インターフェイス\)  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、開発者がアプリケーションにテキストを含めるときに使用できるいくつかのテキスト [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を提供します。  これらの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、次の 3 つのカテゴリにグループ化されます。  
+  
+-   **レイアウトとユーザー インターフェイス** :   [!INCLUDE[TLA#tla_gui](../../../../includes/tlasharptla-gui-md.md)] に対応した一般的なテキスト コントロールです。  
+  
+-   **軽量テキスト描画** :   オブジェクトにテキストを直接描画することができます。  
+  
+-   **テキストの高度な書式設定** :   カスタム テキスト エンジンを実装することができます。  
+  
+### レイアウトとユーザー インターフェイス  
+ テキスト [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] は、最上位の機能レベルにおいて、<xref:System.Windows.Controls.Label>、<xref:System.Windows.Controls.TextBlock>、<xref:System.Windows.Controls.TextBox> などの [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] コントロールを提供します。  これらのコントロールは、アプリケーション内に基本的な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を提供し、テキストの表示や操作を簡単に実行できるようにします。  <xref:System.Windows.Controls.RichTextBox> や <xref:System.Windows.Controls.PasswordBox> などのコントロールを使用すると、より高度で特殊なテキスト処理が可能になります。  <xref:System.Windows.Documents.TextRange>、<xref:System.Windows.Documents.TextSelection>、<xref:System.Windows.Documents.TextPointer> などのクラスにより、便利なテキスト操作を実行できます。  これらの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] コントロールには、<xref:System.Windows.Controls.Control.FontFamily%2A>、<xref:System.Windows.Controls.Control.FontSize%2A>、<xref:System.Windows.Controls.Control.FontStyle%2A> などのプロパティがあり、テキストの描画に使用するフォントを制御できます。  
+  
+#### ビットマップ効果、変換、およびテキスト効果の使用  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ビットマップ効果、変換、テキスト効果などの機能を利用して、人の目をひきつけるテキストを作成できます。  テキストに標準タイプのドロップ シャドウ効果を適用した例を次に示します。  
+  
+ ![ぼかし &#61; 0.25 のテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext01.png "ShadowText01")  
+ドロップ シャドウが適用されたテキスト  
+  
+ テキストにドロップ シャドウ効果とノイズを適用した例を次に示します。  
+  
+ ![ノイズを含むテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext04.png "ShadowText04")  
+ドロップ シャドウとノイズが適用されたテキスト  
+  
+ テキストの外縁にグロー効果を適用した例を次に示します。  
+  
+ ![OuterGlowBitmapEffect を使用するテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext05.png "ShadowText05")  
+外縁にグロー効果が適用されたテキスト  
+  
+ テキストにぼかし効果が適用されている例を次に示します。  
+  
+ ![BlurBitmapEffect を使用するテキスト シャドウ](../../../../docs/framework/wpf/advanced/media/shadowtext06.png "ShadowText06")  
+ぼかし効果が適用されたテキスト  
+  
+ テキストの 2 行目を x 軸に沿って 150% 拡大し、3 行目を y 軸に沿って 150% 拡大した例を次に示します。  
+  
+ ![ScaleTransform を使用してスケールされたテキスト](../../../../docs/framework/wpf/advanced/media/transformedtext02.png "TransformedText02")  
+ScaleTransform を使用したテキスト  
+  
+ x 軸に沿って傾斜させたテキストの例を次に示します。  
+  
+ ![SkewTransform を使用して傾斜させたテキスト](../../../../docs/framework/wpf/advanced/media/transformedtext03.png "TransformedText03")  
+SkewTransform を使用したテキスト  
+  
+ <xref:System.Windows.Media.TextEffect> オブジェクトは、テキスト文字列内の 1 つ以上の文字列のグループとしてテキストを処理できるヘルパー オブジェクトです。  次の例は、回転する個々の文字を示しています。  各文字は、1 秒間隔で個別に回転します。  
+  
+ ![テキストを回転するテキスト効果のスクリーンショット](../../../../docs/framework/wpf/advanced/media/texteffect01.png "TextEffect01")  
+回転するテキスト効果アニメーションの例  
+  
+#### フロー ドキュメントの使用  
+ 一般的な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] コントロールに加えて、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、テキスト表示に使用するレイアウト コントロール \(<xref:System.Windows.Documents.FlowDocument> 要素\) があります。  <xref:System.Windows.Documents.FlowDocument> 要素を <xref:System.Windows.Controls.DocumentViewer> 要素と組み合わせると、さまざまなレイアウト要件を持つ大量のテキストに対応するコントロールを作成できます。  レイアウト コントロールは、<xref:System.Windows.Documents.Typography> オブジェクト、および他の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] コントロールのフォント関連プロパティを通じて、高度なタイポグラフィへのアクセスを実現します。  
+  
+ 検索、ナビゲーション、改ページ位置の自動修正、コンテンツ スケーリングをサポートする <xref:System.Windows.Controls.FlowDocumentReader> でホストされているテキスト コンテンツを次の例に示します。  
+  
+ ![OpenType フォント サンプルの使用のスクリーンショット](../../../../docs/framework/wpf/advanced/media/typographyinwpf-03.png "TypographyInWPF\_03")  
+FlowDocumentReader でホストされるテキスト  
+  
+ 詳細については、「[WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)」を参照してください。  
+  
+### 軽量テキスト描画  
+ <xref:System.Windows.Media.DrawingContext> オブジェクトの <xref:System.Windows.Media.DrawingContext.DrawText%2A> メソッドを使用すると、テキストを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] オブジェクトに直接描画できます。  このメソッドを使用するには、<xref:System.Windows.Media.FormattedText> オブジェクトを作成します。  このオブジェクトを使用すると、複数行のテキストを描画できます。このテキストでは、テキスト内の各文字を個々に書式設定できます。  <xref:System.Windows.Media.FormattedText> オブジェクトの機能には、Win32 API の DrawText フラグの多くの機能が含まれています。  また、<xref:System.Windows.Media.FormattedText> オブジェクトには、テキストがその境界を越えたときに省略記号を表示する、省略記号のサポートなどの機能も備えています。  いくつかの書式を適用したテキストを次の例に示します。たとえば、2 番目および 3 番目の単語には線形グラデーションが適用されています。  
+  
+ ![FormattedText オブジェクトを使用して表示されるテキスト](../../../../docs/framework/wpf/advanced/media/formattedtext01.png "FormattedText01")  
+FormattedText オブジェクトを使用して表示したテキスト  
+  
+ 書式設定したテキストを <xref:System.Windows.Media.Geometry> オブジェクトに変換し、人の目をひきつける他の種類のテキストを作成することができます。  たとえば、テキスト文字列のアウトラインに基づいて <xref:System.Windows.Media.Geometry> オブジェクトを作成できます。  
+  
+ ![線形グラデーション ブラシを使用するテキスト アウトライン](../../../../docs/framework/wpf/advanced/media/outlinedtext02.png "OutlinedText02")  
+線形グラデーション ブラシを使用したテキスト アウトライン  
+  
+ 変換されたテキストのストローク、塗りつぶし、および強調表示を変更して、人の目をひく視覚効果を作成するいくつかの方法を次の例に示します。  
+  
+ ![塗りつぶしとストロークに別の色を使用するテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext03.png "OutlinedText03")  
+ストロークおよび塗りつぶしを別々の色に設定した例  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext04.png "OutlinedText04")  
+ストロークに適用したイメージ ブラシの例  
+  
+ ![ストロークに適用されるイメージ ブラシを含むテキスト](../../../../docs/framework/wpf/advanced/media/outlinedtext05.png "OutlinedText05")  
+ストロークおよび強調表示に適用したイメージ ブラシの例  
+  
+ <xref:System.Windows.Media.FormattedText> オブジェクトの詳細については、「[書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)」を参照してください。  
+  
+### テキストの高度な書式設定  
+ テキスト [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の最も高度なレベルとして、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、<xref:System.Windows.Media.TextFormatting.TextFormatter> オブジェクトおよび <xref:System.Windows.Media.TextFormatting> 名前空間のその他の型を使用して、カスタム テキスト レイアウトを作成する機能が用意されています。  <xref:System.Windows.Media.TextFormatting.TextFormatter> および関連クラスを使用して、カスタム テキスト レイアウトを実装し、文字形式、段落スタイル、改行ルール、および各国対応テキストのその他のレイアウト機能を独自に定義することができます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] テキスト レイアウトのサポートの既定の実装をオーバーライドする必要はほとんどありません。  ただし、テキストを編集するコントロールやアプリケーションを作成する場合は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既定の実装とは異なる実装が必要になることがあります。  
+  
+ 従来のテキスト [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] とは異なり、<xref:System.Windows.Media.TextFormatting.TextFormatter> は一連のコールバック メソッドを使用して、テキスト レイアウト クライアントと対話します。  このテキスト フォーマッタを使用するには、クライアントが <xref:System.Windows.Media.TextFormatting.TextSource> クラスの実装にこれらのメソッドを提供している必要があります。  クライアント アプリケーションと <xref:System.Windows.Media.TextFormatting.TextFormatter> の間のテキスト レイアウトの対話を次の図に示します。  
+  
+ ![テキスト レイアウト クライアントと TextFormatter のダイアグラム](../../../../docs/framework/wpf/advanced/media/textformatter01.png "TextFormatter01")  
+アプリケーションと TextFormatter の対話  
+  
+ カスタム テキス レイアウトの作成の詳細については、「[テキストの高度な書式設定](../../../../docs/framework/wpf/advanced/advanced-text-formatting.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.FormattedText>   
+ <xref:System.Windows.Media.TextFormatting.TextFormatter>   
+ [ClearType の概要](../../../../docs/framework/wpf/advanced/cleartype-overview.md)   
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)   
+ [書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)   
+ [テキストの高度な書式設定](../../../../docs/framework/wpf/advanced/advanced-text-formatting.md)   
+ [テキスト](../../../../docs/framework/wpf/advanced/optimizing-performance-text.md)   
+ [Microsoft Typography \(Microsoft Typography\)](http://www.microsoft.com/typography/default.mspx)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/typography.md b/docs/framework/wpf/advanced/typography.md
new file mode 100644
index 00000000000..fc514e03e68
--- /dev/null
+++ b/docs/framework/wpf/advanced/typography.md
@@ -0,0 +1,42 @@
+---
+title: "タイポグラフィ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "フォント, タイポグラフィ"
+  - "テキスト, タイポグラフィ"
+  - "タイポグラフィ"
+ms.assetid: e4ef38db-b7d1-4bda-87ab-8bb738440ddc
+caps.latest.revision: 60
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 60
+---
+# タイポグラフィ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、多彩なテキスト コンテンツ表示をサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のテキストは、テキストのわかりやすさと読みやすさを高める [!INCLUDE[TLA#tla_ct](../../../../includes/tlasharptla-ct-md.md)] を使用して描画されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、[!INCLUDE[TLA#tla_truetype](../../../../includes/tlasharptla-truetype-md.md)] 書式で定義される機能を超える追加機能を提供する [!INCLUDE[TLA#tla_opentype](../../../../includes/tlasharptla-opentype-md.md)] フォントもサポートします。  
+  
+## このセクションの内容  
+ [WPF のタイポグラフィ](../../../../docs/framework/wpf/advanced/typography-in-wpf.md)  
+ [ClearType の概要](../../../../docs/framework/wpf/advanced/cleartype-overview.md)  
+ [ClearType レジストリの設定](../../../../docs/framework/wpf/advanced/cleartype-registry-settings.md)  
+ [書式設定されたテキストの描画](../../../../docs/framework/wpf/advanced/drawing-formatted-text.md)  
+ [テキストの高度な書式設定](../../../../docs/framework/wpf/advanced/advanced-text-formatting.md)  
+ [フォント](../../../../docs/framework/wpf/advanced/fonts-wpf.md)  
+ [グリフ](../../../../docs/framework/wpf/advanced/glyphs.md)  
+ [方法のトピック](../../../../docs/framework/wpf/advanced/typography-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Documents.Typography>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [OpenType フォントの機能](../../../../docs/framework/wpf/advanced/opentype-font-features.md)   
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/use-automatic-layout-overview.md b/docs/framework/wpf/advanced/use-automatic-layout-overview.md
new file mode 100644
index 00000000000..051a7bf30f6
--- /dev/null
+++ b/docs/framework/wpf/advanced/use-automatic-layout-overview.md
@@ -0,0 +1,103 @@
+---
+title: "自動レイアウトの使用の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "自動レイアウト"
+  - "レイアウト, 自動"
+ms.assetid: 6fed9264-18bb-4d05-8867-1fe356c6f687
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 自動レイアウトの使用の概要
+ここでは、開発者がローカライズ可能な[!INCLUDE[TLA#tla_ui#plural](../../../../includes/tlasharptla-uisharpplural-md.md)] を持つ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションを作成する方法に関するガイドラインについて説明します。  これまで、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のローカライズには時間がかかっていました。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が翻訳された言語をピクセル単位で調整する必要がありました。  現在では、適切な設計およびコーディング標準を使用して [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を構築し、ローカライザーが行う必要があるサイズ変更や位置変更を減らすことができます。  サイズ変更や位置変更がより簡単になるアプリケーション作成方法は、自動レイアウトと呼ばれます。これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション設計を使用して実現できます。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [自動レイアウトを使用する利点](#advantages_of_autolayout)  
+  
+-   [自動レイアウトとコントロール](#autolayout_controls)  
+  
+-   [自動レイアウトとコーディング標準](#autolayout_coding)  
+  
+-   [自動レイアウトとグリッド](#autolay_grids)  
+  
+-   [IsSharedSizeScope プロパティを使用した自動レイアウトとグリッド](#autolay_grids_issharedsizescope)  
+  
+-   [関連トピック](#seeAlsoToggle)  
+  
+<a name="advantages_of_autolayout"></a>   
+## 自動レイアウトを使用する利点  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプレゼンテーション システムは強力で柔軟なため、さまざまな言語の要件を満たすように調整できる、アプリケーション要素のレイアウト機能を提供します。  自動レイアウトの利点の一部を次に示します。  
+  
+-   [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] がどの言語でも適切に表示されます。  
+  
+-   テキストの翻訳後にコントロールの位置およびサイズを再調整する必要性が軽減されます。  
+  
+-   ウィンドウ サイズを再調整する必要性が軽減されます。  
+  
+-   [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] レイアウトがどの言語でも適切にレンダリングされます。  
+  
+-   ローカリゼーション作業を文字列の翻訳と同じ程度まで削減できます。  
+  
+<a name="autolayout_controls"></a>   
+## 自動レイアウトとコントロール  
+ 自動レイアウトを使用すると、アプリケーションでコントロールのサイズを自動的に調整できます。  たとえば、文字列が収まる長さにコントロールを変更できます。  この機能により、ローカライザーは文字列を翻訳した後、翻訳したテキストに合わせてコントロールのサイズを変更する必要がなくなりました。  次の例では、英語のコンテンツを含むボタンが作成されます。  
+  
+ [!code-xml[LocalizationBtn_snip#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationBtn_snip/CS/Pane1.xaml#1)]  
+  
+ この例でスペイン語のボタンを作成するには、テキストを変更するだけで済みます。  次に例を示します。  
+  
+ [!code-xml[LocalizationBtn#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationBtn/CS/Pane1.xaml#1)]  
+  
+ コード サンプルによる出力を次の図に示します。  
+  
+ ![テキストの言語が異なる同じボタン](../../../../docs/framework/wpf/advanced/media/globalizationbutton.png "GlobalizationButton")  
+自動サイズ変更可能なボタン  
+  
+<a name="autolayout_coding"></a>   
+## 自動レイアウトとコーディング標準  
+ 自動レイアウト方法を使用するには、完全にローカライズ可能な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成するためのコーディングと設計の標準および規則のセットが必要です。  次のガイドラインは、自動レイアウト コーディングに役立ちます。  
+  
+|コーディング標準|Description|  
+|--------------|-----------------|  
+|絶対位置を使用しない。|-   <xref:System.Windows.Controls.Canvas> は要素を絶対位置に配置するため、使用しないでください。<br />-   コントロールを配置するには、<xref:System.Windows.Controls.DockPanel>、<xref:System.Windows.Controls.StackPanel>、および <xref:System.Windows.Controls.Grid> を使用します。<br />-   さまざまな種類のパネルの詳細については、「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」を参照してください。|  
+|ウィンドウに固定サイズを設定しない。|-   <xref:System.Windows.Window.SizeToContent%2A> を使用します。<br />-   次に例を示します。<br /><br /> [!code-xml[LocalizationGrid#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationGrid/CS/Pane1.xaml#2)]|  
+|<xref:System.Windows.FrameworkElement.FlowDirection%2A> を追加する。|<ul><li>アプリケーションのルート要素に <xref:System.Windows.FrameworkElement.FlowDirection%2A> を追加します。</li><li>[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、横型、縦型、および双方向のレイアウトをサポートするための便利な方法が用意されています。  プレゼンテーション フレームワークで、<xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティを使用してレイアウトを定義できます。  フロー方向のパターンは次のとおりです。<br /><br /> <ul><li><xref:System.Windows.FlowDirection> \(LrTb\): ラテン言語や東アジア言語などの横型レイアウト。</li><li><xref:System.Windows.FlowDirection> \(RlTb\): アラビア語やヘブライ語などの双方向レイアウト。</li></ul></li></ul>|  
+|物理フォントではなく複合フォントを使用する。|<ul><li>複合フォントでは、<xref:System.Windows.Controls.Control.FontFamily%2A> プロパティをローカライズする必要がありません。</li><li>開発者は、次のいずれかのフォントを使用するか、独自のフォントを作成することができます。<br /><br /> <ul><li>Global User Interface</li><li>Global San Serif</li><li>Global Serif</li></ul></li></ul>|  
+|xml:lang を追加する。|-   `xml:lang` 属性を [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のルート要素に追加します \(英語のアプリケーションの場合は `xml:lang="en-US"` など\)。<br />-   複合フォントでは `xml:lang` を使用して使用するフォントが決定されるため、このプロパティを設定して多言語シナリオをサポートします。|  
+  
+<a name="autolay_grids"></a>   
+## 自動レイアウトとグリッド  
+ <xref:System.Windows.Controls.Grid> 要素を使用すると、開発者は要素を配置できるため、自動レイアウトに役立ちます。  <xref:System.Windows.Controls.Grid> コントロールは、列と行の配置を使用して、使用可能なスペースを子要素間で配分できます。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素は複数のセルにまたがることができ、グリッド内にグリッドを配置することもできます。  グリッドを使用すると、複雑な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成および配置できるため便利です。  グリッドを使用してボタンとテキストを配置する方法を次の例に示します。  セルの高さと幅は <xref:System.Windows.GridUnitType> に設定されているため、イメージを持つボタンを含むセルがイメージに合わせて調整されます。  
+  
+ [!code-xml[LocalizationGrid#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationGrid/CS/Pane1.xaml#1)]  
+  
+ 前のコードによって生成されるグリッドを次の図に示します。  
+  
+ ![グリッドの例](../../../../docs/framework/wpf/advanced/media/glob-grid.png "glob\_grid")  
+\[グリッド\]  
+  
+<a name="autolay_grids_issharedsizescope"></a>   
+## IsSharedSizeScope プロパティを使用した自動レイアウトとグリッド  
+ <xref:System.Windows.Controls.Grid> 要素は、ローカライズ可能なアプリケーションでコンテンツに合わせて調整されるコントロールを作成する場合に便利です。  ただし、コンテンツに関係なくコントロールが特定のサイズを維持する必要がある場合もあります。  たとえば、多くの場合、\[OK\]、\[キャンセル\]、および \[参照\] ボタンをコンテンツに合わせてサイズ変更することはありません。  この場合、<xref:System.Windows.Controls.Grid.IsSharedSizeScope%2A?displayProperty=fullName> 添付プロパティを使用して、複数のグリッド要素間で同じサイズ設定を共有すると便利です。  複数の <xref:System.Windows.Controls.Grid> 要素間で列と行のサイズ設定データを共有する方法を次の例に示します。  
+  
+ [!code-xml[gridIssharedsizescopeProp#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml#2)]  
+  
+ **メモ** 完全なコード例については、「[グリッド間でサイズ設定プロパティを共有する](../../../../docs/framework/wpf/controls/how-to-share-sizing-properties-between-grids.md)」を参照してください。  
+  
+## 参照  
+ [WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)   
+ [自動レイアウトを使用してボタンを作成する](../../../../docs/framework/wpf/advanced/how-to-use-automatic-layout-to-create-a-button.md)   
+ [自動レイアウト用のグリッドを使用する](../../../../docs/framework/wpf/advanced/how-to-use-a-grid-for-automatic-layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md b/docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md
new file mode 100644
index 00000000000..5d005c156bf
--- /dev/null
+++ b/docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md
@@ -0,0 +1,56 @@
+---
+title: "Visual Basic と WPF のイベント処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ハンドラー, Visual Basic"
+  - "Visual Basic, イベント ハンドラー"
+ms.assetid: ad4eb9aa-3afc-4a71-8cf6-add3fbea54a1
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Visual Basic と WPF のイベント処理
+[!INCLUDE[TLA#tla_visualbnet](../../../../includes/tlasharptla-visualbnet-md.md)] 言語の場合に限り、言語固有の `Handles` キーワードを使用すると、イベント ハンドラーを、属性に関連付けたり <xref:System.Windows.UIElement.AddHandler%2A> メソッドを使用したりする代わりに、インスタンスに関連付けることができます。  ただし、ハンドラーをインスタンスに関連付ける `Handles` 手法にはいくつかの制限もあります。`Handles` 構文でサポートできない [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント システムの特定の[ルーティング イベント](GTMT)機能が存在するためです。  
+  
+## WPF アプリケーションでの "ハンドル" の使用  
+ `Handles` を使用してインスタンスおよびイベントに接続されるイベント ハンドラーは、すべてインスタンスの部分クラス宣言内で定義される必要があります。これは、要素の属性値を使用して割り当てられるイベント ハンドラーの要件でもあります。  `Handles` は、<xref:System.Windows.FrameworkContentElement.Name%2A> プロパティ値を持つ \(または [x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)が宣言された\) ページの要素に対してのみ指定できます。  これは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の <xref:System.Windows.FrameworkContentElement.Name%2A> によって、`Handles` 構文で必要な *Instance.Event* 参照形式をサポートするために必要なインスタンス参照が作成されるためです。  <xref:System.Windows.FrameworkContentElement.Name%2A> 参照なしで `Handles` に使用できる要素は、部分クラスを定義するルート要素インスタンスだけです。  
+  
+ `Handles` の後の *Instance.Event* 参照をコンマで区切ることによって、1 つのハンドラーを複数の要素に割り当てることができます。  
+  
+ `Handles` を使用して、複数のハンドラーを 1 つの *Instance.Event* 参照に割り当てることができます。  ハンドラーが `Handles` 参照に指定される順序は重要ではありません。同じイベントを処理するハンドラーはどのような順序でも呼び出せることを想定する必要があります。  
+  
+ 宣言内で `Handles` を使用して追加されたハンドラーを削除するには、<xref:System.Windows.UIElement.RemoveHandler%2A> を呼び出します。  
+  
+ `Handles` を使用して、[ルーティング イベント](GTMT)のハンドラーをアタッチすることができます。ただしその場合には、メンバー テーブルで処理されるイベントを定義するインスタンスにハンドラーをアタッチする必要があります。  [ルーティング イベント](GTMT)の場合、`Handles` を使用してアタッチされるハンドラーは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 属性としてアタッチされるハンドラーまたは <xref:System.Windows.UIElement.AddHandler%2A> の一般的なシグネチャにアタッチされるハンドラーの場合と同じルーティング規則に従います。  つまり、イベントが既に処理済みとしてマークされている場合 \(イベント データの <xref:System.Windows.RoutedEventArgs.Handled%2A> プロパティが `True` の場合\)、`Handles` を使用してアタッチされるハンドラーは、そのイベント インスタンスに応答して呼び出されることはありません。  イベントは、ルート内の別の要素のインスタンス ハンドラーによって処理済みとしてマークされるか、ルート上の現在の要素または前の要素のクラス処理によって処理済みとしてマークされます。  トンネル\/バブルのペアになったイベントをサポートする入力イベントの場合は、トンネル ルートがイベント ペアを処理済みとしてマークしていることがあります。  ルーティング イベントの詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+## ハンドラーの追加時の "ハンドル" の制限  
+ `Handles` は、[添付イベント](GTMT)のハンドラーを参照できません。  その添付イベントの `add` アクセサー メソッドを使用するか、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で *typename.eventname* イベント属性を使用する必要があります。  詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+ [ルーティング イベント](GTMT)の場合、`Handles` を使用して、インスタンス メンバー テーブルのそのイベントが存在するインスタンスにハンドラーを割り当てることしかできません。  ただし、ルーティング イベントでは通常、親要素を子要素のイベントのリスナーにすることができます。これは、親要素のメンバー テーブルにそのイベントが存在しない場合でも可能です。  属性構文では、処理するイベントを実際に定義する型を修飾する *typename.membername* 属性形式を使用してこの指定を行うことができます。  たとえば、`Button.Click` の形式で属性ハンドラーを割り当てることで、\(`Clic`k イベントが定義されていない\) 親 `Page` がボタン クリック イベントをリッスンできるようになります。  ただし、`Handles` は競合する *Instance.Event* 形式をサポートする必要があるため、*typename.membername* 形式をサポートしません。  詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+ `Handles` は、既に処理済みとしてマークされているイベントに対して呼び出されるハンドラーをアタッチすることはできません。  代わりに、コードを使用して <xref:System.Windows.UIElement.AddHandler%28System.Windows.RoutedEvent%2CSystem.Delegate%2CSystem.Boolean%29> の `handledEventsToo` オーバーロードを呼び出す必要があります。  
+  
+> [!NOTE]
+>  XAML の同じイベントにイベント ハンドラーを指定するときに、[!INCLUDE[vb_current_short](../../../../includes/vb-current-short-md.md)] で `Handles` 構文を使用しないでください。  その場合、イベント ハンドラーが 2 回呼び出されます。  
+  
+## WPF での "ハンドル" 機能の実装方法  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ページのコンパイル時に、中間ファイルで、<xref:System.Windows.FrameworkContentElement.Name%2A> プロパティが設定されている \(または [x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md) が宣言されている\) ページのすべての要素への `Friend` `WithEvents` 参照が宣言されます。  それぞれの名前付きインスタンスは、`Handles` を使用してハンドラーに割り当てることができる要素になる可能性があります。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] 内では、[!INCLUDE[TLA2#tla_intellisense](../../../../includes/tla2sharptla-intellisense-md.md)] によって、要素がページの `Handles` 参照に使用できるようになったことを表示できます。  ただし、これには、中間ファイルですべての `Friends` 参照を設定できるように、1 つのコンパイル パスが必要になる場合があります。  
+  
+## 参照  
+ <xref:System.Windows.UIElement.AddHandler%2A>   
+ [ルーティング イベントの処理済みとしてのマーキング、およびクラス処理](../../../../docs/framework/wpf/advanced/marking-routed-events-as-handled-and-class-handling.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-arranging-windows-forms-controls-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-arranging-windows-forms-controls-in-wpf.md
new file mode 100644
index 00000000000..88b54ef332a
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-arranging-windows-forms-controls-in-wpf.md
@@ -0,0 +1,295 @@
+---
+title: "チュートリアル: WPF での Windows フォーム コントロールの配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (コントロールを)"
+  - "ハイブリッド アプリケーション [WPF 相互運用性]"
+ms.assetid: a1db8049-15c7-45d6-ae3d-36a6735cb848
+caps.latest.revision: 31
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# チュートリアル: WPF での Windows フォーム コントロールの配置
+このチュートリアルでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト機能を使用して、ハイブリッド アプリケーションで [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを配置する方法を示します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトの作成。  
+  
+-   既定のレイアウト設定の使用。  
+  
+-   コンテンツに合わせたサイズの変更。  
+  
+-   絶対配置の使用。  
+  
+-   サイズの明示的な指定。  
+  
+-   レイアウト プロパティの設定。  
+  
+-   z オーダーの制限の理解。  
+  
+-   ドッキング。  
+  
+-   可視性の設定。  
+  
+-   伸縮しないコントロールのホスト。  
+  
+-   スケーリング。  
+  
+-   回転。  
+  
+-   パディングとマージンの設定。  
+  
+-   動的レイアウト コンテナーの使用。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[WPF での Windows フォーム コントロールの配置のサンプル](http://go.microsoft.com/fwlink/?LinkID=159971)を参照してください。  
+  
+ 終了すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションにおける [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] レイアウトの機能を理解できます。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## プロジェクトの作成  
+  
+#### プロジェクトを作成し、設定するには  
+  
+1.  `WpfLayoutHostingWf` という名前の WPF アプリケーション プロジェクトを作成します。  
+  
+2.  ソリューション エクスプローラーで、次のアセンブリへの参照を追加します。  
+  
+    -   WindowsFormsIntegration  
+  
+    -   System.Windows.Forms  
+  
+    -   System.Drawing  
+  
+3.  MainWindow.xaml をダブルクリックして、XAML ビューで開きます。  
+  
+4.  <xref:System.Windows.Window> 要素に、次の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] 名前空間の割り当てを追加します。  
+  
+    ```xaml  
+    xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"  
+    ```  
+  
+5.  <xref:System.Windows.Controls.Grid> 要素で、<xref:System.Windows.Controls.Grid.ShowGridLines%2A> プロパティを `true` に設定し、5 つの行と 3 つの列を定義します。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#2)]  
+  
+## 既定のレイアウト設定の使用  
+ 既定では、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素が、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのレイアウトを処理します。  
+  
+#### 既定のレイアウト設定を使用するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#3)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] <xref:System.Windows.Forms.Button?displayProperty=fullName> コントロールが <xref:System.Windows.Controls.Canvas> に表示されます。  ホストされているコントロールはそのコンテンツに基づいてサイズ設定され、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素はホストされているコントロールが収まるようにサイズ変更されます。  
+  
+## コンテンツに合わせたサイズの変更  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を使用すると、ホストされているコントロールのサイズは、そのコンテンツが正しく表示されるように変更されます。  
+  
+#### コンテンツに合わせてサイズ変更するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#4)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  長くなったテキスト文字列および大きくなったフォント サイズが正しく表示されるように 2 つの新しいボタン コントロールのサイズが変更され、ホストされているコントロールが収まるように <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素のサイズが変更されます。  
+  
+## 絶対配置の使用  
+ 絶対配置を使用して、ユーザー インターフェイス \(UI\) の任意の場所に <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を配置できます。  
+  
+#### 絶対配置を使用するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#5)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、グリッド セルの上辺から 20 ピクセル、左辺から 20 ピクセルの位置に配置されます。  
+  
+## サイズの明示的な指定  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素のサイズは、<xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティを使用して指定できます。  
+  
+#### サイズを明示的に指定するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#6)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、既定のレイアウト設定よりも小さい、幅 50 ピクセル、高さ 70 ピクセルに設定されます。  それに合わせて、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのコンテンツが再配置されます。  
+  
+## レイアウト プロパティの設定  
+ ホストされているコントロールにレイアウト関連のプロパティを設定する場合は、常に <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素のプロパティを使用します。  ホストされているコントロールで直接レイアウト プロパティを設定すると、予期しない結果になります。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でホストされているコントロールにレイアウト関連プロパティを設定しても無効です。  
+  
+#### ホストされているコントロールでプロパティを設定した場合の結果を確認するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#7)]  
+  
+2.  ソリューション エクスプローラーで、MainWindow.xaml.  vb または MainWindow.xaml.cs をダブルクリックして、コード エディターで開きます。  
+  
+3.  次のコードを `MainWindow` クラス定義にコピーします。  
+  
+     [!code-csharp[WpfLayoutHostingWfWithXaml#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml.cs#101)]
+     [!code-vb[WpfLayoutHostingWfWithXaml#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml.vb#101)]  
+  
+4.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+5.  \[Click me\] ボタンをクリックします。  `button1_Click` イベント ハンドラーは、ホストされているコントロールで <xref:System.Windows.Forms.Control.Top%2A> プロパティと <xref:System.Windows.Forms.Control.Left%2A> プロパティを設定します。  これにより、ホストされているコントロールは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素内で再配置されます。  ホストは同じ画面領域を維持しますが、ホストされているコントロールはクリップされます。  代わりに、ホストされているコントロールは、常に <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素全体を占めます。  
+  
+## z オーダーの制限の理解  
+ 既定では<xref:System.Windows.Forms.Integration.WindowsFormsHost> の可視要素は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の他の要素の上に常に描画されz オーダーには影響しません。  18 Z 命令を有効にするには<xref:System.Windows.Interop.CompositionMode.Full> または <xref:System.Windows.Interop.CompositionMode.OutputOnly> と <xref:System.Windows.Interop.HwndHost.CompositionMode%2A> のプロパティを調整できるように <xref:System.Windows.Forms.Integration.WindowsFormsHost> の <xref:System.Windows.Interop.HwndHost.IsRedirected%2A> のプロパティを設定します。  
+  
+#### 既定の z オーダーの動作を確認するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#8)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。   <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素がラベル要素の上に描画されます。  
+  
+#### IsRedirected に該当する場合は z オーダーの動作を確認するには  
+  
+1.  次の XAML に前の z オーダーの例を次のコードに置き換えます。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#8b](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml#8b)]  
+  
+     F5 キーを押してアプリケーションをビルドし、実行します。  label 要素は <xref:System.Windows.Forms.Integration.WindowsFormsHost> の要素の上に描画されます。  
+  
+## ドッキング  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のドッキングをサポートします。  ホストされているコントロールを <xref:System.Windows.Controls.DockPanel> 要素にドッキングするように、<xref:System.Windows.Controls.DockPanel.Dock%2A> 添付プロパティを設定します。  
+  
+#### ホストされているコントロールをドッキングするには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#9)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素が <xref:System.Windows.Controls.DockPanel> 要素の右側にドッキングされます。  
+  
+## 可視性の設定  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを非表示にしたり、折りたたむには、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素で <xref:System.Windows.UIElement.Visibility%2A> プロパティを設定します。  コントロールを非表示にすると、そのコントロールは表示されませんが、レイアウト空間は使用されます。  コントロールを折りたたむと、そのコントロールは表示されず、レイアウト空間も使用されません。  
+  
+#### ホストされているコントロールの可視性を設定するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#10)]  
+  
+2.  MainWindow.xaml.vb または MainWindow.xaml.cs で、次のコードをクラス定義にコピーします。  
+  
+     [!code-csharp[WpfLayoutHostingWfWithXaml#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml.cs#102)]
+     [!code-vb[WpfLayoutHostingWfWithXaml#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml.vb#102)]  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+4.  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を非表示にするには、\[Click to make invisible\] ボタンをクリックします。  
+  
+5.  レイアウト全体から <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を非表示にする場合は、\[Click to collapse\] ボタンをクリックします。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが折りたたまれ、周りの要素が再配置されて、そのスペースが使用されます。  
+  
+## 伸縮しないコントロールのホスト  
+ 一部の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、サイズが固定され、レイアウト内の使用可能なスペースに合わせて伸縮しません。  たとえば、<xref:System.Windows.Forms.MonthCalendar> コントロールでは、固定されたスペースに月が表示されます。  
+  
+#### 伸縮しないコントロールをホストするには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#11)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素はグリッド行で中央揃えになりますが、使用可能なスペースに合わせて伸縮されることはありません。  ウィンドウが十分に大きい場合は、ホストされている <xref:System.Windows.Forms.MonthCalendar> コントロールによって 2 か月以上の月が表示される場合もありますが、これらは行内で中央揃えになります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウト エンジンは、使用可能なスペースに合わせたサイズ変更ができない要素を中央揃えにします。  
+  
+## スケーリング  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素と異なり、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは継続的にスケーリングすることはできません。  既定では<xref:System.Windows.Forms.Integration.WindowsFormsHost> の要素は可能であればホストされているコントロールをスケーリングします。  完全なスケーリングを有効にするには<xref:System.Windows.Interop.CompositionMode.Full> または <xref:System.Windows.Interop.CompositionMode.OutputOnly> と <xref:System.Windows.Interop.HwndHost.CompositionMode%2A> のプロパティを調整できるように <xref:System.Windows.Forms.Integration.WindowsFormsHost> の <xref:System.Windows.Interop.HwndHost.IsRedirected%2A> のプロパティを設定します。  
+  
+#### ホストされているコントロールを既定の動作を使用してスケーリングするには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#12)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  ホストされているコントロールとその周りの要素は、ファクター 0.5 でスケーリングされますが、  ホストされているコントロールのフォントはスケーリングされません。  
+  
+#### ホストされているコントロールを IsRedirected を true に設定してスケーリングするには  
+  
+1.  次の XAML にスケーリング前の例のに置き換えます。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#12b](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml#12b)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  ホストされているコントロールその周りの要素とホストされているコントロールのフォントはファクター 0.5 でスケーリングされます。  
+  
+## 回転  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素とは異なり、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは回転をサポートしません。  既定では<xref:System.Windows.Forms.Integration.WindowsFormsHost> の要素は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の他の要素と回転変換が適用されても。  回転値が 180 度の場合を除き、<xref:System.Windows.Forms.Integration.WindowsFormsHost.LayoutError> イベントが発生します。  への回転の角度を有効にするには<xref:System.Windows.Interop.CompositionMode.Full> または <xref:System.Windows.Interop.CompositionMode.OutputOnly> と <xref:System.Windows.Interop.HwndHost.CompositionMode%2A> のプロパティを調整できるように <xref:System.Windows.Forms.Integration.WindowsFormsHost> の <xref:System.Windows.Interop.HwndHost.IsRedirected%2A> のプロパティを設定します。  
+  
+#### ハイブリッド アプリケーションでの回転の結果を確認するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#13)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  ホストされているコントロールは回転しませんが、その周りの要素は 180 度の角度で回転します。  要素を表示するためにウィンドウのサイズを変更することが必要になる場合があります。  
+  
+#### IsRedirected に該当する場合はハイブリッド アプリケーションで回転の効果を確認します。  
+  
+1.  次の XAML に前の回転の例を次のコードに置き換えます。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#13b](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml#13b)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  ホストされているコントロールは回転します。  <xref:System.Windows.Media.RotateTransform.Angle%2A> のプロパティを任意の値に設定できることに注意してください。  要素を表示するためにウィンドウのサイズを変更することが必要になる場合があります。  
+  
+## パディングとマージンの設定  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウトのパディングとマージンは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のパディングとマージンに似ています。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素で <xref:System.Windows.Controls.Control.Padding%2A> プロパティと <xref:System.Windows.FrameworkElement.Margin%2A> プロパティを設定するだけです。  
+  
+#### ホストされているコントロールのパディングとマージンを設定するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#14)]  
+    [!code-xml[WpfLayoutHostingWfWithXaml#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#15)]  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  パディングとマージンの設定が、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]で適用される場合と同じように、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに適用されます。  
+  
+## 動的レイアウト コンテナーの使用  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]は、2 つの動的レイアウト コンテナー、<xref:System.Windows.Forms.FlowLayoutPanel> と <xref:System.Windows.Forms.TableLayoutPanel> を提供します。  これらのコンテナーは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レイアウトで使用することもできます。  
+  
+#### 動的レイアウト コンテナーを使用するには  
+  
+1.  次の XAML を <xref:System.Windows.Controls.Grid> 要素にコピーします。  
+  
+     [!code-xml[WpfLayoutHostingWfWithXaml#16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml#16)]  
+  
+2.  MainWindow.xaml.vb または MainWindow.xaml.cs で、次のコードをクラス定義にコピーします。  
+  
+     [!code-csharp[WpfLayoutHostingWfWithXaml#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml.cs#103)]
+     [!code-vb[WpfLayoutHostingWfWithXaml#103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml.vb#103)]  
+  
+3.  コンストラクターに `InitializeFlowLayoutPanel` メソッドの呼び出しを追加します。  
+  
+     [!code-csharp[WpfLayoutHostingWfWithXaml#104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/CSharp/Window1.xaml.cs#104)]
+     [!code-vb[WpfLayoutHostingWfWithXaml#104](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfLayoutHostingWfWithXaml/VisualBasic/Window1.xaml.vb#104)]  
+  
+4.  F5 キーを押してアプリケーションをビルドし、実行します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は <xref:System.Windows.Controls.DockPanel> 全体を占め、<xref:System.Windows.Forms.FlowLayoutPanel> はその子コントロールを既定の <xref:System.Windows.Forms.FlowLayoutPanel.FlowDirection%2A> に配置します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [WindowsFormsHost 要素のレイアウトに関する考慮事項](../../../../docs/framework/wpf/advanced/layout-considerations-for-the-windowsformshost-element.md)   
+ [WPF での Windows フォーム コントロールの配置のサンプル](http://go.microsoft.com/fwlink/?LinkID=159971)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-binding-to-data-in-hybrid-applications.md b/docs/framework/wpf/advanced/walkthrough-binding-to-data-in-hybrid-applications.md
new file mode 100644
index 00000000000..d22d3e1e480
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-binding-to-data-in-hybrid-applications.md
@@ -0,0 +1,186 @@
+---
+title: "チュートリアル : ハイブリッド アプリケーションでのデータへのバインディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング [WPF 相互運用性]"
+  - "ハイブリッド アプリケーション [WPF 相互運用性]"
+ms.assetid: 18997e71-745a-4425-9c69-2cbce1d8669e
+caps.latest.revision: 39
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 36
+---
+# チュートリアル : ハイブリッド アプリケーションでのデータへのバインディング
+データ ソースのコントロールへのバインディングは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のどちらを使用しているかに関係なく、ユーザーが基になるデータにアクセスできるようにするために不可欠です。  このチュートリアルでは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの両方を含むハイブリッド アプリケーションでデータ バインディングを使用する方法を示します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトの作成。  
+  
+-   データ テンプレートの定義。  
+  
+-   フォーム レイアウトの指定。  
+  
+-   データ バインディングの指定。  
+  
+-   相互運用を使用したデータの表示。  
+  
+-   プロジェクトへのデータ ソースの追加。  
+  
+-   データ ソースへのバインディング。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[ハイブリッド アプリケーションでのデータ バインディングのサンプル](http://go.microsoft.com/fwlink/?LinkID=159983)を参照してください。  
+  
+ 終了すると、ハイブリッド アプリケーションのデータ バインディング機能を理解できるようになります。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+-   Microsoft SQL Server で実行されている Northwind サンプル データベースへのアクセス。  
+  
+## プロジェクトの作成  
+  
+#### プロジェクトを作成し、設定するには  
+  
+1.  `WPFWithWFAndDatabinding` という名前の WPF アプリケーション プロジェクトを作成します。  
+  
+2.  ソリューション エクスプローラーで、次のアセンブリへの参照を追加します。  
+  
+    -   WindowsFormsIntegration  
+  
+    -   System.Windows.Forms  
+  
+3.  [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]で MainWindow.xaml を開きます。  
+  
+4.  <xref:System.Windows.Window> 要素に、次の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]名前空間の割り当てを追加します。  
+  
+    ```xaml  
+    xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"  
+    ```  
+  
+5.  <xref:System.Windows.FrameworkElement.Name%2A> プロパティを割り当てて、既定の <xref:System.Windows.Controls.Grid> 要素に `mainGrid` という名前を付けます。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#8)]  
+  
+## データ テンプレートの定義  
+ 顧客のマスター一覧が <xref:System.Windows.Controls.ListBox> コントロールに表示されます。  <xref:System.Windows.Controls.ListBox> コントロールのビジュアル ツリーを制御する `ListItemsTemplate` という名前の <xref:System.Windows.DataTemplate> オブジェクトを定義するコード例を次に示します。  この <xref:System.Windows.DataTemplate> は、<xref:System.Windows.Controls.ListBox> コントロールの <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> プロパティに割り当てられます。  
+  
+#### データ テンプレートを定義するには  
+  
+-   次の XAML を <xref:System.Windows.Controls.Grid> 要素の宣言にコピーします。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#3)]  
+  
+## フォーム レイアウトの指定  
+ フォームのレイアウトは、3 つの行と 3 つの列を持つグリッドで定義されます。  <xref:System.Windows.Controls.Label> コントロールで、Customers テーブル内の各列が識別されます。  
+  
+#### グリッド レイアウトを設定するには  
+  
+-   次の XAML を <xref:System.Windows.Controls.Grid> 要素の宣言にコピーします。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#4)]  
+  
+#### ラベル コントロールを設定するには  
+  
+-   次の XAML を <xref:System.Windows.Controls.Grid> 要素の宣言にコピーします。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#5)]  
+  
+## データ バインディングの指定  
+ 顧客のマスター一覧が <xref:System.Windows.Controls.ListBox> コントロールに表示されます。  結合された `ListItemsTemplate` によって、<xref:System.Windows.Controls.TextBlock> コントロールがデータベースの `ContactName` フィールドにバインドされます。  
+  
+ 各顧客レコードの詳細がいくつかの <xref:System.Windows.Controls.TextBox> コントロールに表示されます。  
+  
+#### データ バインディングを指定するには  
+  
+-   次の XAML を <xref:System.Windows.Controls.Grid> 要素の宣言にコピーします。  
+  
+     <xref:System.Windows.Data.Binding> クラスによって、<xref:System.Windows.Controls.TextBox> コントロールがデータベースの適切なフィールドにバインドされます。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#6)]  
+  
+## 相互運用を使用したデータの表示  
+ 選択した顧客に対応する注文が、`dataGridView1` という名前の <xref:System.Windows.Forms.DataGridView?displayProperty=fullName> コントロールに表示されます。  `dataGridView1` コントロールは、分離コード ファイルのデータ ソースにバインドされています。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは、この [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの親です。  
+  
+#### DataGridView コントロールにデータを表示するには  
+  
+-   次の XAML を <xref:System.Windows.Controls.Grid> 要素の宣言にコピーします。  
+  
+     [!code-xml[WPFWithWFAndDatabinding#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml#7)]  
+  
+## プロジェクトへのデータ ソースの追加  
+ [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を使用すると、データ ソースをプロジェクトに簡単に追加できます。  この手順では、厳密に型指定されたデータ セットをプロジェクトに追加します。  選択されたテーブルごとのテーブル アダプターなどの他のサポート クラスもいくつか追加されます。  
+  
+#### データ ソースを追加するには  
+  
+1.  **\[データ\]** メニューの **\[新しいデータ ソースの追加\]** をクリックします。  
+  
+2.  **データ ソース構成ウィザード**で、データセットを使用して、Northwind データベースへの接続を作成します。  詳細については、「[方法 : データベース内のデータに接続する](../Topic/How%20to:%20Connect%20to%20Data%20in%20a%20Database.md)」を参照してください。  
+  
+3.  データソース構成ウィザードからメッセージが表示されたら、接続文字列を `NorthwindConnectionString` として保存します。  
+  
+4.  データベース オブジェクトの選択を求められた場合は、`Customers` テーブルと `Orders` テーブルを選択し、生成されたデータセットに  `NorthwindDataSet` という名前を付けます。  
+  
+## データ ソースへのバインディング  
+ <xref:System.Windows.Forms.BindingSource?displayProperty=fullName> コンポーネントは、アプリケーションのデータ ソースの統一されたインターフェイスを提供します。  データ ソースへのバインディングは、分離コード ファイルで実装されます。  
+  
+#### データ ソースにバインドするには  
+  
+1.  MainWindow.xaml.vb または MainWindow.xaml.cs という名前の分離コード ファイルを開きます。  
+  
+2.  次のコードを `MainWindow` クラス定義にコピーします。  
+  
+     このコードでは、<xref:System.Windows.Forms.BindingSource> コンポーネントと、データベースに接続する関連付けられたヘルパー クラスが宣言されます。  
+  
+     [!code-csharp[WPFWithWFAndDatabinding#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml.cs#11)]
+     [!code-vb[WPFWithWFAndDatabinding#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFWithWFAndDatabinding/VisualBasic/WPFWithWFAndDatabinding/Window1.xaml.vb#11)]  
+  
+3.  コンストラクターに次のコードをコピーします。  
+  
+     このコードでは、<xref:System.Windows.Forms.BindingSource> コンポーネントが作成および初期化されます。  
+  
+     [!code-csharp[WPFWithWFAndDatabinding#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml.cs#12)]
+     [!code-vb[WPFWithWFAndDatabinding#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFWithWFAndDatabinding/VisualBasic/WPFWithWFAndDatabinding/Window1.xaml.vb#12)]  
+  
+4.  MainWindow.xaml を開きます。  
+  
+5.  デザイン ビューまたは XAML ビューで、<xref:System.Windows.Window> 要素を選択します。  
+  
+6.  プロパティ ウィンドウの **\[イベント\]** タブをクリックします。  
+  
+7.  <xref:System.Windows.FrameworkElement.Loaded> イベントをダブルクリックします。  
+  
+8.  <xref:System.Windows.FrameworkElement.Loaded> イベント ハンドラーに次のコードをコピーします。  
+  
+     このコードでは、<xref:System.Windows.Forms.BindingSource> コンポーネントがデータ コンテキストとして割り当てられ、`Customers` および `Orders` アダプター オブジェクトが設定されます。  
+  
+     [!code-csharp[WPFWithWFAndDatabinding#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml.cs#13)]
+     [!code-vb[WPFWithWFAndDatabinding#13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFWithWFAndDatabinding/VisualBasic/WPFWithWFAndDatabinding/Window1.xaml.vb#13)]  
+  
+9. 次のコードを `MainWindow` クラス定義にコピーします。  
+  
+     このメソッドは <xref:System.Windows.Data.CollectionView.CurrentChanged> イベントを処理し、データ バインディングの現在の項目を更新します。  
+  
+     [!code-csharp[WPFWithWFAndDatabinding#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFWithWFAndDatabinding/CSharp/WPFWithWFAndDatabinding/Window1.xaml.cs#14)]
+     [!code-vb[WPFWithWFAndDatabinding#14](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFWithWFAndDatabinding/VisualBasic/WPFWithWFAndDatabinding/Window1.xaml.vb#14)]  
+  
+10. F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [ハイブリッド アプリケーションでのデータ バインディングのサンプル](http://go.microsoft.com/fwlink/?LinkID=159983)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md b/docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md
new file mode 100644
index 00000000000..405f80fb4ae
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md
@@ -0,0 +1,336 @@
+---
+title: "チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キャッシュ [.NET Framework]"
+  - "キャッシュ [WPF]"
+  - "チュートリアル [WPF], キャッシュ"
+ms.assetid: dac2c9ce-042b-4d23-91eb-28f584415cef
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ
+キャッシュを使用するとメモリにデータを格納しておくことができるのですぐにアクセスできます。  データに再度アクセスするとき、アプリケーションは元のソースからデータを取得する代わりにキャッシュからデータを取得できます。  これにより、パフォーマンスとスケーラビリティが向上します。  さらにキャッシュを使用するとデータ ソースが一時的に使用できない場合もデータが使用可能になります。  
+  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションでキャッシュを使用できるクラスを提供します。  これらのクラスは <xref:System.Runtime.Caching> の名前空間にあります。  
+  
+> [!NOTE]
+>  <xref:System.Runtime.Caching> 名前空間は [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] で新たに追加されました。  この名前空間を使用すると、すべての [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アプリケーションでキャッシュを使用できます。  以前のバージョンの [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、<xref:System.Web> 名前空間でしかキャッシュを使用できないため、ASP.NET クラスに対する依存関係が必要になります。  
+  
+ このチュートリアルでは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] で使用可能なキャッシュ機能を [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションの一部として使用する方法について説明します。  チュートリアルではテキスト ファイルの内容をキャッシュします。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   WPF アプリケーション プロジェクトを作成します。  
+  
+-   [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] に参照を追加します。  
+  
+-   キャッシュを初期化します。  
+  
+-   テキスト ファイルの内容を格納しているキャッシュ エントリを追加します。  
+  
+-   キャッシュ エントリの削除ポリシーを指定します。  
+  
+-   キャッシュ ファイルのパスを監視し、監視対象の項目への変更についてキャッシュ インスタンスに通知します。  
+  
+## 必須コンポーネント  
+ このチュートリアルを完了するための要件は次のとおりです。  
+  
+-   Microsoft [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)]  
+  
+-   少量のテキストを含むテキスト ファイル。  このテキスト ファイルの内容をメッセージ ボックスに表示します。 このチュートリアルに示すコードでは、次のファイルを使用していることを前提としています。  
+  
+     `c:\cache\cacheText.txt`  
+  
+     ただし、このチュートリアルでは、任意のテキスト ファイルを使用し、コードにわずかな変更を加えることができます。  
+  
+## WPF アプリケーション プロジェクトの作成  
+ WPF アプリケーション プロジェクトを作成することから始めます。  
+  
+#### WPF アプリケーションを作成するには  
+  
+1.  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] を起動します。  
+  
+2.  **\[ファイル\]** メニューの **\[新規作成\]** をクリックし、**\[新しいプロジェクト\]** をクリックします。  
+  
+     **\[新しいプロジェクト\]** ダイアログ ボックスが表示されます。  
+  
+3.  **\[インストールされているテンプレート\]** で、使用するプログラミング言語 \(**\[Visual Basic\]** または **\[Visual C\#\]**\) をクリックします。  
+  
+4.  **\[新しいプロジェクト\]** ダイアログ ボックスで、**\[WPF アプリケーション\]** をクリックします。  
+  
+    > [!NOTE]
+    >  **\[WPF アプリケーション\]** テンプレートがない場合は、WPF をサポートしている [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のバージョンを使用しているかどうかを確認してください。  **\[新しいプロジェクト\]** ダイアログ ボックスで、一覧から [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] を選択します。  
+  
+5.  **\[名前\]** ボックスにプロジェクトの名前を入力します。  たとえば、「WPFCaching」と入力できます。  
+  
+6.  **\[ソリューションのディレクトリを作成\]** チェック ボックスをオンにします。  
+  
+7.  **\[OK\]** をクリックします。  
+  
+     **デザイン** ビューに WPF デザイナーが開き、MainWindow.xaml ファイルが表示されます。  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] では、**My Project** フォルダー、Application.xaml ファイル、および MainWindow.xaml ファイルを作成します。  
+  
+## .NET Framework を対象にすることおよびキャッシュ アセンブリへの参照の追加  
+ 既定では、WPF アプリケーションは [!INCLUDE[net_client_v40_long](../../../../includes/net-client-v40-long-md.md)] を対象とします。  WPF アプリケーションで <xref:System.Runtime.Caching> 名前空間を使用するには、名前空間で [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] \([!INCLUDE[net_client_v40_long](../../../../includes/net-client-v40-long-md.md)] ではない\) を対象にして、名前空間への参照を含める必要があります。  
+  
+ そのため、次の手順では対象の .NET Framework を変更し、<xref:System.Runtime.Caching> 名前空間への参照を追加します。  
+  
+> [!NOTE]
+>  Visual Basic プロジェクトと Visual C\# プロジェクトでは、対象の .NET Framework を変更する手順が異なります。  
+  
+#### Visual Basic で対象の .NET Framework を変更するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクト名を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+     アプリケーションのプロパティ ウィンドウが表示されます。  
+  
+2.  **\[コンパイル\]** タブをクリックします。  
+  
+3.  ウィンドウの下部にある **\[詳細コンパイル オプション\]** をクリックします。  
+  
+     **\[コンパイラの詳細設定\]** ダイアログ ボックスが表示されます。  
+  
+4.  **ターゲット フレームワーク （すべての構成）** の一覧の \[ [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)]。  （ [!INCLUDE[net_client_v40_long](../../../../includes/net-client-v40-long-md.md)]を選択しないでください）。  
+  
+5.  **\[OK\]** をクリックします。  
+  
+     **\[対象とする Framework の変更\]** ダイアログ ボックスが表示されます。  
+  
+6.  **\[対象とする Framework の変更\]** ダイアログ ボックスで、**\[はい\]** をクリックします。  
+  
+     プロジェクトが閉じてから再び開きます。  
+  
+7.  次の手順に従って、キャッシュ アセンブリへの参照を追加します。  
+  
+    1.  **ソリューション エクスプローラー**で、プロジェクトの名前を右クリックし、**\[参照の追加\]** をクリックします。  
+  
+    2.  **\[.NET\]** タブをクリックし、`System.Runtime.Caching` を選択して、**\[OK\]** をクリックします。  
+  
+#### Visual C\# プロジェクトで対象の .NET Framework を変更するには  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクト名を右クリックし、**\[プロパティ\]** をクリックします。  
+  
+     アプリケーションのプロパティ ウィンドウが表示されます。  
+  
+2.  **\[アプリケーション\]** タブをクリックします。  
+  
+3.  **\[対象とする Framework\]** ボックスの一覧で、[!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] を選択します   \(**.NET Framework 4 Client Profile** は選択しないでください\)。  
+  
+4.  次の手順に従って、キャッシュ アセンブリへの参照を追加します。  
+  
+    1.  **\[参照設定\]** フォルダーを右クリックし、**\[参照の追加\]** をクリックします。  
+  
+    2.  **\[.NET\]** タブをクリックし、`System.Runtime.Caching` を選択して、**\[OK\]** をクリックします。  
+  
+## WPF ウィンドウへのボタンの追加  
+ 次に、ボタン コントロールを追加して、ボタンの `Click` イベントのイベント ハンドラーを作成します。  後でコードを追加し、ボタンをクリックしたときにテキスト ファイルの内容がキャッシュされて表示されるようにします。  
+  
+#### ボタン コントロールを追加するには  
+  
+1.  **ソリューション エクスプローラー**で、MainWindow.xaml ファイルをダブルクリックして開きます。  
+  
+2.  **\[ツールボックス\]** の **\[コモン WPF コントロール\]** で、`Button` コントロールを `MainWindow` ウィンドウにドラッグします。  
+  
+3.  **プロパティ** ウィンドウで、`Button` コントロールの `Content` プロパティを \[Get Cache\] に設定します。  
+  
+## キャッシュの初期化とエントリのキャッシュ  
+ 次に、次のタスクを行うコードを追加します。  
+  
+-   キャッシュ クラスのインスタンスを作成します。つまり、新しい <xref:System.Runtime.Caching.MemoryCache> オブジェクトのインスタンスを生成します。  
+  
+-   キャッシュが <xref:System.Runtime.Caching.HostFileChangeMonitor> オブジェクトを使用してテキスト ファイルの変更を監視するよう指定します。  
+  
+-   テキスト ファイルを読み取り、その内容をキャッシュ エントリとしてキャッシュします。  
+  
+-   キャッシュしたテキスト ファイルの内容を表示します。  
+  
+#### キャッシュ オブジェクトを作成するには  
+  
+1.  MainWindow.xaml.cs ファイルまたは MainWindow.Xaml.vb ファイルにイベント ハンドラーを作成するために、追加したボタンをダブルクリックします。  
+  
+2.  ファイルの上部 \(クラス宣言の前\) に次の `Imports` \(Visual Basic\) または `using` \(C\#\) ステートメントを追加します。  
+  
+    ```csharp  
+    using System.Runtime.Caching;  
+    using System.IO;  
+    ```  
+  
+    ```vb  
+    Imports System.Runtime.Caching  
+    Imports System.IO  
+    ```  
+  
+3.  キャッシュ オブジェクトのインスタンスを生成するためにイベント ハンドラーに次のコードを追加します。  
+  
+    ```csharp  
+    ObjectCache cache = MemoryCache.Default;  
+    ```  
+  
+    ```vb  
+    Dim cache As ObjectCache = MemoryCache.Default  
+    ```  
+  
+     <xref:System.Runtime.Caching.ObjectCache> クラスは、メモリ内オブジェクト キャッシュを提供する組み込みクラスです。  
+  
+4.  `filecontents` という名前のキャッシュ エントリの内容を読み取るために次のコードを追加します。  
+  
+    ```vb  
+    Dim fileContents As String = TryCast(cache("filecontents"), String)  
+    ```  
+  
+    ```csharp  
+    string fileContents = cache["filecontents"] as string;  
+    ```  
+  
+5.  `filecontents` という名前のキャッシュ エントリがあるかどうかを確認するために次のコードを追加します。  
+  
+    ```vb  
+    If fileContents Is Nothing Then  
+  
+    End If  
+    ```  
+  
+    ```csharp  
+    if (fileContents == null)  
+    {  
+  
+    }  
+    ```  
+  
+     指定したキャッシュ エントリがない場合は、テキスト ファイルを読み取り、これをキャッシュ エントリとしてキャッシュに追加する必要があります。  
+  
+6.  キャッシュ エントリの有効期限が 10 秒後に切れるように指定する新しい <xref:System.Runtime.Caching.CacheItemPolicy> オブジェクトを作成するために、`if/then` ブロックに次のコードを追加します。  
+  
+    ```vb  
+    Dim policy As New CacheItemPolicy()  
+    policy.AbsoluteExpiration = DateTimeOffset.Now.AddSeconds(10.0)  
+    ```  
+  
+    ```csharp  
+    CacheItemPolicy policy = new CacheItemPolicy();  
+    policy.AbsoluteExpiration = DateTimeOffset.Now.AddSeconds(10.0);  
+    ```  
+  
+     削除情報や有効期限情報が指定されない場合、既定値は <xref:System.Runtime.Caching.ObjectCache.InfiniteAbsoluteExpiration> になり、キャッシュ エントリが絶対時間のみに基づいて有効期限切れになることはなくなります。  この場合はメモリ圧迫の状態にある場合にのみキャッシュ エントリが期限切れになります。  ベスト プラクティスとして、常に絶対有効期限またはスライド式有効期限を明示的に指定してください。  
+  
+7.  監視するファイル パスのコレクションを作成してテキスト ファイルのパスをコレクションに追加するために、`if/then` ブロック内の前の手順で追加したコードの後に次のコードを追加します。  
+  
+    ```vb  
+    Dim filePaths As New List(Of String)()  
+    filePaths.Add("c:\cache\cacheText.txt")  
+    ```  
+  
+    ```csharp  
+    List<string> filePaths = new List<string>();  
+    filePaths.Add("c:\\cache\\cacheText.txt");  
+    ```  
+  
+    > [!NOTE]
+    >  使用しようとするテキスト ファイルが `c:\cache\cacheText.txt` でない場合は、そのテキスト ファイルのパスを指定します。  
+  
+8.  キャッシュ エントリの変更監視機能のコレクションに新しい <xref:System.Runtime.Caching.HostFileChangeMonitor> オブジェクトを追加するために、前の手順で追加したコードの後に次のコードを追加します。  
+  
+    ```vb  
+    policy.ChangeMonitors.Add(New HostFileChangeMonitor(filePaths))  
+    ```  
+  
+    ```csharp  
+    policy.ChangeMonitors.Add(new HostFileChangeMonitor(filePaths));  
+    ```  
+  
+     <xref:System.Runtime.Caching.HostFileChangeMonitor> オブジェクトはテキスト ファイルのパスを監視し、変更が発生するとキャッシュに通知します。  この例のキャッシュ エントリは、ファイルの内容に変更があると有効期限が切れます。  
+  
+9. テキスト ファイルの内容を読み取るために、前の手順で追加したコードの後に次のコードを追加します。  
+  
+    ```vb  
+    fileContents = File.ReadAllText("c:\cache\cacheText.txt") & vbCrLf & DateTime.Now.ToString()  
+    ```  
+  
+    ```csharp  
+    fileContents = File.ReadAllText("c:\\cache\\cacheText.txt") + + "\n" + DateTime.Now;   
+    ```  
+  
+     キャッシュ エントリの有効期限を確認できるように、日付と時刻のタイムスタンプが追加されます。  
+  
+10. ファイルの内容を <xref:System.Runtime.Caching.CacheItem> インスタンスとしてキャッシュ オブジェクトに挿入するために、前の手順で追加したコードの後に次のコードを追加します。  
+  
+    ```vb  
+    cache.Set("filecontents", fileContents, policy)  
+    ```  
+  
+    ```csharp  
+    cache.Set("filecontents", fileContents, policy);  
+    ```  
+  
+     キャッシュ エントリの削除方法に関する情報を指定するために、前に作成した <xref:System.Runtime.Caching.CacheItemPolicy> オブジェクトをパラメーターとして渡します。  
+  
+11. キャッシュしたファイルの内容をメッセージ ボックスに表示するために、`if/then` ブロックの後に次のコードを追加します。  
+  
+    ```vb  
+    MessageBox.Show(fileContents)  
+    ```  
+  
+    ```csharp  
+    MessageBox.Show(fileContents);  
+    ```  
+  
+12. **\[ビルド\]** メニューの **\[WPFCaching のビルド\]** をクリックし、プロジェクトをビルドします。  
+  
+## WPF アプリケーションでのキャッシュのテスト  
+ これで、アプリケーションをテストできるようになりました。  
+  
+#### WPF アプリケーションでのキャッシュをテストするには  
+  
+1.  Ctrl キーを押しながら F5 キーを押してアプリケーションを実行します。  
+  
+     `MainWindow` ウィンドウが表示されます。  
+  
+2.  **\[Get Cache\]** をクリックします。  
+  
+     テキスト ファイルのキャッシュされた内容がメッセージ ボックスに表示されます。  ファイルにタイムスタンプがあることを確認します。  
+  
+3.  メッセージ ボックスを閉じてから、**\[Get Cache\]** を再度クリックします。  
+  
+     タイムスタンプは変わりません。  これは、キャッシュされた内容が表示されていることを示します。  
+  
+4.  10 秒以上待機してから、**\[Get Cache\]** を再度クリックします。  
+  
+     今度は新しいタイムスタンプが表示されます。  これはポリシーによってキャッシュ エントリの有効期限が切れ、キャッシュされた新しい内容が表示されていることを示します。  
+  
+5.  テキスト エディターで、作成したテキスト ファイルを開きます。  まだ変更は加えないでください。  
+  
+6.  メッセージ ボックスを閉じてから、**\[Get Cache\]** を再度クリックします。  
+  
+     タイムスタンプを再度確認します。  
+  
+7.  テキスト ファイルに変更を加え、ファイルを保存します。  
+  
+8.  メッセージ ボックスを閉じてから、**\[Get Cache\]** を再度クリックします。  
+  
+     このメッセージ ボックスには、テキスト ファイルの更新された内容と新しいタイムスタンプが格納されます。  これは、絶対タイムアウト期間が期限切れではない場合でも、ファイルを変更したときにホスト ファイルの変更監視機能によってキャッシュ エントリが直ちに削除されたことを示します。  
+  
+    > [!NOTE]
+    >  削除時間を 20 秒以上に長くすると、ファイルに変更を加える時間を長くすることができます。  
+  
+## コード例  
+ このチュートリアルを完了すると、作成したプロジェクトのコードは次の例のようになります。  
+  
+ [!code-csharp[CachingWPFApplications#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CachingWPFApplications/CSharp/MainWindow.xaml.cs#1)]
+ [!code-vb[CachingWPFApplications#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CachingWPFApplications/VisualBasic/MainWindow.xaml.vb#1)]  
+  
+## 参照  
+ <xref:System.Runtime.Caching.MemoryCache>   
+ <xref:System.Runtime.Caching.ObjectCache>   
+ <xref:System.Runtime.Caching>   
+ [.NET Framework アプリケーションでのキャッシュ](../../../../docs/framework/performance/caching-in-net-framework-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md
new file mode 100644
index 00000000000..baf2702dd84
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md
@@ -0,0 +1,152 @@
+---
+title: "チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Direct3D9 [WPF 相互運用性], 作成 (Direct3D9 コンテンツを)"
+  - "WPF, 作成 (Direct3D9 コンテンツを)"
+ms.assetid: 286e98bc-1eaa-4b5e-923d-3490a9cca5fc
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成
+このチュートリアルでは、Windows Presentation Foundation \(WPF\) アプリケーションでのホストに適した Direct3D9 コンテンツを作成する方法を示します。  WPF アプリケーションで Direct3D9 コンテンツをホストする方法の詳細については、「[WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)」を参照してください。  
+  
+ このチュートリアルでは次のタスクを行います。  
+  
+-   Direct3D9 プロジェクトを作成する。  
+  
+-   WPF アプリケーションでホストするための Direct3D9 プロジェクトを構成する。  
+  
+ タスクが終了すると、WPF アプリケーションで使用される Direct3D9 コンテンツを含む DLL が生成されます。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+-   DirectX SDK 9 以降  
+  
+## Direct3D9 プロジェクトの作成  
+ 最初に Direct3D9 プロジェクトを作成して構成します。  
+  
+#### Direct3D9 プロジェクトを作成するには  
+  
+1.  C\+\+ で、`D3DContent` という名前の新しい Win32 プロジェクトを作成します。  
+  
+     Win32 アプリケーション ウィザードが開き、\[ようこそ\] 画面が表示されます。  
+  
+2.  **\[次へ\]** をクリックします。  
+  
+     \[アプリケーションの設定\] 画面が表示されます。  
+  
+3.  **\[アプリケーションの種類\]** セクションで、**\[DLL\]** オプションをクリックします。  
+  
+4.  **\[完了\]** をクリックします。  
+  
+     D3DContent プロジェクトが生成されます。  
+  
+5.  ソリューション エクスプローラーで、D3DContent プロジェクトを右クリックし、**\[プロパティ\]** をクリックします。  
+  
+     **\[D3DContent プロパティ ページ\]** ダイアログ ボックスが表示されます。  
+  
+6.  **\[C\/C\+\+\]** ノードをクリックします。  
+  
+7.  **\[追加のインクルード ディレクトリ\]** フィールドに、DirectX インクルード フォルダーの場所を指定します。  このフォルダーの既定の場所は、%ProgramFiles%\\Microsoft DirectX SDK \(*バージョン*\)\\Include です。  
+  
+8.  **\[リンカー\]** ノードをダブルクリックして展開します。  
+  
+9. **\[追加のライブラリ ディレクトリ\]** フィールドに、DirectX ライブラリ フォルダーの場所を指定します。  このフォルダーの既定の場所は、%ProgramFiles%\\Microsoft DirectX SDK \(*バージョン*\)\\Lib\\x86 です。  
+  
+10. **\[入力\]** ノードをクリックします。  
+  
+11. **\[追加の依存ファイル\]** フィールドに、`d3d9.lib` ファイルと `d3dx9.lib` ファイルを追加します。  
+  
+12. ソリューション エクスプローラーで、`D3DContent.def` という名前の新しいモジュール定義ファイル \(.def\) をプロジェクトに追加します。  
+  
+## Direct3D9 コンテンツの作成  
+ 最大限のパフォーマンスを得るには、Direct3D9 コンテンツで特定の設定を使用する必要があります。  次のコードは、最大限のパフォーマンス特性を持つ Direct3D9 サーフェイスを作成する方法を示しています。  詳細については、「[Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)」を参照してください。  
+  
+#### Direct3D9 コンテンツを作成するには  
+  
+1.  ソリューション エクスプローラーを使用して、3 つの C\+\+ クラスを次に示す名前のプロジェクトに追加します。  
+  
+     `CRenderer` \(仮想デストラクターを使用\)  
+  
+     `CRendererManager`  
+  
+     `CTriangleRenderer`  
+  
+2.  コード エディターで Renderer.h を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#RendererH](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderer.h#rendererh)]  
+  
+3.  コード エディターで Renderer.cpp を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#RendererCPP](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderer.cpp#renderercpp)]  
+  
+4.  コード エディターで RendererManager.h を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#RendererManagerH](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.h#renderermanagerh)]  
+  
+5.  コード エディターで RendererManager.cpp を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#RendererManagerCPP](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.cpp#renderermanagercpp)]  
+  
+6.  コード エディターで TriangleRenderer.h を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#TriangleRendererH](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/trianglerenderer.h#trianglerendererh)]  
+  
+7.  コード エディターで TriangleRenderer.cpp を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#TriangleRendererCPP](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/trianglerenderer.cpp#trianglerenderercpp)]  
+  
+8.  コード エディターで stdafx.h を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#StdafxH](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/stdafx.h#stdafxh)]  
+  
+9. コード エディターで dllmain.cpp を開き、自動的に生成されたコードを次のコードに置き換えます。  
+  
+     [!code-cpp[System.Windows.Interop.D3DImage#DllMain](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/dllmain.cpp#dllmain)]  
+  
+10. コード エディターで D3DContent.def を開きます。  
+  
+11. 自動的に生成されたコードを次のコードで置き換えます。  
+  
+    ```  
+  
+    LIBRARY "D3DContent"  
+  
+    EXPORTS  
+  
+    SetSize  
+    SetAlpha  
+    SetNumDesiredSamples  
+    SetAdapter  
+  
+    GetBackBufferNoRef  
+    Render  
+    Destroy  
+  
+    ```  
+  
+12. プロジェクトをビルドします。  
+  
+## 次の手順  
+  
+-   WPF アプリケーションで Direct3D9 コンテンツをホストします。  詳細については、「[チュートリアル : WPF での Direct3D9 コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Interop.D3DImage>   
+ [Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)   
+ [チュートリアル : WPF での Direct3D9 コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-creating-your-first-touch-application.md b/docs/framework/wpf/advanced/walkthrough-creating-your-first-touch-application.md
new file mode 100644
index 00000000000..e3a71fe5661
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-creating-your-first-touch-application.md
@@ -0,0 +1,93 @@
+---
+title: "チュートリアル: 初めてのタッチ アプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成 (タッチスクリーン アプリケーションを) [WPF]"
+  - "作成 (タッチを検知するアプリケーションを) [WPF]"
+  - "タッチスクリーン アプリケーション [WPF], 作成"
+  - "タッチを検知するアプリケーション [WPF], 作成"
+ms.assetid: d69e602e-9a25-4e24-950b-e89eaa2a906b
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# チュートリアル: 初めてのタッチ アプリケーションの作成
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、タッチに応答するアプリケーションを作成できます。  たとえば、タッチスクリーンなどのタッチを検知するデバイスで 1 本または複数本の指を使用してアプリケーションを操作できます。このチュートリアルでは、タッチすることで単一のオブジェクトを移動、サイズ変更または回転させることのできるアプリケーションを作成します。  
+  
+## 必要条件  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_ext](../../../../includes/vs-dev10-ext-md.md)].  
+  
+-   Windows 7。  
+  
+-   Windows タッチをサポートする、タッチスクリーンなどのタッチ入力ができるデバイス。  
+  
+ また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのアプリケーションの作成において、特にイベントのサブスクライブ方法と処理方法に関する基礎知識があることが必要です。  詳細については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  
+  
+## アプリケーションの作成  
+  
+#### アプリケーションを作成するには  
+  
+1.  Visual Basic または Visual C\# で、「`BasicManipulation`」という名前の新しい WPF アプリケーション プロジェクトを作成します。  詳細については、「[方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)」を参照してください。  
+  
+2.  MainWindow.xaml の内容を次の XAML に置き換えます。  
+  
+     マークアップにより、<xref:System.Windows.Controls.Canvas> 上に赤い <xref:System.Windows.Shapes.Rectangle> を含む単純なアプリケーションが作成されます。  <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.UIElement.IsManipulationEnabled%2A> プロパティは、操作イベントを受け取ることができるように true に設定されます。  アプリケーションは、<xref:System.Windows.UIElement.ManipulationStarting> イベント、<xref:System.Windows.UIElement.ManipulationDelta> イベントおよび <xref:System.Windows.UIElement.ManipulationInertiaStarting> イベントをサブスクライブします。  これらのイベントには、ユーザーが操作したときに <xref:System.Windows.Shapes.Rectangle> を移動するためのロジックが含まれています。  
+  
+     [!code-xml[BasicManipulation#UI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicmanipulation/csharp/mainwindow.xaml#ui)]  
+  
+3.  Visual Basic を使用している場合は、MainWindow.xaml の最初の行で、`x:Class="BasicManipulation.MainWindow"` を `x:Class="MainWindow"` で置換します。  
+  
+4.  `MainWindow` クラスに、次の <xref:System.Windows.UIElement.ManipulationStarting> イベント ハンドラーを追加します。  
+  
+     <xref:System.Windows.UIElement.ManipulationStarting> イベントは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] がタッチ入力によるオブジェクト操作の開始を検知すると発生します。  コードでは、<xref:System.Windows.Input.ManipulationStartingEventArgs.ManipulationContainer%2A> プロパティを設定することで、操作の位置が <xref:System.Windows.Window> と相対するように指定します。  
+  
+     [!code-csharp[BasicManipulation#ManipulationStarting](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicmanipulation/csharp/mainwindow.xaml.cs#manipulationstarting)]
+     [!code-vb[BasicManipulation#ManipulationStarting](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicmanipulation/visualbasic/mainwindow.xaml.vb#manipulationstarting)]  
+  
+5.  `MainWindow` クラスに、次の <xref:System.Windows.Input.ManipulationDelta> イベント ハンドラーを追加します。  
+  
+     <xref:System.Windows.Input.ManipulationDelta> イベントは、タッチ入力の位置が変更されると発生し、一度の操作中に複数回発生することがあります。  イベントは、指を離した後にも発生します。  たとえば、ユーザーが画面上で指をドラッグすると、<xref:System.Windows.Input.ManipulationDelta> イベントは指が移動するたびに複数回発生します。  ユーザーが指を画面から離すと、<xref:System.Windows.Input.ManipulationDelta> イベントは慣性をシミュレートするために発生し続けます。  
+  
+     コードでは、ユーザーのタッチ入力に沿って移動するために、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.UIElement.RenderTransform%2A> に <xref:System.Windows.Input.ManipulationDeltaEventArgs.DeltaManipulation%2A> を適用します。  また、慣性処理中にイベントが発生したときに、<xref:System.Windows.Shapes.Rectangle> が <xref:System.Windows.Window> の境界の外側にあるかどうかもチェックします。  境界の外側にある場合、アプリケーションは <xref:System.Windows.Input.ManipulationDeltaEventArgs.Complete%2A?displayProperty=fullName> メソッドを呼び出して操作を終了します。  
+  
+     [!code-csharp[BasicManipulation#ManipulationDelta](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicmanipulation/csharp/mainwindow.xaml.cs#manipulationdelta)]
+     [!code-vb[BasicManipulation#ManipulationDelta](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicmanipulation/visualbasic/mainwindow.xaml.vb#manipulationdelta)]  
+  
+6.  `MainWindow` クラスに、次の <xref:System.Windows.UIElement.ManipulationInertiaStarting> イベント ハンドラーを追加します。  
+  
+     ユーザーが画面からすべての指を離すと、<xref:System.Windows.UIElement.ManipulationInertiaStarting> イベントが発生します。  コードにより、四角形の移動、拡大および回転に対する初期の速度と減速度が設定されます。  
+  
+     [!code-csharp[BasicManipulation#ManipulationInertiaStarting](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicmanipulation/csharp/mainwindow.xaml.cs#manipulationinertiastarting)]
+     [!code-vb[BasicManipulation#ManipulationInertiaStarting](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicmanipulation/visualbasic/mainwindow.xaml.vb#manipulationinertiastarting)]  
+  
+7.  プロジェクトをビルドして実行します。  
+  
+     ウィンドウ内に赤い正方形が表示されます。  
+  
+## アプリケーションのテスト  
+ アプリケーションをテストするには、次の操作を試します。  一度に複数の操作を試すことができます。  
+  
+-   <xref:System.Windows.Shapes.Rectangle> を移動するには、<xref:System.Windows.Shapes.Rectangle> の上に 1 本の指を置き、画面上でその指を動かします。  
+  
+-   <xref:System.Windows.Shapes.Rectangle> のサイズを変更するには、<xref:System.Windows.Shapes.Rectangle> 上に 2 本の指を置き、指どうしの距離を互いに近づけるか離します。  
+  
+-   <xref:System.Windows.Shapes.Rectangle> を回転させるには、<xref:System.Windows.Shapes.Rectangle> 上に 2 本の指を置き、互いの周りで指を回します。  
+  
+ 慣性を発生させるには、直前の操作を実行したときに画面からすばやく指を離します。  <xref:System.Windows.Shapes.Rectangle> は、停止するまでの数秒間、移動、サイズ変更または回転を続けます。  
+  
+## 参照  
+ <xref:System.Windows.UIElement.ManipulationStarting?displayProperty=fullName>   
+ <xref:System.Windows.UIElement.ManipulationDelta?displayProperty=fullName>   
+ <xref:System.Windows.UIElement.ManipulationInertiaStarting?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md b/docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md
new file mode 100644
index 00000000000..71407422ccd
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-enabling-drag-and-drop-on-a-user-control.md
@@ -0,0 +1,344 @@
+---
+title: "チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ドラッグ アンド ドロップ [WPF], チュートリアル"
+  - "チュートリアル [WPF], ドラッグ アンド ドロップ"
+ms.assetid: cc844419-1a77-4906-95d9-060d79107fc7
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# チュートリアル: ユーザー コントロールでのドラッグ アンド ドロップの有効化
+このチュートリアルでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でドラッグ アンド ドロップによるデータ転送に参加できるカスタム ユーザー コントロールを作成する方法を説明します。  
+  
+ このチュートリアルでは、円を表すカスタム WPF <xref:System.Windows.Controls.UserControl> を作成します。  コントロールに機能を実装して、ドラッグ アンド ドロップ操作でデータを転送できるようにします。  たとえば、ある Circle コントロールから別のコントロールにドラッグすると、塗りつぶしの色のデータがソースの Circle からターゲットにコピーされます。  Circle コントロールから <xref:System.Windows.Controls.TextBox> にドラッグすると、塗りつぶしの色の文字列形式が <xref:System.Windows.Controls.TextBox> にコピーされます。  2 つのパネル コントロールを含む小さなアプリケーションおよび <xref:System.Windows.Controls.TextBox> も作成して、ドラッグ アンド ドロップ機能をテストします。  また、ドロップした Circle データをパネルで処理できるようにするコードを記述します。これにより、あるパネルの子コレクションから別の場所に Circle を移動またはコピーできるようになります。  
+  
+ このチュートリアルでは、次の作業について説明します。  
+  
+-   カスタム ユーザー コントロールを作成する。  
+  
+-   ユーザー コントロールがドラッグ ソースになるようにする。  
+  
+-   ユーザー コントロールがドロップ ターゲットになるようにする。  
+  
+-   ユーザー コントロールからドロップされたデータをパネルで受け取ることができるようにする。  
+  
+## 必要条件  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   Visual Studio 2010  
+  
+## アプリケーション プロジェクトの作成  
+ このセクションでは、2 つのパネルを備えたメイン ページおよび <xref:System.Windows.Controls.TextBox> が含まれるアプリケーション インフラストラクチャを作成します。  
+  
+### プロジェクトを作成するには  
+  
+1.  Visual Basic または Visual C\# で `DragDropExample` という名前の新しい WPF アプリケーション プロジェクトを作成します。  詳細については、「[方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)」を参照してください。  
+  
+2.  MainWindow.xaml を開きます。  
+  
+3.  <xref:System.Windows.Controls.Grid> の開始タグと終了タグの間に、次のマークアップを追加します。  
+  
+     このマークアップは、テスト アプリケーションのユーザー インターフェイスを作成します。  
+  
+     [!code-xml[DragDropWalkthrough#PanelsStep1XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/SnippetWindow.xaml#panelsstep1xaml)]  
+  
+## プロジェクトへの新しいユーザー コントロールの追加  
+ ここでは、プロジェクトに新しいユーザー コントロールを追加します。  
+  
+### 新しいユーザー コントロールを追加するには  
+  
+1.  \[プロジェクト\] メニューの **\[ユーザー コントロールの追加\]** をクリックします。  
+  
+2.  \[新しい項目の追加\] ダイアログ ボックスで、名前を `Circle.xaml` に変更し、**\[追加\]** をクリックします。  
+  
+     Circle.xaml とその分離コードがプロジェクトに追加されます。  
+  
+3.  Circle.xaml を開きます。  
+  
+     このファイルには、ユーザー コントロールのユーザー インターフェイス要素が含まれます。  
+  
+4.  次のマークアップをルート <xref:System.Windows.Controls.Grid> に追加し、青い円を UI とした単純なユーザー コントロールを作成します。  
+  
+     [!code-xml[DragDropWalkthrough#EllipseXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml#ellipsexaml)]  
+  
+5.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+6.  C\# で、既定のコンストラクターの後に次のコードを追加して、コピー コンストラクターを作成します。  Visual Basic で、次のコードを追加して、既定のコンストラクターとコピー コンストラクターの両方を作成します。  
+  
+     ユーザー コントロールをコピーできるようにするために、分離コード ファイルで、コピー コンストラクター メソッドを追加します。  簡素化された Circle ユーザー コントロールでは、塗りつぶしとユーザー コントロールのサイズのみをコピーします。  
+  
+     [!code-csharp[DragDropWalkthrough#CopyCtor](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#copyctor)]
+     [!code-vb[DragDropWalkthrough#CopyCtor](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#copyctor)]  
+  
+### メイン ウィンドウにユーザー コントロールを追加するには  
+  
+1.  MainWindow.xaml を開きます。  
+  
+2.  次の XAML を <xref:System.Windows.Window> の開始タグに追加して、現在のアプリケーションへの XML 名前空間参照を作成します。  
+  
+    ```  
+    xmlns:local="clr-namespace:DragDropExample"  
+    ```  
+  
+3.  最初の <xref:System.Windows.Controls.StackPanel> で、次の XAML を追加して、最初のパネルに Circle ユーザー コントロールの 2 つのインスタンスを作成します。  
+  
+     [!code-xml[DragDropWalkthrough#CirclesXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/SnippetWindow.xaml#circlesxaml)]  
+  
+     パネルの完全な XAML は次のようになります。  
+  
+     [!code-xml[DragDropWalkthrough#PanelsStep2XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/SnippetWindow.xaml#panelsstep2xaml)]  
+  
+## ユーザー コントロールでのドラッグ ソース イベントの実装  
+ ここでは、ドラッグ ソースのイベント ハンドラーで、<xref:System.Windows.UIElement.OnMouseMove%2A> メソッドをオーバーライドして、ドラッグ アンド ドロップ操作を開始します。  
+  
+ ドラッグを開始すると \(マウス ボタンを押しながらマウスを動かすと\)、転送するデータを <xref:System.Windows.DataObject> にパッケージ化することになります。  ここでは、塗りつぶしの色の文字列形式、高さの double 型形式、およびコピーという 3 つのデータ項目を、Circle コントロールがパッケージ化します。  
+  
+### ドラッグ アンド ドロップ操作を開始するには  
+  
+1.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+2.  次の <xref:System.Windows.UIElement.OnMouseMove%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.MouseMove> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnMouseMove](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#onmousemove)]
+     [!code-vb[DragDropWalkthrough#OnMouseMove](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#onmousemove)]  
+  
+     この <xref:System.Windows.UIElement.OnMouseMove%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   マウスを動かしながらマウスの左ボタンを押しているかどうかをチェックします。  
+  
+    -   Circle データを <xref:System.Windows.DataObject> にパッケージ化します。  ここでは、塗りつぶしの色、高さの double 型形式、およびコピーという 3 つのデータ項目を、Circle コントロールがパッケージ化します。  
+  
+    -   ドラッグ アンド ドロップ操作を開始するための静的な <xref:System.Windows.DragDrop.DoDragDrop%2A?displayProperty=fullName> メソッドを呼び出します。  次の 3 つのパラメーターを <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドに渡します。  
+  
+        -   `dragSource` – このコントロールへの参照。  
+  
+        -   `data` – 前のコードで作成された <xref:System.Windows.DataObject>。  
+  
+        -   `allowedEffects` – 有効なドラッグ アンド ドロップ操作 \(<xref:System.Windows.DragDropEffects> または <xref:System.Windows.DragDropEffects>\)。  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+4.  Circle コントロールを 1 つクリックして、パネル、他の Circle、および <xref:System.Windows.Controls.TextBox> の上にドラッグします。  <xref:System.Windows.Controls.TextBox> の上にドラッグすると、カーソルが変化して移動を示します。  
+  
+5.  Circle を <xref:System.Windows.Controls.TextBox> の上にドラッグしながら、Ctrl キーを押します。  カーソルが変化してコピーを示すようになります。  
+  
+6.  Circle を <xref:System.Windows.Controls.TextBox> にドラッグ アンド ドロップします。  Circle の塗りつぶしの色の文字列形式が <xref:System.Windows.Controls.TextBox> に追加されます。  
+  
+     ![Circle の塗りつぶしの色の文字列形式](../../../../docs/framework/wpf/advanced/media/dragdrop-colorstring.png "DragDrop\_ColorString")  
+  
+ 既定では、ドラッグ アンド ドロップ操作中にカーソルが変化して、データのドロップによって適用される効果を示します。  ユーザーに示されるフィードバックは、<xref:System.Windows.UIElement.GiveFeedback> イベントを処理して別のカーソルを設定することによってカスタマイズできます。  
+  
+### ユーザーにフィードバックを示すには  
+  
+1.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+2.  次の <xref:System.Windows.UIElement.OnGiveFeedback%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.GiveFeedback> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnGiveFeedback](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#ongivefeedback)]
+     [!code-vb[DragDropWalkthrough#OnGiveFeedback](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#ongivefeedback)]  
+  
+     この <xref:System.Windows.UIElement.OnGiveFeedback%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   ドロップ ターゲットの <xref:System.Windows.UIElement.DragOver> イベント ハンドラーに設定された <xref:System.Windows.GiveFeedbackEventArgs.Effects%2A> の値をチェックします。  
+  
+    -   <xref:System.Windows.GiveFeedbackEventArgs.Effects%2A> の値に基づいて、カスタム カーソルを設定します。  このカーソルは、データのドロップによって適用される効果についての視覚的フィードバックをユーザーに示すためのものです。  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+4.  パネル、他の Circle、および <xref:System.Windows.Controls.TextBox> の上に、Circle コントロールを 1 つドラッグします。  カーソルは、<xref:System.Windows.UIElement.OnGiveFeedback%2A> オーバーライドで指定したカスタム カーソルになっています。  
+  
+     ![カスタム カーソルによるドラッグ アンド ドロップ](../../../../docs/framework/wpf/advanced/media/dragdrop-customcursor.png "DragDrop\_CustomCursor")  
+  
+5.  <xref:System.Windows.Controls.TextBox> で `green` というテキストを選択します。  
+  
+6.  `green` というテキストを Circle コントロールにドラッグします。  既定のカーソルが表示されて、ドラッグ アンド ドロップ操作の効果を示します。  フィードバックのカーソルは、常にドラッグ ソースによって設定されます。  
+  
+## ユーザー コントロールでのドロップ ターゲット イベントの実装  
+ ここでは、ユーザー コントロールがドロップ ターゲットであることを指定し、ユーザー コントロールがドロップ ターゲットになるようにするメソッドをオーバーライドして、ドロップするデータを処理します。  
+  
+### ユーザー コントロールがドロップ ターゲットになるようにするには  
+  
+1.  Circle.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.UserControl> の開始タグで、<xref:System.Windows.UIElement.AllowDrop%2A> プロパティを追加して `true` に設定します。  
+  
+     [!code-xml[DragDropWalkthrough#UCTagXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml#uctagxaml)]  
+  
+ <xref:System.Windows.UIElement.AllowDrop%2A> プロパティが `true` に設定され、ドラッグ ソースのデータが Circle ユーザー コントロール上にドロップされると、<xref:System.Windows.UIElement.OnDrop%2A> メソッドが呼び出されます。  この方法では、ドロップされたデータを処理して、そのデータを Circle に適用します。  
+  
+### ドロップされたデータを処理するには  
+  
+1.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+2.  次の <xref:System.Windows.UIElement.OnDrop%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.Drop> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnDrop](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#ondrop)]
+     [!code-vb[DragDropWalkthrough#OnDrop](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#ondrop)]  
+  
+     この <xref:System.Windows.UIElement.OnDrop%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   <xref:System.Windows.DataObject.GetDataPresent%2A> メソッドを使用して、ドラッグされたデータに文字列オブジェクトが含まれているかどうかをチェックします。  
+  
+    -   <xref:System.Windows.DataObject.GetData%2A> メソッドを使用して、文字列データが存在する場合はその文字列データを抽出します。  
+  
+    -   <xref:System.Windows.Media.BrushConverter> を使用して、文字列から <xref:System.Windows.Media.Brush> への変換を試みます。  
+  
+    -   変換が成功した場合は、Circle コントロールの UI を提供する <xref:System.Windows.Shapes.Ellipse> の <xref:System.Windows.Shapes.Shape.Fill%2A> にそのブラシを適用します。  
+  
+    -   <xref:System.Windows.UIElement.Drop> イベントを処理済みとしてマークします。  ドロップ イベントが Circle ユーザー コントロールによって処理済みであることをこのドロップ イベントを受け取る他の要素で認識できるようにするために、ドロップ イベントを処理済みとしてマークする必要があります。  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+4.  <xref:System.Windows.Controls.TextBox> で `green` というテキストを選択します。  
+  
+5.  このテキストを Circle コントロールにドラッグしてドロップします。  Circle が青から緑に変わります。  
+  
+     ![ブラシへの文字列の変換](../../../../docs/framework/wpf/advanced/media/dragdrop-dropgreentext.png "DragDrop\_DropGreenText")  
+  
+6.  `green` というテキストを <xref:System.Windows.Controls.TextBox> に入力します。  
+  
+7.  <xref:System.Windows.Controls.TextBox> で `gre` というテキストを選択します。  
+  
+8.  このテキストを Circle コントロールにドラッグしてドロップします。  カーソルが変化し、ドロップが有効であることが示されますが、`gre` は有効な色ではないので Circle の色は変わりません。  
+  
+9. 緑の Circle コントロールからドラッグして、青の Circle コントロールにドロップします。  Circle が青から緑に変わります。  表示されるカーソルは、<xref:System.Windows.Controls.TextBox> または Circle のどちらがドラッグ ソースであるかによって異なります。  
+  
+ ある要素をドロップ ターゲットにするために必要なことは、<xref:System.Windows.UIElement.AllowDrop%2A> プロパティを `true` に設定し、ドロップされたデータを処理することです。  ただし、ユーザー エクスペリエンスを向上させるためには、<xref:System.Windows.UIElement.DragEnter>、<xref:System.Windows.UIElement.DragLeave>、および <xref:System.Windows.UIElement.DragOver> の各イベントも処理する必要があります。  これらのイベントでは、データのドロップ前に、チェックを実行して追加のフィードバックをユーザーに提供することができます。  
+  
+ データが Circle ユーザー コントロール上にドラッグされると、このコントロールは、ドラッグされたデータが処理可能であるかどうかをドラッグ ソースに通知します。  このコントロールは、データの処理方法が不明な場合、ドロップを拒否します。  これを行うには、<xref:System.Windows.UIElement.DragOver> イベントを処理して、<xref:System.Windows.DragEventArgs.Effects%2A> プロパティを設定します。  
+  
+### データ ドロップが有効であることを確認するには  
+  
+1.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+2.  次の <xref:System.Windows.UIElement.OnDragOver%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.DragOver> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnDragOver](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#ondragover)]
+     [!code-vb[DragDropWalkthrough#OnDragOver](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#ondragover)]  
+  
+     この <xref:System.Windows.UIElement.OnDragOver%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   <xref:System.Windows.DragEventArgs.Effects%2A> プロパティを <xref:System.Windows.DragDropEffects> に設定します。  
+  
+    -   <xref:System.Windows.UIElement.OnDrop%2A> メソッドの場合と同じチェックを実行して、ドラッグされたデータを Circle ユーザー コントロールで処理できるかどうかを判断します。  
+  
+    -   ユーザー コントロールでデータを処理できる場合は、<xref:System.Windows.DragEventArgs.Effects%2A> プロパティを <xref:System.Windows.DragDropEffects> または <xref:System.Windows.DragDropEffects> に設定します。  
+  
+3.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+4.  <xref:System.Windows.Controls.TextBox> で `gre` というテキストを選択します。  
+  
+5.  このテキストを Circle コントロールにドラッグします。  カーソルが変化し、ドロップが有効でないことが示されます。これは、`gre` が有効な色ではないためです。  
+  
+ ドロップ操作のプレビューを適用することにより、ユーザー エクスペリエンスをさらに向上させることができます。  Circle ユーザー コントロールについて、<xref:System.Windows.UIElement.OnDragEnter%2A> メソッドと <xref:System.Windows.UIElement.OnDragLeave%2A> メソッドをオーバーライドします。  データをコントロール上にドラッグしたときに、現在の背景の <xref:System.Windows.Shapes.Shape.Fill%2A> がプレースホルダーの変数に保存されます。  その文字列がブラシに変換されて、Circle の UI を提供する <xref:System.Windows.Shapes.Ellipse> に適用されます。  データがドロップされることなく Circle の外へドラッグされると、元の <xref:System.Windows.Shapes.Shape.Fill%2A> の値が Circle に再び適用されます。  
+  
+### ドラッグ アンド ドロップ操作の効果をプレビューするには  
+  
+1.  Circle.xaml.cs または Circle.xaml.vb を開きます。  
+  
+2.  Circle クラスで、`_previousFill` という名前のプライベート <xref:System.Windows.Media.Brush> 変数を宣言し、`null` に初期化します。  
+  
+     [!code-csharp[DragDropWalkthrough#Brush](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#brush)]
+     [!code-vb[DragDropWalkthrough#Brush](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#brush)]  
+  
+3.  次の <xref:System.Windows.UIElement.OnDragEnter%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.DragEnter> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnDragEnter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#ondragenter)]
+     [!code-vb[DragDropWalkthrough#OnDragEnter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#ondragenter)]  
+  
+     この <xref:System.Windows.UIElement.OnDragEnter%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   <xref:System.Windows.Shapes.Ellipse> の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを `_previousFill` 変数に保存します。  
+  
+    -   <xref:System.Windows.UIElement.OnDrop%2A> メソッドの場合と同じチェックを実行して、データを <xref:System.Windows.Media.Brush> に変換できるかどうかを判断します。  
+  
+    -   データが有効な <xref:System.Windows.Media.Brush> に変換される場合は、<xref:System.Windows.Shapes.Ellipse> の <xref:System.Windows.Shapes.Shape.Fill%2A> に適用します。  
+  
+4.  次の <xref:System.Windows.UIElement.OnDragLeave%2A> オーバーライドを追加して、<xref:System.Windows.UIElement.DragLeave> イベントにクラス処理を提供します。  
+  
+     [!code-csharp[DragDropWalkthrough#OnDragLeave](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/Circle.xaml.cs#ondragleave)]
+     [!code-vb[DragDropWalkthrough#OnDragLeave](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/Circle.xaml.vb#ondragleave)]  
+  
+     この <xref:System.Windows.UIElement.OnDragLeave%2A> オーバーライドは、次のタスクを実行します。  
+  
+    -   `_previousFill` 変数に保存された <xref:System.Windows.Media.Brush> を、Circle ユーザー コントロールの UI を提供する <xref:System.Windows.Shapes.Ellipse> の <xref:System.Windows.Shapes.Shape.Fill%2A> に適用します。  
+  
+5.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+6.  <xref:System.Windows.Controls.TextBox> で `green` というテキストを選択します。  
+  
+7.  このテキストを Circle コントロール上にドラッグしますが、ドロップしません。  Circle が青から緑に変わります。  
+  
+     ![ドラッグ アンド ドロップ操作の効果のプレビュー](../../../../docs/framework/wpf/advanced/media/dragdrop-previeweffects.png "DragDrop\_PreviewEffects")  
+  
+8.  このテキストを Circle コントロールから離れた位置にドラッグします。  Circle が緑から青に戻ります。  
+  
+## ドロップされたデータをパネルで受け取ることの有効化  
+ ここでは、Circle ユーザー コントロールをホストするパネルを、ドラッグされた Circle データのドロップ ターゲットとして機能するようにします。  あるパネルから別のパネルに Circle を移動すること、または Ctrl キーを押しながら Circle をドラッグ アンド ドロップして Circle コントロールのコピーを作成することを可能にするコードを実装します。  
+  
+### パネルがドロップ ターゲットになるようにするには  
+  
+1.  MainWindow.xaml を開きます。  
+  
+2.  次の XAML に示すように、それぞれの <xref:System.Windows.Controls.StackPanel> コントロールで、<xref:System.Windows.UIElement.DragOver> イベントおよび <xref:System.Windows.UIElement.Drop> イベント用のハンドラーを追加します。  <xref:System.Windows.UIElement.DragOver> イベント ハンドラーに `panel_DragOver` という名前、<xref:System.Windows.UIElement.Drop> イベント ハンドラーに `panel_Drop` という名前を付けます。  
+  
+     [!code-xml[DragDropWalkthrough#PanelsXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/MainWindow.xaml#panelsxaml)]  
+  
+3.  MainWindows.xaml.cs または MainWindow.xaml.vb を開きます。  
+  
+4.  <xref:System.Windows.UIElement.DragOver> イベント ハンドラーに次のコードを追加します。  
+  
+     [!code-csharp[DragDropWalkthrough#PanelDragOver](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/MainWindow.xaml.cs#paneldragover)]
+     [!code-vb[DragDropWalkthrough#PanelDragOver](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/MainWindow.xaml.vb#paneldragover)]  
+  
+     この <xref:System.Windows.UIElement.DragOver> イベント ハンドラーは、次のタスクを実行します。  
+  
+    -   Circle ユーザー コントロールによって <xref:system.Windows.DataObject> にパッケージ化され、<xref:System.Windows.DragDrop.DoDragDrop%2A> の呼び出しに渡される "オブジェクト" データが、ドラッグされたデータに含まれていることをチェックします。  
+  
+    -   "オブジェクト" データがある場合は、Ctrl キーが押されているかどうかをチェックします。  
+  
+    -   Ctrl キーが押されている場合は、<xref:System.Windows.DragEventArgs.Effects%2A> プロパティを <xref:System.Windows.DragDropEffects> に設定します。  それ以外の場合は、<xref:System.Windows.DragEventArgs.Effects%2A> プロパティを <xref:System.Windows.DragDropEffects> に設定します。  
+  
+5.  <xref:System.Windows.UIElement.Drop> イベント ハンドラーに次のコードを追加します。  
+  
+     [!code-csharp[DragDropWalkthrough#PanelDrop](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DragDropWalkthrough/CS/MainWindow.xaml.cs#paneldrop)]
+     [!code-vb[DragDropWalkthrough#PanelDrop](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DragDropWalkthrough/VB/MainWindow.xaml.vb#paneldrop)]  
+  
+     この <xref:System.Windows.UIElement.Drop> イベント ハンドラーは、次のタスクを実行します。  
+  
+    -   <xref:System.Windows.UIElement.Drop> イベントが処理されたかどうかをチェックします。  たとえば、ある Circle が <xref:System.Windows.UIElement.Drop> イベントを処理する別の Circle 上にドロップされた場合、その Circle を含むパネルではイベントを処理しないようにしたいと考えるものです。  
+  
+    -   <xref:System.Windows.UIElement.Drop> イベントが処理されない場合は、Ctrl キーが押されているかどうかをチェックします。  
+  
+    -   <xref:System.Windows.UIElement.Drop> イベントの発生時に Ctrl キーが押されている場合は、Circle コントロールのコピーを作成して、<xref:System.Windows.Controls.StackPanel> の <xref:System.Windows.Controls.Panel.Children%2A> コレクションに追加します。  
+  
+    -   Ctrl キーが押されていない場合は、Circle を親パネルの <xref:System.Windows.Controls.Panel.Children%2A> コレクションから、ドロップ先のパネルの <xref:System.Windows.Controls.Panel.Children%2A> コレクションに移動します。  
+  
+    -   <xref:System.Windows.DragEventArgs.Effects%2A> プロパティを設定して、移動操作またはコピー操作が実行されたことを <xref:System.Windows.DragDrop.DoDragDrop%2A> メソッドに通知します。  
+  
+6.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+7.  <xref:System.Windows.Controls.TextBox> で `green` というテキストを選択します。  
+  
+8.  このテキストを Circle コントロール上にドラッグしてドロップします。  
+  
+9. Circle コントロールを左側のパネルから右側のパネルにドラッグしてドロップします。  Circle が、左側のパネルの <xref:System.Windows.Controls.Panel.Children%2A> コレクションから削除され、右側のパネルの子コレクションに追加されます。  
+  
+10. Ctrl キーを押しながら、Circle コントロールがあるパネルから別のパネルに Circle コントロールをドラッグしてドロップします。  Circle がコピーされ、そのコピーが、受け取る側のパネルの <xref:System.Windows.Controls.Panel.Children%2A> コレクションに追加されます。  
+  
+     ![Ctrl キーを押しながら Circle をドラッグ](../../../../docs/framework/wpf/advanced/media/dragdrop-paneldrop.png "DragDrop\_PanelDrop")  
+  
+## 参照  
+ [ドラッグ アンド ドロップの概要](../../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md
new file mode 100644
index 00000000000..06b79466dcd
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md
@@ -0,0 +1,104 @@
+---
+title: "チュートリアル: Windows フォームでの 3D WPF 複合コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複合コントロール, ホスト (WPF を)"
+  - "ホスト (Windows フォームの WPF コンテンツを)"
+ms.assetid: 486369a9-606a-4a3b-b086-a06f2119c7b0
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# チュートリアル: Windows フォームでの 3D WPF 複合コントロールのホスト
+このチュートリアルでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールを作成し、それを <xref:System.Windows.Forms.Integration.ElementHost> コントロールを使用して [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のコントロールおよびフォームでホストする方法を示します。  
+  
+ ここでは、2 つの子コントロールを含む [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.UserControl> を実装します。  <xref:System.Windows.Controls.UserControl> は、3 次元 \(3\-D\) の円錐形を表示します。  3\-D オブジェクトのレンダリングは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]より [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で行う方がはるかに簡単です。  したがって、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.UserControl> クラスをホストして 3\-D グラフィックスを作成することには意味があります。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.UserControl> の作成  
+  
+-   Windows フォームのホスト プロジェクトの作成  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.UserControl> のホスト  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[Windows フォームでの 3\-D WPF 複合コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160001)を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)].  
+  
+<a name="To_Create_the_UserControl"></a>   
+## UserControl の作成  
+  
+#### UserControl を作成するには  
+  
+1.  `HostingWpfUserControlInWf` という名前の WPF ユーザー コントロール ライブラリ プロジェクトを作成します。  
+  
+2.  [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]で UserControl1.xaml を開きます。  
+  
+3.  生成されているコードを次のコードに置き換えます。  
+  
+     このコードでは、2 つの子コントロールを含む <xref:System.Windows.Controls.UserControl?displayProperty=fullName> が定義されています。  1 番目の子コントロールは <xref:System.Windows.Controls.Label?displayProperty=fullName> コントロールで、2 番目は 3\-D の円錐形を表示する <xref:System.Windows.Controls.Viewport3D> コントロールです。  
+  
+     [!code-xml[HostingWpfUserControlInWf#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWpfUserControlInWf/CSharp/HostingWpfUserControlInWf/ConeControl.xaml#1)]  
+  
+<a name="To_Create_the_Windows_Forms_Host_Project"></a>   
+## Windows フォームのホスト プロジェクトの作成  
+  
+#### ホスト プロジェクトを作成するには  
+  
+1.  `WpfUserControlHost` という名前の Windows アプリケーション プロジェクトをソリューションに追加します。  詳細については、「[方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)」を参照してください。  
+  
+2.  ソリューション エクスプローラーで、WindowsFormsIntegration.dll という名前の WindowsFormsIntegration アセンブリへの参照を追加します。  
+  
+3.  次の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アセンブリへの参照を追加します。  
+  
+    -   PresentationCore  
+  
+    -   PresentationFramework  
+  
+    -   WindowsBase  
+  
+4.  `HostingWpfUserControlInWf` プロジェクトへの参照を追加します。  
+  
+5.  ソリューション エクスプローラーで、`WpfUserControlHost` プロジェクトをスタートアップ プロジェクトとして設定します。  
+  
+<a name="To_Host_the_Windows_Presentation_Foundation"></a>   
+## Windows Presentation Foundation UserControl のホスト  
+  
+#### UserControl をホストするには  
+  
+1.  Windows フォーム デザイナーで、Form1 を開きます。  
+  
+2.  \[プロパティ\] ウィンドウで、\[イベント\] をクリックし、<xref:System.Windows.Forms.Form.Load> イベントをダブルクリックしてイベント ハンドラーを作成します。  
+  
+     コード エディターで、新しく生成された `Form1_Load` イベント ハンドラーが開かれます。  
+  
+3.  Form1.cs 内のコードを次のコードに置き換えます。  
+  
+     `Form1_Load` イベント ハンドラーは、`UserControl1` のインスタンスを作成し、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの子コントロールのコレクションにそれを追加します `` 。  フォームの子コントロールのコレクションには、<xref:System.Windows.Forms.Integration.ElementHost> コントロールが追加されます。  
+  
+     [!code-csharp[HostingWpfUserControlInWf#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWpfUserControlInWf/CSharp/WpfUserControlHost/Form1.cs#10)]
+     [!code-vb[HostingWpfUserControlInWf#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HostingWpfUserControlInWf/VisualBasic/WpfUserControlHost/Form1.vb#10)]  
+  
+4.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [Windows フォームでの WPF 複合コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160001)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md
new file mode 100644
index 00000000000..be8e189b5bb
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md
@@ -0,0 +1,164 @@
+---
+title: "チュートリアル: WPF での Win32 コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (Win32 コントロールを WPF で) "
+  - "Win32 コード, WPF 相互運用"
+ms.assetid: a676b1eb-fc55-4355-93ab-df840c41cea0
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# チュートリアル: WPF での Win32 コントロールのホスト
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] のコードに多くの投資を行った場合は、元のコードを全面的に記述し直すよりも、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのコードの少なくとも一部を再利用する方が効率的である場合があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページで [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウをホストするためのわかりやすいメカニズムが用意されています。  
+  
+ このトピックでは、[WPF での Win32 ListBox コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159998)に示されている、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] リスト ボックス コントロールをホストするアプリケーションについて説明します。  この一般的な手順を拡張することにより、どの [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウでもホストできます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="requirements"></a>   
+## 要件  
+ このトピックは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] および [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] のプログラミングに関する基本的な知識があることを前提としています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プログラミングの概要については、「[作業の開始](../../../../docs/framework/wpf/getting-started/index.md)」を参照してください。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プログラミングの概要については多数の書籍が出版されているので、それらを参照してください。特に、『プログラミング Windows』\(Charles Petzold 著\) が参考になります。  
+  
+ このトピックに含まれるサンプルは [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] で実装されるので、[!INCLUDE[TLA#tla_pinvoke](../../../../includes/tlasharptla-pinvoke-md.md)] を利用して、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] にアクセスします。  [!INCLUDE[TLA2#tla_pinvoke](../../../../includes/tla2sharptla-pinvoke-md.md)] の知識は役立ちますが、必須ではありません。  
+  
+> [!NOTE]
+>  このトピックには、関連するサンプルからのコード例が数多く含まれています。  ただし、読みやすさのために、完全なサンプル コードは含まれていません。  コード全体については、[WPF での Win32 ListBox コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159998)を参照してください。  
+  
+<a name="basic_procedure"></a>   
+## 基本手順  
+ ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページで [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウをホストするための基本手順を説明します。  残りのセクションでは、各手順の詳細について説明します。  
+  
+ 基本的なホスト手順は次のとおりです。  
+  
+1.  ウィンドウをホストする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページを実装します。  1 つの方法は、<xref:System.Windows.Controls.Border> 要素を作成し、ホストされるウィンドウのページのセクションを予約することです。  
+  
+2.  <xref:System.Windows.Interop.HwndHost> から継承するコントロールをホストするクラスを実装します。  
+  
+3.  そのクラスで、<xref:System.Windows.Interop.HwndHost> クラス メンバーの <xref:System.Windows.Interop.HwndHost.BuildWindowCore%2A> をオーバーライドします。  
+  
+4.  ホストされるウィンドウを、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページを含むウィンドウの子として作成します。  従来の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プログラミングでは明示的に利用する必要はありませんが、ホストするページは、ハンドル \(HWND\) を持つウィンドウです。  ページの HWND は、<xref:System.Windows.Interop.HwndHost.BuildWindowCore%2A> メソッドの `hwndParent` パラメーターを通じて受け取ります。  ホストされるウィンドウは、この HWND の子として作成する必要があります。  
+  
+5.  ホスト ウィンドウを作成したら、ホストされるウィンドウの HWND を返します。  1 つ以上の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールをホストする場合、通常は、ホスト ウィンドウを HWND の子として作成し、コントロールをそのホスト ウィンドウの子にします。  複数のコントロールを 1 つのホスト ウィンドウにラップすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページでそれらのコントロールから通知を受信することが簡素化され、HWND 境界を越えた通知に関する [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] での問題を処理できます。  
+  
+6.  子コントロールからの通知など、ホスト ウィンドウに送信されたメッセージを選択して処理します。  これには、2 つの方法があります。  
+  
+    -   ホストするクラスでメッセージを処理する場合は、<xref:System.Windows.Interop.HwndHost> クラスの <xref:System.Windows.Interop.HwndHost.WndProc%2A> メソッドをオーバーライドします。  
+  
+    -   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でメッセージを処理する場合は、分離コードで <xref:System.Windows.Interop.HwndHost> クラスの <xref:System.Windows.Interop.HwndHost.MessageHook> イベントを処理します。  このイベントは、ホストされるウィンドウで受信されるメッセージごとに発生します。  このオプションを選択する場合でも <xref:System.Windows.Interop.HwndHost.WndProc%2A> をオーバーライドする必要がありますが、最小限の実装だけで十分です。  
+  
+7.  <xref:System.Windows.Interop.HwndHost> の <xref:System.Windows.Interop.HwndHost.DestroyWindowCore%2A> メソッドと <xref:System.Windows.Interop.HwndHost.WndProc%2A> メソッドをオーバーライドします。  <xref:System.Windows.Interop.HwndHost> コントラクトを満たすためにはこれらのメソッドをオーバーライドする必要がありますが、場合によっては最小限の実装だけで十分です。  
+  
+8.  分離コード ファイルで、コントロール ホスト クラスのインスタンスを作成し、ウィンドウをホストする目的の <xref:System.Windows.Controls.Border> 要素の子にします。  
+  
+9. ホストされるウィンドウに [!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] メッセージを送信し、コントロールから送信された通知など、その子ウィンドウからのメッセージを処理して、そのウィンドウと通信します。  
+  
+<a name="page_layout"></a>   
+## ページ レイアウトの実装  
+ ListBox コントロールをホストする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページのレイアウトは、2 つの領域で構成されます。  ページの左側では、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールを操作するための[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を提供する、いくつかの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールをホストします。  ページの右上隅には、ホストされる ListBox コントロールを表す正方形の領域があります。  
+  
+ このレイアウトを実装するコードは、非常に単純です。  ルート要素は、2 つの子要素を持つ <xref:System.Windows.Controls.DockPanel> です。  1 つ目は、ListBox コントロールをホストする <xref:System.Windows.Controls.Border> 要素です。  これは、ページの右上隅の 200 × 200 の正方形部分を使用します。  2 つ目は、情報を表示したり、公開されている相互運用プロパティを設定して ListBox コントロールを操作できる一連の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールを含む <xref:System.Windows.Controls.StackPanel> 要素です。  <xref:System.Windows.Controls.StackPanel> の子である各要素については、どのような要素があり、それらが何を実行するかについての詳細について、使用されている各要素のリファレンス資料で参照してください。これらの要素は、次のサンプル コードにリストされていますが、ここでは説明しません \(それらは基本相互運用モデルには不要で、サンプルの対話性を強化するために提供されています\)。  
+  
+ [!code-xml[WPFHostingWin32Control#WPFUI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/Page1.xaml#wpfui)]  
+  
+<a name="host_class"></a>   
+## Microsoft Win32 コントロールをホストするクラスの実装  
+ このサンプルの中核は、コントロールを実際にホストする ControlHost.cs というクラスです。  このクラスは、<xref:System.Windows.Interop.HwndHost> から継承されます。  コンストラクターは、高さと幅の 2 つのパラメーターを使用します。これらのパラメーターは、ListBox コントロールをホストする <xref:System.Windows.Controls.Border> 要素の高さと幅に対応します。  これらの値を後から使用して、コントロールのサイズが <xref:System.Windows.Controls.Border> 要素と一致するようにします。  
+  
+ [!code-csharp[WPFHostingWin32Control#ControlHostClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#controlhostclass)]
+ [!code-vb[WPFHostingWin32Control#ControlHostClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#controlhostclass)]  
+  
+ また、一連の定数もあります。  これらの定数の多くは Winuser.h から取得され、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 関数を呼び出すときには従来の名前を使用できます。  
+  
+ [!code-csharp[WPFHostingWin32Control#ControlHostConstants](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#controlhostconstants)]
+ [!code-vb[WPFHostingWin32Control#ControlHostConstants](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#controlhostconstants)]  
+  
+<a name="buildwindowcore"></a>   
+### Microsoft Win32 ウィンドウを作成するための BuildWindowCore のオーバーライド  
+ このメソッドをオーバーライドして、ページでホストされる [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウを作成し、ウィンドウとページの間を接続します。  このサンプルでは ListBox コントロールをホストするため、2 つのウィンドウが作成されます。  1 つは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページで実際にホストされるウィンドウです。  ListBox コントロールは、そのウィンドウの子として作成されます。  
+  
+ この方法を使用するのは、コントロールから通知を受信するプロセスを簡単にするためです。  <xref:System.Windows.Interop.HwndHost> クラスを使用することにより、ホストしているウィンドウに送信されるメッセージを処理できます。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールを直接ホストする場合は、コントロールの内部メッセージ ループに送信されたメッセージを受信します。  コントロールを表示してそのコントロールにメッセージを送信できますが、コントロールがその親ウィンドウに送信する通知は受信されません。  これが意味することはいくつかありますが、その 1 つは、ユーザーがコントロールと対話していることを検出する手段がないことです。  そのため、代わりにホスト ウィンドウを作成し、コントロールをそのウィンドウの子にします。  この方法を使用すると、コントロールがホスト ウィンドウに対して送信する通知を含め、ホスト ウィンドウのメッセージを処理できます。  ホスト ウィンドウは、コントロールの単純なラッパーとほとんど変わりないため、便宜上、パッケージは ListBox コントロールとして参照されます。  
+  
+<a name="create_the_window_and_listbox"></a>   
+#### ホスト ウィンドウと ListBox コントロールの作成  
+ [!INCLUDE[TLA2#tla_pinvoke](../../../../includes/tla2sharptla-pinvoke-md.md)] を使用して、ウィンドウ クラスを作成、登録するなどの方法で、コントロールのホスト ウィンドウを作成できます。  ただし、定義済みの "静的" ウィンドウ クラスを使用してウィンドウを作成した方がはるかに簡単です。  この方法では、コントロールから通知を受信するために必要なウィンドウ プロシージャが提供されるので、最小限のコーディングだけで済みます。  
+  
+ コントロールの HWND は読み取り専用プロパティを通じて公開されるため、ホスト ページは HWND を使用してコントロールにメッセージを送信できます。  
+  
+ [!code-csharp[WPFHostingWin32Control#IntPtrProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#intptrproperty)]
+ [!code-vb[WPFHostingWin32Control#IntPtrProperty](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#intptrproperty)]  
+  
+ ListBox コントロールは、ホスト ウィンドウの子として作成されます。  両方のウィンドウの高さと幅は、既に説明したように、コンストラクターに渡される値に設定されます。  このため、ホスト ウィンドウとコントロールのサイズは、ページ上の予約された領域と同じになります。  ウィンドウが作成されると、このサンプルでは、ホスト ウィンドウの HWND を含む <xref:System.Runtime.InteropServices.HandleRef> オブジェクトが返されます。  
+  
+ [!code-csharp[WPFHostingWin32Control#BuildWindowCore](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#buildwindowcore)]
+ [!code-vb[WPFHostingWin32Control#BuildWindowCore](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#buildwindowcore)]  
+  
+ [!code-csharp[WPFHostingWin32Control#BuildWindowCoreHelper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#buildwindowcorehelper)]
+ [!code-vb[WPFHostingWin32Control#BuildWindowCoreHelper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#buildwindowcorehelper)]  
+  
+<a name="destroywindow_wndproc"></a>   
+### DestroyWindow と WndProc の実装  
+ <xref:System.Windows.Interop.HwndHost.BuildWindowCore%2A> に加え、<xref:System.Windows.Interop.HwndHost> の <xref:System.Windows.Interop.HwndHost.WndProc%2A> メソッドと <xref:System.Windows.Interop.HwndHost.DestroyWindowCore%2A> メソッドもオーバーライドする必要があります。  この例では、コントロールのメッセージが <xref:System.Windows.Interop.HwndHost.MessageHook> ハンドラーで処理されるため、少なくとも <xref:System.Windows.Interop.HwndHost.WndProc%2A> と <xref:System.Windows.Interop.HwndHost.DestroyWindowCore%2A> の実装が必要です。  <xref:System.Windows.Interop.HwndHost.WndProc%2A> の場合は、`handled` を `false` に設定して、メッセージが処理されなかったことを示し、0 を返します。  <xref:System.Windows.Interop.HwndHost.DestroyWindowCore%2A> の場合は、単純にウィンドウを破棄します。  
+  
+ [!code-csharp[WPFHostingWin32Control#WndProcDestroy](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#wndprocdestroy)]
+ [!code-vb[WPFHostingWin32Control#WndProcDestroy](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#wndprocdestroy)]  
+  
+ [!code-csharp[WPFHostingWin32Control#WndProcDestroyHelper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/ControlHost.cs#wndprocdestroyhelper)]
+ [!code-vb[WPFHostingWin32Control#WndProcDestroyHelper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/ControlHost.vb#wndprocdestroyhelper)]  
+  
+<a name="host_the_control"></a>   
+## ページでのコントロールのホスト  
+ ページ上のコントロールをホストするには、最初に `ControlHost` クラスの新しいインスタンスを作成します。  コントロールを含む境界線要素 \(`ControlHostElement`\) の高さと幅を、`ControlHost` コンストラクターに渡します。  これにより、ListBox のサイズが正しく設定されます。  次に、ホストの <xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Decorator.Child%2A> プロパティに `ControlHost` オブジェクトを割り当てて、ページ上のコントロールをホストします。  
+  
+ このサンプルでは、`ControlHost` の <xref:System.Windows.Interop.HwndHost.MessageHook> イベントにハンドラーをアタッチしてコントロールからのメッセージを受信します。  このイベントは、ホストされているウィンドウに送信されたすべてのメッセージに対して発生します。  この場合、これらのメッセージは、コントロールからの通知を含め、実際の ListBox コントロールをラップするウィンドウに送信されます。  このサンプルでは、SendMessage を呼び出して、コントロールから情報を取得し、そのコンテンツを変更します。  ページとコントロールとの通信方法の詳細については、次のセクションで説明します。  
+  
+> [!NOTE]
+>  SendMessage には 2 つの[!INCLUDE[TLA2#tla_pinvoke](../../../../includes/tla2sharptla-pinvoke-md.md)] 宣言があります。  2 つ必要なのは、一方は `wParam` パラメーターを使用して文字列を渡し、もう一方は同じパラメーターを使用して整数を渡すためです。  データが正しくマーシャリングされるために、各署名に対して個別の宣言が必要です。  
+  
+ [!code-csharp[WPFHostingWin32Control#HostWindowClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/Page1.xaml.cs#hostwindowclass)]
+ [!code-vb[WPFHostingWin32Control#HostWindowClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/Page1.xaml.vb#hostwindowclass)]  
+  
+ [!code-csharp[WPFHostingWin32Control#ControlMsgFilterSendMessage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/Page1.xaml.cs#controlmsgfiltersendmessage)]
+ [!code-vb[WPFHostingWin32Control#ControlMsgFilterSendMessage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/Page1.xaml.vb#controlmsgfiltersendmessage)]  
+  
+<a name="communication"></a>   
+## コントロールとページ間の通信の実装  
+ コントロールに [!INCLUDE[TLA2#tla_win](../../../../includes/tla2sharptla-win-md.md)] メッセージを送信して、コントロールを操作します。  コントロールは、そのホスト ウィンドウに通知を送信することで、ユーザーがコントロールと対話したことを通知します。  [WPF での Win32 ListBox コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159998)には、この動作の次のようないくつかの例を示す UI が含まれています。  
+  
+-   リストへの項目の追加  
+  
+-   リストからの選択した項目の削除  
+  
+-   現在選択されている項目のテキストの表示  
+  
+-   リスト内の項目数の表示  
+  
+ ユーザーは、従来の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションと同様に、リスト ボックス内の項目をクリックして選択することもできます。  表示されているデータは、ユーザーが項目を選択、追加して、リスト ボックスの状態を変更するたびに更新されます。  
+  
+ 項目を追加するには、リスト ボックスに LB\_ADDSTRING メッセージを送信します。  項目を削除するには、LB\_GETCURSEL を送信して現在の選択のインデックスを取得してから、LB\_DELETESTRING を送信して項目を削除します。  このサンプルでは、LB\_GETCOUNT も送信し、返された値を使用することにより、項目数を示す表示を更新します。  SendMessage のこれらのインスタンスはどちらも、前のセクションで説明した [!INCLUDE[TLA2#tla_pinvoke](../../../../includes/tla2sharptla-pinvoke-md.md)] 宣言の 1 つを使用しています。  
+  
+ [!code-csharp[WPFHostingWin32Control#AppendDeleteText](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFHostingWin32Control/CSharp/Page1.xaml.cs#appenddeletetext)]
+ [!code-vb[WPFHostingWin32Control#AppendDeleteText](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFHostingWin32Control/VisualBasic/Page1.xaml.vb#appenddeletetext)]  
+  
+ ユーザーが項目を選択したり、選択内容を変更すると、コントロールはホスト ウィンドウに WM\_COMMAND メッセージを送信して通知し、その結果、ページの <xref:System.Windows.Interop.HwndHost.MessageHook> イベントが発生します。  ハンドラーは、ホスト ウィンドウのメイン ウィンドウ プロシージャと同じ情報を受け取ります。  また、ブール値 `handled` への参照を渡します。  メッセージが処理済みになり、これ以上の処理が不要であることを示すには、`handled` を `true` に設定します。  
+  
+ WM\_COMMAND はさまざまな理由で送信されるため、通知 ID を調べて、処理するイベントかどうかを判断する必要があります。  ID は、`wParam` パラメーターの上位ワードに格納されています。  [!INCLUDE[TLA#tla_net](../../../../includes/tlasharptla-net-md.md)] には HIWORD マクロがないため、このサンプルではビット単位の演算子を使用して ID を抽出します。  ユーザーが選択や選択の変更を行うと、ID は LBN\_SELCHANGE になります。  
+  
+ サンプルは、LBN\_SELCHANGE を受け取ると、コントロールに LB\_GETCURSEL メッセージを送信することにより、選択した項目のインデックスを取得します。  テキストを取得するには、最初に <xref:System.Text.StringBuilder> を作成します。  その後、コントロールに LB\_GETTEXT メッセージを送信します。  空の <xref:System.Text.StringBuilder> オブジェクトを `wParam` パラメーターとして渡します。  SendMessage が返るときに、<xref:System.Text.StringBuilder> には選択した項目のテキストが含まれます。  SendMessage を使用するには、さらに別の [!INCLUDE[TLA2#tla_pinvoke](../../../../includes/tla2sharptla-pinvoke-md.md)] 宣言が必要です。  
+  
+ 最後に、`handled` を `true` に設定して、メッセージが処理されたことを示します。  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndHost>   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)   
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md
new file mode 100644
index 00000000000..5f7702fbac0
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md
@@ -0,0 +1,249 @@
+---
+title: "チュートリアル: WPF での Windows フォーム複合コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複合コントロール, ホスト (WPF で)"
+  - "ホスト (Windows フォーム コントロールを WPF で)"
+ms.assetid: 96fcd78d-1c77-4206-8928-3a0579476ef4
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# チュートリアル: WPF での Windows フォーム複合コントロールのホスト
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のコードに多くの投資を行った場合は、コードを最初から記述し直すよりも、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのコードの少なくとも一部を再利用する方が効率的です。  最も一般的なシナリオは、既存の [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールがある場合です。  場合によっては、これらのコントロールのソース コードにアクセスできないことがあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、そのようなコントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでホストするための簡単な手順が用意されています。  たとえば、特殊な <xref:System.Windows.Forms.DataGridView> コントロールをホストしながら、ほとんどのプログラミングには [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用できます。  
+  
+ このチュートリアルでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] 複合コントロールをホストしてデータ エントリを実行するアプリケーションについて段階的に説明します。  複合コントロールは DLL にパッケージ化されています。  この一般的な手順は、さらに複雑なアプリケーションやコントロールに拡張できます。  このチュートリアルは、外観および機能が「[チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)」の例とほぼ同じになるように設計されています。  主な違いは、ホストする側とされる側が逆であることです。  
+  
+ チュートリアルは、2 つのセクションに分かれています。  最初のセクションでは、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] 複合コントロールの実装について簡単に説明します。  2 番目のセクションでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで複合コントロールをホストし、コントロールからイベントを受け取って、コントロールのプロパティの一部にアクセスする方法について詳しく説明します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   Windows フォーム複合コントロールの実装  
+  
+-   WPF ホスト アプリケーションの実装  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[WPF での Windows フォーム複合コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159999)を参照してください。  
+  
+## 必要条件  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## Windows フォーム複合コントロールの実装  
+ この例で使用する [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] 複合コントロールは、単純なデータ入力フォームです。  このフォームは、ユーザーの名前と住所を受け取った後、カスタム イベントを使用してその情報をホストに返します。  レンダリングされたコントロールを次の図に示します。  
+  
+ ![シンプルな Windows フォーム コントロール](../../../../docs/framework/wpf/advanced/media/wfcontrol.png "WFControl")  
+Windows フォーム複合コントロール  
+  
+### プロジェクトの作成  
+ プロジェクトを開始するには  
+  
+1.  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を起動して、**\[新しいプロジェクト\]** ダイアログ ボックスを開きます。  
+  
+2.  ウィンドウのカテゴリで、**\[Windows フォーム コントロール ライブラリ\]** テンプレートを選択します。  
+  
+3.  新しいプロジェクトに `MyControls` という名前を付けます。  
+  
+4.  配置場所としては、`WpfHostingWindowsFormsControl` など、わかりやすい名前を付けた最上位フォルダーを指定します。  このフォルダーには後でホスト アプリケーションも配置します。  
+  
+5.  **\[OK\]** をクリックして、プロジェクトを作成します。  既定のプロジェクトには、`UserControl1` という名前の 1 つのコントロールが含まれます。  
+  
+6.  ソリューション エクスプローラーで、`UserControl1` の名前を `MyControl1` に変更します。  
+  
+ プロジェクトは、次のシステム DLL を参照している必要があります。  これらの DLL のいずれかが既定で含まれていない場合は、プロジェクトに追加します。  
+  
+-   システム  
+  
+-   System.Data  
+  
+-   System.Drawing  
+  
+-   System.Windows.Forms  
+  
+-   System.Xml  
+  
+### フォームへのコントロールの追加  
+ フォームにコントロールを追加するには、次の操作を実行します。  
+  
+-   デザイナーで `MyControl1` を開きます。  
+  
+ 5 つの <xref:System.Windows.Forms.Label> コントロールとそれに対応する <xref:System.Windows.Forms.TextBox> コントロールを、前の図と同じようなサイズと位置関係で、フォーム上に追加します。  この例では、<xref:System.Windows.Forms.TextBox> コントロールには次のような名前を付けます。  
+  
+-   `txtName`  
+  
+-   `txtAddress`  
+  
+-   `txtCity`  
+  
+-   `txtState`  
+  
+-   `txtZip`  
+  
+ **OK** と **Cancel** というラベルを付けた 2 つの <xref:System.Windows.Forms.Button> コントロールを追加します。  この例では、ボタンの名前はそれぞれ `btnOK` と `btnCancel` です。  
+  
+### サポート コードの実装  
+ コード ビューでフォームを開きます。  コントロールは、カスタム `OnButtonClick` イベントを発生させることで、収集したデータをホストに返します。  データは、イベント引数オブジェクトに格納されています。  次のコードは、イベントとデリゲートの宣言を示しています。  
+  
+ `MyControl1` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/MyControls/MyControl1.cs#2)]
+ [!code-vb[WpfHostingWindowsFormsControl#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/MyControls/MyControl1.vb#2)]  
+  
+ `MyControlEventArgs` クラスには、ホストに返される情報が格納されます。  
+  
+ 次のクラスをフォームに追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/MyControls/MyControl1.cs#3)]
+ [!code-vb[WpfHostingWindowsFormsControl#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/MyControls/MyControl1.vb#3)]  
+  
+ ユーザーが \[OK\] ボタンまたは \[Cancel\] ボタンをクリックすると、<xref:System.Windows.Forms.Control.Click> イベント ハンドラーはデータを格納した `MyControlEventArgs` オブジェクトを作成し、`OnButtonClick` イベントを発生させます。  2 つのハンドラーの違いは、イベント引数の `IsOK` プロパティだけです。  このプロパティにより、ホストはどちらのボタンがクリックされたのかを判別できます。  \[OK\] ボタンの場合は `true` が設定され、\[Cancel\] ボタンの場合は `false` が設定されます。  次のコード例は、2 つのボタン ハンドラーを示しています。  
+  
+ `MyControl1` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/MyControls/MyControl1.cs#4)]
+ [!code-vb[WpfHostingWindowsFormsControl#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/MyControls/MyControl1.vb#4)]  
+  
+### アセンブリへの厳密な名前の設定とアセンブリのビルド  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションからこのアセンブリを参照するには、アセンブリに厳密な名前を付ける必要があります。  厳密な名前を作成するには、Sn.exe でキー ファイルを作成し、それをプロジェクトに追加します。  
+  
+1.  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] のコマンド プロンプトを開きます。  この操作を行うには、**\[スタート\]** ボタンをクリックし、**\[すべてのプログラム\]**、\[Microsoft Visual Studio 2010\]、\[Visual Studio ツール\] の順にポイントして、\[Visual Studio コマンド プロンプト\] をクリックします。  カスタマイズされた環境変数でコンソール ウィンドウが起動されます。  
+  
+2.  コマンド プロンプトで、`cd` コマンドを使用してプロジェクト フォルダーに移動します。  
+  
+3.  次のコマンドを実行し、MyControls.snk という名前のキー ファイルを生成します。  
+  
+    ```  
+    Sn.exe -k MyControls.snk  
+    ```  
+  
+4.  キー ファイルをプロジェクトに組み込むには、ソリューション エクスプローラーでプロジェクト名を右クリックし、**\[プロパティ\]** をクリックします。  プロジェクト デザイナーで、**\[署名\]** タブをクリックし、**\[アセンブリの署名\]** チェック ボックスをオンにして、キー ファイルを参照します。  
+  
+5.  ソリューションをビルドします。  ビルドでは、MyControls.dll という名前の DLL が生成されます。  
+  
+## WPF ホスト アプリケーションの実装  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ホスト アプリケーションは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールを使用して `MyControl1` をホストします。  アプリケーションは、`OnButtonClick` イベントを処理して、コントロールからデータを受け取ります。  また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションからコントロールの一部のプロパティを変更できるオプション ボタンのコレクションもあります。  最終的なアプリケーションを次の図に示します。  
+  
+ ![WPF ページに埋め込まれたコントロール](../../../../docs/framework/wpf/advanced/media/avalonhost.png "AvalonHost")  
+WPF アプリケーションに埋め込まれたコントロールが表示されている完成したアプリケーション  
+  
+### プロジェクトの作成  
+ プロジェクトを開始するには  
+  
+1.  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] を開き、\[新しいプロジェクト\] を選択します。  
+  
+2.  ウィンドウのカテゴリで、**\[WPF アプリケーション\]** テンプレートを選択します。  
+  
+3.  新しいプロジェクトに `WpfHost` という名前を付けます。  
+  
+4.  配置場所としては、MyControls プロジェクトの配置先と同じ最上位フォルダーを指定します。  
+  
+5.  **\[OK\]** をクリックして、プロジェクトを作成します。  
+  
+ `MyControl1` および他のアセンブリを含む DLL への参照も追加する必要があります。  
+  
+1.  ソリューション エクスプローラーで、プロジェクト名を右クリックし、**\[参照の追加\]** を選択します。  
+  
+2.  **\[参照\]** タブをクリックし、MyControls.dll を格納しているフォルダーを参照します。  このチュートリアルの場合は、MyControls\\bin\\Debug フォルダーです。  
+  
+3.  MyControls.dll を選択し、**\[OK\]** をクリックします。  
+  
+4.  WindowsFormsIntegration.dll という名前の WindowsFormsIntegration アセンブリに参照を追加します。  
+  
+### 基本レイアウトの実装  
+ ホスト アプリケーションの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] は、MainWindow.xaml で実装されます。  このファイルは、レイアウトを定義する [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] マークアップを含み、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールをホストします。  アプリケーションは次の 3 つの領域に分かれています。  
+  
+-   \[Control Properties\] パネルには、ホストされるコントロールのさまざまなプロパティの変更に使用できるオプション ボタンのコレクションが含まれます。  
+  
+-   \[Data from Control\] パネルには、ホストされるコントロールから返されるデータを表示する <xref:System.Windows.Controls.TextBlock> 要素が含まれます。  
+  
+-   ホストされるコントロール自体。  
+  
+ 基本的なレイアウトを次の XAML に示します。  `MyControl1` をホストするために必要なマークアップはこの例では省略されていますが、これについては後で説明します。  
+  
+ MainWindow.xaml 内の XAML を次のコードに置き換えます。  Visual Basic を使用している場合は、クラスを `x:Class="MainWindow"` に変更します。  
+  
+ [!code-xml[WpfHostingWindowsFormsControl#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml#100)]  
+  
+ 最初の <xref:System.Windows.Controls.StackPanel> 要素には、ホストされるコントロールのさまざまな既定のプロパティを変更できる一連の <xref:System.Windows.Controls.RadioButton> コントロールが含まれます。  その後にある <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、`MyControl1` をホストします。  最後の <xref:System.Windows.Controls.StackPanel> 要素には、ホストされるコントロールから返されるデータを表示する <xref:System.Windows.Controls.TextBlock> 要素が含まれます。  要素の順序、および <xref:System.Windows.Controls.DockPanel.Dock%2A> 属性と <xref:System.Windows.FrameworkElement.Height%2A> 属性の設定により、すきまやゆがみがないように、ホストされるコントロールがウィンドウに埋め込まれます。  
+  
+#### コントロールのホスト  
+ 次のコードは前の XAML を編集したものですが、ここでは `MyControl1` をホストするために必要な要素に焦点を当てます。  
+  
+ [!code-xml[WpfHostingWindowsFormsControl#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml#101)]  
+[!code-xml[WpfHostingWindowsFormsControl#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml#102)]  
+  
+ `xmlns` 名前空間の割り当ての属性により、ホストされるコントロールを格納する `MyControls` 名前空間への参照が作成されます。  この割り当てにより、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で `MyControl1` を `<mcl:MyControl1>` として表すことができます。  
+  
+ XAML に含まれる次の 2 つの要素がホストを処理します。  
+  
+-   `WindowsFormsHost` は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでの [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールのホストを可能にする <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素を表します。  
+  
+-   `MyControl1` を表す `mcl:MyControl1` は、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の子コレクションに追加されます。  結果として、この [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ウィンドウの一部としてレンダリングされ、アプリケーションからコントロールと通信できます。  
+  
+### 分離コード ファイルの実装  
+ 分離コード ファイル MainWindow.xaml.vb または MainWindow.xaml.cs には、前のセクションで説明した [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の機能を実装する手順コードが含まれます。  主要なタスクは次のとおりです。  
+  
+-   `MyControl1` の `OnButtonClick` イベントへのイベント ハンドラーのアタッチ。  
+  
+-   一連のオプション ボタンの設定に基づく、`MyControl1` のさまざまなプロパティの変更。  
+  
+-   コントロールによって収集されたデータの表示。  
+  
+#### アプリケーションの初期化  
+ 初期化コードは、ウィンドウの <xref:System.Windows.FrameworkElement.Loaded> イベントのイベント ハンドラーに含まれ、イベント ハンドラーをコントロールの `OnButtonClick` イベントにアタッチします。  
+  
+ MainWindow.xaml.vb または MainWindow.xaml.cs で、`MainWindow` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml.cs#11)]
+ [!code-vb[WpfHostingWindowsFormsControl#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/WpfHost/Page1.xaml.vb#11)]  
+  
+ 前述の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] によって、`MyControl1` が <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の子要素コレクションに追加されているため、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の <xref:System.Windows.Forms.Integration.WindowsFormsHost.Child%2A> をキャストして `MyControl1` への参照を取得できます。  その後、その参照を使用して、イベント ハンドラーを `OnButtonClick` にアタッチすることができます。  
+  
+ コントロール自体への参照を提供するだけでなく、<xref:System.Windows.Forms.Integration.WindowsFormsHost> ではさまざまなコントロールのプロパティも公開されており、アプリケーションからそれを操作できます。  初期化コードは、後でアプリケーションで使用するため、これらの値をプライベート グローバル変数に代入します。  
+  
+ `MyControls` DLL の種類に簡単にアクセスできるように、次の `Imports` ステートメントまたは `using` ステートメントをファイルの先頭に追加します。  
+  
+```vb  
+Imports MyControls  
+```  
+  
+```csharp  
+using MyControls;  
+```  
+  
+#### OnButtonClick イベントの処理  
+ ユーザーがコントロールのボタンのいずれかをクリックすると、`MyControl1` が `OnButtonClick` イベントを発生させます。  
+  
+ `MainWindow` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml.cs#12)]
+ [!code-vb[WpfHostingWindowsFormsControl#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/WpfHost/Page1.xaml.vb#12)]  
+  
+ テキスト ボックスのデータは、`MyControlEventArgs` オブジェクトに格納されます。  ユーザーが \[OK\] ボタンをクリックすると、イベント ハンドラーはデータを抽出して、`MyControl1` の下のパネルに表示します。  
+  
+#### コントロールのプロパティの変更  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、ホストされるコントロールのいくつかの既定のプロパティを公開します。  これにより、アプリケーションのスタイルにより一致するように、コントロールの外観を変更できます。  左側のパネルにある一連のオプション ボタンを使用すると、色やフォントのプロパティを変更できます。  各ボタン セットには <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントに対するハンドラーがあり、ユーザーによるオプション ボタンの選択を検出して、コントロールの対応するプロパティを変更します。  
+  
+ `MainWindow` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WpfHostingWindowsFormsControl#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/CSharp/WpfHost/Page1.xaml.cs#13)]
+ [!code-vb[WpfHostingWindowsFormsControl#13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WpfHostingWindowsFormsControl/VisualBasic/WpfHost/Page1.xaml.vb#13)]  
+  
+ アプリケーションをビルドして実行します。  Windows フォーム複合コントロールにテキストを追加して **\[OK\]** をクリックします。  そのテキストがラベルに表示されます。  別のオプション ボタンをクリックして、コントロール上の影響を確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf-by-using-xaml.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf-by-using-xaml.md
new file mode 100644
index 00000000000..6a954edcbb7
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf-by-using-xaml.md
@@ -0,0 +1,69 @@
+---
+title: "チュートリアル: WPF での、XAML を使用した Windows フォーム コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (Windows フォーム コントロールを WPF で)"
+ms.assetid: 1aef42cb-4cfb-44b4-9a7a-c02632d3d9c7
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# チュートリアル: WPF での、XAML を使用した Windows フォーム コントロールのホスト
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、さまざまな機能を持つコントロールが多数あります。  しかし、独自の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページの [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを使用する方が望ましい場合があります。  たとえば、既存の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに多くの手間と時間がかかっている場合や、固有の機能を備えた [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールがある場合などです。  
+  
+ このチュートリアルでは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して Windows フォームの <xref:System.Windows.Forms.MaskedTextBox?displayProperty=fullName> コントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページでホストする方法を示します。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[WPF での、XAML を使用した Windows フォーム コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160000)を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## Windows Forms Control のホスト  
+  
+#### MaskedTextBox コントロールをホストするには  
+  
+1.  `HostingWfInWpfWithXaml` という名前の WPF アプリケーション プロジェクトを作成します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    -   WindowsFormsIntegration  
+  
+    -   System.Windows.Forms  
+  
+3.  [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]で MainWindow.xaml を開きます。  
+  
+4.  <xref:System.Windows.Window> 要素に、次の名前空間の割り当てを追加します。  `wf` 名前空間の割り当ては、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールを格納するアセンブリへの参照を確立します。  
+  
+    ```xaml  
+    xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"  
+    ```  
+  
+5.  <xref:System.Windows.Controls.Grid> 要素に、次の XAML を追加します。  
+  
+     <xref:System.Windows.Forms.MaskedTextBox> コントロールは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールの子として作成されます。  
+  
+     [!code-xml[HostingWfInWpfWithXaml#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWfInWpfWithXaml/CSharp/HostingWfInWpf/Window1.xaml#3)]  
+  
+6.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [Windows フォーム コントロールおよび同等の WPF コントロール](../../../../docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md)   
+ [WPF での、XAML を使用した Windows フォーム コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160000)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md
new file mode 100644
index 00000000000..c14ff830e26
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md
@@ -0,0 +1,77 @@
+---
+title: "チュートリアル: WPF での Windows フォーム コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (Windows フォーム コントロールを WPF で)"
+ms.assetid: 9cb88415-39b0-4c46-80c4-ff325b674286
+caps.latest.revision: 36
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# チュートリアル: WPF での Windows フォーム コントロールのホスト
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、さまざまな機能を持つコントロールが多数あります。  しかし、独自の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページの [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを使用する方が望ましい場合があります。  たとえば、既存の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに多くの手間と時間がかかっている場合や、固有の機能を備えた [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールがある場合などです。  
+  
+ このチュートリアルでは、コードを使用して [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の <xref:System.Windows.Forms.MaskedTextBox?displayProperty=fullName> コントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページでホストする方法を示します。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[WPF での Windows フォーム コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160057)を参照してください。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## Windows Forms Control のホスト  
+  
+#### MaskedTextBox コントロールをホストするには  
+  
+1.  `HostingWfInWpf` という名前の WPF アプリケーション プロジェクトを作成します。  
+  
+2.  次のアセンブリへの参照を追加します。  
+  
+    -   WindowsFormsIntegration  
+  
+    -   System.Windows.Forms  
+  
+3.  [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]で MainWindow.xaml を開きます。  
+  
+4.  <xref:System.Windows.Controls.Grid> 要素に `grid1` という名前を付けます。  
+  
+     [!code-xml[HostingWfInWPF#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWfInWPF/CSharp/HostingWfInWPF/Window1.xaml#1)]  
+  
+5.  デザイン ビューまたは XAML ビューで、<xref:System.Windows.Window> 要素を選択します。  
+  
+6.  プロパティ ウィンドウの **\[イベント\]** タブをクリックします。  
+  
+7.  <xref:System.Windows.FrameworkElement.Loaded> イベントをダブルクリックします。  
+  
+8.  <xref:System.Windows.FrameworkElement.Loaded> イベントを処理するには、次のコードを挿入します。  
+  
+     [!code-csharp[HostingWfInWPF#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWfInWPF/CSharp/HostingWfInWPF/Window1.xaml.cs#10)]
+     [!code-vb[HostingWfInWPF#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HostingWfInWPF/VisualBasic/HostingWfInWpf/Window1.xaml.vb#10)]  
+  
+9. ファイルの冒頭に、次の `Imports` ステートメントまたは `using` ステートメントを追加します。  
+  
+     [!code-csharp[HostingWfInWPF#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWfInWPF/CSharp/HostingWfInWPF/Window1.xaml.cs#11)]
+     [!code-vb[HostingWfInWPF#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HostingWfInWPF/VisualBasic/HostingWfInWpf/Window1.xaml.vb#11)]  
+  
+10. F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での、XAML を使用した Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf-by-using-xaml.md)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [Windows フォーム コントロールおよび同等の WPF コントロール](../../../../docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md)   
+ [WPF での Windows フォーム コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=160057)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-clock-in-win32.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-clock-in-win32.md
new file mode 100644
index 00000000000..85c901b2766
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-clock-in-win32.md
@@ -0,0 +1,238 @@
+---
+title: "チュートリアル: Win32 での WPF クロックのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "相互運用性 [WPF], チュートリアル"
+  - "相互運用性 [WPF], Win32"
+  - "Win32 コード, WPF 相互運用"
+ms.assetid: 555e55a7-0851-4ec8-b1c6-0acba7e9b648
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# チュートリアル: Win32 での WPF クロックのホスト
+[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーション内に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を配置するには、<xref:System.Windows.Interop.HwndSource> を使用します。<xref:System.Windows.Interop.HwndSource> は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを格納する HWND を提供します。  まず、<xref:System.Windows.Interop.HwndSource> を作成し、CreateWindow に似たパラメーターを渡します。  次に、<xref:System.Windows.Interop.HwndSource> 内に格納する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツについて <xref:System.Windows.Interop.HwndSource> に通知します。  最後に、<xref:System.Windows.Interop.HwndSource> から HWND を取得します。  このチュートリアルでは、オペレーティング システムの **\[日付と時刻のプロパティ\]** ダイアログを再実装する混在 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーション内に作成する方法について説明します。  
+  
+## 必須コンポーネント  
+ 「[WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)」を参照してください。  
+  
+## このチュートリアルの使用方法  
+ このチュートリアルでは、相互運用アプリケーションを作成するための重要な手順に重点を置いて説明します。  このチュートリアルは、[Win32 クロック相互運用のサンプル](http://go.microsoft.com/fwlink/?LinkID=160051)によって補足されます。ただし、このサンプルは最終結果を反映しています。  このチュートリアルでは、開発者が独自の既存の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクト \(おそらく以前から存在するプロジェクト\) から開始し、ホストされる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をアプリケーションに追加すると仮定して手順を説明します。  最終結果は [Win32 クロック相互運用のサンプル](http://go.microsoft.com/fwlink/?LinkID=160051)と比較できます。  
+  
+## Win32 \(HwndSource\) 内の Windows Presentation Framework のチュートリアル  
+ このチュートリアルの対象となるダイアログを次の図に示します。  
+  
+ ![&#91;日付と時刻のプロパティ&#93; ダイアログ ボックス](../../../../docs/framework/wpf/advanced/media/interoparch06.png "InteropArch06")  
+  
+ [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] で C\+\+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクトを作成し、ダイアログ エディターを使用して次のダイアログを作成することにより、このダイアログを再作成することができます。  
+  
+ ![&#91;日付と時刻のプロパティ&#93; ダイアログ ボックス](../../../../docs/framework/wpf/advanced/media/interoparch07.png "InteropArch07")  
+  
+ \(<xref:System.Windows.Interop.HwndSource> を使用するのに [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用する必要はなく、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プログラムを作成するのに C\+\+ を使用する必要もありません。ただし、これらを使用するのが一般的なやり方であり、チュートリアルの段階的な説明に役立ちます。\)  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックをダイアログ内に配置するには、次の 5 つのサブステップを実行する必要があります。  
+  
+1.  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] でプロジェクト設定を変更して、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクトがマネージ コード \(**\/clr**\) を呼び出すことができるようにします。  
+  
+2.  別の DLL 内に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Page> を作成します。  
+  
+3.  その [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Page> を <xref:System.Windows.Interop.HwndSource> 内に配置します。  
+  
+4.  <xref:System.Windows.Interop.HwndSource.Handle%2A> プロパティを使用して、この <xref:System.Windows.Controls.Page> の HWND を取得します。  
+  
+5.  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] を使用して、より大きな[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーション内の HWND の配置場所を決定します。  
+  
+## \/clr  
+ 最初の手順は、このアンマネージ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクトを、マネージ コードを呼び出すことができるプロジェクトに変更することです。  \/clr コンパイラ オプションを使用して必要な DLL にリンクし、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で使用する Main メソッドを変更します。  
+  
+ C\+\+ プロジェクト内でマネージ コードを使用できるようにするには、win32clock プロジェクトを右クリックして \[プロパティ\] をクリックします。  \[全般\] プロパティ ページ \(既定\) で、共通言語ランタイム サポートを `/clr` に変更します。  
+  
+ 次に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で必要な DLL \(PresentationCore.dll、PresentationFramework.dll、System.dll、WindowsBase.dll、UIAutomationProvider.dll、および UIAutomationTypes.dll\) への参照を追加します   \(次の手順では、オペレーティング システムが C: ドライブにインストールされていると仮定します\)。  
+  
+1.  win32clock プロジェクトを右クリックして **\[参照設定\]** をクリックし、表示されるダイアログで次の手順を実行します。  
+  
+2.  win32clock プロジェクトを右クリックして **\[参照設定\]** をクリックします。  
+  
+3.  \[新しい参照の追加\] をクリックして \[参照\] タブをクリックし、「C:\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\PresentationCore.dll」と入力して \[OK\] をクリックします。  
+  
+4.  PresentationFramework.dll \(C:\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\PresentationFramework.dll\) について同様の手順を繰り返します。  
+  
+5.  WindowsBase.dll \(C:\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\WindowsBase.dll\) について同様の手順を繰り返します。  
+  
+6.  UIAutomationTypes.dll \(C:\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\UIAutomationTypes.dll\) について同様の手順を繰り返します。  
+  
+7.  UIAutomationProvider.dll \(C:\\Program Files\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\UIAutomationProvider.dll\) について同様の手順を繰り返します。  
+  
+8.  **\[新しい参照の追加\]** をクリックし、System.dll を選択して **\[OK\]** をクリックします。  
+  
+9. \[OK\] をクリックして、参照を追加するための win32clock プロパティ ページを閉じます。  
+  
+ 最後に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で使用する `_tWinMain` メソッドに `STAThreadAttribute` を追加します。  
+  
+```  
+[System::STAThreadAttribute]  
+int APIENTRY _tWinMain(HINSTANCE hInstance,  
+                     HINSTANCE hPrevInstance,  
+                     LPTSTR    lpCmdLine,  
+                     int       nCmdShow)  
+```  
+  
+ この属性は、[!INCLUDE[TLA#tla_com](../../../../includes/tlasharptla-com-md.md)] を初期化するタイミングと、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] \(および [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]\) で必要なシングル スレッド アパートメント モデル \(STA\) を使用する必要があることを[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] に通知します。  
+  
+## Windows Presentation Framework ページの作成  
+ 次に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Page> を定義する DLL を作成します。  通常は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Page> をスタンドアロン アプリケーションとして作成し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 部分を単独で記述およびデバッグするのが最も簡単です。  作成が完了したら、そのプロジェクトを DLL に変更することができます。DLL に変更するには、プロジェクトを右クリックして \[プロパティ\] をクリックし、アプリケーションに移動して出力の種類を Windows クラス ライブラリに変更します。  
+  
+ その後、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] dll プロジェクトと [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクトを結合できます \(2 つのプロジェクトを含むソリューション\)。これを行うには、ソリューションを右クリックして **\[既存プロジェクトの追加\]** をクリックします。  
+  
+ この [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] dll を [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プロジェクトから使用するには、次の手順を実行して参照を追加する必要があります。  
+  
+1.  win32clock プロジェクトを右クリックして **\[参照設定\]** をクリックします。  
+  
+2.  **\[新しい参照の追加\]** をクリックします。  
+  
+3.  **\[プロジェクト\]** タブをクリックします。  WPFClock を選択して \[OK\] をクリックします。  
+  
+4.  \[OK\] をクリックして、参照を追加するための win32clock プロパティ ページを閉じます。  
+  
+## HwndSource  
+ 次に、<xref:System.Windows.Interop.HwndSource> を使用して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Page> を HWND に似た外観にします。  次のコード ブロックを C\+\+ ファイルに追加します。  
+  
+```  
+namespace ManagedCode  
+{  
+    using namespace System;  
+    using namespace System::Windows;  
+    using namespace System::Windows::Interop;  
+    using namespace System::Windows::Media;  
+  
+    HWND GetHwnd(HWND parent, int x, int y, int width, int height) {  
+        HwndSource^ source = gcnew HwndSource(  
+            0, // class style  
+            WS_VISIBLE | WS_CHILD, // style  
+            0, // exstyle  
+            x, y, width, height,  
+            "hi", // NAME  
+            IntPtr(parent)        // parent window   
+            );  
+  
+        UIElement^ page = gcnew WPFClock::Clock();  
+        source->RootVisual = page;  
+        return (HWND) source->Handle.ToPointer();  
+    }  
+}  
+}  
+```  
+  
+ これは長いコードであり、若干の説明を加えることができます。  先頭にはさまざまな句が記述されています。これにより、すべての呼び出しを完全に修飾する必要がなくなります。  
+  
+```  
+namespace ManagedCode  
+{  
+    using namespace System;  
+    using namespace System::Windows;  
+    using namespace System::Windows::Interop;  
+    using namespace System::Windows::Media;  
+```  
+  
+ 次に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを作成し、その周りに <xref:System.Windows.Interop.HwndSource> を配置して HWND を返す関数を定義します。  
+  
+```  
+HWND GetHwnd(HWND parent, int x, int y, int width, int height) {  
+```  
+  
+ 最初に、CreateWindow と同様のパラメーターを指定して <xref:System.Windows.Interop.HwndSource> を作成します。  
+  
+```  
+HwndSource^ source = gcnew HwndSource(  
+    0, // class style  
+    WS_VISIBLE | WS_CHILD, // style  
+    0, // exstyle  
+    x, y, width, height,  
+    "hi", // NAME  
+    IntPtr(parent) // parent window   
+    );  
+```  
+  
+ 次に、コンストラクターを呼び出して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ クラスを作成します。  
+  
+```  
+UIElement^ page = gcnew WPFClock::Clock();  
+```  
+  
+ 次に、ページを <xref:System.Windows.Interop.HwndSource> に関連付けます。  
+  
+```  
+source->RootVisual = page;  
+```  
+  
+ 最後の行で <xref:System.Windows.Interop.HwndSource> の HWND を返します。  
+  
+```  
+return (HWND) source->Handle.ToPointer();  
+```  
+  
+## Hwnd の配置  
+ 以上で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックを含む HWND の作成が完了しました。次に、この HWND を [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ダイアログ内に配置する必要があります。  HWND の配置場所がわかっている場合は、先ほど定義した `GetHwnd` 関数に HWND のサイズと位置を渡すだけで済みます。  ただし、ここではリソース ファイルを使用してダイアログを定義したため、HWND の正確な配置場所がわかりません。  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] のダイアログ エディターを使用すると、クロックの配置場所 \("ここにクロックを挿入"\) に [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] スタティック コントロールを配置し、それを使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックを配置することができます。  
+  
+ WM\_INITDIALOG を処理する場合は、`GetDlgItem` を使用して STATIC プレースホルダーの HWND を取得します。  
+  
+```  
+HWND placeholder = GetDlgItem(hDlg, IDC_CLOCK);  
+```  
+  
+ 次に、STATIC プレースホルダーのサイズと位置を計算し、その場所に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックを配置できるようにします。  
+  
+ RECT 四角形  
+  
+```  
+GetWindowRect(placeholder, &rectangle);  
+int width = rectangle.right - rectangle.left;  
+int height = rectangle.bottom - rectangle.top;  
+POINT point;  
+point.x = rectangle.left;  
+point.y = rectangle.top;  
+result = MapWindowPoints(NULL, hDlg, &point, 1);  
+```  
+  
+ 次に、STATIC プレースホルダーを非表示にします。  
+  
+```  
+ShowWindow(placeholder, SW_HIDE);  
+```  
+  
+ その場所に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロック HWND を作成します。  
+  
+```  
+HWND clock = ManagedCode::GetHwnd(hDlg, point.x, point.y, width, height);  
+```  
+  
+ このチュートリアルを有意義なものにし、実際の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックを作成するには、この時点で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロック コントロールを作成する必要があります。  通常、このコントロールは、分離コード内のいくつかのイベント ハンドラーと共に、マークアップで作成します。  このチュートリアルは、相互運用に関するものであり、コントロール設計に関するものではありません。したがって、ここでは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] クロックのコード全体をコード ブロックとして提供し、個々の作成手順や各部分の意味については説明しません。  このコードを修正し、コントロールの外観や機能を変更してみることをお勧めします。  
+  
+ マークアップを次に示します。  
+  
+ [!code-xml[Win32Clock#AllClockXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Win32Clock/CS/Clock.xaml#allclockxaml)]  
+  
+ 関連する分離コードを次に示します。  
+  
+ [!code-csharp[Win32Clock#AllClockCS](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Win32Clock/CS/Clock.xaml.cs#allclockcs)]  
+  
+ 最終結果は次のようになります。  
+  
+ ![&#91;日付と時刻のプロパティ&#93; ダイアログ ボックス](../../../../docs/framework/wpf/advanced/media/interoparch08.png "InteropArch08")  
+  
+ 最終結果とこのスクリーンショットを生成したコードを比較する場合は、[Win32 クロック相互運用のサンプル](http://go.microsoft.com/fwlink/?LinkID=160051)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndSource>   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)   
+ [Win32 クロック相互運用のサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md b/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md
new file mode 100644
index 00000000000..a4adbe810df
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md
@@ -0,0 +1,338 @@
+---
+title: "チュートリアル: Windows フォームでの WPF 複合コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (Windows フォームの WPF コンテンツを)"
+ms.assetid: 0ac41286-4c1b-4b17-9196-d985cb844ce1
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# チュートリアル: Windows フォームでの WPF 複合コントロールのホスト
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のコードに多大な手間と時間をかけた場合は、コードを最初から記述し直すよりも、既存の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーションを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で拡張する方が効率的となることもあります。  一般的なシナリオとしては、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーション内に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用して実装したコントロールを埋め込む場合が挙げられます。  WPF コントロールのカスタマイズ方法の詳細については、「[コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)」を参照してください。  
+  
+ このチュートリアルでは、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーションで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールをホストしてデータ エントリを実行するアプリケーションについて段階的に説明します。  複合コントロールは DLL にパッケージ化されています。  この一般的な手順は、さらに複雑なアプリケーションやコントロールに拡張できます。  このチュートリアルは、外観および機能が「[チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)」の例とほぼ同じになるように設計されています。  主な違いは、ホストする側とされる側が逆であることです。  
+  
+ チュートリアルは、2 つのセクションに分かれています。  最初のセクションでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールの実装について簡単に説明します。  2 番目のセクションでは、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] アプリケーションで複合コントロールをホストし、コントロールからイベントを受け取って、コントロールのプロパティの一部にアクセスする方法について詳しく説明します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   WPF 複合コントロールを実装する。  
+  
+-   Windows フォーム ホスト アプリケーションを実装する。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[Windows フォームでの WPF 複合コントロールのホストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159996)を参照してください。  
+  
+## 必要条件  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## WPF 複合コントロールの実装  
+ この例で使用される [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールは、ユーザーの名前と住所を受け取る単純なデータ入力フォームです。  ユーザーが 2 つのボタンのいずれかをクリックして入力操作が終了したことを示すと、コントロールは入力情報をホストに返すカスタム イベントを発生させます。  レンダリングされたコントロールを次の図に示します。  
+  
+ ![単純な WPF コントロール](../../../../docs/framework/wpf/advanced/media/avaloncontrol.png "AvalonControl")  
+WPF 複合コントロール  
+  
+### プロジェクトの作成  
+ プロジェクトを開始するには  
+  
+1.  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を起動して、**\[新しいプロジェクト\]** ダイアログ ボックスを開きます。  
+  
+2.  Visual C\# および Windows のカテゴリで、**\[WPF ユーザー コントロール ライブラリ\]** テンプレートを選択します。  
+  
+3.  新しいプロジェクトに `MyControls` という名前を付けます。  
+  
+4.  配置場所としては、`WindowsFormsHostingWpfControl` など、わかりやすい名前を付けた最上位フォルダーを指定します。  このフォルダーには後でホスト アプリケーションも配置します。  
+  
+5.  **\[OK\]** をクリックして、プロジェクトを作成します。  既定のプロジェクトには、`UserControl1` という名前の 1 つのコントロールが含まれます。  
+  
+6.  ソリューション エクスプローラーで、`UserControl1` の名前を `MyControl1` に変更します。  
+  
+ プロジェクトは、次のシステム DLL を参照している必要があります。  これらの DLL のいずれかが既定で含まれていない場合は、プロジェクトに追加します。  
+  
+-   PresentationCore  
+  
+-   PresentationFramework  
+  
+-   システム  
+  
+-   WindowsBase  
+  
+### ユーザー インターフェイスの作成  
+ 複合コントロールの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して実装されます。  複合コントロールの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は 5 つの <xref:System.Windows.Controls.TextBox> 要素で構成されています。  各 <xref:System.Windows.Controls.TextBox> 要素には、ラベルとして使用される <xref:System.Windows.Controls.TextBlock> 要素が関連付けられています。  下部には **\[OK\]** および **\[Cancel\]** という 2 つの <xref:System.Windows.Controls.Button> 要素があります。  ユーザーがいずれかのボタンをクリックすると、コントロールは情報をホストに返すカスタム イベントを発生させます。  
+  
+#### 基本的なレイアウト  
+ <xref:System.Windows.Controls.Grid> 要素には、さまざまな [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素が格納されます。  <xref:System.Windows.Controls.Grid> を使用して、HTML で `Table` 要素を使用する場合とほとんど同じ方法で、複合コントロールのコンテンツを配置できます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には <xref:System.Windows.Documents.Table> 要素もありますが、<xref:System.Windows.Controls.Grid> の方が軽量で、単純なレイアウト タスクに適しています。  
+  
+ 次の XAML に基本的なレイアウトを示します。  この XAML では、<xref:System.Windows.Controls.Grid> 要素に列および行の数を指定することにより、コントロールの全体的な構造を定義しています。  
+  
+ MyControl1.xaml で、既存の XAML を次の XAML で置き換えます。  
+  
+ [!code-xml[WindowsFormsHostingWpfControl#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml#101)]  
+[!code-xml[WindowsFormsHostingWpfControl#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml#102)]  
+  
+#### TextBlock 要素および TextBox 要素のグリッドへの追加  
+ グリッドに [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を配置するには、その要素の <xref:System.Windows.Controls.Grid.RowProperty> および <xref:System.Windows.Controls.Grid.ColumnProperty> 属性に適切な行番号と列番号を設定します。  行と列の番号付けは 0 から始まる点に注意してください。  <xref:System.Windows.Controls.Grid.ColumnSpanProperty> 属性を設定することによって、1 つの要素を複数の列にまたがって表示することができます。  <xref:System.Windows.Controls.Grid> 要素の詳細については、「[グリッド要素を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-grid-element.md)」を参照してください。  
+  
+ 次の XAML では、複合コントロールの <xref:System.Windows.Controls.TextBox> 要素および <xref:System.Windows.Controls.TextBlock> 要素に、要素をグリッドに適切に配置するための <xref:System.Windows.Controls.Grid.RowProperty> 属性および <xref:System.Windows.Controls.Grid.ColumnProperty> 属性を設定しています。  
+  
+ MyControl1.xaml で、次の XAML を <xref:System.Windows.Controls.Grid> 要素内に追加します。  
+  
+ [!code-xml[WindowsFormsHostingWpfControl#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml#103)]  
+  
+#### UI 要素のスタイル設定  
+ データ入力フォームの多くの要素は、外観が似ています。つまり、それらの要素ではいくつかのプロパティの設定が同一になります。  前の XAML では、各要素の属性を個別に設定するのではなく、<xref:System.Windows.Style> 要素を使用して、複数の要素のクラスの標準プロパティ設定を定義しています。  この方法では、コントロールの複雑さが軽減され、1 つのスタイル属性を使用して複数の要素の外観を変更できます。  
+  
+ <xref:System.Windows.Style> 要素は <xref:System.Windows.Controls.Grid> 要素の <xref:System.Windows.FrameworkElement.Resources%2A> プロパティに格納されるため、コントロール内のすべての要素で使用できます。  スタイルに名前が付いている場合は、そのスタイルの名前に設定された <xref:System.Windows.Style> 要素を追加することによって、要素にそのスタイルを適用します。  名前が付いていないスタイルは、要素の既定のスタイルになります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のスタイルの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+ 複合コントロールの <xref:System.Windows.Style> 要素を次の XAML に示します。  スタイルが要素にどのように適用されるかについては、前の XAML を参照してください。  たとえば、最後の <xref:System.Windows.Controls.TextBlock> 要素には `inlineText` スタイルが適用され、最後の <xref:System.Windows.Controls.TextBox> 要素は既定のスタイルを使用します。  
+  
+ MyControl1.xaml で、次の XAML を <xref:System.Windows.Controls.Grid> の開始要素の直後に追加します。  
+  
+ [!code-xml[WindowsFormsHostingWpfControl#104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml#104)]  
+  
+#### \[OK\] および \[Cancel\] ボタンの追加  
+ 複合コントロール上の最後の要素は、<xref:System.Windows.Controls.Grid> の最後の行の最初の 2 つの列を専有する **\[OK\]** および **\[Cancel\]** の <xref:System.Windows.Controls.Button> 要素です。  これらの要素は、共通のイベント ハンドラーである `ButtonClicked`、および前の XAML で定義された既定の <xref:System.Windows.Controls.Button> スタイルを使用します。  
+  
+ MyControl1.xaml で、次の XAML を最後の <xref:System.Windows.Controls.TextBox> 要素の後に追加します。  複合コントロールの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 部分はこれで完成です。  
+  
+ [!code-xml[WindowsFormsHostingWpfControl#105](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml#105)]  
+  
+### 分離コード ファイルの実装  
+ 分離コード ファイル MyControl1.xaml.cs は、3 つの基本的なタスクを実装します。  
+  
+1.  ユーザーがボタンのいずれかをクリックしたときに発生するイベントを処理します。  
+  
+2.  <xref:System.Windows.Controls.TextBox> 要素からデータを取得し、そのデータをカスタム イベント引数オブジェクトにパッケージ化します。  
+  
+3.  ユーザーが操作を終了したことをホストに通知し、入力データをホストに渡すカスタム `OnButtonClick` イベントを発生させます。  
+  
+ コントロールは、外観を変更するための色とフォントのプロパティもいくつか公開します。  [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールをホストするために使用される <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスとは異なり、<xref:System.Windows.Forms.Integration.ElementHost> クラスはコントロールの <xref:System.Windows.Controls.Panel.Background%2A> プロパティのみを公開します。  このコード例と「[チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)」で説明した例の類似性を保持するために、このコントロールでは残りのプロパティを直接公開します。  
+  
+#### 分離コード ファイルの基本構造  
+ 分離コード ファイルは、`MyControl1` および `MyControlEventArgs` という 2 つのクラスを格納する単一の名前空間である `MyControls` で構成されています。  
+  
+```  
+  
+namespace MyControls  
+{  
+  public partial class MyControl1 : Grid  
+  {  
+    //...  
+  }  
+  public class MyControlEventArgs : EventArgs  
+  {  
+    //...  
+  }  
+}  
+  
+```  
+  
+ 最初のクラスである `MyControl1` は、MyControl1.xaml で定義された [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の機能を実装するコードを格納する部分クラスです。  MyControl1.xaml が解析されると、その [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は同じ部分クラスに変換され、2 つの部分クラスがマージされて、コンパイルされたコントロールを形成します。  このため、分離コード ファイル内のクラス名は、MyControl1.xaml に割り当てられたクラス名と一致する必要があり、コントロールのルート要素から継承する必要があります。  2 番目のクラスである `MyControlEventArgs` はホストにデータを返送するために使用されるイベント引数クラスです。  
+  
+ MyControl1.xaml.cs を開きます。  次の名前に合わせて既存のクラス宣言を変更し、<xref:System.Windows.Controls.Grid> を継承します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml.cs#21)]  
+  
+#### コントロールの初期化  
+ このコードでは、次の基本タスクを実装します。  
+  
+-   プライベート イベントである `OnButtonClick`、およびそのイベントに関連付けられたデリゲートである `MyControlEventHandler` を宣言します。  
+  
+-   ユーザーのデータを格納する複数のプライベート グローバル変数を作成します。  このデータは、対応するプロパティを通じて公開されます。  
+  
+-   コントロールの <xref:System.Windows.FrameworkElement.Loaded> イベントのハンドラー `Init` を実装します。  このハンドラーは、グローバル変数に MyControl1.xaml で定義された値を割り当てることによって、グローバル変数を初期化します。  初期化するには、一般的な <xref:System.Windows.Controls.TextBlock> の要素である `nameLabel` に割り当てられた <xref:System.Windows.FrameworkElement.Name%2A> を使用して、この要素のプロパティの設定にアクセスします。  
+  
+ 既存のコンストラクターを削除し、次のコードを `MyControl1` クラスに追加します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml.cs#11)]  
+  
+#### ボタンのクリック イベントの処理  
+ ユーザーは、**\[OK\]** ボタンまたは **\[Cancel\]** ボタンをクリックすることにより、データ入力タスクを完了したことを示します。  これらのボタンは両方とも、同じ <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーである `ButtonClicked` を使用します。  これらのボタンにはそれぞれ `btnOK` または `btnCancel` という名前が付けられています。これにより、ハンドラーが `sender` 引数の値を調べることによって、どちらのボタンがクリックされたかを判断することができます。  ハンドラーは次の処理を行います。  
+  
+-   <xref:System.Windows.Controls.TextBox> 要素からのデータを格納する `MyControlEventArgs` オブジェクトを作成します。  
+  
+-   ユーザーが \[Cancel\] ボタンをクリックした場合に、`MyControlEventArgs` オブジェクトの `IsOK` プロパティを `false` に設定します。  
+  
+-   ユーザーが操作を終了したことをホストに示す `OnButtonClick` イベントを発生させ、収集したデータを渡します。  
+  
+ 次のコードを、`MyControl1` クラスの `Init` メソッドの後に追加します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml.cs#12)]  
+  
+#### プロパティの作成  
+ クラスの残りの部分では単純に、前に説明したグローバル変数に対応するプロパティを公開します。  プロパティが変更されると、set アクセサーが対応する要素のプロパティを変更し、基になるグローバル変数を更新することによって、コントロールの外観を変更します。  
+  
+ `MyControl1` クラスに次のコードを追加します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml.cs#13)]  
+  
+#### ホストへのデータの返送  
+ ファイルの最後のコンポーネントは、収集されたデータをホストに返送するために使用される `MyControlEventArgs` クラスです。  
+  
+ `MyControls` 名前空間に次のコードを追加します。  この実装は簡単なので、これ以上の説明はしません。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/MyControls/Page1.xaml.cs#14)]  
+  
+ ソリューションをビルドします。  ビルドでは、MyControls.dll という名前の DLL が生成されます。  
+  
+<a name="winforms_host_section"></a>   
+## Windows フォーム ホスト アプリケーションの実装  
+ [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] ホスト アプリケーションは <xref:System.Windows.Forms.Integration.ElementHost> オブジェクトを使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールをホストします。  アプリケーションは、`OnButtonClick` イベントを処理して、複合コントロールからデータを受け取ります。  アプリケーションには、コントロールの外観を変更するために使用できるオプションのボタンのセットもあります。  次の図は、アプリケーションを示しています。  
+  
+ ![Avalon コントロールをホストする Windows フォーム](../../../../docs/framework/wpf/advanced/media/wfhost.png "WFHost")  
+Windows フォーム アプリケーションでホストされる WPF 複合コントロール  
+  
+### プロジェクトの作成  
+ プロジェクトを開始するには  
+  
+1.  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] を起動して、**\[新しいプロジェクト\]** ダイアログ ボックスを開きます。  
+  
+2.  Visual C\# および Windows のカテゴリで、**\[Windows フォーム アプリケーション\]** テンプレートを選択します。  
+  
+3.  新しいプロジェクトに `WFHost` という名前を付けます。  
+  
+4.  配置場所としては、MyControls プロジェクトの配置先と同じ最上位フォルダーを指定します。  
+  
+5.  **\[OK\]** をクリックして、プロジェクトを作成します。  
+  
+ `MyControl1` および他のアセンブリを含む DLL への参照も追加する必要があります。  
+  
+1.  ソリューション エクスプローラーで、プロジェクト名を右クリックし、**\[参照の追加\]** を選択します。  
+  
+2.  **\[参照\]** タブをクリックし、MyControls.dll を格納しているフォルダーを参照します。  このチュートリアルの場合は、MyControls\\bin\\Debug フォルダーです。  
+  
+3.  MyControls.dll を選択し、**\[OK\]** をクリックします。  
+  
+4.  次のアセンブリへの参照を追加します。  
+  
+    -   PresentationCore  
+  
+    -   PresentationFramework  
+  
+    -   System.Xaml  
+  
+    -   WindowsBase  
+  
+    -   WindowsFormsIntegration  
+  
+### アプリケーションのユーザー インターフェイスの実装  
+ Windows フォーム アプリケーションの UI には、WPF 複合コントロールと対話するためのいくつかのコントロールが含まれています。  
+  
+1.  Windows フォーム デザイナーで、Form1 を開きます。  
+  
+2.  コントロールを配置するためにフォームを拡げます。  
+  
+3.  フォームの右上隅に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールを保持するための <xref:System.Windows.Forms.Panel?displayProperty=fullName> コントロールを追加します。  
+  
+4.  次の <xref:System.Windows.Forms.GroupBox?displayProperty=fullName> コントロールをフォームに追加します。  
+  
+    |名前|テキスト|  
+    |--------|----------|  
+    |groupBox1|\[背景色\]|  
+    |groupBox2|前景色|  
+    |groupBox3|Font Size|  
+    |groupBox4|フォント ファミリ|  
+    |groupBox5|フォント スタイル|  
+    |groupBox6|フォントの太さ|  
+    |groupBox7|コントロールからのデータ|  
+  
+5.  次の <xref:System.Windows.Forms.RadioButton?displayProperty=fullName> コントロールを <xref:System.Windows.Forms.GroupBox?displayProperty=fullName> コントロールに追加します。  
+  
+    |GroupBox|名前|テキスト|  
+    |--------------|--------|----------|  
+    |groupBox1|radioBackgroundOriginal|元|  
+    |groupBox1|radioBackgroundLightGreen|ライトグリーン|  
+    |groupBox1|radioBackgroundLightSalmon|ライトサーモン|  
+    |groupBox2|radioForegroundOriginal|元|  
+    |groupBox2|radioForegroundRed|赤|  
+    |groupBox2|radioForegroundYellow|黄|  
+    |groupBox3|radioSizeOriginal|元|  
+    |groupBox3|radioSizeTen|10|  
+    |groupBox3|radioSizeTwelve|12|  
+    |groupBox4|radioFamilyOriginal|元|  
+    |groupBox4|radioFamilyTimes|Times New Roman|  
+    |groupBox4|radioFamilyWingDings|WingDings|  
+    |groupBox5|radioStyleOriginal|Normal|  
+    |groupBox5|radioStyleItalic|イタリック体|  
+    |groupBox6|radioWeightOriginal|元|  
+    |groupBox6|radioWeightBold|\[太字\]|  
+  
+6.  次の <xref:System.Windows.Forms.Label?displayProperty=fullName> コントロールを最後の <xref:System.Windows.Forms.GroupBox?displayProperty=fullName> に追加します。  これらのコントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールから返されたデータを表示します。  
+  
+    |GroupBox|名前|テキスト|  
+    |--------------|--------|----------|  
+    |groupBox7|lblName|名前:|  
+    |groupBox7|lblAddress|番地:|  
+    |groupBox7|lblCity|市区町村:|  
+    |groupBox7|lblState|都道府県:|  
+    |groupBox7|lblZip|郵便番号:|  
+  
+### フォームの初期化  
+ 通常は、フォームの <xref:System.Windows.Forms.Form.Load> イベント ハンドラー内にホスティング コードを実装します。  次のコードは、サンプルの <xref:System.Windows.Forms.Form.Load> イベント ハンドラー、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールの <xref:System.Windows.FrameworkElement.Loaded> イベントのハンドラー、および後で使用するいくつかのグローバル変数の宣言を示します。  
+  
+ Windows フォーム デザイナーで、フォームをダブルクリックして <xref:System.Windows.Forms.Form.Load> イベント ハンドラーを作成します。  Form1.cs の先頭に、次の `using` ステートメントを追加します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/WFHost/Form1.cs#10)]  
+  
+ 既存の `Form1` クラスの内容を次のコードで置き換えます。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/WFHost/Form1.cs#2)]  
+  
+ 前のコードの `Form1_Load` メソッドは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールをホストするための一般的な手順を示します。  
+  
+1.  新しい <xref:System.Windows.Forms.Integration.ElementHost> オブジェクトを作成します。  
+  
+2.  コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle?displayProperty=fullName> に設定します。  
+  
+3.  <xref:System.Windows.Forms.Integration.ElementHost> コントロールを <xref:System.Windows.Forms.Panel> コントロールの <xref:System.Windows.Forms.Control.Controls%2A> コレクションに追加します。  
+  
+4.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールのインスタンスを作成します。  
+  
+5.  <xref:System.Windows.Forms.Integration.ElementHost> コントロールの <xref:System.Windows.Forms.Integration.ElementHost.Child%2A> プロパティにコントロールを割り当てることによって、フォーム上で複合コントロールをホストします。  
+  
+ `Form1_Load` メソッドの残りの 2 行は、2 つのコントロール イベントにハンドラーをアタッチします。  
+  
+-   `OnButtonClick` は、ユーザーが **\[OK\]** または **\[Cancel\]** ボタンをクリックしたときに複合コントロールが発生させるカスタム イベントです。  このイベントを処理して、ユーザーの応答を取得し、ユーザーが指定したデータをすべて収集します。  
+  
+-   <xref:System.Windows.FrameworkElement.Loaded> は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが完全に読み込まれたときにこのコントロールが発生させる標準のイベントです。  ここでこのイベントを使用するのは、この例ではコントロールからのプロパティを使用して複数のグローバル変数を初期化する必要があるからです。  フォームの <xref:System.Windows.Forms.Form.Load> イベントが発生した時点では、コントロールは完全には読み込まれておらず、これらの値はまだ `null` に設定されています。  これらのプロパティにアクセスするには、コントロールの <xref:System.Windows.FrameworkElement.Loaded> イベントが発生するまで待つ必要があります。  
+  
+ 前のコードでは、<xref:System.Windows.FrameworkElement.Loaded> イベント ハンドラーが示されています。  `OnButtonClick` ハンドラーについては次のセクションで説明します。  
+  
+### OnButtonClick の処理  
+ `OnButtonClick` イベントは、ユーザーが \[OK\] または \[Cancel\] ボタンをクリックしたときに発生します。  
+  
+ イベント ハンドラーは、イベント引数の `IsOK` フィールドをチェックして、どちらのボタンがクリックされたかを判断します。  `lbl`*data* 変数は、前に説明した <xref:System.Windows.Forms.Label> コントロールに対応します。  ユーザーが **\[OK\]** ボタンをクリックすると、コントロールの <xref:System.Windows.Controls.TextBox> コントロールからのデータは、対応する <xref:System.Windows.Forms.Label> コントロールに割り当てられます。  ユーザーが **\[Cancel\]** ボタンをクリックした場合、<xref:System.Windows.Forms.Label.Text%2A> の値は既定の文字列に設定されます。  
+  
+ 次のボタン クリック イベント ハンドラー コードを `Form1` クラスに追加します。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/WFHost/Form1.cs#3)]  
+  
+ アプリケーションをビルドして実行します。  WPF 複合コントロールに任意のテキストを追加し、**\[OK\]** をクリックします。  そのテキストがラベルに表示されます。  この時点で、オプション ボタンの処理用にコードは追加されていません。  
+  
+### コントロールの外観の変更  
+ フォームの <xref:System.Windows.Forms.RadioButton> コントロールを使用すると、ユーザーは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 複合コントロールの前景と背景の色、および複数のフォント プロパティを変更できます。  背景色は <xref:System.Windows.Forms.Integration.ElementHost> オブジェクトによって公開されます。  残りのプロパティは、コントロールのカスタム プロパティとして公開されます。  
+  
+ フォーム上の各 <xref:System.Windows.Forms.RadioButton> コントロールをダブルクリックして <xref:System.Windows.Forms.RadioButton.CheckedChanged> イベント ハンドラーを作成します。  <xref:System.Windows.Forms.RadioButton.CheckedChanged> イベント ハンドラーを次のコードで置き換えます。  
+  
+ [!code-csharp[WindowsFormsHostingWpfControl#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsFormsHostingWpfControl/CSharp/WFHost/Form1.cs#4)]  
+  
+ アプリケーションをビルドして実行します。  別のオプション ボタンをクリックして、WPF 複合コントロール上の影響を確認します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの 3D WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-an-activex-control-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-hosting-an-activex-control-in-wpf.md
new file mode 100644
index 00000000000..3b7b3098c88
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-an-activex-control-in-wpf.md
@@ -0,0 +1,117 @@
+---
+title: "チュートリアル: WPF での ActiveX コントロールのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ActiveX コントロール [WPF 相互運用性]"
+  - "ホスト (ActiveX コントロールを)"
+ms.assetid: 1931d292-0dd1-434f-963c-dcda7638d75a
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# チュートリアル: WPF での ActiveX コントロールのホスト
+ブラウザーでの操作を改善するには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションで [!INCLUDE[TLA#tla_actx](../../../../includes/tlasharptla-actx-md.md)] コントロールを使用できます。  このチュートリアルでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページ上のコントロールとして [!INCLUDE[TLA#tla_wmp](../../../../includes/tlasharptla-wmp-md.md)] をホストする方法を示します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトの作成。  
+  
+-   ActiveX コントロールの作成。  
+  
+-   WPF ページでの ActiveX コントロールのホスティング。  
+  
+ このチュートリアルを完了すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションで [!INCLUDE[TLA#tla_actx](../../../../includes/tlasharptla-actx-md.md)] コントロールを使用する方法を理解できます。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] がインストールされているコンピューターにインストールされた [!INCLUDE[TLA#tla_wmp](../../../../includes/tlasharptla-wmp-md.md)]。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+## プロジェクトの作成  
+  
+#### プロジェクトを作成し、設定するには  
+  
+1.  `HostingAxInWpf` という名前の WPF アプリケーション プロジェクトを作成します。  
+  
+2.  ソリューションに Windows フォーム コントロール ライブラリ プロジェクトを追加し、プロジェクトに `WmpAxLib` という名前を付けます。  
+  
+3.  WmpAxLib プロジェクトで、wmp.dll という名前の Windows Media Player アセンブリへの参照を追加します。  
+  
+4.  **\[ツールボックス\]** を開きます。  
+  
+5.  **ツールボックス**内を右クリックし、**\[アイテムの選択\]** をクリックします。  
+  
+6.  **\[COM コンポーネント\]** タブをクリックし、**\[Windows Media Player\]** コントロールを選択し、**\[OK\]** をクリックします。  
+  
+     Windows Media Player コントロールが**ツールボックス**に追加されます。  
+  
+7.  ソリューション エクスプローラーで、**\[UserControl1\]** ファイルを右クリックし、**\[名前の変更\]** をクリックします。  
+  
+8.  言語に応じて名前を `WmpAxControl.vb` または `WmpAxControl.cs` に変更します。  
+  
+9. 全ての参照名を変更するかを確認するメッセージが表示されたら、**\[はい\]** をクリックします。  
+  
+## ActiveX コントロールの作成  
+ コントロールがデザイン サーフェイスに追加されると、[!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] によって [!INCLUDE[TLA#tla_actx](../../../../includes/tlasharptla-actx-md.md)] コントロールの <xref:System.Windows.Forms.AxHost> ラッパー クラスが自動的に生成されます。  次の手順では、AxInterop.WMPLib.dll という名前の管理アセンブリが作成されます。  
+  
+#### ActiveX コントロールを作成するには  
+  
+1.  Windows フォーム デザイナーで、WmpAxControl.vb または WmpAxControl.cs を開きます。  
+  
+2.  **ツールボックス**から Windows Media Player コントロールをデザイン サーフェイスに追加します。  
+  
+3.  \[プロパティ\] ウィンドウで、Windows Media Player コントロールの <xref:System.Windows.Forms.Control.Dock%2A> プロパティの値を <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+4.  WmpAxLib コントロール ライブラリ プロジェクトをビルドします。  
+  
+## WPF ページでの ActiveX コントロールのホスティング  
+  
+#### ActiveX コントロールをホストするには  
+  
+1.  HostingAxInWpf プロジェクトで、生成された [!INCLUDE[TLA2#tla_actx](../../../../includes/tla2sharptla-actx-md.md)] 相互運用アセンブリに参照を追加します。  
+  
+     このアセンブリ名は AxInterop.WMPLib.dll で、Windows Media Player コントロールをインポートした時点で、WmpAxLib プロジェクトの Debug フォルダーに追加されています。  
+  
+2.  WindowsFormsIntegration.dll という名前の WindowsFormsIntegration アセンブリに参照を追加します。  
+  
+3.  System.Windows.Forms.dll という名前の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アセンブリに参照を追加します。  
+  
+4.  WPF デザイナーで、MainWindow.xaml を開きます。  
+  
+5.  <xref:System.Windows.Controls.Grid> 要素に `grid1` という名前を付けます。  
+  
+     [!code-xml[HostingAxInWpf#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingAxInWpf/CSharp/HostingAxInWpf/window1.xaml#1)]  
+  
+6.  デザイン ビューまたは XAML ビューで、<xref:System.Windows.Window> 要素を選択します。  
+  
+7.  プロパティ ウィンドウの **\[イベント\]** タブをクリックします。  
+  
+8.  <xref:System.Windows.FrameworkElement.Loaded> イベントをダブルクリックします。  
+  
+9. <xref:System.Windows.FrameworkElement.Loaded> イベントを処理するには、次のコードを挿入します。  
+  
+     このコードは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールのインスタンスを作成し、`AxWindowsMediaPlayer` コントロールのインスタンスをその子として追加します。  
+  
+     [!code-csharp[HostingAxInWpf#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingAxInWpf/CSharp/HostingAxInWpf/window1.xaml.cs#11)]
+     [!code-vb[HostingAxInWpf#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HostingAxInWpf/VisualBasic/HostingAxInWpf/window1.xaml.vb#11)]  
+  
+10. F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md b/docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md
new file mode 100644
index 00000000000..64d4ce9304c
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md
@@ -0,0 +1,83 @@
+---
+title: "チュートリアル : WPF での Direct3D9 コンテンツのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Direct3D9 [WPF 相互運用性], ホスト (Direct3D9 コンテンツを)"
+  - "WPF, ホスト (Direct3D9 コンテンツを)"
+ms.assetid: 60983736-0ab5-42cc-8b16-e9fbde261a43
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# チュートリアル : WPF での Direct3D9 コンテンツのホスト
+このチュートリアルでは、Windows Presentation Foundation \(WPF\) アプリケーションで Direct3D9 コンテンツをホストする方法について説明します。  
+  
+ このチュートリアルでは次のタスクを行います。  
+  
+-   Direct3D9 コンテンツをホストする WPF プロジェクトを作成する。  
+  
+-   Direct3D9 コンテンツをインポートする。  
+  
+-   <xref:System.Windows.Interop.D3DImage> クラスを使用して Direct3D9 コンテンツを表示する。  
+  
+ このチュートリアルを終了すると、WPF アプリケーションで Direct3D9 コンテンツをホストする方法を理解できます。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev10_long](../../../../includes/vs-dev10-long-md.md)].  
+  
+-   DirectX SDK 9 以降  
+  
+-   WPF 互換形式の Direct3D9 コンテンツを含む DLL。  詳細については、「[WPF と Direct3D9 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md)」および「[チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md)」を参照してください。  
+  
+## WPF プロジェクトの作成  
+ 最初に WPF アプリケーションのプロジェクトを作成します。  
+  
+#### WPF プロジェクトを作成するには  
+  
+-   Visual C\# で `D3DHost` という名前の新しい WPF アプリケーション プロジェクトを作成します。  詳細については、「[方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)」を参照してください。  
+  
+     [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]で MainWindow.xaml が開きます。  
+  
+## Direct3D9 コンテンツのインポート  
+ `DllImport` 属性を使用して、Direct3D9 コンテンツをアンマネージ DLL からインポートします。  
+  
+#### Direct3D9 コンテンツをインポートするには  
+  
+1.  コード エディターで MainWindow.xaml.cs を開きます。  
+  
+2.  自動的に生成されたコードを次のコードで置き換えます。  
+  
+     [!code-csharp[System.Windows.Interop.D3DImage#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/CS/window1.xaml.cs#1)]  
+  
+## Direct3D9 コンテンツのホスト  
+ 最後に、<xref:System.Windows.Interop.D3DImage> クラスを使用して Direct3D9 コンテンツをホストします。  
+  
+#### Direct3D9 コンテンツをホストするには  
+  
+1.  MainWindow.xaml で、自動的に生成された XAML を次の XAML に置き換えます。  
+  
+     [!code-xml[System.Windows.Interop.D3DImage#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/CS/window1.xaml#10)]  
+  
+2.  プロジェクトをビルドします。  
+  
+3.  Direct3D9 コンテンツを含む DLL を bin\/Debug フォルダーにコピーします。  
+  
+4.  F5 キーを押してプロジェクトを実行します。  
+  
+     WPF アプリケーションの中に Direct3D9 コンテンツが表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Interop.D3DImage>   
+ [Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md b/docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md
new file mode 100644
index 00000000000..2f854a91969
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md
@@ -0,0 +1,238 @@
+---
+title: "チュートリアル: Win32 での WPF コンテンツのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (WPF コンテンツを Win32 ウィンドウで)"
+ms.assetid: 38ce284a-4303-46dd-b699-c9365b22a7dc
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# チュートリアル: Win32 での WPF コンテンツのホスト
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] コードにかなりの投資がある場合は、元のコードを書き換えるより、アプリケーションに [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の機能を追加するほうがより効果的であることがあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストする簡単なメカニズムがあります。  
+  
+ このチュートリアルでは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするサンプル アプリケーション \(「[Win32 ウィンドウのサンプルで WPF コンテンツをホストする](http://go.microsoft.com/fwlink/?LinkID=160004)」\) の記述方法について説明します。  このサンプルを拡張すると、いずれの [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウでもホストできます。  マネージ コードとアンマネージ コードの混在が関係しているため、このアプリケーションは [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] で記述されます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="requirements"></a>   
+## 必要条件  
+ このチュートリアルは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プログラミングの基礎知識があることを前提としています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプログラミングの基本的な概要については、「[作業の開始](../../../../docs/framework/wpf/getting-started/index.md)」を参照してください。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] のプログラミングの概要については、この主題に関する数多くの書籍、特に「*Programming Windows*」 \(Charles Petzold 著\) を参照することをお勧めします。  
+  
+ このチュートリアルに付属するサンプルは [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] で実装されているため、このチュートリアルでは [!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] を使用した [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] のプログラミングの知識があることと、マネージ コード プログラミングを理解していることを前提としています。  [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] の知識があることは、役立ちますが、必須ではありません。  
+  
+> [!NOTE]
+>  このチュートリアルには、関連するサンプルからのコード例が多数含まれています。  しかし、読みやすくするため、完全なサンプル コードは含まれていません。  完全なサンプル コードについては、「[Win32 ウィンドウのサンプルで WPF コンテンツをホストする](http://go.microsoft.com/fwlink/?LinkID=160004)」を参照してください。  
+  
+<a name="basic_procedure"></a>   
+## 基本手順  
+ このセクションでは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするために使用する基本手順について概説します。  残りのセクションでは、各手順の詳細について説明します。  
+  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をホストする鍵となるのが、<xref:System.Windows.Interop.HwndSource> クラスです。  このクラスは [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをラップし、子ウィンドウとして [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に組み込めるようにすることができます。  次の方法では、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を単一のアプリケーションに統合します。  
+  
+1.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをマネージ クラスとして実装します。  
+  
+2.  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションを [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] で実装します。  既存のアプリケーションとアンマネージの [!INCLUDE[TLA#tla_cpp](../../../../includes/tlasharptla-cpp-md.md)] コードで使用を開始する場合、通常は、プロジェクトの設定を `/clr` コンパイラ フラグを含めるように変更して、マネージ コードを呼び出せるようにします。  
+  
+3.  スレッド処理モデルをシングル スレッド アパートメント \(STA: Single Threaded Apartment\) に設定します。  
+  
+4.  ウィンドウのプロシージャで [WM\_CREATE](http://msdn.microsoft.com/library/ms632619.aspx) を処理してから、以下を実行します。  
+  
+    1.  新しい <xref:System.Windows.Interop.HwndSource> オブジェクトを、親ウィンドウがその `parent` パラメーターとなるように指定して作成します。  
+  
+    2.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ クラスのインスタンスを作成します。  
+  
+    3.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトへの参照を <xref:System.Windows.Interop.HwndSource> の <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティに割り当てます。  
+  
+    4.  コンテンツの HWND を取得します。  <xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.Handle%2A> プロパティにウィンドウ ハンドル \(HWND\) が格納されます。  アプリケーションのアンマネージ部分で使用できる HWND を取得するには、`Handle.ToPointer()` を HWND にキャストします。  
+  
+5.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照を保持する静的フィールドを含むマネージ クラスを実装します。  このクラスを使用すると、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードから [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照を取得できるようになります。  
+  
+6.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを静的フィールドに割り当てます。  
+  
+7.  ハンドラーを 1 つ以上の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベントにアタッチして、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツから通知を受信します。  
+  
+8.  静的フィールドに格納した参照を使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツと通信し、プロパティの設定などを行います。  
+  
+> [!NOTE]
+>  また、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを実装することもできます。  ただし、このコンテンツは [!INCLUDE[TLA#tla_dll](../../../../includes/tlasharptla-dll-md.md)] として別にコンパイルしてから、その [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] に [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションから参照する必要があります。  手順の残りの部分は、前述の手順と同様です。  
+  
+<a name="implementing_the_application"></a>   
+## ホスト アプリケーションの実装  
+ このセクションでは、基本的な [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストする方法について説明します。  コンテンツ自体は、マネージ クラスとして [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] に実装されます。  ほとんどの部分が、簡単な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプログラミングです。  コンテンツの実装の重要な側面については、「[WPF コンテンツの実装](#implementing_the_wpf_page)」で説明します。  
+  
+<a name="autoNestedSectionsOUTLINE1"></a>   
+-   [基本的なアプリケーション](#the_basic_application)  
+  
+-   [WPF コンテンツのホスティング](#hosting_the_wpf_page)  
+  
+-   [WPF コンテンツへの参照の保持](#holding_a_reference)  
+  
+-   [WPF コンテンツとの通信](#communicating_with_the_page)  
+  
+<a name="the_basic_application"></a>   
+### 基本的なアプリケーション  
+ ホスト アプリケーションの開始点は、[!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] テンプレートを作成することでした。  
+  
+1.  [!INCLUDE[TLA2#tla_visualstu2005](../../../../includes/tla2sharptla-visualstu2005-md.md)] を開き、**\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックします。  
+  
+2.  [!INCLUDE[TLA2#tla_visualcpp](../../../../includes/tla2sharptla-visualcpp-md.md)] プロジェクトの種類の一覧から、**Win32** を選択します。  既定の言語が [!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] でない場合は、このプロジェクトの種類は **\[他の言語\]** の下にあります。  
+  
+3.  **\[Win32 プロジェクト\]** テンプレートをクリックし、プロジェクトに名前を割り当ててから、**\[OK\]** をクリックして、**\[Win32 アプリケーション\] ウィザード**を開始します。  
+  
+4.  ウィザードの既定の設定をそのまま承認し、**\[完了\]** をクリックしてプロジェクトを開始します。  
+  
+ このテンプレートは、次のような基本的な [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションを作成します。  
+  
+-   アプリケーションのエントリ ポイント。  
+  
+-   関連するウィンドウ プロシージャ \(WndProc\) を含むウィンドウ。  
+  
+-   **\[ファイル\]** と **\[ヘルプ\]** の各見出しを含むメニュー。  **\[ファイル\]** メニューには、アプリケーションを閉じる **\[終了\]** 項目があります。  **\[ヘルプ\]** メニューには、簡単なダイアログ ボックスを起動する **\[バージョン情報\]** 項目があります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするためにコードを記述する前に、基本のテンプレートに対して 2 つの変更を加える必要があります。  
+  
+ 1 つ目は、プロジェクトをマネージ コードとしてコンパイルすることです。  既定では、プロジェクトはアンマネージ コードとしてコンパイルされます。  ただし、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] はマネージ コードで実装されているため、プロジェクトは状況に応じてコンパイルする必要があります。  
+  
+1.  **ソリューション エクスプローラー**で、プロジェクト名を右クリックし、コンテキスト メニューの **\[プロパティ\]** をクリックして、**\[プロパティ ページ\]** ダイアログ ボックスを開始します。  
+  
+2.  左ペインにあるツリー ビューで、**\[構成プロパティ\]** を選択します。  
+  
+3.  右ペインの **\[プロジェクトの詳細\]** の一覧から、”**共通言語ランタイム** サポート” を選択します。  
+  
+4.  ドロップダウン リスト ボックスから**共通言語ランタイム サポート \(\/clr\)** を選択します。  
+  
+> [!NOTE]
+>  このコンパイラ フラグを使用すると、アプリケーションでマネージ コードを使用できますが、アンマネージ コードは以前と同様にコンパイルされます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、シングル スレッド アパートメント \(STA\) スレッド処理モデルを使用します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのコードで正常に機能するためには、エントリ ポイントに属性を適用してアプリケーションのスレッド処理モデルを STA に設定する必要があります。  
+  
+ [!code-cpp[Win32HostingWPFPage#WinMain](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.cpp#winmain)]  
+  
+<a name="hosting_the_wpf_page"></a>   
+### WPF コンテンツのホスティング  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、単純なアドレス入力アプリケーションです。  それは、ユーザー名やアドレスなどを取得する複数の <xref:System.Windows.Controls.TextBox> コントロールで構成されています。  さらに、**\[OK\]** と **\[キャンセル\]** という 2 つの <xref:System.Windows.Controls.Button> コントロールがあります。  ユーザーが **\[OK\]** をクリックすると、ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーは <xref:System.Windows.Controls.TextBox> コントロールからデータを収集し、それを対応するプロパティに割り当て、カスタム イベント `OnButtonClicked` を発生させます。  ユーザーが **\[キャンセル\]** をクリックすると、ハンドラーは単に `OnButtonClicked` を発生させます。  `OnButtonClicked` のイベント引数オブジェクトには、どのボタンをクリックしたかを示すブール型フィールドが含まれています。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするコードは、ホスト ウィンドウで [WM\_CREATE](http://msdn.microsoft.com/library/ms632619.aspx) 通知を行うためにハンドラーに実装されます。  
+  
+ [!code-cpp[Win32HostingWPFPage#WMCreate](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.cpp#wmcreate)]  
+  
+ `GetHwnd` メソッドは、サイズと位置の情報および親ウィンドウ ハンドルを取得し、ホストされた [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのウィンドウ ハンドルを返します。  
+  
+> [!NOTE]
+>  `System::Windows::Interop` 名前空間に `#using` ディレクティブを使用することはできません。  使用すると、その名前空間の <xref:System.Windows.Interop.MSG> 構造体と winuser.h で宣言した MSG 構造体の間で名前の競合が発生します。  代わりに、その名前空間のコンテンツにアクセスするための完全修飾名を使用する必要があります。  
+  
+ [!code-cpp[Win32HostingWPFPage#GetHwnd](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.cpp#gethwnd)]  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコンテンツを直接アプリケーション ウィンドウでホストすることはできません。  代わりに、まず [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをラップするための <xref:System.Windows.Interop.HwndSource> オブジェクトを作成します。  このオブジェクトは、基本的に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするように設計されたウィンドウです。  <xref:System.Windows.Interop.HwndSource> オブジェクトをアプリケーションの一部である [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの子として作成することで、このオブジェクトを親ウィンドウでホストします。  <xref:System.Windows.Interop.HwndSource> コンストラクターのパラメーターには、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] の子ウィンドウの作成時に CreateWindow に渡される情報とほとんど同じ情報が含まれています。  
+  
+ 次に、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトのインスタンスを作成します。  この場合は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、[!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] を使用して、別のクラス `WPFPage` として実装されます。  さらに、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で実装することもできます。  ただし、これを行うためには、別のプロジェクトをセットアップしてから、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] としてビルドする必要があります。  プロジェクトにその [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] への参照を追加し、その参照を使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのインスタンスを作成します。  
+  
+ <xref:System.Windows.Interop.HwndSource> の <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティに [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照を割り当てることで、子ウィンドウに [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを表示します。  
+  
+ 次のコード行は、イベント ハンドラー `WPFButtonClicked` を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツの `OnButtonClicked` イベントにアタッチしています。  このハンドラーは、ユーザーが **\[OK\]** または **\[キャンセル\]** ボタンをクリックすると呼び出されます。  このイベント ハンドラーの詳細な説明については「[communicating\_with\_the\_WPF コンテンツ](#communicating_with_the_page)」を参照してください。  
+  
+ 示されているコードの最後の行は、<xref:System.Windows.Interop.HwndSource> オブジェクトに関連付けられているウィンドウ ハンドル \(HWND\) を返します。  このハンドルは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードから使用してホストされたウィンドウにメッセージを送信することができます。ただし、サンプルではこれはできません。  <xref:System.Windows.Interop.HwndSource> オブジェクトは、メッセージを受信するたびにイベントを発生させます。  メッセージを処理するには、<xref:System.Windows.Interop.HwndSource.AddHook%2A> メソッドを呼び出してメッセージ ハンドラーをアタッチしてから、そのハンドラーでメッセージを処理します。  
+  
+<a name="holding_a_reference"></a>   
+### WPF コンテンツへの参照の保持  
+ 多くのアプリケーションでは、後で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツと通信することができます。  たとえば、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのプロパティを変更したり、場合によっては <xref:System.Windows.Interop.HwndSource> オブジェクトが異なる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストするようにしたりできます。  そのためには、<xref:System.Windows.Interop.HwndSource> オブジェクトまたは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照が必要です。  <xref:System.Windows.Interop.HwndSource> オブジェクトと関連する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、ウィンドウ ハンドルを破棄するまでメモリに残ります。  ただし、<xref:System.Windows.Interop.HwndSource> オブジェクトに割り当てる変数は、ウィンドウ プロシージャから戻ると同時にスコープの外に出ます。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションでこの問題を処理するためによく使用される方法は、静的変数またはグローバル変数を使用することです。  残念ながら、このような変数の種類に対してマネージ オブジェクトを割り当てることはできません。  <xref:System.Windows.Interop.HwndSource> オブジェクトに関連付けられているウィンドウ ハンドルを、グローバル変数または静的変数に割り当てることができますが、オブジェクト自体にアクセスすることはできません。  
+  
+ この問題の最も簡単な解決法は、静的フィールドのセットを含むマネージ クラスを実装して、アクセスが必要なすべてのマネージ オブジェクトへの参照を保持することです。  サンプルでは、`WPFPageHost` クラスを使用して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照、および後でユーザーが変更する可能性があるプロパティの数の初期値を保持します。  これは、ヘッダーで定義します。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageHost](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.h#wpfpagehost)]  
+  
+ `GetHwnd` 関数の後半部分では、後に、`myPage` がスコープ内にある間に使用するため、対象のフィールドに値を割り当てます。  
+  
+<a name="communicating_with_the_page"></a>   
+### WPF コンテンツとの通信  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツとの通信には次の 2 種類があります。  アプリケーションは、ユーザーが **\[OK\]** または **\[キャンセル\]** ボタンをクリックすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツから情報を受信します。  アプリケーションには、背景色や既定のフォント サイズなどのさまざまな [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのプロパティをユーザーが変更できるようにする [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] があります。  
+  
+ 前述のように、ユーザーがいずれかのボタンをクリックすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは `OnButtonClicked` イベントを発生させます。  アプリケーションは、これらの通知を受信するため、このイベントにハンドラーをアタッチします。  **\[OK\]** ボタンがクリックされた場合、ハンドラーはユーザー情報を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツから取得し、一連の静的コントロールで表示します。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFButtonClicked](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.cpp#wpfbuttonclicked)]  
+  
+ ハンドラーは、カスタム イベント引数オブジェクトを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコンテンツ、`MyPageEventArgs` から受信します。  **\[OK\]** ボタンをクリックした場合、オブジェクトの `IsOK` プロパティは `true` に設定されます。**\[キャンセル\]** ボタンをクリックした場合は `false` に設定されます。  
+  
+ **\[OK\]** ボタンをクリックした場合、ハンドラーはコンテナー クラスから [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツへの参照を取得します。  その後、関連する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ プロパティが保持するユーザー情報を収集し、静的コントロールを使用して親ウィンドウに情報を表示します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ データは、マネージ文字列の形式であるため、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールによってマーシャリングする必要があります。  **\[キャンセル\]** ボタンがクリックされた場合、ハンドラーは、スタティック コントロールからのデータをクリアします。  
+  
+ アプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] には、ユーザーが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツの背景色を変更できるようにするラジオ ボタンのセット、および複数のフォント関連のプロパティが用意されています。  次の例は、アプリケーションのウィンドウ プロシージャ \(WndProc\)、および背景色など、各種のメッセージに対してさまざまなプロパティを設定するそのプロシージャのメッセージ処理からの抜粋です。  その他は類似しているため、示していません。  詳細とコンテキストについては、完全なサンプルを参照してください。  
+  
+ [!code-cpp[Win32HostingWPFPage#WMCommandToBG](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/Win32HostingWPFPage.cpp#wmcommandtobg)]  
+  
+ 背景色を設定するには、`WPFPageHost` から [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ \(`hostedPage`\) への参照を取得して、背景色のプロパティを適切な色に設定します。  サンプルでは、元の色、明るい緑、または明るいサーモン色の 3 つの色のオプションを使用します。  元の背景色は静的フィールドとして `WPFPageHost` クラスに格納されます。  他の 2 つの色を設定するには、新しい <xref:System.Windows.Media.SolidColorBrush> オブジェクトを作成して、<xref:System.Windows.Media.Colors> オブジェクトからコンストラクターに静的な色の値を渡します。  
+  
+<a name="implementing_the_wpf_page"></a>   
+## WPF ページの実装  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、実際の実装の知識がなくてもホストして、使用できます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツが個別の [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] にパッケージ化されていた場合は、いずれの [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] 言語で構築できました。  以下は、このサンプルで使用する [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] の実装の簡単なチュートリアルです。  このセクションには、次のサブセクションが含まれています。  
+  
+<a name="autoNestedSectionsOUTLINE2"></a>   
+-   [レイアウト](#page_layout)  
+  
+-   [データをホスト ウィンドウに返す](#returning_data_to_window)  
+  
+-   [WPF のプロパティを設定する](#set_page_properties)  
+  
+<a name="page_layout"></a>   
+### レイアウト  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素は、5 つの <xref:System.Windows.Controls.TextBox> コントロールと、関連する <xref:System.Windows.Controls.Label> コントロール \(名前、住所、市区町村、都道府県、および郵便番号\) で構成しています。  さらに、**\[OK\]** と **\[キャンセル\]** という 2 つの <xref:System.Windows.Controls.Button> コントロールがあります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは `WPFPage` クラスに実装されています。  レイアウトは、<xref:System.Windows.Controls.Grid> レイアウト要素で処理されます。  クラスは <xref:System.Windows.Controls.Grid> から継承されます。これにより、クラスは効果的に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのルート要素になります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのコンストラクターは、必要な幅と高さを指定し、それに合わせて <xref:System.Windows.Controls.Grid> のサイズを指定します。  その後、コンストラクターは、<xref:System.Windows.Controls.ColumnDefinition> オブジェクトと <xref:System.Windows.Controls.RowDefinition> オブジェクトのセットを作成してから、それらを <xref:System.Windows.Controls.Grid> オブジェクトの基本の <xref:System.Windows.Controls.Grid.ColumnDefinitions%2A> および <xref:System.Windows.Controls.Grid.RowDefinitions%2A> コレクションにそれぞれ追加することで、基本のレイアウトを定義します。  これにより、5 つの行と、7 つの列のグリッドが定義され、セルの内容によって大きさが決定します。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageCtorToGridDef](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagectortogriddef)]  
+  
+ 次に、コンストラクターは [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を <xref:System.Windows.Controls.Grid> に追加します。  最初の要素はタイトルのテキストです。これは、グリッドの 1 行目の中央に表示される <xref:System.Windows.Controls.Label> コントロールです。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageCtorTitle](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagectortitle)]  
+  
+ 次の行には、名前の <xref:System.Windows.Controls.Label> コントロールと関連する <xref:System.Windows.Controls.TextBox> コントロールが格納されます。  ラベルとテキスト ボックスの各ペアに同じコードが使用されるため、コードはプライベート メソッドのペアに配置され、5 つのラベルとテキスト ボックスのペアすべてに使用されます。  メソッドは適切な制御を作成し、<xref:System.Windows.Controls.Grid> クラスの静的な <xref:System.Windows.Controls.Grid.SetColumn%2A> および <xref:System.Windows.Controls.Grid.SetRow%2A> メソッドを呼び出して、適切なセルにコントロールを配置します。  コントロールが作成されると、サンプルは <xref:System.Windows.Controls.Grid> の <xref:System.Windows.Controls.Panel.Children%2A> プロパティの <xref:System.Windows.Controls.UIElementCollection.Add%2A> メソッドを呼び出して、グリッドにコントロールを追加します。  残りのラベルとテキスト ボックスのペアを追加するコードは似ています。  詳細については、サンプル コードを参照してください。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageCtorName](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagectorname)]  
+  
+ 2 つのメソッドの実装は、次のとおりです。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageCreateHelpers](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagecreatehelpers)]  
+  
+ 最後に、サンプルでは **\[OK\]** ボタンと **\[キャンセル\]** ボタンが追加され、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントにイベント ハンドラーがアタッチされます。  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageCtorButtonsEvents](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagectorbuttonsevents)]  
+  
+<a name="returning_data_to_window"></a>   
+### データをホスト ウィンドウに返す  
+ いずれかのボタンをクリックすると、その <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントが発生します。  ホスト ウィンドウはこれらのイベントにハンドラーをアタッチして、<xref:System.Windows.Controls.TextBox> コントロールから直接データを取得します。  サンプルは、いくぶん直接的ではない方法を使用します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ内で <xref:System.Windows.Controls.Primitives.ButtonBase.Click> が処理され、カスタム イベント `OnButtonClicked` が生成されて、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツに通知されます。  これにより、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツがホストに通知する前にパラメーターの検証を実行します。  ハンドラーは、<xref:System.Windows.Controls.TextBox> コントロールからテキストを取得し、パブリック プロパティに割り当てます。ここからホストは情報を取得します。  
+  
+ WPFPage.h でのイベント宣言:  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageEventDecl](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.h#wpfpageeventdecl)]  
+  
+ WPFPage.cpp での <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラー:  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageButtonClicked](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagebuttonclicked)]  
+  
+<a name="set_page_properties"></a>   
+### WPF のプロパティを設定する  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ホストでは、ユーザーがいくつかの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのプロパティを変更できるようにします。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 側では、これはプロパティの変更の問題にすぎません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコンテンツ クラスの実装はいくらか複雑になります。これは、全コントロールのフォントを制御する 1 つのグローバル プロパティがないためです。  代わりに、各コントロールの適切なプロパティは、プロパティの set アクセサーで変更されます。  次の例は、`DefaultFontFamily` プロパティのコードを示しています。  プロパティを設定すると、プライベート メソッドが呼び出され、さまざまなコントロールに <xref:System.Windows.Controls.Control.FontFamily%2A> プロパティが設定されます。  
+  
+ WPFPage.h から:  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageFontFamilyProperty](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.h#wpfpagefontfamilyproperty)]  
+  
+ WPFPage.cpp から:  
+  
+ [!code-cpp[Win32HostingWPFPage#WPFPageSetFontFamily](../../../../samples/snippets/cpp/VS_Snippets_Wpf/Win32HostingWPFPage/CPP/WPFPage.cpp#wpfpagesetfontfamily)]  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndSource>   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-localizing-a-hybrid-application.md b/docs/framework/wpf/advanced/walkthrough-localizing-a-hybrid-application.md
new file mode 100644
index 00000000000..56cc3292abe
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-localizing-a-hybrid-application.md
@@ -0,0 +1,180 @@
+---
+title: "チュートリアル : ハイブリッド アプリケーションのローカライズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ハイブリッド アプリケーション [WPF 相互運用性]"
+  - "ローカリゼーション [WPF 相互運用性]"
+ms.assetid: fbc0c54e-930a-4c13-8e9c-27b83665010a
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# チュートリアル : ハイブリッド アプリケーションのローカライズ
+このチュートリアルでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのハイブリッド アプリケーション内にある [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] 要素をローカライズする方法を示します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ホスト プロジェクトを作成する。  
+  
+-   ローカライズ可能な内容を追加する。  
+  
+-   ローカライズを有効にする。  
+  
+-   リソース識別子を割り当てる。  
+  
+-   LocBaml ツールを使用してサテライト アセンブリを生成する。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[ハイブリッド アプリケーションのローカライズのサンプル](http://go.microsoft.com/fwlink/?LinkID=160015)を参照してください。  
+  
+ 終了すると、ローカライズされたハイブリッド アプリケーションが作成されています。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)].  
+  
+## Windows フォームのホスト プロジェクトの作成  
+ 最初に [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーション プロジェクトを作成し、内容をローカライズする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素を追加します。  
+  
+#### ホスト プロジェクトを作成するには  
+  
+1.  `LocalizingWpfInWf` という名前の WPF アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  `SimpleControl` という [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.UserControl> 要素をプロジェクトに追加します。  
+  
+3.  <xref:System.Windows.Forms.Integration.ElementHost> コントロールを使用して、フォームに `SimpleControl` 要素を配置します。  詳細については、「[チュートリアル: Windows フォームでの 3D WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-3-d-wpf-composite-control-in-windows-forms.md)」を参照してください。  
+  
+## ローカライズ可能な内容を追加する  
+ 次に、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ラベル コントロールを追加し、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の内容にローカライズ可能な文字列を設定します。  
+  
+#### ローカライズ可能な内容を追加する手順  
+  
+1.  ソリューション エクスプローラーで **\[SimpleControl.xaml\]** をダブルクリックして、[!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]でそのファイルを開きます。  
+  
+2.  次のコードを使用している <xref:System.Windows.Controls.Button> コントロールの内容を設定します。  
+  
+     [!code-xml[LocalizingWpfInWf#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizingWpfInWf/CSharp/SimpleControl0.xaml#10)]  
+  
+3.  ソリューション エクスプローラーで **\[Form1\]** をダブルクリックして Windows フォーム デザイナーを開きます。  
+  
+4.  ツールボックスを開いて、**\[ラベル\]** をダブルクリックし、フォームにラベル コントロールを追加します。  <xref:System.Windows.Forms.Control.Text%2A> プロパティの値を`「Hello」`に設定します。  
+  
+5.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+     `SimpleControl` 要素とラベル コントロールにより、テキスト **\[Hello\]** が表示されます。  
+  
+## ローカライズを有効にする  
+ Windows フォーム デザイナーでは、サテライト アセンブリのローカライズを有効にする設定を行うことができます。  
+  
+#### ローカライズを有効にする手順  
+  
+1.  ソリューション エクスプローラーで、**\[Form1.cs\]** をダブルクリックして Windows フォーム デザイナーで開きます。  
+  
+2.  \[プロパティ\] ウィンドウで、フォームの **\[ローカライズ可能\]** プロパティを `true` に設定します。  
+  
+3.  \[プロパティ\] ウィンドウで、**\[言語\]** プロパティを **\[スペイン語 \(スペイン\)\]** に設定します。  
+  
+4.  Windows フォーム デザイナーで、ラベル コントロールを選択します。  
+  
+5.  \[プロパティ\] ウィンドウで、<xref:System.Windows.Forms.Control.Text%2A> プロパティの値を`「Hola」`に設定します。  
+  
+     Form1.es\-ES.resx という名前の新しいリソース ファイルが、プロジェクトに追加されます。  
+  
+6.  ソリューション エクスプローラーで、**\[Form1.cs\]** を右クリックし、**\[コードの表示\]** をクリックしてコード エディターで開きます。  
+  
+7.  `InitializeComponent` の呼び出しの前にある `Form1` コンストラクターに次のコードをコピーします。  
+  
+     [!code-csharp[LocalizingWpfInWf#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizingWpfInWf/CSharp/Form1.cs#2)]  
+  
+8.  ソリューション エクスプローラーで、**\[LocalizingWpfInWf\]** を右クリックし、**\[プロジェクトのアンロード\]** をクリックします。  
+  
+     プロジェクト名に **\(利用不可\)** のマークが付きます。  
+  
+9. **\[LocalizingWpfInWf\]** を右クリックし、**\[LocalizingWpfInWf.csproj の編集\]** をクリックします。  
+  
+     コード エディターでプロジェクト ファイルが開きます。  
+  
+10. プロジェクト ファイルの最初の `PropertyGroup` に次の行をコピーします。  
+  
+    ```  
+    <UICulture>en-US</UICulture>   
+    ```  
+  
+11. プロジェクト ファイルを保存して閉じます。  
+  
+12. ソリューション エクスプローラーで、**\[LocalizingWpfInWf\]** を右クリックし、**\[プロジェクトの再読み込み\]** をクリックします。  
+  
+## リソース識別子を割り当てる  
+ リソース識別子を使用すると、ローカライズ可能な内容をリソース アセンブリにマッピングできます。  `updateuid` オプションを指定すると、MsBuild.exe アプリケーションが自動的にリソース識別子を割り当てます。  
+  
+#### リソース識別子を割り当てる手順  
+  
+1.  \[スタート\] メニューから、[!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] コマンド プロンプトを開きます。  
+  
+2.  次のコマンドを使用して、ローカライズ可能な内容にリソース識別子を割り当てます。  
+  
+    ```  
+    msbuild /t:updateuid LocalizingWpfInWf.csproj  
+    ```  
+  
+3.  ソリューション エクスプローラーで、\[SimpleControl.xaml\] をダブルクリックして、コード エディターでそのファイルを開きます。  `msbuild` コマンドによって、すべての要素に `Uid` 属性が追加されています。  これにより、リソース識別子の割り当てを用いたローカライズが容易になります。  
+  
+     [!code-xml[LocalizingWpfInWf#20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizingWpfInWf/CSharp/SimpleControl.xaml#20)]  
+  
+4.  F6 キーを押してソリューションをビルドします。  
+  
+## LocBaml を使用してサテライト アセンブリを生成する  
+ ローカライズされた内容は、リソース専用*サテライト アセンブリ*に格納されています。  LocBaml.exe コマンド ライン ツールを使用して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内容のローカライズされたアセンブリを生成します。  
+  
+#### サテライト アセンブリを生成する手順  
+  
+1.  プロジェクトの obj\\Debug フォルダーに LocBaml.exe をコピーします。  詳細については、「[アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)」を参照してください。  
+  
+2.  コマンド プロンプト ウィンドウで、次のコマンドを使用してテンポラリ ファイルにリソース文字列を抽出します。  
+  
+    ```  
+    LocBaml /parse LocalizingWpfInWf.g.en-US.resources /out:temp.csv  
+    ```  
+  
+3.  [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] または別のテキスト エディターで temp.csv ファイルを開きます。  文字列 `"Hello"` をそのスペイン語の訳語 `"Hola"` に置き換えます。  
+  
+4.  temp.csv ファイルを保存します。  
+  
+5.  次のコマンドを使用して、ローカライズされたリソース ファイルを生成します。  
+  
+    ```  
+    LocBaml /generate /trans:temp.csv LocalizingWpfInWf.g.en-US.resources /out:. /cul:es-ES  
+    ```  
+  
+     LocalizingWpfInWf.g.es\-ES.resources ファイルは、obj\\Debug フォルダーに作成されます。  
+  
+6.  次のコマンドを使用して、ローカライズされたサテライト アセンブリを作成します。  
+  
+    ```  
+    Al.exe /out:LocalizingWpfInWf.resources.dll /culture:es-ES /embed:LocalizingWpfInWf.Form1.es-ES.resources /embed:LocalizingWpfInWf.g.es-ES.resources  
+    ```  
+  
+     LocalizingWpfInWf.resources.dll ファイルは、obj\\Debug フォルダーに作成されます。  
+  
+7.  プロジェクトの bin\\Debug\\es\-ES フォルダーに LocalizingWpfInWf.resources.dll ファイルをコピーします。  既存のファイルを置き換えます。  
+  
+8.  プロジェクトの bin\\Debug フォルダーにある LocalizingWpfInWf.exe を実行します。  サテライト アセンブリが上書きされるので、アプリケーションを再度ビルドしないでください。  
+  
+     アプリケーションにより、英語の文字列の代わりにローカライズされた文字列が表示されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)   
+ [Walkthrough: Localizing Windows Forms](http://msdn.microsoft.com/ja-jp/9a96220d-a19b-4de0-9f48-01e5d82679e5)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-elementhost-control.md b/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-elementhost-control.md
new file mode 100644
index 00000000000..f572687d55d
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-elementhost-control.md
@@ -0,0 +1,150 @@
+---
+title: "チュートリアル : ElementHost コントロールを使用したプロパティの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ElementHost コントロール, 割り当て (プロパティを)"
+  - "割り当て (プロパティを)"
+ms.assetid: bccd6e0d-2272-4924-9107-ff8ed58b88aa
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# チュートリアル : ElementHost コントロールを使用したプロパティの割り当て
+このチュートリアルでは、<xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A> プロパティを使用して、ホストされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の対応するプロパティに [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] プロパティを割り当てる方法を示します。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトの作成。  
+  
+-   新しいプロパティ マッピングの定義。  
+  
+-   既定のプロパティ マッピングの削除。  
+  
+-   既定のプロパティ マッピングの拡張。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、[ElementHost コントロールを使用したプロパティの割り当てのサンプル](http://go.microsoft.com/fwlink/?LinkID=160018)を参照してください。  
+  
+ 終了すると、ホストされている要素の対応する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティに [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] プロパティを割り当てることができるようになります。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)].  
+  
+## プロジェクトの作成  
+  
+#### プロジェクトを作成するには  
+  
+1.  `PropertyMappingWithElementHost` という名前の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーション プロジェクトを作成します。  詳細については、「[How to: Create a Windows Application Project](http://msdn.microsoft.com/ja-jp/b2f93fed-c635-4705-8d0e-cf079a264efa)」を参照してください。  
+  
+2.  ソリューション エクスプローラーで、次の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アセンブリへの参照を追加します。  
+  
+    -   PresentationCore  
+  
+    -   PresentationFramework  
+  
+    -   WindowsBase  
+  
+    -   WindowsFormsIntegration  
+  
+3.  次のコードを `Form1` コード ファイルの先頭にコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#10)]
+     [!code-vb[PropertyMappingWithElementHost#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#10)]  
+  
+4.  Windows フォーム デザイナーで `Form1` を開きます。  フォームをダブルクリックして <xref:System.Windows.Forms.Form.Load> イベントのイベント ハンドラーを追加します。  
+  
+5.  Windows フォーム デザイナーに戻り、フォームの <xref:System.Windows.Forms.Control.Resize> イベントのイベント ハンドラーを追加します。  詳細については、「[How to: Create Event Handlers Using the Designer](http://msdn.microsoft.com/ja-jp/8461e9b8-14e8-406f-936e-3726732b23d2)」を参照してください。  
+  
+6.  `Form1` クラス内に、<xref:System.Windows.Forms.Integration.ElementHost> フィールドを宣言します。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#16)]
+     [!code-vb[PropertyMappingWithElementHost#16](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#16)]  
+  
+## 新しいプロパティ割り当ての定義  
+ <xref:System.Windows.Forms.Integration.ElementHost> コントロールには、既定のプロパティ割り当てがいくつか用意されています。  新しいプロパティ割り当てを追加するには、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A> で <xref:System.Windows.Forms.Integration.PropertyMap.Add%2A> メソッドを呼び出します。  
+  
+#### 新しいプロパティ割り当てを定義するには  
+  
+1.  `Form1` クラスの定義に次のコードをコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#12)]
+     [!code-vb[PropertyMappingWithElementHost#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#12)]  
+  
+     `AddMarginMapping` メソッドは、<xref:System.Windows.Forms.Control.Margin%2A> プロパティの新しいマッピングを追加します。  
+  
+     `OnMarginChange` メソッドは、<xref:System.Windows.Forms.Control.Margin%2A> プロパティを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の <xref:System.Windows.FrameworkElement.Margin%2A> プロパティに変換します。  
+  
+2.  `Form1` クラスの定義に次のコードをコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#14)]
+     [!code-vb[PropertyMappingWithElementHost#14](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#14)]  
+  
+     `AddRegionMapping` メソッドは、<xref:System.Windows.Forms.Control.Region%2A> プロパティの新しいマッピングを追加します。  
+  
+     `OnRegionChange` メソッドは、<xref:System.Windows.Forms.Control.Region%2A> プロパティを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の <xref:System.Windows.UIElement.Clip%2A> プロパティに変換します。  
+  
+     `Form1_Resize` メソッドは、フォームの <xref:System.Windows.Forms.Control.Resize> イベントを処理し、ホストされている要素に合わせてクリッピング領域のサイズを設定します。  
+  
+## 既定のプロパティ マッピングの削除  
+ 既定のプロパティ割り当てを削除するには、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A> で <xref:System.Windows.Forms.Integration.PropertyMap.Remove%2A> メソッドを呼び出します。  
+  
+#### 既定のプロパティ マッピングを削除するには  
+  
+-   `Form1` クラスの定義に次のコードをコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#13)]
+     [!code-vb[PropertyMappingWithElementHost#13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#13)]  
+  
+     `RemoveCursorMapping` メソッドは、<xref:System.Windows.Forms.Control.Cursor%2A> プロパティの既定のマッピングを削除します。  
+  
+## 既定のプロパティ マッピングの拡張  
+ 既定のプロパティ マッピングを使用したり、それをユーザー独自のマッピングで拡張することもできます。  
+  
+#### 既定のプロパティ マッピングを拡張するには  
+  
+-   `Form1` クラスの定義に次のコードをコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#15)]
+     [!code-vb[PropertyMappingWithElementHost#15](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#15)]  
+  
+     `ExtendBackColorMapping` メソッドは、カスタム プロパティ トランスレータを既存の <xref:System.Windows.Forms.Control.BackColor%2A> プロパティ マッピングに追加します。  
+  
+     `OnBackColorChange` メソッドは、特定のイメージをホストされているコントロールの <xref:System.Windows.Controls.Control.Background%2A> プロパティに割り当てます。  `OnBackColorChange` メソッドは、既定のプロパティ マッピングの適用後に呼び出されます。  
+  
+## プロパティ マッピングの初期化  
+  
+#### プロパティ マッピングを初期化するには  
+  
+1.  `Form1` クラスの定義に次のコードをコピーします。  
+  
+     [!code-csharp[PropertyMappingWithElementHost#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithElementHost/CSharp/PropertyMappingWithElementHost/Form1.cs#11)]
+     [!code-vb[PropertyMappingWithElementHost#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithElementHost/VisualBasic/PropertyMappingWithElementHost/Form1.vb#11)]  
+  
+     `Form1_Load` メソッドは <xref:System.Windows.Forms.Form.Load> イベントを処理し、次の初期化を実行します。  
+  
+    -   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.Button> 要素を作成します。  
+  
+    -   このチュートリアルで定義したメソッドを呼び出して、プロパティ マッピングを設定します。  
+  
+    -   マップされたプロパティに初期値を割り当てます。  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-windowsformshost-element.md b/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-windowsformshost-element.md
new file mode 100644
index 00000000000..944b13b6ebd
--- /dev/null
+++ b/docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-windowsformshost-element.md
@@ -0,0 +1,160 @@
+---
+title: "チュートリアル : WindowsFormsHost 要素を使用したプロパティの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "割り当て (プロパティを)"
+  - "WindowsFormsHost 要素のプロパティの割り当て"
+ms.assetid: 74809167-bf8e-48b7-a2e7-b4ea08bc7d8c
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# チュートリアル : WindowsFormsHost 要素を使用したプロパティの割り当て
+このチュートリアルで使用する方法、<xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A>プロパティにマップする[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、ホスト型の対応するプロパティにプロパティ[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロール。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   プロジェクトを作成しています。  
+  
+-   アプリケーションのレイアウトを定義します。  
+  
+-   新しいプロパティ マッピングを定義します。  
+  
+-   プロパティの既定のマッピングを削除しています。  
+  
+-   プロパティの既定のマッピングを交換してください。  
+  
+-   プロパティの既定のマッピングを拡張しています。  
+  
+ このチュートリアルで示すタスクの完全なコード一覧については、次を参照してください。 [WindowsFormsHost 要素のサンプルを使用してマッピング プロパティ](http://go.microsoft.com/fwlink/?LinkID=160019)します。  
+  
+ マップが完了したらができます[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、ホスト型に対応するプロパティをプロパティ[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールです。  
+  
+## <a name="prerequisites"></a>必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)]。  
+  
+## <a name="creating-the-project"></a>プロジェクトの作成  
+  
+#### <a name="to-create-and-set-up-the-project"></a>作成し、プロジェクトを設定するには  
+  
+1.  という名前の WPF アプリケーション プロジェクトを作成する`PropertyMappingWithWfhSample`です。  
+  
+2.  ソリューション エクスプ ローラーでは、WindowsFormsIntegration.dll と呼ばれる WindowsFormsIntegration アセンブリへの参照を追加します。  
+  
+3.  ソリューション エクスプ ローラーでは、System.Drawing、および System.Windows.Forms アセンブリへの参照を追加します。  
+  
+## <a name="defining-the-application-layout"></a>アプリケーションのレイアウトを定義します。  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]-ベースのアプリケーションで使用する、 <xref:System.Windows.Forms.Integration.WindowsFormsHost>ホストへの要素、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]コントロールです。  
+  
+#### <a name="to-define-the-application-layout"></a>アプリケーションのレイアウトを定義するには  
+  
+1.  Window1.xaml を開き、[!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]です。  
+  
+2.  既存のコードを次のコードに置き換えます。  
+  
+     [!code-xml[PropertyMappingWithWfhSample#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml#1)]  
+  
+3.  Window1.xaml.cs のコード エディターでを開きます。  
+  
+4.  ファイルの上部にある次の名前空間をインポートします。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#20)]
+     [!code-vb[PropertyMappingWithWfhSample#20](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#20)]  
+  
+## <a name="defining-a-new-property-mapping"></a>新しいプロパティ マッピングを定義します。  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>要素は、いくつかの既定のプロパティ マッピングを提供します。 新しいプロパティ割り当てを追加するには呼び出すことによって、<xref:System.Windows.Forms.Integration.PropertyMap.Add%2A>メソッドを<xref:System.Windows.Forms.Integration.WindowsFormsHost>要素の<xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A>します。  
+  
+#### <a name="to-define-a-new-property-mapping"></a>新しいプロパティ マッピングを定義するには  
+  
+-   定義に次のコードをコピー、`Window1`クラスです。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#14)]
+     [!code-vb[PropertyMappingWithWfhSample#14](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#14)]  
+  
+     `AddClipMapping`メソッドは、新しいマッピングを追加、<xref:System.Windows.UIElement.Clip%2A>プロパティです。  
+  
+     `OnClipChange`メソッドは、変換、<xref:System.Windows.UIElement.Clip%2A>プロパティを[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]<xref:System.Windows.Forms.Control.Region%2A>プロパティです。  
+  
+     `Window1_SizeChanged`メソッドは処理ウィンドウの<xref:System.Windows.FrameworkElement.SizeChanged>イベントがアプリケーション ウィンドウに合わせてクリッピング領域のサイズを設定するとします。  
+  
+## <a name="removing-a-default-property-mapping"></a>プロパティの既定のマッピングを削除します。  
+ プロパティの既定のマッピングを削除する、<xref:System.Windows.Forms.Integration.PropertyMap.Remove%2A>メソッドを<xref:System.Windows.Forms.Integration.WindowsFormsHost>要素の<xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A>します。  
+  
+#### <a name="to-remove-a-default-property-mapping"></a>プロパティの既定のマッピングを削除するには  
+  
+-   定義に次のコードをコピー、`Window1`クラスです。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#13)]
+     [!code-vb[PropertyMappingWithWfhSample#13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#13)]  
+  
+     `RemoveCursorMapping`メソッドの既定のマッピングを削除する、<xref:System.Windows.FrameworkElement.Cursor%2A>プロパティです。  
+  
+## <a name="replacing-a-default-property-mapping"></a>プロパティの既定のマッピングを置き換える  
+ 既定のマッピングと呼び出しを削除することでプロパティの既定のマッピングを置き換える、<xref:System.Windows.Forms.Integration.PropertyMap.Add%2A>メソッドを<xref:System.Windows.Forms.Integration.WindowsFormsHost>要素の<xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A>します。  
+  
+#### <a name="to-replace-a-default-property-mapping"></a>プロパティの既定のマッピングを置換するには  
+  
+-   定義に次のコードをコピー、`Window1`クラスです。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#12)]
+     [!code-vb[PropertyMappingWithWfhSample#12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#12)]  
+  
+     `ReplaceFlowDirectionMapping`メソッドは、置換の既定のマッピング、 <xref:System.Windows.FrameworkElement.FlowDirection%2A>プロパティです。  
+  
+     `OnFlowDirectionChange`メソッドは、変換、 <xref:System.Windows.FrameworkElement.FlowDirection%2A>プロパティを[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] <xref:System.Windows.Forms.Control.RightToLeft%2A>プロパティです。  
+  
+     `cb_CheckedChanged`メソッド ハンドル、 <xref:System.Windows.Forms.CheckBox.CheckedChanged>でイベントを<xref:System.Windows.Forms.CheckBox>コントロールです。 割り当て、 <xref:System.Windows.FrameworkElement.FlowDirection%2A>プロパティの値に基づいて、 <xref:System.Windows.Forms.CheckBox.CheckState%2A>プロパティ  
+  
+## <a name="extending-a-default-property-mapping"></a>プロパティの既定のマッピングを拡張します。  
+ プロパティの既定のマッピングを使用し、また独自のマッピングでは拡張できます。  
+  
+#### <a name="to-extend-a-default-property-mapping"></a>プロパティの既定のマッピングを拡張するには  
+  
+-   定義に次のコードをコピー、`Window1`クラスです。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#15)]
+     [!code-vb[PropertyMappingWithWfhSample#15](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#15)]  
+  
+     `ExtendBackgroundMapping`メソッドでは、カスタム プロパティの翻訳者を追加すると、既存<xref:System.Windows.Controls.Control.Background%2A>プロパティ マッピングします。  
+  
+     `OnBackgroundChange`メソッドは、ホストされるコントロールの特定のイメージを割り当てます<xref:System.Windows.Forms.Control.BackgroundImage%2A>プロパティです。 `OnBackgroundChange`既定のプロパティ マッピングが適用された後にメソッドが呼び出されます。  
+  
+## <a name="initializing-your-property-mappings"></a>プロパティ マッピングの初期化  
+ プロパティ マッピングで既に説明したメソッドを呼び出して設定、 <xref:System.Windows.FrameworkElement.Loaded>イベント ハンドラーです。  
+  
+#### <a name="to-initialize-your-property-mappings"></a>プロパティ マッピングを初期化するには  
+  
+1.  定義に次のコードをコピー、`Window1`クラスです。  
+  
+     [!code-csharp[PropertyMappingWithWfhSample#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PropertyMappingWithWfhSample/CSharp/PropertyMappingWithWfh/Window1.xaml.cs#11)]
+     [!code-vb[PropertyMappingWithWfhSample#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PropertyMappingWithWfhSample/VisualBasic/PropertyMappingWithWfh/Window1.xaml.vb#11)]  
+  
+     `WindowLoaded`メソッド ハンドル、 <xref:System.Windows.FrameworkElement.Loaded>イベントし、次の初期化を実行します。  
+  
+    -   作成、 [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] <xref:System.Windows.Forms.CheckBox>コントロールです。  
+  
+    -   プロパティのマッピングを設定するチュートリアルの前半で定義されているメソッドを呼び出します。  
+  
+    -   初期の割り当て済みのプロパティに値を割り当てます。  
+  
+2.  F5 キーを押してアプリケーションをビルドし、実行します。 効果を確認するチェック ボックスをクリックして、 <xref:System.Windows.FrameworkElement.FlowDirection%2A>マッピングします。 チェック ボックスをクリックすると、レイアウトは左から右方向を反転します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A?displayProperty=fullName>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)   
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [チュートリアル: WPF での Windows フォーム コントロールをホストしています。](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/weak-event-patterns.md b/docs/framework/wpf/advanced/weak-event-patterns.md
new file mode 100644
index 00000000000..9e193ebca02
--- /dev/null
+++ b/docs/framework/wpf/advanced/weak-event-patterns.md
@@ -0,0 +1,144 @@
+---
+title: "弱いイベント パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ハンドラー, 弱いイベント パターン"
+  - "IWeakEventListener インターフェイス"
+  - "弱いイベント パターンの実装"
+  - "WeakEventManager クラス"
+ms.assetid: e7c62920-4812-4811-94d8-050a65c856f6
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 弱いイベント パターン
+アプリケーションでは、イベント ソースにアタッチされているハンドラーが、このハンドラーをソースにアタッチしたリスナー オブジェクトとの関連によって、破棄されないことがあります。  このような状況は、メモリ リークにつながる可能性があります。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、デザイン パターンが導入されており、このデザイン パターンを使用して、特定のイベントの専用マネージャー クラスを提供し、そのイベントのリスナーにインターフェイスを実装することによって、この問題に対処できます。  このデザイン パターンは、弱いイベント パターンと呼ばれます。  
+  
+## 弱いイベント パターンを実装する理由  
+ イベントのリッスンによって、メモリ リークが発生する可能性があります。  イベントをリッスンする場合の一般的な手法は、言語固有の構文を使用して、ソース上でイベントにハンドラーをアタッチすることです。  たとえば、[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] では、その構文は `source.SomeEvent += new SomeEventHandler(MyEventHandler)` です。  
+  
+ この手法では、イベント ソースからイベント リスナーへの強い参照を作成します。  通常、リスナーのイベント ハンドラーをアタッチすると、リスナーはオブジェクトの有効期間を持ちますが、この有効期間はソースのオブジェクトの有効期間の影響を受けます \(イベント ハンドラーが明示的に削除されない場合\)。  ただし、特定の状況では、リスナーのオブジェクトの有効期間を、ソースの有効期間によってではなく、アプリケーションのビジュアル ツリーに現在属しているかどうかなどの別の要素によって制御したい場合もあります。  ソース オブジェクトの有効期間がリスナーのオブジェクトの有効期間を超える場合、常に通常のイベント パターンによってメモリ リークが発生します。つまり、このリスナーは想定した以上に長く維持されます。  
+  
+ 弱いイベント パターンは、このメモリ リークの問題を解決するように設計されています。  弱いイベント パターンは、リスナーをイベントに登録する必要がある際に、いつ登録を解除するかを明示的には認識できない場合に使用できます。  また、弱いイベント パターンは、ソースのオブジェクトの有効期間がリスナーの有用なオブジェクトの有効期間を超える場合にも使用できます  \(この場合、*"有用な"* ものは自分自身で判断します\)。弱いイベント パターンを使用すると、リスナーのオブジェクトの有効期間の特性にまったく影響を与えることなく、リスナーをイベントに登録し、イベントを受け取ることができます。  実際には、ソースからの暗黙的な参照では、リスナーがガベージ コレクションの対象であるかどうかは判断されません。  この参照は弱い参照であり、このことから弱いイベント パターンおよび関連する [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] の名前が付けられています。  リスナーはガベージ コレクトされ、そうでなければ破棄されて、ソースは存続することができ、破棄されたオブジェクトへの収集不能なハンドラー参照を継続することもありません。  
+  
+## だれが弱いイベント パターンを実装するのか  
+ 弱いイベント パターンの実装は、主にコントロール作成者にとって意味があります。  コントロールの作成者には、作成したコントロールの動作と格納およびそれを組み込むアプリケーションに与える影響に対する主な責任があります。  これには、コントロール オブジェクトの有効期間の動作 \(特に、上に示したメモリ リークの問題への対応\) が含まれます。  
+  
+ 弱いイベント パターンを適用すると本質的に役立つシナリオがいくつかあります。  このようなシナリオの 1 つが、データ バインディングです。  データ バインディングでは、ソース オブジェクトが、バインディングのターゲットであるリスナー オブジェクトにまったく依存しない場合が一般的です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] データ バインディングの多くの側面は、イベントの実装方法に適用される弱いイベント パターンをあらかじめ含んでいます。  
+  
+## 弱いイベント パターンを実装する方法  
+ 弱いイベント パターンを実装する 3 とおりの方法があります。  次の表ではを使用すると3 とおりの方法についてガイダンスを提供します。  
+  
+|方法|実行します。|  
+|--------|------------|  
+|既存の弱いイベント マネージャー クラスを使用します。|サブスクライブするイベントに対応する <xref:System.Windows.WeakEventManager> を使用すると既存の弱いイベント マネージャーがある場合。  WPF に含まれる弱いイベント マネージャーの一覧については<xref:System.Windows.WeakEventManager> のクラスの継承階層 " を参照してください。  WPF に含まれているためは他の方法の 1 つがを選択する必要があります。ただし比較的少数の弱いイベント マネージャーがあることに注意してください。|  
+|一般的に弱いイベント マネージャー クラスを使用します。|既存の <xref:System.Windows.WeakEventManager> が存在しない場合通常 <xref:System.Windows.WeakEventManager%602> を実行する必要があるため簡単にを使用して効率の影響を受けません。  一般的な <xref:System.Windows.WeakEventManager%602> は既存またはカスタムの弱いイベント マネージャーよりも効率的です。  たとえばジェネリック クラスはイベントの名前のイベントを検出するためにリフレクションを実行します。  またジェネリック <xref:System.Windows.WeakEventManager%602> を使用してイベントを登録するコードは既存またはカスタム <xref:System.Windows.WeakEventManager> を使用して冗長です。|  
+|カスタム弱いイベント マネージャー クラスを作成します。|既存の <xref:System.Windows.WeakEventManager> 存在しない最適な効率が必要な場合はカスタム <xref:System.Windows.WeakEventManager> を作成します。  カスタム <xref:System.Windows.WeakEventManager> を使用してイベントをサブスクライブする方が効率的ですが先頭でのコードの記述のコストがかかります。|  
+  
+ 以降のセクションでは弱いイベント パターンを実装する方法について説明します。  ここではサブスクライブするイベントには次の特徴があります。  
+  
+-   イベント名は `SomeEvent` です。  
+  
+-   イベントは `EventSource` のクラスによって発生します。  
+  
+-   イベント ハンドラーは型を含んでいます : `SomeEventEventHandler` \(または\) `EventHandler<SomeEventEventArgs>`。  
+  
+-   イベントがイベント ハンドラーに `SomeEventEventArgs` 型のパラメーターを渡します。  
+  
+### 既存の弱いイベント マネージャー クラスを使用します。  
+  
+1.  既存の弱いイベント マネージャーを検索します。  
+  
+     WPF に含まれる弱いイベント マネージャーの一覧については<xref:System.Windows.WeakEventManager> のクラスの継承階層 " を参照してください。  
+  
+2.  通常のイベントの接続ではなく弱いイベント マネージャーを使用します。  
+  
+     たとえばコードがイベントをサブスクライブするには次のパターンを使用する場合 :  
+  
+    ```  
+    source.SomeEvent += new SomeEventEventHandler(OnSomeEvent);  
+    ```  
+  
+     次のパターンに変更します :  
+  
+    ```  
+    SomeEventWeakEventManager.AddHandler(source, OnSomeEvent);  
+    ```  
+  
+     同様にコードがイベントをサブスクライブを解除するには次のパターンを使用する場合 :  
+  
+    ```  
+    source.SomeEvent -= new SomeEventEventHandler(OnSome);  
+    ```  
+  
+     次のパターンに変更します :  
+  
+    ```  
+    SomeEventWeakEventManager.RemoveHandler(source, OnSomeEvent);  
+    ```  
+  
+### 一般的に弱いイベント マネージャー クラスを使用します。  
+  
+1.  通常のイベントの接続ではなく <xref:System.Windows.WeakEventManager%602> の一般的なクラスを使用します。  
+  
+     イベント リスナーの登録に <xref:System.Windows.WeakEventManager%602> を使用するとクラスに型パラメーターとして <xref:System.EventArgs> のイベント ソースを指定し次のコードに示すように <xref:System.Windows.WeakEventManager%602.AddHandler%2A> を呼び出します :  
+  
+    ```  
+    WeakEventManager<EventSource, SomeEventEventArgs>.AddHandler(source, "SomeEvent", source_SomeEvent);  
+    ```  
+  
+### カスタム弱いイベント マネージャー クラスの作成  
+  
+1.  プロジェクトに次のクラス テンプレートをコピーします。  
+  
+     このクラスは <xref:System.Windows.WeakEventManager> クラスから継承します。  
+  
+     [!code-csharp[WeakEvents#WeakEventManagerTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WeakEvents/CSharp/WeakEventManagerTemplate.cs#weakeventmanagertemplate)]  
+  
+2.  独自の名前と `SomeEventWeakEventManager` の名前に置き換えます。  
+  
+3.  前に説明したイベントに対応する名前を持つ 3 個の名前に置き換えます。  \(`SomeEvent``EventSource` と `SomeEventEventArgs`\)  
+  
+4.  イベントは管理するのと同じ表示に弱いイベント マネージャー クラスの表示 \(public または internal キーと秘密キーのペア\) に設定します。  
+  
+5.  通常のイベントの接続ではなく弱いイベント マネージャーを使用します。  
+  
+     たとえばコードがイベントをサブスクライブするには次のパターンを使用する場合 :  
+  
+    ```  
+    source.SomeEvent += new SomeEventEventHandler(OnSomeEvent);  
+    ```  
+  
+     次のパターンに変更します :  
+  
+    ```  
+    SomeEventWeakEventManager.AddHandler(source, OnSomeEvent);  
+    ```  
+  
+     同様にコードがイベントをサブスクライブを解除するには次のパターンを使用する場合 :  
+  
+    ```  
+    source.SomeEvent -= new SomeEventEventHandler(OnSome);  
+    ```  
+  
+     次のパターンに変更します :  
+  
+    ```  
+    SomeEventWeakEventManager.RemoveHandler(source, OnSomeEvent);  
+    ```  
+  
+## 参照  
+ <xref:System.Windows.WeakEventManager>   
+ <xref:System.Windows.IWeakEventListener>   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/windows-forms-and-wpf-interoperability-input-architecture.md b/docs/framework/wpf/advanced/windows-forms-and-wpf-interoperability-input-architecture.md
new file mode 100644
index 00000000000..eaf50f246e1
--- /dev/null
+++ b/docs/framework/wpf/advanced/windows-forms-and-wpf-interoperability-input-architecture.md
@@ -0,0 +1,145 @@
+---
+title: "Windows フォームと WPF の相互運用性入力アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ElementHost のキーボードとメッセージ"
+  - "入力アーキテクチャ [WPF 相互運用性]"
+  - "相互運用性 [WPF], Windows フォーム"
+  - "キーボードの相互運用 [WPF]"
+  - "メッセージ [WPF]"
+  - "モードレス ダイアログ ボックス [WPF]"
+  - "モードレス フォーム"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+  - "WindowsFormsHost のキーボードとメッセージ_"
+ms.assetid: 0eb6f137-f088-4c5e-9e37-f96afd28f235
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Windows フォームと WPF の相互運用性入力アーキテクチャ
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]間の相互運用を実現するには、両方のテクノロジに適切なキーボード入力処理が必要です。  ここでは、これらのテクノロジにキーボードおよびメッセージ処理を実装して、ハイブリッド アプリケーションでの円滑な相互運用を有効にする方法を説明します。  
+  
+ このトピックは、次の内容で構成されています。  
+  
+-   モードレス フォームとダイアログ ボックス  
+  
+-   WindowsFormsHost キーボードとメッセージ処理  
+  
+-   ElementHost のキーボードおよびメッセージ処理  
+  
+## モードレス フォームとダイアログ ボックス  
+ モードレス フォームまたはダイアログ ボックスを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションから開くには、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素で <xref:System.Windows.Forms.Integration.WindowsFormsHost.EnableWindowsFormsInterop%2A> メソッドを呼び出します。  
+  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ベースのアプリケーションでモードレス [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページを開くには、<xref:System.Windows.Forms.Integration.ElementHost> コントロールで <xref:System.Windows.Forms.Integration.ElementHost.EnableModelessKeyboardInterop%2A> メソッドを呼び出します。  
+  
+## WindowsFormsHost キーボードとメッセージ処理  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションでホストされている場合、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のキーボードおよびメッセージ処理は、次の要素から構成されます。  
+  
+-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスは、<xref:System.Windows.Interop.ComponentDispatcher> クラスで実装される [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] メッセージ ループからメッセージを取得します。  
+  
+-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスは、通常の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] キーボード処理が行われるように、サロゲート [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] メッセージ ループを作成します。  
+  
+-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスは、<xref:System.Windows.Interop.IKeyboardInputSink> インターフェイスを実装して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] とフォーカス管理を調整します。  
+  
+-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは自身を登録し、それらのメッセージ ループを開始します。  
+  
+ 以下のセクションでは、これらのプロセスの各部分について詳しく説明します。  
+  
+### WPF メッセージ ループからのメッセージの取得  
+ <xref:System.Windows.Interop.ComponentDispatcher> クラスは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のメッセージ ループ マネージャーを実装します。  <xref:System.Windows.Interop.ComponentDispatcher> クラスはフックを提供して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] がメッセージを処理する前に外部のクライアントによってそれらのメッセージが処理されるようにします。  
+  
+ 相互運用性の実装は <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage?displayProperty=fullName> イベントを処理し、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールよりも前にメッセージを処理できるようにします。  
+  
+### サロゲート Windows フォーム メッセージ ループ  
+ 既定では、<xref:System.Windows.Forms.Application?displayProperty=fullName> クラスに [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーションの主要なメッセージ ループが含まれています。  相互運用中、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] メッセージ ループはメッセージを処理しません。  したがって、このロジックを再現する必要があります。  <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage?displayProperty=fullName> イベントのハンドラーは、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Forms.IMessageFilter> インターフェイスを使用してメッセージをフィルター処理します。  
+  
+2.  <xref:System.Windows.Forms.Control.PreProcessMessage%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+3.  必要な場合は、メッセージを変換してディスパッチします。  
+  
+4.  他のコントロールがメッセージを処理しない場合、ホストしているコントロールにメッセージを渡します。  
+  
+### IKeyboardInputSink の実装  
+ サロゲート メッセージ ループは、キーボード管理を処理します。  したがって、<xref:System.Windows.Interop.IKeyboardInputSink.TabInto%2A?displayProperty=fullName> メソッドは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> クラスで実装を必要とする唯一の <xref:System.Windows.Interop.IKeyboardInputSink> メンバーです。  
+  
+ 既定では、<xref:System.Windows.Interop.HwndHost> クラスは、その <xref:System.Windows.Interop.HwndHost.System%23Windows%23Interop%23IKeyboardInputSink%23TabInto%2A> の実装に対して `false` を返します。  これにより、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールから [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールへの Tab キーによる移動はできなくなります。  
+  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> の <xref:System.Windows.Interop.IKeyboardInputSink.TabInto%2A?displayProperty=fullName> メソッドの  実装は、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールに含まれ、フォーカスを受け取ることができる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の最初または最後のコントロールを見つけます。  コントロールの選択肢は、検査情報によって異なります。  
+  
+2.  コントロールにフォーカスを設定し、`true` を返します。  
+  
+3.  コントロールがフォーカスを受け取ることができない場合は、`false` を返します。  
+  
+### WindowsFormsHost の登録  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールへのウィンドウ ハンドルが作成されると、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは、メッセージ ループに対してその存在を登録する内部の静的メソッドを呼び出します。  
+  
+ 登録中、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールはメッセージ ループを調べます。  メッセージ ループが開始されていない場合、<xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage?displayProperty=fullName> イベント ハンドラーが作成されます。  <xref:System.Windows.Interop.ComponentDispatcher.ThreadFilterMessage?displayProperty=fullName> イベント ハンドラーがアタッチされている場合、メッセージ ループは実行中と見なされます。  
+  
+ ウィンドウ ハンドルが破棄されると、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは自身の登録を解除します。  
+  
+## ElementHost のキーボードおよびメッセージ処理  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アプリケーションでホストされている場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のキーボードおよびメッセージ処理は、次の要素から構成されます。  
+  
+-   <xref:System.Windows.Interop.HwndSource>、<xref:System.Windows.Interop.IKeyboardInputSink> インターフェイス実装、および <xref:System.Windows.Interop.IKeyboardInputSite> インターフェイス実装。  
+  
+-   Tab キーと方向キー。  
+  
+-   コマンド キーとダイアログ ボックス キー。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アクセラレータ処理。  
+  
+ 以下のセクションでは、これらの各部分について詳しく説明します。  
+  
+### インターフェイスの実装  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]では、キーボード メッセージが、フォーカスを持つコントロールのウィンドウ ハンドルにルーティングされます。  <xref:System.Windows.Forms.Integration.ElementHost> コントロールでは、これらのメッセージはホストされている要素にルーティングされます。  これを実現するために、<xref:System.Windows.Forms.Integration.ElementHost> コントロールは、<xref:System.Windows.Interop.HwndSource> インスタンスを提供します。  <xref:System.Windows.Forms.Integration.ElementHost> コントロールにフォーカスが設定されている場合、<xref:System.Windows.Interop.HwndSource> インスタンスはほとんどのキーボード入力をルーティングして、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Input.InputManager> クラスで処理できるようにします。  
+  
+ <xref:System.Windows.Interop.HwndSource> クラスは、<xref:System.Windows.Interop.IKeyboardInputSink> インターフェイスと <xref:System.Windows.Interop.IKeyboardInputSite> インターフェイスを実装します。  
+  
+ キーボードの相互運用では、<xref:System.Windows.Interop.IKeyboardInputSite.OnNoMoreTabStops%2A> メソッドの実装に依存して、ホストされている要素からフォーカスを移動する Tab キーおよび方向キーの入力を処理します。  
+  
+### Tab キーと方向キー  
+ Tab キーおよび方向キーによる移動を実装するために、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の選択ロジックは <xref:System.Windows.Interop.HwndSource.System%23Windows%23Interop%23IKeyboardInputSink%23TabInto%2A> メソッドと <xref:System.Windows.Interop.IKeyboardInputSite.OnNoMoreTabStops%2A> メソッドにマッピングされます。  <xref:System.Windows.Forms.Integration.ElementHost.Select%2A> メソッドをオーバーライドして、このマッピングを実現します。  
+  
+### コマンド キーとダイアログ ボックス キー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に対して、コマンド キーとダイアログ キーを処理する最初の機会を提供するために、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コマンドの事前処理が <xref:System.Windows.Interop.IKeyboardInputSink.TranslateAccelerator%2A> メソッドに関連付けられます。  <xref:System.Windows.Forms.Control.ProcessCmdKey%2A?displayProperty=fullName> メソッドをオーバーライドすると、2 つのテクノロジが関連付けられます。  
+  
+ <xref:System.Windows.Interop.IKeyboardInputSink.TranslateAccelerator%2A> メソッドを使用すると、ホストされた要素は、Tab キー、Enter キー、Esc キー、方向キーなどのコマンド キーを含む、WM\_KEYDOWN、WM\_KEYUP、WM\_SYSKEYDOWN、WM\_SYSKEYUP などのキー メッセージを処理できます。  キー メッセージが処理されない場合、そのキー メッセージは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の先祖の階層に送られ、処理されます。  
+  
+### アクセラレータ処理  
+ アクセラレータを正しく処理するには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アクセラレータ処理を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Input.AccessKeyManager> クラスに関連付ける必要があります。  また、すべての WM\_CHAR メッセージは、ホストされている要素に正しくルーティングされる必要があります。  
+  
+ <xref:System.Windows.Interop.HwndSource> の <xref:System.Windows.Interop.IKeyboardInputSink.TranslateChar%2A> メソッドの既定の実装は `false` を返すため、WM\_CHAR メッセージは次のロジックを使用して処理されます。  
+  
+-   <xref:System.Windows.Forms.Control.IsInputChar%2A?displayProperty=fullName> メソッドは、すべての WM\_CHAR メッセージがホストされている要素に転送されるようにオーバーライドされます。  
+  
+-   Alt キーが押された場合、メッセージは WM\_SYSCHAR になります。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]は、このメッセージを <xref:System.Windows.Forms.Control.IsInputChar%2A> メソッドを通して事前に処理しません。  したがって、<xref:System.Windows.Forms.Control.ProcessMnemonic%2A> メソッドは、登録済みのアクセラレータを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Input.AccessKeyManager> に照会するためにオーバーライドされます。  登録済みのアクセラレータが見つかった場合、<xref:System.Windows.Input.AccessKeyManager> はそのアクセラレータを処理します。  
+  
+-   Alt キーが押されない場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Input.InputManager> クラスは未処理の入力を処理します。  入力がアクセラレータである場合、<xref:System.Windows.Input.AccessKeyManager> がそのアクセラレータを処理します。  処理されていない WM\_CHAR メッセージに対して <xref:System.Windows.Input.InputManager.PostProcessInput> イベントが処理されます。  
+  
+ ユーザーが Alt キーを押すと、アクセラレータのビジュアル キューがフォーム全体に示されます。  この動作をサポートするために、アクティブ フォーム上のすべての <xref:System.Windows.Forms.Integration.ElementHost> コントロールは、フォーカスがどのコントロールに設定されているかに関係なく、WM\_SYSKEYDOWN メッセージを受け取ります。  
+  
+ メッセージは、アクティブ フォーム内の <xref:System.Windows.Forms.Integration.ElementHost> コントロールにだけ送信されます。  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost.EnableWindowsFormsInterop%2A>   
+ <xref:System.Windows.Forms.Integration.ElementHost.EnableModelessKeyboardInterop%2A>   
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md b/docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md
new file mode 100644
index 00000000000..2fa5d06b007
--- /dev/null
+++ b/docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md
@@ -0,0 +1,150 @@
+---
+title: "Windows フォームと WPF プロパティの割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "相互運用性 [WPF], Windows フォーム"
+  - "プロパティの割り当て [WPF 相互運用性]"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+  - "WindowsFormsHost 要素のプロパティの割り当て"
+ms.assetid: 999d8298-9c04-467d-a453-86e41002057d
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Windows フォームと WPF プロパティの割り当て
+[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] テクノロジと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] テクノロジは、類似する 2 つのプロパティ モデルを使用しますが、まったく同じというわけではありません。  *プロパティの割り当て*は、2 つのアーキテクチャ間の相互運用をサポートし、次の機能を提供します。  
+  
+-   ホスト環境での関連するプロパティの変更を、ホストされるコントロールまたは要素に簡単に割り当てられるようにします。  
+  
+-   最もよく使用されるプロパティの割り当てに対する既定の処理を提供します。  
+  
+-   既定のプロパティを簡単に削除、オーバーライド、または拡張できるようにします。  
+  
+-   ホストでのプロパティ値の変更が自動的に検出され、ホストされるコントロールまたは要素に変換されるようにします。  
+  
+> [!NOTE]
+>  プロパティ変更イベントは、コントロールまたは要素のホスト階層を上方には伝達されません。  プロパティの値を変更する直接設定、スタイル、継承、データ バインディング、またはその他の機構のため、プロパティのローカル値が変更されない場合は、プロパティの変換は行われません。  
+  
+ プロパティの割り当てにアクセスするには、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の <xref:System.Windows.Forms.Integration.WindowsFormsHost.PropertyMap%2A> プロパティおよび <xref:System.Windows.Forms.Integration.ElementHost> コントロールの <xref:System.Windows.Forms.Integration.ElementHost.PropertyMap%2A> プロパティを使用します。  
+  
+## WindowsFormsHost 要素を使用したプロパティの割り当て  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、次の変換テーブルを使用して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既定のプロパティを [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]でそれに相当するものに変換します。  
+  
+|Windows Presentation Foundation ホスト|Windows フォーム|相互運用動作|  
+|-----------------------------------------|------------------|------------|  
+|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> \(<xref:System.Windows.Media.Brush?displayProperty=fullName>\)|<xref:System.Windows.Forms.Control.BackColor%2A><br /><br /> \(<xref:System.Drawing.Color?displayProperty=fullName>\)|<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素は、ホストされるコントロールの <xref:System.Windows.Forms.Control.BackColor%2A> プロパティおよび <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティを設定します。  割り当ては、次のルールを使用して行われます。<br /><br /> -   <xref:System.Windows.Controls.Control.Background%2A> が純色の場合は、変換されて、ホストされるコントロールの <xref:System.Windows.Forms.Control.BackColor%2A> プロパティを設定するために使用されます。  ホストされるコントロールは <xref:System.Windows.Forms.Control.BackColor%2A> プロパティの値を継承できるため、ホストされるコントロールでは <xref:System.Windows.Forms.Control.BackColor%2A> プロパティは設定されません。 **Note:**  ホストされるコントロールは透過性をサポートしません。  <xref:System.Windows.Forms.Control.BackColor%2A> に割り当てられる色は、アルファ値が 0xFF で、完全に不透明でなければなりません。 <br /><br /> -   <xref:System.Windows.Controls.Control.Background%2A> が純色でない場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは <xref:System.Windows.Controls.Control.Background%2A> プロパティからビットマップを作成します。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは、このビットマップをホストされるコントロールの <xref:System.Windows.Forms.Control.BackgroundImage%2A> プロパティに割り当てます。  これにより、透過性に似た効果が実現します。 **Note:**  この動作をオーバーライドしたり、<xref:System.Windows.Controls.Control.Background%2A> プロパティの割り当てを削除することができます。|  
+|<xref:System.Windows.FrameworkElement.Cursor%2A>|<xref:System.Windows.Forms.Control.Cursor%2A>|既定の割り当てが再割り当てされていない場合、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは、<xref:System.Windows.FrameworkElement.Cursor%2A> プロパティが設定されている先祖が見つかるまで、先祖の階層を処理します。  この値は、対応する最も近い [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] カーソルに変換されます。<br /><br /> <xref:System.Windows.FrameworkElement.ForceCursor%2A> プロパティの既定の割り当てが再割り当てされていない場合、処理は、<xref:System.Windows.FrameworkElement.ForceCursor%2A> が `true` に設定されている最初の先祖で停止します。|  
+|<xref:System.Windows.FrameworkElement.FlowDirection%2A><br /><br /> \(<xref:System.Windows.FlowDirection?displayProperty=fullName>\)|<xref:System.Windows.Forms.Control.RightToLeft%2A><br /><br /> \(<xref:System.Windows.Forms.RightToLeft?displayProperty=fullName>\)|<xref:System.Windows.FlowDirection> は <xref:System.Windows.Forms.RightToLeft> にマップされます。<br /><br /> <xref:System.Windows.FlowDirection> は <xref:System.Windows.Forms.RightToLeft> にマップされます。<br /><br /> <xref:System.Windows.Forms.RightToLeft> は割り当てられません。<br /><br /> <xref:System.Windows.FlowDirection?displayProperty=fullName> は <xref:System.Windows.Forms.RightToLeft?displayProperty=fullName> にマップされます。|  
+|<xref:System.Windows.Controls.Control.FontStyle%2A>|ホストされているコントロールの <xref:System.Drawing.Font.Style%2A> の <xref:System.Drawing.Font?displayProperty=fullName>|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプロパティ セットは、対応する <xref:System.Drawing.Font> に変換されます。  これらのプロパティのいずれかが変更された場合は、新しい <xref:System.Drawing.Font> が作成されます。  <xref:System.Windows.FontStyles.Normal%2A> の場合、<xref:System.Drawing.FontStyle> は無効です。  <xref:System.Windows.FontStyles.Italic%2A> または <xref:System.Windows.FontStyles.Oblique%2A> の場合、<xref:System.Drawing.FontStyle> は有効です。|  
+|<xref:System.Windows.Controls.Control.FontWeight%2A>|ホストされているコントロールの <xref:System.Drawing.Font.Style%2A> の <xref:System.Drawing.Font?displayProperty=fullName>|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプロパティ セットは、対応する <xref:System.Drawing.Font> に変換されます。  これらのプロパティのいずれかが変更された場合は、新しい <xref:System.Drawing.Font> が作成されます。  <xref:System.Windows.FontWeights.Black%2A>、<xref:System.Windows.FontWeights.Bold%2A>、<xref:System.Windows.FontWeights.DemiBold%2A>、<xref:System.Windows.FontWeights.ExtraBold%2A>、<xref:System.Windows.FontWeights.Heavy%2A>、<xref:System.Windows.FontWeights.Medium%2A>、<xref:System.Windows.FontWeights.SemiBold%2A>、または <xref:System.Windows.FontWeights.UltraBold%2A> の場合、<xref:System.Drawing.FontStyle> は有効です。  <xref:System.Windows.FontWeights.ExtraLight%2A>、<xref:System.Windows.FontWeights.Light%2A>、<xref:System.Windows.FontWeights.Normal%2A>、<xref:System.Windows.FontWeights.Regular%2A>、<xref:System.Windows.FontWeights.Thin%2A>、または <xref:System.Windows.FontWeights.UltraLight%2A> の場合、<xref:System.Drawing.FontStyle> は無効です。|  
+|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> \(<xref:System.Drawing.Font?displayProperty=fullName>\)|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプロパティ セットは、対応する <xref:System.Drawing.Font> に変換されます。  これらのプロパティのいずれかが変更された場合は、新しい <xref:System.Drawing.Font> が作成されます。  ホストされる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、フォント サイズに基づいてサイズを変更します。<br /><br /> フォント サイズは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では 1\/96 インチで表され、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]では 1\/72 インチで表されます。  対応する変換は次のとおりです。<br /><br /> [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]のフォント サイズ \= [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のフォント サイズ \* 72.0 \/ 96.0|  
+|<xref:System.Windows.Controls.Control.Foreground%2A><br /><br /> \(<xref:System.Windows.Media.Brush?displayProperty=fullName>\)|<xref:System.Windows.Forms.Control.ForeColor%2A><br /><br /> \(<xref:System.Drawing.Color?displayProperty=fullName>\)|<xref:System.Windows.Controls.Control.Foreground%2A> プロパティの割り当ては、次のルールを使用して行われます。<br /><br /> -   <xref:System.Windows.Controls.Control.Foreground%2A> が <xref:System.Windows.Media.SolidColorBrush> の場合、<xref:System.Windows.Forms.Control.ForeColor%2A> には <xref:System.Windows.Media.SolidColorBrush.Color%2A> を使用します。<br />-   <xref:System.Windows.Controls.Control.Foreground%2A> が <xref:System.Windows.Media.GradientBrush> の場合、<xref:System.Windows.Forms.Control.ForeColor%2A> には <xref:System.Windows.Media.GradientStop> の色と最低のオフセット値を使用します。<br />-   他の <xref:System.Windows.Media.Brush> 型の場合は、<xref:System.Windows.Forms.Control.ForeColor%2A> は変更されません。  これは、既定値が使用されることを意味します。|  
+|<xref:System.Windows.UIElement.IsEnabled%2A>|<xref:System.Windows.Forms.Control.Enabled%2A>|<xref:System.Windows.UIElement.IsEnabled%2A> が設定されていると、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素はホストされるコントロールの <xref:System.Windows.Forms.Control.Enabled%2A> プロパティを設定します。|  
+|<xref:System.Windows.Controls.Control.Padding%2A>|<xref:System.Windows.Forms.Control.Padding%2A>|ホストされる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの <xref:System.Windows.Forms.Control.Padding%2A> プロパティの 4 つの値はすべて、同じ <xref:System.Windows.Thickness> 値に設定されます。<br /><br /> -   <xref:System.Int32.MaxValue> より大きい値は、<xref:System.Int32.MaxValue> に設定されます。<br />-   <xref:System.Int32.MinValue> より小さい値は、<xref:System.Int32.MinValue> に設定されます。|  
+|<xref:System.Windows.UIElement.Visibility%2A>|<xref:System.Windows.Forms.Control.Visible%2A>|-   <xref:System.Windows.Visibility> は、<xref:System.Windows.Forms.Control.Visible%2A> \= `true` に割り当てられます。  ホストされる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは表示されます。  ホストされているコントロールに対して <xref:System.Windows.Forms.Control.Visible%2A> プロパティを明示的に `false` に設定することはお勧めしません。<br />-   <xref:System.Windows.Visibility> は、<xref:System.Windows.Forms.Control.Visible%2A> \= `true` または `false` に割り当てられます。  ホストされる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは描画されず、領域は折りたたまれます。<br />-   <xref:System.Windows.Visibility> : ホストされる [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールはレイアウトのスペースを使用しますが、表示はされません。  この場合、<xref:System.Windows.Forms.Control.Visible%2A> プロパティは `true` に設定されます。  ホストされているコントロールに対して <xref:System.Windows.Forms.Control.Visible%2A> プロパティを明示的に `false` に設定することはお勧めしません。|  
+  
+ コンテナー要素の添付プロパティは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素によって完全にサポートされます。  
+  
+ 詳細については、「[チュートリアル : WindowsFormsHost 要素を使用したプロパティの割り当て](../../../../docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-windowsformshost-element.md)」を参照してください。  
+  
+## 親プロパティの更新  
+ ほとんどの親プロパティに対する変更は、ホストされる子コントロールに通知されます。  値が変更されても通知が行われないプロパティを次に示します。  
+  
+-   <xref:System.Windows.Controls.Control.Background%2A>  
+  
+-   <xref:System.Windows.FrameworkElement.Cursor%2A>  
+  
+-   <xref:System.Windows.FrameworkElement.ForceCursor%2A>  
+  
+-   <xref:System.Windows.UIElement.Visibility%2A>  
+  
+ たとえば、<xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素の <xref:System.Windows.Controls.Control.Background%2A> プロパティの値を変更しても、ホストされるコントロールの <xref:System.Windows.Forms.Control.BackColor%2A> プロパティは変更されません。  
+  
+## ElementHost コントロールを使用したプロパティの割り当て  
+ 次のプロパティは、組み込みの変更通知を提供します。  これらのプロパティを割り当てるときは、<xref:System.Windows.FrameworkElement.OnPropertyChanged%2A> メソッドを呼び出さないでください。  
+  
+-   AutoSize  
+  
+-   BackColor  
+  
+-   BackgroundImage  
+  
+-   BackgroundImageLayout  
+  
+-   BindingContext  
+  
+-   CausesValidation  
+  
+-   ContextMenu  
+  
+-   ContextMenuStrip  
+  
+-   Cursor  
+  
+-   Dock  
+  
+-   Enabled  
+  
+-   フォント  
+  
+-   ForeColor  
+  
+-   場所  
+  
+-   Margin  
+  
+-   Padding  
+  
+-   Parent  
+  
+-   Region  
+  
+-   RightToLeft  
+  
+-   サイズ  
+  
+-   TabIndex  
+  
+-   TabStop  
+  
+-   テキスト  
+  
+-   Visible  
+  
+ <xref:System.Windows.Forms.Integration.ElementHost> コントロールは、次の変換テーブルを使用して、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の既定のプロパティを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でそれに相当するものに変換します。  
+  
+ 詳細については、「[チュートリアル : ElementHost コントロールを使用したプロパティの割り当て](../../../../docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-elementhost-control.md)」を参照してください。  
+  
+|Windows フォーム ホスト|Windows Presentation Foundation|相互運用動作|  
+|----------------------|-------------------------------------|------------|  
+|<xref:System.Windows.Forms.Control.BackColor%2A><br /><br /> \(<xref:System.Drawing.Color?displayProperty=fullName>\)|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> \(ホストされている要素の <xref:System.Windows.Media.Brush?displayProperty=fullName>\)|このプロパティを設定すると、<xref:System.Windows.Media.ImageBrush> での再描画が強制されます。  <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> プロパティが `false` \(既定値\) に設定されている場合、この <xref:System.Windows.Media.ImageBrush> は、<xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.BackgroundImage%2A>、<xref:System.Windows.Forms.Control.BackgroundImageLayout%2A> プロパティやアタッチされている描画ハンドラーなど、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの外観に基づいています。<br /><br /> <xref:System.Windows.Forms.Integration.ElementHost.BackColorTransparent%2A> が `true` に設定されている場合、<xref:System.Windows.Media.ImageBrush> は、親の <xref:System.Windows.Forms.Control.BackColor%2A>、<xref:System.Windows.Forms.Control.BackgroundImage%2A>、<xref:System.Windows.Forms.Control.BackgroundImageLayout%2A> プロパティやアタッチされている描画ハンドラーなど、<xref:System.Windows.Forms.Integration.ElementHost> コントロールの親の外観に基づいています。|  
+|<xref:System.Windows.Forms.Control.BackgroundImage%2A><br /><br /> \(<xref:System.Drawing.Image?displayProperty=fullName>\)|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> \(ホストされている要素の <xref:System.Windows.Media.Brush?displayProperty=fullName>\)|このプロパティを設定すると、<xref:System.Windows.Forms.Control.BackColor%2A> のマッピングに関する記述と同じ動作が発生します。|  
+|<xref:System.Windows.Forms.Control.BackgroundImageLayout%2A>|<xref:System.Windows.Controls.Control.Background%2A><br /><br /> \(ホストされている要素の <xref:System.Windows.Media.Brush?displayProperty=fullName>\)|このプロパティを設定すると、<xref:System.Windows.Forms.Control.BackColor%2A> のマッピングに関する記述と同じ動作が発生します。|  
+|<xref:System.Windows.Forms.Control.Cursor%2A><br /><br /> \(<xref:System.Windows.Forms.Cursor?displayProperty=fullName>\)|<xref:System.Windows.FrameworkElement.Cursor%2A><br /><br /> \(<xref:System.Windows.Input.Cursor?displayProperty=fullName>\)|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の標準カーソルは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の対応する標準カーソルに変換されます。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]が標準カーソルでない場合は、既定値が割り当てられます。|  
+|<xref:System.Windows.Forms.Control.Enabled%2A>|<xref:System.Windows.UIElement.IsEnabled%2A>|<xref:System.Windows.Forms.Control.Enabled%2A> が設定されていると、<xref:System.Windows.Forms.Integration.ElementHost> コントロールはホストされる要素の <xref:System.Windows.UIElement.IsEnabled%2A> プロパティを設定します。|  
+|<xref:System.Windows.Forms.Control.Font%2A><br /><br /> \(<xref:System.Drawing.Font?displayProperty=fullName>\)|<xref:System.Windows.Controls.Control.FontFamily%2A><br /><br /> <xref:System.Windows.Controls.Control.FontSize%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStretch%2A><br /><br /> <xref:System.Windows.Controls.Control.FontStyle%2A><br /><br /> <xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Windows.Forms.Control.Font%2A> の値は、対応する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] フォント プロパティのセットに変換されます。|  
+|<xref:System.Drawing.Font.Bold%2A>|ホストされている要素の <xref:System.Windows.Controls.Control.FontWeight%2A>|<xref:System.Drawing.Font.Bold%2A> が `true` の場合は、<xref:System.Windows.Controls.Control.FontWeight%2A> が <xref:System.Windows.FontWeights.Bold%2A> に設定されます。<br /><br /> <xref:System.Drawing.Font.Bold%2A> が `false` の場合は、<xref:System.Windows.Controls.Control.FontWeight%2A> が <xref:System.Windows.FontWeights.Normal%2A> に設定されます。|  
+|<xref:System.Drawing.Font.Italic%2A>|ホストされている要素の <xref:System.Windows.Controls.Control.FontStyle%2A>|<xref:System.Drawing.Font.Italic%2A> が `true` の場合は、<xref:System.Windows.Controls.Control.FontStyle%2A> が <xref:System.Windows.FontStyles.Italic%2A> に設定されます。<br /><br /> <xref:System.Drawing.Font.Italic%2A> が `false` の場合は、<xref:System.Windows.Controls.Control.FontStyle%2A> が <xref:System.Windows.FontStyles.Normal%2A> に設定されます。|  
+|<xref:System.Drawing.Font.Strikeout%2A>|ホストされている要素の <xref:System.Windows.TextDecorations>|<xref:System.Windows.Controls.TextBlock> コントロールをホストしている場合のみ適用されます。|  
+|<xref:System.Drawing.Font.Underline%2A>|ホストされている要素の <xref:System.Windows.TextDecorations>|<xref:System.Windows.Controls.TextBlock> コントロールをホストしている場合のみ適用されます。|  
+|<xref:System.Windows.Forms.Control.RightToLeft%2A><br /><br /> \(<xref:System.Windows.Forms.RightToLeft?displayProperty=fullName>\)|<xref:System.Windows.FrameworkElement.FlowDirection%2A><br /><br /> \(<xref:System.Windows.FlowDirection>\)|<xref:System.Windows.Forms.RightToLeft> は <xref:System.Windows.FlowDirection> にマップされます。<br /><br /> <xref:System.Windows.Forms.RightToLeft> は <xref:System.Windows.FlowDirection> にマップされます。|  
+|<xref:System.Windows.Forms.Control.Visible%2A>|<xref:System.Windows.UIElement.Visibility%2A>|<xref:System.Windows.Forms.Integration.ElementHost> コントロールは、次のルールを使用して、ホストされる要素の <xref:System.Windows.UIElement.Visibility%2A> プロパティを設定します。<br /><br /> -   <xref:System.Windows.Forms.Control.Visible%2A> \= `true` は <xref:System.Windows.Visibility> にマップされます。<br />-   <xref:System.Windows.Forms.Control.Visible%2A> \= `false` は <xref:System.Windows.Visibility> にマップされます。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)   
+ [WPF と Windows フォームの相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md)   
+ [チュートリアル : WindowsFormsHost 要素を使用したプロパティの割り当て](../../../../docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-windowsformshost-element.md)   
+ [チュートリアル : ElementHost コントロールを使用したプロパティの割り当て](../../../../docs/framework/wpf/advanced/walkthrough-mapping-properties-using-the-elementhost-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md b/docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md
new file mode 100644
index 00000000000..56ee8d5cbcc
--- /dev/null
+++ b/docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md
@@ -0,0 +1,100 @@
+---
+title: "Windows フォーム コントロールおよび同等の WPF コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "相互運用性 [WPF], Windows フォーム"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+ms.assetid: 8a157e6b-8054-46db-a5cf-a78966acc7a1
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# Windows フォーム コントロールおよび同等の WPF コントロール
+多くの場合、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールには同等の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールがありますが、中には [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと同等のコントロールが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] にない場合もあります。  ここでは、2 つのテクノロジによって提供されるコントロール型を比較します。  
+  
+ 相互運用を利用すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションに同等のコントロールがない [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを常にホストできます。  
+  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールおよびコンポーネントと同等の機能を持つ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールを次の表に示します。  
+  
+|Windows フォーム コントロール|WPF の同等コントロール|解説|  
+|-------------------------|-------------------|--------|  
+|<xref:System.Windows.Forms.BindingNavigator>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.BindingSource>|<xref:System.Windows.Data.CollectionViewSource>||  
+|<xref:System.Windows.Forms.Button>|<xref:System.Windows.Controls.Button>||  
+|<xref:System.Windows.Forms.CheckBox>|<xref:System.Windows.Controls.CheckBox>||  
+|<xref:System.Windows.Forms.CheckedListBox>|コンポジションを使用した <xref:System.Windows.Controls.ListBox>。||  
+|<xref:System.Windows.Forms.ColorDialog>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.ComboBox>|<xref:System.Windows.Controls.ComboBox>|<xref:System.Windows.Controls.ComboBox> は、オート コンプリートをサポートしていません。|  
+|<xref:System.Windows.Forms.ContextMenuStrip>|<xref:System.Windows.Controls.ContextMenu>||  
+|<xref:System.Windows.Forms.DataGridView>|<xref:System.Windows.Controls.DataGrid>||  
+|<xref:System.Windows.Forms.DateTimePicker>|<xref:System.Windows.Controls.DatePicker>||  
+|<xref:System.Windows.Forms.DomainUpDown>|<xref:System.Windows.Controls.TextBox> と 2 つの <xref:System.Windows.Controls.Primitives.RepeatButton> コントロール。||  
+|<xref:System.Windows.Forms.ErrorProvider>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.FlowLayoutPanel>|<xref:System.Windows.Controls.WrapPanel> または <xref:System.Windows.Controls.StackPanel>||  
+|<xref:System.Windows.Forms.FolderBrowserDialog>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.FontDialog>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.Form>|<xref:System.Windows.Window>|<xref:System.Windows.Window> は子ウィンドウをサポートしていません。|  
+|<xref:System.Windows.Forms.GroupBox>|<xref:System.Windows.Controls.GroupBox>||  
+|<xref:System.Windows.Forms.HelpProvider>|同等のコントロールはありません。|F1 ヘルプはありません。  "ポップ ヒント" ヘルプはツールヒントに置き換えられます。|  
+|<xref:System.Windows.Forms.HScrollBar>|<xref:System.Windows.Controls.Primitives.ScrollBar>|スクロールは、コンテナー コントロールに組み込まれます。|  
+|<xref:System.Windows.Forms.ImageList>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.Label>|<xref:System.Windows.Controls.Label>||  
+|<xref:System.Windows.Forms.LinkLabel>|同等のコントロールはありません。|<xref:System.Windows.Documents.Hyperlink> クラスを使用すると、フロー コンテンツ内でハイパーリンクをホストできます。|  
+|<xref:System.Windows.Forms.ListBox>|<xref:System.Windows.Controls.ListBox>||  
+|<xref:System.Windows.Forms.ListView>|<xref:System.Windows.Controls.ListView>|<xref:System.Windows.Controls.ListView> コントロールは、読み取り専用の詳細表示を提供します。|  
+|<xref:System.Windows.Forms.MaskedTextBox>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.MenuStrip>|<xref:System.Windows.Controls.Menu>|<xref:System.Windows.Controls.Menu> コントロールのスタイル設定は、<xref:System.Windows.Forms.ToolStripProfessionalRenderer?displayProperty=fullName> クラスとほぼ同様の動作および外観を提供できます。|  
+|<xref:System.Windows.Forms.MonthCalendar>|<xref:System.Windows.Controls.Calendar>||  
+|<xref:System.Windows.Forms.NotifyIcon>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.NumericUpDown>|<xref:System.Windows.Controls.TextBox> と 2 つの <xref:System.Windows.Controls.Primitives.RepeatButton> コントロール。||  
+|<xref:System.Windows.Forms.OpenFileDialog>|<xref:Microsoft.Win32.OpenFileDialog>|<xref:Microsoft.Win32.OpenFileDialog> クラスは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ラッパー クラスです。|  
+|<xref:System.Windows.Forms.PageSetupDialog>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.Panel>|<xref:System.Windows.Controls.Canvas>||  
+|<xref:System.Windows.Forms.PictureBox>|<xref:System.Windows.Controls.Image>||  
+|<xref:System.Windows.Forms.PrintDialog>|<xref:System.Windows.Controls.PrintDialog>||  
+|<xref:System.Drawing.Printing.PrintDocument>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.PrintPreviewControl>|<xref:System.Windows.Controls.DocumentViewer>||  
+|<xref:System.Windows.Forms.PrintPreviewDialog>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.ProgressBar>|<xref:System.Windows.Controls.ProgressBar>||  
+|<xref:System.Windows.Forms.PropertyGrid>|同等のコントロールはありません。||  
+|<xref:System.Windows.Forms.RadioButton>|<xref:System.Windows.Controls.RadioButton>||  
+|<xref:System.Windows.Forms.RichTextBox>|<xref:System.Windows.Controls.RichTextBox>||  
+|<xref:System.Windows.Forms.SaveFileDialog>|<xref:Microsoft.Win32.SaveFileDialog>|<xref:Microsoft.Win32.SaveFileDialog> クラスは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ラッパー クラスです。|  
+|<xref:System.Windows.Forms.ScrollableControl>|<xref:System.Windows.Controls.ScrollViewer>||  
+|<xref:System.Media.SoundPlayer>|<xref:System.Windows.Media.MediaPlayer>||  
+|<xref:System.Windows.Forms.SplitContainer>|<xref:System.Windows.Controls.GridSplitter>||  
+|<xref:System.Windows.Forms.StatusStrip>|<xref:System.Windows.Controls.Primitives.StatusBar>||  
+|<xref:System.Windows.Forms.TabControl>|<xref:System.Windows.Controls.TabControl>||  
+|<xref:System.Windows.Forms.TableLayoutPanel>|<xref:System.Windows.Controls.Grid>||  
+|<xref:System.Windows.Forms.TextBox>|<xref:System.Windows.Controls.TextBox>||  
+|<xref:System.Windows.Forms.Timer>|<xref:System.Windows.Threading.DispatcherTimer>||  
+|<xref:System.Windows.Forms.ToolStrip>|<xref:System.Windows.Controls.ToolBar>||  
+|<xref:System.Windows.Forms.ToolStripContainer>|コンポジションを使用した <xref:System.Windows.Controls.ToolBar>。||  
+|<xref:System.Windows.Forms.ToolStripDropDown>|コンポジションを使用した <xref:System.Windows.Controls.ToolBar>。||  
+|<xref:System.Windows.Forms.ToolStripDropDownMenu>|コンポジションを使用した <xref:System.Windows.Controls.ToolBar>。||  
+|<xref:System.Windows.Forms.ToolStripPanel>|コンポジションを使用した <xref:System.Windows.Controls.ToolBar>。||  
+|<xref:System.Windows.Forms.ToolTip>|<xref:System.Windows.Controls.ToolTip>||  
+|<xref:System.Windows.Forms.TrackBar>|<xref:System.Windows.Controls.Slider>||  
+|<xref:System.Windows.Forms.TreeView>|<xref:System.Windows.Controls.TreeView>||  
+|<xref:System.Windows.Forms.UserControl>|<xref:System.Windows.Controls.UserControl>||  
+|<xref:System.Windows.Forms.VScrollBar>|<xref:System.Windows.Controls.Primitives.ScrollBar>|スクロールは、コンテナー コントロールに組み込まれます。|  
+|<xref:System.Windows.Forms.WebBrowser>|<xref:System.Windows.Controls.Frame>, <xref:System.Windows.Controls.WebBrowser?displayProperty=fullName>|<xref:System.Windows.Controls.Frame> コントロールは、HTML ページをホストできます。<br /><br /> [!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] から、<xref:System.Windows.Controls.WebBrowser?displayProperty=fullName> コントロールは HTML ページをホストできるほか、<xref:System.Windows.Controls.Frame> コントロールをサポートできます。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [Windows フォーム開発者向け WPF デザイナー](http://msdn.microsoft.com/ja-jp/47ad0909-e89b-4996-b4ac-874d929f94ca)   
+ [チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [移行と相互運用性](../../../../docs/framework/wpf/advanced/migration-and-interoperability.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md b/docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md
new file mode 100644
index 00000000000..d70cd5f27f1
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-and-direct3d9-interoperation.md
@@ -0,0 +1,159 @@
+---
+title: "WPF と Direct3D9 の相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Direct3D9 [WPF 相互運用性], 作成 (Direct3D9 コンテンツを)"
+  - "WPF, 作成 (Direct3D9 コンテンツを)"
+ms.assetid: 1b14b823-69c4-4e8d-99e4-f6dade58f89a
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# WPF と Direct3D9 の相互運用性
+Windows Presentation Foundation \(WPF\) アプリケーションの中に Direct3D9 コンテンツを含めることができます。  このトピックでは、WPF と効率よく相互運用するための Direct3D9 コンテンツを作成する方法について説明します。  
+  
+> [!NOTE]
+>  Direct3D9 コンテンツを WPF で使用するときは、パフォーマンスについても考慮する必要があります。  パフォーマンスを最適化する方法の詳細については、「[Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)」を参照してください。  
+  
+## 表示バッファー  
+ <xref:System.Windows.Interop.D3DImage> クラスは、*バック バッファー*および*フロント バッファー*と呼ばれる 2 種類の表示バッファーを管理します。  バック バッファーはユーザーの Direct3D9 サーフェイスです。  バック バッファーへの変更点は、<xref:System.Windows.Interop.D3DImage.Unlock%2A> メソッドを呼び出すときに、フロント バッファーにコピーされます。  
+  
+ 次の図は、バック バッファーとフロント バッファーの関係を示しています。  
+  
+ ![D3DImage 表示バッファー](../../../../docs/framework/wpf/advanced/media/d3dimage-buffers.png "D3DImage\_buffers")  
+  
+## Direct3D9 デバイスの作成  
+ Direct3D9 コンテンツを表示するには、Direct3D9 デバイスを作成する必要があります。  デバイスを作成するために使用できる Direct3D9 オブジェクトには、`IDirect3D9` と `IDirect3D9Ex` の 2 種類があります。  これらのオブジェクトを使用して、`IDirect3DDevice9` デバイスと `IDirect3DDevice9Ex` デバイスを作成します。  
+  
+ 次のいずれかのメソッドを呼び出すことで、デバイスを作成します。  
+  
+-   `IDirect3D9 * Direct3DCreate9(UINT SDKVersion);`  
+  
+-   `HRESULT Direct3DCreate9Ex(UINT SDKVersion, IDirect3D9Ex **ppD3D);`  
+  
+ Windows Vista または後で、Windows オペレーティング システム Driver Display Model \(WDDM\) を使用するようにコンフィギュレーションされていると `Direct3DCreate9Ex` の表示方法を使用します。  それ以外のすべてのプラットフォームでは、`Direct3DCreate9` メソッドを使用します。  
+  
+### Direct3DCreate9Ex メソッドの可用性  
+ d3d9.dll に Windows Vista またはそれ以降のオペレーティング システムでのみ `Direct3DCreate9Ex` の方法があります。  この関数を Windows XP で直接リンクすると、アプリケーションの読み込みが失敗します。  `Direct3DCreate9Ex` メソッドがサポートされているかどうかを確認するには、この DLL を読み込み、プロシージャ アドレスを探します。  次のコードは、`Direct3DCreate9Ex` メソッドをテストする方法を示しています。  完全なコード例については、「[チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md)」を参照してください。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#RendererManager_EnsureD3DObjects](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.cpp#renderermanager_ensured3dobjects)]  
+  
+### HWND の作成  
+ デバイスを作成するには、HWND が必要です。  通常は、使用する Direct3D9 用のダミー HWND を作成します。  次のコード例は、ダミー HWND を作成する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#RendererManager_EnsureHWND](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.cpp#renderermanager_ensurehwnd)]  
+  
+### 表示パラメーター  
+ デバイスを作成するには `D3DPRESENT_PARAMETERS` 構造体も必要ですが、重要なのは一部のパラメーターだけです。  これらのパラメーターは、メモリの使用量を最小限に抑えるために選択されています。  
+  
+ `BackBufferHeight` フィールドおよび `BackBufferWidth` フィールドを 1 に設定します。  これらを 0 に設定すると、HWND のサイズが設定されます。  
+  
+ Direct3D9 によって使用されるメモリの破棄と Direct3D9 による FPU 設定の変更を回避するために、`D3DCREATE_MULTITHREADED` フラグと `D3DCREATE_FPU_PRESERVE` フラグを常に設定します。  
+  
+ 次のコードは、`D3DPRESENT_PARAMETERS` 構造体を初期化する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#Renderer_Init](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderer.cpp#renderer_init)]  
+  
+## バック バッファーのレンダリング先の作成  
+ <xref:System.Windows.Interop.D3DImage> 内の Direct3D9 コンテンツを表示するには、Direct3D9 サーフェイスを作成し、<xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> メソッドを呼び出してそれを割り当てます。  
+  
+### アダプターによるサポートの確認  
+ サーフェイスを作成する前に、必要なサーフェイス プロパティがすべてのアダプターでサポートされていることを確認します。  レンダリング先として 1 つのアダプターだけを指定した場合でも、WPF ウィンドウはシステム内のどのアダプターでも表示できます。  WPF では使用可能なアダプター間でサーフェイスを移動することがあるので、マルチアダプター構成を処理する Direct3D9 コードを常に記述し、すべてのアダプターのサポート状況を確認してください。  
+  
+ 次のコード例は、システムのすべてのアダプターで Direct3D9 がサポートされているかどうかを調べる方法を示しています。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#RendererManager_TestSurfaceSettings](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.cpp#renderermanager_testsurfacesettings)]  
+  
+### サーフェイスの作成  
+ サーフェイスを作成する前に、デバイスが対象のオペレーティング システム上で適切なパフォーマンスで動作できることを確認します。  詳細については、「[Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)」を参照してください。  
+  
+ デバイスの能力を確認した後、サーフェイスを作成できます。  次のコード例は、レンダリング先を作成する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#Renderer_CreateSurface](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderer.cpp#renderer_createsurface)]  
+  
+### WDDM  
+ WDDM を使用するようにコンフィギュレーションされた後のオペレーティング システムと Windows Vista でレンダー ターゲットのテクスチャを作成し、<xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> 方法にレベルを 0 の標的を渡すことができます。  Windows XP では、ロック可能なレンダリング先のテクスチャを作成できず、パフォーマンスが低下するので、この方法はお勧めしません。  
+  
+## デバイス状態の処理  
+ <xref:System.Windows.Interop.D3DImage> クラスは、*バック バッファー*および*フロント バッファー*と呼ばれる 2 種類の表示バッファーを管理します。  バック バッファーは、ユーザーの Direct3D サーフェイスです。   は、バッファの変更がフロント バッファへのハードウェアに表示される <xref:System.Windows.Interop.D3DImage.Unlock%2A> 方法を追加すると、コピーようになります。  場合によっては、バッファ フロントは使用できなくなります。  デバイスが使用できなくなる原因としては、画面のロック、全画面表示の専用 Direct3D アプリケーション、ユーザーの切り替え、その他のシステムの動作が考えられます。  このような場合は、の WPF のアプリケーションは <xref:System.Windows.Interop.D3DImage.IsFrontBufferAvailableChanged> イベントの処理によって通知されます。  自分のアプリケーションで使用できなくなるフロント バッファに対応する方法を WPF がソフトウェアの表示にはあることを可能にするかによって異なります。  <xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> 方法に WPF は、ソフトウェアの表示にはあるかどうかを指定するパラメータを受け取る過負荷があります。  
+  
+ <xref:System.Windows.Interop.D3DImage.SetBackBuffer%28System.Windows.Interop.D3DResourceType%2CSystem.IntPtr%29> の過負荷に電話または `false`に設定 `enableSoftwareFallback` パラメータの <xref:System.Windows.Interop.D3DImage.SetBackBuffer%28System.Windows.Interop.D3DResourceType%2CSystem.IntPtr%2CSystem.Boolean%29> 過負荷の名前を表示するとシステムはフロント バッファが使用できないになり、何も表示されない場合は、バッファへの参照をリリースします。  フロント バッファが再び使用可能な場合、表示のシステムは、WPF のアプリケーションを通知するために <xref:System.Windows.Interop.D3DImage.IsFrontBufferAvailableChanged> のイベントを上げます。  有効な Direct3D が直面すると、再び表示を再開するに <xref:System.Windows.Interop.D3DImage.IsFrontBufferAvailableChanged> のイベントのイベント ハンドラーを作成できます。  表示を再開するには、<xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A>を追加する必要があります。  
+  
+ `true`に設定 `enableSoftwareFallback` パラメータの <xref:System.Windows.Interop.D3DImage.SetBackBuffer%28System.Windows.Interop.D3DResourceType%2CSystem.IntPtr%2CSystem.Boolean%29> 過負荷の名前を表示するとシステムはフロント バッファが再び使用可能な場合フロント バッファが使用できなくなっている場合は、バッファへの参照は存在するが <xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> を追加する必要残しません。  
+  
+ ソフトウェアの表示が有効の場合、ユーザーのデバイスが使用できなくなる、システムが表示 Direct3D が直面への参照を終了ステータスがあります。  Direct3D9 デバイスが利用不可かどうかを確認するには、`TestCooperativeLevel` 方法を追加します。  `TestCooperativeLevel` 方法が常に非難され、成功を返すこと、Direct3D9Ex デバイスを確認するには `CheckDeviceState` 方法を追加します。  ユーザーのデバイスが使用できなくなっている場合は、バッファに WPF の参照をリリースするに <xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> を追加します。  自分のデバイスをリセットする必要がある場合は `null`に設定 `backBuffer` パラメータの <xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> と呼ばれる次に `backBuffer` の <xref:System.Windows.Interop.D3DImage.SetBackBuffer%2A> を設定します Direct3D に再度有効な標的を追加します。  
+  
+ 無効なデバイスから回復するための `Reset` メソッドの呼び出しは、マルチアダプターのサポートを実装する場合のみ実行します。  それ以外の場合は、すべての Direct3D9 インターフェイスを解放し、全体を再作成します。  アダプターのレイアウトが変更されている場合、変更前に作成された Direct3D9 オブジェクトは更新されません。  
+  
+## サイズ変更の処理  
+ <xref:System.Windows.Interop.D3DImage> が、のサイズ以外の決済に表示されている場合、期限内に <xref:System.Windows.Media.RenderOptions.BitmapScalingMode%2A>に従って縮小増幅されますが、例外と、<xref:System.Windows.Media.Effects.SamplingMode> は <xref:System.Windows.Media.BitmapScalingMode>の代わりになります。  
+  
+ 高い忠実性が必要な場合は、<xref:System.Windows.Interop.D3DImage> のコンテナーのサイズが変更されたときに新しいサーフェイスを作成する必要があります。  
+  
+ サイズ変更を処理する方法には、以下の 3 つがあります。  
+  
+-   レイアウト システムを処理し、サイズが変更されたときに新しいサーフェイスを作成します。  ビデオ メモリの不足や断片化が発生する可能性があるので、作成するサーフェイスが多くなりすぎないようにしてください。  
+  
+-   一定期間待機してサイズ変更イベントが発生しないことを確認した後、新しいサーフェイスを作成します。  
+  
+-   コンテナーのサイズを 1 秒間に数回チェックする <xref:System.Windows.Threading.DispatcherTimer> を作成します。  
+  
+## マルチモニターの最適化  
+ レンダリング システムが <xref:System.Windows.Interop.D3DImage> を別のモニターに移動したときに、パフォーマンスが大幅に低下する場合があります。  
+  
+ WDDM の場合、移動前後のモニターが同じビデオ カード上にあり、`Direct3DCreate9Ex` を使用している限り、パフォーマンスが低下することはありません。  モニターが別々のビデオ カードを使用している場合は、パフォーマンスが低下します。  Windows XP の場合、パフォーマンスは常に低下します。  
+  
+ <xref:System.Windows.Interop.D3DImage> が別のモニターに移動するときは、対応するアダプター上に新しいサーフェイスを作成することで、パフォーマンスを維持できます。  
+  
+ パフォーマンスの低下を回避するには、マルチモニター用に特別なコードを記述します。  次のリストは、マルチモニター コードを記述するための 1 つの方法を示しています。  
+  
+1.  <xref:System.Windows.Interop.D3DImage> の画面空間でのポイントを、`Visual.ProjectToScreen` メソッドを使用して検出します。  
+  
+2.  `MonitorFromPoint` GDI メソッドを使用して、そのポイントを表示しているモニターを検出します。  
+  
+3.  `IDirect3D9::GetAdapterMonitor` メソッドを使用して、モニターがオンになっている Direct3D9 アダプターを検出します。  
+  
+4.  検出されたアダプターがバック バッファーを持つアダプターと一致しない場合は、新しいモニターに新しいバック バッファーを作成し、それを <xref:System.Windows.Interop.D3DImage> バック バッファーに割り当てます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Interop.D3DImage> がモニター間にまたがる場合、WDDM と `IDirect3D9Ex` が同一のアダプター上にあるときを除いてパフォーマンスは低下します。  このような状況では、パフォーマンスを向上させる方法はありません。  
+  
+ 次のコード例は、現在のモニターを検出する方法を示しています。  
+  
+ [!code-cpp[System.Windows.Interop.D3DImage#RendererManager_SetAdapter](../../../../samples/snippets/cpp/VS_Snippets_Wpf/System.Windows.Interop.D3DImage/cpp/renderermanager.cpp#renderermanager_setadapter)]  
+  
+ <xref:System.Windows.Interop.D3DImage> コンテナーのサイズまたは位置が変更されたとき、モニターを更新します。または、1 秒間に数回更新を行う `DispatcherTimer` を使用してモニターを更新します。  
+  
+## WPF ソフトウェアのレンダリング  
+ WPF は、次のような場合、ソフトウェアの UI スレッドで同期的にレンダリングします。  
+  
+-   印刷  
+  
+-   <xref:System.Windows.Media.Effects.BitmapEffect>  
+  
+-   <xref:System.Windows.Media.Imaging.RenderTargetBitmap>  
+  
+ これらの状況のいずれかが発生すると、レンダリング システムは <xref:System.Windows.Interop.D3DImage.CopyBackBuffer%2A> メソッドを呼び出して、ハードウェア バッファーをソフトウェアにコピーします。  既定の実装では、`GetRenderTargetData` メソッドをサーフェイスを使用して呼び出します。  この呼び出しはロック\/ロック解除パターンの外部で発生するので、失敗する場合があります。  この場合、`CopyBackBuffer` メソッドは `null` を返し、イメージは表示されません。  
+  
+ <xref:System.Windows.Interop.D3DImage.CopyBackBuffer%2A> メソッドをオーバーライドして基本実装を呼び出すことができ、`null` が返された場合はプレースホルダー <xref:System.Windows.Media.Imaging.BitmapSource> を返すことができます。  
+  
+ 基本実装を呼び出す代わりに、独自のソフトウェア レンダリングを実装することもできます。  
+  
+> [!NOTE]
+>  WPF がソフトウェア内で完全にレンダリングを実行する場合、WPF にフロント バッファーがないために <xref:System.Windows.Interop.D3DImage> は表示されません。  
+  
+## 参照  
+ <xref:System.Windows.Interop.D3DImage>   
+ [Direct3D9 および WPF の相互運用性のパフォーマンスに関する考慮事項](../../../../docs/framework/wpf/advanced/performance-considerations-for-direct3d9-and-wpf-interoperability.md)   
+ [チュートリアル : WPF でホストするための Direct3D9 コンテンツの作成](../../../../docs/framework/wpf/advanced/walkthrough-creating-direct3d9-content-for-hosting-in-wpf.md)   
+ [チュートリアル : WPF での Direct3D9 コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-direct3d9-content-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-and-win32-interoperation.md b/docs/framework/wpf/advanced/wpf-and-win32-interoperation.md
new file mode 100644
index 00000000000..7c04703490f
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-and-win32-interoperation.md
@@ -0,0 +1,171 @@
+---
+title: "WPF と Win32 の相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスト (WPF コンテンツを Win32 ウィンドウで)"
+  - "HWND 相互運用機能 [WPF]"
+  - "相互運用性 [WPF], Win32"
+  - "Win32 コード, WPF 相互運用"
+ms.assetid: 0ffbde0d-701d-45a3-a6fa-dd71f4d9772e
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# WPF と Win32 の相互運用性
+このトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] および [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードを相互運用する方法の概要について説明します。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] コードに多くの投資を行った場合は、そのコードの一部を再利用する方がより効率的である場合があります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="basics"></a>   
+## WPF と Win32 の相互運用の基本  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードを相互運用するための基本的な手法は 2 つあります。  
+  
+-   [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをホストします。  この手法では、標準の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウおよびアプリケーションのフレームワーク内で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の高度なグラフィックス機能を使用できます。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツで [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウをホストします。  この手法では、既存のカスタム [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コントロールを他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツのコンテキストで使用し、境界を越えてデータを渡すことができます。  
+  
+ ここでは、これらの各手法について概念的に説明します。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をホストする場合のコードを使用した説明については、「[チュートリアル: Win32 での WPF コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md)」を参照してください。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] をホストする場合のコードを使用した説明については、「[チュートリアル: WPF での Win32 コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md)」を参照してください。  
+  
+<a name="projects"></a>   
+## WPF 相互運用プロジェクト  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] はマネージ コードですが、ほとんどの既存の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プログラムはアンマネージ [!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] で記述されています。  純粋なアンマネージ プログラムから [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)][!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を呼び出すことはできません。  ただし、[!INCLUDE[TLA#tla_visualcpp](../../../../includes/tlasharptla-visualcpp-md.md)] コンパイラで `/clr` オプションを使用すると、マネージとアンマネージの [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] 呼び出しをシームレスに混在させることができる、マネージとアンマネージの混在プログラムを作成することができます。  
+  
+ プロジェクト レベルで、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルを [!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] プロジェクトにコンパイルできないという問題があります。  これを解決するために、プロジェクトを分割する手法がいくつかあります。  
+  
+-   すべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを含む [!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] DLL をコンパイル済みのアセンブリとして作成し、[!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] 実行可能ファイルにその [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] を参照として含めます。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツの [!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] 実行可能ファイルを作成し、そのファイルが [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンテンツを含む [!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] [!INCLUDE[TLA2#tla_dll](../../../../includes/tla2sharptla-dll-md.md)] を参照するようにします。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] をコンパイルする代わりに、<xref:System.Windows.Markup.XamlReader.Load%2A> を使用して、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を実行時に読み込みます。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用せずに、すべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をコードで記述し、<xref:System.Windows.Application> から要素ツリーを構築します。  
+  
+ これらの中で最適な方法を使用してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] を使用したことがない場合は、相互運用のコード例に `gcnew` や `nullptr` などの "見慣れない" キーワードがあるかもしれません。古い二重アンダースコアの構文 \(`__gc`\) がこれらのキーワードによって置き換えられています。これらのキーワードを使用すると、[!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] のマネージ コードの構文がより自然になります。  [!INCLUDE[TLA#tla_cppcli](../../../../includes/tlasharptla-cppcli-md.md)] マネージ機能の詳細については、「[ランタイム プラットフォームのコンポーネントの拡張機能](../Topic/Component%20Extensions%20for%20Runtime%20Platforms.md)」および「[Hello, C\+\+\/CLI](http://go.microsoft.com/fwlink/?LinkId=98739)」を参照してください。  
+  
+<a name="hwnds"></a>   
+## WPF での Hwnd の使用方法  
+ ほとんどの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] "HWND 相互運用" を行うには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] での HWND の使用方法を理解する必要があります。  HWND では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レンダリングと [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] レンダリングまたは [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)]\/[!INCLUDE[TLA2#tla_gdiplus](../../../../includes/tla2sharptla-gdiplus-md.md)] レンダリングを混在させることはできません。  混在させると、さまざまな影響が生じます。  主に、これらのレンダリング モデルを混在させるには、相互運用ソリューションを作成し、使用するレンダリング モデルごとに指定された相互運用セグメントを使用する必要があります。  また、相互運用ソリューションで実現できる動作に対する "空域" 制限がレンダリング動作によって生じます。  "空域" の概念の詳細については、「[技術領域の概要](../../../../docs/framework/wpf/advanced/technology-regions-overview.md)」を参照してください。  
+  
+ 画面上のすべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素が最終的に HWND によってサポートされます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Window> を作成すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によってトップレベルの HWND が作成され、<xref:System.Windows.Interop.HwndSource> を使用して <xref:System.Windows.Window> とその [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツが HWND 内に格納されます。  アプリケーション内の残りの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、その単一の HWND を共有します。  ただし、メニュー、コンボ ボックス ドロップダウン、およびその他のポップアップは例外です。  これらの要素では独自のトップレベル ウィンドウが作成されます。このため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] メニューは、そのメニューを格納するウィンドウ HWND の端を越える可能性があります。  <xref:System.Windows.Interop.HwndHost> を使用して HWND を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内に格納すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Window> HWND に対して新しい子 HWND を配置する方法が [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] から [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] に通知されます。  
+  
+ HWND の関連概念として、各 HWND 内および各 HWND 間の透過性が挙げられます。  これは、「[技術領域の概要](../../../../docs/framework/wpf/advanced/technology-regions-overview.md)」でも解説されています。  
+  
+<a name="hosting_a_wpf_page"></a>   
+## Microsoft Win32 ウィンドウでの WPF コンテンツのホスト  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をホストするキーとなるのは、<xref:System.Windows.Interop.HwndSource> クラスです。  このクラスは [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツをラップし、その [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツを子ウィンドウとして[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に組み込むことができます。  次の方法では、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] および [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を単一のアプリケーションに統合します。  
+  
+1.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ \(コンテンツのルート要素\) をマネージ クラスとして実装します。  通常、このクラスは、複数の子要素を格納できるクラスやルート要素として使用されるクラスのいずれか \(<xref:System.Windows.Controls.DockPanel> や <xref:System.Windows.Controls.Page> など\) から継承されます。  以降の手順では、このクラスを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ クラスと呼び、そのクラスのインスタンスを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトと呼びます。  
+  
+2.  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] アプリケーションを [!INCLUDE[TLA2#tla_cppcli](../../../../includes/tla2sharptla-cppcli-md.md)] で実装します。  既存のアンマネージ [!INCLUDE[TLA2#tla_cpp](../../../../includes/tla2sharptla-cpp-md.md)] アプリケーションから始める場合、通常、`/clr` コンパイラ フラグが含まれるようにプロジェクトの設定を変更して、アプリケーションでマネージ コードを呼び出すことができるようにできます \(`/clr` コンパイルをサポートするための要件の詳細については、ここでは説明しません\)。  
+  
+3.  スレッド処理モデルをシングル スレッド アパートメント \(STA: Single Threaded Apartment\) に設定します。  このスレッド処理モデルを使用するのは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のみです。  
+  
+4.  ウィンドウ プロシージャで WM\_CREATE 通知を処理します。  
+  
+5.  ハンドラー \(またはハンドラーが呼び出す関数\) で、次の手順を実行します。  
+  
+    1.  `parent` パラメーターとして親ウィンドウ HWND を持つ新しい <xref:System.Windows.Interop.HwndSource> オブジェクトを作成します。  
+  
+    2.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ クラスのインスタンスを作成します。  
+  
+    3.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトへの参照を <xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティに割り当てます。  
+  
+    4.  <xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.Handle%2A> プロパティにウィンドウ ハンドル \(HWND\) が格納されます。  アプリケーションのアンマネージ部分で使用できる HWND を取得するには、`Handle.ToPointer()` を HWND にキャストします。  
+  
+6.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトへの参照を保持する静的フィールドを含むマネージ クラスを実装します。  このクラスを使用すると、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コードから [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトへの参照を取得できますが、さらに、<xref:System.Windows.Interop.HwndSource> が不注意によりガベージ コレクトされることを回避できます。  
+  
+7.  ハンドラーを 1 つ以上の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクト イベントにアタッチして、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトから通知を受信します。  
+  
+8.  静的フィールドに格納した参照を使用してプロパティの設定やメソッドの呼び出しなどを行い、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ オブジェクトと通信します。  
+  
+> [!NOTE]
+>  個別のアセンブリを生成して参照する場合、手順 1. の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ クラスの定義の一部またはすべてを、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でコンテンツ クラスの既定の部分クラスを使用して行うことができます。通常は、<xref:System.Windows.Application> オブジェクトを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のコンパイルの一部としてアセンブリに含めますが、その <xref:System.Windows.Application> を相互運用の一部として使用することにはなりません。単に、アプリケーションによって参照される [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルの 1 つ以上のルート クラスを使用し、その部分クラスを参照します。  手順の残りの部分は、基本的に前述の手順と同様です。  
+>   
+>  これらの各手順のコードを使用した説明については、「[チュートリアル: Win32 での WPF コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md)」を参照してください。  
+  
+<a name="hosting_an_hwnd"></a>   
+## WPF での Microsoft Win32 ウィンドウのホスト  
+ 他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツ内で [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウをホストするキーとなるのは、<xref:System.Windows.Interop.HwndHost> クラスです。  このクラスは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素ツリーに追加できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素でウィンドウをラップします。  また、<xref:System.Windows.Interop.HwndHost> は、ホストされたウィンドウのメッセージの処理などのタスクを実行できるようにする [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] もサポートします。  基本手順は次のとおりです。  
+  
+1.  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの要素ツリーを作成します \(コードまたはマークアップで作成できます\)。  <xref:System.Windows.Interop.HwndHost> の実装を子要素として追加できる適切な許可ポイントを要素ツリーで検索します。  この手順では以後、この要素を予約要素と呼びます。  
+  
+2.  <xref:System.Windows.Interop.HwndHost> からの派生クラスを作成し、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンテンツを保持するオブジェクトを作成します。  
+  
+3.  そのホスト クラスで、<xref:System.Windows.Interop.HwndHost> の <xref:System.Windows.Interop.HwndHost.BuildWindowCore%2A> メソッドをオーバーライドします。  ホストされたウィンドウの HWND を返します。  返されたウィンドウの子ウィンドウとして実際のコントロールをラップすることもできます。ホスト ウィンドウでコントロールをラップすると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツでコントロールからの通知を簡単に受信できます。  この手法により、ホストされたコントロールの境界でのメッセージ処理に関するいくつかの [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 問題を修正できます。  
+  
+4.  <xref:System.Windows.Interop.HwndHost> の <xref:System.Windows.Interop.HwndHost.DestroyWindowCore%2A> メソッドと <xref:System.Windows.Interop.HwndHost.WndProc%2A> メソッドをオーバーライドします。  これは、クリーンアップの処理およびホストされたコンテンツへの参照の削除を行うためです \(特に、アンマネージ オブジェクトへの参照を作成した場合\)。  
+  
+5.  分離コード ファイルで、コントロール ホスト クラスのインスタンスを作成し、予約要素の子にします。  通常は、<xref:System.Windows.FrameworkElement.Loaded> などのイベント ハンドラーを使用するか、部分クラス コンストラクターを使用します。  ただし、ランタイム動作によって相互運用コンテンツを追加することもできます。  
+  
+6.  コントロールの通知などの選択されたウィンドウ メッセージを処理します。  処理方法は 2 つあります。  どちらも同様にメッセージ ストリームにアクセスできるようにするため、どちらを選択するかは、多くの場合、プログラミングの便宜上の理由によって決まります。  
+  
+    -   <xref:System.Windows.Interop.HwndHost> の <xref:System.Windows.Interop.HwndHost.WndProc%2A> メソッドのオーバーライドで、シャットダウン メッセージだけでなくすべてのメッセージのメッセージ処理を実装します。  
+  
+    -   <xref:System.Windows.Interop.HwndHost.MessageHook> イベントを処理して、ホスト [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素でメッセージを処理します。  このイベントは、ホストされたウィンドウのメイン ウィンドウ プロシージャに送信されるすべてのメッセージに対して発生します。  
+  
+    -   メッセージは、<xref:System.Windows.Interop.HwndHost.WndProc%2A> を使用するプロセスで発生したウィンドウからは処理できません。  
+  
+7.  プラットフォーム呼び出しを使用してアンマネージ `SendMessage` 関数を呼び出し、ホストされたウィンドウと通信します。  
+  
+ 次の手順に従って、マウス入力で動作するアプリケーションを作成します。  <xref:System.Windows.Interop.IKeyboardInputSink> インターフェイスを実装して、ホストされたウィンドウで Tab キーによる移動がサポートされるようにすることができます。  
+  
+ これらの各手順のコードを使用した説明については、「[チュートリアル: WPF での Win32 コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md)」を参照してください。  
+  
+### WPF 内の HWND  
+ <xref:System.Windows.Interop.HwndHost> は特殊なコントロールであると考えることができます   \(技術的には、<xref:System.Windows.Interop.HwndHost> は <xref:System.Windows.Controls.Control> 派生クラスではなく、<xref:System.Windows.FrameworkElement> 派生クラスですが、相互運用のためのコントロールと見なすことができます\)。<xref:System.Windows.Interop.HwndHost> は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の残りの部分が、ホストされたコンテンツは入力を描画および処理する別のコントロールに似たオブジェクトであると見なすように、ホストされたコンテンツの基になる [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 特性を抽出します。  通常、<xref:System.Windows.Interop.HwndHost> は他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.FrameworkElement> と同様に動作しますが、出力 \(描画とグラフィックス\) および入力 \(マウスとキーボード\) には、基になる HWND のサポート内容の制限に基づく重要な違いがいくつかあります。  
+  
+#### 出力動作の顕著な違い  
+  
+-   <xref:System.Windows.Interop.HwndHost> の基底クラスである <xref:System.Windows.FrameworkElement> には、UI の変更に関係する多くのプロパティが用意されています。  これには、親要素内の要素のレイアウトを変更する <xref:System.Windows.FrameworkElement.FlowDirection%2A?displayProperty=fullName> などのプロパティが含まれます。  ただし、これらのプロパティの多くは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] で有効な等価機能が存在しても、それに対応付けられていません。  非常に多くのプロパティとその意味がレンダリング テクノロジ固有でありすぎるために、対応付けをしても役に立ちません。  そのため、<xref:System.Windows.Interop.HwndHost> で <xref:System.Windows.FrameworkElement.FlowDirection%2A> などのプロパティを設定しても効果がありません。  
+  
+-   <xref:System.Windows.Interop.HwndHost> は、回転、拡大縮小、傾斜、または変換の影響を受けません。  
+  
+-   <xref:System.Windows.Interop.HwndHost> では、<xref:System.Windows.UIElement.Opacity%2A> プロパティ \(アルファ ブレンディング\) はサポートされません。  <xref:System.Windows.Interop.HwndHost> 内のコンテンツでアルファ情報を含む <xref:System.Drawing> 操作が実行される場合、それ自体は違反ではありませんが、<xref:System.Windows.Interop.HwndHost> 全体では不透明度 \= 1.0 \(100%\) のみがサポートされます。  
+  
+-   <xref:System.Windows.Interop.HwndHost> は、同じトップレベル ウィンドウの他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の上に表示されます。  ただし、<xref:System.Windows.Controls.ToolTip> または <xref:System.Windows.Controls.ContextMenu> で生成されるメニューは独立したトップレベル ウィンドウであるため、<xref:System.Windows.Interop.HwndHost> で正しく動作します。  
+  
+-   <xref:System.Windows.Interop.HwndHost> は、親 <xref:System.Windows.UIElement> のクリッピング領域に対応しません。  これは、<xref:System.Windows.Interop.HwndHost> クラスをスクロール領域または <xref:System.Windows.Controls.Canvas> に格納しようとする場合に問題となる可能性があります。  
+  
+#### 入力動作の顕著な違い  
+  
+-   通常、入力デバイスは、<xref:System.Windows.Interop.HwndHost> がホストする [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 領域内がスコープとなり、入力イベントは [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] に直接移動します。  
+  
+-   <xref:System.Windows.Interop.HwndHost> の上にマウスがあるとき、アプリケーションは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マウス イベントを受け取らず、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の <xref:System.Windows.UIElement.IsMouseOver%2A> プロパティの値は `false` になります。  
+  
+-   <xref:System.Windows.Interop.HwndHost> にキーボード フォーカスがあるとき、アプリケーションは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] キーボード イベントを受け取らず、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の <xref:System.Windows.UIElement.IsKeyboardFocusWithin%2A> プロパティの値は `false` になります。  
+  
+-   <xref:System.Windows.Interop.HwndHost> 内にあるフォーカスが <xref:System.Windows.Interop.HwndHost> 内の別のコントロールに移動したとき、アプリケーションは [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の <xref:System.Windows.UIElement.GotFocus> イベントまたは <xref:System.Windows.UIElement.LostFocus> イベントを受け取りません。  
+  
+-   関連するスタイラス プロパティおよびイベントは類似しており、スタイラスが <xref:System.Windows.Interop.HwndHost> 上にあるときは情報を報告しません。  
+  
+<a name="tabbing_mnemonics_accelerators"></a>   
+## Tab キーによる移動、ニーモニック、およびアクセラレータ  
+ <xref:System.Windows.Interop.IKeyboardInputSink> インターフェイスおよび <xref:System.Windows.Interop.IKeyboardInputSite> インターフェイスを使用すると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] が混在するアプリケーションでシームレスなキーボード操作を実現できます。  
+  
+-   [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンポーネントと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンポーネント間の Tab キーによる移動  
+  
+-   フォーカスが Win32 コンポーネント内にある場合と WPF コンポーネント内にある場合の両方で動作するニーモニックおよびアクセラレータ  
+  
+ <xref:System.Windows.Interop.HwndHost> クラスと <xref:System.Windows.Interop.HwndSource> クラスはどちらも <xref:System.Windows.Interop.IKeyboardInputSink> の実装を提供しますが、より高度なシナリオで必要な入力メッセージが一部処理されない場合があります。  適切なメソッドをオーバーライドして、必要なキーボード動作を確保してください。  
+  
+ インターフェイスは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 領域と [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 領域間の遷移で発生する処理をサポートするだけです。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 領域では、Tab キーによる移動動作は、Tab キーによる移動の [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] 実装ロジック \(ある場合\) によって完全に制御されます。  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndHost>   
+ <xref:System.Windows.Interop.HwndSource>   
+ <xref:System.Windows.Interop>   
+ [チュートリアル: WPF での Win32 コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-win32-control-in-wpf.md)   
+ [チュートリアル: Win32 での WPF コンテンツのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-wpf-content-in-win32.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md b/docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md
new file mode 100644
index 00000000000..a2d91b1e58c
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md
@@ -0,0 +1,134 @@
+---
+title: "WPF と Windows フォームの相互運用性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ハイブリッド コントロール [WPF 相互運用性]"
+  - "相互運用性 [WPF], Windows フォーム"
+  - "入れ子になった相互運用 [WPF]"
+  - "Windows フォーム [WPF], 相互運用性"
+  - "Windows フォーム, WPF 相互運用"
+ms.assetid: 9e8aa6b6-112c-4579-98d1-c974917df499
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# WPF と Windows フォームの相互運用性
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]は、アプリケーション インターフェイスを作成するための 2 つの異なるアーキテクチャを提供します。  <xref:System.Windows.Forms.Integration?displayProperty=fullName> 名前空間は、共通の相互運用シナリオを可能にするクラスを提供します。  相互運用機能を実装する 2 つの主要クラスは、<xref:System.Windows.Forms.Integration.WindowsFormsHost> と <xref:System.Windows.Forms.Integration.ElementHost> です。  ここでは、サポートされる相互運用シナリオと、サポートされないシナリオについて説明します。  
+  
+> [!NOTE]
+>  *ハイブリッド コントロール* シナリオには特に注意する必要があります。  ハイブリッド コントロールは、あるテクノロジのコントロールの入れ子になっている別のテクノロジのコントロールです。  これは、*入れ子になった相互運用*とも呼ばれます。  *複数レベルのハイブリッド コントロール*には、複数のレベルで入れ子になっているハイブリッド コントロールが含まれます。  複数レベルの入れ子になった相互運用の例として、ある [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが含まれ、さらにそのコントロールに [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが含まれている場合があります。  複数レベルのハイブリッド コントロールはサポートされていません。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Windows_Presentation_Foundation_Application_Hosting"></a>   
+## WPF での Windows フォーム コントロールのホスト  
+ 次の相互運用のシナリオは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールをホストする場合にサポートされます。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールは、XAML を使用して 1 つ以上の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールをホストできます。  
+  
+-   コードを使用して 1 つ以上の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールをホストできます。  
+  
+-   他の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを含む [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コンテナー コントロールをホストできます。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マスターおよび [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] 詳細を使用して、マスター\/詳細フォームをホストできます。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] マスターおよび [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 詳細を使用して、マスター\/詳細フォームをホストできます。  
+  
+-   1 つ以上の [!INCLUDE[TLA2#tla_actx](../../../../includes/tla2sharptla-actx-md.md)] コントロールをホストできます。  
+  
+-   1 つ以上の複合コントロールをホストできます。  
+  
+-   [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用してハイブリッド コントロールをホストできます。  
+  
+-   コードを使用してハイブリッド コントロールをホストできます。  
+  
+### レイアウトのサポート  
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 要素がホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]のレイアウト システムに統合する際の既知の制限を次のリストに示します。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、サイズを変更できなかったり、特定のサイズにしか設定できない場合があります。  たとえば、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] <xref:System.Windows.Forms.ComboBox> コントロールは、コントロールのフォント サイズで定義されている 1 つの高さしかサポートしていません。  要素を垂直方向に伸縮できると想定される、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の動的レイアウトでは、ホストされている <xref:System.Windows.Forms.ComboBox> コントロールは同様には伸縮できません。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは回転または斜めにすることはできません。  たとえば、ユーザー インターフェイスを 90°回転した場合、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの垂直の位置は維持されます。  
+  
+-   ほとんどの場合、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、比率を保持したまま拡大縮小することはできません。  コントロール全体のサイズは拡大縮小されますが、コントロールの子コントロールやコンポーネント要素のサイズは希望どおりに変更できません。  この制限は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] の各コントロールで拡大縮小をどの程度サポートしているかに依存します。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ユーザー インターフェイスでは、要素の z オーダーを変更して重複を制御できます。  ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは別の HWND で描画されるため、常に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素の一番上に描画されます。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、フォント サイズに基づく自動スケーリングをサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ユーザー インターフェイスでは、フォント サイズを変更しても、レイアウト全体のサイズは変わりません。ただし、個々の要素は動的にサイズを変更できます。  
+  
+### アンビエント プロパティ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの一部のアンビエント プロパティは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] と同等の機能があります。  これらのアンビエント プロパティは、ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに適用され、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールのパブリック プロパティとして公開されます。  <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは、各 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アンビエント プロパティをその [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]の等価プロパティに変換します。  
+  
+ 詳細については、「[Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)」を参照してください。  
+  
+### \[動作\]  
+ 相互運用動作の説明を次の表に示します。  
+  
+|\[動作\]|サポート状況|Not supported|  
+|------------|------------|-------------------|  
+|透過性|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのレンダリングは透過性をサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の親コントロールの背景を、ホストしている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの背景にすることができます。|一部の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、透過性をサポートしません。  たとえば、<xref:System.Windows.Forms.TextBox> コントロールと <xref:System.Windows.Forms.ComboBox> コントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でホストされている場合、透明になりません。|  
+|Tab キーによる移動|ホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールのタブ オーダーは、それらのコントロールが [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ベースのアプリケーションでホストされている場合と同じです。<br /><br /> Tab キーおよび Shift \+ Tab キーを使用した [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールから [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールへの Tab キーによる移動は、通常どおり動作します。<br /><br /> <xref:System.Windows.Forms.Control.TabStop%2A> プロパティの値が `false` になっている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、ユーザーがコントロール間を Tab キーで移動しても、フォーカスを受け取りません。<br /><br /> -   各 <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールは <xref:System.Windows.Forms.Integration.WindowsFormsHost.TabIndex%2A> 値を持ちます。この値は、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールがフォーカスを受け取るタイミングを決定します。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コンテナー内に含まれている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、<xref:System.Windows.Forms.Control.TabIndex%2A> プロパティで指定されたタブ オーダーに従います。  最後のタブ インデックスで Tab キーを押すと、次の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール \(存在する場合\) にフォーカスが移ります。  他にフォーカスを取得できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが存在しない場合、Tab キーを押すと、タブ オーダーの最初の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに移動します。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> 内のコントロールの <xref:System.Windows.Forms.Integration.WindowsFormsHost.TabIndex%2A> 値は、<xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールに含まれている兄弟 [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールを基準にします。<br />-   Tab キーによる移動は、コントロール固有の動作に従います。  たとえば、<xref:System.Windows.Forms.TextBoxBase.AcceptsTab%2A> プロパティの値が `true` になっている <xref:System.Windows.Forms.TextBox> コントロールで Tab キーを押すと、フォーカスが移動するのではなく、テキスト ボックス内にタブが入力されます。|該当なし。|  
+|方向キーによるナビゲーション|-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールでの方向キーによるナビゲーションは、通常の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コンテナー コントロールと同じです。上方向キーと左方向キーは前のコントロールを選択し、下方向キーと右方向キーは次のコントロールを選択します。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールに含まれている最初のコントロールで上方向キーと左方向キーを押すと、Shift \+ Tab キーボード ショートカットと同じアクションが実行されます。  フォーカスを取得できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが存在する場合は、フォーカスは <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロール外に移動します。  この動作は、最後のコントロールに折り返されないという点で、標準の <xref:System.Windows.Forms.ContainerControl> の動作とは異なります。  他にフォーカスを取得できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが存在しない場合、フォーカスはタブ オーダーの最後の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに戻ります。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールに含まれている最後のコントロールで下方向キーと右方向キーを押すと、Tab キーと同じアクションが実行されます。  フォーカスを取得できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが存在する場合は、フォーカスは <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロール外に移動します。  この動作は、最初のコントロールに折り返されないという点で、標準の <xref:System.Windows.Forms.ContainerControl> の動作とは異なります。  他にフォーカスを取得できる [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールが存在しない場合、フォーカスはタブ オーダーの最初の [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに戻ります。|該当なし。|  
+|アクセラレータ|アクセラレータは、"サポートなし" 列に示されている場合を除き、通常どおり動作します。|テクノロジ間で重複するアクセラレータは、通常の重複するアクセラレータのようには動作しません。  アクセラレータがテクノロジ間で重複する場合、つまり、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールに 1 つ以上、および [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールにも他のアクセラレータがある場合は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールはアクセラレータを常に受け取ります。  重複するアクセラレータ キーが押された場合、フォーカスはコントロール間で切り替わりません。|  
+|ショートカット キー|ショートカット キーは、"サポートなし" 列に示されている場合を除き、通常どおり動作します。|-   事前処理段階で処理される [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ショートカット キーは常に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ショートカット キーよりも優先されます。  たとえば、Ctrl \+ S ショートカット キーが定義されている <xref:System.Windows.Forms.ToolStrip> コントロールがあり、CTRL \+ S にバインドされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コマンドがある場合、フォーカスに関係なく、<xref:System.Windows.Forms.ToolStrip> コントロール ハンドラーが常に最初に呼び出されます。<br />-   <xref:System.Windows.Forms.Control.KeyDown> イベントで処理される [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] ショートカット キーは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で最後に処理されます。  この動作を回避するには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの <xref:System.Windows.Forms.Control.IsInputKey%2A> メソッドをオーバーライドするか、<xref:System.Windows.Forms.Control.PreviewKeyDown> イベントを処理します。  <xref:System.Windows.Forms.Control.IsInputKey%2A> メソッドから `true` を返すか、<xref:System.Windows.Forms.Control.PreviewKeyDown> イベント ハンドラーで <xref:System.Windows.Forms.PreviewKeyDownEventArgs.IsInputKey%2A?displayProperty=fullName> プロパティの値を `true` に設定します。|  
+|AcceptsReturn、AcceptsTab、およびその他のコントロール固有の動作|既定のキーボードの動作を変更するプロパティは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールが <xref:System.Windows.Forms.Control.IsInputKey%2A> メソッドをオーバーライドして `true` を返す場合、通常どおり動作します。|<xref:System.Windows.Forms.Control.KeyDown> イベントで既定のキーボードの動作を変更する [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールは、ホストの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールで最後に処理されます。  これらのコントロールは最後に処理されるため、予期しない動作が発生する場合があります。|  
+|Enter イベントと Leave イベント|含まれている <xref:System.Windows.Forms.Integration.ElementHost> コントロールにフォーカスが移動しない場合に、フォーカスが 1 つの <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールで変更されると、Enter イベントと Leave イベントは通常どおり発生します。|Enter イベントと Leave イベントは、次のフォーカスの変更が行われるまで発生しません。<br /><br /> -   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールの内部から外部への変更。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールの外部から内部への変更。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールの外部での変更。<br />-   <xref:System.Windows.Forms.Integration.WindowsFormsHost> コントロールでホストされている [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールから、同じ <xref:System.Windows.Forms.Integration.WindowsFormsHost> 内でホストされている <xref:System.Windows.Forms.Integration.ElementHost> コントロールへの変更。|  
+|マルチスレッド|あらゆる種類のマルチスレッドがサポートされます。|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の両方のテクノロジでは、シングルスレッドの同時実行モデルを前提にしています。  デバッグ中は、他のスレッドからフレームワーク オブジェクトを呼び出すと例外が発生し、この要件が強制されます。|  
+|セキュリティ|すべての相互運用シナリオには完全な信頼が必要です。|相互運用シナリオは、部分的な信頼ではサポートされません。|  
+|アクセシビリティ|すべてのアクセシビリティ シナリオがサポートされます。  支援技術製品は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の両方のコントロールを含むハイブリッド アプリケーションで使用すると正しく動作します。|該当なし。|  
+|クリップボード|すべてのクリップボードは通常どおり操作できます。  これには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール間の切り取りと貼り付けも含まれます。|該当なし。|  
+|ドラッグ アンド ドロップ機能|すべてのドラッグ アンド ドロップは通常どおり操作できます。  これには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール間の操作も含まれます。|該当なし。|  
+  
+<a name="Windows_Forms_Application_Hosting_Windows"></a>   
+## Windows フォームでの WPF コントロールのホスト  
+ 次の相互運用のシナリオは、[!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] コントロールが [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールをホストする場合にサポートされます。  
+  
+-   コードを使用して 1 つ以上の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールをホストする。  
+  
+-   プロパティ シートを 1 つ以上のホストされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールに関連付ける。  
+  
+-   フォームで 1 つ以上の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページをホストする。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ウィンドウを起動する。  
+  
+-   [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] マスターおよび [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 詳細を使用したマスター\/詳細フォームのホスト。  
+  
+-   [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マスターおよび [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] 詳細を使用したマスター\/詳細フォームのホスト。  
+  
+-   カスタム [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールをホストする。  
+  
+-   ハイブリッド コントロールをホストする。  
+  
+### アンビエント プロパティ  
+ [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールの一部のアンビエント プロパティは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と同等の機能があります。  これらのアンビエント プロパティは、ホストされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールに適用され、<xref:System.Windows.Forms.Integration.ElementHost> コントロールのパブリック プロパティとして公開されます。  <xref:System.Windows.Forms.Integration.ElementHost> コントロールは、各 [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] アンビエント プロパティをその [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の等価プロパティに変換します。  
+  
+ 詳細については、「[Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)」を参照してください。  
+  
+### \[動作\]  
+ 相互運用動作の説明を次の表に示します。  
+  
+|\[動作\]|サポート状況|Not supported|  
+|------------|------------|-------------------|  
+|透過性|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールのレンダリングは透過性をサポートします。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] の親コントロールの背景を、ホストしている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの背景にすることができます。|該当なし。|  
+|マルチスレッド|あらゆる種類のマルチスレッドがサポートされます。|[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の両方のテクノロジでは、シングルスレッドの同時実行モデルを前提にしています。  デバッグ中は、他のスレッドからフレームワーク オブジェクトを呼び出すと例外が発生し、この要件が強制されます。|  
+|セキュリティ|すべての相互運用シナリオには完全な信頼が必要です。|相互運用シナリオは、部分的な信頼ではサポートされません。|  
+|アクセシビリティ|すべてのアクセシビリティ シナリオがサポートされます。  支援技術製品は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の両方のコントロールを含むハイブリッド アプリケーションで使用すると正しく動作します。|該当なし。|  
+|クリップボード|すべてのクリップボードは通常どおり操作できます。  これには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール間の切り取りと貼り付けも含まれます。|該当なし。|  
+|ドラッグ アンド ドロップ機能|すべてのドラッグ アンド ドロップは通常どおり操作できます。  これには、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)] コントロールと [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール間の操作も含まれます。|該当なし。|  
+  
+## 参照  
+ <xref:System.Windows.Forms.Integration.ElementHost>   
+ <xref:System.Windows.Forms.Integration.WindowsFormsHost>   
+ [チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)   
+ [チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)   
+ [チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)   
+ [Windows フォームと WPF プロパティの割り当て](../../../../docs/framework/wpf/advanced/windows-forms-and-wpf-property-mapping.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-architecture.md b/docs/framework/wpf/advanced/wpf-architecture.md
new file mode 100644
index 00000000000..d7f3ce7166c
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-architecture.md
@@ -0,0 +1,183 @@
+---
+title: "WPF アーキテクチャ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アフィニティ スレッド"
+  - "アーキテクチャ"
+  - "添付プロパティ"
+  - "クラス, System.Object"
+  - "クラス, System.Threading.DispatcherObject"
+  - "クラス, System.Windows.Controls.Control"
+  - "クラス, System.Windows.DependencyObject"
+  - "クラス, System.Windows.FrameworkElement"
+  - "クラス, System.Windows.Media.Visual"
+  - "クラス, System.Windows.UIElement"
+  - "CommandBindings"
+  - "コンポーネント, unmanaged"
+  - "Control クラス"
+  - "データ テンプレート"
+  - "DependencyObject クラス"
+  - "DispatcherObject クラス"
+  - "FrameworkElement クラス"
+  - "INotifyPropertyChange インターフェイス"
+  - "インターフェイス, INotifyPropertyChange"
+  - "milcore"
+  - "ペインタ アルゴリズム"
+  - "プロパティ, 添付"
+  - "ストーリーボード"
+  - "System.Object クラス"
+  - "System.Threading.DispatcherObject クラス"
+  - "System.Windows.Controls.Control クラス"
+  - "System.Windows.DependencyObject クラス"
+  - "System.Windows.FrameworkElement クラス"
+  - "System.Windows.Media.Visual クラス"
+  - "System.Windows.UIElement クラス"
+  - "スレッド, アフィニティ"
+  - "UIElement クラス"
+  - "アンマネージ コンポーネント"
+  - "Visual クラス"
+ms.assetid: 8579c10b-76ab-4c52-9691-195ce02333c8
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# WPF アーキテクチャ
+ここでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] のクラス階層について順を追って説明します。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の主要なサブシステムをほぼ網羅し、その相互作用を示すと共に、  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の設計者が下した選択事項についても説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="System_Object"></a>   
+## System.Object  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の主なプログラミング モデルは、マネージ コードを通じて公開されます。  システムのマネージ コンポーネントとアンマネージ コンポーネントの境界をどこに設定するかについて、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の設計初期段階に議論が重ねられました。  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] には、開発の生産性と信頼性を高める多数の機能 \(メモリ管理、エラー処理、共通型システムなど\) が用意されていますが、これによって犠牲になったものもあります。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の主なコンポーネントを下の図に示します。  図の赤い部分 \(PresentationFramework、PresentationCore、および milcore\) は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の主要コード部分です。  このうち、アンマネージ コンポーネントは milcore だけです。  milcore がアンマネージ コードで記述されているのは、[!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] との緊密な統合を実現するためです。  ハードウェア レンダリングおよびソフトウェア レンダリングの効率性を考え、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] での表示はすべて [!INCLUDE[TLA2#tla_dx](../../../../includes/tla2sharptla-dx-md.md)] エンジンによって実行されるようになっています。  メモリと実行の細かい制御も、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] に対する要件の 1 つでした。  milcore の合成エンジンはきわめて高いパフォーマンスを必要としますが、パフォーマンスを確保するために [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] の多くの利点を放棄しなければなりませんでした。  
+  
+ ![.NET Framework 内の WPF の位置。](../../../../docs/framework/wpf/advanced/media/wpf-architect1.png "wpf\_architect1")  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のマネージ部分とアンマネージ部分の間の通信については、後ほどこのトピックで説明します。  マネージ プログラミング モデルの残りの部分について、次に説明します。  
+  
+<a name="System_Threading_DispatcherObject"></a>   
+## System.Threading.DispatcherObject  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のオブジェクトのほとんどは、<xref:System.Windows.Threading.DispatcherObject> から派生しています。このオブジェクトを基本構造として、同時実行とスレッドの処理が行われます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、このディスパッチャーによって実装されるメッセージング システムに基づいています。  このしくみは、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] のメッセージ ポンプとよく似ており、実際に、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のディスパッチャーはスレッド間呼び出しの実行に User32 のメッセージを使用します。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] での同時実行について論じる場合に理解しておく必要のある中心的概念として、ディスパッチャーとスレッド アフィニティの 2 つがあります。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の設計段階で目標としていたのは、シングル スレッド実行、ただしスレッドとの "アフィニティ \(密接な関係\)" を持たないモデルでした。  スレッド アフィニティが生じるのは、コンポーネントが状態情報を保存するために実行スレッドの ID を使用しているときです。  その最も一般的な形態は、スレッド ローカル ストア \(TLS\) を使用した状態保存です。  スレッド アフィニティが存在するということは、1 つの論理実行スレッドを所有する物理スレッドは 1 つだけでなければならないので、メモリ消費量が増加する可能性があります。  最終的に、WPF のスレッド モデルは、スレッド アフィニティのあるシングル スレッド実行方式をとる既存の User32 スレッド モデルとの同期を保った形になりました。  その主な理由は相互運用性で、[!INCLUDE[TLA2#tla_ole2.0](../../../../includes/tla2sharptla-ole2-0-md.md)] のようなシステム、クリップボード、および Internet Explorer はいずれもシングル スレッド アフィニティ \(STA\) 実行を必要とするためです。  
+  
+ オブジェクトで STA スレッドを使用する場合は、スレッド間通信の手段が必要になります。また、正しいスレッドで実行しているかどうかを検証する必要があります。  この役割を担うのがディスパッチャーです。  ディスパッチャーとは、基本的なメッセージ ディスパッチ システムで、優先順位の付けられた複数のキューを備えています。  メッセージの例としては、未加工の入力通知 \(マウスの移動\)、フレームワーク機能 \(レイアウト\)、ユーザー コマンド \(このメソッドの実行\) などが挙げられます。  <xref:System.Windows.Threading.DispatcherObject> から派生させて [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトを作成すると、このオブジェクトは STA 動作を持つことになり、作成時にディスパッチャーへのポインターが与えられます。  
+  
+<a name="System_Windows_DependencyObject"></a>   
+## System.Windows.DependencyObject  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を構築するにあたってのアーキテクチャ面での理念の 1 つに、"メソッドやイベントよりも、なるべくプロパティを使用する" があります。  プロパティは宣言的であり、開発者はアクションではなく意図を容易に指定することができます。  モデル ドリブン、つまりデータ ドリブンでユーザー インターフェイス コンテンツを表示するシステムも、この理念によって支えられています。  この理念の意図は、アプリケーションの動作を詳しく制御できるように、バインド先として指定可能なプロパティの数を増やすことでした。  
+  
+ プロパティで制御できるシステムの範囲を広げるために、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] が提供するプロパティ システムよりも多様なプロパティ システムが求められていました。  この多様性のわかりやすい例として、変更通知が挙げられます。  双方向バインディングを可能にするには、バインドの両側で変更通知がサポートされる必要があります。  動作をプロパティ値と連動させるには、プロパティ値の変更時に通知が送られるようにする必要があります。  [!INCLUDE[TLA#tla_netframewk](../../../../includes/tlasharptla-netframewk-md.md)] の **INotifyPropertyChange** というインターフェイスを使用すると、オブジェクトによる変更通知の発行が可能になります。ただし、これは必須ではありません。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、<xref:System.Windows.DependencyObject> 型から派生した、多機能のプロパティ システムが用意されています。  プロパティ式どうしの依存関係を把握し、依存関係が変化したときにプロパティ値を自動的に再検証するという点で、このプロパティ システムは真の "依存関係" プロパティ システムと言えます。  たとえば、プロパティが継承される場合 \(<xref:System.Windows.Controls.Control.FontSize%2A> など\) は、値を継承する要素の親でそのプロパティが変更されると、プロパティ システムが自動的に更新されます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プロパティ システムの基盤となるのは、プロパティ式の概念です。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の最初のリリースとなる今回のリリースでは、プロパティ式システムは非公開になっており、式はすべてフレームワークの一部として提供されます。  プロパティ システムが式を持つことで、データ バインディング、スタイル設定、継承はハード コーディングされるのではなく、フレームワーク内の後の層で提供されるようになっています。  
+  
+ このプロパティ システムは、プロパティ値のスパース ストレージ \(sparse storage\) にも対応しています。  オブジェクトのプロパティ数が数十個に及ぶこともありますが、その値の大多数は既定の状態 \(継承された状態、スタイルで設定された状態など\) です。定義済みのすべてのプロパティの値をオブジェクトのすべてのインスタンスに持たせることが必要であるとは限りません。  
+  
+ プロパティ システムの新機能として最後に挙げられるのは、[添付プロパティ](GTMT)の概念です。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の要素は、合成とコンポーネント再利用の原則に基づいて構築されています。  他の要素を格納する要素 \(<xref:System.Windows.Controls.Grid> レイアウト要素など\) は、多くの場合、子要素の動作を制御するために子要素に関する追加データ \(行や列の情報など\) を必要とします。  このようなプロパティをすべて個々の要素に関連付ける代わりに、どのオブジェクトも他のオブジェクトのプロパティを定義できるようになっています。  これは、JavaScript の "expando" 機能と似ています。  
+  
+<a name="System_Windows_Media_Visual"></a>   
+## System.Windows.Media.Visual  
+ システムの定義が完了したら、画面にピクセルを描画するための手順に移ります。  <xref:System.Windows.Media.Visual> は、ビジュアル オブジェクト ツリーを構築するためのクラスです。各オブジェクトは、描画命令と、その命令をレンダリングする方法 \(クリッピング、変換など\) に関するメタデータを任意で持つことができます。  <xref:System.Windows.Media.Visual> は、負荷を抑え、柔軟性を持たせるように設計されているので、ほとんどの機能はパブリック [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] を公開しておらず、保護されたコールバック関数に大きく依存します。  
+  
+ <xref:System.Windows.Media.Visual> はまさに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 合成システムへのエントリ ポイントです。  <xref:System.Windows.Media.Visual> が接続ポイントとなって、マネージ [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] とアンマネージ milcore の 2 つのサブシステムが連結されます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、milcore で管理されているアンマネージ データ構造をスキャンすることによってデータを表示します。  この構造 \(合成ノード\) は階層構造の表示ツリーを表し、各ノードにレンダリング命令があります。  このツリー \(次の図の右側に示すツリー\) には、メッセージ プロトコルを介してのみアクセスできます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のプログラミング時には、<xref:System.Windows.Media.Visual> 要素と派生型を作成します。これらの要素と型は、このメッセージ プロトコルを通して合成ツリーとの内部的な通信を行います。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 内の各 <xref:System.Windows.Media.Visual> によって作成される合成ノードは、1 つの場合もあれば、まったくない場合も複数の場合もあります。  
+  
+ ![Windows Presentation Foundation ビジュアル ツリー。](../../../../docs/framework/wpf/advanced/media/wpf-architecture2.png "wpf\_architecture2")  
+  
+ ここで、アーキテクチャの詳細に関して非常に重要な注目点があります。ビジュアルと描画命令のツリー全体がキャッシュされる点です。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、グラフィック用語で言う保持モードのレンダリング システムを使用します。  このため、再描画のリフレッシュ レートを高くしても、ユーザー コードへのコールバックが合成システムによってブロックされることはありません。  これは、アプリケーションが応答しなくなったように見えるという事態の防止に役立ちます。  
+  
+ 図から読み取れることではありませんが、もう 1 つ重要なのは、システムが実際にどのような方法で合成を実行するかという点です。  
+  
+ User32 と [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] において、システムは即時モードのクリッピング システム上で動作します。  コンポーネントのレンダリングが必要になると、システムはクリッピングの境界を設定し、その外側のピクセルにはコンポーネントの影響が及ばないようにしたうえで、そのボックス内にピクセルを描画するようコンポーネントに要求します。  このシステムは、メモリが限られているシステムで非常に有効に機能します。なんらかの変更が発生した場合には、その影響を受けるコンポーネントだけを修正すればよいからです。2 つのコンポーネントが 1 ピクセルの色に寄与することはありません。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、"画家のアルゴリズム \(painter's algorithm\)" 描画モデルを使用します。  これは、各コンポーネントをクリッピングするのではなく、それぞれのコンポーネントに対して画面の奥から手前の順にレンダリングするよう要求するものです。  これにより、各コンポーネントは前のコンポーネントの表示に重ねて描画することができます。  このモデルの利点は、複雑で部分的に透明な図形を描けることです。  User32 や [!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] が作成されたときとは異なり、今日の最新のグラフィックス ハードウェアでは、このモデルは比較的高速に処理されます。  
+  
+ 前述のように、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、より宣言的な "プロパティ中心" のプログラミング モデルへの移行を中心的理念としていました。  ビジュアル システムには、このことが現れている興味深い部分が 2 つあります。  
+  
+ 第 1 に、保持モードのグラフィック システムについて考えてみると、これがまさに命令型の DrawLine\/DrawLine 型モデルからデータ指向モデル new Line\(\)\/new Line\(\) への移行を意味します。  このデータ ドリブン レンダリングへの移行によって、描画命令に関する複雑な操作をプロパティで表現できるようになります。  <xref:System.Windows.Media.Drawing> から派生する型が、事実上、レンダリングのオブジェクト モデルになります。  
+  
+ 第 2 に、アニメーション システムを評価してみると、ほぼ完全に宣言的であることがわかります。  開発者が次の位置や次の色を計算する必要はなく、アニメーション オブジェクトの一連のプロパティとしてアニメーションを表現することができます。  このようなアニメーションは、開発者またはデザイナーの意図 \(このボタンをここからそこへ 5 秒で移動する\) を表すものであり、その意図を実現する最も効率的な方法がシステムによって特定されます。  
+  
+<a name="System_Windows_UIElement"></a>   
+## System.Windows.UIElement  
+ <xref:System.Windows.UIElement> は、レイアウト、入力、イベントなどの中心的なサブシステムを定義します。  
+  
+ レイアウトは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の中心的概念です。  システムの多くは、一連のレイアウト モデルが固定されているか \(HTML ではレイアウトのモデルとしてフロー、絶対、テーブルの 3 つがサポートされます\)、レイアウトのモデルが 1 つもありません \(User32 でサポートされるのは絶対位置指定のみです\)。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、開発者とデザイナーが命令型ロジックではなくプロパティ値で制御できる柔軟で拡張性の高いレイアウト モデルを求めているという前提から出発しています。  <xref:System.Windows.UIElement> のレベルでは、レイアウト用の基本的なコントラクトとして、<xref:System.Windows.UIElement.Measure%2A> パスと <xref:System.Windows.UIElement.Arrange%2A> パスから成る 2 フェーズ モデルが導入されています。  
+  
+ <xref:System.Windows.UIElement.Measure%2A> では、コンポーネントが自らの描画サイズを決定することができます。  このフェーズが <xref:System.Windows.UIElement.Arrange%2A> とは切り離されているのは、親要素が自身の最適な位置とサイズを特定するために、子要素に対してサイズ測定を何度も要求するケースが多々あるためです。  親要素が子要素にサイズ測定を要求するという事実は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のもう 1 つの重要な理念、つまり "コンテンツに合わせたサイズ変更" の現れです。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のコントロールはいずれも、コンテンツの自然なサイズに合わせたサイズ変更機能をサポートしています。  これによってローカライズがはるかに簡単になり、項目のサイズ変更に応じた要素の動的レイアウトが可能になります。  <xref:System.Windows.UIElement.Arrange%2A> フェーズでは、親がそれぞれの子の位置と最終的なサイズを決定することができます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の出力側である <xref:System.Windows.Media.Visual> と関連オブジェクトは取り上げられる頻度が高く、その話題には多くの時間が費やされています。  しかしながら、入力側における革新も同じようにもきわめて大きなものです。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の入力モデルに見られる最も根本的な変化は、システムを通して入力イベントの行き先を決定する一貫したモデルであると言えるでしょう。  
+  
+ 入力は、カーネル モードのデバイス ドライバー上で信号として発生しますが、この信号が正しいプロセスおよびスレッドに届けられるまでには、Windows カーネルと User32 が関与する複雑な複雑なプロセスを通過します。  入力に対応する User32 メッセージが [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] にルーティングされると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の未加工入力メッセージに変換され、ディスパッチャーに送信されます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、未加工入力イベントを複数の実際のイベントに変換できるようになっており、"MouseEnter" のような機能をシステムの低レベルで実装しても確実に配信されます。  
+  
+ それぞれの入力イベントは、少なくとも "プレビュー" イベントと実際のイベントの 2 つのイベントに変換されます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のすべてのイベントに共通する概念として、"要素ツリーを通じたルーティング" があります。  イベントが、ターゲットからツリーのルートまで上位へ向かうものである場合は "バブリング" と言い、ルートからターゲットまで下位に向かうものである場合は "トンネリング" と言います。  入力プレビュー イベントはトンネリングするので、ツリー内の任意の要素でイベントをフィルタリングしたり、イベントに対してアクションを実行したりすることができます。  その後で、通常の \(プレビューでない\) イベントがターゲットからルートへと上向きにバブリングします。  
+  
+ このように、トンネリング フェーズとバブリング フェーズに分けることで、キーボード アクセラレータのような機能の実装を複合環境で一貫性を持って機能させることができます。  User32 でキーボード アクセラレータを実装すると仮定しましょう。それには、サポート対象のアクセラレータ \(Ctrl \+ N から "新規作成" へのマッピング\) をすべて 1 つのグローバル テーブルに格納します。  アプリケーションのディスパッチャーで **TranslateAccelerator** を呼び出して、User32 で入力メッセージをスニッフィングし、登録済みのアクセラレータと一致するものがあるかどうかを判断します。  これは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では機能しません。なぜなら、システムが完全に "合成可能" であり、任意の要素で任意のキーボード アクセラレータを処理および使用できるようになっているためです。  入力にこの 2 フェーズ モデルが採用されているので、コンポーネントは独自の "TranslateAccelerator" を実装することができます。  
+  
+ さらに踏み込んで言うと、<xref:System.Windows.UIElement> にはコマンド バインディングの概念も導入されています。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のコマンド システムでは、開発者がコマンド エンド ポイント \(<xref:System.Windows.Input.ICommand> を実装するもの\) によって機能を定義できるようになっています。  コマンド バインディングとは、入力ジェスチャ \(Ctrl \+ N\) とコマンド \("新規作成"\) の間のマッピングを 1 つの要素で定義することです。  入力ジェスチャとコマンド定義はいずれも拡張可能であり、使用時に結び付けられるようになっています。  これにより、たとえば、特定のアプリケーション内で使用するキー バインディングをエンド ユーザーがカスタマイズできるようにすることも、特別難しい問題ではなくなります。  
+  
+ ここまでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の "中心的" 機能、つまり PresentationCore アセンブリに実装されている機能に焦点を当ててきました。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の構築にあたっては、基礎部分 \(**Measure** と **Arrange** を使用するレイアウト用のコントラクトなど\) とフレームワーク部分 \(<xref:System.Windows.Controls.Grid> のような特定のレイアウトの実装など\) の明確な区別を目指していました。  目標は、スタックの下層に機能拡張ポイントを設け、外部の開発者が必要に応じて独自のフレームワークを作成できるようにすることでした。  
+  
+<a name="System_Windows_FrameworkElement"></a>   
+## System.Windows.FrameworkElement  
+ <xref:System.Windows.FrameworkElement> については 2 つの見方があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の下位層に導入されているサブシステムに対する一連のポリシーとカスタマイズを導入するクラスであり、  一連の新しいサブシステムを導入するクラスでもあります。  
+  
+ <xref:System.Windows.FrameworkElement> によって導入される主なポリシーは、アプリケーション レイアウトに関するものです。  <xref:System.Windows.FrameworkElement> は、<xref:System.Windows.UIElement> によって導入される基本レイアウト コントラクトに基づいて構築され、レイアウト "スロット" の概念が付加されています。この概念によって、レイアウト作成時に、プロパティで制御されるレイアウトのセマンティクスの整合性を取ることが容易になりました。  <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A>、<xref:System.Windows.FrameworkElement.MinWidth%2A>、<xref:System.Windows.FrameworkElement.Margin%2A> を始めとするプロパティによって、<xref:System.Windows.FrameworkElement> から派生したすべてのコンポーネントの、レイアウト コンテナー内での動作が統一されます。  
+  
+ <xref:System.Windows.FrameworkElement> には、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の中心層にある多くの機能に関する [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の公開を容易にする効果もあります。  たとえば、<xref:System.Windows.FrameworkElement> は、<xref:System.Windows.FrameworkElement.BeginStoryboard%2A> メソッドを通じてアニメーションへの直接アクセスを可能にします。  <xref:System.Windows.Media.Animation.Storyboard> を使用すると、一連のプロパティに対して複数のアニメーションのスクリプトを記述できます。  
+  
+ <xref:System.Windows.FrameworkElement> によって導入される機能の中で最も重要なのは、データ バインディングとスタイルの 2 つです。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のデータ バインディング サブシステムは、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]や [!INCLUDE[TLA#tla_aspnet](../../../../includes/tlasharptla-aspnet-md.md)] を使用してアプリケーション [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成したことがあれば比較的理解しやすいはずです。  これらのシステムにはそれぞれ、指定した要素の 1 つ以上のプロパティを特定のデータにバインドする意図を簡単に表現する方法があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、プロパティ バインディング、変換、およびリスト バインディングを完全にサポートしています。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] におけるデータ バインディングの最も興味深い機能の 1 つに、データ テンプレートの導入があります。  データ テンプレートを使用すると、データの視覚的表現を宣言的に指定することができます。  データにバインドできるカスタム ユーザー インターフェイスを作成する代わりに、問題を裏返して考え、作成される画面がデータによって決定されるようにすることができます。  
+  
+ スタイル設定とは、実際にはデータ バインディングを軽量化したものです。  スタイルを使用すると、共有定義の一連のプロパティを要素の 1 つ以上のインスタンスにバインドすることができます。  スタイルは、<xref:System.Windows.FrameworkElement.Style%2A> プロパティを設定することによって明示的に参照して要素に適用することも、要素の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 型にスタイルを関連付けることによって暗黙的に適用することもできます。  
+  
+<a name="System_Windows_Controls_Control"></a>   
+## System.Windows.Controls.Control  
+ Control の最も重要な機能はテンプレートです。  WPF の合成システムを保持モードのレンダリング システムと考えた場合、テンプレートは、コントロールのレンダリング方法をパラメーターとして宣言的な方法で記述できるようにする役割を担います。  <xref:System.Windows.Controls.ControlTemplate> は実のところ、一連の子要素を作成して、コントロールの持つプロパティにバインドさせるスクリプトに過ぎません。  
+  
+ <xref:System.Windows.Controls.Control> には、<xref:System.Windows.Controls.Control.Foreground%2A>、<xref:System.Windows.Controls.Control.Background%2A>、<xref:System.Windows.Controls.Control.Padding%2A> を始めとする一連のストック プロパティがあり、テンプレート作成者はこれを使用してコントロールの表示をカスタマイズすることができます。  コントロールの実装によって、データ モデルと操作モデルが利用可能になります。  操作モデルは、一連のコマンド \(ウィンドウを閉じるコマンドなど\) と入力ジェスチャへのバインディング \(ウィンドウの上隅にある赤い X をクリックするなど\) を定義するものです。  データ モデルは、操作モデルをカスタマイズしたり、テンプレートによって決定される表示をカスタマイズしたりするための一連のプロパティを持ちます。  
+  
+ このようにデータ モデル \(プロパティ\)、操作モデル \(コマンドおよびイベント\)、および表示モデル \(テンプレート\) を分離することで、コントロールの外観と動作全体がカスタマイズ可能になります。  
+  
+ コントロールのデータ モデルの代表的な形態がコンテンツ モデルです。  <xref:System.Windows.Controls.Button> などのコントロールを見てみると、"Content" という名前の <xref:System.Object> 型のプロパティが存在することがわかります。  [!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]と [!INCLUDE[TLA#tla_aspnet](../../../../includes/tlasharptla-aspnet-md.md)] では、一般にこのプロパティは文字列ですが、その結果、ボタンに配置できるコンテンツの型が制限されることになります。  ボタンのコンテンツは、単純な文字列の場合もあれば、複雑なデータ オブジェクトやツリー全体の場合もあります。  データ オブジェクトの場合は、表示の構築にデータ テンプレートが使用されます。  
+  
+<a name="Summary"></a>   
+## 概要  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、動的なデータ ドリブン プレゼンテーション システムを作成できるように設計されています。  システムのどの部分も、動作を制御するプロパティ セットを通じてオブジェクトを作成するように設計されています。  データ バインディングはシステムの基礎となる部分であり、どの層にも統合されています。  
+  
+ 従来のアプリケーションは、表示方法を作成してからデータにバインドしています。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、コントロールに関するすべての事項、表示のあらゆる側面が、なんらかのデータ バインディングによって生成されます。  たとえば、ボタンの内側にテキストを表示するには、コントロールを組み立ててボタンの内側に配置し、表示方法をボタンのコンテンツ プロパティにバインドします。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ベースのアプリケーションの開発を始めてみると、なじみ深さを感じるはずです。  プロパティの設定、オブジェクトの使用、およびデータ バインディングの方法は、[!INCLUDE[TLA#tla_winforms](../../../../includes/tlasharptla-winforms-md.md)]や [!INCLUDE[TLA#tla_aspnet](../../../../includes/tlasharptla-aspnet-md.md)] を使用する場合とほぼ同じです。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のアーキテクチャを詳しく知るにつれて、基本的にデータをアプリケーションの中心的原動力として扱う多機能なアプリケーションを作成できる可能性があることがわかるでしょう。  
+  
+## 参照  
+ <xref:System.Windows.Media.Visual>   
+ <xref:System.Windows.UIElement>   
+ <xref:System.Windows.Input.ICommand>   
+ <xref:System.Windows.FrameworkElement>   
+ <xref:System.Windows.Threading.DispatcherObject>   
+ <xref:System.Windows.Input.CommandBinding>   
+ <xref:System.Windows.Controls.Control>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md b/docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md
new file mode 100644
index 00000000000..c36b089c195
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md
@@ -0,0 +1,315 @@
+---
+title: "WPF のグローバリゼーションおよびローカリゼーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グローバリゼーション, グローバリゼーションの概要"
+  - "ローカリゼーション, ローカリゼーションの概要"
+ms.assetid: 56e5a5c8-6c96-4d19-b8e1-a5be1dc564af
+caps.latest.revision: 39
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# WPF のグローバリゼーションおよびローカリゼーションの概要
+製品を 1 言語だけで作成することは、潜在的な顧客ベースを、65 億の世界人口のごく一部に制限することを意味します。  アプリケーション製品をグローバルな市場に届けようとする場合、最良かつ経済的な方法の 1 つは、費用対効果の高いローカリゼーションです。  
+  
+ ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のグローバリゼーションとローカリゼーションについて説明します。  グローバリゼーションとは、さまざまな場所で実行されるアプリケーションを設計および開発することです。  たとえば、グローバリゼーションは、さまざまなカルチャのユーザーのために、ローカライズされたユーザー インターフェイスと地域データをサポートします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、自動レイアウト、サテライト アセンブリ、ローカリゼーション属性とコメントなどの、グローバル化されたデザイン機能が用意されています。  
+  
+ ローカリゼーションとは、アプリケーションでサポートする特定のカルチャ用のローカライズ バージョンに、アプリケーション リソースを変換することです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でローカライズする場合には、<xref:System.Windows.Markup.Localizer> 名前空間の API を使用します。これらの API により、[LocBaml ツールのサンプル](http://go.microsoft.com/fwlink/?LinkID=160016)のコマンド ライン ツールが機能します。  LocBaml を構築して使用する方法については、「[アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)」を参照してください。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## WPF のグローバリゼーションとローカリゼーションのベスト プラクティス  
+ ここに示す UI 設計とローカリゼーションに関するヒントに従うと、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に組み込まれたグローバリゼーション機能とローカリゼーション機能を最大限に活用できます。  
+  
+### WPF の UI 設計のベスト プラクティス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を設計する場合、これらのベスト プラクティスの実装を考慮してください。  
+  
+-   [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で記述します。[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] はコードで作成しないようにします。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成する場合は、組み込みローカリゼーション API を通じてそれを公開します。  
+  
+-   コンテンツのレイアウト時に、絶対位置と固定サイズを使用しないようにします。代わりに、相対位置と自動サイズ設定を使用します。  
+  
+    -   <xref:System.Windows.Window.SizeToContent%2A> を使用し、幅と高さの設定を `Auto` に維持します。  
+  
+    -   [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のレイアウト時に、<xref:System.Windows.Controls.Canvas> を使用しないようにします。  
+  
+    -   <xref:System.Windows.Controls.Grid> とそのサイズ共有機能を使用します。  
+  
+-   ローカライズされたテキストはより多くのスペースを必要とすることが多いため、余白にスペースを確保しておきます。  余分なスペースがあれば、文字の張り出しに対応できます。  
+  
+-   <xref:System.Windows.Controls.TextBlock> で <xref:System.Windows.Controls.TextBlock.TextWrapping%2A> を有効にして、クリッピングを回避します。  
+  
+-   **xml:lang** 属性を設定します。  この属性は、特定の要素のカルチャと、その子要素について記述します。  このプロパティの値は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のいくつかの機能の動作を変更します。たとえば、ハイフネーション、スペル チェック、数字の置換、複雑な文字の整形、フォントの代替などの動作を変更します。  [XAML における xml:lang の処理](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md) の設定の詳細については、「[WPF のグローバリゼーション](../../../../docs/framework/wpf/advanced/globalization-for-wpf.md)」を参照してください。  
+  
+-   さまざまな言語で使用されるフォントをより良く制御するには、カスタマイズした複合フォントを作成します。  既定では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって Windows\\Fonts ディレクトリの GlobalUserInterface.CompositeFont が使用されます。  
+  
+-   作成するナビゲーション アプリケーションが、右から左の方向にテキストを表示するカルチャにローカライズされる可能性がある場合は、各ページの <xref:System.Windows.FlowDirection> を明示的に設定して、ページが <xref:System.Windows.Navigation.NavigationWindow> の <xref:System.Windows.FlowDirection> を継承しないようにします。  
+  
+-   ブラウザーの外でホストされるスタンドアロンのナビゲーション アプリケーションを作成する場合、初期アプリケーションの <xref:System.Windows.Application.StartupUri%2A> に、ページ \(`<Application StartupUri="NavigationWindow.xaml">` など\) ではなく <xref:System.Windows.Navigation.NavigationWindow> を設定します。  この設計を使用すると、ウィンドウとナビゲーション バーの <xref:System.Windows.FlowDirection> を変更できます。  詳細および例については、[グローバリゼーション ホームページのサンプル](http://go.microsoft.com/fwlink/?LinkID=159990)を参照してください。  
+  
+### WPF のローカリゼーションのベスト プラクティス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションをローカライズする場合、次のベスト プラクティスの実装を考慮してください。  
+  
+-   ローカリゼーション コメントを使用して、ローカライザーに追加のコンテキストを提供します。  
+  
+-   ローカリゼーションを制御するには、要素の <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを選択的に省略するのではなく、ローカリゼーション属性を使用します。  詳細については、「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを追加して確認するには、**msbuild \/t:updateuid** および **\/t:checkuid** を使用します。  開発とローカリゼーション間の変更を追跡するには、<xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを使用します。<xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティは、開発の新しい変更をローカライズする際に役立ちます。  <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを手動で [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] に追加すると、一般に、作業が面倒なうえ正確さに欠けます。  
+  
+    -   ローカリゼーションの開始後は、<xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを編集または変更しないようにします。  
+  
+    -   重複した <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを使用しないようにします \(コピーして貼り付けるコマンドを使用するときはこの点に留意してください\)。  
+  
+    -   AssemblyInfo.\* の `UltimateResourceFallback` 位置を設定して、フォールバックに適した言語を指定します \(たとえば `[assembly: NeutralResourcesLanguage("en-US",   UltimateResourceFallbackLocation.Satellite)]`\)。  
+  
+         プロジェクト ファイルの `<UICulture>` タグを省略して、メイン アセンブリにソース言語を含める場合、`UltimateResourceFallback` 位置にサテライトではなくメイン アセンブリを設定します \(たとえば `[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.MainAssembly)]`\)。  
+  
+<a name="workflow_to_localize"></a>   
+## WPF アプリケーションをローカライズする  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションをローカライズするときには、いくつかのオプションがあります。  たとえば、アプリケーション内のローカライズ可能リソースを [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ファイルにバインドしたり、ローカライズ可能テキストを resx テーブルに格納したり、ローカライザーが [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルを使用したりできます。  ここでは、XAML の BAML 形式を使用したローカリゼーション ワークフローについて説明します。これによって次のような利点が提供されます。  
+  
+-   ビルド後にローカライズできます。  
+  
+-   古いバージョンの XAML の BAML 形式を使用したローカリゼーションで、新しいバージョンの XAML の BAML 形式に更新できるので、開発と同時にローカライズできます。  
+  
+-   XAML の BAML 形式は [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] をコンパイルした形式であるので、元のソース要素とセマンティクスをコンパイル時に検証できます。  
+  
+### ローカリゼーションのビルド プロセス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを開発する場合の、ローカリゼーションのビルド プロセスは次のとおりです。  
+  
+-   開発者が [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを作成し、グローバル化します。  アプリケーションのコンパイル時に、言語に依存しないメイン アセンブリが生成されるように、プロジェクト ファイルで開発者が `<UICulture>en-US</UICulture>` を設定します。このアセンブリには、すべてのローカライズ可能リソースが含まれた、サテライトの .resources.dll ファイルがあります。ローカリゼーション [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] ではメイン アセンブリからの抽出がサポートされるので、必要に応じてソース言語をメイン アセンブリ内に残すこともできます。  
+  
+-   ファイルをビルドにコンパイルすると、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] が XAML の BAML 形式に変換されます。  カルチャに依存しない `MyDialog.exe` ファイルと、カルチャに依存する \(英語の\) `MyDialog.resources.dll` ファイルを、英語圏の顧客にリリースします。  
+  
+### ローカリゼーション ワークフロー  
+ ローカライズされていない `MyDialog.resources.dll` ファイルがビルドされた後、ローカリゼーション プロセスが始まります。  <xref:System.Windows.Markup.Localizer> の下の [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] が使用され、元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 内の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素とプロパティが、XAML の BAML 形式からキーと値のペアとして抽出されます。  ローカライザーは、キーと値のペアを使用して、アプリケーションをローカライズします。  ローカリゼーションの完了後、新しい値から新しい .resource.dll を生成できます。  
+  
+ キーと値のペアにおけるキーは、開発者が元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に配置した `x:Uid` 値です。  これらの `x:Uid` 値を使用すると、ローカリゼーション時に開発者とローカライザーの間で発生する変更を、[!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] で追跡およびマージすることができます。  たとえば、ローカライザーがローカライズを開始した後に開発者が [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を変更した場合、完了したローカリゼーション作業に開発の変更をマージして、失われる変換作業を最小限に抑えることができます。  
+  
+ 次の図に、XAML の BAML 形式に基づく一般的なローカリゼーション ワークフローを示します。  この図では、開発者が英語のアプリケーションを作成しているものとします。  開発者が WPF アプリケーションを作成し、グローバル化します。  開発者は、ビルド時に言語に依存しないメイン アセンブリが生成されるように、プロジェクト ファイルに `<UICulture>en-US</UICulture>` を設定します。このアセンブリには、すべてのローカライズ可能リソースが含まれた、サテライトの .resources.dll があります。  WPF のローカリゼーション API ではメイン アセンブリからの抽出がサポートされるため、必要に応じてソース言語をメイン アセンブリ内に残すこともできます。  ビルド処理が完了すると、XAML は BAML にコンパイルされます。  カルチャに依存しない MyDialog.exe.resources.dll を、英語圏の顧客に出荷します。  
+  
+ ![ローカリゼーション ワークフロー](../../../../docs/framework/wpf/advanced/media/localizationworkflow.png "LocalizationWorkflow")  
+  
+ ![非ローカライズ ワークフロー](../../../../docs/framework/wpf/advanced/media/localizationworkflow2.png "LocalizationWorkflow2")  
+  
+<a name="examples_of_localization"></a>   
+## WPF のローカリゼーションの例  
+ ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションをビルドおよびローカライズする方法の理解に役立つ、ローカライズされたアプリケーションの例を示します。  
+  
+#### \[Run\] ダイアログ ボックスの例  
+ 次の図は、\[Run\] ダイアログ ボックスのサンプルの出力を示します。  
+  
+ **次に示します。**  
+  
+ ![&#91;実行&#93; ダイアログ ボックス](../../../../docs/framework/wpf/advanced/media/rundialogenglish.png "RunDialogEnglish")  
+  
+ **ドイツ語 :**  
+  
+ ![ドイツ語の &#91;Run&#93; ダイアログ ボックス](../../../../docs/framework/wpf/advanced/media/rundialoggerman.png "RunDialogGerman")  
+  
+ **グローバルな \[Run\] ダイアログ ボックスの設計**  
+  
+ この例では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] および [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して、\[Run\] ダイアログ ボックスを作成します。  このダイアログ ボックスは、[!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] の \[スタート\] メニューから使用可能な **\[ファイル名を指定して実行\]** ダイアログ ボックスと同じものです。  
+  
+ グローバルなダイアログ ボックスを作成するためのいくつかの要点を次に示します。  
+  
+ **Automatic Layout**  
+  
+ *次の Window1.xaml の行を見てください。*  
+  
+ `<Window SizeToContent="WidthAndHeight">`  
+  
+ 上記のウィンドウのプロパティでは、ウィンドウのサイズがコンテンツのサイズに合わせて自動的に変更されます。  このプロパティは、ローカリゼーション後にサイズが大きくなるコンテンツが切り捨てられないようにします。また、ローカリゼーション後にコンテンツのサイズが小さくなる場合は、不要なスペースを削除します。  
+  
+ `<Grid x:Uid="Grid_1">`  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ローカリゼーションの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] が正しく機能するためには、<xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティが必要です。  
+  
+ これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ローカリゼーションの [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] によって、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の開発とローカリゼーション間の変更を追跡するために使用されます。  <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを使用すると、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の新しいバージョンを [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の古いローカリゼーションにマージできます。  <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティを追加するには、コマンド シェルで **msbuild \/t:updateuid RunDialog.csproj** を実行します。  <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティの追加には、この方法をお勧めします。一般に、手動で追加すると時間がかかり、正確さにも欠けます。  <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A> プロパティが正しく設定されたことを確認するには、**msbuild \/t:checkuid RunDialog.csproj** を実行します。  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は <xref:System.Windows.Controls.Grid> コントロールを使用して構造化されます。このコントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の自動レイアウトを利用するために役立ちます。  ダイアログ ボックスは、3 行 5 列に分割されています。  どの行と列にも、固定サイズが定義されていません。このため、各セルに配置された [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素は、ローカライズ時のサイズの増加や減少に対応できます。  
+  
+ [!code-xml[GlobalizationRunDialog#GridColumnDef](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlobalizationRunDialog/CS/Window1.xaml#gridcolumndef)]  
+  
+ **\[Open:\]** ラベルと <xref:System.Windows.Controls.ComboBox> が配置されている最初の 2 列は、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 全体の幅の 10%を使用します。  
+  
+ [!code-xml[GlobalizationRunDialog#GridColumnDef2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlobalizationRunDialog/CS/Window1.xaml#gridcolumndef2)]  
+  
+ この例では、<xref:System.Windows.Controls.Grid> のサイズ設定共有機能を使用しています。  最後の 3 列は同じ <xref:System.Windows.Controls.DefinitionBase.SharedSizeGroup%2A> に配置され、この機能を利用しています。  名前から推測できるとおり、このプロパティを使用すると、複数の列で同じサイズを共有できます。  このため、"Browse..." がこれより長い文字列 "Durchsuchen..." にローカライズされた場合、小さい \[OK\] ボタンと極端に大きい \[Durchsuchen...\] ボタンが作成される代わりに、すべてのボタンの幅が広くなります。  
+  
+ **Xml:lang**  
+  
+ `Xml:lang="en-US"`  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のルート要素に配置された [XAML における xml:lang の処理](../../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md)に注目してください。  このプロパティは、指定した要素のカルチャと、その子について記述します。  この値は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のいくつかの機能で使用され、ローカライズ時に適切に変更される必要があります。  この値は、単語のハイフネーションとスペル チェックに使用する言語辞書を変更します。  また、桁の表示と、フォントの代替システムが使用フォントを選択する方法にも影響します。  最後に、このプロパティは、数字の表示方法と、複雑な文字を使用したテキストの整形方法にも影響します。  既定値は "en\-US" です。  
+  
+ **Building a Satellite Resource Assembly**  
+  
+ *次の .csproj の行を見てください。*  
+  
+ `<UICulture>en-US</UICulture>`  
+  
+ `UICulture` 値が追加されています。  これが en\-US などの有効な <xref:System.Globalization.CultureInfo> 値に設定されている場合、プロジェクトのビルドによって、すべてのローカライズ可能リソースが含まれたサテライト アセンブリが生成されます。  
+  
+ `<Resource Include="RunIcon.JPG">`  
+  
+ `<Localizable>False</Localizable>`  
+  
+ `</Resource>`  
+  
+ `RunIcon.JPG` は、すべてのカルチャで同様に表示するため、ローカライズする必要がありません。  サテライト アセンブリに含めるのではなく、言語に依存しないメイン アセンブリ内にこれを残すよう、`Localizable` を `false` に設定します。  すべてのコンパイル不可能なリソースの `Localizable` は、既定で `true` に設定されます。  
+  
+ **\[Run\] ダイアログのローカライズ**  
+  
+ **Parse**  
+  
+ アプリケーションのビルド後、これをローカライズする最初の手順は、ローカライズ可能リソースをサテライト アセンブリから解析することです。  ここでは、[LocBaml ツールのサンプル](http://go.microsoft.com/fwlink/?LinkID=160016)にある、サンプルの LocBaml ツールを使用します。   ただし、LocBaml はサンプル ツールに過ぎず、独自のローカリゼーション プロセスに合ったローカリゼーション ツールの構築を始める支援するためのものです。  LocBaml で **LocBaml \/parse RunDialog.resources.dll \/out:** を実行して解析を行い、RunDialog.resources.dll.CSV ファイルを生成します。  
+  
+ **Localize**  
+  
+ Unicode をサポートする任意の CSV エディターを使用して、このファイルを編集します。  ローカリゼーションのカテゴリが "None" であるすべてのエントリを、フィルターで除外します。  次のエントリが表示されます。  
+  
+||||  
+|-|-|-|  
+|リソース キー|ローカライズのカテゴリ|値|  
+|Button\_1:System.Windows.Controls.Button.$Content|ボタン|\[OK\]|  
+|Button\_2:System.Windows.Controls.Button.$Content|ボタン|\[キャンセル\]|  
+|Button\_3:System.Windows.Controls.Button.$Content|ボタン|Browse...|  
+|ComboBox\_1:System.Windows.Controls.ComboBox.$Content|ComboBox||  
+|TextBlock\_1:System.Windows.Controls.TextBlock.$Content|テキスト|Type the name of a program, folder, document, or Internet resource, and Windows will open it for you.|  
+|TextBlock\_2:System.Windows.Controls.TextBlock.$Content|テキスト|Open:|  
+|Window\_1:System.Windows.Window.Title|Title|\[実行\]|  
+  
+ アプリケーションをドイツ語にローカライズするには、次の変換が必要です。  
+  
+||||  
+|-|-|-|  
+|リソース キー|ローカライズのカテゴリ|値|  
+|Button\_1:System.Windows.Controls.Button.$Content|ボタン|\[OK\]|  
+|Button\_2:System.Windows.Controls.Button.$Content|ボタン|Abbrechen|  
+|Button\_3:System.Windows.Controls.Button.$Content|ボタン|Durchsuchen…|  
+|ComboBox\_1:System.Windows.Controls.ComboBox.$Content|ComboBox||  
+|TextBlock\_1:System.Windows.Controls.TextBlock.$Content|テキスト|Geben Sie den Namen eines Programms, Ordners, Dokuments oder einer Internetresource an.|  
+|TextBlock\_2:System.Windows.Controls.TextBlock.$Content|テキスト|Öffnen:|  
+|Window\_1:System.Windows.Window.Title|Title|\[実行\]|  
+  
+ **Generate**  
+  
+ ローカリゼーションの最後の手順では、新しくローカライズされたサテライト アセンブリを作成します。  これを行うには、次の LocBaml コマンドを使用します。  
+  
+ **LocBaml.exe \/generate RunDialog.resources.dll \/trans:RunDialog.resources.dll.CSV \/out: .  \/cul:de\-DE**  
+  
+ ドイツ語版 [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] では、メイン アセンブリの隣の de\-DE フォルダーにこの resources.dll が配置されている場合、en\-US フォルダー内のリソースの代わりに、このリソースが自動的に読み込まれます。  これをテストするためのドイツ語版の [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] を所有していない場合は、カルチャに、現在使用している [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] のカルチャ \(  en\-US\) を設定し、元の resources.dll を置き換えます。  
+  
+ **Satellite Resource Loading**  
+  
+|MyDialog.exe|en\-US\\MyDialog.resources.dll|de\-DE\\MyDialog.resources.dll|  
+|------------------|------------------------------------|------------------------------------|  
+|コード|元の英語の BAML|ローカライズされた BAML|  
+|カルチャに依存しないリソース|英語のその他のリソース|ドイツ語にローカライズされたその他のリソース|  
+  
+ .NET Framework は、読み込むサテライト リソース アセンブリを、アプリケーションの `Thread.CurrentThread.CurrentUICulture` に基づいて自動的に選択します。  既定では、使用している [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] OS のカルチャです。  つまり、ドイツ語版 [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] を使用している場合は de\-DE\\MyDialog.resources.dll が読み込まれ、英語版 [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] を使用している場合は en\-US\\MyDialog.resources.dll が読み込まれます。  プロジェクトの AssemblyInfo.\* で NeutralResourcesLanguage を指定すると、アプリケーションの最終フォールバック リソースを設定できます。  たとえば、次のように指定するとします。  
+  
+ `[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]`  
+  
+ こうすると、ドイツ語版 Windows で de\-DE\\MyDialog.resources.dll と de\\MyDialog.resources.dll のどちらも使用できない場合に、en\-US\\MyDialog.resources.dll が使用されます。  
+  
+### Microsoft サウジアラビアのホームページ  
+ 次の図は、英語とアラビア語のホームページを示します。  これらのグラフィックスを生成するサンプル全体については、[グローバリゼーション ホームページのサンプル](http://go.microsoft.com/fwlink/?LinkID=159990)を参照してください。  
+  
+ **次に示します。**  
+  
+ ![英語ページ](../../../../docs/framework/wpf/advanced/media/englishhomepage.png "EnglishHomepage")  
+  
+ **アラビア語 :**  
+  
+ ![アラビア語ページ](../../../../docs/framework/wpf/advanced/media/arabichomepage.png "ArabicHomepage")  
+  
+### Microsoft のグローバルなホームページの設計  
+ この Microsoft サウジアラビアの Web サイトのサンプルは、RightToLeft 言語に提供されるグローバリゼーション機能を表しています。  ヘブライ語やアラビア語などの言語は右から左に読むため、多くの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のレイアウトを、英語などの左から右に読む言語の場合とは大幅に変える必要があります。  左から右に読む言語と右から左に読む言語の間では、ローカリゼーションが困難な場合があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、そのようなローカリゼーションをはるかに簡単に行うことができるよう設計されています。  
+  
+ **FlowDirection**  
+  
+ *Homepage.xaml を次に示します。*  
+  
+ [!code-xml[GlobalizationHomepage#Homepage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlobalizationHomepage/CS/Homepage.xaml#homepage)]  
+  
+ <xref:System.Windows.Controls.Page> の <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティに注目してください。  このプロパティを <xref:System.Windows.FlowDirection> に変更すると、<xref:System.Windows.Controls.Page> とその子要素の <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティが変更されます。その結果、この [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のレイアウトが反転し、アラビア語圏のユーザーに適した右から左の表示になります。  任意の要素で <xref:System.Windows.FrameworkElement.FlowDirection%2A> を明示的に指定すると、この継承動作をオーバーライドできます。  <xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティはすべての <xref:System.Windows.FrameworkElement> やドキュメント関連要素で使用でき、暗黙的な値は <xref:System.Windows.FlowDirection> です。  
+  
+ ルートの <xref:System.Windows.FrameworkElement.FlowDirection%2A> を変更すると、背景のグラデーション ブラシも正しく反転します。  
+  
+ **FlowDirection\="LeftToRight"**  
+  
+ ![左から右に読む](../../../../docs/framework/wpf/advanced/media/lefttoright.png "LeftToRight")  
+  
+ **FlowDirection\="RightToLeft"**  
+  
+ ![右から左に読む](../../../../docs/framework/wpf/advanced/media/righttoleft.png "RightToLeft")  
+  
+ **固定サイズのパネルとコントロールの使用を回避する**  
+  
+ Homepage.xaml を調べると、上部の <xref:System.Windows.Controls.DockPanel> の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 全体に対して固定の幅と高さが指定されていることを除けば、他に固定サイズがないことがわかります。  ローカライズ後にソース テキストより長くなったテキストがクリップされるのを回避するため、固定サイズは使用しないようにします。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のパネルとコントロールは、含まれているコンテンツに基づいて自動的にサイズ変更されます。  多くのコントロールは、最小サイズと最大サイズを設定して制御することもできます   \(MinWidth\= "20" など\)。  <xref:System.Windows.Controls.Grid> では、「\*」を使用して相対的な幅と高さを設定したり   \(Width\= "0.25\*" など\)、セル サイズの共有機能を使用したりすることもできます。  
+  
+ **ローカリゼーション コメント**  
+  
+ コンテンツが不明確で変換が困難な場合も少なくありません。  開発者またはデザイナーは、ローカリゼーション コメントを通じて、追加のコンテキストやコメントをローカライザーに提供できます。  たとえば、次の Localization.Comments は "&#124;" 文字の使用方法を説明しています。  
+  
+ [!code-xml[GlobalizationHomepage#LocalizationComment](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlobalizationHomepage/CS/Homepage.xaml#localizationcomment)]  
+  
+ このコメントは TextBlock\_1 のコンテンツと関連付けられ、LocBaml ツール \(「[アプリケーションをローカライズする](../../../../docs/framework/wpf/advanced/how-to-localize-an-application.md)」を参照\) の場合、出力 .csv ファイルの TextBlock\_1 行の 6 列目に表示されます。  
+  
+|||||||  
+|-|-|-|-|-|-|  
+|リソース キー|\[カテゴリ\]|読み取り可能|変更可能|コメント|値|  
+|TextBlock\_1:System.Windows.Controls.TextBlock.$Content|テキスト|TRUE|TRUE|This character is used as a decorative rule.|&#124;|  
+  
+ 任意の要素のコンテンツやプロパティにコメントを配置するには、次の構文を使用します。  
+  
+ [!code-xml[GlobalizationHomepage#LocalizationCommentsProp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GlobalizationHomepage/CS/Homepage.xaml#localizationcommentsprop)]  
+  
+ **ローカリゼーション属性**  
+  
+ ローカライザーが読んだり変更したりできる箇所を、開発者やローカリゼーション マネージャーが制御する必要がある場合も少なくありません。  たとえば、会社名や法的文言をローカライザーに変換させたくない場合もあります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、要素のコンテンツやプロパティの readability、modifiability、および category を設定するための属性が用意されています。これらの属性を独自のローカリゼーション ツールで使用して、要素をロックしたり、非表示にしたり、並べ替えたりできます。  詳細については、「<xref:System.Windows.Localization.Attributes%2A>」を参照してください。  このサンプルでは、LocBaml ツールがこれらの属性の値だけを出力します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のすべてのコントロールには、これらの属性の既定値がありますが、オーバーライドすることもできます。  たとえば、次の例では `TextBlock_1` の既定のローカリゼーション属性をオーバーライドして、ローカライザーがコンテンツを読み取ることはできても変更できないように設定します。  
+  
+ [!code-xml[LocalizationComAtt#LocalizationAttributes](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationComAtt/CSharp/Attributes.xaml#localizationattributes)]  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、readability および modifiability の属性に加えて、UI の一般的なカテゴリの列挙体 \(<xref:System.Windows.LocalizationCategory>\) が用意されており、より多くのコンテキストをローカライザーに提供するために使用できます。  プラットフォーム コントロールに対する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既定のカテゴリも、次のように [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 内でオーバーライドできます。  
+  
+ [!code-xml[LocalizationComAtt#LocalizationAttributesOverridden](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LocalizationComAtt/CSharp/Attributes.xaml#localizationattributesoverridden)]  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で提供される既定のローカリゼーション属性は、コードを使用してもオーバーライドできるため、カスタム コントロールに対する適切な既定値を正しく設定できます。  次に例を示します。  
+  
+ `[Localizability(Readability = Readability.Readable, Modifiability=Modifiability.Unmodifiable, LocalizationCategory.None)]`  
+  
+ `public class CorporateLogo: TextBlock`  
+  
+ `{`  
+  
+ `…`  
+  
+ `..`  
+  
+ `.`  
+  
+ `}`  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で設定されたインスタンスごとの属性は、カスタム コントロールに対してコードで設定された値より優先されます。  属性とコメントの詳細については、「[ローカリゼーション属性とコメント](../../../../docs/framework/wpf/advanced/localization-attributes-and-comments.md)」を参照してください。  
+  
+ **フォントの代替と複合フォント**  
+  
+ 指定されているコード ポイント範囲をサポートしないフォントを指定した場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって Windows\\Fonts ディレクトリの GlobalUserInterface.CompositeFont が使用され、そのコード ポイント範囲をサポートするフォントに自動的に置き換えられます。  複合フォントは、その他のフォントと同様に機能し、要素の FontFamily \(たとえば、  FontFamily\= "Global User Interface"\) を設定することにより明示的に使用できます。  独自の複合フォントを作成し、特定のコード ポイント範囲や言語で使用するフォントを指定することにより、フォントの代替設定を独自に指定することもできます。  
+  
+ 複合フォントの詳細については、<xref:System.Windows.Media.FontFamily> を参照してください。  
+  
+ **Microsoft ホームページのローカライズ**  
+  
+ \[Run\] ダイアログの例と同じ手順に従って、このアプリケーションをローカライズできます。  アラビア語にローカライズされた .csv ファイルについては、[グローバリゼーション ホームページのサンプル](http://go.microsoft.com/fwlink/?LinkID=159990)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-xaml-extensions.md b/docs/framework/wpf/advanced/wpf-xaml-extensions.md
new file mode 100644
index 00000000000..9b4f1b892be
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-xaml-extensions.md
@@ -0,0 +1,36 @@
+---
+title: "WPF XAML 拡張機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "マークアップ拡張機能"
+  - "WPF 名前空間"
+  - "XAML, マークアップ拡張機能"
+ms.assetid: 5e1d60e8-9403-47d0-98e4-b49aec871ee7
+caps.latest.revision: 52
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# WPF XAML 拡張機能
+## このセクションの内容  
+ [バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)  
+ [ColorConvertedBitmap のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/colorconvertedbitmap-markup-extension.md)  
+ [ComponentResourceKey マークアップ拡張機能](../../../../docs/framework/wpf/advanced/componentresourcekey-markup-extension.md)  
+ [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)  
+ [RelativeSource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/relativesource-markupextension.md)  
+ [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)  
+ [TemplateBinding のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md)  
+ [ThemeDictionary のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/themedictionary-markup-extension.md)  
+ [PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md)  
+ [PresentationOptions:Freeze 属性](../../../../docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/wpf-xaml-namescopes.md b/docs/framework/wpf/advanced/wpf-xaml-namescopes.md
new file mode 100644
index 00000000000..1dadfcc8237
--- /dev/null
+++ b/docs/framework/wpf/advanced/wpf-xaml-namescopes.md
@@ -0,0 +1,113 @@
+---
+title: "WPF XAML 名前スコープ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "API, 名前関連"
+  - "クラス, FrameworkContentElement"
+  - "クラス, FrameworkElement"
+  - "クラス, RegisterName"
+  - "FrameworkContentElement クラス"
+  - "FrameworkElement クラス"
+  - "名前関連 API"
+  - "名前スコープ"
+  - "RegisterName クラス"
+  - "スタイル, 名前スコープ"
+  - "テンプレート, 名前スコープ"
+  - "XAML, 名前スコープ"
+ms.assetid: 52bbf4f2-15fc-40d4-837b-bb4c21ead7d4
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# WPF XAML 名前スコープ
+XAML 名前スコープは、XAML で定義されるオブジェクトを識別する概念です。  XAML 名前スコープの名前を使用すると、XAML で定義されたオブジェクトの名前とそれに対応するインスタンスとの関係をオブジェクト ツリーとして確立できます。  通常、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マネージ コードの XAML 名前スコープは、XAML アプリケーションの個々の XAML ページ ルートの読み込み時に作成されます。  プログラミング オブジェクトとしての XAML 名前スコープは、<xref:System.Windows.Markup.INameScope> インターフェイスによって定義され、実際的な <xref:System.Windows.NameScope> クラスによって実装されます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Namescopes_in_Loaded_XAML_Applications"></a>   
+## 読み込まれた XAML アプリケーションにおける名前スコープ  
+ 広義のプログラミングまたはコンピューター サイエンスのコンテキストでは、プログラミングの概念に、オブジェクトへのアクセスに使用できる一意の識別子または名前の原則が含まれる場合がよくあります。  識別子または名前を使用するシステムの場合、名前スコープによって、その名前のオブジェクトが要求されたときにプロセスまたは技法で検索する境界、または識別名の一意性を適用する境界が定義されます。  XAML 名前スコープには、これらの一般原則が当てはまります。  WPF では、XAML 名前スコープは、XAML ページを読み込むときに、そのルート要素上に作成されます。  XAML ページ内で指定した名前は、それぞれ関連する XAML 名前スコープに追加されます。名前はページ ルートから始まります。  
+  
+ WPF XAML では、共通ルート要素である要素 \(<xref:System.Windows.Controls.Page> や <xref:System.Windows.Window> など\) が XAML 名前スコープを常に制御します。  マークアップのページのルート要素が <xref:System.Windows.FrameworkElement> や <xref:System.Windows.FrameworkContentElement> などの要素である場合は、有効な XAML 名前スコープを <xref:System.Windows.Controls.Page> が提供できるように、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサによって <xref:System.Windows.Controls.Page> ルートが暗黙的に追加されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップ内の要素に `Name` 属性または `x:Name` 属性が定義されていない場合でも、WPF ビルド アクションによって XAML 稼働環境の XAML 名前スコープが作成されます。  
+  
+ 1 つの XAML 名前スコープ内で同じ名前を 2 回使用しようとすると、例外が発生します。  分離コードを持ち、コンパイル済みアプリケーションの一部である WPF XAML の場合、この例外は、WPF ビルド アクションによるビルド時、最初のマークアップ コンパイル中にページに対する生成クラスが作成されるときに発生します。  どのビルド アクションによってもマークアップ コンパイルされない XAML では、XAML の読み込み時に XAML 名前スコープの問題に関連する例外が発生することがあります。  XAML デザイナーがデザイン時に XAML 名前スコープの問題を予測できる場合もあります。  
+  
+### ランタイム オブジェクト ツリーへのオブジェクトの追加  
+ XAML が解析されるのは、WPF XAML 名前スコープが作成され、定義される時点です。  XAML が解析されてオブジェクト ツリーが生成された後、そのオブジェクト ツリーにオブジェクトを追加しても、新しいオブジェクトの `Name` または `x:Name` の値によって XAML 名前スコープ内の情報が自動的に更新されることはありません。  XAML の読み込み後にオブジェクトの名前を WPF XAML 名前スコープに追加するには、XAML 名前スコープを定義するオブジェクトの適切な <xref:System.Windows.Markup.INameScope.RegisterName%2A> の実装を呼び出す必要があります。通常、これは XAML ページ ルートです。  名前が登録されていない場合、追加したオブジェクトを <xref:System.Windows.FrameworkElement.FindName%2A> などのメソッドを使用して名前で参照することはできません。また、名前をアニメーションのターゲットとして使用することもできません。  
+  
+ アプリケーション開発者にとって最も一般的なシナリオでは、<xref:System.Windows.FrameworkElement.RegisterName%2A> を使用して、ページの現在のルート上の XAML 名前スコープに名前を登録します。  <xref:System.Windows.FrameworkElement.RegisterName%2A> は、オブジェクトをアニメーションのターゲットとするストーリーボードにとって重要なシナリオの一部です。  詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+ XAML 名前スコープを定義するオブジェクト以外のオブジェクトで <xref:System.Windows.FrameworkElement.RegisterName%2A> を呼び出した場合も、XAML 名前スコープを定義するオブジェクトで <xref:System.Windows.FrameworkElement.RegisterName%2A> を呼び出した場合と同様に、名前は呼び出し元のオブジェクトが保持されている XAML 名前スコープに登録されます。  
+  
+### コードでの XAML 名前スコープ  
+ コードで XAML 名前スコープを作成して使用できます。  API および XAML 名前スコープの作成に関連する概念は、純粋なコードを使用する場合でも同じです。これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の XAML プロセッサが XAML 自体を処理するときにこれらの API と概念を使用するためです。  この概念と API の主な目的は、通常は一部または全体が XAML で定義されるオブジェクト ツリー内で、名前でオブジェクトを検索できるようにすることです。  
+  
+ XAML の読み込みによるのではなくプログラムで作成されるアプリケーションの場合、XAML 名前スコープをサポートするためには、XAML 名前スコープを定義するオブジェクトが <xref:System.Windows.Markup.INameScope> を実装しているか、<xref:System.Windows.FrameworkElement> 派生クラスまたは <xref:System.Windows.FrameworkContentElement> 派生クラスである必要があります。  
+  
+ また、XAML プロセッサによって読み込みおよび処理が行われない要素の場合、既定では、オブジェクトの XAML 名前スコープは作成または初期化されません。  後で名前を登録する予定のオブジェクトに対しては、新しい XAML 名前スコープを明示的に作成する必要があります。  XAML 名前スコープを作成するには、静的な <xref:System.Windows.NameScope.SetNameScope%2A> メソッドを呼び出します。  `dependencyObject` パラメーターとしてそれを所有するオブジェクトを、`value` パラメーターとして新しい <xref:System.Windows.NameScope.%23ctor%2A> コンストラクターの呼び出しを指定します。  
+  
+ <xref:System.Windows.NameScope.SetNameScope%2A> に対する `dependencyObject` として指定したオブジェクトが、<xref:System.Windows.Markup.INameScope> 実装、<xref:System.Windows.FrameworkElement>、または <xref:System.Windows.FrameworkContentElement> のいずれでもない場合、子要素上で <xref:System.Windows.FrameworkElement.RegisterName%2A> を呼び出しても効果はありません。  新しい XAML 名前スコープを明示的に作成しなかった場合、<xref:System.Windows.FrameworkElement.RegisterName%2A> を呼び出すと例外が発生します。  
+  
+ XAML 名前スコープ API をコードで使用する例については、「[名前のスコープを定義する](../../../../docs/framework/wpf/graphics-multimedia/how-to-define-a-name-scope.md)」を参照してください。  
+  
+<a name="Namescopes_in_Styles_and_Templates"></a>   
+## スタイルとテンプレートにおける XAML 名前スコープ  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のスタイルとテンプレートを使用すると、コンテンツを直接再利用および再適用できます。  ただし、スタイルとテンプレートには、テンプレート レベルで定義された XAML 名を持つ要素も含まれている可能性があります。  同一のテンプレートが、ページ内で複数回使用される可能性があります。  このため、スタイルとテンプレートでは両方とも、適用先のオブジェクト ツリー内の場所に依存しない独自の XAML 名前スコープを定義します。  
+  
+ 次に例を示します。  
+  
+ [!code-xml[XamlOvwSupport#NameScopeTemplates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page6.xaml#namescopetemplates)]  
+  
+ ここでは、同一のテンプレートを 2 つの異なるボタンに適用しています。  これらのテンプレートがそれぞれ異なる XAML 名前スコープを持っていない場合、テンプレート内で使用されている `TheBorder` という名前により、XAML 名前スコープで名前の競合が発生することになります。  テンプレートの各インスタンスは独自の XAML 名前スコープを持つため、この例の場合、インスタンス化された各テンプレートの XAML 名前スコープに、名前が必ず 1 つずつ含まれます。  
+  
+ スタイルも独自の XAML 名前スコープを定義します。これは主に、ストーリーボードの各部分に独自の名前が割り当てられるようにするためです。  コントロールのカスタマイズ時にテンプレートを再定義した場合も、これらの名前によって、名前の要素を対象とするコントロール固有の動作が可能となります。  
+  
+ XAML 名前スコープが複数存在するため、テンプレート内の指定要素の検索が、ページ内のテンプレートなしの指定要素の検索よりも困難になります。  まず、テンプレートが適用されたコントロールの <xref:System.Windows.Controls.Control.Template%2A> プロパティ値を取得して、適用されたテンプレートを判断する必要があります。  その後、テンプレート バージョンの <xref:System.Windows.FrameworkTemplate.FindName%2A> を呼び出し、テンプレートが適用されたコントロールを 2 番目のパラメーターとして渡します。  
+  
+ コントロールの作成者が生成している規則で、適用されたテンプレートの特定の指定要素を、コントロール自体によって定義される動作の対象とする場合は、コントロール実装コードから <xref:System.Windows.FrameworkElement.GetTemplateChild%2A> メソッドを使用できます。  <xref:System.Windows.FrameworkElement.GetTemplateChild%2A> メソッドはプロテクトされているため、コントロールの作成者のみがアクセスできます。  
+  
+ テンプレート内での作業中に、テンプレートが適用される XAML 名前スコープを取得する必要がある場合は、<xref:System.Windows.FrameworkElement.TemplatedParent%2A> の値を取得した後、そこで <xref:System.Windows.FrameworkElement.FindName%2A> を呼び出します。  テンプレート内で作業するのは、たとえば、適用したテンプレート内の要素からイベントを発生させるようなイベント ハンドラーを記述する場合です。  
+  
+<a name="Namescopes_and_Name_related_APIs"></a>   
+## XAML 名前スコープと名前関連 API  
+ <xref:System.Windows.FrameworkElement> には、<xref:System.Windows.FrameworkElement.FindName%2A>、<xref:System.Windows.FrameworkElement.RegisterName%2A>、<xref:System.Windows.FrameworkElement.UnregisterName%2A> の各メソッドがあります。  これらのメソッドを呼び出すオブジェクトが XAML 名前スコープを所有している場合、そのメソッドは関連する XAML 名前スコープのメソッドを呼び出します。  それ以外の場合、親要素が XAML 名前スコープを所有しているかどうかが調べられ、XAML 名前スコープが見つかるまでこの処理が再帰的に続行されます \(XAML プロセッサの動作により、ルートには必ず XAML 名前スコープが存在します\)。  <xref:System.Windows.FrameworkContentElement> での動作もこれに類似していますが、いずれの <xref:System.Windows.FrameworkContentElement> も XAML 名前スコープを所有しない点だけが異なります。  <xref:System.Windows.FrameworkContentElement> にもそれらのメソッドが存在するため、呼び出しは、最終的に <xref:System.Windows.FrameworkElement> 親要素まで転送されることができます。  
+  
+ 新しい XAML 名前スコープを既存のオブジェクトに割り当てるには、<xref:System.Windows.NameScope.SetNameScope%2A> を使用します。  XAML 名前スコープをリセットしたり消去したりするために <xref:System.Windows.NameScope.SetNameScope%2A> を複数回呼び出すこともできますが、一般的な使用方法ではありません。  また、通常、<xref:System.Windows.NameScope.GetNameScope%2A> をコードから使用することはありません。  
+  
+### XAML 名前スコープの実装  
+ 次のクラスは、<xref:System.Windows.Markup.INameScope> を直接実装します。  
+  
+-   <xref:System.Windows.NameScope>  
+  
+-   <xref:System.Windows.Style>  
+  
+-   <xref:System.Windows.ResourceDictionary>  
+  
+-   <xref:System.Windows.FrameworkTemplate>  
+  
+ <xref:System.Windows.ResourceDictionary> はディクショナリの実装であるため、XAML 名または名前スコープの代わりにキーを使用します。  <xref:System.Windows.ResourceDictionary> で <xref:System.Windows.Markup.INameScope> を実装する唯一の理由は、ユーザー コードに対して例外を発生可能にして、本当の XAML 名前スコープと <xref:System.Windows.ResourceDictionary> によるキーの処理方法との違いを明確にしたり、XAML 名前スコープが特に親要素によって <xref:System.Windows.ResourceDictionary> に適用されないようにしたりできるためです。  
+  
+ <xref:System.Windows.FrameworkTemplate> および <xref:System.Windows.Style> は、明示的なインターフェイス定義を通じて <xref:System.Windows.Markup.INameScope> を実装します。  明示的に実装すると、<xref:System.Windows.Markup.INameScope> インターフェイスからこれらの XAML 名前スコープにアクセスした場合に、それらが従来どおりに動作します。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内部プロセスは、このアクセス方法を使用して XAML 名前スコープと通信します。  しかし、明示的なインターフェイス定義は、<xref:System.Windows.FrameworkTemplate> と <xref:System.Windows.Style> の通常の API サーフェイスには含まれません。これは、<xref:System.Windows.FrameworkTemplate> や <xref:System.Windows.Style> では、<xref:System.Windows.Markup.INameScope> のメソッドを直接呼び出す必要がほとんどなく、代わりに <xref:System.Windows.FrameworkElement.GetTemplateChild%2A> などの他の API を使用するためです。  
+  
+ 次のクラスは、<xref:System.Windows.NameScope?displayProperty=fullName> ヘルパー クラスを使用し、<xref:System.Windows.NameScope.NameScope%2A?displayProperty=fullName> 添付プロパティからその XAML 名前スコープ実装に接続することにより、独自の XAML 名前スコープを定義します。  
+  
+-   <xref:System.Windows.FrameworkElement>  
+  
+-   <xref:System.Windows.FrameworkContentElement>  
+  
+## 参照  
+ [XAML 名前空間および WPF XAML の名前空間の割り当て](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)   
+ [x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md b/docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md
new file mode 100644
index 00000000000..65dfdd20533
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md
@@ -0,0 +1,127 @@
+---
+title: "WPF における XAML とカスタム クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, カスタム クラス (XAML)"
+  - "カスタム クラス (XAML)"
+  - "XAML, カスタム クラス"
+ms.assetid: e7313137-581e-4a64-8453-d44e15a6164a
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# WPF における XAML とカスタム クラス
+[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] のフレームワークで実装される XAML は [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] の言語のカスタム クラスまたは構造体を定義してXAML マークアップを使用してアクセスすることができます。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] で定義されている型とカスタム型は、通常はカスタム型を XAML 名前空間プレフィックスにマップすることで、同じマークアップ ファイルで使用することができます。  このトピックでは満たすカスタム クラスが XAML 要素として使用する必要があるという要件について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Custom_Classes_in_Applications_vs__in_Assemblies"></a>   
+## アプリケーション内のカスタム クラスとアセンブリ内のカスタム クラス  
+ XAML で使用するカスタム クラスは 2 種類の形でも定義できます : コードとしてビハインドかの主要なアプリケーションを作成 [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 他のコード内またはクラス ライブラリとして使用されている実行可能ファイルまたは DLL などの別のアセンブリのクラス。  これらの方法には、それぞれ利点と欠点があります。  
+  
+-   クラス ライブラリを作成する場合の利点は、それらのカスタム クラスを異なる多くのアプリケーションの間で共有できることです。  別のライブラリはアプリケーションのバージョン管理の問題に制御しやすくなります。の使用を目的の XAML ページ ルート要素として持つクラスの作成が簡単になります。  
+  
+-   カスタム クラスをアプリケーション内で定義する場合の利点は、比較的軽量であることです。メインのアプリケーションの実行可能ファイルとは別のアセンブリを導入する場合に生じる配置やテストの問題を最小限に抑えることができます。  
+  
+-   同じまたは別のアセンブリで定義されてカスタム クラスがCLR 名前空間と XML 名前空間の間の要素としての XAML で使用するために割り当てる必要があるかどうか。  「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照してください。  
+  
+<a name="Requirements_for_a_Custom_Class_as_a_XAML_Element"></a>   
+## XAML 要素としてのカスタム クラスの要件  
+ カスタム クラスをオブジェクト要素としてインスタンス化できるようにするには、次の要件が満たされている必要があります。  
+  
+-   カスタム クラスがパブリックであり、既定の \(パラメーターなしの\) パブリック コンストラクターがサポートされている   \(構造体に関する説明は次のセクションを参照してください\)。  
+  
+-   カスタム クラスが入れ子になっていない。  入れ子になったクラスや、そのクラスの一般的な CLR で使用される構文の "ドット" は、添付プロパティなどの他の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] または XAML の機能に干渉します。  
+  
+ オブジェクト要素構文を使用できるようになると、オブジェクト定義でそのオブジェクトを値の型とする他のパブリック プロパティでプロパティ要素構文を使用できるようにもなります。  これは、オブジェクト要素としてインスタンス化できるようになったオブジェクトは、そのプロパティのプロパティ要素値として設定できるためです。  
+  
+### 構造体  
+ カスタム型を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の XAML で構築されるため常に定義する構造体。これは [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] コンパイラが暗黙的に既定ではすべてのプロパティ値を初期化する構造体の既定のコンストラクターが作成されるためです。  既定のコンストラクターの動作やある構造体におけるオブジェクト要素の使用が望ましくない場合もあります。  その理由は、構造体は値と関数を概念的に一体として入れることを意図しており、このため含まれた値が排他的な解釈を持つ可能性があり、その結果プロパティがまったく設定できない場合が生じるためです。  このような構造体の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の例は <xref:System.Windows.GridLength> です。  一般的にこのような構造体には、異なる解釈や構造体の値のモードを作成する文字列の規則を使って値を属性形式で表示できるようにする型コンバーターを実装します。  この構造体では、コード構築が既定以外のコンストラクターによって行われる場合にも、同じ動作が見られると考えられます。  
+  
+<a name="Requirements_for_Properties_of_a_Custom_Class_as_XAML"></a>   
+## カスタム クラスのプロパティの XAML 属性としての要件  
+ プロパティでは、値の型 \(プリミティブなど\) を参照するか、既定のコンストラクターまたは XAML プロセッサからアクセスできる専用の型コンバーターを持つ型のクラスを使用する必要があります。  CLR における XAML の実装では、XAML プロセッサはそのようなコンバーターを、言語プリミティブのネイティブ サポートを通じて検索するか、またはバッキング型定義の型やメンバーに対する <xref:System.ComponentModel.TypeConverterAttribute> のアプリケーションを通じて検索します。  
+  
+ そのほか、抽象クラス型やインターフェイスを参照することもできます。  抽象クラスやインターフェイスの場合は、そのインターフェイスを実装する実用クラスのインスタンスや、その抽象クラスを派生する型のインスタンスによって、XAML 解析時にプロパティ値が設定されることが想定されます。  
+  
+ プロパティは抽象クラスで宣言できますが、その抽象クラスから派生する実用クラスでしか設定できません。  これは、クラスのオブジェクト要素を作成するには、クラスにパブリックな既定のコンストラクターが必要であるためです。  
+  
+### 型コンバーターによって実現される属性構文  
+ 属性として割り当てられた専用の型コンバーターをクラス レベルで用意すると、適用される型変換によって、その型をインスタンス化する必要がある任意のプロパティで属性構文を使用できるようになります。  型コンバーターを用意しても、その型のオブジェクト要素の使用は有効になりません。オブジェクト要素の使用は、その型の既定のコンストラクターが存在する場合にのみ有効です。  したがって、型コンバーターによって実現されるプロパティは、その型自体でオブジェクト要素構文もサポートされていない限り、一般にプロパティ構文では使用できません。  例外として、プロパティ要素に文字列を含める場合には、プロパティ要素構文を指定できます。  この使用方法は、実際には属性構文の使用方法と本質的に変わらず、属性値で空白の堅牢な処理が必要な場合を除いては一般的ではありません。  文字列を受け取るプロパティ要素の使用方法と、それと同等な属性の使用方法を次の例に示します。  
+  
+ [!code-xml[XamlOvwSupport#GoofyTCPE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#goofytcpe)]  
+  
+ [!code-xml[XamlOvwSupport#GoofyTCPE2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#goofytcpe2)]  
+  
+ 属性構文を使用できますがプロパティ要素構文です <xref:System.Windows.Input.Cursor> の型を使用するさまざまなプロパティ拒否されるオブジェクト要素を含むプロパティの例としてはXAML で。  <xref:System.Windows.Input.Cursor> クラスには専用の型コンバーター <xref:System.Windows.Input.CursorConverter> がありますが、既定のコンストラクターは公開されていません。このため、<xref:System.Windows.FrameworkElement.Cursor%2A> プロパティは、実際の <xref:System.Windows.Input.Cursor> 型は参照型であるにもかかわらず、属性構文でしか設定できません。  
+  
+### プロパティごとの型コンバーター  
+ プロパティ レベルで型コンバーターを宣言することもできます。  これにより、プロパティの型のオブジェクトをインラインでインスタンス化する "ミニ言語" が実現されます。これは、渡される属性の文字列値を <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> 操作の入力として適切な型に基づいて処理することによって行われます。  通常XAML でプロパティを設定できるようにするための唯一の手段として便宜上アクセサーを提供するようにします。  ただし、使用する既存の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 型に既定のコンストラクターも、属性として割り当てられた型コンバーターも用意されていない場合に、属性の型コンバーターを使用することもできます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] API では <xref:System.Globalization.CultureInfo> の型を使用する特定のプロパティです。  この場合[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は.NET Framework の以前のバージョンで使用され<xref:System.Globalization.CultureInfo> の型はXAML のプロパティ値として使用するために必要なコンストラクターまたは型レベルの型変換を直接サポートされていませんでしたアドレスの互換性移行のシナリオを実現するために [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] 既存の <xref:System.Globalization.CultureInfo> の型を使用しています。  
+  
+ XAML を使用するプロパティを公開するときには常に \(コントロールを作成する場合は特に\)、そのプロパティを依存関係プロパティで補足することを強くお勧めします。  これは <xref:System.Windows.DependencyProperty> のサポートを使用することでパフォーマンスを向上できるためXAML プロセッサの [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の既存の実装を使用する場合は特に当てはまります。  依存関係プロパティは、XAML でアクセス可能なプロパティに対して期待されるプロパティ システム機能をそのプロパティのために公開します。  これには、アニメーション、データ バインディング、スタイルのサポートなどの機能が含まれます。  詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」および「[XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)」を参照してください。  
+  
+### 型コンバーターの作成と割り当て  
+ プロパティ型の型変換を提供するためにカスタム <xref:System.ComponentModel.TypeConverter> 派生クラスの作成が必要になることはあります。  XAML の使用をサポートする型コンバーターの派生および作成の手順や、<xref:System.ComponentModel.TypeConverterAttribute> の適用方法については、「[TypeConverters および XAML](../../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)」を参照してください。  
+  
+<a name="Requirements_for_Events_of_a_Custom_Class_as_XAML"></a>   
+## カスタム クラスのイベントの XAML イベント ハンドラー属性構文の要件  
+ イベントを [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントとして使用できるようにするには、既定のコンストラクターをサポートするクラスか、派生クラスでイベントにアクセスできる抽象クラスで、パブリック イベントとして公開する必要があります。  [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントを[ルーティング イベント](GTMT)として便利に使用できるようにするには、明示的な `add` メソッドと `remove` メソッドを実装する必要があります。それらのメソッドは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベント シグネチャのハンドラーを追加および削除し、それらのハンドラーを <xref:System.Windows.UIElement.AddHandler%2A> メソッドと <xref:System.Windows.UIElement.RemoveHandler%2A> メソッドに転送します。  これらのメソッドは、イベントがアタッチされているインスタンスのルーティング イベント ハンドラー ストアのハンドラーを追加または削除します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.UIElement.AddHandler%2A> を使用して直接ルーティング イベントのハンドラーを登録し、[ルーティング イベント](GTMT)を公開する [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントを意図的に定義しないようにすることもできます。  これは通常イベントのハンドラーをアタッチする XAML 属性構文を有効にしてクラスがその型の機能は透過的な XAML ビューを提供するためにお勧めできません。  
+  
+<a name="Collection_Properties"></a>   
+## コレクション プロパティの作成  
+ コレクション型を受け取るプロパティには、コレクションに追加されるオブジェクトを指定できる XAML 構文があります。  この構文には注目すべき機能が 2 つあります。  
+  
+-   コレクション オブジェクトとなるオブジェクトをオブジェクト要素構文で指定する必要はありません。  コレクション型を受け取るプロパティを XAML で指定するたびに、そのコレクション型の存在が暗黙的に示されます。  
+  
+-   マークアップにおけるコレクション プロパティの子要素が処理されると、コレクションのメンバーになります。  通常は、コレクションのメンバーにコードでアクセスするには、`Add` などのリスト\/ディクショナリ メソッドを使用するか、インデクサーを使用します。  ただしXAML  構文はメソッドやインデクサー \(例外をサポートしていません : XAML 2009 はメソッドをサポートできますがXAML 2009 を使用する可能な WPF の使用を制限します ; [XAML 2009 言語機能](../../../../docs/framework/xaml-services/xaml-2009-language-features.md) を参照してください。  コレクションは要素ツリーの構築のためにごく一般的に必要になるため、それらのコレクションを宣言型の XAML で設定するための何らかの方法が必要です。  このため、コレクション プロパティの子要素は、コレクション プロパティ型の値であるコレクションに追加することによって処理されます。  
+  
+ .NET Framework XAML サービス実装しコレクション プロパティを構成します。がWPF XAML プロセッサは次のシグネチャを使用します。  プロパティのプロパティ型で次のいずれかを実装する必要があります。  
+  
+-   <xref:System.Collections.IList> を実装します。  
+  
+-   <xref:System.Collections.IDictionary>、またはこれと同等のジェネリック クラス \(<xref:System.Collections.Generic.IDictionary%602>\) を実装します。  
+  
+-   <xref:System.Array> から派生します \(XAML の配列に関する詳細については[x:Array のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-array-markup-extension.md) を参照してください\)。  
+  
+-   <xref:System.Windows.Markup.IAddChild> \([!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で定義されているインターフェイス\) を実装します。  
+  
+ これらの型はCLR がオブジェクト グラフを作成すると基になるコレクションに項目を追加するためにXAML プロセッサによって使用される `Add` のメソッドを入力します。  
+  
+> [!NOTE]
+>  `Dictionary` の一般的な `List` とインターフェイスは[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] XAML プロセッサによってコレクション検出では \(<xref:System.Collections.Generic.IList%601> と <xref:System.Collections.Generic.IDictionary%602> はサポートされていません。  一方、<xref:System.Collections.Generic.List%601> クラスおよび <xref:System.Collections.Generic.Dictionary%602> クラスを基本クラスとして使用することはできます。それぞれ、<xref:System.Collections.IList> と <xref:System.Collections.IDictionary> を直接実装しているためです。  
+  
+ コレクションを受け取るプロパティを宣言するときには、その型の新しいインスタンスでそのプロパティ値がどのように初期化されるかに注意する必要があります。  プロパティを依存関係プロパティとして実装しない場合は、コレクション型のコンストラクターを呼び出す補足フィールドを使用できます。  プロパティが依存関係プロパティの場合は、そのコレクション プロパティを既定の型コンストラクターの一部として初期化する必要がある可能性があります。  これは、依存関係プロパティはメタデータから既定値を受け取りますが、コレクション プロパティの初期値は、通常、共有された静的コレクションにはしないためです。  包含型のインスタンスごとにコレクション インスタンスが必要です。  詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+ コレクション プロパティにカスタム コレクション型を実装することもできます。  暗黙的なコレクション プロパティとして扱われるため、カスタム コレクション型では既定のコンストラクターを用意する必要はありません。既定のコンストラクターがなくても、XAML で暗黙的に使用できます。  ただし、コレクション型の既定のコンストラクターを用意することもできます。  これを実行することで、  既定のコンストラクターを用意しないと、そのコレクションをオブジェクト要素として明示的に宣言できない場合に役立てることができます。  マークアップ スタイルの問題から明示的なコレクションが好まれることもあります。  また、既定のコンストラクターを用意すると、そのコレクション型をプロパティ値として使用する新しいオブジェクトを作成するときの初期化要件が単純化されます。  
+  
+<a name="XAMLCONtent"></a>   
+## XAML コンテンツ プロパティの宣言  
+ XAML 言語で [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のコンテンツ プロパティの概念を定義します。  オブジェクト構文で使用できる各クラスは、XAML コンテンツ プロパティを 1 つだけ持つことができます。  プロパティをクラスの XAML コンテンツ プロパティとして宣言するには、クラス定義の一部として <xref:System.Windows.Markup.ContentPropertyAttribute> を適用し、  目的の XAML コンテンツ プロパティの名前をその属性の <xref:System.Windows.Markup.ContentPropertyAttribute.Name%2A> として指定します。  プロパティは文字列でない <xref:System.Reflection.PropertyInfo> などのリフレクションの構造体として名前を指定します。  
+  
+ コレクション プロパティを XAML コンテンツ プロパティとして指定することもできます。  この結果、そのプロパティの使用方法で、コレクション オブジェクト要素やプロパティ要素のタグを間にはさまずに、オブジェクト要素に 1 つ以上の子要素を持たせることができます。  それらの要素は XAML コンテンツ プロパティの値として扱われ、対応するコレクション インスタンスに追加されます。  
+  
+ 既存の XAML コンテンツ プロパティはプロパティ型を使用します `Object`。  この場合、XAML コンテンツ プロパティで、<xref:System.String> などのプリミティブ値も、1 つの参照オブジェクト値も受け取ることができます。  このモデルに従う場合は、型の判定や使用できる型の処理をその型で行う必要があります。  <xref:System.Object> コンテンツ タイプは一般に、オブジェクト コンテンツを文字列として追加する単純な手段と \(既定のプレゼンテーションが適用されます\)、既定以外のプレゼンテーションまたは追加データを指定するオブジェクト コンテンツを追加する高度な手段の両方をサポートする場合に使用されます。  
+  
+<a name="Serializing"></a>   
+## XAML のシリアル化  
+ 一部のシナリオではなどのコントロールを作成する場合などXAML  でインスタンス化できるオブジェクト表現も同等の XAML マークアップによってシリアル化できるようにする必要があります。  シリアル化の要件については、ここでは説明しません。  詳細については、「[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)」および「[要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)」を参照してください。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)   
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)   
+ [XAML 読み込みと依存関係プロパティ](../../../../docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-in-wpf.md b/docs/framework/wpf/advanced/xaml-in-wpf.md
new file mode 100644
index 00000000000..a8e2bba231c
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-in-wpf.md
@@ -0,0 +1,52 @@
+---
+title: "WPF の XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Extensible Application Markup Language"
+  - "XAML"
+ms.assetid: 5d858575-a83b-42df-ad3f-047ed2d6e3c8
+caps.latest.revision: 79
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 79
+---
+# WPF の XAML
+[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] は、宣言的アプリケーション プログラミングで使用するマークアップ言語です。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、XAML プロセッサを実装し、XAML の言語サポートを提供します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の型は、XAML 表現に必要な型バッキングを提供できるように実装されます。通常、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのほとんどの UI を XAML マークアップで作成できます。  
+  
+## このセクションの内容  
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)  
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)  
+ [WPF における分離コードと XAML](../../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)  
+ [WPF における XAML とカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)  
+ [マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)  
+ [XAML 名前空間および WPF XAML の名前空間の割り当て](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)  
+ [WPF XAML 名前スコープ](../../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)  
+ [インライン スタイルおよびテンプレート](../../../../docs/framework/wpf/advanced/inline-styles-and-templates.md)  
+ [XAML での空白の処理](../../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)  
+ [TypeConverters および XAML](../../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)  
+ [XML 文字エンティティと XAML](../../../../docs/framework/xaml-services/xml-character-entities-and-xaml.md)  
+ [XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)  
+ [WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)  
+ [マークアップの互換性 \(mc:\) 言語機能](../../../../docs/framework/wpf/advanced/markup-compatibility-mc-language-features.md)  
+  
+## 関連項目  
+ [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+ [基本要素](../../../../docs/framework/wpf/advanced/base-elements.md)  
+ [要素のツリーおよびシリアル化](../../../../docs/framework/wpf/advanced/element-tree-and-serialization.md)  
+ [プロパティ](../../../../docs/framework/wpf/advanced/properties-wpf.md)  
+ [イベント](../../../../docs/framework/wpf/advanced/events-wpf.md)  
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)  
+ [リソース](../../../../docs/framework/wpf/advanced/resources-wpf.md)  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ [スレッド モデル](../../../../docs/framework/wpf/advanced/threading-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md b/docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md
new file mode 100644
index 00000000000..ea67459b32c
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-loading-and-dependency-properties.md
@@ -0,0 +1,55 @@
+---
+title: "XAML 読み込みと依存関係プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム依存関係プロパティ"
+  - "依存関係プロパティ, XAML 読み込みおよび"
+  - "読み込み (XML データを) "
+ms.assetid: 6eea9f4e-45ce-413b-a266-f08238737bf2
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# XAML 読み込みと依存関係プロパティ
+現在の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 実装の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、依存関係プロパティに最初から対応しています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、バイナリ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を読み込むとき、および依存関係プロパティである属性を処理するときに、依存関係プロパティ用のプロパティ システム メソッドを使用します。  この結果、プロパティ ラッパーは実質的に省略されます。  カスタムの依存関係プロパティを実装するときには、この動作を考慮に入れて、プロパティ システム メソッド <xref:System.Windows.DependencyObject.GetValue%2A> および <xref:System.Windows.DependencyObject.SetValue%2A> 以外のコードをプロパティ ラッパーに記述することは避ける必要があります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックは、依存関係プロパティを使用と作成の両面から理解していることと、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」および「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を通読していることを前提としています。  また、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」および「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」も通読している必要があります。  
+  
+<a name="implementation"></a>   
+## WPF XAML ローダーの実装とパフォーマンス  
+ 実装上の理由から、プロパティを依存関係プロパティとして指定して、プロパティ システムの <xref:System.Windows.DependencyObject.SetValue%2A> メソッドを使用して設定する方が、プロパティ ラッパーおよびその setter を使用するよりも、処理の負荷が抑えられます。  その理由は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、マークアップとさまざまな文字列の構造で示された、型とメンバーの関係を把握し、それだけを頼りに、基になるコードのオブジェクト モデル全体を推論する必要があるためです。  
+  
+ 型は xmlns とアセンブリ属性の組み合わせで検索されますが、メンバーの識別、属性として設定された値をどれがサポートするかの判断、およびプロパティ値がどの型をサポートするかの解決は、<xref:System.Reflection.PropertyInfo> によるリフレクションを多用することになります。  任意の型の依存関係プロパティは、プロパティ システムを通じてストレージ テーブルとしてアクセスできます。このため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 実装の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサは、このテーブルを使用します。そして、プロパティ *ABC* を設定するには、依存関係プロパティ識別子 *ABCProperty* を使用して、所属する <xref:System.Windows.DependencyObject.SetValue%2A> 派生型の <xref:System.Windows.DependencyObject> を呼び出す方が効率がよいと推論します。  
+  
+<a name="implications"></a>   
+## カスタム依存関係プロパティでの影響  
+ 現在の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 実装の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサでは、プロパティ設定の動作でラッパーが完全に省略されるため、カスタム依存関係プロパティのラッパーの set の定義には、追加的なロジックを記述しないことが必要です。  追加的なロジックを set の定義に記述した場合、プロパティがコードではなく [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で設定されたときには、ロジックは実行されません。  
+  
+ 同様に、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] プロセッサが [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 処理からプロパティ値を取得するときにも、ラッパーではなく <xref:System.Windows.DependencyObject.GetValue%2A> が使用されます。  したがって、`get` の定義では、<xref:System.Windows.DependencyObject.GetValue%2A> の呼び出し以外に追加的な処理を実装することは避ける必要があります。  
+  
+ 次の例は、依存関係プロパティで推奨される定義方法です。ラッパーを使用して、プロパティ識別子は `public` `static` `readonly` フィールドとして格納し、`get` と `set` の定義には、依存関係プロパティのバッキングを定義するために必要なプロパティ システム メソッド以外のコードは含まれていません。  
+  
+ [!code-csharp[WPFAquariumSln#AGWithWrapper](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAquariumSln/CSharp/WPFAquariumObjects/Class1.cs#agwithwrapper)]
+ [!code-vb[WPFAquariumSln#AGWithWrapper](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAquariumSln/visualbasic/wpfaquariumobjects/class1.vb#agwithwrapper)]  
+  
+## 参照  
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [依存関係プロパティのメタデータ](../../../../docs/framework/wpf/advanced/dependency-property-metadata.md)   
+ [コレクション型依存関係プロパティ](../../../../docs/framework/wpf/advanced/collection-type-dependency-properties.md)   
+ [依存関係プロパティのセキュリティ](../../../../docs/framework/wpf/advanced/dependency-property-security.md)   
+ [DependencyObject の安全なコンストラクター パターン](../../../../docs/framework/wpf/advanced/safe-constructor-patterns-for-dependencyobjects.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md b/docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md
new file mode 100644
index 00000000000..683aa190789
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md
@@ -0,0 +1,146 @@
+---
+title: "XAML 名前空間および WPF XAML の名前空間の割り当て | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ, 割り当て (名前空間を)"
+  - "クラス, 割り当て (名前空間を)"
+  - "カスタム クラス, 割り当て (名前空間を)"
+  - "割り当て (名前空間を)"
+  - "名前空間の割り当て"
+  - "名前空間"
+  - "XAML, 名前空間の割り当て"
+  - "XAML, 名前空間"
+ms.assetid: 5c0854e3-7470-435d-9fe2-93eec9d3634e
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# XAML 名前空間および WPF XAML の名前空間の割り当て
+ここでは、WPF XAML ファイルのルート タグに含まれることがよくある 2 つの XAML 名前空間の割り当ての存在と目的について説明します。  また、独自のコードや個別のアセンブリ内で定義されている要素を使用するために同様の割り当てを生成する方法についても説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## XAML 名前空間とは  
+ XAML 名前空間は、XML 名前空間の概念を拡張したものです。  XAML 名前空間を指定する技法は、XML 名前空間の構文、名前空間識別子として URI を使用する規則、同じマークアップ ソースの複数の名前空間を参照する手段を提供するためのプレフィックスの使用などに依存します。  XAML 定義に追加された XML 名前空間の主な概念は、XAML 名前空間が、マークアップの使用に関する一意性の範囲を示すだけでなく、マークアップ エンティティが特定の CLR 名前空間と参照アセンブリによってどのようにサポートされる可能性があるかに影響を与えるということです。  後者の考慮事項は、XAML スキーマ コンテキストの概念の影響も受けます。  WPF が XAML 名前空間で機能する方法の目的を除けば、一般に、XAML 名前空間は、既定の XAML 名前空間、XAML 言語の名前空間、および XAML マークアップによって直接特定のバッキング CLR 名前空間と参照アセンブリに割り当てられるその他の XAML 名前空間として考えることができます。  
+  
+<a name="The_WPF_and_XAML_Namespace_Declarations"></a>   
+## WPF および XAML 名前空間宣言  
+ 多くの XAML ファイルのルート タグの名前空間宣言内には、通常 2 つの XML 名前空間宣言が含まれています。  最初の宣言では、次のように WPF クライアント\/フレームワークの XAML 名前空間全体を既定として割り当てます。  
+  
+ `xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"`  
+  
+ 2 番目の宣言は、個別の XAML 名前空間を割り当てます \(通常は、`x:` プレフィックスに割り当てます\)。  
+  
+ `xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`  
+  
+ これらの宣言の関係は、`x:` プレフィックスの割り当てによって XAML 言語定義の一部である組み込みをサポートし、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は XAML を言語として使用する 1 つの実装として、そのオブジェクトの XAML での語彙を定義するという位置付けになります。  WPF 語彙の使用は XAML 組み込みの使用に比べてはるかに一般的であるため、WPF 語彙が既定として割り当てられます。  
+  
+ XAML 言語組み込みのサポートを `x:` プレフィックスに割り当てる規則は、プロジェクト テンプレート、サンプル コード、およびこの [!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] 内の言語機能のドキュメントに適用されます。  XAML 名前空間は、基本的な WPF アプリケーションにも必要な一般的に使用されるさまざまな機能を定義します。  たとえば、部分クラスを使用して分離コードを XAML ファイルに結合するには、そのクラスの名前を、関連する XAML ファイルのルート要素の `x:Class` 属性として指定する必要があります。  または、アクセスする XAML ページでキーを持つリソースとして定義されている要素では、`x:Key` 属性を設定する必要があります。  XAML のこれらの面およびその他の面の詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」または「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+<a name="Mapping_To_Custom_Classes_and_Assemblies"></a>   
+## カスタム クラスおよびアセンブリへの割り当て  
+ 標準の WPF 名前空間と XAML 組み込み XAML 名前空間をプレフィックスに割り当てる場合と同じ方法で、`xmlns` プレフィックス宣言内の一連のトークンを使用して XML 名前空間をアセンブリに割り当てることができます。  
+  
+ 構文には、次の名前のトークンおよび値を指定できます。  
+  
+ `clr-namespace:` 要素として公開するパブリック型を含むアセンブリ内で宣言される CLR 名前空間。  
+  
+ `assembly=` : 参照される [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 名前空間の一部またはすべてを含むアセンブリ。  通常、この値にはパスではなくアセンブリの名前のみを設定し、拡張子 \(.dll、.exe など\) は含めません。  そのアセンブリへのパスは、割り当てる XAML が格納されたプロジェクト ファイルのプロジェクト参照として確立される必要があります。  バージョン管理および厳密な名前の署名を組み込むために、`assembly` 値を、単純な文字列名ではなく <xref:System.Reflection.AssemblyName> によって定義されている文字列にすることもできます。  
+  
+ `clr-namespace` トークンとその値を区切る文字はコロン \(:\) ですが、`assembly` トークンとその値を区切る文字は等号 \(\=\) であることに注意してください。  これら 2 つのトークン間で使用する文字は、セミコロンです。  さらに、宣言内で空白は使用しないでください。  
+  
+### 基本的なカスタム マッピングの例  
+ 次のコードは、サンプルのカスタム クラスを定義しています。  
+  
+```csharp  
+namespace SDKSample {  
+    public class ExampleClass : ContentControl {  
+        public ExampleClass() {  
+        ...  
+        }  
+    }  
+}  
+```  
+  
+```vb  
+Namespace SDKSample  
+    Public Class ExampleClass  
+        Inherits ContentControl  
+         ...  
+        Public Sub New()  
+        End Sub  
+    End Class  
+End Namespace  
+```  
+  
+ 次に、このカスタム クラスをライブラリにコンパイルすると、プロジェクト設定 \(この例には示されていません\) は `SDKSampleLibrary` という名前になります。  
+  
+ このカスタム クラスを参照するには、現在のプロジェクトの参照としてこれを含める必要があります。通常、これを行うには Visual Studio のソリューション エクスプローラー UI を使用します。  
+  
+ これで、クラスが含まれたライブラリおよびプロジェクト設定内のそれへの参照が作成され、XAML のルート要素の一部として次のプレフィックス割り当てを追加できます。  
+  
+ `xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary"`  
+  
+ すべてをまとめると、ルート タグの通常の既定の割り当ておよび x: 割り当てに加え、カスタム マッピングが含まれた次の XAML になります。この後、プレフィックス付きの参照を使用してその UI の `ExampleClass` をインスタンス化します。  
+  
+```xaml  
+<Page x:Class="WPFApplication1.MainPage"  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"   
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    xmlns:custom="clr-namespace:SDKSample;assembly=SDKSampleLibrary">  
+  ...  
+  <custom:ExampleClass/>  
+...  
+</Page>  
+```  
+  
+### 現在のアセンブリへの割り当て  
+ `assembly` は、参照される `clr-namespace` がカスタム クラスを参照しているアプリケーション コードと同じアセンブリ内で定義されている場合は省略できます。  または、等号の後に文字列トークンを設定せずに `assembly=` を指定すると、前述の場合と等価の構文になります。  
+  
+ 同じアセンブリで定義されているカスタム クラスをページのルート要素として使用することはできません。  部分クラスを割り当てる必要はありません。XAML でクラスを要素として参照する場合、アプリケーションのページの部分クラスではないクラスのみを割り当てる必要があります。  
+  
+<a name="Mapping_CLR_Namespaces_to_XML_Namespaces_in_an"></a>   
+## アセンブリ内の XML 名前空間への CLR 名前空間の割り当て  
+ WPF は、複数の CLR 名前空間を単一の XAML 名前空間に割り当てるために、XAML プロセッサが使用する CLR 属性を定義します。  この属性 <xref:System.Windows.Markup.XmlnsDefinitionAttribute> は、アセンブリを生成するソース コードのアセンブリ レベルに配置されます。  WPF アセンブリ ソース コードでは、この属性を使用して、<xref:System.Windows> や <xref:System.Windows.Controls> などの一般的な各種名前空間が [!INCLUDE[TLA#tla_wpfxmlnsv1](../../../../includes/tlasharptla-wpfxmlnsv1-md.md)] 名前空間に割り当てられます。  
+  
+ <xref:System.Windows.Markup.XmlnsDefinitionAttribute> には、XML\/XAML 名前空間名および CLR 名前空間名の 2 つのパラメーターがあります。  複数の <xref:System.Windows.Markup.XmlnsDefinitionAttribute> を使用して、複数の CLR 名前空間を同じ XML 名前空間に割り当てることができます。  必要に応じて、部分クラスの分離コード ページで適切な `using` ステートメントを指定することによって、割り当てられた名前空間のメンバーを完全修飾せずに参照することもできます。  詳細については、「<xref:System.Windows.Markup.XmlnsDefinitionAttribute>」を参照してください。  
+  
+## デザイナー名前空間および XAML テンプレートの他のプレフィックス  
+ WPF XAML 用の開発環境やデザイン ツールを使用して作業している場合、XAML マークアップ内に他の定義済みの XAML 名前空間やプレフィックスが存在することがわかります。  
+  
+ [!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] では、通常 `d:` というプレフィックスに割り当てられるデザイナー名前空間が使用されます。  WPF 用の最近のプロジェクト テンプレートでは、[!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] と他のデザイン環境間で XAML を交換できるように、この XAML 名前空間が事前に割り当てられています。  このデザインの XAML 名前空間は、デザイナーで XAML ベースの UI をラウンド トリップするときにデザイン状態を永続化するために使用されます。  また、デザイナーでランタイム データ ソースを有効にする `d:IsDataSource` などの機能にも使用されます。  
+  
+ 割り当てることがある別のプレフィックスは、`mc:` です。  `mc:` はマークアップ互換性のために用意され、必ずしも XAML 固有ではないマークアップ互換性パターンを使用しています。  マークアップ互換性機能は、複数のフレームワーク間で、またはバッキング実装の他の境界にまたがって、XAML を交換するために使用したり、複数の XAML スキーマ コンテキスト間で機能したり、デザイナーの制限されたモードに互換性を提供したりすることができます。  マークアップ互換性の概念、およびその概念が WPF にどのように関係するかについては、「[マークアップの互換性 \(mc:\) 言語機能](../../../../docs/framework/wpf/advanced/markup-compatibility-mc-language-features.md)」を参照してください。  
+  
+## WPF およびアセンブリの読み込み  
+ WPF の XAML スキーマ コンテキストは WPF アプリケーション モデルと統合されて、CLR で定義された <xref:System.AppDomain> の概念を使用します。  次の手順は、XAML スキーマ コンテキストが、WPF における <xref:System.AppDomain> およびその他の要素の使用に基づいて、実行時またはデザイン時にどのようにアセンブリの読み込みまたは型の検索を行うかについて解釈する方法を示しています。  
+  
+1.  <xref:System.AppDomain> を反復処理して、名前のすべての要素が一致する読み込み済みのアセンブリを、最も新しく読み込まれたアセンブリから順に検索します。  
+  
+2.  名前が修飾されている場合は、修飾名で <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+3.  短い名前に修飾名の公開キー トークンを加えたものが、マークアップの読み込み元であるアセンブリに一致する場合は、そのアセンブリを返します。  
+  
+4.  短い名前と公開キー トークンを使用して、<xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+5.  名前が修飾されていない場合は、<xref:System.Reflection.Assembly.LoadWithPartialName%2A?displayProperty=fullName> を呼び出します。  
+  
+ Loose XAML の場合は、読み込み元のアセンブリがないので手順 3. は適用されません。  
+  
+ WPF 向けにコンパイルされた XAML \(XamlBuildTask を使用して生成\) の場合は、<xref:System.AppDomain> からの読み込み済みアセンブリ \(手順 1.\) を使用しません。  また、XamlBuildTask 出力からの名前が修飾されないことはありません。したがって、手順 5. は適用されません。  
+  
+ BAML では修飾なしのアセンブリ名は含まれませんが、コンパイルされた BAML \(PresentationBuildTask を使用して生成\) の場合はすべての手順が適用されます。  
+  
+## 参照  
+ [XML 名前空間入門](http://go.microsoft.com/fwlink/?LinkId=98069)   
+ [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-overview-wpf.md b/docs/framework/wpf/advanced/xaml-overview-wpf.md
new file mode 100644
index 00000000000..67409aebf4f
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-overview-wpf.md
@@ -0,0 +1,340 @@
+---
+title: "XAML の概要 (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "属性構文 [XAML]"
+  - "基本クラス [XAML]"
+  - "クラス [XAML]"
+  - "分離コード ファイル [WPF], XAML"
+  - "コレクション プロパティ [XAML]"
+  - "コンテンツ モデル [XAML]"
+  - "イベント [XAML]"
+  - "Extensible Application Markup Language ("XAML" を参照)"
+  - "プロパティ要素 [XAML]"
+  - "ルート要素 [XAML]"
+  - "ルーティング イベント"
+  - "ユーザー インターフェイス [XAML]"
+  - "XAML [WPF], 概要 (XAML の)"
+ms.assetid: a80db4cd-dd0f-479f-a45f-3740017c22e4
+caps.latest.revision: 57
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 50
+---
+# XAML の概要 (WPF)
+ここでは、XAML 言語の機能と、XAML を使用して実際に [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションを記述する方法について説明します。  ここで説明する XAML は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって実装されている XAML です。  XAML 自体は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] よりも大きい言語概念です。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="what_is_xaml"></a>   
+## XAML とは  
+ XAML は、宣言型マークアップ言語です。  XAML を [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] プログラミング モデルに適用すると、[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の作成が簡単になります。  表示される [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を宣言的 XAML マークアップで作成し、分離コード ファイルを使用して [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 定義をランタイム ロジックから分離させることができます。分離コード ファイルは部分クラス定義を通じてマークアップに結合されます。  XAML では、アセンブリで定義されている一連のバッキング型のオブジェクトのインスタンス化が直接表現されます。これは、他のほとんどのマークアップ言語 \(一般に、このようにバッキング型システムと直接関連付けられていない解釈される言語\) とは異なります。  XAML により、アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] とロジックの作業を別々の作業者が \(場合によっては別々のツールを使用して\) 行うことができるワークフローが実現されます。  
+  
+ テキストとして表現された場合の XAML ファイルは XML ファイルで、拡張子は通常 `.xaml` です。  ファイルは任意の XML エンコーディングでエンコードできますが、UTF\-8 としてエンコードするのが一般的です。  
+  
+ 次の例は、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の一部としてボタンを作成する方法を示しています。  この例は、一般的な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] プログラミング要素が XAML でどのように表現されるのかを大まかに示すためのものであり、完全なサンプルではありません。  
+  
+ [!code-xml[XAMLOvwSupport#DirtSimple](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page2.xaml#dirtsimple)]  
+  
+<a name="xaml_syntax_in_brief"></a>   
+## XAML 構文の概要  
+ ここでは、XAML 構文の基本的な形式について説明し、短いマークアップの例を紹介します。  各構文形式に関する詳細な説明 \(それらがバッキング型システムでどのように表現されるかなど\) は含まれません。  ここで紹介する各形式の XAML 構文の詳細については、「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+ 既に XML 言語に精通している方にとって、以降のセクションで説明する内容はほとんどが初歩的なものです。  これは、XAML の基本的な設計原則の 1 つに従った結果です。  XAML 言語ではそれ自体の概念が定義されますが、これらの概念は XML 言語およびマークアップ形式内で機能します。  
+  
+### XAML オブジェクト要素  
+ 通常、オブジェクト要素は型のインスタンスを宣言します。  その型は、XAML を言語として使用するテクノロジにバッキング型を提供するアセンブリで定義されています。  
+  
+ オブジェクト要素構文は常に左山かっこ \(\<\) で始まります。  次に、インスタンスを作成する型の名前を指定します   \(名前にプレフィックスを含めることもできます。プレフィックスについては後で説明します\)。その後に、オブジェクト要素の属性を宣言することもできます。  オブジェクト要素タグを完成させるには、右山かっこ \(\>\) でタグを閉じます。  コンテンツを含まない自己終了形式を使用することもできます。その場合は、タグを閉じるときにスラッシュと右山かっこを続けて入力します \(\/\>\)。  例として、先ほどのマークアップ スニペットをもう一度示します。  
+  
+ [!code-xml[XAMLOvwSupport#DirtSimple](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page2.xaml#dirtsimple)]  
+  
+ ここでは、`<StackPanel>` \(コンテンツが含まれ、その後に終了タグがあります\) と `<Button .../>` \(自己終了形式。いくつかの属性が含まれています\) という 2 つのオブジェクト要素が指定されています。  `StackPanel` と `Button` というオブジェクト要素は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] によって定義されているクラスの名前にそれぞれマッピングされます。これらのクラスは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アセンブリの一部になっています。  オブジェクト要素タグを指定すると、XAML 処理に対する命令が作成されて、新しいインスタンスが作成されます。  各インスタンスは、XAML が解析されて読み込まれるときに、基になる型の既定のコンストラクターを呼び出して作成されます。  
+  
+### 属性構文 \(プロパティ\)  
+ オブジェクトのプロパティは、多くの場合、オブジェクト要素の属性として表現できます。  属性構文では、属性構文で設定するプロパティの名前を指定し、代入演算子 \(\=\) をはさんで、  属性の値を指定します。値は常に、引用符で囲まれた文字列として指定されます。  
+  
+ 属性構文は最も簡潔なプロパティ設定構文であり、マークアップ言語を使用した経験がある開発者が最も直感的に使用できるのがこの構文です。  たとえば、次のマークアップは、赤いテキストと青い背景を持つボタンを作成します。このボタンには、`Content` として指定された表示テキストも含まれます。  
+  
+ [!code-xml[XAMLOvwSupport#BlueRedButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#blueredbutton)]  
+  
+### プロパティ要素の構文  
+ オブジェクト要素のプロパティには、プロパティ値を指定するために必要なオブジェクトや情報を引用符で囲んで適切に表現できないため、および属性構文の文字列の制限があるため、属性構文を使用できないものもあります。  そのような場合は、プロパティ要素構文と呼ばれる別の構文を使用できます。  
+  
+ プロパティ要素の開始タグの構文は、`<`*typeName*`.`*propertyName*`>` です。  このタグのコンテンツには、一般に、そのプロパティが値として受け取る型のオブジェクト要素を指定します。  コンテンツを指定した後は、終了タグを使用してプロパティ要素を終了する必要があります。  終了タグの構文は、`</`*typeName*`.`*propertyName*`>` です。  
+  
+ 属性構文を使用できる場合は、通常、属性構文を使用した方が便利で、マークアップもよりコンパクトになります。ただし、多くの場合、これは単なるスタイルの問題であり、技術的な制限ではありません。  次の例では、前の属性構文の例で設定したのと同じプロパティを設定しています。ただし、ここでは、`Button` のすべてのプロパティに対してプロパティ要素構文を使用しています。  
+  
+ [!code-xml[XAMLOvwSupport#BlueRedButtonPE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#blueredbuttonpe)]  
+  
+### コレクションの構文  
+ XAML 言語には、人が判読しやすいマークアップを生成するいくつかの最適化機能が盛り込まれています。  そのような最適化の 1 つは、特定のプロパティがコレクション型を受け取る場合、そのプロパティの値内の子要素としてマークアップで宣言する項目がそのコレクションの一部になるということです。  この場合、一連の子オブジェクト要素が、そのコレクション プロパティに設定される値になります。  
+  
+ 次の例は、<xref:System.Windows.Media.GradientBrush.GradientStops%2A> プロパティの値を設定するコレクション構文の例を示しています。  
+  
+```xaml  
+<LinearGradientBrush>  
+  <LinearGradientBrush.GradientStops>  
+    <!-- no explicit new GradientStopCollection, parser knows how to find or create -->  
+    <GradientStop Offset="0.0" Color="Red" />  
+    <GradientStop Offset="1.0" Color="Blue" />  
+  </LinearGradientBrush.GradientStops>  
+</LinearGradientBrush>  
+```  
+  
+### XAML コンテンツ プロパティ  
+ XAML で規定されている言語機能として、クラスでそのプロパティのうちの 1 つだけを XAML コンテンツ プロパティとして指定できます。  コンテンツ プロパティの値は、そのオブジェクト要素の子要素を使用して設定されます。  つまり、コンテンツ プロパティのみについては、XAML マークアップでそのプロパティを設定するときにプロパティ要素を省略し、よりわかりやすい親\/子メタファをマークアップに生成できます。  
+  
+ たとえば、<xref:System.Windows.Controls.Border> では <xref:System.Windows.Controls.Decorator.Child%2A> がコンテンツ プロパティとして指定されています。  次の 2 つの <xref:System.Windows.Controls.Border> 要素は同じように扱われます。  1 つ目の例では、コンテンツ プロパティ構文を利用して `Border.Child` プロパティ要素を省略しています。  2 つ目の例では、`Border.Child` が明示的に指定されています。  
+  
+```xaml  
+<Border>  
+  <TextBox Width="300"/>  
+</Border>  
+<!--explicit equivalent-->  
+<Border>  
+  <Border.Child>  
+    <TextBox Width="300"/>  
+  </Border.Child>  
+</Border>  
+```  
+  
+ XAML 言語の規則として、XAML コンテンツ プロパティの値は、そのオブジェクト要素の他のすべてのプロパティ要素の前または後に指定する必要があります。  たとえば、次のマークアップはコンパイルされません。  
+  
+```  
+<Button>I am a   
+  <Button.Background>Blue</Button.Background>  
+  blue button</Button>  
+```  
+  
+ この XAML コンテンツ プロパティの制限の詳細については、「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」の「XAML コンテンツ プロパティ」を参照してください。  
+  
+### テキスト コンテンツ  
+ 一部の XAML 要素では、テキストをコンテンツとして直接処理できます。  これが有効になるのは、次のいずれかの状況に当てはまる場合です。  
+  
+-   クラスでコンテンツ プロパティが宣言されていて、そのコンテンツ プロパティの型が文字列に代入可能な型 \(<xref:System.Object> など\) である。  たとえば、すべての <xref:System.Windows.Controls.ContentControl> は、<xref:System.Object> 型の <xref:System.Windows.Controls.ContentControl.Content%2A> をコンテンツ プロパティとして使用します。この場合、実際の <xref:System.Windows.Controls.ContentControl> \(<xref:System.Windows.Controls.Button> など\) で `<Button>Hello</Button>` という使用方法がサポートされます。  
+  
+-   型で型コンバーターが宣言されている。この場合は、テキスト コンテンツがその型コンバーターの初期化テキストとして使用されます   たとえば、`<Brush>Blue</Brush>` のようにします。  このケースは、実際にはあまり見られません。  
+  
+-   型が既知の XAML 言語プリミティブである。  
+  
+### コンテンツ プロパティとコレクション構文の組み合わせ  
+ 次の例について考えます。  
+  
+```xaml  
+<StackPanel>  
+  <Button>First Button</Button>  
+  <Button>Second Button</Button>  
+</StackPanel>  
+```  
+  
+ ここで、各 <xref:System.Windows.Controls.Button> は <xref:System.Windows.Controls.StackPanel> の子要素です。  この簡略化された直観的なマークアップでは、2 つのタグがそれぞれ異なる理由で省略されています。  
+  
+-   **StackPanel.Children プロパティ要素の省略 :**  <xref:System.Windows.Controls.StackPanel> は <xref:System.Windows.Controls.Panel> から派生します。  <xref:System.Windows.Controls.Panel> では、<xref:System.Windows.Controls.Panel.Children%2A?displayProperty=fullName> がその XAML コンテンツ プロパティとして定義されています。  
+  
+-   **UIElementCollection オブジェクト要素の省略 :** <xref:System.Windows.Controls.Panel.Children%2A?displayProperty=fullName> プロパティは、<xref:System.Collections.IList> を実装する <xref:System.Windows.Controls.UIElementCollection> 型を受け取ります。  コレクションの要素タグは、<xref:System.Collections.IList> などのコレクションの処理に関する XAML の規則に基づいて省略できます   \(この例では、<xref:System.Windows.Controls.UIElementCollection> は既定のコンストラクターを公開していないため、実際にはインスタンス化できません。<xref:System.Windows.Controls.UIElementCollection> オブジェクト要素がコメント アウトされているのはこのためです\)。  
+  
+```xaml  
+<StackPanel>  
+  <StackPanel.Children>  
+    <!--<UIElementCollection>-->  
+    <Button>First Button</Button>  
+    <Button>Second Button</Button>  
+    <!--</UIElementCollection>-->  
+  </StackPanel.Children>  
+</StackPanel>  
+```  
+  
+### 属性構文 \(イベント\)  
+ 属性構文は、プロパティではなくイベントであるメンバーに対しても使用できます。  この場合、属性の名前はイベントの名前です。  XAML のイベントの WPF 実装では、属性の値は、そのイベントのデリゲートを実装するハンドラーの名前です。  たとえば、次のマークアップでは、マークアップで作成された <xref:System.Windows.Controls.Button> に <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントのハンドラーを割り当てています。  
+  
+ [!code-xml[XAMLOvwSupport#ButtonWithCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page3.xaml#buttonwithcodebehind)]  
+  
+ WPF のイベントと XAML については、この属性構文の例だけでは説明しきれません。  たとえば、ここで参照されている `ClickHandler` が何を表し、どのように定義されているのかが気になった方もいるでしょう。  これについては、後ほど「」で説明します。  
+  
+<a name="case_and_whitespace_in_xaml"></a>   
+## XAML の大文字\/小文字と空白  
+ 一般に、XAML は大文字と小文字を区別します。  バッキング型の解決という目的上、CLR が大文字と小文字を区別する同じ規則によって、WPF XAML は大文字と小文字を区別します。  アセンブリ内の基になる型や型のメンバーとの名前による比較の際は、すべてのオブジェクト要素、プロパティ要素、および属性名を、大文字と小文字を正しく区別して指定する必要があります。  XAML 言語のキーワードとプリミティブも大文字と小文字を区別します。  値の大文字と小文字は必ずしも区別されるわけではありません。  値の大文字と小文字が区別されるかどうかは、その値を受け取るプロパティ \(そのプロパティの値型\) に関連付けられている型コンバーターの動作によって決まります。  たとえば、<xref:System.Boolean> 型を受け取るプロパティでは、`true` と `True` のいずれかを同じ値として受け取ることができますが、これは、ネイティブ WPF XAML パーサーの文字列から <xref:System.Boolean> への型変換で、これらを同じ値として扱うことが許可済みであるためです。  
+  
+ WPF XAML プロセッサとシリアライザーでは、意味のない空白はすべて無視 \(省略\) され、意味のある空白は正規化されます。  これは、XAML 仕様で推奨される既定の空白の動作と一致しています。  この動作は、通常、XAML コンテンツ プロパティ内に文字列を指定した場合にのみ行われます。  簡単に言うと、XAML では、空白、ライン フィード、およびタブ文字が空白に変換され、連続する文字列の前または後ろに空白がある場合は、それぞれ 1 つの空白が保持されます。  XAML の空白の処理の詳細は、このトピックでは扱いません。  詳細については、「[XAML での空白の処理](../../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)」を参照してください。  
+  
+<a name="markup_extensions"></a>   
+## マークアップ拡張  
+ マークアップ拡張機能は XAML 言語の概念です。  属性構文の値を指定するために使用する場合は、中かっこ \(`{` と `}`\) によってマークアップ拡張機能の使用方法を示します。  これにより、XAML プロセッサの通常の処理 \(リテラル文字列か、文字列に変換できる値のいずれかとして属性値を扱う処理\) がエスケープされます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーション プログラミングで使用される最も一般的なマークアップ拡張機能には、データ バインディング表現に使用する [Binding](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)、およびリソース参照 [StaticResource](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md) と [DynamicResource](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md) があります。  マークアップ拡張機能を使用すると、通常は属性構文をサポートしないプロパティでも、属性構文を使用してプロパティの値を指定できます。  また、中間式の型を使用して、値の設定の遅延や、実行時にしか存在しない他のオブジェクトの参照などの機能を有効にすることもできます。  
+  
+ たとえば、次のマークアップでは、属性構文を使用して <xref:System.Windows.FrameworkElement.Style%2A> プロパティの値を設定しています。  <xref:System.Windows.FrameworkElement.Style%2A> プロパティは <xref:System.Windows.Style> クラスのインスタンスを受け取ります。これは、既定では属性構文の文字列でインスタンス化することはできません。  しかし、この例では、属性が [StaticResource](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md) のマークアップ拡張機能を参照しています。  このマークアップ拡張機能が処理されると、リソース ディクショナリ内のキーを持つリソースとして既にインスタンス化されているスタイルへの参照が返されます。  
+  
+<!-- TODO: review snippet reference  [!CODE [FEResourceSH#XAMLOvwShortResources](FEResourceSH#XAMLOvwShortResources)]  -->  
+<!-- TODO: review snippet reference [!CODE [FEResourceSH#XAMLOvwShortResources2](FEResourceSH#XAMLOvwShortResources2)]  -->  
+<!-- TODO: review snippet reference [!CODE [FEResourceSH#XAMLOvwShortResources3](FEResourceSH#XAMLOvwShortResources3)]  -->  
+  
+ 特に WPF に実装されている XAML のすべてのマークアップ拡張機能のリファレンス情報については、「[WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)」を参照してください。  System.Xaml で定義され、.NET Framework XAML の実装でより広範に使用できるマークアップ拡張機能のリファレンス情報については、「[XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)」を参照してください。  マークアップ拡張機能の概念の詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+<a name="type_converters"></a>   
+## 型コンバーター  
+ 「」で説明したように、属性値は文字列で設定できる必要があります。  文字列から他のオブジェクト型やプリミティブ値への変換という基本的なネイティブの処理は、<xref:System.DateTime> や <xref:System.Uri> などの一部の型のネイティブ処理と同様に、<xref:System.String> 型自体に基づいて行われます。  ただし、多くの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 型やそのメンバーでは、基本的な文字列属性の処理の動作を拡張して、より複雑なオブジェクト型のインスタンスを文字列や属性として指定できるようにしています。  
+  
+ XAML での使用時に型変換が有効になる型の一例として、<xref:System.Windows.Thickness> 構造体があります。  <xref:System.Windows.Thickness> は、入れ子になった四角形内の寸法を表す構造体で、<xref:System.Windows.FrameworkElement.Margin%2A> などのプロパティの値として使用されます。  <xref:System.Windows.Thickness> に型コンバーターを配置すると、<xref:System.Windows.Thickness> を使用するすべてのプロパティを属性として指定できるようになるため、XAML での指定が簡単になります。  次の例では、型変換と属性構文を使用して <xref:System.Windows.FrameworkElement.Margin%2A> の値を指定しています。  
+  
+ [!code-xml[XAMLOvwSupport#MarginTCE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page7.xaml#margintce)]  
+  
+ この属性構文の例は、次の例に示すより冗長な構文と同等です。次の例では、<xref:System.Windows.Thickness> オブジェクト要素を含むプロパティ要素構文によって <xref:System.Windows.FrameworkElement.Margin%2A> が設定されています。  <xref:System.Windows.Thickness> の 4 つの主要なプロパティが、新しいインスタンスの属性として設定されています。  
+  
+ [!code-xml[XAMLOvwSupport#MarginVerbose](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page7.xaml#marginverbose)]  
+  
+> [!NOTE]
+>  オブジェクトによっては、型自体に既定のコンストラクターがないため、サブクラスを含めずにプロパティをその型に設定するには型変換を使用する以外方法がない場合もあります。  <xref:System.Windows.Input.Cursor> はその一例です。  
+  
+ 型変換および属性構文での型変換の使用がどのようにサポートされているかの詳細については、「[TypeConverters および XAML](../../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)」を参照してください。  
+  
+<a name="xaml_root_elements_and_xaml_namespaces"></a>   
+## XAML ルート要素と XAML 名前空間  
+ XAML ファイルを整形式の [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ファイルにし、有効な XAML ファイルにするためには、ルート要素を 1 つだけ指定する必要があります。  一般的な WPF シナリオでは、WPF アプリケーション モデルにおいて重要な意味を持つルート要素を使用します \(ページの場合は <xref:System.Windows.Window> や <xref:System.Windows.Controls.Page>、外部ディクショナリの場合は <xref:System.Windows.ResourceDictionary>、アプリケーション定義の場合は <xref:System.Windows.Application> など\)。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ページの一般的な XAML ファイルの <xref:System.Windows.Controls.Page> というルート要素の例を次に示します。  
+  
+ [!code-xml[XAMLOvwSupport#RootOnly](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page2.xaml#rootonly)]  
+[!code-xml[XAMLOvwSupport#RootOnly2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page2.xaml#rootonly2)]  
+  
+ このルート要素には、`xmlns` と `xmlns:x` という属性も含まれています。  これらの属性は、マークアップで要素として参照するバッキング型の型定義が含まれている XAML 名前空間を XAML プロセッサに対して示します。  `xmlns` 属性は、既定の XAML 名前空間を明示的に指定しています。  既定の XAML 名前空間内では、マークアップのオブジェクト要素をプレフィックスなしで指定できます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションのほとんどのシナリオ \(およびこの [!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] セクションのほとんどすべての例\) で、既定の XAML 名前空間は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 名前空間 [!INCLUDE[TLA#tla_wpfxmlnsv1](../../../../includes/tlasharptla-wpfxmlnsv1-md.md)] にマッピングされます。  `xmlns:x` 属性は追加の XAML 名前空間を示し、XAML 言語の名前空間 [!INCLUDE[TLA#tla_xamlxmlnsv1](../../../../includes/tlasharptla-xamlxmlnsv1-md.md)] を割り当てています。  
+  
+ このように `xmlns` を使用して名前空間の使用方法とマッピングのスコープを定義することは、XML 1.0 仕様に一致しています。  XAML 名前空間と XML 名前空間の違いは、XAML 名前空間は、型の解決や XAML の解析の際に、名前空間の要素のバッキング タイプを特定するためにも使用されるということだけです。  
+  
+ `xmlns` 属性が厳密に必要なのは、各 XAML ファイルのルート要素に対してだけです。  `xmlns` の定義はルート要素のすべての子孫要素に適用されます \(この動作も `xmlns` の XML 1.0 仕様に一致しています\)。`xmlns` 属性をルートの下のその他の要素で定義することも可能で、その場合も、定義されている要素のすべての子孫要素に適用されます。  ただし、XAML 名前空間を頻繁に定義したり再定義したりすると、XAML のマークアップが読みにくくなる可能性があります。  
+  
+ XAML プロセッサの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 実装には、WPF コア アセンブリを認識するインフラストラクチャが含まれます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コア アセンブリは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] から既定の XAML 名前空間へのマッピングをサポートする型を含んでいることがわかっています。  これは、プロジェクト ビルド ファイルに含まれている構成と、WPF のビルド システムとプロジェクト システムによって実現されます。  このため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アセンブリに基づく XAML 要素を参照するには、既定の XAML 名前空間を既定の `xmlns` として宣言するだけで済みます。  
+  
+### x: プレフィックス  
+ 前のルート要素の例では、`x:` というプレフィックスを使用して、XAML 名前空間 [!INCLUDE[TLA#tla_xamlxmlnsv1](../../../../includes/tlasharptla-xamlxmlnsv1-md.md)] \(XAML 言語構成要素をサポートする専用の XAML 名前空間\) をマップしていました。  この `x:` プレフィックスは、この [!INCLUDE[TLA2#tla_sdk](../../../../includes/tla2sharptla-sdk-md.md)] 全体を通じて、プロジェクトのテンプレート、例、およびドキュメントで、この XAML 名前空間をマッピングするために使用されています。  XAML 言語用の XAML 名前空間には、XAML で頻繁に使用されるプログラミング構成要素がいくつか含まれます。  `x:` プレフィックスのプログラミング構成要素の中で最もよく使用されるものを以下に示します。  
+  
+-   [x:Key](../../../../docs/framework/xaml-services/x-key-directive.md): <xref:System.Windows.ResourceDictionary> 内の各リソース \(または他のフレームワークの同様のディクショナリの概念\) に一意キーを設定します。  おそらく、一般的な WPF アプリケーションのマークアップで使用される `x:` の約 90% は `x:Key` であると考えられます。  
+  
+-   [x:Class](../../../../docs/framework/xaml-services/x-class-directive.md): XAML ページの分離コードを提供するクラスの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 名前空間とクラス名を指定します。  WPF プログラミング モデルごとに分離コードをサポートするには、このようなクラスが必要です。リソースがない場合でもほぼ必ず `x:` が割り当てられるのはこのためです。  
+  
+-   [x:Name](../../../../docs/framework/xaml-services/x-name-directive.md): オブジェクト要素が処理された後のランタイム コードに存在するインスタンスのランタイム オブジェクト名を指定します。  一般に、[x:Name](../../../../docs/framework/xaml-services/x-name-directive.md) に対応する WPF で定義されている同様のプロパティを使用することがよくあります。  このようなプロパティは特に CLR バッキング プロパティに割り当てられるので、初期化された XAML から名前付き要素を見つけるために実行時コードを使用することがよくある、アプリケーションのプログラミングで役立ちます。  このようなプロパティで最も一般的に使用されるのは、<xref:System.Windows.FrameworkElement.Name%2A?displayProperty=fullName> です。  それでも、[x:Name](../../../../docs/framework/xaml-services/x-name-directive.md) は、同等の [WPF フレームワーク レベル](GTMT)の <xref:System.Windows.FrameworkElement.Name%2A> プロパティが特定の型でサポートされない場合に使用します。  一部のアニメーション シナリオでこのような状況が見られます。  
+  
+-   [x:Static](../../../../docs/framework/xaml-services/x-static-markup-extension.md): XAML 互換のプロパティとしては定義されていない静的な値を返す参照を可能にします。  
+  
+-   [x:Type](../../../../docs/framework/xaml-services/x-type-markup-extension.md): 型の名前に基づいて <xref:System.Type> の参照を作成します。  これは、<xref:System.Windows.Style.TargetType%2A?displayProperty=fullName> など、<xref:System.Type> を受け取る属性を指定する場合に使用します。ただし、多くの場合、プロパティには文字列から <xref:System.Type> へのネイティブ変換が用意されており、[x:Type](../../../../docs/framework/xaml-services/x-type-markup-extension.md) マークアップ拡張機能の使用は任意です。  
+  
+ `x:` プレフィックス\/XAML 名前空間には、これ以外にも、あまり一般的でないプログラミング構成要素があります。  詳細については、「[XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)」を参照してください。  
+  
+<a name="custom_prefixes_and_custom_types_in_xaml"></a>   
+## XAML のカスタム プレフィックスとカスタム型  
+ 独自のカスタム アセンブリや、WPF コアの PresentationCore、PresentationFramework、および WindowsBase 以外のアセンブリに対しては、カスタム `xmlns` マッピングの一部としてそのアセンブリを指定できます。  そうすると、目的の XAML の使用方法をサポートするように型が正しく実装されている限り、そのアセンブリの型を XAML で参照できるようになります。  
+  
+ XAML マークアップでカスタム プレフィックスがどのように機能するのかをごく簡単な例で見てみましょう。  プレフィックス `custom` がルート要素タグで定義され、アプリケーションにパッケージ化されている特定のアセンブリに対応付けられています。  このアセンブリには、`NumericUpDown` という型が含まれています。この型は、一般的な XAML の使用方法と、この型を WPF XAML コンテンツ モデルのこの特定の場所に挿入できるようにするクラス継承の使用をサポートするように実装されています。  この `NumericUpDown` コントロールのインスタンスは、プレフィックスを使用してオブジェクト要素として宣言されます。プレフィックスにより、この型がどの XAML 名前空間に含まれているか、さらには型定義を含むバッキング アセンブリがどこにあるかを XAML パーサーが認識できるようになります。  
+  
+```  
+<Page  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"   
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"   
+    xmlns:custom="clr-namespace:NumericUpDownCustomControl;assembly=CustomLibrary"  
+    >  
+  <StackPanel Name="LayoutRoot">  
+    <custom:NumericUpDown Name="numericCtrl1" Width="100" Height="60"/>  
+...  
+  </StackPanel>  
+</Page>  
+```  
+  
+ XAML のカスタム型の詳細については、「[WPF における XAML とカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)」を参照してください。  
+  
+ XML 名前空間とアセンブリ内の対応するコードの名前空間との関連の詳細については、「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照してください。  
+  
+<a name="events_and_xaml_codebehind"></a>   
+## イベントと XAML 分離コード  
+ ほとんどの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションは、XAML マークアップと分離コードの両方で構成されています。  プロジェクト内では、XAML は `.xaml` ファイルとして作成され、分離コード ファイルの記述には [!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] や [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] などの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] 言語が使用されます。  WPF プログラミングとアプリケーション モデルの一部として XAML ファイルをマークアップ コンパイルすると、XAML のルート要素の `x:Class` 属性として指定された名前空間とクラスにより、XAML ファイルに対応する XAML 分離コード ファイルの場所が特定されます。  
+  
+ これまでに見てきた例にはいくつかのボタンが含まれていましたが、それらのボタンにはまだ論理的な動作が関連付けられていません。  オブジェクト要素の動作を追加するためのアプリケーション レベルの主要なメカニズムでは、要素クラスの既存のイベントを使用して、そのイベントの特定のハンドラーを作成します。実行時にそのイベントが発生すると、そのハンドラーが呼び出されます。  イベントの名前と使用するハンドラーの名前をマークアップで指定し、ハンドラーを実装するコードは分離コードで定義します。  
+  
+ [!code-xml[XAMLOvwSupport#ButtonWithCodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page3.xaml#buttonwithcodebehind)]  
+  
+ [!code-csharp[XAMLOvwSupport#ButtonWithCodeBehindHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page3.xaml.cs#buttonwithcodebehindhandler)]
+ [!code-vb[XAMLOvwSupport#ButtonWithCodeBehindHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XAMLOvwSupport/VisualBasic/Page1.xaml.vb#buttonwithcodebehindhandler)]  
+  
+ この分離コード ファイルでは、CLR 名前空間 `ExampleNamespace` が使用されており、その名前空間内の部分クラスとして `ExamplePage` が宣言されています。  これは、マークアップのルートで指定されている `x:Class` 属性値 `ExampleNamespace`.`ExamplePage` に対応しています。  WPF マークアップ コンパイラは、ルート要素の型からクラスを派生させることにより、コンパイルされた XAML ファイルの部分クラスを作成します。  同じ部分クラスを定義する分離コードを指定した場合、作成されるコードは、コンパイルされたアプリケーションの同じ名前空間とクラスに結合されます。  
+  
+ WPF での分離コード プログラミングの要件の詳細については、「[WPF における分離コードと XAML](../../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)」の「分離コード、イベント ハンドラー、および部分クラスの要件」を参照してください。  
+  
+ 独立した分離コード ファイルを作成しない場合は、XAML ファイル内にインラインでコードを埋め込むこともできます。  ただし、インライン コードには多くの制限があり、汎用性の面で劣ります。  詳細については、「[WPF における分離コードと XAML](../../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)」を参照してください。  
+  
+### ルーティング イベント  
+ [ルーティング イベント](GTMT)は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の基本的なイベント機能です。  ルーティング イベントを使用すると、ツリー リレーションシップでつながっている要素間において、ある要素で発生したイベントを別の要素で処理できます。  XAML 属性を使用してイベント処理を指定する際には、要素のクラス メンバー テーブルにその特定のイベントが含まれているかどうかに関係なく、任意の要素でルーティング イベントをリッスンおよび処理できます。  これを実現するには、所有するクラスの名前でイベント名属性を修飾します。  たとえば、ここで使用している `StackPanel` \/ `Button` の例の親 `StackPanel` で子要素ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントのハンドラーを登録するには、`StackPanel` オブジェクト要素で属性 `Button.Click` を指定します。属性値は、使用するハンドラーの名前です。  ルーティング イベントのしくみの詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」を参照してください。  
+  
+<a name="x_name_and_xaml_named_elements"></a>   
+## XAML の名前付き要素  
+ XAML オブジェクト要素を処理することによってオブジェクト グラフに作成されたオブジェクト インスタンスには、既定では一意の識別子やオブジェクト参照はありません。  これに対し、コードでコンストラクターを呼び出す場合は、作成されたインスタンスを後からコードで参照できるように、コンストラクターの結果として返されたインスタンスを変数に設定することが一般的です。  XAML の場合は、マークアップ定義によって作成されたオブジェクトへの標準的なアクセスを実現する方法として、[x:Name 属性](../../../../docs/framework/xaml-services/x-name-directive.md)が定義されています。  `x:Name` 属性の値は、任意のオブジェクト要素で設定できます。  指定した識別子は、分離コードにおいて、作成されたインスタンスを参照するインスタンス変数と同じように機能します。  名前付きの要素はあらゆる点でオブジェクト インスタンスのように機能するため \(名前で対象のインスタンスが参照されます\)、名前付きの要素を分離コードで参照してアプリケーション内の実行時のやり取りを処理できます。  インスタンスと変数間のこの関連付けは、WPF XAML マークアップ コンパイラによって実現し、より具体的には <xref:System.Windows.Markup.IComponentConnector.InitializeComponent%2A> などの機能とパターン \(ここでは詳しく説明しません\) が必要です。  
+  
+ [WPF フレームワーク レベル](GTMT)の XAML 要素は、<xref:System.Windows.FrameworkElement.Name%2A> プロパティを継承しています。このプロパティは、XAML で定義される `x:Name` 属性と同等です。  その他のクラスでも、`x:Name` と同等のプロパティが用意されている場合があり、そのようなプロパティも通常は `Name` プロパティとして定義されています。  一般に、目的の要素\/型のメンバー テーブルに `Name` プロパティがない場合は、代わりに `x:Name` を使用します。  `x:Name` の値は、特定のサブシステムまたはユーティリティ メソッド \(<xref:System.Windows.FrameworkElement.FindName%2A> など\) によって、実行時に使用できる XAML 要素に識別子を提供します。  
+  
+ 次の例では、<xref:System.Windows.Controls.StackPanel> 要素の <xref:System.Windows.FrameworkElement.Name%2A> を設定しています。  その後、その <xref:System.Windows.Controls.StackPanel> 内の <xref:System.Windows.Controls.Button> のハンドラーで、<xref:System.Windows.FrameworkElement.Name%2A> で設定したインスタンス参照 `buttonContainer` を使用して <xref:System.Windows.Controls.StackPanel> を参照しています。  
+  
+ [!code-xml[XAMLOvwSupport#NamedE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page7.xaml#namede)]  
+[!code-xml[XAMLOvwSupport#NamedE2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page7.xaml#namede2)]  
+  
+ [!code-csharp[XAMLOvwSupport#NameCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page7.xaml.cs#namecode)]
+ [!code-vb[XAMLOvwSupport#NameCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XAMLOvwSupport/VisualBasic/Page1.xaml.vb#namecode)]  
+  
+ 変数と同様に、インスタンスの XAML 名も、予測可能な特定のスコープ内において名前が一意になるように、スコープの概念によって制御されています。  ページを定義するプライマリ マークアップで一意の XAML 名前スコープが指定され、XAML 名前スコープの境界はそのページのルート要素になります。  ただし、実行時には、スタイルやスタイル内のテンプレートなどの他のマークアップ ソースもページとやり取りをする可能性があります。そのようなマークアップ ソースは、ページの XAML 名前スコープとは必ずしも関連のない独自の XAML スコープを持っていることがよくあります。  `x:Name` および XAML 名前スコープの詳細については、「<xref:System.Windows.FrameworkElement.Name%2A>」、「[x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)」、または「[WPF XAML 名前スコープ](../../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)」を参照してください。  
+  
+<a name="attached_properties_and_attached_events"></a>   
+## 添付プロパティと添付イベント  
+ XAML で規定されている言語機能では、要素の型の定義に存在するかどうかに関係なく、特定のプロパティやイベントを任意の要素で指定できます。  この機能は、プロパティでは[添付プロパティ](GTMT)、イベントでは[添付イベント](GTMT)と呼びます。  添付プロパティと添付イベントは、概念的には、任意の XAML 要素\/オブジェクト インスタンスに設定できるグローバル メンバーと考えることができます。  ただし、その要素\/クラス、またはより大きなインフラストラクチャは、添付された値のバッキング プロパティ ストアをサポートする必要があります。  
+  
+ XAML の添付プロパティは、通常、属性構文で使用されます。  属性構文では、*ownerType*.*propertyName* という形式で添付プロパティを指定します。  
+  
+ この形式は、表面的にはプロパティ要素の使用方法に似ていますが、ここで指定する *ownerType* は常に、添付プロパティが設定されるオブジェクト要素とは別の型です。  *ownerType* は、XAML プロセッサで添付プロパティの値を取得したり設定したりするために必要なアクセサー メソッドを提供する型です。  
+  
+ 添付プロパティのシナリオとしては、子要素が親要素にプロパティ値を報告できるようにするために使用されるのが最も一般的です。  
+  
+ <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 添付プロパティの例を次に示します。  <xref:System.Windows.Controls.DockPanel> クラスは、<xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> のアクセサーを定義しています。したがって、この添付プロパティを所有しています。  <xref:System.Windows.Controls.DockPanel> クラスには、子要素を反復処理して各要素で <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> の設定値がないかどうかをチェックするロジックも含まれています。  値が見つかった場合は、レイアウト時に子要素を配置するために使用されます。  実際、<xref:System.Windows.Controls.DockPanel> クラスは、<xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 添付プロパティとこの配置の機能のために使用されます。  
+  
+ [!code-xml[XAMLOvwSupport#DockAP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#dockap)]  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、大部分またはすべての添付プロパティは[依存関係プロパティ](GTMT)としても実装されます。  詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+ 添付イベントも、*ownerType*.*eventName* という同じような形式の属性構文を使用します。  他のイベントの場合と同様に、XAML の添付イベントの属性値では、要素でイベントが処理されるときに呼び出されるハンドラー メソッドの名前を指定します。  WPF XAML で添付イベントを使用することはあまり一般的ではありません。  詳細については、「[添付イベントの概要](../../../../docs/framework/wpf/advanced/attached-events-overview.md)」を参照してください。  
+  
+<a name="base_classes_and_xaml"></a>   
+## 基本型と XAML  
+ WPF XAML とその XAML 名前空間の基礎になっているのは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトに対応する一連の型です。これらのクラスは、XAML のマークアップ要素にも対応しています。  ただし、すべてのクラスを要素に対応付けられるわけではありません。  <xref:System.Windows.Controls.Primitives.ButtonBase> などの抽象クラスや一部の非抽象基本クラスは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト モデルでは継承のために使用されます。  それでも基本クラスは、抽象クラスも含め、XAML 開発にとって重要です。これは、XAML の各具象要素は、その階層構造内の基本クラスのメンバーを継承するためです。  それらのメンバーには、多くの場合、要素の属性として設定できるプロパティや、処理できるイベントが含まれています。  <xref:System.Windows.FrameworkElement> は、[WPF フレームワーク レベル](GTMT)における [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の具象基本 [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] クラスです。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をデザインする際には、さまざまな図形、パネル、デコレータ、コントロールのクラスを使用しますが、それらはすべて <xref:System.Windows.FrameworkElement> から派生します。  関連する基本クラスの <xref:System.Windows.FrameworkContentElement> は、<xref:System.Windows.FrameworkElement> の [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を意図的に反映する [!INCLUDE[TLA2#tla_api#plural](../../../../includes/tla2sharptla-apisharpplural-md.md)] を使用して、フロー レイアウトのプレゼンテーションに適したドキュメント指向の要素をサポートします。  要素レベルの属性と [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト モデルの組み合わせにより、一連の共通プロパティをほとんどの具象 XAML 要素で、特定の XAML 要素や基になる型に関係なく設定できるようになっています。  
+  
+<a name="xaml_security"></a>   
+## XAML のセキュリティ  
+ XAML は、オブジェクトのインスタンス化と実行を直接表現するマークアップ言語です。  したがって、XAML で作成された要素では、対応する生成コードと同じシステム リソースとのやり取り \(ネットワーク アクセスやファイル システムの入出力など\) が可能です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、[!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] セキュリティ フレームワークの [!INCLUDE[TLA#tla_cas](../../../../includes/tlasharptla-cas-md.md)] をサポートしています。  このため、インターネット ゾーンで実行される [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コンテンツは、実行のアクセス許可を制限されます。  "Loose XAML" \(読み込み時に XAML ビューアーによって解釈されるコンパイルされない XAML のページ\) と [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] は、通常このインターネット ゾーンで実行され、同じアクセス許可セットを使用します。  ただし、完全に信頼されたアプリケーションに読み込まれた XAML は、システム リソースに対してホスト アプリケーションと同じアクセス権を持ちます。  詳細については、「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+<a name="loading_xaml_from_code"></a>   
+## コードからの XAML の読み込み  
+ XAML を使用してすべての UI を定義することもできますが、UI の一部のみを XAML で定義することが適している場合もあります。  この機能を利用すると、部分的なカスタマイズ、情報のローカル保存、XAML を使用したビジネス オブジェクトの提供など、さまざまなシナリオが可能になります。  このようなシナリオで重要になるのは、<xref:System.Windows.Markup.XamlReader> クラスおよびその <xref:System.Windows.Markup.XamlReader.Load%2A> メソッドです。  XAML ファイルを入力とし、そのマークアップから作成された実行時のすべてのオブジェクト ツリーを表す 1 つのオブジェクトが出力となります。  このオブジェクトを、アプリケーション内に既に存在する別のオブジェクトのプロパティとして挿入できます。  そのプロパティが、最終的な表示機能を備え、アプリケーションへの新しいコンテンツの追加を実行エンジンに通知するコンテンツ モデルにおける適切なプロパティであれば、XAML を使用して、実行中のアプリケーションのコンテンツを非常に簡単に修正できます。  ただし、実行中のアプリケーションにファイルを読み込むことは明らかにセキュリティに影響するので、この機能を利用できるのは、一般に完全信頼アプリケーションの場合のみです。  
+  
+<a name="whats_next"></a>   
+## 次の内容  
+ ここでは、WPF に適用される XAML 構文の概念と用語の基本的な概要を紹介しました。  ここで使用した用語の詳細については、「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+ まだ終えていない場合は、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」のチュートリアルの演習に挑戦してみることをお勧めします。  このチュートリアルで説明されているマークアップ中心のアプリケーションを作成すると、ここで説明した多くの概念の理解が深まります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Windows.Application> クラスに基づく特有のアプリケーション モデルを使用します。  詳細については、「[アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)」を参照してください。  
+  
+ XAML を含むアプリケーションをコマンド ラインから作成する方法、および [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用して作成する方法の詳細については、「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のプロパティの汎用性についての詳細、および[依存関係プロパティ](GTMT)の概念の概要については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+## 参照  
+ [XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)   
+ [WPF における XAML とカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)   
+ [XAML 名前空間 \(x:\) 言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)   
+ [WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)   
+ [基本要素の概要](../../../../docs/framework/wpf/advanced/base-elements-overview.md)   
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-resources.md b/docs/framework/wpf/advanced/xaml-resources.md
new file mode 100644
index 00000000000..b7db436bf64
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-resources.md
@@ -0,0 +1,172 @@
+---
+title: "XAML リソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "再利用 (リソースを)"
+  - "リソースを再利用します。"
+  - "再利用 (一般的に定義されるオブジェクトを)"
+  - "XAML では、リソースの再利用"
+ms.assetid: 91580b89-a0a8-4889-aecb-fddf8e63175f
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 32
+---
+# XAML リソース
+リソースは、アプリケーションでさまざまな場所で再利用可能なオブジェクトです。 リソースの例には、ブラシやスタイルが含まれます。 この概要でのリソースを使用する方法を説明する[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]です。 作成、または同じ意味で、コードを使用して、コードの間でリソースにアクセスして、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]です。 詳細については、次を参照してください。[リソースとコード](../../../../docs/framework/wpf/advanced/resources-and-code.md)します。  
+  
+> [!NOTE]
+>  このトピックで説明されているリソース ファイルとリソース ファイルに記載するものと異なる場合は[WPF アプリケーションのリソース、コンテンツ、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)で記述されている埋め込みまたはリンクされたリソースとは異なると[を管理するアプリケーションのリソース (.NET)](../Topic/Managing%20Application%20Resources%20\(.NET\).md)します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="usingresources"></a>   
+## <a name="using-resources-in-xaml"></a>XAML でリソースを使用します。  
+ 次の例、 <xref:System.Windows.Media.SolidColorBrush>ページのルート要素上のリソースとして。 例では、リソースを参照しなどいくつかの子要素のプロパティを設定するため、<xref:System.Windows.Shapes.Ellipse>、 <xref:System.Windows.Controls.TextBlock>、および<xref:System.Windows.Controls.Button>します。  
+  
+ [!code-xml[FEResourceSH_snip#XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEResourceSH_snip/CS/page1.xaml#xaml)]  
+  
+ フレームワーク レベルのすべての要素 ( <xref:System.Windows.FrameworkElement>または<xref:System.Windows.FrameworkContentElement>) が、<xref:System.Windows.FrameworkElement.Resources%2A>リソースを含むプロパティであるプロパティ (として、 <xref:System.Windows.ResourceDictionary>) リソースを定義します。 任意の要素でリソースを定義することができます。 ただし、リソースは、これはルート要素で定義された最も多くの場合、<xref:System.Windows.Controls.Page>の例です。  
+  
+ リソース ディクショナリ内の各リソースは、一意キーを持つ必要があります。 使って一意のキーを割り当てるマークアップでリソースを定義すると、 [X:key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)します。 通常、キーは、文字列です。ただしも設定できます、その他のオブジェクトの種類に適切なマークアップ拡張機能を使用しています。 リソースの文字列ではないキーが特定の機能領域内で使用される[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]スタイル、コンポーネントのリソース、およびデータのスタイル処理の代表的なものです。  
+  
+ リソースを定義した後は、たとえば、キー名を指定するリソースのマークアップ拡張構文を使用して、プロパティ値を使用するリソースを参照できます。  
+  
+ [!code-xml[FEResourceSH_snip#KeyNameUsage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEResourceSH_snip/CS/page2.xaml#keynameusage)]  
+  
+ 前の例でときに、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ローダーは、値を処理`{StaticResource MyBrush}`の<xref:System.Windows.Controls.Control.Background%2A>プロパティを<xref:System.Windows.Controls.Button>、リソースの検索ロジック最初をリソース ディクショナリでチェック、 <xref:System.Windows.Controls.Button>要素。 場合<xref:System.Windows.Controls.Button>リソース キーの定義がない`MyBrush`(そうでない、つまり、リソースのコレクションが空)、ルックアップの親要素を次にチェックする<xref:System.Windows.Controls.Button>、これは<xref:System.Windows.Controls.Page>します。 したがってのリソースを定義するとき、<xref:System.Windows.Controls.Page>ルート要素での論理ツリー内のすべての要素、<xref:System.Windows.Controls.Page>アクセスでき、および任意のプロパティの値の設定を受け入れるため、同じリソースを再利用することができます、<xref:System.Type>リソースが表す。 同じ前の例で`MyBrush`リソースは、2 つの異なるプロパティを設定:<xref:System.Windows.Controls.Control.Background%2A>の<xref:System.Windows.Controls.Button>、および<xref:System.Windows.Shapes.Shape.Fill%2A>の<xref:System.Windows.Shapes.Rectangle>します。  
+  
+<a name="staticdynamic"></a>   
+## <a name="static-and-dynamic-resources"></a>静的および動的なリソース  
+ リソースは、静的リソースまたは動的なリソースのいずれかとして参照することができます。 いずれかを使用して、これは、 [StaticResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)または[DynamicResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)です。 マークアップ拡張機能の機能である[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]オブジェクト参照を指定するには、マークアップ拡張が設定されている属性の文字列を処理し、対象のオブジェクトを返すには、機能を持つことでこれによって、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ローダー。 マークアップ拡張機能の動作の詳細については、次を参照してください。[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)します。  
+  
+ マークアップ拡張機能を使用する場合は、その特定のマークアップ拡張機能で処理される文字列形式の&1; つ以上のパラメーターではなく、設定されるプロパティのコンテキストで評価される通常提供します。 [StaticResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)すべての利用可能なリソース ディクショナリ内でそのキーの値を参照して、キーを処理します。 これは、読み込みプロセスを静的リソース参照を受け取るプロパティの値を割り当てる必要がある場合に、ポイントの読み込み中に発生します。 [DynamicResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)代わりにプロセス、式とその式を作成して、キーは残ります評価されていないアプリケーションが実際に実行されるまで、れた時点で、式が評価され、値を提供します。  
+  
+ リソースを参照するときに次の考慮事項は、静的リソース参照または動的リソース参照を使用するかどうかに影響します。  
+  
+-   アプリケーションのリソースを作成する方法の全体的なデザイン (アプリケーションでは、ページごとに疎[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、リソースだけのアセンブリに)。  
+  
+-   アプリケーションの機能: アプリケーションの要件の一部をリアルタイムでリソースを更新中ですか?  
+  
+-   そのリソースの参照型のそれぞれの検索動作します。  
+  
+-   特定のプロパティまたはリソースの種類とそれらの型のネイティブの動作です。  
+  
+### <a name="static-resources"></a>静的リソース  
+ 静的リソースは、次の状況に最適な作業を参照します。  
+  
+-   アプリケーションの設計は集中ディクショナリでは、リソースのページへのまたはアプリケーション レベルのリソースのほぼすべてします。 静的リソース参照は、ページの再読み込みなどの実行時の動作に基づいて再評価されないと、したがってするはパフォーマンスが向上するには、リソースとアプリケーションを設計あたり不要と多数の動的リソース参照を回避します。  
+  
+-   含まれていないプロパティの値を設定する、 <xref:System.Windows.DependencyObject>または<xref:System.Windows.Freezable>します。  
+  
+-   DLL にコンパイルし、アプリケーションの一部としてパッケージ化またはアプリケーション間で共有されるリソース ディクショナリを作成します。  
+  
+-   カスタム コントロール用のテーマを作成し、テーマ内で使用されているリソースを定義します。 この場合は、通常たくない動的リソース参照の検索動作は、検索結果は予測可能で自己完結型のテーマにようにに代わりに、静的リソース参照動作が必要です。 動的リソース参照で、テーマでの参照のまま、偶数が、実行時まで評価して、テーマが適用されるときに、いくつかのローカル要素を参照すると、テーマ、キーを再定義し、ローカルの要素が参照では、それ自体は、テーマに以前分類可能性があります。 このような場合、テーマは期待どおりに動作しません。  
+  
+-   多数の依存関係プロパティを設定するのには、リソースを使用しています。 依存関係プロパティがある値のキャッシュ プロパティ システムで有効化されるので、可能な依存関係プロパティの値を指定する場合、読み込み時に評価される依存関係プロパティ reevaluated 式を確認する必要はありません、最後に有効な値を返すことができます。 この方法は、パフォーマンスが向上します。  
+  
+-   すべてのコンシューマーの基になるリソースを変更するかを使用して、各コンシューマーの書き込み可能な個別のインスタンスを管理する、 [x: 共有の属性](../../../../docs/framework/xaml-services/x-shared-attribute.md)します。  
+  
+#### <a name="static-resource-lookup-behavior"></a>静的リソースの検索動作  
+  
+1.  照合プロセスでは、プロパティを設定する要素によって定義されたリソース ディクショナリ内で要求されたキーを確認します。  
+  
+2.  検索プロセスは、親要素とそのリソース ディクショナリにし、論理ツリーを上を走査します。 ルート要素に到達するまで繰り返されます。  
+  
+3.  次に、アプリケーションのリソースがチェックされます。 アプリケーション リソースで定義されているリソース ディクショナリ内では、<xref:System.Windows.Application>のオブジェクト、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションです。  
+  
+ リソース ディクショナリ内の静的リソース参照が既に定義されている構文的にリソースの参照の前にリソースを参照する必要があります。 静的リソース参照では、前方参照を解決できません。 このため、静的リソース参照を使用する場合は、必要があります構造を設計する、リソース ディクショナリまたは各リソース ディクショナリの先頭付近にリソースを使用するためのリソースを定義するようです。  
+  
+ 静的リソースの検索には、テーマ、またはシステム リソースを拡張できますが、ためにのみ、これはサポート、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ローダーによって要求が遅延します。 ページの読み込み時にランタイムのテーマは、アプリケーションに適切に適用されるよう、遅延する必要があります。 ただし、静的リソース参照にのみ存在テーマまたはシステム リソースをお勧めできないとしているキーです。 これは、テーマがリアルタイムでユーザーが変更された場合、このような参照が再評価されないためです。 テーマやシステム リソースを要求すると、動的リソース参照はより信頼性の高いです。 例外は、テーマ要素自体が他のリソースを要求したときです。 これらの参照は、前述の理由で静的リソース参照をする必要があります。  
+  
+ 静的リソース参照が見つからない場合は、例外動作が異なります。 リソースが延期された場合は、実行時に例外が発生します。 リソースを遅延していない場合は、読み込み時に例外が発生します。  
+  
+### <a name="dynamic-resources"></a>動的リソース  
+ 次の状況に最適な動的リソース。  
+  
+-   リソースの値は、実行時まで不明な条件によって異なります。 これには、システム リソース、または他のユーザー設定可能なリソースが含まれます。 によって公開されていると、システムのプロパティを参照する set アクセス操作子の値を作成するなどの<xref:System.Windows.SystemColors>、 <xref:System.Windows.SystemFonts>、または<xref:System.Windows.SystemParameters>します。 これらの値は、最終的には、ユーザーとオペレーティング システムのランタイム環境から取得されるために本当に動的です。 ページ レベル リソースへのアクセスの変更のキャプチャをする必要がありますも、変更可能なアプリケーション レベルのテーマもあります。  
+  
+-   作成するか、カスタム コントロールのテーマ スタイルを参照します。  
+  
+-   内容を調整する、 <xref:System.Windows.ResourceDictionary>アプリケーションの有効期間中にします。  
+  
+-   前方参照が必要なありますの相互依存性を持つ構造の複雑なリソースがあります。 静的リソース参照は前方参照をサポートしていませんが、動的リソース参照をサポートしてそれらのリソースが実行時まで評価する必要がないのでおり前方参照できないためです、関連する概念です。  
+  
+-   大規模なコンパイルまたはワーキング セットの観点からは、リソースを参照しているし、ページが読み込まれるときにすぐに、リソースを使用しない可能性があります。 静的リソース参照を常に読み込む[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ページが読み込まれたときに、ただし、動的リソース参照まで読み込まれませんが、実際に使用します。  
+  
+-   Set アクセス操作子の値が元の場所のテーマや他のユーザー設定の影響を受けるその他の値のスタイルを作成します。  
+  
+-   する親を再指定論理ツリーでアプリケーションの有効期間中に要素には、リソースを適用します。 可能性のあるも、親を変更すると、リソースの検索スコープを変更ので、する場合は、リソースが再評価されますこの要素の新しいスコープに基づいて、常に使用して動的リソース参照します。  
+  
+#### <a name="dynamic-resource-lookup-behavior"></a>動的リソースの検索動作  
+ 呼び出した場合動的リソース参照用リソースの検索の動作は、コード内の検索の動作に対応して<xref:System.Windows.FrameworkElement.FindResource%2A>または<xref:System.Windows.FrameworkElement.SetResourceReference%2A>します。  
+  
+1.  照合プロセスでは、プロパティを設定する要素によって定義されたリソース ディクショナリ内で要求されたキーを確認します。  
+  
+    -   要素が定義されている場合、<xref:System.Windows.FrameworkElement.Style%2A>プロパティには、<xref:System.Windows.Style.Resources%2A>ディクショナリ内で、<xref:System.Windows.Style>がオンになっています。  
+  
+    -   要素が定義されている場合、<xref:System.Windows.Controls.Control.Template%2A>プロパティには、<xref:System.Windows.FrameworkTemplate.Resources%2A>ディクショナリ内で、 <xref:System.Windows.FrameworkTemplate>がオンになっています。  
+  
+2.  検索プロセスは、親要素とそのリソース ディクショナリにし、論理ツリーを上を走査します。 ルート要素に到達するまで繰り返されます。  
+  
+3.  次に、アプリケーションのリソースがチェックされます。 アプリケーション リソースで定義されているリソース ディクショナリ内では、<xref:System.Windows.Application>のオブジェクト、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションです。  
+  
+4.  現在アクティブなテーマのテーマ リソース ディクショナリがチェックされます。 実行時に、テーマが変更された場合、値が再評価されます。  
+  
+5.  システム リソースがチェックされます。  
+  
+ (もしあれば) の例外の動作が異なります。  
+  
+-   リソースが要求した場合、 <xref:System.Windows.FrameworkElement.FindResource%2A>を呼び出すとが見つかりませんでした、例外が発生します。  
+  
+-   リソースが要求した場合、 <xref:System.Windows.FrameworkElement.TryFindResource%2A>を呼び出すと、され、例外が発生しなかったが、返される値を検出されませんでした`null`します。 設定されるプロパティが受け付けない場合`null`、詳細な例外が発生することも、(これは設定されている個々 のプロパティに依存)。  
+  
+-   リソースが要求で動的リソース参照したかどうかは[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、およびは見つかりませんでしたし、動作は、[全般] プロパティ システムによって異なりますが、通常の動作は、レベル、リソースが存在するプロパティ設定操作実行されなかったかのようです。 たとえばに背景を設定しようとする場合、評価されないリソースを使用して、各ボタン要素値の設定はありません、結果が、プロパティ システムと値の優先順位の他の参加者から有効な値が決まることができます。 たとえば、バック グラウンドの値がローカルに定義されたボタンのスタイルとテーマ スタイルから決まる場合があります。 テーマ スタイルで定義されていないプロパティの場合は、障害が発生したリソースの評価後に有効な値は、プロパティのメタデータの既定値から取得可能性があります。  
+  
+#### <a name="restrictions"></a>制限事項  
+ 動的リソース参照では、いくつか注目すべき制限があります。 次の少なくとも&1; つがあります。  
+  
+-   設定されるプロパティは、プロパティ、 <xref:System.Windows.FrameworkElement>または<xref:System.Windows.FrameworkContentElement>します。 プロパティをバックアップする必要がある、 <xref:System.Windows.DependencyProperty>します。  
+  
+-   内の値を参照先は、<xref:System.Windows.Style><xref:System.Windows.Setter>します。  
+  
+-   設定されるプロパティは、プロパティ、 <xref:System.Windows.Freezable>いずれかの値として提供される、 <xref:System.Windows.FrameworkElement>または<xref:System.Windows.FrameworkContentElement>プロパティ、または<xref:System.Windows.Setter>値。  
+  
+ プロパティが設定されている必要がありますので、 <xref:System.Windows.DependencyProperty>または<xref:System.Windows.Freezable>プロパティには、ほとんどのプロパティの変更からに伝達する UI プロパティのシステム プロパティの変更 (動的なリソースが変更された値) が確認されているためです。 ほとんどのコントロールが場合に、コントロールの別のレイアウトを強制するロジックを含む、 <xref:System.Windows.DependencyProperty>変更し、プロパティがレイアウトに影響を与えます。 ただし、すべてのプロパティがある、 [DynamicResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)値としては、UI にリアルタイムで更新するように値を提供する保証されています。 機能をまだ異なりますによっては、プロパティ、またはアプリケーションの論理構造を所有する型だけでなく、プロパティによって異なります。  
+  
+<a name="stylesimplicitkeys"></a>   
+## <a name="styles-datatemplates-and-implicit-keys"></a>スタイル、Datatemplate、および暗黙的なキー  
+ 前に説明したように、すべての項目、 <xref:System.Windows.ResourceDictionary>キーを持っている必要があります。 ただし、いないわけでは、明示的なすべてのリソースがある必要があります`x:Key`します。 いくつかのオブジェクト型では、別のプロパティの値に関連付けられた、キー値をリソースとして定義されている場合、暗黙のキーをサポートします。 一方、暗黙のキーと呼ばれるは、この、`x:Key`属性は、明示的なキーです。 明示的なキーを指定することによって、暗黙のキーを上書きできます。  
+  
+ リソースの&1; つの非常に重要なシナリオは、定義する場合、<xref:System.Windows.Style>します。 実際には、<xref:System.Windows.Style>スタイルは本質的に再利用するためのものであるため、リソース ディクショナリのエントリとしてはほぼ常に定義します。 スタイルの詳細については、次を参照してください。[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)します。  
+  
+ コントロールのスタイル両方で作成して、暗黙のキーを使用して参照します。 コントロールの既定の外観を定義するテーマ スタイルは、この暗黙のキーに依存します。 それを要求の観点からは、暗黙のキーは、<xref:System.Type>コントロール自体のです。 リソースを定義するという観点から、暗黙のキーは、 <xref:System.Windows.Style.TargetType%2A>スタイルのです。 そのため、カスタム コントロール用のテーマを作成する場合、既存のテーマ スタイルを使用して対話するスタイルの作成する必要はありませんを指定する、 [X:key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)その<xref:System.Windows.Style>します。 テーマが適用されたスタイルを使用する場合は任意のスタイルを指定する必要はありません。 たとえば、次のスタイル定義の動作、にもかかわらず、<xref:System.Windows.Style>キーが存在するリソースは表示されません。  
+  
+ [!code-xml[FEResourceSH_snip#ImplicitStyle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FEResourceSH_snip/CS/page2.xaml#implicitstyle)]  
+  
+ あるスタイル実際には、キーが: 暗黙のキー `typeof(`<xref:System.Windows.Controls.Button>`)`します。 マークアップでは、指定することができます、 <xref:System.Windows.Style.TargetType%2A>の種類として直接という名前を (必要に応じて使用することができますか[{X:type...}](../../../../docs/framework/xaml-services/x-type-markup-extension.md) 返す、<xref:System.Type>します。  
+  
+ 使用される既定のテーマ スタイルのメカニズムを通じて[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、ランタイム スタイルのスタイルを適用する、 <xref:System.Windows.Controls.Button> ページで、場合でも、<xref:System.Windows.Controls.Button>自体を指定しません、<xref:System.Windows.FrameworkElement.Style%2A>プロパティまたはスタイルへの参照を特定のリソースです。 ページで定義されたスタイルについては、テーマ ディクショナリ スタイルには、同じキーを使用してテーマ ディクショナリのスタイルよりも前参照シーケンスの前にあります。 指定することだけ`<Button>Hello</Button>`任意の場所で、ページで定義されているスタイル<xref:System.Windows.Style.TargetType%2A>の`Button`はそのボタンに適用します。 同じ型の値を持つスタイルをキーできますも明示的にする場合は、 <xref:System.Windows.Style.TargetType%2A>、わかりやすくするため、マークアップでは省略可能です。  
+  
+ 場合、スタイルの暗黙的なキーは、コントロールに適用されません<xref:System.Windows.FrameworkElement.OverridesDefaultStyle%2A>は`true`(もなお<xref:System.Windows.FrameworkElement.OverridesDefaultStyle%2A>コントロール クラスではなく明示的に、コントロールのインスタンスのネイティブの動作の一部として設定することがあります)。 また、暗黙的なキーの派生クラスのシナリオをサポートするためにコントロールする必要がありますオーバーライド<xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> (の一部として提供されるすべての既存のコントロール[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]こう)。 スタイル、テーマ、およびコントロールのデザインの詳細については、次を参照してください。[スタイル設定可能なコントロールをデザインするためのガイドライン](../../../../docs/framework/wpf/controls/guidelines-for-designing-stylable-controls.md)します。  
+  
+ <xref:System.Windows.DataTemplate>暗黙のキーもあります。 に対して暗黙のキー、 <xref:System.Windows.DataTemplate>は、 <xref:System.Windows.DataTemplate.DataType%2A>プロパティの値。                  <xref:System.Windows.DataTemplate.DataType%2A>が明示的に使用するのではなく、型の名前として指定することも[{X:type...}](../../../../docs/framework/xaml-services/x-type-markup-extension.md). 詳細については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.ResourceDictionary>   
+ [アプリケーション リソース](../../../../docs/framework/wpf/advanced/optimizing-performance-application-resources.md)   
+ [リソースとコード](../../../../docs/framework/wpf/advanced/resources-and-code.md)   
+ [定義し、リソースを参照](../../../../docs/framework/wpf/advanced/how-to-define-and-reference-a-resource.md)   
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)   
+ [X:type マークアップ拡張機能](../../../../docs/framework/xaml-services/x-type-markup-extension.md)   
+ [StaticResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)   
+ [DynamicResource のマークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/advanced/xaml-syntax-in-detail.md b/docs/framework/wpf/advanced/xaml-syntax-in-detail.md
new file mode 100644
index 00000000000..db7462f1756
--- /dev/null
+++ b/docs/framework/wpf/advanced/xaml-syntax-in-detail.md
@@ -0,0 +1,331 @@
+---
+title: "XAML 構文の詳細 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XML 名前空間"
+  - "XAML 属性の解析"
+  - "解析 (属性の)"
+  - "XAML マークアップ拡張機能"
+  - "添付プロパティ"
+  - "タグ構文 [XAML]"
+  - "マークアップ拡張機能"
+  - "XAML オブジェクト要素構文"
+  - "XAML 構文用語"
+  - "添付イベント"
+  - "検索セマンティクス"
+  - "XAML では、アタッチされるイベント"
+  - "XAML では、コンテンツの構文"
+  - "XAML では、参照セマンティクス"
+  - "コンテンツ構文"
+  - "オブジェクト要素構文"
+  - "構文用語 [XAML]"
+  - "XAML では、添付プロパティ"
+  - "解析属性 [XAML]"
+  - "XAML では、タグ構文"
+  - "XAML 属性の構文"
+  - "プロパティ要素構文"
+  - "用語 [XAML]"
+  - "XML の名前空間"
+  - "属性構文 [XAML]"
+  - "XAML プロパティ要素構文"
+ms.assetid: 67cce290-ca26-4c41-a797-b68aabc45479
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# XAML 構文の詳細
+このトピックでは、XAML 構文の要素の説明に使用される用語を定義します。 これらの用語は、具体的には、XAML または System.Xaml レベルで XAML 言語のサポートを有効になっている基本的な XAML の概念を使用するその他のフレームワークも、このドキュメントでは WPF のドキュメントの両方の残りの部分でよく使用されます。 このトピックの展開」で説明する基本的な用語で[XAML の概要 (WPF)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)します。  
+  
+
+  
+<a name="the_xaml_language_specification"></a>   
+## <a name="the-xaml-language-specification"></a>XAML 言語仕様  
+ ここで定義されている XAML 構文の用語も定義されているか、XAML 言語仕様で参照されています。 XAML は XML に基づく言語に依存すると、XML の構造的な規則について詳しく説明します。 用語の一部から共有されてまたは、XML 言語または XML ドキュメント オブジェクト モデルを記述する場合によく使用する用語に基づきます。  
+  
+ XAML 言語仕様の詳細については、ダウンロード[ \[MS-XAML\] ](http://go.microsoft.com/fwlink/?LinkId=114525) Microsoft ダウンロード センターからです。  
+  
+<a name="xaml_and_clr"></a>   
+## <a name="xaml-and-clr"></a>XAML と CLR  
+ XAML は、マークアップ言語です。 [!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)]、その名前では、ランタイムの実行を有効にして、暗黙です。 XAML はないだけで、CLR ランタイムによって直接使用される一般的な言語のいずれかです。 代わりに、XAML の型システムをサポートするいると考えることができます。 WPF で使用される特定の XAML の解析システムは、CLR および CLR 型システムに基づいています。 XAML の型は、WPF の XAML が解析されるときに実行時の表現をインスタンス化する CLR 型にマップされます。 このため、このドキュメント内の構文のディスカッションの残りの部分は、XAML 言語仕様で同等の構文の説明がない場合でも、CLR 型システムへの参照を含まれます。 (個々 の XAML 言語仕様レベル XAML の型にマップすること、その他の型システムに、CLR のないが、作成してさまざまな XAML パーサーの使用を必要とします。)  
+  
+#### <a name="members-of-types-and-class-inheritance"></a>型のメンバーとクラスの継承  
+ プロパティおよびの XAML メンバーとして表示されるイベント、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]型が基本型から継承された多くの場合。 たとえば、次の例:`<Button Background="Blue" .../>`です。 <xref:System.Windows.Controls.Control.Background%2A>プロパティは、すぐに宣言されているプロパティで、<xref:System.Windows.Controls.Button>クラス、クラス定義、リフレクション結果またはドキュメントを確認した場合。 代わりに、<xref:System.Windows.Controls.Control.Background%2A>ベースから継承された<xref:System.Windows.Controls.Control>クラスです。  
+  
+ クラスの継承の動作の[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]XAML 要素が重要な従来の XML マークアップをスキーマによって適用されたに解釈します。 クラスの継承は中間の基本クラスは抽象クラスで特に場合、またはインターフェイスが含まれている場合、複雑になることができます。 これは、1 つの理由の XAML 要素およびその使用可能属性のセットが正確かつ完全には、スキーマ型を使用して表さ難しくに通常使用される[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)]プログラミングでは、DTD または XSD 形式などです。 別の原因としては、その機能を拡張し、XAML 言語自体の型のマッピング機能が使用可能な型とメンバーのすべての固定表現の完全性を妨げるものでいます。  
+  
+<a name="object_element_syntax"></a>   
+## <a name="object-element-syntax"></a>オブジェクト要素構文  
+ *オブジェクト要素構文*XML 要素を宣言することで、CLR クラスまたは構造体をインスタンス化する XAML マークアップ構文を示します。 この構文では、HTML など他のマークアップ言語の要素の構文に似ています。 オブジェクト要素構文は、左山かっこ (で始まる\<), followed immediately by the type name of the class or structure being instantiated. followed="" immediately="" by="" the="" type="" name="" of="" the="" class="" or="" structure="" being="">\</), followed immediately by the type name of the class or structure being instantiated.> 0 個以上のスペースは、型名、および&0; 個以上の属性が宣言されてもオブジェクト要素のそれぞれの属性名を分離する&1; つ以上のスペースを含む =「値」ペア。 最後は、次のいずれかの必要があります。  
+  
+-   要素とタグは、右の山かっこ (>) がすぐに続くフォワード スラッシュ (/) によって終了する必要があります。  
+  
+-   右の山かっこ (>) では、開始タグを完了する必要があります。 その他のオブジェクトの要素、プロパティ要素、または内部テキ ストは、開始タグをフォローできます。 要素のオブジェクト モデルによっては、どのようなコンテンツをここで含めることが正確には制限が通常されます。 対応するオブジェクトの要素のタグを終了する必要がありますも適切な入れ子でが存在し、その他の開始と終了タグのペアとのバランスをとる。  
+  
+ .NET に実装された XAML オブジェクト要素にプロパティまたはイベント、および XAML 名前空間を CLR 名前空間とアセンブリに属性の種類にマップするルールのセットがあります。 WPF と .NET Framework では、XAML オブジェクト要素にマップされる[!INCLUDE[TLA#tla_net](../../../../includes/tlasharptla-net-md.md)]型で定義されているが、アセンブリを参照し、属性、それらの型のメンバーにマップします。 XAML で CLR 型を参照するときにもその型の継承されたメンバーへのアクセスがあります。  
+  
+ たとえば、次の例は、オブジェクト要素構文の新しいインスタンスをインスタンス化する、<xref:System.Windows.Controls.Button>クラスし、も指定、<xref:System.Windows.FrameworkElement.Name%2A>属性とその属性の値。  
+  
+ [!code-xml[XAMLOvwSupport#SyntaxOE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#syntaxoe)]  
+  
+ 次の例は、XAML コンテンツ プロパティの構文を含むオブジェクト要素構文です。 含まれる内部のテキストを使用して設定することは、 <xref:System.Windows.Controls.TextBox> XAML のコンテンツ プロパティ<xref:System.Windows.Controls.TextBox.Text%2A>します。  
+  
+ [!code-xml[XAMLOvwSupport#ThisIsATextBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#thisisatextbox)]  
+  
+### <a name="content-models"></a>コンテンツ モデル  
+ クラスは、構文という点で、XAML オブジェクト要素としての使用方法をサポートする可能性がありますはその要素はのみ正しく機能のアプリケーションやページの全体的なコンテンツのモデルや要素ツリーの適切な位置に配置されている場合。 たとえば、 <xref:System.Windows.Controls.MenuItem>の子としてのみ配置通常、 <xref:System.Windows.Controls.Primitives.MenuBase>などのクラスを派生<xref:System.Windows.Controls.Menu>します。 コンテンツ コントロール、およびその他のクラスのページで、「解説」の一部として特定要素モデルが記載されている[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]XAML 要素として使用できるクラスです。  
+  
+<a name="properties_of_object_elements"></a>   
+## <a name="properties-of-object-elements"></a>オブジェクト要素のプロパティ  
+ XAML でのプロパティは、さまざまな構文で設定されます。 特定のプロパティの構文を使用できますが、に応じて変わりますを設定するプロパティの基になる型システムの特性。  
+  
+ プロパティの値を設定するには、機能や特性オブジェクトに追加するように、実行時のオブジェクト グラフ内に存在します。 オブジェクト要素から作成されたオブジェクトの初期状態は、既定のコンス トラクターの動作に基づきます。 通常、アプリケーションは、完全に既定のインスタンスの任意のオブジェクト以外に使用されます。  
+  
+<a name="attribute_syntax_properties"></a>   
+## <a name="attribute-syntax-properties"></a>属性構文 (プロパティ)  
+ 属性構文では、既存のオブジェクト要素の属性を宣言することで、プロパティの値を設定する XAML マークアップの構文です。 属性名は、関連するオブジェクトの要素をサポートするクラスのプロパティの CLR メンバー名と一致する必要があります。 属性名には、代入演算子 (=) が続きます。 属性値には、引用符で囲まれた文字列を指定する必要があります。  
+  
+> [!NOTE]
+>  代替の引用符を使用して、属性内のリテラル二重引用符を配置できます。 インスタンスの内部に二重引用符文字を含む文字列を宣言するのに手段として単一引用符を使用できます。 一重または二重引用符を使用するかどうかは、属性値の文字列を開いたり、閉じたりするため、一致するペアを使用してください。 ありますエスケープ シーケンスやその他の手法によって XAML の構文の特定の文字制限を回避するために使用できます。 参照してください[XML 文字エンティティと XAML](../../../../docs/framework/xaml-services/xml-character-entities-and-xaml.md)します。  
+  
+ 属性構文で設定するためにプロパティはパブリックであることし、書き込み可能である必要があります。 バッキング型のシステムのプロパティの値は、値型である必要があります。 または必要がある参照型をインスタンス化されたか、関連するアクセスするときに、XAML プロセッサによって参照されることができますバックアップの種類。  
+  
+ WPF XAML イベント属性名として参照されているイベントではパブリックであるおよびパブリック デリゲートを用意する必要があります。  
+  
+ プロパティまたはイベント クラスまたはオブジェクトのコンテナーの要素によってインスタンス化される構造体のメンバーである必要があります。  
+  
+### <a name="processing-of-attribute-values"></a>属性値の処理  
+ 開始タグと終わりの引用符内に含まれる文字列値は、XAML プロセッサによって処理されます。 プロパティの場合は、既定の処理動作を基になる CLR プロパティの型によって決まります。  
+  
+ 属性の値が、次のいずれかで埋められた次の処理順序を使用します。  
+  
+1.  XAML プロセッサは、中かっこ、またはから派生するオブジェクト要素が発生すると<xref:System.Windows.Markup.MarkupExtension>し、参照先のマークアップ拡張機能が最初に評価を文字列として値の処理ではなく、およびマークアップ拡張機能によって返されるオブジェクトは、値として使用します。 多くの場合は、マークアップ拡張機能によって返されるオブジェクトを既存のオブジェクトまたは実行時まで評価されないし、新しくインスタンス化されたオブジェクトではない式への参照となります。  
+  
+2.  プロパティが宣言されている場合、属性付きで<xref:System.ComponentModel.TypeConverter>、またはそのプロパティの値の型が宣言されると、属性付き<xref:System.ComponentModel.TypeConverter>属性の文字列値が変換の入力として、型コンバーターに送信され、コンバーターは、新しいオブジェクト インスタンスを返します。  
+  
+3.  ある場合ない<xref:System.ComponentModel.TypeConverter>プロパティの型への直接変換が試行されます。 この最後のレベルは、XAML 言語プリミティブ型、または (パーサーは、一致する値をその後、アクセス) 列挙型の名前付き定数の名前のチェックの間のパーサー ネイティブ値に直接変換です。  
+  
+#### <a name="enumeration-attribute-values"></a>列挙属性値  
+ XAML での列挙は、XAML パーサーで本質的に処理され、列挙型の名前付き定数のいずれかの文字列名を指定することで列挙体のメンバーを指定する必要があります。  
+  
+ フラグ列挙値の場合は、ネイティブな動作は、属性値の文字列を処理し、列挙値のいずれかに解決です。 形式の列挙型を指定しない*列挙*.*値*コードで行うようにします。 代わりに、だけを指定する*値*、および*列挙*を設定するプロパティの型により推測されます。 内の属性を指定する場合、*列挙*.*値*フォームに正しく解決されません。  
+  
+ フラグ列挙体の動作に基づく、 <xref:System.Enum.Parse%2A?displayProperty=fullName>メソッドです。 フラグ列挙体の複数の値は、それぞれの値をコンマで区切って指定できます。 ただし、フラグはない列挙値を組み合わせることはできません。 たとえば、コンマ構文を使用して作成しようとすることはできません、<xref:System.Windows.Trigger>フラグ列挙体の複数の条件に機能します。  
+  
+```  
+<!--This will not compile, because Visibility is not a flagwise enumeration.-->  
+...  
+<Trigger Property="Visibility" Value="Collapsed,Hidden">  
+  <Setter ... />  
+</Trigger>  
+...  
+```  
+  
+ XAML で設定できる属性をサポートするフラグ列挙体では、WPF ではまれです。 ただし、このような&1; つの列挙は<xref:System.Windows.Media.StyleSimulations>です。 「解説」に示した例を変更するフラグの属性をコンマで区切られた構文を使用するなど、<xref:System.Windows.Documents.Glyphs>クラスです。`StyleSimulations = "BoldSimulation"`なる`StyleSimulations = "BoldSimulation,ItalicSimulation"`します。 <xref:System.Windows.Input.KeyBinding.Modifiers%2A?displayProperty=fullName>別のプロパティでは、1 つ以上の列挙値を指定できます。 ただし、このプロパティがである特殊なケースであるため、<xref:System.Windows.Input.ModifierKeys>列挙体は、独自の型コンバーターをサポートしています。 修飾子の型コンバーターは、プラス記号 (+) をコンマ (,) ではなく、区切り記号として使用します。 この変換には、"Ctrl + Alt"などの Microsoft Windows プログラミングではキーの組み合わせを表す従来の構文がサポートしています。  
+  
+### <a name="properties-and-event-member-name-references"></a>プロパティおよびイベント メンバー名の参照  
+ 属性を指定する場合は、任意のプロパティまたはオブジェクトのコンテナー要素にインスタンス化された CLR 型のメンバーとして存在するイベントを参照できます。  
+  
+ また、添付プロパティを参照できるや、アタッチされるイベントの格納オブジェクト要素に依存しません。 (添付プロパティは、後のセクションで説明しますが)。  
+  
+ 使用して既定の名前空間を介してアクセス可能なすべてのオブジェクトからイベントを名前も、 *typeName*.*イベント*部分修飾名。 ルーティング イベントのハンドラーのアタッチをサポートしていますが、子要素、親要素からルーティング イベントを処理するハンドラーは、ここでがないイベントのメンバー テーブルにこの構文です。 この構文には、アタッチされるイベントの構文が似ていますが、イベントをここでは、true アタッチされるイベントではありません。 代わりに、修飾名を持つイベントを参照しています。 詳細については、次を参照してください。[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)します。  
+  
+ シナリオによっては、プロパティ名が属性名ではなく、属性の値として提供される場合があります。 プロパティ名では、フォームで指定されたプロパティなどの修飾子を含めることも*ownerType*.*dependencyPropertyName*します。 スタイルまたはテンプレートを XAML に書き込むときに、このシナリオが一般的です。 属性値として指定したプロパティ名の処理規則では、仕様が異なると、設定されるプロパティのタイプまたは特定の WPF サブシステムの動作によって制御されます。 詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)します。  
+  
+ プロパティ名の他の使用方法は、属性値は、プロパティ間のリレーションシップを記述するときにです。 この機能は、データ バインドとストーリー ボードのターゲットに使用されで有効になって、 <xref:System.Windows.PropertyPath>クラスとその型コンバーター。 検索セマンティクスの詳細については、次を参照してください。 [PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md)します。  
+  
+<a name="property_element_syntax"></a>   
+## <a name="property-element-syntax"></a>プロパティ要素構文  
+ *プロパティ要素構文*やや要素の基本的な XML 構文規則から逸脱した構文です。 XML では、属性の値は、事実上文字列、可能なバリエーション文字列エンコード方式が使用されているです。 XAML では、他のオブジェクト要素のプロパティの値であることを割り当てることができます。 この機能は、プロパティ要素構文は有効です。 要素のタグ内の属性として指定されているプロパティではなく、プロパティが指定されて、開始要素を使用してタグに*elementTypeName*.*propertyName*フォーム内で、プロパティの値が指定されているし、property 要素が閉じられます。  
+  
+ 構文は、左山かっこ (始め具体的には、\<), followed immediately by the type name of the class or structure that the property element syntax is contained within. followed="" immediately="" by="" the="" type="" name="" of="" the="" class="" or="" structure="" that="" the="" property="" element="" syntax="" is="" contained="">\</), followed immediately by the type name of the class or structure that the property element syntax is contained within.> これの直後&1; つのドット (.) し、プロパティの名前で、右の山かっこ (>)。 属性構文と同様、そのプロパティは、指定した型の宣言されたパブリック メンバーに配置する必要があります。 プロパティに割り当てられる値は、property 要素に含まれます。 通常、値が、1 つ以上のオブジェクトの要素を指定した、アドレス プロパティ要素構文は、シナリオは、値としてオブジェクトを指定するためです。 最後に、同じを指定することと同等の終了タグ*elementTypeName*.*propertyName*適切な入れ子や他の要素タグとのバランスがでの組み合わせを指定する必要があります。  
+  
+ 次のプロパティ要素構文は、たとえば、 <xref:System.Windows.FrameworkElement.ContextMenu%2A>のプロパティ、<xref:System.Windows.Controls.Button>します。  
+  
+ [!code-xml[XAMLOvwSupport#ContextMenu](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#contextmenu)]  
+  
+ プロパティ要素内の値できますとして指定することで指定されているプロパティの型がプリミティブ値型の場合の内部テキ ストなど<xref:System.String>、または名前が指定されている列挙します。 シンプルな属性構文を使用する可能性がありますもこれらの各ケースがあるために、2 つの用法は、それほど一般的ではありません。 XAML コンテンツ プロパティではありませんが、UI テキストの表示のために使用されるプロパティは文字列にプロパティ要素をシナリオの&1; つあり、改行などの特殊な空白要素はその UI テキストに表示するために必要な。 属性構文は、改行を保持できません。 が有意の空白の維持がアクティブな場合に限り、プロパティ要素構文ができます (詳細については、「 [XAML で空白の処理](../../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md))。 別のシナリオはように[X:uid ディレクティブ](../../../../docs/framework/xaml-services/x-uid-directive.md)プロパティ要素に適用されることができ、そのため、WPF のローカライズ必要がある値の出力 BAML またはその他の手法によって内の値をマークします。  
+  
+ Property 要素は、WPF の論理ツリーには表示されません。 Property 要素は、プロパティを設定するため特定の構文だけであり、インスタンスまたはオブジェクトを持つ要素ではありません。 (論理ツリーの概念の詳細については、「 [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)。)  
+  
+ プロパティの属性とプロパティの両方の要素の構文がサポートされている場合、2 種類の構文では、構文の空白の処理などの細かい点が多少異なる場合が同じ結果が一般にいます。  
+  
+<a name="collection_syntax"></a>   
+## <a name="collection-syntax"></a>コレクション構文  
+ XAML 仕様書には、XAML プロセッサ実装で、値の型がコレクションのプロパティを識別する必要があります。 .NET での一般的な XAML プロセッサ実装はマネージ コードと、CLR に基づいており、次のいずれかの方法でコレクション型を識別します。  
+  
+-   入力を実装して<xref:System.Collections.IList>します。  
+  
+-   入力を実装して<xref:System.Collections.IDictionary>します。  
+  
+-   型から派生して<xref:System.Array>(XAML で配列の概要の詳細については、次を参照してください[X:array のマークアップ拡張機能](../Topic/x:Array%20Markup%20Extension.md)。)。  
+  
+ プロパティの型がコレクションの場合、推論されるコレクション型をマークアップには、object 要素として指定する必要はありません。 代わりに、コレクション内の項目となる要素はプロパティ要素の&1; つまたは複数の子要素として指定します。 それらの各項目が読み込み時にオブジェクトを評価し、呼び出すことによって、コレクションに追加、`Add`の暗黙的なコレクション メソッド。 たとえば、<xref:System.Windows.Style.Triggers%2A>プロパティの<xref:System.Windows.Style>は特殊なコレクション型を受け取り<xref:System.Windows.TriggerCollection>を実装する<xref:System.Collections.IList>します。 インスタンスを作成する必要はありません、 <xref:System.Windows.TriggerCollection>マークアップ内のオブジェクト要素。 代わりに、1 つまたは複数を指定<xref:System.Windows.Trigger>項目内の要素として、`Style.Triggers`プロパティ要素で<xref:System.Windows.Trigger> (または派生クラス) は厳密に型指定されたと暗黙的な項目の種類として期待される型です。 <xref:System.Windows.TriggerCollection>します。  
+  
+ [!code-xml[XAMLOvwSupport#SyntaxPECollection](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/Page1.xaml#syntaxpecollection)]  
+  
+ プロパティは、コレクション型とその型の XAML コンテンツ プロパティの両方になる場合があり、派生型は、このトピックの次へ セクションで説明します。  
+  
+ 暗黙的コレクションの要素は、マークアップで要素としては表示しない場合でも、論理ツリーで表されたメンバーを作成します。 通常親の型のコンス トラクターは、そのプロパティの&1; つであるコレクションのインスタンス化を実行し、最初に空のコレクションのオブジェクト ツリーの一部になります。  
+  
+> [!NOTE]
+>  ジェネリック リストおよび辞書インターフェイス (<xref:System.Collections.Generic.IList%601>と<xref:System.Collections.Generic.IDictionary%602>) コレクションの検出はサポートされていません\</TKey, TValue>。 ただし、使用することができます、<xref:System.Collections.Generic.List%601>クラスの基本クラスとして実装しているため<xref:System.Collections.IList>を直接または<xref:System.Collections.Generic.Dictionary%602>基底クラスとして実装しているため<xref:System.Collections.IDictionary>直接\</TKey, TValue>。  
+  
+ コレクション型の .NET のリファレンス ページをコレクションのオブジェクト要素の意図的に省略は、この構文はときどき XAML 構文セクションで暗黙の型のコレクション構文として説明します。  
+  
+ ルート要素を除き、本当に、次の場合の一方または両方にある要素に別の要素の子要素として入れ子になっている XAML ファイル内のすべてのオブジェクト要素: 親要素、または親要素 (XAML コンテンツ プロパティは、後のセクションで説明) の XAML コンテンツ プロパティの値を指定する要素の暗黙的なコレクション プロパティのメンバーです。 つまり、親要素とマークアップ ページ内の子要素のリレーションシップはルートで、1 つのオブジェクトと、ルートの直下にすべてのオブジェクト要素は、親のプロパティ値を提供する&1; つのインスタンスまたは親のコレクション型プロパティ値になっているコレクション内の項目のいずれかです。 このシングル ルート概念、xml に共通で、XAML を読み込むなどの Api の動作の頻度がより強化<xref:System.Windows.Markup.XamlReader.Load%2A>します。  
+  
+ 次の例は、コレクションのオブジェクト要素構文 (<xref:System.Windows.Media.GradientStopCollection>) を明示的に指定します。  
+  
+```xaml  
+<LinearGradientBrush>  
+  <LinearGradientBrush.GradientStops>  
+    <GradientStopCollection>  
+      <GradientStop Offset="0.0" Color="Red" />  
+      <GradientStop Offset="1.0" Color="Blue" />  
+    </GradientStopCollection>  
+  </LinearGradientBrush.GradientStops>  
+</LinearGradientBrush>  
+```  
+  
+ ある常に、コレクションを明示的に宣言することに注意してください。 インスタンスを宣言しよう<xref:System.Windows.TriggerCollection>前に示したで明示的に<xref:System.Windows.Style.Triggers%2A>の例は失敗します。 コレクションを明示的に宣言するには、コレクション クラスで既定のコンス トラクターがサポートしている必要があり、 <xref:System.Windows.TriggerCollection>既定のコンス トラクターがありません。  
+  
+<a name="xaml_content_properties"></a>   
+## <a name="xaml-content-properties"></a>XAML コンテンツ プロパティ  
+ XAML コンテンツ構文は、指定のクラスにのみ有効になっている構文、 <xref:System.Windows.Markup.ContentPropertyAttribute>クラス宣言の一部として。 <xref:System.Windows.Markup.ContentPropertyAttribute>要素 (派生クラスを含む) の種類のコンテンツ プロパティは、プロパティ名を参照します。 XAML プロセッサによって処理されるときにすべての子要素またはタグと終了タグのオブジェクト要素の間にある内部のテキストは、そのオブジェクトの XAML コンテンツ プロパティの値に割り当てるされます。 コンテンツ プロパティの明示的なプロパティ要素を指定する権限を持っているが、この使用法は、通常 XAML 構文セクションでは、.NET のリファレンスでは表示されません。 明示的な詳細な方法がマークアップわかりやすくするため、またはマークアップのスタイルの問題が、通常コンテンツ プロパティの目的は、親-子として直感的に関連する要素は、直接できます入れ子になったため、マークアップを効率化します。 要素の他のプロパティのプロパティ要素タグが厳密な XAML 言語定義ごとには、"content"に割り当てられていません。これらは、XAML パーサーの処理順序で以前に処理され、「コンテンツ」であると見なされないします。  
+  
+### <a name="xaml-content-property-values-must-be-contiguous"></a>XAML コンテンツ プロパティの値が連続している必要があります。  
+ XAML のコンテンツ プロパティの値は、そのオブジェクト要素の前に、またはその他のすべてのプロパティ要素の後、指定する必要があります。 これは、文字列、または&1; つまたは複数のオブジェクトとして、XAML コンテンツ プロパティの値が指定されているかどうかに当てはまります。 たとえば、次のマークアップは解析されません。  
+  
+```  
+<Button>I am a   
+  <Button.Background>Blue</Button.Background>  
+  blue button</Button>  
+```  
+  
+ これは基本的には正しくない場合はこの構文は、コンテンツ プロパティのプロパティ要素構文を使用して明示的に行われた、し、コンテンツのプロパティが&2; 回設定するため。  
+  
+```  
+<Button>  
+  <Button.Content>I am a </Button.Content>  
+  <Button.Background>Blue</Button.Background>  
+  <Button.Content> blue button</Button.Content>  
+</Button>  
+```  
+  
+ 同様に不正な例では、コンテンツのプロパティは、コレクションと、子要素のプロパティ要素が混じっているかどうかを示します。  
+  
+```  
+<StackPanel>  
+  <Button>This example</Button>  
+  <StackPanel.Resources>  
+    <SolidColorBrush x:Key="BlueBrush" Color="Blue"/>  
+  </StackPanel.Resources>  
+  <Button>... is illegal XAML</Button>  
+</StackPanel>  
+```  
+  
+<a name="content_properties_and_collection_syntax_combined"></a>   
+## <a name="content-properties-and-collection-syntax-combined"></a>コンテンツ プロパティとコレクション構文の組み合わせ  
+ そのまま使用するために複数のコンテンツとして&1; つのオブジェクト要素コンテンツのプロパティの型必要があります具体的にはコレクション型であります。 コレクション型のプロパティ要素構文と同様に、XAML プロセッサ必要がありますによって型が識別コレクション型。 要素に XAML コンテンツ プロパティがあり、ユーザーが XAML コンテンツ プロパティの型がコレクションは、暗黙的なコレクション型はオブジェクト要素としてのマークアップで指定する必要はありませんし、XAML コンテンツ プロパティがプロパティ要素として指定する必要はありません。 したがって、マークアップで明らかなコンテンツ モデル今すぐ複数の子要素がコンテンツとして割り当てられていることができます。 コンテンツの構文を次に、<xref:System.Windows.Controls.Panel>クラスを派生します。 すべて<xref:System.Windows.Controls.Panel>派生クラスを確立する XAML のコンテンツ プロパティ<xref:System.Windows.Controls.Panel.Children%2A>、型の値がありますが、 <xref:System.Windows.Controls.UIElementCollection>します。  
+  
+ [!code-xml[XAMLOvwSupport#SyntaxContent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page5.xaml#syntaxcontent)]  
+  
+ 注意してくださいのいずれのプロパティ要素の<xref:System.Windows.Controls.Panel.Children%2A>の要素も、 <xref:System.Windows.Controls.UIElementCollection>マークアップに必要なです。 XAML のデザイン機能は、再帰的に定義する要素が含まれているようにこれは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]より直感的にせず、介在するプロパティ要素のタグまたはコレクション オブジェクトの直接の親と子要素の関係を持つ入れ子になった要素のツリーとして表現されます。 実際には、 <xref:System.Windows.Controls.UIElementCollection>では指定できない明示的にマークアップでオブジェクト要素としてデザインします。 その唯一の用途を暗黙の型のコレクションとして<xref:System.Windows.Controls.UIElementCollection>パブリックの既定のコンス トラクターを公開しないと、そのため、オブジェクト要素としてインスタンス化できることはできません。  
+  
+### <a name="mixing-property-elements-and-object-elements-in-an-object-with-a-content-property"></a>プロパティ要素とコンテンツのプロパティを持つオブジェクトのオブジェクト要素の混在  
+ XAML 仕様書では、オブジェクト要素内の XAML コンテンツ プロパティが使用されているオブジェクトの要素が、連続する必要があり、混在させないでください XAML プロセッサが実施できることを宣言します。 プロパティ要素とコンテンツを混在させると、この制限が適用される、 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] XAML プロセッサ。  
+  
+ オブジェクトの子要素は、object 要素内の最初の即時マークアップとして設定できます。 プロパティ要素を導入できます。 または、1 つまたは複数のプロパティ要素では、コンテンツ、プロパティの多くの要素を指定することができます。 Property 要素コンテンツに依存して、さらにそのコンテンツを導入することはできません、のみプロパティ要素を追加することができます。  
+  
+ このコンテンツ]、[プロパティ要素の順序の要件は、コンテンツとして使用される内部のテキストには適用されません。 ただし、有意の空白はプロパティ要素の内部テキ ストが混じって場合は、マークアップで視覚的に検出が困難になるために、内部テキ ストの連続したを保持するマークアップのスタイルではまだです。  
+  
+<a name="xaml_namespaces"></a>   
+## <a name="xaml-namespaces"></a>XAML 名前空間  
+ 上記の構文例は、既定の XAML 名前空間以外の XAML 名前空間を指定します。 一般的な[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーション、既定の XAML 名前空間が指定されている、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]名前空間。 既定の XAML 名前空間以外の XAML 名前空間を指定し、同様の構文を使用できます。 次に、任意の場所ではという名前のクラスは、既定の XAML 名前空間内でアクセスできないクラス名にする必要がありますの前に、XAML 名前空間のプレフィックスように対応する CLR 名前空間にマップします。 たとえば、`<custom:Example/>`のインスタンスをインスタンス化するオブジェクト要素構文は、`Example`クラス、そのクラス (および場合によってはバッキング型を含む外部アセンブリ情報) を含む CLR 名前空間を以前に割り当てられて、`custom`プレフィックス。  
+  
+ XAML 名前空間の詳細については、次を参照してください。 [XAML 名前空間および WPF XAML のマッピング情報 Namespace](../../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)します。  
+  
+<a name="markup_extensions"></a>   
+## <a name="markup-extensions"></a>マークアップ拡張機能  
+ XAML では、通常 XAML プロセッサの処理は、文字列の属性値またはオブジェクトの要素からエスケープが有効にし、バッキング クラスに処理を延期するエンティティのプログラミング、マークアップ拡張機能を定義します。 中かっこ ({})、右中かっこ (}) 以外の文字で後に、属性の構文を使用するときに xaml マークアップ拡張機能を識別する文字。 中かっこの後の最初の文字列には、その部分文字列が真のクラス名の一部である場合、特定の拡張機能の動作は、参照が、部分文字列を含めない場合があります"Extension"を提供するクラスを参照する必要があります。 その後は単一の空白は見えますが、し、各文字を含めるが入力として使用拡張機能の実装で右中かっこが検出されるまでです。  
+  
+ .NET XAML の実装を使用して、<xref:System.Windows.Markup.MarkupExtension>でサポートされているマークアップ拡張機能のすべての基礎として抽象クラス[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]だけでなく他のフレームワークやテクノロジです。 マークアップ拡張機能を[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]具体的には実装が他の既存のオブジェクトを参照するか、実行時に評価されるオブジェクトへの遅延の参照を作成する手段を提供する多くの場合、対象としています。 指定して単純な WPF データ バインドを行うなど、`{Binding}`通常受け取る特定のプロパティ値の代わりに、マークアップ拡張機能です。 WPF のマークアップ拡張機能の多くには、プロパティが属性構文を利用できないための属性構文が有効にします。 たとえば、<xref:System.Windows.Style>オブジェクトは、比較的複雑な型を入れ子になった一連のオブジェクトとプロパティを含みます。 WPF のスタイルでは、通常のリソースとして定義、 <xref:System.Windows.ResourceDictionary>リソースを要求 WPF マークアップの&2; つの拡張機能のいずれかを使用し、参照します。 マークアップ拡張機能リソースの検索対象のプロパティ値の評価されないしの値を提供できるように、<xref:System.Windows.FrameworkElement.Style%2A>プロパティには、型を取得<xref:System.Windows.Style>で、属性の構文例を次に示します。  
+  
+ `<Button Style="{StaticResource MyStyle}">My button</Button>`  
+  
+ ここでは、`StaticResource`を識別、 <xref:System.Windows.StaticResourceExtension>マークアップ拡張機能の実装を提供するクラス。 次の文字列`MyStyle`は、既定以外の入力として使用<xref:System.Windows.StaticResourceExtension>コンス トラクター、拡張子の文字列から取得したようにパラメーターが要求されたコマンドを宣言<xref:System.Windows.ResourceKey>します。 `MyStyle`できると予想される、 [X:key](../../../../docs/framework/xaml-services/x-key-directive.md)の値、<xref:System.Windows.Style>リソースとして定義します。 [StaticResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)使用状況が提供する、リソースが使用することを要求、<xref:System.Windows.Style>の読み込み時に静的リソースの検索ロジックを使用してプロパティ値です。  
+  
+ マークアップ拡張機能の詳細については、次を参照してください。[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)します。 マークアップ拡張機能とプログラミング機能の全般的な .NET XAML 実装で有効になっている他の XAML の参照を次を参照してください[XAML Namespace (x:)。言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)です。 WPF 固有のマークアップ拡張機能を参照してください。 [WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)です。  
+  
+<a name="attached_properties"></a>   
+## <a name="attached-properties"></a>アタッチされるプロパティ  
+ 添付プロパティは XAML のプロパティを所有しているし、特定の型によって定義されたそれによってで導入されたプログラミングの概念上の任意の要素が属性または要素のプロパティとして設定します。 主なシナリオは、すべての要素の間で広範囲に共有されたオブジェクト モデルを必要とせず、親要素に情報を報告するためのマークアップ構造内の子要素を有効にするのには、添付プロパティを意図しています。 逆に、添付プロパティは、子要素に情報をレポートする親要素によって使用できます。 アタッチされたプロパティと、独自に作成する方法の目的に関する詳細については、プロパティを接続を参照してください。[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)します。  
+  
+ 添付プロパティは、表面的プロパティ要素構文に似た構文を使用で指定することも、 *typeName*.*propertyName*の組み合わせ。 次の&2; つの重要な違いがあります。  
+  
+-   使用することができます、 *typeName*.*propertyName*属性構文で添付プロパティを設定した場合でもの組み合わせ。 添付プロパティは、だけ大文字と小文字プロパティ名を修飾するが属性構文の要件です。  
+  
+-   添付プロパティのプロパティ要素構文を使用することもできます。 ただし、一般的なプロパティ要素構文について、 *typeName*プロパティ要素が含まれるオブジェクトの要素を指定します。 添付プロパティを参照している場合、 *typeName*オブジェクト要素ではなく、添付プロパティを定義するクラスです。  
+  
+<a name="attached_events"></a>   
+## <a name="attached-events"></a>アタッチされるイベント  
+ アタッチされるイベントは、イベントは、特定の種類で定義できますが、オブジェクト要素のハンドラーが接続されている XAML で導入されたもう&1; つのプログラミング概念です。 WOF 実装では多くの場合、アタッチされるイベントを定義する型は、サービスを定義する静的な型と、アタッチされるイベントが、ルーティングされたイベントでの別名、サービスを公開する型によって公開される場合があります。 アタッチされるイベントのハンドラーは、属性構文で指定します。 アタッチされるイベントを許可するようにアタッチされるイベントの属性の構文を展開、 *typeName*.*eventName*使用法、場所*typeName*を提供するクラスは、`Add`と`Remove`、アタッチされるイベント インフラストラクチャのためのイベント ハンドラーのアクセサーと*eventName*イベントの名前を指定します。  
+  
+<a name="anatomy_of_a_xaml_page_root_element"></a>   
+## <a name="anatomy-of-a-xaml-root-element"></a>XAML ルート要素の構造  
+ 次の表は、一般的な XAML ルート要素は、のルート要素の特定の属性の表示を示しています。  
+  
+|||  
+|-|-|  
+|`<Page`|ルート要素の開始オブジェクト要素|  
+|`xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"`|既定値 ([!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]) の XAML 名前空間|  
+|`xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`|XAML 言語の XAML 名前空間|  
+|`x:Class="ExampleNamespace.ExampleCode"`|部分クラスに対して定義されているマークアップを分離コードに接続する部分クラス宣言|  
+|`>`|ルートのオブジェクト要素の終了。 要素には、子要素が含まれているためオブジェクトがまだ閉じていません。|  
+  
+<a name="optional_and_nonrecommended_xaml_usages"></a>   
+## <a name="optional-and-nonrecommended-xaml-usages"></a>オプションであり、非推奨の XAML の使用方法  
+ 次のセクションでは、技術的には、XAML プロセッサでサポートされているが、詳細度またはその他の美しさ妨げになる問題時期を人間が判読できる残りの XAML ファイルを生成する XAML の使用方法を説明する、XAML ソースを含むアプリケーションを開発します。  
+  
+### <a name="optional-property-element-usages"></a>省略可能なプロパティ要素の使用方法  
+ 省略可能なプロパティ要素の使用状況には、XAML プロセッサが暗黙の型が判断した要素のコンテンツ プロパティを明示的に記述が含まれます。 内容を宣言する場合など、 [] メニューの <xref:System.Windows.Controls.Menu>を明示的に宣言することもできます、<xref:System.Windows.Controls.ItemsControl.Items%2A>のコレクション、<xref:System.Windows.Controls.Menu>として、`<Menu.Items>`プロパティ要素のタグおよび配置<xref:System.Windows.Controls.MenuItem>内で`<Menu.Items>`、暗黙的な XAML プロセッサの動作を使用するのではなくのすべての子要素、 [] メニューの <xref:System.Windows.Controls.Menu>する必要があります、 <xref:System.Windows.Controls.MenuItem>に配置し、<xref:System.Windows.Controls.ItemsControl.Items%2A>コレクションです。 省略可能な使用法は視覚的に、マークアップで表されるオブジェクトの構造が明確にできます。 または、明示的なプロパティ要素の使用が技術的には、属性値内での入れ子になったマークアップ拡張機能など、視覚的に混乱しますが、機能するマークアップを回避することがあります。  
+  
+### <a name="full-typenamemembername-qualified-attributes"></a>完全 typeName.memberName 属性の修飾  
+ The *typeName*.*memberName*フォーム ルーティング イベントの場合だけより汎用的な属性が実際に機能します。 他の状況でそのフォーム不要で、マークアップのスタイルや読みやすさの原因のためだけを避ける必要があります。 参照、3 つ以下の例では、<xref:System.Windows.Controls.Control.Background%2A>属性が完全に等価です。  
+  
+ [!code-xml[XAMLOvwSupport#TypeNameProp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#typenameprop)]  
+  
+ `Button.Background`有効でプロパティの修飾参照<xref:System.Windows.Controls.Button>が成功した (<xref:System.Windows.Controls.Control.Background%2A>コントロールから継承された) と<xref:System.Windows.Controls.Button>はオブジェクト要素のクラスまたは基本クラスです。 `Control.Background`ので、<xref:System.Windows.Controls.Control>クラスは実際には、定義<xref:System.Windows.Controls.Control.Background%2A>と<xref:System.Windows.Controls.Control>は、<xref:System.Windows.Controls.Button>基本クラスです。  
+  
+ ただし、次*typeName*.*memberName* form の例は行われず、コメントがあるため表示されます。  
+  
+ [!code-xml[XAMLOvwSupport#TypeNameBadProp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#typenamebadprop)]  
+  
+ <xref:System.Windows.Controls.Label>の別の派生クラスは、<xref:System.Windows.Controls.Control>、指定した場合と`Label.Background`内で、<xref:System.Windows.Controls.Label>オブジェクト要素の場合は、この使用法が機能します。 ただし、ため<xref:System.Windows.Controls.Label>クラスまたは基本クラスではない<xref:System.Windows.Controls.Button>は、指定した XAML プロセッサの動作を処理し、`Label.Background`添付プロパティとして。 `Label.Background`使用可能な添付プロパティではなく、この使用法が失敗しました。  
+  
+### <a name="basetypenamemembername-property-elements"></a>baseTypeName.memberName プロパティ要素  
+ 方法と同様の方法で、 *typeName*.*memberName*属性構文では、フォームの動作、*関連付ける*.*memberName*構文のプロパティ要素構文に動作します。 たとえば、次の構文が動作します。  
+  
+ [!code-xml[XAMLOvwSupport#GoofyPE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XAMLOvwSupport/CSharp/page8.xaml#goofype)]  
+  
+ ここでは、property 要素は、として指定された`Control.Background`に property 要素が含まれている場合でも`Button`します。  
+  
+ 同じですが、 *typeName*.*memberName*属性で、フォーム*関連付ける*.*memberName*マークアップでは、スタイルは、これを避ける必要があります。  
+  
+## <a name="see-also"></a>関連項目  
+ [XAML の概要 (WPF)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [XAML Namespace (x:)言語機能](../../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)   
+ [WPF XAML 拡張機能](../../../../docs/framework/wpf/advanced/wpf-xaml-extensions.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)   
+ [TypeConverters および XAML](../../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)   
+ [XAML と WPF のカスタム クラス](../../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/TOC.md b/docs/framework/wpf/app-development/TOC.md
new file mode 100644
index 00000000000..7cbe14c2b44
--- /dev/null
+++ b/docs/framework/wpf/app-development/TOC.md
@@ -0,0 +1,46 @@
+# [Visual Studio を構成して Web サービスを呼び出す XAML ブラウザー アプリケーションをデバッグする](configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md)
+# [方法のトピック](navigation-how-to-topics.md)
+# [GetCustomUI](getcustomui.md)
+# [WPF のウィンドウ](windows-in-wpf-applications.md)
+# [スプラッシュ スクリーンを WPF アプリケーションに追加する](how-to-add-a-splash-screen-to-a-wpf-application.md)
+# [IWpfHostSupport](iwpfhostsupport.md)
+# [IEnumRAWINPUTDEVIC:Skip](ienumrawinputdevic-skip.md)
+# [WPF アプリケーションを配置するように IIS 5.0 および IIS 6.0 を構成する](how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md)
+# [GetRawInputDevices](getrawinputdevices.md)
+# [方法のトピック](how-to-topics.md)
+# [WPF アプリケーションのビルド](building-a-wpf-application-wpf.md)
+# [ページ関数を呼び出す](how-to-call-a-page-function.md)
+# [インストールされている WPF のバージョンを確認する](how-to-determine-the-installed-version-of-wpf.md)
+# [IEnumRAWINPUTDEVICE](ienumrawinputdevice.md)
+# [方法のトピック](build-and-deploy-how-to-topics.md)
+# [ページ関数から戻る](how-to-return-from-a-page-function.md)
+# [ナビゲーションの概要](navigation-overview.md)
+# [UI であるアドインを作成する](how-to-create-an-add-in-that-is-a-ui.md)
+# [.NET Framework 3.5 がインストールされているかどうかの確認](how-to-detect-whether-the-net-framework-3-5-is-installed.md)
+# [WPF のブラウザーのホスト処理をサポートするネイティブ API](native-wpf-browser-hosting-support-apis.md)
+# [.NET Framework 3.0 がインストールされているかどうかの確認](how-to-detect-whether-the-net-framework-3-0-is-installed.md)
+# [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](wpf-application-resource-content-and-data-files.md)
+# [ページ関数の戻り値を取得する](how-to-get-the-return-value-of-a-page-function.md)
+# [WPF ウィンドウの概要](wpf-windows-overview.md)
+# [IEnumRAWINPUTDEVIC:Reset](ienumrawinputdevic-reset.md)
+# [Firefox に対応した WPF プラグインがインストールされているかどうかを確認する](how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md)
+# [ナビゲーション トポロジの概要](navigation-topologies-overview.md)
+# [移動履歴の前後への移動](how-to-navigate-forward-or-back-through-navigation-history.md)
+# [UI を返すアドインを作成する](how-to-create-an-add-in-that-returns-a-ui.md)
+# [アプリケーション セッション全体でアプリケーション スコープのプロパティを永続化および復元する](persist-and-restore-application-scope-properties.md)
+# [アプリケーション スコープのリソース ディクショナリを使用する](how-to-use-an-application-scope-resource-dictionary.md)
+# [ビルドと配置](building-and-deploying-wpf-applications.md)
+# [FilterInputMessage](filterinputmessage.md)
+# [WPF におけるパッケージの URI](pack-uris-in-wpf.md)
+# [WPF XAML ブラウザー アプリケーションの概要](wpf-xaml-browser-applications-overview.md)
+# [IEnumRAWINPUTDEVIC:Next](ienumrawinputdevic-next.md)
+# [アプリケーション管理の概要](application-management-overview.md)
+# [WPF ホスト (PresentationHost.exe)](wpf-host-presentationhost-exe.md)
+# [IEnumRAWINPUTDEVIC:Clone](ienumrawinputdevic-clone.md)
+# [アプリケーション開発](index.md)
+# [.NET アプリケーションの配置をサポートするための Firefox のアドオン](firefox-add-ons-to-support-net-application-deployment.md)
+# [ホスト](hosting-wpf-applications.md)
+# [WPF アプリケーションの配置](deploying-a-wpf-application-wpf.md)
+# [ダイアログ ボックスの概要](dialog-boxes-overview.md)
+# [構造化ナビゲーションの概要](structured-navigation-overview.md)
+# [WPF アドインの概要](wpf-add-ins-overview.md)
diff --git a/docs/framework/wpf/app-development/application-management-overview.md b/docs/framework/wpf/app-development/application-management-overview.md
new file mode 100644
index 00000000000..5252ade4eb4
--- /dev/null
+++ b/docs/framework/wpf/app-development/application-management-overview.md
@@ -0,0 +1,381 @@
+---
+title: "アプリケーション管理の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション管理 [WPF]"
+ms.assetid: 32b1c054-5aca-423b-b4b5-ed8dc4dc637d
+caps.latest.revision: 56
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# アプリケーション管理の概要
+すべてのアプリケーションは実装と管理に適用する機能を共有されることがよくあります。  このトピックでは作成および管理アプリケーションに <xref:System.Windows.Application> クラスの機能の概要について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## Application クラス  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では共通のアプリケーション スコープの機能は <xref:System.Windows.Application> のクラスにカプセル化されます。  <xref:System.Windows.Application> のクラスは次の機能が含まれています :  
+  
+-   アプリケーションの有効期間を追跡し、これと対話する。  
+  
+-   コマンド ライン パラメーターを取得し、処理する。  
+  
+-   未処理の例外を検出し、これに応答する。  
+  
+-   アプリケーション スコープのプロパティとリソースを共有する。  
+  
+-   スタンドアロン アプリケーションのウィンドウを管理する。  
+  
+-   ナビゲーションを追跡し管理する。  
+  
+<a name="The_Application_Class"></a>   
+## アプリケーション クラスを使用して一般的なタスクを実行する方法  
+ <xref:System.Windows.Application> クラスのすべての詳細を必要としないそれらの実行方法を次の表に <xref:System.Windows.Application> の一般的なタスクの一覧です。  関連 API とトピックを表示することによって詳細およびサンプル コードを参照できます。  
+  
+|タスク|方法|  
+|---------|--------|  
+|現在のアプリケーションを表すオブジェクトを取得します。|<xref:System.Windows.Application.Current%2A?displayProperty=fullName> プロパティを使用します。|  
+|アプリケーションが起動画面を追加します。|「[スプラッシュ スクリーンを WPF アプリケーションに追加する](../../../../docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md)」を参照してください。|  
+|アプリケーションを起動します。|<xref:System.Windows.Application.Run%2A?displayProperty=fullName> メソッドを使用してください。|  
+|アプリケーションを停止します。|<xref:System.Windows.Application.Current%2A> オブジェクトの <xref:System.Windows.Application.Shutdown%2A?displayProperty=fullName> メソッドを使用します。|  
+|コマンド ラインから引数を取得します。|<xref:System.Windows.Application.Startup?displayProperty=fullName> のイベントを処理し<xref:System.Windows.StartupEventArgs.Args%2A?displayProperty=fullName> のプロパティを使用します。  例については<xref:System.Windows.Application.Startup?displayProperty=fullName> のイベントを参照してください。|  
+|アプリケーション終了コードを取得および設定します。|<xref:System.Windows.Application.Exit?displayProperty=fullName> のイベント ハンドラーの <xref:System.Windows.ExitEventArgs.ApplicationExitCode%2A?displayProperty=fullName> のプロパティを設定するか<xref:System.Windows.Application.Shutdown%2A> のメソッドを呼び出し整数を渡します。|  
+|未処理の例外を検出して応答します|<xref:System.Windows.Application.DispatcherUnhandledException> イベントを処理します。|  
+|アプリケーション スコープのリソースを取得および設定します。|<xref:System.Windows.Application.Resources%2A?displayProperty=fullName> プロパティを使用します。|  
+|アプリケーション スコープのリソース ディクショナリを使用します。|「[アプリケーション スコープのリソース ディクショナリを使用する](../../../../docs/framework/wpf/app-development/how-to-use-an-application-scope-resource-dictionary.md)」を参照してください。|  
+|アプリケーション スコープのプロパティを取得および設定します。|<xref:System.Windows.Application.Properties%2A?displayProperty=fullName> プロパティを使用します。|  
+|アプリケーションの状態を取得および格納します。|「[アプリケーション セッション全体でアプリケーション スコープのプロパティを永続化および復元する](../../../../docs/framework/wpf/app-development/persist-and-restore-application-scope-properties.md)」を参照してください。|  
+|リソース ファイルコンテンツ ファイルおよび起点サイトに関するデータ ファイルなどコード ファイルを管理します。|「[WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)」を参照してください。|  
+|スタンドアロン アプリケーションのウィンドウを管理する|「[WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md)」を参照してください。|  
+|ナビゲーションを追跡および管理します。|「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。|  
+  
+<a name="The_Application_Definition"></a>   
+## アプリケーション定義  
+ <xref:System.Windows.Application> クラスの機能を利用するにはアプリケーション定義を実装する必要があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーション定義は <xref:System.Windows.Application> の派生クラスで、特別な [!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] 設定を使用して構成します。  
+  
+### アプリケーション定義の実装  
+ 一般的な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーション定義は、マークアップと分離コードの両方を使用して実装します。  そのため、マークアップを使用して、アプリケーションのプロパティやリソースの設定、イベントの登録を宣言したり、分離コードを使用して、イベントの処理やアプリケーション固有の動作を実装したりすることができます。  
+  
+ マークアップと分離コードの両方を使用してアプリケーション定義を実装する方法を次の例に示します。  
+  
+ [!code-xml[ApplicationSnippets#ApplicationXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationSnippets/CSharp/App.xaml#applicationxaml)]  
+  
+ [!code-csharp[ApplicationSnippets#ApplicationCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationSnippets/CSharp/App.xaml.cs#applicationcodebehind)]
+ [!code-vb[ApplicationSnippets#ApplicationCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationSnippets/visualbasic/application.xaml.vb#applicationcodebehind)]  
+  
+ マークアップ ファイルと分離コード ファイルを連携させるには、次のようにする必要があります。  
+  
+-   マークアップの `Application` 要素に、`x:Class` 属性を含める必要があります。  アプリケーションのビルド時にマークアップ ファイルに `x:Class` が含まれていると、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] は、`x:Class` 属性で指定された名前を持つ、<xref:System.Windows.Application> から派生した `partial` クラスを作成します。  そのためには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] スキーマ \(`xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`\) に [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間宣言を追加する必要があります。  
+  
+-   分離コードでは、クラスは、マークアップ内の `x:Class` 属性で指定されている名前を持つ `partial` クラスでなければなりません。また、<xref:System.Windows.Application> から派生する必要があります。  これによって、分離コード ファイルと、アプリケーションのビルド時にマークアップ ファイル用に生成される`partial`クラスとが関連付けられます \(「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照\)。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用して WPF アプリケーション プロジェクトまたは WPF ブラウザー アプリケーション プロジェクトを新しく作成すると、アプリケーション定義が既定で含まれ、マークアップと分離コードの両方を使用して定義されます。  
+  
+ このコードは、アプリケーション定義を実装するために最低限必要です。  ただし、アプリケーションをビルドして実装する前に、追加の [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] 構成をアプリケーション定義に対して行う必要があります。  
+  
+### MSBuild 用のアプリケーション定義の構成  
+ スタンドアロン アプリケーションや [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] を実行できるようにするには、一定レベルのインフラストラクチャの実装が必要です。  このインフラストラクチャの最も重要な部分はエントリ ポイントです。  ユーザーがアプリケーションを起動するとき、オペレーティング システムはエントリ ポイントを呼び出します。これは、オペレーティング システムがアプリケーションを起動するための機能としてよく知られています。  
+  
+ 従来、テクノロジに応じて、このコードの一部または全部を開発者が記述する必要がありました。  しかし、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、アプリケーション定義のマークアップ ファイルを [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `ApplicationDefinition` 項目として構成すると、次の [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] プロジェクト ファイルに示すように、このコードが自動生成されます。  
+  
+```  
+<Project   
+  DefaultTargets="Build"  
+  xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
+  ...  
+  <ApplicationDefinition Include="App.xaml" />  
+  <Compile Include="App.xaml.cs" />  
+  ...  
+</Project>  
+```  
+  
+ 分離コード ファイルにはコードが含まれているので、通常どおり、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `Compile` 項目としてマークされます。  
+  
+ これらの [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] 構成をアプリケーション定義のマークアップや分離コード ファイルに適用すると、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] によって次のようなコードが生成されます。  
+  
+ [!code-csharp[AppDefAugSnippets#AppDefAugCODE1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AppDefAugSnippets/CSharp/App.cs#appdefaugcode1)]
+ [!code-vb[AppDefAugSnippets#AppDefAugCODE1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AppDefAugSnippets/VisualBasic/App.vb#appdefaugcode1)]  
+[!code-csharp[AppDefAugSnippets#AppDefAugCODE2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AppDefAugSnippets/CSharp/App.cs#appdefaugcode2)]
+[!code-vb[AppDefAugSnippets#AppDefAugCODE2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AppDefAugSnippets/VisualBasic/App.vb#appdefaugcode2)]  
+  
+ 生成されるコードにより、アプリケーション定義にインフラストラクチャ コードが追加され、そこに `Main` というエントリ ポイント メソッドが含まれます。  <xref:System.STAThreadAttribute> 属性が `Main` メソッドに適用され、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションのメイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] スレッドが [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションに必須の STA スレッドであることを示します。これが呼び出されると、`Main` は `App` の新しいインスタンスを作成し、続いて `InitializeComponent` メソッドを呼び出して、イベントを登録し、マークアップに実装されているプロパティを設定します。  `InitializeComponent` は自動生成されるので、<xref:System.Windows.Controls.Page> および <xref:System.Windows.Window> の実装とは異なり、`InitializeComponent` をアプリケーションから明示的に呼び出す必要はありません。  最後に、<xref:System.Windows.Application.Run%2A> メソッドが呼び出され、アプリケーションを起動します。  
+  
+<a name="Getting_the_Current_Application"></a>   
+## 現在のアプリケーションの取得  
+ <xref:System.Windows.Application> クラスの機能がアプリケーション全体で共有されるため<xref:System.AppDomain> に対して <xref:System.Windows.Application> クラスの 1 個のインスタンスは一つだけです。  このことを強制するため、<xref:System.Windows.Application> クラスはシングルトン クラスとして実装されます \(「[Implementing Singleton in C\#](http://go.microsoft.com/fwlink/?LinkId=100567)」を参照\)。つまり、インスタンスを 1 つだけ作成し、`static` <xref:System.Windows.Application.Current%2A> プロパティを使用してインスタンスへの共有アクセスを提供します。  
+  
+ 現在の <xref:System.AppDomain> の <xref:System.Windows.Application> オブジェクトへの参照を取得する方法を次のコードに示します。  
+  
+ [!code-csharp[ApplicationManagementOverviewSnippets#GetCurrentAppCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationManagementOverviewSnippets/CSharp/MainWindow.xaml.cs#getcurrentappcode)]
+ [!code-vb[ApplicationManagementOverviewSnippets#GetCurrentAppCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationManagementOverviewSnippets/VisualBasic/MainWindow.xaml.vb#getcurrentappcode)]  
+  
+ <xref:System.Windows.Application.Current%2A> は、<xref:System.Windows.Application> クラスのインスタンスへの参照を返します。  <xref:System.Windows.Application> 派生クラスへの参照が必要な場合、<xref:System.Windows.Application.Current%2A> プロパティの値を、次の例に示すようにキャストしなければなりません。  
+  
+ [!code-csharp[ApplicationManagementOverviewSnippets#GetSTCurrentAppCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationManagementOverviewSnippets/CSharp/MainWindow.xaml.cs#getstcurrentappcode)]
+ [!code-vb[ApplicationManagementOverviewSnippets#GetSTCurrentAppCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationManagementOverviewSnippets/VisualBasic/MainWindow.xaml.vb#getstcurrentappcode)]  
+  
+ <xref:System.Windows.Application.Current%2A> の値は、<xref:System.Windows.Application> オブジェクトが有効である間はいつでも確認できます。  ただし、注意が必要です。  <xref:System.Windows.Application> クラスがインスタンス化されると、<xref:System.Windows.Application> オブジェクトの状態に一貫性が失われる期間が生じます。  この期間中、<xref:System.Windows.Application> は、アプリケーション インフラストラクチャの確立、プロパティの設定、イベントの登録など、コードの実行に必要なさまざまな初期化タスクを実行します。  この期間中に <xref:System.Windows.Application> オブジェクトを使用しようとすると、特に設定中の各種 <xref:System.Windows.Application> プロパティにコードが依存している場合に、コードで予期しない結果が生じる可能性があります。  
+  
+ <xref:System.Windows.Application> の実質的な有効期間は、初期化作業が完了した時点から始まります。  
+  
+<a name="Application_Lifetime"></a>   
+## アプリケーションの有効期間  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの有効期間は、アプリケーションが起動されたこと、アプリケーションがアクティブ、および非アクティブになったこと、シャットダウンされたことなどを通知するために <xref:System.Windows.Application> で発生するいくつかのイベントによって規定されます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Splash_Screen"></a>   
+### スプラッシュ スクリーン  
+ [!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] 以降では、スタートアップ ウィンドウ \(*スプラッシュ スクリーン*\) で使用されるイメージを指定できます。  <xref:System.Windows.SplashScreen> クラスを使用すると、アプリケーションの読み込みの間、スタートアップ ウィンドウを簡単に表示できます。  <xref:System.Windows.SplashScreen> ウィンドウは、<xref:System.Windows.Application.Run%2A> を呼び出す前に作成されて表示されます。  詳細については、「[アプリケーションの起動時間](../../../../docs/framework/wpf/advanced/application-startup-time.md)」および「[スプラッシュ スクリーンを WPF アプリケーションに追加する](../../../../docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md)」を参照してください。  
+  
+<a name="Starting_an_Application"></a>   
+### アプリケーションの起動  
+ <xref:System.Windows.Application.Run%2A> が呼び出され、アプリケーションが初期化されると、アプリケーションの実行準備が整います。  このタイミングは、<xref:System.Windows.Application.Startup> イベントが発生したときに通知されます。  
+  
+ [!code-csharp[ApplicationStartupSnippets#StartupCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationStartupSnippets/CSharp/App.xaml.cs#startupcodebehind1)]
+ [!code-vb[ApplicationStartupSnippets#StartupCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationStartupSnippets/visualbasic/application.xaml.vb#startupcodebehind1)]  
+[!code-csharp[ApplicationStartupSnippets#StartupCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationStartupSnippets/CSharp/App.xaml.cs#startupcodebehind2)]
+[!code-vb[ApplicationStartupSnippets#StartupCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationStartupSnippets/visualbasic/application.xaml.vb#startupcodebehind2)]  
+  
+ アプリケーションの有効期間中のこの時点で一般的に行われるのは [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の表示です。  
+  
+<a name="Showing_a_User_Interface"></a>   
+### ユーザー インターフェイスの表示  
+ 一般的なスタンドアロン [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] アプリケーションは、実行を開始すると <xref:System.Windows.Window> を開きます。  次のコードに示すように、<xref:System.Windows.Application.Startup> イベント ハンドラーはそれを行うことができる場所の 1 つです。  
+  
+ [!code-xml[AppShowWindowHardSnippets#StartupEventMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AppShowWindowHardSnippets/CSharp/App.xaml#startupeventmarkup)]  
+  
+ [!code-csharp[AppShowWindowHardSnippets#StartupEventCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AppShowWindowHardSnippets/CSharp/App.xaml.cs#startupeventcodebehind)]
+ [!code-vb[AppShowWindowHardSnippets#StartupEventCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AppShowWindowHardSnippets/VisualBasic/Application.xaml.vb#startupeventcodebehind)]  
+  
+> [!NOTE]
+>  スタンドアロン アプリケーションで最初にインスタンス化される <xref:System.Windows.Window> は、既定でメイン アプリケーション ウィンドウになります。  この <xref:System.Windows.Window> オブジェクトは、<xref:System.Windows.Application.MainWindow%2A?displayProperty=fullName> プロパティによって参照されます。  最初にインスタンス化された <xref:System.Windows.Window> 以外のウィンドウをメイン ウィンドウにする必要がある場合は、<xref:System.Windows.Application.MainWindow%2A> プロパティの値をプログラムで変更できます。  
+  
+ [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が最初に起動すると、一般的には <xref:System.Windows.Controls.Page> にナビゲートされます。  コードは次のようになります。  
+  
+ [!code-xml[XBAPAppStartupSnippets#StartupXBAPMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppStartupSnippets/CSharp/App.xaml#startupxbapmarkup)]  
+  
+ [!code-csharp[XBAPAppStartupSnippets#StartupXBAPCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppStartupSnippets/CSharp/App.xaml.cs#startupxbapcodebehind)]
+ [!code-vb[XBAPAppStartupSnippets#StartupXBAPCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XBAPAppStartupSnippets/VisualBasic/Application.xaml.vb#startupxbapcodebehind)]  
+  
+ <xref:System.Windows.Application.Startup> の処理目的が <xref:System.Windows.Window> を開くことまたは <xref:System.Windows.Controls.Page> にナビゲートすることのみの場合は、代わりに `StartupUri` 属性をマークアップに設定できます。  
+  
+ <xref:System.Windows.Application.StartupUri%2A> をスタンドアロン アプリケーションで使用して <xref:System.Windows.Window> を開く方法を次の例に示します。  
+  
+ [!code-xml[ApplicationManagementOverviewSnippets#OverviewStartupUriMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationManagementOverviewSnippets/CSharp/App.xaml#overviewstartupurimarkup)]  
+  
+ <xref:System.Windows.Application.StartupUri%2A> を [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] で使用して <xref:System.Windows.Controls.Page> にナビゲートする方法の例を次に示します。  
+  
+ [!code-xml[PageSnippets#XBAPStartupUriMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PageSnippets/CSharp/App.xaml#xbapstartupurimarkup)]  
+  
+ このマークアップは、ウィンドウを開くことについて、前のコードと同じ効果があります。  
+  
+> [!NOTE]
+>  ナビゲーションの詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+ 既定ではないコンストラクターを使用してウィンドウをインスタンス化する必要がある場合、ウィンドウのプロパティやサブプロパティを設定してから表示する必要がある場合、またはアプリケーションの起動時に指定されたコマンド ライン引数を処理する必要がある場合は、<xref:System.Windows.Window> を開くために <xref:System.Windows.Application.Startup> イベントを処理する必要があります。  
+  
+<a name="Processing_Command_Line_Arguments"></a>   
+### コマンド ライン引数の処理  
+ [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] では、スタンドアロン アプリケーションはコマンド プロンプトまたはデスクトップから起動できます。  どちらの場合でも、アプリケーションにコマンド ライン引数を渡すことができます。単一のコマンド ライン引数 "\/StartMinimized" を指定して起動されるアプリケーションの例を次に示します。  
+  
+ `wpfapplication.exe /StartMinimized`  
+  
+ アプリケーションの初期化中に、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] はオペレーティング システムからコマンド ライン引数を取得し、<xref:System.Windows.StartupEventArgs> パラメーターの <xref:System.Windows.StartupEventArgs.Args%2A> プロパティ経由で、<xref:System.Windows.Application.Startup> イベント ハンドラーにそれらの引数を渡します。  コマンド ライン引数を取得および格納するには、次のようなコードを使用します。  
+  
+ [!code-xml[ApplicationStartupSnippets#HandleStartupXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationStartupSnippets/CSharp/App.xaml#handlestartupxaml)]  
+  
+ [!code-csharp[ApplicationStartupSnippets#HandleStartupCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationStartupSnippets/CSharp/App.xaml.cs#handlestartupcodebehind)]
+ [!code-vb[ApplicationStartupSnippets#HandleStartupCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationStartupSnippets/visualbasic/application.xaml.vb#handlestartupcodebehind)]  
+  
+ このコードは <xref:System.Windows.Application.Startup> を処理し、**\/StartMinimized** コマンド ライン引数が指定されているかどうかを検証します。指定されている場合、<xref:System.Windows.WindowState> が <xref:System.Windows.WindowState> であるメイン ウィンドウを開きます。  <xref:System.Windows.Window.WindowState%2A> プロパティはプログラムで設定する必要があるため、メイン <xref:System.Windows.Window> はコードで明示的に開く必要があります。  
+  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] はコマンド ライン引数の取得や処理ができません。これは、[!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] 展開を使用して起動されるためです \(「[WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)」を参照\)。  ただし、起動に使用される URL のクエリ文字列パラメーターは取得して処理できます。  
+  
+<a name="Application_Activation_and_Deactivation"></a>   
+### アプリケーションのアクティブ化および非アクティブ化  
+ [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] では、ユーザーがアプリケーションを切り替えることができます。Alt キーを押しながら Tab キーを押すのが一般的なやり方です。  アプリケーションを切り替えるには、アプリケーションに、ユーザーが選択できる可視の <xref:System.Windows.Window> が必要がです。  現在選択されている <xref:System.Windows.Window> は*アクティブ ウィンドウ*と呼ばれ \(*前面ウィンドウ*とも呼ばれる\)、これがユーザー入力を受け取る <xref:System.Windows.Window> になります。アクティブ ウィンドウを持つアプリケーションは*アクティブ アプリケーション* \(または*前面アプリケーション*\) と呼ばれます。アプリケーションは、次の場合にアクティブ アプリケーションになります。  
+  
+-   起動され、<xref:System.Windows.Window> を表示した。  
+  
+-   ユーザーがそのアプリケーションの <xref:System.Windows.Window> を選択して別のアプリケーションから切り替えた。  
+  
+ アプリケーションがアクティブになったことを検出するには、<xref:System.Windows.Application.Activated?displayProperty=fullName> イベントを処理します。  
+  
+ 同様に、アプリケーションは次の場合に非アクティブになります。  
+  
+-   ユーザーが現在のアプリケーションから別のアプリケーションに切り替えた。  
+  
+-   アプリケーションがシャットダウンされた。  
+  
+ アプリケーションが非アクティブになったことを検出するには、<xref:System.Windows.Application.Deactivated?displayProperty=fullName> イベントを処理します。  
+  
+ <xref:System.Windows.Application.Activated> イベントと <xref:System.Windows.Application.Deactivated> イベントを処理してアプリケーションがアクティブかどうかを判断する方法を次のコードに示します。  
+  
+ [!code-xml[ApplicationActivationSnippets#DetectActivationStateXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationActivationSnippets/CSharp/App.xaml#detectactivationstatexaml)]  
+  
+ [!code-csharp[ApplicationActivationSnippets#DetectActivationStateCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationActivationSnippets/CSharp/App.xaml.cs#detectactivationstatecodebehind)]
+ [!code-vb[ApplicationActivationSnippets#DetectActivationStateCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationActivationSnippets/visualbasic/application.xaml.vb#detectactivationstatecodebehind)]  
+  
+ <xref:System.Windows.Window> もアクティブまたは非アクティブにできます。  詳細については、「<xref:System.Windows.Window.Activated?displayProperty=fullName>」および「<xref:System.Windows.Window.Deactivated?displayProperty=fullName>」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Application.Activated?displayProperty=fullName> も <xref:System.Windows.Application.Deactivated?displayProperty=fullName> も [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] に対しては発生しません。  
+  
+<a name="Application_Shutdown"></a>   
+### アプリケーションのシャットダウン  
+ アプリケーションの有効期間は、シャットダウンと同時に終了します。シャットダウンは次の理由で発生します。  
+  
+-   ユーザーがすべての <xref:System.Windows.Window> を閉じた。  
+  
+-   ユーザーがメイン <xref:System.Windows.Window> を閉じた。  
+  
+-   ユーザーがログオフまたはシャットダウンして、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] を終了した。  
+  
+-   アプリケーション固有の条件が満たされた。  
+  
+ アプリケーションのシャットダウンの管理を支援するため、<xref:System.Windows.Application> には <xref:System.Windows.Application.Shutdown%2A> メソッド、<xref:System.Windows.Application.ShutdownMode%2A> プロパティ、<xref:System.Windows.Application.SessionEnding> イベント、および <xref:System.Windows.Application.Exit> イベントが用意されています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Application.Shutdown%2A> は、<xref:System.Security.Permissions.UIPermission> を持つアプリケーションでのみ呼び出すことができます。  スタンドアロン [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には必ずこのアクセス許可があります。  ただし、インターネット ゾーン部分信頼のセキュリティ サンドボックス内で実行される [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] には含まれません。  
+  
+#### シャットダウン モード  
+ ほとんどのアプリケーションは、すべてのウィンドウが閉じられるか、メイン ウィンドウが閉じられると、シャットダウンします。  ただし、アプリケーションのシャットダウンに他のアプリケーション固有の条件が関係する場合もあります。  アプリケーションのシャットダウン条件は、<xref:System.Windows.Application.ShutdownMode%2A> を次のいずれかの <xref:System.Windows.ShutdownMode> 列挙値で設定できます。  
+  
+-   <xref:System.Windows.ShutdownMode>  
+  
+-   <xref:System.Windows.ShutdownMode>  
+  
+-   <xref:System.Windows.ShutdownMode>  
+  
+ <xref:System.Windows.Application.ShutdownMode%2A> の既定値は <xref:System.Windows.ShutdownMode> です。これは、アプリケーションの最後のウィンドウが閉じられると自動的にシャットダウンすることを意味します。  一方、メイン ウィンドウが閉じられたときにアプリケーションがシャットダウンするようにする必要がある場合は、<xref:System.Windows.Application.ShutdownMode%2A> を <xref:System.Windows.ShutdownMode> に設定すると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が自動的にシャットダウンします。  これを次の例に示します。  
+  
+ [!code-xml[ApplicationShutdownModeSnippets#OnMainWindowCloseMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationShutdownModeSnippets/CS/Page1.xaml#onmainwindowclosemarkup)]  
+  
+ アプリケーション固有のシャットダウン条件がある場合は、<xref:System.Windows.Application.ShutdownMode%2A> を <xref:System.Windows.ShutdownMode> に設定します。  この場合は、プログラムで <xref:System.Windows.Application.Shutdown%2A> メソッドを明示的に呼び出してアプリケーションをシャットダウンする必要があります。そうしないと、すべてのウィンドウが閉じた後も、アプリケーションは実行したままになります。  <xref:System.Windows.Application.Shutdown%2A> は、<xref:System.Windows.Application.ShutdownMode%2A> が <xref:System.Windows.ShutdownMode> または <xref:System.Windows.ShutdownMode> の場合、暗黙に呼び出されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Application.ShutdownMode%2A> は [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] から設定できますが、無視されます。[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は、ブラウザーで他にナビゲートされた場合、または [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] をホストするブラウザーが閉じられた場合に、必ずシャットダウンします。  詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+#### セッションの終了  
+ <xref:System.Windows.Application.ShutdownMode%2A> プロパティで記述されたシャットダウン条件は、アプリケーション固有です。  ただし、場合によっては、外部条件の結果としてシャットダウンすることもあります。  一般的な外部条件は、ユーザーが次の操作によって [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] セッションを終了した場合です。  
+  
+-   ログオフ  
+  
+-   シャットダウン  
+  
+-   再起動  
+  
+-   休止  
+  
+ [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] セッションの終了を検出するには、次の例に示すように、<xref:System.Windows.Application.SessionEnding> イベントを処理します。  
+  
+ [!code-xml[ApplicationSessionEndingSnippets#HandlingSessionEndingXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationSessionEndingSnippets/CSharp/App.xaml#handlingsessionendingxaml)]  
+  
+ [!code-csharp[ApplicationSessionEndingSnippets#HandlingSessionEndingCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationSessionEndingSnippets/CSharp/App.xaml.cs#handlingsessionendingcodebehind)]
+ [!code-vb[ApplicationSessionEndingSnippets#HandlingSessionEndingCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationSessionEndingSnippets/visualbasic/application.xaml.vb#handlingsessionendingcodebehind)]  
+  
+ この例では、コードは <xref:System.Windows.SessionEndingCancelEventArgs.ReasonSessionEnding%2A> プロパティ検証して、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] セッションの終了方法を判別します。  この値は、ユーザーに対する確認メッセージの表示に使用されます。  ユーザーがセッションの終了を意図していない場合、コードで <xref:System.ComponentModel.CancelEventArgs.Cancel%2A> が `true` に設定されるため、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] セッションは終了しません。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Application.SessionEnding> は [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] に対しては発生しません。  
+  
+#### Exit  
+ アプリケーションは、シャットダウン時に、アプリケーション状態の保存などの最終処理を必要とする場合があります。  そのような状況のためには、<xref:System.Windows.Application.Exit> イベントを処理できます。  
+  
+ [!code-xml[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml#persistrestoreappscopepropertiesxaml1)]  
+[!code-xml[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml#persistrestoreappscopepropertiesxaml2)]  
+  
+ [!code-csharp[HOWTOApplicationModelSnippets#PersistAppScopePropertiesCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml.cs#persistappscopepropertiescodebehind1)]
+ [!code-vb[HOWTOApplicationModelSnippets#PersistAppScopePropertiesCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/visualbasic/application.xaml.vb#persistappscopepropertiescodebehind1)]  
+[!code-csharp[HOWTOApplicationModelSnippets#PersistAppScopePropertiesCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml.cs#persistappscopepropertiescodebehind2)]
+[!code-vb[HOWTOApplicationModelSnippets#PersistAppScopePropertiesCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/visualbasic/application.xaml.vb#persistappscopepropertiescodebehind2)]  
+  
+ コード例全体については、「[アプリケーション セッション全体でアプリケーション スコープのプロパティを永続化および復元する](../../../../docs/framework/wpf/app-development/persist-and-restore-application-scope-properties.md)」を参照してください。  
+  
+ <xref:System.Windows.Application.Exit> は、スタンドアロン アプリケーション、および [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の両方で処理できます。  [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] では、次の場合に <xref:System.Windows.Application.Exit> が発生します。  
+  
+-   [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が外部にナビゲートされた。  
+  
+-   [!INCLUDE[TLA2#tla_ie7](../../../../includes/tla2sharptla-ie7-md.md)] で、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] をホストしていたタブが閉じられた。  
+  
+-   ブラウザーが閉じられた。  
+  
+#### 終了コード  
+ ほとんどのアプリケーションは、ユーザー要求に応じてオペレーティング システムから起動されます。  しかし、別のアプリケーションから起動されて特定のタスクを実行するアプリケーションもあります。  起動されたアプリケーションをシャットダウンするときに、起動したアプリケーションがそのシャットダウン理由を必要とする場合があります。  そのような場合に、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] ではアプリケーションがシャットダウン時にアプリケーション終了コードを返すことができます。  既定では、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは終了コード値として 0 を返します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] でデバッグする場合、アプリケーション終了コードは、アプリケーションのシャットダウン時に、**\[出力\]** ウィンドウに次のようなメッセージと共に表示されます。  
+>   
+>  `The program '[5340] AWPFApp.vshost.exe: Managed' has exited with code 0 (0x0).`  
+>   
+>  **\[出力\]** ウィンドウを開くには、**\[表示\]** メニューの **\[出力\]** をクリックします。  
+  
+ 終了コードを変更するには、<xref:System.Windows.Application.Shutdown%28System.Int32%29> オーバーロードを呼び出します。これが、終了コードとして整数値の引数を受け付けます。  
+  
+ [!code-csharp[ApplicationExitSnippets#AppExitCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationExitSnippets/CSharp/MainWindow.xaml.cs#appexitcode)]
+ [!code-vb[ApplicationExitSnippets#AppExitCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationExitSnippets/visualbasic/mainwindow.xaml.vb#appexitcode)]  
+  
+ <xref:System.Windows.Application.Exit> イベントを処理することで、終了コードの値を検出して変更できます。  <xref:System.Windows.Application.Exit> イベント ハンドラーには <xref:System.Windows.ExitEventArgs> が渡され、<xref:System.Windows.ExitEventArgs.ApplicationExitCode%2A> プロパティによって終了コードへのアクセスが提供されます。  詳細については、「<xref:System.Windows.Application.Exit>」を参照してください。  
+  
+> [!NOTE]
+>  終了コードは、スタンドアロン アプリケーション、および [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] のいずれでも設定できます。  ただし、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] では終了コード値は無視されます。  
+  
+<a name="Unhandled_Exceptions"></a>   
+### 未処理の例外  
+ アプリケーションは、予期しない例外が発生したときなどに、異常条件によりシャットダウンする可能性があります。  この場合、アプリケーションにはその例外を検出して処理するためのコードがありません。  このような例外はハンドルされない例外と呼ばれ、アプリケーションが閉じる前に次の図に示すような通知が表示されます。  
+  
+ ![ハンドルされない例外通知](../../../../docs/framework/wpf/app-development/media/applicationmanagementoverviewfigure2.png "ApplicationManagementOverviewFigure2")  
+  
+ ユーザー エクスペリエンスの観点から、アプリケーションではこの既定の動作を使用せず、次の一部またはすべてを行うことをお勧めします。  
+  
+-   わかりやすい情報を表示する。  
+  
+-   アプリケーションを続行するよう試みる。  
+  
+-   開発者向けの詳細な例外情報を [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] イベント ログに記録する。  
+  
+ このサポートを実装するには、ハンドルされない例外を検出できることが前提となります。ハンドルされない例外を検出するには、発生する <xref:System.Windows.Application.DispatcherUnhandledException> イベントを検出します。  
+  
+ [!code-xml[ApplicationDispatcherUnhandledExceptionSnippets#HandleDispatcherUnhandledExceptionXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationDispatcherUnhandledExceptionSnippets/CSharp/App.xaml#handledispatcherunhandledexceptionxaml)]  
+  
+ [!code-csharp[ApplicationDispatcherUnhandledExceptionSnippets#HandleDispatcherUnhandledExceptionCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationDispatcherUnhandledExceptionSnippets/CSharp/App.xaml.cs#handledispatcherunhandledexceptioncodebehind1)]
+ [!code-vb[ApplicationDispatcherUnhandledExceptionSnippets#HandleDispatcherUnhandledExceptionCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationDispatcherUnhandledExceptionSnippets/visualbasic/application.xaml.vb#handledispatcherunhandledexceptioncodebehind1)]  
+[!code-csharp[ApplicationDispatcherUnhandledExceptionSnippets#HandleDispatcherUnhandledExceptionCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ApplicationDispatcherUnhandledExceptionSnippets/CSharp/App.xaml.cs#handledispatcherunhandledexceptioncodebehind2)]
+[!code-vb[ApplicationDispatcherUnhandledExceptionSnippets#HandleDispatcherUnhandledExceptionCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ApplicationDispatcherUnhandledExceptionSnippets/visualbasic/application.xaml.vb#handledispatcherunhandledexceptioncodebehind2)]  
+  
+ <xref:System.Windows.Application.DispatcherUnhandledException> イベント ハンドラーには、未処理の例外に関するコンテキスト情報を含む <xref:System.Windows.Threading.DispatcherUnhandledExceptionEventArgs> パラメーターが渡されます。この情報には、例外自体 \(<xref:System.Windows.Threading.DispatcherUnhandledExceptionEventArgs.Exception%2A?displayProperty=fullName>\) も含まれます。  この情報を使用して、例外の処理方法を確認できます。  
+  
+ <xref:System.Windows.Application.DispatcherUnhandledException> を処理するときは、必ず <xref:System.Windows.Threading.DispatcherUnhandledExceptionEventArgs.Handled%2A?displayProperty=fullName> プロパティを `true` に設定します。そうしないと、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] はその例外を未処理のままと見なし、先に説明した既定の動作に戻ります。  ハンドルされない例外が発生し、かつ <xref:System.Windows.Application.DispatcherUnhandledException> イベントが処理されないか、イベントが処理されても <xref:System.Windows.Threading.DispatcherUnhandledExceptionEventArgs.Handled%2A> の設定が `false` である場合、アプリケーションは直ちにシャットダウンします。  また、他の <xref:System.Windows.Application> イベントは発生しません。  したがって、アプリケーションのシャットダウン前に実行する必要があるコードがある場合は、<xref:System.Windows.Application.DispatcherUnhandledException> を処理する必要があります。  
+  
+ アプリケーションは、ハンドルされない例外の結果、シャットダウンする可能性がありますが、通常は、次のセクションで示すように、ユーザーの要求に呼応する形でシャットダウンします。  
+  
+<a name="Application_Lifetime_Events"></a>   
+### アプリケーションの有効期間イベント  
+ スタンドアロン アプリケーションと [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] とで、有効期間が厳密に同じというわけではありません。スタンドアロン アプリケーションの有効期間内の主なイベントとその発生順を次の図に示します。  
+  
+ ![スタンドアロン アプリケーション &#45; アプリケーション オブジェクト イベント](../../../../docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents.png "ApplicationModelOverview\_ApplicationObjectEvents")  
+  
+ 同様に、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] の有効期間内の主要イベントとその発生順を次の図に示します。  
+  
+ ![XBAP &#45; アプリケーション オブジェクト イベント](../../../../docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents-xbap.png "ApplicationModelOverview\_ApplicationObjectEvents\_xbap")  
+  
+## 参照  
+ <xref:System.Windows.Application>   
+ [WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md)   
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)   
+ [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)   
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)   
+ [Application Model: How\-to Topics](http://msdn.microsoft.com/ja-jp/76771b09-3688-4d1c-8818-9b3f4cf39a30)   
+ [アプリケーション開発](../../../../docs/framework/wpf/app-development/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/build-and-deploy-how-to-topics.md b/docs/framework/wpf/app-development/build-and-deploy-how-to-topics.md
new file mode 100644
index 00000000000..307b92271bb
--- /dev/null
+++ b/docs/framework/wpf/app-development/build-and-deploy-how-to-topics.md
@@ -0,0 +1,42 @@
+---
+title: "ビルドおよび配置に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "WPF アプリケーション, ビルド"
+  - "WPF アプリケーション, 配置"
+ms.assetid: 88952ad2-5b74-48ca-a4c5-3f4fbb53ce12
+caps.latest.revision: 82
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 82
+---
+# ビルドおよび配置に関する「方法」トピック
+以下のトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの種類ごとにプロジェクト ファイルの作成方法を示します。  
+  
+## このセクションの内容  
+ [WPF アプリケーションを配置するように IIS 5.0 および IIS 6.0 を構成する](../../../../docs/framework/wpf/app-development/how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md)  
+ [Visual Studio を構成して Web サービスを呼び出す XAML ブラウザー アプリケーションをデバッグする](../../../../docs/framework/wpf/app-development/configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md)  
+ [インストールされている WPF のバージョンを確認する](../../../../docs/framework/wpf/app-development/how-to-determine-the-installed-version-of-wpf.md)  
+ [.NET Framework 3.0 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md)  
+ [.NET Framework 3.5 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md)  
+ [Firefox に対応した WPF プラグインがインストールされているかどうかを確認する](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md)  
+  
+## 関連項目  
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)  
+  
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)  
+  
+ [方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)  
+  
+ [方法 : 新しい WPF ブラウザー アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/72ef4d90-e163-42a1-8df0-ea7ccfd1901f)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/building-a-wpf-application-wpf.md b/docs/framework/wpf/app-development/building-a-wpf-application-wpf.md
new file mode 100644
index 00000000000..f0d22cca5dd
--- /dev/null
+++ b/docs/framework/wpf/app-development/building-a-wpf-application-wpf.md
@@ -0,0 +1,178 @@
+---
+title: "WPF アプリケーション (WPF) のビルド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WPF アプリケーション, ビルド"
+ms.assetid: a58696fd-bdad-4b55-9759-136dfdf8b91c
+caps.latest.revision: 45
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 42
+---
+# WPF アプリケーション (WPF) のビルド
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションは、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の実行可能ファイル \(.exe\)、ライブラリ \(.dll\)、またはこれらの両方のタイプのアセンブリの組み合わせとしてビルドできます。  このトピックでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションをビルドする方法を紹介し、ビルド処理の主要な手順について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Building_a_WPF_Application_using_Command_Line"></a>   
+## WPF アプリケーションのビルド  
+ WPF アプリケーションは、次の方法でコンパイルできます。  
+  
+-   コマンド ライン。  アプリケーションにはコード \(XAML ではない\) とアプリケーション定義ファイルだけを含める必要があります。  詳細については、「[csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」または「[コマンド ラインからのビルド \(Visual Basic\)](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」を参照してください。  
+  
+-   Microsoft Build Engine \(MSBuild\)。  コードおよび XAML ファイルに加えて、アプリケーションには MSBuild プロジェクト ファイルを含める必要があります。  詳細については、「[MSBuild](../Topic/MSBuild1.md)」を参照してください。  
+  
+-   Visual Studio  Visual Studio は、WPF アプリケーションと MSBuild をコンパイルし、UI を作成するためのビジュアル デザイナーを含む、統合開発環境です。  詳細については、「[Visual Studio でのアプリケーション開発](http://msdn.microsoft.com/ja-jp/97490c1b-a247-41fb-8f2c-bc4c201eff68)」および「[WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)」を参照してください。  
+  
+<a name="The_Windows_Presentation_Foundation_Build_Pipeline"></a>   
+## WPF ビルド パイプライン  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プロジェクトがビルドされると、言語固有のターゲットと [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 固有のターゲットの組み合わせが呼び出されます。  これらのターゲットを実行するプロセスをビルド パイプラインと呼びます。主要な手順を次の図に示します。  
+  
+ ![WPF ビルド処理](../../../../docs/framework/wpf/app-development/media/wpfbuildsystem-figure1.png "WPFBuildSystem\_Figure1")  
+  
+<a name="Pre_Build_Initializations"></a>   
+### ビルド前の初期化  
+ ビルドを実行する前に、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] は、次のような主要なツールおよびライブラリの場所を確認します。  
+  
+-   [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)]。  
+  
+-   [!INCLUDE[TLA2#tla_wcsdk](../../../../includes/tla2sharptla-wcsdk-md.md)] ディレクトリ。  
+  
+-   [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 参照アセンブリの場所。  
+  
+-   アセンブリ検索パスのプロパティ。  
+  
+ [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] がアセンブリを最初に検索する場所は、参照アセンブリ ディレクトリ \(%ProgramFiles%\\Reference Assemblies\\Microsoft\\Framework\\v3.0\\\) です。  また、この手順では、ビルド プロセスがさまざまなプロパティおよび項目のグループを初期化し、必要なクリーンアップ作業を実行します。  
+  
+<a name="Resolving_references"></a>   
+### 参照の解決  
+ ビルド プロセスは、アプリケーション プロジェクトのビルドに必要なアセンブリを探してバインディングします。  このロジックは、`ResolveAssemblyReference` タスクに含まれます。  プロジェクト ファイル内で `Reference` として宣言されたすべてのアセンブリは、検索パスに関する情報と、既にシステムにインストールされているアセンブリのメタデータと共にタスクに渡されます。  タスクはアセンブリを検索し、インストールされているアセンブリのメタデータを使用して、出力マニフェストに含める必要のないコアの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アセンブリをフィルターして除外します。  これは、ClickOnce マニフェストで情報が重複するのを避けるために行われます。  たとえば、PresentationFramework.dll は [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でビルドされた代表的なアプリケーションと見なすことができ、また、すべての [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アセンブリは [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされているすべてのコンピューターで同じ場所に存在するため、マニフェストにすべての [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] 参照アセンブリに関するすべての情報を含める必要はありません。  
+  
+<a name="Markup_Compilation___Pass_1"></a>   
+### マークアップ コンパイルのパス 1  
+ この手順では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルを解析してコンパイルし、ランタイムが [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] の解析やプロパティ値の検証などに時間を費やさずに済むようにします。  コンパイル済みの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルを事前にトークン化するため、実行時の読み込みは [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルを読み込むよりもはるかに短時間で終わります。  
+  
+ この手順では、`Page` ビルド項目である [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルごとに次のアクティビティが実行されます。  
+  
+1.  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルがマークアップ コンパイラによって解析されます。  
+  
+2.  対象の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に対してコンパイル済みの形式が作成され、obj\\Release フォルダーにコピーされます。  
+  
+3.  新しい部分クラスの CodeDOM 形式が作成され、obj\\Release フォルダーにコピーされます。  
+  
+ さらに、言語固有のコード ファイルが [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルごとに生成されます。たとえば、[!INCLUDE[TLA2#tla_visualb](../../../../includes/tla2sharptla-visualb-md.md)] プロジェクトの Page1.xaml ページに対して Page1.g.vb が生成され、[!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] プロジェクトの Page1.xaml ページに対して Page1.g.cs が生成されます。  ファイル名に含まれる ".g" は、ファイルが生成されたコードであり、マークアップ ファイルのトップレベルの要素 \(`Page`、`Window` など\) に対する部分クラス宣言を持つことを示しています。  クラスは [!INCLUDE[TLA2#tla_cshrp](../../../../includes/tla2sharptla-cshrp-md.md)] で`partial`修飾子 \([!INCLUDE[TLA2#tla_visualb](../../../../includes/tla2sharptla-visualb-md.md)] では `Extends`\) を指定して宣言され、他の場所に別のクラス宣言があることを示します。通常は分離コード ファイル Page1.xaml.cs 内です。  
+  
+ 部分クラスは該当の基本クラスから拡張され \(ページの <xref:System.Windows.Controls.Page> など\)、<xref:System.Windows.Markup.IComponentConnector?displayProperty=fullName> インターフェイスを実装します。  <xref:System.Windows.Markup.IComponentConnector> インターフェイスには、コンポーネントを初期化し、コンテンツ内の要素の名前とイベントを結び付けるメソッドがあります。  そのため、生成されたコード ファイルには次のようなメソッド実装が含まれます。  
+  
+```csharp  
+public void InitializeComponent() {  
+    if (_contentLoaded) {  
+        return;  
+    }  
+    _contentLoaded = true;  
+    System.Uri resourceLocater =   
+        new System.Uri(  
+            "window1.xaml",   
+            System.UriKind.RelativeOrAbsolute);  
+    System.Windows.Application.LoadComponent(this, resourceLocater);  
+}  
+```  
+  
+```vb  
+Public Sub InitializeComponent() _  
+  
+    If _contentLoaded Then  
+        Return  
+    End If  
+  
+    _contentLoaded = True  
+    Dim resourceLocater As System.Uri = _  
+        New System.Uri("mainwindow.xaml", System.UriKind.Relative)  
+  
+    System.Windows.Application.LoadComponent(Me, resourceLocater)  
+  
+End Sub  
+```  
+  
+ 既定で、マークアップ コンパイルは [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] エンジンと同じ <xref:System.AppDomain> 内で実行されます。  これにより、パフォーマンスが大幅に向上します。  この動作は、`AlwaysCompileMarkupFilesInSeparateDomain` プロパティで切り替えられます。  切り替えた場合、別の <xref:System.AppDomain> をアンロードすることにより、すべての参照アセンブリをアンロードするという利点があります  
+  
+<a name="Pass_2_of_Markup_Compilation"></a>   
+### マークアップ コンパイルのパス 2  
+ マークアップ コンパイルのパス 1 ですべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページがコンパイルされるとは限りません。  ローカルで定義された型参照 \(つまり、同じプロジェクト内の他のコードで定義された型の参照\) を含む [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは、この時点ではコンパイルから除外されます。  これは、ローカルで定義された型はソース内にのみ存在し、まだコンパイルされていないためです。  これを判別するために、パーサーはマークアップ ファイル内で `x:Name` などの項目を検索するヒューリスティックを使用します。  このようなインスタンスが見つかると、そのマークアップ ファイルのコンパイルはコード ファイルがコンパイルされるまで延期されます。その後、2 回目のマークアップ コンパイル パスでこれらのファイルが処理されます。  
+  
+<a name="File_Classification"></a>   
+### ファイルの分類  
+ ビルド プロセスにより、配置するアプリケーション アセンブリに基づいて、出力ファイルが別のリソース グループに配置されます。  通常、ローカライズされないアプリケーションでは、`Resource` とマークされたすべてのデータ ファイルはメイン アセンブリ \(実行可能ファイルまたはライブラリ\) に配置されます。  `UICulture` がプロジェクト内に設定されると、コンパイル済みのすべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルおよび言語固有と明示的にマークされたリソースは、サテライト リソース アセンブリに配置されます。  また、言語に依存しないすべてのリソースは、メイン アセンブリに配置されます。  ビルド プロセスのこの手順で、この決定が行われます。  
+  
+ プロジェクト ファイル内の `ApplicationDefinition`、`Page`、および `Resource` ビルド アクションは、`Localizable` メタデータで拡張できます \(入力可能値は `true` および `false`\)。これにより、ファイルが言語固有か、言語に依存しないかを指定します。  
+  
+<a name="Core_Compilation"></a>   
+### コア コンパイル  
+ コア コンパイルの手順では、コード ファイルをコンパイルします。  これは、Microsoft.CSharp.targets や Microsoft.VisualBasic.targets など、言語固有のターゲット ファイル内のロジックによって調整されます。  ヒューリスティックによってマークアップ コンパイラの 1 回のパスでは不十分であることが判断されると、メイン アセンブリが生成されます。  ただし、プロジェクト内の 1 つ以上の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルにローカルで定義された型の参照が含まれている場合は、一時的な .dll ファイルが生成されます。これにより、マークアップ コンパイルの 2 回目のパスが完了すると、最終的なアプリケーション アセンブリが作成されます。  
+  
+<a name="Manifest_generation"></a>   
+### マニフェストの生成  
+ ビルド プロセスの終わりに、すべてのアプリケーション アセンブリとコンテンツ ファイルの準備が整った後で、アプリケーションの [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] マニフェストが生成されます。  
+  
+ 配置マニフェスト ファイルには、配置モデル \(現在のバージョン、更新動作、および発行元の ID とデジタル署名\) が記述されています。  このマニフェストは、配置を処理する管理者が作成します。  ファイル拡張子は、[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] を表す .xbap とインストール型のアプリケーションを表す .application です。  前者は `HostInBrowser` プロジェクト プロパティによって指定されるため、マニフェストはアプリケーションがブラウザーによってホストされることを識別します。  
+  
+ アプリケーション マニフェスト \(.exe.manifest ファイル\) には、アプリケーション アセンブリ、依存ライブラリ、およびアプリケーションで必要なアクセス許可のリストが記述されています。  このファイルは、アプリケーション開発者が作成します。  [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] アプリケーションを起動するには、ユーザーはアプリケーションの配置マニフェスト ファイルを開きます。  
+  
+ これらのマニフェスト ファイルは、常に [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] 用に作成されています。  インストール型のアプリケーションでは、プロジェクト ファイル内で `GenerateManifests` プロパティ値を `true` に指定しない限り作成されません。  
+  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、一般的なインターネット ゾーン アプリケーションに割り当てられるこれらの許可のほかに、2 つの追加の許可を取得します。追加の許可とは、<xref:System.Security.Permissions.WebBrowserPermission> と <xref:System.Security.Permissions.MediaPermission> です。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のビルド システムは、アプリケーション マニフェストでこれらのアクセス許可を宣言します。  
+  
+<a name="Incremental_Build_Support"></a>   
+## インクリメンタル ビルドのサポート  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のビルド システムは、インクリメンタル ビルドをサポートします。  これは、マークアップやコードの変更を検出し、変更の影響を受けるアイテムだけをコンパイルするという高度な機能です。  インクリメンタル ビルド メカニズムでは、次のファイルを使用します。  
+  
+-   $\(*AssemblyName*\)\_MarkupCompiler.Cache ファイル。現在のコンパイラの状態を保持します。  
+  
+-   $\(*AssemblyName*\)\_MarkupCompiler.lref ファイル。ローカルで定義された型への参照を持つ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルをキャッシュします。  
+  
+ インクリメンタル ビルドの規則を次に示します。  
+  
+-   ビルド システムが変更を検出できるのは、ファイル単位以上です。  そのため、コード ファイルの場合、ビルド システムは型が変更されたかどうか、またはコードが追加されたかどうかを通知できません。  同じことはプロジェクト ファイルにも当てはまります。  
+  
+-   インクリメンタル ビルドのメカニズムは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページがクラスを定義するのか、他のクラスを使用するのかを認識していなければなりません。  
+  
+-   `Reference` のエントリが変更された場合は、すべてのページを再コンパイルします。  
+  
+-   コード ファイルが変更された場合は、ローカルで定義された型参照を含むすべてのページを再コンパイルします。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルが変更された場合 :  
+  
+    -   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] がプロジェクトで `Page` として宣言されている場合 : [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] にローカルで定義された型参照がなければ、その [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] とローカル参照を含むすべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを再コンパイルします。[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] にローカル参照があれば、ローカル参照を含むすべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを再コンパイルします。  
+  
+    -   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] がプロジェクト内で `ApplicationDefinition` として宣言されている場合 : すべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを再コンパイルします \(それぞれの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に、変更された可能性のある <xref:System.Windows.Application> 型への参照があるため\)。  
+  
+-   プロジェクト ファイルで、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルではなくコード ファイルをアプリケーション定義として宣言している場合 :  
+  
+    -   プロジェクト ファイル内の `ApplicationClassName` 値が変更されたかどうかを確認します \(たとえば、新しいアプリケーションの種類があるかどうか\)。  その場合は、アプリケーション全体を再コンパイルします。  
+  
+    -   または、ローカル参照を含むすべての [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページを再コンパイルします。  
+  
+-   プロジェクト ファイルが変更された場合は、上記のすべての規則を適用し、再コンパイルする必要があるものを確認します。  次のプロパティが変更されると、全体の再コンパイルが実行されます : `AssemblyName`、`IntermediateOutputPath`、`RootNamespace`、および `HostInBrowser`。  
+  
+ 次の再コンパイルのシナリオが考えられます。  
+  
+-   アプリケーション全体が再コンパイルされます。  
+  
+-   ローカルで定義された型参照を含む [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルだけが再コンパイルされます。  
+  
+-   再コンパイルされるものはありません \(プロジェクト内で変更が加えられていない場合\)。  
+  
+## 参照  
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)   
+ [WPF MSBuild のリファレンス](../Topic/WPF%20MSBuild%20Reference.md)   
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)   
+ [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md b/docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md
new file mode 100644
index 00000000000..5f0afae9560
--- /dev/null
+++ b/docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md
@@ -0,0 +1,47 @@
+---
+title: "WPF アプリケーションのビルドと配置 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ビルド (アプリケーションを)"
+  - "ビルド"
+  - "配置 (アプリケーションを)"
+ms.assetid: 5198df5e-dda0-4ddc-a275-e0a7a4693524
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# WPF アプリケーションのビルドと配置
+次のようなビルドと配置モデルにより、アプリケーションをローカルまたはリモートにビルドおよび配置することができます。  
+  
+-   MSBuild : Microsoft.Build.Tasks.Windows 名前空間に配置される .NET ビルド システム。  
+  
+-   リソース : UI リソースの使用。  
+  
+-   ClickOnce の配置 : .NET の公開および配置システム。  
+  
+## このセクションの内容  
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)  
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)  
+ [方法のトピック](../../../../docs/framework/wpf/app-development/build-and-deploy-how-to-topics.md)  
+  
+## 関連項目  
+ MSBuild  
+  
+## 関連項目  
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)  
+ [WPF のウィンドウ](../../../../docs/framework/wpf/app-development/windows-in-wpf-applications.md)  
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)  
+ [WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)  
+ [ホスト](../../../../docs/framework/wpf/app-development/hosting-wpf-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md b/docs/framework/wpf/app-development/configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md
new file mode 100644
index 00000000000..436dfbf398a
--- /dev/null
+++ b/docs/framework/wpf/app-development/configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md
@@ -0,0 +1,73 @@
+---
+title: "方法 : Visual Studio を構成して Web サービスを呼び出す XAML ブラウザー アプリケーションをデバッグする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "構成 (XAML ブラウザー アプリケーションをデバッグするために Visual Studio を) [WPF]"
+  - "構成 (XBAP をデバッグするために Visual Studio を) [WPF]"
+  - "デバッグ (XBAP のセキュリティ例外を) [WPF]"
+  - "デバッグ (Web サービスを呼び出す XBAP を) [WPF]"
+  - "XBAP のセキュリティ例外 [WPF], デバッグ"
+ms.assetid: fd1db082-a7bb-4c4b-9331-6ad74a0682d0
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Visual Studio を構成して Web サービスを呼び出す XAML ブラウザー アプリケーションをデバッグする
+[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] は、インターネット ゾーン アクセス許可セットに制限される部分信頼セキュリティ サンドボックス内で実行されます。  このアクセス許可セットは、Web サービス呼び出しを、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] アプリケーションの起点サイトに位置する Web サービスにのみ制限するものです。  ただし、[!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] から [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] をデバッグする場合、参照する Web サービスと同じ起点サイトを持つとは見なされません。  このため、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が Web サービスの呼び出しを試みると、セキュリティ例外が発生します。  ただし、[!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] [!INCLUDE[TLA#tla_wpfbrowserappproj](../../../../includes/tlasharptla-wpfbrowserappproj-md.md)] プロジェクトを構成することで、デバッグ時に、呼び出す Web サービスと同じ起点サイトを持つようにシミュレートできます。  これにより、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は、セキュリティ例外を発生することなく、安全に Web サービスを呼び出すことができます。  
+  
+## Visual Studio の構成  
+ [!INCLUDE[TLA#tla_visualstu2005](../../../../includes/tlasharptla-visualstu2005-md.md)] を構成して、Web サービスを呼び出す [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] をデバッグするには  
+  
+1.  **ソリューション エクスプローラー**でプロジェクトが選択されている状態で、**\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+2.  **プロジェクト デザイナー**で、**\[デバッグ\]** タブをクリックします。  
+  
+3.  **\[開始動作\]** セクションで、**\[外部プログラムの開始\]** をクリックし、次のように入力します。  
+  
+     `C:\WINDOWS\System32\PresentationHost.exe`  
+  
+4.  **\[開始オプション\]** セクションで、**\[コマンド ライン引数\]** ボックスに次のように入力します。  
+  
+     `-debug`  *filename*  
+  
+     **\-debug** パラメーターの *filename* 値には、次に示すように、.xbap ファイル名を指定します。  
+  
+     `-debug c:\example.xbap`  
+  
+> [!NOTE]
+>  これは、[!INCLUDE[TLA2#tla_visualstu2005](../../../../includes/tla2sharptla-visualstu2005-md.md)] [!INCLUDE[TLA#tla_wpfbrowserappproj](../../../../includes/tlasharptla-wpfbrowserappproj-md.md)] プロジェクト テンプレートで作成されるソリューションの既定の構成です。  
+  
+1.  **ソリューション エクスプローラー**でプロジェクトが選択されている状態で、**\[プロジェクト\]** メニューの **\[プロパティ\]** をクリックします。  
+  
+2.  **プロジェクト デザイナー**で、**\[デバッグ\]** タブをクリックします。  
+  
+3.  **\[開始オプション\]** セクションで、**\[コマンド ライン引数\]** ボックスに、次のコマンド ライン パラメーターを入力します。  
+  
+     `-debugSecurityZoneURL`  *URL*  
+  
+     **\-debugSecurityZoneURL** パラメーターの *URL* 値には、アプリケーションの起点サイトとしてシミュレートする場所の [!INCLUDE[TLA#tla_url](../../../../includes/tlasharptla-url-md.md)] を指定します。  
+  
+ たとえば、次の [!INCLUDE[TLA2#tla_url](../../../../includes/tla2sharptla-url-md.md)] の Web サービスを使用する [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] があるものとします。  
+  
+ `http://services.msdn.microsoft.com/ContentServices/ContentService.asmx`  
+  
+ この Web サービスの起点サイト [!INCLUDE[TLA2#tla_url](../../../../includes/tla2sharptla-url-md.md)] は、次のとおりです。  
+  
+ `http://services.msdn.microsoft.com`  
+  
+ したがって、完全な **\-debugSecurityZoneURL** コマンド ライン パラメーターおよび値は次のとおりです。  
+  
+ `-debugSecurityZoneURL http://services.msdn.microsoft.com`  
+  
+## 参照  
+ [WPF ホスト \(PresentationHost.exe\)](../../../../docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md b/docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md
new file mode 100644
index 00000000000..8bdf8443956
--- /dev/null
+++ b/docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md
@@ -0,0 +1,136 @@
+---
+title: "WPF アプリケーションの配置 (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 [WPF], アプリケーション"
+  - "WPF アプリケーション, 配置"
+ms.assetid: 12cadca0-b32c-4064-9a56-e6a306dcc76d
+caps.latest.revision: 27
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# WPF アプリケーションの配置 (WPF)
+ビルドが終了した [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションは配置する必要があります。  [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] および [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] には、いくつかの配置テクノロジがあります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの配置に使用する配置テクノロジは、アプリケーションの種類によって決まります。  このトピックでは、配置テクノロジの概要と [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションで必要とされる配置の要件に関連して配置テクノロジがどのように使用されるかについて説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Deployment_Technologies"></a>   
+## 配置テクノロジ  
+ [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] および [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] には、次の配置テクノロジがあります。  
+  
+-   XCopy による配置。  
+  
+-   [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]による配置。  
+  
+-   [!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] 配置。  
+  
+<a name="XCopy_Deployment"></a>   
+### XCopy による配置  
+ XCopy による配置は、XCopy コマンド ライン プログラムを使用して、ある場所から別の場所へファイルをコピーする配置です。  XCopy による配置は、次のような状況に適しています。  
+  
+-   単独で使用でき、  実行するためにクライアントを更新する必要がないアプリケーションの場合。  
+  
+-   アプリケーション ファイルをある場所から別の場所、たとえば、ビルド場所 \(ローカル ディスクや [!INCLUDE[TLA2#tla_unc](../../../../includes/tla2sharptla-unc-md.md)] ファイル共有など\) から公開場所 \(Web サイトや [!INCLUDE[TLA2#tla_unc](../../../../includes/tla2sharptla-unc-md.md)] ファイル共有など\) へ移動する必要がある場合。  
+  
+-   シェル統合 \(\[スタート\] メニュー ショートカットやデスクトップ アイコンなど\) を必要としないアプリケーションの場合。  
+  
+ XCopy は単純な配置シナリオには適していますが、複雑な配置が必要なシナリオには十分に対応できません。  特に、配置を高い信頼性で管理するためにスクリプトを作成、実行、および維持しようとすると、多くの場合に XCopy の使用はオーバーヘッドを招きます。  また、XCopy ではバージョン管理、アンインストール、およびロールバックがサポートされません。  
+  
+<a name="Windows_Installer"></a>   
+### Windows インストーラー  
+ [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用すると、クライアントに簡単に配布して実行できる自己完結型実行プログラムとしてアプリケーションをパッケージ化できます。  また、[!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] と共にインストールされ、デスクトップ、\[スタート\] メニュー、および \[プログラム\] コントロール パネルとの統合を可能にします。  
+  
+ [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用するとアプリケーションを簡単にインストールまたはアンインストールできますが、インストールされたアプリケーションをバージョン管理の観点から最新の状態に保つ機能は提供されません。  
+  
+ [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]の詳細については、「[Windows Installer Deployment](http://msdn.microsoft.com/ja-jp/121be21b-b916-43e2-8f10-8b080516d2a0)」を参照してください。  
+  
+<a name="ClickOnce_Deployment"></a>   
+### ClickOnce の配置  
+ [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] を使用すると、非 Web アプリケーションを Web スタイル アプリケーションと同じように配置できます。つまり、アプリケーションは、Web サーバーまたはファイル サーバーに公開され、これらのサーバーから配置されます。  [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] は、[!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用してインストールされたアプリケーションが取得するクライアント側の機能を完全にはサポートしませんが、次の機能を備えています。  
+  
+-   \[スタート\] メニューおよび \[プログラム\] コントロール パネルとの統合。  
+  
+-   バージョン管理、ロールバック、およびアンインストール。  
+  
+-   アプリケーションを常に配置場所から起動する、オンライン インストール モード。  
+  
+-   新しいバージョンがリリースされたときの自動更新。  
+  
+-   ファイル拡張子の登録。  
+  
+ [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] の詳細については、「[ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)」を参照してください。  
+  
+<a name="Deploying_WPF_Applications"></a>   
+## WPF アプリケーションの配置  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの配置オプションは、アプリケーションの種類によって決まります。  配置の観点から見ると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、次の 3 種類の重要なアプリケーションがあります。  
+  
+-   スタンドアロン アプリケーション。  
+  
+-   マークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] アプリケーション。  
+  
+-   [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)].  
+  
+<a name="Deploying_Standalone_Applications"></a>   
+### スタンドアロン アプリケーションの配置  
+ スタンドアロン アプリケーションは [!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] または [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用して配置されます。  いずれの場合も、スタンドアロン アプリケーションを実行するにはアプリケーションが完全に信頼されている必要があります。  [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用して配置されたスタンドアロン アプリケーションには、完全な信頼が自動的に与えられます。  [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] を使用して配置されたスタンドアロン アプリケーションには、完全な信頼が自動的に与えられません。  代わりに、スタンドアロン アプリケーションをインストールする前に、[!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] に表示されるセキュリティ警告ダイアログを受け入れる必要があります。  受け入れた場合は、スタンドアロン アプリケーションがインストールされ、完全な信頼が与えられます。  受け入れない場合、スタンドアロン アプリケーションはインストールされません。  
+  
+<a name="Deploying_Markup_Only_XAML_Applications"></a>   
+### マークアップのみの XAML アプリケーションの配置  
+ 通常、マークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページは [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ページのように Web サーバーに公開され、[!INCLUDE[TLA2#tla_iegeneric](../../../../includes/tla2sharptla-iegeneric-md.md)] を使用して表示できます。  マークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページは、部分信頼セキュリティ サンドボックス内で実行され、インターネット ゾーン アクセス許可セットに定義された制約が適用されます。  これにより、[!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ベース Web アプリケーションと同等のセキュリティ サンドボックスが提供されます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションのセキュリティの詳細については、「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」を参照してください。  
+  
+ マークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページは、XCopy または [!INCLUDE[TLA2#tla_wininstall](../../../../includes/tla2sharptla-wininstall-md.md)]を使用してローカル ファイル システムにインストールできます。  ページは、[!INCLUDE[TLA2#tla_iegeneric](../../../../includes/tla2sharptla-iegeneric-md.md)] または [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] エクスプローラーを使用して表示できます。  
+  
+ XAML の詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+<a name="Deploying_XAML_Browser_Applications"></a>   
+### XAML ブラウザー アプリケーションの配置  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、次の 3 つのファイルを配置する必要がある、コンパイル済みのアプリケーションです。  
+  
+-   *ApplicationName*.exe: 実行可能アセンブリ アプリケーション ファイル。  
+  
+-   *ApplicationName*.xbap: 配置マニフェスト。  
+  
+-   *ApplicationName*.exe.manifest: アプリケーション マニフェスト。  
+  
+> [!NOTE]
+>  配置マニフェストおよびアプリケーション マニフェストの詳細については、「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照してください。  
+  
+ これらのファイルは、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] がビルドされるときに生成されます。  詳細については、「[方法 : 新しい WPF ブラウザー アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/72ef4d90-e163-42a1-8df0-ea7ccfd1901f)」を参照してください。  マークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページと同様に、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は通常 Web サーバーに公開され、[!INCLUDE[TLA2#tla_iegeneric](../../../../includes/tla2sharptla-iegeneric-md.md)] を使用して表示されます。  
+  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、任意の配置技術を使用してクライアントに配置できます。  ただし、[!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] には次の機能が備わっているので、この方法をお勧めします。  
+  
+1.  新しいバージョンが公開されたときの自動更新。  
+  
+2.  完全な信頼で実行される [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] の特権の昇格。  
+  
+ 既定では、ClickOnce によって、.deploy という拡張子のアプリケーション ファイルが公開されます。  これは問題になる可能性がありますが、無効にできます。  詳細については、「[ClickOnce 配置でのサーバーおよびクライアント構成の問題](../Topic/Server%20and%20Client%20Configuration%20Issues%20in%20ClickOnce%20Deployments.md)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] の配置の詳細については、「[WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」を参照してください。  
+  
+<a name="Installing__NET_Framework_3_0"></a>   
+## .NET Framework のインストール  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションを実行するには、クライアントに [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] がインストールされている必要があります。  [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] では、ブラウザーでホストされる [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションを表示するときに、クライアントに [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされているかどうかが自動で検出されます。  [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされていない場合、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] によって、インストールを要求するメッセージが表示されます。  
+  
+ [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされているかどうかを検出するために、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] には、.xaml、.xps、.xbap、および .application の拡張子を持つコンテンツ ファイルのフォールバック [!INCLUDE[TLA#tla_mime](../../../../includes/tlasharptla-mime-md.md)] ハンドラーとして登録されているブートストラップ アプリケーションが含まれています。  これらの種類のファイルに移動するときに、[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がクライアントにインストールされていないと、ブートストラップ アプリケーションによってインストールに同意することが要求されます。  ユーザーがインストールに同意しない場合、[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] もアプリケーションもインストールされません。  
+  
+ 同意した場合は、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] で [!INCLUDE[TLA#tla_bits](../../../../includes/tlasharptla-bits-md.md)] を使用して [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がダウンロードされ、インストールされます。  [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] が正しくインストールされると、最初に要求されたファイルが新しいブラウザー ウィンドウで開きます。  
+  
+ [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] の自動検出機能は、[!INCLUDE[TLA2#tla_ie7](../../../../includes/tla2sharptla-ie7-md.md)] 以降がインストールされている [!INCLUDE[TLA#tla_longhorn](../../../../includes/tlasharptla-longhorn-md.md)] クライアント、[!INCLUDE[TLA#tla_winxpsp2](../../../../includes/tlasharptla-winxpsp2-md.md)] クライアント、および [!INCLUDE[TLA#tla_winnetsvrfamsp1](../../../../includes/tlasharptla-winnetsvrfamsp1-md.md)] クライアントで利用できます。  
+  
+ 詳細については、「[.NET Framework およびアプリケーションの配置](../../../../docs/framework/deployment/net-framework-and-applications.md)」を参照してください。  
+  
+## 参照  
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)   
+ [セキュリティ](../../../../docs/framework/wpf/security-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/dialog-boxes-overview.md b/docs/framework/wpf/app-development/dialog-boxes-overview.md
new file mode 100644
index 00000000000..1a2de5180d0
--- /dev/null
+++ b/docs/framework/wpf/app-development/dialog-boxes-overview.md
@@ -0,0 +1,354 @@
+---
+title: "ダイアログ ボックスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "モードレス ダイアログ ボックス"
+  - "ダイアログ ボックス"
+  - "メッセージ ボックス"
+  - "モーダル ダイアログ ボックス"
+ms.assetid: 0d23d544-a393-4a02-a3aa-d8cd5d3d6511
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ダイアログ ボックスの概要
+スタンドアロン アプリケーションは通常、メイン ウィンドウがどのアプリケーションが機能して、使用してデータを処理する機能を公開、メインのデータをある[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]メカニズムは、メニュー バー、ツールバー、およびステータス バーと同様にします。 また、他のウィンドウで、次の操作を表示することも重要なアプリケーション。  
+  
+-   ユーザーに固有の情報を表示します。  
+  
+-   ユーザーから情報を収集します。  
+  
+-   両方を表示し、情報を収集します。  
+  
+ これらの種類のウィンドウと呼ばれる*ダイアログ ボックス*、し、2 種類があります: モーダルとモードレスです。  
+  
+ A*モーダル*関数には、引き続きユーザーからの追加データが必要がある場合、関数によってダイアログ ボックスが表示されます。 関数は、データを収集するモーダル ダイアログ ボックスに依存しているため、モーダル ダイアログ ボックスも防止、ユーザーが開いている間に、アプリケーションの他のウィンドウをアクティブ化します。 モーダル ダイアログ ボックスでキーを押して、モーダル ダイアログ ボックスを終了するときにユーザーはほとんどの場合、 **OK**または**キャンセル** ボタンをクリックします。 キーを押して、 **OK**  ボタンをクリックことを示し、ユーザー データが入力されたデータに対して処理を続行する関数を希望します。 キーを押して、**キャンセル**ボタンは、ユーザーが、関数が完全に実行を停止することを示します。 開く、保存、およびデータを印刷するには、モーダル ダイアログ ボックスの最も一般的な例を示します。  
+  
+ A*モードレス*ダイアログ ボックスで、その一方を防ぐ、ユーザーが開いている間、他のウィンドウをアクティブ化します。 たとえば、ユーザーがドキュメント内の特定の単語の出現箇所を検索したい場合でも、メイン ウィンドウ対象の単語が探しているユーザー入力を要求するダイアログ ボックスが多くの場合、開きます。 単語なると、ユーザーは、ドキュメントの編集によって妨げ、ただし、ダイアログ ボックスがモーダルである必要ありませんから。 モードレス ダイアログ ボックスは、少なくとも、**閉じる** ダイアログ ボックスを閉じるボタンをクリックしなどの特定の機能を実行するその他のボタンを提供することがあります、**次を検索**word search の検索条件に一致する次の単語を検索する ボタンをクリックします。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]ダイアログ ボックス、メッセージ ボックス、コモン ダイアログ ボックスでは、カスタム ダイアログ ボックスなどの複数の種類を作成できます。 このトピックでは、それぞれ、[ダイアログ ボックスのサンプル](http://go.microsoft.com/fwlink/?LinkID=159984)一致する例を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Message_Boxes"></a>   
+## <a name="message-boxes"></a>メッセージ ボックス  
+ A*メッセージ ボックス*テキストの情報を表示し、ユーザーのボタンで、意思決定を行うことを許可するように使用できるダイアログ ボックスです。 次の図は、テキストの情報を表示、質問を質問に答える&3; つのボタンをユーザーに提供するメッセージ ボックスを表示します。  
+  
+ ![[ワード プロセッサ] ダイアログ ボックス](../Image/DialogBoxesOverviewFigure1.png "DialogBoxesOverviewFigure1")  
+  
+ 使用するメッセージ ボックスを作成する、<xref:System.Windows.MessageBox>クラスです。                  <xref:System.Windows.MessageBox>メッセージ ボックスのテキスト、タイトル、アイコン、およびボタン、次のようなコードを使用して構成することができます。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#MsgBoxConfigureCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#msgboxconfigurecodebehind)]
+ [!code-vb[DialogBoxesOverviewSnippets#MsgBoxConfigureCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#msgboxconfigurecodebehind)]  
+  
+ メッセージ ボックスを表示するのにを呼び出します、 `static`<xref:System.Windows.MessageBox.Show%2A>メソッドを次のコードに示すようにします。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#MsgBoxShowCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#msgboxshowcodebehind)]
+ [!code-vb[DialogBoxesOverviewSnippets#MsgBoxShowCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#msgboxshowcodebehind)]  
+  
+ メッセージ ボックスを表示するコードを検出して、ユーザーの決定 (どのボタンが押された) を処理する場合、コードは、次のコードに示すようにメッセージ ボックスの結果を検査できます。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#MsgBoxShowAndResultCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#msgboxshowandresultcodebehind1)]
+ [!code-vb[DialogBoxesOverviewSnippets#MsgBoxShowAndResultCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#msgboxshowandresultcodebehind1)]  
+  
+ メッセージ ボックスの使用の詳細については、次を参照してください。<xref:System.Windows.MessageBox>、[メッセージ ボックス サンプル](http://go.microsoft.com/fwlink/?LinkID=160023)、および[ダイアログ ボックスのサンプル](http://go.microsoft.com/fwlink/?LinkID=159984)します。  
+  
+ <xref:System.Windows.MessageBox>簡単なダイアログ ボックス ユーザー エクスペリエンスを使用する利点を提供することがあります<xref:System.Windows.MessageBox>は部分信頼セキュリティ サンド ボックス内で実行されるアプリケーションで表示できるウィンドウの唯一の種類は、(を参照してください[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)) など[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)]します。  
+  
+ ほとんどのダイアログ ボックスは表示のテキストを選択 (チェック ボックス) 相互に排他的な選択 (オプション ボタン) を含むメッセージ ボックスの結果よりもさらに複雑なデータを収集して、リスト (リスト ボックス、コンボ ボックス、ドロップダウン リスト ボックス) を選択します。 これらの[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]いくつかの一般的なダイアログ ボックスが表示され、いずれかの使用を完全信頼で実行されているアプリケーションに制限されていますが、独自のダイアログ ボックスを作成することができます。  
+  
+<a name="Common_Dialogs"></a>   
+## <a name="common-dialog-boxes"></a>コモン ダイアログ ボックス  
+ [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)]さまざまなファイルを開く、保存、および印刷用のダイアログ ボックスを含むすべてのアプリケーションに共通する再利用可能なダイアログ ボックスを実装します。 これらのダイアログ ボックスがオペレーティング システムによって実装されているために、により、ユーザー エクスペリエンスの一貫性は、オペレーティング システムで実行されるすべてのアプリケーション間で共有できます。ユーザーが&1; つのアプリケーションで、オペレーティング システムによって提供されるダイアログ ボックスの使用経験がほとんどの場合は、他のアプリケーションでは、そのダイアログ ボックスを使用する方法について説明する必要はありません。 これらのダイアログ ボックスがすべてのアプリケーションで使用できると呼ばれますので、一貫したユーザー エクスペリエンスを提供するのに役立つ、ため*コモン ダイアログ ボックス*します。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]開いているファイルの保存にファイル、および印刷ダイアログ ボックスをカプセル化し、それらがスタンドアロン アプリケーションで使用するため、マネージ クラスを公開します。 このトピックでは、それぞれの簡単な概要を説明します。  
+  
+<a name="Open_File_Dialog"></a>   
+### <a name="open-file-dialog"></a>ファイルを開く ダイアログ  
+ ファイルを開く機能は次の図に示すようにファイルを開く ダイアログ ボックスを使用して、開くファイルの名前を取得します。  
+  
+ ![[開く] ダイアログ ボックス](../Image/DialogBoxesOverviewFigure2.png "DialogBoxesOverviewFigure2")  
+  
+ 一般的なファイルを開く ダイアログ ボックスは、 <xref:Microsoft.Win32.OpenFileDialog>クラスに配置されていると、 <xref:Microsoft.Win32>名前空間。 次のコードでは、作成、構成、および、1 つを表示する方法と結果を処理する方法を示します。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#OpenFileDialogBoxCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#openfiledialogboxcodebehind)]
+ [!code-vb[DialogBoxesOverviewSnippets#OpenFileDialogBoxCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#openfiledialogboxcodebehind)]  
+  
+ ファイルを開く ダイアログ ボックスの詳細については、次を参照してください。 <xref:Microsoft.Win32.OpenFileDialog?displayProperty=fullName>します。  
+  
+> [!NOTE]
+>  <xref:Microsoft.Win32.OpenFileDialog>を安全にファイル名を取得する部分信頼で実行されているアプリケーションで使用できます (を参照してください[セキュリティ](../../../../docs/framework/wpf/security-wpf.md))。  
+  
+<a name="Save_File_Dialog"></a>   
+### <a name="save-file-dialog-box"></a>[保存] ダイアログ ボックスのファイル  
+ 保存先を保存するファイルの名前を取得するファイルの保存機能によって次の図に示すように、ファイル ダイアログ ボックスを使用します。  
+  
+ ![名前を付けて保存 ダイアログ ボックス](../../../../docs/framework/wpf/app-development/media/dialogboxesoverviewfigure3.png "DialogBoxesOverviewFigure3")  
+  
+ 一般的な保存ファイル ダイアログ ボックスとして実装、 <xref:Microsoft.Win32.SaveFileDialog>クラスに配置されていると、 <xref:Microsoft.Win32>名前空間。 次のコードでは、作成、構成、および、1 つを表示する方法と結果を処理する方法を示します。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#SaveFileDialogBoxCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#savefiledialogboxcodebehind)]
+ [!code-vb[DialogBoxesOverviewSnippets#SaveFileDialogBoxCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#savefiledialogboxcodebehind)]  
+  
+ 保存の詳細については [ファイル] ダイアログ ボックスは、「 <xref:Microsoft.Win32.SaveFileDialog?displayProperty=fullName>します。  
+  
+<a name="Print_Dialog"></a>   
+### <a name="print-dialog-box"></a>[印刷] ダイアログ ボックス  
+ 次の図に示すように、印刷ダイアログ ボックスを選択し、ユーザーがデータの印刷には、プリンターを構成する印刷機能によって使用されます。  
+  
+ ![印刷ダイアログ ボックスで](../../../../docs/framework/wpf/app-development/media/dialogboxesoverviewfigure4.png "DialogBoxesOverviewFigure4")  
+  
+ 一般的な印刷ダイアログ ボックスは、 <xref:System.Windows.Controls.PrintDialog>クラスでありにある、 <xref:System.Windows.Controls>名前空間。 次のコードでは、作成、構成、および&1; つを表示する方法を示します。  
+  
+ [!code-csharp[DialogBoxesOverviewSnippets#PrintDialogBoxCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/CSharp/Window1.xaml.cs#printdialogboxcodebehind)]
+ [!code-vb[DialogBoxesOverviewSnippets#PrintDialogBoxCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxesOverviewSnippets/VisualBasic/window1.xaml.vb#printdialogboxcodebehind)]  
+  
+ [印刷] ダイアログ ボックスの詳細については、次を参照してください。 <xref:System.Windows.Controls.PrintDialog?displayProperty=fullName>します。 印刷の詳細については[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]を参照してください[印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)します。  
+  
+<a name="Custom_Dialog_Boxes"></a>   
+## <a name="custom-dialog-boxes"></a>カスタム ダイアログ ボックス  
+ コモン ダイアログ ボックスが便利で、可能な場合に使用する必要があります、ドメイン固有のダイアログ ボックスの要件はサポートしていません。 このような場合は、独自のダイアログ ボックスを作成する必要があります。 おわかりのとおり、ダイアログ ボックスは、特殊な動作とウィンドウです。                  <xref:System.Windows.Window>これらの動作を実装して、その結果を使用する<xref:System.Windows.Window>カスタム モーダルとモードレスのダイアログ ボックスを作成します。  
+  
+<a name="Creating_a_Modal_Custom_Dialog_Box"></a>   
+### <a name="creating-a-modal-custom-dialog-box"></a>カスタムのモーダル ダイアログ ボックスを作成します。  
+ このトピックは、使用する方法を示しています。<xref:System.Windows.Window>、通常のモーダル ダイアログ ボックスの実装を作成するを使用して、`Margins`ようなダイアログ ボックス (を参照してください[ダイアログ ボックスのサンプル](http://go.microsoft.com/fwlink/?LinkID=159984))。 `Margins`  ダイアログ ボックスが次の図に示すようにします。  
+  
+ ![[余白] ダイアログ ボックス](../Image/DialogBoxesOverviewFigure5.png "DialogBoxesOverviewFigure5")  
+  
+#### <a name="configuring-a-modal-dialog-box"></a>モーダル ダイアログ ボックスを構成します。  
+ 一般的なダイアログ ボックスのユーザー インターフェイスには、次の項目が含まれます。  
+  
+-   必要なデータを収集するために必要なさまざまなコントロールです。  
+  
+-   表示、 **OK**ユーザーがクリックすると、関数に戻り、ダイアログ ボックスを閉じるし、処理を続行 ボタンをクリックします。  
+  
+-   表示、**キャンセル**クリックするダイアログ ボックスを終了し、関数の処理を停止する ボタンをクリックします。  
+  
+-   表示、**閉じる**タイトル バー ボタンをクリックします。  
+  
+-   アイコンを表示しています。  
+  
+-   Showing                                          **Minimize**,                                          **Maximize**, and                                          **Restore** buttons.  
+  
+-   表示、**システム**メニューを最小化、最大化、復元、およびダイアログ ボックスを閉じます。  
+  
+-   上部およびダイアログ ボックスを開いたウィンドウの中央に開いています。  
+  
+-   ダイアログ ボックスでは、それぞれ ダイアログ ボックスが小さすぎることを防止し、便利な既定のサイズをユーザーに提供するには、既定値と最小の両方を設定する必要があります。 したがって、可能なサイズ変更可能なディメンションを指定する必要があります。  
+  
+-   原因となるキーボード ショートカットとして構成するか、ESC キーを押して、**キャンセル** ボタンを押します。 これを設定するのには、 <xref:System.Windows.Controls.Button.IsCancel%2A>のプロパティ、**キャンセル**ボタン`true`します。  
+  
+-   原因となるキーボード ショートカットとして構成する必要があります (または戻り値) の入力キーを押して、 **ok**  ボタンを押します。 これを設定するのには、 <xref:System.Windows.Controls.Button.IsDefault%2A>のプロパティ、 **[ok]**ボタン`true`します。  
+  
+ 次のコードでは、この構成を示します。  
+  
+ [!code-xml[DialogBoxSample#MarginsDialogBoxMainBitsMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsdialogboxmainbitsmarkup1)]  
+[!code-xml[DialogBoxSample#MarginsDialogBoxMainBitsMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsdialogboxmainbitsmarkup2)]  
+  
+ [!code-csharp[DialogBoxSample#MarginsDialogBoxMainBitsCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxmainbitscodebehind1)]
+ [!code-vb[DialogBoxSample#MarginsDialogBoxMainBitsCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxmainbitscodebehind1)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxMainBitsCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxmainbitscodebehind2)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxMainBitsCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxmainbitscodebehind2)]  
+  
+ ダイアログ ボックスのユーザー エクスペリエンスは、ダイアログ ボックスを開くウィンドウのメニュー バーにも及びます。 メニュー項目が、関数を続行するには、ダイアログ ボックスでユーザーとの対話を必要とする関数を実行すると、関数のメニュー項目は、次のように、ヘッダーに省略記号があります。  
+  
+ [!code-xml[DialogBoxSample#MainWindowMarginsDialogBoxMenuItemMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml#mainwindowmarginsdialogboxmenuitemmarkup1)]  
+[!code-xml[DialogBoxSample#MainWindowMarginsDialogBoxMenuItemMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml#mainwindowmarginsdialogboxmenuitemmarkup2)]  
+  
+ メニュー項目は、バージョン情報 ダイアログ ボックスなどのユーザーの操作を必要としない ダイアログ ボックスを表示する関数を実行すると、省略記号は必要ありません。  
+  
+#### <a name="opening-a-modal-dialog-box"></a>モーダル ダイアログ ボックスを開く  
+ ダイアログ ボックスは、通常、ワード プロセッサで、ドキュメントの余白を設定するなどのドメイン固有の機能を実行するメニュー項目を選択すると、ユーザーの結果として表示されます。 ダイアログ ボックスとウィンドウを表示する方法は、追加のダイアログ ボックスに固有の構成が必要ですが通常のウィンドウを表示に似ています。 インスタンス化するプロセス全体、構成、およびダイアログ ボックスを開くは、次のコードに表示が。  
+  
+ [!code-csharp[DialogBoxSample#OpenMarginsDialogCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogcodebehind1)]
+ [!code-vb[DialogBoxSample#OpenMarginsDialogCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogcodebehind1)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogcodebehind2)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogcodebehind2)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogcodebehind3)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogcodebehind3)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogCODEBEHIND4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogcodebehind4)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogCODEBEHIND4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogcodebehind4)]  
+  
+ ここでは、渡された既定の情報 (現在のマージン) ダイアログ ボックスにします。 設定されても、 <xref:System.Windows.Window.Owner%2A?displayProperty=fullName>  ダイアログ ボックスが表示されているウィンドウへの参照を持つプロパティです。 一般に、必ず設定してダイアログ ボックスの所有者に、すべてのダイアログ ボックスに共通するウィンドウの状態関連の動作を提供する (を参照してください[WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md)の詳細)。  
+  
+> [!NOTE]
+>  サポートするために所有者を指定する必要があります[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]ダイアログ ボックスのための自動化 (を参照してください[UI オートメーションの概要](../../../../docs/framework/ui-automation/ui-automation-overview.md))。  
+  
+ 呼び出しでモーダルとして表示されます ダイアログ ボックスを構成した後、 <xref:System.Windows.Window.ShowDialog%2A>メソッドです。  
+  
+#### <a name="validating-user-provided-data"></a>ユーザー指定のデータの検証  
+ ダイアログ ボックスが開かれ、ユーザーは、必要なデータ、ダイアログ ボックスが提供されているデータが次の理由で有効であることを保証します。  
+  
+-   セキュリティの観点からは、すべての入力を検証する必要があります。  
+  
+-   ドメイン固有の観点から、データの検証には、例外をスローする可能性のあるコードによって処理されてから正しくないデータができないようにします。  
+  
+-   ユーザー エクスペリエンスの観点から ダイアログ ボックスは、表示することによって、入力したデータが無効ユーザーを支援することができます。  
+  
+-   パフォーマンスの観点から多階層アプリケーションのデータの検証は、アプリケーションが Web サービスまたはサーバー ベースのデータベースで構成される場合に特にに、クライアントとアプリケーション層の間のラウンド トリップの回数を削減できます。  
+  
+ バインドされたコントロールを検証する[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]バインドに関連付けることの検証規則を定義する必要があります。 派生するカスタム クラスの検証ルールは<xref:System.Windows.Controls.ValidationRule>します。 次の例では、検証規則`MarginValidationRule`、バインドされた値がどのチェック、<xref:System.Double>と指定した範囲内にあります。  
+  
+ [!code-csharp[DialogBoxSample#MarginValidationRuleCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginValidationRule.cs#marginvalidationrulecode)]
+ [!code-vb[DialogBoxSample#MarginValidationRuleCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginValidationRule.vb#marginvalidationrulecode)]  
+  
+ このコードは、オーバーライドすることで、検証規則の検証ロジックを実装、<xref:System.Windows.Controls.ValidationRule.Validate%2A>データ検証を返す、適切なメソッド<xref:System.Windows.Controls.ValidationResult>します。  
+  
+ バインドされたコントロールと検証規則を関連付けるには、次のマークアップを使用します。  
+  
+ [!code-xml[DialogBoxSample#MarginsValidationMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsvalidationmarkup1)]  
+[!code-xml[DialogBoxSample#MarginsValidationMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsvalidationmarkup2)]  
+[!code-xml[DialogBoxSample#MarginsValidationMARKUP3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsvalidationmarkup3)]  
+  
+ 検証規則が関連付けられている[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]が自動的に適用して、バインドされたコントロールにデータが入力されるとします。 コントロールには、無効なデータが含まれている[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]次の図に示すように無効なコントロールの周囲に赤い境界線が表示されます。  
+  
+ ![無効な左余白](../../../../docs/framework/wpf/app-development/media/dialogboxesoverviewfigure7.png "DialogBoxesOverviewFigure7")  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]有効なデータを入力するまで無効なコントロール、ユーザーは制限されません。 これは、ダイアログ ボックスの適切な動作ユーザーは、データが有効かどうか、ダイアログ ボックスのコントロールを自由に移動できる必要があります。 この場合、ユーザーは、無効なデータを入力できる、 **OK**  ボタンをクリックします。 このため、コードも必要があるダイアログ ボックスのすべてのコントロールを検証する際にボックス、 **OK**ボタンを処理することにより、 <xref:System.Windows.Controls.Primitives.ButtonBase.Click>イベントです。  
+  
+ [!code-csharp[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxvalidationcodebehind1)]
+ [!code-vb[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxvalidationcodebehind1)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxvalidationcodebehind2)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxvalidationcodebehind2)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxvalidationcodebehind3)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxValidationCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxvalidationcodebehind3)]  
+  
+ このコードは、ウィンドウ上のすべての依存関係オブジェクトを列挙し、いずれかが無効な場合 (によって返される<xref:System.Windows.Controls.Validation.GetHasError%2A>、無効なコントロールがフォーカスを取得、`IsValid`メソッドを返します。 `false`、ウィンドウが無効とみなされるとします。  
+  
+ ダイアログ ボックスが有効なそのことができます安全を閉じて戻ります。 戻り値のプロセスの一環として、呼び出し元の関数に結果を返すが必要です。  
+  
+#### <a name="setting-the-modal-dialog-result"></a>モーダル ダイアログ ボックスの結果を設定します。  
+ 使用して、ダイアログ ボックスを開く<xref:System.Windows.Window.ShowDialog%2A>メソッドを呼び出す場合と基本的には: を使用して、ダイアログ ボックスを開いたコード<xref:System.Windows.Window.ShowDialog%2A>されるまで待機する<xref:System.Windows.Window.ShowDialog%2A>を返します。 <xref:System.Windows.Window.ShowDialog%2A>を返す場合は、それを呼び出したコードが必要かどうかに基づくした処理を続行するか、処理を停止するかどうかを決定する、ユーザーが押された、 **[ok]**ボタンまたは**キャンセル** ボタンをクリックします。 ユーザーの選択を返す必要があります ダイアログ ボックスをこの決定を容易にする、<xref:System.Boolean>から返される値、 <xref:System.Windows.Window.ShowDialog%2A>メソッドです。  
+  
+ ときに、 **OK**  ボタンをクリックすると、 <xref:System.Windows.Window.ShowDialog%2A>返す必要があります`true`します。 これを設定するのには、 <xref:System.Windows.Window.DialogResult%2A>際に、ダイアログ ボックスのプロパティ ボックス、 **OK**  ボタンをクリックします。  
+  
+ [!code-csharp[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxokresultsetcodebehind1)]
+ [!code-vb[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxokresultsetcodebehind1)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxokresultsetcodebehind2)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxokresultsetcodebehind2)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxokresultsetcodebehind3)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxokresultsetcodebehind3)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxokresultsetcodebehind4)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxOKResultSetCODEBEHIND4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxokresultsetcodebehind4)]  
+  
+ その設定に注意してください、 <xref:System.Windows.Window.DialogResult%2A>プロパティを明示的に呼び出す必要性を軽減するウィンドウが自動的に閉じるがも<xref:System.Windows.Window.Close%2A>します。  
+  
+ ときに、**キャンセル** ボタンをクリックすると、 <xref:System.Windows.Window.ShowDialog%2A>返す必要があります`false`、設定も必要があります、 <xref:System.Windows.Window.DialogResult%2A>プロパティです。  
+  
+ [!code-csharp[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxcancelresultsetcodebehind1)]
+ [!code-vb[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxcancelresultsetcodebehind1)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxcancelresultsetcodebehind2)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxcancelresultsetcodebehind2)]  
+[!code-csharp[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml.cs#marginsdialogboxcancelresultsetcodebehind3)]
+[!code-vb[DialogBoxSample#MarginsDialogBoxCancelResultSetCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MarginsDialogBox.xaml.vb#marginsdialogboxcancelresultsetcodebehind3)]  
+  
+ ときにボタンの<xref:System.Windows.Controls.Button.IsCancel%2A>プロパティに設定されて`true`、いずれかのユーザーが押した、**キャンセル** ボタンまたは ESC キー <xref:System.Windows.Window.DialogResult%2A>に自動的に設定されている`false`します。 次のマークアップを処理する必要はありません、上記のコードと同じ効果を持つ、<xref:System.Windows.Controls.Primitives.ButtonBase.Click>イベントです。  
+  
+ [!code-xml[DialogBoxSample#MarginsDialogDefaultCancelMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MarginsDialogBox.xaml#marginsdialogdefaultcancelmarkup)]  
+  
+ ダイアログ ボックスが自動的に返します`false`、ユーザーが押したとき、**閉じる**タイトル バー ボタンをクリックするかを選択、**閉じる**からメニュー項目、**システム**メニュー。  
+  
+#### <a name="processing-data-returned-from-a-modal-dialog-box"></a>モーダル ダイアログ ボックスから返されるデータの処理  
+ ときに<xref:System.Windows.Window.DialogResult%2A>設定 ダイアログ ボックスで開いた関数は、調べることによってダイアログ ボックスの結果を取得できます、 <xref:System.Windows.Window.DialogResult%2A>プロパティと<xref:System.Windows.Window.ShowDialog%2A>を返します。  
+  
+ [!code-csharp[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogprocessreturncodebehind1)]
+ [!code-vb[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogprocessreturncodebehind1)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogprocessreturncodebehind2)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogprocessreturncodebehind2)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogprocessreturncodebehind3)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogprocessreturncodebehind3)]  
+[!code-csharp[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openmarginsdialogprocessreturncodebehind4)]
+[!code-vb[DialogBoxSample#OpenMarginsDialogProcessReturnCODEBEHIND4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openmarginsdialogprocessreturncodebehind4)]  
+  
+ ダイアログの結果が場合`true`、関数として使用するキューを取得して、ユーザーが指定したデータを処理します。  
+  
+> [!NOTE]
+>  後に<xref:System.Windows.Window.ShowDialog%2A>が返されると、ダイアログ ボックスを再度開くことはできません。 代わりに、新しいインスタンスを作成する必要があります。  
+  
+ ダイアログの結果が場合`false`関数が適切に処理を終了する必要があります。  
+  
+<a name="Creating_a_Modeless_Custom_Dialog_Box"></a>   
+### <a name="creating-a-modeless-custom-dialog-box"></a>モードレスのカスタム ダイアログ ボックスを作成します。  
+ モードレス ダイアログ ボックスでは、次の図に示すように [検索] ダイアログ ボックスなど、同じ基本的な外観モーダル ダイアログ ボックスとしてです。  
+  
+ ![[検索] ダイアログ ボックス](../Image/DialogBoxesOverviewFigure6.PNG "DialogBoxesOverviewFigure6")  
+  
+ 動作がわずかに異なるように、次のセクションで説明します。  
+  
+#### <a name="opening-a-modeless-dialog-box"></a>モードレス ダイアログ ボックスを開く  
+ 呼び出して、モードレス ダイアログ ボックスが開かれる、<xref:System.Windows.Window.Show%2A>メソッドです。  
+  
+ [!code-xml[DialogBoxSample#OpenFindDialogMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml#openfinddialogmarkup1)]  
+  
+ [!code-csharp[DialogBoxSample#OpenFindDialogCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openfinddialogcodebehind1)]
+ [!code-vb[DialogBoxSample#OpenFindDialogCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openfinddialogcodebehind1)]  
+[!code-csharp[DialogBoxSample#OpenFindDialogCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openfinddialogcodebehind2)]
+[!code-vb[DialogBoxSample#OpenFindDialogCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openfinddialogcodebehind2)]  
+[!code-csharp[DialogBoxSample#OpenFindDialogCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openfinddialogcodebehind3)]
+[!code-vb[DialogBoxSample#OpenFindDialogCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openfinddialogcodebehind3)]  
+  
+ 異なり<xref:System.Windows.Window.ShowDialog%2A>、<xref:System.Windows.Window.Show%2A>が直ちに返されます。 その結果、呼び出し元のウィンドウはモードレス ダイアログ ボックスが閉じられるし、そのため、知らないダイアログ ボックスの結果を確認するか、さらに処理するためのダイアログ ボックスからデータを取得するタイミングを判断できません。 代わりに、ダイアログ ボックスでは、呼び出し元のウィンドウで処理するためにデータを返す別の方法を作成する必要があります。  
+  
+#### <a name="processing-data-returned-from-a-modeless-dialog-box"></a>モードレス ダイアログ ボックスから返されるデータの処理  
+ この例では、 `FindDialogBox`&1; つまたは複数の検索テキストが検索されている特定の頻度に応じて、メイン ウィンドウに結果を返す可能性があります。 モードレス ダイアログ ボックスはモーダル ダイアログ ボックスと同様、プロパティを使用して結果を返すことができます。 ただし、ダイアログ ボックスを所有しているウィンドウは、これらのプロパティを確認するタイミングを認識する必要があります。 これを有効にする方法の&1; つでは、テキストが見つかったときに発生するイベントを実装する ダイアログ ボックスです。                                  `FindDialogBox`実装して、`TextFoundEvent`ときに最初この目的のためには、デリゲートが必要です。  
+  
+ [!code-csharp[DialogBoxSample#TextFoundEventHandlerCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/TextFoundEventHandler.cs#textfoundeventhandlercode)]
+ [!code-vb[DialogBoxSample#TextFoundEventHandlerCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/TextFoundEventHandler.vb#textfoundeventhandlercode)]  
+  
+ Using the                                  `TextFoundEventHandler` delegate,                                  `FindDialogBox` implements the                                  `TextFoundEvent`.  
+  
+ [!code-csharp[DialogBoxSample#TextFoundEventCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventcodebehind1)]
+ [!code-vb[DialogBoxSample#TextFoundEventCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventcodebehind1)]  
+[!code-csharp[DialogBoxSample#TextFoundEventCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventcodebehind2)]
+[!code-vb[DialogBoxSample#TextFoundEventCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventcodebehind2)]  
+  
+ その結果、`Find`検索結果が見つかった場合は、イベントを発生させることができます。  
+  
+ [!code-csharp[DialogBoxSample#TextFoundEventRaiseCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventraisecodebehind1)]
+ [!code-vb[DialogBoxSample#TextFoundEventRaiseCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventraisecodebehind1)]  
+[!code-csharp[DialogBoxSample#TextFoundEventRaiseCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventraisecodebehind2)]
+[!code-vb[DialogBoxSample#TextFoundEventRaiseCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventraisecodebehind2)]  
+[!code-csharp[DialogBoxSample#TextFoundEventRaiseCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventraisecodebehind3)]
+[!code-vb[DialogBoxSample#TextFoundEventRaiseCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventraisecodebehind3)]  
+[!code-csharp[DialogBoxSample#TextFoundEventRaiseCODEBEHIND4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventraisecodebehind4)]
+[!code-vb[DialogBoxSample#TextFoundEventRaiseCODEBEHIND4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventraisecodebehind4)]  
+[!code-csharp[DialogBoxSample#TextFoundEventRaiseCODEBEHIND5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#textfoundeventraisecodebehind5)]
+[!code-vb[DialogBoxSample#TextFoundEventRaiseCODEBEHIND5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#textfoundeventraisecodebehind5)]  
+  
+ オーナー ウィンドウは、登録し、このイベントを処理する必要があります。  
+  
+ [!code-csharp[DialogBoxSample#OpenFindDialogResultCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openfinddialogresultcodebehind1)]
+ [!code-vb[DialogBoxSample#OpenFindDialogResultCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openfinddialogresultcodebehind1)]  
+[!code-csharp[DialogBoxSample#OpenFindDialogResultCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/MainWindow.xaml.cs#openfinddialogresultcodebehind2)]
+[!code-vb[DialogBoxSample#OpenFindDialogResultCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/MainWindow.xaml.vb#openfinddialogresultcodebehind2)]  
+  
+#### <a name="closing-a-modeless-dialog-box"></a>モードレス ダイアログ ボックスを閉じる  
+ <xref:System.Windows.Window.DialogResult%2A>システムを使用してモードレスのダイアログを閉じることができる設定する必要はありませんたとえば、次のメカニズムを提供します。  
+  
+-   クリックすると、**閉じる**タイトル バー ボタンをクリックします。  
+  
+-   Alt キーを押しながら f4 キーを押すとします。  
+  
+-   Choosing                                          **Close** from the                                          **System** menu.  
+  
+ また、コードを呼び出すことができます<xref:System.Windows.Window.Close%2A>ときに、**閉じる** ボタンをクリックします。  
+  
+ [!code-csharp[DialogBoxSample#FindDialogCloseCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#finddialogclosecodebehind1)]
+ [!code-vb[DialogBoxSample#FindDialogCloseCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#finddialogclosecodebehind1)]  
+[!code-csharp[DialogBoxSample#FindDialogCloseCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DialogBoxSample/CSharp/FindDialogBox.xaml.cs#finddialogclosecodebehind2)]
+[!code-vb[DialogBoxSample#FindDialogCloseCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DialogBoxSample/VisualBasic/FindDialogBox.xaml.vb#finddialogclosecodebehind2)]  
+  
+## <a name="see-also"></a>関連項目  
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)   
+ [ダイアログ ボックスのサンプル](http://go.microsoft.com/fwlink/?LinkID=159984)   
+ [ColorPicker カスタム コントロールのサンプル](http://go.microsoft.com/fwlink/?LinkID=159977)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/filterinputmessage.md b/docs/framework/wpf/app-development/filterinputmessage.md
new file mode 100644
index 00000000000..1089e14d46a
--- /dev/null
+++ b/docs/framework/wpf/app-development/filterinputmessage.md
@@ -0,0 +1,53 @@
+---
+title: "FilterInputMessage | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "FilterInputMessage メソッド"
+  - "未加工の入力 [WPF]"
+ms.assetid: 4d74c6cf-7d1d-49ff-96c1-231340ce54f5
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# FilterInputMessage
+E\_NOTIMPL が返されない限り、メッセージを受信するたびに PresentationHost.exe によって呼び出されます。  
+  
+## 構文  
+  
+```  
+HRESULT FilterInputMessage( [in] MSG* pMsg ) ;  
+```  
+  
+#### パラメーター  
+ `pMsg`  
+  
+ \[in\] 未加工入力を取得するウィンドウに送信される WM\_INPUT メッセージ。  
+  
+## プロパティ値\/戻り値  
+ HRESULT:  
+  
+ S\_OK \- フィルターはメッセージを処理せず、それ以降の処理は実行されることがあります。  
+  
+ S\_FALSE \- フィルターはこのメッセージを処理しました。それ以降の処理は実行されません。  
+  
+ E\_NOTIMPL – この値が返される場合、[FilterInputMessage](../../../../docs/framework/wpf/app-development/filterinputmessage.md) は再度呼び出されません。  この値は、カスタムの進行状況の提供のみを対象とするホスト アプリケーションから返されることがあります。PresentationHost.exe へのエラー ユーザー インターフェイスは、PresentationHost.exe からの未加工の入力メッセージの転送を対象としていません。  
+  
+## 解説  
+ PresentationHost.exe は、キーボード、マウス、およびリモート コントロールなどのさまざまな未加工入力デバイスのターゲットになります。  場合によって、ホスト アプリケーションでの動作は PresentationHost.exe で使用される入力に依存します。  たとえば、ホスト アプリケーションは、特定のユーザー インターフェイス要素を表示するかどうかを判断するために、特定の入力メッセージの受信に依存することがあります。  
+  
+ これらの動作を提供するためにホスト アプリケーションが必要な入力メッセージを受信できるようにするため、PresentationHost.exe は、[FilterInputMessage](../../../../docs/framework/wpf/app-development/filterinputmessage.md) を呼び出して、適切な未加工の入力メッセージをホストされるアプリケーションに転送します。  
+  
+ ホストされるアプリケーションは、[GetRawInputDevices](../../../../docs/framework/wpf/app-development/getrawinputdevices.md) によって返される未加工の入力デバイス \(ヒューマン インターフェイス デバイス\) のセットを登録することで、未加工の入力メッセージを受信します。  
+  
+## 参照  
+ [Microsoft API とリファレンスのカタログ](http://msdn.microsoft.com/library/default.asp?url=/library/winui/winui/windowsuserinterface/userinput/rawinput/rawinputreference/rawinputmessages/wm_input.asp)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/firefox-add-ons-to-support-net-application-deployment.md b/docs/framework/wpf/app-development/firefox-add-ons-to-support-net-application-deployment.md
new file mode 100644
index 00000000000..49db588652b
--- /dev/null
+++ b/docs/framework/wpf/app-development/firefox-add-ons-to-support-net-application-deployment.md
@@ -0,0 +1,46 @@
+---
+title: ".NET アプリケーションの配置をサポートするための Firefox のアドオン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET アプリケーションの配置, 配置 (Firefox アドオンによる)"
+  - ".NET Framework Assistant for Firefox"
+  - "Firefox アドオン (.NET アプリケーションを配置するための)"
+  - "Firefox に対応した WPF プラグイン"
+ms.assetid: 2403403b-9b14-48e9-b70d-fa288a3c9081
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# .NET アプリケーションの配置をサポートするための Firefox のアドオン
+Firefox に対応した [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] プラグインおよび .NET Framework Assistant for Firefox を使用すると、[!INCLUDE[TLA#tla_winfxwebapp#plural](../../../../includes/tlasharptla-winfxwebappsharpplural-md.md)]、Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、および ClickOnce アプリケーションを Mozilla Firefox ブラウザーで実行できます。  
+  
+## Firefox に対応した WPF プラグイン  
+ Firefox に対応した WPF プラグインを使用すると、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] ファイルおよび Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルを Firefox ブラウザーの最上位レベルまたは HTML IFRAME にナビゲートして、そこで実行できます。  [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は、Web サーバーに公開してサポートされているブラウザー内で起動できる [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションです。  Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は、サポートされているブラウザーにナビゲートしてそのブラウザーで表示できる XAML のみのファイルです。XML ファイルとよく似ています。  
+  
+ Firefox に対応した [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラグインは、[!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] と共にインストールされます。  Window 7 には [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] が含まれますが、Firefox に対応した [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラグインは含まれません。Windows 7 には、Firefox に対応した [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラグインをインストールできません。  
+  
+ [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] には、Firefox に対応した [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プラグインは含まれません。ただし、[!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] と [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] の両方がインストールされる場合、Firefox に対応した WPF プラグインは [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] と共にインストールされます。  WPF ホストが適切なバージョンのフレームワークを読み込むので、[!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] アプリケーションは稼働します。  詳細については、「[WPF ホスト \(PresentationHost.exe\)](../../../../docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md)」を参照してください。  
+  
+## .NET Framework Assistant for Firefox  
+ .NET Framework Assistant for Firefox を使用すると、スタンドアロンの ClickOnce アプリケーションを Firefox ブラウザーから実行できます。  .NET Framework Assistant for Firefox は、Firefox ブラウザーの前後どちらでインストールしたときも同じように機能します。  Firefox ブラウザーを起動して [!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] をインストールするときに、Firefox が .NET Framework Assistant for Firefox を見つけてインストールします。  ユーザーは、.NET Framework Assistant for Firefox が次の動作を行うように構成できます。  
+  
+-   ClickOnce アプリケーションの実行前にプロンプトを表示する。  
+  
+-   インストールされている .NET Framework のすべてのバージョン、または最新バージョンのみを報告する。  
+  
+ .NET Framework Assistant for Firefox は、[!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] に含まれています。  .NET Framework Assistant for Firefox を削除する方法の詳細については、「[.NET Framework Assistant for Firefox を削除する方法](http://go.microsoft.com/fwlink/?LinkId=177944)」を参照してください。  
+  
+## 参照  
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)   
+ [WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)   
+ [Firefox に対応した WPF プラグインがインストールされているかどうかを確認する](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/getcustomui.md b/docs/framework/wpf/app-development/getcustomui.md
new file mode 100644
index 00000000000..567e741e755
--- /dev/null
+++ b/docs/framework/wpf/app-development/getcustomui.md
@@ -0,0 +1,57 @@
+---
+title: "GetCustomUI | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム エラー メッセージ [WPF]"
+  - "GetCustomUI メソッド"
+ms.assetid: e55180fc-35bb-4f80-a136-772b5eb3e4e5
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# GetCustomUI
+実装されている場合、ホストから進行状況とエラーのカスタム メッセージを取得するために PresentationHost.exe によって呼び出されます。  
+  
+## 構文  
+  
+```  
+HRESULT GetCustomUI( [out] BSTR* pwzProgressAssemblyName, [out] BSTR* pwzProgressClassName, [out] BSTR* pwzErrorAssemblyName, [out] BSTR* pwzErrorClassName );  
+```  
+  
+#### パラメーター  
+ `pwzProgressAssemblyName`  
+  
+ \[out\] ホストから提供される、進行状況のユーザー インターフェイスを格納するアセンブリへのポインター。  
+  
+ `pwzProgressClassName`  
+  
+ \[out\] ホストから提供される、進行状況のユーザー インターフェイスのクラス名。<xref:System.Windows.Controls.Page> を持つ [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] ファイルは、このクラスのトップ レベルの要素にすることをお勧めします。  このクラスは、`pwzProgressAssemblyName` で指定されたアセンブリにあります。  
+  
+ `pwzErrorAssemblyName`  
+  
+ \[out\] ホストから提供される、エラーのユーザー インターフェイスを格納するアセンブリへのポインター。  
+  
+ `pwzErrorClassName`  
+  
+ \[out\] ホストから提供される、エラーのユーザー インターフェイスのクラス名。<xref:System.Windows.Controls.Page> を持つ XAML ファイルは、このクラスのトップ レベルの要素にすることをお勧めします。  このクラスは、`pwzErrorAssemblyName` で指定されたアセンブリにあります。  
+  
+## プロパティ値\/戻り値  
+ HRESULT : 無視されます。  
+  
+## 解説  
+ ホスト アプリケーションは、PresentationHost.exe の既定のユーザー インターフェイスが準拠できない特定のテーマを持つ場合があります。  このような場合は、ホスト アプリケーションに [GetCustomUI](../../../../docs/framework/wpf/app-development/getcustomui.md) を実装して、PresentationHost.exe に進行状況とエラーのユーザー インターフェイスを返すことができます。  PresentationHost.exe は常に、既定のユーザー インターフェイスを使用する前に [GetCustomUI](../../../../docs/framework/wpf/app-development/getcustomui.md) を呼び出します。  
+  
+ この関数は、PresentationHost の初期化中に 1 回呼び出されます。  
+  
+## 参照  
+ [IWpfHostSupport](../../../../docs/framework/wpf/app-development/iwpfhostsupport.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/getrawinputdevices.md b/docs/framework/wpf/app-development/getrawinputdevices.md
new file mode 100644
index 00000000000..3baec943570
--- /dev/null
+++ b/docs/framework/wpf/app-development/getrawinputdevices.md
@@ -0,0 +1,50 @@
+---
+title: "GetRawInputDevices | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GetRawInputDevices メソッド"
+  - "未加工の入力 [WPF]"
+ms.assetid: c4d37ecd-065a-4d1c-9e6c-26804ae968ca
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# GetRawInputDevices
+PresentationHost.exe が、ホスト アプリケーションに必要な未加工入力デバイス \(ヒューマン インターフェイス デバイス\) を検出できるようにします。  
+  
+## 構文  
+  
+```  
+HRESULT GetRawInputDevices( [out] IEnumRAWINPUTDEVICE **ppEnum );  
+```  
+  
+#### パラメーター  
+ `ppEnum`  
+  
+ \[out\] 未加工入力デバイスを列挙するための [IEnumRAWINPUTDEVICE](../../../../docs/framework/wpf/app-development/ienumrawinputdevice.md) へのポインター。  
+  
+## プロパティ値\/戻り値  
+ HRESULT:  
+  
+ S\_OK \- [IEnumRAWINPUTDEVICE](../../../../docs/framework/wpf/app-development/ienumrawinputdevice.md) は、S\_OK が返された場合に、PresentationHost.exe によってのみ使用されます。  
+  
+ E\_NOTIMPL  
+  
+## 解説  
+ 未加工入力デバイスは、キーボード、マウス、およびリモート コントロールのような比較的新しいデバイスを含む入力デバイスのセットです。  
+  
+ 未加工の入力デバイスの一覧を取得すると、PresentationHost.exe は WM\_INPUT 通知メッセージを受信するデバイスを登録します。  
+  
+## 参照  
+ [http:\/\/msdn.microsoft.com\/library\/default.asp?url\=\/library\/winui\/winui\/windowsuserinterface\/userinput\/rawinput\/rawinputreference\/rawinputfunctions\/getrawinputdevicelist.asp](http://msdn.microsoft.com/library/default.asp?url=/library/winui/winui/windowsuserinterface/userinput/rawinput/rawinputreference/rawinputfunctions/getrawinputdevicelist.asp)   
+ [FilterInputMessage](../../../../docs/framework/wpf/app-development/filterinputmessage.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/hosting-wpf-applications.md b/docs/framework/wpf/app-development/hosting-wpf-applications.md
new file mode 100644
index 00000000000..2c1d55b5fb6
--- /dev/null
+++ b/docs/framework/wpf/app-development/hosting-wpf-applications.md
@@ -0,0 +1,38 @@
+---
+title: "WPF アプリケーションのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アプリケーションのホスト [WPF]"
+  - "ホスト (アプリケーションを) [WPF]"
+  - "WPF アプリケーション, ホスティング"
+ms.assetid: 1f73067d-c60a-4e9a-b513-c817ee7da3a1
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# WPF アプリケーションのホスト
+WPF XAML ブラウザー アプリケーション \(XBAP\) は、Web サーバーに配置しブラウザー内で起動できるリッチ クライアント アプリケーションです。  WPF ホスト \(PresentationHost.exe\) は、XBAP ファイルおよび XAML ファイルのシェルおよび MIME ハンドラーとして登録されます。  したがって、Internet Explorer では、XBAP が起動されたときに WPF ホストが起動されます。  Firefox ユーザーは、Firefox で XBAP をホストするための Firefox アドオンをインストールできます。  XBAP は、WPF から提供されるネイティブ ブラウザー ホスト API を使用することにより、他のブラウザーやスタンドアロン アプリケーションでホストできます。  
+  
+## このセクションの内容  
+ [WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)  
+ [WPF ホスト \(PresentationHost.exe\)](../../../../docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md)  
+ [.NET アプリケーションの配置をサポートするための Firefox のアドオン](../../../../docs/framework/wpf/app-development/firefox-add-ons-to-support-net-application-deployment.md)  
+ [WPF のブラウザーのホスト処理をサポートするネイティブ API](../../../../docs/framework/wpf/app-development/native-wpf-browser-hosting-support-apis.md)  
+  
+## 関連項目  
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)  
+ [WPF のウィンドウ](../../../../docs/framework/wpf/app-development/windows-in-wpf-applications.md)  
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)  
+ [ビルドと配置](../../../../docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md b/docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md
new file mode 100644
index 00000000000..5a20ed72903
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-add-a-splash-screen-to-a-wpf-application.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : スプラッシュ スクリーンを WPF アプリケーションに追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スプラッシュ スクリーン [WPF]"
+  - "SplashScreen クラス [WPF]"
+  - "スタートアップ ウィンドウ [WPF]"
+  - "WPF, スプラッシュ スクリーン"
+ms.assetid: d70a25c4-5fb9-4c27-b01d-b1b8ef39b3fd
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : スプラッシュ スクリーンを WPF アプリケーションに追加する
+このトピックでは、スタートアップ ウィンドウ、つまり*スプラッシュ スクリーン*を Windows Presentation Foundation \(WPF\) アプリケーションに追加する方法を示します。  
+  
+### 既存のイメージをスプラッシュ スクリーンとして追加するには  
+  
+1.  スプラッシュ スクリーンに使用するイメージを作成または検索します。  Windows イメージング コンポーネント \(WIC\) によってサポートされているイメージ形式はすべて使用できます。  たとえば、BMP、GIF、JPEG、PNG、TIFF 形式などが使用できます。  
+  
+2.  イメージ ファイルを WPF アプリケーション プロジェクトに追加します。  詳細については、「[NIB:How to: Add Existing Items to a Project](http://msdn.microsoft.com/ja-jp/15f4cfb7-78ab-457f-9f14-099a25a6a2d3)」を参照してください。  
+  
+3.  ソリューション エクスプローラーでイメージを選択します。  
+  
+4.  \[プロパティ\] ウィンドウで、**\[ビルド アクション\]** プロパティのドロップダウン矢印をクリックします。  
+  
+5.  ドロップダウン リストの **\[SplashScreen\]** をクリックします。  
+  
+    > [!NOTE]
+    >  **\[SplashScreen\]** オプションが表示されない場合は、[!INCLUDE[vs_orcas_long](../../../../includes/vs-orcas-long-md.md)] SP1 以降を使用しているかどうかを確認してください。  
+  
+6.  F5 キーを押してアプリケーションをビルドし、実行します。  
+  
+     画面の中央にスプラッシュ スクリーンのイメージが表示されます。このイメージは、メインのアプリケーション ウィンドウが表示されると、フェード アウトします。  
+  
+### アプリケーションからスプラッシュ スクリーンを削除するには  
+  
+1.  ソリューション エクスプローラーで、スプラッシュ スクリーンのイメージを選択します。  
+  
+2.  \[プロパティ\] ウィンドウで、**\[ビルド アクション\]** を **\[なし\]** に設定します。  
+  
+### アプリケーションからスプラッシュ スクリーンを削除するには  
+  
+-   ソリューション エクスプローラーで、スプラッシュ スクリーンのイメージを削除します。  
+  
+-   スプラッシュ スクリーンのイメージをプロジェクトから除外します。  
+  
+## 参照  
+ <xref:System.Windows.SplashScreen>   
+ [NIB:How to: Add Existing Items to a Project](http://msdn.microsoft.com/ja-jp/15f4cfb7-78ab-457f-9f14-099a25a6a2d3)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-call-a-page-function.md b/docs/framework/wpf/app-development/how-to-call-a-page-function.md
new file mode 100644
index 00000000000..14567bea588
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-call-a-page-function.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : ページ関数を呼び出す | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "呼び出し (ページ関数を)"
+  - "関数, 呼び出し"
+  - "ページ関数, 呼び出し"
+ms.assetid: a4808397-c6d5-406a-83e0-0091f0c15ae4
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : ページ関数を呼び出す
+[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ページからページ関数を呼び出す方法を次の例に示します。  
+  
+## 使用例  
+ ページに移動するときと同様に、[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] を使用してページ関数に移動できます。  これを次の例に示します。  
+  
+ [!code-csharp[HOWTOPageFunctionSnippets#NavigateToAPageFunctionLikeAPageCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/CallingPage.xaml.cs#navigatetoapagefunctionlikeapagecodebehind)]
+ [!code-vb[HOWTOPageFunctionSnippets#NavigateToAPageFunctionLikeAPageCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/VisualBasic/CallingPage.xaml.vb#navigatetoapagefunctionlikeapagecodebehind)]  
+  
+ データをページ関数に渡す必要がある場合は、そのインスタンスを作成し、プロパティを設定してデータを渡すことができます。  または、次の例のように、既定以外のコンストラクターを使用してデータを渡すことができます。  
+  
+ [!code-xml[HOWTOPageFunctionSnippets#CallAPageFunctionXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/CallingPage.xaml#callapagefunctionxaml)]  
+  
+ [!code-csharp[HOWTOPageFunctionSnippets#CallAPageFunctionCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/CallingPage.xaml.cs#callapagefunctioncodebehind)]
+ [!code-vb[HOWTOPageFunctionSnippets#CallAPageFunctionCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/VisualBasic/CallingPage.xaml.vb#callapagefunctioncodebehind)]  
+  
+## 参照  
+ <xref:System.Windows.Navigation.PageFunction%601>
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md b/docs/framework/wpf/app-development/how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md
new file mode 100644
index 00000000000..b058959adaf
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md
@@ -0,0 +1,156 @@
+---
+title: "方法 : WPF アプリケーションを配置するように IIS 5.0 および IIS 6.0 を構成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "調整 (コンテンツの有効期限の設定を)"
+  - "アプリケーション, 配置"
+  - "構成 (WPF アプリケーションを配置するために Web サーバーを)"
+  - "コンテンツの有効期限の設定, 調整"
+  - "配置 (アプリケーションを)"
+  - "ファイルの拡張子, 登録"
+  - "MIME タイプ, 登録"
+  - "登録 (ファイル拡張子を)"
+  - "登録 (MIME タイプを)"
+  - "Web サーバー, 構成 (WPF アプリケーションを配置するために)"
+ms.assetid: c6e8c2cb-9ba2-4e75-a0d5-180ec9639433
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : WPF アプリケーションを配置するように IIS 5.0 および IIS 6.0 を構成する
+適切な [!INCLUDE[TLA#tla_mime](../../../../includes/tlasharptla-mime-md.md)] タイプを使用して構成されていれば、ほとんどの Web サーバーから [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションを配置することができます。  既定では、[!INCLUDE[TLA#tla_iis70](../../../../includes/tlasharptla-iis70-md.md)] はこれらの [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプを使用して構成されますが、[!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] や [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] は使用しません。  
+  
+ ここでは、[!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] および [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] を構成して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを配置する方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+> [!NOTE]
+>  レジストリ内の *UserAgent* 文字列をチェックして、システムに [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされているかどうかを確認します。  詳細情報と *UserAgent* 文字列を調べてシステムに [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] がインストールされているかどうかを確認するスクリプトについては、「[.NET Framework 3.0 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md)」を参照してください。  
+  
+<a name="content_expiration"></a>   
+## コンテンツの有効期限の設定を調整する  
+ コンテンツの有効期限の設定を 1 分に調整する必要があります。  次の手順では、[!INCLUDE[TLA2#tla_iis5](../../../../includes/tla2sharptla-iis5-md.md)] を使用して調整する方法について説明します。  
+  
+1.  \[Start\] ボタンをクリックし、\[Administrative Tools\] をポイントして、\[Internet Information Services \(IIS\) Manager\] をクリックします。  このアプリケーションは、コマンド ラインで、「%SystemRoot%\\system32\\inetsrv\\iis.msc」と入力して起動することもできます。  
+  
+2.  \[Default Web site\] ノードが見つかるまで [!INCLUDE[TLA2#tla_iis5](../../../../includes/tla2sharptla-iis5-md.md)] ツリーを展開します。  
+  
+3.  \[Default Web site\] を右クリックし、コンテキスト メニューの \[Properties\] をクリックします。  
+  
+4.  \[HTTP Headers\] タブをクリックし、\[Enable Content Expiration\] チェック ボックスをオンにします。  
+  
+5.  コンテンツが 1 分後に期限切れになるように設定します。  
+  
+<a name="register_mime_types"></a>   
+## MIME タイプとファイル拡張子を登録する  
+ クライアント システムのブラウザーで適切なハンドラーを読み込めるように、いくつかの [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプとファイル拡張子を登録する必要があります。  次のタイプを追加する必要があります。  
+  
+|拡張子|MIME タイプ|  
+|---------|--------------|  
+|.manifest|application\/manifest|  
+|xaml|application\/xaml\+xml|  
+|.application|application\/x\-ms\-application|  
+|xbap|application\/x\-ms\-xbap|  
+|.deploy|application\/octet\-stream|  
+|xps|application\/vnd.ms\-xpsdocument|  
+  
+> [!NOTE]
+>  クライアント システムに、[!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプとファイル拡張子を登録する必要はありません。  これらは、[!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] のインストール時に自動的に登録されます。  
+  
+ 次の [!INCLUDE[TLA#tla_visualbscrpt](../../../../includes/tlasharptla-visualbscrpt-md.md)] のサンプルでは、必要な [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプが [!INCLUDE[TLA2#tla_iis5](../../../../includes/tla2sharptla-iis5-md.md)] に自動的に追加されます。  スクリプトを使用するには、サーバー上の .vbs ファイルにこのコードをコピーします。  コピーしたら、コマンド ラインから、または [!INCLUDE[TLA#tla_winexpl](../../../../includes/tlasharptla-winexpl-md.md)]でこのファイルをダブルクリックしてスクリプトを実行します。  
+  
+```  
+' This script adds the necessary Windows Presentation Foundation MIME types   
+' to an IIS Server.  
+' To use this script, just double-click or execute it from a command line.  
+' Running this script multiple times results in multiple entries in the IIS MimeMap.  
+  
+Dim MimeMapObj, MimeMapArray, MimeTypesToAddArray, WshShell, oExec  
+Const ADS_PROPERTY_UPDATE = 2   
+  
+' Set the MIME types to be added  
+MimeTypesToAddArray = Array(".manifest", "application/manifest", ".xaml", _  
+    "application/xaml+xml", ".application", "application/x-ms-application", _  
+    ".deploy", "application/octet-stream", ".xbap", "application/x-ms-xbap", _  
+    ".xps", "application/vnd.ms-xpsdocument")   
+  
+' Get the mimemap object   
+Set MimeMapObj = GetObject("IIS://LocalHost/MimeMap")  
+  
+' Call AddMimeType for every pair of extension/MIME type  
+For counter = 0 to UBound(MimeTypesToAddArray) Step 2  
+    AddMimeType MimeTypesToAddArray(counter), MimeTypesToAddArray(counter+1)  
+Next  
+  
+' Create a Shell object  
+Set WshShell = CreateObject("WScript.Shell")  
+  
+' Stop and Start the IIS Service  
+Set oExec = WshShell.Exec("net stop w3svc")  
+Do While oExec.Status = 0  
+    WScript.Sleep 100  
+Loop  
+  
+Set oExec = WshShell.Exec("net start w3svc")  
+Do While oExec.Status = 0  
+    WScript.Sleep 100  
+Loop  
+  
+Set oExec = Nothing  
+  
+' Report status to user  
+WScript.Echo "Windows Presentation Foundation MIME types have been registered."  
+  
+' AddMimeType Sub  
+Sub AddMimeType (Ext, MType)  
+  
+    ' Get the mappings from the MimeMap property.   
+    MimeMapArray = MimeMapObj.GetEx("MimeMap")   
+  
+    ' Add a new mapping.   
+    i = UBound(MimeMapArray) + 1   
+    Redim Preserve MimeMapArray(i)   
+    Set MimeMapArray(i) = CreateObject("MimeMap")   
+    MimeMapArray(i).Extension = Ext   
+    MimeMapArray(i).MimeType = MType   
+    MimeMapObj.PutEx ADS_PROPERTY_UPDATE, "MimeMap", MimeMapArray  
+    MimeMapObj.SetInfo  
+  
+End Sub  
+```  
+  
+> [!NOTE]
+>  このスクリプトを複数回実行すると、複数の [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] マップ エントリが [!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] または [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] メタベースに作成されます。  
+  
+ このスクリプトを実行しても、[!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] または [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] [!INCLUDE[TLA#tla_mmc](../../../../includes/tlasharptla-mmc-md.md)] から追加の [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプを参照できない場合があります。  しかし、これらの [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプは、[!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] または [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] メタベースに追加されています。  次のスクリプトは、[!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] または [!INCLUDE[TLA#tla_iis60](../../../../includes/tlasharptla-iis60-md.md)] メタベース内のすべての [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] タイプを表示します。  
+  
+```  
+' This script lists the MIME types for an IIS Server.  
+' To use this script, just double-click or execute it from a command line   
+' by calling cscript.exe  
+  
+dim mimeMapEntry, allMimeMaps  
+  
+' Get the mimemap object.  
+Set mimeMapEntry = GetObject("IIS://localhost/MimeMap")  
+allMimeMaps = mimeMapEntry.GetEx("MimeMap")  
+  
+' Display the mappings in the table.  
+For Each mimeMap In allMimeMaps  
+    WScript.Echo(mimeMap.MimeType & " (" & mimeMap.Extension + ")")  
+Next  
+```  
+  
+ スクリプトを `.vbs` ファイルとして保存し \(たとえば、`DiscoverIISMimeTypes.vbs`\)、次のコマンドを使用して、コマンド ラインからこれを実行します。  
+  
+ `cscript DiscoverIISMimeTypes.vbs`
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-create-an-add-in-that-is-a-ui.md b/docs/framework/wpf/app-development/how-to-create-an-add-in-that-is-a-ui.md
new file mode 100644
index 00000000000..fd2cc877a70
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-create-an-add-in-that-is-a-ui.md
@@ -0,0 +1,488 @@
+---
+title: "方法 : UI であるアドインを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成 (UI であるアドインを) [WPF]"
+  - "アドイン [WPF] UI"
+  - "作成 (UI アドインを) [WPF]"
+  - "UI アドイン [WPF] を作成します。"
+  - "実装 (UI アドインを) [WPF]"
+  - "アドインを作成するパイプライン セグメント [WPF]"
+ms.assetid: 86375525-282b-4039-8352-8680051a10ea
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : UI であるアドインを作成する
+\<?xml version="1.0" encoding="utf-8"?>
+\<developerHowToDocument xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://ddue.schemas.microsoft.com/authoring/2003/5 http://dduestorage.blob.core.windows.net/ddueschema/developer.xsd">
+  <introduction>
+    <para>この例は、アドインを作成する方法を示しています、<token>グラス フレーム TLA</token> <token>では</token>によってホストされます、 <token>TLA2 拡張されたグラス</token>スタンドアロン アプリケーションです</para>。
+    <para>、アドインは、 <token>TLA&#2;tla_ui</token>つまり、<token>グラス フレーム TLA2</token>ユーザー コントロールです。ユーザー コントロールのコンテンツは、1 つのボタンで、クリックすると、メッセージ ボックスを表示します。<token>グラス フレーム TLA2</token>スタンドアロン アプリケーションはアドインをホストする<token>TLA&#2;tla_ui</token>アプリケーションのメイン ウィンドウのコンテンツとして</para>。
+    <para>
+      <embeddedLabel>の前提条件</embeddedLabel>
+    </para>
+    <para>この例で強調表示、<token>グラス フレーム TLA2</token>の拡張機能、 <token>dnprdnshort</token>アドインでこのシナリオを実現し、モデルを以下を前提としています:</para>
+    <list class="bullet">
+      <listItem>
+        <para>の知識、 <token>dnprdnshort</token>アドインなど、モデル パイプライン、アドインでは、ホストの開発用です。これらの概念に慣れていない場合は、次を参照してください。\<legacyLink xlink:href="8dd45b02-7218-40f9-857d-40d7b98b850b">アドインおよび拡張</legacyLink>します。パイプライン、アドイン、およびホスト アプリケーションの実装を説明するチュートリアルについては、次を参照してください\<legacyLink xlink:href="694a33c5-a040-450d-aed5-ac49fc88ce61">チュートリアル: 拡張性のあるアプリケーションを作成する</legacyLink>。</para> 。
+      </listItem> 
+      <listItem>
+        <para>の知識、<token>グラス フレーム TLA2</token>の拡張機能、 <token>dnprdnshort</token>アドイン モデル、こちらをご覧: \<link xlink:href="00b4c776-29a8-4dba-b603-280a0cdc2ade">WPF アドインの概要</link>.</para>
+      </listItem> 
+    </list> 
+  </introduction> 
+  <codeExample> 
+    <legacy> 
+      <content>
+        <para>がアドインを作成する、<token>グラス フレーム TLA2</token> <token>TLA&#2;tla_ui</token>各パイプライン セグメント、アドイン、およびホスト アプリケーションの特定のコードが必要です</para>。
+        <para>
+          <token>アウトラインの自動作成</token>
+        </para>
+      </content>
+      <sections>
+        <section address="Contract">
+          <title>コントラクト パイプライン セグメントの実装</title>
+          <content>
+            <para>とアドインでは、 <token>TLA&#2;tla_ui</token>、アドインのコントラクトを実装する必要があります<codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>します。例では、 <codeInline>IWPFAddInContract</codeInline>実装<codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>の次のコードに示すようにします。</para>
+            <code language="c#">using System.AddIn.Contract; // INativeHandleContract
+using System.AddIn.Pipeline; // AddInContractAttribute
+
+namespace Contracts
+{
+    /// &lt;summary&gt;
+    /// Defines the services that an add-in will provide to a host application.
+    /// In this case, the add-in is a UI.
+    /// &lt;/summary&gt;
+    [AddInContract]
+    public interface IWPFAddInContract : INativeHandleContract {}
+}</code>
+          <code language="vb">Imports System.AddIn.Contract ' INativeHandleContract
+Imports System.AddIn.Pipeline ' AddInContractAttribute
+
+Namespace Contracts
+    ''' &lt;summary&gt;
+    ''' Defines the services that an add-in will provide to a host application.
+    ''' In this case, the add-in is a UI.
+    ''' &lt;/summary&gt;
+    &lt;AddInContract&gt;
+    Public Interface IWPFAddInContract
+        Inherits INativeHandleContract
+        Inherits IContract
+    End Interface
+End Namespace</code></content>
+        </section>
+        <section address="AddInViewPipeline">
+          <title>アドインのビューのパイプライン セグメントの実装</title>
+          <content>
+            <para>のサブクラスとして、アドインに実装されるため、<codeEntityReference autoUpgrade="true">として</codeEntityReference>アドイン ビューの種類はサブクラス化も必要<codeEntityReference autoUpgrade="true">として</codeEntityReference>します。次のコードは、アドインのビューとして実装されたコントラクトの<codeInline>WPFAddInView</codeInline>クラス</para>
+            <code language="c#">using System.AddIn.Pipeline; // AddInBaseAttribute
+using System.Windows.Controls; // UserControl
+
+namespace AddInViews
+{
+    /// &lt;summary&gt;
+    /// Defines the add-in's view of the contract.
+    /// &lt;/summary&gt;
+    [AddInBase]
+    public class WPFAddInView : UserControl { }
+}</code> 
+          <code language="vb">Imports System.AddIn.Pipeline ' AddInBaseAttribute
+Imports System.Windows.Controls ' UserControl
+
+Namespace AddInViews
+    ''' &lt;summary&gt;
+    ''' Defines the add-in's view of the contract.
+    ''' &lt;/summary&gt;
+    &lt;AddInBase&gt;
+    Public Class WPFAddInView
+        Inherits UserControl
+    End Class
+End Namespace</code>
+            <para>ここでは、アドイン ビューがから派生した<codeEntityReference autoUpgrade="true">該当</codeEntityReference>します。そのため、アドインを<token>TLA&#2;tla_ui</token>からも派生する必要があります<codeEntityReference autoUpgrade="true">該当</codeEntityReference>します。</para>
+          </content>
+        </section>
+        <section address="AddInSideAdapter">
+          <title>Add-In-Side アダプター パイプライン セグメントの実装</title>
+          <content>
+            <para>コントラクトは、中に、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>、アドインでは、<codeEntityReference autoUpgrade="true">として</codeEntityReference>(アドイン ビュー パイプライン セグメントで、指定された)。したがって、<codeEntityReference autoUpgrade="true">として</codeEntityReference>に変換する必要があります、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>分離境界を越える前にします。呼び出して追加アドイン側アダプターでこの作業を行う<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter(System.Windows.FrameworkElement)</codeEntityReference>次のコードに示すように、</para> 。
+            <code language="c#">using System; // IntPtr
+using System.AddIn.Contract; // INativeHandleContract
+using System.AddIn.Pipeline; // AddInAdapterAttribute, FrameworkElementAdapters, ContractBase
+using System.Security.Permissions;
+
+using AddInViews; // WPFAddInView
+using Contracts; // IWPFAddInContract
+
+namespace AddInSideAdapters
+{
+    /// &lt;summary&gt;
+    /// Adapts the add-in's view of the contract to the add-in contract
+    /// &lt;/summary&gt;
+    [AddInAdapter]
+    public class WPFAddIn_ViewToContractAddInSideAdapter : ContractBase, IWPFAddInContract
+    {
+        WPFAddInView wpfAddInView;
+
+        public WPFAddIn_ViewToContractAddInSideAdapter(WPFAddInView wpfAddInView)
+        {
+            // Adapt the add-in view of the contract (WPFAddInView) 
+            // to the contract (IWPFAddInContract)
+            this.wpfAddInView = wpfAddInView;
+        }
+
+        /// &lt;summary&gt;
+        /// ContractBase.QueryContract must be overridden to:
+        /// * Safely return a window handle for an add-in UI to the host 
+        ///   application's application.
+        /// * Enable tabbing between host application UI and add-in UI, in the
+        ///   "add-in is a UI" scenario.
+        /// &lt;/summary&gt;
+        public override IContract QueryContract(string contractIdentifier)
+        {
+            if (contractIdentifier.Equals(typeof(INativeHandleContract).AssemblyQualifiedName))
+            {
+                return FrameworkElementAdapters.ViewToContractAdapter(this.wpfAddInView);
+            }
+
+            return base.QueryContract(contractIdentifier);
+        }
+
+        /// &lt;summary&gt;
+        /// GetHandle is called by the WPF add-in model from the host application's 
+        /// application domain to to get the window handle for an add-in UI from the 
+        /// add-in's application domain. GetHandle is called if a window handle isn't 
+        /// returned by other means ie overriding ContractBase.QueryContract, 
+        /// as shown above.
+        /// NOTE: This method requires UnmanagedCodePermission to be called 
+        ///       (full-trust by default), to prevent illegal window handle
+        ///       access in partially trusted scenarios. If the add-in could
+        ///       run in a partially trusted application domain 
+        ///       (eg AddInSecurityLevel.Internet), you can safely return a window
+        ///       handle by overriding ContractBase.QueryContract, as shown above.
+        /// &lt;/summary&gt;
+        [SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
+        public IntPtr GetHandle()
+        {
+            return FrameworkElementAdapters.ViewToContractAdapter(this.wpfAddInView).GetHandle();
+        }
+    }
+}</code> 
+          <code language="vb">Imports System ' IntPtr
+Imports System.AddIn.Contract ' INativeHandleContract
+Imports System.AddIn.Pipeline ' AddInAdapterAttribute, FrameworkElementAdapters, ContractBase
+Imports System.Security.Permissions
+
+Imports AddInViews ' WPFAddInView
+Imports Contracts ' IWPFAddInContract
+
+Namespace AddInSideAdapters
+    ''' &lt;summary&gt;
+    ''' Adapts the add-in's view of the contract to the add-in contract
+    ''' &lt;/summary&gt;
+    &lt;AddInAdapter&gt;
+    Public Class WPFAddIn_ViewToContractAddInSideAdapter
+        Inherits ContractBase
+        Implements IWPFAddInContract
+
+        Private wpfAddInView As WPFAddInView
+
+        Public Sub New(ByVal wpfAddInView As WPFAddInView)
+            ' Adapt the add-in view of the contract (WPFAddInView) 
+            ' to the contract (IWPFAddInContract)
+            Me.wpfAddInView = wpfAddInView
+        End Sub
+
+        ''' &lt;summary&gt;
+        ''' ContractBase.QueryContract must be overridden to:
+        ''' * Safely return a window handle for an add-in UI to the host 
+        '''   application's application.
+        ''' * Enable tabbing between host application UI and add-in UI, in the
+        '''   "add-in is a UI" scenario.
+        ''' &lt;/summary&gt;
+        Public Overrides Function QueryContract(ByVal contractIdentifier As String) As IContract
+            If contractIdentifier.Equals(GetType(INativeHandleContract).AssemblyQualifiedName) Then
+                Return FrameworkElementAdapters.ViewToContractAdapter(Me.wpfAddInView)
+            End If
+
+            Return MyBase.QueryContract(contractIdentifier)
+        End Function
+
+        ''' &lt;summary&gt;
+        ''' GetHandle is called by the WPF add-in model from the host application's 
+        ''' application domain to to get the window handle for an add-in UI from the 
+        ''' add-in's application domain. GetHandle is called if a window handle isn't 
+        ''' returned by other means ie overriding ContractBase.QueryContract, 
+        ''' as shown above.
+        ''' NOTE: This method requires UnmanagedCodePermission to be called 
+        '''       (full-trust by default), to prevent illegal window handle
+        '''       access in partially trusted scenarios. If the add-in could
+        '''       run in a partially trusted application domain 
+        '''       (eg AddInSecurityLevel.Internet), you can safely return a window
+        '''       handle by overriding ContractBase.QueryContract, as shown above.
+        ''' &lt;/summary&gt;
+        &lt;SecurityPermissionAttribute(SecurityAction.Demand, Flags:=SecurityPermissionFlag.UnmanagedCode)&gt;
+        Public Function GetHandle() As IntPtr Implements INativeHandleContract.GetHandle
+            Return FrameworkElementAdapters.ViewToContractAdapter(Me.wpfAddInView).GetHandle()
+        End Function
+
+    End Class
+End Namespace</code> 
+            <para>、アドインを返すモデルで、 <token>TLA&#2;tla_ui</token> (を参照してください\<link xlink:href="57f274b7-4c66-4b72-92eb-81939a393776">方法: UI 作成、アドインを返すこと</link>)、アドイン アダプタの変換、<codeEntityReference autoUpgrade="true">として</codeEntityReference>に、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>を呼び出して<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter(System.Windows.FrameworkElement)</codeEntityReference>します。<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter(System.Windows.FrameworkElement)</codeEntityReference>からそれを呼び出すコードを記述するメソッドを実装する必要がありますが、このモデルでというもする必要があります。オーバーライドすることで、これを行う<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.ContractBase.QueryContract(System.String)</codeEntityReference>を呼び出すコードを実装して<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter(System.Windows.FrameworkElement)</codeEntityReference>場合を呼び出しているコード<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.ContractBase.QueryContract(System.String)</codeEntityReference>を予期している、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>します。この場合、呼び出し元は、後続のサブセクションで示されているホスト側アダプタになります。</para>
+            <alert class="note">
+              <para>オーバーライドすることも必要<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.ContractBase.QueryContract(System.String)</codeEntityReference>ホスト アプリケーション間のタブ移動を有効にするには、このモデルで<token>TLA&#2;tla_ui</token>とアドインの<token>TLA&#2;tla_ui</token>します。詳細については、WPF アドインの制限事項」を参照してください\<link xlink:href="00b4c776-29a8-4dba-b603-280a0cdc2ade">WPF アドインの概要</link>.</para>
+            </alert>
+            <para>追加アドイン側アダプターから派生するインターフェイスを実装しているため<codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>を実装する必要があります<codeEntityReference autoUpgrade="true">M:System.AddIn.Contract.INativeHandleContract.GetHandle</codeEntityReference>これは無視されますが、ときに<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.ContractBase.QueryContract(System.String)</codeEntityReference>がオーバーライドされます。</para>
+          </content>
+        </section>
+        <section address="HostViewPipeline">
+          <title>ホスト ビュー パイプライン セグメントの実装</title>
+          <content>
+            <para>このモデルでは、ホスト アプリケーション通常がホスト ビューに、<codeEntityReference autoUpgrade="true">として</codeEntityReference>サブクラスです。ホスト側アダプタに変換する必要があります、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>に、<codeEntityReference autoUpgrade="true">として</codeEntityReference>後、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>分離境界を超えています。メソッドを取得するホスト アプリケーションによって呼び出されるされていないため、<codeEntityReference autoUpgrade="true">として</codeEntityReference>、ホスト ビュー必要があります"return"、<codeEntityReference autoUpgrade="true">として</codeEntityReference>で示すことです。その結果、ホスト ビューがのサブクラスから派生する必要があります<codeEntityReference autoUpgrade="true">として</codeEntityReference>他を持つことができる<token>TLA&#2;tla_ui #plural</token>など<codeEntityReference autoUpgrade="true">該当</codeEntityReference>します。次のコードは、ホスト ビューとして実装されたコントラクトの<codeInline>WPFAddInHostView</codeInline>クラスです。</para>
+            <code language="c#">using System.Windows.Controls; // UserControl
+
+namespace HostViews
+{
+    /// &lt;summary&gt;
+    /// Defines the host's view of the add-in
+    /// &lt;/summary&gt;
+    public class WPFAddInHostView : UserControl { }
+}</code>
+          <code language="vb">Imports System.Windows.Controls ' UserControl
+
+Namespace HostViews
+    ''' &lt;summary&gt;
+    ''' Defines the host's view of the add-in
+    ''' &lt;/summary&gt;
+    Public Class WPFAddInHostView
+        Inherits UserControl
+    End Class
+End Namespace</code>
+          </content>
+        </section>
+        <section address="HostSideAdapter">
+          <title>ホスト側アダプター パイプライン セグメントの実装</title>
+          <content>
+            <para>コントラクトは、中に、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>、ホスト アプリケーションが必要ですが、<codeEntityReference autoUpgrade="true">項目に該当</codeEntityReference>(ホスト ビューで、指定した)。その結果、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>に変換する必要があります、<codeEntityReference autoUpgrade="true">として</codeEntityReference>ホスト ビューのコンテンツとして設定する前に、分離境界を通過後 (から派生した<codeEntityReference autoUpgrade="true">該当</codeEntityReference>).</para>
+            <para>の次のコードに示すように、ホスト側アダプターによってこの作業が実行されます。</para> 
+            <code language="c#">using System.AddIn.Contract; // INativeHandleContract
+using System.AddIn.Pipeline; // HostAdapterAttribute, FrameworkElementAdapters, ContractHandle
+using System.Windows; // FrameworkElement
+
+using Contracts; // IWPFAddInContract
+using HostViews; // WPFAddInHostView
+
+namespace HostSideAdapters
+{
+    /// &lt;summary&gt;
+    /// Adapts the add-in contract to the host's view of the add-in
+    /// &lt;/summary&gt;
+    [HostAdapter]
+    public class WPFAddIn_ContractToViewHostSideAdapter : WPFAddInHostView
+    {
+        IWPFAddInContract wpfAddInContract;
+        ContractHandle wpfAddInContractHandle;
+
+        public WPFAddIn_ContractToViewHostSideAdapter(IWPFAddInContract wpfAddInContract)
+        {
+            // Adapt the contract (IWPFAddInContract) to the host application's
+            // view of the contract (WPFAddInHostView)
+            this.wpfAddInContract = wpfAddInContract;
+
+            // Prevent the reference to the contract from being released while the
+            // host application uses the add-in
+            this.wpfAddInContractHandle = new ContractHandle(wpfAddInContract);
+
+            // Convert the INativeHandleContract for the add-in UI that was passed 
+            // from the add-in side of the isolation boundary to a FrameworkElement
+            string aqn = typeof(INativeHandleContract).AssemblyQualifiedName;
+            INativeHandleContract inhc = (INativeHandleContract)wpfAddInContract.QueryContract(aqn);
+            FrameworkElement fe = (FrameworkElement)FrameworkElementAdapters.ContractToViewAdapter(inhc);
+
+            // Add FrameworkElement (which displays the UI provided by the add-in) as
+            // content of the view (a UserControl)
+            this.Content = fe;
+        }
+    }
+}</code> 
+          <code language="vb">Imports System.AddIn.Contract ' INativeHandleContract
+Imports System.AddIn.Pipeline ' HostAdapterAttribute, FrameworkElementAdapters, ContractHandle
+Imports System.Windows ' FrameworkElement
+
+Imports Contracts ' IWPFAddInContract
+Imports HostViews ' WPFAddInHostView
+
+Namespace HostSideAdapters
+    ''' &lt;summary&gt;
+    ''' Adapts the add-in contract to the host's view of the add-in
+    ''' &lt;/summary&gt;
+    &lt;HostAdapter&gt;
+    Public Class WPFAddIn_ContractToViewHostSideAdapter
+        Inherits WPFAddInHostView
+        Private wpfAddInContract As IWPFAddInContract
+        Private wpfAddInContractHandle As ContractHandle
+
+        Public Sub New(ByVal wpfAddInContract As IWPFAddInContract)
+            ' Adapt the contract (IWPFAddInContract) to the host application's
+            ' view of the contract (WPFAddInHostView)
+            Me.wpfAddInContract = wpfAddInContract
+
+            ' Prevent the reference to the contract from being released while the
+            ' host application uses the add-in
+            Me.wpfAddInContractHandle = New ContractHandle(wpfAddInContract)
+
+            ' Convert the INativeHandleContract for the add-in UI that was passed 
+            ' from the add-in side of the isolation boundary to a FrameworkElement
+            Dim aqn As String = GetType(INativeHandleContract).AssemblyQualifiedName
+            Dim inhc As INativeHandleContract = CType(wpfAddInContract.QueryContract(aqn), INativeHandleContract)
+            Dim fe As FrameworkElement = CType(FrameworkElementAdapters.ContractToViewAdapter(inhc), FrameworkElement)
+
+            ' Add FrameworkElement (which displays the UI provided by the add-in) as
+            ' content of the view (a UserControl)
+            Me.Content = fe
+        End Sub
+    End Class
+End Namespace</code> 
+            <para>、ホスト側アダプタを取得するよう、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>を呼び出して追加アドイン側アダプターの<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.ContractBase.QueryContract(System.String)</codeEntityReference>メソッド (これは、ポイントを<codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>分離境界を越える).</para>
+            <para>ホスト側アダプターが次に、変換、 <codeEntityReference autoUpgrade="true">T:System.AddIn.Contract.INativeHandleContract</codeEntityReference>に、<codeEntityReference autoUpgrade="true">として</codeEntityReference>を呼び出して<codeEntityReference autoUpgrade="true">M:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter(System.AddIn.Contract.INativeHandleContract)</codeEntityReference>します。最後に、<codeEntityReference autoUpgrade="true">として</codeEntityReference>ホスト ビューのコンテンツとして設定します。</para>
+          </content>
+        </section>
+        <section address="AddIn">
+          <title>アドインを実装する</title>
+          <content>
+            <para>追加アドイン側アダプターとアドインのビューが用意で、アドインを実装できます、アドイン ビューから派生することで次のコードに示すようにします</para>。
+            <code language="xaml">&lt;addInViews:WPFAddInView
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:addInViews="clr-namespace:AddInViews;assembly=AddInViews"
+    x:Class="WPFAddIn1.AddInUI"&gt;
+
+    &lt;Grid&gt;
+        &lt;Button Click="clickMeButton_Click" Content="Click Me!" /&gt;        
+    &lt;/Grid&gt;
+
+&lt;/addInViews:WPFAddInView&gt;</code> 
+            <code language="c#">using System.AddIn; // AddInAttribute
+using System.Windows; // MessageBox, RoutedEventArgs
+
+using AddInViews; // WPFAddInView
+
+namespace WPFAddIn1
+{
+    /// &lt;summary&gt;
+    /// Implements the add-in by deriving from WPFAddInView
+    /// &lt;/summary&gt;
+    [AddIn("WPF Add-In 1")]
+    public partial class AddInUI : WPFAddInView
+    {
+        public AddInUI()
+        {
+            InitializeComponent();
+        }
+
+        void clickMeButton_Click(object sender, RoutedEventArgs e)
+        {
+            MessageBox.Show("Hello from WPFAddIn1");
+        }
+    }
+}</code> 
+          <code language="vb">Imports System.AddIn ' AddInAttribute
+Imports System.Windows ' MessageBox, RoutedEventArgs
+
+Imports AddInViews ' WPFAddInView
+
+Namespace WPFAddIn1
+    ''' &lt;summary&gt;
+    ''' Implements the add-in by deriving from WPFAddInView
+    ''' &lt;/summary&gt;
+    &lt;AddIn("WPF Add-In 1")&gt;
+    Partial Public Class AddInUI
+        Inherits WPFAddInView
+        Public Sub New()
+            InitializeComponent()
+        End Sub
+
+        Private Sub clickMeButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
+            MessageBox.Show("Hello from WPFAddIn1")
+        End Sub
+    End Class
+End Namespace</code>
+            <para>からこの例では、このモデルの 1 つの興味深い利点を確認できます。 アドイン開発者はのみアドインを実装する必要があります (であるため、 <token>TLA&#2;tla_ui</token>も)、アドイン クラスとアドインの両方ではなく<token>TLA&#2;tla_ui</token>します。</para>
+          </content>
+        </section>
+        <section address="HostApp">
+          <title>ホスト アプリケーションを実装する</title>
+          <content>
+            <para>ホスト側アダプターとホスト ビューの作成、ホスト アプリケーションが使用できます、 <token>dnprdnshort</token>アドイン モデルでは、パイプラインを開き、アドインのホスト ビューを取得します。次の手順は、次のコードに表示されます。</para> 
+            <code language="c#">// Get add-in pipeline folder (the folder in which this application was launched from)
+string appPath = Environment.CurrentDirectory;
+
+// Rebuild visual add-in pipeline
+string[] warnings = AddInStore.Rebuild(appPath);
+if (warnings.Length &gt; 0)
+{
+    string msg = "Could not rebuild pipeline:";
+    foreach (string warning in warnings) msg += "\n" + warning;
+    MessageBox.Show(msg);
+    return;
+}
+
+// Activate add-in with Internet zone security isolation
+Collection&lt;AddInToken&gt; addInTokens = AddInStore.FindAddIns(typeof(WPFAddInHostView), appPath);
+AddInToken wpfAddInToken = addInTokens[0];
+this.wpfAddInHostView = wpfAddInToken.Activate&lt;WPFAddInHostView&gt;(AddInSecurityLevel.Internet);
+
+// Display add-in UI
+this.addInUIHostGrid.Children.Add(this.wpfAddInHostView);</code> 
+          <code language="vb">' Get add-in pipeline folder (the folder in which this application was launched from)
+Dim appPath As String = Environment.CurrentDirectory
+
+' Rebuild visual add-in pipeline
+Dim warnings() As String = AddInStore.Rebuild(appPath)
+If warnings.Length &gt; 0 Then
+    Dim msg As String = "Could not rebuild pipeline:"
+    For Each warning As String In warnings
+        msg &amp;= vbLf &amp; warning
+    Next warning
+    MessageBox.Show(msg)
+    Return
+End If
+
+' Activate add-in with Internet zone security isolation
+Dim addInTokens As Collection(Of AddInToken) = AddInStore.FindAddIns(GetType(WPFAddInHostView), appPath)
+Dim wpfAddInToken As AddInToken = addInTokens(0)
+Me.wpfAddInHostView = wpfAddInToken.Activate(Of WPFAddInHostView)(AddInSecurityLevel.Internet)
+
+' Display add-in UI
+Me.addInUIHostGrid.Children.Add(Me.wpfAddInHostView)</code>
+            <para>ホスト アプリケーションは標準的な<token>dnprdnshort</token>アドイン モデルではアクティブにするコード、アドインに暗黙的に、ホスト アプリケーションに、ホスト ビューを返します。その後、ホスト アプリケーションにはホスト ビューが表示されます (これは、<codeEntityReference autoUpgrade="true">該当</codeEntityReference>) から、<codeEntityReference autoUpgrade="true">テーブルを作成</codeEntityReference>.</para>
+            <para>アドインとの対話を処理するためのコード<token>TLA&#2;tla_ui</token>アドインのアプリケーション ドメインで実行します。これらの対話には、次が含まれます:</para>
+            <list class="bullet">
+              <listItem>
+                <para>処理、<codeEntityReference autoUpgrade="true">プロパティ</codeEntityReference> <codeEntityReference autoUpgrade="true">ここ</codeEntityReference>イベント</para>。
+              </listItem> 
+              <listItem>
+                <para>を示す、<codeEntityReference autoUpgrade="true">実行</codeEntityReference>.</para>
+              </listItem> 
+            </list>
+            <para>このアクティビティは、ホスト アプリケーションから完全に分離します。</para>
+          </content>
+        </section>
+      </sections>
+    </legacy>
+  </codeExample>
+  <relatedTopics>
+\<legacyLink xlink:href="8dd45b02-7218-40f9-857d-40d7b98b850b">アドインと拡張</legacyLink>
+\<link xlink:href="00b4c776-29a8-4dba-b603-280a0cdc2ade">WPF アドインの概要</link>
+</relatedTopics>
+</developerHowToDocument>
diff --git a/docs/framework/wpf/app-development/how-to-create-an-add-in-that-returns-a-ui.md b/docs/framework/wpf/app-development/how-to-create-an-add-in-that-returns-a-ui.md
new file mode 100644
index 00000000000..f0d0e147463
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-create-an-add-in-that-returns-a-ui.md
@@ -0,0 +1,99 @@
+---
+title: "方法 : UI を返すアドインを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アドイン [WPF], 返す (UI を)"
+  - "作成 (UI を返すアドインを) [WPF]"
+  - "実装 (アドイン パイプライン セグメントを) [WPF]"
+ms.assetid: 57f274b7-4c66-4b72-92eb-81939a393776
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : UI を返すアドインを作成する
+この例では、ホスト [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] スタンドアロン アプリケーションに [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を返すアドインを作成する方法を示します。  
+  
+ このアドインが返す[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ユーザー コントロールです。  ユーザー コントロールの中身は単一のボタンで、クリックするとメッセージ ボックスを表示します。  このアドインは [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] スタンドアロン アプリケーションがホストし、アドインが返すユーザー コントロールをメイン アプリケーション ウィンドウのコンテンツとして表示します。  
+  
+ **必要条件**  
+  
+ この例では、このシナリオを実現する [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 拡張機能に焦点を当てます。前提条件は次のとおりです。  
+  
+-   パイプライン、アドイン、ホスト開発など、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルについて知っていること。  これらの概念の詳細については、「[アドインおよび拡張機能](../../../../ml/index.xml)」を参照してください。  パイプライン、アドイン、およびホスト アプリケーションの実装例を示すチュートリアルについては、「[チュートリアル : 拡張性のあるアプリケーションの作成](../Topic/Walkthrough:%20Creating%20an%20Extensible%20Application.md)」を参照してください。  
+  
+-   [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 拡張機能について知っていること。詳細については、「[WPF アドインの概要](../../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)」を参照してください。  
+  
+## 使用例  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返すアドインを作成するには、各パイプライン セグメント、アドイン、およびホスト アプリケーションに特定のコードが必要です。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Contract"></a>   
+## コントラクト パイプライン セグメントの実装  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返すようにするには、メソッドはコントラクトで宣言し、その戻り値を <xref:System.AddIn.Contract.INativeHandleContract> 型にする必要があります。  次のコードではこれについて、`IWPFAddInContract` コントラクトの `GetAddInUI` メソッドによって示します。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#ContractCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/Contracts/IWPFAddInContract.cs#contractcode)]
+ [!code-vb[SimpleAddInReturnsAUISample#ContractCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/Contracts/IWPFAddInContract.vb#contractcode)]  
+  
+<a name="AddInView"></a>   
+## アドイン ビュー パイプライン セグメントの実装  
+ アドインは [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を実装するため、<xref:System.Windows.FrameworkElement> のサブクラスとして提供します。`IWPFAddInView.GetAddInUI` に関連するアドイン ビューのメソッドは <xref:System.Windows.FrameworkElement> 型の値を返す必要があります。  次のコードでは、コントラクトのアドイン ビューがインターフェイスとして実装されています。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#AddInViewCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/AddInViews/IWPFAddInView.cs#addinviewcode)]
+ [!code-vb[SimpleAddInReturnsAUISample#AddInViewCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/AddInViews/IWPFAddInView.vb#addinviewcode)]  
+  
+<a name="AddInSideAdapter"></a>   
+## アドイン側アダプター パイプライン セグメントの実装  
+ コントラクト メソッドは <xref:System.AddIn.Contract.INativeHandleContract> を返しますが、アドインは <xref:System.Windows.FrameworkElement> を返します \(アドイン ビューの指定のとおり\)。  したがって、<xref:System.Windows.FrameworkElement> は、分離境界を越える前に <xref:System.AddIn.Contract.INativeHandleContract> に変換される必要があります。  この処理は、次のコードに示すように、アドイン側のアダプターで <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> を呼び出して実行されます。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#AddInSideAdapterCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/AddInSideAdapters/WPFAddIn_ViewToContractAddInSideAdapter.cs#addinsideadaptercode)]
+ [!code-vb[SimpleAddInReturnsAUISample#AddInSideAdapterCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/AddInSideAdapters/WPFAddIn_ViewToContractAddInSideAdapter.vb#addinsideadaptercode)]  
+  
+<a name="HostView"></a>   
+## ホスト ビュー パイプライン セグメントの実装  
+ ホスト アプリケーションは <xref:System.Windows.FrameworkElement> を表示するため、`IWPFAddInHostView.GetAddInUI` に関連するホスト ビューのメソッドは <xref:System.Windows.FrameworkElement> 型の値を返す必要があります。  次のコードでは、コントラクトのホスト ビューがインターフェイスとして実装されています。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#HostViewCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/HostViews/IWPFAddInHostView.cs#hostviewcode)]
+ [!code-vb[SimpleAddInReturnsAUISample#HostViewCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/HostViews/IWPFAddInHostView.vb#hostviewcode)]  
+  
+<a name="HostSideAdapter"></a>   
+## ホスト側アダプター パイプライン セグメントの実装  
+ コントラクト メソッドは <xref:System.AddIn.Contract.INativeHandleContract> を返しますが、ホスト アプリケーションでは <xref:System.Windows.FrameworkElement> が想定されています \(ホスト ビューの指定のとおり\)。  したがって、<xref:System.AddIn.Contract.INativeHandleContract> は、分離境界を越えた後に <xref:System.Windows.FrameworkElement> に変換される必要があります。  この処理は、次のコードに示されているように、ホスト側のアダプターで <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> を呼び出して実行されます。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#HostSideAdapterCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/HostSideAdapters/WPFAddIn_ContractToViewHostSideAdapter.cs#hostsideadaptercode)]
+ [!code-vb[SimpleAddInReturnsAUISample#HostSideAdapterCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/HostSideAdapters/WPFAddIn_ContractToViewHostSideAdapter.vb#hostsideadaptercode)]  
+  
+<a name="AddIn"></a>   
+## アドインの実装  
+ アドイン側のアダプターとアドイン ビューを作成したら、アドイン \(`WPFAddIn1.AddIn`\) に `IWPFAddInView.GetAddInUI` メソッドを実装して、<xref:System.Windows.FrameworkElement> オブジェクト \(この例では <xref:System.Windows.Controls.UserControl>\) を返すようにする必要があります。  <xref:System.Windows.Controls.UserControl> \(`AddInUI`\) は次のコードに示すように実装します。  
+  
+ [!code-xml[SimpleAddInReturnsAUISample#AddInUIMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/WPFAddIn1/AddInUI.xaml#addinuimarkup)]  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#AddInUICodeBehind](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/WPFAddIn1/AddInUI.xaml.cs#addinuicodebehind)]
+ [!code-vb[SimpleAddInReturnsAUISample#AddInUICodeBehind](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/WPFAddIn1/AddInUI.xaml.vb#addinuicodebehind)]  
+  
+ アドインの `IWPFAddInView.GetAddInUI` の実装では、次のコードに示すように、`AddInUI` の新しいインスタンスを返すだけです。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#AddInCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/WPFAddIn1/AddIn.cs#addincode)]
+ [!code-vb[SimpleAddInReturnsAUISample#AddInCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/WPFAddIn1/AddIn.vb#addincode)]  
+  
+<a name="App"></a>   
+## ホスト アプリケーションの実装  
+ ホスト側のアダプターとホスト ビューが作成されると、ホスト アプリケーションで [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルを使用して、パイプラインを開き、アドインのビューを取得し、`IWPFAddInHostView.GetAddInUI` メソッドを呼び出すことができます。  これらの手順を次にコードに示します。  
+  
+ [!code-csharp[SimpleAddInReturnsAUISample#GetUICode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/CSharp/Host/MainWindow.xaml.cs#getuicode)]
+ [!code-vb[SimpleAddInReturnsAUISample#GetUICode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleAddInReturnsAUISample/VisualBasic/Host/MainWindow.xaml.vb#getuicode)]  
+  
+## 参照  
+ [アドインおよび拡張機能](../../../../ml/index.xml)   
+ [WPF アドインの概要](../../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md
new file mode 100644
index 00000000000..5d2d8e97556
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md
@@ -0,0 +1,134 @@
+---
+title: "方法: .NET Framework 3.0 がインストールされているかどうかを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "検出 (WPF の存在を)"
+  - "WPT の存在, 検出"
+  - "WinFX ランタイム ユーザー エージェント文字列"
+ms.assetid: 7f71d652-1749-4379-945a-aa2e3994cb43
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法: .NET Framework 3.0 がインストールされているかどうかを確認する
+管理者が [!INCLUDE[TLA#tla_avalonwinfx](../../../../includes/tlasharptla-avalonwinfx-md.md)] アプリケーションをシステムに配置するには、最初に、[!INCLUDE[TLA2#tla_avalonwinfx](../../../../includes/tla2sharptla-avalonwinfx-md.md)] ランタイムが存在することを確認する必要があります。  ここでは、システムに [!INCLUDE[TLA2#tla_avalonwinfx](../../../../includes/tla2sharptla-avalonwinfx-md.md)] が存在するかどうかを確認するための、HTML\/JavaScript で記述されたスクリプトを示します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] のインストール、配置、および検出の詳細については、「[Deploying Microsoft .NET Framework Version 3.0](http://go.microsoft.com/fwlink/?LinkId=96739)」を参照してください。  
+  
+<a name="content_expiration"></a>   
+## ".NET CLR" ユーザー エージェント文字列の検出  
+ [!INCLUDE[TLA2#tla_avalonwinfx](../../../../includes/tla2sharptla-avalonwinfx-md.md)] がインストールされるときに、MSI によって ".NET CLR" およびバージョン番号が UserAgent 文字列に追加されます。  次の例では、単純な HTML ページに埋め込まれたスクリプトを示します。  このスクリプトは、UserAgent 文字列を検索して、[!INCLUDE[TLA2#tla_avalonwinfx](../../../../includes/tla2sharptla-avalonwinfx-md.md)] がインストールされているかどうかを判断し、検索の結果についてのステータス メッセージを表示します。  
+  
+```  
+<HTML>  
+  <HEAD>  
+    <TITLE>Test for the .NET Framework 3.0</TITLE>  
+    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />  
+    <SCRIPT LANGUAGE="JavaScript">  
+    <!--  
+    var dotNETRuntimeVersion = "3.0.04425.00";  
+  
+    function window::onload()  
+    {  
+      if (HasRuntimeVersion(dotNETRuntimeVersion))  
+      {  
+        result.innerText =   
+          "This machine has the correct version of the .NET Framework 3.0: "   
+          + dotNETRuntimeVersion  
+      }   
+      else  
+      {  
+        result.innerText =   
+          "This machine does not have the correct version of the .NET Framework 3.0."  
+      }  
+      result.innerText += "\n\nThis machine's userAgent string is: " +   
+        navigator.userAgent + ".";  
+    }  
+  
+    //  
+    // Retrieve the version from the user agent string and   
+    // compare with the specified version.  
+    //  
+    function HasRuntimeVersion(versionToCheck)  
+    {  
+      var userAgentString =   
+        navigator.userAgent.match(/.NET CLR [0-9.]+/g);  
+  
+      if (userAgentString != null)  
+      {  
+        var i;  
+  
+        for (i = 0; i < userAgentString.length; ++i)  
+        {  
+          if (CompareVersions(GetVersion(versionToCheck),   
+            GetVersion(userAgentString[i])) <= 0)  
+            return true;  
+        }  
+      }  
+  
+      return false;  
+    }  
+  
+    //  
+    // Extract the numeric part of the version string.  
+    //  
+    function GetVersion(versionString)  
+    {  
+      var numericString =   
+        versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);  
+      return numericString.slice(1);  
+    }  
+  
+    //  
+    // Compare the 2 version strings by converting them to numeric format.  
+    //  
+    function CompareVersions(version1, version2)  
+    {  
+      for (i = 0; i < version1.length; ++i)  
+      {  
+        var number1 = new Number(version1[i]);  
+        var number2 = new Number(version2[i]);  
+  
+        if (number1 < number2)  
+          return -1;  
+  
+        if (number1 > number2)  
+          return 1;  
+      }  
+  
+      return 0;  
+    }  
+  
+    -->  
+    </SCRIPT>  
+  </HEAD>  
+  
+  <BODY>  
+    <div id="result" />  
+  </BODY>  
+</HTML>  
+  
+```  
+  
+ ".NET CLR " バージョンが検出された場合は、次のようなステータス メッセージが表示されます。  
+  
+ `This machine has the correct version of the .NET Framework 3.0: 3.0.04425.00`  
+  
+ `This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; .NET CLR 1.1.4322; InfoPath.1; .NET CLR 2.0.50727; .NET CLR 3.0.04425.00).`  
+  
+ それ以外の場合は、次のようなステータス メッセージが表示されます。  
+  
+ `This machine does not have correct version of the .NET Framework 3.0.`  
+  
+ `This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; .NET CLR 1.1.4322; InfoPath.1; .NET CLR 2.0.50727).`
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md
new file mode 100644
index 00000000000..032e4943367
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md
@@ -0,0 +1,140 @@
+---
+title: "方法: .NET Framework 3.5 がインストールされているかどうかを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "検出 (.NET Framework 3.5 のインストールを) [WPF]"
+  - "検出 (.NET Framework 3.5 がインストールされているかどうかを) [WPF]"
+  - "確認 (.NET Framework 3.5 がインストールされているかどうかを) [WPF]"
+  - "検証 (.NET Framework 3.5 がインストールされているかどうかを) [WPF]"
+ms.assetid: 8556a9d2-1eb8-48ef-919c-5baf22a2a9a2
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: .NET Framework 3.5 がインストールされているかどうかを確認する
+管理者が [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションを [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] に対応するシステムに配置するには、最初に、[!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] ランタイムが存在することを確認する必要があります。  ここでは、システムに [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] が存在するかどうかを確認するための、HTML\/JavaScript で記述されたスクリプトを示します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のインストール、配置、および検出の詳細については、「[.NET Framework のインストール](../../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+## 使用例  
+ [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] がインストールされるときに、MSI によって ".NET CLR" およびバージョン番号が UserAgent 文字列に追加されます。  次の例では、単純な HTML ページに埋め込まれたスクリプトを示します。  このスクリプトは、UserAgent 文字列を検索して、[!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] がインストールされているかどうかを判断し、検索の結果についてのステータス メッセージを表示します。  
+  
+> [!NOTE]
+>  このスクリプトは Internet Explorer 向けです。  他のブラウザーでは、UserAgent 文字列に .NET CLR の情報は含まれません。  
+  
+```  
+<HTML>  
+  <HEAD>  
+    <TITLE>Test for the .NET Framework 3.5</TITLE>  
+    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />  
+    <SCRIPT LANGUAGE="JavaScript">  
+    <!--  
+    var dotNETRuntimeVersion = "3.5.0.0";  
+  
+    function window::onload()  
+    {  
+      if (HasRuntimeVersion(dotNETRuntimeVersion))  
+      {  
+        result.innerText =   
+          "This machine has the correct version of the .NET Framework 3.5."  
+      }   
+      else  
+      {  
+        result.innerText =   
+          "This machine does not have the correct version of the .NET Framework 3.5." +  
+          " The required version is v" + dotNETRuntimeVersion + ".";  
+      }  
+      result.innerText += "\n\nThis machine's userAgent string is: " +   
+        navigator.userAgent + ".";  
+    }  
+  
+    //  
+    // Retrieve the version from the user agent string and   
+    // compare with the specified version.  
+    //  
+    function HasRuntimeVersion(versionToCheck)  
+    {  
+      var userAgentString =   
+        navigator.userAgent.match(/.NET CLR [0-9.]+/g);  
+  
+      if (userAgentString != null)  
+      {  
+        var i;  
+  
+        for (i = 0; i < userAgentString.length; ++i)  
+        {  
+          if (CompareVersions(GetVersion(versionToCheck),   
+            GetVersion(userAgentString[i])) <= 0)  
+            return true;  
+        }  
+      }  
+  
+      return false;  
+    }  
+  
+    //  
+    // Extract the numeric part of the version string.  
+    //  
+    function GetVersion(versionString)  
+    {  
+      var numericString =   
+        versionString.match(/([0-9]+)\.([0-9]+)\.([0-9]+)/i);  
+      return numericString.slice(1);  
+    }  
+  
+    //  
+    // Compare the 2 version strings by converting them to numeric format.  
+    //  
+    function CompareVersions(version1, version2)  
+    {  
+      for (i = 0; i < version1.length; ++i)  
+      {  
+        var number1 = new Number(version1[i]);  
+        var number2 = new Number(version2[i]);  
+  
+        if (number1 < number2)  
+          return -1;  
+  
+        if (number1 > number2)  
+          return 1;  
+      }  
+  
+      return 0;  
+    }  
+  
+    -->  
+    </SCRIPT>  
+  </HEAD>  
+  
+  <BODY>  
+    <div id="result" />  
+  </BODY>  
+</HTML>  
+  
+```  
+  
+ ".NET CLR " バージョンが検出された場合は、次のようなステータス メッセージが表示されます。  
+  
+ `This machine has the correct version of the .NET Framework 3.5.`  
+  
+ `This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0; SLCC1; .NET CLR 2.0.50727; .NET CLR 1.1.4322; InfoPath.2; .NET CLR 3.0.590; .NET CLR 3.5.20726; MS-RTC LM 8).`  
+  
+ それ以外の場合は、次のようなステータス メッセージが表示されます。  
+  
+ `This machine does not have the correct version of the .NET Framework 3.5.  The required version is v3.5.0.0.`  
+  
+ `This machine's userAgent string is: Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0; SLCC1; .NET CLR 2.0.50727; .NET CLR 1.1.4322; InfoPath.2; .NET CLR 3.0.590; MS-RTC LM 8).`  
+  
+## 参照  
+ [.NET Framework 3.0 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md b/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md
new file mode 100644
index 00000000000..f36bfd94a91
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-detect-whether-the-wpf-plug-in-for-firefox-is-installed.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : Firefox に対応した WPF プラグインがインストールされているかどうかを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "確認 (Firefox プラグインを) [WPF]"
+  - "検出 (Firefox のインストールを) [WPF]"
+  - "検出 (Firefox に対応した WPF プラグインがインストールされているかどうかを) [WPF]"
+  - "Firefox [WPF], 検出 (インストールを)"
+  - "Firefox に対応したプラグイン [WPF]"
+ms.assetid: 5f839373-e3fb-44f1-88ad-4a0761f02189
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : Firefox に対応した WPF プラグインがインストールされているかどうかを確認する
+Firefox に対応した [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] プラグインを使用すると、[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] ファイルおよび Loose XAML ファイルを Mozilla Firefox ブラウザーで実行できます。  ここでは、Firefox に対応した WPF プラグインがインストールされているかどうかを確認するための、HTML および JavaScript で記述されたスクリプトを示します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のインストール、配置、および検出の詳細については、「[.NET Framework のインストール](../../../../docs/framework/install/guide-for-developers.md)」を参照してください。  
+  
+## 使用例  
+ [!INCLUDE[net_v35_short](../../../../includes/net-v35-short-md.md)] がインストールされると、クライアント コンピューターは、Firefox に対応した WPF プラグインで構成されます。  Firefox に対応した WPF プラグインの有無をチェックして、適切なステータス メッセージを表示するスクリプトの例を次に示します。  
+  
+```  
+<HTML>  
+  
+  <HEAD>  
+    <TITLE>Test for the WPF plug-in for Firefox</TITLE>  
+    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8" />  
+    <SCRIPT type="text/javascript">  
+    <!--  
+    function OnLoad()  
+    {  
+  
+       // Check for the WPF plug-in for Firefox and report  
+       var msg = "The WPF plug-in for Firefox is ";  
+       var wpfPlugin = navigator.plugins["Windows Presentation Foundation"];  
+       if( wpfPlugin != null ) {  
+          document.writeln(msg + " installed.");  
+       }  
+       else {  
+          document.writeln(msg + " not installed. Please install or reinstall the .NET Framework 3.5.");  
+       }  
+    }  
+    -->  
+    </SCRIPT>  
+  </HEAD>  
+  
+  <BODY onload="OnLoad()" />  
+  
+</HTML>  
+```  
+  
+ Firefox に対応した WPF プラグインの有無のチェックが成功すると、次のステータス メッセージが表示されます。  
+  
+ `The WPF plug-in for Firefox is installed.`  
+  
+ それ以外の場合は、次のステータス メッセージが表示されます。  
+  
+ `The WPF plug-in for Firefox is not installed.  Please install or reinstall the .NET Framework 3.5.`  
+  
+## 参照  
+ [.NET Framework 3.0 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-0-is-installed.md)   
+ [.NET Framework 3.5 がインストールされているかどうかの確認](../../../../docs/framework/wpf/app-development/how-to-detect-whether-the-net-framework-3-5-is-installed.md)   
+ [WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-determine-the-installed-version-of-wpf.md b/docs/framework/wpf/app-development/how-to-determine-the-installed-version-of-wpf.md
new file mode 100644
index 00000000000..ec3db7ec58f
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-determine-the-installed-version-of-wpf.md
@@ -0,0 +1,34 @@
+---
+title: "方法: インストールされている WPF のバージョンを確認する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バージョン, 検索"
+ms.assetid: 99971cef-e218-4f9f-a4c1-350332741860
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法: インストールされている WPF のバージョンを確認する
+現在インストールされている [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のバージョン番号は、**レジストリ**にあります。  
+  
+ バージョン番号を確認するには、次の操作を実行します。  
+  
+1.  **\[スタート\]** メニューの **\[ファイル名を指定して実行\]** をクリックします。  
+  
+2.  \[名前 :\] に「**regedit.exe**」と入力します。  
+  
+3.  次のキーを開きます。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.0\Setup\Windows Presentation Foundation`  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のバージョン番号は、**Version** の値に格納されています。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-get-the-return-value-of-a-page-function.md b/docs/framework/wpf/app-development/how-to-get-the-return-value-of-a-page-function.md
new file mode 100644
index 00000000000..155a7e16378
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-get-the-return-value-of-a-page-function.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : ページ関数の戻り値を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "関数, 取得 (戻り値を)"
+  - "取得, ページ関数の戻り値"
+  - "ページ関数, 取得 (戻り値を)"
+  - "ページ関数の戻り値"
+ms.assetid: 75470af6-256c-4c46-87e7-705080723a1c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ページ関数の戻り値を取得する
+この例では、ページ関数から返された結果を取得する方法を示します。  
+  
+## 使用例  
+ ページ関数から返された結果を取得するには、呼び出し先のページ関数の <xref:System.Windows.Navigation.PageFunction%601.Return> を処理する必要があります。  
+  
+ [!code-xml[HOWTOPageFunctionSnippets#CallAPageFunctionXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/CallingPage.xaml#callapagefunctionxaml)]  
+  
+ [!code-csharp[HOWTOPageFunctionSnippets#GetPageFunctionResultCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/CallingPage.xaml.cs#getpagefunctionresultcodebehind)]
+ [!code-vb[HOWTOPageFunctionSnippets#GetPageFunctionResultCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/VisualBasic/CallingPage.xaml.vb#getpagefunctionresultcodebehind)]  
+  
+## 参照  
+ <xref:System.Windows.Navigation.PageFunction%601>
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-navigate-forward-or-back-through-navigation-history.md b/docs/framework/wpf/app-development/how-to-navigate-forward-or-back-through-navigation-history.md
new file mode 100644
index 00000000000..84d38225a29
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-navigate-forward-or-back-through-navigation-history.md
@@ -0,0 +1,47 @@
+---
+title: "方法: 移動履歴を前後へ移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "履歴, 移動, 移動 (前方へ)"
+  - "移動, ナビゲーション履歴 (前方)"
+ms.assetid: 5939d574-5f53-469e-85f5-1f2b13607caa
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法: 移動履歴を前後へ移動する
+この例では" 進む " ナビゲーション履歴のエントリに移動する方法を示します。  
+  
+## 使用例  
+ 次のコンテンツをホストから実行がナビゲーション履歴を転送します。またはその逆を移動できること 1 エントリずつコードします。  
+  
+-   <xref:System.Windows.Navigation.NavigationService> を使用して <xref:System.Windows.Navigation.NavigationWindow>  
+  
+-   <xref:System.Windows.Navigation.NavigationService> を使用して <xref:System.Windows.Controls.Frame>  
+  
+-   [!INCLUDE[TLA#tla_iegeneric](../../../../includes/tlasharptla-iegeneric-md.md)]  
+  
+ 1 エントリ前方に移動する前にまず **CanGoForward** のプロパティを調べることによって" 進む " ナビゲーション履歴にエントリ実行することを確認する必要があります。  前方に移動するには**GoForward** 1 エントリのメソッドを呼び出します。  この操作を次の例に示します。  
+  
+ [!code-csharp[HOWTONavigationSnippets#NavigateForwardCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTONavigationSnippets/CSharp/HomePage.xaml.cs#navigateforwardcode)]
+ [!code-vb[HOWTONavigationSnippets#NavigateForwardCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTONavigationSnippets/visualbasic/homepage.xaml.vb#navigateforwardcode)]  
+  
+ 1 エントリを移動する前に**CanGoBack** のプロパティを調べることによって" 戻る " ナビゲーション履歴にエントリ実行することを確認する必要があります。  1 エントリを移動するには**GoBack** のメソッドを呼び出します。  この操作を次の例に示します。  
+  
+ [!code-csharp[HOWTONavigationSnippets#NavigateBackCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTONavigationSnippets/CSharp/HomePage.xaml.cs#navigatebackcode)]
+ [!code-vb[HOWTONavigationSnippets#NavigateBackCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTONavigationSnippets/visualbasic/homepage.xaml.vb#navigatebackcode)]  
+  
+ **CanGoForward** **GoForward** **CanGoBack** と **GoBack** は <xref:System.Windows.Navigation.NavigationWindow><xref:System.Windows.Controls.Frame> と <xref:System.Windows.Navigation.NavigationService> によって実装されます。  
+  
+> [!NOTE]
+>  **GoForward** と " 進む " ナビゲーション履歴にエントリが呼び出すと**GoBack** を呼び出すと戻る " ナビゲーション履歴にエントリがない場合<xref:System.InvalidOperationException> がスローされます。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-return-from-a-page-function.md b/docs/framework/wpf/app-development/how-to-return-from-a-page-function.md
new file mode 100644
index 00000000000..3e2960951a8
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-return-from-a-page-function.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : ページ関数から戻る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "関数, 返す"
+  - "ページ関数, 返す"
+  - "返す (ページ関数から)"
+ms.assetid: 87804905-7e8f-417b-b0e3-5622da686396
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ページ関数から戻る
+この例では、ページ関数から結果を返す方法を示します。  
+  
+## 使用例  
+ ページ関数から結果を返すには、<xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> を呼び出して <xref:System.Windows.Navigation.ReturnEventArgs%601> のインスタンスを渡す必要があります。  
+  
+ [!code-xml[HOWTOPageFunctionSnippets#PageFunctionReturnAResultXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/GetStringPageFunction.xaml#pagefunctionreturnaresultxaml1)]  
+[!code-xml[HOWTOPageFunctionSnippets#PageFunctionReturnAResultXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/GetStringPageFunction.xaml#pagefunctionreturnaresultxaml2)]  
+  
+ [!code-csharp[HOWTOPageFunctionSnippets#PageFunctionReturnAResultCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/CSharp/GetStringPageFunction.xaml.cs#pagefunctionreturnaresultcodebehind)]
+ [!code-vb[HOWTOPageFunctionSnippets#PageFunctionReturnAResultCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOPageFunctionSnippets/VisualBasic/GetStringPageFunction.xaml.vb#pagefunctionreturnaresultcodebehind)]  
+  
+## 参照  
+ <xref:System.Windows.Navigation.PageFunction%601>
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-topics.md b/docs/framework/wpf/app-development/how-to-topics.md
new file mode 100644
index 00000000000..a08872e8118
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-topics.md
@@ -0,0 +1,33 @@
+---
+title: "方法のトピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アドイン [WPF], UI である"
+  - "アドイン [WPF], 返す (UI を)"
+  - "作成 (アドインを) [WPF]"
+ms.assetid: c33980e8-36e7-45ce-a485-8c826dd29009
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法のトピック
+以下のトピックでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アドインの作成方法を示します。  
+  
+## このセクションの内容  
+ [UI を返すアドインを作成する](../../../../docs/framework/wpf/app-development/how-to-create-an-add-in-that-returns-a-ui.md)  
+ [UI であるアドインを作成する](../../../../docs/framework/wpf/app-development/how-to-create-an-add-in-that-is-a-ui.md)  
+  
+## 関連項目  
+ [WPF アドインの概要](../../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/how-to-use-an-application-scope-resource-dictionary.md b/docs/framework/wpf/app-development/how-to-use-an-application-scope-resource-dictionary.md
new file mode 100644
index 00000000000..3f29a0167b9
--- /dev/null
+++ b/docs/framework/wpf/app-development/how-to-use-an-application-scope-resource-dictionary.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : アプリケーション スコープのリソース ディクショナリを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション スコープのリソース ディクショナリ"
+  - "ディクショナリ, リソース"
+  - "リソース ディクショナリ, アプリケーション スコープ"
+ms.assetid: 53857682-bd2c-4f2c-8f25-1307d0b451a2
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : アプリケーション スコープのリソース ディクショナリを使用する
+この例では、アプリケーション スコープのカスタム リソース ディクショナリを定義および使用する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Application> は、共有リソースのアプリケーション スコープのストアである <xref:System.Windows.Application.Resources%2A> を公開します。  既定では、<xref:System.Windows.Application.Resources%2A> プロパティは、<xref:System.Windows.ResourceDictionary> 型のインスタンスで初期化されます。  このインスタンスは、<xref:System.Windows.Application.Resources%2A> を使用してアプリケーション スコープのプロパティを取得および設定する場合に使用します。  \(詳細については、「[How to: Get and Set an Application\-Scope Resource](http://msdn.microsoft.com/ja-jp/39e0420c-c9fc-47dc-8956-fdd95b214095)」を参照してください\)。  
+  
+ <xref:System.Windows.Application.Resources%2A> を使用して設定したリソースが複数ある場合は、カスタム リソース ディクショナリを使用してこれらのリソースを格納し、<xref:System.Windows.Application.Resources%2A> を設定することができます。  次に示すのは、XAML を使用してカスタム リソース ディクショナリを宣言する方法です。  
+  
+ [!code-xml[HOWTOResourceDictionaries#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToResourceDictionaries/CSharp/MyResourceDictionary.xaml#1)]  
+  
+ <xref:System.Windows.Application.Resources%2A> を使用してリソース ディクショナリ全体を交換することで、各テーマが単一のリソース ディクショナリでカプセル化されているアプリケーション スコープのテーマをサポートすることができます。  <xref:System.Windows.ResourceDictionary> を設定する方法を次の例に示します。  
+  
+ [!code-xml[HOWTOResourceDictionaries#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToResourceDictionaries/CSharp/App.xaml#2)]  
+  
+ 次に示すのは、XAML の <xref:System.Windows.Application.Resources%2A> で公開されたリソース ディクショナリから、アプリケーション スコープのリソースを取得する方法です。  
+  
+ [!code-xml[HOWTOResourceDictionaries#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToResourceDictionaries/CSharp/MainWindow.xaml#4)]  
+  
+ 次に示すのは、コードでリソースを取得する方法です。  
+  
+ [!code-csharp[HOWTOResourceDictionaries#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HowToResourceDictionaries/CSharp/MainWindow.xaml.cs#3)]
+ [!code-vb[HOWTOResourceDictionaries#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HowToResourceDictionaries/VB/MainWindow.xaml.vb#3)]  
+  
+ <xref:System.Windows.Application.Resources%2A> を使用するときに注意すべき点が 2 つあります。  1 つ目は、ディクショナリ キーはオブジェクトであるため、プロパティ値を設定および取得するときに、まったく同じオブジェクト インスタンスを使用する必要があります  \(キーに文字列を使用する場合、大文字と小文字が区別されることに注意してください\)。2 つ目は、ディクショナリの値はオブジェクトであるため、プロパティ値を取得するときにその値を目的の型に変換する必要があります。  
+  
+## 参照  
+ <xref:System.Windows.ResourceDictionary>   
+ <xref:System.Windows.Application.Resources%2A>   
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [マージされたリソース ディクショナリ](../../../../docs/framework/wpf/advanced/merged-resource-dictionaries.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/ienumrawinputdevic-clone.md b/docs/framework/wpf/app-development/ienumrawinputdevic-clone.md
new file mode 100644
index 00000000000..f7ac122966c
--- /dev/null
+++ b/docs/framework/wpf/app-development/ienumrawinputdevic-clone.md
@@ -0,0 +1,39 @@
+---
+title: "IEnumRAWINPUTDEVIC:Clone | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Clone メソッド"
+ms.assetid: 2a6a1900-aa55-45fa-9382-241d569a2dc4
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# IEnumRAWINPUTDEVIC:Clone
+同じリストに対する反復処理を行うために、現在の列挙子と同じ状態の未加工の入力デバイス列挙子を別に作成します。  
+  
+## 構文  
+  
+```  
+HRESULT Clone( [out] IEnumRAWINPUTDEVICE **ppenum);  
+```  
+  
+#### パラメーター  
+ `ppenum`  
+  
+ \[out\] [IEnumRAWINPUTDEVICE](../../../../docs/framework/wpf/app-development/ienumrawinputdevice.md) インターフェイス ポインターを受け取る出力変数のアドレス。  メソッドが失敗した場合、この出力変数の値は未定義です。  
+  
+## プロパティ値\/戻り値  
+ HRESULT : このメソッドは、標準の戻り値である E\_INVALIDARG、E\_OUTOFMEMORY、および E\_UNEXPECTED をサポートします。  
+  
+## 解説  
+ このメソッドは、列挙体シーケンス内のポイントを記録して、後でそのポイントに戻ることができるようにしています。  呼び出し元は、この新しい列挙子を最初の列挙子とは別に解放する必要があります。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/ienumrawinputdevic-next.md b/docs/framework/wpf/app-development/ienumrawinputdevic-next.md
new file mode 100644
index 00000000000..5effe274dbd
--- /dev/null
+++ b/docs/framework/wpf/app-development/ienumrawinputdevic-next.md
@@ -0,0 +1,47 @@
+---
+title: "IEnumRAWINPUTDEVIC:Next | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "次のメソッド"
+ms.assetid: 3698b44d-510e-4d18-b32b-85f17188ee26
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# IEnumRAWINPUTDEVIC:Next
+列挙子の一覧で次の  `celt` [RAWINPUTDEVICE](http://msdn.microsoft.com/library/default.asp?url=/library/winui/winui/windowsuserinterface/userinput/rawinput/rawinputreference/rawinputstructures/rawinputdevice.asp) 構造を列挙し、実際に `pceltFetched` に列挙された要素の数とともに `rgelt` に返します。  
+  
+## 構文  
+  
+```  
+HRESULT Next(  
+      [in] ULONG celt,  
+      [out, size_is(celt), length_is(*pceltFetched)] RAWINPUTDEVICE *rgelt,  
+      [out] ULONG *pceltFetched);  
+```  
+  
+#### パラメーター  
+ `celt`  
+  
+ \[in\] `rgelt` に返される [RAWINPUTDEVICE](http://msdn.microsoft.com/library/default.asp?url=/library/winui/winui/windowsuserinterface/userinput/rawinput/rawinputreference/rawinputstructures/rawinputdevice.asp) 構造の数。  
+  
+ `rgelt`  
+  
+ \[out\] 列挙された RAWINPUTDEVICE 構造体を受け取る size celt \(またはそれ以上\) の配列。  
+  
+ `pceltFetched`  
+  
+ \[out\] `rgelt` に実際に指定された要素の数へのポインター。  `rgelt` が 1 の場合、呼び出し元は `NULL` に渡すことができます。  
+  
+## プロパティ値\/戻り値  
+ 指定された要素の数が `celt` の場合は HRESULT: S\_OK。それ以外の場合は S\_FALSE。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/ienumrawinputdevic-reset.md b/docs/framework/wpf/app-development/ienumrawinputdevic-reset.md
new file mode 100644
index 00000000000..339fb599ac6
--- /dev/null
+++ b/docs/framework/wpf/app-development/ienumrawinputdevic-reset.md
@@ -0,0 +1,31 @@
+---
+title: "IEnumRAWINPUTDEVIC:Reset | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Reset メソッド"
+ms.assetid: 6f3255f0-90e0-4736-b184-c1d3b8387bd3
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# IEnumRAWINPUTDEVIC:Reset
+列挙体シーケンスを先頭にリセットします。  
+  
+## 構文  
+  
+```  
+HRESULT Reset();  
+```  
+  
+## プロパティ値\/戻り値  
+ HRESULT : S\_OK。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/ienumrawinputdevic-skip.md b/docs/framework/wpf/app-development/ienumrawinputdevic-skip.md
new file mode 100644
index 00000000000..9ea56374b55
--- /dev/null
+++ b/docs/framework/wpf/app-development/ienumrawinputdevic-skip.md
@@ -0,0 +1,36 @@
+---
+title: "IEnumRAWINPUTDEVIC:Skip | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Skip メソッド"
+ms.assetid: c967b0f8-1c6a-459c-8c16-d4f08918ab65
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# IEnumRAWINPUTDEVIC:Skip
+列挙体の次の `celt` 個の要素をスキップするように列挙子に指示し、それらの要素が次の [IEnumRAWINPUTDEVIC:Next](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-next.md) の呼び出しで返されないようにします。  
+  
+## 構文  
+  
+```  
+HRESULT Skip( [in] ULONG celt);  
+```  
+  
+#### パラメーター  
+ `celt`  
+  
+ \[in\] スキップする要素の数。  
+  
+## プロパティ値\/戻り値  
+ HRESULT : スキップされた要素の数が `celt` の場合は S\_OK。それ以外の場合は S\_FALSE。
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/ienumrawinputdevice.md b/docs/framework/wpf/app-development/ienumrawinputdevice.md
new file mode 100644
index 00000000000..47a3444421f
--- /dev/null
+++ b/docs/framework/wpf/app-development/ienumrawinputdevice.md
@@ -0,0 +1,37 @@
+---
+title: "IEnumRAWINPUTDEVICE | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IEnumRAWINPUTDEVICE インターフェイス"
+ms.assetid: 88c8b389-a48b-46b9-b895-8ed7b1e26fea
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# IEnumRAWINPUTDEVICE
+このインターフェイスは、未加工入力デバイスを列挙し、 PresentationHost.exe でのみ使用されます。  
+  
+> [!NOTE]
+>  この API は、ローカル クライアント コンピューターでの使用のみを目的とし、サポートされています。  
+  
+## メンバー  
+  
+|メンバー|説明|  
+|----------|--------|  
+|[IEnumRAWINPUTDEVIC:Next](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-next.md)|次の `celt` 要素 \(つまり RAWINPUTDEVICE 構造体\) を、列挙子の一覧で列挙するとともに、それを `pceltFetched` で列挙された要素の実際の数とともに `rgelt` で返します。|  
+|[IEnumRAWINPUTDEVIC:Skip](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-skip.md)|\[[IEnumRAWINPUTDEVIC:Next](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-next.md)\] の次回の呼び出しで列挙体の次の `celt` 要素が返されないように、この要素をスキップするよう列挙子に指示します。|  
+|[IEnumRAWINPUTDEVIC:Reset](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-reset.md)|列挙のシーケンスを最初にリセットします。|  
+|[IEnumRAWINPUTDEVIC:Clone](../../../../docs/framework/wpf/app-development/ienumrawinputdevic-clone.md)|同じリストを反復処理するため、現在の列挙子と同じ状態の別の未加工入力デバイスの列挙子を作成します。|  
+  
+## 参照  
+ [未加工入力について](http://msdn.microsoft.com/library/default.asp?url=/library/winui/winui/windowsuserinterface/userinput/rawinput/aboutrawinput.asp)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/index.md b/docs/framework/wpf/app-development/index.md
new file mode 100644
index 00000000000..d86803ab7ca
--- /dev/null
+++ b/docs/framework/wpf/app-development/index.md
@@ -0,0 +1,139 @@
+---
+title: "アプリケーション開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [WPF], 概要"
+  - "WPF, アプリケーション開発の概要"
+ms.assetid: 2996ce5e-81e9-49ae-881b-952db3dd1b7e
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# アプリケーション開発
+<a name="introduction"></a> [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は、次のような種類のアプリケーションやサービスを開発するために使用できるプレゼンテーション フレームワークです。  
+  
+-   スタンドアロン アプリケーション \(クライアント コンピューターにインストールし、そこから実行できる実行可能アセンブリとしてビルドされた従来スタイルの [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] アプリケーション\)。  
+  
+-   [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] \([!INCLUDE[TLA#tla_ie](../../../../includes/tlasharptla-ie-md.md)] や Mozilla Firefox などの Web ブラウザーによってホストされ、実行可能アセンブリとしてビルドされた移動可能ページで構成されるアプリケーション\)。  
+  
+-   カスタム コントロール ライブラリ \(再利用可能なコントロールを含む非実行可能アセンブリ\)。  
+  
+-   クラス ライブラリ \(再利用可能なクラスを含む非実行可能アセンブリ\)。  
+  
+> [!NOTE]
+>  Windows サービスで WPF 型を使用することは避けることを強くお勧めします。  Windows サービスでこれらの機能を使用すると、期待どおりの動作が得られない場合があります。  
+  
+ このような一連のアプリケーションをビルドするために、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は多数のサービスを実装しています。  このトピックでは、これらのサービスの概要を説明し、詳細情報へのリンクを示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Application_Management"></a>   
+## アプリケーション管理  
+ 実行可能 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは、一般に次のコアな機能セットを必要とします。  
+  
+-   共通アプリケーション インフラストラクチャを作成し、これを管理する \(エントリ ポイント メソッドと、システム メッセージおよび入力メッセージを受け取るための Windows メッセージ ループの作成を含む\)。  
+  
+-   アプリケーションの有効期間を追跡し、これと相互作用する。  
+  
+-   コマンド ライン パラメーターを取得し、処理する。  
+  
+-   アプリケーション スコープのプロパティと [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] リソースを共有する。  
+  
+-   未処理の例外を検出し、これを処理する。  
+  
+-   終了コードを返す。  
+  
+-   スタンドアロン アプリケーションのウィンドウを管理する。  
+  
+-   [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] や、ナビゲーション ウィンドウとフレームを持つスタンドアロン アプリケーションで、ナビゲーションを追跡する。  
+  
+ これらの機能は、<xref:System.Windows.Application> クラスによって実装されます。このクラスをアプリケーションに追加するには、*アプリケーション定義*を使用します。  
+  
+ 詳細については、「[アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)」を参照してください。  
+  
+<a name="WPF_Application_Resource__Content__and_Data_Files"></a>   
+## WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、埋め込みリソースを扱う [!INCLUDE[TLA#tla_winfx](../../../../includes/tlasharptla-winfx-md.md)] のコア サポートを拡張して、リソース、コンテンツ、データの 3 種類の非実行可能データ ファイルのサポートを追加します。詳細については、「[WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)」を参照してください。  
+  
+ WPF 非実行可能データ ファイル サポートの重要なコンポーネントは、一意の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用してこれらのファイルを識別し、読み込む機能です。詳細については、「[WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)」を参照してください。  
+  
+<a name="Windows_and_Dialog_Boxes"></a>   
+## ウィンドウとダイアログ ボックス  
+ ユーザーは、ウィンドウをとおして [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] スタンドアロン アプリケーションとやり取りします。  ウィンドウの目的は、アプリケーションのコンテンツをホストし、コンテンツとやり取りするためにユーザーが利用できるアプリケーション機能を公開することです。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、ウィンドウは <xref:System.Windows.Window> クラスにカプセル化されます。このクラスは、次の機能を備えています。  
+  
+-   ウィンドウを作成し、表示する。  
+  
+-   所有者と所有先ウィンドウの関係を確立する。  
+  
+-   ウィンドウの外観を構成する \(サイズ、位置、アイコン、タイトル バーのテキスト、境界など\)。  
+  
+-   ウィザードの有効期間を追跡し、これと相互作用する。  
+  
+ 詳細については、「[WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Window> は、ダイアログ ボックスと呼ばれる特別な種類のウィンドウを作成できます。  モーダル ダイアログ ボックスとモードレス ダイアログ ボックスの両方の種類のダイアログ ボックスを作成できます。  
+  
+ 使いやすさ、再利用性の利点、およびアプリケーション全体の操作性の統一のために、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] のコモン ダイアログ ボックスから <xref:Microsoft.Win32.OpenFileDialog>、<xref:Microsoft.Win32.SaveFileDialog>、および <xref:System.Windows.Controls.PrintDialog> の 3 つを公開しています。  
+  
+ メッセージ ボックスは、重要な情報をテキストでユーザーに表示し、単純な \[はい\]、\[いいえ\]、\[OK\]、\[キャンセル\] の応答を求めるために使用する特別なダイアログ ボックスです。  メッセージ ボックスを作成して表示するには、<xref:System.Windows.MessageBox> クラスを使用します。  
+  
+ 詳細については、「[ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)」を参照してください。  
+  
+<a name="Navigation"></a>   
+## Navigation  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、ページ \(<xref:System.Windows.Controls.Page>\) とハイパーリンク \(<xref:System.Windows.Documents.Hyperlink>\) を使用する Web スタイルのナビゲーションをサポートしています。  ナビゲーションは、次のようなさまざまな方法で実装できます。  
+  
+-   Web ブラウザーでホストされるスタンドアロンのページ。  
+  
+-   Web ブラウザーでホストされる [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] にコンパイルされるページ。  
+  
+-   スタンドアロン アプリケーションにコンパイルされ、ナビゲーション ウィンドウ \(<xref:System.Windows.Navigation.NavigationWindow>\) によってホストされるページ。  
+  
+-   フレーム \(<xref:System.Windows.Controls.Frame>\) によってホストされるページ。フレームは、スタンドアロン ページか、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] またはスタンドアロン アプリケーションにコンパイルされたページにホストされることがあります。  
+  
+ ナビゲーションに役立つように、次の機能が [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] に実装されます。  
+  
+-   アプリケーション内ナビゲーションをサポートするために <xref:System.Windows.Controls.Frame>、<xref:System.Windows.Navigation.NavigationWindow>、および [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] で使用される、ナビゲーション要求処理用の共有ナビゲーション エンジンである <xref:System.Windows.Navigation.NavigationService>。  
+  
+-   ナビゲーションを開始するために使用するナビゲーション メソッド。  
+  
+-   ナビゲーションの有効期間を追跡し、これと相互作用するために使用するナビゲーション イベント。  
+  
+-   履歴を使用した前方や後方へのナビゲーションの記録。履歴の情報は、調べたり操作したりすることもできます。  
+  
+ 詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、構造化ナビゲーションと呼ばれる特別な種類のナビゲーションもサポートしています。  構造化ナビゲーションは、呼び出し元関数との一貫性が保たれた、構造化されて予測の可能な形式でデータを返す 1 つ以上のページを呼び出すために使用できます。  この機能は <xref:System.Windows.Navigation.PageFunction%601> クラスに依存します。このクラスの詳細については、「[構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)」を参照してください。  また、<xref:System.Windows.Navigation.PageFunction%601> は、複雑なナビゲーション トポロジの作成を簡略化するためにも役立ちます。詳細については、「[ナビゲーション トポロジの概要](../../../../docs/framework/wpf/app-development/navigation-topologies-overview.md)」を参照してください。  
+  
+<a name="Hosting"></a>   
+## ホスト  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、[!INCLUDE[TLA#tla_ie](../../../../includes/tlasharptla-ie-md.md)] または Firefox でホストできます。  ホストのモデルによって考慮事項や制約が異なります。詳細については、「[ホスト](../../../../docs/framework/wpf/app-development/hosting-wpf-applications.md)」を参照してください。  
+  
+<a name="Build_and_Deploy"></a>   
+## ビルドと配置  
+ 単純な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションはコマンド ライン コンパイラを使用してコマンド プロンプトでビルドできますが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] と [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] が統合されることで、開発とビルドのプロセスを簡略化するための追加サポートを使用できます。  詳細については、「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照してください。  
+  
+ ビルドするアプリケーションの種類によって、選択する配置オプションが異なります。  詳細については、「[WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)」を参照してください。  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)|アプリケーションの有効期間、ウィンドウ、アプリケーション リソース、ナビゲーションの管理など、<xref:System.Windows.Application> クラスの概要について説明します。|  
+|[WPF のウィンドウ](../../../../docs/framework/wpf/app-development/windows-in-wpf-applications.md)|<xref:System.Windows.Window> クラスおよびダイアログ ボックスの使い方など、アプリケーション内のウィンドウ管理の詳細について説明します。|  
+|[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)|アプリケーション内のページ間でのナビゲーション管理の概要について説明します。|  
+|[ホスト](../../../../docs/framework/wpf/app-development/hosting-wpf-applications.md)|[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] の概要について説明します。|  
+|[ビルドと配置](../../../../docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md)|WPF アプリケーションをビルドして配置する方法について説明します。|  
+|[Visual Studio 2015 での WPF の概要](../../../../docs/framework/wpf/getting-started/introduction-to-wpf-in-vs.md)|WPF の主な機能について説明します。|  
+|[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)|ページ ナビゲーション、レイアウト、コントロール、イメージ、スタイル、バインディングを使用する WPF アプリケーションの作成方法を示すチュートリアルです。|
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/iwpfhostsupport.md b/docs/framework/wpf/app-development/iwpfhostsupport.md
new file mode 100644
index 00000000000..bff9be2cb0b
--- /dev/null
+++ b/docs/framework/wpf/app-development/iwpfhostsupport.md
@@ -0,0 +1,44 @@
+---
+title: "IWpfHostSupport | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IWpfHostSupport インターフェイス"
+ms.assetid: cc5a0281-de81-4cc1-87e4-0e46b1a811e9
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# IWpfHostSupport
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] コンテンツを PresentationHost.exe を介してホストするアプリケーションは、ホストと PresentationHost.exe を統合するポイントを提供するために、このインターフェイスを実装します。  
+  
+## 解説  
+ Web ブラウザーなどの [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] アプリケーションは、[!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] や Loose XAML などの [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] コンテンツをホストできます。  [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] アプリケーションは、[!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] コンテンツをホストするために、[WebBrowser コントロール](http://go.microsoft.com/fwlink/?LinkId=97911)のインスタンスを作成します。  [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] をホストするには、PresentationHost.exe のインスタンスを作成します。これにより、ホストされる [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] コンテンツを [WebBrowser コントロール](http://go.microsoft.com/fwlink/?LinkId=97911)で表示するために、ホストに提供します。  
+  
+ `IWpfHostSupport` で有効化される統合により、PresentationHost.exe では次のことが可能になります。  
+  
+-   ホスト アプリケーションに必要な未加工の入力デバイス \(ヒューマン インターフェイス デバイス\) を検出して登録する。  
+  
+-   登録された未加工の入力デバイスからの入力メッセージを受け取り、適切なメッセージをホスト アプリケーションに転送する。  
+  
+-   ホスト アプリケーションに対して、進行状況とエラーに関するカスタム ユーザー インターフェイスの有無を照会する。  
+  
+> [!NOTE]
+>  この API は、ローカルのクライアント コンピューターでのみ使用できます。  
+  
+## メンバー  
+  
+|メンバー|Description|  
+|----------|-----------------|  
+|[GetRawInputDevices](../../../../docs/framework/wpf/app-development/getrawinputdevices.md)|ホスト アプリケーションに必要な入力ロー デバイス \(ヒューマン インターフェイス デバイス\) を PresentationHost.exe が検出できるようにします。|  
+|[FilterInputMessage](../../../../docs/framework/wpf/app-development/filterinputmessage.md)|E\_NOTIMPL が返されない限り、メッセージを受け取るたびに PresentationHost.exe によって呼び出されます。|  
+|[GetCustomUI](../../../../docs/framework/wpf/app-development/getcustomui.md)|既定では、PresentationHost.exe には、WPF コンテンツの配置時に表示される、独自の配置状況と配置エラーのユーザー インターフェイスが備わっています。|
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/media/applicationmanagementoverviewfigure2.png b/docs/framework/wpf/app-development/media/applicationmanagementoverviewfigure2.png
new file mode 100644
index 00000000000..e5f1ba7e09e
Binary files /dev/null and b/docs/framework/wpf/app-development/media/applicationmanagementoverviewfigure2.png differ
diff --git a/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents-xbap.png b/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents-xbap.png
new file mode 100644
index 00000000000..17eb9b7cf2f
Binary files /dev/null and b/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents-xbap.png differ
diff --git a/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents.png b/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents.png
new file mode 100644
index 00000000000..0e2392bb28a
Binary files /dev/null and b/docs/framework/wpf/app-development/media/applicationmodeloverview-applicationobjectevents.png differ
diff --git a/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure3.png b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure3.png
new file mode 100644
index 00000000000..b95a9d664a3
Binary files /dev/null and b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure3.png differ
diff --git a/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure4.png b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure4.png
new file mode 100644
index 00000000000..6c044323784
Binary files /dev/null and b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure4.png differ
diff --git a/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure7.png b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure7.png
new file mode 100644
index 00000000000..2584ebbc6bf
Binary files /dev/null and b/docs/framework/wpf/app-development/media/dialogboxesoverviewfigure7.png differ
diff --git a/docs/framework/wpf/app-development/media/naivgationoverviewfigure24.png b/docs/framework/wpf/app-development/media/naivgationoverviewfigure24.png
new file mode 100644
index 00000000000..7e485816b90
Binary files /dev/null and b/docs/framework/wpf/app-development/media/naivgationoverviewfigure24.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure10.PNG b/docs/framework/wpf/app-development/media/navigationoverviewfigure10.PNG
new file mode 100644
index 00000000000..113ecb2e912
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure10.PNG differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure11.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure11.png
new file mode 100644
index 00000000000..8357dfec47a
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure11.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure17.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure17.png
new file mode 100644
index 00000000000..0eb9c108214
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure17.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure21.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure21.png
new file mode 100644
index 00000000000..a689b2aa29f
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure21.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure22.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure22.png
new file mode 100644
index 00000000000..4eb5eb30974
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure22.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure23.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure23.png
new file mode 100644
index 00000000000..28700878c02
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure23.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure3.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure3.png
new file mode 100644
index 00000000000..bcfd649fce0
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure3.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure4.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure4.png
new file mode 100644
index 00000000000..11ad15fc969
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure4.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure5.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure5.png
new file mode 100644
index 00000000000..943f0decb70
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure5.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure7.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure7.png
new file mode 100644
index 00000000000..de090480dda
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure7.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure8.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure8.png
new file mode 100644
index 00000000000..25d30e986fb
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure8.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationoverviewfigure9.png b/docs/framework/wpf/app-development/media/navigationoverviewfigure9.png
new file mode 100644
index 00000000000..f75fed32617
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationoverviewfigure9.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure1.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure1.png
new file mode 100644
index 00000000000..5eff0eebe6f
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure1.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure2.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure2.png
new file mode 100644
index 00000000000..0d2021a2afd
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure2.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure3.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure3.png
new file mode 100644
index 00000000000..c85d266b413
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure3.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure4.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure4.png
new file mode 100644
index 00000000000..5fe201836ec
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure4.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure5.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure5.png
new file mode 100644
index 00000000000..b855479707e
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure5.png differ
diff --git a/docs/framework/wpf/app-development/media/navigationtopologyfigure6.png b/docs/framework/wpf/app-development/media/navigationtopologyfigure6.png
new file mode 100644
index 00000000000..de55668875a
Binary files /dev/null and b/docs/framework/wpf/app-development/media/navigationtopologyfigure6.png differ
diff --git a/docs/framework/wpf/app-development/media/nonrectangularwindowfigure.PNG b/docs/framework/wpf/app-development/media/nonrectangularwindowfigure.PNG
new file mode 100644
index 00000000000..9a779e9ec11
Binary files /dev/null and b/docs/framework/wpf/app-development/media/nonrectangularwindowfigure.PNG differ
diff --git a/docs/framework/wpf/app-development/media/structurednavigationoverviewfigure1.png b/docs/framework/wpf/app-development/media/structurednavigationoverviewfigure1.png
new file mode 100644
index 00000000000..1b6ea4dd391
Binary files /dev/null and b/docs/framework/wpf/app-development/media/structurednavigationoverviewfigure1.png differ
diff --git a/docs/framework/wpf/app-development/media/windowlifetimeevents.png b/docs/framework/wpf/app-development/media/windowlifetimeevents.png
new file mode 100644
index 00000000000..8e9af2d109f
Binary files /dev/null and b/docs/framework/wpf/app-development/media/windowlifetimeevents.png differ
diff --git a/docs/framework/wpf/app-development/media/windowlifetimenoact.png b/docs/framework/wpf/app-development/media/windowlifetimenoact.png
new file mode 100644
index 00000000000..daeed38c7f3
Binary files /dev/null and b/docs/framework/wpf/app-development/media/windowlifetimenoact.png differ
diff --git a/docs/framework/wpf/app-development/media/windowoverviewfigure1.PNG b/docs/framework/wpf/app-development/media/windowoverviewfigure1.PNG
new file mode 100644
index 00000000000..fb6bafc126d
Binary files /dev/null and b/docs/framework/wpf/app-development/media/windowoverviewfigure1.PNG differ
diff --git a/docs/framework/wpf/app-development/media/windowoverviewfigure8.png b/docs/framework/wpf/app-development/media/windowoverviewfigure8.png
new file mode 100644
index 00000000000..190eac5f488
Binary files /dev/null and b/docs/framework/wpf/app-development/media/windowoverviewfigure8.png differ
diff --git a/docs/framework/wpf/app-development/media/wpfbuildsystem-figure1.png b/docs/framework/wpf/app-development/media/wpfbuildsystem-figure1.png
new file mode 100644
index 00000000000..831d7b421bc
Binary files /dev/null and b/docs/framework/wpf/app-development/media/wpfbuildsystem-figure1.png differ
diff --git a/docs/framework/wpf/app-development/media/wpfpackurischemefigure4.png b/docs/framework/wpf/app-development/media/wpfpackurischemefigure4.png
new file mode 100644
index 00000000000..5f5ee1119e4
Binary files /dev/null and b/docs/framework/wpf/app-development/media/wpfpackurischemefigure4.png differ
diff --git a/docs/framework/wpf/app-development/native-wpf-browser-hosting-support-apis.md b/docs/framework/wpf/app-development/native-wpf-browser-hosting-support-apis.md
new file mode 100644
index 00000000000..4edb5a341ad
--- /dev/null
+++ b/docs/framework/wpf/app-development/native-wpf-browser-hosting-support-apis.md
@@ -0,0 +1,43 @@
+---
+title: "WPF のブラウザーのホスト処理をサポートするネイティブ API | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ブラウザーのホスト処理のサポート [WPF]"
+  - "WPF のブラウザーのホスト処理をサポートする API"
+ms.assetid: 82c133a8-d760-45fb-a2b9-3a997537f1d4
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# WPF のブラウザーのホスト処理をサポートするネイティブ API
+Web ブラウザーでの [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] アプリケーションのホストは、WPF ホストの外部に登録された Active ドキュメント サーバー \(DocObject とも呼ばれます\) によって実現されます。  [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] は、アクティブ ドキュメントを直接アクティブ化して統合することができます。  Mozilla ブラウザーで XBAP および Loose XAML ドキュメントをホストするために、[!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] は NPAPI プラグインを提供します。このプラグインは、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] で提供されるのと似たホスト環境を [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] Active ドキュメント サーバーに提供します。  しかし、他のブラウザーおよびスタンドアロン アプリケーションで XBAP および XAML ドキュメントをホストする最も簡単で実際的な方法は、Internet Explorer の Web ブラウザー コントロールを使用することです。  Web ブラウザー コントロールは、複雑な Active ドキュメント サーバー ホスト環境を提供するだけでなく、自身のホストがその環境をカスタマイズおよび拡張し、現在の Active ドキュメント オブジェクトと直接通信できるようにします。  
+  
+ [!INCLUDE[TLA#tla_titlewinclient](../../../../includes/tlasharptla-titlewinclient-md.md)] Active ドキュメント サーバーは、[IOleObject](http://go.microsoft.com/fwlink/?LinkId=162049)、[IOleDocument](http://go.microsoft.com/fwlink/?LinkId=162050)、[IOleInPlaceActiveObject](http://go.microsoft.com/fwlink/?LinkId=162051)、[IPersistMoniker](http://go.microsoft.com/fwlink/?LinkId=162045)、[IOleCommandTarget](http://go.microsoft.com/fwlink/?LinkId=162047) などの共通ホスト インターフェイスを実装します。  Web ブラウザー コントロールでホストされた場合、これらのインターフェイスは、[IWebBrowser2::Document](http://go.microsoft.com/fwlink/?LinkId=162048) プロパティで返されるオブジェクトからクエリできます。  
+  
+## IOleCommandTarget  
+ WPF Active ドキュメント サーバーの [IOleCommandTarget](http://go.microsoft.com/fwlink/?LinkId=162047) の実装は、標準 OLE コマンド グループ \(コマンド グループ GUID は null\) のさまざまなナビゲーション関連コマンドおよびブラウザー固有のコマンドをサポートします。  また、CGID\_PresentationHost という名前のカスタム コマンド グループも認識します。  現在、このグループ内で定義されているコマンドは 1 つだけです。  
+  
+```  
+DEFINE_GUID(CGID_PresentationHost, 0xd0288c55, 0xd6, 0x4f5e, 0xa8, 0x51, 0x79, 0xde, 0xc5, 0x1b, 0x10, 0xec);  
+enum PresentationHostCommands {   
+   PHCMDID_TABINTO = 1   
+};  
+```  
+  
+ PHCMDID\_TABINTO は、Shift キーの状態に基づいてコンテンツ内の最初または最後のフォーカス可能な要素にフォーカスを切り替えるように、PresentationHost に指示します。  
+  
+## このセクションの内容  
+ [IEnumRAWINPUTDEVICE](../../../../docs/framework/wpf/app-development/ienumrawinputdevice.md)  
+ [IWpfHostSupport](../../../../docs/framework/wpf/app-development/iwpfhostsupport.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/navigation-how-to-topics.md b/docs/framework/wpf/app-development/navigation-how-to-topics.md
new file mode 100644
index 00000000000..5d54a8bea01
--- /dev/null
+++ b/docs/framework/wpf/app-development/navigation-how-to-topics.md
@@ -0,0 +1,35 @@
+---
+title: "ナビゲーションに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ナビゲーション [WPF]"
+ms.assetid: f804648e-558c-4f60-8e48-d11f4a23c436
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# ナビゲーションに関する「方法」トピック
+以下のトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ナビゲーションの使用方法を示します。  
+  
+## このセクションの内容  
+ [ページ関数を呼び出す](../../../../docs/framework/wpf/app-development/how-to-call-a-page-function.md)  
+ [ページ関数の戻り値を取得する](../../../../docs/framework/wpf/app-development/how-to-get-the-return-value-of-a-page-function.md)  
+ [移動履歴の前後への移動](../../../../docs/framework/wpf/app-development/how-to-navigate-forward-or-back-through-navigation-history.md)  
+ [ページ関数から戻る](../../../../docs/framework/wpf/app-development/how-to-return-from-a-page-function.md)  
+  
+## 関連項目  
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)  
+  
+ [構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/navigation-overview.md b/docs/framework/wpf/app-development/navigation-overview.md
new file mode 100644
index 00000000000..0539c7984dd
--- /dev/null
+++ b/docs/framework/wpf/app-development/navigation-overview.md
@@ -0,0 +1,746 @@
+---
+title: "ナビゲーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテンツ状態 [WPF]"
+  - "カスタム オブジェクト [WPF]"
+  - "フラグメント ナビゲーション [WPF]"
+  - "フレーム [WPF]"
+  - "HTML ファイル [WPF]"
+  - "ハイパーリンク [WPF]"
+  - "ジャーナル [WPF]"
+  - "有効期間 [WPF]"
+  - "Loose XAML ファイル [WPF]"
+  - "ナビゲーション ホスト [WPF]"
+  - "ページ [WPF]"
+  - "プログラム ナビゲーション [WPF]"
+  - "保持 (コンテンツ状態を) [WPF]"
+  - "スタート ページ [WPF]"
+  - "構造化ナビゲーション [WPF]"
+  - "Uniform Resource Identifier (URI)"
+  - "URI (Uniform Resource Identifier)"
+  - "ウィンドウ [WPF]"
+ms.assetid: 86ad2143-606a-4e34-bf7e-51a2594248b8
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# ナビゲーションの概要
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は、2 種類のアプリケーション \(スタンドアロン アプリケーションと [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)]\) で使用可能なブラウザー スタイルのナビゲーションをサポートします。ナビゲーション用にコンテンツをパッケージ化するために、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は <xref:System.Windows.Controls.Page> クラスを提供します。  <xref:System.Windows.Controls.Page> 間は、<xref:System.Windows.Documents.Hyperlink> を使用して宣言するか、<xref:System.Windows.Navigation.NavigationService> を使用してプログラムによってナビゲートできます。[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、ナビゲート元のページを記録して、それらのページに戻るために履歴を使用します。  
+  
+ <xref:System.Windows.Controls.Page>、<xref:System.Windows.Documents.Hyperlink>、<xref:System.Windows.Navigation.NavigationService>、および履歴は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] によって提供されるナビゲーション サポートの中核を形成しています。  この概要では、Loose [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイル、[!INCLUDE[TLA#tla_html](../../../../includes/tlasharptla-html-md.md)] ファイル、およびオブジェクトへのナビゲーションを含む高度なナビゲーション サポートについて説明する前に、それらの機能について詳細に説明します。  
+  
+> [!NOTE]
+>  このトピックでは、"ブラウザー" という用語は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のアプリケーションをホスト可能なブラウザーのみを指しています。現在のところ、これには [!INCLUDE[TLA#tla_ie](../../../../includes/tlasharptla-ie-md.md)] と Firefox が含まれます。  特定の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 機能が特定のブラウザーでのみサポートされる場合は、ブラウザー バージョンを示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="XAMLBrowserApplications"></a>   
+## WPF アプリケーションでのナビゲーション  
+ ここでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の主なナビゲーション機能の概要について説明します。  このトピックでは、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] のコンテキスト内でこれらの機能について説明します。これらの機能はスタンドアロン アプリケーションと [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の両方で使用できます  
+  
+> [!NOTE]
+>  ここでは、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] をビルドして配置する方法については説明しません。  [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の詳細については、「[WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」を参照してください。  
+  
+ ナビゲーションの次の側面について説明します。  
+  
+-   [ページの実装](#CreatingAXAMLPage)  
+  
+-   [開始ページの構成](#Configuring_a_Start_Page)  
+  
+-   [ホスト ウィンドウのタイトル、幅、および高さの構成](#ConfiguringAXAMLPage)  
+  
+-   [ハイパーリンク ナビゲーション](#NavigatingBetweenXAMLPages)  
+  
+-   [フラグメント ナビゲーション](#FragmentNavigation)  
+  
+-   [ナビゲーション サービス](#NavigationService)  
+  
+-   [ナビゲーション サービスを使用するプログラム ナビゲーション](#Programmatic_Navigation_with_the_Navigation_Service)  
+  
+-   [ナビゲーションの有効期間](#Navigation_Lifetime)  
+  
+-   [履歴によるナビゲーションの記録](#NavigationHistory)  
+  
+-   [ページの有効期間と履歴](#PageLifetime)  
+  
+-   [ナビゲーション履歴を使用したコンテンツ状態の保持](#RetainingContentStateWithNavigationHistory)  
+  
+-   [クッキー](#Cookies)  
+  
+-   [構造化ナビゲーション](#Structured_Navigation)  
+  
+<a name="CreatingAXAMLPage"></a>   
+### ページの実装  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、[!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] オブジェクト、カスタム オブジェクト、列挙値、ユーザー コントロール、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル、および [!INCLUDE[TLA#tla_html](../../../../includes/tlasharptla-html-md.md)] ファイルを含むさまざまなコンテンツ タイプにナビゲートできます。  ただし、コンテンツをパッケージ化する最も一般的で便利な方法は、<xref:System.Windows.Controls.Page> を使用することです。  さらに、<xref:System.Windows.Controls.Page> はナビゲーション固有の機能を実装し、それらの外観を向上して開発を単純化します。  
+  
+ <xref:System.Windows.Controls.Page> を使用すると、次のようなマークアップを使用して、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] コンテンツのナビゲート可能なページを宣言によって実装できます。  
+  
+ [!code-xml[NavigationOverviewSnippets#Page1XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/Page1.xaml#page1xaml)]  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップで実装される <xref:System.Windows.Controls.Page> には、ルート要素としての `Page` があり、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] 名前空間宣言が必要です。  `Page` 要素には、ナビゲートして表示するコンテンツが格納されます。  コンテンツは、次のマークアップに示すように、`Page.Content` プロパティ要素を設定して追加します。  
+  
+ [!code-xml[NavigationOverviewSnippets#Page2XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/Page2.xaml#page2xaml)]  
+  
+ `Page.Content` には 1 つの子要素のみを格納できます。前の例では、コンテンツは単一の文字列 "Hello, Page\!" です。実際の開発では、一般的に、レイアウト コントロールを子要素として使用し \(「[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)」を参照\)、コンテンツを格納して構成します。  
+  
+ `Page` 要素の子要素は、<xref:System.Windows.Controls.Page> のコンテンツと見なされるため、明示的な `Page.Content` 宣言を使用する必要はありません。  次のマークアップは、前のサンプルの宣言と同等です。  
+  
+ [!code-xml[NavigationOverviewSnippets#Page3XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/Page3.xaml#page3xaml)]  
+  
+ この場合、`Page.Content` は、`Page` 要素の子要素を使用して自動的に設定されます。  詳細については、「[WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)」を参照してください。  
+  
+ マークアップのみの <xref:System.Windows.Controls.Page> は、コンテンツを表示するとき役立ちます。  ただし、<xref:System.Windows.Controls.Page> はユーザーによるページの操作を可能にするコントロールも表示し、イベントを処理してアプリケーション ロジックを呼び出すことによって、ユーザー操作に応答できます。  対話形式の <xref:System.Windows.Controls.Page> は、次の例に示すように、マークアップと分離コードの組み合わせを使用して実装されます。  
+  
+ [!code-xml[XBAPAppDefSnippets#HomePageMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppDefSnippets/CSharp/HomePage.xaml#homepagemarkup)]  
+  
+ [!code-csharp[XBAPAppDefSnippets#HomePageCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppDefSnippets/CSharp/HomePage.xaml.cs#homepagecodebehind)]
+ [!code-vb[XBAPAppDefSnippets#HomePageCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XBAPAppDefSnippets/VisualBasic/HomePage.xaml.vb#homepagecodebehind)]  
+  
+ マークアップ ファイルと分離コード ファイルを連携させるには、次の構成が必要です。  
+  
+-   マークアップの `Page` 要素に、`x:Class` 属性を含める必要があります。  アプリケーションのビルド時にマークアップ ファイルに `x:Class` が含まれていると、[!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] は、`x:Class` 属性で指定された名前を持つ、<xref:System.Windows.Controls.Page> から派生した`partial`クラスを作成します。  そのためには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] スキーマ \(`xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`\) に [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間宣言を追加する必要があります。  生成された`partial`クラスは `InitializeComponent` を実装します。これを呼び出すとイベントが登録され、マークアップで実装されるプロパティが設定されます。  
+  
+-   分離コードでは、クラスは、マークアップ内の `x:Class` 属性で指定されている名前を持つ`partial`クラスでなければなりません。また、<xref:System.Windows.Controls.Page> から派生する必要があります。  これによって、分離コード ファイルと、アプリケーションのビルド時にマークアップ ファイル用に生成される`partial`クラスとが関連付けられます \(「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照\)。  
+  
+-   分離コードでは、<xref:System.Windows.Controls.Page> クラスが実装するコンストラクターで `InitializeComponent` メソッドを呼び出す必要があります。  `InitializeComponent` は、マークアップ ファイル用に生成された `partial` クラスによって実装されるもので、イベントの登録と、マークアップで定義されたプロパティの設定を実行します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用してプロジェクトに新しい <xref:System.Windows.Controls.Page> を追加すると、ここでの説明したように、マークアップと分離コードの両方を使用して <xref:System.Windows.Controls.Page> が実装され、マークアップ ファイルと分離コード ファイル間の関連付けの作成に必要な構成が組み込まれます。  
+  
+ <xref:System.Windows.Controls.Page> を作成すると、これにナビゲートできるようになります。  アプリケーションがナビゲートする最初の <xref:System.Windows.Controls.Page> を指定するには、開始 <xref:System.Windows.Controls.Page> を構成する必要があります。  
+  
+<a name="Configuring_a_Start_Page"></a>   
+### 開始ページの構成  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] では、一定の量のアプリケーション インフラストラクチャをブラウザーでホストする必要があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、<xref:System.Windows.Application> クラスは、必要なアプリケーション インフラストラクチャを確立するアプリケーション定義の一部です \(「[アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)」を参照\)。  
+  
+ アプリケーション定義は、通常、マークアップと分離コードの両方を使用して、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `ApplicationDefinition` 項目として構成されたマークアップ ファイルで実装されます。[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] のアプリケーション定義を次に示します。  
+  
+ [!code-xml[XBAPAppDefSnippets#XBAPApplicationDefinitionMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppDefSnippets/CSharp/App.xaml#xbapapplicationdefinitionmarkup)]  
+  
+ [!code-csharp[XBAPAppDefSnippets#XBAPApplicationDefinitionCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XBAPAppDefSnippets/CSharp/App.xaml.cs#xbapapplicationdefinitioncodebehind)]
+ [!code-vb[XBAPAppDefSnippets#XBAPApplicationDefinitionCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XBAPAppDefSnippets/VisualBasic/Application.xaml.vb#xbapapplicationdefinitioncodebehind)]  
+  
+ [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] では、そのアプリケーション定義を使用して開始 <xref:System.Windows.Controls.Page> を指定できます。このページは、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が起動したときに自動的に呼び出される <xref:System.Windows.Controls.Page> です。  これを行うには、<xref:System.Windows.Application.StartupUri%2A> プロパティを目的の <xref:System.Windows.Controls.Page> の[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] に設定します。  
+  
+> [!NOTE]
+>  ほとんどの場合、<xref:System.Windows.Controls.Page> はアプリケーションにコンパイルされるか、アプリケーションと共に配置されます。  このような場合、<xref:System.Windows.Controls.Page> を識別する [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] です。この URI は、*パッケージ* スキームに準拠した [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] です。  パッケージ [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] については、「[WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)」で詳細に説明します。以下で説明する http スキームを使用してコンテンツにナビゲートすることもできます。  
+  
+ 次の例に示すように、マークアップで宣言によって <xref:System.Windows.Application.StartupUri%2A> を設定できます。  
+  
+ [!code-xml[NavigationOverviewSnippets#XBAPApplicationDefinitionMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/App.xaml#xbapapplicationdefinitionmarkup)]  
+  
+ この例では、HomePage.xaml を識別する相対パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] によって `StartupUri` 属性を設定します。  [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が起動すると、自動的に HomePage.xaml にナビゲートしてこのページが表示されます。  次の図に、Web サーバーから起動された [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] を示します。  
+  
+ ![XBAP ページ](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure9.png "NavigationOverviewFigure9")  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の開発および配置の詳細については、「[WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」と「[WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)」を参照してください。  
+  
+<a name="ConfiguringAXAMLPage"></a>   
+### ホスト ウィンドウのタイトル、幅、および高さの構成  
+ 前の図を見て気付くことは、ブラウザーとタブ パネルのタイトルがどちらも [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] になっていることです。  タイトルは、長いだけでなく、見た目が良いわけでも役立つ情報になっているわけでもありません。  このため、<xref:System.Windows.Controls.Page> には、<xref:System.Windows.Controls.Page.WindowTitle%2A> プロパティを設定することによってタイトルを変更する方法が用意されています。  さらに、<xref:System.Windows.Controls.Page.WindowWidth%2A> と <xref:System.Windows.Controls.Page.WindowHeight%2A> を設定して、ブラウザー ウィンドウのそれぞれ幅と高さを構成することができます。  
+  
+ <xref:System.Windows.Controls.Page.WindowTitle%2A>、<xref:System.Windows.Controls.Page.WindowWidth%2A>、および <xref:System.Windows.Controls.Page.WindowHeight%2A> は、次の例に示すように、マークアップで宣言して設定できます。  
+  
+ [!code-xml[NavigationOverviewSnippets#HomePageMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/HomePage.xaml#homepagemarkup)]  
+  
+ 結果は次の図のようになります。  
+  
+ ![ウィンドウのタイトル、高さ、幅](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure2.png "NavigationOverviewFigure2")  
+  
+<a name="NavigatingBetweenXAMLPages"></a>   
+### ハイパーリンク ナビゲーション  
+ 一般的な [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は複数のページで構成されます。  あるページから別のページにナビゲートする最も簡単な方法は、<xref:System.Windows.Documents.Hyperlink> を使用することです。  次のマークアップに示すように、`Hyperlink` 要素を使用すると、<xref:System.Windows.Documents.Hyperlink> を <xref:System.Windows.Controls.Page> に宣言によって追加できます。  
+  
+ [!code-xml[NavigationOverviewSnippets#HyperlinkXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml1)]  
+[!code-xml[NavigationOverviewSnippets#HyperlinkXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml2)]  
+[!code-xml[NavigationOverviewSnippets#HyperlinkXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml3)]  
+  
+ `Hyperlink` 要素には次のものが必要です。  
+  
+-   `NavigateUri` 属性によって指定される、ナビゲート先の <xref:System.Windows.Controls.Page> のパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。  
+  
+-   テキストやイメージなど、ナビゲーションを開始するときにクリック可能なコンテンツ \(`Hyperlink` 要素に格納可能なコンテンツについては、<xref:System.Windows.Documents.Hyperlink> を参照\)。  
+  
+ <xref:System.Windows.Documents.Hyperlink> が存在する <xref:System.Windows.Controls.Page> を持つ [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] を次の図に示します。  
+  
+ ![ハイパーリンクを含むページ](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure3.png "NavigationOverviewFigure3")  
+  
+ 想定されるとおり、<xref:System.Windows.Documents.Hyperlink> をクリックすると、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] が `NavigateUri` 属性によって識別される <xref:System.Windows.Controls.Page> にナビゲートします。  さらに、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は前の <xref:System.Windows.Controls.Page> のエントリを、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] の \[最近表示したページ\] の一覧に追加します。  これを次の図に示します。  
+  
+ ![&#91;戻る&#93; ボタンと &#91;次に進む&#93; ボタン](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure4.png "NavigationOverviewFigure4")  
+  
+ <xref:System.Windows.Controls.Page> 間のナビゲーションをサポートすると同時に、<xref:System.Windows.Documents.Hyperlink> は、フラグメント ナビゲーションもサポートします。  
+  
+<a name="FragmentNavigation"></a>   
+### フラグメント ナビゲーション  
+ *フラグメント ナビゲーション*は、現在の <xref:System.Windows.Controls.Page> または別の <xref:System.Windows.Controls.Page> にあるコンテンツ フラグメントへのナビゲーションです。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、コンテンツ フラグメントは名前付き要素に格納されるコンテンツです。  名前付き要素とは、`Name` 属性が設定されている要素です。  コンテンツ フラグメントが格納された `TextBlock` 要素を次のマークアップに示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#PageWithContentFragmentsMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithFragments.xaml#pagewithcontentfragmentsmarkup1)]  
+[!code-xml[NavigationOverviewSnippets#PageWithContentFragmentsMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithFragments.xaml#pagewithcontentfragmentsmarkup2)]  
+[!code-xml[NavigationOverviewSnippets#PageWithContentFragmentsMARKUP3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithFragments.xaml#pagewithcontentfragmentsmarkup3)]  
+  
+ コンテンツ フラグメントにナビゲートする <xref:System.Windows.Documents.Hyperlink> の場合、`NavigateUri` 属性に次のものを含める必要があります。  
+  
+-   ナビゲート先のコンテンツ フラグメントがある <xref:System.Windows.Controls.Page> の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。  
+  
+-   "\#" 文字。  
+  
+-   コンテンツ フラグメントがある <xref:System.Windows.Controls.Page> 上の要素の名前。  
+  
+ フラグメント [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の形式は、次のとおりです。  
+  
+ *PageURI* `#` *ElementName*  
+  
+ コンテンツ フラグメントにナビゲートするように構成されている `Hyperlink` の例を次に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#PageThatNavigatesXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageThatNavigatesToFragment.xaml#pagethatnavigatesxaml1)]  
+[!code-xml[NavigationOverviewSnippets#PageThatNavigatesXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageThatNavigatesToFragment.xaml#pagethatnavigatesxaml2)]  
+[!code-xml[NavigationOverviewSnippets#PageThatNavigatesXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageThatNavigatesToFragment.xaml#pagethatnavigatesxaml3)]  
+  
+> [!NOTE]
+>  ここでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] での既定のフラグメント ナビゲーション実装について説明します。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、<xref:System.Windows.Navigation.NavigationService.FragmentNavigation?displayProperty=fullName> イベントの処理などが必要な独自のフラグメント ナビゲーション スキームを実装することもできます。  
+  
+> [!IMPORTANT]
+>  Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページ \(ルート要素として `Page` を持つマークアップのみの [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル\) 内のフラグメントには、[!INCLUDE[TLA2#tla_http](../../../../includes/tla2sharptla-http-md.md)] を使用してページを参照可能な場合のみナビゲートできます。  
+>   
+>  ただし、Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページは、自身のフラグメントにナビゲートできます。  
+  
+<a name="NavigationService"></a>   
+### ナビゲーション サービス  
+ <xref:System.Windows.Documents.Hyperlink> を使用すると、ユーザーは特定の <xref:System.Windows.Controls.Page> へのナビゲーションを開始できますが、ページの位置の特定とダウンロードは <xref:System.Windows.Navigation.NavigationService> クラスによって実行されます。  基本的に、<xref:System.Windows.Navigation.NavigationService> は <xref:System.Windows.Documents.Hyperlink> などのクライアント コードの代わりに、ナビゲーション要求を処理できます。  さらに、<xref:System.Windows.Navigation.NavigationService> はナビゲーション要求の追跡および制御の高レベルなサポートを実装します。  
+  
+ <xref:System.Windows.Documents.Hyperlink> がクリックされると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は <xref:System.Windows.Navigation.NavigationService.Navigate%2A?displayProperty=fullName> を呼び出し、指定されたパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] にある <xref:System.Windows.Controls.Page> を特定してダウンロードします。  ダウンロードされた <xref:System.Windows.Controls.Page> は、ルート オブジェクトが、ダウンロードされた <xref:System.Windows.Controls.Page> のインスタンスとなっているオブジェクトのツリーに変換されます。  ルート <xref:System.Windows.Controls.Page> オブジェクトへの参照は、<xref:System.Windows.Navigation.NavigationService.Content%2A?displayProperty=fullName> プロパティに格納されます。  ナビゲート先のコンテンツのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、<xref:System.Windows.Navigation.NavigationService.Source%2A?displayProperty=fullName> プロパティに格納されますが、<xref:System.Windows.Navigation.NavigationService.CurrentSource%2A?displayProperty=fullName> にはナビゲート先の最後のページのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が格納されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションには、現在アクティブな <xref:System.Windows.Navigation.NavigationService> が複数存在していてもかまいません。  詳細については、このトピックで後述する「[ナビゲーション ホスト](#Navigation_Hosts)」を参照してください。  
+  
+<a name="Programmatic_Navigation_with_the_Navigation_Service"></a>   
+### ナビゲーション サービスを使用するプログラム ナビゲーション  
+ ナビゲーションが、<xref:System.Windows.Documents.Hyperlink> を使用してマークアップで宣言として実装されている場合は、開発者が <xref:System.Windows.Navigation.NavigationService> について認識していなくてもかまいません。<xref:System.Windows.Documents.Hyperlink> が自動的に <xref:System.Windows.Navigation.NavigationService> を使用するためです。  つまり、<xref:System.Windows.Documents.Hyperlink> の直接または間接的な親がナビゲーション ホスト \(「[ナビゲーション ホスト](#Navigation_Hosts)」を参照\) である場合、<xref:System.Windows.Documents.Hyperlink> は、そのナビゲーション ホストのナビゲーション サービスを発見および使用して、ナビゲーション要求を処理できます。  
+  
+ ただし、次の場合は <xref:System.Windows.Navigation.NavigationService> を直接使用する必要があります。  
+  
+-   既定以外のコンストラクターを使用して <xref:System.Windows.Controls.Page> をインスタンス化する必要がある場合。  
+  
+-   ナビゲートする前に <xref:System.Windows.Controls.Page> のプロパティを設定する必要がある場合。  
+  
+-   どの <xref:System.Windows.Controls.Page> にナビゲートするかが、実行時まで決定できない場合。  
+  
+ これらの場合は、<xref:System.Windows.Navigation.NavigationService> オブジェクトの <xref:System.Windows.Navigation.NavigationService.Navigate%2A> メソッドを呼び出して、プログラムよってナビゲーションを開始するためのコードを記述する必要があります。  そのためには、<xref:System.Windows.Navigation.NavigationService> への参照を取得する必要があります。  
+  
+#### NavigationService への参照の取得  
+ 「[ナビゲーション ホスト](#Navigation_Hosts)」で説明する理由によって、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションには複数の <xref:System.Windows.Navigation.NavigationService> が存在していてもかまいません。  これは、コードに <xref:System.Windows.Navigation.NavigationService> \(通常は、現在の <xref:System.Windows.Controls.Page> にナビゲートした <xref:System.Windows.Navigation.NavigationService>\) を検索する方法が必要なことを意味します。<xref:System.Windows.Navigation.NavigationService> への参照は、`static` <xref:System.Windows.Navigation.NavigationService.GetNavigationService%2A?displayProperty=fullName> メソッドを呼び出して取得できます。  特定の <xref:System.Windows.Controls.Page> にナビゲートした <xref:System.Windows.Navigation.NavigationService> を取得するには、参照を <xref:System.Windows.Navigation.NavigationService.GetNavigationService%2A> メソッドの引数として <xref:System.Windows.Controls.Page> に渡します。  現在の <xref:System.Windows.Controls.Page> の <xref:System.Windows.Navigation.NavigationService> を取得する方法を次のコードに示します。  
+  
+ [!code-csharp[NavigationOverviewSnippets#GetNSCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/GetNSPage.xaml.cs#getnscodebehind1)]  
+[!code-csharp[NavigationOverviewSnippets#GetNSCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/GetNSPage.xaml.cs#getnscodebehind2)]
+[!code-vb[NavigationOverviewSnippets#GetNSCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/GetNSPage.xaml.vb#getnscodebehind2)]  
+  
+ <xref:System.Windows.Controls.Page> の <xref:System.Windows.Navigation.NavigationService> を検索するショートカットとして、<xref:System.Windows.Controls.Page> は <xref:System.Windows.Controls.Page.NavigationService%2A> プロパティを実装します。  これを次の例に示します。  
+  
+ [!code-csharp[NavigationOverviewSnippets#GetNSShortcutCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/GetNSPageShortCut.xaml.cs#getnsshortcutcodebehind1)]  
+[!code-csharp[NavigationOverviewSnippets#GetNSShortcutCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/GetNSPageShortCut.xaml.cs#getnsshortcutcodebehind2)]
+[!code-vb[NavigationOverviewSnippets#GetNSShortcutCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/GetNSPageShortCut.xaml.vb#getnsshortcutcodebehind2)]  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.Page> によって <xref:System.Windows.FrameworkElement.Loaded> イベントが発生した場合、<xref:System.Windows.Controls.Page> は、その <xref:System.Windows.Navigation.NavigationService> への参照のみを取得できます。  
+  
+#### ページ オブジェクトへのプログラム ナビゲーション  
+ <xref:System.Windows.Navigation.NavigationService> を使用して、<xref:System.Windows.Controls.Page> にプログラムによってナビゲートする方法を次の例に示します。  ナビゲート先の <xref:System.Windows.Controls.Page> は、1 つの既定以外のコンストラクターを使用した場合にのみインスタンス化できるため、プログラム ナビゲーションが必要になります。  既定以外のコンストラクターを持つ <xref:System.Windows.Controls.Page> を、次のマークアップおよびコードに示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#PageWithNonDefaultConstructorXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithNonDefaultConstructor.xaml#pagewithnondefaultconstructorxaml)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#PageWithNonDefaultConstructorCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithNonDefaultConstructor.xaml.cs#pagewithnondefaultconstructorcodebehind)]
+ [!code-vb[NavigationOverviewSnippets#PageWithNonDefaultConstructorCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/PageWithNonDefaultConstructor.xaml.vb#pagewithnondefaultconstructorcodebehind)]  
+  
+ 既定以外のコンストラクターを持つ <xref:System.Windows.Controls.Page> にナビゲートする <xref:System.Windows.Controls.Page> を、次のマークアップおよびコードに示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#NSNavigationPageXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSNavigationPage.xaml#nsnavigationpagexaml)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#NSNavigationPageCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSNavigationPage.xaml.cs#nsnavigationpagecodebehind)]
+ [!code-vb[NavigationOverviewSnippets#NSNavigationPageCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/NSNavigationPage.xaml.vb#nsnavigationpagecodebehind)]  
+  
+ この <xref:System.Windows.Controls.Page> 上の <xref:System.Windows.Documents.Hyperlink> がクリックされると、既定以外のコンストラクターを使用して <xref:System.Windows.Navigation.NavigationService.Navigate%2A?displayProperty=fullName> メソッドを呼び出し、ナビゲート先の <xref:System.Windows.Controls.Page> をインスタンス化することによって、ナビゲーションが開始されます。  <xref:System.Windows.Navigation.NavigationService.Navigate%2A> は、パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] ではなく、<xref:System.Windows.Navigation.NavigationService> がナビゲートするオブジェクトへの参照を受け取ります。  
+  
+#### パッケージ URI を使用するプログラム ナビゲーション  
+ パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] をプログラムによって構築する必要がある場合 \(たとえば、実行時にのみパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を決定できる場合など\) は、<xref:System.Windows.Navigation.NavigationService.Navigate%2A?displayProperty=fullName> メソッドを使用できます。  これを次の例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#NSUriNavigationPageXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSUriNavigationPage.xaml#nsurinavigationpagexaml)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#NSUriNavigationPageCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSUriNavigationPage.xaml.cs#nsurinavigationpagecodebehind)]
+ [!code-vb[NavigationOverviewSnippets#NSUriNavigationPageCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/NSUriNavigationPage.xaml.vb#nsurinavigationpagecodebehind)]  
+  
+#### 現在のページの更新  
+ <xref:System.Windows.Controls.Page> が、<xref:System.Windows.Navigation.NavigationService.Source%2A?displayProperty=fullName> プロパティに格納されているパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] と同じパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を持つ場合、このページはダウンロードされません。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で現在のページを再度強制的にダウンロードするには、次の例に示すように <xref:System.Windows.Navigation.NavigationService.Refresh%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+ [!code-xml[NavigationOverviewSnippets#NSRefreshNavigationPageXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSRefreshNavigationPage.xaml#nsrefreshnavigationpagexaml1)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#NSRefreshNavigationPageCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSRefreshNavigationPage.xaml.cs#nsrefreshnavigationpagecodebehind1)]
+ [!code-vb[NavigationOverviewSnippets#NSRefreshNavigationPageCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/NSRefreshNavigationPage.xaml.vb#nsrefreshnavigationpagecodebehind1)]  
+[!code-csharp[NavigationOverviewSnippets#NSRefreshNavigationPageCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NSRefreshNavigationPage.xaml.cs#nsrefreshnavigationpagecodebehind2)]
+[!code-vb[NavigationOverviewSnippets#NSRefreshNavigationPageCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/NSRefreshNavigationPage.xaml.vb#nsrefreshnavigationpagecodebehind2)]  
+  
+<a name="Navigation_Lifetime"></a>   
+### ナビゲーションの有効期間  
+ これまで説明したように、ナビゲーションを開始するには多くの方法があります。  ナビゲーションを開始すると、ナビゲーションの進行中は、<xref:System.Windows.Navigation.NavigationService> によって実装された次のイベントを使用して、ナビゲーションを追跡および制御できます。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.Navigating>.  新しいナビゲーションが要求されると発生します。  ナビゲーションのキャンセルに使用できます。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.NavigationProgress>.  ダウンロード中に定期的に発生して、ナビゲーションの進行状況に関する情報を提供します。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.Navigated>.  ページの位置の特定とダウンロードが完了したときに発生します。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.NavigationStopped>.  ナビゲーションが \(<xref:System.Windows.Navigation.NavigationService.StopLoading%2A> の呼び出しによって\) 中止されたときや、現在のナビゲーションの進行中に新しいナビゲーションが要求されたときに発生します。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.NavigationFailed>.  要求されたコンテンツに移動する際にエラーが発生すると発生します。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.LoadCompleted>.  ナビゲート先のコンテンツが読み込まれ、解析されて、レンダリングが開始されると発生します。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.FragmentNavigation>.  コンテンツ フラグメントへのナビゲーションが開始されたときに、次のタイミングで発生します。  
+  
+    -   目的のフラグメントが現在のコンテンツに含まれる場合はすぐに発生します。  
+  
+    -   目的のフラグメントが別のコンテンツに含まれる場合は、ソース コンテンツが読み込まれた後で発生します。  
+  
+ ナビゲーション イベントが発生する順序を次の図に示します。  
+  
+ ![ページ ナビゲーションのフロー チャート](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure11.png "NavigationOverviewFigure11")  
+  
+ 通常、<xref:System.Windows.Controls.Page> はこれらのイベントの影響を受けません。  アプリケーションはこれらのイベントの影響を受ける可能性が高いため、これらのイベントは <xref:System.Windows.Application> クラスによっても発生します。  
+  
+-   <xref:System.Windows.Application.Navigating?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.NavigationProgress?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.Navigated?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.NavigationFailed?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.NavigationStopped?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.LoadCompleted?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Application.FragmentNavigation?displayProperty=fullName>  
+  
+ <xref:System.Windows.Navigation.NavigationService> によってイベントが発生するたびに、<xref:System.Windows.Application> クラスによって対応するイベントが発生します。  <xref:System.Windows.Controls.Frame> および <xref:System.Windows.Navigation.NavigationWindow> は、それぞれのスコープ内でナビゲーションを検出する同じイベントを提供します。  
+  
+ 場合によっては、<xref:System.Windows.Controls.Page> がこれらのイベントに関与することがあります。  たとえば、<xref:System.Windows.Controls.Page> は <xref:System.Windows.Navigation.NavigationService.Navigating?displayProperty=fullName> イベントを処理して、ページ外へのナビゲーションをキャンセルするかどうかを決定する場合があります。  これを次の例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#CancelNavigationPageXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/CancelNavigationPage.xaml#cancelnavigationpagexaml)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#CancelNavigationPageCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/CancelNavigationPage.xaml.cs#cancelnavigationpagecodebehind)]
+ [!code-vb[NavigationOverviewSnippets#CancelNavigationPageCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/CancelNavigationPage.xaml.vb#cancelnavigationpagecodebehind)]  
+  
+ 前の例で行ったように、<xref:System.Windows.Controls.Page> からのナビゲーション イベントを含むハンドラーを登録する場合、イベント ハンドラーの登録を解除する必要もあります。  解除しない場合、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ナビゲーションが履歴を使用して <xref:System.Windows.Controls.Page> ナビゲーションを記録する方法に関して副作用が発生する可能性があります。  
+  
+<a name="NavigationHistory"></a>   
+### 履歴によるナビゲーションの記録  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、"戻る" スタックと "進む" スタックの 2 つのスタックを使用して、ナビゲート元のページを記録します。  現在の <xref:System.Windows.Controls.Page> から新しい <xref:System.Windows.Controls.Page> にナビゲートするか、既存の <xref:System.Windows.Controls.Page> に進む場合、現在の <xref:System.Windows.Controls.Page> が *"戻る" スタック*に追加されます。  現在の <xref:System.Windows.Controls.Page> から前の <xref:System.Windows.Controls.Page> に戻る場合、現在の <xref:System.Windows.Controls.Page> が *"進む" スタック*に追加されます。  "戻る" スタック、"進む" スタック、およびそれらを管理する機能を、まとめて履歴と呼びます。  "戻る" スタックと "進む" スタックの各項目は、<xref:System.Windows.Navigation.JournalEntry> クラスのインスタンスです。これを*履歴エントリ*と呼びます。  
+  
+#### Internet Explorer からの履歴のナビゲート  
+ 概念として、履歴は [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] の **\[戻る\]** ボタンおよび **\[進む\]** ボタンと同じように機能します。  次の図に例を示します。  
+  
+ ![&#91;戻る&#93; ボタンと &#91;次に進む&#93; ボタン](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure4.png "NavigationOverviewFigure4")  
+  
+ [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] によってホストされる [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の場合、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は履歴を [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] のナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] に統合します。  これによって、ユーザーは [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] の **\[戻る\]**、**\[進む\]**、および **\[最近表示したページ\]** の各ボタンを使用して [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] のページ間をナビゲートできるようになります。[!INCLUDE[TLA2#tla_ie6](../../../../includes/tla2sharptla-ie6-md.md)] には、[!INCLUDE[TLA2#tla_ie7](../../../../includes/tla2sharptla-ie7-md.md)] または Internet Explorer 8 と同じ方法では履歴は統合されません。  代わりに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は代替ナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をレンダリングします。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] では、ユーザーが [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] との間をナビゲートすると、履歴に保持されていないページの履歴項目のみが履歴に保持されます。  ページを履歴に保持する方法については、このトピックで後述する「[ページの有効期間と履歴](#PageLifetime)」を参照してください。  
+  
+ 既定では、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] の **\[最近表示したページ\]** の一覧に表示される各 <xref:System.Windows.Controls.Page> のテキストは、<xref:System.Windows.Controls.Page> の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] になっています。  多くの場合、これはユーザーにとって特別な意味がありません。  このため、次のオプションのいずれかを使用してテキストを変更できます。  
+  
+1.  `JournalEntry.Name` 添付属性値。  
+  
+2.  `Page.Title` 属性値。  
+  
+3.  `Page.WindowTitle` 属性値、および現在の <xref:System.Windows.Controls.Page> の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。  
+  
+4.  現在の <xref:System.Windows.Controls.Page> の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]。  \(既定値\)  
+  
+ これらのオプションの順序は、テキスト検索の優先順位と一致します。  たとえば、`JournalEntry.Name` が設定されている場合、他の値は無視されます。  
+  
+ `Page.Title` 属性を使用して、履歴エントリに表示されるテキストを変更する方法を次の例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#PageTitleMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithTitle.xaml#pagetitlemarkup1)]  
+[!code-xml[NavigationOverviewSnippets#PageTitleMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithTitle.xaml#pagetitlemarkup2)]  
+  
+ [!code-csharp[NavigationOverviewSnippets#PageTitleCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithTitle.xaml.cs#pagetitlecodebehind1)]
+ [!code-vb[NavigationOverviewSnippets#PageTitleCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/PageWithTitle.xaml.vb#pagetitlecodebehind1)]  
+[!code-csharp[NavigationOverviewSnippets#PageTitleCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithTitle.xaml.cs#pagetitlecodebehind2)]
+[!code-vb[NavigationOverviewSnippets#PageTitleCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigationOverviewSnippets/VisualBasic/PageWithTitle.xaml.vb#pagetitlecodebehind2)]  
+  
+#### WPF を使用する履歴のナビゲート  
+ ユーザーは [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] の **\[戻る\]**、**\[進む\]**、および **\[最近表示したページ\]** を使用して履歴をナビゲートできますが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で提供された宣言による機構やプログラムによる機構を使用しても履歴をナビゲートできます。  これを行うのは、たとえば、独自のナビゲーション [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] をページに表示する場合です。  
+  
+ <xref:System.Windows.Input.NavigationCommands> で公開されるナビゲーション コマンドを使用して、履歴ナビゲーション サポートを宣言によって追加できます。  `BrowseBack` ナビゲーション コマンドの使用方法を次の例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#NavigationCommandsPageXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NavigationCommandsPage.xaml#navigationcommandspagexaml1)]  
+[!code-xml[NavigationOverviewSnippets#NavigationCommandsPageXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NavigationCommandsPage.xaml#navigationcommandspagexaml2)]  
+[!code-xml[NavigationOverviewSnippets#NavigationCommandsPageXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NavigationCommandsPage.xaml#navigationcommandspagexaml3)]  
+[!code-xml[NavigationOverviewSnippets#NavigationCommandsPageXAML4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/NavigationCommandsPage.xaml#navigationcommandspagexaml4)]  
+  
+ <xref:System.Windows.Navigation.NavigationService> クラスの次のメンバーのいずれかを使用して、プログラムによって履歴をナビゲートできます。  
+  
+-   <xref:System.Windows.Navigation.NavigationService.GoBack%2A>  
+  
+-   <xref:System.Windows.Navigation.NavigationService.GoForward%2A>  
+  
+-   <xref:System.Windows.Navigation.NavigationService.CanGoBack%2A>  
+  
+-   <xref:System.Windows.Navigation.NavigationService.CanGoForward%2A>  
+  
+ このトピックの「[ナビゲーション履歴を使用したコンテンツ状態の保持](#RetainingContentStateWithNavigationHistory)」で後述するように、プログラムによって履歴を操作することも可能です。  
+  
+<a name="PageLifetime"></a>   
+### ページの有効期間と履歴  
+ グラフィックス、アニメーション、メディアなどのリッチ コンテンツを含む、複数のページが存在する [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] について説明します。  特にビデオやオーディオ メディアが使用されている場合、これらのページのメモリ使用量は、長時間が経過すると非常に大きくなる可能性があります。  履歴がナビゲート先のページを "記録" することを考えると、このような [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] はすぐに大量のメモリを消費する可能性があります。  
+  
+ このため、履歴の既定の動作では、<xref:System.Windows.Controls.Page> オブジェクトへの参照ではなく、<xref:System.Windows.Controls.Page> メタデータが各履歴エントリに格納されます。  履歴エントリにナビゲートすると、その <xref:System.Windows.Controls.Page> メタデータを使用して、指定した <xref:System.Windows.Controls.Page> の新しいインスタンスが作成されます。  結果として、ナビゲートされた各 <xref:System.Windows.Controls.Page> には、次の図に示す有効期間が設定されます。  
+  
+ ![ページの有効期間](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure10.PNG "NavigationOverviewFigure10")  
+  
+ 既定の履歴動作を使用するとメモリの消費を節約できますが、特にコンテンツが多い場合は、ページごとのレンダリングのパフォーマンスが低下し、<xref:System.Windows.Controls.Page> の再インスタンス化に時間がかかる可能性があります。  <xref:System.Windows.Controls.Page> インスタンスを履歴に保持する必要がある場合、2 つの方法を使用してこれを行うことができます。  1 つ目の方法は、<xref:System.Windows.Navigation.NavigationService.Navigate%2A?displayProperty=fullName> メソッドを呼び出すことによって、<xref:System.Windows.Controls.Page> オブジェクトにプログラムによるナビゲートを行います。  
+  
+ 2 つ目の方法は、<xref:System.Windows.Controls.Page.KeepAlive%2A> プロパティを `true` \(既定値は `false`\) に設定することによって、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が <xref:System.Windows.Controls.Page> のインスタンスを履歴に保持するように指定します。  次の例に示すように、マークアップで宣言によって <xref:System.Windows.Controls.Page.KeepAlive%2A> を設定できます。  
+  
+ [!code-xml[NavigationOverviewSnippets#KeepAlivePageXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/KeepAlivePage.xaml#keepalivepagexaml)]  
+  
+ 履歴に保持される <xref:System.Windows.Controls.Page> と保持されないページの有効期間は、わずかに異なります。  履歴に保持される <xref:System.Windows.Controls.Page> が初めてナビゲートされると、履歴に保持されない <xref:System.Windows.Controls.Page> と同様にインスタンス化されます。  ただし、<xref:System.Windows.Controls.Page> のインスタンスは履歴に保持されるため、履歴に残っている限り再びインスタンス化されることはありません。  したがって、<xref:System.Windows.Controls.Page> がナビゲートされるたびに呼び出す必要がある初期化ロジックを <xref:System.Windows.Controls.Page> が持っている場合、それをコンストラクターから <xref:System.Windows.FrameworkElement.Loaded> イベントのハンドラーに移動する必要があります。  このようにしても、次の図に示すように、<xref:System.Windows.Controls.Page> がナビゲート先およびナビゲート元となるたびに、それぞれ <xref:System.Windows.FrameworkElement.Loaded> イベントと <xref:System.Windows.FrameworkElement.Unloaded> イベントが発生します。  
+  
+ ![Loaded イベントと Unloaded イベントが発生した場合](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure17.png "NavigationOverviewFigure17")  
+  
+ <xref:System.Windows.Controls.Page> が履歴に保持されない場合、次のいずれの操作も行わないでください。  
+  
+-   ページへの参照、または一部分を格納する。  
+  
+-   ページによって実装されていないイベントのイベント ハンドラーを登録する。  
+  
+ このいずれかの操作を行うと、<xref:System.Windows.Controls.Page> を履歴から削除した後でも強制的にメモリに保持される参照が作成されます。  
+  
+ 通常は、<xref:System.Windows.Controls.Page> を履歴に保持しない <xref:System.Windows.Controls.Page> の既定の動作をお勧めします。  ただし、これには次のセクションで説明する状態も関係します。  
+  
+<a name="RetainingContentStateWithNavigationHistory"></a>   
+### ナビゲーション履歴を使用したコンテンツ状態の保持  
+ <xref:System.Windows.Controls.Page> が履歴に保持されず、ユーザーからデータを収集するコントロールを持っている場合、ユーザーが <xref:System.Windows.Controls.Page> との間でナビゲートすると、データに対して何が行われるでしょうか。  ユーザー エクスペリエンスの観点では、ユーザーは前に入力したデータが表示されることを期待します。  しかし、<xref:System.Windows.Controls.Page> の新しいインスタンスはナビゲーションごとに作成されるため、データを収集したコントロールが再インスタンス化されてデータは失われます。  
+  
+ ただし、履歴は <xref:System.Windows.Controls.Page> ナビゲーション間をまたいだデータ \(コントロール データなど\) の記録をサポートします。  具体的には、各 <xref:System.Windows.Controls.Page> の履歴エントリは、関連している <xref:System.Windows.Controls.Page> 状態情報の一時的なコンテナーとして機能します。  <xref:System.Windows.Controls.Page> からナビゲートするときにこのサポートがどのように使用されるかを次の手順に示します。  
+  
+1.  現在の <xref:System.Windows.Controls.Page> のエントリが履歴に追加されます。  
+  
+2.  <xref:System.Windows.Controls.Page> の状態情報が、そのページの履歴エントリに格納され、"戻る" スタックに追加されます。  
+  
+3.  新しい <xref:System.Windows.Controls.Page> にナビゲートします。  
+  
+ 履歴を使用してページ <xref:System.Windows.Controls.Page> に戻るときは、次の手順が実行されます。  
+  
+1.  <xref:System.Windows.Controls.Page> \("戻る" スタックの 1 番上の履歴エントリ\) がインスタンス化されます。  
+  
+2.  <xref:System.Windows.Controls.Page> の履歴エントリに格納された状態情報を使用して、<xref:System.Windows.Controls.Page> が更新されます。  
+  
+3.  <xref:System.Windows.Controls.Page> に戻ります。  
+  
+ <xref:System.Windows.Controls.Page> で次のコントロールが使用されると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は自動的にこのサポートを使用します。  
+  
+-   <xref:System.Windows.Controls.CheckBox>  
+  
+-   <xref:System.Windows.Controls.ComboBox>  
+  
+-   <xref:System.Windows.Controls.Expander>  
+  
+-   <xref:System.Windows.Controls.Frame>  
+  
+-   <xref:System.Windows.Controls.ListBox>  
+  
+-   <xref:System.Windows.Controls.ListBoxItem>  
+  
+-   <xref:System.Windows.Controls.MenuItem>  
+  
+-   <xref:System.Windows.Controls.ProgressBar>  
+  
+-   <xref:System.Windows.Controls.RadioButton>  
+  
+-   <xref:System.Windows.Controls.Slider>  
+  
+-   <xref:System.Windows.Controls.TabControl>  
+  
+-   <xref:System.Windows.Controls.TabItem>  
+  
+-   <xref:System.Windows.Controls.TextBox>  
+  
+ 次の図の **\[Favorite Color\]** <xref:System.Windows.Controls.ListBox> が示すように、<xref:System.Windows.Controls.Page> がこれらのコントロールを使用する場合、項目に入力されたデータが <xref:System.Windows.Controls.Page> ナビゲーション間をまたいで記録されます。  
+  
+ ![状態を記憶するコントロールを含むページ](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure13.png "NavigationOverviewFigure13")  
+  
+ 前述の一覧にないコントロールが <xref:System.Windows.Controls.Page> にある場合や、状態情報がカスタム オブジェクトに格納されている場合、<xref:System.Windows.Controls.Page> ナビゲーション間をまたぐ状態を履歴に記録するコードを記述する必要があります。  
+  
+ <xref:System.Windows.Controls.Page> ナビゲーション間をまたぐ少量の状態情報を記録する必要がある場合、<xref:System.Windows.FrameworkPropertyMetadata.Journal%2A?displayProperty=fullName> メタデータ フラグを使用して構成された依存関係プロパティ \(<xref:System.Windows.DependencyProperty> を参照\) を使用できます。  
+  
+ ナビゲーション間をまたいで記録する必要がある <xref:System.Windows.Controls.Page> の状態情報が複数のデータで構成される場合は、状態情報を 1 つのクラスにカプセル化して <xref:System.Windows.Navigation.IProvideCustomContentState> を実装する方が、コードが簡単になる場合があります。  
+  
+ <xref:System.Windows.Controls.Page> 自体からはナビゲートせずに、1 つの <xref:System.Windows.Controls.Page> のさまざまな状態情報をナビゲートする必要がある場合、<xref:System.Windows.Navigation.IProvideCustomContentState> と <xref:System.Windows.Navigation.NavigationService.AddBackEntry%2A?displayProperty=fullName> を使用できます。  
+  
+<a name="Cookies"></a>   
+### クッキー  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションがデータを格納する別の方法では、クッキーを使用します。クッキーは、<xref:System.Windows.Application.SetCookie%2A> メソッドと <xref:System.Windows.Application.GetCookie%2A> メソッドを使用して作成、更新、および削除されます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で作成できるクッキーは、他の種類の Web アプリケーションが使用クッキー同じです。クッキーとは、アプリケーション セッションが完了するまで、または複数のアプリケーション セッションにわたって、クライアント コンピューター上にアプリケーションによって格納される任意のデータです。  クッキー データは通常、次のような名前と値の組み合わせで構成されます。  
+  
+ *Name* `=` *Value*  
+  
+ データが、クッキーを設定する場所の <xref:System.Uri> と共に <xref:System.Windows.Application.SetCookie%2A> に渡されると、メモリ内にクッキーが作成され、現在のアプリケーション セッションの期間のみ使用可能になります。  この種類のクッキーは、*セッション クッキー* と呼ばれます。  
+  
+ 複数のアプリケーション セッションにわたってクッキーを格納するには、次の形式を使用してクッキーに有効期限を追加する必要があります。  
+  
+ *NAME* `=` *VALUE* `; expires=DAY, DD-MMM-YYYY HH:MM:SS GMT`  
+  
+ 有効期限を持つクッキーは、その期限が切れるまで、現在の [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] インストールのインターネット一時ファイル フォルダーに格納されます。  このようなクッキーは、アプリケーション セッションをまたいで存続するため、*永続的なクッキー*と呼ばれます。  
+  
+ セッション クッキーと永続的なクッキーの両方を取得するには、<xref:System.Windows.Application.GetCookie%2A> メソッドを呼び出し、<xref:System.Windows.Application.SetCookie%2A> メソッドを使用してクッキーを設定した場所の <xref:System.Uri> を渡します。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でクッキーがどのようにサポートされるかを次に示します。  
+  
+-   [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] スタンドアロン アプリケーションと [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、クッキーの作成と管理のどちらも行うことができます。  
+  
+-   [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] によって作成されたクッキーには、ブラウザーからアクセスできます。  
+  
+-   同じドメインの [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、クッキーを共有できます。  
+  
+-   同じドメインの [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] ページと [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ページは、クッキーを作成して共有できます。  
+  
+-   [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] ページと Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページが Web 要求を行うと、クッキーがディスパッチされます。  
+  
+-   IFRAMES にホストされた最上位の [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] と [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、どちらもクッキーにアクセスできます。  
+  
+-   [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でのクッキー サポートは、サポートされるすべてのブラウザーで同じです。  
+  
+-   [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] では、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、クッキーに関連する P3P ポリシー \(特に開発元とサードパーティの [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] に関して\) に従います。  
+  
+<a name="Structured_Navigation"></a>   
+### 構造化ナビゲーション  
+ <xref:System.Windows.Controls.Page> 間でデータを渡す必要がある場合、<xref:System.Windows.Controls.Page> の既定以外のコンストラクターにデータを引数として渡すことができます。  この方法を使用する場合、<xref:System.Windows.Controls.Page> を履歴に保持する必要があることに注意してください。保持しない場合、次回 <xref:System.Windows.Controls.Page> にナビゲートすると、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が既定のコンストラクターを使用して <xref:System.Windows.Controls.Page> を再インスタンス化します。  
+  
+ または、渡す必要があるデータを使用して設定されたプロパティを <xref:System.Windows.Controls.Page> に実装することもできます。  ただし、<xref:System.Windows.Controls.Page> がナビゲート元の <xref:System.Windows.Controls.Page> にデータを戻す場合は、少し手間がかかります。  問題は、ナビゲート後に <xref:System.Windows.Controls.Page> に戻ることを保証する機構を、ナビゲーションがネイティブにサポートしていないことにあります。  基本的に、ナビゲーションは "呼び出す\/戻る" のセマンティクスをサポートしません。  この問題を解決するため、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、予測可能な構造化された方法で <xref:System.Windows.Controls.Page> に戻ることができるようにする <xref:System.Windows.Navigation.PageFunction%601> クラスを提供します。  詳細については、「[構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)」を参照してください。  
+  
+<a name="The_NavigationWindow_Class"></a>   
+## NavigationWindow クラス  
+ ここまでで、ナビゲート可能なコンテンツによってアプリケーションをビルドするために使用する可能性が最も高い、ナビゲーション サービスの全容について説明しました。  これらのサービスについて [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] のコンテキストで説明しましたが、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] だけで使用されているわけではありません。  最新のオペレーティング システムおよび [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] アプリケーションでは、最近のユーザーがブラウザーの使用経験を持つことを考慮して、スタンドアロン アプリケーションにブラウザー スタイルのナビゲーションが組み込まれています。一般的な例は次のとおりです。  
+  
+-   **Word の類義語辞典** : 選択可能な単語をナビゲートします。  
+  
+-   **ファイル エクスプローラー** : ファイルとフォルダーをナビゲートします。  
+  
+-   **ウィザード** : 複雑なタスクを複数のページに分割し、ページ間をナビゲートできます。  たとえば、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] 機能の追加と削除を行う Windows コンポーネント ウィザードなどがあります。  
+  
+ ブラウザー スタイルのナビゲーションをスタンドアロン アプリケーションに組み込むには、<xref:System.Windows.Navigation.NavigationWindow> クラスを使用します。  <xref:System.Windows.Navigation.NavigationWindow> は、<xref:System.Windows.Window> から派生しており、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] が提供するナビゲーションを同じようにサポートして、ウィンドウを拡張します。<xref:System.Windows.Navigation.NavigationWindow> は、スタンドアロン アプリケーションのメイン ウィンドウとしても、ダイアログ ボックスなどの 2 次ウィンドウとしても使用できます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の最上位クラス \(<xref:System.Windows.Window>、<xref:System.Windows.Controls.Page> など\) と同様に <xref:System.Windows.Navigation.NavigationWindow> を実装するには、マークアップと分離コードの組み合わせを使用します。  これを次の例に示します。  
+  
+ [!code-xml[IntroToNavNavigationWindowSnippets#NavigationWindowMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/MainWindow.xaml#navigationwindowmarkup)]  
+  
+ [!code-csharp[IntroToNavNavigationWindowSnippets#NavigationWindowCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/MainWindow.xaml.cs#navigationwindowcodebehind)]
+ [!code-vb[IntroToNavNavigationWindowSnippets#NavigationWindowCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/VisualBasic/MainWindow.xaml.vb#navigationwindowcodebehind)]  
+  
+ このコードは、<xref:System.Windows.Navigation.NavigationWindow> を開いたときに自動的に <xref:System.Windows.Controls.Page> \(HomePage.xaml\) にナビゲートする <xref:System.Windows.Navigation.NavigationWindow> を作成します。  <xref:System.Windows.Navigation.NavigationWindow> がアプリケーションのメイン ウィンドウの場合、`StartupUri` 属性を使用してこのウィンドウを起動できます。  これを次のマークアップに示します。  
+  
+ [!code-xml[IntroToNavNavigationWindowSnippets#AppLaunchNavWindow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/App.xaml#applaunchnavwindow)]  
+  
+ 次の図に、スタンドアロン アプリケーションのメイン ウィンドウとしての <xref:System.Windows.Navigation.NavigationWindow> を示します。  
+  
+ ![メイン ウィンドウ](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure18.png "NavigationOverviewFigure18")  
+  
+ この図では、前の例の <xref:System.Windows.Navigation.NavigationWindow> 実装コードでは設定しなかったにもかかわらず、<xref:System.Windows.Navigation.NavigationWindow> にタイトルが表示されています。  代わりに、次のコードに示す <xref:System.Windows.Controls.Page.WindowTitle%2A> プロパティを使用してタイトルを設定します。  
+  
+ [!code-xml[IntroToNavNavigationWindowSnippets#HomePageMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/HomePage.xaml#homepagemarkup1)]  
+[!code-xml[IntroToNavNavigationWindowSnippets#HomePageMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/HomePage.xaml#homepagemarkup2)]  
+  
+ <xref:System.Windows.Controls.Page.WindowWidth%2A> プロパティと <xref:System.Windows.Controls.Page.WindowHeight%2A> プロパティを設定すると、<xref:System.Windows.Navigation.NavigationWindow> にも影響を与えます。  
+  
+ 通常、動作または外観をカスタマイズする必要があるときに、独自の <xref:System.Windows.Navigation.NavigationWindow> を実装します。  どちらも行わない場合は、ショートカットを使用できます。  スタンドアロン アプリケーションで <xref:System.Windows.Controls.Page> のパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を <xref:System.Windows.Application.StartupUri%2A> として指定した場合、<xref:System.Windows.Application> は自動的に <xref:System.Windows.Navigation.NavigationWindow> を作成して <xref:System.Windows.Controls.Page> をホストします。  これを行う方法を次のマークアップに示します。  
+  
+ [!code-xml[IntroToNavNavigationWindowSnippets#AppLaunchPage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/AnotherApp.xaml#applaunchpage)]  
+  
+ ダイアログ ボックスなどの、アプリケーションの 2 次ウィンドウを <xref:System.Windows.Navigation.NavigationWindow> にする場合、次の例のコードを使用して開くことができます。  
+  
+ [!code-csharp[IntroToNavNavigationWindowSnippets#CreateNWDialogBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/CSharp/DialogOwnerWindow.xaml.cs#createnwdialogbox)]
+ [!code-vb[IntroToNavNavigationWindowSnippets#CreateNWDialogBox](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/IntroToNavNavigationWindowSnippets/VisualBasic/DialogOwnerWindow.xaml.vb#createnwdialogbox)]  
+  
+ 結果を次の図に示します。  
+  
+ ![ダイアログ ボックス](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure19.png "NavigationOverviewFigure19")  
+  
+ この図では、<xref:System.Windows.Navigation.NavigationWindow> に [!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] スタイルの **\[戻る\]** ボタンと **\[進む\]** ボタンが表示され、ユーザーは履歴をナビゲートできます。  これらのボタンの操作感は、次の図と同じ操作感になります。  
+  
+ ![NavigationWindow 内の &#91;戻る&#93; ボタンと &#91;次に進む&#93; ボタン](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure20.png "NavigationOverviewFigure20")  
+  
+ 独自の履歴ナビゲーション サポートと UI をページに含める場合、<xref:System.Windows.Navigation.NavigationWindow.ShowsNavigationUI%2A> プロパティの値を `false` に設定すると、<xref:System.Windows.Navigation.NavigationWindow> によって表示される **\[戻る\]** ボタンと **\[進む\]** ボタンは非表示になります。  
+  
+ 代わりに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のカスタマイズ サポートを使用して、<xref:System.Windows.Navigation.NavigationWindow> 自体の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を置き換えることもできます。  
+  
+<a name="Frame_in_Standalone_Applications"></a>   
+## Frame クラス  
+ ブラウザーと <xref:System.Windows.Navigation.NavigationWindow> はどちらも、ナビゲート可能なコンテンツをホストするウィンドウです。  場合によっては、ウィンドウ全体にホストする必要がないコンテンツがアプリケーションに存在することもあります。  このようなコンテンツは、代わりに他のコンテンツの内部にホストします。  <xref:System.Windows.Controls.Frame> クラスを使用すると、ナビゲート可能なコンテンツを他のコンテンツに挿入できます。  <xref:System.Windows.Controls.Frame> は、<xref:System.Windows.Navigation.NavigationWindow> および [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] と同じサポートを提供します。  
+  
+ `Frame` 要素を使用して、<xref:System.Windows.Controls.Frame> を <xref:System.Windows.Controls.Page> に宣言によって追加する方法を次のコード例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#FrameHostPageXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPage.xaml#framehostpagexaml1)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPage.xaml#framehostpagexaml2)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPage.xaml#framehostpagexaml3)]  
+  
+ このマークアップでは、<xref:System.Windows.Controls.Frame> が最初にナビゲートする必要がある <xref:System.Windows.Controls.Page> のパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用して、`Frame` 要素の `Source` 属性を設定します。  次の図に、複数のページ間でナビゲートする <xref:System.Windows.Controls.Frame> を持つ <xref:System.Windows.Controls.Page> が存在する [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] を示します。  
+  
+ ![複数のページ間を移動したフレーム](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure5.png "NavigationOverviewFigure5")  
+  
+ <xref:System.Windows.Controls.Page> のコンテンツの内部にある <xref:System.Windows.Controls.Frame> のみを使用する必要はありません。  <xref:System.Windows.Window> のコンテンツの内部で <xref:System.Windows.Controls.Frame> をホストするのも一般的です。  
+  
+ 既定では、<xref:System.Windows.Controls.Frame> は別の履歴がない場合に独自の履歴のみを使用します。  <xref:System.Windows.Controls.Frame> が、<xref:System.Windows.Navigation.NavigationWindow> または [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] のどちらかの内部にホストされたコンテンツの一部である場合、<xref:System.Windows.Controls.Frame> は <xref:System.Windows.Navigation.NavigationWindow> または [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] に属する履歴を使用します。ただし、場合によっては <xref:System.Windows.Controls.Frame> が独自の履歴を使用する必要があります。  これは、<xref:System.Windows.Controls.Frame> によってホストされるページ内での履歴ナビゲーションを可能にするためです。  これを次の図に示します。  
+  
+ ![フレームとページのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure7.png "NavigationOverviewFigure7")  
+  
+ この場合、<xref:System.Windows.Controls.Frame> の <xref:System.Windows.Controls.Frame.JournalOwnership%2A> プロパティを <xref:System.Windows.Navigation.JournalOwnership> に設定することによって、<xref:System.Windows.Controls.Frame> が独自の履歴を使用するように構成できます。  これを次のマークアップに示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#FrameHostPageOwnJournalXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnJournal.xaml#framehostpageownjournalxaml1)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageOwnJournalXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnJournal.xaml#framehostpageownjournalxaml2)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageOwnJournalXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnJournal.xaml#framehostpageownjournalxaml3)]  
+  
+ 独自の履歴を使用する <xref:System.Windows.Controls.Frame> 内でのナビゲートの結果を次の図に示します。  
+  
+ ![独自の履歴を使用するフレーム](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure8.png "NavigationOverviewFigure8")  
+  
+ 履歴エントリは、[!INCLUDE[TLA2#tla_ie](../../../../includes/tla2sharptla-ie-md.md)] ではなく、<xref:System.Windows.Controls.Frame> 内のナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] によって表示される点に注意してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.Frame> が、<xref:System.Windows.Window> にホストされているコンテンツの一部である場合、<xref:System.Windows.Controls.Frame> は独自の履歴を使用するため、専用のナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を表示します。  
+  
+ <xref:System.Windows.Controls.Frame> にナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を表示せずに独自の履歴を表示することがユーザー エクスペリエンスで必要とされる場合、<xref:System.Windows.Controls.Frame.NavigationUIVisibility%2A> を <xref:System.Windows.Visibility> に設定して、ナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を非表示にできます。  これを次のマークアップに示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#FrameHostPageHidesUIXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnHiddenJournal.xaml#framehostpagehidesuixaml1)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageHidesUIXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnHiddenJournal.xaml#framehostpagehidesuixaml2)]  
+[!code-xml[NavigationOverviewSnippets#FrameHostPageHidesUIXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHostPageOwnHiddenJournal.xaml#framehostpagehidesuixaml3)]  
+  
+<a name="Navigation_Hosts"></a>   
+## ナビゲーション ホスト  
+ <xref:System.Windows.Controls.Frame> と <xref:System.Windows.Navigation.NavigationWindow> は、ナビゲーション ホストと呼ばれるクラスです。  *ナビゲーション ホスト*は、コンテンツにナビゲートして表示することができるクラスです。  これを実現するため、各ナビゲーション ホストは独自の <xref:System.Windows.Navigation.NavigationService> および履歴を使用します。  ナビゲーション ホストの基本的な構造を次の図に示します。  
+  
+ ![ナビゲーターのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure15.png "NavigationOverviewFigure15")  
+  
+ これによって、<xref:System.Windows.Navigation.NavigationWindow> および <xref:System.Windows.Controls.Frame> は、実質的に [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] がブラウザーにホストされているときに提供するのと同じナビゲーション サポートを提供できます。  
+  
+ <xref:System.Windows.Navigation.NavigationService> および履歴を使用することだけでなく、ナビゲーション ホストは <xref:System.Windows.Navigation.NavigationService> が実装するのと同じメンバーを実装します。  これを次の図に示します。  
+  
+ ![フレームおよび NavigationWindow 内の履歴](../../../../docs/framework/wpf/app-development/media/naivgationoverviewfigure24.png "NaivgationOverviewFigure24")  
+  
+ アプリケーションでは、これらのメンバーを直接使用してナビゲーション サポートをプログラミングできます。  <xref:System.Windows.Window> 内でホストされる <xref:System.Windows.Controls.Frame> のカスタム ナビゲーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を独自に作成する場合に、この方法を検討してみてください。さらに、どちらのクラスも、この他に `BackStack` \(<xref:System.Windows.Navigation.NavigationWindow.BackStack%2A?displayProperty=fullName>, <xref:System.Windows.Controls.Frame.BackStack%2A?displayProperty=fullName>\) や `ForwardStack` \(<xref:System.Windows.Navigation.NavigationWindow.ForwardStack%2A?displayProperty=fullName>、<xref:System.Windows.Controls.Frame.ForwardStack%2A?displayProperty=fullName>\) などのナビゲーション関連のメンバーを実装します。これらのメンバーを使用すると、それぞれ "戻る" および "進む" の履歴エントリを列挙できます。  
+  
+ 前に述べたように、アプリケーション内に複数の履歴が存在することがあります。  この例を次の図に示します。  
+  
+ ![1 つのアプリケーション内の複数の履歴](../../../../docs/framework/wpf/app-development/media/naivgationoverviewfigure25.png "NaivgationOverviewFigure25")  
+  
+<a name="Navigating_to_Content_Other_than_Pages"></a>   
+## XAML ページ以外のコンテンツへのナビゲート  
+ このトピック全体で、<xref:System.Windows.Controls.Page> とパッケージ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] を使用して、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のさまざまなナビゲーション機能について説明してきました。  しかし、アプリケーションにコンパイルされる <xref:System.Windows.Controls.Page> はナビゲート可能なコンテンツの唯一のタイプではなく、パッケージ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] はコンテンツを識別する唯一の方法ではありません。  
+  
+ ここで示すように、Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル、[!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ファイル、およびオブジェクトにもナビゲートできます。  
+  
+<a name="Navigating_to_Loose_XAML_Files"></a>   
+### Loose XAML ファイルへのナビゲート  
+ Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは、次の特性を持つファイルです。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] のみが含まれている \(つまり、コードがない\)。  
+  
+-   適切な名前空間宣言がある。  
+  
+-   .xaml ファイル名拡張子がある。  
+  
+ たとえば、Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル Person.xaml として格納されている次のコンテンツについて考えます。  
+  
+ [!code-xml[NavigationOverviewSnippets#LooseXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/Person.xaml#loosexaml)]  
+  
+ ファイルをダブルクリックすると、ブラウザーが開き、コンテンツにナビゲートしてコンテンツが表示されます。  これを次の図に示します。  
+  
+ ![Person.XAML ファイルの内容の表示](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure21.png "NavigationOverviewFigure21")  
+  
+ Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは次の場所から表示できます。  
+  
+-   ローカル コンピューター、イントラネット、またはインターネットの Web サイト。  
+  
+-   [!INCLUDE[TLA#tla_unc](../../../../includes/tlasharptla-unc-md.md)] ファイル共有。  
+  
+-   ローカル ディスク。  
+  
+ Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは、ブラウザーのお気に入りに追加したり、ブラウザーのホーム ページとして設定したりできます。  
+  
+> [!NOTE]
+>  Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページの公開および起動の詳細については、「[WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)」を参照してください。  
+  
+ Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] に関する 1 つの制限は、部分信頼で安全に実行されるコンテンツしかホストできないという点です。  たとえば、`Window` を Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルのルート要素とすることはできません。  詳細については、「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+<a name="Navigating_to_HTML_Files_Using_Frame"></a>   
+### フレームを使用した HTML ファイルへのナビゲート  
+ 予想されるとおり、[!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] にもナビゲートできます。  http スキームを使用する [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を入力するだけです。  たとえば、次の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] には、[!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ページにナビゲートする <xref:System.Windows.Controls.Frame> が表示されます。  
+  
+ [!code-xml[NavigationOverviewSnippets#FrameHtmlNavMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/FrameHTMLNavPage.xaml#framehtmlnavmarkup)]  
+  
+ [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] にナビゲートするには、特殊なアクセス許可が必要です。  たとえば、インターネット ゾーンの部分信頼セキュリティ サンドボックスで実行されている [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] からはナビゲートできません。詳細については、「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+<a name="Navigating_to_HTML_Files_Using_WebBrowser"></a>   
+### WebBrowser コントロールを使用した HTML ファイルへのナビゲート  
+ <xref:System.Windows.Controls.WebBrowser> コントロールでは、[!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ドキュメント ホスティング、ナビゲーション、およびスクリプト\/マネージ コードの相互運用性がサポートされます。  <xref:System.Windows.Controls.WebBrowser> コントロールの詳細については、「<xref:System.Windows.Controls.WebBrowser>」を参照してください。  
+  
+ <xref:System.Windows.Controls.Frame> と同様に、<xref:System.Windows.Controls.WebBrowser> を使用して [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] にナビゲートするには、特殊なアクセス許可が必要です。  たとえば、部分信頼アプリケーションからは、起点にある [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] にのみナビゲートできます。  詳細については、「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+<a name="Navigating_to_Objects"></a>   
+### カスタム オブジェクトへのナビゲート  
+ カスタム オブジェクトとして格納されたデータがある場合、そのデータを表示する 1 つの方法は、それらのオブジェクトにバインドされたコンテンツを使用して <xref:System.Windows.Controls.Page> を作成することです \(「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照\)。  オブジェクトを表示するためだけにページ全体を作成するオーバーヘッドが必要ない場合、代わりにオブジェクトに直接ナビゲートすることもできます。  
+  
+ 次のコードに実装された `Person` クラスについて考えます。  
+  
+ [!code-csharp[NavigateToObjectSnippets#PersonClassCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/Person.cs#personclasscode)]
+ [!code-vb[NavigateToObjectSnippets#PersonClassCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigateToObjectSnippets/VisualBasic/Person.vb#personclasscode)]  
+  
+ このクラスにナビゲートするには、次のコードに示すように、<xref:System.Windows.Navigation.NavigationWindow.Navigate%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+ [!code-xml[NavigateToObjectSnippets#PageThatNavsToObject1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/HomePage.xaml#pagethatnavstoobject1)]  
+[!code-xml[NavigateToObjectSnippets#PageThatNavsToObject2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/HomePage.xaml#pagethatnavstoobject2)]  
+[!code-xml[NavigateToObjectSnippets#PageThatNavsToObject3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/HomePage.xaml#pagethatnavstoobject3)]  
+  
+ [!code-csharp[NavigateToObjectSnippets#PageThatNavsToObjectCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/HomePage.xaml.cs#pagethatnavstoobjectcodebehind)]
+ [!code-vb[NavigateToObjectSnippets#PageThatNavsToObjectCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/NavigateToObjectSnippets/VisualBasic/HomePage.xaml.vb#pagethatnavstoobjectcodebehind)]  
+  
+ 結果を次の図に示します。  
+  
+ ![クラスに移動するページ](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure22.png "NavigationOverviewFigure22")  
+  
+ この図では、役に立つものが何も表示されていません。  実際に、表示される値は Person オブジェクトの `ToString` メソッドの戻り値です。既定では、これは [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] がオブジェクトの表示に使用できる唯一の値です。  `ToString` メソッドをオーバーライドすると、より意味のある情報を返すことができますが、それでも文字列値でしかありません。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の表示機能を活用する 1 つの方法として、データ テンプレートを使用できます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が特定の種類のオブジェクトと関連付けることができる、データ テンプレートを実装できます。  `Person` オブジェクトのデータ テンプレートを次のコードに示します。  
+  
+ [!code-xml[NavigateToObjectSnippets#DataTemplateMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigateToObjectSnippets/CSharp/App.xaml#datatemplatemarkup)]  
+  
+ ここでは、`DataType` 属性で `x:Type` マークアップ拡張機能を使用することによって、データ テンプレートが `Person` 型と関連付けられます。  次に、データ テンプレートは `TextBlock` 要素 \(<xref:System.Windows.Controls.TextBlock> を参照\) を `Person` クラスのプロパティにバインドします。  `Person` オブジェクトの更新された外観を次の図に示します。  
+  
+ ![データ テンプレートを持つクラスへの移動](../../../../docs/framework/wpf/app-development/media/navigationoverviewfigure23.png "NavigationOverviewFigure23")  
+  
+ この方法の利点は、データ テンプレートを再使用して、アプリケーションの任意の場所でオブジェクトを一貫して表示できるようにすることによって得られる一貫性です。  
+  
+ データ テンプレートの詳細については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)」を参照してください。  
+  
+<a name="Security"></a>   
+## セキュリティ  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ナビゲーション サポートによって、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] をインターネット全体にナビゲートし、アプリケーションにサード パーティのコンテンツをホストすることが可能になります。  アプリケーションとユーザーの両方を有害な動作から保護するため、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] はさまざまなセキュリティ機能を提供します。これらの機能の詳細については、「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」と「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Application.SetCookie%2A>   
+ <xref:System.Windows.Application.GetCookie%2A>   
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)   
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)   
+ [構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)   
+ [ナビゲーション トポロジの概要](../../../../docs/framework/wpf/app-development/navigation-topologies-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/app-development/navigation-how-to-topics.md)   
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/navigation-topologies-overview.md b/docs/framework/wpf/app-development/navigation-topologies-overview.md
new file mode 100644
index 00000000000..b1fca7d9e6f
--- /dev/null
+++ b/docs/framework/wpf/app-development/navigation-topologies-overview.md
@@ -0,0 +1,154 @@
+---
+title: "ナビゲーション トポロジの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "動的生成トポロジ"
+  - "固定階層トポロジ"
+  - "固定線形トポロジ"
+  - "線形トポロジ"
+  - "ナビゲーション トポロジ [WPF]"
+  - "トポロジ [WPF]"
+ms.assetid: 5d5ee837-629a-4933-869a-186dc22ac43d
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ナビゲーション トポロジの概要
+<a name="introduction"></a> この概要では、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のナビゲーション トポロジについて紹介します。  3 つのナビゲーション トポロジをサンプルと共に説明します。  
+  
+> [!NOTE]
+>  このトピックを読む前に、ページ関数を使用した [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の構造化ナビゲーションの概念を理解している必要があります。  これらのトピックに関する詳細については、「[構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)」を参照してください。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [ナビゲーション トポロジ](#Navigation_Topologies)  
+  
+-   [構造化ナビゲーション トポロジ](#Structured_Navigation_Topologies)  
+  
+-   [固定線形トポロジを介したナビゲーション](#Navigation_over_a_Fixed_Linear_Topology)  
+  
+-   [固定階層トポロジを介した動的ナビゲーション](#Dynamic_Navigation_over_a_Fixed_Hierarchical_Topology)  
+  
+-   [動的に生成されたトポロジを介したナビゲーション](#Navigation_over_a_Dynamically_Generated_Topology)  
+  
+<a name="Navigation_Topologies"></a>   
+## ナビゲーション トポロジ  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] において、ナビゲーションは通常、クリックされると他のページに移動するハイパーリンク \(<xref:System.Windows.Documents.Hyperlink>\) を持つページ \(<xref:System.Windows.Controls.Page>\) で構成されます。  移動先となるページは [!INCLUDE[TLA#tla_uri#plural](../../../../includes/tlasharptla-urisharpplural-md.md)] で識別されます \(「[WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)」を参照してください\)。  ページ、ハイパーリンク、および [!INCLUDE[TLA#tla_uri#plural](../../../../includes/tlasharptla-urisharpplural-md.md)] を表示する次の簡単な例について考えます。  
+  
+ [!code-xml[NavigationTopologiesOverviewSnippets#Page1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationTopologiesOverviewSnippets/CS/Page1.xaml#page1)]  
+  
+ [!code-xml[NavigationTopologiesOverviewSnippets#Page2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationTopologiesOverviewSnippets/CS/Page2.xaml#page2)]  
+  
+ これらのページは 1 つの*ナビゲーション トポロジ*に配置され、その構造はページ間をどう移動できるかによって決まります。  このナビゲーション トポロジはシンプルなシナリオに適していますが、ナビゲーションにもっと複雑なトポロジが必要になる場合もあり、アプリケーションの実行中にしか定義できないものもあります。  
+  
+ このトピックでは、それぞれ*固定線形*、*固定階層*、*動的生成*と呼ばれる 3 つの一般的なナビゲーション トポロジについて説明します。  各ナビゲーション トポロジは、次の図に示すような [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を持つサンプルで示されます。  
+  
+ ![データ項目を含むタスク ページ](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure6.png "NavigationTopologyFigure6")  
+  
+<a name="Structured_Navigation_Topologies"></a>   
+## 構造化ナビゲーション トポロジ  
+ ナビゲーション トポロジには、大きく分けて次の 2 種類があります。  
+  
+-   **固定トポロジ** : コンパイル時に定義され、実行時には変更されません。  固定トポロジは、シーケンスが固定されたページを線形的または階層的にナビゲートする場合に役立ちます。  
+  
+-   **動的トポロジ** : ユーザー、アプリケーション、またはシステムから収集された入力に基づいて実行時に定義されます。  動的トポロジは、ページがさまざまなシーケンスでナビゲートされる可能性がある場合に便利です。  
+  
+ ナビゲーション トポロジの作成にはページを使用することもできますが、このサンプルではページ関数を使用しています。その理由は、ページ関数に用意されている追加サポートによって、トポロジのページ間でデータをやり取りする機能のサポートを簡略化できるためです。  
+  
+<a name="Navigation_over_a_Fixed_Linear_Topology"></a>   
+## 固定線形トポロジを介したナビゲーション  
+ 固定線形トポロジは、シーケンスが固定されている 1 つ以上のウィザード ページの構造に似ています。  次の図は、固定線形トポロジを持つウィザードの高レベルの構造およびフローを示しています。  
+  
+ ![ナビゲーション トポロジのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure1.png "NavigationTopologyFigure1")  
+  
+ 固定線形トポロジを使用するナビゲーションの一般的な動作は次のようになります。  
+  
+-   呼び出し元ページから起動ページに移動します。起動ページでは、ウィザードを初期化し、最初のウィザード ページに移動します。  呼び出し元ページからウィザードの最初のページを直接呼び出すこともできるため、起動ページ \([!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のない <xref:System.Windows.Navigation.PageFunction%601>\) は必須ではありません。  ただし、起動ページを使用すると、ウィザードの初期化プロセスを簡略化でき、特に初期化が複雑な場合に便利です。  
+  
+-   ユーザーは、"戻る" ボタンと "進む" ボタン \(またはハイパーリンク\) を使用してページ間を移動できます。  
+  
+-   ユーザーは、履歴を使用してページ間を移動できます。  
+  
+-   ユーザーは、任意のウィザード ページで \[キャンセル\] ボタンをクリックしてウィザードをキャンセルできます。  
+  
+-   ユーザーは、最後のウィザード ページで \[完了\] ボタンをクリックしてウィザードを受け入れることができます。  
+  
+-   キャンセルされた場合、ウィザードは適切な結果を返し、データは返しません。  
+  
+-   ユーザーがウィザードを受け入れた場合、ウィザードは適切な結果と収集したデータを返します。  
+  
+-   ウィザードが完了すると \(受け入れられた場合もキャンセルされた場合も含めて\)、ウィザードを構成するページは履歴から削除されます。  これにより、ウィザードの各インスタンスが分離され、異常なデータや状態の発生を防ぎます。  
+  
+<a name="Dynamic_Navigation_over_a_Fixed_Hierarchical_Topology"></a>   
+## 固定階層トポロジを介した動的ナビゲーション  
+ アプリケーションによっては、次の例に示すように、ページから複数のページに移動できる場合があります。  
+  
+ ![複数のページに移動できるページ](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure2.png "NavigationTopologyFigure2")  
+  
+ この構造は固定階層トポロジと呼ばれ、通常、階層内を移動するシーケンスは、アプリケーションまたはユーザーによって実行時に決定されます。  複数の他のページに移動できる階層内の各ページでは、実行時に、移動先ページを決定するために必要なデータが収集されます。  次の図は、前の図に基づくいくつかの可能なナビゲーション シーケンスを示しています。  
+  
+ ![ナビゲーション トポロジのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure3.png "NavigationTopologyFigure3")  
+  
+ 固定階層構造内のページのシーケンスは実行時に決定されますが、ユーザー エクスペリエンスは固定線形トポロジの場合と同じです。  
+  
+-   呼び出し元ページから起動ページに移動します。起動ページでは、ウィザードを初期化し、最初のウィザード ページに移動します。  呼び出し元ページからウィザードの最初のページを直接呼び出すこともできるため、起動ページ \([!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のない <xref:System.Windows.Navigation.PageFunction%601>\) は必須ではありません。  ただし、起動ページを使用すると、ウィザードの初期化プロセスを簡略化でき、特に初期化が複雑な場合に便利です。  
+  
+-   ユーザーは、"戻る" ボタンと "進む" ボタン \(またはハイパーリンク\) を使用してページ間を移動できます。  
+  
+-   ユーザーは、履歴を使用してページ間を移動できます。  
+  
+-   ユーザーは、履歴をたどって戻ることで、ナビゲーション シーケンスを変更できます。  
+  
+-   ユーザーは、任意のウィザード ページで \[キャンセル\] ボタンをクリックしてウィザードをキャンセルできます。  
+  
+-   ユーザーは、最後のウィザード ページで \[完了\] ボタンをクリックしてウィザードを受け入れることができます。  
+  
+-   キャンセルされた場合、ウィザードは適切な結果を返し、データは返しません。  
+  
+-   ユーザーがウィザードを受け入れた場合、ウィザードは適切な結果と収集したデータを返します。  
+  
+-   ウィザードが完了すると \(受け入れられた場合もキャンセルされた場合も含めて\)、ウィザードを構成するページは履歴から削除されます。  これにより、ウィザードの各インスタンスが分離され、異常なデータや状態の発生を防ぎます。  
+  
+<a name="Navigation_over_a_Dynamically_Generated_Topology"></a>   
+## 動的に生成されたトポロジを介したナビゲーション  
+ アプリケーションによっては、複数のページ間を移動するシーケンスの決定にユーザー、アプリケーション、または外部データが必要となり、実行時にしか決定できない場合があります。  次の図は、基本となるナビゲーション シーケンスを持つページの集合を示しています。  
+  
+ ![ナビゲーション トポロジのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure4.png "NavigationTopologyFigure4")  
+  
+ 次の図は、ユーザーによって実行時に選択されたナビゲーション シーケンスを示しています。  
+  
+ ![ナビゲーションのダイアグラム](../../../../docs/framework/wpf/app-development/media/navigationtopologyfigure5.png "NavigationTopologyFigure5")  
+  
+ このナビゲーション シーケンスは、動的生成トポロジと呼ばれます。  ユーザーにとっては、他のナビゲーション トポロジと同様に、ユーザー エクスペリエンスは前述のトポロジと同じになります。  
+  
+-   呼び出し元ページから起動ページに移動します。起動ページでは、ウィザードを初期化し、最初のウィザード ページに移動します。  呼び出し元ページからウィザードの最初のページを直接呼び出すこともできるため、起動ページ \([!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のない <xref:System.Windows.Navigation.PageFunction%601>\) は必須ではありません。  ただし、起動ページを使用すると、ウィザードの初期化プロセスを簡略化でき、特に初期化が複雑な場合に便利です。  
+  
+-   ユーザーは、"戻る" ボタンと "進む" ボタン \(またはハイパーリンク\) を使用してページ間を移動できます。  
+  
+-   ユーザーは、履歴を使用してページ間を移動できます。  
+  
+-   ユーザーは、任意のウィザード ページで \[キャンセル\] ボタンをクリックしてウィザードをキャンセルできます。  
+  
+-   ユーザーは、最後のウィザード ページで \[完了\] ボタンをクリックしてウィザードを受け入れることができます。  
+  
+-   キャンセルされた場合、ウィザードは適切な結果を返し、データは返しません。  
+  
+-   ユーザーがウィザードを受け入れた場合、ウィザードは適切な結果と収集したデータを返します。  
+  
+-   ウィザードが完了すると \(受け入れられた場合もキャンセルされた場合も含めて\)、ウィザードを構成するページは履歴から削除されます。  これにより、ウィザードの各インスタンスが分離され、異常なデータや状態の発生を防ぎます。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Page>   
+ <xref:System.Windows.Navigation.PageFunction%601>   
+ <xref:System.Windows.Navigation.NavigationService>   
+ [構造化ナビゲーションの概要](../../../../docs/framework/wpf/app-development/structured-navigation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/pack-uris-in-wpf.md b/docs/framework/wpf/app-development/pack-uris-in-wpf.md
new file mode 100644
index 00000000000..b0b1d1906d2
--- /dev/null
+++ b/docs/framework/wpf/app-development/pack-uris-in-wpf.md
@@ -0,0 +1,434 @@
+---
+title: "WPF におけるパッケージの URI | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション管理 [WPF]"
+  - "読み込み (埋め込みリソースを)"
+  - "読み込み (非リソース ファイルを)"
+  - "パック URI スキーム"
+  - "Uniform Resource Identifier (URI)"
+  - "URI (Uniform Resource Identifier)"
+ms.assetid: 43adb517-21a7-4df3-98e8-09e9cdf764c4
+caps.latest.revision: 35
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# WPF におけるパッケージの URI
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] において、[!INCLUDE[TLA#tla_uri#plural](../../../../includes/tlasharptla-urisharpplural-md.md)] は次のようなさまざまな用途でファイルを指定し、読み込むために使用されます。  
+  
+-   アプリケーションの起動時に表示する [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の指定。  
+  
+-   イメージの読み込み。  
+  
+-   ページへの移動。  
+  
+-   実行可能ファイルではないデータ ファイルの読み込み。  
+  
+ また、[!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して、次に示すようなさまざまな場所にあるファイルを指定し、読み込むことができます。  
+  
+-   現在のアセンブリ。  
+  
+-   参照アセンブリ。  
+  
+-   アセンブリを基準とした場所。  
+  
+-   アプリケーションの起点サイト。  
+  
+ こうした場所にある各種ファイルを指定して読み込むため、一貫性のある仕組みの提供を目的として、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では*パッケージの URI スキーム*を採用しています。  このトピックでは、このスキームの概要、さまざまなシナリオでのパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] の作成方法、絶対および相対 [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] と [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の解決について説明した後、マークアップやコードでパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用する方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="The_Pack_URI_Scheme"></a>   
+## パッケージの URI スキーム  
+ パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] スキームは、[Open Packaging Conventions](http://go.microsoft.com/fwlink/?LinkID=71255) \(OPC\) 仕様で使用されています。この仕様は、コンテンツの編成および特定について規定します。  このモデルの主な要素はパッケージとパーツです。*パッケージ*は、1 つ以上の論理*パーツ*の論理コンテナーです。  この概念を次の図に示します。  
+  
+ ![パッケージとパーツのダイアグラム](../../../../docs/framework/wpf/app-development/media/wpfpackurischemefigure1.png "WPFPackURISchemeFigure1")  
+  
+ パーツの識別を目的として、OPC 仕様では、パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] スキームを定義するために、RFC 2396 \(Uniform Resource Identifiers \(URI\): Generic Syntax\) の拡張機能を利用しています。  
+  
+ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] で指定されるスキームは、そのプレフィックスで定義されます。http、ftp、file などがよく知られています。  パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] スキームは、スキームとして pack を使用し、証明機関とパスの 2 つのコンポーネントが含まれます。  パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の書式は次のとおりです。  
+  
+ pack:\/\/*authority*\/*path*  
+  
+ *authority* は、パーツが格納されているパッケージの種類を指定し、*path* は、パッケージ内のパーツの場所を指定します。  
+  
+ この概念を次の図に示します。  
+  
+ ![パッケージ、権限、およびパスの間のリレーションシップ](../../../../docs/framework/wpf/app-development/media/wpfpackurischemefigure2.png "WPFPackURISchemeFigure2")  
+  
+ パッケージとパーツは、アプリケーションとアプリケーション データ ファイルに似ています。つまり、アプリケーション \(パッケージ\) には、次のような 1 つ以上のファイル \(パーツ\) を含めることができます。  
+  
+-   ローカル アセンブリにコンパイルされるリソース ファイル。  
+  
+-   参照アセンブリにコンパイルされるリソース ファイル。  
+  
+-   参照元のアセンブリにコンパイルされるリソース ファイル。  
+  
+-   コンテンツ ファイル。  
+  
+-   起点サイト ファイル。  
+  
+ これらのファイルにアクセスするために、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、application:\/\/\/ と siteoforigin:\/\/\/ という 2 つの証明機関をサポートします。  application:\/\/\/ 証明機関は、リソース ファイルやコンテンツ ファイルなど、コンパイル時に既知のアプリケーション データ ファイルを示すために使用されます。  siteoforigin:\/\/\/ 証明機関は、起点サイト ファイルの指定に使用されます。  各証明機関のスコープを、次の図に示します。  
+  
+ ![Pack URI のダイアグラム](../../../../docs/framework/wpf/app-development/media/wpfpackurischemefigure4.png "WPFPackURISchemeFigure4")  
+  
+> [!NOTE]
+>  パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の証明機関コンポーネントは、パッケージを指す埋め込みの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] で、RFC 2396 に準拠する必要があります。  また、"\/" 文字は "," 文字に置き換え、"%" や "?" などの予約文字はエスケープする必要があります。  詳細については、OPC を参照してください。  
+  
+ 以下のセクションでは、2 つの証明機関と、リソース ファイル、コンテンツ ファイル、および起点サイト ファイルの適切なパスとを組み合わせて使用して、パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を構築する方法について説明します。  
+  
+<a name="Resource_File_Pack_URIs___Local_Assembly"></a>   
+## リソース ファイル パッケージの URI  
+ リソース ファイルは [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `Resource` 項目として構成され、コンパイルされてアセンブリに変換されます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、ローカル アセンブリに変換されたリソース ファイルの指定やローカル アセンブリから参照されるアセンブリに変換されたリソース ファイルの指定に使用できるパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] の構築をサポートしています。  
+  
+<a name="Local_Assembly_Resource_File"></a>   
+### ローカル アセンブリ リソース ファイル  
+ ローカル アセンブリにコンパイルされるリソース ファイルのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、次の証明機関とパスを使用します。  
+  
+-   **証明機関** : application:\/\/\/。  
+  
+-   **パス** : ローカル アセンブリ プロジェクト フォルダーのルートを基準とするパスを含む、リソース ファイルの名前。  
+  
+ ローカル アセンブリのプロジェクト フォルダーのルートにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/ResourceFile.xaml`  
+  
+ ローカル アセンブリのプロジェクト フォルダーのサブフォルダーにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/Subfolder/ResourceFile.xaml`  
+  
+<a name="Resource_File_Pack_URIs___Referenced_Assembly"></a>   
+### 参照アセンブリ リソース ファイル  
+ 参照アセンブリにコンパイルされるリソース ファイルのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、次の証明機関とパスを使用します。  
+  
+-   **証明機関** : application:\/\/\/。  
+  
+-   **パス** : コンパイルされて参照アセンブリに変換されるリソース ファイルの名前。  パスは、次の書式に従う必要があります。  
+  
+     *AssemblyShortName*\[*;Version*\]\[*;PublicKey*\];component\/*Path*  
+  
+    -   **AssemblyShortName** : 参照アセンブリの短い名前。  
+  
+    -   **;Version** \(省略可能\): リソース ファイルを含む参照アセンブリのバージョン。  これは、同じ短い名前を持つ 2 つ以上の参照アセンブリを読み込む場合に使用されます。  
+  
+    -   **;PublicKey** \(省略可能\): 参照アセンブリの署名に使用された公開キー。  これは、同じ短い名前を持つ 2 つ以上の参照アセンブリを読み込む場合に使用されます。  
+  
+    -   **;component**: 参照アセンブリがローカル アセンブリから参照されることを指定します。  
+  
+    -   **\/Path**: 参照アセンブリのプロジェクト フォルダーのルートを基準とするパスを含む、リソース ファイルの名前。  
+  
+ 参照アセンブリのプロジェクト フォルダーのルートにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/ReferencedAssembly;component/ResourceFile.xaml`  
+  
+ 参照アセンブリのプロジェクト フォルダーのサブフォルダーにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/ReferencedAssembly;component/Subfolder/ResourceFile.xaml`  
+  
+ バージョン固有の参照アセンブリのプロジェクト フォルダーのルート フォルダーにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/ReferencedAssembly;v1.0.0.1;component/ResourceFile.xaml`  
+  
+ 参照アセンブリ リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] 構文は、application:\/\/\/ 証明機関と組み合わせる場合のみ使用できます。  たとえば、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では次はサポートされません。  
+  
+ `pack://siteoforigin:,,,/SomeAssembly;component/ResourceFile.xaml`  
+  
+<a name="Content_File_Pack_URIs"></a>   
+## コンテンツ ファイルのパッケージの URI  
+ コンテンツ ファイルのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、次の証明機関とパスを使用します。  
+  
+-   **証明機関** : application:\/\/\/。  
+  
+-   **パス** : アプリケーションのメインの実行可能アセンブリのファイル システムの場所を基準とするパスを含む、コンテンツ ファイルの名前。  
+  
+ 実行可能アセンブリと同じフォルダーにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] コンテンツ ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/ContentFile.xaml`  
+  
+ アプリケーションの実行可能アセンブリを基準とするサブフォルダーにある [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] コンテンツ ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://application:,,,/Subfolder/ContentFile.xaml`  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] コンテンツ ファイルは、移動先にはできません。  [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] スキームは、起点サイトにある [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ファイルへの移動のみをサポートします。  
+  
+<a name="The_siteoforigin_____Authority"></a>   
+## 起点サイトのパッケージの URI  
+ 起点サイト ファイルのパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、次の証明機関とパスを使用します。  
+  
+-   **証明機関** : siteoforigin:\/\/\/。  
+  
+-   **パス** : 実行可能アセンブリが起動される場所を基準とするパスを含む、起点サイト ファイルの名前。  
+  
+ 実行可能アセンブリが起動される場所に格納されている、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 起点サイト ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://siteoforigin:,,,/SiteOfOriginFile.xaml`  
+  
+ アプリケーションの実行可能アセンブリが起動される場所を基準とするサブフォルダーに格納されている、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 起点サイト ファイルのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の例を次に示します。  
+  
+ `pack://siteoforigin:,,,/Subfolder/SiteOfOriginFile.xaml`  
+  
+<a name="Page_Files"></a>   
+## パッケージ ファイル  
+ [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `Page` 項目として構成されている [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは、リソース ファイルと同じようにしてコンパイルされ、アセンブリに変換されます。  したがって、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `Page` 項目は、リソース ファイルのパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して指定できます。  
+  
+ 一般的に [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] `Page` 項目として構成される [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルの種類には、ルート要素として次のいずれかが含まれます。  
+  
+-   <xref:System.Windows.Window?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Controls.Page?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Navigation.PageFunction%601?displayProperty=fullName>  
+  
+-   <xref:System.Windows.ResourceDictionary?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Documents.FlowDocument?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Controls.UserControl?displayProperty=fullName>  
+  
+<a name="Absolute_vs_Relative_Pack_URIs"></a>   
+## 絶対パッケージの URI と相対パッケージの URI  
+ 完全修飾パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] にはスキーム、証明機関、パスが含まれ、絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] と見なされます。  開発者にとっての簡便さを考慮して、通常、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 要素では、パスだけを含む相対パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] で適切な属性を設定できます。  
+  
+ たとえば、ローカル アセンブリ内のリソース ファイルに対する次の絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を考えてみます。  
+  
+ `pack://application:,,,/ResourceFile.xaml`  
+  
+ このリソース ファイルを参照する相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、次のようになります。  
+  
+ `/ResourceFile.xaml`  
+  
+> [!NOTE]
+>  起点サイト ファイルはアセンブリに関連付けられていないため、絶対パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用した参照のみ可能です。  
+  
+ 既定では、相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、参照を含むマークアップまたはコードの位置を基準にしていると見なされます。  ただし、先頭にバックスラッシュを使用すると、相対パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] 参照はアプリケーションのルートに対して相対的であると見なされます。  たとえば、次のプロジェクト構造を考えます。  
+  
+ `App.xaml`  
+  
+ `Page2.xaml`  
+  
+ `\SubFolder`  
+  
+ `+ Page1.xaml`  
+  
+ `+ Page2.xaml`  
+  
+ Page1.xaml に *Root*\\SubFolder\\Page2.xaml を参照する [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が含まれている場合、参照で次の相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用できます。  
+  
+ `Page2.xaml`  
+  
+ Page1.xaml に *Root*\\Page2.xaml を参照する [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が含まれている場合、参照で次の相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用できます。  
+  
+ `/Page2.xaml`  
+  
+<a name="Pack_URI_Resolution"></a>   
+## パッケージの URI の解決  
+ パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] の形式は、さまざまな種類のファイルのパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] が同じに見えるようになっています。  たとえば、次の絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] について検討してみます。  
+  
+ `pack://application:,,,/ResourceOrContentFile.xaml`  
+  
+ この絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は、ローカル アセンブリ内のリソース ファイルまたはコンテンツ ファイルを参照できます。  同じことは、次の相対 [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] にも当てはまります。  
+  
+ `/ResourceOrContentFile.xaml`  
+  
+ パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が参照しているファイルの種類を特定するために、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、次のヒューリスティックを使用して、ローカル アセンブリ内のリソース ファイルとコンテンツ ファイルの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を解決します。  
+  
+1.  アセンブリ メタデータに、パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] に一致する <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 属性があるかどうかを調べます。  
+  
+2.  <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 属性が見つかった場合は、パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] のパスはコンテンツ ファイルを参照しています。  
+  
+3.  <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 属性が見つからない場合、コンパイルされてローカル アセンブリに変換された設定リソース ファイルを調べます。  
+  
+4.  パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] のパスに一致するリソース ファイルが見つかると、パッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] のパスはリソース ファイルを参照しています。  
+  
+5.  リソースが見つからない場合、内部で作成された <xref:System.Uri> は無効です。  
+  
+ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] 解決は、次を参照する [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] には適用されません。  
+  
+-   参照アセンブリ内のコンテンツ ファイル : この種類のファイルは [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でサポートされません。  
+  
+-   参照アセンブリに埋め込まれたファイル : これらを指定する [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] は、参照アセンブリの名前と `;component` サフィックスの両方が含まれているため、一意です。  
+  
+-   起点サイト ファイル : これらを指定する [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] は、siteoforigin:\/\/\/ 証明機関を含むパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] で指定できる唯一の種類のファイルあるため、一意です。  
+  
+ パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] 解決によってもたらされる 1 つの単純化は、コードがリソース ファイルやコンテンツ ファイルの場所に依存しなくなることです。  たとえば、コンテンツ ファイルに再構成されたリソース ファイルがローカル アセンブリにある場合、そのリソースのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] は変わらず、そのパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用するコードも変わりません。  
+  
+<a name="Programming_with_Pack_URIs"></a>   
+## パッケージの URI を使用したプログラミング  
+ 多くの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] クラスは、パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して設定できる次のようなプロパティを実装します。  
+  
+-   <xref:System.Windows.Application.StartupUri%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Controls.Frame.Source%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Navigation.NavigationWindow.Source%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Documents.Hyperlink.NavigateUri%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Window.Icon%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.Controls.Image.Source%2A?displayProperty=fullName>  
+  
+ これらのプロパティは、マークアップとコードのどちらからも設定できます。  ここでは、両方の構造と共通シナリオについて説明します。  
+  
+<a name="Using_Pack_URIs_in_Markup"></a>   
+### マークアップでのパッケージの URI の使用  
+ マークアップでパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を指定するには、パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用する属性の要素を設定します。  次に例を示します。  
+  
+ `<element attribute="pack://application:,,,/File.xaml" />`  
+  
+ 表 1 は、マークアップで指定できるさまざまな絶対パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を示しています。  
+  
+ 表 1 : マークアップでの絶対パッケージの URI  
+  
+|File|絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]|  
+|----------|---------------------------------------------------------------------------|  
+|リソース ファイル \- ローカル アセンブリ|`"pack://application:,,,/ResourceFile.xaml"`|  
+|サブフォルダー内のリソース ファイル \- ローカル アセンブリ|`"pack://application:,,,/Subfolder/ResourceFile.xaml"`|  
+|リソース ファイル \- 参照アセンブリ|`"pack://application:,,,/ReferencedAssembly;component/ResourceFile.xaml"`|  
+|参照アセンブリのサブフォルダー内のリソース ファイル|`"pack://application:,,,/ReferencedAssembly;component/Subfolder/ResourceFile.xaml"`|  
+|バージョン管理された参照アセンブリ内のリソース ファイル|`"pack://application:,,,/ReferencedAssembly;v1.0.0.0;component/ResourceFile.xaml"`|  
+|コンテンツ ファイル|`"pack://application:,,,/ContentFile.xaml"`|  
+|サブフォルダー内のコンテンツ ファイル|`"pack://application:,,,/Subfolder/ContentFile.xaml"`|  
+|起点サイト ファイル|`"pack://siteoforigin:,,,/SOOFile.xaml"`|  
+|サブフォルダー内の起点サイト ファイル|`"pack://siteoforigin:,,,/Subfolder/SOOFile.xaml"`|  
+  
+ 表 2 は、マークアップで指定できるさまざまな相対パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を示しています。  
+  
+ 表 2 : マークアップでの相対パッケージの URI  
+  
+|File|相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]|  
+|----------|---------------------------------------------------------------------------|  
+|ローカル アセンブリ内のリソース ファイル|`"/ResourceFile.xaml"`|  
+|ローカル アセンブリのサブフォルダー内のリソース ファイル|`"/Subfolder/ResourceFile.xaml"`|  
+|参照アセンブリ内のリソース ファイル|`"/ReferencedAssembly;component/ResourceFile.xaml"`|  
+|参照アセンブリのサブフォルダー内のリソース ファイル|`"/ReferencedAssembly;component/Subfolder/ResourceFile.xaml"`|  
+|コンテンツ ファイル|`"/ContentFile.xaml"`|  
+|サブフォルダー内のコンテンツ ファイル|`"/Subfolder/ContentFile.xaml"`|  
+  
+<a name="Using_Pack_URIs_in_Code"></a>   
+### コードでのパッケージの URI の使用  
+ コードでパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を指定するには、<xref:System.Uri> クラスをインスタンス化し、パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] をパラメーターとしてコンストラクターに渡します。  このコード例を次に示します。  
+  
+```csharp  
+Uri uri = new Uri("pack://application:,,,/File.xaml");  
+```  
+  
+ 既定では、<xref:System.Uri> クラスは、パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を絶対と見なします。  そのため、<xref:System.Uri> クラスのインスタンスが相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用して作成されると、例外が発生します。  
+  
+```csharp  
+Uri uri = new Uri("/File.xaml");  
+```  
+  
+ しかし、<xref:System.Uri> クラスのコンストラクターの <xref:System.Uri.%23ctor%28System.String%2CSystem.UriKind%29> オーバーロードは、<xref:System.UriKind> 型のパラメーターを受け取ります。これを使用すると、パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が絶対または相対のどちらであるかを指定できます。  
+  
+```csharp  
+// Absolute URI (default)  
+Uri absoluteUri = new Uri("pack://application:,,,/File.xaml", UriKind.Absolute);  
+// Relative URI  
+Uri relativeUri = new Uri("/File.xaml", UriKind.Relative);  
+```  
+  
+ 提供されたパッケージ [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] が <xref:System.UriKind> と <xref:System.UriKind> のどちらであるかわかっている場合は、それだけを指定します。  使用されているパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] の種類がわからない場合、たとえばユーザーがパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を実行時に入力する場合は、代わりに <xref:System.UriKind> を使用します。  
+  
+```csharp  
+// Relative or Absolute URI provided by user via a text box  
+TextBox userProvidedUriTextBox = new TextBox();  
+Uri uri = new Uri(userProvidedUriTextBox.Text, UriKind.RelativeOrAbsolute);  
+```  
+  
+ 表 3 は、<xref:System.Uri?displayProperty=fullName> を使用してコードで指定できるさまざまな絶対パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を示しています。  
+  
+ 表 3 : コードでの絶対パッケージの URI  
+  
+|File|絶対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]|  
+|----------|---------------------------------------------------------------------------|  
+|リソース ファイル \- ローカル アセンブリ|`Uri uri = new Uri("pack://application:,,,/ResourceFile.xaml", UriKind.Absolute);`|  
+|サブフォルダー内のリソース ファイル \- ローカル アセンブリ|`Uri uri = new Uri("pack://application:,,,/Subfolder/ResourceFile.xaml", UriKind.Absolute);`|  
+|リソース ファイル \- 参照アセンブリ|`Uri uri = new Uri("pack://application:,,,/ReferencedAssembly;component/ResourceFile.xaml", UriKind.Absolute);`|  
+|参照アセンブリのサブフォルダー内のリソース ファイル|`Uri uri = new Uri("pack://application:,,,/ReferencedAssembly;component/Subfolder/ResourceFile.xaml", UriKind.Absolute);`|  
+|バージョン管理された参照アセンブリ内のリソース ファイル|`Uri uri = new Uri("pack://application:,,,/ReferencedAssembly;v1.0.0.0;component/ResourceFile.xaml", UriKind.Absolute);`|  
+|コンテンツ ファイル|`Uri uri = new Uri("pack://application:,,,/ContentFile.xaml", UriKind.Absolute);`|  
+|サブフォルダー内のコンテンツ ファイル|`Uri uri = new Uri("pack://application:,,,/Subfolder/ContentFile.xaml", UriKind.Absolute);`|  
+|起点サイト ファイル|`Uri uri = new Uri("pack://siteoforigin:,,,/SOOFile.xaml", UriKind.Absolute);`|  
+|サブフォルダー内の起点サイト ファイル|`Uri uri = new Uri("pack://siteoforigin:,,,/Subfolder/SOOFile.xaml", UriKind.Absolute);`|  
+  
+ 表 4 は、<xref:System.Uri?displayProperty=fullName> を使用してコードで指定できるさまざまな相対パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を示しています。  
+  
+ 表 4 : コードでの相対パッケージの URI  
+  
+|File|相対パッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)]|  
+|----------|---------------------------------------------------------------------------|  
+|リソース ファイル \- ローカル アセンブリ|`Uri uri = new Uri("/ResourceFile.xaml", UriKind.Relative);`|  
+|サブフォルダー内のリソース ファイル \- ローカル アセンブリ|`Uri uri = new Uri("/Subfolder/ResourceFile.xaml", UriKind.Relative);`|  
+|リソース ファイル \- 参照アセンブリ|`Uri uri = new Uri("/ReferencedAssembly;component/ResourceFile.xaml", UriKind.Relative);`|  
+|サブフォルダー内のリソース ファイル \- 参照アセンブリ|`Uri uri = new Uri("/ReferencedAssembly;component/Subfolder/ResourceFile.xaml", UriKind.Relative);`|  
+|コンテンツ ファイル|`Uri uri = new Uri("/ContentFile.xaml", UriKind.Relative);`|  
+|サブフォルダー内のコンテンツ ファイル|`Uri uri = new Uri("/Subfolder/ContentFile.xaml", UriKind.Relative);`|  
+  
+<a name="Common_Pack_URI_Scenarios"></a>   
+### パッケージの URI 関連の一般的なシナリオ  
+ ここまで、リソース ファイル、コンテンツ ファイル、および起点サイト ファイルを指定するためにパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を構築する方法を説明してきました。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、こうした構造はさまざまな方法で使用されています。以下のセクションでは、いくつかの一般的な用途について説明します。  
+  
+<a name="Specifying_the_UI_to_Show_when_an_Application_Starts"></a>   
+#### アプリケーションの起動時に表示する UI の指定  
+ <xref:System.Windows.Application.StartupUri%2A> は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの起動時に表示する最初の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を指定します。  スタンドアロン アプリケーションでは、次の例に示すように、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] としてウィンドウを使用できます。  
+  
+ [!code-xml[PackURIOverviewSnippets#StartupUriWindow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PackURIOverviewSnippets/CS/Copy of App.xaml#startupuriwindow)]  
+  
+ スタンドアロン アプリケーションおよび [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] では、次の例に示すように、初期 UI としてページを指定することもできます。  
+  
+ [!code-xml[PackURIOverviewSnippets#StartupUriPage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PackURIOverviewSnippets/CS/App.xaml#startupuripage)]  
+  
+ アプリケーションがスタンドアロン アプリケーションであり、ページが <xref:System.Windows.Application.StartupUri%2A> を使用して指定されている場合、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は <xref:System.Windows.Navigation.NavigationWindow> を開いてページをホストします。  [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] の場合、ページはホスト ブラウザーに表示されます。  
+  
+<a name="Navigating_to_a_Page"></a>   
+#### ページへの移動  
+ ページへの移動方法を次の例に示します。  
+  
+ [!code-xml[NavigationOverviewSnippets#HyperlinkXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml1)]  
+[!code-xml[NavigationOverviewSnippets#HyperlinkXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml2)]  
+[!code-xml[NavigationOverviewSnippets#HyperlinkXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/NavigationOverviewSnippets/CSharp/PageWithHyperlink.xaml#hyperlinkxaml3)]  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で移動に使用できるさまざまな方法の詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+<a name="Specifying_a_Window_Icon"></a>   
+#### ウィンドウ アイコンの指定  
+ URI を使用してウィンドウのアイコンを指定する方法を次の例に示します。  
+  
+ [!code-xml[WindowIconSnippets#WindowIconSetXAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/WindowIconSnippets/XAML/MainWindow.xaml#windowiconsetxaml)]  
+  
+ 詳細については、「<xref:System.Windows.Window.Icon%2A>」を参照してください。  
+  
+<a name="Loading_Image__Audio__and_Video_Files"></a>   
+#### イメージ ファイル、オーディオ ファイル、およびビデオ ファイルの読み込み  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用すると、アプリケーションでさまざまな種類のメディアを使用できます。次の例に示すように、それらはどれもパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して指定し、読み込むことができます。  
+  
+ [!code-xml[MediaPlayerVideoSample#VideoPackURIAtSOO](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaPlayerVideoSample/CS/HomePage.xaml#videopackuriatsoo)]  
+  
+ [!code-xml[MediaPlayerAudioSample#AudioPackURIAtSOO](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaPlayerAudioSample/CS/HomePage.xaml#audiopackuriatsoo)]  
+  
+ [!code-xml[ImageSample#ImagePackURIContent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageSample/CS/HomePage.xaml#imagepackuricontent)]  
+  
+ メディア コンテンツの操作方法の詳細については、「[グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)」を参照してください。  
+  
+<a name="Loading_a_Resource_Dictionary_from_the_Site_of_Origin"></a>   
+#### 起点サイトからのリソース ディクショナリの読み込み  
+ リソース ディクショナリ \(<xref:System.Windows.ResourceDictionary>\) は、アプリケーション テーマのサポートに使用できます。  テーマを作成および管理する 1 つの方法は、複数のテーマをリソース ディクショナリとして作成し、アプリケーションの起点サイトに配置することです。  これにより、アプリケーションを再コンパイルして再配置することなく、テーマを追加および更新できます。  これらのリソース ディクショナリは、次の例に示すように、パッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して指定し、読み込むことができます。  
+  
+ [!code-xml[ResourceDictionarySnippets#ResourceDictionaryPackURI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ResourceDictionarySnippets/CS/App.xaml#resourcedictionarypackuri)]  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でのテーマの概要については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+## 参照  
+ [WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/persist-and-restore-application-scope-properties.md b/docs/framework/wpf/app-development/persist-and-restore-application-scope-properties.md
new file mode 100644
index 00000000000..e0dd0877e48
--- /dev/null
+++ b/docs/framework/wpf/app-development/persist-and-restore-application-scope-properties.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : アプリケーション セッション全体でアプリケーション スコープのプロパティを永続化および復元する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション スコープのプロパティ, 永続化"
+  - "アプリケーション スコープのプロパティ, 復元"
+  - "永続化 (アプリケーション スコープのプロパティを)"
+  - "プロパティ, 永続化"
+  - "プロパティ, 復元"
+  - "復元 (アプリケーション スコープのプロパティを)"
+ms.assetid: 55d5904a-f444-4eb5-abd3-6bc74dd14226
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : アプリケーション セッション全体でアプリケーション スコープのプロパティを永続化および復元する
+この例では、アプリケーションがシャットダウンしたときにアプリケーション スコープのプロパティを永続化する方法と、次回の起動時にアプリケーション スコープのプロパティを復元する方法を示します。  
+  
+## 使用例  
+ アプリケーションは、アプリケーション スコープのプロパティの永続化と復元を、分離ストレージに対して行います。  分離ストレージは、ファイル アクセス許可がないアプリケーションから安全に使用できる、保護されたストレージ エリアです。  
+  
+ [!code-xml[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml#persistrestoreappscopepropertiesxaml1)]  
+[!code-xml[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml#persistrestoreappscopepropertiesxaml2)]  
+  
+ [!code-csharp[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml.cs#persistrestoreappscopepropertiescodebehind1)]
+ [!code-vb[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/visualbasic/application.xaml.vb#persistrestoreappscopepropertiescodebehind1)]  
+[!code-csharp[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml.cs#persistrestoreappscopepropertiescodebehind2)]
+[!code-vb[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/visualbasic/application.xaml.vb#persistrestoreappscopepropertiescodebehind2)]  
+[!code-csharp[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/CSharp/App.xaml.cs#persistrestoreappscopepropertiescodebehind3)]
+[!code-vb[HOWTOApplicationModelSnippets#PersistRestoreAppScopePropertiesCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOApplicationModelSnippets/visualbasic/application.xaml.vb#persistrestoreappscopepropertiescodebehind3)]
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/structured-navigation-overview.md b/docs/framework/wpf/app-development/structured-navigation-overview.md
new file mode 100644
index 00000000000..6dab1eb476f
--- /dev/null
+++ b/docs/framework/wpf/app-development/structured-navigation-overview.md
@@ -0,0 +1,178 @@
+---
+title: "構造化ナビゲーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "構造化ナビゲーション [WPF]"
+ms.assetid: 025d30ef-fec5-436d-ad7a-5d5483331c26
+caps.latest.revision: 43
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 36
+---
+# 構造化ナビゲーションの概要
+[!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] がホストするコンテンツ、<xref:System.Windows.Controls.Frame>、または <xref:System.Windows.Navigation.NavigationWindow> は、pack [!INCLUDE[TLA#tla_uri#plural](../../../../includes/tlasharptla-urisharpplural-md.md)] で識別され、ハイパーリンクに移動するページで構成されています。  ページの構造、およびハイパーリンクで定義される移動方法を、ナビゲーション トポロジと呼びます。  このトポロジはさまざまな種類のアプリケーションに対応しますが、特にドキュメント間を移動するアプリケーションに適しています。  このようなアプリケーションでは、互いのページの情報を必要とせずに、ユーザーはページ間を移動できます。  
+  
+ ただし、アプリケーションによっては、移動のタイミングを理解している必要があるページを使用します。  たとえば、組織内のすべての従業員を一覧するページ \(\[従業員の一覧\] ページ\) を使用する人事アプリケーションがあるものとします。  このページでは、ハイパーリンクをクリックすることによって、新しい従業員を追加することもできます。  クリックすると、\[従業員の追加\] ページに移動して新しい従業員の詳細情報を収集し、それを \[従業員の一覧\] ページに返して、新しい従業員を作成し、一覧を更新します。  このスタイルのナビゲーションは、構造化プログラミングと呼ばれる、処理を実行して値を返すメソッドの呼び出しに似ています。  そのため、このスタイルのナビゲーションを、*構造化ナビゲーション*と呼びます。  
+  
+ <xref:System.Windows.Controls.Page> クラスは、構造化ナビゲーションのサポートを実装していません。  代わりに、<xref:System.Windows.Controls.Page> から <xref:System.Windows.Navigation.PageFunction%601> クラスが派生し、構造化ナビゲーションで必要な基本コンストラクトで拡張されています。  このトピックでは、<xref:System.Windows.Navigation.PageFunction%601> を使用して構造化ナビゲーションを確立する方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Structured_Navigation"></a>   
+## 構造化ナビゲーション  
+ 構造化ナビゲーションで、あるページが別のページを呼び出す場合、以下の一部またはすべての動作が必要です。  
+  
+-   呼び出し元ページが、必要に応じてパラメーターを渡して、呼び出されたページに移動します。  
+  
+-   呼び出し元ページの使用が終了すると、呼び出されたページは呼び出し元ページに戻ります。このとき、次の動作が行われることがあります。  
+  
+    -   呼び出し元ページの終了方法 \(ユーザーが \[OK\] または \[キャンセル\] をクリックしたかどうかなど\) を示す状態情報を返します。  
+  
+    -   ユーザーから収集したデータ \(新しい従業員の詳細など\) を返します。  
+  
+-   呼び出し元ページが、呼び出されたページに戻ると、呼び出されたページはナビゲーション履歴から削除されて、呼び出されたページのインスタンスが他のインスタンスから分離されます。  
+  
+ これらの動作を次の図に示します。  
+  
+ ![呼び出し元ページと呼び出し先ページの間のフロー](../../../../docs/framework/wpf/app-development/media/structurednavigationoverviewfigure1.png "StructuredNavigationOverviewFigure1")  
+  
+ これらの動作は、呼び出されたページとして <xref:System.Windows.Navigation.PageFunction%601> を使用して実装できます。  
+  
+<a name="Structured_Navigation_with_PageFunction"></a>   
+## PageFunction を使用した構造化ナビゲーション  
+ このトピックでは、単一の <xref:System.Windows.Navigation.PageFunction%601> を使用する構造化ナビゲーションの基本メカニズムを実装する方法について説明します。  このサンプルでは、<xref:System.Windows.Controls.Page> が <xref:System.Windows.Navigation.PageFunction%601> を呼び出してユーザーから <xref:System.String> 値を取得し、それを返します。  
+  
+### 呼び出し元ページを作成する  
+ <xref:System.Windows.Navigation.PageFunction%601> を呼び出すページは、<xref:System.Windows.Controls.Page> または <xref:System.Windows.Navigation.PageFunction%601> です。  この例では、次のコードに示すように、<xref:System.Windows.Controls.Page> です。  
+  
+ [!code-xml[StructuredNavigationSample#CallingPageDefaultMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml#callingpagedefaultmarkup1)]  
+[!code-xml[StructuredNavigationSample#CallingPageDefaultMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml#callingpagedefaultmarkup2)]  
+  
+ [!code-csharp[StructuredNavigationSample#CallingPageDefaultCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#callingpagedefaultcodebehind1)]
+ [!code-vb[StructuredNavigationSample#CallingPageDefaultCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#callingpagedefaultcodebehind1)]  
+[!code-csharp[StructuredNavigationSample#CallingPageDefaultCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#callingpagedefaultcodebehind2)]
+[!code-vb[StructuredNavigationSample#CallingPageDefaultCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#callingpagedefaultcodebehind2)]  
+[!code-csharp[StructuredNavigationSample#CallingPageDefaultCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#callingpagedefaultcodebehind3)]
+[!code-vb[StructuredNavigationSample#CallingPageDefaultCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#callingpagedefaultcodebehind3)]  
+  
+### 呼び出すページ関数を作成する  
+ 呼び出し元ページは、呼び出されたページを使用してユーザーからデータを収集し、それを返すため、<xref:System.Windows.Navigation.PageFunction%601> は、呼び出されたページが返す値の型を型引数で指定するジェネリック クラスとして実装されます。  <xref:System.Windows.Navigation.PageFunction%601> を使用して <xref:System.String> を返す、呼び出されるページの初期実装のコードを次に示します。  
+  
+ [!code-xml[StructuredNavigationSample#CalledPageFunctionMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml#calledpagefunctionmarkup)]  
+  
+ [!code-csharp[StructuredNavigationSample#CalledPageFunctionCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#calledpagefunctioncodebehind1)]
+ [!code-vb[StructuredNavigationSample#CalledPageFunctionCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#calledpagefunctioncodebehind1)]  
+[!code-csharp[StructuredNavigationSample#CalledPageFunctionCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#calledpagefunctioncodebehind2)]
+[!code-vb[StructuredNavigationSample#CalledPageFunctionCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#calledpagefunctioncodebehind2)]  
+  
+ <xref:System.Windows.Navigation.PageFunction%601> の宣言は、型引数が追加された <xref:System.Windows.Controls.Page> の宣言に似ています。  コード例に示されているように、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップ \(`x:TypeArguments` 属性を使用\) と分離コード \(標準のジェネリック型引数構文を使用\) の両方で型引数が指定されています。  
+  
+ 型引数として [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] クラスのみを使用する必要はありません。  <xref:System.Windows.Navigation.PageFunction%601> を呼び出して、カスタム型として抽象化されるドメイン固有のデータを収集できます。  <xref:System.Windows.Navigation.PageFunction%601> の型引数としてカスタム型を使用する方法を次のコードに示します。  
+  
+ [!code-csharp[CustomTypePageFunctionSnippets#CustomTypeCODE1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/CSharp/CustomType.cs#customtypecode1)]
+ [!code-vb[CustomTypePageFunctionSnippets#CustomTypeCODE1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/VisualBasic/CustomType.vb#customtypecode1)]  
+[!code-csharp[CustomTypePageFunctionSnippets#CustomTypeCODE2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/CSharp/CustomType.cs#customtypecode2)]
+[!code-vb[CustomTypePageFunctionSnippets#CustomTypeCODE2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/VisualBasic/CustomType.vb#customtypecode2)]  
+  
+ [!code-xml[CustomTypePageFunctionSnippets#CustomTypePageFunctionMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/CSharp/CustomTypePageFunction.xaml#customtypepagefunctionmarkup1)]  
+[!code-xml[CustomTypePageFunctionSnippets#CustomTypePageFunctionMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/CSharp/CustomTypePageFunction.xaml#customtypepagefunctionmarkup2)]  
+  
+ [!code-csharp[CustomTypePageFunctionSnippets#CustomTypePageFunctionCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/CSharp/CustomTypePageFunction.xaml.cs#customtypepagefunctioncodebehind1)]
+ [!code-vb[CustomTypePageFunctionSnippets#CustomTypePageFunctionCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomTypePageFunctionSnippets/VisualBasic/CustomTypePageFunction.xaml.vb#customtypepagefunctioncodebehind1)]  
+  
+  
+ <xref:System.Windows.Navigation.PageFunction%601> の型引数は、呼び出し元ページと、呼び出されるページとの間の通信の基盤を提供します。  
+  
+ ここで示すように、<xref:System.Windows.Navigation.PageFunction%601> の宣言で指定される型は、<xref:System.Windows.Navigation.PageFunction%601> から呼び出し元ページにデータを返すうえで重要な役割を果たします。  
+  
+### PageFunction を呼び出してパラメーターを渡す  
+ ページを呼び出すには、<xref:System.Windows.Navigation.NavigationService.Navigate%2A> メソッドを使用して、呼び出し元ページが、呼び出されるページをインスタンス化し、そのページに移動する必要があります。  呼び出し元ページは、呼び出されるページで収集されるデータの既定値など、呼び出されるページに初期データを渡すことができます。  
+  
+ 既定以外のコンストラクターを使用して呼び出されたページが、呼び出し元ページからパラメーターを受け取るコードを次に示します。  
+  
+ [!code-csharp[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#acceptsinitialdatacodebehind1)]
+ [!code-vb[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#acceptsinitialdatacodebehind1)]  
+[!code-csharp[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#acceptsinitialdatacodebehind2)]
+[!code-vb[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#acceptsinitialdatacodebehind2)]  
+[!code-csharp[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#acceptsinitialdatacodebehind3)]
+[!code-vb[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#acceptsinitialdatacodebehind3)]  
+[!code-csharp[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#acceptsinitialdatacodebehind4)]
+[!code-vb[StructuredNavigationSample#AcceptsInitialDataCODEBEHIND4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#acceptsinitialdatacodebehind4)]  
+  
+ 呼び出し元ページが、<xref:System.Windows.Documents.Hyperlink> の <xref:System.Windows.Documents.Hyperlink.Click> イベントを処理することによって呼び出し対象のページをインスタンス化し、このページに初期の文字列値を渡すコードを次に示します。  
+  
+ [!code-xml[StructuredNavigationSample#PassingDataMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml#passingdatamarkup2)]  
+[!code-csharp[StructuredNavigationSample#PassingDataCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#passingdatacodebehind1)]
+[!code-vb[StructuredNavigationSample#PassingDataCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#passingdatacodebehind1)]  
+[!code-csharp[StructuredNavigationSample#PassingDataCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#passingdatacodebehind2)]
+[!code-vb[StructuredNavigationSample#PassingDataCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#passingdatacodebehind2)]  
+[!code-csharp[StructuredNavigationSample#PassingDataCODEBEHIND3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#passingdatacodebehind3)]
+[!code-vb[StructuredNavigationSample#PassingDataCODEBEHIND3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#passingdatacodebehind3)]  
+  
+ 呼び出されるページにパラメーターを渡す必要はありません。  代わりに、以下を実行できます。  
+  
+-   呼び出し元ページの場合  
+  
+    1.  既定のコンストラクターを使用して、呼び出された <xref:System.Windows.Navigation.PageFunction%601> をインスタンス化します。  
+  
+    2.  <xref:System.Windows.Application.Properties%2A> にパラメーターを格納します。  
+  
+    3.  呼び出された <xref:System.Windows.Navigation.PageFunction%601> に移動します。  
+  
+-   呼び出された <xref:System.Windows.Navigation.PageFunction%601> の場合  
+  
+    -   <xref:System.Windows.Application.Properties%2A> に格納されたパラメーターを取得および使用します。  
+  
+ しかし、この後の説明にもあるように、依然として、コードを使用して呼び出されたページをインスタンス化し、そのページに移動して、呼び出されたページから返されるデータを収集する必要があります。  このため、<xref:System.Windows.Navigation.PageFunction%601> は有効である必要があります。有効でないと、次に <xref:System.Windows.Navigation.PageFunction%601> に移動したとき、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が既定のコンストラクターを使用して <xref:System.Windows.Navigation.PageFunction%601> をインスタンス化します。  
+  
+ ただし、呼び出されたページが戻る前に、呼び出し元ページが取得できるデータを返す必要があります。  
+  
+### タスクから呼び出し元ページにタスク結果とタスク データを返す  
+ ユーザーが呼び出されたページの使用を終了すると \(この例では、\[OK\] または \[キャンセル\] をクリックすることで表されます\)、呼び出されたページは戻る必要があります。  呼び出し元ページは、呼び出されたページを使用してユーザーからデータを収集するため、呼び出し元ページには 2 種類の情報が必要です。  
+  
+1.  ユーザーが呼び出されたページをキャンセルしたかどうか \(この例では、\[OK\] と \[キャンセル\] のどちらをクリックしたかで表されます\)。  これによって、呼び出し元ページは、ユーザーから収集したデータを処理するかどうかを判断します。  
+  
+2.  ユーザーが提供したデータ。  
+  
+ 情報を返すために、<xref:System.Windows.Navigation.PageFunction%601> は <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> メソッドを実装しています。  その呼び出し方法を次のコードに示します。  
+  
+ [!code-csharp[StructuredNavigationSample#ReturnCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#returncodebehind1)]
+ [!code-vb[StructuredNavigationSample#ReturnCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#returncodebehind1)]  
+[!code-csharp[StructuredNavigationSample#ReturnCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CalledPageFunction.xaml.cs#returncodebehind2)]
+[!code-vb[StructuredNavigationSample#ReturnCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CalledPageFunction.xaml.vb#returncodebehind2)]  
+  
+ この例では、ユーザーが \[キャンセル\] をクリックすると、呼び出し元ページに `null` が返されます。  ユーザーが \[OK\] をクリックすると、ユーザーによって指定された文字列値が返されます。  <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> は、指定したデータを呼び出し元ページに返すために実行する `protected` `virtual` メソッドです。  データは、ジェネリックな <xref:System.Windows.Navigation.ReturnEventArgs%601> 型のインスタンスにパッケージ化する必要があります。この型の型引数は、<xref:System.Windows.Navigation.ReturnEventArgs%601.Result%2A> が返す値の型を指定します。  このように、特定の型引数を使用して <xref:System.Windows.Navigation.PageFunction%601> を宣言することは、<xref:System.Windows.Navigation.PageFunction%601> が型引数で指定される型のインスタンスを返すことを示しています。  この例では、型引数、および戻り値が <xref:System.String> 型です。  
+  
+ <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> を呼び出す場合、呼び出し元ページでは、<xref:System.Windows.Navigation.PageFunction%601> の戻り値を受け取るための方法が必要です。  そのため、<xref:System.Windows.Navigation.PageFunction%601> は、呼び出し元ページが処理する <xref:System.Windows.Navigation.PageFunction%601.Return> イベントを実装しています。  <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> を呼び出すと、<xref:System.Windows.Navigation.PageFunction%601.Return> が発生するので、呼び出し元ページは <xref:System.Windows.Navigation.PageFunction%601.Return> に登録して通知を受け取ることができます。  
+  
+ [!code-csharp[StructuredNavigationSample#ProcessResultCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#processresultcodebehind1)]
+ [!code-vb[StructuredNavigationSample#ProcessResultCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#processresultcodebehind1)]  
+[!code-csharp[StructuredNavigationSample#ProcessResultCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StructuredNavigationSample/CSharp/CallingPage.xaml.cs#processresultcodebehind2)]
+[!code-vb[StructuredNavigationSample#ProcessResultCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StructuredNavigationSample/VisualBasic/CallingPage.xaml.vb#processresultcodebehind2)]  
+  
+### タスク完了時にタスク ページを削除する  
+ 呼び出されたページが戻り、呼び出されたページをユーザーがキャンセルしなかった場合、呼び出し元ページでは、ユーザーから提供されたデータ、および、呼び出されたページから返されたデータを処理します。  このような方法で行われるデータ取得は、通常は分離されたアクティビティです。呼び出されたページが戻ると、呼び出し元ページでは、さらにデータをキャプチャするために、新しい呼び出し元ページを作成し、そこに移動する必要があります。  
+  
+ ただし、呼び出されたページが[履歴](GTMT)から削除されない限り、ユーザーは呼び出し元ページの前のインスタンスに戻ることができます。  <xref:System.Windows.Navigation.PageFunction%601> が[履歴](GTMT)に残っているかどうかは、<xref:System.Windows.Navigation.PageFunctionBase.RemoveFromJournal%2A> プロパティで判断されます。  既定では、<xref:System.Windows.Navigation.PageFunctionBase.RemoveFromJournal%2A> が `true` に設定されるため、ページ関数は <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> が呼び出されたときに自動的に削除されます。  <xref:System.Windows.Navigation.PageFunction%601.OnReturn%2A> が呼び出された後にページ関数をナビゲーション履歴内に残すには、<xref:System.Windows.Navigation.PageFunctionBase.RemoveFromJournal%2A> を `false` に設定します。  
+  
+<a name="Other_Types_of_Structured_Navigation"></a>   
+## 他の種類の構造化ナビゲーション  
+ このトピックでは、構造化ナビゲーションの呼び出しと戻りをサポートする <xref:System.Windows.Navigation.PageFunction%601> の最も基本的な使用方法について説明しています。  これに基づいて、より複雑な構造化ナビゲーションを作成できます。  
+  
+ たとえば、ページを呼び出してユーザーから多くのデータを収集したり、タスクを実行するのに、複数のページが必要な場合があります。  複数のページを使用する場合、これを "ウィザード" と呼びます。  
+  
+ また、構造化ナビゲーションに基づいて効率的な処理を行う複雑なナビゲーション トポロジを使用するアプリケーションもあります。  詳細については、「[ナビゲーション トポロジの概要](../../../../docs/framework/wpf/app-development/navigation-topologies-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Navigation.PageFunction%601>   
+ <xref:System.Windows.Navigation.NavigationService>   
+ [ナビゲーション トポロジの概要](../../../../docs/framework/wpf/app-development/navigation-topologies-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/windows-in-wpf-applications.md b/docs/framework/wpf/app-development/windows-in-wpf-applications.md
new file mode 100644
index 00000000000..a9e89585360
--- /dev/null
+++ b/docs/framework/wpf/app-development/windows-in-wpf-applications.md
@@ -0,0 +1,41 @@
+---
+title: "WPF アプリケーションのウィンドウ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ウィンドウ [WPF]"
+  - "WPF アプリケーション, ウィンドウ"
+ms.assetid: dc091d04-68cf-4592-9695-75fda037db76
+caps.latest.revision: 67
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 67
+---
+# WPF アプリケーションのウィンドウ
+ユーザーは、ウィンドウを通してアプリケーションと対話します。  ウィンドウの基本目的は、コンテンツをホストして表示することです。  ウィンドウがホストするコンテンツの種類は、アプリケーションが処理するデータの種類によって異なります。このようなデータの種類には、メディア、XAML \(Extensible Application Markup Language\) ページ、Web ページ、ドキュメント、データベースのテーブルやレコード、およびシステム情報などが含まれます。  
+  
+## このセクションの内容  
+ [WPF ウィンドウの概要](../../../../docs/framework/wpf/app-development/wpf-windows-overview.md)  
+ [ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)  
+ [How\-to Topics](../../../../ocs/framework/wpf/app-development/window-management-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Window>  
+  
+ <xref:System.Windows.Navigation.NavigationWindow>  
+  
+## 関連項目  
+ [アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)  
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)  
+ [ホスト](../../../../docs/framework/wpf/app-development/hosting-wpf-applications.md)  
+ [ビルドと配置](../../../../docs/framework/wpf/app-development/building-and-deploying-wpf-applications.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/wpf-add-ins-overview.md b/docs/framework/wpf/app-development/wpf-add-ins-overview.md
new file mode 100644
index 00000000000..21f32440183
--- /dev/null
+++ b/docs/framework/wpf/app-development/wpf-add-ins-overview.md
@@ -0,0 +1,298 @@
+---
+title: "WPF アドインの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework アドイン モデル [WPF]"
+  - "アドイン [WPF], アーキテクチャ"
+  - "アドイン [WPF], 利点"
+  - "アドイン [WPF], 制限事項"
+  - "アドイン [WPF], パフォーマンス"
+  - "アドイン [WPF], ユーザー インターフェイス"
+  - "アドインとユーザー インターフェイス [WPF]"
+  - "アドインと XAML ブラウザー アプリケーション [WPF]"
+  - "アドインの概要 [WPF]"
+ms.assetid: 00b4c776-29a8-4dba-b603-280a0cdc2ade
+caps.latest.revision: 36
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# WPF アドインの概要
+<a name="Introduction"></a> [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] には、アドイン機能拡張をサポートするアプリケーションの作成に使用できるアドイン モデルが用意されています。  このアドイン モデルを使用することで、アプリケーション機能に統合され、アプリケーション機能を拡張するアドインを作成できます。  一部のシナリオでは、アドインが提供する [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] をアプリケーションで表示する必要があります。  このトピックでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] が [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルを強化してこうしたシナリオを実現するしくみ、背後にあるアーキテクチャ、その利点、および制限事項について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Requirements"></a>   
+## 必要条件  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルを十分に理解していることが必要です。  詳細については、「[アドインおよび拡張機能](../../../../ml/index.xml)」を参照してください。  
+  
+<a name="AddInsOverview"></a>   
+## アドインの概要  
+ 新しい機能を追加するためにアプリケーションを再コンパイルして再配置する手間を省くことを目的として、アプリケーションは機能拡張メカニズムを実装し、開発者 \(開発元、サード パーティのいずれも\) が元のアプリケーションに統合される別のアプリケーションを作成できるようにしています。  こうした拡張機能をサポートする方法としては、アドイン \("アドオン"、"プラグイン" などとも呼ばれる\) の使用が最も一般的です。  アドインによる機能拡張を実行する実際のアプリケーションとして、次のようなものが挙げられます。  
+  
+-   Internet Explorer のアドオン。  
+  
+-   Windows Media Player のプラグイン。  
+  
+-   Visual Studio のアドイン。  
+  
+ たとえば、Windows Media Player のアドイン モデルにおいて、サード パーティの開発者は、Windows Media Player の機能をさまざまな形で拡張する "プラグイン" を実装できます。たとえば、Windows Media Player でネイティブ サポートされていないメディア形式 \(DVD、MP3 など\) のデコーダーおよびエンコーダー、オーディオ エフェクト、スキンなどを作成できます。  各アドイン モデルは、アプリケーション固有の機能を組み込むために構築されますが、どのアドイン モデルにも共通するエンティティや動作がいくつかあります。  
+  
+ 典型的な機能拡張ソリューションの主な 3 つのエンティティは、*コントラクト*、*アドイン*、および*ホスト アプリケーション*です。  コントラクトは、次の 2 つの方法で、アドインとホスト アプリケーションとの統合方法を定義します。  
+  
+-   アドインはホスト アプリケーションによって実装される機能と一体化します。  
+  
+-   ホスト アプリケーションはアドインが一体化するための機能を公開します。  
+  
+ アドインを使用できるようにするためには、ホスト アプリケーションが実行時にアドインを検索して読み込む必要があります。  したがって、アドインをサポートするアプリケーションには次の機能が必要です。  
+  
+-   **探索** : ホスト アプリケーションによってサポートされるコントラクトに準拠しているアドインを検索します。  
+  
+-   **アクティブ化** : アドインを読み込んで実行し、アドインとの通信を確立します。  
+  
+-   **分離** : アプリケーション ドメインまたはアプリケーション プロセスを使用することで他から切り離すための境界を確立し、アドインの使用に伴うセキュリティおよび実行に関する潜在的な問題からアプリケーションを保護します。  
+  
+-   **通信** : アドインとホスト アプリケーションが分離の境界を越えて通信し、メソッドを呼び出したりデータを渡したりできるようにします。  
+  
+-   **有効期間管理** : アプリケーション ドメインとアプリケーション プロセスの読み込みおよびアンロードを、クリーンで予測可能な方法で行います \(「[アプリケーション ドメイン](../../../../docs/framework/app-domains/application-domains.md)」を参照\)。  
+  
+-   **バージョン管理** : ホスト アプリケーションとアドインのどちらかに、新バージョンが作成された後も引き続き通信できるようにします。  
+  
+ このことからわかるように、堅牢なアドイン モデルの開発は簡単なことではありません。  そのため、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] にはアドイン モデルの構築に必要なインフラストラクチャが用意されています。  
+  
+> [!NOTE]
+>  アドインの詳細については、「[アドインおよび拡張機能](../../../../ml/index.xml)」を参照してください。  
+  
+<a name="NETFrameworkAddInModelOverview"></a>   
+## .NET Framework アドイン モデルの概要  
+ [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルは、<xref:System.AddIn> 名前空間にあり、アドイン機能拡張の開発を単純化するために設計された型のセットが用意されています。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルの基本単位は*コントラクト*です。コントラクトは、ホスト アプリケーションとアドイン間の通信を定義します。  コントラクトのホスト アプリケーション固有の*ビュー*を使用して、コントラクトはホスト アプリケーションに公開されます。  同様に、コントラクトのアドイン固有の*ビュー*がアドインに公開されます。  *アダプター*は、ホスト アプリケーションとアドインが、コントラクトの対応するビュー間で通信するために使用されます。  コントラクト、ビュー、およびアダプターはセグメントと見なされ、関連セグメントのセットが*パイプライン*を構成します。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルはパイプラインを基盤とし、それを基に探索、アクティブ化、セキュリティ分離、実行分離 \(アプリケーションのドメインとプロセスを両方使用\)、通信、有効期間管理、およびバージョン管理をサポートします。  
+  
+ このサポート全体を使用して、開発者はホスト アプリケーションの機能を統合するアドインを開発できます。  ただし、一部のシナリオでは、アドインが提供する [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] をホスト アプリケーションで表示する必要が生じます。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の各プレゼンテーション テクノロジには [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] 実装の独自のモデルがあるため、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルは特定のプレゼンテーション テクノロジをサポートしません。  その代わり、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルをアドインの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] サポートという形で機能拡張します。  
+  
+<a name="WPFAddInModel"></a>   
+## WPF アドイン  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルと併用することで、ホスト アプリケーションでアドインの [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を表示する必要があるさまざまなシナリオに対応できます。  特に、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] によるこれらのシナリオの対応には、次の 2 つのプログラミング モデルが使用されます。  
+  
+1.  **アドインが UI を返す**。  アドインが、コントラクトの定義に従って、メソッド呼び出しを介してホスト アプリケーションに [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返します。  このシナリオは、次の場合に使用されます。  
+  
+    -   アドインが返す [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の外観が、動的に生成されるレポートなど、実行時にしか存在しないデータまたは条件に依存している。  
+  
+    -   アドインが提供するサービスの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が、そのアドインを使用できるホスト アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] と違っている。  
+  
+    -   アドインは主にホスト アプリケーション向けのサービスを実行し、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を使用してホスト アプリケーションにステータスをレポートする。  
+  
+2.  **アドインが UI である**。  アドインが、コントラクトの定義に従う [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] です。  このシナリオは、次の場合に使用されます。  
+  
+    -   アドインは表示以外のサービス \(アドバタイズメントなど\) を提供しない。  
+  
+    -   アドインが提供するサービスの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、そのアドインを使用できるすべてのホスト アプリケーションで共通である \(電卓、カラー ピッカーなど\)。  
+  
+ これらのシナリオでは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] オブジェクトをホスト アプリケーション ドメインとアドイン アプリケーション ドメインとの間で受け渡しできる必要があります。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルは、アプリケーション ドメイン間の通信においてリモート処理に依存しているため、それらの間で受け渡しされるオブジェクトはリモート処理可能である必要があります。  
+  
+ リモート処理可能なオブジェクトとは、次の 1 つ以上に該当するクラスのインスタンスです。  
+  
+-   <xref:System.MarshalByRefObject> クラスから派生している。  
+  
+-   <xref:System.Runtime.Serialization.ISerializable> インターフェイスを実装している。  
+  
+-   <xref:System.SerializableAttribute> 属性が適用されている。  
+  
+> [!NOTE]
+>  リモート処理可能な [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] オブジェクトの作成の詳細については、「[Making Objects Remotable](http://msdn.microsoft.com/ja-jp/01197253-3f13-43b7-894d-9683e431192a)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の型はリモート処理可能ではありません。  この問題を解決するため、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルを拡張して、アドインによって作成される [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をホスト アプリケーションで表示できるようにします。  これは [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] によって、<xref:System.AddIn.Contract.INativeHandleContract> インターフェイスと、<xref:System.AddIn.Pipeline.FrameworkElementAdapters> クラスの 2 つの静的メソッド <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> および <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> という 2 つの方法でサポートされています。  大まかに、これらの型およびメソッドは次のように使用されます。  
+  
+1.  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、アドインが提供する [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] が、図形、コントロール、ユーザー コントロール、レイアウト パネル、ページなど、<xref:System.Windows.FrameworkElement> から直接または間接的に派生したクラスである必要があります。  
+  
+2.  UI がアドインとホスト アプリケーションとの間で受け渡しされることをコントラクトで宣言する場合、必ず <xref:System.AddIn.Contract.INativeHandleContract> として宣言する必要があります \(<xref:System.Windows.FrameworkElement> ではない\)。<xref:System.AddIn.Contract.INativeHandleContract> はアドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のリモート処理可能な表現で、分離の境界を越えて受け渡しできます。  
+  
+3.  アドインのアプリケーション ドメインから渡される前に、<xref:System.Windows.FrameworkElement> は、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> 呼び出しによって、<xref:System.AddIn.Contract.INativeHandleContract> としてパッケージ化されます。  
+  
+4.  ホスト アプリケーションのアプリケーション ドメインに渡された後、<xref:System.AddIn.Contract.INativeHandleContract> は、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> 呼び出しによって、<xref:System.Windows.FrameworkElement> として再パッケージ化する必要があります。  
+  
+ <xref:System.AddIn.Contract.INativeHandleContract>、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A>、および <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> の使用形態は、個々のシナリオによって異なります。  以降では、各プログラミング モデルについて詳しく説明していきます。  
+  
+<a name="ReturnUIFromAddInContract"></a>   
+## ユーザー インターフェイスを返すアドイン  
+ アドインが [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をホスト アプリケーションに返すようにするには、次のことが必要です。  
+  
+1.  ホスト アプリケーション、アドイン、およびパイプラインが、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の「[アドインおよび拡張機能](../../../../ml/index.xml)」の説明に従って作成されている必要があります。  
+  
+2.  コントラクトに <xref:System.AddIn.Contract.IContract> を実装することが必要です。また、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返すようにするため、戻り値が <xref:System.AddIn.Contract.INativeHandleContract> 型であるメソッドをコントラクトで宣言する必要があります。  
+  
+3.  アドインとホスト アプリケーションとの間で受け渡される [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、直接または間接的に、<xref:System.Windows.FrameworkElement> から派生している必要があります。  
+  
+4.  アドインが返す [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、分離境界を越える前に、<xref:System.Windows.FrameworkElement> から <xref:System.AddIn.Contract.INativeHandleContract> に変換される必要があります。  
+  
+5.  返される [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、分離境界を越えた後に、<xref:System.AddIn.Contract.INativeHandleContract> から <xref:System.Windows.FrameworkElement> に変換される必要があります。  
+  
+6.  ホスト アプリケーションは、返された <xref:System.Windows.FrameworkElement> を表示します。  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返すアドインを実装する方法の例については、「[UI を返すアドインを作成する](../../../../docs/framework/wpf/app-development/how-to-create-an-add-in-that-returns-a-ui.md)」を参照してください。  
+  
+<a name="AddInIsAUI"></a>   
+## ユーザー インターフェイスであるアドイン  
+ アドインが [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] である場合、次のことが必要です。  
+  
+1.  ホスト アプリケーション、アドイン、およびパイプラインが、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の「[アドインおよび拡張機能](../../../../ml/index.xml)」の説明に従って作成されている必要があります。  
+  
+2.  アドインのコントラクト インターフェイスに <xref:System.AddIn.Contract.INativeHandleContract> を実装する必要があります。  
+  
+3.  ホスト アプリケーションに渡されるアドインが、直接または間接的に、<xref:System.Windows.FrameworkElement> から派生している必要があります。  
+  
+4.  アドインは、分離境界を越える前に <xref:System.Windows.FrameworkElement> から <xref:System.AddIn.Contract.INativeHandleContract> に変換される必要があります。  
+  
+5.  アドインは、分離境界を越えた後に <xref:System.AddIn.Contract.INativeHandleContract> から <xref:System.Windows.FrameworkElement> に変換される必要があります。  
+  
+6.  ホスト アプリケーションは、返された <xref:System.Windows.FrameworkElement> を表示します。  
+  
+ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] であるアドインを実装する方法の例については、「[UI であるアドインを作成する](../../../../docs/framework/wpf/app-development/how-to-create-an-add-in-that-is-a-ui.md)」を参照してください。  
+  
+<a name="ReturningMultipleUIsFromAnAddIn"></a>   
+## 複数の UI を返すアドイン  
+ アドインが提供する複数の [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] をホスト アプリケーションが表示するケースはよくあります。  たとえば、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] であるアドインが、ホスト アプリケーションにステータス情報も [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] として提供するとします。  このようなアドインは、[ユーザー インターフェイスを返すアドイン](#ReturnUIFromAddInContract)のモデルと[ユーザー インターフェイスであるアドイン](#AddInIsAUI)のモデルの両方の手法を組み合わせることで実装できます。  
+  
+<a name="AddInsAndXBAPs"></a>   
+## アドインと XAML ブラウザー アプリケーション  
+ ここまでの例では、ホスト アプリケーションはスタンドアロン アプリケーションとしてインストールされています。  [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] はアドインをホストすることもできますが、そのためには次に示すビルドと実装の要件を満たす必要があります。  
+  
+-   パイプライン \(フォルダーとアセンブリ\) とアドイン アセンブリを、クライアント コンピューターの [!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] アプリケーション キャッシュの、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] と同じフォルダーにダウンロードするよう、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] アプリケーション マニフェストを構成する必要があります。  
+  
+-   アドインを探索して読み込む [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] コードで、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] の [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] アプリケーション キャッシュを、パイプラインとアドインの場所として使用する必要があります。  
+  
+-   [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] は、アドインが起点サイトにある圧縮しないファイルを参照する場合、アドインを特別なセキュリティ コンテキストの下で読み込む必要があります。[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] によってホストされる場合、アドインが参照できるのは、ホスト アプリケーションの起点サイトにある圧縮しないファイルのみです。  
+  
+ これらのタスクについて、次のサブセクションで詳しく説明します。  
+  
+### ClickOnce 配置のためのパイプラインとアドインの構成  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、[!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] 配置キャッシュの安全なフォルダーにダウンロードされ、そこから実行されます。  [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] でアドインをホストするには、パイプラインとアドインのアセンブリも同じ安全なフォルダーにダウンロードする必要があります。  これを行うには、パイプラインとアドインのどちらのアセンブリもダウンロード対象に含まれるよう、アプリケーション マニフェストを構成する必要があります。  これは、[!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] で行うのが最も簡単ですが、[!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] でパイプラインをアセンブリとして検出するには、パイプラインとアドインのアセンブリが、ホスト [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] プロジェクトのルート フォルダーに存在する必要があります。  
+  
+ したがって、まず、パイプライン アセンブリとアドイン アセンブリの各プロジェクトのビルド出力を設定し、パイプラインとアドインのアセンブリを [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] プロジェクトのルートにビルドします。  次の表は、ホストの [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] プロジェクトと同じソリューションとルートのフォルダーに格納される、パイプライン アセンブリ プロジェクトとアドイン アセンブリ プロジェクトのビルド出力パスを示します。  
+  
+ 表 1: XBAP でホストされるパイプライン アセンブリのビルド出力パス  
+  
+|パイプライン アセンブリ プロジェクト|ビルド出力パス|  
+|-------------------------|-------------|  
+|コントラクト|`..  \HostXBAP\Contracts\`|  
+|アドイン ビュー|`..  \HostXBAP\AddInViews\`|  
+|アドイン側のアダプター|`..  \HostXBAP\AddInSideAdapters\`|  
+|ホスト側のアダプター|`..  \HostXBAP\HostSideAdapters\`|  
+|アドイン|`..  \HostXBAP\AddIns\WPFAddIn1`|  
+  
+ 次に、パイプライン アセンブリとアドイン アセンブリを [!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] コンテンツ ファイルとして [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] に指定します。手順は次のとおりです。  
+  
+1.  ソリューション エクスプローラーで各パイプライン フォルダーを右クリックし、**\[プロジェクトに含める\]** をクリックして、パイプラインとアドインのアセンブリをプロジェクトに含めます。  
+  
+2.  **\[プロパティ\]** ウィンドウで、パイプライン アセンブリとアドイン アセンブリそれぞれについて、**\[ビルド アクション\]** を **\[コンテンツ\]** に設定します。  
+  
+ 最後に、パイプラインとアドインのどちらのアセンブリ ファイルもダウンロード対象に含まれるよう、アプリケーション マニフェストを構成します。  ファイルは、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] アプリケーションが占有する [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] キャッシュ内のフォルダーのルートにあるフォルダー内に存在している必要があります。  この構成は、次の手順に従って、[!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] で行うことができます。  
+  
+1.  [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] プロジェクトを右クリックし、**\[プロパティ\]**、**\[発行\]** の順にクリックし、**\[アプリケーション ファイル\]** をクリックします。  
+  
+2.  **\[アプリケーション ファイル\]** ダイアログ ボックスで、各パイプラインとアドインの DLL の **\[発行の状況\]** を **\[含める \(自動\)\]** に設定し、各パイプラインとアドインの DLL の **\[ダウンロード グループ\]** を **\[\(必要\)\]** に設定します。  
+  
+### アプリケーション ベースからのパイプラインとアドインの使用  
+ パイプラインとアドインが [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] 配置用に構成されると、[!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] キャッシュ フォルダーに [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] としてダウンロードされます。  このパイプラインとアドインを [!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] から使用するには、[!INCLUDE[TLA2#tla_xbap](../../../../includes/tla2sharptla-xbap-md.md)] コードがそれらをアプリケーション ベースから取得する必要があります。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルのさまざまな型やメンバーは、パイプラインおよびアドインを使用できるよう、このシナリオ用に特別なサポートを提供しています。  パスは <xref:System.AddIn.Hosting.PipelineStoreLocation> 列挙値で識別されます。  この値を適切なアドイン メンバーのオーバーロードと併用することで、次のようなパイプラインを使用できます。  
+  
+-   <xref:System.AddIn.Hosting.AddInStore.FindAddIns%28System.Type%2CSystem.AddIn.Hosting.PipelineStoreLocation%29?displayProperty=fullName>  
+  
+-   [AddInStore.FindAddIns\(Type, PipelineStoreLocation, String\<xref:System.AddIn.Hosting.AddInStore.FindAddIns%28System.Type%2CSystem.AddIn.Hosting.PipelineStoreLocation%2CSystem.String%5B%5D%29?displayProperty=fullName>  
+  
+-   <xref:System.AddIn.Hosting.AddInStore.Rebuild%28System.AddIn.Hosting.PipelineStoreLocation%29?displayProperty=fullName>  
+  
+-   <xref:System.AddIn.Hosting.AddInStore.Update%28System.AddIn.Hosting.PipelineStoreLocation%29?displayProperty=fullName>  
+  
+### ホストの起点サイトへのアクセス  
+ アドインが起点サイトのファイルを参照できるように、アドインはホスト アプリケーションと等価なセキュリティ分離を使用して読み込む必要があります。  このセキュリティ レベルは <xref:System.AddIn.Hosting.AddInSecurityLevel?displayProperty=fullName> 列挙値により識別され、アドインがアクティブ化されたときに <xref:System.AddIn.Hosting.AddInToken.Activate%2A> メソッドに渡されます。  
+  
+<a name="WPFAddInModelArchitecture"></a>   
+## WPF アドイン アーキテクチャ  
+ これまで見てきたように、最上位のレベルでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用することによって、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドインで、\(<xref:System.Windows.FrameworkElement> から直接または間接的に派生した\) [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を、<xref:System.AddIn.Contract.INativeHandleContract>、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A>、および <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> を使用して実装できます。  その結果、ホスト アプリケーションに <xref:System.Windows.FrameworkElement> が返され、ホスト アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] で表示されます。  
+  
+ 簡単な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] アドイン シナリオでは、開発者に必要な詳細はこれだけです。  より複雑なシナリオ、特にレイアウト、リソース、データ バインドなど、追加 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] サービスの活用を想定したシナリオでは、その利点と制約を把握するために [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をサポートする [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で拡張されるしくみについて詳しい知識が必要です。  
+  
+ 基本的に、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をアドインからホスト アプリケーションに渡しません。その代わり、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の Win32 ウィンドウ ハンドルを [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 相互運用性を使用して渡します。  つまり、アドインの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] がホスト アプリケーションに渡されると、次の処理が行われます。  
+  
+-   アドイン側で、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、ホスト アプリケーションによって表示される [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のウィンドウ ハンドルを取得します。  このウィンドウ ハンドルは、<xref:System.Windows.Interop.HwndSource> から派生し、<xref:System.AddIn.Contract.INativeHandleContract> を実装する内部 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] クラスによってカプセル化されます。  このクラスのインスタンスは、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> によって返され、アドインのアプリケーション ドメインからホスト アプリケーションのアプリケーション ドメインにマーシャリングされます。  
+  
+-   ホスト アプリケーション側では、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は <xref:System.Windows.Interop.HwndSource> を、<xref:System.Windows.Interop.HwndHost> から派生し、<xref:System.AddIn.Contract.INativeHandleContract> を使用する内部 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] クラスとして、再パッケージ化します。  このクラスのインスタンスは、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> によってホスト アプリケーションに返されます。  
+  
+ <xref:System.Windows.Interop.HwndHost> は、ウィンドウ ハンドルによって特定される [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] で表示するために存在します。  詳細については、「[WPF と Win32 の相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-win32-interoperation.md)」を参照してください。  
+  
+ まとめると、<xref:System.AddIn.Contract.INativeHandleContract>、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A>、および <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のウィンドウ ハンドルを、アドインからホスト アプリケーションに渡すために存在します。渡されると、<xref:System.Windows.Interop.HwndHost> によってカプセル化され、ホスト アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を表示します。  
+  
+> [!NOTE]
+>  ホスト アプリケーションは <xref:System.Windows.Interop.HwndHost> を取得するので、ホスト アプリケーションは <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ContractToViewAdapter%2A> から返されるオブジェクトを、アドインによって実装された型 \(<xref:System.Windows.Controls.UserControl> など\) に変換できません。  
+  
+ その特質上、<xref:System.Windows.Interop.HwndHost> には、ホスト アプリケーションの使用に影響する制約があります。  ただし、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、<xref:System.Windows.Interop.HwndHost> をアドイン シナリオ用の一部の機能で拡張します。  その利点と制約について以下に説明します。  
+  
+<a name="WPFAddInModelBenefits"></a>   
+## WPF アドインの利点  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] は、<xref:System.Windows.Interop.HwndHost> から派生する内部クラスを使用してホスト アプリケーションで表示されるため、そのような [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] は、レイアウト、レンダリング、データ バインド、スタイル、テンプレート、リソースなどの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] サービスに関して、<xref:System.Windows.Interop.HwndHost> の機能の制約を受けます。  ただし、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、その内部 <xref:System.Windows.Interop.HwndHost> サブクラスを、次のような追加機能で強化します。  
+  
+-   ホスト アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] とアドインの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] との間を Tab キーで移動できます。  "アドインが [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] である" プログラミング モデルでは、アドインが完全に信頼されているか部分的に信頼されているかに関係なく、アドイン側のアダプターが <xref:System.AddIn.Pipeline.ContractBase.QueryContract%2A> をオーバーライドして、Tab キーによる移動処理を有効にする必要があります。  
+  
+-   ホスト アプリケーション [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] で表示されるアドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] のアクセシビリティ要件を順守します。  
+  
+-   アプリケーション ドメインが複数あるシナリオで [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションが安全に実行されます。  
+  
+-   アドインがセキュリティ分離を使用して実行されている場合 \(部分的に信頼されているセキュリティ サンドボックス\)、アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] ウィンドウ ハンドルへの不正アクセスを回避します。  <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> を呼び出すことでこのセキュリティが保証されます。  
+  
+    -   "アドインが [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を返す" プログラミング モデルで、アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のウィンドウ ハンドルを分離境界を越えて渡す唯一の方法は、<xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> を呼び出すことです。  
+  
+    -   "アドインが [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] である" プログラミング モデルでは、アドイン側のアダプターで <xref:System.AddIn.Pipeline.ContractBase.QueryContract%2A> をオーバーライドして <xref:System.AddIn.Pipeline.FrameworkElementAdapters.ViewToContractAdapter%2A> を呼び出すこと \(前の例に従って\) が、アドイン側のアダプターの `QueryContract` 実装をホスト側のアダプターから呼び出すことに相当する処理として必要です。  
+  
+-   アプリケーション ドメインの実行を何重にも保護します。  アプリケーション ドメインの制約に起因して、アドイン アプリケーション ドメインでスローされた未処理の例外は、分離境界が存在していても、アプリケーション全体のクラッシュにつながります。  ただし、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アドイン モデルおよび [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アドイン モデルは、この問題を回避し、アプリケーションの安定性を向上させる簡単な手段を提供します。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を表示する [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アドインは、ホスト アプリケーションが [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションである場合に、アプリケーション ドメインが実行されているスレッドの <xref:System.Windows.Threading.Dispatcher> を作成します。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アドインの <xref:System.Windows.Threading.Dispatcher> の <xref:System.Windows.Threading.Dispatcher.UnhandledException> イベントを処理することで、アプリケーション ドメインで発生した未処理の例外をすべて検出できます。  <xref:System.Windows.Threading.Dispatcher> は、<xref:System.Windows.Threading.Dispatcher.CurrentDispatcher%2A> プロパティから取得できます。  
+  
+<a name="WPFAddInModelLimitations"></a>   
+## WPF アドインの制約  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、<xref:System.Windows.Interop.HwndSource>、<xref:System.Windows.Interop.HwndHost>、およびウィンドウ ハンドルによる既定の動作に利点をもたらしますが、ホスト アプリケーションで表示されるアドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] に対する制約もあります。  
+  
+-   ホスト アプリケーションで表示されるアドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] では、ホスト アプリケーションのクリッピング動作が考慮されません。  
+  
+-   相互運用性シナリオの*空域*の概念もアドインに適用されます \(「[技術領域の概要](../../../../docs/framework/wpf/advanced/technology-regions-overview.md)」を参照\)。  
+  
+-   リソースの継承、データ バインディング、コマンド実行など、ホスト アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] サービスは、アドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] で自動的に使用可能化されないためです。  このサービスをアドインに提供するには、パイプラインを更新する必要があります。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] に回転、拡大縮小、傾斜などの変換は適用できません \(「[変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)」を参照\)。  
+  
+-   <xref:System.Drawing> 名前空間の描画操作によって描画されるアドイン [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] 内のコンテンツに、アルファ ブレンド効果を含めることができます。  ただし、それを含むアドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] とホスト アプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のいずれも、完全に不透明である必要があります。言い換えると、どちらについても `Opacity` プロパティが 1 に設定されている必要があります。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を含むホスト アプリケーションのウィンドウの <xref:System.Windows.Window.AllowsTransparency%2A> プロパティが `true` の場合、アドインは非表示になります。  このことは、アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が完全に不透明 \(`Opacity` プロパティの値が 1\) の場合にも該当します。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、同じトップレベル ウィンドウ内の他の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 要素より前面に表示する必要があります。  
+  
+-   アドインの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] には、<xref:System.Windows.Media.VisualBrush> を使用して描画できる部分はありません。  その代わり、アドインは生成された [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のスナップショットを取り、コントラクトで定義されているメソッドを使用してホスト アプリケーションに渡すことができるビットマップを作成できます。  
+  
+-   メディア ファイルをアドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 内の <xref:System.Windows.Controls.MediaElement> で再生することはできません。  
+  
+-   ホスト アプリケーションがアドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 用に生成されたマウス イベントを発生させたり、受け取ったりすることはなく、ホスト アプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の `IsMouseOver` プロパティの値は `false` に設定されます。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 内のコントロール間を、フォーカスが移動しても、`GotFocus` イベントおよび `LostFocus` イベントをホスト アプリケーションで受け取ったり、発生したりすることはありません。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を含むホスト アプリケーション部分は、印刷時には白く出力されます。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] によって作成されたすべてのディスパッチャー \(「<xref:System.Windows.Threading.Dispatcher>」を参照\) は、ホスト アプリケーションが実行を継続する場合、オーナー アドインがアンロードされる前に手動でシャットダウンする必要があります。  コントラクトは、アドインがアンロードされる前にホスト アプリケーションがアドインにシグナルを送信するためのメソッドを実装でき、それによりアドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] がそのディスパッチャーをシャットダウンできます。  
+  
+-   アドイン [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が <xref:System.Windows.Controls.InkCanvas> である場合、または <xref:System.Windows.Controls.InkCanvas> を含んでいる場合、そのアドインをアンロードすることはできません。  
+  
+<a name="PerformanceOptimization"></a>   
+## パフォーマンスの最適化  
+ 既定では、複数のアプリケーション ドメインが使用されていると、各アプリケーションで必要とされているさまざまな [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] アセンブリがすべてそのアプリケーションのドメインに読み込まれます。  その結果、新しいアプリケーション ドメインを作成してその中でアプリケーションを起動するために必要な時間がパフォーマンスに影響します。  ただし、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] には、アプリケーションに必要なアセンブリが既に読み込まれている場合に、それをアプリケーション ドメイン間で共有するよう指示することで起動時間を短縮する手段が用意されています。  これを行うには、<xref:System.LoaderOptimizationAttribute> 属性を使用します。これを、エントリ ポイント メソッド \(`Main`\) に適用する必要があります。  この場合、アプリケーション定義を実装するコードのみを使用する必要があります \(「[アプリケーション管理の概要](../../../../docs/framework/wpf/app-development/application-management-overview.md)」を参照\)。  
+  
+## 参照  
+ <xref:System.LoaderOptimizationAttribute>   
+ [アドインおよび拡張機能](../../../../ml/index.xml)   
+ [アプリケーション ドメイン](../../../../docs/framework/app-domains/application-domains.md)   
+ [.NET Framework Remoting Overview](http://msdn.microsoft.com/ja-jp/eccb1d31-0a22-417a-97fd-f4f1f3aa4462)   
+ [Making Objects Remotable](http://msdn.microsoft.com/ja-jp/01197253-3f13-43b7-894d-9683e431192a)   
+ [方法のトピック](../../../../docs/framework/wpf/app-development/how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md b/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md
new file mode 100644
index 00000000000..5431610f8e5
--- /dev/null
+++ b/docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md
@@ -0,0 +1,247 @@
+---
+title: "WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [WPF], files"
+  - "アプリケーション管理 [WPF]"
+  - "コンテンツ ファイル [WPF]"
+  - "埋め込みリソース [WPF]"
+  - "ファイル [WPF]"
+  - "制約が緩いリソース [WPF]"
+  - "参照元アプリケーション ファイル [WPF]"
+  - "リモート ファイル [WPF]"
+  - "リソース ファイル [WPF]"
+  - "起点サイト ファイル [WPF]"
+  - "WPF アプリケーション, files"
+ms.assetid: 7ad2943b-3961-41d3-8fc6-1582d43f5d99
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル
+[!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] アプリケーションは、多くの場面で、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]、イメージ、ビデオ、オーディオなどの実行可能ではないデータを格納したファイルを必要とします。  [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] には、アプリケーション データ ファイルと呼ばれるこれらの種類のデータ ファイルを設定、指定、および使用するための特殊なサポート機能があります。  このサポートの中心となるのは、次の種類のアプリケーション データ ファイルです。  
+  
+-   **リソース ファイル** : コンパイルして実行可能またはライブラリ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アセンブリを作成するためのデータ ファイル。  
+  
+-   **コンテンツ ファイル** : 実行可能 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アセンブリとの明示的な関連付けを持つスタンドアロン データ ファイル。  
+  
+-   **起点サイト ファイル** : 実行可能 [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アセンブリとの関連付けを持たないスタンドアロン データ ファイル。  
+  
+ この 3 種類のファイルの重要な違いは、リソース ファイルとコンテンツ ファイルはビルド時に認識されるという点です。アセンブリは、これらを明確に認識します。  起点サイト ファイルについては、アセンブリはまったく認識しないか、パッケージの[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] 参照を通して暗黙的に認識します。後者の場合、参照される起点サイト ファイルが実際に存在することは保証されません。  
+  
+ アプリケーション データ ファイルを参照するために、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] はパッケージの[!INCLUDE[TLA#tla_uri](../../../../includes/tlasharptla-uri-md.md)] スキームを使用します。このスキームについては、「[WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)」で詳しく説明します。  
+  
+ ここでは、アプリケーション データ ファイルを設定および使用する方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Resource_Files"></a>   
+## リソース ファイル  
+ 特定のアプリケーション データ ファイルを常にアプリケーションで使用できるようにするには、コンパイルしてアプリケーションのメイン実行可能アセンブリまたはその参照アセンブリの 1 つに組み込む必要があります。  この種類のアプリケーション データ ファイルを、*リソース ファイル*と呼びます。  
+  
+ リソース ファイルは、次のときに使用します。  
+  
+-   コンパイルしてアセンブリに組み込んだ後に、リソース ファイルのコンテンツを更新する必要がない。  
+  
+-   アプリケーション配布の複雑さを軽減するために、ファイルの依存関係の数を減らす必要がある。  
+  
+-   アプリケーション データ ファイルをローカライズ可能にする必要がある \(「[WPF のグローバリゼーションおよびローカリゼーションの概要](../../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)」を参照\)。  
+  
+> [!NOTE]
+>  ここで説明するリソース ファイルは [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md) で説明した埋め込まれるとは別の [アプリケーション リソースの管理 \(.NET\)](../Topic/Managing%20Application%20Resources%20\(.NET\).md) のリソース ファイルまたはリンク リソースとは異なります。  
+  
+### リソース ファイルの構成  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、リソース ファイルとは次に示すように [!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] プロジェクトに `Resource` 項目としてインクルードされるファイルです。  
+  
+```  
+<Project "xmlns=http://schemas.microsoft.com/developer/msbuild/2003" ... >  
+  ...  
+  <ItemGroup>  
+    <Resource Include="ResourceFile.xaml" />  
+  </ItemGroup>  
+  ...  
+</Project>  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] では、リソース ファイルを作成するにはファイルをプロジェクトに追加し、その `Build Action` を `Resource` に設定します。  
+  
+ プロジェクトをビルドするときに、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] によってリソースがコンパイルされ、アセンブリに組み込まれます。  
+  
+### リソース ファイルの使用  
+ リソース ファイルを読み込むには、<xref:System.Windows.Application> クラスの <xref:System.Windows.Application.GetResourceStream%2A> メソッドを呼び出し、目的のリソース ファイルを表すパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を渡します。  <xref:System.Windows.Application.GetResourceStream%2A> からは、<xref:System.Windows.Resources.StreamResourceInfo> オブジェクトが返されます。このオブジェクトによってリソース ファイルが <xref:System.IO.Stream> として公開され、そのコンテンツ タイプが記述されます。  
+  
+ 次に示すコードの例では、<xref:System.Windows.Application.GetResourceStream%2A> を使用して <xref:System.Windows.Controls.Page> リソース ファイルを読み込み、<xref:System.Windows.Controls.Frame> \(`pageFrame`\) のコンテンツとして設定する方法を示します。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadAPageResourceFileManuallyCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetResourceStreamSnippetWindow.xaml.cs#loadapageresourcefilemanuallycode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadAPageResourceFileManuallyCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/ApplicationGetResourceStreamSnippetWindow.xaml.vb#loadapageresourcefilemanuallycode)]  
+  
+ <xref:System.Windows.Application.GetResourceStream%2A> を呼び出すと<xref:System.IO.Stream> にアクセスできますが、そのストリームを、設定に使用するプロパティの型に変換する追加作業が必要になります。  代わりに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用して、コードでリソース ファイルをある型のプロパティに直接読み込むことによって <xref:System.IO.Stream> を開いたり変換したりできます。  
+  
+ 次の例は、コードを使用して <xref:System.Windows.Controls.Page> を直接 <xref:System.Windows.Controls.Frame> \(`pageFrame`\) に読み込む方法を示しています。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadPageResourceFileFromCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetResourceStreamSnippetWindow.xaml.cs#loadpageresourcefilefromcode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadPageResourceFileFromCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/ApplicationGetResourceStreamSnippetWindow.xaml.vb#loadpageresourcefilefromcode)]  
+  
+ 次の例は、上の例と同じ意味のマークアップです。  
+  
+ [!code-xml[WPFAssemblyResourcesSnippets#LoadPageResourceFileFromXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetResourceStreamSnippetWindow.xaml#loadpageresourcefilefromxaml)]  
+  
+### リソース ファイルとしてのアプリケーション コード ファイル  
+ ウィンドウ、ページ、フロー ドキュメント、リソース ディクショナリなどのパッケージの [!INCLUDE[TLA2#tla_uri#plural](../../../../includes/tla2sharptla-urisharpplural-md.md)] を使用して参照できる、特殊な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーション コード ファイルがあります。  たとえば、ウィンドウやページを参照するパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を使用して <xref:System.Windows.Application.StartupUri%2A?displayProperty=fullName> プロパティを設定すると、アプリケーションの起動時にそのウィンドウまたはページを読み込むことができます。  
+  
+ [!code-xml[WPFAssemblyResourcesSnippets#SetApplicationStartupURI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/App.xaml#setapplicationstartupuri)]  
+  
+ これを実行できるのは、次に示すように [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルが [!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] プロジェクトに `Page` 項目としてインクルードされている場合です。  
+  
+```  
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ... >  
+  ...  
+  <ItemGroup>  
+    <Page Include="MainWindow.xaml" />  
+  </ItemGroup>  
+  ...  
+</Project>  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] では、新しい <xref:System.Windows.Window>、<xref:System.Windows.Navigation.NavigationWindow>、<xref:System.Windows.Controls.Page>、<xref:System.Windows.Documents.FlowDocument>、または <xref:System.Windows.ResourceDictionary> をプロジェクトに追加したときの、マークアップ ファイルの `Build Action` の既定値は `Page` です。  
+  
+ `Page` 項目を持つプロジェクトがコンパイルされるときに、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] 項目はバイナリ形式に変換され、コンパイルされて対応するアセンブリに組み込まれます。  したがって、これらのファイルは、通常のリソース ファイルと同様に使用できます。  
+  
+> [!NOTE]
+>  `Resource` 項目として構成されている [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルに分離コード ファイルがない場合は、元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] をバイナリに変換したものではなく、元の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] がコンパイルされてアセンブリに組み込まれます。  
+  
+<a name="Content_Files"></a>   
+## コンテンツ ファイル  
+ *コンテンツ ファイル*は、実行可能アセンブリと共に圧縮しないファイルとして配布されます。  コンテンツ ファイルはコンパイルされてアセンブリに組み込まれるのではありませんが、アセンブリのコンパイル時に、各コンテンツ ファイルとの関連付けを確立するメタデータが使用されます。  
+  
+ アプリケーションに必要な特定のアプリケーション データ ファイルが更新されても、そのファイルを使用するアセンブリを再コンパイルしなくて済むようにするには、コンテンツ ファイルを使用します。  
+  
+### コンテンツ ファイルの構成  
+ コンテンツ ファイルをプロジェクトに追加するには、アプリケーション データ ファイルを `Content` 項目としてインクルードする必要があります。  さらに、コンテンツ ファイルはコンパイルされて直接アセンブリに組み込まれるものではないので、ビルド アセンブリからの相対的な場所にコンテンツ ファイルがコピーされることを指定するために [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)]```CopyToOutputDirectory` メタデータ要素を設定する必要があります。  プロジェクトがビルドされるたびにビルド出力フォルダーにリソースがコピーされるようにするには、`CopyToOutputDirectory` メタデータ要素の設定値を `Always` とします。  それ以外の場合は、リソースの最新バージョンだけがビルド出力フォルダーにコピーされるように、`PreserveNewest` 値を使用して設定します。  
+  
+ 次に示すファイルは、新しいバージョンのリソースがプロジェクトに追加された場合にのみビルド出力フォルダーにコピーされるコンテンツ ファイルとして構成されています。  
+  
+```  
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ... >  
+  ...  
+  <ItemGroup>  
+    <Content Include="ContentFile.xaml">  
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>  
+    </Content>  
+  </ItemGroup>  
+  ...  
+</Project>  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] では、コンテンツ ファイルを作成するにはファイルをプロジェクトに追加し、その `Build Action` を `Content` に設定します。また、`Copy to Output Directory` を `Copy always` \(`Always` と同じ\) および `Copy if newer` \(`PreserveNewest` と同じ\) に設定します。  
+  
+ プロジェクトがビルドされるときに、<xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 属性はコンパイルされて次のように各コンテンツ ファイルのアセンブリのメタデータとなります。  
+  
+ `[assembly: AssemblyAssociatedContentFile("ContentFile.xaml")]`  
+  
+ <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 値の意味は、プロジェクト内のコンテンツ ファイルの位置を表す相対パスです。  たとえば、コンテンツ ファイルがプロジェクト サブフォルダー内にある場合は、追加のパス情報が次のように <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 値に組み込まれます。  
+  
+ `[assembly: AssemblyAssociatedContentFile("Resources/ContentFile.xaml")]`  
+  
+ <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> 値は、ビルド出力フォルダー内のコンテンツ ファイルへのパスの値でもあります。  
+  
+### コンテンツ ファイルの使用  
+ コンテンツ ファイルを読み込むには、<xref:System.Windows.Application> クラスの <xref:System.Windows.Application.GetContentStream%2A> メソッドを呼び出し、目的のコンテンツ ファイルを表すパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を渡します。  <xref:System.Windows.Application.GetContentStream%2A> からは、<xref:System.Windows.Resources.StreamResourceInfo> オブジェクトが返されます。このオブジェクトによってコンテンツ ファイルが <xref:System.IO.Stream> として公開され、そのコンテンツ タイプが記述されます。  
+  
+ 次に示すコードの例では、<xref:System.Windows.Application.GetContentStream%2A> を使用して <xref:System.Windows.Controls.Page> コンテンツ ファイルを読み込み、<xref:System.Windows.Controls.Frame> \(`pageFrame`\) のコンテンツとして設定する方法を示します。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadAPageContentFileManuallyCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetContentStreamSnippetWindow.xaml.cs#loadapagecontentfilemanuallycode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadAPageContentFileManuallyCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/ApplicationGetContentStreamSnippetWindow.xaml.vb#loadapagecontentfilemanuallycode)]  
+  
+ <xref:System.Windows.Application.GetContentStream%2A> を呼び出すと<xref:System.IO.Stream> にアクセスできますが、そのストリームを、設定に使用するプロパティの型に変換する追加作業が必要になります。  代わりに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用して、コードでリソース ファイルをある型のプロパティに直接読み込むことによって <xref:System.IO.Stream> を開いたり変換したりできます。  
+  
+ 次の例は、コードを使用して <xref:System.Windows.Controls.Page> を直接 <xref:System.Windows.Controls.Frame> \(`pageFrame`\) に読み込む方法を示しています。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadPageContentFileFromCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetContentStreamSnippetWindow.xaml.cs#loadpagecontentfilefromcode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadPageContentFileFromCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/ApplicationGetContentStreamSnippetWindow.xaml.vb#loadpagecontentfilefromcode)]  
+  
+ 次の例は、上の例と同じ意味のマークアップです。  
+  
+ [!code-xml[WPFAssemblyResourcesSnippets#LoadPageContentFileFromXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/ApplicationGetContentStreamSnippetWindow.xaml#loadpagecontentfilefromxaml)]  
+  
+<a name="Site_of_Origin_Files"></a>   
+## 起点サイト ファイル  
+ リソース ファイルは、共に配布されるアセンブリとの間に明示的な関係を持っており、この関係は <xref:System.Windows.Resources.AssemblyAssociatedContentFileAttribute> で定義されます。  ただし、実際のアプリケーション開発では、アセンブリとアプリケーション データ ファイル間に暗黙的な関係を持たせる、あるいは関係を持たせないようにすることがあります。たとえば次のような場合です。  
+  
+-   コンパイル時にファイルが存在しない場合。  
+  
+-   アセンブリが必要とするファイルが、実行時までわからない場合。  
+  
+-   関連付けられているアセンブリを再コンパイルせずにファイルを更新できるようにする場合。  
+  
+-   オーディオやビデオなど大容量のデータ ファイルを使用するアプリケーションで、ユーザーが選択した場合にのみファイルがダウンロードされるようにする場合。  
+  
+ このような種類のファイルを、file:\/\/\/ スキームや http:\/\/ スキームなど、従来の [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] スキームを使用して読み込むこともできます。  
+  
+ [!code-xml[WPFAssemblyResourcesSnippets#AbsolutePackUriFileHttpReferenceXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/AbsolutePackUriPage.xaml#absolutepackurifilehttpreferencexaml)]  
+  
+ ただし、file:\/\/\/ スキームや http:\/\/ スキームを使用する場合は、アプリケーションに完全信頼が必要です。  アプリケーションが、インターネットまたはイントラネットから起動された [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] であり、その場所から起動されたアプリケーションに対して許可されるアクセス許可のみをアプリケーションが要求する場合は、アプリケーションの起点サイト \(起動場所\) からのみ圧縮しないファイルを読み込むことができます。  このようなファイルを、*起点サイト ファイル*と呼びます。  
+  
+ 起点サイト ファイルは部分信頼アプリケーションの唯一のオプションですが、部分信頼アプリケーション以外でも使用できます。  完全信頼アプリケーションでも、読み込むアプリケーション データ ファイルがビルド時点では不明な場合があります。完全信頼アプリケーションでは file:\/\/\/ を使用できますが、アプリケーション データ ファイルがアプリケーション アセンブリと同じフォルダーにインストールされることも、サブフォルダーにインストールされることも考えられます。  この場合は、起点サイト参照を使用する方が、file:\/\/\/ を使用するよりも簡単です。file:\/\/\/ を使用するには、ファイルの完全パスを指定する必要があるからです。  
+  
+> [!NOTE]
+>  起点サイト ファイルは、コンテンツ ファイルとは異なり、クライアント コンピューターの [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] でキャッシュされません。  したがって、起点サイト ファイルは明確に要求されたときにのみダウンロードされます。  [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] アプリケーションで使用する大容量のメディア ファイルを起点サイト ファイルとして構成すると、アプリケーションの最初の起動時間が大幅に短縮され、ファイルは要求されたときにのみダウンロードされるようになります。  
+  
+### 起点サイト ファイルの構成  
+ 起点サイト ファイルがコンパイル時に存在しない場合や不明な場合は、従来の配置機構 \(`XCopy` コマンド ライン プログラム、[!INCLUDE[TLA#tla_wininstall](../../../../includes/tlasharptla-wininstall-md.md)] など\) を使用して、必要なファイルが実行時には使用可能になっているようにする必要があります。  
+  
+ 起点サイトに配置されるファイルがコンパイル時にわかっているけれども、明示的な依存関係を持たせないようにするには、そのファイルを [!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] プロジェクトに `None` 項目として追加します。  コンテンツ ファイルと同様に、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] の `CopyToOutputDirectory` 属性を設定して、ビルド アセンブリからの相対位置に起点サイト ファイルがコピーされることを指定する必要があります。値は、`Always` または `PreserveNewest` を指定します。  
+  
+```  
+<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ... >  
+  ...  
+  <None Include="PageSiteOfOriginFile.xaml">  
+    <CopyToOutputDirectory>Always</CopyToOutputDirectory>  
+  </None>  
+  ...  
+</Project>  
+```  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] では、起点サイト ファイルを作成するにはファイルをプロジェクトに追加し、その `Build Action` を `None` に設定します。  
+  
+ プロジェクトをビルドするときに、指定したファイルが [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] によってビルド出力フォルダーにコピーされます。  
+  
+### 起点サイト ファイルの使用  
+ 起点サイト ファイルを読み込むには、<xref:System.Windows.Application> クラスの <xref:System.Windows.Application.GetRemoteStream%2A> メソッドを呼び出し、目的の起点サイト ファイルを表すパッケージの [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] を渡します。  <xref:System.Windows.Application.GetRemoteStream%2A> からは、<xref:System.Windows.Resources.StreamResourceInfo> オブジェクトが返されます。このオブジェクトによって起点サイト ファイルが <xref:System.IO.Stream> として公開され、そのコンテンツ タイプが記述されます。  
+  
+ 次に示すコードの例では、<xref:System.Windows.Application.GetRemoteStream%2A> を使用して <xref:System.Windows.Controls.Page> 起点サイト ファイルを読み込み、<xref:System.Windows.Controls.Frame> \(`pageFrame`\) のコンテンツとして設定する方法を示します。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadAPageSOOFileManuallyCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/SOOPage.xaml.cs#loadapagesoofilemanuallycode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadAPageSOOFileManuallyCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/SOOPage.xaml.vb#loadapagesoofilemanuallycode)]  
+  
+ <xref:System.Windows.Application.GetRemoteStream%2A> を呼び出すと<xref:System.IO.Stream> にアクセスできますが、そのストリームを、設定に使用するプロパティの型に変換する追加作業が必要になります。  代わりに、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用して、コードでリソース ファイルをある型のプロパティに直接読み込むことによって <xref:System.IO.Stream> を開いたり変換したりできます。  
+  
+ 次の例は、コードを使用して <xref:System.Windows.Controls.Page> を直接 <xref:System.Windows.Controls.Frame> \(`pageFrame`\) に読み込む方法を示しています。  
+  
+ [!code-csharp[WPFAssemblyResourcesSnippets#LoadPageSOOFileFromCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/SOOPage.xaml.cs#loadpagesoofilefromcode)]
+ [!code-vb[WPFAssemblyResourcesSnippets#LoadPageSOOFileFromCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/VisualBasic/ResourcesSample/SOOPage.xaml.vb#loadpagesoofilefromcode)]  
+  
+ 次の例は、上の例と同じ意味のマークアップです。  
+  
+ [!code-xml[WPFAssemblyResourcesSnippets#LoadPageSOOFileFromXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFAssemblyResourcesSnippets/CSharp/ResourcesSample/SOOPage.xaml#loadpagesoofilefromxaml)]  
+  
+<a name="Rebuilding_after_Changing_Build_Type"></a>   
+## ビルド タイプ変更後の再ビルド  
+ アプリケーション データ ファイルのビルド タイプを変更した後は、変更を確実に反映するためにアプリケーション全体を再ビルドする必要があります。  アプリケーションのみをビルドしても、変更は適用されません。  
+  
+## 参照  
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md b/docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md
new file mode 100644
index 00000000000..76c2c486720
--- /dev/null
+++ b/docs/framework/wpf/app-development/wpf-host-presentationhost-exe.md
@@ -0,0 +1,68 @@
+---
+title: "WPF ホスト (PresentationHost.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PresentationHost.exe"
+  - "WPF ホスト アプリケーション"
+ms.assetid: 3215bfa1-722c-4ac8-a7c5-bdd02d30afbd
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# WPF ホスト (PresentationHost.exe)
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] ホスト \(PresentationHost.exe\) は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションを互換ブラウザー \([!INCLUDE[TLA#tla_ie6](../../../../includes/tlasharptla-ie6-md.md)] およびそれ以降を含む\) でホストできるようにするアプリケーションです。  既定では、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] ホストは、ブラウザーによってホストされる [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] コンテンツのシェルおよび [!INCLUDE[TLA2#tla_mime](../../../../includes/tla2sharptla-mime-md.md)] ハンドラーとして登録されます。該当するコンテンツには、次のものが含まれます。  
+  
+-   Loose である \(コンパイルされていない\) [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル \(.xaml\)。  
+  
+-   [!INCLUDE[TLA#tla_xbap](../../../../includes/tlasharptla-xbap-md.md)] \(.xbap\)。  
+  
+ これらの種類のファイルに対して、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] ホストは、次の処理を実行します。  
+  
+-   [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] コンテンツをホストするために、登録されている [!INCLUDE[TLA2#tla_html](../../../../includes/tla2sharptla-html-md.md)] ハンドラーを起動します。  
+  
+-   必要な[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] および [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アセンブリの正しいバージョンを読み込みます。  
+  
+-   展開のゾーンに適切なアクセス許可レベルが設定されるようにします。  
+  
+ ここでは、PresentationHost.exe で使用できるコマンド ライン パラメーターについて説明します。  
+  
+## 使用方法  
+ `PresentationHost.exe [parameters] uri|filename`  
+  
+## パラメーター  
+  
+|パラメーター|Description|  
+|------------|-----------------|  
+|filename|アクティブにするファイルのパス。  [!INCLUDE[TLA2#tla_uri](../../../../includes/tla2sharptla-uri-md.md)] も指定できます。|  
+|\-debug|アプリケーションをアクティブにする場合に、このアプリケーションをストアにコミットしたり、ストアから実行しません。  これは、ローカル ファイルをアクティブにする場合に限って使用できます。|  
+|\-debugSecurityZoneURL \<url\>|アプリケーションを、指定した [!INCLUDE[TLA2#tla_url](../../../../includes/tla2sharptla-url-md.md)] から展開されたものとしてデバッグする必要があることを PresentationHost.exe に指示するために、[!INCLUDE[TLA2#tla_url](../../../../includes/tla2sharptla-url-md.md)] 値と共に使用します。  これは、展開ゾーンと起点サイトの両方を決定します。|  
+|\-embedding|OLE で必要になります。  `-event` または `-debug` パラメーターを指定した場合、`-embedding` パラメーターは内部で設定されるため、指定する必要はありません。|  
+|\-event \<eventname\>|PresentationHost.exe が初期化され、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] コンテンツをホストする準備ができた時点で、この名前のイベントを開き、シグナルを送信します。  PresentationHost.exe は、イベントを開く際にエラーが発生すると \(そのイベントがまだ作成されていない場合など\) 終了します。|  
+|\-launchApplication \<url\>|指定した URL から、スタンドアロンの [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] アプリケーションを起動します。  .NET アプリケーションに関する [!INCLUDE[TLA2#tla_iegeneric](../../../../includes/tla2sharptla-iegeneric-md.md)] および WinINet のセキュリティ ポリシーが適用されます。|  
+  
+## シナリオ  
+  
+### シェル ハンドラー  
+ `PresentationHost.exe example.xbap`  
+  
+### MIME ハンドラー  
+ `PresentationHost.exe -embedding example.xbap`  
+  
+### Visual Studio によるデバッグ  
+ `PresentationHost.exe -debug example.xbap`  
+  
+### Visual Studio によるゾーンでのデバッグ  
+ `PresentationHost.exe -debug -debugSecurityZoneURL http://www.example.com c:\folderpath\example.xbap`  
+  
+## 参照  
+ [セキュリティ](../../../../docs/framework/wpf/security-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/wpf-windows-overview.md b/docs/framework/wpf/app-development/wpf-windows-overview.md
new file mode 100644
index 00000000000..f00a1913772
--- /dev/null
+++ b/docs/framework/wpf/app-development/wpf-windows-overview.md
@@ -0,0 +1,508 @@
+---
+title: "WPF ウィンドウの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, ホスティング"
+  - "コンテンツ, 表示"
+  - "コンテンツ, 表示 (手続き型コードによる)"
+  - "コンテンツ, 表示 (XAML による)"
+  - "作成, ウィンドウ"
+  - "ダイアログ ボックス"
+  - "表示 (コンテンツを)"
+  - "表示 (手続き型コードによるコンテンツの)"
+  - "表示 (XAML ページを)"
+  - "イベント"
+  - "ホスティング, アプリケーション"
+  - "管理 (ウィンドウを)"
+  - "モーダル ダイアログ ボックス"
+  - "モーダル ウィンドウ"
+  - "NavigationWindow オブジェクト"
+  - "Page オブジェクト"
+  - "手続き型コード, コンテンツの表示"
+  - "ウィンドウ イベント"
+  - "ウィンドウ管理"
+  - "ウィンドウ オブジェクト"
+  - "ウィンドウ"
+  - "XAML ページ, 表示"
+  - "XAML, コンテンツの表示"
+ms.assetid: 737d04ec-8861-46c3-8d44-fa11d3528d23
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 60
+---
+# WPF ウィンドウの概要
+ユーザーは、ウィンドウをとおして [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] スタンドアロン アプリケーションとやり取りします。  ウィンドウの主な目的は、データを視覚化してユーザーがデータと対話できるようにするコンテンツをホストすることです。スタンドアロンの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションには、<xref:System.Windows.Window> クラスを使用した独自のウィンドウがあります。  ここでは、<xref:System.Windows.Window> について説明してから、スタンドアロン アプリケーションにおけるウィンドウの作成と管理の基本について説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] や Loose [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] のページなど、ブラウザーによってホストされる [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションには、独自のウィンドウはありません。  その代わり、[!INCLUDE[TLA#tla_iegeneric](../../../../includes/tlasharptla-iegeneric-md.md)] で提供されるウィンドウでホストされます。  「[WPF XAML ブラウザー アプリケーションの概要](../../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」を参照してください。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="TheWindowClass"></a>   
+## ウィンドウ クラス  
+ 次の図は、ウィンドウの構成部品を示しています。  
+  
+ ![ウィンドウ要素](../../../../docs/framework/wpf/app-development/media/windowoverviewfigure1.PNG "WindowOverviewFigure1")  
+  
+ ウィンドウは、非クライアント領域とクライアント領域の 2 つに分かれます。  
+  
+ ウィンドウの*非クライアント領域*は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] によって実装され、多くのウィンドウに共通のウィンドウ部品が含まれます。これらの部品には次のものがあります。  
+  
+-   境界線  
+  
+-   タイトル バー  
+  
+-   アイコン  
+  
+-   最小化ボタン、最大化ボタン、および復元ボタン  
+  
+-   閉じるボタン。  
+  
+-   ウィンドウを最小化、最大化、元のサイズに戻す、移動、サイズ変更、および閉じるためのメニュー項目を含むシステム メニュー。  
+  
+ ウィンドウの*クライアント領域*は、ウィンドウの非クライアント領域の内側の領域であり、開発者が使用して、メニュー バー、ツール バー、コントロールなどのアプリケーション固有のコンテンツを追加します。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、ウィンドウは <xref:System.Windows.Window> クラスでカプセル化され、これにより以下の操作を行うことができます。  
+  
+-   ウィンドウを表示する。  
+  
+-   ウィンドウのサイズ、位置、および外観を構成する。  
+  
+-   アプリケーション固有のコンテンツをホストする。  
+  
+-   ウィンドウの有効期間を管理する。  
+  
+<a name="DefiningAWindow"></a>   
+## ウィンドウの実装  
+ 一般的なウィンドウの実装は、外観と動作で構成されます。*外観*では、ユーザーに対するウィンドウの表示方法を定義します。*動作*では、ユーザーがウィンドウと対話するときにウィンドウが機能を果たす方法を定義します。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、コードまたは [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップを使用して、ウィンドウの外観と動作を実装できます。  
+  
+ ただし、通常は、次の例に示すように、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップを使用してウィンドウの外観を実装し、分離コードを使用してウィンドウの動作を実装します。  
+  
+ [!code-xml[WindowsOverviewSnippets#MarkupAndCodeBehindWindowMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/MarkupAndCodeBehindWindow.xaml#markupandcodebehindwindowmarkup)]  
+  
+ [!code-csharp[WindowsOverviewSnippets#MarkupAndCodeBehindWindowCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/MarkupAndCodeBehindWindow.xaml.cs#markupandcodebehindwindowcodebehind)]
+ [!code-vb[WindowsOverviewSnippets#MarkupAndCodeBehindWindowCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowsOverviewSnippets/VisualBasic/MarkupAndCodeBehindWindow.xaml.vb#markupandcodebehindwindowcodebehind)]  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップ ファイルと分離コード ファイルを連携させるには、次のことが必要です。  
+  
+-   マークアップの `Window` 要素に、`x:Class` 属性を含める必要があります。  アプリケーションのビルド時にマークアップ ファイルに `x:Class` 属性が含まれていると、[!INCLUDE[TLA#tla_msbuild](../../../../includes/tlasharptla-msbuild-md.md)] は、`x:Class` 属性で指定された名前を持つ、<xref:System.Windows.Window> から派生した`partial`クラスを作成します。  そのためには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] スキーマ \(`xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`\) に [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間宣言を追加する必要があります。  生成された`partial`クラスは `InitializeComponent` メソッドを実装します。このメソッドを呼び出すとイベントが登録され、マークアップで実装されるプロパティが設定されます。  
+  
+-   分離コードでは、クラスは、マークアップ内の `x:Class` 属性で指定されている名前を持つ`partial`クラスでなければなりません。また、<xref:System.Windows.Window> から派生する必要があります。  これによって、分離コード ファイルと、アプリケーションのビルド時にマークアップ ファイル用に生成される`partial`クラスとが関連付けられます \(「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照\)。  
+  
+-   分離コードでは、<xref:System.Windows.Window> クラスが実装するコンストラクターで `InitializeComponent` メソッドを呼び出す必要があります。  `InitializeComponent` は、マークアップ ファイル用に生成された `partial` クラスによって実装されるもので、イベントの登録と、マークアップで定義されたプロパティの設定を実行します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用してプロジェクトに新しい <xref:System.Windows.Window> を追加すると、ここで説明したように、マークアップと分離コードの両方を使用して <xref:System.Windows.Window> が実装され、マークアップ ファイルと分離コード ファイル間の関連付けの作成に必要な構成が組み込まれます。  
+  
+ この構成が組み込まれると、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップでウィンドウの外観を定義し、分離コードでウィンドウの動作を実装することに集中できます。  ボタンを含むウィンドウを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップで実装し、そのボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントのイベント ハンドラーを分離コードで実装する例を次に示します。  
+  
+ [!code-xml[WindowsOverviewWindowWithButtonSnippets#MarkupAndCodeBehindWindowMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewWindowWithButtonSnippets/CSharp/MarkupAndCodeBehindWindow.xaml#markupandcodebehindwindowmarkup)]  
+  
+ [!code-csharp[WindowsOverviewWindowWithButtonSnippets#MarkupAndCodeBehindWindowCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewWindowWithButtonSnippets/CSharp/MarkupAndCodeBehindWindow.xaml.cs#markupandcodebehindwindowcodebehind)]
+ [!code-vb[WindowsOverviewWindowWithButtonSnippets#MarkupAndCodeBehindWindowCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowsOverviewWindowWithButtonSnippets/VisualBasic/MarkupAndCodeBehindWindow.xaml.vb#markupandcodebehindwindowcodebehind)]  
+  
+<a name="ConfiguringWindowForMSBuild"></a>   
+## MSBuild 用のウィンドウ定義の構成  
+ ウィンドウを実装する方法によって、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] を構成する方法が決定します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップと分離コードの両方を使用して定義したウィンドウには、次の要件があります。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップ ファイルは、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] の `Page` 項目として構成する必要があります。  
+  
+-   分離コード ファイルは、[!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] の `Compile` 項目として構成する必要があります。  
+  
+ これを次の [!INCLUDE[TLA2#tla_msbuild](../../../../includes/tla2sharptla-msbuild-md.md)] プロジェクト ファイルに示します。  
+  
+```  
+<Project ... xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
+    ...  
+    <Page Include="MarkupAndCodeBehindWindow.xaml" />  
+    <Compile Include=" MarkupAndCodeBehindWindow.xaml.cs" />  
+    ...  
+</Project>  
+```  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションのビルドの詳細については、「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照してください。  
+  
+<a name="WindowLifetime"></a>   
+## ウィンドウの有効期間  
+ クラスと同様に、ウィンドウにも有効期間があります。有効期間は、ウィンドウが開いてインスタンス化されたときに開始し、アクティブ化と非アクティブ化を経て、最後に閉じられるまで継続します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Opening_a_Window"></a>   
+### ウィンドウを開く  
+ ウィンドウを開くには、次の例に示すように最初にインスタンスを作成します。  
+  
+ [!code-xml[WindowsOverviewStartupEventSnippets#AppMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewStartupEventSnippets/CSharp/App.xaml#appmarkup)]  
+  
+ [!code-csharp[WindowsOverviewStartupEventSnippets#AppCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewStartupEventSnippets/CSharp/App.xaml.cs#appcodebehind)]  
+  
+ この例では、<xref:System.Windows.Application.Startup> イベントが発生してアプリケーションが起動するときに `MarkupAndCodeBehindWindow` がインスタンス化されます。  
+  
+ ウィンドウがインスタンス化されると、<xref:System.Windows.Application> オブジェクトが管理するウィンドウのリストにそのウィンドウへの参照が自動的に追加されます \(<xref:System.Windows.Application.Windows%2A?displayProperty=fullName> を参照\)。  さらに、インスタンス化される最初のウィンドウは、既定で <xref:System.Windows.Application> によってメイン アプリケーション ウィンドウとして設定されます \(<xref:System.Windows.Application.MainWindow%2A?displayProperty=fullName> を参照\)。  
+  
+ 最後に <xref:System.Windows.Window.Show%2A> メソッドを呼び出すことによってウィンドウが開き、次の図に示すような結果になります。  
+  
+ ![Window.Show の呼び出しによって開いたウィンドウ](../../../../docs/framework/wpf/app-development/media/windowoverviewfigure8.png "WindowOverviewFigure8")  
+  
+ <xref:System.Windows.Window.Show%2A> を呼び出すことによって開いたウィンドウは、モードレス ウィンドウです。これは、ユーザーが同じアプリケーションで他のウィンドウをアクティブ化できるモードでアプリケーションが動作することを意味します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Window.ShowDialog%2A> は、ダイアログ ボックスなどのウィンドウをモーダルで開くために呼び出されます。  詳細については、「[ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Window.Show%2A> を呼び出すと、ウィンドウは表示される前に初期化処理を実行して、ユーザーの入力を受け取ることのできるインフラストラクチャを確立します。  ウィンドウが初期化されると、<xref:System.Windows.Window.SourceInitialized> イベントが発生し、ウィンドウが表示されます。  
+  
+ 簡単な方法として、<xref:System.Windows.Application.StartupUri%2A> を設定して、アプリケーションの起動時に自動的に開く最初のウィンドウを指定できます。  
+  
+ [!code-xml[WindowsOverviewSnippets#ApplicationStartupUriMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/App.xaml#applicationstartupurimarkup)]  
+  
+ アプリケーションが起動したら、<xref:System.Windows.Application.StartupUri%2A> の値で指定されたウィンドウがモードレスで開きます。内部的には、ウィンドウはその <xref:System.Windows.Window.Show%2A> メソッドを呼び出すことによって開きます。  
+  
+<a name="Ownership"></a>   
+#### ウィンドウの所有権  
+ <xref:System.Windows.Window.Show%2A> メソッドを使用して開いたウィンドウと、そのウィンドウを作成したウィンドウには、暗黙的な関係はありません。ユーザーは、どちらのウィンドウとも、もう一方のウィンドウに関係なく対話できます。つまり、どちらのウィンドウでも次の作業ができます。  
+  
+-   もう一方のウィンドウの上に表示する \(いずれかのウィンドウの <xref:System.Windows.Window.Topmost%2A> プロパティが `true` に設定されている場合を除く\)。  
+  
+-   もう一方のウィンドウに影響を与えずに、最小化し、最大化し、元のサイズに戻す。  
+  
+ 一部のウィンドウには、そのウィンドウを開いたウィンドウとの関係が必要です。  たとえば、[!INCLUDE[TLA#tla_ide](../../../../includes/tlasharptla-ide-md.md)] アプリケーションでは、プロパティ ウィンドウやツール ウィンドウのように、一般的に作成元のウィンドウの上に表示されるウィンドウが開く場合があります。  また、そのようなウィンドウは、必ず作成元のウィンドウと一緒に閉じ、最小化し、最大化し、元のサイズに戻す必要があります。  このような関係を確立するには、あるウィンドウが別のウィンドウを*所有する*ようにします。そのためには、*所有されているウィンドウ*の <xref:System.Windows.Window.Owner%2A> プロパティに、*オーナー ウィンドウ*への参照を設定します。  これを次の例に示します。  
+  
+ [!code-csharp[WindowOwnerOwnedWindowsSnippets#SetWindowOwnerCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowOwnerOwnedWindowsSnippets/CSharp/MainWindow.xaml.cs#setwindowownercode)]
+ [!code-vb[WindowOwnerOwnedWindowsSnippets#SetWindowOwnerCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowOwnerOwnedWindowsSnippets/visualbasic/mainwindow.xaml.vb#setwindowownercode)]  
+  
+ 所有権が確立されると、次のようになります。  
+  
+-   所有されているウィンドウは <xref:System.Windows.Window.Owner%2A> プロパティの値を調べることによって、オーナー ウィンドウを参照できます。  
+  
+-   オーナー ウィンドウは、<xref:System.Windows.Window.OwnedWindows%2A> プロパティの値を調べることによって、所有するすべてのウィンドウを検出できます。  
+  
+<a name="Preventing"></a>   
+#### ウィンドウのアクティブ化の防止  
+ 表示されてもアクティブにしないことが適切なウィンドウもあります。インターネット メッセンジャーのようなアプリケーションの対話ウィンドウや、電子メール アプリケーションの通知ウィンドウなどです。  
+  
+ 表示されたときにアクティブにしないウィンドウがアプリケーションにある場合は、<xref:System.Windows.Window.Show%2A> メソッドの初回呼び出し前に、<xref:System.Windows.Window.ShowActivated%2A> プロパティを `false` に設定します。  結果は次のようになります。  
+  
+-   ウィンドウはアクティブになりません。  
+  
+-   ウィンドウの <xref:System.Windows.Window.Activated> イベントは発生しません。  
+  
+-   現在アクティブなウィンドウは、アクティブのままです。  
+  
+ ただし、ユーザーがクライアント領域または非クライアント領域をクリックすると、ウィンドウは直ちにアクティブになります。  この場合、結果は次のようになります。  
+  
+-   ウィンドウはアクティブになります。  
+  
+-   ウィンドウの <xref:System.Windows.Window.Activated> イベントが発生します。  
+  
+-   直前にアクティブだったウィンドウは非アクティブになります。  
+  
+-   その後、ウィンドウの <xref:System.Windows.Window.Deactivated> および <xref:System.Windows.Window.Activated> イベントが、ユーザーの操作への応答として発生します。  
+  
+<a name="Window_Activation"></a>   
+### ウィンドウのアクティブ化  
+ ウィンドウを最初に開いたときは、そのウィンドウがアクティブ ウィンドウになります \(<xref:System.Windows.Window.ShowActivated%2A> が `false` に設定されている場合を除く\)。  *アクティブ ウィンドウ*は、キー ストロークやマウス クリックなどのユーザー入力を現在キャプチャしているウィンドウです。  ウィンドウがアクティブになると、<xref:System.Windows.Window.Activated> イベントが発生します。  
+  
+> [!NOTE]
+>  ウィンドウが最初に開くとき、<xref:System.Windows.FrameworkElement.Loaded> イベントおよび <xref:System.Windows.Window.ContentRendered> イベントは、<xref:System.Windows.Window.Activated> イベントが発生した後にのみ発生します。  そのため、ウィンドウは <xref:System.Windows.Window.ContentRendered> が発生した場合にのみ開いたと見なされます。  
+  
+ ウィンドウがアクティブになった後で、ユーザーは同じアプリケーションの別のウィンドウをアクティブ化したり、別のアプリケーションをアクティブ化したりできます。  このとき、現在アクティブなウィンドウが非アクティブ化され、<xref:System.Windows.Window.Deactivated> イベントが発生します。  同様に、ユーザーが現在非アクティブなウィンドウを選択すると、ウィンドウは再びアクティブになり、<xref:System.Windows.Window.Activated> が発生します。  
+  
+ 一般に、<xref:System.Windows.Window.Activated> と <xref:System.Windows.Window.Deactivated> を処理するのは、ウィンドウがアクティブなときにのみ実行できる機能を有効または無効にするためです。  たとえば、ゲームやビデオ プレーヤーなど、ユーザーの一定の入力や介入が必要な双方向コンテンツが表示されるウィンドウがあります。  この動作を実装するために <xref:System.Windows.Window.Activated> および <xref:System.Windows.Window.Deactivated> を処理する方法を、次の簡単なビデオ プレーヤーの例で示します。  
+  
+ [!code-xml[WindowsOverviewSnippets#ActivationDeactivationMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/CustomMediaPlayerWindow.xaml#activationdeactivationmarkup)]  
+  
+ [!code-csharp[WindowsOverviewSnippets#ActivationDeactivationCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/CustomMediaPlayerWindow.xaml.cs#activationdeactivationcodebehind)]
+ [!code-vb[WindowsOverviewSnippets#ActivationDeactivationCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowsOverviewSnippets/VisualBasic/CustomMediaPlayerWindow.xaml.vb#activationdeactivationcodebehind)]  
+  
+ ウィンドウが非アクティブでも、バックグラウンドでコードを実行できるアプリケーションもあります。  たとえば、メール クライアントは、ユーザーが他のアプリケーションを使用している間もメール サーバーへのポーリングを続けています。  このようなアプリケーションは、メイン ウィンドウが非アクティブのときにも、別の動作や追加の動作を頻繁に実行します。  メール プログラムでは、新規のメールを受信トレイに追加し、システム トレイに通知アイコンを追加することがあります。  通知アイコンは、メール ウィンドウがアクティブでないときにのみ表示する必要があります。メール ウィンドウがアクティブかどうかは、<xref:System.Windows.Window.IsActive%2A> プロパティを調べることで確認できます。  
+  
+ バックグラウンド タスクの完了時に、ユーザーに緊急に通知する必要がある場合は、<xref:System.Windows.Window.Activate%2A> メソッドを呼び出します。  <xref:System.Windows.Window.Activate%2A> を呼び出したときに、ユーザーが別のアクティブなアプリケーションと対話している場合は、ウィンドウのタスク バー ボタンが点滅します。  ユーザーが現在のアプリケーションと対話している場合は、<xref:System.Windows.Window.Activate%2A> を呼び出すと、ウィンドウが前面に表示されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Application.Activated?displayProperty=fullName> イベントおよび <xref:System.Windows.Application.Deactivated?displayProperty=fullName> イベントを使用して、アプリケーション スコープのアクティベーションを処理できます。  
+  
+<a name="Closing_a_Window"></a>   
+### ウィンドウを閉じる  
+ ウィンドウの有効期間は、表示されたときに開始し、ユーザーが閉じたときに終了します。  ウィンドウを閉じるには、非クライアント領域の要素を使用します。これには、次のものが含まれます。  
+  
+-   **システム** メニューの **\[閉じる\]** 項目。  
+  
+-   Alt キーを押しながら F4 キーを押す。  
+  
+-   **閉じる**ボタン。  
+  
+ クライアント領域に機構を追加してウィンドウを閉じることもできます。その一般的な例を次に示します。  
+  
+-   一般にメイン アプリケーション ウィンドウにある、**\[ファイル\]** メニューの **\[終了\]** 項目。  
+  
+-   一般にアプリケーションの 2 次ウィンドウにある、**\[ファイル\]** メニューの **\[閉じる\]** 項目。  
+  
+-   一般にモーダル ダイアログ ボックスにある **\[キャンセル\]** ボタン。  
+  
+-   一般にモードレス ダイアログ ボックスにある**閉じる**ボタン。  
+  
+ これらのカスタム機構に対応したウィンドウを閉じるには、<xref:System.Windows.Window.Close%2A> メソッドを呼び出す必要があります。  **\[ファイル\]** メニューの **\[終了\]** をクリックすることでウィンドウを閉じる機能を実装する方法を、次の例に示します。  
+  
+ [!code-xml[WindowsOverviewSnippets#WindowWithFileExitMARKUP](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowWithFileExit.xaml#windowwithfileexitmarkup)]  
+  
+ [!code-csharp[WindowsOverviewSnippets#WindowWithFileExitCODEBEHIND](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowWithFileExit.xaml.cs#windowwithfileexitcodebehind)]
+ [!code-vb[WindowsOverviewSnippets#WindowWithFileExitCODEBEHIND](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowsOverviewSnippets/VisualBasic/WindowWithFileExit.xaml.vb#windowwithfileexitcodebehind)]  
+  
+ ウィンドウが閉じるとき、<xref:System.Windows.Window.Closing> と <xref:System.Windows.Window.Closed> の 2 つのイベントが発生します。  
+  
+ <xref:System.Windows.Window.Closing> はウィンドウが閉じる前に発生し、ウィンドウが閉じるのを防ぐことができる機構を提供します。  ウィンドウが閉じるのを防ぐのは、一般的に、ウィンドウ コンテンツに変更したデータが含まれている場合です。  この場合、<xref:System.Windows.Window.Closing> イベントを処理して、データが変更されているかどうかを確認できます。変更されている場合は、ユーザーにデータを保存しないでウィンドウを閉じるか、またはウィンドウを閉じる操作をキャンセルするかどうかを確認できます。  <xref:System.Windows.Window.Closing> を処理するときの要点を次の例に示します。  
+  
+ [!code-csharp[WindowClosingSnippets#WindowClosingCODEBEHIND1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowClosingSnippets/CSharp/DataWindow.xaml.cs#windowclosingcodebehind1)]
+ [!code-vb[WindowClosingSnippets#WindowClosingCODEBEHIND1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowClosingSnippets/visualbasic/datawindow.xaml.vb#windowclosingcodebehind1)]  
+[!code-csharp[WindowClosingSnippets#WindowClosingCODEBEHIND2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowClosingSnippets/CSharp/DataWindow.xaml.cs#windowclosingcodebehind2)]
+[!code-vb[WindowClosingSnippets#WindowClosingCODEBEHIND2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WindowClosingSnippets/visualbasic/datawindow.xaml.vb#windowclosingcodebehind2)]  
+  
+ <xref:System.Windows.Window.Closing> イベント ハンドラーに <xref:System.ComponentModel.CancelEventArgs> が渡されます。これにより、`true` に設定するとウィンドウが閉じるのを防ぐ `Boolean` 型の <xref:System.ComponentModel.CancelEventArgs.Cancel%2A> プロパティを実装します。  
+  
+ <xref:System.Windows.Window.Closing> が処理されない場合、または処理されたがキャンセルされていない場合、ウィンドウは閉じられます。  ウィンドウが実際に閉じる直前に、<xref:System.Windows.Window.Closed> が発生します。  この時点で、ウィンドウが閉じるのを防ぐことはできません。  
+  
+> [!NOTE]
+>  メイン アプリケーション ウィンドウを閉じるか、最後のウィンドウを閉じるときに、アプリケーションが自動的にシャットダウンされるように構成することができます \(<xref:System.Windows.Application.MainWindow%2A> を参照\)。  詳細については、「<xref:System.Windows.Application.ShutdownMode%2A>」を参照してください。  
+  
+ 非クライアント領域およびクライアント領域に提供される機構によって、ウィンドウを明示的に閉じることができます。また、次のような場合に、アプリケーションまたは [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] の他の部分の動作の結果として、ウィンドウを暗黙的に閉じることもできます。  
+  
+-   ユーザーが [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] からログオフしたか、[!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] をシャットダウンした場合。  
+  
+-   ウィンドウのオーナーが閉じた場合 \(<xref:System.Windows.Window.Owner%2A> を参照\)。  
+  
+-   メイン アプリケーション ウィンドウが閉じられ、<xref:System.Windows.Application.ShutdownMode%2A> が <xref:System.Windows.ShutdownMode> である場合。  
+  
+-   <xref:System.Windows.Application.Shutdown%2A> が呼び出されます。  
+  
+> [!NOTE]
+>  ウィンドウを閉じると、再度開くことはできません。  
+  
+<a name="Window_Lifetime_Events"></a>   
+### ウィンドウの有効期間イベント  
+ 次の図は、ウィンドウの有効期間内における主要なイベントのシーケンスを示しています。  
+  
+ ![ウィンドウの有効期間](../../../../docs/framework/wpf/app-development/media/windowlifetimeevents.png "WindowLifetimeEvents")  
+  
+ 次の図は、アクティブ化しないで表示されるウィンドウの有効期間内における主要なイベントのシーケンスを示しています。ウィンドウが表示される前に <xref:System.Windows.Window.ShowActivated%2A> は `false` に設定されています。  
+  
+ ![ウィンドウの有効期間 &#40;Window.ShowActivated &#61; False&#41;](../../../../docs/framework/wpf/app-development/media/windowlifetimenoact.png "WindowLifetimeNoAct")  
+  
+<a name="WindowLocation"></a>   
+## ウィンドウの位置  
+ ウィンドウが開いているとき、ウィンドウはデスクトップに対して相対的な x 座標と y 座標の位置にあります。  この位置は、<xref:System.Windows.Window.Left%2A> プロパティと <xref:System.Windows.Window.Top%2A> プロパティをそれぞれ調べることで確認できます。  これらのプロパティを設定して、ウィンドウの位置を変更できます。  
+  
+ <xref:System.Windows.Window.WindowStartupLocation%2A> プロパティを次の <xref:System.Windows.WindowStartupLocation> 列挙値のいずれかに設定して、<xref:System.Windows.Window> が最初に表示されるときの初期位置を指定することもできます。  
+  
+-   <xref:System.Windows.WindowStartupLocation> \(既定値\)  
+  
+-   <xref:System.Windows.WindowStartupLocation>  
+  
+-   <xref:System.Windows.WindowStartupLocation>  
+  
+ 開始位置が <xref:System.Windows.WindowStartupLocation> と指定され、<xref:System.Windows.Window.Left%2A> プロパティと <xref:System.Windows.Window.Top%2A> プロパティが設定されていない場合、<xref:System.Windows.Window> は表示する位置を [!INCLUDE[TLA2#tla_mswin](../../../../includes/tla2sharptla-mswin-md.md)] に問い合わせます。  
+  
+<a name="Topmost_Windows_and_Z_Order"></a>   
+### 最上位ウィンドウと Z オーダー  
+ ウィンドウには、x 位置と y 位置のほかに、他のウィンドウを基準にして垂直位置を決定する z 次元の位置もあります。  これはウィンドウの z オーダーともいい、標準 z オーダーと最上位 z オーダーの 2 種類があります。  *標準 z オーダー*にあるウィンドウの位置は、そのウィンドウが現在アクティブかどうかによって決まります。  既定では、ウィンドウは標準 z オーダーにあります。  *最上位 z オーダー*にあるウィンドウの位置も、そのウィンドウが現在アクティブかどうかによって決まります。  また、最上位 z オーダーにあるウィンドウは、常に、標準 z オーダーにあるウィンドウの上に位置します。  ウィンドウを最上位 z オーダーに配置するには、ウィンドウの <xref:System.Windows.Window.Topmost%2A> プロパティを `true` に設定します。  
+  
+ [!code-xml[WindowsOverviewSnippets#TopmostWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/TopmostWindow.xaml#topmostwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#TopmostWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/TopmostWindow.xaml#topmostwindowmarkup2)]  
+  
+ 各 z オーダー内では、現在アクティブなウィンドウは、同じ z オーダーにある他のすべてのウィンドウの上に表示されます。  
+  
+<a name="WindowSize"></a>   
+## ウィンドウのサイズ  
+ ウィンドウには、デスクトップの位置のほかに、さまざまな幅と高さのプロパティや <xref:System.Windows.Window.SizeToContent%2A> プロパティなど、複数のプロパティによって決定されるサイズがあります。  
+  
+ <xref:System.Windows.FrameworkElement.MinWidth%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、および <xref:System.Windows.FrameworkElement.MaxWidth%2A> を使用して、有効期間中にウィンドウが取ることができる幅の範囲を管理します。これは、次の例に示すように構成します。  
+  
+ [!code-xml[WindowsOverviewSnippets#WidthWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WidthWindow.xaml#widthwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#WidthWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WidthWindow.xaml#widthwindowmarkup2)]  
+  
+ ウィンドウの高さは、<xref:System.Windows.FrameworkElement.MinHeight%2A>、<xref:System.Windows.FrameworkElement.Height%2A>、および <xref:System.Windows.FrameworkElement.MaxHeight%2A> によって管理します。これは、次の例に示すようにして構成します。  
+  
+ [!code-xml[WindowsOverviewSnippets#HeightWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/HeightWindow.xaml#heightwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#HeightWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/HeightWindow.xaml#heightwindowmarkup2)]  
+  
+ さまざまな幅の値と高さの値はそれぞれ範囲を指定しているため、サイズを変更できるウィンドウの幅と高さは、それぞれの寸法に指定された範囲内のいずれかの値を取ります。  現在の幅と高さを検出するには、それぞれ <xref:System.Windows.FrameworkElement.ActualWidth%2A> と <xref:System.Windows.FrameworkElement.ActualHeight%2A> を調べます。  
+  
+ ウィンドウの幅と高さを、ウィンドウのコンテンツのサイズに合わせたサイズにする場合は、<xref:System.Windows.Window.SizeToContent%2A> プロパティを使用できます。これは、次の値を取ります。  
+  
+-   <xref:System.Windows.SizeToContent>.  無効 \(既定値\)。  
+  
+-   <xref:System.Windows.SizeToContent>.  コンテンツの幅に合わせます。<xref:System.Windows.FrameworkElement.MinWidth%2A> と <xref:System.Windows.FrameworkElement.MaxWidth%2A> の両方をコンテンツの幅に設定するのと同じ効果です。  
+  
+-   <xref:System.Windows.SizeToContent>.  コンテンツの高さに合わせます。<xref:System.Windows.FrameworkElement.MinHeight%2A> と <xref:System.Windows.FrameworkElement.MaxHeight%2A> の両方をコンテンツの高さに設定するのと同じ効果です。  
+  
+-   <xref:System.Windows.SizeToContent>.  コンテンツの幅と高さに合わせます。<xref:System.Windows.FrameworkElement.MinHeight%2A> と <xref:System.Windows.FrameworkElement.MaxHeight%2A> の両方をコンテンツの高さに設定し、<xref:System.Windows.FrameworkElement.MinWidth%2A> と <xref:System.Windows.FrameworkElement.MaxWidth%2A> の両方をコンテンツの幅に設定するのと同じ効果です。  
+  
+ 次の例では最初に表示するときにコンテンツ方向と垂直方向に合わせるウィンドウを自動的に調整示します。  
+  
+ [!code-xml[WindowsOverviewSnippets#SizeToContentWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/SizeToContentWindow.xaml#sizetocontentwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#SizeToContentWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/SizeToContentWindow.xaml#sizetocontentwindowmarkup2)]  
+  
+ 次の例ではウィンドウのサイズ変更の内容に合わせて方法を指定するコードの <xref:System.Windows.Window.SizeToContent%2A> のプロパティを設定する方法を示します。  
+  
+ [!code-csharp[HOWTOWindowManagementSnippets#SetWindowSizeToContentPropertyCODE](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HOWTOWindowManagementSnippets/CSharp/MainWindow.xaml.cs#setwindowsizetocontentpropertycode)]
+ [!code-vb[HOWTOWindowManagementSnippets#SetWindowSizeToContentPropertyCODE](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HOWTOWindowManagementSnippets/visualbasic/mainwindow.xaml.vb#setwindowsizetocontentpropertycode)]  
+  
+<a name="OrderOfPrecedence"></a>   
+## サイズ設定プロパティの優先順位  
+ 基本的に、ウィンドウのさまざまなサイズのプロパティを組み合わせて、サイズを変更できるウィンドウの幅と高さの範囲を定義します。  有効な範囲を確認するために、<xref:System.Windows.Window> は次の優先順位でサイズ プロパティの値を評価します。  
+  
+ **高さのプロパティ**  
+  
+1.  <xref:System.Windows.FrameworkElement.MinHeight%2A?displayProperty=fullName> \>  
+  
+2.  <xref:System.Windows.FrameworkElement.MaxHeight%2A?displayProperty=fullName> \>  
+  
+3.  <xref:System.Windows.SizeToContent?displayProperty=fullName>\/<xref:System.Windows.SizeToContent?displayProperty=fullName> \>  
+  
+4.  <xref:System.Windows.FrameworkElement.Height%2A?displayProperty=fullName>  
+  
+ **幅のプロパティ**  
+  
+1.  <xref:System.Windows.FrameworkElement.MinWidth%2A?displayProperty=fullName> \>  
+  
+2.  <xref:System.Windows.FrameworkElement.MaxWidth%2A?displayProperty=fullName> \>  
+  
+3.  <xref:System.Windows.SizeToContent?displayProperty=fullName>\/<xref:System.Windows.SizeToContent?displayProperty=fullName> \>  
+  
+4.  <xref:System.Windows.FrameworkElement.Width%2A?displayProperty=fullName>  
+  
+ 優先順位は、ウィンドウが最大化されたときのサイズも決定します。これは、<xref:System.Windows.Window.WindowState%2A> プロパティで管理します。  
+  
+<a name="WindowState"></a>   
+## ウィンドウの状態  
+ サイズを変更できるウィンドウは、有効期間中、通常、最小化、最大化の 3 つの状態を持っています。  *通常*の状態のウィンドウは、ウィンドウの既定の状態です。  この状態のウィンドウは、サイズ変更グリップ、またはサイズ変更可能な場合は境界線を使用して、ユーザーが移動したりサイズ変更したりできます。  
+  
+ *最小化*された状態のウィンドウは、<xref:System.Windows.Window.ShowInTaskbar%2A> が `true` に設定されている場合は、折りたたまれてタスク バー ボタンになります。それ以外の場合は、折りたたまれて、可能な最小のサイズになり、デスクトップの左下隅に自動的に再配置されます。  最小化されたウィンドウはいずれの種類も、境界線またはサイズ変更グリップを使用してサイズ変更できません。ただし、タスク バーに表示されていない最小化されたウィンドウはデスクトップの任意の場所にドラッグできます。  
+  
+ *最大化*された状態のウィンドウは、拡大されて、可能な最大のサイズになります。これは、<xref:System.Windows.FrameworkElement.MaxWidth%2A> プロパティ、<xref:System.Windows.FrameworkElement.MaxHeight%2A> プロパティ、および <xref:System.Windows.Window.SizeToContent%2A> プロパティが指定するのと同じサイズです。  最小化されたウィンドウと同様、最大化されたウィンドウは、サイズ変更グリップを使用したり、境界線をドラッグしたりすることによってサイズ変更できません。  
+  
+> [!NOTE]
+>  ウィンドウが現在最大化または最小化されている場合でも、ウィンドウの <xref:System.Windows.Window.Top%2A>、<xref:System.Windows.Window.Left%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、および <xref:System.Windows.FrameworkElement.Height%2A> の各プロパティの値は、通常の状態の値を常に表します。  
+  
+ ウィンドウの状態は、<xref:System.Windows.Window.WindowState%2A> プロパティを設定することによって構成できます。これは、次の <xref:System.Windows.WindowState> 列挙値のいずれかを取ります。  
+  
+-   <xref:System.Windows.WindowState> \(既定値\)  
+  
+-   <xref:System.Windows.WindowState>  
+  
+-   <xref:System.Windows.WindowState>  
+  
+ 開くときに最大化されて表示されるウィンドウを作成する方法を次の例に示します。  
+  
+ [!code-xml[WindowsOverviewSnippets#WindowStateWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowStateWindow.xaml#windowstatewindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#WindowStateWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowStateWindow.xaml#windowstatewindowmarkup2)]  
+  
+ 通常は、<xref:System.Windows.Window.WindowState%2A> を設定してウィンドウの初期状態を構成する必要があります。  サイズ変更可能なウィンドウが表示されると、ユーザーはウィンドウのタイトル バーにある最小化ボタン、最大化ボタン、および元に戻すボタンを使用して、ウィンドウの状態を変更できます。  
+  
+<a name="WindowAppearance"></a>   
+## ウィンドウの外観  
+ ウィンドウのクライアント領域の外観を変更するために、ボタン、ラベル、テキスト ボックスなど、ウィンドウ固有のコンテンツを追加します。  非クライアント領域を構成するために、<xref:System.Windows.Window> には、ウィンドウのアイコンを設定する <xref:System.Windows.Window.Icon%2A>、タイトルを設定する <xref:System.Windows.Window.Title%2A> など、いくつかのプロパティが用意されています。  
+  
+ また、ウィンドウのサイズ変更モード、ウィンドウ スタイル、デスクトップのタスク バーにボタンとして表示するかどうかを設定して、非クライアント領域の境界線の外観と動作も変更できます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Resize_Mode"></a>   
+### サイズ変更モード  
+ <xref:System.Windows.Window.WindowStyle%2A> プロパティによって、ユーザーがどのようにウィンドウのサイズを変更するか、またはウィンドウのサイズを変更できるかどうかを制御できます。  ウィンドウ スタイルの選択は、ユーザーがマウスで境界線をドラッグすることによってウィンドウのサイズを変更できるかどうか、**最小化**ボタン、**最大化**ボタン、および**サイズ変更**ボタンが非クライアント領域に表示されるかどうか、表示される場合にボタンが有効かどうかに影響を与えます。  
+  
+ ウィンドウのサイズ変更方法は、<xref:System.Windows.Window.ResizeMode%2A> プロパティを設定することによって構成できます。これは、次の <xref:System.Windows.ResizeMode> 列挙値のいずれかを取ります。  
+  
+-   <xref:System.Windows.ResizeMode>  
+  
+-   <xref:System.Windows.ResizeMode>  
+  
+-   <xref:System.Windows.ResizeMode> \(既定値\)  
+  
+-   <xref:System.Windows.ResizeMode>  
+  
+ <xref:System.Windows.Window.WindowStyle%2A> と同様に、ウィンドウのサイズ変更モードは、有効期間中に変更される可能性はほとんどありません。したがって、多くの場合は [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップから設定します。  
+  
+ [!code-xml[WindowsOverviewSnippets#ResizeModeWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/ResizeModeWindow.xaml#resizemodewindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#ResizeModeWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/ResizeModeWindow.xaml#resizemodewindowmarkup2)]  
+  
+ <xref:System.Windows.Window.WindowState%2A> プロパティを調べることによって、ウィンドウが最大化されているか、最小化されているか、元のサイズに戻されているかを検出できます。  
+  
+<a name="Window_Style"></a>   
+### ウィンドウ スタイル  
+ ウィンドウの非クライアント領域から公開される境界線は、多くのアプリケーションに適しています。  ただし、ウィンドウの種類によって、異なる種類の境界線が必要な状況や、境界線がまったく必要ない状況があります。  
+  
+ ウィンドウが取得する境界線の種類を制御するには、<xref:System.Windows.Window.WindowStyle%2A> プロパティを次の <xref:System.Windows.WindowStyle> 列挙値のいずれかに設定します。  
+  
+-   <xref:System.Windows.WindowStyle>  
+  
+-   <xref:System.Windows.WindowStyle> \(既定値\)  
+  
+-   <xref:System.Windows.WindowStyle>  
+  
+-   <xref:System.Windows.WindowStyle>  
+  
+ これらのウィンドウ スタイルの効果については、次の図で説明します。  
+  
+ ![ウィンドウ スタイル](../../../../docs/framework/wpf/app-development/media/windowoverviewfigure6.png "WindowOverviewFigure6")  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップまたはコードのいずれかを使用して <xref:System.Windows.Window.WindowStyle%2A> を設定できます。ウィンドウの有効期間中に変更される可能性はほとんどないため、多くの場合は [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップで設定します。  
+  
+ [!code-xml[WindowsOverviewSnippets#WindowStyleWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowStyleWindow.xaml#windowstylewindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#WindowStyleWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/WindowStyleWindow.xaml#windowstylewindowmarkup2)]  
+  
+#### 四角形以外のウィンドウ スタイル  
+ <xref:System.Windows.Window.WindowStyle%2A> で使用できる境界線のスタイルでは十分でない状況もあります。  たとえば、[!INCLUDE[TLA#tla_wmp](../../../../includes/tlasharptla-wmp-md.md)] が使用するような、四角形以外の境界線を持つアプリケーションを作成する場合があります。  
+  
+ たとえば、次の図に示す音声のバブル ウィンドウを想定します。  
+  
+ ![四角形以外のウィンドウ](../../../../docs/framework/wpf/app-development/media/nonrectangularwindowfigure.PNG "NonRectangularWindowFigure")  
+  
+ この種類のウィンドウは、<xref:System.Windows.Window.WindowStyle%2A> プロパティを <xref:System.Windows.WindowStyle> に設定し、<xref:System.Windows.Window> が持つ透明度に対する特殊なサポートを使用することによって作成できます。  
+  
+ [!code-xml[WindowsOverviewSnippets#TransparentWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/TransparentWindow.xaml#transparentwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#TransparentWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/TransparentWindow.xaml#transparentwindowmarkup2)]  
+  
+ 値をこの組み合わせで使用し、ウィンドウが完全に透明にレンダリングされるように設定します。  この状態では、ウィンドウの非クライアント領域の表示要素 \(\[閉じる\] メニュー、最小化ボタン、最大化ボタン、元に戻すボタンなど\) は使用できません。  したがって、独自の表示要素を用意する必要があります。  
+  
+<a name="Task_Bar_Presence"></a>   
+### タスク バーのプレゼンス  
+ ウィンドウの既定の外観には、次の図に示すような、タスク バー ボタンも含まれます。  
+  
+ ![タスク バー ボタンがあるウィンドウ](../../../../docs/framework/wpf/app-development/media/windowoverviewfigure7.png "WindowOverviewFigure7")  
+  
+ メッセージ ボックスやダイアログ ボックスなど、ウィンドウの種類によっては、タスク バー ボタンがありません \(「[ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)」を参照\)。  ウィンドウのタスク バー ボタンを表示するかどうかは、<xref:System.Windows.Window.ShowInTaskbar%2A> プロパティを設定することによって制御できます \(既定値は `true`\)。  
+  
+ [!code-xml[WindowsOverviewSnippets#ShowInTaskbarWindowMARKUP1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/ShowInTaskbarWindow.xaml#showintaskbarwindowmarkup1)]  
+[!code-xml[WindowsOverviewSnippets#ShowInTaskbarWindowMARKUP2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WindowsOverviewSnippets/CSharp/ShowInTaskbarWindow.xaml#showintaskbarwindowmarkup2)]  
+  
+<a name="SecurityConsiderations"></a>   
+## セキュリティの考慮事項  
+ <xref:System.Windows.Window> をインスタンス化するには、`UnmanagedCode` セキュリティ アクセス許可が必要です。  ローカル コンピューターにインストールされ、ローカル コンピューターから起動されるアプリケーションの場合は、アプリケーションに付与される許可セットの範囲内になります。  
+  
+ ただし、これは、[!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] を使用して、インターネット ゾーンまたはローカル イントラネット ゾーンから起動されるアプリケーションに付与される許可セットの範囲外になります。  そのため、ユーザーは [!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] セキュリティ警告を受け取り、アプリケーションの許可セットを完全信頼に昇格させる必要があります。  
+  
+ さらに、[!INCLUDE[TLA2#tla_xbap#plural](../../../../includes/tla2sharptla-xbapsharpplural-md.md)] では、既定でウィンドウまたはダイアログ ボックスを表示できません。  スタンドアロン アプリケーションのセキュリティに関する考慮事項については、「[WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)」を参照してください。  
+  
+<a name="Other_Types_of_Windows"></a>   
+## その他の種類のウィンドウ  
+ <xref:System.Windows.Navigation.NavigationWindow> は、ナビゲーション可能なコンテンツをホストするように設計されたウィンドウです。  詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+ ダイアログ ボックスは、ユーザーから情報を収集して機能を完了するためによく使用されるウィンドウです。  たとえば、ユーザーがファイルを開く場合は、通常、ユーザーからファイル名を取得するために、アプリケーションによって **\[ファイルを開く\]** ダイアログ ボックスが表示されます。  詳細については、「[ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Window>   
+ <xref:System.Windows.MessageBox>   
+ <xref:System.Windows.Navigation.NavigationWindow>   
+ <xref:System.Windows.Application>   
+ [ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)   
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md b/docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md
new file mode 100644
index 00000000000..20aa7a5c51f
--- /dev/null
+++ b/docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md
@@ -0,0 +1,192 @@
+---
+title: "WPF XAML ブラウザー アプリケーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラウザーによってホストされるアプリケーション [WPF]"
+  - "WPF XAML ブラウザー アプリケーション (XBAP)"
+  - "XAML ブラウザー アプリケーション (XBAP)"
+  - "XBAP, XAML ブラウザー アプリケーション"
+ms.assetid: 3a7a86a8-75d5-4898-96b9-73da151e5e16
+caps.latest.revision: 47
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 47
+---
+# WPF XAML ブラウザー アプリケーションの概要
+<a name="introduction"></a> [!INCLUDE[TLA#tla_xbap#plural](../../../../includes/tlasharptla-xbapsharpplural-md.md)] は、Web アプリケーションとリッチ クライアント アプリケーションの両方の機能を組み合わせます。  Web アプリケーションと同様、XBAP は Web サーバーに配置して、Internet Explorer または Firefox から開始できます。  また、リッチ クライアント アプリケーションと同じように、XBAP は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の機能を活用できます。  XBAP の開発方法もリッチ クライアントの開発に似ています。  このトピックでは、XBAP 開発の高度な概略を示し、XBAP 開発が標準的なリッチ クライアント開発と異なる点について説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [新しい XAML ブラウザー アプリケーション \(XBAP\) の作成](#creating_a_new_xaml_browser_application_xbap)  
+  
+-   [XBAP の配置](#deploying_a_xbap)  
+  
+-   [ホスト Web ページとの通信](#communicating_with_the_host_web_page)  
+  
+-   [XBAP セキュリティの考慮事項](#xbap_security_considerations)  
+  
+-   [XBAP 起動時のパフォーマンスに関する考慮事項](#xbap_start_time_performance_considerations)  
+  
+<a name="creating_a_new_xaml_browser_application_xbap"></a>   
+## 新しい XAML ブラウザー アプリケーション \(XBAP\) の作成  
+ 新しい XBAP プロジェクトを作成する最も簡単な方法は、[!INCLUDE[vs_dev10_ext](../../../../includes/vs-dev10-ext-md.md)] を使用することです。  新しいプロジェクトを作成するときは、テンプレートのリストから **\[WPF ブラウザー アプリケーション\]** をクリックします。  詳細については、「[方法 : 新しい WPF ブラウザー アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/72ef4d90-e163-42a1-8df0-ea7ccfd1901f)」を参照してください。  
+  
+ XBAP プロジェクトを実行すると、スタンドアロン ウィンドウではなくブラウザー ウィンドウで開かれます。  XBAP を [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] でデバッグする場合、アプリケーションはインターネット ゾーン アクセス許可付きで実行されるため、そのアクセス許可を超えるとセキュリティ例外がスローされます。  詳細については、「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」および「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用して開発していない場合やプロジェクト ファイルについて詳しく知りたい場合は、「[WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)」を参照してください。  
+  
+<a name="deploying_a_xbap"></a>   
+## XBAP の配置  
+ XBAP をビルドすると、次の 3 つのファイルが生成されます。  
+  
+|File|Description|  
+|----------|-----------------|  
+|実行可能ファイル \(.exe\)|コンパイル済みのコードが含まれます。拡張子は .exe です。|  
+|アプリケーション マニフェスト \(.manifest\)|これにはアプリケーションに関連付けられたメタデータが含まれ、拡張子は .manifest です。|  
+|配置マニフェスト \(.xbap\)|[!INCLUDE[TLA#tla_clickonce](../../../../includes/tlasharptla-clickonce-md.md)] がアプリケーションの配置に使用する情報が含まれます。このファイルの拡張子は .xbap です。|  
+  
+ XBAP は Web サーバー \([!INCLUDE[TLA#tla_iis50](../../../../includes/tlasharptla-iis50-md.md)] 以降のバージョンなど\) に配置します。  [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] を Web サーバーにインストールする必要はありませんが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] [!INCLUDE[TLA#tla_mime](../../../../includes/tlasharptla-mime-md.md)] 型とファイル名拡張子を登録する必要はあります。  詳細については、「[WPF アプリケーションを配置するように IIS 5.0 および IIS 6.0 を構成する](../../../../docs/framework/wpf/app-development/how-to-configure-iis-5-0-and-iis-6-0-to-deploy-wpf-applications.md)」を参照してください。  
+  
+ XBAP を配置用に準備するには、.exe および関連付けられたマニフェストを Web サーバーにコピーします。  配置マニフェスト \(拡張子が .xbap のファイル\) を開くためのハイパーリンクを含む HTML ページを作成します。  ユーザーが .xbap ファイルへのリンクをクリックすると、[!INCLUDE[TLA2#tla_clickonce](../../../../includes/tla2sharptla-clickonce-md.md)] がアプリケーションのダウンロードと開始を自動的に処理します。  次のプログラム例では、XBAP を指し示すハイパーリンクを含む HTML ページを示しています。  
+  
+```  
+<html>   
+  <head></head>  
+  <body>   
+    <a href="XbapEx.xbap">Click this link to launch the application</a>  
+  </body>   
+</html>  
+  
+```  
+  
+ XBAP は、Web ページのフレーム内にホストすることもできます。  1 つまたは複数のフレームを持つ Web ページを作成します。  配置マニフェスト ファイルに対するフレームのソース プロパティを設定します。  ホストする Web ページと XBAP との間で、組み込まれた機構を使用して通信を行う場合は、アプリケーションをフレーム内にホストする必要があります。  次のプログラム例では、2 つのフレームを持つ HTML ページ \(2 つ目のフレームのソースが XBAP に設定されています\) を示しています。  
+  
+```  
+<html>   
+  <head>A page with frames.</head>  
+    <frameset cols="50%,50%">   
+      <frame src="introduction.htm" >   
+      <frame src="XbapEx.xbap" >   
+  </frameset>   
+</html>  
+```  
+  
+### キャッシュされた XBAP の削除  
+ XBAP をビルドし直して開始した後に、旧バージョンの XBAP が開かれることがあります。  たとえば、この動作は XBAP アセンブリのバージョン番号が静的である場合に、XBAP をコマンド ラインから開始すると起こることがあります。  この場合、キャッシュされているバージョン \(それまで開始されていたバージョン\) と新しいバージョンとでバージョン番号が変わらないので、XBAP の新しいバージョンはダウンロードされません。  代わりに、キャッシュされたバージョンが読み込まれます。  
+  
+ このような場合は、**Mage** コマンド \(Visual Studio または [!INCLUDE[TLA2#tla_lhsdk](../../../../includes/tla2sharptla-lhsdk-md.md)] と共にインストールされる\) をコマンド プロンプトで使用して、キャッシュされているバージョンを削除できます。  次のコマンドでアプリケーション キャッシュを消去します。  
+  
+ `Mage.exe -cc`  
+  
+ このコマンドを実行すると、最新バージョンの XBAP が開かれるようになります。  アプリケーションを [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] でデバッグするときは、XBAP の最新バージョンを開始する必要があります。一般的に、配置バージョン番号は、ビルドするたびに更新することをお勧めします。  Mage.exe の詳細については、「[Mage.exe \(マニフェストの生成および編集ツール\)](../../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md)」を参照してください。  
+  
+<a name="communicating_with_the_host_web_page"></a>   
+## ホスト Web ページとの通信  
+ アプリケーションが HTML フレーム内でホストされている場合、XBAP を含む Web ページと通信することができます。  この処理は、<xref:System.Windows.Interop.BrowserInteropHelper> の <xref:System.Windows.Interop.BrowserInteropHelper.HostScript%2A> プロパティを取得することで実行できます。  このプロパティは、HTML ウィンドウを表すスクリプト オブジェクトを返します。  [window オブジェクト](http://go.microsoft.com/fwlink/?LinkId=160274)上のプロパティ、メソッドおよびイベントへは、標準のドット構文を使ってアクセスできます。  スクリプト メソッドおよびグローバル変数にアクセスすることもできます。  次の例は、スクリプト オブジェクトを取得してブラウザーを閉じる方法を示しています。  
+  
+ [!code-csharp[XbapBrowserInterop#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/xbapbrowserinterop/cs/page1.xaml.cs#10)]
+ [!code-vb[XbapBrowserInterop#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/xbapbrowserinterop/vb/page1.xaml.vb#10)]  
+  
+### HostScript を使用する XBAP のデバッグ  
+ XBAP で <xref:System.Windows.Interop.BrowserInteropHelper.HostScript%2A> オブジェクトを使用して HTML ウィンドウと通信する場合に、[!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] でアプリケーションを実行およびデバッグするには、2 つの設定を指定する必要があります。  つまり、アプリケーションから元のサイトにアクセスできる必要があると同時に、そのアプリケーションを XBAP を含む HTML ページで開始する必要があるということです。  これら 2 つの設定を確認する方法を次の手順で説明します。  
+  
+1.  Visual Studio でプロジェクトのプロパティを開きます。  
+  
+2.  **\[セキュリティ\]** タブの **\[詳細設定\]** をクリックします。  
+  
+     \[セキュリティの詳細設定\] ダイアログ ボックスが表示されます。  
+  
+3.  **\[アプリケーション アクセスをその元のサイトに与える\]** チェック ボックスがオンになっていることを確認し、**\[OK\]** をクリックします。  
+  
+4.  **\[デバッグ\]** タブで、**\[ブラウザーを開始時に使用する URL\]** をクリックし、XBAP を含む HTML ページの URL を指定します。  
+  
+5.  Internet Explorer で、**\[ツール\]** をクリックし、**\[インターネット オプション\]** をクリックします。  
+  
+     \[インターネット オプション\] ダイアログ ボックスが表示されます。  
+  
+6.  **\[詳細設定\]** タブをクリックします。  
+  
+7.  **\[セキュリティ\]** の下にある **\[設定\]** ボックスで、**\[マイ コンピューターのファイルでのアクティブ コンテンツの実行を許可する\]** チェック ボックスをオンにします。  
+  
+8.  **\[OK\]** をクリックします。  
+  
+     変更は、Internet Explorer を再起動すると有効になります。  
+  
+> [!CAUTION]
+>  Internet Explorer でアクティブ コンテンツを有効にすると、コンピューターが危険にさらされるおそれがあります。  詳細については、「[Internet Explorer のセキュリティとプライバシーの機能](http://go.microsoft.com/fwlink/?LinkId=179286)」を参照してください。  Internet Explorer のセキュリティ設定を変更したくない場合は、HTML ページをサーバーから起動して、[!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] デバッガーをプロセスにアタッチできます。  
+  
+<a name="xbap_security_considerations"></a>   
+## XBAP セキュリティの考慮事項  
+ XBAP は通常、インターネット ゾーン アクセス許可セットに制限された部分信頼セキュリティ サンドボックス内で実行する必要があります。  したがって、実装ではインターネット ゾーン内でサポートされている [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 要素のサブセットをサポートするか、またはアプリケーションのアクセス許可を昇格させる必要があります。  詳細については、「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.WebBrowser> コントロールをアプリケーションで使用する場合、内部的には WPF によってネイティブ WebBrowser ActiveX コントロールがインスタンス化されます。  アプリケーションが Internet Explorer で実行している部分信頼の XBAP である場合、ActiveX コントロールは Internet Explorer プロセスの専用スレッドで実行されます。  このため、次の制限が適用されます。  
+  
+-   <xref:System.Windows.Controls.WebBrowser> コントロールでは、セキュリティ上の制限などのホスト ブラウザーに似た動作を提供する必要があります。  このようなセキュリティ上の制限は、Internet Explorer のセキュリティ設定を使用して制御できます。  詳細については、「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」を参照してください。  
+  
+-   XBAP がドメインをまたいで HTML ページにロードされると、例外がスローされます。  
+  
+-   入力が WPF <xref:System.Windows.Controls.WebBrowser> とは別のスレッドで行われるため、キーボード入力を受け取ることができず、IME の状態が共有されません。  
+  
+-   ActiveX コントロールが他のスレッド上で実行されるため、ナビゲーションのタイミングまたは順序が異なることがあります。  たとえば、ページへの移動が、別のナビゲーション要求の開始によって取り消されない場合があります。  
+  
+-   WPF アプリケーションが独立したスレッドで実行されるため、カスタムの ActiveX コントロールに通信上の問題が発生することがあります。  
+  
+-   <xref:System.Windows.Interop.HwndHost.MessageHook> は発生しません。<xref:System.Windows.Interop.HwndHost> が他のスレッドまたはプロセスで実行中のウィンドウをサブクラス化できないためです。  
+  
+### 完全信頼の XBAP の作成  
+ XBAP で完全信頼が必要な場合、プロジェクトを変更してこのアクセス許可を有効にできます。  完全信頼を有効にする手順を次に示します。  
+  
+1.  Visual Studio でプロジェクトのプロパティを開きます。  
+  
+2.  **\[セキュリティ\]** タブで、**\[これは完全に信頼するアプリケーションです\]** をクリックします。  
+  
+ この設定により、次の変更が実行されます。  
+  
+-   プロジェクト ファイル内の `<TargetZone>` 要素の値が `Custom` に変更される。  
+  
+-   アプリケーション マニフェスト \(app.manifest\) の `Unrestricted="true"` 属性が `PermissionSet` 要素に追加される。  
+  
+    ```  
+    <PermissionSet class="System.Security.PermissionSet"   
+        version="1"   
+        ID="Custom"   
+        SameSite="site"   
+        Unrestricted="true"   
+    />  
+    ```  
+  
+### 完全信頼の XBAP の配置  
+ ClickOnce 信頼済み配置モデルに従っていない完全信頼の XBAP を配置した場合、ユーザーがアプリケーションを実行したときの動作は、セキュリティ ゾーンに依存します。  ユーザーがアプリケーションをインストールしようとすると警告が表示されることもあります。  ユーザーは、インストールを続行するか取り消すかを選択できます。  次の表は、各セキュリティ ゾーンのアプリケーション動作と、完全信頼を受け取るアプリケーションで行う必要のある操作を示しています。  
+  
+|セキュリティ ゾーン|\[動作\]|完全信頼を受け取るための操作|  
+|----------------|------------|--------------------|  
+|ローカル コンピューター|完全信頼を自動的に受け取る|アクションは必要ありません。|  
+|イントラネットおよび信頼されたサイト|完全信頼のプロンプトを表示|ユーザーへのプロンプトにソースが表示されるように、証明書を使用して XBAP を署名します。|  
+|インターネット|"信頼されていません" というメッセージが表示され、失敗する|証明書を使用して XBAP に署名します。|  
+  
+> [!NOTE]
+>  前の表で説明した動作は、ClickOnce 信頼済み配置モデルに従っていない完全信頼の XBAP の動作です。  
+  
+ 完全信頼の XBAP を配置する場合は、ClickOnce 信頼済み配置モデルを使用することをお勧めします。  このモデルにより、セキュリティ ゾーンに関係なく XBAP に完全信頼を自動的に付与できるため、ユーザーにプロンプトが表示されることはありません。  このモデルの一部としては、信頼された発行元からの証明書を使用してアプリケーションを署名する必要があります。  細については、「[信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)」および「[Introduction to Code Signing \(コード署名の概要\)](http://go.microsoft.com/fwlink/?LinkId=166327)」を参照してください。  
+  
+<a name="xbap_start_time_performance_considerations"></a>   
+## XBAP 起動時のパフォーマンスに関する考慮事項  
+ XBAP のパフォーマンスにとって重要な側面は、その起動時にあります。  最初に読み込む WPF アプリケーションが XBAP である場合は、*コールド スタート*時間が 10 秒以上かかる可能性があります。  これは、進行状況ページは WPF によってレンダリングされますが、アプリケーションを表示するには CLR と WPF の両方をコールド スタートする必要があるためです。  
+  
+ [!INCLUDE[net_v35SP1_short](../../../../includes/net-v35sp1-short-md.md)] 以降、XBAP のコールド スタート時間は、アンマネージ進行状況ページを配置サイクルの初期に表示することで短縮されています。進行状況ページは、ネイティブ ホスティング コードによって表示され、HTML でレンダリングされるので、ほぼアプリケーションの起動直後に表示されます。  
+  
+ さらに、[!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] のダウンロード シーケンスの同時実行の改良によって、開始時間は最大 10% 短縮されます。  [!INCLUDE[ndptecclick](../../../../includes/ndptecclick-md.md)] がマニフェストをダウンロードして評価した後、アプリケーションのダウンロードが開始され、プログレス バーの更新が開始されます。  
+  
+## 参照  
+ [Visual Studio を構成して Web サービスを呼び出す XAML ブラウザー アプリケーションをデバッグする](../../../../docs/framework/wpf/app-development/configure-vs-to-debug-a-xaml-browser-to-call-a-web-service.md)   
+ [WPF アプリケーションの配置](../../../../docs/framework/wpf/app-development/deploying-a-wpf-application-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/class-library-wpf.md b/docs/framework/wpf/class-library-wpf.md
new file mode 100644
index 00000000000..d5ee0fcee96
--- /dev/null
+++ b/docs/framework/wpf/class-library-wpf.md
@@ -0,0 +1,143 @@
+---
+title: "クラス ライブラリ (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス ライブラリ"
+  - "Windows Presentation Foundation クラス ライブラリ"
+  - "WPF クラス ライブラリ"
+ms.assetid: dcb35927-00ad-4141-a1ab-a7a524dd3f10
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# クラス ライブラリ (WPF)
+次のリンクは、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA#tla_api#plural](../../../includes/tlasharptla-apisharpplural-md.md)] を格納する名前空間を参照します。  
+  
+## このセクションの内容  
+  
+## 関連項目  
+  
+-   <xref:Microsoft.Build.Tasks.Windows>  
+  
+-   <xref:Microsoft.Win32> \(共有\)  
+  
+-   <xref:Microsoft.Windows.Themes>  
+  
+-   <xref:System.Collections.ObjectModel> \(共有\)  
+  
+-   <xref:System.Collections.Specialized> \(共有\)  
+  
+-   <xref:System.ComponentModel> \(共有\)  
+  
+-   <xref:System.Diagnostics> \(共有\)  
+  
+-   <xref:System.IO> \(共有\)  
+  
+-   <xref:System.IO.Packaging>  
+  
+-   <xref:System.Printing>  
+  
+-   <xref:System.Printing.IndexedProperties>  
+  
+-   <xref:System.Printing.Interop>  
+  
+-   <xref:System.Security.Permissions> \(共有\)  
+  
+-   <xref:System.Security.RightsManagement>  
+  
+-   <xref:System.Windows>  
+  
+-   <xref:System.Windows.Annotations>  
+  
+-   <xref:System.Windows.Annotations.Storage>  
+  
+-   <xref:System.Windows.Automation>  
+  
+-   <xref:System.Windows.Automation.Peers>  
+  
+-   <xref:System.Windows.Automation.Provider>  
+  
+-   <xref:System.Windows.Automation.Text>  
+  
+-   <xref:System.Windows.Controls>  
+  
+-   <xref:System.Windows.Controls.Primitives>  
+  
+-   <xref:System.Windows.Converters>  
+  
+-   <xref:System.Windows.Data>  
+  
+-   <xref:System.Windows.Documents>  
+  
+-   <xref:System.Windows.Documents.DocumentStructures>  
+  
+-   <xref:System.Windows.Documents.Serialization>  
+  
+-   <xref:System.Windows.Forms.Integration>  
+  
+-   <xref:System.Windows.Ink>  
+  
+-   <xref:System.Windows.Input>  
+  
+-   <xref:System.Windows.Input.StylusPlugIns>  
+  
+-   <xref:System.Windows.Interop>  
+  
+-   <xref:System.Windows.Markup> \(共有\)  
+  
+-   <xref:System.Windows.Markup.Localizer>  
+  
+-   <xref:System.Windows.Markup.Primitives>  
+  
+-   <xref:System.Windows.Media>  
+  
+-   <xref:System.Windows.Media.Animation>  
+  
+-   <xref:System.Windows.Media.Converters>  
+  
+-   <xref:System.Windows.Media.Effects>  
+  
+-   <xref:System.Windows.Media.Imaging>  
+  
+-   <xref:System.Windows.Media.Media3D>  
+  
+-   <xref:System.Windows.Media.Media3D.Converters>  
+  
+-   <xref:System.Windows.Media.TextFormatting>  
+  
+-   <xref:System.Windows.Navigation>  
+  
+-   <xref:System.Windows.Resources>  
+  
+-   <xref:System.Windows.Shapes>  
+  
+-   <xref:System.Windows.Threading>  
+  
+-   <xref:System.Windows.Xps>  
+  
+-   <xref:System.Windows.Xps.Packaging>  
+  
+-   <xref:System.Windows.Xps.Serialization>  
+  
+-   <xref:UIAutomationClientsideProviders>  
+  
+## .NET 4 での XAML のサポート  
+ 次の名前空間には、System.Xaml アセンブリの型が含まれています。  System.Xaml は、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] を基盤として構築されたフレームワーク \(WPF など\) に対して、XAML の共通言語サポートを提供します。  
+  
+-   <xref:System.Windows.Markup> \(共有\)  
+  
+-   <xref:System.Xaml>  
+  
+-   <xref:System.Xaml.Permissions>  
+  
+-   <xref:System.Xaml.Schema>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/TOC.md b/docs/framework/wpf/controls/TOC.md
new file mode 100644
index 00000000000..a4e68d10dfa
--- /dev/null
+++ b/docs/framework/wpf/controls/TOC.md
@@ -0,0 +1,225 @@
+# [RichTextBox コンテンツの保存、読み込み、および印刷](how-to-save-load-and-print-richtextbox-content.md)
+# [Microsoft Expression Blend を使用してボタンを作成する](walkthrough-create-a-button-by-using-microsoft-expression-blend.md)
+# [要素からすべての装飾を削除する](how-to-remove-all-adorners-from-an-element.md)
+# [ComboBox](combobox.md)
+# [Canvas](canvas.md)
+# [RepeatButton のスタイルとテンプレート](repeatbutton-syles-and-templates.md)
+# [BorderThickness 値をアニメーション化する](how-to-animate-a-borderthickness-value.md)
+# [Dock の値を取得または設定する](how-to-get-or-set-a-dock-value.md)
+# [ListBox のスタイルとテンプレート](listbox-styles-and-templates.md)
+# [ListView](listview.md)
+# [ポップアップの配置動作](popup-placement-behavior.md)
+# [スライダー](slider.md)
+# [ScrollBar のつまみのサイズをカスタマイズする](how-to-customize-the-thumb-size-on-a-scrollbar.md)
+# [StackPanel または DockPanel を選択する](how-to-choose-between-stackpanel-and-dockpanel.md)
+# [カテゴリ別のコントロール](controls-by-category.md)
+# [パネルの概要](panels-overview.md)
+# [CheckBox を持つ ListViewItem を作成する](how-to-create-listviewitems-with-a-checkbox.md)
+# [TabControl のスタイルとテンプレート](tabcontrol-styles-and-templates.md)
+# [カレンダーのスタイルとテンプレート](calendar-styles-and-templates.md)
+# [RichTextBox からテキスト コンテンツを抽出する](how-to-extract-the-text-content-from-a-richtextbox.md)
+# [プログラムによる RichTextBox での選択の変更](change-selection-in-a-richtextbox-programmatically.md)
+# [WrapPanel](wrappanel.md)
+# [ToolTip の概要](tooltip-overview.md)
+# [GridView を実装する ListView の項目をグループ化する](how-to-group-items-in-a-listview-that-implements-a-gridview.md)
+# [Calendar](calendar.md)
+# [CheckBox](checkbox.md)
+# [方法: DataGrid コントロールを使用して検証を実装する](how-to-implement-validation-with-the-datagrid-control.md)
+# [TextBlock](textblock.md)
+# [Expander](expander.md)
+# [チュートリアル : カスタム アニメーション ボタンの作成](walkthroughs-create-a-custom-animated-button.md)
+# [StackPanel を作成する](how-to-create-a-stackpanel.md)
+# [TextBox コントロールを読み取り専用にする](how-to-make-a-textbox-control-read-only.md)
+# [方法のトピック](image-how-to-topics.md)
+# [方法のトピック](adorners-how-to-topics.md)
+# [ボタンのスタイルとテンプレート](button-styles-and-templates.md)
+# [カスタム パネル要素を作成する](how-to-create-a-custom-panel-element.md)
+# [ScrollViewer のスタイルとテンプレート](scrollviewer-styles-and-templates.md)
+# [TextBox へのウォーターマークの追加](how-to-add-a-watermark-to-a-textbox.md)
+# [PasswordBox のスタイルとテンプレート](passwordbox-syles-and-templates.md)
+# [ListBox にデータをバインドする](how-to-bind-a-listbox-to-data.md)
+# [方法のトピック](gridsplitter-how-to-topics.md)
+# [深度がわからないデータに TreeView をバインドする](how-to-bind-a-treeview-to-data-that-has-an-indeterminable-depth.md)
+# [ListBoxItem を取得する](how-to-get-a-listboxitem.md)
+# [エクスパンダーのスタイルとテンプレート](expander-styles-and-templates.md)
+# [スライダーのスタイルとテンプレート](slider-styles-and-templates.md)
+# [IScrollInfo インターフェイスを使用してコンテンツをスクロールする](how-to-scroll-content-by-using-the-iscrollinfo-interface.md)
+# [方法 : ControlTemplate によって生成された要素を検索する](how-to-find-controltemplate-generated-elements.md)
+# [グリッドを使用して標準 UI ダイアログ ボックスをビルドする](how-to-build-a-standard-ui-dialog-box-by-using-grid.md)
+# [テキスト選択を取得する](how-to-retrieve-a-text-selection.md)
+# [ListView のスタイルとテンプレート](listview-styles-and-templates.md)
+# [グリッド](grid.md)
+# [ToolTip を配置する](how-to-position-a-tooltip.md)
+# [Canvas のコンテンツを Border で囲む](how-to-wrap-a-border-around-the-content-of-a-canvas.md)
+# [方法のトピック](stackpanel-how-to-topics.md)
+# [RichTextBox の概要](richtextbox-overview.md)
+# [TextBox コントロールのテキストの先頭または末尾にカーソルを配置する](position-the-cursor-at-the-beginning-or-end-of-text.md)
+# [イメージをトリミングする](how-to-crop-an-image.md)
+# [スタイルの設定が可能なコントロールを設計するためのガイドライン](guidelines-for-designing-stylable-controls.md)
+# [DatePicker のスタイルとテンプレート](datepicker-syles-and-templates.md)
+# [方法のトピック](expander-how-to-topics.md)
+# [DocumentViewer](documentviewer.md)
+# [StackPanel にコンテンツを水平方向または垂直方向に配置する](how-to-horizontally-or-vertically-align-content-in-a-stackpanel.md)
+# [ラベルのスタイルとテンプレート](label-styles-and-templates.md)
+# [コントロール ライブラリ](control-library.md)
+# [コントロールのスタイルとテンプレート](control-styles-and-templates.md)
+# [CheckBox のスタイルとテンプレート](checkbox-styles-and-templates.md)
+# [ColumnDefinitionsCollections および RowDefinitionsCollections を使用して列と行を操作する](manipulate-columns-and-rows-by-using-columndefinitionscollections.md)
+# [DataGrid](datagrid.md)
+# [カスタム コンテキスト メニューを RichTextBox に配置する](how-to-position-a-custom-context-menu-in-a-richtextbox.md)
+# [GridViewRowPresenter を使用してデータを表示する](how-to-display-data-by-using-gridviewrowpresenter.md)
+# [ToolBar のスタイルとテンプレート](toolbar-styles-and-templates.md)
+# [TextBox コントロールのテキスト コンテンツを設定する](how-to-set-the-text-content-of-a-textbox-control.md)
+# [FlowDocumentReader](flowdocumentreader.md)
+# [ToolBar のコントロールのスタイルを設定する](how-to-style-controls-on-a-toolbar.md)
+# [方法のトピック](treeview-how-to-topics.md)
+# [Viewbox のコンテンツに Stretch プロパティを適用する](how-to-apply-stretch-properties-to-the-contents-of-a-viewbox.md)
+# [ListView の列の水平方向の配置を変更する](how-to-change-the-horizontal-alignment-of-a-column-in-a-listview.md)
+# [ListBox](listbox.md)
+# [メニューのスタイルとテンプレート](menu-styles-and-templates.md)
+# [TreeView のパフォーマンスを改善する](how-to-improve-the-performance-of-a-treeview.md)
+# [グリッド要素を作成する](how-to-create-a-grid-element.md)
+# [GridView の概要](gridview-overview.md)
+# [要素に装飾をバインドする](how-to-bind-an-adorner-to-an-element.md)
+# [ComboBox のスタイルとテンプレート](combobox-styles-and-templates.md)
+# [ポップアップをアニメーション化する](how-to-animate-a-popup.md)
+# [StatusBar](statusbar.md)
+# [方法のトピック](listview-how-to-topics.md)
+# [TextBox のスタイルとテンプレート](textbox-styles-and-templates.md)
+# [ボタン](button.md)
+# [ToolBar の概要](toolbar-overview.md)
+# [StackPanel](stackpanel.md)
+# [TreeView のスタイルとテンプレート](treeview-styles-and-templates.md)
+# [コントロールのカスタマイズ](control-customization.md)
+# [ヒント](tooltip.md)
+# [DockPanel 要素を使用して領域を分割する](how-to-partition-space-by-using-the-dockpanel-element.md)
+# [RichTextBox](richtextbox.md)
+# [TextBox から行のコレクションを取得する](how-to-get-a-collection-of-lines-from-a-textbox.md)
+# [グリッド間でサイズ設定プロパティを共有する](how-to-share-sizing-properties-between-grids.md)
+# [フレームのスタイルとテンプレート](frame-styles-and-templates.md)
+# [StatusBar のスタイルとテンプレート](statusbar-styles-and-templates.md)
+# [外観をカスタマイズできるコントロールの作成](creating-a-control-that-has-a-customizable-appearance.md)
+# [DataGrid のスタイルとテンプレート](datagrid-styles-and-templates.md)
+# [RadioButton のスタイルとテンプレート](radiobutton-styles-and-templates.md)
+# [GridSplitter](gridsplitter.md)
+# [ListView の概要](listview-overview.md)
+# [BetweenShowDelay プロパティを使用する](how-to-use-the-betweenshowdelay-property.md)
+# [要素から装飾を削除する](how-to-remove-an-adorner-from-an-element.md)
+# [DataGrid コントロールのサイズ変更方法](sizing-options-in-the-datagrid-control.md)
+# [テンプレートを使用して、GridView を使用する ListView のスタイルを設定する](how-to-use-templates-to-style-a-listview-that-uses-gridview.md)
+# [ScrollViewer の概要](scrollviewer-overview.md)
+# [方法のトピック](popup-how-to-topics.md)
+# [ProgressBar のスタイルとテンプレート](progressbar-styles-and-templates.md)
+# [DockPanel を作成する](how-to-create-a-dockpanel.md)
+# [方法のトピック](grid-how-to-topics.md)
+# [DockPanel](dockpanel.md)
+# [ToolBar](toolbar.md)
+# [エキスパンダーの概要](expander-overview.md)
+# [つまみのスタイルとテンプレート](thumb-syles-and-templates.md)
+# [イメージを回転させる](how-to-rotate-an-image.md)
+# [GroupBox テンプレートを定義する](how-to-define-a-groupbox-template.md)
+# [TextBox でカスタム コンテキスト メニューを使用する](how-to-use-a-custom-context-menu-with-a-textbox.md)
+# [ListView の各項目の MouseDoubleClick イベントを処理する](how-to-handle-the-mousedoubleclick-event-for-each-item-in-a-listview.md)
+# [TreeView](treeview.md)
+# [スタイルおよびテンプレート](styles-and-templates.md)
+# [つまみを使用したキャンバスのサイズ変更](how-to-resize-a-canvas-by-using-a-thumb.md)
+# [パネル](panel.md)
+# [イメージをグレースケールに変換する](how-to-convert-an-image-to-greyscale.md)
+# [ポップアップの概要](popup-overview.md)
+# [GridView の列ヘッダー スタイルおｙびテンプレートの概要](gridview-column-header-styles-and-templates-overview.md)
+# [TreeView での TreeViewItem の検索](how-to-find-a-treeviewitem-in-a-treeview.md)
+# [FlowDocumentScrollViewer](flowdocumentscrollviewer.md)
+# [ListView のカスタム表示モードを作成する](how-to-create-a-custom-view-mode-for-a-listview.md)
+# [テキスト編集コントロールでスペル チェックを有効にする](how-to-enable-spell-checking-in-a-text-editing-control.md)
+# [要素の Width プロパティを設定する](how-to-set-the-width-properties-of-an-element.md)
+# [RadioButton](radiobutton.md)
+# [DocumentViewer のスタイルとテンプレート](documentviewer-styles-and-templates.md)
+# [チュートリアル: DataGrid コントロールで SQL Server データベースのデータを表示する](walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md)
+# [メニューの概要](menu-overview.md)
+# [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](customizing-the-appearance-of-an-existing-control.md)
+# [方法のトピック](dockpanel-how-to-topics.md)
+# [TreeView の概要](treeview-overview.md)
+# [コンテキスト メニューでスペル チェックを使用する](how-to-use-spell-checking-with-a-context-menu.md)
+# [DatePicker](datepicker.md)
+# [ScrollBar](scrollbar.md)
+# [イメージを持つ Button を作成する](how-to-create-a-button-that-has-an-image.md)
+# [Adorners](adorners.md)
+# [方法のトピック](canvas-how-to-topics.md)
+# [GridView を使用して ListView コンテンツを表示する](how-to-display-listview-contents-by-using-a-gridview.md)
+# [イメージ要素を使用する](how-to-use-the-image-element.md)
+# [要素の Height プロパティを設定する](how-to-set-the-height-properties-of-an-element.md)
+# [GridLengthConverter オブジェクトを作成および使用する](how-to-create-and-use-a-gridlengthconverter-object.md)
+# [パネルの OnRender メソッドをオーバーライドする](how-to-override-the-panel-onrender-method.md)
+# [イメージ](image.md)
+# [RepeatButton](repeatbutton.md)
+# [装飾を実装する](how-to-implement-an-adorner.md)
+# [DataGrid コントロールの既定のキーボード動作とマウス動作](default-keyboard-and-mouse-behavior-in-the-datagrid-control.md)
+# [ToggleButton のスタイルとテンプレート](togglebutton-syles-and-templates.md)
+# [境界](border.md)
+# [スライダーの目盛りをカスタマイズする](how-to-customize-the-ticks-on-a-slider.md)
+# [PasswordBox](passwordbox.md)
+# [複雑なグリッドを作成する](how-to-create-a-complex-grid.md)
+# [パネルの子を装飾する](how-to-adorn-the-children-of-a-panel.md)
+# [概要](listview-overviews.md)
+# [Canvas の添付プロパティを使用して子要素を配置する](how-to-use-the-attached-properties-of-canvas-to-position-child-elements.md)
+# [ヘッダーがクリックされたときに GridView 列を並べ替える](how-to-sort-a-gridview-column-when-a-header-is-clicked.md)
+# [スタイルとテンプレート](styling-and-templating.md)
+# [WPF カスタム コントロールの UI オートメーション](ui-automation-of-a-wpf-custom-control.md)
+# [GridSplitter を使用して列のサイズを変更する](how-to-resize-columns-with-a-gridsplitter.md)
+# [ScrollViewer のコンテンツ スクロール メソッドを使用する](how-to-use-the-content-scrolling-methods-of-scrollviewer.md)
+# [ProgressBar](progressbar.md)
+# [メニュー](menu.md)
+# [ScrollChanged イベントの処理](how-to-handle-the-scrollchanged-event.md)
+# [Canvas を作成および使用する](how-to-create-and-use-a-canvas.md)
+# [ToolTip のスタイルとテンプレート](tooltip-styles-and-templates.md)
+# [コントロール](index.md)
+# [コントロールの作成の概要](control-authoring-overview.md)
+# [TabControl](tabcontrol.md)
+# [方法のトピック](richtextbox-how-to-topics.md)
+# [ポップアップ](popup.md)
+# [NavigationWindow のスタイルとテンプレート](navigationwindow-styles-and-templates.md)
+# [ContextMenu のスタイルとテンプレート](contextmenu-styles-and-templates.md)
+# [GroupBox のスタイルとテンプレート](groupbox-styles-and-templates.md)
+# [装飾の概要](adorners-overview.md)
+# [SelectedValue、SelectedValuePath、および SelectedItem を使用する](how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md)
+# [ContextMenu](contextmenu.md)
+# [GridView を実装する ListView で行のスタイルを設定する](how-to-style-a-row-in-a-listview-that-implements-a-gridview.md)
+# [ウィンドウのスタイルとテンプレート](window-styles-and-templates.md)
+# [ScrollViewer を持つエキスパンダーを作成する](how-to-create-an-expander-with-a-scrollviewer.md)
+# [方法のトピック](tooltip-how-to-topics.md)
+# [方法のトピック](panel-how-to-topics.md)
+# [ポップアップのカスタム位置を指定する](how-to-specify-a-custom-popup-position.md)
+# [グリッドの子要素を配置する](how-to-position-the-child-elements-of-a-grid.md)
+# [TextBox](textbox.md)
+# [TextBox コントロールにフォーカスを設定する](how-to-set-focus-in-a-textbox-control.md)
+# [TextBlock の概要](textblock-overview.md)
+# [ラベル](label.md)
+# [GridSplitter を使用して行のサイズを変更する](how-to-resize-rows-with-a-gridsplitter.md)
+# [ScrollViewer](scrollviewer.md)
+# [WPF のコンテンツ モデル](wpf-content-model.md)
+# [アクセス キーおよびテキスト折り返し機能を持つコントロールを作成する](how-to-create-a-control-that-has-an-access-key-and-text-wrapping.md)
+# [GroupBox](groupbox.md)
+# [FlowDocumentPageViewer](flowdocumentpageviewer.md)
+# [ListBox のスクロール速度を向上させる](how-to-improve-the-scrolling-performance-of-a-listbox.md)
+# [トリガーを使用して、ListView で選択された項目のスタイルを設定する](how-to-use-triggers-to-style-selected-items-in-a-listview.md)
+# [方法のトピック](scrollviewer-how-to-topics.md)
+# [単純または複雑な TreeView を作成する](how-to-create-simple-or-complex-treeviews.md)
+# [TextBox のテキストがいつ変更されたかを検出する](how-to-detect-when-text-in-a-textbox-has-changed.md)
+# [TextBox の概要](textbox-overview.md)
+# [区切り記号](separator.md)
+# [BulletDecorator](bulletdecorator.md)
+# [ContextMenu の概要](contextmenu-overview.md)
+# [Canvas の配置プロパティを取得または設定する](how-to-get-or-set-canvas-positioning-properties.md)
+# [方法のトピック](listbox-how-to-topics.md)
+# [フレーム](frame.md)
+# [TextBox コントロールでタブ文字を有効にする](how-to-enable-tab-characters-in-a-textbox-control.md)
+# [XAML を使用したボタンの作成](walkthrough-create-a-button-by-using-xaml.md)
+# [PrintDialog](printdialog.md)
+# [方法: DataGrid コントロールに行の詳細を追加する](how-to-add-row-details-to-a-datagrid-control.md)
+# [ドラッグされた GridView 列ヘッダーのスタイルを作成する](how-to-create-a-style-for-a-dragged-gridview-column-header.md)
+# [GridSplitter を表示されるようにする](how-to-make-sure-that-a-gridsplitter-is-visible.md)
+# [ScrollBar のスタイルとテンプレート](scrollbar-styles-and-templates.md)
+# [複数行の TextBox コントロールを作成する](how-to-create-a-multiline-textbox-control.md)
+# [方法: DataGrid コントロールでデータをグループ化、並べ替え、およびフィルター処理する](how-to-group-sort-and-filter-data-in-the-datagrid-control.md)
+# [Viewbox](viewbox.md)
+# [方法のトピック](textbox-how-to-topics.md)
diff --git a/docs/framework/wpf/controls/adorners-how-to-topics.md b/docs/framework/wpf/controls/adorners-how-to-topics.md
new file mode 100644
index 00000000000..e8dad2a6869
--- /dev/null
+++ b/docs/framework/wpf/controls/adorners-how-to-topics.md
@@ -0,0 +1,44 @@
+---
+title: "装飾に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "装飾 [WPF], 方法トピック"
+ms.assetid: e29d7516-d5e6-4500-bd4f-775e6f830984
+caps.latest.revision: 52
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# 装飾に関する「方法」トピック
+次の例では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 装飾フレームワークを使用して一般的なタスクを実行する方法を示します。  
+  
+## このセクションの内容  
+ [装飾を実装する](../../../../docs/framework/wpf/controls/how-to-implement-an-adorner.md)  
+ [要素に装飾をバインドする](../../../../docs/framework/wpf/controls/how-to-bind-an-adorner-to-an-element.md)  
+ [パネルの子を装飾する](../../../../docs/framework/wpf/controls/how-to-adorn-the-children-of-a-panel.md)  
+ [要素から装飾を削除する](../../../../docs/framework/wpf/controls/how-to-remove-an-adorner-from-an-element.md)  
+ [要素からすべての装飾を削除する](../../../../docs/framework/wpf/controls/how-to-remove-all-adorners-from-an-element.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.AdornedElementPlaceholder>  
+  
+ <xref:System.Windows.Documents.Adorner>  
+  
+ <xref:System.Windows.Documents.AdornerDecorator>  
+  
+ <xref:System.Windows.Media.AdornerHitTestResult>  
+  
+ <xref:System.Windows.Documents.AdornerLayer>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/adorners-overview.md b/docs/framework/wpf/controls/adorners-overview.md
new file mode 100644
index 00000000000..828b4a2246a
--- /dev/null
+++ b/docs/framework/wpf/controls/adorners-overview.md
@@ -0,0 +1,113 @@
+---
+title: "装飾の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾 [WPF], 装飾の概要"
+ms.assetid: 33d4c5c2-2daf-4e45-ba9a-5b673e2b8280
+caps.latest.revision: 35
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# 装飾の概要
+装飾は、ユーザーにビジュアル キューを提供するために使用する、特別な種類の <xref:System.Windows.FrameworkElement> です。  装飾にはさまざまな使用法があり、要素に機能ハンドルを追加したり、コントロールに関する状態情報を提供するためなどに使用できます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="about_Adorners"></a>   
+## 装飾について  
+ <xref:System.Windows.Documents.Adorner> は、<xref:System.Windows.UIElement> にバインドされるカスタム <xref:System.Windows.FrameworkElement> です。  装飾は、<xref:System.Windows.Documents.AdornerLayer> に描画されます。これは、常に装飾対象の要素またはそのコレクションの上に存在するレンダリング サーフェイスです。  装飾の描画は、その装飾がバインドされる <xref:System.Windows.UIElement> の描画とは独立して実行されます。  通常、装飾は、装飾対象の要素の左上に位置する標準の 2\-D 座標の原点を使用して、バインド先の要素に対して相対的な位置に配置されます。  
+  
+ 装飾の一般的な用途には、以下が含まれます。  
+  
+-   ユーザーが要素を何らかの方法で操作 \(サイズ変更、回転、位置変更など\) できるようにする機能ハンドルを <xref:System.Windows.UIElement> に追加する。  
+  
+-   さまざまな状態を示すために、または各種のイベントへの対応として、視覚的フィードバックを提供する。  
+  
+-   <xref:System.Windows.UIElement> に視覚的装飾をオーバーレイする。  
+  
+-   <xref:System.Windows.UIElement> の一部または全部を視覚的にマスクまたはオーバーライドする。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、ビジュアル要素を装飾するための基本的なフレームワークを提供します。  オブジェクトを装飾する際に使用する主なクラスと、その用途の一覧を次の表に示します。  その後に、いくつかの使用方法の例を示します。  
+  
+|||  
+|-|-|  
+|<xref:System.Windows.Documents.Adorner>|すべての具体的な装飾の実装の継承元になる抽象基本クラス。|  
+|<xref:System.Windows.Documents.AdornerLayer>|装飾される 1 つ以上の要素について、装飾のレンダリング層を表すクラス。|  
+|<xref:System.Windows.Documents.AdornerDecorator>|1 つの装飾層を要素のコレクションに関連付けることを可能にするクラス。|  
+  
+<a name="implement_custom_Adorner"></a>   
+## カスタム装飾を実装する  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] が提供する装飾フレームワークは、カスタム装飾の作成をサポートすることを主な目的としています。  抽象型 <xref:System.Windows.Documents.Adorner> クラスから継承されるクラスを実装することにより、カスタムの Adorner が作成されます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Documents.Adorner> の親は、装飾される要素ではなく、<xref:System.Windows.Documents.Adorner> を描画する <xref:System.Windows.Documents.AdornerLayer> です。  
+  
+ 簡単な装飾を実装するクラスを次の例に示します。  この例の装飾は、<xref:System.Windows.UIElement> の四隅を円で装飾します。  
+  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_SimpleCircleAdornerBody](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_simplecircleadornerbody)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_SimpleCircleAdornerBody](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_simplecircleadornerbody)]  
+  
+ <xref:System.Windows.Controls.TextBox> に適用された SimpleCircleAdorner を次の図に示します。  
+  
+ ![装飾の例: 装飾された TextBox](../../../../docs/framework/wpf/controls/media/adornedtextbox.png "AdornedTextBox")  
+  
+<a name="rendering_behavior_for_Adorners"></a>   
+## 装飾のレンダリング動作  
+ Adorner 自体には継承されたレンダリング動作は含まれず、Adorner のレンダリングは Adorner の実装者の責任で行う必要がある点について注意が必要です。  レンダリング動作を実装する一般的な方法としては、<xref:System.Windows.UIElement.OnRender%2A> メソッドをオーバーライドし、1 つ以上の <xref:System.Windows.Media.DrawingContext> オブジェクトを使用して、装飾のビジュアルを必要に応じて描画します \(上の例を参照\)。  
+  
+> [!NOTE]
+>  装飾層に配置されているすべてのものは、設定した他のすべてのスタイルの上に描画されます。  つまり、装飾は常に視覚的に最上位にあり、[z オーダー](GTMT)を使用してオーバーライドすることはできません。  
+  
+<a name="adorner_events_hittest"></a>   
+## イベントおよびヒット テスト  
+ 他のすべての <xref:System.Windows.FrameworkElement> と同様に、装飾も入力イベントを受け取ります。  装飾は、それが装飾する要素よりも常に高い [z オーダー](GTMT)を持つため、下位にある装飾対象の要素に向けられた入力イベント \(たとえば <xref:System.Windows.UIElement.Drop> や <xref:System.Windows.UIElement.MouseMove>\) であっても受け取ります。  装飾は、特定の入力イベントをリッスンし、それらのイベントを再び発生させることによって下位にある装飾対象の要素に渡すことができます。  
+  
+ 装飾を通過させてその下にある要素のヒット テストを有効にするには、その装飾でヒット テストの <xref:System.Windows.UIElement.IsHitTestVisible%2A> プロパティを **false** に設定します。  ヒット テストの詳細については、次を参照してください。  
+  
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md).  
+  
+<a name="adorn_single_element"></a>   
+## 単一の UIElement を装飾する  
+ Adorner を特定の <xref:System.Windows.UIElement> にバインドするには、次の手順を実行します。  
+  
+1.  静的メソッド <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> を呼び出し、修飾対象の <xref:System.Windows.UIElement> の <xref:System.Windows.Documents.AdornerLayer> オブジェクトを取得します。  <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> は、指定した <xref:System.Windows.UIElement> を起点にしてビジュアル ツリーを上方向に検索し、最初に見つかった修飾層を返します。  \(Adorner のレイヤーが見つからない場合は、メソッドにより null が返されます。\)  
+  
+2.  <xref:System.Windows.Documents.AdornerLayer.Add%2A> メソッドを呼び出し、装飾を対象の <xref:System.Windows.UIElement> にバインドします。  
+  
+ 次の例では、SimpleCircleAdorner \(前述\) を <xref:System.Windows.Controls.TextBox> \(名前は *myTextBox*\) にバインドしています。  
+  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_AdornSingleElement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_adornsingleelement)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_AdornSingleElement](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_adornsingleelement)]  
+  
+> [!NOTE]
+>  Adorner を別の要素にバインドするために [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用することは、現在サポートされていません。  
+  
+<a name="adorn_children_panel"></a>   
+## パネルの子を装飾する  
+ Adorner を <xref:System.Windows.Controls.Panel> の子にバインドするには、次の手順を実行します。  
+  
+1.  `静的`メソッド <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> を呼び出し、子が装飾の対象となる要素の装飾層を検出します。  
+  
+2.  親要素の子を列挙し、<xref:System.Windows.Documents.AdornerLayer.Add%2A> メソッドを呼び出して Adorner を各子要素にバインドします。  
+  
+ 次の例では、SimpleCircleAdorner \(前述\) を <xref:System.Windows.Controls.StackPanel> の子 \(名前は *myStackPanel*\) にバインドしています。  
+  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_AdornChildren](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_adornchildren)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_AdornChildren](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_adornchildren)]  
+  
+## 参照  
+ <xref:System.Windows.Media.AdornerHitTestResult>   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/adorners-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/adorners.md b/docs/framework/wpf/controls/adorners.md
new file mode 100644
index 00000000000..dca891b1e99
--- /dev/null
+++ b/docs/framework/wpf/controls/adorners.md
@@ -0,0 +1,41 @@
+---
+title: "Adorners | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "装飾 [WPF]"
+ms.assetid: 5d5f656b-8e05-4839-9d53-b0324d902aa9
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# Adorners
+ここでは、装飾と [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の装飾フレームワークに関する情報を提供します。  
+  
+## このセクションの内容  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/adorners-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.AdornedElementPlaceholder>  
+  
+ <xref:System.Windows.Documents.Adorner>  
+  
+ <xref:System.Windows.Documents.AdornerDecorator>  
+  
+ <xref:System.Windows.Media.AdornerHitTestResult>  
+  
+ <xref:System.Windows.Documents.AdornerLayer>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/border.md b/docs/framework/wpf/controls/border.md
new file mode 100644
index 00000000000..342ee806394
--- /dev/null
+++ b/docs/framework/wpf/controls/border.md
@@ -0,0 +1,39 @@
+---
+title: "境界 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Border コントロール [WPF]"
+  - "境界 [WPF]"
+  - "コントロール [WPF], 境界"
+ms.assetid: 51739f83-b5a2-489b-854b-30607e74a502
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# 境界
+次のサンプルでは、<xref:System.Windows.Controls.Border> 要素のプロパティを動的に変更する方法を示します。  
+  
+## このセクションの内容  
+ [BorderThickness 値をアニメーション化する](../../../../docs/framework/wpf/controls/how-to-animate-a-borderthickness-value.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Decorator>  
+  
+ <xref:System.Windows.Controls.Border>  
+  
+## 関連項目  
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)  
+  
+ [配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/bulletdecorator.md b/docs/framework/wpf/controls/bulletdecorator.md
new file mode 100644
index 00000000000..d3e5e77e76a
--- /dev/null
+++ b/docs/framework/wpf/controls/bulletdecorator.md
@@ -0,0 +1,32 @@
+---
+title: "BulletDecorator | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "BulletDecorator コントロール [WPF]"
+  - "コントロール [WPF], BulletDecorator"
+ms.assetid: 1756cabf-59b4-47a7-883d-1bdf2e5abe00
+caps.latest.revision: 67
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 67
+---
+# BulletDecorator
+<xref:System.Windows.Controls.Primitives.BulletDecorator> には、<xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> および <xref:System.Windows.Controls.Decorator.Child%2A> という 2 つのコンテンツ プロパティがあります。  <xref:System.Windows.Controls.Primitives.BulletDecorator.Bullet%2A> プロパティは、行頭文字として使用する <xref:System.Windows.UIElement> を定義します。  <xref:System.Windows.Controls.Decorator.Child%2A> プロパティは、行頭文字に合わせて視覚的に配置する <xref:System.Windows.UIElement> を定義します。  
+  
+ <xref:System.Windows.Controls.Primitives.BulletDecorator> を使用するいくつかのコントロールの例を次の図に示します。  
+  
+ ![3 つの BulletDecorator: CheckBox、RadioButton、TextBox](../../../../docs/framework/wpf/controls/media/bulletdecorator.png "BulletDecorator")  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.BulletDecorator>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/button-styles-and-templates.md b/docs/framework/wpf/controls/button-styles-and-templates.md
new file mode 100644
index 00000000000..f7c93be8e88
--- /dev/null
+++ b/docs/framework/wpf/controls/button-styles-and-templates.md
@@ -0,0 +1,65 @@
+---
+title: "ボタンのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Button [WPF], スタイルおよびテンプレート"
+  - "ControlTemplate [WPF], ボタン"
+  - "パーツ [WPF], ボタン"
+  - "状態 [WPF], ボタン"
+  - "スタイル [WPF], ボタン"
+  - "テンプレート [WPF], ボタン"
+ms.assetid: e223c759-f8c4-4717-acfb-b1e40bdf5f3b
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# ボタンのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Button> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Button のパーツ  
+ <xref:System.Windows.Controls.Button> コントロールには、名前付きのパーツは存在しません。  
+  
+## Button の状態  
+ 次の表は、<xref:System.Windows.Controls.Button> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Button ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Button> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Button](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/button.xaml#button)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/button.md b/docs/framework/wpf/controls/button.md
new file mode 100644
index 00000000000..bf01acc96d7
--- /dev/null
+++ b/docs/framework/wpf/controls/button.md
@@ -0,0 +1,36 @@
+---
+title: "ボタン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Button コントロール [WPF]"
+  - "コントロール [WPF], ボタン"
+ms.assetid: a9d8f5a5-c98c-463e-808a-5a4e63173098
+caps.latest.revision: 80
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 80
+---
+# ボタン
+<xref:System.Windows.Controls.Button> コントロールは、マウス、キーボード、スタイラスなどの入力デバイスからのユーザー入力に反応して、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを発生させます。  <xref:System.Windows.Controls.Button> は、テキストなどの単純なコンテンツも、イメージ コントロールや <xref:System.Windows.Controls.Panel> コントロールなどの複雑なコンテンツも含むことができる、基本[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] コンポーネントです。  
+  
+ ![ボタンの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-buttons.bmp "SS\_CTL\_buttons")  
+  
+## このセクションの内容  
+ [イメージを持つ Button を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-button-that-has-an-image.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Button>  
+ <xref:System.Windows.Controls.Primitives.ButtonBase>  
+ <xref:System.Windows.Controls.RadioButton>  
+ <xref:System.Windows.Controls.Primitives.RepeatButton>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/calendar-styles-and-templates.md b/docs/framework/wpf/controls/calendar-styles-and-templates.md
new file mode 100644
index 00000000000..9eae08a273a
--- /dev/null
+++ b/docs/framework/wpf/controls/calendar-styles-and-templates.md
@@ -0,0 +1,148 @@
+---
+title: "カレンダーのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Calendar [WPF], スタイルおよびテンプレート"
+  - "ControlTemplate [WPF], Calendar"
+  - "パーツ [WPF], Calendar"
+  - "状態 [WPF], Calendar"
+  - "スタイル [WPF], Calendar"
+  - "テンプレート [WPF], Calendar"
+ms.assetid: f4fcf046-7a8f-41b8-b5a8-534b64e0345c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# カレンダーのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Calendar> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Calendar のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Calendar> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_CalendarItem|<xref:System.Windows.Controls.Primitives.CalendarItem>|<xref:System.Windows.Controls.Calendar> に現在表示されている月または年。|  
+|PART\_Root|<xref:System.Windows.Controls.Panel>|<xref:System.Windows.Controls.Primitives.CalendarItem> を格納するパネル。|  
+  
+## Calendar の状態  
+ 次の表は、<xref:System.Windows.Controls.Calendar> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## CalendarItem のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.CalendarItem> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Root|<xref:System.Windows.FrameworkElement>|コントロールのルートです。|  
+|PART\_PreviousButton|<xref:System.Windows.Controls.Button>|このボタンをクリックすると、カレンダーの前のページを表示します。|  
+|PART\_NextButton|<xref:System.Windows.Controls.Button>|このボタンをクリックすると、カレンダーの次のページを表示します。|  
+|PART\_HeaderButton|<xref:System.Windows.Controls.Button>|月モード、年モード、および 10 年単位モードを切り替えるボタンです。|  
+|PART\_MonthView|<xref:System.Windows.Controls.Grid>|月モードの場合にコンテンツをホストします。|  
+|PART\_YearView|<xref:System.Windows.Controls.Grid>|年モードか 10 年単位のモードの場合にコンテンツをホストします。|  
+|PART\_DisabledVisual|<xref:System.Windows.FrameworkElement>|無効な状態のオーバーレイ。|  
+|DayTitleTemplate|<xref:System.Windows.DataTemplate>|視覚的な構造を表す <xref:System.Windows.DataTemplate>。|  
+  
+## CalendarItem の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.CalendarItem> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal State|CommonStates|既定の状態です。|  
+|Disabled State|CommonStates|<xref:System.Windows.UIElement.IsEnabled%2A> プロパティが `false` であるときの予定表の状態。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## CalendarDayButton のパーツ  
+ <xref:System.Windows.Controls.Primitives.CalendarDayButton> コントロールには、名前付きのパーツは存在しません。  
+  
+## CalendarDayButton の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.CalendarDayButton> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|<xref:System.Windows.Controls.Primitives.CalendarDayButton> が無効になっています。|  
+|MouseOver|CommonStates|マウス ポインターは、<xref:System.Windows.Controls.Primitives.CalendarDayButton> の上に置かれています。|  
+|Pressed|CommonStates|<xref:System.Windows.Controls.Primitives.CalendarDayButton> が押されています。|  
+|Selected|SelectionStates|ボタンが選択されています。|  
+|Unselected|SelectionStates|ボタンが選択されていません。|  
+|CalendarButtonFocused|CalendarButtonFocusStates|ボタンにフォーカスがあります。|  
+|CalendarButtonUnfocused|CalendarButtonFocusStates|ボタンにフォーカスがありません。|  
+|Focused|FocusStates|ボタンにフォーカスがあります。|  
+|Unfocused|FocusStates|ボタンにフォーカスがありません。|  
+|Active|ActiveStates|ボタンがアクティブです。|  
+|Inactive|ActiveStates|ボタンがアクティブではありません。|  
+|RegularDay|DayStates|ボタンが <xref:System.DateTime.Today%2A?displayProperty=fullName> を表していません。|  
+|Today|DayStates|ボタンが <xref:System.DateTime.Today%2A?displayProperty=fullName> を表しています。|  
+|NormalDay|BlackoutDayStates|このボタンは、選択できる日を表します。|  
+|BlackoutDay|BlackoutDayStates|このボタンは、選択できない日を表します。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## CalendarButton のパーツ  
+ <xref:System.Windows.Controls.Primitives.CalendarButton> コントロールには、名前付きのパーツは存在しません。  
+  
+## CalendarButton の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.CalendarButton> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|<xref:System.Windows.Controls.Primitives.CalendarButton> が無効になっています。|  
+|MouseOver|CommonStates|マウス ポインターは、<xref:System.Windows.Controls.Primitives.CalendarButton> の上に置かれています。|  
+|Pressed|CommonStates|<xref:System.Windows.Controls.Primitives.CalendarButton> が押されています。|  
+|Selected|SelectionStates|ボタンが選択されています。|  
+|Unselected|SelectionStates|ボタンが選択されていません。|  
+|CalendarButtonFocused|CalendarButtonFocusStates|ボタンにフォーカスがあります。|  
+|CalendarButtonUnfocused|CalendarButtonFocusStates|ボタンにフォーカスがありません。|  
+|Focused|FocusStates|ボタンにフォーカスがあります。|  
+|Unfocused|FocusStates|ボタンにフォーカスがありません。|  
+|Active|ActiveStates|ボタンがアクティブです。|  
+|Inactive|ActiveStates|ボタンがアクティブではありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Calendar ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Calendar> コントロールの <xref:System.Windows.Controls.ControlTemplate> と関連の型を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Calendar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/calendar.xaml#calendar)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/calendar.md b/docs/framework/wpf/controls/calendar.md
new file mode 100644
index 00000000000..9b089b2fd3b
--- /dev/null
+++ b/docs/framework/wpf/controls/calendar.md
@@ -0,0 +1,63 @@
+---
+title: "Calendar | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Calendar コントロール [WPF]"
+  - "コントロール [WPF], Calendar"
+ms.assetid: ee844e4a-eefe-48e2-bd0d-1d82cc5e960b
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# Calendar
+カレンダーは、ユーザーがビジュアルな予定表を使用して日付を選択できるコントロールです。  
+  
+ <xref:System.Windows.Controls.Calendar> コントロールは、単独で使用することも、<xref:System.Windows.Controls.DatePicker> コントロールのドロップダウン部分として使用することもできます。  詳細については、「<xref:System.Windows.Controls.DatePicker>」を参照してください。  
+  
+ 次の図は、2 つの <xref:System.Windows.Controls.Calendar> コントロールを示します。選択したものと暗転表示された日付が、一方には含まれていますが、他方には含まれていません。  
+  
+ ![予定表コントロール](../../../../docs/framework/wpf/controls/media/ndp-calendarcontrols.png "NDP\_CalendarControls")  
+Calendar コントロール  
+  
+ 次の表は、一般的に <xref:System.Windows.Controls.Calendar> に関連付けられているタスクに関する情報を示しています。  
+  
+|タスク|実装|  
+|---------|--------|  
+|選択できない日付を指定します。|<xref:System.Windows.Controls.Calendar.BlackoutDates%2A> プロパティを使用します。|  
+|<xref:System.Windows.Controls.Calendar> に 1 か月分、1 年分、または 10 年分を表示します。|<xref:System.Windows.Controls.Calendar.DisplayMode%2A> プロパティを月、年、または 10 年に設定します。|  
+|ユーザーが日付、日付の範囲、または日付の複数の範囲を選択できるかどうかを指定します。|<xref:System.Windows.Controls.Calendar.SelectionMode%2A> を使用します。|  
+|<xref:System.Windows.Controls.Calendar> に表示される日付の範囲を指定します。|<xref:System.Windows.Controls.Calendar.DisplayDateStart%2A> プロパティおよび <xref:System.Windows.Controls.Calendar.DisplayDateEnd%2A> プロパティを使用します。|  
+|現在の日付が強調表示されるかどうかを指定します。|<xref:System.Windows.Controls.Calendar.IsTodayHighlighted%2A> プロパティを使用します。  既定では、<xref:System.Windows.Controls.Calendar.IsTodayHighlighted%2A> は `true` に設定されています。|  
+|<xref:System.Windows.Controls.Calendar> のサイズを変更します。|<xref:System.Windows.Controls.Viewbox> を使用するか、<xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティを <xref:System.Windows.Media.ScaleTransform> に設定します。  <xref:System.Windows.Controls.Calendar> の <xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティを設定した場合、実際の予定表のサイズは変更されない点に注意してください。|  
+  
+ <xref:System.Windows.Controls.Calendar> コントロールでは、マウスまたはキーボードによる基本的なナビゲーションを使用できます。  キーボード ナビゲーションを次の表にまとめます。  
+  
+|ショートカット キー|<xref:System.Windows.Controls.Calendar.DisplayMode%2A>|動作|  
+|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|--------|  
+|方向キー|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.SelectionMode%2A> プロパティが <xref:System.Windows.Controls.CalendarSelectionMode> に設定されていない場合、<xref:System.Windows.Controls.Calendar.SelectedDate%2A> プロパティを変更します。|  
+|方向キー|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> プロパティの月を変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|方向キー|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> の年を変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|Shift \+ 方向キー|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.SelectionMode%2A> が <xref:System.Windows.Controls.CalendarSelectionMode> または <xref:System.Windows.Controls.CalendarSelectionMode> に設定されていない場合に、日付の選択範囲を拡張します。|  
+|Home|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.SelectedDate%2A> を現在の月の最初の日に変更します。|  
+|Home|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> の月を年の最初の月に変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|Home|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> の年を 10 年間の最初の年に変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|End|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.SelectedDate%2A> を現在の月の最後の日に変更します。|  
+|End|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> の月を年の最後の月に変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|End|<xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayDate%2A> の年を 10 年間の最後の年に変更します。  <xref:System.Windows.Controls.Calendar.SelectedDate%2A> は変更されません。|  
+|Ctrl \+ ↑|どれでも可|次に大きい <xref:System.Windows.Controls.Calendar.DisplayMode%2A> に切り替えます。  <xref:System.Windows.Controls.Calendar.DisplayMode%2A> が既に <xref:System.Windows.Controls.CalendarMode> の場合には、処理は行われません。|  
+|Ctrl \+ ↓|どれでも可|次に小さい <xref:System.Windows.Controls.Calendar.DisplayMode%2A> に切り替えます。  <xref:System.Windows.Controls.Calendar.DisplayMode%2A> が既に <xref:System.Windows.Controls.CalendarMode> の場合には、処理は行われません。|  
+|Space キーまたは Enter キー|<xref:System.Windows.Controls.CalendarMode> または <xref:System.Windows.Controls.CalendarMode>|<xref:System.Windows.Controls.Calendar.DisplayMode%2A> を、フォーカスが設定されている項目によって表された <xref:System.Windows.Controls.CalendarMode> または <xref:System.Windows.Controls.CalendarMode> に切り替えます。|  
+  
+## 参照  
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/canvas-how-to-topics.md b/docs/framework/wpf/controls/canvas-how-to-topics.md
new file mode 100644
index 00000000000..7bef5718a07
--- /dev/null
+++ b/docs/framework/wpf/controls/canvas-how-to-topics.md
@@ -0,0 +1,54 @@
+---
+title: "キャンバスに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Canvas コントロール, 方法トピック"
+  - "コントロール, Canvas"
+ms.assetid: 5c8f5bca-7ba9-4526-a9bf-0852351dbe8a
+caps.latest.revision: 70
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# キャンバスに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Canvas> 要素を使用して、子要素を絶対位置に配置する方法について説明します。  
+  
+## このセクションの内容  
+ [Canvas のコンテンツを Border で囲む](../../../../docs/framework/wpf/controls/how-to-wrap-a-border-around-the-content-of-a-canvas.md)  
+ [Canvas の配置プロパティを取得または設定する](../../../../docs/framework/wpf/controls/how-to-get-or-set-canvas-positioning-properties.md)  
+ [Canvas を作成および使用する](../../../../docs/framework/wpf/controls/how-to-create-and-use-a-canvas.md)  
+ [Canvas の添付プロパティを使用して子要素を配置する](../../../../docs/framework/wpf/controls/how-to-use-the-attached-properties-of-canvas-to-position-child-elements.md)  
+ [つまみを使用したキャンバスのサイズ変更](../../../../docs/framework/wpf/controls/how-to-resize-a-canvas-by-using-a-thumb.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/canvas.md b/docs/framework/wpf/controls/canvas.md
new file mode 100644
index 00000000000..d7fafe78b80
--- /dev/null
+++ b/docs/framework/wpf/controls/canvas.md
@@ -0,0 +1,51 @@
+---
+title: "Canvas | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Canvas コントロール [WPF]"
+  - "コントロール [WPF], Canvas"
+  - "レイアウト [WPF], Canvas コントロール"
+ms.assetid: fdb390e9-1bba-4b5f-87fe-c3bc246fa7e9
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# Canvas
+<xref:System.Windows.Controls.Canvas> は、子要素の絶対配置を可能にするレイアウト コントロールです。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/canvas-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/change-selection-in-a-richtextbox-programmatically.md b/docs/framework/wpf/controls/change-selection-in-a-richtextbox-programmatically.md
new file mode 100644
index 00000000000..f2a828b82fb
--- /dev/null
+++ b/docs/framework/wpf/controls/change-selection-in-a-richtextbox-programmatically.md
@@ -0,0 +1,38 @@
+---
+title: "プログラムによる RichTextBox での選択の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変更 (RichTextBox での選択を) [WPF]"
+  - "変更 (テキスト ボックスでの選択を) [WPF]"
+ms.assetid: f1213205-1ad7-4cd2-b115-460173cc5aa3
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# プログラムによる RichTextBox での選択の変更
+この例では、<xref:System.Windows.Controls.RichTextBox> での現在の選択をプログラムで変更する方法を示します。  この選択は、ユーザーがユーザー インターフェイスを使用してコンテンツを選択することと同じです。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] コードは、簡単なコンテンツを含む <xref:System.Windows.Controls.RichTextBox> コントロールを記述しています。  
+  
+ [!code-xml[RichTextBoxMiscSnippets_snip#ChangeSelectionProgrammaticalyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/ChangeSelectionProgrammaticaly.xaml#changeselectionprogrammaticalyexamplewholepage)]  
+  
+## 使用例  
+ 次のコードは、ユーザーが <xref:System.Windows.Controls.RichTextBox> の内部をクリックしたときに任意のテキストをプログラムで選択します。  
+  
+ [!code-csharp[RichTextBoxMiscSnippets_snip#ChangeSelectionProgrammaticalyCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/ChangeSelectionProgrammaticaly.xaml.cs#changeselectionprogrammaticalycodeexamplewholepage)]
+ [!code-vb[RichTextBoxMiscSnippets_snip#ChangeSelectionProgrammaticalyCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/VisualBasic/ChangeSelectionProgrammaticaly.xaml.vb#changeselectionprogrammaticalycodeexamplewholepage)]  
+  
+## 参照  
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/checkbox-styles-and-templates.md b/docs/framework/wpf/controls/checkbox-styles-and-templates.md
new file mode 100644
index 00000000000..be8e062eea7
--- /dev/null
+++ b/docs/framework/wpf/controls/checkbox-styles-and-templates.md
@@ -0,0 +1,67 @@
+---
+title: "CheckBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CheckBox [WPF], スタイルおよびテンプレート"
+  - "ControlTemplate [WPF], CheckBox"
+  - "パーツ [WPF], CheckBox"
+  - "状態 [WPF], CheckBox"
+  - "スタイル [WPF], CheckBox"
+  - "テンプレート [WPF], CheckBox"
+ms.assetid: bfdaec96-d101-4d3d-864d-c27e6b621d03
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# CheckBox のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.CheckBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## CheckBox のパーツ  
+ <xref:System.Windows.Controls.CheckBox> コントロールには、名前付きのパーツは存在しません。  
+  
+## CheckBox の状態  
+ 次の表は、<xref:System.Windows.Controls.CheckBox> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|オン|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `true` なので、|  
+|Unchecked|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `false` なので、|  
+|Indeterminate|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsThreeState%2A> が `true` で、<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> が `null` です。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## CheckBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.CheckBox> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#CheckBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/checkbox.xaml#checkbox)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/checkbox.md b/docs/framework/wpf/controls/checkbox.md
new file mode 100644
index 00000000000..9190dad1fe4
--- /dev/null
+++ b/docs/framework/wpf/controls/checkbox.md
@@ -0,0 +1,38 @@
+---
+title: "CheckBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "CheckBox コントロール [WPF]"
+  - "コントロール [WPF], CheckBox"
+ms.assetid: ee701cc2-968b-4683-8f81-3fafd8542700
+caps.latest.revision: 74
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 74
+---
+# CheckBox
+アプリケーションの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] で <xref:System.Windows.Controls.CheckBox> を使用すると、ユーザーが選択または選択解除できるオプションを表示できます。  チェック ボックスは、単独で使用することも、2 つ以上をグループ化することもできます。  
+  
+ さまざまな状態の <xref:System.Windows.Controls.CheckBox> を次の図に示します。  
+  
+ ![チェック ボックスの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-checkbox.png "SS\_CTL\_checkbox")  
+さまざまな状態の CheckBox コントロール  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.CheckBox>  
+ <xref:System.Windows.Controls.RadioButton>  
+ <xref:System.Windows.Controls.Primitives.ButtonBase>  
+ <xref:System.Windows.Controls.Primitives.RepeatButton>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/combobox-styles-and-templates.md b/docs/framework/wpf/controls/combobox-styles-and-templates.md
new file mode 100644
index 00000000000..85ccec8f3e5
--- /dev/null
+++ b/docs/framework/wpf/controls/combobox-styles-and-templates.md
@@ -0,0 +1,96 @@
+---
+title: "ComboBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ComboBox [WPF], スタイルおよびテンプレート"
+  - "ControlTemplate [WPF], ComboBox"
+  - "パーツ [WPF], ComboBox"
+  - "状態 [WPF], ComboBox"
+  - "スタイル [WPF], ComboBox"
+  - "テンプレート [WPF], ComboBox"
+ms.assetid: b0662fa1-16d7-4320-b26b-c1804e565a44
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# ComboBox のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ComboBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ComboBox のパーツ  
+ 次の表は、<xref:System.Windows.Controls.ComboBox> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_EditableTextBox|<xref:System.Windows.Controls.TextBox>|<xref:System.Windows.Controls.ComboBox> のテキストが格納されます。|  
+|PART\_Popup|<xref:System.Windows.Controls.Primitives.Popup>|コンボ ボックスの項目を格納するドロップダウンです。|  
+  
+ <xref:System.Windows.Controls.ComboBox> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.ComboBox> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## ComboBox の状態  
+ 次の表は、<xref:System.Windows.Controls.ComboBox> コントロールの状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|MouseOver|CommonStates|<xref:System.Windows.Controls.ComboBox> コントロール上にマウス ポインターがあります。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|FocusedDropDown|FocusStates|<xref:System.Windows.Controls.ComboBox> のドロップダウンにフォーカスがあります。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+|Editable|EditStates|<xref:System.Windows.Controls.ComboBox.IsEditable%2A> プロパティが `true` である。|  
+|Uneditable|EditStates|<xref:System.Windows.Controls.ComboBox.IsEditable%2A> プロパティが `false` である。|  
+  
+## ComboBoxItem のパーツ  
+ <xref:System.Windows.Controls.ComboBoxItem> コントロールには、名前付きのパーツは存在しません。  
+  
+## ComboBoxItem の状態  
+ 次の表は、<xref:System.Windows.Controls.ComboBoxItem> コントロールの状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|MouseOver|CommonStates|<xref:System.Windows.Controls.ComboBox> コントロール上にマウス ポインターがあります。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Selected|SelectionStates|項目は選択されています。|  
+|Unselected|SelectionStates|項目は選択されていません。|  
+|SelectedUnfocused|SelectionStates|項目は選択されていますが、フォーカスはありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ComboBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ComboBox> コントロールの <xref:System.Windows.Controls.ControlTemplate> と関連の型を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ComboBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/combobox.xaml#combobox)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/combobox.md b/docs/framework/wpf/controls/combobox.md
new file mode 100644
index 00000000000..c4365b1c12c
--- /dev/null
+++ b/docs/framework/wpf/controls/combobox.md
@@ -0,0 +1,36 @@
+---
+title: "ComboBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ComboBox コントロール [WPF]"
+  - "コントロール [WPF], ComboBox"
+ms.assetid: fe0c2f62-fec2-4c41-a37e-5773d284170c
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# ComboBox
+<xref:System.Windows.Controls.ComboBox> コントロールは、ユーザーにオプションの一覧を提供します。  コントロールの展開または折りたたみを行うと、一覧の表示\/非表示が切り替わります。  既定の状態では、一覧は折りたたまれ、選択肢が 1 つだけ表示されています。  ユーザーは、ボタンをクリックして、オプションの完全な一覧を確認します。  
+  
+ さまざまな状態の <xref:System.Windows.Controls.ComboBox> を次の図に示します。  
+  
+ ![既定の状態と押された状態のコンボ ボックス](../../../../docs/framework/wpf/controls/media/ss-ctl-combobox.gif "SS\_CTL\_combobox")  
+折りたたんだ状態と展開した状態  
+  
+## このセクションの内容  
+ [How to: Get a ComboBoxItem](http://msdn.microsoft.com/ja-jp/8a0d2622-64b6-41fc-bf80-9669a1eacb53)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ComboBox>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/contextmenu-overview.md b/docs/framework/wpf/controls/contextmenu-overview.md
new file mode 100644
index 00000000000..f411d691135
--- /dev/null
+++ b/docs/framework/wpf/controls/contextmenu-overview.md
@@ -0,0 +1,76 @@
+---
+title: "ContextMenu の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ContextMenu コントロール [WPF], ContextMenu コントロールの概要"
+  - "コントロール, ContextMenu"
+ms.assetid: 16909c42-799a-4561-91e0-7d69dcfeea91
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ContextMenu の概要
+<xref:System.Windows.Controls.ContextMenu> クラスは、コンテキスト固有の <xref:System.Windows.Controls.Menu> を使用して機能を公開する要素を表します。  通常、ユーザーはマウス ボタンを右クリックすることで、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に <xref:System.Windows.Controls.ContextMenu> を公開します。  ここでは、<xref:System.Windows.Controls.ContextMenu> 要素について説明し、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] とコードでそれを使用する例を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="contextmenu_control"></a>   
+## ContextMenu コントロール  
+ <xref:System.Windows.Controls.ContextMenu> は特定のコントロールに結合されます。  <xref:System.Windows.Controls.ContextMenu> 要素を使用すると、<xref:System.Windows.Controls.Button> などの特定のコントロールに関連付けられているコマンドやオプションを指定する項目の一覧を、ユーザーに提供できます。  ユーザーは、コントロールを右クリックすることで、メニューを表示します。  通常、<xref:System.Windows.Controls.MenuItem> をクリックすると、サブメニューが開くか、アプリケーションがコマンドを実行します。  
+  
+<a name="creating_contextmenus"></a>   
+## ContextMenu の作成  
+ サブメニューのある <xref:System.Windows.Controls.ContextMenu> を作成する方法を次の例に示します。  <xref:System.Windows.Controls.ContextMenu> コントロールは、ボタン コントロールに結合されます。  
+  
+ [!code-xml[ContextMenu#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenu/CSharp/Pane1.xaml#1)]  
+  
+ [!code-csharp[ContextMenu#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ContextMenu/CSharp/Pane1.xaml.cs#2)]
+ [!code-vb[ContextMenu#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ContextMenu/VisualBasic/Pane1.xaml.vb#2)]  
+  
+<a name="applying_styles_to_contextmenu"></a>   
+## ContextMenu へのスタイルの適用  
+ コントロールの <xref:System.Windows.Style> を使用すると、カスタム コントロールを作成しなくても、<xref:System.Windows.Controls.ContextMenu> の外観や動作を大幅に変更できます。  視覚プロパティの設定に加えて、コントロールの一部にスタイルを適用することもできます。  たとえば、プロパティを使用したコントロールの動作を一部変更したり、<xref:System.Windows.Controls.ContextMenu> に対するパーツの追加やレイアウトの変更を行ったりすることができます。  <xref:System.Windows.Controls.ContextMenu> コントロールにスタイルを追加するいくつかの方法を次の例に示します。  
+  
+ 最初の例は、`SimpleSysResources` という名前のスタイルを定義し、スタイルで現在のシステム設定を使用する方法を示しています。  この例では、<xref:System.Windows.Controls.ContextMenu> の <xref:System.Windows.Controls.Control.Background%2A> の色として <xref:System.Windows.SystemColors.MenuHighlightBrushKey%2A> を割り当て、<xref:System.Windows.Controls.Control.Foreground%2A> の色として <xref:System.Windows.SystemColors.MenuTextBrushKey%2A> を割り当てています。  
+  
+```  
+<Style x:Key="SimpleSysResources" TargetType="{x:Type MenuItem}">  
+  <Setter Property = "Background" Value=   
+    "{DynamicResource {x:Static SystemColors.MenuHighlightBrushKey}}"/>  
+  <Setter Property = "Foreground" Value=   
+    "{DynamicResource {x:Static SystemColors.MenuTextBrushKey}}"/>  
+</Style>  
+```  
+  
+ 次の例では、<xref:System.Windows.Trigger> 要素を使用して、<xref:System.Windows.Controls.ContextMenu> で発生するイベントに応じて <xref:System.Windows.Controls.Menu> の外観を変更しています。  ユーザーがメニューの上にマウスを移動すると、<xref:System.Windows.Controls.ContextMenu> 項目の外観が変わります。  
+  
+```  
+<Style x:Key="Triggers" TargetType="{x:Type MenuItem}">  
+  <Style.Triggers>  
+    <Trigger Property="MenuItem.IsMouseOver" Value="true">  
+      <Setter Property = "FontSize" Value="16"/>  
+      <Setter Property = "FontStyle" Value="Italic"/>  
+      <Setter Property = "Foreground" Value="Red"/>  
+    </Trigger>  
+  </Style.Triggers>  
+</Style>  
+```  
+  
+## 参照  
+ <xref:System.Windows.Controls.ContextMenu>   
+ <xref:System.Windows.Style>   
+ <xref:System.Windows.Controls.Menu>   
+ <xref:System.Windows.Controls.MenuItem>   
+ [ContextMenu](../../../../docs/framework/wpf/controls/contextmenu.md)   
+ [ContextMenu のスタイルとテンプレート](../../../../docs/framework/wpf/controls/contextmenu-styles-and-templates.md)   
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/contextmenu-styles-and-templates.md b/docs/framework/wpf/controls/contextmenu-styles-and-templates.md
new file mode 100644
index 00000000000..4d524575990
--- /dev/null
+++ b/docs/framework/wpf/controls/contextmenu-styles-and-templates.md
@@ -0,0 +1,61 @@
+---
+title: "ContextMenu のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ContextMenu [WPF], スタイルおよびテンプレート"
+  - "ControlTemplate [WPF], ContextMenu"
+  - "パーツ [WPF], ContextMenu"
+  - "状態 [WPF], ContextMenu"
+  - "スタイル [WPF], ContextMenu"
+  - "テンプレート [WPF], ContextMenu"
+ms.assetid: 342d1f17-c406-4f94-8f55-867c5f3ea511
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ContextMenu のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ContextMenu> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ContextMenu のパーツ  
+ <xref:System.Windows.Controls.ContextMenu> コントロールには、名前付きのパーツは存在しません。  
+  
+ <xref:System.Windows.Controls.ContextMenu> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.ContextMenu> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## ContextMenu の状態  
+ 次の表は、<xref:System.Windows.Controls.ContextMenu> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ContextMenu ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ContextMenu> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ContextMenu](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/menu.xaml#contextmenu)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> は、次のリソースを使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/contextmenu.md b/docs/framework/wpf/controls/contextmenu.md
new file mode 100644
index 00000000000..7c7f7e46603
--- /dev/null
+++ b/docs/framework/wpf/controls/contextmenu.md
@@ -0,0 +1,39 @@
+---
+title: "ContextMenu | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ContextMenu コントロール [WPF]"
+  - "コントロール [WPF], ContextMenu"
+  - "メニュー [WPF], コンテキスト"
+ms.assetid: 2f40b2bb-b702-4706-9fc4-10bcfd7cc35d
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# ContextMenu
+コントロールで <xref:System.Windows.Controls.ContextMenu> を使用すると、そのコントロールのコンテキスト固有の <xref:System.Windows.Controls.Menu> を表示できます。  通常、<xref:System.Windows.Controls.ContextMenu> は、マウスの右ボタンまたはキーボードのメニュー ボタンによって、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] で公開されます。  
+  
+ 既定の状態と開いている状態の 2 種類の状態の <xref:System.Windows.Controls.ContextMenu> を次の図に示します。  既定の状態では、コントロールは折りたたまれています。  メニューの親の上でマウスの右ボタンが押されると、コントロールが展開してメニュー項目を表示します。  
+  
+ ![コンテキスト メニューの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-contextmenu.png "SS\_CTL\_contextmenu")  
+さまざまな状態の ContextMenu  
+  
+## このセクションの内容  
+ [ContextMenu の概要](../../../../docs/framework/wpf/controls/contextmenu-overview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ContextMenu>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/control-authoring-overview.md b/docs/framework/wpf/controls/control-authoring-overview.md
new file mode 100644
index 00000000000..36858ac8a52
--- /dev/null
+++ b/docs/framework/wpf/controls/control-authoring-overview.md
@@ -0,0 +1,278 @@
+---
+title: "コントロールの作成の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成の概要 (コントロールの)"
+  - "コントロール, 作成の概要"
+ms.assetid: 3d864748-cff0-4e63-9b23-d8e5a635b28f
+caps.latest.revision: 32
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# コントロールの作成の概要
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] コントロール モデルの機能拡張により、新しいコントロールを作成する必要性が大幅に削減されます。  ただし、場合によっては、カスタム コントロールを作成する必要があります。  ここでは、カスタム コントロールを作成する必要性を最小限に抑える機能と、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のさまざまなコントロール作成モデルについて説明します。  また、新しいコントロールを作成する方法も示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="when_to_write_a_new_control"></a>   
+## 新しいコントロールを作成しないための方法  
+ 従来、カスタマイズの内容を既存のコントロールから取得する場合は、背景色、境界線の幅、フォントのサイズなど、コントロールの標準プロパティの変更は制限されていました。  このような定義済みのパラメーター以外の部分について、コントロールの外観や動作を拡張するには、新しいコントロールを作成する必要があり、一般的には、既存のコントロールを継承し、コントロールの描画を行うメソッドをオーバーライドしていました。  その方法は現在でも使用できますが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、リッチ コンテンツ モデル、スタイル、テンプレート、およびトリガーを使用して、既存のコントロールをカスタマイズすることもできます。  これらの機能を使用して、新しいコントロールを作成せずにカスタム操作および一貫した操作を実現する方法には、次のようなものがあります。  
+  
+-   **リッチ コンテンツ。**標準の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの多くは、リッチ コンテンツをサポートします。  たとえば、<xref:System.Windows.Controls.Button> のコンテンツ プロパティは <xref:System.Object> 型なので、理論的には、<xref:System.Windows.Controls.Button> 上にはどのようなものでも表示できます。  ボタンにイメージとテキストを表示するには、イメージと <xref:System.Windows.Controls.TextBlock> を <xref:System.Windows.Controls.StackPanel> に追加し、その <xref:System.Windows.Controls.StackPanel> を <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティに設定します。  コントロールには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のビジュアル要素と任意のデータを表示できるため、新しいコントロールを作成する必要性や、複雑な視覚化をサポートするために既存のコントロールを変更する必要性は少なくなります。  <xref:System.Windows.Controls.Button> のコンテンツ モデルおよび [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のその他のコンテンツ モデルの詳細については、「[WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)」を参照してください。  
+  
+-   **スタイル。** <xref:System.Windows.Style> は、コントロールのプロパティを表す値のコレクションです。  スタイルを使用して、新しいコントロールを作成することなく、目的のコントロールの外観や動作の再利用可能な表現を作成できます。  たとえば、すべての <xref:System.Windows.Controls.TextBlock> コントロールに、赤色でフォント サイズ 14 の Arial フォントを設定するとします。  その場合、スタイルをリソースとして作成し、該当する適切なプロパティを設定します。  すると、アプリケーションに追加する各 <xref:System.Windows.Controls.TextBlock> は同じ外観となります。  
+  
+-   **データ テンプレート。** <xref:System.Windows.DataTemplate> を使用すると、コントロールでのデータの表示方法をカスタマイズできます。  たとえば、<xref:System.Windows.DataTemplate> を使用して、<xref:System.Windows.Controls.ListBox> でのデータの表示方法を指定できます。  この例については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)」を参照してください。  <xref:System.Windows.DataTemplate> では、データの表示形式のカスタマイズのほか、UI 要素を含めることができ、カスタム UI の柔軟性を高めることができます。  たとえば、<xref:System.Windows.DataTemplate> を使用して、各項目がチェック ボックスを持つ <xref:System.Windows.Controls.ComboBox> を作成できます。  
+  
+-   **コントロール テンプレート。** [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の多くのコントロールでは、<xref:System.Windows.Controls.ControlTemplate> を使用してコントロールの構造と外観を定義します。これにより、コントロールの外観と機能を分離できます。コントロールの <xref:System.Windows.Controls.ControlTemplate> を再定義すると、外観を大きく変えることができます。  たとえば、信号機のような外観のコントロールが必要だとします。  このコントロールのユーザー インターフェイスと機能は単純です。  このコントロールは 3 つの円で構成され、1 度に点灯するのはそのうちの 1 つだけです。  これを実現する方法をしばらく考えた結果、一度に 1 つだけを選択するという機能は <xref:System.Windows.Controls.RadioButton> で実現できることに気付いたとします。しかし、<xref:System.Windows.Controls.RadioButton> の既定の外観は、信号機とは似ても似付きません。  <xref:System.Windows.Controls.RadioButton> では、外観の定義にコントロール テンプレートを使用しているため、コントロールの要件に合わせて <xref:System.Windows.Controls.ControlTemplate> を簡単に再定義でき、オプション ボタンで信号機を実現できます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Controls.RadioButton> では <xref:System.Windows.DataTemplate> を使用できますが、この例は <xref:System.Windows.DataTemplate> では不十分です。  <xref:System.Windows.DataTemplate> は、コントロールのコンテンツの表示形式を定義するものです。  <xref:System.Windows.Controls.RadioButton> の場合、コンテンツとは、<xref:System.Windows.Controls.RadioButton> が選択されているかどうかを示す円の右側に表示される内容です。  信号機の例では、オプション ボタンは、"点灯" する円のみであることが必要です。信号機の場合、外観の要件が、<xref:System.Windows.Controls.RadioButton> の既定の外観とは大きく異なるため、<xref:System.Windows.Controls.ControlTemplate> を再定義する必要があります。  一般には、コントロールのコンテンツ \(またはデータ\) の定義には <xref:System.Windows.DataTemplate> を使用し、コントロールの構造の定義には <xref:System.Windows.Controls.ControlTemplate> を使用します。  
+  
+-   **トリガー。** <xref:System.Windows.Trigger> を使用すると、新しいコントロールを作成しなくても、コントロールの外観や動作を動的に変更できます。  たとえば、複数の <xref:System.Windows.Controls.ListBox> コントロールを使用するアプリケーションがあり、各 <xref:System.Windows.Controls.ListBox> の選択項目を赤色の太字で表示するとします。  すぐに思い付くのは、<xref:System.Windows.Controls.ListBox> を継承したクラスを作成し、<xref:System.Windows.Controls.Primitives.Selector.OnSelectionChanged%2A> メソッドをオーバーライドして選択項目の外観を変更するという方法ですが、<xref:System.Windows.Controls.ListBoxItem> のスタイルに、選択項目の外観を変更するトリガーを追加するという方法の方がより適切です。  トリガーを使用すると、プロパティ値の変更や、プロパティ値に基づいた処理を実行できます。  <xref:System.Windows.EventTrigger> により、イベントが発生したときに処理を実行できます。  
+  
+ スタイル、テンプレート、およびトリガーの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+ 一般に、既存のコントロールと同じ機能を持ち外観が異なるコントロールが必要な場合は、このセクションで説明した方法のいずれかを使用して既存のコントロールの外観を変更できないかどうかをまず検討することをお勧めします。  
+  
+<a name="models_for_control_authoring"></a>   
+## コントロール作成モデル  
+ リッチ コンテンツ モデル、スタイル、テンプレート、およびトリガーを使用すると、新しいコントロールを作成する必要性は大幅に抑えられます。  ただし、場合によっては、新しいコントロールを作成する必要があります。その場合は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の各種のコントロール作成モデルを理解することが重要です。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、コントロールを作成するための一般的なモデルが 3 つあり、各モデルがそれぞれ異なる機能と柔軟性レベルを持ちます。  3 つのモデルの基本クラスは、<xref:System.Windows.Controls.UserControl>、<xref:System.Windows.Controls.Control>、および <xref:System.Windows.FrameworkElement> です。  
+  
+### UserControl からの派生  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でコントロールを作成する方法で最も簡単なのは、<xref:System.Windows.Controls.UserControl> を派生する方法です。  <xref:System.Windows.Controls.UserControl> を継承したコントロールを作成するときには、<xref:System.Windows.Controls.UserControl> に既存のコンポーネントを追加し、コンポーネントに名前を付けて、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でイベント ハンドラーを参照します。  次に、指定の要素を参照し、コードでイベント ハンドラーを定義します。  この開発モデルは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でのアプリケーション開発に使用されるモデルと非常によく似ています。  
+  
+ <xref:System.Windows.Controls.UserControl> は、正しく構築されていれば、リッチ コンテンツ、スタイル、およびトリガーの利点を活用できます。  しかし、<xref:System.Windows.Controls.UserControl> を継承したコントロールの場合、そのユーザーは、<xref:System.Windows.DataTemplate> や <xref:System.Windows.Controls.ControlTemplate> を使用して外観をカスタマイズできません。  <xref:System.Windows.Controls.Control> クラスまたはその派生クラス \(<xref:System.Windows.Controls.UserControl> を除く\) を派生して、テンプレートをサポートするカスタム コントロールを作成する必要があります。  
+  
+#### UserControl からの派生の利点  
+ 次のすべての項目に該当する場合は、<xref:System.Windows.Controls.UserControl> から派生することをお勧めします。  
+  
+-   アプリケーションの構築と同じ方法でコントロールを構築する必要がある場合。  
+  
+-   コントロールが既存のコンポーネントだけで構成されている場合。  
+  
+-   複雑なカスタマイズをサポートする必要がない場合。  
+  
+### Control からの派生  
+ <xref:System.Windows.Controls.Control> クラスからの派生は、既存の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールの多くで使用されるモデルです。  <xref:System.Windows.Controls.Control> クラスを継承したコントロールを作成するときには、テンプレートを使用してその外観を定義します。  それにより、操作ロジックと視覚的表現とが分離されます。  また、イベントではなくコマンドとバインディングを使用し、<xref:System.Windows.Controls.ControlTemplate> の要素の参照をできる限り避けることによって、UI とロジックを分離できます。コントロールの UI とロジックが適切に分離されていると、コントロールのユーザーがコントロールの <xref:System.Windows.Controls.ControlTemplate> を再定義して、その外観をカスタマイズできます。カスタム <xref:System.Windows.Controls.Control> の作成は <xref:System.Windows.Controls.UserControl> の作成ほど単純ではありませんが、カスタム <xref:System.Windows.Controls.Control> では高い柔軟性を得ることができます。  
+  
+#### Control からの派生の利点  
+ 次のいずれかの項目に該当する場合は、<xref:System.Windows.Controls.UserControl> クラスを使用するのではなく、<xref:System.Windows.Controls.Control> から派生することをお勧めします。  
+  
+-   コントロールの外観を、<xref:System.Windows.Controls.ControlTemplate> によりカスタマイズ可能にする必要がある場合。  
+  
+-   コントロールでさまざまなテーマをサポートする必要がある場合。  
+  
+### FrameworkElement からの派生  
+ <xref:System.Windows.Controls.UserControl> または <xref:System.Windows.Controls.Control> から派生するコントロールは、既存の要素の構成に依存します。  多くの状況では、それで問題ありません。<xref:System.Windows.FrameworkElement> を継承するどのオブジェクトも <xref:System.Windows.Controls.ControlTemplate> に含めることができるためです。  しかし、場合によっては、単純な要素コンポジションでは、コントロールの外観で求められる機能を実現できないことがあります。  このような状況では、<xref:System.Windows.FrameworkElement> に基づいてコンポーネントを作成するのが適切な選択です。  
+  
+ <xref:System.Windows.FrameworkElement> に基づくコンポーネントを構築するには、ダイレクト レンダリングとカスタム要素コンポジションの 2 つの標準的な方法があります。  ダイレクト レンダリングでは、<xref:System.Windows.FrameworkElement> の <xref:System.Windows.UIElement.OnRender%2A> メソッドをオーバーライドし、コンポーネントのビジュアルを明示的に定義する <xref:System.Windows.Media.DrawingContext> 操作を提供します。  これは、<xref:System.Windows.Controls.Image> および <xref:System.Windows.Controls.Border> で使用される方法です。  カスタム要素コンポジションでは、<xref:System.Windows.Media.Visual> 型のオブジェクトを使用してコンポーネントの外観を構成します。  例については、「[DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)」を参照してください。  たとえば、カスタム要素コンポジションを使用する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のコントロールとして、<xref:System.Windows.Controls.Primitives.Track> があります。  また、同じコントロールでダイレクト レンダリングとカスタム要素コンポジションの両方を使用することもできます。  
+  
+#### FrameworkElement からの派生の利点  
+ 次のいずれかの項目に該当する場合は、<xref:System.Windows.FrameworkElement> から派生することをお勧めします。  
+  
+-   コントロールの外観に関して、単純な要素コンポジションで提供されるよりも厳密な制御を必要とする場合。  
+  
+-   独自のレンダリング ロジックを定義してコントロールの外観を定義する必要がある場合。  
+  
+-   <xref:System.Windows.Controls.UserControl> および <xref:System.Windows.Controls.Control> を使用する方法では実現できない新しい方法で既存の要素を構成する必要がある場合。  
+  
+<a name="control_authoring_basics"></a>   
+## コントロールの作成の基本  
+ 既に述べたように、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の最も強力な機能の 1 つは、コントロールの基本的なプロパティの設定だけでなく、外観と動作を変更でき、しかもカスタム コントロールを作成する必要がないということです。スタイル、データ バインディング、およびトリガーの各機能は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プロパティ システムおよび [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント システムによって実現されています。以降のセクションでは、カスタム コントロールの作成に使用されたモデルに関係なく、これらの機能を使用できるようにする方法について説明します。カスタム コントロールのユーザーは、これらの機能を [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属のコントロールと同じように使用できます。  
+  
+### 依存関係プロパティの使用  
+ プロパティが依存関係プロパティの場合、以下が可能です。  
+  
+-   スタイルでプロパティを設定する。  
+  
+-   プロパティをデータ ソースにバインドする。  
+  
+-   プロパティの値として動的リソースを使用する。  
+  
+-   プロパティをアニメーション化する。  
+  
+ コントロールのプロパティでこれらの機能のいずれかをサポートすることが必要な場合は、依存関係プロパティとして実装する必要があります。  次に示す例では、次の処理を行うことによって、`Value` という名前の依存関係プロパティを定義します。  
+  
+-   `ValueProperty` という名前の <xref:System.Windows.DependencyProperty> 識別子を `public` `static` `readonly` フィールドとして定義します。  
+  
+-   <xref:System.Windows.DependencyProperty.Register%2A?displayProperty=fullName> を呼び出してプロパティ システムにプロパティ名を登録し、次の項目を指定します。  
+  
+    -   プロパティの名前。  
+  
+    -   プロパティの型。  
+  
+    -   プロパティを所有する型。  
+  
+    -   プロパティのメタデータ。  メタデータには、プロパティの既定値、<xref:System.Windows.CoerceValueCallback>、および <xref:System.Windows.PropertyChangedCallback> が含まれています。  
+  
+-   依存関係プロパティの登録に使用したのと同じ `Value` という名前で [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] ラッパー プロパティを定義し、プロパティの `get` アクセサーおよび `set` アクセサーを実装します。  この `get` アクセサーおよび `set` アクセサーは、それぞれ <xref:System.Windows.DependencyObject.GetValue%2A> と <xref:System.Windows.DependencyObject.SetValue%2A> を呼び出すだけです。  依存関係プロパティのアクセサーには、その他のロジックを含めないことをお勧めします。クライアントおよび [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、アクセサーを省略して、<xref:System.Windows.DependencyObject.GetValue%2A> および <xref:System.Windows.DependencyObject.SetValue%2A> を直接呼び出すことがあるためです。  たとえば、プロパティがデータ ソースにバインドされている場合、プロパティの `set` アクセサーは呼び出されません。  get アクセサーおよび set アクセサーに他のロジックを追加するのではなく、<xref:System.Windows.ValidateValueCallback>、<xref:System.Windows.CoerceValueCallback>、および <xref:System.Windows.PropertyChangedCallback> の各デリゲートを使用して、値が変更したときの対応やチェックを行います。  これらのコールバックの詳細については、「[依存関係プロパティのコールバックと検証](../../../../docs/framework/wpf/advanced/dependency-property-callbacks-and-validation.md)」を参照してください。  
+  
+-   <xref:System.Windows.CoerceValueCallback> に対応する、`CoerceValue` という名前のメソッドを定義します。  `CoerceValue` では、`Value` が `MinValue` 以上 `MaxValue` 以下であることを確認します。  
+  
+-   <xref:System.Windows.PropertyChangedCallback> に対応する、`OnValueChanged` という名前のメソッドを定義します。  `OnValueChanged` では、<xref:System.Windows.RoutedPropertyChangedEventArgs%601> オブジェクトを作成し、`ValueChanged` ルーティング イベントを発生させる準備をします。  ルーティング イベントについては、次のセクションで説明します。  
+  
+ [!code-csharp[UserControlNumericUpDown#DependencyProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UserControlNumericUpDown/CSharp/NumericUpDown.xaml.cs#dependencyproperty)]
+ [!code-vb[UserControlNumericUpDown#DependencyProperty](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UserControlNumericUpDown/visualbasic/numericupdown.xaml.vb#dependencyproperty)]  
+  
+ 詳細については、「[カスタム依存関係プロパティ](../../../../docs/framework/wpf/advanced/custom-dependency-properties.md)」を参照してください。  
+  
+### ルーティング イベントの使用  
+ [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティの概念を追加の機能で拡張する[依存関係プロパティ](GTMT)と同様に、[ルーティング イベント](GTMT)は、標準の [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] イベントの概念を拡張します。  新しい [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールを作成する場合は、イベントをルーティング イベントとして実装することをお勧めします。ルーティング イベントは以下の機能をサポートしているためです。  
+  
+-   複数のコントロールの親でイベントを処理できます。  イベントがバブル イベントの場合、要素ツリーの単一の親がイベントをサブスクライブできます。  これにより、アプリケーション開発者は、複数のコントロールのイベントに 1 つのハンドラーで対応できます。  たとえば、<xref:System.Windows.Controls.ListBox> の各項目に含まれるコントロール \(<xref:System.Windows.DataTemplate> に含まれているため\) の場合、アプリケーション開発者は、コントロールのイベントに対応するイベント ハンドラーを <xref:System.Windows.Controls.ListBox> で定義できます。  いずれかのコントロールでイベントが発生すると、そのイベント ハンドラーが呼び出されます。  
+  
+-   ルーティング イベントは <xref:System.Windows.EventSetter> で使用できます。これにより、アプリケーション開発者は、イベントのハンドラーをスタイル内で指定できます。  
+  
+-   ルーティング イベントは <xref:System.Windows.EventTrigger> で使用できます。[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] によるプロパティのアニメーション化に有用です。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ 次に示す例では、次の処理を行うことによって、ルーティング イベントを定義します。  
+  
+-   `ValueChangedEvent` という名前の <xref:System.Windows.RoutedEvent> 識別子を `public` `static` `readonly` フィールドとして定義します。  
+  
+-   <xref:System.Windows.EventManager.RegisterRoutedEvent%2A?displayProperty=fullName> メソッドを呼び出して、ルーティング イベントを登録します。  この例では、<xref:System.Windows.EventManager.RegisterRoutedEvent%2A> を呼び出すときに、次の情報を指定しています。  
+  
+    -   イベントの名前が `ValueChanged` であること。  
+  
+    -   ルーティング方法が <xref:System.Windows.RoutingStrategy> であること。ソース \(イベントを発生させたオブジェクト\) のイベント ハンドラーがまず呼び出された後、直近の親要素のイベント ハンドラー以降、ソースの親要素のイベント ハンドラーが順に呼び出されていくルーティング方法です。  
+  
+    -   イベント ハンドラーの型が <xref:System.Windows.RoutedPropertyChangedEventHandler%601> で、<xref:System.Decimal> 型で構築されていること。  
+  
+    -   イベントを所有する型が `NumericUpDown` であること。  
+  
+-   `ValueChanged` という名前のパブリック イベントを宣言し、イベント アクセサー宣言を含めます。  この例では、`add` アクセサー宣言で <xref:System.Windows.UIElement.AddHandler%2A> を、`remove` アクセサー宣言で <xref:System.Windows.UIElement.RemoveHandler%2A> を、それぞれ呼び出して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] イベント サービスを使用します。  
+  
+-   `ValueChanged` イベントを発生させるプロテクト仮想メソッド `OnValueChanged` を作成します。  
+  
+ [!code-csharp[UserControlNumericUpDown#RoutedEvent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UserControlNumericUpDown/CSharp/NumericUpDown.xaml.cs#routedevent)]
+ [!code-vb[UserControlNumericUpDown#RoutedEvent](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UserControlNumericUpDown/visualbasic/numericupdown.xaml.vb#routedevent)]  
+  
+ 詳細については、「[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)」および「[カスタム ルーティング イベントを作成する](../../../../docs/framework/wpf/advanced/how-to-create-a-custom-routed-event.md)」を参照してください。  
+  
+### バインディングの使用  
+ コントロールの UI とロジックとを分離するには、データ バインディングを使用する方法もあります。  これは、<xref:System.Windows.Controls.ControlTemplate> を使用してコントロールの外観を定義する場合に、特に重要になります。  データ バインディングを使用すると、コードから UI の特定の部分を参照する必要がなくなる場合があります。  コードが <xref:System.Windows.Controls.ControlTemplate> 内の要素を参照する場合、<xref:System.Windows.Controls.ControlTemplate> が変更されたときには、参照先の要素を新しい <xref:System.Windows.Controls.ControlTemplate> に含める必要があります。このため、<xref:System.Windows.Controls.ControlTemplate> 内の要素の参照を避けることをお勧めします。  
+  
+ 次の例では、`NumericUpDown` コントロールの <xref:System.Windows.Controls.TextBlock> を更新し、名前を割り当てて、コード内で名前を使用してテキスト ボックスを参照しています。  
+  
+ [!code-xml[UserControlNumericUpDownSimple#UIRefMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UserControlNumericUpDownSimple/CSharp/NumericUpDown.xaml#uirefmarkup)]  
+  
+ [!code-csharp[UserControlNumericUpDownSimple#UIRefCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UserControlNumericUpDownSimple/CSharp/NumericUpDown.xaml.cs#uirefcode)]
+ [!code-vb[UserControlNumericUpDownSimple#UIRefCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UserControlNumericUpDownSimple/VisualBasic/NumericUpDown.xaml.vb#uirefcode)]  
+  
+ 次の例では、バインディングを使用して同じことを実現しています。  
+  
+ [!code-xml[UserControlNumericUpDown#Binding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UserControlNumericUpDown/CSharp/NumericUpDown.xaml#binding)]  
+  
+ データ バインディングの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+### デザイナーに対応したデザイン  
+ [!INCLUDE[wpfdesigner_current_long](../../../../includes/wpfdesigner-current-long-md.md)] でカスタム WPF コントロールのサポート \(たとえば \[プロパティ\] ウィンドウでのプロパティ編集\) を利用するには、以下のガイドラインに従います。  [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]向けの開発の詳細については、「[WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)」を参照してください。  
+  
+#### 依存関係プロパティ  
+ 「依存関係プロパティの使用」で述べたように、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] の `get` アクセサーおよび `set` アクセサーを実装します。デザイナーは、ラッパーを使用して依存関係プロパティの存在を検出する場合がありますが、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] およびコントロールのクライアントと同様に、プロパティを取得または設定するときに必ずしもアクセサーを呼び出す必要はありません。  
+  
+#### 添付プロパティ  
+ 以下のガイドラインに従って、カスタム コントロールに添付プロパティを実装する必要があります。  
+  
+-   *PropertyName* `Property` という形式の `public` `static` `readonly` <xref:System.Windows.DependencyProperty> を、<xref:System.Windows.DependencyProperty.RegisterAttached%2A> メソッドを使用して作成します。  <xref:System.Windows.DependencyProperty.RegisterAttached%2A> に渡すプロパティ名は *PropertyName* に一致する必要があります。  
+  
+-   `Set` *PropertyName* および `Get`*PropertyName* という名前の `public` `static` CLR メソッドのペアを実装します。  いずれのメソッドも、<xref:System.Windows.DependencyProperty> の派生クラスを最初の引数で受け取ります。  `Set`*PropertyName* メソッドでは、プロパティの登録データ型と同じ型の引数も受け取ります。  `Get`*PropertyName* メソッドでは、同じ型の値を返す必要があります。  `Set`*PropertyName* メソッドがない場合、プロパティは読み取り専用としてマークされます。  
+  
+-   `Set` *PropertyName* および `Get`*PropertyName* は、対象の依存関係オブジェクトの <xref:System.Windows.DependencyObject.GetValue%2A> メソッドおよび <xref:System.Windows.DependencyObject.SetValue%2A> メソッドのそれぞれに直接転送する必要があります。  デザイナーが添付プロパティにアクセスするときには、メソッド ラッパー経由で呼び出す場合と、対象の依存関係オブジェクトを直接呼び出す場合の両方があります。  
+  
+ 添付プロパティの詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+### 共有リソースの定義と使用  
+ アプリケーションと同じアセンブリにコントロールを含めることも、複数のアプリケーションが使用できる別のアセンブリにコントロールをパッケージ化することもできます。  このトピックで示す情報の大部分は、使用する方法に関係なく適用されます。  ただし、1 つだけ例外があります。  アプリケーションと同じアセンブリにコントロールを含める場合は、App.xaml ファイルにグローバル リソースを追加できます。  コントロールだけを含むアセンブリには <xref:System.Windows.Application> オブジェクトが関連付けられないため、App.xaml ファイルは使用できません。  
+  
+ アプリケーションがリソースを検索するときには、次に示す順序で 3 つのレベルを検索します。  
+  
+1.  要素レベル。  
+  
+     システムは、リソースを参照する要素から検索を開始し、ルート要素に到達するまで、論理上の親のリソースの検索を続けます。  
+  
+2.  アプリケーション レベル。  
+  
+     <xref:System.Windows.Application> オブジェクトで定義されたリソース。  
+  
+3.  テーマ レベル。  
+  
+     テーマ レベルのディクショナリは、Themes というサブフォルダーに格納されています。  Themes フォルダー内のファイルは、テーマに対応しています。  たとえば、Aero.NormalColor.xaml、Luna.NormalColor.xaml、Royale.NormalColor.xaml などのファイルがあります。  また、generic.xaml という名前のファイルが含まれている場合もあります。  システムがテーマ レベルでリソースを検索するときには、最初にテーマ固有のファイル内を検索し、その後で generic.xaml 内を検索します。  
+  
+ アプリケーションとは別のアセンブリ内にコントロールを含めるときには、グローバル リソースを要素レベルまたはテーマ レベルに配置する必要があります。  どちらに配置する場合も、それぞれの利点があります。  
+  
+#### 要素レベルでのリソース定義  
+ 要素レベルで共有リソースを定義するには、カスタムのリソース ディクショナリを作成し、それをコントロールのリソース ディクショナリに結合します。  このメソッドで定義する場合は、リソース ファイルに任意の名前を付けることができます。また、それをコントロールと同じフォルダーに配置できます。  要素レベルのリソースでは、単純な文字列をキーとして使用することもできます。  次の例では、Dictionary1.xaml という名前の、<xref:System.Windows.Media.LinearGradientBrush> リソース ファイルを作成します。  
+  
+ [!code-xml[SharedResources#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SharedResources/CS/Dictionary1.xaml#1)]  
+  
+ ディクショナリを定義したら、それをコントロールのリソース ディクショナリにマージする必要があります。  これを行うには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] またはコードを使用します。  
+  
+ 次の例では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用してリソース ディクショナリを結合します。  
+  
+ [!code-xml[SharedResources#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SharedResources/CS/ShapeResizer.xaml#2)]  
+  
+ この方法の欠点は、参照するたびに <xref:System.Windows.ResourceDictionary> オブジェクトが作成されることです。  たとえば、ライブラリ内に 10 個のカスタム コントロールがあり、XAML を使用して各コントロール用の共有リソース ライブラリを結合する場合は、同一の <xref:System.Windows.ResourceDictionary> オブジェクトが 10 個作成されてしまいます。  これを回避するには、コード内でリソースを結合し、結果として作成される <xref:System.Windows.ResourceDictionary> を返す、静的クラスを作成します。  
+  
+ 次の例では、共有の <xref:System.Windows.ResourceDictionary> を返すクラスを作成します。  
+  
+ [!code-csharp[SharedResources#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SharedResources/CS/SharedDictionaryManager.cs#3)]  
+  
+ 次の例では、`InitilizeComponent` を呼び出す前に、共有リソースをコントロールのコンストラクター内でカスタム コントロールのリソースと結合します。  `SharedDictionaryManager.SharedDictionary` は静的プロパティであるため、<xref:System.Windows.ResourceDictionary> は 1 回だけ作成されます。  また、リソース ディクショナリが `InitializeComponent` の呼び出し前に結合されるため、コントロールはその [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルでリソースを使用できます。  
+  
+ [!code-csharp[SharedResources#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SharedResources/CS/ShapeResizer.xaml.cs#4)]  
+  
+#### テーマ レベルでのリソース定義  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、さまざまな Windows テーマ用にリソースを作成できます。  コントロールの作成者は、特定のテーマ用のリソースを定義して、使用するテーマに応じてコントロールの外観を変更できます。  たとえば、Windows クラシック テーマ \(Windows 2000 の既定のテーマ\) の <xref:System.Windows.Controls.Button> の外観は、Windows Luna テーマ \(Windows XP の既定のテーマ\) の <xref:System.Windows.Controls.Button> とは異なります。これは、<xref:System.Windows.Controls.Button> が各テーマ用に異なる <xref:System.Windows.Controls.ControlTemplate> を使用するためです。  
+  
+ テーマ固有のリソースは、固有のファイル名でリソース ディクショナリに保持されます。  これらのファイルは、コントロールが格納されているフォルダーのサブフォルダーである `Themes` フォルダー内に配置する必要があります。  次の表は、リソース ディクショナリ ファイルと、各ファイルに関連付けられているテーマを示しています。  
+  
+|リソース ディクショナリ ファイル名|Windows テーマ|  
+|------------------------|-----------------|  
+|`Classic.xaml`|Windows XP のクラシックな Windows 9x\/2000 の外観|  
+|`Luna.NormalColor.xaml`|Windows XP の既定の青のテーマ|  
+|`Luna.Homestead.xaml`|Windows XP のオリーブのテーマ|  
+|`Luna.Metallic.xaml`|Windows XP のシルバーのテーマ|  
+|`Royale.NormalColor.xaml`|Windows XP Media Center Edition の既定のテーマ|  
+|`Aero.NormalColor.xaml`|Windows Vista の既定のテーマ|  
+  
+ すべてのテーマのリソースを定義する必要はありません。  特定のテーマについてリソースが定義されていない場合、コントロールはリソースの `Classic.xaml` をチェックします。  現在のテーマに対応するファイルまたは `Classic.xaml` にリソースが定義されていない場合、コントロールは汎用のリソースを使用します。汎用のリソースは、`generic.xaml` という名前のリソース ディクショナリ ファイルにあります。  `generic.xaml` ファイルは、テーマ固有のリソース ディクショナリ ファイルと同じフォルダー内にあります。  `generic.xaml` は特定の Windows テーマには対応していませんが、テーマ レベルのディクショナリです。  
+  
+ [テーマおよび UI オートメーションがサポートされた NumericUpDown カスタム コントロールのサンプル](http://go.microsoft.com/fwlink/?LinkID=160025)には、`NumericUpDown` コントロール用の 2 つのリソース ディクショナリが含まれています。1 つは generic.xaml に、もう 1 つは Luna.NormalColor.xaml にあります。  アプリケーションを実行し、Windows XP のシルバーのテーマと別のテーマとを切り替えて、2 つのコントロール テンプレートの違いを確認できます。  Windows Vista を使用している場合は、Luna.NormalColor.xaml を Aero.NormalColor.xaml という名前に変えて、Windows クラシック テーマと Windows Vista の既定のテーマの切り替えなど、2 つのテーマの切り替えを行うことができます。  
+  
+ テーマ固有のリソース ディクショナリ ファイルに <xref:System.Windows.Controls.ControlTemplate> を置くときには、次の例に示すように、コントロール用の静的コンストラクターを作成し、<xref:System.Windows.DependencyProperty.OverrideMetadata%28System.Type%2CSystem.Windows.PropertyMetadata%29> メソッドを <xref:System.Windows.FrameworkElement.DefaultStyleKey%2A> に対して呼び出す必要があります。  
+  
+ [!code-csharp[CustomControlNumericUpDownOneProject#StaticConstructor](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomControlNumericUpDownOneProject/CSharp/NumericUpDown.cs#staticconstructor)]
+ [!code-vb[CustomControlNumericUpDownOneProject#StaticConstructor](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomControlNumericUpDownOneProject/visualbasic/numericupdown.vb#staticconstructor)]  
+  
+##### テーマ リソース用のキーの定義と参照  
+ 要素レベルでリソースを定義するときには、文字列をキーとして割り当て、その文字列を使用してそのリソースにアクセスできます。  テーマ レベルでリソースを定義するときには、キーとして <xref:System.Windows.ComponentResourceKey> を使用する必要があります。  次の例では、generic.xaml でリソースを定義します。  
+  
+  
+  
+ 次の例では、キーとして <xref:System.Windows.ComponentResourceKey> を指定して、リソースを参照します。  
+  
+  
+  
+##### テーマ リソースの場所の指定  
+ コントロールのリソースを見つけるには、アセンブリにコントロール固有のリソースが含まれていることを、ホスト アプリケーションが認識する必要があります。  これを可能にするには、コントロールが含まれているアセンブリに <xref:System.Windows.ThemeInfoAttribute> を追加します。  <xref:System.Windows.ThemeInfoAttribute> には、汎用リソースの場所を指定する <xref:System.Windows.ThemeInfoAttribute.GenericDictionaryLocation%2A> プロパティと、テーマ固有のリソースの場所を指定する <xref:System.Windows.ThemeInfoAttribute.ThemeDictionaryLocation%2A> プロパティがあります。  
+  
+ 次の例では、<xref:System.Windows.ThemeInfoAttribute.GenericDictionaryLocation%2A> プロパティと <xref:System.Windows.ThemeInfoAttribute.ThemeDictionaryLocation%2A> プロパティを <xref:System.Windows.ResourceDictionaryLocation> に設定して、汎用リソースとテーマ固有のリソースがコントロールと同じアセンブリに置かれていることを示します。  
+  
+ [!code-csharp[CustomControlNumericUpDown#ThemesSection](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomControlNumericUpDown/CSharp/CustomControlLibrary/Properties/AssemblyInfo.cs#themessection)]
+ [!code-vb[CustomControlNumericUpDown#ThemesSection](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomControlNumericUpDown/visualbasic/customcontrollibrary/my project/assemblyinfo.vb#themessection)]  
+  
+## 参照  
+ [WPF デザイナー](http://msdn.microsoft.com/ja-jp/c6c65214-8411-4e16-b254-163ed4099c26)   
+ [WPF におけるパッケージの URI](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/control-customization.md b/docs/framework/wpf/controls/control-customization.md
new file mode 100644
index 00000000000..35414422669
--- /dev/null
+++ b/docs/framework/wpf/controls/control-customization.md
@@ -0,0 +1,35 @@
+---
+title: "コントロールのカスタマイズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, カスタマイズ"
+  - "カスタマイズ (コントロールを)"
+ms.assetid: a3d9930e-5597-470e-a636-dcf65eac500b
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# コントロールのカスタマイズ
+このカテゴリには、完全に機能する [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] コントロールの作成に使用する各種の基本クラス、インターフェイスとその他の要素、および概念が含まれます。  
+  
+## このセクションの内容  
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)  
+ [スタイルの設定が可能なコントロールを設計するためのガイドライン](../../../../docs/framework/wpf/controls/guidelines-for-designing-stylable-controls.md)  
+ [Adorners](../../../../docs/framework/wpf/controls/adorners.md)  
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)  
+ [WPF カスタム コントロールの UI オートメーション](../../../../docs/framework/wpf/controls/ui-automation-of-a-wpf-custom-control.md)  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/control-library.md b/docs/framework/wpf/controls/control-library.md
new file mode 100644
index 00000000000..725bd916f6b
--- /dev/null
+++ b/docs/framework/wpf/controls/control-library.md
@@ -0,0 +1,87 @@
+---
+title: "コントロール ライブラリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール ライブラリ"
+  - "ライブラリ, コントロール"
+ms.assetid: c1b33289-c389-4ac2-b153-3cbb0d8324ad
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# コントロール ライブラリ
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] コントロール ライブラリには、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] で提供されるコントロールについての情報がアルファベット順に含まれています。  
+  
+## このセクションの内容  
+ [境界](../../../../docs/framework/wpf/controls/border.md)  
+ [BulletDecorator](../../../../docs/framework/wpf/controls/bulletdecorator.md)  
+ [ボタン](../../../../docs/framework/wpf/controls/button.md)  
+ [Calendar](../../../../docs/framework/wpf/controls/calendar.md)  
+ [Canvas](../../../../docs/framework/wpf/controls/canvas.md)  
+ [CheckBox](../../../../docs/framework/wpf/controls/checkbox.md)  
+ [ComboBox](../../../../docs/framework/wpf/controls/combobox.md)  
+ [ContextMenu](../../../../docs/framework/wpf/controls/contextmenu.md)  
+ [DataGrid](../../../../docs/framework/wpf/controls/datagrid.md)  
+ [DatePicker](../../../../docs/framework/wpf/controls/datepicker.md)  
+ [DockPanel](../../../../docs/framework/wpf/controls/dockpanel.md)  
+ [DocumentViewer](../../../../docs/framework/wpf/controls/documentviewer.md)  
+ [Expander](../../../../docs/framework/wpf/controls/expander.md)  
+ [FlowDocumentPageViewer](../../../../docs/framework/wpf/controls/flowdocumentpageviewer.md)  
+ [FlowDocumentReader](../../../../docs/framework/wpf/controls/flowdocumentreader.md)  
+ [FlowDocumentScrollViewer](../../../../docs/framework/wpf/controls/flowdocumentscrollviewer.md)  
+ [フレーム](../../../../docs/framework/wpf/controls/frame.md)  
+ [グリッド](../../../../docs/framework/wpf/controls/grid.md)  
+ [GridSplitter](../../../../docs/framework/wpf/controls/gridsplitter.md)  
+ [GroupBox](../../../../docs/framework/wpf/controls/groupbox.md)  
+ [イメージ](../../../../docs/framework/wpf/controls/image.md)  
+ [ラベル](../../../../docs/framework/wpf/controls/label.md)  
+ [ListBox](../../../../docs/framework/wpf/controls/listbox.md)  
+ [ListView](../../../../docs/framework/wpf/controls/listview.md)  
+ [メニュー](../../../../docs/framework/wpf/controls/menu.md)  
+ [パネル](../../../../docs/framework/wpf/controls/panel.md)  
+ [PasswordBox](../../../../docs/framework/wpf/controls/passwordbox.md)  
+ [ポップアップ](../../../../docs/framework/wpf/controls/popup.md)  
+ [ProgressBar](../../../../docs/framework/wpf/controls/progressbar.md)  
+ [PrintDialog](../../../../docs/framework/wpf/controls/printdialog.md)  
+ [RadioButton](../../../../docs/framework/wpf/controls/radiobutton.md)  
+ [RepeatButton](../../../../docs/framework/wpf/controls/repeatbutton.md)  
+ [リボン \(WPF\)](../Topic/Ribbon%20\(WPF\).md)  
+ [RichTextBox](../../../../docs/framework/wpf/controls/richtextbox.md)  
+ [ScrollBar](../../../../docs/framework/wpf/controls/scrollbar.md)  
+ [ScrollViewer](../../../../docs/framework/wpf/controls/scrollviewer.md)  
+ [区切り記号](../../../../docs/framework/wpf/controls/separator.md)  
+ [スライダー](../../../../docs/framework/wpf/controls/slider.md)  
+ [StackPanel](../../../../docs/framework/wpf/controls/stackpanel.md)  
+ [StatusBar](../../../../docs/framework/wpf/controls/statusbar.md)  
+ [TabControl](../../../../docs/framework/wpf/controls/tabcontrol.md)  
+ [TextBlock](../../../../docs/framework/wpf/controls/textblock.md)  
+ [TextBox](../../../../docs/framework/wpf/controls/textbox.md)  
+ [ToolBar](../../../../docs/framework/wpf/controls/toolbar.md)  
+ [ヒント](../../../../docs/framework/wpf/controls/tooltip.md)  
+ [TreeView](../../../../docs/framework/wpf/controls/treeview.md)  
+ [WrapPanel](../../../../docs/framework/wpf/controls/wrappanel.md)  
+ [Viewbox](../../../../docs/framework/wpf/controls/viewbox.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls>  
+  
+ <xref:System.Windows.Controls.Primitives>  
+  
+## 関連項目  
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)  
+  
+ [カテゴリ別のコントロール](../../../../docs/framework/wpf/controls/controls-by-category.md)  
+  
+ [WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/control-styles-and-templates.md b/docs/framework/wpf/controls/control-styles-and-templates.md
new file mode 100644
index 00000000000..5898ade50c9
--- /dev/null
+++ b/docs/framework/wpf/controls/control-styles-and-templates.md
@@ -0,0 +1,85 @@
+---
+title: "コントロールのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF]"
+  - "パーツ [WPF]"
+  - "状態 [WPF]"
+  - "スタイル [WPF]"
+  - "テンプレート [WPF]"
+ms.assetid: c19049bb-5ceb-492d-afd2-751dca0ed8e3
+caps.latest.revision: 36
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# コントロールのスタイルとテンプレート
+Windows Presentation Foundation \(WPF\) のコントロールには、そのコントロールの[ビジュアル ツリー](GTMT)を含む <xref:System.Windows.Controls.ControlTemplate> があります。  コントロールの構造や外観を変更するには、そのコントロールの <xref:System.Windows.Controls.ControlTemplate> を変更します。  コントロールのビジュアル ツリーの一部だけを置き換えることはできません。コントロールのビジュアル ツリーを変更するには、コントロールの <xref:System.Windows.Controls.Control.Template%2A> プロパティをその新しい完全な <xref:System.Windows.Controls.ControlTemplate> に設定する必要があります。  
+  
+ デスクトップ テーマにより、使用するリソース ディクショナリが決まります。  デスクトップ テーマにより、使用するリソース ディクショナリが決まります。  デスクトップ テーマに対するリソース ディクショナリを取得するには、[既定の WPF テーマ](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+ 次の表は、リソース ディクショナリ ファイル名とデスクトップ テーマの対応関係をまとめたものです。  
+  
+|テーマ ファイル|デスクトップ テーマ|  
+|--------------|----------------|  
+|Classic.xaml|Windows XP オペレーティング システムにおけるクラシックな Windows \(Windows 95、Windows 98、および Windows 2000\) の外観。|  
+|Luna.NormalColor.xaml|Windows XP の既定の青のテーマ。|  
+|Luna.Homestead.xaml|Windows XP のオリーブのテーマ。|  
+|Luna.Metallic.xaml|Windows XP のシルバーのテーマ。|  
+|Royale.NormalColor.xaml|Windows XP Media Center Edition オペレーティング システムの既定のテーマ。|  
+|Aero.NormalColor.xaml|Windows Vista オペレーティング システムの既定のテーマ。|  
+  
+## このセクションの内容  
+ [ボタンのスタイルとテンプレート](../../../../docs/framework/wpf/controls/button-styles-and-templates.md)  
+ [カレンダーのスタイルとテンプレート](../../../../docs/framework/wpf/controls/calendar-styles-and-templates.md)  
+ [CheckBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/checkbox-styles-and-templates.md)  
+ [ComboBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/combobox-styles-and-templates.md)  
+ [ContextMenu のスタイルとテンプレート](../../../../docs/framework/wpf/controls/contextmenu-styles-and-templates.md)  
+ [DataGrid のスタイルとテンプレート](../../../../docs/framework/wpf/controls/datagrid-styles-and-templates.md)  
+ [DatePicker のスタイルとテンプレート](../../../../docs/framework/wpf/controls/datepicker-syles-and-templates.md)  
+ [DocumentViewer のスタイルとテンプレート](../../../../docs/framework/wpf/controls/documentviewer-styles-and-templates.md)  
+ [エクスパンダーのスタイルとテンプレート](../../../../docs/framework/wpf/controls/expander-styles-and-templates.md)  
+ [フレームのスタイルとテンプレート](../../../../docs/framework/wpf/controls/frame-styles-and-templates.md)  
+ [GroupBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/groupbox-styles-and-templates.md)  
+ [ラベルのスタイルとテンプレート](../../../../docs/framework/wpf/controls/label-styles-and-templates.md)  
+ [ListBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/listbox-styles-and-templates.md)  
+ [ListView のスタイルとテンプレート](../../../../docs/framework/wpf/controls/listview-styles-and-templates.md)  
+ [メニューのスタイルとテンプレート](../../../../docs/framework/wpf/controls/menu-styles-and-templates.md)  
+ [NavigationWindow のスタイルとテンプレート](../../../../docs/framework/wpf/controls/navigationwindow-styles-and-templates.md)  
+ [PasswordBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/passwordbox-syles-and-templates.md)  
+ [ProgressBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/progressbar-styles-and-templates.md)  
+ [RadioButton のスタイルとテンプレート](../../../../docs/framework/wpf/controls/radiobutton-styles-and-templates.md)  
+ [RepeatButton のスタイルとテンプレート](../../../../docs/framework/wpf/controls/repeatbutton-syles-and-templates.md)  
+ [ScrollBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/scrollbar-styles-and-templates.md)  
+ [ScrollViewer のスタイルとテンプレート](../../../../docs/framework/wpf/controls/scrollviewer-styles-and-templates.md)  
+ [スライダーのスタイルとテンプレート](../../../../docs/framework/wpf/controls/slider-styles-and-templates.md)  
+ [StatusBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/statusbar-styles-and-templates.md)  
+ [TabControl のスタイルとテンプレート](../../../../docs/framework/wpf/controls/tabcontrol-styles-and-templates.md)  
+ [TextBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/textbox-styles-and-templates.md)  
+ [つまみのスタイルとテンプレート](../../../../docs/framework/wpf/controls/thumb-syles-and-templates.md)  
+ [ToggleButton のスタイルとテンプレート](../../../../docs/framework/wpf/controls/togglebutton-syles-and-templates.md)  
+ [ToolBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/toolbar-styles-and-templates.md)  
+ [ToolTip のスタイルとテンプレート](../../../../docs/framework/wpf/controls/tooltip-styles-and-templates.md)  
+ [TreeView のスタイルとテンプレート](../../../../docs/framework/wpf/controls/treeview-styles-and-templates.md)  
+ [ウィンドウのスタイルとテンプレート](../../../../docs/framework/wpf/controls/window-styles-and-templates.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls>  
+  
+ <xref:System.Windows.Controls.ControlTemplate>  
+  
+## 関連項目  
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)  
+  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/controls-by-category.md b/docs/framework/wpf/controls/controls-by-category.md
new file mode 100644
index 00000000000..78a7a712e76
--- /dev/null
+++ b/docs/framework/wpf/controls/controls-by-category.md
@@ -0,0 +1,188 @@
+---
+title: "カテゴリ別のコントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, カテゴリ別の一覧表示"
+ms.assetid: f8a1f78e-d9fa-4367-9ec6-f084577e83bb
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# カテゴリ別のコントロール
+[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] コントロールは、さまざまなカテゴリに、論理的にグループ化されます。  これらのカテゴリを使用すると、類似の使用パターンや機能を持つコントロールを見つけやすいため、シナリオに適したコントロールを選択できます。  
+  
+## \[レイアウト\]  
+ レイアウト コントロールは、要素のサイズ、次元、位置、および子コンテンツの配置の制御に使用します。  
+  
+-   <xref:System.Windows.Controls.Border>  
+  
+-   <xref:System.Windows.Controls.Primitives.BulletDecorator>  
+  
+-   <xref:System.Windows.Controls.Canvas>  
+  
+-   <xref:System.Windows.Controls.DockPanel>  
+  
+-   <xref:System.Windows.Controls.Expander>  
+  
+-   <xref:System.Windows.Controls.Grid>  
+  
+-   <xref:System.Windows.Controls.GridSplitter>  
+  
+-   <xref:System.Windows.Controls.GroupBox>  
+  
+-   <xref:System.Windows.Controls.Panel>  
+  
+-   <xref:System.Windows.Controls.Primitives.ResizeGrip>  
+  
+-   <xref:System.Windows.Controls.Separator>  
+  
+-   <xref:System.Windows.Controls.Primitives.ScrollBar>  
+  
+-   <xref:System.Windows.Controls.ScrollViewer>  
+  
+-   <xref:System.Windows.Controls.StackPanel>  
+  
+-   <xref:System.Windows.Controls.Primitives.Thumb>  
+  
+-   <xref:System.Windows.Controls.Viewbox>  
+  
+-   <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+-   <xref:System.Windows.Window>  
+  
+-   <xref:System.Windows.Controls.WrapPanel>  
+  
+## ボタン  
+ ボタンは、最も基本的なユーザー インターフェイス コントロールの 1 つです。  アプリケーションは通常、ユーザーがボタンをクリックしたときに、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント内のタスクを実行します。  
+  
+-   <xref:System.Windows.Controls.Button>  
+  
+-   <xref:System.Windows.Controls.Primitives.RepeatButton>  
+  
+## データ表示  
+ データ表示コントロールは、データ ソースからの情報を表示する目的で使用されます。  
+  
+-   <xref:System.Windows.Controls.DataGrid>  
+  
+-   <xref:System.Windows.Controls.ListView>  
+  
+-   <xref:System.Windows.Controls.TreeView>  
+  
+## 日付表示および選択  
+ 日付コントロールは、カレンダーの情報を表示したり選択したりする目的で使用します。  
+  
+-   <xref:System.Windows.Controls.Calendar>  
+  
+-   <xref:System.Windows.Controls.DatePicker>  
+  
+## メニュー  
+ メニューは、関連するアクションをグループ化したり、コンテキスト支援を提供するために使用されます。  
+  
+-   <xref:System.Windows.Controls.ContextMenu>  
+  
+-   <xref:System.Windows.Controls.Menu>  
+  
+-   <xref:System.Windows.Controls.ToolBar>  
+  
+## Selection  
+ 選択コントロールを使用すると、ユーザーは 1 つまたは複数のオプションを選択できます。  
+  
+-   <xref:System.Windows.Controls.CheckBox>  
+  
+-   <xref:System.Windows.Controls.ComboBox>  
+  
+-   <xref:System.Windows.Controls.ListBox>  
+  
+-   <xref:System.Windows.Controls.RadioButton>  
+  
+-   <xref:System.Windows.Controls.Slider>  
+  
+## Navigation  
+ ナビゲーション コントロールは、対象のフレームやタブ付きのアプリケーションの外観を作成することによって、アプリケーションのナビゲーション操作を向上または拡張します。  
+  
+-   <xref:System.Windows.Controls.Frame>  
+  
+-   <xref:System.Windows.Documents.Hyperlink>  
+  
+-   <xref:System.Windows.Controls.Page>  
+  
+-   <xref:System.Windows.Navigation.NavigationWindow>  
+  
+-   <xref:System.Windows.Controls.TabControl>  
+  
+## ダイアログ ボックス  
+ ダイアログ ボックスは、印刷などの通常のユーザー操作のシナリオに、対象となるサポートを提供します。  
+  
+-   <xref:Microsoft.Win32.OpenFileDialog>  
+  
+-   <xref:System.Windows.Controls.PrintDialog>  
+  
+-   <xref:Microsoft.Win32.SaveFileDialog>  
+  
+## ユーザー情報  
+ ユーザー情報コントロールは、コンテキスト フィードバックを提供したり、アプリケーションのユーザー インターフェイスを明確にします。  ユーザーは通常、このコントロールを操作できません。  
+  
+-   <xref:System.Windows.Controls.AccessText>  
+  
+-   <xref:System.Windows.Controls.Label>  
+  
+-   <xref:System.Windows.Controls.Primitives.Popup>  
+  
+-   <xref:System.Windows.Controls.ProgressBar>  
+  
+-   <xref:System.Windows.Controls.Primitives.StatusBar>  
+  
+-   <xref:System.Windows.Controls.TextBlock>  
+  
+-   <xref:System.Windows.Controls.ToolTip>  
+  
+## ドキュメント  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、ドキュメントの表示に特化したいくつかのコントロールがあります。  これらのコントロールは、対象ユーザーのシナリオに基づいて、読みやすさを最適化します。  
+  
+-   <xref:System.Windows.Controls.DocumentViewer>  
+  
+-   <xref:System.Windows.Controls.FlowDocumentPageViewer>  
+  
+-   <xref:System.Windows.Controls.FlowDocumentReader>  
+  
+-   <xref:System.Windows.Controls.FlowDocumentScrollViewer>  
+  
+-   <xref:System.Windows.Controls.StickyNoteControl>  
+  
+## 入力  
+ 入力コントロールを使用すると、ユーザーはテキストや他のコンテンツを入力できます。  
+  
+-   <xref:System.Windows.Controls.TextBox>  
+  
+-   <xref:System.Windows.Controls.RichTextBox>  
+  
+-   <xref:System.Windows.Controls.PasswordBox>  
+  
+## メディア  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、一般的なイメージ形式の[コーデック](GTMT)、オーディオ コンテンツとビデオ コンテンツのホストを統合的にサポートします。  
+  
+-   <xref:System.Windows.Controls.Image>  
+  
+-   <xref:System.Windows.Controls.MediaElement>  
+  
+-   <xref:System.Windows.Controls.SoundPlayerAction>  
+  
+## デジタル インク  
+ デジタル インク コントロールは、インク表示やインク入力など、[!INCLUDE[TLA#tla_tpc](../../../../includes/tlasharptla-tpc-md.md)] 機能の統合的なサポートを提供します。  
+  
+-   <xref:System.Windows.Controls.InkCanvas>  
+  
+-   <xref:System.Windows.Controls.InkPresenter>  
+  
+## 参照  
+ [コントロール ライブラリ](../../../../docs/framework/wpf/controls/control-library.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/creating-a-control-that-has-a-customizable-appearance.md b/docs/framework/wpf/controls/creating-a-control-that-has-a-customizable-appearance.md
new file mode 100644
index 00000000000..a7fe5190c2f
--- /dev/null
+++ b/docs/framework/wpf/controls/creating-a-control-that-has-a-customizable-appearance.md
@@ -0,0 +1,245 @@
+---
+title: "外観をカスタマイズできるコントロールの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], カスタマイズ"
+  - "コントロール [WPF], 定義 (視覚的な構造と視覚的な動作を)"
+  - "ControlTemplate [WPF], カスタマイズ (外観を)"
+  - "カスタマイズ (外観を) [WPF], ControlTemplate"
+  - "管理 (コントロールの状態を) [WPF], VisualStateManager"
+  - "VisualStateManager [WPF], ベスト プラクティス"
+  - "VisualStateManager [WPF], 管理 (コントロールの状態を)"
+ms.assetid: 9e356d3d-a3d0-4b01-a25f-2d43e4d53fe5
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 外観をカスタマイズできるコントロールの作成
+<a name="introduction"></a> [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、外観をカスタマイズできるコントロールを作成できます。  たとえば、新しい <xref:System.Windows.Controls.ControlTemplate> を作成すると、<xref:System.Windows.Controls.CheckBox> の外観に対して、プロパティの設定だけではできないような変更を加えることができます。  次の図は、既定の <xref:System.Windows.Controls.ControlTemplate> を使用する <xref:System.Windows.Controls.CheckBox> と、カスタムの <xref:System.Windows.Controls.ControlTemplate> を使用する <xref:System.Windows.Controls.CheckBox> を示しています。  
+  
+ ![既定のコントロール テンプレート付きのチェック ボックス](../../../../docs/framework/wpf/controls/media/ndp-checkboxdefault.png "NDP\_CheckBoxDefault")  
+既定のコントロール テンプレートを使用する CheckBox  
+  
+ ![カスタム コントロール テンプレート付きのチェック ボックス](../../../../docs/framework/wpf/controls/media/ndp-checkboxcustom.png "NDP\_CheckBoxCustom")  
+カスタム コントロール テンプレートを使用する CheckBox  
+  
+ Parts and States モデルに従って作成されたコントロールは、その外観をカスタマイズできます。  Parts and States モデルは、Microsoft Expression Blend などのデザイナー ツールでサポートされるため、Parts and States モデルに従って作成されたコントロールであれば、これらのデザイナー ツールでカスタマイズできます。  このトピックでは、Parts and States モデルとは何か、また、このモデルに従ってどのように独自のコントロールを作成するのかについて説明します。  また、カスタム コントロールの例として、`NumericUpDown` を使用しながら、このモデルの考え方を説明します。  `NumericUpDown` は数値を表示するコントロールです。ユーザーは、このコントロールのボタンをクリックして数値を増減させることができます。  次の図は、このトピックで説明する `NumericUpDown` コントロールを示しています。  
+  
+ ![NumericUpDown カスタム コントロール](../../../../docs/framework/wpf/controls/media/ndp-numericupdown.png "NDP\_NumericUPDown")  
+カスタムの NumericUpDown コントロール  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [必要条件](#prerequisites)  
+  
+-   [Parts and States モデル](#parts_and_states_model)  
+  
+-   [コントロールの視覚的な構造と視覚的な動作を ControlTemplate で定義する](#defining_the_visual_structure_and_visual_behavior_of_a_control_in_a_controltemplate)  
+  
+-   [コードから ControlTemplate のパーツを使用する際はベスト プラクティスに従う](#using_parts_of_the_controltemplate_in_code)  
+  
+-   [コントロール コントラクトを提供する](#providing_the_control_contract)  
+  
+-   [コード例全体](#complete_example)  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックでは、読者が既存のコントロールに新しい <xref:System.Windows.Controls.ControlTemplate> を作成する方法を知っていること、コントロール コントラクトの要素に精通していること、および「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」で説明されている概念を理解していることを前提としています。  
+  
+> [!NOTE]
+>  外観をカスタマイズできるコントロールを作成するには、<xref:System.Windows.Controls.Control> クラスまたはそのサブクラス \(<xref:System.Windows.Controls.UserControl> を除く\) を継承するコントロールを作成する必要があります。  <xref:System.Windows.Controls.UserControl> を継承するコントロールはすばやく作成できますが、<xref:System.Windows.Controls.ControlTemplate> が使用されていないため、外観をカスタマイズすることはできません。  
+  
+<a name="parts_and_states_model"></a>   
+## Parts and States モデル  
+ Parts and States モデルでは、コントロールの視覚的な構造と視覚的な動作をどのように定義するかを指定します。  Parts and States モデルに準拠するには、次の作業が必要となります。  
+  
+-   コントロールの視覚的な構造と視覚的な動作を <xref:System.Windows.Controls.ControlTemplate> で定義する。  
+  
+-   コントロールのロジックと \(コントロール テンプレートの\) パーツとの接点となる部分を、特定のベスト プラクティスに従って定義する。  
+  
+-   <xref:System.Windows.Controls.ControlTemplate> に含まれる必要のある事柄を規定した "コントロール コントラクト" を提供する。  
+  
+ コントロールの視覚的な構造と視覚的な動作が <xref:System.Windows.Controls.ControlTemplate> で定義されている限り、アプリケーション作成者は、コードを記述しなくても、新しい <xref:System.Windows.Controls.ControlTemplate> を作成して、コントロールの視覚的な構造と視覚的な動作を変更できます。  ここで、<xref:System.Windows.Controls.ControlTemplate> で定義されている必要のある <xref:System.Windows.FrameworkElement> のオブジェクトおよび状態を、アプリケーション作成者に対して伝えるコントロール コントラクトを提供する必要があります。  不完全な <xref:System.Windows.Controls.ControlTemplate> が適用されても適切に動作するように、<xref:System.Windows.Controls.ControlTemplate> のパーツとの接点となる部分に関しては、いくつかのベスト プラクティスに従う必要があります。  この 3 つの原則を踏まえてコントロールを作成しておくことで、アプリケーション作成者は、そのコントロールの <xref:System.Windows.Controls.ControlTemplate> を、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属のコントロールに対して作成する場合と同じように簡単に作成できます。  これらの推奨事項については、以下のセクションで詳しく説明します。  
+  
+<a name="defining_the_visual_structure_and_visual_behavior_of_a_control_in_a_controltemplate"></a>   
+## コントロールの視覚的な構造と視覚的な動作を ControlTemplate で定義する  
+ Parts and States モデルに従ってカスタム コントロールを作成するときは、コントロールの視覚的な構造と視覚的な動作をコントロールのロジックではなく <xref:System.Windows.Controls.ControlTemplate> で定義します。  コントロールの視覚的な構造は、そのコントロールを構成するさまざまな <xref:System.Windows.FrameworkElement> オブジェクトの複合体と考えることができます。  視覚的な動作とは、コントロールが特定の状態になったときにどのように表示されるかということです。  <xref:System.Windows.Controls.ControlTemplate> を作成して、コントロールの視覚的な構造と視覚的な動作を指定する方法の詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+ `NumericUpDown` コントロールの場合、視覚的な構造には、2 つの <xref:System.Windows.Controls.Primitives.RepeatButton> コントロールと、1 つの <xref:System.Windows.Controls.TextBlock> が含まれます。  これらのコントロールを、`NumericUpDown` コントロールのコード \(コンストラクターなど\) で追加した場合、コントロールの位置を変更できなくなります。  コントロールの視覚的な構造と視覚的な動作は、コードではなく <xref:System.Windows.Controls.ControlTemplate> で定義する必要があります。  このように設計することで、アプリケーション開発者は、<xref:System.Windows.Controls.ControlTemplate> を置き換えて、ボタンや <xref:System.Windows.Controls.TextBlock> の位置をカスタマイズし、`Value` が負数になったときの動作を指定できます。  
+  
+ 次の例は、`NumericUpDown` コントロールの視覚的な構造を示しています。このコントロールには、`Value` を増加させるための <xref:System.Windows.Controls.Primitives.RepeatButton>、`Value` を減少させるための <xref:System.Windows.Controls.Primitives.RepeatButton>、および `Value` を表示するための <xref:System.Windows.Controls.TextBlock> が含まれています。  
+  
+ [!code-xml[VSMCustomControl#VisualStructure](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/window1.xaml#visualstructure)]  
+  
+ この `NumericUpDown` コントロールは、負の値を赤色のフォントで表示するという、視覚的な動作を持ちます。  `Value` が負数のときに <xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Foreground%2A> を変更するという処理をコードで記述した場合、`NumericUpDown` は負の値を赤色でしか表示できなくなります。  コントロールの視覚的な動作は <xref:System.Windows.Controls.ControlTemplate> で <xref:System.Windows.Controls.ControlTemplate> に <xref:System.Windows.VisualState> オブジェクトを追加して指定します。  次の例は、`Positive` または `Negative` の状態に対応する <xref:System.Windows.VisualState> オブジェクトを示しています。  `Positive` と `Negative` は同時に指定できない \(同時に 2 つの状態であることはできない\) ため、この例では <xref:System.Windows.VisualState> オブジェクトを単一の <xref:System.Windows.VisualStateGroup> にまとめています。  コントロールが `Negative` 状態に移行した場合、<xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Foreground%2A> が赤色に変化します。  コントロールが `Positive` 状態の場合、<xref:System.Windows.Controls.TextBlock.Foreground%2A> が元の値に戻ります。  <xref:System.Windows.Controls.ControlTemplate> で <xref:System.Windows.VisualState> オブジェクトを定義する方法については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」で詳しく説明しています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.VisualStateManager.VisualStateGroups%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Controls.ControlTemplate> のルート <xref:System.Windows.FrameworkElement> に設定してください。  
+  
+ [!code-xml[VSMCustomControl#ValueStates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/window1.xaml#valuestates)]  
+  
+<a name="using_parts_of_the_controltemplate_in_code"></a>   
+## コードから ControlTemplate のパーツを使用する際はベスト プラクティスに従う  
+ <xref:System.Windows.Controls.ControlTemplate> の作成者が必ずしも <xref:System.Windows.FrameworkElement> オブジェクトや <xref:System.Windows.VisualState> オブジェクトを厳密に定義するとは限りません。意図的に、または間違いによって、それらのオブジェクトが省略される可能性があります。しかし、カスタム コントロールのロジックでは、これらのパーツが適切に機能することが必要となる場合があります。  <xref:System.Windows.Controls.ControlTemplate> からの <xref:System.Windows.FrameworkElement> や <xref:System.Windows.VisualState> オブジェクトの欠落に対応できることは、Parts and States モデルがコントロールに対して求めている条件の 1 つでもあります。  <xref:System.Windows.FrameworkElement>、<xref:System.Windows.VisualState>、<xref:System.Windows.VisualStateGroup> などが <xref:System.Windows.Controls.ControlTemplate> に存在しない場合でも、カスタム コントロールが例外をスローする、またはエラーを報告することのないようにする必要があります。  このセクションでは、<xref:System.Windows.FrameworkElement> オブジェクトとの対話や状態の管理に関するベスト プラクティスについて説明します。  
+  
+### FrameworkElement オブジェクトが存在しない可能性を想定する  
+ <xref:System.Windows.Controls.ControlTemplate> で <xref:System.Windows.FrameworkElement> オブジェクトを定義する場合、カスタム コントロールのロジックの中で、そのいくつかのオブジェクトとの対話が必要になることがあります。  たとえば、`NumericUpDown` コントロールは、ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントをサブスクライブして `Value` を増減させ、<xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Text%2A> プロパティを `Value` に設定します。  カスタム <xref:System.Windows.Controls.ControlTemplate> で <xref:System.Windows.Controls.TextBlock> やボタンが省略され、そのコントロールのいくつかの機能が失われていても、コントロールは使用できます。ただし、そのような場合でも、コントロールがエラーを発生させないようにする必要があります。  たとえば、<xref:System.Windows.Controls.ControlTemplate> に `Value` を変更するためのボタンが存在しないと、`NumericUpDown` はその機能を果たせなくなりますが、それによって、<xref:System.Windows.Controls.ControlTemplate> を使用しているアプリケーションの実行が中断されることは避ける必要があります。  
+  
+ <xref:System.Windows.FrameworkElement> オブジェクトの欠落に適切に対処するためのベスト プラクティスを次に示します。  
+  
+1.  コード内で参照する必要のある各 <xref:System.Windows.FrameworkElement> に `x:Name` 属性を設定します。  
+  
+2.  対話する必要のある各 <xref:System.Windows.FrameworkElement> についてプライベート プロパティを定義します。  
+  
+3.  カスタム コントロールで処理するイベントのサブスクライブとアンサブスクライブを、<xref:System.Windows.FrameworkElement> プロパティの set アクセサーで行います。  
+  
+4.  手順 2. で定義した <xref:System.Windows.FrameworkElement> プロパティを、<xref:System.Windows.FrameworkElement.OnApplyTemplate%2A> メソッドで設定します。  これが、コントロールから <xref:System.Windows.Controls.ControlTemplate> の <xref:System.Windows.FrameworkElement> にアクセスできる最も早いタイミングです。  <xref:System.Windows.FrameworkElement> を <xref:System.Windows.Controls.ControlTemplate> から取得する際は、`x:Name` を使用します。  
+  
+5.  <xref:System.Windows.FrameworkElement> が `null` でないことを、そのメンバーにアクセスする前に確認します。  `null` であったとしても、エラーを報告しないようにします。  
+  
+ 以上の推奨事項に従って作成された `NumericUpDown` コントロールの例を次に示します。<xref:System.Windows.FrameworkElement> オブジェクトの扱いに注目しながら参照してください。  
+  
+ この例では、`NumericUpDown` コントロールの視覚的な構造が <xref:System.Windows.Controls.ControlTemplate> で定義されています。`Value` を増やすための <xref:System.Windows.Controls.Primitives.RepeatButton> は、その `x:Name` 属性が `UpButton` に設定されています。  次の例を見ると、<xref:System.Windows.Controls.ControlTemplate> で定義された <xref:System.Windows.Controls.Primitives.RepeatButton> を表す `UpButtonElement` というプロパティが宣言されていることがわかります。  `set` アクセサーでは、まず、`UpDownElement` が `null` 以外の場合に、ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントをアンサブスクライブし、そのプロパティを設定した後、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントをサブスクライブしています。  ここでは示していませんが、他の <xref:System.Windows.Controls.Primitives.RepeatButton> プロパティも `DownButtonElement` という名前で定義されています。  
+  
+ [!code-csharp[VSMCustomControl#UpButtonProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#upbuttonproperty)]
+ [!code-vb[VSMCustomControl#UpButtonProperty](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#upbuttonproperty)]  
+  
+ 次の例は、`NumericUpDown` コントロールの <xref:System.Windows.FrameworkElement.OnApplyTemplate%2A> を示しています。  この例では、<xref:System.Windows.Controls.ControlTemplate> から <xref:System.Windows.FrameworkElement> オブジェクトを取得するために、<xref:System.Windows.FrameworkElement.GetTemplateChild%2A> メソッドが使用されています。  <xref:System.Windows.FrameworkElement.GetTemplateChild%2A> で、想定外の型の名前が指定された <xref:System.Windows.FrameworkElement> が見つかった場合の対策がなされている点に注目してください。  また、指定された `x:Name` を持つ要素でも、型が間違っている場合は無視しています。これも 1 つのベスト プラクティスです。  
+  
+ [!code-csharp[VSMCustomControl#ApplyTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#applytemplate)]
+ [!code-vb[VSMCustomControl#ApplyTemplate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#applytemplate)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> に <xref:System.Windows.FrameworkElement> が存在していなくても、前の例に示したベスト プラクティスに従っていれば、コントロールの実行が妨げられることはありません。  
+  
+### VisualStateManager を使用して状態を管理する  
+ <xref:System.Windows.VisualStateManager> はコントロールの状態を追跡し、状態間の遷移に必要なロジックを実行します。  <xref:System.Windows.Controls.ControlTemplate> に <xref:System.Windows.VisualState> オブジェクトを追加する場合は、それらを <xref:System.Windows.VisualStateGroup> に追加し、さらに、その <xref:System.Windows.VisualStateGroup> を <xref:System.Windows.VisualStateManager.VisualStateGroups%2A?displayProperty=fullName> 添付プロパティに追加して、<xref:System.Windows.VisualStateManager> からアクセスできるようにします。  
+  
+ 次の例は、前の例に続き、コントロールの `Positive` 状態および `Negative` 状態に対応する <xref:System.Windows.VisualState> オブジェクトを示しています。  `Negative` <xref:System.Windows.VisualState> の <xref:System.Windows.Media.Animation.Storyboard> は、<xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Foreground%2A> を赤色に変化させます。  `NumericUpDown` コントロールが `Negative` 状態になると、`Negative` 状態のストーリーボードが開始されます。  `Negative` 状態の <xref:System.Windows.Media.Animation.Storyboard> は、コントロールが `Positive` 状態に戻ると停止します。  `Negative` の <xref:System.Windows.Media.Animation.Storyboard> が停止した場合、<xref:System.Windows.Controls.TextBlock.Foreground%2A> が元の色に戻るため、`Positive` <xref:System.Windows.VisualState> には、必ずしも <xref:System.Windows.Media.Animation.Storyboard> が存在している必要はありません。  
+  
+ [!code-xml[VSMCustomControl#ValueStates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/window1.xaml#valuestates)]  
+  
+ <xref:System.Windows.Controls.TextBlock> には名前が付けられますが、<xref:System.Windows.Controls.TextBlock> は `NumericUpDown` のコントロール コントラクトに存在しないことに注意してください。これは、コントロールのロジックが <xref:System.Windows.Controls.TextBlock> を参照しないためです。  名前を持つ要素は <xref:System.Windows.Controls.ControlTemplate> で参照されますが、コントロール コントラクトの一部である必要はありません。コントロールの新しい <xref:System.Windows.Controls.ControlTemplate> は、その要素を参照する必要がないことがあるためです。  たとえば、`NumericUpDown` の新しい <xref:System.Windows.Controls.ControlTemplate> を作成する人が、<xref:System.Windows.Controls.Control.Foreground%2A> を変更して、その `Value` が負数であることを示さなかったとします。  この場合、コードも <xref:System.Windows.Controls.ControlTemplate> も <xref:System.Windows.Controls.TextBlock> を名前で参照しません。  
+  
+ コントロールの状態は、コントロールのロジックで変更します。  次の例では、`Value` が 0 以上の場合は `Positive` 状態に移行し、`Value` が 0 未満の場合は `Negative` 状態に移行するというロジックを、`NumericUpDown` コントロールから <xref:System.Windows.VisualStateManager.GoToState%2A> メソッドを呼び出して実現しています。  
+  
+ [!code-csharp[VSMCustomControl#ValueStateChange](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#valuestatechange)]
+ [!code-vb[VSMCustomControl#ValueStateChange](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#valuestatechange)]  
+  
+ <xref:System.Windows.VisualStateManager.GoToState%2A> メソッドは、ストーリーボードを開始または停止するために必要なロジックを実行します。  コントロールがその状態を変化させるために <xref:System.Windows.VisualStateManager.GoToState%2A> を呼び出すと、<xref:System.Windows.VisualStateManager> によって次の処理が実行されます。  
+  
+-   これから移行しようとしている <xref:System.Windows.VisualState> に <xref:System.Windows.Media.Animation.Storyboard> が存在する場合は、そのストーリーボードを開始します。  さらに、移行前の <xref:System.Windows.VisualState> に <xref:System.Windows.Media.Animation.Storyboard> が存在する場合は、そのストーリーボードを終了します。  
+  
+-   コントロールが既に指定された状態である場合、<xref:System.Windows.VisualStateManager.GoToState%2A> は何も実行せずに、`true` を返します。  
+  
+-   `control` の <xref:System.Windows.Controls.ControlTemplate> に存在しない状態が指定された場合、<xref:System.Windows.VisualStateManager.GoToState%2A> は何も実行せずに、`false` を返します。  
+  
+#### VisualStateManager の使用上のベスト プラクティス  
+ コントロールの状態を管理する際は、次のようにすることをお勧めします。  
+  
+-   プロパティを使用してその状態を追跡する。  
+  
+-   状態を遷移させるためのヘルパー メソッドを作成する。  
+  
+ `NumericUpDown` コントロールは、その `Value` プロパティを使用してその状態 \(`Positive` または `Negative`\) を追跡します。  また、`NumericUpDown` コントロールは `Focused` および `UnFocused` の状態を定義することで、<xref:System.Windows.UIElement.IsFocused%2A> プロパティも追跡します。  コントロールのプロパティに元から対応していない状態を使用する場合は、プライベート プロパティを定義して状態を追跡できます。  
+  
+ 単一のメソッドですべての状態を更新して <xref:System.Windows.VisualStateManager> への呼び出しを集中化することで、コードを管理できる状態に保ちます。  次の例は、`NumericUpDown` コントロールのヘルパー メソッド `UpdateStates` です。  `Value` が 0 以上の場合、<xref:System.Windows.Controls.Control> は `Positive` 状態になります。  `Value` が 0 未満の場合、コントロールは `Negative` 状態になります。  <xref:System.Windows.UIElement.IsFocused%2A> が `true` の場合、コントロールは `Focused` 状態になり、それ以外の場合は `Unfocused` 状態になります。  コントロールは、どの状態への変更であるかに関係なく、状態を変更する必要があるときは常に `UpdateStates` を呼び出すことができます。  
+  
+ [!code-csharp[VSMCustomControl#UpdateStates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#updatestates)]
+ [!code-vb[VSMCustomControl#UpdateStates](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#updatestates)]  
+  
+ 特定の状態の名前を <xref:System.Windows.VisualStateManager.GoToState%2A> に渡した場合、コントロールが既にその状態になっていれば、<xref:System.Windows.VisualStateManager.GoToState%2A> は何も実行しません。したがって、コントロールの現在の状態を確認する必要はありません。  たとえば、`Value` が負数から別の負数に変化した場合、`Negative` 状態のストーリーボードは中断されず、ユーザーから見てもコントロールの外観は変化しません。  
+  
+ <xref:System.Windows.VisualStateManager> は、<xref:System.Windows.VisualStateManager.GoToState%2A> が呼び出されたときに、どの状態を終了させればよいかを、<xref:System.Windows.VisualStateGroup> オブジェクトを使って判断します。  <xref:System.Windows.VisualStateGroup> は <xref:System.Windows.Controls.ControlTemplate> に定義されており、コントロールは、それぞれの VisualStateGroup につき必ず 1 つの状態を持ちます。この状態が失われるのは、同じ <xref:System.Windows.VisualStateGroup> 内の別の状態に移行するときだけです。  たとえば、`NumericUpDown` コントロールの <xref:System.Windows.Controls.ControlTemplate> には、`Positive` と `Negative` という <xref:System.Windows.VisualState> オブジェクトと、`Focused` と `Unfocused` という <xref:System.Windows.VisualState> オブジェクトが、それぞれ異なる <xref:System.Windows.VisualStateGroup> に定義されています   \(`Focused` と `Unfocused` <xref:System.Windows.VisualState> が定義されているところは、このトピックの「[コード例全体](#complete_example)」で参照できます\)。コントロールの状態が `Positive` から `Negative` に \(または逆の状態に\) 変化した場合、コントロールは `Focused` または `Unfocused` の状態のままになります。  
+  
+ 一般に、コントロールの状態が変化するタイミングとしては、次の 3 つが考えられます。  
+  
+-   <xref:System.Windows.Controls.Control> に <xref:System.Windows.Controls.ControlTemplate> が適用されたとき。  
+  
+-   プロパティが変化したとき。  
+  
+-   イベントが発生したとき。  
+  
+ それぞれのケースで `NumericUpDown` コントロールの状態を更新する例を次に示します。  
+  
+ コントロールの状態は <xref:System.Windows.FrameworkElement.OnApplyTemplate%2A> メソッドで更新する必要があります。これにより、<xref:System.Windows.Controls.ControlTemplate> の適用時にコントロールが正しい状態で表示されます。  次の例では、<xref:System.Windows.FrameworkElement.OnApplyTemplate%2A> で `UpdateStates` を呼び出して、コントロールを適切な状態に移行させています。  たとえば、`NumericUpDown` コントロールを作成し、その <xref:System.Windows.Controls.Control.Foreground%2A> を緑色に設定し、`Value` を \-5 に設定したとします。  `NumericUpDown` コントロールに <xref:System.Windows.Controls.ControlTemplate> を適用する際に `UpdateStates` を呼び出さなかった場合、コントロールの状態が `Negative` に移行せず、値が赤色ではなく緑色で表示されます。  コントロールを `Negative` 状態に移行させるには、`UpdateStates` を呼び出す必要があります。  
+  
+ [!code-csharp[VSMCustomControl#ApplyTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#applytemplate)]
+ [!code-vb[VSMCustomControl#ApplyTemplate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#applytemplate)]  
+  
+ プロパティが変更された場合にコントロールの状態を更新するケースも珍しくありません。  次の例は、`ValueChangedCallback` メソッド全体のコードを示しています。  `ValueChangedCallback` は `Value` が変化するたびにメソッドで呼び出されるため、`UpdateStates` の呼び出しは、`Value` が正から負に \(または負から正に\) 変化したときに行われます。  正数であるか負数であるかにかかわらず `Value` が変化したときに常に `UpdateStates` を呼び出すことができます \(正負の変化がなければ、コントロールの状態は変化しないため\)。  
+  
+ [!code-csharp[VSMCustomControl#EntireValueChangedCallback](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#entirevaluechangedcallback)]
+ [!code-vb[VSMCustomControl#EntireValueChangedCallback](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#entirevaluechangedcallback)]  
+  
+ イベントの発生時に状態を更新するケースもあります。  次の例では、`NumericUpDown` が <xref:System.Windows.Controls.Control> の `UpdateStates` を呼び出して、<xref:System.Windows.UIElement.GotFocus> イベントを処理しています。  
+  
+ [!code-csharp[VSMCustomControl#OnGotFocus](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#ongotfocus)]
+ [!code-vb[VSMCustomControl#OnGotFocus](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#ongotfocus)]  
+  
+ <xref:System.Windows.VisualStateManager> を使用すると、コントロールの状態を簡単に管理できます。  <xref:System.Windows.VisualStateManager> を使用すると、コントロールの状態を正しく遷移させることができます。  このセクションで述べた推奨事項に従って <xref:System.Windows.VisualStateManager> を使用すると、コントロールのコードが読みやすくなり、コードの保守性が向上します。  
+  
+<a name="providing_the_control_contract"></a>   
+## コントロール コントラクトを提供する  
+ コントロール コントラクトが提供されている場合、<xref:System.Windows.Controls.ControlTemplate> 作成者は、これから作成しようとしているテンプレートに何を定義するのかを知ることができます。  コントロール コントラクトには、3 つの要素があります。  
+  
+-   コントロールのロジックが使用する視覚的要素。  
+  
+-   コントロールの状態と各状態が属するグループ。  
+  
+-   コントロールに対して視覚的に作用するパブリック プロパティ。  
+  
+ 新しい <xref:System.Windows.Controls.ControlTemplate> の作成者が、まず必要とする情報は、コントロールのロジックに使用されている <xref:System.Windows.FrameworkElement> オブジェクトと、それぞれのオブジェクトの型および名前です。  また、<xref:System.Windows.Controls.ControlTemplate> の作成者は、さらにコントロールに想定されているすべての状態の名前と、それぞれの状態がどの <xref:System.Windows.VisualStateGroup> に属しているかを知っておく必要があります。  
+  
+ 前の `NumericUpDown` コントロールの場合、<xref:System.Windows.Controls.ControlTemplate> には次の <xref:System.Windows.FrameworkElement> オブジェクトが必要です。  
+  
+-   <xref:System.Windows.Controls.Primitives.RepeatButton> \(`UpButton`\)  
+  
+-   <xref:System.Windows.Controls.Primitives.RepeatButton> \(`DownButton.`\)  
+  
+ コントロールに想定されている状態は次のとおりです。  
+  
+-   `ValueStates` <xref:System.Windows.VisualStateGroup>  
+  
+    -   `Positive`  
+  
+    -   `Negative`  
+  
+-   `FocusStates` <xref:System.Windows.VisualStateGroup>  
+  
+    -   `Focused`  
+  
+    -   `Unfocused`  
+  
+ コントロールに必要な <xref:System.Windows.FrameworkElement> オブジェクトを指定するには、<xref:System.Windows.TemplatePartAttribute> を使用して、必要な要素の名前と型を指定します。  コントロールに想定されている状態を指定するには、<xref:System.Windows.TemplateVisualStateAttribute> を使用して、状態の名前とその所属先の <xref:System.Windows.VisualStateGroup> を指定します。  <xref:System.Windows.TemplatePartAttribute> および <xref:System.Windows.TemplateVisualStateAttribute> は、コントロールのクラス定義に記述します。  
+  
+ コントロールの外観に影響するパブリック プロパティもコントロール コントラクトの一部です。  
+  
+ 次の例では、`NumericUpDown` コントロールの <xref:System.Windows.FrameworkElement> オブジェクトおよび状態を指定しています。  
+  
+ [!code-csharp[VSMCustomControl#ControlContract](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#controlcontract)]
+ [!code-vb[VSMCustomControl#ControlContract](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#controlcontract)]  
+  
+<a name="complete_example"></a>   
+## コード例全体  
+ 次の例は、`NumericUpDown` コントロールの完全な <xref:System.Windows.Controls.ControlTemplate> です。  
+  
+ [!code-xml[VSMCustomControl#NUDTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/themes/generic.xaml#nudtemplate)]  
+  
+ `NumericUpDown` のロジックの例を次に示します。  
+  
+ [!code-csharp[VSMCustomControl#ControlLogic](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmcustomcontrol/csharp/numericupdown.cs#controllogic)]
+ [!code-vb[VSMCustomControl#ControlLogic](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmcustomcontrol/visualbasic/numericupdown.vb#controllogic)]  
+  
+## 参照  
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md b/docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md
new file mode 100644
index 00000000000..d23a71c1e90
--- /dev/null
+++ b/docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md
@@ -0,0 +1,270 @@
+---
+title: "ControlTemplate の作成による既存のコントロールの外観のカスタマイズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール コントラクト [WPF]"
+  - "コントロール [WPF], 外観 (状態に応じた)"
+  - "コントロール [WPF], 視覚的な構造の変更"
+  - "ControlTemplate [WPF], カスタマイズ (既存のコントロールを)"
+  - "スキンの適用 (コントロールに) [WPF]"
+  - "テンプレート [WPF], カスタム (既存のコントロール用)"
+ms.assetid: 678dd116-43a2-4b8c-82b5-6b826f126e31
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ControlTemplate の作成による既存のコントロールの外観のカスタマイズ
+<a name="introduction"></a> <xref:System.Windows.Controls.ControlTemplate> を使用して、コントロールの視覚的な構造および動作を指定します。  コントロールの外観をカスタマイズするには、コントロールの新しい <xref:System.Windows.Controls.ControlTemplate> を作成します。  <xref:System.Windows.Controls.ControlTemplate> を作成すると、既存のコントロールの機能を変更せずに外観だけを変更できます。  たとえば、アプリケーションのボタンを既定の四角形から丸い形に変更しても、今までどおりそのボタンで <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントが発生します。  
+  
+ このトピックでは、<xref:System.Windows.Controls.ControlTemplate> の各部分について説明し、<xref:System.Windows.Controls.Button> の単純な <xref:System.Windows.Controls.ControlTemplate> を作成する例を示します。さらに、コントロールの外観をカスタマイズできるように、コントロールのコントロール コントラクトについて詳しく解説します。  <xref:System.Windows.Controls.ControlTemplate> は [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で作成できるため、コードを一切記述しないでコントロールの外観を変更できます。  カスタム コントロールのテンプレートを作成するためにデザイナーを、 Microsoft Expression Blend などの使用できます。  このトピックでは、<xref:System.Windows.Controls.Button> の外観をカスタマイズする [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例を示し、トピックの最後では完全な例を示します。  Expression Blend の使用方法の詳細については、「[テンプレートをサポートするコントロールのスタイル処理](http://go.microsoft.com/fwlink/?LinkId=161153)」を参照してください。  
+  
+ 次の図は、このトピックで作成する <xref:System.Windows.Controls.ControlTemplate> を使用した <xref:System.Windows.Controls.Button> を示しています。  
+  
+ ![カスタム コントロール テンプレート付きのボタン](../../../../docs/framework/wpf/controls/media/ndp-buttonnormal.png "NDP\_ButtonNormal")  
+カスタム コントロール テンプレートを使用しているボタン  
+  
+ ![赤い境界線付きのボタン](../../../../docs/framework/wpf/controls/media/ndp-buttonmouseover.png "NDP\_ButtonMouseOver")  
+カスタム コントロール テンプレートを使用したボタンにマウス ポインターを置いた図  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックは、「[コントロール](../../../../docs/framework/wpf/controls/index.md)」で説明した、コントロールとスタイルを作成して使用する方法を理解していることを前提としています。  このトピックで紹介する概念は、<xref:System.Windows.Controls.UserControl> 以外の <xref:System.Windows.Controls.Control> クラスから継承する要素に適用されます。  <xref:System.Windows.Controls.ControlTemplate> は、<xref:System.Windows.Controls.UserControl> に適用できません。  
+  
+<a name="when_you_should_create_a_controltemplate"></a>   
+## ControlTemplate の作成が必要な場合  
+ コントロールには <xref:System.Windows.Controls.Border.Background%2A>、<xref:System.Windows.Controls.Control.Foreground%2A>、<xref:System.Windows.Controls.Control.FontFamily%2A> など、多数のプロパティがあり、これらのプロパティを設定することでコントロールの外観をさまざまな面から指定できますが、プロパティの設定から変更できることは限られています。  たとえば、<xref:System.Windows.Controls.CheckBox> の <xref:System.Windows.Controls.Control.Foreground%2A> プロパティを青に、<xref:System.Windows.Controls.Control.FontStyle%2A> プロパティをイタリックに設定できます。  
+  
+ コントロールの新しい <xref:System.Windows.Controls.ControlTemplate> を作成できなければ、どの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ベースのアプリケーションでもすべてのコントロールで同じ一般的な外観を使用することになり、独自の外観と操作性を備えたアプリケーションを作成することは難しくなります。  既定では、すべての <xref:System.Windows.Controls.CheckBox> には同じ特性があります。  たとえば、<xref:System.Windows.Controls.CheckBox> のコンテンツは常に選択インジケーターの右側に配置され、<xref:System.Windows.Controls.CheckBox> がオンになっていることを示すためにチェック マークが必ず使用されます。  
+  
+ <xref:System.Windows.Controls.ControlTemplate> を作成すると、コントロールの外観に、コントロールのその他のプロパティの設定を変更するだけでは不可能なカスタマイズを施すことができるようになります。  <xref:System.Windows.Controls.CheckBox> の例では、チェック ボックスのコンテンツを選択インジケーターの上に配置し、<xref:System.Windows.Controls.CheckBox> がオンになるように "X" を使用します。  このような変更は、<xref:System.Windows.Controls.CheckBox> の <xref:System.Windows.Controls.ControlTemplate> で指定します。  
+  
+ 既定の <xref:System.Windows.Controls.ControlTemplate> を使用する <xref:System.Windows.Controls.CheckBox> を次の図に示します。  
+  
+ ![既定のコントロール テンプレート付きのチェック ボックス](../../../../docs/framework/wpf/controls/media/ndp-checkboxdefault.png "NDP\_CheckBoxDefault")  
+既定のコントロール テンプレートを使用する CheckBox  
+  
+ 次の図は、<xref:System.Windows.Controls.CheckBox> でカスタムの <xref:System.Windows.Controls.ControlTemplate> を使用して、<xref:System.Windows.Controls.CheckBox> のコンテンツを選択インジケーターの上に配置し、<xref:System.Windows.Controls.CheckBox> がオンのときに X を表示するようすを示しています。  
+  
+ ![カスタム コントロール テンプレート付きのチェック ボックス](../../../../docs/framework/wpf/controls/media/ndp-checkboxcustom.png "NDP\_CheckBoxCustom")  
+カスタム コントロール テンプレートを使用する CheckBox  
+  
+ このサンプルの <xref:System.Windows.Controls.CheckBox> の <xref:System.Windows.Controls.ControlTemplate> は比較的複雑なため、このトピックでは簡単な例を使用して <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ControlTemplate> を作成します。  
+  
+<a name="changing_the_visual_structure_of_a_control"></a>   
+## コントロールの視覚的な構造の変更  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では通常、コントロールは複合 <xref:System.Windows.FrameworkElement> オブジェクトです。  <xref:System.Windows.Controls.ControlTemplate> を作成する場合は、<xref:System.Windows.FrameworkElement> オブジェクトを組み合わせて 1 つのコントロールを作成します。  1 つの <xref:System.Windows.Controls.ControlTemplate> には、ルート要素として <xref:System.Windows.FrameworkElement> が 1 つだけ必要です。  通常、このルート要素には他の <xref:System.Windows.FrameworkElement> オブジェクトが含まれます。  オブジェクトを組み合わせて、コントロールの視覚的な構造を構成します。  
+  
+ <xref:System.Windows.Controls.Button> に対するカスタム <xref:System.Windows.Controls.ControlTemplate> を作成する例を次に示します。  <xref:System.Windows.Controls.ControlTemplate> を使用して <xref:System.Windows.Controls.Button> の視覚的な構造を作成します。  この例では、ボタン上にマウス ポインターを置いても、クリックしてもボタンの外観は変化しません。  状態に応じて外観が変化するボタンについては、このトピックで後述します。  
+  
+ この例では、次のパーツで視覚的な構造を構成しています。  
+  
+-   `RootElement` という名前の <xref:System.Windows.Controls.Border>。テンプレートのルート <xref:System.Windows.FrameworkElement> として機能します。  
+  
+-   `RootElement` の子である <xref:System.Windows.Controls.Grid>。  
+  
+-   ボタンのコンテンツを表示する <xref:System.Windows.Controls.ContentPresenter>。  <xref:System.Windows.Controls.ContentPresenter> を使用すると、あらゆる型のオブジェクトを表示できます。  
+  
+ [!code-xml[VSMButtonTemplate#BasicTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/buttonstages.xaml#basictemplate)]  
+  
+### TemplateBinding を使用してコントロールのプロパティの機能を維持する方法  
+ 新しい <xref:System.Windows.Controls.ControlTemplate> を作成した場合でも、パブリック プロパティを使用して、コントロールの外観を変更することができます。  [TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) のマークアップ拡張機能は、<xref:System.Windows.Controls.ControlTemplate> 内の要素のプロパティを、コントロールによって定義されたパブリック プロパティにバインドする機能です。  [TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) を使用すると、コントロールのプロパティを有効にして、テンプレートに対するパラメーターとして機能させることができます。  つまり、コントロールのプロパティを設定したときに、その値が [TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) を持つ要素に渡されます。  
+  
+ 前の例では、[TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) のマークアップ拡張機能を使用して、<xref:System.Windows.Controls.ControlTemplate> 内の要素のプロパティを、ボタンによって定義されたパブリック プロパティにバインドしていますが、次の例では、その一部を繰り返しています。  
+  
+ [!code-xml[VSMButtonTemplate#TemplateBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/buttonstages.xaml#templatebinding)]  
+  
+ この例では、<xref:System.Windows.Controls.Grid> で <xref:System.Windows.Controls.Panel.Background%2A?displayProperty=fullName> プロパティ テンプレートを <xref:System.Windows.Controls.Control.Background%2A?displayProperty=fullName> にバインドします。  <xref:System.Windows.Controls.Panel.Background%2A?displayProperty=fullName> がテンプレート バインディングされているため、同じ <xref:System.Windows.Controls.ControlTemplate> を使用する複数のボタンを作成し、ボタンごとに異なる値を <xref:System.Windows.Controls.Control.Background%2A?displayProperty=fullName> に設定できます。  <xref:System.Windows.Controls.Control.Background%2A?displayProperty=fullName> が <xref:System.Windows.Controls.ControlTemplate> 内の要素のプロパティにテンプレート バインディングされていないと、ボタンの <xref:System.Windows.Controls.Control.Background%2A?displayProperty=fullName> を設定してもボタンの外観に影響しません。  
+  
+ 2 つのプロパティの名前は同じである必要はありません。  前の例では、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A?displayProperty=fullName> プロパティが、<xref:System.Windows.Controls.ContentPresenter> の <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A?displayProperty=fullName> プロパティにテンプレート バインディングされています。  これにより、ボタンのコンテンツを水平方向に配置できます。  <xref:System.Windows.Controls.ContentPresenter> には `HorizontalContentAlignment` という名前のプロパティがありませんが、<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A?displayProperty=fullName> を <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A?displayProperty=fullName> にバインドすることができます。  プロパティをテンプレート バインディングするときは、ターゲットとソースのプロパティが同じ型であることを確認してください。  
+  
+ <xref:System.Windows.Controls.Control> クラスを使用して、設定時にコントロールに適用するコントロール テンプレートで使用する必要があるいくつかのプロパティを定義します。  <xref:System.Windows.Controls.ControlTemplate> でのプロパティの使用方法は、プロパティによって異なります。  <xref:System.Windows.Controls.ControlTemplate> では、次のいずれかの方法でプロパティを使用する必要があります。  
+  
+-   <xref:System.Windows.Controls.ControlTemplate> テンプレート内の要素をプロパティにバインドします。  
+  
+-   <xref:System.Windows.Controls.ControlTemplate> テンプレート内の要素は、親 <xref:System.Windows.FrameworkElement> からプロパティを継承します。  
+  
+ コントロールによって <xref:System.Windows.Controls.Control> クラスから継承される視覚プロパティを次の表に示します。  また、コントロールの既定のコントロール テンプレートで継承されたプロパティ値を使用するかどうか、およびテンプレート バインディングする必要があるかどうかも示します。  
+  
+|プロパティ|使用のメソッド|  
+|-----------|-------------|  
+|<xref:System.Windows.Controls.Control.Background%2A>|テンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.BorderThickness%2A>|テンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.BorderBrush%2A>|テンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.FontFamily%2A>|プロパティの継承またはテンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.FontSize%2A>|プロパティの継承またはテンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.FontStretch%2A>|プロパティの継承またはテンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.FontWeight%2A>|プロパティの継承またはテンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.Foreground%2A>|プロパティの継承またはテンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A>|テンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.Padding%2A>|テンプレート バインディング|  
+|<xref:System.Windows.Controls.Control.VerticalContentAlignment%2A>|テンプレート バインディング|  
+  
+ 表には、<xref:System.Windows.Controls.Control> クラスから継承される視覚プロパティのみを示しています。  表内のプロパティとは別に、コントロールによって、親フレームワーク要素から <xref:System.Windows.FrameworkElement.DataContext%2A>、<xref:System.Windows.FrameworkElement.Language%2A>、および <xref:System.Windows.Controls.TextBlock.TextDecorations%2A> の各プロパティも継承される場合があります。  
+  
+ また、<xref:System.Windows.Controls.ContentPresenter> が <xref:System.Windows.Controls.ContentControl> の <xref:System.Windows.Controls.ControlTemplate> に存在する場合は、<xref:System.Windows.Controls.ContentPresenter> は自動的に <xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> プロパティおよび <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティにバインドされます。  同様に、<xref:System.Windows.Controls.ItemsControl> の <xref:System.Windows.Controls.ControlTemplate> に存在する <xref:System.Windows.Controls.ItemsPresenter> は自動的に <xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティおよび <xref:System.Windows.Controls.ItemsPresenter> プロパティにバインドされます。  
+  
+ 次の例では、前の例で定義した <xref:System.Windows.Controls.ControlTemplate> を使用するボタンを 2 つ作成します。  この例では、各ボタンの <xref:System.Windows.Controls.Control.Background%2A>、<xref:System.Windows.Controls.Control.Foreground%2A>、および <xref:System.Windows.Controls.Control.FontSize%2A> の各プロパティを設定します。  <xref:System.Windows.Controls.Control.Background%2A> プロパティは <xref:System.Windows.Controls.ControlTemplate> にテンプレート バインディングされているため、そのプロパティの設定は有効です。  <xref:System.Windows.Controls.Control.Foreground%2A> プロパティおよび <xref:System.Windows.Controls.Control.FontSize%2A> プロパティはテンプレート バインディングされていなくても、値を継承するため、それらのプロパティの設定は有効です。  
+  
+ [!code-xml[VSMButtonTemplate#ButtonDeclaration](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/buttonstages.xaml#buttondeclaration)]  
+  
+ 前の例では、次の図のような出力を生成します。  
+  
+ ![2 つのボタン &#40;青色のボタンと紫色のボタン&#41;](../../../../docs/framework/wpf/controls/media/ndp-buttontwo.png "NDP\_ButtonTwo")  
+背景色が異なる 2 つのボタン  
+  
+<a name="changing_the_appearance_of_a_control_depending_on_its_state"></a>   
+## 状態に応じたコントロールの外観の変化  
+ 既定の外観のボタンと前の例のボタンの違いは、既定のボタンが別の状態になったときにわずかに変化することです。  たとえば、既定のボタンの外観はボタンをクリックしたときやマウス ポインターをボタンの上に置いたときに変化します。  <xref:System.Windows.Controls.ControlTemplate> によってコントロールの機能は変更されませんが、コントロールの視覚的な動作は変更されます。  視覚的な動作とは、コントロールが特定の状態になったときの外観のことです。  コントロールの機能と視覚的な動作との違いを理解するために、ボタンの例について考えてみます。  ボタンの機能とはクリックされたときに <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを発生させることですが、ボタンの視覚的な動作とはボタンをポイントまたはクリックしたときのボタンの外観の変化のことです。  
+  
+ <xref:System.Windows.VisualState> を使用して、特定の状態のときのコントロールの外観を指定します。  <xref:System.Windows.VisualState> には、<xref:System.Windows.Controls.ControlTemplate> 内の要素の外観を変化させる <xref:System.Windows.Media.Animation.Storyboard> が含まれています。  <xref:System.Windows.VisualStateManager> を使用することで、コントロールのロジックにより状態が変化するため、この変化をコードで記述する必要はありません。  コントロールが <xref:System.Windows.VisualState.Name%2A?displayProperty=fullName> プロパティで指定された状態になると、<xref:System.Windows.Media.Animation.Storyboard> が開始されます。  コントロールがその状態から移行すると、<xref:System.Windows.Media.Animation.Storyboard> は停止します。  
+  
+ マウス ポインターをボタンの上に置いたときに <xref:System.Windows.Controls.Button> の外観を変化させる <xref:System.Windows.VisualState> の例を次に示します。  <xref:System.Windows.Media.Animation.Storyboard> によって `BorderBrush` の色が変化することで、ボタンの境界線の色が変化します。  このトピックの冒頭にある <xref:System.Windows.Controls.ControlTemplate> の例を参照すると、`BorderBrush` が <xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Border.Background%2A> に割り当てた <xref:System.Windows.Media.SolidColorBrush> の名前であることがわかります。  
+  
+ [!code-xml[VSMButtonTemplate#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/skinnedbutton.xaml#4)]  
+  
+ このコントロールで、コントロール コントラクトの一部として状態を定義します。詳細については、このトピックの「[コントロール コントラクトについて理解しその他のコントロールをカスタマイズする方法](#customizing_other_controls_by_understanding_the_control_contract)」で後述します。  次の表は、<xref:System.Windows.Controls.Button> に指定される状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+  
+ <xref:System.Windows.Controls.Button> では、2 つの状態グループが定義されています \(`Normal`、`MouseOver`、`Pressed` および `Disabled` の各状態を含む `CommonStates` グループと   `Focused` 状態および `Unfocused` 状態を含む `FocusStates` グループ\)。  同じ状態グループ内の状態を同時に複数指定することはできません。  コントロールは常に 1 グループにつき 1 つの状態になります。  たとえば、<xref:System.Windows.Controls.Button> には、マウス ポインターが置かれていないときでもフォーカスを設定できます。そのため、`Focused` 状態の <xref:System.Windows.Controls.Button> は `MouseOver`、`Pressed`、または `Normal` の状態になります。  
+  
+ <xref:System.Windows.VisualState> オブジェクトを <xref:System.Windows.VisualStateGroup> オブジェクトに追加します。  <xref:System.Windows.VisualStateGroup> オブジェクトを <xref:System.Windows.VisualStateManager.VisualStateGroups%2A?displayProperty=fullName> 添付プロパティに追加します。  次の例では、`Normal`、`MouseOver`、`Pressed` の各状態の <xref:System.Windows.VisualState> オブジェクトを定義します。これらの状態は、すべて `CommonStates` グループに属しています。  各 <xref:System.Windows.VisualState> の <xref:System.Windows.VisualState.Name%2A> は、前の表に記載された名前と一致します。  `Disabled` 状態および `FocusStates` グループの状態は、例を簡潔にするために省略していますが、このトピックの最後で紹介している完全なコード例には含まれています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.VisualStateManager.VisualStateGroups%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Controls.ControlTemplate> のルート <xref:System.Windows.FrameworkElement> に設定してください。  
+  
+ [!code-xml[VSMButtonTemplate#VisualStates](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/buttonstages.xaml#visualstates)]  
+  
+ 前の例では、次の図のような出力を生成します。  
+  
+ ![カスタム コントロール テンプレート付きのボタン](../../../../docs/framework/wpf/controls/media/ndp-buttonnormal.png "NDP\_ButtonNormal")  
+通常の状態のカスタム コントロール テンプレートを使用しているボタン  
+  
+ ![赤い境界線付きのボタン](../../../../docs/framework/wpf/controls/media/ndp-buttonmouseover.png "NDP\_ButtonMouseOver")  
+マウス オーバー状態のカスタム コントロール テンプレートを使用しているボタン  
+  
+ ![押されたボタンの透明な境界線](../../../../docs/framework/wpf/controls/media/ndp-buttonpressed.png "NDP\_ButtonPressed")  
+押された状態のカスタム コントロール テンプレートを使用しているボタン  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属するコントロールの視覚的な状態については、「[コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)」を参照してください。  
+  
+<a name="specifying_the_behavior_of_a_control_when_it_transitions_between_states"></a>   
+## 状態間を遷移するときのコントロールの動作の指定  
+ 前の例では、ボタンをクリックしたときにもボタンの外観は変化しますが、ボタンを 1 秒間押したままにしない限り変化しません。  既定では、アニメーションが開始されるまでに 1 秒かかります。  多くの場合、ユーザーがボタンをクリックして離すまでの時間はそれよりもかなり短いため、<xref:System.Windows.Controls.ControlTemplate> を既定の状態のままにしておくと視覚的フィードバックが効果的になりません。  
+  
+ アニメーションを開始するまでの時間を指定して、コントロールをある状態から別の状態に円滑に遷移させるには、<xref:System.Windows.VisualTransition> オブジェクトを <xref:System.Windows.Controls.ControlTemplate> に追加します。  <xref:System.Windows.VisualTransition> を作成する場合は、次のうちの 1 つ以上を指定します。  
+  
+-   状態間の遷移を開始するまでの時間。  
+  
+-   遷移時に発生するコントロールの外観への追加の変更。  
+  
+-   <xref:System.Windows.VisualTransition> を適用する状態。  
+  
+### 遷移の継続時間の指定  
+ <xref:System.Windows.VisualTransition.GeneratedDuration%2A> プロパティを設定すると、遷移に要する時間を指定できます。  前の例では、<xref:System.Windows.VisualState> は、ボタンを押したときにボタンの境界線が透明に変化するようになっていますが、ボタンをすばやく押して離した場合、アニメーションが開始されるまでの時間が長すぎるため認識されません。  <xref:System.Windows.VisualTransition> を使用して、コントロールが押された状態に遷移するために要する時間を指定できます。  次の例では、コントロールが押された状態に遷移するまでの時間を 1\/100 秒に指定しています。  
+  
+ [!code-xml[VSMButtonTemplate#PressedTransition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/skinnedbutton.xaml#pressedtransition)]  
+  
+### 遷移時にコントロールの外観の変更を指定する方法  
+ <xref:System.Windows.VisualTransition> には、コントロールの状態が遷移するときに開始される <xref:System.Windows.Media.Animation.Storyboard> が含まれています。  たとえば、コントロールが `MouseOver` 状態から `Normal` 状態に遷移する場合に特定のアニメーションが実行されるように指定することができます。  次の例では、ユーザーがマウス ポインターをボタンの外に移動したときに、ボタンの境界線が 1.5 秒で青色、黄色、黒の順に変化するように指定する <xref:System.Windows.VisualTransition> を作成します。  
+  
+ [!code-xml[VSMButtonTemplate#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/skinnedbutton.xaml#8)]  
+  
+### VisualTransition を適用するタイミングの指定  
+ <xref:System.Windows.VisualTransition> を特定の状態にだけ適用するように制限することも、コントロールが状態間を遷移するときに常に適用することもできます。  前の例ではコントロールが `MouseOver` 状態から `Normal` 状態に遷移したときに <xref:System.Windows.VisualTransition> が適用され、その前の例ではコントロールが `Pressed` 状態に遷移したときに <xref:System.Windows.VisualTransition> が適用されます。  <xref:System.Windows.VisualTransition.To%2A> プロパティと <xref:System.Windows.VisualTransition.From%2A> プロパティを設定すると、<xref:System.Windows.VisualTransition> を適用するタイミングを制限できます。  最も制限的なものから制限が最も少ない制限レベルについて次の表に示します。  
+  
+|制限の種類|From の値|To の値|  
+|-----------|-------------|-----------|  
+|指定した状態から別の指定した状態まで|<xref:System.Windows.VisualState> の名前|<xref:System.Windows.VisualState> の名前|  
+|任意の状態から指定した状態まで|設定しない|<xref:System.Windows.VisualState> の名前|  
+|指定した状態から任意の状態まで|<xref:System.Windows.VisualState> の名前|設定しない|  
+|任意の状態から別の任意の状態まで|設定しない|設定しない|  
+  
+ 同じ状態を参照する <xref:System.Windows.VisualStateGroup> で複数の <xref:System.Windows.VisualTransition> オブジェクトを保持できますが、それらのオブジェクトは前の表で指定した順序に従って使用されます。  次の例は、2 つの <xref:System.Windows.VisualTransition> オブジェクトを示しています。  `Pressed` 状態から `MouseOver` 状態にコントロールを遷移させる場合は、<xref:System.Windows.VisualTransition.From%2A> および <xref:System.Windows.VisualTransition.To%2A> の両方が設定されている <xref:System.Windows.VisualTransition> が使用されます。  `Pressed` 状態にない状態から `MouseOver` 状態にコントロールを遷移させる場合は、別の状態が使用されます。  
+  
+ [!code-xml[VSMButtonTemplate#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/skinnedbutton.xaml#7)]  
+  
+ <xref:System.Windows.VisualStateGroup> には、<xref:System.Windows.VisualStateGroup> の <xref:System.Windows.VisualState> オブジェクトに適用する <xref:System.Windows.VisualTransition> オブジェクトを含む <xref:System.Windows.VisualStateGroup.Transitions%2A> プロパティがあります。  <xref:System.Windows.Controls.ControlTemplate> の作成者は、自由に <xref:System.Windows.VisualTransition> を含めることができます。  ただし、<xref:System.Windows.VisualTransition.To%2A> プロパティおよび <xref:System.Windows.VisualTransition.From%2A> プロパティに設定した状態の名前が <xref:System.Windows.VisualStateGroup> に含まれていない場合、<xref:System.Windows.VisualTransition> は無視されます。  
+  
+ `CommonStates` の <xref:System.Windows.VisualStateGroup> を次の例に示します。  この例では、次のボタンの各遷移に対して <xref:System.Windows.VisualTransition> を定義しています。  
+  
+-   `Pressed` 状態への遷移。  
+  
+-   `MouseOver` 状態への遷移。  
+  
+-   `Pressed` 状態から `MouseOver` 状態への遷移。  
+  
+-   `MouseOver` 状態から `Normal` 状態への遷移。  
+  
+ [!code-xml[VSMButtonTemplate#VisualTransitions](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/buttonstages.xaml#visualtransitions)]  
+  
+<a name="customizing_other_controls_by_understanding_the_control_contract"></a>   
+## コントロール コントラクトについて理解しその他のコントロールをカスタマイズする方法  
+ <xref:System.Windows.Controls.ControlTemplate> を使用して、その視覚的な構造 \(<xref:System.Windows.FrameworkElement> オブジェクトを使用\) および視覚的な動作 \(<xref:System.Windows.VisualState> オブジェクトを使用\) を指定するコントロールでは、パーツ コントロール モデルを使用しています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 4 に含まれる多くのコントロールには、このモデルが採用されています。  <xref:System.Windows.Controls.ControlTemplate> の作成者は、コントロール コントラクトを通じて伝えられるパーツに注意する必要があります。  コントロール コントラクトのパーツについて理解すると、パーツ コントロール モデルを採用しているすべてのコントロールの外観をカスタマイズできます。  
+  
+ コントロール コントラクトには、3 つの要素があります。  
+  
+-   コントロールのロジックが使用する視覚的要素。  
+  
+-   コントロールの状態と各状態が属するグループ。  
+  
+-   コントロールに対して視覚的に作用するパブリック プロパティ。  
+  
+### コントロール コントラクトの視覚的要素  
+ コントロールのロジックは、<xref:System.Windows.Controls.ControlTemplate> 内の <xref:System.Windows.FrameworkElement> と対話することがあります。  たとえば、コントロールによる要素のイベント処理が考えられます。  コントロールは、<xref:System.Windows.Controls.ControlTemplate> から特定の <xref:System.Windows.FrameworkElement> を探すとき、その情報を <xref:System.Windows.Controls.ControlTemplate> の作成者に伝達します。  探している要素の型および名前を伝達する手段として、コントロールは <xref:System.Windows.TemplatePartAttribute> を使用します。  <xref:System.Windows.Controls.Button> のコントロール コントラクト内に <xref:System.Windows.FrameworkElement> パーツはありませんが、<xref:System.Windows.Controls.ComboBox> などの他のコントロールにはあります。  
+  
+ <xref:System.Windows.Controls.ComboBox> クラスで指定する <xref:System.Windows.TemplatePartAttribute> オブジェクトを次の例に示します。  <xref:System.Windows.Controls.ComboBox> のロジックは、<xref:System.Windows.Controls.ControlTemplate> 内で `PART_EditableTextBox` という名前の <xref:System.Windows.Controls.TextBox> および `PART_Popup` という名前の <xref:System.Windows.Controls.Primitives.Popup> を探します。  
+  
+ [!code-csharp[VSMButtonTemplate#ComboBoxContract](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/controlcontracts.cs#comboboxcontract)]
+ [!code-vb[VSMButtonTemplate#ComboBoxContract](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmbuttontemplate/visualbasic/window1.xaml.vb#comboboxcontract)]  
+  
+ <xref:System.Windows.Controls.ComboBox> クラスの <xref:System.Windows.TemplatePartAttribute> オブジェクトによって指定された要素を含む、<xref:System.Windows.Controls.ComboBox> の簡略化した <xref:System.Windows.Controls.ControlTemplate> を次の例に示します。  
+  
+ [!code-xml[VSMButtonTemplate#ComboBoxTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/window1.xaml#comboboxtemplate)]  
+  
+### コントロール コントラクトの状態  
+ コントロールの状態もコントロール コントラクトの一部です。  <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ControlTemplate> を作成する例では、<xref:System.Windows.Controls.Button> の状態に応じて外観を指定する方法を示しています。  指定したそれぞれの状態に対して <xref:System.Windows.VisualState> を作成し、<xref:System.Windows.TemplateVisualStateAttribute.GroupName%2A> を共有するすべての <xref:System.Windows.VisualState> オブジェクトを、このトピックの「[状態に応じたコントロールの外観の変化](#changing_the_appearance_of_a_control_depending_on_its_state)」で説明したように <xref:System.Windows.VisualStateGroup> に配置します。  サードパーティ コントロールは <xref:System.Windows.TemplateVisualStateAttribute>のコントロール テンプレート作成のためにコントロールの状態を公開することをデザイナーのツールが、 Expression Blend など、使用する使用して状態を指定する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属するコントロールのコントロール コントラクトについては、「[コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)」を参照してください。  
+  
+### コントロール コントラクトのプロパティ  
+ コントロールに視覚的な影響を与えるパブリック プロパティもコントロール コントラクトに含まれています。  これらのプロパティを設定すると、<xref:System.Windows.Controls.ControlTemplate> を新たに作成せずに、コントロールの外観を変更できます。  また、[TemplateBinding](../../../../docs/framework/wpf/advanced/templatebinding-markup-extension.md) のマークアップ拡張機能を使用して、<xref:System.Windows.Controls.ControlTemplate> 内の要素のプロパティを、<xref:System.Windows.Controls.Button> によって定義されたパブリック プロパティにバインドすることもできます。  
+  
+ 次の例では、ボタンのコントロール コントラクトを示します。  
+  
+ [!code-csharp[VSMButtonTemplate#ButtonContract](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/controlcontracts.cs#buttoncontract)]
+ [!code-vb[VSMButtonTemplate#ButtonContract](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/vsmbuttontemplate/visualbasic/window1.xaml.vb#buttoncontract)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> を作成する場合は、既存の <xref:System.Windows.Controls.ControlTemplate> を利用して、変更を加える方が簡単です。  次のいずれかの方法で、既存の <xref:System.Windows.Controls.ControlTemplate> を変更できます。  
+  
+-   Expression Blend などのデザイナーを使用します。デザイナーには、コントロール テンプレートを作成するためのグラフィカル ユーザー インターフェイスが用意されています。  詳細については、「[テンプレートをサポートするコントロールのスタイル処理](http://go.microsoft.com/fwlink/?LinkId=161153)」を参照してください。  
+  
+-   既定の <xref:System.Windows.Controls.ControlTemplate> を取得して、編集します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に付属する既定のコントロール テンプレートについては、[既定の WPF テーマ](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+<a name="complete_example"></a>   
+## コード例全体  
+ 次に示す例は、このトピックで説明した <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ControlTemplate> の完全版です。  
+  
+ [!code-xml[VSMButtonTemplate#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/vsmbuttontemplate/csharp/skinnedbutton.xaml#3)]  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/datagrid-styles-and-templates.md b/docs/framework/wpf/controls/datagrid-styles-and-templates.md
new file mode 100644
index 00000000000..14c28c906f5
--- /dev/null
+++ b/docs/framework/wpf/controls/datagrid-styles-and-templates.md
@@ -0,0 +1,195 @@
+---
+title: "DataGrid のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], DataGrid"
+  - "DataGrid [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], DataGrid"
+  - "状態 [WPF], DataGrid"
+  - "スタイル [WPF], DataGrid"
+  - "テンプレート [WPF], DataGrid"
+ms.assetid: 9cb31d63-f148-4d25-b079-816e73f988c7
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# DataGrid のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.DataGrid> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## DataGrid のパーツ  
+ 次の表は、<xref:System.Windows.Controls.DataGrid> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ColumnHeadersPresenter|<xref:System.Windows.Controls.Primitives.DataGridColumnHeadersPresenter>|列ヘッダーが含まれる行。|  
+  
+ <xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.DataGrid> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+ <xref:System.Windows.Controls.DataGrid> の既定のテンプレートには、<xref:System.Windows.Controls.ScrollViewer> コントロールが含まれています。  <xref:System.Windows.Controls.ScrollViewer> で定義されたパーツの詳細については、「[ScrollViewer のスタイルとテンプレート](../../../../docs/framework/wpf/controls/scrollviewer-styles-and-templates.md)」を参照してください。  
+  
+## DataGrid の状態  
+ 次の表は、<xref:System.Windows.Controls.DataGrid> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|InvalidFocused|ValidationStates|コントロールは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|コントロールは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|コントロールが有効です。|  
+  
+## DataGridCell のパーツ  
+ <xref:System.Windows.Controls.DataGridCell> 要素には、名前付きのパーツは存在しません。  
+  
+## DataGridCell の状態  
+ 次の表は、<xref:System.Windows.Controls.DataGridCell> 要素の表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターは、セルの上に置かれています。|  
+|Focused|FocusStates|セルにフォーカスがあります。|  
+|Unfocused|FocusStates|セルにフォーカスがありません。|  
+|Current|CurrentStates|セルは現在のセルです。|  
+|Regular|CurrentStates|セルは現在のセルではありません。|  
+|表示|InteractionStates|セルは表示モードです。|  
+|編集|InteractionStates|セルは編集モードです。|  
+|Selected|SelectionStates|セルが選択されています。|  
+|Unselected|SelectionStates|セルは選択されていません。|  
+|InvalidFocused|ValidationStates|セルは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|セルは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|セルは有効です。|  
+  
+## DataGridRow のパーツ  
+ <xref:System.Windows.Controls.DataGridRow> 要素には、名前付きのパーツは存在しません。  
+  
+## DataGridRow の状態  
+ 次の表は、<xref:System.Windows.Controls.DataGridRow> 要素の表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターは、行の上に置かれています。|  
+|MouseOver\_Editing|CommonStates|マウス ポインターは行の上に置かれ、行は編集モードです。|  
+|MouseOver\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行が選択されています。|  
+|MouseOver\_Unfocused\_Editing|CommonStates|マウス ポインターは行の上に置かれ、行は編集モードで、フォーカスはありません。|  
+|MouseOver\_Unfocused\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行が選択され、フォーカスはありません。|  
+|Normal\_AlternatingRow|CommonStates|行は交互の行です。|  
+|Normal\_Editing|CommonStates|行は編集モードです。|  
+|Normal\_Selected|CommonStates|行が選択されています。|  
+|Unfocused\_Editing|CommonStates|行は編集モードで、フォーカスはありません。|  
+|Unfocused\_Selected|CommonStates|行が選択され、フォーカスはありません。|  
+|InvalidFocused|ValidationStates|コントロールは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|コントロールは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|コントロールが有効です。|  
+  
+## DataGridRowHeader のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridRowHeader> 要素の名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_TopHeaderGripper|<xref:System.Windows.Controls.Primitives.Thumb>|行ヘッダーのサイズを上端から変更する場合に使用する要素です。|  
+|PART\_BottomHeaderGripper|<xref:System.Windows.Controls.Primitives.Thumb>|行ヘッダーのサイズを下端から変更する場合に使用する要素です。|  
+  
+## DataGridRowHeader の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridRowHeader> 要素の表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターは、行の上に置かれています。|  
+|MouseOver\_CurrentRow|CommonStates|マウス ポインターは行の上に置かれ、行は現在の行です。|  
+|MouseOver\_CurrentRow\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行は現在の行で、選択されています。|  
+|MouseOver\_EditingRow|CommonStates|マウス ポインターは行の上に置かれ、行は編集モードです。|  
+|MouseOver\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行が選択されています。|  
+|MouseOver\_Unfocused\_CurrentRow\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行は現在の行で、選択され、フォーカスはありません。|  
+|MouseOver\_Unfocused\_EditingRow|CommonStates|マウス ポインターは行の上に置かれ、行は編集モードで、フォーカスはありません。|  
+|MouseOver\_Unfocused\_Selected|CommonStates|マウス ポインターは行の上に置かれ、行が選択され、フォーカスはありません。|  
+|Normal\_CurrentRow|CommonStates|行は現在の行です。|  
+|Normal\_CurrentRow\_Selected|CommonStates|行は現在の行で、選択されています。|  
+|Normal\_EditingRow|CommonStates|行は編集モードです。|  
+|Normal\_Selected|CommonStates|行が選択されています。|  
+|Unfocused\_CurrentRow\_Selected|CommonStates|行は現在の行で、選択され、フォーカスはありません。|  
+|Unfocused\_EditingRow|CommonStates|行は編集モードで、フォーカスはありません。|  
+|Unfocused\_Selected|CommonStates|行が選択され、フォーカスはありません。|  
+|InvalidFocused|ValidationStates|コントロールは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|コントロールは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|コントロールが有効です。|  
+  
+## DataGridColumnHeadersPresenter のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridColumnHeadersPresenter> 要素の名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_FillerColumnHeader|<xref:System.Windows.Controls.Primitives.DataGridColumnHeader>|列ヘッダーのプレースホルダーです。|  
+  
+## DataGridColumnHeadersPresenter の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridColumnHeadersPresenter> 要素の表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|InvalidFocused|ValidationStates|セルは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|セルは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|セルは有効です。|  
+  
+## DataGridColumnHeader のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridColumnHeader> 要素の名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_LeftHeaderGripper|<xref:System.Windows.Controls.Primitives.Thumb>|列ヘッダーのサイズを左端から変更する場合に使用する要素です。|  
+|PART\_RightHeaderGripper|<xref:System.Windows.Controls.Primitives.Thumb>|列ヘッダーのサイズを右端から変更する場合に使用する要素です。|  
+  
+## DataGridColumnHeader の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DataGridColumnHeader> 要素の表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|SortAscending|SortStates|列は昇順に並べ替えられます。|  
+|SortDescending|SortStates|列は降順に並べ替えられます。|  
+|Unsorted|SortStates|列は並べ替えられません。|  
+|InvalidFocused|ValidationStates|コントロールは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|コントロールは有効ではなく、フォーカスはありません。|  
+|Valid|ValidationStates|コントロールが有効です。|  
+  
+## DataGrid ControlTemplate の例  
+ <xref:System.Windows.Controls.DataGrid> コントロールの <xref:System.Windows.Controls.ControlTemplate> およびその関連付けられた型を定義する方法を次の例に示します。  
+  
+ [!code-xml[ControlTemplateExamples#DataGrid](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/datagrid.xaml#datagrid)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/datagrid.md b/docs/framework/wpf/controls/datagrid.md
new file mode 100644
index 00000000000..94dafcd2d86
--- /dev/null
+++ b/docs/framework/wpf/controls/datagrid.md
@@ -0,0 +1,72 @@
+---
+title: "DataGrid | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], DataGrid"
+  - "DataGrid [WPF], 一般的なタスク"
+  - "DataGrid [WPF], カスタマイズ (外観を)"
+  - "DataGrid の列型 [WPF]"
+  - "DataGrid の列 [WPF], 使用"
+  - "DataGrid コントロール [WPF]"
+  - "DataGrid のシナリオ [WPF]"
+ms.assetid: bf89ea63-79b6-422b-bc9f-0485ad803216
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# DataGrid
+<xref:System.Windows.Controls.DataGrid> コントロールでは、SQL データベース、LINQ クエリ、バインドできる他のデータ ソースなどのさまざまなソースのデータを表示および編集できます。  詳細については、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」を参照してください。  
+  
+ 列には、テキスト、<xref:System.Windows.Controls.ComboBox> などのコントロール、イメージやボタンなどのその他の WPF コンテンツ、またはテンプレートに格納されるコンテンツを表示できます。  <xref:System.Windows.Controls.DataGridTemplateColumn> を使用して、テンプレートに定義されたデータを表示できます。  既定で提供される列の型を次の表に示します。  
+  
+|生成された列の型|\[データ型\]|  
+|--------------|--------------|  
+|<xref:System.Windows.Controls.DataGridTextColumn>|<xref:System.String>|  
+|<xref:System.Windows.Controls.DataGridCheckBoxColumn>|<xref:System.Boolean>|  
+|<xref:System.Windows.Controls.DataGridComboBoxColumn>|<xref:System.Enum>|  
+|<xref:System.Windows.Controls.DataGridHyperlinkColumn>|<xref:System.Uri>|  
+  
+ <xref:System.Windows.Controls.DataGrid> では、セルのフォント、色、サイズなどの表示形式をカスタマイズできます。  <xref:System.Windows.Controls.DataGrid> では、他の WPF コントロールのスタイルとテンプレート機能のすべてをサポートしています。  <xref:System.Windows.Controls.DataGrid> には、編集、並べ替え、および検証に関する、既定の動作とカスタマイズできる動作も用意されています。  
+  
+ 次の表に、<xref:System.Windows.Controls.DataGrid> に共通のタスクの一部と、それらの実行方法を示します。  関連する API を表示することによって、詳細やサンプル コードを参照できます。  
+  
+|シナリオ|方法|  
+|----------|--------|  
+|背景色の変更|<xref:System.Windows.Controls.ItemsControl.AlternationIndex%2A> プロパティを 2 以上に設定し、<xref:System.Windows.Media.Brush> を <xref:System.Windows.Controls.DataGrid.RowBackground%2A> および <xref:System.Windows.Controls.DataGrid.AlternatingRowBackground%2A> プロパティに割り当てます。|  
+|セルと行の選択動作の定義|<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> プロパティおよび <xref:System.Windows.Controls.DataGrid.SelectionUnit%2A> プロパティを設定します。|  
+|ヘッダー、セル、および行の視覚的な外観のカスタマイズ|新しい <xref:System.Windows.Style> を <xref:System.Windows.Controls.DataGrid.ColumnHeaderStyle%2A>、<xref:System.Windows.Controls.DataGrid.RowHeaderStyle%2A>、<xref:System.Windows.Controls.DataGrid.CellStyle%2A>、または <xref:System.Windows.Controls.DataGrid.RowStyle%2A> プロパティに適用します。|  
+|サイズ変更オプションの設定|<xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.MaxHeight%2A>、<xref:System.Windows.FrameworkElement.MinHeight%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、<xref:System.Windows.FrameworkElement.MaxWidth%2A>、または <xref:System.Windows.FrameworkElement.MinWidth%2A> の各プロパティを設定します。  詳細については、「[DataGrid コントロールのサイズ変更方法](../../../../docs/framework/wpf/controls/sizing-options-in-the-datagrid-control.md)」を参照してください。|  
+|選択されたアイテムへのアクセス|選択されたセルを取得するには <xref:System.Windows.Controls.DataGrid.SelectedCells%2A> プロパティをチェックし、選択された行を取得するには <xref:System.Windows.Controls.Primitives.MultiSelector.SelectedItems%2A> プロパティをチェックします。  詳細については、<xref:System.Windows.Controls.DataGrid.SelectedCells%2A> を参照してください。|  
+|エンド ユーザーとの対話をカスタマイズ|<xref:System.Windows.Controls.DataGrid.CanUserAddRows%2A> プロパティ、<xref:System.Windows.Controls.DataGrid.CanUserDeleteRows%2A> プロパティ、<xref:System.Windows.Controls.DataGrid.CanUserReorderColumns%2A> プロパティ、<xref:System.Windows.Controls.DataGrid.CanUserResizeColumns%2A> プロパティ、<xref:System.Windows.Controls.DataGrid.CanUserResizeRows%2A> プロパティおよび <xref:System.Windows.Controls.DataGrid.CanUserSortColumns%2A> プロパティを設定します。|  
+|自動生成された列のキャンセルまたは変更|<xref:System.Windows.Controls.DataGrid.AutoGeneratingColumn> イベントを処理します。|  
+|列の固定|<xref:System.Windows.Controls.DataGrid.FrozenColumnCount%2A> プロパティを 1 に設定し、<xref:System.Windows.Controls.DataGridColumn.DisplayIndex%2A> プロパティを 0 に設定することによって列を左端の位置に移動します。|  
+|データ ソースとしての XML データの使用|<xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> を、項目のコレクションを表す XPath クエリにバインドします。  <xref:System.Windows.Controls.DataGrid> に各列を作成します。  バインディングの XPath を、項目のソースのプロパティを取得するクエリに設定することによって各列をバインドします。  例については、「<xref:System.Windows.Controls.DataGridTextColumn>」を参照してください。|  
+  
+## 関連トピック  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[チュートリアル: DataGrid コントロールで SQL Server データベースのデータを表示する](../../../../docs/framework/wpf/controls/walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md)|新しい WPF プロジェクトを設定し、Entity Framework の要素を追加し、ソースを設定し、<xref:System.Windows.Controls.DataGrid> にデータを表示する方法について説明します。|  
+|[方法: DataGrid コントロールに行の詳細を追加する](../../../../docs/framework/wpf/controls/how-to-add-row-details-to-a-datagrid-control.md)|<xref:System.Windows.Controls.DataGrid> の行の詳細を作成する方法について説明します。|  
+|[方法: DataGrid コントロールを使用して検証を実装する](../../../../docs/framework/wpf/controls/how-to-implement-validation-with-the-datagrid-control.md)|<xref:System.Windows.Controls.DataGrid> のセルと行の値を検証し、検証フィードバックを表示する方法について説明します。|  
+|[DataGrid コントロールの既定のキーボード動作とマウス動作](../../../../docs/framework/wpf/controls/default-keyboard-and-mouse-behavior-in-the-datagrid-control.md)|キーボードとマウスを使用して <xref:System.Windows.Controls.DataGrid> コントロールと対話する方法について説明します。|  
+|[方法: DataGrid コントロールでデータをグループ化、並べ替え、およびフィルター処理する](../../../../docs/framework/wpf/controls/how-to-group-sort-and-filter-data-in-the-datagrid-control.md)|グループ化、並べ替え、フィルターなどを適用することによって、さまざまな角度から <xref:System.Windows.Controls.DataGrid> でデータを表示する方法について説明します。|  
+|[DataGrid コントロールのサイズ変更方法](../../../../docs/framework/wpf/controls/sizing-options-in-the-datagrid-control.md)|<xref:System.Windows.Controls.DataGrid> での絶対サイズ設定および自動サイズ設定を制御する方法について説明します。|  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataGrid>   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)   
+ [WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/datepicker-syles-and-templates.md b/docs/framework/wpf/controls/datepicker-syles-and-templates.md
new file mode 100644
index 00000000000..3cd878f3410
--- /dev/null
+++ b/docs/framework/wpf/controls/datepicker-syles-and-templates.md
@@ -0,0 +1,96 @@
+---
+title: "DatePicker のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], DatePicker"
+  - "DatePicker [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], DatePicker"
+  - "状態 [WPF], DatePicker"
+  - "スタイル [WPF], DatePicker"
+  - "テンプレート [WPF], DatePicker"
+ms.assetid: c430a657-692f-44bd-a549-2341f92d6115
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# DatePicker のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.DatePicker> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## DatePicker のパーツ  
+ 次の表は、<xref:System.Windows.Controls.DatePicker> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Root|<xref:System.Windows.Controls.Grid>|コントロールのルートです。|  
+|PART\_Button|<xref:System.Windows.Controls.Button>|<xref:System.Windows.Controls.Calendar> を開いたり閉じたりするボタンです。|  
+|PART\_TextBox|<xref:System.Windows.Controls.Primitives.DatePickerTextBox>|日付を入力できるテキスト ボックスです。|  
+|PART\_Popup|<xref:System.Windows.Controls.Primitives.Popup>|<xref:System.Windows.Controls.DatePicker> コントロールのポップアップです。|  
+  
+## DatePicker の状態  
+ 次の表は、<xref:System.Windows.Controls.DatePicker> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|<xref:System.Windows.Controls.DatePicker> が無効になっています。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## DatePickerTextBox のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DatePickerTextBox> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Watermark|<xref:System.Windows.Controls.ContentControl>|<xref:System.Windows.Controls.DatePicker> の初期化テキストを格納する要素です。|  
+|PART\_ContentElement|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.FrameworkElement> 要素を含むことができるビジュアル要素です。  <xref:System.Windows.Controls.TextBox> のテキストは、この要素内に表示されます。|  
+  
+## DatePickerTextBox の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.DatePickerTextBox> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|<xref:System.Windows.Controls.Primitives.DatePickerTextBox> が無効になっています。|  
+|MouseOver|CommonStates|マウス ポインターは、<xref:System.Windows.Controls.Primitives.DatePickerTextBox> の上に置かれています。|  
+|ReadOnly|CommonStates|ユーザーは、<xref:System.Windows.Controls.Primitives.DatePickerTextBox> 内のテキストを変更できません。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Watermarked|WatermarkStates|コントロールに初期化テキストが表示されます。  ユーザーがテキストを入力していないか日付を選択していないときの <xref:System.Windows.Controls.Primitives.DatePickerTextBox> の状態です。|  
+|Unwatermarked|WatermarkStates|ユーザーが <xref:System.Windows.Controls.Primitives.DatePickerTextBox> にテキストを入力したか、<xref:System.Windows.Controls.DatePicker> で日付を選択しました。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## DatePicker ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.DatePicker> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#DatePicker](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/datepicker.xaml#datepicker)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/datepicker.md b/docs/framework/wpf/controls/datepicker.md
new file mode 100644
index 00000000000..7fc58d1caad
--- /dev/null
+++ b/docs/framework/wpf/controls/datepicker.md
@@ -0,0 +1,36 @@
+---
+title: "DatePicker | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], DatePicker"
+  - "DatePicker コントロール [WPF]"
+ms.assetid: 619765c8-8d25-4315-aec2-79aea08fed9f
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# DatePicker
+<xref:System.Windows.Controls.DatePicker> コントロールを使用すると、ユーザーはテキスト フィールドに入力することによって、またはドロップダウン形式の <xref:System.Windows.Controls.Calendar> コントロールを使用して、日付を選択できます。  
+  
+ 次の図は、<xref:System.Windows.Controls.DatePicker> を示しています。  
+  
+ ![DatePicker コントロール](../../../../docs/framework/wpf/controls/media/ndp-datepicker.png "NDP\_DatePicker")  
+DatePicker コントロール  
+  
+ <xref:System.Windows.Controls.DatePicker> コントロールのプロパティの多くはその組み込み <xref:System.Windows.Controls.Calendar> を管理するためのものであり、<xref:System.Windows.Controls.Calendar> の相当するプロパティと同じように機能します。  特に、<xref:System.Windows.Controls.DatePicker.IsTodayHighlighted%2A?displayProperty=fullName>、<xref:System.Windows.Controls.DatePicker.FirstDayOfWeek%2A?displayProperty=fullName>、<xref:System.Windows.Controls.DatePicker.BlackoutDates%2A?displayProperty=fullName>、<xref:System.Windows.Controls.DatePicker.DisplayDateStart%2A?displayProperty=fullName>、<xref:System.Windows.Controls.DatePicker.DisplayDateEnd%2A?displayProperty=fullName>、<xref:System.Windows.Controls.DatePicker.DisplayDate%2A?displayProperty=fullName>、および <xref:System.Windows.Controls.DatePicker.SelectedDate%2A?displayProperty=fullName> の各プロパティは、<xref:System.Windows.Controls.Calendar> の対応するプロパティと同じように機能します。  詳細については、「<xref:System.Windows.Controls.Calendar>」を参照してください。  
+  
+ ユーザーは、テキスト フィールドに日付を直接入力することもできます。これによって、<xref:System.Windows.Controls.DatePicker.Text%2A> プロパティが設定されます。  <xref:System.Windows.Controls.DatePicker> が、入力された文字列を有効な日付に変換できない場合は、<xref:System.Windows.Controls.DatePicker.DateValidationError> イベントが発生します。  既定では例外が発生しますが、<xref:System.Windows.Controls.DatePicker.DateValidationError> のイベント ハンドラーで <xref:System.Windows.Controls.DatePickerDateValidationErrorEventArgs.ThrowException%2A> プロパティを `false` に設定すると、例外の発生を回避できます。  
+  
+## 参照  
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/default-keyboard-and-mouse-behavior-in-the-datagrid-control.md b/docs/framework/wpf/controls/default-keyboard-and-mouse-behavior-in-the-datagrid-control.md
new file mode 100644
index 00000000000..7c73c9b4de5
--- /dev/null
+++ b/docs/framework/wpf/controls/default-keyboard-and-mouse-behavior-in-the-datagrid-control.md
@@ -0,0 +1,108 @@
+---
+title: "DataGrid コントロールの既定のキーボード動作とマウス動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataGrid [WPF], キーボード動作"
+  - "DataGrid [WPF], マウスの動作"
+  - "キーボード動作 [WPF], DataGrid"
+  - "マウスの動作 [WPF], DataGrid"
+ms.assetid: 563b8854-ca39-4d97-8235-17eaa0f93c8d
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# DataGrid コントロールの既定のキーボード動作とマウス動作
+このトピックでは、ユーザーがキーボードとマウスを使用して <xref:System.Windows.Controls.DataGrid> コントロールと対話する方法について説明します。  
+  
+ <xref:System.Windows.Controls.DataGrid> に対する標準的な対話操作には、ナビゲーション、選択、編集などがあります。  選択動作は、<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> プロパティおよび <xref:System.Windows.Controls.DataGrid.SelectionUnit%2A> プロパティの影響を受けます。  このトピックで説明した動作の前提となる既定値は、<xref:System.Windows.Controls.DataGridSelectionMode?displayProperty=fullName> および <xref:System.Windows.Controls.DataGridSelectionUnit?displayProperty=fullName> です。  これらの値を変更すると、ここでの説明内容とは動作が異なる場合があります。  セルが編集モードになっている場合、<xref:System.Windows.Controls.DataGrid> の標準キーボードの動作は、編集コントロールによってオーバーライドされます。  
+  
+## キーボードの既定の動作  
+ <xref:System.Windows.Controls.DataGrid> におけるキーボードの既定の動作を次の表に示します。  
+  
+|キーまたはキーの組み合わせ|Description|  
+|-------------------|-----------------|  
+|↓|現在のセルの 1 つ下のセルにフォーカスを移動します。  フォーカスが最後の行にある場合は、何も行いません。|  
+|↑|現在のセルの 1 つ上のセルにフォーカスを移動します。  フォーカスが最初の行にある場合は、何も行いません。|  
+|←|同じ行の 1 つ前のセルにフォーカスを移動します。  フォーカスが行の最初のセルにある場合は、何も行いません。|  
+|→|同じ行の次のセルにフォーカスを移動します。  フォーカスが行の最後のセルにある場合は、何も行いません。|  
+|Home|現在の行の最初のセルにフォーカスを移動します。|  
+|End|現在の行の最後のセルにフォーカスを移動します。|  
+|PageDown|行がグループ化されていない場合、完全に表示されている行数分、コントロールを下にスクロールします。  完全に表示されている最後の行にフォーカスを移動します。列は変更しません。<br /><br /> 行がグループ化されている場合、<xref:System.Windows.Controls.DataGrid> 内の最後の行にフォーカスを移動します。列は変更されません。|  
+|PageUp|行がグループ化されていない場合、完全に表示されている行数分、コントロールを上にスクロールします。  現在表示されている最初の行にフォーカスを移動します。列は変更しません。<br /><br /> 行がグループ化されている場合、<xref:System.Windows.Controls.DataGrid> 内の先頭の行にフォーカスを移動します。列は変更されません。|  
+|Tab|現在の行の次のセルにフォーカスを移動します。  行の最後のセルにフォーカスがあるときは、次の行の最初のセルにフォーカスを移動します。  コントロールの最後のセルにフォーカスがあるときは、親コンテナーのタブ オーダーで次のコントロールにフォーカスを移動します。<br /><br /> 現在のセルが編集モードになっている場合、Tab キーを押すと、フォーカスが現在の行から移動します。その行に対して行われた変更は、フォーカスが変わる前にコミットされます。|  
+|Shift \+ Tab|現在の行の前のセルにフォーカスを移動します。  行の最初のセルにフォーカスがあるときは、1 つ前の行の最後のセルにフォーカスを移動します。  コントロールの最初のセルにフォーカスがある場合は、親コンテナーのタブ オーダーで 1 つ前のコントロールにフォーカスを移動します。<br /><br /> 現在のセルが編集モードになっている場合、Tab キーを押すと、フォーカスが現在の行から移動します。その行に対して行われた変更は、フォーカスが変わる前にコミットされます。|  
+|Ctrl \+ ↓|現在の列の最後のセルにフォーカスを移動します。|  
+|Ctrl \+ ↑|現在の列の最初のセルにフォーカスを移動します。|  
+|Ctrl \+ →|現在の行の最後のセルにフォーカスを移動します。|  
+|Ctrl \+ ←|現在の行の最初のセルにフォーカスを移動します。|  
+|Ctrl \+ Home|コントロール内の最初のセルにフォーカスを移動します。|  
+|Ctrl \+ End|コントロール内の最後のセルにフォーカスを移動します。|  
+|Ctrl \+ PageDown|PageDown と同じです。|  
+|Ctrl \+ PageUp|PageUp と同じです。|  
+|F2|<xref:System.Windows.Controls.DataGrid.IsReadOnly%2A?displayProperty=fullName> プロパティが `false` で、現在の列の <xref:System.Windows.Controls.DataGridColumn.IsReadOnly%2A?displayProperty=fullName> プロパティが `false` の場合、現在のセルを編集モードに設定します。|  
+|Enter|現在のセルおよび行への変更をコミットし、現在のセルの 1 つ下のセルにフォーカスを移動します。  フォーカスが最後の行にある場合は、変更をコミットし、フォーカスは移動しません。|  
+|Esc|コントロールが編集モードの場合は、編集を取り消し、コントロール内で行われた変更をすべて元に戻します。  基になるデータ ソースに <xref:System.ComponentModel.IEditableObject> が実装されている場合、Esc キーを 2 回押すと、行全体の編集モードが取り消されます。|  
+|BackSpace|セルを編集するときに、カーソル位置の前にある文字を削除します。|  
+|Del|セルを編集するときに、カーソル位置の後にある文字を削除します。|  
+|Ctrl \+ Enter|現在のセルに対して行われた変更をコミットします。フォーカスは移動しません。|  
+|Ctrl \+ A|<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> が <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合、<xref:System.Windows.Controls.DataGrid> 内のすべての行を選択します。|  
+  
+## 選択キー  
+ <xref:System.Windows.Controls.DataGrid.SelectionMode%2A> プロパティが <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合は、移動動作は変更されません。ただし、Shift \(Ctrl \+ Shift を含む\) キーを押しながらキーボードを使用する移動では、複数行の選択範囲が変更されます。  移動を開始する前に、コントロールは現在の行をアンカー行としてマークします。  Shift キーを押しながら移動すると、アンカー行と現在の行の間のすべての行が選択範囲に含められます。  
+  
+ 次の選択キーでは、複数行の選択範囲が変更されます。  
+  
+-   Shift \+ ↓  
+  
+-   Shift \+ ↑  
+  
+-   Shift \+ PageDown  
+  
+-   Shift \+ PageUp  
+  
+-   Ctrl \+ Shift \+ ↓  
+  
+-   Ctrl \+ Shift \+ ↑  
+  
+-   Ctrl \+ Shift \+ Home  
+  
+-   Ctrl \+ Shift \+ End  
+  
+## マウスの既定の動作  
+ <xref:System.Windows.Controls.DataGrid> におけるマウスの既定の動作を次の表に示します。  
+  
+|マウス操作|Description|  
+|-----------|-----------------|  
+|未選択の行をクリック|クリックした行が現在の行になり、クリックしたセルが現在のセルになります。|  
+|現在のセルをクリック|現在のセルを編集モードにします。|  
+|列ヘッダー セルをドラッグ|<xref:System.Windows.Controls.DataGrid.CanUserReorderColumns%2A?displayProperty=fullName> プロパティが `true` で、現在の列の <xref:System.Windows.Controls.DataGridColumn.CanUserReorder%2A?displayProperty=fullName> プロパティが `true` の場合、列を移動して別の位置にドロップできます。|  
+|列ヘッダーの区切りをドラッグ|<xref:System.Windows.Controls.DataGrid.CanUserResizeColumns%2A?displayProperty=fullName> プロパティが `true` で、現在の列の <xref:System.Windows.Controls.DataGridColumn.CanUserResize%2A?displayProperty=fullName> プロパティが `true` の場合、列のサイズが変更されます。|  
+|列ヘッダーの区切りをダブルクリック|現在の列の <xref:System.Windows.Controls.DataGrid.CanUserResizeColumns%2A?displayProperty=fullName> プロパティが `true` で、<xref:System.Windows.Controls.DataGridColumn.CanUserResize%2A?displayProperty=fullName> プロパティが `true` である場合、<xref:System.Windows.Controls.DataGridLength.Auto%2A> サイズ変更モードを使用して列のサイズを自動調整します。|  
+|列ヘッダー セルをクリック|<xref:System.Windows.Controls.DataGrid.CanUserSortColumns%2A?displayProperty=fullName> プロパティが `true` で、現在の列の <xref:System.Windows.Controls.DataGridColumn.CanUserSort%2A?displayProperty=fullName> プロパティが `true` の場合、列の並べ替えが実行されます。<br /><br /> 既に並べ替えられた列のヘッダーをクリックすると、逆順で並べ替えが行われます。<br /><br /> Shift キーを押しながら複数の列ヘッダーをクリックすると、クリックした順番で、複数の列に基づいて並べ替えが適用されます。|  
+|Ctrl キーを押しながら行をクリック|<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> が <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合、不連続の複数の行を選択できます。<br /><br /> 既に行が選択されている場合、行の選択を解除します。|  
+|Shift キーを押しながら行をクリック|<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> が <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合、連続する複数の行を選択できます。|  
+|行グループ ヘッダーをクリック|グループの展開または折りたたみを行います。|  
+|<xref:System.Windows.Controls.DataGrid> の左上隅の \[すべて選択\] ボタンをクリック|<xref:System.Windows.Controls.DataGrid.SelectionMode%2A> が <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合、<xref:System.Windows.Controls.DataGrid> 内のすべての行を選択します。|  
+  
+## マウスによる選択  
+ <xref:System.Windows.Controls.DataGrid.SelectionMode%2A> プロパティが <xref:System.Windows.Controls.DataGridSelectionMode> に設定されている場合、Ctrl キーまたは Shift キーを押しながら行をクリックすると複数行の選択範囲が変更されます。  
+  
+ Ctrl キーを押しながら行をクリックすると、その行の選択状態は変化しますが、その他のすべての行は現在の選択状態を保持します。  隣接しない行を選択するにはこの方法を使用します。  
+  
+ Shift キーを押しながら特定の行をクリックした場合、現在の行とアンカー行 \(クリックの前に選択されていた行\) の間のすべての行が選択されます。  それ以降、Shift キーを押しながらクリックすると、現在の行は変更されますが、アンカー行は変更されません。  隣接する行の範囲を選択するにはこの方法を使用します。  
+  
+ Ctrl キーを押しながら Shift キーを押すと、離れて存在する隣接行範囲を選択できます。  そのためには、前の説明に従い、Shift キーを押しながらのクリック操作で、1 つ目の範囲を選択します。  1 つ目の行範囲を選択したら、Ctrl キーを押しながらのクリック操作で、次の範囲内の先頭行をまず選択し、Ctrl キーと Shift キーを押した状態で、その範囲の最後の行をクリックします。  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataGrid>   
+ <xref:System.Windows.Controls.DataGrid.SelectionMode%2A>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/dockpanel-how-to-topics.md b/docs/framework/wpf/controls/dockpanel-how-to-topics.md
new file mode 100644
index 00000000000..c6bc25065d4
--- /dev/null
+++ b/docs/framework/wpf/controls/dockpanel-how-to-topics.md
@@ -0,0 +1,52 @@
+---
+title: "DockPanel に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, DockPanel"
+  - "DockPanel コントロール [WPF], 方法トピック"
+ms.assetid: 62544800-db6a-4124-8cb0-ed9bc4a90901
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# DockPanel に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.DockPanel> 要素を使用して、レイアウト コンテナーの端に沿って子要素を配置する方法について説明します。  
+  
+## このセクションの内容  
+ [Dock の値を取得または設定する](../../../../docs/framework/wpf/controls/how-to-get-or-set-a-dock-value.md)  
+ [DockPanel を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-dockpanel.md)  
+ [DockPanel 要素を使用して領域を分割する](../../../../docs/framework/wpf/controls/how-to-partition-space-by-using-the-dockpanel-element.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/dockpanel.md b/docs/framework/wpf/controls/dockpanel.md
new file mode 100644
index 00000000000..974c91e620b
--- /dev/null
+++ b/docs/framework/wpf/controls/dockpanel.md
@@ -0,0 +1,50 @@
+---
+title: "DockPanel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], DockPanel"
+  - "DockPanel コントロール [WPF]"
+ms.assetid: 8d3d290b-d38c-47d0-918e-cee2baeb92ae
+caps.latest.revision: 62
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 62
+---
+# DockPanel
+<xref:System.Windows.Controls.DockPanel> 要素は、レイアウト コンテナーの端に沿って子コンテンツを配置するために使用されます。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/dockpanel-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/documentviewer-styles-and-templates.md b/docs/framework/wpf/controls/documentviewer-styles-and-templates.md
new file mode 100644
index 00000000000..e711af8e879
--- /dev/null
+++ b/docs/framework/wpf/controls/documentviewer-styles-and-templates.md
@@ -0,0 +1,65 @@
+---
+title: "DocumentViewer のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], DocumentViewer"
+  - "DocumentViewer [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], DocumentViewer"
+  - "状態 [WPF], DocumentViewer"
+  - "スタイル [WPF], DocumentViewer"
+  - "テンプレート [WPF], DocumentViewer"
+ms.assetid: 6bd4ff8f-ea6a-4084-ac58-e7a67446ce1c
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# DocumentViewer のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.DocumentViewer> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## DocumentViewer のパーツ  
+ 次の表は、<xref:System.Windows.Controls.DocumentViewer> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ContentHost|<xref:System.Windows.Controls.ScrollViewer>|コンテンツとスクロールの領域です。|  
+|PART\_FindToolBarHost|<xref:System.Windows.Controls.ContentControl>|検索ボックスです。既定では、最下部にあります。|  
+  
+## DocumentViewer の状態  
+ 次の表は、<xref:System.Windows.Controls.DocumentViewer> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## DocumentViewer ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.DocumentViewer> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#DocumentViewer](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/documentviewer.xaml#documentviewer)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/documentviewer.md b/docs/framework/wpf/controls/documentviewer.md
new file mode 100644
index 00000000000..bd8ead75204
--- /dev/null
+++ b/docs/framework/wpf/controls/documentviewer.md
@@ -0,0 +1,35 @@
+---
+title: "DocumentViewer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], DocumentViewer"
+  - "DocumentViewer コントロール [WPF]"
+ms.assetid: c21eb322-d6b3-474b-ab05-94527bd1b0fa
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# DocumentViewer
+<xref:System.Windows.Controls.DocumentViewer> コントロールは、改ページ位置が自動修正される書式で、<xref:System.Windows.Documents.FixedDocument> コンテンツ \([!INCLUDE[TLA#tla_metro](../../../../includes/tlasharptla-metro-md.md)] ドキュメントなど\) を表示するために使用します。  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.DocumentViewer>  
+  
+ <xref:System.Windows.Documents.FixedDocument>  
+  
+## 参照  
+ [ドキュメント](../../../../docs/framework/wpf/advanced/documents.md)   
+ [ドキュメントのシリアル化および保存](../../../../docs/framework/wpf/advanced/document-serialization-and-storage.md)   
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/expander-how-to-topics.md b/docs/framework/wpf/controls/expander-how-to-topics.md
new file mode 100644
index 00000000000..051c6efe3fa
--- /dev/null
+++ b/docs/framework/wpf/controls/expander-how-to-topics.md
@@ -0,0 +1,34 @@
+---
+title: "エキスパンダーに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, Expander"
+  - "Expander コントロール, 方法トピック"
+ms.assetid: c31e85e3-963f-4693-b463-a29adc433fcd
+caps.latest.revision: 62
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 62
+---
+# エキスパンダーに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Expander> コントロールを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [ScrollViewer を持つエキスパンダーを作成する](../../../../docs/framework/wpf/controls/how-to-create-an-expander-with-a-scrollviewer.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Expander>  
+  
+## 関連項目  
+ [エキスパンダーの概要](../../../../docs/framework/wpf/controls/expander-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/expander-overview.md b/docs/framework/wpf/controls/expander-overview.md
new file mode 100644
index 00000000000..82365d20ff8
--- /dev/null
+++ b/docs/framework/wpf/controls/expander-overview.md
@@ -0,0 +1,70 @@
+---
+title: "エキスパンダーの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, Expander"
+  - "Expander コントロール, エキスパンダー コントロールの概要"
+ms.assetid: 877bf425-0e54-49ec-8fd2-13a211377abb
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# エキスパンダーの概要
+<xref:System.Windows.Controls.Expander> コントロールとは、ウィンドウに似た、ヘッダーを持つ展開可能な領域内にコンテンツを表示するための手段です。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="CreatinganExpanderinXAML"></a>   
+## 単純なエキスパンダーの作成  
+ 簡単な <xref:System.Windows.Controls.Expander> コントロールを作成する方法を次の例に示します。  この例では、前の図のような外観の <xref:System.Windows.Controls.Expander> を作成します。  
+  
+ [!code-xml[ExpanderExample#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpanderExample/CSharp/Page1.xaml#2)]  
+  
+ <xref:System.Windows.Controls.Expander> の <xref:System.Windows.Controls.ContentControl.Content%2A> および <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> には、<xref:System.Windows.Controls.RadioButton> オブジェクトや <xref:System.Windows.Controls.Image> オブジェクトなどの複雑なコンテンツも格納できます。  
+  
+<a name="SettingtheDirectionoftheExpandingWindow"></a>   
+## コンテンツ エリアの展開方向の設定  
+ <xref:System.Windows.Controls.ExpandDirection> プロパティを使用して、<xref:System.Windows.Controls.Expander> コントロールのコンテンツ領域を <xref:System.Windows.Controls.ExpandDirection>、<xref:System.Windows.Controls.ExpandDirection>、<xref:System.Windows.Controls.ExpandDirection>、<xref:System.Windows.Controls.ExpandDirection> の 4 つのうちどの方向に展開するかを設定します。  コンテンツ領域が折りたたまれているときは、<xref:System.Windows.Controls.Expander> <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> およびそのトグル ボタンだけが表示されます。  方向を示す矢印を表示する <xref:System.Windows.Controls.Button> コントロールが、コンテンツ エリアを展開したり折りたたんだりするためのトグル ボタンとして使用されます。  展開されると、<xref:System.Windows.Controls.Expander> は、ウィンドウに似た領域にすべてのコンテンツを表示しようとします。  
+  
+<a name="SettingSizeDimensionsonanExpanderinaPanel"></a>   
+## パネル内のエキスパンダーのサイズの制御  
+ <xref:System.Windows.Controls.Expander> コントロールが <xref:System.Windows.Controls.StackPanel> などの <xref:System.Windows.Controls.Panel> から継承されるレイアウト コントロールの内側にあり、<xref:System.Windows.Controls.Expander.ExpandDirection%2A> プロパティが <xref:System.Windows.Controls.ExpandDirection> または <xref:System.Windows.Controls.ExpandDirection> に設定されている場合は、<xref:System.Windows.Controls.Expander> に対して <xref:System.Windows.FrameworkElement.Height%2A> を指定しないでください。  同様に、<xref:System.Windows.Controls.Expander.ExpandDirection%2A> プロパティが <xref:System.Windows.Controls.ExpandDirection> または <xref:System.Windows.Controls.ExpandDirection> に設定されている場合は、<xref:System.Windows.Controls.Expander> に対して <xref:System.Windows.FrameworkElement.Width%2A> を指定しないでください。  
+  
+ 展開されたコンテンツを表示する方向のサイズを <xref:System.Windows.Controls.Expander> コントロールに対して設定すると、コンテンツが使用する領域は<xref:System.Windows.Controls.Expander> によって制御され、その周囲に境界線が表示されます。  コンテンツが折りたたまれても境界線は表示されます。  展開されたコンテンツ領域のサイズを設定するには、<xref:System.Windows.Controls.Expander> のコンテンツに対してサイズを設定します。スクロール可能にする場合は、コンテンツを囲む <xref:System.Windows.Controls.ScrollViewer> に対してサイズを設定します。  
+  
+ <xref:System.Windows.Controls.Expander> コントロールが <xref:System.Windows.Controls.DockPanel> の最後の要素である場合は、<xref:System.Windows.Controls.DockPanel> の残りの領域に等しくなるように、<xref:System.Windows.Controls.Expander> のサイズが [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] によって自動的に設定されます。  この既定の動作を回避するには、<xref:System.Windows.Controls.DockPanel> オブジェクトの <xref:System.Windows.Controls.DockPanel.LastChildFill%2A> プロパティを `false` に設定するか、<xref:System.Windows.Controls.Expander> が <xref:System.Windows.Controls.DockPanel> の最後の要素にならないようにします。  
+  
+<a name="CreatingScrollableContent"></a>   
+## スクロール可能なコンテンツの作成  
+ コンテンツが大きすぎてコンテンツ領域に表示できない場合は、<xref:System.Windows.Controls.Expander> のコンテンツを <xref:System.Windows.Controls.ScrollViewer> でラップすると、コンテンツがスクロール可能になります。  <xref:System.Windows.Controls.Expander> コントロールは、スクロール機能を自動的に持つわけではありません。  <xref:System.Windows.Controls.ScrollViewer> コントロールを持つ <xref:System.Windows.Controls.Expander> コントロールを次の図に示します。  
+  
+ **ScrollViewer 内のエキスパンダー**  
+  
+ ![ScrollBar を持つ Expander](../../../../docs/framework/wpf/controls/media/expanderwithscrollbar.JPG "ExpanderWithScrollBar")  
+  
+ <xref:System.Windows.Controls.Expander> コントロールを <xref:System.Windows.Controls.ScrollViewer> 内に配置する場合は、<xref:System.Windows.Controls.Expander> コンテンツが開く方向に対応する <xref:System.Windows.Controls.ScrollViewer> のサイズ プロパティを、<xref:System.Windows.Controls.Expander> コンテンツ領域のサイズに設定します。  たとえば、<xref:System.Windows.Controls.Expander> の <xref:System.Windows.Controls.Expander.ExpandDirection%2A> プロパティを <xref:System.Windows.Controls.ExpandDirection> に設定する \(コンテンツ領域が下に開く\) 場合は、<xref:System.Windows.Controls.ScrollViewer> コントロールの <xref:System.Windows.FrameworkElement.Height%2A> プロパティを、コンテンツ領域に必要な高さに設定します。  このような設定を行わずにコンテンツ自体の高さのサイズを設定しても、この設定は <xref:System.Windows.Controls.ScrollViewer> に認識されないので、コンテンツはスクロール可能にはなりません。  
+  
+ コンテンツが複雑で、<xref:System.Windows.Controls.ScrollViewer> コントロールを持つ <xref:System.Windows.Controls.Expander> コントロールを作成する方法を次の例に示します。  この例では、ここで最初に示した図のような <xref:System.Windows.Controls.Expander> を作成します。  
+  
+ [!code-csharp[ExpanderRichContent#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpanderRichContent/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[ExpanderRichContent#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpanderRichContent/VisualBasic/Window1.xaml.vb#1)]
+ [!code-xml[ExpanderRichContent#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpanderRichContent/CSharp/Window1.xaml#1)]  
+  
+<a name="UsingtheAlignmentProperties"></a>   
+## 配置プロパティの使用  
+ コンテンツの配置 \(左揃えや上揃えなど\) を指定するには、<xref:System.Windows.Controls.Expander> コントロールの <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> プロパティおよび <xref:System.Windows.Controls.Control.VerticalContentAlignment%2A> プロパティを設定します。  これらのプロパティを設定すると、配置がヘッダーに適用され、展開されたコンテンツにも適用されます。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Expander>   
+ <xref:System.Windows.Controls.ExpandDirection>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/expander-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/expander-styles-and-templates.md b/docs/framework/wpf/controls/expander-styles-and-templates.md
new file mode 100644
index 00000000000..dc4b2f41d76
--- /dev/null
+++ b/docs/framework/wpf/controls/expander-styles-and-templates.md
@@ -0,0 +1,70 @@
+---
+title: "エクスパンダーのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], Expander"
+  - "Expander [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], Expander"
+  - "状態 [WPF], Expander"
+  - "スタイル [WPF], Expander"
+  - "テンプレート [WPF], Expander"
+ms.assetid: da2e5a1c-5230-4c21-98a5-59c7895facd7
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# エクスパンダーのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Expander> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Expander のパーツ  
+ <xref:System.Windows.Controls.Expander> コントロールには、名前付きのパーツは存在しません。  
+  
+## Expander の状態  
+ 次の表は、<xref:System.Windows.Controls.Expander> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Expanded|ExpansionStates|コントロールは展開されています。|  
+|Collapsed|ExpansionStates|コントロールは展開されていません。|  
+|ExpandDown|ExpandDirectionStates|コントロールは下方向に拡張します。|  
+|ExpandUp|ExpandDirectionStates|コントロールは上方向に拡張します。|  
+|ExpandLeft|ExpandDirectionStates|コントロールは左方向に拡張します。|  
+|ExpandRight|ExpandDirectionStates|コントロールは右方向に拡張します。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Expander ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Expander> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Expander](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/expander.xaml#expander)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/expander.md b/docs/framework/wpf/controls/expander.md
new file mode 100644
index 00000000000..17cb9755a44
--- /dev/null
+++ b/docs/framework/wpf/controls/expander.md
@@ -0,0 +1,42 @@
+---
+title: "Expander | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "折りたたみ (ヘッダーを) [WPF]"
+  - "コントロール [WPF], Expander"
+  - "Expander コントロール [WPF]"
+  - "展開 (ヘッダーを) [WPF]"
+  - "ヘッダー [WPF]"
+ms.assetid: e9dfc8d6-4555-47b9-a4de-0acd64f8770a
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# Expander
+<xref:System.Windows.Controls.Expander> を使用すると、ヘッダーを表示し、ヘッダーを展開して詳細を見たり、セクションをヘッダーに折りたたんだりすることができます。  
+  
+ 展開された位置にあるこのコントロールの例を次の図に示します。  
+  
+ ![Expander の例](../../../../docs/framework/wpf/controls/media/expanderexample.JPG "ExpanderExample")  
+Expander コントロール  
+  
+## このセクションの内容  
+ [エキスパンダーの概要](../../../../docs/framework/wpf/controls/expander-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/expander-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Expander>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/flowdocumentpageviewer.md b/docs/framework/wpf/controls/flowdocumentpageviewer.md
new file mode 100644
index 00000000000..401f52e427b
--- /dev/null
+++ b/docs/framework/wpf/controls/flowdocumentpageviewer.md
@@ -0,0 +1,31 @@
+---
+title: "FlowDocumentPageViewer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], FlowDocumentPageViewer"
+  - "FlowDocumentPageViewer コントロール [WPF]"
+ms.assetid: 1ed5a30e-f415-4c26-a52f-9f028a68f66f
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# FlowDocumentPageViewer
+<xref:System.Windows.Controls.FlowDocumentPageViewer> コントロールは、1 ページ単位で <xref:System.Windows.Documents.FlowDocument> のコンテンツを表示するために使用します。  これに対して、<xref:System.Windows.Controls.FlowDocumentScrollViewer> は、<xref:System.Windows.Documents.FlowDocument> のコンテンツをスクロール ビューアーで表示します。  
+  
+## 参照  
+ <xref:System.Windows.Documents.FlowDocument>   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/advanced/flow-content-elements-how-to-topics.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/flowdocumentreader.md b/docs/framework/wpf/controls/flowdocumentreader.md
new file mode 100644
index 00000000000..3b57f100ff3
--- /dev/null
+++ b/docs/framework/wpf/controls/flowdocumentreader.md
@@ -0,0 +1,32 @@
+---
+title: "FlowDocumentReader | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], FlowDocumentReader"
+  - "FlowDocumentReader コントロール [WPF]"
+ms.assetid: ba7aaa70-f77b-4555-a79d-68a12c8e134b
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# FlowDocumentReader
+<xref:System.Windows.Controls.FlowDocumentReader> コントロールを使用して <xref:System.Windows.Documents.FlowDocument> のコンテンツを表示します。  これは、複数の表示モードをサポートします。  
+  
+## 参照  
+ <xref:System.Windows.Controls.FlowDocumentReader>   
+ <xref:System.Windows.Controls.FlowDocumentPageViewer>   
+ <xref:System.Windows.Controls.FlowDocumentScrollViewer>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/flowdocumentscrollviewer.md b/docs/framework/wpf/controls/flowdocumentscrollviewer.md
new file mode 100644
index 00000000000..a87fbb8d6b3
--- /dev/null
+++ b/docs/framework/wpf/controls/flowdocumentscrollviewer.md
@@ -0,0 +1,33 @@
+---
+title: "FlowDocumentScrollViewer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], FlowDocumentScrollViewer"
+  - "FlowDocumentScrollViewer コントロール [WPF]"
+ms.assetid: 727b0a0a-b845-4aa9-9fd4-98f42ed738b4
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# FlowDocumentScrollViewer
+<xref:System.Windows.Controls.FlowDocumentScrollViewer> コントロールは、スクロール コンテナー内の <xref:System.Windows.Documents.FlowDocument> のコンテンツを表示するために使用します。  このコントロールは、コンテンツをページ単位で表示する <xref:System.Windows.Controls.FlowDocumentPageViewer> とは異なります。  
+  
+## 参照  
+ <xref:System.Windows.Controls.FlowDocumentReader>   
+ <xref:System.Windows.Controls.FlowDocumentPageViewer>   
+ <xref:System.Windows.Controls.FlowDocumentScrollViewer>   
+ <xref:System.Windows.Documents.FlowDocument>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/frame-styles-and-templates.md b/docs/framework/wpf/controls/frame-styles-and-templates.md
new file mode 100644
index 00000000000..5e76999a714
--- /dev/null
+++ b/docs/framework/wpf/controls/frame-styles-and-templates.md
@@ -0,0 +1,64 @@
+---
+title: "フレームのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], フレーム"
+  - "Frame [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], フレーム"
+  - "状態 [WPF], フレーム"
+  - "スタイル [WPF], フレーム"
+  - "テンプレート [WPF], フレーム"
+ms.assetid: a01c32e2-c951-46a0-a82f-2614ca241f0b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# フレームのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Frame> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Frame のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Frame> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_FrameCP|<xref:System.Windows.Controls.ContentPresenter>|コンテンツ領域です。|  
+  
+## Frame の状態  
+ 次の表は、<xref:System.Windows.Controls.Frame> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Frame ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Frame> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Frame](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/frame.xaml#frame)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/frame.md b/docs/framework/wpf/controls/frame.md
new file mode 100644
index 00000000000..574e04f1257
--- /dev/null
+++ b/docs/framework/wpf/controls/frame.md
@@ -0,0 +1,33 @@
+---
+title: "フレーム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], Frame コントロール"
+  - "コントロール [WPF], フレーム"
+  - "Frame コントロール [WPF]"
+  - "ナビゲーション [WPF], コンテンツ内"
+ms.assetid: 1588f9bf-9001-4437-a8fc-cc57ef50561c
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# フレーム
+<xref:System.Windows.Controls.Frame> コントロールはコンテンツ内でのコンテンツ ナビゲーションをサポートします。  <xref:System.Windows.Controls.Frame> は、<xref:System.Windows.Window>、<xref:System.Windows.Navigation.NavigationWindow>、<xref:System.Windows.Controls.Page>、<xref:System.Windows.Controls.UserControl>、<xref:System.Windows.Documents.FlowDocument> などのルート要素によって、またはルート要素に属するコンテンツ ツリー内のアイランドとしてホストできます。  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Frame>  
+  
+## 関連項目  
+ [ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/grid-how-to-topics.md b/docs/framework/wpf/controls/grid-how-to-topics.md
new file mode 100644
index 00000000000..9f482aadc74
--- /dev/null
+++ b/docs/framework/wpf/controls/grid-how-to-topics.md
@@ -0,0 +1,56 @@
+---
+title: "グリッドに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, グリッド"
+  - "グリッド コントロール [WPF], 方法トピック"
+ms.assetid: 90e07c2d-237f-47b4-a632-771570b77fd0
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# グリッドに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Grid> 要素を使用して要素を配置する方法について説明します。  
+  
+## このセクションの内容  
+ [グリッドを使用して標準 UI ダイアログ ボックスをビルドする](../../../../docs/framework/wpf/controls/how-to-build-a-standard-ui-dialog-box-by-using-grid.md)  
+ [複雑なグリッドを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-complex-grid.md)  
+ [グリッド要素を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-grid-element.md)  
+ [GridLengthConverter オブジェクトを作成および使用する](../../../../docs/framework/wpf/controls/how-to-create-and-use-a-gridlengthconverter-object.md)  
+ [ColumnDefinitionsCollections および RowDefinitionsCollections を使用して列と行を操作する](../../../../docs/framework/wpf/controls/manipulate-columns-and-rows-by-using-columndefinitionscollections.md)  
+ [グリッドの子要素を配置する](../../../../docs/framework/wpf/controls/how-to-position-the-child-elements-of-a-grid.md)  
+ [グリッド間でサイズ設定プロパティを共有する](../../../../docs/framework/wpf/controls/how-to-share-sizing-properties-between-grids.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/grid.md b/docs/framework/wpf/controls/grid.md
new file mode 100644
index 00000000000..7fc3265016d
--- /dev/null
+++ b/docs/framework/wpf/controls/grid.md
@@ -0,0 +1,51 @@
+---
+title: "グリッド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], グリッド コントロール"
+  - "コントロール [WPF], グリッド"
+  - "グリッド コントロール [WPF]"
+ms.assetid: cf2cc94c-bbc2-4e54-a601-605038ab63fe
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# グリッド
+<xref:System.Windows.Controls.Grid> 要素は、行と列に含まれるコンテンツを正確に配置するために使用されます。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/grid-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/gridsplitter-how-to-topics.md b/docs/framework/wpf/controls/gridsplitter-how-to-topics.md
new file mode 100644
index 00000000000..1fda9f839b2
--- /dev/null
+++ b/docs/framework/wpf/controls/gridsplitter-how-to-topics.md
@@ -0,0 +1,37 @@
+---
+title: "GridSplitter に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, GridSplitter"
+  - "GridSplitter コントロール [WPF], 方法トピック"
+ms.assetid: db0da67a-954f-42e6-bbf7-4e16b8cbb210
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# GridSplitter に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.GridSplitter> コントロールを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [GridSplitter を使用して行のサイズを変更する](../../../../docs/framework/wpf/controls/how-to-resize-rows-with-a-gridsplitter.md)  
+ [GridSplitter を使用して列のサイズを変更する](../../../../docs/framework/wpf/controls/how-to-resize-columns-with-a-gridsplitter.md)  
+ [GridSplitter を表示されるようにする](../../../../docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.GridSplitter>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/gridsplitter.md b/docs/framework/wpf/controls/gridsplitter.md
new file mode 100644
index 00000000000..c0b4745486c
--- /dev/null
+++ b/docs/framework/wpf/controls/gridsplitter.md
@@ -0,0 +1,34 @@
+---
+title: "GridSplitter | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], GridSplitter コントロール"
+  - "コントロール [WPF], GridSplitter"
+  - "GridSplitter コントロール [WPF]"
+ms.assetid: 98b007e8-ea6b-41b5-8120-ca7134e8239f
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# GridSplitter
+<xref:System.Windows.Controls.GridSplitter> は、<xref:System.Windows.Controls.Grid> コントロールの行間または列間の領域を再配分します。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/gridsplitter-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.GridSplitter>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md b/docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md
new file mode 100644
index 00000000000..53f963d2310
--- /dev/null
+++ b/docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md
@@ -0,0 +1,48 @@
+---
+title: "GridView の列ヘッダー スタイルおｙびテンプレートの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列ヘッダー, カスタマイズ"
+  - "コントロール, ListView"
+  - "GridView 表示モード, カスタマイズ (列ヘッダーを)"
+  - "ヘッダー, カスタマイズ"
+  - "ListView コントロール [WPF], GridView の列ヘッダー スタイル"
+ms.assetid: 74835674-a39e-4ab5-9418-ad7f6ab7b956
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# GridView の列ヘッダー スタイルおｙびテンプレートの概要
+ここでは、<xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.GridView> 表示モードの列ヘッダーをカスタマイズするために使用するプロパティの優先順位について説明します。  
+  
+## GridView の列ヘッダーのカスタマイズ  
+ <xref:System.Windows.Controls.GridView> の列ヘッダーの内容、レイアウト、およびスタイルを定義するプロパティは、多くの関連クラスで使用されます。  これらのプロパティのいくつかは、類似した機能または同一の機能を持ちます。  
+  
+ 同じ機能を実行するプロパティのグループを次の表の行に示します。  これらのプロパティを使用して、<xref:System.Windows.Controls.GridView> の列ヘッダーをカスタマイズできます。  関連するプロパティの優先順位は、右から左の順になります。一番右の列のプロパティの優先順位が最も高くなります。  たとえば、<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> が <xref:System.Windows.Controls.GridViewColumnHeader> オブジェクトで設定され、<xref:System.Windows.Controls.GridViewColumn.HeaderTemplateSelector%2A> が関連する <xref:System.Windows.Controls.GridViewColumn> で設定されている場合、<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> が優先されます。  このシナリオでは、<xref:System.Windows.Controls.GridViewColumn.HeaderTemplateSelector%2A> は無効になります。  
+  
+ **GridView の列ヘッダーの関連プロパティ**  
+  
+|||||  
+|-|-|-|-|  
+|**Classes**|<xref:System.Windows.Controls.GridView>|<xref:System.Windows.Controls.GridViewColumn>|<xref:System.Windows.Controls.GridViewColumnHeader>|  
+|**コンテキスト メニュー プロパティ**|<xref:System.Windows.Controls.GridView.ColumnHeaderContextMenu%2A>|該当なし|<xref:System.Windows.FrameworkElement.ContextMenu%2A>|  
+|**ツールヒント**<br /><br /> **プロパティ**|<xref:System.Windows.Controls.GridView.ColumnHeaderToolTip%2A>|該当なし|<xref:System.Windows.FrameworkElement.ToolTip%2A>|  
+|**ヘッダー テンプレート**<br /><br /> **プロパティ**|<xref:System.Windows.Controls.GridView.ColumnHeaderTemplate%2A> <sup>1</sup>\/<br /><br /> <xref:System.Windows.Controls.GridView.ColumnHeaderTemplateSelector%2A>|<xref:System.Windows.Controls.GridViewColumn.HeaderTemplate%2A> <sup>1</sup>\/<br /><br /> <xref:System.Windows.Controls.GridViewColumn.HeaderTemplateSelector%2A>|<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> <sup>1</sup>\/<br /><br /> <xref:System.Windows.Controls.ContentControl.ContentTemplateSelector%2A>|  
+|**スタイル プロパティ**|<xref:System.Windows.Controls.GridView.ColumnHeaderContainerStyle%2A>|<xref:System.Windows.Controls.GridViewColumn.HeaderContainerStyle%2A>|<xref:System.Windows.FrameworkElement.Style%2A>|  
+  
+ <sup>1</sup> **ヘッダー テンプレート プロパティ**では、テンプレート プロパティとテンプレート セレクター プロパティの両方を設定した場合は、テンプレート プロパティが優先されます。  たとえば、<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> プロパティと <xref:System.Windows.Controls.ContentControl.ContentTemplateSelector%2A> プロパティの両方を設定した場合は、<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> プロパティが優先されます。  
+  
+## 参照  
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/gridview-overview.md b/docs/framework/wpf/controls/gridview-overview.md
new file mode 100644
index 00000000000..d59383e63dc
--- /dev/null
+++ b/docs/framework/wpf/controls/gridview-overview.md
@@ -0,0 +1,148 @@
+---
+title: "GridView の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ListView"
+  - "GridView 表示モード"
+  - "ListView コントロール, GridView 表示モード"
+ms.assetid: b2d02267-32b3-40ce-8e9f-06972d8749d9
+caps.latest.revision: 26
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# GridView の概要
+<xref:System.Windows.Controls.GridView> 表示モードは、<xref:System.Windows.Controls.ListView> コントロールの表示モードの 1 つです。  <xref:System.Windows.Controls.GridView> クラスおよびそのサポート クラスを使用すると、一般的にボタンを対話型列ヘッダーとして使用するテーブルに項目コレクションを表示することができます。  ここでは、<xref:System.Windows.Controls.GridView> クラスについて説明し、その使用方法を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="DefiningaListViewthatusesGridViewView"></a>   
+## GridView ビューとは  
+ <xref:System.Windows.Controls.GridView> 表示モードでは、データ フィールドを列にバインドし、列ヘッダーを表示してフィールドを識別することによって、データ項目のリストを表示します。  既定の <xref:System.Windows.Controls.GridView> スタイルは、列ヘッダーとしてボタンを実装します。  列ヘッダーにボタンを使用すると、重要なユーザー操作機能を実装できます。たとえば、ユーザーは列ヘッダーをクリックして、特定の列のコンテンツに従って <xref:System.Windows.Controls.GridView> データを並べ替えることができます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.GridView> で列ヘッダーに使用されるボタン コントロールは、<xref:System.Windows.Controls.Primitives.ButtonBase> から派生します。  
+  
+ <xref:System.Windows.Controls.ListView> コンテンツの <xref:System.Windows.Controls.GridView> ビューを次の図に示します。  
+  
+ **ListView コンテンツの GridView ビュー**  
+  
+ ![スタイル設定された ListView](../../../../docs/framework/wpf/controls/media/styledlistview.png "StyledListView")  
+  
+ <xref:System.Windows.Controls.GridView> の列は <xref:System.Windows.Controls.GridViewColumn> オブジェクトによって表されます。このオブジェクトのサイズは、コンテンツのサイズに自動的に設定されます。  必要に応じて、<xref:System.Windows.Controls.GridViewColumn> を特定の幅に明示的に設定できます。  列ヘッダー間のグリッパーをドラッグすることによって、列のサイズを変更できます。  また、列の追加、削除、置換、および並べ替え機能が <xref:System.Windows.Controls.GridView> に組み込まれているため、この機能を動的に実行することができます。  ただし、<xref:System.Windows.Controls.GridView> では、表示されるデータを直接更新することはできません。  
+  
+ 従業員データを表示する <xref:System.Windows.Controls.GridView> を定義する方法を次の例に示します。  この例では、<xref:System.Windows.Controls.ListView> で `EmployeeInfoDataSource` が <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> として定義されています。  <xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> のプロパティ定義によって、<xref:System.Windows.Controls.GridViewColumn> のコンテンツが `EmployeeInfoDataSource` データ カテゴリにバインドされます。  
+  
+ [!code-xml[ListViewCode#ListViewEmployee](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml#listviewemployee)]  
+  
+ 前述の例で作成したテーブルを次の図に示します。  
+  
+ **ItemsSource のデータを表示する GridView**  
+  
+ ![GridView 出力を含む ListView](../../../../docs/framework/wpf/controls/media/listviewgridview.png "ListViewGridView")  
+  
+<a name="GridViewLayoutandStyle"></a>   
+## GridView レイアウトおよびスタイル  
+ <xref:System.Windows.Controls.GridViewColumn> の列のセルおよび列ヘッダーの幅は同じです。  既定では、各列の幅は、そのコンテンツに合わせて設定されます。  必要に応じて、列を固定幅に設定できます。  
+  
+ 関連するデータ コンテンツは、水平行に表示されます。  たとえば、前の図では、各従業員の氏名および ID 番号が水平行に示されているため、これらが 1 つのセットとして表示されています。  
+  
+<a name="DefiningandStylingColumnsinaGridView"></a>   
+### GridView の列の定義およびスタイル設定  
+ <xref:System.Windows.Controls.GridViewColumn> に表示するデータ フィールドを定義する場合は、<xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A>、<xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A>、または <xref:System.Windows.Controls.GridViewColumn.CellTemplateSelector%2A> プロパティを使用します。  <xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> プロパティは、他の 2 つのテンプレート プロパティよりも優先されます。  
+  
+ <xref:System.Windows.Controls.GridView> の列のコンテンツの配置を指定するには、<xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A> を定義します。  <xref:System.Windows.Controls.GridView> を使用して表示する <xref:System.Windows.Controls.ListView> のコンテンツには、<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> および <xref:System.Windows.Controls.Control.VerticalContentAlignment%2A> プロパティを使用しないでください。  
+  
+ 列ヘッダーのテンプレート プロパティとスタイル プロパティを指定するには、<xref:System.Windows.Controls.GridView>、<xref:System.Windows.Controls.GridViewColumn>、および <xref:System.Windows.Controls.GridViewColumnHeader> クラスを使用します。  詳細については、「[GridView の列ヘッダー スタイルおｙびテンプレートの概要](../../../../docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md)」を参照してください。  
+  
+<a name="AddingVisualElementstoaGridViewView"></a>   
+### GridView へのビジュアル要素の追加  
+ <xref:System.Windows.Controls.CheckBox> コントロールや <xref:System.Windows.Controls.Button> コントロールなどのビジュアル要素を <xref:System.Windows.Controls.GridView> 表示モードに追加するには、テンプレートまたはスタイルを使用します。  
+  
+ ビジュアル要素をデータ項目として明示的に定義した場合、その要素は <xref:System.Windows.Controls.GridView> に一度しか表示できません。  この制限は、要素は親を 1 つしか持つことができず、[ビジュアル ツリー](GTMT)に一度しか表示されないために適用されます。  
+  
+<a name="StylingRowsinaGridViewView"></a>   
+### GridView の行のスタイル設定  
+ <xref:System.Windows.Controls.GridViewRowPresenter> および <xref:System.Windows.Controls.GridViewHeaderRowPresenter> クラスを使用して、<xref:System.Windows.Controls.GridView> の行を書式設定して表示します。  <xref:System.Windows.Controls.GridView> 表示モードの行のスタイルを設定する方法の例については、「[GridView を実装する ListView で行のスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-style-a-row-in-a-listview-that-implements-a-gridview.md)」を参照してください。  
+  
+<a name="AlignmentIssuesWhenUsingItemContainerStyle"></a>   
+### ItemContainerStyle を使用する際の配置の問題  
+ 列ヘッダーとセル間の配置の問題を回避するため、<xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> の項目の幅に影響を与えるプロパティを設定したりテンプレートを指定したりしないようにしてください。  たとえば、<xref:System.Windows.FrameworkElement.Margin%2A> プロパティを設定したり、<xref:System.Windows.Controls.ListView> コントロールで定義されている <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> に <xref:System.Windows.Controls.CheckBox> を追加する <xref:System.Windows.Controls.ControlTemplate> を指定したりしないでください。  代わりに、列の幅に影響を与えるプロパティおよびテンプレートを、<xref:System.Windows.Controls.GridView> 表示モードを定義するクラスで直接指定してください。  
+  
+ たとえば、<xref:System.Windows.Controls.CheckBox> を <xref:System.Windows.Controls.GridView> 表示モードの行に追加するには、<xref:System.Windows.Controls.CheckBox> を <xref:System.Windows.DataTemplate> に追加して、<xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A> プロパティをその <xref:System.Windows.DataTemplate> に設定します。  
+  
+<a name="InteractingwithaGridViewControl"></a>   
+## GridView でのユーザーの操作  
+ アプリケーションで <xref:System.Windows.Controls.GridView> を使用する場合、ユーザーは <xref:System.Windows.Controls.GridView> の書式設定を操作および変更できます。  たとえば、ユーザーは列の並べ替え、列のサイズ変更、テーブルでの項目の選択、コンテンツのスクロールなどを実行できます。  また、ユーザーが列ヘッダー ボタンをクリックしたときに応答するイベント ハンドラーを定義することもできます。  イベント ハンドラーは、列のコンテンツに従って <xref:System.Windows.Controls.GridView> に表示されるデータを並べ替える操作などを実行できます。  
+  
+ <xref:System.Windows.Controls.GridView> を使用したユーザー操作のための機能の詳細を次に示します。  
+  
+-   **ドラッグ アンド ドロップを使用した列の並べ替え。**  
+  
+     ユーザーは、マウスが列ヘッダー上にあるときにその左ボタンを押してその列を新しい位置にドラッグすることで、<xref:System.Windows.Controls.GridView> の列を並べ替えることができます。  ユーザーが列ヘッダーをドラッグするとき、フローティング バージョンのヘッダーと、列を挿入する位置を示す黒い実線が表示されます。  
+  
+     フローティング バージョンのヘッダーの既定のスタイルを変更する場合は、<xref:System.Windows.Controls.GridViewColumnHeader.Role%2A> プロパティが <xref:System.Windows.Controls.GridViewColumnHeaderRole> に設定されているときにトリガーされる <xref:System.Windows.Controls.GridViewColumnHeader> 型の <xref:System.Windows.Controls.ControlTemplate> を指定します。  詳細については、「[ドラッグされた GridView 列ヘッダーのスタイルを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-style-for-a-dragged-gridview-column-header.md)」を参照してください。  
+  
+-   **コンテンツに合わせた列のサイズ変更。**  
+  
+     ユーザーは、列ヘッダーの右にあるグリッパーをダブルクリックして、列のサイズをそのコンテンツに合わせて変更することができます。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Controls.GridViewColumn.Width%2A> プロパティを `Double.NaN` に設定して、同じ効果を得ることができます。  
+  
+-   **行項目の選択。**  
+  
+     ユーザーは、<xref:System.Windows.Controls.GridView> の 1 つ以上の項目を選択できます。  
+  
+     選択された項目の <xref:System.Windows.Style> を変更する場合は、「[トリガーを使用して、ListView で選択された項目のスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-use-triggers-to-style-selected-items-in-a-listview.md)」を参照してください。  
+  
+-   **最初に画面に表示されていないコンテンツを表示するためのスクロール。**  
+  
+     <xref:System.Windows.Controls.GridView> のサイズがすべての項目を表示できる十分な大きさではない場合、ユーザーは、<xref:System.Windows.Controls.ScrollViewer> コントロールによって提供されるスクロール バーを使用して水平方向または垂直方向にスクロールできます。  特定の方向ですべてのコンテンツが表示可能な場合、<xref:System.Windows.Controls.Primitives.ScrollBar> は非表示になります。  列ヘッダーは垂直スクロール バーでスクロールされませんが、水平方向にはスクロールされます。  
+  
+-   **列ヘッダー ボタンをクリックすることによる列の操作。**  
+  
+     並べ替えアルゴリズムが提供されている場合、列ヘッダー ボタンをクリックすると、ユーザーは列に表示されるデータを並べ替えることができます。  
+  
+     並べ替えアルゴリズムなどの機能を提供するには、列ヘッダー ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理します。  単一の列ヘッダーの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理するには、<xref:System.Windows.Controls.GridViewColumnHeader> に対してイベント ハンドラーを設定します。  すべての列ヘッダーの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理するイベント ハンドラーを設定するには、<xref:System.Windows.Controls.ListView> コントロールに対してハンドラーを設定します。  
+  
+<a name="Obtaining_Other_Custom_Views"></a>   
+## その他のカスタム ビューの取得  
+ <xref:System.Windows.Controls.ViewBase> 抽象クラスから派生した <xref:System.Windows.Controls.GridView> クラスは、<xref:System.Windows.Controls.ListView> クラスの使用可能な表示モードの一例です。  <xref:System.Windows.Controls.ViewBase> クラスから派生させて、<xref:System.Windows.Controls.ListView> のその他のカスタム ビューを作成できます。  カスタム表示モードの例については、「[ListView のカスタム表示モードを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md)」を参照してください。  
+  
+<a name="GridViewSupportingClasses"></a>   
+## GridView のサポート クラス  
+ 次のクラスは <xref:System.Windows.Controls.GridView> 表示モードをサポートします。  
+  
+-   <xref:System.Windows.Controls.GridViewColumn>  
+  
+-   <xref:System.Windows.Controls.GridViewColumnHeader>  
+  
+-   <xref:System.Windows.Controls.GridViewRowPresenter>  
+  
+-   <xref:System.Windows.Controls.GridViewHeaderRowPresenter>  
+  
+-   <xref:System.Windows.Controls.GridViewColumnCollection>  
+  
+-   <xref:System.Windows.Controls.GridViewColumnHeaderRole>  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.ListViewItem>   
+ <xref:System.Windows.Controls.GridViewColumn>   
+ <xref:System.Windows.Controls.GridViewColumnHeader>   
+ <xref:System.Windows.Controls.GridViewRowPresenter>   
+ <xref:System.Windows.Controls.GridViewHeaderRowPresenter>   
+ <xref:System.Windows.Controls.ViewBase>   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [ヘッダーがクリックされたときに GridView 列を並べ替える](../../../../docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/groupbox-styles-and-templates.md b/docs/framework/wpf/controls/groupbox-styles-and-templates.md
new file mode 100644
index 00000000000..5ad74b2ebb9
--- /dev/null
+++ b/docs/framework/wpf/controls/groupbox-styles-and-templates.md
@@ -0,0 +1,62 @@
+---
+title: "GroupBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], GroupBox"
+  - "GroupBox [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], GroupBox"
+  - "状態 [WPF], GroupBox"
+  - "スタイル [WPF], GroupBox"
+  - "テンプレート [WPF], GroupBox"
+ms.assetid: 33df7037-0a1b-476f-b9d0-41566a777699
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# GroupBox のスタイルとテンプレート
+<a name="introduction"></a> このトピックでは、<xref:System.Windows.Controls.GroupBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+<a name="groupbox_parts"></a>   
+## GroupBox のパーツ  
+ <xref:System.Windows.Controls.GroupBox> コントロールには、名前付きのパーツは存在しません。  
+  
+<a name="groupbox_states"></a>   
+## GroupBox の状態  
+ 次の表は、<xref:System.Windows.Controls.GroupBox> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+<a name="groupbox_controltemplate_example"></a>   
+## GroupBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.GroupBox> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#GroupBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/groupbox.xaml#groupbox)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> は、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/groupbox.md b/docs/framework/wpf/controls/groupbox.md
new file mode 100644
index 00000000000..5ff156e1d93
--- /dev/null
+++ b/docs/framework/wpf/controls/groupbox.md
@@ -0,0 +1,37 @@
+---
+title: "GroupBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], GroupBox"
+  - "GroupBox コントロール [WPF]"
+ms.assetid: 1f4ed3d9-a171-4623-bc4f-3314e3576271
+caps.latest.revision: 70
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# GroupBox
+<xref:System.Windows.Controls.GroupBox> コントロールは、[!INCLUDE[TLA#tla_gui](../../../../includes/tlasharptla-gui-md.md)] のコンテンツにタイトル付きのコンテナーを提供する <xref:System.Windows.Controls.HeaderedContentControl> です。  
+  
+ <xref:System.Windows.Controls.StackPanel> で囲まれた <xref:System.Windows.Controls.TabControl> と <xref:System.Windows.Controls.Button> を含む <xref:System.Windows.Controls.GroupBox> を次の図に示します。  
+  
+ ![GroupBoxImage](../../../../docs/framework/wpf/controls/media/groupboximage.png "GroupBoxImage")  
+  
+## このセクションの内容  
+ [GroupBox テンプレートを定義する](../../../../docs/framework/wpf/controls/how-to-define-a-groupbox-template.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.GroupBox>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/guidelines-for-designing-stylable-controls.md b/docs/framework/wpf/controls/guidelines-for-designing-stylable-controls.md
new file mode 100644
index 00000000000..b0fbf93f5c1
--- /dev/null
+++ b/docs/framework/wpf/controls/guidelines-for-designing-stylable-controls.md
@@ -0,0 +1,132 @@
+---
+title: "スタイルの設定が可能なコントロールを設計するためのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, スタイル設定 (デザインの)"
+  - "スタイル設定 (コントロールのデザインの)"
+ms.assetid: c52dde45-a311-4531-af4c-853371c4d5f4
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# スタイルの設定が可能なコントロールを設計するためのガイドライン
+このドキュメントでは、スタイルおよびテンプレートを容易に設定できるコントロールを設計する際に考慮する一連のベスト プラクティスについて説明します。  このベスト プラクティスは、組み込みの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール セット用のテーマ コントロール スタイルでの作業の際に、多くの試行錯誤を通じて得られたものです。  スタイルの設定の成功には、スタイルそのものと同様に、優れた設計のオブジェクト モデルの機能が重要であることがわかりました。  このドキュメントは、スタイルの作成者ではなくコントロールの作成者を対象読者として想定しています。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Terminology"></a>   
+## 用語  
+ "スタイルとテンプレート" では、コントロールの作成者が、コントロールの視覚的な側面をコントロールのスタイルとテンプレートに任せるためのテクノロジ スイートについて説明しています。  このテクノロジ スイートには次のものが含まれます。  
+  
+-   スタイル \(プロパティの setter、トリガー、およびストーリーボードを含む\)。  
+  
+-   リソース。  
+  
+-   コントロール テンプレート。  
+  
+-   データ テンプレート。  
+  
+ スタイルとテンプレートの概要については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+<a name="Before_You_Start__Understanding_Your_Control"></a>   
+## 開始する前に : コントロールの理解  
+ ガイドラインに進む前に、コントロールの一般的な使用方法を把握し、定義しておくことが重要です。  スタイル設定の一連の方法は、統制がとれていない状態で公開されていることがよくあります。  多くのアプリケーションや開発者に広く使用される目的で作成されるコントロールでは、スタイルの使用によってコントロールの外観が大きく変更される可能性があるという問題が生じます。  実際に、スタイルの設定されたコントロールが、コントロールの作成者の意図したものと少しも似ていない場合があります。  スタイルがもたらす柔軟性は基本的に制限がないため、一般的な使用方法という概念を使用して、決定の際に役立てることができます。  
+  
+ コントロールの一般的な使用方法を理解するためには、コントロールの価値命題について考えることをお勧めします。  つまり、テーブルに対して自分のコントロールが提供できて他のコントロールには提供できない機能を明らかにします。  一般的な使用方法に含まれるのは、特定の外観ではなく、コントロールの原理と、その使用に関する妥当な期待です。  これを理解することで、一般的な事例におけるコントロールの構成モデルおよびスタイルで定義される動作をある程度仮定できるようになります。  たとえば <xref:System.Windows.Controls.ComboBox> の場合は、一般的な使用方法を理解することで、特定の <xref:System.Windows.Controls.ComboBox> の角が丸いかどうかはわからなくても、<xref:System.Windows.Controls.ComboBox> におそらくポップアップ ウィンドウやその開閉を切り替える方法が必要になることはわかります。  
+  
+<a name="General_Guidelines"></a>   
+## 一般的なガイドライン  
+  
+-   **テンプレート コントラクトは厳密に適用しないようにします。**コントロールのテンプレート コントラクトは、コントロールが正しく機能するために必要とされる、または期待される要素、コマンド、バインディング、トリガー、あるいはプロパティ設定で構成されます。  
+  
+    -   コントラクトはできる限り最小化してください。  
+  
+    -   デザインを行うときは、デザイン時 \(つまりデザイン ツールを使用するとき\) のコントロール テンプレートの状態は一般に不完全であることを予期しておいてください。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は "作成中" の状態のインフラストラクチャを提供しないため、そのような状態になり得るという予測の下にコントロールをビルドする必要があります。  
+  
+    -   テンプレート コントラクトの側面に従っていなくても、例外はスローしないでください。  これに従って、パネルの子が多すぎたり少なすぎたりしても、そのパネルから例外をスローしないようにする必要があります。  
+  
+-   **周辺機能はテンプレート ヘルパー要素に組み入れます。**各コントロールは、そのコア機能と真の価値命題に的を絞り、コントロールの一般的な使用方法によって定義する必要があります。  そのためには、テンプレート内のコンポジション要素とヘルパー要素を使用して、周辺動作と視覚化、つまりコントロールのコア機能に影響しない動作と視覚化を実現します。  ヘルパー要素は、3 つのカテゴリに分類されます。  
+  
+    -   **Standalone** ヘルパー要素は、パブリックで再利用可能なコントロールまたはプリミティブで、テンプレート内では "匿名で" 使用されます。つまり、ヘルパー要素とスタイルが設定されたコントロールは、相手を認識しません。  技術的には、どの要素も匿名型にすることができますが、この文脈でのこの用語は、対象のシナリオを可能にする特殊な機能をカプセル化する型を表しています。  
+  
+    -   **Type\-based** ヘルパー要素は、特殊な機能をカプセル化する新しい型です。  通常この要素は、一般的なコントロールやプリミティブよりも狭い範囲の機能で設計されます。  Standalone ヘルパー要素とは異なり、Type\-based ヘルパー要素は、使用されているコンテキストを認識し、通常は、それらの要素が属しているテンプレートを持つコントロールとデータを共有する必要があります。  
+  
+    -   **Named** ヘルパー要素は、コントロールがそのテンプレート内で名前で検出する一般的なコントロールまたはプリミティブです。これらの要素にはテンプレート内で既知の名前が割り当てられるため、コントロールはその要素を検出し、プログラムを通じて対話できます。  特定の名前を持つ要素はテンプレート内に 1 つだけ存在できます。  
+  
+     現在コントロール スタイルが採用しているヘルパー要素を次の表に示します \(これはすべてを網羅した一覧ではありません\)。  
+  
+    |要素|種類|使用するコントロール|  
+    |--------|--------|----------------|  
+    |<xref:System.Windows.Controls.ContentPresenter>|Type\-based|<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.CheckBox>、<xref:System.Windows.Controls.RadioButton>、<xref:System.Windows.Controls.Frame> など \(いずれも <xref:System.Windows.Controls.ContentControl> 型\)|  
+    |<xref:System.Windows.Controls.ItemsPresenter>|Type\-based|<xref:System.Windows.Controls.ListBox>、<xref:System.Windows.Controls.ComboBox>、<xref:System.Windows.Controls.Menu> など \(いずれも <xref:System.Windows.Controls.ItemsControl> 型\)|  
+    |<xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel>|Named|<xref:System.Windows.Controls.ToolBar>|  
+    |<xref:System.Windows.Controls.Primitives.Popup>|Standalone|<xref:System.Windows.Controls.ComboBox>、<xref:System.Windows.Controls.ToolBar>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.ToolTip> など|  
+    |<xref:System.Windows.Controls.Primitives.RepeatButton>|Named|<xref:System.Windows.Controls.Slider>、<xref:System.Windows.Controls.Primitives.ScrollBar> など|  
+    |<xref:System.Windows.Controls.Primitives.ScrollBar>|Named|<xref:System.Windows.Controls.ScrollViewer>|  
+    |<xref:System.Windows.Controls.ScrollViewer>|Standalone|<xref:System.Windows.Controls.ListBox>、<xref:System.Windows.Controls.ComboBox>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.Frame> など|  
+    |<xref:System.Windows.Controls.Primitives.TabPanel>|Standalone|<xref:System.Windows.Controls.TabControl>|  
+    |<xref:System.Windows.Controls.TextBox>|Named|<xref:System.Windows.Controls.ComboBox>|  
+    |<xref:System.Windows.Controls.Primitives.TickBar>|Type\-based|<xref:System.Windows.Controls.Slider>|  
+  
+-   **ヘルパー要素で必要となるユーザー指定のバインディングまたはプロパティ設定は最小限に抑えます。** 一般に、ヘルパー要素がコントロール テンプレート内で正しく機能するためには、一定のバインディングまたはプロパティ設定が必要となります。  これらの設定は、できる限りヘルパー要素と template 宣言されたコントロールで設定する必要があります。  プロパティの設定やバインディングの確立の際には、ユーザーが設定した値をオーバーライドしないように注意してください。  具体的なベスト プラクティスは次のとおりです。  
+  
+    -   Named ヘルパー要素は親によって識別されるようにします。また、親がこのヘルパー要素に対して必要なすべての設定を設定するようにします。  
+  
+    -   Type\-based ヘルパー要素は、必要なすべての設定を直接それ自身に対して設定するようにします。  そのためには、ヘルパー要素が、その要素が使用されている情報コンテキストを照会する必要があります。これには、その `TemplatedParent` \(ヘルパー要素が使用されているテンプレートのコントロール型\) も含まれます。  たとえば、<xref:System.Windows.Controls.ContentPresenter> は、<xref:System.Windows.Controls.ContentControl> 派生型で使用されるときに、自動的にその `TemplatedParent` の `Content` プロパティをその <xref:System.Windows.Controls.ContentPresenter.Content%2A> プロパティにバインドします。  
+  
+    -   Standalone ヘルパー要素は上記の方法で最適化できません。これは、本質的にヘルパー要素と親が互いを認識しないためです。  
+  
+-   **Name プロパティを使用してテンプレート内の要素にフラグを設定します。** プログラムから要素にアクセスするためにスタイル内で要素を検索する必要のあるコントロールは、`Name` プロパティと `FindName` パラダイムを使用してその処理を行う必要があります。  要素が見つからなかった場合、コントロールは例外をスローするのではなく、その要素を必要としていた機能を通知することなく正常に無効にする必要があります。  
+  
+-   **スタイルでコントロールの状態と動作を表すためのベスト プラクティスに従います。**次に示すのは、スタイルでコントロールの状態の変更と動作を表すためのベスト プラクティスを順序付けた一覧です。  自分のシナリオに合うリスト内の最初の項目を使用してください。  
+  
+    1.  プロパティのバインディング。  たとえば、<xref:System.Windows.Controls.ComboBox.IsDropDownOpen%2A?displayProperty=fullName> と <xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A?displayProperty=fullName> のバインディングがあります。  
+  
+    2.  トリガーされるプロパティの変更またはプロパティ アニメーション。  たとえば、<xref:System.Windows.Controls.Button> のホバー状態があります。  
+  
+    3.  コマンド。  たとえば、<xref:System.Windows.Controls.Primitives.ScrollBar> の <xref:System.Windows.Controls.Primitives.ScrollBar.LineUpCommand> や <xref:System.Windows.Controls.Primitives.ScrollBar.LineDownCommand> があります。  
+  
+    4.  Standalone ヘルパー要素。  たとえば、<xref:System.Windows.Controls.TabControl> の <xref:System.Windows.Controls.Primitives.TabPanel> があります。  
+  
+    5.  Type\-based ヘルパー要素。  たとえば、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ContentPresenter> や <xref:System.Windows.Controls.Slider> の <xref:System.Windows.Controls.Primitives.TickBar> があります。  
+  
+    6.  Named ヘルパー要素。  たとえば、<xref:System.Windows.Controls.ComboBox> の <xref:System.Windows.Controls.TextBox> があります。  
+  
+    7.  Named ヘルパー要素からバブリングされるイベント。  スタイル要素からバブリングされたイベントをリッスンする場合は、イベントを生成する要素を一意に識別できる必要があります。  たとえば、<xref:System.Windows.Controls.ToolBar> の <xref:System.Windows.Controls.Primitives.Thumb> があります。  
+  
+    8.  カスタムの `OnRender` 動作。  たとえば、<xref:System.Windows.Controls.Button> の <xref:Microsoft.Windows.Themes.ButtonChrome> があります。  
+  
+-   **スタイル トリガー \(テンプレート トリガーとは対照的に\) を多用しないようにします。** テンプレート内の要素のプロパティに影響するトリガーは、テンプレート内で宣言する必要があります。  コントロールのプロパティに影響するトリガー \(`TargetName` なし\) は、テンプレート変更時にトリガーの破棄も必要である場合を除いて、スタイルで宣言できます。  
+  
+-   **既存のスタイル パターンとの一貫性を維持します。**多くの場合、問題には複数の解決方法があります。  既存のコントロール スタイル パターンを認識し、できればそれらのパターンとの一貫性を維持してください。  特に、同じ基本型から派生したコントロールの場合 \(<xref:System.Windows.Controls.ContentControl>、<xref:System.Windows.Controls.ItemsControl>、<xref:System.Windows.Controls.Primitives.RangeBase> など\) はこれが重要になります。  
+  
+-   **プロパティを公開して、テンプレートを再設定しなくても一般的なカスタマイズ シナリオに対応できるようにします。** [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ではプラグ可能なパーツやカスタマイズ可能なパーツがサポートされないため、コントロールのユーザーがカスタマイズを行うには、プロパティを直接設定するか、スタイルを使用してプロパティを設定するかという 2 つの方法しかありません。  この点を考慮すると、通常はテンプレートの再設定が必要になるようなカスタマイズ シナリオのうち、頻繁に使用される優先度の高いシナリオを対象として、限られた数のプロパティを公開するのが適切です。  カスタマイズ シナリオを有効にするタイミングと方法に関するベスト プラクティスを次に示します。  
+  
+    -   一般性が高いカスタマイズは、コントロールのプロパティとして公開し、テンプレートで使用されるようにします。  
+  
+    -   まれではないものの一般性が低いカスタマイズは、添付プロパティとして公開し、テンプレートで使用されるようにします。  
+  
+    -   認識されていてもまれにしか行われないカスタマイズは、テンプレートの再設定を必要としてもかまいません。  
+  
+<a name="Theme_Considerations"></a>   
+## テーマに関する考慮事項  
+  
+-   **テーマ スタイルは、プロパティのセマンティクスをすべてのテーマで一貫させるようにする必要がありますが、それに対する保証は行わないようにします。** コントロールには、そのドキュメントの一部として、コントロールのプロパティ セマンティクス、つまりコントロールのプロパティの "意味" について説明したドキュメントが必要です。  たとえば、<xref:System.Windows.Controls.ComboBox> コントロールは、<xref:System.Windows.Controls.ComboBox> における <xref:System.Windows.Controls.Control.Background%2A> プロパティの意味を定義する必要があります。  コントロールの既定のスタイルは、このドキュメントに定義されているセマンティクスに、すべてのテーマで従うようにする必要があります。  これに対しコントロールのユーザーは、そのプロパティ セマンティクスがテーマごとに変わる可能性があるので注意する必要があります。  場合によっては、特定のテーマで要求される視覚上の制約によって、指定されたプロパティを表現できないこともあります   \(たとえば、クラシック テーマには、多くのコントロールで `Thickness` を適用できる一重罫線が使用されません\)。  
+  
+-   **テーマ スタイルのトリガー セマンティクスは、すべてのテーマで一貫させる必要はありません。** コントロール スタイルがトリガーまたはアニメーションを通して公開する動作は、テーマごとに異なっていてもかまいません。  コントロールのユーザーは、コントロールが特定の動作を実現するためにすべてのテーマで同じ機構を採用するとは限らないので注意をする必要があります。  たとえば、あるテーマがマウス ポインターを上に置いた場合の動作を表現するためにアニメーションを使用する一方で、別のテーマはトリガーを使用する可能性があります。  これにより、カスタマイズされたコントロールでの動作の保持に一貫性がなくなる場合があります   \(たとえば、コントロールの選択状態がトリガーを使用して表現されている場合は、Background プロパティを変更してもその状態には影響しません。  一方、選択状態がアニメーションを使用して実装されている場合に Background プロパティを変更すると、アニメーションが修復できないほど破壊され、状態の遷移が不可能になるおそれがあります\)。  
+  
+-   **テーマ スタイルでは、"レイアウト" セマンティクスをすべてのテーマで一貫させる必要はありません。** たとえば、コントロールの占有するサイズがすべてのテーマで同じになることを既定のスタイルで保証する必要はありません。あるいは、コントロールのコンテンツの余白やパディングがすべてのテーマで同じになることを保証する必要もありません。  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-add-a-watermark-to-a-textbox.md b/docs/framework/wpf/controls/how-to-add-a-watermark-to-a-textbox.md
new file mode 100644
index 00000000000..f544c2c5847
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-add-a-watermark-to-a-textbox.md
@@ -0,0 +1,38 @@
+---
+title: "方法: TextBox にウォーターマークを追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "背景イメージを使用して TextBox の操作性を高める [WPF]"
+  - "表示 (ユーザー入力を支援するためにテキスト ボックス内に背景イメージを) [WPF]"
+ms.assetid: df89bdd8-a0fb-45e0-b312-dd53332d01a8
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: TextBox にウォーターマークを追加する
+<xref:System.Windows.Controls.TextBox> 内に説明の背景イメージを表示することによって <xref:System.Windows.Controls.TextBox> の操作性を高める方法を次の例に示します。この背景イメージは、ユーザーがテキストを入力するまで表示され、入力が行われた時点で削除されます。  また、背景イメージは、ユーザーが入力を削除すると、再び復元されます。  次の図を参照してください。  
+  
+ ![背景イメージを含む TextBox](../../../../docs/framework/wpf/controls/media/editing-textbox-using-background-image.png "Editing\_TextBox\_using\_background\_image")  
+  
+> [!NOTE]
+>  この例では、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.Controls.TextBox.Text%2A> プロパティを操作するのではなく、背景イメージが使用されています。それは、背景イメージがデータ バインディングに干渉しないためです。  
+  
+## 使用例  
+ [!code-xml[TextBoxMiscSnippets_snip#TextBoxBackgroundExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/textbox_with_background_image.xaml#textboxbackgroundexamplewholepage)]  
+  
+ [!code-csharp[TextBoxMiscSnippets_snip#TextBoxBackgroundCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/textbox_with_background_image.xaml.cs#textboxbackgroundcodeexamplewholepage)]
+ [!code-vb[TextBoxMiscSnippets_snip#TextBoxBackgroundCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/visualbasic/textbox_with_background_image.xaml.vb#textboxbackgroundcodeexamplewholepage)]  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-add-row-details-to-a-datagrid-control.md b/docs/framework/wpf/controls/how-to-add-row-details-to-a-datagrid-control.md
new file mode 100644
index 00000000000..69402369052
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-add-row-details-to-a-datagrid-control.md
@@ -0,0 +1,73 @@
+---
+title: "方法: DataGrid コントロールに行の詳細を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataGrid [WPF], 行の詳細"
+  - "DataTemplate [WPF], DataGrid"
+  - "行の詳細 [WPF], DataGrid"
+ms.assetid: 0bdc6f50-9b4c-483f-9df6-a47a1fde998b
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: DataGrid コントロールに行の詳細を追加する
+<xref:System.Windows.Controls.DataGrid> コントロールを使用するときに、行の詳細セクションを追加して、データ表示をカスタマイズできます。  行の詳細セクションを追加すると、テンプレート内のデータをグループ化して、必要に応じて表示と非表示を切り替えることができます。  たとえば、<xref:System.Windows.Controls.DataGrid> 内の各行の概要のみを表示する <xref:System.Windows.Controls.DataGrid> に行の詳細を追加して、ユーザーが行を選択したときに詳細なデータ フィールドが表示されるようにします。  <xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> プロパティの行の詳細セクションに対して、テンプレートを定義します。  次の図に、行の詳細セクションの例を示します。  
+  
+ ![行の詳細を表示する DataGrid](../../../../docs/framework/wpf/controls/media/ndp-rowdetails.png "NDP\_RowDetails")  
+  
+ 行の詳細テンプレートは、インライン XAML またはリソースとして定義します。  両方の手順について次に示します。  リソースとして追加されたテンプレートは、テンプレートを再作成しなくてもプロジェクト全体で使用できます。  インライン XAML として追加されたデータ テンプレートは、それが定義されているコントロールからのみアクセスできます。  
+  
+### インライン XAML を使用して行の詳細を表示するには  
+  
+1.  データ ソースのデータを表示する <xref:System.Windows.Controls.DataGrid> を作成します。  
+  
+2.  <xref:System.Windows.Controls.DataGrid> 要素に、<xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> 要素を追加します。  
+  
+3.  行の詳細セクションの外観を定義する <xref:System.Windows.DataTemplate> を作成します。  
+  
+     次の XAML は、<xref:System.Windows.Controls.DataGrid>、および <xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> をインラインで定義する方法を示しています。  <xref:System.Windows.Controls.DataGrid> は、各行内の 3 つの値、および行が選択されたときにさらに表示される 3 つの値を表示します。  
+  
+     [!code-xml[DataGrid_RowDetails#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_rowdetails/cs/mainwindow.xaml#1)]  
+  
+     次のコードは、<xref:System.Windows.Controls.DataGrid> に表示されるデータを選択する際に使用されるクエリを示しています。  この例では、クエリによって、顧客情報を含むエンティティのデータが選択されます。  
+  
+     [!code-csharp[DataGrid_RowDetails#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_rowdetails/cs/mainwindow.xaml.cs#2)]
+     [!code-vb[DataGrid_RowDetails#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/datagrid_rowdetails/vb/mainwindow.xaml.vb#2)]  
+  
+### リソースを使用して行の詳細を表示するには  
+  
+1.  データ ソースのデータを表示する <xref:System.Windows.Controls.DataGrid> を作成します。  
+  
+2.  <xref:System.Windows.FrameworkElement.Resources%2A> 要素を <xref:System.Windows.Window> コントロールや <xref:System.Windows.Controls.Page> コントロールなどのルート要素に追加するか、または <xref:System.Windows.Application.Resources%2A> 要素を App.xaml \(または Application.xaml\) ファイル内の <xref:System.Windows.Application> クラスに追加します。  
+  
+3.  リソース要素に、行の詳細セクションの外観を定義する <xref:System.Windows.DataTemplate> を作成します。  
+  
+     次の XAML は、<xref:System.Windows.Application> クラスに定義された <xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> を示しています。  
+  
+     [!code-xml[DataGrid_RowDetails#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_rowdetails/cs/app.xaml#3)]  
+  
+4.  <xref:System.Windows.DataTemplate> で、[x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md) に、データ テンプレートを一意に識別する値を設定します。  
+  
+5.  <xref:System.Windows.Controls.DataGrid> 要素で、<xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> プロパティを、前の手順で定義したリソースに設定します。  リソースを静的リソースとして割り当てます。  
+  
+     次の XAML は、<xref:System.Windows.Controls.DataGrid.RowDetailsTemplate%2A> プロパティが前の例のリソースに設定された状態を示しています。  
+  
+     [!code-xml[DataGrid_RowDetails#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_rowdetails/cs/window2.xaml#4)]  
+  
+### 行の詳細の表示を設定し、水平方向にスクロールできないようにするには  
+  
+1.  必要に応じて、<xref:System.Windows.Controls.DataGrid.RowDetailsVisibilityMode%2A> プロパティを <xref:System.Windows.Controls.DataGridRowDetailsVisibilityMode> の値に設定します。  
+  
+     既定では、値は <xref:System.Windows.Controls.DataGridRowDetailsVisibilityMode> に設定されます。  すべての行の詳細を表示するには、この値を <xref:System.Windows.Controls.DataGridRowDetailsVisibilityMode> に設定し、すべての行の詳細を非表示にするには、この値を <xref:System.Windows.Controls.DataGridRowDetailsVisibilityMode> に設定します。  
+  
+2.  必要に応じて、<xref:System.Windows.Controls.DataGrid.AreRowDetailsFrozen%2A> プロパティを `true` に設定して、行の詳細セクションを水平方向にスクロールできないようにします。
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-adorn-the-children-of-a-panel.md b/docs/framework/wpf/controls/how-to-adorn-the-children-of-a-panel.md
new file mode 100644
index 00000000000..c5b196183ce
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-adorn-the-children-of-a-panel.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : パネルの子を装飾する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾, バインド (パネルの子に)"
+  - "Panel コントロール, バインド (子に装飾を)"
+ms.assetid: 4cc9b972-b472-4e5c-bdf3-3702d7fbb1f5
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : パネルの子を装飾する
+この例では、指定した <xref:System.Windows.Controls.Panel> の子にプログラムによって装飾をバインドする方法を示します。  
+  
+## 使用例  
+ Adorner を <xref:System.Windows.Controls.Panel> の子にバインドするには、次の手順を実行します。  
+  
+1.  新しい <xref:System.Windows.Documents.AdornerLayer> オブジェクトを宣言し、`static` <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> メソッドを呼び出して、子が装飾の対象となる要素の装飾層を検出します。  
+  
+2.  親要素の子を列挙し、<xref:System.Windows.Documents.AdornerLayer.Add%2A> メソッドを呼び出して Adorner を各子要素にバインドします。  
+  
+ 次の例では、SimpleCircleAdorner \(前述\) を <xref:System.Windows.Controls.StackPanel> の子 \(名前は *myStackPanel*\) にバインドしています。  
+  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_AdornChildren](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_adornchildren)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_AdornChildren](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_adornchildren)]  
+  
+> [!NOTE]
+>  Adorner を別の要素にバインドするために [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用することは、現在サポートされていません。  
+  
+## 参照  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-animate-a-borderthickness-value.md b/docs/framework/wpf/controls/how-to-animate-a-borderthickness-value.md
new file mode 100644
index 00000000000..b9023e4d9a9
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-animate-a-borderthickness-value.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : BorderThickness 値をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 変更 (境界線の太さの)"
+  - "境界線の太さ, アニメーション化 (変更を)"
+ms.assetid: fd021978-f74b-4e7b-a7f7-3987dcad9e0f
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : BorderThickness 値をアニメーション化する
+この例は、<xref:System.Windows.Media.Animation.ThicknessAnimation> クラスを使用して境界線の太さ変更をアニメーション化する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.ThicknessAnimation> を使用して境界線の太さをアニメーション化する例を次に示します。  この例では、<xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Border.BorderThickness%2A> プロパティを使用します。  
+  
+ [!code-csharp[BasicAnimations_snip#ThicknessAnimationWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BasicAnimations_snip/CSharp/ThicknessAnimationExample.cs#thicknessanimationwholepage)]
+ [!code-vb[BasicAnimations_snip#ThicknessAnimationWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BasicAnimations_snip/VisualBasic/ThicknessAnimationExample.vb#thicknessanimationwholepage)]  
+  
+ サンプル全体については、[アニメーション サンプル ギャラリー](http://go.microsoft.com/fwlink/?LinkID=159969)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.ThicknessAnimation>   
+ <xref:System.Windows.Controls.Border.BorderThickness%2A>   
+ <xref:System.Windows.Controls.Border>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)   
+ [キー フレームを使用して境界線の太さをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-thickness-of-a-border-by-using-key-frames.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-animate-a-popup.md b/docs/framework/wpf/controls/how-to-animate-a-popup.md
new file mode 100644
index 00000000000..5d8612b2da9
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-animate-a-popup.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : ポップアップをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ポップアップ コントロール"
+  - "Popup コントロール, アニメーション化"
+ms.assetid: acaa2a0a-6137-4efd-9cd1-75ece222e390
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ポップアップをアニメーション化する
+ここでは、<xref:System.Windows.Controls.Primitives.Popup> コントロールをアニメーション化する 2 つの方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Primitives.PopupAnimation> プロパティを <xref:System.Windows.Controls.Primitives.PopupAnimation> の値に設定して、<xref:System.Windows.Controls.Primitives.Popup> を "スライド イン" させながら表示する例を次に示します。  
+  
+ <xref:System.Windows.Controls.Primitives.Popup> を回転させるため、この例では <xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Controls.Canvas> \(<xref:System.Windows.Controls.Primitives.Popup> の子要素\) の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに割り当てています。  
+  
+ この変換が正常に動作するためには、<xref:System.Windows.Controls.Primitives.Popup.AllowsTransparency%2A> プロパティを `true` に設定する必要があります。  また、<xref:System.Windows.Controls.Canvas> コンテンツの <xref:System.Windows.FrameworkElement.Margin%2A> で、<xref:System.Windows.Controls.Primitives.Popup> が回転するのに十分な領域を指定する必要があります。  
+  
+ [!code-xml[AnimatedPopup#RotateTransform2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimatedPopup/CS/Window1.xaml#rotatetransform2)]  
+  
+ <xref:System.Windows.Controls.Button> をクリックすると発生する <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントが、アニメーションを開始する <xref:System.Windows.Media.Animation.Storyboard> をトリガーする方法を次の例に示します。  
+  
+ [!code-xml[AnimatedPopup#RotateTransform1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimatedPopup/CS/Window1.xaml#rotatetransform1)]  
+  
+## 参照  
+ <xref:System.Windows.UIElement.RenderTransform%2A>   
+ <xref:System.Windows.Controls.Primitives.BulletDecorator>   
+ <xref:System.Windows.Media.RotateTransform>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ <xref:System.Windows.Controls.Primitives.Popup>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)   
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-apply-stretch-properties-to-the-contents-of-a-viewbox.md b/docs/framework/wpf/controls/how-to-apply-stretch-properties-to-the-contents-of-a-viewbox.md
new file mode 100644
index 00000000000..4a5ee09f537
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-apply-stretch-properties-to-the-contents-of-a-viewbox.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : Viewbox のコンテンツに Stretch プロパティを適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, Viewbox"
+  - "Stretch プロパティ"
+  - "StretchDirection プロパティ"
+  - "Viewbox コントロール"
+ms.assetid: b9c22ef4-bce4-4300-9e0c-8260b7db83cc
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Viewbox のコンテンツに Stretch プロパティを適用する
+## 使用例  
+ この例では、<xref:System.Windows.Controls.Viewbox> の <xref:System.Windows.Controls.Viewbox.StretchDirection%2A> プロパティの値と <xref:System.Windows.Controls.Viewbox.Stretch%2A> プロパティの値を変更する方法を示します。  
+  
+ 最初の例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して <xref:System.Windows.Controls.Viewbox> 要素を定義します。  ここでは、400 の <xref:System.Windows.FrameworkElement.MaxWidth%2A> と 400 の <xref:System.Windows.FrameworkElement.MaxHeight%2A> を割り当てます。  この例では、<xref:System.Windows.Controls.Image> 要素を <xref:System.Windows.Controls.Viewbox> 内に入れ子にします。  <xref:System.Windows.Controls.Viewbox.Stretch%2A> 列挙体と <xref:System.Windows.Controls.StretchDirection> 列挙体のプロパティ値に対応する <xref:System.Windows.Controls.Button> 要素は、入れ子になった <xref:System.Windows.Controls.Image> の伸縮動作を操作します。  
+  
+ [!code-xml[viewboxStretchLayoutSamp#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/viewboxStretchLayoutSamp/CSharp/Window1.xaml#1)]  
+  
+ 次の分離コード ファイルは、前の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例で定義した <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを処理します。  
+  
+ [!code-csharp[viewboxStretchLayoutSamp#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/viewboxStretchLayoutSamp/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[viewboxStretchLayoutSamp#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/viewboxStretchLayoutSamp/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Viewbox>   
+ <xref:System.Windows.Media.Stretch>   
+ <xref:System.Windows.Controls.StretchDirection>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-bind-a-listbox-to-data.md b/docs/framework/wpf/controls/how-to-bind-a-listbox-to-data.md
new file mode 100644
index 00000000000..7dc33eaa856
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-bind-a-listbox-to-data.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : ListBox にデータをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), ListBox コントロール"
+  - "データ バインディング, ListBox コントロール"
+  - "ListBox コントロール, バインド (データを)"
+ms.assetid: de93a907-709a-44a7-84bf-578b846a3d8b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ListBox にデータをバインドする
+アプリケーション開発者は、各 <xref:System.Windows.Controls.ListBoxItem> のコンテンツを個別に指定することなく、<xref:System.Windows.Controls.ListBox> コントロールを作成することができます。  データ バインディングを使用して、個々の項目にデータをバインドできます。  
+  
+ *Colors* というデータ ソースにデータをバインドすることにより、<xref:System.Windows.Controls.ListBoxItem> 要素を設定する <xref:System.Windows.Controls.ListBox> の作成方法を次の例に示します。  この場合、<xref:System.Windows.Controls.ListBoxItem> タグを使用して各項目のコンテンツを指定する必要はありません。  
+  
+## 使用例  
+ [!code-xml[ListBoxEvent#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxEvent/CSharp/Pane1.xaml#7)]  
+[!code-xml[ListBoxEvent#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxEvent/CSharp/Pane1.xaml#3)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListBox>   
+ <xref:System.Windows.Controls.ListBoxItem>   
+ [コントロール](../../../../docs/framework/wpf/advanced/optimizing-performance-controls.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-bind-a-treeview-to-data-that-has-an-indeterminable-depth.md b/docs/framework/wpf/controls/how-to-bind-a-treeview-to-data-that-has-an-indeterminable-depth.md
new file mode 100644
index 00000000000..9dc9de073ab
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-bind-a-treeview-to-data-that-has-an-indeterminable-depth.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 深度がわからないデータに TreeView をバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TreeView コントロール [WPF], バインド (深さがわからないデータに)"
+ms.assetid: daddcd74-1b0f-4ffd-baeb-ec934c5e0f53
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 深度がわからないデータに TreeView をバインドする
+深度がわからないデータ ソースに <xref:System.Windows.Controls.TreeView> をバインドすることが必要になる場合があります。  たとえば、フォルダー内にフォルダーが含まれる可能性のあるファイル システムなど、データが再帰的な性質を持つ場合や、従業員が他の従業員を直属の部下として持つ企業の組織構造などの場合があります。  
+  
+ データ ソースには階層的なオブジェクト モデルが必要です。  たとえば、`Employee` には、従業員の直属の部下である Employee オブジェクトのコレクションが含まれることが考えられます。  データが階層的ではない方法で表現されている場合は、そのデータの階層的な表現を作成する必要があります。  
+  
+ <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A?displayProperty=fullName> プロパティを設定するときに、<xref:System.Windows.Controls.ItemsControl> がそれぞれの子項目用に <xref:System.Windows.Controls.ItemsControl> を生成する場合、子の <xref:System.Windows.Controls.ItemsControl> は親と同じ <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> を使用します。  たとえば、<xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> プロパティをデータ バインド <xref:System.Windows.Controls.TreeView> に設定する場合、生成される各 <xref:System.Windows.Controls.TreeViewItem> は、<xref:System.Windows.Controls.TreeView> の <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> プロパティに割り当てられた <xref:System.Windows.DataTemplate> を使用します。  
+  
+ <xref:System.Windows.HierarchicalDataTemplate> は、データ テンプレートで、<xref:System.Windows.Controls.TreeViewItem> 用の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A>、または任意の <xref:System.Windows.Controls.HeaderedItemsControl> を指定できるようにします。  <xref:System.Windows.HierarchicalDataTemplate.ItemsSource%2A?displayProperty=fullName> プロパティを設定すると、<xref:System.Windows.HierarchicalDataTemplate> の適用時にその値が使用されます。  <xref:System.Windows.HierarchicalDataTemplate> を使用することによって、<xref:System.Windows.Controls.TreeView> 内の各 <xref:System.Windows.Controls.TreeViewItem> 用に <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> を再帰的に設定できます。  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Controls.TreeView> を階層データにバインドし、<xref:System.Windows.HierarchicalDataTemplate> を使用して各 <xref:System.Windows.Controls.TreeViewItem> 用に <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> を指定する方法を示しています。  <xref:System.Windows.Controls.TreeView> は、社内の従業員を表す XML データにバインドします。  各 `Employee` 要素に他の `Employee` 要素を含めることによって、だれがだれの部下であるかを示すことができます。  データは再帰的であるため、<xref:System.Windows.HierarchicalDataTemplate> を各レベルに適用することができます。  
+  
+ [!code-xml[TreeViewWithUnknownDepth#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewWithUnknownDepth/CS/Window1.xaml#1)]  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-bind-an-adorner-to-an-element.md b/docs/framework/wpf/controls/how-to-bind-an-adorner-to-an-element.md
new file mode 100644
index 00000000000..82f91767e94
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-bind-an-adorner-to-an-element.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : 要素に装飾をバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾, バインド (指定した UIElement に)"
+  - "UIElements, バインド (装飾を)"
+ms.assetid: b2101611-a0ee-4137-bdb8-9b3673d2e6b9
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 要素に装飾をバインドする
+この例では、指定した <xref:System.Windows.UIElement> にプログラムによって装飾をバインドする方法を示します。  
+  
+## 使用例  
+ Adorner を特定の <xref:System.Windows.UIElement> にバインドするには、次の手順を実行します。  
+  
+1.  `static` メソッド <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> を呼び出し、修飾対象の <xref:System.Windows.UIElement> の <xref:System.Windows.Documents.AdornerLayer> オブジェクトを取得します。  <xref:System.Windows.Documents.AdornerLayer.GetAdornerLayer%2A> は、指定した **UIElement** を起点にしてビジュアル ツリーを上方向に検索し、最初に見つかった修飾層を返します。  \(Adorner のレイヤーが見つからない場合は、メソッドにより null が返されます。\)  
+  
+2.  <xref:System.Windows.Documents.AdornerLayer.Add%2A> メソッドを呼び出し、対象の **UIElement** に装飾をバインドします。  
+  
+ 次の例では、SimpleCircleAdorner \(前述\) を <xref:System.Windows.Controls.TextBox> \(名前は *myTextBox*\) にバインドしています。  
+  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_AdornSingleElement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_adornsingleelement)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_AdornSingleElement](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_adornsingleelement)]  
+  
+> [!NOTE]
+>  Adorner を別の要素にバインドするために [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用することは、現在サポートされていません。  
+  
+## 参照  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-build-a-standard-ui-dialog-box-by-using-grid.md b/docs/framework/wpf/controls/how-to-build-a-standard-ui-dialog-box-by-using-grid.md
new file mode 100644
index 00000000000..600902b0e2d
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-build-a-standard-ui-dialog-box-by-using-grid.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : グリッドを使用して標準 UI ダイアログ ボックスをビルドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ダイアログ ボックス, 作成"
+  - "グリッド コントロール, 作成, ダイアログ ボックス"
+ms.assetid: d6ac3d51-844b-4d29-96d8-81a696a7b960
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : グリッドを使用して標準 UI ダイアログ ボックスをビルドする
+この例では、<xref:System.Windows.Controls.Grid> 要素を使用して、標準の[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] ダイアログ ボックスを作成する方法を示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] オペレーティング システムの **\[ファイル名を指定して実行\]** ダイアログ ボックスに似たダイアログ ボックスを作成する例を次に示します。  
+  
+ この例では、<xref:System.Windows.Controls.Grid> を作成し、<xref:System.Windows.Controls.ColumnDefinition> クラスおよび <xref:System.Windows.Controls.RowDefinition> クラスを使用して、5 つの列と 4 つの行を定義しています。  
+  
+ 次に、ダイアログ ボックスに表示するイメージを表すために、`RunIcon.png` という <xref:System.Windows.Controls.Image> を追加して配置します。  このイメージは、<xref:System.Windows.Controls.Grid> の第 1 列、第 1 行 \(左上隅\) に配置します。  
+  
+ 次に、<xref:System.Windows.Controls.TextBlock> 要素を第 1 列に追加します。これは、第 1 行の最後の列までまたがります。  さらに、別の <xref:System.Windows.Controls.TextBlock> 要素を第 1 列、第 2 行に追加します。これは \[Open\] ボックスを表します。  その後に、もう一つ <xref:System.Windows.Controls.TextBlock> を追加します。これはデータ入力領域を表します。  
+  
+ 最後に、**OK**、**Cancel**、および **Browse** の各イベントを表す 3 つの <xref:System.Windows.Controls.Button> 要素を最終行に追加します。  
+  
+ [!code-csharp[GridRunDialog#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridRunDialog/CSharp/window1.xaml.cs#1)]
+ [!code-vb[GridRunDialog#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GridRunDialog/VisualBasic/grid_vb.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ <xref:System.Windows.GridUnitType>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/grid-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-change-the-horizontal-alignment-of-a-column-in-a-listview.md b/docs/framework/wpf/controls/how-to-change-the-horizontal-alignment-of-a-column-in-a-listview.md
new file mode 100644
index 00000000000..b64050c8df0
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-change-the-horizontal-alignment-of-a-column-in-a-listview.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : ListView の列の水平方向の配置を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール, 水平方向の配置"
+ms.assetid: b9573e44-9dad-4d14-939c-7859ca372758
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : ListView の列の水平方向の配置を変更する
+既定では、<xref:System.Windows.Controls.ListViewItem> の各列の内容は左揃えで表示されます。  <xref:System.Windows.DataTemplate> を使用し、<xref:System.Windows.DataTemplate> 内の要素の <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティを設定すると、各列の配置を変更できます。  このトピックでは、<xref:System.Windows.Controls.ListView> の内容の既定の配置について、および <xref:System.Windows.Controls.ListView> の特定の列の配置を変更する方法について説明します。  
+  
+## 使用例  
+ 次の例では、`Title` 列および `ISBN` 列のデータは左揃えです。  
+  
+ [!code-xml[ListViewHowTos#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#1)]  
+[!code-xml[ListViewHowTos#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#2)]  
+  
+ `ISBN` 列の配置を変更するには、各 <xref:System.Windows.Controls.ListViewItem> の <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> プロパティを <xref:System.Windows.HorizontalAlignment> に設定する必要があります。こうすると、各 <xref:System.Windows.Controls.ListViewItem> の要素を各列の幅全体に広げて配置できます。  <xref:System.Windows.Controls.ListView> はデータ ソースにバインドされているため、<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> を設定するスタイルを作成する必要があります。  次に、<xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> プロパティではなく <xref:System.Windows.DataTemplate> を使用して内容を表示する必要があります。  各テンプレートの `ISBN` を表示するために <xref:System.Windows.DataTemplate> に必要なのは、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティを <xref:System.Windows.HorizontalAlignment> に設定した <xref:System.Windows.Controls.TextBlock> のみです。  
+  
+ 次の例では、`ISBN` 列を右揃えにするために必要なスタイルと <xref:System.Windows.DataTemplate> を定義し、<xref:System.Windows.Controls.GridViewColumn> を変更して <xref:System.Windows.DataTemplate> を参照しています。  
+  
+ [!code-xml[ListViewHowTos#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#3)]  
+[!code-xml[ListViewHowTos#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#4)]  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-choose-between-stackpanel-and-dockpanel.md b/docs/framework/wpf/controls/how-to-choose-between-stackpanel-and-dockpanel.md
new file mode 100644
index 00000000000..01b641638c5
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-choose-between-stackpanel-and-dockpanel.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : StackPanel または DockPanel を選択する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], DockPanel"
+  - "コントロール [WPF], StackPanel"
+  - "DockPanel コントロール, StackPanel コントロールとの比較"
+  - "StackPanel コントロール, DockPanel コントロールとの比較"
+ms.assetid: f9239086-451f-42e6-81f7-ef89ef349742
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : StackPanel または DockPanel を選択する
+この例では、<xref:System.Windows.Controls.Panel> のコンテンツをスタックする場合に、<xref:System.Windows.Controls.StackPanel> または <xref:System.Windows.Controls.DockPanel> のどちらを使用するかを選択する方法を示します。  
+  
+## 使用例  
+ 子要素のスタックには <xref:System.Windows.Controls.DockPanel> または <xref:System.Windows.Controls.StackPanel> のどちらも使用できますが、2 つのコントロールが必ずしも同じ結果を生成するとは限りません。  たとえば、子要素を入力する順序は <xref:System.Windows.Controls.DockPanel> 内の子要素のサイズに影響を与える可能性がありますが、<xref:System.Windows.Controls.StackPanel> 内の子要素のサイズには影響を与えません。  このような動作の違いが発生するのは、<xref:System.Windows.Controls.StackPanel> が <xref:System.Double>.<xref:System.Double.PositiveInfinity> でのスタッキング方向で計測するためです。しかし、<xref:System.Windows.Controls.DockPanel> は使用可能なサイズだけを計測します。  
+  
+ 次の例では、<xref:System.Windows.Controls.DockPanel> と <xref:System.Windows.Controls.StackPanel> の主な相違点を示します。  
+  
+ [!code-cpp[StackPanelOvw4#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/StackPanelOvw4/CPP/StackPanel_Ovw_Sample4.cpp#1)]
+ [!code-csharp[StackPanelOvw4#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StackPanelOvw4/CSharp/StackPanel_Ovw_Sample4.cs#1)]
+ [!code-vb[StackPanelOvw4#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StackPanelOvw4/VisualBasic/StackPanelSamp.vb#1)]
+ [!code-xml[StackPanelOvw4#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/StackPanelOvw4/XAML/default.xaml#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.StackPanel>   
+ <xref:System.Windows.Controls.DockPanel>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-convert-an-image-to-greyscale.md b/docs/framework/wpf/controls/how-to-convert-an-image-to-greyscale.md
new file mode 100644
index 00000000000..0f19115cb19
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-convert-an-image-to-greyscale.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : イメージをグレースケールに変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, FormatConvertedBitmap"
+  - "変換, イメージをグレースケールに"
+  - "FormatConvertedBitmap クラス"
+  - "グレースケール, 変換 (イメージを)"
+  - "イメージ, 変換 (グレースケールに)"
+ms.assetid: 77935ff0-4500-4307-9710-96999dcf579f
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : イメージをグレースケールに変換する
+この例では、<xref:System.Windows.Media.Imaging.FormatConvertedBitmap> を使用してイメージをグレースケールに変換する方法を示します。  
+  
+## 使用例  
+ [!code-xml[ImagingSnippetGallery_snip#FormatConvertedBitmapXamlExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_snip/CS/FormatConvertedBitmapExample.xaml#formatconvertedbitmapxamlexamplewholepage)]  
+  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#FormatConvertedBitmapCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/FormatConvertedBitmapExample.cs#formatconvertedbitmapcodeexamplewholepage)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#FormatConvertedBitmapCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/FormatConvertedBitmapExample.vb#formatconvertedbitmapcodeexamplewholepage)]  
+  
+## 参照  
+ [イメージ要素を使用する](../../../../docs/framework/wpf/controls/how-to-use-the-image-element.md)   
+ [イメージをトリミングする](../../../../docs/framework/wpf/controls/how-to-crop-an-image.md)   
+ [イメージを回転させる](../../../../docs/framework/wpf/controls/how-to-rotate-an-image.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-button-that-has-an-image.md b/docs/framework/wpf/controls/how-to-create-a-button-that-has-an-image.md
new file mode 100644
index 00000000000..04a3669c93e
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-button-that-has-an-image.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : イメージを持つ Button を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Button コントロール [WPF], 作成"
+ms.assetid: 607a193c-4098-4dd8-8dc0-51256cec2020
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : イメージを持つ Button を作成する
+この例では、<xref:System.Windows.Controls.Button> 上にイメージを含める方法を示します。  
+  
+## 使用例  
+ 次の例では、2 つの <xref:System.Windows.Controls.Button> コントロールを作成します。  1 つの <xref:System.Windows.Controls.Button> はテキストを含み、もう 1 つはイメージを含みます。  イメージは data と呼ばれるフォルダーにあります。このフォルダーは、例のプロジェクト フォルダーのサブフォルダーです。  ユーザーがイメージを持つ <xref:System.Windows.Controls.Button> をクリックすると、もう 1 つの <xref:System.Windows.Controls.Button> の背景とテキストが変化します。  
+  
+ この例では、マークアップを使用して <xref:System.Windows.Controls.Button> コントロールを作成しますが、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーはコードで記述します。  
+  
+ [!code-xml[BtnColor#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BtnColor/CSharp/Pane1.xaml#4)]  
+  
+ [!code-csharp[BtnColor#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BtnColor/CSharp/Pane1.xaml.cs#6)]
+ [!code-vb[BtnColor#6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BtnColor/VisualBasic/Pane1.xaml.vb#6)]  
+  
+## 参照  
+ [コントロール](../../../../docs/framework/wpf/controls/index.md)   
+ [コントロール ライブラリ](../../../../docs/framework/wpf/controls/control-library.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-complex-grid.md b/docs/framework/wpf/controls/how-to-create-a-complex-grid.md
new file mode 100644
index 00000000000..50ab56395ce
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-complex-grid.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 複雑なグリッドを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カレンダー, 作成"
+  - "グリッド コントロール, 作成, 複雑なグリッド"
+  - "月別カレンダー, 作成"
+ms.assetid: 4ce3040a-a156-4364-9596-98ca1eca5550
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 複雑なグリッドを作成する
+この例では、<xref:System.Windows.Controls.Grid> を使用して月別カレンダーと同様のレイアウトを作成する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Controls.RowDefinition> クラスと <xref:System.Windows.Controls.ColumnDefinition> クラスを使用して、8 つの行と 8 つの列を定義します。  <xref:System.Windows.Controls.Grid.ColumnSpan%2A?displayProperty=fullName> 添付プロパティと <xref:System.Windows.Controls.Grid.RowSpan%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Shapes.Rectangle> 要素と共に使用し、さまざまな列と行の背景を塗りつぶします。  このようなデザインが可能なのは、<xref:System.Windows.Controls.Grid> 内の各セルに複数の要素が存在できるためです。これは、<xref:System.Windows.Controls.Grid> と <xref:System.Windows.Documents.Table> の本質的な違いです。  
+  
+ この例では、カレンダーの見た目を良くし、読みやすくするために、垂直グラデーションを使用して列と行を塗りつぶします \(<xref:System.Windows.Shapes.Shape.Fill%2A>\)。  スタイル設定された <xref:System.Windows.Controls.TextBlock> 要素は、日付と曜日を表します。  <xref:System.Windows.Controls.TextBlock> 要素は、<xref:System.Windows.FrameworkElement.Margin%2A> プロパティと、アプリケーションのスタイル内で定義された配置プロパティを使用して、それぞれのセル内の絶対位置に配置されます。  
+  
+ [!code-xml[GridComplex#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridComplex/CS/default.xaml#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ <xref:System.Windows.Documents.TableCell>   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-control-that-has-an-access-key-and-text-wrapping.md b/docs/framework/wpf/controls/how-to-create-a-control-that-has-an-access-key-and-text-wrapping.md
new file mode 100644
index 00000000000..8a8d1ea2c26
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-control-that-has-an-access-key-and-text-wrapping.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : アクセス キーおよびテキスト折り返し機能を持つコントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アクセス キー, コントロール"
+  - "コントロール, アクセス キー"
+  - "コントロール, テキストの折り返し"
+  - "キー, コントロール"
+  - "テキストの折り返し"
+  - "折り返し (テキストを)"
+ms.assetid: 205099d9-2551-4302-a25e-a15af9f67e04
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : アクセス キーおよびテキスト折り返し機能を持つコントロールを作成する
+この例では、[アクセス キー](GTMT)を持ち、テキストの折り返しをサポートするコントロールを作成する方法を示します。  これらの概念を示すために、例では <xref:System.Windows.Controls.Label> コントロールを使用します。  
+  
+## 使用例  
+ **ラベルにテキストの折り返し機能を追加する**  
+  
+ <xref:System.Windows.Controls.Label> コントロールは、テキストの折り返しをサポートしません。  複数行にわたって折り返すラベルが必要な場合は、テキストの折り返しをサポートする別の要素を入れ子にして、その要素をラベルの内部に配置します。  複数のテキスト行にわたって折り返すラベルを <xref:System.Windows.Controls.TextBlock> を使用して作成する方法を次の例に示します。  
+  
+ [!code-xml[Label#5](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Label/XAML/Pane1.xaml#5)]
+ [!code-xml[Label#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Label/CS/Pane1.xaml#5)]  
+  
+ **アクセス キーとテキストの折り返しをラベルに追加する**  
+  
+ アクセス キー \(ニーモニック\) を持つ <xref:System.Windows.Controls.Label> が必要な場合は、<xref:System.Windows.Controls.Label> の内部の <xref:System.Windows.Controls.AccessText> を使用します。  
+  
+ <xref:System.Windows.Controls.Label>、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.RadioButton>、<xref:System.Windows.Controls.CheckBox>、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Controls.TabItem>、<xref:System.Windows.Controls.Expander>、<xref:System.Windows.Controls.GroupBox> などのコントロールには、既定のコントロール テンプレートがあります。  これらのテンプレートには、<xref:System.Windows.Controls.ContentPresenter> が含まれます。  <xref:System.Windows.Controls.ContentPresenter> で設定できるプロパティの 1 つに <xref:System.Windows.Controls.ContentPresenter.RecognizesAccessKey%2A>\="true" があり、これを使用するとコントロールのアクセス キーを指定できます。  
+  
+ アクセス キーを持ち、テキストの折り返しをサポートする <xref:System.Windows.Controls.Label> を作成する方法を次の例に示します。  この例では、テキストの折り返しを有効にするために <xref:System.Windows.Controls.AccessText.TextWrapping%2A> プロパティを設定し、下線文字を使用してアクセス キーを示しています。  下線文字のすぐ後にある文字がアクセス キーです。  
+  
+ [!code-xml[Label#4](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Label/XAML/Pane1.xaml#4)]
+ [!code-xml[Label#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Label/CS/Pane1.xaml#4)]  
+  
+## 参照  
+ [How to: Set the Target Property of a Label](http://msdn.microsoft.com/ja-jp/b24c6977-ebcb-4855-a9bb-3fd4435af8f8)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-custom-panel-element.md b/docs/framework/wpf/controls/how-to-create-a-custom-panel-element.md
new file mode 100644
index 00000000000..d19a56d0ed8
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-custom-panel-element.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : カスタム パネル要素を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタムの Panel 要素"
+  - "Panel コントロール"
+ms.assetid: e0df4f1e-8c07-4e86-89a3-e22acfffdc2a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : カスタム パネル要素を作成する
+## 使用例  
+ この例では、<xref:System.Windows.Controls.Panel> 要素の既定のレイアウト動作をオーバーライドして、<xref:System.Windows.Controls.Panel> から派生したカスタム レイアウト要素を作成する方法を示します。  
+  
+ この例では、`PlotPanel` という単純なカスタム <xref:System.Windows.Controls.Panel> 要素を定義します。この要素は、ハードコーディングされた x 座標および y 座標に従って子要素を配置します。  この例では、`x` および `y` をどちらも `50` に設定します。そのため、すべての子要素は x 座標および y 座標上のこの位置に配置されます。  
+  
+ カスタムの <xref:System.Windows.Controls.Panel> 動作を実装するために、この例では <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドと <xref:System.Windows.FrameworkElement.ArrangeOverride%2A> メソッドを使用します。  各メソッドは、子要素の配置とレンダリングに必要な <xref:System.Windows.Size> データを返します。  
+  
+ [!code-cpp[PlotPanel#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PlotPanel/CPP/PlotPanel.cpp#1)]
+ [!code-csharp[PlotPanel#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PlotPanel/CSharp/PlotPanel.cs#1)]
+ [!code-vb[PlotPanel#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PlotPanel/VisualBasic/PlotPanel.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Panel>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [カスタム コンテンツ折り返しパネルの作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159979)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md b/docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md
new file mode 100644
index 00000000000..6395b368568
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : ListView のカスタム表示モードを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール, 作成 (カスタム表示モードを)"
+ms.assetid: 71077349-eeb9-4344-ab29-b5df96df3314
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ListView のカスタム表示モードを作成する
+この例では、<xref:System.Windows.Controls.ListView> コントロールのカスタム <xref:System.Windows.Controls.ListView.View%2A> モードを作成する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.ListView> コントロールのカスタム ビューを作成する場合は、<xref:System.Windows.Controls.ViewBase> クラスを使用する必要があります。  <xref:System.Windows.Controls.ViewBase> クラスから派生した、`PlainView` と呼ばれる表示モードを次の例に示します。  
+  
+ [!code-csharp[ListViewCustomView#PlainView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCustomView/CSharp/PlainView.cs#plainview)]
+ [!code-vb[ListViewCustomView#PlainView](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListViewCustomView/visualbasic/plainview.vb#plainview)]  
+  
+ カスタム ビューにスタイルを適用するには、<xref:System.Windows.Style> クラスを使用します。  `PlainView` 表示モードの <xref:System.Windows.Style> を定義する例を次に示します。  前の例では、このスタイルは、`PlainView` に対して定義されている <xref:System.Windows.Controls.ViewBase.DefaultStyleKey%2A> プロパティの値として設定されています。  
+  
+ [!code-xml[ListViewCustomView#PlainViewStyle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCustomView/CSharp/Themes/Generic.xaml#plainviewstyle)]  
+  
+ カスタム表示モードでのデータのレイアウトを定義するには、<xref:System.Windows.DataTemplate> オブジェクトを定義します。  `PlainView` 表示モードでのデータの表示に使用できる <xref:System.Windows.DataTemplate> を定義する例を次に示します。  
+  
+ [!code-xml[ListViewCustomView#PlainViewDataTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCustomView/CSharp/Window1.xaml#plainviewdatatemplate)]  
+  
+ 前の例で定義した <xref:System.Windows.DataTemplate> を使用する `PlainView` 表示モードの <xref:System.Windows.ResourceKey> を定義する方法を次の例に示します。  
+  
+ [!code-xml[ListViewCustomView#PlainViewtileView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCustomView/CSharp/Window1.xaml#plainviewtileview)]  
+  
+ <xref:System.Windows.Controls.ListView> コントロールでは、<xref:System.Windows.Controls.ListView.View%2A> プロパティをリソース キーに設定することで、カスタム ビューを使用できるようになります。  `PlainView` を <xref:System.Windows.Controls.ListView> の表示モードとして指定する方法を次の例に示します。  
+  
+ [!code-csharp[ListViewCustomView#ListViewtileViewmode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCustomView/CSharp/Window1.xaml.cs#listviewtileviewmode)]
+ [!code-vb[ListViewCustomView#ListViewtileViewmode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListViewCustomView/visualbasic/window1.xaml.vb#listviewtileviewmode)]  
+  
+ サンプル全体については、[複数のビューを持つ ListView のサンプル](http://go.microsoft.com/fwlink/?LinkID=160013)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-dockpanel.md b/docs/framework/wpf/controls/how-to-create-a-dockpanel.md
new file mode 100644
index 00000000000..051138a50c1
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-dockpanel.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : DockPanel を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, DockPanel"
+  - "DockPanel コントロール, 作成"
+ms.assetid: 9194f663-e279-4f1a-86d7-125a57d05c6f
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : DockPanel を作成する
+## 使用例  
+ 次の例では、コードを使用して、<xref:System.Windows.Controls.DockPanel> のインスタンスを作成および使用します。  5 つの <xref:System.Windows.Shapes.Rectangle> 要素を作成し、それらを親 <xref:System.Windows.Controls.DockPanel> の内部に配置 \(ドッキング\) することで領域を分割する方法を次の例に示します。  既定の設定を維持した場合、最後の四角形は割り当てられていない残りの領域全体を満たします。  
+  
+ [!code-csharp[DockPanelCode#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DockPanelCode/CSharp/DockPanel_Code.cs#1)]
+ [!code-vb[DockPanelCode#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DockPanelCode/VisualBasic/dockpanel_vb.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.DockPanel>   
+ <xref:System.Windows.Controls.Dock>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-grid-element.md b/docs/framework/wpf/controls/how-to-create-a-grid-element.md
new file mode 100644
index 00000000000..ee054a6ab58
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-grid-element.md
@@ -0,0 +1,31 @@
+---
+title: "方法 : グリッド要素を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド コントロール, 作成, グリッド インスタンス"
+ms.assetid: b2f07626-9df8-43b8-8d36-492f3cb42837
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : グリッド要素を作成する
+## 使用例  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] またはコードを使用して、<xref:System.Windows.Controls.Grid> のインスタンスを作成および使用する方法を次の例に示します。  次の例では、3 つの <xref:System.Windows.Controls.ColumnDefinition> オブジェクトおよび 3 つの <xref:System.Windows.Controls.RowDefinition> オブジェクトを使用して、ワークシートに見られるような、9 つのセルから成るグリッドを作成します。  各セルはデータを表す <xref:System.Windows.Controls.TextBlock> 要素を含み、一番上の行は <xref:System.Windows.Controls.Grid.ColumnSpan%2A> プロパティが適用される <xref:System.Windows.Controls.TextBlock> を含みます。  各セルの境界を表示するには、<xref:System.Windows.Controls.Grid.ShowGridLines%2A> プロパティを有効にします。  
+  
+ [!code-csharp[Grid#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Grid/CSharp/Grid_Code.cs#3)]
+ [!code-vb[Grid#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Grid/VisualBasic/grid_vb.vb#3)]
+ [!code-xml[Grid#3](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Grid/XAML/default.xaml#3)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-multiline-textbox-control.md b/docs/framework/wpf/controls/how-to-create-a-multiline-textbox-control.md
new file mode 100644
index 00000000000..666b48c36b8
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-multiline-textbox-control.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : 複数行の TextBox コントロールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TextBox コントロール, 複数行 (テキストの)"
+ms.assetid: 05914a93-d0ea-4a9a-b693-09df7d4e2ac2
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 複数行の TextBox コントロールを作成する
+この例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して、複数行のテキストが収まるように自動的に拡大する <xref:System.Windows.Controls.TextBox> コントロールを定義する方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TextBox.TextWrapping%2A> 属性を **Wrap** に設定すると、入力したテキストが <xref:System.Windows.Controls.TextBox> コントロールの端に達すると次の行に折り返されます。<xref:System.Windows.Controls.TextBox> コントロールのサイズは、新しい行が収まるように必要に応じて自動的に調整されます。  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.AcceptsReturn%2A> 属性を **true** に設定した場合は、Enter キーを押すたびに新しい行が挿入されます。このときも、<xref:System.Windows.Controls.TextBox> は新しい行が収まるように必要に応じて自動的に調整されます。  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.VerticalScrollBarVisibility%2A> 属性を設定すると <xref:System.Windows.Controls.TextBox> にスクロール バーが追加され、<xref:System.Windows.Controls.TextBox> がそれを囲むフレームまたはウィンドウのサイズよりも大きくなった場合は、<xref:System.Windows.Controls.TextBox> の内容をスクロールすることができます。  
+  
+ [!code-xml[TextBox_MiscCode#_MultilineTextBoxXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_multilinetextboxxaml)]  
+  
+## 参照  
+ <xref:System.Windows.TextWrapping>   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-stackpanel.md b/docs/framework/wpf/controls/how-to-create-a-stackpanel.md
new file mode 100644
index 00000000000..ae7016c4f41
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-stackpanel.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : StackPanel を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "StackPanel コントロールを作成します。"
+ms.assetid: e7ce65cb-720a-4bb6-95b6-286b74488a58
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : StackPanel を作成する
+この例を作成する方法を示しています、 <xref:System.Windows.Controls.StackPanel>します。  
+  
+## <a name="example"></a>例  
+ A <xref:System.Windows.Controls.StackPanel>すると、指定した方向に要素を積み重ねることができます。 定義されているプロパティを使用して<xref:System.Windows.Controls.StackPanel>、コンテンツ流し込むことができます垂直方向に、これは既定の設定または水平方向にします。  
+  
+ 5 つは、次の例が垂直方向に積み上げ<xref:System.Windows.Controls.TextBlock>制御する場合に、それぞれ異なる<xref:System.Windows.Controls.Border>と<xref:System.Windows.Controls.Border.Background%2A>を使用して<xref:System.Windows.Controls.StackPanel>します。 指定されて子要素<xref:System.Windows.FrameworkElement.Width%2A>を親ウィンドウの拡大が、子要素ですが、指定した<xref:System.Windows.FrameworkElement.Width%2A>ウィンドウ内で中央揃えで配置しません。  
+  
+ 既定のスタック方向、 <xref:System.Windows.Controls.StackPanel>は垂直に表示します。 コンテンツの流れを制御する、 <xref:System.Windows.Controls.StackPanel>を使用して、<xref:System.Windows.Controls.StackPanel.Orientation%2A>プロパティです。 水平方向の配置を制御するにを使用して、 <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>プロパティです。  
+  
+```xaml  
+  
+<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" WindowTitle="StackPanel Sample">  
+  <StackPanel>  
+    <Border Background="SkyBlue" BorderBrush="Black" BorderThickness="1">  
+      <TextBlock Foreground="Black" FontSize="12">Stacked Item #1</TextBlock>  
+    </Border>  
+    <Border Width="400" Background="CadetBlue" BorderBrush="Black" BorderThickness="1">  
+      <TextBlock Foreground="Black" FontSize="14">Stacked Item #2</TextBlock>  
+    </Border>  
+    <Border Background="LightGoldenRodYellow" BorderBrush="Black" BorderThickness="1">  
+      <TextBlock Foreground="Black" FontSize="16">Stacked Item #3</TextBlock>  
+    </Border>  
+    <Border Width="200" Background="PaleGreen" BorderBrush="Black" BorderThickness="1">  
+      <TextBlock Foreground="Black" FontSize="18">Stacked Item #4</TextBlock>  
+    </Border>  
+    <Border Background="White" BorderBrush="Black" BorderThickness="1">  
+      <TextBlock Foreground="Black" FontSize="20">Stacked Item #5</TextBlock>  
+    </Border>  
+  </StackPanel>  
+</Page>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.StackPanel>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/controls/stackpanel-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-a-style-for-a-dragged-gridview-column-header.md b/docs/framework/wpf/controls/how-to-create-a-style-for-a-dragged-gridview-column-header.md
new file mode 100644
index 00000000000..286e81ce675
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-a-style-for-a-dragged-gridview-column-header.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : ドラッグされた GridView 列ヘッダーのスタイルを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール, スタイル設定"
+ms.assetid: 0b999645-0313-4b33-80b9-19ece08b5459
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ドラッグされた GridView 列ヘッダーのスタイルを作成する
+この例では、ユーザーが列の位置を変更したときに、ドラッグされた <xref:System.Windows.Controls.GridViewColumnHeader> の外観を変更する方法を示します。  
+  
+## 使用例  
+ 表示モードに <xref:System.Windows.Controls.GridView> を使用する <xref:System.Windows.Controls.ListView> で列ヘッダーを別の場所にドラッグすると、その列が新しい位置に移動します。  列ヘッダーをドラッグしている間、元のヘッダーとは別に、そのコピーであるフローティング ヘッダーが表示されます。  <xref:System.Windows.Controls.GridView> の列ヘッダーは、<xref:System.Windows.Controls.GridViewColumnHeader> オブジェクトで表されます。  
+  
+ フローティング ヘッダーと元のヘッダーの外観をカスタマイズするには、<xref:System.Windows.Controls.ControlTemplate.Triggers%2A> を設定して <xref:System.Windows.Controls.GridViewColumnHeader> <xref:System.Windows.Style> を変更します。  これらの <xref:System.Windows.Controls.ControlTemplate.Triggers%2A> は、<xref:System.Windows.Controls.Primitives.ButtonBase.IsPressed%2A> プロパティ値が `true` で、<xref:System.Windows.Controls.GridViewColumnHeader.Role%2A> プロパティ値が <xref:System.Windows.Controls.GridViewColumnHeaderRole> の場合に適用されます。  
+  
+ <xref:System.Windows.Controls.GridViewColumnHeader> の上にマウス ポインターがある間にユーザーがマウス ボタンを押して、そのまま押し続けると、<xref:System.Windows.Controls.Primitives.ButtonBase.IsPressed%2A> プロパティ値は `true` に変更されます。  同様に、ユーザーがドラッグ操作を開始すると、<xref:System.Windows.Controls.GridViewColumnHeader.Role%2A> プロパティは <xref:System.Windows.Controls.GridViewColumnHeaderRole> に変更されます。  
+  
+ <xref:System.Windows.Controls.ControlTemplate.Triggers%2A> を設定して、ユーザーが列を新しい位置にドラッグしているときに、元のヘッダーとフローティング ヘッダーの <xref:System.Windows.Controls.Control.Foreground%2A> と <xref:System.Windows.Controls.Control.Background%2A> の色を変更する方法を次の例に示します。  
+  
+ [!code-xml[ListViewHeaderRoleStyle#GVCHControlTemplateStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#gvchcontroltemplatestart)]  
+[!code-xml[ListViewHeaderRoleStyle#ControlTemplateTriggersStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#controltemplatetriggersstart)]  
+[!code-xml[ListViewHeaderRoleStyle#IsPressed](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#ispressed)]  
+[!code-xml[ListViewHeaderRoleStyle#Floating](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#floating)]  
+[!code-xml[ListViewHeaderRoleStyle#ControlTemplateTriggersEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#controltemplatetriggersend)]  
+[!code-xml[ListViewHeaderRoleStyle#GVCHControlTemplateEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHeaderRoleStyle/CS/Window1.xaml#gvchcontroltemplateend)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridViewColumnHeader>   
+ <xref:System.Windows.Controls.GridViewColumnHeaderRole>   
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-an-expander-with-a-scrollviewer.md b/docs/framework/wpf/controls/how-to-create-an-expander-with-a-scrollviewer.md
new file mode 100644
index 00000000000..1e26cb956ba
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-an-expander-with-a-scrollviewer.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ScrollViewer を持つエキスパンダーを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], Expander"
+  - "コントロール [WPF], ScrollViewer"
+  - "Expander コントロール, 作成"
+  - "ScrollViewer コントロール, Expander コントロールを備えた"
+ms.assetid: 2ad124d2-2406-4157-aaf2-64e067298f01
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ScrollViewer を持つエキスパンダーを作成する
+この例では、イメージやテキストなどの複雑なコンテンツを格納した <xref:System.Windows.Controls.Expander> コントロールを作成する方法を示します。  また、この例では、<xref:System.Windows.Controls.Expander> のコンテンツを <xref:System.Windows.Controls.ScrollViewer> コントロールで囲む方法も示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Expander> の作成方法を次の例に示します。  この例では、<xref:System.Windows.Controls.HeaderedContentControl.Header%2A> を定義するために、イメージとテキストを含む <xref:System.Windows.Controls.Primitives.BulletDecorator> コントロールを使用しています。  <xref:System.Windows.Controls.ScrollViewer> コントロールは、展開されたコンテンツをスクロールするメソッドを提供します。  
+  
+ この例では、コンテンツに対してではなく、<xref:System.Windows.Controls.ScrollViewer> に対して <xref:System.Windows.FrameworkElement.Height%2A> プロパティを設定していることに注意してください。  <xref:System.Windows.FrameworkElement.Height%2A> をコンテンツに対して設定すると、<xref:System.Windows.Controls.ScrollViewer> はコンテンツのスクロールを許可しなくなります。  <xref:System.Windows.FrameworkElement.Width%2A> プロパティは <xref:System.Windows.Controls.Expander> コントロールで設定され、この設定は、<xref:System.Windows.Controls.HeaderedContentControl.Header%2A> および展開されたコンテンツに対して適用されます。  
+  
+ [!code-xml[ExpanderRichContent#CreateExpander](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpanderRichContent/CSharp/Window1.xaml#createexpander)]  
+  
+ [!code-csharp[ExpanderRichContent#CreateExpanderCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpanderRichContent/CSharp/Window1.xaml.cs#createexpandercode)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Expander>   
+ [エキスパンダーの概要](../../../../docs/framework/wpf/controls/expander-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/expander-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-and-use-a-canvas.md b/docs/framework/wpf/controls/how-to-create-and-use-a-canvas.md
new file mode 100644
index 00000000000..d9b1aa1106f
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-and-use-a-canvas.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : Canvas を作成および使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Canvas コントロール, 作成"
+  - "Canvas コントロール, 使用"
+  - "コントロール, Canvas"
+ms.assetid: 420b9487-9a15-477c-9489-a22a4dec7779
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Canvas を作成および使用する
+<xref:System.Windows.Controls.Canvas> のインスタンスを作成して使用する方法を次の例に示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Controls.Canvas> の <xref:System.Windows.Controls.Canvas.SetTop%2A> メソッドと <xref:System.Windows.Controls.Canvas.SetLeft%2A> メソッドを使用して、2 つの <xref:System.Windows.Controls.TextBlock> 要素を明示的に配置しています。  また、この例では、`LightSteelBlue` の <xref:System.Windows.Controls.Control.Background%2A> 色を <xref:System.Windows.Controls.Canvas> に割り当てています。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して <xref:System.Windows.Controls.TextBlock> 要素を配置する場合は、<xref:System.Windows.Controls.Canvas.Top%2A> プロパティと <xref:System.Windows.Controls.Canvas.Left%2A> プロパティを使用します。  
+  
+ [!code-csharp[CanvasCode#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasCode/CSharp/Canvas_Code.cs#1)]
+ [!code-vb[CanvasCode#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CanvasCode/VisualBasic/canvas_vb.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Canvas>   
+ <xref:System.Windows.Controls.TextBlock>   
+ <xref:System.Windows.Controls.Canvas.SetTop%2A>   
+ <xref:System.Windows.Controls.Canvas.SetLeft%2A>   
+ <xref:System.Windows.Controls.Canvas.Top%2A>   
+ <xref:System.Windows.Controls.Canvas.Left%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/canvas-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-and-use-a-gridlengthconverter-object.md b/docs/framework/wpf/controls/how-to-create-and-use-a-gridlengthconverter-object.md
new file mode 100644
index 00000000000..e1d83b36ad0
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-and-use-a-gridlengthconverter-object.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : GridLengthConverter オブジェクトを作成および使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド コントロール, 作成, GridLengthConverter オブジェクト"
+ms.assetid: 5ab75911-e36a-4825-80e4-081c57e8e182
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : GridLengthConverter オブジェクトを作成および使用する
+## 使用例  
+ <xref:System.Windows.GridLengthConverter> のインスタンスを作成および使用する方法の例を次に示します。  この例では、`changeCol` というカスタム メソッドを定義します。このメソッドは <xref:System.Windows.Controls.ListBoxItem> を <xref:System.Windows.GridLengthConverter> に渡し、そこで <xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.Controls.ContentControl.Content%2A> が <xref:System.Windows.GridLength> のインスタンスに変換されます。  変換された値は、<xref:System.Windows.Controls.ColumnDefinition> 要素の <xref:System.Windows.Controls.ColumnDefinition.Width%2A> プロパティの値として戻されます。  
+  
+ また、この例では、`changeColVal` という名前の第 2 のカスタム メソッドも定義されています。  このカスタム メソッドは、<xref:System.Windows.Controls.Slider> の <xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> を <xref:System.String> に変換した後、その値を要素の <xref:System.Windows.Controls.ColumnDefinition.Width%2A> として <xref:System.Windows.Controls.ColumnDefinition> に返します。  
+  
+ <xref:System.Windows.Controls.ListBoxItem> のコンテンツは、別の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルで定義されます。  
+  
+ [!code-csharp[gridlengthConverterGrid#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridlengthConverterGrid/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[gridlengthConverterGrid#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/gridlengthConverterGrid/VisualBasic/Window1.xaml.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.GridLengthConverter>   
+ <xref:System.Windows.GridLength>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-listviewitems-with-a-checkbox.md b/docs/framework/wpf/controls/how-to-create-listviewitems-with-a-checkbox.md
new file mode 100644
index 00000000000..5b32b32b23a
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-listviewitems-with-a-checkbox.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : CheckBox を持つ ListViewItem を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール"
+  - "コントロール、チェック ボックス"
+  - "CheckBox コントロールを ListView コントロールします。"
+  - "ListView コントロールでチェック ボックス コントロール"
+ms.assetid: f6d66c7f-906c-4f65-a55a-0ede9d00e26a
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : CheckBox を持つ ListViewItem を作成する
+この例の列を表示する方法を示しています<xref:System.Windows.Controls.CheckBox>コントロールで、 <xref:System.Windows.Controls.ListView>を使用するコントロール、 <xref:System.Windows.Controls.GridView>します。  
+  
+## <a name="example"></a>例  
+ 含む列を作成する<xref:System.Windows.Controls.CheckBox>コントロールで、 <xref:System.Windows.Controls.ListView>、作成、 <xref:System.Windows.DataTemplate>を含む、 <xref:System.Windows.Controls.CheckBox>します。 設定し、 <xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A>の<xref:System.Windows.Controls.GridViewColumn>に、 <xref:System.Windows.DataTemplate>します。  
+  
+ 例を次に、 <xref:System.Windows.DataTemplate>を含む、 <xref:System.Windows.Controls.CheckBox>します。 この例で、 <xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A>のプロパティ、 <xref:System.Windows.Controls.CheckBox>に、 <xref:System.Windows.Controls.ListBoxItem.IsSelected%2A>のプロパティの値、 <xref:System.Windows.Controls.ListViewItem>含まれています。 したがってときに、 <xref:System.Windows.Controls.ListViewItem>を含む、<xref:System.Windows.Controls.CheckBox>が選択されている、<xref:System.Windows.Controls.CheckBox>がオンになっています。  
+  
+ [!code-xml[ListViewChkBox#CheckBoxDataTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#checkboxdatatemplate)]  
+  
+ 次の例の列を作成する方法を示しています。 <xref:System.Windows.Controls.CheckBox>コントロールです。 例のセットの列に設定、 <xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A>のプロパティ、 <xref:System.Windows.Controls.GridViewColumn>に、 <xref:System.Windows.DataTemplate>します。  
+  
+ [!code-xml[ListViewChkBox#GridViewColumnCheckBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#gridviewcolumncheckbox)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.Control>   
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-create-simple-or-complex-treeviews.md b/docs/framework/wpf/controls/how-to-create-simple-or-complex-treeviews.md
new file mode 100644
index 00000000000..9ed243cee85
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-create-simple-or-complex-treeviews.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : 単純または複雑な TreeView を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Control クラス, TreeView, 作成"
+  - "TreeView コントロール, 作成"
+ms.assetid: 1defbb78-b8e7-4c0e-b650-576453ac828d
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : 単純または複雑な TreeView を作成する
+この例では、単純または複雑な <xref:System.Windows.Controls.TreeView> コントロールを作成する方法を示します。  
+  
+ <xref:System.Windows.Controls.TreeView> は <xref:System.Windows.Controls.TreeViewItem> コントロールの階層で構成されます。<xref:System.Windows.Controls.TreeViewItem> は、単純なテキスト文字列を含むことも、<xref:System.Windows.Controls.Button> コントロールや、コンテンツが埋め込まれた <xref:System.Windows.Controls.StackPanel> などのさらに複雑なコンテンツを含むこともできます。  <xref:System.Windows.Controls.TreeView> のコンテンツは、明示的に定義することも、データ ソースが提供することもできます。  このトピックでは、これらの概念の例を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TreeViewItem> の <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> プロパティには、<xref:System.Windows.Controls.TreeView> がその項目に対して表示するコンテンツが含まれます。  <xref:System.Windows.Controls.TreeViewItem> は、子要素として <xref:System.Windows.Controls.TreeViewItem> を持つこともでき、これらの子要素は <xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティを使用して定義できます。  
+  
+ <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> プロパティにテキスト文字列を設定することで <xref:System.Windows.Controls.TreeViewItem> のコンテンツを明示的に定義する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSimple#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#1)]  
+  
+ <xref:System.Windows.Controls.Button> コントロールである <xref:System.Windows.Controls.ItemsControl.Items%2A> を定義することで <xref:System.Windows.Controls.TreeViewItem> の子要素を定義する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSimple#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#3)]  
+  
+ <xref:System.Windows.Data.XmlDataProvider> で <xref:System.Windows.Controls.TreeViewItem> のコンテンツを提供し、<xref:System.Windows.HierarchicalDataTemplate> でコンテンツの表示を定義して、<xref:System.Windows.Controls.TreeView> を作成する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSimple#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#6)]  
+  
+ [!code-xml[TreeViewSimple#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#7)]  
+  
+ [!code-xml[TreeViewSimple#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#5)]  
+  
+ <xref:System.Windows.Controls.TreeViewItem> のコンテンツとして、コンテンツが埋め込まれた <xref:System.Windows.Controls.DockPanel> コントロールを含む <xref:System.Windows.Controls.TreeView> を作成する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSimple#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#9)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.TreeView>   
+ <xref:System.Windows.Controls.TreeViewItem>   
+ [TreeView の概要](../../../../docs/framework/wpf/controls/treeview-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/treeview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-crop-an-image.md b/docs/framework/wpf/controls/how-to-crop-an-image.md
new file mode 100644
index 00000000000..0d6536154a3
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-crop-an-image.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : イメージをトリミングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, CroppedBitmap"
+  - "CroppedBitmap クラス"
+  - "トリミング (イメージを)"
+  - "イメージ, トリミング"
+ms.assetid: c6bba109-c6e7-4cf8-bfe6-9cf8d01bb4fc
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : イメージをトリミングする
+この例では、<xref:System.Windows.Media.Imaging.CroppedBitmap> を使用してイメージをトリミングする方法を示します。  
+  
+ <xref:System.Windows.Media.Imaging.CroppedBitmap> は、主にイメージのトリミングされたバージョンをエンコードしてファイルに保存する際に使用されます。  表示する目的でイメージをトリミングするには、「[Create a Clip Region](http://msdn.microsoft.com/ja-jp/56e4bed6-78d7-4292-b917-d72d0b3e4376)」を参照してください。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] は、以下のサンプル内で使用するリソースを定義しています。  
+  
+ [!code-xml[imageelementexample#CroppedXAML1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/CroppedImageExample.xaml#croppedxaml1)]  
+  
+ <xref:System.Windows.Media.Imaging.CroppedBitmap> をイメージ ソースとして使用してイメージを作成する例を次に示します。  
+  
+ [!code-xml[imageelementexample#CroppedXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/CroppedImageExample.xaml#croppedxaml2)]  
+  
+ [!code-csharp[imageelementexample#CroppedCSharp1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/CroppedImageExample.xaml.cs#croppedcsharp1)]
+ [!code-vb[imageelementexample#CroppedCSharp1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample/VB/CroppedImageExample.xaml.vb#croppedcsharp1)]  
+  
+ <xref:System.Windows.Media.Imaging.CroppedBitmap> は、別の <xref:System.Windows.Media.Imaging.CroppedBitmap> のソースとして使用して、トリミングされたイメージをつなぎ合わせることもできます。  <xref:System.Windows.Media.Imaging.CroppedBitmap.SourceRect%2A> は、最初のイメージではなく、ソースとなるトリミングされたビットマップを基準とした値を使用することに注意してください。  
+  
+ [!code-xml[imageelementexample#CroppedXAML3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/CroppedImageExample.xaml#croppedxaml3)]  
+  
+ [!code-csharp[imageelementexample#CroppedCSharp2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/CroppedImageExample.xaml.cs#croppedcsharp2)]
+ [!code-vb[imageelementexample#CroppedCSharp2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample/VB/CroppedImageExample.xaml.vb#croppedcsharp2)]  
+  
+## 参照  
+ [Create a Clip Region](http://msdn.microsoft.com/ja-jp/56e4bed6-78d7-4292-b917-d72d0b3e4376)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-customize-the-thumb-size-on-a-scrollbar.md b/docs/framework/wpf/controls/how-to-customize-the-thumb-size-on-a-scrollbar.md
new file mode 100644
index 00000000000..bfc45aad5c7
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-customize-the-thumb-size-on-a-scrollbar.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : ScrollBar のつまみのサイズをカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタマイズ (つまみのサイズを)"
+  - "ScrollBar コントロール"
+  - "つまみのサイズ"
+ms.assetid: fa32b866-5ca1-4e73-85e7-2ac64b80d194
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ScrollBar のつまみのサイズをカスタマイズする
+このトピックでは、<xref:System.Windows.Controls.Primitives.ScrollBar> の <xref:System.Windows.Controls.Primitives.Thumb> を固定サイズに設定する方法と <xref:System.Windows.Controls.Primitives.ScrollBar> の <xref:System.Windows.Controls.Primitives.Thumb> の最小サイズを指定する方法について説明します。  
+  
+## 使用例  
+  
+## Description  
+ 次の例は、固定サイズの <xref:System.Windows.Controls.Primitives.Thumb> を持つ <xref:System.Windows.Controls.Primitives.ScrollBar> を作成します。  この例では、<xref:System.Windows.Controls.Primitives.Thumb> の <xref:System.Windows.Controls.Primitives.Track.ViewportSize%2A> プロパティを <xref:System.Double.NaN> に設定し、<xref:System.Windows.Controls.Primitives.Thumb> の高さを設定しています。  固定幅の <xref:System.Windows.Controls.Primitives.Thumb> を持つ水平 <xref:System.Windows.Controls.Primitives.ScrollBar> を作成するには、<xref:System.Windows.Controls.Primitives.Thumb> の幅を設定します。  
+  
+## コード  
+ [!code-xml[ScrollBarCustomThumbSize#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ScrollBarCustomThumbSize/CS/Window1.xaml#1)]  
+  
+## Description  
+ 次の例は、最小サイズの <xref:System.Windows.Controls.Primitives.Thumb> を持つ <xref:System.Windows.Controls.Primitives.ScrollBar> を作成します。  この例では、<xref:System.Windows.SystemParameters.VerticalScrollBarButtonHeightKey%2A> の値を設定しています。  最小幅の <xref:System.Windows.Controls.Primitives.Thumb> を持つ水平 <xref:System.Windows.Controls.Primitives.ScrollBar> を作成するには、<xref:System.Windows.SystemParameters.HorizontalScrollBarButtonWidthKey%2A> の幅を設定します。  
+  
+## コード  
+ [!code-xml[ScrollBarCustomThumbSize#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ScrollBarCustomThumbSize/CS/Window1.xaml#2)]  
+  
+## 参照  
+ [ScrollBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/scrollbar-styles-and-templates.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-customize-the-ticks-on-a-slider.md b/docs/framework/wpf/controls/how-to-customize-the-ticks-on-a-slider.md
new file mode 100644
index 00000000000..9570a0e9dad
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-customize-the-ticks-on-a-slider.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : スライダーの目盛りをカスタマイズする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TickBar"
+  - "スライダー コントロールを作成 (TickBar で)"
+ms.assetid: 4fa694f2-a620-4b15-be78-5f4286f89361
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : スライダーの目盛りをカスタマイズする
+この例を作成する方法を示しています、<xref:System.Windows.Controls.Slider>目盛りを持つコントロールです。  
+  
+## <a name="example"></a>例  
+ <xref:System.Windows.Controls.Primitives.TickBar>表示を設定すると、 <xref:System.Windows.Controls.Slider.TickPlacement%2A>プロパティ以外の値を<xref:System.Windows.Controls.Primitives.TickPlacement>、これは、既定値です。  
+  
+ 次の例を作成する方法を示しています、<xref:System.Windows.Controls.Slider>で、 <xref:System.Windows.Controls.Primitives.TickBar>目盛り表示を表示します。 <xref:System.Windows.Controls.Slider.TickPlacement%2A>と<xref:System.Windows.Controls.Slider.TickFrequency%2A>プロパティは、目盛りは、それらの間の間隔の場所を定義します。 移動すると、 <xref:System.Windows.Controls.Primitives.Thumb>、ツール ヒントの値を表示する、<xref:System.Windows.Controls.Slider>します。 <xref:System.Windows.Controls.Slider.AutoToolTipPlacement%2A>プロパティは、ツールヒントが発生する可能性を定義します。 <xref:System.Windows.Controls.Primitives.Thumb>の動きが目盛りの位置に対応しているため<xref:System.Windows.Controls.Slider.IsSnapToTickEnabled%2A>に設定されている`true`します。  
+  
+ 次の例を使用する方法を示しています、<xref:System.Windows.Controls.Slider.Ticks%2A>ティックに沿ってマークを作成するプロパティ、<xref:System.Windows.Controls.Slider>不規則な間隔でします。  
+  
+ [!code-xml[Slider#4](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Slider/xaml/window1.xaml#4)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.Slider>   
+ <xref:System.Windows.Controls.Primitives.TickBar>   
+ <xref:System.Windows.Controls.Slider.TickPlacement%2A>   
+ [スライダーの操作方法に関するトピック](http://msdn.microsoft.com/ja-jp/534be86c-afb2-425d-8186-631278a9925e)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-define-a-groupbox-template.md b/docs/framework/wpf/controls/how-to-define-a-groupbox-template.md
new file mode 100644
index 00000000000..1ee3ec6a412
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-define-a-groupbox-template.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : GroupBox テンプレートを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, GroupBox"
+  - "GroupBox コントロール, 作成 (テンプレートを)"
+ms.assetid: 85a4d1a7-4753-4f4a-b26d-14fa10c1ddb5
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : GroupBox テンプレートを定義する
+この例では、<xref:System.Windows.Controls.GroupBox> コントロールのテンプレートを作成する方法を示します。  
+  
+## 使用例  
+ 次の例で定義する <xref:System.Windows.Controls.GroupBox> コントロール テンプレートでは、<xref:System.Windows.Controls.Grid> コントロールを使用してレイアウトを行います。  このテンプレートは <xref:System.Windows.Controls.BorderGapMaskConverter> を使用して <xref:System.Windows.Controls.GroupBox> の境界線を定義しているので、境界線で <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> コンテンツが隠されることはありません。  
+  
+ [!code-xml[GroupBoxSnippet#GroupBoxTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GroupBoxSnippet/CS/Window1.xaml#groupboxtemplate)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GroupBox>   
+ [GroupBox How\-to Topics](http://msdn.microsoft.com/ja-jp/7692e155-a4c6-428c-b7e0-64b3740daca7)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md b/docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md
new file mode 100644
index 00000000000..b1793c6581e
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : TextBox のテキストがいつ変更されたかを検出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "検出 (テキストの変更を)"
+  - "テキストの変更, 検出"
+  - "TextBox コントロール, 検出 (テキストの変更を)"
+ms.assetid: 1c39ee14-e37f-49fb-a0d1-a9824ca13584
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : TextBox のテキストがいつ変更されたかを検出する
+この例では、<xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> イベントを使用して、<xref:System.Windows.Controls.TextBox> コントロール内のテキストが変わるたびにメソッドを実行する 1 つの方法を示します。  
+  
+ 変更用にモニターする <xref:System.Windows.Controls.TextBox> コントロールを含む [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の分離コード クラスでは、<xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> イベントの実行時に呼び出し用メソッドを挿入します。  このメソッドには、<xref:System.Windows.Controls.TextChangedEventHandler> デリゲートで想定された署名に一致する署名を含める必要があります。  
+  
+ イベント ハンドラーは、<xref:System.Windows.Controls.TextBox> コントロールの内容が変更されるたびにユーザーまたはプログラムによって呼び出されます。  
+  
+ **メモ :** このイベントは、<xref:System.Windows.Controls.TextBox> コントロールが作成され、テキストが初めて読み込まれるときに実行されます。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TextBox> コントロールを定義する [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で、<xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> 属性に、イベント ハンドラーのメソッド名と一致する値を指定します。  
+  
+ [!code-xml[TextBox_MiscCode#_TextChangedXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_textchangedxaml)]  
+  
+## 使用例  
+ 変更用にモニターする <xref:System.Windows.Controls.TextBox> コントロールを含む [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の分離コード クラスでは、<xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> イベントの実行時に呼び出し用メソッドを挿入します。  このメソッドには、<xref:System.Windows.Controls.TextChangedEventHandler> デリゲートで想定された署名に一致する署名を含める必要があります。  
+  
+ [!code-csharp[TextBox_MiscCode#_TextChangedEventHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_textchangedeventhandler)]
+ [!code-vb[TextBox_MiscCode#_TextChangedEventHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_textchangedeventhandler)]  
+  
+ イベント ハンドラーは、<xref:System.Windows.Controls.TextBox> コントロールの内容が変更されるたびにユーザーまたはプログラムによって呼び出されます。  
+  
+ **メモ :** このイベントは、<xref:System.Windows.Controls.TextBox> コントロールが作成され、テキストが初めて読み込まれるときに実行されます。  
+  
+ コメント  
+  
+## 参照  
+ <xref:System.Windows.Controls.TextChangedEventArgs>   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-display-data-by-using-gridviewrowpresenter.md b/docs/framework/wpf/controls/how-to-display-data-by-using-gridviewrowpresenter.md
new file mode 100644
index 00000000000..3567af2a9fa
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-display-data-by-using-gridviewrowpresenter.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : GridViewRowPresenter を使用してデータを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "表示 (GridViewRowPresenter でデータを)"
+  - "GridViewRowPresenter"
+ms.assetid: bdb785a5-a262-44d5-a517-ea14383e5f70
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : GridViewRowPresenter を使用してデータを表示する
+この例では、<xref:System.Windows.Controls.GridViewRowPresenter> オブジェクトと <xref:System.Windows.Controls.GridViewHeaderRowPresenter> オブジェクトを使用して、列内にデータを表示する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.GridViewRowPresenter> オブジェクトと <xref:System.Windows.Controls.GridViewHeaderRowPresenter> オブジェクトを使用して、<xref:System.DateTime> オブジェクトの <xref:System.DateTime.DayOfWeek%2A> と <xref:System.DateTime.Year%2A> を表示する <xref:System.Windows.Controls.GridViewColumnCollection> を指定する方法を次の例に示します。  この例では、<xref:System.Windows.Controls.GridViewColumn> の <xref:System.Windows.Controls.GridViewColumn.Header%2A> の <xref:System.Windows.Style> も定義します。  
+  
+ [!code-xml[GridViewRowPresenterSample#GridViewRowPresenter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridViewRowPresenterSample/CS/Window1.xaml#gridviewrowpresenter)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridViewHeaderRowPresenter>   
+ <xref:System.Windows.Controls.GridViewRowPresenter>   
+ <xref:System.Windows.Controls.GridViewColumnCollection>   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-display-listview-contents-by-using-a-gridview.md b/docs/framework/wpf/controls/how-to-display-listview-contents-by-using-a-gridview.md
new file mode 100644
index 00000000000..4a854acce80
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-display-listview-contents-by-using-a-gridview.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : GridView を使用して ListView コンテンツを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GridView, 表示 (ListView コンテンツを)"
+  - "ListView コントロール, 表示 (GridView でコンテンツを)"
+ms.assetid: 5bc1e767-ab46-4f14-bd41-3d5d39e1d000
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : GridView を使用して ListView コンテンツを表示する
+この例では、<xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.GridView> 表示モードを定義する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.GridView> の表示モードは、<xref:System.Windows.Controls.GridViewColumn> オブジェクトを指定することで定義できます。  <xref:System.Windows.Controls.ListView> コントロールに対して指定されているデータ コンテンツにバインドする <xref:System.Windows.Controls.GridViewColumn> オブジェクトを定義する方法を次の例に示します。  この <xref:System.Windows.Controls.GridView> の例では、3 つの <xref:System.Windows.Controls.GridViewColumn> オブジェクトを指定します。これらのオブジェクトは、<xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> として設定されている `EmployeeInfoDataSource` の、`FirstName`、`LastName`、および `EmployeeNumber` フィールドにマップされています。  
+  
+ [!code-xml[ListViewCode#ListViewEmployee](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml#listviewemployee)]  
+  
+ この例の表示結果を次の図に示します。  
+  
+ ![GridView 出力を含む ListView](../../../../docs/framework/wpf/controls/media/listviewgridview.png "ListViewGridView")  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md b/docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md
new file mode 100644
index 00000000000..c6b36aae8ed
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : テキスト編集コントロールでスペル チェックを有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "チェック (スペルを)"
+  - "リアルタイム スペル チェック"
+  - "スペル チェック"
+  - "スペル チェック"
+  - "TextBox コントロール, リアルタイム スペル チェック"
+ms.assetid: 6f953d2b-67e8-4012-84ce-53c0e958da47
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : テキスト編集コントロールでスペル チェックを有効にする
+<xref:System.Windows.Controls.SpellCheck> クラスの <xref:System.Windows.Controls.SpellCheck.IsEnabled%2A> プロパティを使用して、<xref:System.Windows.Controls.TextBox> でのリアルタイム スペル チェックを有効にする方法を次の例に示します。  
+  
+## 使用例  
+ [!code-xml[TextBoxMiscSnippets_snip#SpellCheckExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/spellcheckexample.xaml#spellcheckexamplewholepage)]  
+  
+ [!code-csharp[TextBoxMiscSnippets_procedural_snip#SpellCheckCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_procedural_snip/CSharp/SpellCheckExample.cs#spellcheckcodeexamplewholepage)]
+ [!code-vb[TextBoxMiscSnippets_procedural_snip#SpellCheckCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBoxMiscSnippets_procedural_snip/visualbasic/spellcheckexample.vb#spellcheckcodeexamplewholepage)]  
+  
+## 参照  
+ [コンテキスト メニューでスペル チェックを使用する](../../../../docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-enable-tab-characters-in-a-textbox-control.md b/docs/framework/wpf/controls/how-to-enable-tab-characters-in-a-textbox-control.md
new file mode 100644
index 00000000000..f7d1bac4286
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-enable-tab-characters-in-a-textbox-control.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : TextBox コントロールでタブ文字を有効にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タブ文字, 有効化"
+  - "TextBox コントロール, 有効化 (タブ文字を)"
+ms.assetid: 14b1b064-61f7-4958-be63-88d85b868d03
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : TextBox コントロールでタブ文字を有効にする
+<xref:System.Windows.Controls.TextBox> コントロールの通常入力としてタブ文字を受け入れられるようにする方法を次の例に示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TextBox> コントロールの入力としてタブ文字を受け入れられるようにするには、<xref:System.Windows.Controls.Primitives.TextBoxBase.AcceptsTab%2A> 属性を **true** に設定します。  
+  
+ [!code-xml[TextBox_EnablingTab#_AcceptsTab](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_EnablingTab/CS/Window1.xaml#_acceptstab)]  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-extract-the-text-content-from-a-richtextbox.md b/docs/framework/wpf/controls/how-to-extract-the-text-content-from-a-richtextbox.md
new file mode 100644
index 00000000000..f29538a47c1
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-extract-the-text-content-from-a-richtextbox.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : RichTextBox からテキスト コンテンツを抽出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテンツ, 抽出"
+  - "抽出 (テキスト コンテンツを)"
+  - "RichTextBox コントロール, 抽出 (テキスト コンテンツを)"
+  - "テキスト コンテンツ, 抽出"
+ms.assetid: f13c093f-1a05-45b3-ac8f-c9ea5e4a11c5
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : RichTextBox からテキスト コンテンツを抽出する
+この例では、<xref:System.Windows.Controls.RichTextBox> のコンテンツをプレーン テキストとして抽出する方法を示します。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] コードは、簡単なコンテンツを含む <xref:System.Windows.Controls.RichTextBox> コントロールを記述しています。  
+  
+ [!code-xml[RichTextBoxSnippets#_RTB_XAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxSnippets/CSharp/Window1.xaml#_rtb_xaml)]  
+  
+## 使用例  
+ 次のコードでは、引数として <xref:System.Windows.Controls.RichTextBox> を受け取り、<xref:System.Windows.Controls.RichTextBox> のプレーン テキスト コンテンツを表す文字列を返すメソッドを実装します。  
+  
+ このメソッドは、抽出するコンテンツの範囲を示す <xref:System.Windows.Documents.FlowDocument.ContentStart%2A> および <xref:System.Windows.Documents.FlowDocument.ContentEnd%2A> を使用して、<xref:System.Windows.Controls.RichTextBox> のコンテンツから新しい <xref:System.Windows.Documents.TextRange> を作成します。  <xref:System.Windows.Documents.FlowDocument.ContentStart%2A> プロパティと <xref:System.Windows.Documents.FlowDocument.ContentEnd%2A> プロパティはそれぞれ <xref:System.Windows.Documents.TextPointer> を返し、<xref:System.Windows.Controls.RichTextBox> のコンテンツを表す基の FlowDocument でアクセスできます。  <xref:System.Windows.Documents.TextRange> は Text プロパティを提供し、<xref:System.Windows.Documents.TextRange> のプレーン テキスト部分を文字列として返します。  
+  
+ [!code-csharp[RichTextBoxSnippets#_RTB_StringFrom](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxSnippets/CSharp/Window1.xaml.cs#_rtb_stringfrom)]
+ [!code-vb[RichTextBoxSnippets#_RTB_StringFrom](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBoxSnippets/visualbasic/window1.xaml.vb#_rtb_stringfrom)]  
+  
+## 参照  
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-find-a-treeviewitem-in-a-treeview.md b/docs/framework/wpf/controls/how-to-find-a-treeviewitem-in-a-treeview.md
new file mode 100644
index 00000000000..c519f6efa67
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-find-a-treeviewitem-in-a-treeview.md
@@ -0,0 +1,49 @@
+---
+title: "方法: TreeView で TreeViewItem を検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TreeView コントロール [WPF], 検索 (TreeViewItem を)"
+  - "TreeViewItem [WPF], 検索"
+ms.assetid: 72ecd40c-3939-4e01-b617-5e9daa6074d9
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: TreeView で TreeViewItem を検索する
+<xref:System.Windows.Controls.TreeView> コントロールは、階層データを表示するための便利な方法を提供します。  <xref:System.Windows.Controls.TreeView> をデータ ソースにバインドすると、<xref:System.Windows.Controls.TreeView.SelectedItem%2A> プロパティでは、選択したデータ オブジェクトをすばやく取得するための便利な方法を使用できるようになります。  通常、基になるデータ オブジェクトを使用することが最適な方法ですが、データが含まれている <xref:System.Windows.Controls.TreeViewItem> をプログラムで操作することが必要になる場合もあります。  たとえば、<xref:System.Windows.Controls.TreeViewItem> をプログラムで展開すること、または <xref:System.Windows.Controls.TreeView> 内の別の項目をプログラムで選択することが必要になる場合があります。  
+  
+ 特定のデータ オブジェクトを含む <xref:System.Windows.Controls.TreeViewItem> を検索するには、<xref:System.Windows.Controls.TreeView> の各レベルを走査する必要があります。  また、パフォーマンスを向上させるために、<xref:System.Windows.Controls.TreeView> 内の項目を仮想化することもできます。  項目を仮想化する場合は、<xref:System.Windows.Controls.TreeViewItem> を取得して、そこにデータ オブジェクトが含まれているかどうかを確認することも必要です。  
+  
+## 使用例  
+  
+## Description  
+ 次の例では、<xref:System.Windows.Controls.TreeView> 内で特定のオブジェクトを検索し、オブジェクトが含まれている <xref:System.Windows.Controls.TreeViewItem> を返します。  この例では、子項目を検索できるように各 <xref:System.Windows.Controls.TreeViewItem> をインスタンス化する必要があります。  この例は、<xref:System.Windows.Controls.TreeView> に仮想化された項目がない場合も適用できます。  
+  
+> [!NOTE]
+>  次の例は、基になるデータ モデルに関係なく、あらゆる <xref:System.Windows.Controls.TreeView> に適用できます。オブジェクトが見つかるまで、それぞれの <xref:System.Windows.Controls.TreeViewItem> を検索します。  より優れたパフォーマンスを実現するもう 1 つの方法は、データ モデル内で特定のオブジェクトを検索し、データ階層内のその場所を追跡して、<xref:System.Windows.Controls.TreeView> 内の対応する <xref:System.Windows.Controls.TreeViewItem> を見つけることです。  ただし、より優れたパフォーマンスを実現する方法は、データ モデルについての知識を必要とし、任意の <xref:System.Windows.Controls.TreeView> について一般化することはできません。  
+  
+## コード  
+ [!code-csharp[TreeViewFindTVI#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewFindTVI/CSharp/MainWindow.xaml.cs#1)]
+ [!code-vb[TreeViewFindTVI#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TreeViewFindTVI/VisualBasic/MainWindow.xaml.vb#1)]  
+  
+ 前のコードは、`BringIntoView` という名前のメソッドを公開するカスタム <xref:System.Windows.Controls.VirtualizingStackPanel> に依存します。  次のコードは、カスタム <xref:System.Windows.Controls.VirtualizingStackPanel> を定義します。  
+  
+ [!code-csharp[TreeViewFindTVI#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewFindTVI/CSharp/MainWindow.xaml.cs#2)]
+ [!code-vb[TreeViewFindTVI#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TreeViewFindTVI/VisualBasic/MainWindow.xaml.vb#2)]  
+  
+ 次の XAML は、カスタム <xref:System.Windows.Controls.VirtualizingStackPanel> を使用する <xref:System.Windows.Controls.TreeView> を作成する方法を示します。  
+  
+ [!code-xml[TreeViewFindTVI#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewFindTVI/CSharp/MainWindow.xaml#3)]  
+  
+## 参照  
+ [TreeView のパフォーマンスを改善する](../../../../docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md b/docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md
new file mode 100644
index 00000000000..21db9567ea0
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ControlTemplate によって生成された要素を検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], 検索 (要素を)"
+  - "検索 (ControlTemplate 要素を)"
+ms.assetid: d7b25447-ceff-4bb4-9be5-fd7c40ef00af
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ControlTemplate によって生成された要素を検索する
+この例では、<xref:System.Windows.Controls.ControlTemplate> によって生成された要素の検索方法について説明します。  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Controls.Button> クラス用のシンプルな <xref:System.Windows.Controls.ControlTemplate> を作成するスタイルを示しています。  
+  
+ [!code-xml[FindGeneratedItems#CT](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml#ct)]  
+  
+ テンプレートの適用後にテンプレート内の要素を検索するには、<xref:System.Windows.Controls.Control.Template%2A> の <xref:System.Windows.FrameworkTemplate.FindName%2A> メソッドを呼び出します。  次の例は、コントロール テンプレート内にある <xref:System.Windows.Controls.Grid> の実際の幅の値を表示するメッセージ ボックスを作成しています。  
+  
+ [!code-csharp[FindGeneratedItems#CTFindElement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml.cs#ctfindelement)]
+ [!code-vb[FindGeneratedItems#CTFindElement](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindGeneratedItems/VisualBasic/Window1.xaml.vb#ctfindelement)]  
+  
+## 参照  
+ [DataTemplate によって生成された要素を検索する](../../../../docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [WPF XAML 名前スコープ](../../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)   
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-get-a-collection-of-lines-from-a-textbox.md b/docs/framework/wpf/controls/how-to-get-a-collection-of-lines-from-a-textbox.md
new file mode 100644
index 00000000000..e1e4e8d9897
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-get-a-collection-of-lines-from-a-textbox.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : TextBox から行のコレクションを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "線, 取得 (コレクションを)"
+  - "TextBox コントロール, 取得 (行のコレクションを)"
+ms.assetid: a12f529d-b926-47f6-92bf-cad5f17b532a
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : TextBox から行のコレクションを取得する
+この例では、<xref:System.Windows.Controls.TextBox> からテキスト行のコレクションを取得する方法を示します。  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Controls.TextBox> を引数とし、**TextBox** 内のテキスト行を含む <xref:System.Collections.Specialized.StringCollection> を返す単純なメソッドを示しています。  <xref:System.Windows.Controls.TextBox.LineCount%2A> プロパティは、**TextBox** 内の現在の行数を確認するために使用し、<xref:System.Windows.Controls.TextBox.GetLineText%2A> メソッドは、各行を抽出してそれを行のコレクションに追加するために使用します。  
+  
+ [!code-csharp[TextBox_MiscCode#_TextBox_GetLines](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_textbox_getlines)]  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-get-a-listboxitem.md b/docs/framework/wpf/controls/how-to-get-a-listboxitem.md
new file mode 100644
index 00000000000..5098a60ed28
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-get-a-listboxitem.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : ListBoxItem を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListBox コントロール, 取得 (ListBoxItem を)"
+  - "ListBoxItem"
+ms.assetid: da877c6f-5fd8-40cb-8909-225cbfd99aa5
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ListBoxItem を取得する
+<xref:System.Windows.Controls.ListBox> の特定のインデックス位置にある特定の <xref:System.Windows.Controls.ListBoxItem> を取得する必要がある場合は、<xref:System.Windows.Controls.ItemContainerGenerator> を使用できます。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.ListBox> とその項目の例を次に示します。  
+  
+ [!code-xml[ListBoxItems#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems/CSharp/Window1.xaml#1)]  
+  
+ 次の例では、<xref:System.Windows.Controls.ItemContainerGenerator> の <xref:System.Windows.Controls.ItemContainerGenerator.ContainerFromIndex%2A> プロパティ内項目のインデックスを指定してアイテムを取得する方法を示しています。  
+  
+ [!code-csharp[ListBoxItems#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[ListBoxItems#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListBoxItems/VisualBasic/Window1.xaml.vb#2)]  
+  
+ リスト ボックスの項目を取得したら、次の例に示すように、項目のコンテンツを表示できます。  
+  
+ [!code-csharp[ListBoxItems#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxItems/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[ListBoxItems#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListBoxItems/VisualBasic/Window1.xaml.vb#3)]
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-get-or-set-a-dock-value.md b/docs/framework/wpf/controls/how-to-get-or-set-a-dock-value.md
new file mode 100644
index 00000000000..28211ade78a
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-get-or-set-a-dock-value.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : Dock の値を取得または設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Dock 値, 取得"
+  - "Dock 値, 設定"
+ms.assetid: fcf4ab8a-c7cd-4835-8d04-de1c999ab4a8
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : Dock の値を取得または設定する
+次の例では、オブジェクトに <xref:System.Windows.Controls.Dock> 値を割り当てる方法を示します。  この例では、<xref:System.Windows.Controls.DockPanel> の <xref:System.Windows.Controls.DockPanel.GetDock%2A> メソッドと <xref:System.Windows.Controls.DockPanel.SetDock%2A> メソッドを使用します。  
+  
+## 使用例  
+ この例では、<xref:System.Windows.Controls.TextBlock> 要素のインスタンスである `txt1` を作成し、<xref:System.Windows.Controls.DockPanel> の <xref:System.Windows.Controls.DockPanel.SetDock%2A> メソッドを使用して `Top` の <xref:System.Windows.Controls.Dock> 値を割り当てます。  次に、<xref:System.Windows.Controls.DockPanel.GetDock%2A> メソッドを使用して、<xref:System.Windows.Controls.TextBlock> 要素の <xref:System.Windows.Controls.TextBlock.Text%2A> に <xref:System.Windows.Controls.Dock> プロパティの値を追加します。  最後に、<xref:System.Windows.Controls.TextBlock> 要素を、親 <xref:System.Windows.Controls.DockPanel> である `dp1` に追加します。  
+  
+ [!code-csharp[DockPanelSetDock#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DockPanelSetDock/CSharp/DockPanel_SetDock.cs#1)]
+ [!code-vb[DockPanelSetDock#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DockPanelSetDock/VisualBasic/DockPanel_SetDock.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.DockPanel>   
+ <xref:System.Windows.Controls.DockPanel.GetDock%2A>   
+ <xref:System.Windows.Controls.DockPanel.SetDock%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-get-or-set-canvas-positioning-properties.md b/docs/framework/wpf/controls/how-to-get-or-set-canvas-positioning-properties.md
new file mode 100644
index 00000000000..fcfb6eb8dae
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-get-or-set-canvas-positioning-properties.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : Canvas の配置プロパティを取得または設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Canvas コントロール, 設定 (位置決めのプロパティを)"
+ms.assetid: 1636b950-2b5a-4507-8a10-c5034cc58b1c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : Canvas の配置プロパティを取得または設定する
+この例では、<xref:System.Windows.Controls.Canvas> 要素の配置メソッドを使用して子要素を配置する方法を示します。  この例では、<xref:System.Windows.Controls.ListBoxItem> 内のコンテンツを使用して配置の値を表し、その値を、配置に必要な引数である <xref:System.Double> のインスタンスに変換します。  次に、この値を文字列に戻し、<xref:System.Windows.Controls.Canvas.GetLeft%2A> メソッドを使用して <xref:System.Windows.Controls.TextBlock> 要素にテキストとして表示します。  
+  
+## 使用例  
+ 次の例では、11 個の選択可能な <xref:System.Windows.Controls.ListBoxItem> 要素を持つ <xref:System.Windows.Controls.ListBox> 要素を作成します。  <xref:System.Windows.Controls.Primitives.Selector.SelectionChanged> イベントは、後続のコード ブロックで定義される `ChangeLeft` カスタム メソッドをトリガーします。  
+  
+ 各 <xref:System.Windows.Controls.ListBoxItem> は、<xref:System.Double> 値を表します。この値は、<xref:System.Windows.Controls.Canvas> の <xref:System.Windows.Controls.Canvas.SetLeft%2A> メソッドが受け入れる引数の 1 つです。  <xref:System.Windows.Controls.ListBoxItem> を使用して <xref:System.Double> のインスタンスを表すためには、最初に <xref:System.Windows.Controls.ListBoxItem> を正しいデータ型に変換する必要があります。  
+  
+ [!code-xml[CanvasPositioningProperties#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasPositioningProperties/CSharp/Window1.xaml#1)]  
+  
+ ユーザーが <xref:System.Windows.Controls.ListBox> の選択項目を変更すると、`ChangeLeft` カスタム メソッドが呼び出されます。  このメソッドは <xref:System.Windows.Controls.ListBoxItem> を <xref:System.Windows.LengthConverter> オブジェクトに渡します。このオブジェクトは、<xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.Double> のインスタンスに変換します \(この値は、<xref:System.Windows.Controls.Control.ToString%2A> メソッドを使用して既に <xref:System.String> に変換されていることに注意してください\)。  この値は、`text1` オブジェクトの位置を変更するために、<xref:System.Windows.Controls.Canvas> の <xref:System.Windows.Controls.Canvas.SetLeft%2A> メソッドと <xref:System.Windows.Controls.Canvas.GetLeft%2A> メソッドに渡されます。  
+  
+ [!code-csharp[CanvasPositioningProperties#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasPositioningProperties/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[CanvasPositioningProperties#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CanvasPositioningProperties/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Canvas>   
+ <xref:System.Windows.Controls.ListBoxItem>   
+ <xref:System.Windows.LengthConverter>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-group-items-in-a-listview-that-implements-a-gridview.md b/docs/framework/wpf/controls/how-to-group-items-in-a-listview-that-implements-a-gridview.md
new file mode 100644
index 00000000000..60b3b9a20d7
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-group-items-in-a-listview-that-implements-a-gridview.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : GridView を実装する ListView の項目をグループ化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GridView コントロール, グループ化 (項目を)"
+  - "グループ化 (GridView を実装する ListView で項目を)"
+  - "ListView コントロール, グループ化 (GridView で項目を)"
+ms.assetid: eebef25b-ddc6-424e-a66d-ea228d1bf33d
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : GridView を実装する ListView の項目をグループ化する
+この例では、 <xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.GridView> ビュー モードでグループの項目を表示する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.ListView> でグループの項目を表示するには、<xref:System.Windows.Data.CollectionViewSource> を定義します。  次の例では、 `Catalog` データ フィールドの値に従ってデータ項目をグループ化する <xref:System.Windows.Data.CollectionViewSource> を示します。  
+  
+ [!code-xml[GridViewWithGroups#GroupingCollectionViewSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridViewWithGroups/CS/Window1.xaml#groupingcollectionviewsource)]  
+  
+ 次の例では、前の例で定義される <xref:System.Windows.Data.CollectionViewSource> に、<xref:System.Windows.Controls.ListView> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> が設定されます。  また、この例では <xref:System.Windows.Controls.Expander> コントロールを実装する <xref:System.Windows.Controls.ItemsControl.GroupStyle%2A> も定義されます。  
+  
+ [!code-xml[GridViewWithGroups#ListViewGroups](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridViewWithGroups/CS/Window1.xaml#listviewgroups)]  
+[!code-xml[GridViewWithGroups#ListViewEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridViewWithGroups/CS/Window1.xaml#listviewend)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-group-sort-and-filter-data-in-the-datagrid-control.md b/docs/framework/wpf/controls/how-to-group-sort-and-filter-data-in-the-datagrid-control.md
new file mode 100644
index 00000000000..6b633e08244
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-group-sort-and-filter-data-in-the-datagrid-control.md
@@ -0,0 +1,161 @@
+---
+title: "方法: DataGrid コントロールでデータをグループ化、並べ替え、およびフィルター処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataGrid [WPF], フィルター"
+  - "DataGrid [WPF], グループ"
+  - "DataGrid [WPF], 並べ替え"
+ms.assetid: 03345e85-89e3-4aec-9ed0-3b80759df770
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: DataGrid コントロールでデータをグループ化、並べ替え、およびフィルター処理する
+<xref:System.Windows.Controls.DataGrid> はグループ化、並べ替え、フィルターなどを適用することによって、さまざまな角度からデータを表示することができます。  <xref:System.Windows.Controls.DataGrid> のデータをグループ化、並べ替え、およびフィルター処理するには、これらの機能がサポートされている <xref:System.Windows.Data.CollectionView> に DataGrid をバインドします。  そうすると、<xref:System.Windows.Data.CollectionView> のデータを操作できるようになり、基になるソース データに影響が及ぶことはありません。  コレクション ビューにおける変更は、<xref:System.Windows.Controls.DataGrid> のユーザー インターフェイス \(UI\) に反映されます。  
+  
+ <xref:System.Windows.Data.CollectionView> クラスには、<xref:System.Collections.IEnumerable> インターフェイスを実装したデータ ソースに対するグループ化および並べ替えの機能があります。  <xref:System.Windows.Data.CollectionViewSource> クラスを使用すると、XAML の <xref:System.Windows.Data.CollectionView> のプロパティを設定できます。  
+  
+ この例では、`Task` オブジェクトのコレクションが <xref:System.Windows.Data.CollectionViewSource> オブジェクトにバインドされます。  この <xref:System.Windows.Data.CollectionViewSource> が <xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> として使用されます。  グループ化、並べ替え、およびフィルター処理は <xref:System.Windows.Data.CollectionViewSource> に対して実行され、<xref:System.Windows.Controls.DataGrid> の UI に表示されることになります。  
+  
+ ![DataGrid のグループ化されたデータ](../../../../docs/framework/wpf/controls/media/wpf-datagridgroups.png "WPF\_DataGridGroups")  
+DataGrid 内のグループ化されたデータ  
+  
+## CollectionViewSource を ItemsSource として使用する  
+ <xref:System.Windows.Controls.DataGrid> コントロールのデータをグループ化、並べ替え、およびフィルター処理するには、これらの機能がサポートされている <xref:System.Windows.Data.CollectionView> に <xref:System.Windows.Controls.DataGrid> をバインドします。  この例では、`Task` オブジェクトのコレクションをラップする <xref:System.Windows.Data.CollectionViewSource> に <xref:System.Windows.Controls.DataGrid> をバインドすることによって、このオブジェクトの <xref:System.Collections.Generic.List%601> データをさまざまな角度から表示できるようにします。  
+  
+#### DataGrid を CollectionViewSource にバインドするには  
+  
+1.  <xref:System.Collections.IEnumerable> インターフェイスを実装するデータ コレクションを作成します。  
+  
+     <xref:System.Collections.Generic.List%601> を使用してコレクションを作成する場合、<xref:System.Collections.Generic.List%601> のインスタンスをインスタンス化する代わりに、<xref:System.Collections.Generic.List%601> を継承する新しいクラスを作成する必要があります。  これにより、XAML のコレクションへのデータ バインドが可能になります。  
+  
+    > [!NOTE]
+    >  プロパティの変化や編集に対して <xref:System.Windows.Controls.DataGrid> が正しく応答するためには、コレクション内のオブジェクトに <xref:System.ComponentModel.INotifyPropertyChanged> 変更通知インターフェイスおよび <xref:System.ComponentModel.IEditableObject> インターフェイスが実装されている必要があります。  詳細については、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」を参照してください。  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#101)]
+     [!code-vb[DataGrid_GroupSortFilter#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#101)]  
+  
+2.  XAML で、コレクション クラスのインスタンスを作成し、[x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)を設定します。  
+  
+3.  XAML で、<xref:System.Windows.Data.CollectionViewSource> クラスのインスタンスを作成し、[x:Key ディレクティブ](../../../../docs/framework/xaml-services/x-key-directive.md)を設定します。次に、コレクション クラスのインスタンスを <xref:System.Windows.Data.CollectionViewSource.Source%2A> として設定します。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#201](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/WindowSnips1.xaml#201)]  
+  
+4.  <xref:System.Windows.Controls.DataGrid> クラスのインスタンスを作成し、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを <xref:System.Windows.Data.CollectionViewSource> に設定します。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#002](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#002)]  
+  
+5.  コードから <xref:System.Windows.Data.CollectionViewSource> にアクセスするには、<xref:System.Windows.Data.CollectionViewSource.GetDefaultView%2A> メソッドを使用して、<xref:System.Windows.Data.CollectionViewSource> の参照を取得します。  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#102)]
+     [!code-vb[DataGrid_GroupSortFilter#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#102)]  
+  
+## DataGrid 内の項目をグループ化する  
+ <xref:System.Windows.Controls.DataGrid> における項目のグループ化方法を指定するには、<xref:System.Windows.Data.PropertyGroupDescription> 型を使用し、ソース ビューで項目をグループ化します。  
+  
+#### XAML を使用して DataGrid 内の項目をグループ化するには  
+  
+1.  グループ化に使用するプロパティを指定する <xref:System.Windows.Data.PropertyGroupDescription> を作成します。  プロパティは、XAML またはコードで指定できます。  
+  
+    1.  XAML では、<xref:System.Windows.Data.PropertyGroupDescription.PropertyName%2A> をグループ化に使用するプロパティの名前に設定します。  
+  
+    2.  コードでは、グループ化に使用するプロパティの名前をコンストラクターに渡します。  
+  
+2.  <xref:System.Windows.Data.PropertyGroupDescription> を <xref:System.Windows.Data.CollectionViewSource.GroupDescriptions%2A?displayProperty=fullName> コレクションに追加します。  
+  
+3.  グループ化のレベルを追加するには、<xref:System.Windows.Data.PropertyGroupDescription> の別のインスタンスを <xref:System.Windows.Data.CollectionViewSource.GroupDescriptions%2A> コレクションに追加します。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#012](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#012)]  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#112](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#112)]
+     [!code-vb[DataGrid_GroupSortFilter#112](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#112)]  
+  
+4.  グループを削除するには、<xref:System.Windows.Data.PropertyGroupDescription> を <xref:System.Windows.Data.CollectionViewSource.GroupDescriptions%2A> コレクションから削除します。  
+  
+5.  すべてのグループを削除するには、<xref:System.Windows.Data.CollectionViewSource.GroupDescriptions%2A> コレクションの <xref:System.Collections.ObjectModel.Collection%601.Clear%2A> メソッドを呼び出します。  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#114](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#114)]
+     [!code-vb[DataGrid_GroupSortFilter#114](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#114)]  
+  
+ <xref:System.Windows.Controls.DataGrid> 内の項目をグループ化した場合、各グループの外観を指定する <xref:System.Windows.Controls.GroupStyle> を定義できます。  <xref:System.Windows.Controls.GroupStyle> を適用するには、これを DataGrid の <xref:System.Windows.Controls.ItemsControl.GroupStyle%2A> コレクションに追加します。  グループ化のレベルが複数存在する場合は、グループ レベルごとに異なるスタイルを定義できます。  スタイルはその定義順に適用されます。  たとえば、2 つのスタイルを定義した場合、最上位の行グループには 1 つ目のスタイルが適用されます。  第 2 レベル以下のすべての行グループには、2 つ目のスタイルが適用されます。  <xref:System.Windows.Controls.GroupStyle> の <xref:System.Windows.FrameworkElement.DataContext%2A> は、グループが表す <xref:System.Windows.Data.CollectionViewGroup> です。  
+  
+#### 行グループ ヘッダーの外観を変更するには  
+  
+1.  行グループの外観を定義する <xref:System.Windows.Controls.GroupStyle> を作成します。  
+  
+2.  <xref:System.Windows.Controls.GroupStyle> を `<DataGrid.GroupStyle>` タグ内に配置します。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#003](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#003)]  
+  
+## DataGrid 内の項目を並べ替える  
+ <xref:System.Windows.Controls.DataGrid> における項目の並べ替え方法を指定するには、<xref:System.ComponentModel.SortDescription> 型を使用し、ソース ビューで項目を並べ替えます。  
+  
+#### DataGrid 内の項目を並べ替えるには  
+  
+1.  並べ替えに使用するプロパティを指定する <xref:System.ComponentModel.SortDescription> を作成します。  プロパティは、XAML またはコードで指定できます。  
+  
+    1.  XAML では、<xref:System.ComponentModel.SortDescription.PropertyName%2A> を並べ替えに使用するプロパティの名前に設定します。  
+  
+    2.  コードでは、並べ替えに使用するプロパティの名前と <xref:System.ComponentModel.ListSortDirection> をコンストラクターに渡します。  
+  
+2.  <xref:System.ComponentModel.SortDescription> を <xref:System.Windows.Data.CollectionViewSource.SortDescriptions%2A?displayProperty=fullName> コレクションに追加します。  
+  
+3.  並べ替えの基準として使用するプロパティを追加するには、<xref:System.ComponentModel.SortDescription> の別のインスタンスを <xref:System.Windows.Data.CollectionViewSource.SortDescriptions%2A> コレクションに追加します。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#011](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#011)]  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#211](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/WindowSnips1.xaml.cs#211)]
+     [!code-vb[DataGrid_GroupSortFilter#211](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#211)]  
+  
+## DataGrid 内の項目をフィルター処理するには  
+ <xref:System.Windows.Data.CollectionViewSource> を使用して <xref:System.Windows.Controls.DataGrid> 内の項目をフィルター処理するには、<xref:System.Windows.Data.CollectionViewSource.Filter?displayProperty=fullName> イベントのハンドラーにフィルタリング ロジックを指定します。  
+  
+#### DataGrid 内の項目をフィルター処理するには  
+  
+1.  <xref:System.Windows.Data.CollectionViewSource.Filter?displayProperty=fullName> イベントのハンドラーを追加します。  
+  
+2.  <xref:System.Windows.Data.CollectionViewSource.Filter> イベント ハンドラーで、フィルター処理のロジックを定義します。  
+  
+     フィルターは、ビューが更新されるたびに適用されます。  
+  
+     [!code-xml[DataGrid_GroupSortFilter#013](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#013)]  
+  
+     [!code-csharp[DataGrid_GroupSortFilter#113](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#113)]
+     [!code-vb[DataGrid_GroupSortFilter#113](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#113)]  
+  
+ また、<xref:System.Windows.Controls.DataGrid> 内の項目をフィルター処理する別の方法として、フィルター処理のロジックを提供するメソッドを作成し、フィルターを適用する <xref:System.Windows.Data.CollectionView.Filter%2A?displayProperty=fullName> プロパティを設定します。  この方法の例については、「[ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Data.CollectionViewSource> 内の `Task` データをグループ化、並べ替え、およびフィルター処理し、その結果の `Task` データを <xref:System.Windows.Controls.DataGrid> に表示します。  この <xref:System.Windows.Data.CollectionViewSource> が <xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> として使用されます。  グループ化、並べ替え、およびフィルター処理は <xref:System.Windows.Data.CollectionViewSource> に対して実行され、<xref:System.Windows.Controls.DataGrid> の UI に表示されることになります。  
+  
+ この例をテストするには、プロジェクト名に合わせて DGGroupSortFilterExample 名を調整する必要があります。  Visual Basic を使用している場合は、<xref:System.Windows.Window> のクラス名を以下の名前に変更する必要があります。  
+  
+ `<Window x:Class="MainWindow"`  
+  
+ [!code-xml[DataGrid_GroupSortFilter#000](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml#000)]  
+  
+ [!code-csharp[DataGrid_GroupSortFilter#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_GroupSortFilter/CS/MainWindow.xaml.cs#100)]
+ [!code-vb[DataGrid_GroupSortFilter#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_GroupSortFilter/VB/MainWindow.xaml.vb#100)]  
+  
+## コードのコンパイル  
+  
+## 信頼性の高いプログラミング  
+  
+## .NET Framework セキュリティ  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ObservableCollection を作成およびバインドする](../../../../docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md)   
+ [ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)   
+ [ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)   
+ [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-handle-the-mousedoubleclick-event-for-each-item-in-a-listview.md b/docs/framework/wpf/controls/how-to-handle-the-mousedoubleclick-event-for-each-item-in-a-listview.md
new file mode 100644
index 00000000000..bb7b48d4370
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-handle-the-mousedoubleclick-event-for-each-item-in-a-listview.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ListView の各項目の MouseDoubleClick イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール, MouseDoubleClick イベント"
+ms.assetid: 81b39369-655a-4585-ac58-4640e5bb8fed
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ListView の各項目の MouseDoubleClick イベントを処理する
+<xref:System.Windows.Controls.ListView> の項目のイベントを処理するには、各 <xref:System.Windows.Controls.ListViewItem> にイベント ハンドラーを追加する必要があります。  <xref:System.Windows.Controls.ListView> がデータ ソースにバインドされている場合、<xref:System.Windows.Controls.ListViewItem> を明示的には作成しませんが、<xref:System.Windows.Controls.ListViewItem> のスタイルに <xref:System.Windows.EventSetter> を追加することで、各項目のイベントを処理できます。  
+  
+## 使用例  
+ データ バインド <xref:System.Windows.Controls.ListView> を作成し、各 <xref:System.Windows.Controls.ListViewItem> にイベント ハンドラーを追加する <xref:System.Windows.Style> を作成する例を次に示します。  
+  
+ [!code-xml[ListViewHowTos#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#1)]  
+[!code-xml[ListViewHowTos#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#5)]  
+[!code-xml[ListViewHowTos#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml#2)]  
+  
+ <xref:System.Windows.Controls.Control.MouseDoubleClick> イベントを処理する例を次に示します。  
+  
+ [!code-csharp[ListViewHowTos#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewHowTos/CSharp/Window1.xaml.cs#6)]
+ [!code-vb[ListViewHowTos#6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListViewHowTos/VisualBasic/Window1.xaml.vb#6)]  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.ListView> をデータ ソースにバインドすることはきわめて一般的ですが、非データ バインド <xref:System.Windows.Controls.ListView> で、<xref:System.Windows.Controls.ListViewItem> を明示的に作成するかどうかに関係なく、スタイルを使用して各 <xref:System.Windows.Controls.ListViewItem> にイベント ハンドラーを追加することができます。  明示的および暗黙的に作成された <xref:System.Windows.Controls.ListViewItem> コントロールの詳細については、「<xref:System.Windows.Controls.ItemsControl>」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlElement>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-handle-the-scrollchanged-event.md b/docs/framework/wpf/controls/how-to-handle-the-scrollchanged-event.md
new file mode 100644
index 00000000000..462bd7cbd25
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-handle-the-scrollchanged-event.md
@@ -0,0 +1,38 @@
+---
+title: "方法: ScrollChanged イベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ScrollChanged イベント"
+  - "ScrollViewer コントロール, 発生 (ScrollChanged イベントを)"
+ms.assetid: 42c695d8-ee28-49d4-80fd-fc71e9be7f29
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: ScrollChanged イベントを処理する
+## 使用例  
+ この例では、<xref:System.Windows.Controls.ScrollViewer> の <xref:System.Windows.Controls.ScrollViewer.ScrollChanged> イベントを処理する方法を示します。  
+  
+ <xref:System.Windows.Documents.Paragraph> パーツを含む <xref:System.Windows.Documents.FlowDocument> 要素が、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義されています。  ユーザーの操作によって <xref:System.Windows.Controls.ScrollViewer.ScrollChanged> イベントが発生すると、ハンドラーが呼び出されて、イベントが発生したことを示すテキストが <xref:System.Windows.Controls.TextBlock> に書き込まれます。  
+  
+ [!code-xml[scrollchangedeventargsLayout#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/scrollchangedeventargsLayout/CSharp/Window1.xaml#1)]  
+[!code-xml[scrollchangedeventargsLayout#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/scrollchangedeventargsLayout/CSharp/Window1.xaml#2)]  
+  
+ [!code-csharp[scrollchangedeventargsLayout#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/scrollchangedeventargsLayout/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[scrollchangedeventargsLayout#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/scrollchangedeventargsLayout/VisualBasic/Window1.xaml.vb#3)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ScrollViewer>   
+ <xref:System.Windows.Controls.ScrollViewer.ScrollChanged>   
+ <xref:System.Windows.Controls.ScrollChangedEventHandler>   
+ <xref:System.Windows.Controls.ScrollChangedEventArgs>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-horizontally-or-vertically-align-content-in-a-stackpanel.md b/docs/framework/wpf/controls/how-to-horizontally-or-vertically-align-content-in-a-stackpanel.md
new file mode 100644
index 00000000000..58756f023d3
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-horizontally-or-vertically-align-content-in-a-stackpanel.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : StackPanel にコンテンツを水平方向または垂直方向に配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エイリアスの使用, コンテンツ"
+  - "コンテンツの配置"
+  - "StackPanel コントロール, コンテンツの配置"
+ms.assetid: c1e8f962-72c8-4e7a-8670-7a2d7e021791
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : StackPanel にコンテンツを水平方向または垂直方向に配置する
+この例では、<xref:System.Windows.Controls.StackPanel> 要素内のコンテンツの <xref:System.Windows.Controls.StackPanel.Orientation%2A> を調整する方法、および子コンテンツの <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> と <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> を調整する方法を示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で 3 つの <xref:System.Windows.Controls.ListBox> 要素を作成する例を次に示します。  それぞれの <xref:System.Windows.Controls.ListBox> が、<xref:System.Windows.Controls.StackPanel> の <xref:System.Windows.Controls.StackPanel.Orientation%2A>、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、および <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> の各プロパティに指定できる値を表します。  ユーザーがいずれかの <xref:System.Windows.Controls.ListBox> 要素で値を選択すると、<xref:System.Windows.Controls.StackPanel> 要素の関連するプロパティと、その子要素である <xref:System.Windows.Controls.Button> が変わります。  
+  
+ [!code-xml[StackPanelIntroSamp#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StackPanelIntroSamp/CSharp/Window1.xaml#1)]  
+  
+ 次の分離コード ファイルでは、<xref:System.Windows.Controls.ListBox> の選択の変更に関連付けられているイベントに対する変更を定義します。  <xref:System.Windows.Controls.StackPanel> は、<xref:System.Windows.FrameworkElement.Name%2A> `sp1` で識別されます。  
+  
+ [!code-csharp[StackPanelIntroSamp#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StackPanelIntroSamp/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[StackPanelIntroSamp#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StackPanelIntroSamp/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.StackPanel>   
+ <xref:System.Windows.Controls.ListBox>   
+ <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>   
+ <xref:System.Windows.FrameworkElement.VerticalAlignment%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-implement-an-adorner.md b/docs/framework/wpf/controls/how-to-implement-an-adorner.md
new file mode 100644
index 00000000000..52f56f9c613
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-implement-an-adorner.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 装飾を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾, 実装"
+ms.assetid: 56ae32b6-0599-455c-b52f-2ff97e6f1ec2
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 装飾を実装する
+この例では、最小限の装飾の実装を示します。  
+  
+## 実装についてのメモ  
+ Adorner 自体には継承されたレンダリング動作は含まれず、Adorner のレンダリングは Adorner の実装者の責任で行う必要がある点について注意が必要です。  レンダリング動作を実装する一般的な方法としては、<xref:System.Windows.UIElement.OnRender%2A> メソッドをオーバーライドし、1 つ以上の <xref:System.Windows.Media.DrawingContext> オブジェクトを使用して、装飾のビジュアルを必要に応じて描画します \(次の例を参照\)。  
+  
+## 例  
+  
+### Description  
+ 抽象型 <xref:System.Windows.Documents.Adorner> クラスから継承されるクラスを実装することにより、カスタムの Adorner が作成されます。  この例の装飾では、<xref:System.Windows.UIElement.OnRender%2A> メソッドをオーバーライドして <xref:System.Windows.UIElement> の四隅を円で装飾します。  
+  
+### コード  
+ [!code-csharp[Adorners_SimpleCircleAdorner#_SimpleCircleAdornerBody](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/CSharp/Window1.xaml.cs#_simplecircleadornerbody)]
+ [!code-vb[Adorners_SimpleCircleAdorner#_SimpleCircleAdornerBody](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Adorners_SimpleCircleAdorner/VisualBasic/Window1.xaml.vb#_simplecircleadornerbody)]  
+  
+## 参照  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-implement-validation-with-the-datagrid-control.md b/docs/framework/wpf/controls/how-to-implement-validation-with-the-datagrid-control.md
new file mode 100644
index 00000000000..6ff666199f2
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-implement-validation-with-the-datagrid-control.md
@@ -0,0 +1,102 @@
+---
+title: "方法: DataGrid コントロールを使用して検証を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataGrid [WPF], 検証"
+  - "検証 [WPF], DataGrid"
+ms.assetid: ec6078a8-1e42-4648-b414-f4348e81bda1
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法: DataGrid コントロールを使用して検証を実装する
+<xref:System.Windows.Controls.DataGrid> コントロールでは、セル レベルと行レベルの両方で検証を実行できます。  セル レベルの検証では、ユーザーが値を更新したときに、バインドされたデータ オブジェクトの個々のプロパティを検証します。  行レベルの検証では、ユーザーが行に対する変更をコミットしたときに、データ オブジェクト全体を検証します。  検証エラーに対してカスタマイズした視覚的フィードバックを提供したり、<xref:System.Windows.Controls.DataGrid> コントロールで提供される既定の視覚的フィードバックを使用したりすることもできます。  
+  
+ 以下の手順では、検証規則を <xref:System.Windows.Controls.DataGrid> バインディングに適用し、視覚的フィードバックをカスタマイズする方法について説明します。  
+  
+### 個別のセル値を検証するには  
+  
+-   列で使用されるバインディングに対して 1 つ以上の検証規則を指定します。  これは、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」に説明されている単純なコントロールのデータの検証に似ています。  
+  
+     次の例では、ビジネス オブジェクトの別々のプロパティにバインドされた 4 つの列がある <xref:System.Windows.Controls.DataGrid> コントロールを示します。  そのうちの 3 つの列では、<xref:System.Windows.Data.Binding.ValidatesOnExceptions%2A> プロパティを `true` に設定して、<xref:System.Windows.Controls.ExceptionValidationRule> を指定しています。  
+  
+     [!code-xml[DataGrid_Validation#BasicXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/window1.xaml#basicxaml)]  
+  
+     ユーザーが無効な値 \(Course ID 列の整数以外など\) を入力すると、赤い枠線がセルの周囲に表示されます。  この既定の検証フィードバックは、次の手順に従って変更できます。  
+  
+### セルの検証フィードバックをカスタマイズするには  
+  
+-   列の <xref:System.Windows.Controls.DataGridBoundColumn.EditingElementStyle%2A> プロパティを、列の編集コントロールに適したスタイルに設定します。  編集コントロールは実行時に作成されるため、単純なコントロールのように <xref:System.Windows.Controls.Validation.ErrorTemplate%2A?displayProperty=fullName> 添付プロパティを使用することはできません。  
+  
+     次の例では、前の例を更新して、検証規則のある 3 つの列で共有されるエラー スタイルを追加します。  ユーザーが無効な値を入力すると、スタイルによってセルの背景色が変更され、ツールヒントが追加されます。  トリガーを使用して検証エラーがあるかどうかを確認していることに注意してください。  現在はセル用のエラー テンプレートがないため、この処理が必要です。  
+  
+     [!code-xml[DataGrid_Validation#CellValidationXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml#cellvalidationxaml)]  
+  
+     列で使用される <xref:System.Windows.Controls.DataGridColumn.CellStyle%2A> を置き換えると、より広範囲なカスタマイズを実装できます。  
+  
+### 単一行の複数の値を検証するには  
+  
+1.  バインドされたデータ オブジェクトの複数のプロパティをチェックする <xref:System.Windows.Controls.ValidationRule> サブクラスを実装します。  <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドの実装で、`value` パラメーターの値を <xref:System.Windows.Data.BindingGroup> インスタンスにキャストします。  その後、<xref:System.Windows.Data.BindingGroup.Items%2A> プロパティを使用してデータ オブジェクトにアクセスできます。  
+  
+     この処理によって `Course` オブジェクトの `StartDate` プロパティ値が `EndDate` プロパティ値より前かどうかを検証する例を次に示します。  
+  
+     [!code-csharp[DataGrid_Validation#CourseValidationRule](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml.cs#coursevalidationrule)]
+     [!code-vb[DataGrid_Validation#CourseValidationRule](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/datagrid_validation/vb/mainwindow.xaml.vb#coursevalidationrule)]  
+  
+2.  <xref:System.Windows.Controls.DataGrid.RowValidationRules%2A?displayProperty=fullName> コレクションに検証規則を追加します。  <xref:System.Windows.Controls.DataGrid.RowValidationRules%2A> プロパティは、コントロールで使用されるすべてのバインディングをグループ化する <xref:System.Windows.Data.BindingGroup> インスタンスの <xref:System.Windows.Data.BindingGroup.ValidationRules%2A> プロパティへの直接アクセスを可能にします。  
+  
+     XAML に <xref:System.Windows.Controls.DataGrid.RowValidationRules%2A> プロパティを設定する例を次に示します。  <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> プロパティが <xref:System.Windows.Controls.ValidationStep> に設定されているため、検証はバインドされたデータ オブジェクトの更新後にのみ行われます。  
+  
+     [!code-xml[DataGrid_Validation#RowValidationRulesXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml#rowvalidationrulesxaml)]  
+  
+     ユーザーが、開始日より前の終了日を指定すると、赤い感嘆符 \(\!\) が行ヘッダーに表示されます。  この既定の検証フィードバックは、次の手順に従って変更できます。  
+  
+### 行の検証フィードバックをカスタマイズするには  
+  
+-   <xref:System.Windows.Controls.DataGrid.RowValidationErrorTemplate%2A?displayProperty=fullName> プロパティを設定します。  このプロパティを使用して、個々の <xref:System.Windows.Controls.DataGrid> コントロールの行の検証フィードバックをカスタマイズできます。  暗黙の行スタイルを使用して <xref:System.Windows.Controls.DataGridRow.ValidationErrorTemplate%2A?displayProperty=fullName> プロパティを設定することにより、複数のコントロールに影響を与えることもできます。  
+  
+     より視覚的なインジケーターで既定の行の検証フィードバックを置き換える例を次に示します。  ユーザーが無効な値を入力すると、赤い円で囲まれた白い感嘆符が行ヘッダーに表示されます。  これは、行とセルのどちらの検証エラーでも発生します。  関連付けられているエラー メッセージがツールヒントに表示されます。  
+  
+     [!code-xml[DataGrid_Validation#RowValidationFeedbackXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml#rowvalidationfeedbackxaml)]  
+  
+## 使用例  
+ 次の例では、セルおよび行の検証の詳細なデモンストレーションを示します。  `Course` クラスは、トランザクションをサポートするために、<xref:System.ComponentModel.IEditableObject> を実装するサンプル データ オブジェクトを提供します。  <xref:System.Windows.Controls.DataGrid> コントロールは、<xref:System.ComponentModel.IEditableObject> とやり取りして、ユーザーが Esc キーを押すことで変更を元に戻せるようにします。  
+  
+> [!NOTE]
+>  Visual Basic を使用している場合は、MainWindow.xaml の最初の行で、`x:Class="DataGridValidation.MainWindow"` を `x:Class="MainWindow"` に置き換えてください。  
+  
+ 検証をテストするには、次の操作を試します。  
+  
+-   Course ID 列に、整数以外の値を入力します。  
+  
+-   End Date 列に、Start Date より前の日付を入力します。  
+  
+-   Course ID、Start Date、または End Date の値を削除します。  
+  
+-   無効なセル値を元に戻すには、カーソルをセルに戻し、Esc キーを押します。  
+  
+-   現在のセルが編集モードのときに行全体の変更を元に戻すには、Esc キーを 2 回押します。  
+  
+-   検証エラーが発生した場合は、行ヘッダーのインジケーターの上にマウス ポインターを移動すると、関連するエラー メッセージが表示されます。  
+  
+ [!code-csharp[DataGrid_Validation#FullCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml.cs#fullcode)]
+ [!code-vb[DataGrid_Validation#FullCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/datagrid_validation/vb/mainwindow.xaml.vb#fullcode)]  
+  
+ [!code-xml[DataGrid_Validation#FullXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/datagrid_validation/cs/mainwindow.xaml#fullxaml)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataGrid>   
+ [DataGrid](../../../../docs/framework/wpf/controls/datagrid.md)   
+ [データ バインディング](../../../../docs/framework/wpf/data/data-binding-wpf.md)   
+ [バインディングの検証の実装](../../../../docs/framework/wpf/data/how-to-implement-binding-validation.md)   
+ [カスタム オブジェクトに検証ロジックを実装する](../../../../docs/framework/wpf/data/how-to-implement-validation-logic-on-custom-objects.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md b/docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md
new file mode 100644
index 00000000000..140ecaec27c
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : TreeView のパフォーマンスを改善する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TreeView コントロール [WPF], 向上 (パフォーマンスを)"
+ms.assetid: b792c740-cf2b-4da8-8ba8-3d2e5a821874
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : TreeView のパフォーマンスを改善する
+<xref:System.Windows.Controls.TreeView> に多くの項目が含まれていると、読み込みに時間を要するためにユーザー インターフェイスに大きな遅れが生じる可能性があります。  <xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A?displayProperty=fullName> 添付プロパティを `true` に設定することによって、読み込み時間を改善できます。  また、マウス ホイールの操作、またはスクロール バーのつまみのドラッグによる <xref:System.Windows.Controls.TreeView> のスクロール時に、UI の反応が遅れる場合があります。  <xref:System.Windows.Controls.VirtualizingStackPanel.VirtualizationMode%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Controls.VirtualizationMode> に設定することで、ユーザーがスクロールを実行したときの <xref:System.Windows.Controls.TreeView> のパフォーマンスを向上させることができます。  
+  
+## 使用例  
+  
+## Description  
+ <xref:System.Windows.Controls.TreeView> を作成する例を次に示します。この例では、<xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A?displayProperty=fullName> を true に設定し、<xref:System.Windows.Controls.VirtualizingStackPanel.VirtualizationMode%2A?displayProperty=fullName> を <xref:System.Windows.Controls.VirtualizationMode> に設定することにより、パフォーマンスを最適化します。  
+  
+## コード  
+ [!code-xml[RecycleItemContainerShippets#VirtualizingTreeView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml#virtualizingtreeview)]  
+  
+ 次の例は、前の例で使用するデータを示しています。  
+  
+ [!code-csharp[RecycleItemContainerShippets#TreeViewData](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml.cs#treeviewdata)]
+ [!code-vb[RecycleItemContainerShippets#TreeViewData](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RecycleItemContainerShippets/visualbasic/window1.xaml.vb#treeviewdata)]  
+  
+## 参照  
+ [コントロール](../../../../docs/framework/wpf/advanced/optimizing-performance-controls.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-improve-the-scrolling-performance-of-a-listbox.md b/docs/framework/wpf/controls/how-to-improve-the-scrolling-performance-of-a-listbox.md
new file mode 100644
index 00000000000..f54a93fd312
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-improve-the-scrolling-performance-of-a-listbox.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : ListBox のスクロール速度を向上させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListBox コントロール [WPF], 向上 (スクロールのパフォーマンスを)"
+  - "ListBox コントロール [WPF], 再利用 (項目コンテナーを)"
+ms.assetid: 1e2bf8f3-c8ce-47f7-a400-a7fe11d1a848
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ListBox のスクロール速度を向上させる
+<xref:System.Windows.Controls.ListBox> に多くの項目が含まれていると、マウス ホイールの操作、またはスクロール バーのつまみのドラッグによる <xref:System.Windows.Controls.ListBox> のスクロール時に、ユーザー インターフェイスの反応が遅くなる可能性があります。  <xref:System.Windows.Controls.VirtualizingStackPanel.VirtualizationMode%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Controls.VirtualizationMode> に設定することで、ユーザーがスクロールを実行したときの <xref:System.Windows.Controls.ListBox> のパフォーマンスを向上させることができます。  
+  
+## 使用例  
+  
+## Description  
+ 次の例では、<xref:System.Windows.Controls.ListBox> を作成し、<xref:System.Windows.Controls.VirtualizingStackPanel.VirtualizationMode%2A?displayProperty=fullName> を <xref:System.Windows.Controls.VirtualizationMode> に設定することで、スクロール時のパフォーマンスを向上させます。  
+  
+## コード  
+ [!code-xml[RecycleItemContainerShippets#VirtualizationMode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml#virtualizationmode)]  
+  
+ 次の例は、前の例で使用するデータを示しています。  
+  
+ [!code-csharp[RecycleItemContainerShippets#ListBoxData](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RecycleItemContainerShippets/CSharp/Window1.xaml.cs#listboxdata)]
+ [!code-vb[RecycleItemContainerShippets#ListBoxData](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RecycleItemContainerShippets/visualbasic/window1.xaml.vb#listboxdata)]
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-make-a-textbox-control-read-only.md b/docs/framework/wpf/controls/how-to-make-a-textbox-control-read-only.md
new file mode 100644
index 00000000000..be4de8857db
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-make-a-textbox-control-read-only.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : TextBox コントロールを読み取り専用にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "読み取り専用の TextBox コントロール"
+  - "TextBox コントロール (読み取り専用)"
+ms.assetid: e707ec59-8b22-473e-b77c-3060a237517a
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : TextBox コントロールを読み取り専用にする
+この例では、<xref:System.Windows.Controls.TextBox> コントロールをユーザーが入力または変更できないように構成する方法を示します。  
+  
+## 使用例  
+ ユーザーが <xref:System.Windows.Controls.TextBox> コントロールの内容を変更できないようにするには、<xref:System.Windows.Controls.Primitives.TextBoxBase.IsReadOnly%2A> 属性を **true** に設定します。  
+  
+ [!code-xml[TextBox_MiscCode#_ReadOnlyTextBoxXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_readonlytextboxxaml)]  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.IsReadOnly%2A> 属性が適用されるのはユーザー入力だけです。[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] での <xref:System.Windows.Controls.TextBox> コントロールの記述で設定されているテキスト、または <xref:System.Windows.Controls.TextBox.Text%2A> プロパティでプログラムを使用して設定されるテキストは影響を受けません。  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.IsReadOnly%2A> の既定値は **false** です。  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md b/docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md
new file mode 100644
index 00000000000..0d4055e5d19
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : GridSplitter を表示されるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GridSplitter コントロール, 確保 (可視性を)"
+ms.assetid: 0a62a964-89c8-48f0-9023-5df721a8cf47
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : GridSplitter を表示されるようにする
+この例では、<xref:System.Windows.Controls.GridSplitter> コントロールが <xref:System.Windows.Controls.Grid> 内で他のコントロールによって隠されないようにする方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Grid> コントロールの <xref:System.Windows.Controls.Panel.Children%2A> は、マークアップやコードに定義されている順序で描画されます。  <xref:System.Windows.Controls.GridSplitter> コントロールは、<xref:System.Windows.Controls.Panel.Children%2A> コレクションで最後の要素として定義されていない場合、または <xref:System.Windows.Controls.Panel.ZIndexProperty> の値が他のコントロールより低い場合に、他のコントロールによって隠される可能性があります。  
+  
+ <xref:System.Windows.Controls.GridSplitter> コントロールが隠されないようにするには、次のいずれかの操作を行います。  
+  
+-   <xref:System.Windows.Controls.GridSplitter> コントロールを、<xref:System.Windows.Controls.Grid> に最後の <xref:System.Windows.Controls.Panel.Children%2A> として追加します。  次の例では、<xref:System.Windows.Controls.GridSplitter> が <xref:System.Windows.Controls.Grid> の <xref:System.Windows.Controls.Panel.Children%2A> コレクションの最後の要素として示されています。  
+  
+ [!code-xml[GridSplitterSnips#GridSplitterLastChild](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterSnips/CSharp/Window1.xaml#gridsplitterlastchild)]  
+  
+-   <xref:System.Windows.Controls.GridSplitter> の <xref:System.Windows.Controls.Panel.ZIndexProperty> に、このコントロールを隠す可能性のある他のコントロールより高い値を設定します。  次の例では、<xref:System.Windows.Controls.GridSplitter> コントロールの <xref:System.Windows.Controls.Panel.ZIndexProperty> に <xref:System.Windows.Controls.Button> コントロールより高い値を設定しています。  
+  
+ [!code-xml[GridSplitterSnips#GridSplitterZIndex](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterSnips/CSharp/Window1.xaml#gridsplitterzindex)]  
+  
+-   <xref:System.Windows.Controls.GridSplitter> を隠す可能性のあるコントロールにマージンを設定し、<xref:System.Windows.Controls.GridSplitter> が確実に表示されるようにします。  次の例では、<xref:System.Windows.Controls.GridSplitter> に重なって隠す可能性のあるコントロールにマージンを設定しています。  
+  
+ [!code-xml[GridSplitterSnips#GridSplitterMargin](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterSnips/CSharp/Window1.xaml#gridsplittermargin)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridSplitter>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/gridsplitter-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-override-the-panel-onrender-method.md b/docs/framework/wpf/controls/how-to-override-the-panel-onrender-method.md
new file mode 100644
index 00000000000..0ba7e2f242b
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-override-the-panel-onrender-method.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : パネルの OnRender メソッドをオーバーライドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "overriding OnRender method"
+  - "Panel control, overriding OnRender method"
+  - "OnRender method"
+  - "controls, Panel, overriding OnRender method"
+helpviewer_keywords: 
+  - "OnRender メソッド, オーバーライド"
+  - "オーバーライド (Panel コントロールの OnRender メソッドを)"
+  - "Panel コントロール, オーバーライド (OnRender メソッドを)"
+ms.assetid: 57397834-a085-4e36-90ab-416fad98f341
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : パネルの OnRender メソッドをオーバーライドする
+この例では、<xref:System.Windows.Controls.Panel> の <xref:System.Windows.Controls.Panel.OnRender%2A> メソッドをオーバーライドして、レイアウト要素にカスタムのグラフィカル効果を追加する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Panel.OnRender%2A> メソッドを使用して、描画されたパネル要素にグラフィカル効果を追加します。  たとえば、このメソッドを使用してカスタムの境界線または背景の効果を追加できます。  <xref:System.Windows.Media.DrawingContext> オブジェクトが引数として渡され、図形、テキスト、イメージ、またはビデオを描画するためのメソッドを提供します。  このため、このメソッドはパネル オブジェクトをカスタマイズするのに役立ちます。  
+  
+ [!code-csharp[LightWeightCustomPanel#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LightWeightCustomPanel/CSharp/OffsetPanel.cs#1)]
+ [!code-vb[LightWeightCustomPanel#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/LightWeightCustomPanel/visualbasic/offsetpanel.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Panel>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [カスタム放射状パネルのサンプル](http://go.microsoft.com/fwlink/?LinkID=159982)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/panel-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-partition-space-by-using-the-dockpanel-element.md b/docs/framework/wpf/controls/how-to-partition-space-by-using-the-dockpanel-element.md
new file mode 100644
index 00000000000..fb8d164e274
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-partition-space-by-using-the-dockpanel-element.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : DockPanel 要素を使用して領域を分割する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], DockPanel"
+  - "DockPanel コントロール, 分割 (領域を)"
+  - "分割 (領域を)"
+ms.assetid: a219b9e5-b205-4438-89b5-0a137ac463ab
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : DockPanel 要素を使用して領域を分割する
+<xref:System.Windows.Controls.DockPanel> 要素を使用して、単純な[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] フレームワークを作成する例を次に示します。  <xref:System.Windows.Controls.DockPanel> パーティションは使用可能な領域をその子要素に分割します。  
+  
+## 使用例  
+ この例では、<xref:System.Windows.Controls.DockPanel.Dock%2A> プロパティを使用します。このプロパティは、分割された領域の <xref:System.Windows.Controls.Dock> にある 2 つの同じ <xref:System.Windows.Controls.Border> 要素をドッキングするための[添付プロパティ](GTMT)です。  3 つ目の <xref:System.Windows.Controls.Border> 要素は、幅が 200 ピクセルに設定されて <xref:System.Windows.Controls.Dock> にドッキングされます。  4 つ目の <xref:System.Windows.Controls.Border> は、画面の <xref:System.Windows.Controls.Dock> にドッキングされます。  最後の <xref:System.Windows.Controls.Border> 要素は、残りの領域を自動的に満たします。  
+  
+ [!code-cpp[DockPanelOvwSample#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DockPanelOvwSample/CPP/DockPanel_Ovw_Sample.cpp#1)]
+ [!code-csharp[DockPanelOvwSample#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DockPanelOvwSample/CSharp/DockPanel_Ovw_Sample.cs#1)]
+ [!code-vb[DockPanelOvwSample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DockPanelOvwSample/VisualBasic/dockpanel_vb.vb#1)]
+ [!code-xml[DockPanelOvwSample#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DockPanelOvwSample/XAML/default.xaml#1)]  
+  
+> [!NOTE]
+>  既定では、<xref:System.Windows.Controls.DockPanel> 要素の最後の子は、割り当てられていない残りの領域を満たします。  この動作が不要な場合は、`LastChildFill="False"` を設定します。  
+  
+ コンパイルされたアプリケーションは、下に示すような新しい UI を生成します。  
+  
+ ![一般的な DockPanel シナリオ。](../../../../docs/framework/wpf/controls/media/panel-intro-dockpanel.png "panel\_intro\_dockpanel")  
+  
+## 参照  
+ <xref:System.Windows.Controls.DockPanel>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-position-a-custom-context-menu-in-a-richtextbox.md b/docs/framework/wpf/controls/how-to-position-a-custom-context-menu-in-a-richtextbox.md
new file mode 100644
index 00000000000..3cdf50af2af
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-position-a-custom-context-menu-in-a-richtextbox.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : カスタム コンテキスト メニューを RichTextBox に配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置のカスタム コンテキスト メニュー"
+  - "配置 (カスタム コンテキスト メニューを)"
+  - "RichTextBox コントロール、カスタム コンテキスト メニューの配置"
+  - "配置のコンテキスト メニュー"
+ms.assetid: bf77c930-a546-4573-9a56-9af345ba189a
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : カスタム コンテキスト メニューを RichTextBox に配置する
+この例では、カスタム コンテキスト メニューの配置、 <xref:System.Windows.Controls.RichTextBox>します。  
+  
+ カスタム コンテキスト メニューを実装する場合、 **RichTextBox**、コンテキスト メニューの配置を処理を担当します。  中央に既定では、カスタム コンテキスト メニューを開く、 **RichTextBox**します。  
+  
+## <a name="example"></a>例  
+ 既定の配置の動作を上書きするには、追加のリスナー、 <xref:System.Windows.FrameworkContentElement.ContextMenuOpening>イベントです。  次の例では、このプログラムで実行する方法を示します。  
+  
+ [!code-csharp[RichTextBox_ContextMenu#_AddListener](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBox_ContextMenu/CSharp/app.xaml.cs#_addlistener)]
+ [!code-vb[RichTextBox_ContextMenu#_AddListener](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBox_ContextMenu/VisualBasic/app.xaml.vb#_addlistener)]  
+  
+## <a name="example"></a>例  
+ 次の例は、対応する実装を示します<xref:System.Windows.FrameworkContentElement.ContextMenuOpening>イベント リスナー。  
+  
+ [!code-csharp[RichTextBox_ContextMenu#_ListenerBody](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBox_ContextMenu/CSharp/app.xaml.cs#_listenerbody)]
+ [!code-vb[RichTextBox_ContextMenu#_ListenerBody](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBox_ContextMenu/VisualBasic/app.xaml.vb#_listenerbody)]  
+  
+## <a name="see-also"></a>関連項目  
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-position-a-tooltip.md b/docs/framework/wpf/controls/how-to-position-a-tooltip.md
new file mode 100644
index 00000000000..05fb0e6fa16
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-position-a-tooltip.md
@@ -0,0 +1,70 @@
+---
+title: "方法 : ToolTip を配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (ToolTip コントロールを)"
+  - "ToolTip コントロール, 配置"
+ms.assetid: cddf3757-9e5f-4ce3-a6eb-44489cf3804a
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ToolTip を配置する
+画面上でのツールヒントの位置を指定する方法を次の例に示します。  
+  
+## 使用例  
+ ツールヒントを配置するには、<xref:System.Windows.Controls.ToolTip> クラスと <xref:System.Windows.Controls.ToolTipService> クラスの両方で定義されている 5 つのプロパティのセットを使用します。  これら 5 つのプロパティの 2 つのセットと、そのクラス別の参考資料へのリンクを次の表に示します。  
+  
+### クラス別の対応するツールヒント プロパティ  
+  
+|<xref:System.Windows.Controls.ToolTip?displayProperty=fullName> クラスのプロパティ|<xref:System.Windows.Controls.ToolTipService?displayProperty=fullName> クラスのプロパティ|  
+|-------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Windows.Controls.ToolTip.Placement%2A?displayProperty=fullName>|<xref:System.Windows.Controls.ToolTipService.Placement%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Controls.ToolTip.PlacementTarget%2A?displayProperty=fullName>|<xref:System.Windows.Controls.ToolTipService.PlacementTarget%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Controls.ToolTip.PlacementRectangle%2A?displayProperty=fullName>|<xref:System.Windows.Controls.ToolTipService.PlacementRectangle%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Controls.ToolTip.HorizontalOffset%2A?displayProperty=fullName>|<xref:System.Windows.Controls.ToolTipService.HorizontalOffset%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Controls.ToolTip.VerticalOffset%2A?displayProperty=fullName>|<xref:System.Windows.Controls.ToolTipService.VerticalOffset%2A?displayProperty=fullName>|  
+  
+ ツールヒントのコンテンツを <xref:System.Windows.Controls.ToolTip> オブジェクトを使用して定義する場合は、どちらのクラスのプロパティも使用できます。ただし、<xref:System.Windows.Controls.ToolTipService> のプロパティが優先されます。  <xref:System.Windows.Controls.ToolTip> オブジェクトとして定義されていないツールヒントには、<xref:System.Windows.Controls.ToolTipService> のプロパティを使用してください。  
+  
+ これらのプロパティを使用してツールヒントを配置する方法を以下の図に示します。  これらの図の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、<xref:System.Windows.Controls.ToolTip> クラスで定義されるプロパティの設定方法を示していますが、<xref:System.Windows.Controls.ToolTipService> クラスの対応する各プロパティも、同じレイアウト ルールに従います。  Placement プロパティに使用できる値の詳細については、「[ポップアップの配置動作](../../../../docs/framework/wpf/controls/popup-placement-behavior.md)」を参照してください。  
+  
+ ![ツールヒント配置](../../../../docs/framework/wpf/controls/media/tooltipplacement.png "ToolTipPlacement")  
+Placement プロパティを使用して ToolTip を配置する  
+  
+ ![配置四角形を使用したツールヒントの配置](../../../../docs/framework/wpf/controls/media/tooltipplacementrectangle.png "ToolTipPlacementRectangle")  
+Placement および PlacementRectangle プロパティを使用して ToolTip を配置する  
+  
+ ![ツールヒント配置のダイアグラム](../../../../docs/framework/wpf/controls/media/tooltipplacementprhv.png "ToolTipPlacementPRHV")  
+Placement、PlacementRectangle、および Offset プロパティを使用して ToolTip を配置する  
+  
+ <xref:System.Windows.Controls.ToolTip> のプロパティを使用して <xref:System.Windows.Controls.ToolTip> オブジェクトをコンテンツとするツールヒントの位置を指定する方法を次の例に示します。  
+  
+ [!code-xml[ToolTipService#ToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#tooltip)]  
+  
+ [!code-csharp[ToolTipService#ToolTipCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml.cs#tooltipcode)]
+ [!code-vb[ToolTipService#ToolTipCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ToolTipService/visualbasic/pane1.xaml.vb#tooltipcode)]  
+  
+ <xref:System.Windows.Controls.ToolTipService> のプロパティを使用して、コンテンツが <xref:System.Windows.Controls.ToolTip> オブジェクトでないツールヒントの位置を指定する方法を次の例に示します。  
+  
+ [!code-xml[ToolTipService#NoToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)]  
+  
+ [!code-csharp[ToolTipService#NoToolTipCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml.cs#notooltipcode)]
+ [!code-vb[ToolTipService#NoToolTipCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ToolTipService/visualbasic/pane1.xaml.vb#notooltipcode)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ToolTip>   
+ <xref:System.Windows.Controls.ToolTipService>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/tooltip-how-to-topics.md)   
+ [ToolTip の概要](../../../../docs/framework/wpf/controls/tooltip-overview.md)   
+ [Use the ContextMenuService and ToolTipService](http://msdn.microsoft.com/ja-jp/809b0e9c-d612-4cda-b8af-1a698c68f4d1)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-position-the-child-elements-of-a-grid.md b/docs/framework/wpf/controls/how-to-position-the-child-elements-of-a-grid.md
new file mode 100644
index 00000000000..10b5a3d9ef5
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-position-the-child-elements-of-a-grid.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : グリッドの子要素を配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド コントロール, 配置 (子要素を)"
+ms.assetid: 27b3ba9b-ad32-44e2-bcab-a79d573a463c
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : グリッドの子要素を配置する
+この例では、<xref:System.Windows.Controls.Grid> 上で定義された get メソッドおよび set メソッドを使用して子要素を配置する方法を示します。  
+  
+## 使用例  
+ それぞれ 3 つの列と行を持つ親 <xref:System.Windows.Controls.Grid> 要素 \(`grid1`\) を定義する例を次に示します。  子 <xref:System.Windows.Shapes.Rectangle> 要素 \(`rect1`\) は、<xref:System.Windows.Controls.Grid> の列 0、行 0 の位置に追加されます。  <xref:System.Windows.Controls.Button> は、<xref:System.Windows.Controls.Grid> 内で <xref:System.Windows.Shapes.Rectangle> 要素の位置を変更するために呼び出すことができるメソッドを表します。  ボタンをクリックすると、関連メソッドがアクティブになります。  
+  
+ [!code-xml[gridGetSetMethods#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridGetSetMethods/CSharp/Window1.xaml#1)]  
+  
+ 次の分離コードの例では、ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントによって実行されるメソッドを処理します。  この例では、これらのメソッド呼び出しを <xref:System.Windows.Controls.TextBlock> 要素に書き出し、関連する get メソッドを使用して、新しいプロパティ値を文字列として出力します。  
+  
+ [!code-csharp[gridGetSetMethods#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridGetSetMethods/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[gridGetSetMethods#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/gridGetSetMethods/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-remove-all-adorners-from-an-element.md b/docs/framework/wpf/controls/how-to-remove-all-adorners-from-an-element.md
new file mode 100644
index 00000000000..73dffa35caa
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-remove-all-adorners-from-an-element.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 要素からすべての装飾を削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾, 削除"
+ms.assetid: fe5303a3-b76e-4643-aafb-51419032b47b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 要素からすべての装飾を削除する
+この例では、指定された <xref:System.Windows.UIElement> からプログラムを使用してすべての装飾を削除する方法を示します。  
+  
+## 使用例  
+ この詳細なコード例では、<xref:System.Windows.Documents.AdornerLayer.GetAdorners%2A> によって返される装飾の配列にあるすべての装飾が削除されます。  この例では、*myTextBox* という名前の <xref:System.Windows.UIElement> の装飾が取得されます。  <xref:System.Windows.Documents.AdornerLayer.GetAdorners%2A> の呼び出しで指定された要素に装飾がない場合、`null` が返されます。  このコードは NULL 配列を明示的にチェックします。NULL 配列が比較的多いと予想される場合には、このコードがアプリケーションに最も適しています。  
+  
+ [!code-csharp[AdornersMiscCode#_RemoveAllAdornersLong](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornersMiscCode/CSharp/Window1.xaml.cs#_removealladornerslong)]
+ [!code-vb[AdornersMiscCode#_RemoveAllAdornersLong](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornersMiscCode/visualbasic/window1.xaml.vb#_removealladornerslong)]  
+  
+## 使用例  
+ この縮小されたコード例は、上に示した詳細例と同等の機能を持っています。  このコードは NULL 配列を明示的にチェックしないため、<xref:System.NullReferenceException> 例外が発生する可能性があります。  このコードは、NULL 配列がまれにしかないと予想されるアプリケーションに最も適しています。  
+  
+ [!code-csharp[AdornersMiscCode#_RemoveAllAdornersShort](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornersMiscCode/CSharp/Window1.xaml.cs#_removealladornersshort)]
+ [!code-vb[AdornersMiscCode#_RemoveAllAdornersShort](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornersMiscCode/visualbasic/window1.xaml.vb#_removealladornersshort)]  
+  
+## 参照  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-remove-an-adorner-from-an-element.md b/docs/framework/wpf/controls/how-to-remove-an-adorner-from-an-element.md
new file mode 100644
index 00000000000..58c12304de6
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-remove-an-adorner-from-an-element.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 要素から装飾を削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "装飾, 削除"
+ms.assetid: 97cf4d9f-0596-429e-8526-32a30aa4ae99
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 要素から装飾を削除する
+この例では、指定された <xref:System.Windows.UIElement> からプログラムを使用して特定の装飾を削除する方法を示します。  
+  
+## 使用例  
+ この詳細なコード例では、<xref:System.Windows.Documents.AdornerLayer.GetAdorners%2A> によって返される装飾の配列にある最初の装飾が削除されます。  この例では、*myTextBox* という名前の <xref:System.Windows.UIElement> の装飾が取得されます。  <xref:System.Windows.Documents.AdornerLayer.GetAdorners%2A> の呼び出しで指定された要素に装飾がない場合、`null` が返されます。  このコードは NULL 配列を明示的にチェックします。NULL 配列が比較的多いと予想される場合には、このコードがアプリケーションに最も適しています。  
+  
+ [!code-csharp[AdornersMiscCode#_RemoveSpecificAdornerLong](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornersMiscCode/CSharp/Window1.xaml.cs#_removespecificadornerlong)]
+ [!code-vb[AdornersMiscCode#_RemoveSpecificAdornerLong](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornersMiscCode/visualbasic/window1.xaml.vb#_removespecificadornerlong)]  
+  
+## 使用例  
+ この縮小されたコード例は、上に示した詳細例と同等の機能を持っています。  このコードは NULL 配列を明示的にチェックしないため、<xref:System.NullReferenceException> 例外が発生する可能性があります。  このコードは、NULL 配列がまれにしかないと予想されるアプリケーションに最も適しています。  
+  
+ [!code-csharp[AdornersMiscCode#_RemoveSpecificAdornerShort](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AdornersMiscCode/CSharp/Window1.xaml.cs#_removespecificadornershort)]
+ [!code-vb[AdornersMiscCode#_RemoveSpecificAdornerShort](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AdornersMiscCode/visualbasic/window1.xaml.vb#_removespecificadornershort)]  
+  
+## 参照  
+ [装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-resize-a-canvas-by-using-a-thumb.md b/docs/framework/wpf/controls/how-to-resize-a-canvas-by-using-a-thumb.md
new file mode 100644
index 00000000000..b9cab5c924b
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-resize-a-canvas-by-using-a-thumb.md
@@ -0,0 +1,57 @@
+---
+title: "方法: つまみを使用してキャンバスのサイズを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Canvas コントロール"
+  - "コントロール, Canvas"
+  - "コントロール, つまみ"
+  - "サイズ変更 (キャンバス コントロールの)"
+  - "つまみコントロール"
+ms.assetid: 7dc9f435-726c-4d4d-be41-eb24cfe17bef
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法: つまみを使用してキャンバスのサイズを変更する
+この例では、<xref:System.Windows.Controls.Primitives.Thumb> コントロールを使用して <xref:System.Windows.Controls.Canvas> コントロールのサイズを変更する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Primitives.Thumb> は、ドラッグ機能を実現するためのコントロールです。このコントロールを使用してコントロールを移動したりサイズを変更したりするには、<xref:System.Windows.Controls.Primitives.Thumb> の <xref:System.Windows.Controls.Primitives.Thumb.DragStarted> イベント、<xref:System.Windows.Controls.Primitives.Thumb.DragDelta> イベント、および <xref:System.Windows.Controls.Primitives.Thumb.DragCompleted> イベントを監視します。  
+  
+ ユーザーがドラッグ操作を開始するときは、<xref:System.Windows.Controls.Primitives.Thumb> コントロール上にマウス ポインターを置いてマウスの左ボタンを押します。  ドラッグ操作は、マウスの左ボタンが押されている間続きます。  ドラッグ操作中に、<xref:System.Windows.Controls.Primitives.Thumb.DragDelta> が 2 回以上発生する可能性があります。  このイベントが発生するたびに、マウス位置の変化に対応するコントロール位置の変化の情報が <xref:System.Windows.Controls.Primitives.DragDeltaEventArgs> クラスに格納されます。  ユーザーがマウスの左ボタンを離すと、ドラッグ操作は終了します。  ドラッグ操作は新しい座標を示すだけで、<xref:System.Windows.Controls.Primitives.Thumb> の位置を自動的に変更することはありません。  
+  
+ <xref:System.Windows.Controls.Canvas> コントロールの子要素である <xref:System.Windows.Controls.Primitives.Thumb> コントロールの例を次に示します。  このコントロールの <xref:System.Windows.Controls.Primitives.Thumb.DragDelta> イベントのイベント ハンドラーの中で、<xref:System.Windows.Controls.Primitives.Thumb> の移動や <xref:System.Windows.Controls.Canvas> のサイズ変更を行います。  <xref:System.Windows.Controls.Primitives.Thumb.DragStarted> および <xref:System.Windows.Controls.Primitives.Thumb.DragCompleted> イベントのイベント ハンドラーによって、ドラッグ操作中の <xref:System.Windows.Controls.Primitives.Thumb> の色を変更します。  次の例では、<xref:System.Windows.Controls.Primitives.Thumb> を定義しています。  
+  
+ [!code-xml[Thumb#thumb](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Thumb/CSharp/Pane1.xaml#thumb)]  
+  
+ マウスの動きに応じて <xref:System.Windows.Controls.Primitives.Thumb> の移動や <xref:System.Windows.Controls.Canvas> のサイズ変更を行う <xref:System.Windows.Controls.Primitives.Thumb.DragDelta> イベント ハンドラーの例を次に示します。  
+  
+ [!code-csharp[Thumb#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Thumb/CSharp/Pane1.xaml.cs#2)]  
+  
+ <xref:System.Windows.Controls.Primitives.Thumb.DragStarted> イベント ハンドラーの例を次に示します。  
+  
+ [!code-csharp[Thumb#DragStartedHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Thumb/CSharp/Pane1.xaml.cs#dragstartedhandler)]
+ [!code-vb[Thumb#DragStartedHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Thumb/VisualBasic/Pane1.xaml.vb#dragstartedhandler)]  
+  
+ <xref:System.Windows.Controls.Primitives.Thumb.DragCompleted> イベント ハンドラーの例を次に示します。  
+  
+ [!code-csharp[Thumb#DragCompletedHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Thumb/CSharp/Pane1.xaml.cs#dragcompletedhandler)]
+ [!code-vb[Thumb#DragCompletedHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Thumb/VisualBasic/Pane1.xaml.vb#dragcompletedhandler)]  
+  
+ サンプル全体については、[サム ドラッグ機能のサンプル](http://go.microsoft.com/fwlink/?LinkID=160042)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Primitives.Thumb>   
+ <xref:System.Windows.Controls.Primitives.Thumb.DragStarted>   
+ <xref:System.Windows.Controls.Primitives.Thumb.DragDelta>   
+ <xref:System.Windows.Controls.Primitives.Thumb.DragCompleted>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-resize-columns-with-a-gridsplitter.md b/docs/framework/wpf/controls/how-to-resize-columns-with-a-gridsplitter.md
new file mode 100644
index 00000000000..a3de139c09d
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-resize-columns-with-a-gridsplitter.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : GridSplitter を使用して列のサイズを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド列, サイズ変更"
+  - "GridSplitter コントロール, サイズ変更 (グリッド列の)"
+  - "サイズ変更 (グリッド列の)"
+ms.assetid: 47b20fe6-7adc-4aa6-9693-b4e184eef74b
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : GridSplitter を使用して列のサイズを変更する
+この例では、<xref:System.Windows.Controls.Grid> の寸法を変更せずに <xref:System.Windows.Controls.Grid> 内の列の間で領域を再配分するために垂直 <xref:System.Windows.Controls.GridSplitter> を作成する方法を示します。  
+  
+## 使用例  
+ **列の端に重なって表示される GridSplitter を作成する方法**  
+  
+ <xref:System.Windows.Controls.Grid> 内の隣接する列のサイズを変更する <xref:System.Windows.Controls.GridSplitter> を指定するには、サイズを変更する列の 1 つに <xref:System.Windows.Controls.Grid.Column%2A> [添付プロパティ](GTMT)を設定します。  <xref:System.Windows.Controls.Grid> に複数の行がある場合は、<xref:System.Windows.Controls.Grid.RowSpan%2A> 添付プロパティに行の数を設定します。  次に、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティを <xref:System.Windows.HorizontalAlignment> または <xref:System.Windows.HorizontalAlignment> に設定します \(どちらの配置に設定するかはサイズを変更する 2 列によって異なります\)。  最後に、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティを <xref:System.Windows.VerticalAlignment> に設定します。  
+  
+ [!code-xml[GridSplitterRowColumn#GridSplitterColumnOverlay](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplittercolumnoverlay)]  
+  
+ 独自の列を持たない <xref:System.Windows.Controls.GridSplitter> は、<xref:System.Windows.Controls.Grid> 内の他のコントロールによって隠される場合があります。  この問題を回避する方法の詳細については、「[GridSplitter を表示されるようにする](../../../../docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md)」を参照してください。  
+  
+ **列を占有する GridSplitter を作成する方法**  
+  
+ <xref:System.Windows.Controls.Grid> 内の列を占有する <xref:System.Windows.Controls.GridSplitter> を指定するには、サイズを変更する列の 1 つに <xref:System.Windows.Controls.Grid.Column%2A> [添付プロパティ](GTMT)を設定します。  Grid に複数の行がある場合は、<xref:System.Windows.Controls.Grid.RowSpan%2A> 添付プロパティに行の数を設定します。  次に、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> を <xref:System.Windows.HorizontalAlignment> に設定し、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> プロパティを <xref:System.Windows.VerticalAlignment> に設定して、<xref:System.Windows.Controls.GridSplitter> を含む列の <xref:System.Windows.Controls.ColumnDefinition.Width%2A> を <xref:System.Windows.GridLength.Auto%2A> に設定します。  
+  
+ 列を占有し、その列の両側の列のサイズを変更する垂直 <xref:System.Windows.Controls.GridSplitter> を定義する方法を次の例に示します。  
+  
+ [!code-xml[GridSplitterRowColumn#GridSplitterEntireColumnPart1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplitterentirecolumnpart1)]  
+[!code-xml[GridSplitterRowColumn#GridSplitterEntireColumnPart2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplitterentirecolumnpart2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridSplitter>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/gridsplitter-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-resize-rows-with-a-gridsplitter.md b/docs/framework/wpf/controls/how-to-resize-rows-with-a-gridsplitter.md
new file mode 100644
index 00000000000..c6e6a5c0ff7
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-resize-rows-with-a-gridsplitter.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : GridSplitter を使用して行のサイズを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド行, サイズ変更"
+  - "GridSplitter コントロール, サイズ変更 (グリッド行の)"
+  - "サイズ変更 (グリッド行の)"
+ms.assetid: 2413a9f2-1d81-46ed-95cb-95ec8233eea2
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : GridSplitter を使用して行のサイズを変更する
+この例では、水平 <xref:System.Windows.Controls.GridSplitter> を使用して、<xref:System.Windows.Controls.Grid> の寸法を変更せずに <xref:System.Windows.Controls.Grid> 内の行間の領域を再配分する方法を示します。  
+  
+## 使用例  
+ **行の端に重なって表示される GridSplitter を作成する方法**  
+  
+ <xref:System.Windows.Controls.Grid> 内の隣接する行のサイズを変更する <xref:System.Windows.Controls.GridSplitter> を指定するには、サイズを変更する行の 1 つに <xref:System.Windows.Controls.Grid.Row%2A> [添付プロパティ](GTMT)を設定します。  <xref:System.Windows.Controls.Grid> に複数の列がある場合は、<xref:System.Windows.Controls.Grid.ColumnSpan%2A> 添付プロパティを設定して列の数を指定します。  次に、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> を <xref:System.Windows.VerticalAlignment> または <xref:System.Windows.VerticalAlignment> に設定します \(どちらの配置に設定するかは、サイズを変更する 2 行がどちらであるかによって異なります\)。  最後に、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> のプロパティを <xref:System.Windows.HorizontalAlignment> に設定します。  
+  
+ 隣接する行のサイズを変更する、水平 <xref:System.Windows.Controls.GridSplitter> を定義する方法を次の例に示します。  
+  
+ [!code-xml[GridSplitterRowColumn#GridSplitterRowOverlay](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplitterrowoverlay)]  
+  
+ 固有の行を占有しない <xref:System.Windows.Controls.GridSplitter> は、<xref:System.Windows.Controls.Grid> 内の他のコントロールによって隠される場合があります。  この問題を回避する方法の詳細については、「[GridSplitter を表示されるようにする](../../../../docs/framework/wpf/controls/how-to-make-sure-that-a-gridsplitter-is-visible.md)」を参照してください。  
+  
+ **行を占有する GridSplitter を作成する方法**  
+  
+ <xref:System.Windows.Controls.Grid> 内の行を占有する <xref:System.Windows.Controls.GridSplitter> を指定するには、サイズを変更する行の 1 つに <xref:System.Windows.Controls.Grid.Row%2A> [添付プロパティ](GTMT)を設定します。  <xref:System.Windows.Controls.Grid> に複数の列がある場合は、<xref:System.Windows.Controls.Grid.ColumnSpan%2A> 添付プロパティに列の数を設定します。  次に、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A> を <xref:System.Windows.VerticalAlignment> に設定し、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティを <xref:System.Windows.HorizontalAlignment> に設定して、<xref:System.Windows.Controls.GridSplitter> を含む行の <xref:System.Windows.Controls.RowDefinition.Height%2A> を <xref:System.Windows.GridLength.Auto%2A> に設定します。  
+  
+ 行を占有し、その行の両側の行のサイズを変更する水平 <xref:System.Windows.Controls.GridSplitter> を定義する方法を次の例に示します。  
+  
+ [!code-xml[GridSplitterRowColumn#GridSplitterEntireRowPart1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplitterentirerowpart1)]  
+[!code-xml[GridSplitterRowColumn#GridSplitterEntireRowPart2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridSplitterRowColumn/CS/Window1.xaml#gridsplitterentirerowpart2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridSplitter>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/gridsplitter-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-retrieve-a-text-selection.md b/docs/framework/wpf/controls/how-to-retrieve-a-text-selection.md
new file mode 100644
index 00000000000..344cfd1d0a6
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-retrieve-a-text-selection.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : テキスト選択を取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "取得 (テキストを)"
+  - "テキスト, 取得"
+  - "TextBox コントロール, 取得 (テキストを)"
+ms.assetid: d5793172-1e11-4a39-9be0-73f336ed858d
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : テキスト選択を取得する
+この例では、<xref:System.Windows.Controls.TextBox.SelectedText%2A> プロパティを使用して、ユーザーが <xref:System.Windows.Controls.TextBox> コントロールで選択したテキストを取得する方法を 1 つ示します。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、選択対象のテキストを格納した <xref:System.Windows.Controls.TextBox> コントロールと、<xref:System.Windows.Controls.Button.OnClick%2A> メソッドを指定した <xref:System.Windows.Controls.Button> コントロールの定義を示します。  
+  
+ この例では、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーが関連付けられたボタンを使用して、テキスト選択を取得しています。  ユーザーがボタンをクリックすると、<xref:System.Windows.Controls.Button.OnClick%2A> メソッドにより、テキストボックス内で選択されたすべてのテキストが文字列にコピーされます。  テキスト選択の取得 \(ボタンのクリック\)、およびその選択に関連し実行されるアクション \(文字列へのテキスト選択のコピー\) に対応する特定環境を簡単に変更して、さまざまなシナリオに対応できます。  
+  
+ [!code-xml[TextBox_MiscCode#_TextBoxSelectTextXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_textboxselecttextxaml)]  
+  
+## 使用例  
+ 次に示す [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] の例では、この例の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で定義したボタンで使用する <xref:System.Windows.Controls.Button.OnClick%2A> イベント ハンドラーを示します。  
+  
+ [!code-csharp[TextBox_MiscCode#_SelectText](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_selecttext)]
+ [!code-vb[TextBox_MiscCode#_SelectText](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_selecttext)]  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-rotate-an-image.md b/docs/framework/wpf/controls/how-to-rotate-an-image.md
new file mode 100644
index 00000000000..ed32c9ac3e3
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-rotate-an-image.md
@@ -0,0 +1,29 @@
+---
+title: "方法 : イメージを回転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イメージ, 回転"
+  - "回転 (イメージを)"
+ms.assetid: 863fe998-9a6b-490d-bd86-6ef5c9ec6d75
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : イメージを回転させる
+この例では、<xref:System.Windows.Media.Imaging.BitmapImage> の <xref:System.Windows.Media.Imaging.BitmapImage.Rotation%2A> プロパティを使用してイメージを 90°回転させる方法を示します。  
+  
+## 使用例  
+ [!code-xml[ImageElementExample_snip#TransformedXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/TransformedImageExample.xaml#transformedxaml2)]  
+  
+ [!code-csharp[ImageElementExample_snip#TransformedCSharp1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/TransformedImageExample.xaml.cs#transformedcsharp1)]
+ [!code-vb[ImageElementExample_snip#TransformedCSharp1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/TransformedImageExample.xaml.vb#transformedcsharp1)]
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-save-load-and-print-richtextbox-content.md b/docs/framework/wpf/controls/how-to-save-load-and-print-richtextbox-content.md
new file mode 100644
index 00000000000..68ce684589d
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-save-load-and-print-richtextbox-content.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : RichTextBox コンテンツを保存、読み込み、および印刷する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "読み込み (RichTextBox コントロールを)"
+  - "印刷 (RichTextBox コントロールを)"
+  - "RichTextBox コントロール, 読み込み"
+  - "RichTextBox コントロール, 印刷"
+  - "RichTextBox コントロール, 保存"
+  - "保存 (RichTextBox コントロールを)"
+ms.assetid: ffb113d3-c68a-47ca-8ac0-882283f38326
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : RichTextBox コンテンツを保存、読み込み、および印刷する
+<xref:System.Windows.Controls.RichTextBox> のコンテンツをファイルに保存し、そのコンテンツを再び <xref:System.Windows.Controls.RichTextBox> に読み込み、そのコンテンツを印刷する方法を次の例に示します。  
+  
+## 使用例  
+ 以下は、この例のマークアップです。  
+  
+ [!code-xml[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/SaveLoadPrintRTB.xaml#saveloadprintrtbexamplewholepage)]  
+  
+## 使用例  
+ 以下は、この例の分離コードです。  
+  
+ [!code-csharp[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/SaveLoadPrintRTB.xaml.cs#saveloadprintrtbcodeexamplewholepage)]
+ [!code-vb[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/VisualBasic/SaveLoadPrintRTB.xaml.vb#saveloadprintrtbcodeexamplewholepage)]  
+  
+## 参照  
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-scroll-content-by-using-the-iscrollinfo-interface.md b/docs/framework/wpf/controls/how-to-scroll-content-by-using-the-iscrollinfo-interface.md
new file mode 100644
index 00000000000..54888462cff
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-scroll-content-by-using-the-iscrollinfo-interface.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : IScrollInfo インターフェイスを使用してコンテンツをスクロールする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IScrollInfo インターフェイス"
+  - "スクロール (コンテンツを)"
+  - "ScrollViewer コントロール, スクロール (コンテンツを)"
+ms.assetid: d8700bef-a3f8-4c12-9de2-fc3b79f32cd3
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : IScrollInfo インターフェイスを使用してコンテンツをスクロールする
+この例では、<xref:System.Windows.Controls.Primitives.IScrollInfo> インターフェイスを使用して、コンテンツをスクロールする方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Primitives.IScrollInfo> インターフェイスの機能の例を次に示します。  この例では、親 <xref:System.Windows.Controls.ScrollViewer> に入れ子にされている <xref:System.Windows.Controls.StackPanel> 要素を [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で作成します。  <xref:System.Windows.Controls.StackPanel> の子要素を、<xref:System.Windows.Controls.Primitives.IScrollInfo> インターフェイスで定義されたメソッドを使って論理的にスクロールし、コード内で <xref:System.Windows.Controls.StackPanel> のインスタンス \(`sp1`\) にキャストすることができます。  
+  
+ [!code-xml[IScrollInfoMethods#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IScrollInfoMethods/CSharp/Window1.xaml#2)]  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル内の各 <xref:System.Windows.Controls.Button> は、<xref:System.Windows.Controls.StackPanel> 内でのスクロール動作を制御する関連したカスタム メソッドをトリガーします。  次の例は、<xref:System.Windows.Controls.Primitives.IScrollInfo.LineUp%2A> メソッドおよび <xref:System.Windows.Controls.Primitives.IScrollInfo.LineDown%2A> メソッドの使用方法を示しています。また、<xref:System.Windows.Controls.Primitives.IScrollInfo> クラスで定義されているすべての配置メソッドの一般的な使用方法も示しています。  
+  
+ [!code-csharp[IScrollInfoMethods#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IScrollInfoMethods/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[IScrollInfoMethods#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/IScrollInfoMethods/VisualBasic/Window1.xaml.vb#3)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ScrollViewer>   
+ <xref:System.Windows.Controls.Primitives.IScrollInfo>   
+ <xref:System.Windows.Controls.StackPanel>   
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/scrollviewer-how-to-topics.md)   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-set-focus-in-a-textbox-control.md b/docs/framework/wpf/controls/how-to-set-focus-in-a-textbox-control.md
new file mode 100644
index 00000000000..d79a4b95e3c
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-set-focus-in-a-textbox-control.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : TextBox コントロールにフォーカスを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "フォーカス, 設定"
+  - "TextBox コントロール, 設定 (フォーカスを)"
+ms.assetid: 24b61b45-dc2d-425e-9839-b017af7ab86f
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : TextBox コントロールにフォーカスを設定する
+<xref:System.Windows.UIElement.Focus%2A> メソッドを使用して、<xref:System.Windows.Controls.TextBox> コントロールにフォーカスを設定する方法を次の例に示します。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 例は、*tbFocusMe* という名前の単純な <xref:System.Windows.Controls.TextBox> コントロールを示しています。  
+  
+ [!code-xml[TextBox_MiscCode#_TextBoxFocusXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_textboxfocusxaml)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.UIElement.Focus%2A> メソッドを呼び出して、*tbFocusMe* という名前の <xref:System.Windows.Controls.TextBox> コントロールにフォーカスを設定しています。  
+  
+ [!code-csharp[TextBox_MiscCode#_FocusTextBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_focustextbox)]
+ [!code-vb[TextBox_MiscCode#_FocusTextBox](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_focustextbox)]  
+  
+## 参照  
+ <xref:System.Windows.UIElement.Focusable%2A>   
+ <xref:System.Windows.UIElement.IsFocused%2A>   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-set-the-height-properties-of-an-element.md b/docs/framework/wpf/controls/how-to-set-the-height-properties-of-an-element.md
new file mode 100644
index 00000000000..0690f9d90ed
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-set-the-height-properties-of-an-element.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : 要素の Height プロパティを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "高さのプロパティ"
+  - "Panel コントロール, 高さのプロパティ (要素の)"
+ms.assetid: 5ab9e781-dbb8-469a-a3c8-cf38ce312647
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 要素の Height プロパティを設定する
+## 使用例  
+ この例では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の高さに関連する 4 つのプロパティについて、描画の動作の違いを視覚的に示します。  
+  
+ <xref:System.Windows.FrameworkElement> クラスは、要素の高さの特性を記述する 4 つのプロパティを公開します。  これらの 4 つのプロパティは競合する可能性がありますが、その場合は、<xref:System.Windows.FrameworkElement.MinHeight%2A> 値、<xref:System.Windows.FrameworkElement.MaxHeight%2A> 値、<xref:System.Windows.FrameworkElement.Height%2A> 値の順序で優先して使用されます。  4 つ目のプロパティの <xref:System.Windows.FrameworkElement.ActualHeight%2A> は読み取り専用で、レイアウト プロセスとのやり取りによって決定される実際の高さを報告します。  
+  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、<xref:System.Windows.Shapes.Rectangle> 要素 \(`rect1`\) を <xref:System.Windows.Controls.Canvas> の子として描画します。  <xref:System.Windows.Shapes.Rectangle> の高さのプロパティは、<xref:System.Windows.FrameworkElement.MinHeight%2A>、<xref:System.Windows.FrameworkElement.MaxHeight%2A>、および <xref:System.Windows.FrameworkElement.Height%2A> の各プロパティ値を表す一連の <xref:System.Windows.Controls.ListBox> 要素を使用して変更できます。  この方法では、各プロパティの優先順位が表示されます。  
+  
+ [!code-xml[HeightMinHeightMaxHeight#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HeightMinHeightMaxHeight/CSharp/Window1.xaml#1)]  
+[!code-xml[HeightMinHeightMaxHeight#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HeightMinHeightMaxHeight/CSharp/Window1.xaml#2)]  
+  
+ 次の分離コードの例では、<xref:System.Windows.Controls.Primitives.Selector.SelectionChanged> イベントによって発生したイベントを処理します。  各ハンドラーは <xref:System.Windows.Controls.ListBox> から入力を受け取り、値を <xref:System.Double> として解析し、指定された高さに関連するプロパティに値を適用します。  高さの値は文字列にも変換され、各種の <xref:System.Windows.Controls.TextBlock> 要素に書き込まれます \(それらの要素の定義は、上の XAML の例には示されていません\)。  
+  
+ [!code-csharp[HeightMinHeightMaxHeight#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HeightMinHeightMaxHeight/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[HeightMinHeightMaxHeight#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HeightMinHeightMaxHeight/VisualBasic/Window1.xaml.vb#3)]  
+  
+ サンプル全体については、[Height プロパティのサンプル](http://go.microsoft.com/fwlink/?LinkID=159993)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement>   
+ <xref:System.Windows.Controls.ListBox>   
+ <xref:System.Windows.FrameworkElement.ActualHeight%2A>   
+ <xref:System.Windows.FrameworkElement.MaxHeight%2A>   
+ <xref:System.Windows.FrameworkElement.MinHeight%2A>   
+ <xref:System.Windows.FrameworkElement.Height%2A>   
+ [要素の Width プロパティを設定する](../../../../docs/framework/wpf/controls/how-to-set-the-width-properties-of-an-element.md)   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [Height プロパティのサンプル](http://go.microsoft.com/fwlink/?LinkID=159993)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-set-the-text-content-of-a-textbox-control.md b/docs/framework/wpf/controls/how-to-set-the-text-content-of-a-textbox-control.md
new file mode 100644
index 00000000000..0cd2570f1af
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-set-the-text-content-of-a-textbox-control.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : TextBox コントロールのテキスト コンテンツを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "テキスト コンテンツ, 設定"
+  - "TextBox コントロール, 設定 (テキスト コンテンツを)"
+ms.assetid: bcd25fc7-a52f-4453-b802-2c8d2b335ab8
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : TextBox コントロールのテキスト コンテンツを設定する
+この例では、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティを使用して、<xref:System.Windows.Controls.TextBox> コントロールの初期のテキスト コンテンツを設定する方法を示します。  
+  
+ **メモ** この例の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] バージョンでは、各ボタンの <xref:System.Windows.Controls.TextBox> コンテンツのテキストの前後に `<TextBox.Text>` タグを使用することもできますが、<xref:System.Windows.Controls.TextBox> は <xref:System.Windows.Controls.TextBox.Text%2A> プロパティに  <xref:System.Windows.Markup.ContentPropertyAttribute> 属性を適用するため、この処理は必要ありません。  詳細については、「[XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+## 使用例  
+ [!code-xml[TextBox_MiscCode#_TextBoxSetTextXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_textboxsettextxaml)]  
+  
+## 使用例  
+ [!code-csharp[TextBox_MiscCode#_TextBoxSetText](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_textboxsettext)]
+ [!code-vb[TextBox_MiscCode#_TextBoxSetText](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_textboxsettext)]  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-set-the-width-properties-of-an-element.md b/docs/framework/wpf/controls/how-to-set-the-width-properties-of-an-element.md
new file mode 100644
index 00000000000..c5bbd1d2a6f
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-set-the-width-properties-of-an-element.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : 要素の Width プロパティを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Panel コントロール, Width プロパティ (要素の)"
+  - "幅のプロパティ"
+ms.assetid: 6ee04a9d-63f0-4f5b-a406-0a8cd4c35729
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 要素の Width プロパティを設定する
+## 使用例  
+ この例では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の幅に関連する 4 つのプロパティについて、レンダリング動作の違いを視覚的に示します。  
+  
+ <xref:System.Windows.FrameworkElement> クラスは、要素の幅の特性を記述する 4 つのプロパティを公開します。  これらの 4 つのプロパティは競合する可能性がありますが、その場合は、<xref:System.Windows.FrameworkElement.MinWidth%2A> 値、<xref:System.Windows.FrameworkElement.MaxWidth%2A> 値、<xref:System.Windows.FrameworkElement.Width%2A> 値の順序で優先して使用されます。  4 つ目のプロパティの <xref:System.Windows.FrameworkElement.ActualWidth%2A> は読み取り専用で、レイアウト プロセスとのやり取りによって決定される実際の幅を報告します。  
+  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、<xref:System.Windows.Shapes.Rectangle> 要素 \(`rect1`\) を <xref:System.Windows.Controls.Canvas> の子として描画します。  <xref:System.Windows.Shapes.Rectangle> の幅のプロパティは、<xref:System.Windows.FrameworkElement.MinWidth%2A>、<xref:System.Windows.FrameworkElement.MaxWidth%2A>、および <xref:System.Windows.FrameworkElement.Width%2A> の各プロパティ値を表す一連の <xref:System.Windows.Controls.ListBox> 要素を使用して変更できます。  この方法では、各プロパティの優先順位が表示されます。  
+  
+ [!code-xml[WidthMinWidthMaxWidth#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WidthMinWidthMaxWidth/CSharp/Window1.xaml#1)]  
+[!code-xml[WidthMinWidthMaxWidth#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WidthMinWidthMaxWidth/CSharp/Window1.xaml#2)]  
+  
+ 次の分離コードの例では、<xref:System.Windows.Controls.Primitives.Selector.SelectionChanged> イベントによって発生したイベントを処理します。  各カスタム メソッドは <xref:System.Windows.Controls.ListBox> から入力を受け取り、値を <xref:System.Double> として解析し、指定された幅に関連するプロパティに値を適用します。  幅の値は文字列にも変換され、各種の <xref:System.Windows.Controls.TextBlock> 要素に書き込まれます \(それらの要素の定義は、上の XAML の例には示されていません\)。  
+  
+ [!code-csharp[WidthMinWidthMaxWidth#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WidthMinWidthMaxWidth/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[WidthMinWidthMaxWidth#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WidthMinWidthMaxWidth/VisualBasic/Window1.xaml.vb#3)]  
+  
+ サンプル全体については、[Width のプロパティの比較のサンプル](http://go.microsoft.com/fwlink/?LinkID=160050)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListBox>   
+ <xref:System.Windows.FrameworkElement>   
+ <xref:System.Windows.FrameworkElement.ActualWidth%2A>   
+ <xref:System.Windows.FrameworkElement.MaxWidth%2A>   
+ <xref:System.Windows.FrameworkElement.MinWidth%2A>   
+ <xref:System.Windows.FrameworkElement.Width%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [要素の Height プロパティを設定する](../../../../docs/framework/wpf/controls/how-to-set-the-height-properties-of-an-element.md)   
+ [Width のプロパティの比較のサンプル](http://go.microsoft.com/fwlink/?LinkID=160050)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-share-sizing-properties-between-grids.md b/docs/framework/wpf/controls/how-to-share-sizing-properties-between-grids.md
new file mode 100644
index 00000000000..6098bdb41fa
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-share-sizing-properties-between-grids.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : グリッド間でサイズ設定プロパティを共有する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グリッド コントロール, 共有 (列のサイズ設定データを)"
+  - "グリッド コントロール, 共有 (行のサイズ設定データを)"
+  - "サイズ設定データ (グリッド コントロールの)"
+ms.assetid: a0535a6f-ff04-4b25-9912-7dd856e11044
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : グリッド間でサイズ設定プロパティを共有する
+この例では、一貫したサイズ設定を行うために、<xref:System.Windows.Controls.Grid> の要素間で列と行のサイズ設定データを共有する方法を示します。  
+  
+## 使用例  
+ 次の例では、親 <xref:System.Windows.Controls.DockPanel> の子要素として 2 つの <xref:System.Windows.Controls.Grid> 要素を導入しています。  <xref:System.Windows.Controls.Grid> の <xref:System.Windows.Controls.Grid.IsSharedSizeScope%2A> [添付プロパティ](GTMT)は、親 <xref:System.Windows.Controls.DockPanel> で定義されています。  
+  
+ この例では、2 つの <xref:System.Windows.Controls.Button> 要素を使用してプロパティの値を操作します。各要素は、Boolean プロパティ値の 1 つを表します。  <xref:System.Windows.Controls.Grid.IsSharedSizeScope%2A> プロパティ値が `true` に設定されている場合、<xref:System.Windows.Controls.DefinitionBase.SharedSizeGroup%2A> の各列または行メンバーは、行または列のコンテンツに関係なく、サイズ設定情報を共有します。  
+  
+ [!code-xml[gridIssharedsizescopeProp#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml#1)]  
+  
+ ...  
+  
+ [!code-xml[gridIssharedsizescopeProp#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml#2)]  
+  
+ 次の分離コード例では、ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントによって起動されるメソッドを処理します。  この例では、これらのメソッドの <xref:System.Windows.Controls.TextBlock> 要素に対する呼び出しの結果を記述しています。この要素は、関連する get メソッドを使用して新しいプロパティの値を文字列として出力します。  
+  
+ [!code-csharp[gridIssharedsizescopeProp#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/gridIssharedsizescopeProp/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[gridIssharedsizescopeProp#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/gridIssharedsizescopeProp/VisualBasic/Window1.xaml.vb#3)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ <xref:System.Windows.Controls.Grid.IsSharedSizeScope%2A>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md b/docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md
new file mode 100644
index 00000000000..c3550f485ad
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md
@@ -0,0 +1,231 @@
+---
+title: "方法 : ヘッダーがクリックされたときに GridView 列を並べ替える | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GridView コントロール"
+  - "ListView コントロール"
+  - "ListView コントロール、GridView の列の並べ替え"
+  - "GridView コントロールを ListView コントロール"
+ms.assetid: 4865d720-d147-40ed-83a7-af7587f8aad8
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : ヘッダーがクリックされたときに GridView 列を並べ替える
+この例を作成する方法を示しています、 <xref:System.Windows.Controls.ListView>を実装するコントロール、 <xref:System.Windows.Controls.GridView>モードと並べ替えの列ヘッダーをクリックすると、データがコンテンツを表示します。  
+  
+## <a name="example"></a>例  
+ 次の例、 <xref:System.Windows.Controls.GridView>バインド先である&3; つの列を含む、<xref:System.DateTime.Year%2A>、<xref:System.DateTime.Month%2A>、および<xref:System.DateTime.Day%2A>のプロパティ、 <xref:System.DateTime>構造体。  
+  
+```xaml  
+<GridView>  
+  <GridViewColumn DisplayMemberBinding="{Binding Path=Year}"   
+                  Header="Year"  
+                  Width="100"/>  
+  <GridViewColumn DisplayMemberBinding="{Binding Path=Month}"   
+                  Header="Month"  
+                  Width="100"/>  
+  <GridViewColumn DisplayMemberBinding="{Binding Path=Day}"   
+                  Header="Day"  
+                  Width="100"/>  
+</GridView>  
+```  
+  
+ 次の例では、データ項目として定義されている、 <xref:System.Collections.ArrayList>の<xref:System.DateTime>オブジェクトです。 <xref:System.Collections.ArrayList>として定義された、 <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A>の<xref:System.Windows.Controls.ListView>コントロールです。  
+  
+```xaml  
+<ListView.ItemsSource>  
+  <s:ArrayList>  
+    <p:DateTime>1993/1/1 12:22:02</p:DateTime>  
+    <p:DateTime>1993/1/2 13:2:01</p:DateTime>  
+    <p:DateTime>1997/1/3 2:1:6</p:DateTime>  
+    <p:DateTime>1997/1/4 13:6:55</p:DateTime>  
+    <p:DateTime>1999/2/1 12:22:02</p:DateTime>  
+    <p:DateTime>1998/2/2 13:2:01</p:DateTime>  
+    <p:DateTime>2000/2/3 2:1:6</p:DateTime>  
+    <p:DateTime>2002/2/4 13:6:55</p:DateTime>  
+    <p:DateTime>2001/3/1 12:22:02</p:DateTime>  
+    <p:DateTime>2006/3/2 13:2:01</p:DateTime>  
+    <p:DateTime>2004/3/3 2:1:6</p:DateTime>  
+    <p:DateTime>2004/3/4 13:6:55</p:DateTime>  
+  </s:ArrayList>  
+</ListView.ItemsSource>  
+```  
+  
+ `s`と`p`の識別子、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]タグがのメタデータで定義されている名前空間マッピングを参照してください、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ページです。 次の例では、メタデータの定義を示します。  
+  
+```xaml  
+<Window        
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    x:Class="ListViewSort.Window1"      
+    xmlns:s="clr-namespace:System.Collections;assembly=mscorlib"  
+    xmlns:p="clr-namespace:System;assembly=mscorlib">  
+```  
+  
+ 処理するイベント ハンドラーを定義している例では、列の内容に従ってデータを並べ替える、<xref:System.Windows.Controls.Primitives.ButtonBase.Click>列ヘッダーのボタンを押したときに発生するイベントです。 次の例では、イベント ハンドラーを指定する方法、 <xref:System.Windows.Controls.GridViewColumnHeader>コントロールです。  
+  
+```xaml  
+<ListView x:Name='lv' Height="150" HorizontalAlignment="Center"   
+  VerticalAlignment="Center"   
+  GridViewColumnHeader.Click="GridViewColumnHeaderClickedHandler"  
+ >  
+```  
+  
+ 例は、並べ替えの方向は昇順と降順の列ヘッダーのボタンをクリックするたびに間変更されるように、イベント ハンドラーを定義します。 次の例では、イベント ハンドラーを示します。  
+  
+```csharp  
+public partial class Window1 : Window  
+{  
+    public Window1()  
+    {  
+        InitializeComponent();  
+    }  
+  
+    GridViewColumnHeader _lastHeaderClicked = null;  
+    ListSortDirection _lastDirection = ListSortDirection.Ascending;  
+  
+    void GridViewColumnHeaderClickedHandler(object sender,  
+                                            RoutedEventArgs e)  
+    {  
+        GridViewColumnHeader headerClicked =  
+              e.OriginalSource as GridViewColumnHeader;  
+        ListSortDirection direction;  
+  
+        if (headerClicked != null)  
+        {  
+            if (headerClicked.Role != GridViewColumnHeaderRole.Padding)  
+            {  
+                if (headerClicked != _lastHeaderClicked)  
+                {  
+                    direction = ListSortDirection.Ascending;  
+                }  
+                else  
+                {  
+                    if (_lastDirection == ListSortDirection.Ascending)  
+                    {  
+                        direction = ListSortDirection.Descending;  
+                    }  
+                    else  
+                    {  
+                        direction = ListSortDirection.Ascending;  
+                    }  
+                }  
+  
+                string header = headerClicked.Column.Header as string;  
+                Sort(header, direction);  
+  
+                if (direction == ListSortDirection.Ascending)  
+                {  
+                    headerClicked.Column.HeaderTemplate =  
+                      Resources["HeaderTemplateArrowUp"] as DataTemplate;  
+                }  
+                else  
+                {  
+                    headerClicked.Column.HeaderTemplate =  
+                      Resources["HeaderTemplateArrowDown"] as DataTemplate;  
+                }  
+  
+                // Remove arrow from previously sorted header  
+                if (_lastHeaderClicked != null && _lastHeaderClicked != headerClicked)  
+                {  
+                    _lastHeaderClicked.Column.HeaderTemplate = null;  
+                }  
+  
+                _lastHeaderClicked = headerClicked;  
+                _lastDirection = direction;  
+            }  
+        }  
+    }  
+```  
+  
+```vb  
+Partial Public Class Window1  
+        Inherits Window  
+        Public Sub New()  
+            InitializeComponent()  
+        End Sub  
+  
+        Private _lastHeaderClicked As GridViewColumnHeader = Nothing  
+        Private _lastDirection As ListSortDirection = ListSortDirection.Ascending  
+  
+        Private Sub GridViewColumnHeaderClickedHandler(ByVal sender As Object, ByVal e As RoutedEventArgs)  
+            Dim headerClicked As GridViewColumnHeader = TryCast(e.OriginalSource, GridViewColumnHeader)  
+            Dim direction As ListSortDirection  
+  
+            If headerClicked IsNot Nothing Then  
+                If headerClicked.Role <> GridViewColumnHeaderRole.Padding Then  
+                    If headerClicked IsNot _lastHeaderClicked Then  
+                        direction = ListSortDirection.Ascending  
+                    Else  
+                        If _lastDirection = ListSortDirection.Ascending Then  
+                            direction = ListSortDirection.Descending  
+                        Else  
+                            direction = ListSortDirection.Ascending  
+                        End If  
+                    End If  
+  
+                    Dim header As String = TryCast(headerClicked.Column.Header, String)  
+                    Sort(header, direction)  
+  
+                    If direction = ListSortDirection.Ascending Then  
+                        headerClicked.Column.HeaderTemplate = TryCast(Resources("HeaderTemplateArrowUp"), DataTemplate)  
+                    Else  
+                        headerClicked.Column.HeaderTemplate = TryCast(Resources("HeaderTemplateArrowDown"), DataTemplate)  
+                    End If  
+  
+                    ' Remove arrow from previously sorted header  
+                    If _lastHeaderClicked IsNot Nothing AndAlso _lastHeaderClicked IsNot headerClicked Then  
+                        _lastHeaderClicked.Column.HeaderTemplate = Nothing  
+                    End If  
+  
+                    _lastHeaderClicked = headerClicked  
+                    _lastDirection = direction  
+                End If  
+            End If  
+        End Sub  
+```  
+  
+ 次の例では、データの並べ替えにイベント ハンドラーが呼び出される並べ替えアルゴリズムを示します。 並べ替えを実行して、新しいを作成して<xref:System.ComponentModel.SortDescription>構造体。  
+  
+```csharp  
+private void Sort(string sortBy, ListSortDirection direction)  
+{  
+    ICollectionView dataView =  
+      CollectionViewSource.GetDefaultView(lv.ItemsSource);  
+  
+    dataView.SortDescriptions.Clear();  
+    SortDescription sd = new SortDescription(sortBy, direction);  
+    dataView.SortDescriptions.Add(sd);  
+    dataView.Refresh();  
+}  
+  
+```  
+  
+```vb  
+Private Sub Sort(ByVal sortBy As String, ByVal direction As ListSortDirection)  
+            Dim dataView As ICollectionView = CollectionViewSource.GetDefaultView(lv.ItemsSource)  
+  
+            dataView.SortDescriptions.Clear()  
+            Dim sd As New SortDescription(sortBy, direction)  
+            dataView.SortDescriptions.Add(sd)  
+            dataView.Refresh()  
+        End Sub  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md b/docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md
new file mode 100644
index 00000000000..d8f18b03da0
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : ポップアップのカスタム位置を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Popup コントロール, 指定 (カスタム位置を)"
+ms.assetid: 28c24f39-d3aa-4ee2-b950-384b4a5dab92
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ポップアップのカスタム位置を指定する
+<xref:System.Windows.Controls.Primitives.Popup.Placement%2A> プロパティが <xref:System.Windows.Controls.Primitives.PlacementMode> に設定されている場合に、<xref:System.Windows.Controls.Primitives.Popup> コントロールのカスタム位置を指定する方法を次の例に示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Primitives.Popup.Placement%2A> プロパティが <xref:System.Windows.Controls.Primitives.PlacementMode> に設定されると、<xref:System.Windows.Controls.Primitives.Popup> は <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback> デリゲートの定義済みインスタンスを呼び出します。  このデリゲートは、ターゲット領域の左上隅および <xref:System.Windows.Controls.Primitives.Popup> の左上隅を基準として、表示先になり得る一連の相対位置を返します。  <xref:System.Windows.Controls.Primitives.Popup> は、最も見やすい位置に配置されます。  
+  
+ <xref:System.Windows.Controls.Primitives.Popup.Placement%2A> プロパティを <xref:System.Windows.Controls.Primitives.PlacementMode> に設定することによって <xref:System.Windows.Controls.Primitives.Popup> の位置を定義する方法を次の例に示します。  この例では、<xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback> デリゲートを作成して割り当てることによって <xref:System.Windows.Controls.Primitives.Popup> を配置する方法も示します。  コールバック デリゲートは、2 つの <xref:System.Windows.Controls.Primitives.CustomPopupPlacement> オブジェクトを返します。  最初の位置では <xref:System.Windows.Controls.Primitives.Popup> が画面の端に隠れる場合、<xref:System.Windows.Controls.Primitives.Popup> は 2 番目の位置に配置されます。  
+  
+ [!code-xml[PopupCustomPlacement#CustomPlacement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupCustomPlacement/CSharp/Window1.xaml#customplacement)]  
+  
+ [!code-csharp[PopupCustomPlacement#DelegateInstance](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupCustomPlacement/CSharp/Window1.xaml.cs#delegateinstance)]
+ [!code-vb[PopupCustomPlacement#DelegateInstance](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PopupCustomPlacement/visualbasic/window1.xaml.vb#delegateinstance)]  
+  
+ [!code-csharp[PopupCustomPlacement#DelegateDefinition](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupCustomPlacement/CSharp/Window1.xaml.cs#delegatedefinition)]
+ [!code-vb[PopupCustomPlacement#DelegateDefinition](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PopupCustomPlacement/visualbasic/window1.xaml.vb#delegatedefinition)]  
+  
+ サンプル全体については、[ポップアップ配置のサンプル](http://go.microsoft.com/fwlink/?LinkID=160032)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Primitives.Popup>   
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-style-a-row-in-a-listview-that-implements-a-gridview.md b/docs/framework/wpf/controls/how-to-style-a-row-in-a-listview-that-implements-a-gridview.md
new file mode 100644
index 00000000000..a2495ab9e29
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-style-a-row-in-a-listview-that-implements-a-gridview.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : GridView を実装する ListView で行のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "行のスタイル設定、GridView コントロール"
+  - "スタイル設定 (GridView を実装する ListView の行を)"
+  - "ListView コントロール、Gridview を含む行のスタイル設定"
+ms.assetid: 2e406ba2-70a0-4e62-841f-0934859de76e
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : GridView を実装する ListView で行のスタイルを設定する
+内の行のスタイルを設定する方法を示します、 <xref:System.Windows.Controls.ListView>を実装するコントロール、 <xref:System.Windows.Controls.GridView><xref:System.Windows.Controls.ListView.View%2A>モードです。  
+  
+## <a name="example"></a>例  
+ 内の行のスタイルを設定することができます、 <xref:System.Windows.Controls.ListView>コントロールを設定して、 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>上、 <xref:System.Windows.Controls.ListView>コントロールです。 として表される項目のスタイルを設定<xref:System.Windows.Controls.ListViewItem>のオブジェクト。 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>参照、 <xref:System.Windows.Controls.ControlTemplate>オブジェクト、行の内容を表示するために使用します。  
+  
+ 次の例の抽出元で、完全なサンプルに格納されている楽曲情報のコレクションを表示する、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)]データベースです。 データベースの各曲が格納された rating フィールドをこのフィールドの値が曲情報の行を表示する方法を指定します。  
+  
+ 次の例は、定義する方法を示しています。 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>の、 <xref:System.Windows.Controls.ListViewItem>曲のコレクション内の曲を表すオブジェクト。 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>参照<xref:System.Windows.Controls.ControlTemplate>楽曲情報の行を表示する方法を指定するオブジェクト。  
+  
+ [!code-xml[ListViewItemStyleSnippet#ItemContainerStyle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewItemStyleSnippet/CS/Window1.xaml#itemcontainerstyle)]  
+  
+ 例を次に、 <xref:System.Windows.Controls.ControlTemplate>テキスト文字列を追加する`"Strongly Recommended"`行にします。 このテンプレートで参照される、 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>し、曲の格付けがある 5 (5) の値が表示されます。 <xref:System.Windows.Controls.ControlTemplate>を含む、 <xref:System.Windows.Controls.GridViewRowPresenter>オブジェクトで定義されている列の行の内容をレイアウトする、 <xref:System.Windows.Controls.GridView>表示モード。  
+  
+ [!code-xml[ListViewItemStyleSnippet#ControlTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewItemStyleSnippet/CS/Window1.xaml#controltemplate)]  
+  
+ 次の例では定義<xref:System.Windows.Controls.GridView>します。  
+  
+ [!code-xml[ListViewItemStyleSnippet#GridView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewItemStyleSnippet/CS/Window1.xaml#gridview)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-style-controls-on-a-toolbar.md b/docs/framework/wpf/controls/how-to-style-controls-on-a-toolbar.md
new file mode 100644
index 00000000000..1935ba2f4d3
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-style-controls-on-a-toolbar.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : ToolBar のコントロールのスタイルを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタマイズ (ツール バーのコントロールを)"
+  - "スタイル設定 (ツール バーのコントロールを)"
+  - "ツール バー"
+ms.assetid: ba6ae056-d6a9-4c24-90f8-467ab0bc0b1a
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : ToolBar のコントロールのスタイルを指定する
+<xref:System.Windows.Controls.ToolBar> では、<xref:System.Windows.ResourceKey> オブジェクトを定義することで、<xref:System.Windows.Controls.ToolBar> に含まれているコントロールのスタイルを指定します。  <xref:System.Windows.Controls.ToolBar> のコントロールのスタイルを指定するには、スタイルの `x:key` 属性を <xref:System.Windows.Controls.ToolBar> で定義された <xref:System.Windows.ResourceKey> に設定します。  
+  
+ <xref:System.Windows.Controls.ToolBar> は次の <xref:System.Windows.ResourceKey> オブジェクトを定義します。  
+  
+-   <xref:System.Windows.Controls.ToolBar.ButtonStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.CheckBoxStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.ComboBoxStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.MenuStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.RadioButtonStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.SeparatorStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.TextBoxStyleKey%2A>  
+  
+-   <xref:System.Windows.Controls.ToolBar.ToggleButtonStyleKey%2A>  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Controls.ToolBar> に含まれているコントロールのスタイルを定義しています。  
+  
+ [!code-xml[ToolBar_snip#ToolBarAllStyles](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolBar_snip/CS/pane1.xaml#toolbarallstyles)]  
+[!code-xml[ToolBar_snip#ToolBar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolBar_snip/CS/pane1.xaml#toolbar)]  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md b/docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md
new file mode 100644
index 00000000000..9685f14b2c5
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : TextBox でカスタム コンテキスト メニューを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コンテキスト メニュー, カスタム"
+  - "カスタム コンテキスト メニュー"
+  - "メニュー, カスタム"
+  - "TextBox コントロール, カスタム コンテキスト メニュー"
+ms.assetid: 842d3cd5-6fa0-4be4-8d90-6c7466213b1c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : TextBox でカスタム コンテキスト メニューを使用する
+この例では、<xref:System.Windows.Controls.TextBox> に対する単純なカスタム コンテキスト メニューを定義および実装する方法を示します。  
+  
+## 使用例  
+ 次の [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、カスタム コンテキスト メニューを持つ <xref:System.Windows.Controls.TextBox> コントロールを定義しています。  
+  
+ コンテキスト メニューを定義するには、<xref:System.Windows.Controls.ContextMenu> 要素を使用します。  コンテキスト メニュー自体は、一連の <xref:System.Windows.Controls.MenuItem> 要素と <xref:System.Windows.Controls.Separator> 要素で構成されます。  各 <xref:System.Windows.Controls.MenuItem> 要素は、コンテキスト メニュー内のコマンドを定義します。<xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> 属性は、メニュー コマンドの表示テキストを定義し、<xref:System.Windows.Controls.MenuItem.Click> 属性は各メニュー項目に対するハンドラー メソッドを指定します。  <xref:System.Windows.Controls.Separator> は、前後のメニュー項目の間に区切り線を表示するための要素です。  
+  
+ [!code-xml[TextBox_ContextMenu#_TextBox_ContextMenuXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_ContextMenu/CSharp/Window1.xaml#_textbox_contextmenuxaml)]  
+  
+## 使用例  
+ 上記で定義したコンテキスト メニューの実装コード、およびコンテキスト メニューを有効または無効にするコードを次の例に示します。  <xref:System.Windows.Controls.ContextMenu.Opened> イベントを使用して、<xref:System.Windows.Controls.TextBox> の現在の状態に応じて特定のコマンドを動的に有効または無効にする処理を行います。  
+  
+ 既定のコンテキスト メニューに戻すには、<xref:System.Windows.DependencyObject.ClearValue%2A> メソッドを使用して <xref:System.Windows.FrameworkElement.ContextMenu%2A> プロパティの値を消去します。  コンテキスト メニュー全体を無効にするには、<xref:System.Windows.FrameworkElement.ContextMenu%2A> プロパティを null 参照 \(Visual Basic の場合は `Nothing`\) に設定します。  
+  
+ [!code-csharp[TextBox_ContextMenu#_TextBox_ContextMenu](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_ContextMenu/CSharp/Window1.xaml.cs#_textbox_contextmenu)]
+ [!code-vb[TextBox_ContextMenu#_TextBox_ContextMenu](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_ContextMenu/VisualBasic/Window1.xaml.vb#_textbox_contextmenu)]  
+  
+## 参照  
+ [コンテキスト メニューでスペル チェックを使用する](../../../../docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md b/docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md
new file mode 100644
index 00000000000..f5493ead3e7
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : SelectedValue、SelectedValuePath、および SelectedItem を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Control クラス, SelectedItem プロパティ"
+  - "Control クラス, SelectedValue プロパティ"
+  - "Control クラス, SelectedValuePath プロパティ"
+  - "Control クラス, TreeView プロパティ"
+  - "SelectedValue, SelectedItem プロパティ"
+  - "SelectedValue, SelectedValuePath プロパティ"
+  - "TreeView コントロール, SelectedItem プロパティ"
+  - "TreeView コントロール, SelectedValue プロパティ"
+  - "TreeView コントロール, SelectedValuePath プロパティ"
+ms.assetid: 2fc92ad4-f02c-4f89-bbe9-d4978a7af0db
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : SelectedValue、SelectedValuePath、および SelectedItem を使用する
+この例では、<xref:System.Windows.Controls.TreeView.SelectedValue%2A> および <xref:System.Windows.Controls.TreeView.SelectedValuePath%2A> プロパティを使用して、<xref:System.Windows.Controls.TreeView> の <xref:System.Windows.Controls.TreeView.SelectedItem%2A> の値を指定する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TreeView.SelectedValuePath%2A> プロパティは、<xref:System.Windows.Controls.TreeView> の <xref:System.Windows.Controls.TreeView.SelectedItem%2A> に対して <xref:System.Windows.Controls.TreeView.SelectedValue%2A> を指定する方法を提供します。  <xref:System.Windows.Controls.TreeView.SelectedItem%2A> は <xref:System.Windows.Controls.ItemsControl.Items%2A> コレクション内のオブジェクトを表し、<xref:System.Windows.Controls.TreeView> は選択された項目の 1 つのプロパティの値を表示します。  <xref:System.Windows.Controls.TreeView.SelectedValuePath%2A> プロパティは、<xref:System.Windows.Controls.TreeView.SelectedValue%2A> プロパティの値の決定に使用されたプロパティへのパスを指定します。  このトピックの例で、この概念を示します。  
+  
+ 次の例では、従業員情報を含む <xref:System.Windows.Data.XmlDataProvider> を示します。  
+  
+ [!code-xml[TreeViewSelectedValue#XMLDataProvider](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSelectedValue/CS/Window1.xaml#xmldataprovider)]  
+  
+ 次の例は、`Employee` の `EmployeeName` と `EmployeeWorkDay` を表示する <xref:System.Windows.HierarchicalDataTemplate> を定義しています。  <xref:System.Windows.HierarchicalDataTemplate> では、`EmployeeNumber` をテンプレートの一部として指定していないことに注意してください。  
+  
+ [!code-xml[TreeViewSelectedValue#HierarchicalDataTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSelectedValue/CS/Window1.xaml#hierarchicaldatatemplate)]  
+  
+ 次の例は、前に定義された <xref:System.Windows.HierarchicalDataTemplate> を使用し、<xref:System.Windows.Controls.TreeView.SelectedValue%2A> プロパティを `EmployeeNumber` に設定する、<xref:System.Windows.Controls.TreeView> を示しています。  <xref:System.Windows.Controls.TreeView> で `EmployeeName` を選択すると、<xref:System.Windows.Controls.TreeView.SelectedItem%2A> プロパティは、選択された `EmployeeName` に対応する `EmployeeInfo` データ項目を返します。  ただし、この <xref:System.Windows.Controls.TreeView> の <xref:System.Windows.Controls.TreeView.SelectedValuePath%2A> は `EmployeeNumber` に設定されているため、<xref:System.Windows.Controls.TreeView.SelectedValue%2A> は `EmployeeNumber` に設定されます。  
+  
+ [!code-xml[TreeViewSelectedValue#SelectedValuePath](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSelectedValue/CS/Window1.xaml#selectedvaluepath)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.TreeView>   
+ <xref:System.Windows.Controls.TreeViewItem>   
+ [TreeView の概要](../../../../docs/framework/wpf/controls/treeview-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/treeview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md b/docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md
new file mode 100644
index 00000000000..88cb24d3e23
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : コンテキスト メニューでスペル チェックを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "有効化 (テキスト ボックスでスペル チェックを) [WPF]"
+  - "再有効化 (テキスト ボックスでスペル チェックを) [WPF]"
+  - "スペル チェック (コンテキスト メニューによる) [WPF]"
+ms.assetid: 61f69a20-2ff3-4056-9060-e32f4483ec5e
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : コンテキスト メニューでスペル チェックを使用する
+既定では、<xref:System.Windows.Controls.TextBox> や <xref:System.Windows.Controls.RichTextBox> などの編集コントロールでスペル チェックを有効にすると、スペル チェック用の項目がコンテキスト メニューに表示されます。  たとえば、スペルが間違っている単語をユーザーが右クリックすると、スペル修正の候補や **\[すべて無視\]** のオプションが表示されます。  しかし、既定のコンテキスト メニューを独自のカスタム コンテキスト メニューでオーバーライドすると、この機能は失われ、コンテキスト メニューのスペル チェック機能を再度有効にするためのコードを記述する必要があります。  <xref:System.Windows.Controls.TextBox> でこれを行う方法を次の例に示します。  
+  
+## 使用例  
+ コンテキスト メニューの実装に使用するイベントを持つ <xref:System.Windows.Controls.TextBox> を作成する [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を次の例に示します。  
+  
+ [!code-xml[TextBoxMiscSnippets_snip#SpellerCustomContextMenuExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/speller_custom_context_menu.xaml#spellercustomcontextmenuexamplewholepage)]  
+  
+## 使用例  
+ コンテキスト メニューを実装するコードを次の例に示します。  
+  
+ [!code-csharp[TextBoxMiscSnippets_snip#SpellerCustomContextMenuCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/speller_custom_context_menu.xaml.cs#spellercustomcontextmenucodeexamplewholepage)]
+ [!code-vb[TextBoxMiscSnippets_snip#SpellerCustomContextMenuCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/visualbasic/speller_custom_context_menu.xaml.vb#spellercustomcontextmenucodeexamplewholepage)]  
+  
+ <xref:System.Windows.Controls.RichTextBox> でこれを行う場合も、同様のコードを使用します。  大きな違いは、`GetSpellingError` メソッドに渡すパラメーターです。  <xref:System.Windows.Controls.TextBox> に対しては、キャレット位置のインデックスを表す整数を渡します。  
+  
+ `spellingError = myTextBox.GetSpellingError(caretIndex);`  
+  
+ <xref:System.Windows.Controls.RichTextBox> に対しては、キャレット位置を表す <xref:System.Windows.Documents.TextPointer> を渡します。  
+  
+ `spellingError = myRichTextBox.GetSpellingError(myRichTextBox.CaretPosition);`  
+  
+## 参照  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)   
+ [テキスト編集コントロールでスペル チェックを有効にする](../../../../docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md)   
+ [TextBox でカスタム コンテキスト メニューを使用する](../../../../docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-templates-to-style-a-listview-that-uses-gridview.md b/docs/framework/wpf/controls/how-to-use-templates-to-style-a-listview-that-uses-gridview.md
new file mode 100644
index 00000000000..68adefcce35
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-templates-to-style-a-listview-that-uses-gridview.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : テンプレートを使用して、GridView を使用する ListView のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール, スタイル設定"
+ms.assetid: 94bf964b-96c8-4bdf-a0c3-f5271b7cb565
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : テンプレートを使用して、GridView を使用する ListView のスタイルを設定する
+<xref:System.Windows.DataTemplate> オブジェクトと <xref:System.Windows.Style> オブジェクトを使用して、<xref:System.Windows.Controls.GridView> 表示モードを使用する <xref:System.Windows.Controls.ListView> コントロールの外観を指定する方法を次の例に示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Controls.GridViewColumn> の列ヘッダーの外観をカスタマイズする <xref:System.Windows.Style> オブジェクトと <xref:System.Windows.DataTemplate> オブジェクトを示します。  
+  
+ [!code-xml[ListViewTemplate#GridViewHeaderStyle](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#gridviewheaderstyle)]  
+  
+ [!code-xml[ListViewTemplate#GridViewHeaderTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#gridviewheadertemplate)]  
+  
+ これらの <xref:System.Windows.Style> オブジェクトと <xref:System.Windows.DataTemplate> オブジェクトを使用して <xref:System.Windows.Controls.GridViewColumn> の <xref:System.Windows.Controls.GridViewColumn.HeaderContainerStyle%2A> プロパティと <xref:System.Windows.Controls.GridViewColumn.HeaderTemplate%2A> プロパティを設定する方法を次の例に示します。  <xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> プロパティでは、列のセルのコンテンツが定義されています。  
+  
+ [!code-xml[ListViewTemplate#GridViewColumnTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#gridviewcolumntemplate)]  
+  
+ <xref:System.Windows.Controls.GridViewColumn.HeaderContainerStyle%2A> と <xref:System.Windows.Controls.GridViewColumn.HeaderTemplate%2A> の他にも、<xref:System.Windows.Controls.GridView> コントロールには、列ヘッダーの外観をカスタマイズするために使用できるプロパティがいくつかあります。  詳細については、「[GridView の列ヘッダー スタイルおｙびテンプレートの概要](../../../../docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md)」を参照してください。  
+  
+ 次の例では、<xref:System.Windows.Controls.GridViewColumn> のセルの外観をカスタマイズする <xref:System.Windows.DataTemplate> を定義する方法を示します。  
+  
+ [!code-xml[ListViewTemplate#GridViewCellTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#gridviewcelltemplate)]  
+  
+ 次の例では、この <xref:System.Windows.DataTemplate> を使用して <xref:System.Windows.Controls.GridViewColumn> セルのコンテンツを定義する方法を示します。  このテンプレートは、前の <xref:System.Windows.Controls.GridViewColumn> の例で示した <xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> プロパティの代わりに使用されています。  
+  
+ [!code-xml[ListViewTemplate#CellTemplateProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#celltemplateproperty)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-the-attached-properties-of-canvas-to-position-child-elements.md b/docs/framework/wpf/controls/how-to-use-the-attached-properties-of-canvas-to-position-child-elements.md
new file mode 100644
index 00000000000..8b0caffc8c3
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-the-attached-properties-of-canvas-to-position-child-elements.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : Canvas の添付プロパティを使用して子要素を配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "添付プロパティ [WPF デザイナー]"
+  - "Canvas コントロール, 添付プロパティ"
+ms.assetid: 48f1d25d-3820-4107-a4cc-d6c1e5664a44
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : Canvas の添付プロパティを使用して子要素を配置する
+この例では、<xref:System.Windows.Controls.Canvas> の[添付プロパティ](GTMT)を使用して子要素を配置する方法を示します。  
+  
+## 使用例  
+ 次の例では、4 つの <xref:System.Windows.Controls.Button> 要素を親 <xref:System.Windows.Controls.Canvas> の子要素として追加します。  各子要素は、<xref:System.Windows.Controls.Canvas> の異なる添付プロパティである <xref:System.Windows.Controls.Canvas.Bottom%2A>、<xref:System.Windows.Controls.Canvas.Left%2A>、<xref:System.Windows.Controls.Canvas.Right%2A>、および <xref:System.Windows.Controls.Canvas.Top%2A> を表します。  各 <xref:System.Windows.Controls.Button> は、親の <xref:System.Windows.Controls.Canvas> を基準に、割り当てられているプロパティ値に従って配置されます。  
+  
+ [!code-cpp[CanvasAttachedProperties#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/CanvasAttachedProperties/CPP/CanvasAttachedProps.cpp#1)]
+ [!code-csharp[CanvasAttachedProperties#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasAttachedProperties/CSharp/CanvasAttachedProps.cs#1)]
+ [!code-vb[CanvasAttachedProperties#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CanvasAttachedProperties/VisualBasic/CanvasAttachedProps.vb#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Canvas>   
+ <xref:System.Windows.Controls.Canvas.Bottom%2A>   
+ <xref:System.Windows.Controls.Canvas.Left%2A>   
+ <xref:System.Windows.Controls.Canvas.Right%2A>   
+ <xref:System.Windows.Controls.Canvas.Top%2A>   
+ <xref:System.Windows.Controls.Button>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/canvas-how-to-topics.md)   
+ [添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-the-betweenshowdelay-property.md b/docs/framework/wpf/controls/how-to-use-the-betweenshowdelay-property.md
new file mode 100644
index 00000000000..912125d1ccf
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-the-betweenshowdelay-property.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : BetweenShowDelay プロパティを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BetweenShowDelay 時間プロパティ"
+  - "ToolTip コントロール, BetweenShowDelay 時間プロパティ"
+ms.assetid: 984ea76d-f2a2-4326-a02e-f97ec3d036d6
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : BetweenShowDelay プロパティを使用する
+この例では、<xref:System.Windows.Controls.ToolTipService.BetweenShowDelay%2A> 時間プロパティを使用して、ユーザーがあるツールヒントから別のツールヒントにマウス ポインターを直接移動したときに、ほとんど遅延なく、すばやくツールヒントを表示する方法を示します。  
+  
+## 使用例  
+ 次の例では、両方の <xref:System.Windows.Shapes.Ellipse> コントロールのツールヒントについて、<xref:System.Windows.Controls.ToolTipService.InitialShowDelay%2A> プロパティを 1 秒 \(1000 ミリ秒\) に設定し、<xref:System.Windows.Controls.ToolTipService.BetweenShowDelay%2A> を 2 秒 \(2000 ミリ秒\) に設定しています。  一方の楕円のツールヒントを表示した後、2 秒以内に別の楕円にマウス ポインターを移動してそこにとどまると、2 番目の楕円のツールヒントがすぐに表示されます。  
+  
+ 次のシナリオではいずれも、<xref:System.Windows.Controls.ToolTipService.InitialShowDelay%2A> が適用され、2 番目の楕円のツールヒントは 1 秒後に表示されます。  
+  
+-   2 番目の楕円に移動するのに 2 秒より長くかかる場合。  
+  
+-   1 番目の楕円の時間間隔の開始時に、ツールヒントが表示されない場合。  
+  
+ [!code-xml[ToolTipService#ToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#tooltip)]  
+[!code-xml[ToolTipService#NoToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#notooltip)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ToolTip>   
+ <xref:System.Windows.Controls.ToolTipService>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/tooltip-how-to-topics.md)   
+ [ToolTip の概要](../../../../docs/framework/wpf/controls/tooltip-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-the-content-scrolling-methods-of-scrollviewer.md b/docs/framework/wpf/controls/how-to-use-the-content-scrolling-methods-of-scrollviewer.md
new file mode 100644
index 00000000000..405c5258694
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-the-content-scrolling-methods-of-scrollviewer.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : ScrollViewer のコンテンツ スクロール メソッドを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IScrollInfo インターフェイス"
+  - "スクロール メソッド"
+  - "ScrollViewer コントロール, スクロール メソッド"
+ms.assetid: 4708cc65-6510-45f8-82e6-30b0d3e30045
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ScrollViewer のコンテンツ スクロール メソッドを使用する
+この例では、<xref:System.Windows.Controls.ScrollViewer> 要素のスクロール メソッドを使用する方法を示します。  これらのメソッドを使用すると、<xref:System.Windows.Controls.ScrollViewer> に表示されたコンテンツを行単位またはページ単位のインクリメント方式でスクロールできます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Controls.TextBlock> 子要素をホストする `sv1` という名前の <xref:System.Windows.Controls.ScrollViewer> を作成します。  <xref:System.Windows.Controls.TextBlock> は親である <xref:System.Windows.Controls.ScrollViewer> を超えているため、スクロール バーが表示され、スクロールできるようになっています。  また、さまざまなスクロール メソッドを表す <xref:System.Windows.Controls.Button> 要素が、別の <xref:System.Windows.Controls.StackPanel> の左側にドッキングされます。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイル内の各 <xref:System.Windows.Controls.Button> は、<xref:System.Windows.Controls.ScrollViewer> でのスクロール動作を制御する関連カスタム メソッドを呼び出します。  
+  
+ [!code-xml[ScrollViewerMethods#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ScrollViewerMethods/CSharp/Window1.xaml#1)]  
+  
+ 次の例では、<xref:System.Windows.Controls.ScrollViewer.LineUp%2A> メソッドと <xref:System.Windows.Controls.ScrollViewer.LineDown%2A> メソッドを使用しています。  
+  
+ [!code-csharp[ScrollViewerMethods#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ScrollViewerMethods/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[ScrollViewerMethods#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ScrollViewerMethods/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ScrollViewer>   
+ <xref:System.Windows.Controls.StackPanel>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-the-image-element.md b/docs/framework/wpf/controls/how-to-use-the-image-element.md
new file mode 100644
index 00000000000..7ddf0a6171a
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-the-image-element.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : イメージ要素を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapImage クラス"
+  - "クラス, BitmapImage"
+  - "コントロール, イメージ"
+  - "Image コントロール"
+  - "描画 (イメージを)"
+ms.assetid: 5b92e74b-1b56-4756-ac64-d5e9e08d9854
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : イメージ要素を使用する
+この例では、<xref:System.Windows.Controls.Image> 要素を使用してアプリケーションにイメージを含める方法を示します。  
+  
+## 使用例  
+ 幅が 200 ピクセルのイメージをレンダリングする方法を次の例に示します。  この [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の例では、属性構文とプロパティ タグ構文はどちらもイメージを定義するために使用されています。  属性およびプロパティの構文については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  <xref:System.Windows.Media.Imaging.BitmapImage> はイメージのソース データを定義するために使用されており、プロパティ タグ構文の例に対して明示的に定義されています。  また、<xref:System.Windows.Media.Imaging.BitmapImage> の <xref:System.Windows.Media.Imaging.BitmapImage.DecodePixelWidth%2A> は、<xref:System.Windows.Controls.Image> の <xref:System.Windows.FrameworkElement.Width%2A> と同じ幅に設定されています。  これは、イメージのレンダリングに使用されるメモリの消費量を最小限に抑えるためです。  
+  
+> [!NOTE]
+>  一般的に、レンダリングされたイメージのサイズを指定する場合は、<xref:System.Windows.FrameworkElement.Width%2A> または <xref:System.Windows.FrameworkElement.Height%2A> の一方のみを指定し、両方は指定しません。  いずれか一方を指定すると、イメージの[縦横比](GTMT)を保つことができます。  両方指定すると、予期しないイメージの拡大やゆがみが発生する場合があります。  イメージの拡大動作を制御するには、<xref:System.Windows.Controls.Image.Stretch%2A> プロパティおよび <xref:System.Windows.Controls.Image.StretchDirection%2A> プロパティを使用します。  
+  
+> [!NOTE]
+>  イメージのサイズを <xref:System.Windows.FrameworkElement.Width%2A> または <xref:System.Windows.FrameworkElement.Height%2A> で指定した場合、<xref:System.Windows.Media.Imaging.BitmapImage.DecodePixelWidth%2A> または <xref:System.Windows.Media.Imaging.BitmapImage.DecodePixelHeight%2A> も同じように対応させて設定する必要があります。  
+  
+ <xref:System.Windows.Controls.Image.Stretch%2A> プロパティは、イメージ ソースを引き伸ばしてイメージ要素を埋める方法を示します。  詳細については、<xref:System.Windows.Media.Stretch> 列挙体の解説を参照してください。  
+  
+ [!code-xml[ImageElementExample_snip#ImageSimpleExampleInlineMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml#imagesimpleexampleinlinemarkup)]  
+  
+## 使用例  
+ コードを使用して幅が 200 ピクセルのイメージをレンダリングする方法を次の例に示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Imaging.BitmapImage> プロパティは、<xref:System.Windows.Media.Imaging.BitmapImage.BeginInit%2A>\/<xref:System.Windows.Media.Imaging.BitmapImage.EndInit%2A> ブロック内で設定する必要があります。  
+  
+ [!code-csharp[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml.cs#imagesimpleexampleinlinecode1)]
+ [!code-vb[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/ImageSimpleExample.xaml.vb#imagesimpleexampleinlinecode1)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-use-triggers-to-style-selected-items-in-a-listview.md b/docs/framework/wpf/controls/how-to-use-triggers-to-style-selected-items-in-a-listview.md
new file mode 100644
index 00000000000..cbf0cff798c
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-use-triggers-to-style-selected-items-in-a-listview.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : トリガーを使用して、ListView で選択された項目のスタイルを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ListView コントロール、スタイル設定"
+ms.assetid: 1e2bdce0-afe8-4507-9b18-f33de43de25a
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : トリガーを使用して、ListView で選択された項目のスタイルを設定する
+定義する方法を示します<xref:System.Windows.Style.Triggers%2A>の<xref:System.Windows.Controls.ListViewItem>コントロールようにプロパティの値のときに、 <xref:System.Windows.Controls.ListViewItem> 、変更、<xref:System.Windows.Style>の<xref:System.Windows.Controls.ListViewItem>応答内の変更。  
+  
+## <a name="example"></a>例  
+ 場合は、<xref:System.Windows.Style>の<xref:System.Windows.Controls.ListViewItem>プロパティの変更に応答を変更するには、定義<xref:System.Windows.Style.Triggers%2A>の<xref:System.Windows.Style>を変更します。  
+  
+ 次の例、<xref:System.Windows.Trigger>が設定された、<xref:System.Windows.Controls.Control.Foreground%2A>プロパティを<xref:System.Windows.Media.Brushes.Blue%2A>し、変更、<xref:System.Windows.FrameworkElement.Cursor%2A>を表示する、<xref:System.Windows.Input.CursorType>ときに、 <xref:System.Windows.UIElement.IsMouseOver%2A>プロパティに対する変更を`true`します。  
+  
+ [!code-xml[ListViewChkBox#ListViewItemTriggersStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#listviewitemtriggersstart)]  
+[!code-xml[ListViewChkBox#Trigger](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#trigger)]  
+[!code-xml[ListViewChkBox#ListViewItemTriggersEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#listviewitemtriggersend)]  
+  
+ 次の例、 <xref:System.Windows.MultiTrigger>が設定された、<xref:System.Windows.Controls.Control.Foreground%2A>のプロパティ、 <xref:System.Windows.Controls.ListViewItem>に<xref:System.Windows.Media.Brushes.Yellow%2A>ときに、 <xref:System.Windows.Controls.ListViewItem>選択した項目は、キーボード フォーカスがあります。  
+  
+ [!code-xml[ListViewChkBox#ListViewItemTriggersStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#listviewitemtriggersstart)]  
+[!code-xml[ListViewChkBox#MultiTrigger](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#multitrigger)]  
+[!code-xml[ListViewChkBox#ListViewItemTriggersEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewChkBox/CS/window1.xaml#listviewitemtriggersend)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.Control>   
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.GridView>   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/how-to-wrap-a-border-around-the-content-of-a-canvas.md b/docs/framework/wpf/controls/how-to-wrap-a-border-around-the-content-of-a-canvas.md
new file mode 100644
index 00000000000..e6dbb19d0b5
--- /dev/null
+++ b/docs/framework/wpf/controls/how-to-wrap-a-border-around-the-content-of-a-canvas.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : Canvas のコンテンツを Border で囲む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Border コントロール, 囲む (Canvas を)"
+  - "Canvas コントロール, 囲む (境界線で)"
+  - "コントロール, 境界"
+  - "コントロール, Canvas"
+ms.assetid: caf0404f-f4e7-484f-9928-5dae1238d8ef
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Canvas のコンテンツを Border で囲む
+この例では、<xref:System.Windows.Controls.Border> を使用して <xref:System.Windows.Controls.Canvas> 要素を囲む方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Canvas> 要素内に "`Hello World!`" を表示する方法を次の例に示します。  <xref:System.Windows.Controls.Canvas> 要素は <xref:System.Windows.Controls.Border> 要素によって、境界線で輪郭を描くように囲まれます。  
+  
+ [!code-xml[CanvasHelloWorldBorder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasHelloWorldBorder/CS/default.xaml#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Canvas>   
+ <xref:System.Windows.Controls.Border>   
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/image-how-to-topics.md b/docs/framework/wpf/controls/image-how-to-topics.md
new file mode 100644
index 00000000000..10914657d97
--- /dev/null
+++ b/docs/framework/wpf/controls/image-how-to-topics.md
@@ -0,0 +1,42 @@
+---
+title: "イメージに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, イメージ"
+  - "Image コントロール"
+ms.assetid: e6e51cf9-8fa1-457e-856b-a5e513bc5caf
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# イメージに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Image> 要素を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [イメージ要素を使用する](../../../../docs/framework/wpf/controls/how-to-use-the-image-element.md)  
+ [イメージをグレースケールに変換する](../../../../docs/framework/wpf/controls/how-to-convert-an-image-to-greyscale.md)  
+ [イメージをトリミングする](../../../../docs/framework/wpf/controls/how-to-crop-an-image.md)  
+ [イメージを回転させる](../../../../docs/framework/wpf/controls/how-to-rotate-an-image.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Image>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapImage>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapSource>  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/image.md b/docs/framework/wpf/controls/image.md
new file mode 100644
index 00000000000..d4e641fb64b
--- /dev/null
+++ b/docs/framework/wpf/controls/image.md
@@ -0,0 +1,39 @@
+---
+title: "イメージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], イメージ"
+  - "Image コントロール [WPF]"
+ms.assetid: 5707e860-ee4a-4c9f-b123-80c64996af19
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# イメージ
+<xref:System.Windows.Controls.Image> 要素は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションでビットマップ イメージを表示するために使用されます。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/image-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Image>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapImage>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapSource>  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/index.md b/docs/framework/wpf/controls/index.md
new file mode 100644
index 00000000000..91a381b8b86
--- /dev/null
+++ b/docs/framework/wpf/controls/index.md
@@ -0,0 +1,114 @@
+---
+title: "コントロール | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], WPF コントロールの概要"
+ms.assetid: 3f255a8a-35a8-4712-9065-472ff7d75599
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# コントロール
+<a name="introduction"></a> [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.Label>、<xref:System.Windows.Controls.TextBox>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.ListBox> など、ほとんどの Windows アプリケーションで使用される共通の UI コンポーネントが多数用意されています。  これまで、こうしたオブジェクトはコントロールと呼ばれてきました。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] SDK では、アプリケーションで表示可能なオブジェクトを表すクラスを広義に意味する用語として "コントロール" を引き続き使用しますが、クラスは、表示可能な部分を持つために <xref:System.Windows.Controls.Control> クラスを継承する必要がないことに注意してください。  <xref:System.Windows.Controls.Control> クラスを継承するクラスには <xref:System.Windows.Controls.ControlTemplate> があります。これを使用すると、コントロールのコンシューマーは、新しいサブクラスを作成することなく、そのコントロールの外観を大幅に変更できます。  このトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] におけるコントロール \(<xref:System.Windows.Controls.Control> クラスを継承するものとそうでないものの両方\) の一般的な使用方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="creating_an_instance_of_a_control"></a>   
+## コントロールのインスタンスの作成  
+ コントロールをアプリケーションに追加するには、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] またはコードを使用します。  次の例は、ユーザーに姓と名の入力を要求する簡単なアプリケーションの作成方法を示しています。  この例では、ラベルが 2 つ、テキスト ボックスが 2 つ、ボタンが 2 つの合計 6 つのコントロールを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で作成しています。  どのコントロールも同様の方法で作成できます。  
+  
+ [!code-xml[ControlsOverview#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/Window1.xaml#1)]  
+  
+ 次の例は、サンプル アプリケーションをコードで作成しています。  簡略化のため、<xref:System.Windows.Controls.Grid> である `grid1` の作成はサンプルでは除外されています。  `grid1` には、前の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例で示されているものと同じ行と列の定義があります。  
+  
+ [!code-csharp[ControlsOverview#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml.cs#2)]
+ [!code-vb[ControlsOverview#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ControlsOverview/VisualBasic/AppInCode.xaml.vb#2)]  
+  
+<a name="changing_the_appearance_of_a_control"></a>   
+## コントロールの外観の変更  
+ コントロールの外観は、アプリケーションの外観に合わせてよく変更されます。  コントロールの外観を変更するには、目的に応じて次のいずれかを行います。  
+  
+-   コントロールのプロパティの値を変更します。  
+  
+-   コントロールに <xref:System.Windows.Style> を作成します。  
+  
+-   コントロールに新しい <xref:System.Windows.Controls.ControlTemplate> を作成します。  
+  
+### コントロールのプロパティ値の変更  
+ 多くのコントロールには、コントロールの外観を変更するためのプロパティが用意されています。たとえば、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> がそれに該当します。  値プロパティは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でもコードでも設定できます。  次の例では、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A>、<xref:System.Windows.Controls.Control.FontSize%2A>、<xref:System.Windows.Controls.Control.FontWeight%2A> の各プロパティを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で設定しています。  
+  
+ [!code-xml[ControlsOverview#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml#3)]  
+  
+ 次の例では、同じプロパティをコードで設定しています。  
+  
+ [!code-csharp[ControlsOverview#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml.cs#4)]
+ [!code-vb[ControlsOverview#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ControlsOverview/VisualBasic/AppInCode.xaml.vb#4)]  
+  
+### コントロールのスタイルの作成  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、アプリケーションの各インスタンスにプロパティを設定するのではなく、<xref:System.Windows.Style> を作成することによって、すべてのコントロールの外観を指定する機能が用意されています。  次の例は、アプリケーションの各 <xref:System.Windows.Controls.Button> に適用される <xref:System.Windows.Style> を作成しています。<xref:System.Windows.Style> 定義は、通常、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では <xref:System.Windows.ResourceDictionary> に定義されます。たとえば、<xref:System.Windows.FrameworkElement> の <xref:System.Windows.FrameworkElement.Resources%2A> プロパティがそれに該当します。  
+  
+ [!code-xml[ControlsOverview#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml#5)]  
+  
+ キーをスタイルに割り当て、そのキーをコントロールの `Style` プロパティに指定することで、特定の種類のコントロールのみにスタイルを適用できます。  スタイルの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+### ControlTemplate の作成  
+ <xref:System.Windows.Style> を使用すると複数のコントロールのプロパティを一度に設定できますが、<xref:System.Windows.Style> の作成だけでは <xref:System.Windows.Controls.Control> の外観を十分にカスタマイズできない場合も考えられます。  <xref:System.Windows.Controls.Control> クラスを継承するクラスには <xref:System.Windows.Controls.ControlTemplate> があり、これで <xref:System.Windows.Controls.Control> の構造と外観が定義されます。  <xref:System.Windows.Controls.Control> の <xref:System.Windows.Controls.Control.Template%2A> プロパティはパブリックであるため、<xref:System.Windows.Controls.Control> に既定とは異なる <xref:System.Windows.Controls.ControlTemplate> スタイルを与えることができます。  一般的に、<xref:System.Windows.Controls.Control> の外観をカスタマイズするには、コントロールを継承するのではなく、<xref:System.Windows.Controls.Control> に新しい <xref:System.Windows.Controls.ControlTemplate> を指定します。  
+  
+ 非常によく使用される <xref:System.Windows.Controls.Button> というコントロールについて考えてみます。  <xref:System.Windows.Controls.Button> の主な動作は、ユーザーがそれをクリックしたときにアプリケーションが一定のアクションを実行できるようにすることです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Controls.Button> は既定で浮き出し表示の四角形で表されます。  アプリケーションを開発しているとき、<xref:System.Windows.Controls.Button> の動作 \(ボタンのクリック イベントの処理\) は利用しつつ、ボタンのプロパティの変更だけではできないボタンの外観の変更を行うことにしたとします。  このような場合は、新しい <xref:System.Windows.Controls.ControlTemplate> オブジェクトを作成します。  
+  
+ 次の例は、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ControlTemplate> を作成しています。  この <xref:System.Windows.Controls.ControlTemplate> は、角が丸くて背景がグラデーションになっている <xref:System.Windows.Controls.Button> を作成します。  この <xref:System.Windows.Controls.ControlTemplate> には、<xref:System.Windows.Controls.Border.Background%2A> が 2 つの <xref:System.Windows.Media.GradientStop> オブジェクトを持つ <xref:System.Windows.Media.LinearGradientBrush> である <xref:System.Windows.Controls.Border> が含まれています。  最初の <xref:System.Windows.Media.GradientStop> ではデータ バインディングを使用して、<xref:System.Windows.Media.GradientStop> の <xref:System.Windows.Media.GradientStop.Color%2A> をボタンの背景の色にバインドしています。  <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> プロパティを設定すると、その値の色が最初の <xref:System.Windows.Media.GradientStop> として使用されます。  データ バインディングの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  この例はまた、<xref:System.Windows.Controls.Primitives.ButtonBase.IsPressed%2A> が `true` のときに <xref:System.Windows.Controls.Button> の外観を変更する <xref:System.Windows.Trigger> を作成しています。  
+  
+ [!code-xml[ControlsOverview#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/Window1.xaml#6)]  
+[!code-xml[ControlsOverview#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml#7)]  
+  
+> [!NOTE]
+>  この例が正常に動作するには、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> が <xref:System.Windows.Media.SolidColorBrush> に設定される必要があります。  
+  
+<a name="subscribing_to_events"></a>   
+## イベントのサブスクライブ  
+ コントロールのイベントをサブスクライブするには、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] またはコードを使用できますが、コードではイベントの処理しかできません。  次の例は、<xref:System.Windows.Controls.Button> の `Click` イベントのサブスクライブ方法を示しています。  
+  
+ [!code-xml[ControlsOverview#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/Window1.xaml#10)]  
+  
+ [!code-csharp[ControlsOverview#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml.cs#8)]
+ [!code-vb[ControlsOverview#8](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ControlsOverview/VisualBasic/AppInCode.xaml.vb#8)]  
+  
+ 次の例は、<xref:System.Windows.Controls.Button> の `Click` イベントを処理しています。  
+  
+ [!code-csharp[ControlsOverview#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlsOverview/CSharp/AppInCode.xaml.cs#9)]
+ [!code-vb[ControlsOverview#9](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ControlsOverview/VisualBasic/AppInCode.xaml.vb#9)]  
+  
+<a name="rich_content_in_controls"></a>   
+## コントロールでのリッチ コンテンツ  
+ <xref:System.Windows.Controls.Control> クラスを継承するほとんどのクラスに、リッチ コンテンツを格納する機能があります。  たとえば、<xref:System.Windows.Controls.Label> には、文字列、<xref:System.Windows.Controls.Image>、<xref:System.Windows.Controls.Panel> など、任意のオブジェクトを格納できます。  次のクラスは、リッチ コンテンツをサポートしており、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に含まれているほとんどのコントロールの基本クラスとして機能します。  
+  
+-   <xref:System.Windows.Controls.ContentControl>\-\- このクラスを継承するクラスには、<xref:System.Windows.Controls.Label>、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.ToolTip> などがあります。  
+  
+-   <xref:System.Windows.Controls.ItemsControl>\-\- このクラスを継承するクラスには、<xref:System.Windows.Controls.ListBox>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.Primitives.StatusBar> などがあります。  
+  
+-   <xref:System.Windows.Controls.HeaderedContentControl>\-\- このクラスを継承するクラスには、<xref:System.Windows.Controls.TabItem>、<xref:System.Windows.Controls.GroupBox>、<xref:System.Windows.Controls.Expander> などがあります。  
+  
+-   <xref:System.Windows.Controls.HeaderedItemsControl>\-\- このクラスを継承するクラスには、<xref:System.Windows.Controls.MenuItem>、<xref:System.Windows.Controls.TreeViewItem>、<xref:System.Windows.Controls.ToolBar> などがあります。  
+  
+ これらの基本クラスの詳細については、「[WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)」を参照してください。  
+  
+## 参照  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [カテゴリ別のコントロール](../../../../docs/framework/wpf/controls/controls-by-category.md)   
+ [コントロール ライブラリ](../../../../docs/framework/wpf/controls/control-library.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [入力](../../../../docs/framework/wpf/advanced/input-wpf.md)   
+ [コマンドを有効にする](../../../../docs/framework/wpf/advanced/how-to-enable-a-command.md)   
+ [チュートリアル : カスタム アニメーション ボタンの作成](../../../../docs/framework/wpf/controls/walkthroughs-create-a-custom-animated-button.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/label-styles-and-templates.md b/docs/framework/wpf/controls/label-styles-and-templates.md
new file mode 100644
index 00000000000..bcb9030d6f4
--- /dev/null
+++ b/docs/framework/wpf/controls/label-styles-and-templates.md
@@ -0,0 +1,59 @@
+---
+title: "ラベルのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ラベル"
+  - "Label [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], ラベル"
+  - "状態 [WPF], ラベル"
+  - "スタイル [WPF], ラベル"
+  - "テンプレート [WPF], ラベル"
+ms.assetid: c1d5359a-8e4a-4925-ab3e-e92bf6694859
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# ラベルのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Label> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Label のパーツ  
+ <xref:System.Windows.Controls.Label> コントロールには、名前付きのパーツは存在しません。  
+  
+## Label の状態  
+ 次の表は、<xref:System.Windows.Controls.Label> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Label ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Label> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Label](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/label.xaml#label)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> は、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/label.md b/docs/framework/wpf/controls/label.md
new file mode 100644
index 00000000000..f7f0c3b9902
--- /dev/null
+++ b/docs/framework/wpf/controls/label.md
@@ -0,0 +1,37 @@
+---
+title: "ラベル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ラベル"
+  - "Label コントロール [WPF]"
+ms.assetid: 241c1ce2-60f8-4613-a0ec-9b9bb25fb6af
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# ラベル
+通常、<xref:System.Windows.Controls.Label> コントロールは [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] で情報を提供します。  過去には <xref:System.Windows.Controls.Label> に含まれるのはテキストだけでしたが、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] に付属する <xref:System.Windows.Controls.Label> は <xref:System.Windows.Controls.ContentControl> であることから、テキストまたは <xref:System.Windows.UIElement> を含むことができます。  
+  
+ <xref:System.Windows.Controls.Label> は、アクセス キーに対する機能上のサポートと表示上のサポートの両方を提供します。  <xref:System.Windows.Controls.TextBox> などのコントロールに対するすばやいキーボード アクセスを実現するために頻繁に使用されます。  <xref:System.Windows.Controls.Label> を <xref:System.Windows.Controls.Control> に割り当てるには、<xref:System.Windows.Controls.Label.Target%2A?displayProperty=fullName> プロパティを、ユーザーがアクセス キーを押したときにフォーカスを取得するコントロールに設定します。  
+  
+ 次のイメージは、<xref:System.Windows.Controls.ComboBox> を表示対象とする <xref:System.Windows.Controls.Label> "テーマ" を示しています。  ユーザーがキーを押した場合、<xref:System.Windows.Controls.ComboBox> はフォーカスを受け取ります。  詳細については、「[How to: Set the Target Property of a Label](http://msdn.microsoft.com/ja-jp/b24c6977-ebcb-4855-a9bb-3fd4435af8f8)」を参照してください。  
+  
+ ![画面のプロパティは、使用法別にラベル付きで表示されます](../../../../docs/framework/wpf/controls/media/labeledby.JPG "LabeledBy")  
+  
+## このセクションの内容  
+ [How to: Set the Target Property of a Label](http://msdn.microsoft.com/ja-jp/b24c6977-ebcb-4855-a9bb-3fd4435af8f8)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Label>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listbox-how-to-topics.md b/docs/framework/wpf/controls/listbox-how-to-topics.md
new file mode 100644
index 00000000000..662d999006a
--- /dev/null
+++ b/docs/framework/wpf/controls/listbox-how-to-topics.md
@@ -0,0 +1,38 @@
+---
+title: "ListBox に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ListBox"
+  - "ListBox コントロール [WPF], 方法トピック"
+ms.assetid: 15d58f1d-3db6-4cb5-88c7-8c45f19301e2
+caps.latest.revision: 67
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 67
+---
+# ListBox に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.ListBox> コントロールを使用して選択可能な項目の一覧を表示する方法について説明します。  
+  
+## このセクションの内容  
+ [ListBox にデータをバインドする](../../../../docs/framework/wpf/controls/how-to-bind-a-listbox-to-data.md)  
+ [ListBoxItem を取得する](../../../../docs/framework/wpf/controls/how-to-get-a-listboxitem.md)  
+ [How to: Add Data to an ItemsControl](http://msdn.microsoft.com/ja-jp/271e52ce-0f44-4b1f-a7da-0bc72bd9ed65)  
+ [ListBox のスクロール速度を向上させる](../../../../docs/framework/wpf/controls/how-to-improve-the-scrolling-performance-of-a-listbox.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ListBox>  
+  
+ <xref:System.Windows.Controls.ListBoxItem>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listbox-styles-and-templates.md b/docs/framework/wpf/controls/listbox-styles-and-templates.md
new file mode 100644
index 00000000000..697d1ff9b6e
--- /dev/null
+++ b/docs/framework/wpf/controls/listbox-styles-and-templates.md
@@ -0,0 +1,82 @@
+---
+title: "ListBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ListBox"
+  - "ListBox [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], ListBox"
+  - "状態 [WPF], ListBox"
+  - "スタイル [WPF], ListBox"
+  - "テンプレート [WPF], ListBox"
+ms.assetid: fc5764cb-c27b-495b-88d4-d969a8213ccb
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# ListBox のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ListBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ListBox のパーツ  
+ <xref:System.Windows.Controls.ListBox> コントロールには、名前付きのパーツは存在しません。  
+  
+ <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ControlTemplate> を作成する際には、テンプレートの <xref:System.Windows.Controls.ScrollViewer> に <xref:System.Windows.Controls.ItemsPresenter> を含めることができます。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.ListBox> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## ListBox の状態  
+ 次の表は、<xref:System.Windows.Controls.ListBox> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|コントロールが有効です。|  
+|InvalidFocused|ValidationStates|コントロールは有効ではありませんが、フォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|コントロールは有効ではなく、フォーカスはありません。|  
+  
+## ListBoxItem のパーツ  
+ <xref:System.Windows.Controls.ListBoxItem> コントロールには、名前付きのパーツは存在しません。  
+  
+## ListBoxItem の状態  
+ 次の表は、<xref:System.Windows.Controls.ListBox> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|項目が無効です。|  
+|Focused|FocusStates|項目にフォーカスがあります。|  
+|Unfocused|FocusStates|項目にフォーカスがありません。|  
+|Unselected|SelectionStates|項目は選択されています。|  
+|Selected|SelectionStates|項目は選択されていません。|  
+|SelectedUnfocused|SelectionStates|項目は選択されていますが、フォーカスはありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ListBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ListBox> コントロールと <xref:System.Windows.Controls.ListBoxItem> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ListBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/listbox.xaml#listbox)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listbox.md b/docs/framework/wpf/controls/listbox.md
new file mode 100644
index 00000000000..940e8ba60e3
--- /dev/null
+++ b/docs/framework/wpf/controls/listbox.md
@@ -0,0 +1,39 @@
+---
+title: "ListBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ListBox"
+  - "ListBox コントロール [WPF]"
+ms.assetid: b91bb352-4f51-44e0-9017-a041f216c852
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# ListBox
+<xref:System.Windows.Controls.ListBox> コントロールは、ユーザーに選択可能な項目の一覧を提供します。  
+  
+ 一般的な <xref:System.Windows.Controls.ListBox> を次の図に示します。  
+  
+ ![ListBox スクリーンショット](../../../../docs/framework/wpf/controls/media/ss-ctl-listbox.png "SS\_CTL\_listbox")  
+一般的な ListBox  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/listbox-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ListBox>  
+ <xref:System.Windows.Controls.ListBoxItem>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listview-how-to-topics.md b/docs/framework/wpf/controls/listview-how-to-topics.md
new file mode 100644
index 00000000000..d6e2ae67678
--- /dev/null
+++ b/docs/framework/wpf/controls/listview-how-to-topics.md
@@ -0,0 +1,49 @@
+---
+title: "ListView に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ListView"
+  - "ListView コントロール [WPF], 方法トピック"
+ms.assetid: aafce40c-9bfe-45ec-86a3-599616a11276
+caps.latest.revision: 68
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 68
+---
+# ListView に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.ListView> コントロールを使用してデータ項目のセットを表示する方法について説明します。  
+  
+## このセクションの内容  
+ [ヘッダーがクリックされたときに GridView 列を並べ替える](../../../../docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md)  
+ [ListView のカスタム表示モードを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md)  
+ [テンプレートを使用して、GridView を使用する ListView のスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-use-templates-to-style-a-listview-that-uses-gridview.md)  
+ [ドラッグされた GridView 列ヘッダーのスタイルを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-style-for-a-dragged-gridview-column-header.md)  
+ [GridView を使用して ListView コンテンツを表示する](../../../../docs/framework/wpf/controls/how-to-display-listview-contents-by-using-a-gridview.md)  
+ [トリガーを使用して、ListView で選択された項目のスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-use-triggers-to-style-selected-items-in-a-listview.md)  
+ [CheckBox を持つ ListViewItem を作成する](../../../../docs/framework/wpf/controls/how-to-create-listviewitems-with-a-checkbox.md)  
+ [GridViewRowPresenter を使用してデータを表示する](../../../../docs/framework/wpf/controls/how-to-display-data-by-using-gridviewrowpresenter.md)  
+ [GridView を実装する ListView の項目をグループ化する](../../../../docs/framework/wpf/controls/how-to-group-items-in-a-listview-that-implements-a-gridview.md)  
+ [GridView を実装する ListView で行のスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-style-a-row-in-a-listview-that-implements-a-gridview.md)  
+ [ListView の列の水平方向の配置を変更する](../../../../docs/framework/wpf/controls/how-to-change-the-horizontal-alignment-of-a-column-in-a-listview.md)  
+ [ListView の各項目の MouseDoubleClick イベントを処理する](../../../../docs/framework/wpf/controls/how-to-handle-the-mousedoubleclick-event-for-each-item-in-a-listview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ListView>  
+  
+ <xref:System.Windows.Controls.ListViewItem>  
+  
+ <xref:System.Windows.Controls.GridView>  
+  
+## 関連項目  
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listview-overview.md b/docs/framework/wpf/controls/listview-overview.md
new file mode 100644
index 00000000000..1b3d9cadce1
--- /dev/null
+++ b/docs/framework/wpf/controls/listview-overview.md
@@ -0,0 +1,98 @@
+---
+title: "ListView の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ListView"
+  - "ListView コントロール [WPF], ListView コントロールの概要"
+ms.assetid: 989e12b0-260e-4570-95c6-489284003ce2
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ListView の概要
+<xref:System.Windows.Controls.ListView> コントロールは、一連のデータ項目を異なるレイアウトまたはビューで表示するためのインフラストラクチャを提供します。  たとえば、データ項目をテーブルで表示し、さらに列の並べ替えも行う場合です。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="WhatisaListView"></a>   
+## ListView とは  
+ <xref:System.Windows.Controls.ListView> コントロールは、<xref:System.Windows.Controls.ListBox> から派生した <xref:System.Windows.Controls.ItemsControl> です。  通常、その項目はデータ コレクションのメンバーであり、<xref:System.Windows.Controls.ListViewItem> オブジェクトとして表されます。  <xref:System.Windows.Controls.ListViewItem> は <xref:System.Windows.Controls.ContentControl> であり、格納できる子要素は 1 つだけです。  ただし、その子要素はどのようなビジュアル要素でもかまいません。  
+  
+<a name="DefiningaListViewView"></a>   
+## ListView の表示モードの定義  
+ <xref:System.Windows.Controls.ListView> コントロールのコンテンツの表示モードを指定するには、<xref:System.Windows.Controls.ListView.View%2A> プロパティを設定します。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] に用意されている表示モードの 1 つに <xref:System.Windows.Controls.GridView> があります。このモードでは、カスタマイズ可能な列を持つテーブルにデータ項目のコレクションが表示されます。  
+  
+ 従業員情報を表示する <xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.GridView> を定義する方法を次の例に示します。  
+  
+ [!code-xml[ListViewCode#ListViewEmployee](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml#listviewemployee)]  
+  
+ 次の図は、前の例でデータがどのように表示されるのかを示したものです。  
+  
+ ![GridView 出力を含む ListView](../../../../docs/framework/wpf/controls/media/listviewgridview.png "ListViewGridView")  
+  
+ <xref:System.Windows.Controls.ViewBase> クラスを継承するクラスを定義することで、カスタム表示モードを作成できます。  <xref:System.Windows.Controls.ViewBase> クラスは、カスタム ビューを作成するために必要なインフラストラクチャを提供します。  カスタム ビューの作成方法の詳細については、「[ListView のカスタム表示モードを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-custom-view-mode-for-a-listview.md)」を参照してください。  
+  
+<a name="BindingDatatoaListView"></a>   
+## ListView へのデータのバインド  
+ <xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティと <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを使用して、<xref:System.Windows.Controls.ListView> コントロールの項目を指定します。  次の例では、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを `EmployeeInfoDataSource` という名前のデータ コレクションに設定します。  
+  
+ [!code-xml[ListViewCode#ItemsSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml#itemssource)]  
+  
+ <xref:System.Windows.Controls.GridView> では、<xref:System.Windows.Controls.GridViewColumn> オブジェクトが指定したデータ フィールドにバインドされます。  次の例では、<xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> プロパティに <xref:System.Windows.Data.Binding> を指定することで、<xref:System.Windows.Controls.GridViewColumn> オブジェクトをデータ フィールドにバインドします。  
+  
+ [!code-csharp[ListViewCode#GridViewColumnProperties](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml.cs#gridviewcolumnproperties)]
+ [!code-vb[ListViewCode#GridViewColumnProperties](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListViewCode/visualbasic/window1.xaml.vb#gridviewcolumnproperties)]
+ [!code-xml[ListViewCode#GridViewColumnProperties](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewCode/CSharp/Window1.xaml#gridviewcolumnproperties)]  
+  
+ また、列のセルにスタイルを設定するために使用する <xref:System.Windows.DataTemplate> 定義の一部として、<xref:System.Windows.Data.Binding> を指定することもできます。  次の例では、<xref:System.Windows.ResourceKey> で識別される <xref:System.Windows.DataTemplate> で、<xref:System.Windows.Controls.GridViewColumn> に <xref:System.Windows.Data.Binding> を設定します。  この例では、<xref:System.Windows.Controls.GridViewColumn.DisplayMemberBinding%2A> を定義していないことに注意してください。これを定義すると、<xref:System.Windows.DataTemplate> によって指定されているバインディングがオーバーライドされます。  
+  
+ [!code-xml[ListViewTemplate#GridViewCellTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#gridviewcelltemplate)]  
+  
+ [!code-xml[ListViewTemplate#CellTemplateProperty](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListViewTemplate/CS/window1.xaml#celltemplateproperty)]  
+  
+<a name="StylingaListView"></a>   
+## GridView を実装する ListView へのスタイルの設定  
+ <xref:System.Windows.Controls.ListView> コントロールに含まれる <xref:System.Windows.Controls.ListViewItem> オブジェクトは、表示されるデータ項目を表します。  次のプロパティを使用して、データ項目のコンテンツとスタイルを定義できます。  
+  
+-   <xref:System.Windows.Controls.ListView> コントロールでは、<xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>、<xref:System.Windows.Controls.ItemsControl.ItemTemplateSelector%2A>、および <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> プロパティを使用します。  
+  
+-   <xref:System.Windows.Controls.ListViewItem> コントロールでは、<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A> および <xref:System.Windows.Controls.ContentControl.ContentTemplateSelector%2A> プロパティを使用します。  
+  
+ <xref:System.Windows.Controls.GridView> におけるセル間の配置の問題を回避するため、<xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> を使用して <xref:System.Windows.Controls.ListView> の項目の幅に影響を与えるプロパティやコンテンツを設定または追加しないようにしてください。  たとえば、<xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> で <xref:System.Windows.FrameworkElement.Margin%2A> プロパティを設定すると、配置の問題が発生する可能性があります。  <xref:System.Windows.Controls.GridView> 内の項目の幅に影響を与えるプロパティやコンテンツを指定または定義するには、<xref:System.Windows.Controls.GridView> クラスのプロパティ、およびそれに関連するクラス \(<xref:System.Windows.Controls.GridViewColumn> など\) を使用してください。  
+  
+ <xref:System.Windows.Controls.GridView> およびそのサポート クラスの使用方法について、詳しくは「[GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A> を定義し、さらに <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> も定義する場合、<xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> が正しく動作するには、スタイルに <xref:System.Windows.Controls.ContentPresenter> を含める必要があります。  
+  
+ <xref:System.Windows.Controls.GridView> を使用して表示する <xref:System.Windows.Controls.ListView> のコンテンツには、<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A> および <xref:System.Windows.Controls.Control.VerticalContentAlignment%2A> プロパティを使用しないでください。  <xref:System.Windows.Controls.GridView> の列のコンテンツの配置を指定するには、<xref:System.Windows.Controls.GridViewColumn.CellTemplate%2A> を定義します。  
+  
+<a name="UsingtheSameViewMoreThanOnce"></a>   
+## 同じ表示モードの共有  
+ 2 つの <xref:System.Windows.Controls.ListView> コントロールが同じ表示モードを同時に共有することはできません。  複数の <xref:System.Windows.Controls.ListView> コントロールで同じ表示モードを使用しようとすると、例外が発生します。  
+  
+ 複数の <xref:System.Windows.Controls.ListView> で同時に使用できる表示モードを指定するには、テンプレートまたはスタイルを使用します。  <xref:System.Windows.FrameworkElement.Resources%2A> としてビューを定義する方法の例については、[複数のビューを持つ ListView のサンプル](http://go.microsoft.com/fwlink/?LinkID=160013)を参照してください。  
+  
+<a name="CreatingaCustomView"></a>   
+## カスタム表示モードの作成  
+ <xref:System.Windows.Controls.GridView> のようなカスタマイズされたビューは、<xref:System.Windows.Controls.ViewBase> 抽象クラスから派生します。この抽象クラスは、<xref:System.Windows.Controls.ListViewItem> オブジェクトとして表されるデータ項目を表示するためのツールを提供します。  
+  
+ カスタム表示モードの例については、[複数のビューを持つ ListView のサンプル](http://go.microsoft.com/fwlink/?LinkID=160013)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.GridView>   
+ <xref:System.Windows.Controls.ListView>   
+ <xref:System.Windows.Controls.ListViewItem>   
+ <xref:System.Windows.Data.Binding>   
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)   
+ [コントロール](../../../../docs/framework/wpf/advanced/optimizing-performance-controls.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listview-overviews.md b/docs/framework/wpf/controls/listview-overviews.md
new file mode 100644
index 00000000000..db098d9386d
--- /dev/null
+++ b/docs/framework/wpf/controls/listview-overviews.md
@@ -0,0 +1,38 @@
+---
+title: "ListView の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ListView"
+  - "ListView コントロール [WPF], 使用"
+ms.assetid: 49dfef1a-dddf-4fc6-a511-6d5f925a4781
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ListView の概要
+このセクションのトピックでは、<xref:System.Windows.Controls.ListView> コントロールを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [ListView の概要](../../../../docs/framework/wpf/controls/listview-overview.md)  
+ [GridView の概要](../../../../docs/framework/wpf/controls/gridview-overview.md)  
+ [GridView の列ヘッダー スタイルおｙびテンプレートの概要](../../../../docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ListView>  
+  
+ <xref:System.Windows.Controls.GridView>  
+  
+## 関連項目  
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listview-styles-and-templates.md b/docs/framework/wpf/controls/listview-styles-and-templates.md
new file mode 100644
index 00000000000..b98c9c77e39
--- /dev/null
+++ b/docs/framework/wpf/controls/listview-styles-and-templates.md
@@ -0,0 +1,82 @@
+---
+title: "ListView のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ListView"
+  - "ListView [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], ListView"
+  - "状態 [WPF], ListView"
+  - "スタイル [WPF], ListView"
+  - "テンプレート [WPF], ListView"
+ms.assetid: d2387356-2171-4785-822a-7247e024b4ee
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ListView のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ListView> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ListView のパーツ  
+ <xref:System.Windows.Controls.ListView> コントロールには、名前付きのパーツは存在しません。  
+  
+ <xref:System.Windows.Controls.ListView> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.ListView> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## ListView の状態  
+ 次の表は、<xref:System.Windows.Controls.ListView> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ListViewItem のパーツ  
+ <xref:System.Windows.Controls.ListViewItem> コントロールには、名前付きのパーツは存在しません。  
+  
+## ListViewItem の状態  
+ 次の表は、<xref:System.Windows.Controls.ListViewItem> コントロールの状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|MouseOver|CommonStates|<xref:System.Windows.Controls.ComboBox> コントロール上にマウス ポインターがあります。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Selected|SelectionStates|項目は選択されています。|  
+|Unselected|SelectionStates|項目は選択されていません。|  
+|SelectedUnfocused|SelectionStates|項目は選択されていますが、フォーカスはありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ListView ControlTemplate の例  
+ <xref:System.Windows.Controls.ListView> コントロールの <xref:System.Windows.Controls.ControlTemplate> およびその関連付けられた型を定義する方法を次の例に示します。  
+  
+ [!code-xml[ControlTemplateExamples#ListView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/listview.xaml#listview)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> の例では、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/listview.md b/docs/framework/wpf/controls/listview.md
new file mode 100644
index 00000000000..6764f2bdf9b
--- /dev/null
+++ b/docs/framework/wpf/controls/listview.md
@@ -0,0 +1,42 @@
+---
+title: "ListView | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ListView"
+  - "ListView コントロール [WPF]"
+ms.assetid: fc3784a7-c9e8-4e2b-909a-7af37cef9b43
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# ListView
+<xref:System.Windows.Controls.ListView> コントロールは、一連のデータ項目を異なるレイアウトまたはビューで表示するためのインフラストラクチャを提供します。  
+  
+ 次の図は、<xref:System.Windows.Controls.ListView> を示しています。  
+  
+ ![GridView 出力を含む ListView](../../../../docs/framework/wpf/controls/media/listviewgridview.png "ListViewGridView")  
+  
+## このセクションの内容  
+ [概要](../../../../docs/framework/wpf/controls/listview-overviews.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/listview-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ListView>  
+ <xref:System.Windows.Controls.ListViewItem>  
+ <xref:System.Windows.Controls.GridView>  
+  
+## 関連項目  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)  
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/manipulate-columns-and-rows-by-using-columndefinitionscollections.md b/docs/framework/wpf/controls/manipulate-columns-and-rows-by-using-columndefinitionscollections.md
new file mode 100644
index 00000000000..d97381dcf63
--- /dev/null
+++ b/docs/framework/wpf/controls/manipulate-columns-and-rows-by-using-columndefinitionscollections.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : ColumnDefinitionsCollections および RowDefinitionsCollections を使用して列と行を操作する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, ColumnDefinitionCollection"
+  - "クラス, RowDefinitionCollection"
+  - "ColumnDefinitionCollection クラス"
+  - "コントロール, Grid クラス"
+  - "グリッド コントロール, ColumnDefinitionCollection クラス"
+  - "グリッド コントロール, RowDefinitionCollection クラス"
+  - "RowDefinitionCollection クラス"
+ms.assetid: bfc7160a-45f2-4e17-9961-df414dfb13c5
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ColumnDefinitionsCollections および RowDefinitionsCollections を使用して列と行を操作する
+この例では、<xref:System.Windows.Controls.ColumnDefinitionCollection> クラスと <xref:System.Windows.Controls.RowDefinitionCollection> クラスのメソッドを使用して、行や列のコンテンツの追加、クリア、カウントなどのアクションを実行する方法を示します。  たとえば、<xref:System.Windows.Controls.ColumnDefinition> または <xref:System.Windows.Controls.RowDefinition> に含まれる項目について、<xref:System.Windows.Controls.ColumnDefinitionCollection.Add%2A>、<xref:System.Windows.Controls.ColumnDefinitionCollection.Clear%2A>、または <xref:System.Windows.Controls.ColumnDefinitionCollection.Count%2A> を実行できます。  
+  
+## 使用例  
+ <xref:System.Windows.FrameworkElement.Name%2A> が `grid1` に設定された <xref:System.Windows.Controls.Grid> 要素を作成する例を次に示します。  この <xref:System.Windows.Controls.Grid> は、それぞれ別のコレクション メソッドによって制御される <xref:System.Windows.Controls.Button> 要素を持つ <xref:System.Windows.Controls.StackPanel> を含みます。  <xref:System.Windows.Controls.Button> をクリックすると、分離コード ファイルのメソッド呼び出しをアクティブ化します。  
+  
+ [!code-xml[ColumnDefinitionsGrid#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ColumnDefinitionsGrid/CSharp/Window1.xaml#1)]  
+  
+ この例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイルの各 <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントに対応する一連のカスタム メソッドを定義します。  <xref:System.Windows.Controls.Grid> 内の列と行の数を、追加や削除、行と列の合計数をカウントするなどの方法で変更できます。  <xref:System.ArgumentOutOfRangeException> 例外および <xref:System.ArgumentException> 例外を回避するために、<xref:System.Windows.Controls.ColumnDefinitionCollection.RemoveRange%2A> メソッドの提供するエラー チェック機能を使用できます。  
+  
+ [!code-csharp[ColumnDefinitionsGrid#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ColumnDefinitionsGrid/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[ColumnDefinitionsGrid#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ColumnDefinitionsGrid/VisualBasic/Window1.xaml.vb#2)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Grid>   
+ <xref:System.Windows.Controls.ColumnDefinitionCollection>   
+ <xref:System.Windows.Controls.RowDefinitionCollection>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/media/adornedtextbox.png b/docs/framework/wpf/controls/media/adornedtextbox.png
new file mode 100644
index 00000000000..9c82407f5a0
Binary files /dev/null and b/docs/framework/wpf/controls/media/adornedtextbox.png differ
diff --git a/docs/framework/wpf/controls/media/bulletdecorator.png b/docs/framework/wpf/controls/media/bulletdecorator.png
new file mode 100644
index 00000000000..0cc7ba2d442
Binary files /dev/null and b/docs/framework/wpf/controls/media/bulletdecorator.png differ
diff --git a/docs/framework/wpf/controls/media/controlcontentmodelimagetextinto.PNG b/docs/framework/wpf/controls/media/controlcontentmodelimagetextinto.PNG
new file mode 100644
index 00000000000..f0affe878d2
Binary files /dev/null and b/docs/framework/wpf/controls/media/controlcontentmodelimagetextinto.PNG differ
diff --git a/docs/framework/wpf/controls/media/controlcontentmodellistbox2.PNG b/docs/framework/wpf/controls/media/controlcontentmodellistbox2.PNG
new file mode 100644
index 00000000000..b5d2c0d3596
Binary files /dev/null and b/docs/framework/wpf/controls/media/controlcontentmodellistbox2.PNG differ
diff --git a/docs/framework/wpf/controls/media/controlcontentmodelteabitem.PNG b/docs/framework/wpf/controls/media/controlcontentmodelteabitem.PNG
new file mode 100644
index 00000000000..84a8fcec053
Binary files /dev/null and b/docs/framework/wpf/controls/media/controlcontentmodelteabitem.PNG differ
diff --git a/docs/framework/wpf/controls/media/custom-button-animatedbutton-4.gif b/docs/framework/wpf/controls/media/custom-button-animatedbutton-4.gif
new file mode 100644
index 00000000000..69a40a2f70f
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-animatedbutton-4.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-changebackground.png b/docs/framework/wpf/controls/media/custom-button-blend-changebackground.png
new file mode 100644
index 00000000000..869d2a2fd8d
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-changebackground.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-changerectproperties.png b/docs/framework/wpf/controls/media/custom-button-blend-changerectproperties.png
new file mode 100644
index 00000000000..4cb0c85bcc4
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-changerectproperties.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-clickeventtrigger1.png b/docs/framework/wpf/controls/media/custom-button-blend-clickeventtrigger1.png
new file mode 100644
index 00000000000..7f2be6f5de6
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-clickeventtrigger1.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-createmultiplebuttons.png b/docs/framework/wpf/controls/media/custom-button-blend-createmultiplebuttons.png
new file mode 100644
index 00000000000..2def789de62
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-createmultiplebuttons.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-drawrect.png b/docs/framework/wpf/controls/media/custom-button-blend-drawrect.png
new file mode 100644
index 00000000000..d2b4faa9aec
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-drawrect.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-edittemplate.jpg b/docs/framework/wpf/controls/media/custom-button-blend-edittemplate.jpg
new file mode 100644
index 00000000000..4a98b0b1cbe
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-edittemplate.jpg differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-glasscubeappearance.gif b/docs/framework/wpf/controls/media/custom-button-blend-glasscubeappearance.gif
new file mode 100644
index 00000000000..c937150e85f
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-glasscubeappearance.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties1.png b/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties1.png
new file mode 100644
index 00000000000..368d98c0190
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties1.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties2.png b/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties2.png
new file mode 100644
index 00000000000..f9a6cac8fa1
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties2.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-innerrectangle2.png b/docs/framework/wpf/controls/media/custom-button-blend-innerrectangle2.png
new file mode 100644
index 00000000000..646e78648fc
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-innerrectangle2.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-innerrectangleproperties.png b/docs/framework/wpf/controls/media/custom-button-blend-innerrectangleproperties.png
new file mode 100644
index 00000000000..20d417154aa
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-innerrectangleproperties.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger.png b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger.png
new file mode 100644
index 00000000000..d91e8adcf72
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger2.gif b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger2.gif
new file mode 100644
index 00000000000..1ad9da3068e
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger2.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger3.png b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger3.png
new file mode 100644
index 00000000000..dc1e4fcd1ef
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger3.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-makebutton.png b/docs/framework/wpf/controls/media/custom-button-blend-makebutton.png
new file mode 100644
index 00000000000..058514dc088
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-makebutton.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-makebutton2.gif b/docs/framework/wpf/controls/media/custom-button-blend-makebutton2.gif
new file mode 100644
index 00000000000..1928866815b
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-makebutton2.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger.png b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger.png
new file mode 100644
index 00000000000..6801507dfe0
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger2.png b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger2.png
new file mode 100644
index 00000000000..73018ec55ba
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger2.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger3.png b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger3.png
new file mode 100644
index 00000000000..7ffb2ac7160
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger3.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger4.png b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger4.png
new file mode 100644
index 00000000000..e2acb3716fd
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger4.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerinfo.png b/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerinfo.png
new file mode 100644
index 00000000000..1452a20bef8
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerinfo.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerwithbitmapeffect.png b/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerwithbitmapeffect.png
new file mode 100644
index 00000000000..fe1cd70383c
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-propertytriggerwithbitmapeffect.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-renamecomponents.png b/docs/framework/wpf/controls/media/custom-button-blend-renamecomponents.png
new file mode 100644
index 00000000000..f881d240f62
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-renamecomponents.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-rotatetransform.gif b/docs/framework/wpf/controls/media/custom-button-blend-rotatetransform.gif
new file mode 100644
index 00000000000..0b8068ac610
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-rotatetransform.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-roundcorners.png b/docs/framework/wpf/controls/media/custom-button-blend-roundcorners.png
new file mode 100644
index 00000000000..5be4a15336d
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-roundcorners.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-scopeup.gif b/docs/framework/wpf/controls/media/custom-button-blend-scopeup.gif
new file mode 100644
index 00000000000..e349253551a
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-scopeup.gif differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-sizetransform.png b/docs/framework/wpf/controls/media/custom-button-blend-sizetransform.png
new file mode 100644
index 00000000000..5dc820960f1
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-sizetransform.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-templatepanel.png b/docs/framework/wpf/controls/media/custom-button-blend-templatepanel.png
new file mode 100644
index 00000000000..21b9ea9790f
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-templatepanel.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-blend-templatestroke.png b/docs/framework/wpf/controls/media/custom-button-blend-templatestroke.png
new file mode 100644
index 00000000000..a4d89f09a99
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-blend-templatestroke.png differ
diff --git a/docs/framework/wpf/controls/media/custom-button-glassrectangleproperties3.gif b/docs/framework/wpf/controls/media/custom-button-glassrectangleproperties3.gif
new file mode 100644
index 00000000000..44c09b34ba3
Binary files /dev/null and b/docs/framework/wpf/controls/media/custom-button-glassrectangleproperties3.gif differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step1.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step1.png
new file mode 100644
index 00000000000..cbf2128906a
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step1.png differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step2.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step2.png
new file mode 100644
index 00000000000..4a39b1327e3
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step2.png differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step3.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step3.png
new file mode 100644
index 00000000000..373f78bb4d4
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step3.png differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step4.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step4.png
new file mode 100644
index 00000000000..fe06a8bd6d1
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step4.png differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step5.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step5.png
new file mode 100644
index 00000000000..3c62e5e79d7
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step5.png differ
diff --git a/docs/framework/wpf/controls/media/datagrid-sql-ef-step6.png b/docs/framework/wpf/controls/media/datagrid-sql-ef-step6.png
new file mode 100644
index 00000000000..a58f97ebb18
Binary files /dev/null and b/docs/framework/wpf/controls/media/datagrid-sql-ef-step6.png differ
diff --git a/docs/framework/wpf/controls/media/editing-textbox-using-background-image.png b/docs/framework/wpf/controls/media/editing-textbox-using-background-image.png
new file mode 100644
index 00000000000..db6aa0ff07b
Binary files /dev/null and b/docs/framework/wpf/controls/media/editing-textbox-using-background-image.png differ
diff --git a/docs/framework/wpf/controls/media/editing-textbox-with-context-menu.png b/docs/framework/wpf/controls/media/editing-textbox-with-context-menu.png
new file mode 100644
index 00000000000..4f57da8ab7f
Binary files /dev/null and b/docs/framework/wpf/controls/media/editing-textbox-with-context-menu.png differ
diff --git a/docs/framework/wpf/controls/media/editing-textbox-with-spellchecking.png b/docs/framework/wpf/controls/media/editing-textbox-with-spellchecking.png
new file mode 100644
index 00000000000..85eedec9d75
Binary files /dev/null and b/docs/framework/wpf/controls/media/editing-textbox-with-spellchecking.png differ
diff --git a/docs/framework/wpf/controls/media/expanderexample.JPG b/docs/framework/wpf/controls/media/expanderexample.JPG
new file mode 100644
index 00000000000..7f4b950e942
Binary files /dev/null and b/docs/framework/wpf/controls/media/expanderexample.JPG differ
diff --git a/docs/framework/wpf/controls/media/expanderwithscrollbar.JPG b/docs/framework/wpf/controls/media/expanderwithscrollbar.JPG
new file mode 100644
index 00000000000..ee1abeafeb2
Binary files /dev/null and b/docs/framework/wpf/controls/media/expanderwithscrollbar.JPG differ
diff --git a/docs/framework/wpf/controls/media/labeledby.JPG b/docs/framework/wpf/controls/media/labeledby.JPG
new file mode 100644
index 00000000000..bbac095470a
Binary files /dev/null and b/docs/framework/wpf/controls/media/labeledby.JPG differ
diff --git a/docs/framework/wpf/controls/media/layout-border-around-textbox.png b/docs/framework/wpf/controls/media/layout-border-around-textbox.png
new file mode 100644
index 00000000000..4aa47c00915
Binary files /dev/null and b/docs/framework/wpf/controls/media/layout-border-around-textbox.png differ
diff --git a/docs/framework/wpf/controls/media/ndp-calendarcontrols.png b/docs/framework/wpf/controls/media/ndp-calendarcontrols.png
new file mode 100644
index 00000000000..101bd82a9d8
Binary files /dev/null and b/docs/framework/wpf/controls/media/ndp-calendarcontrols.png differ
diff --git a/docs/framework/wpf/controls/media/ndp-datepicker.png b/docs/framework/wpf/controls/media/ndp-datepicker.png
new file mode 100644
index 00000000000..83cf31f8833
Binary files /dev/null and b/docs/framework/wpf/controls/media/ndp-datepicker.png differ
diff --git a/docs/framework/wpf/controls/media/popuppicture.JPG b/docs/framework/wpf/controls/media/popuppicture.JPG
new file mode 100644
index 00000000000..d55d2a642d4
Binary files /dev/null and b/docs/framework/wpf/controls/media/popuppicture.JPG differ
diff --git a/docs/framework/wpf/controls/media/popupplacementabsolute.png b/docs/framework/wpf/controls/media/popupplacementabsolute.png
new file mode 100644
index 00000000000..5a3c5c99398
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementabsolute.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementbottom.png b/docs/framework/wpf/controls/media/popupplacementbottom.png
new file mode 100644
index 00000000000..5884fe2bc1e
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementbottom.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementbottomscreenedge.png b/docs/framework/wpf/controls/media/popupplacementbottomscreenedge.png
new file mode 100644
index 00000000000..48b5583d152
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementbottomscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementcenter.png b/docs/framework/wpf/controls/media/popupplacementcenter.png
new file mode 100644
index 00000000000..a7fc61dc31e
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementcenter.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementleft.png b/docs/framework/wpf/controls/media/popupplacementleft.png
new file mode 100644
index 00000000000..839bb3ef0a1
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementleft.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementleftscreenedge.png b/docs/framework/wpf/controls/media/popupplacementleftscreenedge.png
new file mode 100644
index 00000000000..6fca93e1597
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementleftscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementmouse.png b/docs/framework/wpf/controls/media/popupplacementmouse.png
new file mode 100644
index 00000000000..a19b68dfb18
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementmouse.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementmousepoint.png b/docs/framework/wpf/controls/media/popupplacementmousepoint.png
new file mode 100644
index 00000000000..39f06d2652b
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementmousepoint.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementmousescreenedge.png b/docs/framework/wpf/controls/media/popupplacementmousescreenedge.png
new file mode 100644
index 00000000000..277419df710
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementmousescreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementrelative.png b/docs/framework/wpf/controls/media/popupplacementrelative.png
new file mode 100644
index 00000000000..495dd513320
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementrelative.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementrelativepointrightscreenedge.png b/docs/framework/wpf/controls/media/popupplacementrelativepointrightscreenedge.png
new file mode 100644
index 00000000000..364857ef012
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementrelativepointrightscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementrelativepointscreenedge.png b/docs/framework/wpf/controls/media/popupplacementrelativepointscreenedge.png
new file mode 100644
index 00000000000..83373f81954
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementrelativepointscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementrelativescreenedge.png b/docs/framework/wpf/controls/media/popupplacementrelativescreenedge.png
new file mode 100644
index 00000000000..afd7ebdd7b2
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementrelativescreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementright.png b/docs/framework/wpf/controls/media/popupplacementright.png
new file mode 100644
index 00000000000..0d0d250ad06
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementright.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementrightscreenedge.png b/docs/framework/wpf/controls/media/popupplacementrightscreenedge.png
new file mode 100644
index 00000000000..9406cfe7d8a
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementrightscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementtargetoriginalignmentpoint.PNG b/docs/framework/wpf/controls/media/popupplacementtargetoriginalignmentpoint.PNG
new file mode 100644
index 00000000000..535099f1a9a
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementtargetoriginalignmentpoint.PNG differ
diff --git a/docs/framework/wpf/controls/media/popupplacementtop.png b/docs/framework/wpf/controls/media/popupplacementtop.png
new file mode 100644
index 00000000000..c28b66dbefb
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementtop.png differ
diff --git a/docs/framework/wpf/controls/media/popupplacementtopscreenedge.png b/docs/framework/wpf/controls/media/popupplacementtopscreenedge.png
new file mode 100644
index 00000000000..8a0bcf51abb
Binary files /dev/null and b/docs/framework/wpf/controls/media/popupplacementtopscreenedge.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-buttons.bmp b/docs/framework/wpf/controls/media/ss-ctl-buttons.bmp
new file mode 100644
index 00000000000..4a256ab4658
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-buttons.bmp differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-checkbox.png b/docs/framework/wpf/controls/media/ss-ctl-checkbox.png
new file mode 100644
index 00000000000..c9a33e4ef1d
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-checkbox.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-combobox.gif b/docs/framework/wpf/controls/media/ss-ctl-combobox.gif
new file mode 100644
index 00000000000..84aaaa75ff0
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-combobox.gif differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-contextmenu.png b/docs/framework/wpf/controls/media/ss-ctl-contextmenu.png
new file mode 100644
index 00000000000..7ab229787d5
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-contextmenu.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-horztoolbar.GIF b/docs/framework/wpf/controls/media/ss-ctl-horztoolbar.GIF
new file mode 100644
index 00000000000..2ee94958867
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-horztoolbar.GIF differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-hslider-ticks.png b/docs/framework/wpf/controls/media/ss-ctl-hslider-ticks.png
new file mode 100644
index 00000000000..d6d2e9996e1
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-hslider-ticks.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-menu.gif b/docs/framework/wpf/controls/media/ss-ctl-menu.gif
new file mode 100644
index 00000000000..2ed3b159cad
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-menu.gif differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-radiobuttons.gif b/docs/framework/wpf/controls/media/ss-ctl-radiobuttons.gif
new file mode 100644
index 00000000000..a72c7cb8ea0
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-radiobuttons.gif differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-repeatbutton.png b/docs/framework/wpf/controls/media/ss-ctl-repeatbutton.png
new file mode 100644
index 00000000000..36cfc11efdd
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-repeatbutton.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-statusbar.GIF b/docs/framework/wpf/controls/media/ss-ctl-statusbar.GIF
new file mode 100644
index 00000000000..ff544413061
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-statusbar.GIF differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-tabcontrol.gif b/docs/framework/wpf/controls/media/ss-ctl-tabcontrol.gif
new file mode 100644
index 00000000000..677cd6210e0
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-tabcontrol.gif differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-tooltip.png b/docs/framework/wpf/controls/media/ss-ctl-tooltip.png
new file mode 100644
index 00000000000..4f713ea47bd
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-tooltip.png differ
diff --git a/docs/framework/wpf/controls/media/ss-ctl-verttoolbar.GIF b/docs/framework/wpf/controls/media/ss-ctl-verttoolbar.GIF
new file mode 100644
index 00000000000..5dae89df4d8
Binary files /dev/null and b/docs/framework/wpf/controls/media/ss-ctl-verttoolbar.GIF differ
diff --git a/docs/framework/wpf/controls/media/treeviewillustration.JPG b/docs/framework/wpf/controls/media/treeviewillustration.JPG
new file mode 100644
index 00000000000..217e2af5a3c
Binary files /dev/null and b/docs/framework/wpf/controls/media/treeviewillustration.JPG differ
diff --git a/docs/framework/wpf/controls/media/wpf-datagridgroups.png b/docs/framework/wpf/controls/media/wpf-datagridgroups.png
new file mode 100644
index 00000000000..9c93a97f37a
Binary files /dev/null and b/docs/framework/wpf/controls/media/wpf-datagridgroups.png differ
diff --git a/docs/framework/wpf/controls/menu-overview.md b/docs/framework/wpf/controls/menu-overview.md
new file mode 100644
index 00000000000..0a7da75b185
--- /dev/null
+++ b/docs/framework/wpf/controls/menu-overview.md
@@ -0,0 +1,71 @@
+---
+title: "メニューの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メニュー コントロール"
+  - "メニュー コントロール"
+ms.assetid: 67df6de5-db96-4c71-b752-af90729a6537
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# メニューの概要
+<xref:System.Windows.Controls.Menu>クラスでは、コマンドおよび階層の順序でイベント ハンドラーに関連付けられている要素を整理することができます。 各<xref:System.Windows.Controls.Menu>要素のコレクションを格納する<xref:System.Windows.Controls.MenuItem>要素。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="menu_control"></a>   
+## <a name="menu-control"></a>メニュー コントロール  
+ <xref:System.Windows.Controls.Menu>コントロールは、コマンドまたはアプリケーションのオプションを指定する項目の一覧を表示します。 通常をクリックすると、 <xref:System.Windows.Controls.MenuItem>サブメニューを開くかによって、コマンドを実行するアプリケーション。  
+  
+<a name="creating_menus"></a>   
+## <a name="creating-menus"></a>メニューを作成します。  
+ 次の例を作成し、 [] メニューの <xref:System.Windows.Controls.Menu>でテキストを操作、 <xref:System.Windows.Controls.TextBox>します。 [] メニューの <xref:System.Windows.Controls.Menu>が含まれています<xref:System.Windows.Controls.MenuItem>を使用するオブジェクト、<xref:System.Windows.Controls.MenuItem.Command%2A>、 <xref:System.Windows.Controls.MenuItem.IsCheckable%2A>、および<xref:System.Windows.Controls.HeaderedItemsControl.Header%2A>プロパティおよび<xref:System.Windows.Controls.MenuItem.Checked>、<xref:System.Windows.Controls.MenuItem.Unchecked>と<xref:System.Windows.Controls.MenuItem.Click>イベントです。  
+  
+ [!code-xml[MenuItemCommandsAndEvents#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuItemCommandsAndEvents/CSharp/Window1.xaml#1)]  
+  
+ [!code-csharp[MenuItemCommandsAndEvents#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuItemCommandsAndEvents/CSharp/Window1.xaml.cs#2)]
+ [!code-vb[MenuItemCommandsAndEvents#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MenuItemCommandsAndEvents/VisualBasic/Window1.xaml.vb#2)]  
+  
+<a name="menus_with_shortcutkeys"></a>   
+## <a name="menuitems-with-keyboard-shortcuts"></a>キーボード ショートカットの MenuItems  
+ ショートカット キーは、キーボードで入力できる文字の組み合わせ<xref:System.Windows.Controls.Menu>コマンドです。 たとえば、ショートカット キーを**コピー**は CTRL キーを押しながら C キー。 ショートカット キーとメニュー項目を使用する&2; つのプロパティ-<xref:System.Windows.Controls.MenuItem.InputGestureText%2A>または<xref:System.Windows.Controls.MenuItem.Command%2A>します。  
+  
+<a name="menus_inputgesturetext"></a>   
+### <a name="inputgesturetext"></a>InputGestureText  
+ 次の例を使用する方法を示しています、 <xref:System.Windows.Controls.MenuItem.InputGestureText%2A>にキーボード ショートカットのテキストを割り当てるプロパティを<xref:System.Windows.Controls.MenuItem>コントロールです。 キーボード ショートカット メニュー項目にのみ生じます。  コマンドでは関連付けられません、 <xref:System.Windows.Controls.MenuItem>します。 アプリケーションでは、アクションを実行するために、ユーザーの入力を処理する必要があります。  
+  
+ [!code-xml[MenuEvent#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuEvent/CSharp/Pane1.xaml#6)]  
+  
+<a name="menus_commands"></a>   
+### <a name="command"></a>コマンド  
+ 使用する例を次に示します、<xref:System.Windows.Controls.MenuItem.Command%2A>プロパティに関連付けるには、**開く**と**保存**コマンドと<xref:System.Windows.Controls.MenuItem>コントロールです。 Command プロパティがコマンドに関連付けるだけでなく、 <xref:System.Windows.Controls.MenuItem>、もショートカットとして使用する入力ジェスチャのテキストを提供しています。  
+  
+ [!code-xml[MenuEvent#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuEvent/CSharp/Pane1.xaml#8)]  
+  
+ <xref:System.Windows.Controls.MenuItem>クラスもあります、 <xref:System.Windows.Controls.MenuItem.CommandTarget%2A>プロパティをコマンドが発生する要素を指定します。 場合<xref:System.Windows.Controls.MenuItem.CommandTarget%2A>未設定、キーボード フォーカスを持つ要素は、コマンドを受信します。 コマンドの詳細については、次を参照してください。[コマンドの実行の概要](../../../../docs/framework/wpf/advanced/commanding-overview.md)します。  
+  
+<a name="menu_styling"></a>   
+## <a name="menu-styling"></a>メニューのスタイル設定  
+ コントロールのスタイル設定を大幅に変更の動作と外観<xref:System.Windows.Controls.Menu>カスタム コントロールを記述しなくても制御します。 視覚プロパティの設定だけでなく適用することも、<xref:System.Windows.Style>コントロールの各部分にプロパティを使用してコントロールの一部の動作を変更または追加のパーツを追加またはコントロールのレイアウトを変更します。 次の例では、いくつかの方法で追加、<xref:System.Windows.Style>に、<xref:System.Windows.Controls.Menu>コントロールです。  
+  
+ 最初のコード例で定義、<xref:System.Windows.Style>と呼ばれる`Simple`自分のスタイルの現在のシステム設定を使用する方法を示します。 色を代入して、 `MenuHighlightBrush`  メニューの背景色として、 `MenuTextBrush`  メニューの前景色として。 ブラシを割り当てるには、リソース キーを使用することに注意してください。  
+  
+ [!code-xml[MenuStylesSnippet#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuStylesSnippet/CS/app.xaml#1)]  
+  
+ 次のサンプルは<xref:System.Windows.Trigger>要素の外観を変更するための<xref:System.Windows.Controls.MenuItem>で発生するイベントに応答、<xref:System.Windows.Controls.Menu>します。 上でマウスを移動すると、<xref:System.Windows.Controls.Menu>、前景色を指定し、メニュー項目のフォント特性を変更します。  
+  
+ [!code-xml[MenuStylesSnippet#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MenuStylesSnippet/CS/app.xaml#2)]  
+  
+## <a name="see-also"></a>関連項目  
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/menu-styles-and-templates.md b/docs/framework/wpf/controls/menu-styles-and-templates.md
new file mode 100644
index 00000000000..884af5bbda1
--- /dev/null
+++ b/docs/framework/wpf/controls/menu-styles-and-templates.md
@@ -0,0 +1,89 @@
+---
+title: "メニューのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], メニュー"
+  - "Menu [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], メニュー"
+  - "状態 [WPF], メニュー"
+  - "スタイル [WPF], メニュー"
+  - "テンプレート [WPF], メニュー"
+ms.assetid: b89da183-9b87-42c6-ac53-731a42c7b09e
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# メニューのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Menu> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Menu のパーツ  
+ <xref:System.Windows.Controls.Menu> コントロールには、名前付きのパーツは存在しません。  
+  
+ <xref:System.Windows.Controls.Menu> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.Menu> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## Menu の状態  
+ 次の表は、<xref:System.Windows.Controls.Menu> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## MenuItem のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Menu> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Popup|<xref:System.Windows.Controls.Primitives.Popup>|サブメニューを表示する領域です。|  
+  
+ <xref:System.Windows.Controls.MenuItem> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.MenuItem> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## MenuItem の状態  
+ 次の表は、<xref:System.Windows.Controls.MenuItem> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Menu および MenuItem ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Menu> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Menu](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/menu.xaml#menu)]  
+  
+ 次の例は、<xref:System.Windows.Controls.MenuItem> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#MenuItem](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/menu.xaml#menuitem)]  
+  
+ 次のコード例は、前の例で使用した `MenuScrollViewer` を定義します。  
+  
+ [!code-xml[ControlTemplateExamples#MenuScrollViewer](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/menu.xaml#menuscrollviewer)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> の例では、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/menu.md b/docs/framework/wpf/controls/menu.md
new file mode 100644
index 00000000000..3a7d5c03dce
--- /dev/null
+++ b/docs/framework/wpf/controls/menu.md
@@ -0,0 +1,41 @@
+---
+title: "メニュー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], メニュー"
+  - "Menu コントロール [WPF]"
+ms.assetid: 4317fb80-408c-47c7-9223-b29e4742c4ee
+caps.latest.revision: 77
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# メニュー
+<xref:System.Windows.Controls.Menu> コントロールを使用すると、コマンドまたはイベント ハンドラーに関連付けられている要素を階層的に編成できます。  各 <xref:System.Windows.Controls.Menu> には、複数の <xref:System.Windows.Controls.MenuItem> コントロールを格納できます。  各 <xref:System.Windows.Controls.MenuItem> は、コマンドまたは `Click` イベント ハンドラーを呼び出すことができます。  また、<xref:System.Windows.Controls.MenuItem> は、複数の <xref:System.Windows.Controls.MenuItem> 要素を子として持つことができ、サブメニューを構成できます。  
+  
+ 次の図は、メニュー コントロールの 3 つの異なる状態を示します。  既定の状態は、マウス ポインターなどのデバイスを <xref:System.Windows.Controls.Menu> 上に置いていない場合です。  フォーカス状態は、マウス ポインターを <xref:System.Windows.Controls.Menu> 上に置いているときに発生し、押された状態は、マウス ボタンを <xref:System.Windows.Controls.Menu> 上でクリックしたときに発生します。  
+  
+ ![メニューの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-menu.gif "SS\_CTL\_menu")  
+さまざまな状態のメニュー  
+  
+## このセクションの内容  
+ [メニューの概要](../../../../docs/framework/wpf/controls/menu-overview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Menu>  
+ <xref:System.Windows.Controls.MenuItem>  
+ <xref:System.Windows.Controls.Primitives.MenuBase>  
+ <xref:System.Windows.Controls.ContextMenu>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/navigationwindow-styles-and-templates.md b/docs/framework/wpf/controls/navigationwindow-styles-and-templates.md
new file mode 100644
index 00000000000..70ea873f65d
--- /dev/null
+++ b/docs/framework/wpf/controls/navigationwindow-styles-and-templates.md
@@ -0,0 +1,65 @@
+---
+title: "NavigationWindow のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], NavigationWindow"
+  - "NavigationWindow [WPF], スタイルおよびテンプレート"
+  - "パーツ [WPF], NavigationWindow"
+  - "状態 [WPF], NavigationWindow"
+  - "スタイル [WPF], NavigationWindow"
+  - "テンプレート [WPF], NavigationWindow"
+ms.assetid: 3656055e-3222-43c8-b868-fd0c90cc31a3
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# NavigationWindow のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Navigation.NavigationWindow> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## NavigationWindow のパーツ  
+ 次の表は、<xref:System.Windows.Navigation.NavigationWindow> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_NavWinCP|<xref:System.Windows.Controls.ContentPresenter>|コンテンツを表示する領域。|  
+  
+## NavigationWindow の状態  
+ 次の表は、<xref:System.Windows.Navigation.NavigationWindow> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## NavigationWindow ControlTemplate の例  
+ この例には <xref:System.Windows.Navigation.NavigationWindow> の <xref:System.Windows.Controls.ControlTemplate> に既定で定義されるすべての要素が含まれていますが、各値は単なる例と考えてください。  
+  
+ [!code-xml[ControlTemplateExamples#NavigationWindow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/navigationwindow.xaml#navigationwindow)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#ResizeGrip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/resizegrip.xaml#resizegrip)]  
+[!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/panel-how-to-topics.md b/docs/framework/wpf/controls/panel-how-to-topics.md
new file mode 100644
index 00000000000..882f90727ac
--- /dev/null
+++ b/docs/framework/wpf/controls/panel-how-to-topics.md
@@ -0,0 +1,54 @@
+---
+title: "パネルに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, パネル"
+  - "Panel コントロール [WPF], 方法トピック"
+ms.assetid: 28d8faf2-490c-4e17-a447-df25a66f6679
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# パネルに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Panel> 要素および関連する [!INCLUDE[TLA#tla_api#plural](../../../../includes/tlasharptla-apisharpplural-md.md)] を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [How to: Apply a LayoutTransform to an Element](http://msdn.microsoft.com/ja-jp/8221db67-d99f-4783-b65e-a6c5a52c03ab)  
+ [カスタム パネル要素を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-custom-panel-element.md)  
+ [パネルの OnRender メソッドをオーバーライドする](../../../../docs/framework/wpf/controls/how-to-override-the-panel-onrender-method.md)  
+ [要素の Height プロパティを設定する](../../../../docs/framework/wpf/controls/how-to-set-the-height-properties-of-an-element.md)  
+ [要素の Width プロパティを設定する](../../../../docs/framework/wpf/controls/how-to-set-the-width-properties-of-an-element.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/panel.md b/docs/framework/wpf/controls/panel.md
new file mode 100644
index 00000000000..07111b0927b
--- /dev/null
+++ b/docs/framework/wpf/controls/panel.md
@@ -0,0 +1,52 @@
+---
+title: "パネル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], パネル"
+  - "レイアウト [WPF], Panel コントロール"
+  - "Panel コントロール [WPF]"
+ms.assetid: 792943c5-335d-49dd-aa5b-ec1582a10088
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# パネル
+<xref:System.Windows.Controls.Panel> は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でのアプリケーション レイアウトをサポートするすべての要素の基本クラスです。  
+  
+## このセクションの内容  
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/panel-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/panels-overview.md b/docs/framework/wpf/controls/panels-overview.md
new file mode 100644
index 00000000000..a27f03efe47
--- /dev/null
+++ b/docs/framework/wpf/controls/panels-overview.md
@@ -0,0 +1,269 @@
+---
+title: "パネルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, パネル"
+  - "Panel コントロール [WPF], Panel コントロールの概要"
+ms.assetid: f73644af-9941-4611-8754-6d4cef03fc44
+caps.latest.revision: 48
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 45
+---
+# パネルの概要
+<xref:System.Windows.Controls.Panel> 要素は、要素のレンダリング \(サイズ、次元、位置、および子コンテンツの配置\) を制御するコンポーネントです。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、定義済みの多数の <xref:System.Windows.Controls.Panel> 要素と共に、カスタム <xref:System.Windows.Controls.Panel> 要素の作成機能を提供します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [パネル クラス](#Panels_view_from_10000_feet)  
+  
+-   [パネル要素の一般的なメンバー](#Panels_declared_members)  
+  
+-   [派生パネル要素](#Panels_derived_elements)  
+  
+-   [ユーザー インターフェイス パネル](#Panels_main_UI_elements)  
+  
+-   [入れ子になったパネル要素](#Panels_nested_panel_elements)  
+  
+-   [カスタム パネル要素](#Panels_custom_panel_elements)  
+  
+-   [ローカリゼーション\/グローバリゼーション サポート](#Panels_global_localization)  
+  
+-   [関連トピック](#seeAlsoToggle)  
+  
+<a name="Panels_view_from_10000_feet"></a>   
+## パネル クラス  
+ <xref:System.Windows.Controls.Panel> は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でのレイアウト サポートを提供するすべての要素の基本クラスです。  派生 <xref:System.Windows.Controls.Panel> 要素は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] とコードにおいて要素を配置して整列する際に使用されます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、多くの複雑なレイアウトを可能にする派生パネル実装の総合的なスイートが含まれます。  これらの派生クラスは、標準 [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] シナリオのほとんどを可能にするプロパティとメソッドを公開します。  ニーズを満たす子整列動作を見つけることができない開発者は、<xref:System.Windows.FrameworkElement.ArrangeOverride%2A> と <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドをオーバーライドすることにより、新しいレイアウトを作成できます。  カスタム レイアウト動作の詳細については、「[カスタム パネル要素](#Panels_custom_panel_elements)」を参照してください。  
+  
+<a name="Panels_declared_members"></a>   
+## パネルの一般的なメンバー  
+ すべての <xref:System.Windows.Controls.Panel> 要素は、<xref:System.Windows.FrameworkElement>によって定義されているベースのサイズ変更と位置プロパティ \(<xref:System.Windows.FrameworkElement.Height%2A>、<xref:System.Windows.FrameworkElement.Width%2A>、<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>、<xref:System.Windows.FrameworkElement.VerticalAlignment%2A>、<xref:System.Windows.FrameworkElement.Margin%2A>、<xref:System.Windows.FrameworkElement.LayoutTransform%2A> など\) をサポートします。  <xref:System.Windows.FrameworkElement> によって定義される位置プロパティの詳細については、「[配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.Panel> は、レイアウトを理解して使用するうえできわめて重要なその他のプロパティを公開します。  <xref:System.Windows.Controls.Panel.Background%2A> プロパティは、<xref:System.Windows.Media.Brush> で派生パネル要素の境界の間の領域を塗りつぶすために使用されます。  <xref:System.Windows.Controls.Panel.Children%2A> は、<xref:System.Windows.Controls.Panel> を構成する要素の子コレクションを表します。  <xref:System.Windows.Controls.Panel.InternalChildren%2A> は、<xref:System.Windows.Controls.Panel.Children%2A> コレクションの内容に加え、データ バインディングによって生成されるメンバーを表します。  どちらも、親 <xref:System.Windows.Controls.Panel> 内にホストされた子要素の <xref:System.Windows.Controls.UIElementCollection> で構成されます。  
+  
+ パネルは、派生 <xref:System.Windows.Controls.Panel.ZIndex%2A?displayProperty=fullName> のレイヤー化された順序を実現するために使用される <xref:System.Windows.Controls.Panel> 添付プロパティも公開します。  大きい <xref:System.Windows.Controls.Panel.ZIndex%2A?displayProperty=fullName> 値を持つパネルの <xref:System.Windows.Controls.Panel.Children%2A> コレクションのメンバーは、小さい <xref:System.Windows.Controls.Panel.ZIndex%2A?displayProperty=fullName> 値を持つメンバーの前に表示されます。  これは、子に同じ座標領域を共有できるようにする <xref:System.Windows.Controls.Canvas> および <xref:System.Windows.Controls.Grid> などのパネルに特に役立ちます。  
+  
+ また、<xref:System.Windows.Controls.Panel> は <xref:System.Windows.Controls.Panel.OnRender%2A> メソッドも定義しており、これを使用して <xref:System.Windows.Controls.Panel> の既定のプレゼンテーション動作をオーバーライドできます。  
+  
+#### 添付プロパティ  
+ 派生パネル要素は、[添付プロパティ](GTMT)を広く活用しています。  添付プロパティは、従来の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] プロパティ "ラッパー" を持たない特殊な形式の[依存関係プロパティ](GTMT)です。  添付プロパティは、下記の例に見られるとおり、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 内に特殊な構文を持ちます。  
+  
+ 添付プロパティの目的の 1 つは、親要素によって実際に定義されたプロパティの一意の値を子要素が格納できるようにすることです。  この機能の応用方法の 1 つは、子要素から親要素に [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] でどのように表示したいかを通知させることで、これはアプリケーション レイアウトに非常に役立ちます。  詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+<a name="Panels_derived_elements"></a>   
+## 派生パネル要素  
+ <xref:System.Windows.Controls.Panel> から多くのオブジェクトが派生しますが、それらのすべてがルート レイアウト プロバイダーとして使用されません。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] アプリケーション専用に作成された、6 つの定義済みパネル クラス \(<xref:System.Windows.Controls.Canvas>、<xref:System.Windows.Controls.DockPanel>、<xref:System.Windows.Controls.Grid>、<xref:System.Windows.Controls.StackPanel>、<xref:System.Windows.Controls.VirtualizingStackPanel>、および<xref:System.Windows.Controls.WrapPanel>\)があります。  
+  
+ 次の表に各パネル要素でカプセル化されているそれぞれの特殊機能を示します。  
+  
+|要素名|UI パネル?|Description|  
+|---------|-------------|-----------------|  
+|<xref:System.Windows.Controls.Canvas>|○|<xref:System.Windows.Controls.Canvas> 領域に対する座標により子要素を明示的に配置できる領域を定義します。|  
+|<xref:System.Windows.Controls.DockPanel>|○|子要素を互いに水平方向または垂直方向に整列する領域を定義します。|  
+|<xref:System.Windows.Controls.Grid>|○|列と行で構成されている柔軟なグリッド領域を定義します。  <xref:System.Windows.Controls.Grid> の子要素は、<xref:System.Windows.FrameworkElement.Margin%2A> プロパティを正確に使用して配置できます。|  
+|<xref:System.Windows.Controls.StackPanel>|○|単一行に子要素を整列します。行は水平方向または垂直方向にできます。|  
+|<xref:System.Windows.Controls.Primitives.TabPanel>|Ｘ|<xref:System.Windows.Controls.TabControl> でタブ ボタンのレイアウトを処理します。|  
+|<xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel>|Ｘ|<xref:System.Windows.Controls.ToolBar> コントロール内のコンテンツを整列します。|  
+|<xref:System.Windows.Controls.Primitives.UniformGrid>|Ｘ|<xref:System.Windows.Controls.Primitives.UniformGrid> は、グリッド内の子をすべて同じセル サイズで整列する際に使用されます。|  
+|<xref:System.Windows.Controls.VirtualizingPanel>|Ｘ|子コレクションを "仮想化" できるパネルに基本クラスを提供します。|  
+|<xref:System.Windows.Controls.VirtualizingStackPanel>|○|水平方向または垂直方向に向けた単一行上にコンテンツを整列して仮想化します。|  
+|<xref:System.Windows.Controls.WrapPanel>|○|<xref:System.Windows.Controls.WrapPanel> は、左から右へ順に子要素を配置し、ボックスの端で改行してコンテンツを次の行へ送ります。  後続の配置は、<xref:System.Windows.Controls.WrapPanel.Orientation%2A> プロパティの値に応じて、上から下または右から左に向かって行われます。|  
+  
+<a name="Panels_main_UI_elements"></a>   
+## ユーザー インターフェイス パネル  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] シナリオをサポートするために最適化された次の 6 つのパネル クラスがあります。それは、<xref:System.Windows.Controls.Canvas>、<xref:System.Windows.Controls.DockPanel>、<xref:System.Windows.Controls.Grid>、<xref:System.Windows.Controls.StackPanel>、<xref:System.Windows.Controls.VirtualizingStackPanel>、および <xref:System.Windows.Controls.WrapPanel> です。  これらのパネル要素は使いやすく、用途が広く、ほとんどのアプリケーションに対する拡張性があります。  
+  
+ 各派生 <xref:System.Windows.Controls.Panel> 要素で、サイズ制約の処理方法が異なります。  <xref:System.Windows.Controls.Panel> が水平または垂直方向のどちらで制約を処理するかを理解することにより、レイアウトの予測がより可能となります。  
+  
+|**パネル名**|**x\-Dimension**|**y\-Dimension**|  
+|--------------|----------------------|----------------------|  
+|<xref:System.Windows.Controls.Canvas>|コンテンツに対する制約あり。|コンテンツに対する制約あり。|  
+|<xref:System.Windows.Controls.DockPanel>|制約あり。|制約あり。|  
+|<xref:System.Windows.Controls.StackPanel> \(垂直方向\)|制約あり。|コンテンツに対する制約あり。|  
+|<xref:System.Windows.Controls.StackPanel> \(水平方向\)|コンテンツに対する制約あり。|制約あり。|  
+|<xref:System.Windows.Controls.Grid>|制約あり。|制約あり。ただし、<xref:System.Windows.GridUnitType> が行と列に適用される場合を除きます。|  
+|<xref:System.Windows.Controls.WrapPanel>|コンテンツに対する制約あり。|コンテンツに対する制約あり。|  
+  
+ これらの各要素の詳細な説明と使用例については、以下を参照してください。  
+  
+<a name="Panels_overview_Canvas_subsection"></a>   
+### Canvas  
+ <xref:System.Windows.Controls.Canvas> 要素は、*x\-* および  *y\-* の絶対座標に従って、コンテンツの位置を設定できます。  要素は一意の場所に描画できます。または、要素が同じ座標を占める場合、マークアップに表示される順序が要素の描画順序を決定します。  
+  
+ <xref:System.Windows.Controls.Canvas> は、<xref:System.Windows.Controls.Panel> のレイアウトを最も柔軟にサポートします。  Height および Width プロパティがキャンバスの領域の定義に使用され、内側の要素には、親の <xref:System.Windows.Controls.Canvas> 領域に対する絶対座標が割り当てられます。  4 つの添付プロパティ \(<xref:System.Windows.Controls.Canvas.Left%2A?displayProperty=fullName>、<xref:System.Windows.Controls.Canvas.Top%2A?displayProperty=fullName>、<xref:System.Windows.Controls.Canvas.Right%2A?displayProperty=fullName>、および <xref:System.Windows.Controls.Canvas.Bottom%2A?displayProperty=fullName>\) により、<xref:System.Windows.Controls.Canvas> 内のオブジェクトの配置を緻密に制御できるので、開発者は画面上で要素の配置と整列を正確に行うことができます。  
+  
+#### キャンバス内の ClipToBounds  
+ <xref:System.Windows.Controls.Canvas> は、独自に定義した<xref:System.Windows.FrameworkElement.Height%2A> と <xref:System.Windows.FrameworkElement.Width%2A> の外側にある座標でも、画面の任意の位置に子要素を配置できます。  また、<xref:System.Windows.Controls.Canvas> は子要素のサイズの影響を受けません。  その結果、子要素は親の <xref:System.Windows.Controls.Canvas> の外接する四角形の外側に他の要素を描画できます。  <xref:System.Windows.Controls.Canvas> の既定動作により、親の <xref:System.Windows.Controls.Canvas> の境界の外側に子要素を描画できます。  この動作が必要でない場合は、<xref:System.Windows.UIElement.ClipToBounds%2A> プロパティを `true` に設定します。  これにより、<xref:System.Windows.Controls.Canvas> が独自のサイズに切り取られます。  <xref:System.Windows.Controls.Canvas> は、境界の外側に子要素を描画できる唯一のレイアウト要素です。  
+  
+ この動作は、[Width のプロパティの比較のサンプル](http://go.microsoft.com/fwlink/?LinkID=160050)に図示されています。  
+  
+#### キャンバスの定義と使用  
+ <xref:System.Windows.Controls.Canvas> は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] またはコードを使用して、容易にインスタンス化できます。  次の例に、<xref:System.Windows.Controls.Canvas> を使用してコンテンツを絶対的に配置する方法を示します。  このコードでは、100 ピクセルの四角形を 3 つ生成します。  最初の四角形は赤色で、左上 \(*x, y*\) の位置が \(0, 0\) に指定されます。  2 番目の四角形は緑色で、左上の位置は \(100, 100\) となり、最初の四角形の右下になります。  3 番目の四角形は青色で、左上の位置は \(50, 50\) となるため、最初の四角形の右下の象限および 2 番目の四角形の左上の象限を囲む状態になります。  3 番目の四角形が最後にレイアウトされるため、他の 2 つの四角形の上に重なっているように見えます。つまり、重複している部分は 3 番目の四角形の色とみなされます。  
+  
+ [!code-csharp[CanvasOvwSample#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CanvasOvwSample/CSharp/Canvas_Ovw_Sample.cs#1)]
+ [!code-vb[CanvasOvwSample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CanvasOvwSample/VisualBasic/canvas_vb.vb#1)]
+ [!code-xml[CanvasOvwSample#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/CanvasOvwSample/XAML/default.xaml#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![一般的なキャンバス要素。](../../../../docs/framework/wpf/controls/media/panel-intro-canvas.png "panel\_intro\_canvas")  
+  
+<a name="Panels_overview_DockPanel_subsection"></a>   
+### DockPanel  
+ <xref:System.Windows.Controls.DockPanel> 要素は、子コンテンツ要素で設定された <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> 添付プロパティを使用して、コンテナーの端に沿ってコンテンツを配置します。  <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> を <xref:System.Windows.Controls.Dock> または <xref:System.Windows.Controls.Dock> に設定すると、子要素は互いの上または下に配置されます。  <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> を <xref:System.Windows.Controls.Dock> または <xref:System.Windows.Controls.Dock> に設定すると、子要素は互いの左または右に配置されます。  <xref:System.Windows.Controls.DockPanel.LastChildFill%2A> プロパティは、 <xref:System.Windows.Controls.DockPanel> の子として追加された最終要素の位置を決定します。  
+  
+ <xref:System.Windows.Controls.DockPanel> を使用して、一連のボタンなど、関連コントロールのグループを配置できます。  または、これを使用して、[!INCLUDE[TLA#tla_outlook](../../../../includes/tlasharptla-outlook-md.md)] に見られるのと同様の "ウィンドウ形式の" [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成できます。  
+  
+#### コンテンツに合わせたサイズの変更  
+ <xref:System.Windows.FrameworkElement.Height%2A> と <xref:System.Windows.FrameworkElement.Width%2A> プロパティが指定されていない場合、<xref:System.Windows.Controls.DockPanel> はコンテンツに合わせてサイズを変更します。  サイズは、子要素のサイズに合うように、増減させることができます。  ただし、これらのプロパティが指定されており、次に指定する子要素のためのスペースがない場合、<xref:System.Windows.Controls.DockPanel> はその子要素または後続の子要素を表示せず、後続の子要素を計測しません。  
+  
+#### LastChildFill  
+ 既定では、<xref:System.Windows.Controls.DockPanel> 要素の最後の子は、残りの未割り当て領域の "塗り潰し" を実行します。  この動作が必要でない場合、<xref:System.Windows.Controls.DockPanel.LastChildFill%2A> プロパティを `false` に設定します。  
+  
+#### DockPanel の定義と使用  
+ 次の例に、<xref:System.Windows.Controls.DockPanel> を使用してスペースを分割する方法を示します。  親 <xref:System.Windows.Controls.DockPanel> の子として、5 つの <xref:System.Windows.Controls.Border> 要素が追加されます。  それぞれ <xref:System.Windows.Controls.DockPanel> の異なる位置プロパティを使用して、スペースを分割します。  最後の要素が、残っている未割り当て領域の "塗り潰し" を実行します。  
+  
+ [!code-cpp[DockPanelOvwSample#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/DockPanelOvwSample/CPP/DockPanel_Ovw_Sample.cpp#1)]
+ [!code-csharp[DockPanelOvwSample#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DockPanelOvwSample/CSharp/DockPanel_Ovw_Sample.cs#1)]
+ [!code-vb[DockPanelOvwSample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DockPanelOvwSample/VisualBasic/dockpanel_vb.vb#1)]
+ [!code-xml[DockPanelOvwSample#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DockPanelOvwSample/XAML/default.xaml#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![一般的な DockPanel シナリオ。](../../../../docs/framework/wpf/controls/media/panel-intro-dockpanel.png "panel\_intro\_dockpanel")  
+  
+<a name="Panels_overview_Grid_subsection"></a>   
+### \[グリッド\]  
+ <xref:System.Windows.Controls.Grid> 要素は、絶対配置と表データ コントロールの機能をマージします。  <xref:System.Windows.Controls.Grid> により、容易に要素を配置して体裁を整えることができます。  <xref:System.Windows.Controls.Grid> では、行と列のグループを柔軟に定義でき、複数の <xref:System.Windows.Controls.Grid> 要素間でサイズ情報を共有するメカニズムも用意されています。  
+  
+#### グリッドとテーブルを区別する方法  
+ <xref:System.Windows.Documents.Table> と <xref:System.Windows.Controls.Grid> には共通の機能がいくつかありますが、それぞれが最も適している状況は異なります。  <xref:System.Windows.Documents.Table> は、フロー コンテンツ内で使用するために設計されています \(フロー コンテンツの詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください\)。  グリッドは、フォーム内 \(基本的にはフロー コンテンツ外の任意の場所\) で使用するのに最適です。  <xref:System.Windows.Documents.FlowDocument> 内では、<xref:System.Windows.Documents.Table> は改ページ位置の自動修正、列の再配置、およびコンテンツの選択をサポートしますが、<xref:System.Windows.Controls.Grid> はサポートしません。  一方、<xref:System.Windows.Controls.Grid> は、さまざまな理由から <xref:System.Windows.Documents.FlowDocument> の外で使用するのに適しています。たとえば、<xref:System.Windows.Controls.Grid> は行と列のインデックスに基づいて要素を追加しますが、<xref:System.Windows.Documents.Table> は追加しません。  <xref:System.Windows.Controls.Grid> 要素により、子のコンテンツのレイヤーを表示でき、1 つの "セル" 内に複数の要素を含むことができます。<xref:System.Windows.Documents.Table> は、レイヤー表示をサポートしません。  <xref:System.Windows.Controls.Grid> の子要素は、"セル" 境界の領域に対して絶対位置で配置できます。  <xref:System.Windows.Documents.Table> は、この機能をサポートしていません。  最後に、<xref:System.Windows.Controls.Grid> は <xref:System.Windows.Documents.Table> より軽量です。  
+  
+#### 列と行のサイズ変更動作  
+ <xref:System.Windows.Controls.Grid> 内で定義された列と行は、<xref:System.Windows.GridUnitType> サイズ変更機能を利用して、残りのスペースを比率に応じて分配できます。  <xref:System.Windows.GridUnitType> が行または列の高さまたは幅として選択された場合、その列または行は、使用可能な残りのスペースの領域を加重比率分を受け取ります。  これは、列または行内のコンテンツのサイズに基づいてスペースを均等に分配する <xref:System.Windows.GridUnitType> とは対照的です。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用する場合、この値は `*` または `2*` と表現されます。  最初のケースでは、行または列は使用可能なスペース領域を 1 回受け取り、2 番目のケースでは 2 回受け取ることになります。  <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> を使用してスペースを比率に応じて分配する方法と、`Stretch` の <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> 値を組み合わせることにより、画面スペースのパーセンテージ単位でレイアウト スペースを分割できます。  このような方法でスペースを分配できるレイアウト パネルは、<xref:System.Windows.Controls.Grid> だけです。  
+  
+#### グリッドの定義と使用  
+ 次の例に、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] スタート メニューで使用可能な「ファイル名を指定して実行」ダイアログに見られるのと同様の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を構築する方法を示します。  
+  
+ [!code-csharp[GridRunDialog#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GridRunDialog/CSharp/window1.xaml.cs#1)]
+ [!code-vb[GridRunDialog#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GridRunDialog/VisualBasic/grid_vb.vb#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![一般的なグリッド要素。](../../../../docs/framework/wpf/controls/media/avalon-run-dialog.png "avalon\_run\_dialog")  
+  
+<a name="Panels_overview_StackPanel_subsection"></a>   
+### StackPanel  
+ <xref:System.Windows.Controls.StackPanel> により、割り当てられた方向に要素を "スタック" できます。  既定のスタック方向は、縦です。  <xref:System.Windows.Controls.StackPanel.Orientation%2A> プロパティを使用して、コンテンツ フローを制御できます。  
+  
+#### StackPanel と DockPanel  
+ <xref:System.Windows.Controls.DockPanel> でも子要素を "スタック" できますが、<xref:System.Windows.Controls.DockPanel> と <xref:System.Windows.Controls.StackPanel> を同じ状況で使用しても、同様の結果は生成されません。  たとえば、<xref:System.Windows.Controls.DockPanel> では、子要素の順序がサイズに影響を与えますが、<xref:System.Windows.Controls.StackPanel> では影響しません。  これは、<xref:System.Windows.Controls.StackPanel> が <xref:System.Double.PositiveInfinity> でスタック方向に計測するのに対し、<xref:System.Windows.Controls.DockPanel> は使用可能なサイズだけを計測するためです。  
+  
+ この主な相違点を次の例に示します。  
+  
+ [!code-cpp[StackPanelOvw4#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/StackPanelOvw4/CPP/StackPanel_Ovw_Sample4.cpp#1)]
+ [!code-csharp[StackPanelOvw4#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StackPanelOvw4/CSharp/StackPanel_Ovw_Sample4.cs#1)]
+ [!code-vb[StackPanelOvw4#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StackPanelOvw4/VisualBasic/StackPanelSamp.vb#1)]
+ [!code-xml[StackPanelOvw4#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/StackPanelOvw4/XAML/default.xaml#1)]  
+  
+ このイメージにはレンダリング動作の違いが見られます。  
+  
+ ![スクリーン ショット: StackPanel スクリーンショットとDockPanel スクリーン ショット](../../../../docs/framework/wpf/controls/media/layout-smiley-stackpanel.png "layout\_smiley\_stackpanel")  
+  
+#### StackPanel の定義と使用  
+ 次の例に、<xref:System.Windows.Controls.StackPanel> を使用して一連の縦方向配置ボタンを作成する方法を示します。  横方向に配置する場合は、<xref:System.Windows.Controls.StackPanel.Orientation%2A> プロパティを<xref:System.Windows.Controls.Orientation> に設定します。  
+  
+ [!code-csharp[StackPanel_ovw2#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StackPanel_ovw2/CSharp/StackPanel_Ovw_Sample2.cs#1)]
+ [!code-vb[StackPanel_ovw2#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StackPanel_ovw2/VisualBasic/StackPanelOvw.vb#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![一般的な StackPanel 要素。](../../../../docs/framework/wpf/controls/media/panel-intro-stackpanel.png "panel\_intro\_stackpanel")  
+  
+<a name="Panels_overview_VirtualizingStackPanel_subsection"></a>   
+#### VirtualizingStackPanel  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] もデータ バインド子コンテンツを自動的に "仮想化する" <xref:System.Windows.Controls.StackPanel> 要素のバリエーションを提供します。  ここで、"仮想化" は、どの項目を画面に表示するかに基づいて、要素のサブセットを多数のデータ項目から生成する手法を指します。  特定の時間に画面に UI 要素が少ししか表示されていない場合に多数の UI 要素を生成すると、メモリおよびプロセッサの両方に負荷がかかります。  <xref:System.Windows.Controls.VirtualizingStackPanel> は、<xref:System.Windows.Controls.VirtualizingPanel> で提供される機能を通じて、表示される項目を計算し、<xref:System.Windows.Controls.ItemsControl> \(<xref:System.Windows.Controls.ListBox> や <xref:System.Windows.Controls.ListView> など\) の <xref:System.Windows.Controls.ItemContainerGenerator> と共に機能することで、表示される項目に対応する要素だけを作成します。  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel> 要素は、<xref:System.Windows.Controls.ListBox> などのコントロール用の項目ホストとして自動的に設定されます。  データ バインド コレクションをホストした場合、<xref:System.Windows.Controls.ScrollViewer> の境界内にコンテンツがあれば、コンテンツは自動的に仮想化されます。  これにより、多くの子項目をホストする際のパフォーマンスが大幅に向上します。  
+  
+ 次のマークアップは、項目ホストとして <xref:System.Windows.Controls.VirtualizingStackPanel> を使用する方法を示します。  <xref:System.Windows.Controls.VirtualizingStackPanel.IsVirtualizing%2A?displayProperty=fullName> [添付プロパティ](GTMT)を `true` \(既定値\) に設定して、仮想化が行われるようにする必要があります。  
+  
+ [!code-xml[VirtualizingStackPanel_Intro#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VirtualizingStackPanel_Intro/CS/default.xaml#1)]  
+  
+<a name="Panels_overview_WrapPanel"></a>   
+### WrapPanel  
+ <xref:System.Windows.Controls.WrapPanel> を使用して、子要素を左から右に順に配置し、親コンテナーの端に達すると、次の行に改行させます。  コンテンツは水平方向または垂直方向に設定できます。  <xref:System.Windows.Controls.WrapPanel> は、単純な流れの [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] シナリオに役立ちます。  また、子要素すべてに均等なサイズを適用する際にも使用できます。  
+  
+ 次の例には、コンテナーの端に達した時点でラップする <xref:System.Windows.Controls.Button> コントロールを表示するための <xref:System.Windows.Controls.WrapPanel> の作成方法を示します。  
+  
+ [!code-cpp[WrapPanel_Intro#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/WrapPanel_Intro/CPP/WrapPanel_Code.cpp#1)]
+ [!code-csharp[WrapPanel_Intro#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WrapPanel_Intro/CSharp/WrapPanel_Code.cs#1)]
+ [!code-vb[WrapPanel_Intro#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WrapPanel_Intro/VisualBasic/WrapPanel_vb.vb#1)]
+ [!code-xml[WrapPanel_Intro#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/WrapPanel_Intro/XAML/default.xaml#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![一般的な WrapPanel 要素。](../../../../docs/framework/wpf/controls/media/wrappanel-element.png "WrapPanel\_Element")  
+  
+<a name="Panels_nested_panel_elements"></a>   
+## 入れ子になったパネル要素  
+ <xref:System.Windows.Controls.Panel> 要素を互いに入れ子にして、複雑なレイアウトを生成することができます。  これは、<xref:System.Windows.Controls.Panel> が [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のある部分には適しているが、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の別の部分のニーズに合致しない場合に、役立つことがあります。  
+  
+ アプリケーションがサポートできる入れ子の量に決められた制限はありませんが、一般的に、目的のレイアウトに必要なパネルのみを使用するようアプリケーションを制限することをお勧めします。  多くの場合、<xref:System.Windows.Controls.Grid> 要素はレイアウト コンテナーとしての柔軟性を持つため、入れ子になったパネルの代用として使用できます。  これにより、ツリーから不要な要素が排除され、アプリケーションのパフォーマンスが向上します。  
+  
+ 次の例に、特定のレイアウトを達成するために、入れ子になった <xref:System.Windows.Controls.Panel> 要素を利用する [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成する方法を示します。  このような特定のケースでは、<xref:System.Windows.Controls.DockPanel> 要素を使用して [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 構造を提供し、入れ子になった <xref:System.Windows.Controls.StackPanel> 要素、<xref:System.Windows.Controls.Grid>、および <xref:System.Windows.Controls.Canvas> を使用して、親の <xref:System.Windows.Controls.DockPanel> 内で子要素を正しく配置します。  
+  
+ [!code-csharp[Nested_Panels#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Nested_Panels/CSharp/nestedpanels.cs#1)]
+ [!code-vb[Nested_Panels#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Nested_Panels/VisualBasic/nestedpanels.vb#1)]  
+  
+ コンパイルされたアプリケーションは、これと同様の新しい [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を生成します。  
+  
+ ![入れ子になったパネルを利用する UI。](../../../../docs/framework/wpf/controls/media/nested-panels.png "nested\_panels")  
+  
+<a name="Panels_custom_panel_elements"></a>   
+## カスタム パネル要素  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] により柔軟なレイアウト コントロール配列が提供されますが、<xref:System.Windows.FrameworkElement.ArrangeOverride%2A> および <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドをオーバーライドすることにより、カスタム レイアウト動作も実行できます。  このオーバーライド メソッド内で新しい配置動作を定義することにより、カスタムのサイズ変更と配置が実行されます。  
+  
+ 同様に、派生クラス \(<xref:System.Windows.Controls.Canvas>、<xref:System.Windows.Controls.Grid> など\) に基づくカスタム レイアウト動作は、<xref:System.Windows.FrameworkElement.ArrangeOverride%2A> および <xref:System.Windows.FrameworkElement.MeasureOverride%2A> メソッドをオーバーライドすることにより定義できます。  
+  
+ 次のマークアップは、カスタムの <xref:System.Windows.Controls.Panel> 要素を作成する方法を示します。  `PlotPanel` として定義されたこの新しい <xref:System.Windows.Controls.Panel> では、ハードコーディングされた *x\-* および *y\-* 座標を使って子要素の配置がサポートされます。  この例では、<xref:System.Windows.Shapes.Rectangle> 要素 \(表示されていません\) は、プロット位置 50 \(*x*\) と 50 \(*y*\) に配置されます。  
+  
+ [!code-cpp[PlotPanel#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PlotPanel/CPP/PlotPanel.cpp#1)]
+ [!code-csharp[PlotPanel#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PlotPanel/CSharp/PlotPanel.cs#1)]
+ [!code-vb[PlotPanel#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PlotPanel/VisualBasic/PlotPanel.vb#1)]  
+  
+ より複雑なカスタム パネルの実装を確認するには、[カスタム コンテンツ折り返しパネルの作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159979)を参照してください。  
+  
+<a name="Panels_global_localization"></a>   
+## ローカリゼーション\/グローバリゼーション サポート  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、ローカライズ可能な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の作成を支援する多数の機能をサポートしています。  
+  
+ すべてのパネル要素は、<xref:System.Windows.FrameworkElement.FlowDirection%2A> プロパティをサポートしており、ユーザーのロケールまたは言語設定に基づいて内容を動的に再フローする際に使用できます。  詳細については、<xref:System.Windows.FrameworkElement.FlowDirection%2A> を参照してください。  
+  
+ <xref:System.Windows.Window.SizeToContent%2A> プロパティは、アプリケーション開発者がローカライズされた [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のニーズを予測できるメカニズムを提供します。  親 <xref:System.Windows.Window> は、このプロパティの <xref:System.Windows.SizeToContent> 値を使用することにより、コンテンツに合わせて常に動的にサイズを変更し、シミュレート用の高さまたは幅制限による制限を受けません。  
+  
+ <xref:System.Windows.Controls.DockPanel>、<xref:System.Windows.Controls.Grid>、および <xref:System.Windows.Controls.StackPanel> はすべて、ローカライズできる [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] に適しています。  一方、<xref:System.Windows.Controls.Canvas> は、コンテンツが絶対的に配置され、ローカライズが困難なため、適切ではありません。  
+  
+ ローカライズ可能な [!INCLUDE[TLA#tla_ui#plural](../../../../includes/tlasharptla-uisharpplural-md.md)] を備えた [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの作成方法の詳細については、「[自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)」を参照してください。  
+  
+## 参照  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)   
+ [WPF レイアウト ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160054)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)   
+ [配置、余白、パディングの概要](../../../../docs/framework/wpf/advanced/alignment-margins-and-padding-overview.md)   
+ [カスタム コンテンツ折り返しパネルの作成のサンプル](http://go.microsoft.com/fwlink/?LinkID=159979)   
+ [添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)   
+ [自動レイアウトの使用の概要](../../../../docs/framework/wpf/advanced/use-automatic-layout-overview.md)   
+ [レイアウトとデザイン](../../../../docs/framework/wpf/advanced/optimizing-performance-layout-and-design.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/passwordbox-syles-and-templates.md b/docs/framework/wpf/controls/passwordbox-syles-and-templates.md
new file mode 100644
index 00000000000..39c7e05e356
--- /dev/null
+++ b/docs/framework/wpf/controls/passwordbox-syles-and-templates.md
@@ -0,0 +1,69 @@
+---
+title: "PasswordBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], PasswordBox"
+  - "パーツ [WPF], PasswordBox"
+  - "PasswordBox [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], PasswordBox"
+  - "スタイル [WPF], PasswordBox"
+  - "テンプレート [WPF], PasswordBox"
+ms.assetid: deb52107-959f-4a60-b303-d21a0a933060
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# PasswordBox のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.PasswordBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## PasswordBox のパーツ  
+ 次の表は、<xref:System.Windows.Controls.PasswordBox> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ContentHost|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.FrameworkElement> 要素を含むことができるビジュアル要素です。  <xref:System.Windows.Controls.PasswordBox> のテキストは、この要素内に表示されます。|  
+  
+## PasswordBox の状態  
+ 次の表は、<xref:System.Windows.Controls.PasswordBox> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## PasswordBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.PasswordBox> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#PasswordBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/textbox.xaml#passwordbox)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/passwordbox.md b/docs/framework/wpf/controls/passwordbox.md
new file mode 100644
index 00000000000..0b9464d1677
--- /dev/null
+++ b/docs/framework/wpf/controls/passwordbox.md
@@ -0,0 +1,30 @@
+---
+title: "PasswordBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], PasswordBox"
+  - "PasswordBox コントロール [WPF]"
+ms.assetid: 4dbf0320-30c2-4015-b9bc-4f6502f78e32
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# PasswordBox
+<xref:System.Windows.Controls.PasswordBox> コントロールは、機密性の高い情報やプライベートな情報を入力するために使用します。  
+  
+## 参照  
+ <xref:System.Windows.Controls.TextBox>   
+ <xref:System.Windows.Controls.RichTextBox>   
+ [コントロール ライブラリ](../../../../docs/framework/wpf/controls/control-library.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/popup-how-to-topics.md b/docs/framework/wpf/controls/popup-how-to-topics.md
new file mode 100644
index 00000000000..e48a411f2c1
--- /dev/null
+++ b/docs/framework/wpf/controls/popup-how-to-topics.md
@@ -0,0 +1,35 @@
+---
+title: "ポップアップに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ポップアップ"
+  - "ポップアップ コントロール [WPF], 方法トピック"
+ms.assetid: 9488a245-0168-4650-b9ab-d075a108cc8f
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# ポップアップに関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.Primitives.Popup> コントロールを使用して、現在のアプリケーション ウィンドウの上にフロート表示される個別のウィンドウにコンテンツを表示する方法について説明します。  
+  
+## このセクションの内容  
+ [ポップアップをアニメーション化する](../../../../docs/framework/wpf/controls/how-to-animate-a-popup.md)  
+ [ポップアップのカスタム位置を指定する](../../../../docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.Popup>  
+  
+## 関連項目  
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/popup-overview.md b/docs/framework/wpf/controls/popup-overview.md
new file mode 100644
index 00000000000..b13153d9fd1
--- /dev/null
+++ b/docs/framework/wpf/controls/popup-overview.md
@@ -0,0 +1,107 @@
+---
+title: "ポップアップの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ポップアップ"
+  - "ポップアップ コントロール [WPF], ポップアップ コントロールの概要"
+ms.assetid: 774f53ca-bff8-470e-9ce9-3928b4cf3d4c
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# ポップアップの概要
+<xref:System.Windows.Controls.Primitives.Popup> コントロールは、現在のアプリケーション ウィンドウの上の別のウィンドウにコンテンツを表示するための手段です。ウィンドウの表示位置は、特定の要素を基準として、または画面座標として指定されます。  ここでは、<xref:System.Windows.Controls.Primitives.Popup> コントロールの概要と、使用方法に関する情報を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="What_Is_a_Popup_"></a>   
+## ポップアップとは  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールは、画面上の要素または点を基準として別のウィンドウにコンテンツを表示します。  <xref:System.Windows.Controls.Primitives.Popup> が表示されているときは、<xref:System.Windows.Controls.Primitives.Popup.IsOpen%2A> プロパティが `true` に設定されています。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.Primitives.Popup> は、マウス ポインターが親オブジェクト上に移動したときに自動的に開くわけではありません。  <xref:System.Windows.Controls.Primitives.Popup> が自動的に開くようにする場合は、<xref:System.Windows.Controls.ToolTip> クラスまたは <xref:System.Windows.Controls.ToolTipService> クラスを使用します。  詳細については、「[ToolTip の概要](../../../../docs/framework/wpf/controls/tooltip-overview.md)」を参照してください。  
+  
+<a name="APopupExample"></a>   
+## ポップアップの作成  
+ <xref:System.Windows.Controls.Button> コントロールの子要素である <xref:System.Windows.Controls.Primitives.Popup> コントロールを定義する方法を次の例に示します。  <xref:System.Windows.Controls.Button> が持つことのできる子要素は 1 つだけであるので、この例では、<xref:System.Windows.Controls.Button> コントロールおよび <xref:System.Windows.Controls.Primitives.Popup> コントロールのテキストを <xref:System.Windows.Controls.StackPanel> の中に配置します。  <xref:System.Windows.Controls.Primitives.Popup> のコンテンツは <xref:System.Windows.Controls.TextBlock> コントロールに表示されます。このコントロールのテキストは、アプリケーション ウィンドウ上の、関連付けられた <xref:System.Windows.Controls.Button> コントロールの近くにフロート表示される別のウィンドウに表示されます。  
+  
+ [!code-xml[PopupSimple#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupSimple/CSharp/Window1.xaml#1)]  
+  
+ [!code-xml[PopupSimple#CreatePopupCodeXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupSimple/CSharp/Window1.xaml#createpopupcodexaml)]  
+  
+<a name="PopupUses"></a>   
+## ポップアップを実装するコントロール  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールは、他のコントロールの中に組み込むことができます。  次のコントロールは、特定の使用目的の <xref:System.Windows.Controls.Primitives.Popup> コントロールを実装します。  
+  
+-   <xref:System.Windows.Controls.ToolTip>.  要素のツールヒントを作成する場合は、<xref:System.Windows.Controls.ToolTip> クラスと <xref:System.Windows.Controls.ToolTipService> クラスを使用します。  詳細については、「[ToolTip の概要](../../../../docs/framework/wpf/controls/tooltip-overview.md)」を参照してください。  
+  
+-   <xref:System.Windows.Controls.ContextMenu>.  要素のコンテキスト メニューを作成する場合は、<xref:System.Windows.Controls.ContextMenu> コントロールを使用します。  詳細については、「[ContextMenu の概要](../../../../docs/framework/wpf/controls/contextmenu-overview.md)」を参照してください。  
+  
+-   <xref:System.Windows.Controls.ComboBox>.  表示と非表示の切り替えが可能なドロップダウン リスト ボックスを持つ選択コントロールを作成する場合は、<xref:System.Windows.Controls.ComboBox> コントロールを使用します。  
+  
+-   <xref:System.Windows.Controls.Expander>.  コンテンツを表示するための折りたたみ可能な領域を持つヘッダーを表示するコントロールを作成する場合は、<xref:System.Windows.Controls.Expander> コントロールを使用します。  詳細については、「[エキスパンダーの概要](../../../../docs/framework/wpf/controls/expander-overview.md)」を参照してください。  
+  
+<a name="PopupBehaviorandAppearance"></a>   
+## ポップアップの動作および外観  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールには、その動作および外観をカスタマイズするための機能があります。  たとえば、開く動作と閉じる動作、アニメーション、透過度効果とビットマップ効果、および <xref:System.Windows.Controls.Primitives.Popup> のサイズと位置を設定できます。  
+  
+<a name="OpenandCloseBehavior"></a>   
+### 開く\/閉じるの動作  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールのコンテンツが表示されるのは、<xref:System.Windows.Controls.Primitives.Popup.IsOpen%2A> プロパティが `true` に設定されているときです。  既定の設定では、<xref:System.Windows.Controls.Primitives.Popup.IsOpen%2A> プロパティが `false` に設定されるまでは <xref:System.Windows.Controls.Primitives.Popup> が開いたままになります。  この既定の動作を変更するには、<xref:System.Windows.Controls.Primitives.Popup.StaysOpen%2A> プロパティを `false` に設定します。  このプロパティが `false` に設定されると、<xref:System.Windows.Controls.Primitives.Popup> コンテンツ ウィンドウがマウス キャプチャを持ちます。  <xref:System.Windows.Controls.Primitives.Popup> ウィンドウの外部でマウス イベントが発生すると、<xref:System.Windows.Controls.Primitives.Popup> はマウス キャプチャを失い、ウィンドウが閉じます。  
+  
+ <xref:System.Windows.Controls.Primitives.Popup> コンテンツ ウィンドウが開いたときと閉じたときに、<xref:System.Windows.Controls.Primitives.Popup.Opened> イベントおよび <xref:System.Windows.Controls.Primitives.Popup.Closed> イベントが発生します。  
+  
+<a name="Animation"></a>   
+### アニメーション  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールには、フェード インやスライド インのような動作に関連付けられているアニメーションのサポートが組み込まれています。  このようなアニメーションを有効にするには、<xref:System.Windows.Controls.Primitives.Popup.PopupAnimation%2A> プロパティを <xref:System.Windows.Controls.Primitives.PopupAnimation> 列挙値に設定します。  <xref:System.Windows.Controls.Primitives.Popup> アニメーションを正常に動作させるためには、<xref:System.Windows.Controls.Primitives.Popup.AllowsTransparency%2A> プロパティを `true` に設定する必要があります。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> のようなアニメーションを <xref:System.Windows.Controls.Primitives.Popup> コントロールに適用することもできます。  
+  
+<a name="OpacityandBitmapEffects"></a>   
+### 透過度効果とビットマップ効果  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールの <xref:System.Windows.UIElement.Opacity%2A> プロパティは、コンテンツには影響しません。  既定の設定では、<xref:System.Windows.Controls.Primitives.Popup> コンテンツ ウィンドウは不透明です。  透明の <xref:System.Windows.Controls.Primitives.Popup> を作成するには、<xref:System.Windows.Controls.Primitives.Popup.AllowsTransparency%2A> プロパティを `true` に設定します。  
+  
+ <xref:System.Windows.Controls.Primitives.Popup> のコンテンツは、<xref:System.Windows.Media.Effects.DropShadowBitmapEffect> などのビットマップ効果を継承しません。ビットマップ効果は、<xref:System.Windows.Controls.Primitives.Popup> コントロールに対して直接設定されることも、親ウィンドウのその他の要素に対して設定されることもあります。  ビットマップ効果を <xref:System.Windows.Controls.Primitives.Popup> のコンテンツに反映させるには、ビットマップ効果を直接コンテンツに対して設定する必要があります。  たとえば、<xref:System.Windows.Controls.Primitives.Popup> の子が <xref:System.Windows.Controls.StackPanel> の場合は、<xref:System.Windows.Controls.StackPanel> に対してビットマップ効果を設定します。  
+  
+<a name="PopupSize"></a>   
+### ポップアップのサイズ  
+ 既定の設定では、<xref:System.Windows.Controls.Primitives.Popup> のサイズはコンテンツに合わせて自動的に調整されます。  自動サイズ変更が行われたときに、ビットマップ効果の一部が反映されなくなることがあります。<xref:System.Windows.Controls.Primitives.Popup> のコンテンツに対して定義された画面領域の既定のサイズが、ビットマップ効果を表示するのに十分ではない場合です。  
+  
+ また、コンテンツに対して <xref:System.Windows.UIElement.RenderTransform%2A> を設定した場合も、<xref:System.Windows.Controls.Primitives.Popup> のコンテンツが隠されることがあります。  このシナリオでは、変換後の <xref:System.Windows.Controls.Primitives.Popup> の領域が元の <xref:System.Windows.Controls.Primitives.Popup> の領域よりも広い場合に、一部のコンテンツが非表示になります。  ビットマップ効果または変換のために広い領域が必要な場合は、<xref:System.Windows.Controls.Primitives.Popup> コンテンツの周囲のマージンを定義して、コントロールの領域を広げます。  
+  
+<a name="DefiningPopupPosition"></a>   
+## ポップアップの位置の定義  
+ ポップアップの配置は、<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>、<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>、<xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>、<xref:System.Windows.Controls.Primitives.Popup.VerticalOffsetProperty> の各プロパティを設定して指定できます。  詳細については、「[ポップアップの配置動作](../../../../docs/framework/wpf/controls/popup-placement-behavior.md)」を参照してください。  <xref:System.Windows.Controls.Primitives.Popup> が画面に表示されると、その親の位置が変更された場合でも、それ自体の位置は変更されません。  
+  
+<a name="CustomizingPopupPlacement"></a>   
+### ポップアップの配置のカスタマイズ  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールを表示する位置を、<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A> を基準とする相対座標として指定することで、<xref:System.Windows.Controls.Primitives.Popup> の配置をカスタマイズできます。  
+  
+ 配置をカスタマイズするには、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A> プロパティを <xref:System.Windows.Controls.Primitives.PlacementMode> に設定します。  次に、<xref:System.Windows.Controls.Primitives.Popup> で使用可能な配置ポイントおよび主軸のセット \(優先度順\) を返す <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback> デリゲートを定義します。  <xref:System.Windows.Controls.Primitives.Popup> の最大部分を示すポイントは、自動的に選択されます。  例については、「[ポップアップのカスタム位置を指定する](../../../../docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md)」を参照してください。  
+  
+<a name="PopupandtheVisualTree"></a>   
+## ポップアップとビジュアル ツリー  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールは独自の[ビジュアル ツリー](GTMT)を持たないので、<xref:System.Windows.Controls.Primitives.Popup> の <xref:System.Windows.Controls.Primitives.Popup.MeasureOverride%2A> メソッドが呼び出されると、代わりにサイズ 0 を返します。  ただし、<xref:System.Windows.Controls.Primitives.Popup> の <xref:System.Windows.Controls.Primitives.Popup.IsOpen%2A> プロパティを `true` に設定すると、独自のビジュアル ツリーを持つ新しいウィンドウが作成されます。  新しいウィンドウには、<xref:System.Windows.Controls.Primitives.Popup> の <xref:System.Windows.Controls.Primitives.Popup.Child%2A> コンテンツが表示されます。  新しいウィンドウの幅と高さは、最大で画面の幅または高さの 75% までです。  
+  
+ <xref:System.Windows.Controls.Primitives.Popup> コントロールは、論理上の子として <xref:System.Windows.Controls.Primitives.Popup.Child%2A> コンテンツへの参照を保持します。  新しいウィンドウが作成されたときに、<xref:System.Windows.Controls.Primitives.Popup> のコンテンツはビジュアル ツリー上でウィンドウの子になりますが、<xref:System.Windows.Controls.Primitives.Popup> の論理上の子のままです。  逆に、<xref:System.Windows.Controls.Primitives.Popup> は、<xref:System.Windows.Controls.Primitives.Popup.Child%2A> コンテンツの論理上の親のままです。  
+  
+## 参照  
+ <xref:System.Windows.Controls.Primitives.Popup>   
+ <xref:System.Windows.Controls.Primitives.PopupPrimaryAxis>   
+ <xref:System.Windows.Controls.Primitives.PlacementMode>   
+ <xref:System.Windows.Controls.Primitives.CustomPopupPlacement>   
+ <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback>   
+ <xref:System.Windows.Controls.ToolTip>   
+ <xref:System.Windows.Controls.ToolTipService>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)   
+ [方法のトピック](../../../../docs/framework/wpf/controls/tooltip-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/popup-placement-behavior.md b/docs/framework/wpf/controls/popup-placement-behavior.md
new file mode 100644
index 00000000000..a9525e8c4d1
--- /dev/null
+++ b/docs/framework/wpf/controls/popup-placement-behavior.md
@@ -0,0 +1,238 @@
+---
+title: "ポップアップの配置動作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ポップアップ"
+  - "ポップアップ コントロールを配置します。"
+  - "位置指定 (ポップアップを)"
+  - "配置 (Popup を)"
+ms.assetid: fbf642e9-f670-4efd-a7af-a67468a1c8e1
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ポップアップの配置動作
+A<xref:System.Windows.Controls.Primitives.Popup>コントロールは、アプリケーションで別のウィンドウでコンテンツを表示します。 位置を指定する、<xref:System.Windows.Controls.Primitives.Popup>コントロール、マウス、またはを使用して画面を基準とした、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>、および<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>プロパティです。  これらのプロパティは、柔軟に指定した位置に共同作業、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.ToolTip>と<xref:System.Windows.Controls.ContextMenu>クラスは、またこれら&5; つのプロパティを定義して、同様に動作します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Positioning"></a>   
+## <a name="positioning-the-popup"></a>ポップアップの配置  
+ 配置、<xref:System.Windows.Controls.Primitives.Popup>基準にすることができます、 <xref:System.Windows.UIElement>または画面全体にします。  次の例は、4 つ作成<xref:System.Windows.Controls.Primitives.Popup>基準となるコントロール、 <xref:System.Windows.UIElement>-この場合は、イメージにします。 すべての<xref:System.Windows.Controls.Primitives.Popup>コントロールがある、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>プロパティに設定`image1`が各<xref:System.Windows.Controls.Primitives.Popup>が配置プロパティの値が異なる。  
+  
+ [!code-xml[PopupPositionSnippet#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS/Window1.xaml#3)]  
+  
+ 次の図は、イメージ、および<xref:System.Windows.Controls.Primitives.Popup>コントロール  
+  
+ ![次の&4; つのポップアップ コントロールを含むイメージ](../../../../docs/framework/wpf/controls/media/popupplacementintro.png "PopupPlacementIntro")  
+次の&4; つのポップアップを持つイメージ  
+  
+ この簡単な例を設定する方法を示しています、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>と<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>プロパティを使用して、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>、および<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>プロパティ、where より詳細に制御がある、<xref:System.Windows.Controls.Primitives.Popup>が配置されています。  
+  
+<a name="Definitions"></a>   
+## <a name="definitions-of-terms-the-anatomy-of-a-popup"></a>用語の定義: ポップアップの構造  
+ 次の用語は理解するに役立つ方法、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>、および<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>プロパティが相互に関連付けると、<xref:System.Windows.Controls.Primitives.Popup>:  
+  
+-   ターゲット オブジェクト  
+  
+-   ターゲット領域  
+  
+-   ターゲットの基準  
+  
+-   ポップアップ配置ポイント  
+  
+ これらの用語のさまざまな側面を参照する便利な手段を提供する、<xref:System.Windows.Controls.Primitives.Popup>と関連付けられているコントロール。  
+  
+### <a name="target-object"></a>ターゲット オブジェクト  
+ *ターゲット オブジェクト*要素を<xref:System.Windows.Controls.Primitives.Popup>に関連付けられています。 場合、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>プロパティが設定されて、ターゲット オブジェクトを指定します。  場合<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>が設定されていないと、<xref:System.Windows.Controls.Primitives.Popup>親を持つ親は、ターゲット オブジェクト。  ある場合なし<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>値と、親ターゲット オブジェクトが存在しないと、<xref:System.Windows.Controls.Primitives.Popup>画面を基準に配置します。  
+  
+ 次の例を作成し、<xref:System.Windows.Controls.Primitives.Popup>の子は、<xref:System.Windows.Controls.Canvas>します。  この例では設定しません、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>プロパティを<xref:System.Windows.Controls.Primitives.Popup>します。 既定値<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode?displayProperty=fullName>ので、<xref:System.Windows.Controls.Primitives.Popup>の下に表示、<xref:System.Windows.Controls.Canvas>します。  
+  
+ [!code-xml[PopupPositionSnippet#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS/Window1.xaml#1)]  
+  
+ 次の図を表示する、<xref:System.Windows.Controls.Primitives.Popup>に対して相対的な位置、<xref:System.Windows.Controls.Canvas>します。  
+  
+ ![Placementtarget のないポップアップ コントロール](../../../../docs/framework/wpf/controls/media/popupplacementnoplacementtarget.png "PopupPlacementNoPlacementTarget")  
+Placementtarget のないポップアップ  
+  
+ 次の例を作成し、<xref:System.Windows.Controls.Primitives.Popup>の子は、<xref:System.Windows.Controls.Canvas>、今度は、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>に設定されている`ellipse1`下に、ポップアップが表示されますので、<xref:System.Windows.Shapes.Ellipse>します。  
+  
+ [!code-xml[PopupPositionSnippet#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS/Window1.xaml#2)]  
+  
+ 次の図を表示する、<xref:System.Windows.Controls.Primitives.Popup>に対して相対的な位置、<xref:System.Windows.Shapes.Ellipse>します。  
+  
+ ![楕円に相対的に配置されるポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementwithplacementtarget.png "PopupPlacementWithPlacementTarget")  
+Placementtarget のポップアップ  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.ToolTip>、既定値の<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>します。  <xref:System.Windows.Controls.ContextMenu>、既定値の<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>します。 これらの値が「どのようにプロパティの連携します」で、後で説明しました。  
+  
+### <a name="target-area"></a>ターゲット領域  
+ *ターゲット領*は画面上の領域を<xref:System.Windows.Controls.Primitives.Popup>に相対的であります。 前の例で、<xref:System.Windows.Controls.Primitives.Popup>は場合によっては、ターゲット オブジェクトの境界に揃えられます、<xref:System.Windows.Controls.Primitives.Popup>は他の境界に配置場合でも、<xref:System.Windows.Controls.Primitives.Popup>ターゲット オブジェクトが存在します。  場合、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>プロパティが設定されて、対象となる領域はターゲット オブジェクトの境界とは異なる、できます。  
+  
+ 次の例では、2 つ作成されます<xref:System.Windows.Controls.Canvas>オブジェクト、1 つを含む、<xref:System.Windows.Shapes.Rectangle>と<xref:System.Windows.Controls.Primitives.Popup>します。  どちらの場合も、対象のオブジェクトを<xref:System.Windows.Controls.Primitives.Popup>は、<xref:System.Windows.Controls.Canvas>します。 <xref:System.Windows.Controls.Primitives.Popup>最初の<xref:System.Windows.Controls.Canvas>が、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>によって設定、 <xref:System.Windows.Rect.X%2A>、 <xref:System.Windows.Rect.Y%2A>、<xref:System.Windows.Rect.Width%2A>、および<xref:System.Windows.Rect.Height%2A>プロパティがそれぞれ 50 件、50、50 と 100 に設定します。 <xref:System.Windows.Controls.Primitives.Popup>2 番目の<xref:System.Windows.Controls.Canvas>が、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>を設定します。  その結果、最初の<xref:System.Windows.Controls.Primitives.Popup>の下にある、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> 、2 番目<xref:System.Windows.Controls.Primitives.Popup>の下にある、<xref:System.Windows.Controls.Canvas>します。 各<xref:System.Windows.Controls.Canvas>も含まれています、<xref:System.Windows.Shapes.Rectangle>と同じ境界を持つ、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A> 、最初の<xref:System.Windows.Controls.Primitives.Popup>します。  注意してください、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>アプリケーションで表示されている要素を作成できません例を作成し、<xref:System.Windows.Shapes.Rectangle>を表す、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>します。  
+  
+ [!code-xml[PopupPositionSnippet#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS/Window1.xaml#4)]  
+  
+ 次の図は、前の例の結果を示しています。  
+  
+ ![ポップアップと PlacementRectangle なし](../../../../docs/framework/wpf/controls/media/popupplacementplacementrectangle.png "PopupPlacementPlacementRectangle")  
+PlacementRectangle がある (またはない) ポップアップ  
+  
+### <a name="target-origin-and-popup-alignment-point"></a>ターゲットの基点とポップアップ配置ポイント  
+ *オリジンをターゲット*と*ポップアップ配置ポイント*は、対象となる領域とポップアップで、上の参照点をそれぞれを配置するために使用されています。 使用することができます、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>と<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>プロパティを対象となる領域からポップアップをオフセットします。  <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>と<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>はターゲットの基点とポップアップ配置ポイントを基準としています。 値、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>プロパティは、ターゲットの基準とポップアップ配置ポイントがある場所を決定します。  
+  
+ 次の例を作成し、<xref:System.Windows.Controls.Primitives.Popup>し、設定、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>と<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>プロパティを 20 にします。  <xref:System.Windows.Controls.Primitives.Popup.Placement%2A>にプロパティが設定されている<xref:System.Windows.Controls.Primitives.PlacementMode>(既定)、のでターゲットの基準は、対象となる領域の左下隅で、ポップアップ配置ポイントの左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ [!code-xml[PopupPositionSnippet#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PopupPositionSnippet/CS/Window1.xaml#5)]  
+  
+ 次の図は、前の例の結果を示しています。  
+  
+ ![ターゲット開始点の配置ポイントを含むポップアップ配置](../../../../docs/framework/wpf/controls/media/popupplacementtargetoriginalignmentpoint.PNG "PopupPlacementTargetOriginAlignmentPoint")  
+HorizontalOffset と VerticalOffset を含むポップアップ  
+  
+<a name="How"></a>   
+## <a name="how-the-properties-work-together"></a>プロパティがどのように連携  
+ 値<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>、および<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>か、適切なターゲットの領域、ターゲットの出発地とポップアップ配置ポイントを一緒に考慮する必要があります。  などの場合の値<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>、ターゲット オブジェクトが存在しない、 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>は無視され、対象領域で、マウス ポインターの境界。 その一方で場合、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>、 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>親は、ターゲット オブジェクトを決定したりと<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>対象領域を決定します。  
+  
+ 次の表に、対象のオブジェクト、ターゲットの領域、ターゲットの基準、およびポップアップ配置ポイントを説明を示し、かどうか<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>と<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ごとに使用される<xref:System.Windows.Controls.Primitives.PlacementMode>列挙値。  
+  
+|PlacementMode|ターゲット オブジェクト|ターゲット領域|ターゲットの基準|ポップアップ配置ポイント|  
+|-------------------|-------------------|-----------------|-------------------|---------------------------|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|該当なし。 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>は無視されます。|画面または<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>画面に対する相対パスです。|対象となる領域の左上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|該当なし。 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>は無視されます。|画面または<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>画面に対する相対パスです。|対象となる領域の左上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の左下隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の中心です。|中央、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|定義される、 <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback>します。|定義される、 <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の左上隅です。|右上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|該当なし。 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>は無視されます。|マウス ポインターの境界。 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>は無視されます。|対象となる領域の左下隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|該当なし。 <xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>は無視されます。|マウス ポインターの境界。 <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>は無視されます。|対象となる領域の左上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の左上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の左上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の右上隅です。|左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|<xref:System.Windows.Controls.Primitives.Popup.PlacementTarget%2A>または親。|ターゲット オブジェクトまたは<xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>設定されている場合。  <xref:System.Windows.Controls.Primitives.Popup.PlacementRectangle%2A>ターゲット オブジェクトに対する相対パスです。|対象となる領域の左上隅です。|左下隅、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+  
+ 次の図に示さ、<xref:System.Windows.Controls.Primitives.Popup>、対象となる領域、ターゲットの基準、およびポップアップ配置ポイントごとに<xref:System.Windows.Controls.Primitives.PlacementMode>値。 各図では、対象となる領域は黄色、および<xref:System.Windows.Controls.Primitives.Popup>は青です。  
+  
+ ![Absolute または AbsolutePoint 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementabsolute.png "PopupPlacementAbsolute")  
+Absolute または AbsolutePoint 配置が、します。  
+  
+ ![Bottom 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementbottom.png "PopupPlacementBottom")  
+配置は、下部にあります。  
+  
+ ![Center 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementcenter.png "PopupPlacementCenter")  
+配置はセンター  
+  
+ ![Left 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementleft.png "PopupPlacementLeft")  
+配置は、左  
+  
+ ![Mouse 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementmouse.png "PopupPlacementMouse")  
+配置は、マウス  
+  
+ ![MousePoint 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementmousepoint.png "PopupPlacementMousePoint")  
+配置は MousePoint  
+  
+ ![Relative または RelativePoint 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementrelative.png "PopupPlacementRelative")  
+Relative または RelativePoint 配置が、します。  
+  
+ ![Right 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementright.png "PopupPlacementRight")  
+配置は、右  
+  
+ ![Top 配置を含むポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementtop.png "PopupPlacementTop")  
+一番上の配置  
+  
+<a name="When"></a>   
+## <a name="when-the-popup-encounters-the-edge-of-the-screen"></a>ポップアップが画面の端を検出した場合  
+ セキュリティ上の理由、<xref:System.Windows.Controls.Primitives.Popup>画面の端で非表示にすることはできません。 次の&3; つのいずれかが発生時に、<xref:System.Windows.Controls.Primitives.Popup>画面の端が発生しました。  
+  
+-   ポップアップ ウィンドウが隠れてしまわないように画面の端に沿った realigns 自体、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+-   別のポップアップ配置ポイントを使用します。  
+  
+-   別のターゲットの基準とポップアップ配置ポイントを使用します。  
+  
+ これらのオプションは、後でするこのセクションで詳しく説明します。  
+  
+ 動作、<xref:System.Windows.Controls.Primitives.Popup>画面の端がの値に依存を見つけたときに、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>プロパティと画面の端のポップアップが発生しました。 次の表に、動作と、<xref:System.Windows.Controls.Primitives.Popup>各画面の端を検出した<xref:System.Windows.Controls.Primitives.PlacementMode>値。  
+  
+|PlacementMode|上端|下端|左端|右の端|  
+|-------------------|--------------|-----------------|---------------|----------------|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|下端に揃えます。|左端に揃えます。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|左下隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|左端に揃えます。|右上隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|ターゲットの基準が対象となる領域の左上隅に変更されの左下隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|左端に揃えます。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|下端に揃えます。|左端に揃えます。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|下端に揃えます。|ターゲットの基準を対象となる領域の右上隅に変更し、ポップアップ配置ポイントに変更の左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|ターゲットの領域 (マウス ポインターの範囲) の左上隅にターゲットの基準が変わりの左下隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|左端に揃えます。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|左下隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|左端に揃えます。|ポップアップの配置は、変更をポップアップの右上隅をポイントします。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|下端に揃えます。|左端に揃えます。|右端に揃えます。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|左下隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|左端に揃えます。|ポップアップの配置は、変更をポップアップの右上隅をポイントします。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|上端に揃えます。|下端に揃えます。|左端に揃えます。|ターゲットの基準が対象となる領域の左上隅に変更されの右上隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。|  
+|<xref:System.Windows.Controls.Primitives.PlacementMode>|ターゲットの基準が対象となる領域の左下隅に変更されの左上隅にポップアップ配置ポイントを変更、<xref:System.Windows.Controls.Primitives.Popup>します。 これは有効にする場合と同じ<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>します。|下端に揃えます。|左端に揃えます。|右端に揃えます。|  
+  
+### <a name="aligning-to-the-screen-edge"></a>画面の端の整列  
+ A<xref:System.Windows.Controls.Primitives.Popup>に揃えて配置できます、画面の端にので自体を再配置して全体<xref:System.Windows.Controls.Primitives.Popup>画面に表示されます。  値からターゲットの基準とポップアップ配置ポイント間の距離が異なる場合がありますこのとき、 <xref:System.Windows.Controls.Primitives.Popup.HorizontalOffset%2A>と<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>します。 <xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>、 <xref:System.Windows.Controls.Primitives.PlacementMode>、または<xref:System.Windows.Controls.Primitives.PlacementMode>、<xref:System.Windows.Controls.Primitives.Popup>自体をすべて画面端に配置します。  たとえば、あると想定して、<xref:System.Windows.Controls.Primitives.Popup>が<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>に設定<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup.VerticalOffset%2A>を 100 に設定します。  画面の下端の全部または一部を非表示にする場合、<xref:System.Windows.Controls.Primitives.Popup>、<xref:System.Windows.Controls.Primitives.Popup>自体を再配置、画面とターゲットの基準とポップアップの垂直方向の距離の下端に沿って配置ポイントには 100 未満です。 次の図では、これを示します。  
+  
+ ![画面の端に配置されるポップアップ](../../../../docs/framework/wpf/controls/media/popupplacementrelativescreenedge.png "PopupPlacementRelativeScreenEdge")  
+ポップアップが画面の端に配置します。  
+  
+### <a name="changing-the-popup-alignment-point"></a>ポップアップ配置ポイントを変更します。  
+ 場合<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>、 <xref:System.Windows.Controls.Primitives.PlacementMode>、または<xref:System.Windows.Controls.Primitives.PlacementMode>、ポップアップ配置ポイントが下または右側の画面の端を検出すると、ポップアップを変更します。  
+  
+ ときに、画面の下端の全部または一部を非表示にすると、次の図は、プログラムことを示します、<xref:System.Windows.Controls.Primitives.Popup>、ポップアップ配置ポイントの左下隅は、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の下端による新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementrelativepointscreenedge.png "PopupPlacementRelativePointScreenEdge")  
+ポップアップは画面の下端を検出し、ポップアップ配置ポイントを変更  
+  
+ 次の図に示す時に、<xref:System.Windows.Controls.Primitives.Popup>を非表示にポップアップ配置ポイントの右上隅を画面の右端で、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の端による新しいポップアップ配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementrelativepointrightscreenedge.png "PopupPlacementRelativePointRightScreenEdge")  
+ポップアップは画面の右端を検出し、ポップアップ配置ポイントを変更  
+  
+ 場合、<xref:System.Windows.Controls.Primitives.Popup>下部と画面の右端のエッジが発生したポップアップ配置ポイントは、の右下隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+### <a name="changing-the-target-origin-and-popup-alignment-point"></a>ターゲットの基準とポップアップ配置ポイントを変更します。  
+ ときに<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>、<xref:System.Windows.Controls.Primitives.PlacementMode>、<xref:System.Windows.Controls.Primitives.PlacementMode>、<xref:System.Windows.Controls.Primitives.PlacementMode>、または<xref:System.Windows.Controls.Primitives.PlacementMode>、特定の画面の端が発生した場合、ターゲットの基準とポップアップの配置が変更をポイントします。  位置を変更すると、画面の端が異なります、 <xref:System.Windows.Controls.Primitives.PlacementMode>値。  
+  
+ 次の図に示す時に<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup>下部にある画面の端を検出したターゲットの基準は、対象となる領域の左上隅で、ポップアップ配置ポイントの左下隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の下端による新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementbottomscreenedge.png "PopupPlacementBottomScreenEdge")  
+配置は、下部にあると、ポップアップが画面の下端を検出しました。  
+  
+ 次の図をすることを示しています<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup>画面の左端を検出したターゲットの基準は、対象となる領域の右上隅で、ポップアップ配置ポイントの左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の左端による新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementleftscreenedge.png "PopupPlacementLeftScreenEdge")  
+配置は、左とポップアップが画面の左端を検出しました。  
+  
+ 次の図をすることを示しています<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup>画面の右端を検出したターゲットの基準は、対象となる領域の左上隅で、ポップアップ配置ポイントの右上隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の右端による新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementrightscreenedge.png "PopupPlacementRightScreenEdge")  
+配置が右で、ポップアップが画面の右端を検出しました。  
+  
+ 次の図をすることを示しています<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup>画面の上端を検出したターゲットの基準は、対象となる領域の左下隅で、ポップアップ配置ポイントの左上隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の上端による新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementtopscreenedge.png "PopupPlacementTopScreenEdge")  
+配置は、上と、ポップアップが画面の上端を検出しました。  
+  
+ 次の図に示す時に<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>は<xref:System.Windows.Controls.Primitives.PlacementMode>と<xref:System.Windows.Controls.Primitives.Popup>下部にある画面の端を検出したターゲットの基準 (マウス ポインターの範囲) の対象となる領域の左上隅で、ポップアップ配置ポイントの左下隅、<xref:System.Windows.Controls.Primitives.Popup>します。  
+  
+ ![画面の端に近いマウスによる新しい配置ポイント](../../../../docs/framework/wpf/controls/media/popupplacementmousescreenedge.png "PopupPlacementMouseScreenEdge")  
+配置は、マウスとポップアップが画面の下端を検出しました。  
+  
+### <a name="customizing-popup-placement"></a>ポップアップの配置をカスタマイズします。  
+ ターゲットの基準とポップアップ配置ポイントをカスタマイズするには設定して、<xref:System.Windows.Controls.Primitives.Popup.Placement%2A>プロパティを<xref:System.Windows.Controls.Primitives.PlacementMode>します。 定義し、 <xref:System.Windows.Controls.Primitives.CustomPopupPlacementCallback>のような配置ポイントと (優先順位) でプライマリ軸のセットを返すデリゲート、<xref:System.Windows.Controls.Primitives.Popup>します。 ポイントの最大の部分を示す、<xref:System.Windows.Controls.Primitives.Popup>が選択されています。  位置、<xref:System.Windows.Controls.Primitives.Popup>場合に自動的に調整、<xref:System.Windows.Controls.Primitives.Popup>は画面の端で非表示です。 例については、次を参照してください。[カスタム ポップアップの位置を指定する](../../../../docs/framework/wpf/controls/how-to-specify-a-custom-popup-position.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [ポップアップの配置のサンプル](http://go.microsoft.com/fwlink/?LinkID=160032)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/popup.md b/docs/framework/wpf/controls/popup.md
new file mode 100644
index 00000000000..84734c3a3af
--- /dev/null
+++ b/docs/framework/wpf/controls/popup.md
@@ -0,0 +1,41 @@
+---
+title: "ポップアップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], Popup コントロール"
+  - "コントロール [WPF], ポップアップ"
+  - "ポップアップ コントロール [WPF]"
+  - "Popup [WPF]"
+ms.assetid: 36a4320f-91ce-4f5f-9621-7934de3eff77
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# ポップアップ
+<xref:System.Windows.Controls.Primitives.Popup> コントロールは、現在のアプリケーション ウィンドウの上にフロート表示される個別のウィンドウにコンテンツを表示します。  
+  
+ 次の図では、<xref:System.Windows.Controls.Primitives.Popup> コントロールが、親である <xref:System.Windows.Controls.Button> を基準として配置されています。  
+  
+ ![ポップアップの図](../../../../docs/framework/wpf/controls/media/popuppicture.JPG "PopupPicture")  
+  
+## このセクションの内容  
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)  
+ [ポップアップの配置動作](../../../../docs/framework/wpf/controls/popup-placement-behavior.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.Popup>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/position-the-cursor-at-the-beginning-or-end-of-text.md b/docs/framework/wpf/controls/position-the-cursor-at-the-beginning-or-end-of-text.md
new file mode 100644
index 00000000000..0800eee2a8e
--- /dev/null
+++ b/docs/framework/wpf/controls/position-the-cursor-at-the-beginning-or-end-of-text.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : TextBox コントロールのテキストの先頭または末尾にカーソルを配置する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配置 (カーソルを)"
+  - "テキスト ボックス コントロールをカーソルの位置"
+  - "カーソル位置"
+ms.assetid: c771a0b8-c6b4-4240-aecd-a21d0ba51a2e
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : TextBox コントロールのテキストの先頭または末尾にカーソルを配置する
+この例では、先頭または末尾のテキスト コンテンツにカーソルを配置、 <xref:System.Windows.Controls.TextBox>コントロールです。  
+  
+## <a name="example"></a>例  
+ 次[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]コードについて説明します、 <xref:System.Windows.Controls.TextBox>を制御し、名前を割り当てます。  
+  
+ [!code-xml[TextBox_MiscCode#_MoveCursorXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_movecursorxaml)]  
+  
+## <a name="example"></a>例  
+ 内容の先頭にカーソルを配置する、 <xref:System.Windows.Controls.TextBox>コントロールを呼び出す、<xref:System.Windows.Controls.TextBox.Select%2A>メソッドし、選択範囲の開始位置に 0、および選択範囲の長さは 0 を指定します。  
+  
+ [!code-csharp[TextBox_MiscCode#_CursorToStart](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_cursortostart)]
+ [!code-vb[TextBox_MiscCode#_CursorToStart](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_cursortostart)]  
+  
+## <a name="example"></a>例  
+ 内容の末尾にカーソルを配置する、 <xref:System.Windows.Controls.TextBox>コントロールを呼び出す、<xref:System.Windows.Controls.TextBox.Select%2A>メソッドし、コンテンツのテキストの長さと選択範囲の長さは 0 に等しく選択の開始位置を指定します。  
+  
+ [!code-csharp[TextBox_MiscCode#_CursorToEnd](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml.cs#_cursortoend)]
+ [!code-vb[TextBox_MiscCode#_CursorToEnd](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBox_MiscCode/VisualBasic/Window1.xaml.vb#_cursortoend)]  
+  
+## <a name="see-also"></a>関連項目  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/printdialog.md b/docs/framework/wpf/controls/printdialog.md
new file mode 100644
index 00000000000..b6049902327
--- /dev/null
+++ b/docs/framework/wpf/controls/printdialog.md
@@ -0,0 +1,37 @@
+---
+title: "PrintDialog | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], PrintDialog"
+  - "印刷ダイアログ ボックス [WPF], PrintDialog コントロール"
+  - "PrintDialog コントロール [WPF]"
+ms.assetid: 0ce9e3e7-206f-45ec-b845-4c05cfb5ff1d
+caps.latest.revision: 74
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 74
+---
+# PrintDialog
+<xref:System.Windows.Controls.PrintDialog> コントロールは、ユーザー入力に従って <xref:System.Printing.PrintTicket> と <xref:System.Printing.PrintQueue> を自動的に構成する標準の印刷ダイアログ ボックスをインスタンス化するために使用します。  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.PrintDialog>  
+  
+ <xref:System.Printing.PrintTicket>  
+  
+ <xref:System.Printing.PrintQueue>  
+  
+## 参照  
+ [印刷の概要](../../../../docs/framework/wpf/advanced/printing-overview.md)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/progressbar-styles-and-templates.md b/docs/framework/wpf/controls/progressbar-styles-and-templates.md
new file mode 100644
index 00000000000..9d49fb1e22b
--- /dev/null
+++ b/docs/framework/wpf/controls/progressbar-styles-and-templates.md
@@ -0,0 +1,67 @@
+---
+title: "ProgressBar のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ProgressBar"
+  - "パーツ [WPF], ProgressBar"
+  - "ProgressBar [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], ProgressBar"
+  - "スタイル [WPF], ProgressBar"
+  - "テンプレート [WPF], ProgressBar"
+ms.assetid: 935aa600-16e6-4947-a905-37a189a583dd
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# ProgressBar のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ProgressBar> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ProgressBar のパーツ  
+ 次の表は、<xref:System.Windows.Controls.ProgressBar> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Indicator|<xref:System.Windows.FrameworkElement>|進行状況を示すオブジェクトです。|  
+|PART\_Track|<xref:System.Windows.FrameworkElement>|プログレス インジケーターのパスを定義するオブジェクトです。|  
+|PART\_GlowRect|<xref:System.Windows.FrameworkElement>|プログレス バーを拡張するオブジェクトです。|  
+  
+## ProgressBar の状態  
+ 次の表は、<xref:System.Windows.Controls.ProgressBar> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Determinate|CommonStates|<xref:System.Windows.Controls.ProgressBar> は <xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> プロパティに基づいて進行状況を報告します。|  
+|Indeterminate|CommonStates|<xref:System.Windows.Controls.ProgressBar> は繰り返しパターンを使用して一般的な進行状況を報告します。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ProgressBar ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ProgressBar> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ProgressBar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/progressbar.xaml#progressbar)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/progressbar.md b/docs/framework/wpf/controls/progressbar.md
new file mode 100644
index 00000000000..032c69148b4
--- /dev/null
+++ b/docs/framework/wpf/controls/progressbar.md
@@ -0,0 +1,37 @@
+---
+title: "ProgressBar | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ProgressBar"
+  - "ProgressBar コントロール [WPF]"
+ms.assetid: 4545b358-b93c-47df-88e4-9946d7db9e3f
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# ProgressBar
+<xref:System.Windows.Controls.ProgressBar> は、操作の進行状況を示します。  <xref:System.Windows.Controls.ProgressBar> コントロールは、処理の進行状況に合わせてシステムの強調表示色で塗りつぶされていくウィンドウで構成されます。  
+  
+ 次の図は、標準的な <xref:System.Windows.Controls.ProgressBar> です。  
+  
+ ![進行状況バー](../../../../docs/framework/wpf/controls/media/ss-ctl-progressbar.png "SS\_CTL\_progressbar")  
+  
+## このセクションの内容  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ProgressBar>  
+ <xref:System.Windows.Controls.Primitives.StatusBar>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/radiobutton-styles-and-templates.md b/docs/framework/wpf/controls/radiobutton-styles-and-templates.md
new file mode 100644
index 00000000000..72515b18800
--- /dev/null
+++ b/docs/framework/wpf/controls/radiobutton-styles-and-templates.md
@@ -0,0 +1,67 @@
+---
+title: "RadioButton のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], RadioButton"
+  - "パーツ [WPF], RadioButton"
+  - "RadioButton [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], RadioButton"
+  - "スタイル [WPF], RadioButton"
+  - "テンプレート [WPF], RadioButton"
+ms.assetid: 9acf93f7-dd2f-4010-8ce0-1edd81c52ae2
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# RadioButton のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.RadioButton> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## RadioButton のパーツ  
+ <xref:System.Windows.Controls.RadioButton> コントロールには、名前付きのパーツは存在しません。  
+  
+## RadioButton の状態  
+ 次の表は、<xref:System.Windows.Controls.RadioButton> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|オン|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `true` なので、|  
+|Unchecked|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `false` なので、|  
+|Indeterminate|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsThreeState%2A> が `true` で、<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> が `null` です。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## RadioButton ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.RadioButton> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#RadioButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/radiobutton.xaml#radiobutton)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/radiobutton.md b/docs/framework/wpf/controls/radiobutton.md
new file mode 100644
index 00000000000..b407122d148
--- /dev/null
+++ b/docs/framework/wpf/controls/radiobutton.md
@@ -0,0 +1,35 @@
+---
+title: "RadioButton | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], RadioButton"
+  - "RadioButton コントロール [WPF]"
+ms.assetid: 6c9ba847-eab7-4bba-9c74-6b56ef72067b
+caps.latest.revision: 66
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 66
+---
+# RadioButton
+<xref:System.Windows.Controls.RadioButton> コントロールは、通常はいくつかを 1 つのグループにまとめて使用し、ユーザーは複数の選択肢の中から 1 つを選択できます。一度に選択できるボタンは 1 つだけです。  
+  
+ <xref:System.Windows.Controls.RadioButton> コントロールの例を次の図に示します。  
+  
+ ![オプション ボタンの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-radiobuttons.gif "SS\_CTL\_radiobuttons")  
+一般的な RadioButton  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.ToggleButton>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/repeatbutton-syles-and-templates.md b/docs/framework/wpf/controls/repeatbutton-syles-and-templates.md
new file mode 100644
index 00000000000..6f143c56964
--- /dev/null
+++ b/docs/framework/wpf/controls/repeatbutton-syles-and-templates.md
@@ -0,0 +1,65 @@
+---
+title: "RepeatButton のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], RepeatButton"
+  - "パーツ [WPF], RepeatButton"
+  - "RepeatButton [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], RepeatButton"
+  - "スタイル [WPF], RepeatButton"
+  - "テンプレート [WPF], RepeatButton"
+ms.assetid: fd340743-f44f-4990-9077-085301469670
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# RepeatButton のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Primitives.RepeatButton> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## RepeatButton のパーツ  
+ <xref:System.Windows.Controls.Primitives.RepeatButton> コントロールには、名前付きのパーツは存在しません。  
+  
+## RepeatButton の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.RepeatButton> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## RepeatButton ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Primitives.RepeatButton> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#RepeatButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/scrollbar.xaml#repeatbutton)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/repeatbutton.md b/docs/framework/wpf/controls/repeatbutton.md
new file mode 100644
index 00000000000..3ff03954910
--- /dev/null
+++ b/docs/framework/wpf/controls/repeatbutton.md
@@ -0,0 +1,37 @@
+---
+title: "RepeatButton | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], RepeatButton"
+  - "RepeatButton コントロール [WPF]"
+ms.assetid: 5702b603-95e6-438a-88c0-76509367e876
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# RepeatButton
+<xref:System.Windows.Controls.Primitives.RepeatButton> は、<xref:System.Windows.Controls.Button> に似ています。  ただし、<xref:System.Windows.Controls.Primitives.RepeatButton> 要素を使用することで、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントが発生するタイミングと方法を制御することができます。  
+  
+ 次の図は、Default、PointerFocused、Pressed という、リピート ボタン コントロールの 3 種類の状態を示します。  最初のボタンは、<xref:System.Windows.Controls.Primitives.RepeatButton> の既定の状態を示しています。  2 番目のボタンは、マウス ポインターがボタンの上に置かれ、フォーカスが与えられたときに、ボタンの外観がどのように変化するかを示しています。  最後のボタンは、ユーザーがコントロールの上でマウス ボタンを押したときの、<xref:System.Windows.Controls.Primitives.RepeatButton> の外観を示しています。  
+  
+ ![&#91;繰り返し&#93; ボタンの状態](../../../../docs/framework/wpf/controls/media/ss-ctl-repeatbutton.png "SS\_CTL\_repeatbutton")  
+一般的な RepeatButton  
+  
+## このセクションの内容  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.RepeatButton>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/richtextbox-how-to-topics.md b/docs/framework/wpf/controls/richtextbox-how-to-topics.md
new file mode 100644
index 00000000000..b93be1f3d61
--- /dev/null
+++ b/docs/framework/wpf/controls/richtextbox-how-to-topics.md
@@ -0,0 +1,37 @@
+---
+title: "RichTextBox に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, RichTextBox"
+  - "RichTextBox コントロール [WPF], 方法トピック"
+ms.assetid: 36e9f98e-f968-42d8-adb6-9e78c814aec0
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# RichTextBox に関する「方法」トピック
+このセクションでは、<xref:System.Windows.Controls.RichTextBox> コントロールを使用して一般的なタスクを実行する方法を、いくつかの例で示します。  
+  
+## このセクションの内容  
+ [RichTextBox からテキスト コンテンツを抽出する](../../../../docs/framework/wpf/controls/how-to-extract-the-text-content-from-a-richtextbox.md)  
+ [プログラムによる RichTextBox での選択の変更](../../../../docs/framework/wpf/controls/change-selection-in-a-richtextbox-programmatically.md)  
+ [RichTextBox コンテンツの保存、読み込み、および印刷](../../../../docs/framework/wpf/controls/how-to-save-load-and-print-richtextbox-content.md)  
+ [カスタム コンテキスト メニューを RichTextBox に配置する](../../../../docs/framework/wpf/controls/how-to-position-a-custom-context-menu-in-a-richtextbox.md)  
+ [How to: Replace the Default Content Host for a RichTextBox](http://msdn.microsoft.com/ja-jp/dec1b2ce-9ca5-4bb2-bf54-f8a80a3c8beb)  
+  
+## 参照  
+ <xref:System.Windows.Controls.TextBox>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/richtextbox-overview.md b/docs/framework/wpf/controls/richtextbox-overview.md
new file mode 100644
index 00000000000..76df49a84c8
--- /dev/null
+++ b/docs/framework/wpf/controls/richtextbox-overview.md
@@ -0,0 +1,104 @@
+---
+title: "RichTextBox の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, RichTextBox"
+  - "RichTextBox コントロール [WPF], RichTextBox コントロールの概要"
+ms.assetid: c94548b2-c1e9-4b62-b10c-dd8740eb23d8
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# RichTextBox の概要
+<xref:System.Windows.Controls.RichTextBox> コントロールを使用すると、段落、イメージ、テーブルなどのフロー コンテンツを表示または編集できます。  このトピックでは、<xref:System.Windows.Controls.TextBox> クラスについて説明し、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] と [!INCLUDE[TLA#tla_lhcshrp](../../../../includes/tlasharptla-lhcshrp-md.md)] の両方で使用する例を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="textbox_or_richtextbox"></a>   
+## TextBox と RichTextBox  
+ <xref:System.Windows.Controls.RichTextBox> と <xref:System.Windows.Controls.TextBox> のどちらを使用してもテキストを編集できますが、2 つのコントロールは異なるシナリオで使用されます。  <xref:System.Windows.Controls.RichTextBox> は、書式設定されたテキスト、イメージ、テーブル、またはその他のリッチ コンテンツを編集する必要がある場合に適しています。  たとえば、書式設定やイメージなどが必要なドキュメント、記事、またはブログを編集する場合は、<xref:System.Windows.Controls.RichTextBox> を使用することをお勧めします。  <xref:System.Windows.Controls.TextBox> で必要なシステム リソースは <xref:System.Windows.Controls.RichTextBox> よりも少ないため、プレーンテキストのみを編集する必要がある場合 \(  フォームでの使用\) に適しています。  <xref:System.Windows.Controls.TextBox> の詳細については、「[TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)」を参照してください。  <xref:System.Windows.Controls.TextBox> および <xref:System.Windows.Controls.RichTextBox> の主要な機能を次の表にまとめます。  
+  
+|Control|リアルタイム スペル チェック|コンテキスト メニュー|<xref:System.Windows.Documents.EditingCommands.ToggleBold%2A> \(Ctrl \+ B\) などの書式設定コマンド|イメージ、段落、テーブルなどの <xref:System.Windows.Documents.FlowDocument> コンテンツ|  
+|-------------|---------------------|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Windows.Controls.TextBox>|○|○|Ｘ|いいえ。|  
+|<xref:System.Windows.Controls.RichTextBox>|○|○|○|○|  
+  
+ **メモ :** <xref:System.Windows.Controls.TextBox> では <xref:System.Windows.Documents.EditingCommands.ToggleBold%2A> \(Ctrl \+ B\) などの書式設定関連のコマンドはサポートされませんが、<xref:System.Windows.Documents.EditingCommands.MoveToLineEnd%2A> などのさまざまな基本コマンドが両方のコントロールでサポートされています。  
+  
+ 上の表に示した機能については、後で詳しく説明します。  
+  
+<a name="creating_a_richtextbox"></a>   
+## RichTextBox の作成  
+ 次のコードでは、ユーザーがリッチ コンテンツを編集できる <xref:System.Windows.Controls.RichTextBox> を作成する方法を示します。  
+  
+ [!code-xml[RichTextBoxMiscSnippets_snip#BasicRichTextBoxExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/BasicRichTextBoxExample.xaml#basicrichtextboxexamplewholepage)]  
+  
+ 具体的に言えば、<xref:System.Windows.Controls.RichTextBox> で編集されるコンテンツはフロー コンテンツです。  フロー コンテンツには、書式設定されたテキスト、イメージ、リスト、およびテーブルなどのさまざまな種類の要素を格納できます。  フロー ドキュメントの詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  フロー コンテンツを格納するために、<xref:System.Windows.Controls.RichTextBox> が <xref:System.Windows.Documents.FlowDocument> オブジェクトをホストし、そのオブジェクトが編集可能コンテンツを格納します。  <xref:System.Windows.Controls.RichTextBox> のフロー コンテンツを示すために、次のコードで、段落と太字テキストのある <xref:System.Windows.Controls.RichTextBox> を作成する方法を示します。  
+  
+ [!code-xml[RichTextBoxMiscSnippets_snip#RichTextBoxWithContentExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/RichTextBoxWithContentExample.xaml#richtextboxwithcontentexamplewholepage)]  
+  
+ [!code-csharp[RichTextBoxMiscSnippets_procedural_snip#BasicRichTextBoxWithContentCodeOnlyExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_procedural_snip/CSharp/BasicRichTextBoxWithContentExample.cs#basicrichtextboxwithcontentcodeonlyexample)]
+ [!code-vb[RichTextBoxMiscSnippets_procedural_snip#BasicRichTextBoxWithContentCodeOnlyExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBoxMiscSnippets_procedural_snip/visualbasic/basicrichtextboxwithcontentexample.vb#basicrichtextboxwithcontentcodeonlyexample)]  
+  
+ このサンプルの表示結果を次の図に示します。  
+  
+ ![内容を含む RichTextBox](../../../../docs/framework/wpf/controls/media/editing-richtextbox-with-content.png "Editing\_RichTextBox\_with\_Content")  
+  
+ <xref:System.Windows.Documents.Paragraph> や <xref:System.Windows.Documents.Bold> などの要素は、<xref:System.Windows.Controls.RichTextBox> 内のコンテンツがどのように表示されるかを決定します。  ユーザーが <xref:System.Windows.Controls.RichTextBox> のコンテンツを編集すると、これらの要素がこのフロー コンテンツを変更します。  フロー コンテンツの機能、およびその使用方法の詳細については、「[フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)」を参照してください。  
+  
+ **メモ :** <xref:System.Windows.Controls.RichTextBox> 内のフロー コンテンツの動作は、他のコントロールに格納されたフロー コンテンツの動作とは異なる場合があります。  たとえば、<xref:System.Windows.Controls.RichTextBox> 内には列が存在しないため、自動サイズ変更動作もありません。  また、検索、表示モード、ページ ナビゲーション、およびズームなどの組み込み機能も、<xref:System.Windows.Controls.RichTextBox> 内では使用できません。  
+  
+<a name="realtime_spellechecking"></a>   
+## リアルタイム スペル チェック  
+ <xref:System.Windows.Controls.TextBox> または <xref:System.Windows.Controls.RichTextBox> でリアルタイム スペル チェックを有効にすることができます。  スペル チェックを有効にすると、スペル ミスがある単語の下に赤い線が表示されます \(下図を参照\)。  
+  
+ ![スペル チェックを含む Textbox](../../../../docs/framework/wpf/controls/media/editing-textbox-with-spellchecking.png "Editing\_TextBox\_with\_Spellchecking")  
+  
+ スペル チェックを有効にする方法については、「[テキスト編集コントロールでスペル チェックを有効にする](../../../../docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md)」を参照してください。  
+  
+<a name="context_menu"></a>   
+## コンテキスト メニュー  
+ 既定で、<xref:System.Windows.Controls.TextBox> と <xref:System.Windows.Controls.RichTextBox> の両方に、ユーザーがコントロール内を右クリックしたときに表示されるコンテキスト メニューが用意されています。  コンテキスト メニューを使用すると、ユーザーは切り取り、コピー、または貼り付けを実行できます \(下図を参照\)。  
+  
+ ![コンテキスト メニューを含む TextBox](../../../../docs/framework/wpf/controls/media/editing-textbox-with-context-menu.png "Editing\_TextBox\_with\_Context\_Menu")  
+  
+ 独自のカスタム コンテキスト メニューを作成して、既定のメニューをオーバーライドできます。  詳細については、「[カスタム コンテキスト メニューを RichTextBox に配置する](../../../../docs/framework/wpf/controls/how-to-position-a-custom-context-menu-in-a-richtextbox.md)」を参照してください。  
+  
+<a name="detect_when_content_changes"></a>   
+## 編集コマンド  
+ 編集コマンドを使用することで、ユーザーは <xref:System.Windows.Controls.RichTextBox> 内の編集可能コンテンツを書式設定できます。  <xref:System.Windows.Controls.RichTextBox> には、基本的な編集コマンドのほかに、<xref:System.Windows.Controls.TextBox> ではサポートされていない書式設定コマンドが含まれています。  たとえば、<xref:System.Windows.Controls.RichTextBox> 内で編集を行う場合、ユーザーは Ctrl \+ B キーを押すことで、テキストの太字設定を切り替えることができます。  使用可能なコマンドの全リストについては、<xref:System.Windows.Documents.EditingCommands> を参照してください。  キーボード ショートカットを使用するほかに、コマンドをボタンなどのその他のコントロールにフックすることができます。  次の例では、ユーザーがテキストの書式設定を変更するために使用できるボタンを格納した簡単なツール バーを作成する方法を示します。  
+  
+ [!code-xml[RichTextBox_InputPanel_snip#RichTextBoxWithToolBarExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBox_InputPanel_snip/CS/Window1.xaml#richtextboxwithtoolbarexamplewholepage)]  
+  
+ このサンプルの表示結果を次の図に示します。  
+  
+ ![ツール バーを含む RichTextBox](../../../../docs/framework/wpf/controls/media/editing-richtextbox-with-toobar.png "Editing\_RichTextBox\_with\_TooBar")  
+  
+<a name="editing_commands"></a>   
+## コンテンツの変更の検出  
+ <xref:System.Windows.Controls.TextBox> または <xref:System.Windows.Controls.RichTextBox> のテキストの変更を検出するには、<xref:System.Windows.UIElement.KeyDown> イベントを使用するのではなく、通常は <xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> イベントを使用する必要があります。  例については、「[TextBox のテキストがいつ変更されたかを検出する](../../../../docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md)」を参照してください。  
+  
+<a name="save_load_and_print_richtextbox_content"></a>   
+## RichTextBox コンテンツの保存、読み込み、および印刷  
+ <xref:System.Windows.Controls.RichTextBox> のコンテンツをファイルに保存し、そのコンテンツを再び <xref:System.Windows.Controls.RichTextBox> に読み込み、そのコンテンツを印刷する方法を次の例に示します。  以下は、この例のマークアップです。  
+  
+ [!code-xml[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/SaveLoadPrintRTB.xaml#saveloadprintrtbexamplewholepage)]  
+  
+ 以下は、この例の分離コードです。  
+  
+ [!code-csharp[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/CSharp/SaveLoadPrintRTB.xaml.cs#saveloadprintrtbcodeexamplewholepage)]
+ [!code-vb[RichTextBoxMiscSnippets_snip#SaveLoadPrintRTBCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/RichTextBoxMiscSnippets_snip/VisualBasic/SaveLoadPrintRTB.xaml.vb#saveloadprintrtbcodeexamplewholepage)]  
+  
+## 参照  
+ [方法のトピック](../../../../docs/framework/wpf/controls/richtextbox-how-to-topics.md)   
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/richtextbox.md b/docs/framework/wpf/controls/richtextbox.md
new file mode 100644
index 00000000000..491d41aa2a2
--- /dev/null
+++ b/docs/framework/wpf/controls/richtextbox.md
@@ -0,0 +1,34 @@
+---
+title: "RichTextBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], RichTextBox"
+  - "RichTextBox コントロール [WPF]"
+ms.assetid: a177374d-ee54-4d00-aaae-c983481cae9b
+caps.latest.revision: 68
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 68
+---
+# RichTextBox
+<xref:System.Windows.Controls.RichTextBox> 要素は、切り取りと貼り付け、リッチ ドキュメント プレゼンテーション、コンテンツの選択などの機能のサポートが組み込まれた編集コントロールを定義します。  
+  
+## このセクションの内容  
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/richtextbox-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Controls.TextBox>   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollbar-styles-and-templates.md b/docs/framework/wpf/controls/scrollbar-styles-and-templates.md
new file mode 100644
index 00000000000..dfc08aab61c
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollbar-styles-and-templates.md
@@ -0,0 +1,66 @@
+---
+title: "ScrollBar のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ScrollBar"
+  - "パーツ [WPF], ScrollBar"
+  - "ScrollBar [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], ScrollBar"
+  - "スタイル [WPF], ScrollBar"
+  - "テンプレート [WPF], ScrollBar"
+ms.assetid: 066ea45a-e27d-43b0-adfe-cce6934c22f5
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# ScrollBar のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Primitives.ScrollBar> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ScrollBar のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Primitives.ScrollBar> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Track|<xref:System.Windows.Controls.Primitives.Track>|<xref:System.Windows.Controls.Primitives.ScrollBar> の位置を示す要素のコンテナー。|  
+  
+## ScrollBar の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.ScrollBar> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ScrollBar ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Primitives.ScrollBar> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ScrollBar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/scrollbar.xaml#scrollbar)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollbar.md b/docs/framework/wpf/controls/scrollbar.md
new file mode 100644
index 00000000000..a82606026c3
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollbar.md
@@ -0,0 +1,34 @@
+---
+title: "ScrollBar | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ScrollBar"
+  - "ScrollBar コントロール [WPF]"
+ms.assetid: 60f27d35-8f7b-4285-89d2-28336a4c073a
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# ScrollBar
+<xref:System.Windows.Controls.Primitives.ScrollBar> を使用すると、<xref:System.Windows.Controls.Primitives.Thumb> をスライドしてコンテンツを表示することで、現在の表示領域外にあるコンテンツを表示できます。  
+  
+## このセクションの内容  
+ [ScrollBar のつまみのサイズをカスタマイズする](../../../../docs/framework/wpf/controls/how-to-customize-the-thumb-size-on-a-scrollbar.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.ScrollBar>  
+ <xref:System.Windows.Controls.Primitives.Track>  
+ <xref:System.Windows.Controls.Primitives.Thumb>  
+ <xref:System.Windows.Controls.ScrollViewer>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollviewer-how-to-topics.md b/docs/framework/wpf/controls/scrollviewer-how-to-topics.md
new file mode 100644
index 00000000000..ff4cbd4e633
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollviewer-how-to-topics.md
@@ -0,0 +1,39 @@
+---
+title: "ScrollViewer に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ScrollViewer"
+  - "ScrollViewer コントロール, 方法トピック"
+ms.assetid: 1e20804b-1d80-4b54-af41-76b3e10a6f89
+caps.latest.revision: 62
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 62
+---
+# ScrollViewer に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.ScrollViewer> 要素を使用してアプリケーション内にスクロール可能な領域を作成する方法について説明します。  
+  
+## このセクションの内容  
+ [ScrollChanged イベントの処理](../../../../docs/framework/wpf/controls/how-to-handle-the-scrollchanged-event.md)  
+ [IScrollInfo インターフェイスを使用してコンテンツをスクロールする](../../../../docs/framework/wpf/controls/how-to-scroll-content-by-using-the-iscrollinfo-interface.md)  
+ [ScrollViewer のコンテンツ スクロール メソッドを使用する](../../../../docs/framework/wpf/controls/how-to-use-the-content-scrolling-methods-of-scrollviewer.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.ScrollBar>  
+  
+ <xref:System.Windows.Controls.ScrollViewer>  
+  
+## 参照  
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollviewer-overview.md b/docs/framework/wpf/controls/scrollviewer-overview.md
new file mode 100644
index 00000000000..1464a38c04c
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollviewer-overview.md
@@ -0,0 +1,88 @@
+---
+title: "ScrollViewer の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ScrollViewer"
+  - "ScrollViewer コントロール, ScrollViewer コントロールの概要"
+ms.assetid: 94a13b94-cfdf-4b12-a1aa-90cb50c6e9b9
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ScrollViewer の概要
+ユーザー インターフェイスのコンテンツは、コンピューターの画面の表示領域より大きいことがよくあります。  <xref:System.Windows.Controls.ScrollViewer> コントロールには、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションのコンテンツのスクロールを可能にする便利な方法が用意されています。  このトピックでは、<xref:System.Windows.Controls.ScrollViewer> 要素について説明し、使用例をいくつか示します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [ScrollViewer コントロール](#what_is_a_scrollviewer_element)  
+  
+-   [物理スクロールと論理スクロール](#scrollviewer_physical_vs_logical)  
+  
+-   [ScrollViewer 要素の定義と使用](#scrollviewer_markup_syntax_and_sample)  
+  
+-   [ScrollViewer へのスタイルの適用](#scrollviewer_styling_scrollviewer)  
+  
+-   [ドキュメントの改ページ処理](#scrollviewer_scroll_vs_paginate)  
+  
+-   [Related Topics](#seeAlsoToggle)  
+  
+<a name="what_is_a_scrollviewer_element"></a>   
+## ScrollViewer コントロール  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションでのスクロールを可能にする定義済み要素には、<xref:System.Windows.Controls.Primitives.ScrollBar> と <xref:System.Windows.Controls.ScrollViewer> の 2 つがあります。  <xref:System.Windows.Controls.ScrollViewer> コントロールは、スクロール可能領域に他の表示要素を表示するために、水平および垂直の <xref:System.Windows.Controls.Primitives.ScrollBar> 要素とコンテンツ コンテナー \(<xref:System.Windows.Controls.Panel> 要素など\) をカプセル化します。  コンテンツのスクロール用に <xref:System.Windows.Controls.Primitives.ScrollBar> 要素を使用するには、カスタム オブジェクトを作成する必要があります。  一方、<xref:System.Windows.Controls.ScrollViewer> 要素は <xref:System.Windows.Controls.Primitives.ScrollBar> の機能をカプセル化する複合コントロールなので、単独で使用することができます。  
+  
+ <xref:System.Windows.Controls.ScrollViewer> コントロールは、マウスとキーボードの両方のコマンドに応答し、あらかじめ設定されているインクリメントでコンテンツをスクロールする多くのメソッドが定義されています。  <xref:System.Windows.Controls.ScrollViewer> の状態変化を検出するには、<xref:System.Windows.Controls.ScrollViewer.ScrollChanged> イベントを使用できます。  
+  
+ <xref:System.Windows.Controls.ScrollViewer> が持つことのできる子は 1 つだけです。通常は、要素の <xref:System.Windows.Controls.Panel.Children%2A> コレクションをホストできる <xref:System.Windows.Controls.Panel> 要素を使用します。  <xref:System.Windows.Controls.ContentPresenter.Content%2A> プロパティは、<xref:System.Windows.Controls.ScrollViewer> の唯一の子を定義します。  
+  
+<a name="scrollviewer_physical_vs_logical"></a>   
+## 物理スクロールと論理スクロール  
+ 物理スクロールは、あらかじめ定められた物理インクリメント \(通常は、ピクセル数で宣言された値\) で内容をスクロールするために使用されます。  論理スクロールは、論理ツリーの次の項目にスクロールするために使用されます。  物理スクロールは、ほとんどの <xref:System.Windows.Controls.Panel> 要素の既定のスクロール動作です。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、両方の種類のスクロールをサポートしています。  
+  
+#### IScrollInfo インターフェイス  
+ <xref:System.Windows.Controls.Primitives.IScrollInfo> インターフェイスは、<xref:System.Windows.Controls.ScrollViewer> または派生コントロール内のメインのスクロール領域を表します。  このインターフェイスではスクロールのプロパティとメソッドが定義されており、物理インクリメントではなく論理単位でのスクロールを必要とする <xref:System.Windows.Controls.Panel> 要素によって実装できます。  <xref:System.Windows.Controls.Primitives.IScrollInfo> のインスタンスを派生 <xref:System.Windows.Controls.Panel> にキャストし、そのスクロール メソッドを使用すると、ピクセル インクリメントではなく、子コレクション内の次の論理単位にスクロールする場合に役立ちます。  既定では、<xref:System.Windows.Controls.ScrollViewer> コントロールは物理単位でのスクロールをサポートします。  
+  
+ <xref:System.Windows.Controls.StackPanel> と <xref:System.Windows.Controls.VirtualizingStackPanel> はどちらも <xref:System.Windows.Controls.Primitives.IScrollInfo> を実装し、論理スクロールをネイティブでサポートします。  論理スクロールをネイティブでサポートするレイアウト コントロールでも、ホスト <xref:System.Windows.Controls.Panel> 要素を <xref:System.Windows.Controls.ScrollViewer> 内にラップし、<xref:System.Windows.Controls.ScrollViewer.CanContentScroll%2A> プロパティを `false` に設定することで、物理スクロールを実現できます。  
+  
+ <xref:System.Windows.Controls.Primitives.IScrollInfo> のインスタンスを <xref:System.Windows.Controls.StackPanel> にキャストして、インターフェイスによって定義されているコンテンツ スクロール メソッド \(<xref:System.Windows.Controls.Primitives.IScrollInfo.LineUp%2A> および <xref:System.Windows.Controls.Primitives.IScrollInfo.LineDown%2A>\) を使用する方法を次のコード例に示します。  
+  
+ [!code-csharp[IScrollInfoMethods#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/IScrollInfoMethods/CSharp/Window1.xaml.cs#3)]
+ [!code-vb[IScrollInfoMethods#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/IScrollInfoMethods/VisualBasic/Window1.xaml.vb#3)]  
+  
+<a name="scrollviewer_markup_syntax_and_sample"></a>   
+## ScrollViewer 要素の定義と使用  
+ いくつかのテキストと四角形を含むウィンドウに <xref:System.Windows.Controls.ScrollViewer> を作成する例を次に示します。  <xref:System.Windows.Controls.Primitives.ScrollBar> 要素は必要な場合にのみ表示されます。  ウィンドウのサイズを変更すると、<xref:System.Windows.Controls.ScrollViewer.ComputedHorizontalScrollBarVisibility%2A> プロパティと <xref:System.Windows.Controls.ScrollViewer.ComputedVerticalScrollBarVisibility%2A> プロパティの値の更新に応じて、<xref:System.Windows.Controls.Primitives.ScrollBar> 要素が表示されたり表示されなくなったりします。  
+  
+ [!code-cpp[ScrollViewer#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/ScrollViewer/CPP/ScrollViewer_wcp.cpp#1)]
+ [!code-csharp[ScrollViewer#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ScrollViewer/CSharp/ScrollViewer_wcp.cs#1)]
+ [!code-vb[ScrollViewer#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ScrollViewer/VisualBasic/ScrollViewer.vb#1)]
+ [!code-xml[ScrollViewer#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/ScrollViewer/XAML/Pane1.xaml#1)]  
+  
+<a name="scrollviewer_styling_scrollviewer"></a>   
+## ScrollViewer へのスタイルの適用  
+ Windows Presentation Foundation の他のコントロールと同様に、<xref:System.Windows.Controls.ScrollViewer> にもスタイルを設定でき、コントロールの既定のレンダリング動作を変更できます。  コントロールのスタイル設定の詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+<a name="scrollviewer_scroll_vs_paginate"></a>   
+## ドキュメントの改ページ処理  
+ ドキュメント コンテンツの場合は、スクロールの代わりに、改ページ処理をサポートするドキュメント コンテナーを選択できます。  <xref:System.Windows.Documents.FlowDocument> は、<xref:System.Windows.Controls.FlowDocumentPageViewer> など、複数ページにわたるコンテンツの改ページをサポートする表示コントロールでホストされるように設計されたドキュメント用です。このような表示コントロールでは、スクロールの必要がありません。  <xref:System.Windows.Controls.DocumentViewer> は、<xref:System.Windows.Documents.FixedDocument> コンテンツを表示するためのソリューションを提供し、従来のスクロールを使用して、表示領域の外部にあるコンテンツを表示します。  
+  
+ ドキュメント形式と表示オプションの詳細については、「[WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.ScrollViewer>   
+ <xref:System.Windows.Controls.Primitives.ScrollBar>   
+ <xref:System.Windows.Controls.Primitives.IScrollInfo>   
+ [Create a Scroll Viewer](http://msdn.microsoft.com/ja-jp/c8e46af7-b417-441b-aa30-791cbdbd43ef)   
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)   
+ [ScrollBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/scrollbar-styles-and-templates.md)   
+ [コントロール](../../../../docs/framework/wpf/advanced/optimizing-performance-controls.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollviewer-styles-and-templates.md b/docs/framework/wpf/controls/scrollviewer-styles-and-templates.md
new file mode 100644
index 00000000000..a3fbfd6c02b
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollviewer-styles-and-templates.md
@@ -0,0 +1,66 @@
+---
+title: "ScrollViewer のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ScrollViewer"
+  - "パーツ [WPF], ScrollViewer"
+  - "ScrollViewer [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], ScrollViewer"
+  - "スタイル [WPF], ScrollViewer"
+  - "テンプレート [WPF], ScrollViewer"
+ms.assetid: dffdd822-ae69-4946-abaf-710860cd65b2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# ScrollViewer のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ScrollViewer> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ScrollViewer のパーツ  
+ 次の表は、<xref:System.Windows.Controls.ScrollViewer> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ScrollContentPresenter|<xref:System.Windows.Controls.ScrollContentPresenter>|<xref:System.Windows.Controls.ScrollViewer> のコンテンツのプレースホルダーです。|  
+|PART\_HorizontalScrollBar|<xref:System.Windows.Controls.Primitives.ScrollBar>|コンテンツを水平方向にスクロールするために使用する <xref:System.Windows.Controls.Primitives.ScrollBar> です。|  
+|PART\_VerticalScrollBar|<xref:System.Windows.Controls.Primitives.ScrollBar>|コンテンツを垂直方向にスクロールするために使用する <xref:System.Windows.Controls.Primitives.ScrollBar> です。|  
+  
+## ScrollViewer の状態  
+ 次の表は、<xref:System.Windows.Controls.ScrollViewer> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ScrollViewer ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ScrollViewer> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ScrollViewer](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/scrollviewer.xaml#scrollviewer)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/scrollviewer.md b/docs/framework/wpf/controls/scrollviewer.md
new file mode 100644
index 00000000000..43d6a7ee48f
--- /dev/null
+++ b/docs/framework/wpf/controls/scrollviewer.md
@@ -0,0 +1,40 @@
+---
+title: "ScrollViewer | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], ScrollViewer コントロール"
+  - "コントロール [WPF], ScrollViewer"
+  - "スクロール (コンテンツを) [WPF]"
+  - "ScrollViewer コントロール [WPF]"
+ms.assetid: 2163666e-04da-4036-841f-40947c9c034d
+caps.latest.revision: 67
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 67
+---
+# ScrollViewer
+<xref:System.Windows.Controls.ScrollViewer> コントロールは、スクロール可能な領域を作成します。この領域の中では、コンテンツを左右または上下にスクロールできます。  
+  
+## このセクションの内容  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/scrollviewer-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.ScrollBar>  
+  
+ <xref:System.Windows.Controls.ScrollViewer>  
+  
+## 参照  
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/separator.md b/docs/framework/wpf/controls/separator.md
new file mode 100644
index 00000000000..3a86a63ebaf
--- /dev/null
+++ b/docs/framework/wpf/controls/separator.md
@@ -0,0 +1,30 @@
+---
+title: "区切り記号 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], 区切り記号"
+  - "区分線コントロール [WPF]"
+ms.assetid: 1b872bc6-1a26-401c-989b-3fafecc5a4ef
+caps.latest.revision: 67
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 67
+---
+# 区切り記号
+<xref:System.Windows.Controls.Separator> コントロールは、<xref:System.Windows.Controls.ListBox>、<xref:System.Windows.Controls.Menu>、<xref:System.Windows.Controls.ToolBar> などのコントロール内の項目間に水平線または垂直線を描画します。  
+  
+## このセクションの内容  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Separator>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/sizing-options-in-the-datagrid-control.md b/docs/framework/wpf/controls/sizing-options-in-the-datagrid-control.md
new file mode 100644
index 00000000000..384c629c68a
--- /dev/null
+++ b/docs/framework/wpf/controls/sizing-options-in-the-datagrid-control.md
@@ -0,0 +1,99 @@
+---
+title: "DataGrid コントロールのサイズ変更方法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "自動的なサイズ変更 (DataGrid を)"
+  - "DataGrid コントロール [WPF], サイズ変更"
+  - "サイズ [WPF], DataGrid"
+ms.assetid: 96a0e47e-b010-4302-98ef-2daac446d8db
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# DataGrid コントロールのサイズ変更方法
+<xref:System.Windows.Controls.DataGrid> のサイズは、さまざまな方法で制御できます。  <xref:System.Windows.Controls.DataGrid> のサイズと、<xref:System.Windows.Controls.DataGrid> を構成する行および列のサイズは、そのコンテンツに応じて自動的に設定するか、特定の値を設定することで変更できます。  既定では、<xref:System.Windows.Controls.DataGrid> は、そのコンテンツのサイズに合わせて伸縮します。  
+  
+## DataGrid のサイズ変更  
+  
+### 自動サイズ変更を使用する際の注意点  
+ 既定では、<xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.FrameworkElement.Height%2A> プロパティと <xref:System.Windows.FrameworkElement.Width%2A> プロパティが <xref:System.Double.NaN?displayProperty=fullName> \(XAML では "`Auto`"\) に設定され、<xref:System.Windows.Controls.DataGrid> のサイズが、そのコンテンツの大きさに合わせて調整されるようになっています。  
+  
+ 子のサイズが制限されないコンテナー内 \(<xref:System.Windows.Controls.Canvas>、<xref:System.Windows.Controls.StackPanel> など\) に配置した場合、<xref:System.Windows.Controls.DataGrid> がコンテナーの可視領域を越えて拡張され、スクロール バーは表示されません。  これはユーザビリティの面でも、パフォーマンスの面でも問題があります。  
+  
+ <xref:System.Windows.Controls.DataGrid> をデータ セットにバインドした場合、DataGrid の <xref:System.Windows.FrameworkElement.Height%2A> を制限しない限り、バインドされたデータ セットのデータ項目ごとに、際限なく行が追加されていきます。  最終的には、行が追加されるに従って、<xref:System.Windows.Controls.DataGrid> の大きさがアプリケーションの可視領域を越えることが予想されます。  この場合、<xref:System.Windows.Controls.DataGrid> そのものは、新しい行を表示できるよう、<xref:System.Windows.FrameworkElement.Height%2A> が絶えず拡張されるため、スクロール バーは表示されません。  
+  
+ オブジェクトは、<xref:System.Windows.Controls.DataGrid> 内の行ごとに作成されます。  <xref:System.Windows.Controls.DataGrid> のサイズが自動的に調整されるように設定した場合、扱うデータ セットが大きいと、多数のオブジェクトが作成されるために、アプリケーションのパフォーマンスが低下する可能性があります。  
+  
+ 大きなデータ セットを扱う際の問題を防ぐために、<xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.FrameworkElement.Height%2A> に具体的な値を設定するか、DataGrid の配置先を <xref:System.Windows.FrameworkElement.Height%2A> が制限されるコンテナー \(<xref:System.Windows.Controls.Grid> など\) にすることをお勧めします。  <xref:System.Windows.FrameworkElement.Height%2A> が制限されている場合、<xref:System.Windows.Controls.DataGrid> の行は、指定された <xref:System.Windows.FrameworkElement.Height%2A> の範囲内でのみ作成され、新しいデータを表示するために必要な分だけ、これらの行が再利用されます。  
+  
+### DataGrid のサイズ設定  
+ <xref:System.Windows.Controls.DataGrid> は、指定された範囲内で自動的にサイズが調整されるように設定することも、<xref:System.Windows.Controls.DataGrid> に特定のサイズを設定することもできます。  次の表は、<xref:System.Windows.Controls.DataGrid> のサイズ制御に関連したプロパティを示しています。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.FrameworkElement.Height%2A>|<xref:System.Windows.Controls.DataGrid> の特定の高さを設定します。|  
+|<xref:System.Windows.FrameworkElement.MaxHeight%2A>|<xref:System.Windows.Controls.DataGrid> の高さの上限を設定します。  <xref:System.Windows.Controls.DataGrid> のサイズは、この高さに達するまで垂直方向に拡張されます。|  
+|<xref:System.Windows.FrameworkElement.MinHeight%2A>|<xref:System.Windows.Controls.DataGrid> の高さの下限を設定します。  <xref:System.Windows.Controls.DataGrid> のサイズは、この高さに達するまで垂直方向に縮小されます。|  
+|<xref:System.Windows.FrameworkElement.Width%2A>|<xref:System.Windows.Controls.DataGrid> の特定の幅を設定します。|  
+|<xref:System.Windows.FrameworkElement.MaxWidth%2A>|<xref:System.Windows.Controls.DataGrid> の幅の上限を設定します。  <xref:System.Windows.Controls.DataGrid> のサイズは、この幅に達するまで水平方向に拡張されます。|  
+|<xref:System.Windows.FrameworkElement.MinWidth%2A>|<xref:System.Windows.Controls.DataGrid> の幅の下限を設定します。  <xref:System.Windows.Controls.DataGrid> のサイズは、この幅に達するまで水平方向に縮小されます。|  
+  
+## 行と行ヘッダーのサイズ変更  
+  
+### DataGrid の行  
+ 既定では、<xref:System.Windows.Controls.DataGrid> の行の <xref:System.Windows.FrameworkElement.Height%2A> プロパティが <xref:System.Double.NaN?displayProperty=fullName> \(XAML では "`Auto`"\) に設定されているため、行の高さは、そのコンテンツの大きさに合わせて拡張されます。  <xref:System.Windows.Controls.DataGrid> 内のすべての行の高さは、<xref:System.Windows.Controls.DataGrid.RowHeight%2A?displayProperty=fullName> プロパティを設定することによって指定できます。  ユーザーは、行ヘッダーの区分線をドラッグすることによって行の高さを変更できます。  
+  
+### DataGrid の行ヘッダー  
+ 行ヘッダーを表示するには、<xref:System.Windows.Controls.DataGrid.HeadersVisibility%2A> プロパティを <xref:System.Windows.Controls.DataGridHeadersVisibility?displayProperty=fullName> または <xref:System.Windows.Controls.DataGridHeadersVisibility?displayProperty=fullName> に設定する必要があります。  既定では、行ヘッダーを表示すると、そのサイズはコンテンツに合わせて自動的に調整されます。  行ヘッダーには、<xref:System.Windows.Controls.DataGrid.RowHeaderWidth%2A?displayProperty=fullName> プロパティを設定することによって特定の幅を指定できます。  
+  
+## 列と列ヘッダーのサイズ変更  
+  
+### DataGrid の列  
+ <xref:System.Windows.Controls.DataGrid> の絶対サイズ変更モードまたは自動サイズ変更モードを指定する際には、<xref:System.Windows.Controls.DataGridLength> および <xref:System.Windows.Controls.DataGridLengthUnitType> 構造体の値が使用されます。  
+  
+ <xref:System.Windows.Controls.DataGridLengthUnitType> 構造体の値を次の表に示します。  
+  
+|名前|Description|  
+|--------|-----------------|  
+|<xref:System.Windows.Controls.DataGridLengthUnitType>|既定の自動サイズ変更モードでは、セルと列ヘッダーの両方のコンテンツに基づき、<xref:System.Windows.Controls.DataGrid> 列のサイズが変更されます。|  
+|<xref:System.Windows.Controls.DataGridLengthUnitType>|セル ベースの自動サイズ変更モードでは、列内のセルのコンテンツに基づき \(列ヘッダーは含みません\)、<xref:System.Windows.Controls.DataGrid> 列のサイズが変更されます。|  
+|<xref:System.Windows.Controls.DataGridLengthUnitType>|ヘッダー ベースの自動サイズ変更モードでは、列ヘッダーのコンテンツにのみ基づき、<xref:System.Windows.Controls.DataGrid> 列のサイズが変更されます。|  
+|<xref:System.Windows.Controls.DataGridLengthUnitType>|ピクセル ベースのサイズ変更モードでは、<xref:System.Windows.Controls.DataGrid> 列のサイズが、指定された数値に基づいて設定されます。|  
+|<xref:System.Windows.Controls.DataGridLengthUnitType>|スター サイズ変更モードでは、使用可能なスペースを加重比率に基づいて配分できます。<br /><br /> XAML では、スター値は n\* と表現されます \(n は数値を表します\)。  1\* は \* と同じ意味です。  たとえば、<xref:System.Windows.Controls.DataGrid> の 2 つの列の幅がそれぞれ \* と 2\* であるとした場合、最初の列には使用可能なスペースの 3 分の 1 が割り当てられ、2 番目の列には使用可能なスペースの 3 分の 2 が割り当てられます。|  
+  
+ <xref:System.Windows.Controls.DataGridLengthConverter> クラスを使用すると、数値 \(または文字列値\) と <xref:System.Windows.Controls.DataGridLength> 値との間でデータを変換できます。  
+  
+ 既定では、<xref:System.Windows.Controls.DataGrid.ColumnWidth%2A?displayProperty=fullName> プロパティが <xref:System.Windows.Controls.DataGridLength.SizeToHeader%2A> に、<xref:System.Windows.Controls.DataGridColumn.Width%2A?displayProperty=fullName> プロパティが <xref:System.Windows.Controls.DataGridLength.Auto%2A> に設定されます。  サイズ変更モードを <xref:System.Windows.Controls.DataGridLength.Auto%2A> または <xref:System.Windows.Controls.DataGridLength.SizeToCells%2A> に設定した場合、最も幅の広い可視コンテンツの幅に合わせて列が拡張されます。  これらのサイズ変更モードでは、現在の列サイズよりも大きいコンテンツをスクロールして表示すると列が拡張されます。  コンテンツを表示領域の外側にスクロールした後も、列は縮小されません。  
+  
+ <xref:System.Windows.Controls.DataGrid> の列のサイズは、指定された範囲内で自動的に調整されるようにしたり、特定のサイズを設定したりすることもできます。  次の表は、列のサイズ制御に関連したプロパティを示しています。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Controls.DataGrid.MaxColumnWidth%2A?displayProperty=fullName>|<xref:System.Windows.Controls.DataGrid> 内のすべての列の上限を設定します。|  
+|<xref:System.Windows.Controls.DataGridColumn.MaxWidth%2A?displayProperty=fullName>|個々の列の上限を設定します。  <xref:System.Windows.Controls.DataGrid.MaxColumnWidth%2A?displayProperty=fullName> をオーバーライドします。|  
+|<xref:System.Windows.Controls.DataGrid.MinColumnWidth%2A?displayProperty=fullName>|<xref:System.Windows.Controls.DataGrid> 内のすべての列の下限を設定します。|  
+|<xref:System.Windows.Controls.DataGridColumn.MinWidth%2A?displayProperty=fullName>|個々の列の下限を設定します。  <xref:System.Windows.Controls.DataGrid.MinColumnWidth%2A?displayProperty=fullName> をオーバーライドします。|  
+|<xref:System.Windows.Controls.DataGrid.ColumnWidth%2A?displayProperty=fullName>|<xref:System.Windows.Controls.DataGrid> のすべての列に対し、特定の幅を設定します。|  
+|<xref:System.Windows.Controls.DataGridColumn.Width%2A?displayProperty=fullName>|個々の列に対し、特定の幅を設定します。  <xref:System.Windows.Controls.DataGrid.ColumnWidth%2A?displayProperty=fullName> をオーバーライドします。|  
+  
+### DataGrid の列ヘッダー  
+ 既定では、<xref:System.Windows.Controls.DataGrid> に列ヘッダーが表示されます。  列ヘッダーを非表示にするには、<xref:System.Windows.Controls.DataGrid.HeadersVisibility%2A> プロパティを <xref:System.Windows.Controls.DataGridHeadersVisibility?displayProperty=fullName> または <xref:System.Windows.Controls.DataGridHeadersVisibility?displayProperty=fullName> に設定する必要があります。  既定では、列ヘッダーを表示した場合、そのサイズは、コンテンツに合わせて自動的に調整されます。  列ヘッダーには、<xref:System.Windows.Controls.DataGrid.ColumnHeaderHeight%2A?displayProperty=fullName> プロパティを設定することによって特定の高さを指定できます。  
+  
+### マウス操作によるサイズ変更  
+ ユーザーは、行ヘッダーまたは列ヘッダーの区分線をドラッグすることによって、<xref:System.Windows.Controls.DataGrid> 行または列のサイズを変更できます。  <xref:System.Windows.Controls.DataGrid> では、行ヘッダーまたは列ヘッダーの区分線をダブルクリックすることによる行または列の自動サイズ変更もサポートされます。  特定の列のサイズを変更できないようにするには、個々の列について、<xref:System.Windows.Controls.DataGridColumn.CanUserResize%2A?displayProperty=fullName> プロパティを `false` に設定します。  すべての列のサイズを変更できないようにするには、<xref:System.Windows.Controls.DataGrid.CanUserResizeColumns%2A?displayProperty=fullName> プロパティを `false` に設定します。  すべての行のサイズを変更できないようにするには、<xref:System.Windows.Controls.DataGrid.CanUserResizeRows%2A?displayProperty=fullName> プロパティを `false` に設定します。  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataGrid>   
+ <xref:System.Windows.Controls.DataGridColumn>   
+ <xref:System.Windows.Controls.DataGridLength>   
+ <xref:System.Windows.Controls.DataGridLengthConverter>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/slider-styles-and-templates.md b/docs/framework/wpf/controls/slider-styles-and-templates.md
new file mode 100644
index 00000000000..fe48b919e89
--- /dev/null
+++ b/docs/framework/wpf/controls/slider-styles-and-templates.md
@@ -0,0 +1,69 @@
+---
+title: "スライダーのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], スライダー"
+  - "パーツ [WPF], スライダー"
+  - "Slider [WPF], スタイルおよびテンプレート"
+  - "状態 [WPF], スライダー"
+  - "スタイル [WPF], スライダー"
+  - "テンプレート [WPF], スライダー"
+ms.assetid: d89aa97b-075a-4752-9c41-9679df65c491
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# スライダーのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Slider> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Slider のパーツ  
+ 次の表は、<xref:System.Windows.Controls.Slider> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_Track|<xref:System.Windows.Controls.Primitives.Track>|<xref:System.Windows.Controls.Slider> の位置を示す要素のコンテナー。|  
+|PART\_SelectionRange|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.Controls.Slider> に沿って選択範囲を表示する要素。  選択範囲は、<xref:System.Windows.Controls.Slider.IsSelectionRangeEnabled%2A> プロパティが `true` の場合にのみ表示されます。|  
+  
+## Slider の状態  
+ 次の表は、<xref:System.Windows.Controls.Slider> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Slider ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Slider> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Slider](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/slider.xaml#slider)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/slider.md b/docs/framework/wpf/controls/slider.md
new file mode 100644
index 00000000000..3f06a358ead
--- /dev/null
+++ b/docs/framework/wpf/controls/slider.md
@@ -0,0 +1,37 @@
+---
+title: "スライダー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], スライダー"
+  - "Slider コントロール [WPF]"
+ms.assetid: fb037e2a-0002-458b-9e6b-321623fe72a7
+caps.latest.revision: 71
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 71
+---
+# スライダー
+<xref:System.Windows.Controls.Slider> を使用すると、<xref:System.Windows.Controls.Primitives.Track> に沿って <xref:System.Windows.Controls.Primitives.Thumb> を移動することにより一定の範囲から値を選択できます。  
+  
+ 水平 <xref:System.Windows.Controls.Slider> コントロールの例を次の図に示します。  
+  
+ ![目盛り付きの水平スライダー](../../../../docs/framework/wpf/controls/media/ss-ctl-hslider-ticks.png "SS\_CTL\_hslider\_ticks")  
+  
+## このセクションの内容  
+ [スライダーの目盛りをカスタマイズする](../../../../docs/framework/wpf/controls/how-to-customize-the-ticks-on-a-slider.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Slider>  
+ <xref:System.Windows.Controls.Primitives.Track>  
+ <xref:System.Windows.Controls.Primitives.Thumb>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/stackpanel-how-to-topics.md b/docs/framework/wpf/controls/stackpanel-how-to-topics.md
new file mode 100644
index 00000000000..3422588f254
--- /dev/null
+++ b/docs/framework/wpf/controls/stackpanel-how-to-topics.md
@@ -0,0 +1,52 @@
+---
+title: "StackPanel に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, StackPanel"
+  - "StackPanel コントロール, 方法トピック"
+ms.assetid: c9849df3-d000-4cdf-8345-5edcd053919d
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# StackPanel に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.StackPanel> 要素を使用して、コンテンツを水平方向または垂直方向にスタックする方法について説明します。  
+  
+## このセクションの内容  
+ [StackPanel または DockPanel を選択する](../../../../docs/framework/wpf/controls/how-to-choose-between-stackpanel-and-dockpanel.md)  
+ [StackPanel を作成する](../../../../docs/framework/wpf/controls/how-to-create-a-stackpanel.md)  
+ [StackPanel にコンテンツを水平方向または垂直方向に配置する](../../../../docs/framework/wpf/controls/how-to-horizontally-or-vertically-align-content-in-a-stackpanel.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/stackpanel.md b/docs/framework/wpf/controls/stackpanel.md
new file mode 100644
index 00000000000..84760f15e53
--- /dev/null
+++ b/docs/framework/wpf/controls/stackpanel.md
@@ -0,0 +1,51 @@
+---
+title: "StackPanel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], StackPanel"
+  - "スタック (要素を) [WPF]"
+  - "StackPanel コントロール [WPF]"
+ms.assetid: a82b824c-1b98-49a9-b7fd-2d9c154dd002
+caps.latest.revision: 68
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 68
+---
+# StackPanel
+<xref:System.Windows.Controls.StackPanel> 要素は、子要素を水平方向または垂直方向にスタックするために使用します。  
+  
+## このセクションの内容  
+ [方法のトピック](../../../../docs/framework/wpf/controls/stackpanel-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/statusbar-styles-and-templates.md b/docs/framework/wpf/controls/statusbar-styles-and-templates.md
new file mode 100644
index 00000000000..138cc4653a0
--- /dev/null
+++ b/docs/framework/wpf/controls/statusbar-styles-and-templates.md
@@ -0,0 +1,72 @@
+---
+title: "StatusBar のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], StatusBar"
+  - "パーツ [WPF], StatusBar"
+  - "状態 [WPF], StatusBar"
+  - "StatusBar [WPF], スタイルおよびテンプレート"
+  - "スタイル [WPF], StatusBar"
+  - "テンプレート [WPF], StatusBar"
+ms.assetid: 9f5e1c25-81eb-4756-a0ac-d9e1fbe33ee2
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# StatusBar のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Primitives.StatusBar> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## StatusBar のパーツ  
+ <xref:System.Windows.Controls.Primitives.StatusBar> コントロールには、名前付きのパーツは存在しません。  
+  
+## StatusBar の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.StatusBar> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## StatusBarItem のパーツ  
+ <xref:System.Windows.Controls.Primitives.StatusBarItem> コントロールには、名前付きのパーツは存在しません。  
+  
+## StatusBar の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.StatusBarItem> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## StatusBar ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Primitives.StatusBar> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#StatusBar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/statusbar.xaml#statusbar)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> は、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/statusbar.md b/docs/framework/wpf/controls/statusbar.md
new file mode 100644
index 00000000000..4238c289878
--- /dev/null
+++ b/docs/framework/wpf/controls/statusbar.md
@@ -0,0 +1,37 @@
+---
+title: "StatusBar | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], StatusBar"
+  - "StatusBar コントロール [WPF]"
+ms.assetid: aba45aed-7953-4b2c-bc29-315a9be6c440
+caps.latest.revision: 69
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 69
+---
+# StatusBar
+<xref:System.Windows.Controls.Primitives.StatusBar> は、ウィンドウの下端に表示される水平な領域です。アプリケーションは、この領域にステータス情報を表示できます。  
+  
+ <xref:System.Windows.Controls.Primitives.StatusBar> の例を次の図に示します。  
+  
+ ![ステータス バー](../../../../docs/framework/wpf/controls/media/ss-ctl-statusbar.GIF "SS\_CTL\_statusbar")  
+  
+## このセクションの内容  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Primitives.StatusBar>  
+ <xref:System.Windows.Controls.Primitives.StatusBarItem>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/styles-and-templates.md b/docs/framework/wpf/controls/styles-and-templates.md
new file mode 100644
index 00000000000..339c168787c
--- /dev/null
+++ b/docs/framework/wpf/controls/styles-and-templates.md
@@ -0,0 +1,39 @@
+---
+title: "スタイルおよびテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutogeneratedOrientationPage"
+helpviewer_keywords: 
+  - "スタイル"
+  - "テンプレート"
+ms.assetid: 7fd571fd-d54a-40fc-b332-4c4015a5b6ff
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# スタイルおよびテンプレート
+Windows Presentation Foundation \(WPF\) のスタイルとテンプレートは、アプリケーション、ドキュメント、またはユーザー インターフェイス \(UI: User Interface\) のデザイナーが、視覚効果に優れたアプリケーションを作成したり、それらの製品に特有の外観で標準化できる一連の機能 \(スタイル、テンプレート、トリガー、およびストーリーボード\) を表します。  
+  
+## このセクションの内容  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ [方法 : ControlTemplate によって生成された要素を検索する](../../../../docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Style>  
+ <xref:System.Windows.Controls.ControlTemplate>  
+ <xref:System.Windows.DataTemplate>  
+  
+## 関連項目  
+ [詳細設定](../../../../docs/framework/wpf/advanced/index.md)  
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/styling-and-templating.md b/docs/framework/wpf/controls/styling-and-templating.md
new file mode 100644
index 00000000000..32d53012375
--- /dev/null
+++ b/docs/framework/wpf/controls/styling-and-templating.md
@@ -0,0 +1,208 @@
+---
+title: "スタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "トリガー"
+  - "スタイルを参照します。"
+  - "イベント トリガー"
+  - "スタイル、前提条件"
+  - "スタイルを宣言します。"
+  - "スタイル, 概要"
+  - "拡張スタイル"
+  - "トリガーのスタイル"
+  - "スタイル、イベント トリガー"
+ms.assetid: 481765e5-5467-4a75-9f7b-e10e2ac410d9
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# スタイルとテンプレート
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]スタイルとテンプレートは、一連の開発者および設計者は、視覚的に説得力のある効果を作成し、それらの製品の一貫した外観を作成できるようにする機能 (スタイル、テンプレート、トリガー、およびストーリー ボード) を参照してください。 開発者や設計者は、アプリケーションの単位で広範囲に外観をカスタマイズできますが、強力なスタイルとテンプレートのモデルは内およびアプリケーション間での外観の保守や共有を許可する必要があります。 [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]そのモデルを提供します。  
+  
+ 他の機能、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]スタイルのモデルは、プレゼンテーションとロジックの分離。 つまり、デザイナーは、のみを使用してアプリケーションの外観に操作できること[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]c# または Visual Basic を使用して開発者の作業はプログラミング ロジックを同時にします。  
+  
+ この概要では、アプリケーションのスタイルとテンプレートの側面に焦点を当てていますを任意のデータ バインディングの概念については説明しません。 データ バインディングについては、次を参照してください。[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)します。  
+  
+ また、スタイルとテンプレートの再利用を使用できるように、リソースを理解する必要もあります。 リソースの詳細については、次を参照してください。 [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="styling_and_templating_sample"></a>   
+## <a name="styling-and-templating-sample"></a>スタイルとテンプレート サンプル  
+ この概要で使用するコード例は、次の図に示すように単純な写真のサンプルに基づいています。  
+  
+ ![ListView のスタイル](../../../../docs/framework/wpf/controls/media/stylingintro-triggers.png "StylingIntro_triggers")  
+  
+ この単純な写真のサンプルでは、スタイルとテンプレートを使用して、視覚的に説得力のあるユーザー エクスペリエンスを作成します。 サンプルには&2; つ<xref:System.Windows.Controls.TextBlock>要素および<xref:System.Windows.Controls.ListBox>イメージの一覧にバインドされているコントロール。 完全なサンプルを参照してください。[スタイルとテンプレート サンプルの概要](http://go.microsoft.com/fwlink/?LinkID=160010)します。  
+  
+<a name="styling_basics"></a>   
+## <a name="style-basics"></a>スタイルの基本  
+ 考えることができます、<xref:System.Windows.Style>プロパティ値のセットを&1; つ以上の要素に適用する便利な方法として。 たとえば、次<xref:System.Windows.Controls.TextBlock>要素と、既定の外観。  
+  
+ [!code-xml[StylingIntroSample_snippet#TextBlocks](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSample_snippet/CSharp/Window1.xaml#textblocks)]  
+  
+ ![スタイル サンプル スクリーン ショット](../../../../docs/framework/wpf/controls/media/stylingintro-textblocksbefore.png "StylingIntro_TextBlocksBefore")  
+  
+ などのプロパティを設定して既定の外観を変更する<xref:System.Windows.Controls.Control.FontSize%2A>と<xref:System.Windows.Controls.Control.FontFamily%2A>、各<xref:System.Windows.Controls.TextBlock>要素の直後です。 ただし、する場合は、 <xref:System.Windows.Controls.TextBlock>をいくつかのプロパティを共有する要素を作成、<xref:System.Windows.Style>で、`Resources`のセクション、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルを次のように。  
+  
+ [!code-xml[StylingIntroSnippet#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources)]  
+[!code-xml[StylingIntroSnippet#tb1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#tb1)]  
+[!code-xml[StylingIntroSnippet#Resources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources2)]  
+  
+ 設定すると、 <xref:System.Windows.Style.TargetType%2A>に自分のスタイルの<xref:System.Windows.Controls.TextBlock>すべてに種類、スタイルが適用されている、 <xref:System.Windows.Controls.TextBlock>ウィンドウ内の要素。  
+  
+ これで、 <xref:System.Windows.Controls.TextBlock>要素は次のように表示されます。  
+  
+ ![スタイル サンプル スクリーン ショット](../../../../docs/framework/wpf/controls/media/stylingintro-textblocksbasestyle.png "StylingIntro_TextBlocksBaseStyle")  
+  
+### <a name="extending-styles"></a>スタイルの拡張  
+ 場合、2 つ<xref:System.Windows.Controls.TextBlock>など、いくつかのプロパティ値を共有する要素、 <xref:System.Windows.Controls.Control.FontFamily%2A>で、中央揃えに<xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>テキストの追加のプロパティに「マイ ピクチャ」もできます。 次に示すように、最初のスタイルに基づいている新しいスタイルを作成することで実現できます。  
+  
+ [!code-xml[StylingIntroSnippet#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources)]  
+[!code-xml[StylingIntroSnippet#tb2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#tb2)]  
+[!code-xml[StylingIntroSnippet#Resources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources2)]  
+  
+ 以前のスタイルが指定された通知、`x:Key`です。 設定するスタイルを適用する、<xref:System.Windows.FrameworkElement.Style%2A>プロパティを<xref:System.Windows.Controls.TextBlock>に、`x:Key`値に設定する次のようにします。  
+  
+ [!code-xml[StylingIntroSnippet#UIText](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#uitext)]  
+  
+ これ<xref:System.Windows.Controls.TextBlock>スタイルには、今すぐ、 <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A>の値<xref:System.Windows.HorizontalAlignment>、 <xref:System.Windows.Controls.TextBlock.FontFamily%2A>の値`Comic Sans MS`、 <xref:System.Windows.Controls.TextBlock.FontSize%2A> 26 の値と<xref:System.Windows.Controls.TextBlock.Foreground%2A>値に設定、 <xref:System.Windows.Media.LinearGradientBrush>の例に示すようにします。 これは、上書きに注意してください、 <xref:System.Windows.Controls.Control.FontSize%2A>の基本のスタイルの値。 1 つ以上を使用する必要がある場合<xref:System.Windows.Setter>で同じプロパティを設定、<xref:System.Windows.Style>、 <xref:System.Windows.Setter>が宣言されている最後が優先されます。  
+  
+ どのような次の表示、 <xref:System.Windows.Controls.TextBlock>要素のようになります。  
+  
+ ![テキスト ブロック スタイルが適用された](../../../../docs/framework/wpf/controls/media/stylingintro-textblocks.png "StylingIntro_TextBlocks")  
+  
+ これは、`TitleText`スタイル拡張用に作成されたスタイル、 <xref:System.Windows.Controls.TextBlock>型です。 スタイルを拡張することも、`x:Key`を使用して、`x:Key`値。 例については、使用されている例を参照してください、 <xref:System.Windows.Style.BasedOn%2A>プロパティです。  
+  
+### <a name="relationship-of-the-targettype-property-and-the-xkey-attribute"></a>TargetType プロパティおよび X:key 属性の関係  
+ 最初の例に示すように設定、 <xref:System.Windows.Style.TargetType%2A>プロパティを`TextBlock`スタイルを割り当てることがなく、`x:Key`すべてに適用されるスタイル<xref:System.Windows.Controls.TextBlock>要素。 ここで、`x:Key`に暗黙的に設定されている`{x:Type TextBlock}`します。 これは、ため、明示的に設定する場合、`x:Key`以外の値が決まって`{x:Type TextBlock}`、<xref:System.Windows.Style>すべてに適用できません<xref:System.Windows.Controls.TextBlock>要素に自動的にします。 代わりに、スタイルを適用する必要があります (を使用して、`x:Key`値) に、 <xref:System.Windows.Controls.TextBlock>要素に明示的にします。 自分のスタイルは、resources セクションには、その設定しないでください、 <xref:System.Windows.Style.TargetType%2A>に対して自分のスタイル プロパティを提供する必要があります、`x:Key`です。  
+  
+ 既定値を提供するだけでなく、 `x:Key`、 <xref:System.Windows.Style.TargetType%2A>プロパティ set アクセス操作子のプロパティを適用する種類を指定します。 指定しない場合、 <xref:System.Windows.Style.TargetType%2A>、内のプロパティを修飾する必要があります、 <xref:System.Windows.Setter>構文を使用してクラス名を持つオブジェクト`Property="ClassName.Property"`します。 たとえば、設定ではなく`Property="FontSize"`、設定する必要があります<xref:System.Windows.Setter.Property%2A>に`"TextBlock.FontSize"`または`"Control.FontSize"`です。  
+  
+ なお、それほど多く[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]コントロールは、その他の組み合わせで構成されます[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]コントロールです。 型のすべてのコントロールに適用されるスタイルを作成する場合は、予期しない結果を得る可能性があります。 対象とするスタイルを作成する場合など、 <xref:System.Windows.Controls.TextBlock>入力、<xref:System.Windows.Window>、スタイルはすべてに適用<xref:System.Windows.Controls.TextBlock>  ウィンドウで、コントロール場合でも、 <xref:System.Windows.Controls.TextBlock>など、他のコントロールの一部では、 <xref:System.Windows.Controls.ListBox>します。  
+  
+### <a name="styles-and-resources"></a>スタイルとリソース  
+ 派生した任意の要素のスタイルを使用する<xref:System.Windows.FrameworkElement>または<xref:System.Windows.FrameworkContentElement>します。 スタイルを宣言する最も一般的な方法は、内のリソースとして、`Resources`セクション、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルは、前の例に示すようにします。 スタイルはリソースであるため、すべてのリソースに適用されるスコープの規則に従いますここで、スタイルを適用できる位置に影響を与えますスタイルを宣言します。 たとえば、アプリケーション定義のルート要素にスタイルを宣言する[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイル、スタイルは、アプリケーションのどこにでも使用できます。 ナビゲーション アプリケーションを作成し、アプリケーションのいずれかでスタイルを宣言する場合[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]するだけで、ファイル、スタイルを使用できます[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルです。 スコープのリソースの規則の詳細については、次を参照してください。 [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)します。  
+  
+ 詳細については、スタイルとリソースを検索するさらに、[共有リソースとテーマ](#styling_themes)この概要で後述します。  
+  
+### <a name="setting-styles-programmatically"></a>プログラムによるスタイルの設定  
+ プログラムを使用して要素を名前付きのスタイルを割り当てるには、するリソースのコレクションからスタイルを取得し、要素に割り当てる<xref:System.Windows.FrameworkElement.Style%2A>プロパティです。 型のリソース コレクション内の項目がある注意<xref:System.Object>します。 そのため、取得したスタイルをキャストする必要があります、<xref:System.Windows.Style>に割り当てる前に、<xref:System.Windows.FrameworkElement.Style%2A>プロパティです。 例については、定義された設定に`TitleText`に対するスタイル、 <xref:System.Windows.Controls.TextBlock>という名前`textblock1`、次の操作します。  
+  
+ [!code-csharp[StylingIntroSample_snippet#Code](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSample_snippet/CSharp/Window1.xaml.cs#code)]
+ [!code-vb[StylingIntroSample_snippet#Code](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StylingIntroSample_snippet/visualbasic/window1.xaml.vb#code)]  
+  
+ スタイルが適用されると、それが封印されているをして変更することはできませんれます。 既に適用されているスタイルを動的に変更する場合に既存のものを置き換える新しいスタイルを作成する必要があります。 詳細については、次を参照してください。、 <xref:System.Windows.Style.IsSealed%2A>プロパティです。  
+  
+ カスタム ロジックに基づいてを適用するスタイルを選択するオブジェクトを作成することができます。 例については、使用されている例を参照してください、 <xref:System.Windows.Controls.StyleSelector>クラスです。  
+  
+<a name="styling_binding_dynamicresource"></a>   
+### <a name="bindings-dynamic-resources-and-event-handlers"></a>バインディング、動的リソース、およびイベント ハンドラー  
+ 使用できる、`Setter.Value`プロパティを指定する、[バインド マークアップ拡張機能の選択](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)または[DynamicResource マークアップ拡張機能](../../../../docs/framework/wpf/advanced/dynamicresource-markup-extension.md)です。 詳細についてに付属する例を参照してください、 <xref:System.Windows.Setter.Value%2A?displayProperty=fullName>プロパティです。  
+  
+ ここまでは、この概要は、プロパティ値を設定する set アクセス操作子の使用のみを説明します。 スタイルのイベント ハンドラーを指定することもできます。 詳細については、次を参照してください。 <xref:System.Windows.EventSetter>します。  
+  
+<a name="styling_datatemplates"></a>   
+## <a name="data-templates"></a>データ テンプレート  
+ このサンプル アプリケーションでは、 <xref:System.Windows.Controls.ListBox>写真のリストにバインドされているコントロール。  
+  
+ [!code-xml[StylingIntroSnippet#UIListBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#uilistbox)]  
+  
+ これは、 <xref:System.Windows.Controls.ListBox>現在、次のようになります。  
+  
+ ![テンプレートの適用前に、の ListBox](../../../../docs/framework/wpf/controls/media/stylingintro-listboxbefore.png "StylingIntro_ListBoxBefore")  
+  
+ ほとんどのコントロールはいくつかの種類のコンテンツを使用し、そのコンテンツは多くの場合にバインドするデータから取得しています。 このサンプルでは、データは、写真のリストです。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]を使用する、 <xref:System.Windows.DataTemplate>データのビジュアル表現を定義します。 基本的には、どのようなに配置すること、 <xref:System.Windows.DataTemplate>レンダリングされたアプリケーション内でデータがどのようにを決定します。  
+  
+ サンプル アプリケーションでは、各カスタム`Photo`オブジェクトには、`Source`イメージのファイル パスを指定する文字列型のプロパティです。 現在のところ、photo オブジェクトは、ファイルのパスとして表示されます。  
+  
+ イメージとして表示する写真を作成する、 <xref:System.Windows.DataTemplate>をリソースとして。  
+  
+ [!code-xml[StylingIntroSnippet#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources)]  
+[!code-xml[StylingIntroSnippet#DataTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#datatemplate)]  
+[!code-xml[StylingIntroSnippet#Resources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSnippet/CS/window1.xaml#resources2)]  
+  
+ 注意して、<xref:System.Windows.DataTemplate.DataType%2A>プロパティによく似ていますが、 <xref:System.Windows.Style.TargetType%2A>のプロパティ、<xref:System.Windows.Style>します。 場合、 <xref:System.Windows.DataTemplate>リソース セクションで、指定した場合、<xref:System.Windows.DataTemplate.DataType%2A>プロパティ型を割り当てないでくださいと、 `x:Key`、 <xref:System.Windows.DataTemplate>その型が表示されるたびに適用します。 割り当てるオプションが常にある、 <xref:System.Windows.DataTemplate>で、`x:Key`として設定し、`StaticResource`プロパティ<xref:System.Windows.DataTemplate>などの型、 <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>プロパティまたは<xref:System.Windows.Controls.ContentControl.ContentTemplate%2A>プロパティです。  
+  
+ 基本的には、 <xref:System.Windows.DataTemplate>上の例ではされるように定義があるときに、`Photo`オブジェクトとして表示する必要があります、<xref:System.Windows.Controls.Image>内で、<xref:System.Windows.Controls.Border>します。 この<xref:System.Windows.DataTemplate>、次のようなアプリケーション。  
+  
+ ![フォト イメージ](../../../../docs/framework/wpf/controls/media/stylingintro-photosasimages.png "StylingIntro_PhotosAsImages")  
+  
+ データ テンプレートのモデルでは、その他の機能を提供します。 使用して他のコレクションを格納するコレクションのデータを表示する場合など、 <xref:System.Windows.Controls.HeaderedItemsControl>などの入力、<xref:System.Windows.Controls.Menu>または<xref:System.Windows.Controls.TreeView>がある、 <xref:System.Windows.HierarchicalDataTemplate>します。 別のデータ テンプレートの機能は、 <xref:System.Windows.Controls.DataTemplateSelector>を選択できます、 <xref:System.Windows.DataTemplate>に基づいてカスタム ロジックを使用します。 詳細については、次を参照してください。[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)、別のデータ転送の各機能の詳細情報について提供します。  
+  
+<a name="styling_controltemplates"></a>   
+## <a name="control-templates"></a>コントロール テンプレート  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、 <xref:System.Windows.Controls.ControlTemplate>コントロールのコントロールの外観を定義します。 構造とコントロールの外観を変更するには、新しい定義することで<xref:System.Windows.Controls.ControlTemplate>コントロールです。 多くの場合、これは十分な柔軟性できるように、独自のカスタム コントロールを作成する必要はありません。 詳細については、次を参照してください。 [ControlTemplate を作成することで、既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)します。  
+  
+<a name="styling_triggers"></a>   
+## <a name="triggers"></a>トリガー  
+ トリガーのプロパティを設定するか、プロパティ値が変更されたときにいずれかのイベントが発生したときに、アニメーションなどの操作を開始します。 <xref:System.Windows.Style>、 <xref:System.Windows.Controls.ControlTemplate>、および<xref:System.Windows.DataTemplate>すべてである、`Triggers`プロパティを一連のトリガーを含むことができます。 さまざまな種類のトリガーがあります。  
+  
+### <a name="property-triggers"></a>プロパティ トリガー  
+ A<xref:System.Windows.Trigger>セット プロパティが値またはプロパティの値に基づいてアクションを開始すると、プロパティ トリガー呼びます。  
+  
+ プロパティ トリガーを使用する方法を示すためには、行うことができますそれぞれ<xref:System.Windows.Controls.ListBoxItem>が選択されている場合を除き、部分的に透明です。 次のスタイル設定、<xref:System.Windows.UIElement.Opacity%2A>の値、 <xref:System.Windows.Controls.ListBoxItem>に`0.5`します。 ときに、 <xref:System.Windows.Controls.ListBoxItem.IsSelected%2A>プロパティは、 `true`、ただし、<xref:System.Windows.UIElement.Opacity%2A>に設定されている`1.0`:  
+  
+ [!code-xml[StylingIntroSample_snippet#Triggers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSample_snippet/CSharp/Window1.xaml#triggers)]  
+[!code-xml[StylingIntroSample_snippet#EndTriggers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSample_snippet/CSharp/Window1.xaml#endtriggers)]  
+  
+ この例では、<xref:System.Windows.Trigger>プロパティの値を設定することに注意してください、<xref:System.Windows.Trigger>クラスもあります、 <xref:System.Windows.TriggerBase.EnterActions%2A>と<xref:System.Windows.TriggerBase.ExitActions%2A>の操作を実行するためのトリガーを有効にするプロパティです。  
+  
+ 注意して、 <xref:System.Windows.FrameworkElement.MaxHeight%2A>のプロパティ、 <xref:System.Windows.Controls.ListBoxItem>に設定されている`75`します。 次の図では、3 番目の項目には、選択した項目です。  
+  
+ ![ListView のスタイル](../../../../docs/framework/wpf/controls/media/stylingintro-triggers.png "StylingIntro_triggers")  
+  
+### <a name="eventtriggers-and-storyboards"></a>Eventtrigger とストーリー ボード  
+ トリガーの別の種類は、 <xref:System.Windows.EventTrigger>一連のイベントの発生に基づいてアクションを開始します。 たとえば、次<xref:System.Windows.EventTrigger>オブジェクトを指定する、マウス ポインターが入ったときに、 <xref:System.Windows.Controls.ListBoxItem>、 <xref:System.Windows.FrameworkElement.MaxHeight%2A>の値にプロパティをアニメーション化`90`経由で、 `0.2`&2; 番目の期間。 アイテムから離れた場所でマウスが移動するとき、プロパティは、一定の期間元の値を返します`1`2 番目です。 方法を指定する必要はありません、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>の値として、 <xref:System.Windows.ContentElement.MouseLeave>アニメーションです。 これは、アニメーションが元の値を追跡することが原因です。  
+  
+ [!code-xml[StylingIntroSample_snippet#EventTriggers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StylingIntroSample_snippet/CSharp/Window1.xaml#eventtriggers)]  
+  
+ 詳細については、次を参照してください。、[ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)します。  
+  
+ 次の図には、マウスをポイントして、3 番目の項目にいます。  
+  
+ ![スタイル サンプル スクリーン ショット](../../../../docs/framework/wpf/controls/media/stylingintro-eventtriggers.png "StylingIntro_EventTriggers")  
+  
+### <a name="multitriggers-datatriggers-and-multidatatriggers"></a>MultiTriggers、DataTriggers、および MultiDataTriggers  
+ 他に、<xref:System.Windows.Trigger>と<xref:System.Windows.EventTrigger>トリガーの他の種類があります。 <xref:System.Windows.MultiTrigger>複数の条件に基づくプロパティ値を設定することができます。 使用する<xref:System.Windows.DataTrigger>と<xref:System.Windows.MultiDataTrigger>条件のプロパティがデータ バインドします。  
+  
+<a name="styling_themes"></a>   
+## <a name="shared-resources-and-themes"></a>共有リソースとテーマ  
+ 標準的な[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]アプリケーションは、アプリケーション全体でインストールされている複数のユーザー インターフェイス (UI) リソースを必要があります。 集合的に、このリソースのセットには、アプリケーションのテーマを検討できます。 [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]では、パッケージのユーザー インターフェイス (UI) のリソースをテーマとしてとしてカプセル化されたリソース ディクショナリを使用して、 <xref:System.Windows.ResourceDictionary>クラスです。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]スタイルとテンプレートのメカニズムを使用してテーマを定義する[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]任意の要素のビジュアルをカスタマイズするために公開します。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]テーマのリソースは、埋め込みリソース ディクショナリに格納されます。 署名されたアセンブリ内にこれらのリソース ディクショナリを埋め込む必要があり、いずれかの埋め込み可能コード自体と同じアセンブリまたはサイド バイ サイド アセンブリします。 PresentationFramework.dll、含まれているアセンブリの場合[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)]コントロール、テーマのリソースは、一連のサイド バイ サイド アセンブリのです。  
+  
+ テーマは、要素のスタイルを検索するときに最後の場所になります。 通常、検索は適切なリソースを検索する要素のツリーをウォークしてからアプリケーションのリソース コレクションがないか調べ、最後に、システム クエリを実行します。 これは、方法により、アプリケーション開発者は、テーマに到達する前に、ツリーまたはアプリケーション レベルで任意のオブジェクトのスタイルを再定義します。  
+  
+ リソース ディクショナリは、複数のアプリケーションでテーマを再利用するための個々 のファイルとして定義できます。 同じ種類のリソースの値が異なる複数のリソース ディクショナリを定義することによって、交換できるテーマを作成することもできます。 これらのスタイルまたはその他のリソースをアプリケーション レベルで再定義するは、アプリケーションをスキニングの推奨されるアプローチです。  
+  
+ 複数のアプリケーションでのスタイルおよびテンプレートを含むリソースのセットを共有するを作成、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]ファイルし、定義、 <xref:System.Windows.ResourceDictionary>します。 たとえばの一部を示しています次の図を見て、[サンプル全体について](http://go.microsoft.com/fwlink/?LinkID=160041):。  
+  
+ ![テンプレートの例の制御](../../../../docs/framework/wpf/controls/media/stylingintro-controltemplateexamples.png "StylingIntro_ControlTemplateExamples")  
+  
+ 確認する場合、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]サンプル内のファイル、すべてのファイルは、以下である確認は。  
+  
+ [!code-xml[ControlTemplateExamples#MergedDictionaries](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/button.xaml#mergeddictionaries)]  
+  
+ 共有は`shared.xaml`を定義する、 <xref:System.Windows.ResourceDictionary>一貫性のある外観のサンプルでコントロールできるようにする一連のスタイルおよびブラシ リソースを格納しています。  
+  
+ 詳細については、次を参照してください。[リソース ディクショナリのトピックとマージ](../../../../docs/framework/wpf/advanced/merged-resource-dictionaries.md)します。  
+  
+ カスタム コントロールのテーマを作成する場合、は、外部のコントロール ライブラリ セクションを参照して、[コントロールの作成の概要](../../../../docs/framework/wpf/controls/control-authoring-overview.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [WPF におけるパッケージの Uri](../../../../docs/framework/wpf/app-development/pack-uris-in-wpf.md)   
+ [方法: ControlTemplate によって生成された要素を検索](../../../../docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md)   
+ [DataTemplate によって生成された要素を検索します。](../../../../docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tabcontrol-styles-and-templates.md b/docs/framework/wpf/controls/tabcontrol-styles-and-templates.md
new file mode 100644
index 00000000000..08a08a228a6
--- /dev/null
+++ b/docs/framework/wpf/controls/tabcontrol-styles-and-templates.md
@@ -0,0 +1,86 @@
+---
+title: "TabControl のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], TabControl"
+  - "パーツ [WPF], TabControl"
+  - "状態 [WPF], TabControl"
+  - "スタイル [WPF], TabControl"
+  - "TabControl [WPF], スタイルおよびテンプレート"
+  - "テンプレート [WPF], TabControl"
+ms.assetid: f6b19a30-f10e-4fa1-96ce-f17a54092ab6
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# TabControl のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.TabControl> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## TabControl パーツ  
+ 次の表は、<xref:System.Windows.Controls.TabControl> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_SelectedContentHost|<xref:System.Windows.Controls.ContentPresenter>|現在選択されている <xref:System.Windows.Controls.TabItem> のコンテンツを表示するオブジェクト。|  
+  
+ <xref:System.Windows.Controls.TabControl> の <xref:System.Windows.Controls.ControlTemplate> を作成する際には、テンプレートの <xref:System.Windows.Controls.ScrollViewer> に <xref:System.Windows.Controls.ItemsPresenter> を含めることができます。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.TabControl> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## TabControl の状態  
+ 次の表は、<xref:System.Windows.Controls.TabControl> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## TabItem パーツ  
+ <xref:System.Windows.Controls.TabItem> コントロールには、名前付きのパーツは存在しません。  
+  
+## TabItem の状態  
+ 次の表は、<xref:System.Windows.Controls.TabItem> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Selected|SelectionStates|コントロールは選択されています。|  
+|Unselected|SelectionStates|コントロールは選択されていません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## TabControl ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.TabControl> コントロールと <xref:System.Windows.Controls.TabItem> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#TabControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/tabcontrol.xaml#tabcontrol)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tabcontrol.md b/docs/framework/wpf/controls/tabcontrol.md
new file mode 100644
index 00000000000..f3202166df4
--- /dev/null
+++ b/docs/framework/wpf/controls/tabcontrol.md
@@ -0,0 +1,36 @@
+---
+title: "TabControl | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], TabControl"
+  - "TabControl コントロール [WPF]"
+ms.assetid: 3d26404b-431e-432d-a82b-ef026feb3fff
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# TabControl
+<xref:System.Windows.Controls.TabControl> 要素は、独立した複数のページにコンテンツを表示します。各ページには、それぞれのタブをクリックしてアクセスします。  各タブには、<xref:System.Windows.Controls.TabItem> が含まれます。  
+  
+ 次の図は、<xref:System.Windows.Controls.TabControl> を示しています。  
+  
+ ![タブ コントロール](../../../../docs/framework/wpf/controls/media/ss-ctl-tabcontrol.gif "SS\_CTL\_tabcontrol")  
+典型的な TabControl  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.TabControl>  
+ <xref:System.Windows.Controls.TabItem>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textblock-overview.md b/docs/framework/wpf/controls/textblock-overview.md
new file mode 100644
index 00000000000..5ba2b7b0413
--- /dev/null
+++ b/docs/framework/wpf/controls/textblock-overview.md
@@ -0,0 +1,35 @@
+---
+title: "TextBlock の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TextBlock コントロール"
+  - "TextBlock コントロール"
+ms.assetid: 24720bca-341a-4b03-8a6b-7a678023b10a
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# TextBlock の概要
+<xref:System.Windows.Controls.TextBlock>コントロールは、柔軟性の高いテキストのサポートの[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アプリケーションです。 要素が、主として、basic [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]&1; つ以上の段落のテキストを必要としないシナリオです。 いくつかのように、プレゼンテーションを正確に制御が利用可能なプロパティがサポートしている<xref:System.Windows.Controls.TextBlock.FontFamily%2A>、 <xref:System.Windows.Controls.TextBlock.FontSize%2A>、 <xref:System.Windows.Controls.TextBlock.FontWeight%2A>、 <xref:System.Windows.Controls.TextBlock.TextEffects%2A>、および<xref:System.Windows.Controls.TextBlock.TextWrapping%2A>します。 使用してテキストの内容を追加できる、<xref:System.Windows.Controls.TextBlock.Text%2A>プロパティです。 使用すると[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]要素のテキストとして、オープン、および終了タグの間でコンテンツが暗黙的に追加します。  
+  
+ A <xref:System.Windows.Controls.TextBlock>非常に簡単に使用して要素をインスタンス化することができます[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]します。  
+  
+ [!code-xml[TextBlockSnip_XAML#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBlockSnip_XAML/CS/default.xaml#2)]  
+  
+ 同様に、使用量を<xref:System.Windows.Controls.TextBlock>コード内の要素は比較的簡単です。  
+  
+ [!code-csharp[TextBlockSnip#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBlockSnip/CSharp/TextBlockSnips.cs#1)]
+ [!code-vb[TextBlockSnip#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TextBlockSnip/VisualBasic/TextBlockSnips.vb#1)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.Label>
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textblock.md b/docs/framework/wpf/controls/textblock.md
new file mode 100644
index 00000000000..b7833c411b7
--- /dev/null
+++ b/docs/framework/wpf/controls/textblock.md
@@ -0,0 +1,36 @@
+---
+title: "TextBlock | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], TextBlock"
+  - "TextBlock コントロール [WPF]"
+ms.assetid: ea5f7826-7a92-4de9-9eee-10ef700ce7b6
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# TextBlock
+<xref:System.Windows.Controls.TextBlock> コントロールは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに対して柔軟なテキストのサポートを提供します。  この要素は、主として、複数の段落のテキストを必要としない基本 [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のシナリオを対象としています。  
+  
+## このセクションの内容  
+ [TextBlock の概要](../../../../docs/framework/wpf/controls/textblock-overview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Label>  
+  
+## 関連項目  
+ [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)  
+  
+ [フロー ドキュメントの概要](../../../../docs/framework/wpf/advanced/flow-document-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textbox-how-to-topics.md b/docs/framework/wpf/controls/textbox-how-to-topics.md
new file mode 100644
index 00000000000..bb7c92c0d1b
--- /dev/null
+++ b/docs/framework/wpf/controls/textbox-how-to-topics.md
@@ -0,0 +1,53 @@
+---
+title: "TextBox に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, TextBox"
+  - "TextBox コントロール, 方法トピック"
+ms.assetid: 006aa461-fe37-4cd8-860a-d38d76e8b9f7
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# TextBox に関する「方法」トピック
+このセクションでは、<xref:System.Windows.Controls.TextBox> コントロールを使用して一般的なタスクを実行する方法を、いくつかの例で示します。  
+  
+## このセクションの内容  
+ [複数行の TextBox コントロールを作成する](../../../../docs/framework/wpf/controls/how-to-create-a-multiline-textbox-control.md)  
+ [TextBox のテキストがいつ変更されたかを検出する](../../../../docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md)  
+ [TextBox コントロールでタブ文字を有効にする](../../../../docs/framework/wpf/controls/how-to-enable-tab-characters-in-a-textbox-control.md)  
+ [TextBox から行のコレクションを取得する](../../../../docs/framework/wpf/controls/how-to-get-a-collection-of-lines-from-a-textbox.md)  
+ [TextBox コントロールを読み取り専用にする](../../../../docs/framework/wpf/controls/how-to-make-a-textbox-control-read-only.md)  
+ [TextBox コントロールのテキストの先頭または末尾にカーソルを配置する](../../../../docs/framework/wpf/controls/position-the-cursor-at-the-beginning-or-end-of-text.md)  
+ [テキスト選択を取得する](../../../../docs/framework/wpf/controls/how-to-retrieve-a-text-selection.md)  
+ [TextBox コントロールにフォーカスを設定する](../../../../docs/framework/wpf/controls/how-to-set-focus-in-a-textbox-control.md)  
+ [TextBox コントロールのテキスト コンテンツを設定する](../../../../docs/framework/wpf/controls/how-to-set-the-text-content-of-a-textbox-control.md)  
+ [テキスト編集コントロールでスペル チェックを有効にする](../../../../docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md)  
+ [TextBox でカスタム コンテキスト メニューを使用する](../../../../docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md)  
+ [コンテキスト メニューでスペル チェックを使用する](../../../../docs/framework/wpf/controls/how-to-use-spell-checking-with-a-context-menu.md)  
+ [TextBox へのウォーターマークの追加](../../../../docs/framework/wpf/controls/how-to-add-a-watermark-to-a-textbox.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.TextBox>  
+  
+ <xref:System.Windows.Controls.RichTextBox>  
+  
+ <xref:System.Windows.Controls.TextBlock>  
+  
+ <xref:System.Windows.Controls.PasswordBox>  
+  
+## 参照  
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)   
+ [TextBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/textbox-styles-and-templates.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textbox-overview.md b/docs/framework/wpf/controls/textbox-overview.md
new file mode 100644
index 00000000000..4f302ef5c92
--- /dev/null
+++ b/docs/framework/wpf/controls/textbox-overview.md
@@ -0,0 +1,79 @@
+---
+title: "TextBox の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, TextBox"
+  - "TextBox コントロール, TextBox コントロールの概要"
+ms.assetid: 1ba6dc5b-11a7-4247-9213-36c6729ee35f
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# TextBox の概要
+<xref:System.Windows.Controls.TextBox> クラスを使用すると、書式なしテキストを表示または編集できます。  <xref:System.Windows.Controls.TextBox> は一般的に、フォームで書式なしテキストを編集するために使用されます。  たとえば、ユーザーの氏名や電話番号などの入力を求めるフォームで、テキスト入力のために <xref:System.Windows.Controls.TextBox> コントロールを使用します。  このトピックでは、<xref:System.Windows.Controls.TextBox> クラスについて説明し、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] と [!INCLUDE[TLA#tla_lhcshrp](../../../../includes/tlasharptla-lhcshrp-md.md)] の両方で使用する例を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="textbox_or_richtextbox"></a>   
+## TextBox と RichTextBox  
+ <xref:System.Windows.Controls.TextBox> と <xref:System.Windows.Controls.RichTextBox> のどちらを使用してもテキストを入力できますが、2 つのコントロールは異なるシナリオで使用されます。  <xref:System.Windows.Controls.TextBox> で必要なシステム リソースは <xref:System.Windows.Controls.RichTextBox> よりも少ないため、プレーン テキストのみを編集する必要がある場合 \(フォームでの使用\) に適しています。  <xref:System.Windows.Controls.RichTextBox> は、書式設定されたテキスト、イメージ、テーブル、またはその他のサポートされているコンテンツを編集する必要がある場合に適しています。  たとえば、書式設定やイメージなどが必要なドキュメント、記事、またはブログを編集する場合は、<xref:System.Windows.Controls.RichTextBox> を使用することをお勧めします。  <xref:System.Windows.Controls.TextBox> および <xref:System.Windows.Controls.TextBox> の主要な機能を次の表にまとめます。  
+  
+|Control|リアルタイム スペル チェック|コンテキスト メニュー|<xref:System.Windows.Documents.EditingCommands.ToggleBold%2A> \(Ctrl \+ B\) などの書式設定コマンド|イメージ、段落、テーブルなどの <xref:System.Windows.Documents.FlowDocument> コンテンツ|  
+|-------------|---------------------|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Windows.Controls.TextBox>|○|○|Ｘ|いいえ。|  
+|<xref:System.Windows.Controls.RichTextBox>|○|○|○ \([RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md) を参照\)|○ \([RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md) を参照\)|  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.TextBox> では <xref:System.Windows.Documents.EditingCommands.ToggleBold%2A> \(Ctrl \+ B\) などの書式設定関連の編集コマンドはサポートされませんが、<xref:System.Windows.Documents.EditingCommands.MoveToLineEnd%2A> などのさまざまな基本コマンドが両方のコントロールでサポートされています。  詳細については、<xref:System.Windows.Documents.EditingCommands> のトピックを参照してください。  
+  
+ <xref:System.Windows.Controls.TextBox> でサポートされる機能については、以降のセクションで説明します。  <xref:System.Windows.Controls.RichTextBox> の詳細については、「[RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)」を参照してください。  
+  
+### リアルタイム スペル チェック  
+ <xref:System.Windows.Controls.TextBox> または <xref:System.Windows.Controls.RichTextBox> では、リアルタイム スペルチェックを有効にすることができます。  スペル チェックを有効にすると、スペル ミスがある単語の下に赤い線が表示されます \(下図を参照\)。  
+  
+ ![スペル チェックを含む Textbox](../../../../docs/framework/wpf/controls/media/editing-textbox-with-spellchecking.png "Editing\_TextBox\_with\_Spellchecking")  
+  
+ スペル チェックを有効にする方法については、「[テキスト編集コントロールでスペル チェックを有効にする](../../../../docs/framework/wpf/controls/how-to-enable-spell-checking-in-a-text-editing-control.md)」を参照してください。  
+  
+### コンテキスト メニュー  
+ 既定で、<xref:System.Windows.Controls.TextBox> と <xref:System.Windows.Controls.RichTextBox> の両方に、ユーザーがコントロール内を右クリックしたときに表示されるコンテキスト メニューが用意されています。  コンテキスト メニューを使用すると、ユーザーは切り取り、コピー、または貼り付けを実行できます \(下図を参照\)。  
+  
+ ![コンテキスト メニューを含む TextBox](../../../../docs/framework/wpf/controls/media/editing-textbox-with-context-menu.png "Editing\_TextBox\_with\_Context\_Menu")  
+  
+ 独自のカスタム コンテキスト メニューを作成して、既定の動作をオーバーライドできます。  詳細については、「[TextBox でカスタム コンテキスト メニューを使用する](../../../../docs/framework/wpf/controls/how-to-use-a-custom-context-menu-with-a-textbox.md)」を参照してください。  
+  
+<a name="creating_textboxes"></a>   
+## TextBox の作成  
+ <xref:System.Windows.Controls.TextBox> は、高さを単一行にすることも、複数行から構成することもできます。  単一行の <xref:System.Windows.Controls.TextBox> は、少量のプレーンテキスト \(フォームの "  氏名" や "電話番号"  など\) の入力に適しています。  単一行の <xref:System.Windows.Controls.TextBox> を作成する方法を次の例に示します。  
+  
+ [!code-xml[TextBoxMiscSnippets_snip#BasicTextBoxExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBoxMiscSnippets_snip/csharp/basictextboxexample.xaml#basictextboxexamplewholepage)]  
+  
+ 複数行のテキストを入力できる <xref:System.Windows.Controls.TextBox> を作成することもできます。  たとえば、フォームでユーザーの簡単な経歴の入力を求める場合は、複数行のテキストをサポートする <xref:System.Windows.Controls.TextBox> を使用します。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して複数行のテキストが収まるように自動的に拡大する <xref:System.Windows.Controls.TextBox> コントロールを定義する方法を次の例に示します。  
+  
+ [!code-xml[TextBox_MiscCode#_MultilineTextBoxXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TextBox_MiscCode/CSharp/Window1.xaml#_multilinetextboxxaml)]  
+  
+ <xref:System.Windows.Controls.TextBox.TextWrapping%2A> 属性を `Wrap` に設定した場合、テキストは <xref:System.Windows.Controls.TextBox> コントロールの端に達すると次の行に折り返されます。<xref:System.Windows.Controls.TextBox> コントロールは、新しい行が収まるように必要に応じて自動的に調整されます。  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.AcceptsReturn%2A> 属性を `true` に設定した場合は、Enter キーを押すたびに新しい行が挿入されます。このときも、<xref:System.Windows.Controls.TextBox> は新しい行が収まるように必要に応じて自動的に調整されます。  
+  
+ <xref:System.Windows.Controls.Primitives.TextBoxBase.VerticalScrollBarVisibility%2A> 属性を設定すると <xref:System.Windows.Controls.TextBox> にスクロール バーが追加され、<xref:System.Windows.Controls.TextBox> がそれを囲むフレームまたはウィンドウのサイズよりも大きくなった場合は、<xref:System.Windows.Controls.TextBox> の内容をスクロールすることができます。  
+  
+ <xref:System.Windows.Controls.TextBox> の使用に関連するさまざまなタスクの詳細については、「[方法のトピック](../../../../docs/framework/wpf/controls/textbox-how-to-topics.md)」を参照してください。  
+  
+<a name="editing_commands"></a>   
+## コンテンツの変更の検出  
+ <xref:System.Windows.Controls.TextBox> または <xref:System.Windows.Controls.RichTextBox> 内のテキストが変わったことを検出するには、<xref:System.Windows.UIElement.KeyDown> イベントを使用すると思われがちですが、通常は <xref:System.Windows.Controls.Primitives.TextBoxBase.TextChanged> イベントを使用する必要があります。  例については、「[TextBox のテキストがいつ変更されたかを検出する](../../../../docs/framework/wpf/controls/how-to-detect-when-text-in-a-textbox-has-changed.md)」を参照してください。  
+  
+## 参照  
+ [方法のトピック](../../../../docs/framework/wpf/controls/textbox-how-to-topics.md)   
+ [RichTextBox の概要](../../../../docs/framework/wpf/controls/richtextbox-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textbox-styles-and-templates.md b/docs/framework/wpf/controls/textbox-styles-and-templates.md
new file mode 100644
index 00000000000..f3c7856c6bb
--- /dev/null
+++ b/docs/framework/wpf/controls/textbox-styles-and-templates.md
@@ -0,0 +1,69 @@
+---
+title: "TextBox のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], TextBox"
+  - "パーツ [WPF], TextBox"
+  - "状態 [WPF], TextBox"
+  - "スタイル [WPF], TextBox"
+  - "テンプレート [WPF], TextBox"
+  - "TextBox [WPF], スタイルおよびテンプレート"
+ms.assetid: aa99130c-43a1-450f-9b46-c40ae0db0cca
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# TextBox のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.TextBox> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## TextBox のパーツ  
+ 次の表は、<xref:System.Windows.Controls.TextBox> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ContentHost|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.FrameworkElement> 要素を含むことができるビジュアル要素です。  <xref:System.Windows.Controls.TextBox> のテキストは、この要素内に表示されます。|  
+  
+## TextBox の状態  
+ 次の表は、<xref:System.Windows.Controls.TextBox> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|ReadOnly|CommonStates|ユーザーは、<xref:System.Windows.Controls.TextBox> 内のテキストを変更できません。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## TextBox ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.TextBox> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#TextBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/textbox.xaml#textbox)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/textbox.md b/docs/framework/wpf/controls/textbox.md
new file mode 100644
index 00000000000..f1048a7a332
--- /dev/null
+++ b/docs/framework/wpf/controls/textbox.md
@@ -0,0 +1,42 @@
+---
+title: "TextBox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], TextBox"
+  - "TextBox コントロール [WPF]"
+ms.assetid: 2512a277-e9d8-4de8-a12f-2bd95e8e7b60
+caps.latest.revision: 74
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 74
+---
+# TextBox
+<xref:System.Windows.Controls.TextBox> コントロールは、WPF アプリケーションでの基本テキスト入力をサポートします。  
+  
+## このセクションの内容  
+ [TextBox の概要](../../../../docs/framework/wpf/controls/textbox-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/textbox-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.TextBox>  
+  
+ <xref:System.Windows.Controls.RichTextBox>  
+  
+ <xref:System.Windows.Controls.TextBlock>  
+  
+ <xref:System.Windows.Controls.PasswordBox>  
+  
+## 参照  
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)   
+ [TextBox のスタイルとテンプレート](../../../../docs/framework/wpf/controls/textbox-styles-and-templates.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/thumb-syles-and-templates.md b/docs/framework/wpf/controls/thumb-syles-and-templates.md
new file mode 100644
index 00000000000..175fe2fc086
--- /dev/null
+++ b/docs/framework/wpf/controls/thumb-syles-and-templates.md
@@ -0,0 +1,65 @@
+---
+title: "つまみのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], つまみ"
+  - "パーツ [WPF], つまみ"
+  - "状態 [WPF], つまみ"
+  - "スタイル [WPF], つまみ"
+  - "テンプレート [WPF], つまみ"
+  - "Thumb [WPF], スタイルおよびテンプレート"
+ms.assetid: 86a49235-62d9-414e-923e-53126e3f930a
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# つまみのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Primitives.Thumb> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## Thumb のパーツ  
+ <xref:System.Windows.Controls.Primitives.Thumb> コントロールには、名前付きのパーツは存在しません。  
+  
+## Thumb の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.Thumb> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Thumb ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Primitives.Thumb> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Thumb](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/slider.xaml#thumb)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/togglebutton-syles-and-templates.md b/docs/framework/wpf/controls/togglebutton-syles-and-templates.md
new file mode 100644
index 00000000000..4ff456e39ec
--- /dev/null
+++ b/docs/framework/wpf/controls/togglebutton-syles-and-templates.md
@@ -0,0 +1,71 @@
+---
+title: "ToggleButton のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ToggleButton"
+  - "パーツ [WPF], ToggleButton"
+  - "状態 [WPF], ToggleButton"
+  - "スタイル [WPF], ToggleButton"
+  - "テンプレート [WPF], ToggleButton"
+  - "ToggleButton [WPF], スタイルおよびテンプレート"
+ms.assetid: 54f23f30-4bcb-4f09-8ce4-376a13a255a1
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ToggleButton のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.Primitives.ToggleButton> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ToggleButton のパーツ  
+ <xref:System.Windows.Controls.Primitives.ToggleButton> コントロールには、名前付きのパーツは存在しません。  
+  
+## ToggleButton の状態  
+ 次の表は、<xref:System.Windows.Controls.Primitives.ToggleButton> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターがコントロール上に配置されています。|  
+|Pressed|CommonStates|コントロールが押されています。|  
+|Disabled|CommonStates|コントロールが無効になっています。|  
+|Focused|FocusStates|コントロールにフォーカスがあります。|  
+|Unfocused|FocusStates|コントロールにフォーカスがありません。|  
+|オン|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `true` なので、|  
+|Unchecked|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> は `false` なので、|  
+|Indeterminate|CheckStates|<xref:System.Windows.Controls.Primitives.ToggleButton.IsThreeState%2A> が `true` で、<xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> が `null` です。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+> [!NOTE]
+>  コントロール テンプレートに Indeterminate 表示状態が含まれていない場合は、既定の表示状態として Unchecked 表示状態が使用されます。  
+  
+## ToggleButton ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.Primitives.ToggleButton> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ToggleButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/combobox.xaml#togglebutton)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/toolbar-overview.md b/docs/framework/wpf/controls/toolbar-overview.md
new file mode 100644
index 00000000000..9cfc176a2ed
--- /dev/null
+++ b/docs/framework/wpf/controls/toolbar-overview.md
@@ -0,0 +1,56 @@
+---
+title: "ToolBar の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ToolBar"
+  - "ToolBar コントロール"
+ms.assetid: a8edb32c-118d-4f31-b6e6-8899082b504b
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# ToolBar の概要
+<xref:System.Windows.Controls.ToolBar> コントロールは、通常は関連性のある機能を持つコマンドまたはコントロールのグループのコンテナーです。  <xref:System.Windows.Controls.ToolBar> には、通常はコマンドを呼び出すボタンが格納されています。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="ToolBarControl"></a>   
+## ToolBar コントロール  
+ <xref:System.Windows.Controls.ToolBar> コントロールという名前は、ボタンなどのコントロールが 1 つの行または列としてバーのように整列されていることに基づいています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.ToolBar> コントロールはオーバーフロー機構を備えており、サイズが制限されている <xref:System.Windows.Controls.ToolBar> にそのままでは収まらない項目を、特殊なオーバーフロー領域に配置できます。  また、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.Controls.ToolBar> コントロールは通常、関連する <xref:System.Windows.Controls.ToolBarTray> コントロールと共に使用されます。これは、ユーザーによるツール バーのサイズ変更や配置のサポートだけでなく、特殊なレイアウト動作も提供します。  
+  
+<a name="Creating_ToolBars"></a>   
+## ToolBarTray での ToolBar の位置の指定  
+ <xref:System.Windows.Controls.ToolBar.Band%2A> プロパティと <xref:System.Windows.Controls.ToolBar.BandIndex%2A> プロパティは、<xref:System.Windows.Controls.ToolBarTray> に <xref:System.Windows.Controls.ToolBar> を配置するために使用します。  <xref:System.Windows.Controls.ToolBar.Band%2A> は、<xref:System.Windows.Controls.ToolBar> がその親 <xref:System.Windows.Controls.ToolBarTray> 内で配置される位置を示します。  <xref:System.Windows.Controls.ToolBar.BandIndex%2A> は、<xref:System.Windows.Controls.ToolBar> がそのバンド内で配置される順序を示します。  このプロパティを使用して <xref:System.Windows.Controls.ToolBar> コントロールを <xref:System.Windows.Controls.ToolBarTray> 内に配置する方法を次の例に示します。  
+  
+ [!code-xml[ToolBarExample#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolBarExample/CS/Pane1.xaml#2)]  
+  
+<a name="ToolBars_with_Overflow_Items"></a>   
+## オーバーフロー項目を持つ ToolBar  
+ <xref:System.Windows.Controls.ToolBar> コントロールに含まれる項目の数が多いために、ツール バーのサイズに収まらないことがあります。  そのような場合は、<xref:System.Windows.Controls.ToolBar> にオーバーフロー ボタンが表示されます。  オーバーフロー項目を確認するには、オーバーフロー ボタンをクリックし、<xref:System.Windows.Controls.ToolBar> の下のポップアップ ウィンドウに項目を表示します。  次の図は、オーバーフロー項目を含む <xref:System.Windows.Controls.ToolBar> を示しています。  
+  
+ ![オーバーフローを含むツール バー](../../../../docs/framework/wpf/controls/media/toolbarwithoverflowitem.png "ToolbarWithOverflowItem")  
+オーバーフロー項目を持つ ToolBar  
+  
+ ツール バーの項目がオーバーフロー パネルに配置されるタイミングを設定するには、<xref:System.Windows.Controls.ToolBar.OverflowMode%2A?displayProperty=fullName> 添付プロパティを <xref:System.Windows.Controls.OverflowMode?displayProperty=fullName>、<xref:System.Windows.Controls.OverflowMode?displayProperty=fullName>、または <xref:System.Windows.Controls.OverflowMode?displayProperty=fullName> に設定します。  次の例は、ツール バーの最後の 4 つのボタンが常にオーバーフロー パネル上に存在するように指定しています。  
+  
+ [!code-xml[ToolBarExample#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolBarExample/CS/Pane1.xaml#3)]  
+  
+ <xref:System.Windows.Controls.ToolBar> は、その <xref:System.Windows.Controls.ControlTemplate> で、<xref:System.Windows.Controls.Primitives.ToolBarPanel> と <xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel> を使用します。  <xref:System.Windows.Controls.Primitives.ToolBarPanel> は、ツール バー上の項目のレイアウトを制御します。  <xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel> は、<xref:System.Windows.Controls.ToolBar> に収まらない項目のレイアウトを制御します。  <xref:System.Windows.Controls.ToolBar> の <xref:System.Windows.Controls.ControlTemplate> の例については、次のトピックを参照してください。  
+  
+ [ToolBar のスタイルとテンプレート](../../../../docs/framework/wpf/controls/toolbar-styles-and-templates.md).  
+  
+## 参照  
+ <xref:System.Windows.Controls.Primitives.ToolBarPanel>   
+ <xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel>   
+ [ToolBar のコントロールのスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-style-controls-on-a-toolbar.md)   
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/toolbar-styles-and-templates.md b/docs/framework/wpf/controls/toolbar-styles-and-templates.md
new file mode 100644
index 00000000000..7f18d3c74b7
--- /dev/null
+++ b/docs/framework/wpf/controls/toolbar-styles-and-templates.md
@@ -0,0 +1,67 @@
+---
+title: "ToolBar のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ToolBar"
+  - "パーツ [WPF], ToolBar"
+  - "状態 [WPF], ToolBar"
+  - "スタイル [WPF], ToolBar"
+  - "テンプレート [WPF], ToolBar"
+  - "ToolBar [WPF], スタイルおよびテンプレート"
+ms.assetid: bd875f46-4690-46f5-81e0-f11a9822484f
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# ToolBar のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ToolBar> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ToolBar のパーツ  
+ 次の表は、<xref:System.Windows.Controls.ToolBar> コントロールの名前付きパーツの一覧です。  
+  
+||||  
+|-|-|-|  
+|指定項目|種類|Description|  
+|PART\_ToolBarPanel|<xref:System.Windows.Controls.Primitives.ToolBarPanel>|<xref:System.Windows.Controls.ToolBar> のコントロールを格納しているオブジェクトです。|  
+|PART\_ToolBarOverflowPanel|<xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel>|<xref:System.Windows.Controls.ToolBar> のオーバーフロー領域にあるコントロールを格納するオブジェクトです。|  
+  
+ <xref:System.Windows.Controls.ToolBar> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.ToolBar> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## ToolBar の状態  
+ 次の表は、<xref:System.Windows.Controls.ToolBar> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ToolBar ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ToolBar> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ToolBar](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/toolbar.xaml#toolbar)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/toolbar.md b/docs/framework/wpf/controls/toolbar.md
new file mode 100644
index 00000000000..51c12238795
--- /dev/null
+++ b/docs/framework/wpf/controls/toolbar.md
@@ -0,0 +1,43 @@
+---
+title: "ToolBar | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ToolBar"
+  - "ToolBar コントロール [WPF]"
+ms.assetid: 8a95d759-c298-4291-aa7e-ecdeffaae6ab
+caps.latest.revision: 65
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 65
+---
+# ToolBar
+<xref:System.Windows.Controls.ToolBar> コントロールは、通常は関連性のある機能を持つコマンドまたはコントロールのグループのコンテナーです。  
+  
+ 水平方向および垂直方向の <xref:System.Windows.Controls.ToolBar> コントロールの例を次の図に示します。  
+  
+ ![水平ツール バー](../../../../docs/framework/wpf/controls/media/ss-ctl-horztoolbar.GIF "SS\_CTL\_horztoolbar")  
+水平方向のツール バー  
+  
+ ![垂直ツール バー](../../../../docs/framework/wpf/controls/media/ss-ctl-verttoolbar.GIF "SS\_CTL\_verttoolbar")  
+垂直方向のツール バー  
+  
+## このセクションの内容  
+ [ToolBar の概要](../../../../docs/framework/wpf/controls/toolbar-overview.md)  
+ [ToolBar のコントロールのスタイルを設定する](../../../../docs/framework/wpf/controls/how-to-style-controls-on-a-toolbar.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ToolBar>  
+ <xref:System.Windows.Controls.ToolBarTray>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tooltip-how-to-topics.md b/docs/framework/wpf/controls/tooltip-how-to-topics.md
new file mode 100644
index 00000000000..72273b73362
--- /dev/null
+++ b/docs/framework/wpf/controls/tooltip-how-to-topics.md
@@ -0,0 +1,39 @@
+---
+title: "ToolTip に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, ヒント"
+  - "ToolTip コントロール, 方法トピック"
+ms.assetid: 2aa88347-c4cb-48d3-951d-a7072643283b
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# ToolTip に関する「方法」トピック
+## このセクションの内容  
+ [ToolTip を配置する](../../../../docs/framework/wpf/controls/how-to-position-a-tooltip.md)  
+ [BetweenShowDelay プロパティを使用する](../../../../docs/framework/wpf/controls/how-to-use-the-betweenshowdelay-property.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ToolTip>  
+  
+ <xref:System.Windows.Controls.ToolTipService>  
+  
+ <xref:System.Windows.Controls.Primitives.Popup>  
+  
+## 関連項目  
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)  
+  
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tooltip-overview.md b/docs/framework/wpf/controls/tooltip-overview.md
new file mode 100644
index 00000000000..3a3a16032a3
--- /dev/null
+++ b/docs/framework/wpf/controls/tooltip-overview.md
@@ -0,0 +1,87 @@
+---
+title: "ToolTip の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール, ヒント"
+  - "ToolTip コントロール, ToolTip コントロールの概要"
+ms.assetid: f06c1603-e9cb-4809-8a62-234607fc52f7
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# ToolTip の概要
+ツールヒントは、<xref:System.Windows.Controls.Button> などの要素の上にマウス ポインターを置いたときに表示される小さいポップアップ ウィンドウです。  ここでは、ツールヒントについて、およびツールヒントのコンテンツを作成およびカスタマイズする方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="what_is_a_tooltip"></a>   
+## ツールヒントとは  
+ ツールヒントを持つ要素の上にマウス ポインターを移動すると、ツールヒントのコンテンツ \(たとえば、コントロールの機能を説明するテキスト コンテンツなど\) を含むウィンドウが、指定した時間だけ表示されます。  マウス ポインターをコントロールの外に移動すると、ツールヒントのコンテンツはフォーカスを受け取ることができないので、ウィンドウは表示されなくなります。  
+  
+ ツールヒントのコンテンツには、1 行または複数行のテキスト、イメージ、図形、またはその他のビジュアル コンテンツを使用できます。  コントロールのツールヒントを定義するには、ツールヒントのコンテンツに次のいずれかのプロパティを設定します。  
+  
+-   <xref:System.Windows.FrameworkContentElement.ToolTip%2A?displayProperty=fullName>  
+  
+-   <xref:System.Windows.FrameworkElement.ToolTip%2A?displayProperty=fullName>  
+  
+ どちらのプロパティを使用するかは、ツールヒントを定義するコントロールが <xref:System.Windows.FrameworkContentElement> クラスまたは <xref:System.Windows.FrameworkElement> クラスのどちらを継承するかによります。  
+  
+<a name="create_tooltip"></a>   
+## ツールヒントの作成  
+ <xref:System.Windows.Controls.Button> コントロールの <xref:System.Windows.FrameworkElement.ToolTip%2A> プロパティにテキスト文字列を設定して、簡単なツールヒントを作成する方法を次の例に示します。  
+  
+ [!code-xml[GroupBoxSnippet#ToolTipString](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GroupBoxSnippet/CS/Window1.xaml#tooltipstring)]  
+  
+ <xref:System.Windows.Controls.ToolTip> オブジェクトとしてツールヒントを定義することもできます。  次の例では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用し、<xref:System.Windows.Controls.TextBox> 要素のツールヒントとして <xref:System.Windows.Controls.ToolTip> オブジェクトを指定します。  <xref:System.Windows.FrameworkElement.ToolTip%2A?displayProperty=fullName> プロパティを設定することで <xref:System.Windows.Controls.ToolTip> を指定していることに注意してください。  
+  
+ [!code-xml[ToolTipSimple#ToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipSimple/CSharp/Pane1.xaml#tooltip)]  
+  
+ コードを使用して <xref:System.Windows.Controls.ToolTip> オブジェクトを生成する例を次に示します。  この例では、<xref:System.Windows.Controls.ToolTip> \(`tt`\) を作成し、それを <xref:System.Windows.Controls.Button> に関連付けます。  
+  
+ [!code-csharp[ToolTipSimple#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipSimple/CSharp/Pane1.xaml.cs#2)]
+ [!code-vb[ToolTipSimple#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ToolTipSimple/VisualBasic/Window1.xaml.vb#2)]  
+  
+ ツールヒントのコンテンツを <xref:System.Windows.Controls.DockPanel> などのレイアウト要素で囲むことで、<xref:System.Windows.Controls.ToolTip> オブジェクトとして定義されていないツールヒントのコンテンツを作成することもできます。  次の例では、<xref:System.Windows.Controls.DockPanel> コントロールで囲まれているコンテンツを、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.FrameworkElement.ToolTip%2A> プロパティに設定する方法を示します。  
+  
+ [!code-xml[GroupBoxSnippet#ToolTipDockPanel](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GroupBoxSnippet/CS/Window1.xaml#tooltipdockpanel)]  
+  
+<a name="Using_the_ToolTip_and_ToolTipService_Properties"></a>   
+## ToolTip クラスと ToolTipService クラスのプロパティの使用  
+ 視覚プロパティを設定してスタイルを適用することで、ツールヒントのコンテンツをカスタマイズできます。  <xref:System.Windows.Controls.ToolTip> オブジェクトとしてツールヒントのコンテンツを定義する場合は、<xref:System.Windows.Controls.ToolTip> オブジェクトの視覚プロパティを設定できます。  それ以外の場合は、<xref:System.Windows.Controls.ToolTipService> クラスで等価の[添付プロパティ](GTMT)を設定する必要があります。  
+  
+ <xref:System.Windows.Controls.ToolTip> と <xref:System.Windows.Controls.ToolTipService> のプロパティを使用して、ツールヒントのコンテンツの位置を指定するプロパティを設定する方法の例については、「[ToolTip を配置する](../../../../docs/framework/wpf/controls/how-to-position-a-tooltip.md)」を参照してください。  
+  
+<a name="StylingToolTip"></a>   
+## ToolTip のスタイル設定  
+ カスタム <xref:System.Windows.Style> を定義することで、<xref:System.Windows.Controls.ToolTip> のスタイルを設定できます。  次の例では、<xref:System.Windows.Controls.Control.Background%2A>、<xref:System.Windows.Controls.Control.Foreground%2A>、<xref:System.Windows.Controls.Control.FontSize%2A>、および <xref:System.Windows.Controls.Control.FontWeight%2A> を設定することで <xref:System.Windows.Controls.ToolTip> の配置をオフセットして外観を変更する、`Simple` という名前の <xref:System.Windows.Style> を定義しています。  
+  
+ [!code-xml[ToolTipSimple#Style](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipSimple/CSharp/Pane1.xaml#style)]  
+  
+<a name="UsingtheToolTipServiceTimeIntervalProperties"></a>   
+## ToolTipService の時間間隔プロパティの使用  
+ <xref:System.Windows.Controls.ToolTipService> クラスで提供されている <xref:System.Windows.Controls.ToolTipService.InitialShowDelay%2A>、<xref:System.Windows.Controls.ToolTipService.BetweenShowDelay%2A>、および <xref:System.Windows.Controls.ToolTipService.ShowDuration%2A> の各プロパティを使用すると、ツールヒントの表示時間を設定できます。  
+  
+ <xref:System.Windows.Controls.ToolTip> が表示されるまでの遅延時間 \(通常は短時間\)、および <xref:System.Windows.Controls.ToolTip> が表示されている時間を指定するには、<xref:System.Windows.Controls.ToolTipService.InitialShowDelay%2A> プロパティと <xref:System.Windows.Controls.ToolTipService.ShowDuration%2A> プロパティを使用します。  詳細については、「[How to: Delay the Display of a ToolTip](http://msdn.microsoft.com/ja-jp/618e05ef-f2bf-4a53-a0f4-aacb49918bd7)」を参照してください。  
+  
+ <xref:System.Windows.Controls.ToolTipService.BetweenShowDelay%2A> プロパティは、マウス ポインターをあるコントロールから別のコントロールに移動したときに、後のコントロールのツールヒントを初期遅延なしで表示するかどうかを指定します。  <xref:System.Windows.Controls.ToolTipService.BetweenShowDelay%2A> プロパティの詳細については、「[BetweenShowDelay プロパティを使用する](../../../../docs/framework/wpf/controls/how-to-use-the-betweenshowdelay-property.md)」を参照してください。  
+  
+ 次の例では、ツールヒントにこれらのプロパティを設定する方法を示します。  
+  
+ [!code-xml[ToolTipService#ToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ToolTipService/CSharp/Pane1.xaml#tooltip)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.ToolTipService>   
+ <xref:System.Windows.Controls.ToolTip>   
+ <xref:System.Windows.Controls.ToolTipEventArgs>   
+ <xref:System.Windows.Controls.ToolTipEventHandler>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/tooltip-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tooltip-styles-and-templates.md b/docs/framework/wpf/controls/tooltip-styles-and-templates.md
new file mode 100644
index 00000000000..df0457eaa58
--- /dev/null
+++ b/docs/framework/wpf/controls/tooltip-styles-and-templates.md
@@ -0,0 +1,61 @@
+---
+title: "ToolTip のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ヒント"
+  - "パーツ [WPF], ヒント"
+  - "状態 [WPF], ヒント"
+  - "スタイル [WPF], ヒント"
+  - "テンプレート [WPF], ヒント"
+  - "ToolTip [WPF], スタイルおよびテンプレート"
+ms.assetid: 405fe385-4de9-49ee-a448-d8f4d1f740dd
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ToolTip のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.ToolTip> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ToolTip のパーツ  
+ <xref:System.Windows.Controls.ToolTip> コントロールには、名前付きのパーツは存在しません。  
+  
+## ToolTip の状態  
+ 次の表は、<xref:System.Windows.Controls.ToolTip> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Closed|OpenStates|既定の状態です。|  
+|\[Open\]|OpenStates|<xref:System.Windows.Controls.ToolTip> が表示されます。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## ToolTip ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Controls.ToolTip> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#ToolTip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/tooltip.xaml#tooltip)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/tooltip.md b/docs/framework/wpf/controls/tooltip.md
new file mode 100644
index 00000000000..bf4fdaa6835
--- /dev/null
+++ b/docs/framework/wpf/controls/tooltip.md
@@ -0,0 +1,45 @@
+---
+title: "ヒント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], ヒント"
+  - "Popup [WPF]"
+  - "ToolTip コントロール [WPF]"
+ms.assetid: a3cb42d6-6ce3-4aa0-a557-2cc5b142f1e4
+caps.latest.revision: 68
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 68
+---
+# ヒント
+ツールヒントは、<xref:System.Windows.Controls.Button> などの要素の上にマウス ポインターを置いたときに表示される小さいポップアップ ウィンドウです。  
+  
+ **\[閉じる\]** <xref:System.Windows.Controls.Button> の上にマウス ポインターを移動し、ボタンの機能を示す <xref:System.Windows.Controls.ToolTip> が表示されている状況を次の図に示します。  
+  
+ ツールヒントが表示された \[閉じる\] ボタン  
+  
+ ![ツールヒント スクリーンショット](../../../../docs/framework/wpf/controls/media/ss-ctl-tooltip.png "SS\_CTL\_tooltip")  
+  
+## このセクションの内容  
+ [ToolTip の概要](../../../../docs/framework/wpf/controls/tooltip-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/tooltip-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.ToolTip>  
+ <xref:System.Windows.Controls.ToolTipService>  
+ <xref:System.Windows.Controls.Primitives.Popup>  
+  
+## 関連項目  
+ [ポップアップの概要](../../../../docs/framework/wpf/controls/popup-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/popup-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/treeview-how-to-topics.md b/docs/framework/wpf/controls/treeview-how-to-topics.md
new file mode 100644
index 00000000000..2902891224a
--- /dev/null
+++ b/docs/framework/wpf/controls/treeview-how-to-topics.md
@@ -0,0 +1,39 @@
+---
+title: "TreeView に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール, TreeView"
+  - "TreeView コントロール, 方法トピック"
+ms.assetid: b9e9790e-7bfd-45d1-8b7a-1e0d125182a8
+caps.latest.revision: 70
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 70
+---
+# TreeView に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Controls.TreeView> コントロールを使用して情報を階層構造で表示する方法について説明します。  
+  
+## このセクションの内容  
+ [単純または複雑な TreeView を作成する](../../../../docs/framework/wpf/controls/how-to-create-simple-or-complex-treeviews.md)  
+ [SelectedValue、SelectedValuePath、および SelectedItem を使用する](../../../../docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md)  
+ [深度がわからないデータに TreeView をバインドする](../../../../docs/framework/wpf/controls/how-to-bind-a-treeview-to-data-that-has-an-indeterminable-depth.md)  
+ [TreeView のパフォーマンスを改善する](../../../../docs/framework/wpf/controls/how-to-improve-the-performance-of-a-treeview.md)  
+ [TreeView での TreeViewItem の検索](../../../../docs/framework/wpf/controls/how-to-find-a-treeviewitem-in-a-treeview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.TreeView>  
+  
+ <xref:System.Windows.Controls.TreeViewItem>  
+  
+## 関連項目
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/treeview-overview.md b/docs/framework/wpf/controls/treeview-overview.md
new file mode 100644
index 00000000000..a948b3d5b68
--- /dev/null
+++ b/docs/framework/wpf/controls/treeview-overview.md
@@ -0,0 +1,88 @@
+---
+title: "TreeView の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Control クラス, TreeView"
+  - "展開 (ノードを)"
+  - "TreeView コントロール, TreeView コントロールの概要"
+ms.assetid: 62212512-5a5c-4864-949e-b6a6a3a52c02
+caps.latest.revision: 33
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 32
+---
+# TreeView の概要
+<xref:System.Windows.Controls.TreeView> コントロールは、折りたたみ可能なノードを使用して、階層構造で情報を表示する手段を提供します。  ここでは、<xref:System.Windows.Controls.TreeView> および <xref:System.Windows.Controls.TreeViewItem> コントロールについて説明し、簡単な使用例を示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Simple_TreeView_Control"></a>   
+## TreeView とは  
+ <xref:System.Windows.Controls.TreeView> は、<xref:System.Windows.Controls.TreeViewItem> コントロールを使用して項目を入れ子にする <xref:System.Windows.Controls.ItemsControl> です。  <xref:System.Windows.Controls.TreeView> を作成する例を次に示します。  
+  
+ [!code-xml[TreeViewSnips#EmbeddedTVIs](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSnips/CSharp/Window1.xaml#embeddedtvis)]  
+  
+<a name="Creating_a_TreeView"></a>   
+## TreeView の作成  
+ <xref:System.Windows.Controls.TreeView> コントロールには、<xref:System.Windows.Controls.TreeViewItem> コントロールの階層が格納されます。  <xref:System.Windows.Controls.TreeViewItem> コントロールは、<xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> と <xref:System.Windows.Controls.ItemsControl.Items%2A> コレクションを持つ <xref:System.Windows.Controls.HeaderedItemsControl> です。  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して <xref:System.Windows.Controls.TreeView> を定義する場合は、<xref:System.Windows.Controls.TreeViewItem> コントロールの <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> コンテンツとそのコレクションを構成する項目を明示的に定義できます。  前の図は、このメソッドを示しています。  
+  
+ <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> をデータ ソースとして指定し、<xref:System.Windows.Controls.HeaderedItemsControl.HeaderTemplate%2A> と <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> を指定して <xref:System.Windows.Controls.TreeViewItem> のコンテンツを定義することもできます。  
+  
+ また、<xref:System.Windows.HierarchicalDataTemplate> オブジェクトを使用して、<xref:System.Windows.Controls.TreeViewItem> コントロールのレイアウトを定義できます。  詳細および使用例については、「[SelectedValue、SelectedValuePath、および SelectedItem を使用する](../../../../docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.TreeViewItem> コントロールでない項目は、<xref:System.Windows.Controls.TreeView> コントロールが表示されるときに、<xref:System.Windows.Controls.TreeViewItem> コントロールで自動的に囲まれます。  
+  
+<a name="Expanding_and_Collapsing_a_TreeViewItem"></a>   
+## TreeViewItem の展開と折りたたみ  
+ ユーザーが <xref:System.Windows.Controls.TreeViewItem> を展開すると、<xref:System.Windows.Controls.TreeViewItem.IsExpanded%2A> プロパティが `true` に設定されます。  また、<xref:System.Windows.Controls.TreeViewItem.IsExpanded%2A> プロパティを `true` \(展開\) または `false` \(折りたたみ\) に設定すると、直接のユーザー アクションなしに <xref:System.Windows.Controls.TreeViewItem> を展開したり折りたたんだりすることができます。  このプロパティが変更されると、<xref:System.Windows.Controls.TreeViewItem.Expanded> イベントまたは <xref:System.Windows.Controls.TreeViewItem.Collapsed> イベントが発生します。  
+  
+ <xref:System.Windows.FrameworkElement.BringIntoView%2A> メソッドが <xref:System.Windows.Controls.TreeViewItem> コントロールで呼び出されると、<xref:System.Windows.Controls.TreeViewItem> とその親 <xref:System.Windows.Controls.TreeViewItem> コントロールが展開します。  <xref:System.Windows.Controls.TreeViewItem> が表示されない、またはその一部が表示されない場合、<xref:System.Windows.Controls.TreeView> がスクロールして、表示されるようになります。  
+  
+<a name="TreeViewItem_Selection"></a>   
+## TreeViewItem の選択  
+ ユーザーが <xref:System.Windows.Controls.TreeViewItem> コントロールをクリックして選択すると、<xref:System.Windows.Controls.TreeViewItem.Selected> イベントが発生し、その <xref:System.Windows.Controls.TreeViewItem.IsSelected%2A> プロパティが `true` に設定されます。  この <xref:System.Windows.Controls.TreeViewItem> は、<xref:System.Windows.Controls.TreeView> コントロールの <xref:System.Windows.Controls.TreeView.SelectedItem%2A> にもなります。  一方、選択項目が <xref:System.Windows.Controls.TreeViewItem> コントロールから変更されると、<xref:System.Windows.Controls.TreeViewItem.Unselected> イベントが発生し、その <xref:System.Windows.Controls.TreeViewItem.IsSelected%2A> プロパティが `false` に設定されます。  
+  
+ この <xref:System.Windows.Controls.TreeView> コントロールの <xref:System.Windows.Controls.TreeView.SelectedItem%2A> プロパティは読み取り専用プロパティであるめ、明示的に設定することはできません。  <xref:System.Windows.Controls.TreeView.SelectedItem%2A> プロパティが設定されるのは、ユーザーが <xref:System.Windows.Controls.TreeViewItem> コントロールをクリックするときか、または <xref:System.Windows.Controls.TreeViewItem.IsSelected%2A> プロパティが <xref:System.Windows.Controls.TreeViewItem> コントロールで `true` に設定されるときです。  
+  
+ <xref:System.Windows.Controls.TreeView.SelectedItem%2A> の <xref:System.Windows.Controls.TreeView.SelectedValue%2A> を指定するには、<xref:System.Windows.Controls.TreeView.SelectedValuePath%2A> プロパティを使用します。  詳細については、「[SelectedValue、SelectedValuePath、および SelectedItem を使用する](../../../../docs/framework/wpf/controls/how-to-use-selectedvalue-selectedvaluepath-and-selecteditem.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.TreeView.SelectedItemChanged> イベントで、イベント ハンドラーを登録して、選択した <xref:System.Windows.Controls.TreeViewItem> を変更するタイミングを指定できます。  イベント ハンドラーに提供される <xref:System.Windows.RoutedPropertyChangedEventArgs%601> は、前の選択内容の <xref:System.Windows.RoutedPropertyChangedEventArgs%601.OldValue%2A> を指定し、現在の選択内容の <xref:System.Windows.RoutedPropertyChangedEventArgs%601.NewValue%2A> を指定します。  アプリケーションまたはユーザーが、前または現在の選択を行っていない場合、その値は `null` になります。  
+  
+<a name="TreeView_Style"></a>   
+## TreeView のスタイル  
+ <xref:System.Windows.Controls.TreeView> コントロールの既定のスタイルでは、<xref:System.Windows.Controls.ScrollViewer> コントロールを含む <xref:System.Windows.Controls.StackPanel> オブジェクト内に、コントロールが配置されます。  <xref:System.Windows.Controls.TreeView> の <xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティを設定した場合は、これらの値を使用して <xref:System.Windows.Controls.TreeView> を表示する <xref:System.Windows.Controls.StackPanel> オブジェクトのサイズが変更されます。  表示するコンテンツが表示領域より大きい場合は、<xref:System.Windows.Controls.ScrollViewer> が自動的に表示されるので、ユーザーは <xref:System.Windows.Controls.TreeView> コンテンツ全体をスクロールできます。  
+  
+ <xref:System.Windows.Controls.TreeViewItem> コントロールの外観をカスタマイズするには、<xref:System.Windows.FrameworkElement.Style%2A> プロパティをカスタムの <xref:System.Windows.Style> に設定します。  
+  
+ <xref:System.Windows.FrameworkElement.Style%2A> を使用して、<xref:System.Windows.Controls.TreeViewItem> コントロールの <xref:System.Windows.Controls.Control.Foreground%2A> および <xref:System.Windows.Controls.Control.FontSize%2A> プロパティ値を設定する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSimple#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSimple/CS/Window1.xaml#8)]  
+  
+<a name="Adding_Images_and_oOther_Content_to_TreeView_Items"></a>   
+## TreeView 項目へのイメージおよび他のコンテンツの追加  
+ 複数のオブジェクトを <xref:System.Windows.Controls.TreeViewItem> の <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> コンテンツに含めることができます。  複数のオブジェクトを <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> コンテンツに含めるには、<xref:System.Windows.Controls.Panel> または <xref:System.Windows.Controls.StackPanel> などのレイアウト コントロールで囲まれるように配置します。  
+  
+ <xref:System.Windows.Controls.TreeViewItem> の <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> を、<xref:System.Windows.Controls.DockPanel> コントロールに囲まれた <xref:System.Windows.Controls.CheckBox> および <xref:System.Windows.Controls.TextBlock> として定義する方法を次の例に示します。  
+  
+ [!code-xml[TreeViewSnips#TVIHeader](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewSnips/CSharp/Window1.xaml#tviheader)]  
+  
+ <xref:System.Windows.Controls.DockPanel> コントロールに囲まれた <xref:System.Windows.Controls.Image> と <xref:System.Windows.Controls.TextBlock> を含む <xref:System.Windows.DataTemplate> を定義する方法を次の例に示します。  <xref:System.Windows.DataTemplate> を使用して、<xref:System.Windows.Controls.TreeViewItem> の <xref:System.Windows.Controls.HeaderedItemsControl.HeaderTemplate%2A> または <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> を設定できます。  
+  
+ [!code-xml[TreeViewDataBinding#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TreeViewDataBinding/CSharp/Window1.xaml#6)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.TreeView>   
+ <xref:System.Windows.Controls.TreeViewItem>   
+ [方法のトピック](../../../../docs/framework/wpf/controls/treeview-how-to-topics.md)   
+ [WPF のコンテンツ モデル](../../../../docs/framework/wpf/controls/wpf-content-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/treeview-styles-and-templates.md b/docs/framework/wpf/controls/treeview-styles-and-templates.md
new file mode 100644
index 00000000000..f59230c07fb
--- /dev/null
+++ b/docs/framework/wpf/controls/treeview-styles-and-templates.md
@@ -0,0 +1,89 @@
+---
+title: "TreeView のスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], TreeView"
+  - "パーツ [WPF], TreeView"
+  - "状態 [WPF], TreeView"
+  - "スタイル [WPF], TreeView"
+  - "テンプレート [WPF], TreeView"
+  - "TreeView [WPF], スタイルおよびテンプレート"
+ms.assetid: a49adb77-0202-4caa-b94a-8bb110d7fa9a
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# TreeView のスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Controls.TreeView> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## TreeView のパーツ  
+ <xref:System.Windows.Controls.TreeView> コントロールには、名前付きのパーツは存在しません。  
+  
+ <xref:System.Windows.Controls.TreeView> の <xref:System.Windows.Controls.ControlTemplate> を作成するときに、テンプレートの <xref:System.Windows.Controls.ScrollViewer> 内に <xref:System.Windows.Controls.ItemsPresenter> が含まれる場合があります。  <xref:System.Windows.Controls.ItemsPresenter> により、<xref:System.Windows.Controls.TreeView> の各項目が表示されます。また、<xref:System.Windows.Controls.ScrollViewer> により、コントロール内でスクロールできるようになります。  <xref:System.Windows.Controls.ItemsPresenter> が <xref:System.Windows.Controls.ScrollViewer> の直接の子でない場合は、<xref:System.Windows.Controls.ItemsPresenter> に `ItemsPresenter` という名前を付ける必要があります。  
+  
+## TreeView の状態  
+ 次の表は、<xref:System.Windows.Controls.TreeView> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## TreeViewItem のパーツ  
+ 次の表は、<xref:System.Windows.Controls.TreeViewItem> コントロールの名前付きパーツの一覧です。  
+  
+|指定項目|種類|Description|  
+|----------|--------|-----------------|  
+|PART\_Header|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.Controls.TreeView> コントロールのヘッダーの内容を格納しているビジュアル要素です。|  
+  
+## TreeViewItem の状態  
+ 次の表は、<xref:System.Windows.Controls.TreeViewItem> コントロールの表示状態の一覧です。  
+  
+|VisualState 名|VisualStateGroup 名|Description|  
+|-------------------|------------------------|-----------------|  
+|Normal|CommonStates|既定の状態です。|  
+|MouseOver|CommonStates|マウス ポインターは、<xref:System.Windows.Controls.TreeViewItem> の上に置かれています。|  
+|Disabled|CommonStates|<xref:System.Windows.Controls.TreeViewItem> が無効になっています。|  
+|Focused|FocusStates|<xref:System.Windows.Controls.TreeViewItem> にフォーカスがあります。|  
+|Unfocused|FocusStates|<xref:System.Windows.Controls.TreeViewItem> にフォーカスがありません。|  
+|Expanded|ExpansionStates|<xref:System.Windows.Controls.TreeViewItem> コントロールが展開されています。|  
+|Collapsed|ExpansionStates|<xref:System.Windows.Controls.TreeViewItem> コントロールが折りたたまれています。|  
+|HasItems|HasItemsStates|<xref:System.Windows.Controls.TreeViewItem> に項目が含まれています。|  
+|NoItems|HasItemsStates|<xref:System.Windows.Controls.TreeViewItem> に項目が含まれていません。|  
+|Selected|SelectionStates|<xref:System.Windows.Controls.TreeViewItem> が選択されています。|  
+|SelectedInactive|SelectionStates|<xref:System.Windows.Controls.TreeViewItem> が選択されていますが、アクティブではありません。|  
+|Unselected|SelectionStates|<xref:System.Windows.Controls.TreeViewItem> が選択されていません。|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## TreeView ControlTemplate の例  
+ <xref:System.Windows.Controls.TreeView> コントロールの <xref:System.Windows.Controls.ControlTemplate> およびその関連付けられた型を定義する方法を次の例に示します。  
+  
+ [!code-xml[ControlTemplateExamples#TreeView](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/treeview.xaml#treeview)]  
+  
+ 前の例では、次の 1 つ以上のリソースを使用しています。  
+  
+ [!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、「[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)」を参照してください。.  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/treeview.md b/docs/framework/wpf/controls/treeview.md
new file mode 100644
index 00000000000..ad94db8210e
--- /dev/null
+++ b/docs/framework/wpf/controls/treeview.md
@@ -0,0 +1,42 @@
+---
+title: "TreeView | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], TreeView"
+  - "階層構造 [WPF], TreeView コントロール"
+  - "TreeView コントロール [WPF]"
+ms.assetid: 805c235c-0a0e-4e34-8d96-9dc3865cf2df
+caps.latest.revision: 64
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 64
+---
+# TreeView
+<xref:System.Windows.Controls.TreeView> コントロールは、折りたたみ可能なノードを使用して、階層構造で情報を表示します。  
+  
+ <xref:System.Windows.Controls.TreeViewItem> コントロールを入れ子にした <xref:System.Windows.Controls.TreeView> コントロールの例を次の図に示します。  
+  
+ ![TreeView の図](../../../../docs/framework/wpf/controls/media/treeviewillustration.JPG "TreeViewIllustration")  
+  
+## このセクションの内容  
+ [TreeView の概要](../../../../docs/framework/wpf/controls/treeview-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/controls/treeview-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.TreeView>  
+ <xref:System.Windows.Controls.TreeViewItem>  
+  
+## 関連項目  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)  
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/ui-automation-of-a-wpf-custom-control.md b/docs/framework/wpf/controls/ui-automation-of-a-wpf-custom-control.md
new file mode 100644
index 00000000000..35ed813bbdd
--- /dev/null
+++ b/docs/framework/wpf/controls/ui-automation-of-a-wpf-custom-control.md
@@ -0,0 +1,164 @@
+---
+title: "WPF カスタム コントロールの UI オートメーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "UI オートメーションを適用するカスタム コントロール [WPF]"
+  - "カスタム コントロールに適用することにユーザー補助 [WPF]"
+  - "ユーザー補助機能を向上させるカスタム コントロール [WPF]"
+  - "カスタム コントロールで使用する UI オートメーション [WPF]"
+ms.assetid: 47b310fc-fbd5-4ce2-a606-22d04c6d4911
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# WPF カスタム コントロールの UI オートメーション
+[!INCLUDE[TLA#tla_uiautomation](../../../../includes/tlasharptla-uiautomation-md.md)]クライアントを確認またはさまざまなプラットフォームやフレームワークのユーザー インターフェイスの操作を使用してその自動化機能を単一の汎用的なインターフェイスを提供します。 [!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]品質保証 (テスト) のコードとユーザー インターフェイス要素を調べて、他のコードからそれらにユーザーの操作をシュミレーションにスクリーン リーダーなどのユーザー補助アプリケーションの両方を使用できます。 については[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]すべてのプラットフォームでは、ユーザー補助機能を参照してください。  
+  
+ このトピックでは、WPF アプリケーションで実行されるカスタム コントロール用のサーバー側 UI オートメーション プロバイダーを実装する方法について説明します。 WPF でサポートされる[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]ピア オートメーション オブジェクトのツリーで、ユーザー インターフェイス要素のツリーに似ています。 コードとユーザー補助機能がピア オブジェクトを使用して直接 (インプロセス コード用) を提供するアプリケーションをテストまたは汎用化されたインターフェイスによって提供される[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]します。  
+  
+ 
+  
+<a name="AutomationPeerClasses"></a>   
+## <a name="automation-peer-classes"></a>オートメーション ピア クラス  
+ コントロールがサポートする WPF[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]ピア クラスから派生するツリーを通じた<xref:System.Windows.Automation.Peers.AutomationPeer>します。 規則は、ピア クラス名は、コントロールのクラス名で始まるし、"AutomationPeer"で終了します。 たとえば、 <xref:System.Windows.Automation.Peers.ButtonAutomationPeer>のピア クラスである、<xref:System.Windows.Controls.Button>コントロール クラス。 ピア クラスはほぼ同じ[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]コントロール型が、合わせて[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]要素。 オートメーション コード経由での WPF アプリケーションにアクセスする、[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]インターフェイスがオートメーション ピアを直接使用されませんが、同じプロセス空間での自動化のサンプル コードでは、オートメーション ピアを直接使用することができます。  
+  
+<a name="BuiltInAutomationPeerClasses"></a>   
+## <a name="built-in-automation-peer-classes"></a>組み込みのオートメーション ピア クラス  
+ 要素は、スクリーン リーダー アプリケーションのユーザーによって必要な情報が含まれている場合や、ユーザー インターフェイスのアクティビティを受け入れる場合、オートメーション ピア クラスを実装します。 すべての WPF のビジュアル要素は、オートメーションのピアを持っています。 オートメーション ピアを実装するクラスの例としては、<xref:System.Windows.Controls.Button>、 <xref:System.Windows.Controls.TextBox>と<xref:System.Windows.Controls.Label>します。 オートメーション ピアを実装していないクラスの例から派生するクラスには<xref:System.Windows.Controls.Decorator>など<xref:System.Windows.Controls.Border>とクラスに基づいて<xref:System.Windows.Controls.Panel>など<xref:System.Windows.Controls.Grid>と<xref:System.Windows.Controls.Canvas>します。  
+  
+ 基本<xref:System.Windows.Controls.Control>クラスには、対応するピア クラスがありません。 ピア クラスから派生するカスタム コントロールに対応する必要がある場合<xref:System.Windows.Controls.Control>からカスタム ピア クラスを派生する必要があります<xref:System.Windows.Automation.Peers.FrameworkElementAutomationPeer>します。  
+  
+<a name="SecurityConsiderations"></a>   
+## <a name="security-considerations-for-derived-peers"></a>派生ピアのセキュリティの考慮事項  
+ オートメーション ピアは、部分的に信頼された環境で実行する必要があります。 UIAutomationClient アセンブリ内のコードが部分的に信頼された環境で実行が構成されていないと、オートメーション ピアのコードは、そのアセンブリを参照しないでください。 代わりに、UIAutomationTypes アセンブリのクラスを使用する必要があります。 たとえば、使用する必要があります、 <xref:System.Windows.Automation.AutomationElementIdentifiers>クラスに対応する UIAutomationTypes アセンブリから、 <xref:System.Windows.Automation.AutomationElement> UIAutomationClient アセンブリ内のクラスです。 オートメーション ピアのコードで UIAutomationTypes アセンブリを参照すると安全です。  
+  
+<a name="PeerNavigation"></a>   
+## <a name="peer-navigation"></a>ピアのナビゲーション  
+ オートメーション ピアを特定すると、プロセス内のコードを呼び出して、オブジェクトのピア ツリーを移動できます<xref:System.Windows.Automation.Peers.AutomationPeer.GetChildren%2A>と<xref:System.Windows.Automation.Peers.AutomationPeer.GetParent%2A>メソッドです。 間のナビゲーション[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]のピアの実装によって、コントロール内の要素がサポートされている、 <xref:System.Windows.Automation.Peers.AutomationPeer.GetChildrenCore%2A>メソッドです。 UI オートメーション システムは、コントロール内に含まれるサブ要素のツリーを構築するには、このメソッドを呼び出しますたとえば、リスト ボックス内の項目を一覧表示します。 既定値<xref:System.Windows.Automation.Peers.UIElementAutomationPeer.GetChildrenCore%2A?displayProperty=fullName>メソッドは、オートメーション ピアのツリーを構築する要素のビジュアル ツリーを走査します。 カスタム コントロールは、子要素を返す情報を伝達するか、ユーザーによる操作が許可される要素のオートメーション ピア オートメーション クライアントに公開するには、このメソッドをオーバーライドします。  
+  
+<a name="Customizations"></a>   
+## <a name="customizations-in-a-derived-peer"></a>派生のピアでのカスタマイズ  
+ すべてのクラスから派生した<xref:System.Windows.UIElement>と<xref:System.Windows.ContentElement>プロテクト仮想メソッドが含まれて<xref:System.Windows.UIElement.OnCreateAutomationPeer%2A>します。 WPF 呼び出し<xref:System.Windows.UIElement.OnCreateAutomationPeer%2A>各コントロールのオートメーションのピア オブジェクトを取得します。 コントロールの特性と機能に関する情報を取得し、対話型の使用をシミュレートするために、自動化のサンプル コードは、ピアを使用できます。 オートメーションをサポートするカスタム コントロールをオーバーライドする必要があります<xref:System.Windows.UIElement.OnCreateAutomationPeer%2A>から派生したクラスのインスタンスを返すと<xref:System.Windows.Automation.Peers.AutomationPeer>します。 たとえば、カスタム コントロールから派生している場合、 <xref:System.Windows.Controls.Primitives.ButtonBase>クラス、オブジェクトによって返される<xref:System.Windows.UIElement.OnCreateAutomationPeer%2A>から派生する必要があります<xref:System.Windows.Automation.Peers.ButtonBaseAutomationPeer>します。  
+  
+ カスタム コントロールを実装する場合は、カスタム コントロールに固有の動作を説明する基本オートメーション ピア クラスからの"Core"メソッドをオーバーライドする必要があります。  
+  
+### <a name="override-oncreateautomationpeer"></a>OnCreateAutomationPeer をオーバーライドします。  
+ オーバーライド、 <xref:System.Windows.UIElement.OnCreateAutomationPeer%2A>メソッドを返す、プロバイダー オブジェクトから直接または間接的に派生する必要がありますので、カスタム コントロールの<xref:System.Windows.Automation.Peers.AutomationPeer>します。  
+  
+### <a name="override-getpattern"></a>GetPattern をオーバーライドします。  
+ オートメーション ピアは、サーバー側の実装の一部を簡略化[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]パターン インターフェイスは、プロバイダーがカスタム コントロールのオートメーションのピアで処理も必要があります。 WPF 以外のプロバイダーのようにピア コントロール パターンのサポートでのインターフェイスの実装を提供することにより、 <xref:System.Windows.Automation.Provider?displayProperty=fullName>名前空間など<xref:System.Windows.Automation.Provider.IInvokeProvider>します。 ピア自体または別のオブジェクトによっては、コントロール パターンのインターフェイスを実装することができます。 ピアの<xref:System.Windows.Automation.Peers.AutomationPeer.GetPattern%2A>指定したパターンをサポートするオブジェクトを返します。 [!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]コードの呼び出し、 <xref:System.Windows.Automation.Peers.UIElementAutomationPeer.GetPattern%2A>メソッドを指定し、 <xref:System.Windows.Automation.Peers.PatternInterface>列挙値。 オーバーライド<xref:System.Windows.Automation.Peers.UIElementAutomationPeer.GetPattern%2A>指定したパターンを実装するオブジェクトを返す必要があります。 コントロールが、パターンのカスタム実装を持たない場合の基本型の実装を呼び出すことができます<xref:System.Windows.Automation.Peers.AutomationPeer.GetPattern%2A>をこの種類のコントロールのパターンがサポートされていない場合、実装、または null のいずれかを取得します。 カスタム NumericUpDown コントロールを設定して、範囲内の値になど、その[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]ピアを実装、 <xref:System.Windows.Automation.Provider.IRangeValueProvider>インターフェイスです。 例を次にどのようにピアの<xref:System.Windows.Automation.Peers.UIElementAutomationPeer.GetPattern%2A>に応答するメソッドがオーバーライドされる、 <xref:System.Windows.Automation.Peers.PatternInterface?displayProperty=fullName>値。  
+  
+ [!code-csharp[CustomControlNumericUpDown#GetPattern](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomControlNumericUpDown/CSharp/CustomControlLibrary/NumericUpDown.cs#getpattern)]
+ [!code-vb[CustomControlNumericUpDown#GetPattern](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomControlNumericUpDown/visualbasic/customcontrollibrary/numericupdown.vb#getpattern)]  
+  
+ A <xref:System.Windows.Automation.Peers.UIElementAutomationPeer.GetPattern%2A>メソッドではパターン プロバイダーとしてのサブ要素を指定してもできます。 次のコードはどのように<xref:System.Windows.Controls.ItemsControl>転送は、内部のピアにパターンの処理をスクロール<xref:System.Windows.Controls.ScrollViewer>コントロールです。  
+  
+```csharp  
+public override object GetPattern(PatternInterface patternInterface)  
+{  
+    if (patternInterface == PatternInterface.Scroll)  
+    {  
+        ItemsControl owner = (ItemsControl) base.Owner;  
+  
+        // ScrollHost is internal to the ItemsControl class  
+        if (owner.ScrollHost != null)  
+        {  
+            AutomationPeer peer = UIElementAutomationPeer.CreatePeerForElement(owner.ScrollHost);  
+            if ((peer != null) && (peer is IScrollProvider))  
+            {  
+                peer.EventsSource = this;  
+                return (IScrollProvider) peer;  
+            }  
+        }  
+    }  
+    return base.GetPattern(patternInterface);  
+}  
+```  
+  
+```vb  
+Public Class Class1  
+    Public Overrides Function GetPattern(ByVal patternInterface__1 As PatternInterface) As Object  
+        If patternInterface1 = PatternInterface.Scroll Then  
+            Dim owner As ItemsControl = DirectCast(MyBase.Owner, ItemsControl)  
+  
+            ' ScrollHost is internal to the ItemsControl class  
+            If owner.ScrollHost IsNot Nothing Then  
+                Dim peer As AutomationPeer = UIElementAutomationPeer.CreatePeerForElement(owner.ScrollHost)  
+                If (peer IsNot Nothing) AndAlso (TypeOf peer Is IScrollProvider) Then  
+                    peer.EventsSource = Me  
+                    Return DirectCast(peer, IScrollProvider)  
+                End If  
+            End If  
+        End If  
+        Return MyBase.GetPattern(patternInterface1)  
+    End Function  
+End Class  
+```  
+  
+ このコード パターンの処理のためのサブ要素を指定するサブ要素オブジェクトを取得を使用してピアを作成、 <xref:System.Windows.Automation.Peers.UIElementAutomationPeer.CreatePeerForElement%2A>メソッドでは、設定、 <xref:System.Windows.Automation.Peers.AutomationPeer.EventsSource%2A>を現在のピアでは、新しいピアのプロパティを新しいピアを返します。 設定<xref:System.Windows.Automation.Peers.AutomationPeer.EventsSource%2A>サブ要素のサブ要素をオートメーション ピア ツリーに表示されると、サブ要素によって生成されるすべてのイベントを指定で指定したコントロールから発信されている<xref:System.Windows.Automation.Peers.AutomationPeer.EventsSource%2A>します。 <xref:System.Windows.Controls.ScrollViewer>コントロールは、オートメーション ツリーには表示されずから発生したように、生成されるスクロールのイベントが表示されます、 <xref:System.Windows.Controls.ItemsControl>オブジェクトです。  
+  
+### <a name="override-core-methods"></a>"Core"メソッドをオーバーライドします。  
+ 自動化のサンプル コードでは、ピア クラスのパブリック メソッドを呼び出して、コントロールに関する情報を取得します。 コントロールに関する情報を提供するには、基本オートメーション ピア クラスで提供されているものとは異なり、コントロールの実装時に"Core"で終わる名前を持つ各メソッドをオーバーライドします。 少なくとも、コントロールを実装する必要があります、 <xref:System.Windows.Automation.Peers.AutomationPeer.GetClassNameCore%2A>と<xref:System.Windows.Automation.Peers.AutomationPeer.GetAutomationControlTypeCore%2A>メソッドは、次の例で示すようにします。  
+  
+ [!code-csharp[CustomControlNumericUpDown#CoreOverrides](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomControlNumericUpDown/CSharp/CustomControlLibrary/NumericUpDown.cs#coreoverrides)]
+ [!code-vb[CustomControlNumericUpDown#CoreOverrides](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomControlNumericUpDown/visualbasic/customcontrollibrary/numericupdown.vb#coreoverrides)]  
+  
+ 実装<xref:System.Windows.Automation.Peers.AutomationPeer.GetAutomationControlTypeCore%2A>を返すことによって、コントロールの説明、 <xref:System.Windows.Automation.ControlType>値。 返すことができますが<xref:System.Windows.Automation.ControlType.Custom?displayProperty=fullName>コントロールを正確に記述されている場合より特定のコントロール型の&1; つ返す必要があります。 戻り値<xref:System.Windows.Automation.ControlType.Custom?displayProperty=fullName>を実装するプロバイダーの追加の作業が必要[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]、および[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]クライアント製品は、制御構造、キーボード操作、および使用できるコントロール パターンを予測することはできません。  
+  
+ 実装、 <xref:System.Windows.Automation.Peers.AutomationPeer.IsContentElementCore%2A>と<xref:System.Windows.Automation.Peers.AutomationPeer.IsControlElementCore%2A>コントロールがデータの内容が含まれていますか (またはその両方) をユーザー インターフェイスで対話型のロールを満たすかどうかを示すメソッドです。 既定では、両方のメソッドが返す`true`します。 これらの設定には、オートメーション ツリーをフィルター処理するこれらのメソッドを使用するスクリーン リーダーなどの自動化ツールの使いやすさが向上します。 場合、 <xref:System.Windows.Automation.Peers.AutomationPeer.GetPattern%2A>サブエレメント ピアに、サブ要素のピアの処理メソッド転送パターン<xref:System.Windows.Automation.Peers.AutomationPeer.IsControlElementCore%2A>メソッドは、オートメーション ツリーからのサブ要素のピアを非表示にする場合は false で返すことができます。 スクロールなど、 <xref:System.Windows.Controls.ListBox>によって処理、 <xref:System.Windows.Controls.ScrollViewer>、およびのオートメーション ピア<xref:System.Windows.Automation.Peers.PatternInterface?displayProperty=fullName>によって返される、 <xref:System.Windows.Automation.Peers.AutomationPeer.GetPattern%2A>のメソッド、 <xref:System.Windows.Automation.Peers.ScrollViewerAutomationPeer>と関連付けられている、 <xref:System.Windows.Automation.Peers.ListBoxAutomationPeer>します。そのため、 <xref:System.Windows.Automation.Peers.AutomationPeer.IsControlElementCore%2A>のメソッド、 <xref:System.Windows.Automation.Peers.ScrollViewerAutomationPeer>を返します`false`れるため、 <xref:System.Windows.Automation.Peers.ScrollViewerAutomationPeer>オートメーション ツリーがないです。  
+  
+ オートメーション ピアは、コントロールの適切な既定値を指定する必要があります。 注コントロールを参照する XAML を含めることによって、ピア実装の重要なメソッドをオーバーライドできます<xref:System.Windows.Automation.AutomationProperties>属性です。 たとえば、次の XAML がボタンをクリックし、2 つのカスタマイズを作成[!INCLUDE[TLA2#tla_uiautomation](../../../../includes/tla2sharptla-uiautomation-md.md)]プロパティです。  
+  
+```xaml  
+<Button AutomationProperties.Name="Special"   
+    AutomationProperties.HelpText="This is a special button."/>  
+```  
+  
+### <a name="implement-pattern-providers"></a>プロバイダーのパターンを実装します。  
+ 所有している要素から直接派生している場合に、カスタム プロバイダーによって実装されるインターフェイスが明示的に宣言される<xref:System.Windows.Controls.Control>します。 たとえば、次のコードがピアを宣言して、<xref:System.Windows.Controls.Control>範囲の値を実装します。  
+  
+```csharp  
+public class RangePeer1 : FrameworkElementAutomationPeer, IRangeValueProvider { }  
+```  
+  
+```vb  
+Public Class RangePeer1  
+    Inherits FrameworkElementAutomationPeer  
+    Implements IRangeValueProvider  
+End Class  
+```  
+  
+ かどうかは所有しているコントロールから派生したコントロールの特定の種類など、 <xref:System.Windows.Controls.Primitives.RangeBase>ピアは、同等の派生ピア クラスから派生できます。 ここでは、ピアがから派生は<xref:System.Windows.Automation.Peers.RangeBaseAutomationPeer>の基本実装を提供する<xref:System.Windows.Automation.Provider.IRangeValueProvider>します。 次のコードでは、このようなピアの宣言を示します。  
+  
+```csharp  
+public class RangePeer2 : RangeBaseAutomationPeer { }  
+```  
+  
+```vb  
+Public Class RangePeer2  
+    Inherits RangeBaseAutomationPeer  
+End Class  
+```  
+  
+ 、実装の例を参照してください。 [NumericUpDown カスタム コントロールおよびテーマと UI オートメーションのサポートのサンプル](http://go.microsoft.com/fwlink/?LinkID=160025)します。  
+  
+### <a name="raise-events"></a>イベントを発生させる  
+ オートメーション クライアントは、オートメーション イベントをサブスクライブできます。 カスタム コントロールは、呼び出すことによってコントロールの状態に対する変更を報告する必要があります、 <xref:System.Windows.Automation.Peers.AutomationPeer.RaiseAutomationEvent%2A>メソッドです。 同様に、プロパティの値の変更されたときに呼び出す、 <xref:System.Windows.Automation.Peers.AutomationPeer.RaisePropertyChangedEvent%2A>メソッドです。 次のコードでは、コントロールのコード内からピア オブジェクトを取得し、イベントを発生させるメソッドを呼び出す方法を示します。 最適化の手法としては、コードは、この種類のイベントのリスナーがあるかどうかを判断します。 リスナーがある場合にのみイベントを発生させると、不要なオーバーヘッドを回避し、応答性を維持する制御に役立ちます。  
+  
+ [!code-csharp[CustomControlNumericUpDown#RaiseEventFromControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CustomControlNumericUpDown/CSharp/CustomControlLibrary/NumericUpDown.cs#raiseeventfromcontrol)]
+ [!code-vb[CustomControlNumericUpDown#RaiseEventFromControl](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CustomControlNumericUpDown/visualbasic/customcontrollibrary/numericupdown.vb#raiseeventfromcontrol)]  
+  
+## <a name="see-also"></a>関連項目  
+ [UI オートメーションの概要](../../../../docs/framework/ui-automation/ui-automation-overview.md)   
+ [NumericUpDown カスタム コントロールおよびテーマと UI オートメーションのサポートのサンプル](http://go.microsoft.com/fwlink/?LinkID=160025)   
+ [サーバー側 UI オートメーション プロバイダーの実装](../../../../docs/framework/ui-automation/server-side-ui-automation-provider-implementation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/viewbox.md b/docs/framework/wpf/controls/viewbox.md
new file mode 100644
index 00000000000..e8d3b168838
--- /dev/null
+++ b/docs/framework/wpf/controls/viewbox.md
@@ -0,0 +1,38 @@
+---
+title: "Viewbox | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コントロール [WPF], Viewbox"
+  - "スケーリング (要素を) [WPF], Viewbox コントロール"
+  - "引き伸ばし (要素を) [WPF], Viewbox コントロール"
+  - "Viewbox コントロール [WPF]"
+ms.assetid: 00fc0a16-1078-4d55-9849-ffaf7da96531
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# Viewbox
+<xref:System.Windows.Controls.Viewbox> コントロールは、子要素を伸縮またはスケーリングするために使用します。  
+  
+## このセクションの内容  
+ [Viewbox のコンテンツに Stretch プロパティを適用する](../../../../docs/framework/wpf/controls/how-to-apply-stretch-properties-to-the-contents-of-a-viewbox.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Viewbox>  
+  
+ <xref:System.Windows.Controls.Image>  
+  
+## 参照  
+ [WPF コントロール ギャラリーのサンプル](http://go.microsoft.com/fwlink/?LinkID=160053)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md b/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md
new file mode 100644
index 00000000000..f383df40de4
--- /dev/null
+++ b/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md
@@ -0,0 +1,262 @@
+---
+title: "チュートリアル : Microsoft Expression Blend を使用してボタンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ボタン"
+  - "変換, 図形をボタンに"
+  - "Expression Blend [WPF デザイナー]"
+ms.assetid: ff5037c2-bba7-4cae-8abb-6475b686c48e
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# チュートリアル : Microsoft Expression Blend を使用してボタンを作成する
+このチュートリアルでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のカスタマイズされたボタンを Microsoft Expression Blend を使用して作成する手順について説明します。  
+  
+> [!IMPORTANT]
+>  Microsoft Expression Blend の具体的な動作は [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の生成で、これがコンパイルされ、実行可能プログラムが作成されます。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を直接扱う場合については、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を Blend ではなく [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して、これと同じアプリケーションを作成する別のチュートリアルが用意されています。  詳細については、「[XAML を使用したボタンの作成](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md)」を参照してください。  
+  
+ これから作成する、カスタマイズされたボタンを次の図に示します。  
+  
+ ![ユーザーが作成するカスタマイズされたボタン](../../../../docs/framework/wpf/controls/media/custom-button-blend-intro.png "custom\_button\_blend\_Intro")  
+  
+## 図形からボタンへの変換  
+ このチュートリアルの前半では、カスタム ボタンの独自の外観を作成します。  作成するには、まず四角形をボタンに変換します。  次に、他の図形をボタンのテンプレートに追加し、より複雑な外観のボタンを作成します。  ここでは、通常のボタンを使用してカスタマイズします。  ボタンには今回は使用しない組み込み機能があるので、カスタム ボタンを作成するには、四角形から始める方が簡単です。  
+  
+#### Expression Blend で新しいプロジェクトを作成するには  
+  
+1.  Expression Blend を起動します   \(**\[スタート\]** をクリックし、**\[すべてのプログラム\]**、**\[Microsoft Expression\]**、**\[Microsoft Expression Blend\]** の順にポイントします\)。  
+  
+2.  必要に応じて、アプリケーションを最大化します。  
+  
+3.  **\[ファイル\]** メニューの **\[新しいプロジェクト\]** をクリックします。  
+  
+4.  **\[標準アプリケーション \(.exe\)\]** を選択します。  
+  
+5.  プロジェクトの名前を「`CustomButton`」と指定して、**\[OK\]** をクリックします。  
+  
+ この時点で、空の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] プロジェクトができます。  F5 キーを押すと、アプリケーションを実行できます。  予想どおり、アプリケーションは空のウィンドウのみで構成されていることがわかります。  次に、角の丸い四角形を作成し、それをボタンに変換します。  
+  
+#### 四角形をボタンに変換するには  
+  
+1.  **ウィンドウの背景プロパティを黒に設定します。**ウィンドウを選択して **\[プロパティ\]** タブをクリックし、<xref:System.Windows.Controls.Control.Background%2A> プロパティを `Black` に設定します。  
+  
+     ![ボタンの背景を黒に設定する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-changebackground.png "custom\_button\_blend\_ChangeBackground")  
+  
+2.  **大きさがボタンのサイズに近い四角形をウィンドウ上に描画します。**左側のツール パネルで四角形ツールを選択し、ウィンドウ上でドラッグして四角形を描画します。  
+  
+     ![四角形を描画する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-drawrect.png "custom\_button\_blend\_DrawRect")  
+  
+3.  **四角形の四隅を丸めます。**四角形の制御点をドラッグするか、<xref:System.Windows.Shapes.Rectangle.RadiusX%2A> プロパティと <xref:System.Windows.Shapes.Rectangle.RadiusY%2A> プロパティを直接設定します。  <xref:System.Windows.Shapes.Rectangle.RadiusX%2A> と <xref:System.Windows.Shapes.Rectangle.RadiusY%2A> の値を 20 に設定します。  
+  
+     ![四角形の角を丸くする方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-roundcorners.png "custom\_button\_blend\_RoundCorners")  
+  
+4.  **四角形をボタンに変換します。**四角形を選択します。  **\[ツール\]** メニューの **\[ボタンの作成\]** をクリックします。  
+  
+     ![図形をボタンにする方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-makebutton.png "custom\_button\_blend\_MakeButton")  
+  
+5.  **スタイル\/テンプレートのスコープを指定します。**次のようなダイアログ ボックスが表示されます。  
+  
+     ![&#91;Style リソースの作成&#93; ダイアログ ボックス](../../../../docs/framework/wpf/controls/media/custom-button-blend-makebutton2.gif "custom\_button\_blend\_MakeButton2")  
+  
+     **\[リソース名 \(キー\)\]** で、**\[すべてに適用\]** を選択します。  これにより、生成されるスタイルとボタン テンプレートが、ボタンであるすべてのオブジェクトに適用されます。  **\[定義元\]** で、**\[アプリケーション\]** を選択します。  これにより、生成されるスタイルとボタン テンプレートのスコープが、アプリケーション全体になります。  この 2 つのボックスに値を設定すると、ボタンのスタイルとテンプレートはアプリケーション全体に含まれるすべてのボタンに適用され、アプリケーションで作成するボタンには既定でこのテンプレートが使用されます。  
+  
+## ボタン テンプレートの編集  
+ 現在、ボタンに変更された四角形があります。  このセクションでは、ボタンのテンプレートを変更して、外観をさらにカスタマイズします。  
+  
+#### ボタンの外観を変更するためにボタン テンプレートを編集するには  
+  
+1.  **テンプレートの表示ビューに移動します。**ボタンの外観をさらにカスタマイズするには、ボタン テンプレートを編集する必要があります。  このテンプレートは、四角形をボタンに変換したときに作成されました。  ボタン テンプレートを編集するには、ボタンを右クリックし、**\[コントロール パーツ \(テンプレート\) の編集\]**、**\[テンプレートの編集\]** の順にクリックします。  
+  
+     ![テンプレートを編集する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-edittemplate.jpg "custom\_button\_blend\_EditTemplate")  
+  
+     テンプレート エディターでは、ボタンが <xref:System.Windows.Shapes.Rectangle> と <xref:System.Windows.Controls.ContentPresenter> に分離されています。  <xref:System.Windows.Controls.ContentPresenter> は、ボタン内のコンテンツ \(文字列 "Button" など\) の表示に使用します。  四角形と <xref:System.Windows.Controls.ContentPresenter> はどちらも <xref:System.Windows.Controls.Grid> の内側に配置されます。  
+  
+     ![四角形で表したコンポーネント](../../../../docs/framework/wpf/controls/media/custom-button-blend-templatepanel.png "custom\_button\_blend\_TemplatePanel")  
+  
+2.  **テンプレート コンポーネントの名前を変更します。**テンプレート インベントリで四角形を右クリックし、<xref:System.Windows.Shapes.Rectangle> 名を "\[Rectangle\]" から "outerRectangle" に変更し、"\[ContentPresenter\]" を "myContentPresenter" に変更します。  
+  
+     ![テンプレートのコンポーネント名を変更する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-renamecomponents.png "custom\_button\_blend\_RenameComponents")  
+  
+3.  **中が空洞になるよう \(ドーナツのように\) 四角形を変更します。** **\[outerRectangle\]** を選択し、<xref:System.Windows.Shapes.Shape.Fill%2A> を "Transparent" に設定し、<xref:System.Windows.Shapes.Shape.StrokeThickness%2A> を 5 に設定します。  
+  
+     ![四角形を空にする方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-changerectproperties.png "custom\_button\_blend\_ChangeRectProperties")  
+  
+     次に、<xref:System.Windows.Shapes.Shape.Stroke%2A> にテンプレートの色を設定します。  これを行うには、**\[ストローク\]** の横にある小さな白いボックスをクリックし、**\[CustomExpression\]** を選択し、ダイアログ ボックスに「{TemplateBinding Background}」と入力します。  
+  
+     ![テンプレートの色の使用を設定する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-templatestroke.png "custom\_button\_blend\_TemplateStroke")  
+  
+4.  **内側の四角形を作成します。**次に、四角形をもう 1 つ作成し \("innerRectangle" という名前を付けます\)、それを **outerRectangle** の内側に対称になるように配置します。  このような場合、ズームを使用して編集領域に表示されるボタンを大きくすると、作業しやすくなります。  
+  
+    > [!NOTE]
+    >  作成している四角形は、図のものと外観が異なっている場合があります \(角が丸くなっているなど\)。  
+  
+     ![別の四角形の中に四角形を作成する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-innerrectangleproperties.png "custom\_button\_blend\_innerRectangleProperties")  
+  
+5.  **ContentPresenter を最前面に移動します。**この時点で、テキスト "Button" が表示されなくなることがあります。  これは、**innerRectangle** が **myContentPresenter** より前面にあるためです。  これを解消するには、**myContentPresenter** を **innerRectangle** の下にドラッグします。  四角形や **myContentPresenter** の位置を変更して、次のようにします。  
+  
+    > [!NOTE]
+    >  また、**myContentPresenter** は、右クリックして **\[前面へ移動\]** をクリックすることで、前面に配置することもできます。  
+  
+     ![別のボタンの上にボタンを移動する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-innerrectangle2.png "custom\_button\_blend\_innerRectangle2")  
+  
+6.  **innerRectangle の外観を変更します。** <xref:System.Windows.Shapes.Rectangle.RadiusX%2A>、<xref:System.Windows.Shapes.Rectangle.RadiusY%2A>、および <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> の値を 20 に設定します。  また、<xref:System.Windows.Shapes.Shape.Fill%2A> をカスタム式 "{TemplateBinding Background}" を使用してテンプレートの背景に設定し、<xref:System.Windows.Shapes.Shape.Stroke%2A> を "transparent" に設定します。  **innerRectangle** の <xref:System.Windows.Shapes.Shape.Fill%2A> と <xref:System.Windows.Shapes.Shape.Stroke%2A> が **outerRectangle** とは逆になっていることを確認します。  
+  
+     ![四角形の外観を変更する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties1.png "custom\_button\_blend\_glassRectangleProperties1")  
+  
+7.  **グラス レイヤーを前面に追加します。**ボタンの外観変更の最後の手順は、グラス レイヤーを前面に追加することです。  このグラス レイヤーは、3 つ目の四角形です。  グラスはボタン全体を覆うため、グラス四角形のサイズは **outerRectangle** とほとんど同じになります。  したがって、この四角形を作成するには、単純に **outerRectangle** のコピーを作成します。  **outerRectangle** を強調表示し、Ctrl \+ C と Ctrl \+ V でコピーを作成します。  この新しい四角形の名前を "glassCube" と指定します。  
+  
+8.  **必要に応じて glassCube 位置を変更します。** **glassCube** がボタンを覆う位置にない場合は、覆う位置までドラッグします。  
+  
+9. **glassCube に outerRectangle とは少しだけ異なる外観を指定します。** **glassCube** のプロパティを変更します。  まず、<xref:System.Windows.Shapes.Rectangle.RadiusX%2A> プロパティと <xref:System.Windows.Shapes.Rectangle.RadiusY%2A> プロパティを 10 に変更し、<xref:System.Windows.Shapes.Shape.StrokeThickness%2A> を 2 に変更します。  
+  
+     ![glassCube の外観設定](../../../../docs/framework/wpf/controls/media/custom-button-blend-glasscubeappearance.gif "custom\_button\_blend\_GlassCubeAppearance")  
+  
+10. **glassCube をグラスのような外観にします。** <xref:System.Windows.Shapes.Shape.Fill%2A> をグラスのような外観にするには、75% 不透明の線形グラデーションを使用し、色は白と透明とをほとんど同じような間隔で 6 回交互に入れ替えます。  グラデーション終了位置の設定値は次のようになります。  
+  
+    -   グラデーション終了位置 1: 白、アルファ値 75%  
+  
+    -   グラデーション終了位置 2: 透明  
+  
+    -   グラデーション終了位置 3: 白、アルファ値 75%  
+  
+    -   グラデーション終了位置 4: 透明  
+  
+    -   グラデーション終了位置 5: 白、アルファ値 75%  
+  
+    -   グラデーション終了位置 6: 透明  
+  
+     これで、"波打つ" グラスの外観になります。  
+  
+     ![グラスのような四角形](../../../../docs/framework/wpf/controls/media/custom-button-blend-glassrectangleproperties2.png "custom\_button\_blend\_glassRectangleProperties2")  
+  
+11. **グラス レイヤーを非表示にします。**グラスのようなレイヤーの外観はこれで確認できたので、**\[プロパティ\] パネル**の **\[表示\] ペイン**に移動し、\[不透明度\] を 0% にして非表示にします。  ここから先では、グラス レイヤーを操作するのに、プロパティ トリガーとイベントを使用します。  
+  
+     ![グラス四角形を非表示にする方法](../../../../docs/framework/wpf/controls/media/custom-button-glassrectangleproperties3.gif "custom\_button\_glassRectangleProperties3")  
+  
+## ボタン動作のカスタマイズ  
+ この時点で、ボタンのプレゼンテーションはテンプレートの変更によってカスタマイズされていますが、マウスオーバーによる外観の変化、フォーカスの受け取り、クリックなどのユーザー操作に対して、通常のボタンのような反応はしません。次の 2 つの手順で、こうした動作をカスタム ボタンに組み込む方法を説明します。  まず、簡単なプロパティ トリガーを使用し、その後にイベント トリガーやアニメーションを追加します。  
+  
+#### プロパティ トリガーを設定するには  
+  
+1.  **新しいプロパティ トリガーを作成します。** **\[glassCube\]** が選択された状態で、**\[トリガー\]** パネルで **\[\+ プロパティ\]** をクリックします \(次の手順の下の図を参照してください\)。  これにより、既定のプロパティ トリガーを持つプロパティ トリガーが作成されます。  
+  
+2.  **IsMouseOver をトリガーによって使用されるプロパティにします。**プロパティを <xref:System.Windows.UIElement.IsMouseOver%2A> に変更します。  これにより、<xref:System.Windows.UIElement.IsMouseOver%2A> プロパティが `true` になる \(ユーザーがマウスでボタンをポイントする\) と、プロパティ トリガーがアクティブになります。  
+  
+     ![プロパティでトリガーを設定する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger.png "custom\_button\_blend\_IsMousedOverPropertyTrigger")  
+  
+3.  **IsMouseOver で glassCube の不透明度 100% をトリガーします。** **\[トリガー記録オン\]** と表示されていることを確認します \(前の図を参照\)。  これは、記録がオンの間に **glassCube** のプロパティ値に行われるあらゆる変更が、<xref:System.Windows.UIElement.IsMouseOver%2A> が `true` の場合に実行されるアクションになることを意味します。  記録中に、**glassCube** の <xref:System.Windows.UIElement.Opacity%2A> を 100% に変更します。  
+  
+     ![ボタンの不透明度を設定する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger2.gif "custom\_button\_blend\_IsMousedOverPropertyTrigger2")  
+  
+     これで、最初のプロパティ トリガーが作成されました。  エディターの **\[トリガー\]** パネルに、<xref:System.Windows.UIElement.Opacity%2A> が 100% に変更されたことが記録されたことを確認します。  
+  
+     ![&#91;トリガー&#93; パネル](../../../../docs/framework/wpf/controls/media/custom-button-blend-propertytriggerinfo.png "custom\_button\_blend\_PropertyTriggerInfo")  
+  
+     F5 キーを押してアプリケーションを実行し、マウス ポインターをボタンに合わせたり、ボタンから離したりします。  ボタンにマウス ポインターを合わせるとグラス レイヤーが現れ、離すと消えることを確認します。  
+  
+4.  **IsMouseOver でストローク値の変更をトリガーします。**他のアクションを <xref:System.Windows.UIElement.IsMouseOver%2A> トリガーと関連付けてみましょう。  記録が続行されている間、選択を **glassCube** から **outerRectangle** に切り替えます。  次に、**outerRectangle** の <xref:System.Windows.Shapes.Shape.Stroke%2A> をカスタム式 "{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" に設定します。  これにより、<xref:System.Windows.Shapes.Shape.Stroke%2A> が、ボタンによって使用される通常の強調表示色に設定されます。  F5 キーを押し、マウスをボタンに合わせたときの効果を確認します。  
+  
+     ![ストロークを強調表示色に設定する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-ismousedoverpropertytrigger3.png "custom\_button\_blend\_IsMousedOverPropertyTrigger3")  
+  
+5.  **IsMouseOver でぼやけたテキストをトリガーします。** <xref:System.Windows.UIElement.IsMouseOver%2A> プロパティ トリガーにアクションをもう 1 つ追加します。  グラスがボタンを覆ったときに、ボタンのコンテンツが少しぼやけるようにします。  これを行うには、ぼかしの <xref:System.Windows.Media.Effects.BitmapEffect> を <xref:System.Windows.Controls.ContentPresenter> \(**myContentPresenter**\) に適用します。  
+  
+     ![ボタンの内容をぼかす方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-propertytriggerwithbitmapeffect.png "custom\_button\_blend\_PropertyTriggerWithBitMapEffect")  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Media.Effects.BitmapEffect> を検索する前の状態に **\[プロパティ\]** パネルを戻すには、**\[検索\]** ボックスのテキストをクリアします。  
+  
+     ここまでの段階では、プロパティ トリガーにいくつかのアクションを関連付けて、マウス ポインターがボタン領域に出入りしたときの強調表示動作を作成しました。  もう 1 つの一般的なボタン動作は、フォーカスがあるとき \(クリックされた後など\) の強調表示です。  このような動作を追加するには、<xref:System.Windows.UIElement.IsFocused%2A> プロパティに別のプロパティ トリガーを追加します。  
+  
+6.  **IsFocused のプロパティ トリガーを作成します。** <xref:System.Windows.UIElement.IsMouseOver%2A> の場合と同じ手順で \(このセクションの最初の手順を参照\)、<xref:System.Windows.UIElement.IsFocused%2A> プロパティにプロパティ トリガーをもう 1 つ作成します。  **\[トリガー記録オン\]** の間、次のアクションをトリガーに追加します。  
+  
+    -   **glassCube** の <xref:System.Windows.UIElement.Opacity%2A> を 100% にする。  
+  
+    -   **outerRectangle** の <xref:System.Windows.Shapes.Shape.Stroke%2A> をカスタム値 "{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" に設定する。  
+  
+ このチュートリアルの最後の手順として、ボタンにアニメーションを追加します。  ボタンのアニメーションはイベントによりトリガーされます。具体的には <xref:System.Windows.UIElement.MouseEnter> イベントと <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントです。  
+  
+#### イベント トリガーとアニメーションを使用して対話機能を追加するには  
+  
+1.  **MouseEnter イベント トリガーを作成します。**新しいイベント トリガーを追加し、トリガーで使用するイベントとして <xref:System.Windows.UIElement.MouseEnter> を選択します。  
+  
+     ![MouseEnter イベント トリガーを作成する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger.png "custom\_button\_blend\_MouseOverEventTrigger")  
+  
+2.  **アニメーション タイムラインを作成します。**次に、アニメーション タイムラインを <xref:System.Windows.UIElement.MouseEnter> イベントに関連付けます。  
+  
+     ![アニメーション タイムラインをイベントに追加する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger2.png "custom\_button\_blend\_MouseOverEventTrigger2")  
+  
+     **\[OK\]** をクリックして新しいタイムラインを作成すると、**\[タイムライン パネル\]** が表示され、"Timeline recording is on" がデザイン パネルに表示されます。  これは、タイムラインでのプロパティ変更の記録を開始できることを示しています \(プロパティ変更のアニメーション化\)。  
+  
+    > [!NOTE]
+    >  この表示を見るために、場合によってはウィンドウやパネルの表示サイズを大きくする必要があります。  
+  
+     ![タイムライン パネル](../../../../docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger3.png "custom\_button\_blend\_MouseOverEventTrigger3")  
+  
+3.  **キーフレームを作成します。**アニメーションを作成するには、アニメーション化するオブジェクトを選択し、タイムライン上に 2 つ以上のキーフレームを作成します。そして、それぞれのキーフレームについて、アニメーションで補間する間隔を示すプロパティ値を設定します。  次の図は、キーフレームの作成過程を示しています。  
+  
+     ![キーフレームを作成する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-mouseovereventtrigger4.png "custom\_button\_blend\_MouseOverEventTrigger4")  
+  
+4.  **このキーフレームで glassCube を縮小します。**2 番目のキーフレームが選択された状態で、**glassCube** のサイズを **\[サイズ変換\]** を使用して元の大きさの 90% に縮小します。  
+  
+     ![ボタンのサイズを縮小する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-sizetransform.png "custom\_button\_blend\_SizeTransform")  
+  
+     F5 キーを押してアプリケーションを実行します。  マウス ポインターをボタンに合わせます。  ボタン上のグラス レイヤーが縮小することを確認します。  
+  
+5.  **イベント トリガーをもう 1 つ作成し、別のアニメーションを関連付けます。**アニメーションをもう 1 つ追加します。  前のイベント トリガー アニメーションを作成するために使用した方法と似た手順を使用します。  
+  
+    1.  新しいイベント トリガーを <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントを使用して作成します。  
+  
+    2.  新しいタイムライン <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベントに関連付けます。  
+  
+     ![新しいタイムラインを作成する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-clickeventtrigger1.png "custom\_button\_blend\_ClickEventTrigger1")  
+  
+    1.  このタイムラインに 2 つのキーフレームを作成します。位置はそれぞれ 0.0 秒と 0.3 秒です。  
+  
+    2.  0.3 秒の位置のキーフレームが強調表示された状態で、**\[回転角度\]** を 360° に設定します。  
+  
+     ![回転変換を作成する方法](../../../../docs/framework/wpf/controls/media/custom-button-blend-rotatetransform.gif "custom\_button\_blend\_RotateTransform")  
+  
+    1.  F5 キーを押してアプリケーションを実行します。  ボタンをクリックします。  グラス レイヤーが回転することを確認します。  
+  
+## まとめ  
+ これで、カスタマイズされたボタンが完成されました。  これには、アプリケーションに存在するすべてのボタンに適用されるボタン テンプレートを使用しました。  テンプレートを編集モードのままにして \(次の図を参照\) 他にもボタンを作成すると、作成されるボタンの動作と外観が、既定のボタンではなくカスタム ボタンに似ていることを確認できます。  
+  
+ ![カスタム ボタン テンプレート](../../../../docs/framework/wpf/controls/media/custom-button-blend-scopeup.gif "custom\_button\_blend\_ScopeUp")  
+  
+ ![同じテンプレートを使用する複数のボタン](../../../../docs/framework/wpf/controls/media/custom-button-blend-createmultiplebuttons.png "custom\_button\_blend\_CreateMultipleButtons")  
+  
+ F5 キーを押してアプリケーションを実行します。  ボタンをクリックして、どれも動作が同じであることを確認します。  
+  
+ 前の手順において、テンプレートのカスタマイズ中に、**innerRectangle** の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティと **outerRectangle** の <xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティを、テンプレートの背景 \({TemplateBinding Background}\) に設定しました。  このため、個々のボタンの背景色を設定すると、設定した背景が個々のプロパティで使用されます。  ここで、背景を変更してみます。  次の図では、異なるグラデーションが使用されています。  したがって、テンプレートはボタンのようなコントロールの全体的なカスタマイズには便利ですが、テンプレートを使用したコントロールどうしで外観が異なるように変更することは引き続き可能です。  
+  
+ ![外観が異なる同じテンプレートを含むボタン](../../../../docs/framework/wpf/controls/media/custom-button-blend-blendconclusion.png "custom\_button\_blend\_BlendConclusion")  
+  
+ ボタン テンプレートをカスタマイズする過程で、Microsoft Expression Blend で次のことを行う方法を学びました。  
+  
+-   コントロールの外観をカスタマイズする。  
+  
+-   プロパティ トリガーを設定する。  プロパティ トリガーは、コントロールに限らずほとんどのオブジェクトでも使用でき、非常に便利です。  
+  
+-   イベント トリガーを設定する。  イベント トリガーは、コントロールに限らずほとんどのオブジェクトでも使用でき、非常に便利です。  
+  
+-   アニメーションを作成する。  
+  
+-   その他 : グラデーションの作成、BitmapEffects の追加、変換の使用、オブジェクトの基本プロパティの設定。  
+  
+## 参照  
+ [XAML を使用したボタンの作成](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [ビットマップ効果の概要](../../../../docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md b/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md
new file mode 100644
index 00000000000..5e40cc38961
--- /dev/null
+++ b/docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md
@@ -0,0 +1,517 @@
+---
+title: "チュートリアル : XAML を使用したボタンの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ボタン"
+ms.assetid: 138c41c4-1759-4bbf-8d77-77031a06a8a0
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# チュートリアル : XAML を使用したボタンの作成
+このチュートリアルでは、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションで使用するアニメーション ボタンの作成方法について説明します。  このチュートリアルでは、カスタマイズされたボタン リソースを作成するのにスタイルとテンプレートを使用します。これにより、コードを再利用したり、ボタン ロジックをボタン宣言から分離したりできるようになります。  このチュートリアルはすべて [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で記述されています。  
+  
+> [!IMPORTANT]
+>  このチュートリアルでは、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を Microsoft [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] に入力するか、コピーと貼り付けを行うことでアプリケーションを作成する手順について説明します。  同じアプリケーションをデザイン ツール \(Microsoft Expression Blend\) を使用して作成する方法の詳細については、「[Microsoft Expression Blend を使用してボタンを作成する](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md)」を参照してください。  
+  
+ 次の図は、完成したボタンの外観を示しています。  
+  
+ ![XAML を使用して作成されたカスタム ボタン](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-5.png "custom\_button\_AnimatedButton\_5")  
+  
+## 基本ボタンの作成  
+ まず、新しいプロジェクトを作成し、ウィンドウにボタンをいくつか追加します。  
+  
+#### 新しい WPF プロジェクトを作成し、ウィンドウにボタンを追加するには  
+  
+1.  [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を起動します。  
+  
+2.  **新しい WPF プロジェクトの作成 :** **\[ファイル\]** メニューの **\[新規\]** をポイントし、**\[プロジェクト\]** をクリックします。  **\[Windows アプリケーション\]** テンプレートを選択し、プロジェクトに「AnimatedButton」という名前を付けます。  これで、アプリケーションのスケルトンが作成されます。  
+  
+3.  **既定の基本ボタンの追加 :** このチュートリアルで必要となるファイルは、すべてテンプレートに用意されています。  ソリューション エクスプローラーで、Window1.xaml をダブルクリックして開きます。  Window1.xaml には、既定で <xref:System.Windows.Controls.Grid> 要素があります。  <xref:System.Windows.Controls.Grid> 要素を削除し、次の強調表示されたコードを Window1.xaml に入力するかコピーして貼り付けて、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ページにボタンをいくつか追加します。  
+  
+    ```  
+    <Window x:Class="AnimatedButton.Window1"  
+      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+      Title="AnimatedButton" Height="300" Width="300"   
+      Background="Black">  
+  
+      <!-- Buttons arranged vertically inside a StackPanel. -->  
+      <StackPanel HorizontalAlignment="Left">  
+        <Button>Button 1</Button>  
+        <Button>Button 2</Button>  
+        <Button>Button 3</Button>  
+      </StackPanel>  
+  
+    </Window>  
+    ```  
+  
+     F5 キーを押してアプリケーションを実行します。次の図のようなボタンのセットが表示されます。  
+  
+     ![3 つの基本的なボタン](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-1.png "custom\_button\_AnimatedButton\_1")  
+  
+     基本ボタンを作成したので、Window1.xaml ファイルに対する作業は終わりです。  これ以降は、ボタンのスタイルとテンプレートを定義する app.xaml ファイルを中心に説明します。  
+  
+## 基本プロパティの設定  
+ 次に、これらのボタンについて、外観とレイアウトをコントロールするためのプロパティをいくつか設定します。  その際、プロパティをボタン別に設定するのではなく、アプリケーション全体のボタン プロパティを定義するリソースを使用します。  アプリケーション リソースは Web ページ用の外部 [!INCLUDE[TLA#tla_css](../../../../includes/tlasharptla-css-md.md)] と概念的には似ていますが、このチュートリアルを通じて説明されるように、リソースの方が [!INCLUDE[TLA#tla_css](../../../../includes/tlasharptla-css-md.md)] よりはるかに強力です。  リソースの詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+#### ボタンの基本プロパティを設定するためのスタイルを使用するには  
+  
+1.  **Application.Resources ブロックの定義 :** app.xaml を開き、次の強調表示されたマークアップが含まれていない場合は追加します。  
+  
+    ```  
+    <Application x:Class="AnimatedButton.App"  
+      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+      StartupUri="Window1.xaml"  
+      >  
+      <Application.Resources>  
+  
+        <!-- Resources for the entire application can be   
+             defined here. -->  
+  
+      </Application.Resources>  
+    </Application>  
+    ```  
+  
+     リソースのスコープは、リソースを定義する場所で決定されます。  app.xaml ファイルの `Application.Resoureses` で定義されたリソースは、アプリケーションのどこででも使用できます。  リソースのスコープの定義の詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+2.  **スタイルの作成と、基本プロパティ値の定義 :** 次のマークアップを `Application.Resources` ブロックに追加します。  このマークアップは、アプリケーションに含まれるすべてのボタンに適用される <xref:System.Windows.Style> を作成します。このスタイルにより、ボタンの <xref:System.Windows.FrameworkElement.Width%2A> は 90 に設定され、<xref:System.Windows.FrameworkElement.Margin%2A> は 10 に設定されます。  
+  
+    ```  
+    <Application.Resources>  
+  
+      <Style TargetType="Button">  
+        <Setter Property="Width" Value="90" />  
+        <Setter Property="Margin" Value="10" />  
+      </Style>  
+  
+    </Application.Resources>  
+    ```  
+  
+     <xref:System.Windows.Style.TargetType%2A> プロパティは、<xref:System.Windows.Controls.Button> 型のすべてのオブジェクトに適用されるスタイルを指定します。  各 <xref:System.Windows.Setter> は <xref:System.Windows.Style> に異なるプロパティ値を設定します。  したがって、この時点では、アプリケーションに含まれるすべてのボタンの幅は 90 で、余白は 10 です。  F5 キーを押してアプリケーションを実行すると、次のようなウィンドウが表示されます。  
+  
+     ![幅 90、余白 10 のボタン](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-2.png "custom\_button\_AnimatedButton\_2")  
+  
+     スタイルを使用すると、他にもさまざまなことができます。たとえば、対象オブジェクトを微調整する方法が各種用意されているほか、複雑なプロパティ値を指定したり、あるスタイルを他のスタイルの入力として使用したりすることもできます。  詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  
+  
+3.  **スタイルのプロパティ値のリソースへの設定 :** リソースを使用することで、一般的に定義されるオブジェクトや値を簡単に再利用できます。  複雑な値をリソースを使用して定義することは、コードをモジュール化するのにたいへん便利です。  次の強調表示されたマークアップを app.xaml に追加します。  
+  
+    ```  
+    <Application.Resources>  
+  
+      <LinearGradientBrush x:Key="GrayBlueGradientBrush"   
+        StartPoint="0,0" EndPoint="1,1">  
+        <GradientStop Color="DarkGray" Offset="0" />  
+        <GradientStop Color="#CCCCFF" Offset="0.5" />  
+        <GradientStop Color="DarkGray" Offset="1" />  
+      </LinearGradientBrush>  
+  
+      <Style TargetType="{x:Type Button}">  
+        <Setter Property="Background"   
+          Value="{StaticResource GrayBlueGradientBrush}" />  
+        <Setter Property="Width" Value="80" />  
+        <Setter Property="Margin" Value="10" />  
+      </Style>  
+  
+    </Application.Resources>  
+    ```  
+  
+     `Application.Resources` ブロックの直下に、"GrayBlueGradientBrush" というリソースが作成されています。  このリソースは、水平方向のグラデーションを定義します。  このリソースは、<xref:System.Windows.Controls.Control.Background%2A> プロパティのボタン スタイルの Setter の内部からなど、アプリケーションのどこからでもプロパティ値として使用できます。  これで、すべてのボタンがこのグラデーションの <xref:System.Windows.Controls.Control.Background%2A> プロパティを持つようになりました。  
+  
+     F5 キーを押してアプリケーションを実行します。  結果は次のようになります。  
+  
+     ![グラデーション背景を持つボタン](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-3.png "custom\_button\_AnimatedButton\_3")  
+  
+## ボタンの外観を定義するテンプレートの作成  
+ ここでは、ボタンの外観 \(プレゼンテーション\) をカスタマイズするテンプレートを作成します。  ボタン プレゼンテーションは、四角形などのコンポーネントを含むいくつかのオブジェクトで構成され、ボタンに固有の外観を指定します。  
+  
+ これまで、アプリケーションにおけるボタンの外観のコントロールは、ボタンのプロパティを変更することに制限されていました。  ボタンの外観をより大きく変更するにはどうしたらよいでしょうか。  テンプレートを使用すると、オブジェクトのプレゼンテーションを強力にコントロールできます。  テンプレートはスタイル内で使用できるので、スタイルが適用されるすべてのオブジェクト \(このチュートリアルではボタン\) にテンプレートを適用できます。  
+  
+#### ボタンの外観を定義するテンプレートを使用するには  
+  
+1.  **テンプレートのセットアップ :** <xref:System.Windows.Controls.Button> などのコントロールには <xref:System.Windows.Controls.Control.Template%2A> プロパティがあるので、テンプレートのプロパティ値は、<xref:System.Windows.Style> で <xref:System.Windows.Setter> を使用して設定した他のプロパティと同じようにして定義できます。  次の強調表示されたマークアップをボタン スタイルに追加します。  
+  
+    ```  
+    <Application.Resources>  
+  
+      <LinearGradientBrush x:Key="GrayBlueGradientBrush"   
+        StartPoint="0,0" EndPoint="1,1">  
+        <GradientStop Color="DarkGray" Offset="0" />  
+        <GradientStop Color="#CCCCFF" Offset="0.5" />  
+        <GradientStop Color="DarkGray" Offset="1" />  
+      </LinearGradientBrush>  
+  
+      <Style TargetType="{x:Type Button}">  
+      <Setter Property="Background" Value="{StaticResource GrayBlueGradientBrush}" />  
+        <Setter Property="Width" Value="80" />  
+        <Setter Property="Margin" Value="10" />  
+        <Setter Property="Template">  
+          <Setter.Value>  
+            <!-- The button template is defined here. -->  
+          </Setter.Value>  
+        </Setter>  
+      </Style>  
+  
+    </Application.Resources>  
+    ```  
+  
+2.  **ボタン プレゼンテーションの変更 :** この時点でテンプレートを定義する必要があります。  次の強調表示されたマークアップを追加します。  このマークアップは、角が丸い 2 つの <xref:System.Windows.Shapes.Rectangle> 要素を指定し、続いて <xref:System.Windows.Controls.DockPanel> を指定します。  <xref:System.Windows.Controls.DockPanel> はボタンの <xref:System.Windows.Controls.ContentPresenter> をホストするために使用されます。  <xref:System.Windows.Controls.ContentPresenter> にはボタンのコンテンツが表示されます。  このチュートリアルでは、コンテンツはテキスト \("Button 1"、"Button 2"、"Button 3"\) です。  テンプレート コンポーネント \(四角形と <xref:System.Windows.Controls.DockPanel>\) はすべて <xref:System.Windows.Controls.Grid> 内部にレイアウトされます。  
+  
+    ```  
+    <Setter.Value>  
+      <ControlTemplate TargetType="Button">  
+        <Grid Width="{TemplateBinding Width}"   
+         Height="{TemplateBinding Height}" ClipToBounds="True">  
+  
+          <!-- Outer Rectangle with rounded corners. -->  
+          <Rectangle x:Name="outerRectangle"   
+            HorizontalAlignment="Stretch"   
+            VerticalAlignment="Stretch"   
+            Stroke="{TemplateBinding Background}"   
+            RadiusX="20" RadiusY="20" StrokeThickness="5"   
+            Fill="Transparent" />  
+  
+          <!-- Inner Rectangle with rounded corners. -->  
+          <Rectangle x:Name="innerRectangle"   
+            HorizontalAlignment="Stretch"   
+            VerticalAlignment="Stretch" Stroke="Transparent"   
+            StrokeThickness="20"   
+            Fill="{TemplateBinding Background}"   
+            RadiusX="20" RadiusY="20"   />  
+  
+          <!-- Present Content (text) of the button. -->  
+          <DockPanel Name="myContentPresenterDockPanel">  
+            <ContentPresenter x:Name="myContentPresenter" Margin="20"   
+              Content="{TemplateBinding  Content}"   
+              TextBlock.Foreground="Black" />  
+          </DockPanel>  
+        </Grid>  
+      </ControlTemplate>  
+    </Setter.Value>  
+    ```  
+  
+     F5 キーを押してアプリケーションを実行します。  結果は次のようになります。  
+  
+     ![](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-4.gif "custom\_button\_AnimatedButton\_4")  
+  
+3.  **テンプレートへのグラス効果の追加 :** 次に、グラスを追加します。  まず、グラス グラデーション効果を作成するリソースをいくつか作成します。  これらのグラデーション リソースを `Application.Resources` ブロック内のどこかに追加します。  
+  
+    ```  
+    <Application.Resources>  
+      <GradientStopCollection x:Key="MyGlassGradientStopsResource">  
+        <GradientStop Color="WhiteSmoke" Offset="0.2" />  
+        <GradientStop Color="Transparent" Offset="0.4" />  
+        <GradientStop Color="WhiteSmoke" Offset="0.5" />  
+        <GradientStop Color="Transparent" Offset="0.75" />  
+        <GradientStop Color="WhiteSmoke" Offset="0.9" />  
+        <GradientStop Color="Transparent" Offset="1" />  
+      </GradientStopCollection>  
+  
+      <LinearGradientBrush x:Key="MyGlassBrushResource"   
+       StartPoint="0,0" EndPoint="1,1" Opacity="0.75"   
+       GradientStops="{StaticResource MyGlassGradientStopsResource}" />  
+    <!-- Styles and other resources below here. -->  
+    ```  
+  
+     これらのリソースは、ボタン テンプレートの <xref:System.Windows.Controls.Grid> に挿入する四角形の <xref:System.Windows.Shapes.Shape.Fill%2A> として使用されます。  次の強調表示されたマークアップをテンプレートに追加します。  
+  
+    ```  
+    <Setter.Value>  
+      <ControlTemplate TargetType="{x:Type Button}">  
+        <Grid Width="{TemplateBinding Width}" Height="{TemplateBinding Height}"  
+    ClipToBounds="True">  
+  
+        <!-- Outer Rectangle with rounded corners. -->  
+        <Rectangle x:Name="outerRectangle" HorizontalAlignment="Stretch"   
+          VerticalAlignment="Stretch" Stroke="{TemplateBinding Background}"   
+          RadiusX="20" RadiusY="20" StrokeThickness="5" Fill="Transparent" />  
+  
+        <!-- Inner Rectangle with rounded corners. -->  
+        <Rectangle x:Name="innerRectangle" HorizontalAlignment="Stretch"   
+          VerticalAlignment="Stretch" Stroke="Transparent" StrokeThickness="20"   
+          Fill="{TemplateBinding Background}" RadiusX="20" RadiusY="20" />  
+  
+        <!-- Glass Rectangle -->  
+        <Rectangle x:Name="glassCube" HorizontalAlignment="Stretch"  
+          VerticalAlignment="Stretch"  
+          StrokeThickness="2" RadiusX="10" RadiusY="10" Opacity="0"  
+          Fill="{StaticResource MyGlassBrushResource}"  
+          RenderTransformOrigin="0.5,0.5">  
+          <Rectangle.Stroke>  
+            <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">  
+              <LinearGradientBrush.GradientStops>  
+                <GradientStop Offset="0.0" Color="LightBlue" />  
+                <GradientStop Offset="1.0" Color="Gray" />  
+              </LinearGradientBrush.GradientStops>  
+            </LinearGradientBrush>  
+          </Rectangle.Stroke>  
+  
+          <!-- These transforms have no effect as they are declared here.   
+               The reason the transforms are included is to be targets   
+               for animation (see later). -->  
+          <Rectangle.RenderTransform>  
+            <TransformGroup>  
+              <ScaleTransform />  
+              <RotateTransform />  
+            </TransformGroup>  
+          </Rectangle.RenderTransform>  
+  
+          <!-- A BevelBitmapEffect is applied to give the button a   
+               "Beveled" look. -->  
+          <Rectangle.BitmapEffect>  
+            <BevelBitmapEffect />  
+          </Rectangle.BitmapEffect>  
+        </Rectangle>  
+  
+        <!-- Present Text of the button. -->  
+        <DockPanel Name="myContentPresenterDockPanel">  
+          <ContentPresenter x:Name="myContentPresenter" Margin="20"   
+            Content="{TemplateBinding  Content}" TextBlock.Foreground="Black" />  
+        </DockPanel>  
+      </Grid>  
+    </ControlTemplate>  
+    </Setter.Value>  
+    ```  
+  
+     "glassCube" の `x:Name` プロパティを持つ四角形の <xref:System.Windows.UIElement.Opacity%2A> は 0 なので、このサンプルを実行すると、グラス四角形は最前面にオーバーレイ表示されません。  これは、ユーザーがボタンを使用して対話操作を行う場合について、後でトリガーをテンプレートに追加するからです。  ただし、<xref:System.Windows.UIElement.Opacity%2A> 値を 1 に変更してアプリケーションを実行すると、ボタンの外観をすぐに確認できます。  次の図を参照してください。  次の手順に進む前に、<xref:System.Windows.UIElement.Opacity%2A> を 0 に戻してください。  
+  
+     ![XAML を使用して作成されたカスタム ボタン](../../../../docs/framework/wpf/controls/media/custom-button-animatedbutton-5.png "custom\_button\_AnimatedButton\_5")  
+  
+## ボタンの対話機能の作成  
+ ここでは、マウス ポインターをボタンに合わせてクリックするなどのユーザー アクションに対応して、プロパティ値を変更してアニメーションを実行するプロパティ トリガーおよびイベント トリガーを作成します。  
+  
+ 対話機能 \(マウスオーバー、マウスリーブ、クリックなど\) を追加する簡単な方法は、テンプレートまたはスタイルの内部にトリガーを定義することです。  <xref:System.Windows.Trigger> を作成するには、ボタンの <xref:System.Windows.UIElement.IsMouseOver%2A> プロパティが `true` に等しい、といったプロパティ "条件" を作成します。  次に、トリガー条件が true になったときに実行される setter \(アクション\) を定義します。  
+  
+#### ボタンの対話機能を作成するには  
+  
+1.  **テンプレート トリガーの追加 :** 次の強調表示されたマークアップをテンプレートに追加します。  
+  
+    ```  
+    <Setter.Value>  
+      <ControlTemplate TargetType="{x:Type Button}">  
+        <Grid Width="{TemplateBinding Width}"   
+          Height="{TemplateBinding Height}" ClipToBounds="True">  
+  
+          <!-- Outer Rectangle with rounded corners. -->  
+          <Rectangle x:Name="outerRectangle" HorizontalAlignment="Stretch"   
+          VerticalAlignment="Stretch" Stroke="{TemplateBinding Background}"   
+          RadiusX="20" RadiusY="20" StrokeThickness="5" Fill="Transparent" />  
+  
+          <!-- Inner Rectangle with rounded corners. -->  
+          <Rectangle x:Name="innerRectangle" HorizontalAlignment="Stretch"   
+            VerticalAlignment="Stretch" Stroke="Transparent"   
+            StrokeThickness="20"   
+            Fill="{TemplateBinding Background}" RadiusX="20" RadiusY="20"   
+          />  
+  
+          <!-- Glass Rectangle -->  
+          <Rectangle x:Name="glassCube" HorizontalAlignment="Stretch"  
+            VerticalAlignment="Stretch"  
+            StrokeThickness="2" RadiusX="10" RadiusY="10" Opacity="0"  
+            Fill="{StaticResource MyGlassBrushResource}"  
+            RenderTransformOrigin="0.5,0.5">  
+            <Rectangle.Stroke>  
+              <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">  
+                <LinearGradientBrush.GradientStops>  
+                  <GradientStop Offset="0.0" Color="LightBlue" />  
+                  <GradientStop Offset="1.0" Color="Gray" />  
+                </LinearGradientBrush.GradientStops>  
+              </LinearGradientBrush>  
+            </Rectangle.Stroke>  
+  
+            <!-- These transforms have no effect as they   
+                 are declared here.   
+                 The reason the transforms are included is to be targets   
+                 for animation (see later). -->  
+            <Rectangle.RenderTransform>  
+              <TransformGroup>  
+                <ScaleTransform />  
+                <RotateTransform />  
+              </TransformGroup>  
+            </Rectangle.RenderTransform>  
+  
+              <!-- A BevelBitmapEffect is applied to give the button a   
+                   "Beveled" look. -->  
+            <Rectangle.BitmapEffect>  
+              <BevelBitmapEffect />  
+            </Rectangle.BitmapEffect>  
+          </Rectangle>  
+  
+          <!-- Present Text of the button. -->  
+          <DockPanel Name="myContentPresenterDockPanel">  
+            <ContentPresenter x:Name="myContentPresenter" Margin="20"   
+              Content="{TemplateBinding  Content}" TextBlock.Foreground="Black" />  
+          </DockPanel>  
+        </Grid>  
+  
+        <ControlTemplate.Triggers>  
+          <!-- Set action triggers for the buttons and define  
+               what the button does in response to those triggers. -->  
+        </ControlTemplate.Triggers>  
+      </ControlTemplate>  
+    </Setter.Value>  
+    ```  
+  
+2.  **プロパティ トリガーの追加 :** 次の強調表示されたマークアップを `ControlTemplate.Triggers` ブロックに追加します。  
+  
+    ```  
+    <ControlTemplate.Triggers>  
+  
+      <!-- Set properties when mouse pointer is over the button. -->  
+      <Trigger Property="IsMouseOver" Value="True">  
+  
+        <!-- Below are three property settings that occur when the   
+             condition is met (user mouses over button).  -->  
+        <!-- Change the color of the outer rectangle when user   
+             mouses over it. -->  
+        <Setter Property ="Rectangle.Stroke" TargetName="outerRectangle"  
+          Value="{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" />  
+  
+        <!-- Sets the glass opacity to 1, therefore, the   
+             glass "appears" when user mouses over it. -->  
+        <Setter Property="Rectangle.Opacity" Value="1" TargetName="glassCube" />  
+  
+        <!-- Makes the text slightly blurry as though you   
+             were looking at it through blurry glass. -->  
+        <Setter Property="ContentPresenter.BitmapEffect"   
+          TargetName="myContentPresenter">  
+          <Setter.Value>  
+            <BlurBitmapEffect Radius="1" />  
+          </Setter.Value>  
+        </Setter>  
+      </Trigger>  
+  
+    <ControlTemplate.Triggers/>  
+    ```  
+  
+     F5 キーを押してアプリケーションを実行し、マウス ポインターをボタンに合わせたときの効果を確認します。  
+  
+3.  **フォーカス トリガーの追加 :** 次に、ボタンにフォーカスがある場合 \(ユーザーがクリックした後など\) を処理する同様の setter を追加します。  
+  
+    ```  
+    <ControlTemplate.Triggers>  
+  
+      <!-- Set properties when mouse pointer is over the button. -->  
+      <Trigger Property="IsMouseOver" Value="True">  
+  
+        <!-- Below are three property settings that occur when the   
+             condition is met (user mouses over button).  -->  
+        <!-- Change the color of the outer rectangle when user          mouses over it. -->  
+        <Setter Property ="Rectangle.Stroke" TargetName="outerRectangle"  
+          Value="{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" />  
+  
+        <!-- Sets the glass opacity to 1, therefore, the          glass "appears" when user mouses over it. -->  
+        <Setter Property="Rectangle.Opacity" Value="1"       TargetName="glassCube" />  
+  
+        <!-- Makes the text slightly blurry as though you were          looking at it through blurry glass. -->  
+        <Setter Property="ContentPresenter.BitmapEffect"       TargetName="myContentPresenter">  
+          <Setter.Value>  
+            <BlurBitmapEffect Radius="1" />  
+          </Setter.Value>  
+        </Setter>  
+      </Trigger>  
+      <!-- Set properties when button has focus. -->  
+      <Trigger Property="IsFocused" Value="true">  
+        <Setter Property="Rectangle.Opacity" Value="1"       TargetName="glassCube" />  
+        <Setter Property="Rectangle.Stroke" TargetName="outerRectangle"  
+          Value="{DynamicResource {x:Static SystemColors.HighlightBrushKey}}" />  
+        <Setter Property="Rectangle.Opacity" Value="1" TargetName="glassCube" />  
+      </Trigger>  
+  
+    </ControlTemplate.Triggers>  
+    ```  
+  
+     F5 キーを押してアプリケーションを実行し、いずれかのボタンをクリックします。  クリックされた後でもフォーカスがあるので、ボタンは強調表示されたままになります。  別のボタンをクリックすると、新しいボタンにフォーカスが移り、それまでのボタンはフォーカスを失います。  
+  
+4.  <xref:System.Windows.UIElement.MouseEnter>  **と**  <xref:System.Windows.UIElement.MouseLeave>  **へのアニメーションの追加**  **:** 次に、トリガーにアニメーションを追加します。  次のマークアップを `ControlTemplate.Triggers` ブロックの中に追加します。  
+  
+    ```  
+  
+                    <!-- Animations that start when mouse enters and leaves button. -->  
+    <EventTrigger RoutedEvent="Mouse.MouseEnter">  
+      <EventTrigger.Actions>  
+        <BeginStoryboard Name="mouseEnterBeginStoryboard">  
+          <Storyboard>  
+  
+          <!-- This animation makes the glass rectangle shrink in the X direction. -->  
+            <DoubleAnimation Storyboard.TargetName="glassCube"   
+              Storyboard.TargetProperty=  
+              "(Rectangle.RenderTransform).(TransformGroup.Children)[0].(ScaleTransform.ScaleX)"  
+              By="-0.1" Duration="0:0:0.5" />  
+  
+            <!-- This animation makes the glass rectangle shrink in the Y direction. -->  
+            <DoubleAnimation  
+            Storyboard.TargetName="glassCube"   
+              Storyboard.TargetProperty=  
+              "(Rectangle.RenderTransform).(TransformGroup.Children)[0].(ScaleTransform.ScaleY)"   
+              By="-0.1" Duration="0:0:0.5" />  
+          </Storyboard>  
+        </BeginStoryboard>  
+      </EventTrigger.Actions>  
+    </EventTrigger>  
+    <EventTrigger RoutedEvent="Mouse.MouseLeave">  
+      <EventTrigger.Actions>  
+  
+        <!-- Stopping the storyboard sets all animated properties back to default. -->  
+        <StopStoryboard BeginStoryboardName="mouseEnterBeginStoryboard" />  
+      </EventTrigger.Actions>  
+    </EventTrigger>  
+    ```  
+  
+     グラス四角形は、マウス ポインターをボタンに合わせると小さくなり、ポインターが離れると標準サイズに戻ります。  
+  
+     ポインターをボタンに合わせたとき \(<xref:System.Windows.UIElement.MouseEnter> イベントが生成されたとき\) にトリガーされるアニメーションは 2 つあります。  これらのアニメーションは、グラス四角形をそれぞれ X 軸および Y 軸方向に縮小します。  <xref:System.Windows.Media.Animation.DoubleAnimation> 要素のプロパティは、<xref:System.Windows.Media.Animation.Timeline.Duration%2A> と <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> です。  <xref:System.Windows.Media.Animation.Timeline.Duration%2A> はアニメーションが 0.5 秒間発生するように指定し、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> はグラスが 10% 縮小されるように指定します。  
+  
+     2 番目のイベント トリガー \(<xref:System.Windows.UIElement.MouseLeave>\) は、単純に最初のイベントを停止します。  <xref:System.Windows.Media.Animation.Storyboard> を停止すると、アニメーション化されたすべてのプロパティが既定値に戻ります。  したがって、ユーザーがポインターをボタンから離すと、ボタンはマウス ポインターをボタンに合わせる前の状態に戻ります。  アニメーションの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+5.  **ボタンがクリックされたときのアニメーションの追加 :** 最後の手順は、ユーザーがボタンをクリックしたときのトリガーの追加です。  次のマークアップを `ControlTemplate.Triggers` ブロックの中に追加します。  
+  
+    ```  
+  
+                    <!-- Animation fires when button is clicked, causing glass to spin.  -->  
+    <EventTrigger RoutedEvent="Button.Click">  
+      <EventTrigger.Actions>  
+        <BeginStoryboard>  
+          <Storyboard>  
+            <DoubleAnimation Storyboard.TargetName="glassCube"   
+              Storyboard.TargetProperty=  
+              "(Rectangle.RenderTransform).(TransformGroup.Children)[1].(RotateTransform.Angle)"   
+              By="360" Duration="0:0:0.5" />  
+          </Storyboard>  
+        </BeginStoryboard>  
+      </EventTrigger.Actions>  
+    </EventTrigger>  
+    ```  
+  
+     F5 キーを押してアプリケーションを実行し、いずれかのボタンをクリックします。  ボタンをクリックすると、グラス四角形が回転します。  
+  
+## 概要  
+ このチュートリアルでは、次の演習を行いました。  
+  
+-   <xref:System.Windows.Style> をオブジェクト型 \(<xref:System.Windows.Controls.Button>\) に適用しました。  
+  
+-   アプリケーション全体のボタンの基本プロパティを <xref:System.Windows.Style> を使用してコントロールしました。  
+  
+-   <xref:System.Windows.Style> setter のプロパティ値で使用するグラデーションなどのリソースを作成しました。  
+  
+-   テンプレートをボタンに適用することで、アプリケーション全体のボタンの外観をカスタマイズしました。  
+  
+-   アニメーション効果を含むユーザー アクション \(<xref:System.Windows.UIElement.MouseEnter>、<xref:System.Windows.UIElement.MouseLeave>、<xref:System.Windows.Controls.Primitives.ButtonBase.Click> など\) に対応するボタンの動作をカスタマイズしました。  
+  
+## 参照  
+ [Microsoft Expression Blend を使用してボタンを作成する](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [ビットマップ効果の概要](../../../../docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md b/docs/framework/wpf/controls/walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md
new file mode 100644
index 00000000000..629c1a787b8
--- /dev/null
+++ b/docs/framework/wpf/controls/walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md
@@ -0,0 +1,110 @@
+---
+title: "チュートリアル: DataGrid コントロールで SQL Server データベースのデータを表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コントロール [WPF], DataGrid"
+  - "DataGrid [WPF], 表示 (SQL Server のデータを)"
+ms.assetid: 6810b048-0a23-4f86-bfa5-97f92b3cfab4
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# チュートリアル: DataGrid コントロールで SQL Server データベースのデータを表示する
+このチュートリアルでは、SQL Server データベースからデータを取得して、<xref:System.Windows.Controls.DataGrid> コントロールでそのデータを表示します。  ADO.NET Entity Framework を使用して、データを表すエンティティ クラスを作成し、LINQ を使用して、エンティティ クラスから指定したデータを取得するためのクエリを記述します。  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)].  
+  
+-   AdventureWorksLT2008 サンプル データベースがアタッチされた、SQL Server または SQL Server Express の実行中のインスタンスへのアクセス。  AdventureWorksLT2008 データベースは、[CodePlex の Web サイト](http://go.microsoft.com/fwlink/?linkid=159848)からダウンロードできます。  
+  
+### エンティティ クラスを作成するには  
+  
+1.  Visual Basic または C\# で新しい WPF アプリケーション プロジェクトを作成して、「`DataGridSQLExample`」という名前を付けます。  
+  
+2.  ソリューション エクスプローラーでプロジェクトを右クリックし、**\[追加\]** をポイントして、**\[新しいアイテム\]** をクリックします。  
+  
+     \[新しい項目の追加\] ダイアログ ボックスが表示されます。  
+  
+3.  \[インストールされたテンプレート\] ペインで **\[データ\]** を選択し、テンプレートの一覧で **\[ADO.NET エンティティ データ モデル\]** を選択します。  
+  
+     ![ADO.NET エンティティ データ モデルの選択](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step1.png "DataGrid\_SQL\_EF\_Step1")  
+  
+4.  ファイルに「`AdventureWorksModel.edmx`」という名前を付け、**\[追加\]** をクリックします。  
+  
+     Entity Data Model ウィザードが表示されます。  
+  
+5.  \[モデルのコンテンツの選択\] 画面で、**\[データベースから生成\]** をクリックし、**\[次へ\]** をクリックします。  
+  
+     ![&#91;データベースから生成&#93; オプションの選択](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step2.png "DataGrid\_SQL\_EF\_Step2")  
+  
+6.  \[データ接続の選択\] 画面で、AdventureWorksLT2008 データベースへの接続情報を入力します。  詳細については、「[\[データ接続の選択\] ダイアログ ボックス](http://go.microsoft.com/fwlink/?LinkId=160190)」を参照してください。  
+  
+     ![データベースへの接続の提供](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step3.png "DataGrid\_SQL\_EF\_Step3")  
+  
+7.  名前が「`AdventureWorksLT2008Entities`」であり、**\[エンティティ接続設定に名前を付けて App.Config に保存\]** チェック ボックスがオンになっていることを確認し、**\[次へ\]** をクリックします。  
+  
+8.  \[データベース オブジェクトの選択\] 画面で、\[テーブル\] ノードを展開し、**Product** テーブルと **ProductCategory** テーブルをクリックします。  
+  
+     エンティティ クラスはすべてのテーブルについて生成できますが、この例ではこれら 2 つのテーブルのデータのみを取得します。  
+  
+     ![テーブルからの Product および ProductCategory の選択](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step4.png "DataGrid\_SQL\_EF\_Step4")  
+  
+9. **\[完了\]** をクリックします。  
+  
+     Product エンティティと ProductCategory エンティティが Entity Designer に表示されます。  
+  
+     ![Product および ProductCategory エンティティ モデル](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step5.png "DataGrid\_SQL\_EF\_Step5")  
+  
+### データを取得して表示するには  
+  
+1.  MainWindow.xaml ファイルを開きます。  
+  
+2.  <xref:System.Windows.Window> 上の <xref:System.Windows.FrameworkElement.Width%2A> プロパティを「450」に設定します。  
+  
+3.  XAML エディターで、`<Grid>` タグと `</Grid>` タグの間に次の <xref:System.Windows.Controls.DataGrid> タグを追加して、`dataGrid1` という名前の <xref:System.Windows.Controls.DataGrid> を追加します。  
+  
+     [!code-xml[DataGrid_SQL_EF_Walkthrough#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_SQL_EF_Walkthrough/CS/MainWindow.xaml#3)]  
+  
+     ![DataGrid のあるウィンドウ](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step6.png "DataGrid\_SQL\_EF\_Step6")  
+  
+4.  <xref:System.Windows.Window> を選択します。  
+  
+5.  プロパティ ウィンドウまたは XAML エディターを使用して、<xref:System.Windows.FrameworkElement.Loaded> イベントに対し、<xref:System.Windows.Window> のイベント ハンドラーを `Window_Loaded` という名前で作成します。  詳細については、「[方法 : 単純なイベント ハンドラーを作成する](http://msdn.microsoft.com/ja-jp/b1456e07-9dec-4354-99cf-18666b64f480)」を参照してください。  
+  
+     MainWindow.xaml の XAML を次に示します。  
+  
+    > [!NOTE]
+    >  Visual Basic を使用している場合は、MainWindow.xaml の最初の行で、`x:Class="DataGridSQLExample.MainWindow"` を `x:Class="MainWindow"` で置換します。  
+  
+     [!code-xml[DataGrid_SQL_EF_Walkthrough#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_SQL_EF_Walkthrough/CS/MainWindow.xaml#1)]  
+  
+6.  <xref:System.Windows.Window> の分離コード ファイル \(MainWindow.xaml.vb または MainWindow.xaml.cs\) を開きます。  
+  
+7.  次のコードを追加して、結合されたテーブルの特定の値のみを取得し、<xref:System.Windows.Controls.DataGrid> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを、クエリの結果に設定します。  
+  
+     [!code-csharp[DataGrid_SQL_EF_Walkthrough#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataGrid_SQL_EF_Walkthrough/CS/MainWindow.xaml.cs#2)]
+     [!code-vb[DataGrid_SQL_EF_Walkthrough#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataGrid_SQL_EF_Walkthrough/VB/MainWindow.xaml.vb#2)]  
+  
+8.  例を実行します。  
+  
+     <xref:System.Windows.Controls.DataGrid> にデータが表示されることを確認します。  
+  
+     ![SQL データベースからのデータがある DataGrid](../../../../docs/framework/wpf/controls/media/datagrid-sql-ef-step7.png "DataGrid\_SQL\_EF\_Step7")  
+  
+## 次の手順  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataGrid>   
+ [操作方法: WPF アプリケーションに Entity Framework で開始します。](http://go.microsoft.com/fwlink/?LinkId=159868)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/walkthroughs-create-a-custom-animated-button.md b/docs/framework/wpf/controls/walkthroughs-create-a-custom-animated-button.md
new file mode 100644
index 00000000000..c3034f05b5c
--- /dev/null
+++ b/docs/framework/wpf/controls/walkthroughs-create-a-custom-animated-button.md
@@ -0,0 +1,48 @@
+---
+title: "チュートリアル : カスタム アニメーション ボタンの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ボタン"
+  - "ボタン"
+  - "カスタム アニメーション ボタン"
+ms.assetid: e9532c72-460f-4898-9332-613fa21d746a
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# チュートリアル : カスタム アニメーション ボタンの作成
+名前のとおり、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は、ユーザーに豊富なプレゼンテーション エクスペリエンスをもたらすのに最適です。  このチュートリアルでは、ボタンの外観や動作 \(アニメーションを含む\) をカスタマイズする方法について説明します。  カスタマイズでは、スタイルやテンプレートを使用するので、このカスタム ボタンをアプリケーションの他のボタンに簡単に適用できます。  これから作成する、カスタマイズされたボタンを次の図に示します。  
+  
+ ![ユーザーが作成するカスタマイズされたボタン](../../../../docs/framework/wpf/controls/media/custom-button-blend-intro.png "custom\_button\_blend\_Intro")  
+  
+ ボタンの外観を構成するベクター グラフィックスは、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して作成します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は HTML に似ていますが、より強力で拡張性が高くなっています。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] は、Microsoft Visual Studio やメモ帳を使用して手入力したり、Microsoft Expression Blend などのビジュアル デザイン ツールを使用して入力したりできます。  Expression Blend は、基になる [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] コードを作成することによって機能するため、どちらの方法でも同じグラフィックスが作成されます。  
+  
+## このセクションの内容  
+ [Microsoft Expression Blend を使用してボタンを作成する](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md)  
+ Expression Blend のデザイナー機能を使用してカスタム動作を持つボタンを作成する方法を示します。  
+  
+ [XAML を使用したボタンの作成](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md)  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] と [!INCLUDE[vs_current_short](../../../../includes/vs-current-short-md.md)] を使用して、カスタム動作を持つボタンを作成する方法を示します。  
+  
+## 関連項目  
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)  
+ スタイルとテンプレートを使用してコントロールの外観と動作を指定する方法を示します。  
+  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のアニメーションとタイミング システムを使用してオブジェクトをアニメーション化する方法を示します。  
+  
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)  
+ ブラシ オブジェクトを使用して、純色、線形グラデーション、および放射状グラデーションで塗りつぶす方法を示します。  
+  
+ [ビットマップ効果の概要](../../../../docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md)  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] がサポートするビットマップ効果とその適用方法を示します。
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/window-styles-and-templates.md b/docs/framework/wpf/controls/window-styles-and-templates.md
new file mode 100644
index 00000000000..a393d6cec4e
--- /dev/null
+++ b/docs/framework/wpf/controls/window-styles-and-templates.md
@@ -0,0 +1,60 @@
+---
+title: "ウィンドウのスタイルとテンプレート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ControlTemplate [WPF], ウィンドウ"
+  - "パーツ [WPF], ウィンドウ"
+  - "状態 [WPF], ウィンドウ"
+  - "スタイル [WPF], ウィンドウ"
+  - "テンプレート [WPF], ウィンドウ"
+  - "Window [WPF], スタイルおよびテンプレート"
+ms.assetid: 2dfdf025-347b-4342-bf28-95206c273f35
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ウィンドウのスタイルとテンプレート
+このトピックでは、<xref:System.Windows.Window> コントロールのスタイルおよびテンプレートについて説明します。  既定の <xref:System.Windows.Controls.ControlTemplate> に変更を加えることで、コントロールに独自の外観を設定できます。  詳細については、「[ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)」を参照してください。  
+  
+## ウィンドウのパーツ  
+ <xref:System.Windows.Window> コントロールには、名前付きのパーツは存在しません。  
+  
+## ウィンドウの状態  
+ 次の表は、<xref:System.Windows.Window> コントロールの表示状態の一覧です。  
+  
+||||  
+|-|-|-|  
+|VisualState 名|VisualStateGroup 名|Description|  
+|Valid|ValidationStates|このコントロールは <xref:System.Windows.Controls.Validation> クラスを使用し、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `false` です。|  
+|InvalidFocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがあります。|  
+|InvalidUnfocused|ValidationStates|<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> 添付プロパティは `true` で、コントロールにはフォーカスがありません。|  
+  
+## Window ControlTemplate の例  
+ 次の例は、<xref:System.Windows.Window> コントロールの <xref:System.Windows.Controls.ControlTemplate> を定義する方法を示しています。  
+  
+ [!code-xml[ControlTemplateExamples#Window](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/window.xaml#window)]  
+  
+ <xref:System.Windows.Controls.ControlTemplate> は、次のリソースを 1 つ以上使用します。  
+  
+ [!code-xml[ControlTemplateExamples#ResizeGrip](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/resizegrip.xaml#resizegrip)]  
+[!code-xml[ControlTemplateExamples#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ControlTemplateExamples/CS/resources/shared.xaml#resources)]  
+  
+ サンプル全体については、[ControlTemplate を使用したスタイル設定のサンプル](http://go.microsoft.com/fwlink/?LinkID=160041)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Style%2A>   
+ <xref:System.Windows.Controls.ControlTemplate>   
+ [コントロールのスタイルとテンプレート](../../../../docs/framework/wpf/controls/control-styles-and-templates.md)   
+ [コントロールのカスタマイズ](../../../../docs/framework/wpf/controls/control-customization.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [ControlTemplate の作成による既存のコントロールの外観のカスタマイズ](../../../../docs/framework/wpf/controls/customizing-the-appearance-of-an-existing-control.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/wpf-content-model.md b/docs/framework/wpf/controls/wpf-content-model.md
new file mode 100644
index 00000000000..bd915d66589
--- /dev/null
+++ b/docs/framework/wpf/controls/wpf-content-model.md
@@ -0,0 +1,263 @@
+---
+title: "WPF のコンテンツ モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "任意のコンテンツのクラス [WPF], コンテンツ モデル"
+  - "コンテンツの表示 [WPF], コントロール"
+  - "コンテンツ モデル [WPF], コントロール"
+  - "ContentControl クラス [WPF], 表示 (コンテンツを)"
+  - "コントロール [WPF], 表示 (テキストを)"
+  - "コントロール [WPF], 書式設定 (テキストの)"
+  - "表示 (コンテンツを) [WPF]"
+  - "UIElement クラス [WPF], 表示 (コンテンツを)"
+ms.assetid: 214da5ef-547a-4cf8-9b07-4aa8a0e52cdd
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# WPF のコンテンツ モデル
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、コンテンツのさまざまな種類の表示が主な目的である、数多くのコントロール型やコントロールに似た型を提供するプレゼンテーション プラットフォームです。  使用するコントロールまたは派生元として使用するコントロールを決定するには、各コントロールで最適に表示できるオブジェクトの種類を理解しておくことが重要です。  
+  
+ このトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロール型とコントロールに似た型のコンテンツ モデルについて説明します。  コンテンツ モデルでは、コントロールで使用できるコンテンツが表されます。また、各コンテンツ モデルのコンテンツ プロパティについても示します。  コンテンツ プロパティは、オブジェクトのコンテンツの格納に使用されるプロパティです。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="classes_that_contain_arbitrary_content"></a>   
+## 任意のコンテンツを格納するクラス  
+ コントロールの中には、文字列、<xref:System.DateTime> オブジェクト、追加項目のコンテナーである <xref:System.Windows.UIElement> など、任意の型のオブジェクトを格納できるものがあります。  たとえば、<xref:System.Windows.Controls.Button> にはイメージおよびテキストを格納できます。また、<xref:System.Windows.Controls.CheckBox> には <xref:System.DateTime.Now%2A?displayProperty=fullName> の値を格納できます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、任意のコンテンツを格納できるクラスが 4 つあります。  <xref:System.Windows.Controls.Control> から継承するクラスの一覧を次の表に示します。  
+  
+|任意のコンテンツを格納するクラス|Content|  
+|----------------------|-------------|  
+|<xref:System.Windows.Controls.ContentControl>|単一の任意のオブジェクト。|  
+|<xref:System.Windows.Controls.HeaderedContentControl>|任意のオブジェクトであるヘッダーと単一の項目。|  
+|<xref:System.Windows.Controls.ItemsControl>|任意のオブジェクトのコレクション。|  
+|<xref:System.Windows.Controls.HeaderedItemsControl>|任意のオブジェクトであるヘッダーと項目のコレクション。|  
+  
+ これらのクラスから継承するコントロールは、同じ型のコンテンツを格納することができ、そのコンテンツを同じ方法で扱うことができます。  次の図は、イメージやテキストを格納する各コンテンツ モデルのコントロールを示しています。  
+  
+ ![Button、GroupBox、Listbax、TreeViewItem](../../../../docs/framework/wpf/controls/media/controlcontentmodelimagetextinto.PNG "ControlContentModelImageTextInto")  
+  
+### 単一の任意のオブジェクトを格納するコントロール  
+ <xref:System.Windows.Controls.ContentControl> クラスには、任意のコンテンツの 1 つが格納されます。  コンテンツ プロパティは <xref:System.Windows.Controls.ContentControl.Content%2A> です。  次に示すのは <xref:System.Windows.Controls.ContentControl> から継承し、そのコンテンツ モデルを使用するコントロールです。  
+  
+-   <xref:System.Windows.Controls.Button>  
+  
+-   <xref:System.Windows.Controls.Primitives.ButtonBase>  
+  
+-   <xref:System.Windows.Controls.CheckBox>  
+  
+-   <xref:System.Windows.Controls.ComboBoxItem>  
+  
+-   <xref:System.Windows.Controls.ContentControl>  
+  
+-   <xref:System.Windows.Controls.Frame>  
+  
+-   <xref:System.Windows.Controls.GridViewColumnHeader>  
+  
+-   <xref:System.Windows.Controls.GroupItem>  
+  
+-   <xref:System.Windows.Controls.Label>  
+  
+-   <xref:System.Windows.Controls.ListBoxItem>  
+  
+-   <xref:System.Windows.Controls.ListViewItem>  
+  
+-   <xref:System.Windows.Navigation.NavigationWindow>  
+  
+-   <xref:System.Windows.Controls.RadioButton>  
+  
+-   <xref:System.Windows.Controls.Primitives.RepeatButton>  
+  
+-   <xref:System.Windows.Controls.ScrollViewer>  
+  
+-   <xref:System.Windows.Controls.Primitives.StatusBarItem>  
+  
+-   <xref:System.Windows.Controls.Primitives.ToggleButton>  
+  
+-   <xref:System.Windows.Controls.ToolTip>  
+  
+-   <xref:System.Windows.Controls.UserControl>  
+  
+-   <xref:System.Windows.Window>  
+  
+ 次の図は、<xref:System.Windows.Controls.ContentControl.Content%2A> が文字列、<xref:System.DateTime> オブジェクト、<xref:System.Windows.Shapes.Rectangle>、および <xref:System.Windows.Controls.Panel> \(<xref:System.Windows.Shapes.Ellipse> と <xref:System.Windows.Controls.TextBlock> を格納する\) が設定された 4 つのボタンを示しています。  
+  
+ ![4 つのボタン](../../../../docs/framework/wpf/controls/media/controlcontentmodelbuttons.png "ControlContentModelButtons")  
+異なる型のコンテンツを持つ 4 つのボタン  
+  
+ <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティの設定方法の例については、<xref:System.Windows.Controls.ContentControl> のトピックを参照してください。  
+  
+### ヘッダーおよび単一の任意のオブジェクトを格納するコントロール  
+ <xref:System.Windows.Controls.ContentControl> から継承される <xref:System.Windows.Controls.HeaderedContentControl> クラスは、ヘッダーを使用してコンテンツを表示します。  コンテンツ プロパティ <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.Windows.Controls.ContentControl> から継承し、<xref:System.Object> 型の <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> プロパティを定義します。その結果、ヘッダーとコンテンツの両者が任意のオブジェクトとなることができます。  
+  
+ 次に示すのは <xref:System.Windows.Controls.HeaderedContentControl> から継承し、そのコンテンツ モデルを使用するコントロールです。  
+  
+-   <xref:System.Windows.Controls.Expander>  
+  
+-   <xref:System.Windows.Controls.GroupBox>  
+  
+-   <xref:System.Windows.Controls.TabItem>  
+  
+ 次の図に、2 つの <xref:System.Windows.Controls.TabItem> オブジェクトを示します。  1 つ目の <xref:System.Windows.Controls.TabItem> には <xref:System.Windows.UIElement> オブジェクトが <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> および <xref:System.Windows.Controls.ContentControl.Content%2A> として付いています。  <xref:System.Windows.Controls.HeaderedContentControl.Header%2A> は <xref:System.Windows.Shapes.Ellipse> と <xref:System.Windows.Controls.TextBlock> を格納する <xref:System.Windows.Controls.StackPanel> に設定されています。  <xref:System.Windows.Controls.ContentControl.Content%2A> は <xref:System.Windows.Controls.TextBlock> と <xref:System.Windows.Controls.Label> を格納する <xref:System.Windows.Controls.StackPanel> に設定されています。  2 つ目の <xref:System.Windows.Controls.TabItem> の場合、<xref:System.Windows.Controls.HeaderedContentControl.Header%2A> には文字列、<xref:System.Windows.Controls.ContentControl.Content%2A> には <xref:System.Windows.Controls.TextBlock> が付いています。  
+  
+ ![TabControl](../../../../docs/framework/wpf/controls/media/controlcontentmodelteabitem.PNG "ControlContentModelTeabItem")  
+Header プロパティで異なる型を使用する TabControl  
+  
+ <xref:System.Windows.Controls.TabItem> オブジェクトを作成する方法の例については、<xref:System.Windows.Controls.HeaderedContentControl> のトピックを参照してください。  
+  
+### 任意のオブジェクトのコレクションを格納するコントロール  
+ <xref:System.Windows.Controls.Control> から継承する <xref:System.Windows.Controls.ItemsControl> クラスには、文字列、オブジェクト、他の要素などの複数の項目を格納できます。  このクラスのコンテンツ プロパティは <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> と <xref:System.Windows.Controls.ItemsControl.Items%2A> です。  <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> は通常、データ収集時に <xref:System.Windows.Controls.ItemsControl> を取得するために使用されます。  コレクションを使用して <xref:System.Windows.Controls.ItemsControl> を取得しない場合は、<xref:System.Windows.Controls.ItemsControl.Items%2A> プロパティを使用して項目を追加できます。  
+  
+ 次に示すのは <xref:System.Windows.Controls.ItemsControl> から継承し、そのコンテンツ モデルを使用するコントロールです。  
+  
+-   <xref:System.Windows.Controls.Menu>  
+  
+-   <xref:System.Windows.Controls.Primitives.MenuBase>  
+  
+-   <xref:System.Windows.Controls.ContextMenu>  
+  
+-   <xref:System.Windows.Controls.ComboBox>  
+  
+-   <xref:System.Windows.Controls.ItemsControl>  
+  
+-   <xref:System.Windows.Controls.ListBox>  
+  
+-   <xref:System.Windows.Controls.ListView>  
+  
+-   <xref:System.Windows.Controls.TabControl>  
+  
+-   <xref:System.Windows.Controls.TreeView>  
+  
+-   <xref:System.Windows.Controls.Primitives.Selector>  
+  
+-   <xref:System.Windows.Controls.Primitives.StatusBar>  
+  
+ 次の図は、これらの型の項目を含む <xref:System.Windows.Controls.ListBox> を示しています。  
+  
+-   文字列  
+  
+-   <xref:System.DateTime> オブジェクト。  
+  
+-   <xref:System.Windows.UIElement>。  
+  
+-   <xref:System.Windows.Shapes.Ellipse> と <xref:System.Windows.Controls.TextBlock> が格納された <xref:System.Windows.Controls.Panel>。  
+  
+ ![4 種類の内容を含む ListBox](../../../../docs/framework/wpf/controls/media/controlcontentmodellistbox2.PNG "ControlContentModelListBox2")  
+さまざまな種類のオブジェクトを格納する ListBox  
+  
+### ヘッダーと任意のオブジェクトのコレクションを格納するコントロール  
+ <xref:System.Windows.Controls.ItemsControl> から継承する <xref:System.Windows.Controls.HeaderedItemsControl> クラスには、文字列、オブジェクト、ヘッダー、他の要素などの複数の項目を格納できます。  このクラスは <xref:System.Windows.Controls.ItemsControl> のコンテンツ プロパティである <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> と <xref:System.Windows.Controls.ItemsControl.Items%2A> を継承し、任意のオブジェクトとなるように <xref:System.Windows.Controls.HeaderedItemsControl.Header%2A> プロパティを定義します。  
+  
+ 次に示すのは <xref:System.Windows.Controls.HeaderedItemsControl> から継承し、そのコンテンツ モデルを使用するコントロールです。  
+  
+-   <xref:System.Windows.Controls.MenuItem>  
+  
+-   <xref:System.Windows.Controls.ToolBar>  
+  
+-   <xref:System.Windows.Controls.TreeViewItem>  
+  
+<a name="classes_that_contain_a_collection_of_uielement_objects"></a>   
+## UIElement オブジェクトのコレクションを格納するクラス  
+ <xref:System.Windows.Controls.Panel> クラスは、子である <xref:System.Windows.UIElement> オブジェクトの配置および配列を行います。  コンテンツ プロパティは <xref:System.Windows.Controls.Panel.Children%2A> です。  
+  
+ 次に示すのは <xref:System.Windows.Controls.Panel> クラスから継承し、そのコンテンツ モデルを使用するクラスです。  
+  
+-   <xref:System.Windows.Controls.Canvas>  
+  
+-   <xref:System.Windows.Controls.DockPanel>  
+  
+-   <xref:System.Windows.Controls.Grid>  
+  
+-   <xref:System.Windows.Controls.Primitives.TabPanel>  
+  
+-   <xref:System.Windows.Controls.Primitives.ToolBarOverflowPanel>  
+  
+-   <xref:System.Windows.Controls.Primitives.ToolBarPanel>  
+  
+-   <xref:System.Windows.Controls.Primitives.UniformGrid>  
+  
+-   <xref:System.Windows.Controls.StackPanel>  
+  
+-   <xref:System.Windows.Controls.VirtualizingPanel>  
+  
+-   <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+-   <xref:System.Windows.Controls.WrapPanel>  
+  
+ 詳細については、「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」を参照してください。  
+  
+<a name="classes_that_affects_the_appearance_of_a_uielement"></a>   
+## UIElement の外観に影響するクラス  
+ <xref:System.Windows.Controls.Decorator> クラスは、単一の子である <xref:System.Windows.UIElement> 上またはその周囲に視覚的な効果を適用します。  コンテンツ プロパティは <xref:System.Windows.Controls.Decorator.Child%2A> です。  次に示すのは <xref:System.Windows.Controls.Decorator> から継承し、そのコンテンツ モデルを使用するクラスです。  
+  
+-   <xref:System.Windows.Documents.AdornerDecorator>  
+  
+-   <xref:System.Windows.Controls.Border>  
+  
+-   <xref:System.Windows.Controls.Primitives.BulletDecorator>  
+  
+-   <xref:Microsoft.Windows.Themes.ButtonChrome>  
+  
+-   <xref:Microsoft.Windows.Themes.ClassicBorderDecorator>  
+  
+-   <xref:System.Windows.Controls.InkPresenter>  
+  
+-   <xref:Microsoft.Windows.Themes.ListBoxChrome>  
+  
+-   <xref:Microsoft.Windows.Themes.SystemDropShadowChrome>  
+  
+-   <xref:System.Windows.Controls.Viewbox>  
+  
+ 周囲を <xref:System.Windows.Controls.Border> で装飾した <xref:System.Windows.Controls.TextBox> を次の図に示します。  
+  
+ ![境界線が黒の TextBox](../../../../docs/framework/wpf/controls/media/layout-border-around-textbox.png "Layout\_Border\_around\_TextBox")  
+境界線のある TextBlock  
+  
+<a name="classes_that_provides_visual_feedback_about_a_uielement"></a>   
+## UIElement の視覚的フィードバックを提供するクラス  
+ <xref:System.Windows.Documents.Adorner> クラスは、ユーザーに視覚上の手掛かりを示します。  たとえば、<xref:System.Windows.Documents.Adorner> を使用すると、要素に機能ハンドルを追加したり、コントロールに関する状態情報を提供したりできます。  <xref:System.Windows.Documents.Adorner> クラスでは、独自の装飾を作成できるようにするフレームワークが用意されています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、実装済みの装飾は用意されていません。  詳細については、「[装飾の概要](../../../../docs/framework/wpf/controls/adorners-overview.md)」を参照してください。  
+  
+<a name="classes_that_enable_users_to_enter_text"></a>   
+## ユーザーがテキストを入力できるようにするクラス  
+ WPF には、ユーザーがテキストを入力できるようにするための主要なコントロールが 3 つ用意されています。  各コントロールは、テキストをそれぞれの形式で表示できます。  次の表に、これら 3 つのテキスト関連のコントロールを、テキストの表示形式およびテキストを格納するプロパティと共に示します。  
+  
+|Control|テキストの表示形式|コンテンツ プロパティ|  
+|-------------|---------------|-----------------|  
+|<xref:System.Windows.Controls.TextBox>|書式なしテキスト|<xref:System.Windows.Controls.TextBox.Text%2A>|  
+|<xref:System.Windows.Controls.RichTextBox>|書式設定されたテキスト|<xref:System.Windows.Controls.RichTextBox.Document%2A>|  
+|<xref:System.Windows.Controls.PasswordBox>|非表示のテキスト \(マスクされた文字\)|<xref:System.Windows.Controls.PasswordBox.Password%2A>|  
+  
+<a name="classes_that_display_text"></a>   
+## テキストを表示するクラス  
+ 書式なしのテキストまたは書式設定されたテキストを表示できるクラスはいくつかあります。  短いテキストを表示する場合は、<xref:System.Windows.Controls.TextBlock> を使用します。  長いテキストを表示する場合は、<xref:System.Windows.Controls.FlowDocumentReader> コントロール、<xref:System.Windows.Controls.FlowDocumentPageViewer> コントロールまたは <xref:System.Windows.Controls.FlowDocumentScrollViewer> コントロールを使用します。  
+  
+ <xref:System.Windows.Controls.TextBlock> には、<xref:System.Windows.Controls.TextBlock.Text%2A> および <xref:System.Windows.Controls.TextBlock.Inlines%2A> という 2 つのコンテンツ プロパティがあります。  表示するテキストに一貫性のある書式を適用する場合は、<xref:System.Windows.Controls.TextBlock.Text%2A> プロパティの使用が適しています。  テキスト全体で異なる書式を使用する場合は、<xref:System.Windows.Controls.TextBlock.Inlines%2A> プロパティを使用します。  <xref:System.Windows.Controls.TextBlock.Inlines%2A> プロパティは、テキストの書式を指定する <xref:System.Windows.Documents.Inline> オブジェクトのコレクションです。  
+  
+ <xref:System.Windows.Controls.FlowDocumentReader>、<xref:System.Windows.Controls.FlowDocumentPageViewer>、および <xref:System.Windows.Controls.FlowDocumentScrollViewer> クラスのコンテンツ プロパティを次の表に示します。  
+  
+|Control|コンテンツ プロパティ|コンテンツ プロパティの型|  
+|-------------|-----------------|-------------------|  
+|<xref:System.Windows.Controls.FlowDocumentPageViewer>|Document|<xref:System.Windows.Documents.IDocumentPaginatorSource>|  
+|<xref:System.Windows.Controls.FlowDocumentReader>|Document|<xref:System.Windows.Documents.FlowDocument>|  
+|<xref:System.Windows.Controls.FlowDocumentScrollViewer>|Document|<xref:System.Windows.Documents.FlowDocument>|  
+  
+ <xref:System.Windows.Documents.FlowDocument> では <xref:System.Windows.Documents.IDocumentPaginatorSource> インターフェイスを実装します。このため、3 つのクラスはすべて <xref:System.Windows.Documents.FlowDocument> をコンテンツとして受け取ることができます。  
+  
+<a name="classes_that_format_text"></a>   
+## テキストの書式を設定するクラス  
+ <xref:System.Windows.Documents.TextElement> およびその関連クラスでは、テキストの書式を設定できます。  <xref:System.Windows.Documents.TextElement> オブジェクトには、<xref:System.Windows.Controls.TextBlock> オブジェクトおよび <xref:System.Windows.Documents.FlowDocument> オブジェクトでテキストを格納し、その書式を設定できます。  <xref:System.Windows.Documents.TextElement> オブジェクトの主要な型は <xref:System.Windows.Documents.Block> 要素および <xref:System.Windows.Documents.Inline> 要素の 2 つです。  <xref:System.Windows.Documents.Block> 要素は、段落や一覧などの 1 つのテキスト ブロックを表します。  <xref:System.Windows.Documents.Inline> 要素は、ブロック内のテキストの部分を表します。  多くの <xref:System.Windows.Documents.Inline> クラスでは、テキストに適用される書式を指定します。  それぞれの <xref:System.Windows.Documents.TextElement> には独自のコンテンツ モデルがあります。  詳細については、「[TextElement コンテンツ モデルの概要](../../../../docs/framework/wpf/advanced/textelement-content-model-overview.md)」を参照してください。  
+  
+## 参照  
+ [詳細設定](../../../../docs/framework/wpf/advanced/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/controls/wrappanel.md b/docs/framework/wpf/controls/wrappanel.md
new file mode 100644
index 00000000000..490637b04fc
--- /dev/null
+++ b/docs/framework/wpf/controls/wrappanel.md
@@ -0,0 +1,48 @@
+---
+title: "WrapPanel | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "コンテンツ [WPF], 順番に配置"
+  - "コントロール [WPF], WrapPanel"
+  - "WrapPanel コントロール [WPF]"
+ms.assetid: f0acb1b4-df71-4c5a-b4a4-98f189002537
+caps.latest.revision: 63
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 63
+---
+# WrapPanel
+<xref:System.Windows.Controls.WrapPanel> 要素は、左から右へ順に子要素を配置し、ボックスの端で改行してコンテンツを次の行へ送ります。  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Panel>  
+  
+ <xref:System.Windows.Controls.Canvas>  
+  
+ <xref:System.Windows.Controls.DockPanel>  
+  
+ <xref:System.Windows.Controls.Grid>  
+  
+ <xref:System.Windows.Controls.StackPanel>  
+  
+ <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+ <xref:System.Windows.Controls.WrapPanel>  
+  
+## 関連項目  
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)  
+  
+ [ScrollViewer の概要](../../../../docs/framework/wpf/controls/scrollviewer-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/TOC.md b/docs/framework/wpf/data/TOC.md
new file mode 100644
index 00000000000..96f489b3117
--- /dev/null
+++ b/docs/framework/wpf/data/TOC.md
@@ -0,0 +1,41 @@
+# [TextBox テキストでソースを更新するタイミングを制御する](how-to-control-when-the-textbox-text-updates-the-source.md)
+# [LINQ クエリの結果にバインドする](how-to-bind-to-the-results-of-a-linq-query.md)
+# [データ CollectionView のオブジェクト間を移動する](how-to-navigate-through-the-objects-in-a-data-collectionview.md)
+# [ビュー内のデータの並べ替え](how-to-sort-data-in-a-view.md)
+# [バインディングの検証の実装](how-to-implement-binding-validation.md)
+# [階層 XML データでマスター詳細パターンを使用する](how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md)
+# [PriorityBinding を実装する](how-to-implement-prioritybinding.md)
+# [ビュー内のデータをフィルター処理する](how-to-filter-data-in-a-view.md)
+# [データ バインドの概要](data-binding-overview.md)
+# [DataTemplate によって生成された要素を検索する](how-to-find-datatemplate-generated-elements.md)
+# [バインディング宣言の概要](binding-declarations-overview.md)
+# [列挙値にバインドする](how-to-bind-to-an-enumeration.md)
+# [データ コレクションの既定のビューを取得する](how-to-get-the-default-view-of-a-data-collection.md)
+# [バインドされた項目の一覧に基づいて値を生成する](how-to-produce-a-value-based-on-a-list-of-bound-items.md)
+# [バインドされたデータを変換する](how-to-convert-bound-data.md)
+# [ADO.NET データ ソースにバインドする](how-to-bind-to-an-ado-net-data-source.md)
+# [データ バインドで XML 名前空間を使用する](how-to-use-xml-namespaces-in-data-binding.md)
+# [方法のトピック](data-binding-how-to-topics.md)
+# [コレクションにバインドして選択に基づく情報を表示する](how-to-bind-to-a-collection-and-display-information-based-on-selection.md)
+# [データ バインディング](data-binding-wpf.md)
+# [バインドされているターゲット プロパティからのバインディング オブジェクトの取得](how-to-get-the-binding-object-from-a-bound-target-property.md)
+# [XMLDataProvider と XPath クエリを使用して XML データにバインドする](how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)
+# [Web サービスにバインドする](how-to-bind-to-a-web-service.md)
+# [カスタム オブジェクトに検証ロジックを実装する](how-to-implement-validation-logic-on-custom-objects.md)
+# [バインディングをクリアする](how-to-clear-bindings.md)
+# [XAML でデータをバインディング可能にする](how-to-make-data-available-for-binding-in-xaml.md)
+# [ObservableCollection を作成およびバインドする](how-to-create-and-bind-to-an-observablecollection.md)
+# [XDocument、XElement、または LINQ for XML クエリの結果にバインドする](how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md)
+# [簡単なバインディングを作成する](how-to-create-a-simple-binding.md)
+# [メソッドにバインドする](how-to-bind-to-a-method.md)
+# [バインディングの更新の通知を設定する](how-to-set-up-notification-of-binding-updates.md)
+# [バインディング ソースを指定する](how-to-specify-the-binding-source.md)
+# [バインディングの方向を指定する](how-to-specify-the-direction-of-the-binding.md)
+# [プロパティの変更通知を実装する](how-to-implement-property-change-notification.md)
+# [バインディング ソースの概要](binding-sources-overview.md)
+# [コードでバインディングを作成する](how-to-create-a-binding-in-code.md)
+# [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](how-to-sort-and-group-data-using-a-view-in-xaml.md)
+# [階層データでマスター詳細パターンを使用する](how-to-use-the-master-detail-pattern-with-hierarchical-data.md)
+# [データ テンプレートの概要](data-templating-overview.md)
+# [CompositeCollection を実装する](how-to-implement-a-compositecollection.md)
+# [2 つのコントロールのプロパティをバインドする](how-to-bind-the-properties-of-two-controls.md)
diff --git a/docs/framework/wpf/data/binding-declarations-overview.md b/docs/framework/wpf/data/binding-declarations-overview.md
new file mode 100644
index 00000000000..a3e956fbc7e
--- /dev/null
+++ b/docs/framework/wpf/data/binding-declarations-overview.md
@@ -0,0 +1,138 @@
+---
+title: "バインディング宣言の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 宣言"
+  - "バインディング宣言"
+  - "データ バインディング, 宣言"
+  - "マークアップ拡張機能"
+  - "オブジェクト要素構文"
+  - "構文, オブジェクト要素"
+ms.assetid: b97fd626-4c0d-4761-872a-2bca5820da2c
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# バインディング宣言の概要
+ここでは、バインディングを宣言するさまざまな方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Prereq"></a>   
+## 必要条件  
+ このトピックを読む前に、マークアップ拡張機能の概念と使用方法を理解していることが重要です。  マークアップ拡張機能の詳細については、「[マークアップ拡張機能と WPF XAML](../../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+ ここでは、データ バインディングの概念については説明しません。  データ バインディングの概念については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+<a name="BindinginXAML"></a>   
+## XAML でバインディングを宣言する  
+ ここでは、XAML でバインディングを宣言する方法について説明します。  
+  
+<a name="MarkupExtensionSyntax"></a>   
+### マークアップ拡張機能の使用方法  
+ <xref:System.Windows.Data.Binding> はマークアップ拡張機能です。  バインディング拡張を使用してバインディングを宣言する場合、その宣言は、`Binding` キーワードの後に一連の句をコンマ \(,\) で区切って並べたものになります。  バインディング宣言では、句は任意の順序で並べることができ、また、さまざまな組み合わせが可能です。  句は *名前*\=*値* という形のペアで、*名前*は <xref:System.Windows.Data.Binding> プロパティの名前、*値* はそのプロパティに設定する値です。  
+  
+ バインディング宣言文字列をマークアップで作成する場合、それらの文字列はターゲット オブジェクトの特定の[依存関係プロパティ](GTMT)に関連付ける必要があります。  バインディング拡張を使用し、<xref:System.Windows.Data.Binding.Source%2A> プロパティおよび <xref:System.Windows.Data.Binding.Path%2A> プロパティを指定して、<xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> プロパティをバインドする方法を次の例に示します。  
+  
+ [!code-xml[SimpleBinding#BDO1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#bdo1)]  
+  
+ <xref:System.Windows.Data.Binding> クラスのほとんどのプロパティは、この方法で指定できます。  バインディング拡張の詳細、およびバインディング拡張を使用して設定できない <xref:System.Windows.Data.Binding> プロパティのリストについては、「[バインドのマークアップ拡張機能](../../../../docs/framework/wpf/advanced/binding-markup-extension.md)」の概要を参照してください。  
+  
+<a name="ObjectElementSyntax"></a>   
+### オブジェクト要素の構文  
+ オブジェクト要素構文を使用しても、バインディング宣言を作成できます。  ほとんどの場合、マークアップ拡張機能とオブジェクト要素構文のどちらを使用した場合でも、特別な利点はありません。  ただし、設定するプロパティ値が型変換のない非文字列型である場合のように、目的のシナリオがマークアップ拡張機能でサポートされない場合には、オブジェクト要素構文を使用する必要があります。  
+  
+ オブジェクト要素構文とマークアップ拡張機能の両方の使用方法を次の例に示します。  
+  
+ [!code-xml[BindConversionMarkup#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindConversionMarkup/CSharp/Page1.xaml#1)]  
+  
+ この例では、拡張構文を使用してバインディングを宣言することにより、<xref:System.Windows.Controls.TextBlock.Foreground%2A> プロパティをバインドしています。  <xref:System.Windows.Controls.TextBlock.Text%2A> プロパティのバインディング宣言では、オブジェクト要素構文を使用しています。  
+  
+ 各種の用語の詳細については、「[XAML 構文の詳細](../../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+<a name="MBandPB"></a>   
+### MultiBinding および PriorityBinding  
+ <xref:System.Windows.Data.MultiBinding> および <xref:System.Windows.Data.PriorityBinding> は、XAML 拡張構文をサポートしません。  そのため、XAML で <xref:System.Windows.Data.MultiBinding> または <xref:System.Windows.Data.PriorityBinding> を宣言する場合は、オブジェクト要素構文を使用する必要があります。  
+  
+<a name="BindinginCode"></a>   
+## コードでバインディングを作成する  
+ バインディングを指定するもう一つの方法として、コード内で <xref:System.Windows.Data.Binding> オブジェクトのプロパティを直接設定する方法があります。  <xref:System.Windows.Data.Binding> オブジェクトを作成し、コードでプロパティを指定する方法を次の例に示します。  この例では、`TheConverter` は <xref:System.Windows.Data.IValueConverter> インターフェイスを実装するオブジェクトです。  
+  
+ [!code-csharp[BindConversion#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindConversion/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[BindConversion#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BindConversion/visualbasic/window1.xaml.vb#1)]  
+[!code-csharp[BindConversion#end1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindConversion/CSharp/Window1.xaml.cs#end1)]
+[!code-vb[BindConversion#end1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BindConversion/visualbasic/window1.xaml.vb#end1)]  
+  
+ バインドする対象のオブジェクトが <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> の場合は、<xref:System.Windows.Data.BindingOperations.SetBinding%2A?displayProperty=fullName> を使用する代わりに、オブジェクトで `SetBinding` メソッドを直接呼び出すことができます。  例については、「[コードでバインディングを作成する](../../../../docs/framework/wpf/data/how-to-create-a-binding-in-code.md)」を参照してください。  
+  
+<a name="Path_Syntax"></a>   
+## パス構文をバインドする  
+ バインドするソースの値を指定するには、<xref:System.Windows.Data.Binding.Path%2A> プロパティを使用します。  
+  
+-   特に単純な使用例では、<xref:System.Windows.Data.Binding.Path%2A> プロパティ値は `Path=PropertyName` など、バインディングに使用するソース オブジェクトのプロパティの名前になります。  
+  
+-   プロパティのサブプロパティは、[!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] 内の構文と同様の構文によって指定できます。  たとえば、`Path=ShoppingCart.Order` 句は、オブジェクトまたはプロパティ `ShoppingCart` のサブプロパティ `Order` へのバインディングを設定します。  
+  
+-   [添付プロパティ](GTMT)にバインドするには、[添付プロパティ](GTMT)をかっこで囲みます。  たとえば、[添付プロパティ](GTMT) <xref:System.Windows.Controls.DockPanel.Dock%2A?displayProperty=fullName> にバインドする構文は、`Path=(DockPanel.Dock)` です。  
+  
+-   プロパティのインデクサーは、インデクサーが適用されるプロパティ名の後に続く角かっこ内に指定できます。  たとえば、`Path=ShoppingCart[0]` 句は、プロパティの内部のインデックスのリテラル文字列 "0" の処理方法に対応するインデックスにバインディングを設定します。  入れ子になったインデクサーもサポートされています。  
+  
+-   インデクサーとサブプロパティは、`Path` 句に混在させることができます。たとえば、`Path=ShoppingCart.ShippingInfo[MailingAddress,Street]` のように使用できます。  
+  
+-   インデクサーの内側では、複数のインデクサー パラメーターをコンマ \(,\) で区切って指定できます。  各パラメーターの型は、かっこを使用して指定できます。  たとえば、`Path="[(sys:Int32)42,(sys:Int32)24]"` のように指定します。ここで、`sys` は `System` 名前空間にマップされます。  
+  
+-   ソースがコレクション ビューであるときは、現在の項目をスラッシュ \(\/\) で指定できます。  たとえば、`Path=/` 句は、ビュー内の現在の項目へのバインディングを設定します。  ソースがコレクションである場合、この構文は、既定のコレクション ビューの現在の項目を指定します。  
+  
+-   プロパティ名とスラッシュを組み合わせて、コレクションである各プロパティを走査することができます。  たとえば、`Path=/Offices/ManagerName` は、それ自体がコレクションである `Offices` プロパティを含む、ソース コレクションの現在の項目を指定します。  その現在の項目は、`ManagerName` プロパティを含むオブジェクトです。  
+  
+-   また、ピリオド \(.\) パスを使用して現在のソースにバインドすることもできます。  たとえば、`Text="{Binding}"` は `Text="{Binding Path=.}"` と同じ意味です。  
+  
+### エスケープ機構  
+  
+-   インデクサー \(\[ \]\) 内では、キャレット文字 \(^\) は次の文字をエスケープします。  
+  
+-   XAML で <xref:System.Windows.Data.Binding.Path%2A> を指定する場合は、XML 言語定義で特別な意味を持つ特定の文字についても \(XML エンティティを使用して\) 次のようにエスケープする必要があります。  
+  
+    -   文字 "&" をエスケープするには、`&` を使用します。  
+  
+    -   タグの終了を示す "\>" をエスケープするには、`>` を使用します。  
+  
+-   また、マークアップ拡張構文を使用して、属性内にバインディング全体を記述する場合には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] マークアップ拡張機能パーサーにとって特別な意味を持つ次の文字を \(バックスラッシュ \\ を使用して\) エスケープする必要があります。  
+  
+    -   バックスラッシュ \(\\\) は、それ自体がエスケープ文字です。  
+  
+    -   等号 \(\=\) は、プロパティ名とプロパティ値を区切ります。  
+  
+    -   コンマ \(,\) は、複数のプロパティを区切ります。  
+  
+    -   右中かっこ \(}\) は、マークアップ拡張機能の終了を示します。  
+  
+<a name="Default"></a>   
+## 既定の動作  
+ 宣言に指定がない場合の既定の動作は次のとおりです。  
+  
+-   [バインディング ソース](GTMT)値と[バインディング ターゲット](GTMT)値を相互に型変換する既定のコンバーターが作成されます。  型変換できない場合、既定のコンバーターは `null` を返します。  
+  
+-   <xref:System.Windows.Data.Binding.ConverterCulture%2A> を設定しない場合、バインディング エンジンでは、[バインディング ターゲット](GTMT) オブジェクトの `Language` プロパティが使用されます。  XAML では、このプロパティは既定で "en\-US" に設定されるか、明示的に設定されている場合はページのルート要素 \(または任意の要素\) から値を継承します。  
+  
+-   バインディングに既にデータ コンテキストが存在し \(たとえば、親要素から継承したデータ コンテキストの場合\)、そのコンテキストから返される項目またはコレクションがすべてバインディングするために適切であり、パスを変更する必要もない場合には、バインディング宣言は、`{Binding}` のように、句を一切含めないで宣言することができます。これは、バインディングがコレクションに影響を与えるデータ スタイルに対してバインディングを指定する場合に多く用いられる方法です。  詳細については、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」の「オブジェクト全体をバインディング ソースとして使用する」セクションを参照してください。  
+  
+-   既定の <xref:System.Windows.Data.Binding.Mode%2A> は、バインドされる[依存関係プロパティ](GTMT)に応じて、一方向と双方向のいずれかになります。  バインディングを目的どおりに動作させるために、バインディング モードを常に明示的に宣言できます。  一般に、ユーザーが編集できる <xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> や <xref:System.Windows.Controls.Primitives.RangeBase.Value%2A?displayProperty=fullName> などのコントロール プロパティは、既定で双方向のバインディングであり、それ以外のほとんどのプロパティは既定で一方向のバインディングになります。  
+  
+-   既定の <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値も、バインドされる[依存関係プロパティ](GTMT)に応じて、<xref:System.Windows.Data.UpdateSourceTrigger> と <xref:System.Windows.Data.UpdateSourceTrigger> のいずれかになります。  ほとんどの[依存関係プロパティ](GTMT)の既定値は <xref:System.Windows.Data.UpdateSourceTrigger> であるのに対し、<xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> プロパティの既定値は <xref:System.Windows.Data.UpdateSourceTrigger> です。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [PropertyPath の XAML 構文](../../../../docs/framework/wpf/advanced/propertypath-xaml-syntax.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/binding-sources-overview.md b/docs/framework/wpf/data/binding-sources-overview.md
new file mode 100644
index 00000000000..af3076967f9
--- /dev/null
+++ b/docs/framework/wpf/data/binding-sources-overview.md
@@ -0,0 +1,111 @@
+---
+title: "バインディング ソースの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), バインディング ソース"
+  - "バインディング ソース"
+  - "データ バインディング, バインディング ソース"
+ms.assetid: 2df2cd11-6aac-4bdf-ab7b-ea5f464cd5ca
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# バインディング ソースの概要
+データ バインディングでは、データの取得元のオブジェクトを[バインディング ソース](GTMT) オブジェクトと呼びます。  ここでは、バインディング ソースとして使用できるオブジェクトの種類について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="binding_sources"></a>   
+## バインディング ソースの種類  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] データ バインディングでは、次の種類の[バインディング ソース](GTMT)がサポートされます。  
+  
+|バインディング ソース|Description|  
+|-----------------|-----------------|  
+|[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクト|任意の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトのパブリック プロパティ、サブプロパティ、およびインデクサーにバインドできます。  バインディング エンジンは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] リフレクションを使用してプロパティの値を取得します。  また、<xref:System.ComponentModel.ICustomTypeDescriptor> を実装しているオブジェクトや、登録された <xref:System.ComponentModel.TypeDescriptionProvider> を持つオブジェクトも、バインディング エンジンと連携できます。<br /><br /> バインディング ソースとして使用できるクラスの実装方法の詳細については、このトピックで後述する「[バインディング ソースとしてクラスを実装する](#classes)」を参照してください。|  
+|動的オブジェクト|<xref:System.Dynamic.IDynamicMetaObjectProvider> インターフェイスを実装するオブジェクトの使用可能なプロパティおよびインデクサーにバインドできます。  コードのメンバーにアクセスできる場合は、そのメンバーにバインドできます。  たとえば、動的オブジェクトを使用して `someObjet.AProperty` によってコードのメンバーにアクセスできる場合は、バインド パスを `AProperty` に設定することでそのメンバーにバインドできます。|  
+|[!INCLUDE[TLA#tla_adonet](../../../../includes/tlasharptla-adonet-md.md)] オブジェクト|<xref:System.Data.DataTable> などの [!INCLUDE[TLA2#tla_adonet](../../../../includes/tla2sharptla-adonet-md.md)] オブジェクトにバインドできます。[!INCLUDE[TLA2#tla_adonet](../../../../includes/tla2sharptla-adonet-md.md)] <xref:System.Data.DataView> は <xref:System.ComponentModel.IBindingList> インターフェイスを実装し、バインド エンジンがリッスンする変更通知を提供します。|  
+|[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] オブジェクト|<xref:System.Xml.XmlNode>、<xref:System.Xml.XmlDocument>、または <xref:System.Xml.XmlElement> にバインドして、`XPath` クエリを実行できます。  マークアップ内の[バインディング ソース](GTMT)である [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データに簡単にアクセスするには、<xref:System.Windows.Data.XmlDataProvider> オブジェクトを使用します。  詳細については、「[XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)」を参照してください。<br /><br /> <xref:System.Xml.Linq.XElement> または <xref:System.Xml.Linq.XDocument> にバインドしたり、LINQ to XML を使用してこれらの型のオブジェクトに対して実行したクエリの結果にバインドしたりすることもできます。  LINQ to XML を使用してマークアップ内のバインディング ソースである XML データに簡単にアクセスするには、<xref:System.Windows.Data.ObjectDataProvider> オブジェクトを使用します。  詳細については、「[XDocument、XElement、または LINQ for XML クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md)」を参照してください。|  
+|<xref:System.Windows.DependencyObject> オブジェクト|任意の <xref:System.Windows.DependencyObject> の[依存関係プロパティ](GTMT)にバインドできます。  例については、「[2 つのコントロールのプロパティをバインドする](../../../../docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md)」を参照してください。|  
+  
+<a name="classes"></a>   
+## バインディング ソースとしてクラスを実装する  
+ バインディング ソースは独自に作成できます。  ここでは、 クラスをバインディング ソースとして使用する目的で実装する場合に認識しておく必要のある事項について説明します。  
+  
+### 変更通知を提供する  
+ <xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> バインディング \(バインディング ソース プロパティが動的に変更される場合は [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を更新する必要があるため\) を使用している場合は、適切なプロパティ変更通知機構を実装する必要があります。  推奨される機構としては、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] クラスまたは動的クラスによる <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスの実装があります。  詳細については、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」を参照してください。  
+  
+ <xref:System.ComponentModel.INotifyPropertyChanged> を実装しない [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトを作成する場合は、バインディングで使用されるデータが常に最新の状態を保つように、独自の通知システムを用意する必要があります。  変更通知を提供するには、変更を通知する必要のある各プロパティの `PropertyChanged` パターンをサポートします。  このパターンをサポートするには、各プロパティに対して *PropertyName*Changed イベントを定義します。ここで、*PropertyName* はそのプロパティの名前です。  プロパティが変更されるたびに、このイベントが発生するようにします。  
+  
+ バインディング ソースがこれらのいずれかの通知機構を実装している場合、ターゲットは自動的に更新されます。  なんらかの理由でバインディング ソースが適切なプロパティ変更通知を提供しない場合は、<xref:System.Windows.Data.BindingExpression.UpdateTarget%2A> メソッドを使用してターゲット プロパティを明示的に更新できます。  
+  
+### その他の特性  
+ 注意する必要のあるその他の重要な点を、次の一覧に示します。  
+  
+-   オブジェクトを [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で作成する場合、クラスには既定のコンストラクターが必要です。  [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] などの一部の [!INCLUDE[TLA2#tla_net](../../../../includes/tla2sharptla-net-md.md)] 言語では、既定のコンストラクターがあらかじめ作成されている場合があります。  
+  
+-   バインディングのバインディング ソース プロパティとして使用するプロパティは、クラスのパブリック プロパティである必要があります。  明示的に定義されたインターフェイス プロパティには、基本実装を持たない保護プロパティ、プライベート プロパティ、内部プロパティ、および仮想プロパティの場合と同様に、バインディングのためにアクセスすることはできません。  
+  
+-   パブリック フィールドにバインドすることはできません。  
+  
+-   クラスで宣言したプロパティの型は、バインディングに渡される型です。  ただし、バインディングで最終的に使用される型は、バインディング ソース プロパティの型ではなく、[バインディング ターゲット](GTMT) プロパティの型に依存します。  型が異なっている場合は、カスタム プロパティがバインディングに最初に渡される方法を処理するためのコンバーターを作成することが考えられます。  詳細については、「<xref:System.Windows.Data.IValueConverter>」を参照してください。  
+  
+<a name="objects"></a>   
+## オブジェクト全体をバインディング ソースとして使用する  
+ オブジェクト全体をバインディング ソースとして使用できます。  <xref:System.Windows.Data.Binding.Source%2A> プロパティまたは <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを使用してバインディング ソースを指定し、次に、`{Binding}` のように、空白のバインディング宣言を指定できます。  この方法が役立つシナリオとしては、型文字列のオブジェクトへのバインディング、必要な複数のプロパティを持つオブジェクトへのバインディング、またはコレクション オブジェクトへのバインディングなどがあります。  コレクション オブジェクト全体へのバインディングの例については、「[階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)」を参照してください。  
+  
+ カスタム ロジックを適用して、バインドしたターゲット プロパティでデータが有効になるようにしなければならない場合があることに注意してください。  カスタム ロジックは、カスタム コンバーター \(既定の型変換が存在しない場合\) のフォーム、または <xref:System.Windows.DataTemplate> に含まれていなければなりません。  コンバーターの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」の「データ変換」セクションを参照してください。  データ テンプレートの詳細については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)」を参照してください。  
+  
+<a name="collections"></a>   
+## コレクション オブジェクトをバインディング ソースとして使用する  
+ 多くの場合、バインディング ソースとして使用する必要のあるオブジェクトは、複数のカスタム オブジェクトのコレクションです。  各オブジェクトは、反復されるバインディングの 1 つのインスタンスのソースとして使用されます。  たとえば、複数の `CustomerOrder` オブジェクトで構成される `CustomerOrders` コレクションがあり、アプリケーションはそのコレクションを反復処理して、存在する注文の数と、各注文に含まれるデータを判別する場合があります。  
+  
+ <xref:System.Collections.IEnumerable> インターフェイスを実装するすべてのコレクションを列挙できます。  ただし、コレクションへの挿入や削除によって [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が自動的に更新されるように動的バインディングを設定するには、コレクションで <xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを実装する必要があります。  このインターフェイスは、基になるコレクションが変更されるたびに発生する必要があるイベントを公開します。  
+  
+ <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスは、<xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを公開するデータ コレクションの組み込み実装です。  コレクション内の個々のデータ オブジェクトは、前のセクションで説明されている要件を満たす必要があります。  例については、「[ObservableCollection を作成およびバインドする](../../../../docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md)」を参照してください。  独自のコレクションを実装する前に、<xref:System.Collections.ObjectModel.ObservableCollection%601> または既存のコレクション クラスのいずれか \(特に <xref:System.Collections.Generic.List%601>、<xref:System.Collections.ObjectModel.Collection%601>、<xref:System.ComponentModel.BindingList%601> など\) の使用を検討します。  
+  
+ WPF がコレクションに直接バインドされることはありません。  コレクションをバインディング ソースとして指定した場合、WPF は実際にはそのコレクションの既定のビューにバインドされます。  既定のビューの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+ 高度なシナリオがあり、独自のコレクションを実装する場合は、<xref:System.Collections.IList> インターフェイスの使用を検討してください。  <xref:System.Collections.IList> により、インデックスによって個別にアクセスできるオブジェクトの非ジェネリック コレクションが利用可能になり、パフォーマンスが向上します。  
+  
+<a name="permissions"></a>   
+## データ バインディングに必要なアクセス許可  
+ データ バインディングを使用する場合、アプリケーションの信頼レベルを考慮する必要があります。  完全な信頼または部分信頼で実行されているアプリケーションにバインドできるプロパティの種類を次の表に要約します。  
+  
+|プロパティの型<br /><br /> \(すべてのアクセス修飾子\)|動的オブジェクト プロパティ|動的オブジェクト プロパティ|CLR プロパティ|CLR プロパティ|依存関係プロパティ|依存関係プロパティ|  
+|---------------------------------|--------------------|--------------------|---------------|---------------|---------------|---------------|  
+|**信頼レベル**|**完全信頼**|**部分信頼**|**完全信頼**|**部分信頼**|**完全信頼**|**部分信頼**|  
+|パブリック クラス|○|○|○|○|○|○|  
+|パブリック クラス以外|○|Ｘ|○|Ｘ|○|○|  
+  
+ 次の表は、データ バインディングで必要とされるアクセス許可についての重要事項の説明です。  
+  
+-   [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] プロパティの場合、データ バインディングは、バインディング エンジンがリフレクションを使用してバインディング ソース プロパティにアクセスできる限り、機能します。  それ以外の場合、バインディング エンジンは、プロパティを見つけることができないと警告を発し、可能であればフォールバック値または既定値を使用します。  
+  
+-   コンパイル時または実行時に定義される動的オブジェクトのプロパティにバインドできます。  
+  
+-   いつでも[依存関係プロパティ](GTMT)にバインドできます。  
+  
+ [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] バインディングで必要とされるアクセス許可も同様です。部分信頼サンドボックスでは、指定されたデータへのアクセス許可がない場合、<xref:System.Windows.Data.XmlDataProvider> は失敗します。  
+  
+ 匿名型のオブジェクトは内部オブジェクトです。  完全信頼で実行する場合のみ、匿名型のプロパティにバインドできます。  匿名型の詳細については、「[匿名型 \(C\# プログラミング ガイド\)](../Topic/Anonymous%20Types%20\(C%23%20Programming%20Guide\).md)」または「[匿名型 \(Visual Basic\)](../Topic/Anonymous%20Types%20\(Visual%20Basic\).md)」\(Visual Basic\) を参照してください。  
+  
+ 部分信頼セキュリティの詳細については、「[WPF 部分信頼セキュリティ](../../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Data.ObjectDataProvider>   
+ <xref:System.Windows.Data.XmlDataProvider>   
+ [バインディング ソースを指定する](../../../../docs/framework/wpf/data/how-to-specify-the-binding-source.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)   
+ [LINQ to XML による WPF のデータ バインドの概要](../Topic/WPF%20Data%20Binding%20with%20LINQ%20to%20XML%20Overview.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/data-binding-how-to-topics.md b/docs/framework/wpf/data/data-binding-how-to-topics.md
new file mode 100644
index 00000000000..65985d5fb78
--- /dev/null
+++ b/docs/framework/wpf/data/data-binding-how-to-topics.md
@@ -0,0 +1,76 @@
+---
+title: "データ バインドに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "バインド (データを), 方法トピック"
+  - "データ バインディング, 方法トピック"
+ms.assetid: a3b2563e-d879-41a7-9dfd-ac56b27fdcad
+caps.latest.revision: 81
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 81
+---
+# データ バインドに関する「方法」トピック
+このセクションの各トピックでは、データ バインディングを使用して、要素を共通言語ランタイム \(CLR\) オブジェクトや XML の形式のさまざまなデータ ソースからのデータにバインドする方法について説明します。  
+  
+## このセクションの内容  
+ [簡単なバインディングを作成する](../../../../docs/framework/wpf/data/how-to-create-a-simple-binding.md)  
+ [バインディング ソースを指定する](../../../../docs/framework/wpf/data/how-to-specify-the-binding-source.md)  
+ [XAML でデータをバインディング可能にする](../../../../docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md)  
+ [TextBox テキストでソースを更新するタイミングを制御する](../../../../docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md)  
+ [バインディングの方向を指定する](../../../../docs/framework/wpf/data/how-to-specify-the-direction-of-the-binding.md)  
+ [コレクションにバインドして選択に基づく情報を表示する](../../../../docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md)  
+ [列挙値にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-an-enumeration.md)  
+ [2 つのコントロールのプロパティをバインドする](../../../../docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md)  
+ [バインディングの検証の実装](../../../../docs/framework/wpf/data/how-to-implement-binding-validation.md)  
+ [カスタム オブジェクトに検証ロジックを実装する](../../../../docs/framework/wpf/data/how-to-implement-validation-logic-on-custom-objects.md)  
+ [バインドされているターゲット プロパティからのバインディング オブジェクトの取得](../../../../docs/framework/wpf/data/how-to-get-the-binding-object-from-a-bound-target-property.md)  
+ [CompositeCollection を実装する](../../../../docs/framework/wpf/data/how-to-implement-a-compositecollection.md)  
+ [バインドされたデータを変換する](../../../../docs/framework/wpf/data/how-to-convert-bound-data.md)  
+ [コードでバインディングを作成する](../../../../docs/framework/wpf/data/how-to-create-a-binding-in-code.md)  
+ [データ コレクションの既定のビューを取得する](../../../../docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md)  
+ [データ CollectionView のオブジェクト間を移動する](../../../../docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md)  
+ [ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)  
+ [ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)  
+ [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)  
+ [階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)  
+ [階層 XML データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md)  
+ [バインドされた項目の一覧に基づいて値を生成する](../../../../docs/framework/wpf/data/how-to-produce-a-value-based-on-a-list-of-bound-items.md)  
+ [プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)  
+ [ObservableCollection を作成およびバインドする](../../../../docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md)  
+ [PriorityBinding を実装する](../../../../docs/framework/wpf/data/how-to-implement-prioritybinding.md)  
+ [XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)  
+ [XDocument、XElement、または LINQ for XML クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md)  
+ [データ バインドで XML 名前空間を使用する](../../../../docs/framework/wpf/data/how-to-use-xml-namespaces-in-data-binding.md)  
+ [ADO.NET データ ソースにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-an-ado-net-data-source.md)  
+ [メソッドにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-a-method.md)  
+ [バインディングの更新の通知を設定する](../../../../docs/framework/wpf/data/how-to-set-up-notification-of-binding-updates.md)  
+ [バインディングをクリアする](../../../../docs/framework/wpf/data/how-to-clear-bindings.md)  
+ [DataTemplate によって生成された要素を検索する](../../../../docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md)  
+ [Web サービスにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-a-web-service.md)  
+ [LINQ クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-the-results-of-a-linq-query.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Data>  
+  
+ <xref:System.Windows.Data.Binding>  
+  
+ <xref:System.Windows.DataTemplate>  
+  
+ <xref:System.Windows.Controls.DataTemplateSelector>  
+  
+## 関連項目  
+ [データ バインディング](../../../../docs/framework/wpf/data/data-binding-wpf.md)  
+  
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/data-binding-overview.md b/docs/framework/wpf/data/data-binding-overview.md
new file mode 100644
index 00000000000..32f081cb62f
--- /dev/null
+++ b/docs/framework/wpf/data/data-binding-overview.md
@@ -0,0 +1,458 @@
+---
+title: "データ バインドの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 概要 (データ バインディングの)"
+  - "変換 (データ バインディングのための)"
+  - "データ バインディング, 概要 (データ バインディングの)"
+  - "データ変換 (バインディングのための)"
+ms.assetid: c707c95f-7811-401d-956e-2fffd019a211
+caps.latest.revision: 78
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# データ バインドの概要
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] データ バインディングは、アプリケーションがデータを提示し、データと対話するための簡単で一貫性のある方法を提供します。  要素は、[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトや [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] の形式のさまざまなデータ ソースのデータにバインドできます。  <xref:System.Windows.Controls.Button> などの <xref:System.Windows.Controls.ContentControl> と、<xref:System.Windows.Controls.ListBox> や <xref:System.Windows.Controls.ListView> などの <xref:System.Windows.Controls.ItemsControl> には、単一のデータ項目やデータ項目のコレクションのスタイルを柔軟に設定できるようにするための機能が組み込まれています。  データの最上位に並べ替え、フィルター、およびグループ ビューを生成できます。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のデータ バインディング機能には、従来のモデルに比べていくつかの利点があります。たとえば、データ バインディングをネイティブにサポートするさまざまなプロパティ、データの柔軟な [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 表現、ビジネス ロジックと [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の明確な分離などです。  
+  
+ このトピックでは、最初に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] データ バインディングの基本的な概念について説明し、次に <xref:System.Windows.Data.Binding> クラスの使用方法とデータ バインディングのその他の機能について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="what_is_data_binding"></a>   
+## データ バインディングとは  
+ データ バインディングとは、アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] とビジネス ロジックを関連付けるプロセスです。  バインディングが適切に設定されており、データが適切な通知を提供する場合、データの値が変更されると、データにバインドされている要素にその変更が自動的に反映されます。  また、データ バインディングは、要素内のデータの外部表現が変更された場合、基になるデータが自動的に更新されてその変更が反映されるということも意味します。  たとえば、ユーザーが <xref:System.Windows.Controls.TextBox> 要素の値を編集した場合、基になるデータの値が自動的に更新されてその変更が反映されます。  
+  
+ データ バインディングの代表的な用途としては、サーバーまたはローカルの構成データをフォームなどの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] コントロールに配置することです。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、この概念が、さまざまなプロパティとさまざまなデータ ソースのバインディングにまで拡張されています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、要素の[依存関係プロパティ](GTMT)を、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト \([!INCLUDE[TLA#tla_adonet](../../../../includes/tlasharptla-adonet-md.md)] オブジェクトや、Web サービスおよび Web プロパティに関連するオブジェクトなど\) や [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにバインドできます。  
+  
+ データ バインディングの例としては、次のアプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を[データ バインディングのデモ](http://go.microsoft.com/fwlink/?LinkID=163703)からダウンロードして参照してください。  
+  
+ ![データ バインディングのサンプルのスクリーンショット](../../../../docs/framework/wpf/data/media/databinding-databindingdemo.png "DataBinding\_DataBindingDemo")  
+  
+ 上の図は、オークション品目の一覧を表示するアプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] です。  このアプリケーションでは、次のデータ バインディングの機能を示します。  
+  
+-   <xref:System.Windows.Controls.ListBox> のコンテンツは、*AuctionItem* オブジェクトのコレクションにバインドされています。  *AuctionItem* オブジェクトには、*Description*、*StartPrice*、*StartDate*、*Category*、*SpecialFeatures* などのプロパティがあります。  
+  
+-   <xref:System.Windows.Controls.ListBox> に表示されるデータ \(*AuctionItem* オブジェクト\) は、各品目の説明と現在の価格が表示されるようにテンプレート化されています。  このテンプレート化には <xref:System.Windows.DataTemplate> を使用しています。  また、各品目の外観は、表示されている *AuctionItem* の *SpecialFeatures* 値に依存します。  *AuctionItem* の *SpecialFeatures* 値が *Color* の場合は、品目の境界線が青色になります。  値が *Highlight* の場合は、品目の境界線がオレンジ色になり、項目に星が表示されます。  データ テンプレートに関する情報については、「[データ テンプレート](#data_templating)」セクションで説明します。  
+  
+-   ユーザーは、画面上にある <xref:System.Windows.Controls.CheckBox> を使用して、データのグループ化、フィルター処理、または並べ替えを行うことができます。  上のイメージでは、\[Group by category\] と \[Sort by category and date\] の <xref:System.Windows.Controls.CheckBox> がオンになっています。  商品のカテゴリを基にデータがグループ化されており、カテゴリ名がアルファベット順になっています。  このイメージからはわかりづらいですが、各カテゴリ内の品目は開始日で並べ替えられています。  この並べ替えにはコレクション ビューを使用しています。  コレクション ビューについては、「[コレクションへのバインディング](#binding_to_collections)」セクションで説明します。  
+  
+-   ユーザーが品目を選択すると、その品目の詳細が <xref:System.Windows.Controls.ContentControl> に表示されます。  これはマスター詳細シナリオと呼ばれます。  この種のバインディング シナリオに関する情報については、「[マスター詳細シナリオ](#master_detail_scenario)」セクションで説明します。  
+  
+-   *StartDate* プロパティの型は <xref:System.DateTime> です。この型は、ミリ秒までの時刻を含む日付を返します。  このアプリケーションでは、カスタム コンバーターが使用されているため、短い形式の日付文字列が表示されます。  これらのコンバーターに関する情報については、「[データ変換](#data_conversion)」セクションで説明します。  
+  
+ ユーザーが \[Add Product\] ボタンをクリックすると、次のフォームが表示されます。  
+  
+ ![&#91;Add Product Listing&#93; ページ](../../../../docs/framework/wpf/data/media/databinding-demo-addproductlisting.png "DataBinding\_Demo\_AddProductListing")  
+  
+ ユーザーは、フォーム内のフィールドを編集し、簡単なプレビュー ペインと詳細なプレビュー ペインで商品一覧をプレビューしてから、\[submit\] をクリックして新しい商品一覧を追加することができます。  既存のグループ化、フィルター処理、および並べ替えの機能が新しいエントリに適用されます。  この場合、上のイメージに入力した品目は、Computer カテゴリ内の 2 番目の品目として表示されます。  
+  
+ このイメージでは、*Start Date* <xref:System.Windows.Controls.TextBox> で指定されている検証ロジックが示されていません。  ユーザーが無効な日付 \(無効な形式または過去の日付\) を入力した場合は、日付が無効であることが、<xref:System.Windows.Controls.ToolTip> と <xref:System.Windows.Controls.TextBox> の横の赤い感嘆符でユーザーに通知されます。  検証ロジックの作成方法については、「[データの検証](#data_validation)」セクションで説明します。  
+  
+ 上であらましを述べたさまざまなデータ バインディング機能について説明する前に、次のセクションでは、まず [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] データ バインディングを理解するのに不可欠な基本的概念について説明します。  
+  
+<a name="basic_data_binding_concepts"></a>   
+## 基本的なデータ バインディングの概念  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+ バインドする要素の種類やデータ ソースの性質に関係なく、各バインディングは常に、次の図に示されているモデルに従って行われます。  
+  
+ ![基本的なデータ バインディング ダイアグラム](../../../../docs/framework/wpf/data/media/databindingmostbasic.png "DataBindingMostBasic")  
+  
+ 上の図に示されているように、データ バインディングは、基本的に[バインディング ターゲット](GTMT)と[バインディング ソース](GTMT)間のブリッジです。  この図は、次の基本的な [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] データ バインディングの概念を示しています。  
+  
+-   通常、各バインディングには、[バインディング ターゲット](GTMT) オブジェクト、ターゲット プロパティ、[バインディング ソース](GTMT)、および使用する[バインディング ソース](GTMT)内の値へのパスの 4 つのコンポーネントがあります。  たとえば、<xref:System.Windows.Controls.TextBox> の内容を *Employee* オブジェクトの *Name* プロパティにバインドする場合、対象オブジェクトは <xref:System.Windows.Controls.TextBox>、対象プロパティは <xref:System.Windows.Controls.TextBox.Text%2A> プロパティ、使用する値は *Name*、ソース オブジェクトは *Employee* オブジェクトになります。  
+  
+-   ターゲット プロパティには、[依存関係プロパティ](GTMT)を指定する必要があります。  <xref:System.Windows.UIElement> のほとんどのプロパティは[依存関係プロパティ](GTMT)であり、読み取り専用のものを除くほとんどの[依存関係プロパティ](GTMT)は、既定でデータ バインディングをサポートします   \(<xref:System.Windows.DependencyObject> 型だけが[依存関係プロパティ](GTMT)、および <xref:System.Windows.DependencyObject> から派生したすべての <xref:System.Windows.UIElement> を定義できます\)。  
+  
+-   図には示されていませんが、[バインディング ソース](GTMT) オブジェクトはカスタムの [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトであってもかまいません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のデータ バインディングでは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクトおよび [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] の形式のデータをサポートします。  いくつか例を挙げると、バインディング ソースは <xref:System.Windows.UIElement>、任意のリスト オブジェクト、[!INCLUDE[TLA#tla_adonet](../../../../includes/tlasharptla-adonet-md.md)] データまたは Web サービスに関連付けられた [!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)] オブジェクト、または [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データを含む XmlNode のいずれでもかまいません。  詳細については、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」を参照してください。  
+  
+ バインディングを確立する場合、[バインディング ターゲット](GTMT)を[バインディング ソース](GTMT)にバインドします。[!INCLUDE[TLA#tla_sdk](../../../../includes/tlasharptla-sdk-md.md)] の他のトピックに目を通す際には、この点を覚えておくことが重要です。  たとえば、データ バインディングを使用して基になる [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データを <xref:System.Windows.Controls.ListBox> に表示する場合は、<xref:System.Windows.Controls.ListBox> を [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにバインドします。  
+  
+ バインディングを確立するには、<xref:System.Windows.Data.Binding> オブジェクトを使用します。  以降では、<xref:System.Windows.Data.Binding> オブジェクトに関連するさまざまな概念と、このオブジェクトのいくつかのプロパティおよび使用方法について説明します。  
+  
+<a name="direction_of_data_flow"></a>   
+### データ フローの方向  
+ 既に説明し、上の図の矢印でも示したように、バインディングのデータ フローには、[バインディング ターゲット](GTMT)から[バインディング ソース](GTMT)へのフロー \(ユーザーが <xref:System.Windows.Controls.TextBox> の値を編集したときのソース値の変更など\) と、バインディング ソースが適切な通知を提供する場合の[バインディング ソース](GTMT)から[バインディング ターゲット](GTMT)へのフロー \([バインディング ソース](GTMT)の変更による <xref:System.Windows.Controls.TextBox> の更新など\) があります。  
+  
+ アプリケーションでユーザーによるデータの変更を可能にし、その変更をソース オブジェクトに反映できるようにする必要が生じる場合があります。  あるいは、ユーザーがソース データを更新できないようにする必要が生じることもあります。  <xref:System.Windows.Data.Binding> オブジェクトの <xref:System.Windows.Data.Binding.Mode%2A> プロパティを設定することで、こうした動作を制御することができます。  次の図は、さまざまな種類のデータ フローを示しています。  
+  
+ ![データ バインディング データ フロー](../../../../docs/framework/wpf/data/media/databinding-dataflow.png "DataBinding\_DataFlow")  
+  
+-   <xref:System.Windows.Data.BindingMode> バインディングでは、ソース プロパティが変更されると、ターゲット プロパティも自動的に更新されます。ただし、ターゲット プロパティの変更はソース プロパティに反映されません。  この型のバインディングは、バインドされているコントロールが暗黙的な読み取り専用の場合に適しています。  たとえば、株価情報などのソースにバインドする場合です。また、ターゲット プロパティには、データ バインドされたテーブルの背景色などの変更用コントロール インターフェイスがない可能性もあります。  ターゲット プロパティの変更を監視する必要がない場合は、<xref:System.Windows.Data.BindingMode> バインディング モードを使うことにより、<xref:System.Windows.Data.BindingMode> バインディング モードのオーバーヘッドを回避できます。  
+  
+-   <xref:System.Windows.Data.BindingMode> バインディングでは、ソース プロパティまたはターゲット プロパティのどちらか一方が変更されると、もう一方も自動的に更新されます。  この型のバインディングは、編集可能なフォームや完全対話型の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] シナリオに適しています。  ほとんどのプロパティは既定で <xref:System.Windows.Data.BindingMode> バインディングになります。ただし、一部の[依存関係プロパティ](GTMT) \(一般的に、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.Controls.TextBox.Text%2A> プロパティや <xref:System.Windows.Controls.CheckBox> の <xref:System.Windows.Controls.Primitives.ToggleButton.IsChecked%2A> プロパティなど、ユーザーが編集できるコントロールのプロパティ\) は既定で <xref:System.Windows.Data.BindingMode> バインディングになります。  [依存関係プロパティ](GTMT)が既定で一方向または双方向のいずれであるかをプログラムにより判断する 1 つの方法は、<xref:System.Windows.DependencyProperty.GetMetadata%2A> を使用してプロパティのプロパティ メタデータを取得してから、<xref:System.Windows.FrameworkPropertyMetadata.BindsTwoWayByDefault%2A> プロパティのブール値を確認することです。  
+  
+-   <xref:System.Windows.Data.BindingMode> は <xref:System.Windows.Data.BindingMode> バインディングの逆方向のバインディングです。このバインディングでは、ターゲット プロパティが変更されると、ソース プロパティが更新されます。  シナリオの例の 1 つには、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] からのソース値のみを再評価する必要がある場合があります。  
+  
+-   図に示されていない <xref:System.Windows.Data.BindingMode> バインディングでは、ソース プロパティによってターゲット プロパティが初期化されます。ただし、それ以降の変更は反映されません。  これは、データ コンテキストまたはデータ コンテキスト内のオブジェクトが変更された場合、その変更はターゲット プロパティに反映されないということを意味します。  この型のバインディングは、現在の状態のスナップショットを使用した方がよい場合や、データが完全に静的である場合に適しています。  また、ソース プロパティの値を使用してターゲット プロパティを初期化するときにデータ コンテキストが事前にわからない場合にも、この型のバインディングは便利です。  基本的に、この型のバインディングは、ソース値が変わらない場合にパフォーマンスを向上させる <xref:System.Windows.Data.BindingMode> バインディングを簡易化したものです。  
+  
+ ソースの変更を検出するには \(<xref:System.Windows.Data.BindingMode> および <xref:System.Windows.Data.BindingMode> バインディングが該当\)、ソースで <xref:System.ComponentModel.INotifyPropertyChanged> などの適切なプロパティの変更通知機構を実装する必要があります。  <xref:System.ComponentModel.INotifyPropertyChanged> の実装の例については、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」を参照してください。  
+  
+ バインディング モードの詳細とバインディングの方向を指定する方法の例については、<xref:System.Windows.Data.Binding.Mode%2A> プロパティのページを参照してください。  
+  
+<a name="what_triggers_source_updates"></a>   
+### ソースの更新の要因  
+ <xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> のバインディングでは、対象プロパティ内の変更をリッスンして、ソースに反映させます。  これを、ソースの更新と呼びます。  たとえば、TextBox のテキストを編集して、基になるソース値を変更できます。  前のセクションで説明したように、データ フローの方向は、バインディングの <xref:System.Windows.Data.Binding.Mode%2A> プロパティの値によって決定されます。  
+  
+ では、ソース値はテキストの編集中に更新されるのでしょうか。それとも、テキストの編集を終了し、マウスのポインターを TextBox から離した後に更新されるのでしょうか。  ソースの更新の要因は、バインディングの <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティによって決定されます。  次の図の点線の右矢印は、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティの役割を示しています。  
+  
+ ![UpdateSourceTrigger ダイアグラム](../../../../docs/framework/wpf/data/media/databindingupdatesourcetrigger.png "DataBindingUpdateSourceTrigger")  
+  
+ <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値が <xref:System.Windows.Data.UpdateSourceTrigger> の場合、<xref:System.Windows.Data.BindingMode> バインディングまたは <xref:System.Windows.Data.BindingMode> バインディングの右矢印が指す値は、ターゲット プロパティが変更された直後に更新されます。  一方、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値が <xref:System.Windows.Data.UpdateSourceTrigger> の場合、この値が新しい値に更新されるのは、ターゲット プロパティがフォーカスを失ったときだけです。  
+  
+ <xref:System.Windows.Data.Binding.Mode%2A> プロパティと同様に、[依存関係プロパティ](GTMT)の既定の <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値は、依存関係プロパティごとに異なります。  ほとんどの[依存関係プロパティ](GTMT)の既定値は <xref:System.Windows.Data.UpdateSourceTrigger> であるのに対し、<xref:System.Windows.Controls.TextBox.Text%2A> プロパティの既定値は <xref:System.Windows.Data.UpdateSourceTrigger> です。  つまり、通常はターゲット プロパティの変更時にソースが更新されます。こうした動作は、<xref:System.Windows.Controls.CheckBox> などの単純なコントロールに適しています。  ただし、テキスト フィールドの場合、各キーストロークの後に更新を行うと、パフォーマンスが低下する可能性があり、ユーザーは新しい値をコミットする前に BackSpace キーを使用して入力エラーを修正するという通常の操作ができなくなります。  <xref:System.Windows.Controls.TextBox.Text%2A> プロパティの既定値が、<xref:System.Windows.Data.UpdateSourceTrigger> ではなく <xref:System.Windows.Data.UpdateSourceTrigger> に設定されているのはこのためです。  
+  
+ [依存関係プロパティ](GTMT)の既定の <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値を確認する方法については、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティのページを参照してください。  
+  
+ 次の表は、各 <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値のシナリオ例を示しています。これらのシナリオでは、<xref:System.Windows.Controls.TextBox> を例として使用しています。  
+  
+|UpdateSourceTrigger 値|ソース値が更新されるタイミング|TextBox のシナリオ例|  
+|---------------------------|---------------------|--------------------|  
+|LostFocus \(<xref:System.Windows.Controls.TextBox.Text%2A?displayProperty=fullName> の既定値\)|TextBox コントロールがフォーカスを失ったとき|検証ロジックに関連付けられている <xref:System.Windows.Controls.TextBox> \(「データの検証」セクションを参照\)|  
+|PropertyChanged|<xref:System.Windows.Controls.TextBox> に入力したとき|チャット ルーム ウィンドウの <xref:System.Windows.Controls.TextBox> コントロール|  
+|Explicit|アプリケーションが <xref:System.Windows.Data.BindingExpression.UpdateSource%2A> を呼び出したとき|編集可能なフォームの <xref:System.Windows.Controls.TextBox> コントロール \(ユーザーが送信ボタンをクリックした場合のみソース値を更新する\)|  
+  
+ 例については、「[TextBox テキストでソースを更新するタイミングを制御する](../../../../docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md)」を参照してください。  
+  
+<a name="creating_a_binding"></a>   
+## バインディングの作成  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+ 前のセクションで説明したいくつかの概念を要約するために、<xref:System.Windows.Data.Binding> を使用してバインディングを設定します。通常、各バインディングには、バインディング ターゲット、ターゲット プロパティ、バインディング ソース、および使用するソース値へのパスの 4 つのコンポーネントがあります。  このセクションでは、バインディングの設定方法について説明します。  
+  
+ 次に例を示します。この例では、*SDKSample* 名前空間内で定義されている *MyData* という名前のクラスをバインディング ソース オブジェクトに設定しています。  デモの目的で、*MyData* クラスは *ColorName* という名前の文字列プロパティを持っており、プロパティの値は "Red" に設定されています。  したがって、この例では赤い背景のボタンが作成されます。  
+  
+ [!code-xml[BindNonTextProperty#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindNonTextProperty/CS/Page1.xaml#1)]  
+  
+ バインディング宣言構文の詳細とコードでバインディングを設定する方法の例については、「[バインディング宣言の概要](../../../../docs/framework/wpf/data/binding-declarations-overview.md)」を参照してください。  
+  
+ 上の基本的な図にこの例を適用すると、次のような図が得られます。  Background プロパティは既定で <xref:System.Windows.Data.BindingMode> バインディングをサポートするため、これは <xref:System.Windows.Data.BindingMode> バインディングになります。  
+  
+ ![データ バインディング ダイアグラム](../../../../docs/framework/wpf/data/media/databindingbuttonbackgroundexample.png "DataBindingButtonBackgroundExample")  
+  
+ *ColorName* プロパティは文字列型で <xref:System.Windows.Controls.Control.Background%2A> プロパティは <xref:System.Windows.Media.Brush> 型であるにもかかわらず、このバインディングが正常に機能することに疑問を持たれるかもしれません。  これは既定の型変換が実行されるためです。型変換については「[データ変換](#data_conversion)」セクションで説明します。  
+  
+<a name="specifying_the_binding_source"></a>   
+### バインディング ソースの指定  
+ 前の例では、<xref:System.Windows.Controls.DockPanel> 要素の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを設定することで、バインディング ソースを指定しています。  次に、<xref:System.Windows.Controls.Button> は、その親要素である <xref:System.Windows.Controls.DockPanel> から <xref:System.Windows.FrameworkElement.DataContext%2A> 値を継承します。  繰り返しますが、バインディング ソース オブジェクトは、バインディングの 4 つの必須コンポーネントの 1 つです。  したがって、バインディング ソース オブジェクトが指定されていない場合、バインディングは機能しません。  
+  
+ バインディング ソース オブジェクトを指定する方法はいくつかあります。  親要素の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを使用する方法は、複数のプロパティを同じソースにバインドする場合に役立ちます。  ただし、個々のバインディング宣言でバインディング ソースを指定する方が適している場合もあります。  前の例の場合は、<xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを使用する代わりに、ボタンのバインディング宣言で直接 <xref:System.Windows.Data.Binding.Source%2A> プロパティを設定することでバインディング ソースを指定できます。次に例を示します。  
+  
+ [!code-xml[BindNonTextProperty#BackgroundBindingCompact](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindNonTextProperty/CS/Page2.xaml#backgroundbindingcompact)]  
+  
+ <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを要素に直接設定したり、<xref:System.Windows.FrameworkElement.DataContext%2A> 値を先祖から継承したり \(最初の例のボタンなど\)、<xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.Binding.Source%2A> プロパティの設定でバインディング ソースを明示的に指定する方法以外に、<xref:System.Windows.Data.Binding.ElementName%2A> プロパティまたは <xref:System.Windows.Data.Binding.RelativeSource%2A> プロパティを使用してバインディング ソースを指定する方法もあります。  <xref:System.Windows.Data.Binding.ElementName%2A> プロパティは、アプリケーション内の他の要素にバインドする場合 \(スライダーを使用してボタンの幅を調整する場合など\) に役立ちます。  <xref:System.Windows.Data.Binding.RelativeSource%2A> プロパティは、<xref:System.Windows.Controls.ControlTemplate> または <xref:System.Windows.Style> でバインディングを指定する場合に役立ちます。  詳細については、「[バインディング ソースを指定する](../../../../docs/framework/wpf/data/how-to-specify-the-binding-source.md)」を参照してください。  
+  
+<a name="specifying_the_path_to_the_value"></a>   
+### 値へのパスの指定  
+ バインディング ソースがオブジェクトである場合は、<xref:System.Windows.Data.Binding.Path%2A> プロパティを使用して、バインディングで使用する値を指定します。  [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにバインドする場合は、<xref:System.Windows.Data.Binding.XPath%2A> プロパティを使用して値を指定します。  場合によっては、データが [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] であっても <xref:System.Windows.Data.Binding.Path%2A> プロパティを使用できます。  たとえば、\(XPath クエリの結果として\) 返された XmlNode の Name プロパティにアクセスする場合は、<xref:System.Windows.Data.Binding.XPath%2A> プロパティに加えて <xref:System.Windows.Data.Binding.Path%2A> プロパティを使用する必要があります。  
+  
+ 構文の詳細および例については、<xref:System.Windows.Data.Binding.Path%2A> プロパティと <xref:System.Windows.Data.Binding.XPath%2A> プロパティのページを参照してください。  
+  
+ 使用する値への <xref:System.Windows.Data.Binding.Path%2A> はバインディングの 4 つの必須コンポーネントの 1 つであると強調しましたが、オブジェクト全体にバインドするシナリオでは、使用する値は[バインディング ソース](GTMT) オブジェクトと同一になります。  このような場合には、<xref:System.Windows.Data.Binding.Path%2A> を指定する必要はありません。  次に例を示します。  
+  
+ [!code-xml[MasterDetail#EmptyBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MasterDetail/CSharp/Page1.xaml#emptybinding)]  
+  
+ 上の例では、空のバインディング構文 \({Binding}\) を使用しています。  この場合、<xref:System.Windows.Controls.ListBox> は、親の DockPanel 要素から DataContext を継承します \(この例には示されていません\)。  パスを指定しない場合、既定でオブジェクト全体にバインドされます。  つまり、この例では、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティをオブジェクト全体にバインドしているため、パスが省略されたことになります   \(詳細については、「[コレクションへのバインド](#binding_to_collections)」セクションを参照してください\)。  
+  
+ このシナリオは、コレクションにバインドする場合だけでなく、オブジェクトの単一のプロパティの代わりにオブジェクト全体にバインドする場合にも役立ちます。  たとえば、ソース オブジェクトが文字列型で、その文字列自体にバインドする場合などです。  もう 1 つの一般的なシナリオは、複数のプロパティを持つオブジェクトに要素をバインドする場合です。  
+  
+ カスタム ロジックを適用して、バインドしたターゲット プロパティでデータが有効になるようにしなければならない場合があることに注意してください。  カスタム ロジックは、カスタム コンバーターの形式になることがあります \(既定の型変換が存在しない場合\)。  コンバーターの詳細については、「[データ変換](#data_conversion)」を参照してください。  
+  
+<a name="binding_bindingexpression"></a>   
+### Binding と BindingExpression  
+ データ バインディングのその他の機能と使用方法について説明する前に、<xref:System.Windows.Data.BindingExpression> クラスについて説明した方がよいでしょう。  前のセクションで説明したように、<xref:System.Windows.Data.Binding> クラスは、バインディング宣言で使用する高レベルのクラスです。<xref:System.Windows.Data.Binding> クラスは、バインディングの特性を指定するためのさまざまなプロパティを提供します。  関連クラスである <xref:System.Windows.Data.BindingExpression> クラスは、ソースとターゲットとの関連付けを維持する、基になるオブジェクトです。  バインディングには、複数のバインディング式で共有可能な情報がすべて含まれています。  <xref:System.Windows.Data.BindingExpression> は、共有できないインスタンス式であり、<xref:System.Windows.Data.Binding> に関するインスタンス情報がすべて含まれています。  
+  
+ 次に例を示します。*myDataObject* は *MyData* クラスのインスタンス、*myBinding* は <xref:System.Windows.Data.Binding> ソース オブジェクト、*MyData* クラスは *MyDataProperty* という名前の文字列プロパティを含む定義済みクラスです。  この例では、<xref:System.Windows.Controls.TextBlock> のインスタンスである *mytext* のテキスト コンテンツを、*MyDataProperty* にバインドします。  
+  
+ [!code-csharp[CodeOnlyBinding#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CodeOnlyBinding/CSharp/binding.cs#1)]
+ [!code-vb[CodeOnlyBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CodeOnlyBinding/VisualBasic/App.vb#1)]  
+  
+ 同じ *myBinding* オブジェクトを使用して、他のバインディングを作成できます。  たとえば、*myBinding* オブジェクトを使用して、チェック ボックスのテキスト コンテンツを *MyDataProperty* にバインドできます。  このシナリオには、*myBinding* オブジェクトを共有する <xref:System.Windows.Data.BindingExpression> のインスタンスが 2 つあります。  
+  
+ <xref:System.Windows.Data.BindingExpression> オブジェクトは、データ バインドされたオブジェクト上の <xref:System.Windows.Data.BindingOperations.GetBindingExpression%2A> を呼び出した結果の戻り値を使用して取得できます。  以下のトピックでは、<xref:System.Windows.Data.BindingExpression> クラスの使用方法の一部を示します。  
+  
+-   [バインドされているターゲット プロパティからのバインディング オブジェクトの取得](../../../../docs/framework/wpf/data/how-to-get-the-binding-object-from-a-bound-target-property.md)  
+  
+-   [TextBox テキストでソースを更新するタイミングを制御する](../../../../docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md)  
+  
+<a name="data_conversion"></a>   
+## データ変換  
+ 前の例では、ボタンの <xref:System.Windows.Controls.Control.Background%2A> プロパティが "Red" という値を持つ文字列プロパティにバインドされているため、ボタンの色が赤になります。  これが機能するのは、文字列値を <xref:System.Windows.Media.Brush> に変換する型コンバーターが <xref:System.Windows.Media.Brush> 型に存在するためです。  
+  
+ この情報を「[バインディングの作成](#creating_a_binding)」セクションの図に追加すると、次のような図が得られます。  
+  
+ ![データ バインディング ダイアグラム](../../../../docs/framework/wpf/data/media/databindingbuttondefaultconversion.png "DataBindingButtonDefaultConversion")  
+  
+ では、文字列型のプロパティの代わりに、<xref:System.Windows.Media.Color> 型の *Color* プロパティがバインディング ソース オブジェクトにある場合はどうなるのでしょうか。  この場合、バインディングを機能させるには、最初に *Color* プロパティの値を、<xref:System.Windows.Controls.Control.Background%2A> で受け入れられる値に変換する必要があります。  次の例に示すように、<xref:System.Windows.Data.IValueConverter> インターフェイスを実装して、カスタム コンバーターを作成する必要があります。  
+  
+ [!code-csharp[ColorPicker_snip#16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ColorPicker_snip/CSharp/ColorPickerLib/ColorPicker.cs#16)]
+ [!code-vb[ColorPicker_snip#16](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ColorPicker_snip/visualbasic/colorpickerlib/colorpicker.vb#16)]  
+  
+ 詳細については、<xref:System.Windows.Data.IValueConverter> のリファレンス ページを参照してください。  
+  
+ ここでは、既定の変換の代わりにカスタム コンバーターを使用します。したがって、上の図は次のようになります。  
+  
+ ![データ バインディング ダイアグラム](../../../../docs/framework/wpf/data/media/databindingconvertercolorexample.png "DataBindingConverterColorExample")  
+  
+ 繰り返しますが、バインディング ターゲットの型に型コンバーターが存在していれば、既定の変換を使用できる場合があります。  この動作は、ターゲットで使用できる型コンバーターによって異なります。  不確かな場合は、独自のコンバーターを作成してください。  
+  
+ 型コンバーターを実装することが理にかなっている代表的なシナリオとして、以下が挙げられます。  
+  
+-   カルチャに応じてデータを異なる形式で表示する必要がある場合。  たとえば、特定のカルチャで使用される値や標準を基に、通貨コンバーターやカレンダーの日付\/時刻コンバーターを実装できます。  
+  
+-   使用中のデータが必ずしもプロパティのテキスト値を変更するためのものではなく、イメージのソースや表示テキストの色またはスタイルなど、その他の値を変更するためのものである場合。  この場合は、コンバーターを使用して、不適切と思われるプロパティのバインディング \(テキスト フィールドとテーブル セルの Background プロパティのバインディングなど\) を変換できます。  
+  
+-   複数のコントロールまたはコントロールの複数のプロパティを同じデータにバインドする場合。  この場合、同じバインディングをソース情報として使用したまま、プライマリ バインディングでテキストを表示し、その他のバインディングで表示に関する特定の問題を処理することができます。  
+  
+-   ターゲット プロパティにバインディングのコレクションが含まれる <xref:System.Windows.Data.MultiBinding> \(これについてはまだ説明していません\) を使用する場合。  <xref:System.Windows.Data.MultiBinding> の場合は、カスタム <xref:System.Windows.Data.IMultiValueConverter> を使用して、バインディングの値から最終的な値を生成します。  たとえば、同じまたは異なるバインディング ソース オブジェクトの値である赤、青、緑の値から色の値を計算できます。  例および詳細については、<xref:System.Windows.Data.MultiBinding> クラスのページを参照してください。  
+  
+<a name="binding_to_collections"></a>   
+## コレクションへのバインド  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+ バインディング ソース オブジェクトは、プロパティにデータが含まれる単一のオブジェクト、または \(データベースへのクエリの結果など\) 通常はグループ化されるポリモーフィック オブジェクトのデータ コレクションのいずれかとして処理することができます。  これまでは単一オブジェクトへのバインディングについてのみ説明してきましたが、データ コレクションへのバインディングも一般的なシナリオです。  たとえば、一般的なシナリオでは、「[データ バインディングとは](#what_is_data_binding)」セクションで示したアプリケーションのように、<xref:System.Windows.Controls.ListBox>、<xref:System.Windows.Controls.ListView>、<xref:System.Windows.Controls.TreeView> などの <xref:System.Windows.Controls.ItemsControl> を使用してデータ コレクションを表示します。  
+  
+ 幸いなことに、上の基本的な図を引き続き適用できます。  <xref:System.Windows.Controls.ItemsControl> をコレクションにバインドしている場合、この図は次のようになります。  
+  
+ ![データ バインディング ItemsControl ダイアグラム](../../../../docs/framework/wpf/data/media/databindingitemscontrol.png "DataBindingItemsControl")  
+  
+ この図に示されているように、コレクション オブジェクトに <xref:System.Windows.Controls.ItemsControl> をバインドする場合、使用するプロパティは <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティです。  <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティは、<xref:System.Windows.Controls.ItemsControl> のコンテンツと考えることができます。  <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティは、既定では、<xref:System.Windows.Data.BindingMode> バインディングをサポートします。したがって、バインディングは <xref:System.Windows.Data.BindingMode> になることに注意してください。  
+  
+<a name="how_to_implement_collections"></a>   
+### コレクションを実装する方法  
+ <xref:System.Collections.IEnumerable> インターフェイスを実装するすべてのコレクションを列挙できます。  ただし、コレクションへの挿入や削除によって [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] が自動的に更新されるように動的バインディングを設定するには、コレクションで <xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを実装する必要があります。  このインターフェイスは、基になるコレクションが変更されるたびに発生するイベントを公開します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを公開するデータ コレクションの組み込み実装である <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスを提供します。  ソース オブジェクトからターゲットへのデータ値の転送を完全にサポートするためには、バインド可能なプロパティをサポートするコレクション内の各オブジェクトに <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスも実装する必要があります。  詳細については、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」を参照してください。  
+  
+ 独自のコレクションを実装する前に、<xref:System.Collections.ObjectModel.ObservableCollection%601> または既存のコレクション クラスのいずれか \(特に <xref:System.Collections.Generic.List%601>、<xref:System.Collections.ObjectModel.Collection%601>、<xref:System.ComponentModel.BindingList%601> など\) の使用を検討します。  高度なシナリオがあり、独自のコレクションを実装する場合は、<xref:System.Collections.IList> の使用を検討してください。これにより、インデックスによって個別にアクセスできるオブジェクトの非ジェネリック コレクションが利用可能になり、最適なパフォーマンスが実現されます。  
+  
+<a name="collection_views"></a>   
+### コレクション ビュー  
+ <xref:System.Windows.Controls.ItemsControl> をデータ コレクションにバインドすると、データの並べ替え、フィルター処理、またはグループ化が必要になる場合があります。  これらの処理を実行するには、<xref:System.ComponentModel.ICollectionView> インターフェイスを実装したクラスであるコレクション ビューを使用します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="what_are_collection_views"></a>   
+#### コレクション ビューとは  
+ コレクション ビューは、基になるソース コレクションそのものを操作せずに、並べ替え、フィルター、およびグループ クエリに基づいてソース コレクションを移動および表示できるようにする、バインディング ソース コレクションの最上位層です。  また、コレクション ビューは、コレクション内の現在の項目へのポインターを維持します。  ソース コレクションが <xref:System.Collections.Specialized.INotifyCollectionChanged> インターフェイスを実装している場合は、<xref:System.Collections.Specialized.INotifyCollectionChanged.CollectionChanged> イベントによって発生した変更がビューに反映されます。  
+  
+ ビューは基になるソース コレクションを変更しないため、各ソース コレクションは関連付けられた複数のビューを持つことができます。  たとえば、*Task* オブジェクトのコレクションを持つことができます。  ビューを使用することにより、同じデータを異なる方法で表示できます。  たとえば、優先順位で並べ替えたタスクをページの左側に表示し、領域ごとにグループ化されたタスクをページの右側に表示できます。  
+  
+<a name="how_to_create_a_view"></a>   
+#### ビューを作成する方法  
+ ビューを作成および使用する方法の 1 つは、ビュー オブジェクトを直接インスタンス化し、それをバインディング オブジェクトとして使用することです。  たとえば、「[データ バインディングとは](#what_is_data_binding)」セクションで示した[データ バインディングのデモ](http://go.microsoft.com/fwlink/?LinkID=163703) アプリケーションを参照してください。  このアプリケーションは、<xref:System.Windows.Controls.ListBox> をデータ コレクションに直接バインドするのではなく、データ コレクション上のビューにバインドするように実装されています。  次の例は、[データ バインディングのデモ](http://go.microsoft.com/fwlink/?LinkID=163703) アプリケーションから抽出したものです。  <xref:System.Windows.Data.CollectionViewSource> クラスは、<xref:System.Windows.Data.CollectionView> から継承するクラスの [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] プロキシです。  この例では、現在のアプリケーション オブジェクトの *AuctionItems* コレクション \(<xref:System.Collections.ObjectModel.ObservableCollection%601> 型\) に、ビューの <xref:System.Windows.Data.CollectionViewSource.Source%2A> をバインドしています。  
+  
+ [!code-xml[DataBindingLab#WindowResources1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#windowresources1)]  
+[!code-xml[DataBindingLab#CollectionViewSource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#collectionviewsource)]  
+[!code-xml[DataBindingLab#WindowResources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#windowresources2)]  
+  
+ 次に、*listingDataView* リソースを、アプリケーション内の要素 \(<xref:System.Windows.Controls.ListBox> など\) のバインディング ソースに設定します。  
+  
+ [!code-xml[DataBindingLab#Master1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#master1)]  
+[!code-xml[DataBindingLab#Master2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#master2)]  
+  
+ 同じコレクションに対して別のビューを作成するには、別の <xref:System.Windows.Data.CollectionViewSource> インスタンスを作成し、そのインスタンスに異なる `x:Key` 名を付けます。  
+  
+ 次の表は、既定のコレクション ビューとして作成されるビュー データの型、またはソース コレクションの型に基づく <xref:System.Windows.Data.CollectionViewSource> で作成されるビュー データの型を示しています。  
+  
+|ソース コレクションの型|コレクション ビューの型|説明|  
+|------------------|------------------|--------|  
+|<xref:System.Collections.IEnumerable>|<xref:System.Windows.Data.CollectionView> に基づく内部型|項目をグループ化できません。|  
+|<xref:System.Collections.IList>|<xref:System.Windows.Data.ListCollectionView>|最も高速です。|  
+|<xref:System.ComponentModel.IBindingList>|<xref:System.Windows.Data.BindingListCollectionView>||  
+  
+##### 既定のビューの使用  
+ コレクション ビューを作成および使用する 1 つの方法は、コレクション ビューをバインディング オブジェクトとして指定することです。  また、WPF は、バインディング ソースとして使用されるすべてのコレクション用の既定のコレクション ビューを作成します。  コレクションに直接バインドする場合、WPF はその既定のビューにバインドします。  この既定のビューは、同じコレクションへのすべてのバインディングで共有されます。そのため、1 つのバインドされたコントロールまたはコードによって既定のビューに加えられた変更 \(後で説明する、現在の項目のポインターの並べ替えや変更など\) は、同じコレクションへの他のすべてのバインディングにも反映されます。  
+  
+ 既定のビューを取得するには、<xref:System.Windows.Data.CollectionViewSource.GetDefaultView%2A> メソッドを使用します。  例については、「[データ コレクションの既定のビューを取得する](../../../../docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md)」を参照してください。  
+  
+##### ADO.NET DataTables を持つコレクション ビュー  
+ パフォーマンスを向上させるため、ADO.NET <xref:System.Data.DataTable> オブジェクトまたは <xref:System.Data.DataView> オブジェクトのコレクション ビューは、並べ替えとフィルター処理を <xref:System.Data.DataView> に委任します。  これにより、データ ソースのすべてのコレクション ビューが、並べ替えとフィルター処理を共有するようになります。  各コレクション ビューが個別に並べ替えとフィルター処理を行うことができるようにするには、各コレクション ビューをそれ自体の <xref:System.Data.DataView> オブジェクトで初期化します。  
+  
+<a name="sorting"></a>   
+#### 並べ替え  
+ 既に説明したように、ビューでは、コレクションに並べ替え順序を適用できます。  基になるコレクションに並べ替え順序が存在している場合、関連する固有の順序がデータに適用されたり適用されなかったりすることがあります。  コレクション上のビューを使用すると、指定した比較条件に基づいて、順序を強制したり既定の順序を変更したりできます。  これはクライアント ベースのデータ ビューであるため、ユーザーが対応する列の値に応じてテーブル データの列を並べ替える必要がある場合によく使用されます。  ビューを使用すると、こうしたユーザーによる並べ替えを適用できます。この場合も基になるコレクションを変更する必要はありません。また、コレクションのコンテンツに対してクエリを再度実行する必要さえありません。  例については、「[ヘッダーがクリックされたときに GridView 列を並べ替える](../../../../docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md)」を参照してください。  
+  
+ 次の例は、「[データ バインディングとは](#what_is_data_binding)」セクションで示したアプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] である \[Sort by category and date\] <xref:System.Windows.Controls.CheckBox> の並べ替えロジックを示しています。  
+  
+ [!code-csharp[DataBindingLab#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#8)]
+ [!code-vb[DataBindingLab#8](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#8)]  
+  
+<a name="filtering"></a>   
+#### フィルター処理  
+ ビューでは、コレクションにフィルターを適用することもできます。  つまり、この特定のビューは、コレクションに項目が存在する場合でも、コレクション全体の特定のサブセットのみを表示するためのものです。  データの条件に基づいてフィルター処理することができます。  たとえば、「[データ バインディングとは](#what_is_data_binding)」セクションで示したアプリケーションの \[Show only bargains\] <xref:System.Windows.Controls.CheckBox> には、25 ドル以上の品目をフィルターで除外するロジックが含まれています。  この <xref:System.Windows.Controls.CheckBox> をオンにすると、次のコードが実行され、*ShowOnlyBargainsFilter* が <xref:System.Windows.Data.CollectionViewSource.Filter> イベント ハンドラーとして設定されます。  
+  
+ [!code-csharp[DataBindingLab#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#10)]
+ [!code-vb[DataBindingLab#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#10)]  
+  
+ *ShowOnlyBargainsFilter* イベント ハンドラーの実装例を次に示します。  
+  
+ [!code-csharp[DataBindingLab#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#5)]
+ [!code-vb[DataBindingLab#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#5)]  
+  
+ <xref:System.Windows.Data.CollectionViewSource> の代わりに <xref:System.Windows.Data.CollectionView> クラスのいずれかを直接使用している場合は、<xref:System.Windows.Data.CollectionView.Filter%2A> プロパティを使用してコールバックを指定します。  例については、「[ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)」を参照してください。  
+  
+<a name="grouping"></a>   
+#### グループ化  
+ <xref:System.Collections.IEnumerable> コレクションを表示する内部クラスを除いて、すべてのコレクション ビューがグループ化の機能をサポートします。このため、ユーザーは、コレクション ビュー内でコレクションを論理グループに分割できます。  グループには、ユーザーがグループの一覧を提供する明示的なグループと、データに基づいて動的にグループが生成される暗黙的なグループがあります。  
+  
+ 次の例は、\[Group by category\] <xref:System.Windows.Controls.CheckBox> のロジックを示しています。  
+  
+ [!code-csharp[DataBindingLab#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#6)]
+ [!code-vb[DataBindingLab#6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#6)]  
+  
+ 他のグループ化の例については、「[GridView を実装する ListView の項目をグループ化する](../../../../docs/framework/wpf/controls/how-to-group-items-in-a-listview-that-implements-a-gridview.md)」を参照してください。  
+  
+<a name="current_record_pointers"></a>   
+#### 現在の項目のポインター  
+ ビューでは、現在の項目の概念もサポートされます。  コレクション ビュー内のオブジェクト間を移動できます。  オブジェクト間を移動するときは、コレクション内の特定の場所に存在するオブジェクトを取得できるようにする項目ポインターを移動しています。  例については、「[データ CollectionView のオブジェクト間を移動する](../../../../docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md)」を参照してください。  
+  
+ WPF がコレクションにバインドするときは必ずビュー \(ユーザーが指定したビュー、またはコレクションの既定のビュー\) を使用するため、コレクションへのすべてのバインディングには現在の項目のポインターがあります。  ビューにバインドするたきには、`Path` 値のスラッシュ \("\/"\) 文字がそのビューの現在の項目を指定します。  次の例では、データ コンテキストがコレクション ビューになります。  最初の行はコレクションにバインドします。  2 番目の行はコレクション内の現在の項目にバインドします。  3 行目は、コレクション内の現在の項目の `Description` プロパティにバインドします。  
+  
+```xaml  
+<Button Content="{Binding }" />  
+<Button Content="{Binding Path=/}" />  
+<Button Content="{Binding Path=/Description}" />   
+```  
+  
+ スラッシュとプロパティ構文をスタックして、コレクション階層を走査することもできます。  次の例では、ソース コレクションの現在の項目のプロパティである、`Offices` という名前の、コレクションの現在の項目にバインドします。  
+  
+```xaml  
+<Button Content="{Binding /Offices/}" />  
+```  
+  
+ 現在の項目のポインターは、コレクションに適用される並べ替えまたはフィルター処理によって影響を受けることがあります。  並べ替えでは、選択した最後の項目に現在の項目のポインターが維持されますが、コレクション ビューはその項目を中心にして再構築されます   \(リストの先頭にあった、選択された項目が、リストの中央部に移動することが考えられます\)。選択されていた項目がフィルター処理後にビュー内に残っている場合、その項目は保持されます。  それ以外の場合、現在の項目のポインターは、フィルター処理されたコレクション ビューの最初の項目に設定されます。  
+  
+<a name="master_detail_scenario"></a>   
+#### マスター詳細シナリオ  
+ 現在の項目の概念は、コレクション内の項目間の移動だけでなく、バインディングのマスター詳細シナリオでも役立ちます。  「[データ バインディングとは](#what_is_data_binding)」セクションのアプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をもう一度考えてみましょう。  このアプリケーションでは、<xref:System.Windows.Controls.ListBox> 内の選択内容によって <xref:System.Windows.Controls.ContentControl> に表示されるコンテンツが決定されます。  つまり、<xref:System.Windows.Controls.ListBox> の項目を選択すると、その項目の詳細が <xref:System.Windows.Controls.ContentControl> に表示されます。  
+  
+ 複数のコントロールを同じビューにバインドするだけで、マスター詳細シナリオを実装することができます。  次に示すのは[データ バインディングのデモ](http://go.microsoft.com/fwlink/?LinkID=163703)からの例で、<xref:System.Windows.Controls.ListBox> のマークアップおよび <xref:System.Windows.Controls.ContentControl> です。これらは「[データ バインディングとは](#what_is_data_binding)」セクションのアプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] で参照しました。  
+  
+ [!code-xml[DataBindingLab#Master1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#master1)]  
+[!code-xml[DataBindingLab#Master2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#master2)]  
+[!code-xml[DataBindingLab#Detail](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml#detail)]  
+  
+ 両方のコントロールが同じソース \(*listingDataView* 静的リソース\) にバインドされていることに注意してください \(「[ビューを作成する方法](#how_to_create_a_view)」セクションにあるこのリソースの定義を参照\)。  これが機能するのは、シングルトン オブジェクト \(この場合は <xref:System.Windows.Controls.ContentControl>\) をコレクション ビューにバインドした場合、そのシングルトン オブジェクトが自動的にビューの <xref:System.Windows.Data.CollectionView.CurrentItem%2A> にバインドされるためです。  <xref:System.Windows.Data.CollectionViewSource> オブジェクトによって現在の項目と選択した項目が自動的に同期されることに注意してください。  この例とは異なり、リスト コントロールが <xref:System.Windows.Data.CollectionViewSource> オブジェクトにバインドされない場合は、<xref:System.Windows.Controls.Primitives.Selector.IsSynchronizedWithCurrentItem%2A> プロパティを `true` に設定して、現在の項目と選択した項目が同期されるようにする必要があります。  
+  
+ その他の例については、「[コレクションにバインドして選択に基づく情報を表示する](../../../../docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md)」および「[階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)」を参照してください。  
+  
+ 上記の例ではテンプレートが使用されています。  実際、テンプレート \(<xref:System.Windows.Controls.ContentControl> によって明示的に使用されるテンプレートと <xref:System.Windows.Controls.ListBox> によって暗黙的に使用されるテンプレート\) を使用しない場合、データは意図したとおりの形式で表示されません。  次のセクションでは、データ テンプレートについて説明します。  
+  
+<a name="data_templating"></a>   
+## データ テンプレート  
+ データ テンプレートを使用しない場合、「[データ バインディングとは](#what_is_data_binding)」セクションのアプリケーション [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は、次のようになります。  
+  
+ ![データ テンプレートのないデータ バインディング デモ](../../../../docs/framework/wpf/data/media/databindingdemotemplates.png "DataBindingDemoTemplates")  
+  
+ 前のセクションの例で示したように、<xref:System.Windows.Controls.ListBox> コントロールおよび <xref:System.Windows.Controls.ContentControl> の両方が、*AuctionItems* のコレクション オブジェクト全体 \(具体的には、コレクション オブジェクトのビュー\) にバインドされます。  データ コレクションの表示方法を特に指定していない場合は、基になるコレクション内の各オブジェクトの文字列表現が <xref:System.Windows.Controls.ListBox> に表示され、バインド先のオブジェクトの文字列形式が <xref:System.Windows.Controls.ContentControl> に表示されます。  
+  
+ この問題を解決するには、アプリケーションで <xref:System.Windows.DataTemplate> を定義します。  前のセクションの例で示したように、<xref:System.Windows.Controls.ContentControl> は *detailsProductListingTemplate* <xref:System.Windows.DataTemplate> を明示的に使用します。  <xref:System.Windows.Controls.ListBox> コントロールは、コレクション内の *AuctionItem* オブジェクトを表示する際に、次の <xref:System.Windows.DataTemplate> を暗黙的に使用します。  
+  
+ [!code-xml[DataBindingLab#AuctionItemDataTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/DataBindingLabApp.xaml#auctionitemdatatemplate)]  
+  
+ これら 2 つの <xref:System.Windows.DataTemplate> を使用すると、「[データ バインディングとは](#what_is_data_binding)」セクションで示した UI が表示されます。  この UI のスクリーンショットからわかるように、<xref:System.Windows.DataTemplate> を使用すると、コントロール内にデータを配置できるだけでなく、優れた視覚効果をデータに対して定義することができます。  たとえば、上の <xref:System.Windows.DataTemplate> では、<xref:System.Windows.DataTrigger> を使用しています。これにより、*HighLight* の値が *SpecialFeatures* に設定されている *AuctionItem* が、星の付いたオレンジ色の境界線で表示されます。  
+  
+ データ テンプレートの詳細については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)」を参照してください。  
+  
+<a name="data_validation"></a>   
+## データの検証  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+ ユーザー入力を受け取るほとんどのアプリケーションでは、ユーザーが必要な情報を入力したことを確認するための検証ロジックが必要になります。  型、範囲、形式、またはその他のアプリケーション固有の要件に基づいて、検証チェックを実行することができます。  ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] におけるデータ検証のしくみについて説明します。  
+  
+<a name="validation_rules"></a>   
+### 検証規則とバインディングの関連付け  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] データ バインディング モデルでは、<xref:System.Windows.Data.Binding.ValidationRules%2A> を <xref:System.Windows.Data.Binding> オブジェクトに関連付けることができます。  たとえば、次の例では <xref:System.Windows.Controls.TextBox> を `StartPrice` という名前のプロパティにバインドし、<xref:System.Windows.Controls.ExceptionValidationRule> オブジェクトを <xref:System.Windows.Data.Binding.ValidationRules%2A?displayProperty=fullName> プロパティにバインドします。  
+  
+ [!code-xml[DataBindingLab#DefaultValidation](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/AddProductWindow.xaml#defaultvalidation)]  
+  
+ <xref:System.Windows.Controls.ValidationRule> オブジェクトは、プロパティ値が有効であるかどうかを確認します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、次の 2 種類の組み込み <xref:System.Windows.Controls.ValidationRule> オブジェクトがあります。  
+  
+-   <xref:System.Windows.Controls.ExceptionValidationRule> では、バインディング ソース プロパティの更新中にスローされる例外をチェックします。  前の例では、`StartPrice` の型は整数です。  ユーザーが整数に変換できない値を入力すると、例外がスローされ、バインディングが無効としてマークされます。  また、<xref:System.Windows.Controls.ExceptionValidationRule> を明示的に設定するには、<xref:System.Windows.Data.Binding> オブジェクトまたは <xref:System.Windows.Data.MultiBinding> オブジェクトで、<xref:System.Windows.Data.Binding.ValidatesOnExceptions%2A> プロパティを `true` に設定する構文も使用できます。  
+  
+-   <xref:System.Windows.Controls.DataErrorValidationRule> オブジェクトは、<xref:System.ComponentModel.IDataErrorInfo> インターフェイスを実装するオブジェクトで発生するエラーをチェックします。  この検証規則の使用例については、「<xref:System.Windows.Controls.DataErrorValidationRule>」を参照してください。  また、<xref:System.Windows.Controls.DataErrorValidationRule> を明示的に設定するには、<xref:System.Windows.Data.Binding> オブジェクトまたは <xref:System.Windows.Data.MultiBinding> オブジェクトで、<xref:System.Windows.Data.Binding.ValidatesOnDataErrors%2A> プロパティを `true` に設定する構文も使用できます。  
+  
+ <xref:System.Windows.Controls.ValidationRule> クラスを継承し、<xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドを実装することにより、独自の検証規則を作成することもできます。  次の例は、「[データ バインディングとは](#what_is_data_binding)」セクションで示した \[Add Product Listing\] の \[Start Date\] <xref:System.Windows.Controls.TextBox> で使用される規則を示しています。  
+  
+ [!code-csharp[DataBindingLab#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/FutureDateRule.cs#2)]
+ [!code-vb[DataBindingLab#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/FutureDateRule.vb#2)]  
+  
+ 次の例に示すように、*StartDateEntryForm* <xref:System.Windows.Controls.TextBox> では、この *FutureDateRule* が使用されます。  
+  
+ [!code-xml[DataBindingLab#CustomValidation](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/AddProductWindow.xaml#customvalidation)]  
+  
+ <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> の値が <xref:System.Windows.Data.UpdateSourceTrigger> であるため、バインディング エンジンは、キーストロークが発生するたびにソース値を更新します。つまり、<xref:System.Windows.Data.Binding.ValidationRules%2A> コレクション内のすべての規則もまた、キーストロークが発生するたびにバインディング エンジンによってチェックされることになります。  詳細については、「検証プロセス」セクションで説明します。  
+  
+<a name="invalidation_feedback"></a>   
+### 視覚的フィードバックの提供  
+ ユーザーが無効な値を入力した場合には、アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 上でエラーに関するフィードバックを提供する必要があります。  このようなフィードバックを提供する方法として、<xref:System.Windows.Controls.Validation.ErrorTemplate%2A?displayProperty=fullName> 添付プロパティをカスタム <xref:System.Windows.Controls.ControlTemplate> に設定する方法があります。  前のサブセクションで示したように、*StartDateEntryForm* <xref:System.Windows.Controls.TextBox> では、*validationTemplate* という名前の <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> が使用されます。  *validationTemplate* の定義を次の例に示します。  
+  
+ [!code-xml[DataBindingLab#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/AddProductWindow.xaml#1)]  
+  
+ <xref:System.Windows.Controls.AdornedElementPlaceholder> 要素は、装飾されているコントロールの位置を指定します。  
+  
+ また、<xref:System.Windows.Controls.ToolTip> を使用してエラー メッセージを表示することもできます。  *StartDateEntryForm* および *StartPriceEntryForm* の両 <xref:System.Windows.Controls.TextBox> では、*textStyleTextBox* スタイルが使用されています。これにより、エラー メッセージを表示する <xref:System.Windows.Controls.ToolTip> が作成されます。  *textStyleTextBox* の定義を次の例に示します。  バインドされている要素のプロパティで 1 つ以上のバインディングにエラーが発生すると、<xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> [添付プロパティ](GTMT)が `true` になります。  
+  
+ [!code-xml[DataBindingLab#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/DataBindingLabApp.xaml#14)]  
+  
+ カスタム <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> と <xref:System.Windows.Controls.ToolTip> を使用している場合、検証エラーが発生すると、*StartDateEntryForm* <xref:System.Windows.Controls.TextBox> は次のようになります。  
+  
+ ![データ バインディング検証エラー](../../../../docs/framework/wpf/data/media/databindingdemo-validation.png "DataBindingDemo\_Validation")  
+  
+ <xref:System.Windows.Data.Binding> に検証規則が関連付けられていても、バインドされているコントロールに対して <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> を指定していない場合は、検証エラーが発生したときのユーザーへの通知に既定の <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> が使用されます。  既定の <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> は、装飾層に赤い境界線を定義するコントロール テンプレートです。  既定の <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> と <xref:System.Windows.Controls.ToolTip> を使用している場合、検証エラーが発生すると、*StartPriceEntryForm* <xref:System.Windows.Controls.TextBox> の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] は次のようになります。  
+  
+ ![データ バインディング検証エラー](../../../../docs/framework/wpf/data/media/databindingdemo-validationdefault.png "DataBindingDemo\_ValidationDefault")  
+  
+ ダイアログ ボックス内のすべてのコントロールを検証するロジックを提供する方法の例については、「[ダイアログ ボックスの概要](../../../../docs/framework/wpf/app-development/dialog-boxes-overview.md)」の「カスタム ダイアログ ボックス」セクションを参照してください。  
+  
+<a name="validation_process"></a>   
+### 検証プロセス  
+ 検証は、通常、ターゲットの値がバインディング ソース プロパティに転送されると発生します。  検証は、<xref:System.Windows.Data.BindingMode> バインディングと <xref:System.Windows.Data.BindingMode> バインディングで行われます。  「[ソースの更新の要因](#what_triggers_source_updates)」セクションで説明したように、ソースの更新の要因は、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティの値によって異なります。  
+  
+ ここでは、*検証*プロセスについて説明します。  このプロセスの最中に検証エラーなどのエラーが発生すると、プロセスが中止されることに注意してください。  
+  
+1.  バインディング エンジンは、該当する <xref:System.Windows.Data.Binding> について <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されているカスタム <xref:System.Windows.Controls.ValidationRule> オブジェクトが定義されているかどうかをチェックします。このとき、どれかでエラーが発生するか、すべてが合格するまで、各 <xref:System.Windows.Controls.ValidationRule> の <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドを呼び出します。  
+  
+2.  次に、バインディング エンジンはコンバーターを呼び出します \(存在する場合\)。  
+  
+3.  コンバーターが正常終了した場合、バインディング エンジンは、該当する <xref:System.Windows.Data.Binding> について <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されているカスタム <xref:System.Windows.Controls.ValidationRule> オブジェクトが定義されているかどうかをチェックします。このとき、いずれかでエラーが発生するか、すべてが合格するまで、<xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されている各 <xref:System.Windows.Controls.ValidationRule> の <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドを呼び出します。  
+  
+4.  バインディング エンジンがソース プロパティを設定します。  
+  
+5.  バインディング エンジンは、該当する <xref:System.Windows.Data.Binding> について <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されているカスタム <xref:System.Windows.Controls.ValidationRule> オブジェクトが定義されているかどうかをチェックします。このとき、いずれかでエラーが発生するか、すべてが合格するまで、<xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されている各 <xref:System.Windows.Controls.ValidationRule> の <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドを呼び出します。  <xref:System.Windows.Controls.DataErrorValidationRule> がバインディングに関連付けられており、その <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が既定の <xref:System.Windows.Controls.ValidationStep> に設定されている場合、この時点で <xref:System.Windows.Controls.DataErrorValidationRule> がチェックされます。  また、この時点で、<xref:System.Windows.Data.Binding.ValidatesOnDataErrors%2A> が `true` に設定されているバインディングもチェックされます。  
+  
+6.  バインディング エンジンは、該当する <xref:System.Windows.Data.Binding> について <xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されているカスタム <xref:System.Windows.Controls.ValidationRule> オブジェクトが定義されているかどうかをチェックします。このとき、いずれかでエラーが発生するか、すべてが合格するまで、<xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されている各 <xref:System.Windows.Controls.ValidationRule> の <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドを呼び出します。  
+  
+ このプロセスの最中に <xref:System.Windows.Controls.ValidationRule> が合格しなかった場合、バインディング エンジンは <xref:System.Windows.Controls.ValidationError> オブジェクトを作成し、それをバインドされている要素の <xref:System.Windows.Controls.Validation.Errors%2A?displayProperty=fullName> コレクションに追加します。  バインディング エンジンは、各手順で <xref:System.Windows.Controls.ValidationRule> オブジェクトを実行する前に、バインドされた要素の <xref:System.Windows.Controls.Validation.Errors%2A?displayProperty=fullName> [添付プロパティ](GTMT)にその手順で以前追加されたすべての <xref:System.Windows.Controls.ValidationError> を削除します。  たとえば、<xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定された <xref:System.Windows.Controls.ValidationRule> が不合格になった場合、次回このプロセスが発生したとき、バインディング エンジンはそのような <xref:System.Windows.Controls.ValidationError> を、<xref:System.Windows.Controls.ValidationRule.ValidationStep%2A> が <xref:System.Windows.Controls.ValidationStep> に設定されている <xref:System.Windows.Controls.ValidationRule> を呼び出す直前に削除します。  
+  
+ <xref:System.Windows.Controls.Validation.Errors%2A?displayProperty=fullName> が空でない場合、その要素の <xref:System.Windows.Controls.Validation.HasError%2A?displayProperty=fullName> [添付プロパティ](GTMT)は `true` に設定されます。  また、<xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.Binding.NotifyOnValidationError%2A> プロパティが `true` に設定されている場合、バインディング エンジンはその要素の <xref:System.Windows.Controls.Validation.Error?displayProperty=fullName> [添付イベント](GTMT)を発生させます。  
+  
+ また、どちらの方向 \(ターゲットからソース、またはソースからターゲット\) でも、有効な値を転送すると <xref:System.Windows.Controls.Validation.Errors%2A?displayProperty=fullName> [添付プロパティ](GTMT)が消去されることに注意してください。  
+  
+ バインディングに <xref:System.Windows.Controls.ExceptionValidationRule> が関連付けられているか、<xref:System.Windows.Data.Binding.ValidatesOnExceptions%2A> プロパティが `true` に設定されており、バインディング エンジンがソースを設定したときに例外がスローされた場合、バインディング エンジンは <xref:System.Windows.Data.Binding.UpdateSourceExceptionFilter%2A> が存在するかどうかをチェックします。  <xref:System.Windows.Data.Binding.UpdateSourceExceptionFilter%2A> コールバックを使用して、例外を処理するためのカスタム ハンドラーを提供することもできます。  <xref:System.Windows.Data.Binding.UpdateSourceExceptionFilter%2A> が <xref:System.Windows.Data.Binding> で指定されていない場合、バインディング エンジンは例外を使用して <xref:System.Windows.Controls.ValidationError> を作成し、それをバインドされている要素の <xref:System.Windows.Controls.Validation.Errors%2A?displayProperty=fullName> コレクションに追加します。  
+  
+<a name="debugging_mechanism"></a>   
+## デバッグ機構  
+ バインディング関連のオブジェクトに対して <xref:System.Diagnostics.PresentationTraceSources.TraceLevel%2A?displayProperty=fullName> 添付プロパティを設定すると、特定のバインディングのステータス情報を取得できます。  
+  
+## 参照  
+ <xref:System.Windows.Controls.DataErrorValidationRule>   
+ [WPF Version 4.5 の新機能](../../../../docs/framework/wpf/getting-started/whats-new.md)   
+ [LINQ クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-the-results-of-a-linq-query.md)   
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [データ バインディングのデモ](http://go.microsoft.com/fwlink/?LinkID=163703)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)   
+ [ADO.NET データ ソースにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-an-ado-net-data-source.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/data-binding-wpf.md b/docs/framework/wpf/data/data-binding-wpf.md
new file mode 100644
index 00000000000..e93aaed4594
--- /dev/null
+++ b/docs/framework/wpf/data/data-binding-wpf.md
@@ -0,0 +1,48 @@
+---
+title: "データ バインド (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "バインド (データを)"
+  - "データ バインディング"
+ms.assetid: 90f79b97-17e7-40d1-abf0-3ba600ad1d7e
+caps.latest.revision: 79
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 79
+---
+# データ バインド (WPF)
+Windows Presentation Foundation \(WPF\) のデータ バインディングは、アプリケーションがデータを提示し、データと対話するための簡単で一貫性のある方法を提供します。  要素は、共通言語ランタイム \(CLR\) オブジェクトや XML の形式のさまざまなデータ ソースのデータにバインドできます。  
+  
+## このセクションの内容  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)  
+ [バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)  
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)  
+ [バインディング宣言の概要](../../../../docs/framework/wpf/data/binding-declarations-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Data>  
+  
+ <xref:System.Windows.Data.Binding>  
+  
+ <xref:System.Windows.DataTemplate>  
+  
+ <xref:System.Windows.Controls.DataTemplateSelector>  
+  
+## 関連項目  
+ [ドラッグ アンド ドロップ](../../../../docs/framework/wpf/advanced/drag-and-drop.md)  
+  
+ [データ バインド](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)  
+  
+ [チュートリアル: WPF アプリケーション内のアプリケーション データのキャッシュ](../../../../docs/framework/wpf/advanced/walkthrough-caching-application-data-in-a-wpf-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/data-templating-overview.md b/docs/framework/wpf/data/data-templating-overview.md
new file mode 100644
index 00000000000..b42840a2e71
--- /dev/null
+++ b/docs/framework/wpf/data/data-templating-overview.md
@@ -0,0 +1,207 @@
+---
+title: "データ テンプレートの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインド、テンプレート"
+  - "データ バインディング、テンプレート"
+  - "データのテンプレート"
+  - "データ テンプレート"
+ms.assetid: 0f4d9f8c-0230-4013-bd7b-e8e7fed01b4a
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# データ テンプレートの概要
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]データ テンプレート モデルは、非常に柔軟に、データの表示を定義します。 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]コントロールには、データの表示のカスタマイズをサポートする組み込みの機能があります。 このトピックは、まずを定義する方法を示します、 <xref:System.Windows.DataTemplate>し、カスタム ロジックと階層データを表示するためのサポートに基づくテンプレートの選択などその他のデータ転送の各機能を紹介します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Prerequisites"></a>   
+## <a name="prerequisites"></a>必須コンポーネント  
+ このトピックでは、データ テンプレート機能に重点を置いていて、データ バインディングの概念の概要ではありません。 基本的なデータ バインディングの概念については、次を参照してください。、[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)します。  
+  
+ <xref:System.Windows.DataTemplate>データの表示については、によって提供される多くの機能の&1; つ、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]スタイルとテンプレートのモデルです。 概要については、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]を使用する方法などのスタイルとテンプレートのモデル、<xref:System.Windows.Style>コントロールのプロパティを設定するには、「、[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)トピックです。  
+  
+ さらを理解する必要が`Resources`、使用できるようにオブジェクトなど、これは本質的に<xref:System.Windows.Style>と<xref:System.Windows.DataTemplate>再利用できるようにします。 リソースの詳細については、次を参照してください。 [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)します。  
+  
+<a name="DataTemplating_Basic"></a>   
+## <a name="data-templating-basics"></a>データ テンプレートの基本  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+ その理由を示すために<xref:System.Windows.DataTemplate>が重要では、データ バインディングの例をしていきます。 私たちがこの例では、 <xref:System.Windows.Controls.ListBox>の一覧にバインドされた`Task`オブジェクトです。 各`Task`オブジェクトには、 `TaskName` (文字列)、 `Description` (文字列)、 `Priority` (int) と型のプロパティ`TaskType`、これは、`Enum`値を持つ`Home`と`Work`です。  
+  
+ [!code-xml[DataTemplatingIntro_snip#Resources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#resources)]  
+[!code-xml[DataTemplatingIntro_snip#UI1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#ui1)]  
+[!code-xml[DataTemplatingIntro_snip#UI2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#ui2)]  
+  
+<a name="without_a_datatemplate"></a>   
+### <a name="without-a-datatemplate"></a>DataTemplate なし  
+ なし、 <xref:System.Windows.DataTemplate>、当社<xref:System.Windows.Controls.ListBox>現在次のようにします。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig1.png "DataTemplatingIntro_fig1")  
+  
+ ない場合の特定の手順では、何が起こっているか、 <xref:System.Windows.Controls.ListBox>既定の呼び出しによって`ToString`コレクションにオブジェクトを表示しようとするとします。 そのため場合、`Task`オブジェクトの上書き、 `ToString` 、メソッド、 <xref:System.Windows.Controls.ListBox>基になるコレクションに各ソース オブジェクトの文字列表現を表示します。  
+  
+ などの場合、`Task`クラスのオーバーライド、`ToString`メソッドこうすると、ここで`name`用のフィールド、`TaskName`プロパティ。  
+  
+ [!code-csharp[DataTemplatingIntro_snip#ToString](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Data.cs#tostring)]
+ [!code-vb[DataTemplatingIntro_snip#ToString](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataTemplatingIntro_snip/visualbasic/data.vb#tostring)]  
+  
+ 続いて、 <xref:System.Windows.Controls.ListBox>次のようになります。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig2.png "DataTemplatingIntro_fig2")  
+  
+ ただし、制限があり、柔軟性は低いものです。 またにバインドする場合は、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)]データできませんをオーバーライドする`ToString`です。  
+  
+<a name="defining_simple_datatemplate"></a>   
+### <a name="defining-a-simple-datatemplate"></a>単純な DataTemplate を定義します。  
+ ソリューションは、定義する、 <xref:System.Windows.DataTemplate>します。 1 つの方法が設定するのには、 <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>のプロパティ、 <xref:System.Windows.Controls.ListBox>に、 <xref:System.Windows.DataTemplate>します。 指定した、 <xref:System.Windows.DataTemplate>データ オブジェクトの視覚的な構造になります。 次<xref:System.Windows.DataTemplate>は非常に単純です。 3 つの各項目が表示される指示を送るお<xref:System.Windows.Controls.TextBlock>内の要素、 <xref:System.Windows.Controls.StackPanel>します。 各<xref:System.Windows.Controls.TextBlock>要素がのプロパティにバインドされている、`Task`クラスです。  
+  
+ [!code-xml[DataTemplatingIntro_snip#Inline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#inline)]  
+  
+ このトピックの例の基になるデータのコレクションは、[!INCLUDE[TLA2#tla_clr](../../../../includes/tla2sharptla-clr-md.md)]オブジェクトです。 バインドする場合は、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)]データは同じである、基本的な概念が、構文上のわずかな違いがあります。 例ではなく`Path=TaskName`、設定は<xref:System.Windows.Data.Binding.XPath%2A>に`@TaskName`(場合`TaskName`の属性です、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)]ノード)。  
+  
+ これで、 <xref:System.Windows.Controls.ListBox>次のようになります。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig3.png "DataTemplatingIntro_fig3")  
+  
+<a name="defining_datatemplate_as_a_resource"></a>   
+### <a name="creating-the-datatemplate-as-a-resource"></a>DataTemplate をリソースとして作成します。  
+ 上記の例で定義した、 <xref:System.Windows.DataTemplate>インラインです。 次の例に示すように、再利用可能なオブジェクトにするためのリソース セクションで定義する方が一般的です。  
+  
+ [!code-xml[DataTemplatingIntro_snip#R1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#r1)]  
+[!code-xml[DataTemplatingIntro_snip#AsResource](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#asresource)]  
+[!code-xml[DataTemplatingIntro_snip#R2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#r2)]  
+  
+ 使用できるようになりました`myTaskTemplate`次の例のように、リソースとして。  
+  
+ [!code-xml[DataTemplatingIntro_snip#MyTaskTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#mytasktemplate)]  
+  
+ `myTaskTemplate` 、リソースを受け取るプロパティを持つその他のコントロールで使用することができますようになりました、 <xref:System.Windows.DataTemplate>型です。 に対して、上記で示される<xref:System.Windows.Controls.ItemsControl>などのオブジェクト、 <xref:System.Windows.Controls.ListBox>は、 <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>プロパティです。 <xref:System.Windows.Controls.ContentControl>オブジェクトの場合に、 <xref:System.Windows.Controls.ContentControl.ContentTemplate%2A>プロパティです。  
+  
+<a name="Styling_DataType"></a>   
+### <a name="the-datatype-property"></a>DataType プロパティ  
+ <xref:System.Windows.DataTemplate>クラスには、 <xref:System.Windows.DataTemplate.DataType%2A>プロパティによく似ていますが、 <xref:System.Windows.Style.TargetType%2A>のプロパティ、<xref:System.Windows.Style>クラスです。 指定する代わりに、そのため、`x:Key`の<xref:System.Windows.DataTemplate>上記の例では、次を行うことができます。  
+  
+ [!code-xml[DataTemplatingIntro_snip#DataType](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#datatype)]  
+  
+ これは、 <xref:System.Windows.DataTemplate>すべてに自動的に適用される`Task`オブジェクトです。 ここで注意してください、`x:Key`が暗黙的に設定します。 そのため、これを割り当てる場合<xref:System.Windows.DataTemplate> 、`x:Key`値、暗黙的なをオーバーライドする`x:Key`と<xref:System.Windows.DataTemplate>自動的には適用されません。  
+  
+ バインドする場合、 <xref:System.Windows.Controls.ContentControl>のコレクションに`Task`オブジェクト、 <xref:System.Windows.Controls.ContentControl>上記は使いません<xref:System.Windows.DataTemplate>自動的にします。 これは、ためのバインディング、 <xref:System.Windows.Controls.ContentControl>コレクション全体または個々 のオブジェクトにバインドするかどうかを区別するためには情報が必要です。 場合、 <xref:System.Windows.Controls.ContentControl>の選択を追跡して、 <xref:System.Windows.Controls.ItemsControl>の種類を設定できます、<xref:System.Windows.Data.Binding.Path%2A>のプロパティ、 <xref:System.Windows.Controls.ContentControl>へのバインド"`/`"を現在のアイテムを興味のあることを示します。 例については、次を参照してください。[にバインドしてコレクションを選択に基づいて情報を表示](../../../../docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md)します。 それ以外の場合、指定する必要があります、 <xref:System.Windows.DataTemplate>設定して明示的に、 <xref:System.Windows.Controls.ContentControl.ContentTemplate%2A>プロパティです。  
+  
+ <xref:System.Windows.DataTemplate.DataType%2A>がある場合、プロパティが特に便利ですが、 <xref:System.Windows.Data.CompositeCollection>データ オブジェクトのさまざまな種類のです。 例については、次を参照してください。 [Compositecollection](../../../../docs/framework/wpf/data/how-to-implement-a-compositecollection.md)します。  
+  
+<a name="adding_more_to_datatemplate"></a>   
+## <a name="adding-more-to-the-datatemplate"></a>DataTemplate を複数追加します。  
+ データが現在必要な情報が表示されますが、間違いなく改善の余地があります。 追加することで、プレゼンテーションを改善しましょう、<xref:System.Windows.Controls.Border>、<xref:System.Windows.Controls.Grid>、およびいくつか<xref:System.Windows.Controls.TextBlock>が表示されているデータを説明する要素。  
+  
+ [!code-xml[DataTemplatingIntro#AddingMore](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DataTemplatingIntro/xaml/window1.xaml#addingmore)]  
+[!code-xml[DataTemplatingIntro#AddingMore2](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DataTemplatingIntro/xaml/window1.xaml#addingmore2)]  
+  
+ 次のスクリーン ショット、 <xref:System.Windows.Controls.ListBox>で修正された<xref:System.Windows.DataTemplate>:  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig4.png "DataTemplatingIntro_fig4")  
+  
+ 設定することが<xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A>に<xref:System.Windows.HorizontalAlignment>上、 <xref:System.Windows.Controls.ListBox>アイテムの幅が全体の場所を取っているかどうかを確認します。  
+  
+ [!code-xml[DataTemplatingIntro_snip#Stretch](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#stretch)]  
+  
+ <xref:System.Windows.Controls.Control.HorizontalContentAlignment%2A>プロパティに設定<xref:System.Windows.HorizontalAlignment>、 <xref:System.Windows.Controls.ListBox>今すぐ次のようにします。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig5.png "DataTemplatingIntro_fig5")  
+  
+<a name="DataTrigger_to_Apply_Property_Values"></a>   
+### <a name="use-datatriggers-to-apply-property-values"></a>DataTriggers を使用して、プロパティの値を適用するには  
+ 現在のプレゼンテーションには記載されているかどうか、`Task`ホーム タスクまたは office タスクです。 注意して、`Task`オブジェクトには、`TaskType`型のプロパティ`TaskType`、これは、列挙型値を持つ`Home`と`Work`です。  
+  
+ 次の例では、 <xref:System.Windows.DataTrigger>設定、 <xref:System.Windows.Controls.Border.BorderBrush%2A>という名前の要素の`border`に`Yellow`場合、`TaskType`プロパティは`TaskType.Home`です。  
+  
+ [!code-xml[DataTemplatingIntro#DT](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DataTemplatingIntro/xaml/window1.xaml#dt)]  
+[!code-xml[DataTemplatingIntro#DataTrigger](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DataTemplatingIntro/xaml/window1.xaml#datatrigger)]  
+[!code-xml[DataTemplatingIntro#AddingMore2](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DataTemplatingIntro/xaml/window1.xaml#addingmore2)]  
+  
+ これで、アプリケーションは、次のようになります。 ホーム作業が黄色の枠線と共に表示され、水色の境界線で office タスクが表示されます。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig6.png "DataTemplatingIntro_fig6")  
+  
+ この例では、 <xref:System.Windows.DataTrigger>を使用して、 <xref:System.Windows.Setter>プロパティ値を設定します。 トリガー クラスも持つ、 <xref:System.Windows.TriggerBase.EnterActions%2A>と<xref:System.Windows.TriggerBase.ExitActions%2A>アニメーションなどのアクションのセットを開始するためのプロパティです。 さらに、 <xref:System.Windows.MultiDataTrigger>複数のデータ バインドされたプロパティ値に基づいて、変更を適用できるようにするクラス。  
+  
+ バインドには、同じ効果を実現する方法も、 <xref:System.Windows.Controls.Border.BorderBrush%2A>プロパティを`TaskType`プロパティおよび使用する色を返す値コンバーターのに基づいて、`TaskType`値。 コンバーターを使用して上記の効果は、パフォーマンスの面で若干効率的です。 さらに、独自のコンバーターを作成する、柔軟性、独自のロジックを指定しているためです。 最終的には、どの手法を選択してでは、自分のシナリオと設定に依存します。 コンバーターを作成する方法については、次を参照してください。 <xref:System.Windows.Data.IValueConverter>します。  
+  
+<a name="what_belongs_in_datatemplate"></a>   
+### <a name="what-belongs-in-a-datatemplate"></a>DataTemplate でどのようなものでしょうか。  
+ 内でトリガーを配置する前の例では、 <xref:System.Windows.DataTemplate>を使用して、 <xref:System.Windows.DataTemplate>.<xref:System.Windows.DataTemplate.Triggers%2A>プロパティです。 <xref:System.Windows.Setter>トリガーの要素のプロパティの値を設定します (、<xref:System.Windows.Controls.Border>要素) 内にある、 <xref:System.Windows.DataTemplate>します。 ただし場合、プロパティを`Setters`も問題が現在の範囲内にある要素のプロパティではない<xref:System.Windows.DataTemplate>を使用してプロパティを設定する適切な場合があります、<xref:System.Windows.Style>については、 <xref:System.Windows.Controls.ListBoxItem>クラス (にバインドするコントロールがある場合、 <xref:System.Windows.Controls.ListBox>)。 たい場合など、<xref:System.Windows.Trigger>をアニメーション化する、<xref:System.Windows.UIElement.Opacity%2A>値、アイテムのアイテムにマウスがポイントしたときにトリガーを定義する内で、 <xref:System.Windows.Controls.ListBoxItem>スタイル。 例については、次を参照してください。、[スタイルとテンプレート サンプルの概要](http://go.microsoft.com/fwlink/?LinkID=160010)します。  
+  
+ 一般に、ことに注意、 <xref:System.Windows.DataTemplate>が、生成された各に適用される<xref:System.Windows.Controls.ListBoxItem> (詳細については、実際に適用される方法と場所は、次を参照してください。、 <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>ページです。)。 <xref:System.Windows.DataTemplate>はプレゼンテーション層とデータ オブジェクトの外観だけを考慮します。 ほとんどの場合、どのようなアイテムなどのプレゼンテーションの他のすべての側面とようになりますが選択されているか、または<xref:System.Windows.Controls.ListBox>の定義で、項目を lays が属していない、 <xref:System.Windows.DataTemplate>します。 例については、次を参照してください。、[スタイルとテンプレート、ItemsControl](#DataTemplating_ItemsControl)セクションです。  
+  
+<a name="Styling_StyleSelection"></a>   
+## <a name="choosing-a-datatemplate-based-on-properties-of-the-data-object"></a>データ オブジェクトのプロパティに基づいてデータ テンプレートを選択します。  
+ [DataType プロパティ](#Styling_DataType) セクションで、話し合い別のデータ オブジェクトのさまざまなデータ テンプレートを定義することができます。 ある場合に特に便利です、 <xref:System.Windows.Data.CompositeCollection>さまざまな種類のさまざまな種類の項目を含むコレクション。 [プロパティ値の適用を使用して DataTriggers](#DataTrigger_to_Apply_Property_Values)  セクションで、同じ種類のデータ オブジェクトのコレクションがある場合は、作成することを説明しました、 <xref:System.Windows.DataTemplate>し、トリガーを使用して、各データ オブジェクトのプロパティの値に基づいて変更を適用します。 ただし、トリガーでは、プロパティの値を適用またはアニメーションを開始することができますが、データ オブジェクトの構造を再構築する柔軟性が得られない。 一部のシナリオには、別に作成する必要があります<xref:System.Windows.DataTemplate>は同一のオブジェクト データの入力しますが、さまざまなプロパティがあります。  
+  
+ たとえば、`Task`オブジェクトには、`Priority`の値`1`、自分用の警告として処理するためにまったく異なる見た目にすることがあります。 この場合は、作成、 <xref:System.Windows.DataTemplate>高優先度を表示するため`Task`オブジェクトです。 次のコードを追加してみましょう<xref:System.Windows.DataTemplate> resources セクションにします。  
+  
+ [!code-xml[DataTemplatingIntro_snip#ImportantTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#importanttemplate)]  
+  
+ この例で、 <xref:System.Windows.DataTemplate>.<xref:System.Windows.FrameworkTemplate.Resources%2A>プロパティです。 内の要素が共有セクションに定義されているリソース、 <xref:System.Windows.DataTemplate>します。  
+  
+ 選択するためのロジックを提供する<xref:System.Windows.DataTemplate>に基づいて、使用するのには、`Priority`値のデータ オブジェクトのサブクラスを作成<xref:System.Windows.Controls.DataTemplateSelector>させ、 <xref:System.Windows.Controls.DataTemplateSelector.SelectTemplate%2A>メソッドです。 次の例では、 <xref:System.Windows.Controls.DataTemplateSelector.SelectTemplate%2A>メソッドの値に基づいて、適切なテンプレートを返すロジックを提供する、`Priority`プロパティです。 返されるテンプレートは、エンベロープの資料を参照<xref:System.Windows.Window>要素。  
+  
+ [!code-csharp[DataTemplatingIntro_snip#DTSClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/TaskListDataTemplateSelector.cs#dtsclass)]
+ [!code-vb[DataTemplatingIntro_snip#DTSClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataTemplatingIntro_snip/visualbasic/tasklistdatatemplateselector.vb#dtsclass)]  
+  
+ 宣言できますし、`TaskListDataTemplateSelector`をリソースとして。  
+  
+ [!code-xml[DataTemplatingIntro_snip#R1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#r1)]  
+[!code-xml[DataTemplatingIntro_snip#DTS](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#dts)]  
+[!code-xml[DataTemplatingIntro_snip#R2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#r2)]  
+  
+ テンプレート セレクター リソースを使用するには、それを割り当てる、 <xref:System.Windows.Controls.ItemsControl.ItemTemplateSelector%2A>のプロパティ、 <xref:System.Windows.Controls.ListBox>します。 <xref:System.Windows.Controls.ListBox>呼び出し、 <xref:System.Windows.Controls.DataTemplateSelector.SelectTemplate%2A>のメソッド、`TaskListDataTemplateSelector`の基になるコレクション内の項目ごとにします。 呼び出しは、アイテムのパラメーターとして、データ オブジェクトを渡します。 <xref:System.Windows.DataTemplate>によって返される、メソッドがそのデータ オブジェクトに適用されます。  
+  
+ [!code-xml[DataTemplatingIntro_snip#ItemTemplateSelector](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#itemtemplateselector)]  
+  
+ インプレースでのテンプレート セレクターで、 <xref:System.Windows.Controls.ListBox>次のように表示されます。  
+  
+ ![データ テンプレート サンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/datatemplatingintro-fig7.png "DataTemplatingIntro_fig7")  
+  
+ これには、この例の説明では終了します。 完全なサンプルを参照してください。[データ テンプレート サンプルの概要](http://go.microsoft.com/fwlink/?LinkID=160009)します。  
+  
+<a name="DataTemplating_ItemsControl"></a>   
+## <a name="styling-and-templating-an-itemscontrol"></a>スタイルとテンプレート、ItemsControl  
+ にもかかわらず、 <xref:System.Windows.Controls.ItemsControl>使用できる唯一のコントロール型ではない、 <xref:System.Windows.DataTemplate>にバインドする非常に一般的なシナリオでは、 <xref:System.Windows.Controls.ItemsControl>コレクションにします。 [DataTemplate に属しているどのような](#what_belongs_in_datatemplate)を説明したセクションの定義、 <xref:System.Windows.DataTemplate>がデータの表示で注意のみが必要です。 ないの使用に適した場合を知るために、 <xref:System.Windows.DataTemplate>によって提供されるさまざまなスタイルとテンプレートのプロパティを理解することが重要、 <xref:System.Windows.Controls.ItemsControl>します。 次の例は、これらの各プロパティの機能を示すために設計されています。 <xref:System.Windows.Controls.ItemsControl>この例では、同じバインドされている`Tasks`前の例のようにコレクションです。 デモの目的で、スタイルおよびテンプレートをこの例では、すべてインラインで宣言されてです。  
+  
+ [!code-xml[DataTemplatingIntro_snip#ItemsControlProperties](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataTemplatingIntro_snip/CSharp/Window1.xaml#itemscontrolproperties)]  
+  
+ 以下は、例のスクリーン ショットが表示される場合です。  
+  
+ ![ItemsControl の例のスクリーン ショット](../../../../docs/framework/wpf/data/media/databinding-itemscontrolproperties.png "DataBinding_ItemsControlProperties")  
+  
+ 注意して使用する代わりに、 <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A>、使用することができます、 <xref:System.Windows.Controls.ItemsControl.ItemTemplateSelector%2A>します。 例については、前のセクションを参照してください。 使用する代わりに、同様に、 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyle%2A>を使用するオプションがある、 <xref:System.Windows.Controls.ItemsControl.ItemContainerStyleSelector%2A>します。  
+  
+ 2 つの他のスタイル関連プロパティ、 <xref:System.Windows.Controls.ItemsControl>ここでは表示されていない<xref:System.Windows.Controls.ItemsControl.GroupStyle%2A>と<xref:System.Windows.Controls.ItemsControl.GroupStyleSelector%2A>します。  
+  
+<a name="DataTemplating_HeirarchicalDataTemplate"></a>   
+## <a name="support-for-hierarchical-data"></a>階層データのサポート  
+ これまで説明してきました連結し、単一のコレクションを表示する方法について説明します。 あります他のコレクションを格納するコレクションがあります。 <xref:System.Windows.HierarchicalDataTemplate>クラスは併用できるように設計されています。 <xref:System.Windows.Controls.HeaderedItemsControl>などのデータを表示する型。 次の例で`ListLeagueList`の一覧は、`League`オブジェクトです。 各`League`オブジェクトには、`Name`およびさまざまな`Division`オブジェクトです。 各`Division`が、`Name`およびさまざまな`Team`オブジェクト、および各`Team`オブジェクトには、`Name`です。  
+  
+ [!code-xml[HierarchicalDataTemplateSnippet#HDT](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HierarchicalDataTemplateSnippet/CS/window1.xaml#hdt)]  
+  
+ 使用する、例に示します<xref:System.Windows.HierarchicalDataTemplate>、その他のリストを含んでいるリストのデータを簡単に表示できます。 この例のスクリーン ショットを次に示します。  
+  
+ ![HierarchicalDataTemplate のサンプルのスクリーン ショット](../../../../docs/framework/wpf/data/media/databinding-hierarchicaldatatemplate.png "DataBinding_HierarchicalDataTemplate")  
+  
+## <a name="see-also"></a>関連項目  
+ [データ バインディング](../../../../docs/framework/wpf/advanced/optimizing-performance-data-binding.md)   
+ [DataTemplate によって生成された要素を検索します。](../../../../docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [GridView 列ヘッダーのスタイルとテンプレートの概要](../../../../docs/framework/wpf/controls/gridview-column-header-styles-and-templates-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md b/docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md
new file mode 100644
index 00000000000..80d80ac4a37
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-the-properties-of-two-controls.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 2 つのコントロールのプロパティをバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (2 つのコントロールのプロパティを)"
+  - "コントロール, バインディング プロパティ"
+  - "データ バインディング, バインド (2 つのコントロールのプロパティを)"
+ms.assetid: 06318fac-6afd-4c7d-a277-6d7ef50f47bc
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 2 つのコントロールのプロパティをバインドする
+この例では、<xref:System.Windows.Data.Binding.ElementName%2A> プロパティを使用して、インスタンス化された 1 つのコントロールのプロパティを別のコントロールのプロパティにバインドする方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Canvas> の <xref:System.Windows.Controls.Panel.Background%2A> プロパティを <xref:System.Windows.Controls.ComboBox> の <xref:System.Windows.Controls.Primitives.Selector.SelectedItem%2A>.<xref:System.Windows.Controls.ContentControl.Content%2A> プロパティにバインドする方法を次の例に示します。  
+  
+ [!code-xml[BindDptoDp#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindDPtoDP/CS/Window1.xaml#1)]  
+  
+ この例をレンダリングすると、次のようになります。  
+  
+ ![背景が緑のキャンバス](../../../../docs/framework/wpf/data/media/databindingbindingdpssample.png "DataBindingBindingDPsSample")  
+  
+ **メモ** [バインディング ターゲット](GTMT) プロパティ \(この例では <xref:System.Windows.Controls.Panel.Background%2A> プロパティ\) は、[依存関係プロパティ](GTMT)である必要があります。  詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+## 参照  
+ [バインディング ソースを指定する](../../../../docs/framework/wpf/data/how-to-specify-the-binding-source.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md b/docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md
new file mode 100644
index 00000000000..983123e1cdd
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : コレクションにバインドして選択に基づく情報を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, バインド (コレクションに)"
+  - "データ バインディング, 作成 (データ コレクションのビューを)"
+  - "データ バインディング, 選択 (ビューのデータを)"
+  - "データ コレクション, 選択 (ビューのデータを)"
+ms.assetid: 952a7d76-dd29-49e5-86f5-32c4530e70eb
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : コレクションにバインドして選択に基づく情報を表示する
+簡単なマスター詳細シナリオには、<xref:System.Windows.Controls.ListBox> のようなデータ バインドされた <xref:System.Windows.Controls.ItemsControl> があります。  ユーザー選択に基づいて、選択された項目に関する情報をさらに表示します。  このシナリオを実装する方法を次の例に示します。  
+  
+## 使用例  
+ この例では、`People` は `Person` クラスの <xref:System.Collections.ObjectModel.ObservableCollection%601> です。  この `Person` クラスには、`FirstName`、`LastName`、および `HomeTown` という 3 つのプロパティが含まれ、すべて `string` 型です。  
+  
+ [!code-xml[CollectionBinding#Source](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionBinding/CSharp/Window1.xaml#source)]  
+[!code-xml[CollectionBinding#UI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionBinding/CSharp/Window1.xaml#ui)]  
+  
+ <xref:System.Windows.Controls.ContentControl> は、`Person` の情報の提示方法を定義する、次のような <xref:System.Windows.DataTemplate> を使用します。  
+  
+ [!code-xml[CollectionBinding#DetailTemplate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionBinding/CSharp/Window1.xaml#detailtemplate)]  
+  
+ この例が生成するスクリーンショットを次に示します。  <xref:System.Windows.Controls.ContentControl> は、選択されている人の他のプロパティを示します。  
+  
+ ![コレクションへのバインディング](../../../../docs/framework/wpf/data/media/databinding-collectionbindingsample.png "DataBinding\_CollectionBindingSample")  
+  
+ この例では、次の 2 つの点に注意する必要があります。  
+  
+1.  <xref:System.Windows.Controls.ListBox> と <xref:System.Windows.Controls.ContentControl> は、同じソースにバインドしています。  どちらのコントロールもコレクション オブジェクト全体にバインドしているので、どちらのバインディングの <xref:System.Windows.Data.Binding.Path%2A> プロパティも指定されていません。  
+  
+2.  この例が動作するには、<xref:System.Windows.Controls.Primitives.Selector.IsSynchronizedWithCurrentItem%2A> プロパティを `true` に設定する必要があります。  このプロパティを設定すると、選択されている項目は常に <xref:System.Windows.Controls.ItemCollection.CurrentItem%2A> として設定されます。  または、<xref:System.Windows.Controls.ListBox> が <xref:System.Windows.Data.CollectionViewSource> からデータを取得する場合は、選択と現在の項目が自動的に同期されます。  
+  
+ `Person` クラスが次のように `ToString` メソッドをオーバーライドすることに注意してください。  既定では、<xref:System.Windows.Controls.ListBox> は `ToString` を呼び出して、バインドされたコレクション内の各オブジェクトの文字列表現を表示します。  これにより、各 `Person` は <xref:System.Windows.Controls.ListBox> の名前として表示されます。  
+  
+ [!code-csharp[CollectionBinding#ToString](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionBinding/CSharp/Data.cs#tostring)]
+ [!code-vb[CollectionBinding#ToString](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CollectionBinding/VisualBasic/Person.vb#tostring)]  
+  
+## 参照  
+ [階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)   
+ [階層 XML データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-a-method.md b/docs/framework/wpf/data/how-to-bind-to-a-method.md
new file mode 100644
index 00000000000..ef42cb6dbcc
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-a-method.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : メソッドにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド, メソッド"
+  - "クラス, ObjectDataProvider"
+  - "データ バインディング, バインド (ObjectDataProvider を使用してメソッドに)"
+  - "メソッド, バインド"
+  - "ObjectDataProvider クラス"
+ms.assetid: 5f55e71e-2182-42a0-88d1-700cc1427a7a
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : メソッドにバインドする
+<xref:System.Windows.Data.ObjectDataProvider> を使用してメソッドにバインドする方法の例を次に示します。  
+  
+## 使用例  
+ この例では、`TemperatureScale` はメソッド `ConvertTemp` を持つクラスで、2 つのパラメーター \(1 つは `double` でもう 1 つは `enum` 型 `TempType)` を取得して、指定した値をある温度尺度から他の温度尺度へ変換します。  次の例では、<xref:System.Windows.Data.ObjectDataProvider> を使用して `TemperatureScale` オブジェクトをインスタンス化します。  `ConvertTemp` メソッドは、2 つの指定したパラメーターで呼び出します。  
+  
+ [!code-xml[BindToMethod#WindowResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToMethod/CS/Window1.xaml#windowresources)]  
+  
+ このメソッドはリソースとして使用可能となり、その結果にバインドできます。  次の例では、<xref:System.Windows.Controls.TextBox> の <xref:System.Windows.Controls.TextBox.Text%2A> プロパティと <xref:System.Windows.Controls.ComboBox> の <xref:System.Windows.Controls.Primitives.Selector.SelectedValue%2A> をこのメソッドの 2 つのパラメーターにバインドします。  これにより、ユーザーは、変換する温度と変換前の温度尺度を指定できます。  <xref:System.Windows.Data.Binding.BindsDirectlyToSource%2A> が `true` に設定されることに注意してください。これは、<xref:System.Windows.Data.ObjectDataProvider> \(`TemperatureScale` オブジェクト\) によってラップされたオブジェクトのプロパティではなく、<xref:System.Windows.Data.ObjectDataProvider> インスタンスの <xref:System.Windows.Data.ObjectDataProvider.MethodParameters%2A> プロパティにバインドするためです。  
+  
+ 最後の <xref:System.Windows.Controls.Label> の <xref:System.Windows.Controls.ContentControl.Content%2A> は、ユーザーが <xref:System.Windows.Controls.TextBox> の内容、または <xref:System.Windows.Controls.ComboBox> の選択を変更したときに更新されます。  
+  
+ [!code-xml[BindToMethod#UI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToMethod/CS/Window1.xaml#ui)]  
+  
+ コンバーター `DoubleToString` は、<xref:System.Windows.Data.IValueConverter.Convert%2A> 方向では double を受け取って string に変換し \([バインディング ソース](GTMT)から[バインディング ターゲット](GTMT)である <xref:System.Windows.Controls.TextBox.Text%2A> プロパティへ\)、<xref:System.Windows.Data.IValueConverter.ConvertBack%2A> 方向では `string` を `double` に変換します。  
+  
+ `InvalidationCharacterRule` は無効な文字をチェックする <xref:System.Windows.Controls.ValidationRule> です。  入力値が double 型の値でない場合は、既定のエラー テンプレート \(<xref:System.Windows.Controls.TextBox> の周囲の赤い境界線\) がユーザーへの通知として表示されます。  
+  
+## 参照  
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)   
+ [列挙値にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-an-enumeration.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-a-web-service.md b/docs/framework/wpf/data/how-to-bind-to-a-web-service.md
new file mode 100644
index 00000000000..45f9870b888
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-a-web-service.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : Web サービスにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), Web サービス"
+  - "データ バインド, Web サービス"
+  - "Web サービス バインディング"
+ms.assetid: 77e2d373-69ba-4cbd-b6f5-2c83c38fc98b
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Web サービスにバインドする
+この例では、Web サービス メソッド呼び出しによって返されるオブジェクトにバインドする方法について説明します。  
+  
+## 使用例  
+ この例では、[MSDN\/TechNet Publishing System \(MTPS\) コンテンツ サービス](http://go.microsoft.com/fwlink/?LinkId=95677)を使用して、指定されたドキュメントによってサポートされている言語の一覧を取得します。  
+  
+ Web サービスを呼び出す前に、その Web サービスへの参照を作成する必要があります。  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用して MTPS サービスへの Web 参照を作成するには、次の手順に従います。  
+  
+1.  [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] でプロジェクトを開いてみてください。  
+  
+2.  **\[プロジェクト\]** メニューの **\[Web 参照の追加\]** をクリックします。  
+  
+3.  ダイアログ ボックスで、**\[URL\]** を「[http:\/\/services.msdn.microsoft.com\/contentservices\/contentservice.asmx?wsdl](http://services.msdn.microsoft.com/contentservices/contentservice.asmx?wsdl)」に設定します。  
+  
+4.  **\[移動\]** をクリックし、**\[参照の追加\]** をクリックします。  
+  
+ 次に、Web サービス メソッドを呼び出し、適切なコントロールまたはウィンドウの <xref:System.Windows.FrameworkElement.DataContext%2A> を、返されたオブジェクトに設定します。  MTPS サービスの **GetContent** メソッドは、**getContentRequest** オブジェクトへの参照を受け取ります。  そのため、次の例では、まず要求オブジェクトを設定しています。  
+  
+ [!code-csharp[BindToWebService#Namespace](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToWebService/CSharp/Window1.xaml.cs#namespace)]
+ [!code-vb[BindToWebService#Namespace](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BindToWebService/VisualBasic/Window1.xaml.vb#namespace)]  
+[!code-csharp[BindToWebService#WebServiceCall](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToWebService/CSharp/Window1.xaml.cs#webservicecall)]
+[!code-vb[BindToWebService#WebServiceCall](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BindToWebService/VisualBasic/Window1.xaml.vb#webservicecall)]  
+  
+ <xref:System.Windows.FrameworkElement.DataContext%2A> を設定したら、<xref:System.Windows.FrameworkElement.DataContext%2A> が設定されているオブジェクトのプロパティへのバインディングを作成できます。  この例では、<xref:System.Windows.FrameworkElement.DataContext%2A> は **GetContent** メソッドによって返された **getContentResponse** オブジェクトに設定されます。  次の例では、<xref:System.Windows.Controls.ItemsControl> は **getContentResponse** の **availableVersionsAndLocales** の **locale** 値にバインドされ、その値が表示されます。  
+  
+ [!code-xml[BindToWebService#Binding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToWebService/CSharp/Window1.xaml#binding)]  
+  
+ **getContentResponse** の構造の詳細については、[Content Service のドキュメント](http://services.msdn.microsoft.com/ContentServices/ContentService.asmx)を参照してください。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)   
+ [XAML でデータをバインディング可能にする](../../../../docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-an-ado-net-data-source.md b/docs/framework/wpf/data/how-to-bind-to-an-ado-net-data-source.md
new file mode 100644
index 00000000000..a2c8459b4e2
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-an-ado-net-data-source.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : ADO.NET データ ソースにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ADO.NET データ ソース, バインド"
+  - "バインド, ADO.NET データ ソース"
+  - "データ バインディング, バインド (ADO.NET データ ソースに)"
+ms.assetid: a70c6d7b-7b38-4fdf-b655-4804db7c8315
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ADO.NET データ ソースにバインドする
+この例では、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] <xref:System.Windows.Controls.ListBox> コントロールを [!INCLUDE[TLA#tla_adonet](../../../../includes/tlasharptla-adonet-md.md)] `DataSet` にバインドする方法を示します。  
+  
+## 使用例  
+ ここでは、データ ソース \(接続文字列で指定された `Access MDB` ファイル\) に接続するために、`OleDbConnection` オブジェクトを使用します。  接続が確立されると、その後、`OleDbDataAdpater` オブジェクトが作成されます。  `OleDbDataAdpater` オブジェクトは、select [!INCLUDE[TLA#tla_sql](../../../../includes/tlasharptla-sql-md.md)] ステートメントを使用して、データベースからレコードセットを取得します。  [!INCLUDE[TLA2#tla_sql](../../../../includes/tla2sharptla-sql-md.md)] コマンドの結果は、 `OleDbDataAdapter` の `Fill` メソッドを呼び出して、`DataSet` の `DataTable` に格納されます。  この例の `DataTable` には、`BookTable` という名前が付いています。  また、この例では、<xref:System.Windows.Controls.ListBox> の <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティを `DataSet` オブジェクトに設定します。  
+  
+ [!code-csharp[ADODataSet#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ADODataSet/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[ADODataSet#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ADODataSet/VisualBasic/Window1.xaml.vb#1)]  
+  
+ これで、<xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを、`DataSet` の `BookTable` にバインドできます。  
+  
+ [!code-xml[ADODataSet#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ADODataSet/CSharp/Window1.xaml#2)]  
+  
+ `BookItemTemplate` は、データがどのように表示されるかを定義する <xref:System.Windows.DataTemplate> です。  
+  
+ [!code-xml[ADODataSet#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ADODataSet/CSharp/Window1.xaml#3)]  
+  
+ `IntColorConverter` は、`int` を 1 つの色に変換します。  このコンバーターを使用すると、3 つ目の <xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.Controls.TextBlock.Background%2A> の色は、`NumPages` の値が 350 未満の場合は緑で、それ以外の場合は赤で表示されます。  コンバーターの実装は、ここでは示されていません。  
+  
+## 参照  
+ <xref:System.Windows.Data.BindingListCollectionView>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-an-enumeration.md b/docs/framework/wpf/data/how-to-bind-to-an-enumeration.md
new file mode 100644
index 00000000000..515cac79e1e
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-an-enumeration.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : 列挙値にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 列挙型"
+  - "データ バインド, 列挙型"
+  - "列挙型"
+ms.assetid: b9091eba-1119-424e-868b-d1a4168b3732
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 列挙値にバインドする
+この例では、列挙体の GetValues メソッドを使用して列挙値にバインドする方法について説明します。  
+  
+## 使用例  
+ 次の例では、データ バインディングを使用して、<xref:System.Windows.Controls.ListBox> に <xref:System.Windows.HorizontalAlignment> 列挙値の一覧を表示します。  <xref:System.Windows.Controls.ListBox> と <xref:System.Windows.Controls.Button> は、<xref:System.Windows.Controls.ListBox> で値を選択することによって <xref:System.Windows.Controls.Button> の <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> プロパティ値を変更できるようにバインドされています。  
+  
+ [!code-xml[BindToEnum#BindToEnum](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindToEnum/CS/Window1.xaml#bindtoenum)]  
+  
+## 参照  
+ [メソッドにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-a-method.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-the-results-of-a-linq-query.md b/docs/framework/wpf/data/how-to-bind-to-the-results-of-a-linq-query.md
new file mode 100644
index 00000000000..d4b783b59e5
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-the-results-of-a-linq-query.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : LINQ クエリの結果にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (LINQ クエリの結果に) [WPF]"
+  - "実行 (LINQ クエリを) [WPF], バインド (結果に)"
+ms.assetid: ff2844d9-17ed-4ea6-aab1-5111af0bc684
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : LINQ クエリの結果にバインドする
+この例では、LINQ クエリを実行し、その結果にバインドする方法について説明します。  
+  
+## 使用例  
+ 次の例では、2 つのリスト ボックスを作成します。  最初のリスト ボックスには 3 つのリスト項目が含まれます。  
+  
+ [!code-xml[LinqExample#UI](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LinqExample/CSharp/Window1.xaml#ui)]  
+  
+ 最初のリスト ボックスから項目を選択すると、次のイベント ハンドラーが呼び出されます。  この例では、`Tasks` は `Task` オブジェクトのコレクションです。  `Task` クラスには、`Priority` という名前のプロパティがあります。  このイベント ハンドラーは、優先順位値が選択された `Task` オブジェクトのコレクションを返す LINQ クエリを実行し、それを <xref:System.Windows.FrameworkElement.DataContext%2A> として設定します。  
+  
+ [!code-csharp[LinqExample#Using](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LinqExample/CSharp/Window1.xaml.cs#using)]  
+[!code-csharp[LinqExample#Tasks](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LinqExample/CSharp/Window1.xaml.cs#tasks)]  
+[!code-csharp[LinqExample#Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/LinqExample/CSharp/Window1.xaml.cs#handler)]  
+  
+ 2 つ目のリスト ボックスは、<xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> 値が `{Binding}` に設定されているため、そのコレクションにバインドされます。  その結果、返されたコレクションが `myTaskTemplate` <xref:System.Windows.DataTemplate> に基づいて表示されます。  
+  
+## 参照  
+ [XAML でデータをバインディング可能にする](../../../../docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md)   
+ [コレクションにバインドして選択に基づく情報を表示する](../../../../docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md)   
+ [WPF Version 4.5 の新機能](../../../../docs/framework/wpf/getting-started/whats-new.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md b/docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md
new file mode 100644
index 00000000000..f6d9ed16b42
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : XDocument、XElement、または LINQ for XML クエリの結果にバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング [WPF], バインド (XDocument に)"
+  - "データ バインディング [WPF], バインド (XElement に)"
+ms.assetid: 6a629a49-fe1c-465d-b76a-3dcbf4307b64
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : XDocument、XElement、または LINQ for XML クエリの結果にバインドする
+この例は、<xref:System.Xml.Linq.XDocument> を使用して XML データを <xref:System.Windows.Controls.ItemsControl> にバインドする方法を示しています。  
+  
+## 使用例  
+ 次の XAML コードは、<xref:System.Windows.Controls.ItemsControl> を定義し、`Planet` 型のデータ用のデータ テンプレートを `http://planetsNS` XML 名前空間に含めます。  名前空間を占有する XML データ型では、名前空間をかっこで囲んで含める必要があります。また、その XML データ型が XAML マークアップ拡張機能が出現する可能性がある場所に出現する場合は、名前空間の前に、かっこのエスケープ シーケンスを使用して指定する必要があります。  このコードは、<xref:System.Xml.Linq.XElement> クラスの <xref:System.Xml.Linq.XContainer.Element%2A> メソッドと <xref:System.Xml.Linq.XElement.Attribute%2A> メソッドに対応する動的プロパティにバインドします。  動的プロパティによって、XAML がこれらのメソッドの名前を共有する動的プロパティにバインドできます。  詳細については、「[LINQ to XML の動的プロパティ](../Topic/LINQ%20to%20XML%20Dynamic%20Properties.md)」を参照してください。  XML 用の既定の名前空間宣言が属性名には適用されないことに注意してください。  
+  
+ [!code-xml[XLinqExample#StackPanelResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml#stackpanelresources)]  
+[!code-xml[XLinqExample#ItemsControl](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml#itemscontrol)]  
+  
+ 次の C\# コードは、<xref:System.Xml.Linq.XDocument.Load%2A> を呼び出し、スタック パネルのデータ コンテキストを `http://planetsNS` XML 名前空間内の `SolarSystemPlanets` という名前の要素のすべてのサブ要素に設定します。  
+  
+ [!code-csharp[XLinqExample#LoadDCFromFile](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml.cs#loaddcfromfile)]
+ [!code-vb[XLinqExample#LoadDCFromFile](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XLinqExample/visualbasic/window1.xaml.vb#loaddcfromfile)]  
+  
+ XML データは、<xref:System.Windows.Data.ObjectDataProvider> を使用して XAML リソースとして格納することができます。  コード例全体については、「[L2DBForm.xaml ソース コード](../Topic/L2DBForm.xaml%20Source%20Code.md)」を参照してください。  次の例は、コードでデータ コンテキストをオブジェクト リソースに設定する方法を示しています。  
+  
+ [!code-csharp[XLinqExample#LoadDCFromXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml.cs#loaddcfromxaml)]
+ [!code-vb[XLinqExample#LoadDCFromXAML](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XLinqExample/visualbasic/window1.xaml.vb#loaddcfromxaml)]  
+  
+ <xref:System.Xml.Linq.XContainer.Element%2A> および <xref:System.Xml.Linq.XElement.Attribute%2A> にマップされる動的プロパティによって、XAML 内での柔軟性が提供されます。  コードを LINQ for XML クエリの結果にバインドすることもできます。  この例では、要素の値によって並べられたクエリ結果にバインドします。  
+  
+ [!code-csharp[XLinqExample#BindToResults](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml.cs#bindtoresults)]
+ [!code-vb[XLinqExample#BindToResults](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/XLinqExample/visualbasic/window1.xaml.vb#bindtoresults)]  
+  
+## 参照  
+ [バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)   
+ [LINQ to XML による WPF のデータ バインドの概要](../Topic/WPF%20Data%20Binding%20with%20LINQ%20to%20XML%20Overview.md)   
+ [LINQ to XML を使用した WPF のデータ バインドの例](../Topic/WPF%20Data%20Binding%20Using%20LINQ%20to%20XML%20Example.md)   
+ [LINQ to XML の動的プロパティ](../Topic/LINQ%20to%20XML%20Dynamic%20Properties.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md b/docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md
new file mode 100644
index 00000000000..f89a5a07e23
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : XMLDataProvider と XPath クエリを使用して XML データにバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド, XML データに (XmlDataProvider クエリを使用)"
+  - "データ バインディング, バインド (XmlDataProvider クエリを使用して XML データに)"
+  - "XmlDataProvider, バインド (XML データに)"
+ms.assetid: 7dcd018f-16aa-4870-8e47-c1b4ea31e574
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : XMLDataProvider と XPath クエリを使用して XML データにバインドする
+この例では、<xref:System.Windows.Data.XmlDataProvider> を使用して [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] データにバインドする方法を示します。  
+  
+ <xref:System.Windows.Data.XmlDataProvider> を使用して、アプリケーションでデータ バインディングを介してアクセスできる基になるデータは、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ノードの任意のツリーです。  つまり、<xref:System.Windows.Data.XmlDataProvider> とは、[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] ノードの任意のツリーを[バインディング ソース](GTMT)として使用するための便利な手段です。  
+  
+## 使用例  
+ 次の例では、データは [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データ アイランドとして直接 <xref:System.Windows.FrameworkElement.Resources%2A> セクションに埋め込まれています。  [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データ アイランドは、`<x:XData>` タグ内にラップされていることと、常にルート ノードを 1 つだけ \(この例では *Inventory*\) 持つことが必要です。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データのルート ノードには **xmlns** 属性があり、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間が空の文字列に設定されています。  これは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページ内にインラインで配置されるデータ アイランドに XPath クエリを適用する場合の必須事項です。  このインラインの場合は、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] と、必然的にデータ アイランドも <xref:System.Windows> 名前空間を継承します。  このため、XPath クエリが <xref:System.Windows> 名前空間によって修飾されることを防ぐために、名前空間を空白に設定する必要があります。このようにしなければ、クエリの検索範囲が本来のものとは異なってしまいます。  
+  
+ [!code-xml[XMLDataSource#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XmlDataSource/CS/Window1.xaml#1)]  
+  
+ この例に示すように、同じバインディング宣言を属性構文で作成するには、特殊文字を適切にエスケープする必要があります。  詳細については、「[XML 文字エンティティと XAML](../../../../docs/framework/xaml-services/xml-character-entities-and-xaml.md)」を参照してください。  
+  
+ この例を実行すると、次の項目が <xref:System.Windows.Controls.ListBox> に表示されます。  これらは、*Books* の下のすべての要素のうち、*Stock* の値が "*out*" か、*Number* の値が 3 に等しいか 8 以上のものの *Title* です。  *CD* の項目が 1 つも返されないのは、<xref:System.Windows.Data.XmlDataProvider> の <xref:System.Windows.Data.XmlDataProvider.XPath%2A> の設定値が、*Books* 要素のみを公開するように指定されている \(フィルターを設定することと同じ\) からです。  
+  
+ ![XPath の例](../../../../docs/framework/wpf/data/media/xpathexample.png "XPathExample")  
+  
+ この例で書籍のタイトルが表示されるのは、<xref:System.Windows.DataTemplate> 内の <xref:System.Windows.Controls.TextBlock> バインディングの <xref:System.Windows.Data.Binding.XPath%2A> が "*Title*" に設定されているためです。  属性、たとえば *ISBN* の値を表示するには、<xref:System.Windows.Data.Binding.XPath%2A> の値を "`@ISBN`" に設定します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 内の **XPath** プロパティは、XmlNode.SelectNodes メソッドによって処理されます。  別の結果を得るために、**XPath** クエリを変更することもできます。  前の例での、バインドされた <xref:System.Windows.Controls.ListBox> に対する <xref:System.Windows.Data.Binding.XPath%2A> クエリの例を次に示します。  
+  
+-   `XPath="Book[1]"` は、最初の書籍要素 \("XML in Action"\) を返します。  **XPath** のインデックスが 0 ではなく 1 から開始することに注意してください。  
+  
+-   `XPath="Book[@*]"` は、任意の属性を持つすべての書籍要素を返します。  
+  
+-   `XPath="Book[last()-1]"` は、最後から 2 番目の書籍要素 \("Introducing Microsoft .NET"\) を返します。  
+  
+-   `XPath="*[position()>3]"` は、最初の 3 つを除くすべての書籍要素を返します。  
+  
+ **XPath** クエリを実行すると、1 つの <xref:System.Xml.XmlNode> または XmlNode のリストが返されます。  <xref:System.Xml.XmlNode> は[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトです。つまり、<xref:System.Windows.Data.Binding.Path%2A> プロパティを使用して[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] のプロパティにバインドできます。  前の例をもう一度考えてみます。  例の残りの部分はそのままで <xref:System.Windows.Controls.TextBlock> バインディングを次のように変更すると、返された XmlNode の名前が <xref:System.Windows.Controls.ListBox> に表示されます。  この場合、返されたノードの名前はすべて "*Book*" です。  
+  
+ [!code-xml[XmlDataSourceVariation#XmlNodePath](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XmlDataSourceVariation/CS/Page1.xaml#xmlnodepath)]  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ページのソースに [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] をデータ アイランドとして埋め込む方法では、コンパイルの時点で正確なデータ コンテンツが必要となるので、アプリケーションによっては不都合が生じます。  したがって、次の例のように、外部ファイル [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] からデータを取得する機能もサポートされています。  
+  
+ [!code-xml[XMLDataSource2#XmlFileExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XmlDataSource2/CS/Window1.xaml#xmlfileexample)]  
+  
+ [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データがリモートの [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ファイル内に存在する場合は、次のように、適切な [!INCLUDE[TLA2#tla_url](../../../../includes/tla2sharptla-url-md.md)] を <xref:System.Windows.Data.XmlDataProvider.Source%2A> 属性に割り当てることによってデータへのアクセスを定義します。  
+  
+```  
+<XmlDataProvider x:Key="BookData" Source="http://MyUrl" XPath="Books"/>  
+```  
+  
+## 参照  
+ <xref:System.Windows.Data.ObjectDataProvider>   
+ [XDocument、XElement、または LINQ for XML クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md)   
+ [階層 XML データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md)   
+ [バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-clear-bindings.md b/docs/framework/wpf/data/how-to-clear-bindings.md
new file mode 100644
index 00000000000..e0caf6207a8
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-clear-bindings.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : バインディングをクリアする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディング, クリア"
+  - "クリア (バインディングを)"
+  - "データ バインディング, クリア (バインディングを)"
+ms.assetid: 73962a93-32a9-4bcd-9240-bcfbb239093a
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : バインディングをクリアする
+この例では、オブジェクトからバインディングをクリアする方法を示します。  
+  
+## 使用例  
+ オブジェクトの個々のプロパティからバインディングをクリアするには、次の例で示すように、<xref:System.Windows.Data.BindingOperations.ClearBinding%2A> を呼び出します。  次の例では、<xref:System.Windows.Controls.TextBlock> オブジェクトである *mytext* の <xref:System.Windows.Controls.TextBlock.TextProperty> からバインディングを削除します。  
+  
+ [!code-csharp[CodeOnlyBinding#ClearBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CodeOnlyBinding/CSharp/binding.cs#clearbinding)]
+ [!code-vb[CodeOnlyBinding#ClearBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CodeOnlyBinding/VisualBasic/App.vb#clearbinding)]  
+  
+ バインディングをクリアすると、バイディングが削除され、[依存関係プロパティ](GTMT)の値は、バインディングが存在していなかったときの値に変更されます。  この値は、既定値、継承された値、データ テンプレート バインディングの値などです。  
+  
+ オブジェクトのすべてのプロパティからバインディングをクリアするには、<xref:System.Windows.Data.BindingOperations.ClearAllBindings%2A> を使用します。  
+  
+## 参照  
+ <xref:System.Windows.Data.BindingOperations>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md b/docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md
new file mode 100644
index 00000000000..83c214c940c
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : TextBox テキストでソースを更新するタイミングを制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, タイミング (ソースの更新の)"
+  - "ソースの更新, タイミング"
+  - "タイミング (ソースの更新の)"
+ms.assetid: ffb7b96a-351d-4c68-81e7-054033781c64
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : TextBox テキストでソースを更新するタイミングを制御する
+ここでは、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティを使用して、[バインディング ソース](GTMT)の更新のタイミングを制御する方法について説明します。  例として、ここでは <xref:System.Windows.Controls.TextBox> コントロールを使用します。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.TextBox>.<xref:System.Windows.Controls.TextBox.Text%2A> プロパティの <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> の既定値は <xref:System.Windows.Data.UpdateSourceTrigger> です。  つまり、アプリケーションに、データ バインドされていた <xref:System.Windows.Controls.TextBox>.<xref:System.Windows.Controls.TextBox.Text%2A> プロパティを持つ <xref:System.Windows.Controls.TextBox> がある場合、<xref:System.Windows.Controls.TextBox> に入力するテキストによってソースが更新されるのは、<xref:System.Windows.Controls.TextBox> にフォーカスがなくなったときです \(たとえば、<xref:System.Windows.Controls.TextBox> から離れた位置でクリックしたとき\)。  
+  
+ 入力すると同時にソースを更新するには、バインディングの <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> を <xref:System.Windows.Data.UpdateSourceTrigger> に設定します。  次の例では、<xref:System.Windows.Controls.TextBox> および <xref:System.Windows.Controls.TextBlock> の両方の `Text` プロパティが同じソース プロパティにバインドされています。  <xref:System.Windows.Controls.TextBox> バインディングの <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティは、<xref:System.Windows.Data.UpdateSourceTrigger> に設定されています。  
+  
+ [!code-xml[SimpleBinding#USTHowTo](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleBinding/VisualBasic/Page1.xaml#usthowto)]  
+  
+ 結果として、次のスクリーンショットの例に示すように、<xref:System.Windows.Controls.TextBlock> は、ユーザーが <xref:System.Windows.Controls.TextBox> に入力したのと同じテキストを表示します \(ソースが変更されるため\)。  
+  
+ ![単純なデータ バインディングのサンプルのスクリーンショット](../../../../docs/framework/wpf/data/media/databindingsimplebindingsample2.png "DataBindingSimpleBindingSample2")  
+  
+ ダイアログまたはユーザーが編集できるフォームがあり、ユーザーがフィールドの編集を終えて \[OK\] をクリックするまでソースの更新を遅延させる場合は、次の例のように、バインディングの <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値を <xref:System.Windows.Data.UpdateSourceTrigger> に設定します。  
+  
+ [!code-xml[UpdateSource#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UpdateSource/CSharp/Window1.xaml#2)]  
+  
+ <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> 値を <xref:System.Windows.Data.UpdateSourceTrigger> に設定すると、アプリケーションが <xref:System.Windows.Data.BindingExpression.UpdateSource%2A> メソッドを呼び出す場合にのみソース値が変化します。  `itemNameTextBox` の <xref:System.Windows.Data.BindingExpression.UpdateSource%2A> を呼び出す方法を次の例に示します。  
+  
+ [!code-csharp[UpdateSource#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UpdateSource/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[UpdateSource#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UpdateSource/VisualBasic/Window1.xaml.vb#1)]  
+  
+> [!NOTE]
+>  同じ方法を他のコントロールのプロパティにも使用できますが、大多数の他のプロパティには <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> の既定値の <xref:System.Windows.Data.UpdateSourceTrigger> が設定されているので注意が必要です。  詳細については、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティのページを参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティはソースの更新を扱うため、<xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> のバインディングにのみ関連します。  <xref:System.Windows.Data.BindingMode> バインディングと <xref:System.Windows.Data.BindingMode> バインディングが動作するには、ソース オブジェクトがプロパティ変更通知を提供する必要があります。  詳細については、このトピック内にあるサンプルを参照してください。  また、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」も参照してください。  
+  
+## 参照  
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-convert-bound-data.md b/docs/framework/wpf/data/how-to-convert-bound-data.md
new file mode 100644
index 00000000000..70bfbc586dc
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-convert-bound-data.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : バインドされたデータを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 変換 (バインドされたデータを)"
+  - "変換, バインドされたデータ"
+  - "データ バインディング, 変換 (バインドされたデータを)"
+ms.assetid: b00aaa19-c6df-4c3b-a9fd-88a0b488df2b
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : バインドされたデータを変換する
+この例では、バインディングで使用するデータに変換を適用する方法を示します。  
+  
+ バインディング中にデータを変換するには、<xref:System.Windows.Data.IValueConverter> インターフェイスを実装するクラスを作成する必要があります。このインターフェイスには、<xref:System.Windows.Data.IValueConverter.Convert%2A> メソッドや <xref:System.Windows.Data.IValueConverter.ConvertBack%2A> メソッドなどが用意されています。  
+  
+## 使用例  
+ 渡された日付の値を変換し、年、月、日だけを表示する日付コンバーターの実装を次の例に示します。  <xref:System.Windows.Data.IValueConverter> インターフェイスを実装する際、次の例のように、実装を <xref:System.Windows.Data.ValueConversionAttribute> 属性で修飾し、変換に関連するデータ型を開発ツールに示すことをお勧めします。  
+  
+ [!code-csharp[DataBindingLab#18](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/DateConverter.cs#18)]
+ [!code-vb[DataBindingLab#18](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/DateConverter.vb#18)]  
+  
+ コンバーターを作成したら、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ファイル内でリソースとしてそのコンバーターを追加できます。  次の例では、*DateConverter* が定義される名前空間に *src* を割り当てます。  
+  
+ [!code-xml[DataBindingLab#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/DataBindingLabApp.xaml#15)]  
+  
+ 最後に、次の構文を使用して、このコンバーターをバインディングで使用できます。  次の例では、<xref:System.Windows.Controls.TextBlock> のテキスト コンテンツは、外部データ ソースのプロパティである *StartDate* にバインドされています。  
+  
+ [!code-xml[DataBindingLab#17](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/DataBindingLabApp.xaml#17)]  
+  
+ 上の例で参照したスタイル リソースは、ここでは示していないリソース セクションで定義されます。  
+  
+## 参照  
+ [バインディングの検証の実装](../../../../docs/framework/wpf/data/how-to-implement-binding-validation.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-create-a-binding-in-code.md b/docs/framework/wpf/data/how-to-create-a-binding-in-code.md
new file mode 100644
index 00000000000..de6f86b644e
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-create-a-binding-in-code.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : コードでバインディングを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 作成"
+  - "データ バインディング, 作成"
+ms.assetid: 1a606db9-cf5f-42ed-a1c5-9e4722ec77a0
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# 方法 : コードでバインディングを作成する
+コードで <xref:System.Windows.Data.Binding> を作成して設定する方法を次の例に示します。  
+  
+## 使用例  
+ <xref:System.Windows.FrameworkElement> クラスと <xref:System.Windows.FrameworkContentElement> クラスはどちらも `SetBinding` メソッドを公開しています。  どちらかのクラスを継承する要素をバインドする場合は、<xref:System.Windows.FrameworkElement.SetBinding%2A> メソッドを直接呼び出すことができます。  
+  
+ 次の例では、`MyDataProperty` という名前のプロパティを含む `MyData` という名前のクラスを作成しています。  
+  
+ [!code-csharp[CodeOnlyBinding#DataObject](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CodeOnlyBinding/CSharp/MyData.cs#dataobject)]
+ [!code-vb[CodeOnlyBinding#DataObject](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CodeOnlyBinding/VisualBasic/MyData.vb#dataobject)]  
+  
+ バインディングのソースを設定するためにバインディング オブジェクトを作成する方法を次の例に示します。  この例では、<xref:System.Windows.FrameworkElement.SetBinding%2A> を使用して、<xref:System.Windows.Controls.TextBlock> コントロールである `myText` の <xref:System.Windows.Controls.TextBlock.Text%2A> プロパティを `MyDataProperty` にバインドします。  
+  
+ [!code-csharp[CodeOnlyBinding#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CodeOnlyBinding/CSharp/binding.cs#1)]
+ [!code-vb[CodeOnlyBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CodeOnlyBinding/VisualBasic/App.vb#1)]  
+  
+ コード サンプル全体については、「[Code\-only Binding Sample](http://msdn.microsoft.com/ja-jp/764aaf0b-2216-4941-9548-9c98da18d1a6)」を参照してください。  
+  
+ <xref:System.Windows.FrameworkElement.SetBinding%2A> を呼び出す代わりに、<xref:System.Windows.Data.BindingOperations> クラスの <xref:System.Windows.Data.BindingOperations.SetBinding%2A> 静的メソッドを使用できます。  次の例では、<xref:System.Windows.FrameworkElement.SetBinding%2A?displayProperty=fullName> の代わりに <xref:System.Windows.Data.BindingOperations.SetBinding%2A?displayProperty=fullName> を呼び出して、`myText` を `myDataProperty` にバインドします。  
+  
+ [!code-csharp[CodeOnlyBinding#BOSetBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CodeOnlyBinding/CSharp/binding.cs#bosetbinding)]
+ [!code-vb[CodeOnlyBinding#BOSetBinding](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CodeOnlyBinding/VisualBasic/App.vb#bosetbinding)]  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-create-a-simple-binding.md b/docs/framework/wpf/data/how-to-create-a-simple-binding.md
new file mode 100644
index 00000000000..d96e410a671
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-create-a-simple-binding.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 簡単なバインディングを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), 作成"
+  - "データ バインディング, 作成 (単純バインディングを)"
+  - "単純バインディング, 作成"
+ms.assetid: 69b80f72-6259-44cb-8294-5bdcebca1e08
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 簡単なバインディングを作成する
+簡単な <xref:System.Windows.Data.Binding> を作成する方法を次の例に示します。  
+  
+## 使用例  
+ この例では、`PersonName` という名前の文字列プロパティを持つ `Person` オブジェクトがあります。  この `Person` オブジェクトは、`SDKSample` という名前空間で定義されます。  
+  
+ `Joe` という `PersonName` プロパティ値を使用して `Person` オブジェクトをインスタンス化する例を次に示します。  これは、`Resources` セクションで実行され、`x:Key` が割り当てられます。  
+  
+ [!code-xml[SimpleBinding#Instantiation](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#instantiation)]  
+[!code-xml[SimpleBinding#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#2)]  
+[!code-xml[SimpleBinding#EndWindow](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#endwindow)]  
+  
+ `PersonName` プロパティをバインドするには、次の操作を実行します。  
+  
+ [!code-xml[SimpleBinding#BDO1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#bdo1)]  
+  
+ 結果として、<xref:System.Windows.Controls.TextBlock> には値 "Joe" が表示されます。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md b/docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md
new file mode 100644
index 00000000000..795f2eb0aff
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-create-and-bind-to-an-observablecollection.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : ObservableCollection を作成およびバインドする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, ObservableCollection"
+  - "データ バインディング, ObservableCollection クラス"
+  - "通知"
+ms.assetid: 6cf7e275-df76-41c6-a611-53b889b8fd5a
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ObservableCollection を作成およびバインドする
+この例では、項目が追加または削除されたときに通知するコレクション クラスである <xref:System.Collections.ObjectModel.ObservableCollection%601> クラスから派生したコレクションを作成およびバインドする方法を示します。  
+  
+## 使用例  
+ `NameList` コレクションの実装例を次に示します。  
+  
+ [!code-csharp[MultiBinding#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[MultiBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MultiBinding/VisualBasic/NameList.vb#1)]  
+  
+ このコレクションをバインディングに使用できるようにする方法は、「[XAML でデータをバインディング可能にする](../../../../docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md)」で説明した、他の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトの場合と同様です。  たとえば、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でコレクションをインスタンス化し、次に示すように、そのコレクションをリソースとして指定します。  
+  
+ [!code-xml[MultiBinding#OCHowTo](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#ochowto)]  
+[!code-xml[MultiBinding#Resources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#resources2)]  
+  
+ その後、次の方法でコレクションにバインドできます。  
+  
+ [!code-xml[MultiBinding#MultiBindingListBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#multibindinglistbox)]  
+  
+ `NameItemTemplate` の定義は、ここには示していません。  
+  
+> [!NOTE]
+>  コレクション内のオブジェクトは、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」で説明されている要件を満たす必要があります。  特に、<xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> \(たとえば、ソース プロパティが動的に変更される場合は [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を更新する必要がある\) を使用している場合には、<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスなどの、適切なプロパティ変更通知機構を実装する必要があります。  
+  
+ 詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」の「コレクションへのバインド」を参照してください。  
+  
+## 参照  
+ [ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)   
+ [ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)   
+ [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-filter-data-in-a-view.md b/docs/framework/wpf/data/how-to-filter-data-in-a-view.md
new file mode 100644
index 00000000000..6739292e21a
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-filter-data-in-a-view.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : ビュー内のデータをフィルター処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, フィルター処理 (ビュー内のデータを)"
+  - "フィルター処理 (ビュー内のデータを)"
+  - "ビュー, フィルター処理 (データを)"
+ms.assetid: c76e8606-4cc4-45a8-9110-e2ec66dc6afd
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ビュー内のデータをフィルター処理する
+この例では、ビュー内のデータをフィルター処理する方法を示します。  
+  
+## 使用例  
+ フィルターを作成するには、フィルター処理ロジックを提供するメソッドを定義します。  このメソッドは、コールバックとして使用され、`object` 型のパラメーターを受け取ります。  次のメソッドは、残りのオブジェクトをフィルターで除外し、`filled` プロパティが "No" に設定されたすべての `Order` オブジェクトを返します。  
+  
+ [!code-csharp[SortFilter#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SortFilter/CSharp/Page1.xaml.cs#2)]
+ [!code-vb[SortFilter#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SortFilter/VisualBasic/Page1.xaml.vb#2)]  
+  
+ 次の例に示すように、フィルターを適用できます。  この例では、`myCollectionView` は、<xref:System.Windows.Data.ListCollectionView> オブジェクトです。  
+  
+ [!code-csharp[SortFilter#Filter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SortFilter/CSharp/Page1.xaml.cs#filter)]
+ [!code-vb[SortFilter#Filter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SortFilter/VisualBasic/Page1.xaml.vb#filter)]  
+  
+ フィルターを解除するには、<xref:System.Windows.Data.CollectionView.Filter%2A> プロパティを `null` に設定できます。  
+  
+ [!code-csharp[SortFilter#Unfilter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SortFilter/CSharp/Page1.xaml.cs#unfilter)]
+ [!code-vb[SortFilter#Unfilter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SortFilter/VisualBasic/Page1.xaml.vb#unfilter)]  
+  
+ ビューを作成または取得する方法については、「[データ コレクションの既定のビューを取得する](../../../../docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md)」を参照してください。  サンプル全体については、[ビューでの項目の並べ替えおよびフィルター処理のサンプル](http://go.microsoft.com/fwlink/?LinkID=160040)を参照してください。  
+  
+ ビュー オブジェクトが <xref:System.Windows.Data.CollectionViewSource> オブジェクトから生成された場合は、<xref:System.Windows.Data.CollectionViewSource.Filter> イベントのイベント ハンドラーを設定することによりフィルター処理ロジックを適用します。  次の例では、`listingDataView` は <xref:System.Windows.Data.CollectionViewSource> のインスタンスです。  
+  
+ [!code-csharp[DataBindingLab#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#10)]
+ [!code-vb[DataBindingLab#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#10)]  
+  
+ `ShowOnlyBargainsFilter` フィルター イベント ハンドラーの実装例を次に示します。  このイベント ハンドラーは、<xref:System.Windows.Data.FilterEventArgs.Accepted%2A> プロパティを使用して、`CurrentPrice` が 25 ドル以上の `AuctionItem` オブジェクトをフィルターで除外します。  
+  
+ [!code-csharp[DataBindingLab#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DataBindingLab/CSharp/MainWindow.xaml.cs#5)]
+ [!code-vb[DataBindingLab#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DataBindingLab/VisualBasic/MainWindow.xaml.vb#5)]  
+  
+## 参照  
+ <xref:System.Windows.Data.CollectionView.CanFilter%2A>   
+ <xref:System.Windows.Data.BindingListCollectionView.CustomFilter%2A>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md b/docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md
new file mode 100644
index 00000000000..9115fec81ea
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-find-datatemplate-generated-elements.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : DataTemplate によって生成された要素を検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DataTemplate"
+  - "検索 (DataTemplate 要素を)"
+ms.assetid: bfcd564e-5e9e-451e-8641-a9b5c3cfac90
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : DataTemplate によって生成された要素を検索する
+この例では、<xref:System.Windows.DataTemplate> によって生成された要素の検索方法について説明します。  
+  
+## 使用例  
+ この例には、ある [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにバインドされた <xref:System.Windows.Controls.ListBox> が存在します。  
+  
+ [!code-xml[FindGeneratedItems#LB](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml#lb)]  
+  
+ この <xref:System.Windows.Controls.ListBox> は、次の <xref:System.Windows.DataTemplate> を使用します。  
+  
+ [!code-xml[FindGeneratedItems#DT](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml#dt)]  
+  
+ ある <xref:System.Windows.Controls.ListBoxItem> の <xref:System.Windows.DataTemplate> によって生成された <xref:System.Windows.Controls.TextBlock> 要素を取得するには、<xref:System.Windows.Controls.ListBoxItem> を取得し、その <xref:System.Windows.Controls.ListBoxItem> 内で <xref:System.Windows.Controls.ContentPresenter> を検索し、その <xref:System.Windows.Controls.ContentPresenter> に設定されている <xref:System.Windows.DataTemplate> に対して <xref:System.Windows.FrameworkTemplate.FindName%2A> を呼び出す必要があります。  次の例は、この手順の実行方法を示しています。  わかりやすくするため、この例では <xref:System.Windows.DataTemplate> で生成されたテキスト ブロックのテキスト コンテンツを表示するメッセージ ボックスを作成しています。  
+  
+ [!code-csharp[FindGeneratedItems#DTFindElement](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml.cs#dtfindelement)]
+ [!code-vb[FindGeneratedItems#DTFindElement](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindGeneratedItems/VisualBasic/Window1.xaml.vb#dtfindelement)]  
+  
+ 次に示すのは、`FindVisualChild` の実装です。この実装は、<xref:System.Windows.Media.VisualTreeHelper> メソッドを使用しています。  
+  
+ [!code-csharp[FindGeneratedItems#FVC](../../../../samples/snippets/csharp/VS_Snippets_Wpf/FindGeneratedItems/CSharp/Window1.xaml.cs#fvc)]
+ [!code-vb[FindGeneratedItems#FVC](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/FindGeneratedItems/VisualBasic/Window1.xaml.vb#fvc)]  
+  
+## 参照  
+ [方法 : ControlTemplate によって生成された要素を検索する](../../../../docs/framework/wpf/controls/how-to-find-controltemplate-generated-elements.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)   
+ [スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [WPF XAML 名前スコープ](../../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)   
+ [WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-get-the-binding-object-from-a-bound-target-property.md b/docs/framework/wpf/data/how-to-get-the-binding-object-from-a-bound-target-property.md
new file mode 100644
index 00000000000..951ac686256
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-get-the-binding-object-from-a-bound-target-property.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : バインドされているターゲット プロパティからのバインディング オブジェクトの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, 取得 (バインドされているターゲット プロパティからバインディング オブジェクトを)"
+  - "プロパティ, 取得 (バインディング オブジェクトを)"
+ms.assetid: 87974c5f-136b-4de7-b07d-9285b62ab123
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : バインドされているターゲット プロパティからのバインディング オブジェクトの取得
+この例では、データにバインドされているターゲット プロパティからバインディング オブジェクトを取得する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Data.Binding> オブジェクトを取得する方法を次に示します。  
+  
+ [!code-csharp[BindValidation#GetBinding](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindValidation/CSharp/Window1.xaml.cs#getbinding)]  
+  
+> [!NOTE]
+>  バインディングの[依存関係プロパティ](GTMT)を指定しなければならないのは、ターゲット オブジェクトに、データ バインディングを使用するプロパティが複数存在する可能性があるためです。  
+  
+ また、<xref:System.Windows.Data.BindingExpression> を取得してから <xref:System.Windows.Data.BindingExpression.ParentBinding%2A> プロパティの値を取得するという方法もあります。  
+  
+ コード例全体については、[バインディングの検証のサンプル](http://go.microsoft.com/fwlink/?LinkID=159972)を参照してください。  
+  
+> [!NOTE]
+>  バインディングが <xref:System.Windows.Data.MultiBinding> である場合は、<xref:System.Windows.Data.BindingOperations>.<xref:System.Windows.Data.BindingOperations.GetMultiBinding%2A> を使用します。  <xref:System.Windows.Data.PriorityBinding> である場合は、<xref:System.Windows.Data.BindingOperations>.<xref:System.Windows.Data.BindingOperations.GetPriorityBinding%2A> を使用します。  ターゲット プロパティが、<xref:System.Windows.Data.Binding>、<xref:System.Windows.Data.MultiBinding>、<xref:System.Windows.Data.PriorityBinding> のどれを使用してバインドされているかが不明な場合は、<xref:System.Windows.Data.BindingOperations>.<xref:System.Windows.Data.BindingOperations.GetBindingBase%2A> を使用してください。  
+  
+## 参照  
+ [コードでバインディングを作成する](../../../../docs/framework/wpf/data/how-to-create-a-binding-in-code.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md b/docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md
new file mode 100644
index 00000000000..d128b96f6a3
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : データ コレクションの既定のビューを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成, データ コレクションのビュー"
+  - "データ バインディング, 作成 (データ コレクションのビューを)"
+  - "データ コレクション, 作成 (ビューを)"
+ms.assetid: b641e96c-c2f6-42ea-9c5d-bac81176ad65
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : データ コレクションの既定のビューを取得する
+ビューを使用すると、並べ替え、フィルター処理、またはグループ化の基準に応じて、同じデータ コレクションをさまざまな方法で表示できます。  すべてのコレクションに、1 つの共有の既定ビューがあります。この既定のビューは、バインディングがそのソースとしてコレクションを指定したときに、実際のバインディング ソースとして使用されます。  この例は、コレクションの既定のビューを取得する方法を示しています。  
+  
+## 使用例  
+ ビューを作成するには、コレクションへのオブジェクト参照が必要です。  このデータ オブジェクトは、独自の分離コード オブジェクトを参照することによって、データ コンテキストを取得することによって、データ ソースのプロパティを取得することによって、またはバインディングのプロパティを取得することによって得ることができます。  この例は、データ オブジェクトの <xref:System.Windows.FrameworkElement.DataContext%2A> を取得して、このコレクションの既定のコレクション ビューを直接取得するために使用する方法を示しています。  
+  
+ [!code-csharp[CollectionView#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionView/CSharp/Page1.xaml.cs#2)]
+ [!code-vb[CollectionView#2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CollectionView/VisualBasic/Page1.xaml.vb#2)]  
+  
+ この例では、ルート要素は <xref:System.Windows.Controls.StackPanel> です。  <xref:System.Windows.FrameworkElement.DataContext%2A> は、データ プロバイダーを参照する *myDataSource* に設定されます。データ プロバイダーは、*Order* オブジェクトの <xref:System.Collections.ObjectModel.ObservableCollection%601> です。  
+  
+ [!code-xml[CollectionView#CollectionViewDataContext](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionView/CSharp/Page1.xaml#collectionviewdatacontext)]  
+  
+ また、<xref:System.Windows.Data.CollectionViewSource> クラスを使用して、独自のコレクション ビューをインスタンス化してそれにバインドすることもできます。  このコレクション ビューは、それに直接バインドするコントロールだけが共有します。  例については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」の「ビューの作成方法」を参照してください。  
+  
+ コレクション ビューによって提供される機能の例については、「[ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)」、「[ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)」および「[データ CollectionView のオブジェクト間を移動する](../../../../docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md)」を参照してください。  
+  
+## 参照  
+ [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-implement-a-compositecollection.md b/docs/framework/wpf/data/how-to-implement-a-compositecollection.md
new file mode 100644
index 00000000000..dc3dfd49452
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-implement-a-compositecollection.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : CompositeCollection を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, CompositeCollection"
+  - "データ バインディング, CompositeCollection クラス"
+ms.assetid: 0d8fc84c-7920-427f-8ad7-d55ca656c170
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : CompositeCollection を実装する
+## 使用例  
+ <xref:System.Windows.Data.CompositeCollection> クラスを使用して、複数のコレクションと項目を 1 つのリストとして表示する方法を次の例に示します。  この例では、`GreekGods` は `GreekGod` カスタム オブジェクトの <xref:System.Collections.ObjectModel.ObservableCollection%601> です。  データ テンプレートは、`GreekGod` オブジェクトと `GreekHero` オブジェクトがそれぞれ金とシアンの前景色で表示されるように定義されています。  
+  
+ [!code-xml[CompositeCollections#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CompositeCollections/CS/Window1.xaml#1)]  
+  
+## 参照  
+ <xref:System.Windows.Data.CollectionContainer>   
+ <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A>   
+ <xref:System.Windows.Data.XmlDataProvider>   
+ <xref:System.Windows.DataTemplate>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-implement-binding-validation.md b/docs/framework/wpf/data/how-to-implement-binding-validation.md
new file mode 100644
index 00000000000..8a09f1bd682
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-implement-binding-validation.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : バインディングの検証の実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド, 検証"
+  - "データ バインディング, 検証 (バインディングの)"
+  - "検証 (バインディングの)"
+ms.assetid: eb98b33d-9866-49ae-b981-bc5ff20d607a
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法 : バインディングの検証の実装
+この例では、<xref:System.Windows.Controls.Validation.ErrorTemplate%2A> およびスタイル トリガーを使用して、カスタム検証規則に基づき無効な値が入力されたことをユーザーに通知するための視覚的フィードバックを提供する方法を示します。  
+  
+## 使用例  
+ 次の例で使用されている <xref:System.Windows.Controls.TextBox> のテキスト コンテンツは、`ods` という名前の[バインディング ソース](GTMT) オブジェクトの `Age` プロパティ \(int 型\) にバインドされています。  バインドは、`AgeRangeRule` という名前の入力規則を使用するよう設定されています。つまり、ユーザーが数字以外の文字、または 21 ～ 130 の範囲外の数値を入力すると、テキスト ボックスの横に赤の感嘆符が表示され、ユーザーがテキスト ボックス上にマウスを置くとエラー メッセージを含んだツール ヒントが示されます。  
+  
+ [!code-xml[BindValidation#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindValidation/CSharp/Window1.xaml#2)]  
+  
+ 次の例では `AgeRangeRule` の実装方法を示します。この規則は、<xref:System.Windows.Controls.ValidationRule> から継承され、<xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドをオーバーライドします。  Int32.Parse\(\) メソッドは、値に無効な文字が含まれていないことを確認するために、値に対して呼び出されます。  <xref:System.Windows.Controls.ValidationRule.Validate%2A> メソッドは、解析中に例外が発生したかどうか、および年齢値が範囲外にあるかどうかに基づいて、値が有効かどうかを示す <xref:System.Windows.Controls.ValidationResult> を返します。  
+  
+ [!code-csharp[BindValidation#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindValidation/CSharp/AgeRangeRule.cs#3)]  
+  
+ 次の例では、検証エラーをユーザーに通知する赤い感嘆符を作成するための、カスタム <xref:System.Windows.Controls.ControlTemplate> `validationTemplate` を示します。  コントロール テンプレートは、コントロールの外観を再定義するために使用されます。  
+  
+ [!code-xml[BindValidation#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindValidation/CSharp/Window1.xaml#4)]  
+  
+ 次の例に示すように、エラー メッセージを表示する <xref:System.Windows.Controls.ToolTip> は、`textBoxInError` という名前のスタイル トリガーを使って作成されます。  <xref:System.Windows.Controls.Validation.HasError%2A> の値が `true` である場合、トリガーは現在の <xref:System.Windows.Controls.TextBox> のツール ヒントに、最初の検証エラーを設定します。  <xref:System.Windows.Data.Binding.RelativeSource%2A> には、現在の要素を参照している <xref:System.Windows.Data.RelativeSourceMode> が設定されます。  
+  
+ [!code-xml[BindValidation#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BindValidation/CSharp/Window1.xaml#5)]  
+  
+ コード例全体については、[バインディングの検証のサンプル](http://go.microsoft.com/fwlink/?LinkID=159972)を参照してください。  
+  
+ カスタム <xref:System.Windows.Controls.Validation.ErrorTemplate%2A> を提供しない場合、検証エラーがあった際にユーザーに視覚的にフィードバックするために、既定のエラー テンプレートが使用されることに注意してください。  詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」の「データの検証」を参照してください。  さらに [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、バインド ソース プロパティの更新中にスローされる例外をキャッチするための、組み込みの検証規則を提供します。  詳細については、「<xref:System.Windows.Controls.ExceptionValidationRule>」を参照してください。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-implement-prioritybinding.md b/docs/framework/wpf/data/how-to-implement-prioritybinding.md
new file mode 100644
index 00000000000..d3e9e816fce
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-implement-prioritybinding.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : PriorityBinding を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, PriorityBinding"
+  - "データ バインディング, PriorityBinding クラス"
+  - "PriorityBinding クラス"
+ms.assetid: d63b65ab-b3e9-4322-9aa8-1450f8d89532
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : PriorityBinding を実装する
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] における <xref:System.Windows.Data.PriorityBinding> は、バインディング リストの指定により機能します。  バインディング リストは、優先順位の高いものから低いものに順番に並べられています。  優先順位の最も高いバインディングが処理された際に値を正常に返した場合は、リスト内の他のバインディングを処理する必要はありません。  優先順位の最も高いバインディングの評価に時間がかかる場合は、そのバインディングが値を正常に返すまで、正常に値を返した 2 番目に優先順位の高いバインディングが使用されることがあります。  
+  
+## 使用例  
+ <xref:System.Windows.Data.PriorityBinding> の動作を示すため、`FastDP`、`SlowerDP`、および `SlowestDP` という 3 つのプロパティを持つ `AsyncDataSource` オブジェクトを作成しています。  
+  
+ `FastDP` の get アクセサーは、`_fastDP` データ メンバーの値を返します。  
+  
+ `SlowerDP` の get アクセサーは、3 秒待機してから `_slowerDP` データ メンバーの値を返します。  
+  
+ `SlowestDP` の get アクセサーは、5 秒待機してから `_slowestDP` データ メンバーの値を返します。  
+  
+> [!NOTE]
+>  この例は、デモンストレーションのためだけに作成されています。  フィールド セットよりもはるかに時間がかかるため、[!INCLUDE[TLA#tla_net](../../../../includes/tlasharptla-net-md.md)] ガイドラインではプロパティを定義しないように推奨しています。  詳細については、「[NIB: Choosing Between Properties and Methods](http://msdn.microsoft.com/ja-jp/55825e8f-7e2e-448a-9505-7217cc91b1af)」を参照してください。  
+  
+ [!code-csharp[PriorityBinding#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PriorityBinding/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[PriorityBinding#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PriorityBinding/VisualBasic/AsyncDataSource.vb#1)]  
+  
+ <xref:System.Windows.Controls.TextBlock.Text%2A> プロパティは、<xref:System.Windows.Data.PriorityBinding> を次のように使用して、上の `AsyncDS` にバインドされます。  
+  
+ [!code-xml[PriorityBinding#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PriorityBinding/CSharp/Window1.xaml#2)]  
+  
+ バインディング エンジンが <xref:System.Windows.Data.Binding> オブジェクトを処理する場合は、最初の <xref:System.Windows.Data.Binding> から処理を開始しますが、これは `SlowestDP` プロパティにバインドされています。  この <xref:System.Windows.Data.Binding> は 5 秒間スリープするため、処理された時点では正常に値を返しません。そのため、次の <xref:System.Windows.Data.Binding> 要素が処理されます。  次の <xref:System.Windows.Data.Binding> も 3 秒間スリープするため、正常に値を返しません。  そのため、バインディング エンジンは次の <xref:System.Windows.Data.Binding> 要素に移動します。この要素は `FastDP` プロパティにバインドされています。  この <xref:System.Windows.Data.Binding> は、値 "Fast Value" を返します。  <xref:System.Windows.Controls.TextBlock> には、値 "Fast Value" が表示されます。  
+  
+ 3 秒経過すると、`SlowerDP` プロパティから値 "Slower Value" が返されます。  <xref:System.Windows.Controls.TextBlock> には、値 "Slower Value" が表示されます。  
+  
+ 5 秒経過すると、`SlowestDP` プロパティから値 "Slowest Value" が返されます。  このバインディングは、リストの先頭に表示されているため、優先順位が最も高くなります。  <xref:System.Windows.Controls.TextBlock> には、値 "Slowest Value" が表示されます。  
+  
+ どのような値がバインディングからの正常な戻り値と見なされるかについては、<xref:System.Windows.Data.PriorityBinding> を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Data.Binding.IsAsync%2A?displayProperty=fullName>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-implement-property-change-notification.md b/docs/framework/wpf/data/how-to-implement-property-change-notification.md
new file mode 100644
index 00000000000..77e7b360339
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-implement-property-change-notification.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : プロパティの変更通知を実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変更通知"
+  - "データ バインディング, プロパティの変更通知"
+  - "通知 (変更の)"
+  - "プロパティ, 変更通知"
+ms.assetid: 30b59d9e-8c3a-4349-aa82-4be837e841cf
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : プロパティの変更通知を実装する
+[バインディング ターゲット](GTMT)のプロパティに[バインディング ソース](GTMT)の動的変更が自動的に反映される \(たとえば、ユーザーがフォームを編集するとプレビュー ペインが自動的に更新される\) ようにするために、<xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> バインディングをサポートするには、クラスが適切なプロパティ変更通知を提供する必要があります。  この例では、<xref:System.ComponentModel.INotifyPropertyChanged> を実装するクラスを作成する方法を示します。  
+  
+## 使用例  
+ <xref:System.ComponentModel.INotifyPropertyChanged> を実装するには、<xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントを宣言し、`OnPropertyChanged` メソッドを作成する必要があります。  次に、変更を通知する必要のある各プロパティについて、そのプロパティが更新されるたびに `OnPropertyChanged` を呼び出します。  
+  
+ [!code-csharp[SimpleBinding#PersonClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Person.cs#personclass)]
+ [!code-vb[SimpleBinding#PersonClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleBinding/VisualBasic/Person.vb#personclass)]  
+  
+ `Person` クラスを使用して <xref:System.Windows.Data.BindingMode> バインディングをサポートする例については、「[TextBox テキストでソースを更新するタイミングを制御する](../../../../docs/framework/wpf/data/how-to-control-when-the-textbox-text-updates-the-source.md)」を参照してください。  
+  
+## 参照  
+ [バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-implement-validation-logic-on-custom-objects.md b/docs/framework/wpf/data/how-to-implement-validation-logic-on-custom-objects.md
new file mode 100644
index 00000000000..b2e7f48b67f
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-implement-validation-logic-on-custom-objects.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : カスタム オブジェクトに検証ロジックを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "チェック (検証エラーを) [WPF]"
+  - "カスタム オブジェクト [WPF], 実装 (検証ロジックを)"
+  - "実装 (カスタム オブジェクトに検証ロジックを) [WPF]"
+  - "検証エラー [WPF], チェック"
+ms.assetid: 751fda9b-44f9-4d63-b4f2-1df07ac41e0f
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : カスタム オブジェクトに検証ロジックを実装する
+次のコード例は、カスタム オブジェクトに検証ロジックを実装してバインドする方法を示しています。  
+  
+## 使用例  
+ 次の例に示すように、ソース オブジェクトで <xref:System.ComponentModel.IDataErrorInfo> を実装する場合は、ビジネス層に検証ロジックを実装できます。  
+  
+ [!code-csharp[BusinessLayerValidation#IDataErrorInfo](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BusinessLayerValidation/CSharp/Data.cs#idataerrorinfo)]
+ [!code-vb[BusinessLayerValidation#IDataErrorInfo](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BusinessLayerValidation/VisualBasic/Data.vb#idataerrorinfo)]  
+  
+ 次の例では、テキスト ボックスのテキスト プロパティが `Person` オブジェクトの `Age` プロパティにバインドされています。このプロパティは、`x:Key` `data` が指定されたリソース宣言によってバインディング可能になっています。  <xref:System.Windows.Controls.DataErrorValidationRule> は、<xref:System.ComponentModel.IDataErrorInfo> の実装によって発生した検証エラーをチェックします。  
+  
+ [!code-xml[BusinessLayerValidation#BoundTextBox](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BusinessLayerValidation/CSharp/Window1.xaml#boundtextbox)]  
+  
+ また、<xref:System.Windows.Controls.DataErrorValidationRule> を使用する代わりに、<xref:System.Windows.Data.Binding.ValidatesOnDataErrors%2A> プロパティを `true` に設定する方法もあります。  
+  
+## 参照  
+ <xref:System.Windows.Controls.ExceptionValidationRule>   
+ [バインディングの検証の実装](../../../../docs/framework/wpf/data/how-to-implement-binding-validation.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md b/docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md
new file mode 100644
index 00000000000..e8eb8fbd099
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : XAML でデータをバインディング可能にする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), データを利用可能にする"
+  - "データ バインディング, データをバインディング可能にする"
+ms.assetid: 7103c2e8-0e31-4a13-bf12-ca382221a8d5
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : XAML でデータをバインディング可能にする
+ここでは、アプリケーションでの必要に応じて、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でデータをバインディング可能にするさまざまな方法について説明します。  
+  
+## 使用例  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] から[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトにバインドする場合、そのオブジェクトをバインディング可能にする方法の 1 つは、それをリソースとして定義し、`x:Key` を指定することです。  次の例では、`PersonName` という名前の文字列プロパティを持つ `Person` オブジェクトがあります。  この `Person` オブジェクトは、`SDKSample` という名前空間で定義されます。  
+  
+ [!code-xml[SimpleBinding#Instantiation](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#instantiation)]  
+[!code-xml[SimpleBinding#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#2)]  
+  
+ その後、次の例に示すように、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でそのオブジェクトにバインドします。  
+  
+ [!code-xml[SimpleBinding#BDO1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#bdo1)]  
+  
+ または、次の例に示すように、<xref:System.Windows.Data.ObjectDataProvider> クラスを使用することもできます。  
+  
+ [!code-xml[SimpleBinding#ODPCP](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SimpleBinding/VisualBasic/Page1.xaml#odpcp)]  
+  
+ 同じようにバインディングを定義します。  
+  
+ [!code-xml[SimpleBinding#BDO1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SimpleBinding/CSharp/Page1.xaml#bdo1)]  
+  
+ ここに示す例では、結果は同じになります。`Joe` というテキスト コンテンツを持つ <xref:System.Windows.Controls.TextBlock> が得られます。  これに対し、<xref:System.Windows.Data.ObjectDataProvider> クラスは、メソッドの結果にバインドするなどの機能を提供します。  <xref:System.Windows.Data.ObjectDataProvider> クラスが提供する機能が必要な場合は、そちらを使用してください。  
+  
+ ただし、既に作成されているオブジェクトにバインドする場合は、次の例に示すように、コード内で `DataContext` を設定する必要があります。  
+  
+ [!code-csharp[ADODataSet#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ADODataSet/CSharp/Window1.xaml.cs#1)]
+ [!code-vb[ADODataSet#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ADODataSet/VisualBasic/Window1.xaml.vb#1)]  
+  
+ <xref:System.Windows.Data.XmlDataProvider> クラスを使用して、バインディングで使用する [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにアクセスするには、「[XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)」を参照してください。  <xref:System.Windows.Data.ObjectDataProvider> クラスを使用して、バインディングで使用する [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データにアクセスするには、「[XDocument、XElement、または LINQ for XML クエリの結果にバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xdocument-xelement-or-linq-for-xml-query-results.md)」を参照してください。  
+  
+ バインド先とするデータを指定するさまざまな方法については、「[バインディング ソースを指定する](../../../../docs/framework/wpf/data/how-to-specify-the-binding-source.md)」を参照してください。  バインド先として指定できるデータの型、またはバインディング用に独自の[!INCLUDE[TLA#tla_clr](../../../../includes/tlasharptla-clr-md.md)] オブジェクトを実装する方法については、「[バインディング ソースの概要](../../../../docs/framework/wpf/data/binding-sources-overview.md)」を参照してください。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md b/docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md
new file mode 100644
index 00000000000..492a77e6379
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-navigate-through-the-objects-in-a-data-collectionview.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : データ CollectionView のオブジェクト間を移動する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CollectionView, 移動 (オブジェクト間を)"
+  - "データ バインディング, 移動 (データ CollectionView のオブジェクト間を)"
+  - "移動 (データ CollectionView のオブジェクト間を)"
+ms.assetid: fcd37590-bce1-4ac9-8b74-3b96c7458b8a
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : データ CollectionView のオブジェクト間を移動する
+ビューを使用すれば、同じデータ コレクションを、並べ替え、フィルター処理、またはグループ化するによってさまざまな方法で表示できます。  ビューでは現在のレコード ポインターの概念を用いており、このポインターは移動できます。  この例では、現在のオブジェクトを取得する方法と、<xref:System.Windows.Data.CollectionView> クラスにある機能を使用してデータ コレクション内のオブジェクト間を移動する方法を示します。  
+  
+## 使用例  
+ この例では、`myCollectionView` は、連結コレクションのビューである <xref:System.Windows.Data.CollectionView> オブジェクトです。  
+  
+ 次の例では、`OnButton` がアプリケーションの \[`Previous`\] ボタンと \[`Next`\] ボタン用のイベント ハンドラーで、これらのボタンを使用してユーザーがデータ コレクション内を移動できます。  <xref:System.Windows.Data.CollectionView.IsCurrentBeforeFirst%2A> と <xref:System.Windows.Data.CollectionView.IsCurrentAfterLast%2A> プロパティが <xref:System.Windows.Data.CollectionView.MoveCurrentToFirst%2A> と <xref:System.Windows.Data.CollectionView.MoveCurrentToLast%2A> が必要に応じて呼び出せるように、カレント レコード ポインターが最初とリストの末尾のそれぞれに達したかどうかを報告します。  
+  
+ ビューの <xref:System.Windows.Data.CollectionView.CurrentItem%2A> プロパティは、コレクションの現在の順序項目を返すために、`Order` としてキャストされます。  
+  
+ [!code-csharp[CollectionView#OnButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionView/CSharp/Page1.xaml.cs#onbutton)]
+ [!code-vb[CollectionView#OnButton](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CollectionView/VisualBasic/Page1.xaml.vb#onbutton)]  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ビュー内のデータの並べ替え](../../../../docs/framework/wpf/data/how-to-sort-data-in-a-view.md)   
+ [ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)   
+ [XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-produce-a-value-based-on-a-list-of-bound-items.md b/docs/framework/wpf/data/how-to-produce-a-value-based-on-a-list-of-bound-items.md
new file mode 100644
index 00000000000..cb803cce992
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-produce-a-value-based-on-a-list-of-bound-items.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : バインドされた項目の一覧に基づいて値を生成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, MultiBinding"
+  - "MultiBinding"
+ms.assetid: b3d06378-b511-4181-95aa-316d60c9229b
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : バインドされた項目の一覧に基づいて値を生成する
+<xref:System.Windows.Data.MultiBinding> を使用すると、ソース プロパティの一覧に[バインディング ターゲット](GTMT) プロパティをバインドし、指定した入力で値を生成するロジックを適用することができます。  この例では、<xref:System.Windows.Data.MultiBinding> を使用する方法を示します。  
+  
+## 使用例  
+ 次の例では、`NameListData` は、`PersonName` オブジェクトのコレクションを参照します。このオブジェクトは、`firstName` と `lastName` の 2 つのプロパティを含みます。  個人の氏名を姓から表示する <xref:System.Windows.Controls.TextBlock> を生成する例を次に示します。  
+  
+ [!code-xml[MultiBinding#Resources1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#resources1)]  
+[!code-xml[MultiBinding#Resources2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#resources2)]  
+[!code-xml[MultiBinding#MultiBindingTextBox2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#multibindingtextbox2)]  
+[!code-xml[MultiBinding#Window](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/Window1.xaml#window)]  
+  
+ 姓が先の形式を生成する方法を理解するには、次に示す `NameConverter` の実装を参照してください。  
+  
+ [!code-csharp[MultiBinding#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MultiBinding/CSharp/NameConverter.cs#3)]
+ [!code-vb[MultiBinding#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MultiBinding/VisualBasic/NameConverter.vb#3)]  
+  
+ `NameConverter` では、<xref:System.Windows.Data.IMultiValueConverter> インターフェイスを実装します。  `NameConverter` は、個々のバインディングから値を受け取り、それらを値のオブジェクト配列に格納します。  <xref:System.Windows.Data.Binding> 要素が <xref:System.Windows.Data.MultiBinding> 要素の下に出現する順序は、値が配列内に格納されている順序です。  <xref:System.Windows.Data.MultiBinding.ConverterParameter%2A> 属性の値は、名前の形式を決定するパラメーターの切り替えを実行する <xref:System.Windows.Data.MultiBinding.Converter%2A> メソッドのパラメーター引数によって参照されます。  
+  
+## 参照  
+ [バインドされたデータを変換する](../../../../docs/framework/wpf/data/how-to-convert-bound-data.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-set-up-notification-of-binding-updates.md b/docs/framework/wpf/data/how-to-set-up-notification-of-binding-updates.md
new file mode 100644
index 00000000000..f0c2850706f
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-set-up-notification-of-binding-updates.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : バインディングの更新の通知を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド, 更新, 通知"
+  - "データ バインディング, 通知 (バインディングの更新の)"
+  - "通知, バインディングの更新"
+ms.assetid: 5673073e-dbe1-49da-980a-484a88f9595a
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : バインディングの更新の通知を設定する
+この例では、バインディングの[バインディング ターゲット](GTMT) \(ターゲット\) プロパティまたは[バインディング ソース](GTMT) \(ソース\) プロパティが更新されたときに通知を受け取る設定方法を示します。  
+  
+## 使用例  
+ バインディングのソースまたはターゲットが更新されるたびに、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] はデータ更新イベントを発生させます。  内部的には、このイベントは、バインドされたデータが変更されたため、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を更新する必要があることを通知するために使用されます。  これらのイベントを動作させ、一方向または双方向のバインディングを正しく動作させるためには、<xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを使用してデータ クラスを実装する必要があることに注意してください。  詳細については、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」を参照してください。  
+  
+ バインディングで、<xref:System.Windows.Data.Binding.NotifyOnTargetUpdated%2A> プロパティか <xref:System.Windows.Data.Binding.NotifyOnSourceUpdated%2A> プロパティ \(または両方\) を `true` に設定します。  このイベントをリッスンするために提供するハンドラーは、変更を通知する要素に直接結び付ける必要があります。また、コンテキストのあらゆる変更について通知を受け取る場合は、データ コンテキスト全体に結び付けます。  
+  
+ ターゲット プロパティが更新された場合の通知を設定する方法を次の例に示します。  
+  
+ [!code-xml[DirectionalBinding#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml#2)]  
+  
+ その後、EventHandler\<T\> デリゲート \(この例では *OnTargetUpdated*\) に基づいてハンドラーを割り当て、イベントを処理することができます。  
+  
+ [!code-csharp[DirectionalBinding#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml.cs#3)]  
+[!code-csharp[DirectionalBinding#EndEvent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml.cs#endevent)]  
+  
+ イベントのパラメーターは、変更されたプロパティの詳細 \(複数の要素に同じハンドラーが結び付けられている場合は、種類や特定の要素など\) を特定するために使用できます。これは、単一の要素に複数のプロパティがバインドされている場合に役立ちます。  
+  
+## 参照  
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md b/docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md
new file mode 100644
index 00000000000..afa6b5f9b93
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : XAML でビューを使用してデータの並べ替えおよびグループ化を行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, グループ化 (XAML でビューのデータを)"
+  - "データ バインディング, 並べ替え (XAML でビューのデータを)"
+  - "グループ化 (XAML でビューのデータを)"
+  - "並べ替え (XAML でビューのデータを)"
+  - "ビュー, グループ化 (データを)"
+  - "ビュー, 並べ替え (データの)"
+  - "XAML, グループ化 (ビューのデータを)"
+  - "XAML, 並べ替え (ビューのデータを)"
+ms.assetid: 145c8c3f-dbdd-4d0d-816f-90b35eba7eda
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : XAML でビューを使用してデータの並べ替えおよびグループ化を行う
+[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でデータ コレクションのビューを作成する方法を次の例に示します。  ビューには、グループ化、並べ替え、およびフィルター処理の機能があり、現在の項目も使用できます。  
+  
+## 使用例  
+ 次の例では、*places* という名前の静的リソースが、*Place* オブジェクトのコレクションとして定義されます。それぞれの *Place* オブジェクトは、都市の名前と州で構成されます。  プレフィックス *src* は、データ ソース *Places* が定義されている名前空間にマップされます。  プレフィックス *scm* は `"clr-namespace:System.ComponentModel;assembly=WindowsBase"` にマップされ、*dat* は `"clr-namespace:System.Windows.Data;assembly=PresentationFramework"` にマップされます。  
+  
+ 次の例では、CityName で並べ替えられ、State でグループ化されたデータ コレクションのビューを作成します。  
+  
+ [!code-xml[CollectionViewSource#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionViewSource/CS/window1.xaml#1)]  
+  
+ その後、次の例のように、このビューをバインディング ソースに指定できます。  
+  
+ [!code-xml[CollectionViewSource#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionViewSource/CS/window1.xaml#2)]  
+  
+ <xref:System.Windows.Data.XmlDataProvider> リソースで定義された XML データへのバインディングの場合は、XML 名の前に @ 記号を付けます。  
+  
+ [!code-xml[CollectionViewSource#XDPChunk](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionViewSource/CS/window1.xaml#xdpchunk)]  
+  
+ [!code-xml[CollectionViewSource#Attribute](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CollectionViewSource/CS/window1.xaml#attribute)]  
+  
+## 参照  
+ <xref:System.Windows.Data.CollectionViewSource>   
+ [データ コレクションの既定のビューを取得する](../../../../docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-sort-data-in-a-view.md b/docs/framework/wpf/data/how-to-sort-data-in-a-view.md
new file mode 100644
index 00000000000..c6d2081df4d
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-sort-data-in-a-view.md
@@ -0,0 +1,48 @@
+---
+title: "方法: ビュー内のデータを並べ替える | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, グループ化 (ビューのデータを)"
+  - "データ バインディング, 並べ替え (ビューのデータを)"
+  - "グループ化 (ビューのデータを)"
+  - "並べ替え (ビューのデータを)"
+  - "ビュー, グループ化 (データを)"
+  - "ビュー, 並べ替え (データの)"
+ms.assetid: f4c43578-01b7-4774-a953-acb95a13b94a
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法: ビュー内のデータを並べ替える
+この例では、ビュー内のデータを並べ替える方法を示します。  
+  
+## 使用例  
+ 簡単な <xref:System.Windows.Controls.ListBox> と <xref:System.Windows.Controls.Button> を作成する例を次に示します。  
+  
+ [!code-xml[ListBoxSort_snip#HowTo](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxSort_snip/CSharp/Window1.xaml#howto)]  
+  
+ ボタンの <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーには、<xref:System.Windows.Controls.ListBox> 内の項目を降順に並べ替えるロジックが含まれています。  この方法が可能なのは、こうして <xref:System.Windows.Controls.ListBox> に項目を追加すると <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemCollection> に項目が追加され、<xref:System.Windows.Controls.ItemCollection> は <xref:System.Windows.Data.CollectionView> クラスから派生しているためです。  <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティを使用してコレクションに <xref:System.Windows.Controls.ListBox> をバインドしている場合も、同じ手法を使用して並べ替えることができます。  
+  
+ [!code-csharp[ListBoxSort_snip#HowToCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ListBoxSort_snip/CSharp/Window1.xaml.cs#howtocode)]
+ [!code-vb[ListBoxSort_snip#HowToCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ListBoxSort_snip/visualbasic/window1.xaml.vb#howtocode)]  
+  
+ ビュー オブジェクトに対する参照がある限り、同じ手法を使用して、他のコレクション ビューのコンテンツも並べ替えることができます。  ビューを取得する方法の例については、「[データ コレクションの既定のビューを取得する](../../../../docs/framework/wpf/data/how-to-get-the-default-view-of-a-data-collection.md)」を参照してください。  別の例については、「[ヘッダーがクリックされたときに GridView 列を並べ替える](../../../../docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md)」を参照してください。  ビューの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」の「コレクションへのバインド」を参照してください。  
+  
+ 並べ替えロジックに [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を適用する方法の例については、「[XAML でビューを使用してデータの並べ替えおよびグループ化を行う](../../../../docs/framework/wpf/data/how-to-sort-and-group-data-using-a-view-in-xaml.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Data.ListCollectionView.CustomSort%2A>   
+ [ヘッダーがクリックされたときに GridView 列を並べ替える](../../../../docs/framework/wpf/controls/how-to-sort-a-gridview-column-when-a-header-is-clicked.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [ビュー内のデータをフィルター処理する](../../../../docs/framework/wpf/data/how-to-filter-data-in-a-view.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-specify-the-binding-source.md b/docs/framework/wpf/data/how-to-specify-the-binding-source.md
new file mode 100644
index 00000000000..cb86f6a2d56
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-specify-the-binding-source.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : バインディング ソースを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインド (データを), バインディング ソース"
+  - "バインディング ソース"
+  - "データ バインディング, バインディング ソース"
+ms.assetid: 55d47757-2648-4a52-987f-b767953f168c
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : バインディング ソースを指定する
+データ バインディングでは、データの取得元のオブジェクトを[バインディング ソース](GTMT) オブジェクトと呼びます。  ここでは、[バインディング ソース](GTMT)を指定するさまざまな方法について説明します。  
+  
+## 使用例  
+ 複数のプロパティを共通のソースにバインドする場合は、`DataContext` プロパティを使用することをお勧めします。このプロパティは、データ バインドされたすべてのプロパティが共通のソースから継承するスコープを確立するための便利な方法を提供します。  
+  
+ 次の例では、アプリケーションのルート要素でデータ コンテキストが確立されています。  これにより、すべての子要素がデータ コンテキストを継承できます。  バインディングのデータは、カスタム データ クラス `NetIncome` をマッピングで直接参照し、リソース キーとして `incomeDataSource` を指定することによって取得しています。  
+  
+ [!code-xml[DirectionalBinding#DataContext1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml#datacontext1)]  
+[!code-xml[DirectionalBinding#DataContext2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml#datacontext2)]  
+  
+ `NetIncome` クラスの定義の例を次に示します。  
+  
+ [!code-csharp[DirectionalBinding#DataObject](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/billsdata.cs#dataobject)]
+ [!code-vb[DirectionalBinding#DataObject](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DirectionalBinding/VisualBasic/NetIncome.vb#dataobject)]  
+  
+> [!NOTE]
+>  上記の例では、マークアップ内のオブジェクトをインスタンス化し、リソースとして使用しています。  コードで既にインスタンス化されているオブジェクトにバインドする場合は、`DataContext` プロパティをプログラムによって設定する必要があります。  例については、「[XAML でデータをバインディング可能にする](../../../../docs/framework/wpf/data/how-to-make-data-available-for-binding-in-xaml.md)」を参照してください。  
+  
+ また、個々のバインディングについてソースを明示的に指定する場合は、次のオプションを使用します。  これらは、継承されたデータ コンテキストより優先されます。  
+  
+|プロパティ|Description|  
+|-----------|-----------------|  
+|<xref:System.Windows.Data.Binding.Source%2A>|このプロパティは、ソースをオブジェクトのインスタンスに設定するために使用します。  複数のプロパティが同じデータ コンテキストを継承するスコープを確立するという機能が必要でない場合は、<xref:System.Windows.Data.Binding.Source%2A> プロパティを `DataContext` プロパティの代わりに使用できます。  詳細については、<xref:System.Windows.Data.Binding.Source%2A> を参照してください。|  
+|<xref:System.Windows.Data.Binding.RelativeSource%2A>|これは、[バインディング ターゲット](GTMT)の位置を基準にしてソースを指定する場合に役立ちます。  このプロパティを使用する可能性がある一般的なシナリオとしては、ある要素の特定のプロパティを同じ要素の別のプロパティにバインドする場合や、スタイルまたはテンプレートでバインディングを定義する場合などがあります。  詳細については、<xref:System.Windows.Data.Binding.RelativeSource%2A> を参照してください。|  
+|<xref:System.Windows.Data.Binding.ElementName%2A>|バインド先の要素を表す文字列を指定します。  これは、アプリケーションの別の要素のプロパティにバインドする場合に役立ちます。  たとえば、<xref:System.Windows.Controls.Slider> を使用してアプリケーション内の別のコントロールの高さを制御する場合や、コントロールの <xref:System.Windows.Controls.ContentControl.Content%2A> を <xref:System.Windows.Controls.ListBox> コントロールの <xref:System.Windows.Controls.Primitives.Selector.SelectedValue%2A> プロパティにバインドする場合に指定します。  詳細については、<xref:System.Windows.Data.Binding.ElementName%2A> を参照してください。|  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.DataContext%2A?displayProperty=fullName>   
+ <xref:System.Windows.FrameworkContentElement.DataContext%2A?displayProperty=fullName>   
+ [プロパティ値の継承](../../../../docs/framework/wpf/advanced/property-value-inheritance.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [バインディング宣言の概要](../../../../docs/framework/wpf/data/binding-declarations-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-specify-the-direction-of-the-binding.md b/docs/framework/wpf/data/how-to-specify-the-direction-of-the-binding.md
new file mode 100644
index 00000000000..5d4f0fadc73
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-specify-the-direction-of-the-binding.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : バインディングの方向を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "バインディングの方向"
+  - "データ バインディング, 方向 (バインディングの)"
+  - "方向 (バインディングの)"
+ms.assetid: 37334478-028b-4514-86c9-1420709f4818
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 方法 : バインディングの方向を指定する
+この例では、バインディングで[バインディング ターゲット](GTMT) \(ターゲット\) プロパティのみを更新するか、[バインディング ソース](GTMT) \(ソース\) プロパティのみを更新するか、またはターゲット プロパティとソース プロパティの両方を更新するかを指定する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Data.Binding.Mode%2A> プロパティを使用して、バインディングの方向を指定します。  バインディングの更新で使用可能なオプションを次の列挙値の一覧に示します。  
+  
+-   <xref:System.Windows.Data.BindingMode> は、ソース プロパティまたはターゲット プロパティのいずれかが変更されると、ターゲット プロパティまたはソース プロパティを更新します。  
+  
+-   <xref:System.Windows.Data.BindingMode> は、ソース プロパティが変更されたときに、ターゲット プロパティのみを更新します。  
+  
+-   <xref:System.Windows.Data.BindingMode> は、アプリケーションの起動時または <xref:System.Windows.FrameworkElement.DataContext%2A> の変更時に、ターゲット プロパティのみを更新します。  
+  
+-   <xref:System.Windows.Data.BindingMode> は、ターゲット プロパティが変更されると、ソース プロパティを更新します。  
+  
+-   <xref:System.Windows.Data.BindingMode> を指定すると、ターゲット プロパティの <xref:System.Windows.Data.Binding.Mode%2A> の既定値が使用されます。  
+  
+ 詳細については、<xref:System.Windows.Data.BindingMode> 列挙体の解説を参照してください。  
+  
+ <xref:System.Windows.Data.Binding.Mode%2A> プロパティを設定する方法を次の例に示します。  
+  
+ [!code-xml[DirectionalBinding#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DirectionalBinding/CSharp/Page1.xaml#4)]  
+  
+ ソースの変更を検出するには \(<xref:System.Windows.Data.BindingMode> および <xref:System.Windows.Data.BindingMode> バインディングの場合\)、ソースで <xref:System.ComponentModel.INotifyPropertyChanged> などの適切なプロパティの変更通知機構を実装する必要があります。  <xref:System.ComponentModel.INotifyPropertyChanged> の実装の例については、「[プロパティの変更通知を実装する](../../../../docs/framework/wpf/data/how-to-implement-property-change-notification.md)」を参照してください。  
+  
+ <xref:System.Windows.Data.BindingMode> または <xref:System.Windows.Data.BindingMode> のバインディングでは、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティを設定することにより、ソースの更新のタイミングを制御できます。  詳細については、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Data.Binding>   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md b/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md
new file mode 100644
index 00000000000..188f8d7d16b
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : 階層データでマスター詳細パターンを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, マスター/詳細データ パラダイム"
+  - "マスター/詳細データ パラダイム"
+ms.assetid: 11429b9e-058d-4084-bfb6-2cf209c8ddf7
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 階層データでマスター詳細パターンを使用する
+この例では、マスター詳細シナリオを実装する方法を示します。  
+  
+## 使用例  
+ この例では、`LeagueList` は `Leagues` のコレクションです。  `League` にはそれぞれ `Divisions` のコレクションと `Name` があり、`Division` にはそれぞれ `Teams` のコレクションと名前があります。  `Team` にはそれぞれチーム名があります。  
+  
+ [!code-xml[MasterDetail#HowTo1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MasterDetail/VisualBasic/Page1.xaml#howto1)]  
+[!code-xml[MasterDetail#HowTo2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MasterDetail/VisualBasic/Page1.xaml#howto2)]  
+  
+ この例のスクリーンショットを次に示します。  `Divisions` <xref:System.Windows.Controls.ListBox> は、`Leagues` <xref:System.Windows.Controls.ListBox> での選択を自動的に追跡し、対応するデータを表示します。  `Teams` <xref:System.Windows.Controls.ListBox> は、他の 2 つの <xref:System.Windows.Controls.ListBox> コントロールでの選択を追跡します。  
+  
+ ![マスター詳細のサンプル](../../../../docs/framework/wpf/data/media/databindingmasterdetailsample.png "DataBindingMasterDetailSample")  
+  
+ この例では、次の 2 つの点に注意する必要があります。  
+  
+1.  3 つの <xref:System.Windows.Controls.ListBox> コントロールは、同じソースにバインドしています。  <xref:System.Windows.Controls.ListBox> に表示するデータのレベルを指定するには、バインディングの <xref:System.Windows.Data.Binding.Path%2A> プロパティを設定します。  
+  
+2.  選択を追跡する <xref:System.Windows.Controls.ListBox> コントロールでは、<xref:System.Windows.Controls.Primitives.Selector.IsSynchronizedWithCurrentItem%2A> プロパティを `true` に設定する必要があります。  このプロパティを設定すると、選択されている項目は常に <xref:System.Windows.Controls.ItemCollection.CurrentItem%2A> として設定されます。  または、<xref:System.Windows.Controls.ListBox> が <xref:System.Windows.Data.CollectionViewSource> からデータを取得する場合は、選択と現在の項目が自動的に同期されます。  
+  
+ [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データを使用する場合は、方法が若干異なります。  例については、「[階層 XML データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.HierarchicalDataTemplate>   
+ [コレクションにバインドして選択に基づく情報を表示する](../../../../docs/framework/wpf/data/how-to-bind-to-a-collection-and-display-information-based-on-selection.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md b/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md
new file mode 100644
index 00000000000..5529d322113
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-xml-data.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : 階層 XML データでマスター詳細パターンを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, マスター/詳細データ パラダイム"
+  - "マスター/詳細データ パラダイム"
+ms.assetid: eb8dbdd8-5871-42bb-a16b-04e655fea677
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 階層 XML データでマスター詳細パターンを使用する
+この例では、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データでマスター詳細シナリオを実装する方法を示します。  
+  
+## 使用例  
+ この例は、「[階層データでマスター詳細パターンを使用する](../../../../docs/framework/wpf/data/how-to-use-the-master-detail-pattern-with-hierarchical-data.md)」で説明した例の [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データ バージョンです。  この例では、データは `League.xml` ファイルから取得します。  3 番目の <xref:System.Windows.Controls.ListBox> コントロールが、2 番目の <xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.Primitives.Selector.SelectedValue%2A> プロパティにバインドすることにより、その選択項目の変更を追跡していることに注意してください。  
+  
+ [!code-xml[MasterDetailXml#HowTo1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MasterDetailXml/CS/Window1.xaml#howto1)]  
+[!code-xml[MasterDetailXml#HowTo2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MasterDetailXml/CS/Window1.xaml#howto2)]  
+  
+## 参照  
+ <xref:System.Windows.HierarchicalDataTemplate>   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/how-to-use-xml-namespaces-in-data-binding.md b/docs/framework/wpf/data/how-to-use-xml-namespaces-in-data-binding.md
new file mode 100644
index 00000000000..117569760d7
--- /dev/null
+++ b/docs/framework/wpf/data/how-to-use-xml-namespaces-in-data-binding.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : データ バインドで XML 名前空間を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ バインディング, XML 名前空間"
+  - "名前空間, XML"
+  - "XML, 名前空間"
+ms.assetid: a47c832f-dc84-48f2-96d5-cde18fc4284b
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : データ バインドで XML 名前空間を使用する
+## 使用例  
+ この例は、[!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] [バインディング ソース](GTMT)で指定された名前空間を処理する方法を示します。  
+  
+ [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データに次の [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間定義があるとします。  
+  
+ `<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">`  
+  
+ この場合は、次の例のように、<xref:System.Windows.Data.XmlNamespaceMapping> 要素を使用して名前空間を <xref:System.Windows.Data.XmlNamespaceMapping.Prefix%2A> にマッピングします。  これで、<xref:System.Windows.Data.XmlNamespaceMapping.Prefix%2A> を使用して [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] 名前空間を参照できます。  この例の <xref:System.Windows.Controls.ListBox> では、各 *item* の *title* および *dc:date* が表示されます。  
+  
+ [!code-xml[XmlnsBind#XmlNamespaceMapping](../../../../samples/snippets/xaml/VS_Snippets_Wpf/XmlnsBind/XAML/Window1.xaml#xmlnamespacemapping)]
+ [!code-xml[XmlnsBind#XmlNamespaceMapping](../../../../samples/snippets/csharp/VS_Snippets_Wpf/XmlnsBind/CS/Window1.xaml#xmlnamespacemapping)]  
+  
+ 指定した <xref:System.Windows.Data.XmlNamespaceMapping.Prefix%2A> は、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ソースで使用されているものと一致する必要はありません。[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] ソースでプレフィックスが変更されても、マッピングは機能します。  
+  
+ この例では、[!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データのソースが Web サービスになっていますが、<xref:System.Windows.Data.XmlNamespaceMapping> 要素は、埋め込まれたファイルのインライン [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] または [!INCLUDE[TLA2#tla_xml](../../../../includes/tla2sharptla-xml-md.md)] データでも機能します。  
+  
+## 参照  
+ [XMLDataProvider と XPath クエリを使用して XML データにバインドする](../../../../docs/framework/wpf/data/how-to-bind-to-xml-data-using-an-xmldataprovider-and-xpath-queries.md)   
+ [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/data/data-binding-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/data/media/databinding-dataflow.png b/docs/framework/wpf/data/media/databinding-dataflow.png
new file mode 100644
index 00000000000..3759316096c
Binary files /dev/null and b/docs/framework/wpf/data/media/databinding-dataflow.png differ
diff --git a/docs/framework/wpf/data/media/databindingbuttonbackgroundexample.png b/docs/framework/wpf/data/media/databindingbuttonbackgroundexample.png
new file mode 100644
index 00000000000..1d289997a0d
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingbuttonbackgroundexample.png differ
diff --git a/docs/framework/wpf/data/media/databindingbuttondefaultconversion.png b/docs/framework/wpf/data/media/databindingbuttondefaultconversion.png
new file mode 100644
index 00000000000..07e842b1e66
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingbuttondefaultconversion.png differ
diff --git a/docs/framework/wpf/data/media/databindingconvertercolorexample.png b/docs/framework/wpf/data/media/databindingconvertercolorexample.png
new file mode 100644
index 00000000000..6b310eac848
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingconvertercolorexample.png differ
diff --git a/docs/framework/wpf/data/media/databindingitemscontrol.png b/docs/framework/wpf/data/media/databindingitemscontrol.png
new file mode 100644
index 00000000000..56c08f8715a
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingitemscontrol.png differ
diff --git a/docs/framework/wpf/data/media/databindingmostbasic.png b/docs/framework/wpf/data/media/databindingmostbasic.png
new file mode 100644
index 00000000000..918ef20444a
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingmostbasic.png differ
diff --git a/docs/framework/wpf/data/media/databindingupdatesourcetrigger.png b/docs/framework/wpf/data/media/databindingupdatesourcetrigger.png
new file mode 100644
index 00000000000..4bb7f51f24a
Binary files /dev/null and b/docs/framework/wpf/data/media/databindingupdatesourcetrigger.png differ
diff --git a/docs/framework/wpf/getting-started/TOC.md b/docs/framework/wpf/getting-started/TOC.md
new file mode 100644
index 00000000000..3ee4336c7b5
--- /dev/null
+++ b/docs/framework/wpf/getting-started/TOC.md
@@ -0,0 +1,6 @@
+# [WPF Version 4.5 の新機能](whats-new.md)
+# [WPF のチュートリアル](wpf-walkthroughs.md)
+# [チュートリアル: WPF の概要](walkthrough-my-first-wpf-desktop-application.md)
+# [Visual Studio 2015 での WPF の概要](introduction-to-wpf-in-vs.md)
+# [WPF コミュニティのフィードバック](community-feedback.md)
+# [作業の開始](index.md)
diff --git a/docs/framework/wpf/getting-started/community-feedback.md b/docs/framework/wpf/getting-started/community-feedback.md
new file mode 100644
index 00000000000..de16a1cd4ad
--- /dev/null
+++ b/docs/framework/wpf/getting-started/community-feedback.md
@@ -0,0 +1,191 @@
+---
+title: "WPF コミュニティのフィードバック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブログ (フィードバック用の)"
+  - "バグの説明"
+  - "コミュニティ リソース"
+  - "フィードバック センター"
+  - "フォーラム"
+  - "Microsoft 製品フィードバック センター"
+  - "製品フィードバック センター"
+  - "Web ログ (フィードバック用の)"
+ms.assetid: 468b060a-d54b-4900-a74a-9faccb554045
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# WPF コミュニティのフィードバック
+[!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] は、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] について学習したり、ディスカッションをしたり、フィードバックを提供する際に利用できる、さまざまなコミュニティ リソースを公開しています。これらのリソースには、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のチーム メンバーやコミュニティ リーダーが作成したブログ、フォーラム、および [!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] 製品フィードバック センターが含まれます。  各コミュニティ リソースには、それぞれ異なる利点があります。  ここでは、それらの利点について、およびそれぞれのコミュニティ リソースを使用してコミュニティ一般から、および [!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] から、最良の回答を得るためのベスト プラクティスについて説明します。  
+  
+> [!NOTE]
+>  製品に関するフィードバックを送信する場合、各ページの最後に表示された **\[コメント\]** リンクは使用しないでください。  このリンクは、ドキュメントに関するフィードバックをお送りいただく際にのみ使用できます。以下のブログ、フォーラム、フィードバックおよびコミュニティについての情報共有は主に英語でのコミュニケーションになっています。日本語でのコミュニティについては MSDN コミュニティ \(http:\/\/www.microsoft.com\/japan\/msdn\/community\/\) を利用することができます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Blogs"></a>   
+## ブログ  
+ [!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のチーム メンバーとコミュニティ リーダーは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の概要、または明確な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のサブセットを対象としたさまざまな[ブログ](http://go.microsoft.com/fwlink/?LinkId=98852)を作成しています。  コンテンツは一般的に製品開発、モチベーション、および信条から、特定のシナリオ、問題点、および [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] の詳細な説明まで多岐にわたります。  また、プラットフォームを熟知している人と、関心のある投稿について深く話し合ったり、質問することができます。  
+  
+<a name="Forums"></a>   
+## フォーラム  
+ [WPF フォーラム](http://go.microsoft.com/fwlink/?LinkID=187440) \(および [!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] 64 の[フォーラム](http://go.microsoft.com/fwlink/?LinkId=98855)\) は、問題について話し合ったり、解決するための中心的なコミュニティ リソースです。  フォーラムでは、次のような一連の包括的な機能のサポートを提供することで、ディスカッションや問題解決を促進しています。  
+  
+-   検索  
+  
+-   ディスカッション追跡  
+  
+-   テキストとコードの豊富な書式設定  
+  
+-   [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] 統合  
+  
+-   Most Valued Professional \(MVP\) とコミュニティの関係  
+  
+-   投稿に対して迅速な応答がなされているかどうかを確認するための監視  
+  
+ 問題が [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] に関連する場合でも、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] フォーラムがその問題を取り上げるのに最も適切な場所とはいえない場合があります。  たとえば、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ツール \([Expression Blend](http://go.microsoft.com/fwlink/?LinkId=98858)、[Expression Web](http://go.microsoft.com/fwlink/?LinkId=98859)、[Expression Design](http://go.microsoft.com/fwlink/?LinkId=98860) など\) に固有の問題の場合です。  その場合は、適切な [Expression コミュニティ フォーラム](http://go.microsoft.com/fwlink/?LinkId=98861) を利用する必要があります。  
+  
+### フォーラムのベスト プラクティス  
+ 次のベスト プラクティスは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] フォーラムに投稿した問題を最短の時間で解決するのに役立ちます。  これらのベスト プラクティスは、すべてのフォーラムに当てはまります。  
+  
+#### 既存の投稿の検索  
+ 一部の問題は広範囲にわたって発生し、他のユーザーが既に同じ問題に直面している場合があります。  したがって、問題を迅速に解決したり、既存のディスカッションに入力を追加したりできます。  
+  
+#### 意味のあるタイトルの使用  
+ 簡潔で意味のあるタイトルを付けると、投稿が目に止まりやすくなり、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] フォーラム コミュニティの他のメンバーは、自分が問題を解決できるかどうかを判断しやすくなります。  
+  
+#### 内容の正しい説明  
+ 問題の内容、およびその問題を解決するために行った処理を説明する必要があります。  可能であれば、サポート コードや簡単なサンプルを記述して、問題点を具体的に示します。  これらの詳細な内容はすべて、問題を迅速に解決する可能性を高くするために役立ちます。  
+  
+ フォーラムのすべてのベスト プラクティスは、[オンライン](http://www.microsoft.com/wn3/locales/help/help_en-us.htm)で参照できます。  
+  
+<a name="Product_Feedback_Center"></a>   
+## 製品フィードバック センター  
+ 問題を解決するのが難しい場合、または解決できない場合があります。  そのような状況は、テクノロジのバグ、テクノロジを特定のシナリオに適用できない、または特定のシナリオをサポートできないといったことが原因で発生します。  この情報は [!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] にとって重要です。この情報は、[製品フィードバック センター](http://go.microsoft.com/fwlink/?LinkId=99381)を通じて提供できます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 製品フィードバック センターに投稿された項目は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] チームの内部バグ データベースに送られます。  したがって、これが、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 機能の所有者にフィードバックを届ける最も信頼性の高い方法です。  また、提案内容やバグを検証および追跡するだけでなく、それらに投票することができます。これにより、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] チームは問題に優先順位を付けることができます。  
+  
+### WPF 製品フィードバック センターのベスト プラクティス  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 製品フィードバック センターに投稿するときは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] フォーラムに投稿するときと同様、既存の投稿の検索、意味のあるタイトルの使用、内容の正しい説明は重要なベスト プラクティスです。  これ以外に使用する必要のあるベスト プラクティスを以下に示します。  
+  
+#### 既存の投稿の検索  
+ 一部の問題は広範囲にわたって発生し、他のユーザーが既に同じ問題に直面している場合があります。  したがって、問題を迅速に解決したり、既存のディスカッションに入力を追加したりできます。  
+  
+#### 意味のあるタイトルの使用  
+ 簡潔で意味のあるタイトルを付けると、問題が最短の時間で最も適切な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] チームに送られる可能性が高くなります。  これは、相互に関連する多くの機能を含む [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] などのテクノロジでは特に重要です。  
+  
+#### バグの再現方法の説明  
+ バグについて投稿する場合は、必要に応じて以下の項目を含めることが重要です。  
+  
+-   バグについて明確に説明します。  
+  
+-   コードを使用して、バグの説明をサポートします。  
+  
+-   バグの再現方法を示す手順の一覧を示します。  
+  
+-   バグを再現する最小のコード サンプルを含めます。  
+  
+-   バグが常に再現されかどうかを記述します。  
+  
+-   関連のある例外情報を含めます。  
+  
+ バグがインストールまたはセットアップに関連する場合は、関係するインストール ログとスナップショット \(%temp% フォルダー内にある "dd\_"" というプリフィックスの付いたファイル\) を添付します。  
+  
+ コンパイルまたはビルドに関する問題の場合は、ビルド ログを添付します。  MSBuild システムは、コマンド ラインで \/v: スイッチを使用するか、[!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] などの[!INCLUDE[TLA#tla_ide](../../../../includes/tlasharptla-ide-md.md)] で適切なレベルを設定して、さまざまな詳細レベルでログをサポートするように設定できます。  
+  
+#### 環境情報の提供  
+ 背景情報は、コンテキストを投稿に追加する場合に役立つことがあります。  特に、"Windows XP SP2, Pentium III, x86" のように、オペレーティング システム プラットフォーム、プロセッサ ファミリ、およびアーキテクチャの情報を提供します。  
+  
+ 投稿する問題が表示に関連する場合は、グラフィックス カードやドライバーの詳細も可能な限り含める必要があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] はプレゼンテーション フレームワークであるため、この情報は重要です。  
+  
+#### ソリューションまたはプロジェクト情報の提供  
+ バグは、アプリケーションの開発や構築に使用されるツール、構築しているアプリケーションの種類に関係していることがあります。  したがって、次の項目を提供すると役立つ可能性があります。  
+  
+-   次のような、構築中のアプリケーションの種類。  
+  
+    -   アプリケーション \(.exe\) またはライブラリ \(.dll\)  
+  
+    -   [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] ブラウザー アプリケーション \(XBAP\)  
+  
+    -   Loose [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] アプリケーション  
+  
+    -   スタンドアロンのインストール型アプリケーション  
+  
+    -   スタンドアロンの ClickOnce 配置アプリケーション  
+  
+-   次のような開発ツール  
+  
+    -   MSBuild  
+  
+    -   Expression Graphic Designer  
+  
+    -   Expression Interactive Designer  
+  
+    -   [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)].  
+  
+-   次のようなソリューション構成  
+  
+    -   1 つのソリューション  
+  
+    -   単一のプロジェクト  
+  
+    -   複数の依存プロジェクトを使用する 1 つのソリューション  
+  
+-   アプリケーションに言語固有のリソースまたは言語に依存しないリソースがあるかどうか。  たとえば、`UICulture` プロジェクト プロパティを指定したか、または `Application`、`Page`、および `Resource` 型のローカライズ可能なメタデータを指定したかどうか。  
+  
+-   AssemblyInfo.cs ファイルまたは AssemblyInfo.vb ファイルでニュートラル言語設定を使用したかどうか。  
+  
+#### シナリオと影響に関する情報の提供  
+ バグを発生させるシナリオとバグの影響に関する情報は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] チームにとって、問題をいつ、どのような方法で修正する必要があるか、または受け入れ可能な回避策を使用できるかどうかを判断する上で重要です。  
+  
+ 通常、クラッシュおよびデータの損失に関するシナリオは影響が大きいため、優先順位が高くなります。  ただし、一般的ではないシナリオでのみ表れるバグであっても、場合によっては主要なシナリオになる場合もあります。  シナリオと影響に関するコンテキストを提供することで、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] チームは正しい判断を下すことができます。  
+  
+<a name="Windows_Presentation_Foundation_Community_Site"></a>   
+## Windows Presentation Foundation コミュニティ サイト  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、[!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] により、[コミュニティ ポータル サイト](http://go.microsoft.com/fwlink/?LinkId=99382)を使用してサポートされます。このサイトは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] に関連するブログ、フォーラム、およびその他のリソースへの単一のエントリ ポイントです。  
+  
+<a name="MSDN_Community_Content"></a>   
+## MSDN コミュニティ コンテンツ  
+ 「[Windows Presentation Foundation](../../../../docs/framework/wpf/index.md)」ドキュメントでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] によって実現される中心的なシナリオを対象とした技術コンテンツを包括的に取り上げています。  実際の現場の開発者たちは、興味深く、一般的ではない、さまざまなシナリオに直面し、そこから教訓を得ます。その中には、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の開発コミュニティ全体にとって有益なものもあります。  
+  
+ 開発者たちが、自らの知識と経験を [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] コミュニティと共有できるよう、このドキュメントは MSDN コミュニティ コンテンツと併せて拡張され、概念説明、リファレンス、方法、チュートリアル、およびサンプルの各トピックに対し、開発者がコメントを追加および更新できるようになりました。  
+  
+ MSDN コミュニティ コンテンツに情報を追加することには、[!INCLUDE[TLA2#tla_ms](../../../../includes/tla2sharptla-ms-md.md)] とコミュニティの知識と経験を、一元的な最新の共有リポジトリに集約できるメリットがあります。これにより、オンライン ドキュメントのメリットが高まります。  さらに、コンテンツは管理されるため、明晰、正確、的確、および有益な情報が得られます。  
+  
+### MSDN コミュニティ コンテンツへの追加に適したコンテンツの種類  
+ MSDN コミュニティ コンテンツは、既存の MSDN コンテンツを拡張する、的確、有益、適切な情報を集めるための場所です。  前に述べた有効性の高い適切なツールを使用して、バグ、フィードバック、スレッド式の議論、質問などをポストします。  
+  
+### MSDN コミュニティ コンテンツの管理  
+ MSDN コミュニティ コンテンツは、適切なコンテンツとなるように管理されています。  MSDN [コンテンツ モデレート ガイドライン](http://go.microsoft.com/fwlink/?LinkId=98864)で述べられているように、以下の種類のコンテンツは適切でないと判断されます。  
+  
+-   MSDN コミュニティ[行動規範](http://go.microsoft.com/fwlink/?LinkId=98865)に違反するコンテンツ  
+  
+-   関連性がないコンテンツ、理解不能なコンテンツ、試験的なコンテンツ  
+  
+-   重複するコンテンツ  
+  
+-   スパム  
+  
+-   ドキュメント フィードバック  
+  
+-   バグ報告  
+  
+-   質問  
+  
+ モデレーターは、MSDN コミュニティ コンテンツ モデレート ガイドラインに従って、これらの種類のコンテンツを処理します。  
+  
+### MSDN コミュニティ コンテンツの言語サポート  
+ MSDN コミュニティ コンテンツは、MSDN オンラインの英語 \(米国\) 版およびポルトガル語 \(ブラジル\) 版で使用できます。  今後は、日本語、フランス語、ドイツ語、イタリア語、スペイン語、韓国語、簡体字中国語、および繁体字中国語版のリリースが計画されています。  
+  
+### MSDN コミュニティ コンテンツについてよく寄せられる質問  
+ その他の情報については、MSDN コミュニティ コンテンツの[よく寄せられる質問](http://go.microsoft.com/fwlink/?LinkId=98866)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/getting-started/index.md b/docs/framework/wpf/getting-started/index.md
new file mode 100644
index 00000000000..80b415906ff
--- /dev/null
+++ b/docs/framework/wpf/getting-started/index.md
@@ -0,0 +1,46 @@
+---
+title: "概要 (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "概要 [WPF]"
+  - "概要 [WPF]"
+  - "WPF, はじめに"
+ms.assetid: 04f91da8-708c-46c7-8172-f1695ec847cd
+caps.latest.revision: 60
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 58
+---
+# 概要 (WPF)
+Windows Presentation Foundation \(WPF\) は、多様な対話型のクライアント アプリケーションを作成する UI フレームワークです。  WPF の開発プラットフォームは、アプリケーション モデル、リソース、コントロール、グラフィックス、レイアウト、データ バインド、ドキュメント、およびセキュリティなどのさまざまなアプリケーション開発機能の一式をサポートします。  WPF は .NET Framework のサブセットであるため、以前 ASP.NET や Windows フォームを使用して  .NET Framework でアプリケーションを構築したことがあれば、プログラミングには馴染みがあるでしょう。  WPF は、Extensible Application Markup Language \(XAML\) を使用して、アプリケーションのプログラミング用に、宣言型モデルを提供します。  このセクションには、WPF の紹介のトピックと、WPF の使用を開始するトピックがあります。  
+  
+## 開始すべき場所  
+  
+|||  
+|-|-|  
+|すぐに使用を開始したい|[WPF の簡単なアプリケーションのチュートリアル ハンズ オン ラボ](http://go.microsoft.com/fwlink/?LinkId=207072)<br /><br /> [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)|  
+|コードを表示する...|[WPF のチュートリアル](../../../../docs/framework/wpf/getting-started/wpf-walkthroughs.md)<br /><br /> [WPF ドキュメントのサンプル](http://go.microsoft.com/fwlink/?LinkID=159044)<br /><br /> [コミュニティ WPF のサンプル](http://go.microsoft.com/fwlink/?LinkID=159044)|  
+|ビデオを見たい|[WindowsClient.NET での WPF のビデオ](http://go.microsoft.com/fwlink/?LinkId=192244)|  
+|アプリケーションの UI のデザイン方法|[WPF デザイナーの概要](http://msdn.microsoft.com/ja-jp/18e61d03-b96a-4058-a166-8ec6b3f6116b)<br /><br /> [Expression Blend 4](http://go.microsoft.com/fwlink/?LinkId=192245)|  
+|WPF の新機能|[WPF Version 4.5 の新機能](../../../../docs/framework/wpf/getting-started/whats-new.md)|  
+|Silverlight の開発者向け|[WPF との互換性](http://msdn.microsoft.com/library/cc903925\(VS.95\).aspx)|  
+|Windows フォームの開発者向け|[Windows フォーム コントロールおよび同等の WPF コントロール](../../../../docs/framework/wpf/advanced/windows-forms-controls-and-equivalent-wpf-controls.md)<br /><br /> [WPF と Windows フォームの相互運用性](../../../../docs/framework/wpf/advanced/wpf-and-windows-forms-interoperation.md)<br /><br /> [Windows フォーム \- WPF の相互運用性に関する FAQ](http://windowsclient.net/learn/integration.aspx)|  
+|.NET の初心者向け|[NIB: Overview of the .NET Framework](http://msdn.microsoft.com/ja-jp/ea38ac1e-92af-4d1b-8db1-e8a5ea10ed85)<br /><br /> [.NET Framework アプリケーションの基本事項](../../../../docs/standard/application-essentials.md)<br /><br /> [Visual C\# と Visual Basic の概要](../Topic/Getting%20Started%20with%20Visual%20C%23%20and%20Visual%20Basic.md)|  
+|WPF の機能の詳細な説明...|[Visual Studio 2015 での WPF の概要](../../../../docs/framework/wpf/getting-started/introduction-to-wpf-in-vs.md)<br /><br /> [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)<br /><br /> [コントロール](../../../../docs/framework/wpf/controls/index.md)<br /><br /> [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)<br /><br /> [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)|  
+  
+## 参照  
+ [クラス ライブラリ](../../../../docs/framework/wpf/class-library-wpf.md)   
+ [WPF コミュニティのフィードバック](../../../../docs/framework/wpf/getting-started/community-feedback.md)   
+ [WPF ツール](../Topic/WPF%20Tools.md)   
+ [Windows Presentation Foundation によるデザイン](http://go.microsoft.com/fwlink/?LinkId=64253)   
+ [アプリケーション開発](../../../../docs/framework/wpf/app-development/index.md)   
+ [.NET Framework デベロッパー センター](http://go.microsoft.com/fwlink/?LinkId=187437)
\ No newline at end of file
diff --git a/docs/framework/wpf/getting-started/introduction-to-wpf-in-vs.md b/docs/framework/wpf/getting-started/introduction-to-wpf-in-vs.md
new file mode 100644
index 00000000000..9b0f2943a16
--- /dev/null
+++ b/docs/framework/wpf/getting-started/introduction-to-wpf-in-vs.md
@@ -0,0 +1,43 @@
+---
+title: "Visual Studio 2015 での WPF の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タイポグラフィ [WPF]"
+  - "メディア [WPF]"
+  - "分離コード [WPF]"
+  - "Windows Presentation Foundation、Windows Presentation Foundation の概要"
+  - "2-D 図形 [WPF]"
+  - "アニメーション [WPF]"
+  - "スタンドアロン アプリケーション [WPF]"
+  - "マークアップ [WPF]"
+  - "2-D 効果 [WPF]"
+  - "ブラウザーによってホストされるアプリケーション [WPF]"
+  - "WPF、Windows Presentation Foundation の概要"
+  - "3-D レンダリング [WPF]"
+ms.assetid: 582a314e-e23d-4144-b45b-acbbd5579252
+caps.latest.revision: 54
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 54
+---
+# Visual Studio 2015 での WPF の概要
+Visual Studio 2015 の Windows Presentation Foundation \(WPF\) は、Windows 上の最新の基幹業務デスクトップ アプリケーションを構築するための統一されたプログラミング モデルを開発者に提供します。  
+  
+ [Windows Presentation Foundation での最新のデスクトップ アプリケーションの作成](../Topic/Create%20Modern%20Desktop%20Applications%20with%20Windows%20Presentation%20Foundation.md)  
+  
+ [Designing XAML in Visual Studio and Blend for Visual Studio](../Topic/Designing%20XAML%20in%20Visual%20Studio.md)  
+  
+ [WPF の概要](../Topic/Introduction%20to%20WPF.md)  
+  
+ [.NET Framework での WPF](https://msdn.microsoft.com/en-us/library/ms754130\(v=vs.100\).aspx)  
+  
+ [Visual Studio の入手](https://www.visualstudio.com/features/wpf-vs)
\ No newline at end of file
diff --git a/docs/framework/wpf/getting-started/media/gettingstartedfigure3.png b/docs/framework/wpf/getting-started/media/gettingstartedfigure3.png
new file mode 100644
index 00000000000..8cb9d3fea22
Binary files /dev/null and b/docs/framework/wpf/getting-started/media/gettingstartedfigure3.png differ
diff --git a/docs/framework/wpf/getting-started/media/gettingstartedfigure4.png b/docs/framework/wpf/getting-started/media/gettingstartedfigure4.png
new file mode 100644
index 00000000000..1c7b7c1d693
Binary files /dev/null and b/docs/framework/wpf/getting-started/media/gettingstartedfigure4.png differ
diff --git a/docs/framework/wpf/getting-started/media/gettingstartedfigure5.png b/docs/framework/wpf/getting-started/media/gettingstartedfigure5.png
new file mode 100644
index 00000000000..0e00cf9ee0a
Binary files /dev/null and b/docs/framework/wpf/getting-started/media/gettingstartedfigure5.png differ
diff --git a/docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md b/docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md
new file mode 100644
index 00000000000..95375403e2c
--- /dev/null
+++ b/docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md
@@ -0,0 +1,479 @@
+---
+title: "チュートリアル: WPF の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "はじめに, WPF"
+  - "WPF, はじめに"
+ms.assetid: b96bed40-8946-4285-8fe4-88045ab854ed
+caps.latest.revision: 71
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 68
+---
+# チュートリアル: WPF の概要
+<a name="introduction"></a> このチュートリアルでは、ほとんどの [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションに共通の要素を含む [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの開発の概要について説明します。このような共通の要素には、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] マークアップ、分離コード、アプリケーション定義、コントロール、レイアウト、データ バインディング、スタイルなどがあります。  
+  
+ このチュートリアルでは、次の手順に従って、簡単な [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションを作成していきます。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を定義して、アプリケーションの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] の外観を設計します。  
+  
+-   アプリケーションの動作を構築するコードを記述します。  
+  
+-   アプリケーション定義を作成して、アプリケーションを管理します。  
+  
+-   コントロールの追加およびレイアウトの作成を行い、アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を構成します。  
+  
+-   アプリケーションの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 全体で一貫性のある外観を作成するためのスタイルを作成します。  
+  
+-   [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] をデータにバインドして、データから [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を設定し、データと [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] の同期を維持します。  
+  
+ このチュートリアルの最後には、ユーザーが選択した個人の経費報告書を表示できる、スタンドアロンの [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] アプリケーションが完成します。  このアプリケーションは、ブラウザー スタイルのウィンドウでホストされる複数の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ページから構成されます。  
+  
+ このチュートリアルの構築に使用するサンプル コードは、[!INCLUDE[TLA#tla_visualb](../../../../includes/tlasharptla-visualb-md.md)] と [!INCLUDE[TLA#tla_cshrp](../../../../includes/tlasharptla-cshrp-md.md)] の両方が用意されています。[WPF アプリケーションの構築の概要](http://go.microsoft.com/fwlink/?LinkID=160008)に関する記述を参照してください。  
+  
+<a name="Requirements"></a>   
+## 必要条件  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   [!INCLUDE[vs_dev11_long](../../../../includes/vs-dev11-long-md.md)]  
+  
+ [!INCLUDE[TLA2#tla_visualstu](../../../../includes/tla2sharptla-visualstu-md.md)] のインストールの詳細については、「[Visual Studio のインストール](../Topic/Install%20Visual%20Studio%202015.md)」を参照してください。  
+  
+<a name="Create_The_Application_Code_Files"></a>   
+## アプリケーション プロジェクトの作成  
+ このセクションでは、アプリケーション定義、2 つのページ、および 1 つのイメージが含まれるアプリケーション インフラストラクチャを作成します。  
+  
+1.  Visual Basic または Visual C\# で `ExpenseIt` という名前の新しい WPF アプリケーション プロジェクトを作成します。  詳細については、「[方法 : 新しい WPF アプリケーション プロジェクトを作成する](http://msdn.microsoft.com/ja-jp/1f6aea7a-33e1-4d3f-8555-1daa42e95d82)」を参照してください。  
+  
+    > [!NOTE]
+    >  このチュートリアルでは、.NET Framework 4 で使用できる <xref:System.Windows.Controls.DataGrid> コントロールを使用します。  プロジェクトで .NET Framework 4 を対象としてください。  詳細については、「[方法: .NET Framework のバージョンをターゲットにする](../Topic/How%20to:%20Target%20a%20Version%20of%20the%20.NET%20Framework.md)」を参照してください。  
+  
+2.  Application.xaml \(Visual Basic\) または App.xaml \(C\#\) を開きます。  
+  
+     この [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションとすべてのアプリケーション リソースを定義します。また、このファイルは、アプリケーションの起動時に自動的に表示する [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を指定するためにも使用されます。この例では、MainWindow.xaml を指定しています。  
+  
+     Visual Basic では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は次のようになります。  
+  
+     [!code-xml[ExpenseIt#1_A](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/Application.xaml#1_a)]  
+  
+     C\# では、次のようになります。  
+  
+     [!code-xml[ExpenseIt#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt/App.xaml#1)]  
+  
+3.  MainWindow.xaml を開きます。  
+  
+     この [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] ファイルは、アプリケーションのメイン ウィンドウであり、ページで作成されたコンテンツを表示します。  <xref:System.Windows.Window> クラスは、ウィンドウのプロパティ \(タイトル、サイズ、アイコンなど\) を定義し、イベント \(ウィンドウを閉じたり非表示にしたりするなど\) を処理します。  
+  
+4.  <xref:System.Windows.Window> 要素を <xref:System.Windows.Navigation.NavigationWindow> に変更します。  
+  
+     このアプリケーションでは、ユーザー操作に応じてさまざまなコンテンツに移動します。  そのため、メインの <xref:System.Windows.Window> を <xref:System.Windows.Navigation.NavigationWindow> に変更する必要があります。  <xref:System.Windows.Navigation.NavigationWindow> は、<xref:System.Windows.Window> のすべてのプロパティを継承します。  XAML ファイル内の <xref:System.Windows.Navigation.NavigationWindow> 要素は、<xref:System.Windows.Navigation.NavigationWindow> クラスのインスタンスを作成します。  詳細については、「[ナビゲーションの概要](../../../../docs/framework/wpf/app-development/navigation-overview.md)」を参照してください。  
+  
+5.  <xref:System.Windows.Navigation.NavigationWindow> 要素の次のプロパティを変更します。  
+  
+    -   <xref:System.Windows.Window.Title%2A> プロパティを "ExpenseIt" に設定します。  
+  
+    -   <xref:System.Windows.FrameworkElement.Width%2A> プロパティを 500 ピクセルに設定します。  
+  
+    -   <xref:System.Windows.FrameworkElement.Height%2A> プロパティを 350 ピクセルに設定します。  
+  
+    -   <xref:System.Windows.Navigation.NavigationWindow> タグの間の <xref:System.Windows.Controls.Grid> 要素を削除します。  
+  
+     Visual Basic では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は次のようになります。  
+  
+     [!code-xml[ExpenseIt#2_A](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt/MainWindow.xaml#2_a)]  
+  
+     C\# では、次のようになります。  
+  
+     [!code-xml[ExpenseIt#2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt/MainWindow.xaml#2)]  
+  
+6.  MainWindow.xaml.vb または MainWindow.xaml.cs を開きます。  
+  
+     このファイルは、MainWindow.xaml で宣言されたイベントを処理するコードを含む分離コード ファイルです。  このファイルには、XAML で定義されたウィンドウの部分クラスが含まれています。  
+  
+7.  C\# を使用している場合は、`MainWindow` クラスが <xref:System.Windows.Navigation.NavigationWindow> から派生するように変更します。  
+  
+     Visual Basic では、XAML でウィンドウを変更すると自動的にこの処理が行われます。  
+  
+     コードは、次のようになります。  
+  
+     [!code-csharp[ExpenseIt#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt/MainWindow.xaml.cs#3)]
+     [!code-vb[ExpenseIt#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/MainWindow.xaml.vb#3)]  
+  
+<a name="add_files_to_the_application"></a>   
+## アプリケーションへのファイルの追加  
+ このセクションでは、2 つのページと 1 つのイメージをアプリケーションに追加します。  
+  
+1.  `ExpenseItHome.xaml` というプロジェクトに、新しいページ \(WPF\) を追加します。  詳細については、「[方法 : 新しい項目を WPF プロジェクトに追加する](http://msdn.microsoft.com/ja-jp/17e6b238-fc32-4385-98ef-2f66ca09d9ad)」を参照してください。  
+  
+     このページは、アプリケーションの起動時に最初に表示されるページです。  ここに個人の一覧が表示され、ユーザーは経費報告書の表示対象となる個人を選択できます。  
+  
+2.  ExpenseItHome.xaml を開きます。  
+  
+3.  <xref:System.Windows.Controls.Page.Title%2A> を "ExpenseIt \- Home" に設定します。  
+  
+     Visual Basic では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は次のようになります。  
+  
+     [!code-xml[ExpenseIt#6_A](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/ExpenseItHome.xaml#6_a)]  
+  
+     C\# では、次のようになります。  
+  
+     [!code-xml[ExpenseIt#6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt2/ExpenseItHome.xaml#6)]  
+  
+4.  MainWindow.xaml を開きます。  
+  
+5.  <xref:System.Windows.Navigation.NavigationWindow> の <xref:System.Windows.Navigation.NavigationWindow.Source%2A> プロパティを "ExpenseItHome.xaml" に設定します。  
+  
+     これにより、ExpenseItHome.xaml は、アプリケーションの起動時に最初に表示されるページに設定されます。  Visual Basic では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は次のようになります。  
+  
+     [!code-xml[ExpenseIt#7_A](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/MainWindow.xaml#7_a)]  
+  
+     C\# では、次のようになります。  
+  
+     [!code-xml[ExpenseIt#7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt2/MainWindow.xaml#7)]  
+  
+6.  `ExpenseReportPage.xaml` というプロジェクトに、新しいページ \(WPF\) を追加します。  
+  
+     このページには、ExpenseItHome.xaml で選択された個人の経費報告書が表示されます。  
+  
+7.  ExpenseReportPage.xaml を開きます。  
+  
+8.  <xref:System.Windows.Controls.Page.Title%2A> を "ExpenseIt \- View Expense" に設定します。  
+  
+     Visual Basic では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] は次のようになります。  
+  
+     [!code-xml[ExpenseIt#4_A](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/ExpenseReportPage.xaml#4_a)]  
+  
+     C\# では、次のようになります。  
+  
+     [!code-xml[ExpenseIt#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt/ExpenseReportPage.xaml#4)]  
+  
+9. ExpenseItHome.xaml.vb と ExpenseReportPage.xaml.vb を開くか、または ExpenseItHome.xaml.cs と ExpenseReportPage.xaml.cs を開きます。  
+  
+     新しいページ ファイルを作成すると、分離コード ファイルが自動的に作成されます。  これらの分離コード ファイルでは、ユーザー入力に応答するためのロジックを処理します。  
+  
+     コードは、次のようになります。  
+  
+     [!code-csharp[ExpenseIt#2_5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt2/ExpenseItHome.xaml.cs#2_5)]
+     [!code-vb[ExpenseIt#2_5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/ExpenseItHome.xaml.vb#2_5)]  
+  
+     [!code-csharp[ExpenseIt#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt/ExpenseReportPage.xaml.cs#5)]
+     [!code-vb[ExpenseIt#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt1_A/ExpenseReportPage.xaml.vb#5)]  
+  
+10. watermark.png という名前のイメージをプロジェクトに追加します。  独自のイメージを作成することも、サンプル コードからファイルをコピーすることもできます。  詳細については、「[NIB:How to: Add Existing Items to a Project](http://msdn.microsoft.com/ja-jp/15f4cfb7-78ab-457f-9f14-099a25a6a2d3)」を参照してください。  
+  
+<a name="Build_The_Application"></a>   
+## アプリケーションのビルドと実行  
+ このセクションでは、アプリケーションをビルドして実行します。  
+  
+1.  F5 キーを押すか、**\[デバッグ\]** メニューの **\[デバッグ開始\]** をクリックして、アプリケーションをビルドして実行します。  
+  
+     次の図は、<xref:System.Windows.Navigation.NavigationWindow> ボタンのあるアプリケーションを示しています。  
+  
+     ![ExpenseIt のサンプルのスクリーンショット](../../../../docs/framework/wpf/getting-started/media/gettingstartedfigure1.png "GettingStartedFigure1")  
+  
+2.  アプリケーションを閉じて [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] に戻ります。  
+  
+<a name="Add_Layout"></a>   
+## レイアウトの作成  
+ レイアウトは、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素の配置を整えるほか、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] のサイズが変更された場合に各要素のサイズと位置を管理します。  通常、レイアウトを作成するには、次のレイアウト コントロールのいずれかを使用します。  
+  
+-   <xref:System.Windows.Controls.Canvas>  
+  
+-   <xref:System.Windows.Controls.DockPanel>  
+  
+-   <xref:System.Windows.Controls.Grid>  
+  
+-   <xref:System.Windows.Controls.StackPanel>  
+  
+-   <xref:System.Windows.Controls.VirtualizingStackPanel>  
+  
+-   <xref:System.Windows.Controls.WrapPanel>  
+  
+ これらの各レイアウト コントロールは、その子要素に対して特別な種類のレイアウトをサポートします。  ExpenseIt のページはサイズの変更が可能で、各ページの要素は縦にも横にも他の要素と揃えられています。  したがって、このアプリケーションにとっては <xref:System.Windows.Controls.Grid> が最適なレイアウト要素です。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.Panel> 要素の詳細については、「[パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)」を参照してください。  レイアウトの詳細については、「[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)」を参照してください。  
+  
+ このセクションでは、ExpenseItHome.xaml の <xref:System.Windows.Controls.Grid> に列と行の定義を追加して、10 ピクセルのマージンを持つ 3 行 1 列のテーブルを作成します。  
+  
+1.  ExpenseItHome.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.Grid> 要素の <xref:System.Windows.FrameworkElement.Margin%2A> プロパティを "10,0,10,10" に設定します。"10,0,10,10" の各値は、左、上、右、下のマージンに対応しています。  
+  
+3.  <xref:System.Windows.Controls.Grid> タグの間に次の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を追加し、行と列の定義を作成します。  
+  
+     [!code-xml[ExpenseIt#8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt3/ExpenseItHome.xaml#8)]  
+  
+     2 つの行の <xref:System.Windows.Controls.RowDefinition.Height%2A> は <xref:System.Windows.GridLength.Auto%2A> に設定されます。これは、行のサイズがその行に含まれるコンテンツに基づいて設定されることを意味します。  既定では、<xref:System.Windows.Controls.RowDefinition.Height%2A> は <xref:System.Windows.GridUnitType> サイズ値です。つまり、行は、使用可能なスペースの加重比率で示されます。  たとえば、2 つの行それぞれの高さが "\*" の場合、各行の高さは、使用可能なスペースの半分です。  
+  
+     <xref:System.Windows.Controls.Grid> は、次の XAML のようになります。  
+  
+     [!code-xml[ExpenseIt#9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt3/ExpenseItHome.xaml#9)]  
+  
+<a name="Add_Controls"></a>   
+## コントロールの追加  
+ このセクションでは、ホーム ページの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を更新して個人の一覧を表示します。ユーザーは、この一覧から選択して、特定の個人の経費報告書を表示できます。  コントロールとは、ユーザーがアプリケーションと対話できるようにする UI オブジェクトのことです。  詳細については、「[コントロール](../../../../docs/framework/wpf/controls/index.md)」を参照してください。  
+  
+ この [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成するために、ExpenseItHome.xaml に次の要素を追加します。  
+  
+-   <xref:System.Windows.Controls.ListBox> \(個人の一覧を表示します\)。  
+  
+-   <xref:System.Windows.Controls.Label> \(一覧のヘッダーとして使用します\)。  
+  
+-   <xref:System.Windows.Controls.Button> \(クリック時に、一覧で選択された個人の経費報告書を表示します\)。  
+  
+ 各コントロールは、<xref:System.Windows.Controls.Grid.Row%2A?displayProperty=fullName> 添付プロパティを設定することで、<xref:System.Windows.Controls.Grid> の行に配置されます。  添付プロパティの詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+1.  ExpenseItHome.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.Grid> タグの間に次の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を追加します。  
+  
+     [!code-xml[ExpenseIt#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt4/ExpenseItHome.xaml#10)]  
+  
+3.  アプリケーションをビルドして実行します。  
+  
+ 次の図は、このセクションの XAML で作成されたコントロールを示しています。  
+  
+ ![ExpenseIt のサンプルのスクリーンショット](../../../../docs/framework/wpf/getting-started/media/gettingstartedfigure2.png "GettingStartedFigure2")  
+  
+<a name="Add_an_Image"></a>   
+## イメージとタイトルの追加  
+ このセクションでは、ホーム ページの [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を更新して、イメージとページ タイトルを表示します。  
+  
+1.  ExpenseItHome.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.Grid.ColumnDefinitions%2A> に、<xref:System.Windows.Controls.ColumnDefinition.Width%2A> が 230 ピクセルで固定された新しい列を追加します。  
+  
+     [!code-xml[ExpenseIt#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt5/ExpenseItHome.xaml#11)]  
+  
+3.  <xref:System.Windows.Controls.Grid.RowDefinitions%2A> に新しい行を追加します。  
+  
+     [!code-xml[ExpenseIt#11b](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt5/ExpenseItHome.xaml#11b)]  
+  
+4.  <xref:System.Windows.Controls.Grid.Column%2A?displayProperty=fullName> を 1 に設定して、コントロールを 2 列目に移動します。  <xref:System.Windows.Controls.Grid.Row%2A?displayProperty=fullName> を 1 増加して、各コントロールを 1 行下へ移動します。  
+  
+     [!code-xml[ExpenseIt#12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt5/ExpenseItHome.xaml#12)]  
+  
+5.  <xref:System.Windows.Controls.Grid> の <xref:System.Windows.Controls.Panel.Background%2A> を watermark.png イメージ ファイルに設定します。  
+  
+     [!code-xml[ExpenseIt#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt5/ExpenseItHome.xaml#14)]  
+  
+6.  <xref:System.Windows.Controls.Border> の前に、ページのタイトルになる "View Expense Report" というコンテンツが指定された <xref:System.Windows.Controls.Label> を追加します。  
+  
+     [!code-xml[ExpenseIt#13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt5/ExpenseItHome.xaml#13)]  
+  
+7.  アプリケーションをビルドして実行します。  
+  
+ 次の図は、このセクションの結果を示しています。  
+  
+ ![ExpenseIt のサンプルのスクリーンショット](../../../../docs/framework/wpf/getting-started/media/gettingstartedfigure3.png "GettingStartedFigure3")  
+  
+<a name="Add_Code_to_Process_Events"></a>   
+## イベントを処理するコードの追加  
+  
+1.  ExpenseItHome.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.Button> 要素に <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーを追加します。  詳細については、「[方法 : 単純なイベント ハンドラーを作成する](http://msdn.microsoft.com/ja-jp/b1456e07-9dec-4354-99cf-18666b64f480)」を参照してください。  
+  
+     [!code-xml[ExpenseIt#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt6/ExpenseItHome.xaml#15)]  
+  
+3.  ExpenseItHome.xaml.vb または ExpenseItHome.xaml.cs を開きます。  
+  
+4.  <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーに次のコードを追加します。これにより、ウィンドウが ExpenseReportPage.xaml ファイルに移動します。  
+  
+     [!code-csharp[ExpenseIt#16](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt6/ExpenseItHome.xaml.cs#16)]
+     [!code-vb[ExpenseIt#16](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt6/ExpenseItHome.xaml.vb#16)]  
+  
+<a name="Create_the_UI_for_Pane2"></a>   
+## ExpenseReportPage の UI の作成  
+ ExpenseReportPage.xaml には、ExpenseItHome.xaml で選択した個人の経費報告書が表示されます。  このセクションでは、コントロールを追加して、ExpenseReportPage.xaml の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を作成します。  また、さまざまな [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素の背景と塗りつぶしの色も追加します。  
+  
+1.  ExpenseReportPage.xaml を開きます。  
+  
+2.  <xref:System.Windows.Controls.Grid> タグの間に次の XAML を追加します。  
+  
+     この UI は、<xref:System.Windows.Controls.DataGrid> で表示されるレポート データ以外は、ExpenseItHome.xaml で作成した UI に似ています。  
+  
+     [!code-xml[ExpenseIt#17](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt6/ExpenseReportPage.xaml#17)]  
+  
+3.  アプリケーションをビルドして実行します。  
+  
+    > [!NOTE]
+    >  <xref:System.Windows.Controls.DataGrid> が見つからないか存在しないエラーが発生した場合は、プロジェクトで .NET Framework 4 を対象としてください。  詳細については、「[方法: .NET Framework のバージョンをターゲットにする](../Topic/How%20to:%20Target%20a%20Version%20of%20the%20.NET%20Framework.md)」を参照してください。  
+  
+4.  **\[View\]** をクリックします。  
+  
+     経費報告書のページが表示されます。  
+  
+ ExpenseReportPage.xaml に追加された [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を次の図に示します。  "戻る" ナビゲーション ボタンが有効になっていることに注意してください。  
+  
+ ![ExpenseIt のサンプルのスクリーンショット](../../../../docs/framework/wpf/getting-started/media/gettingstartedfigure4.png "GettingStartedFigure4")  
+  
+<a name="Add_Code_to_Style_a_Control"></a>   
+## コントロールのスタイル設定  
+ 多くの場合、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] では、要素の種類が同じであれば、外観もすべて同じになります。  [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] では、複数の要素間で外観を再利用できるように、スタイルが使用されます。  スタイルの再利用性により、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の作成と管理が簡略化されます。  スタイルの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。  このセクションでは、これまでの手順で定義した要素ごとの属性をスタイルに置き換えます。  
+  
+1.  Application.xaml または App.xaml を開きます。  
+  
+2.  <xref:System.Windows.Application.Resources%2A?displayProperty=fullName> タグの間に次の XAML を追加します。  
+  
+     [!code-xml[ExpenseIt#18](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt7/App.xaml#18)]  
+  
+     この [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、次のスタイルが追加されます。  
+  
+    -   `headerTextStyle`: ページ タイトルの <xref:System.Windows.Controls.Label> を書式設定します。  
+  
+    -   `labelStyle`: <xref:System.Windows.Controls.Label> コントロールを書式設定します。  
+  
+    -   `columnHeaderStyle`: <xref:System.Windows.Controls.Primitives.DataGridColumnHeader> を書式設定します。  
+  
+    -   `listHeaderStyle`: 一覧のヘッダーの <xref:System.Windows.Controls.Border> コントロールを書式設定します。  
+  
+    -   `listHeaderTextStyle`: 一覧のヘッダーの <xref:System.Windows.Controls.Label> を書式設定します。  
+  
+    -   `buttonStyle`: ExpenseItHome.xaml の <xref:System.Windows.Controls.Button> を書式設定します。  
+  
+     スタイルは、<xref:System.Windows.Application.Resources%2A?displayProperty=fullName> プロパティ要素のリソースであり、子でもあります。  ここでは、スタイルはアプリケーション内のすべての要素に適用されます。  [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションでリソースを使用する例については、「[アプリケーション リソースを使用する](../../../../docs/framework/wpf/advanced/how-to-use-application-resources.md)」を参照してください。  
+  
+3.  ExpenseItHome.xaml を開きます。  
+  
+4.  <xref:System.Windows.Controls.Grid> 要素間のすべての内容を次の XAML に置き換えます。  
+  
+     [!code-xml[ExpenseIt#19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt7/ExpenseItHome.xaml#19)]  
+  
+     各コントロールの外観を定義する <xref:System.Windows.VerticalAlignment> や <xref:System.Windows.Media.FontFamily> などのプロパティは、スタイルを適用することにより、削除されて置き換えられます。  たとえば、`headerTextStyle` は、"View Expense Report" という <xref:System.Windows.Controls.Label> に適用されます。  
+  
+5.  ExpenseReportPage.xaml を開きます。  
+  
+6.  <xref:System.Windows.Controls.Grid> 要素間のすべての内容を次の XAML に置き換えます。  
+  
+     [!code-xml[ExpenseIt#20](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt7/ExpenseReportPage.xaml#20)]  
+  
+     これにより、<xref:System.Windows.Controls.Label> 要素と <xref:System.Windows.Controls.Border> 要素にスタイルが追加されます。  
+  
+7.  アプリケーションをビルドして実行します。  
+  
+     このセクションで [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を追加した後も、アプリケーションの外観はスタイルによる更新の前と変わりません。  
+  
+<a name="Bind_Data_to_a_Control"></a>   
+## コントロールへのデータのバインド  
+ このセクションでは、さまざまなコントロールにバインドされる [!INCLUDE[TLA#tla_xml](../../../../includes/tlasharptla-xml-md.md)] データを作成します。  
+  
+1.  ExpenseItHome.xaml を開きます。  
+  
+2.  開始の <xref:System.Windows.Controls.Grid> 要素の後に、各個人のデータを含む <xref:System.Windows.Data.XmlDataProvider> を作成する次の XAML を追加します。  
+  
+     データは <xref:System.Windows.Controls.Grid> リソースとして作成されます。  通常、これはファイルとして読み込まれますが、わかりやすくするために、データをインラインで追加しています。  
+  
+     [!code-xml[ExpenseIt#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#21)]  
+    [!code-xml[ExpenseIt#23](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#23)]  
+    [!code-xml[ExpenseIt#22](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#22)]  
+  
+3.  <xref:System.Windows.Controls.Grid> リソースでは、次の <xref:System.Windows.DataTemplate> を追加します。これにより、<xref:System.Windows.Controls.ListBox> にデータを表示する方法が定義されます。  データ テンプレートの詳細については、「[データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)」を参照してください。  
+  
+     [!code-xml[ExpenseIt#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#21)]  
+    [!code-xml[ExpenseIt#24](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#24)]  
+    [!code-xml[ExpenseIt#22](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#22)]  
+  
+4.  既存の <xref:System.Windows.Controls.ListBox> を次の XAML に置き換えます。  
+  
+     [!code-xml[ExpenseIt#25](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml#25)]  
+  
+     この XAML は、<xref:System.Windows.Controls.ListBox> の <xref:System.Windows.Controls.ItemsControl.ItemsSource%2A> プロパティをデータ ソースにバインドし、データ テンプレートを <xref:System.Windows.Controls.ItemsControl.ItemTemplate%2A> として適用します。  
+  
+<a name="Connect_Data_to_Controls"></a>   
+## コントロールへのデータの接続  
+ このセクションでは、ExpenseItHome.xaml ページ上の個人の一覧で選択されている現在の項目を取得し、その参照を `ExpenseReportPage` のコンストラクターに渡してインスタンス化するコードを作成します。  `ExpenseReportPage` は、渡された項目を使用してデータ コンテキストを設定します。この項目が、ExpenseReportPage.xaml で定義されたコントロールのバインド先になります。  
+  
+1.  ExpenseReportPage.xaml.vb または ExpenseReportPage.xaml.cs を開きます。  
+  
+2.  オブジェクトを取得するコンストラクターを追加して、選択した個人の経費報告書データを渡せるようにします。  
+  
+     [!code-csharp[ExpenseIt#26](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseReportPage.xaml.cs#26)]
+     [!code-vb[ExpenseIt#26](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt8/ExpenseReportPage.xaml.vb#26)]  
+  
+3.  ExpenseItHome.xaml.vb または ExpenseItHome.xaml.cs を開きます。  
+  
+4.  選択した個人の経費報告書データを渡す新しいコンストラクターを呼び出すように <xref:System.Windows.Controls.Primitives.ButtonBase.Click> イベント ハンドラーを変更します。  
+  
+     [!code-csharp[ExpenseIt#27](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt8/ExpenseItHome.xaml.cs#27)]
+     [!code-vb[ExpenseIt#27](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ExpenseIt/VB/ExpenseIt8/ExpenseItHome.xaml.vb#27)]  
+  
+<a name="Add_Style_to_Data"></a>   
+## データ テンプレートを使用したデータのスタイル設定  
+ このセクションでは、データ テンプレートを使用して、データ バインド リスト内の各項目の [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を更新します。  
+  
+1.  ExpenseReportPage.xaml を開きます。  
+  
+2.  "Name" および "Department" の <xref:System.Windows.Controls.Label> 要素の内容を適切なデータ ソース プロパティにバインドします。  データ バインディングの詳細については、「[データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+     [!code-xml[ExpenseIt#31](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt9/ExpenseReportPage.xaml#31)]  
+  
+3.  <xref:System.Windows.Controls.Grid> 要素を開いたら、経費報告書データの表示方法を定義する、次のデータ テンプレートを追加します。  
+  
+     [!code-xml[ExpenseIt#30](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt9/ExpenseReportPage.xaml#30)]  
+  
+4.  経費報告書データを表示する <xref:System.Windows.Controls.DataGrid> 列にテンプレートを適用します。  
+  
+     [!code-xml[ExpenseIt#32](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ExpenseIt/CSharp/ExpenseIt9/ExpenseReportPage.xaml#32)]  
+  
+5.  アプリケーションをビルドして実行します。  
+  
+6.  個人を選択し、\[**View**\] をクリックします。  
+  
+ 次の図は、コントロール、レイアウト、スタイル、データ バインド、およびデータ テンプレートが適用された ExpenseIt アプリケーションの両方のページを示しています。  
+  
+ ![ExpenseIt のサンプルのスクリーンショット](../../../../docs/framework/wpf/getting-started/media/gettingstartedfigure5.png "GettingStartedFigure5")  
+  
+<a name="Best_Practices"></a>   
+## ベスト プラクティス  
+ このサンプルでは、WPF の特定の機能を示します。そのため、アプリケーション開発のベスト プラクティスに従っていません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] のアプリケーション開発ベスト プラクティスの包括的な説明については、適宜、次のトピックを参照してください。  
+  
+-   ユーザー補助 \- 「[ユーザー補助のベスト プラクティス](../../../../docs/framework/ui-automation/accessibility-best-practices.md)」  
+  
+-   セキュリティ \- 「[セキュリティ](../../../../docs/framework/wpf/security-wpf.md)」  
+  
+-   ローカリゼーション \- 「[WPF のグローバリゼーションおよびローカリゼーションの概要](../../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)」  
+  
+-   パフォーマンス \- 「[WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)」  
+  
+<a name="Whats_Next"></a>   
+## 次の内容  
+ ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] を使用して [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] を自由に作成する多くの方法を学習しました。  データ バインドされた [!INCLUDE[TLA2#tla_winfx](../../../../includes/tla2sharptla-winfx-md.md)] アプリケーションの基本的なビルド ブロックについて幅広く説明してきました。  このトピックですべてを網羅したわけではありませんが、このトピックに示した方法以外にも独自の方法を発見できる可能性があります。  
+  
+ WPF アーキテクチャおよびプログラミング モデルの詳細については、次のトピックを参照してください。  
+  
+-   [WPF アーキテクチャ](../../../../docs/framework/wpf/advanced/wpf-architecture.md)  
+  
+-   [XAML の概要 \(WPF\)](../../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)  
+  
+-   [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)  
+  
+-   [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)  
+  
+ アプリケーションの作成の詳細については、次のトピックを参照してください。  
+  
+-   [アプリケーション開発](../../../../docs/framework/wpf/app-development/index.md)  
+  
+-   [コントロール](../../../../docs/framework/wpf/controls/index.md)  
+  
+-   [データ バインドの概要](../../../../docs/framework/wpf/data/data-binding-overview.md)  
+  
+-   [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)  
+  
+-   [WPF のドキュメント](../../../../docs/framework/wpf/advanced/documents-in-wpf.md)  
+  
+## 参照  
+ [パネルの概要](../../../../docs/framework/wpf/controls/panels-overview.md)   
+ [データ テンプレートの概要](../../../../docs/framework/wpf/data/data-templating-overview.md)   
+ [WPF アプリケーションのビルド](../../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)   
+ [スタイルおよびテンプレート](../../../../docs/framework/wpf/controls/styles-and-templates.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/getting-started/whats-new.md b/docs/framework/wpf/getting-started/whats-new.md
new file mode 100644
index 00000000000..20981653e37
--- /dev/null
+++ b/docs/framework/wpf/getting-started/whats-new.md
@@ -0,0 +1,136 @@
+---
+title: "WPF Version 4.5 の新機能 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Windows Presentation Foundation, 新機能"
+  - "WPF, 新機能"
+ms.assetid: db086ae4-70bb-4862-95db-2eaca5216bc3
+caps.latest.revision: 55
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 55
+---
+# WPF Version 4.5 の新機能
+<a name="introduction"></a> このトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] Version 4.5 の新機能および拡張機能について説明します。  
+  
+ このトピックには以下のセクションがあります。  
+  
+-   [リボン コントロール](#ribbon_control)  
+  
+-   [グループ化された大きなデータ セットを表示する際のパフォーマンスが向上](#grouped_virtualization)  
+  
+-   [VirtualizingPanel の新機能](#VirtualizingPanel)  
+  
+-   [静的プロパティへのバインド](#static_properties)  
+  
+-   [非 UI スレッドでのコレクションへのアクセス](#xthread_access)  
+  
+-   [データの同期および非同期検証](#INotifyDataErrorInfo)  
+  
+-   [データ バインディングのソースの自動更新](#delay)  
+  
+-   [ICustomTypeProvider を実装する型へのバインド](#ICustomTypeProvider)  
+  
+-   [バインディング式からのデータ バインディング情報の取得](#binding_state)  
+  
+-   [有効な DataContext オブジェクトの確認](#DisconnectedSource)  
+  
+-   [データの値変更に伴うデータの再配置 \(ライブ形成\)](#live_shaping)  
+  
+-   [イベントへの弱い参照確立のサポート強化](#weak_event_pattern)  
+  
+-   [ディスパッチャー クラスの新しいメソッド](#async)  
+  
+-   [イベントのマークアップ拡張機能](#events_markup_extenions)  
+  
+<a name="ribbon_control"></a>   
+## リボン コントロール  
+ WPF 4.5 には、クイック アクセス ツール バー、アプリケーション メニュー、タブをホストする <xref:System.Windows.Controls.Ribbon.Ribbon> コントロールが付属しています。  詳細については、「[リボンの概要](../Topic/Ribbon%20Overview.md)」を参照してください。  
+  
+<a name="grouped_virtualization"></a>   
+## グループ化された大きなデータ セットを表示する際のパフォーマンスが向上  
+ UI の仮想化は、ユーザー インターフェイス \(UI\) 要素のサブセットが画面上に表示する項目に基づいて、より多くのデータ項目から生成されるときに行われます。  <xref:System.Windows.Controls.VirtualizingPanel> は、グループ化されたデータの UI の仮想化を有効にする <xref:System.Windows.Controls.VirtualizingPanel.IsVirtualizingWhenGrouping%2A> 添付プロパティを定義します。  データのグループ化の詳細については、「How to: Sort and Group Data Using a View in XAML」\(方法: XAML のビューを使用したデータの並べ替えとグループ化\) を参照してください。  グループ化されたデータの仮想化の詳細については、<xref:System.Windows.Controls.VirtualizingPanel.IsVirtualizingWhenGrouping%2A> 添付プロパティを参照してください。  
+  
+<a name="VirtualizingPanel"></a>   
+## VirtualizingPanel の新機能  
+  
+1.  <xref:System.Windows.Controls.VirtualizingPanel.ScrollUnit%2A> 添付プロパティを指定することで、<xref:System.Windows.Controls.VirtualizingPanel> \(<xref:System.Windows.Controls.VirtualizingStackPanel> など\) に部分的な項目を表示するかどうかを指定できます。  <xref:System.Windows.Controls.VirtualizingPanel.ScrollUnit%2A> が <xref:System.Windows.Controls.ScrollUnit> に設定されている場合、<xref:System.Windows.Controls.VirtualizingPanel> には完全に表示される項目だけが表示されます。  <xref:System.Windows.Controls.VirtualizingPanel.ScrollUnit%2A> が <xref:System.Windows.Controls.ScrollUnit> に設定されている場合、<xref:System.Windows.Controls.VirtualizingPanel> には部分的に表示される項目も表示されます。  
+  
+2.  <xref:System.Windows.Controls.VirtualizingPanel.CacheLength%2A> 添付プロパティを使用して <xref:System.Windows.Controls.VirtualizingPanel> を仮想化すると、ビューポートの前後でキャッシュのサイズを指定できます。  キャッシュは、項目が仮想化されないビューポートの上または下の領域の量です。  キャッシュを使用して、UI 要素がビューにスクロールされたときに UI 要素が生成されないようすると、パフォーマンスが向上します。  キャッシュは、操作中にアプリケーションが応答を停止しないように低い優先度で実行されます。  <xref:System.Windows.Controls.VirtualizingPanel.CacheLengthUnit%2A?displayProperty=fullName> プロパティは、<xref:System.Windows.Controls.VirtualizingPanel.CacheLength%2A?displayProperty=fullName> により使用される測定単位を決定します。  
+  
+<a name="static_properties"></a>   
+## 静的プロパティへのバインド  
+ データ バインディングのソースとして静的プロパティを使用できます。  データ バインディング エンジンは、静的イベントが発生した場合にプロパティの値が変更されたことを認識します。  たとえば、`SomeClass` クラスが `MyProperty` という静的プロパティを定義している場合、`SomeClass` は `MyProperty` の値が変更されたときに発生する静的イベントを定義できます。  静的イベントは、次のいずれかのシグネチャを使用できます。  
+  
+-   `public static event EventHandler MyPropertyChanged;`  
+  
+-   `public static event EventHandler<PropertyChangedEventArgs> StaticPropertyChanged;`  
+  
+ Note that in the first case, the class exposes a static event named *PropertyName*`Changed` that passes <xref:System.EventArgs> to the event handler.  2 番目のケースでは、イベント ハンドラーに <xref:System.ComponentModel.PropertyChangedEventArgs> を渡す `StaticPropertyChanged` という名前の静的イベントがクラスにより公開されています。  静的プロパティを実装するクラスは、いずれかの方法を使用してプロパティ変更通知を生成することを選択できます。  
+  
+<a name="xthread_access"></a>   
+## 非 UI スレッドでのコレクションへのアクセス  
+ WPF により、コレクションで作成されたスレッド以外のスレッドでデータ コレクションにアクセスして変更することが可能になります。  このため、バックグラウンド スレッドを使用して、データベースなどの外部ソースからデータを受信し、UI スレッドにデータを表示することができます。  別のスレッドを使用してコレクションを変更することで、ユーザー インターフェイスはユーザー操作への応答を維持します。  
+  
+<a name="INotifyDataErrorInfo"></a>   
+## データの同期および非同期検証  
+ <xref:System.ComponentModel.INotifyDataErrorInfo> インターフェイスにより、データ エンティティ クラスは、ユーザー定義の検証規則を実装し、検証結果を非同期的に公開することができます。  このインターフェイスは、カスタム エラー オブジェクト、プロパティごとの複数のエラー、プロパティ間のエラー、およびエンティティ レベルのエラーもサポートします。  詳細については、「<xref:System.ComponentModel.INotifyDataErrorInfo>」を参照してください。  
+  
+<a name="delay"></a>   
+## データ バインディングのソースの自動更新  
+ データ バインディングを使用してデータ ソースを更新する場合、<xref:System.Windows.Data.BindingBase.Delay%2A> プロパティを使用して、ターゲットでプロパティが変更されてからソースが更新されるまでの時間の長さを指定できます。  たとえば、<xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> プロパティ データがデータ オブジェクトのプロパティに双方向にバインドされた <xref:System.Windows.Controls.Slider> があり、<xref:System.Windows.Data.Binding.UpdateSourceTrigger%2A> プロパティが <xref:System.Windows.Data.UpdateSourceTrigger> に設定されているとします。  この例では、ユーザーが <xref:System.Windows.Controls.Slider> を移動すると、<xref:System.Windows.Controls.Slider> が移動する各ピクセルのソースが更新されます。  <xref:System.Windows.Controls.Primitives.RangeBase.Value%2A> が変更を停止した場合、ソース オブジェクトには通常スライダーの値のみ必要です。  ソースがあまり頻繁に更新されないようにするには、<xref:System.Windows.Data.BindingBase.Delay%2A> を使用して、Thumb が移動を停止してから一定の時間が経過するまでソースが更新されないように指定します。  
+  
+<a name="ICustomTypeProvider"></a>   
+## ICustomTypeProvider を実装する型へのバインド  
+ WPF では、<xref:System.Reflection.ICustomTypeProvider> を実装するオブジェクトへのデータ バインディングがサポートされます \(カスタムの型とも呼ばれます\)。  カスタムの型は、次の場合に使用できます。  
+  
+1.  データ バインディングにおける <xref:System.Windows.PropertyPath> として。  たとえば、<xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.Binding.Path%2A> プロパティは、カスタムの型のプロパティを参照できます。  
+  
+2.  <xref:System.Windows.DataTemplate.DataType%2A> プロパティの値として。  
+  
+3.  <xref:System.Windows.Controls.DataGrid> で自動的に生成された列を決定する型として。  
+  
+<a name="binding_state"></a>   
+## バインディング式からのデータ バインディング情報の取得  
+ 場合によっては、<xref:System.Windows.Data.Binding> の <xref:System.Windows.Data.BindingExpression> を取得することがあり、バインディングのソースとターゲットのオブジェクトに関する情報を必要となる可能性があります。  ソースまたはターゲットのオブジェクトや関連プロパティを取得できるように、新しい API が追加されました。  <xref:System.Windows.Data.BindingExpression> がある場合、次の API を使用してターゲットおよびソースに関する情報を取得します。  
+  
+|検出するバインディングの値|使用する API|  
+|-------------------|--------------|  
+|ターゲット オブジェクト|<xref:System.Windows.Data.BindingExpressionBase.Target%2A?displayProperty=fullName>|  
+|ターゲット プロパティ|<xref:System.Windows.Data.BindingExpressionBase.TargetProperty%2A?displayProperty=fullName>|  
+|ソース オブジェクト|<xref:System.Windows.Data.BindingExpression.ResolvedSource%2A?displayProperty=fullName>|  
+|ソース プロパティ|<xref:System.Windows.Data.BindingExpression.ResolvedSourcePropertyName%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Data.BindingExpression> が <xref:System.Windows.Data.BindingGroup> に属するかどうか|<xref:System.Windows.Data.BindingExpressionBase.BindingGroup%2A?displayProperty=fullName>|  
+|<xref:System.Windows.Data.BindingGroup> の所有者|<xref:System.Windows.Data.BindingGroup.Owner%2A>|  
+  
+<a name="DisconnectedSource"></a>   
+## 有効な DataContext オブジェクトの確認  
+ <xref:System.Windows.Controls.ItemsControl> にある項目のコンテナーの <xref:System.Windows.FrameworkElement.DataContext%2A> が切断されるケースがあります。  項目コンテナーは、<xref:System.Windows.Controls.ItemsControl> に項目を表示する UI 要素です。  <xref:System.Windows.Controls.ItemsControl> がコレクションにバインドされたデータの場合、項目コンテナーは項目ごとに生成されます。  場合によっては、項目コンテナーがビジュアル ツリーから削除されます。  項目コンテナーが削除される 2 つの一般的なケースは、項目が基になるコレクションから削除されたときと、仮想化が <xref:System.Windows.Controls.ItemsControl> で有効になっているときです。  このような場合、項目コンテナーの <xref:System.Windows.FrameworkElement.DataContext%2A> プロパティは、<xref:System.Windows.Data.BindingOperations.DisconnectedSource%2A?displayProperty=fullName> の静的プロパティから返されるオブジェクトのセンティネル オブジェクトに設定されます。  項目コンテナーの <xref:System.Windows.FrameworkElement.DataContext%2A> にアクセスする前に、<xref:System.Windows.FrameworkElement.DataContext%2A> が <xref:System.Windows.Data.BindingOperations.DisconnectedSource%2A> オブジェクトと等しいかどうかを確認する必要があります。  
+  
+<a name="live_shaping"></a>   
+## データの値変更に伴うデータの再配置 \(ライブ形成\)  
+ データのコレクションは、グループ化、並べ替え、またはフィルター処理が可能です。  WPF 4.5 により、データが変更されたときの再配置が可能になります。  たとえば、アプリケーションが <xref:System.Windows.Controls.DataGrid> を使用して株式市場の株式を一覧表示し、株式が株価によって並べ替えられるとします。  株式の <xref:System.Windows.Data.CollectionView> でライブ並べ替えが有効な場合、株式が別の株式の価格を上回るか下回ると、<xref:System.Windows.Controls.DataGrid> における株式の位置が移動します。  詳細については、<xref:System.ComponentModel.ICollectionViewLiveShaping> インターフェイスのトピックを参照してください。  
+  
+<a name="weak_event_pattern"></a>   
+## イベントへの弱い参照確立のサポート強化  
+ 追加のインターフェイスを実装しなくてもイベントへのサブスクライバーがイベントに参加できるため、弱いパターンの実装が簡単になりました。  一般的な <xref:System.Windows.WeakEventManager> クラスでは、専用の <xref:System.Windows.WeakEventManager> が特定のイベントに存在しない場合は、サブスクライバーが弱いイベント パターンにも参加できるようになりました。  詳細については、「[弱いイベント パターン](../../../../docs/framework/wpf/advanced/weak-event-patterns.md)」を参照してください。  
+  
+<a name="async"></a>   
+## ディスパッチャー クラスの新しいメソッド  
+ ディスパッチャー クラスは、同期操作および非同期操作の新しいメソッドを定義します。  同期メソッドである <xref:System.Windows.Threading.Dispatcher.Invoke%2A> は、<xref:System.Action> パラメーターまたは <xref:System.Func%601> パラメーターを受け取るオーバーロードを定義します。  新しい非同期メソッドである <xref:System.Windows.Threading.Dispatcher.InvokeAsync%2A>は、コールバック パラメーターとして <xref:System.Action> か <xref:System.Func%601> を受け取り、<xref:System.Windows.Threading.DispatcherOperation> か <xref:System.Windows.Threading.DispatcherOperation%601> を返します。  <xref:System.Windows.Threading.DispatcherOperation> クラスと <xref:System.Windows.Threading.DispatcherOperation%601> クラスは、<xref:System.Threading.Tasks.Task> プロパティを定義します。  <xref:System.Windows.Threading.Dispatcher.InvokeAsync%2A> を呼び出すと、<xref:System.Windows.Threading.DispatcherOperation> または関連付けられた <xref:System.Threading.Tasks.Task>の `await` を持つキーワードを使用できます。  <xref:System.Windows.Threading.DispatcherOperation> または <xref:System.Windows.Threading.DispatcherOperation%601> によって返される <xref:System.Threading.Tasks.Task> を同期的に待機する必要がある場合、<xref:System.Windows.Threading.TaskExtensions.DispatcherOperationWait%2A> 拡張メソッドを呼び出します。  <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> を呼び出すと、呼び出し元スレッドで操作がキューに置かれた場合はデッドロックが発生します。  <xref:System.Threading.Tasks.Task> を使用して非同期操作を実行する方法の詳細については、「[タスクの並列化 \(タスク並列ライブラリ\)](../../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)」を参照してください。  
+  
+<a name="events_markup_extenions"></a>   
+## イベントのマークアップ拡張機能  
+ WPF 4.5 では、イベントのマークアップ拡張機能がサポートされます。  WPF はイベントに使用されるマークアップ拡張機能を定義しませんが、サードパーティがイベントで使用できるマークアップ拡張機能を作成できます。  
+  
+## 参照  
+ [.NET Framework の新機能](../../../../docs/framework/whats-new/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/getting-started/wpf-walkthroughs.md b/docs/framework/wpf/getting-started/wpf-walkthroughs.md
new file mode 100644
index 00000000000..02a4af601ba
--- /dev/null
+++ b/docs/framework/wpf/getting-started/wpf-walkthroughs.md
@@ -0,0 +1,60 @@
+---
+title: "WPF のチュートリアル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "チュートリアル [WPF]"
+  - "WPF チュートリアル"
+ms.assetid: c29bde96-0389-4aff-a9fb-cd678f66b7f7
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# WPF のチュートリアル
+チュートリアルでは、一般的なシナリオでの操作手順を詳しく説明します。  このため、製品や特定の機能領域について知るための最初のステップとして適しています。  
+  
+ このトピックには、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] のチュートリアルへのリンクが含まれています。  
+  
+## WPF デザイナーのチュートリアル  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[チュートリアル : WPF デザイナーでの簡単な WPF アプリケーションの作成](http://msdn.microsoft.com/ja-jp/2d412231-dbdf-4e69-b060-4f2b246c2027)|[!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]による簡単な WPF アプリケーションのビルド方法を説明します。|  
+|[チュートリアル : 動的レイアウトの構築](http://msdn.microsoft.com/ja-jp/483aafbb-b29d-435a-b956-8e4f67cd4a0f)|<xref:System.Windows.Controls.Grid> パネル コントロールを使用した動的レイアウトの作成方法を説明します。|  
+|[チュートリアル : WPF デザイナーによるサイズ変更可能なアプリケーションの作成](http://msdn.microsoft.com/ja-jp/18f5271e-4dc6-4eef-bc20-bb8862045d2e)|実行時にユーザーがサイズ変更できるウィンドウ レイアウトの作成方法を説明します。|  
+|[チュートリアル: WPF デザイナーによるデータ バインディングの作成](http://msdn.microsoft.com/ja-jp/8a79ed20-d59f-46b8-944f-6fd5dbb4e278)|[!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]を使用してコントロールにデータを接続するデータ バインディングを作成する方法を説明します。|  
+|[チュートリアル: デザイナーでの DesignInstance によるデータへのバインド](http://msdn.microsoft.com/ja-jp/a4d3747a-bd43-42bc-b66d-477856a6769c)|実行時に割り当てられるデータ コンテキストのデザイン時に [!INCLUDE[wpfdesigner_current_short](../../../../includes/wpfdesigner-current-short-md.md)]を使用してデータ バインディングを作成する方法を説明します。|  
+  
+## WPF のチュートリアル  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)|コントロール、レイアウト、データ バインドなど、WPF の多数の一般的な機能を使用した WPF アプリケーションの作成について説明します。|  
+|[XAML を使用したボタンの作成](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-xaml.md)|アニメーション ボタンの作成方法について説明します。|  
+|[Microsoft Expression Blend を使用してボタンを作成する](../../../../docs/framework/wpf/controls/walkthrough-create-a-button-by-using-microsoft-expression-blend.md)|Microsoft Expression Blend を使用して、カスタマイズされたボタンを作成するプロセスを説明します。|  
+|[チュートリアル: DataGrid コントロールで SQL Server データベースのデータを表示する](../../../../docs/framework/wpf/controls/walkthrough-display-data-from-a-sql-server-database-in-a-datagrid-control.md)|SQL Server データベースからデータを取得して、<xref:System.Windows.Controls.DataGrid> コントロールでそのデータを表示する方法を説明します。|  
+  
+## WPF における移行と相互運用性  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[チュートリアル: WPF での Windows フォーム コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-control-in-wpf.md)|WPF アプリケーションで Windows フォーム <xref:System.Windows.Forms.MaskedTextBox?displayProperty=fullName> コントロールをホストする方法を説明します。|  
+|[チュートリアル: WPF での Windows フォーム複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-windows-forms-composite-control-in-wpf.md)|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションで [!INCLUDE[TLA2#tla_winforms](../../../../includes/tla2sharptla-winforms-md.md)] データ エントリ複合コントロールをホストする方法を説明します。|  
+|[チュートリアル: Windows フォームでの WPF 複合コントロールのホスト](../../../../docs/framework/wpf/advanced/walkthrough-hosting-a-wpf-composite-control-in-windows-forms.md)|Windows フォーム アプリケーションで WPF データ エントリ複合コントロールをホストする方法を説明します。|  
+|[チュートリアル: WPF での Windows フォーム コントロールの配置](../../../../docs/framework/wpf/advanced/walkthrough-arranging-windows-forms-controls-in-wpf.md)|WPF レイアウト機能を使用してハイブリッド アプリケーションに Windows フォーム コントロールを配置する方法を説明します。|  
+|[チュートリアル : ハイブリッド アプリケーションでのデータへのバインディング](../../../../docs/framework/wpf/advanced/walkthrough-binding-to-data-in-hybrid-applications.md)|Windows フォーム コントロールと WPF コントロールの両方を含むハイブリッド アプリケーションで、データ バインディングを使用する方法を説明します。|  
+  
+## 関連項目  
+  
+|Title|Description|  
+|-----------|-----------------|  
+|[Visual Studio Walkthroughs](http://msdn.microsoft.com/ja-jp/f5399a1f-2d3d-42fb-b989-134ccda2159f)|Visual Studio でのプログラミングのあらゆる領域に関連するチュートリアルの一覧を示します。|
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/3-d-graphics-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/3-d-graphics-how-to-topics.md
new file mode 100644
index 00000000000..2cd5ae9211f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/3-d-graphics-how-to-topics.md
@@ -0,0 +1,56 @@
+---
+title: "3-D グラフィックスに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "3-D グラフィックス"
+  - "グラフィックス [WPF], 3-D"
+ms.assetid: 4f091835-28d1-498c-b660-9b3acf34ed13
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# 3-D グラフィックスに関する「方法」トピック
+このセクションのトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] アプリケーションで [!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] グラフィックスを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)  
+ [3\-D モデルに描画を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-a-drawing-to-a-3-d-model.md)  
+ [3\-D オブジェクトの前面および背面に素材を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md)  
+ [3\-D モデルに放射性素材を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-emissive-material-to-a-3-d-object.md)  
+ [3\-D モデルのスケールを変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-transform-the-scale-of-a-3-d-model.md)  
+ [複数の変換を 3\-D モデルに適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transformations-to-a-3-d-model.md)  
+ [3\-D 変換をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-3-d-translations.md)  
+ [ストーリーボードを使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md)  
+ [Rotation3DAnimation を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md)  
+ [四元数を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md)  
+ [キー フレーム \(Rotation3DAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md)  
+ [キー フレーム \(QuaternionAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/animate-a-3-d-rotation-quaternionanimationusingkeyframes.md)  
+ [3D シーンでカメラの位置および方向をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-in-a-3d-scene.md)  
+ [キー フレームを使用してカメラの位置および方向をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-using-key-frames.md)  
+ [3\-D シーンで素材プロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md)  
+ [Viewport3D でヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-in-a-viewport3d.md)  
+ [Point4D 構造体が等価かどうかをテストする](../../../../docs/framework/wpf/graphics-multimedia/how-to-test-point4d-structures-for-equality-and-inequality.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Viewport3D>  
+  
+ <xref:System.Windows.Media.Media3D.PerspectiveCamera>  
+  
+ <xref:System.Windows.Media.Media3D.DirectionalLight>  
+  
+ <xref:System.Windows.Media.Media3D.Material>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md b/docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md
new file mode 100644
index 00000000000..1e4d04d4d78
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md
@@ -0,0 +1,184 @@
+---
+title: "3-D グラフィックスの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D グラフィックス"
+  - "グラフィックス [WPF], 3-D"
+ms.assetid: 67f31ed4-e36b-4b02-9889-dcce245d7afc
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 3-D グラフィックスの概要
+<a name="introduction"></a> [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] 機能により、マークアップ コードおよび手順コードの両方で、開発者は 3\-D グラフィックスを描画、変換、およびアニメーション化できます。  開発者は、[!INCLUDE[TLA#tla_2d](../../../../includes/tlasharptla-2d-md.md)] グラフィックスと [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] グラフィックスを組み合わせることで、多彩なコントロールを作成したり、複雑なイラストレーションのデータを提供したり、アプリケーション インターフェイスのユーザー エクスペリエンスを向上させることができます。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] での [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] サポートは、多機能なゲーム開発プラットフォームを提供するために設計されたものではありません。このトピックでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] グラフィックス システムの [!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] 機能の概要について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="threed_in_2d"></a>   
+## 2\-D コンテナー内の 3\-D グラフィックス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] グラフィックス コンテンツは、2 次元要素の構造内に追加できる <xref:System.Windows.Controls.Viewport3D> 要素内にカプセル化されます。  グラフィックス システムでは、他の多くの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] と同様に、<xref:System.Windows.Controls.Viewport3D> を 2 次元のビジュアル要素として扱います。  <xref:System.Windows.Controls.Viewport3D> は、3 次元シーンへのウィンドウ \(ビューポート\) として機能します。  正確には、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンが投影されるサーフェイスです。  
+  
+ 従来の [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] アプリケーションでは、Grid や Canvas などの他のコンテナー要素と同じように <xref:System.Windows.Controls.Viewport3D> を使用します。  <xref:System.Windows.Controls.Viewport3D> と他の [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] 描画オブジェクトを同じシーン グラフで使用することはできますが、<xref:System.Windows.Controls.Viewport3D> 内で [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] オブジェクトと [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトを相互に貫入させることはできません。  ここでは、<xref:System.Windows.Controls.Viewport3D> 内で [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] グラフィックスを描画する方法を中心に説明します。  
+  
+<a name="coord_space"></a>   
+## 3\-D 座標空間  
+ [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] グラフィックスの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 座標系では、レンダリング領域 \(通常は画面\) の左上に原点を置きます。  [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] 座標系では、正の x 軸の値で右に移動し、正の y 軸の値で下に移動します。  しかし、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] 座標系では、原点はレンダリング領域の中心に置かれ、正の x 軸の値で右に移動しますが、正の y 軸の値では上に移動し、さらに正の z 軸の値で原点から離れて閲覧者に向かう方向に移動します。  
+  
+ ![座標系](../../../../docs/framework/wpf/graphics-multimedia/media/coordsystem-1.png "CoordSystem\-1")  
+従来の 2\-D 座標系および 3\-D 座標系の表現  
+  
+ これらの軸によって定義される空間は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトを参照する静止座標系です。  この座標空間にモデルを構築し、照明とカメラを作成して表示するときに、この静止座標系、つまり "ワールド座標" と、変換を適用するときにモデルごとに作成するローカル座標とを区別すると役に立ちます。  また、ワールド座標のオブジェクトは、照明とカメラの設定によってまったく違って見えたり何も表示されないことがあります。ただし、カメラの位置によってワールド座標におけるオブジェクトの場所が変わることはありません。  
+  
+<a name="cameras"></a>   
+## カメラと投影  
+ [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] を操作する開発者は、2 次元の画面上に描画プリミティブを配置することに慣れています。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンを作成するときには、実際は [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトの [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] 表現を作成しているということを忘れないことが重要です。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンは閲覧者の視点によって異なって見えるため、視点を指定する必要があります。  この [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンの視点は、<xref:System.Windows.Media.Media3D.Camera> クラスによって指定できます。  
+  
+ [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンを [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] サーフェイス上で表現する方法を理解するために、表示するサーフェイス上への投影としてシーンを説明することもできます。  <xref:System.Windows.Media.Media3D.ProjectionCamera> では、閲覧者からの [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] モデルの見え方を変化させる多様な投影とそのプロパティを指定できます。  <xref:System.Windows.Media.Media3D.PerspectiveCamera> は、シーンを遠近短縮する投影を指定します。  つまり、<xref:System.Windows.Media.Media3D.PerspectiveCamera> は、消失点の視野を提供します。  シーンの座標空間内のカメラの位置、カメラの向きと視野、およびシーン内での "上" の方向を定義するベクターを指定できます。  <xref:System.Windows.Media.Media3D.PerspectiveCamera> の投影を表す図を次に示します。  
+  
+ <xref:System.Windows.Media.Media3D.ProjectionCamera> の <xref:System.Windows.Media.Media3D.ProjectionCamera.NearPlaneDistance%2A> プロパティと <xref:System.Windows.Media.Media3D.ProjectionCamera.FarPlaneDistance%2A> プロパティは、カメラの投影の範囲を制限します。  カメラはシーン内の任意の場所に配置できるため、カメラの実際の配置がモデルの内部だったりモデルに近すぎたりして、オブジェクトを適切に識別できなくなる可能性もあります。  <xref:System.Windows.Media.Media3D.ProjectionCamera.NearPlaneDistance%2A> では、その距離を超えるとオブジェクトが描画されなくなる、カメラからの最短の距離を指定できます。  逆に、<xref:System.Windows.Media.Media3D.ProjectionCamera.FarPlaneDistance%2A> では、識別できないほど離れたオブジェクトがシーンに含まれないように、その距離を超えるとオブジェクトが描画されなくなる、カメラからの最長の距離を指定できます。  
+  
+ ![カメラ設定](../../../../docs/framework/wpf/graphics-multimedia/media/coordsystem-6.png "CoordSystem\-6")  
+カメラの位置  
+  
+ <xref:System.Windows.Media.Media3D.OrthographicCamera> は、[!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] ビジュアル サーフェイスに対する [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] モデルの正投影を指定します。  他のカメラと同様に、位置、表示方向、および "上向き" 方向を指定します。  ただし、<xref:System.Windows.Media.Media3D.PerspectiveCamera> とは異なり、<xref:System.Windows.Media.Media3D.OrthographicCamera> は遠近短縮を含まない投影を記述します。  つまり、<xref:System.Windows.Media.Media3D.OrthographicCamera> は、辺がカメラの 1 点に集まる表示ボックスではなく、辺が平行な表示ボックスを記述します。  次の図は、<xref:System.Windows.Media.Media3D.PerspectiveCamera> および <xref:System.Windows.Media.Media3D.OrthographicCamera> を使用して表示した同じモデルを示しています。  
+  
+ ![正投影とパースペクティブ射影](../../../../docs/framework/wpf/graphics-multimedia/media/camera-projections4.png "Camera\_projections4")  
+透視投影と正投影  
+  
+ 次のコードは、一般的なカメラの設定を示しています。  
+  
+ [!code-csharp[3dgallery_procedural_snip#Basic3DShapeCodeExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/Basic3DShapeExample.cs#basic3dshapecodeexampleinline1)]
+ [!code-vb[3dgallery_procedural_snip#Basic3DShapeCodeExampleInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/basic3dshapeexample.vb#basic3dshapecodeexampleinline1)]  
+  
+<a name="models_meshes"></a>   
+## モデルとメッシュ プリミティブ  
+ <xref:System.Windows.Media.Media3D.Model3D> は、汎用 [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトを表す抽象基本クラスです。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーンを構築するには、表示するためのオブジェクトが必要です。シーン グラフを構成するオブジェクトは、<xref:System.Windows.Media.Media3D.Model3D> から派生します。  現在、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、<xref:System.Windows.Media.Media3D.GeometryModel3D> でモデリングするジオメトリをサポートしています。  このモデルの <xref:System.Windows.Media.Media3D.GeometryModel3D.Geometry%2A> プロパティは、メッシュ プリミティブを受け取ります。  
+  
+ モデルを構築するには、プリミティブまたはメッシュを構築することから開始します。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] プリミティブは、単一の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] エンティティを形成する頂点のコレクションです。  大多数の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] システムは、最も単純な閉じた図形、つまり 3 つの頂点で定義された三角形に基づいてモデル化されるプリミティブを提供します。  三角形の 3 つの点は同一平面上にあるため、さらに複雑な図形 \(メッシュ\) をモデル化するために引き続きいくつかの三角形を追加できます。  
+  
+ 現在の [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] システムには、ジオメトリを指定できる <xref:System.Windows.Media.Media3D.MeshGeometry3D> クラスが用意されています。現時点では、球体や立方体のような定義済みの [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] プリミティブはサポートしていません。  三角形の頂点のリストを <xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> プロパティとして指定して、<xref:System.Windows.Media.Media3D.MeshGeometry3D> の作成を開始します。  各頂点は、<xref:System.Windows.Media.Media3D.Point3D> として指定します   \([!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、各頂点の座標を表して 3 つにグループ化した数値のリストとしてこのプロパティを指定します\)。ジオメトリに応じて、メッシュは、一部が同じ角 \(頂点\) を共有する数多くの三角形で構成される場合があります。  メッシュを正しく描画するために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は複数の三角形が共有する頂点に関する情報を必要とします。  この情報を与えるには、三角形のインデックスのリストとその <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A> プロパティを指定します。  このリストは、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> リストに指定された点が三角形を決定する順序を示します。  
+  
+ [!code-xml[basic3d#Basic3DXAML3DN3](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Basic3D/XAML/Window1.xaml#basic3dxaml3dn3)]  
+  
+ 前の例で、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> リストには、立方体の形状のメッシュを定義する 8 つの頂点を指定しています。  <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A> プロパティでは、3 つのインデックスの 12 のグループのリストを指定しています。  リスト内の各数値は、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> リストへのオフセットを参照します。  たとえば、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> リストで指定される最初の 3 つの頂点は、\(1,1,0\)、\(0,1,0\)、および \(0,0,0\) です。  <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A> リストに指定される最初の 3 つのインデックスは、0、2、および 1 です。これは、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A> リスト内の 1 番目の点、3 番目の点、2 番目の点に対応します。  結果として、立方体モデルを形成する最初の三角形は \(1,1,0\) から \(0,1,0\)、\(0,0,0\) で構成され、残りの 11 の三角形も同様に決定されます。  
+  
+ <xref:System.Windows.Media.Media3D.MeshGeometry3D.Normals%2A> プロパティおよび <xref:System.Windows.Media.Media3D.MeshGeometry3D.TextureCoordinates%2A> プロパティの値を指定して、モデルの定義を続行できます。  モデルのサーフェイスをレンダリングするために、グラフィックス システムは、指定された任意の三角形でサーフェイスが向いている方向に関する情報を必要とします。  この情報はモデルの光源計算に使用されます。直接光源に向いているサーフェイスは、光源から離れた角度のサーフェイスよりも明るく見えます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、位置座標を使用して既定の法線ベクターを決定できます。曲面のサーフェイスの外観に接する別の法線ベクターを指定することもできます。  
+  
+ <xref:System.Windows.Media.Media3D.MeshGeometry3D.TextureCoordinates%2A> プロパティは、メッシュの頂点にテクスチャを描画する方法を決定する座標のマッピング方法をグラフィックス システムに通知する <xref:System.Windows.Point> のコレクションを指定します。  <xref:System.Windows.Media.Media3D.MeshGeometry3D.TextureCoordinates%2A> は、0 ～ 1 の値として指定されます。  <xref:System.Windows.Media.Media3D.MeshGeometry3D.Normals%2A> プロパティの場合と同様に、グラフィックス システムは既定のテクスチャ座標を計算できますが、たとえば、繰り返すパターンの一部を含むテクスチャのマッピングを制御する別のテクスチャ座標の設定を選択することもできます。  テクスチャ座標に関する追加の情報は、後続のトピックまたは Managed Direct3D SDK を参照してください。  
+  
+ 手順コードで立方体モデルの 1 つの面を作成する方法を次の例に示します。  立方体の全体を単一の GeometryModel3D として描画できます。この例では、後で各面に別々のテクスチャを適用するために、立方体の表面を別個のモデルとして描画しています。  
+  
+ [!code-csharp[3doverview#3DOverview3DN6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn6)]
+ [!code-vb[3doverview#3DOverview3DN6](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn6)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn7)]
+ [!code-vb[3doverview#3DOverview3DN7](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn7)]  
+  
+<a name="materials"></a>   
+## モデルへのマテリアルの適用  
+ メッシュは 3 次元オブジェクトのように見えますが、光を発してカメラに映るには、頂点と三角形によって定義されるサーフェイスを覆うテクスチャの適用が必要です。  [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] では、<xref:System.Windows.Media.Brush> クラスを使用して、色、パターン、グラデーション、または他のビジュアル コンテンツを画面の領域に適用します。  しかし、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトの外観は、適用された単なる色またはパターンではなく、照明モデルの機能です。  実世界のオブジェクトは、サーフェイスの品質によって光の反射の仕方が異なります。光沢があって輝いているサーフェイスは、粗くマットなサーフェイスの外観と同じではありません。光を吸収するように見えるオブジェクトもあれば、光を放つように見えるオブジェクトもあります。  [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] オブジェクトに適用できるブラシはすべて [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] オブジェクトにも適用できますが、直接適用することはできません。  
+  
+ モデルのサーフェイスの特性を定義するために、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は <xref:System.Windows.Media.Media3D.Material> 抽象クラスを使用します。  Material の具象サブクラスは、モデル サーフェイスの外観の特性の一部を決定します。それぞれが、SolidColorBrush、TileBrush、または VisualBrush を渡す Brush プロパティを提供します。  
+  
+-   <xref:System.Windows.Media.Media3D.DiffuseMaterial> は、そのモデルが光を拡散させるかのように、ブラシをモデルに適用することを指定します。  DiffuseMaterial の使用は、[!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] モデルに直接ブラシを使用することに似ています。モデルのサーフェイスは光沢のようには光を反射しません。  
+  
+-   <xref:System.Windows.Media.Media3D.SpecularMaterial> は、モデルのサーフェイスが硬質であるかのように、または光沢があってハイライトを反射できるかのように、ブラシをモデルに適用することを指定します。  <xref:System.Windows.Media.Media3D.SpecularMaterial.SpecularPower%2A> プロパティの値を指定することによって、この反射の品質 \("輝き"\) を示すテクスチャの度合いを設定できます。  
+  
+-   <xref:System.Windows.Media.Media3D.EmissiveMaterial> では、モデルがブラシの色と同じ光を放射しているかのように、テクスチャを適用することを指定できます。  これは、モデルを光源にするものではありませんが、DiffuseMaterial または SpecularMaterial でテクスチャを適用した場合とは異なる影を加えます。  
+  
+ パフォーマンスの向上のために、<xref:System.Windows.Media.Media3D.GeometryModel3D> の背面 \(これらの面は、カメラの反対側に位置するモデルの面なので、表示されません\) はシーンから除かれます。  <xref:System.Windows.Media.Media3D.Material> を指定して平面のようなモデルの背面に適用するには、モデルの <xref:System.Windows.Media.Media3D.GeometryModel3D.BackMaterial%2A> プロパティを設定します。  
+  
+ 光り輝く効果や反射の効果のようなサーフェイスの品質を実現するために、モデルに数種類のブラシを続けて適用することができます。  <xref:System.Windows.Media.Media3D.MaterialGroup> クラスを使用すると、複数のマテリアルを適用し、再利用できます。  MaterialGroup の子は、複数の描画パスの始めから終わりまで適用されます。  
+  
+ [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] モデルにブラシとして純色と描画を適用する方法を次のコード例に示します。  
+  
+ [!code-xml[basic3d#Basic3DXAML3DN5](../../../../samples/snippets/xaml/VS_Snippets_Wpf/Basic3D/XAML/Window1.xaml#basic3dxaml3dn5)]  
+  
+ [!code-xml[3doverview#3DOverview3DN9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/app.xaml#3doverview3dn9)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN8](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn8)]
+ [!code-vb[3doverview#3DOverview3DN8](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn8)]  
+  
+<a name="lights"></a>   
+## シーンの照明  
+ [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] グラフィックス内の光源は、現実の世界で光が果たす役割を果たします。つまり、サーフェイスを見えるようにします。  さらに、光源は、投影に含まれるシーンの部分を決定します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の光源オブジェクトは、多彩な光と影の効果を作り出し、現実の世界のさまざまな光源の振る舞いに従ってモデル化されます。  シーンには少なくとも 1 つの光源を入れる必要があります。そうしないと、モデルが表示されません。  
+  
+ 次の光源は、<xref:System.Windows.Media.Media3D.Light> 基本クラスから派生します。  
+  
+-   <xref:System.Windows.Media.Media3D.AmbientLight>: 位置や向きに関係なく、すべてのオブジェクトを一様に照らすアンビエント光を提供します。  
+  
+-   <xref:System.Windows.Media.Media3D.DirectionalLight>: 遠くにある光源のように照らします。  指向性のある光源には、Vector3D として指定される <xref:System.Windows.Media.Media3D.DirectionalLight.Direction%2A> はありますが、特定の位置はありません。  
+  
+-   <xref:System.Windows.Media.Media3D.PointLight>: 隣接する光源のように照らします。  PointLight には位置があり、その位置から光を投げかけます。  シーン内のオブジェクトは、その位置と、光源に対する距離に応じて照らされます。  <xref:System.Windows.Media.Media3D.PointLightBase> は <xref:System.Windows.Media.Media3D.PointLightBase.Range%2A> プロパティを公開します。これは、モデルが光源によって照らされなくなる距離を決定します。  PointLight は、光の強さが距離に応じて減少する割合を決定する減衰のプロパティを公開します。  光の減衰には定数補間、線形補間、または 2 次補間を指定できます。  
+  
+-   <xref:System.Windows.Media.Media3D.SpotLight>: <xref:System.Windows.Media.Media3D.PointLight> から継承します。  スポットライトは PointLight のように照らし、位置と方向の両方があります。  <xref:System.Windows.Media.Media3D.SpotLight.InnerConeAngle%2A> プロパティおよび <xref:System.Windows.Media.Media3D.SpotLight.OuterConeAngle%2A> プロパティによって設定される円すい形の領域に、指定された程度の光を投射します。  
+  
+ 光源は <xref:System.Windows.Media.Media3D.Model3D> オブジェクトなので、位置、色、方向、および範囲などの光源のプロパティを変換したり、アニメーション化したりできます。  
+  
+ [!code-xml[hittest3d#HitTest3D3DN6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTest3D/CSharp/Window1.xaml#hittest3d3dn6)]  
+  
+ [!code-csharp[basic3d#Basic3D3DN11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Basic3D/CSharp/Window1.xaml.cs#basic3d3dn11)]
+ [!code-vb[basic3d#Basic3D3DN11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Basic3D/visualbasic/window1.xaml.vb#basic3d3dn11)]  
+  
+ [!code-csharp[basic3d#Basic3D3DN12](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Basic3D/CSharp/Window1.xaml.cs#basic3d3dn12)]
+ [!code-vb[basic3d#Basic3D3DN12](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Basic3D/visualbasic/window1.xaml.vb#basic3d3dn12)]  
+  
+ [!code-csharp[basic3d#Basic3D3DN13](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Basic3D/CSharp/Window1.xaml.cs#basic3d3dn13)]
+ [!code-vb[basic3d#Basic3D3DN13](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Basic3D/visualbasic/window1.xaml.vb#basic3d3dn13)]  
+  
+<a name="transforms"></a>   
+## モデルの変換  
+ モデルを作成すると、モデルはシーン内の特定の場所に配置されます。  モデルをシーン内で移動したり、回転したり、サイズを変更したりするために、モデル自身を定義する頂点を変更するのは実用的ではありません。  代わりに、[!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] と同様、モデルに変換を適用します。  
+  
+ 各モデル オブジェクトには、<xref:System.Windows.Media.Media3D.Model3D.Transform%2A> プロパティがあり、モデルを移動したり、向きやサイズを変更したりできます。  変換を適用すると、変換で指定されたベクターまたは値だけ効果的にモデルのすべての点をオフセットすることができます。  つまり、モデルが定義されている座標空間 \(モデル空間\) を変換しても、シーン全体の座標系におけるモデルの図形座標 \(ワールド座標\) を構成する値は変更されません。  
+  
+ モデルの変換の詳細については、「[3\-D 変換の概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-transformations-overview.md)」を参照してください。  
+  
+<a name="animations"></a>   
+## モデルへのアニメーションの適用  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] 実装は、[!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] グラフィックスと同じタイミングとアニメーション システムに追加されます。  つまり、3\-D シーンにアニメーションを適用するには、そのモデルのプロパティにアニメーションを適用します。  プリミティブのプロパティに直接アニメーションを適用できますが、通常はモデルの位置や外観を変更する変換にアニメーションを適用する方が簡単です。  変換は、個々のモデル同様、<xref:System.Windows.Media.Media3D.Model3DGroup> オブジェクトに適用できるため、Model3DGroup の子にアニメーションのセットを適用し、子オブジェクトのグループに別のアニメーションのセットを適用することが可能です。  シーンの光源のプロパティをアニメーション化することによって、さまざまな視覚効果を実現できます。  最後に、カメラの位置または視野をアニメーション化することによって、投影自体をアニメーション化することもできます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のタイミングとアニメーション システムに関する背景情報については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」、および「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のオブジェクトをアニメーション化するには、タイムラインを作成し、アニメーションを定義し \(これは、実際は一定期間にわたって一部のプロパティ値を変更します\)、アニメーションを適用するプロパティを指定します。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] シーン内のすべてのオブジェクトは <xref:System.Windows.Controls.Viewport3D> の子であるため、シーンに適用するアニメーションの対象となるプロパティは、Viewport3D のプロパティになります。  
+  
+ モデルが同じ場所で揺れて見えるようにするとします。  モデルに <xref:System.Windows.Media.Media3D.RotateTransform3D> を適用して、あるベクターから別のベクターへの回転の軸にアニメーションを適用できます。  RotateTransform3D は TransformGroup でモデルに適用されている複数の変換の 1 つであるという前提で、Vector3DAnimation を変換の Rotation3D の Axis プロパティに適用する方法を次のコード例に示します。  
+  
+ [!code-csharp[3doverview#3DOverview3DN1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn1)]
+ [!code-vb[3doverview#3DOverview3DN1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn1)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn3)]
+ [!code-vb[3doverview#3DOverview3DN3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn3)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn4)]
+ [!code-vb[3doverview#3DOverview3DN4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn4)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn5)]
+ [!code-vb[3doverview#3DOverview3DN5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn5)]  
+  
+<a name="animations1"></a>   
+## ウィンドウへの 3\-D コンテンツの追加  
+ シーンを描画するには、モデルと光源を <xref:System.Windows.Media.Media3D.Model3DGroup> に追加し、その <xref:System.Windows.Media.Media3D.Model3DGroup> を <xref:System.Windows.Media.Media3D.ModelVisual3D> の <xref:System.Windows.Media.Media3D.ModelVisual3D.Content%2A> として設定します。  <xref:System.Windows.Media.Media3D.ModelVisual3D> を <xref:System.Windows.Controls.Viewport3D> の <xref:System.Windows.Controls.Viewport3D.Children%2A> コレクションに追加します。  <xref:System.Windows.Controls.Viewport3D.Camera%2A> プロパティを設定することによって、カメラを <xref:System.Windows.Controls.Viewport3D> に追加します。  
+  
+ 最後に、ウィンドウに <xref:System.Windows.Controls.Viewport3D> を追加します。  <xref:System.Windows.Controls.Viewport3D> が Canvas などのレイアウト要素のコンテンツとして含まれる場合、その <xref:System.Windows.FrameworkElement.Height%2A> プロパティおよび <xref:System.Windows.FrameworkElement.Width%2A> プロパティ \(<xref:System.Windows.FrameworkElement> から継承\) を設定することによって、Viewport3D のサイズを設定します。  
+  
+ [!code-xml[hostingwpfusercontrolinwf#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HostingWpfUserControlInWf/CSharp/HostingWpfUserControlInWf/ConeControl.xaml#1)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.Viewport3D>   
+ <xref:System.Windows.Media.Media3D.PerspectiveCamera>   
+ <xref:System.Windows.Media.Media3D.DirectionalLight>   
+ <xref:System.Windows.Media.Media3D.Material>   
+ [3\-D 変換の概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-transformations-overview.md)   
+ [WPF の 3D パフォーマンスの最大化](../../../../docs/framework/wpf/graphics-multimedia/maximize-wpf-3d-performance.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-how-to-topics.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/3-d-transformations-overview.md b/docs/framework/wpf/graphics-multimedia/3-d-transformations-overview.md
new file mode 100644
index 00000000000..629e18c82ff
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/3-d-transformations-overview.md
@@ -0,0 +1,115 @@
+---
+title: "3-D 変換の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換"
+  - "変換, 3-D"
+ms.assetid: e45e555d-ac1e-4b36-aced-e433afe7f27f
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 3-D 変換の概要
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のグラフィックス システムで 3\-D モデルに変換を適用する方法について説明します。  変換を使用すると、開発者は、モデルを定義する基本値を変更せずに、モデルの位置、サイズ、および向きを変更することができます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+## 3\-D 座標空間  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の 3\-D グラフィックス コンテンツは、2 次元要素の構造内に追加できる要素 <xref:System.Windows.Controls.Viewport3D> 内にカプセル化されます。  グラフィックス システムでは Viewport3D を他の多くの [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] と同様に 2 次元のビジュアル要素として扱います。  Viewport3D は 3 次元シーンへのウィンドウ \(ビューポート\) として機能します。  正確には、3\-D シーンが投影されるサーフェイスです。  同じシーン グラフ内で Viewport3D を他の 2\-D 描画オブジェクトと共に使用できますが、Viewport3D 内で 2\-D オブジェクトと 3\-D オブジェクトを相互に貫入させることはできません。  以下の説明では、示される座標空間は Viewport3D 要素に含まれています。  
+  
+ 2\-D グラフィックスの [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 座標系では、レンダリング サーフェイス \(通常は画面\) の左上に原点を置きます。  2\-D 座標系では、正の x 軸の値で右に移動し、正の y 軸の値で下に移動します。  しかし、3\-D 座標系では、原点は画面の中心に置かれ、正の x 軸の値で右に移動しますが、正の y 軸の値では上に移動し、さらに正の z 軸の値で原点から離れて観察者に向かう方向に移動します。  
+  
+ ![座標系](../../../../docs/framework/wpf/graphics-multimedia/media/coordsystem-1.png "CoordSystem\-1")  
+座標系の比較  
+  
+ これらの軸によって定義される空間は、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の 3\-D オブジェクトを参照する静止座標系です。  この座標空間にモデルを構築し、照明とカメラを作成して表示するときに、この静止座標系、つまり "ワールド座標" と、変換を適用するときにモデルごとに作成するローカル座標とを区別すると役に立ちます。  また、ワールド座標のオブジェクトは、照明とカメラの設定によってまったく違って見えたり何も表示されないことがあります。ただし、カメラの位置によってワールド座標におけるオブジェクトの場所が変わることはありません。  
+  
+## モデルの変換  
+ モデルを作成すると、モデルはシーン内の特定の場所に配置されます。  モデルをシーン内で移動したり、回転したり、サイズを変更したりするために、モデル自身を定義する頂点を変更するのは実用的ではありません。  代わりに、2\-D と同様、モデルに変換を適用します。  
+  
+ 各モデル オブジェクトには、<xref:System.Windows.Media.Media3D.Model3D.Transform%2A> プロパティがあり、モデルを移動したり、向きやサイズを変更したりできます。  変換を適用すると、変換で指定されたベクターまたは値だけモデルの点をすべてオフセットできるため効率的です。  つまり、モデルが定義されている座標空間 \(モデル空間\) を変換しても、シーン全体の座標系におけるモデルの図形座標 \(ワールド座標\) を構成する値は変更されません。  
+  
+## 平行移動変換  
+ 3\-D 変換は抽象基本クラス <xref:System.Windows.Media.Media3D.Transform3D> を継承します。具体的には、アフィン変換クラス <xref:System.Windows.Media.Media3D.TranslateTransform3D>、<xref:System.Windows.Media.Media3D.ScaleTransform3D>、<xref:System.Windows.Media.Media3D.RotateTransform3D> などがあります。  また、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 3\-D 座標系は、より簡潔な行列演算で同じ変換を指定できるようにする <xref:System.Windows.Media.Media3D.MatrixTransform3D> クラスも提供します。  
+  
+ <xref:System.Windows.Media.Media3D.TranslateTransform3D> は、<xref:System.Windows.Media.Media3D.TranslateTransform3D.OffsetX%2A>、<xref:System.Windows.Media.Media3D.TranslateTransform3D.OffsetY%2A>、および <xref:System.Windows.Media.Media3D.TranslateTransform3D.OffsetZ%2A> プロパティを使用して指定するオフセット ベクターの方向に Model3D のすべての点を移動します。  たとえば、立方体の 1 つの頂点が \(2,2,2\) の場合、オフセット ベクター \(0,1.6,1\) はその頂点 \(2,2,2\) を \(2,3.6,3\) に移動します。  立方体の頂点は、モデル空間では \(2,2,2\) のままですが、モデル空間とワールド座標の関係は変更され、モデル空間での \(2,2,2\) はワールド座標では \(2,3.6,3\) になっています。  
+  
+ ![変換の図](../../../../docs/framework/wpf/graphics-multimedia/media/transforms-translate.png "Transforms\-Translate")  
+オフセットによる平行移動  
+  
+ 平行移動を適用する方法を次のコード例に示します。  
+  
+ [!code-xml[animation3dgallery_snip#Translation3DAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Translation3DAnimationExample.xaml#translation3danimationexamplewholepage)]  
+  
+## スケール変換  
+ <xref:System.Windows.Media.Media3D.ScaleTransform3D> は、中心点を基準にして指定したスケールのベクターを使用してモデルのスケールを変更します。  モデルのサイズを比率に応じて変更するには、X 軸、Y 軸、および Z 軸方向に同じ値ずつモデルをスケーリングする均等なスケールを指定します。  たとえば、変換の <xref:System.Windows.Media.ScaleTransform.ScaleX%2A>、<xref:System.Windows.Media.ScaleTransform.ScaleY%2A>、および <xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleZ%2A> プロパティを 0.5 に設定すると、モデルのサイズが半分になります。同じプロパティを 2 に設定すると、3 つすべての軸方向にスケールが倍になります。  
+  
+ ![ScaleTransform3D の統一](../../../../docs/framework/wpf/graphics-multimedia/media/threecubes-uniformscale-1.png "threecubes\_uniformscale\_1")  
+ScaleVector の例  
+  
+ 不均等なスケール変換、つまり X、Y、および Z の値の一部が異なるスケール変換を指定すると、他の次元に影響を与えずに 1 つまたは 2 つの次元でモデルを伸縮できます。  たとえば、<xref:System.Windows.Media.ScaleTransform.ScaleX%2A> を 1、<xref:System.Windows.Media.ScaleTransform.ScaleY%2A> を 2、<xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleZ%2A> を 1 に設定すると、変換されたモデルの高さは 2 倍になりますが、X 軸および Z 軸方向は変更されません。  
+  
+ 既定では、ScaleTransform3D によって頂点が原点 \(0,0,0\) を中心として伸縮されます。  ただし、変換するモデルが原点から描画されていない場合、原点からのモデルのスケーリングでは、モデルは "その場で" スケーリングされません。代わりに、モデルの頂点がスケールのベクターで乗算されるとき、スケーリング操作でモデルの平行移動およびそのスケーリングが実行されます。  
+  
+ ![指定した中心点でスケールされる 3 つのキューブ](../../../../docs/framework/wpf/graphics-multimedia/media/threecubes-scaledwithcenter-1.png "threecubes\_scaledwithcenter\_1")  
+スケールの中心の例  
+  
+ モデルを "その場で" スケーリングするには、ScaleTransform3D の <xref:System.Windows.Media.ScaleTransform.CenterX%2A>、<xref:System.Windows.Media.ScaleTransform.CenterY%2A>、および <xref:System.Windows.Media.Media3D.ScaleTransform3D.CenterZ%2A> プロパティを設定してモデルの中心を指定します。  これにより、グラフィックス システムでモデル空間がスケーリングされ、指定した <xref:System.Windows.Media.Media3D.Point3D> の中心に平行移動されます。  逆に、原点を中心とするモデルを構築して別の中心点を指定すると、モデルは原点から平行移動されます。  
+  
+## 回転変換  
+ 3\-D のモデルは、さまざまな方法で回転できます。  一般的な回転変換では、軸とその軸に沿った回転角度を指定します。  <xref:System.Windows.Media.Media3D.RotateTransform3D> クラスを使用して、<xref:System.Windows.Media.Media3D.RotateTransform3D.Rotation%2A> プロパティで <xref:System.Windows.Media.Media3D.Rotation3D> を定義できます。  次に、Rotation3D \(この場合は <xref:System.Windows.Media.Media3D.AxisAngleRotation3D>\) で <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Axis%2A> および <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Angle%2A> プロパティを指定して変換を定義します。  次の例では、Y 軸に沿ってモデルを 60°回転します。  
+  
+ [!code-xml[animation3dgallery_snip#Rotate3DUsingAxisAngleRotation3DExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Rotat3DUsingAxisAngleRotation3DExample.xaml#rotate3dusingaxisanglerotation3dexamplewholepage)]  
+  
+ メモ : [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の 3\-D は右回りの座標系です。つまり、回転の角度値が正の場合は、軸に沿って反時計回りに回転が行われます。  
+  
+ 軸\/角度回転では、値が RotateTransform3D の <xref:System.Windows.Media.Media3D.RotateTransform3D.CenterX%2A>、<xref:System.Windows.Media.Media3D.RotateTransform3D.CenterY%2A>、および <xref:System.Windows.Media.Media3D.RotateTransform3D.CenterZ%2A> プロパティに指定されていない場合は、原点を中心とする回転が想定されます。  スケーリングと同様に、回転ではモデルの座標空間全体が変換されることに留意してください。  モデルが原点を中心として作成されていない場合、または以前に平行移動されている場合は、回転時にその場で回転する代わりに原点を中心として "旋回" する可能性があります。  
+  
+ ![新しい中心点による回転](../../../../docs/framework/wpf/graphics-multimedia/media/threecubes-rotationwithcenter-1.png "threecubes\_rotationwithcenter\_1")  
+新しい中心が指定された回転  
+  
+ モデルを "その場で" 回転するには、モデルの実際の中心を回転の中心として指定します。  通常、ジオメトリは原点を中心としてモデル化されるため、多くの場合、まずモデルのサイズを設定し \(スケーリング\)、次にその向きを設定し \(回転\)、最後にモデルを目的の位置に移動すると \(平行移動\)、一連の変換の予想どおりの結果が得られます。  
+  
+ ![x 軸と y 軸で 60 度回転](../../../../docs/framework/wpf/graphics-multimedia/media/twocubes-rotation2axes-1.png "twocubes\_rotation2axes\_1")  
+回転の例  
+  
+ 軸\/角度回転は、静的な変換と一部のアニメーションで正しく動作します。  ただし、立方体モデルを X 軸に沿って 60°回転してから Z 軸に沿って 45°回転することを考えてみます。  この変換は、2 つの個別のアフィン変換または行列として記述できます。  ただし、この方法で定義した回転をスムーズにアニメーション化するのは困難です。  モデルの開始位置および終了位置はどちらの方法で計算しても同じですが、モデルが受け取る中間位置は、計算上は不確定です。  四元数は、回転の開始と終了の間の補間を計算する別の方法を示します。  
+  
+ 四元数は、3\-D 空間の軸とその軸に沿った回転を表します。  たとえば、四元数は、\(1,1,2\) の軸と 50°の回転を表します。  四元数の回転の定義機能は、四元数で実行可能な構成および補間の 2 つの操作に基づきます。  ジオメトリに適用される 2 つの四元数の構成は、"ジオメトリを axis2 に沿って rotation2 だけ回転してから axis1 に沿って rotation1 だけ回転する" ことを意味します。構成を使用すると、ジオメトリに対する 2 つの回転を組み合わせて、結果を表す単一の四元数を取得することができます。  四元数の補間では、軸および向きの滑らかで適切なパスを計算できるため、元の四元数から構成済みの四元数に補間して滑らかな遷移を実現し、変換をアニメーション化することができます。  アニメーション化するモデルでは、<xref:System.Windows.Media.Media3D.RotateTransform3D.Rotation%2A> プロパティの <xref:System.Windows.Media.Media3D.QuaternionRotation3D> を使用して、回転先の <xref:System.Windows.Media.Media3D.Quaternion> を指定できます。  
+  
+## 変換コレクションの使用  
+ シーンの作成時には、複数の変換を 1 つのモデルに適用するのが一般的です。  変換を <xref:System.Windows.Media.Media3D.Transform3DGroup> クラスの <xref:System.Windows.Media.Media3D.Transform3DGroup.Children%2A> コレクションに追加して、シーン内のさまざまなモデルに適用する変換を簡単にグループ化できます。  多くの場合、異なる変換セットを各インスタンスに適用することでモデルを再利用できるのと同様に、複数の異なるグループで変換を再利用すると便利です。  変換をコレクションに追加する順序が重要であることに注意してください。コレクション内の変換は、始めから終わりまで適用されます。  
+  
+## 変換のアニメーション化  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 3\-D 実装は、2\-D グラフィックスと同じタイミングとアニメーション システムに追加されます。  つまり、3\-D シーンにアニメーションを適用するには、そのモデルのプロパティにアニメーションを適用します。  プリミティブのプロパティに直接アニメーションを適用できますが、通常はモデルの位置や外観を変更する変換にアニメーションを適用する方が簡単です。  変換は、個々のモデル同様、<xref:System.Windows.Media.Media3D.Model3DGroup> オブジェクトに適用できるため、Model3Dgroup の子にアニメーションのセットを適用し、オブジェクトのグループに別のアニメーションのセットを適用することが可能です。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のタイミングとアニメーション システムに関する背景情報として、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」および「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のオブジェクトをアニメーション化するには、タイムラインを作成し、アニメーションを定義し \(これは、実際は一定期間にわたって一部のプロパティ値を変更します\)、アニメーションを適用するプロパティを指定します。  このプロパティは、FrameworkElement のプロパティでなければなりません。  3\-D シーン内のすべてのオブジェクトは Viewport3D の子であるため、シーンに適用するアニメーションの対象となるプロパティは、Viewport3D のプロパティです。  構文が詳細な場合があるため、アニメーションのプロパティ パスは慎重に指定することが重要です。  
+  
+ たとえば、オブジェクトをその場で回転し、同時に旋回動作を適用してオブジェクトのより多くの部分が見えるようにするとします。  モデルに RotateTransform3D を適用して、あるベクトルから別のベクトルへの回転の軸にアニメーションを適用できます。  RotateTransform3D は <xref:System.Windows.Media.TransformGroup> でモデルに適用されている複数の変換の 1 つであるという前提で、<xref:System.Windows.Media.Animation.Vector3DAnimation> を変換の Rotation3D の Axis プロパティに適用する方法を次のコード例に示します。  
+  
+ [!code-csharp[3doverview#3DOverview3DN1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn1)]
+ [!code-vb[3doverview#3DOverview3DN1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn1)]  
+  
+ [!code-csharp[3doverview#3DOverview3DN3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DOverview/CSharp/Window1.xaml.cs#3doverview3dn3)]
+ [!code-vb[3doverview#3DOverview3DN3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DOverview/visualbasic/window1.xaml.vb#3doverview3dn3)]  
+  
+ 同様の構文を使用して、オブジェクトを移動またはスケーリングする他の変換プロパティをターゲットにします。  たとえば、<xref:System.Windows.Media.Animation.Point3DAnimation> をスケール変換の ScaleCenter プロパティに適用して、モデルの形状をスムーズにゆがめます。  
+  
+ 前の例では <xref:System.Windows.Media.Media3D.GeometryModel3D> のプロパティを変換しましたが、シーン内のその他のモデルのプロパティを変換することもできます。  たとえば、光源オブジェクトに適用された平行移動をアニメーション化すると、モデルの外観を大幅に変更できる光と影の移動効果を作り出すことができます。  
+  
+ カメラもモデルであるため、カメラのプロパティも変換することができます。  カメラの位置または平面距離を変換することで \(実際にはシーン投影全体を変換することで\) シーンの外観を確実に変更できますが、この方法で得られる効果の多くは、シーン内のモデルの位置に適用される変換に比べると、見る側にとって "視覚的な意味" があまりないことに注意してください。  
+  
+## 参照  
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/TOC.md b/docs/framework/wpf/graphics-multimedia/TOC.md
new file mode 100644
index 00000000000..e7c876810fe
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/TOC.md
@@ -0,0 +1,208 @@
+# [方法のトピック](transformations-how-to-topics.md)
+# [BMP イメージのエンコードおよびデコード](how-to-encode-and-decode-a-bmp-image.md)
+# [マルチメディアの概要](multimedia-overview.md)
+# [3-D モデルに放射性素材を適用する](how-to-apply-emissive-material-to-a-3-d-object.md)
+# [ArcSegment のサイズをアニメーション化する](how-to-animate-the-size-of-an-arcsegment.md)
+# [方法のトピック](audio-and-video-how-to-topics.md)
+# [純色およびグラデーションによる塗りつぶしの概要](painting-with-solid-colors-and-gradients-overview.md)
+# [変換の原点を相対値で指定する](how-to-specify-the-origin-of-a-transform-by-using-relative-values.md)
+# [直線または線分の終点のキャップを変更する](how-to-modify-the-cap-at-the-end-of-a-line-or-segment.md)
+# [グラフィックス レンダリングのレジストリ設定](graphics-rendering-registry-settings.md)
+# [ストーリーボードを使ってプロパティをアニメーション化する](how-to-animate-a-property-by-using-a-storyboard.md)
+# [3-D モデルのスケールを変換する](how-to-transform-the-scale-of-a-3-d-model.md)
+# [チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](tutorial-hosting-visual-objects-in-a-win32-application.md)
+# [オブジェクトを回転させる](how-to-rotate-an-object.md)
+# [WPF のブラシの概要](wpf-brushes-overview.md)
+# [クロックの状態が変化したときに通知を受け取る](how-to-receive-notification-when-clock-state-changes.md)
+# [ブラシを変換する](how-to-transform-a-brush.md)
+# [パス アニメーションに関する「方法」トピック](path-animation-how-to-topics.md)
+# [アニメーションを反復する](how-to-repeat-an-animation.md)
+# [AnimationClock を使用してプロパティをアニメーション化する](how-to-animate-a-property-by-using-an-animationclock.md)
+# [クロックを同期的にシークする](how-to-seek-a-clock-synchronously.md)
+# [アニメーションのヒントとテクニック](animation-tips-and-tricks.md)
+# [3-D 変換の概要](3-d-transformations-overview.md)
+# [RectangleGeometry を使用して四角形を定義する](how-to-define-a-rectangle-using-a-rectanglegeometry.md)
+# [Point4D 構造体が等価かどうかをテストする](how-to-test-point4d-structures-for-equality-and-inequality.md)
+# [ImageDrawing を使用してイメージを描画する](how-to-draw-an-image-using-imagedrawing.md)
+# [描画をイメージ ソースとして使用する](how-to-use-a-drawing-as-an-image-source.md)
+# [アクティブな期間の末尾に到達したタイムラインの FillBehavior を指定する](specify-the-fillbehavior-for-a-timeline.md)
+# [3-D オブジェクトの前面および背面に素材を適用する](how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md)
+# [SolidColorBrush の色または不透明度をアニメーション化する](how-to-animate-the-color-or-opacity-of-a-solidcolorbrush.md)
+# [MediaElement で変換を使用する](how-to-use-transforms-on-a-mediaelement.md)
+# [ビジュアル層のプログラミング](visual-layer-programming.md)
+# [3-D 変換をアニメーション化する](how-to-animate-3-d-translations.md)
+# [ストーリーボードを使用せずにプロパティをアニメーション化する](how-to-animate-a-property-without-using-a-storyboard.md)
+# [方法: キャッシュされた要素をブラシとして使用する](how-to-use-a-cached-element-as-a-brush.md)
+# [キー フレームを使用して点をアニメーション化する](how-to-animate-a-point-by-using-key-frames.md)
+# [クロックを対話的に制御する](how-to-interactively-control-a-clock.md)
+# [BitmapSource を別の PixelFormat に変換する](how-to-convert-a-bitmapsource-to-a-different-pixelformat.md)
+# [2 次ベジエ曲線を作成する](how-to-create-a-quadratic-bezier-curve.md)
+# [BitmapSource をインデックス付きピクセル形式に変換する](how-to-convert-a-bitmapsource-to-an-indexed-pixel-format.md)
+# [複数の変換を 3-D モデルに適用する](how-to-apply-multiple-transformations-to-a-3-d-model.md)
+# [ジオメトリック パスを使用してオブジェクトを回転させる](how-to-rotate-an-object-by-using-a-geometric-path.md)
+# [クロックに関する「方法」トピック](clocks-how-to-topics.md)
+# [キー フレームを使用して文字列をアニメーション化する](how-to-animate-a-string-by-using-key-frames.md)
+# [ユーザー イベントによってメディアの再生をトリガーする](how-to-trigger-media-playback-with-a-user-event.md)
+# [複合図形の塗りつぶしを制御する](how-to-control-the-fill-of-a-composite-shape.md)
+# [描画を使用して領域を塗りつぶす](how-to-paint-an-area-with-a-drawing.md)
+# [四角形を描画する](how-to-draw-a-rectangle.md)
+# [ビットマップ効果](bitmap-effects.md)
+# [アニメーションの概要](animation-overview.md)
+# [JPEG イメージのエンコードおよびデコード](how-to-encode-and-decode-a-jpeg-image.md)
+# [アニメーションの出力値をアニメーションの開始値に追加する](how-to-add-an-animation-output-value-to-an-animation-starting-value.md)
+# [パス マークアップ構文](path-markup-syntax.md)
+# [キー フレームを使用して行列をアニメーション化する](how-to-animate-a-matrix-by-using-key-frames.md)
+# [放射状グラデーションを使用して領域を塗りつぶす](how-to-paint-an-area-with-a-radial-gradient.md)
+# [キー フレームを使用してオブジェクトをアニメーション化する](how-to-animate-an-object-by-using-key-frames.md)
+# [ビジュアル層でのヒット テスト](hit-testing-in-the-visual-layer.md)
+# [キー フレーム アニメーションのタイミングを制御する](how-to-control-key-frame-animation-timing.md)
+# [四元数を使用して 3-D 回転をアニメーション化する](how-to-animate-a-3-d-rotation-using-quaternions.md)
+# [3-D シーンを作成する](how-to-create-a-3-d-scene.md)
+# [方法のトピック](visual-layer-programming-how-to-topics.md)
+# [キー フレームを使用して色をアニメーション化する](how-to-animate-color-by-using-key-frames.md)
+# [TileBrush の概要](tilebrush-overview.md)
+# [Rotation3DAnimation を使用して 3-D 回転をアニメーション化する](how-to-animate-a-3-d-rotation-using-rotation3danimation.md)
+# [キー フレームを使用して四角形のジオメトリをアニメーション化する](how-to-animate-a-rectangle-geometry-by-using-key-frames.md)
+# [キー フレームに関する「方法」トピック](key-frame-animation-how-to-topics.md)
+# [点およびベクターを変換する](how-to-transform-points-and-vectors.md)
+# [ジオメトリの概要](geometry-overview.md)
+# [GIF イメージのエンコードおよびデコード](how-to-encode-and-decode-a-gif-image.md)
+# [カスタム アニメーションの概要](custom-animations-overview.md)
+# [Drawing オブジェクトの概要](drawing-objects-overview.md)
+# [楕円または円を描画する](how-to-draw-an-ellipse-or-a-circle.md)
+# [オブジェクトに複数の変換を適用する](how-to-apply-multiple-transforms-to-an-object.md)
+# [ストーリーボード アニメーション間で HandoffBehavior を指定する](how-to-specify-handoffbehavior-between-storyboard-animations.md)
+# [ControlTemplate 内でアニメーション化を行う](how-to-animate-in-a-controltemplate.md)
+# [パス アニメーションの概要](path-animations-overview.md)
+# [方法のトピック](imaging-how-to-topics.md)
+# [方法のトピック](graphics-how-to-topics.md)
+# [Win32 ホスト コンテナーを使用してヒット テストを実行する](how-to-hit-test-using-a-win32-host-container.md)
+# [RectangleGeometry の角に丸みを付ける](how-to-round-the-corners-of-a-rectanglegeometry.md)
+# [ビットマップからメタデータを読み取る](how-to-read-metadata-from-a-bitmap.md)
+# [方法のトピック](shapes-how-to-topics.md)
+# [MatrixTransform を使用してカスタム変換を作成する](how-to-use-a-matrixtransform-to-create-custom-transforms.md)
+# [WDP イメージのエンコードおよびデコード](how-to-encode-and-decode-a-wdp-image.md)
+# [変換の概要](transforms-overview.md)
+# [複合図形を作成する](how-to-create-a-composite-shape.md)
+# [ビジュアル内のジオメトリのヒット テストを実行する](how-to-hit-test-geometry-in-a-visual.md)
+# [ブラシの変換の概要](brush-transformation-overview.md)
+# [アニメーションを使用してメディアを再生する](how-to-play-media-with-animations.md)
+# [図形](shapes.md)
+# [ビジュアルのオフセットを取得する](how-to-get-the-offset-of-a-visual.md)
+# [ストーリーボードをシークする](how-to-seek-a-storyboard.md)
+# [ジオメトリック パスを使用してオブジェクトを回転させる (行列アニメーション)](how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md)
+# [キー フレームを使用してサイズの変更をアニメーション化する](how-to-animate-size-changes-by-using-key-frames.md)
+# [方法のトピック](geometries-how-to-topics.md)
+# [子タイムラインを使用してアニメーションを簡素化する](how-to-simplify-animations-by-using-child-timelines.md)
+# [ペンを定義する](how-to-define-a-pen.md)
+# [ストーリーボードを使用してアニメーション化した後にプロパティを設定する](how-to-set-a-property-after-animating-it-with-a-storyboard.md)
+# [イメージ、描画、およびビジュアルによる塗りつぶし](painting-with-images-drawings-and-visuals.md)
+# [EllipseGeometry をアニメーション化する](how-to-animate-an-ellipsegeometry.md)
+# [プロパティ アニメーションの手法の概要](property-animation-techniques-overview.md)
+# [WPF アプリケーションへのグラス フレームの拡張](extend-glass-frame-into-a-wpf-application.md)
+# [タイムラインの速度を変更せずにクロックの速度を変更する](change-the-speed-of-a-clock.md)
+# [イメージングの概要](imaging-overview.md)
+# [イベントの発生時に要素に変換を適用する](how-to-apply-a-transform-to-an-element-when-an-event-occurs.md)
+# [変換](transformations.md)
+# [CompositionTarget を使用したフレームの間隔ごとの描画](how-to-render-on-a-per-frame-interval-using-compositiontarget.md)
+# [パスに沿ってオブジェクトをアニメーション化する (行列アニメーション)](how-to-animate-an-object-along-a-path-matrix-animation.md)
+# [キー フレーム (Rotation3DAnimationUsingKeyFrames) を使用して 3-D 回転をアニメーション化する](how-to-animate-a-3-d-rotation-using-key-frames.md)
+# [グラデーション ストップの位置または色をアニメーション化する](how-to-animate-the-position-or-color-of-a-gradient-stop.md)
+# [WPF グラフィックス レンダリングの概要](wpf-graphics-rendering-overview.md)
+# [パラメーターとしてジオメトリを使用してヒット テストを実行する](how-to-hit-test-using-geometry-as-a-parameter.md)
+# [描画](drawings.md)
+# [スタイル内でアニメーション化を行う](how-to-animate-in-a-style.md)
+# [ビットマップにメタデータを書き込む](how-to-write-metadata-to-a-bitmap.md)
+# [MediaElement (再生、一時停止、停止、ボリューム、および速度) を制御する](how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md)
+# [3-D モデルに描画を適用する](how-to-apply-a-drawing-to-a-3-d-model.md)
+# [3-D グラフィックスの概要](3-d-graphics-overview.md)
+# [WPF での図形と基本描画の概要](shapes-and-basic-drawing-in-wpf-overview.md)
+# [ポリライン要素を使用してポリラインを描画する](how-to-draw-a-polyline-by-using-the-polyline-element.md)
+# [TileBrush の水平方向および垂直方向の配置を設定する](how-to-set-the-horizontal-and-vertical-alignment-of-a-tilebrush.md)
+# [ストーリーボードを使用して MediaElement を制御する](how-to-control-a-mediaelement-by-using-a-storyboard.md)
+# [方法のトピック](drawings-how-to-topics.md)
+# [純色で領域を塗りつぶす](how-to-paint-an-area-with-a-solid-color.md)
+# [BitmapImage に変換を適用する](how-to-apply-a-transform-to-a-bitmapimage.md)
+# [タイミング動作の概要](timing-behaviors-overview.md)
+# [TileBrush を使用してさまざまなタイル パターンを作成する](how-to-create-different-tile-patterns-with-a-tilebrush.md)
+# [XAML で BitmapImage を使用する](how-to-use-a-bitmapimage.md)
+# [パスに沿ってオブジェクトをアニメーション化する (ダブル アニメーション)](how-to-animate-an-object-along-a-path-double-animation.md)
+# ["From"、"To"、および "By" を使用してアニメーションを制御する](how-to-control-an-animation-using-from-to-and-by.md)
+# [タイミング イベントの概要](timing-events-overview.md)
+# [方法のトピック](animation-and-timing-how-to-topics.md)
+# [キー フレームを使用してカメラの位置および方向をアニメーション化する](how-to-animate-camera-position-and-direction-using-key-frames.md)
+# [四角形をアニメーション化する](how-to-animate-a-rectangle.md)
+# [要素またはブラシの不透明度をアニメーション化する](how-to-animate-the-opacity-of-an-element-or-brush.md)
+# [要素を傾斜させる](how-to-skew-an-element.md)
+# [結合したジオメトリを作成する](how-to-create-a-combined-geometry.md)
+# [反復サイクル中にアニメーション値を累積する](how-to-accumulate-animation-values-during-repeat-cycles.md)
+# [From/To/By アニメーションの概要](from-to-by-animations-overview.md)
+# [システム ブラシで領域を塗りつぶす](how-to-paint-an-area-with-a-system-brush.md)
+# [アニメーションを加速または減速させる](how-to-accelerate-or-decelerate-an-animation.md)
+# [名前のスコープを定義する](how-to-define-a-name-scope.md)
+# [方法のトピック](3-d-graphics-how-to-topics.md)
+# [反射を作成する](how-to-create-a-reflection.md)
+# [WPF の 3D パフォーマンスの最大化](maximize-wpf-3d-performance.md)
+# [キー フレームを使用してブール値をアニメーション化する](how-to-animate-a-boolean-by-using-key-frames.md)
+# [多角形要素を使用して、閉じた図形を描画する](how-to-draw-a-closed-shape-by-using-the-polygon-element.md)
+# [PathGeometry を使用して図形を作成する](how-to-create-a-shape-by-using-a-pathgeometry.md)
+# [3D シーンでカメラの位置および方向をアニメーション化する](how-to-animate-camera-position-and-direction-in-a-3d-scene.md)
+# [ジオメトリ](geometries.md)
+# [方法: 要素をキャッシュしてレンダリングのパフォーマンスを向上させる](how-to-improve-rendering-performance-by-caching-an-element.md)
+# [要素を変換する](how-to-translate-an-element.md)
+# [描画に GuidelineSet を適用する](how-to-apply-a-guidelineset-to-a-drawing.md)
+# [3 次ベジエ曲線を作成する](how-to-create-a-cubic-bezier-curve.md)
+# [方法のトピック](brushes-how-to-topics.md)
+# [Viewport3D でヒット テストを実行する](how-to-hit-test-in-a-viewport3d.md)
+# [PointAnimation を使用してオブジェクトの位置をアニメーション化する](how-to-animate-the-position-of-an-object-by-using-pointanimation.md)
+# [LineGeometry を使用して線を作成する](how-to-create-a-line-using-a-linegeometry.md)
+# [楕円の円弧を作成する](how-to-create-an-elliptical-arc.md)
+# [PNG イメージのエンコードおよびデコード](how-to-encode-and-decode-a-png-image.md)
+# [グラフィックス](graphics.md)
+# [開始後のストーリーボードをイベント トリガーを使用して制御する](how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)
+# [キー フレームを使用して境界線の太さをアニメーション化する](how-to-animate-the-thickness-of-a-border-by-using-key-frames.md)
+# [キー フレームを使用して Double 値をアニメーション化する](how-to-animate-a-double-by-using-key-frames.md)
+# [ビジュアルで領域を塗りつぶす](how-to-paint-an-area-with-a-visual.md)
+# [イメージで領域を塗りつぶす](how-to-paint-an-area-with-an-image.md)
+# [BitmapSource オブジェクトをチェーンする](how-to-chain-bitmapsource-objects-together.md)
+# [イメージ](images.md)
+# [ビジュアルの描画コンテンツを列挙する](how-to-enumerate-drawing-content-of-a-visual.md)
+# [背景として使用するイメージの縦横比を保持する](how-to-preserve-the-aspect-ratio-of-an-image-used-as-a-background.md)
+# [ブラシ](brushes.md)
+# [ビットマップ効果の概要](bitmap-effects-overview.md)
+# [3-D シーンで素材プロパティをアニメーション化する](how-to-animate-material-properties-in-a-3-d-scene.md)
+# [不透明マスクの概要](opacity-masks-overview.md)
+# [ビジュアルをイメージ ファイルにエンコードする](how-to-encode-a-visual-to-an-image-file.md)
+# [パスに沿ってオブジェクトをアニメーション化する (ポイント アニメーション)](how-to-animate-an-object-along-a-path-point-animation.md)
+# [要素のスピンを設定する](how-to-make-an-element-spin-in-place.md)
+# [TIFF イメージのエンコードおよびデコード](how-to-encode-and-decode-a-tiff-image.md)
+# [パスに沿ってオブジェクトをアニメーション化する (オフセット累積による行列アニメーション)](animate-an-object-along-a-path-matrix-animation-with-offset.md)
+# [ストーリーボードの概要](storyboards-overview.md)
+# [グラフィックスとマルチメディア](index.md)
+# [要素をスケーリングする](how-to-scale-an-element.md)
+# [アニメーションとタイミング システムの概要](animation-and-timing-system-overview.md)
+# [VideoDrawing を使用してメディアを再生する](how-to-play-media-using-a-videodrawing.md)
+# [タイムラインを自動的に反転するかどうかを指定する](how-to-specify-whether-a-timeline-automatically-reverses.md)
+# [アニメーションの継続時間を設定する](how-to-set-a-duration-for-an-animation.md)
+# [プロパティ値が変化したときにアニメーションをトリガーする](how-to-trigger-an-animation-when-a-property-value-changes.md)
+# [GeometryDrawing を作成する](how-to-create-a-geometrydrawing.md)
+# [グラデーションでシステム カラーを使用する](how-to-use-system-colors-in-a-gradient.md)
+# [PathGeometry 内に複数のサブパスを作成する](how-to-create-multiple-subpaths-within-a-pathgeometry.md)
+# [ビジュアルからビットマップを作成する](how-to-create-a-bitmap-from-a-visual.md)
+# [ストーリーボードを使用して 3-D 回転をアニメーション化する](how-to-animate-a-3-d-rotation-using-storyboards.md)
+# [キー フレーム アニメーションの概要](key-frame-animations-overview.md)
+# [DrawingVisual オブジェクトの使用](using-drawingvisual-objects.md)
+# [新しい BitmapSource を作成する](how-to-create-a-new-bitmapsource.md)
+# [キー フレーム (QuaternionAnimationUsingKeyFrames) を使用して 3-D 回転をアニメーション化する](animate-a-3-d-rotation-quaternionanimationusingkeyframes.md)
+# [StreamGeometry を使用して図形を作成する](how-to-create-a-shape-using-a-streamgeometry.md)
+# [イージング関数](easing-functions.md)
+# [複合描画を作成する](how-to-create-a-composite-drawing.md)
+# [線を描画する](how-to-draw-a-line.md)
+# [TileBrush のタイル サイズを設定する](how-to-set-the-tile-size-for-a-tilebrush.md)
+# [ビデオを使用して領域を塗りつぶす](how-to-paint-an-area-with-a-video.md)
+# [対話型メソッドを使用してストーリーボードを開始後に制御する](how-to-control-a-storyboard-after-it-starts.md)
+# [ストーリーボードを同期的にシークする](how-to-seek-a-storyboard-synchronously.md)
+# [サムネイルとしてイメージを読み込む](how-to-load-an-image-as-a-thumbnail.md)
+# [メディアの再生を反復する](how-to-repeat-media-playback.md)
+# [PathGeometry で LineSegment を作成する](how-to-create-a-linesegment-in-a-pathgeometry.md)
+# [線形グラデーションを使用して領域を塗りつぶす](how-to-paint-an-area-with-a-linear-gradient.md)
diff --git a/docs/framework/wpf/graphics-multimedia/animate-a-3-d-rotation-quaternionanimationusingkeyframes.md b/docs/framework/wpf/graphics-multimedia/animate-a-3-d-rotation-quaternionanimationusingkeyframes.md
new file mode 100644
index 00000000000..a740e05b5d0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animate-a-3-d-rotation-quaternionanimationusingkeyframes.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : キー フレーム (QuaternionAnimationUsingKeyFrames) を使用して 3-D 回転をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化, キー フレームで (QuaternionAnimationUsingKeyFrames)"
+  - "アニメーション, 3-D 変換, キー フレームで (QuaternionAnimationUsingKeyFrames)"
+  - "キー フレーム, QuaternionAnimationUsingKeyFrames"
+ms.assetid: 09e5707b-7523-4a08-9aa7-bb13cbedccdf
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : キー フレーム (QuaternionAnimationUsingKeyFrames) を使用して 3-D 回転をアニメーション化する
+次の例では、<xref:System.Windows.Media.Animation.QuaternionAnimationUsingKeyFrames> を使用して 3\-D オブジェクトを回転させます。  このアニメーションでは、次のキー フレームを使用します。  
+  
+1.  <xref:System.Windows.Media.Animation.LinearRotation3DKeyFrame> は、値から値への滑らかで直線的な補間を作成するために使用します。  
+  
+2.  <xref:System.Windows.Media.Animation.DiscreteRotation3DKeyFrame> は、値から値への突然の "ジャンプ" \(補間なし\) を作成するために使用します。  
+  
+3.  <xref:System.Windows.Media.Animation.SplineRotation3DKeyFrame> は、<xref:System.Windows.Media.Animation.SplineRotation3DKeyFrame.KeySpline%2A> プロパティに従って、値から値への多様な遷移を作成するために使用します。  下の例で、この部分のアニメーションはゆっくりと始まりますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#QuaternionAnimationUsingKeyFramesExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/QuaternionAnimationUsingKeyFramesExample.xaml#quaternionanimationusingkeyframesexamplewholepage)]  
+  
+## 参照  
+ [ストーリーボードを使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md)   
+ [Rotation3DAnimation を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md)   
+ [四元数を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md)   
+ [キー フレーム \(Rotation3DAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/animate-an-object-along-a-path-matrix-animation-with-offset.md b/docs/framework/wpf/graphics-multimedia/animate-an-object-along-a-path-matrix-animation-with-offset.md
new file mode 100644
index 00000000000..18b3958527d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animate-an-object-along-a-path-matrix-animation-with-offset.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : パスに沿ってオブジェクトをアニメーション化する (オフセット累積による行列アニメーション) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "オフセット累積"
+  - "アニメーション オブジェクトをパスに沿って (オフセット累積による行列アニメーション)"
+  - "行列アニメーション (オフセット累積による)"
+ms.assetid: 1bca90ef-9832-4128-8ed6-62908e7ec146
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : パスに沿ってオブジェクトをアニメーション化する (オフセット累積による行列アニメーション)
+この例では、使用して、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>をパスに沿ってオブジェクトをアニメーション化し、そのオフセットを蓄積したアニメーション クラスに繰り返すような値です。  
+  
+## <a name="example"></a>例  
+ 次の例では、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>アニメーション化するオブジェクト、<xref:System.Windows.Media.MatrixTransform.Matrix%2A>のプロパティ、 <xref:System.Windows.Media.MatrixTransform>ボタンに適用します。 その結果、ボタンは、曲線のパスに沿って移動します。  
+  
+ さらに、例では、設定、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.IsOffsetCumulative%2A>プロパティを`true`、それが原因で、アニメーションを繰り返すたびに蓄積するアニメーション化された行列のオフセット。 オフセットが累積されるため、ボタンは開始位置にリセットするのではなく、アニメーションの繰り返し時に画面間で広く移動します。  
+  
+ [!code-xml[PathAnimationGallery_snippet#MatrixAnimationUsingPathOffsetCumulativeWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/matrixanimationusingpathexampleoffsetcumulative.xaml#matrixanimationusingpathoffsetcumulativewholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathOffsetCumulativeWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/MatrixAnimationUsingPathExampleOffsetCumulative.cs#matrixanimationusingpathoffsetcumulativewholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathOffsetCumulativeWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/MatrixAnimationUsingPathExampleOffsetCumulative.vb#matrixanimationusingpathoffsetcumulativewholepage)]  
+  
+ <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.IsOffsetCumulative%2A>プロパティと、繰り返しを累積するオフセット値を蓄積する回転の値が原因にはなりません。 回転の値を蓄積するために、設定、アニメーションの<xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.DoesRotateWithTangent%2A>と<xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.IsAngleCumulative%2A>プロパティ`true`します。  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。 アニメーション化する方法を示す例については、<xref:System.Windows.Media.Matrix>オフセット累積せずパスに沿った値を参照してください[オブジェクトに沿って、パス (行列アニメーション) をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md
new file mode 100644
index 00000000000..0e5a8b82121
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md
@@ -0,0 +1,66 @@
+---
+title: "アニメーションおよびタイミングに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アニメーション [WPF]"
+  - "タイミング システム [WPF]"
+ms.assetid: 587e36f6-1957-424e-9d89-c43724f26d84
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# アニメーションおよびタイミングに関する「方法」トピック
+以下のトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のアニメーションおよびタイミング システムをアプリケーションで使用する方法について説明します。  
+  
+## このセクションの内容  
+ [アニメーションを加速または減速させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md)  
+ [反復サイクル中にアニメーション値を累積する](../../../../docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md)  
+ [アニメーションの出力値をアニメーションの開始値に追加する](../../../../docs/framework/wpf/graphics-multimedia/how-to-add-an-animation-output-value-to-an-animation-starting-value.md)  
+ [ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)  
+ [ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)  
+ [ControlTemplate 内でアニメーション化を行う](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md)  
+ [スタイル内でアニメーション化を行う](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-style.md)  
+ [要素またはブラシの不透明度をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-opacity-of-an-element-or-brush.md)  
+ [タイムラインの速度を変更せずにクロックの速度を変更する](../../../../docs/framework/wpf/graphics-multimedia/change-the-speed-of-a-clock.md)  
+ [対話型メソッドを使用してストーリーボードを開始後に制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md)  
+ ["From"、"To"、および "By" を使用してアニメーションを制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-an-animation-using-from-to-and-by.md)  
+ [名前のスコープを定義する](../../../../docs/framework/wpf/graphics-multimedia/how-to-define-a-name-scope.md)  
+ [クロックの状態が変化したときに通知を受け取る](../../../../docs/framework/wpf/graphics-multimedia/how-to-receive-notification-when-clock-state-changes.md)  
+ [How to: Remove a Storyboard](http://msdn.microsoft.com/ja-jp/7fe39531-de2f-46a0-a69f-b783d04235ee)  
+ [アニメーションを反復する](../../../../docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md)  
+ [ストーリーボードをシークする](../../../../docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard.md)  
+ [ストーリーボードを同期的にシークする](../../../../docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md)  
+ [アニメーションの継続時間を設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-a-duration-for-an-animation.md)  
+ [ストーリーボードを使用してアニメーション化した後にプロパティを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md)  
+ [子タイムラインを使用してアニメーションを簡素化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-simplify-animations-by-using-child-timelines.md)  
+ [ストーリーボード アニメーション間で HandoffBehavior を指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-handoffbehavior-between-storyboard-animations.md)  
+ [アクティブな期間の末尾に到達したタイムラインの FillBehavior を指定する](../../../../docs/framework/wpf/graphics-multimedia/specify-the-fillbehavior-for-a-timeline.md)  
+ [タイムラインを自動的に反転するかどうかを指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md)  
+ [プロパティ値が変化したときにアニメーションをトリガーする](../../../../docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md)  
+ [開始後のストーリーボードをイベント トリガーを使用して制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Animation.Timeline>  
+  
+ <xref:System.Windows.Media.Animation.Storyboard>  
+  
+ <xref:System.Windows.Media.Animation.BeginStoryboard>  
+  
+ <xref:System.Windows.Media.Animation.Clock>  
+  
+ <xref:System.Windows.Media.Animation>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md b/docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md
new file mode 100644
index 00000000000..5d6c6a45f80
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md
@@ -0,0 +1,96 @@
+---
+title: "アニメーションとタイミング システムの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション [WPF]"
+  - "タイミング システム [WPF]"
+ms.assetid: 172cd5a8-a333-4c81-9456-fafccc19f382
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# アニメーションとタイミング システムの概要
+ここでは、タイミング システムで、アニメーションの <xref:System.Windows.Media.Animation.Timeline> および <xref:System.Windows.Media.Animation.Clock> の各クラスを使用してプロパティをアニメーション化する方法について説明します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」の説明に従って、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーションを使用し、プロパティをアニメーション化できる必要があります。  また、[依存関係プロパティ](GTMT)についても知っておくと役に立ちます。詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+<a name="timelinesandclocks"></a>   
+## タイムラインとクロック  
+ 「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」では、<xref:System.Windows.Media.Animation.Timeline> で時間のセグメントを表す方法、およびアニメーションが出力値を生成する <xref:System.Windows.Media.Animation.Timeline> の 1 つの型であることを説明しました。  <xref:System.Windows.Media.Animation.Timeline> 自体は、時間のセグメントを記述する以外、何も実行しません。  実際の処理を実行するのは、タイムラインの <xref:System.Windows.Media.Animation.Clock> オブジェクトです。  同様に、アニメーションは実際にはプロパティをアニメーション化しません。アニメーション クラスは出力値の計算方法を記述しますが、アニメーション出力を実行し、その出力をプロパティに適用するのは、そのアニメーション用に作成された <xref:System.Windows.Media.Animation.Clock> です。  
+  
+ <xref:System.Windows.Media.Animation.Clock> は、<xref:System.Windows.Media.Animation.Timeline> のタイミングに関連する実行時の状態を維持する特殊な型のオブジェクトです。  このオブジェクトは、アニメーションおよびタイミング システムには不可欠な 3 つの情報、<xref:System.Windows.Media.Animation.Clock.CurrentTime%2A>、<xref:System.Windows.Media.Animation.Clock.CurrentProgress%2A>、および <xref:System.Windows.Media.Animation.Clock.CurrentState%2A> を提供します。  <xref:System.Windows.Media.Animation.Clock> は、その現在の時刻、進行状況、および状態を、その <xref:System.Windows.Media.Animation.Timeline> で記述された、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>、<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>、<xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> などのタイミング動作を使用して判断します。  
+  
+ ほとんどの場合、タイムラインに自動的に <xref:System.Windows.Media.Animation.Clock> が作成されます。  <xref:System.Windows.Media.Animation.Storyboard> メソッドや <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用してアニメーション化すると、タイムラインとアニメーションに自動的にクロックが作成されて対象のプロパティに適用されます。  <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.CreateClock%2A> メソッドを使用して、<xref:System.Windows.Media.Animation.Clock> を明示的に作成することもできます。  <xref:System.Windows.Media.MediaTimeline.CreateClock%2A?displayProperty=fullName> メソッドは、それが呼び出された <xref:System.Windows.Media.Animation.Timeline> に対応する型のクロックを作成します。  <xref:System.Windows.Media.Animation.Timeline> に子タイムラインが含まれる場合、それらの子タイムラインの <xref:System.Windows.Media.Animation.Clock> オブジェクトも作成されます。  結果として得られる <xref:System.Windows.Media.Animation.Clock> オブジェクトは、クロック オブジェクトを作成した <xref:System.Windows.Media.Animation.Timeline> オブジェクト ツリーと同じ構造のツリーに配置されます。  
+  
+ さまざまな型のタイムラインに対応するさまざまな型のクロックが存在します。  いくつかの <xref:System.Windows.Media.Animation.Timeline> 型とそれに対応する <xref:System.Windows.Media.Animation.Clock> 型を次の表に示します。  
+  
+|タイムラインの型|クロックの型|クロックの目的|  
+|--------------|------------|-------------|  
+|Animation \(<xref:System.Windows.Media.Animation.AnimationTimeline> から継承\)|<xref:System.Windows.Media.Animation.AnimationClock>|依存関係プロパティの出力値を生成します。|  
+|<xref:System.Windows.Media.MediaTimeline>|<xref:System.Windows.Media.MediaClock>|メディア ファイルを処理します。|  
+|<xref:System.Windows.Media.Animation.ParallelTimeline>|<xref:System.Windows.Media.Animation.ClockGroup>|その子 <xref:System.Windows.Media.Animation.Clock> オブジェクトをグループ化し、制御します。|  
+|<xref:System.Windows.Media.Animation.Storyboard>|<xref:System.Windows.Media.Animation.ClockGroup>|その子 <xref:System.Windows.Media.Animation.Clock> オブジェクトをグループ化し、制御します。|  
+  
+ 作成した <xref:System.Windows.Media.Animation.AnimationClock> オブジェクトはすべて、<xref:System.Windows.Media.Animation.IAnimatable.ApplyAnimationClock%2A> メソッドを使用して互換性のある依存関係プロパティに適用できます。  
+  
+ 同じようなオブジェクトを多数アニメーション化するなど、パフォーマンスに大きな負荷がかかるシナリオでは、独自の <xref:System.Windows.Media.Animation.Clock> を管理することによってパフォーマンスを向上できます。  
+  
+<a name="timemanager"></a>   
+## クロックとタイム マネージャー  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でオブジェクトをアニメーション化する場合、タイムラインに対して作成された <xref:System.Windows.Media.MediaPlayer.Clock%2A> オブジェクトはタイム マネージャーが管理します。  タイム マネージャーは、<xref:System.Windows.Media.MediaPlayer.Clock%2A> オブジェクトのツリーのルートであり、そのツリーの時間のフローを制御します。  タイム マネージャーは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションごとに自動的に作成され、アプリケーション開発者には表示されません。タイム マネージャーは、1 秒に何度も "タイマーを刻み" ます。1 秒あたりのタイマー刻みの実際の回数は、使用可能なシステム リソースに応じて変わります。  これらの 1 回のタイマー刻みの間、タイム マネージャーは、タイミング ツリー内のすべての <xref:System.Windows.Media.Animation.ClockState> <xref:System.Windows.Media.Animation.Clock> オブジェクトの状態を計算します。  
+  
+ タイム マネージャー、<xref:System.Windows.Media.Animation.AnimationClock>、およびアニメーション化された依存関係プロパティの関係を次の図に示します。  
+  
+ ![タイミング システム コンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-1clock1prop.png "graphicsmm\_clocks\_1clock1prop")  
+プロパティのアニメーション化  
+  
+ タイムマネージャーは、タイマーを刻むときに、アプリケーション内のすべての <xref:System.Windows.Media.Animation.ClockState> <xref:System.Windows.Media.Animation.Clock> の時間を更新します。  <xref:System.Windows.Media.Animation.Clock> が <xref:System.Windows.Media.Animation.AnimationClock> の場合、クロックは、その作成元の <xref:System.Windows.Media.Animation.AnimationTimeline> の <xref:System.Windows.Media.Animation.AnimationTimeline.GetCurrentValue%2A> メソッドを使用して現在の出力値を計算します。  <xref:System.Windows.Media.Animation.AnimationClock> は、現在のローカル時刻、入力値 \(通常はプロパティの基本値\)、および既定の終点の値を指定した <xref:System.Windows.Media.Animation.AnimationTimeline> を提供します。  <xref:System.Windows.DependencyObject.GetValue%2A> メソッドまたはその CLR アクセサーを使用してアニメーション化プロパティの値を取得するときに、その <xref:System.Windows.Media.Animation.AnimationClock> の出力を取得します。  
+  
+#### クロック グループ  
+ 前のセクションでは、さまざまな型のタイムラインに対応するさまざまな型の <xref:System.Windows.Media.Animation.Clock> オブジェクトを説明しました。  タイム マネージャー、<xref:System.Windows.Media.Animation.ClockGroup>、<xref:System.Windows.Media.Animation.AnimationClock>、およびアニメーション化された依存関係プロパティの関係を次の図に示します。  アニメーションおよび他のタイムラインをグループ化する <xref:System.Windows.Media.Animation.Storyboard> クラスなど、他のタイムラインをグループ化するタイムラインに対して、<xref:System.Windows.Media.Animation.ClockGroup> が作成されます。  
+  
+ ![タイミング システム コンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1clockgroup2prop.png "graphicsmm\_clocks\_2clock1clockgroup2prop")  
+ClockGroup  
+  
+#### 構成  
+ 複数のクロックを単一のプロパティに関連付けることが可能です。この場合、各クロックは前のクロックの出力値をその基本値として使用します。  同じプロパティに適用された 3 つの <xref:System.Windows.Media.Animation.AnimationClock> オブジェクトを次の図に示します。  Clock1 は、アニメーション化されたプロパティの基本値をその入力として使用して出力を生成します。  Clock2 は、Clock1 からの出力をその入力として取得し、それを使用して出力を生成します。  Clock3 は、Clock2 からの出力をその入力として取得し、それを使用して出力を生成します。  複数のクロックが同じプロパティに同時に影響を与える場合、それらは構成チェーン内にあるものと見みなされます。  
+  
+ ![タイミング システム コンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1prop.png "graphicsmm\_clocks\_2clock1prop")  
+構成チェーン  
+  
+ 構成チェーン内の <xref:System.Windows.Media.Animation.AnimationClock> オブジェクトの入力および出力間の関係は作成されますが、それらのタイミング動作は影響を受けません。<xref:System.Windows.Media.Animation.Clock> オブジェクト \(<xref:System.Windows.Media.Animation.AnimationClock> オブジェクトを含む\) は、その親 <xref:System.Windows.Media.Animation.Clock> オブジェクトに対して階層型の依存関係を持ちます。  
+  
+ 複数のクロックを同じプロパティに適用するには、<xref:System.Windows.Media.Animation.Storyboard>、アニメーション、または <xref:System.Windows.Media.Animation.AnimationClock> の適用時に <xref:System.Windows.Media.Animation.HandoffBehavior> <xref:System.Windows.Media.Animation.HandoffBehavior> を使用します。  
+  
+#### タイマー刻みとイベントの統合  
+ 出力値の計算に加え、タイム マネージャーはタイマーを刻むごとに他の作業も行います。タイム マネージャーは、各クロックの状態を確認し、必要に応じてイベントを発生させます。  
+  
+ タイマー刻みが頻繁に発生している間は、タイマー刻みの間隔に多くのことが行われる可能性があります。  たとえば、<xref:System.Windows.Media.Animation.Clock> が停止してから開始し、もう一度停止する可能性あります。この場合、クロックの <xref:System.Windows.Media.Animation.Clock.CurrentState%2A> 値は 3 回変更されています。  理論的には、<xref:System.Windows.Media.Animation.Clock.CurrentStateInvalidated> イベントは 1 回のタイマー刻みで複数回発生することは可能ですが、タイミング エンジンはイベントを統合して、<xref:System.Windows.Media.Animation.Clock.CurrentStateInvalidated> イベントが 1 回のタイマー刻みにつき多くても 1 回だけ発生するようにします。  これはすべてのタイミング イベントに該当します。特定の 1 <xref:System.Windows.Media.Animation.Clock> オブジェクトに対して、各型のイベントは 1 回だけ発生します。  
+  
+ タイマー刻み間隔に、<xref:System.Windows.Media.Animation.Clock> の状態が切り替わり、元の状態に戻った場合 \(<xref:System.Windows.Media.Animation.ClockState> から <xref:System.Windows.Media.Animation.ClockState> に切り替わり、<xref:System.Windows.Media.Animation.ClockState> に戻る場合など\) でも、関連のイベントは発生します。  
+  
+ タイミング イベントの詳細については、「[タイミング イベントの概要](../../../../docs/framework/wpf/graphics-multimedia/timing-events-overview.md)」を参照してください。  
+  
+<a name="currentvaluesbasevaluesofproperties"></a>   
+## プロパティの現在値と基本値  
+ アニメーション化可能なプロパティは、基本値と現在値の 2 つの値を持つことができます。  その CLR アクセサーまたは <xref:System.Windows.DependencyObject.SetValue%2A> メソッドを使用してプロパティを設定する場合は、その基本値を設定します。  プロパティをアニメーション化しない場合、その基本値と現在値は同じになります。  
+  
+ プロパティをアニメーション化する場合、<xref:System.Windows.Media.Animation.AnimationClock> はプロパティの*現在*値を設定します。  <xref:System.Windows.Media.Animation.AnimationClock> が <xref:System.Windows.Media.Animation.ClockState> または <xref:System.Windows.Media.Animation.ClockState> の場合、プロパティの値をその CLR アクセサーまたは <xref:System.Windows.DependencyObject.GetValue%2A> メソッドをとおして取得すると、<xref:System.Windows.Media.Animation.AnimationClock> の出力が返されます。  プロパティの基本値は、<xref:System.Windows.Media.Animation.IAnimatable.GetAnimationBaseValue%2A> メソッドを使用して取得できます。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [タイミング イベントの概要](../../../../docs/framework/wpf/graphics-multimedia/timing-events-overview.md)   
+ [タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/animation-overview.md b/docs/framework/wpf/graphics-multimedia/animation-overview.md
new file mode 100644
index 00000000000..5f83935cf0b
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animation-overview.md
@@ -0,0 +1,363 @@
+---
+title: "アニメーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストーリー ボード [WPF] アニメーション"
+  - "アニメーション [WPF], 概要"
+ms.assetid: bd9ce563-725d-4385-87c9-d7ee38cf79ea
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# アニメーションの概要
+<a name="introduction"></a>[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)]魅力的なユーザー インターフェイスやドキュメントを作成するためのグラフィックスとレイアウトの機能の強力なセットを提供します。 アニメーションより傑作と使用可能な魅力的なユーザー インターフェイスを行うことができます。 背景色をアニメーション化することも、アニメーションを適用して<xref:System.Windows.Media.Transform>、劇的な画面の遷移を作成したり、役立つ視覚的な手掛かりを提供します。  
+  
+ この概要について説明する、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アニメーションおよびタイミング システムです。 アニメーションに焦点を当てます[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]のストーリー ボードを使用して、オブジェクトです。  
+
+<a name="introducinganimations"></a>   
+## <a name="introducing-animations"></a>アニメーションの概要  
+ アニメーションは、一連の最後からそれぞれに異なるイメージをすばやく切り替えることによって作成されるフィルターの種類です。 脳は、1 つの変化するシーンとしてイメージのグループを認識します。 映画では、この錯覚は&1; 秒あたりに多数の写真またはフレームを記録するカメラを使用して作成されます。 フレームを映写機で再生すると、見る人には動く画像として映ります。  
+  
+ コンピューター上のアニメーションは似ています。 たとえば、見えない四角形のフェードの描画を行うプログラムがとおり動作する可能性があります。  
+  
+-   プログラムでは、タイマーを作成します。  
+  
+-   プログラムでは、どれ時間だけが経過して設定された間隔でタイマーを確認します。  
+  
+-   プログラムは、タイマーをチェックインするたびに、どれ時間だけが経過時間に基づいて、四角形の不透明度の現在の値を計算します。  
+  
+-   プログラムは、新しい値を持つ四角形を更新し、再描画します。  
+  
+ 前のバージョン[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)]開発者を作成し、タイミング システムを管理または特殊なカスタム ライブラリを使用する必要があります。                  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]マネージ コードによって公開される効率的なタイミング システムを含むと[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]密接に統合されていると、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]フレームワークです。                  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アニメーションを簡単にコントロールやその他のグラフィカル オブジェクトをアニメーション化します。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]すべてのバック グラウンド処理のタイミング システムを管理して、画面を効率的に再描画を処理します。 それらの効果を実現するためのメカニズムではなく、作成する効果に重点を有効にするタイミング クラスを提供します。                  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]容易に、クラスが継承できるアニメーションの基本クラスを公開することで、独自のアニメーションを作成する、カスタマイズされたアニメーションを作成します。 これらのカスタム アニメーションは、標準のアニメーション クラスのパフォーマンスの利点の多くを取得します。  
+  
+<a name="thewpftimingsystem"></a>   
+## <a name="wpf-property-animation-system"></a>WPF プロパティ アニメーション システム  
+ タイミング システムに関するいくつかの重要な概念を理解している場合[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アニメーションを使用する方が簡単にできることができます。 最も重要なは、 [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]、個々 のプロパティにアニメーションを適用することでオブジェクトをアニメーション化します。 たとえば、拡張フレームワーク要素をするためには、アニメーション化する、<xref:System.Windows.FrameworkElement.Width%2A>と<xref:System.Windows.FrameworkElement.Height%2A>プロパティです。 アニメーション化するのには非表示オブジェクト、その<xref:System.Windows.UIElement.Opacity%2A>プロパティです。  
+  
+ アニメーション機能を持つをプロパティには、次の&3; つの要件を満たす必要があります。  
+  
+-   依存関係プロパティがあります。  
+  
+-   継承するクラスに属する必要があります<xref:System.Windows.DependencyObject>を実装し、 <xref:System.Windows.Media.Animation.IAnimatable>インターフェイスです。  
+  
+-   互換性のあるアニメーションの種類を使用可能なあります。 (場合[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]は提供されていない、独自に作成することができます。 参照してください、[カスタム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/custom-animations-overview.md))。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]持つ多くのオブジェクトを含む<xref:System.Windows.Media.Animation.IAnimatable>プロパティです。 などのコントロール<xref:System.Windows.Controls.Button>と<xref:System.Windows.Controls.TabControl>、さらに<xref:System.Windows.Controls.Panel>と<xref:System.Windows.Shapes.Shape>オブジェクトから継承<xref:System.Windows.DependencyObject>します。 それらのプロパティの大部分は、依存関係プロパティです。  
+  
+ 使用できるアニメーションほぼ任意の場所をスタイルおよびコントロール テンプレートが含まれます。 アニメーションを視覚的にする必要はありません。このセクションで説明されている条件を満たしている場合、ユーザー インターフェイスの一部ではないオブジェクトをアニメーション化することができます。  
+  
+<a name="storyboardwalkthrough"></a>   
+## <a name="example-make-an-element-fade-in-and-out-of-view"></a>例: 要素のフェードインとフェードアウトを行う  
+ この例では、使用して、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]依存関係プロパティの値をアニメーション化するアニメーションです。 使用して、 <xref:System.Windows.Media.Animation.DoubleAnimation>、これは、型を生成するアニメーションの<xref:System.Double>をアニメーション化する、値、<xref:System.Windows.UIElement.Opacity%2A>のプロパティ、<xref:System.Windows.Shapes.Rectangle>します。 結果として、<xref:System.Windows.Shapes.Rectangle>ビューから消えます。  
+  
+ この例の最初の部分を作成、<xref:System.Windows.Shapes.Rectangle>要素。 以下の手順は、アニメーションを作成し、四角形に適用する方法を示します<xref:System.Windows.UIElement.Opacity%2A>プロパティです。  
+  
+ 作成する方法を次に示します、<xref:System.Windows.Shapes.Rectangle>内の要素、 <xref:System.Windows.Controls.StackPanel> XAML でします。  
+  
+ [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_1)]  
+  
+ 作成する方法を次に示します、<xref:System.Windows.Shapes.Rectangle>内の要素、 <xref:System.Windows.Controls.StackPanel>コードにします。  
+  
+ [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Class1.cs#rectangleopacityfadeexamplecode_1)]
+ [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/Class1.vb#rectangleopacityfadeexamplecode_1)]  
+  
+<a name="opacity_animation_step1"></a>   
+### <a name="part-1-create-a-doubleanimation"></a>第 1 部: DoubleAnimation を作成します。  
+ フェードアウト要素を&1; つの方法がアニメーション化するのには、<xref:System.Windows.UIElement.Opacity%2A>プロパティです。 <xref:System.Windows.UIElement.Opacity%2A>プロパティの型は<xref:System.Double>、double 値を生成するアニメーションを作成する必要があります。 A <xref:System.Windows.Media.Animation.DoubleAnimation>はこのような&1; つのアニメーションです。 A <xref:System.Windows.Media.Animation.DoubleAnimation>&2; つの倍精度値間の遷移が作成されます。 設定した開始値を指定するには、その<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>プロパティです。 設定する終了値を指定するには、その<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>プロパティです。  
+  
+1.  Opacity の値を`1.0`完全に不透明なオブジェクトとの不透明度の値は、`0.0`完全に非表示になります。 To make the animation transition from                                  `1.0` to                                  `0.0` you set its                                  <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> property to                                  `1.0` and its                                  <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> property to                                  `0.0`. 作成する方法を次に示します、 <xref:System.Windows.Media.Animation.DoubleAnimation> XAML でします。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_2)]  
+  
+     作成する方法を次に示します、 <xref:System.Windows.Media.Animation.DoubleAnimation>コードにします。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Class1.cs#rectangleopacityfadeexamplecode_2)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/Class1.vb#rectangleopacityfadeexamplecode_2)]  
+  
+2.  次に、指定する必要があります、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>します。 <xref:System.Windows.Media.Animation.Timeline.Duration%2A>アニメーションの開始値から、送信先の値に移動にかかる時間を指定します。 設定する方法を次に示します、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>XAML で&5; 秒にします。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_3)]  
+  
+     設定する方法を次に示します、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>コード内で&5; 秒にします。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Class1.cs#rectangleopacityfadeexamplecode_3)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/Class1.vb#rectangleopacityfadeexamplecode_3)]  
+  
+3.  前のコードではから移行するアニメーションを示しました`1.0`に`0.0`、それが原因で、ターゲット要素から完全に不透明な完全に非表示にフェードアウトします。 一度フェードインが消えた後要素をクリックすると、 <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>プロパティをアニメーションの`true`です。 アニメーションを無限に繰り返すするためには、次のように設定します。 その<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>プロパティを<xref:System.Windows.Media.Animation.RepeatBehavior.Forever%2A>します。設定する方法を次に示します、 <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>と<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> XAML でのプロパティです。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_4)]  
+  
+     設定する方法を次に示します、 <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>と<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>コード内のプロパティです。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Class1.cs#rectangleopacityfadeexamplecode_4)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/Class1.vb#rectangleopacityfadeexamplecode_4)]  
+  
+<a name="opacity_animation_step2"></a>   
+### <a name="part-2-create-a-storyboard"></a>第 2 部: ストーリー ボードの作成  
+ 作成するオブジェクトにアニメーションを適用するに、<xref:System.Windows.Media.Animation.Storyboard>を使用して、 <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A>と<xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A>オブジェクトを指定するプロパティとアニメーション化するプロパティをアタッチします。  
+  
+1.  作成、<xref:System.Windows.Media.Animation.Storyboard>し、その子として、アニメーションを追加します。 作成する方法を次に示します、<xref:System.Windows.Media.Animation.Storyboard>XAML でします。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_5)]  
+  
+     作成する、<xref:System.Windows.Media.Animation.Storyboard>コードでは、宣言、<xref:System.Windows.Media.Animation.Storyboard>クラス レベルの変数です。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_100)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_100)]  
+  
+     初期化して、<xref:System.Windows.Media.Animation.Storyboard>し、その子として、アニメーションを追加します。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_101)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_101)]  
+  
+2.  <xref:System.Windows.Media.Animation.Storyboard>アニメーションを適用する場所を知っていなければなりません。 使用して、 <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A?displayProperty=fullName>添付プロパティをアニメーション化するオブジェクトを指定します。 次のターゲットの名前を設定する方法を示しています、 <xref:System.Windows.Media.Animation.DoubleAnimation>に`MyRectangle`XAML でします。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_6)]  
+  
+     ターゲットの名前を設定する方法を次に示します、 <xref:System.Windows.Media.Animation.DoubleAnimation>に`MyRectangle`コードにします。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_102)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_102)]  
+  
+3.  使用して、<xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A>添付プロパティをアニメーション化するプロパティを指定します。 アニメーションを構成する方法を次に示しますターゲットに、<xref:System.Windows.UIElement.Opacity%2A>のプロパティ、<xref:System.Windows.Shapes.Rectangle>XAML でします。  
+  
+     [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml_7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/Window1.xaml#rectangleopacityfadeexamplexaml_7)]  
+  
+     アニメーションを構成する方法を次に示しますターゲットに、<xref:System.Windows.UIElement.Opacity%2A>のプロパティ、<xref:System.Windows.Shapes.Rectangle>コードにします。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_103)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_103)]  
+  
+ 詳細については<xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A>構文とその他の例を参照してください、[ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)します。  
+  
+<a name="opacity_animation_step3"></a>   
+### <a name="part-3-xaml-associate-the-storyboard-with-a-trigger"></a>パート 3 (XAML): トリガーでストーリー ボードの関連付け  
+ 最も簡単な方法を適用し、開始、<xref:System.Windows.Media.Animation.Storyboard>で[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]イベント トリガーを使用することです。                          このセクションに関連付ける方法を示しています、<xref:System.Windows.Media.Animation.Storyboard>XAML でのトリガーです。  
+  
+1.  作成、 <xref:System.Windows.Media.Animation.BeginStoryboard>オブジェクトし、ストーリー ボードを関連付けます。 A <xref:System.Windows.Media.Animation.BeginStoryboard>の種類は、 <xref:System.Windows.TriggerAction>を適用し、開始、<xref:System.Windows.Media.Animation.Storyboard>します。  
+  
+     [!code-xml[animation_ovws_snippet#RectangleOpacityFadeExampleInline_3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_snippet/CS/RectangleOpacityFadeExample.xaml#rectangleopacityfadeexampleinline_3)]  
+  
+2.  作成、 <xref:System.Windows.EventTrigger>を追加し、 <xref:System.Windows.Media.Animation.BeginStoryboard>にその<xref:System.Windows.EventTrigger.Actions%2A>コレクションです。 設定、 <xref:System.Windows.EventTrigger.RoutedEvent%2A>のプロパティ、 <xref:System.Windows.EventTrigger>をルーティングされたイベントを開始するには<xref:System.Windows.Media.Animation.Storyboard>します。 (ルーティング イベントの詳細については、次を参照してください、[ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)。)。  
+  
+     [!code-xml[animation_ovws_snippet#RectangleOpacityFadeExampleInline_2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_snippet/CS/RectangleOpacityFadeExample.xaml#rectangleopacityfadeexampleinline_2)]  
+  
+3.  追加、 <xref:System.Windows.EventTrigger>に、<xref:System.Windows.FrameworkElement.Triggers%2A>四角形のコレクション。  
+  
+     [!code-xml[animation_ovws_snippet#RectangleOpacityFadeExampleInline_1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_snippet/CS/RectangleOpacityFadeExample.xaml#rectangleopacityfadeexampleinline_1)]  
+  
+<a name="opacity_animation_step3code"></a>   
+### <a name="part-3-code-associate-the-storyboard-with-an-event-handler"></a>イベント ハンドラーを持つストーリー ボードの作業 3 (コード): 関連付け  
+ 最も簡単な方法を適用し、開始、<xref:System.Windows.Media.Animation.Storyboard>コードでは、イベント ハンドラーを使用します。 このセクションに関連付ける方法を示しています、<xref:System.Windows.Media.Animation.Storyboard>をコードでイベント ハンドラーです。  
+  
+1.  登録、 <xref:System.Windows.FrameworkElement.Loaded>四角形のイベントです。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_104)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_104](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_104)]  
+  
+2.  イベント ハンドラーを宣言します。 イベント ハンドラーで使用して、<xref:System.Windows.Media.Animation.Storyboard.Begin%2A>ストーリー ボードを適用するメソッドです。  
+  
+     [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode_105](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode_105)]
+     [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode_105](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode_105)]  
+  
+### <a name="complete-example"></a>コード例全体  
+ XAML でビューから消えますを四角形を作成する方法を次に示します。  
+  
+ [!code-xml[animation_ovws2#RectangleOpacityFadeExampleXaml](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml#rectangleopacityfadeexamplexaml)]  
+  
+ 表示と非表示のコードにフェードする四角形を作成する方法を次に示します。  
+  
+ [!code-csharp[animation_ovws2#RectangleOpacityFadeExampleCode](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws2/CSharp/MainWindow.xaml.cs#rectangleopacityfadeexamplecode)]
+ [!code-vb[animation_ovws2#RectangleOpacityFadeExampleCode](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws2/VisualBasic/MainWindow.xaml.vb#rectangleopacityfadeexamplecode)]  
+  
+<a name="animationtypes"></a>   
+## <a name="animation-types"></a>アニメーションの種類  
+ アニメーションは、プロパティの値を生成するため、プロパティの種類別のアニメーションの種類が存在します。 受け取るプロパティをアニメーション化する、<xref:System.Double>など、<xref:System.Windows.FrameworkElement.Width%2A>、要素のプロパティを生成するアニメーションを使用して<xref:System.Double>値。 受け取るプロパティをアニメーション化する、<xref:System.Windows.Point>、生成されるアニメーションを使用して<xref:System.Windows.Point>値、およびなどです。 種類のプロパティの数のためには、いくつかのアニメーション クラスは、 <xref:System.Windows.Media.Animation>名前空間。 幸いにも、それらはそれらを区別しやすく厳密な名前付け規則に従います。  
+  
+-   \<                         *型*> アニメーション  
+  
+     「から/に/者」または"basic"アニメーションと呼ばれ、これらをアニメーション化を開始し、移行先の値の間、または、開始値にオフセット値を追加することで。  
+  
+    -   開始値を指定するには、アニメーションの From プロパティを設定します。  
+  
+    -   終了値を指定するには、アニメーションの To プロパティを設定します。  
+  
+    -   オフセットの値を指定するには、アニメーションの By プロパティを設定します。  
+  
+     この概要の例は、最も簡単に使用されるため、これらのアニメーションを使用します。 From/を/、アニメーションは From/To/By アニメーションの概要で詳細に説明します。  
+  
+-   \<                         *型*> AnimationUsingKeyFrames  
+  
+     キー フレーム アニメーションは、任意の数のターゲット値を指定しても、補間方法を制御するので、/アニメーションよりも強力です。 一部の種類は、キー フレーム アニメーションをアニメーション化するだけです。 キー フレーム アニメーションがで詳しく説明されている、[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)します。  
+  
+-   \<                         *型*> AnimationUsingPath  
+  
+     パス アニメーションを使用すると、ジオメトリック パスをアニメーション化された値を生成するために使用できます。  
+  
+-   \<                         *型*> AnimationBase  
+  
+     実装するときにアニメーション化する抽象クラス、 <> \</>*型*> 値。 このクラスの基本クラスとして機能<>*型*> アニメーションと<>*型*> AnimationUsingKeyFrames クラスです。 ユーザー独自のアニメーションを作成する場合にのみ、これらのクラスを直接扱う必要があります。 それ以外の場合を使用して、 <> \</>*型*> アニメーションまたはキーフレーム<>*型*> アニメーションです。  
+  
+ ほとんどの場合、使用する場合は、 <> \</>*型*> などのアニメーション クラス<xref:System.Windows.Media.Animation.DoubleAnimation>と<xref:System.Windows.Media.Animation.ColorAnimation>します。  
+  
+ 次の表は、いくつかの一般的なアニメーションの種類と使用するいくつかのプロパティを示します。  
+  
+|プロパティの型|対応する (から/に/By) 基本アニメーション|対応するキー フレーム アニメーション|対応するパスのアニメーション|使用例|  
+|-------------------|----------------------------------------------------|---------------------------------------|----------------------------------|-------------------|  
+|<xref:System.Windows.Media.Color>|<xref:System.Windows.Media.Animation.ColorAnimation>|<xref:System.Windows.Media.Animation.ColorAnimationUsingKeyFrames>|なし|Animate the                                  <xref:System.Windows.Media.SolidColorBrush.Color%2A> of a                                  <xref:System.Windows.Media.SolidColorBrush> or a                                  <xref:System.Windows.Media.GradientStop>.|  
+|<xref:System.Double>|<xref:System.Windows.Media.Animation.DoubleAnimation>|<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames>|<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>|Animate the                                  <xref:System.Windows.FrameworkElement.Width%2A> of a                                  <xref:System.Windows.Controls.DockPanel> or the                                  <xref:System.Windows.FrameworkElement.Height%2A> of a                                  <xref:System.Windows.Controls.Button>.|  
+|<xref:System.Windows.Point>|<xref:System.Windows.Media.Animation.PointAnimation>|<xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames>|<xref:System.Windows.Media.Animation.PointAnimationUsingPath>|アニメーション化する、 <xref:System.Windows.Media.EllipseGeometry.Center%2A>の位置、 <xref:System.Windows.Media.EllipseGeometry>します。|  
+|<xref:System.String>|なし|<xref:System.Windows.Media.Animation.StringAnimationUsingKeyFrames>|なし|Animate the                                  <xref:System.Windows.Controls.TextBlock.Text%2A> of a                                  <xref:System.Windows.Controls.TextBlock> or the                                  <xref:System.Windows.Controls.ContentControl.Content%2A> of a                                  <xref:System.Windows.Controls.Button>.|  
+  
+<a name="animationsaretimelines"></a>   
+### <a name="animations-are-timelines"></a>アニメーションはタイムライン  
+ すべてのアニメーションの型を継承、<xref:System.Windows.Media.Animation.Timeline>クラスはそのため、すべてのアニメーション タイムラインの特殊な型です。 A<xref:System.Windows.Media.Animation.Timeline>時間のセグメントを定義します。 指定できます、*タイミング動作*のタイムラインの: その<xref:System.Windows.Media.Animation.Timeline.Duration%2A>の繰り返しと偶数の速さ時間の進行が何回です。  
+  
+ アニメーションがあるため、<xref:System.Windows.Media.Animation.Timeline>時間のセグメントもを表します。 しかし時間の指定されたセグメントで進行状況に合わせて出力値が、アニメーションによっても計算 (または<xref:System.Windows.Media.Animation.Timeline.Duration%2A>)。 アニメーション、または「再生」、関連付けられているプロパティを更新します。  
+  
+ 次の&3; つのタイミングを頻繁に使用されるプロパティは、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>、 <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>、および<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>します。  
+  
+#### <a name="the-duration-property"></a>Duration プロパティ  
+ 既に述べたようには、タイムラインは、時間のセグメントを表します。 そのセグメントの長さはによって決まります、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>通常を使用して指定されると、タイムラインの<xref:System.Windows.Duration.TimeSpan%2A>値。 タイムラインには、その期間の最後に達すると、イテレーションが完了しました。  
+  
+ アニメーションを使用してその<xref:System.Windows.Media.Animation.Timeline.Duration%2A>プロパティを現在の値を決定します。 指定しない場合、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>値、アニメーションの既定値は、1 秒間を使用します。  
+  
+ 次の構文の簡略版を示しています、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]属性の構文、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>プロパティです。  
+  
+||  
+|-|  
+|*hours* `:` *minutes* `:` *seconds*|  
+  
+ 次の表にいくつか示します<xref:System.Windows.Duration>設定とその結果として得られる値です。  
+  
+|設定|結果の値|  
+|-------------|---------------------|  
+|0:0:5.5|5.5 秒です。|  
+|0:30:5.5|30 分、5.5 秒です。|  
+|1:30:5.5|1 時間、30 分、および 5.5 秒です。|  
+  
+ 指定する方法の&1; つ、<xref:System.Windows.Duration>コードでは使用する、 <xref:System.TimeSpan.FromSeconds%2A>を作成する方法、 <xref:System.TimeSpan>を宣言し、新しい<xref:System.Windows.Duration>が使用している構造体<xref:System.TimeSpan>します。  
+  
+ 詳細については<xref:System.Windows.Duration>値と完全な[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]構文を参照してください、<xref:System.Windows.Duration>構造体。  
+  
+#### <a name="autoreverse"></a>AutoReverse  
+ <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>プロパティは、タイムラインの末尾に達した後再生旧バージョンとするかどうかを指定します。 その<xref:System.Windows.Media.Animation.Timeline.Duration%2A>します。 このアニメーションのプロパティを設定する場合`true`の末尾に達すると、アニメーションを反転させますその<xref:System.Windows.Media.Animation.Timeline.Duration%2A>、開始値に戻す終了値から再生します。 このプロパティは、既定では、`false`です。  
+  
+#### <a name="repeatbehavior"></a>RepeatBehavior  
+ <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>プロパティは、タイムラインの再生回数を指定します。 既定では、タイムラインがのイテレーション数をある`1.0`つまり、いずれかを果たすことが時間し、はまったく繰り返されません。  
+  
+ これらのプロパティおよびその他の詳細については、次を参照してください。、[タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)します。  
+  
+<a name="applyanimationstoproperty"></a>   
+## <a name="applying-an-animation-to-a-property"></a>プロパティにアニメーションを適用します。  
+ 前のセクションでは、さまざまな種類のアニメーションとタイミング プロパティについて説明します。 このセクションでは、アニメーションをアニメーション化するプロパティに適用する方法を示します。                  <xref:System.Windows.Media.Animation.Storyboard>オブジェクト プロパティにアニメーションを適用する&1; つの方法を提供します。 A<xref:System.Windows.Media.Animation.Storyboard>は、*コンテナー タイムライン*が含まれているアニメーションのターゲットの情報を提供します。  
+  
+### <a name="targeting-objects-and-properties"></a>ターゲット オブジェクトとプロパティ  
+ <xref:System.Windows.Media.Animation.Storyboard>クラスには、 <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A>と<xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A>アタッチされるプロパティです。 これらのプロパティを設定するには、アニメーションを指示できますアニメーションにアニメーションを作成します。 ただし、アニメーションは、オブジェクトをターゲット、前にオブジェクト必要があります通常する名前を指定します。  
+  
+ 名前が割り当てられて、 <xref:System.Windows.FrameworkElement>に名前の割り当てとは異なります、 <xref:System.Windows.Freezable>オブジェクトです。 ほとんどのコントロールとパネルは framework 要素です。ただし、ブラシ、変換、およびジオメトリなどのほとんどの純粋なグラフィカル オブジェクトは、freezable オブジェクトです。 わからないことを確認するかどうか、型の場合、 <xref:System.Windows.FrameworkElement>または<xref:System.Windows.Freezable>を参照してください、**継承階層**のリファレンス ドキュメントのセクションです。  
+  
+-   させる、 <xref:System.Windows.FrameworkElement>をアニメーションのターゲットを名前を設定してその<xref:System.Windows.FrameworkElement.Name%2A>プロパティです。 コードでは、必要がありますも使用する、 <xref:System.Windows.FrameworkElement.RegisterName%2A>が所属するページに要素名を登録する方法です。  
+  
+-   させる、 <xref:System.Windows.Freezable>オブジェクトをアニメーションのターゲットで[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]を使用する、 [X:name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)名前を指定します。 使用するだけのコードでは、 <xref:System.Windows.FrameworkElement.RegisterName%2A>が所属するページで、オブジェクトを登録します。  
+  
+ 以降のセクションでは、内の要素の名前を付ける例を示す[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]とコードです。 名前付けおよびターゲット設定の詳細については、次を参照してください。、[ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)します。  
+  
+### <a name="applying-and-starting-storyboards"></a>適用して、ストーリー ボードの開始  
+ ストーリー ボードを起動する[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、関連付けること、 <xref:System.Windows.EventTrigger>します。 <xref:System.Windows.EventTrigger>は、特定のイベントが発生したときに実行するアクションを記述するオブジェクト。 これらのアクションのいずれかを指定できます、 <xref:System.Windows.Media.Animation.BeginStoryboard>アクションを使用して、ストーリー ボードを開始します。 イベント トリガーは、アプリケーションが特定のイベントに応答する方法を指定することができるのでイベント ハンドラーに概念は似ています。 イベント トリガーで完全に記述するイベント ハンドラーとは異なり[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]; 他のコードは必要ありません。  
+  
+ 開始する、<xref:System.Windows.Media.Animation.Storyboard>コードでは、使用することができます、 <xref:System.Windows.EventTrigger>か使用して、<xref:System.Windows.Media.Animation.Storyboard.Begin%2A>のメソッド、<xref:System.Windows.Media.Animation.Storyboard>クラスです。  
+  
+<a name="controllingstoryboards"></a>   
+## <a name="interactively-control-a-storyboard"></a>ストーリー ボードを対話的に制御します。  
+ 前の例で開始する方法、<xref:System.Windows.Media.Animation.Storyboard>イベントが発生します。 対話形式で制御することができます、<xref:System.Windows.Media.Animation.Storyboard>開始後に: 一時停止、再開、停止、保留期間に進めること、シーク、および削除できます、<xref:System.Windows.Media.Animation.Storyboard>します。 詳細については、対話的に制御する方法を示す例の<xref:System.Windows.Media.Animation.Storyboard>を参照してください、[ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)します。  
+  
+<a name="fillbehaviorsection"></a>   
+## <a name="what-happens-after-an-animation-ends"></a>アニメーションの終了後どうなりますか。  
+ <xref:System.Windows.Media.Animation.FillBehavior>プロパティは、それが終了すると、タイムラインの動作を指定します。 既定では、タイムラインが開始<xref:System.Windows.Media.Animation.ClockState>終了します。 あるアニメーション<xref:System.Windows.Media.Animation.ClockState>その最終的な出力値を保持します。  
+  
+ <xref:System.Windows.Media.Animation.DoubleAnimation>前の例では終了しませんので、 <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>にプロパティが設定されている<xref:System.Windows.Media.Animation.RepeatBehavior.Forever%2A>します。 次の例では、類似のアニメーションを使用して、四角形をアニメーション化します。 前の例とは異なり、 <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A>と<xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>このアニメーションのプロパティは既定値のままです。 したがって、アニメーションは 0 まで 5 秒間で 1 から進行して停止します。  
+  
+ [!code-xml[animation_ovws_snippet#FillBehaviorExampleRectangleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_snippet/CS/FillBehaviorExample.xaml#fillbehaviorexamplerectangleinline)]  
+  
+ [!code-csharp[animation_ovws_procedural_snip#FillBehaviorExampleRectangleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_procedural_snip/CSharp/FillBehaviorExample.cs#fillbehaviorexamplerectangleinline)]
+ [!code-vb[animation_ovws_procedural_snip#FillBehaviorExampleRectangleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws_procedural_snip/visualbasic/fillbehaviorexample.vb#fillbehaviorexamplerectangleinline)]  
+  
+ その<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A>が、これは既定値から変更されていない<xref:System.Windows.Media.Animation.FillBehavior>アニメーションを保持して、最終的な値は 0、それが終了するとします。 したがって、<xref:System.Windows.UIElement.Opacity%2A>の四角形は、アニメーションの後の 0 から終了します。 設定した場合、<xref:System.Windows.UIElement.Opacity%2A>、別の値に四角形のコードが何効果、アニメーションがまだに影響を与えるため、<xref:System.Windows.UIElement.Opacity%2A>プロパティです。  
+  
+ コードでアニメーションのプロパティの制御を回復する方法の&1; つを使用して、 <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A>メソッド null を指定して、 <xref:System.Windows.Media.Animation.AnimationTimeline>パラメーター。 詳細と例では、次を参照してください。[設定、プロパティの後のアニメーション ストーリー ボードを](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md)します。  
+  
+ 持つプロパティの値を設定するが、 <xref:System.Windows.Media.Animation.ClockState>または<xref:System.Windows.Media.Animation.ClockState>アニメーションは効果がない、プロパティの値は変更できます。 詳細については、次を参照してください。、[アニメーションおよびタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)します。  
+  
+<a name="databindingAndAnimatingAnimationsSection"></a>   
+## <a name="data-binding-and-animating-animations"></a>データ バインドやアニメーションをアニメーション化  
+ ほとんどのアニメーション プロパティは、データ バインドやアニメーション化を指定できます。たとえば、アニメーション化できます、<xref:System.Windows.Media.Animation.Timeline.Duration%2A>のプロパティ、 <xref:System.Windows.Media.Animation.DoubleAnimation>します。 ただし、タイミング システムが動作する方法のため、データ バインドやアニメーションのアニメーションが他のデータと同様に動作しない場合はバインドされているか、オブジェクトをアニメーション化します。 その動作を理解するには、アニメーションをプロパティに適用する意味を理解すると役立ちます。  
+  
+ アニメーション化する方法を説明しました。 前のセクションで例を参照してください、<xref:System.Windows.UIElement.Opacity%2A>四角形のです。 そのイベント トリガーを適用前の例では、四角形が読み込まれるときに、<xref:System.Windows.Media.Animation.Storyboard>します。 タイミング システムのコピーを作成する、<xref:System.Windows.Media.Animation.Storyboard>およびそのアニメーションです。 これらのコピーが固定されている (読み取り専用に行われます) と<xref:System.Windows.Media.Animation.Clock>からオブジェクトが作成されます。 これらのクロックは、対象のプロパティをアニメーション化する実際の作業を実行します。  
+  
+ タイミング システム用の時計の作成、 <xref:System.Windows.Media.Animation.DoubleAnimation>オブジェクトとで指定されたプロパティに適用し、 <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A>と<xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A>の<xref:System.Windows.Media.Animation.DoubleAnimation>します。 タイミング システムにクロックを適用する場合は、<xref:System.Windows.UIElement.Opacity%2A>「続きとしてです」というオブジェクトのプロパティ。  
+  
+ クロックはの作成もされますが、<xref:System.Windows.Media.Animation.Storyboard>クロックは、任意のプロパティには適用されません。 その目的は、その子のクロックに作成される、時計を制御する、 <xref:System.Windows.Media.Animation.DoubleAnimation>します。  
+  
+ データ バインドやアニメーションの変更を反映するアニメーション、その時計を再生成する必要があります。 クロックは、自動的のするは再生成されません。 アニメーションの変更を反映するために、そのストーリー ボードを再適用を使用して、 <xref:System.Windows.Media.Animation.BeginStoryboard>または<xref:System.Windows.Media.Animation.Storyboard.Begin%2A>メソッドです。 これらのメソッドのいずれかを使用すると、アニメーションが再起動されます。 コードでは、使用することができます、 <xref:System.Windows.Media.Animation.Storyboard.Seek%2A>ストーリー ボードをシフトするメソッドは、前の位置にバックアップします。  
+  
+ データの例には、アニメーションがバインドされている、参照してください[キー スプライン アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160011)します。                  アニメーションとタイミング システムの動作の詳細については、次を参照してください。[アニメーションおよびタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)します。  
+  
+<a name="otherWaysToAnimateSection"></a>   
+## <a name="other-ways-to-animate"></a>その他の方法をアニメーション化します。  
+ この概要の例では、ストーリー ボードを使用してアニメーション化する方法を示します。 コードを使用すると、その他のいくつかの方法でアニメーション化できます。 詳細については、次を参照してください。、[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)します。  
+  
+<a name="animation_samples"></a>   
+## <a name="animation-samples"></a>アニメーションのサンプル  
+ 次の例では、アプリケーションにアニメーションの追加を開始できます。  
+  
+-   [From、To、およびアニメーションのターゲット値のサンプルで](http://go.microsoft.com/fwlink/?LinkID=159988)  
+  
+     別の/を/で設定を示します。  
+  
+-   [アニメーションのタイミング動作のサンプル](http://go.microsoft.com/fwlink/?LinkID=159970)  
+  
+     アニメーションの動作のタイミングを制御するさまざまな方法を示します。 このサンプルも示していますバインドする方法、アニメーションの終了値。  
+  
+<a name="related_topics"></a>   
+## <a name="related-topics"></a>関連トピック  
+  
+|タイトル|説明|  
+|-----------|-----------------|  
+|[アニメーションおよびタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)|タイミング システムの使用方法について説明します<xref:System.Windows.Media.Animation.Timeline>と<xref:System.Windows.Media.Animation.Clock>クラスで、アニメーションを作成することです。|  
+|[アニメーションのヒントと秘訣](../../../../docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md)|アニメーションでは、パフォーマンスなどの問題を解決するための役に立つヒントを一覧表示します。|  
+|[カスタム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/custom-animations-overview.md)|キー フレームで、アニメーション クラス、またはフレームごとのコールバックを使用してアニメーション システムを拡張する方法について説明します。|  
+|From/To/By アニメーションの概要|2 つの値の間を遷移するアニメーションを作成する方法について説明します。|  
+|[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)|補間方法を制御する機能など、複数のターゲット値を持つアニメーションを作成する方法について説明します。|  
+|[イージング関数](../../../../docs/framework/wpf/graphics-multimedia/easing-functions.md)|数式をバウンスなどの現実的な動作を実現する、アニメーションに適用する方法について説明します。|  
+|[パス アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/path-animations-overview.md)|移動または複雑なパスに沿ってオブジェクトを回転する方法について説明します。|  
+|[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)|プロパティのアニメーションのストーリー ボードを使用して、ローカル アニメーション、時計、およびアニメーションのフレームごとのについて説明します。|  
+|[ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)|複数のタイムラインでストーリー ボードを使用して、複雑なアニメーションを作成する方法について説明します。|  
+|[タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)|説明、<xref:System.Windows.Media.Animation.Timeline>型およびアニメーションで使用されるプロパティです。|  
+|[タイミング イベントの概要](../../../../docs/framework/wpf/graphics-multimedia/timing-events-overview.md)|使用できるイベントについて説明します、<xref:System.Windows.Media.Animation.Timeline>と<xref:System.Windows.Media.Animation.Clock>など、タイムラインの時点でコードを実行するためのオブジェクトを開始、一時停止、再開、スキップ、または停止します。|  
+|[操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)|アプリケーションでのアニメーションおよびタイムラインを使用するためのコード例を示します。|  
+|[クロックの操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/clocks-how-to-topics.md)|使用するコード例を含む、<xref:System.Windows.Media.Animation.Clock>アプリケーション内のオブジェクト。|  
+|[キー フレームの操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)|アプリケーションでキー フレーム アニメーションを使用するためのコード例を示します。|  
+|[パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)|パス アニメーションを使用して、アプリケーションのためのコード例が含まれています。|  
+  
+<a name="reference"></a>   
+## <a name="reference"></a>参照  
+ <xref:System.Windows.Media.Animation.Timeline>  
+  
+ <xref:System.Windows.Media.Animation.Storyboard>  
+  
+ <xref:System.Windows.Media.Animation.BeginStoryboard>  
+  
+ <xref:System.Windows.Media.Animation.Clock>
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md b/docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md
new file mode 100644
index 00000000000..0bb17ada067
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/animation-tips-and-tricks.md
@@ -0,0 +1,137 @@
+---
+title: "アニメーションのヒントとテクニック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション化 (オブジェクトを) [WPF], トラブルシューティング"
+  - "アニメーションのヒントとテクニック [WPF]"
+  - "アニメーション [WPF], FillBehavior プロパティ"
+  - "アニメーション [WPF], システム リソースの使用"
+  - "パフォーマンスのトラブルシューティング [WPF], アニメーション"
+  - "ヒントとテクニック [WPF], アニメーション"
+  - "トラブルシューティング [WPF], アニメーション"
+  - "トラブルシューティング (アニメーションの) [WPF]"
+ms.assetid: e467796b-d5d4-45a6-a108-8c5d7ff69a0f
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# アニメーションのヒントとテクニック
+ここでは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でアニメーションを扱うときに、パフォーマンスを向上させ、不満を解消するのに役立つ多くのヒントとテクニックについて説明します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="generalissuessection"></a>   
+## 一般的な問題  
+  
+### スクロール バーやスライダーの位置をアニメーション化するとフリーズする  
+ スクロール バーまたはスライダーの位置のアニメーション化に <xref:System.Windows.Media.Animation.FillBehavior> が <xref:System.Windows.Media.Animation.FillBehavior> \(既定値\) であるアニメーションを使用すると、ユーザーはスクロール バーまたはスライダーを使用できなくなります。  これは、アニメーションが完了した後も、ターゲット プロパティの基本値を上書きしているためです。  アニメーションがプロパティの現在値を上書きしないようにするには、アニメーションを削除するか、アニメーションの <xref:System.Windows.Media.Animation.FillBehavior> に <xref:System.Windows.Media.Animation.FillBehavior> を指定します。  詳細および使用例については、「[ストーリーボードを使用してアニメーション化した後にプロパティを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md)」を参照してください。  
+  
+### アニメーションの出力をアニメーション化したのに効果がない  
+ 別のアニメーションの出力であるオブジェクトをアニメーション化することはできません。  たとえば、<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> を使用して <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を <xref:System.Windows.Media.RadialGradientBrush> から <xref:System.Windows.Media.SolidColorBrush> にアニメーション化する場合、<xref:System.Windows.Media.RadialGradientBrush> または <xref:System.Windows.Media.SolidColorBrush> のプロパティはどちらもアニメーション化できません。  
+  
+### アニメーション化した後でプロパティの値を変更できない  
+ 状況によっては、プロパティをアニメーション化した後で、アニメーションが完了しても、そのプロパティの値を変更できないように見えることがあります。  これは、アニメーションが完了した後も、プロパティの基本値を上書きしているためです。  アニメーションがプロパティの現在値を上書きしないようにするには、アニメーションを削除するか、アニメーションの <xref:System.Windows.Media.Animation.FillBehavior> に <xref:System.Windows.Media.Animation.FillBehavior> を指定します。  詳細および使用例については、「[ストーリーボードを使用してアニメーション化した後にプロパティを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md)」を参照してください。  
+  
+### タイムラインを変更したのに効果がない  
+ ほとんどの <xref:System.Windows.Media.Animation.Timeline> プロパティはアニメーション化とデータ バインドが可能ですが、アクティブな <xref:System.Windows.Media.Animation.Timeline> のプロパティ値を変更しても効果がないように見えます。  これは、<xref:System.Windows.Media.Animation.Timeline> が開始されると、タイミング システムが <xref:System.Windows.Media.Animation.Timeline> のコピーを作成し、それを使用して <xref:System.Windows.Media.Animation.Clock> オブジェクトを作成するためです。  元のアニメーションを変更してもシステムのコピーには影響しません。  
+  
+ <xref:System.Windows.Media.Animation.Timeline> に変更を反映するには、クロックを再生成し、前に作成したクロックと置き換える必要があります。  クロックは自動的に再生成されるわけではありません。  タイムラインの変更を適用するいくつかの方法を次に示します。  
+  
+-   タイムラインが <xref:System.Windows.Media.Animation.Storyboard> の場合またはこれに属している場合、<xref:System.Windows.Media.Animation.BeginStoryboard> または <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用してストーリーボードを再適用することで、タイムラインに変更を反映させることができます。  ただし、この場合、アニメーションが再起動されるという影響があります。  コード内で <xref:System.Windows.Media.Animation.Storyboard.Seek%2A> メソッドを使用すると、ストーリーボードを以前の位置に戻すことができます。  
+  
+-   <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用して、アニメーションをプロパティに直接適用した場合は、<xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> を再度呼び出し、変更されたアニメーションを渡します。  
+  
+-   クロック レベルで直接作業している場合は、クロックの新しいセットを作成して適用し、これらのクロックを使用して生成済みのクロックの以前のセットを置き換えます。  
+  
+ タイムラインとクロックの詳細については、「[アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)」を参照してください。  
+  
+### FillBehavior.Stop が予期したとおりに動作しない  
+ あるアニメーションから別のアニメーションへの "引き継ぎ" のときなど、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティを <xref:System.Windows.Media.Animation.FillBehavior> にしても効果がないように見えることがあります。これは、<xref:System.Windows.Media.Animation.BeginStoryboard.HandoffBehavior%2A> 設定が <xref:System.Windows.Media.Animation.HandoffBehavior> になっているためです。  
+  
+ <xref:System.Windows.Controls.Canvas>、<xref:System.Windows.Shapes.Rectangle>、および <xref:System.Windows.Media.TranslateTransform> を作成する例を次に示します。  <xref:System.Windows.Media.TranslateTransform> は、<xref:System.Windows.Shapes.Rectangle> が <xref:System.Windows.Controls.Canvas> を動き回るようにアニメーション化されます。  
+  
+ [!code-xml[AnimationTipsAndTricksSample_snip#FillBehaviorTipAnimatedObject](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml#fillbehaviortipanimatedobject)]  
+  
+ このセクションの例では、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティが予期していたとおりには動作しないいくつかのケースについて、前のオブジェクトを使用して説明します。  
+  
+#### アニメーションが複数の場合の FillBehavior\="Stop" と HandoffBehavior  
+ あるアニメーションが別のアニメーションに置き換わるときに、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティが無視されているように見えることがあります。  これに関して、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを 2 つ作成し、それらを使用して、前の例で示された <xref:System.Windows.Media.TranslateTransform> をアニメーション化する例について考えてみます。  
+  
+ 最初の <xref:System.Windows.Media.Animation.Storyboard> である `B1` は、<xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティを 0 から 350 までアニメーション化します。これにより、四角形が 350 ピクセル左へ動きます。  アニメーションが終わって再生が完了すると、<xref:System.Windows.Media.TranslateTransform.X%2A> プロパティは元の値の 0 に戻ります。  その結果、四角形は右に 350 ピクセル移動し、元の位置に戻ります。  
+  
+ [!code-xml[AnimationTipsAndTricksSample_snip#FillBehaviorTipStoryboardB1Button](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml#fillbehaviortipstoryboardb1button)]  
+  
+ 2 番目の <xref:System.Windows.Media.Animation.Storyboard> である `B2` も、同じ <xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティをアニメーション化します。  <xref:System.Windows.Media.Animation.Storyboard> のアニメーションで設定されているのは <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティのみなので、アニメーションは開始値としてこのプロパティの現在の値を使用します。  
+  
+ [!code-xml[AnimationTipsAndTricksSample_snip#FillBehaviorTipStoryboardB2Button](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml#fillbehaviortipstoryboardb2button)]  
+  
+ 最初の <xref:System.Windows.Media.Animation.Storyboard> の再生中に 2 番目のボタンをクリックした場合は、次のように動作すると予期する可能性があります。  
+  
+1.  アニメーションの <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> が <xref:System.Windows.Media.Animation.FillBehavior> なので、最初のストーリーボードが完了すると、四角形が元の位置に戻る。  
+  
+2.  2 番目のストーリーボードが反映され、現在の位置の 0 から 500 へ動く。  
+  
+ 実際はこのように動作しません。四角形は元の位置に戻らず、右へ移動し続けます。  これは、2 番目のアニメーションが、最初のアニメーションの現在値を開始値として使用し、その値から 500 へとアニメーション化するためです。  <xref:System.Windows.Media.Animation.HandoffBehavior> <xref:System.Windows.Media.Animation.HandoffBehavior> の使用により 2 番目のアニメーションが最初のアニメーションと置き換わるとき、最初のアニメーションの <xref:System.Windows.Media.Animation.FillBehavior> は影響しません。  
+  
+#### FillBehavior と Completed イベント  
+ 次の例では、<xref:System.Windows.Media.Animation.FillBehavior> <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> の効果がないように見える別のシナリオについて説明します。  この例でも、Storyboard を使用して <xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティを 0 から 350 までアニメーション化します。  ただし、今回は <xref:System.Windows.Media.Animation.Timeline.Completed> イベントを登録します。  
+  
+ [!code-xml[AnimationTipsAndTricksSample_snip#FillBehaviorTipStoryboardCButton](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml#fillbehaviortipstoryboardcbutton)]  
+  
+ <xref:System.Windows.Media.Animation.Timeline.Completed> イベント ハンドラーは、同じプロパティを現在値から 500 へとアニメーション化する別の <xref:System.Windows.Media.Animation.Storyboard> を開始します。  
+  
+ [!code-csharp[AnimationTipsAndTricksSample_snip#FillBehaviorTipStoryboardC1CompletedHandler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml.cs#fillbehaviortipstoryboardc1completedhandler)]
+ [!code-vb[AnimationTipsAndTricksSample_snip#FillBehaviorTipStoryboardC1CompletedHandler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/VisualBasic/FillBehaviorTip.xaml.vb#fillbehaviortipstoryboardc1completedhandler)]  
+  
+ 次のマークアップは、2 番目の <xref:System.Windows.Media.Animation.Storyboard> をリソースとして定義します。  
+  
+ [!code-xml[AnimationTipsAndTricksSample_snip#FillBehaviorTipResources](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimationTipsAndTricksSample_snip/CSharp/FillBehaviorTip.xaml#fillbehaviortipresources)]  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> を実行すると、<xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティが 0 から 350 までアニメーション化され、完了すると 0 に戻り \(<xref:System.Windows.Media.Animation.FillBehavior> 設定が <xref:System.Windows.Media.Animation.FillBehavior> であるため\)、それから 0 から 500 へとアニメーション化されると予期する可能性があります。  しかし、実際には、<xref:System.Windows.Media.TranslateTransform> は 0 から 350 までアニメーション化されてから、500 へとアニメーション化されます。  
+  
+ これは、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] がイベントを生成する順序と、プロパティが無効化されない限り、プロパティ値はキャッシュされても再計算されないことが原因です。  <xref:System.Windows.Media.Animation.Timeline.Completed> イベントは、ルート タイムライン \(最初の <xref:System.Windows.Media.Animation.Storyboard>\) によってトリガーされることにより、最初に処理されます。  この時点では、<xref:System.Windows.Media.TranslateTransform.X%2A> プロパティはまだ無効化されていないので、アニメーション化された値を引き続き返します。  2 番目の <xref:System.Windows.Media.Animation.Storyboard> はキャッシュされた値を開始値として使用して、アニメーションを開始します。  
+  
+<a name="performancesection"></a>   
+## パフォーマンス  
+  
+### ページの外に移動した後もアニメーションが実行され続ける  
+ アニメーションの実行を続けている <xref:System.Windows.Controls.Page> の外に移動した後も、実行中のアニメーションは <xref:System.Windows.Controls.Page> のガベージ コレクションが実行されるまで再生され続けます。  使用しているナビゲーション システムに応じて、ページの外に移動した後もページが永続的にメモリに残り、その間アニメーションでリソースを消費し続けることがあります。  この現象は、常に実行される \("アンビエント"\) アニメーションがページに含まれている場合に最も顕著です。  
+  
+ このため、ページ外へ移動するときに <xref:System.Windows.FrameworkElement.Unloaded> イベントを使用してアニメーションを削除することをお勧めします。  
+  
+ アニメーションを削除する方法はいくつかあります。  <xref:System.Windows.Media.Animation.Storyboard> に属するアニメーションを削除するには、次のテクニックを使用できます。  
+  
+-   イベント トリガーで開始した <xref:System.Windows.Media.Animation.Storyboard> を削除するには、「[How to: Remove a Storyboard](http://msdn.microsoft.com/ja-jp/7fe39531-de2f-46a0-a69f-b783d04235ee)」を参照してください。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard> を削除するコードを使用するには、<xref:System.Windows.Media.Animation.Storyboard.Remove%2A> メソッドを参照してください。  
+  
+ 次のテクニックは、アニメーションの開始方法に関係なく使用できます。  
+  
+-   アニメーションを特定のプロパティから削除するには、<xref:System.Windows.Media.Animation.Animatable.BeginAnimation%28System.Windows.DependencyProperty%2CSystem.Windows.Media.Animation.AnimationTimeline%29> メソッドを使用します。  アニメーション化するプロパティを最初のパラメーターとして指定し、`null` を 2 番目のパラメーターとして指定します。  これにより、プロパティからすべてのアニメーション クロックが削除されます。  
+  
+ プロパティをアニメーション化するさまざまな方法の詳細については、「[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)」を参照してください。  
+  
+### Compose HandoffBehavior を使用するとシステム リソースが消費される  
+ <xref:System.Windows.Media.Animation.Storyboard>、<xref:System.Windows.Media.Animation.AnimationTimeline>、または <xref:System.Windows.Media.Animation.AnimationClock> を、<xref:System.Windows.Media.Animation.HandoffBehavior> <xref:System.Windows.Media.Animation.HandoffBehavior> を使用してプロパティに適用すると、そのプロパティに前に関連付けられていたすべての <xref:System.Windows.Media.Animation.Clock> オブジェクトがリソースを消費し続けます。タイミング システムは、これらのクロックを自動的には削除しません。  
+  
+ <xref:System.Windows.Media.Animation.HandoffBehavior> を使用して多数のクロックを適用するときにパフォーマンスの問題が発生しないようにするには、アニメーション化されたプロパティから構成するクロックを完了後に削除してください。  クロックを削除するには、いくつかの方法があります。  
+  
+-   プロパティからすべてのクロックを削除するには、アニメーション化されたオブジェクトの <xref:System.Windows.Media.Animation.Animatable.ApplyAnimationClock%28System.Windows.DependencyProperty%2CSystem.Windows.Media.Animation.AnimationClock%29> メソッドまたは <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%28System.Windows.DependencyProperty%2CSystem.Windows.Media.Animation.AnimationTimeline%29> メソッドを使用します。  アニメーション化するプロパティを最初のパラメーターとして指定し、`null` を 2 番目のパラメーターとして指定します。  これにより、プロパティからすべてのアニメーション クロックが削除されます。  
+  
+-   クロックのリストから特定の <xref:System.Windows.Media.Animation.AnimationClock> を削除するには、<xref:System.Windows.Media.Animation.AnimationClock> の <xref:System.Windows.Media.Animation.Clock.Controller%2A> プロパティを使用して <xref:System.Windows.Media.Animation.ClockController> を取得し、<xref:System.Windows.Media.Animation.ClockController> の <xref:System.Windows.Media.Animation.ClockController.Remove%2A> メソッドを呼び出します。  これは、一般にクロックの <xref:System.Windows.Media.Animation.Clock.Completed> イベント ハンドラーで行われます。  <xref:System.Windows.Media.Animation.ClockController> により制御できるのは、ルート クロックのみである点に注意してください。子クロックの <xref:System.Windows.Media.Animation.Clock.Controller%2A> プロパティは `null` を返します。  クロックの有効期間が無期限の場合、<xref:System.Windows.Media.Animation.Clock.Completed> イベントが発生しない点にも注意してください。  その場合、ユーザーは <xref:System.Windows.Media.Animation.ClockController.Remove%2A> をいつ呼び出すかを決定する必要があります。  
+  
+ これは、主に有効期間が長いオブジェクトにおけるアニメーションの問題です。  オブジェクトがガベージ コレクションされると、そのクロックも切断されてガベージ コレクションされます。  
+  
+ クロック オブジェクトの詳細については、「[アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)」を参照してください。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md
new file mode 100644
index 00000000000..bc167970fba
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md
@@ -0,0 +1,44 @@
+---
+title: "オーディオとビデオに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "メディア"
+  - "マルチメディア"
+ms.assetid: f7d96707-ffb5-486c-9e85-db6f0d5ac547
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# オーディオとビデオに関する「方法」トピック
+以下のトピックでは、<xref:System.Windows.Controls.MediaElement> を使用してアプリケーションにオーディオとビデオのコンテンツを統合する方法について説明します。  
+  
+## このセクションの内容  
+ [How to: Add an Element Dynamically](http://msdn.microsoft.com/ja-jp/d00f258a-7973-4de7-bc54-a3fc1f638419)  
+ [MediaElement \(再生、一時停止、停止、ボリューム、および速度\) を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md)  
+ [ストーリーボードを使用して MediaElement を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md)  
+ [ユーザー イベントによってメディアの再生をトリガーする](../../../../docs/framework/wpf/graphics-multimedia/how-to-trigger-media-playback-with-a-user-event.md)  
+ [メディアの再生を反復する](../../../../docs/framework/wpf/graphics-multimedia/how-to-repeat-media-playback.md)  
+ [アニメーションを使用してメディアを再生する](../../../../docs/framework/wpf/graphics-multimedia/how-to-play-media-with-animations.md)  
+ [MediaElement で変換を使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-transforms-on-a-mediaelement.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.MediaElement>  
+  
+ <xref:System.Windows.Media.MediaPlayer>  
+  
+ <xref:System.Windows.Media.MediaTimeline>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md b/docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md
new file mode 100644
index 00000000000..2a4fc25c348
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md
@@ -0,0 +1,78 @@
+---
+title: "ビットマップ効果の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ効果"
+ms.assetid: 23cb338e-4b59-4b52-b294-96431f9c9568
+caps.latest.revision: 34
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# ビットマップ効果の概要
+ビットマップ効果により、デザイナーおよび開発者は、描画された [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] コンテンツに視覚効果を適用できます。  たとえば、ビットマップ効果を使用すると、イメージまたはボタンに <xref:System.Windows.Media.Effects.DropShadowBitmapEffect> 効果やぼかし効果を簡単に適用できます。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] 以降では、<xref:System.Windows.Media.Effects.BitmapEffect> クラスは使用されなくなりました。  <xref:System.Windows.Media.Effects.BitmapEffect> クラスを使用すると、廃止されていることを示す例外が返されます。  <xref:System.Windows.Media.Effects.BitmapEffect> クラスの代替としては <xref:System.Windows.Media.Effects.Effect> クラスを使用できます。  ほとんどの場合は、<xref:System.Windows.Media.Effects.Effect> クラスを使用した方が高速に処理できます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="wpf_effects"></a>   
+## WPF ビットマップ効果  
+ ビットマップ効果 \(<xref:System.Windows.Media.Effects.BitmapEffect> オブジェクト\) は、単純なピクセル処理操作です。  ビットマップ効果は入力として <xref:System.Windows.Media.Imaging.BitmapSource> を取得し、ぼかしやドロップ シャドウなどの効果を適用した後で、新しい <xref:System.Windows.Media.Imaging.BitmapSource> を生成します。  各ビットマップ効果は、フィルタリング プロパティを制御できるプロパティ \(<xref:System.Windows.Media.Effects.BlurBitmapEffect> の <xref:System.Windows.Media.Effects.BlurBitmapEffect.Radius%2A> など\) を公開します。  
+  
+ 特殊なケースとして、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、<xref:System.Windows.Controls.Button> や <xref:System.Windows.Controls.TextBox> などの使用中の <xref:System.Windows.Media.Visual> オブジェクトのプロパティとして効果を設定できます。  ピクセル処理が適用され、実行時に描画されます。  この場合、描画時に、<xref:System.Windows.Media.Visual> は等価の <xref:System.Windows.Media.Imaging.BitmapSource> に自動的に変換され、<xref:System.Windows.Media.Effects.BitmapEffect> の入力として供給されます。  出力により、<xref:System.Windows.Media.Visual> オブジェクトの既定のレンダリング動作が置き換えられます。  そのため、<xref:System.Windows.Media.Effects.BitmapEffect> オブジェクトはビジュアルがソフトウェアのみで描画されることを強制します。つまり、  効果の適用時には、ビジュアルに対してハードウェア アクセラレータは使用されません。  
+  
+-   <xref:System.Windows.Media.Effects.BlurBitmapEffect> は、焦点を外したように見えるオブジェクトをシミュレートします。  
+  
+-   <xref:System.Windows.Media.Effects.OuterGlowBitmapEffect> は、オブジェクトの周囲に色のにじみを作成します。  
+  
+-   <xref:System.Windows.Media.Effects.DropShadowBitmapEffect> は、オブジェクトの背後に影を作成します。  
+  
+-   <xref:System.Windows.Media.Effects.BevelBitmapEffect> は、指定した曲線に従ってイメージの表面を浮き上がらせる傾斜面を作成します。  
+  
+-   <xref:System.Windows.Media.Effects.EmbossBitmapEffect> は <xref:System.Windows.Media.Visual> のバンプ マッピングを作成し、人工光源による奥行とテクスチャから得られる印象を生成します。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ビットマップ効果は、ソフトウェア モードで描画されます。  効果を適用するすべてのオブジェクトもソフトウェアで描画されます。  パフォーマンスが最も低下するのは、ビットマップ効果を大規模なビジュアルやビットマップ効果のアニメーション プロパティに適用した場合です。  ビットマップ効果をこのような方法で使用してはならないわけではありませんが、予期したとおりのエクスペリエンスをユーザーが体験することを保証するため、使用する場合は細心の注意を払い、徹底的にテストしてください。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ビットマップ効果は、部分信頼では実行できません。  アプリケーションでビットマップ効果を使用するには、完全信頼のアクセス許可が必要です。  
+  
+<a name="applyeffects"></a>   
+## 効果を適用する方法  
+ <xref:System.Windows.Media.Effects.BitmapEffect> は <xref:System.Windows.Media.Visual> のプロパティです。  したがって、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.Image>、<xref:System.Windows.Media.DrawingVisual>、<xref:System.Windows.UIElement> などのビジュアルに効果を適用するのは、プロパティを設定するのと同様に簡単です。  <xref:System.Windows.UIElement.BitmapEffect%2A> は 1 つの <xref:System.Windows.Media.Effects.BitmapEffect> オブジェクトに設定できます。また、<xref:System.Windows.Media.Effects.BitmapEffectGroup> オブジェクトを使用して、複数の効果を連結することもできます。  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で <xref:System.Windows.Media.Effects.BitmapEffect> を適用する方法を次の例に示します。  
+  
+ [!code-xml[EffectsGallery_snip#BlurSimpleExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EffectsGallery_snip/CSharp/blursimpleexample.xaml#blursimpleexampleinline)]  
+  
+ コードで <xref:System.Windows.Media.Effects.BitmapEffect> を適用する方法を次の例に示します。  
+  
+ [!code-csharp[EffectsGallery_snip#CodeBehindBlurCodeBehindExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/EffectsGallery_snip/CSharp/blurcodebehindexample.xaml.cs#codebehindblurcodebehindexampleinline)]  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Effects.BitmapEffect> が <xref:System.Windows.Controls.DockPanel> や <xref:System.Windows.Controls.Canvas> などのレイアウト コンテナーに適用されると、効果は要素またはビジュアルのビジュアル ツリー \(すべての子要素を含む\) に適用されます。  
+  
+<a name="customeffects"></a>   
+## カスタム効果の作成  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] は、マネージ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションで使用できるカスタム効果を作成するために、アンマネージ インターフェイスも提供します。  カスタム ビットマップ効果の作成に関する追加リファレンス資料については、「[アンマネージ WPF ビットマップ効果](_wibe_lh)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Effects.BitmapEffectGroup>   
+ <xref:System.Windows.Media.Effects.BitmapEffectInput>   
+ <xref:System.Windows.Media.Effects.BitmapEffectCollection>   
+ [Unmanaged WPF Bitmap Effect](_wibe_lh)   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [セキュリティ](../../../../docs/framework/wpf/security-wpf.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/bitmap-effects.md b/docs/framework/wpf/graphics-multimedia/bitmap-effects.md
new file mode 100644
index 00000000000..0b5add77639
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/bitmap-effects.md
@@ -0,0 +1,43 @@
+---
+title: "ビットマップ効果 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ビットマップ効果"
+  - "ビットマップ イメージ"
+  - "グラフィックス [WPF], ビットマップ効果"
+  - "イメージ, ビットマップ"
+ms.assetid: be180b56-ca6e-4da3-a839-f6b0bf482f7d
+caps.latest.revision: 62
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 62
+---
+# ビットマップ効果
+このセクションのトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] を使用して、ビットマップ イメージに視覚効果を適用する方法について説明します。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] 以降では、<xref:System.Windows.Media.Effects.BitmapEffect> クラスは使用されなくなりました。  <xref:System.Windows.Media.Effects.BitmapEffect> クラスを使用すると、廃止されていることを示す例外が返されます。  <xref:System.Windows.Media.Effects.BitmapEffect> クラスの代替としては <xref:System.Windows.Media.Effects.Effect> クラスを使用できます。  ほとんどの場合は、<xref:System.Windows.Media.Effects.Effect> クラスを使用した方が高速に処理できます。  
+  
+## このセクションの内容  
+ [ビットマップ効果の概要](../../../../docs/framework/wpf/graphics-multimedia/bitmap-effects-overview.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Effects.BitmapEffect>  
+  
+ <xref:System.Windows.Media.Effects>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)  
+  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md b/docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md
new file mode 100644
index 00000000000..6790f92a6e2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md
@@ -0,0 +1,112 @@
+---
+title: "ブラシの変換の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 変換プロパティ"
+  - "プロパティ, 変換"
+  - "変換プロパティ (ブラシの)"
+ms.assetid: 8b9bfc09-12fd-4cd5-b445-99949f27bc39
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ブラシの変換の概要
+Brush クラスは、<xref:System.Windows.Media.Brush.RelativeTransform%2A> と <xref:System.Windows.Media.Brush.Transform%2A> の 2 つの変換プロパティを提供します。  これらのプロパティを使用すると、ブラシのコンテンツの回転、拡大縮小、傾斜、および平行移動を行うことができます。  ここでは、2 つのプロパティの違いについて説明し、それらの使用例を示します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、変換するブラシの機能を理解する必要があります。  <xref:System.Windows.Media.LinearGradientBrush> と <xref:System.Windows.Media.RadialGradientBrush> については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  <xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、または <xref:System.Windows.Media.VisualBrush> については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  また、「[変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)」で説明されている 2D 変換にも精通している必要があります。  
+  
+<a name="transformversusrelativetransform"></a>   
+## Transform プロパティと RelativeTransform プロパティの違い  
+ ブラシの <xref:System.Windows.Media.Brush.Transform%2A> プロパティに変換を適用する場合、ブラシのコンテンツをその中心を軸に変換するときは、塗りつぶされる領域のサイズを認識しておく必要があります。  塗りつぶされる領域は、幅が 200 [デバイス非依存ピクセル](GTMT)で、高さが 150 であると仮定します。  <xref:System.Windows.Media.RotateTransform> を使用して、ブラシの中心を軸に出力を 45 度回転した場合は、<xref:System.Windows.Media.RotateTransform> で <xref:System.Windows.Media.RotateTransform.CenterX%2A> に 100、<xref:System.Windows.Media.RotateTransform.CenterY%2A> に 75 を指定したことになります。  
+  
+ ブラシの <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに変換を適用する場合は、この変換がブラシに適用されてから、塗りつぶされる領域に出力がマップされます。  ブラシのコンテンツが処理および変換される順序を次に示します。  
+  
+1.  ブラシのコンテンツを処理します。  これは、<xref:System.Windows.Media.GradientBrush> では、グラデーション領域を決定することを意味します。  <xref:System.Windows.Media.TileBrush> では、<xref:System.Windows.Media.TileBrush.Viewbox%2A> が <xref:System.Windows.Media.TileBrush.Viewport%2A> にマップされます。  これがブラシの出力になります。  
+  
+2.  ブラシの出力を 1 × 1 の変換四角形に投影します。  
+  
+3.  ブラシの <xref:System.Windows.Media.Brush.RelativeTransform%2A> がある場合は、それを適用します。  
+  
+4.  塗りつぶす領域に、変換された出力を投影します。  
+  
+5.  ブラシの <xref:System.Windows.Media.Transform> がある場合は、それを適用します。  
+  
+ ブラシの出力が 1 × 1 の四角形にマップされている間に <xref:System.Windows.Media.Brush.RelativeTransform%2A> が適用されるため、変換の中心とオフセット値は相対的に表されます。  たとえば、<xref:System.Windows.Media.RotateTransform> を使用して、ブラシの中心を軸に出力を 45 度回転した場合は、<xref:System.Windows.Media.RotateTransform> で <xref:System.Windows.Media.RotateTransform.CenterX%2A> に 0.5、<xref:System.Windows.Media.RotateTransform.CenterY%2A> に 0.5 を指定したことになります。  
+  
+ 次の図は、<xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティと <xref:System.Windows.Media.Brush.Transform%2A> プロパティを使用して 45 度回転された複数のブラシの出力を示しています。  
+  
+ ![RelativeTransform プロパティと Transform プロパティ](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brushrelativetransform-transform-small.png "graphicsmm\_brushrelativetransform\_transform\_small")  
+  
+<a name="relativetransformandtilebrush"></a>   
+## TileBrush での RelativeTransform の使用  
+ タイル ブラシは他のブラシより複雑であるため、これに <xref:System.Windows.Media.Brush.RelativeTransform%2A> を適用すると予期しない結果が生じる可能性があります。  たとえば、次のイメージを使用するとします。  
+  
+ ![ソース イメージ](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-1-original-image.png "graphicsmm\_reltransform\_1\_original\_image")  
+  
+ 次の例では、<xref:System.Windows.Media.ImageBrush> を使用して、四角形領域を上のイメージで塗りつぶします。  <xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.ImageBrush> オブジェクトの <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに適用し、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを <xref:System.Windows.Media.Stretch> に設定します。この設定によって、イメージが引き伸ばされて四角形を完全に塗りつぶす際に、イメージの縦横比が保持されます。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMRelativeTransformExample2Inline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/RelativeTransformIllustration.xaml#graphicsmmrelativetransformexample2inline)]  
+  
+ この例を実行すると、次の出力が生成されます。  
+  
+ ![変換された出力](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-6-output.png "graphicsmm\_reltransform\_6\_output")  
+  
+ ブラシの <xref:System.Windows.Media.TileBrush.Stretch%2A> が <xref:System.Windows.Media.Stretch> に設定された場合でも、イメージがゆがめられます。  これは、ブラシの <xref:System.Windows.Media.TileBrush.Viewbox%2A> が <xref:System.Windows.Media.TileBrush.Viewport%2A> にマップされた後に相対変換が適用されるためです。  プロセスの手順を次に示します。  
+  
+1.  ブラシの <xref:System.Windows.Media.TileBrush.Stretch%2A> を設定して、ブラシのコンテンツ \(<xref:System.Windows.Media.TileBrush.Viewbox%2A>\) を基本タイル \(<xref:System.Windows.Media.TileBrush.Viewport%2A>\) に投影します。  
+  
+     ![ビューポートに合わせて Viewbox を拡大](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-2-viewbox-to-viewport.png "graphicsmm\_reltransform\_2\_viewbox\_to\_viewport")  
+  
+2.  基本タイルを 1 × 1 の変換四角形に投影します。  
+  
+     ![ビューポートを変換四角形に割り当て](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-3-output-to-transform.png "graphicsmm\_reltransform\_3\_output\_to\_transform")  
+  
+3.  <xref:System.Windows.Media.RotateTransform> を適用します。  
+  
+     ![相対変換の適用](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-4-transform-rotate.png "graphicsmm\_reltransform\_4\_transform\_rotate")  
+  
+4.  塗りつぶす領域に、変換された基本タイルを投影します。  
+  
+     ![変換されたブラシを出力領域に反映](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-reltransform-5-transform-to-output.png "graphicsmm\_reltransform\_5\_transform\_to\_output")  
+  
+<a name="rotateexample"></a>   
+## 例 : ImageBrush を 45 度回転する  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに適用しています。  <xref:System.Windows.Media.RotateTransform> オブジェクトの <xref:System.Windows.Media.RotateTransform.CenterX%2A> プロパティおよび <xref:System.Windows.Media.RotateTransform.CenterY%2A> プロパティは、コンテンツの中心点の相対座標である 0.5 に設定されています。  その結果、ブラシの内容はその中心を軸にして回転します。  
+  
+ [!code-csharp[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTransformExample.cs#imagebrushrelativetransformexample)]
+ [!code-vb[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtransformexample.vb#imagebrushrelativetransformexample)]
+ [!code-xml[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTransformExample.xaml#imagebrushrelativetransformexample)]  
+  
+ 次の例でも <xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.ImageBrush> に適用していますが、<xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティの代わりに <xref:System.Windows.Media.Brush.Transform%2A> プロパティを使用しています。  ブラシをその中心を軸に回転するには、<xref:System.Windows.Media.RotateTransform> オブジェクトの <xref:System.Windows.Media.RotateTransform.CenterX%2A> および <xref:System.Windows.Media.RotateTransform.CenterY%2A> を絶対座標に設定する必要があります。  ブラシで描画される四角形は 175 × 90 ピクセルであるため、その中心点は \(87.5, 45\) になります。  
+  
+ [!code-csharp[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTransformExample.cs#imagebrushtransformexample)]
+ [!code-vb[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtransformexample.vb#imagebrushtransformexample)]
+ [!code-xml[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTransformExample.xaml#imagebrushtransformexample)]  
+  
+ 次の図は、変換していないブラシ、<xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに変換を適用したブラシ、および <xref:System.Windows.Media.Brush.Transform%2A> プロパティに変換を適用したブラシを示しています。  
+  
+ ![ブラシ RelativeTransform と変換の設定](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-transformandrelativetransform.png "wcpsdk\_graphicsmm\_transformandrelativetransform")  
+  
+ この例は、より大きなサンプルの一部です。  サンプル全体については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  ブラシの詳細については、「[WPF のブラシの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Brush.Transform%2A>   
+ <xref:System.Windows.Media.Brush.RelativeTransform%2A>   
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.Brush>   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md
new file mode 100644
index 00000000000..d56b1c7e5d4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md
@@ -0,0 +1,63 @@
+---
+title: "ブラシに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ブラシ"
+  - "グラフィックス, ブラシ"
+ms.assetid: 43e7f798-9558-4498-b5b6-4a4c6baf956b
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# ブラシに関する「方法」トピック
+以下のトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のブラシを使用して、コンテンツで画面を塗りつぶす方法を示します。  
+  
+## このセクションの内容  
+ [SolidColorBrush の色または不透明度をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-color-or-opacity-of-a-solidcolorbrush.md)  
+ [グラデーション ストップの位置または色をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-or-color-of-a-gradient-stop.md)  
+ [反射を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-reflection.md)  
+ [TileBrush を使用してさまざまなタイル パターンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-different-tile-patterns-with-a-tilebrush.md)  
+ [ペンを定義する](../../../../docs/framework/wpf/graphics-multimedia/how-to-define-a-pen.md)  
+ [描画を使用して領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-drawing.md)  
+ [イメージで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-an-image.md)  
+ [線形グラデーションを使用して領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-linear-gradient.md)  
+ [放射状グラデーションを使用して領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-radial-gradient.md)  
+ [純色で領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-solid-color.md)  
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)  
+ [ビデオを使用して領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-video.md)  
+ [ビジュアルで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-visual.md)  
+ [背景として使用するイメージの縦横比を保持する](../../../../docs/framework/wpf/graphics-multimedia/how-to-preserve-the-aspect-ratio-of-an-image-used-as-a-background.md)  
+ [TileBrush の水平方向および垂直方向の配置を設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-the-horizontal-and-vertical-alignment-of-a-tilebrush.md)  
+ [TileBrush のタイル サイズを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-the-tile-size-for-a-tilebrush.md)  
+ [ブラシを変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-transform-a-brush.md)  
+ [グラデーションでシステム カラーを使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Brush>  
+  
+ <xref:System.Windows.Media.SolidColorBrush>  
+  
+ <xref:System.Windows.Media.LinearGradientBrush>  
+  
+ <xref:System.Windows.Media.RadialGradientBrush>  
+  
+ <xref:System.Windows.Media.DrawingBrush>  
+  
+ <xref:System.Windows.Media.VisualBrush>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)  
+  
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/brushes.md b/docs/framework/wpf/graphics-multimedia/brushes.md
new file mode 100644
index 00000000000..55513758dfe
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/brushes.md
@@ -0,0 +1,53 @@
+---
+title: "ブラシ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "ブラシ"
+  - "グラフィックス, ブラシ"
+  - "塗りつぶし [WPF]"
+ms.assetid: 26710879-12ad-4c63-9bc6-a1834bb4243b
+caps.latest.revision: 53
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 53
+---
+# ブラシ
+以下のトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ブラシを使用して画面をコンテンツで "塗りつぶす" 方法について説明します。  
+  
+## このセクションの内容  
+ [WPF のブラシの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md)  
+ [ブラシの変換の概要](../../../../docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md)  
+ [不透明マスクの概要](../../../../docs/framework/wpf/graphics-multimedia/opacity-masks-overview.md)  
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)  
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)  
+ [TileBrush の概要](../../../../docs/framework/wpf/graphics-multimedia/tilebrush-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Brush>  
+  
+ <xref:System.Windows.Media.SolidColorBrush>  
+  
+ <xref:System.Windows.Media.LinearGradientBrush>  
+  
+ <xref:System.Windows.Media.RadialGradientBrush>  
+  
+ <xref:System.Windows.Media.DrawingBrush>  
+  
+ <xref:System.Windows.Media.VisualBrush>  
+  
+## 関連項目  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)  
+  
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/change-the-speed-of-a-clock.md b/docs/framework/wpf/graphics-multimedia/change-the-speed-of-a-clock.md
new file mode 100644
index 00000000000..3e0531b37a4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/change-the-speed-of-a-clock.md
@@ -0,0 +1,27 @@
+---
+title: "方法 : タイムラインの速度を変更せずにクロックの速度を変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クロック, 変更 (速度を)"
+  - "速度 (クロックの), 変更"
+ms.assetid: 72f36dd0-f085-445d-8589-19a83fe74f5e
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : タイムラインの速度を変更せずにクロックの速度を変更する
+<xref:System.Windows.Media.Animation.ClockController> オブジェクトの <xref:System.Windows.Media.Animation.ClockController.SpeedRatio%2A> プロパティを使用すると、クロックの <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.SpeedRatio%2A> を変更せずに <xref:System.Windows.Media.Animation.Clock> の速度を変更できます。  次の例では、クロックの <xref:System.Windows.Media.Animation.ClockController.SpeedRatio%2A> を対話的に変更するために、<xref:System.Windows.Media.Animation.ClockController> を使用しています。  <xref:System.Windows.Media.Animation.Clock.CurrentGlobalSpeedInvalidated> イベントと、クロックの <xref:System.Windows.Media.Animation.Clock.CurrentGlobalSpeed%2A> プロパティを使用して、クロックの対話型 <xref:System.Windows.Media.Animation.ClockController.SpeedRatio%2A> が変更されるたびに、クロックの現在のグローバル速度を表示します。  
+  
+## 使用例  
+ [!code-csharp[timingbehaviors_procedural_snip#GraphicsMMClockControllerSpeedRatioExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_procedural_snip/CSharp/ClockControllerSpeedRatioExample.cs#graphicsmmclockcontrollerspeedratioexample)]
+ [!code-vb[timingbehaviors_procedural_snip#GraphicsMMClockControllerSpeedRatioExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_procedural_snip/visualbasic/clockcontrollerspeedratioexample.vb#graphicsmmclockcontrollerspeedratioexample)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/clocks-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/clocks-how-to-topics.md
new file mode 100644
index 00000000000..0525c680b0e
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/clocks-how-to-topics.md
@@ -0,0 +1,46 @@
+---
+title: "クロックに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アニメーション, クロック"
+  - "クロック"
+  - "クロック, アニメーション"
+  - "グラフィックス [WPF], クロック"
+ms.assetid: c687b2a5-b151-41e2-9ade-df2fc1a16b04
+caps.latest.revision: 37
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# クロックに関する「方法」トピック
+以下のトピックでは、<xref:System.Windows.Media.Animation.Clock> オブジェクトを使用して、<xref:System.Windows.Media.Animation.Timeline> のタイミング状態情報を維持する方法について説明します。  
+  
+## このセクションの内容  
+ [AnimationClock を使用してプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md)  
+ [クロックを対話的に制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-interactively-control-a-clock.md)  
+ [クロックを同期的にシークする](../../../../docs/framework/wpf/graphics-multimedia/how-to-seek-a-clock-synchronously.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Animation.Clock>  
+  
+ <xref:System.Windows.Media.Animation.Storyboard>  
+  
+ <xref:System.Windows.Media.Animation>  
+  
+ <xref:System.Windows.Media.Animation.Timeline>  
+  
+## 関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)  
+  
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/custom-animations-overview.md b/docs/framework/wpf/graphics-multimedia/custom-animations-overview.md
new file mode 100644
index 00000000000..03f7f2159fe
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/custom-animations-overview.md
@@ -0,0 +1,144 @@
+---
+title: "カスタム アニメーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, カスタム クラス"
+  - "カスタム アニメーション クラス"
+  - "カスタム クラス, アニメーション"
+  - "カスタム キー フレーム"
+  - "キー フレーム, カスタム"
+ms.assetid: 9be69d50-3384-4938-886f-08ce00e4a7a6
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# カスタム アニメーションの概要
+ここでは、カスタム キー フレームまたはアニメーション クラスを作成するか、フレームごとのコールバックを使用してアニメーション システムをバイパスすることにより、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のアニメーション システムを拡張する方法とタイミングを説明します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が提供するさまざまな種類のアニメーションに精通している必要があります。  詳細については、「[From\/To\/By アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md)」、「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」、および「[パス アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/path-animations-overview.md)」を参照してください。  
+  
+ アニメーション クラスは <xref:System.Windows.Freezable> クラスを継承するため、<xref:System.Windows.Freezable> オブジェクトおよび <xref:System.Windows.Freezable> クラスの継承方法に精通している必要があります。  詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+<a name="extendingtheanimationsystem"></a>   
+## アニメーション システムの拡張  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーション システムの拡張方法は、使用する組み込み機能のレベルに応じて多数あります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のアニメーション エンジンには、次の 3 つの主要な拡張ポイントがあります。  
+  
+-   <xref:System.Windows.Media.Animation.DoubleKeyFrame> など *\<Type\>*KeyFrame クラスの 1 つを継承することにより、カスタム キー フレーム オブジェクトを作成します。  この方法では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のアニメーション エンジンの組み込み機能のほとんどを使用します。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline> を継承するか、*\<Type\>*AnimationBase クラスの 1 つを継承することにより、独自のアニメーション クラスを作成します。  
+  
+-   フレームごとのコールバックを使用してフレーム ベースのアニメーションを生成します。  この方法は、アニメーションとタイミング システムを完全にバイパスします。  
+  
+ アニメーション システムを拡張するためのいくかのシナリオを次の表に示します。  
+  
+|目的|使用する方法|  
+|--------|------------|  
+|対応する *\<Type\>*AnimationUsingKeyFrames を持つ型の値間の補間をカスタマイズする|カスタム キー フレームを作成します。  詳細については、「[カスタム キー フレームの作成](#createacustomkeyframe)」を参照してください。|  
+|対応する *\<Type\>*Animation を持つ型の値間の補間以上のものもカスタマイズする|アニメーション化する型に対応する *\<Type\>*AnimationBase クラスを継承する、カスタム アニメーション クラスを作成します。  詳細については、「[カスタム アニメーション クラスの作成](#createcustomanimationtype)」を参照してください。|  
+|対応する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーションを持たない型をアニメーション化する|<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> を使用するか、<xref:System.Windows.Media.Animation.AnimationTimeline> を継承するクラスを作成します。  詳細については、「[カスタム アニメーション クラスの作成](#createcustomanimationtype)」を参照してください。|  
+|オブジェクトの最後の一連のやり取りに基づいてフレームごとに計算された値で、複数のオブジェクトをアニメーション化する|フレームごとのコールバックを使用します。  詳細については、「[フレームごとのコールバックの使用](#useperframecallback)」を参照してください。|  
+  
+<a name="createacustomkeyframe"></a>   
+## カスタム キー フレームの作成  
+ カスタム キー フレーム クラスの作成は、アニメーション システムを拡張する最も簡単な方法です。  この方法は、キーフレーム アニメーションに対して別の補間方式が必要な場合に使用します。  「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」で説明しているように、キー フレーム アニメーションは、キー フレーム オブジェクトを使用してその出力値を生成します。  各キー フレームオブジェクトは、次の 3 つの機能を実行します。  
+  
+-   その <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> プロパティを使用してターゲットの値を指定します。  
+  
+-   その <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> プロパティを使用して値に達する時間を指定します。  
+  
+-   InterpolateValueCore メソッドを実装して、前のキー フレームの値とその独自の値の間を補間します。  
+  
+ **実装手順**  
+  
+ *\<Type\>*KeyFrame 抽象クラスから派生して、InterpolateValueCore メソッドを実装します。  InterpolateValueCore メソッドは、キー フレームの現在の値を返します。  このメソッドは、前のキー フレームの値と、0 ～ 1 の進行状況を示す値の 2 つのパラメーターを受け取ります。  進行状況 0 は、キー フレームが開始したばかりであることを示し、1 は、キー フレームが完了したばかりで、その <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> プロパティで指定された値を返す必要があることを示します。  
+  
+ *\<Type\>*KeyFrame クラスは <xref:System.Windows.Freezable> クラスを継承するため、<xref:System.Windows.Freezable.CreateInstanceCore%2A> コアをオーバーライドして、クラスの新しいインスタンスを返す必要もあります。  クラスがデータの格納に[依存関係プロパティ](GTMT)を使用していない場合や、作成後に追加の初期化を必要とする場合は、状況に応じて上記以外のメソッドをオーバーライドする必要が生じます。詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ カスタムの *\<Type\>*KeyFrame アニメーションを作成した後に、その型の *\<Type\>*AnimationUsingKeyFrames でこのアニメーションを使用できます。  
+  
+<a name="createacustomanimationtype"></a>   
+## カスタム アニメーション クラスの作成  
+ 独自の種類のアニメーションを作成すると、オブジェクトをアニメーション化する方法を制御しやすくなります。  独自の種類のアニメーションを作成するための 2 つの推奨方法として、<xref:System.Windows.Media.Animation.AnimationTimeline> クラスから派生する方法と、*\<Type\>*AnimationBase クラスから派生する方法があります。  *\<Type\>*Animation クラスまたは *\<Type\>*AnimationUsingKeyFrames クラスからの派生はお勧めしません。  
+  
+### \<Type\>AnimationBase からの派生  
+ *\<Type\>*AnimationBase クラスから派生する方法は、新しいアニメーションの種類を作成する最も簡単な方法です。  対応する *\<Type\>*AnimationBase クラスが既にある種類の新しいアニメーションを作成する場合は、この方法を使用します。  
+  
+ **実装手順**  
+  
+ *\<Type\>*Animation クラスから派生して、GetCurrentValueCore メソッドを実装します。  GetCurrentValueCore メソッドは、アニメーションの現在の値を返します。  このメソッドは、提示される開始値および終了値、およびアニメーションの進行状況を確認するために使用する <xref:System.Windows.Media.Animation.AnimationClock> の 3 つのパラメーターをとります。  
+  
+ *\<Type\>*AnimationBase クラスは <xref:System.Windows.Freezable> クラスを継承するため、<xref:System.Windows.Freezable.CreateInstanceCore%2A> コアをオーバーライドして、クラスの新しいインスタンスを返す必要もあります。  クラスがデータの格納に[依存関係プロパティ](GTMT)を使用していない場合や、作成後に追加の初期化を必要とする場合は、状況に応じて上記以外のメソッドをオーバーライドする必要が生じます。詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ 詳細については、アニメーション化する型の *\<Type\>*AnimationBase クラスの GetCurrentValueCore メソッドのドキュメントを参照してください。  例については、[カスタム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=159981)を参照してください。  
+  
+ **別の方法**  
+  
+ 単にアニメーション値を補間する方法を変更する場合は、*\<Type\>*KeyFrame クラスの 1 つから派生することをお勧めします。  作成したキー フレームは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が提供する、対応する *\<Type\>*AnimationUsingKeyFrames で使用できます。  
+  
+### AnimationTimeline からの派生  
+ 一致する [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーションを持っていない型に対してアニメーションを作成する場合や、厳密に型指定されていないアニメーションを作成する場合は、<xref:System.Windows.Media.Animation.AnimationTimeline> クラスから派生します。  
+  
+ **実装手順**  
+  
+ <xref:System.Windows.Media.Animation.AnimationTimeline> クラスから派生して、次のメンバーをオーバーライドします。  
+  
+-   <xref:System.Windows.Freezable.CreateInstanceCore%2A> – 新しいクラスが具象クラスである場合、<xref:System.Windows.Freezable.CreateInstanceCore%2A> をオーバーライドしてクラスの新しいインスタンスを返す必要があります。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline.GetCurrentValue%2A> – このメソッドをオーバーライドして、アニメーションの現在の値を返します。  このメソッドは、既定の開始値、既定の終了値、および <xref:System.Windows.Media.Animation.AnimationClock> の 3 つのパラメーターをとります。  <xref:System.Windows.Media.Animation.AnimationClock> を使用して、現在の時刻またはアニメーションの進行状況を取得します。  既定の開始値および終了値を使用するかどうかを選択できます。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline.IsDestinationDefault%2A> – このプロパティをオーバーライドして、<xref:System.Windows.Media.Animation.AnimationTimeline.GetCurrentValue%2A> メソッドで指定されている既定の終了値をアニメーションで使用するかどうかを示します。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline.TargetPropertyType%2A> – このプロパティをオーバーライドして、アニメーションが生成する出力値の <xref:System.Type> を示します。  
+  
+ クラスがデータの格納に[依存関係プロパティ](GTMT)を使用していない場合や、作成後に追加の初期化を必要とする場合は、状況に応じて上記以外のメソッドをオーバーライドする必要が生じます。詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ \([!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーションで使用される\) 推奨されるパラダイムは、次の 2 つの継承レベルを使用することです。  
+  
+1.  <xref:System.Windows.Media.Animation.AnimationTimeline> から派生した抽象 *\<Type\>*AnimationBase クラスを作成します。  このクラスは、<xref:System.Windows.Media.Animation.AnimationTimeline.TargetPropertyType%2A> メソッドをオーバーライドする必要があります。  また、新しい抽象メソッド GetCurrentValueCore を導入し、<xref:System.Windows.Media.Animation.AnimationTimeline.GetCurrentValue%2A> をオーバーライドして、既定の開始値パラメーターと既定の終了値パラメーターの型を検証してから、GetCurrentValueCore を呼び出す必要があります。  
+  
+2.  新しい *\<Type\>*AnimationBase クラスを継承する別のクラスを作成し、<xref:System.Windows.Freezable.CreateInstanceCore%2A> メソッド、導入した GetCurrentValueCore メソッド、および <xref:System.Windows.Media.Animation.AnimationTimeline.IsDestinationDefault%2A> プロパティをオーバーライドします。  
+  
+ **別の方法**  
+  
+ 対応する From\/To\/By アニメーションまたはキーフレーム アニメーションを持たない型をアニメーション化する場合は、<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> の使用をお勧めします。  <xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> は弱く型指定されているため、どの型の値でもアニメーション化できます。  この方法の欠点は、<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> が[離散補間](GTMT)のみをサポートするということです。  
+  
+<a name="useperframecallback"></a>   
+## フレームごとのコールバックの使用  
+ この方法は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーション システムを完全にバイパスする必要がある場合に使用します。  この方法の 1 つのシナリオは、アニメーションの各ステップで、オブジェクトの最後の一連のやり取りに基づいてアニメーション化されたオブジェクトの新しい方向や位置の再計算が必要になる物理アニメーションです。  
+  
+ **実装手順**  
+  
+ これまで説明してきた他の方法とは異なり、フレームごとのコールバックを使用する場合、カスタムのアニメーションやキー フレームのクラスを作成する必要はありません。  
+  
+ 代わりに、アニメーション化するオブジェクトを格納しているオブジェクトの <xref:System.Windows.Media.CompositionTarget.Rendering> イベントで登録します。  このイベント ハンドラー メソッドは、フレームごとに 1 回呼び出されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が[ビジュアル ツリー](GTMT)の永続化されたレンダリング データを構成ツリーにマーシャリングするたびに、イベント ハンドラー メソッドが呼び出されます。  
+  
+ イベント ハンドラーでは、アニメーション効果に必要なあらゆる計算を実行し、これらの値を使用してアニメーション化するオブジェクトのプロパティを設定します。  
+  
+ 現在のフレームの表現時間を取得するには、このイベントに関連付けられている <xref:System.EventArgs> を、<xref:System.Windows.Media.RenderingEventArgs> としてキャストできます。これにより、現在のフレームのレンダリング時間を取得するために使用できる <xref:System.Windows.Media.RenderingEventArgs.RenderingTime%2A> プロパティが提供されます。  
+  
+ 詳細については、<xref:System.Windows.Media.CompositionTarget.Rendering> のページを参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.AnimationTimeline>   
+ <xref:System.Windows.Media.Animation.IKeyFrame>   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [From\/To\/By アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [パス アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/path-animations-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)   
+ [カスタム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=159981)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md b/docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md
new file mode 100644
index 00000000000..14d599ba361
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md
@@ -0,0 +1,252 @@
+---
+title: "Drawing オブジェクトの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Drawing オブジェクト"
+  - "DrawingGroup オブジェクト"
+  - "描画, 描画の概要"
+  - "GeometryDrawing オブジェクト"
+  - "GlyphRunDrawing オブジェクト"
+  - "ImageDrawing オブジェクト"
+ms.assetid: 9b5ce5c0-e204-4320-a7a8-0b2210d62f88
+caps.latest.revision: 25
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# Drawing オブジェクトの概要
+ここでは、<xref:System.Windows.Media.Drawing> オブジェクトについて、およびこのオブジェクトを使用して図形、ビットマップ、テキスト、およびメディアを効率的に描画する方法について説明します。  クリップ アートを作成したり、<xref:System.Windows.Media.DrawingBrush> で塗りつぶしたり、<xref:System.Windows.Media.Visual> オブジェクトを使用したりする場合に、<xref:System.Windows.Media.Drawing> オブジェクトを使用します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="whatisadrawingsection"></a>   
+## 描画オブジェクトとは  
+ <xref:System.Windows.Media.Drawing> オブジェクトは、図形、ビットマップ、ビデオ、またはテキスト行などの表示されるコンテンツを記述します。  異なる種類の描画は、異なる種類のコンテンツを記述します。  描画オブジェクトのさまざまな種類を次の一覧に示します。  
+  
+-   <xref:System.Windows.Media.GeometryDrawing> – 図形を描画します。  
+  
+-   <xref:System.Windows.Media.ImageDrawing> – イメージを描画します。  
+  
+-   <xref:System.Windows.Media.GlyphRunDrawing> – テキストを描画します。  
+  
+-   <xref:System.Windows.Media.VideoDrawing> – オーディオまたはビデオ ファイルを再生します。  
+  
+-   <xref:System.Windows.Media.DrawingGroup> – その他の描画を描画します。  他の描画を 1 つの複合描画に結合するには、描画グループを使用します。  
+  
+ <xref:System.Windows.Media.Drawing> は汎用的なオブジェクトです。<xref:System.Windows.Media.Drawing> オブジェクトにはさまざまな使用方法があります。  
+  
+-   <xref:System.Windows.Media.DrawingImage> および <xref:System.Windows.Controls.Image> コントロールを使用することにより、イメージとして表示できます。  
+  
+-   <xref:System.Windows.Media.DrawingBrush> を使用して、<xref:System.Windows.Controls.Page> の <xref:System.Windows.Controls.Page.Background%2A> などのオブジェクトを塗りつぶすことができます。  
+  
+-   <xref:System.Windows.Media.DrawingVisual> の外観を記述するために使用できます。  
+  
+-   <xref:System.Windows.Media.Visual> のコンテンツを列挙するために使用できます。  
+  
+ WPF に用意されている他の種類のオブジェクトでも、図形、ビットマップ、テキスト、およびメディアを描画できます。  たとえば、<xref:System.Windows.Shapes.Shape> オブジェクトを使用して図形を描画することもできます。また、<xref:System.Windows.Controls.MediaElement> コントロールによってアプリケーションにビデオを追加する方法もあります。  それでは、どのような場合に <xref:System.Windows.Media.Drawing> オブジェクトを使用したらよいのでしょうか。  それは、パフォーマンス上の利点を得るためにフレームワーク レベルの機能を犠牲にしてもかまわない場合や、<xref:System.Windows.Freezable> 機能が必要な場合です。  <xref:System.Windows.Media.Drawing> オブジェクトは、[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)、入力、およびフォーカスをサポートしないため、背景やクリップ アートを表したり、<xref:System.Windows.Media.Visual> オブジェクトで低レベルの描画を行うのに適したパフォーマンスを実現できます。  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトは <xref:System.Windows.Freezable> 型のオブジェクトであるため、[リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)としての宣言、複数のオブジェクトでの共有、読み取り専用に設定することによるパフォーマンスの向上、複製、スレッド セーフの設定など、特殊な機能を備えています。  <xref:System.Windows.Freezable> オブジェクトのさまざまな機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+<a name="drawinggeometriessection"></a>   
+## 図形を描画する  
+ 図形を描画するには、<xref:System.Windows.Media.GeometryDrawing> を使用します。  ジオメトリ描画の <xref:System.Windows.Media.GeometryDrawing.Geometry%2A> プロパティは描画する図形を記述し、<xref:System.Windows.Media.GeometryDrawing.Brush%2A> プロパティは図形の内部の塗りつぶし方法を記述し、<xref:System.Windows.Media.GeometryDrawing.Pen%2A> プロパティは図形のアウトラインの描き方を記述します。  
+  
+ 次の例では、<xref:System.Windows.Media.GeometryDrawing> を使用して図形を描画します。  図形は、1 つの <xref:System.Windows.Media.GeometryGroup> と 2 つの <xref:System.Windows.Media.EllipseGeometry> オブジェクトによって示されます。  図形の内部は <xref:System.Windows.Media.LinearGradientBrush> で塗りつぶし、図形のアウトラインは <xref:System.Windows.Media.Brushes.Black%2A> <xref:System.Windows.Media.Pen> で描画します。  
+  
+ この例では次の <xref:System.Windows.Media.GeometryDrawing> を作成します。  
+  
+ ![2 つの楕円の GeometryDrawing](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-geodraw.png "graphicsmm\_geodraw")  
+GeometryDrawing  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GeometryDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/GeometryDrawingExample.cs#geometrydrawingexampleinline)]
+ [!code-xml[DrawingMiscSnippets_snip#GeometryDrawingExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/GeometryDrawingExample.xaml#geometrydrawingexampleinline)]  
+  
+ コード例全体については、「[GeometryDrawing を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-geometrydrawing.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.PathGeometry> など、その他の <xref:System.Windows.Media.Geometry> クラスを使用すると、曲線や円弧を作成することによってさらに複雑な図形を作成できます。  <xref:System.Windows.Media.Geometry> オブジェクトの詳細については、「[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトを使用しない図形を描画するための他の方法については、「[WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)」を参照してください。  
+  
+<a name="drawingimagessection"></a>   
+## イメージを描画する  
+ イメージを描画するには、<xref:System.Windows.Media.ImageDrawing> を使用できます。  <xref:System.Windows.Media.ImageDrawing> オブジェクトの <xref:System.Windows.Media.ImageDrawing.ImageSource%2A> プロパティは描画するイメージを記述し、<xref:System.Windows.Media.ImageDrawing.Rect%2A> プロパティはイメージが描画される領域を定義します。  
+  
+ 次の例では、\(75,75\) にある 100 x 100 [ピクセル](GTMT)の四角形の中に、イメージを描画します。  この例で作成した <xref:System.Windows.Media.ImageDrawing> を次の図に示します。  <xref:System.Windows.Media.ImageDrawing> の境界を表すために灰色の境界線を追加しています。  
+  
+ ![&#40;75,75&#41; に描画される 100×100 の ImageDrawing](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-simple-imagedrawing-offset.png "graphicsmm\_simple\_imagedrawing\_offset")  
+100 x 100 の ImageDrawing  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#ImageDrawing100by100Inline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/ImageDrawingExample.cs#imagedrawing100by100inline)]
+ [!code-xml[DrawingMiscSnippets_snip#ImageDrawing100by100Inline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/ImageDrawingExample.xaml#imagedrawing100by100inline)]  
+  
+ イメージの詳細については、「[イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)」を参照してください。  
+  
+<a name="playmedia"></a>   
+## メディアを再生する \(コードのみ\)  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.VideoDrawing> を [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で宣言することはできますが、コードを使用した場合のみそのメディアを読み込んで再生することができます。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でビデオを再生するには、<xref:System.Windows.Controls.MediaElement> を使用します。  
+  
+ オーディオ ファイルまたはビデオ ファイルを再生するには、<xref:System.Windows.Media.VideoDrawing> と <xref:System.Windows.Media.MediaPlayer> を使用します。  メディアを読み込んで再生するには、2 つの方法があります。  1 つ目の方法は、<xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> を単独で使用するもので、2 つ目の方法は、独自の <xref:System.Windows.Media.MediaTimeline> を作成して <xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> と共に使用するものです。  
+  
+> [!NOTE]
+>  アプリケーションでメディアを配布する場合は、メディア ファイルをイメージと同じようにプロジェクト リソースとして使用することはできません。  代わりにプロジェクト ファイルでメディアの種類を `Content` に設定し、`CopyToOutputDirectory` を `PreserveNewest` または `Always` に設定する必要があります。  
+  
+ 独自の <xref:System.Windows.Media.MediaTimeline> を作成せずにメディアを再生するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Media.MediaPlayer> オブジェクトを作成します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline1)]  
+  
+2.  メディア ファイルを読み込むには、<xref:System.Windows.Media.MediaPlayer.Open%2A> メソッドを使用します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline2)]  
+  
+3.  <xref:System.Windows.Media.VideoDrawing> を作成します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline3)]  
+  
+4.  <xref:System.Windows.Media.VideoDrawing> の <xref:System.Windows.Media.VideoDrawing.Rect%2A> プロパティを設定して、メディアを描画するサイズと場所を指定します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline4)]  
+  
+5.  作成した <xref:System.Windows.Media.MediaPlayer> で、<xref:System.Windows.Media.VideoDrawing> の <xref:System.Windows.Media.VideoDrawing.Player%2A> プロパティを設定します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline5)]  
+  
+6.  <xref:System.Windows.Media.MediaPlayer> の <xref:System.Windows.Media.MediaPlayer.Play%2A> メソッドを使用して、メディアの再生を開始します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline6](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline6)]  
+  
+ <xref:System.Windows.Media.VideoDrawing> および <xref:System.Windows.Media.MediaPlayer> を使用してビデオ ファイルを 1 回再生する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline)]  
+  
+ メディアのタイミングをさらに細かく制御するには、<xref:System.Windows.Media.MediaPlayer> オブジェクトおよび <xref:System.Windows.Media.VideoDrawing> オブジェクトと共に <xref:System.Windows.Media.MediaTimeline> を使用します。  <xref:System.Windows.Media.MediaTimeline> を使用すると、ビデオを繰り返すかどうかを指定できます。  <xref:System.Windows.Media.VideoDrawing> と共に <xref:System.Windows.Media.MediaTimeline> を使用するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Media.MediaTimeline> を宣言し、そのタイミング動作を設定します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline1)]  
+  
+2.  <xref:System.Windows.Media.MediaTimeline> から <xref:System.Windows.Media.MediaClock> を作成します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline2)]  
+  
+3.  <xref:System.Windows.Media.MediaPlayer> を作成し、<xref:System.Windows.Media.MediaClock> を使用してその <xref:System.Windows.Media.MediaPlayer.Clock%2A> プロパティを設定します。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline3)]  
+  
+4.  <xref:System.Windows.Media.VideoDrawing> を作成し、<xref:System.Windows.Media.MediaPlayer> を <xref:System.Windows.Media.VideoDrawing> の <xref:System.Windows.Media.VideoDrawing.Player%2A> プロパティに割り当てます。  
+  
+     [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline4)]  
+  
+ <xref:System.Windows.Media.MediaTimeline> を <xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> と共に使用してビデオを繰り返し再生する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline)]  
+  
+ <xref:System.Windows.Media.MediaTimeline> を使用するときは、<xref:System.Windows.Media.MediaPlayer> の対話型メソッドを使用するのではなく、<xref:System.Windows.Media.MediaClock> の <xref:System.Windows.Media.Animation.Clock.Controller%2A> プロパティから返される対話型の <xref:System.Windows.Media.Animation.ClockController> を使用してメディアの再生を制御することに注意してください。  
+  
+<a name="drawtext"></a>   
+## テキストを描画する  
+ テキストを描画するには、<xref:System.Windows.Media.GlyphRunDrawing> と <xref:System.Windows.Media.GlyphRun> を使用します。  次の例では、<xref:System.Windows.Media.GlyphRunDrawing> を使用して "Hello World" というテキストを描画しています。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GlyphRunDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/GlyphRunDrawingExample.cs#glyphrundrawingexampleinline)]
+ [!code-xml[DrawingMiscSnippets_snip#GlyphRunDrawingExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/GlyphRunExample.xaml#glyphrundrawingexampleinline)]  
+  
+ <xref:System.Windows.Media.GlyphRun> は、固定形式のドキュメントの表示および印刷シナリオでの使用を意図した、低レベルのオブジェクトです。  画面にテキストを描画するには、<xref:System.Windows.Controls.Label> または <xref:System.Windows.Controls.TextBlock> を使用する方が簡単です。  <xref:System.Windows.Media.GlyphRun> の詳細については、「[GlyphRun オブジェクトと Glyphs 要素の概要](../../../../docs/framework/wpf/advanced/introduction-to-the-glyphrun-object-and-glyphs-element.md)」の概要を参照してください。  
+  
+<a name="compositedrawingssection"></a>   
+## 複合描画  
+ <xref:System.Windows.Media.DrawingGroup> を使用すると、複数の描画を 1 つの複合描画に結合できます。  <xref:System.Windows.Media.DrawingGroup> を使用すると、複数の図形、イメージ、およびテキストを、1 つの <xref:System.Windows.Media.Drawing> オブジェクトに結合できます。  
+  
+ <xref:System.Windows.Media.DrawingGroup> を使用して、2 つの <xref:System.Windows.Media.GeometryDrawing> オブジェクトと 1 つの <xref:System.Windows.Media.ImageDrawing> オブジェクトを結合する例を次に示します。  この例を実行すると、次の出力が生成されます。  
+  
+ ![複数の描画を含む DrawingGroup](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-simple.png "graphicsmm\_simple")  
+複合描画  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMSimpleDrawingGroupExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingGroupExample.cs#graphicsmmsimpledrawinggroupexample)]
+ [!code-xml[DrawingMiscSnippets_snip#GraphicsMMSimpleDrawingGroupExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingGroupExample.xaml#graphicsmmsimpledrawinggroupexample)]  
+  
+ また、<xref:System.Windows.Media.DrawingGroup> を使用すると、不透明マスク、変換、ビットマップ効果などの操作もコンテンツに適用できます。  <xref:System.Windows.Media.DrawingGroup> 操作は、<xref:System.Windows.Media.DrawingGroup.OpacityMask%2A>、<xref:System.Windows.Media.DrawingGroup.Opacity%2A>、<xref:System.Windows.Media.DrawingGroup.BitmapEffect%2A>、<xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>、<xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A>、そして <xref:System.Windows.Media.DrawingGroup.Transform%2A> の順に が適用されます。  
+  
+ <xref:System.Windows.Media.DrawingGroup> 操作が適用される順序を次の図に示します。  
+  
+ ![操作の DrawingGroup 順序](../../../../docs/framework/wpf/graphics-multimedia/media/graphcismm-drawinggroup-order.png "graphcismm\_drawinggroup\_order")  
+DrawingGroup 操作の順序  
+  
+ <xref:System.Windows.Media.DrawingGroup> オブジェクトのコンテンツの操作に使用できるプロパティを次の表に示します。  
+  
+|プロパティ|Description|図|  
+|-----------|-----------------|-------|  
+|<xref:System.Windows.Media.DrawingGroup.OpacityMask%2A>|<xref:System.Windows.Media.DrawingGroup> コンテンツの選択した部分の不透明度を変更します。  例については、「[How to: Control the Opacity of a Drawing](http://msdn.microsoft.com/ja-jp/68580652-7d32-4d27-93cc-a5148cf4d5ee)」を参照してください。||  
+|<xref:System.Windows.Media.DrawingGroup.Opacity%2A>|<xref:System.Windows.Media.DrawingGroup> コンテンツの不透明度を一様に変更します。  <xref:System.Windows.Media.Drawing> を透明または部分的に透明にするには、このプロパティを使用します。  例については、「[How to: Apply an Opacity Mask to a Drawing](http://msdn.microsoft.com/ja-jp/d77b420b-9be2-479c-a45e-82f4da30eb9f)」を参照してください。||  
+|<xref:System.Windows.Media.DrawingGroup.BitmapEffect%2A>|<xref:System.Windows.Media.Effects.BitmapEffect> を <xref:System.Windows.Media.DrawingGroup> コンテンツに適用します。  例については、「[How to: Apply a BitmapEffect to a Drawing](http://msdn.microsoft.com/ja-jp/c5b1de83-8d09-47fb-96db-5f174471f4b5)」を参照してください。||  
+|<xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>|<xref:System.Windows.Media.DrawingGroup> コンテンツを、<xref:System.Windows.Media.Geometry> で記述する領域に対してクリップします。  例については、「[How to: Clip a Drawing](http://msdn.microsoft.com/ja-jp/1f7d8a2c-c3c2-42cb-a542-e6796f9fb058)」を参照してください。||  
+|<xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A>|[デバイス非依存ピクセル](GTMT)を、指定したガイドラインに沿ったデバイス ピクセルにスナップします。  このプロパティは、DPI の低いディスプレイ上で、精緻なグラフィックスをはっきりとレンダリングするために役立ちます。  例については、「[描画に GuidelineSet を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-a-guidelineset-to-a-drawing.md)」を参照してください。||  
+|<xref:System.Windows.Media.DrawingGroup.Transform%2A>|<xref:System.Windows.Media.DrawingGroup> コンテンツを変換します。  例については、「[How to: Apply a Transform to a Drawing](http://msdn.microsoft.com/ja-jp/0d525f2b-682d-4d67-9660-cf46929fbabd)」を参照してください。||  
+  
+<a name="usingimagedrawing"></a>   
+## 描画をイメージとして表示する  
+ <xref:System.Windows.Controls.Image> コントロールを使用して <xref:System.Windows.Media.Drawing> を表示するには、<xref:System.Windows.Media.DrawingImage> を <xref:System.Windows.Controls.Image> コントロールの <xref:System.Windows.Controls.Image.Source%2A> として使用し、<xref:System.Windows.Media.DrawingImage> オブジェクトの <xref:System.Windows.Media.DrawingImage.Drawing%2A?displayProperty=fullName> プロパティを表示する描画に設定します。  
+  
+ <xref:System.Windows.Media.DrawingImage> および <xref:System.Windows.Controls.Image> コントロールを使用して、<xref:System.Windows.Media.GeometryDrawing> を表示する例を次に示します。  この例を実行すると、次の出力が生成されます。  
+  
+ ![2 つの楕円の GeometryDrawing](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-geodraw.png "graphicsmm\_geodraw")  
+DrawingImage  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#DrawingImageExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingImageExample.cs#drawingimageexamplewholepage)]
+ [!code-xml[DrawingMiscSnippets_snip#DrawingImageExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingImageExample.xaml#drawingimageexamplewholepage)]  
+  
+<a name="renderingwithdrawingbrushsection"></a>   
+## 描画を使用してオブジェクトを塗りつぶす  
+ <xref:System.Windows.Media.DrawingBrush> は、描画オブジェクトで領域を塗りつぶすブラシです。  これを使用すると、ほとんどすべてのグラフィカル オブジェクトを描画で塗りつぶすことができます。  <xref:System.Windows.Media.DrawingBrush> の <xref:System.Windows.Media.Drawing> プロパティは、その <xref:System.Windows.Media.DrawingBrush.Drawing%2A> を記述します。  <xref:System.Windows.Media.DrawingBrush> で <xref:System.Windows.Media.Drawing> をレンダリングするには、ブラシの <xref:System.Windows.Media.Drawing> プロパティを使用してブラシに追加してから、ブラシを使用してコントロールやパネルなどのグラフィカル オブジェクトを塗りつぶします。  
+  
+ <xref:System.Windows.Media.DrawingBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を <xref:System.Windows.Media.GeometryDrawing> から作成したパターンで塗りつぶす例を次に示します。  この例を実行すると、次の出力が生成されます。  
+  
+ ![並べて表示される DrawingBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawingbrush-geometrydrawing.png "graphicsmm\_drawingbrush\_geometrydrawing")  
+DrawingBrush と共に使用された GeometryDrawing  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#DrawingBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingBrushExample.cs#drawingbrushexamplewholepage)]
+ [!code-xml[DrawingMiscSnippets_snip#DrawingBrushExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingBrushExample.xaml#drawingbrushexamplewholepage)]  
+  
+ <xref:System.Windows.Media.DrawingBrush> クラスには、コンテンツを伸縮したり並べて表示するさまざまなオプションが用意されています。  <xref:System.Windows.Media.DrawingBrush> の詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」の概要を参照してください。  
+  
+<a name="renderingwithvisualsection"></a>   
+## ビジュアルを使用した描画のレンダリング  
+ <xref:System.Windows.Media.DrawingVisual> は、描画をレンダリングするよう設計されたビジュアル オブジェクトです。  ビジュアル層で直接作業する方法は、高度にカスタマイズされたグラフィカル環境を構築する開発者向けのオプションであり、この概要では説明しません。  詳細については、「[DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)」の概要を参照してください。  
+  
+<a name="drawingcontextobjects"></a>   
+## DrawingContext オブジェクト  
+ <xref:System.Windows.Media.DrawingContext> クラスを使用すると、<xref:System.Windows.Media.Visual> または <xref:System.Windows.Media.Drawing> にビジュアル コンテンツを読み込むことができます。  <xref:System.Windows.Media.DrawingContext> ではグラフィカル コンテンツが効率的に記述されるため、比較的低レベルのグラフィックス オブジェクトの多くで使用されます。  
+  
+ <xref:System.Windows.Media.DrawingContext> 描画メソッドは <xref:System.Drawing.Graphics?displayProperty=fullName> 型の描画メソッドに似ていますが、機能はまったく異なります。  <xref:System.Windows.Media.DrawingContext> は保持モードのグラフィックス システムで使用され、<xref:System.Drawing.Graphics?displayProperty=fullName> 型は即時モードのグラフィックス システムで使用されます。  <xref:System.Windows.Media.DrawingContext> オブジェクトの描画コマンドを使用すると、リアルタイムで画面に描画するのではなく、実際にはグラフィック システムで今後使用する一連の描画命令が格納されます \(正確なストレージ機構は、<xref:System.Windows.Media.DrawingContext> を提供するオブジェクトの型によって異なります\)。  [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] グラフィックス システムの動作原理の詳細については、「[WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.DrawingContext> を直接インスタンス化することはできませんが、<xref:System.Windows.Media.DrawingGroup.Open%2A?displayProperty=fullName> や <xref:System.Windows.Media.DrawingVisual.RenderOpen%2A?displayProperty=fullName> などの一部のメソッドから描画コンテキストを取得できます。  
+  
+<a name="enumeratevisualcontents"></a>   
+## ビジュアルのコンテンツを列挙する  
+ <xref:System.Windows.Media.Drawing> オブジェクトは、他の用途に加えて、<xref:System.Windows.Media.Visual> のコンテンツを列挙するためのオブジェクト モデルも提供します。  
+  
+ <xref:System.Windows.Media.VisualTreeHelper.GetDrawing%2A> メソッドを使用して、<xref:System.Windows.Media.Visual> の <xref:System.Windows.Media.DrawingGroup> 値を取得し列挙する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMRetrieveDrawings](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/EnumerateDrawingsExample.xaml.cs#graphicsmmretrievedrawings)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Drawing>   
+ <xref:System.Windows.Media.DrawingGroup>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/drawings-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/drawings-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/drawings-how-to-topics.md
new file mode 100644
index 00000000000..3d06b2d112c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/drawings-how-to-topics.md
@@ -0,0 +1,43 @@
+---
+title: "描画に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Drawing オブジェクト"
+  - "DrawingGroup オブジェクト"
+  - "描画, 方法トピック"
+  - "GeometryDrawing オブジェクト"
+  - "GlyphRunDrawing オブジェクト"
+  - "ImageDrawing オブジェクト"
+ms.assetid: 5f445633-529c-4091-8a2c-13035ac8c41b
+caps.latest.revision: 75
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 75
+---
+# 描画に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Media.Drawing> オブジェクトを使用して、図形、イメージ、またはテキストを描画する方法について説明します。  
+  
+## このセクションの内容  
+ [描画に GuidelineSet を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-a-guidelineset-to-a-drawing.md)  
+ [複合描画を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-drawing.md)  
+ [GeometryDrawing を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-geometrydrawing.md)  
+ [ImageDrawing を使用してイメージを描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-an-image-using-imagedrawing.md)  
+ [VideoDrawing を使用してメディアを再生する](../../../../docs/framework/wpf/graphics-multimedia/how-to-play-media-using-a-videodrawing.md)  
+ [描画をイメージ ソースとして使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-drawing-as-an-image-source.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Drawing>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/drawings.md b/docs/framework/wpf/graphics-multimedia/drawings.md
new file mode 100644
index 00000000000..8b65560d7c7
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/drawings.md
@@ -0,0 +1,42 @@
+---
+title: "描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "描画 [WPF]"
+  - "Drawing オブジェクト"
+  - "DrawingGroup オブジェクト"
+  - "描画"
+  - "GeometryDrawing オブジェクト"
+  - "GlyphRunDrawing オブジェクト"
+  - "グラフィックス [WPF], 描画"
+  - "ImageDrawing オブジェクト"
+ms.assetid: 6ab1fe6b-3eed-4432-a248-b487e7234e5b
+caps.latest.revision: 53
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 53
+---
+# 描画
+<xref:System.Windows.Media.Drawing> オブジェクトを使用して、効率的に、図形、イメージ、またはテキストを描画します。  描画は、<xref:System.Windows.Media.DrawingBrush> による塗りつぶし、または <xref:System.Windows.Media.Visual> オブジェクトによるプログラミングで使用します。  
+  
+## このセクションの内容  
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/drawings-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Drawing>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/easing-functions.md b/docs/framework/wpf/graphics-multimedia/easing-functions.md
new file mode 100644
index 00000000000..b04a6f99c67
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/easing-functions.md
@@ -0,0 +1,135 @@
+---
+title: "イージング関数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "適用 (数式をアニメーションに) [WPF]"
+  - "適用 (イージング関数をアニメーションに) [WPF]"
+  - "アニメーションに適用する数学的数式 [WPF]"
+  - "リアルな動きのアニメーション [WPF]"
+  - "イージング関数 [WPF]"
+  - "カスタマイズ (イージング関数を) [WPF]"
+  - "定義であるイージング関数 [WPF]"
+  - "カスタマイズのイージング関数 [WPF]"
+  - "適用するアニメーション [WPF]"
+ms.assetid: 075b9c2b-82c4-43fa-b3cd-de0b6236eb38
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# イージング関数
+イージング関数を使用すると、独自の数式をアニメーションに適用することができます。 たとえば、現実的にバウンスまたは、春のと同様に動作するオブジェクトもかまいません。 またはを使用してキー フレーム アニメーションによって/でもこれらの効果を概算するが、大量の作業がかかり、アニメーション公式を使用するよりも正確さに欠けます。  
+  
+ 継承することで、独自のカスタムのイージング関数を作成するだけでなく<xref:System.Windows.Media.Animation.EasingFunctionBase>、ランタイムによって提供される複数のイージング関数のいずれかを使用して、一般的な効果を作成することができます。  
+  
+-   <xref:System.Windows.Media.Animation.BackEase>: 指定したパスのアニメーション化を開始する前に、少しアニメーションの動きが取り消されます。  
+  
+-   <xref:System.Windows.Media.Animation.BounceEase>: 跳ね返り効果を作成します。  
+  
+-   <xref:System.Windows.Media.Animation.CircleEase>: 加速または減速循環関数を使用してアニメーションを作成します。  
+  
+-   <xref:System.Windows.Media.Animation.CubicEase>: 加速または減速の公式を使用するアニメーションを作成*f*( *t*) = *t*<sup>3</sup>します。  
+  
+-   <xref:System.Windows.Media.Animation.ElasticEase>: 伸び縮みするまで春のようなアニメーションを作成します。  
+  
+-   <xref:System.Windows.Media.Animation.ExponentialEase>: 加速または減速指数の式を使用してアニメーションを作成します。  
+  
+-   <xref:System.Windows.Media.Animation.PowerEase>: 加速または減速の公式を使用するアニメーションを作成*f*( *t*) = *t*<sup>p</sup> p に等しい、<xref:System.Windows.Media.Animation.PowerEase.Power%2A>プロパティです。  
+  
+-   <xref:System.Windows.Media.Animation.QuadraticEase>: 加速または減速の公式を使用するアニメーションを作成*f*( *t*) = *t*<sup>2</sup>します。  
+  
+-   <xref:System.Windows.Media.Animation.QuarticEase>: 加速または減速の公式を使用するアニメーションを作成*f*( *t*) = *t*<sup>4</sup>します。  
+  
+-   <xref:System.Windows.Media.Animation.QuinticEase>: アニメーションを加速または減速式を使用して作成*f*( *t*) = *t*<sup>5</sup>します。  
+  
+-   <xref:System.Windows.Media.Animation.SineEase>: 加速または減速サイン (正弦) 式を使用してアニメーションを作成します。  
+  
+ 次の例を使ってイージング関数の動作を調べることができます。  
+  
+ [このサンプルを実行します。](http://go.microsoft.com/fwlink/?LinkId=139798&sref=easing_functions_gallery)  
+  
+ イージング関数をアニメーションに適用するには、使用、`EasingFunction`アニメーションのプロパティがアニメーションに適用するイージング関数を指定します。 次の例では、適用、 <xref:System.Windows.Media.Animation.BounceEase>イージング関数を<xref:System.Windows.Media.Animation.DoubleAnimation>跳ね返り効果を作成します。  
+  
+ [このサンプルを実行します。](http://go.microsoft.com/fwlink/?LinkId=139798&sref=BounceEase)  
+  
+ [!code-xml[BounceEase_snippet#BounceEase](../../../../samples/snippets/csharp/VS_Snippets_Wpf/bounceease_snippet/CS/window1.xaml#bounceease)]  
+  
+ 前の例では、イージング関数を From/に/によって適用したアニメーションです。 キー フレーム アニメーションにこれらのイージング関数を適用することもできます。 次の例では、コントラクトから上位に向かって停止、速度が低下し、下方向 (よう減少) を展開し、停止し、上で移動する四角形のアニメーションを作成するイージングそれらに関連付けられている関数をキー フレームを使用する方法を示します。  
+  
+ [このサンプルを実行します。](http://go.microsoft.com/fwlink/?LinkId=139798&sref=EasingFunctionDoubleKeyFrame)  
+  
+ [!code-xml[EasingFunctionDoubleKeyFrame_snippet#EasingFunctionDoubleKeyFrame](../../../../samples/snippets/csharp/VS_Snippets_Wpf/easingfunctiondoublekeyframe_snippet/CS/window1.xaml#easingfunctiondoublekeyframe)]  
+  
+ 使用することができます、 <xref:System.Windows.Media.Animation.EasingFunctionBase.EasingMode%2A>イージング関数の動作について、つまりを変更するプロパティを変更するアニメーションの補間します。 渡すことができる&3; つの値がある<xref:System.Windows.Media.Animation.EasingFunctionBase.EasingMode%2A>:  
+  
+-   <xref:System.Windows.Media.Animation.EasingMode>: に従ってイージング関数に関連付けられている数式を補間します。  
+  
+-   <xref:System.Windows.Media.Animation.EasingMode>: に従ってイージング関数に関連付けられている計算式の出力結果を差し引き、100% の補間を補間します。  
+  
+-   <xref:System.Windows.Media.Animation.EasingMode>: 補間を使用して<xref:System.Windows.Media.Animation.EasingMode>アニメーションの最初の半分についておよび<xref:System.Windows.Media.Animation.EasingMode>後半のです。  
+  
+ 次のグラフのそれぞれの値を示す<xref:System.Windows.Media.Animation.EasingFunctionBase.EasingMode%2A> 、 *f*( *x*) アニメーションの進行状況を表すと*t*時間を表します。  
+  
+ <xref:System.Windows.Media.Animation.BackEase>  
+  
+ ![BackEase EasingMode のグラフ。] (../Image/BackEase_Graph.png "BackEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.BounceEase>  
+  
+ ![BounceEase EasingMode のグラフ] (../Image/BounceEase_Graph.png "BounceEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.CircleEase>  
+  
+ ![CircleEase EasingMode のグラフ] (../Image/CircleEase_Graph.png "CircleEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.CubicEase>  
+  
+ ![CubicEase EasingMode のグラフ] (../Image/CubicEase_Graph.png "CubicEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.ElasticEase>  
+  
+ ![ElasticEase の異なる easingmode のグラフ] (../Image/ElasticEase_Graph.png "ElasticEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.ExponentialEase>  
+  
+ ![異なる easingmode の ExponentialEase のグラフ。] (../Image/ExponentialEase_Graph.png "ExponentialEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.PowerEase>  
+  
+ ![異なる easingmode のグラフ QuarticEase] (../Image/QuarticEase_Graph.png "QuarticEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.QuadraticEase>  
+  
+ ![異なる easingmode のグラフの QuadraticEase](../../../../docs/framework/wpf/graphics-multimedia/media/quadraticease-graph.png "QuadraticEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.QuarticEase>  
+  
+ ![異なる easingmode のグラフ QuarticEase] (../Image/QuarticEase_Graph.png "QuarticEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.QuinticEase>  
+  
+ ![異なる easingmode のグラフ QuinticEase] (../Image/QuinticEase_Graph.png "QuinticEase_Graph")  
+  
+ <xref:System.Windows.Media.Animation.SineEase>  
+  
+ ![異なる EasingMode 値の SineEase](../../../../docs/framework/wpf/graphics-multimedia/media/sineease-graph.png "SineEase_Graph")  
+  
+> [!NOTE]
+>  使用することができます<xref:System.Windows.Media.Animation.PowerEase>と同じ動作を作成する<xref:System.Windows.Media.Animation.CubicEase>、 <xref:System.Windows.Media.Animation.QuadraticEase>、 <xref:System.Windows.Media.Animation.QuarticEase>、および<xref:System.Windows.Media.Animation.QuinticEase>を使用して、<xref:System.Windows.Media.Animation.PowerEase.Power%2A>プロパティです。 例では、使用する場合の<xref:System.Windows.Media.Animation.PowerEase>の代わりに<xref:System.Windows.Media.Animation.CubicEase>、指定、<xref:System.Windows.Media.Animation.PowerEase.Power%2A>3 の値。  
+  
+ 継承することで、独自のイージング関数を作成する実行時に含まれるイージング関数を使用するだけでなく<xref:System.Windows.Media.Animation.EasingFunctionBase>します。 次の例では、単純なカスタム イージング関数を作成する方法を示します。 イージング関数の動作をオーバーライドすることで、独自の数値演算ロジックを追加する、 <xref:System.Windows.Media.Animation.EasingFunctionBase.EaseInCore%2A>メソッドです。  
+  
+ [このサンプルを実行します。](http://go.microsoft.com/fwlink/?LinkId=139798&sref=CustomEasingFunction)  
+  
+ [!code-csharp[CustomEasingFunction#CustomEasingFunction](../../../../samples/snippets/csharp/VS_Snippets_Wpf/customeasingfunction/csharp/customlog10easingfunction.cs#customeasingfunction)]
+ [!code-vb[CustomEasingFunction#CustomEasingFunction](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/customeasingfunction/visualbasic/customlog10easingfunction.vb#customeasingfunction)]
+ [!code-xml[CustomEasingFunction#CustomEasingFunction](../../../../samples/snippets/csharp/VS_Snippets_Wpf/customeasingfunction/csharp/window1.xaml#customeasingfunction)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/extend-glass-frame-into-a-wpf-application.md b/docs/framework/wpf/graphics-multimedia/extend-glass-frame-into-a-wpf-application.md
new file mode 100644
index 00000000000..40f68d4c4b1
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/extend-glass-frame-into-a-wpf-application.md
@@ -0,0 +1,62 @@
+---
+title: "WPF アプリケーションへのグラス フレームの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション, 拡張 (グラス フレームを)"
+  - "拡張 (アプリケーションにグラス フレームを)"
+  - "グラス フレーム, 拡張 (アプリケーションに)"
+  - "グラフィックス, 拡張 (アプリケーションにグラス フレームを)"
+ms.assetid: 74388a3a-4b69-4a9d-ba1f-e107636bd660
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# WPF アプリケーションへのグラス フレームの拡張
+ここでは、[!INCLUDE[TLA#tla_winvista](../../../../includes/tlasharptla-winvista-md.md)] のグラス フレームを [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションのクライアント領域に拡張する方法について説明します。  
+  
+> [!NOTE]
+>  この例は、グラス対応の Desktop Window Manager \(DWM\) を実行している [!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)] コンピューターでのみ機能します。  [!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)] Home Basic は、透明なグラス効果をサポートしていません。  その他の [!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)] で通常は透明なグラス効果でレンダリングされる領域は、不透明にレンダリングされます。  
+  
+## 使用例  
+ Internet Explorer 7 のアドレス バーに拡張されたグラス フレームを次の図に示します。  
+  
+ **アドレス バーの背後にグラス フレームが拡張された Internet Explorer**  
+  
+ ![アドレス バーの背後にグラス フレームが拡張された IE7。](../../../../docs/framework/wpf/graphics-multimedia/media/ie7glasstopbar.PNG "IE7glasstopbar")  
+  
+ グラス フレームを [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションで拡張するには、アンマネージ [!INCLUDE[TLA#tla_api](../../../../includes/tlasharptla-api-md.md)] へのアクセスが必要です。  フレームをクライアント領域に拡張するために必要な 2 つの [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] に対してプラットフォーム呼び出し \(pinvoke\) を実行する方法を次のコード例に示します。  これらの [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] は、それぞれ **NonClientRegionAPI** と呼ばれるクラスで宣言されます。  
+  
+<!-- TODO: review snippet reference  [!CODE [AvalonClientGlass#DWMExtendFramePInvokeAPI](AvalonClientGlass#DWMExtendFramePInvokeAPI)]  -->  
+  
+ [DwmExtendFrameIntoClientArea](_udwm_dwmextendframeintoclientarea) [](_udwm_dwmextendframeintoclientarea) は、フレームをクライアント領域に拡張する DWM 関数です。  この関数では、ウィンドウ ハンドルと [MARGINS](inet_MARGINS) 構造体という、2 つのパラメーターを使用します。  [MARGINS](inet_MARGINS) は、フレームをクライアント領域に拡張する追加量を DWM に指示するために使用されます。  
+  
+## 使用例  
+ [DwmExtendFrameIntoClientArea](_udwm_dwmextendframeintoclientarea) 関数を使用するには、ウィンドウ ハンドルを取得する必要があります。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、ウィンドウ ハンドルは <xref:System.Windows.Interop.HwndSource> の <xref:System.Windows.Interop.HwndSource.Handle%2A> プロパティから取得できます。  次の例では、ウィンドウの <xref:System.Windows.FrameworkElement.Loaded> イベントでフレームがクライアント領域に拡張されます。  
+  
+<!-- TODO: review snippet reference  [!CODE [AvalonClientGlass#AvalonGlassOnLoadedCSharp](AvalonClientGlass#AvalonGlassOnLoadedCSharp)]  -->  
+  
+## 使用例  
+ フレームがクライアント領域に拡張される簡単なウィンドウを次の例に示します。  フレームは、2 つの <xref:System.Windows.Controls.TextBox> オブジェクトを含む一番上の境界の背後に拡張されます。  
+  
+<!-- TODO: review snippet reference  [!CODE [AvalonClientGlass#AvalonGlassFullWindowXAML](AvalonClientGlass#AvalonGlassFullWindowXAML)]  -->  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションに拡張されたグラス フレームを次の図に示します。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)]  **アプリケーション** に**拡張されたグラス フレーム**。  
+  
+ ![WPF アプリケーションに拡張されたグラス フレーム。](../../../../docs/framework/wpf/graphics-multimedia/media/wpfextendedglassintoclient.png "WPFextendedGlassIntoClient")  
+  
+## 参照  
+ [Desktop Window Manager Overview](_udwm_overview)   
+ [Desktop Window Manager Blur Overview](_udwm_blur_ovw)   
+ [DwmExtendFrameIntoClientArea](_udwm_dwmextendframeintoclientarea)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md b/docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md
new file mode 100644
index 00000000000..b14aca7bf97
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md
@@ -0,0 +1,158 @@
+---
+title: "From/To/By アニメーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, From/To/By"
+  - "From/To/By アニメーション"
+ms.assetid: 516fce0a-e7f8-49b8-b018-53b3d409a8a3
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# From/To/By アニメーションの概要
+ここでは、From\/To\/By アニメーションを使用して[依存関係プロパティ](GTMT)をアニメーション化する方法について説明します。  From\/To\/By アニメーションでは、2 つの値の間の遷移が作成されます。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prereq"></a>   
+## 必要条件  
+ このトピックを理解するには、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のアニメーション機能に精通している必要があります。  アニメーション機能の概要については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+<a name="whatisanimation"></a>   
+## From\/To\/By アニメーションとは  
+ From\/To\/By アニメーションは、開始値と終了値の間の遷移を作成する <xref:System.Windows.Media.Animation.AnimationTimeline> の一種です。  遷移の完了に要する時間は、そのアニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> によって決まります。  
+  
+ マークアップとコードで <xref:System.Windows.Media.Animation.Storyboard> を使用することにより、またはコードで <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用することで、From\/To\/By アニメーションをプロパティに適用できます。  また、From\/To\/By アニメーションを使用して <xref:System.Windows.Media.Animation.AnimationClock> を作成し、1 つ以上のプロパティに適用することもできます。  アニメーションを適用するさまざまな方法の詳細については、「[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)」を参照してください。  
+  
+ From\/To\/By アニメーションで指定できるターゲット値は 2 つまでです。  3 つ以上のターゲット値を持つアニメーションが必要な場合は、キー フレーム アニメーションを使用してください。  キー フレーム アニメーションについては、「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」を参照してください。  
+  
+<a name="animation_types"></a>   
+## From\/To\/By アニメーションの種類  
+ アニメーションによってプロパティ値が生成されるため、さまざまなプロパティ型に対応するさまざまな種類のアニメーションが存在します。  <xref:System.Double> を受け取るプロパティ \(要素の <xref:System.Windows.FrameworkElement.Width%2A> プロパティなど\) をアニメーション化するには、<xref:System.Double> 値を生成するアニメーションを使用します。  <xref:System.Windows.Point> を受け取るプロパティをアニメーション化するには、<xref:System.Windows.Point> 値を生成するアニメーションを使用します。他も同様です。  
+  
+ From\/To\/By アニメーション クラスは <xref:System.Windows.Media.Animation> 名前空間に属し、次の名前付け規則を使用します。  
+  
+ *\<Type\>* `Animation`  
+  
+ ここで、*\<Type\>* はクラスによってアニメーション化される値の型です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、次の From\/To\/By アニメーション クラスが用意されています。  
+  
+|プロパティの型|対応する From\/To\/By アニメーション クラス|  
+|-------------|-----------------------------------|  
+|<xref:System.Byte>|<xref:System.Windows.Media.Animation.ByteAnimation>|  
+|<xref:System.Windows.Media.Color>|<xref:System.Windows.Media.Animation.ColorAnimation>|  
+|<xref:System.Decimal>|<xref:System.Windows.Media.Animation.DecimalAnimation>|  
+|<xref:System.Double>|<xref:System.Windows.Media.Animation.DoubleAnimation>|  
+|<xref:System.Int16>|<xref:System.Windows.Media.Animation.Int16Animation>|  
+|<xref:System.Int32>|<xref:System.Windows.Media.Animation.Int32Animation>|  
+|<xref:System.Int64>|<xref:System.Windows.Media.Animation.Int64Animation>|  
+|<xref:System.Windows.Point>|<xref:System.Windows.Media.Animation.PointAnimation>|  
+|<xref:System.Windows.Media.Media3D.Quaternion>|<xref:System.Windows.Media.Animation.QuaternionAnimation>|  
+|<xref:System.Windows.Rect>|<xref:System.Windows.Media.Animation.RectAnimation>|  
+|<xref:System.Windows.Media.Media3D.Rotation3D>|<xref:System.Windows.Media.Animation.Rotation3DAnimation>|  
+|<xref:System.Single>|<xref:System.Windows.Media.Animation.SingleAnimation>|  
+|<xref:System.Windows.Size>|<xref:System.Windows.Media.Animation.SizeAnimation>|  
+|<xref:System.Windows.Thickness>|<xref:System.Windows.Media.Animation.ThicknessAnimation>|  
+|<xref:System.Windows.Media.Media3D.Vector3D>|<xref:System.Windows.Media.Animation.Vector3DAnimation>|  
+|<xref:System.Windows.Vector>|<xref:System.Windows.Media.Animation.VectorAnimation>|  
+  
+<a name="anim_values"></a>   
+## ターゲット値  
+ From\/To\/By アニメーションでは、2 つのターゲット値の間の遷移が作成されます。  開始値 \(<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティを使用して設定\) と終了値 \(<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティを使用して設定\) を指定するのが一般的です。  ただし、開始値だけ、終点の値だけ、またはオフセット値だけを指定することもできます。  これらの場合、アニメーションは、足りないターゲット値をアニメーション化しているプロパティから取得します。  アニメーションのターゲット値を指定するさまざまな方法を次に示します。  
+  
+-   **開始値**  
+  
+     アニメーションの開始値を明示的に指定する場合は、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティを使用します。  <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティだけで使用することも、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティまたは <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティと共に使用することもできます。  <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティだけを指定した場合は、アニメーションはその値から、アニメーション化されているプロパティの基本値まで遷移します。  
+  
+-   **終了値**  
+  
+     アニメーションの終了値を指定するには、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティを使用します。  <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティだけを使用すると、アニメーションは開始値を、アニメーション化されているプロパティから、または同じプロパティに適用されている別のアニメーションから取得します。  <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティと <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティを一緒に使用することで、アニメーションの開始値と終了値を明示的に指定できます。  
+  
+-   **オフセット値**  
+  
+     <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティを使用すると、アニメーションの明示的な開始値と終了値の代わりに、オフセットを指定できます。  アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティは、継続時間中にアニメーションが変更する値の大きさを指定します。  <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティだけで使用することも、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティと共に使用することもできます。  <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティだけを指定した場合は、プロパティの基本値または別のアニメーションの出力に、オフセット値が追加されます。  
+  
+<a name="examples"></a>   
+## From\/To\/By 値の使用  
+ 以下では、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> の各プロパティを、一緒に、または個別に使用する方法を説明します。  
+  
+ このセクションの各例では、From\/To\/By アニメーションの一種である <xref:System.Windows.Media.Animation.DoubleAnimation> を使用し、高さが 10 [デバイス非依存ピクセル](GTMT)で幅が 100 [デバイス非依存ピクセル](GTMT)の <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> プロパティをアニメーション化します。  
+  
+ 各例では <xref:System.Windows.Media.Animation.DoubleAnimation> を使用しますが、すべての From\/To\/By アニメーションの From、To、By プロパティの動作はまったく同じです。  これらの例では <xref:System.Windows.Media.Animation.Storyboard> を使用しますが、別の方法で From\/To\/By アニメーションを使用することもできます。  詳細については、「[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)」を参照してください。  
+  
+### From\/To  
+ <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> 値と <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> 値を設定すると、アニメーションは、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティで指定されている値から、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティで指定されている値まで進行します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティを 50 に設定し、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティを 300 に設定しています。  その結果、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、50 から 300 までアニメーション化されます。  
+  
+ [!code-csharp[basicvalues_snip#FromToAnimationInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicvalues_snip/CSharp/AnimationTargetValuesExample.cs#fromtoanimationinline)]
+ [!code-vb[basicvalues_snip#FromToAnimationInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicvalues_snip/VisualBasic/AnimationTargetValuesExample.vb#fromtoanimationinline)]  
+  
+### 目的  
+ <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティだけを設定すると、アニメーションは、アニメーション化されているプロパティの基本値から、または同じプロパティに対して先に適用されている構成アニメーションの出力から、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティで指定されている値まで進行します。  
+  
+ "構成アニメーション" とは、同じプロパティに対して以前に適用されていて、現在のアニメーションが <xref:System.Windows.Media.Animation.HandoffBehavior> ハンドオフ動作を使用して適用された時点でまだ有効であった、<xref:System.Windows.Media.Animation.ClockState> アニメーションまたは <xref:System.Windows.Media.Animation.ClockState> アニメーションのことです。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティだけを 300 に設定しています。  開始値は指定されていないので、<xref:System.Windows.Media.Animation.DoubleAnimation> は、<xref:System.Windows.FrameworkElement.Width%2A> プロパティの基本値 \(100\) を開始値として使用します。  <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、100 から、アニメーションのターゲット値である 300 までアニメーション化されます。  
+  
+ [!code-csharp[basicvalues_snip#ToAnimationInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicvalues_snip/CSharp/AnimationTargetValuesExample.cs#toanimationinline)]
+ [!code-vb[basicvalues_snip#ToAnimationInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicvalues_snip/VisualBasic/AnimationTargetValuesExample.vb#toanimationinline)]  
+  
+### By  
+ アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティだけを設定すると、アニメーションは、アニメーション化されているプロパティの基本値から、または構成アニメーションの出力から、これらの値に <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティで指定されている値を加えた合計値まで進行します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティだけを 300 に設定しています。  開始値は指定されていないので、<xref:System.Windows.Media.Animation.DoubleAnimation> は、<xref:System.Windows.FrameworkElement.Width%2A> プロパティの基本値である 100 を開始値として使用します。  終了値は、アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> の値 300 を開始値 100 に加えた値 400 になります。  その結果、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、100 から 400 までアニメーション化されます。  
+  
+ [!code-csharp[basicvalues_snip#ByAnimationInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicvalues_snip/CSharp/AnimationTargetValuesExample.cs#byanimationinline)]
+ [!code-vb[basicvalues_snip#ByAnimationInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicvalues_snip/VisualBasic/AnimationTargetValuesExample.vb#byanimationinline)]  
+  
+### From\/By  
+ アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティと <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティを設定すると、アニメーションは、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティで指定されている値から、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティと <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティの合計で指定される値まで進行します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティを 50 に設定し、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティを 300 に設定しています。  終了値は、アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> の値 300 を開始値 50 に加えた値 350 になります。  その結果、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、50 から 350 までアニメーション化されます。  
+  
+ [!code-csharp[basicvalues_snip#FromByAnimationInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicvalues_snip/CSharp/AnimationTargetValuesExample.cs#frombyanimationinline)]
+ [!code-vb[basicvalues_snip#FromByAnimationInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicvalues_snip/VisualBasic/AnimationTargetValuesExample.vb#frombyanimationinline)]  
+  
+### 変換前  
+ アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> 値だけを指定すると、アニメーションは、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティで指定されている値から、アニメーション化されているプロパティの基本値、または構成アニメーションの出力まで進行します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> プロパティだけを 50 に設定しています。  終了値は指定されていないので、<xref:System.Windows.Media.Animation.DoubleAnimation> は、<xref:System.Windows.FrameworkElement.Width%2A> プロパティの基本値 100 を終了値として使用します。  <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、50 から、<xref:System.Windows.FrameworkElement.Width%2A> プロパティの基本値 100 までアニメーション化されます。  
+  
+ [!code-csharp[basicvalues_snip#FromAnimationInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/basicvalues_snip/CSharp/AnimationTargetValuesExample.cs#fromanimationinline)]
+ [!code-vb[basicvalues_snip#FromAnimationInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/basicvalues_snip/VisualBasic/AnimationTargetValuesExample.vb#fromanimationinline)]  
+  
+### To\/By  
+ <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A> プロパティと <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティの両方を設定した場合は、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A> プロパティは無視されます。  
+  
+<a name="otheranimationtypes"></a>   
+## 他のアニメーションの種類  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が提供するアニメーションの種類は、From\/To\/By アニメーションだけではありません。キー フレーム アニメーションとパス アニメーションも提供されています。  
+  
+-   キー フレーム アニメーションは、キー フレームを使用して記述される複数の終了値に沿ってアニメーション化を行います。  詳細については、「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」を参照してください。  
+  
+-   パス アニメーションは、<xref:System.Windows.Media.PathGeometry> から出力値を生成します。  詳細については、「[パス アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/path-animations-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、独自のカスタム アニメーションの種類を作成することもできます。  詳細については、「[カスタム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/custom-animations-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.Timeline>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [パス アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/path-animations-overview.md)   
+ [カスタム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/custom-animations-overview.md)   
+ [アニメーションのターゲット値 \(From、To、および By\) のサンプル](http://go.microsoft.com/fwlink/?LinkID=159988)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md
new file mode 100644
index 00000000000..40bd8f6b43a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md
@@ -0,0 +1,48 @@
+---
+title: "ジオメトリに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "クラス, ジオメトリ"
+  - "ジオメトリ クラス"
+ms.assetid: 83873331-b013-472e-8197-8ba993dd242f
+caps.latest.revision: 72
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 72
+---
+# ジオメトリに関する「方法」トピック
+このセクションのトピックでは、アプリケーションで <xref:System.Windows.Media.Geometry> オブジェクトを使用する方法について説明します。  
+  
+## このセクションの内容  
+ [EllipseGeometry をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-ellipsegeometry.md)  
+ [ArcSegment のサイズをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-size-of-an-arcsegment.md)  
+ [複合図形の塗りつぶしを制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-the-fill-of-a-composite-shape.md)  
+ [結合したジオメトリを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-combined-geometry.md)  
+ [複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)  
+ [3 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md)  
+ [LineGeometry を使用して線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-line-using-a-linegeometry.md)  
+ [PathGeometry で LineSegment を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md)  
+ [PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)  
+ [StreamGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md)  
+ [2 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md)  
+ [楕円の円弧を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md)  
+ [PathGeometry 内に複数のサブパスを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-multiple-subpaths-within-a-pathgeometry.md)  
+ [RectangleGeometry を使用して四角形を定義する](../../../../docs/framework/wpf/graphics-multimedia/how-to-define-a-rectangle-using-a-rectanglegeometry.md)  
+ [RectangleGeometry の角に丸みを付ける](../../../../docs/framework/wpf/graphics-multimedia/how-to-round-the-corners-of-a-rectanglegeometry.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Brushes>   
+ <xref:System.Windows.Shapes.Shape>   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/geometries.md b/docs/framework/wpf/graphics-multimedia/geometries.md
new file mode 100644
index 00000000000..fa128e1088d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/geometries.md
@@ -0,0 +1,40 @@
+---
+title: "ジオメトリ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "2-D グラフィックス [WPF]"
+  - "クラス, ジオメトリ"
+  - "クリッピング領域の定義 [WPF]"
+  - "ジオメトリ クラス"
+  - "ヒットテスト (オブジェクトの) [WPF]"
+ms.assetid: 47ad531d-a4da-4e99-b12e-1de710c32493
+caps.latest.revision: 55
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 55
+---
+# ジオメトリ
+<xref:System.Windows.Media.Geometry> は、[!INCLUDE[TLA#tla_2d](../../../../includes/tlasharptla-2d-md.md)] グラフィックスのレンダリング、オブジェクトのヒット テスト、およびクリッピング領域の定義に使用される用途の広いクラスです。  
+  
+## このセクションの内容  
+ [パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)  
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Brushes>   
+ <xref:System.Windows.Shapes.Shape>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/geometry-overview.md b/docs/framework/wpf/graphics-multimedia/geometry-overview.md
new file mode 100644
index 00000000000..c377dfb0544
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/geometry-overview.md
@@ -0,0 +1,240 @@
+---
+title: "ジオメトリの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, ジオメトリ"
+  - "CombinedGeometry クラス"
+  - "EllipseGeometry クラス"
+  - "ジオメトリ クラス"
+  - "グラフィックス, ジオメトリ クラス"
+  - "LineGeometry クラス"
+  - "PathGeometry クラス"
+  - "RectangleGeometry クラス"
+ms.assetid: 9fba8934-98b7-4af6-82f6-f4ef887f963a
+caps.latest.revision: 23
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# ジオメトリの概要
+ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の <xref:System.Windows.Media.Geometry> クラスを使用して図形を記述する方法を説明します。  また、<xref:System.Windows.Media.Geometry> オブジェクトと <xref:System.Windows.Shapes.Shape> 要素の違いも示します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="wcpsdk_graphics_geometry_introduction"></a>   
+## ジオメトリとは  
+ <xref:System.Windows.Media.Geometry> クラス、および <xref:System.Windows.Media.EllipseGeometry>、<xref:System.Windows.Media.PathGeometry>、<xref:System.Windows.Media.CombinedGeometry> などの派生クラスを使用すると、2\-D 図形のジオメトリを記述できます。  これらの幾何学的な記述には、画面を塗りつぶす図形を定義したり、ヒット テストやクリップ領域を定義するなど、多くの用途があります。  ジオメトリを使用して、アニメーション パスを定義することもできます。  
+  
+ <xref:System.Windows.Media.Geometry> オブジェクトは、四角形や円などの単純なものにすることも、2 つ以上のジオメトリ オブジェクトから作成された複合的なものにすることもできます。  <xref:System.Windows.Media.PathGeometry> クラスや <xref:System.Windows.Media.StreamGeometry> クラスなど、円弧や曲線を記述できるクラスを使用すると、さらに複雑なジオメトリを作成することができます。  
+  
+ <xref:System.Windows.Media.Geometry> は <xref:System.Windows.Freezable> オブジェクトの一種であるため、<xref:System.Windows.Media.Geometry> オブジェクトにはいくつかの特殊な機能があります。具体的には、[リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)としての宣言、複数オブジェクトでの共有、読み取り専用に設定することによるパフォーマンスの向上、複製、スレッド セーフの設定などです。  <xref:System.Windows.Freezable> オブジェクトのさまざまな機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+<a name="wcpsdk_graphics_geometry_geometryandshapes"></a>   
+## ジオメトリと図形  
+ <xref:System.Windows.Media.Geometry> クラスと <xref:System.Windows.Shapes.Shape> クラスは、両方とも 2\-D 図形を記述するという点で似ていますが \(<xref:System.Windows.Media.EllipseGeometry> と <xref:System.Windows.Shapes.Ellipse> を比較した場合など\)、重要な違いがあります。  
+  
+ その 1 つは、<xref:System.Windows.Media.Geometry> クラスが <xref:System.Windows.Freezable> クラスを継承するのに対し、<xref:System.Windows.Shapes.Shape> クラスは <xref:System.Windows.FrameworkElement> を継承するという点です。  これらは要素であるため、<xref:System.Windows.Shapes.Shape> オブジェクトは自身をレンダリングしたり、レイアウト システムに参加することができますが、<xref:System.Windows.Media.Geometry> オブジェクトはそのような動作を実行できません。  
+  
+ <xref:System.Windows.Shapes.Shape> オブジェクトは、<xref:System.Windows.Media.Geometry> オブジェクトよりも簡単に使用できますが、<xref:System.Windows.Media.Geometry> オブジェクトは、より幅広い用途で使用できます。  <xref:System.Windows.Shapes.Shape> オブジェクトは、2\-D グラフィックスのレンダリングに使用されますが、<xref:System.Windows.Media.Geometry> オブジェクトは、2\-D グラフィックスの幾何学領域を定義したり、クリップ用の領域を定義したり、ヒット テスト用の領域を定義するなどに使用されます。  
+  
+### パス図形  
+ <xref:System.Windows.Shapes.Shape> の 1 つである <xref:System.Windows.Shapes.Path> クラスは、実際には <xref:System.Windows.Media.Geometry> を使用してそのコンテンツを記述します。  <xref:System.Windows.Media.Geometry> で <xref:System.Windows.Shapes.Path> の <xref:System.Windows.Shapes.Path.Data%2A> プロパティを設定し、その <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティと <xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティを設定することにより、<xref:System.Windows.Media.Geometry> をレンダリングできます。  
+  
+<a name="commonproperties"></a>   
+## ジオメトリを使用する一般的なプロパティ  
+ 前のセクションでは、ジオメトリ オブジェクトを他のオブジェクトと共にさまざまな目的で \(図形の描画、アニメーション、クリッピングなど\) 使用できることを説明しました。  <xref:System.Windows.Media.Geometry> オブジェクトを使用するプロパティを持ついくつかのクラスを次の表に示します。  
+  
+|種類|プロパティ|  
+|--------|-----------|  
+|<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>|<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath.PathGeometry%2A>|  
+|<xref:System.Windows.Media.DrawingGroup>|<xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>|  
+|<xref:System.Windows.Media.GeometryDrawing>|<xref:System.Windows.Media.GeometryDrawing.Geometry%2A>|  
+|<xref:System.Windows.Shapes.Path>|<xref:System.Windows.Shapes.Path.Data%2A>|  
+|<xref:System.Windows.UIElement>|<xref:System.Windows.UIElement.Clip%2A>|  
+  
+<a name="wcpsdk_graphics_geometry_geometrytypes"></a>   
+## 単純なジオメトリの種類  
+ すべてのジオメトリの基本クラスは、抽象クラス <xref:System.Windows.Media.Geometry> です。  <xref:System.Windows.Media.Geometry> クラスの派生クラスは大きく 3 つのカテゴリに分類されます。単純なジオメトリ、パス ジオメトリ、および複合ジオメトリです。  
+  
+ 単純なジオメトリ クラスには、<xref:System.Windows.Media.LineGeometry>、<xref:System.Windows.Media.RectangleGeometry>、および <xref:System.Windows.Media.EllipseGeometry> があり、線、四角形、円などの基本的な幾何学図形を作成するために使用されます。  
+  
+-   <xref:System.Windows.Media.LineGeometry> は、行の始点と終点を指定して定義します。  
+  
+-   <xref:System.Windows.Media.RectangleGeometry> は、その相対位置、および高さと幅を指定する <xref:System.Windows.Rect> 構造体を使用して定義されます。  <xref:System.Windows.Media.RectangleGeometry.RadiusX%2A> プロパティと <xref:System.Windows.Media.RectangleGeometry.RadiusY%2A> プロパティを設定して、丸みのある四角形を作成できます。  
+  
+-   <xref:System.Windows.Media.EllipseGeometry> は、中心点、x 半径、および y 半径で定義されます。  レンダリングおよびクリッピング用の単純なジオメトリの作成方法を次の例に示します。  
+  
+ <xref:System.Windows.Media.PathGeometry> を使用するか、ジオメトリ オブジェクトを結合する方法でも、これらと同じ図形や、さらに複雑な図形を作成することができます。ただし、これらのクラスを使用すると、このような基本的な幾何学図形を簡単に生成できます。  
+  
+ <xref:System.Windows.Media.LineGeometry> オブジェクトを作成してレンダリングする方法の例を次に示します。  前に述べたように、<xref:System.Windows.Media.Geometry> オブジェクトは自身を描画できないため、この例では <xref:System.Windows.Shapes.Path> 図形を使用して線をレンダリングします。  線には領域がないため、<xref:System.Windows.Shapes.Path> の <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを設定しても無効です。代わりに、<xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティと <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> プロパティだけを指定します。  この例からの出力を次の図に示します。  
+  
+ ![LineGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-line.png "graphicsmm\_line")  
+\(10,20\) から \(100,130\) まで描画された LineGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmlinegeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmlinegeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmlinegeometryexample)]  
+  
+ 次の例は、<xref:System.Windows.Media.EllipseGeometry> を作成してレンダリングする方法を示しています。  この例では、<xref:System.Windows.Media.EllipseGeometry> の <xref:System.Windows.Media.EllipseGeometry.Center%2A> を点 `50,50` に設定し、x 半径と y 半径を両方とも `50` に設定して、直径が 100 の円を作成します。  楕円の内部は、値 \(この例では <xref:System.Windows.Media.Brushes.Gold%2A>\) を Path 要素の Fill プロパティに割り当てることによって塗りつぶします。  この例からの出力を次の図に示します。  
+  
+ ![EllipseGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-ellipse.png "graphicsmm\_ellipse")  
+\(50,50\) に描画された EllipseGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMEllipseGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmellipsegeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMEllipseGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmellipsegeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMEllipseGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmellipsegeometryexample)]  
+  
+ <xref:System.Windows.Media.RectangleGeometry> オブジェクトを作成してレンダリングする方法の例を次に示します。  四角形の位置およびサイズは、<xref:System.Windows.Rect> 構造体によって定義されます。  位置は `50,50`、高さと幅は両方とも `25` で、正方形が作成されます。  この例からの出力を次の図に示します。  
+  
+ ![RectangleGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rectangle.png "graphicsmm\_rectangle")  
+50,50 に描画された RectangleGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmrectanglegeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmrectanglegeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmrectanglegeometryexample)]  
+  
+ <xref:System.Windows.Media.EllipseGeometry> をイメージのクリップ領域として使用する方法を次の例に示します。  <xref:System.Windows.Controls.Image> オブジェクトは、<xref:System.Windows.FrameworkElement.Width%2A> を 200、<xref:System.Windows.FrameworkElement.Height%2A> を 150 として定義されます。  <xref:System.Windows.Media.EllipseGeometry.RadiusX%2A> 値が 100、<xref:System.Windows.Media.EllipseGeometry.RadiusY%2A> 値が 75、および <xref:System.Windows.Media.EllipseGeometry.Center%2A> 値が 100,75 に指定された <xref:System.Windows.Media.EllipseGeometry> が、イメージの <xref:System.Windows.UIElement.Clip%2A> プロパティに設定されます。  イメージの楕円の領域内の部分だけが表示されます。  この例からの出力を次の図に示します。  
+  
+ ![クリッピングを使用する &#40;または使用しない&#41; イメージ](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-clipexample.png "graphicsmm\_clipexample")  
+イメージ コントロールのクリップに使用される EllipseGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMImageClipGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmimageclipgeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMImageClipGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmimageclipgeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMImageClipGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmimageclipgeometryexample)]  
+  
+<a name="wcpsdk_graphics_geometry_pathgeometry"></a>   
+## パス ジオメトリ  
+ <xref:System.Windows.Media.PathGeometry> クラスとその軽量等価クラスの <xref:System.Windows.Media.StreamGeometry> を使用すると、円弧、曲線、および線で構成される複数の複雑な図形を記述できます。  
+  
+ <xref:System.Windows.Media.PathGeometry> の中核は、<xref:System.Windows.Media.PathFigure> オブジェクトのコレクションです。各図形が <xref:System.Windows.Media.PathGeometry> の個々の図形を記述しているため、この名前が付いています。  各 <xref:System.Windows.Media.PathFigure> 自体は 1 つ以上の <xref:System.Windows.Media.PathSegment> オブジェクトで構成されており、これらの各オブジェクトは図形のセグメントを記述します。  
+  
+ 次のように、多くの種類のセグメントがあります。  
+  
+|セグメントの種類|Description|例|  
+|--------------|-----------------|-------|  
+|<xref:System.Windows.Media.ArcSegment>|2 つの点の間の楕円の円弧を作成します。|[楕円の円弧を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md).|  
+|<xref:System.Windows.Media.BezierSegment>|2 つの点の間の 3 次ベジエ曲線を作成します。|[3 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md).|  
+|<xref:System.Windows.Media.LineSegment>|2 つの点の間の直線を作成します。|[PathGeometry で LineSegment を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md)|  
+|<xref:System.Windows.Media.PolyBezierSegment>|一連の 3 次ベジエ曲線を作成します。|<xref:System.Windows.Media.PolyBezierSegment> の種類のページを参照してください。|  
+|<xref:System.Windows.Media.PolyLineSegment>|一連の直線を作成します。|<xref:System.Windows.Media.PolyLineSegment> の種類のページを参照してください。|  
+|<xref:System.Windows.Media.PolyQuadraticBezierSegment>|一連の 2 次ベジエ曲線を作成します。|<xref:System.Windows.Media.PolyQuadraticBezierSegment> のページを参照してください。|  
+|<xref:System.Windows.Media.QuadraticBezierSegment>|2 次ベジエ曲線を作成します。|[2 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md).|  
+  
+ <xref:System.Windows.Media.PathFigure> 内のセグメントは 1 つの幾何学図形に結合されて、各セグメントの終点が次のセグメントの始点になります。  <xref:System.Windows.Media.PathFigure> の <xref:System.Windows.Media.PathFigure.StartPoint%2A> プロパティは、最初のセグメントが描画される始点を指定します。  後続の各セグメントは、前のセグメントの終点から開始します。  たとえば、`10,50` から `10,150` までの縦線を定義するには、<xref:System.Windows.Media.PathFigure.StartPoint%2A> プロパティを `10,50` に設定し、<xref:System.Windows.Media.LineSegment.Point%2A> プロパティを `10,150` に設定した <xref:System.Windows.Media.LineSegment> を作成します。  
+  
+ <xref:System.Windows.Media.LineSegment> を使用して、単一の <xref:System.Windows.Media.PathFigure> で構成される単純な <xref:System.Windows.Media.PathGeometry> を作成し、<xref:System.Windows.Shapes.Path> 要素を使用してそれを表示する例を次に示します。  <xref:System.Windows.Media.PathFigure> オブジェクトの <xref:System.Windows.Media.PathFigure.StartPoint%2A> は `10,20` に設定され、<xref:System.Windows.Media.LineSegment> の終点は `100,130` で定義されます。  この例で作成した <xref:System.Windows.Media.PathGeometry> を次の図に示します。  
+  
+ ![LineGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-line.png "graphicsmm\_line")  
+単一の LineSegment を含む PathGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMPathGeometryLineExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmpathgeometrylineexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryLineExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmpathgeometrylineexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryLineExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmpathgeometrylineexample)]  
+  
+ この例と、前の <xref:System.Windows.Media.LineGeometry> 例を比較してみてください。  <xref:System.Windows.Media.PathGeometry> に使用されている構文は、単純な <xref:System.Windows.Media.LineGeometry> に使用されている構文よりもかなり詳細です。この例では <xref:System.Windows.Media.LineGeometry> クラスを使用する方が合理的ですが、<xref:System.Windows.Media.PathGeometry> の詳細な構文を使用すると、非常に複雑な幾何学領域を作成できます。  
+  
+ より複雑なジオメトリを作成するには、<xref:System.Windows.Media.PathSegment> オブジェクトを組み合わせて使用します。  
+  
+ 次の例では、<xref:System.Windows.Media.BezierSegment>、<xref:System.Windows.Media.LineSegment>、および <xref:System.Windows.Media.ArcSegment> を使用して図形を作成します。  この例では、最初に、始点 \(前のセグメントの終点\)、終点 \(<xref:System.Windows.Media.BezierSegment.Point3%2A>\)、および 2 つの制御点 \(<xref:System.Windows.Media.BezierSegment.Point1%2A> および <xref:System.Windows.Media.BezierSegment.Point2%2A>\) の 4 つの点を定義して 3 次ベジェ曲線を作成します。  3 次ベジエ曲線の 2 つの制御点は磁石のような働きをします。本来は直線になる部分を制御点の方へ引き寄せ、曲線を生成します。  1 つ目の制御点である <xref:System.Windows.Media.BezierSegment.Point1%2A> は、曲線の開始部分に影響します。2 つ目の制御点である <xref:System.Windows.Media.BezierSegment.Point2%2A> は、曲線の終了部分に影響します。  
+  
+ 次に、<xref:System.Windows.Media.LineSegment> を追加します。これは、その前にある <xref:System.Windows.Media.BezierSegment> の終点からその <xref:System.Windows.Media.LineSegment> プロパティで指定された点までの間に描画されます。  
+  
+ 次に、<xref:System.Windows.Media.ArcSegment> を追加します。これは、その前の <xref:System.Windows.Media.LineSegment> の終点からその <xref:System.Windows.Media.ArcSegment.Point%2A> プロパティで指定された点までの間に描画されます。  また、円弧の x 半径と y 半径 \(<xref:System.Windows.Media.ArcSegment.Size%2A>\)、回転角度 \(<xref:System.Windows.Media.ArcSegment.RotationAngle%2A>\)、結果の円弧の角度の大きさを示すフラグ \(<xref:System.Windows.Media.ArcSegment.IsLargeArc%2A>\)、および円弧が描画される方向を示す値 \(<xref:System.Windows.Media.ArcSegment.SweepDirection%2A>\) も指定します。  この例で作成した図形を次の図に示します。  
+  
+ ![PathGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-path2.png "graphicsmm\_path2")  
+PathGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMPathGeometryComplexExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmpathgeometrycomplexexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryComplexExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmpathgeometrycomplexexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryComplexExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmpathgeometrycomplexexample)]  
+  
+ さらに複雑なジオメトリを作成するには、<xref:System.Windows.Media.PathGeometry> 内で複数の <xref:System.Windows.Media.PathFigure> オブジェクトを使用します。  
+  
+ 2 つの <xref:System.Windows.Media.PathFigure> オブジェクトを使用して <xref:System.Windows.Media.PathGeometry> を作成する例を次に示します。各オブジェクトには、複数の <xref:System.Windows.Media.PathSegment> オブジェクトが含まれます。  上記の例の <xref:System.Windows.Media.PathFigure> と、<xref:System.Windows.Media.PolyLineSegment> および <xref:System.Windows.Media.QuadraticBezierSegment> による <xref:System.Windows.Media.PathFigure> が使用されています。  <xref:System.Windows.Media.PolyLineSegment> は点の配列を使用して定義され、<xref:System.Windows.Media.QuadraticBezierSegment> は制御点と終点を使用して定義されます。  この例で作成した図形を次の図に示します。  
+  
+ ![PathGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-path.png "graphicsmm\_path")  
+複数の図形を使用する PathGeometry  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMPathGeometryComplexMultiExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmpathgeometrycomplexmultiexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryComplexMultiExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmpathgeometrycomplexmultiexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMPathGeometryComplexMultiExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmpathgeometrycomplexmultiexample)]  
+  
+### StreamGeometry  
+ <xref:System.Windows.Media.PathGeometry> クラスと同様に、<xref:System.Windows.Media.StreamGeometry> は、曲線、円弧、および線を含む複雑な幾何学図形を定義することができます。  <xref:System.Windows.Media.PathGeometry> とは異なり、<xref:System.Windows.Media.StreamGeometry> のコンテンツは、データ バインディング、アニメーション、変更をサポートしません。  複雑なジオメトリを作成する必要があるが、データ バインディング、アニメーション、または変更をサポートするためのオーバーヘッドが望ましくない場合は、<xref:System.Windows.Media.StreamGeometry> を使用します。  <xref:System.Windows.Media.StreamGeometry> クラスは効率的であるため、装飾の表現に適しています。  
+  
+ 例については、「[StreamGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md)」を参照してください。  
+  
+### パス マークアップ構文  
+ <xref:System.Windows.Media.PathGeometry> と <xref:System.Windows.Media.StreamGeometry> は、特殊な一連の移動および描画コマンドを使用して [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 属性構文をサポートします。  詳細については、「[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)」を参照してください。  
+  
+<a name="wcpsdk_graphics_geometry_introduction2"></a>   
+## 複合ジオメトリ  
+ 複合ジオメトリ オブジェクトは、<xref:System.Windows.Media.GeometryGroup> または <xref:System.Windows.Media.CombinedGeometry> を使用するか、<xref:System.Windows.Media.Geometry> の静的メソッドである <xref:System.Windows.Media.Geometry.Combine%2A> を呼び出すことによって作成できます。  
+  
+-   <xref:System.Windows.Media.CombinedGeometry> オブジェクトおよび <xref:System.Windows.Media.Geometry.Combine%2A> メソッドはブール演算を実行して、2 つのジオメトリで定義されている領域を結合します。  領域を持たない <xref:System.Windows.Media.Geometry> オブジェクトは破棄されます。  結合できるのは、2 つの <xref:System.Windows.Media.Geometry> オブジェクトだけです。ただし、この 2 つのジオメトリに複合ジオメトリを使用することもできます。  
+  
+-   <xref:System.Windows.Media.GeometryGroup> クラスは、そのクラスに含まれる <xref:System.Windows.Media.Geometry> オブジェクトについて、その領域を結合することなく混合を作成します。  <xref:System.Windows.Media.Geometry> オブジェクトはいくつでも <xref:System.Windows.Media.GeometryGroup> に追加できます。  例については、「[複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)」を参照してください。  
+  
+ 結合操作を実行しないため、<xref:System.Windows.Media.GeometryGroup> オブジェクトを使用した方が、<xref:System.Windows.Media.CombinedGeometry> オブジェクトまたは <xref:System.Windows.Media.Geometry.Combine%2A> メソッドを使用するよりもパフォーマンスが向上します。  
+  
+<a name="combindgeometriessection"></a>   
+## 結合したジオメトリ  
+ 前のセクションでは、<xref:System.Windows.Media.CombinedGeometry> オブジェクトと <xref:System.Windows.Media.Geometry.Combine%2A> メソッドが、それらに含まれるジオメトリで定義された領域を結合することを説明しました。  <xref:System.Windows.Media.GeometryCombineMode> 列挙体は、ジオメトリを結合する方法を指定します。  <xref:System.Windows.Media.CombinedGeometry.GeometryCombineMode%2A> プロパティに指定できる値は、<xref:System.Windows.Media.GeometryCombineMode>、<xref:System.Windows.Media.GeometryCombineMode>、<xref:System.Windows.Media.GeometryCombineMode>、および <xref:System.Windows.Media.GeometryCombineMode> です。  
+  
+ 次の例では、<xref:System.Windows.Media.CombinedGeometry> が和集合の結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#23](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#23)]  
+  
+ ![結合組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-union.png "mil\_task\_combined\_geometry\_union")  
+  
+ 次の例では、<xref:System.Windows.Media.CombinedGeometry> が <xref:System.Windows.Media.GeometryCombineMode> の結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#24](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#24)]  
+  
+ ![Xor 組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-xor.png "mil\_task\_combined\_geometry\_xor")  
+  
+ その他の例については、「[複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)」と「[結合したジオメトリを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-combined-geometry.md)」を参照してください。  
+  
+<a name="freezable_features"></a>   
+## Freezable の機能  
+ <xref:System.Windows.Media.Geometry> クラスは <xref:System.Windows.Freezable> クラスを継承しているため、いくつかの特殊な機能を備えています。つまり、<xref:System.Windows.Media.Geometry> オブジェクトを[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)として宣言したり、複数のオブジェクト間で共有したり、読み取り専用にしてパフォーマンスを高めたり、複製したり、スレッド セーフにしたりできます。  <xref:System.Windows.Freezable> オブジェクトのさまざまな機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+<a name="othergeometryfeatures"></a>   
+## その他のジオメトリ機能  
+ <xref:System.Windows.Media.Geometry> クラスは、次のような便利なユーティリティ メソッドも提供します。  
+  
+-   <xref:System.Windows.Media.Geometry.GetArea%2A> \- <xref:System.Windows.Media.Geometry> の領域を取得します。  
+  
+-   <xref:System.Windows.Media.Geometry.FillContains%2A> \- ジオメトリに別の <xref:System.Windows.Media.Geometry> が含まれているかどうかを判断します。  
+  
+-   <xref:System.Windows.Media.Geometry.StrokeContains%2A> \- 指定した点が <xref:System.Windows.Media.Geometry> のストロークに含まれているかどうかを判断します。  
+  
+ メソッドの完全な一覧については、<xref:System.Windows.Media.Geometry> クラスを参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Geometry>   
+ <xref:System.Windows.Media.PathGeometry>   
+ <xref:System.Windows.Shapes.Path>   
+ <xref:System.Windows.Media.GeometryDrawing>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md
new file mode 100644
index 00000000000..75fa5e91173
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md
@@ -0,0 +1,45 @@
+---
+title: "グラフィックスに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グラフィック効果"
+  - "グラフィックス [WPF], 方法トピック"
+  - "ビジュアル効果"
+ms.assetid: 959cb1cc-d26c-4bbc-b637-251091987288
+caps.latest.revision: 56
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 56
+---
+# グラフィックスに関する「方法」トピック
+以下のトピックでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のグラフィックス機能を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [四角形をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle.md)  
+ [PointAnimation を使用してオブジェクトの位置をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-of-an-object-by-using-pointanimation.md)  
+ [点およびベクターを変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-transform-points-and-vectors.md)  
+ [WPF アプリケーションへのグラス フレームの拡張](../../../../docs/framework/wpf/graphics-multimedia/extend-glass-frame-into-a-wpf-application.md)  
+ [方法: 要素をキャッシュしてレンダリングのパフォーマンスを向上させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-improve-rendering-performance-by-caching-an-element.md)  
+ [方法: キャッシュされた要素をブラシとして使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-cached-element-as-a-brush.md)  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Shape>   
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.Imaging.BitmapImage>   
+ <xref:System.Windows.Media.Geometry>   
+ <xref:System.Windows.Media.Drawing>   
+ <xref:System.Windows.Media.Brush>   
+ <xref:System.Windows.Media.Effects.BitmapEffect>   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md b/docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md
new file mode 100644
index 00000000000..cb9f4130d09
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md
@@ -0,0 +1,109 @@
+---
+title: "グラフィックス レンダリングのレジストリ設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス [WPF], 描画"
+  - "描画 (グラフィックスを)"
+  - "描画 (グラフィックスを), レジストリ設定"
+  - "描画 (グラフィックスを), トラブルシューティング"
+  - "トラブルシューティング (グラフィックス レンダリング)"
+ms.assetid: f4b41b42-327d-407c-b398-3ed5f505df8b
+caps.latest.revision: 18
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# グラフィックス レンダリングのレジストリ設定
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションに影響を与える [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] グラフィックス レンダリングのレジストリ設定の概要について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="overview"></a>   
+## グラフィックス レンダリングのレジストリ設定を使用する場合  
+ これらのレジストリ設定は、トラブルシューティング、デバッグ、および製品サポートのために提供されています。  レジストリを変更するとすべての [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションが影響を受けるので、アプリケーションでは、これらのレジストリ キーを自動的に変更したり、インストール時に変更したりしないでください。  
+  
+<a name="xpdmandwddm"></a>   
+## XPDM と WDDM について  
+ グラフィックス レンダリングのレジストリの一部の設定は、ビデオ カードが XPDM ドライバーまたは WDDM ドライバーのどちらを使用するかによって、既定値が異なります。  XPDM は [!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] Display Driver Model、WDDM は Windows Display Driver Model の略です。  WDDM は、[!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)] および [!INCLUDE[win7](../../../../includes/win7-md.md)] を実行中のコンピューターで使用できます。  XPDM は、[!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)]、[!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)]、および [!INCLUDE[TLA#tla_winnetsvrfam](../../../../includes/tlasharptla-winnetsvrfam-md.md)] を実行中のコンピューターで使用できます。  WDDM の詳細については、「[Windows Vista Display Driver Model Design Guide \(Windows Vista ディスプレイ ドライバー モデル デザイン ガイド\)](http://go.microsoft.com/fwlink/?LinkId=178394)」を参照してください。  
+  
+<a name="registry_settings"></a>   
+## レジストリ設定  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のレンダリングを制御するために 4 つのレジストリ設定が用意されています。  
+  
+|設定|Description|  
+|--------|-----------------|  
+|**Disable Hardware Acceleration Option**|ハードウェア アクセラレータを有効にするかどうかを指定します。|  
+|**Maximum Multisample Value**|[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] コンテンツのアンチエイリアシングのマルチサンプリングの度合いを指定します。|  
+|**Required Video Driver Date Setting**|2004 年 11 月より前にリリースされたドライバーに対してハードウェア アクセラレータをシステムで無効にするかどうかを指定します。|  
+|**Use Reference Rasterizer Option**|[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] でリファレンス ラスタライザーを使用するかどうかを指定します。|  
+  
+ これらの設定には、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] レジストリ設定の参照方法を認識している外部構成ユーティリティを使用してアクセスできます。  また、これらの設定は、[!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] レジストリ エディターを使用して値に直接アクセスして作成または変更することもできます。  
+  
+<a name="disablehardwareacceleration"></a>   
+## Disable Hardware Acceleration Option  
+  
+|レジストリ キー|値の種類|  
+|--------------|----------|  
+|`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration`|DWORD|  
+  
+ **Disable Hardware Acceleration Option** を使用すると、デバッグとテストのためにハードウェアの加速を無効にできます。  アプリケーションでレンダリング アイテムを表示するとき、ハードウェア加速を無効にしてみてください。  アイテムが消える場合は、ビデオ ドライバーの問題である可能性があります。  
+  
+ **Disable Hardware Acceleration Option** は、0 か 1 の DWORD 値です。  値を 1 に設定すると、ハードウェア アクセラレータが無効になります。  値が 0 の場合、システムがハードウェア加速の要件を満たしていれば、ハードウェア加速が有効になります。詳細については、「[グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)」を参照してください。  
+  
+<a name="maxmultisample"></a>   
+## Maximum Multisample Value  
+  
+|レジストリ キー|値の種類|  
+|--------------|----------|  
+|`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics\MaxMultisampleType`|DWORD|  
+  
+ **Maximum Multisample Value** を使用すると、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] コンテンツのアンチエイリアシングの最大量を調整できます。  [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] のアンチエイリアシングを [!INCLUDE[TLA2#tla_winvista](../../../../includes/tla2sharptla-winvista-md.md)] で無効にするには、または [!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] で有効にするには、このレベルを使用します。  
+  
+ **Maximum Multisample Value** は、0 ～ 16 の範囲の DWORD 値です。  値 0 を指定すると、3\-D コンテンツのマルチサンプル アンチエイリアシングは無効になり、値 16 を指定すると、ビデオ カードがサポートする場合は、最大で 16 倍のマルチサンプル アンチエイリアシングの使用が試行されます。  XPDM ドライバーを使用するコンピューターでこのレジストリ キー値を設定すると、アプリケーションは大量のビデオ メモリを追加使用するため、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] レンダリングのパフォーマンスが低下し、レンダリング エラーや安定性の問題が発生する可能性があることに注意してください。  
+  
+ このレジストリ キーを設定しないと、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の既定値は、XPDM ドライバーでは 0、WDDM ドライバーでは 4 になります。  
+  
+<a name="requiredvideodriverdatesetting"></a>   
+## Required Video Driver Date Setting  
+  
+|レジストリ キー|値の種類|  
+|--------------|----------|  
+|`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics\RequiredVideoDriverDate`|\[文字列\]|  
+  
+ 2004 年 11 月に、[!INCLUDE[TLA#tla_ms](../../../../includes/tlasharptla-ms-md.md)] はドライバー テストに関するガイドラインの新バージョンをリリースしました。これ以降に作成されたドライバーは、安定性が向上しています。  既定では、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、これらのドライバーに対してはハードウェア加速パイプラインを使用し、この日より前に公開された XPDM ドライバーについてはソフトウェア レンダリングを使用します。  
+  
+ **Required Video Driver Date Setting** を使用すると、XPDM ドライバーに対して最低限の代わりの日付を指定できます。  使用するビデオ ドライバーが十分に安定して [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をサポートすることが確実な場合にのみ、2004 年 11 月より前の日付を指定するようにしてください。  
+  
+ ビデオ ドライバーの設定では、次の形式の文字列を使用する必要があります。  
+  
+||  
+|-|  
+|*YYYY* `/` *MM* `/` *DD*|  
+  
+ *YYYY* は 4 桁の年、*MM* は 2 桁の月、*DD* は 2 桁の日です。  この値を設定しないと、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は必要なビデオ ドライバーの日付として 2004 年 11 月を使用します。  
+  
+<a name="usereferencerasterizeroption"></a>   
+## Use Reference Rasterizer Option  
+  
+|レジストリ キー|値の種類|  
+|--------------|----------|  
+|`HKEY_CURRENT_USER\SOFTWARE\Microsoft\Avalon.Graphics\UseReferenceRasterizer`|DWORD|  
+  
+ **Use Reference Rasterizer Option** を使用すると、強制的に [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] をデバッグ用のシミュレートされたハードウェア レンダリング モードにすることができます。[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] はハードウェア モードになりますが、実際のハードウェア デバイスの代わりに、[!INCLUDE[TLA#tla_d3d](../../../../includes/tlasharptla-d3d-md.md)] リファレンス ソフトウェア ラスタライザー d3dref9.dll を使用します。  
+  
+ リファレンス ラスタライザーは非常に低速ですが、ビデオ ドライバーをバイパスし、ドライバーの問題によって発生するレンダリングの問題を回避します。  このため、リファレンス ラスタライザーを使用すると、レンダリングの問題の原因がビデオ ドライバーかどうかを判断できます。  d3dref9.dll ファイルは、システム パス内の場所やアプリケーションのローカル ディレクトリなど、アプリケーションがアクセスできる場所に存在する必要があります。  
+  
+ **Use Reference Rasterizer Option** は DWORD 値を受け取ります。  値 0 は、リファレンス ラスタライザーを使用しないことを示します。  他の 0 以外の値は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] にリファレンス ラスタライザーの使用を強制します。  
+  
+## 参照  
+ [グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/graphics.md b/docs/framework/wpf/graphics-multimedia/graphics.md
new file mode 100644
index 00000000000..0c10e70e7c0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/graphics.md
@@ -0,0 +1,48 @@
+---
+title: "グラフィックス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グラフィックス [WPF], 効果"
+  - "ビジュアル効果"
+ms.assetid: 3bfc652e-91b7-4697-a4f4-83ff0e98327e
+caps.latest.revision: 73
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 73
+---
+# グラフィックス
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、マルチメディア、ベクター グラフィックス、アニメーション、およびコンテンツ構成の統合サポートが提供されるので、開発者はユーザーの関心を引くユーザー インターフェイスやコンテンツを簡単に開発できます。  
+  
+## このセクションの内容  
+ [ビットマップ効果](../../../../docs/framework/wpf/graphics-multimedia/bitmap-effects.md)  
+ [ブラシ](../../../../docs/framework/wpf/graphics-multimedia/brushes.md)  
+ [描画](../../../../docs/framework/wpf/graphics-multimedia/drawings.md)  
+ [ジオメトリ](../../../../docs/framework/wpf/graphics-multimedia/geometries.md)  
+ [イメージ](../../../../docs/framework/wpf/graphics-multimedia/images.md)  
+ [図形](../../../../docs/framework/wpf/graphics-multimedia/shapes.md)  
+ [変換](../../../../docs/framework/wpf/graphics-multimedia/transformations.md)  
+ [グラフィックス レンダリングのレジストリ設定](../../../../docs/framework/wpf/graphics-multimedia/graphics-rendering-registry-settings.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Shape>   
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.Imaging.BitmapImage>   
+ <xref:System.Windows.Media.Geometry>   
+ <xref:System.Windows.Media.Drawing>   
+ <xref:System.Windows.Media.Brush>   
+ <xref:System.Windows.Media.Effects.BitmapEffect>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md b/docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md
new file mode 100644
index 00000000000..e24c833e213
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md
@@ -0,0 +1,154 @@
+---
+title: "ビジュアル層でのヒット テスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ヒット テスト機能"
+  - "ビジュアル層, ヒット テスト機能"
+ms.assetid: b1a64b61-14be-4d75-b89a-5c67bebb2c7b
+caps.latest.revision: 42
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 41
+---
+# ビジュアル層でのヒット テスト
+ここでは、ビジュアル層で提供されるヒット テスト機能の概要について説明します。  ヒット テストのサポートにより、ジオメトリまたはポイント値が <xref:System.Windows.Media.Visual> のレンダリングされるコンテンツ内にあるかどうかを判断でき、複数のオブジェクトを選択するための選択四角形などのユーザー インターフェイスの動作を実装できます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="hit_testing_scenarios"></a>   
+## ヒット テストのシナリオ  
+ <xref:System.Windows.UIElement> クラスには <xref:System.Windows.UIElement.InputHitTest%2A> メソッドが用意されています。このメソッドを使用すると、指定した座標値を使用して要素に対してヒット テストを実行できます。  多くの場合、<xref:System.Windows.UIElement.InputHitTest%2A> メソッドは、要素のヒット テストを実装するために必要な機能を提供します。  ただし、ビジュアル層でのヒット テストを実装する必要があるシナリオもいくつか存在します。  
+  
+-   <xref:System.Windows.UIElement> 以外のオブジェクトに対するヒット テスト : これは、<xref:System.Windows.Media.DrawingVisual> やグラフィックス オブジェクトなどの <xref:System.Windows.UIElement> 以外のオブジェクトのヒット テストを行う場合に適用されます。  
+  
+-   ジオメトリを使用したヒット テスト : これは、ポイントの座標値ではなくジオメトリ オブジェクトを使用してヒット テストを行う必要がある場合に適用されます。  
+  
+-   複数のオブジェクトに対するヒット テスト : これは、重なっているオブジェクトなどの複数のオブジェクトに対してヒット テストを行う必要がある場合に適用されます。  最初のビジュアルだけでなく、ジオメトリまたはポイントと交差するすべてのビジュアルの結果を取得できます。  
+  
+-   <xref:System.Windows.UIElement> ヒット テスト ポリシーの無視 : これは、要素が無効または非表示かなどについて考慮する <xref:System.Windows.UIElement> ヒット テスト ポリシーを無視する必要がある場合に適用されます。  
+  
+> [!NOTE]
+>  ビジュアル層でのヒット テストを示すコード サンプル全体については、[DrawingVisuals を使用したヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159994)および [Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)を参照してください。  
+  
+<a name="hit_testing_support"></a>   
+## ヒット テストのサポート  
+ <xref:System.Windows.Media.VisualTreeHelper> クラスの <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドの目的は、ジオメトリまたはポイントの座標値が特定のオブジェクト \(コントロールやグラフィック要素など\) のレンダリングされるコンテンツ内にあるかどうかを確認することです。  たとえば、ヒット テストを使用することで、オブジェクトの外接する四角形内でのマウス クリックが円のジオメトリ内にあるかどうかを確認できます。  また、ヒット テストの既定の実装をオーバーライドして、独自のカスタム ヒット テスト計算を実行することもできます。  
+  
+ 四角形以外のオブジェクトの領域と外接する四角形との関係を次の図に示します。  
+  
+ ![有効なヒット テスト領域のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-1.png "wcpsdk\_mmgraphics\_visuals\_hittest\_1")  
+有効なヒット テスト領域の図  
+  
+<a name="hit_testing_and_z-order"></a>   
+## ヒット テストと Z オーダー  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のビジュアル層は、最上位のオブジェクトだけでなく、ポイントまたはジオメトリの下にあるすべてのオブジェクトに対するヒット テストをサポートします。  結果は [z オーダー](GTMT)で返されます。  ただし、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドにパラメーターとして渡すビジュアル オブジェクトによって、[ビジュアル ツリー](GTMT)のどの部分がヒット テストの対象となるかが決定されます。  ヒット テストは、ビジュアル ツリー全体またはその一部に対して実行できます。  
+  
+ 次の図では、四角形と三角形の両方のオブジェクト上に円オブジェクトがあります。  [z オーダー](GTMT)の値が最上位のビジュアル オブジェクトのヒット テストのみを行う場合、<xref:System.Windows.Media.HitTestResultCallback> から <xref:System.Windows.Media.HitTestResultBehavior> を返すようにビジュアル ヒット テストの列挙体を設定して、最初の項目の終了後にヒット テストの移動を停止することができます。  
+  
+ ![ビジュアル ツリーの z オーダーのダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-2.png "wcpsdk\_mmgraphics\_visuals\_hittest\_2")  
+ビジュアル ツリーの z オーダーの図  
+  
+ 特定のポイントまたはジオメトリの下にあるすべてのビジュアル オブジェクトを列挙する場合は、<xref:System.Windows.Media.HitTestResultCallback> から <xref:System.Windows.Media.HitTestResultBehavior> を返します。  つまり、完全に隠されているものも含めて、他のオブジェクトの下にあるすべてのビジュアル オブジェクトに対してヒット テストを行うことができます。  詳細については、「ヒット テスト結果のコールバックの使用」のサンプル コードを参照してください。  
+  
+> [!NOTE]
+>  透明なビジュアル オブジェクトのヒット テストも実行できます。  
+  
+<a name="using_default_hit_testing"></a>   
+## 既定のヒット テストの使用  
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを使用して、テストを実行するビジュアル オブジェクトとポイントの座標値を指定することにより、ビジュアル オブジェクトのジオメトリ内にポイントがあるかどうかを識別できます。  ビジュアル オブジェクトのパラメーターは、ヒット テストの検索のためのビジュアル ツリー内の開始点を識別します。  ジオメトリに座標が含まれるビジュアル ツリーにビジュアル オブジェクトが存在する場合は、<xref:System.Windows.Media.HitTestResult> オブジェクトの <xref:System.Windows.Media.HitTestResult.VisualHit%2A> プロパティに設定されます。  次に、<xref:System.Windows.Media.HitTestResult> が <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドから返されます。  ヒット テストの対象のビジュアル サブツリーにポイントが含まれない場合、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> は `null` を返します。  
+  
+> [!NOTE]
+>  既定のヒット テストでは、常に [z オーダー](GTMT)で最上位のオブジェクトが返されます。  部分的または完全に隠されているものも含めて、すべてのビジュアル オブジェクトを識別するには、ヒット テストの結果のコールバックを使用します。  
+  
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドの Point パラメーターとして渡す座標値は、ヒット テストの対象のビジュアル オブジェクトの座標空間に対して相対的である必要があります。  たとえば、入れ子になったビジュアル オブジェクトが親の座標空間の \(100, 100\) に定義されている場合、\(0, 0\) での子ビジュアルのヒット テストは、親の座標空間の \(100, 100\) でのヒット テストと同じになります。  
+  
+ 次のコードでは、ヒット テストに使用するイベントをキャプチャするために使用される <xref:System.Windows.UIElement> オブジェクトにマウス イベント ハンドラーを設定する方法を示します。  
+  
+ [!code-csharp[HitTestingOverview#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#100)]
+ [!code-vb[HitTestingOverview#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#100)]  
+  
+### ヒット テストに対するビジュアル ツリーの影響  
+ ビジュアル ツリー内の開始点によって、ヒット テストによるオブジェクトの列挙時に返されるオブジェクトが決定されます。  ヒット テストの対象となるオブジェクトが複数存在する場合、ビジュアル ツリー内の開始点として使用されるビジュアル オブジェクトは、対象となるすべてのオブジェクトの共通の先祖である必要があります。  たとえば、次の図のボタン要素と描画ビジュアルの両方のヒット テストを行う場合、ビジュアル ツリー内の開始点をその両方の共通の先祖に設定する必要があります。  この場合、キャンバス要素がボタン要素と描画ビジュアルの両方の共通の先祖になります。  
+  
+ ![ビジュアル ツリー階層のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-overview-01.png "wcpsdk\_mmgraphics\_visuals\_overview\_01")  
+ビジュアル ツリー階層の図  
+  
+> [!NOTE]
+>  <xref:System.Windows.UIElement.IsHitTestVisible%2A> プロパティは、描画されたコンテンツの一部からヒット テスト結果として <xref:System.Windows.UIElement> 派生オブジェクトが返される可能性があるかどうかを宣言する値を取得または設定します。  これにより、ビジュアル ツリーを選択的に変更し、ヒット テストの対象となるビジュアル オブジェクトを決定することができます。  
+  
+<a name="using_a_hit_test_result_callback"></a>   
+## ヒット テスト結果のコールバックの使用  
+ ジオメトリに指定した座標値が含まれるビジュアル ツリーのすべてのビジュアル オブジェクトを列挙できます。  これにより、他のビジュアル オブジェクトによって部分的または完全に隠されているものも含めて、すべてのビジュアル オブジェクトを識別することができます。  ビジュアル ツリーのビジュアル オブジェクトを列挙するには、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドとヒット テスト コールバック関数を使用します。  ヒット テスト コールバック関数は、指定した座標値がビジュアル オブジェクトに含まれる場合にシステムによって呼び出されます。  
+  
+ ヒット テストの結果の列挙時には、ビジュアル ツリーを変更する操作を実行しないでください。  走査中のビジュアル ツリーに対してオブジェクトの追加または削除を行うと、予測不可能な動作を招く可能性があります。  ビジュアル ツリーの変更は、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドが終了した後に安全に実行できます。  <xref:System.Collections.ArrayList> などのデータ構造体を提供して、ヒット テストの結果の列挙時に値を格納することもできます。  
+  
+ [!code-csharp[HitTestingOverview#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#101)]
+ [!code-vb[HitTestingOverview#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#101)]  
+  
+ ヒット テストのコールバック メソッドは、バーチャル ツリーの特定のビジュアル オブジェクトでヒット テストが識別されたときに、ユーザーが実行するアクションを定義します。  アクションを実行したら、引き続きその他のビジュアル オブジェクトを列挙するかどうかを決定する <xref:System.Windows.Media.HitTestResultBehavior> 値を返します。  
+  
+ [!code-csharp[HitTestingOverview#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#102)]
+ [!code-vb[HitTestingOverview#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#102)]  
+  
+> [!NOTE]
+>  ヒットしたビジュアル オブジェクトの列挙の順序は、[z オーダー](GTMT)順です。  [z オーダー](GTMT)の最上位のビジュアル オブジェクトが最初に列挙されます。  その他のビジュアル オブジェクトは、[z オーダー](GTMT)の上位から順に列挙されます。  この列挙の順序は、ビジュアルのレンダリング順序に対応します。  
+  
+ <xref:System.Windows.Media.HitTestResultBehavior> を返すことによって、ヒット テスト コールバック関数の任意の時点でビジュアル オブジェクトの列挙を停止できます。  
+  
+ [!code-csharp[HitTestingOverview#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#103)]
+ [!code-vb[HitTestingOverview#103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#103)]  
+  
+<a name="using_a_hit_test_filter_callback"></a>   
+## ヒット テスト フィルターのコールバックの使用  
+ オプションのヒット テスト フィルターを使用して、ヒット テストの結果に渡されるオブジェクトを制限できます。  これにより、ヒット テストの結果でビジュアル ツリーの一部を処理する必要がない場合、その部分を無視できます。  ヒット テスト フィルターを実装するには、ヒット テスト フィルターのコールバック関数を定義して、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを呼び出すときにパラメーター値として渡します。  
+  
+ [!code-csharp[HitTestingOverview#104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#104)]
+ [!code-vb[HitTestingOverview#104](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#104)]  
+  
+ オプションのヒット テスト フィルターのコールバック関数を指定しない場合は、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドに対してパラメーターとして `null` 値を渡します。  
+  
+ [!code-csharp[HitTestingOverview#105](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#105)]
+ [!code-vb[HitTestingOverview#105](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#105)]  
+  
+ ![ヒット テスト フィルターを使用したビジュアル ツリーの簡略化](../../../../docs/framework/wpf/graphics-multimedia/media/filteredvisualtree-01.png "FilteredVisualTree\_01")  
+ビジュアル ツリーから余分なものを取り除く  
+  
+ ヒット テスト フィルターのコールバック関数を使用すると、レンダリングされるコンテンツに指定した座標が含まれるすべてのビジュアルを列挙できます。  ただし、ヒット テストの結果のコールバック関数で、ビジュアル ツリーの一部の分岐を処理する必要がない場合、これらの分岐を無視できます。  ヒット テスト フィルターのコールバック関数の戻り値によって、ビジュアル オブジェクトの列挙体が実行するアクションの種類が決定されます。  たとえば、値 <xref:System.Windows.Media.HitTestFilterBehavior> を返した場合、ヒット テストの結果の列挙体から現在のビジュアル オブジェクトおよびその子を削除できます。  つまり、ヒット テストの結果のコールバック関数は、列挙体でこれらのオブジェクトを認識しなくなります。  オブジェクトのビジュアル ツリーから余分なものを取り除くと、ヒット テストの結果の列挙体が渡されるときの処理を減らすことができます。  次のコード例では、フィルターはラベルとその子孫をスキップし、他のすべてのヒット テストを行います。  
+  
+ [!code-csharp[HitTestingOverview#106](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#106)]
+ [!code-vb[HitTestingOverview#106](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#106)]  
+  
+> [!NOTE]
+>  ヒット テスト フィルターのコールバックは、ヒット テストの結果のコールバックが呼び出されない場合に呼び出されることがあります。  
+  
+<a name="overriding_default_hit_testing"></a>   
+## 既定のヒット テストのオーバーライド  
+ <xref:System.Windows.Media.Visual.HitTestCore%2A> メソッドをオーバーライドすることにより、ビジュアル オブジェクトの既定のヒット テストのサポートをオーバーライドできます。  つまり、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを呼び出すと、<xref:System.Windows.Media.Visual.HitTestCore%2A> のオーバーライドされた実装が呼び出されます。  座標がビジュアル オブジェクトのレンダリングされるコンテンツの外側にあっても、ビジュアル オブジェクトの外接する四角形内でヒット テストが実行されると、オーバーライドされたメソッドが呼び出されます。  
+  
+ [!code-csharp[HitTestingOverview#107](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#107)]
+ [!code-vb[HitTestingOverview#107](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#107)]  
+  
+ ビジュアル オブジェクトの外接する四角形とレンダリングされるコンテンツの両方に対してヒット テストを行う必要が生じる場合もあります。  オーバーライドされた <xref:System.Windows.Media.Visual.HitTestCore%2A> メソッドで `PointHitTestParameters` パラメーター値を基本メソッド <xref:System.Windows.Media.Visual.HitTestCore%2A> に対するパラメーターとして使用すると、ビジュアル オブジェクトの外接する四角形のヒットに基づいてアクションを実行し、ビジュアル オブジェクトのレンダリングされるコンテンツに対する 2 番目のヒット テストを実行することができます。  
+  
+ [!code-csharp[HitTestingOverview#108](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/Window1.xaml.cs#108)]
+ [!code-vb[HitTestingOverview#108](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/window1.xaml.vb#108)]  
+  
+## 参照  
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A>   
+ <xref:System.Windows.Media.HitTestResult>   
+ <xref:System.Windows.Media.HitTestResultCallback>   
+ <xref:System.Windows.Media.HitTestFilterCallback>   
+ <xref:System.Windows.UIElement.IsHitTestVisible%2A>   
+ [DrawingVisuals を使用したヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159994)   
+ [Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)   
+ [ビジュアル内のジオメトリのヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md)   
+ [Win32 ホスト コンテナーを使用してヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-a-win32-host-container.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md
new file mode 100644
index 00000000000..d2db5622022
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md
@@ -0,0 +1,30 @@
+---
+title: "方法 : アニメーションを加速または減速させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "加速 (アニメーションを)"
+  - "アニメーション, 加速"
+  - "アニメーション, 減速"
+  - "減速 (アニメーションを)"
+ms.assetid: 4f383b2c-f94d-4a4e-9a06-f56f5dae95f9
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : アニメーションを加速または減速させる
+この例では、時間と共にアニメーションを加速および減速させる方法を示します。  次の例では、<xref:System.Windows.Media.Animation.Timeline.AccelerationRatio%2A> 設定と <xref:System.Windows.Media.Animation.Timeline.DecelerationRatio%2A> 設定が異なるアニメーションによって、複数の四角形をアニメーション化します。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AccelDecelExample.xaml#1)]  
+  
+ この例では、コードは省略されています。  コード全体については、[アニメーションのタイミング動作のサンプル](http://go.microsoft.com/fwlink/?LinkID=159970)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md b/docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md
new file mode 100644
index 00000000000..831b390c392
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 反復サイクル中にアニメーション値を累積する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "累積 (反復サイクル中にアニメーション値を)"
+  - "アニメーション, 累積 (反復サイクル中に値を)"
+ms.assetid: 548df369-c7cc-4dab-b569-08b95ced2e7e
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : 反復サイクル中にアニメーション値を累積する
+この例では、<xref:System.Windows.Media.Animation.DoubleAnimation.IsCumulative%2A> プロパティを使用して、反復サイクル中にアニメーション値を累積する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.DoubleAnimation.IsCumulative%2A> プロパティを使用して、反復サイクル中にアニメーションの基本値を累積します。  たとえば、アニメーションを 9 回反復 \(<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> \= "9x"\) するように設定し、10 から 15 までアニメーション化する \(From \= 10 To \= 15\) ようにプロパティを設定した場合、プロパティは、最初のサイクルでは 10 から 15 まで、2 回目のサイクルでは 15 から 20 まで、3 回目のサイクルでは 20 から 25 までというようにアニメーション化します。  つまり、前のアニメーション サイクルの終了値が、各アニメーション サイクルの基本値として使用されることになります。  
+  
+ `IsCumulative` プロパティは、ほとんどの基本アニメーションとキー フレーム アプリケーションで使用できます。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」および「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」を参照してください。  
+  
+ 次の例では、4 つの四角形の幅をアニメーション化してこの動作を示します。  この例では、次の操作を実行します。  
+  
+-   <xref:System.Windows.Media.Animation.DoubleAnimation> で最初の四角形をアニメーション化し、<xref:System.Windows.Media.Animation.DoubleAnimation.IsCumulative%2A> プロパティを `true` に設定します。  
+  
+-   <xref:System.Windows.Media.Animation.DoubleAnimation> で 2 番目の四角形をアニメーション化し、<xref:System.Windows.Media.Animation.DoubleAnimation.IsCumulative%2A> プロパティを既定値の `false` に設定します。  
+  
+-   <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> で 3 番目の四角形をアニメーション化し、<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames.IsCumulative%2A> プロパティを `true` に設定します。  
+  
+-   <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> で最後の四角形をアニメーション化し、<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames.IsCumulative%2A> プロパティを `false` に設定します。  
+  
+ [!code-xml[timingbehaviors_snip#IsCumulativeWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/IsCumulativeExample.xaml#iscumulativewholepage)]  
+  
+## 参照  
+ [アニメーションの出力値をアニメーションの開始値に追加する](../../../../docs/framework/wpf/graphics-multimedia/how-to-add-an-animation-output-value-to-an-animation-starting-value.md)   
+ [アニメーションを反復する](../../../../docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-add-an-animation-output-value-to-an-animation-starting-value.md b/docs/framework/wpf/graphics-multimedia/how-to-add-an-animation-output-value-to-an-animation-starting-value.md
new file mode 100644
index 00000000000..69abc44b3e0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-add-an-animation-output-value-to-an-animation-starting-value.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : アニメーションの出力値をアニメーションの開始値に追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション"
+  - "IsAdditive プロパティ"
+ms.assetid: b89a82be-b03d-481e-a8d3-cc513d09ca00
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : アニメーションの出力値をアニメーションの開始値に追加する
+この例では、アニメーションの出力値をアニメーションの開始値に追加する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.DoubleAnimation.IsAdditive%2A> プロパティは、アニメーションの出力値を、アニメーション化するプロパティの開始値 \(基本値\) に追加するかどうかを指定します。  <xref:System.Windows.Media.Animation.DoubleAnimation.IsAdditive%2A> プロパティは、ほとんどの基本アニメーションとキー フレーム アプリケーションで使用できます。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」および「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.Animation.DoubleAnimation> で <xref:System.Windows.Media.Animation.DoubleAnimation.IsAdditive%2A?displayProperty=fullName> プロパティを使用した場合の効果、および <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> で <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames.IsAdditive%2A?displayProperty=fullName> プロパティを使用した場合の効果を次の例に示します。  
+  
+ [!code-xml[timingbehaviors_snip#IsAdditiveWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/IsAdditiveExample.xaml#isadditivewholepage)]  
+  
+## 参照  
+ [反復サイクル中にアニメーション値を累積する](../../../../docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-3-d-translations.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-3-d-translations.md
new file mode 100644
index 00000000000..4a39c7bf9a5
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-3-d-translations.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : 3-D 変換をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化"
+  - "アニメーション, 3-D 変換"
+ms.assetid: d4eece1f-0cd2-4a2c-8370-293354c380e4
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 3-D 変換をアニメーション化する
+ここでは、[!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] モデルで設定された平行移動変換をアニメーション化する方法を説明します。  
+  
+ 次のコードでは、<xref:System.Windows.Media.Media3D.TranslateTransform3D> オブジェクトを <xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.Model3D.Transform%2A> プロパティに適用しています。  
+  
+ [!code-xml[Animation3DGallery_snip#Translation3DAnimationInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Translation3DAnimationExample.xaml#translation3danimationinline1)]  
+  
+ この <xref:System.Windows.Media.Media3D.TranslateTransform3D> オブジェクトの <xref:System.Windows.Media.Media3D.TranslateTransform3D.OffsetX%2A> プロパティは、次のコードを使用してアニメーション化されます。  
+  
+ [!code-xml[Animation3DGallery_snip#Translation3DAnimationInline2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Translation3DAnimationExample.xaml#translation3danimationinline2)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[Animation3DGallery_snip#Translation3DAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Translation3DAnimationExample.xaml#translation3danimationexamplewholepage)]  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md
new file mode 100644
index 00000000000..131bc5e475d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : キー フレームを使用して 3-D 回転をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化, キー フレーム (Rotation3DAnimation) を使用"
+  - "アニメーション, 3-D 変換, キー フレーム (Rotation3DAnimation) を使用"
+  - "キー フレーム, Rotation3DAnimation"
+ms.assetid: 6f671b95-7f30-4836-9a4f-aeb7dc30121f
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : キー フレームを使用して 3-D 回転をアニメーション化する
+次の例では、<xref:System.Windows.Media.Animation.Rotation3DAnimationUsingKeyFrames> を使用し、回転の軸をアニメーション化することで "揺れている" ように見える 3D オブジェクトを回転させます。  このアニメーションでは、次のキー フレームを使用します。  
+  
+1.  <xref:System.Windows.Media.Animation.LinearRotation3DKeyFrame> は、値から値への滑らかで直線的な補間を作成するために使用します。  
+  
+2.  <xref:System.Windows.Media.Animation.DiscreteRotation3DKeyFrame> は、値から値への突然の "ジャンプ" \(補間なし\) を作成するために使用します。  
+  
+3.  <xref:System.Windows.Media.Animation.SplineRotation3DKeyFrame> は、<xref:System.Windows.Media.Animation.SplineRotation3DKeyFrame.KeySpline%2A> プロパティに従って、値から値への多様な遷移を作成するために使用します。  下の例で、この部分のアニメーションはゆっくりと始まりますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#Rotation3DAnimationUsingKeyFramesExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Rotation3DAnimationUsingKeyFramesExample.xaml#rotation3danimationusingkeyframesexamplewholepage)]  
+  
+## 参照  
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [ストーリーボードを使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md)   
+ [Rotation3DAnimation を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md)   
+ [四元数を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md)   
+ [キー フレーム \(QuaternionAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/animate-a-3-d-rotation-quaternionanimationusingkeyframes.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md
new file mode 100644
index 00000000000..771fe500c9c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 四元数を使用して 3-D 回転をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化, 四元数を使用"
+  - "アニメーション, 3-D 変換, 四元数を使用"
+  - "四元数"
+ms.assetid: adca9cb1-066b-4de8-abbb-6b4007579ee7
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 四元数を使用して 3-D 回転をアニメーション化する
+この例では、四元数を使用して 3\-D オブジェクトの回転をアニメーション化する方法を示します。  
+  
+ 次のコードでは、<xref:System.Windows.Media.Media3D.RotateTransform3D> の <xref:System.Windows.Media.Media3D.RotateTransform3D.Rotation%2A> プロパティの値として使用される <xref:System.Windows.Media.Media3D.QuaternionRotation3D> を示します。  
+  
+ [!code-xml[Animation3DGallery_snip#QuaternionAnimationExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/QuaternionAnimationExample.xaml#quaternionanimationexampleinline1)]  
+  
+ この <xref:System.Windows.Media.Media3D.QuaternionRotation3D> は、次のコードを使用して、<xref:System.Windows.Media.Animation.Storyboard> 内の <xref:System.Windows.Media.Animation.QuaternionAnimation> でアニメーション化されます。  
+  
+ [!code-xml[Animation3DGallery_snip#QuaternionAnimationExampleInline2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/QuaternionAnimationExample.xaml#quaternionanimationexampleinline2)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[Animation3DGallery_snip#QuaternionAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/QuaternionAnimationExample.xaml#quaternionanimationexamplewholepage)]  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [ストーリーボードを使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md)   
+ [Rotation3DAnimation を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md
new file mode 100644
index 00000000000..83d912b2dc4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : Rotation3DAnimation を使用して 3-D 回転をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化, Rotation3DAnimation を使用"
+  - "アニメーション, 3-D 変換, Rotation3DAnimation を使用"
+  - "Rotation3DAnimation"
+ms.assetid: a92223ec-b634-4f5e-8e79-d33bc43ecfb3
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : Rotation3DAnimation を使用して 3-D 回転をアニメーション化する
+<xref:System.Windows.Media.Animation.Rotation3DAnimation> を使用して、3D オブジェクトに適用される <xref:System.Windows.Media.Media3D.RotateTransform3D> オブジェクトの <xref:System.Windows.Media.Media3D.RotateTransform3D.Rotation%2A> プロパティをアニメーション化することで、"揺れている" 3D オブジェクトを回転させる方法を次の例に示します。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#Rotation3DAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Rotation3DAnimationExample.xaml#rotation3danimationexamplewholepage)]  
+  
+## 参照  
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [キー フレーム \(Rotation3DAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md)   
+ [ストーリーボードを使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md)   
+ [四元数を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-quaternions.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md
new file mode 100644
index 00000000000..bc77ee1ba3a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-storyboards.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : ストーリーボードを使用して 3-D 回転をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D 変換, アニメーション化, ストーリーボードで"
+  - "アニメーション, 3-D 変換, ストーリーボードで"
+  - "ストーリーボード"
+ms.assetid: 1020e44e-e21e-49a8-be53-53cbc1910e83
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ストーリーボードを使用して 3-D 回転をアニメーション化する
+<xref:System.Windows.Media.Media3D.AxisAngleRotation3D> オブジェクトの <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Angle%2A> プロパティと <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Axis%2A> プロパティをアニメーション化することで、"揺れている" 3D オブジェクトを回転させる方法を次の例に示します。  この <xref:System.Windows.Media.Media3D.AxisAngleRotation3D> オブジェクトは 3D オブジェクトの回転変換を指定しているため、そのプロパティをアニメーション化すると、目的の回転効果が作成されます。  ストーリーボード内では、<xref:System.Windows.Media.Animation.Vector3DAnimation> を使用して <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Axis%2A> プロパティをアニメーション化している間に、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用して <xref:System.Windows.Media.Media3D.AxisAngleRotation3D.Angle%2A> プロパティをアニメーション化します。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#Rotate3DUsingAxisAngleRotation3DExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/Rotat3DUsingAxisAngleRotation3DExample.xaml#rotate3dusingaxisanglerotation3dexamplewholepage)]  
+  
+## 参照  
+ [Rotation3DAnimation を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-rotation3danimation.md)   
+ [キー フレーム \(Rotation3DAnimationUsingKeyFrames\) を使用して 3\-D 回転をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-3-d-rotation-using-key-frames.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-boolean-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-boolean-by-using-key-frames.md
new file mode 100644
index 00000000000..9e8b0fce834
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-boolean-by-using-key-frames.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : キー フレームを使用してブール値をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ブール値 (キー フレームを使用してアニメーション化)"
+  - "ブール値, アニメーション化 (キー フレームを使用して)"
+  - "キー フレーム, アニメーション化 (ブール値を)"
+ms.assetid: 4b0fac96-6231-4fcf-9775-4dd673ddc785
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : キー フレームを使用してブール値をアニメーション化する
+この例では、<xref:System.Windows.Controls.Button> コントロールの Boolean プロパティ値をキー フレームを使用してアニメーション化する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.BooleanAnimationUsingKeyFrames> クラスを使用して、<xref:System.Windows.Controls.Button> コントロールの <xref:System.Windows.UIElement.IsEnabled%2A> プロパティをアニメーション化します。  この例のすべてのキー フレームでは、<xref:System.Windows.Media.Animation.DiscreteBooleanKeyFrame> クラスのインスタンスを使用します。  <xref:System.Windows.Media.Animation.DiscreteBooleanKeyFrame> のような不連続のキー フレームは、値間で突然のジャンプを作成します。つまり、アニメーションの動きはぎくしゃくしています。  
+  
+ [!code-csharp[keyframes_snip#BooleanAnimationUsingKeyFramesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/BooleanAnimationUsingKeyFramesExample.cs#booleananimationusingkeyframeswholepage)]
+ [!code-vb[keyframes_snip#BooleanAnimationUsingKeyFramesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/booleananimationusingkeyframesexample.vb#booleananimationusingkeyframeswholepage)]
+ [!code-xml[keyframes_snip#BooleanAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/BooleanAnimationUsingKeyFramesExample.xaml#booleananimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.BooleanAnimationUsingKeyFrames>   
+ <xref:System.Windows.UIElement.IsEnabled%2A>   
+ <xref:System.Windows.Controls.Button>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-double-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-double-by-using-key-frames.md
new file mode 100644
index 00000000000..97be75e1f13
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-double-by-using-key-frames.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : キー フレームを使用して Double 値をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, Double をキー フレームで"
+  - "倍精度, アニメーション化 (キー フレームを使用して)"
+  - "キー フレーム, アニメーション化 (Double を)"
+ms.assetid: 3a1a7dba-7694-4907-8a2f-3408baebfa82
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : キー フレームを使用して Double 値をアニメーション化する
+この例では、<xref:System.Double> を受け取るプロパティの値をキー フレームを使用してアニメーション化する方法について説明します。  
+  
+## 使用例  
+ 次の例では、画面を横切るように四角形を移動します。  この例では、<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> クラスを使用して、<xref:System.Windows.Shapes.Rectangle> に適用される <xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティをアニメーション化します。  無期限に繰り返すこのアニメーションでは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  最初の 3 秒間は、<xref:System.Windows.Media.Animation.LinearDoubleKeyFrame> クラスのインスタンスを使用して、開始位置からパスに沿って 500 の位置まで、一定の速度で四角形を移動します。  <xref:System.Windows.Media.Animation.LinearDoubleKeyFrame> のような線形キー フレームを使用すると、値の間に滑らかな線形トランジションが生成されます。  
+  
+2.  4 秒目の終わりに、<xref:System.Windows.Media.Animation.DiscreteDoubleKeyFrame> クラスのインスタンスを使用して、四角形を突然次の位置まで移動します。  <xref:System.Windows.Media.Animation.DiscreteDoubleKeyFrame> のような不連続キー フレームを使用すると、ある値から次の値へのジャンプが生成されます。  この例では、開始位置にあった四角形が突然 500 の位置に出現します。  
+  
+3.  最後の 2 秒間は、<xref:System.Windows.Media.Animation.SplineDoubleKeyFrame> クラスのインスタンスを使用して、四角形を開始位置まで戻します。  <xref:System.Windows.Media.Animation.SplineDoubleKeyFrame> のような[スプライン](GTMT) キー フレームでは、<xref:System.Windows.Media.Animation.SplineDoubleKeyFrame.KeySpline%2A> プロパティの値に従って、値の間に可変遷移が作成されます。  この例では、四角形の動きは最初はゆっくりしていますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+ [!code-csharp[keyframes_snip#AltDoubleAnimationUsingKeyFramesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/AltDoubleAnimationUsingKeyFramesExample.cs#altdoubleanimationusingkeyframeswholepage)]
+ [!code-vb[keyframes_snip#AltDoubleAnimationUsingKeyFramesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/altdoubleanimationusingkeyframesexample.vb#altdoubleanimationusingkeyframeswholepage)]
+ [!code-xml[keyframes_snip#AltDoubleAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/AltDoubleAnimationUsingKeyFramesExample.xaml#altdoubleanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+ 他のアニメーション例との一貫性を保つために、この例のコードでは、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用して <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> を適用しています。  ただし、コードで 1 つのアニメーションを適用する場合は、<xref:System.Windows.Media.Animation.Storyboard> よりも <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用する方が簡単です。  例については、「[ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames>   
+ <xref:System.Windows.Shapes.Rectangle>   
+ <xref:System.Windows.Media.Animation.LinearDoubleKeyFrame>   
+ <xref:System.Windows.Media.Animation.DiscreteDoubleKeyFrame>   
+ <xref:System.Windows.Media.Animation.SplineDoubleKeyFrame>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-matrix-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-matrix-by-using-key-frames.md
new file mode 100644
index 00000000000..1ff6a228a78
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-matrix-by-using-key-frames.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : キー フレームを使用して行列をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 行列プロパティをキー フレームで"
+  - "キー フレーム, アニメーション化 (行列プロパティを)"
+  - "行列プロパティ, アニメーション化 (キー フレームを使用して)"
+ms.assetid: b851a4c7-ecb1-420e-9203-83e7afd037fd
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : キー フレームを使用して行列をアニメーション化する
+次の例は、キー フレームを使用して <xref:System.Windows.Media.MatrixTransform> の <xref:System.Windows.Media.MatrixTransform.Matrix%2A> プロパティにアニメーションを適用する方法を示しています。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Media.Animation.MatrixAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Media.MatrixTransform> の <xref:System.Windows.Media.MatrixTransform.Matrix%2A> プロパティにアニメーションを適用しています。  この例では、<xref:System.Windows.Media.MatrixTransform> オブジェクトを使用して <xref:System.Windows.Controls.Button> の外観と位置を変換します。  
+  
+ このアニメーションでは、<xref:System.Windows.Media.Animation.DiscreteMatrixKeyFrame> クラスを使用して 2 つのキー フレームを作成し、そのキー フレームで次の処理を行います。  
+  
+1.  最初の 0.2 秒の間に、1 番目の <xref:System.Windows.Media.Matrix> をアニメーション化します。  この例では、<xref:System.Windows.Media.Matrix> の <xref:System.Windows.Media.Matrix.M11%2A> プロパティおよび <xref:System.Windows.Media.Matrix.M12%2A> プロパティを変更します。  この変更によって、ボタンは引き伸ばされ、傾斜します。  また、ここでは、<xref:System.Windows.Media.Matrix.OffsetX%2A> プロパティと <xref:System.Windows.Media.Matrix.OffsetY%2A> プロパティを変更することによって、ボタンの位置を変えます。  
+  
+2.  1.0 秒の時点で、2 番目の <xref:System.Windows.Media.Matrix> をアニメーション化します。  ボタンは、傾斜と引き伸ばしがなくなると同時に、別の位置に移動します。  
+  
+3.  このアニメーションを無制限に繰り返します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Animation.DiscreteMatrixKeyFrame> オブジェクトから派生するキー フレームは、値間で突然のジャンプを作成します。つまり、アニメーションの動きはぎくしゃくしています。  
+  
+ [!code-xml[keyframes_snip#MatrixAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/MatrixAnimationUsingKeyFramesExample.xaml#matrixanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.MatrixTransform.Matrix%2A>   
+ <xref:System.Windows.Media.MatrixTransform>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-point-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-point-by-using-key-frames.md
new file mode 100644
index 00000000000..da5a6455b5b
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-point-by-using-key-frames.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : キー フレームを使用して点をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 点をキー フレームで"
+  - "キー フレーム, アニメーション化 (点を)"
+  - "点, アニメーション化 (キー フレームを使用して)"
+ms.assetid: d2e2ef10-0773-4133-856e-d41c09f60ded
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : キー フレームを使用して点をアニメーション化する
+<xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Point> をアニメーション化する方法を次の例に示します。  
+  
+## 使用例  
+ 次の例では、三角形のパスに沿って楕円を移動します。  この例では、<xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Media.EllipseGeometry> の <xref:System.Windows.Media.EllipseGeometry.Center%2A> プロパティをアニメーション化します。  このアニメーションは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  最初の 0.5 秒間は、<xref:System.Windows.Media.Animation.LinearPointKeyFrame> クラスのインスタンスを使用して、開始位置から一定の速度で、パスに沿って楕円を移動します。  <xref:System.Windows.Media.Animation.LinearPointKeyFrame> のようなリニア キー フレームは、値間の滑らかな線形補間を作成します。  
+  
+2.  次の 0.5 秒間の終わりには、<xref:System.Windows.Media.Animation.DiscretePointKeyFrame> クラスのインスタンスを使用して、楕円をパスに沿って次の位置にいきなり移動します。  <xref:System.Windows.Media.Animation.DiscretePointKeyFrame> のような不連続キー フレームを使用すると、ある値から次の値へのジャンプが生成されます。  
+  
+3.  最後の 2 秒間は、<xref:System.Windows.Media.Animation.SplinePointKeyFrame> クラスのインスタンスを使用して、楕円を開始位置まで戻します。  <xref:System.Windows.Media.Animation.SplinePointKeyFrame> のような[スプライン](GTMT) キー フレームでは、<xref:System.Windows.Media.Animation.SplinePointKeyFrame.KeySpline%2A> プロパティの値に従って、値間の可変遷移が作成されます。  この例では、アニメーションは最初はゆっくりしていますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+ [!code-csharp[keyframes_snip#PointAnimationUsingKeyFramesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/PointAnimationUsingKeyFramesExample.cs#pointanimationusingkeyframeswholepage)]
+ [!code-vb[keyframes_snip#PointAnimationUsingKeyFramesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/pointanimationusingkeyframesexample.vb#pointanimationusingkeyframeswholepage)]
+ [!code-xml[keyframes_snip#PointAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/PointAnimationUsingKeyFramesExample.xaml#pointanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+ 他のアニメーション例との一貫性を保つために、この例のコードでは、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用して <xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames> を適用しています。  ただし、コードで 1 つのアニメーションを適用する場合は、<xref:System.Windows.Media.Animation.Storyboard> よりも <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用する方が簡単です。  例については、「[ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames>   
+ <xref:System.Windows.Media.EllipseGeometry.Center%2A?displayProperty=fullName>   
+ <xref:System.Windows.Media.EllipseGeometry>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md
new file mode 100644
index 00000000000..c4642fa657a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ストーリーボードを使ってプロパティをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ストーリーボード"
+  - "ストーリーボード, アニメーション"
+ms.assetid: f4a314e9-1da2-4367-85fc-1232487efa7a
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ストーリーボードを使ってプロパティをアニメーション化する
+この例では、<xref:System.Windows.Media.Animation.Storyboard> を使用してプロパティをアニメーション化する方法を示します。  <xref:System.Windows.Media.Animation.Storyboard> を使用してプロパティをアニメーション化するには、アニメーション化する各プロパティのアニメーションを作成し、アニメーションを格納する <xref:System.Windows.Media.Animation.Storyboard> も作成します。  
+  
+ プロパティの型によって、使用するアニメーションの型が決まります。  たとえば、<xref:System.Double> 値を受け取るプロパティをアニメーション化するには、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用します。  <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> および <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A> [添付プロパティ](GTMT)は、アニメーションを適用するオブジェクトとプロパティを指定します。  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] でストーリーボードを開始するには、<xref:System.Windows.Media.Animation.BeginStoryboard> アクションと <xref:System.Windows.EventTrigger> を使用します。  <xref:System.Windows.EventTrigger.RoutedEvent%2A> プロパティで指定されているイベントが発生すると、<xref:System.Windows.EventTrigger> は <xref:System.Windows.Media.Animation.BeginStoryboard> アクションを開始します。  <xref:System.Windows.Media.Animation.BeginStoryboard> アクションは <xref:System.Windows.Media.Animation.Storyboard> を開始します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用して、2 つの <xref:System.Windows.Controls.Button> コントロールをアニメーション化します。  最初のボタンのサイズを変更するため、<xref:System.Windows.FrameworkElement.Width%2A> をアニメーション化します。  2 番目のボタンの色を変更するため、<xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティを使用して、アニメーション化するボタンの <xref:System.Windows.Controls.Control.Background%2A> を設定します。  
+  
+## 使用例  
+ [!code-xml[AnimatePropertyStoryboards#1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/AnimatePropertyStoryboards/XAML/StoryboardExample.xaml#1)]  
+  
+> [!NOTE]
+>  アニメーションは、<xref:System.Windows.Controls.Control> や <xref:System.Windows.Controls.Panel> などの <xref:System.Windows.FrameworkElement> オブジェクトと、<xref:System.Windows.Media.Brush> や <xref:System.Windows.Media.Transform> などの <xref:System.Windows.Freezable> オブジェクトの両方を対象にできますが、<xref:System.Windows.FrameworkElement.Name%2A> プロパティを持っているのはフレームワーク要素だけです。  名前をフリーズ可能オブジェクトに割り当てて、アニメーションの対象にできるようにするには、前の例で示したように [x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)を使用します。  
+  
+ コードを使用する場合は、<xref:System.Windows.FrameworkElement> に <xref:System.Windows.NameScope> を作成し、アニメーション化するオブジェクトの名前をその <xref:System.Windows.FrameworkElement> に登録します。  コードでアニメーションを開始するには、<xref:System.Windows.EventTrigger> で <xref:System.Windows.Media.Animation.BeginStoryboard> アクションを使用します。  必要に応じて、イベント ハンドラーと <xref:System.Windows.Media.Animation.Storyboard> の <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用できます。  <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用する方法の例を次に示します。  
+  
+ [!code-csharp[AnimatePropertyStoryboards#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/AnimatePropertyStoryboards/CSharp/StoryboardExample.cs#11)]
+ [!code-vb[AnimatePropertyStoryboards#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/AnimatePropertyStoryboards/VisualBasic/StoryboardExample.vb#11)]  
+  
+ アニメーションとストーリーボードの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ コードを使用する場合、プロパティをアニメーション化する方法は <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用するものだけではありません。  使用例を含む詳細については、「[ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)」および「[AnimationClock を使用してプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md
new file mode 100644
index 00000000000..7e82f3b8cef
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : AnimationClock を使用してプロパティをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, プロパティ, AnimationClock を使用"
+  - "AnimationClock"
+ms.assetid: e6542021-714c-4675-9567-04f1c7380834
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : AnimationClock を使用してプロパティをアニメーション化する
+この例では、<xref:System.Windows.Media.Animation.Clock> オブジェクトを使用してプロパティをアニメーション化する方法を説明します。  
+  
+ [依存関係プロパティ](GTMT)をアニメーション化するには次の 3 つの方法があります。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline> を作成し、<xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーション化するプロパティに関連付ける。  
+  
+-   オブジェクトの <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用して、1 つの <xref:System.Windows.Media.Animation.AnimationTimeline> をターゲット プロパティに適用する。  
+  
+-   <xref:System.Windows.Media.Animation.AnimationTimeline> から <xref:System.Windows.Media.Animation.AnimationClock> を作成してプロパティに適用する。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトおよび <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用すると、クロックを直接作成または配布しなくても、プロパティをアニメーション化できます \(例については、「[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)」および「[ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)」を参照してください\)。つまり、クロックは自動的に作成および配布されます。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.AnimationClock> を作成し、2 つの類似するプロパティにこれを適用する方法を次の例に示します。  
+  
+ [!code-csharp[timingbehaviors_procedural_snip#GraphicsMMCreateAnimationClockWholeClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_procedural_snip/CSharp/AnimationClockExample.cs#graphicsmmcreateanimationclockwholeclass)]
+ [!code-vb[timingbehaviors_procedural_snip#GraphicsMMCreateAnimationClockWholeClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_procedural_snip/visualbasic/animationclockexample.vb#graphicsmmcreateanimationclockwholeclass)]  
+  
+ <xref:System.Windows.Media.Animation.Clock> の開始後にこれを対話的に制御する方法の例については、「[クロックを対話的に制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-interactively-control-a-clock.md)」を参照してください。  
+  
+## 参照  
+ [ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)   
+ [ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md
new file mode 100644
index 00000000000..1a362c1949a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : ストーリーボードを使用せずにプロパティをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 非ストーリーボード (ローカル)"
+  - "ローカル アニメーション"
+  - "非ストーリーボード アニメーション"
+ms.assetid: d411db70-4df7-487d-82bc-95a7c1b2e7f8
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : ストーリーボードを使用せずにプロパティをアニメーション化する
+この例では、<xref:System.Windows.Media.Animation.Storyboard> を使用せずにアニメーションをプロパティに適用する方法を示します。  
+  
+> [!NOTE]
+>  この機能は [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では使用できません。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でプロパティをアニメーション化する方法については、「[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)」を参照してください。  
+  
+ ローカル アニメーションをプロパティに適用するには、<xref:System.Windows.UIElement.BeginAnimation%2A> メソッドを使用します。  このメソッドは 2 つのパラメーターを受け取ります。1 つはアニメーション化するプロパティを指定する <xref:System.Windows.DependencyProperty> で、もう 1 つはプロパティに適用するアニメーションです。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.Button> の幅および背景色をアニメーション化する方法を次の例に示します。  
+  
+ [!code-cpp[animateproperty#11](../../../../samples/snippets/cpp/VS_Snippets_Wpf/animateproperty/CPP/LocalAnimationExample.cpp#11)]
+ [!code-csharp[animateproperty#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animateproperty/CSharp/LocalAnimationExample.cs#11)]
+ [!code-vb[animateproperty#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animateproperty/VisualBasic/LocalAnimationExample.vb#11)]  
+  
+ <xref:System.Windows.Media.Animation> 名前空間には、さまざまな種類のプロパティをアニメーション化するためのさまざまなアニメーション クラスがあります。  プロパティのアニメーション化の詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  [依存関係プロパティ](GTMT) \(これらの例に示されているプロパティの種類\) とその機能の詳細については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用せずにアニメーション化する方法は他にもあります。詳細については、「[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.AnimationTimeline>   
+ <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A>   
+ <xref:System.Windows.Media.Animation>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle-geometry-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle-geometry-by-using-key-frames.md
new file mode 100644
index 00000000000..60fc66f08d3
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle-geometry-by-using-key-frames.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : キー フレームを使用して四角形のジオメトリをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, アニメーション化 (キー フレームで RectangleGeometry オブジェクトを)"
+  - "キー フレーム, アニメーション化 (RectangleGeometry オブジェクトを)"
+  - "RectangleGeometry オブジェクト, アニメーション化 (キー フレームを使用して)"
+ms.assetid: a8b45ceb-0e32-4ba1-928f-df6d30db17c6
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : キー フレームを使用して四角形のジオメトリをアニメーション化する
+次の例は、キー フレームを使用して <xref:System.Windows.Media.RectangleGeometry> の <xref:System.Windows.Media.RectangleGeometry.Rect%2A> プロパティにアニメーションを適用する方法を示しています。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Media.Animation.RectAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Media.RectangleGeometry> の <xref:System.Windows.Media.RectangleGeometry.Rect%2A> プロパティにアニメーションを適用しています。  このアニメーションは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  最初の 2 秒間では、<xref:System.Windows.Media.Animation.LinearRectKeyFrame> クラスのインスタンスを使用して、四角形の位置、幅、および高さが徐々に変化する様子をアニメーション化します。  <xref:System.Windows.Media.Animation.LinearRectKeyFrame> のような線形キー フレームを使用すると、値の間に滑らかな線形トランジションが生成されます。  
+  
+2.  次の 0.5 秒間の終わりには、<xref:System.Windows.Media.Animation.DiscreteRectKeyFrame> クラスのインスタンスを使用して、四角形の高さを突然低くします。  <xref:System.Windows.Media.Animation.DiscreteRectKeyFrame> のような不連続のキー フレームは、値間で突然の変化を作成します。つまり、高さの減少は短時間で発生し、滑らかではありません。  
+  
+3.  最後の 2 秒間では、<xref:System.Windows.Media.Animation.SplineRectKeyFrame> クラスのインスタンスを使用して、四角形を元のサイズと位置に戻します。  <xref:System.Windows.Media.Animation.SplineRectKeyFrame> のような[スプライン](GTMT) キー フレームでは、<xref:System.Windows.Media.Animation.SplineRectKeyFrame.KeySpline%2A> プロパティの値に従って、値の間に可変遷移が作成されます。  この例では、変化は最初はゆっくりしていますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+ [!code-csharp[keyframes_snip#RectAnimationUsingKeyFramesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/RectAnimationUsingKeyFramesExample.cs#rectanimationusingkeyframeswholepage)]
+ [!code-vb[keyframes_snip#RectAnimationUsingKeyFramesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/rectanimationusingkeyframesexample.vb#rectanimationusingkeyframeswholepage)]
+ [!code-xml[keyframes_snip#RectAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/RectAnimationUsingKeyFramesExample.xaml#rectanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.RectangleGeometry>   
+ <xref:System.Windows.Media.RectangleGeometry.Rect%2A>   
+ <xref:System.Windows.Media.Animation.RectAnimationUsingKeyFrames>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle.md
new file mode 100644
index 00000000000..fed36a3f9bb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 四角形をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 四角形"
+  - "四角形, アニメーション化"
+ms.assetid: 572ffb95-790d-4ace-adbf-b2ea8a90e75b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 四角形をアニメーション化する
+この例では、四角形のサイズと位置の変化をアニメーション化する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.RectAnimation> クラスのインスタンスを使用して、<xref:System.Windows.Media.RectangleGeometry> の <xref:System.Windows.Media.RectangleGeometry.Rect%2A> プロパティをアニメーション化し、四角形のサイズと位置の変化をアニメーション化します。  
+  
+ [!code-csharp[BasicAnimations_snip#RectAnimationWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BasicAnimations_snip/CSharp/RectAnimationExample.cs#rectanimationwholepage)]
+ [!code-vb[BasicAnimations_snip#RectAnimationWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BasicAnimations_snip/VisualBasic/RectAnimationExample.vb#rectanimationwholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.RectAnimation>   
+ <xref:System.Windows.Media.RectangleGeometry.Rect%2A>   
+ <xref:System.Windows.Media.RectangleGeometry>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-a-string-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-string-by-using-key-frames.md
new file mode 100644
index 00000000000..97192d6ad27
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-a-string-by-using-key-frames.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : キー フレームを使用して文字列をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 文字列をキー フレームで"
+  - "キー フレーム, アニメーション化 (文字列を)"
+  - "文字列, アニメーション化 (キー フレームを使用して)"
+ms.assetid: c62bc9fd-c09a-4227-bce0-0a1ab82049dd
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : キー フレームを使用して文字列をアニメーション化する
+この例では、文字列 \(この例では <xref:System.Windows.Controls.Button> コントロールの <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティ\) をキー フレームを使用してアニメーション化する方法について説明します。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Media.Animation.StringAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティにアニメーションを適用しています。  
+  
+ キー フレームを使用して作成する文字列のアニメーションでは不連続のキー フレームしか使用できないため、この例のすべてのキー フレームでは、<xref:System.Windows.Media.Animation.DiscreteStringKeyFrame> クラスのインスタンスを使用します。  <xref:System.Windows.Media.Animation.DiscreteStringKeyFrame> のような不連続のキー フレームは、値間で突然のジャンプを作成します。つまり、アニメーションの変化は短時間で発生し、滑らかではありません。  
+  
+ [!code-xml[keyframes_snip#StringAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/StringAnimationUsingKeyFramesExample.xaml#stringanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.StringAnimationUsingKeyFrames>   
+ <xref:System.Windows.Controls.ContentControl.Content%2A>   
+ <xref:System.Windows.Controls.Button>   
+ <xref:System.Windows.Media.Animation.DiscreteStringKeyFrame>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-an-ellipsegeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-ellipsegeometry.md
new file mode 100644
index 00000000000..d726a86ce8c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-ellipsegeometry.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : EllipseGeometry をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション、EllipseGeometry オブジェクト"
+  - "EllipseGeometry オブジェクトをアニメーション化します。"
+  - "グラフィックス [WPF] アニメーション"
+ms.assetid: 767b9b6e-9cb7-482e-b6c2-fee7750c3995
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : EllipseGeometry をアニメーション化する
+この例では、アニメーション化する、 <xref:System.Windows.Media.Geometry>内で、<xref:System.Windows.Shapes.Path>要素。 次の例では、 <xref:System.Windows.Media.Animation.PointAnimation>をアニメーション化するために使用、 <xref:System.Windows.Media.EllipseGeometry.Center%2A>の<xref:System.Windows.Media.EllipseGeometry>します。  
+  
+## <a name="example"></a>例  
+ [!code-xml[animatepath_snip_XAML#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animatepath_snip_XAML/CS/EllipseGeometryExample.xaml#1)]  
+  
+ [!code-csharp[animatepath_snip#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animatepath_snip/CSharp/EllipseGeometryExample.cs#101)]  
+  
+ [!code-vb[animatepath_snip#201](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animatepath_snip/VisualBasic/EllipseGeometryExample.vb#201)]  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-double-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-double-animation.md
new file mode 100644
index 00000000000..33e4f853cd7
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-double-animation.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : パスに沿ってオブジェクトをアニメーション化する (ダブル アニメーション) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション オブジェクトをパスに沿って (ダブル アニメーション)"
+  - "ダブル アニメーション"
+ms.assetid: 5a3c4a99-f303-42ad-a52a-e4794bb1798e
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : パスに沿ってオブジェクトをアニメーション化する (ダブル アニメーション)
+この例では、使用して、 <xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>クラスで定義されているパスに沿ってオブジェクトを移動する、 <xref:System.Windows.Media.PathGeometry>します。  
+  
+## <a name="example"></a>例  
+ 次の例を使用して&2; つ<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>ジオメトリック パスに沿った四角形を移動するオブジェクト。  
+  
+-   最初の<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>をアニメーション化、 <xref:System.Windows.Media.TranslateTransform.X%2A>の<xref:System.Windows.Media.TranslateTransform>四角形に適用します。 パスに沿って水平方向に移動する四角形を使用して行えます。  
+  
+-   2 番目<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>をアニメーション化、 <xref:System.Windows.Media.TranslateTransform.Y%2A>の<xref:System.Windows.Media.TranslateTransform>四角形に適用します。 ほうが四角形パスに沿った垂直方向に移動をします。  
+  
+ [!code-xml[PathAnimationGallery_snippet#DoubleAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/doubleanimationusingpathexample.xaml#doubleanimationusingpathwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#DoubleAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/DoubleAnimationUsingPathExample.cs#doubleanimationusingpathwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#DoubleAnimationUsingPathWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/DoubleAnimationUsingPathExample.vb#doubleanimationusingpathwholepage)]  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。  
+  
+ ジオメトリック パスを使用してオブジェクトを移動する別の方法を使用して、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>オブジェクトです。 例については、次を参照してください。[オブジェクト上のパス (行列アニメーション) をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md
new file mode 100644
index 00000000000..d26e03003ec
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : パスに沿ってオブジェクトをアニメーション化する (行列アニメーション) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション オブジェクトをパスに沿って (行列アニメーション)"
+  - "行列アニメーション"
+ms.assetid: 7000e697-1414-468c-b915-cf66062fc49e
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : パスに沿ってオブジェクトをアニメーション化する (行列アニメーション)
+この例では、使用して、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>で定義されているパスに沿ってオブジェクトをアニメーション化するクラス、 <xref:System.Windows.Media.PathGeometry>します。  
+  
+## <a name="example"></a>例  
+ 次の例では、次の手順に従ってパスに沿ってオブジェクトをアニメーション化します。  
+  
+-   適用される、 <xref:System.Windows.Media.MatrixTransform>に移動するためにオブジェクトにします。  
+  
+-   使用してパスを定義、 <xref:System.Windows.Media.PathGeometry>します。  
+  
+-   作成、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>オブジェクトをアニメーション化を使用して、<xref:System.Windows.Media.Matrix>のプロパティ、 <xref:System.Windows.Media.MatrixTransform>します。 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>は、 <xref:System.Windows.Media.PathGeometry>し使用して生成<xref:System.Windows.Media.Matrix>値。  
+  
+ [!code-xml[PathAnimationGallery_snippet#MatrixAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/matrixanimationusingpathexample.xaml#matrixanimationusingpathwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/MatrixAnimationUsingPathExample.cs#matrixanimationusingpathwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/MatrixAnimationUsingPathExample.vb#matrixanimationusingpathwholepage)]  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。 ジオメトリック パスの詳細については、次を参照してください。、[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation.md
new file mode 100644
index 00000000000..2bc557752d4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : パスに沿ってオブジェクトをアニメーション化する (ポイント アニメーション) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション オブジェクトをパスに沿って (ポイント アニメーション)"
+  - "ポイント アニメーション"
+ms.assetid: 1fa3f817-35bc-41a1-b366-f5a20b70da0c
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : パスに沿ってオブジェクトをアニメーション化する (ポイント アニメーション)
+この例では、使用、 <xref:System.Windows.Media.Animation.PointAnimationUsingPath>アニメーション化するオブジェクト、<xref:System.Windows.Point>曲線のパスに沿ったします。  
+  
+## <a name="example"></a>例  
+ 次の例では移動、 <xref:System.Windows.Media.EllipseGeometry>によって定義されたパスに沿った、 <xref:System.Windows.Media.PathGeometry>します。 楕円ジオメトリの<xref:System.Windows.Media.EllipseGeometry.Center%2A>プロパティを<xref:System.Windows.Point>値してアニメーション化する楕円ジオメトリを移動する位置を指定するには、その<xref:System.Windows.Media.EllipseGeometry.Center%2A>プロパティです。 例では、 <xref:System.Windows.Media.Animation.PointAnimationUsingPath>をアニメーション化する、 <xref:System.Windows.Media.EllipseGeometry>オブジェクトの<xref:System.Windows.Media.EllipseGeometry.Center%2A>プロパティです。  
+  
+ [!code-xml[PathAnimationGallery_snippet#PointAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/pointanimationusingpathexample.xaml#pointanimationusingpathwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#PointAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/PointAnimationUsingPathExample.cs#pointanimationusingpathwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#PointAnimationUsingPathWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/PointAnimationUsingPathExample.vb#pointanimationusingpathwholepage)]  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。  
+  
+ 使用前の例のコードのバージョン、<xref:System.Windows.Media.Animation.Storyboard>をアニメーション化する、 <xref:System.Windows.Media.EllipseGeometry>1 つだけのアニメーションが適用された場合でも、します。 A<xref:System.Windows.Media.Animation.Storyboard>同じによってこれらのアニメーションを制御できるため、複数のアニメーションを適用する最も簡単な方法は、多くの場合、<xref:System.Windows.Media.Animation.Storyboard>します。 ただし、簡単にコードを使用する場合は、1 つのアニメーションをプロパティに適用する方法が使用するは、 <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A>メソッドです。 例については、次を参照してください。[プロパティなしを使用して、ストーリー ボード アニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-by-using-key-frames.md
new file mode 100644
index 00000000000..6065adab5b2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-by-using-key-frames.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : キー フレームを使用してオブジェクトをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, オブジェクトをキー フレームで"
+  - "キー フレーム, アニメーション化 (オブジェクトを)"
+ms.assetid: b1f15ba9-cac7-4cea-8699-5c6b55c05c5e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : キー フレームを使用してオブジェクトをアニメーション化する
+この例では、<xref:System.Windows.Controls.Page> コントロールの <xref:System.Windows.Controls.Page.Background%2A> プロパティであるオブジェクトを、キー フレームを使用してアニメーション化する方法について説明します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> クラスを使用して、<xref:System.Windows.Controls.Page> コントロールの <xref:System.Windows.Controls.Page.Background%2A> プロパティの色の変更をアニメーション化します。  この例のアニメーションは、別の背景ブラシに定期的に変化します。  このアニメーションは、<xref:System.Windows.Media.Animation.DiscreteObjectKeyFrame> クラスを使用して 3 つの異なるキー フレームを作成します。  次の方法でキー フレームを使用します。  
+  
+1.  最初の 1 秒間の終わりに、<xref:System.Windows.Media.LinearGradientBrush> クラスのインスタンスをアニメーション化します。  このセクションでは、線形グラデーションを背景色に適用して、その色を黄色からオレンジ、赤へと変化させます。  
+  
+2.  2 秒目の終わりに、<xref:System.Windows.Media.RadialGradientBrush> クラスのインスタンスをアニメーション化します。  このセクションでは、放射状グラデーションを背景色に適用して、その色を白から青、黒へと変化させます。  
+  
+3.  3 秒目の終わりに、<xref:System.Windows.Media.DrawingBrush> クラスのインスタンスをアニメーション化します。  このセクションでは、背景に市松模様を適用します。  
+  
+4.  アニメーションが再度始まり、無制限に繰り返します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Animation.DiscreteObjectKeyFrame> は、<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames> クラスで使用できるキー フレームの唯一の型です。  <xref:System.Windows.Media.Animation.DiscreteObjectKeyFrame> のようなキー フレームは、値の突然の変化を作成するので、この例での色の変化は突然起こります。  
+  
+ [!code-xml[keyframes_snip#ObjectAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/ObjectAnimationUsingKeyFramesExample.xaml#objectanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames>   
+ <xref:System.Windows.Controls.Page.Background%2A>   
+ <xref:System.Windows.Controls.Page>   
+ <xref:System.Windows.Media.Animation.DiscreteObjectKeyFrame>   
+ <xref:System.Windows.Media.LinearGradientBrush>   
+ <xref:System.Windows.Media.RadialGradientBrush>   
+ <xref:System.Windows.Media.DrawingBrush>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-in-a-3d-scene.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-in-a-3d-scene.md
new file mode 100644
index 00000000000..72716bfd4b2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-in-a-3d-scene.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : 3D シーンでカメラの位置および方向をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D シーン, アニメーション化 (カメラの方向を)"
+  - "3-D シーン, アニメーション化 (カメラの位置を)"
+  - "アニメーション, カメラの方向 (3-D シーンでの)"
+  - "アニメーション, カメラの位置 (3-D シーンでの)"
+  - "カメラの方向, アニメーション化 (3-D シーンでの)"
+  - "カメラの位置, アニメーション化 (3-D シーンでの)"
+ms.assetid: 480224b7-a5e5-4165-ba7f-ef760ddff94a
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : 3D シーンでカメラの位置および方向をアニメーション化する
+3D シーンでカメラの位置およびカメラが向いている方向をアニメーション化する方法を次の例に示します。  そのためには、<xref:System.Windows.Media.Animation.Point3DAnimation> と <xref:System.Windows.Media.Animation.Vector3DAnimation> を使用して、<xref:System.Windows.Media.Media3D.PerspectiveCamera> の <xref:System.Windows.Media.Media3D.ProjectionCamera.Position%2A> プロパティと <xref:System.Windows.Media.Media3D.ProjectionCamera.LookDirection%2A> プロパティをそれぞれアニメーション化します。  この種のアニメーションは、イベントに対応して観察者が目にするシーンを変更するような場合に使用します。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#PointVector3DAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/PointVector3DAnimationExample.xaml#pointvector3danimationexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.Vector3DAnimation>   
+ <xref:System.Windows.Media.Animation.Point3DAnimation>   
+ [キー フレームを使用してカメラの位置および方向をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-using-key-frames.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-using-key-frames.md
new file mode 100644
index 00000000000..87ba9ba50de
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-using-key-frames.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : キー フレームを使用してカメラの位置および方向をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, カメラの方向をキー フレームで"
+  - "アニメーション, カメラの位置をキー フレームで"
+  - "カメラの方向, アニメーション化 (キー フレームを使用して)"
+  - "カメラの位置, アニメーション化 (キー フレームを使用して)"
+  - "キー フレーム, アニメーション化 (カメラの方向を)"
+  - "キー フレーム, アニメーション化 (カメラの位置を)"
+ms.assetid: 5753024e-0057-454d-947f-43ea686879c7
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : キー フレームを使用してカメラの位置および方向をアニメーション化する
+次の例では、3D シーンでの <xref:System.Windows.Media.Media3D.PerspectiveCamera> の位置をアニメーション化するために <xref:System.Windows.Media.Animation.Point3DAnimationUsingKeyFrames> を使用しています。  また、3D シーンでカメラが向いている方向をアニメーション化するために <xref:System.Windows.Media.Animation.Vector3DAnimationUsingKeyFrames> を使用しています。  どちらのアニメーションでも、一連のアニメーション効果を作成する複数のキー フレームを使用しています。  
+  
+1.  <xref:System.Windows.Media.Animation.LinearPoint3DKeyFrame> および <xref:System.Windows.Media.Animation.LinearVector3DKeyFrame> は、値間の滑らかな線形補間を作成するために使用します。  
+  
+2.  <xref:System.Windows.Media.Animation.DiscretePoint3DKeyFrame> および <xref:System.Windows.Media.Animation.DiscreteVector3DKeyFrame> は、値間での突然の "ジャンプ" \(補間なし\) を作成するために使用します。  
+  
+3.  <xref:System.Windows.Media.Animation.SplinePoint3DKeyFrame> および <xref:System.Windows.Media.Animation.SplineVector3DKeyFrame> は、<xref:System.Windows.Media.Animation.SplinePoint3DKeyFrame.KeySpline%2A> プロパティに従って、値間の可変遷移を作成するために使用します。  次の例では、アニメーションはゆっくりと始まりますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+## 使用例  
+ [!code-xml[Animation3DGallery_snip#PointVector3DAnimationUsingKeyFramesExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/PointVector3DAnimationUsingKeyFramesExample.xaml#pointvector3danimationusingkeyframesexamplewholepage)]  
+  
+## 参照  
+ [3D シーンでカメラの位置および方向をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-camera-position-and-direction-in-a-3d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-color-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-color-by-using-key-frames.md
new file mode 100644
index 00000000000..57c5db5c5ac
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-color-by-using-key-frames.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : キー フレームを使用して色をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 色をキー フレームで"
+  - "色, アニメーション化 (キー フレームを使用して)"
+  - "キー フレーム, アニメーション化 (色を)"
+ms.assetid: ab04ffa6-4de9-4d5b-a3b4-4e35d5b2ef35
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : キー フレームを使用して色をアニメーション化する
+次の例は、キー フレームを使用して <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> をアニメーション化する方法を示しています。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Media.Animation.ColorAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティにアニメーションを適用しています。  このアニメーションは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  最初の 2 秒間は、<xref:System.Windows.Media.Animation.LinearColorKeyFrame> クラスのインスタンスを使用して、緑から赤へ徐々に色を変更します。  <xref:System.Windows.Media.Animation.LinearColorKeyFrame> のような線形キー フレームを使用すると、値の間に滑らかな線形トランジションが生成されます。  
+  
+2.  次の 0.5 秒間の終わりには、<xref:System.Windows.Media.Animation.DiscreteColorKeyFrame> クラスのインスタンスを使用して、赤から黄色へすばやく色を変更します。  <xref:System.Windows.Media.Animation.DiscreteColorKeyFrame> のような不連続のキー フレームは、値間で突然の変化を作成します。つまり、この部分のアニメーションの色の変化は短時間で発生し、滑らかではありません。  
+  
+3.  最後の 2 秒間は、<xref:System.Windows.Media.Animation.SplineColorKeyFrame> クラスのインスタンスを使用して、色を再度変更します \(この例では黄色から緑へ戻ります\)。  <xref:System.Windows.Media.Animation.SplineColorKeyFrame> のような[スプライン](GTMT) キー フレームでは、<xref:System.Windows.Media.Animation.SplineColorKeyFrame.KeySpline%2A> プロパティの値に従って、値の間に可変遷移が作成されます。  この例では、色の変化は最初はゆっくりと進行しますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+ [!code-csharp[keyframes_snip#ColorAnimationUsingKeyFramesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/ColorAnimationUsingKeyFramesExample.cs#coloranimationusingkeyframeswholepage)]
+ [!code-vb[keyframes_snip#ColorAnimationUsingKeyFramesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/coloranimationusingkeyframesexample.vb#coloranimationusingkeyframeswholepage)]
+ [!code-xml[keyframes_snip#ColorAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/ColorAnimationUsingKeyFramesExample.xaml#coloranimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.SolidColorBrush.Color%2A>   
+ <xref:System.Windows.Media.SolidColorBrush>   
+ <xref:System.Windows.Media.Animation.ColorAnimationUsingKeyFrames>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md
new file mode 100644
index 00000000000..33f125e1415
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md
@@ -0,0 +1,31 @@
+---
+title: "ControlTemplate 内でアニメーション化を行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ControlTemplate"
+  - "ControlTemplate, アニメーション化"
+ms.assetid: 97abb5d9-4dc7-4085-a011-54bd8bcb497b
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# ControlTemplate 内でアニメーション化を行う
+この例では、<xref:System.Windows.Media.Animation.Storyboard>、<xref:System.Windows.EventTrigger>、および <xref:System.Windows.Trigger> オブジェクトを使用して、<xref:System.Windows.Controls.ControlTemplate> 内でアニメーション化を行う方法を示します。  
+  
+## 使用例  
+ [!code-xml[AnimatePropertyStoryboards#GraphicsMMControlTemplateStoryboardExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/AnimatePropertyStoryboards/XAML/ControlTemplateStoryboardExample.xaml#graphicsmmcontroltemplatestoryboardexample)]  
+  
+ ストーリーボードを使用したアニメーション化の詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Controls.ControlTemplate>
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-style.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-style.md
new file mode 100644
index 00000000000..b6776981d81
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-style.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : スタイル内でアニメーション化を行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, プロパティ, スタイル内"
+  - "スタイル, アニメーション化 (プロパティを)"
+ms.assetid: 6a791f3d-6b1f-4972-a2f9-35880bcfd954
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : スタイル内でアニメーション化を行う
+この例では、スタイル内でプロパティをアニメーション化する方法を示します。  スタイル内でのアニメーション化では、スタイルが定義されているフレームワーク要素だけを直接ターゲットにできます。  フリーズ可能オブジェクトをターゲットにするには、スタイルが設定されている要素のプロパティから "ドット ダウン" する必要があります。  
+  
+ 次の例では、複数のアニメーションをスタイル内で定義し、<xref:System.Windows.Controls.Button> に適用します。  ユーザーがマウスをボタン上に移動すると、そのボタンは、不透明から部分的に透明へフェードし、また元に戻るという動作を繰り返します。  ユーザーがマウスをボタンから離すと、すべて不透明になります。  ボタンをクリックすると、その背景色がオレンジから白に変わり、また元に戻ります。  ボタンの描画に使用する <xref:System.Windows.Media.SolidColorBrush> は直接ターゲットにできないため、ボタンの <xref:System.Windows.Controls.Control.Background%2A> プロパティからのドット ダウンによってアクセスします。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/StyleStoryboardsExample.xaml#21)]  
+  
+ スタイル内でアニメーション化を行う場合、存在しないオブジェクトはターゲットにできないことに注意してください。  たとえば、スタイルが <xref:System.Windows.Media.SolidColorBrush> を使用してボタンの Background プロパティを設定すると、ある時点で、そのスタイルはオーバーライドされ、ボタンの背景は <xref:System.Windows.Media.LinearGradientBrush> で設定されます。  <xref:System.Windows.Media.SolidColorBrush> をアニメーション化しようとしても例外をスローすることはなく、アニメーション化は、単に通知なしに失敗します。  
+  
+ ストーリーボードの対象化に関する構文の詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  アニメーションの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  スタイルの詳細については、「[スタイルとテンプレート](../../../../docs/framework/wpf/controls/styling-and-templating.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md
new file mode 100644
index 00000000000..f1907b00e1d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : 3-D シーンで素材プロパティをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D シーン, アニメーション化 (素材プロパティを)"
+  - "アニメーション, 素材プロパティ (3-D シーンの)"
+  - "素材プロパティ, アニメーション化 (3-D シーンでの)"
+ms.assetid: 229fd6eb-7401-4992-b0c9-8b28de230c0f
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 3-D シーンで素材プロパティをアニメーション化する
+次の例は、[!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] モデルに適用された <xref:System.Windows.Media.Media3D.Material> の <xref:System.Windows.Media.Brush.Opacity%2A> プロパティにアニメーションを適用する方法を示しています。  
+  
+ 3D オブジェクトに適用する <xref:System.Windows.Media.Media3D.Material> として使用される <xref:System.Windows.Media.LinearGradientBrush> を定義するコード例を次に示します。  
+  
+ [!code-xml[Animation3DGallery_snip#AnimateMaterialExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/AnimateMaterialExample.xaml#animatematerialexampleinline1)]  
+  
+ この <xref:System.Windows.Media.LinearGradientBrush> の <xref:System.Windows.Media.Brush.Opacity%2A> プロパティは、次のコード例を使用してアニメーション化されます。  
+  
+ [!code-xml[Animation3DGallery_snip#AnimateMaterialExampleInline2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/AnimateMaterialExample.xaml#animatematerialexampleinline2)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[Animation3DGallery_snip#AnimateMaterialExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/AnimateMaterialExample.xaml#animatematerialexamplewholepage)]  
+  
+## 参照  
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-size-changes-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-size-changes-by-using-key-frames.md
new file mode 100644
index 00000000000..4c3a7df351e
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-size-changes-by-using-key-frames.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : キー フレームを使用してサイズの変更をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, キー フレームによるサイズ変更"
+  - "キー フレーム, アニメーション化 (サイズ変更を)"
+  - "サイズ変更, アニメーション化 (キー フレームを使用して)"
+ms.assetid: 86bd2950-d4c9-4ec4-aa8d-7dc3ccadded4
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : キー フレームを使用してサイズの変更をアニメーション化する
+この例では、キー フレームを使用してサイズの変更をアニメーション化する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.SizeAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Media.ArcSegment> の <xref:System.Windows.Media.ArcSegment.Size%2A> プロパティをアニメーション化します。  このアニメーションは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  アニメーションの最初の 0.5 秒間は、<xref:System.Windows.Media.Animation.LinearSizeKeyFrame> クラスのインスタンスを使用して、円弧のサイズを徐々に大きくします。  <xref:System.Windows.Media.Animation.LinearSizeKeyFrame> のような線形キー フレームを使用すると、値の間に滑らかな線形トランジションが生成されます。  
+  
+2.  次の 0.5 秒間の終わりには、<xref:System.Windows.Media.Animation.DiscreteSizeKeyFrame> クラスのインスタンスを使用して、円弧のサイズを突然大きくします。  <xref:System.Windows.Media.Animation.DiscreteSizeKeyFrame> のような不連続キー フレームを使用すると、値と値の間は突然ジャンプします。つまり、サイズが滑らかに変化するのではなく、急に変化します。  
+  
+3.  最後の 2 秒間は、<xref:System.Windows.Media.Animation.SplineSizeKeyFrame> クラスのインスタンスを使用して、円弧のサイズを大きくします。  <xref:System.Windows.Media.Animation.SplineSizeKeyFrame> のような[スプライン](GTMT) キー フレームでは、<xref:System.Windows.Media.Animation.SplineSizeKeyFrame.KeySpline%2A> プロパティの値に従って、値の間に可変遷移が作成されます。  この例では、円弧のサイズは最初はゆっくり大きくなりますが、時間セグメントの終点に向かって急激に大きくなります。  
+  
+ [!code-xml[keyframes_snip#SizeAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/SizeAnimationUsingKeyFramesExample.xaml#sizeanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.SizeAnimationUsingKeyFrames>   
+ <xref:System.Windows.Media.ArcSegment.Size%2A>   
+ <xref:System.Windows.Media.ArcSegment>   
+ <xref:System.Windows.Media.Animation.LinearSizeKeyFrame>   
+ <xref:System.Windows.Media.Animation.DiscreteSizeKeyFrame>   
+ <xref:System.Windows.Media.Animation.SplineSizeKeyFrame>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-color-or-opacity-of-a-solidcolorbrush.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-color-or-opacity-of-a-solidcolorbrush.md
new file mode 100644
index 00000000000..02cd9d6a1c8
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-color-or-opacity-of-a-solidcolorbrush.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : SolidColorBrush の色または不透明度をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 色 (SolidColorBrush の)"
+  - "アニメーション, 不透明度 (SolidColorBrush の)"
+  - "色, アニメーション化"
+  - "不透明, アニメーション化"
+  - "SolidColorBrush, アニメーション化 (色を)"
+  - "SolidColorBrush, アニメーション化 (不透明度を)"
+ms.assetid: d9154354-843f-4713-bad1-35bb0ba6eaeb
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : SolidColorBrush の色または不透明度をアニメーション化する
+この例では、<xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> および <xref:System.Windows.Media.Brush.Opacity%2A> をアニメーション化する方法を説明します。  
+  
+## 使用例  
+ 3 つのアニメーションを使用して、<xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> と <xref:System.Windows.Media.Brush.Opacity%2A> をアニメーション化する例を次に示します。  
+  
+-   1 つ目のアニメーション <xref:System.Windows.Media.Animation.ColorAnimation> では、マウスが四角形の中に入ると、ブラシの色が <xref:System.Windows.Media.Colors.Gray%2A> に変更されます。  
+  
+-   2 つ目のアニメーションである、別の <xref:System.Windows.Media.Animation.ColorAnimation> では、マウスが四角形の外に出ると、ブラシの色が <xref:System.Windows.Media.Colors.Orange%2A> に変更されます。  
+  
+-   最後のアニメーション <xref:System.Windows.Media.Animation.DoubleAnimation> では、マウスの左ボタンをクリックすると、ブラシの不透明度が 0.0 に変更されます。  
+  
+ [!code-csharp[brushanimations_snip#SolidColorBrushAnimationExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushanimations_snip/CSharp/SolidColorBrushExample.cs#solidcolorbrushanimationexample)]  
+  
+ さまざまな種類のブラシをアニメーション化する方法を示した、より完全なサンプルについては、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  アニメーションの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ 他のアニメーション例との一貫性を保つために、この例のコードでは、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用してアニメーションを適用しています。  ただし、コードで 1 つのアニメーションを適用する場合は、<xref:System.Windows.Media.Animation.Storyboard> よりも <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用する方が簡単です。  例については、「[ストーリーボードを使用せずにプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)」を参照してください。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-opacity-of-an-element-or-brush.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-opacity-of-an-element-or-brush.md
new file mode 100644
index 00000000000..32b72efb794
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-opacity-of-an-element-or-brush.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : 要素またはブラシの不透明度をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, Opacity プロパティ"
+  - "不透明, アニメーション化"
+ms.assetid: 572af23b-39dd-48d1-9db5-4bca56a4b3d3
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 要素またはブラシの不透明度をアニメーション化する
+フレームワーク要素のフェード インおよびフェード アウトは、その要素の <xref:System.Windows.UIElement.Opacity%2A> プロパティをアニメーション化するか、その要素の描画に使用される <xref:System.Windows.Media.Brush> \(ブラシ\) の <xref:System.Windows.Media.Brush.Opacity%2A> プロパティをアニメーション化することで作成できます。  要素の不透明度をアニメーション化すると、その要素と子要素のフェード インおよびフェード アウトを作成できます。また、要素の描画に使用されるブラシをアニメーション化することで、要素のどの部分をフェード インまたはフェード アウトするかを選択することもできます。  たとえば、ボタンの背景を描画するブラシの不透明度をアニメーション化できます。  これにより、ボタンの背景だけをフェード インおよびフェード アウトさせ、テキストの部分はそのまま残すことができます。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Brush> の <xref:System.Windows.Media.Brush.Opacity%2A> をアニメーション化した方が、要素の <xref:System.Windows.UIElement.Opacity%2A> プロパティをアニメーション化するよりも、パフォーマンス上の利点があります。  
+  
+ 次の例では、2 つのボタンをアニメーション化してフェード インおよびフェード アウトします。  最初の <xref:System.Windows.Controls.Button> の Opacity は、<xref:System.Windows.Media.Animation.Timeline.Duration%2A> で指定した 5 秒間をかけて `1.0` から `0.0` にアニメーション化されます。  2 番目のボタンもアニメーション化されますが、ボタン全体の不透明度ではなく、<xref:System.Windows.Controls.Control.Background%2A> の描画に使用される SolidColorBrush の Opacity がアニメーション化されます。  この例を実行すると、最初のボタンは全体がフェード インおよびフェード アウトするのに対し、2 番目のボタンは背景だけがフェード インおよびフェード アウトします。  テキストと境界線は、完全に不透明のまま残ります。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/OpacityAnimationExample.xaml#10)]  
+  
+ この例では、コードは省略されています。  サンプル全体では、<xref:System.Windows.Media.LinearGradientBrush> の <xref:System.Windows.Media.Color> の透明度をアニメーション化する方法も示します。  サンプル全体については、[要素の不透明度のアニメーション化のサンプル](http://go.microsoft.com/fwlink/?LinkID=159968)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-of-an-object-by-using-pointanimation.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-of-an-object-by-using-pointanimation.md
new file mode 100644
index 00000000000..32d15285482
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-of-an-object-by-using-pointanimation.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : PointAnimation を使用してオブジェクトの位置をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, PointAnimation"
+  - "クラス, PointAnimation"
+  - "グラフィックス [WPF], アニメーション"
+  - "PointAnimation クラス"
+ms.assetid: 42310977-cc90-438a-8a47-0345898e01be
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : PointAnimation を使用してオブジェクトの位置をアニメーション化する
+この例では、<xref:System.Windows.Media.Animation.PointAnimation> クラスを使用して、<xref:System.Windows.Shapes.Path> に沿ってオブジェクトをアニメーション化する方法を示します。  
+  
+## 使用例  
+ 次の例では、画面上のある点から別の点まで、<xref:System.Windows.Shapes.Path> に沿って楕円を移動します。  この例は、<xref:System.Windows.Media.Animation.PointAnimation> を使用して <xref:System.Windows.Media.EllipseGeometry.Center%2A> プロパティをアニメーション化することで、<xref:System.Windows.Media.EllipseGeometry> の位置をアニメーション化します。  
+  
+ [!code-csharp[BasicAnimations_snip#PointAnimationWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BasicAnimations_snip/CSharp/PointAnimationExample.cs#pointanimationwholepage)]
+ [!code-vb[BasicAnimations_snip#PointAnimationWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BasicAnimations_snip/VisualBasic/PointAnimationExample.vb#pointanimationwholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.PointAnimation>   
+ <xref:System.Windows.Shapes.Path>   
+ <xref:System.Windows.Media.EllipseGeometry>   
+ <xref:System.Windows.Media.EllipseGeometry.Center%2A>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/graphics-how-to-topics.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-or-color-of-a-gradient-stop.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-or-color-of-a-gradient-stop.md
new file mode 100644
index 00000000000..54e7c055fc4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-position-or-color-of-a-gradient-stop.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : グラデーション ストップの位置または色をアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 色 (GradientStop オブジェクトの)"
+  - "アニメーション, 位置 (GradientStop オブジェクトの)"
+  - "色, アニメーション化"
+  - "GradientStop オブジェクト, アニメーション化 (色を)"
+  - "GradientStop オブジェクト, アニメーション化 (位置を)"
+  - "位置, アニメーション化"
+ms.assetid: 6f5b8b47-6c32-4b8e-98ee-fdf6515ec843
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : グラデーション ストップの位置または色をアニメーション化する
+この例では、<xref:System.Windows.Media.GradientStop> オブジェクトの <xref:System.Windows.Media.GradientStop.Color%2A> および <xref:System.Windows.Media.GradientStop.Offset%2A> をアニメーション表示する方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.LinearGradientBrush> の内部に 3 つのグラデーション終了位置をアニメーション化する例を次に示します。  この例では、それぞれが異なるグラデーション終了位置をアニメーション化する 3 つのアニメーションを使用しています。  
+  
+-   最初のアニメーション <xref:System.Windows.Media.Animation.DoubleAnimation> は、最初のグラデーション終了位置の <xref:System.Windows.Media.GradientStop.Offset%2A> を 0.0 から 1.0 までアニメーション化し、0.0 まで戻します。  その結果、グラデーションの最初の色は、四角形の左側から右側の方向に変化し、左側に戻ります。  
+  
+-   2 番目のアニメーション <xref:System.Windows.Media.Animation.ColorAnimation> は、2 番目のグラデーション終了位置の <xref:System.Windows.Media.GradientStop.Color%2A> を <xref:System.Windows.Media.Colors.Purple%2A> から <xref:System.Windows.Media.Colors.Yellow%2A> の方向にアニメーション化し、<xref:System.Windows.Media.Colors.Purple%2A> に戻します。  その結果、グラデーションの中間の色は、紫色から黄色に変化し、紫色に戻ります。  
+  
+-   3 番目のアニメーションである、もう 1 つの <xref:System.Windows.Media.Animation.ColorAnimation> は、3 番目のグラデーション終了位置の <xref:System.Windows.Media.GradientStop.Color%2A> の不透明度を \-1 だけアニメーション化した後、元に戻ります。  その結果、グラデーションの3 番目の色は消えていき、再び不透明になります。  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMGradientAnimationExamplesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/GradientStopAnimationExample.cs#graphicsmmgradientanimationexampleswholepage)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMGradientAnimationExamplesWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/gradientstopanimationexample.vb#graphicsmmgradientanimationexampleswholepage)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMGradientAnimationExamplesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/GradientStopAnimationExample.xaml#graphicsmmgradientanimationexampleswholepage)]  
+  
+ この例では <xref:System.Windows.Media.LinearGradientBrush> を使用していますが、このプロセスは、<xref:System.Windows.Media.RadialGradientBrush> 内部で <xref:System.Windows.Media.GradientStop> オブジェクトをアニメーション化する場合でも同じです。  
+  
+ その他の例については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.GradientStop>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-size-of-an-arcsegment.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-size-of-an-arcsegment.md
new file mode 100644
index 00000000000..95ffecfd7b4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-size-of-an-arcsegment.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : ArcSegment のサイズをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ArcSegment のサイズ"
+  - "ArcSegment, アニメーション化 (サイズを)"
+  - "グラフィックス [WPF], アニメーション"
+ms.assetid: f93a1065-b00a-4d7e-9d4b-37023f98186a
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ArcSegment のサイズをアニメーション化する
+この例では、<xref:System.Windows.Media.ArcSegment> の <xref:System.Windows.Media.ArcSegment.Size%2A> プロパティをアニメーション化する方法について説明します。  
+  
+## 使用例  
+ 次の例では、画面に読み込まれる際に <xref:System.Windows.Media.ArcSegment.Size%2A> をアニメーション化する <xref:System.Windows.Media.ArcSegment> を作成する方法を示します。  
+  
+ [!code-csharp[BasicAnimations_snip#SizeAnimationWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BasicAnimations_snip/CSharp/SizeAnimationExample.cs#sizeanimationwholepage)]
+ [!code-vb[BasicAnimations_snip#SizeAnimationWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BasicAnimations_snip/VisualBasic/SizeAnimationExample.vb#sizeanimationwholepage)]  
+  
+ ジオメトリとアニメーションのその他のサンプルについては、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.ArcSegment.Size%2A>   
+ <xref:System.Windows.Media.ArcSegment>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-animate-the-thickness-of-a-border-by-using-key-frames.md b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-thickness-of-a-border-by-using-key-frames.md
new file mode 100644
index 00000000000..559a71267eb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-animate-the-thickness-of-a-border-by-using-key-frames.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : キー フレームを使用して境界線の太さをアニメーション化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 境界線の太さ (キー フレームを使用してアニメーション化)"
+  - "境界線の太さ, アニメーション化 (キー フレームを使用して)"
+  - "キー フレーム, アニメーション化 (境界線の太さを)"
+ms.assetid: 3a9cb463-0a63-407d-aae7-3fbb1a559947
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : キー フレームを使用して境界線の太さをアニメーション化する
+この例では、<xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Control.BorderThickness%2A> プロパティをアニメーション化する方法を説明します。  
+  
+## 使用例  
+ 次のコード例では、<xref:System.Windows.Media.Animation.ThicknessAnimationUsingKeyFrames> クラスを使用して <xref:System.Windows.Controls.Border> の <xref:System.Windows.Controls.Control.BorderThickness%2A> プロパティにアニメーションを適用しています。  このアニメーションは、次の方法で 3 つのキー フレームを使用します。  
+  
+1.  最初の 0.5 秒間は、<xref:System.Windows.Media.Animation.LinearThicknessKeyFrame> クラスのインスタンスを使用して、境界線の太さを徐々に太くします。  この例では、<xref:System.Windows.Media.Animation.LinearThicknessKeyFrame> を使用して、値から値への滑らかで直線的な増加を作成します。  
+  
+2.  次の 0.5 秒間の終わりには、<xref:System.Windows.Media.Animation.DiscreteThicknessKeyFrame> クラスのインスタンスを使用して、境界線の太さを突然太くします。  <xref:System.Windows.Media.Animation.DiscreteThicknessKeyFrame> からこのような不連続のキー フレームを派生すると、値の間に急なジャンプを作成します。つまり、アニメーションの動きはぎくしゃくします。  
+  
+3.  最後の 2 秒間は、<xref:System.Windows.Media.Animation.SplineThicknessKeyFrame> クラスのインスタンスを使用して、境界線の太さを細くします。  <xref:System.Windows.Media.Animation.SplineThicknessKeyFrame> からこのような[スプライン](GTMT) キー フレームを派生すると、<xref:System.Windows.Media.Animation.SplineThicknessKeyFrame.KeySpline%2A> プロパティの値に従って、値の間に可変遷移が作成されます。  このキー フレームでは、アニメーションはゆっくりと始まりますが、時間セグメントの終点に向かって急激に速くなります。  
+  
+ [!code-xml[keyframes_snip#ThicknessAnimationUsingKeyFramesWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/ThicknessAnimationUsingKeyFramesExample.xaml#thicknessanimationusingkeyframeswholepage)]  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.LinearThicknessKeyFrame>   
+ <xref:System.Windows.Media.Animation.DiscreteThicknessKeyFrame>   
+ <xref:System.Windows.Media.Animation.SplineThicknessKeyFrame>   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)   
+ [BorderThickness 値をアニメーション化する](../../../../docs/framework/wpf/controls/how-to-animate-a-borderthickness-value.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-a-drawing-to-a-3-d-model.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-drawing-to-a-3-d-model.md
new file mode 100644
index 00000000000..54d0033da11
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-drawing-to-a-3-d-model.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 3-D モデルに描画を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D モデル, 適用 (描画を)"
+  - "描画, 適用 (3-D モデルに)"
+ms.assetid: 68357577-b7fc-446e-8be9-a8cc7df3a350
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 3-D モデルに描画を適用する
+<xref:System.Windows.Media.DrawingBrush> を、[!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] モデルに適用された <xref:System.Windows.Media.Media3D.Material> として使用する方法を次の例に示します。  
+  
+ 次のコードは、<xref:System.Windows.Media.DrawingGroup> を <xref:System.Windows.Media.DrawingBrush> のコンテンツとして定義しています。  <xref:System.Windows.Media.DrawingBrush> は、[!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] 平面に適用された <xref:System.Windows.Media.Media3D.DiffuseMaterial> の <xref:System.Windows.Media.Media3D.DiffuseMaterial.Brush%2A> プロパティとして設定されています。  
+  
+ **メモ :** 下記の描画のように複雑なオブジェクトや値は、再利用が可能なリソースとして定義して、コードを簡略化することを推奨します。  詳細については、「[XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ [!code-xml[3DGallery_snip#ApplyDrawingToMaterialInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/ApplyDrawingToMaterialExample.xaml#applydrawingtomaterialinline1)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[3DGallery_snip#ApplyDrawingToMaterialExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/ApplyDrawingToMaterialExample.xaml#applydrawingtomaterialexamplewholepage)]  
+  
+## 参照  
+ [XAML リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-a-guidelineset-to-a-drawing.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-guidelineset-to-a-drawing.md
new file mode 100644
index 00000000000..a5a14141a9b
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-guidelineset-to-a-drawing.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 描画に GuidelineSet を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス [WPF], GuidelineSet プロパティ"
+  - "GuidelineSet プロパティ, 適用 (描画に)"
+ms.assetid: 45f3e0b4-8820-45a7-b865-b8ea5b17b0c8
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 描画に GuidelineSet を適用する
+この例では、<xref:System.Windows.Media.GuidelineSet> を <xref:System.Windows.Media.DrawingGroup> に適用する方法を示します。  
+  
+ <xref:System.Windows.Media.DrawingGroup> クラスは、<xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A> プロパティを持つ <xref:System.Windows.Media.Drawing> の唯一の型です。  <xref:System.Windows.Media.GuidelineSet> を <xref:System.Windows.Media.Drawing> の別の型に適用するには、その型を <xref:System.Windows.Media.DrawingGroup> に追加した後、<xref:System.Windows.Media.GuidelineSet> を <xref:System.Windows.Media.DrawingGroup> に適用します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.DrawingGroup> オブジェクトを 2 つ作成します。両者はほとんど同じですが、唯一異なっているのは、2 番目の <xref:System.Windows.Media.DrawingGroup> が <xref:System.Windows.Media.GuidelineSet> を持っているのに対し、1 番目は持っていないことです。  
+  
+ この例からの出力を次の図に示します。  2 つの <xref:System.Windows.Media.DrawingGroup> オブジェクトのレンダリングの違いはごくわずかなので、描画の一部を拡大してあります。  
+  
+ ![GuidelineSet がある &#40;またはない&#41; DrawingGroup](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawinggroup-guidelineset.png "graphicsmm\_drawinggroup\_guidelineset")  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMDrawingGroupGuidelineSetExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingGroupGuidelineSetExample.cs#graphicsmmdrawinggroupguidelinesetexamplewholepage)]
+ [!code-xml[DrawingMiscSnippets_snip#GraphicsMMDrawingGroupGuidelineSetExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingGroupGuidelineSetExample.xaml#graphicsmmdrawinggroupguidelinesetexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingGroup>   
+ <xref:System.Windows.Media.GuidelineSet>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-a-bitmapimage.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-a-bitmapimage.md
new file mode 100644
index 00000000000..d1d19eee8db
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-a-bitmapimage.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : BitmapImage に変換を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ イメージ"
+  - "BitmapImage クラス"
+  - "変換"
+ms.assetid: 5c042f8d-d569-45e4-ab32-868b89759bf2
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : BitmapImage に変換を適用する
+この例では、<xref:System.Windows.Media.Transform> を <xref:System.Windows.Media.Imaging.BitmapImage> に適用する方法を示します。  
+  
+## 使用例  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#TransformedBitmapInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/TransformedBitmapExample.cs#transformedbitmapinline1)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#TransformedBitmapInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/TransformedBitmapExample.vb#transformedbitmapinline1)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Imaging.BitmapSource>   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [イメージを回転させる](../../../../docs/framework/wpf/controls/how-to-rotate-an-image.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-an-element-when-an-event-occurs.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-an-element-when-an-event-occurs.md
new file mode 100644
index 00000000000..c2c8b044363
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-an-element-when-an-event-occurs.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : イベントの発生時に要素に変換を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 変換 (イベント応答として)"
+  - "LayoutTransform プロパティ"
+  - "プロパティ, LayoutTransform"
+  - "プロパティ, RenderTransform"
+  - "RenderTransform プロパティ"
+  - "変換 (イベント応答として)"
+ms.assetid: 71e4327e-ca57-444c-a3cf-09fb381491a0
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : イベントの発生時に要素に変換を適用する
+この例では、イベントの発生時に <xref:System.Windows.Media.ScaleTransform> を適用する方法を示します。  ここで示される概念は、他の種類の変換を適用する場合に使用するものと同じです。  使用可能な変換の種類の詳細については、<xref:System.Windows.Media.Transform> クラスまたは「[変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)」を参照してください。  
+  
+ 要素に変換を適用するには、次の 2 つの方法があります。  
+  
+-   変換がレイアウトに影響しないようにする場合は、要素の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティを使用します。  
+  
+-   変換がレイアウトに影響するようにする場合は、要素の <xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティを使用します。  
+  
+ 次の例では、ボタンの <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.ScaleTransform> を適用しています。  マウスをボタンの上に移動すると、<xref:System.Windows.Media.ScaleTransform> の <xref:System.Windows.Media.ScaleTransform.ScaleX%2A> プロパティと <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> プロパティが `2` に設定され、ボタンが大きくなります。  マウスがボタンから離れると、<xref:System.Windows.Media.ScaleTransform.ScaleX%2A> と <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> が `1` に設定され、ボタンは元のサイズに戻ります。  
+  
+## 使用例  
+ [!code-xml[ButtonTransform#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ButtonTransform/CSharp/ButtonTransformExample.xaml#1)]  
+  
+ [!code-csharp[ButtonTransform#1cb](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ButtonTransform/CSharp/ButtonTransformExample.xaml.cs#1cb)]
+ [!code-vb[ButtonTransform#1cb](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ButtonTransform/VisualBasic/ButtonTransformExample.xaml.vb#1cb)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.ScaleTransform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)   
+ [ルーティング イベントの概要](../../../../docs/framework/wpf/advanced/routed-events-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-emissive-material-to-a-3-d-object.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-emissive-material-to-a-3-d-object.md
new file mode 100644
index 00000000000..2d9d432abf0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-emissive-material-to-a-3-d-object.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 3-D モデルに放射性素材を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D オブジェクト, 適用 (EmissiveMaterial を)"
+  - "EmissiveMaterial, 適用 (3-D オブジェクトに)"
+ms.assetid: fd442cc2-5adc-487a-ba70-e45ed54bb3b4
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 3-D モデルに放射性素材を適用する
+<xref:System.Windows.Media.Media3D.EmissiveMaterial> を使用して、EmissiveMaterial のブラシの色と同じ色を既存の Material に追加する方法を次の例に示します。  次のコードでは、DiffuseMaterial の外観に青を追加するために適用される <xref:System.Windows.Media.Media3D.DiffuseMaterial> と <xref:System.Windows.Media.Media3D.EmissiveMaterial> の組み合わせを示します。  
+  
+ [!code-xml[3DGallery_snip#EmmisiveMaterialAnimationExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/EmissiveMaterialExample.xaml#emmisivematerialanimationexampleinline1)]  
+  
+ 手順コード  
+  
+ [!code-csharp[3DGallery_procedural_snip#EmissiveMaterialCodeExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/EmissiveMaterialExample.cs#emissivematerialcodeexampleinline1)]
+ [!code-vb[3DGallery_procedural_snip#EmissiveMaterialCodeExampleInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/emissivematerialexample.vb#emissivematerialcodeexampleinline1)]  
+  
+## 使用例  
+ 次のコードは、XAML でのサンプル全体です。  
+  
+ [!code-xml[3DGallery_snip#EmissiveMaterialExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/EmissiveMaterialExample.xaml#emissivematerialexamplewholepage)]  
+  
+## 使用例  
+ 手順コードでのサンプル全体を次に示します。  
+  
+ [!code-csharp[3DGallery_procedural_snip#EmissiveMaterialCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/EmissiveMaterialExample.cs#emissivematerialcodeexamplewholepage)]
+ [!code-vb[3DGallery_procedural_snip#EmissiveMaterialCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/emissivematerialexample.vb#emissivematerialcodeexamplewholepage)]  
+  
+## 参照  
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [3\-D シーンで素材プロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md)   
+ [3\-D オブジェクトの前面および背面に素材を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md
new file mode 100644
index 00000000000..1ebff88b89d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-material-to-the-front-and-back-of-a-3-d-object.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 3-D オブジェクトの前面および背面に素材を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D オブジェクト, 適用 (Material クラスを)"
+  - "クラス, 質感"
+  - "Material クラス, 適用 (3-D オブジェクトの両側に)"
+ms.assetid: d93c8ad6-4939-4d29-9544-4d16d98093c1
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 3-D オブジェクトの前面および背面に素材を適用する
+<xref:System.Windows.Media.Media3D.Material> を 3\-D オブジェクトの前面と背面に適用し、オブジェクトの両側を見せるようにアニメーション化する方法を次の例に示します。  <xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.GeometryModel3D.Material%2A> プロパティを使用して、オブジェクトの前面に赤い <xref:System.Windows.Media.Brush> を適用し、<xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.GeometryModel3D.BackMaterial%2A> プロパティを使用して、オブジェクトの背面に青い <xref:System.Windows.Media.Brush> を適用しています。  次のコードでは、素材をオブジェクトに適用しています。  
+  
+ [!code-xml[Animation3DGallery_snip#BackMaterialAnimationExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/BackMaterialAnimationExample.xaml#backmaterialanimationexampleinline1)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[Animation3DGallery_snip#BackMaterialAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Animation3DGallery_snip/CS/BackMaterialAnimationExample.xaml#backmaterialanimationexamplewholepage)]  
+  
+## 参照  
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)   
+ [3\-D シーンで素材プロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-material-properties-in-a-3-d-scene.md)   
+ [3\-D モデルに放射性素材を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-emissive-material-to-a-3-d-object.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transformations-to-a-3-d-model.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transformations-to-a-3-d-model.md
new file mode 100644
index 00000000000..bc8a3cc1ef9
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transformations-to-a-3-d-model.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 複数の変換を 3-D モデルに適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D モデル, 適用 (複数の変換を)"
+ms.assetid: cb72245a-5560-4c96-9f58-593c66296992
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 複数の変換を 3-D モデルに適用する
+この例では、<xref:System.Windows.Media.Media3D.RotateTransform3D> および <xref:System.Windows.Media.Media3D.ScaleTransform3D> を使用して、3\-D モデルを回転させ、そのスケールを変更する方法を示します。  次のコードでは、XAML でこれらの変換を <xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.Model3D.Transform%2A> プロパティに適用する方法を示します。  
+  
+ [!code-xml[3DGallery_snip#Multiple3DTransformationsExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/MultipleTransformationsExample.xaml#multiple3dtransformationsexampleinline1)]  
+  
+ コードは次のとおりです。  
+  
+ [!code-csharp[3DGallery_procedural_snip#Multiple3DTransformationsCodeExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/MultipleTransformationsExample.cs#multiple3dtransformationscodeexampleinline1)]
+ [!code-vb[3DGallery_procedural_snip#Multiple3DTransformationsCodeExampleInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/multipletransformationsexample.vb#multiple3dtransformationscodeexampleinline1)]  
+  
+## 使用例  
+ 次のコードは、XAML でのサンプル全体です。  
+  
+ [!code-xml[3DGallery_snip#Multiple3DTransformationsExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/MultipleTransformationsExample.xaml#multiple3dtransformationsexamplewholepage)]  
+  
+## 使用例  
+ コードでのサンプル全体を次に示します。  
+  
+ [!code-csharp[3DGallery_procedural_snip#Multiple3DTransformationsCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/MultipleTransformationsExample.cs#multiple3dtransformationscodeexamplewholepage)]
+ [!code-vb[3DGallery_procedural_snip#Multiple3DTransformationsCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/multipletransformationsexample.vb#multiple3dtransformationscodeexamplewholepage)]  
+  
+## 参照  
+ [3\-D モデルのスケールを変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-transform-the-scale-of-a-3-d-model.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transforms-to-an-object.md b/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transforms-to-an-object.md
new file mode 100644
index 00000000000..2681414a65b
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transforms-to-an-object.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : オブジェクトに複数の変換を適用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, グループ化 (Transform オブジェクトを)"
+  - "グループ化 (Transform オブジェクトを)"
+  - "Transform オブジェクト, グループ化"
+  - "TransformGroup"
+ms.assetid: 98cd1921-12bc-4bf5-8193-529228fb7402
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : オブジェクトに複数の変換を適用する
+この例では、<xref:System.Windows.Media.TransformGroup> を使用して、2 つ以上の <xref:System.Windows.Media.Transform> オブジェクトを 1 つの複合 <xref:System.Windows.Media.Transform> にグループ化する方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.TransformGroup> を使用して、<xref:System.Windows.Media.ScaleTransform> と <xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Controls.Button> に適用します。  
+  
+ [!code-xml[Transforms_snip#MultipleTransformExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/MultipleTransformExample.xaml#multipletransformexamplewholepage)]  
+  
+ [!code-csharp[Transforms_Procedural_snip#MultipleTransformsCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_Procedural_snip/CSharp/MultipleTransformsExample.cs#multipletransformscodeexamplewholepage)]
+ [!code-vb[Transforms_Procedural_snip#MultipleTransformsCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Transforms_Procedural_snip/VisualBasic/MultipleTransformsExample.vb#multipletransformscodeexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.UIElement.RenderTransform%2A>   
+ <xref:System.Windows.Media.TransformGroup>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-chain-bitmapsource-objects-together.md b/docs/framework/wpf/graphics-multimedia/how-to-chain-bitmapsource-objects-together.md
new file mode 100644
index 00000000000..465636b4bdc
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-chain-bitmapsource-objects-together.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : BitmapSource オブジェクトをチェーンする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapSource オブジェクト, チェーン"
+  - "チェーン (BitmapSource オブジェクトを)"
+  - "グラフィックス, チェーン (BitmapSource オブジェクトを)"
+ms.assetid: 32d88853-395b-4855-9685-51a482a3b421
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : BitmapSource オブジェクトをチェーンする
+この例では、複数の <xref:System.Windows.Media.Imaging.BitmapSource> 派生オブジェクトを相互にチェーンすることで、イメージ ソースにさまざまな効果を適用する方法を示します。  
+  
+ 次の例では、チェーンを使用して、イメージのソースを反転し、ピクセル形式を変更しています。  
+  
+## 使用例  
+ [!code-xml[ImagingSnippetGallery_snip#ChainedBitmapSourcesXamlExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_snip/CS/ChainedBitmapSourcesExample.xaml#chainedbitmapsourcesxamlexamplewholepage)]  
+  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#ChainedBitmapSourcesCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/ChainedBitmapSourcesExample.cs#chainedbitmapsourcescodeexamplewholepage)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#ChainedBitmapSourcesCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/ChainedBitmapSourcesExample.vb#chainedbitmapsourcescodeexamplewholepage)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md b/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md
new file mode 100644
index 00000000000..4e53ffff5ae
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : ストーリーボードを使用して MediaElement を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "制御 (メディアの再生を), ストーリーボードで"
+  - "メディア, 制御 (ストーリーボードで再生を)"
+  - "マルチメディア, 制御 (ストーリーボードでメディアの再生を)"
+  - "再生 (メディアの), 制御 (ストーリーボードで)"
+  - "ストーリーボード, 制御 (メディアの再生を)"
+ms.assetid: 6128ca77-b826-4e36-b968-6f237157c543
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ストーリーボードを使用して MediaElement を制御する
+この例では、<xref:System.Windows.Media.Animation.Storyboard> 内の <xref:System.Windows.Media.MediaTimeline> を使用して、<xref:System.Windows.Controls.MediaElement> を制御する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.Storyboard> 内の <xref:System.Windows.Media.MediaTimeline> を使用して <xref:System.Windows.Controls.MediaElement> のタイミングを制御する場合、その機能は、アニメーションなど他の <xref:System.Windows.Media.Animation.Timeline> オブジェクトの機能と同じです。  たとえば、<xref:System.Windows.Media.MediaTimeline> は、<xref:System.Windows.Media.Animation.Timeline> プロパティを <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> プロパティのように使用して、<xref:System.Windows.Controls.MediaElement> を開始する \(メディアの再生を開始する\) 時刻を指定します。  また、<xref:System.Windows.Media.Animation.Timeline.Duration%2A> プロパティを使用して、<xref:System.Windows.Controls.MediaElement> をアクティブにする時間 \(メディアの再生時間\) を指定します。  <xref:System.Windows.Media.Animation.Storyboard> で <xref:System.Windows.Media.Animation.Timeline> オブジェクトを使用する方法の詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+ この例では、<xref:System.Windows.Media.MediaTimeline> を使用して再生を制御する単純なメディア プレーヤーを作成する方法を示します。  このメディア プレーヤーには、再生、一時停止、再開、停止ボタンがあります。  また、進行状況バーとして機能する <xref:System.Windows.Controls.Slider> コントロールもあります。  
+  
+ メディア プレーヤーの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] を作成する例を次に示します。  
+  
+ [!code-xml[MediaGallery_snip#MediaTimelineExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MediaGallery_snip/VB/MediaTimelineExample.xaml#mediatimelineexamplewholepage)]  
+  
+ 進行状況バーの機能を作成する例を次に示します。  
+  
+ [!code-csharp[MediaGallery_snip#CodeBehindMediaTimelineExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaGallery_snip/CSharp/MediaTimelineExample.xaml.cs#codebehindmediatimelineexamplewholepage)]
+ [!code-vb[MediaGallery_snip#CodeBehindMediaTimelineExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MediaGallery_snip/VB/MediaTimelineExample.xaml.vb#codebehindmediatimelineexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Controls.MediaElement>   
+ <xref:System.Windows.Media.MediaTimeline>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ [MediaElement \(再生、一時停止、停止、ボリューム、および速度\) を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md b/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md
new file mode 100644
index 00000000000..6b1c8b74e03
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : MediaElement (再生、一時停止、停止、ボリューム、および速度) を制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "制御 (メディアの再生を)"
+  - "メディア, 制御 (再生を)"
+  - "マルチメディア, 制御 (メディアの再生を)"
+  - "再生 (メディアの), 制御"
+ms.assetid: 6885a730-e054-4c16-8c1e-ffe17b1f7c32
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : MediaElement (再生、一時停止、停止、ボリューム、および速度) を制御する
+<xref:System.Windows.Controls.MediaElement> を使用して、メディアの再生を制御する方法を次の例に示します。  ここでは、再生、一時停止、停止、メディア内での前後へのスキップ、ボリューム調整、速度比率調整が可能な単純なメディア プレーヤーを作成します。  
+  
+## 使用例  
+ 次のコードでは、UI を作成します。  
+  
+> [!NOTE]
+>  メディアを対話的に停止、一時停止、および再生できるようにするには、<xref:System.Windows.Controls.MediaElement> の <xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> プロパティを `Manual` に設定する必要があります。  
+  
+ [!code-xml[MediaGallery_snip#MediaElementExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MediaGallery_snip/VB/MediaElementExample.xaml#mediaelementexamplewholepage)]  
+  
+## 使用例  
+ 次のコードでは、サンプル UI コントロールの機能を実装します。  <xref:System.Windows.Controls.MediaElement.Play%2A>、<xref:System.Windows.Controls.MediaElement.Pause%2A>、および <xref:System.Windows.Controls.MediaElement.Stop%2A> メソッドは、それぞれメディアの再生、一時停止、停止に使用します。  <xref:System.Windows.Controls.MediaElement> の <xref:System.Windows.Controls.MediaElement.Position%2A> プロパティを変更すると、メディア内で前後にスキップできます。  最後に、<xref:System.Windows.Controls.MediaElement.Volume%2A> プロパティと <xref:System.Windows.Controls.MediaElement.SpeedRatio%2A> プロパティを使用して、ボリュームとメディアの再生速度を調整します。  
+  
+ [!code-csharp[MediaGallery_snip#CodeBehindMediaElementExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaGallery_snip/CSharp/MediaElementExample.xaml.cs#codebehindmediaelementexamplewholepage)]
+ [!code-vb[MediaGallery_snip#CodeBehindMediaElementExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/MediaGallery_snip/VB/MediaElementExample.xaml.vb#codebehindmediaelementexamplewholepage)]  
+  
+## 参照  
+ [ストーリーボードを使用して MediaElement を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md b/docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md
new file mode 100644
index 00000000000..4bb9493d8dc
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : ストーリーボードを開始後に制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストーリーボード, 制御 (起動後に)"
+ms.assetid: 040f13f0-69f9-4ab5-be2b-079f4f80c7c0
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ストーリーボードを開始後に制御する
+この例では、<xref:System.Windows.Media.Animation.Storyboard> が開始した後で、コードを使用してそのストーリーボードを制御する方法を示します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でストーリーボードを制御するには、たとえば、<xref:System.Windows.Trigger> オブジェクトと <xref:System.Windows.TriggerAction> オブジェクトを使用します。「[開始後のストーリーボードをイベント トリガーを使用して制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)」を参照してください。  
+  
+ ストーリーボードを開始するには、ストーリーボードの <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用します。このメソッドは、ストーリーボードのアニメーションをアニメーション化の対象プロパティに分配し、ストーリーボードを開始します。  
+  
+ ストーリーボードを制御可能にするには、<xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用し、2 番目のパラメーターに **true** を指定します。  その後は、ストーリーボードの対話型メソッドを使用して、ストーリーボードを一時停止、再開、シーク、停止、加速、または減速したり、保留期間まで進めたりすることができます。  以下は、ストーリーボードの対話型メソッドの一覧です。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Pause%2A>: ストーリーボードを一時停止します。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Resume%2A>: 一時停止されたストーリーボードを再開します。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.SetSpeedRatio%2A> : ストーリーボードの対話速度を設定します。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Seek%2A> : ストーリーボードの指定した位置をシークします。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.SeekAlignedToLastTick%2A> : ストーリーボードを指定した位置までシークします。  <xref:System.Windows.Media.Animation.Storyboard.Seek%2A> メソッドとは異なり、この操作は次の目盛りに進む前に処理されます。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.SkipToFill%2A> : ストーリーボードを保留期間に進めます \(保留期間がある場合\)。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Stop%2A>: ストーリーボードを停止します。  
+  
+ 次の例では、さまざまなストーリーボード メソッドを使用して、ストーリーボードを対話形式で制御しています。  
+  
+ **メモ :**  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でトリガーを使用してストーリーボードを制御する例については、「[開始後のストーリーボードをイベント トリガーを使用して制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[timingbehaviors_procedural_snip#ControlStoryboardExampleUsingWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_procedural_snip/CSharp/ControlStoryboardExample.cs#controlstoryboardexampleusingwholepage)]
+ [!code-vb[timingbehaviors_procedural_snip#ControlStoryboardExampleUsingWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_procedural_snip/visualbasic/controlstoryboardexample.vb#controlstoryboardexampleusingwholepage)]  
+  
+## 参照  
+ [開始後のストーリーボードをイベント トリガーを使用して制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-an-animation-using-from-to-and-by.md b/docs/framework/wpf/graphics-multimedia/how-to-control-an-animation-using-from-to-and-by.md
new file mode 100644
index 00000000000..36e4f61641f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-an-animation-using-from-to-and-by.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : &quot;From&quot;、&quot;To&quot;、および &quot;By&quot; を使用してアニメーションを制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーションによって/"
+  - "基本アニメーション"
+  - "アニメーション、基本アニメーション"
+  - "From/To/By アニメーション"
+ms.assetid: 59afba57-6fc1-44c8-987e-8a5f4142adad
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : &quot;From&quot;、&quot;To&quot;、および &quot;By&quot; を使用してアニメーションを制御する
+「から/に/者」または「基本アニメーション」が&2; つのターゲット値の間の遷移を作成 (を参照してください[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)さまざまな種類のアニメーションの概要について)。 基本的なアニメーションのターゲット値を設定するには、使用、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>、および<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>プロパティです。  次の表方法<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>、および<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>プロパティを併用することがありますかとは別に、アニメーションのターゲットを決定する値します。  
+  
+|指定されたプロパティ|結果の動作|  
+|--------------------------|------------------------|  
+|<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>|指定された値、アニメーション、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>プロパティをアニメーション化するプロパティの基本値または前のアニメーションの前のアニメーションの構成方法に応じて、値を出力します。|  
+|<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> and                              <xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>|指定された値、アニメーション、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>プロパティで指定された値を<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>プロパティです。|  
+|<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A> and                              <xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>|指定された値、アニメーション、<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>プロパティの合計で指定された値を<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>と<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>プロパティです。|  
+|<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>|アニメーションがアニメーション化されたプロパティの基本値から移行するか、前のアニメーションの出力値を指定する値を<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>プロパティです。|  
+|<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>|出力にその値と指定する値の合計値をアニメーションをアニメーション化するプロパティの基本値または前のアニメーション、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>プロパティです。|  
+  
+> [!NOTE]
+>  両方を設定しないで、<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>プロパティおよび<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>同じアニメーションのプロパティです。  
+  
+ その他の補間方法を使用する&3; つ以上のターゲット値の間をアニメーション化するには、キー フレーム アニメーションを使用します。 参照してください[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)の詳細。  
+  
+ 1 つのプロパティに複数のアニメーションを適用する方法については、次を参照してください。[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)します。  
+  
+ 次の例は、さまざまな設定の効果を示しています。<xref:System.Windows.Media.Animation.DoubleAnimation.To%2A>、<xref:System.Windows.Media.Animation.DoubleAnimation.By%2A>、および<xref:System.Windows.Media.Animation.DoubleAnimation.From%2A>アニメーションのプロパティです。  
+  
+## <a name="example"></a>例  
+ [!code-xml[BasicAnimations_snippet#AnimationTargetValuesWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BasicAnimations_snippet/CS/AnimationTargetValuesExample.xaml#animationtargetvalueswholepage)]  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [From、To、およびアニメーションのターゲット値のサンプルで](http://go.microsoft.com/fwlink/?LinkID=159988)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-key-frame-animation-timing.md b/docs/framework/wpf/graphics-multimedia/how-to-control-key-frame-animation-timing.md
new file mode 100644
index 00000000000..b904f353014
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-key-frame-animation-timing.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : キー フレーム アニメーションのタイミングを制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "キー フレーム [WPF], タイミング"
+  - "タイミング (キー フレーム アニメーションの)"
+ms.assetid: b059216f-7d4b-4ca8-a019-bc287ee7bf16
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : キー フレーム アニメーションのタイミングを制御する
+この例では、キー フレーム アニメーション内のキー フレームのタイミングを制御する方法を示します。  他のアニメーションと同様に、キー フレーム アニメーションにも <xref:System.Windows.Media.Animation.Timeline.Duration%2A> プロパティがあります。  アニメーションの継続時間の指定に加えて、その継続時間のどの部分を各キー フレームに割り当てるかを指定する必要があります。  継続時間を割り当てるには、アニメーションの各キー フレームの <xref:System.Windows.Media.Animation.KeyTime> を指定します。  
+  
+ 各キー フレームの <xref:System.Windows.Media.Animation.KeyTime> は、キー フレームが終了するタイミングを指定します \(キー フレームの再生時間は指定しません\)。  <xref:System.Windows.Media.Animation.KeyTime> は、<xref:System.TimeSpan> 値として、パーセンテージとして、または特殊な <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> 値や <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> 値として指定できます。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> を使用して、画面を横切るように四角形をアニメーション化する例を次に示します。  キー フレームのキー時刻は、<xref:System.TimeSpan> 値で設定します。  
+  
+ [!code-csharp[keyframes_snip#KeyTimesTimeSpanExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/KeyTimesExample.cs#keytimestimespanexample)]
+ [!code-vb[keyframes_snip#KeyTimesTimeSpanExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/keytimesexample.vb#keytimestimespanexample)]
+ [!code-xml[keyframes_snip#KeyTimesTimeSpanExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/KeyTimesExample.xaml#keytimestimespanexample)]  
+  
+ 各キー フレームの値に達したときの図を次に示します。  
+  
+ ![キー値は 3 秒、4 秒、および 10 秒です](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime1-timespan.png "graphicsmm\_keyframe\_keytime1\_timespan")  
+  
+ キー フレームのキー時刻をパーセンテージの値で設定する以外は前と同一であるアニメーションの例を次に示します。  
+  
+ [!code-csharp[keyframes_snip#KeyTimesPercentageExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/KeyTimesExample.cs#keytimespercentageexample)]
+ [!code-vb[keyframes_snip#KeyTimesPercentageExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/keytimesexample.vb#keytimespercentageexample)]
+ [!code-xml[keyframes_snip#KeyTimesPercentageExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/KeyTimesExample.xaml#keytimespercentageexample)]  
+  
+ 各キー フレームの値に達したときの図を次に示します。  
+  
+ ![キー値は 3 秒、4 秒、および 10 秒です](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime2-percentage.png "graphicsmm\_keyframe\_keytime2\_percentage")  
+  
+ <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> キー時刻の値を使用する例を次に示します。  
+  
+ [!code-csharp[keyframes_snip#KeyTimesUniformExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/KeyTimesExample.cs#keytimesuniformexample)]
+ [!code-vb[keyframes_snip#KeyTimesUniformExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/keytimesexample.vb#keytimesuniformexample)]
+ [!code-xml[keyframes_snip#KeyTimesUniformExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/KeyTimesExample.xaml#keytimesuniformexample)]  
+  
+ 各キー フレームの値に達したときの図を次に示します。  
+  
+ ![キー値は 3.3 秒、6.6 秒、および 9.9 秒です](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime3-uniform.png "graphicsmm\_keyframe\_keytime3\_uniform")  
+  
+ 最後の例では、<xref:System.Windows.Media.Animation.KeyTime.Paced%2A> キー時刻の値を使用します。  
+  
+ [!code-csharp[keyframes_snip#KeyTimesPacedExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_snip/CSharp/KeyTimesExample.cs#keytimespacedexample)]
+ [!code-vb[keyframes_snip#KeyTimesPacedExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/keyframes_snip/visualbasic/keytimesexample.vb#keytimespacedexample)]
+ [!code-xml[keyframes_snip#KeyTimesPacedExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_snip/XAML/KeyTimesExample.xaml#keytimespacedexample)]  
+  
+ 各キー フレームの値に達したときの図を次に示します。  
+  
+ ![キー値は 0 秒、5 秒、および 10 秒です](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime4-paced.png "graphicsmm\_keyframe\_keytime4\_paced")  
+  
+ この例のコードでは、単純化するためにストーリーボードではなくローカル アニメーションを使用しています。1 つのアニメーションだけが 1 つのプロパティに適用されるためですが、代わりにストーリーボードを使用するように変更することもできます。  コードでストーリーボードを宣言する方法の例については、「[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)」を参照してください。  
+  
+ サンプル全体については、[キー フレーム アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)を参照してください。  キー フレーム アニメーションの詳細については、「[キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)」を参照してください。  
+  
+## 参照  
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-control-the-fill-of-a-composite-shape.md b/docs/framework/wpf/graphics-multimedia/how-to-control-the-fill-of-a-composite-shape.md
new file mode 100644
index 00000000000..ee8296bfd55
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-control-the-fill-of-a-composite-shape.md
@@ -0,0 +1,73 @@
+---
+title: "方法 : 複合図形の塗りつぶしを制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "図形、複合、塗りつぶしを制御します。"
+  - "複合図形、塗りつぶしを制御します。"
+  - "複合図形のグラフィックス [WPF]"
+  - "塗りつぶしを制御します。"
+ms.assetid: c1c94575-9eca-48a5-a49a-2ec65259f229
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 複合図形の塗りつぶしを制御する
+<xref:System.Windows.Media.GeometryGroup.FillRule%2A>のプロパティ、 <xref:System.Windows.Media.GeometryGroup>または<xref:System.Windows.Media.PathGeometry>、複合図形を使用して、指定された点のジオメトリの一部であるかどうかを決定する「ルール」を指定します。 2 つの値がある<xref:System.Windows.Media.FillRule>: <xref:System.Windows.Media.FillRule>と<xref:System.Windows.Media.FillRule>します。 次のセクションでは、これら&2; つのルールを使用する方法を説明します。  
+  
+ **EvenOdd:**このルールは、そのポイントからの任意の方向に無制限に光線を描画し、その光線が交差する特定の形状のパス セグメントの数をカウントして、ポイントは、塗りつぶし領域の内側かどうかを確認します。 この数値が偶数の場合は、ポイントは内側にあります。偶数の場合は、ポイントは外側にあります。  
+  
+ たとえば、次の XAML で一連同心円リング (ターゲット) の複合図形を作成します.、 <xref:System.Windows.Media.GeometryGroup.FillRule%2A>設定<xref:System.Windows.Media.FillRule>します。  
+  
+ [!code-xml[GeometriesMiscSnippets_snip#FillRuleEvenOddValue](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GeometriesMiscSnippets_snip/XAML/FillRuleExample.xaml#fillruleevenoddvalue)]  
+  
+ 次の図は、前の例で作成した図形を示します。  
+  
+ ![EvenOdd の FillRule プロパティのスクリーン ショット:](../../../../docs/framework/wpf/graphics-multimedia/media/fillruleevenoddfirstone.png "FillRuleEvenOddFirstOne")  
+  
+ 上の図の中心と 3 番目のリングが入力されていないことを確認します。 これら&2; つのリングのいずれかの任意の点から描画光線が偶数個のセグメントを通過するためです。 次の図を参照してください。  
+  
+ ![ダイアグラム: EvenOdd の FillRule プロパティの値](../../../../docs/framework/wpf/graphics-multimedia/media/fillruleevenodd2.png "FillRuleEvenOdd2")  
+  
+ **0 以外。**このルールは、ポイントがそのポイントからの任意の方向に無制限に光線を描画して、図形のセグメントが光線と交差する場所を調べることが、パスの塗りつぶし領域の内側かどうかを確認します。 以降、カウントが&0;、1 つずつを追加回のセグメントが左から右、およびそれぞれに&1; を減算に光線を越えるパス セグメントでは、右から左に、ray と交差します。 交差のカウント後、結果が&0; の場合は、ポイントは、パスの外側にあります。 それ以外の場合は、内側にあります。  
+  
+ [!code-xml[GeometriesMiscSnippets_snip#FillRuleNonZeroValueEllipseGeometry](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GeometriesMiscSnippets_snip/XAML/FillRuleExample.xaml#fillrulenonzerovalueellipsegeometry)]  
+  
+ 上記の値の例を使用して<xref:System.Windows.Media.FillRule>の<xref:System.Windows.Media.GeometryGroup.FillRule%2A>次の図は、その結果。  
+  
+ ![スクリーン ショット:&0; 以外の FillRule 値](../../../../docs/framework/wpf/graphics-multimedia/media/fillrulenonzero1.png "FillRuleNonZero1")  
+  
+ ご覧のように、すべてのリングに格納されます。 これは、任意の時点から描画光線が交差&1; つまたは複数のセグメントと、超過の合計が&0; と等しくないので、すべてのセグメントが同じ方向に実行されているためです。 たとえば、次の図で赤の矢印セグメントが描かれる方向を表し、白い矢印は、最も内側の輪にポイントから実行する任意の光線を表します。 1 つの値は&0;、光線と交差する、各セグメントの値で始まる、セグメントが左から右に光線を越えるために追加されます。  
+  
+ ![ダイアグラム: FillRule プロパティ値が&0; 以外と等しい](../../../../docs/framework/wpf/graphics-multimedia/media/fillrulenonzero2.png "FillRuleNonZero2")  
+  
+ 動作を詳しく説明するために<xref:System.Windows.Media.FillRule>規則さまざまな方向に実行しているセグメントを持つより複雑な図形が必要です。 次の XAML コードで作成する点を除いて前の例と類似した図形を作成、 <xref:System.Windows.Media.PathGeometry>ではなく、 <xref:System.Windows.Media.EllipseGeometry>の同心円を完全に閉じている&4; つの同心円円弧を作成し、します。  
+  
+ [!code-xml[GeometriesMiscSnippets_snip#FillRuleNonZeroValuePathGeometry](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GeometriesMiscSnippets_snip/XAML/FillRuleExample.xaml#fillrulenonzerovaluepathgeometry)]  
+  
+ 次の図は、前の例で作成した図形を示します。  
+  
+ ![スクリーン ショット:&0; 以外の FillRule プロパティ値](../../../../docs/framework/wpf/graphics-multimedia/media/fillrulenonzero3.png "FillRuleNonZero3")  
+  
+ センターから&3; 番目の円弧が入力されていないことを確認します。 次の図は、これは、理由を示します。 図では、赤の矢印は、セグメントが描かれる方向を表します。 2 つの白い矢印は、「塗りつぶされていない」地域でのポイントから外に移動する&2; つの任意の光線を表しています。 図からわかるように、指定したパス セグメントの境界を越える光線から値の合計は&0; です。 上記で定義した、合計が&0;、ポイントはないということ geometry (塗りつぶしの一部ではない) の一部である合計中に*いない*0、負の値を含む、ジオメトリの一部であります。  
+  
+ ![ダイアグラム: FillRule プロパティ値&0; 以外の](../../../../docs/framework/wpf/graphics-multimedia/media/fillrulenonzero4.png "FillRuleNonZero4")  
+  
+ **注:**の目的で<xref:System.Windows.Media.FillRule>、すべての図形は終了と見なされます。 セグメント内の欠落がある場合を閉じるには、架空の線を描画します。 上記の例では、輪に小規模の欠落があります。 そのため、いずれかの想像し、異なる結果を得るための間隔で実行される ray、別の方向に伸びるします。 この間隙と「虚数セグメント」のいずれかの拡大した例を次に示します (セグメントの適用のために描画される、 <xref:System.Windows.Media.FillRule>) を終了します。  
+  
+ ![ダイアグラム: fillrule の場合、セグメントは常に閉じています](../../../../docs/framework/wpf/graphics-multimedia/media/fillruleclosedshapes.png "FillRuleClosedShapes")  
+  
+## <a name="example"></a>例  
+  
+## <a name="see-also"></a>関連項目  
+ [複合図形を作成します。](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-a-different-pixelformat.md b/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-a-different-pixelformat.md
new file mode 100644
index 00000000000..ada19309223
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-a-different-pixelformat.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : BitmapSource を別の PixelFormat に変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapSource オブジェクト, 変換 (インデックス付きピクセル形式に)"
+  - "BitmapSource オブジェクト, 変換 (パレット ピクセル形式に)"
+  - "変換 (イメージを)"
+  - "変換, BitmapSource オブジェクトをインデックス付きピクセル形式に"
+  - "変換, BitmapSource オブジェクトをパレット ピクセル形式に"
+ms.assetid: cd9df1e4-d5dc-4f57-b67b-4ec67e086b33
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : BitmapSource を別の PixelFormat に変換する
+<xref:System.Windows.Media.Imaging.FormatConvertedBitmap> を使用して <xref:System.Windows.Media.Imaging.BitmapSource> オブジェクト \(<xref:System.Windows.Media.Imaging.BitmapImage>\) を別の <xref:System.Windows.Media.PixelFormat> に変換する方法を次の例に示します。  
+  
+## 使用例  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#PixelFormatConversion](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/PixelFormatsExample.cs#pixelformatconversion)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#PixelFormatConversion](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/PixelFormatsExample.vb#pixelformatconversion)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-an-indexed-pixel-format.md b/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-an-indexed-pixel-format.md
new file mode 100644
index 00000000000..8911c679509
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-an-indexed-pixel-format.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : BitmapSource をインデックス付きピクセル形式に変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapSource オブジェクト, 変換 (インデックス付きピクセル形式に)"
+  - "BitmapSource オブジェクト, 変換 (パレット ピクセル形式に)"
+  - "変換, BitmapSource オブジェクトをインデックス付きピクセル形式に"
+  - "変換, BitmapSource オブジェクトをパレット ピクセル形式に"
+  - "グラフィックス, 変換 (BitmapSource オブジェクトをインデックス付きピクセル形式に)"
+  - "グラフィックス, 変換 (BitmapSource オブジェクトをパレット ピクセル形式に)"
+  - "インデックス付きピクセル形式"
+  - "パレット ピクセル形式"
+  - "ピクセル形式, インデックス付き"
+  - "ピクセル形式, パレット"
+ms.assetid: ccb03a83-8c72-4353-89da-48312d16548b
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : BitmapSource をインデックス付きピクセル形式に変換する
+<xref:System.Windows.Media.Imaging.BitmapSource> をインデックス付きピクセル形式に変換する方法を次の例に示します。  
+  
+## 使用例  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#FormatConvertedBitmapCodeExample2WholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/FormatConvertedBitmapExample2.cs#formatconvertedbitmapcodeexample2wholepage)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#FormatConvertedBitmapCodeExample2WholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/FormatConvertedBitmapExample2.vb#formatconvertedbitmapcodeexample2wholepage)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md
new file mode 100644
index 00000000000..e0dec3ca1ae
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 3-D シーンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D シーン"
+  - "作成, 3-D シーン"
+  - "シーン, 3-D"
+ms.assetid: adb4a598-71a2-4dd5-b677-ea3fc11b78b2
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 3-D シーンを作成する
+この例では、平らな紙を回転させたような 3\-D オブジェクトを作成する方法を示します。  <xref:System.Windows.Controls.Viewport3D> を次のコンポーネントと共に使用して、この簡単な 3\-D シーンを作成します。  
+  
+-   カメラは、<xref:System.Windows.Media.Media3D.PerspectiveCamera> を使用して作成します。  カメラは、3\-D シーンの表示する部分を指定します。  
+  
+-   メッシュは、<xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.GeometryModel3D.Geometry%2A> プロパティを使用して作成し、3\-D オブジェクト \(紙\) の形状を指定します。  
+  
+-   マテリアルは、<xref:System.Windows.Media.Media3D.GeometryModel3D> の <xref:System.Windows.Media.Media3D.GeometryModel3D.Material%2A> プロパティを使用して指定し、オブジェクト \(この例では線形グラデーション\) のサーフェイスに表示されます。  
+  
+-   光源は、<xref:System.Windows.Media.Media3D.DirectionalLight> を使用して作成し、オブジェクトに光を当てます。  
+  
+## 使用例  
+ 次のコードでは、3\-D シーンを XAML で作成する方法を示します。  
+  
+ [!code-xml[3DGallery_snip#Basic3DShapeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/Basic3DShapeExample.xaml#basic3dshapeexamplewholepage)]  
+  
+## 使用例  
+ 次のコードでは、同じ 3\-D シーンを手順コードで作成する方法を示します。  
+  
+ [!code-csharp[3DGallery_procedural_snip#Basic3DShapeCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/Basic3DShapeExample.cs#basic3dshapecodeexamplewholepage)]
+ [!code-vb[3DGallery_procedural_snip#Basic3DShapeCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/3DGallery_procedural_snip/visualbasic/basic3dshapeexample.vb#basic3dshapecodeexamplewholepage)]  
+  
+## 参照  
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-bitmap-from-a-visual.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-bitmap-from-a-visual.md
new file mode 100644
index 00000000000..96d3fb03491
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-bitmap-from-a-visual.md
@@ -0,0 +1,33 @@
+---
+title: "方法 : ビジュアルからビットマップを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ, 描画 (ビジュアルから)"
+  - "ビジュアル, レンダリング (ビットマップに)"
+ms.assetid: 103fc7f5-7306-4026-9d61-2005e79959f3
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ビジュアルからビットマップを作成する
+この例では、<xref:System.Windows.Media.Visual> からビットマップを作成する方法を示します。  <xref:System.Windows.Media.DrawingVisual> を <xref:System.Windows.Media.FormattedText> でレンダリングします。  次に、<xref:System.Windows.Media.Visual> を <xref:System.Windows.Media.Imaging.RenderTargetBitmap> にレンダリングして、指定したテキストのビットマップを作成します。  
+  
+## 使用例  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#CreateRTBImage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/RenderTargetBitmapExample.cs#creatertbimage)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#CreateRTBImage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/RenderTargetBitmapExample.vb#creatertbimage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingContext>   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-combined-geometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-combined-geometry.md
new file mode 100644
index 00000000000..b973daf368d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-combined-geometry.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : 結合したジオメトリを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "結合 (ジオメトリを)"
+  - "ジオメトリ, 結合"
+  - "グラフィックス, 結合 (ジオメトリを)"
+ms.assetid: 54c3277c-6b6e-4b25-91be-fda0bbc706b4
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 結合したジオメトリを作成する
+この例では、ジオメトリを結合する方法を示します。  2 つのジオメトリを結合するには、<xref:System.Windows.Media.CombinedGeometry> オブジェクトを使用します。  このオブジェクトの <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> プロパティを、結合する 2 つのジオメトリに設定し、<xref:System.Windows.Media.CombinedGeometry.GeometryCombineMode%2A> プロパティを `Union`、`Intersect`、`Exclude`、または `Xor` に設定して、ジオメトリの結合方法を決定します。  
+  
+ 2 つ以上のジオメトリから複合ジオメトリを作成するには、<xref:System.Windows.Media.GeometryGroup> を使用します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.CombinedGeometry> は `Exclude` のジオメトリ結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#21)]  
+  
+ ![除外組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-exclude.png "mil\_task\_combined\_geometry\_exclude")  
+Combined Geometry Exclude  
+  
+ 次のマークアップでは、<xref:System.Windows.Media.CombinedGeometry> は `Intersect` の結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#22](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#22)]  
+  
+ ![交差組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-intersect.png "mil\_task\_combined\_geometry\_intersect")  
+Combined Geometry Intersect  
+  
+ 次のマークアップでは、<xref:System.Windows.Media.CombinedGeometry> は `Union` の結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#23](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#23)]  
+  
+ ![結合組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-union.png "mil\_task\_combined\_geometry\_union")  
+Combined Geometry Union  
+  
+ 次のマークアップでは、<xref:System.Windows.Media.CombinedGeometry> は `Xor` の結合モードで定義されています。  <xref:System.Windows.Media.CombinedGeometry.Geometry1%2A> および <xref:System.Windows.Media.CombinedGeometry.Geometry2%2A> は同じ半径の円として定義されていますが、中心は 50 ずれています。  
+  
+ [!code-xml[GeometrySample#24](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#24)]  
+  
+ ![Xor 組み合わせモードの結果](../../../../docs/framework/wpf/graphics-multimedia/media/mil-task-combined-geometry-xor.png "mil\_task\_combined\_geometry\_xor")  
+Combined Geometry Xor
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-drawing.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-drawing.md
new file mode 100644
index 00000000000..13d4b88e66c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-drawing.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 複合描画を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, DrawingGroup"
+  - "複合描画"
+  - "DrawingGroup クラス"
+  - "描画, 複合"
+  - "グラフィックス, 複合描画"
+ms.assetid: 066eb0ab-5f0e-439d-85c6-dca60af269fc
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 複合描画を作成する
+この例では、<xref:System.Windows.Media.DrawingGroup> を使用して複数の <xref:System.Windows.Media.Drawing> オブジェクトを 1 つの複合描画に結合することで複雑な描画を作成する方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.DrawingGroup> を使用して <xref:System.Windows.Media.GeometryDrawing> オブジェクトと <xref:System.Windows.Media.ImageDrawing> オブジェクトから複合描画を作成する例を次に示します。  この例が生成する出力を次の図に示します。  
+  
+ ![複数の描画を含む DrawingGroup](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-simple.png "graphicsmm\_simple")  
+DrawingGroup を使用して作成した複合描画  
+  
+ 描画の境界を表す灰色の境界線に注目してください。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMSimpleDrawingGroupExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingGroupExample.cs#graphicsmmsimpledrawinggroupexample)]
+ [!code-xml[DrawingMiscSnippets_snip#GraphicsMMSimpleDrawingGroupExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingGroupExample.xaml#graphicsmmsimpledrawinggroupexample)]  
+  
+ <xref:System.Windows.Media.DrawingGroup> を使用して、<xref:System.Windows.Media.DrawingGroup.Transform%2A>、<xref:System.Windows.Media.DrawingGroup.Opacity%2A> の設定、<xref:System.Windows.Media.DrawingGroup.OpacityMask%2A>、<xref:System.Windows.Media.DrawingGroup.BitmapEffect%2A>、<xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>、または <xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A> を、グループに含まれる描画に適用できます。  <xref:System.Windows.Media.DrawingGroup> は <xref:System.Windows.Media.Drawing> でもあるため、他の <xref:System.Windows.Media.DrawingGroup> オブジェクトを含めることができます。  
+  
+ 次の例は前の例と似ていますが、追加の <xref:System.Windows.Media.DrawingGroup> オブジェクトを使用して、ビットマップ効果と不透明マスクを一部の描画に適用している点が異なります。  この例が生成する出力を次の図に示します。  
+  
+ ![複数の描画を含む DrawingGroup](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-multiple.png "graphicsmm\_multiple")  
+複数の DrawingGroup オブジェクトを使用する複合描画  
+  
+ 描画の境界を表す灰色の境界線に注目してください。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMMultipleDrawingGroupsExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingGroupExample.cs#graphicsmmmultipledrawinggroupsexample)]
+ [!code-xml[DrawingMiscSnippets_snip#GraphicsMMMultipleDrawingGroupsExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingGroupExample.xaml#graphicsmmmultipledrawinggroupsexample)]  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingGroup.BitmapEffect%2A>   
+ <xref:System.Windows.Media.DrawingGroup.Transform%2A>   
+ <xref:System.Windows.Media.DrawingGroup.OpacityMask%2A>   
+ <xref:System.Windows.Media.DrawingGroup.Opacity%2A>   
+ <xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>   
+ <xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md
new file mode 100644
index 00000000000..5ab5d399554
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 複合図形を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複合図形"
+  - "グラフィックス, 複合図形"
+  - "形状, 複合"
+ms.assetid: 8e5c7ef4-d7ed-4c43-afc9-ca01325c300b
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 複合図形を作成する
+この例では、<xref:System.Windows.Media.Geometry> オブジェクトを使用して複合図形を作成し、<xref:System.Windows.Shapes.Path> 要素を使用してこれらを表示する方法を示します。  次の例は、<xref:System.Windows.Media.LineGeometry>、<xref:System.Windows.Media.EllipseGeometry>、および <xref:System.Windows.Media.RectangleGeometry> を、<xref:System.Windows.Media.GeometryGroup> と共に使用して、複合図形を作成します。  次に、<xref:System.Windows.Shapes.Path> 要素を使用してジオメトリを描画します。  
+  
+## 使用例  
+ [!code-xml[GeometrySample#19](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/combininggeometriesexample.xaml#19)]  
+  
+ [!code-csharp[GeometriesMiscSnippets_procedural_snip#CompositeShapeCodeExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/CSharp/CompositeShapeExample.cs#compositeshapecodeexampleinline1)]
+ [!code-vb[GeometriesMiscSnippets_procedural_snip#CompositeShapeCodeExampleInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/visualbasic/compositeshapeexample.vb#compositeshapecodeexampleinline1)]  
+  
+ 前の例で作成した図を次に示します。  
+  
+ ![GeometryGroup を使用して作成された複合ジオメトリ](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-compositegeometryexample1.png "wcpsdk\_graphicsmm\_compositegeometryexample1")  
+複合ジオメトリ  
+  
+ 多角形や曲線のセグメントを持つ図形など、より複雑な図形は、<xref:System.Windows.Media.PathGeometry> を使用して作成できます。  <xref:System.Windows.Media.PathGeometry> を使用して図形を作成する方法の例については、「[PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)」を参照してください。  この例では <xref:System.Windows.Shapes.Path> 要素を使用して画面に図形をレンダリングしますが、<xref:System.Windows.Media.Geometry> オブジェクトも、<xref:System.Windows.Media.GeometryDrawing> または <xref:System.Windows.Media.DrawingContext> のコンテンツの記述に使用することができます。  またこれらは、クリッピングとヒット テストに使用することもできます。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md
new file mode 100644
index 00000000000..842000baa99
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 3 次ベジエ曲線を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ベジエ曲線, 3 次"
+  - "作成, 3 次ベジエ曲線"
+  - "3 次ベジエ曲線"
+  - "曲線, 3 次ベジエ"
+  - "グラフィックス, 3 次ベジエ曲線"
+ms.assetid: 450a3a77-7c57-48b0-a008-0f6051add980
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 3 次ベジエ曲線を作成する
+3 次ベジエ曲線を作成する方法を次の例に示します。  3 次ベジエ曲線を作成するには、<xref:System.Windows.Media.PathGeometry>、<xref:System.Windows.Media.PathFigure>、および <xref:System.Windows.Media.BezierSegment> の各クラスを使用します。  結果のジオメトリを表示するには、<xref:System.Windows.Shapes.Path> 要素を使用するか、<xref:System.Windows.Media.GeometryDrawing> または <xref:System.Windows.Media.DrawingContext> でジオメトリを使用します。  次の例では、3 次ベジエ曲線を \(10, 100\) から \(300, 100\) まで描画します。  曲線の制御点は \(100, 0\) と \(200, 200\) です。  
+  
+## 使用例  
+ \[xaml\]  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、省略されたマークアップ構文を使用してパスを記述できます。  
+  
+ [!code-xml[GeometrySample#53](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/geometryattributesyntaxexample.xaml#53)]  
+  
+ \[xaml\]  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、オブジェクト タグを使用して 3 次ベジエ曲線を描画することもできます。  次の例は、前の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例と同じです。  
+  
+ [!code-xml[GeometrySample#33](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#33)]  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+## 参照  
+ [楕円の円弧を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md)   
+ [PathGeometry で LineSegment を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md)   
+ [Create a Cubic Bezier Curve](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md)   
+ [2 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-geometrydrawing.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-geometrydrawing.md
new file mode 100644
index 00000000000..f3f4e62d78e
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-geometrydrawing.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : GeometryDrawing を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, GeometryDrawing"
+  - "GeometryDrawing クラス"
+  - "グラフィックス, GeometryDrawing クラス"
+  - "レンダリング可能な図形"
+  - "形状, レンダリング可能"
+ms.assetid: 11d3c096-91ba-4d41-9bba-aeac0db70f97
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : GeometryDrawing を作成する
+この例では、<xref:System.Windows.Media.GeometryDrawing> を作成して表示する方法を示します。  <xref:System.Windows.Media.GeometryDrawing> を使用すると、<xref:System.Windows.Media.Pen> と <xref:System.Windows.Media.Brush> を <xref:System.Windows.Media.Geometry> に関連付けることで、塗りつぶしとアウトラインを使用して図形を作成できます。  <xref:System.Windows.Media.GeometryDrawing.Geometry%2A> は図形の構造を記述し、<xref:System.Windows.Media.GeometryDrawing.Brush%2A> は図形の塗りつぶしを記述し、<xref:System.Windows.Media.GeometryDrawing.Pen%2A> は図形のアウトラインを記述します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.GeometryDrawing> を使用して図形をレンダリングします。  図形は、1 つの <xref:System.Windows.Media.GeometryGroup> と 2 つの <xref:System.Windows.Media.EllipseGeometry> オブジェクトによって示されます。  図形の内部は <xref:System.Windows.Media.LinearGradientBrush> で塗りつぶし、図形のアウトラインは <xref:System.Windows.Media.Brushes.Black%2A> <xref:System.Windows.Media.Pen> で描画します。  <xref:System.Windows.Media.GeometryDrawing> は、<xref:System.Windows.Media.ImageDrawing> と <xref:System.Windows.Controls.Image> 要素を使用して表示されます。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GeometryDrawingExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/GeometryDrawingExample.cs#geometrydrawingexamplewholepage)]
+ [!code-xml[DrawingMiscSnippets_snip#GeometryDrawingExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/GeometryDrawingExample.xaml#geometrydrawingexamplewholepage)]  
+  
+ 結果として作成される <xref:System.Windows.Media.GeometryDrawing> を次の図に示します。  
+  
+ ![2 つの楕円の GeometryDrawing](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-geodraw.png "graphicsmm\_geodraw")  
+  
+ さらに複雑な描画を作成するには、<xref:System.Windows.Media.DrawingGroup> を使用して、複数の描画オブジェクトを 1 つの複合描画に結合できます。  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingGroup>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [複合描画を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-drawing.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-line-using-a-linegeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-line-using-a-linegeometry.md
new file mode 100644
index 00000000000..0dc8857bd41
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-line-using-a-linegeometry.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : LineGeometry を使用して線を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, LineGeometry"
+  - "グラフィックス [WPF], 線"
+  - "LineGeometry クラス"
+ms.assetid: 41231b22-1f74-4c26-a8e7-a55b29f8f6bd
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : LineGeometry を使用して線を作成する
+<xref:System.Windows.Media.LineGeometry> クラスを使用して線を記述する方法を次の例に示します。  <xref:System.Windows.Media.LineGeometry> は、始点と終点によって定義されます。  
+  
+## 使用例  
+ <xref:System.Windows.Media.LineGeometry> オブジェクトを作成してレンダリングする方法の例を次に示します。  線をレンダリングするには、<xref:System.Windows.Shapes.Path> 要素を使用します。  線には領域がないので、<xref:System.Windows.Shapes.Path> オブジェクトの <xref:System.Windows.Shapes.Shape.Fill%2A> は指定しません。代わりに、<xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティと <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> プロパティを使用します。  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmlinegeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmlinegeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMLineGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmlinegeometryexample)]  
+  
+ ![LineGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-line.png "graphicsmm\_line")  
+\(10,20\) から \(100,130\) まで描画された LineGeometry  
+  
+ その他の単純な図形座標クラスとして、<xref:System.Windows.Media.LineGeometry>、<xref:System.Windows.Media.EllipseGeometry> などがあります。  これらの図形座標およびさらに複雑な図形座標は、<xref:System.Windows.Media.PathGeometry> または <xref:System.Windows.Media.StreamGeometry> を使用して作成することもできます。  詳細については、「[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)」を参照してください。  
+  
+## 参照  
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)   
+ [PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md
new file mode 100644
index 00000000000..68cbab4cfa3
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-linesegment-in-a-pathgeometry.md
@@ -0,0 +1,115 @@
+---
+title: "方法 : PathGeometry で LineSegment を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PathGeometry クラス"
+  - "PathGeometry クラス"
+  - "直線セグメントを作成します。"
+  - "グラフィックス [WPF] 直線セグメント"
+ms.assetid: 0155ed47-a20d-49a7-a306-186d8e07fbc4
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : PathGeometry で LineSegment を作成する
+この例では、直線セグメントを作成する方法を示します。 直線セグメントを作成するには、使用、 <xref:System.Windows.Media.PathGeometry>、 <xref:System.Windows.Media.PathFigure>、および<xref:System.Windows.Media.LineSegment>クラスです。  
+  
+## <a name="example"></a>例  
+ 次の例では、描画、 <xref:System.Windows.Media.LineSegment>から (10, 50) を (200, 70)。 次の図は、その結果<xref:System.Windows.Media.LineSegment>; 座標系を表示するグリッドの背景色が追加されました。  
+  
+ ![PathFigure 内の LineSegment](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-pathgeometrylinesegment.png "graphicsmm_pathgeometrylinesegment")  
+(10,50) から (200,70) に描画 LineSegment  
+  
+ [xaml]  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]パスを記述する属性の構文を使用することがあります。  
+  
+```xaml  
+<Path Stroke="Black" StrokeThickness="1"    
+  Data="M 10,50 L 200,70" />  
+```  
+  
+ [xaml]  
+  
+ (この属性の構文が実際に作成するメモ、 <xref:System.Windows.Media.StreamGeometry>、軽量なバージョンの<xref:System.Windows.Media.PathGeometry>します。 詳細については、次を参照してください、[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)ページです。)。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]、オブジェクト要素構文を使用して、直線セグメントを描画することもできます。 次は、前のと同じ[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]例です。  
+  
+```xaml  
+<Path Stroke="Black" StrokeThickness="1">  
+  <Path.Data>  
+    <PathGeometry>  
+      <PathFigure StartPoint="10,50">  
+        <LineSegment Point="200,70" />  
+      </PathFigure>  
+    </PathGeometry>  
+  </Path.Data>  
+</Path>  
+```  
+  
+```csharp  
+PathFigure myPathFigure = new PathFigure();  
+myPathFigure.StartPoint = new Point(10, 50);  
+  
+LineSegment myLineSegment = new LineSegment();  
+myLineSegment.Point = new Point(200, 70);  
+  
+PathSegmentCollection myPathSegmentCollection = new PathSegmentCollection();  
+myPathSegmentCollection.Add(myLineSegment);  
+  
+myPathFigure.Segments = myPathSegmentCollection;  
+  
+PathFigureCollection myPathFigureCollection = new PathFigureCollection();  
+myPathFigureCollection.Add(myPathFigure);  
+  
+PathGeometry myPathGeometry = new PathGeometry();  
+myPathGeometry.Figures = myPathFigureCollection;  
+  
+Path myPath = new Path();  
+myPath.Stroke = Brushes.Black;  
+myPath.StrokeThickness = 1;  
+myPath.Data = myPathGeometry;  
+```  
+  
+```vb  
+Dim myPathFigure As New PathFigure()  
+            myPathFigure.StartPoint = New Point(10, 50)  
+  
+            Dim myLineSegment As New LineSegment()  
+            myLineSegment.Point = New Point(200, 70)  
+  
+            Dim myPathSegmentCollection As New PathSegmentCollection()  
+            myPathSegmentCollection.Add(myLineSegment)  
+  
+            myPathFigure.Segments = myPathSegmentCollection  
+  
+            Dim myPathFigureCollection As New PathFigureCollection()  
+            myPathFigureCollection.Add(myPathFigure)  
+  
+            Dim myPathGeometry As New PathGeometry()  
+            myPathGeometry.Figures = myPathFigureCollection  
+  
+            Dim myPath As New Path()  
+            myPath.Stroke = Brushes.Black  
+            myPath.StrokeThickness = 1  
+            myPath.Data = myPathGeometry  
+```  
+  
+ この例はより大きなサンプルの一部完全なサンプルを参照してください、[ジオメトリ サンプル](http://go.microsoft.com/fwlink/?LinkID=159989)します。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Media.PathFigure>   
+ <xref:System.Windows.Media.PathGeometry>   
+ <xref:System.Windows.Media.GeometryDrawing>   
+ <xref:System.Windows.Shapes.Path>   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-new-bitmapsource.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-new-bitmapsource.md
new file mode 100644
index 00000000000..8ca8f405de4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-new-bitmapsource.md
@@ -0,0 +1,30 @@
+---
+title: "方法 : 新しい BitmapSource を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapSource オブジェクト, 作成"
+  - "作成 (新しい BitmapSource オブジェクトを)"
+ms.assetid: 0adf447e-014f-4ceb-97b2-f21affe6d55b
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : 新しい BitmapSource を作成する
+<xref:System.Windows.Media.Imaging.BitmapSource> の <xref:System.Windows.Media.Imaging.BitmapSource.Create%2A> メソッドを使用して新しい <xref:System.Windows.Media.Imaging.BitmapSource> オブジェクトを作成する方法を次の例に示します。  
+  
+## 使用例  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#BitmapSourceCreate](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/BitmapSourceExample.cs#bitmapsourcecreate)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#BitmapSourceCreate](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/BitmapSourceExample.vb#bitmapsourcecreate)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md
new file mode 100644
index 00000000000..26461f1df8c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 2 次ベジエ曲線を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ベジエ曲線, 作成"
+  - "グラフィックス [WPF], 2 次ベジエ曲線"
+  - "2 次ベジエ曲線, 作成"
+ms.assetid: cd8fca4a-504e-4fd8-92ea-2969065a6e02
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 2 次ベジエ曲線を作成する
+2 次ベジエ曲線を作成する方法を次の例に示します。  2 次ベジエ曲線を作成するには、<xref:System.Windows.Media.PathGeometry>、<xref:System.Windows.Media.PathFigure>、および <xref:System.Windows.Media.QuadraticBezierSegment> の各クラスを使用します。  
+  
+## 使用例  
+ 次の例では、2 次ベジエ曲線を \(10,100\) から \(300,100\) まで描画します。  曲線の制御点は \(200,200\) です。  
+  
+ \[xaml\]  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、属性の構文を使用してパスを記述できます。  
+  
+ [!code-xml[GeometrySample#54](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/geometryattributesyntaxexample.xaml#54)]  
+  
+ \[xaml\]  
+  
+ \(この属性構文は、実際には <xref:System.Windows.Media.PathGeometry> の軽量バージョンである <xref:System.Windows.Media.StreamGeometry> を作成します。  詳細については、「[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)」のページを参照してください。\)  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、オブジェクト要素構文を使用して 2 次ベジエ曲線を描画することもできます。  次の例は、前の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の例と同じです。  
+  
+ [!code-xml[GeometrySample#34](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#34)]  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+## 参照  
+ [楕円の円弧を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md)   
+ [3 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-reflection.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-reflection.md
new file mode 100644
index 00000000000..c1a186e98be
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-reflection.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 反射を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 作成 (反射を)"
+  - "作成 (反射を)"
+  - "反射, 作成"
+ms.assetid: 4f017e16-ab80-43c7-98df-03b6bddbb203
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 反射を作成する
+この例では、<xref:System.Windows.Media.VisualBrush> を使用して反射を作成する方法を示します。  <xref:System.Windows.Media.VisualBrush> は既存のビジュアルを表示できるため、この機能を使用して、反射や拡大など関心を引くための視覚効果を作成できます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.VisualBrush> を使用して、複数の要素が含まれる <xref:System.Windows.Controls.Border> の鏡像を作成します。  この例が生成する出力を次の図に示します。  
+  
+ ![反映された Visual オブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-visualbrush-reflection-small.png "graphicsmm\_visualbrush\_reflection\_small")  
+ビジュアル オブジェクトの鏡像  
+  
+ [!code-csharp[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/visualbrush_markup_snip/CSharp/ReflectionExample.cs#graphicsmmvisualbrushreflectionexamplewholepage)]
+ [!code-vb[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/visualbrush_markup_snip/visualbasic/reflectionexample.vb#graphicsmmvisualbrushreflectionexamplewholepage)]
+ [!code-xml[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/visualbrush_markup_snip/XAML/ReflectionExample.xaml#graphicsmmvisualbrushreflectionexamplewholepage)]  
+  
+ 画面の一部分を拡大する方法および反射を作成する方法の例を含むサンプル全体については、[VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.VisualBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md
new file mode 100644
index 00000000000..c646c5e6039
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : PathGeometry を使用して図形を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, PathGeometry"
+  - "グラフィックス [WPF], 形状"
+  - "PathGeometry クラス"
+  - "形状, 作成 (PathGeometry クラスを使用して)"
+ms.assetid: 49a4a8b7-e738-45be-8dac-b54a6d8f5b21
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : PathGeometry を使用して図形を作成する
+この例では、<xref:System.Windows.Media.PathGeometry> クラスを使用して図形を作成する方法を示します。  <xref:System.Windows.Media.PathGeometry> オブジェクトは 1 つ以上の <xref:System.Windows.Media.PathFigure> オブジェクトで構成され、各 <xref:System.Windows.Media.PathFigure> は異なる "形状" または図形を表します。  各 <xref:System.Windows.Media.PathFigure> 自体は 1 つ以上の <xref:System.Windows.Media.PathSegment> オブジェクトで構成されており、このオブジェクトは形状または図形の接続されている部分を表します。  セグメントの種類には、<xref:System.Windows.Media.LineSegment>、<xref:System.Windows.Media.ArcSegment>、<xref:System.Windows.Media.BezierSegment> などがあります。  
+  
+## 使用例  
+ 次の例は、<xref:System.Windows.Media.PathGeometry> を使用して三角形を作成しています。  <xref:System.Windows.Media.PathGeometry> は <xref:System.Windows.Shapes.Path> 要素を使用して表示されています。  
+  
+ [!code-xml[GeometrySample#49](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#49)]  
+  
+ 前の例で作成した図を次に示します。  
+  
+ ![PathGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-pathgeometry-triangle.png "wcpsdk\_graphicsmm\_pathgeometry\_triangle")  
+PathGeometry で作成された三角形  
+  
+ 前の例では、比較的単純な図形である三角形の作成方法を示しました。  <xref:System.Windows.Media.PathGeometry> を使用すると、円弧や曲線などのさらに複雑な図形も作成できます。  「[楕円の円弧を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md)」、「[3 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md)」、および「[2 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md)」の例を参照してください。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Path>   
+ <xref:System.Windows.Media.GeometryDrawing>   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md
new file mode 100644
index 00000000000..ebfbd70c698
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-using-a-streamgeometry.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : StreamGeometry を使用して図形を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, StreamGeometry"
+  - "グラフィックス [WPF], 形状"
+  - "形状, 作成 (StreamGeometry クラスを使用して)"
+  - "StreamGeometry クラス"
+ms.assetid: 08f7c8ce-074b-49cd-9aba-cc9592d4ee51
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : StreamGeometry を使用して図形を作成する
+<xref:System.Windows.Media.StreamGeometry> は、幾何学図形を作成するための <xref:System.Windows.Media.PathGeometry> の代替となる軽量クラスです。  複雑なジオメトリを作成する必要があるが、データ バインディング、アニメーション、または変更をサポートするためのオーバーヘッドが望ましくない場合は、<xref:System.Windows.Media.StreamGeometry> を使用します。  たとえば、<xref:System.Windows.Media.StreamGeometry> クラスは効率的であるため、装飾の表現に適しています。  
+  
+## 使用例  
+ 次の例では、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で属性構文を使用して三角形の <xref:System.Windows.Media.StreamGeometry> を作成します。  
+  
+ [!code-xml[GeometriesMiscSnippets_snip#StreamGeometryTriangleExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GeometriesMiscSnippets_snip/XAML/StreamGeometryExample.xaml#streamgeometrytriangleexamplewholepage)]  
+  
+ <xref:System.Windows.Media.StreamGeometry> 属性構文の詳細については、「[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)」のページを参照してください。  
+  
+## 使用例  
+ 次の例では、コードで <xref:System.Windows.Media.StreamGeometry> を使用して三角形を定義します。  最初に <xref:System.Windows.Media.StreamGeometry> を作成した後、<xref:System.Windows.Media.StreamGeometryContext> を取得し、そのコンテキストを使用して三角形を記述します。  
+  
+ [!code-csharp[GeometriesMiscSnippets_procedural_snip#StreamGeometryTriangleExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/CSharp/StreamGeometryTriangleExample.cs#streamgeometrytriangleexamplewholepage)]
+ [!code-vb[GeometriesMiscSnippets_procedural_snip#StreamGeometryTriangleExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/visualbasic/streamgeometrytriangleexample.vb#streamgeometrytriangleexamplewholepage)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.StreamGeometry> と <xref:System.Windows.Media.StreamGeometryContext> を使用して指定パラメーターに基づいて幾何学図形を定義するメソッドを作成します。  
+  
+ [!code-csharp[GeometriesMiscSnippets_procedural_snip#StreamGeometryExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/CSharp/StreamGeometryExample.cs#streamgeometryexamplewholepage)]
+ [!code-vb[GeometriesMiscSnippets_procedural_snip#StreamGeometryExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometriesMiscSnippets_procedural_snip/visualbasic/streamgeometryexample.vb#streamgeometryexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.PathGeometry>   
+ <xref:System.Windows.Media.StreamGeometry>   
+ <xref:System.Windows.Media.StreamGeometryContext>   
+ [PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md b/docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md
new file mode 100644
index 00000000000..60389ad6096
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-an-elliptical-arc.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : 楕円の円弧を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "円弧, 楕円"
+  - "楕円の円弧, 作成"
+  - "グラフィックス [WPF], 楕円の円弧"
+ms.assetid: 3dcfe502-3485-45de-99fb-d53a1367c484
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 楕円の円弧を作成する
+この例では、楕円の円弧を描画する方法を示します。  楕円の円弧を作成するには、<xref:System.Windows.Media.PathGeometry>、<xref:System.Windows.Media.PathFigure>、および <xref:System.Windows.Media.ArcSegment> の各クラスを使用します。  
+  
+## 使用例  
+ 次の例では、\(10,100\) から \(200,100\) までの範囲に楕円の円弧を描画します。  この円弧は、<xref:System.Windows.Media.ArcSegment.Size%2A> が 100 × 50 デバイス非依存ピクセル、<xref:System.Windows.Media.ArcSegment.RotationAngle%2A> が 45°、<xref:System.Windows.Media.ArcSegment.IsLargeArc%2A> が `true`、<xref:System.Windows.Media.ArcSegment.SweepDirection%2A> が <xref:System.Windows.Media.SweepDirection> にそれぞれ設定されます。  
+  
+ \[xaml\]  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、属性の構文を使用してパスを記述できます。  
+  
+ [!code-xml[GeometrySample#56](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/geometryattributesyntaxexample.xaml#56)]  
+  
+ \[xaml\]  
+  
+ \(この属性構文は、実際には <xref:System.Windows.Media.PathGeometry> の軽量バージョンである <xref:System.Windows.Media.StreamGeometry> を作成します。  詳細については、「[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)」のページを参照してください。\)  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、明示的にオブジェクト タグを使用して楕円の円弧を描画することもできます。  次に示す例は、前の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップと同等です。  
+  
+ [!code-xml[GeometrySample#36](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#36)]  
+  
+ この例は、より大きなサンプルの一部です。  サンプル全体については、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+## 参照  
+ [2 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-quadratic-bezier-curve.md)   
+ [3 次ベジエ曲線を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-cubic-bezier-curve.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-different-tile-patterns-with-a-tilebrush.md b/docs/framework/wpf/graphics-multimedia/how-to-create-different-tile-patterns-with-a-tilebrush.md
new file mode 100644
index 00000000000..85e17279a1d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-different-tile-patterns-with-a-tilebrush.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : TileBrush を使用してさまざまなタイル パターンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成, TileBrush を使用したタイル パターン"
+  - "タイル パターン, 作成"
+  - "TileBrush, 作成 (タイル パターンを)"
+ms.assetid: 5aa46632-3527-4668-9d8d-0375c8af28aa
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : TileBrush を使用してさまざまなタイル パターンを作成する
+この例では、<xref:System.Windows.Media.TileBrush> の <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティを使用してパターンを作成する方法を示します。  
+  
+ <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティを使用すると、<xref:System.Windows.Media.TileBrush> のコンテンツの繰り返し方法 \(並べて表示して出力領域を塗りつぶす\) を指定することができます。  パターンを作成するには、<xref:System.Windows.Media.TileBrush.TileMode%2A> を <xref:System.Windows.Media.TileMode>、<xref:System.Windows.Media.TileMode>、<xref:System.Windows.Media.TileMode>、または <xref:System.Windows.Media.TileMode> に設定します。  また、塗りつぶす領域よりもパターンが小さい場合を考慮し、<xref:System.Windows.Media.TileBrush> の <xref:System.Windows.Media.TileBrush.Viewport%2A> を設定する必要があります。これを設定しない場合は、<xref:System.Windows.Media.TileBrush.TileMode%2A> の設定にかかわらず、単一のタイルだけが生成されます。  
+  
+## 使用例  
+ 次の例では、5 つの <xref:System.Windows.Media.DrawingBrush> オブジェクトを作成し、それぞれ異なる <xref:System.Windows.Media.TileBrush.TileMode%2A> 設定を与え、5 つの四角形を描画するために使用します。  この例では <xref:System.Windows.Media.DrawingBrush> クラスを使用して <xref:System.Windows.Media.TileBrush.TileMode%2A> の動作を示していますが、<xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティは、すべての <xref:System.Windows.Media.TileBrush> オブジェクト、つまり <xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.VisualBrush>、および <xref:System.Windows.Media.DrawingBrush> に対してもまったく同じように動作します。  
+  
+ この例が生成する出力を次の図に示します。  
+  
+ ![TileBrush を並べて表示する例の出力結果](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawingbrushtilemodeexample.png "graphicsmm\_DrawingBrushTileModeExample")  
+TileMode プロパティで作成されたタイル パターン  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMDrawingBrushTileModeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/TileModeExample.cs#graphicsmmdrawingbrushtilemodeexample)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMDrawingBrushTileModeExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/tilemodeexample.vb#graphicsmmdrawingbrushtilemodeexample)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMDrawingBrushTileModeExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/TileModeExample.xaml#graphicsmmdrawingbrushtilemodeexample)]  
+  
+## 参照  
+ [TileBrush のタイル サイズを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-set-the-tile-size-for-a-tilebrush.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-create-multiple-subpaths-within-a-pathgeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-create-multiple-subpaths-within-a-pathgeometry.md
new file mode 100644
index 00000000000..c836587cdfa
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-create-multiple-subpaths-within-a-pathgeometry.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : PathGeometry 内に複数のサブパスを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, PathGeometry"
+  - "グラフィックス [WPF], サブパス"
+  - "複数のサブパス"
+  - "PathGeometry クラス"
+  - "サブパス"
+ms.assetid: 104a862c-dde2-4e62-ac87-80660dd1681c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : PathGeometry 内に複数のサブパスを作成する
+この例では、<xref:System.Windows.Media.PathGeometry> 内に複数のサブパスを作成する方法を示します。  複数のサブパスを作成するには、サブパスごとに <xref:System.Windows.Media.PathFigure> を作成します。  
+  
+## 使用例  
+ 次の例では、それぞれが三角形の 2 つのサブパスを作成します。  
+  
+ [!code-xml[GeometrySample#38](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#38)]  
+  
+ <xref:System.Windows.Shapes.Path> と [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] の属性構文を使用して複数のサブパスを作成する方法を次の例に示します。  それぞれが三角形を描画する 2 つのサブパスが作成されるように、各 `M` が新しいサブパスを作成します。  
+  
+ [!code-xml[GeometrySample#58](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/geometryattributesyntaxexample.xaml#58)]  
+  
+ \(この属性構文は、実際には <xref:System.Windows.Media.PathGeometry> の軽量バージョンである <xref:System.Windows.Media.StreamGeometry> を作成します。  詳細については、「[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)」のページを参照してください。\)  
+  
+## 参照  
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-define-a-name-scope.md b/docs/framework/wpf/graphics-multimedia/how-to-define-a-name-scope.md
new file mode 100644
index 00000000000..43240b180f0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-define-a-name-scope.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : 名前のスコープを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ストーリーボード, 手続き型コードでの"
+  - "名前のスコープ, 定義"
+  - "ストーリーボード, アニメーション化 (手続き型コードでの)"
+ms.assetid: 4f361925-6a08-40dc-8231-a61111c6b28b
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 名前のスコープを定義する
+コードで <xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーション化を行う場合は、<xref:System.Windows.NameScope> を作成し、その名前スコープを所有する要素にターゲット オブジェクトの名前を登録する必要があります。  次の例では、`myMainPanel` に対して <xref:System.Windows.NameScope> を作成します。  2 つのボタン `button1` と `button2` をパネルに追加し、その名前を登録します。  複数のアニメーションと <xref:System.Windows.Media.Animation.Storyboard> が作成されます。  アニメーションを開始するには、ストーリーボードの <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用します。  
+  
+ `button1`、`button2`、および `myMainPanel` はすべて同じ名前スコープを共有するため、いずれか 1 つを <xref:System.Windows.Media.Animation.Storyboard> <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドで使用して、アニメーションを開始できます。  
+  
+## 使用例  
+ [!code-csharp[StoryboardBeginAnimation_procedural_snip#NameScopeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/StoryboardBeginAnimation_procedural_snip/CSharp/ScopeExample.cs#namescopeexample)]
+ [!code-vb[StoryboardBeginAnimation_procedural_snip#NameScopeExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/StoryboardBeginAnimation_procedural_snip/visualbasic/scopeexample.vb#namescopeexample)]  
+  
+## 参照  
+ [ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-define-a-pen.md b/docs/framework/wpf/graphics-multimedia/how-to-define-a-pen.md
new file mode 100644
index 00000000000..6d47056bdff
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-define-a-pen.md
@@ -0,0 +1,32 @@
+---
+title: "方法 : ペンを定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "作成, ペン"
+  - "ペン, 定義"
+ms.assetid: 7a4f2900-cdf9-49de-84e0-ba5d0ded4d33
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 方法 : ペンを定義する
+この例では、<xref:System.Windows.Media.Pen> を使用して図形のアウトラインを描く方法を示します。  単純な <xref:System.Windows.Media.Pen> であれば、その <xref:System.Windows.Media.Pen.Thickness%2A> および <xref:System.Windows.Media.Pen.Brush%2A> を指定するだけで作成できます。  より複雑なペンを作成するには、<xref:System.Windows.Media.Pen.DashStyle%2A>、<xref:System.Windows.Media.Pen.DashCap%2A>、<xref:System.Windows.Media.Pen.LineJoin%2A>、<xref:System.Windows.Media.Pen.StartLineCap%2A>、および <xref:System.Windows.Media.Pen.EndLineCap%2A> を指定します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Pen> を使用して、<xref:System.Windows.Media.GeometryDrawing> で定義された図形のアウトラインを描く例を次に示します。  
+  
+ [!code-csharp[PenExamples_snip#PenExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PenExamples_snip/CSharp/PenExample.cs#penexamplewholepage)]
+ [!code-vb[PenExamples_snip#PenExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PenExamples_snip/VisualBasic/PenExample.vb#penexamplewholepage)]  
+  
+ ![外枠はペンによって作成されます](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-simple-pen.png "graphicsmm\_simple\_pen")  
+GeometryDrawing
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-define-a-rectangle-using-a-rectanglegeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-define-a-rectangle-using-a-rectanglegeometry.md
new file mode 100644
index 00000000000..1055c00e98b
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-define-a-rectangle-using-a-rectanglegeometry.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : RectangleGeometry を使用して四角形を定義する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, RectangleGeometry"
+  - "グラフィックス [WPF], 四角形"
+  - "RectangleGeometry クラス"
+  - "四角形, 作成 (RectangleGeometry クラスを使用して)"
+ms.assetid: e40b8a8e-54b8-416b-a9f2-be6dca9fdf0b
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : RectangleGeometry を使用して四角形を定義する
+この例では、<xref:System.Windows.Media.RectangleGeometry> クラスを使用して四角形を記述する方法を説明します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.RectangleGeometry> オブジェクトを作成してレンダリングする方法の例を次に示します。  四角形の相対位置およびサイズは、<xref:System.Windows.Rect> 構造体によって定義されます。  相対位置は `50,50`、高さと幅は両方とも `25` で、正方形が作成されます。  四角形の内部は <xref:System.Windows.Media.Brushes.LemonChiffon%2A> ブラシで塗りつぶし、アウトラインは太さ `1` の <xref:System.Windows.Media.Brushes.Black%2A> ストロークで描きます。  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/GeometryExamples.xaml#graphicsmmrectanglegeometryexample)]  
+  
+ [!code-csharp[GeometryOverviewSamples_procedural_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/CSharp/GeometryExamples.cs#graphicsmmrectanglegeometryexample)]
+ [!code-vb[GeometryOverviewSamples_procedural_snip#GraphicsMMRectangleGeometryExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GeometryOverviewSamples_procedural_snip/visualbasic/geometryexamples.vb#graphicsmmrectanglegeometryexample)]  
+  
+ ![RectangleGeometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rectangle.png "graphicsmm\_rectangle")  
+RectangleGeometry  
+  
+ この例では、<xref:System.Windows.Shapes.Path> 要素を <xref:System.Windows.Media.RectangleGeometry> のレンダリングに使用しましたが、<xref:System.Windows.Media.RectangleGeometry> オブジェクトには他にもさまざまな使用方法があります。  たとえば、<xref:System.Windows.Media.RectangleGeometry> を使用して <xref:System.Windows.UIElement> の <xref:System.Windows.UIElement.Clip%2A> や <xref:System.Windows.Media.GeometryDrawing> の <xref:System.Windows.Media.GeometryDrawing.Geometry%2A> を指定できます。  
+  
+ その他の単純な図形座標クラスとして、<xref:System.Windows.Media.LineGeometry>、<xref:System.Windows.Media.EllipseGeometry> などがあります。  これらの図形座標およびさらに複雑な図形座標は、<xref:System.Windows.Media.PathGeometry> または <xref:System.Windows.Media.StreamGeometry> を使用して作成することもできます。  
+  
+## 参照  
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)   
+ [PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-a-closed-shape-by-using-the-polygon-element.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-closed-shape-by-using-the-polygon-element.md
new file mode 100644
index 00000000000..16082b38699
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-closed-shape-by-using-the-polygon-element.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : 多角形要素を使用して、閉じた図形を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "閉じた図形, 描画 (Polygon 要素で)"
+  - "描画, 閉じた図形 (Polygon 要素で)"
+  - "グラフィックス, Polygon 要素"
+  - "Polygon 要素"
+ms.assetid: 4b0ca008-29ce-48dd-8bc3-f3a20ffca6a6
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 多角形要素を使用して、閉じた図形を描画する
+この例では、<xref:System.Windows.Shapes.Polygon> 要素を使用して閉じた図形を描画する方法を示します。  閉じた図形を描画するには、<xref:System.Windows.Shapes.Polygon> 要素を作成し、その <xref:System.Windows.Shapes.Polygon.Points%2A> プロパティを使用して図形の各頂点を指定します。  最初と最後の点を結ぶ線が自動的に描画されます。  最後に、<xref:System.Windows.Shapes.Shape.Fill%2A>、<xref:System.Windows.Shapes.Shape.Stroke%2A>、またはその両方を指定します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、頂点を表す有効な構文は、コンマ区切りの x 座標と y 座標のペアをスペースで区切ったリストです。  
+  
+ [!code-xml[drawingwithshapeelements#PolygonExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/polygonexample.xaml#polygonexample1)]  
+  
+ この例では <xref:System.Windows.Controls.Canvas> を使用して多角形を組み込みますが、テキスト以外のコンテンツをサポートする任意の <xref:System.Windows.Controls.Panel> や <xref:System.Windows.Controls.Control> でも、多角形要素 \(および他のすべての図形要素\) を使用できます。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-a-line.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-line.md
new file mode 100644
index 00000000000..6c7c3adb0e0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-line.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : 線を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "描画, 線"
+  - "グラフィックス [WPF], 線"
+  - "線, 描画"
+ms.assetid: 0513ee01-6b27-4bb3-85f3-3a3e6710d80e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 線を描画する
+この例では、<xref:System.Windows.Shapes.Line> 要素を使用して線を描画する方法を示します。  
+  
+ 線を描画するには、<xref:System.Windows.Shapes.Line> 要素を作成します。  その要素の <xref:System.Windows.Shapes.Line.X1%2A> プロパティと <xref:System.Windows.Shapes.Line.Y1%2A> プロパティを使用して線の始点を設定し、<xref:System.Windows.Shapes.Line.X2%2A> プロパティと <xref:System.Windows.Shapes.Line.Y2%2A> プロパティを使用して終点を設定します。  ストロークのない線は表示されないため、最後に <xref:System.Windows.Shapes.Shape.Stroke%2A> と <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> を設定します。  
+  
+ 線には内部領域がないので、線の <xref:System.Windows.Shapes.Shape.Fill%2A> 要素を設定しても効果はありません。  
+  
+ <xref:System.Windows.Controls.Canvas> 要素の内側に 3 本の線を描画する例を次に示します。  
+  
+## 使用例  
+ [!code-xml[drawingwithshapeelements#LineExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/lineexample.xaml#lineexample1)]  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Line>   
+ [Shape 要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-a-polyline-by-using-the-polyline-element.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-polyline-by-using-the-polyline-element.md
new file mode 100644
index 00000000000..33e67e00e4c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-polyline-by-using-the-polyline-element.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : ポリライン要素を使用してポリラインを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "連結した線"
+  - "描画, ポリライン"
+  - "グラフィックス [WPF], ポリライン"
+  - "線, 接続 ("ポリライン" を参照)"
+  - "ポリライン, 描画"
+ms.assetid: 65db8935-d047-4295-87c4-b427ff3ad293
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ポリライン要素を使用してポリラインを描画する
+この例では、<xref:System.Windows.Shapes.Polyline> 要素を使用して、接続された一連の線であるポリラインを描画する方法を示します。  
+  
+ ポリラインを描画するには、<xref:System.Windows.Shapes.Polyline> 要素を作成し、その <xref:System.Windows.Shapes.Polyline.Points%2A> プロパティを使用して図形の頂点を指定します。  最後に、<xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティと <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> プロパティを使用して、ポリライン アウトラインを描きます。ストロークのない線は表示されません。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Shapes.Polyline> 要素は閉じた図形でないため、意図的に図形のアウトラインを閉じた場合でも、<xref:System.Windows.Shapes.Shape.Fill%2A> プロパティは無効です。  閉じた図形を <xref:System.Windows.Shapes.Shape.Fill%2A> で作成するには、<xref:System.Windows.Shapes.Polygon> 要素を使用します。  
+  
+ <xref:System.Windows.Controls.Canvas> 内に、2 つの <xref:System.Windows.Shapes.Polyline> 要素を描画する例を次に示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、頂点を表す有効な構文は、コンマ区切りの x 座標と y 座標のペアをスペースで区切ったリストです。  
+  
+ [!code-xml[drawingwithshapeelements#PolylineExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/polylineexample.xaml#polylineexample1)]  
+  
+ この例では <xref:System.Windows.Controls.Canvas> を使用してポリラインを組み込みますが、テキスト以外のコンテンツをサポートする任意の <xref:System.Windows.Controls.Panel> や <xref:System.Windows.Controls.Control> でも、ポリライン要素 \(および他のすべての図形要素\) を使用できます。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Polyline>   
+ <xref:System.Windows.Shapes.Polygon>   
+ <xref:System.Windows.Shapes.Shape>   
+ [図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-a-rectangle.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-rectangle.md
new file mode 100644
index 00000000000..97cf3a83614
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-a-rectangle.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 四角形を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "描画, 四角形"
+  - "グラフィックス [WPF], 四角形"
+  - "四角形, 描画"
+ms.assetid: beeb57ef-fab5-4446-a38a-1588f97b4c2f
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 四角形を描画する
+この例では、<xref:System.Windows.Shapes.Rectangle> 要素を使用して四角形を描画する方法を示します。  
+  
+ 四角形を描画するには、<xref:System.Windows.Shapes.Rectangle> 要素を作成し、<xref:System.Windows.FrameworkElement.Width%2A> と <xref:System.Windows.FrameworkElement.Height%2A> を指定します。  四角形の内側を塗りつぶすには、<xref:System.Windows.Shapes.Shape.Fill%2A> を設定します。  四角形のアウトラインを描画するには、<xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティと <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> プロパティを使用します。  
+  
+ 四角形の角を丸くするには、オプションの <xref:System.Windows.Shapes.Rectangle.RadiusX%2A> プロパティと <xref:System.Windows.Shapes.Rectangle.RadiusY%2A> プロパティを指定します。  <xref:System.Windows.Shapes.Rectangle.RadiusX%2A> プロパティと <xref:System.Windows.Shapes.Rectangle.RadiusY%2A> プロパティは、四角形の角に丸みを付けるために使用される楕円の x 軸半径と y 軸半径を設定します。  
+  
+ 次の例では、2 つの <xref:System.Windows.Shapes.Rectangle> 要素が <xref:System.Windows.Controls.Canvas> 内に描画されます。  最初の四角形は、内側が <xref:System.Windows.Media.Brushes.Blue%2A> です。  2 番目の四角形は、内側が <xref:System.Windows.Media.Brushes.Blue%2A>、アウトラインが <xref:System.Windows.Media.Brushes.Black%2A> で角が丸くなります。  
+  
+## 使用例  
+ [!code-xml[drawingwithshapeelements#Rectangle1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/rectangleexample.xaml#rectangle1)]  
+  
+ この例では <xref:System.Windows.Controls.Canvas> を使用して四角形を組み込みますが、テキスト以外のコンテンツをサポートする任意の <xref:System.Windows.Controls.Panel> や <xref:System.Windows.Controls.Control> でも、四角形要素 \(および他のすべての図形要素\) を使用できます。  実際、四角形は、<xref:System.Windows.Controls.Grid> パネルの一部へ背景を提供するのに特に役立ちます。  例については、「[テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)」を参照してください。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Rectangle>   
+ [図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [テーブルの概要](../../../../docs/framework/wpf/advanced/table-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-an-ellipse-or-a-circle.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-an-ellipse-or-a-circle.md
new file mode 100644
index 00000000000..75432771092
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-an-ellipse-or-a-circle.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 楕円または円を描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "円, 描画"
+  - "描画 (円を)"
+  - "描画 (楕円を)"
+  - "楕円, 描画"
+  - "グラフィックス, 描画 (円を)"
+  - "グラフィックス, 描画 (楕円を)"
+ms.assetid: 99763b8c-bfc8-44be-8231-8a70daf5481a
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 楕円または円を描画する
+この例では、<xref:System.Windows.Shapes.Ellipse> 要素を使用して楕円および円を描画する方法を示します。  楕円を描画するには、<xref:System.Windows.Shapes.Ellipse> 要素を作成して <xref:System.Windows.FrameworkElement.Width%2A> と <xref:System.Windows.FrameworkElement.Height%2A> を指定します。  楕円の内部を塗りつぶすために使用する <xref:System.Windows.Media.Brush> を指定するには、<xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを使用します。  楕円のアウトラインを塗りつぶすために使用する <xref:System.Windows.Media.Brush> を指定するには、<xref:System.Windows.Shapes.Shape.Stroke%2A> プロパティを使用します。  <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> プロパティは、楕円のアウトラインの太さを指定します。  
+  
+ 円を描画するには、<xref:System.Windows.Shapes.Ellipse> 要素の <xref:System.Windows.FrameworkElement.Width%2A> と <xref:System.Windows.FrameworkElement.Height%2A> を同じ値にします。  
+  
+ 次の例では、<xref:System.Windows.Controls.Canvas> 内に 4 つの <xref:System.Windows.Shapes.Ellipse> 要素を描画します。  
+  
+## 使用例  
+ [!code-xml[drawingwithshapeelements#EllipseExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/ellipseexample.xaml#ellipseexample1)]  
+  
+ この例では <xref:System.Windows.Controls.Canvas> を使用して楕円を組み込みますが、テキスト以外のコンテンツをサポートする任意の <xref:System.Windows.Controls.Panel> や <xref:System.Windows.Controls.Control> でも、楕円要素 \(および他のすべての図形要素\) を使用できます。  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Ellipse>   
+ <xref:System.Windows.Shapes.Shape>   
+ [図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-draw-an-image-using-imagedrawing.md b/docs/framework/wpf/graphics-multimedia/how-to-draw-an-image-using-imagedrawing.md
new file mode 100644
index 00000000000..c6bdb8ee5ab
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-draw-an-image-using-imagedrawing.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ImageDrawing を使用してイメージを描画する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, ImageDrawing"
+  - "描画, イメージ"
+  - "グラフィックス, 描画 (イメージを)"
+  - "ImageDrawing クラス"
+  - "イメージ, 描画"
+ms.assetid: df28ab41-25fb-4ab3-b51d-7f695b24f55e
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : ImageDrawing を使用してイメージを描画する
+この例では、<xref:System.Windows.Media.ImageDrawing> を使用してイメージを描画する方法を示します。  <xref:System.Windows.Media.ImageDrawing> では、<xref:System.Windows.Media.DrawingBrush>、<xref:System.Windows.Media.DrawingImage>、または <xref:System.Windows.Media.Visual> を使用して <xref:System.Windows.Media.ImageSource> を表示できます。  イメージを描画するには、<xref:System.Windows.Media.ImageDrawing> を作成して、その <xref:System.Windows.Media.ImageDrawing.ImageSource%2A?displayProperty=fullName> プロパティと <xref:System.Windows.Media.ImageDrawing.Rect%2A?displayProperty=fullName> プロパティを設定します。  <xref:System.Windows.Media.ImageDrawing.ImageSource%2A?displayProperty=fullName> プロパティは描画するイメージを指定し、<xref:System.Windows.Media.ImageDrawing.Rect%2A?displayProperty=fullName> プロパティは各イメージの位置とサイズを指定します。  
+  
+## 使用例  
+ 4 つの <xref:System.Windows.Media.ImageDrawing> オブジェクトを使用して 1 つの複合描画を作成する例を次に示します。  この例を実行すると、次のイメージが生成されます。  
+  
+ ![複数の DrawingImage オブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-imagedrawingexample.png "graphicsmm\_ImageDrawingExample")  
+4 つの ImageDrawing オブジェクト  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#ImageDrawingExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/ImageDrawingExample.cs#imagedrawingexample)]
+ [!code-xml[DrawingMiscSnippets_snip#ImageDrawingExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/ImageDrawingExample.xaml#imagedrawingexample)]  
+  
+ <xref:System.Windows.Media.ImageDrawing> を使用せずにイメージを表示する簡単な方法の例については、「[イメージ要素を使用する](../../../../docs/framework/wpf/controls/how-to-use-the-image-element.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Freezable.Freeze%2A>   
+ <xref:System.Windows.Controls.Image>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [PresentationOptions:Freeze 属性](../../../../docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-a-visual-to-an-image-file.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-a-visual-to-an-image-file.md
new file mode 100644
index 00000000000..c44f90d6e97
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-a-visual-to-an-image-file.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : ビジュアルをイメージ ファイルにエンコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エンコード (イメージ形式を)"
+  - "イメージ ファイル, エンコード (ビジュアルから)"
+  - "ビジュアル, エンコード (イメージ ファイルに)"
+ms.assetid: 2036385b-ea47-4d54-8027-5797f52c8149
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : ビジュアルをイメージ ファイルにエンコードする
+この例では、<xref:System.Windows.Media.Imaging.RenderTargetBitmap> と <xref:System.Windows.Media.Imaging.PngBitmapEncoder> を使用して <xref:System.Windows.Media.Visual> オブジェクトをイメージ ファイルにエンコードする方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Imaging.BitmapImage> と <xref:System.Windows.Media.FormattedText> を使用して <xref:System.Windows.Media.DrawingVisual> を作成し、<xref:System.Windows.Media.Imaging.RenderTargetBitmap> にレンダリングします。  次に、レンダリングしたビットマップを使用して <xref:System.Windows.Media.Imaging.BitmapFrame> を作成し、それを <xref:System.Windows.Media.Imaging.PngBitmapEncoder> に追加して新しい[!INCLUDE[TLA#tla_png](../../../../includes/tlasharptla-png-md.md)] ファイルを作成します。  
+  
+ [!code-csharp[ImagingSnippetGallery_procedural_snip#RTBEncodeInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/CSharp/RenderTargetBitmapExample_Encode.cs#rtbencodeinline1)]
+ [!code-vb[ImagingSnippetGallery_procedural_snip#RTBEncodeInline1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImagingSnippetGallery_procedural_snip/VB/RenderTargetBitmapExample_Encode.vb#rtbencodeinline1)]  
+  
+ この例では <xref:System.Windows.Media.Imaging.PngBitmapEncoder> を使用しましたが、<xref:System.Windows.Media.Imaging.BitmapEncoder> から派生した任意のオブジェクトを使用して、イメージ ファイルを作成できます。  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingContext>   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-bmp-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-bmp-image.md
new file mode 100644
index 00000000000..255eb74366c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-bmp-image.md
@@ -0,0 +1,44 @@
+---
+title: "方法: BMP イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BMP のデコード"
+  - "BMP のエンコード"
+  - "デコード (BMP イメージを)"
+  - "デコード (イメージ形式を)"
+  - "エンコード (BMP イメージを)"
+  - "エンコード (イメージ形式を)"
+ms.assetid: feb5ef27-28ac-40ab-bfc2-e0456990d32c
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法: BMP イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.BmpBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.BmpBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_bmp](../../../../includes/tlasharptla-bmp-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Uri> から <xref:System.Windows.Media.Imaging.BmpBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_bmp](../../../../includes/tla2sharptla-bmp-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CPP/anotherfile.cpp#5)]
+ [!code-csharp[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CSharp/BitmapFrame.cs#5)]
+ [!code-vb[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/VB/BitmapFrame.vb#5)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.BmpBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_bmp](../../../../includes/tla2sharptla-bmp-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[BmpBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CPP/anotherfile.cpp#4)]
+ [!code-csharp[BmpBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CSharp/BitmapFrame.cs#4)]
+ [!code-vb[BmpBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/VB/BitmapFrame.vb#4)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-gif-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-gif-image.md
new file mode 100644
index 00000000000..02470111125
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-gif-image.md
@@ -0,0 +1,44 @@
+---
+title: "方法: GIF イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デコード (GIF イメージを)"
+  - "デコード (イメージ形式を)"
+  - "エンコード (GIF イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "GIF のデコード"
+  - "GIF のエンコード"
+ms.assetid: 9cdd9ec7-71eb-444b-b9e3-991958461163
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法: GIF イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.GifBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.GifBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_gif](../../../../includes/tlasharptla-gif-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.IO.FileStream> から <xref:System.Windows.Media.Imaging.GifBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_gif](../../../../includes/tla2sharptla-gif-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[GifBitmapDecoderEncoder#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/GifBitmapDecoderEncoder/CPP/GifEncoderDecoder.cpp#1)]
+ [!code-csharp[GifBitmapDecoderEncoder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GifBitmapDecoderEncoder/CSharp/GifEncoderDecoder.cs#1)]
+ [!code-vb[GifBitmapDecoderEncoder#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GifBitmapDecoderEncoder/VB/GifEncoderDecoder.vb#1)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.GifBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_gif](../../../../includes/tla2sharptla-gif-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[GifBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/GifBitmapDecoderEncoder/CPP/GifEncoderDecoder.cpp#4)]
+ [!code-csharp[GifBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GifBitmapDecoderEncoder/CSharp/GifEncoderDecoder.cs#4)]
+ [!code-vb[GifBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/GifBitmapDecoderEncoder/VB/GifEncoderDecoder.vb#4)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-jpeg-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-jpeg-image.md
new file mode 100644
index 00000000000..b17e2079720
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-jpeg-image.md
@@ -0,0 +1,46 @@
+---
+title: "方法: JPEG イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デコード (イメージ形式を)"
+  - "デコード (JPEG イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "エンコード (JPEG イメージを)"
+  - "JPEG のデコード"
+  - "JPEG のエンコード"
+ms.assetid: b8cfde37-9f68-4911-a05e-51d8d7bdec7b
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法: JPEG イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.JpegBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.JpegBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_jpeg](../../../../includes/tlasharptla-jpeg-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.IO.FileStream> から <xref:System.Windows.Media.Imaging.JpegBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_jpeg](../../../../includes/tla2sharptla-jpeg-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[JpegBitmapDecoderEncoder#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/CPP/jpegencoderdecoder.cpp#1)]
+ [!code-csharp[JpegBitmapDecoderEncoder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/CSharp/JpegEncoderDecoder.cs#1)]
+ [!code-vb[JpegBitmapDecoderEncoder#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/VB/JpegEncoderDecoder.vb#1)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.JpegBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_jpeg](../../../../includes/tla2sharptla-jpeg-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[JpegBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/CPP/jpegencoderdecoder.cpp#4)]
+ [!code-csharp[JpegBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/CSharp/JpegEncoderDecoder.cs#4)]
+ [!code-vb[JpegBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/JpegBitmapDecoderEncoder/VB/JpegEncoderDecoder.vb#4)]  
+  
+## .NET Framework セキュリティ  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-png-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-png-image.md
new file mode 100644
index 00000000000..af2c59216d6
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-png-image.md
@@ -0,0 +1,44 @@
+---
+title: "方法: PNG イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デコード (イメージ形式を)"
+  - "デコード (PNG イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "エンコード (PNG イメージを)"
+  - "PNG のデコード"
+  - "PNG のエンコード"
+ms.assetid: 3d31d186-af73-47f0-b5a7-c26ae46409a6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法: PNG イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.PngBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.PngBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_png](../../../../includes/tlasharptla-png-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.IO.FileStream> から <xref:System.Windows.Media.Imaging.PngBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_png](../../../../includes/tla2sharptla-png-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[PngBitmapDecoderEncoder#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PngBitmapDecoderEncoder/CPP/PngEncoderDecoder.cpp#1)]
+ [!code-csharp[PngBitmapDecoderEncoder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PngBitmapDecoderEncoder/CSharp/PngEncoderDecoder.cs#1)]
+ [!code-vb[PngBitmapDecoderEncoder#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PngBitmapDecoderEncoder/VB/PngEncoderDecoder.vb#1)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.PngBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_png](../../../../includes/tla2sharptla-png-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[PngBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/PngBitmapDecoderEncoder/CPP/PngEncoderDecoder.cpp#4)]
+ [!code-csharp[PngBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PngBitmapDecoderEncoder/CSharp/PngEncoderDecoder.cs#4)]
+ [!code-vb[PngBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PngBitmapDecoderEncoder/VB/PngEncoderDecoder.vb#4)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-tiff-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-tiff-image.md
new file mode 100644
index 00000000000..f3e1abe47e4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-tiff-image.md
@@ -0,0 +1,44 @@
+---
+title: "方法: TIFF イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デコード (イメージ形式を)"
+  - "デコード (TIFF イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "エンコード (TIFF イメージを)"
+  - "TIFF のデコード"
+  - "TIFF のエンコード"
+ms.assetid: 1dfe3209-fc73-40e6-ad1c-71c1c58b3364
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: TIFF イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.TiffBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.TiffBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_tiff](../../../../includes/tlasharptla-tiff-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Uri> から <xref:System.Windows.Media.Imaging.TiffBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_tiff](../../../../includes/tla2sharptla-tiff-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[TiffBitmapDecoderEncoder#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/CPP/TiffEncoderDecoder.cpp#1)]
+ [!code-csharp[TiffBitmapDecoderEncoder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/CSharp/TiffEncoderDecoder.cs#1)]
+ [!code-vb[TiffBitmapDecoderEncoder#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/VB/TiffEncoderDecoder.vb#1)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.TiffBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_tiff](../../../../includes/tla2sharptla-tiff-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[TiffBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/CPP/TiffEncoderDecoder.cpp#4)]
+ [!code-csharp[TiffBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/CSharp/TiffEncoderDecoder.cs#4)]
+ [!code-vb[TiffBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/TiffBitmapDecoderEncoder/VB/TiffEncoderDecoder.vb#4)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-wdp-image.md b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-wdp-image.md
new file mode 100644
index 00000000000..04abbcdae5f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-wdp-image.md
@@ -0,0 +1,44 @@
+---
+title: "方法: WDP イメージをエンコードおよびデコードする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デコード (イメージ形式を)"
+  - "デコード (WDP イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "エンコード (WDP イメージを)"
+  - "WDP のデコード"
+  - "WDP のエンコード"
+ms.assetid: 911777d1-516b-49db-a87b-b54e31b18532
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: WDP イメージをエンコードおよびデコードする
+次の例では、特定の <xref:System.Windows.Media.Imaging.WmpBitmapDecoder> オブジェクトと <xref:System.Windows.Media.Imaging.WmpBitmapEncoder> オブジェクトを使用して、[!INCLUDE[TLA#tla_wdp](../../../../includes/tlasharptla-wdp-md.md)] イメージをデコードおよびエンコードする方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Uri> から <xref:System.Windows.Media.Imaging.WmpBitmapDecoder> を使用して [!INCLUDE[TLA2#tla_wdp](../../../../includes/tla2sharptla-wdp-md.md)] イメージをデコードする方法を示します。  
+  
+ [!code-cpp[WdpBitmapDecoderEncoder#1](../../../../samples/snippets/cpp/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/CPP/WDPEncoderDecoder.cpp#1)]
+ [!code-csharp[WdpBitmapDecoderEncoder#1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/CSharp/WDPEncoderDecoder.cs#1)]
+ [!code-vb[WdpBitmapDecoderEncoder#1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/VB/WDPEncoderDecoder.vb#1)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Imaging.WmpBitmapEncoder> を使用して、<xref:System.Windows.Media.Imaging.BitmapSource> を [!INCLUDE[TLA2#tla_wdp](../../../../includes/tla2sharptla-wdp-md.md)] イメージにエンコードする方法を示します。  
+  
+ [!code-cpp[WdpBitmapDecoderEncoder#4](../../../../samples/snippets/cpp/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/CPP/WDPEncoderDecoder.cpp#4)]
+ [!code-csharp[WdpBitmapDecoderEncoder#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/CSharp/WDPEncoderDecoder.cs#4)]
+ [!code-vb[WdpBitmapDecoderEncoder#4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WdpBitmapDecoderEncoder/VB/WDPEncoderDecoder.vb#4)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-enumerate-drawing-content-of-a-visual.md b/docs/framework/wpf/graphics-multimedia/how-to-enumerate-drawing-content-of-a-visual.md
new file mode 100644
index 00000000000..125b09548e2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-enumerate-drawing-content-of-a-visual.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : ビジュアルの描画コンテンツを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙 (Visual のコンテンツを) [WPF]"
+  - "取得 (Visual の DrawingGroup 値を) [WPF]"
+ms.assetid: 2974ddb3-2997-4713-8fd2-e93d549c58a8
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法 : ビジュアルの描画コンテンツを列挙する
+<xref:System.Windows.Media.Drawing> オブジェクトは、<xref:System.Windows.Media.Visual> のコンテンツを列挙するためのオブジェクト モデルを提供します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.VisualTreeHelper.GetDrawing%2A> メソッドを使用して、<xref:System.Windows.Media.Visual> の <xref:System.Windows.Media.DrawingGroup> 値を取得し列挙する例を次に示します。  
+  
+> [!NOTE]
+>  ビジュアルのコンテンツの列挙の際には、ベクター グラフィックス命令リストとして基になるレンダリング データ表現を取得しているのではなく、<xref:System.Windows.Media.Drawing> オブジェクトを取得しています。  詳細については、「[WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)」を参照してください。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMRetrieveDrawings](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/EnumerateDrawingsExample.xaml.cs#graphicsmmretrievedrawings)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Drawing>   
+ <xref:System.Windows.Media.DrawingGroup>   
+ <xref:System.Windows.Media.VisualTreeHelper>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-get-the-offset-of-a-visual.md b/docs/framework/wpf/graphics-multimedia/how-to-get-the-offset-of-a-visual.md
new file mode 100644
index 00000000000..f59a47884cc
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-get-the-offset-of-a-visual.md
@@ -0,0 +1,75 @@
+---
+title: "方法 : ビジュアルのオフセットを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "取得 (ビジュアル オブジェクトからオフセット値を)"
+  - "オフセット値, 取得 (ビジュアル オブジェクトから)"
+  - "取得 (ビジュアル オブジェクトからオフセット値を)"
+  - "ビジュアル オブジェクト, 取得 (オフセット値を)"
+ms.assetid: 889a1dd6-1b11-445a-b351-fbb04c53ee34
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ビジュアルのオフセットを取得する
+この例では、親、先祖、または子孫を基準とした相対値である、ビジュアル オブジェクトのオフセット値を取得する方法を示します。  
+  
+## 使用例  
+ 次に示すマークアップの例では、<xref:System.Windows.Controls.TextBlock> の <xref:System.Windows.FrameworkElement.Margin%2A> の値に 4 が指定されています。  
+  
+ [!code-xml[VisualSnippets#VisualSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window1.xaml#visualsnippet1)]  
+  
+ <xref:System.Windows.Media.VisualTreeHelper.GetOffset%2A> メソッドを使用して <xref:System.Windows.Controls.TextBlock> のオフセットを取得する方法を次の例に示します。  オフセット値は、返される <xref:System.Windows.Vector> 値に含まれます。  
+  
+ [!code-csharp[VisualSnippets#VisualSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window1.xaml.cs#visualsnippet2)]
+ [!code-vb[VisualSnippets#VisualSnippet2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualSnippets/visualbasic/window1.xaml.vb#visualsnippet2)]  
+  
+ オフセットでは、<xref:System.Windows.FrameworkElement.Margin%2A> 値が考慮されます。  ここでは、<xref:System.Windows.Vector.X%2A> は 4 で、<xref:System.Windows.Vector.Y%2A> も 4 です。  
+  
+ 返されるオフセット値は、<xref:System.Windows.Media.Visual> の親を基準とする相対値です。  <xref:System.Windows.Media.Visual> の親が基準ではないオフセット値を返す必要がある場合は、<xref:System.Windows.Media.Visual.TransformToAncestor%2A> メソッドを使用します。  
+  
+## 先祖を基準としたオフセットの取得  
+ 2 つの <xref:System.Windows.Controls.StackPanel> オブジェクトの中で入れ子になっている <xref:System.Windows.Controls.TextBlock> のマークアップ例を次に示します。  
+  
+ [!code-xml[VisualSnippets#VisualSnippet7](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window2.xaml#visualsnippet7)]  
+  
+ マークアップの結果を次の図に示します。  
+  
+ ![オブジェクトのオフセット値](../../../../docs/framework/wpf/graphics-multimedia/media/visualoffset-01.png "VisualOffset\_01")  
+2 つの StackPanel 内で入れ子にされた TextBlock  
+  
+ <xref:System.Windows.Media.Visual.TransformToAncestor%2A> メソッドを使用して、<xref:System.Windows.Controls.TextBlock> のオフセットを、このオブジェクトを格納している <xref:System.Windows.Window> を基準として取得する方法を次のコード例に示します。  オフセット値は、返される <xref:System.Windows.Media.GeneralTransform> 値に含まれます。  
+  
+ [!code-csharp[VisualSnippets#VisualSnippet5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window1.xaml.cs#visualsnippet5)]
+ [!code-vb[VisualSnippets#VisualSnippet5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualSnippets/visualbasic/window1.xaml.vb#visualsnippet5)]  
+  
+ オフセットの値は、そのオブジェクトを格納している <xref:System.Windows.Window> 内のすべてのオブジェクトの <xref:System.Windows.FrameworkElement.Margin%2A> 値を考慮して計算されます。  この例では、<xref:System.Windows.Vector.X%2A> は 28 \(16 \+ 8 \+ 4\) で、<xref:System.Windows.Vector.Y%2A> も 28 です。  
+  
+ 返されるオフセット値は、<xref:System.Windows.Media.Visual> の先祖を基準としています。  <xref:System.Windows.Media.Visual> の子孫を基準とするオフセット値を返す必要がある場合は、<xref:System.Windows.Media.Visual.TransformToDescendant%2A> メソッドを使用します。  
+  
+## 子孫を基準としたオフセットの取得  
+ <xref:System.Windows.Controls.StackPanel> オブジェクトに格納されている <xref:System.Windows.Controls.TextBlock> のマークアップ例を次に示します。  
+  
+ [!code-xml[VisualSnippets#VisualSnippet4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window1.xaml#visualsnippet4)]  
+  
+ <xref:System.Windows.Media.Visual.TransformToDescendant%2A> メソッドを使用して、子 <xref:System.Windows.Controls.TextBlock> を基準にして <xref:System.Windows.Controls.StackPanel> のオフセットを取得する方法を次のコード例に示します。  オフセット値は、返される <xref:System.Windows.Media.GeneralTransform> 値に含まれます。  
+  
+ [!code-csharp[VisualSnippets#VisualSnippet9](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualSnippets/CSharp/Window1.xaml.cs#visualsnippet9)]
+ [!code-vb[VisualSnippets#VisualSnippet9](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualSnippets/visualbasic/window1.xaml.vb#visualsnippet9)]  
+  
+ オフセットでは、すべてのオブジェクトの <xref:System.Windows.FrameworkElement.Margin%2A> 値が考慮されます。  ここでは、<xref:System.Windows.Vector.X%2A> は \-4 で、<xref:System.Windows.Vector.Y%2A> も \-4 です。  これらのオフセット値が負の値である理由は、子オブジェクトを基準とした親オブジェクトのオフセットが負のオフセットであるためです。  
+  
+## 参照  
+ <xref:System.Windows.Media.Visual>   
+ <xref:System.Windows.Media.VisualTreeHelper>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md
new file mode 100644
index 00000000000..814726cce8d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ビジュアル内のジオメトリのヒット テストを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Geometry オブジェクト, ビジュアル オブジェクトを構成する"
+  - "ヒット テスト, Geometry オブジェクトで構成されるビジュアル オブジェクト"
+  - "ビジュアル オブジェクト, ヒット テスト"
+ms.assetid: 8bf2643f-d7f9-4cb4-9ea6-5b893c23200d
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ビジュアル内のジオメトリのヒット テストを実行する
+この例では、1 つ以上の <xref:System.Windows.Media.Geometry> オブジェクトで構成されるビジュアル オブジェクトに対して[ヒット テスト](GTMT)を実行する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.VisualTreeHelper.GetDrawing%2A> メソッドを使用して、ビジュアル オブジェクトから <xref:System.Windows.Media.DrawingGroup> を取得する方法を次の例に示します。  次に、<xref:System.Windows.Media.DrawingGroup> の各描画のレンダリングされたコンテンツに対してヒット テストを実行し、ヒットしたジオメトリを確認します。  
+  
+> [!NOTE]
+>  通常、ポイントがビジュアルのレンダリングされたコンテンツと交差するかどうかを判定するには、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを使用します。  
+  
+ [!code-csharp[VisualsOverview#VisualsOverviewSnippet4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml.cs#visualsoverviewsnippet4)]
+ [!code-vb[VisualsOverview#VisualsOverviewSnippet4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsOverview/visualbasic/window1.xaml.vb#visualsoverviewsnippet4)]  
+  
+ <xref:System.Windows.Media.Geometry.FillContains%2A> メソッドはオーバーロードされたメソッドであり、これを使用すると、指定した <xref:System.Windows.Point> または <xref:System.Windows.Media.Geometry> を使用してヒット テストを行うことができます。  ジオメトリに線が付いている場合は、塗りつぶしの境界の外側までストロークを延長できます。  この場合は、<xref:System.Windows.Media.Geometry.FillContains%2A> に加えて <xref:System.Windows.Media.Geometry.StrokeContains%2A> を呼び出すことができます。  
+  
+ ベジエ平坦化に使用する <xref:System.Windows.Media.ToleranceType> を提供することもできます。  
+  
+> [!NOTE]
+>  このサンプルでは、ジオメトリに適用される可能性のある変換またはクリッピングは考慮していません。  また、スタイルが設定されたコントロールには直接関連付けられた描画がないので、このサンプルはスタイルが設定されたコントロールに対しては機能しません。  
+  
+## 参照  
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)   
+ [パラメーターとしてジオメトリを使用してヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-geometry-as-a-parameter.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-hit-test-in-a-viewport3d.md b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-in-a-viewport3d.md
new file mode 100644
index 00000000000..16658ef25c2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-in-a-viewport3d.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : Viewport3D でヒット テストを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D ビジュアル, ヒット テスト"
+  - "ヒット テスト, 3-D ビジュアルの"
+  - "Viewport3D"
+ms.assetid: 42bfbd99-c7c6-43f1-940b-90448faa412e
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : Viewport3D でヒット テストを実行する
+この例では、<xref:System.Windows.Controls.Viewport3D> で 3D ビジュアルのヒット テストを行う方法を示します。  
+  
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> は 2D と 3D の情報を返すので、テスト結果を反復処理することで 3D の結果だけを読み取ることができます。  
+  
+ [!code-csharp[HitTest3D#HitTest3D3DN4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTest3D/CSharp/Window1.xaml.cs#hittest3d3dn4)]
+ [!code-vb[HitTest3D#HitTest3D3DN4](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTest3D/visualbasic/window1.xaml.vb#hittest3d3dn4)]  
+  
+ 次のコードの <xref:System.Windows.Media.HitTestResultBehavior> は、ヒット テストの結果の処理方法を決定します。  `UpdateResultInfo` と `UpdateMaterial` は、ローカルに定義されたメソッドです。  
+  
+ [!code-csharp[HitTest3D#HitTest3D3DN5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTest3D/CSharp/Window1.xaml.cs#hittest3d3dn5)]
+ [!code-vb[HitTest3D#HitTest3D3DN5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTest3D/visualbasic/window1.xaml.vb#hittest3d3dn5)]  
+  
+## 参照  
+ [3\-D ヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159959)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-a-win32-host-container.md b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-a-win32-host-container.md
new file mode 100644
index 00000000000..c96752ff016
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-a-win32-host-container.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : Win32 ホスト コンテナーを使用してヒット テストを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ヒット テスト, 使用 (Win32 ホスト コンテナーを)"
+  - "ビジュアル オブジェクト, ヒット テスト"
+  - "Win32 ホスト コンテナー, ヒット テストに使用"
+ms.assetid: 9491f7f3-d8ba-4573-a888-2f064d1349dc
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : Win32 ホスト コンテナーを使用してヒット テストを実行する
+ビジュアル オブジェクトのホスト ウィンドウ コンテナーを提供することで、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] ウィンドウにビジュアル オブジェクトを作成できます。  格納されているビジュアル オブジェクト用のイベント処理機能を提供するには、ホスト ウィンドウ コンテナーのメッセージ フィルター ループに渡されるメッセージを処理します。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウでビジュアル オブジェクトをホストする方法の詳細については、「[チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](../../../../docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md)」を参照してください。  
+  
+## 使用例  
+ 次のコードでは、ビジュアル オブジェクトのホスト コンテナーとして使用される [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウにマウス イベント ハンドラーを設定する方法を示します。  
+  
+ [!code-csharp[VisualsHitTesting#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyWindow.cs#103)]
+ [!code-vb[VisualsHitTesting#103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyWindow.vb#103)]  
+  
+ トラッピング固有のマウス イベントに対応して[ヒット テスト](GTMT)を設定する方法を次の例に示します。  
+  
+ [!code-csharp[VisualsHitTesting#104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyCircle.cs#104)]
+ [!code-vb[VisualsHitTesting#104](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyCircle.vb#104)]  
+  
+ The <xref:System.Windows.Interop.HwndSource> オブジェクトは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] ウィンドウ内の [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] コンテンツを表示します。<xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティの値は、[ビジュアル ツリー](GTMT)階層の最上位ノードを表します。  
+  
+ Win32 ホスト コンテナーを使用するオブジェクトのヒット テストのサンプル全体については、[Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndSource>   
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)   
+ [チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](../../../../docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-geometry-as-a-parameter.md b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-geometry-as-a-parameter.md
new file mode 100644
index 00000000000..af1f4d096ae
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-geometry-as-a-parameter.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : パラメーターとしてジオメトリを使用してヒット テストを実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Geometry オブジェクト, ヒット テスト (ビジュアル オブジェクトに対する)"
+  - "ヒット テスト, Geometry オブジェクトによるビジュアル オブジェクトに対するヒット テスト"
+  - "ビジュアル オブジェクト, ヒット テスト"
+ms.assetid: 6c8bdbf2-19e0-4fbb-bf89-c1252b2ebc61
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : パラメーターとしてジオメトリを使用してヒット テストを実行する
+この例では、<xref:System.Windows.Media.Geometry> をヒット テスト パラメーターとして使用して、ビジュアル オブジェクトに対して[ヒット テスト](GTMT)を実行する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドの <xref:System.Windows.Media.GeometryHitTestParameters> を使用してヒット テストを設定する方法を次の例に示します。  `OnMouseDown` メソッドに渡される <xref:System.Windows.Point> 値は、<xref:System.Windows.Media.Geometry> オブジェクトを作成してヒット テストの範囲を拡張する場合に使用されます。  
+  
+ [!code-csharp[HitTestingOverview#HitTestingOverviewSnippet10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/GeometryHitTest.cs#hittestingoverviewsnippet10)]
+ [!code-vb[HitTestingOverview#HitTestingOverviewSnippet10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/geometryhittest.vb#hittestingoverviewsnippet10)]  
+  
+ <xref:System.Windows.Media.GeometryHitTestResult> の <xref:System.Windows.Media.GeometryHitTestResult.IntersectionDetail%2A> プロパティは、<xref:System.Windows.Media.Geometry> をヒット テスト パラメーターとして使用したヒット テストの実行結果に関する情報を提供します。  ヒット テストのジオメトリ \(青い円\) と対象のビジュアル オブジェクト \(赤い正方形\) の描画されるコンテンツとの関係を次の図に示します。  
+  
+ ![ヒット テストで使用される IntersectionDetail のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/intersectiondetail01.png "IntersectionDetail01")  
+ヒット テストのジオメトリと対象のビジュアル オブジェクトの交差部分  
+  
+ <xref:System.Windows.Media.Geometry> をヒット テスト パラメーターとして使用する場合に、ヒット テストのコールバックを実装する方法を次の例に示します。  <xref:System.Windows.Media.GeometryHitTestResult.IntersectionDetail%2A> プロパティの値を取得するために、`result` パラメーターを <xref:System.Windows.Media.GeometryHitTestResult> にキャストしています。  このプロパティ値を使用して、<xref:System.Windows.Media.Geometry> ヒット テスト パラメーターの全体または一部がヒット テスト対象の描画されるコンテンツ内に含まれるかどうかを判別することができます。  ここに示すサンプル コードでは、完全に対象の境界内に含まれるビジュアルについてのみ、ヒット テストの結果をリストに追加しています。  
+  
+ [!code-csharp[HitTestingOverview#HitTestingOverviewSnippet11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/HitTestingOverview/CSharp/GeometryHitTest.cs#hittestingoverviewsnippet11)]
+ [!code-vb[HitTestingOverview#HitTestingOverviewSnippet11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/HitTestingOverview/visualbasic/geometryhittest.vb#hittestingoverviewsnippet11)]  
+  
+> [!NOTE]
+>  IntersectionDetail が <xref:System.Windows.Media.IntersectionDetail> の場合は、<xref:System.Windows.Media.HitTestResult> コールバックを呼び出さないようにしてください。  
+  
+## 参照  
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)   
+ [ビジュアル内のジオメトリのヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-improve-rendering-performance-by-caching-an-element.md b/docs/framework/wpf/graphics-multimedia/how-to-improve-rendering-performance-by-caching-an-element.md
new file mode 100644
index 00000000000..9657ab95ad0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-improve-rendering-performance-by-caching-an-element.md
@@ -0,0 +1,37 @@
+---
+title: "方法: 要素をキャッシュしてレンダリングのパフォーマンスを向上させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapCache [WPF], 向上 (レンダリングのパフォーマンスを)"
+  - "CacheMode [WPF], 向上 (レンダリングのパフォーマンスを)"
+  - "パフォーマンス [WPF], キャッシュ (要素を)"
+  - "レンダリングのパフォーマンス [WPF], キャッシュ (要素を)"
+  - "UIElement [WPF], キャッシュ"
+ms.assetid: 4739c1fc-60ba-4c46-aba6-f6c1a2688f19
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: 要素をキャッシュしてレンダリングのパフォーマンスを向上させる
+複合 <xref:System.Windows.UIElement> のレンダリングのパフォーマンスを向上させるには、<xref:System.Windows.Media.BitmapCache> クラスを使用します。  要素をキャッシュするには、<xref:System.Windows.Media.BitmapCache> クラスの新しいインスタンスを作成し、そのインスタンスを要素の <xref:System.Windows.UIElement.CacheMode%2A> プロパティに割り当てます。  <xref:System.Windows.Media.BitmapCache> は、<xref:System.Windows.Media.BitmapCacheBrush> で効率的に再利用できます。  
+  
+## 使用例  
+ 次のコード例では、複合要素を作成し、それをビットマップとしてキャッシュして、要素をアニメーションするときのパフォーマンスを向上させる方法を示します。  要素は、多くの頂点を持つ図形ジオメトリを保持するキャンバスです。  既定値を持つ <xref:System.Windows.Media.BitmapCache> がキャンバスの <xref:System.Windows.UIElement.CacheMode%2A> に割り当てられ、キャッシュされたビットマップのスムーズなスケーリングがアニメーションで表示されます。  
+  
+ [!code-xml[System.Windows.Media.BitmapCache#_BitmapCacheXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/system.windows.media.bitmapcache/cs/window1.xaml#_bitmapcachexaml)]  
+  
+## 参照  
+ <xref:System.Windows.Media.BitmapCache>   
+ <xref:System.Windows.Media.BitmapCacheBrush>   
+ <xref:System.Windows.UIElement.CacheMode%2A>   
+ [方法: キャッシュされた要素をブラシとして使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-cached-element-as-a-brush.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-interactively-control-a-clock.md b/docs/framework/wpf/graphics-multimedia/how-to-interactively-control-a-clock.md
new file mode 100644
index 00000000000..6f2e4753fc3
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-interactively-control-a-clock.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : クロックを対話的に制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クロック, 制御 (対話形式で)"
+  - "制御 (クロックを対話形式で)"
+ms.assetid: d0b520e0-2f18-4cef-977f-2909e709548a
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : クロックを対話的に制御する
+<xref:System.Windows.Media.Animation.Clock> オブジェクトの <xref:System.Windows.Media.Animation.ClockController> プロパティを使用すれば、対話形式でクロックを開始、一時停止、再開、シーク、区間の最後までの前進、停止できます。  対話形式で制御できるのは、タイミング ツリーのルートに位置するクロックのみです。  
+  
+> [!NOTE]
+>  クロックを直接操作せずにアニメーションを対話形式で制御する方法もあります。それは、ストーリーボードを使用する方法です。  ストーリーボードは、マークアップとコードの両方でサポートされています。  例については、「[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)」または「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ 次の例では、さまざまなボタンを使用して、アニメーション クロックを対話形式で制御しています。  
+  
+## 使用例  
+ [!code-csharp[timingbehaviors_procedural_snip#GraphicsMMClockControllerExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_procedural_snip/CSharp/ClockControllerExample.cs#graphicsmmclockcontrollerexample)]
+ [!code-vb[timingbehaviors_procedural_snip#GraphicsMMClockControllerExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_procedural_snip/visualbasic/clockcontrollerexample.vb#graphicsmmclockcontrollerexample)]  
+  
+## 参照  
+ [ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-load-an-image-as-a-thumbnail.md b/docs/framework/wpf/graphics-multimedia/how-to-load-an-image-as-a-thumbnail.md
new file mode 100644
index 00000000000..29c7fd10adb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-load-an-image-as-a-thumbnail.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : サムネイルとしてイメージを読み込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イメージ, 読み込み (サムネイルとして)"
+  - "読み込み (イメージをサムネイルとして)"
+  - "サムネイル, 読み込み (イメージを)"
+ms.assetid: 02e055a0-54df-499a-b8b6-ab6ff7535cff
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : サムネイルとしてイメージを読み込む
+次の例では、サムネイルとして <xref:System.Windows.Controls.Image> を読み込み、アプリケーションのメモリを節約する方法を示します。  
+  
+## 使用例  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で <xref:System.Windows.Media.Imaging.BitmapImage> の <xref:System.Windows.Media.Imaging.BitmapImage.DecodePixelWidth%2A> プロパティを設定して、イメージの読み込みに必要なメモリを節約する例を次に示します。  
+  
+ [!code-xml[ImageElementExample_snip#ImageSimpleExampleInlineMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml#imagesimpleexampleinlinemarkup)]  
+  
+## 使用例  
+ コードで <xref:System.Windows.Media.Imaging.BitmapImage> の <xref:System.Windows.Media.Imaging.BitmapImage.DecodePixelWidth%2A> プロパティを設定して、イメージの読み込みに必要なメモリを節約する例を次に示します。  
+  
+ [!code-csharp[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml.cs#imagesimpleexampleinlinecode1)]
+ [!code-vb[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/ImageSimpleExample.xaml.vb#imagesimpleexampleinlinecode1)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-make-an-element-spin-in-place.md b/docs/framework/wpf/graphics-multimedia/how-to-make-an-element-spin-in-place.md
new file mode 100644
index 00000000000..ead74c75192
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-make-an-element-spin-in-place.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 要素のスピンを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, DoubleAnimation"
+  - "クラス, RotateTransform"
+  - "DoubleAnimation クラス"
+  - "グラフィックス, 回転 (要素を)"
+  - "RotateTransform クラス"
+  - "回転 (要素を)"
+ms.assetid: 1f011976-8b07-4c31-9faf-019e0ddaa24c
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 要素のスピンを設定する
+この例では、<xref:System.Windows.Media.RotateTransform> と <xref:System.Windows.Media.Animation.DoubleAnimation> を使用して要素を回転させる方法を示します。  
+  
+ 次の例では、要素の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.RotateTransform> を適用しています。  この例は、<xref:System.Windows.Media.Animation.DoubleAnimation> を使用して <xref:System.Windows.Media.RotateTransform> の <xref:System.Windows.Media.RotateTransform.Angle%2A> をアニメーション化します。  要素をその場で回転させるために、要素の <xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティを点 \(0.5, 0.5\) に設定しています。  
+  
+## 使用例  
+ [!code-xml[transformanimations_snip#11](../../../../samples/snippets/xaml/VS_Snippets_Wpf/transformanimations_snip/XAML/RotateAboutCenterExample.xaml#11)]  
+  
+ さらに多くの変換の例が含まれるサンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-modify-the-cap-at-the-end-of-a-line-or-segment.md b/docs/framework/wpf/graphics-multimedia/how-to-modify-the-cap-at-the-end-of-a-line-or-segment.md
new file mode 100644
index 00000000000..816f81291c8
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-modify-the-cap-at-the-end-of-a-line-or-segment.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 直線または線分の終点のキャップを変更する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 形状キャップ"
+  - "Shape 要素, キャップ"
+  - "Shape 要素, 終点"
+ms.assetid: f4bf3416-b3d8-4568-b98e-3eda8f6dbf7a
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 直線または線分の終点のキャップを変更する
+この例では、開いた <xref:System.Windows.Shapes.Shape> 要素の始点または終点の形状を変更する方法を示します。  開いた <xref:System.Windows.Shapes.Shape> の始点のキャップを変更するには、<xref:System.Windows.Shapes.Shape.StrokeStartLineCap%2A> プロパティを使用します。  開いた <xref:System.Windows.Shapes.Shape> の終点のキャップを変更するには、<xref:System.Windows.Shapes.Shape.StrokeEndLineCap%2A> プロパティを使用します。  使用できる線キャップを確認するには、<xref:System.Windows.Media.PenLineCap> 列挙体を参照してください。  
+  
+> [!NOTE]
+>  このプロパティは、<xref:System.Windows.Shapes.Line>、<xref:System.Windows.Shapes.Polyline>、または開いた <xref:System.Windows.Shapes.Path> 要素などの開いた図形に対してのみ適用されます。  
+  
+ 次の例では、4 つの <xref:System.Windows.Shapes.Polyline> 要素を描画し、それぞれの端に異なる形状のセットを使用します。  
+  
+## 使用例  
+ [!code-xml[drawingwithshapeelements#ShapeLineCaps1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/linecapsandjoinsexample.xaml#shapelinecaps1)]  
+  
+ この例は、より大きなサンプルの一部です。サンプル全体については、[図形要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Polyline>   
+ <xref:System.Windows.Media.PenLineCap>
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-drawing.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-drawing.md
new file mode 100644
index 00000000000..50228f597f5
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-drawing.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : 描画を使用して領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 描画による塗りつぶし"
+  - "描画, 塗りつぶし"
+  - "描画, 描画を使用"
+ms.assetid: c10dc4b1-09b1-41e8-ad14-456b5fb377df
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 描画を使用して領域を塗りつぶす
+この例では、描画を使用して領域を塗りつぶす方法を示します。  描画を使用して領域を塗りつぶすには、<xref:System.Windows.Media.DrawingBrush> オブジェクトと 1 つ以上の <xref:System.Windows.Media.Drawing> オブジェクトを使用します。  <xref:System.Windows.Media.DrawingBrush> を使用して、オブジェクトを 2 つの楕円の描画で塗りつぶす例を次に示します。  
+  
+## 使用例  
+ [!code-xml[drawingbrush_snip#DrawingBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/drawingbrush_snip/CS/DrawingBrushExample.xaml#drawingbrushexamplewholepage)]  
+  
+ [!code-csharp[drawingbrush_procedural_snip#DrawingBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/drawingbrush_procedural_snip/CSharp/DrawingBrushExample.cs#drawingbrushexamplewholepage)]
+ [!code-vb[drawingbrush_procedural_snip#DrawingBrushExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/drawingbrush_procedural_snip/VisualBasic/DrawingBrushExample.vb#drawingbrushexamplewholepage)]  
+  
+ この例の出力を次の図に示します。  
+  
+ ![DrawingBrush からの出力](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawingbrush-simple.png "graphicsmm\_drawingbrush\_simple")  
+  
+ 図形の中央が白である理由については、「[複合図形の塗りつぶしを制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-the-fill-of-a-composite-shape.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.DrawingBrush> オブジェクトの <xref:System.Windows.Media.TileBrush.Viewport%2A> と <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティを設定することにより、繰り返しのパターンを作成できます。  2 つの楕円の描画から作成されるパターンで、オブジェクトを塗りつぶす例を次に示します。  
+  
+ [!code-xml[drawingbrush_snip#TiledDrawingBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/drawingbrush_snip/CS/TiledDrawingBrushExample.xaml#tileddrawingbrushexamplewholepage)]  
+  
+ [!code-csharp[drawingbrush_procedural_snip#TiledDrawingBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/drawingbrush_procedural_snip/CSharp/TiledDrawingBrushExample.cs#tileddrawingbrushexamplewholepage)]
+ [!code-vb[drawingbrush_procedural_snip#TiledDrawingBrushExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/drawingbrush_procedural_snip/VisualBasic/TiledDrawingBrushExample.vb#tileddrawingbrushexamplewholepage)]  
+  
+ 並べて表示された <xref:System.Windows.Media.DrawingBrush> の出力を次の図に示します。  
+  
+ ![DrawingBrush からの並べて表示される出力](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawingbrush-tiled.png "graphicsmm\_drawingbrush\_tiled")  
+  
+ 描画ブラシの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  <xref:System.Windows.Media.Drawing> オブジェクトの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-linear-gradient.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-linear-gradient.md
new file mode 100644
index 00000000000..f8f1e824371
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-linear-gradient.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : 線形グラデーションを使用して領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (線形グラデーションによる)"
+  - "線形グラデーション, 塗りつぶし"
+  - "描画, 線形グラデーションでの"
+ms.assetid: 00e0cd04-48c0-4ec5-850e-d321beb37a34
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 線形グラデーションを使用して領域を塗りつぶす
+この例では、<xref:System.Windows.Media.LinearGradientBrush> クラスを使用して、線形グラデーションで領域を塗りつぶす方法を示します。  次の例では、黄色から赤、青、淡い緑と変化する斜めの線形グラデーションを使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶします。  
+  
+## 使用例  
+ [!code-xml[GradientBrushExamples_snip#DiagonalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#diagonalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#DiagonalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#diagonalgradient1csharp)]  
+  
+ 前の例で作成したグラデーションを次の図に示します。  
+  
+ ![対角線方向の線形グラデーション](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-diagonallgb.png "graphicsmm\_DiagonalLGB")  
+  
+ 水平方向の線形グラデーションを作成するには、<xref:System.Windows.Media.LinearGradientBrush> の <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> と <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を \(0,0.5\) と \(1,0.5\) に変更します。  次の例では、水平方向の線形グラデーションを使用して、<xref:System.Windows.Shapes.Rectangle> を塗りつぶします。  
+  
+ [!code-xml[GradientBrushExamples_snip#HorizontalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#horizontalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#HorizontalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#horizontalgradient1csharp)]  
+  
+ 前の例で作成したグラデーションを次の図に示します。  
+  
+ ![水平方向の線形グラデーション](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-horizontallgb.png "graphicsmm\_HorizontalLGB")  
+  
+ 垂直方向の線形グラデーションを作成するには、<xref:System.Windows.Media.LinearGradientBrush> の <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> と <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を \(0.5,0\) と \(0.5,1\) に変更します。  次の例では、垂直方向の線形グラデーションを使用して、<xref:System.Windows.Shapes.Rectangle> を塗りつぶします。  
+  
+ [!code-xml[GradientBrushExamples_snip#VerticalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#verticalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#VerticalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#verticalgradient1csharp)]  
+  
+ 前の例で作成したグラデーションを次の図に示します。  
+  
+ ![垂直方向の線形グラデーション](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-verticallgb.png "graphicsmm\_VerticalLGB")  
+  
+> [!NOTE]
+>  このトピックのグラデーションの例では、開始点と終了点の設定に既定の座標系を使用しています。  既定の座標系は境界ボックスに対して相対的です。0 は境界ボックスの 0% を示し、1 は境界ボックスの 100% を示します。  この座標系を変更するには、<xref:System.Windows.Media.GradientBrush.MappingMode%2A> プロパティを <xref:System.Windows.Media.BrushMappingMode?displayProperty=fullName> という値に設定します。  絶対座標系は、境界ボックスに対して相対的ではありません。  値は、ローカル空間で直接解釈されます。  
+  
+ その他の例については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  グラデーションとその他の種類のブラシの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-radial-gradient.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-radial-gradient.md
new file mode 100644
index 00000000000..fd32fd4bcf0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-radial-gradient.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 放射状グラデーションを使用して領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 放射状グラデーションによる塗りつぶし"
+  - "描画, 放射状グラデーションを使用"
+  - "放射状グラデーション, 塗りつぶし"
+ms.assetid: b5d0fc8a-8986-4796-b003-a75b41a48928
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 放射状グラデーションを使用して領域を塗りつぶす
+この例では、<xref:System.Windows.Media.RadialGradientBrush> クラスを使用して、放射状グラデーションで領域を塗りつぶす方法を示します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.RadialGradientBrush> を使用して、黄色から赤、青、淡い緑と変化する放射状グラデーションで、四角形を塗りつぶします。  
+  
+ [!code-csharp[BrushesIntroduction_snip#SimpleRadialGradientExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/RadialGradientBrushSnippet.cs#simpleradialgradientexamplewholepage)]
+ [!code-vb[BrushesIntroduction_snip#SimpleRadialGradientExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/radialgradientbrushsnippet.vb#simpleradialgradientexamplewholepage)]
+ [!code-xml[BrushesIntroduction_snip#SimpleRadialGradientExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/RadialGradientBrushSnippet.xaml#simpleradialgradientexamplewholepage)]  
+  
+ 前の例のグラデーションを次の図に示します。  グラデーションの終了位置が強調表示されています。  
+  
+ ![放射状グラデーションのグラデーション ストップ](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops-rg.png "wcpsdk\_graphicsmm\_4gradientstops\_rg")  
+  
+> [!NOTE]
+>  このトピックの例では、制御点の設定に既定の座標系を使用しています。  既定の座標系は境界ボックスに対して相対的です。0 は境界ボックスの 0% を示し、1 は境界ボックスの 100% を示します。  この座標系を変更するには、<xref:System.Windows.Media.GradientBrush.MappingMode%2A> プロパティを <xref:System.Windows.Media.BrushMappingMode> という値に設定します。  絶対座標系は、境界ボックスに対して相対的ではありません。  値は、ローカル空間で直接解釈されます。  
+  
+ その他の <xref:System.Windows.Media.RadialGradientBrush> の例については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  グラデーションとその他の種類のブラシの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-solid-color.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-solid-color.md
new file mode 100644
index 00000000000..3acedad9b78
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-solid-color.md
@@ -0,0 +1,60 @@
+---
+title: "方法 : 純色で領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (純色による)"
+  - "描画, 純色を使用"
+  - "純色, 塗りつぶし"
+ms.assetid: 5d27d8a7-4bd7-4063-bdf3-2c5c0f19f9d3
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 純色で領域を塗りつぶす
+純色で領域を塗りつぶすには、<xref:System.Windows.Media.Brushes.Red%2A> や <xref:System.Windows.Media.Brushes.Blue%2A> などの定義済みのシステム ブラシを使用します。または、新しい <xref:System.Windows.Media.SolidColorBrush> を作成し、アルファ、赤、緑、および青の値を使用して <xref:System.Windows.Media.SolidColorBrush.Color%2A> を記述することもできます。  XAML では、16 進数表記を使用して純色で領域を塗りつぶすこともできます。  
+  
+ これらの各手法を使用して <xref:System.Windows.Shapes.Rectangle> を青で塗りつぶす例を次に示します。  
+  
+## 使用例  
+ **定義済みブラシの使用**  
+  
+ 次の例では、定義済みブラシ <xref:System.Windows.Media.Brushes.Blue%2A> を使用して、四角形を青で塗りつぶします。  
+  
+ [!code-xml[brushsamples_snip#_graphicsmm_PredefinedBrush1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/SolidColorBrushExample.xaml#_graphicsmm_predefinedbrush1)]  
+  
+ [!code-csharp[brushsamples_procedural_snip#_graphicsmm_PredefinedBrush1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_procedural_snip/CSharp/SolidColorBrushExample.cs#_graphicsmm_predefinedbrush1)]  
+  
+ **16 進数表記の使用**  
+  
+ 次の例では、8 桁の 16 進数表記を使用して、四角形を青で塗りつぶします。  
+  
+ [!code-xml[brushsamples_snip#_graphicsmm_HexNotation8Digit1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/SolidColorBrushExample.xaml#_graphicsmm_hexnotation8digit1)]  
+  
+ **ARGB 値の使用**  
+  
+ 次の例では <xref:System.Windows.Media.SolidColorBrush> を作成し、その <xref:System.Windows.Media.SolidColorBrush.Color%2A> を青い色に対応する ARGB 値を使用して記述します。  
+  
+ [!code-xml[brushsamples_snip#_graphicsmm_RgbNotation1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/SolidColorBrushExample.xaml#_graphicsmm_rgbnotation1)]  
+  
+ [!code-csharp[brushsamples_procedural_snip#_graphicsmm_RgbNotation1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_procedural_snip/CSharp/SolidColorBrushExample.cs#_graphicsmm_rgbnotation1)]  
+  
+ 色を記述するその他の方法については、<xref:System.Windows.Media.Color> 構造体を参照してください。  
+  
+ **関連トピック**  
+  
+ <xref:System.Windows.Media.SolidColorBrush> およびその他の例の詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」の概要を参照してください。  
+  
+ このコード例は、<xref:System.Windows.Media.SolidColorBrush> クラスのトピックで取り上げているコード例の一部分です。  サンプル全体については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Brushes>
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md
new file mode 100644
index 00000000000..b0114c6612f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md
@@ -0,0 +1,59 @@
+---
+title: "方法 : システム ブラシで領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (システム ブラシによる)"
+  - "描画, システム ブラシで"
+  - "システム ブラシ, 塗りつぶし"
+ms.assetid: 5141a763-9235-42cb-a6bb-afc75513eac7
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : システム ブラシで領域を塗りつぶす
+<xref:System.Windows.SystemColors> クラスを使用すると、<xref:System.Windows.SystemColors.ControlBrush%2A>、<xref:System.Windows.SystemColors.ControlBrushKey%2A>、<xref:System.Windows.SystemColors.DesktopBrush%2A> などのシステム ブラシやシステム カラーにアクセスできます。  システム ブラシは、指定したシステム カラーで領域を塗りつぶす <xref:System.Windows.Media.SolidColorBrush> オブジェクトです。  システム ブラシは、常に純色の塗りつぶしを生成します。グラデーションを作成するためには使用できません。  
+  
+ システム ブラシは、静的なリソースとしても、動的なリソースとしても使用できます。  アプリケーションの実行中にユーザーがシステム ブラシを変更したときにブラシを自動的に更新する場合は、動的リソースを使用します。それ以外の場合は、静的リソースを使用します。  SystemColors クラスには、厳密な名前付け規則に従うさまざまな静的プロパティが含まれます。  
+  
+-   *\<SystemColor\>*Brush  
+  
+     指定したシステム カラーの <xref:System.Windows.Media.SolidColorBrush> に対する静的参照を取得します。  
+  
+-   *\<SystemColor\>*BrushKey  
+  
+     指定したシステム カラーの <xref:System.Windows.Media.SolidColorBrush> に対する動的参照を取得します。  
+  
+-   *\<SystemColor\>*Color  
+  
+     指定したシステム カラーの <xref:System.Windows.Media.Color> 構造体に対する静的参照を取得します。  
+  
+-   *\<SystemColor\>*ColorKey  
+  
+     指定したシステム カラーの <xref:System.Windows.Media.Color> 構造体に対する動的参照を取得します。  
+  
+ システム カラーは <xref:System.Windows.Media.Color> 構造体であり、ブラシの構成に使用できます。  たとえば、<xref:System.Windows.Media.LinearGradientBrush> オブジェクトのグラデーション終了位置の <xref:System.Windows.Media.GradientStop.Color%2A> プロパティにシステム カラーを設定することで、システム カラーを使用してグラデーションを作成できます。  例については、「[グラデーションでシステム カラーを使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、動的システム ブラシ参照を使用して、ボタンの背景を設定しています。  
+  
+ [!code-xml[brushsamples_snip#GraphicsMMDynamicSystemColorDesktopBrushKeyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/DynamicSystemBrushExample.xaml#graphicsmmdynamicsystemcolordesktopbrushkeyexamplewholepage)]  
+  
+ 次の例では、静的システム ブラシ参照を使用して、ボタンの背景を設定しています。  
+  
+ [!code-xml[brushsamples_snip#GraphicsMMStaticSystemColorDesktopBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/StaticSystemBrushExample.xaml#graphicsmmstaticsystemcolordesktopbrushexamplewholepage)]  
+  
+ グラデーションでのシステム カラーの使用方法を示す例については、「[グラデーションでシステム カラーを使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md)」を参照してください。  
+  
+## 参照  
+ [グラデーションでシステム カラーを使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-video.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-video.md
new file mode 100644
index 00000000000..b1579f7d85f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-video.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : ビデオを使用して領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (ビデオによる)"
+  - "塗りつぶし (ビデオによる)"
+  - "ビデオ, 塗りつぶし"
+ms.assetid: 04dd6600-4a6e-4b43-a93e-21cce7dfbcb8
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ビデオを使用して領域を塗りつぶす
+この例では、メディアを使用して領域を塗りつぶす方法を示します。  メディアを使用して領域を塗りつぶす 1 つの方法は、<xref:System.Windows.Controls.MediaElement> と共に <xref:System.Windows.Media.VisualBrush> を使用することです。  <xref:System.Windows.Controls.MediaElement> を使用してメディアを読み込んで再生した後、そのメディアを使用して <xref:System.Windows.Media.VisualBrush> の <xref:System.Windows.Media.VisualBrush.Visual%2A> プロパティを設定します。  その後は、<xref:System.Windows.Media.VisualBrush> を使用して、読み込んだメディアを使用して領域を塗りつぶすことができます。  
+  
+## 使用例  
+ <xref:System.Windows.Controls.MediaElement> と <xref:System.Windows.Media.VisualBrush> を使用して、<xref:System.Windows.Controls.TextBlock> コントロールの <xref:System.Windows.Controls.TextBlock.Foreground%2A> をビデオで塗りつぶす例を次に示します。  この例では、音が出ないように、<xref:System.Windows.Controls.MediaElement> の <xref:System.Windows.Controls.MediaElement.IsMuted%2A> プロパティを `true` に設定しています。  
+  
+ [!code-csharp[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/visualbrush_markup_snip/CSharp/PaintWithVideoExample.cs#graphicsmmvideoastextbackgroundinline)]
+ [!code-vb[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/visualbrush_markup_snip/visualbasic/paintwithvideoexample.vb#graphicsmmvideoastextbackgroundinline)]
+ [!code-xml[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/visualbrush_markup_snip/XAML/PaintWithVideoExample.xaml#graphicsmmvideoastextbackgroundinline)]  
+  
+## 使用例  
+ <xref:System.Windows.Media.VisualBrush> は <xref:System.Windows.Media.TileBrush> クラスを継承するため、並べて表示するモードをいくつか備えています。  <xref:System.Windows.Media.VisualBrush> の <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティを <xref:System.Windows.Media.TileMode> に設定し、その <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティを塗りつぶす領域より小さい値に設定することで、並べて表示するパターンを作成できます。  
+  
+ 次の例は前の例と同じものですが、<xref:System.Windows.Media.VisualBrush> がビデオからパターンを生成するところが異なっています。  
+  
+ [!code-csharp[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundTiledInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/visualbrush_markup_snip/CSharp/PaintWithVideoExample.cs#graphicsmmvideoastextbackgroundtiledinline)]
+ [!code-vb[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundTiledInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/visualbrush_markup_snip/visualbasic/paintwithvideoexample.vb#graphicsmmvideoastextbackgroundtiledinline)]
+ [!code-xml[Visualbrush_markup_snip#GraphicsMMVideoAsTextBackgroundTiledInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/visualbrush_markup_snip/XAML/PaintWithVideoExample.xaml#graphicsmmvideoastextbackgroundtiledinline)]  
+  
+ メディア ファイルなどのコンテンツ ファイルをアプリケーションに追加する方法については、「[WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)」を参照してください。  メディア ファイルを追加するときは、リソース ファイルとしてではなく、コンテンツ ファイルとして追加する必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Media.VisualBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [TileBrush の概要](../../../../docs/framework/wpf/graphics-multimedia/tilebrush-overview.md)   
+ [マルチメディアの概要](../../../../docs/framework/wpf/graphics-multimedia/multimedia-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-visual.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-visual.md
new file mode 100644
index 00000000000..b106754f2f2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-visual.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : ビジュアルで領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (ビジュアルによる)"
+  - "描画"
+  - "ビジュアル, 塗りつぶし"
+ms.assetid: 35f92996-1d03-4542-acc4-3469dcf09492
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ビジュアルで領域を塗りつぶす
+この例では、<xref:System.Windows.Media.VisualBrush> クラスを使用して <xref:System.Windows.Media.Visual> で領域を塗りつぶす方法を示します。  
+  
+ 次の例では、いくつかのコントロールと 1 つのパネルが四角形の背景として使用されています。  
+  
+## 使用例  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/VisualBrushExample.xaml#graphicsmmvisualbrushasrectanglebackgroundexample)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/VisualBrushExample.cs#graphicsmmvisualbrushasrectanglebackgroundexample1)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/visualbrushexample.vb#graphicsmmvisualbrushasrectanglebackgroundexample1)]  
+  
+ <xref:System.Windows.Media.VisualBrush> およびその他の例の詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」の概要を参照してください。  
+  
+ このコード例は、<xref:System.Windows.Media.VisualBrush> クラスのトピックで取り上げているコード例の一部分です。  サンプル全体については、[VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)を参照してください。  
+  
+## 参照  
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-an-image.md b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-an-image.md
new file mode 100644
index 00000000000..b84f0a79232
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-an-image.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : イメージで領域を塗りつぶす | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, イメージによる塗りつぶし"
+  - "イメージ, 塗りつぶし"
+  - "描画, イメージを使用"
+ms.assetid: 3432c533-1fc7-492d-94ee-0b13d60125ae
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : イメージで領域を塗りつぶす
+この例では、<xref:System.Windows.Media.ImageBrush> クラスを使用してイメージで領域を塗りつぶす方法を示します。  <xref:System.Windows.Media.ImageBrush> を使用した場合、その <xref:System.Windows.Media.ImageBrush.ImageSource%2A> プロパティで指定した単一のイメージが表示されます。  
+  
+## 使用例  
+ <xref:System.Windows.Media.ImageBrush> を使用して、ボタンの <xref:System.Windows.Controls.Control.Background%2A> を塗りつぶす例を次に示します。  
+  
+ [!code-csharp[UsingImageBrush_snip#ImageBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush_snip/CSharp/PaintingWithImagesExample.cs#imagebrushexamplewholepage)]  
+  
+ 既定では、<xref:System.Windows.Media.ImageBrush> はイメージを引き伸ばして、描画する領域を完全に塗りつぶします。  前の例のようにイメージを引き伸ばしてボタンを塗りつぶすと、イメージにゆがみが生じることがあります。  この動作を制御するには、<xref:System.Windows.Media.TileBrush> の <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを <xref:System.Windows.Media.Stretch> または <xref:System.Windows.Media.Stretch> に設定します。これにより、ブラシはイメージの[縦横比](GTMT)を維持します。  
+  
+ <xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.TileBrush.Viewport%2A> および <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティを設定すると、繰り返しのパターンを作成できます。  イメージから作成したパターンを使用して、ボタンを塗りつぶす方法を次の例に示します。  
+  
+ [!code-csharp[UsingImageBrush_snip#TiledImageBrushExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush_snip/CSharp/TiledImageBrushExample.cs#tiledimagebrushexamplewholepage)]
+ [!code-vb[UsingImageBrush_snip#TiledImageBrushExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/UsingImageBrush_snip/VisualBasic/TiledImageBrushExample.vb#tiledimagebrushexamplewholepage)]  
+  
+ <xref:System.Windows.Media.ImageBrush> クラスの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+ このコード例は、<xref:System.Windows.Media.ImageBrush> クラスのトピックで示されているコード例の一部分です。  サンプル全体については、[ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)を参照してください。  
+  
+## 参照  
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-play-media-using-a-videodrawing.md b/docs/framework/wpf/graphics-multimedia/how-to-play-media-using-a-videodrawing.md
new file mode 100644
index 00000000000..360ea2bfdb0
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-play-media-using-a-videodrawing.md
@@ -0,0 +1,47 @@
+---
+title: "方法 : VideoDrawing を使用してメディアを再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, MediaPlayer"
+  - "クラス, VideoDrawing"
+  - "MediaPlayer クラス"
+  - "再生 (メディアの)"
+  - "VideoDrawing クラス"
+ms.assetid: 165d47ed-22ce-4ded-aa6a-aa9b7467de87
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : VideoDrawing を使用してメディアを再生する
+オーディオ ファイルまたはビデオ ファイルを再生するには、<xref:System.Windows.Media.VideoDrawing> と <xref:System.Windows.Media.MediaPlayer> を使用します。  メディアを読み込んで再生するには、2 つの方法があります。  1 つ目の方法は、<xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> を単独で使用するもので、2 つ目の方法は、独自の <xref:System.Windows.Media.MediaTimeline> を作成して <xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> と共に使用するものです。  
+  
+> [!NOTE]
+>  アプリケーションでメディアを配布する場合は、メディア ファイルをイメージと同じようにプロジェクト リソースとして使用することはできません。  代わりにプロジェクト ファイルでメディアの種類を `Content` に設定し、`CopyToOutputDirectory` を `PreserveNewest` または `Always` に設定する必要があります。  
+  
+## 使用例  
+ <xref:System.Windows.Media.VideoDrawing> および <xref:System.Windows.Media.MediaPlayer> を使用してビデオ ファイルを 1 回再生する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline)]  
+  
+ メディアのタイミングをさらに細かく制御するには、<xref:System.Windows.Media.MediaPlayer> オブジェクトおよび <xref:System.Windows.Media.VideoDrawing> オブジェクトと共に <xref:System.Windows.Media.MediaTimeline> を使用します。  <xref:System.Windows.Media.MediaTimeline> を使用すると、ビデオを繰り返すかどうかを指定できます。  
+  
+## 使用例  
+ <xref:System.Windows.Media.MediaTimeline> を <xref:System.Windows.Media.MediaPlayer> および <xref:System.Windows.Media.VideoDrawing> オブジェクトと共に使用してビデオを繰り返し再生する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#RepeatingVideoDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#repeatingvideodrawingexampleinline)]  
+  
+ <xref:System.Windows.Media.MediaTimeline> を使用するときは、<xref:System.Windows.Media.MediaPlayer> の対話型メソッドを使用するのではなく、<xref:System.Windows.Media.MediaClock> の <xref:System.Windows.Media.Animation.Clock.Controller%2A> プロパティから返される対話型の <xref:System.Windows.Media.Animation.ClockController> を使用してメディアの再生を制御することに注意してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.VideoDrawing>   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-play-media-with-animations.md b/docs/framework/wpf/graphics-multimedia/how-to-play-media-with-animations.md
new file mode 100644
index 00000000000..28d4b6c5187
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-play-media-with-animations.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : アニメーションを使用してメディアを再生する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーションを含む、マルチ メディアの再生"
+  - "メディア、アニメーションの再生"
+  - "アニメーションとメディアの再生"
+  - "メディア、アニメーションを再生"
+ms.assetid: 8982b7b7-1c6c-4b24-8801-b328862975f5
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : アニメーションを使用してメディアを再生する
+この例を使用して、同時にメディアおよびアニメーションを再生する方法を示しています、 <xref:System.Windows.Media.MediaTimeline>と<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> 、同じクラス<xref:System.Windows.Media.Animation.Storyboard>します。  
+  
+## <a name="example"></a>例  
+ 1 つまたは複数を使用する<xref:System.Windows.Media.MediaTimeline>内のオブジェクト、<xref:System.Windows.Media.Animation.Storyboard>他の<xref:System.Windows.Media.Animation.Timeline>アニメーションなどのオブジェクト。  
+  
+ 設定を次に例を<xref:System.Windows.Media.Animation.ParallelTimeline.SlipBehavior%2A>のプロパティ、<xref:System.Windows.Media.Animation.Storyboard>の値に`Slip`アニメーションが、メディア (この例ではビデオ) が進行するまでに進まないを指定します。 読み込み時間の原因でメディアの再生が遅延される場合、この機能を必要があります。  
+  
+ [!code-xml[MediaGallery_snippet#MediaTimelinePlusAnimationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaGallery_snippet/CSharp/MediaTimelinePlusAnimationExample.xaml#mediatimelineplusanimationexamplewholepage)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Media.MediaTimeline>   
+ <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ <xref:System.Windows.Media.Animation.ParallelTimeline.SlipBehavior%2A>   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md)   
+ [ストーリー ボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [グラフィックスとマルチ メディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-preserve-the-aspect-ratio-of-an-image-used-as-a-background.md b/docs/framework/wpf/graphics-multimedia/how-to-preserve-the-aspect-ratio-of-an-image-used-as-a-background.md
new file mode 100644
index 00000000000..089278ce59a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-preserve-the-aspect-ratio-of-an-image-used-as-a-background.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : 背景として使用するイメージの縦横比を保持する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "縦横比 (背景イメージの), 保持"
+  - "背景イメージ, 保持 (縦横比を)"
+  - "ブラシ, 保持 (背景イメージの縦横比を)"
+ms.assetid: 28c39478-13d7-4011-80a3-8b9cc3e54478
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 背景として使用するイメージの縦横比を保持する
+この例では、イメージの[縦横比](GTMT)を保持するために <xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを使用する方法について説明します。  
+  
+ 既定では、<xref:System.Windows.Media.ImageBrush> を使用して領域を塗りつぶすと、出力領域が完全に塗りつぶされるようにコンテンツが引き伸ばされます。  出力領域とイメージの[縦横比](GTMT)が異なる場合は、この引き伸ばしによってイメージがゆがめられます。  
+  
+ <xref:System.Windows.Media.ImageBrush> がそのイメージの縦横比を保持するようにするには、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを <xref:System.Windows.Media.Stretch> または <xref:System.Windows.Media.Stretch> に設定します。  
+  
+## 使用例  
+ 次の例では、2 つの <xref:System.Windows.Media.ImageBrush> オブジェクトを使用して、2 つの四角形を塗りつぶしています。  これらの四角形は 300 × 150 [ピクセル](GTMT)で、どちらも 300 × 300 ピクセルのイメージを保持しています。  最初のブラシの <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは <xref:System.Windows.Media.Stretch> に設定され、2 番目のブラシの <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは <xref:System.Windows.Media.Stretch> に設定されています。  
+  
+ [!code-csharp[UsingImageBrush_snip#ImageBrushStretchModesExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush_snip/CSharp/StretchModes.cs#imagebrushstretchmodesexamplewholepage)]  
+  
+ <xref:System.Windows.Media.TileBrush.Stretch%2A> を <xref:System.Windows.Media.Stretch> に設定した最初のブラシの出力を次の図に示します。  
+  
+ ![Uniform 拡大を使用した ImageBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-imagebrushuniformstretch.png "graphicsmm\_ImageBrushUniformStretch")  
+  
+ <xref:System.Windows.Media.TileBrush.Stretch%2A> を <xref:System.Windows.Media.Stretch> に設定した 2 番目のブラシの出力を次の図に示します。  
+  
+ ![UniformToFill 拡大を使用した ImageBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-imagebrushuniformtofillstretch.png "graphicsmm\_ImageBrushUniformToFillStretch")  
+  
+ <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは、他の <xref:System.Windows.Media.TileBrush> オブジェクト、つまり <xref:System.Windows.Media.DrawingBrush> と <xref:System.Windows.Media.VisualBrush> に対してもまったく同じように動作することに注意してください。  <xref:System.Windows.Media.ImageBrush> およびその他の <xref:System.Windows.Media.TileBrush> オブジェクトの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+ また、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは、<xref:System.Windows.Media.TileBrush> コンテンツを出力領域に合わせて引き伸ばす方法を指定するように見えますが、実際には基本タイルを塗りつぶすように <xref:System.Windows.Media.TileBrush> コンテンツを引き伸ばす方法を指定することにも注意してください。  詳細については、<xref:System.Windows.Media.TileBrush> を参照してください。  
+  
+ このコード例は、<xref:System.Windows.Media.ImageBrush> クラスのトピックで示されているコード例の一部分です。  サンプル全体については、[ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.TileBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-read-metadata-from-a-bitmap.md b/docs/framework/wpf/graphics-multimedia/how-to-read-metadata-from-a-bitmap.md
new file mode 100644
index 00000000000..c9d0ee8d1a9
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-read-metadata-from-a-bitmap.md
@@ -0,0 +1,30 @@
+---
+title: "方法 : ビットマップからメタデータを読み取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ, 読み取り (メタデータを)"
+  - "イメージ メタデータ"
+  - "メタデータ, イメージ"
+  - "メタデータ, 読み取り (ビットマップから)"
+ms.assetid: 920784ed-d96b-43e6-92d4-5dea5228f628
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ビットマップからメタデータを読み取る
+メタデータ照会言語を使用してビットマップのメタデータを読み取る方法を次の例に示します。  
+  
+## 使用例  
+ [!code-cpp[BitmapMetadata#GetQuery](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BitMapMetadata/CPP/BitmapMetadata.cpp#getquery)]
+ [!code-csharp[BitmapMetadata#GetQuery](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BitMapMetadata/CSharp/BitmapMetadata.cs#getquery)]
+ [!code-vb[BitmapMetadata#GetQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BitMapMetadata/VB/BitmapMetadata.vb#getquery)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-receive-notification-when-clock-state-changes.md b/docs/framework/wpf/graphics-multimedia/how-to-receive-notification-when-clock-state-changes.md
new file mode 100644
index 00000000000..f69b303fc85
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-receive-notification-when-clock-state-changes.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : クロックの状態が変化したときに通知を受け取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クロック, 状態の変更の通知"
+  - "通知, クロックの状態の変更"
+ms.assetid: ecb10fc9-d0c2-45c3-b0a1-7b11baa733da
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : クロックの状態が変化したときに通知を受け取る
+クロックの <xref:System.Windows.Media.Animation.Clock.CurrentStateInvalidated> イベントは、クロックの <xref:System.Windows.Media.Animation.Clock.CurrentState%2A> が無効化されたとき \(クロックが開始または停止されたときなど\) に発生します。  このイベントは、<xref:System.Windows.Media.Animation.Clock> を直接使用するか、または <xref:System.Windows.Media.Animation.Timeline> を使用して登録できます。  
+  
+ 次の例では、 2 つの四角形の幅をアニメーション化するために、<xref:System.Windows.Media.Animation.Storyboard> と 2 つの <xref:System.Windows.Media.Animation.DoubleAnimation> オブジェクトを使用しています。  <xref:System.Windows.Media.Animation.Timeline.CurrentStateInvalidated> イベントは、クロック状態の変化を待機するために使われています。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#_graphicsmm_StateExampleMarkupWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/StateExample.xaml#_graphicsmm_stateexamplemarkupwholepage)]  
+  
+ [!code-csharp[timingbehaviors_snip#_graphicsmm_StateEventHandlers](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/StateExample.xaml.cs#_graphicsmm_stateeventhandlers)]
+ [!code-vb[timingbehaviors_snip#_graphicsmm_StateEventHandlers](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_snip/visualbasic/stateexample.xaml.vb#_graphicsmm_stateeventhandlers)]  
+  
+ 次の図は、親タイムライン \(*Storyboard*\) の進行に応じて、アニメーションがさまざまな状態に変化することを示したものです。  
+  
+ ![クロックは 2 つのアニメーションを含むストーリーボードを示します](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-3timelines.png "graphicsmm\_3timelines")  
+  
+ 次の表は、*Animation1* の <xref:System.Windows.Media.Animation.Timeline.CurrentStateInvalidated> イベントが発生する時間を示したものです。  
+  
+||||||||  
+|-|-|-|-|-|-|-|  
+|時間 \(秒\)|1|10|19|21|30|39|  
+|状態|Active|Active|Stopped|Active|Active|Stopped|  
+  
+ 次の表は、*Animation2* の <xref:System.Windows.Media.Animation.Timeline.CurrentStateInvalidated> イベントが発生する時間を示したものです。  
+  
+||||||||||  
+|-|-|-|-|-|-|-|-|-|  
+|時間 \(秒\)|1|9|11|19|21|29|31|39|  
+|状態|Active|Filling|Active|Stopped|Active|Filling|Active|Stopped|  
+  
+ *Animation1* の <xref:System.Windows.Media.Animation.Timeline.CurrentStateInvalidated> イベントは10秒で発生しますが、状態は <xref:System.Windows.Media.Animation.ClockState> のままになる点に注目してください。  これは、状態は 10 秒で変更されますが、<xref:System.Windows.Media.Animation.ClockState> から <xref:System.Windows.Media.Animation.ClockState> に変更され、同じタイミングで再び <xref:System.Windows.Media.Animation.ClockState> に戻されるためです。
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-render-on-a-per-frame-interval-using-compositiontarget.md b/docs/framework/wpf/graphics-multimedia/how-to-render-on-a-per-frame-interval-using-compositiontarget.md
new file mode 100644
index 00000000000..3371487785f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-render-on-a-per-frame-interval-using-compositiontarget.md
@@ -0,0 +1,49 @@
+---
+title: "方法 : CompositionTarget を使用したフレームの間隔ごとの描画 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CompositionTarget オブジェクト, 描画 (フレームごとに)"
+  - "描画 (CompositionTarget オブジェクトを使用してフレームごとに)"
+ms.assetid: 701246cd-66b7-4d69-ada9-17b3b433d95d
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : CompositionTarget を使用したフレームの間隔ごとの描画
+[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のアニメーション エンジンには、フレームベースのアニメーションを作成するためのさまざまな機能が用意されています。  ただし、フレームベースの描画をさらにきめ細かく制御することが必要となるアプリケーション シナリオがあります。  <xref:System.Windows.Media.CompositionTarget> オブジェクトを使用すると、フレームごとのコールバックに基づいてカスタム アニメーションを作成できます。  
+  
+ <xref:System.Windows.Media.CompositionTarget> は、アプリケーションが描画される表示サーフェイスを表す静的クラスです。  アプリケーションのシーンが描画されるたびに <xref:System.Windows.Media.CompositionTarget.Rendering> イベントが発生します。  レンダリング フレーム レートは、1 秒あたりのシーンの描画回数です。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.CompositionTarget> を使用したコード サンプル全体については、「[Using the CompositionTarget Sample \(CompositionTarget のサンプルの使用\)](http://go.microsoft.com/fwlink/?LinkID=160045)」を参照してください。  
+  
+## 使用例  
+ <xref:System.Windows.Media.CompositionTarget.Rendering> イベントは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の描画プロセス中に発生します。  静的 <xref:System.Windows.Media.CompositionTarget.Rendering> メソッドに対する <xref:System.EventHandler> デリゲートを <xref:System.Windows.Media.CompositionTarget> に登録する方法を次の例に示します。  
+  
+ [!code-csharp[CompositionTargetSample#CompositionTarget1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CompositionTargetSample/CSharp/Window1.xaml.cs#compositiontarget1)]
+ [!code-vb[CompositionTargetSample#CompositionTarget1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CompositionTargetSample/visualbasic/window1.xaml.vb#compositiontarget1)]  
+  
+ 独自の描画イベント ハンドラー メソッドを使用して、描画のカスタム コンテンツを作成できます。  このイベント ハンドラー メソッドは、フレームごとに 1 回呼び出されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が[ビジュアル ツリー](GTMT)の永続化されたレンダリング データを合成シーン グラフにマーシャリングするたびに、イベント ハンドラー メソッドが呼び出されます。  さらに、[ビジュアル ツリー](GTMT)に対する変更によって合成シーン グラフが強制的に更新される場合も、イベント ハンドラー メソッドが呼び出されます。  イベント ハンドラー メソッドは、レイアウトが計算された後に呼び出されます。  ただし、イベント ハンドラー メソッド内でレイアウトを変更できます。つまり、そのレイアウトは、描画する前にもう一度計算されることになります。  
+  
+ <xref:System.Windows.Media.CompositionTarget> イベント ハンドラー メソッドでカスタム描画を指定する方法を次の例に示します。  この場合、<xref:System.Windows.Controls.Canvas> の背景色は、マウスの座標位置に基づくカラー値で描画されます。  <xref:System.Windows.Controls.Canvas> 内でマウスを移動すると、その背景色が変わります。  また、現在の経過時間および描画されたフレームの合計数に基づいて、平均フレーム レートが計算されます。  
+  
+ [!code-csharp[CompositionTargetSample#CompositionTarget2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/CompositionTargetSample/CSharp/Window1.xaml.cs#compositiontarget2)]
+ [!code-vb[CompositionTargetSample#CompositionTarget2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/CompositionTargetSample/visualbasic/window1.xaml.vb#compositiontarget2)]  
+  
+ カスタム描画は、コンピューターごとに異なる速度で実行される場合があります。  これは、カスタム描画がフレーム レートに依存するためです。  実行しているシステムとそのシステムの負荷に応じて、<xref:System.Windows.Media.CompositionTarget.Rendering> イベントが 1 秒あたりに呼び出される回数が異なる場合があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションを実行するデバイスのグラフィックス ハードウェアの機能およびパフォーマンスの決定については、「[グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)」を参照してください。  
+  
+ イベントの発生中の描画 <xref:System.EventHandler> デリゲートの追加または削除は、イベントが終了するまで遅延します。  これは、<xref:System.MulticastDelegate> ベースのイベントが共通言語ランタイム \(CLR\) で処理される方法と一貫性があります。  また、描画イベントが特定の順序で呼び出されるかどうかは保証されません。  特定の順序に依存する複数の <xref:System.EventHandler> デリゲートがある場合、単一の <xref:System.Windows.Media.CompositionTarget.Rendering> イベントを登録し、手動でデリゲートを正しい順序で多重化する必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Media.CompositionTarget>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md
new file mode 100644
index 00000000000..0cbbd907b45
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : アニメーションを反復する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 繰り返し"
+  - "RepeatBehavior プロパティ (タイムラインの)"
+  - "反復 (アニメーションを)"
+  - "タイムラインの RepeatBehavior プロパティ"
+ms.assetid: e6f3b068-eeeb-47fd-8d40-8848c31f1e1e
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : アニメーションを反復する
+アニメーションの繰り返し動作を制御するために <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用する方法を次の例に示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.Timeline> コントロールの <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティは、アニメーションが単純継続時間を繰り返す回数を制御します。  <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> を使用して、<xref:System.Windows.Media.Animation.Timeline> が特定の回数 \(反復カウント\) または指定した期間、繰り返すことを指定できます。  いずれの場合も、アニメーションは、要求されたカウントまたは期間を満たすのに必要な回数だけ実行を繰り返します。  
+  
+ 既定では、タイムラインの反復カウントは 1.0 です。これは、再生回数が 1 回で、繰り返されないことを意味します。  ただし、<xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを <xref:System.Windows.Media.Animation.RepeatBehavior.Forever%2A> に設定した場合、タイムラインは無限に繰り返します。  
+  
+ <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用してアニメーションの繰り返し動作を制御する方法を次の例に示します。  この例は、それぞれの四角形で異なる種類の繰り返し動作を使用する 5 つの四角形の <xref:System.Windows.FrameworkElement.Width%2A> プロパティをアニメーション化しています。  
+  
+ [!code-xml[timingbehaviors_snip#RepeatBehaviorWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/RepeatBehaviorExample.xaml#repeatbehaviorwholepage)]  
+  
+ サンプル全体については、[アニメーションのタイミング動作のサンプル](http://go.microsoft.com/fwlink/?LinkID=159970)を参照してください。  
+  
+## 参照  
+ [反復サイクル中にアニメーション値を累積する](../../../../docs/framework/wpf/graphics-multimedia/how-to-accumulate-animation-values-during-repeat-cycles.md)   
+ [タイムラインを自動的に反転するかどうかを指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [アニメーションのタイミング動作のサンプル](http://go.microsoft.com/fwlink/?LinkID=159970)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-repeat-media-playback.md b/docs/framework/wpf/graphics-multimedia/how-to-repeat-media-playback.md
new file mode 100644
index 00000000000..848c65a3ecb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-repeat-media-playback.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : メディアの再生を反復する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メディアを繰り返し再生"
+  - "繰り返し (メディアの再生を)"
+  - "マルチ メディア、メディアの再生を繰り返す"
+  - "繰り返しのメディアの再生"
+ms.assetid: 02ab486d-c6b6-4918-9edd-45a12aca4683
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : メディアの再生を反復する
+この例では、どのメディアの再生に無期限には、無限ループで再生するように、メディアを設定することです。  
+  
+## <a name="example"></a>例  
+ 次の例では使用<xref:System.Windows.Controls.MediaElement>と<xref:System.Windows.Media.MediaTimeline>で、<xref:System.Windows.Media.Animation.Storyboard>無限ループにメディア クリップを再生します。  
+  
+ [!code-xml[MediaGallery_snippet#SoundRepeatExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaGallery_snippet/CSharp/SoundRepeatExample.xaml#soundrepeatexamplewholepage)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.MediaElement>   
+ <xref:System.Windows.Media.MediaTimeline>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md)   
+ [グラフィックスとマルチ メディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md
new file mode 100644
index 00000000000..9dc7e3c53e2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : ジオメトリック パスを使用してオブジェクトを回転させる (行列アニメーション) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジオメトリック パス、によってオブジェクトを回転させる"
+  - "回転 (ジオメトリック パスでオブジェクトを)"
+  - "行列アニメーション"
+ms.assetid: 877dc9aa-6bdc-4beb-8772-3efaec32c0f0
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : ジオメトリック パスを使用してオブジェクトを回転させる (行列アニメーション)
+この例では、使用、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>と<xref:System.Windows.Media.MatrixTransform> (ピボット) によって定義されたジオメトリック パスに沿ってオブジェクトを回転する、 <xref:System.Windows.Media.PathGeometry>オブジェクトです。  
+  
+## <a name="example"></a>例  
+ 次の例では、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>アニメーション化するオブジェクト、<xref:System.Windows.Media.MatrixTransform.Matrix%2A>のプロパティ、 <xref:System.Windows.Media.MatrixTransform>します。 <xref:System.Windows.Media.MatrixTransform>ボタンに適用され、曲線のパスに沿って移動する場合は、です。 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.DoesRotateWithTangent%2A>にプロパティが設定されている`true`パスの接線に沿った四角形が回転します。  
+  
+ [!code-xml[PathAnimationGallery_snippet#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/matrixanimationusingpathdoesrotatewithtangentexample.xaml#matrixanimationusingpathdoesrotatewithtangentwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/MatrixAnimationUsingPathDoesRotateWithTangentExample.cs#matrixanimationusingpathdoesrotatewithtangentwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/MatrixAnimationUsingPathDoesRotateWithTangentExample.vb#matrixanimationusingpathdoesrotatewithtangentwholepage)]  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。  
+  
+ 使用前の例のコードのバージョン、<xref:System.Windows.Media.Animation.Storyboard>をアニメーション化する、 <xref:System.Windows.Media.EllipseGeometry>1 つだけのアニメーションが適用された場合でも、します。 コード内のプロパティに&1; つのアニメーションを適用する簡単な方法は、使用する、 <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A>メソッドです。 例については、次を参照してください。[プロパティなしを使用して、ストーリー ボード アニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)です。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)   
+ [パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path.md b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path.md
new file mode 100644
index 00000000000..8646bfd4081
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path.md
@@ -0,0 +1,44 @@
+---
+title: "方法 : ジオメトリック パスを使用してオブジェクトを回転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジオメトリック パス、によってオブジェクトを回転させる"
+  - "回転 (ジオメトリック パスでオブジェクトを)"
+ms.assetid: cb31ca4d-f05a-4c6b-9a18-4b6faaf38d45
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : ジオメトリック パスを使用してオブジェクトを回転させる
+この例では (ピボット) を回転するオブジェクトによって定義されたジオメトリック パスに沿って、 <xref:System.Windows.Media.PathGeometry>オブジェクトです。  
+  
+## <a name="example"></a>例  
+ 次の例は、3 つ<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>ジオメトリック パスに沿った四角形を移動するオブジェクト。  
+  
+-   最初の<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>をアニメーション化、 <xref:System.Windows.Media.RotateTransform>四角形に適用されています。 アニメーションは、角度の値を生成します。 パスの輪郭に沿って (ピボット) を回転する四角形を使用して行えます。  
+  
+-   その他の&2; つのオブジェクトをアニメーション化する、 <xref:System.Windows.Media.TranslateTransform.X%2A>と<xref:System.Windows.Media.TranslateTransform.Y%2A>の値、 <xref:System.Windows.Media.TranslateTransform>四角形に適用されています。 四角形の幅と高さをパスに沿って移動を確認します。  
+  
+ [!code-xml[PathAnimationGallery_snippet#RotateAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/rotateanimationusingpathexample.xaml#rotateanimationusingpathwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#RotateAnimationUsingPathWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/RotateAnimationUsingPathExample.cs#rotateanimationusingpathwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#RotateAnimationUsingPathWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/RotateAnimationUsingPathExample.vb#rotateanimationusingpathwholepage)]  
+  
+ ジオメトリック パスを使用してオブジェクトを回転する別の方法を使用して、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>オブジェクトし、設定、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.DoesRotateWithTangent%2A>プロパティを`true`します。 詳細と例では、次を参照してください。[ジオメトリック パス (行列アニメーション) を使用してオブジェクトを回転させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md)します。  
+  
+ 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object.md b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object.md
new file mode 100644
index 00000000000..4d1b179795e
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : オブジェクトを回転させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 回転 (オブジェクトを)"
+  - "回転 (オブジェクトを)"
+ms.assetid: ee3466cd-e66f-4e8f-8a5a-71d77bc1e390
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : オブジェクトを回転させる
+この例では、オブジェクトを回転させる方法を示します。  この例では、最初に <xref:System.Windows.Media.RotateTransform> を作成した後、その <xref:System.Windows.Media.RotateTransform.Angle%2A> を度で指定します。  
+  
+ 次の例では、<xref:System.Windows.Shapes.Polyline> オブジェクトを、左上隅を中心に 45°回転します。  
+  
+## 使用例  
+ [!code-xml[Transforms_snip#RotatePolylineAboutTopLeft](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/RotateTransformExample.xaml#rotatepolylineabouttopleft)]  
+  
+ [!code-csharp[Transforms_Procedural_snip#RotatePolylineAboutTopLeft](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_Procedural_snip/CSharp/RotateTransformExample.cs#rotatepolylineabouttopleft)]
+ [!code-vb[Transforms_Procedural_snip#RotatePolylineAboutTopLeft](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Transforms_Procedural_snip/VisualBasic/RotateTransformExample.vb#rotatepolylineabouttopleft)]  
+  
+ <xref:System.Windows.Media.RotateTransform> の <xref:System.Windows.Media.RotateTransform.CenterX%2A> プロパティと <xref:System.Windows.Media.RotateTransform.CenterY%2A> プロパティは、オブジェクトを回転させる中心点を指定します。  この中心点は、変換する要素の座標空間で表します。  既定では、回転は \(0,0\) に適用されます。これは変換対象のオブジェクトの左上隅です。  
+  
+ 次の例では、<xref:System.Windows.Shapes.Polyline> オブジェクトを、点 \(25,50\) を中心にして時計回りに 45°回転します。  
+  
+ [!code-xml[Transforms_snip#RotatePolylineAboutCenter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/RotateTransformExample.xaml#rotatepolylineaboutcenter)]  
+  
+ [!code-csharp[Transforms_Procedural_snip#RotatePolylineAboutCenter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_Procedural_snip/CSharp/RotateTransformExample.cs#rotatepolylineaboutcenter)]
+ [!code-vb[Transforms_Procedural_snip#RotatePolylineAboutCenter](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/Transforms_Procedural_snip/VisualBasic/RotateTransformExample.vb#rotatepolylineaboutcenter)]  
+  
+ 次の図は、2 つのオブジェクトに <xref:System.Windows.Media.Transform> を適用した結果を示しています。  
+  
+ ![中心点が異なる 45 度の回転](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-rotatetransform45degrees.png "wcpsdk\_graphicsmm\_rotatetransform45degrees")  
+異なる中心点を軸に 45°回転させた 2 つのオブジェクト  
+  
+ 前の例での <xref:System.Windows.Shapes.Polyline> は <xref:System.Windows.UIElement> です。  <xref:System.Windows.UIElement> の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.Transform> を適用するときは、<xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティを使用して、その要素に適用するすべての <xref:System.Windows.Media.Transform> の原点を指定できます。  <xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティは相対座標を使用するので、要素のサイズがわからなくても、要素の中心に変換を適用できます。  詳細および例については、「[変換の原点を相対値で指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-the-origin-of-a-transform-by-using-relative-values.md)」を参照してください。  
+  
+ サンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-round-the-corners-of-a-rectanglegeometry.md b/docs/framework/wpf/graphics-multimedia/how-to-round-the-corners-of-a-rectanglegeometry.md
new file mode 100644
index 00000000000..5dcd24324c2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-round-the-corners-of-a-rectanglegeometry.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : RectangleGeometry の角に丸みを付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "角, 丸め処理"
+  - "グラフィックス, 丸み付け (RectangleGeometry の角の)"
+  - "RectangleGeometry クラス, 丸み付け (角の)"
+  - "丸み付け (RectangleGeometry の角の)"
+ms.assetid: 926644bc-1357-4c0b-ac81-694bd090ae87
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : RectangleGeometry の角に丸みを付ける
+<xref:System.Windows.Media.RectangleGeometry> の角に丸みを付けるには、<xref:System.Windows.Media.RectangleGeometry.RadiusX%2A> プロパティと <xref:System.Windows.Media.RectangleGeometry.RadiusY%2A> プロパティに 0 より大きい値を設定します。  値が大きいほど、四角形の角は丸くなります。  
+  
+## 使用例  
+ <xref:System.Windows.Media.RectangleGeometry.RadiusX%2A> と <xref:System.Windows.Media.RectangleGeometry.RadiusY%2A> の設定が異なる複数の <xref:System.Windows.Media.RectangleGeometry> オブジェクトを次の例に示します。  <xref:System.Windows.Media.RectangleGeometry> オブジェクトは、<xref:System.Windows.Shapes.Path> 要素を使用して表示されます。  
+  
+ [!code-xml[GeometryOverviewSamples_snip#GraphicsMMRoundedRectangleGeometryExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometryOverviewSamples_snip/CS/RectangleGeometryRoundedCornerExample.xaml#graphicsmmroundedrectanglegeometryexamplewholepage)]  
+  
+ ![RadiusX&#47;RadiusY 設定が異なる四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rounded.png "graphicsmm\_rounded")  
+角を丸くした四角形  
+  
+## 参照  
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [複合図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-composite-shape.md)   
+ [PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-scale-an-element.md b/docs/framework/wpf/graphics-multimedia/how-to-scale-an-element.md
new file mode 100644
index 00000000000..4ed693148c8
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-scale-an-element.md
@@ -0,0 +1,53 @@
+---
+title: "方法 : 要素をスケーリングする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, ScaleTransform"
+  - "グラフィックス, スケーリング (要素を)"
+  - "ScaleTransform クラス"
+  - "スケーリング, 要素"
+ms.assetid: 18158d94-bbe7-4f6a-814e-84d27fa748bf
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 要素をスケーリングする
+<xref:System.Windows.Media.ScaleTransform> を使用して要素をスケーリングする方法を次の例に示します。  
+  
+ <xref:System.Windows.Media.ScaleTransform.ScaleX%2A> および <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> プロパティを使用して、指定するファクターごとに要素のサイズを変更します。  たとえば、<xref:System.Windows.Media.ScaleTransform.ScaleX%2A> の値が 1.5 である場合、要素は元の幅の 150% に引き伸ばされます。  <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> の値が 0.5 である場合、要素の高さは 50% 縮められます。  
+  
+ <xref:System.Windows.Media.ScaleTransform.CenterX%2A> および <xref:System.Windows.Media.ScaleTransform.CenterY%2A> プロパティを使用して、スケール操作の中心となる点を指定します。  既定では、<xref:System.Windows.Media.ScaleTransform> は中心点 \(0,0\) に配置されます。これは四角形の左上隅に相当します。  <xref:System.Windows.Media.Transform> を適用すると、オブジェクトが存在する座標空間が変更されるため、これには要素を移動する効果、および要素を大きく表示する効果もあります。  
+  
+ 次のコード例では、<xref:System.Windows.Media.ScaleTransform> を使用して、縦横 50 サイズの <xref:System.Windows.Shapes.Rectangle> を 2 倍にします。  <xref:System.Windows.Media.ScaleTransform> には、<xref:System.Windows.Media.ScaleTransform.CenterX%2A> と <xref:System.Windows.Media.ScaleTransform.CenterY%2A> の両方に対して値 0 \(既定値\) があります。  
+  
+## 使用例  
+ [!code-xml[transformsSample#21](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/ScaleTransformExample.xaml#21)]  
+  
+ 通常、<xref:System.Windows.Media.ScaleTransform.CenterX%2A> および <xref:System.Windows.Media.ScaleTransform.CenterY%2A> をスケーリングされるオブジェクトの中心に設定します \(<xref:System.Windows.FrameworkElement.Width%2A>\/2、<xref:System.Windows.FrameworkElement.Height%2A>\/2\)。  
+  
+ サイズが 2 倍にされている別の <xref:System.Windows.Shapes.Rectangle> の例を次に示します。ただし、この <xref:System.Windows.Media.ScaleTransform> には、<xref:System.Windows.Media.ScaleTransform.CenterX%2A> と <xref:System.Windows.Media.ScaleTransform.CenterY%2A> の両方に対して、四角形の中心に対応する値 25 があります。  
+  
+ [!code-xml[transformsSample#22](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/ScaleTransformExample.xaml#22)]  
+  
+ 2 つの <xref:System.Windows.Media.ScaleTransform> の操作の違いを次の図に示します。  点線は、スケーリング前の四角形のサイズと位置を示します。  
+  
+ ![中心点が異なる 2 倍のスケール](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-scalecenter.png "wcpsdk\_graphicsmm\_scalecenter")  
+ScaleX 値と ScaleY 値が同じであっても中心が異なる 2 つの ScaleTransform 操作  
+  
+ サンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.ScaleTransform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-seek-a-clock-synchronously.md b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-clock-synchronously.md
new file mode 100644
index 00000000000..deb33fe0109
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-clock-synchronously.md
@@ -0,0 +1,29 @@
+---
+title: "方法 : クロックを同期的にシークする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クロック, シーク (同期的に)"
+  - "シーク (クロックを同期的に)"
+ms.assetid: e5b7529b-b7d0-40d2-9e1d-fa4b5e736e96
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : クロックを同期的にシークする
+<xref:System.Windows.Media.Animation.ClockController.SeekAlignedToLastTick%2A> メソッドを使用して、特定のポイントまでクロックを同期的にシークします。  <xref:System.Windows.Media.Animation.ClockController> の <xref:System.Windows.Media.Animation.ClockController.Seek%2A> メソッドおよび <xref:System.Windows.Media.Animation.ClockController.SeekAlignedToLastTick%2A> メソッドを次の例に示します。  
+  
+ この例では、<xref:System.Windows.Media.Animation.Clock> をシークする方法を示します。ストーリーボードをシークする方法の例については、「[ストーリーボードを同期的にシークする](../../../../docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[ClockController_procedural_snip#ClockControllerSeekExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ClockController_procedural_snip/CSharp/SeekAlignedToLastTickExample.cs#clockcontrollerseekexample)]
+ [!code-vb[ClockController_procedural_snip#ClockControllerSeekExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ClockController_procedural_snip/visualbasic/seekalignedtolasttickexample.vb#clockcontrollerseekexample)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md
new file mode 100644
index 00000000000..01de9ae12cb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md
@@ -0,0 +1,34 @@
+---
+title: "方法 : ストーリーボードを同期的にシークする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "シーク (ストーリーボードを同期的に)"
+  - "ストーリーボード, シーク (同期的に)"
+ms.assetid: 03e06271-a946-4810-88ea-3fb4cfa9e0f1
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法 : ストーリーボードを同期的にシークする
+次の例では、<xref:System.Windows.Media.Animation.Storyboard> の <xref:System.Windows.Media.Animation.Storyboard.SeekAlignedToLastTick%2A> メソッドを使用して、ストーリーボード アニメーション内の位置を同期的にシークする方法を示します。  
+  
+## 使用例  
+ サンプルの XAML マークアップは次のとおりです。  
+  
+ [!code-xml[SeekStoryboard_snip#SeekStoryboardSynchronouslyExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SeekStoryboard_snip/CSharp/SeekStoryboardSynchronouslyExample.xaml#seekstoryboardsynchronouslyexamplewholepage)]  
+  
+## 使用例  
+ 上記の XAML コードと共に使用するコードは次のとおりです。  
+  
+ [!code-csharp[SeekStoryboard_snip#SeekStoryboardSynchronouslyCodeBehindExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SeekStoryboard_snip/CSharp/SeekStoryboardSynchronouslyExample.xaml.cs#seekstoryboardsynchronouslycodebehindexamplewholepage)]
+ [!code-vb[SeekStoryboard_snip#SeekStoryboardSynchronouslyCodeBehindExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SeekStoryboard_snip/VisualBasic/SeekStoryboardSynchronouslyExample.xaml.vb#seekstoryboardsynchronouslycodebehindexamplewholepage)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard.md b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard.md
new file mode 100644
index 00000000000..7116d6545b5
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : ストーリーボードをシークする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "シーク (ストーリーボードを)"
+  - "ストーリーボード, シーク"
+ms.assetid: 887bb39a-0c2a-4ae8-956d-1d9f6f8ebbfc
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法 : ストーリーボードをシークする
+<xref:System.Windows.Media.Animation.Storyboard> の <xref:System.Windows.Media.Animation.Storyboard.Seek%2A> メソッドを使用して、ストーリーボード アニメーション内の任意の位置にジャンプする方法を次の例に示します。  
+  
+## 使用例  
+ サンプルの XAML マークアップは次のとおりです。  
+  
+ [!code-xml[SeekStoryboard_snip#SeekStoryboardExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SeekStoryboard_snip/CSharp/SeekStoryboardExample.xaml#seekstoryboardexamplewholepage)]  
+  
+## 使用例  
+ 上記の XAML コードと共に使用するコードは次のとおりです。  
+  
+ [!code-csharp[SeekStoryboard_snip#SeekStoryboardCodeBehindExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/SeekStoryboard_snip/CSharp/SeekStoryboardExample.xaml.cs#seekstoryboardcodebehindexamplewholepage)]
+ [!code-vb[SeekStoryboard_snip#SeekStoryboardCodeBehindExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/SeekStoryboard_snip/VisualBasic/SeekStoryboardExample.xaml.vb#seekstoryboardcodebehindexamplewholepage)]  
+  
+## 参照  
+ [ストーリーボードを同期的にシークする](../../../../docs/framework/wpf/graphics-multimedia/how-to-seek-a-storyboard-synchronously.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-set-a-duration-for-an-animation.md b/docs/framework/wpf/graphics-multimedia/how-to-set-a-duration-for-an-animation.md
new file mode 100644
index 00000000000..f97793502ab
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-set-a-duration-for-an-animation.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : アニメーションの継続時間を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 継続時間"
+  - "継続期間 (アニメーションの)"
+  - "タイムライン, description"
+ms.assetid: 155034ef-7d00-4416-a73c-b1713992d2eb
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : アニメーションの継続時間を設定する
+<xref:System.Windows.Media.Animation.Timeline> は時間のセグメントを表し、そのセグメントの長さはタイムラインの <xref:System.Windows.Duration> によって決まります。  <xref:System.Windows.Media.Animation.Timeline> は、期間の最後に到達すると、再生を停止します。  <xref:System.Windows.Media.Animation.Timeline> に子タイムラインがある場合は、子も再生を停止します。  アニメーションの場合は、<xref:System.Windows.Duration> は、アニメーションが開始値から終了値まで移行するのに要する時間を指定します。  
+  
+ <xref:System.Windows.Duration> には、特定の有限の時間、または特殊な値 <xref:System.Windows.Duration.Automatic%2A> または <xref:System.Windows.Duration.Forever%2A> を指定できます。  アニメーションには、常に有限の長さを定義する必要があるため、アニメーションの継続時間は必ず時間値にする必要があります。それ以外の場合、アニメーションは、ターゲット値の間で遷移する方法を認識できません。  <xref:System.Windows.Media.Animation.Storyboard> や <xref:System.Windows.Media.Animation.ParallelTimeline> などのコンテナー タイムライン \(<xref:System.Windows.Media.Animation.TimelineGroup> オブジェクト\) の既定の期間は <xref:System.Windows.Duration.Automatic%2A> であり、最後の子が再生を停止した時点で自動的に終了することを意味します。  
+  
+ 次の例では、<xref:System.Windows.Shapes.Rectangle> の幅、高さ、および塗りつぶしの色をアニメーション化しています。  期間はアニメーションとコンテナーのタイムラインに設定されており、アニメーションの認識された速度の制御と、コンテナー タイムラインの期間での子タイムラインの期間のオーバーライドを含むアニメーション効果になっています。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#DurationExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/DurationExample.xaml#durationexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Duration>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md b/docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md
new file mode 100644
index 00000000000..c81681f27e8
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-set-a-property-after-animating-it-with-a-storyboard.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : ストーリーボードを使用してアニメーション化した後にプロパティを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 変更 (後でプロパティ値を)"
+ms.assetid: 79466556-4dbf-40bd-9c1e-a77613b07077
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ストーリーボードを使用してアニメーション化した後にプロパティを設定する
+状況によっては、プロパティをアニメーション化した後に、そのプロパティの値を変更できないように見えることがあります。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.Animation.Storyboard> を使用して <xref:System.Windows.Media.SolidColorBrush> の色をアニメーション化します。  ボタンがクリックされると、ストーリーボードがトリガーされます。  <xref:System.Windows.Media.Animation.Timeline.Completed> イベントを処理することで、<xref:System.Windows.Media.Animation.ColorAnimation> が完了したときにプログラムが通知を受け取るようにします。  
+  
+ [!code-xml[timingbehaviors_snip#GraphicsMMButton1Declaration](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml#graphicsmmbutton1declaration)]  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.ColorAnimation> が完了したら、ブラシの色を青に変更します。  
+  
+ [!code-csharp[timingbehaviors_snip#GraphicsMMButton1Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml.cs#graphicsmmbutton1handler)]
+ [!code-vb[timingbehaviors_snip#GraphicsMMButton1Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_snip/visualbasic/animatethensetpropertyexample.xaml.vb#graphicsmmbutton1handler)]  
+  
+ 前のコードは、何も実行しないように見えます。ブラシは黄色のまま、つまりブラシをアニメーション化した <xref:System.Windows.Media.Animation.ColorAnimation> によって設定された値のままになっています。  実際には、基になるプロパティ値 \(基本値\) は青に変更されています。  しかし、実効値、つまり現在の値が黄色のままであるのは、<xref:System.Windows.Media.Animation.ColorAnimation> が基本値をオーバーライドしたままであるからです。  基本値を再び実効値にするには、アニメーションによるプロパティへの影響を停止する必要があります。  ストーリーボード アニメーションでこのようにするには、次の 3 つの方法があります。  
+  
+-   アニメーションの <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティを <xref:System.Windows.Media.Animation.FillBehavior> に設定する。  
+  
+-   ストーリーボード全体を削除する。  
+  
+-   個々のプロパティからアニメーションを削除する。  
+  
+## アニメーションの FillBehavior プロパティを Stop に設定する  
+ <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> を <xref:System.Windows.Media.Animation.FillBehavior> に設定することで、アニメーションがアクティブ期間の終わりに到達したらターゲット プロパティに影響を与えなくなるように指定します。  
+  
+ [!code-xml[timingbehaviors_snip#GraphicsMMButton2Declaration](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml#graphicsmmbutton2declaration)]  
+  
+ [!code-csharp[timingbehaviors_snip#GraphicsMMButton2Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml.cs#graphicsmmbutton2handler)]
+ [!code-vb[timingbehaviors_snip#GraphicsMMButton2Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_snip/visualbasic/animatethensetpropertyexample.xaml.vb#graphicsmmbutton2handler)]  
+  
+## ストーリーボード全体を削除する  
+ <xref:System.Windows.Media.Animation.RemoveStoryboard> トリガーまたは <xref:System.Windows.Media.Animation.Storyboard.Remove%2A?displayProperty=fullName> メソッドを使用することで、ストーリーボード アニメーションによるターゲット プロパティへの影響を停止します。  この方法と、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティを設定する方法の違いは、ストーリーボードはいつでも削除できるのに対し、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティの効果が現れるのはアニメーションがアクティブ期間の終わりに到達したときのみという点です。  
+  
+ [!code-xml[timingbehaviors_snip#GraphicsMMButton3Declaration](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml#graphicsmmbutton3declaration)]  
+  
+ [!code-csharp[timingbehaviors_snip#GraphicsMMButton3Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml.cs#graphicsmmbutton3handler)]
+ [!code-vb[timingbehaviors_snip#GraphicsMMButton3Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_snip/visualbasic/animatethensetpropertyexample.xaml.vb#graphicsmmbutton3handler)]  
+  
+## 個々のプロパティからアニメーションを削除する  
+ アニメーションによるプロパティへの影響を停止するには、アニメーション化するオブジェクトの <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%28System.Windows.DependencyProperty%2CSystem.Windows.Media.Animation.AnimationTimeline%29> メソッドを使用するという方法もあります。  アニメーション化するプロパティを最初のパラメーターとして指定し、`null` を 2 番目のパラメーターとして指定します。  
+  
+ [!code-xml[timingbehaviors_snip#GraphicsMMButton4Declaration](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml#graphicsmmbutton4declaration)]  
+  
+ [!code-csharp[timingbehaviors_snip#GraphicsMMButton4Handler](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AnimateThenSetPropertyExample.xaml.cs#graphicsmmbutton4handler)]
+ [!code-vb[timingbehaviors_snip#GraphicsMMButton4Handler](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_snip/visualbasic/animatethensetpropertyexample.xaml.vb#graphicsmmbutton4handler)]  
+  
+ この方法は、ストーリーボード以外の手法によるアニメーションにも利用できます。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A>   
+ <xref:System.Windows.Media.Animation.Storyboard.Remove%2A?displayProperty=fullName>   
+ <xref:System.Windows.Media.Animation.RemoveStoryboard>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-set-the-horizontal-and-vertical-alignment-of-a-tilebrush.md b/docs/framework/wpf/graphics-multimedia/how-to-set-the-horizontal-and-vertical-alignment-of-a-tilebrush.md
new file mode 100644
index 00000000000..df941ba3d03
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-set-the-horizontal-and-vertical-alignment-of-a-tilebrush.md
@@ -0,0 +1,83 @@
+---
+title: "方法 : TileBrush の水平方向および垂直方向の配置を設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エイリアスの使用, TileBrush"
+  - "水平方向の配置 (TileBrush の)"
+  - "TileBrush, 配置"
+  - "垂直方向の配置 (TileBrush の)"
+ms.assetid: 65ae89bd-9246-4c9e-bde4-2fb991d4060d
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : TileBrush の水平方向および垂直方向の配置を設定する
+この例では、タイル内にあるコンテンツの水平方向の配置と垂直方向の配置を制御する方法を示します。  <xref:System.Windows.Media.TileBrush> の水平方向および垂直方向の配置を制御するには、その <xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティと <xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティを使用します。  
+  
+ 次のいずれかの条件に当てはまる場合は、<xref:System.Windows.Media.TileBrush> の <xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティと <xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティが使用されます。  
+  
+-   <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティが <xref:System.Windows.Media.Stretch> または <xref:System.Windows.Media.Stretch> で、<xref:System.Windows.Media.TileBrush.Viewbox%2A> および <xref:System.Windows.Media.TileBrush.Viewport%2A> の[縦横比](GTMT)が異なる場合。  
+  
+-   <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティが <xref:System.Windows.Media.Stretch> で、<xref:System.Windows.Media.TileBrush.Viewbox%2A> および <xref:System.Windows.Media.TileBrush.Viewport%2A> のサイズが異なる場合。  
+  
+## 使用例  
+ <xref:System.Windows.Media.TileBrush> の一種である <xref:System.Windows.Media.DrawingBrush> のコンテンツをタイルの左上隅に配置する例を次に示します。  コンテンツの配置のため、この例では、<xref:System.Windows.Media.DrawingBrush> の <xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティを <xref:System.Windows.Media.AlignmentX>、<xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティを <xref:System.Windows.Media.AlignmentY> に設定しています。  この例を実行すると、次の出力が生成されます。  
+  
+ ![左上に配置された TileBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexampletopleft.png "graphicsmm\_TileBrushAlignmentExampleTopLeft")  
+コンテンツを左上隅に配置した TileBrush  
+  
+ [!code-csharp[brushoverviewexamples_snip#TileBrushTopLeftAlignmentInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/TileBrushAlignmentExample.cs#tilebrushtopleftalignmentinline)]
+ [!code-vb[brushoverviewexamples_snip#TileBrushTopLeftAlignmentInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_snip/visualbasic/tilebrushalignmentexample.vb#tilebrushtopleftalignmentinline)]
+ [!code-xml[brushoverviewexamples_snip#TileBrushTopLeftAlignmentInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileBrushAlignmentExample.xaml#tilebrushtopleftalignmentinline)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティを <xref:System.Windows.Media.AlignmentX>、<xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティを <xref:System.Windows.Media.AlignmentY> に設定して、<xref:System.Windows.Media.DrawingBrush> のコンテンツをタイルの右下隅に配置します。  この例の出力は、次のようになります。  
+  
+ ![右下に配置された TileBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexamplebottomright.png "graphicsmm\_TileBrushAlignmentExampleBottomRight")  
+コンテンツを右下隅に配置した TileBrush  
+  
+ [!code-csharp[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/TileBrushAlignmentExample.cs#tilebrushbottomrightalignmentinline)]
+ [!code-vb[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_snip/visualbasic/tilebrushalignmentexample.vb#tilebrushbottomrightalignmentinline)]
+ [!code-xml[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileBrushAlignmentExample.xaml#tilebrushbottomrightalignmentinline)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティを <xref:System.Windows.Media.AlignmentX>、<xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティを <xref:System.Windows.Media.AlignmentY> に設定して、<xref:System.Windows.Media.DrawingBrush> のコンテンツをタイルの左上隅に配置します。  さらに、<xref:System.Windows.Media.DrawingBrush> の <xref:System.Windows.Media.TileBrush.Viewport%2A> および <xref:System.Windows.Media.TileBrush.TileMode%2A> を設定して、タイル パターンを生成します。  この例の出力は、次のようになります。  
+  
+ ![左上に並べて配置された TileBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexampletoplefttiled.png "graphicsmm\_TileBrushAlignmentExampleTopLeftTiled")  
+基本タイルの左上部分にコンテンツを配置したタイル パターン  
+  
+ この図では、コンテンツがどのように配置されるかを確認できるように、基本タイルを強調表示しています。  <xref:System.Windows.Media.DrawingBrush> のコンテンツが基本タイルの水平方向を完全に埋めているため、<xref:System.Windows.Media.TileBrush.AlignmentX%2A> の設定は影響を及ぼさないことに注意してください。  
+  
+ [!code-csharp[brushoverviewexamples_snip#TileBrushTopLeftAlignmentTiledInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/TileBrushAlignmentExample.cs#tilebrushtopleftalignmenttiledinline)]
+ [!code-vb[brushoverviewexamples_snip#TileBrushTopLeftAlignmentTiledInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_snip/visualbasic/tilebrushalignmentexample.vb#tilebrushtopleftalignmenttiledinline)]
+ [!code-xml[brushoverviewexamples_snip#TileBrushTopLeftAlignmentTiledInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileBrushAlignmentExample.xaml#tilebrushtopleftalignmenttiledinline)]  
+  
+## 使用例  
+ 最後の例では、<xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティを <xref:System.Windows.Media.AlignmentX>、<xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティを <xref:System.Windows.Media.AlignmentY> に設定して、並べて表示された <xref:System.Windows.Media.DrawingBrush> のコンテンツを基本タイルの右下に配置します。  この例の出力は、次のようになります。  
+  
+ ![右下に並べて配置された TileBrush](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexamplebottomrighttiled.png "graphicsmm\_TileBrushAlignmentExampleBottomRightTiled")  
+基本タイルの右下部分にコンテンツを配置したタイル パターン  
+  
+ ここでも、<xref:System.Windows.Media.DrawingBrush> のコンテンツが基本タイルの水平方向を完全に埋めているため、<xref:System.Windows.Media.TileBrush.AlignmentX%2A> の設定は影響を及ぼしません。  
+  
+ [!code-csharp[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/TileBrushAlignmentExample.cs#tilebrushbottomrightalignmentinline)]
+ [!code-vb[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_snip/visualbasic/tilebrushalignmentexample.vb#tilebrushbottomrightalignmentinline)]
+ [!code-xml[brushoverviewexamples_snip#TileBrushBottomRightAlignmentInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileBrushAlignmentExample.xaml#tilebrushbottomrightalignmentinline)]  
+  
+ ここでは、<xref:System.Windows.Media.DrawingBrush> オブジェクトを例に取って <xref:System.Windows.Media.TileBrush.AlignmentX%2A> プロパティと <xref:System.Windows.Media.TileBrush.AlignmentY%2A> プロパティの使用方法を示しています。  これらのプロパティは、<xref:System.Windows.Media.DrawingBrush>、<xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.VisualBrush> のすべてのタイル ブラシでまったく同じように動作します。  タイル ブラシの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingBrush>   
+ <xref:System.Windows.Media.ImageBrush>   
+ <xref:System.Windows.Media.VisualBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-set-the-tile-size-for-a-tilebrush.md b/docs/framework/wpf/graphics-multimedia/how-to-set-the-tile-size-for-a-tilebrush.md
new file mode 100644
index 00000000000..7d6cf02eb4a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-set-the-tile-size-for-a-tilebrush.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : TileBrush のタイル サイズを設定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TileBrush, サイズ (タイルの)"
+  - "Viewport プロパティ (TileBrush の)"
+ms.assetid: 04f41090-1b46-4e36-832f-d27d28708b8c
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : TileBrush のタイル サイズを設定する
+この例では、<xref:System.Windows.Media.TileBrush> のタイル サイズを設定する方法について説明します。  既定では、<xref:System.Windows.Media.TileBrush> は、描画する領域を完全に塗りつぶす 1 つのタイルを生成します。  <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティと <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティを設定することで、この動作をオーバーライドできます。  
+  
+ <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティは、<xref:System.Windows.Media.TileBrush> のタイル サイズを指定します。  既定では、<xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティの値は、描画する領域のサイズを基準にした相対値です。  <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティでタイル サイズの絶対値を指定するには、<xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティを <xref:System.Windows.Media.BrushMappingMode> に設定します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.TileBrush> の一種である <xref:System.Windows.Media.ImageBrush> を使用して、四角形をタイルで塗りつぶします。  各タイルを、出力領域 \(四角形\) の 50% x 50% に設定しています。  結果として、四角形はイメージの 4 つの投影で塗りつぶされます。  
+  
+ この例が生成する出力を次の図に示します。  
+  
+ ![イメージ ブラシを並べて表示する例](../../../../docs/framework/wpf/graphics-multimedia/media/0.png "0")  
+  
+ [!code-csharp[UsingImageBrush_snip#RelativeTileSizeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush_snip/CSharp/TileSizeExample.cs#relativetilesizeexample)]  
+  
+ 次の例では、<xref:System.Windows.Media.ImageBrush> を作成し、その <xref:System.Windows.Media.TileBrush.Viewport%2A> を `0,0,25,25` に、また <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> を <xref:System.Windows.Media.BrushMappingMode> に設定して、そのイメージ ブラシを使用して別の四角形を塗りつぶします。  結果として、幅が 25 [ピクセル](GTMT)で高さが 25 [ピクセル](GTMT)のタイルが生成されます。  
+  
+ この例が生成する出力を次の図に示します。  
+  
+ ![ビューポート 0,0,0.25,0.25 で並べて表示される TileBrush](../../../../docs/framework/wpf/graphics-multimedia/media/25x25viewport.png "25x25viewport")  
+  
+ [!code-csharp[UsingImageBrush_snip#AbsoluteTileSizeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush_snip/CSharp/TileSizeExample.cs#absolutetilesizeexample)]  
+  
+ 前の例は、大きなサンプルの一部です。  サンプル全体については、[ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)を参照してください。  
+  
+ この例では <xref:System.Windows.Media.ImageBrush> クラスを使用していますが、<xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティと <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティは、他の <xref:System.Windows.Media.TileBrush> オブジェクト、つまり <xref:System.Windows.Media.DrawingBrush> と <xref:System.Windows.Media.VisualBrush> に対してもまったく同じように動作します。  <xref:System.Windows.Media.ImageBrush> およびその他の <xref:System.Windows.Media.TileBrush> オブジェクトの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.TileBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [TileBrush を使用してさまざまなタイル パターンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-different-tile-patterns-with-a-tilebrush.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-simplify-animations-by-using-child-timelines.md b/docs/framework/wpf/graphics-multimedia/how-to-simplify-animations-by-using-child-timelines.md
new file mode 100644
index 00000000000..0cd6d7710a4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-simplify-animations-by-using-child-timelines.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 子タイムラインを使用してアニメーションを簡素化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 簡素化 (子タイムラインによる)"
+  - "子タイムライン"
+  - "簡素化 (子タイムラインを使用してアニメーションを)"
+ms.assetid: 8335d770-d13d-42bd-8dfa-63f92c0327e2
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 子タイムラインを使用してアニメーションを簡素化する
+この例では、子 <xref:System.Windows.Media.Animation.ParallelTimeline> オブジェクトを使用してアニメーションを簡素化する方法を示します。  <xref:System.Windows.Media.Animation.Storyboard> は <xref:System.Windows.Media.Animation.Timeline> の型で、含まれる複数のタイムラインの対象情報を持っています。  <xref:System.Windows.Media.Animation.Storyboard> を使用して、オブジェクトおよびプロパティの情報を含むタイムラインの対象情報を提供します。  
+  
+ アニメーションを開始するには、1 つ以上の <xref:System.Windows.Media.Animation.ParallelTimeline> オブジェクトを、<xref:System.Windows.Media.Animation.Storyboard> の子要素として入れ子にして使用します。  この <xref:System.Windows.Media.Animation.ParallelTimeline> オブジェクトには、他のアニメーションを格納できるので、複雑なアニメーションのタイミング シーケンスを容易にカプセル化できます。  たとえば、1 つの <xref:System.Windows.Controls.TextBlock> といくつかの図形を同じ <xref:System.Windows.Media.Animation.Storyboard> 内でアニメーション化する場合に、<xref:System.Windows.Controls.TextBlock> のアニメーションと図形のアニメーションとを分離するには、それぞれを別の <xref:System.Windows.Media.Animation.ParallelTimeline> に配置します。  それぞれの <xref:System.Windows.Media.Animation.ParallelTimeline> には独自の <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> があり、<xref:System.Windows.Media.Animation.ParallelTimeline> のすべての子要素は、この <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> を基準として開始されるため、タイミングがより効率的にカプセル化されます。  
+  
+ この例では、2 つのテキスト \(<xref:System.Windows.Controls.TextBlock> オブジェクト\) を同じ <xref:System.Windows.Media.Animation.Storyboard> 内からアニメーション化します。  <xref:System.Windows.Media.Animation.ParallelTimeline> は、1 つの<xref:System.Windows.Controls.TextBlock> オブジェクトのアニメーションをカプセル化します。  
+  
+ **パフォーマンスに関するメモ :** <xref:System.Windows.Media.Animation.Storyboard> タイムラインどうしを入れ子にすることもできますが、入れ子にするには、オーバーヘッドの少ない <xref:System.Windows.Media.Animation.ParallelTimeline> の方が適しています   \(<xref:System.Windows.Media.Animation.Storyboard> クラスは <xref:System.Windows.Media.Animation.ParallelTimeline> クラスから継承されます\)。  
+  
+## 使用例  
+ [!code-xml[Timelines_snip#ParallelTimelineWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Timelines_snip/CS/ParallelTimelineExample.xaml#paralleltimelinewholepage)]  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボード アニメーション間で HandoffBehavior を指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-handoffbehavior-between-storyboard-animations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-skew-an-element.md b/docs/framework/wpf/graphics-multimedia/how-to-skew-an-element.md
new file mode 100644
index 00000000000..430a89a8693
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-skew-an-element.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : 要素を傾斜させる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, SkewTransform"
+  - "グラフィックス, 傾斜 (要素を)"
+  - "傾斜 (要素を)"
+  - "SkewTransform クラス"
+ms.assetid: 56b65f2f-dc6e-4238-923f-ca44ec53c52f
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 要素を傾斜させる
+この例では、<xref:System.Windows.Media.SkewTransform> を使用して要素を傾斜させる方法を示します。  [傾斜](GTMT)とは、座標空間を不均等に伸縮させた変形のことで、シアとも呼ばれます。  <xref:System.Windows.Media.SkewTransform> の代表的な用途の 1 つとして、[!INCLUDE[TLA#tla_2d](../../../../includes/tlasharptla-2d-md.md)] オブジェクトでの [!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] 深度のシミュレートが挙げられます。  
+  
+ <xref:System.Windows.Media.SkewTransform.CenterX%2A> プロパティおよび <xref:System.Windows.Media.SkewTransform.CenterY%2A> プロパティを使用して、<xref:System.Windows.Media.SkewTransform> の中心点を指定します。  
+  
+ <xref:System.Windows.Media.SkewTransform.AngleX%2A> プロパティおよび <xref:System.Windows.Media.SkewTransform.AngleY%2A> プロパティを使用して x 軸と y 軸の傾斜角度を指定し、これらの軸に沿って現在の座標系を傾斜させます。  
+  
+ 傾斜変形の結果を予測するには、<xref:System.Windows.Media.SkewTransform.AngleX%2A> によって、x 軸の値が元の座標系に対して相対的に傾斜すると考えます。  つまり、<xref:System.Windows.Media.SkewTransform.AngleX%2A> が 30 の場合、y 軸が原点を中心に 30°回転し、x の値がその原点から 30°傾斜します。  同様に、<xref:System.Windows.Media.SkewTransform.AngleY%2A> を 30 にすると、図形の y 値が原点から 30°傾斜します。  座標系を x 方向または y 方向に 30°変換 \(移動\) した場合とは効果が異なる点に注意してください。  
+  
+ <xref:System.Windows.Shapes.Rectangle> に対して \(0,0\) を中心点とした水平方向 45°の傾斜を適用する例を次に示します。  
+  
+## 使用例  
+ [!code-xml[transformsSample#41](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/SkewTransformExample.xaml#41)]  
+  
+ <xref:System.Windows.Shapes.Rectangle> に対し、\(25,25\) を中心点として水平方向 45°の傾斜を適用する例を次に示します。  
+  
+ [!code-xml[transformsSample#42](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/SkewTransformExample.xaml#42)]  
+  
+ <xref:System.Windows.Shapes.Rectangle> に対し、\(25,25\) を中心点として垂直方向 45°の傾斜を適用する例を次に示します。  
+  
+ [!code-xml[transformsSample#43](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/SkewTransformExample.xaml#43)]  
+  
+ この例で使用されている各種の傾斜を次の図に示します。  
+  
+ ![SkewTransform の例](../../../../docs/framework/wpf/graphics-multimedia/media/img-wcpsdk-graphicsmm-skewtransformexample.png "img\_wcpsdk\_graphicsmm\_skewtransformexample")  
+3 種類の SkewTransform の例を示した図  
+  
+ サンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.SkewTransform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-specify-handoffbehavior-between-storyboard-animations.md b/docs/framework/wpf/graphics-multimedia/how-to-specify-handoffbehavior-between-storyboard-animations.md
new file mode 100644
index 00000000000..de47eb8222f
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-specify-handoffbehavior-between-storyboard-animations.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : ストーリーボード アニメーション間で HandoffBehavior を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, ハンドオフ動作"
+  - "ストーリーボード, アニメーション間のハンドオフ動作"
+ms.assetid: 97bd6842-929b-49d9-813e-46553ae46472
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ストーリーボード アニメーション間で HandoffBehavior を指定する
+この例では、ストーリーボード アニメーション間のハンドオフ動作を指定する方法を示します。  <xref:System.Windows.Media.Animation.BeginStoryboard> の <xref:System.Windows.Media.Animation.BeginStoryboard.HandoffBehavior%2A> プロパティは、新しいアニメーションが、プロパティに既に適用されている既存のアニメーションと対話する方法を指定します。  
+  
+## 使用例  
+ 次の例では、2 つのボタンを作成します。これらのボタンは、マウス カーソルが上に移動すると大きくなり、カーソルが離れると小さくなります。  マウス カーソルをボタンの上に移動した直後にカーソルを離すと、最初のアニメーションが完了する前に 2 番目のアニメーションが適用されます。  2 つのアニメーションがこのようにオーバーラップする状況では、<xref:System.Windows.Media.Animation.BeginStoryboard.HandoffBehavior%2A> の値が <xref:System.Windows.Media.Animation.HandoffBehavior> と <xref:System.Windows.Media.Animation.HandoffBehavior> である場合の違いが明確にわかります。  値が <xref:System.Windows.Media.Animation.HandoffBehavior> の場合は、オーバーラップするアニメーションが合成され、アニメーション間の移行がスムーズになります。一方、値が <xref:System.Windows.Media.Animation.HandoffBehavior> の場合は、オーバーラップされる古いアニメーションが新しいアニメーションに直ちに置換されます。  
+  
+ [!code-xml[timingbehaviors_snip#HandoffBehaviorWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/HandoffBehaviorExample.xaml#handoffbehaviorwholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.BeginStoryboard>   
+ <xref:System.Windows.Media.Animation.BeginStoryboard.HandoffBehavior%2A>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-specify-the-origin-of-a-transform-by-using-relative-values.md b/docs/framework/wpf/graphics-multimedia/how-to-specify-the-origin-of-a-transform-by-using-relative-values.md
new file mode 100644
index 00000000000..80be41a3b92
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-specify-the-origin-of-a-transform-by-using-relative-values.md
@@ -0,0 +1,52 @@
+---
+title: "方法 : 変換の原点を相対値で指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 原点 (変換の)"
+  - "原点 (変換の)"
+  - "変換, 原点"
+ms.assetid: f4dbc29d-93c7-41cd-96d8-5cfd8624b470
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : 変換の原点を相対値で指定する
+この例では、相対値を使用して、<xref:System.Windows.FrameworkElement> に適用する <xref:System.Windows.UIElement.RenderTransform%2A> の原点を指定する方法を示します。  
+  
+ <xref:System.Windows.UIElement.RenderTransform%2A> プロパティを使用して <xref:System.Windows.FrameworkElement> を回転、拡大縮小、または[傾斜](GTMT)させる場合、既定の設定では、要素の左上隅に変換が適用されます。  要素の中心を基準にして回転、拡大縮小、または傾斜させる場合は、変換の中心を要素の中心に設定することで補正できます。  ただし、この方法を使用するには、要素のサイズがわかっている必要があります。  さらに簡単に変換を要素の中心に適用するには、変換自体で中心の値を設定する代わりに、要素の <xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティを \(0.5, 0.5\) に設定します。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を使用して、<xref:System.Windows.Controls.Button> を時計回りに 45°回転します。  この例では中心を指定しないため、ボタンはその左上隅の点 \(0, 0\) を中心として回転します。  <xref:System.Windows.Media.RotateTransform> は、<xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用されます。  
+  
+ この例の変換結果を次の図に示します。  
+  
+ ![RenderTransform を使用して変換されたボタン](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rendertransformwithdefaultcenter.png "graphicsmm\_RenderTransformWithDefaultCenter")  
+RenderTransform プロパティを使用して時計回りに 45°回転  
+  
+ [!code-xml[Transforms_snip#GraphicsMMRotateButtonExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonRotateTransformExample.xaml#graphicsmmrotatebuttonexample1)]  
+  
+ 次の例でも <xref:System.Windows.Media.RotateTransform> を使用して <xref:System.Windows.Controls.Button> を時計回りに 45°回転していますが、この例ではボタンの <xref:System.Windows.UIElement.RenderTransformOrigin%2A> を \(0.5, 0.5\) に設定しています。  その結果、回転はボタンの左上隅ではなく中心に適用されます。  
+  
+ この例の変換結果を次の図に示します。  
+  
+ ![中心の周りで変換されたボタン](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rendertransformrelativecenter.png "graphicsmm\_RenderTransformRelativeCenter")  
+RenderTransformOrigin を \(0.5, 0.5\) に設定した RenderTransform プロパティを使用して時計回りに 45°回転  
+  
+ [!code-xml[Transforms_snip#GraphicsMMRotateButtonExample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonRotateTransformExample.xaml#graphicsmmrotatebuttonexample2)]  
+  
+ <xref:System.Windows.FrameworkElement> オブジェクトの変換の詳細については、「[変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md b/docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md
new file mode 100644
index 00000000000..86a1086a91d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md
@@ -0,0 +1,26 @@
+---
+title: "方法 : タイムラインを自動的に反転するかどうかを指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AutoReverse プロパティ (タイムラインの)"
+  - "タイムライン, AutoReverse プロパティ"
+ms.assetid: 1648dd90-1bee-409a-ac69-ac729867f557
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : タイムラインを自動的に反転するかどうかを指定する
+タイムラインの <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティは、順方向の反復の完了後にタイムラインを逆方向に再生するかどうかを決定します。  期間とターゲット値は同じで <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> の設定が異なるさまざまなアニメーションの例を次に示します。  異なる <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> の設定に対する <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティの動作を示すため、一部のアニメーションは繰り返すように設定されています。  最後のアニメーションでは、入れ子になったタイムラインでの <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティの動作が示されています。  
+  
+## 使用例  
+ [!code-xml[timingbehaviors_snip#AutoReverseAndRepeatBehaviorExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/AutoReverseExample.xaml#autoreverseandrepeatbehaviorexamplewholepage)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-test-point4d-structures-for-equality-and-inequality.md b/docs/framework/wpf/graphics-multimedia/how-to-test-point4d-structures-for-equality-and-inequality.md
new file mode 100644
index 00000000000..92c5b0798ee
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-test-point4d-structures-for-equality-and-inequality.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : Point4D 構造体が等価かどうかをテストする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "等価比較, テスト (Point4D 構造体を)"
+  - "非等価比較, テスト (Point4D 構造体を)"
+  - "Point4D 構造体, テスト (等しいかどうかを)"
+  - "Point4D 構造体, テスト (等しくないかどうかを)"
+  - "テスト, Point4D 構造体が等しいかどうか"
+  - "テスト, Point4D 構造体が等しくないかどうか"
+ms.assetid: e004a67e-db7f-4af8-a31f-e6b2a44ccf34
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Point4D 構造体が等価かどうかをテストする
+この例では、<xref:System.Windows.Media.Media3D.Point4D> 構造体の等価および非等価をテストする方法を示します。  
+  
+ <xref:System.Windows.Media.Media3D.Point4D> 等価性メソッドを使用して <xref:System.Windows.Media.Media3D.Point4D> 構造体の等価および非等価をテストする方法を次のコード例に示します。  <xref:System.Windows.Media.Media3D.Point4D> 構造体は、オーバーロードされた等価 \(`==`\) 演算子を使用して等価かどうかがテストされ、次にオーバーロードされた非等価 \(`!=`\) 演算子を使用して非等価かどうかがテストされます。最後に、静的 <xref:System.Windows.Media.Media3D.Point4D.Equals%2A> メソッドを使用して <xref:System.Windows.Media.Media3D.Point3D> 構造体と <xref:System.Windows.Media.Media3D.Point4D> 構造体が等価かどうかがチェックされます。  
+  
+## 使用例  
+ [!code-csharp[3DGallery_procedural_snip#Point4DEqualityExample_csharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_procedural_snip/CSharp/Misc3DOperationsExample.cs#point4dequalityexample_csharp)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Media3D.Point4D.op_Equality%2A>   
+ <xref:System.Windows.Media.Media3D.Point4D.op_Inequality%2A>   
+ <xref:System.Windows.Media.Media3D.Point4D.Equals%2A>
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-transform-a-brush.md b/docs/framework/wpf/graphics-multimedia/how-to-transform-a-brush.md
new file mode 100644
index 00000000000..3dcc7e17bdb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-transform-a-brush.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : ブラシを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 回転 (コンテンツを)"
+  - "ブラシ, Transform プロパティ"
+  - "回転 (ブラシのコンテンツを)"
+ms.assetid: ebada2f9-f01f-4863-9ea2-c2e4e51610f1
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : ブラシを変換する
+この例では、2 つの変換プロパティ <xref:System.Windows.Media.Brush.RelativeTransform%2A> と <xref:System.Windows.Media.Brush.Transform%2A> を使用して <xref:System.Windows.Media.Brush> オブジェクトを変換する方法を示します。  
+  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を使用して、<xref:System.Windows.Media.ImageBrush> のコンテンツを 45°回転します。  
+  
+ 次の図は、それぞれ、<xref:System.Windows.Media.RotateTransform> を適用していない状態、<xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに適用した状態、および <xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.Brush.Transform%2A> プロパティに適用した状態の <xref:System.Windows.Media.ImageBrush> を示しています。  
+  
+ ![ブラシ RelativeTransform と変換の設定](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-transformandrelativetransform.png "wcpsdk\_graphicsmm\_transformandrelativetransform")  
+  
+## 使用例  
+ 最初の例では、<xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティに適用しています。  <xref:System.Windows.Media.RotateTransform> オブジェクトの <xref:System.Windows.Media.RotateTransform.CenterX%2A> プロパティおよび <xref:System.Windows.Media.RotateTransform.CenterY%2A> プロパティは、コンテンツの中心点の相対座標である 0.5 に設定されています。  その結果、<xref:System.Windows.Media.ImageBrush> のコンテンツはその中心を軸にして回転します。  
+  
+ [!code-csharp[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTransformExample.cs#imagebrushrelativetransformexample)]
+ [!code-vb[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtransformexample.vb#imagebrushrelativetransformexample)]
+ [!code-xml[BrushesIntroduction_snip#ImageBrushRelativeTransformExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTransformExample.xaml#imagebrushrelativetransformexample)]  
+  
+ 2 番目の例でも、<xref:System.Windows.Media.RotateTransform> を <xref:System.Windows.Media.ImageBrush> に適用していますが、<xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティの代わりに <xref:System.Windows.Media.Brush.Transform%2A> プロパティを使用しています。  
+  
+ ブラシをその中心を軸に回転するために、<xref:System.Windows.Media.RotateTransform> オブジェクトの <xref:System.Windows.Media.RotateTransform.CenterX%2A> プロパティおよび <xref:System.Windows.Media.RotateTransform.CenterY%2A> プロパティを絶対座標に設定しています。  このブラシは 175 × 90 [ピクセル](GTMT)の四角形を塗りつぶすため、四角形の中心点は \(87.5, 45\) になります。  
+  
+ [!code-csharp[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTransformExample.cs#imagebrushtransformexample)]
+ [!code-vb[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtransformexample.vb#imagebrushtransformexample)]
+ [!code-xml[BrushesIntroduction_snip#ImageBrushTransformExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTransformExample.xaml#imagebrushtransformexample)]  
+  
+ <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティと <xref:System.Windows.Media.Brush.Transform%2A> プロパティの機能の詳細については、「[ブラシの変換の概要](../../../../docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md)」を参照してください。  
+  
+ サンプル全体については、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  ブラシの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  
+  
+## 参照  
+ [ブラシの変換の概要](../../../../docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-transform-points-and-vectors.md b/docs/framework/wpf/graphics-multimedia/how-to-transform-points-and-vectors.md
new file mode 100644
index 00000000000..659a613a41c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-transform-points-and-vectors.md
@@ -0,0 +1,30 @@
+---
+title: "方法 : 点およびベクターを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 変換 (Point オブジェクトを)"
+  - "グラフィックス, 変換 (Vector オブジェクトを)"
+  - "Point オブジェクト, 変換"
+  - "変換 (Point オブジェクトを)"
+  - "変換 (Vector オブジェクトを)"
+  - "Vector オブジェクト, 変換"
+ms.assetid: 9fff2742-9162-46be-bc88-310fc3900af4
+caps.latest.revision: 4
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 方法 : 点およびベクターを変換する
+この例では、<xref:System.Windows.Media.Matrix> を使用して <xref:System.Windows.Point> オブジェクトおよび <xref:System.Windows.Vector> オブジェクトを変換する方法を説明します。  
+  
+## 使用例  
+ [!code-csharp[MatrixExamples_snip#MatrixTransformExamples_csharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MatrixExamples_snip/CSharp/MatrixExample.cs#matrixtransformexamples_csharp)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-transform-the-scale-of-a-3-d-model.md b/docs/framework/wpf/graphics-multimedia/how-to-transform-the-scale-of-a-3-d-model.md
new file mode 100644
index 00000000000..9163d53a52a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-transform-the-scale-of-a-3-d-model.md
@@ -0,0 +1,35 @@
+---
+title: "方法 : 3-D モデルのスケールを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D オブジェクト, スケーリング"
+  - "スケーリング, 3-D オブジェクト"
+ms.assetid: f3fdfe33-f7dc-44b0-84a5-e43b89947f35
+caps.latest.revision: 3
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 方法 : 3-D モデルのスケールを変換する
+この例では、3\-D オブジェクトをスケーリングする方法を示します。  3\-D オブジェクトをスケーリングするには、<xref:System.Windows.Media.Media3D.ScaleTransform3D> を使用します。  <xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleX%2A>、<xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleY%2A>、および <xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleZ%2A> プロパティは、指定するファクターごとに要素のサイズを変更します。  たとえば、<xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleX%2A> の値が 1.5 である場合、オブジェクトは元の幅の 150% に引き伸ばされます。  <xref:System.Windows.Media.Media3D.ScaleTransform3D.ScaleY%2A> の値が 0.5 である場合、オブジェクトの高さは 50% 縮められます。  次のコードでは、<xref:System.Windows.Media.Media3D.GeometryModel3D> の変換として <xref:System.Windows.Media.Media3D.ScaleTransform3D> を使用する方法を示します。  
+  
+ [!code-xml[3DGallery_snip#ScaleTransform3DExampleInline1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/ScaleTransform3DExample.xaml#scaletransform3dexampleinline1)]  
+  
+## 使用例  
+ サンプル全体を次のコードに示します。  
+  
+ [!code-xml[3DGallery_snip#ScaleTransform3DExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/3DGallery_snip/CS/ScaleTransform3DExample.xaml#scaletransform3dexamplewholepage)]  
+  
+## 参照  
+ [3\-D 変換をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-3-d-translations.md)   
+ [3\-D シーンを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-3-d-scene.md)   
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-translate-an-element.md b/docs/framework/wpf/graphics-multimedia/how-to-translate-an-element.md
new file mode 100644
index 00000000000..cd9bbbd3733
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-translate-an-element.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 要素を変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, TranslateTransform"
+  - "グラフィックス, 変換"
+  - "TranslateTransform クラス"
+ms.assetid: 461c8273-15df-42f6-8672-89ba22887cc0
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 要素を変換する
+この例では、<xref:System.Windows.Media.TranslateTransform> を使用して要素を変換 \(移動\) する方法を示します。  
+  
+ <xref:System.Windows.Media.TranslateTransform> クラスは、絶対配置をサポートしないパネルの内部で要素を移動する場合に特に便利です。  たとえば、要素の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.TranslateTransform> を適用することで、<xref:System.Windows.Controls.StackPanel> または <xref:System.Windows.Controls.DockPanel> 内で要素を移動できます。  
+  
+ x 軸方向の要素の移動量 \([ピクセル](GTMT)単位\) を指定するには、<xref:System.Windows.Media.TranslateTransform> の <xref:System.Windows.Media.TranslateTransform.X%2A> プロパティを使用します。  y 軸方向の要素の移動量 \(ピクセル単位\) を指定するには、<xref:System.Windows.Media.TranslateTransform.Y%2A> プロパティを使用します。  最後に、要素の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに <xref:System.Windows.Media.TranslateTransform> を適用します。  
+  
+ 次の例では、<xref:System.Windows.Media.TranslateTransform> を使用して、要素を右に 50 [ピクセル](GTMT)、下に 50 ピクセル移動します。  
+  
+## 使用例  
+ [!code-xml[transformsSample#53](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/TranslateTransformExample.xaml#53)]  
+  
+ サンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  
+  
+## 参照  
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md b/docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md
new file mode 100644
index 00000000000..d8cd5964e57
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md
@@ -0,0 +1,36 @@
+---
+title: "方法 : プロパティ値が変化したときにアニメーションをトリガーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 開始 (プロパティ値が変化したときに)"
+  - "ストーリーボード, 開始 (プロパティ値が変化したときに)"
+  - "トリガー (アニメーションを)"
+ms.assetid: 12399c21-0300-4f4f-9e3a-d92d9907e5f5
+caps.latest.revision: 7
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : プロパティ値が変化したときにアニメーションをトリガーする
+この例では、<xref:System.Windows.Trigger> を使用して、プロパティ値が変更されたときに <xref:System.Windows.Media.Animation.Storyboard> を開始する方法を示します。  <xref:System.Windows.Trigger> は、<xref:System.Windows.Style>、<xref:System.Windows.Controls.ControlTemplate>、または <xref:System.Windows.DataTemplate> の内部で使用できます。  
+  
+## 使用例  
+ 次の例では、<xref:System.Windows.Trigger> を使用して、<xref:System.Windows.Controls.Button> の <xref:System.Windows.UIElement.IsMouseOver%2A> プロパティが `true` になったときに、その <xref:System.Windows.UIElement.Opacity%2A> をアニメーション化します。  
+  
+ [!code-xml[AnimatePropertyStoryboards#PropertyTriggerExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/AnimatePropertyStoryboards/XAML/PropertyTriggerExample.xaml#propertytriggerexample)]  
+  
+ プロパティの <xref:System.Windows.Trigger> オブジェクトによって適用されるアニメーションの動作は、<xref:System.Windows.EventTrigger> アニメーション、または <xref:System.Windows.Media.Animation.Storyboard> メソッドを使用して開始されるアニメーションより複雑です。  他の <xref:System.Windows.Trigger> オブジェクトによって定義されるアニメーションで "ハンドオフ" しますが、<xref:System.Windows.EventTrigger> およびメソッドでトリガーされるアニメーションで構成されます。  
+  
+## 参照  
+ <xref:System.Windows.Trigger>   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-trigger-media-playback-with-a-user-event.md b/docs/framework/wpf/graphics-multimedia/how-to-trigger-media-playback-with-a-user-event.md
new file mode 100644
index 00000000000..db26bf33bbe
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-trigger-media-playback-with-a-user-event.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : ユーザー イベントによってメディアの再生をトリガーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "同期 (イベントとメディアの再生を)"
+  - "イベントと同期するメディアの再生"
+  - "イベントと再生を同期するメディア"
+  - "イベントによってマルチ メディア、同期中のメディアの再生"
+ms.assetid: c4dbe632-6e7f-4d7f-9df5-98737a758bc3
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : ユーザー イベントによってメディアの再生をトリガーする
+この例では、イベントとメディアの再生を同期する方法を示します。  
+  
+## <a name="example"></a>例  
+ 次の例で、 <xref:System.Windows.Controls.MediaElement>コントロールと<xref:System.Windows.Media.MediaTimeline> 、ユーザーがクリックしたときに発生するサウンドを再生するクラス、<xref:System.Windows.Controls.Button>します。  
+  
+ [!code-xml[MediaGallery_snippet#SoundFromUserEventExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaGallery_snippet/CSharp/SoundFromUserEventExample.xaml#soundfromusereventexamplewholepage)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Controls.MediaElement>   
+ <xref:System.Windows.Media.MediaTimeline>   
+ <xref:System.Windows.EventTrigger.RoutedEvent%2A>   
+ <xref:System.Windows.Media.Animation.Storyboard>   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md)   
+ [グラフィックスとマルチ メディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-a-bitmapimage.md b/docs/framework/wpf/graphics-multimedia/how-to-use-a-bitmapimage.md
new file mode 100644
index 00000000000..ad664a4d938
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-a-bitmapimage.md
@@ -0,0 +1,33 @@
+---
+title: "方法: BitmapImage を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ イメージ"
+  - "BitmapImage クラス"
+  - "XAML, BitmapImage の使用"
+ms.assetid: 5a5733aa-396d-4d72-b0c3-77f8c25d9a42
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法: BitmapImage を使用する
+この例では、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] の <xref:System.Windows.Controls.Image> コントロールのソースとして <xref:System.Windows.Media.Imaging.BitmapImage> を使用する方法を示します。  
+  
+## 使用例  
+ [!code-xml[ImageElementExample_snip#ImageSimpleExampleInlineMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml#imagesimpleexampleinlinemarkup)]  
+  
+ [!code-csharp[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml.cs#imagesimpleexampleinlinecode1)]
+ [!code-vb[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/ImageSimpleExample.xaml.vb#imagesimpleexampleinlinecode1)]  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-a-cached-element-as-a-brush.md b/docs/framework/wpf/graphics-multimedia/how-to-use-a-cached-element-as-a-brush.md
new file mode 100644
index 00000000000..8caaab97c58
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-a-cached-element-as-a-brush.md
@@ -0,0 +1,36 @@
+---
+title: "方法: キャッシュされた要素をブラシとして使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BitmapCache [WPF], 使用"
+  - "BitmapCacheBrush [WPF], 使用"
+  - "キャッシュした要素 [WPF], ブラシとして使用"
+  - "CacheMode [WPF], 使用"
+ms.assetid: d36e944a-866e-4baf-98c4-fd6a75f6fdd0
+caps.latest.revision: 5
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: キャッシュされた要素をブラシとして使用する
+キャッシュされた要素を効率的に再利用するには、<xref:System.Windows.Media.BitmapCacheBrush> クラスを使用します。  要素をキャッシュするには、<xref:System.Windows.Media.BitmapCache> クラスの新しいインスタンスを作成し、そのインスタンスを要素の <xref:System.Windows.UIElement.CacheMode%2A> プロパティに割り当てます。  
+  
+## 使用例  
+ キャッシュされた要素を再利用する方法を次のコード例に示します。  キャッシュされた要素は、大きいイメージを表示する <xref:System.Windows.Controls.Image> コントロールです。  <xref:System.Windows.Controls.Image> コントロールは、<xref:System.Windows.Media.BitmapCache> クラスを使用してビットマップとしてキャッシュされます。これを <xref:System.Windows.Media.BitmapCacheBrush> に割り当てることで、キャッシュが再利用されます。  効率的な再利用を示すために、ブラシは 25 個のボタンの背景に割り当てられます。  
+  
+ [!code-xml[System.Windows.Media.BitmapCacheBrush#_BitmapCacheBrushXAML](../../../../samples/snippets/csharp/VS_Snippets_Wpf/system.windows.media.bitmapcachebrush/cs/window1.xaml#_bitmapcachebrushxaml)]  
+  
+## 参照  
+ <xref:System.Windows.Media.BitmapCache>   
+ <xref:System.Windows.Media.BitmapCacheBrush>   
+ <xref:System.Windows.UIElement.CacheMode%2A>   
+ [方法: 要素をキャッシュしてレンダリングのパフォーマンスを向上させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-improve-rendering-performance-by-caching-an-element.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-a-drawing-as-an-image-source.md b/docs/framework/wpf/graphics-multimedia/how-to-use-a-drawing-as-an-image-source.md
new file mode 100644
index 00000000000..e2a7ff209bb
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-a-drawing-as-an-image-source.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : 描画をイメージ ソースとして使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "描画, イメージ ソース"
+  - "グラフィックス, 描画, イメージ ソース"
+  - "イメージ ソース, 描画"
+ms.assetid: dcf71c7b-9e86-4b8e-8e39-0d0ce0389ef4
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 描画をイメージ ソースとして使用する
+この例では、<xref:System.Windows.Media.Drawing> を <xref:System.Windows.Controls.Image> コントロールの <xref:System.Windows.Controls.Image.Source%2A> として使用する方法を示します。  <xref:System.Windows.Controls.Image> コントロールを使用して <xref:System.Windows.Media.Drawing> を表示するには、<xref:System.Windows.Media.DrawingImage> を <xref:System.Windows.Controls.Image> コントロールの <xref:System.Windows.Controls.Image.Source%2A> として使用し、<xref:System.Windows.Media.DrawingImage> オブジェクトの <xref:System.Windows.Media.DrawingImage.Drawing%2A?displayProperty=fullName> プロパティを表示する描画に設定します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.DrawingImage> および <xref:System.Windows.Controls.Image> コントロールを使用して、<xref:System.Windows.Media.GeometryDrawing> を表示する例を次に示します。  この例を実行すると、次の出力が生成されます。  
+  
+ ![2 つの楕円の GeometryDrawing](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-geodraw.png "graphicsmm\_geodraw")  
+DrawingImage  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#DrawingImageExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/DrawingImageExample.cs#drawingimageexamplewholepage)]
+ [!code-xml[DrawingMiscSnippets_snip#DrawingImageExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/DrawingMiscSnippets_snip/XAML/DrawingImageExample.xaml#drawingimageexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.Freezable.Freeze%2A>   
+ [ImageDrawing を使用してイメージを描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-an-image-using-imagedrawing.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [PresentationOptions:Freeze 属性](../../../../docs/framework/wpf/advanced/presentationoptions-freeze-attribute.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-a-matrixtransform-to-create-custom-transforms.md b/docs/framework/wpf/graphics-multimedia/how-to-use-a-matrixtransform-to-create-custom-transforms.md
new file mode 100644
index 00000000000..b33a6c6a1d5
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-a-matrixtransform-to-create-custom-transforms.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : MatrixTransform を使用してカスタム変換を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クラス, MatrixTransform"
+  - "グラフィックス [WPF], カスタム変換"
+  - "MatrixTransform クラス"
+ms.assetid: 919381ca-989f-47cf-86b4-1094060236e4
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : MatrixTransform を使用してカスタム変換を作成する
+この例では、<xref:System.Windows.Media.MatrixTransform> を使用して、<xref:System.Windows.Controls.Button> の位置、伸縮、および[傾斜](GTMT)を変換 \(移動\) する方法を示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.RotateTransform>、<xref:System.Windows.Media.SkewTransform>、<xref:System.Windows.Media.ScaleTransform>、または <xref:System.Windows.Media.TranslateTransform> の各クラスでは提供されないカスタム変換を作成するには、<xref:System.Windows.Media.MatrixTransform> クラスを使用します。  
+  
+## 使用例  
+ [!code-xml[Transforms_snip#MatrixTransform](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/MatrixTransformExample.xaml#matrixtransform)]  
+  
+## 参照  
+ <xref:System.Windows.Media.MatrixTransform>   
+ <xref:System.Windows.Media.Transform>   
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md b/docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md
new file mode 100644
index 00000000000..706e1e13eed
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-event-triggers-to-control-a-storyboard-after-it-starts.md
@@ -0,0 +1,58 @@
+---
+title: "方法 : 開始後のストーリーボードをイベント トリガーを使用して制御する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント トリガー, 制御 (ストーリーボードを)"
+  - "ストーリーボード, 制御 (起動後に)"
+  - "トリガー, 制御 (ストーリーボードを)"
+ms.assetid: 3b115594-6a93-4972-b24d-61aa16f1c15f
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 開始後のストーリーボードをイベント トリガーを使用して制御する
+この例では、<xref:System.Windows.Media.Animation.Storyboard> が開始した後でそれを制御する方法を示します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] を使用して <xref:System.Windows.Media.Animation.Storyboard> を開始するには、<xref:System.Windows.Media.Animation.BeginStoryboard> を使用します。これにより、アニメーション化されるオブジェクトとプロパティにアニメーションが配布され、ストーリーボードが開始されます。  <xref:System.Windows.Media.Animation.BeginStoryboard> は、<xref:System.Windows.Media.Animation.BeginStoryboard.Name%2A> プロパティを指定することによって名前を設定すると、制御可能なストーリーボードになります。  ストーリーボードは、開始されると対話的に制御できます。  
+  
+ ストーリーボードを制御するには、以下のストーリーボード アクションを <xref:System.Windows.EventTrigger> オブジェクトと共に使用します。  
+  
+-   <xref:System.Windows.Media.Animation.PauseStoryboard>: ストーリーボードを一時停止します。  
+  
+-   <xref:System.Windows.Media.Animation.ResumeStoryboard>: 一時停止されたストーリーボードを再開します。  
+  
+-   <xref:System.Windows.Media.Animation.SetStoryboardSpeedRatio>: ストーリーボードの速度を変更します。  
+  
+-   <xref:System.Windows.Media.Animation.SkipStoryboardToFill>: ストーリーボードがある場合は、それを区間の最後に進めます。  
+  
+-   <xref:System.Windows.Media.Animation.StopStoryboard>: ストーリーボードを停止します。  
+  
+-   <xref:System.Windows.Media.Animation.RemoveStoryboard>: ストーリーボードを削除して、リソースを解放します。  
+  
+## 使用例  
+ 次の例では、制御可能なストーリーボード アクションを使用して、ストーリーボードを対話的に制御しています。  
+  
+ **メモ :** コードを使用してストーリーボードを制御する例については、「[対話型メソッドを使用してストーリーボードを開始後に制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md)」を参照してください。  
+  
+ [!code-xml[timingbehaviors_snip#ControlStoryboardExampleUsingWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/ControlStoryboardExample.xaml#controlstoryboardexampleusingwholepage)]  
+  
+ その他の例については、[アニメーション サンプル ギャラリー](http://go.microsoft.com/fwlink/?LinkID=159969)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.ResumeStoryboard>   
+ <xref:System.Windows.Media.Animation.SetStoryboardSpeedRatio>   
+ <xref:System.Windows.Media.Animation.SkipStoryboardToFill>   
+ <xref:System.Windows.Media.Animation.PauseStoryboard>   
+ <xref:System.Windows.Media.Animation.StopStoryboard>   
+ <xref:System.Windows.Media.Animation.SeekStoryboard>   
+ [対話型メソッドを使用してストーリーボードを開始後に制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-storyboard-after-it-starts.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md b/docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md
new file mode 100644
index 00000000000..590add5863e
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-system-colors-in-a-gradient.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : グラデーションでシステム カラーを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラデーション, システム カラー"
+  - "システム カラー (グラデーション)"
+ms.assetid: 11942e7e-6300-4b50-8ed1-f50e8d20e7d2
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : グラデーションでシステム カラーを使用する
+グラデーションでシステム カラーを使用するには、<xref:System.Windows.SystemColors> クラスの静的プロパティ *\<SystemColor\>*Color と *\<SystemColor\>*ColorKey を使用して、色に対する参照を取得します。*\<SystemColor\>* は、目的のシステム カラーの名前です。  システム テーマが変更されると自動的に更新される動的な参照を作成するには、*\<SystemColor\>*ColorKey プロパティを使用します。  それ以外の場合は、*\<SystemColor\>*Color プロパティを使用します。  
+  
+## 使用例  
+ 次の例では、動的なシステム カラー リソースを使用してグラデーションを作成します。  
+  
+ [!code-xml[brushsamples_snip#GraphicsMMDynamicSystemColorGradientExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/DynamicSystemColorExample.xaml#graphicsmmdynamicsystemcolorgradientexamplewholepage)]  
+  
+ 次の例では、静的なシステム カラー リソースを使用してグラデーションを作成します。  
+  
+ [!code-xml[brushsamples_snip#GraphicsMMStaticSystemColorGradientExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/brushsamples_snip/CS/StaticSystemColorExample.xaml#graphicsmmstaticsystemcolorgradientexamplewholepage)]  
+  
+## 参照  
+ <xref:System.Windows.SystemColors>   
+ [システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-use-transforms-on-a-mediaelement.md b/docs/framework/wpf/graphics-multimedia/how-to-use-transforms-on-a-mediaelement.md
new file mode 100644
index 00000000000..342287731a6
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-use-transforms-on-a-mediaelement.md
@@ -0,0 +1,29 @@
+---
+title: "方法 : MediaElement で変換を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Mediaelement で変換します。"
+  - "マルチ メディア、Mediaelement で変換を使用します。"
+  - "Mediaelement で変換を使用します。"
+ms.assetid: d89c95e3-27c5-4748-8a27-72e432674032
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : MediaElement で変換を使用する
+この例では、使用して、 <xref:System.Windows.Media.RotateTransform>上、 <xref:System.Windows.Controls.MediaElement>します。  
+  
+## <a name="example"></a>例  
+ 次に示すマークアップ、 <xref:System.Windows.Controls.MediaElement>を使用して、回転、 <xref:System.Windows.Media.RotateTransform>します。  
+  
+ [!code-xml[MediaElement_snippet#MediaElementRotateTransform](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaElement_snippet/CSharp/TransformExample.xaml#mediaelementrotatetransform)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/how-to-write-metadata-to-a-bitmap.md b/docs/framework/wpf/graphics-multimedia/how-to-write-metadata-to-a-bitmap.md
new file mode 100644
index 00000000000..4bf37f7276a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/how-to-write-metadata-to-a-bitmap.md
@@ -0,0 +1,30 @@
+---
+title: "方法 : ビットマップにメタデータを書き込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ビットマップ, 書き込み (メタデータを)"
+  - "イメージ メタデータ"
+  - "メタデータ, イメージ"
+  - "メタデータ, 書き込み (ビットマップに)"
+ms.assetid: 68f0dc4b-c0fe-43be-94f2-9d7399378fb3
+caps.latest.revision: 6
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : ビットマップにメタデータを書き込む
+メタデータ照会言語を使用してビットマップにメタデータを書き込む方法を次の例に示します。  
+  
+## 使用例  
+ [!code-cpp[BitmapMetadata#SetQuery](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BitMapMetadata/CPP/BitmapMetadata.cpp#setquery)]
+ [!code-csharp[BitmapMetadata#SetQuery](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BitMapMetadata/CSharp/BitmapMetadata.cs#setquery)]
+ [!code-vb[BitmapMetadata#SetQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BitMapMetadata/VB/BitmapMetadata.vb#setquery)]
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/images.md b/docs/framework/wpf/graphics-multimedia/images.md
new file mode 100644
index 00000000000..1c655233208
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/images.md
@@ -0,0 +1,42 @@
+---
+title: "イメージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グラフィックス, イメージ"
+  - "イメージ"
+  - "イメージング API"
+  - "WPF アプリケーション, イメージ"
+ms.assetid: 2fe21d59-b444-4786-b68d-35d94e18ce0d
+caps.latest.revision: 83
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 82
+---
+# イメージ
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、複数のイメージ形式、忠実性の高いイメージ レンダリング、および[コーデック](GTMT)拡張機能の組み込みサポートを提供します。  
+  
+## このセクションの内容  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Image>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapImage>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapSource>  
+  
+## 参照  
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md
new file mode 100644
index 00000000000..fe589d008ea
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/imaging-how-to-topics.md
@@ -0,0 +1,54 @@
+---
+title: "イメージングに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "イメージ, 方法トピック"
+  - "イメージング API"
+ms.assetid: 96834ee4-a5fc-4dd0-9948-b9bbc9437a5c
+caps.latest.revision: 79
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 79
+---
+# イメージングに関する「方法」トピック
+このセクションのトピックでは、ビットマップ イメージを表示または変更するために [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] を使用する方法について説明します。  
+  
+## このセクションの内容  
+ [XAML で BitmapImage を使用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-bitmapimage.md)  
+ [サムネイルとしてイメージを読み込む](../../../../docs/framework/wpf/graphics-multimedia/how-to-load-an-image-as-a-thumbnail.md)  
+ [BitmapImage に変換を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-a-bitmapimage.md)  
+ [ビジュアルからビットマップを作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-bitmap-from-a-visual.md)  
+ [ビジュアルをイメージ ファイルにエンコードする](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-a-visual-to-an-image-file.md)  
+ [新しい BitmapSource を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-new-bitmapsource.md)  
+ [BitmapSource オブジェクトをチェーンする](../../../../docs/framework/wpf/graphics-multimedia/how-to-chain-bitmapsource-objects-together.md)  
+ [BitmapSource を別の PixelFormat に変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-a-different-pixelformat.md)  
+ [BitmapSource をインデックス付きピクセル形式に変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-convert-a-bitmapsource-to-an-indexed-pixel-format.md)  
+ [JPEG イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-jpeg-image.md)  
+ [BMP イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-bmp-image.md)  
+ [PNG イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-png-image.md)  
+ [WDP イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-wdp-image.md)  
+ [GIF イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-gif-image.md)  
+ [TIFF イメージのエンコードおよびデコード](../../../../docs/framework/wpf/graphics-multimedia/how-to-encode-and-decode-a-tiff-image.md)  
+ [ビットマップにメタデータを書き込む](../../../../docs/framework/wpf/graphics-multimedia/how-to-write-metadata-to-a-bitmap.md)  
+ [ビットマップからメタデータを読み取る](../../../../docs/framework/wpf/graphics-multimedia/how-to-read-metadata-from-a-bitmap.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Controls.Image>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapImage>  
+  
+ <xref:System.Windows.Media.Imaging.BitmapSource>  
+  
+## 参照  
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/imaging-overview.md b/docs/framework/wpf/graphics-multimedia/imaging-overview.md
new file mode 100644
index 00000000000..f64ca409a5c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/imaging-overview.md
@@ -0,0 +1,202 @@
+---
+title: "イメージングの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変換 (イメージを)"
+  - "トリミング (イメージを)"
+  - "デコード (イメージ形式を)"
+  - "表示 (イメージを)"
+  - "エンコード (イメージ形式を)"
+  - "形式のデコード (イメージ)"
+  - "形式のエンコード (イメージ)"
+  - "イメージ メタデータ"
+  - "イメージ, イメージングの概要"
+  - "イメージング API"
+  - "メタデータ, イメージ"
+  - "イメージによる塗りつぶし"
+  - "回転 (イメージを)"
+  - "引き伸ばし (イメージの)"
+ms.assetid: 72aad87a-e6f3-4937-94cd-a18b7766e990
+caps.latest.revision: 32
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# イメージングの概要
+ここでは、[!INCLUDE[TLA#tla_wic](../../../../includes/tlasharptla-wic-md.md)]の概要を説明します。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]を使用すると、イメージの表示、変換、および書式設定を行うことができます。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="_wpfImaging"></a>   
+## WPF イメージング コンポーネント  
+ [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]では、[!INCLUDE[TLA#tla_win](../../../../includes/tlasharptla-win-md.md)] 内のイメージング機能が大幅に強化されています。  ビットマップの表示や一般的なコントロール上でのイメージの使用などのイメージング機能は、以前は [!INCLUDE[TLA#tla_gdi](../../../../includes/tlasharptla-gdi-md.md)] または [!INCLUDE[TLA#tla_gdiplus](../../../../includes/tlasharptla-gdiplus-md.md)] ライブラリに依存していました。  これらの [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] では、基本的なイメージング機能は提供されていますが、コーデック拡張機能のサポートや忠実性の高いイメージのサポートなどの機能は含まれていません。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]は、[!INCLUDE[TLA2#tla_gdi](../../../../includes/tla2sharptla-gdi-md.md)] および [!INCLUDE[TLA2#tla_gdiplus](../../../../includes/tla2sharptla-gdiplus-md.md)] の欠点を克服し、アプリケーション内でイメージを表示および使用するための新しい [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] のセットを提供するために設計されています。  
+  
+ [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]の [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)]、マネージ コンポーネント、およびアンマネージ コンポーネントにアクセスするには、2 つの方法があります。  アンマネージ コンポーネントは、次の機能を提供します。  
+  
+-   新しいイメージ形式または専用のイメージ形式の拡張モデル。  
+  
+-   [!INCLUDE[TLA#tla_bmp](../../../../includes/tlasharptla-bmp-md.md)]、[!INCLUDE[TLA#tla_jpegorg](../../../../includes/tlasharptla-jpegorg-md.md)]、[!INCLUDE[TLA#tla_png](../../../../includes/tlasharptla-png-md.md)]、[!INCLUDE[TLA#tla_tiff](../../../../includes/tlasharptla-tiff-md.md)]、[!INCLUDE[TLA#tla_wdp](../../../../includes/tlasharptla-wdp-md.md)]、[!INCLUDE[TLA#tla_gif](../../../../includes/tlasharptla-gif-md.md)]、アイコン \(.ico\) などのネイティブ イメージ形式に対するパフォーマンスとセキュリティの向上。  
+  
+-   1 チャネルあたり 8 ビット \(1 ピクセルあたり 32 ビット\) までの高いビット深度のイメージ データの保存。  
+  
+-   非破壊のイメージ スケーリング、トリミング、および回転。  
+  
+-   簡略化された色の管理。  
+  
+-   ファイル内の専用のメタデータのサポート。  
+  
+-   マネージ コンポーネントでは、アンマネージ インフラストラクチャを利用して、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)]、アニメーション、グラフィックスなどのその他の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の機能とイメージとのシームレスな統合を提供します。  マネージ コンポーネントには、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーション内の新しいイメージ形式の自動認識を可能にする、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] のイメージング コーデック拡張モデルによる利点もあります。  
+  
+ [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]のマネージ [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の大部分は <xref:System.Windows.Media.Imaging?displayProperty=fullName> 名前空間にありますが、<xref:System.Windows.Media.ImageBrush> や <xref:System.Windows.Media.ImageDrawing> などのいくつかの重要な種類は <xref:System.Windows.Media?displayProperty=fullName> 名前空間にあり、<xref:System.Windows.Controls.Image> は <xref:System.Windows.Controls?displayProperty=fullName> 名前空間にあります。  
+  
+ ここでは、マネージ コンポーネントに関する追加情報を提供します。  アンマネージ [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] の詳細については、「[Unmanaged WPF Imaging Component](_wic_lh)」を参照してください。  
+  
+<a name="_imageformats"></a>   
+## WPF イメージ形式  
+ コーデックは特定のメディア形式をデコードまたはエンコードするために使用されます。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)] には、[!INCLUDE[TLA2#tla_bmp](../../../../includes/tla2sharptla-bmp-md.md)]、[!INCLUDE[TLA2#tla_jpeg](../../../../includes/tla2sharptla-jpeg-md.md)]、[!INCLUDE[TLA2#tla_png](../../../../includes/tla2sharptla-png-md.md)]、[!INCLUDE[TLA2#tla_tiff](../../../../includes/tla2sharptla-tiff-md.md)]、[!INCLUDE[TLA2#tla_wdp](../../../../includes/tla2sharptla-wdp-md.md)]、[!INCLUDE[TLA2#tla_gif](../../../../includes/tla2sharptla-gif-md.md)]、および ICON のイメージ形式のコーデックが含まれます。  これらのコーデックにより、アプリケーションでは、それぞれのイメージ形式のデコードと、ICON を除く各イメージ形式のエンコードを実行できるようになります。  
+  
+ <xref:System.Windows.Media.Imaging.BitmapSource> はイメージのデコードとエンコードに使用される重要なクラスです。  これは [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)] パイプラインの基本的なビルド ブロックであり、単一の一定なピクセル セットを特定のサイズおよび解像度で表します。  <xref:System.Windows.Media.Imaging.BitmapSource> は複数のフレーム イメージの個別のフレームとしたり、<xref:System.Windows.Media.Imaging.BitmapSource> で実行される変換の結果にしたりできます。  これは <xref:System.Windows.Media.Imaging.BitmapFrame> などの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] イメージングで使用される主なクラスの多くの親です。  
+  
+ <xref:System.Windows.Media.Imaging.BitmapFrame> は、イメージ形式の実際のビットマップ データを格納するために使用されます。  [!INCLUDE[TLA2#tla_gif](../../../../includes/tla2sharptla-gif-md.md)] や [!INCLUDE[TLA2#tla_tiff](../../../../includes/tla2sharptla-tiff-md.md)] などの形式は 1 イメージあたり複数のフレームをサポートしますが、多くのイメージ形式は単一の <xref:System.Windows.Media.Imaging.BitmapFrame> のみをサポートします。  フレームは、デコーダーによって入力データとして使用され、イメージ ファイルを作成するためにエンコーダーに渡されます。  
+  
+ <xref:System.Windows.Media.Imaging.BitmapFrame> がどのように <xref:System.Windows.Media.Imaging.BitmapSource> から作成され、[!INCLUDE[TLA2#tla_tiff](../../../../includes/tla2sharptla-tiff-md.md)] イメージに追加されるかを次の例に示します。  
+  
+ [!code-csharp[BitmapFrameExample#10](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BitmapFrameExample/CSharp/BitmapFrame.cs#10)]
+ [!code-vb[BitmapFrameExample#10](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BitmapFrameExample/VB/BitmapFrame.vb#10)]  
+  
+### イメージ形式のデコード  
+ イメージ デコードとは、イメージ形式をシステムで使用できるイメージ データに変換することです。  その後、イメージ データは、表示、処理、または別の形式にエンコードするために使用できます。  デコーダーは、イメージ形式に基づいて選択されます。  特定のデコーダーが指定されない限り、コーデックの選択は自動的に行われます。  「[WPF でのイメージの表示](#_displayingimages)」セクションで、自動デコードの例を示します。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]の アンマネージ インターフェイスを使用して開発され、システムに登録されたカスタム形式デコーダーは、自動的にデコーダーの選択に追加されます。  これによって、カスタム形式を自動的に [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションで表示できるようになります。  
+  
+ ビットマップ デコータを使用して [!INCLUDE[TLA2#tla_bmp](../../../../includes/tla2sharptla-bmp-md.md)] 形式のイメージをデコードする例を次に示します。  
+  
+ [!code-cpp[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CPP/anotherfile.cpp#5)]
+ [!code-csharp[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CSharp/BitmapFrame.cs#5)]
+ [!code-vb[BmpBitmapDecoderEncoder#5](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/VB/BitmapFrame.vb#5)]  
+  
+### イメージ形式のエンコード  
+ イメージ エンコードとは、イメージ データを特定のイメージ形式に変換することです。  その後、エンコードされたイメージ データは、新しいイメージ ファイルを作成するために使用できます。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]は、前に説明したイメージ形式のそれぞれに対するエンコーダーを提供します。  
+  
+ エンコーダーを使用して新しく作成されるビットマップ イメージを保存する例を次に示します。  
+  
+ [!code-cpp[BmpBitmapDecoderEncoder#3](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CPP/anotherfile.cpp#3)]
+ [!code-csharp[BmpBitmapDecoderEncoder#3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/CSharp/BitmapFrame.cs#3)]
+ [!code-vb[BmpBitmapDecoderEncoder#3](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BmpBitmapDecoderEncoder/VB/BitmapFrame.vb#3)]  
+  
+<a name="_displayingimages"></a>   
+## WPF でのイメージの表示  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] アプリケーションでイメージを表示するにはいくつかの方法があります。  イメージは、<xref:System.Windows.Controls.Image> コントロールを使用して表示したり、<xref:System.Windows.Media.ImageBrush> を使用してビジュアル上に描画したり、<xref:System.Windows.Media.ImageDrawing> を使用して描画したりできます。  
+  
+### イメージ コントロールの使用  
+ <xref:System.Windows.Controls.Image> は、フレームワーク要素であり、アプリケーション内のイメージを表示する主な方法です。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.Controls.Image> を属性構文とプロパティ構文の 2 つの方法で使用できます。  属性構文とプロパティ タグ構文の両方を使用して、幅が 200 ピクセルのイメージをレンダリングする方法を次の例に示します。  属性およびプロパティの構文については、「[依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+ [!code-xml[ImageElementExample_snip#ImageSimpleExampleInlineMarkup](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml#imagesimpleexampleinlinemarkup)]  
+  
+ 多くの例で、イメージ ファイルの参照に <xref:System.Windows.Media.Imaging.BitmapImage> オブジェクトを使用しています。  <xref:System.Windows.Media.Imaging.BitmapImage> は、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 読み込み用に最適化された専用の <xref:System.Windows.Media.Imaging.BitmapSource> で、イメージを <xref:System.Windows.Controls.Image> コントロールの <xref:System.Windows.Controls.Image.Source%2A> として簡単に表示できる方法です。  
+  
+ コードを使用して幅が 200 ピクセルのイメージをレンダリングする方法を次の例に示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.Imaging.BitmapImage> は、複数のプロパティでの初期化を最適化するために <xref:System.ComponentModel.ISupportInitialize> インターフェイスを実装しています。  プロパティを変更できるのは、オブジェクトの初期化時だけです。  <xref:System.Windows.Media.Imaging.BitmapImage.BeginInit%2A> を呼び出して初期化が開始されたことを通知し、<xref:System.Windows.Media.Imaging.BitmapImage.EndInit%2A> を呼び出して初期化が完了したことを通知します。  初期化されると、プロパティの変更は無視されます。  
+  
+ [!code-csharp[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageSimpleExample.xaml.cs#imagesimpleexampleinlinecode1)]
+ [!code-vb[ImageElementExample_snip#ImageSimpleExampleInlineCode1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/ImageSimpleExample.xaml.vb#imagesimpleexampleinlinecode1)]  
+  
+#### イメージの回転、変換、およびトリミング  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用すると、ユーザーは、<xref:System.Windows.Media.Imaging.BitmapImage> のプロパティを使用して、または <xref:System.Windows.Media.Imaging.CroppedBitmap> や <xref:System.Windows.Media.Imaging.FormatConvertedBitmap> などの追加 <xref:System.Windows.Media.Imaging.BitmapSource> オブジェクトを使用して、イメージを変換できます。  これらのイメージの変換では、イメージのスケーリングまたは回転、イメージのピクセル形式の変更、またはイメージのトリミングを行うことができます。  
+  
+ イメージの回転は、<xref:System.Windows.Media.Imaging.BitmapImage> の <xref:System.Windows.Media.Imaging.BitmapImage.Rotation%2A> プロパティを使用して実行されます。  回転は、90°単位でのみ可能です。  次の例では、イメージが 90°回転されます。  
+  
+ [!code-xml[ImageElementExample#TransformedXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/TransformedImageExample.xaml#transformedxaml2)]  
+  
+ [!code-csharp[ImageElementExample#TransformedCSharp1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample/CSharp/TransformedImageExample.xaml.cs#transformedcsharp1)]
+ [!code-vb[ImageElementExample#TransformedCSharp1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample/VB/TransformedImageExample.xaml.vb#transformedcsharp1)]  
+  
+ グレースケールなどの別のピクセル形式へのイメージの変換は、<xref:System.Windows.Media.Imaging.FormatConvertedBitmap> を使用して行われます。  次の例では、イメージが <xref:System.Windows.Media.PixelFormats.Gray4%2A> に変換されます。  
+  
+ [!code-xml[ImageElementExample_snip#ConvertedXAML2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/FormatConvertedExample.xaml#convertedxaml2)]  
+  
+ [!code-csharp[ImageElementExample_snip#ConvertedCSharp1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/FormatConvertedExample.xaml.cs#convertedcsharp1)]
+ [!code-vb[ImageElementExample_snip#ConvertedCSharp1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/FormatConvertedExample.xaml.vb#convertedcsharp1)]  
+  
+ イメージをトリミングするには、<xref:System.Windows.Controls.Image> または <xref:System.Windows.Media.Imaging.CroppedBitmap> の <xref:System.Windows.UIElement.Clip%2A> プロパティを使用できます。  通常、イメージの一部を表示するだけの場合は、<xref:System.Windows.UIElement.Clip%2A> を使用する必要があります。  トリミングされたイメージをエンコードして保存する必要がある場合は、<xref:System.Windows.Media.Imaging.CroppedBitmap> を使用する必要があります。  次の例では、イメージが <xref:System.Windows.Media.EllipseGeometry> を使用している Clip プロパティを使用してトリミングされます。  
+  
+ [!code-xml[ImageElementExample_snip#CroppedXAMLUsingClip1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/CroppedImageExample.xaml#croppedxamlusingclip1)]  
+  
+ [!code-csharp[ImageElementExample_snip#CroppedCSharpUsingClip1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/CroppedImageExample.xaml.cs#croppedcsharpusingclip1)]
+ [!code-vb[ImageElementExample_snip#CroppedCSharpUsingClip1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ImageElementExample_snip/VB/CroppedImageExample.xaml.vb#croppedcsharpusingclip1)]  
+  
+#### イメージの引き伸ばし  
+ <xref:System.Windows.Controls.Image.Stretch%2A> プロパティは、コンテナーを塗りつぶすためにイメージを引き伸ばす方法を制御します。  <xref:System.Windows.Controls.Image.Stretch%2A> プロパティは、<xref:System.Windows.Media.Stretch> 列挙体によって定義された次の値を受け入れます。  
+  
+-   <xref:System.Windows.Media.Stretch> : イメージは出力領域を塗りつぶすために引き伸ばされません。  イメージが出力領域よりも大きい場合は、そのイメージは出力領域に描画され、領域に収まらない部分がトリミングされます。  
+  
+-   <xref:System.Windows.Media.Stretch> : イメージは出力領域に合わせてスケーリングされます。  イメージの高さと幅は別々にスケーリングされるため、イメージの元の縦横比が維持されない場合があります。  つまり、出力コンテナーを完全に塗りつぶすために、イメージがいびつになることがあります。  
+  
+-   <xref:System.Windows.Media.Stretch> : イメージは、出力領域内に完全に収まるようにスケーリングされます。  イメージの縦横比は維持されます。  
+  
+-   <xref:System.Windows.Media.Stretch> : イメージは、イメージの元の縦横比を維持しながら、出力領域を完全に塗りつぶすようにスケーリングされます。  
+  
+ 利用可能な各 <xref:System.Windows.Media.Stretch> 列挙体を <xref:System.Windows.Controls.Image> に適用する例を次に示します。  
+  
+ 次のイメージはこの例の出力結果を表示したものであり、異なる <xref:System.Windows.Controls.Image.Stretch%2A> 設定をイメージに適用した場合の効果を示しています。  
+  
+ ![別の TileBrush Stretch 設定](../../../../docs/framework/wpf/graphics-multimedia/media/img-mmgraphics-stretchenum.png "img\_mmgraphics\_stretchenum")  
+さまざまな Stretch 設定  
+  
+ [!code-xml[ImageElementExample_snip#ImageStretchExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ImageElementExample_snip/CSharp/ImageStretchExample.xaml#imagestretchexamplewholepage)]  
+  
+### イメージによる塗りつぶし  
+ イメージは、<xref:System.Windows.Media.Brush> を使用して塗りつぶすことによってもアプリケーション内に表示できます。  ブラシを使用すると、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] オブジェクトに、純色やパターンとイメージの複雑なセットなどを適用できます。  イメージで塗りつぶすには、<xref:System.Windows.Media.ImageBrush> を使用します。  <xref:System.Windows.Media.ImageBrush> は、ビットマップ イメージとしてコンテンツを定義する <xref:System.Windows.Media.TileBrush> の一種です。  <xref:System.Windows.Media.ImageBrush> を使用した場合、その <xref:System.Windows.Media.ImageBrush.ImageSource%2A> プロパティで指定した単一のイメージが表示されます。  イメージをどのように伸縮、配置、および並べて表示するかを制御できるため、ゆがみを防ぎ、パターンやその他の効果を適用できます。  <xref:System.Windows.Media.ImageBrush> で適用できるいくつかの効果を次の図に示します。  
+  
+ ![ImageBrush の出力例](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-imagebrushexamples.png "wcpsdk\_mmgraphics\_imagebrushexamples")  
+イメージ ブラシは、図形、コントロール、テキストなどの塗りつぶしを行うことができます。  
+  
+ <xref:System.Windows.Media.ImageBrush> を使用してイメージによってボタンの背景を塗りつぶす方法を次の例に示します。  
+  
+ [!code-xml[UsingImageBrush#4](../../../../samples/snippets/csharp/VS_Snippets_Wpf/UsingImageBrush/CS/PaintingWithImages.xaml#4)]  
+  
+ <xref:System.Windows.Media.ImageBrush> とイメージの描画の詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="_metadata"></a>   
+## イメージ メタデータ  
+ 一部のイメージ ファイルには、コンテンツまたはファイルの特性を表すメタデータが含まれています。  たとえば、ほとんどのデジタル カメラでは、イメージをキャプチャするために使用されたカメラの型とモデルに関するメタデータを含むイメージが作成されます。  各イメージ形式ではそれぞれ異なる方法でメタデータを処理しますが、[!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]では、各サポート対象のイメージ形式のメタデータを保存および取得するための統一された方法が提供されます。  
+  
+ メタデータへのアクセスは <xref:System.Windows.Media.Imaging.BitmapSource> オブジェクトの <xref:System.Windows.Media.Imaging.BitmapSource.Metadata%2A> プロパティによって提供されます。  <xref:System.Windows.Media.Imaging.BitmapSource.Metadata%2A> は、イメージに含まれるすべてのメタデータを格納する <xref:System.Windows.Media.Imaging.BitmapMetadata> オブジェクトを返します。  このデータは、1 つのメタデータ スキーマまたはさまざまなスキーマの組み合わせにすることができます。  [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]は、[!INCLUDE[TLA#tla_exif](../../../../includes/tlasharptla-exif-md.md)]、tEXt \(PNG Textual Data\)、[!INCLUDE[TLA#tla_ifd](../../../../includes/tlasharptla-ifd-md.md)]、[!INCLUDE[TLA#tla_iptc](../../../../includes/tlasharptla-iptc-md.md)]、[!INCLUDE[TLA#tla_xmp](../../../../includes/tlasharptla-xmp-md.md)] などのイメージ メタデータ スキーマをサポートします。  
+  
+ メタデータの読み取りのプロセスを簡略化するために、<xref:System.Windows.Media.Imaging.BitmapMetadata> は、<xref:System.Windows.Media.Imaging.BitmapMetadata.Author%2A>、<xref:System.Windows.Media.Imaging.BitmapMetadata.Title%2A>、<xref:System.Windows.Media.Imaging.BitmapMetadata.CameraModel%2A> などの簡単にアクセスできるいくつかの名前付きプロパティを提供します。  これらの名前付きプロパティの多くはメタデータを書き込むためにも使用できます。  メタデータ クエリ リーダーによって、メタデータを読み取るための追加サポートが行われます。  <xref:System.Windows.Media.Imaging.BitmapMetadata.GetQuery%2A> メソッドは、*"\/app1\/exif\/"* などの文字列クエリを提供することによって、メタデータ クエリ リーダーを取得するために使用されます。  次の例では、<xref:System.Windows.Media.Imaging.BitmapMetadata.GetQuery%2A> は *"\/Text\/Description"* の場所に格納されているテキストを取得するために使用されます。  
+  
+ [!code-cpp[BitmapMetadata#GetQuery](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BitMapMetadata/CPP/BitmapMetadata.cpp#getquery)]
+ [!code-csharp[BitmapMetadata#GetQuery](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BitMapMetadata/CSharp/BitmapMetadata.cs#getquery)]
+ [!code-vb[BitmapMetadata#GetQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BitMapMetadata/VB/BitmapMetadata.vb#getquery)]  
+  
+ メタデータを書き込むには、メタデータ クエリ ライターが使用されます。  <xref:System.Windows.Media.Imaging.BitmapMetadata.SetQuery%2A> はクエリ ライターを取得し、必要な値を設定します。  次の例では、<xref:System.Windows.Media.Imaging.BitmapMetadata.SetQuery%2A> は *"\/Text\/Description"* の場所に格納されているテキストを書き込むために使用されます。  
+  
+ [!code-cpp[BitmapMetadata#SetQuery](../../../../samples/snippets/cpp/VS_Snippets_Wpf/BitMapMetadata/CPP/BitmapMetadata.cpp#setquery)]
+ [!code-csharp[BitmapMetadata#SetQuery](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BitMapMetadata/CSharp/BitmapMetadata.cs#setquery)]
+ [!code-vb[BitmapMetadata#SetQuery](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BitMapMetadata/VB/BitmapMetadata.vb#setquery)]  
+  
+<a name="_extensibility"></a>   
+## コーデック拡張機能  
+ [!INCLUDE[TLA2#tla_wic](../../../../includes/tla2sharptla-wic-md.md)]のコア機能は、新しいイメージ コーデックの拡張モデルです。  これらのアンマネージ インターフェイスを使用すると、コーデック開発者は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] アプリケーションで新しいイメージ形式を自動的に使用できるように、コーデックを [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] に統合できます。  
+  
+ 拡張 [!INCLUDE[TLA2#tla_api](../../../../includes/tla2sharptla-api-md.md)] のサンプルについては、[Win32 サンプル コーデック](http://go.microsoft.com/fwlink/?LinkID=160052)を参照してください。  このサンプルでは、カスタム イメージ形式のデコーダーおよびエンコーダーを作成する方法を示します。  
+  
+> [!NOTE]
+>  コーデックには、システムで認識するために、デジタル署名を行う必要があります。  
+  
+## 参照  
+ <xref:System.Windows.Media.Imaging.BitmapSource>   
+ <xref:System.Windows.Media.Imaging.BitmapImage>   
+ <xref:System.Windows.Controls.Image>   
+ <xref:System.Windows.Media.Imaging.BitmapMetadata>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [Win32 サンプル コーデック](http://go.microsoft.com/fwlink/?LinkID=160052)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/index.md b/docs/framework/wpf/graphics-multimedia/index.md
new file mode 100644
index 00000000000..e9741610530
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/index.md
@@ -0,0 +1,164 @@
+---
+title: "グラフィックスとマルチメディア | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, 機能"
+  - "グラフィックス機能"
+  - "メディア, 機能"
+  - "サウンド効果"
+  - "遷移効果"
+  - "ビデオ効果"
+ms.assetid: 1817d9dc-3d6c-46cb-afc8-63b0bae35e37
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# グラフィックスとマルチメディア
+<a name="introduction"></a> [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、マルチメディア、ベクター グラフィックス、アニメーション、およびコンテンツ構成のサポートが提供されるので、開発者はユーザーの関心を引くユーザー インターフェイスやコンテンツを簡単に開発できます。  [!INCLUDE[TLA#tla_visualstu](../../../../includes/tlasharptla-visualstu-md.md)] を使用して、ベクター グラフィックスまたは複雑なアニメーションを作成し、メディアをアプリケーションに統合することができます。  
+  
+ ここでは、アプリケーションにグラフィックス、遷移効果、サウンド、およびビデオを追加できるようにする [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のグラフィックス、アニメーション、およびメディア機能について説明します。  
+  
+> [!NOTE]
+>  Windows サービスで WPF 型を使用することは避けることを強くお勧めします。  Windows サービスで WPF 型を使用しようとした場合、サービスが期待どおりに動作しないことがあります。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="whats_new_with_graphics_and_multimedia_in_wpf_4"></a>   
+## WPF 4 のグラフィックスとマルチメディアの新機能  
+ グラフィックスとアニメーションに関するいくつかの変更点があります。  
+  
+-   レイアウトの丸め  
+  
+     オブジェクトの一方の端が 1 つのピクセル デバイスに位置する場合、DPI に依存しないグラフィック システムでは、不鮮明な表示 \(半透明のエッジ\) などのレンダリング アイテムを作成できます。  以前のバージョンの WPF には、このような場合の処理に役立つピクセル スナップが含まれています。  Silverlight 2 では、レイアウトの丸めが導入されたことで、端がピクセル境界全体に位置するように、要素を移動する別の方法が利用できます。  WPF では今回、<xref:System.Windows.FrameworkElement> にアタッチされた <xref:System.Windows.FrameworkElement.UseLayoutRounding%2A> プロパティで、レイアウトの丸めがサポートされました。  
+  
+-   キャッシュ済みコンポジション  
+  
+     新しい <xref:System.Windows.Media.BitmapCache> クラスと <xref:System.Windows.Media.BitmapCacheBrush> クラスを使用すると、ビジュアル ツリーの複雑な部分をビットマップとしてキャッシュすることで、描画時間を大幅に短縮できます。  このビットマップに対しては、マウス クリックなどのユーザー入力ができるため、その他の要素上にブラシのように描画することができます。  
+  
+-   Pixel Shader 3 のサポート  
+  
+     WPF 4 は、WPF 3.5 SP1 で導入された <xref:System.Windows.Media.Effects.ShaderEffect> のサポートを基に、アプリケーションで Pixel Shader \(PS\) Version 3.0 を使用したエフェクトを記述できるようにします。  PS 3.0 のシェーダー モデルは、サポートされているハードウェア上でより多くのエフェクトを使用できるという点で、PS 2.0 より洗練されています。  
+  
+-   イージング関数  
+  
+     イージング関数を使用すると、アニメーションの動きを詳細に制御できるため、アニメーションが魅力的になります。  たとえば、<xref:System.Windows.Media.Animation.ElasticEase> をアニメーションに適用すると、アニメーションに弾むような動作を加えることができます。  イージングの種類の詳細については、<xref:System.Windows.Media.Animation> 名前空間のドキュメントを参照してください。  
+  
+<a name="graphics_and_rendering"></a>   
+## グラフィックスおよび描画  
+ WPF では、高品質 2D グラフィックスがサポートされます。  ブラシ、ジオメトリ、イメージ、変換などの機能が用意されています。  詳細については、「[グラフィックス](../../../../docs/framework/wpf/graphics-multimedia/graphics.md)」を参照してください。  グラフィック要素の描画は、<xref:System.Windows.Media.Visual> クラスに基づいています。  画面のビジュアル オブジェクトの構造は、ビジュアル ツリーによって表されます。  詳細については、「[WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)」を参照してください。  
+  
+### 2\-D 図形  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、次の図に示すような四角形や楕円などの、一般的に使用されるベクター描画の [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] 図形のライブラリが用意されています。  
+  
+ ![楕円と四角形](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure4.png "WPFIntroFigure4")  
+  
+ これらの固有の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 図形は単なる図形ではなく、キーボード入力やマウス入力を含む最も一般的なコントロールで得られる機能の多くを実装するプログラミング可能な要素です。  次の例は、<xref:System.Windows.Shapes.Ellipse> 要素をクリックすることによって発生した <xref:System.Windows.UIElement.MouseUp> イベントの処理方法を示しています。  
+  
+```xaml  
+<Window  
+  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+  x:Class="Window1" >  
+  <Ellipse Fill="LightBlue" MouseUp="ellipseButton_MouseUp" />  
+</Window>  
+```  
+  
+```csharp  
+public partial class Window1  : Window  
+{  
+    void ellipseButton_MouseUp(object sender, MouseButtonEventArgs e)  
+    {  
+        MessageBox.Show("You clicked the ellipse!");  
+    }  
+}  
+```  
+  
+```vb  
+Partial Public Class Window1  
+    Inherits Window  
+    Private Sub ellipseButton_MouseUp(ByVal sender As Object, ByVal e As MouseButtonEventArgs)  
+        MessageBox.Show("You clicked the ellipse!")  
+    End Sub  
+End Class  
+  
+```  
+  
+ 上記の [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] マークアップおよび分離コードの出力を次の図に示します。  
+  
+ !["you clicked the ellipse&#33;" というテキストを含むウィンドウ](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure12.png "WPFIntroFigure12")  
+  
+ 詳細については、「[WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)」を参照してください。  入門用のサンプルについては、[Shape 要素のサンプル](http://go.microsoft.com/fwlink/?LinkID=160037)を参照してください。  
+  
+### 2\-D ジオメトリ  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] で提供される [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] 図形では不十分な場合は、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] でのジオメトリおよびパスのサポートを利用して独自の図形を作成します。  ジオメトリを使用して図形を描画ブラシとして作成し、他の [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] 要素をクリップする方法を次の図に示します。  
+  
+ ![パスのさまざまな使用](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure5.png "WPFIntroFigure5")  
+  
+ 詳細については、「[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)」を参照してください。  入門用のサンプルについては、[ジオメトリのサンプル](http://go.microsoft.com/fwlink/?LinkID=159989)を参照してください。  
+  
+### 2\-D 効果  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、さまざまな効果を作成するために使用できる [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] クラスのライブラリが用意されています。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] レンダリング機能を使用すると、グラデーション、ビットマップ、描画、およびビデオを持つ [!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)] 要素を塗りつぶすことができます。また、回転、拡大縮小、および[傾斜](GTMT)を使用して要素を操作できます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ブラシを使用して得られる多くの効果の例を次の図に示します。  
+  
+ ![さまざまなブラシの図](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure6.png "WPFIntroFigure6")  
+  
+ 詳細については、「[WPF のブラシの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md)」を参照してください。  入門用のサンプルについては、[ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)を参照してください。  
+  
+<a name="rendering"></a>   
+## 3\-D レンダリング  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] には、さらに人目を引くレイアウト、[!INCLUDE[TLA2#tla_ui](../../../../includes/tla2sharptla-ui-md.md)]、およびデータの視覚化を実現するために [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] の [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] グラフィックス サポートと統合された一連の [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] レンダリング機能が用意されています。  たとえば、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] では、次の図に示すように [!INCLUDE[TLA2#tla_3d](../../../../includes/tla2sharptla-3d-md.md)] 図形のサーフェイスに [!INCLUDE[TLA2#tla_2d](../../../../includes/tla2sharptla-2d-md.md)] イメージを描画できます。  
+  
+ ![Visual3D サンプルのスクリーンショット](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure13.png "WPFIntroFigure13")  
+  
+ 詳細については、「[3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)」を参照してください。  入門用のサンプルについては、[3\-D ソリッドのサンプル](http://go.microsoft.com/fwlink/?LinkID=159964)を参照してください。  
+  
+<a name="animation"></a>   
+## アニメーション  
+ アニメーションを使用すると、コントロールおよび要素の拡張、振動、回転、およびフェード効果を実現できます。また、人の関心を引くページの遷移なども作成できます。  [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ではほとんどのプロパティをアニメーション化できるため、ほとんどの [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] オブジェクトをアニメーション化できるだけでなく、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] を使用して作成するカスタム オブジェクトをアニメーション化することもできます。  
+  
+ ![アニメーション キューブのイメージ](../../../../docs/framework/wpf/graphics-multimedia/media/wpfintrofigure7.png "WPFIntroFigure7")  
+  
+ 詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  その他の入門用のサンプルについては、[アニメーション サンプル ギャラリー](http://go.microsoft.com/fwlink/?LinkID=159969)を参照してください。  
+  
+<a name="media"></a>   
+## メディア  
+ イメージ、ビデオ、およびオーディオは、情報およびユーザー エクスペリエンスを伝えるメディア リッチな手段です。  
+  
+### \[イメージ\]  
+ アイコン、背景、およびアニメーションのパーツを含むイメージは、ほとんどのアプリケーションの中核です。  イメージは頻繁に使用する必要があるため、[!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] ではさまざまな方法でイメージを処理できます。  その方法の一例を次の図に示します。  
+  
+ ![スタイル サンプル スクリーンショット](../../../../docs/framework/wpf/controls/media/stylingintro-eventtriggers.png "StylingIntro\_EventTriggers")  
+  
+ 詳細については、「[イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)」を参照してください。  
+  
+### ビデオとオーディオ  
+ [!INCLUDE[TLA2#tla_wpf](../../../../includes/tla2sharptla-wpf-md.md)] のグラフィックス機能の主要な特性は、ビデオやオーディオを含むマルチメディアの処理をネイティブにサポートすることです。  次の例は、アプリケーションにメディア プレーヤーを挿入する方法を示しています。  
+  
+```xaml  
+<MediaElement Source="media\numbers.wmv" Width="450" Height="250" />  
+```  
+  
+ <xref:System.Windows.Controls.MediaElement> はビデオとオーディオの両方を再生でき、カスタム [!INCLUDE[TLA2#tla_ui#plural](../../../../includes/tla2sharptla-uisharpplural-md.md)] を簡単に作成できる拡張性を備えています。  
+  
+ 詳細については、「[マルチメディアの概要](../../../../docs/framework/wpf/graphics-multimedia/multimedia-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media>   
+ <xref:System.Windows.Media.Animation>   
+ <xref:System.Windows.Media.Media3D>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [3\-D Graphics](http://msdn.microsoft.com/ja-jp/565c1f3c-235b-47de-b05b-3b53ed63f1b8)   
+ [Multimedia](http://msdn.microsoft.com/ja-jp/44a8dcd0-80cb-4db0-a222-87cde68c2fac)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md
new file mode 100644
index 00000000000..580422bd0ce
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md
@@ -0,0 +1,50 @@
+---
+title: "キー フレーム アニメーションに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アニメーション, キー フレーム"
+  - "キー フレーム [WPF], 方法トピック"
+ms.assetid: a5f9ab1a-d14c-4816-8540-3c5b8c8143d5
+caps.latest.revision: 55
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 55
+---
+# キー フレーム アニメーションに関する「方法」トピック
+このセクションの各トピックでは、キー フレーム アニメーションを使用して、3 つ以上のプロパティ値をアニメーション化し、補間処理を制御する方法について説明します。  
+  
+## このセクションの内容  
+ [キー フレームを使用してオブジェクトをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-by-using-key-frames.md)  
+ [キー フレームを使用してブール値をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-boolean-by-using-key-frames.md)  
+ [キー フレームを使用して Double 値をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-double-by-using-key-frames.md)  
+ [キー フレームを使用して行列をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-matrix-by-using-key-frames.md)  
+ [キー フレームを使用して点をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-point-by-using-key-frames.md)  
+ [キー フレームを使用して四角形のジオメトリをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-rectangle-geometry-by-using-key-frames.md)  
+ [キー フレームを使用して文字列をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-string-by-using-key-frames.md)  
+ [キー フレームを使用して色をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-color-by-using-key-frames.md)  
+ [キー フレームを使用してサイズの変更をアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-size-changes-by-using-key-frames.md)  
+ [キー フレームを使用して境界線の太さをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-the-thickness-of-a-border-by-using-key-frames.md)  
+ [キー フレーム アニメーションのタイミングを制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-key-frame-animation-timing.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames>  
+  
+ <xref:System.Windows.Media.Animation.Storyboard>  
+  
+ <xref:System.Windows.Media.Animation.KeyTime>  
+  
+## 参照  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md b/docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md
new file mode 100644
index 00000000000..89c3f2d9cea
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md
@@ -0,0 +1,322 @@
+---
+title: "キー フレーム アニメーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, キー フレーム"
+  - "キー フレーム [WPF], キー フレーム アニメーションの概要"
+  - "複数のアニメーションのターゲット値"
+ms.assetid: 10028f97-bb63-41fc-b8ad-663dac7ea203
+caps.latest.revision: 29
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# キー フレーム アニメーションの概要
+ここでは、キー フレーム アニメーションについて説明します。  キー フレーム アニメーションでは、3 つ以上のターゲット値を使用してアニメーション化し、アニメーションの補間方式を制御することができます。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [必要条件](#prerequisites)  
+  
+-   [キー フレーム アニメーションの使用](#keyframeanimations)  
+  
+-   [関連トピック](#seeAlsoToggle)  
+  
+<a name="prerequisites"></a>   
+## 必要条件  
+ この概要を理解するには、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のアニメーションおよびタイムラインに精通している必要があります。  アニメーションの概要については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。また、From\/To\/By アニメーションについても知っておくと役に立ちます。  詳細については、「[From\/To\/By アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/from-to-by-animations-overview.md)」を参照してください。  
+  
+<a name="whatisakeyframeanimation"></a>   
+## キー フレーム アニメーションとは  
+ From\/To\/By アニメーションと同様に、キー フレーム アニメーションは、ターゲット プロパティの値をアニメーション化します。  また、<xref:System.Windows.Media.Animation.Timeline.Duration%2A> 全体でのターゲット値間の遷移を作成します。  ただし、From\/To\/By アニメーションでは 2 つの値の間の遷移が作成されますが、単一のキー フレーム アニメーションでは、任意の数のターゲット値の間の遷移を作成できます。  From\/To\/By アニメーションとは異なり、キー フレーム アニメーションには、ターゲット値を設定するために使用する From、To、または By プロパティがありません。  キー フレーム アニメーションのターゲット値は、キー フレーム オブジェクトを使用して記述します \(そのため、"キー フレーム アニメーション" と呼ばれます\)。  キー フレーム アニメーションのターゲット値を指定するには、キー フレーム オブジェクトを作成してアニメーションの <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames.KeyFrames%2A> コレクションに追加します。  実行時に、アニメーションは指定したフレーム間を遷移します。  
+  
+ 一部のキー フレーム メソッドは、複数のターゲット値をサポートするだけでなく、複数の補間方式もサポートします。  アニメーションの補間方式によって、ある値から次の値へのアニメーションの遷移方法が定義されます。  補間には、[離散](GTMT)、[線形](GTMT)、および[スプライン](GTMT)の 3 種類があります。  
+  
+ キー フレーム アニメーションを使用してアニメーション化するには、次の手順を実行します。  
+  
+-   From\/To\/By アニメーションの場合と同様に、アニメーションを宣言してその <xref:System.Windows.Media.Animation.Timeline.Duration%2A> を指定します。  
+  
+-   ターゲット値ごとに、適切な型のキー フレームを作成し、その値と <xref:System.Windows.Media.Animation.KeyTime> を設定して、アニメーションの <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames.KeyFrames%2A> コレクションに追加します。  
+  
+-   From\/To\/By アニメーションの場合と同様に、アニメーションをプロパティに関連付けます。  ストーリーボードを使用してアニメーションをプロパティに適用する方法の詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> を使用して、<xref:System.Windows.Shapes.Rectangle> 要素を 4 つの異なる場所にアニメーション化します。  
+  
+ [!code-xml[keyframes_ovw_snip#BasicKeyFrameExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyFramesIntroduction.xaml#basickeyframeexamplewholepage)]
+ [!code-xml[keyframes_ovw_snip#BasicKeyFrameExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyFramesIntroduction.xaml#basickeyframeexamplewholepage)]  
+  
+ From\/To\/By アニメーションと同様に、キー フレーム アニメーションも、マークアップおよびコードで <xref:System.Windows.Media.Animation.Storyboard> を使用するかコードで <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用して、プロパティに適用することができます。  また、キー フレーム アニメーションを使用して <xref:System.Windows.Media.Animation.AnimationClock> を作成し、1 つ以上のプロパティに適用することもできます。  アニメーションを適用するさまざまな方法の詳細については、「[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)」を参照してください。  
+  
+<a name="animation_types"></a>   
+## キー フレーム アニメーションの種類  
+ アニメーションによってプロパティ値が生成されるため、さまざまなプロパティ型に対応するさまざまな種類のアニメーションが存在します。  <xref:System.Double> を受け取るプロパティ \(要素の <xref:System.Windows.FrameworkElement.Width%2A> プロパティなど\) をアニメーション化するには、<xref:System.Double> 値を生成するアニメーションを使用します。  <xref:System.Windows.Point> を受け取るプロパティをアニメーション化するには、<xref:System.Windows.Point> 値を生成するアニメーションを使用します。他も同様です。  
+  
+ キー フレーム アニメーション クラスは <xref:System.Windows.Media.Animation> 名前空間に属し、次の名前付け規則に従います。  
+  
+ *\<Type\>* `AnimationUsingKeyFrames`  
+  
+ ここで、*\<Type\>* はクラスによってアニメーション化される値の型です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、次のキー フレーム アニメーション クラスが用意されています。  
+  
+|プロパティの型|対応する From\/To\/By アニメーション クラス|サポートされている補間方式|  
+|-------------|-----------------------------------|-------------------|  
+|<xref:System.Boolean>|<xref:System.Windows.Media.Animation.BooleanAnimationUsingKeyFrames>|離散|  
+|<xref:System.Byte>|<xref:System.Windows.Media.Animation.ByteAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Media.Color>|<xref:System.Windows.Media.Animation.ColorAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Decimal>|<xref:System.Windows.Media.Animation.DecimalAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Double>|<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Int16>|<xref:System.Windows.Media.Animation.Int16AnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Int32>|<xref:System.Windows.Media.Animation.Int32AnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Int64>|<xref:System.Windows.Media.Animation.Int64AnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Media.Matrix>|<xref:System.Windows.Media.Animation.MatrixAnimationUsingKeyFrames>|離散|  
+|<xref:System.Object>|<xref:System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames>|離散|  
+|<xref:System.Windows.Point>|<xref:System.Windows.Media.Animation.PointAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Media.Media3D.Quaternion>|<xref:System.Windows.Media.Animation.QuaternionAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Rect>|<xref:System.Windows.Media.Animation.RectAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Media.Media3D.Rotation3D>|<xref:System.Windows.Media.Animation.Rotation3DAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Single>|<xref:System.Windows.Media.Animation.SingleAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.String>|<xref:System.Windows.Media.Animation.StringAnimationUsingKeyFrames>|離散|  
+|<xref:System.Windows.Size>|<xref:System.Windows.Media.Animation.SizeAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Thickness>|<xref:System.Windows.Media.Animation.ThicknessAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Media.Media3D.Vector3D>|<xref:System.Windows.Media.Animation.Vector3DAnimationUsingKeyFrames>|離散、線形、スプライン|  
+|<xref:System.Windows.Vector>|<xref:System.Windows.Media.Animation.VectorAnimationUsingKeyFrames>|離散、線形、スプライン|  
+  
+<a name="animation_target_values"></a>   
+## ターゲット値 \(キー フレーム\) およびキー時刻  
+ さまざまな型のプロパティをアニメーション化するためにさまざまな種類のキー フレーム アニメーションが存在するのと同様に、キー フレーム オブジェクトにもさまざまな種類があります。このオブジェクトは、アニメーション化される値の型およびサポートされている補間方式ごとに 1 つずつあります。  キー フレームの種類は、次の名前付け規則に従います。  
+  
+ *\<InterpolationMethod\>\<Type\>* `KeyFrame`  
+  
+ ここで、*\<InterpolationMethod\>* はキー フレームで使用される補間方式で、*\<Type\>* はクラスによってアニメーション化される値の型です。  3 つすべての補間方式をサポートするキー フレーム アニメーションでは、3 種類のキー フレームを使用できます。  たとえば、<xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> では <xref:System.Windows.Media.Animation.DiscreteDoubleKeyFrame>、<xref:System.Windows.Media.Animation.LinearDoubleKeyFrame>、および <xref:System.Windows.Media.Animation.SplineDoubleKeyFrame> の 3 種類のキー フレームを使用できます   \(補間方式については、後のセクションで詳しく説明します\)。  
+  
+ キー フレームの主な目的は、<xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> および <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> を指定することです。  すべての種類のキー フレームで、これら 2 つのプロパティが提供されます。  
+  
+-   <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> プロパティは、そのキー フレームのターゲット値を指定します。  
+  
+-   <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> プロパティは、\(アニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> 内で\) キー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> に達する時刻を指定します。  
+  
+ キー フレーム アニメーションが開始されると、<xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> プロパティで定義された順序でキー フレームが反復処理されます。  
+  
+-   0 の時点にキー フレームが存在しない場合は、アニメーションによってターゲット プロパティの現在の値と最初のキー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> の間の遷移が作成されます。それ以外の場合は、アニメーションの出力値が最初のキー フレームの値になります。  
+  
+-   アニメーションでは、2 番目のキー フレームで指定された補間方式を使用して、最初のキー フレームと 2 番目のキー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> の間の遷移が作成されます。  遷移は最初のキー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> から開始され、2 番目のキー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> に到達した時点で終了します。  
+  
+-   アニメーションが続行され、後続の各キー フレームとその前のキー フレームの間の遷移が作成されます。  
+  
+-   最後に、アニメーションは、その <xref:System.Windows.Media.Animation.Timeline.Duration%2A> 以内で最大のキー時刻が指定されたキー フレームの値に遷移します。  
+  
+ アニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> が <xref:System.Windows.Duration.Automatic%2A> の場合、またはその <xref:System.Windows.Media.Animation.Timeline.Duration%2A> が最後のキー フレームの時刻と等しい場合、アニメーションは終了します。  アニメーションの <xref:System.Windows.Duration> が最後のキー フレームのキー時刻を超える場合、アニメーションは、その <xref:System.Windows.Duration> の最後に到達するまでキー フレームの値を保持します。  すべてのアニメーションと同様に、キー フレーム アニメーションは <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティを使用して、アクティブな期間の末尾に到達したときに最終的な値を保持するかどうかを決定します。  詳細については、「[タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)」を参照してください。  
+  
+ 次の例では、前の例で定義した <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> オブジェクトを使用して、<xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> および <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> プロパティの動作を示します。  
+  
+-   最初のキー フレームは、アニメーションの出力値を直ちに 0 に設定します。  
+  
+-   2 番目のキー フレームは、0 から 350 までアニメーション化します。  最初のキー フレームの終了時 \(0 秒の時点\) に開始され、2 秒間再生されて 0:0:2 の時点で終了します。  
+  
+-   3 番目のキー フレームは、350 から 50 までアニメーション化します。  2 番目のキー フレームの終了時 \(2 秒の時点\) に開始され、5 秒間再生されて 0:0:7 の時点で終了します。  
+  
+-   4 番目のキー フレームは、50 から 200 までアニメーション化します。  3 番目のキー フレームの終了時 \(7 秒の時点\) に開始され、1 秒間再生されて 0:0:8 の時点で終了します。  
+  
+-   アニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> プロパティが 10 秒に設定されているため、アニメーションは、0:0:10 の時点で終了するまでの 2 秒間その最終的な値を保持します。  
+  
+ [!code-xml[keyframes_ovw_snip#BasicKeyFrameExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyFramesIntroduction.xaml#basickeyframeexamplewholepage)]
+ [!code-xml[keyframes_ovw_snip#BasicKeyFrameExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyFramesIntroduction.xaml#basickeyframeexamplewholepage)]  
+  
+<a name="interpolationmethods"></a>   
+## 補間方式  
+ これまでのセクションで、複数の補間方式をサポートするキー フレーム アニメーションもあることについて説明しました。  アニメーションの補間は、アニメーションが期間全体でどのように値の間を遷移するかを記述します。  アニメーションで使用するキー フレームの種類を選択することで、そのキー フレーム セグメントの補間方式を定義できます。  補間方式には、線形、離散、およびスプラインの 3 種類があります。  
+  
+### 線形補間  
+ [線形補間](GTMT)では、アニメーションはセグメント期間において定率で進行します。  たとえば、キー フレーム セグメントが 5 秒間に 0 から 10 に遷移する場合、アニメーションは指定された時点で次の値を出力します。  
+  
+|Time|出力値|  
+|----------|---------|  
+|0|0|  
+|1|2|  
+|2|4|  
+|3|6|  
+|4|8|  
+|4.25|8.5|  
+|4.5|9|  
+|5|10|  
+  
+### 離散補間  
+ [離散補間](GTMT)では、補間なしでアニメーション機能がある値から次の値にジャンプします。  キー フレーム セグメントが 5 秒間に 0 から 10 に遷移する場合、アニメーションは指定された時点で次の値を出力します。  
+  
+|Time|出力値|  
+|----------|---------|  
+|0|0|  
+|1|0|  
+|2|0|  
+|3|0|  
+|4|0|  
+|4.25|0|  
+|4.5|0|  
+|5|10|  
+  
+ セグメント期間の最後までアニメーションの出力値が変化しないことに注目してください。  
+  
+ [スプライン補間](GTMT)はより複雑です。  次のセクションを参照してください。  
+  
+<a name="anim_spline"></a>   
+### スプライン補間  
+ スプライン補間を使用すると、よりリアルなタイミング効果を実現できます。  アニメーションは現実に発生する効果を模倣するために使用されることが多いため、開発者は、オブジェクトの加速と減速を細かく制御し、タイミング セグメントを緻密に操作することが必要になる場合もあります。  スプライン キー フレームを使用すると、スプライン補間でアニメーション化することができます。  他のキー フレームでは、<xref:System.Windows.Media.Animation.IKeyFrame.Value%2A> および <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> を指定しますが、  スプライン キー フレームでは、<xref:System.Windows.Media.Animation.SplineDoubleKeyFrame.KeySpline%2A> も指定します。  <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> の単一のスプライン キー フレームの例を次に示します。  <xref:System.Windows.Media.Animation.KeySpline> プロパティに注目してください。このプロパティが、スプライン キー フレームと他の種類のキー フレームの違いです。  
+  
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/InterpolationMethodsExample.xaml#singlesplinekeyframeexample)]
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/InterpolationMethodsExample.xaml#singlesplinekeyframeexample)]  
+  
+ [3 次ベジエ曲線](GTMT)は、始点、終点、および 2 つの制御点によって定義されます。  スプライン キー フレームの <xref:System.Windows.Media.Animation.KeySpline> プロパティは、\(0,0\) から \(1,1\) に伸びるベジエ曲線の 2 つの制御点を定義します。  1 つ目の制御点はベジエ曲線の前半分の曲率を制御し、2 つ目の制御点はベジエ セグメントの残り半分の曲率を制御します。  作成された曲線は、そのスプライン キー フレームの変更率を示します。  曲線が急になるほどキー フレームの値の変更が速くなります。  曲線が平坦になるほどキー フレームの値の変更が遅くなります。  
+  
+ <xref:System.Windows.Media.Animation.KeySpline> を使用して、流れ落ちる水や跳ねるボールなどの物理的な軌道をシミュレートしたり、その他の "イーズイン" および "イーズアウト" 効果をモーション アニメーションに適用したりする場合があります。  背景のフェード効果やコントロール ボタンの戻り効果などのユーザー操作に関する効果の場合、スプライン補間を適用してアニメーションの変更率を特定の方法で加速または減速する場合もあります。  
+  
+ 次の例は、<xref:System.Windows.Media.Animation.KeySpline> を 0,1 1,0 に指定し、次に示すベジエ曲線を作成します。  
+  
+ ![ベジエ曲線](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-0-1-1-0.png "graphicsmm\_keyspline\_0\_1\_1\_0")  
+制御点が \(0.0, 1.0\) および \(1.0, 0.0\) のキー スプライン  
+  
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/InterpolationMethodsExample.xaml#singlesplinekeyframeexample)]
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/InterpolationMethodsExample.xaml#singlesplinekeyframeexample)]  
+  
+ このキー フレームは、開始時にすばやくアニメーション化し、減速して再度加速し、終了します。  
+  
+ 次の例は、<xref:System.Windows.Media.Animation.KeySpline> を 0.5,0.25 0.75,1.0 に指定し、次に示すベジエ曲線を作成します。  
+  
+ ![ベジエ曲線](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-025-050-075-10.png "graphicsmm\_keyspline\_025\_050\_075\_10")  
+制御点が \(0.25, 0.5\) および \(0.75, 1.0\) のキー スプライン  
+  
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExampleInline3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/InterpolationMethodsExample.xaml#singlesplinekeyframeexampleinline3)]
+ [!code-xml[keyframes_ovw_snip#SingleSplineKeyFrameExampleInline3](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/InterpolationMethodsExample.xaml#singlesplinekeyframeexampleinline3)]  
+  
+ ベジエ曲線の曲率がほとんど変化しないため、このキー フレームはほぼ定率でアニメーション化されます。終了が近づくと少し減速します。  
+  
+ <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> を使用して四角形の位置をアニメーション化する例を次に示します。  <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> で <xref:System.Windows.Media.Animation.SplineDoubleKeyFrame> オブジェクトが使用されるため、キー フレームの各値の間の遷移でスプライン補間が使用されます。  
+  
+ [!code-xml[keyframes_ovw_snip#SplinedInterpolationExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/InterpolationMethodsExample.xaml#splinedinterpolationexample)]
+ [!code-xml[keyframes_ovw_snip#SplinedInterpolationExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/InterpolationMethodsExample.xaml#splinedinterpolationexample)]  
+  
+ スプライン補間は理解しにくいため、さまざまな設定を試してみることをお勧めします。  [キー スプライン アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160011)を使用すると、キー スプラインの値を変更して、アニメーションに表れる結果を確認することができます。  
+  
+<a name="combininginterpolationmethods"></a>   
+### 補間方式の組み合わせ  
+ 補間の種類が異なるキー フレームを 1 つのキー フレーム アニメーションで使用することができます。  補間の種類が異なる 2 つのキー フレーム アニメーションが交互に発生する場合、2 番目のキー フレームの補間方式を使用して、最初の値から 2 番目の値への遷移が作成されます。  
+  
+ 次の例では、線形、スプライン、および離散補間を使用する <xref:System.Windows.Media.Animation.DoubleAnimationUsingKeyFrames> が作成されます。  
+  
+ [!code-xml[keyframes_ovw_snip#ComboInterpolationExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/InterpolationMethodsExample.xaml#combointerpolationexample)]
+ [!code-xml[keyframes_ovw_snip#ComboInterpolationExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/InterpolationMethodsExample.xaml#combointerpolationexample)]  
+  
+<a name="keytimes"></a>   
+## 継続時間およびキー時刻の詳細  
+ 他のアニメーションと同様に、キー フレーム アニメーションにも <xref:System.Windows.Duration> プロパティがあります。  アニメーションの <xref:System.Windows.Duration> の指定に加えて、その継続時間のどの部分を各キー フレームに割り当てるかを指定する必要があります。  指定するには、アニメーションの各キー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> を記述します。  各キー フレームの <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> は、そのキー フレームが終了する時刻を指定します。  
+  
+ <xref:System.Windows.Media.Animation.IKeyFrame.KeyTime%2A> プロパティは、キー時刻の再生時間を指定するわけではありません。  キー フレームが再生される時間は、そのキー フレームが終了する時刻、前のキー フレームが終了した時刻、およびアニメーションの継続時間によって決まります。  キー時刻は、時間を表す値、割合、あるいは特殊な値 \(<xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> または <xref:System.Windows.Media.Animation.KeyTime.Paced%2A>\) で指定できます。  
+  
+ キー時刻を指定するさまざまな方法を次に示します。  
+  
+### TimeSpan 値  
+ <xref:System.TimeSpan> 値を使用して <xref:System.Windows.Media.Animation.KeyTime> を指定できます。  この値は 0 以上でアニメーションの継続時間以下でなければなりません。  継続時間が 10 秒のアニメーションとキー時刻が時間を表す値として指定される 4 つのキー フレームの例を次に示します。  
+  
+-   最初のキー フレームは、最初の 3 秒間に基準値から 100 までアニメーション化し、0:0:03 の時点で終了します。  
+  
+-   2 番目のキー フレームは、100 から 200 までアニメーション化します。  最初のキー フレームの終了時 \(3 秒の時点\) に開始され、5 秒間再生されて 0:0:8 の時点で終了します。  
+  
+-   3 番目のキー フレームは、200 から 500 までアニメーション化します。  2 番目のキー フレームの終了時 \(8 秒の時点\) に開始され、1 秒間再生されて 0:0:9 の時点で終了します。  
+  
+-   4 番目のキー フレームは、500 から 600 までアニメーション化します。  3 番目のキー フレームの終了時 \(9 秒の時点\) に開始され、1 秒間再生されて 0:0:10 の時点で終了します。  
+  
+ [!code-xml[keyframes_ovw_snip#TimeSpanKeyTimeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyTimesExample.xaml#timespankeytimeexample)]
+ [!code-xml[keyframes_ovw_snip#TimeSpanKeyTimeExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyTimesExample.xaml#timespankeytimeexample)]  
+  
+### 割合の値  
+ 割合の値は、キー フレームがアニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> に対する特定の割合の時点で終了するように指定します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、数値の後に `%` 記号が続く形式で割合を指定します。  コードでは、<xref:System.Windows.Media.Animation.KeyTime.FromPercent%2A> メソッドを使用して、割合を示す <xref:System.Double> を渡します。  この値は 0 以上、100% 以下でなければなりません。  継続時間が 10 秒のアニメーションとキー時刻が割合として指定される 4 つのキー フレームの例を次に示します。  
+  
+-   最初のキー フレームは、最初の 3 秒間に基準値から 100 までアニメーション化し、0:0:3 の時点で終了します。  
+  
+-   2 番目のキー フレームは、100 から 200 までアニメーション化します。  最初のキー フレームの終了時 \(3 秒の時点\) に開始され、5 秒間再生されて 0:0:8 \(0.8 × 10 \= 8\) の時点で終了します。  
+  
+-   3 番目のキー フレームは、200 から 500 までアニメーション化します。  2 番目のキー フレームの終了時 \(8 秒の時点\) に開始され、1 秒間再生されて 0:0:9 \(0.9 × 10 \= 9\) の時点で終了します。  
+  
+-   4 番目のキー フレームは、500 から 600 までアニメーション化します。  3 番目のキー フレームの終了時 \(9 秒の時点\) に開始され、1 秒間再生されて 0:0:10 \(1 × 10 \= 10\) の時点で終了します。  
+  
+ [!code-xml[keyframes_ovw_snip#PercentageKeyTimeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyTimesExample.xaml#percentagekeytimeexample)]
+ [!code-xml[keyframes_ovw_snip#PercentageKeyTimeExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyTimesExample.xaml#percentagekeytimeexample)]  
+  
+### 特殊な値 Uniform  
+ 各キー フレームの時間が同じになるようにするには、<xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> タイミングを使用します。  
+  
+ <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> キー時刻では、時間がキー フレームの数で均等に分割され、各キー フレームの終了時間が決まります。  継続時間が 10 秒のアニメーションとキー時刻が <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> として指定される 4 つのキー フレームの例を次に示します。  
+  
+-   最初のキー フレームは、最初の 2.5 秒間に基準値から 100 までアニメーション化し、0:0:2.5 の時点で終了します。  
+  
+-   2 番目のキー フレームは、100 から 200 までアニメーション化します。  最初のキー フレームの終了時 \(2.5 秒の時点\) に開始され、約 2.5 秒間再生されて 0:0:5 の時点で終了します。  
+  
+-   3 番目のキー フレームは、200 から 500 までアニメーション化します。  2 番目のキー フレームの終了時 \(5 秒の時点\) に開始され、2.5 秒間再生されて 0:0:7.5 の時点で終了します。  
+  
+-   4 番目のキー フレームは、500 から 600 までアニメーション化します。  2 番目のキー フレームの終了時 \(7.5 秒の時点\) に開始され、2.5 秒間再生されて 0:0:1 の時点で終了します。  
+  
+ [!code-xml[keyframes_ovw_snip#UniformKeyTimeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyTimesExample.xaml#uniformkeytimeexample)]
+ [!code-xml[keyframes_ovw_snip#UniformKeyTimeExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyTimesExample.xaml#uniformkeytimeexample)]  
+  
+### 特殊な値 Paced  
+ 定率でアニメーション化するには、<xref:System.Windows.Media.Animation.KeyTime.Paced%2A> タイミングを使用します。  
+  
+ <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> キー時刻では、各キー フレームの長さに基づいて時間が割り当てられ、各フレームの継続時間が決まります。  これにより、アニメーションの速度 \(ペース\) が一定になります。  継続時間が 10 秒のアニメーションとキー時刻が <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> として指定される 3 つのキー フレームの例を次に示します。  
+  
+ [!code-xml[keyframes_ovw_snip#PacedKeyTimeExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/keyframes_ovw_snip/CS/KeyTimesExample.xaml#pacedkeytimeexample)]
+ [!code-xml[keyframes_ovw_snip#PacedKeyTimeExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/keyframes_ovw_snip/XAML/KeyTimesExample.xaml#pacedkeytimeexample)]  
+  
+ 最後のキー フレームのキー時刻が <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> または <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> の場合、解決されたキー時刻は 100% に設定されます。  マルチフレーム アニメーションの最初のキー フレームが Paced の場合、解決されたキー時刻は 0 に設定されます。  キー フレーム コレクションに含まれるキー フレームが 1 つだけで、Paced キー フレームである場合、解決されたキー時刻は 100% に設定されます。  
+  
+ 1 つのキー フレーム アニメーション内の異なるキー フレームでは、異なるキー時刻を使用できます。  
+  
+<a name="combiningkeytimes"></a>   
+## キー時刻と順序がバラバラのキー フレームの組み合わせ  
+ 種類が異なる <xref:System.Windows.Media.Animation.KeyTime> の値を持つキー フレームを 1 つのアニメーションで使用することができます。  また、キー フレームは再生順に追加することをお勧めしますが、必須ではありません。  アニメーションおよびタイミング システムでは、順序がバラバラのキー フレームを解決できます。  キー時刻が無効なキー フレームは無視されます。  
+  
+ キー フレーム アニメーションのキー フレームのキー時刻を解決するための手順を次に示します。  
+  
+1.  <xref:System.TimeSpan> <xref:System.Windows.Media.Animation.KeyTime> 値を解決します。  
+  
+2.  アニメーションの合計補間時間 \(キー フレーム アニメーションが順方向の反復を完了するのに要する合計時間\) を決定します。  
+  
+    1.  アニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> が <xref:System.Windows.Duration.Automatic%2A> または <xref:System.Windows.Duration.Forever%2A> ではない場合、合計補間時間はアニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> プロパティの値になります。  
+  
+    2.  それ以外の場合、合計補間時間は、キー フレーム間に指定された <xref:System.TimeSpan> <xref:System.Windows.Media.Animation.KeyTime> 値の中で最大の値になります \(存在する場合\)。  
+  
+    3.  最大値が存在しない場合、合計補間時間は 1 秒です。  
+  
+3.  合計補間時間の値を使用して、<xref:System.Windows.Media.Animation.KeyTimeType> <xref:System.Windows.Media.Animation.KeyTime> 値を解決します。  
+  
+4.  最後のキー フレームを解決します \(前の手順で解決していない場合\)。  最後のキー フレームの <xref:System.Windows.Media.Animation.KeyTime> が <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> または <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> の場合、解決された時間は合計補間時間と等しくなります。  
+  
+     最初のキー フレームの <xref:System.Windows.Media.Animation.KeyTime> が <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> で、このアニメーションに複数のキー フレームが含まれる場合、その <xref:System.Windows.Media.Animation.KeyTime> 値は 0 に解決されます。含まれるキー フレームが 1 つだけで、<xref:System.Windows.Media.Animation.KeyTime> 値が <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> の場合、その値は、前の手順で説明したように合計補間時間に解決されます。  
+  
+5.  残りの <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> <xref:System.Windows.Media.Animation.KeyTime> 値を解決します。これらの値には、それぞれ均等な時間が割り当てられます。  この処理の間、未解決の <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> <xref:System.Windows.Media.Animation.KeyTime> 値は一時的に <xref:System.Windows.Media.Animation.KeyTime.Uniform%2A> <xref:System.Windows.Media.Animation.KeyTime> 値として扱われ、一時的に解決された時間が割り当てられます。  
+  
+6.  キー時刻が指定されていないキー フレームの <xref:System.Windows.Media.Animation.KeyTime> 値を、そのキー フレームの最も近くで宣言されている、解決された <xref:System.Windows.Media.Animation.KeyTime> 値を持つキー フレームを使用して解決します。  
+  
+7.  残りの <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> <xref:System.Windows.Media.Animation.KeyTime> 値を解決します。  <xref:System.Windows.Media.Animation.KeyTime.Paced%2A> <xref:System.Windows.Media.Animation.KeyTime> では、隣接するキー フレームの <xref:System.Windows.Media.Animation.KeyTime> 値を使用して時間が解決されます。  これにより、アニメーションの速度がこのキー フレームの解決された時間を基に一定になります。  
+  
+8.  キー フレームを解決された時間 \(主キー\) の順に並べ替え、宣言 \(2 次キー\) の順に並べ替えます。つまり、解決されたキー フレームの <xref:System.Windows.Media.Animation.KeyTime> 値に基づく安定ソートを使用します。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.KeyTime>   
+ <xref:System.Windows.Media.Animation.KeySpline>   
+ <xref:System.Windows.Media.Animation.Timeline>   
+ [キー スプライン アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160011)   
+ [KeyFrame アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160012)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [キー フレームに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animation-how-to-topics.md)   
+ [タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/maximize-wpf-3d-performance.md b/docs/framework/wpf/graphics-multimedia/maximize-wpf-3d-performance.md
new file mode 100644
index 00000000000..973a605a797
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/maximize-wpf-3d-performance.md
@@ -0,0 +1,73 @@
+---
+title: "WPF の 3D パフォーマンスの最大化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "3-D グラフィックス [WPF]"
+ms.assetid: 4bcf949d-d92f-4d8d-8a9b-1e4c61b25bf6
+caps.latest.revision: 9
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# WPF の 3D パフォーマンスの最大化
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] を使用して 3D コントロールを構築し、アプリケーションに 3D シーンを含める場合は、パフォーマンスの最適化を検討することが重要です。このトピックでは、アプリケーションのパフォーマンスに影響を及ぼす可能性がある 3D クラスおよびプロパティを、使用する際のパフォーマンスの最適化に関する推奨事項と共に一覧にして示します。  
+  
+ このトピックは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] の 3D 機能に関する高度な専門知識があることを前提としています。  ここでの推奨事項は "描画層 2" に適用されます。これは、ピクセル シェーダーの Version 2.0 と頂点シェーダーの Version 2.0 をサポートするハードウェアとして大まかに定義されています。  詳細については、「[グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)」を参照してください。  
+  
+## パフォーマンスへの影響 : 高  
+  
+|||  
+|-|-|  
+|プロパティ|推奨事項|  
+|<xref:System.Windows.Media.Brush>|ブラシの処理速度 \(最高から最低への順\):<br /><br /> <xref:System.Windows.Media.SolidColorBrush><br /><br /> <xref:System.Windows.Media.LinearGradientBrush><br /><br /> <xref:System.Windows.Media.ImageBrush><br /><br /> <xref:System.Windows.Media.DrawingBrush> \(キャッシュ済み\)<br /><br /> <xref:System.Windows.Media.VisualBrush> \(キャッシュ済み\)<br /><br /> <xref:System.Windows.Media.RadialGradientBrush><br /><br /> <xref:System.Windows.Media.DrawingBrush> \(未キャッシュ\)<br /><br /> <xref:System.Windows.Media.VisualBrush> \(未キャッシュ\)|  
+|<xref:System.Windows.UIElement.ClipToBoundsProperty>|[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] で <xref:System.Windows.Controls.Viewport3D> のコンテンツを Viewport3D の四角形に明示的にクリップする必要がない場合は、`Viewport3D.ClipToBounds` を false に設定します。[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のアンチエイリアス クリッピングは非常に低速になることがあり、`ClipToBounds` は <xref:System.Windows.Controls.Viewport3D> に対して既定で有効 \(低速\) です。|  
+|<xref:System.Windows.UIElement.IsHitTestVisible%2A>|マウス ヒット テストを実行する際、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] で <xref:System.Windows.Controls.Viewport3D> のコンテンツを検討する必要がない場合は、`Viewport3D.IsHitTestVisible` を false に設定します。3D コンテンツのヒット テストはソフトウェアで行われ、メッシュが多いと低速になります。<xref:System.Windows.UIElement.IsHitTestVisible%2A> は <xref:System.Windows.Controls.Viewport3D> において既定で有効 \(低速\) です。|  
+|<xref:System.Windows.Media.Media3D.GeometryModel3D>|異なる素材または変換が必要な場合にのみ、異なるモデルを作成します。  それ以外の場合は、同じ素材や変換を使用する多数の <xref:System.Windows.Media.Media3D.GeometryModel3D> インスタンスを少ない数の <xref:System.Windows.Media.Media3D.GeometryModel3D> インスタンスや <xref:System.Windows.Media.Media3D.MeshGeometry3D> インスタンスにまとめます。|  
+|<xref:System.Windows.Media.Media3D.MeshGeometry3D>|メッシュ アニメーションでは、メッシュの個々の頂点がフレームごとに変更されますが、これは [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では必ずしも効率的ではありません。各頂点が変更されるときの変更通知によるパフォーマンスへの影響を最小限に抑えるには、頂点ごとの変更が行われる前に、メッシュを仮想ツリーから切断します。メッシュの変更が完了したら、再び仮想ツリーに接続します。また、この方法でアニメーション化されるメッシュのサイズができるだけ小さくなるようにしてください。|  
+|3D アンチエイリアシング|描画速度を向上させるには、<xref:System.Windows.Media.RenderOptions.EdgeMode%2A> 添付プロパティを `Aliased` に設定することで、<xref:System.Windows.Controls.Viewport3D> に対するマルチサンプリングを無効にします。  3D アンチエイリアシングは、[!INCLUDE[TLA#tla_winxp](../../../../includes/tlasharptla-winxp-md.md)] では既定で無効になっており、[!INCLUDE[TLA#tla_longhorn](../../../../includes/tlasharptla-longhorn-md.md)] では 4 サンプル\/ピクセルで有効になっています。|  
+|テキスト|3D シーンでのライブ テキスト \(ライブである理由はそれが <xref:System.Windows.Media.DrawingBrush> または <xref:System.Windows.Media.VisualBrush> に含まれているため\) は低速になる可能性があります。  テキストが変化しないのであれば、テキストのイメージを使用するようにしてください \(<xref:System.Windows.Media.Imaging.RenderTargetBitmap> を使用\)。|  
+|<xref:System.Windows.Media.TileBrush>|ブラシのコンテンツが静的ではないことが理由で、3D シーンで <xref:System.Windows.Media.VisualBrush> または <xref:System.Windows.Media.DrawingBrush> を使用する場合は、ブラシをキャッシュしてみてください \(<xref:System.Windows.Media.RenderOptions.CachingHint%2A> 添付プロパティを `Cache` に設定\)。  最小および最大スケールの無効化しきい値を設定することで \(<xref:System.Windows.Media.RenderOptions.CacheInvalidationThresholdMinimum%2A> 添付プロパティと <xref:System.Windows.Media.RenderOptions.CacheInvalidationThresholdMaximum%2A> 添付プロパティを使用\)、キャッシュされたブラシが頻繁に再生成されないようにすると同時に、望ましい品質レベルを維持します。  既定では <xref:System.Windows.Media.DrawingBrush> と <xref:System.Windows.Media.VisualBrush> はキャッシュされません。これは、そのブラシで何かが描画されるたびに、ブラシのコンテンツ全体がまず中間表面に再描画される必要があることを意味します。|  
+|<xref:System.Windows.Media.Effects.BitmapEffect>|<xref:System.Windows.Media.Effects.BitmapEffect> は、影響を受けるすべてのコンテンツが、ハードウェア アクセラレータなしで描画されることを強制します。  パフォーマンスを最適にするためには、<xref:System.Windows.Media.Effects.BitmapEffect> を使用しないでください。|  
+  
+## パフォーマンスへの影響 : 中  
+  
+|||  
+|-|-|  
+|プロパティ|推奨事項|  
+|<xref:System.Windows.Media.Media3D.MeshGeometry3D>|メッシュが頂点を共有して隣り合う三角形として定義されており、その頂点が同じ位置座標、標準座標、およびテクスチャ座標を持っている場合は、共有される各頂点を 1 回だけ定義し、三角形の定義には <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A> を持つインデックスを使用します。|  
+|<xref:System.Windows.Media.ImageBrush>|サイズを明示的にコントロールできる場合は \(<xref:System.Windows.Media.Imaging.RenderTargetBitmap> や <xref:System.Windows.Media.ImageBrush> を使用している場合\)、テクスチャ サイズをできるだけ小さくします。  テクスチャの解像度が低いと表示画質が低下するので、画質とパフォーマンスのバランスが適切になるようにしてください。|  
+|Opacity|半透明の 3D コンテンツ \(リフレクションなど\) を描画するときは、`Viewport3D.Opacity` を 1 未満の値に設定して半透明 <xref:System.Windows.Controls.Viewport3D> を別に作成するのではなく、ブラシや素材の不透明度プロパティを \(<xref:System.Windows.Media.Brush.Opacity%2A> または <xref:System.Windows.Media.Media3D.DiffuseMaterial.Color%2A> を介して\) 使用します。|  
+|<xref:System.Windows.Controls.Viewport3D>|シーンで使用する <xref:System.Windows.Controls.Viewport3D> オブジェクトの数を最小限に抑えます。  モデルごとに別個の Viewport3D を作成するのではなく、1 つの Viewport3D に多数の 3D モデルを組み込みます。|  
+|<xref:System.Windows.Freezable>|通常は、<xref:System.Windows.Media.Media3D.MeshGeometry3D>、<xref:System.Windows.Media.Media3D.GeometryModel3D>、Brush、および Material を再利用することをお勧めします。  どれも `Freezable` から派生しており、マルチペアレント可能です。|  
+|<xref:System.Windows.Freezable>|Freezable のプロパティがアプリケーションで変更されない場合は、Freezable に対して <xref:System.Windows.Freezable.Freeze%2A> を呼び出します。  フリーズさせることにより、作業セットが減り、処理速度が向上します。|  
+|<xref:System.Windows.Media.Brush>|ブラシのコンテンツが変化しない場合は、<xref:System.Windows.Media.VisualBrush> や <xref:System.Windows.Media.DrawingBrush> ではなく、<xref:System.Windows.Media.ImageBrush> を使用します。  2D コンテンツは、<xref:System.Windows.Media.Imaging.RenderTargetBitmap> を使用して <xref:System.Windows.Controls.Image> に変換してから <xref:System.Windows.Media.ImageBrush> で使用します。|  
+|<xref:System.Windows.Media.Media3D.GeometryModel3D.BackMaterial%2A>|<xref:System.Windows.Media.Media3D.GeometryModel3D> の背面を表示する必要が実際に発生しない限り、<xref:System.Windows.Media.Media3D.GeometryModel3D.BackMaterial%2A> は使用しないでください。|  
+|<xref:System.Windows.Media.Media3D.Light>|光源の処理速度 \(最高から最低への順\):<br /><br /> <xref:System.Windows.Media.Media3D.AmbientLight><br /><br /> <xref:System.Windows.Media.Media3D.DirectionalLight><br /><br /> <xref:System.Windows.Media.Media3D.PointLight><br /><br /> <xref:System.Windows.Media.Media3D.SpotLight>|  
+|<xref:System.Windows.Media.Media3D.MeshGeometry3D>|メッシュ サイズが次の制限を常に下回るようにしてください。<br /><br /> <xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A>: 20,001 <xref:System.Windows.Media.Media3D.Point3D> インスタンス<br /><br /> <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A>: 60,003 <xref:System.Int32> インスタンス|  
+|<xref:System.Windows.Media.Media3D.Material>|素材の処理速度 \(最高から最低への順\):<br /><br /> <xref:System.Windows.Media.Media3D.EmissiveMaterial><br /><br /> <xref:System.Windows.Media.Media3D.DiffuseMaterial><br /><br /> <xref:System.Windows.Media.Media3D.SpecularMaterial>|  
+|<xref:System.Windows.Media.Brush>|[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] 3D は、非表示のブラシ \(黒のアンビエント ブラシ、クリア ブラシなど\) をすべて同じように除外するわけではありません。これらについては、シーンで省略することを検討してください。|  
+|<xref:System.Windows.Media.Media3D.MaterialGroup>|<xref:System.Windows.Media.Media3D.MaterialGroup> の各 <xref:System.Windows.Media.Media3D.Material> により他のレンダリングが発生するので、素材を多数含めると、それがシンプルなものであったとしても、GPU の塗りつぶし要求が大幅に増加する可能性があります。  <xref:System.Windows.Media.Media3D.MaterialGroup> に含まれる素材の数を最小限に抑えてください。|  
+  
+## パフォーマンスへの影響 : 低  
+  
+|||  
+|-|-|  
+|プロパティ|推奨事項|  
+|<xref:System.Windows.Media.Media3D.Transform3DGroup>|アニメーションまたはデータ バインディングが不要の場合は、変換を複数含む変換グループを使用する代わりに、<xref:System.Windows.Media.Media3D.MatrixTransform3D> を 1 つだけ使用し、変換グループ内では個別に存在するすべての変換の積になるように設定します。|  
+|<xref:System.Windows.Media.Media3D.Light>|シーンに含まれる光源の数を最小限に抑えてください。  シーンに光源が多いと、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] はソフトウェアによる描画を使用します。制限は、およそ 110 <xref:System.Windows.Media.Media3D.DirectionalLight> オブジェクト、70 <xref:System.Windows.Media.Media3D.PointLight> オブジェクト、または 40 <xref:System.Windows.Media.Media3D.SpotLight> オブジェクトです。|  
+|<xref:System.Windows.Media.Media3D.ModelVisual3D>|移動するオブジェクトと静的オブジェクトは、別々の <xref:System.Windows.Media.Media3D.ModelVisual3D> インスタンスに含めて分離します。  ModelVisual3D は <xref:System.Windows.Media.Media3D.GeometryModel3D> より "重い" のですが、その理由は変換された境界をキャッシュするからです。  GeometryModel3D はモデル用に最適化されています。ModelVisual3D はシーン ノード用に最適化されています。  GeometryModel3D の共有インスタンスをシーンに追加するには ModelVisual3D を使用します。|  
+|<xref:System.Windows.Media.Media3D.Light>|シーンに含まれる光源の数を変更する回数を最小限に抑えてください。  光源の数を変更するたびに、シェーダーが再生成され、再コンパイルされます。ただし、この構成が前に終了されている \(したがってシェーダーがキャッシュされている\) 場合を除きます。|  
+|Light|黒い光は見えませんが、描画時間には加算されるので、省略することを検討してください。|  
+|<xref:System.Windows.Media.Media3D.MeshGeometry3D>|MeshGeometry3D の <xref:System.Windows.Media.Media3D.MeshGeometry3D.Positions%2A>、<xref:System.Windows.Media.Media3D.MeshGeometry3D.Normals%2A>、<xref:System.Windows.Media.Media3D.MeshGeometry3D.TextureCoordinates%2A>、および <xref:System.Windows.Media.Media3D.MeshGeometry3D.TriangleIndices%2A> など、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] に含まれる大規模なコレクションの構築時間を最小限に抑えるには、値を読み込む前に、コレクションのサイズを事前に指定します。  可能であれば、コレクションのコンストラクターに、List の配列など、事前に読み込まれているデータ構造体を渡します。|  
+  
+## 参照  
+ [3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/media/absolute-and-relative-viewports.png b/docs/framework/wpf/graphics-multimedia/media/absolute-and-relative-viewports.png
new file mode 100644
index 00000000000..25cbe55431b
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/absolute-and-relative-viewports.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/camera-projections4.png b/docs/framework/wpf/graphics-multimedia/media/camera-projections4.png
new file mode 100644
index 00000000000..8bd73be251c
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/camera-projections4.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/coordsystem-1.png b/docs/framework/wpf/graphics-multimedia/media/coordsystem-1.png
new file mode 100644
index 00000000000..7c698ab3a0e
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/coordsystem-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/coordsystem-6.png b/docs/framework/wpf/graphics-multimedia/media/coordsystem-6.png
new file mode 100644
index 00000000000..2d8048a5bd2
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/coordsystem-6.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/fillruleclosedshapes.png b/docs/framework/wpf/graphics-multimedia/media/fillruleclosedshapes.png
new file mode 100644
index 00000000000..82fa8150cff
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/fillruleclosedshapes.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/fillruleevenodd2.png b/docs/framework/wpf/graphics-multimedia/media/fillruleevenodd2.png
new file mode 100644
index 00000000000..e4136706863
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/fillruleevenodd2.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/fillrulenonzero4.png b/docs/framework/wpf/graphics-multimedia/media/fillrulenonzero4.png
new file mode 100644
index 00000000000..5784a316c90
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/fillrulenonzero4.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-3timelines.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-3timelines.png
new file mode 100644
index 00000000000..88c96c5d2d2
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-3timelines.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clipexample.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clipexample.png
new file mode 100644
index 00000000000..698af603d7c
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clipexample.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-1clock1prop.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-1clock1prop.png
new file mode 100644
index 00000000000..8c7b2b9634d
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-1clock1prop.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1clockgroup2prop.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1clockgroup2prop.png
new file mode 100644
index 00000000000..ae13d8692de
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1clockgroup2prop.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1prop.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1prop.png
new file mode 100644
index 00000000000..fe5dfccbb59
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-clocks-2clock1prop.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-dpi-setting-examples.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-dpi-setting-examples.png
new file mode 100644
index 00000000000..cc5a659cbc3
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-dpi-setting-examples.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawinggroup-guidelineset.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawinggroup-guidelineset.png
new file mode 100644
index 00000000000..0478b7c7746
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-drawinggroup-guidelineset.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime1-timespan.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime1-timespan.png
new file mode 100644
index 00000000000..1dc938418c2
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime1-timespan.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime2-percentage.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime2-percentage.png
new file mode 100644
index 00000000000..ef37e746542
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime2-percentage.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime3-uniform.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime3-uniform.png
new file mode 100644
index 00000000000..dee40361a4a
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime3-uniform.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime4-paced.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime4-paced.png
new file mode 100644
index 00000000000..f372675474f
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyframe-keytime4-paced.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-0-1-1-0.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-0-1-1-0.png
new file mode 100644
index 00000000000..d600974b91a
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-0-1-1-0.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-025-050-075-10.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-025-050-075-10.png
new file mode 100644
index 00000000000..d5639b0405e
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-keyspline-025-050-075-10.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexamplebottomrighttiled.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexamplebottomrighttiled.png
new file mode 100644
index 00000000000..1db30ee7a0a
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexamplebottomrighttiled.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexampletoplefttiled.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexampletoplefttiled.png
new file mode 100644
index 00000000000..0fee43800c5
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tilebrushalignmentexampletoplefttiled.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tiledprojection.png b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tiledprojection.png
new file mode 100644
index 00000000000..2ca7e7e2a5a
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/graphicsmm-tiledprojection.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/ie7glasstopbar.PNG b/docs/framework/wpf/graphics-multimedia/media/ie7glasstopbar.PNG
new file mode 100644
index 00000000000..7c1835644e9
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/ie7glasstopbar.PNG differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/intersectiondetail01.png b/docs/framework/wpf/graphics-multimedia/media/intersectiondetail01.png
new file mode 100644
index 00000000000..86bf178b8c1
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/intersectiondetail01.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/threecubes-rotationwithcenter-1.png b/docs/framework/wpf/graphics-multimedia/media/threecubes-rotationwithcenter-1.png
new file mode 100644
index 00000000000..da821f81f6b
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/threecubes-rotationwithcenter-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/threecubes-scaledwithcenter-1.png b/docs/framework/wpf/graphics-multimedia/media/threecubes-scaledwithcenter-1.png
new file mode 100644
index 00000000000..6d3d962c845
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/threecubes-scaledwithcenter-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/threecubes-uniformscale-1.png b/docs/framework/wpf/graphics-multimedia/media/threecubes-uniformscale-1.png
new file mode 100644
index 00000000000..5b9b7675d31
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/threecubes-uniformscale-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/transforms-translate.png b/docs/framework/wpf/graphics-multimedia/media/transforms-translate.png
new file mode 100644
index 00000000000..8515dec170e
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/transforms-translate.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/twocubes-rotation2axes-1.png b/docs/framework/wpf/graphics-multimedia/media/twocubes-rotation2axes-1.png
new file mode 100644
index 00000000000..fabcda63314
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/twocubes-rotation2axes-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/vectorgraphics01.png b/docs/framework/wpf/graphics-multimedia/media/vectorgraphics01.png
new file mode 100644
index 00000000000..d9a741c58c5
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/vectorgraphics01.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/visualclass01.png b/docs/framework/wpf/graphics-multimedia/media/visualclass01.png
new file mode 100644
index 00000000000..9029b2d6704
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/visualclass01.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview01.png b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview01.png
new file mode 100644
index 00000000000..30cc845ac45
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview01.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview02.png b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview02.png
new file mode 100644
index 00000000000..7db3b046ac9
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview02.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview04.png b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview04.png
new file mode 100644
index 00000000000..3c6a010429c
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/visuallayeroverview04.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/visualoffset-01.png b/docs/framework/wpf/graphics-multimedia/media/visualoffset-01.png
new file mode 100644
index 00000000000..9dc86f52688
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/visualoffset-01.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-drawingbrushasopacitymask.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-drawingbrushasopacitymask.png
new file mode 100644
index 00000000000..12eb1bad5b7
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-drawingbrushasopacitymask.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops-rg.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops-rg.png
new file mode 100644
index 00000000000..ca55b094e0d
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops-rg.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops.png
new file mode 100644
index 00000000000..ac0a57a15fb
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-diagonalgradientaxis.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-diagonalgradientaxis.png
new file mode 100644
index 00000000000..8a170a8ce88
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-diagonalgradientaxis.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-imageasopacitymask.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-imageasopacitymask.png
new file mode 100644
index 00000000000..546eeddc45e
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-imageasopacitymask.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-opacitymask-imageexample.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-opacitymask-imageexample.png
new file mode 100644
index 00000000000..f9bc41278a1
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-opacitymask-imageexample.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-transformandrelativetransform.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-transformandrelativetransform.png
new file mode 100644
index 00000000000..a58085fa396
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-transformandrelativetransform.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-defaultcontentprojection2.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-defaultcontentprojection2.png
new file mode 100644
index 00000000000..b22b4cdbefe
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-defaultcontentprojection2.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-1.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-1.png
new file mode 100644
index 00000000000..9e230839cfa
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-1.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-2.png b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-2.png
new file mode 100644
index 00000000000..198b3adad1c
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-visuals-hittest-2.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/media/wpfperf-visualprofiler-04.png b/docs/framework/wpf/graphics-multimedia/media/wpfperf-visualprofiler-04.png
new file mode 100644
index 00000000000..03a49285123
Binary files /dev/null and b/docs/framework/wpf/graphics-multimedia/media/wpfperf-visualprofiler-04.png differ
diff --git a/docs/framework/wpf/graphics-multimedia/multimedia-overview.md b/docs/framework/wpf/graphics-multimedia/multimedia-overview.md
new file mode 100644
index 00000000000..d3474d27ff2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/multimedia-overview.md
@@ -0,0 +1,125 @@
+---
+title: "マルチメディアの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "メディア"
+  - "マルチメディア"
+ms.assetid: feb25b15-d741-4ac3-818f-1b19f63a3562
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# マルチメディアの概要
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のマルチメディア機能を使用すると、オーディオおよびビデオをアプリケーションに統合し、ユーザー エクスペリエンスを向上させることができます。ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のマルチメディア機能について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="mediaapi"></a>   
+## メディア API  
+ <xref:System.Windows.Controls.MediaElement> クラスと <xref:System.Windows.Media.MediaPlayer> クラスは、オーディオ コンテンツまたはビデオ コンテンツの表示に使用されます。  これらのクラスは対話型またはクロックでの制御に対応しています。  これらのクラスは、[!INCLUDE[TLA#tla_wmp](../../../../includes/tlasharptla-wmp-md.md)] 10 コントロールでメディアを再生するために使用できます。シナリオに応じてクラスを使い分けてください。  
+  
+ <xref:System.Windows.Controls.MediaElement> は、[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)によってサポートされる <xref:System.Windows.UIElement> で、多数のコントロールのコンテンツとして使用できます。  また、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] およびコードで使用できます。一方、<xref:System.Windows.Media.MediaPlayer> は、<xref:System.Windows.Media.Drawing> オブジェクト向けに設計されており、レイアウト サポートはありません。  <xref:System.Windows.Media.MediaPlayer> を使用して読み込まれたメディアは、<xref:System.Windows.Media.VideoDrawing> を使用するか、<xref:System.Windows.Media.DrawingContext> と直接対話することによってのみ再生できます。  <xref:System.Windows.Media.MediaPlayer> は、XAML では使用できません。  
+  
+ 描画オブジェクトおよび描画コンテキストの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  アプリケーションでメディアを配布する場合、メディア ファイルをプロジェクト リソースとして使用することはできません。  代わりにプロジェクト ファイルでメディアの種類を `Content` に設定し、`CopyToOutputDirectory` を `PreserveNewest` または `Always` に設定する必要があります。  
+  
+<a name="mediaplaybackmodes"></a>   
+## メディアの再生モード  
+  
+> [!NOTE]
+>  <xref:System.Windows.Controls.MediaElement> および <xref:System.Windows.Media.MediaPlayer> には、同様のメンバーが含まれています。  このセクション内のリンクは、<xref:System.Windows.Controls.MediaElement> クラス メンバーを参照しています。  特に記載のない限り、<xref:System.Windows.Controls.MediaElement> クラス内にリンクされているメンバーは、<xref:System.Windows.Media.MediaPlayer> クラス内にもあります。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でのメディアの再生を理解するには、メディアを再生可能な異なるモードについて理解している必要があります。  <xref:System.Windows.Controls.MediaElement> および <xref:System.Windows.Media.MediaPlayer> は、独立モードとクロック モードの 2 つのメディア モードで使用できます。  メディア モードは、<xref:System.Windows.Controls.MediaElement.Clock%2A> プロパティによって決定されます。  <xref:System.Windows.Controls.MediaElement.Clock%2A> が `null` の場合、メディア オブジェクトは独立モードです。  <xref:System.Windows.Controls.MediaElement.Clock%2A> が null 以外の場合、メディア オブジェクトはクロック モードです。  既定では、メディア オブジェクトは独立モードです。  
+  
+### 独立モード  
+ 独立モードでは、メディア コンテンツによってメディアの再生が実行されます。  独立モードは次のオプションを有効にします。  
+  
+-   メディアの <xref:System.Uri> を直接指定することができます。  
+  
+-   メディアの再生を直接制御できます。  
+  
+-   メディアの <xref:System.Windows.Controls.MediaElement.Position%2A> プロパティと <xref:System.Windows.Controls.MediaElement.SpeedRatio%2A> プロパティを変更できます。  
+  
+ メディアは、<xref:System.Windows.Controls.MediaElement> オブジェクトの <xref:System.Windows.Controls.MediaElement.Source%2A> プロパティを設定すること、または <xref:System.Windows.Media.MediaPlayer> オブジェクトの <xref:System.Windows.Media.MediaPlayer.Open%2A> メソッドを呼び出すことのいずれかによって読み込まれます。  
+  
+ 独立モードでメディアの再生を制御するために、メディア オブジェクトのコントロール メソッドを使用することはできません。  使用可能なコントロール メソッドは、<xref:System.Windows.Controls.MediaElement.Play%2A>、<xref:System.Windows.Controls.MediaElement.Pause%2A>、<xref:System.Windows.Controls.MediaElement.Close%2A>、<xref:System.Windows.Controls.MediaElement.Stop%2A> です。  <xref:System.Windows.Controls.MediaElement> では、これらのメソッドを使用して対話的に制御できるのは、<xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> が <xref:System.Windows.Controls.MediaState> に設定されている場合です。  メディア オブジェクトがクロック モードの場合、これらのメソッドは使用できません。  
+  
+ 独立モードの使用例については、「[MediaElement \(再生、一時停止、停止、ボリューム、および速度\) を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-play-pause-stop-volume-and-speed.md)」を参照してください。  
+  
+### クロック モード  
+ クロック モードでは、<xref:System.Windows.Media.MediaTimeline> によって、メディアの再生が実行されます。  クロック モードには次の特徴があります。  
+  
+-   メディアの <xref:System.Uri> は、<xref:System.Windows.Media.MediaTimeline> を通じて間接的に設定されます。  
+  
+-   メディアの再生をクロックで制御できます。  メディア オブジェクトのコントロール メソッドは使用できません。  
+  
+-   メディアは、<xref:System.Windows.Media.MediaTimeline> オブジェクトの <xref:System.Windows.Media.MediaTimeline.Source%2A> プロパティを設定すること、タイムラインからクロックを作成すること、およびメディア オブジェクトにクロックを割り当てることによって読み込まれます。  <xref:System.Windows.Media.Animation.Storyboard> 内の <xref:System.Windows.Media.MediaTimeline> が <xref:System.Windows.Controls.MediaElement> をターゲットとする場合にも、メディアはこの方法によって読み込まれます。  
+  
+ クロック モードでメディアの再生を制御するには、<xref:System.Windows.Media.Animation.ClockController> コントロール メソッドを使用する必要があります。  <xref:System.Windows.Media.Animation.ClockController> は、<xref:System.Windows.Media.MediaClock> の <xref:System.Windows.Media.Animation.ClockController> プロパティから取得します。  クロック モードで <xref:System.Windows.Controls.MediaElement> オブジェクトまたは <xref:System.Windows.Media.MediaPlayer> オブジェクトのいずれかのコントロール メソッドを使用しようとすると、<xref:System.InvalidOperationException> がスローされます。  
+  
+ クロックとタイムラインの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+ クロック モードの使用例については、「[ストーリーボードを使用して MediaElement を制御する](../../../../docs/framework/wpf/graphics-multimedia/how-to-control-a-mediaelement-by-using-a-storyboard.md)」を参照してください。  
+  
+<a name="mediaelement"></a>   
+## MediaElement クラス  
+ アプリケーションへのメディアの追加は、アプリケーションの[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に <xref:System.Windows.Controls.MediaElement> コントロールを追加し、含めるメディアに <xref:System.Uri> を提供するというように簡単に行うことができます。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、[!INCLUDE[TLA#tla_wmp](../../../../includes/tlasharptla-wmp-md.md)] 10 でサポートされているすべての種類のメディアがサポートされています。[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] で、<xref:System.Windows.Controls.MediaElement> を簡単に使用する例を次に示します。  
+  
+ [!code-xml[MediaElement_snip#SimpleMediaElementUsageWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/MediaElement_snip/CSharp/SimpleUsage.xaml#simplemediaelementusagewholepage)]  
+  
+ このサンプルでは、メディアは、読み込まれるとすぐに自動的に再生されます。  再生が終わると、メディアは閉じられ、すべてのメディア リソース \(ビデオ メモリを含む\) は解放されます。  これは、<xref:System.Windows.Controls.MediaElement> オブジェクトの既定の動作で、<xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> プロパティと <xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A> プロパティによって制御されます。  
+  
+### MediaElement の制御  
+ <xref:System.Windows.FrameworkElement.IsLoaded%2A> が `true` または `false` のとき、それぞれ、<xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> プロパティと <xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A> プロパティは、<xref:System.Windows.Controls.MediaElement> の動作を制御します。  プロパティで設定される <xref:System.Windows.Controls.MediaState> は、メディアの再生動作に影響します。  たとえば、既定の <xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> は <xref:System.Windows.Controls.MediaState> で、既定の <xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A> は <xref:System.Windows.Controls.MediaState> です。  したがって、<xref:System.Windows.Controls.MediaElement> が読み込まれ、[プリロール](GTMT)が完了するとすぐにメディアは再生を始めます。  再生が終わるとメディアは閉じられ、すべてのメディア リソースは解放されます。  
+  
+ <xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> プロパティと <xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A> プロパティ以外にも、メディアの再生を制御する方法があります。  クロック モードでは、クロックによって <xref:System.Windows.Controls.MediaElement> を制御できるほか、<xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> が <xref:System.Windows.Controls.MediaState> の場合は、コントロール メソッドで対話的に制御できます。  <xref:System.Windows.Controls.MediaElement> は、制御に対するこのような競合を、次の優先順位によって解決します。  
+  
+1.  <xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A>.  メディアがアンロードされた場合。  すべてのメディア リソースが、既定で解放されます。<xref:System.Windows.Media.MediaClock> が <xref:System.Windows.Controls.MediaElement> に関連付けられているときでも同様です。  
+  
+2.  <xref:System.Windows.Media.MediaClock>.  メディアに <xref:System.Windows.Controls.MediaElement.Clock%2A> が含まれている場合に有効になります。  メディアがアンロードされた場合、<xref:System.Windows.Controls.MediaElement.UnloadedBehavior%2A> が <xref:System.Windows.Controls.MediaState> である限り、<xref:System.Windows.Media.MediaClock> が有効になります。  クロック モードは、<xref:System.Windows.Controls.MediaElement> が読み込まれたときの動作を常にオーバーライドします。  
+  
+3.  <xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A>.  メディアが読み込まれた場合。  
+  
+4.  対話型コントロール メソッド。  <xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> が <xref:System.Windows.Controls.MediaState> の場合。  使用可能なコントロール メソッドは、<xref:System.Windows.Controls.MediaElement.Play%2A>、<xref:System.Windows.Controls.MediaElement.Pause%2A>、<xref:System.Windows.Controls.MediaElement.Close%2A>、<xref:System.Windows.Controls.MediaElement.Stop%2A> です。  
+  
+### MediaElement の表示  
+ <xref:System.Windows.Controls.MediaElement> を表示するには、描画されるコンテンツが必要で、コンテンツが読み込まれるまでは、その <xref:System.Windows.FrameworkElement.ActualWidth%2A> プロパティと <xref:System.Windows.FrameworkElement.ActualHeight%2A> プロパティは 0 に設定されます。  オーディオのみのコンテンツでは、これらのプロパティは常に 0 です。  ビデオ コンテンツでは、<xref:System.Windows.Controls.MediaElement.MediaOpened> イベントが発生すると、<xref:System.Windows.FrameworkElement.ActualWidth%2A> と <xref:System.Windows.FrameworkElement.ActualHeight%2A> は読み込まれたメディアのサイズを報告します。  したがって、メディアが読み込まれるまでは、<xref:System.Windows.FrameworkElement.Width%2A> プロパティまたは <xref:System.Windows.FrameworkElement.Height%2A> プロパティが設定されていない限り、<xref:System.Windows.Controls.MediaElement> は [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] 内の物理的なスペースを占めません。  
+  
+ <xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティの両方を設定すると、メディアは、<xref:System.Windows.Controls.MediaElement> に提供された領域に合うように引き伸ばされます。  メディアの元の[縦横比](GTMT)を維持するには、<xref:System.Windows.FrameworkElement.Width%2A> プロパティまたは <xref:System.Windows.FrameworkElement.Height%2A> プロパティのいずれか一方のみを設定する必要があります。  <xref:System.Windows.FrameworkElement.Width%2A> プロパティと <xref:System.Windows.FrameworkElement.Height%2A> プロパティの両方を設定すると、メディアが要素の固定サイズに含まれ、望ましくない場合もあります。  
+  
+ 固定サイズの要素を含まないようにするため、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] では、メディアを[プリロール](GTMT)することができます。  これを行うには、<xref:System.Windows.Controls.MediaElement.LoadedBehavior%2A> を <xref:System.Windows.Controls.MediaState> または <xref:System.Windows.Controls.MediaState> のいずれかに設定します。  <xref:System.Windows.Controls.MediaState> 状態では、メディアはプリロールされ、最初のフレームが表示されます。  <xref:System.Windows.Controls.MediaState> 状態では、メディアは[プリロール](GTMT)され、再生が始まります。  
+  
+<a name="mediaplayer"></a>   
+## MediaPlayer クラス  
+ <xref:System.Windows.Controls.MediaElement> クラスはフレームワーク要素ですが、<xref:System.Windows.Media.MediaPlayer> クラスは <xref:System.Windows.Media.Drawing> オブジェクトで使用するために設計されています。  Drawing オブジェクトは、パフォーマンス上の利点を得るためにフレームワーク レベルの機能を犠牲にしてもかまわない場合や、<xref:System.Windows.Freezable> 機能が必要な場合に使用されます。  <xref:System.Windows.Media.MediaPlayer> を使用すると、メディア コンテンツをアプリケーションに提供すると共に、これらの機能を利用できます。  <xref:System.Windows.Controls.MediaElement> と同様に、<xref:System.Windows.Media.MediaPlayer> は、独立モードまたはクロック モードで使用できますが、<xref:System.Windows.Controls.MediaElement> オブジェクトのアンロードされた状態および読み込まれた状態はありません。  これにより、<xref:System.Windows.Media.MediaPlayer> の再生制御の複雑さが軽減されています。  
+  
+### MediaPlayer の制御  
+ <xref:System.Windows.Media.MediaPlayer> はステートレスであるため、メディアの再生を制御するには 2 つの方法しかありません。  
+  
+1.  対話型コントロール メソッド。  独立モード \(`null` <xref:System.Windows.Media.MediaPlayer.Clock%2A> プロパティ\) の場合。  
+  
+2.  <xref:System.Windows.Media.MediaClock>.  メディアに <xref:System.Windows.Media.MediaPlayer.Clock%2A> が含まれている場合に有効になります。  
+  
+### MediaPlayer の表示  
+ 技術的に、<xref:System.Windows.Media.MediaPlayer> は、物理的な形式を持たないため表示することはできません。  ただし、<xref:System.Windows.Media.VideoDrawing> クラスを使用して、<xref:System.Windows.Media.Drawing> でメディアを提供するために使用することはできます。  <xref:System.Windows.Media.VideoDrawing> を使用してメディアを表示する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#VideoDrawingExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/VideoDrawingExample.cs#videodrawingexampleinline)]  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingGroup>   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/audio-and-video-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/opacity-masks-overview.md b/docs/framework/wpf/graphics-multimedia/opacity-masks-overview.md
new file mode 100644
index 00000000000..f532af3d1f1
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/opacity-masks-overview.md
@@ -0,0 +1,152 @@
+---
+title: "不透明マスクの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 不透明マスク"
+  - "マスク, 不透明"
+  - "不透明, マスク"
+ms.assetid: 22367fab-5f59-4583-abfd-db2bf86eaef7
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 不透明マスクの概要
+不透明マスクを使用すると、要素またはビジュアルの一部分を透明または部分的に透明にすることができます。  不透明マスクを作成するには、要素または <xref:System.Windows.Media.Visual> の <xref:System.Windows.UIElement.OpacityMask%2A> プロパティに <xref:System.Windows.Media.Brush> を適用します。  ブラシは要素またはビジュアルにマップされ、各ブラシのピクセルの不透明度の値を使用して、要素またはビジュアルの対応する各ピクセルの不透明度が決定されます。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [必要条件](#prereqs)  
+  
+-   [不透明マスクを用いた視覚効果の作成](#opacitymasks)  
+  
+-   [不透明マスクの作成](#creatingopacitymasks)  
+  
+-   [不透明マスクとしてのグラデーションの使用](#creatingopacitymaskswithgradients)  
+  
+-   [不透明マスクでのグラデーションの終了位置の指定](#specifyinggradientcolors)  
+  
+-   [不透明マスクとしてのイメージの使用](#usingimageasopacitymask)  
+  
+-   [描画から不透明マスクを作成](#drawingbrushasopacitymask)  
+  
+-   [関連トピック](#seeAlsoToggle)  
+  
+<a name="prereqs"></a>   
+## 必要条件  
+ この概要では、<xref:System.Windows.Media.Brush> オブジェクトに精通していることを前提にしています。  ブラシの使用の概要については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  <xref:System.Windows.Media.ImageBrush> と <xref:System.Windows.Media.DrawingBrush> の詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="opacitymasks"></a>   
+## 不透明マスクを用いた視覚効果の作成  
+ 不透明マスクは、そのコンテンツを要素またはビジュアルにマップすることによって機能します。  さらに、ブラシの各ピクセルの[アルファ チャネル](GTMT)を使用して、要素またはビジュアルの対応するピクセルの不透明度を決定します。ブラシの実際の色は無視されます。  ブラシの指定された部分が透明の場合、要素またはビジュアルの対応する部分は透明になります。  ブラシの指定された部分が不透明の場合、要素またはビジュアルの対応する部分の不透明度は変更されません。  不透明マスクによって指定される不透明度は、要素またはビジュアル内に含まれている不透明度の設定と結合されます。  たとえば、不透明度 25% の要素に、完全に不透明から完全に透明まで遷移する不透明マスクが適用された場合、要素は 25% の不透明度から完全な透明まで遷移します。  
+  
+> [!NOTE]
+>  この概要では、イメージ要素で不透明マスクを使用する例を示していますが、不透明マスクはパネルやコントロールなどの任意の要素または <xref:System.Windows.Media.Visual> に適用できます。  
+  
+ 不透明マスクを使用すると、ビューから消えるイメージまたはボタンを作成する、要素にテクスチャを追加する、あるいはグラデーションを組み合わせてガラスのような表面を生成するなど、人の目をひく視覚効果を作成できます。  不透明マスクの使用方法を次の図に示します。  格子模様の背景はマスクの透過部分を表しています。  
+  
+ ![LinearGradientBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-opacitymask-imageexample.png "wcpsdk\_graphicsmm\_opacitymask\_imageexample")  
+不透明マスクの例  
+  
+<a name="creatingopacitymasks"></a>   
+## 不透明マスクの作成  
+ 不透明マスクを作成するには、<xref:System.Windows.Media.Brush> を作成し、要素またはビジュアルの <xref:System.Windows.UIElement.OpacityMask%2A> プロパティに適用します。  任意の種類の <xref:System.Windows.Media.Brush> を不透明マスクとして使用できます。  
+  
+-   <xref:System.Windows.Media.LinearGradientBrush>、<xref:System.Windows.Media.RadialGradientBrush> : 要素またはビジュアルをビューから消すために使用します。  
+  
+     次の例は、不透明マスクとして使用された <xref:System.Windows.Media.LinearGradientBrush> を示しています。  
+  
+     ![LinearGradientBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-brushes-lineagradientopacitymasksingle.png "wcpsdk\_graphicsmm\_brushes\_lineagradientopacitymasksingle")  
+LinearGradientBrush 不透明マスクの例  
+  
+-   <xref:System.Windows.Media.ImageBrush> : ぼかし、またはぎざぎざのエッジ効果を作成するために使用します。  
+  
+     次の例は、不透明マスクとして使用された <xref:System.Windows.Media.ImageBrush> を示しています。  
+  
+     ![ImageBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-brushes-imageasopacitymasksingle.png "wcpsdk\_graphicsmm\_brushes\_imageasopacitymasksingle")  
+LinearGradientBrush 不透明マスクの例  
+  
+-   <xref:System.Windows.Media.DrawingBrush> : 図形、イメージ、およびグラデーションのパターンから複雑な不透明マスクを作成する場合に使用します。  
+  
+     次の例は、不透明マスクとして使用された <xref:System.Windows.Media.DrawingBrush> を示しています。  
+  
+     ![DrawingBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-drawingbrushasopacitymask-single.png "wcpsdk\_drawingbrushasopacitymask\_single")  
+DrawingBrush 不透明マスクの例  
+  
+ グラデーション ブラシ \(<xref:System.Windows.Media.LinearGradientBrush> および <xref:System.Windows.Media.RadialGradientBrush>\) は、不透明マスクとして使用するのに特に適しています。  <xref:System.Windows.Media.SolidColorBrush> は均一な色で領域を塗りつぶすため、不透明マスクには適していません。<xref:System.Windows.Media.SolidColorBrush> を使用することは、要素またはビジュアルの <xref:System.Windows.UIElement.OpacityMask%2A> プロパティを設定することと同じです。  
+  
+<a name="creatingopacitymaskswithgradients"></a>   
+## 不透明マスクとしてのグラデーションの使用  
+ グラデーションの塗りつぶしを作成するには、グラデーションの複数の終了位置を指定します。  グラデーションの各終了位置には、色および位置の記述が含まれます \(グラデーションの作成および使用の詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください\)。  このプロセスは、グラデーションを不透明マスクとして使用する場合も同様ですが、不透明マスクのグラデーションの場合は色をブレンドするのではなく、アルファ チャネル値をブレンドします。  したがって、グラデーションのコンテンツの実際の色は無視されます。それぞれの色のアルファ チャネルまたは不透明度だけが意味を持ちます。  例を次に示します。  
+  
+ [!code-xml[OpacityMasksExample#LinearGradientOpacityMaskonImage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/GradientBrushExample.xaml#lineargradientopacitymaskonimage)]
+ [!code-xml[OpacityMasksExample#LinearGradientOpacityMaskonImage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/GradientBrushExample.xaml#lineargradientopacitymaskonimage)]  
+  
+<a name="specifyinggradientcolors"></a>   
+## 不透明マスクでのグラデーションの終了位置の指定  
+ 前の例では、システム定義色の <xref:System.Windows.Media.Colors.Black%2A> がグラデーションの開始色として使用されています。  <xref:System.Windows.Media.Colors.Transparent%2A> を除き、<xref:System.Windows.Media.Colors> クラスのすべての色は完全に不透明であるため、これらを使用するとグラデーションの不透明マスクの開始色を簡単に定義できます。  
+  
+ 不透明マスクを定義する際にアルファ値をさらに細かく制御するために、マークアップ内で [!INCLUDE[TLA#tla_argb](../../../../includes/tlasharptla-argb-md.md)] の 16 進数表記を使用したり、<xref:System.Windows.Media.Color.FromScRgb%2A?displayProperty=fullName> メソッドを使用して、色のアルファ チャネルを指定できます。  
+  
+<a name="argbsyntax"></a>   
+### "XAML" での色の透過度の指定  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、[!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] 16 進数表記を使用して、個別の色の透過度を指定します。  [!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] の 16 進数表記では次の構文が使用されます。  
+  
+ `#`**aa** *rrggbb*  
+  
+ この構文の *aa* は、色の不透明度を指定する 2 桁の 16 進数の値を表します。  *rr*、*gg*、*bb* はそれぞれ、赤、緑、青の各色の量を指定する 2 桁の 16 進数を表します。  16 進数の各桁には、0 から 9、または A から F の値を指定できます。  0 が最小値で、F が最大値になります。  00 のアルファ値は、完全に透明な色の指定、FF のアルファ値は、完全に不透明な色の指定を表します。  次の例に、16 進数の [!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] 表記を使用した 2 種類の色の指定方法を示します。  1 つ目には完全に不透明な色を指定し、2 つ目には完全に透明な色を指定しています。  
+  
+ [!code-xml[OpacityMasksExample#AARRGGBBValueonOpacityMask](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/GradientBrushExample.xaml#aarrggbbvalueonopacitymask)]
+ [!code-xml[OpacityMasksExample#AARRGGBBValueonOpacityMask](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/GradientBrushExample.xaml#aarrggbbvalueonopacitymask)]  
+  
+<a name="usingimageasopacitymask"></a>   
+## 不透明マスクとしてのイメージの使用  
+ イメージも不透明マスクとして使用できます。  例を次に示します。  格子模様の背景はマスクの透過部分を表しています。  
+  
+ ![ImageBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-imageasopacitymask.png "wcpsdk\_graphicsmm\_imageasopacitymask")  
+不透明マスクの例  
+  
+ イメージを不透明マスクとして使用するには、イメージを格納する <xref:System.Windows.Media.ImageBrush> を使用します。  不透明マスクとして使用するイメージを作成する場合は、複数の透過性レベルをサポートしている[!INCLUDE[TLA#tla_png](../../../../includes/tlasharptla-png-md.md)] などの形式でイメージを保存してください。  前の図を作成するために使用するコード例を次に示します。  
+  
+ [!code-xml[OpacityMasksExample#UIElementOpacityMask](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/ImageBrushExample.xaml#uielementopacitymask)]
+ [!code-xml[OpacityMasksExample#UIElementOpacityMask](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/ImageBrushExample.xaml#uielementopacitymask)]  
+  
+<a name="tilingimageopacitymask"></a>   
+### 不透明マスクとしての並べて表示されたイメージの使用  
+ 次の例では、同じイメージを別の <xref:System.Windows.Media.ImageBrush> で使用していますが、ブラシを並べて表示する機能を使用して、50 x 50 ピクセルのイメージのタイルを生成しています。  
+  
+ [!code-xml[OpacityMasksExample#TiledImageasOpacityMask](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/ImageBrushExample.xaml#tiledimageasopacitymask)]
+ [!code-xml[OpacityMasksExample#TiledImageasOpacityMask](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/ImageBrushExample.xaml#tiledimageasopacitymask)]  
+  
+<a name="drawingbrushasopacitymask"></a>   
+## 描画から不透明マスクを作成  
+ 描画を不透明マスクとして使用できます。  描画内に含まれる図形は、グラデーション、純色、イメージ、または他の描画を使用して塗りつぶすことができます。  次の例は、不透明マスクとして使用された描画を示しています。  格子模様の背景はマスクの透過部分を表しています。  
+  
+ ![DrawingBrush 不透明マスクを持つオブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-drawingbrushasopacitymask.png "wcpsdk\_drawingbrushasopacitymask")  
+DrawingBrush 不透明マスクの例  
+  
+ 描画を不透明マスクとして使用するには、描画を格納する <xref:System.Windows.Media.DrawingBrush> を使用します。  前の図を作成するために使用するコード例を次に示します。  
+  
+ [!code-xml[OpacityMasksExample#OpacityMaskfromDrawing](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/DrawingBrushExample.xaml#opacitymaskfromdrawing)]
+ [!code-xml[OpacityMasksExample#OpacityMaskfromDrawing](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/DrawingBrushExample.xaml#opacitymaskfromdrawing)]  
+  
+<a name="tileddrawingbrush"></a>   
+### 不透明マスクとしての並べて表示された描画の使用  
+ <xref:System.Windows.Media.ImageBrush> と同様に、<xref:System.Windows.Media.DrawingBrush> によって描画を並べることができます。  次の例では、描画ブラシを使用して、並べて表示された不透明マスクを作成しています。  
+  
+ [!code-xml[OpacityMasksExample#TiledDrawingasOpacityMask](../../../../samples/snippets/csharp/VS_Snippets_Wpf/OpacityMasksExample/CS/DrawingBrushExample.xaml#tileddrawingasopacitymask)]
+ [!code-xml[OpacityMasksExample#TiledDrawingasOpacityMask](../../../../samples/snippets/xaml/VS_Snippets_Wpf/OpacityMasksExample/XAML/DrawingBrushExample.xaml#tileddrawingasopacitymask)]  
+  
+## 参照  
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md b/docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md
new file mode 100644
index 00000000000..0a25ed046a1
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md
@@ -0,0 +1,154 @@
+---
+title: "イメージ、描画、およびビジュアルによる塗りつぶし | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 描画による塗りつぶし"
+  - "ブラシ, イメージによる塗りつぶし"
+  - "ブラシ, 塗りつぶし (ビジュアルによる)"
+  - "塗りつぶし (ビジュアルによる)"
+  - "描画, 描画を使用"
+  - "描画, イメージを使用"
+ms.assetid: 779aac3f-8d41-49d8-8130-768244aa2240
+caps.latest.revision: 28
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# イメージ、描画、およびビジュアルによる塗りつぶし
+ここでは、<xref:System.Windows.Media.ImageBrush> オブジェクト、<xref:System.Windows.Media.DrawingBrush> オブジェクト、および <xref:System.Windows.Media.VisualBrush> オブジェクトを使用して領域をイメージ、<xref:System.Windows.Media.Drawing>、または <xref:System.Windows.Media.Visual> で塗りつぶす方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prereqs"></a>   
+## 必要条件  
+ このトピックを理解するには、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] で提供されるさまざまな種類のブラシとその基本的な機能に精通している必要があります。  詳細については、「[WPF のブラシの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md)」を参照してください。  
+  
+<a name="image"></a>   
+## イメージで領域を塗りつぶす  
+ <xref:System.Windows.Media.ImageBrush> は、<xref:System.Windows.Media.ImageSource> で領域を塗りつぶします。  <xref:System.Windows.Media.ImageBrush> で使用される最も一般的な種類の <xref:System.Windows.Media.ImageSource> は <xref:System.Windows.Media.Imaging.BitmapImage> で、これは 1 個のビットマップ グラフィックを表します。  <xref:System.Windows.Media.DrawingImage> を使用しても、<xref:System.Windows.Media.Drawing> オブジェクトによる塗りつぶしは可能ですが、代わりに <xref:System.Windows.Media.DrawingBrush> を使用する方が簡単です。  <xref:System.Windows.Media.ImageSource> オブジェクトの詳細については、「[イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.ImageBrush> で塗りつぶすには、<xref:System.Windows.Media.Imaging.BitmapImage> を作成し、このオブジェクトを使用してビットマップ コンテンツを読み込みます。  次に、<xref:System.Windows.Media.Imaging.BitmapImage> を使用して、<xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.ImageBrush.ImageSource%2A> プロパティを設定します。  最後に、塗りつぶす対象のオブジェクトに <xref:System.Windows.Media.ImageBrush> を適用します。  [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、<xref:System.Windows.Media.ImageBrush> の <xref:System.Windows.Media.ImageBrush.ImageSource%2A> プロパティに、読み込むイメージのパスを設定するだけでもかまいません。  
+  
+ すべての <xref:System.Windows.Media.Brush> オブジェクトと同様に、<xref:System.Windows.Media.ImageBrush> は、図形、パネル、コントロール、およびテキストなどのオブジェクトの塗りつぶしに使用できます。  <xref:System.Windows.Media.ImageBrush> で適用できるいくつかの効果を次の図に示します。  
+  
+ ![ImageBrush の出力例](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-imagebrushexamples.png "wcpsdk\_mmgraphics\_imagebrushexamples")  
+ImageBrush によって塗りつぶされたオブジェクト  
+  
+ <xref:System.Windows.Media.ImageBrush> の既定の設定では、対象の領域を完全に塗りつぶすようにイメージが引き伸ばされるので、塗りつぶす領域の縦横比がイメージの縦横比と異なる場合にイメージがゆがむことがあります。  この動作を変更するには、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを既定値の <xref:System.Windows.Media.Stretch> から <xref:System.Windows.Media.Stretch>、<xref:System.Windows.Media.Stretch>、または <xref:System.Windows.Media.Stretch> に変更します。  <xref:System.Windows.Media.ImageBrush> は <xref:System.Windows.Media.TileBrush> の型の 1 つであるので、イメージ ブラシで出力領域を塗りつぶす方法を正確に指定でき、パターンを作成することもできます。  高度な <xref:System.Windows.Media.TileBrush> 機能の詳細については、「[TileBrush の概要](../../../../docs/framework/wpf/graphics-multimedia/tilebrush-overview.md)」を参照してください。  
+  
+<a name="fillingpanelwithimage"></a>   
+## 例 : ビットマップ イメージでオブジェクトを塗りつぶす  
+ <xref:System.Windows.Media.ImageBrush> を使用して <xref:System.Windows.Controls.Canvas> の <xref:System.Windows.Controls.Panel.Background%2A> を塗りつぶす例を次に示します。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMImageBrushAsCanvasBackgroundExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/ImageBrushExample.xaml#graphicsmmimagebrushascanvasbackgroundexamplewholepage)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMImageBrushAsCanvasBackgroundExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/ImageBrushExample.cs#graphicsmmimagebrushascanvasbackgroundexamplewholepage)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMImageBrushAsCanvasBackgroundExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/imagebrushexample.vb#graphicsmmimagebrushascanvasbackgroundexamplewholepage)]  
+  
+<a name="drawingbrushintro"></a>   
+## 描画を使用して領域を塗りつぶす  
+ <xref:System.Windows.Media.DrawingBrush> を使用すると、図形、テキスト、イメージ、およびビデオで領域を塗りつぶすことができます。  描画ブラシ内の図形自体も、単色、グラデーション、イメージ、または別の <xref:System.Windows.Media.DrawingBrush> で塗りつぶすことができます。  <xref:System.Windows.Media.DrawingBrush> のいくつかの使用例を次の図に示します。  
+  
+ ![DrawingBrush の出力例](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-drawingbrushexamples.png "wcpsdk\_mmgraphics\_drawingbrushexamples")  
+DrawingBrush によって塗りつぶされたオブジェクト  
+  
+ <xref:System.Windows.Media.DrawingBrush> は、<xref:System.Windows.Media.Drawing> オブジェクトで領域を塗りつぶします。  <xref:System.Windows.Media.Drawing> オブジェクトは、図形、ビットマップ、ビデオ、またはテキスト行などの表示されるコンテンツを記述します。  異なる種類の描画は、異なる種類のコンテンツを記述します。  描画オブジェクトのさまざまな種類を次の一覧に示します。  
+  
+-   <xref:System.Windows.Media.GeometryDrawing> – 図形を描画します。  
+  
+-   <xref:System.Windows.Media.ImageDrawing> – イメージを描画します。  
+  
+-   <xref:System.Windows.Media.GlyphRunDrawing> – テキストを描画します。  
+  
+-   <xref:System.Windows.Media.VideoDrawing> – オーディオまたはビデオ ファイルを再生します。  
+  
+-   <xref:System.Windows.Media.DrawingGroup> – その他の描画を描画します。  他の描画を 1 つの複合描画に結合するには、描画グループを使用します。  
+  
+ <xref:System.Windows.Media.Drawing> オブジェクトの詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.ImageBrush> と同様に、<xref:System.Windows.Media.DrawingBrush> は <xref:System.Windows.Media.DrawingBrush.Drawing%2A> を引き伸ばして出力領域を塗りつぶします。  この動作をオーバーライドするには、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを、既定の設定である <xref:System.Windows.Media.Stretch> から別の設定に変更します。  詳細については、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティのトピックを参照してください。  
+  
+<a name="fillingareawithdrawingbrushexample"></a>   
+## 例 : 描画を使用してオブジェクトを塗りつぶす  
+ 3 つの楕円の描画を使用してオブジェクトを塗りつぶす方法を次の例に示します。  楕円の記述には、<xref:System.Windows.Media.GeometryDrawing> を使用しています。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMDrawingBrushAsButtonBackgroundExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/DrawingBrushExample.xaml#graphicsmmdrawingbrushasbuttonbackgroundexample)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMDrawingBrushAsButtonBackgroundExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/DrawingBrushExample.cs#graphicsmmdrawingbrushasbuttonbackgroundexample1)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMDrawingBrushAsButtonBackgroundExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/drawingbrushexample.vb#graphicsmmdrawingbrushasbuttonbackgroundexample1)]  
+  
+<a name="visualbrushsection"></a>   
+## ビジュアルで領域を塗りつぶす  
+ すべてのブラシの中で最も用途が広く、多くの機能を持つ <xref:System.Windows.Media.VisualBrush> は、<xref:System.Windows.Media.Visual> で領域を塗りつぶします。  <xref:System.Windows.Media.Visual> は低レベルのグラフィックス型で、多数の有用なグラフィカル コンポーネントの先祖として使用されます。  たとえば、<xref:System.Windows.Window> クラス、<xref:System.Windows.FrameworkElement> クラス、および <xref:System.Windows.Controls.Control> クラスはすべて、<xref:System.Windows.Media.Visual> オブジェクトの一種です。  <xref:System.Windows.Media.VisualBrush> による領域の塗りつぶしには、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のほぼすべてのグラフィカル オブジェクトが使用可能です。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Media.VisualBrush> は、一種の <xref:System.Windows.Freezable> オブジェクトですが、その <xref:System.Windows.Media.VisualBrush.Visual%2A> プロパティが `null` 以外の値に設定されている場合は、フリーズする \(読み取り専用にする\) ことはできません。  
+  
+ <xref:System.Windows.Media.VisualBrush> の <xref:System.Windows.Media.VisualBrush.Visual%2A> コンテンツを指定するには、2 とおりの方法があります。  
+  
+-   新しい <xref:System.Windows.Media.Visual> を作成し、このビジュアルを使用して <xref:System.Windows.Media.VisualBrush> の <xref:System.Windows.Media.VisualBrush.Visual%2A> プロパティを設定します。  例については、後の「[例 : ビジュアルを使用してオブジェクトを塗りつぶす](#examplevisualbrush1)」を参照してください。  
+  
+-   既存の <xref:System.Windows.Media.Visual> を使用して、ターゲットの <xref:System.Windows.Media.Visual> の複製イメージを作成します。  次に、<xref:System.Windows.Media.VisualBrush> を使用して反射や拡大などの効果を作成します。  例については、「[例 : 反射を作成する](#examplevisualbrush2)」を参照してください。  
+  
+ <xref:System.Windows.Media.VisualBrush> の <xref:System.Windows.Media.VisualBrush.Visual%2A> を新たに定義したときに、その <xref:System.Windows.Media.Visual> が <xref:System.Windows.UIElement> \(パネルやコントロールなど\) ならば、<xref:System.Windows.Media.VisualBrush.AutoLayoutContent%2A> プロパティが `true` に設定されている場合に <xref:System.Windows.UIElement> およびその子要素に基づいてレイアウト システムが実行されます。  ただし、ルートの <xref:System.Windows.UIElement> は実質的にシステムのその他の部分から切り離され、スタイルや外部レイアウトがこの境界を通過することはできません。  したがって、ルートの <xref:System.Windows.UIElement> のサイズは明示的に指定してください。その唯一の親が <xref:System.Windows.Media.VisualBrush> であるために、描画される領域に合わせて自身のサイズが自動的に設定されることはないからです。  [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] でのレイアウトの詳細については、「[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.ImageBrush> や <xref:System.Windows.Media.DrawingBrush> と同様に、<xref:System.Windows.Media.VisualBrush> で出力領域を塗りつぶすときはコンテンツが引き伸ばされます。  この動作をオーバーライドするには、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティを、既定の設定である <xref:System.Windows.Media.Stretch> から別の設定に変更します。  詳細については、<xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティのトピックを参照してください。  
+  
+<a name="examplevisualbrush1"></a>   
+## 例 : ビジュアルを使用してオブジェクトを塗りつぶす  
+ 次の例では、いくつかのコントロールと 1 つのパネルを使用して四角形を塗りつぶします。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/VisualBrushExample.xaml#graphicsmmvisualbrushasrectanglebackgroundexample)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/VisualBrushExample.cs#graphicsmmvisualbrushasrectanglebackgroundexample1)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMVisualBrushAsRectangleBackgroundExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/visualbrushexample.vb#graphicsmmvisualbrushasrectanglebackgroundexample1)]  
+  
+<a name="examplevisualbrush2"></a>   
+## 例 : 鏡像を作成する  
+ 前の例では、背景として使用するために <xref:System.Windows.Media.Visual> を新規作成する方法を示しました。  <xref:System.Windows.Media.VisualBrush> を使用して既存のビジュアルを表示することもできます。この機能を使用すると、反射や拡大などのユニークな視覚効果を作成できます。  次の例では、<xref:System.Windows.Media.VisualBrush> を使用して、複数の要素が含まれる <xref:System.Windows.Controls.Border> の鏡像を作成します。  この例が生成する出力を次の図に示します。  
+  
+ ![反映された Visual オブジェクト](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-visualbrush-reflection-small.png "graphicsmm\_visualbrush\_reflection\_small")  
+ビジュアル オブジェクトの鏡像  
+  
+ [!code-csharp[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/visualbrush_markup_snip/CSharp/ReflectionExample.cs#graphicsmmvisualbrushreflectionexamplewholepage)]
+ [!code-vb[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/visualbrush_markup_snip/visualbasic/reflectionexample.vb#graphicsmmvisualbrushreflectionexamplewholepage)]
+ [!code-xml[visualbrush_markup_snip#GraphicsMMVisualBrushReflectionExampleWholePage](../../../../samples/snippets/xaml/VS_Snippets_Wpf/visualbrush_markup_snip/XAML/ReflectionExample.xaml#graphicsmmvisualbrushreflectionexamplewholepage)]  
+  
+ この他の、画面の一部分を拡大する方法や鏡像を作成する方法の例については、[VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)を参照してください。  
+  
+<a name="tilebrush"></a>   
+## TileBrush の機能  
+ <xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、および <xref:System.Windows.Media.VisualBrush> は、<xref:System.Windows.Media.TileBrush> オブジェクトの一種です。  <xref:System.Windows.Media.TileBrush> オブジェクトを使用すると、イメージ、描画、またはビジュアルで領域を塗りつぶす方法を細かく制御できます。  たとえば、引き伸ばした単一のイメージで領域をただ塗りつぶすのではなく、パターンを作成する一連のイメージ タイルで領域を塗りつぶすことができます。  
+  
+ <xref:System.Windows.Media.TileBrush> には、コンテンツ、タイル、および出力領域の 3 つの主要コンポーネントがあります。  
+  
+ ![TileBrush コンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-defaultcontentprojection2.png "wcpsdk\_mmgraphics\_defaultcontentprojection2")  
+1 つのタイルを使用する TileBrush のコンポーネント  
+  
+ ![並べて表示された TileBrush のコンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tiledprojection.png "graphicsmm\_tiledprojection")  
+複数のタイルを使用する TileBrush のコンポーネント  
+  
+ <xref:System.Windows.Media.TileBrush> オブジェクトの、並べて表示する機能の詳細については、「[TileBrush の概要](../../../../docs/framework/wpf/graphics-multimedia/tilebrush-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.ImageBrush>   
+ <xref:System.Windows.Media.DrawingBrush>   
+ <xref:System.Windows.Media.VisualBrush>   
+ <xref:System.Windows.Media.TileBrush>   
+ [TileBrush の概要](../../../../docs/framework/wpf/graphics-multimedia/tilebrush-overview.md)   
+ [WPF のブラシの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md)   
+ [イメージングの概要](../../../../docs/framework/wpf/graphics-multimedia/imaging-overview.md)   
+ [Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)   
+ [不透明マスクの概要](../../../../docs/framework/wpf/graphics-multimedia/opacity-masks-overview.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)   
+ [VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md b/docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md
new file mode 100644
index 00000000000..2f84d986d95
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md
@@ -0,0 +1,185 @@
+---
+title: "純色およびグラデーションによる塗りつぶしの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, 塗りつぶし (グラデーションによる)"
+  - "ブラシ, 塗りつぶし (純色による)"
+  - "グラデーション, 塗りつぶし"
+  - "塗りつぶし (グラデーションによる)"
+  - "塗りつぶし (純色による)"
+  - "純色, 塗りつぶし"
+ms.assetid: f5b182f3-c5c7-4cbe-9f2f-65e690d08255
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 純色およびグラデーションによる塗りつぶしの概要
+ここでは、<xref:System.Windows.Media.SolidColorBrush>、<xref:System.Windows.Media.LinearGradientBrush>、および <xref:System.Windows.Media.RadialGradientBrush> オブジェクトを使用して、純色、線形グラデーション、および放射状グラデーションで塗りつぶす方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="solidcolor"></a>   
+## 純色による領域の塗りつぶし  
+ どのようなプラットフォームでも最も一般的な操作の 1 つが、純色の <xref:System.Windows.Media.Color> で領域を塗りつぶす操作です。  このタスクを実現するために、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は <xref:System.Windows.Media.SolidColorBrush> クラスを提供します。  以下のセクションでは、<xref:System.Windows.Media.SolidColorBrush> で塗りつぶすためのさまざまな方法について説明します。  
+  
+<a name="solidcolorinxaml"></a>   
+### "XAML" での SolidColorBrush の使用  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で純色で領域を塗りつぶすには、次のいずれかの方法を使用します。  
+  
+-   定義済みの純色のブラシを名前によって選択します。  たとえば、ボタンの <xref:System.Windows.Controls.Control.Background%2A> を "Red" または "MediumBlue" に設定できます。  その他の定義済みの純色のブラシの一覧については、<xref:System.Windows.Media.Brushes> クラスの静的プロパティを参照してください。  例を次に示します。  
+  
+     [!code-xml[BrushOverviewExamples_snip#SolidColorBrushNamedColor1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/SolidColorBrushExample.xaml#solidcolorbrushnamedcolor1xaml)]  
+  
+-   赤、緑、および青の量を指定して単一の純色に組み合わせることによって、32 ビットのカラー パレットから色を選択します。  32 ビット パレットから色を指定するための形式は、"*\#rrggbb*" です。ここでは、*rr* は赤の相対的な量を指定する 2 桁の 16 進数であり、*gg* は緑の量を指定し、*bb* は青の量を指定します。  また、色は "\#*aarrggbb*" として指定できます。ここでは、*aa* は色のアルファ値、つまり透明度を指定します。  この方法によって、部分的に透明な色を作成できます。  次の例では、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> は、16 進数表記を使用して完全に不透明な赤に設定されます。  
+  
+     [!code-xml[BrushOverviewExamples_snip#SolidColorBrushHex1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/SolidColorBrushExample.xaml#solidcolorbrushhex1xaml)]  
+  
+-   <xref:System.Windows.Media.SolidColorBrush> を記述するには、プロパティ タグ構文を使用します。  この構文は、記述は冗長になりますが、ブラシの不透明度などの追加の設定を指定できます。  次の例では、2 つの <xref:System.Windows.Controls.Button> 要素の <xref:System.Windows.Controls.Control.Background%2A> プロパティが完全に不透明な赤に設定されます。  最初のブラシの色は、定義済みの色の名前を使用して記述されています。  2 番目のブラシの色は、16 進表記を使用して記述されています。  
+  
+     [!code-xml[BrushOverviewExamples_snip#SolidColorBrushPropertyTag1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/SolidColorBrushExample.xaml#solidcolorbrushpropertytag1xaml)]  
+  
+<a name="solidcolorsincode"></a>   
+### コードでの SolidColorBrush による塗りつぶし  
+ コードで純色で領域を塗りつぶすには、次のいずれかの方法を使用します。  
+  
+-   <xref:System.Windows.Media.Brushes> クラスによって提供されている定義済みブラシのいずれかを使用します。  次の例では、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> が <xref:System.Windows.Media.Brushes.Red%2A> に設定されています。  
+  
+     [!code-csharp[BrushOverviewExamples_snip#SolidColorBrushPredefinedBrush1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/SolidColorBrushExample.cs#solidcolorbrushpredefinedbrush1csharp)]  
+  
+-   <xref:System.Windows.Media.SolidColorBrush> を作成し、その <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティを <xref:System.Windows.Media.Color> 構造体を使用して設定します。  <xref:System.Windows.Media.Colors> クラスから定義済みの色を使用するか、静的な <xref:System.Windows.Media.Color.FromArgb%2A> メソッドを使用して <xref:System.Windows.Media.Color> を作成することができます。  
+  
+     定義済みの色を使用して <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティを設定する方法を次の例に示します。  
+  
+     [!code-csharp[BrushOverviewExamples_snip#SolidColorBrushPredefinedColor1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/SolidColorBrushExample.cs#solidcolorbrushpredefinedcolor1csharp)]  
+  
+ 静的な <xref:System.Windows.Media.Color.FromArgb%2A> によって、色の[アルファ](GTMT)、赤、緑、および青の値を指定できます。  これらの各値の一般的な範囲は、0 ～ 255 です。  たとえば、[アルファ](GTMT)値が 0 の場合は色が完全に透明であることを示し、値が 255 の場合は色が完全に不透明であることを示します。  同様に、red 値が 0 である場合は色に赤が含まれないことを示し、値が 255 である場合は使用できる赤の最大量が含まれていることを示します。  以降の例では、ブラシの色はアルファ、赤、緑、および青の値を指定することによって記述されます。  
+  
+ [!code-csharp[BrushOverviewExamples_snip#SolidColorBrushfromArgbExample1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/SolidColorBrushExample.cs#solidcolorbrushfromargbexample1csharp)]  
+  
+ 色を指定するためのその他の方法については、<xref:System.Windows.Media.Color> のリファレンス トピックを参照してください。  
+  
+<a name="gradient"></a>   
+## グラデーションによる領域の塗りつぶし  
+ グラデーション ブラシは、軸に沿ってブレンドしあう複数の色で領域を塗りつぶします。  これらを使用して、光と影の印象を作成でき、コントロールの外観を 3 次元にできます。  これらを使用して、ガラス、クロム、水、およびその他の滑らかな表面をシミュレートすることもできます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、<xref:System.Windows.Media.LinearGradientBrush> と <xref:System.Windows.Media.RadialGradientBrush> の 2 種類のグラデーション ブラシが用意されています。  
+  
+<a name="lineargradientbrush"></a>   
+## 線形グラデーション  
+ <xref:System.Windows.Media.LinearGradientBrush> は、グラデーション軸という線に沿って定義されたグラデーションで領域を塗りつぶします。  <xref:System.Windows.Media.GradientStop> オブジェクトを使用して、グラデーションの色、およびそのグラデーション軸に沿った位置を指定します。  グラデーション軸を変更することもでき、これによって、横グラデーションと縦グラデーションの作成、およびグラデーション方向の反転が可能になります。  グラデーション軸については、次のセクションで説明します。  既定では、斜線グラデーションが作成されます。  
+  
+ 4 色の線形グラデーションを作成するコードを次の例に示します。  
+  
+ [!code-xml[GradientBrushExamples_snip#DiagonalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#diagonalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#DiagonalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#diagonalgradient1csharp)]  
+  
+ このコードを実行すると、次のグラデーションが生成されます。  
+  
+ ![対角線方向の線形グラデーション](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-diaglgradient-nolabel.png "wcpsdk\_graphicsmm\_diaglgradient\_nolabel")  
+  
+ **メモ :** このトピックのグラデーションの例では、開始点と終了点の設定に既定の座標系を使用しています。  既定の座標系は境界ボックスに対して相対的です。0 は境界ボックスの 0% を示し、1 は境界ボックスの 100% を示します。  この座標系を変更するには、<xref:System.Windows.Media.GradientBrush.MappingMode%2A> プロパティを <xref:System.Windows.Media.BrushMappingMode> という値に設定します。  絶対座標系は、境界ボックスに対して相対的ではありません。  値は、ローカル空間で直接解釈されます。  
+  
+ <xref:System.Windows.Media.GradientStop> はグラデーション ブラシの基本的なビルド ブロックです。  グラデーション終了位置は、グラデーション軸に沿った <xref:System.Windows.Media.GradientStop.Offset%2A> 位置の <xref:System.Windows.Media.GradientStop.Color%2A> を示します。  
+  
+-   グラデーション終了位置の <xref:System.Windows.Media.GradientStop.Color%2A> プロパティは、グラデーション終了位置の色を指定します。  色の設定には、<xref:System.Windows.Media.Colors> クラスによる定義済みの色を使用するか、ScRGB 値または ARGB 値を指定することができます。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、色を記述するために 16 進数表記も使用できます。  詳細については、<xref:System.Windows.Media.Color> 構造体の説明を参照してください。  
+  
+-   グラデーション終了位置の <xref:System.Windows.Media.GradientStop.Offset%2A> プロパティは、グラデーション軸上のグラデーション終了位置の色の位置を指定します。  オフセットは 0 ～ 1 の <xref:System.Double> 値です。  グラデーション終了位置のオフセット値が 0 に近づくにつれて、色はグラデーションの始点に近づきます。  グラデーションのオフセット値が 1 に近づくほど、色はグラデーションの終点に近づきます。  
+  
+ グラデーション終了位置の間の各点の色は、2 つの境界グラデーション終了位置によって指定された色の組み合わせとして線形に補間されます。  次の図は、前の例のグラデーション終了位置を示しています。  円はグラデーション終了位置の位置を示し、破線はグラデーション軸を示しています。  
+  
+ ![線形グラデーションのグラデーション ストップ](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops.png "wcpsdk\_graphicsmm\_4gradientstops")  
+  
+ 最初のグラデーション終了位置は、オフセット位置 `0.0` の色として黄色を指定します。  2 番目のグラデーション終了位置は、オフセット位置 `0.25` の色として赤を指定します。  これらの 2 つの終了位置の間の点は、グラデーション軸に沿って左から右に移動するにつれて黄色から赤に徐々に変化します。  3 番目のグラデーション終了位置は、オフセット位置 `0.75` の色として青を指定します。  2 番目と 3 番目のグラデーション終了位置の間の点は、赤から青に徐々に変化します。  4 番目のグラデーション終了位置は、オフセット位置 `1.0` の色として淡い緑を指定します。  3 番目と 4 番目のグラデーション終了位置の間の点は、青から淡い緑に徐々に変化します。  
+  
+<a name="gradientaxis"></a>   
+### グラデーション軸  
+ 前に説明したように、線形グラデーション ブラシのグラデーション終了位置は、グラデーション軸という線に沿って配置されます。  この線の方向とサイズは、ブラシの <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> プロパティおよび <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> プロパティを使用して変更できます。  ブラシの <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> および <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を操作することによって、横グラデーションおよび縦グラデーションの作成、グラデーション方向の反転、グラデーションの拡散の縮小などを行うことができます。  
+  
+ 既定では、線形グラデーションのブラシの <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> および <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> は塗りつぶされている領域に対して相対的なものになります。  点 \(0,0\) は塗りつぶされている領域の左上隅を表し、\(1,1\) は塗りつぶされている領域の右下隅を表します。  <xref:System.Windows.Media.LinearGradientBrush> の既定の <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> は \(0,0\) であり、既定の <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> は \(1,1\) です。これによって、塗りつぶされている領域の左上隅から開始し、右下隅に伸びていく斜線グラデーションが作成されます。  既定の <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> および <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を持つ線形グラデーション ブラシのグラデーション軸を次の図に示します。  
+  
+ ![対角線方向の線形グラデーションのグラデーション軸](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-diagonalgradientaxis.png "wcpsdk\_graphicsmm\_diagonalgradientaxis")  
+  
+ ブラシの <xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> および <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を指定して横グラデーションを作成する方法を次の例に示します。  グラデーション終了位置は前の例と同じであることに注意してください。<xref:System.Windows.Media.LinearGradientBrush.StartPoint%2A> および <xref:System.Windows.Media.LinearGradientBrush.EndPoint%2A> を変更しただけで、グラデーションは斜線から横に変更されました。  
+  
+ [!code-xml[GradientBrushExamples_snip#HorizontalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#horizontalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#HorizontalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#horizontalgradient1csharp)]  
+  
+ 次の図は、作成されたグラデーションを示しています。  グラデーションの軸は破線、グラデーションの分岐点は円で示されています。  
+  
+ ![水平方向の線形グラデーションのグラデーション軸](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-horizontalgradient.png "wcpsdk\_graphicsmm\_horizontalgradient")  
+  
+ 縦グラデーションを作成する方法を次の例に示します。  
+  
+ [!code-xml[GradientBrushExamples_snip#VerticalGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/LinearGradientBrushExample.xaml#verticalgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#VerticalGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/LinearGradientBrushExample.cs#verticalgradient1csharp)]  
+  
+ 次の図は、作成されたグラデーションを示しています。  グラデーションの軸は破線、グラデーションの分岐点は円で示されています。  
+  
+ ![垂直グラデーションのグラデーション軸](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-verticalgradient.png "wcpsdk\_graphicsmm\_verticalgradient")  
+  
+<a name="radialgradients"></a>   
+## 放射状グラデーション  
+ <xref:System.Windows.Media.LinearGradientBrush> と同様に、<xref:System.Windows.Media.RadialGradientBrush> は軸に沿ってブレンドしあう複数の色で領域を塗りつぶします。  前の例では、線形グラデーション ブラシの軸がどのような直線であるかを示しました。  放射状グラデーション ブラシの軸は、円によって定義されます。色は原点から外側に向かって "放射" されます。  
+  
+ 次の例では、放射状グラデーション ブラシは、四角形の内部を塗りつぶすために使用されます。  
+  
+ [!code-xml[GradientBrushExamples_snip#RadialGradient1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/RadialGradientBrushExample.xaml#radialgradient1xaml)]  
+  
+ [!code-csharp[GradientBrushExamples_snip#RadialGradient1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/RadialGradientBrushExample.cs#radialgradient1csharp)]  
+  
+ 前の例で作成したグラデーションを次の図に示します。  ブラシのグラデーション終了位置が示されています。  結果は異なりますが、この例のグラデーション終了位置は前の線形グラデーション ブラシの例のグラデーション終了位置と同じであることに注意してください。  
+  
+ ![放射状グラデーションのグラデーション ストップ](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-4gradientstops-rg.png "wcpsdk\_graphicsmm\_4gradientstops\_rg")  
+  
+ <xref:System.Windows.Media.RadialGradientBrush.GradientOrigin%2A> は、放射状グラデーション ブラシのグラデーション軸の始点を指定します。  グラデーション軸は、グラデーションの原点からグラデーションの円に向かって放射します。  ブラシのグラデーションの円は、<xref:System.Windows.Media.RadialGradientBrush.Center%2A>、<xref:System.Windows.Media.RadialGradientBrush.RadiusX%2A>、<xref:System.Windows.Media.RadialGradientBrush.RadiusY%2A> の各プロパティによって定義されます。  
+  
+ さまざまな <xref:System.Windows.Media.RadialGradientBrush.GradientOrigin%2A>、<xref:System.Windows.Media.RadialGradientBrush.Center%2A>、<xref:System.Windows.Media.RadialGradientBrush.RadiusX%2A>、および <xref:System.Windows.Media.RadialGradientBrush.RadiusY%2A> の設定を持つ複数の放射状グラデーションを次の図に示します。  
+  
+ ![RadialGradientBrush 設定](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-originscirclesandradii.png "wcpsdk\_graphicsmm\_originscirclesandradii")  
+さまざまな GradientOrigin、Center、RadiusX、および RadiusY の設定を持つ RadialGradientBrushes  
+  
+<a name="specifyinggradientcolors"></a>   
+## 透明または部分的に透明なグラデーション終了位置の指定  
+ グラデーション終了位置には不透明度プロパティがないため、マークアップで [!INCLUDE[TLA#tla_argb](../../../../includes/tlasharptla-argb-md.md)] 16 進数表記を使用して色のアルファ チャネルを指定するか、<xref:System.Windows.Media.Color.FromScRgb%2A?displayProperty=fullName> メソッドを使用して、透明または部分的に透明なグラデーション終了位置を作成する必要があります。  以下のセクションでは、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] およびコードで部分的に透明なグラデーション終了位置を作成する方法について説明します。  ブラシ全体の不透明度の設定については、「[ブラシの不透明度の指定](#brushesAndOpacity)」を参照してください。  
+  
+<a name="argbsyntax"></a>   
+### "XAML" での色の透過度の指定  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、[!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] 16 進数表記を使用して、個別の色の透過度を指定します。  [!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] の 16 進数表記では次の構文が使用されます。  
+  
+ `#`**aa** *rrggbb*  
+  
+ この構文の *aa* は、色の不透明度を指定する 2 桁の 16 進数の値を表します。  *rr*、*gg*、*bb* はそれぞれ、赤、緑、青の各色の量を指定する 2 桁の 16 進数を表します。  16 進数の各桁には、0 から 9、または A から F の値を指定できます。  0 が最小値で、F が最大値になります。  00 のアルファ値は、完全に透明な色の指定、FF のアルファ値は、完全に不透明な色の指定を表します。  次の例に、16 進数の [!INCLUDE[TLA2#tla_argb](../../../../includes/tla2sharptla-argb-md.md)] 表記を使用した 2 種類の色の指定方法を示します。  最初の例は部分的に透明 \(アルファ値が x20\) であり、2 番目の例は完全に不透明です。  
+  
+ [!code-xml[GradientBrushExamples_snip#TransparentGradientStopExample1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/GradientBrushExamples_snip/XAML/GradientStopsExample.xaml#transparentgradientstopexample1xaml)]  
+  
+<a name="fromscrgbsyntax"></a>   
+### コードでの色の不透明度の指定  
+ コードを使用する場合は、静的な <xref:System.Windows.Media.Color.FromArgb%2A> メソッドを使用すると、色を作成するときにアルファ値を指定できます。  このメソッドは <xref:System.Byte> 型の 4 つのパラメーターを取ります。  最初のパラメーターは色のアルファ チャネルを指定します。その他の 3 つのパラメーターは色の赤、緑、および青の値を指定します。  各値は、0 ～ 255 のいずれかです。  アルファ値 0 は完全に透明な色を指定し、アルファ値 255 は完全に不透明な色を指定します。  次の例では、<xref:System.Windows.Media.Color.FromArgb%2A> メソッドは 2 つの色を生成するために使用されます。  最初の色は部分的に透明 \(アルファ値が 32\) であり、2 番目の色は完全に不透明です。  
+  
+ [!code-csharp[GradientBrushExamples_snip#TransparentGradientStopExample1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GradientBrushExamples_snip/CSharp/GradientStopsExample.cs#transparentgradientstopexample1csharp)]  
+  
+ また、ScRGB 値を使用して色を作成できるようにする <xref:System.Windows.Media.Color.FromScRgb%2A> メソッドを使用できます。  
+  
+<a name="otherbrushes"></a>   
+## イメージ、描画、ビジュアル、およびパターンによる塗りつぶし  
+ <xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、<xref:System.Windows.Media.VisualBrush> の各クラスを使用すると、イメージ、描画、またはビジュアルで領域を塗りつぶすことができます。  イメージ、描画、およびパターンによる塗りつぶしについては、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Brush>   
+ <xref:System.Windows.Media.SolidColorBrush>   
+ <xref:System.Windows.Media.LinearGradientBrush>   
+ <xref:System.Windows.Media.RadialGradientBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [ブラシの変換の概要](../../../../docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md)   
+ [グラフィックスの描画層](../../../../docs/framework/wpf/advanced/graphics-rendering-tiers.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md
new file mode 100644
index 00000000000..64ef7ce0726
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md
@@ -0,0 +1,43 @@
+---
+title: "パス アニメーションに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "アニメーション, パス"
+  - "パス アニメーション"
+ms.assetid: e9b71017-bac4-40d7-858b-326939442cb1
+caps.latest.revision: 54
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 54
+---
+# パス アニメーションに関する「方法」トピック
+このセクションの各トピックでは、パスに沿ってオブジェクトをアニメーション化する方法について説明します。  
+  
+## このセクションの内容  
+ [パスに沿ってオブジェクトをアニメーション化する \(ダブル アニメーション\)](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-double-animation.md)  
+ [パスに沿ってオブジェクトをアニメーション化する \(ポイント アニメーション\)](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation.md)  
+ [パスに沿ってオブジェクトをアニメーション化する \(行列アニメーション\)](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md)  
+ [パスに沿ってオブジェクトをアニメーション化する \(オフセット累積による行列アニメーション\)](../../../../docs/framework/wpf/graphics-multimedia/animate-an-object-along-a-path-matrix-animation-with-offset.md)  
+ [ジオメトリック パスを使用してオブジェクトを回転させる \(行列アニメーション\)](../../../../docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path-matrix-animation.md)  
+ [ジオメトリック パスを使用してオブジェクトを回転させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object-by-using-a-geometric-path.md)  
+  
+## 関連項目  
+ <xref:System.Windows.Media.Animation.PathAnimationSource>  
+  
+ <xref:System.Windows.Media.Animation.Storyboard>  
+  
+## 参照  
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [キー フレーム アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/key-frame-animations-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/path-animations-overview.md b/docs/framework/wpf/graphics-multimedia/path-animations-overview.md
new file mode 100644
index 00000000000..ef5cc4cd4f9
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/path-animations-overview.md
@@ -0,0 +1,102 @@
+---
+title: "パス アニメーションの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "パスのアニメーション"
+  - "パス アニメーション"
+ms.assetid: 979c732c-df74-47a6-be96-8e07b3707d53
+caps.latest.revision: 13
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# パス アニメーションの概要
+<a name="introduction"></a>このトピックでは、出力値を生成するジオメトリック パスを使用するため、パスのアニメーションを紹介します。 パス アニメーションは、移動および複雑なパスに沿ってオブジェクトを回転するのに便利です。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## <a name="prerequisites"></a>必須コンポーネント  
+ このトピックを理解するのには理解しておく[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アニメーション機能します。 アニメーション機能の概要については、次を参照してください。、[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)します。  
+  
+ 使用するため、 <xref:System.Windows.Media.PathGeometry>パスのアニメーションを定義するオブジェクトする必要がありますも理解しておく<xref:System.Windows.Media.PathGeometry>さまざまなタイプの<xref:System.Windows.Media.PathSegment>オブジェクトです。 詳細については、次を参照してください。、[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)します。  
+  
+<a name="what_is_a_path_animation"></a>   
+## <a name="what-is-a-path-animation"></a>パス アニメーションとは何ですか。  
+ パス アニメーションの種類は、 <xref:System.Windows.Media.Animation.AnimationTimeline>を使用する、 <xref:System.Windows.Media.PathGeometry>として入力します。 プロパティ、To、From を設定する代わりに (な From/に/By の場合とアニメーション) または (キー フレーム アニメーションのと)、キー フレームを使用して、ジオメトリック パスを定義し、設定を使用する、`PathGeometry`パス アニメーションのプロパティです。 パス アニメーション進行状況に応じて、パスから x、y、および角度情報を読み取り、その情報を使用して、その出力を生成することです。  
+  
+ パス アニメーションは、複雑なパスに沿ってオブジェクトをアニメーション化するのに便利です。 使用するパスに沿ってオブジェクトを移動する方法の&1; つ、 <xref:System.Windows.Media.MatrixTransform>と<xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>複雑なパスに沿ってオブジェクトを変換します。 次の例では、この手法をでを使用して、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>アニメーション化するオブジェクト、<xref:System.Windows.Media.MatrixTransform.Matrix%2A>のプロパティ、 <xref:System.Windows.Media.MatrixTransform>します。 <xref:System.Windows.Media.MatrixTransform>ボタンに適用され、曲線のパスに沿って移動する場合は、です。 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.DoesRotateWithTangent%2A>にプロパティが設定されている`true`パスの接線に沿った四角形が回転します。  
+  
+ [!code-xml[PathAnimationGallery_snippet#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_snippet/CS/matrixanimationusingpathdoesrotatewithtangentexample.xaml#matrixanimationusingpathdoesrotatewithtangentwholepage)]  
+  
+ [!code-csharp[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/CSharp/MatrixAnimationUsingPathDoesRotateWithTangentExample.cs#matrixanimationusingpathdoesrotatewithtangentwholepage)]
+ [!code-vb[PathAnimationGallery_procedural_snip#MatrixAnimationUsingPathDoesRotateWithTangentWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PathAnimationGallery_procedural_snip/VisualBasic/MatrixAnimationUsingPathDoesRotateWithTangentExample.vb#matrixanimationusingpathdoesrotatewithtangentwholepage)]  
+  
+ 使用されているパスの構文の詳細については、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]例を参照してください、[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)の概要です。 完全なサンプルを参照してください。[パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)します。  
+  
+ パス アニメーションをプロパティに適用するにを使用して、<xref:System.Windows.Media.Animation.Storyboard>で[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]とコード、またはを使用して、 <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A>コード内のメソッドです。 パス アニメーションを使用して作成した、 <xref:System.Windows.Media.Animation.AnimationClock>し、1 つまたは複数のプロパティに適用します。 アニメーションを適用するためのさまざまな方法の詳細については、次を参照してください。[プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)します。  
+  
+<a name="animation_types"></a>   
+## <a name="path-animation-types"></a>パス アニメーションの種類  
+ アニメーションは、プロパティの値を生成するためには、プロパティの種類別のアニメーションの種類があります。 受け取るプロパティをアニメーション化する、<xref:System.Double>(など、 [X](assetId:///P:System.Windows.Media.TranslateTransform.X?qualifyHint=False&autoUpgrade=True)のプロパティを[TranslateTransform](assetId:///T:System.Windows.Media.TranslateTransform?qualifyHint=False&autoUpgrade=True))、生成されるアニメーションを使用して<xref:System.Double>値。 受け取るプロパティをアニメーション化する、<xref:System.Windows.Point>、生成されるアニメーションを使用して<xref:System.Windows.Point>値、およびなどです。  
+  
+ パス アニメーション クラスは、 <xref:System.Windows.Media.Animation>名前空間および名前付け規則を使用します。  
+  
+ *<>\>*`AnimationUsingPath`  
+  
+ ここで* <> \> *クラスをアニメーション化する値の型です。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]次のパスのアニメーション クラスを提供します。  
+  
+|プロパティの型|対応するパスのアニメーション クラス|例|  
+|-------------------|----------------------------------------|-------------|  
+|<xref:System.Double>|<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>|[(ダブル アニメーション) のパスに沿ってオブジェクトをアニメーション化します。](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-double-animation.md)|  
+|<xref:System.Windows.Media.Matrix>|<xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>|[(行列アニメーション) のパスに沿ってオブジェクトをアニメーション化します。](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-matrix-animation.md)|  
+|<xref:System.Windows.Point>|<xref:System.Windows.Media.Animation.PointAnimationUsingPath>|[(ポイント アニメーション) のパスに沿ってオブジェクトをアニメーション化します。](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-an-object-along-a-path-point-animation.md)|  
+  
+ A <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>生成<xref:System.Windows.Media.Matrix>値からその<xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.PathGeometry%2A>します。 使用すると、 <xref:System.Windows.Media.MatrixTransform>、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>パスに沿ってオブジェクトを移動することができます。 設定した場合、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath.DoesRotateWithTangent%2A>のプロパティ、 <xref:System.Windows.Media.Animation.MatrixAnimationUsingPath>に`true`パスの曲線に沿ってオブジェクトが回転されます。  
+  
+ A <xref:System.Windows.Media.Animation.PointAnimationUsingPath>生成<xref:System.Windows.Point>値から、x 座標と y 座標の<xref:System.Windows.Media.Animation.PointAnimationUsingPath.PathGeometry%2A>します。 使用して、 <xref:System.Windows.Media.Animation.PointAnimationUsingPath>を受け取るプロパティをアニメーション化する<xref:System.Windows.Point>値、パスに沿ってオブジェクトを移動することができます。 A <xref:System.Windows.Media.Animation.PointAnimationUsingPath>オブジェクトを回転させることはできません。  
+  
+ A <xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>生成<xref:System.Double>値からその<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath.PathGeometry%2A>します。 設定して、<xref:System.Windows.Media.Animation.DoubleAnimationUsingPath.Source%2A>プロパティを指定できるかどうか、 <xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>は x 座標、y 座標、またはパスの角度の出力として使用します。 使用することができます、 <xref:System.Windows.Media.Animation.DoubleAnimationUsingPath>をオブジェクトを回転させるか、x 軸または y 軸に沿って移動します。  
+  
+<a name="pathanimationinput"></a>   
+## <a name="path-animation-input"></a>パス アニメーションの入力  
+ 各パスのアニメーション クラスでは、 <xref:System.Windows.Media.PathGeometry>を入力を指定するプロパティです。 パス アニメーションを使用して、 <xref:System.Windows.Media.PathGeometry>の出力値を生成します。 <xref:System.Windows.Media.PathGeometry>クラスでは、円弧、曲線、および行で構成される複数の複雑な図形を記述することができます。  
+  
+ 中心に、 <xref:System.Windows.Media.PathGeometry>のコレクションは、 <xref:System.Windows.Media.PathFigure>オブジェクト。 これらのオブジェクトはという名前は、各図形内の個別の図形の説明、 <xref:System.Windows.Media.PathGeometry>します。 各<xref:System.Windows.Media.PathFigure>は、1 つ以上の<xref:System.Windows.Media.PathSegment>オブジェクトの図のセグメントをそれぞれ記述します。  
+  
+ さまざまな種類のセグメントがあります。  
+  
+|セグメントの種類|説明|  
+|------------------|-----------------|  
+|<xref:System.Windows.Media.ArcSegment>|2 つの地点の楕円の円弧を作成します。|  
+|<xref:System.Windows.Media.BezierSegment>|2 つの地点の&3; 次ベジエ曲線を作成します。|  
+|<xref:System.Windows.Media.LineSegment>|2 つのポイントの間に行を作成します。|  
+|<xref:System.Windows.Media.PolyBezierSegment>|一連の&3; 次ベジエ曲線を作成します。|  
+|<xref:System.Windows.Media.PolyLineSegment>|一連の線を作成します。|  
+|<xref:System.Windows.Media.PolyQuadraticBezierSegment>|一連の二次ベジエ曲線を作成します。|  
+|<xref:System.Windows.Media.QuadraticBezierSegment>|2 次ベジエ曲線を作成します。|  
+  
+ 内のセグメント、 <xref:System.Windows.Media.PathFigure>セグメントの終了点を次のセグメントの開始点として使用する単一幾何図形に結合されます。 <xref:System.Windows.Media.PathFigure.StartPoint%2A>のプロパティ、 <xref:System.Windows.Media.PathFigure>最初のセグメントの描画元となるポイントを指定します。 後続の各セグメントは、前のセグメントの終了位置から開始されます。 垂直線など`10,50`に`10,150`を設定して定義されていることができます、 <xref:System.Windows.Media.PathFigure.StartPoint%2A>プロパティを`10,50`を作成して、 <xref:System.Windows.Media.LineSegment>で、<xref:System.Windows.Media.LineSegment.Point%2A>のプロパティの設定`10,150`します。  
+  
+ 詳細については<xref:System.Windows.Media.PathGeometry>オブジェクトを参照してください、[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)します。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]を設定する特別な省略構文を使用することもできます。、<xref:System.Windows.Media.PathGeometry.Figures%2A>のプロパティ、 <xref:System.Windows.Media.PathGeometry>します。 詳細については、次を参照してください。[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)の概要です。  
+  
+ 使用されているパスの構文の詳細については、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]例を参照してください、[パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)の概要です。  
+  
+## <a name="see-also"></a>関連項目  
+ [パス アニメーションのサンプル](http://go.microsoft.com/fwlink/?LinkID=160028)   
+ [パス マークアップ構文](../../../../docs/framework/wpf/graphics-multimedia/path-markup-syntax.md)   
+ [パス アニメーションに関する「方法」トピック](../../../../docs/framework/wpf/graphics-multimedia/path-animation-how-to-topics.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/path-markup-syntax.md b/docs/framework/wpf/graphics-multimedia/path-markup-syntax.md
new file mode 100644
index 00000000000..c58ba4edcf2
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/path-markup-syntax.md
@@ -0,0 +1,238 @@
+---
+title: "パス マークアップ構文 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PathGeometry クラス"
+  - "属性の使用方法 (XAML)"
+  - "XAML 属性の使用方法"
+  - "PathGeometry クラス"
+  - "グラフィックス、PathGeometry クラス"
+  - "XAML オブジェクト要素の使用"
+ms.assetid: b8586241-a02d-486e-9223-e1e98e047f41
+caps.latest.revision: 22
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# パス マークアップ構文
+パスは、後ほど[図形と WPF の概要での基本的な描画](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)と[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)、ただし、このトピックを詳しく説明よりコンパクトを使用してパス ジオメトリを指定するのに使用する、強力で複雑なミニ言語[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]です。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## <a name="prerequisites"></a>必須コンポーネント  
+ このトピックを理解する必要があります理解しておくの基本機能<xref:System.Windows.Media.Geometry>オブジェクトです。 詳細については、次を参照してください。、[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)します。  
+  
+<a name="abouthisdocument"></a>   
+## <a name="streamgeometry-and-pathfigurecollection-mini-languages"></a>StreamGeometry と PathFigureCollection のミニ言語  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]ジオメトリック パスを記述するためのミニ言語を提供する&2; つのクラスを提供します。 <xref:System.Windows.Media.StreamGeometry>と<xref:System.Windows.Media.PathFigureCollection>します。  
+  
+-   使用する、 <xref:System.Windows.Media.StreamGeometry>型のプロパティを設定するときのミニ言語<xref:System.Windows.Media.Geometry>など、<xref:System.Windows.UIElement.Clip%2A>のプロパティ、 <xref:System.Windows.UIElement>または<xref:System.Windows.Shapes.Path.Data%2A>のプロパティ、<xref:System.Windows.Shapes.Path>要素。 次の例では、属性の構文を使用して、作成、 <xref:System.Windows.Media.StreamGeometry>します。  
+  
+     [!code-xml[GeometrySample_snip_XAML#GraphicsMMStreamGeometryAttributeSyntaxInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample_snip_XAML/CS/MiniLanguageExample.xaml#graphicsmmstreamgeometryattributesyntaxinline)]  
+  
+-   使用する、 <xref:System.Windows.Media.PathFigureCollection>ミニ言語を設定する場合、<xref:System.Windows.Media.PathGeometry.Figures%2A>のプロパティ、 <xref:System.Windows.Media.PathGeometry>します。 次の例では、属性の構文を使用して、作成、 <xref:System.Windows.Media.PathFigureCollection>の<xref:System.Windows.Media.PathGeometry>します。  
+  
+     [!code-xml[GeometrySample_snip_XAML#GraphicsMMPathFigureCollectionAttributeSyntaxInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample_snip_XAML/CS/MiniLanguageExample.xaml#graphicsmmpathfigurecollectionattributesyntaxinline)]  
+  
+ 前の例からわかるように、2 つのミニ言語は、非常に似ています。 使用することは常に、 <xref:System.Windows.Media.PathGeometry>どのような状況を使用する場合に、 <xref:System.Windows.Media.StreamGeometry>; はどちらを使用する必要がありますか。 使用して、 <xref:System.Windows.Media.StreamGeometry>作成後にパスを変更する必要はありませんとを使用して、 <xref:System.Windows.Media.PathGeometry>はパスを変更する必要がある場合。  
+  
+ 違いの詳細については<xref:System.Windows.Media.PathGeometry>と<xref:System.Windows.Media.StreamGeometry>オブジェクトを参照してください、[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)します。  
+  
+### <a name="a-note-about-white-space"></a>空白に関する注意事項  
+ 簡潔にするために従うと、構文セクションには単一の空白が表示されるが、余分なスペースも許容可能な限り、1 つの領域を表示。  
+  
+ 2 つの数値実際をコンマまたは空白で区切ってが、これだけする場合でも、結果の文字列はあいまいです。 たとえば、`2..3`は実際には&2; つの数値:「2」になります。 "です。&3;"です。 同様に、`2-3`は「2」と「-3」です。 スペースは必要ありません、コマンドの前後にするか。  
+  
+### <a name="syntax"></a>構文  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]属性に使用する構文、 <xref:System.Windows.Media.StreamGeometry>は省略可能なので構成<xref:System.Windows.Media.FillRule>値と&1; つ以上の説明を図です。  
+  
+|StreamGeometry XAML 属性の使用方法|  
+|-----------------------------------------|  
+|`<`*object* *property* `="`[                                         `fillRule`]                                          `figureDescription`[                                         `figureDescription`]*`" ... />`|  
+  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)]属性に使用する構文、 <xref:System.Windows.Media.PathFigureCollection>は&1; つまたは複数の図の説明で構成されます。  
+  
+|PathFigureCollection XAML 属性の使用方法|  
+|-----------------------------------------------|  
+|`<`*object* *property* `="` `figureDescription`[                                         `figureDescription`]*`" ... />`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|*fillRule*|<xref:System.Windows.Media.FillRule?displayProperty=fullName><br /><br /> 指定するかどうか、 <xref:System.Windows.Media.StreamGeometry>を使用して、 <xref:System.Windows.Media.FillRule>または<xref:System.Windows.Media.FillRule><xref:System.Windows.Media.PathGeometry.FillRule%2A>します。<br /><br /> -   `F0`指定、 <xref:System.Windows.Media.FillRule>塗りつぶしルール。<br />-   `F1`指定、 <xref:System.Windows.Media.FillRule>塗りつぶしルール。<br /><br /> サブパスは、既定の動作を使用してこのコマンドを省略すると、 <xref:System.Windows.Media.FillRule>します。 このコマンドを指定する場合は最初に配置する必要があります。|  
+|*figureDescription*|コマンド、およびオプションの閉じるコマンド、[移動] コマンドから成る図を描画します。<br /><br /> `moveCommand` `drawCommands`  `[` `closeCommand` `]`|  
+|*moveCommand*|図の開始位置を指定する移動コマンドです。 参照してください、 [Move コマンド](#themovecommand)セクションです。|  
+|*drawCommands*|図の内容を記述する&1; つまたは複数の描画コマンドです。 参照してください、[描画コマンド](#drawcommands)セクションです。|  
+|*closeCommand*|図を閉じている省略可能な終了コマンドです。 参照してください、 [[閉じる] コマンド](#closecommand)セクションです。|  
+  
+<a name="themovecommand"></a>   
+## <a name="move-command"></a>移動 コマンド  
+ 新しい図形の開始位置を指定します。  
+  
+|構文|  
+|------------|  
+|`M`*startPoint*<br /><br /> または<br /><br /> `m`*startPoint*|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|*開始ポイント*|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 新しい図形の開始点。|  
+  
+ 大文字`M`ことを示します`startPoint`の絶対値は、小文字`m`ことを示します`startPoint`を過去の時点のオフセットです (0,&0;) が存在しない場合、またはです。 移動コマンドの後に複数のポイントを一覧表示行のコマンドを指定した場合に、それらのポイントにその行が描画されます。  
+  
+<a name="drawcommands"></a>   
+## <a name="draw-commands"></a>描画コマンド  
+ 描画コマンドは、図形のいくつかのコマンドで構成できます。 図形の次のコマンドを使用できます。 行、水平線、垂直線、3 次ベジエ曲線、二次ベジエ曲線、スムーズ&3; 次ベジエ曲線、二次ベジエ曲線を滑らかな、および楕円の円弧です。  
+  
+ 大文字または小文字のいずれかを使用して、各コマンドを入力: 大文字絶対値あり小文字のアルファベットが相対値を表す: そのセグメントの制御点は、前の例の終了位置。 同じ型の 1 つ以上のコマンドを順番に入力するは、重複するコマンドの入力を省略できます。たとえば、`L 100,200 300,400`は`L 100,200 L 300,400`です。 次の表の**移動**と**描画**コマンドです。  
+  
+### <a name="line-command"></a>コマンドライン  
+ 現在のポイントと指定の終了点を結ぶ線を作成します。                           `l 20 30``L 20,30`の有効な例を示します**行**コマンドです。  
+  
+|構文|  
+|------------|  
+|`L`*エンドポイント*<br /><br /> または<br /><br /> `l`*エンドポイント*|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|*エンドポイント*|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 線の終点。|  
+  
+### <a name="horizontal-line-command"></a>横線コマンド  
+ 現在のポイントと指定した x 座標の水平の線を作成します。                          `H 90`有効な横線コマンドの例に示します。  
+  
+|構文|  
+|------------|  
+|`H`  *x*<br /><br /> または<br /><br /> `h`  *x*|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|*x*|<xref:System.Double?displayProperty=fullName><br /><br /> 直線の終了点の x 座標。|  
+  
+### <a name="vertical-line-command"></a>縦線コマンド  
+ 現在のポイントと指定した座標の y 座標の垂直線を作成します。                          `v 90`有効な縦線コマンドの例に示します。  
+  
+|構文|  
+|------------|  
+|`V`  *y*<br /><br /> または<br /><br /> `v`  *y*|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|*y*|<xref:System.Double?displayProperty=fullName><br /><br /> 直線の終了点の y 座標。|  
+  
+### <a name="cubic-bezier-curve-command"></a>3 次ベジエ曲線コマンド  
+ 2 つの指定したコントロール ポイントを使用して、現在のポイントと指定したエンドポイント間で&3; 次ベジエ曲線を作成 ( `controlPoint`1 と`controlPoint`2)。                          `C 100,200 200,400 300,200`有効な曲線コマンドの例に示します。  
+  
+|構文|  
+|------------|  
+|`C` `controlPoint`1`controlPoint`2`endPoint`<br /><br /> または<br /><br /> `c` `controlPoint`1`controlPoint`2`endPoint`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`controlPoint`1|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線の開始の接線を決定する、曲線の最初の制御点です。|  
+|`controlPoint`2|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線の終了の接線を決定する、曲線の&2; 番目の制御点。|  
+|`endPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線を描画するポイント。|  
+  
+### <a name="quadratic-bezier-curve-command"></a>2 次ベジエ曲線コマンド  
+ 指定したコントロール ポイントを使用して、現在のポイントと指定したエンドポイント間で&2; 次ベジエ曲線を作成 ( `controlPoint`)。                          `q 100,200 300,200`2 次ベジエ曲線の有効なコマンドの例に示します。  
+  
+|構文|  
+|------------|  
+|`Q` `controlPoint` `endPoint`<br /><br /> または<br /><br /> `q` `controlPoint` `endPoint`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`controlPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 最初と最後の曲線の接線を決定する、曲線の制御点。|  
+|`endPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線を描画するポイント。|  
+  
+### <a name="smooth-cubic-bezier-curve-command"></a>3 次ベジエ曲線が滑らかなコマンド  
+ 現在のポイントと指定したエンドポイント間で&3; 次ベジエ曲線を作成します。 最初の制御点は、現在のポイントの基準とした前のコマンドの&2; 番目の制御点のリフレクションと見なされます。 前のコマンドが存在しない場合、または前のコマンドはなかった場合&3; 次ベジエ曲線コマンドまたはスムーズ&3; 次ベジエ曲線のコマンドは、最初の制御点は、現在のポイントと一致すると仮定します。 2 番目の制御点、曲線の終了の制御点を指定して`controlPoint`2 です。 たとえば、`S 100,200 200,300`有効なスムーズ 3 次ベジエ曲線コマンドです。  
+  
+|構文|  
+|------------|  
+|`S` `controlPoint`2`endPoint`<br /><br /> または<br /><br /> `s` `controlPoint`2`endPoint`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`controlPoint`2|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線の終了の接線を決定する、曲線の制御点。|  
+|`endPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線を描画するポイント。|  
+  
+### <a name="smooth-quadratic-bezier-curve-command"></a>2 次ベジエ曲線が滑らかなコマンド  
+ 現在のポイントと指定したエンドポイント間で&2; 次ベジエ曲線を作成します。 コントロール ポイントは、現在のポイントの基準とした前のコマンドの制御点のリフレクションと見なされます。 前のコマンドが存在しない場合、または前のコマンドはなかった場合、2 次ベジエ曲線コマンドまたはスムーズ&2; 次ベジエ曲線のコマンドは、コントロール ポイントは、現在のポイントと一致します。  
+  
+|構文|  
+|------------|  
+|`T` `controlPoint` `endPoint`<br /><br /> または<br /><br /> `t` `controlPoint` `endPoint`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`controlPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 起動して、曲線の接線を決定する、曲線の制御点。|  
+|`endPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 曲線を描画するポイント。|  
+  
+### <a name="elliptical-arc-command"></a>楕円の円弧コマンド  
+ 現在のポイントと指定したエンドポイント間での楕円の円弧を作成します。  
+  
+|構文|  
+|------------|  
+|`A` `size` `rotationAngle` `isLargeArcFlag` `sweepDirectionFlag` `endPoint`<br /><br /> または<br /><br /> `a` `size` `rotationAngle` `isLargeArcFlag` `sweepDirectionFlag` `endPoint`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`size`|<xref:System.Windows.Size?displayProperty=fullName><br /><br /> 円弧の x 半径と y 半径。|  
+|`rotationAngle`|<xref:System.Double?displayProperty=fullName><br /><br /> (度単位)、楕円の回転が異なります。|  
+|`isLargeArcFlag`|円弧の角度が 180 度べき場合 1 に設定。それ以外の場合、0 に設定します。|  
+|`sweepDirectionFlag`|正の角の方向に弧が描画された場合は、1 に設定します。それ以外の場合、0 に設定します。|  
+|`endPoint`|<xref:System.Windows.Point?displayProperty=fullName><br /><br /> 円弧が描画される点。|  
+  
+<a name="closecommand"></a>   
+## <a name="the-close-command"></a>[閉じる] コマンド  
+ 現在の図を終了し、図の開始点を現在の点を結ぶ線を作成します。 このコマンドでは、最後のセグメントと、図の最初のセグメントの間に線結合 (上) を作成します。  
+  
+|構文|  
+|------------|  
+|`Z`<br /><br /> または<br /><br /> `z`|  
+  
+<a name="pointsyntax"></a>   
+## <a name="point-syntax"></a>点の構文  
+ 点の x 座標と y 座標をについて説明します。  
+  
+|構文|  
+|------------|  
+|`x` `,` `y`<br /><br /> または<br /><br /> `x` `y`|  
+  
+|用語|説明|  
+|----------|-----------------|  
+|`x`|<xref:System.Double?displayProperty=fullName><br /><br /> 点の x 座標。|  
+|`y`|<xref:System.Double?displayProperty=fullName><br /><br /> 点の y 座標。|  
+  
+<a name="specialvalues"></a>   
+## <a name="special-values"></a>特殊な値  
+ 標準的な数値ではなく、次の特殊な値を使用することもできます。 これらの値は大文字小文字を区別します。  
+  
+ 無限大  
+ 表す<xref:System.Double.PositiveInfinity?displayProperty=fullName>します。  
+  
+ -Infinity  
+ 表す<xref:System.Double.NegativeInfinity?displayProperty=fullName>します。  
+  
+ NaN  
+ 表す<xref:System.Double.NaN?displayProperty=fullName>します。  
+  
+ また、科学的表記法を使用することがあります。 たとえば、`+1.e17`有効な値です。  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.Windows.Shapes.Path>   
+ <xref:System.Windows.Media.StreamGeometry>   
+ <xref:System.Windows.Media.PathGeometry>   
+ <xref:System.Windows.Media.PathFigureCollection>   
+ [図形と基本描画の WPF の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [操作方法に関するトピック](../../../../docs/framework/wpf/graphics-multimedia/geometries-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md b/docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md
new file mode 100644
index 00000000000..6296e84f807
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md
@@ -0,0 +1,132 @@
+---
+title: "プロパティ アニメーションの手法の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アニメーション, プロパティ, 手法"
+  - "プロパティ, 手法 (アニメーションの)"
+ms.assetid: 74f61413-f8c0-4e75-bf04-951886426c8b
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# プロパティ アニメーションの手法の概要
+ここでは、ストーリーボード、ローカル アニメーション、クロック、フレーム単位のアニメーションなど、プロパティをアニメーション化するためのさまざまな方法を示します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」で説明されている基本的なアニメーション機能に精通している必要があります。  
+  
+<a name="summary"></a>   
+## アニメーション化のための各種方法  
+ プロパティのアニメーション化には多数の異なるシナリオがあるため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、プロパティをアニメーション化するために複数の方法を利用できます。  
+  
+ それぞれの方法について、インスタンス単位、スタイル内、コントロール テンプレート内、またはデータ テンプレート内で使用できるかどうか、[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で使用できるかどうか、およびアニメーションを対話的に制御できるかどうかを次の表に示します。  "インスタンス単位" とは、スタイル、コントロール テンプレート、またはデータ テンプレート内のインスタンスではなく、オブジェクトのインスタンスに直接アニメーションまたはストーリーボードを適用する方法のことです。  
+  
+|アニメーションの手法|シナリオ|XAML のサポート|対話的に制御可能|  
+|----------------|----------|----------------|--------------|  
+|ストーリーボード アニメーション|インスタンス単位、<xref:System.Windows.Style>、<xref:System.Windows.Controls.ControlTemplate>、<xref:System.Windows.DataTemplate>|○|○|  
+|ローカル アニメーション|インスタンス単位|Ｘ|Ｘ|  
+|クロック アニメーション|インスタンス単位|Ｘ|○|  
+|フレーム単位のアニメーション|インスタンス単位|Ｘ|N\/A|  
+  
+<a name="storyboard_animations"></a>   
+## ストーリーボード アニメーション  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でアニメーションを定義して適用する場合、アニメーションを開始後に対話的に制御する場合、アニメーションの複雑なツリーを作成する場合、または <xref:System.Windows.Style>、<xref:System.Windows.Controls.ControlTemplate>、<xref:System.Windows.DataTemplate> でアニメーション化する場合は、<xref:System.Windows.Media.Animation.Storyboard> を使用します。  <xref:System.Windows.Media.Animation.Storyboard> によってアニメーション化するオブジェクトについては、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> である必要があります。あるいは、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> を設定するために使用されている必要があります。  詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> はコンテナー <xref:System.Windows.Media.Animation.Timeline> の特殊な型であり、含まれる複数のアニメーションの対象情報を持っています。  <xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーション化するには、次の 3 つの手順を実行します。  
+  
+1.  <xref:System.Windows.Media.Animation.Storyboard> および 1 つ以上のアニメーションを宣言します。  
+  
+2.  <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> [添付プロパティ](GTMT)および <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A> 添付プロパティを使用して、各アニメーションのターゲット オブジェクトおよびプロパティを指定します。  
+  
+3.  \(コードのみ\) <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> の <xref:System.Windows.NameScope> を定義します。  アニメーション化するオブジェクトの名前を、その <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> に登録します。  
+  
+4.  <xref:System.Windows.Media.Animation.Storyboard> を開始します。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> を開始すると、アニメーションがアニメーション化するプロパティに適用され、開始されます。  <xref:System.Windows.Media.Animation.Storyboard> を開始するには、2 とおりの方法があります。<xref:System.Windows.Media.Animation.Storyboard> クラスによって提供される <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用するか、<xref:System.Windows.Media.Animation.BeginStoryboard> アクションを使用します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でアニメーション化するには、<xref:System.Windows.Media.Animation.BeginStoryboard> アクションを使用する以外に方法はありません。A <xref:System.Windows.Media.Animation.BeginStoryboard> アクションは、<xref:System.Windows.EventTrigger>、<xref:System.Windows.Trigger> プロパティ、または <xref:System.Windows.DataTrigger> で使用できます。  
+  
+ 各 <xref:System.Windows.Media.Animation.Storyboard> の開始方法がサポートされているさまざまな場所、インスタンス単位、スタイル、コントロール テンプレート、およびデータ テンプレートを次の表に示します。  
+  
+|ストーリーボードが開始される場所|インスタンス単位|スタイル|コントロール テンプレート|データ テンプレート|例|  
+|----------------------|--------------|----------|-------------------|----------------|-------|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.EventTrigger>|○|○|○|○|[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.Trigger> プロパティ|Ｘ|○|○|○|[プロパティ値が変化したときにアニメーションをトリガーする](../../../../docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md)|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.DataTrigger>|Ｘ|○|○|○|[How to: Trigger an Animation When Data Changes](http://msdn.microsoft.com/ja-jp/a736bb3a-2ae5-479a-a33a-75a27055d863)|  
+|<xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッド|○|Ｘ|Ｘ|Ｘ|[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)|  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトの詳細については、「[ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)」を参照してください。  
+  
+## ローカル アニメーション  
+ ローカル アニメーションは、任意の <xref:System.Windows.Media.Animation.Animatable> オブジェクトの[依存関係プロパティ](GTMT)をアニメーション化するための便利な方法を提供します。  プロパティに適用するアニメーションが 1 つだけであり、アニメーションを開始後に対話的に制御する必要がない場合は、ローカル アニメーションを使用します。  <xref:System.Windows.Media.Animation.Storyboard> アニメーションとは異なり、ローカル アニメーションは、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> に関連付けられていないオブジェクトをアニメーション化できます。  この種類のアニメーションには <xref:System.Windows.NameScope> を定義する必要はありません。  
+  
+ ローカル アニメーションはコードだけで使用できます。スタイル、コントロール テンプレート、またはデータ テンプレート内では定義できません。  ローカル アニメーションは、開始後に対話的に制御できません。  
+  
+ ローカル アニメーションを使用してアニメーション化するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Media.Animation.AnimationTimeline> オブジェクトを作成します。  
+  
+2.  アニメーション化するオブジェクトの <xref:System.Windows.Media.Animation.Animatable.BeginAnimation%2A> メソッドを使用して、指定するプロパティに <xref:System.Windows.Media.Animation.AnimationTimeline> を適用します。  
+  
+ <xref:System.Windows.Controls.Button> の幅および背景色をアニメーション化する方法を次の例に示します。  
+  
+ [!code-cpp[animateproperty#11](../../../../samples/snippets/cpp/VS_Snippets_Wpf/animateproperty/CPP/LocalAnimationExample.cpp#11)]
+ [!code-csharp[animateproperty#11](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animateproperty/CSharp/LocalAnimationExample.cs#11)]
+ [!code-vb[animateproperty#11](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animateproperty/VisualBasic/LocalAnimationExample.vb#11)]  
+  
+## クロック アニメーション  
+ <xref:System.Windows.Media.Animation.Storyboard> を使用せずにアニメーション化する際に、複雑なタイミング ツリーを作成する場合、またはアニメーションを開始後に対話的に制御する場合は、<xref:System.Windows.Media.MediaPlayer.Clock%2A> オブジェクトを使用します。  Clock オブジェクトを使用すると、任意の <xref:System.Windows.Media.Animation.Animatable> オブジェクトの[依存関係プロパティ](GTMT)をアニメーション化できます。  
+  
+ <xref:System.Windows.Media.Animation.Clock> オブジェクトは、スタイル、コントロール テンプレート、またはデータ テンプレート内で直接アニメーション化するために使用することはできません   \(アニメーションとタイミング システムは、実際に <xref:System.Windows.Media.Animation.Clock> オブジェクトを使用して、スタイル、コントロール テンプレート、およびデータ テンプレート内でアニメーション化しますが、そのためには、これらの <xref:System.Windows.Media.Animation.Clock> オブジェクトを <xref:System.Windows.Media.Animation.Storyboard> から作成する必要があります。  <xref:System.Windows.Media.Animation.Storyboard> オブジェクトと <xref:System.Windows.Media.Animation.Clock> オブジェクトの関係の詳細については、「[アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)」を参照してください。  
+  
+ プロパティに 1 つの <xref:System.Windows.Media.Animation.Clock> を適用するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Media.Animation.AnimationTimeline> オブジェクトを作成します。  
+  
+2.  <xref:System.Windows.Media.Animation.AnimationTimeline> の <xref:System.Windows.Media.Animation.AnimationTimeline.CreateClock%2A> メソッドを使用して <xref:System.Windows.Media.Animation.AnimationClock> を作成します。  
+  
+3.  アニメーション化するオブジェクトの <xref:System.Windows.Media.Animation.Animatable.ApplyAnimationClock%2A> メソッドを使用して、指定するプロパティに <xref:System.Windows.Media.Animation.AnimationClock> を適用します。  
+  
+ <xref:System.Windows.Media.Animation.AnimationClock> を作成し、2 つの類似するプロパティにこれを適用する方法を次の例に示します。  
+  
+ [!code-csharp[timingbehaviors_procedural_snip#GraphicsMMCreateAnimationClockWholeClass](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_procedural_snip/CSharp/AnimationClockExample.cs#graphicsmmcreateanimationclockwholeclass)]
+ [!code-vb[timingbehaviors_procedural_snip#GraphicsMMCreateAnimationClockWholeClass](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/timingbehaviors_procedural_snip/visualbasic/animationclockexample.vb#graphicsmmcreateanimationclockwholeclass)]  
+  
+ タイミング ツリーを作成し、これを使用してプロパティをアニメーション化するには、次の手順を実行します。  
+  
+1.  <xref:System.Windows.Media.Animation.ParallelTimeline> オブジェクトと <xref:System.Windows.Media.Animation.AnimationTimeline> オブジェクトを使用して、タイミング ツリーを作成します。  
+  
+2.  ルート <xref:System.Windows.Media.Animation.ParallelTimeline> の <xref:System.Windows.Media.Animation.TimelineGroup.CreateClock%2A> を使用して <xref:System.Windows.Media.Animation.ClockGroup> を作成します。  
+  
+3.  <xref:System.Windows.Media.Animation.ClockGroup> の <xref:System.Windows.Media.Animation.ClockGroup.Children%2A> を反復処理し、その子 <xref:System.Windows.Media.Animation.Clock> オブジェクトを適用します。  子 <xref:System.Windows.Media.Animation.AnimationClock> ごとに、アニメーション化するオブジェクトの <xref:System.Windows.Media.Animation.Animatable.ApplyAnimationClock%2A> メソッドを使用して、指定するプロパティに <xref:System.Windows.Media.Animation.AnimationClock> を適用します。  
+  
+ Clock オブジェクトの詳細については、「[アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)」を参照してください。  
+  
+## フレーム単位アニメーション : アニメーションとタイミング システムのバイパス  
+ この方法は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アニメーション システムを完全にバイパスする必要がある場合に使用します。  この方法の 1 つのシナリオは、アニメーションの各ステップで、オブジェクトの最後の一連のやり取りに基づいてオブジェクトの再計算が必要になる物理アニメーションです。  
+  
+ フレーム単位アニメーションは、スタイル、コントロール テンプレート、またはデータ テンプレート内で定義できません。  
+  
+ フレームごとにアニメーション化するには、アニメーション化するオブジェクトを格納しているオブジェクトの <xref:System.Windows.Media.CompositionTarget.Rendering> イベントで登録します。  このイベント ハンドラー メソッドは、フレームごとに 1 回呼び出されます。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] が[ビジュアル ツリー](GTMT)の永続化されたレンダリング データを構成ツリーにマーシャリングするたびに、イベント ハンドラー メソッドが呼び出されます。  
+  
+ イベント ハンドラーでは、アニメーション効果に必要なあらゆる計算を実行し、これらの値を使用してアニメーション化するオブジェクトのプロパティを設定します。  
+  
+ 現在のフレームの表現時間を取得するには、このイベントに関連付けられている <xref:System.EventArgs> を、<xref:System.Windows.Media.RenderingEventArgs> としてキャストできます。これにより、現在のフレームのレンダリング時間を取得するために使用できる <xref:System.Windows.Media.RenderingEventArgs.RenderingTime%2A> プロパティが提供されます。  
+  
+ 詳細については、<xref:System.Windows.Media.CompositionTarget.Rendering> のページを参照してください。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [ストーリーボードの概要](../../../../docs/framework/wpf/graphics-multimedia/storyboards-overview.md)   
+ [アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)   
+ [依存関係プロパティの概要](../../../../docs/framework/wpf/advanced/dependency-properties-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md b/docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md
new file mode 100644
index 00000000000..b8184b13e03
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md
@@ -0,0 +1,233 @@
+---
+title: "WPF での図形と基本描画の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "基本描画"
+  - "図形オブジェクト"
+  - "形状, 図形の概要"
+  - "ベクター描画, 概要"
+  - "ベクター, 描画"
+ms.assetid: 66d7a6d6-e3b6-47bc-8dfe-8a1b26f7d901
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# WPF での図形と基本描画の概要
+ここでは、<xref:System.Windows.Shapes.Shape> オブジェクトを使用した描画方法の概要を示します。  <xref:System.Windows.Shapes.Shape> は、画面に図形を描画できるようにする <xref:System.Windows.UIElement> の一種です。  <xref:System.Windows.Shapes.Shape> オブジェクトは UI 要素であるため、<xref:System.Windows.Controls.Panel> 要素およびほとんどのコントロール内で使用できます。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、グラフィックス サービスやレンダリング サービスへのアクセスのレイヤーがいくつか用意されています。  最上位レイヤーにある <xref:System.Windows.Shapes.Shape> オブジェクトは使いやすく、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] イベント システムでのレイアウトや参加などのさまざまな役立つ機能を提供します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="shapes"></a>   
+## 図形オブジェクト  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、すぐに使用できるさまざまな <xref:System.Windows.Shapes.Shape> オブジェクトが用意されています。  すべての図形オブジェクトは <xref:System.Windows.Shapes.Shape> クラスから継承されます。  使用可能な図形オブジェクトには、<xref:System.Windows.Shapes.Ellipse>、<xref:System.Windows.Shapes.Line>、<xref:System.Windows.Shapes.Path>、<xref:System.Windows.Shapes.Polygon>、<xref:System.Windows.Shapes.Polyline>、<xref:System.Windows.Shapes.Rectangle> などがあります。<xref:System.Windows.Shapes.Shape> オブジェクトは、次の共通プロパティを共有します。  
+  
+-   <xref:System.Windows.Shapes.Shape.Stroke%2A> : 図形のアウトラインをどのように塗りつぶすかを示します。  
+  
+-   <xref:System.Windows.Shapes.Shape.StrokeThickness%2A> : 図形のアウトラインの太さを示します。  
+  
+-   <xref:System.Windows.Shapes.Shape.Fill%2A> : 図形の内部をどのように塗りつぶすかを示します。  
+  
+-   [デバイス非依存ピクセル](GTMT)単位で計測される座標と頂点を指定するデータ プロパティ。  
+  
+ 図形オブジェクトは <xref:System.Windows.UIElement> から派生するため、パネルおよびほとんどのコントロール内で使用できます。  <xref:System.Windows.Controls.Canvas> パネルは子オブジェクトの絶対配置をサポートするため、複雑な描画の作成に特に適しています。  
+  
+ <xref:System.Windows.Shapes.Line> クラスを使用すると、2 つの点の間の直線を描画できます。  直線の座標およびストローク プロパティを指定するいくつかの方法を次の例に示します。  
+  
+ [!code-xml[drawingwithshapeelements#LineExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingWithShapeElements/CS/lineexample.xaml#lineexample1)]  
+  
+ [!code-cpp[shapesprocedural#ShapesProceduralLine](../../../../samples/snippets/cpp/VS_Snippets_Wpf/ShapesProcedural/CPP/ShapesProcedural.cpp#shapesproceduralline)]
+ [!code-csharp[shapesprocedural#ShapesProceduralLine](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ShapesProcedural/Csharp/ShapesProcedural.cs#shapesproceduralline)]
+ [!code-vb[shapesprocedural#ShapesProceduralLine](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/ShapesProcedural/VisualBasic/ShapesProceduralVB.vb#shapesproceduralline)]  
+  
+ レンダリングされた <xref:System.Windows.Shapes.Line> を次の図に示します。  
+  
+ ![線の図](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-line2.png "shape\_ovw\_line2")  
+  
+ <xref:System.Windows.Shapes.Line> クラスは <xref:System.Windows.Shapes.Shape.Fill%2A> プロパティを提供しますが、<xref:System.Windows.Shapes.Line> には領域がないため、そのプロパティを設定しても無効です。  
+  
+ もう 1 つの一般的な図形は <xref:System.Windows.Shapes.Ellipse> です。  <xref:System.Windows.Shapes.Ellipse> は、図形の <xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> プロパティを定義して作成します。  円を描画するには、<xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> の値が等しい <xref:System.Windows.Shapes.Ellipse> を指定します。  
+  
+ [!code-xml[ShapeOverviews#ShapesOVW1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/ShapeOverviews/CS/Window1.xaml#shapesovw1)]  
+  
+ [!code-csharp[brushesmiscsnippets_procedural_snip#SetBackgroundColorOfShapeCodeExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesMiscSnippets_procedural_snip/CSharp/SetBackgroundColorOfShapeExample.cs#setbackgroundcolorofshapecodeexamplewholepage)]
+ [!code-vb[brushesmiscsnippets_procedural_snip#SetBackgroundColorOfShapeCodeExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesMiscSnippets_procedural_snip/visualbasic/setbackgroundcolorofshapeexample.vb#setbackgroundcolorofshapecodeexamplewholepage)]  
+  
+ レンダリングされた <xref:System.Windows.Shapes.Ellipse> の例を次の図に示します。  
+  
+ ![楕円の図](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-ellipse2.png "shape\_ovw\_ellipse2")  
+  
+<a name="paths"></a>   
+## パスとジオメトリの使用  
+ <xref:System.Windows.Shapes.Path> クラスを使用すると、曲線および複雑な図形を描画できます。  これらの曲線および図形は、<xref:System.Windows.Media.Geometry> オブジェクトを使用して表現されます。  <xref:System.Windows.Shapes.Path> を使用するには、<xref:System.Windows.Media.Geometry> を作成し、それを使用して <xref:System.Windows.Shapes.Path> オブジェクトの <xref:System.Windows.Shapes.Path.Data%2A> プロパティを設定します。  
+  
+ さまざまな <xref:System.Windows.Media.Geometry> オブジェクトが用意されています。  <xref:System.Windows.Media.LineGeometry>、<xref:System.Windows.Media.RectangleGeometry>、および <xref:System.Windows.Media.EllipseGeometry> クラスは、比較的単純な図形を表現します。  より複雑な図形または曲線を作成するには、<xref:System.Windows.Media.PathGeometry> を使用します。  
+  
+<a name="pathgeometry"></a>   
+### PathGeometry と PathSegment  
+ <xref:System.Windows.Media.PathGeometry> オブジェクトは 1 つ以上の <xref:System.Windows.Media.PathFigure> オブジェクトで構成され、各 <xref:System.Windows.Media.PathFigure> は異なる "形状" または図形を表します。  各 <xref:System.Windows.Media.PathFigure> 自体は 1 つ以上の <xref:System.Windows.Media.PathSegment> オブジェクトで構成されており、このオブジェクトは形状または図形の接続されている部分を表します。  セグメントの種類には、<xref:System.Windows.Media.LineSegment>、<xref:System.Windows.Media.BezierSegment>、<xref:System.Windows.Media.ArcSegment> などがあります。  
+  
+ 次の例では、<xref:System.Windows.Shapes.Path> を使用して 2 次ベジエ曲線を描画します。  
+  
+ [!code-xml[geometrysample#34](../../../../samples/snippets/csharp/VS_Snippets_Wpf/GeometrySample/CS/pathgeometryexample.xaml#34)]  
+  
+ レンダリングされた図形を次の図に示します。  
+  
+ ![パスの図](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-path2.png "shape\_ovw\_path2")  
+  
+ <xref:System.Windows.Media.PathGeometry> およびその他の <xref:System.Windows.Media.Geometry> クラスの詳細については、「[ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)」を参照してください。  
+  
+<a name="pathdatastring"></a>   
+### 省略された XAML 構文  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] では、省略された特殊な構文を使用して <xref:System.Windows.Shapes.Path> を記述することもできます。  次の例では、省略された構文を使用して複雑な図形を描画します。  
+  
+```xaml  
+<Path Stroke="DarkGoldenRod" StrokeThickness="3"   
+Data="M 100,200 C 100,25 400,350 400,175 H 280" />  
+```  
+  
+ レンダリングされた <xref:System.Windows.Shapes.Path> を次の図に示します。  
+  
+ ![パスの図](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-path.png "shape\_ovw\_path")  
+  
+ <xref:System.Windows.Shapes.Path.Data%2A> 属性文字列は、M で示される "moveto" コマンドで始まります。このコマンドは、<xref:System.Windows.Controls.Canvas> の座標系のパスの始点を設定します。  <xref:System.Windows.Shapes.Path> データ パラメーターでは、大文字と小文字が区別されます。  大文字の M は、現在の新しい点の絶対位置を示します。  小文字の m は、相対座標を示します。  最初のセグメントは、2 つの制御点 \(100,25\) と \(400,350\) を使用して描画される、始点が \(100,200\) で終点が \(400,175\) の 3 次[ベジエ曲線](GTMT)です。  このセグメントは、<xref:System.Windows.Shapes.Path.Data%2A> 属性文字列の C コマンドで示されます。  ここでも、大文字の C は絶対パスを示し、小文字の c は相対パスを示します。  
+  
+ 2 番目のセグメントは、絶対水平 "lineto" コマンド H で始まります。このコマンドは、前のサブパスの終点 \(400,175\) から新しい終点 \(280,175\) まで描画される直線を指定します。  水平 "lineto" コマンドであるため、指定される値は x 座標です。  
+  
+ パスの構文全体については、<xref:System.Windows.Shapes.Path.Data%2A> のリファレンスと「[PathGeometry を使用して図形を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-create-a-shape-by-using-a-pathgeometry.md)」を参照してください。  
+  
+<a name="fillpaint"></a>   
+## 図形の塗りつぶし  
+ <xref:System.Windows.Media.Brush> オブジェクトは、図形の <xref:System.Windows.Shapes.Shape.Stroke%2A> および <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす場合に使用します。  次の例では、<xref:System.Windows.Shapes.Ellipse> のストロークおよび塗りつぶしを指定します。  ブラシ プロパティの有効な入力は、キーワードまたは 16 進数のカラー値のいずれかです。  使用可能なカラー キーワードの詳細については、<xref:System.Windows.Media> 名前空間の <xref:System.Windows.Media.Colors> クラスのプロパティを参照してください。  
+  
+```  
+  
+<Canvas Background="LightGray">   
+   <Ellipse  
+      Canvas.Top="50"  
+      Canvas.Left="50"  
+      Fill="#FFFFFF00"  
+      Height="75"  
+      Width="75"  
+      StrokeThickness="5"  
+      Stroke="#FF0000FF"/>  
+</Canvas>  
+  
+```  
+  
+ レンダリングされた <xref:System.Windows.Shapes.Ellipse> を次の図に示します。  
+  
+ ![楕円](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-ellipsefill.png "shape\_ovw\_ellipsefill")  
+  
+ このほか、プロパティ要素構文を使用して <xref:System.Windows.Media.SolidColorBrush> オブジェクトを明示的に作成し、純色で図形を塗りつぶすこともできます。  
+  
+```  
+  
+<!-- This polygon shape uses pre-defined color values for its Stroke and  
+     Fill properties.   
+     The SolidColorBrush's Opacity property affects the fill color in   
+     this case by making it slightly transparent (opacity of 0.4) so   
+     that it blends with any underlying color. -->  
+  
+<Polygon  
+    Points="300,200 400,125 400,275 300,200"  
+    Stroke="Purple"   
+    StrokeThickness="2">  
+    <Polygon.Fill>  
+       <SolidColorBrush Color="Blue" Opacity="0.4"/>  
+    </Polygon.Fill>  
+</Polygon>  
+```  
+  
+ レンダリングされた図形を次の図に示します。  
+  
+ ![SolidColorBrush の図](../../../../docs/framework/wpf/graphics-multimedia/media/shape-ovw-solidcolorbrush.png "shape\_ovw\_solidcolorbrush")  
+  
+ 図形のストロークまたは塗りつぶしをグラデーション、イメージ、パターンなどで塗りつぶすこともできます。  詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  
+  
+<a name="stretchableshapessection"></a>   
+## 伸縮可能な図形  
+ <xref:System.Windows.Shapes.Line>、<xref:System.Windows.Shapes.Path>、<xref:System.Windows.Shapes.Polygon>、<xref:System.Windows.Shapes.Polyline>、および <xref:System.Windows.Shapes.Rectangle> クラスには、すべて <xref:System.Windows.Shapes.Shape.Stretch%2A> プロパティがあります。  このプロパティは、<xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツ \(描画される図形\) をどのように引き伸ばして <xref:System.Windows.Shapes.Shape> オブジェクトのレイアウト空間を塗りつぶすかを決定します。  <xref:System.Windows.Shapes.Shape> オブジェクトのレイアウト空間は、明示的な <xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> 設定または <xref:System.Windows.FrameworkElement.HorizontalAlignment%2A> および <xref:System.Windows.FrameworkElement.VerticalAlignment%2A> 設定のために、レイアウト システムによって <xref:System.Windows.Shapes.Shape> に割り当てられるスペースです。  Windows Presentation Foundation のレイアウトの詳細については、「[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)」を参照してください。  
+  
+ Stretch プロパティには、次のいずれかの値を指定します。  
+  
+-   <xref:System.Windows.Media.Stretch> : <xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツは引き伸ばされません。  
+  
+-   <xref:System.Windows.Media.Stretch> : <xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツは、レイアウト空間を塗りつぶすように引き伸ばされます。  縦横比は維持されません。  
+  
+-   <xref:System.Windows.Media.Stretch> : <xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツは、元の縦横比を維持しながら、レイアウト空間を塗りつぶすように可能な限り引き伸ばされます。  
+  
+-   <xref:System.Windows.Media.Stretch> : <xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツは、元の縦横比を維持しながら、レイアウト空間を完全に塗りつぶすように引き伸ばされます。  
+  
+ <xref:System.Windows.Shapes.Shape> オブジェクトのコンテンツを引き伸ばすとき、<xref:System.Windows.Shapes.Shape> オブジェクトのアウトラインは、引き伸ばされた後に塗りつぶされます。  
+  
+ 次の例では、<xref:System.Windows.Shapes.Polygon> を使用して、頂点が \(0,0\)、\(0,1\)、および \(1,1\) の非常に小さい三角形を描画します。  <xref:System.Windows.Shapes.Polygon> オブジェクトの <xref:System.Windows.FrameworkElement.Width%2A> および <xref:System.Windows.FrameworkElement.Height%2A> は 100 に設定され、その Stretch プロパティは Fill に設定されます。  その結果、<xref:System.Windows.Shapes.Polygon> オブジェクトのコンテンツ \(三角形\) は、より大きい空間を塗りつぶすように引き伸ばされます。  
+  
+```  
+...  
+<Polygon  
+  Points="0,0 0,1 1,1"  
+  Fill="Blue"  
+  Width="100"  
+  Height="100"  
+  Stretch="Fill"  
+  Stroke="Black"  
+  StrokeThickness="2" />  
+...  
+```  
+  
+```  
+...  
+PointCollection myPointCollection = new PointCollection();  
+myPointCollection.Add(new Point(0,0));  
+myPointCollection.Add(new Point(0,1));  
+myPointCollection.Add(new Point(1,1));  
+  
+Polygon myPolygon = new Polygon();  
+myPolygon.Points = myPointCollection;  
+myPolygon.Fill = Brushes.Blue;  
+myPolygon.Width = 100;  
+myPolygon.Height = 100;  
+myPolygon.Stretch = Stretch.Fill;  
+myPolygon.Stroke = Brushes.Black;  
+myPolygon.StrokeThickness = 2;  
+...  
+```  
+  
+<a name="transforms"></a>   
+## 図形の変換  
+ <xref:System.Windows.Media.Transform> クラスは、2 次元の平面で図形を変換する手段を提供します。  変換には、回転 \(<xref:System.Windows.Media.RotateTransform>\)、スケーリング \(<xref:System.Windows.Media.ScaleTransform>\)、傾斜 \(<xref:System.Windows.Media.SkewTransform>\)、および平行移動 \(<xref:System.Windows.Media.TranslateTransform>\) などのさまざまな種類があります。  
+  
+ 図形に適用される一般的な変換は回転です。  図形を回転するには、<xref:System.Windows.Media.RotateTransform> を作成し、その <xref:System.Windows.Media.RotateTransform.Angle%2A> を指定します。  <xref:System.Windows.Media.RotateTransform.Angle%2A> が 45 の場合は要素が時計回りに 45 度回転し、90 では要素が時計回りに 90 度回転します。  要素の回転の中心点を設定するには、<xref:System.Windows.Media.RotateTransform.CenterX%2A> と <xref:System.Windows.Media.RotateTransform.CenterY%2A> のプロパティを設定します。  これらのプロパティ値は、変換する要素の座標空間で表します。  <xref:System.Windows.Media.RotateTransform.CenterX%2A> および <xref:System.Windows.Media.RotateTransform.CenterY%2A> の既定値は 0 です。  最後に、要素に <xref:System.Windows.Media.RotateTransform> を適用します。  変換がレイアウトに影響しないようにする場合は、図形の <xref:System.Windows.UIElement.RenderTransform%2A> プロパティを設定します。  
+  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を使用して、図形をその左上隅 \(0,0\) を中心に 45 度回転しています。  
+  
+ [!code-xml[transformssample#14](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/RotateTransformExample.xaml#14)]  
+  
+ 次の例では、別の図形を 45 度回転していますが、この場合は \(25,50\) が回転の中心です。  
+  
+ [!code-xml[transformssample#15](../../../../samples/snippets/csharp/VS_Snippets_Wpf/transformsSample/CS/RotateTransformExample.xaml#15)]  
+  
+ 上記 2 つの変換を適用すると、結果は次の図のようになります。  
+  
+ ![中心点が異なる 45 度の回転](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-graphicsmm-rotatetransform45degrees.png "wcpsdk\_graphicsmm\_rotatetransform45degrees")  
+  
+ 前の例では、単一の変換を各図形オブジェクトに適用しました。  1 つの図形 \(またはその他の UI 要素\) に複数の変換を適用するには、<xref:System.Windows.Media.TransformGroup> を使用します。  
+  
+## 参照  
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [ジオメトリの概要](../../../../docs/framework/wpf/graphics-multimedia/geometry-overview.md)   
+ [チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/shapes-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/shapes-how-to-topics.md
new file mode 100644
index 00000000000..8c3952dcfe3
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/shapes-how-to-topics.md
@@ -0,0 +1,39 @@
+---
+title: "図形に関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "描画, 線"
+  - "図形オブジェクト"
+  - "Shape 型"
+  - "形状, 方法トピック"
+ms.assetid: 91a371f1-81e4-40da-ad61-ec24167152e6
+caps.latest.revision: 71
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 71
+---
+# 図形に関する「方法」トピック
+このセクションのトピックでは、<xref:System.Windows.Shapes.Shape> オブジェクトを使用して基本的な図形を画面に描画する方法について説明します。  
+  
+## このセクションの内容  
+ [多角形要素を使用して、閉じた図形を描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-a-closed-shape-by-using-the-polygon-element.md)  
+ [楕円または円を描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-an-ellipse-or-a-circle.md)  
+ [線を描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-a-line.md)  
+ [ポリライン要素を使用してポリラインを描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-a-polyline-by-using-the-polyline-element.md)  
+ [四角形を描画する](../../../../docs/framework/wpf/graphics-multimedia/how-to-draw-a-rectangle.md)  
+ [直線または線分の終点のキャップを変更する](../../../../docs/framework/wpf/graphics-multimedia/how-to-modify-the-cap-at-the-end-of-a-line-or-segment.md)  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Shape>   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/shapes.md b/docs/framework/wpf/graphics-multimedia/shapes.md
new file mode 100644
index 00000000000..94b4f8cbc63
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/shapes.md
@@ -0,0 +1,41 @@
+---
+title: "図形 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "描画, 形状"
+  - "Geometry オブジェクト"
+  - "グラフィックス, 図形オブジェクト"
+  - "塗りつぶし (図形を)"
+  - "Path オブジェクト"
+  - "図形オブジェクト"
+  - "図形 [WPF]"
+  - "伸縮可能な図形"
+  - "変換 (図形を)"
+ms.assetid: 893253b8-c2df-4f22-961d-cbc533d64c79
+caps.latest.revision: 52
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# 図形
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] には、基本的な図形の描画をサポートするための <xref:System.Windows.Shapes.Shape> クラスがあります。  図形オブジェクトは <xref:System.Windows.FrameworkElement> から派生します。したがって、レイアウト システムの一部であり、[!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] を使用して簡単に描画できます。  
+  
+## このセクションの内容  
+ [WPF での図形と基本描画の概要](../../../../docs/framework/wpf/graphics-multimedia/shapes-and-basic-drawing-in-wpf-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/shapes-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Shapes.Shape>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/specify-the-fillbehavior-for-a-timeline.md b/docs/framework/wpf/graphics-multimedia/specify-the-fillbehavior-for-a-timeline.md
new file mode 100644
index 00000000000..9f56ff26a67
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/specify-the-fillbehavior-for-a-timeline.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : アクティブな期間の末尾に到達したタイムラインの FillBehavior を指定する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "FillBehavior プロパティ (アクティブでないタイムラインの)"
+  - "タイムライン, FillBehavior プロパティ"
+ms.assetid: db805f59-d513-4dac-af15-47005dae3199
+caps.latest.revision: 10
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : アクティブな期間の末尾に到達したタイムラインの FillBehavior を指定する
+この例では、アニメーション化されたプロパティのアクティブでない <xref:System.Windows.Media.Animation.Timeline> に対して <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> を指定する方法を示します。  
+  
+## 使用例  
+ <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティは、アニメーション化されたプロパティがアニメーション化されていない場合、つまり <xref:System.Windows.Media.Animation.Timeline> はアクティブではないが、その親 <xref:System.Windows.Media.Animation.Timeline> はアクティブ期間または保留期間内にある場合に、そのプロパティの値の処理方法を決定します。  たとえば、アニメーション化されたプロパティが、アニメーションの終了後に、終了値の状態を維持するのか、アニメーションが開始される前の値に戻るのかを決定します。  
+  
+ <xref:System.Windows.Media.Animation.DoubleAnimation> を使用して、2 つの四角形の <xref:System.Windows.FrameworkElement.Width%2A> をアニメーション化する例を次に示します。  各四角形には、それぞれ別の <xref:System.Windows.Media.Animation.Timeline> オブジェクトを使用します。  
+  
+ 一方の <xref:System.Windows.Media.Animation.Timeline> では、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> が <xref:System.Windows.Media.Animation.FillBehavior> に設定されているため、<xref:System.Windows.Media.Animation.Timeline> が終了すると、四角形の幅はアニメーション化される前の値に戻ります。  もう一方の <xref:System.Windows.Media.Animation.Timeline> では、<xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> が <xref:System.Windows.Media.Animation.FillBehavior> に設定されているため、<xref:System.Windows.Media.Animation.Timeline> が終了すると、幅は終了値の状態を維持します。  
+  
+ [!code-xml[timingbehaviors_snip#FillBehaviorWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/timingbehaviors_snip/CSharp/FillBehaviorExample.xaml#fillbehaviorwholepage)]  
+  
+ サンプル全体については、[アニメーション サンプル ギャラリー](http://go.microsoft.com/fwlink/?LinkID=159969)を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Animation.DoubleAnimation>   
+ <xref:System.Windows.FrameworkElement.Width%2A>   
+ <xref:System.Windows.Media.Animation.Timeline>   
+ <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A>   
+ <xref:System.Windows.Media.Animation.FillBehavior>   
+ <xref:System.Windows.Media.Animation.FillBehavior>   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [Animation and Timing](http://msdn.microsoft.com/ja-jp/7d83765b-d5ae-41b1-b423-80206e1124aa)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/storyboards-overview.md b/docs/framework/wpf/graphics-multimedia/storyboards-overview.md
new file mode 100644
index 00000000000..22172fe9bf4
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/storyboards-overview.md
@@ -0,0 +1,313 @@
+---
+title: "ストーリーボードの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストーリーボードの構文"
+  - "構文, ストーリーボード"
+  - "タイムライン"
+ms.assetid: 1a698c3c-30f1-4b30-ae56-57e8a39811bd
+caps.latest.revision: 31
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# ストーリーボードの概要
+ここでは、<xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用してアニメーションを編成および適用する方法を示します。  <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを対話的に操作する方法について説明し、間接的なプロパティの対象化についての構文を示します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、さまざまな種類のアニメーションとその基本的な機能に精通している必要があります。  アニメーションの概要については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  また、添付プロパティの使用方法についても理解しておく必要があります。  添付プロパティの詳細については、「[添付プロパティの概要](../../../../docs/framework/wpf/advanced/attached-properties-overview.md)」を参照してください。  
+  
+<a name="whatisatimeline"></a>   
+## ストーリーボードとは何か  
+ タイムラインの型で役に立つのは、アニメーションだけではありません。  他にも一連のタイムラインの編成を容易にし、タイムラインをプロパティに適用するための Timeline クラスが提供されています。  コンテナー タイムラインは <xref:System.Windows.Media.Animation.TimelineGroup> クラスから派生し、<xref:System.Windows.Media.Animation.ParallelTimeline> と <xref:System.Windows.Media.Animation.Storyboard> があります。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> はコンテナー タイムラインの型で、含まれる複数のタイムラインの対象情報を持っています。  ストーリーボードには、その他のコンテナー タイムラインやアニメーションなど、任意の型の <xref:System.Windows.Media.Animation.Timeline> を格納できます。  <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用すると、さまざまなオブジェクトおよびプロパティに影響を与える複数のタイムラインを 1 つのタイムライン ツリーに結合でき、複雑なタイミング動作の編成および制御が容易になります。  たとえば、次の 3 つのことを実行するボタンを必要としているとします。  
+  
+-   ユーザーに選択されると、拡張して色が変わる。  
+  
+-   クリックされると、縮小してから元のサイズに戻る。  
+  
+-   無効にされると、縮小し、50% の不透明度になる。  
+  
+ この場合、同じオブジェクトに適用するアニメーションのセットを複数用意し、ボタンの状態に応じてそれぞれ別の時間に再生します。  <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用すると、アニメーションを編成し、これらをグループ化して 1 つ以上のオブジェクトに適用できます。  
+  
+<a name="wherecanyouuseastoryboard"></a>   
+## ストーリーボードはどこで使用できるか  
+ <xref:System.Windows.Media.Animation.Storyboard> を使用すると、アニメーション可能なクラスの[依存関係プロパティ](GTMT)をアニメーション化することができます \(クラスをアニメーション可能にする方法の詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください\)。  ただし、ストーリーボードはフレームワーク レベルの機能であるため、オブジェクトは <xref:System.Windows.FrameworkElement> の <xref:System.Windows.NameScope>、または <xref:System.Windows.FrameworkContentElement> に属している必要があります。  
+  
+ たとえば、<xref:System.Windows.Media.Animation.Storyboard> を使用すると、次の処理を実行できます。  
+  
+-   ボタン \(<xref:System.Windows.FrameworkElement> の型\) の背景を描画する <xref:System.Windows.Media.SolidColorBrush> \(非フレームワークの要素\) をアニメーション化します。  
+  
+-   <xref:System.Windows.Controls.Image> \(<xref:System.Windows.FrameworkElement>\) を使用して表示された <xref:System.Windows.Media.GeometryDrawing> \(非フレームワークの要素\) の塗りつぶしを描画する <xref:System.Windows.Media.SolidColorBrush> \(非フレームワークの要素\) をアニメーション化します。  
+  
+-   コード内で <xref:System.Windows.Media.SolidColorBrush> の名前がその <xref:System.Windows.FrameworkElement> を含めて登録された場合、<xref:System.Windows.FrameworkElement> を格納するクラスによって宣言された <xref:System.Windows.Media.SolidColorBrush> もアニメーション化します。  
+  
+ ただし、名前が <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> を含めて登録されていなかったり、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> のプロパティ設定で使用されなかった <xref:System.Windows.Media.SolidColorBrush> については、<xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーション化することはできません。  
+  
+<a name="applyanimationswithastoryboard"></a>   
+## ストーリーボードを使用してアニメーションを適用する方法  
+ <xref:System.Windows.Media.Animation.Storyboard> を使用してアニメーションを編成および適用するには、<xref:System.Windows.Media.Animation.Storyboard> の子タイムラインとしてアニメーションを追加します。  <xref:System.Windows.Media.Animation.Storyboard> クラスは、<xref:System.Windows.Media.Animation.Storyboard.TargetName%2A?displayProperty=fullName> および <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A?displayProperty=fullName> の添付プロパティを提供します。  これらのプロパティをアニメーションで設定して、アニメーションのターゲット オブジェクトとターゲット プロパティを指定します。  
+  
+ これらのターゲットにアニメーションを適用するには、トリガー アクションまたはメソッドを使用して <xref:System.Windows.Media.Animation.Storyboard> を開始します。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.Media.Animation.BeginStoryboard> オブジェクトを <xref:System.Windows.EventTrigger>、<xref:System.Windows.Trigger>、または <xref:System.Windows.DataTrigger> で使用します。  コード内で <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドを使用することもできます。  
+  
+ 各 <xref:System.Windows.Media.Animation.Storyboard> の開始方法がサポートされているさまざまな場所、インスタンス単位、スタイル、コントロール テンプレート、およびデータ テンプレートを次の表に示します。  "インスタンス単位" とは、スタイル、コントロール テンプレート、またはデータ テンプレート内のインスタンスではなく、オブジェクトのインスタンスに直接アニメーションまたはストーリーボードを適用する方法のことです。  
+  
+|ストーリーボードが開始される場所|インスタンス単位|スタイル|コントロール テンプレート|データ テンプレート|例|  
+|----------------------|--------------|----------|-------------------|----------------|-------|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.EventTrigger>|○|○|○|○|[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.Trigger> プロパティ|Ｘ|○|○|○|[プロパティ値が変化したときにアニメーションをトリガーする](../../../../docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md)|  
+|<xref:System.Windows.Media.Animation.BeginStoryboard> および <xref:System.Windows.DataTrigger>|Ｘ|○|○|○|[How to: Trigger an Animation When Data Changes](http://msdn.microsoft.com/ja-jp/a736bb3a-2ae5-479a-a33a-75a27055d863)|  
+|<xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッド|○|Ｘ|Ｘ|Ｘ|[ストーリーボードを使ってプロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)|  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.Storyboard> を使用して、<xref:System.Windows.Shapes.Rectangle> 要素の <xref:System.Windows.FrameworkElement.Width%2A> と、その <xref:System.Windows.Shapes.Rectangle> の描画に使用する <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> をアニメーション化します。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/StoryboardsExample.cs#100)]  
+  
+ 以下のセクションでは、<xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> および <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A> の添付プロパティについて詳しく説明します。  
+  
+<a name="targetingelementsandfreezables"></a>   
+## フレームワーク要素、フレームワーク コンテンツ要素、およびフリーズ可能オブジェクトの対象化  
+ アニメーションでは、そのターゲットを見つけるために、アニメーション化するターゲットの名前およびプロパティを認識する必要があることについては前のセクションで説明しました。  アニメーション化するプロパティを指定することは簡単で、アニメーション化するプロパティの名前で <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A?displayProperty=fullName> を設定するだけです。  アニメーション化するプロパティが含まれるオブジェクトの名前を指定するには、アニメーションで <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A?displayProperty=fullName> プロパティを設定します。  
+  
+ <xref:System.Windows.Setter.TargetName%2A> プロパティを機能させるには、ターゲット オブジェクトに名前が付いていなければなりません。  [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] で <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> に名前を割り当てるのは、<xref:System.Windows.Freezable> オブジェクトに名前を割り当てることとは異なります。  
+  
+ フレームワーク要素は、<xref:System.Windows.FrameworkElement> クラスを継承するそれらのクラスです。  フレームワーク要素の例としては、<xref:System.Windows.Window>、<xref:System.Windows.Controls.DockPanel>、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Shapes.Rectangle> などがあります。  基本的に、ウィンドウ、パネル、およびコントロールはすべて要素です。  フレームワーク コンテンツ要素は、<xref:System.Windows.FrameworkContentElement> クラスを継承するそれらのクラスです。  フレームワーク コンテンツ要素の例としては、<xref:System.Windows.Documents.FlowDocument> や <xref:System.Windows.Documents.Paragraph> などがあります。  型がフレームワーク要素またはフレームワーク コンテンツ要素であるかどうかが明確でない場合は、Name プロパティが含まれているかどうかを確認します。  含まれている場合は、フレームワーク要素またはフレームワーク コンテンツ要素の可能性があります。  確認するには、その型のページの「継承階層」をチェックしてください。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でフレームワーク要素またはフレームワーク コンテンツ要素の対象化を有効にするには、その <xref:System.Windows.FrameworkElement.Name%2A> プロパティを設定します。  また、コード内で <xref:System.Windows.NameScope.RegisterName%2A> メソッドを使用して、各要素の名前を <xref:System.Windows.NameScope> を作成した要素を含めて登録する必要があります。  
+  
+ 次の例では、前の例からの続きとして、<xref:System.Windows.Shapes.Rectangle> に `MyRectangle` \(<xref:System.Windows.FrameworkElement> の型\) という名前を割り当てています。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/StoryboardsExample.cs#102)]  
+  
+ 名前が割り当てられると、その要素のプロパティはアニメーション化できます。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#105](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/StoryboardsExample.cs#105)]  
+  
+ <xref:System.Windows.Freezable> 型は、<xref:System.Windows.Freezable> クラスを継承するそれらのクラスです。  <xref:System.Windows.Freezable> の例としては、<xref:System.Windows.Media.SolidColorBrush>、<xref:System.Windows.Media.RotateTransform>、<xref:System.Windows.Media.GradientStop> などがあります。  
+  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でアニメーションによる <xref:System.Windows.Freezable> の対象化を有効にするには、[x:Name ディレクティブ](../../../../docs/framework/xaml-services/x-name-directive.md)を使用して名前を割り当てます。  コード内で <xref:System.Windows.NameScope.RegisterName%2A> メソッドを使用して、<xref:System.Windows.NameScope> を作成した要素を含めてその名前を登録する必要があります。  
+  
+ 次の例では、<xref:System.Windows.Freezable> オブジェクトに名前を割り当てます。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/StoryboardsExample.cs#103)]  
+  
+ これで、オブジェクトをアニメーションのターゲットにすることができます。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#107](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/StoryboardsExample.cs#107)]  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトは、名前スコープを使用して <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> プロパティを解決します。  WPF 名前スコープの詳細については、「[WPF XAML 名前スコープ](../../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)」を参照してください。  <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> プロパティが省略されている場合、アニメーションは、アニメーションが定義されている要素、スタイルの場合にはスタイルが設定されている要素をターゲットにします。  
+  
+ 場合によっては、<xref:System.Windows.Freezable> オブジェクトに名前を割り当てることができないことがあります。  たとえば、<xref:System.Windows.Freezable> がリソースとして宣言されたり、スタイル内でプロパティ値の設定に使用された場合は、名前を割り当てることができません。  名前が割り当てられていないため、それを直接ターゲットにすることができません。ただし、間接的にターゲットにすることはできます。  以下のセクションでは、間接的な対象化の使用方法について説明します。  
+  
+<a name="pathsyntaxforchangeable"></a>   
+## 間接的な対象化  
+ <xref:System.Windows.Freezable> がリソースとして宣言されたり、スタイル内でプロパティ値の設定に使用されたときなど、アニメーションで <xref:System.Windows.Freezable> を直接ターゲットにできない場合があります。  この場合、直接ターゲットにできなくても、<xref:System.Windows.Freezable> オブジェクトをアニメーション化することができます。  <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> プロパティに <xref:System.Windows.Freezable> の名前を設定するのではなく、<xref:System.Windows.Freezable> が "属している" 要素の名前を指定します。たとえば、四角形要素の <xref:System.Windows.Shapes.Shape.Fill%2A> の設定に使用された <xref:System.Windows.Media.SolidColorBrush> は、その四角形に属しています。  ブラシをアニメーション化するには、設定に <xref:System.Windows.Freezable> が使用されたフレームワーク要素またはフレームワーク コンテンツ要素のプロパティで開始され、アニメーション化する <xref:System.Windows.Freezable> プロパティで終了するプロパティのチェーンを使用して、アニメーションの <xref:System.Windows.Media.Animation.Storyboard.TargetProperty%2A> を設定します。  
+  
+  
+  
+ [!code-csharp[storyboards_ovw_snip#134](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#134)]  
+  
+ <xref:System.Windows.Freezable> が固定されている場合は、複製が作成され、その複製がアニメーション化されることに注意してください。  この場合、元のオブジェクトは実際にはアニメーション化されないため、元のオブジェクトの <xref:System.Windows.Media.Animation.Animatable.HasAnimatedProperties%2A> プロパティは引き続き `false` を返します。  複製の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ また、間接的なプロパティの対象化を使用した場合、存在しないオブジェクトはターゲットにできないことに注意してください。  たとえば、実際にボタンの背景の設定に <xref:System.Windows.Media.LinearGradientBrush> を使用した場合、特定のボタンの <xref:System.Windows.Controls.Control.Background%2A> に <xref:System.Windows.Media.SolidColorBrush> が設定されており、その色をアニメーション化しようとしたとします。  この場合、例外はスローされませんが、<xref:System.Windows.Media.LinearGradientBrush> が <xref:System.Windows.Media.SolidColorBrush.Color%2A> プロパティの変化に反応しないため、アニメーション効果を表示できません。  
+  
+ 以下のセクションでは、間接的なプロパティの対象化についての構文について詳しく説明します。  
+  
+<a name="xamlsyntaxchangeableproperty"></a>   
+### XAML で Freezable のプロパティを間接的に対象化する  
+ [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] でフリーズ可能オブジェクトのプロパティをターゲットにするには、次の構文を使用します。  
+  
+||  
+|-|  
+|*ElementPropertyName*`.`*FreezablePropertyName*|  
+  
+ Where  
+  
+-   *ElementPropertyName* は、<xref:System.Windows.Freezable> を使用して設定される <xref:System.Windows.FrameworkElement> のプロパティです。  
+  
+-   *FreezablePropertyName* は、アニメーション化する <xref:System.Windows.Freezable> のプロパティです。  
+  
+ 次の項目の設定に使用された <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> をアニメーション化する方法を次のコード例に示します。  
+  
+ 四角形要素の <xref:System.Windows.Shapes.Shape.Fill%2A>。  
+  
+  
+  
+ コレクションまたはアレイに含まれるフリーズ可能オブジェクトをターゲットにしなければならない場合があります。  
+  
+ コレクションに含まれるフリーズ可能オブジェクトをターゲットにするには、次のパス構文を使用します。  
+  
+||  
+|-|  
+|*ElementPropertyName* `.Children[` *CollectionIndex* `].` *FreezablePropertyName*|  
+  
+ ここで、*CollectionIndex* はアレイまたはコレクションに含まれるオブジェクトのインデックスです。  
+  
+ たとえば、ある四角形の <xref:System.Windows.Media.TransformGroup> リソースが <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用されていて、その変換の 1 つをアニメーション表示しようとしているとします。  
+  
+  
+  
+ 次のコードは、前の例で示した <xref:System.Windows.Media.RotateTransform> の <xref:System.Windows.Media.RotateTransform.Angle%2A> プロパティをアニメーション化する方法を示しています。  
+  
+  
+  
+<a name="targetingpropertyofchangeableincode"></a>   
+### コード内で Freezable のプロパティを間接的に対象化する  
+ コード内で <xref:System.Windows.PropertyPath> オブジェクトを作成します。  <xref:System.Windows.PropertyPath> を作成する場合は、<xref:System.Windows.PropertyPath.Path%2A> と <xref:System.Windows.PropertyPath.PathParameters%2A> を指定します。  
+  
+ <xref:System.Windows.PropertyPath.PathParameters%2A> を作成するには、依存関係プロパティ識別子フィールドのリストが含まれる <xref:System.Windows.DependencyProperty> 型の配列を作成します。  最初の識別子フィールドは、<xref:System.Windows.Freezable> を使用して設定された <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> のプロパティ用です。  次の識別子フィールドは、ターゲットにする <xref:System.Windows.Freezable> のプロパティを表します。  これは、<xref:System.Windows.Freezable> を <xref:System.Windows.FrameworkElement> オブジェクトに接続するプロパティのチェーンと考えてください。  
+  
+ 四角形要素の <xref:System.Windows.Shapes.Shape.Fill%2A> を設定するために使用された <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> をターゲットにする依存関係プロパティのチェーンの例を次に示します。  
+  
+ [!code-csharp[storyboards_ovw_snip#135](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#135)]  
+  
+ <xref:System.Windows.PropertyPath.Path%2A> も指定する必要があります。  <xref:System.Windows.PropertyPath.Path%2A> は、<xref:System.Windows.PropertyPath.Path%2A> にその <xref:System.Windows.PropertyPath.PathParameters%2A> の解釈方法を伝える <xref:System.String> です。  これには、次の構文を使います。  
+  
+||  
+|-|  
+|`(`*OwnerPropertyArrayIndex*`).(`*FreezablePropertyArrayIndex*`)`|  
+  
+ Where  
+  
+-   *OwnerPropertyArrayIndex* は、<xref:System.Windows.Freezable> を使用して設定された <xref:System.Windows.FrameworkElement> オブジェクトのプロパティの識別子を格納する <xref:System.Windows.DependencyProperty> 配列のインデックスです。  
+  
+-   *FreezablePropertyArrayIndex* は、ターゲットにするプロパティの識別子を格納する <xref:System.Windows.DependencyProperty> 配列のインデックスです。  
+  
+ 前の例で定義した <xref:System.Windows.PropertyPath.PathParameters%2A> を含む <xref:System.Windows.PropertyPath.Path%2A> の例を次に示します。  
+  
+ [!code-csharp[storyboards_ovw_snip#PropertyChainAndPath](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#propertychainandpath)]  
+  
+ 次の例では、前の例のコードを組み合わせて、四角形要素の <xref:System.Windows.Shapes.Shape.Fill%2A> を設定するために使用された <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> をアニメーション化します。  
+  
+ [!code-csharp[storyboards_ovw_snip#137](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#137)]  
+  
+ コレクションまたはアレイに含まれるフリーズ可能オブジェクトをターゲットにしなければならない場合があります。  たとえば、ある四角形の <xref:System.Windows.Media.TransformGroup> リソースが <xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用されていて、その変換の 1 つをアニメーション表示しようとしているとします。  
+  
+ [!code-xml[storyboards_ovw_snip#142](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml#142)]  
+  
+ コレクションに含まれる <xref:System.Windows.Freezable> をターゲットにするには、次のパス構文を使用します。  
+  
+||  
+|-|  
+|`(`*OwnerPropertyArrayIndex*`).(` *CollectionChildrenPropertyArrayIndex*`)` `[`*CollectionIndex* `].(`*FreezablePropertyArrayIndex*`)`|  
+  
+ ここで、*CollectionIndex* はアレイまたはコレクションに含まれるオブジェクトのインデックスです。  
+  
+ <xref:System.Windows.Media.RotateTransform> の <xref:System.Windows.Media.RotateTransform.Angle%2A> プロパティ \(<xref:System.Windows.Media.TransformGroup> 内の 2 番目の変換\) をターゲットにするには、次の <xref:System.Windows.PropertyPath.Path%2A> および <xref:System.Windows.PropertyPath.PathParameters%2A> を使用します。  
+  
+ [!code-csharp[storyboards_ovw_snip#139](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#139)]  
+  
+ <xref:System.Windows.Media.TransformGroup> 内に含まれた <xref:System.Windows.Media.RotateTransform> の <xref:System.Windows.Media.RotateTransform.Angle%2A> をアニメーション化するための完全なコード例を次に示します。  
+  
+ [!code-csharp[storyboards_ovw_snip#138](../../../../samples/snippets/csharp/VS_Snippets_Wpf/storyboards_ovw_snip/CSharp/IndirectTargetingExample.xaml.cs#138)]  
+  
+### 開始点として Freezable を使用して間接的に対象化する  
+ 前のセクションで、<xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> で開始し、<xref:System.Windows.Freezable> サブプロパティへのプロパティ チェーンを作成することによって、<xref:System.Windows.Freezable> を間接的にターゲットにする方法について説明しました。  また、開始点として <xref:System.Windows.Freezable> を使用して、その <xref:System.Windows.Freezable> サブプロパティの 1 つを間接的にターゲットにすることができます。  間接的な対象化で開始点として <xref:System.Windows.Freezable> を使用する場合、適用する制限が 1 つ追加されます。つまり、開始 <xref:System.Windows.Freezable> と、間接的にターゲットにされたサブプロパティまでの各 <xref:System.Windows.Freezable> は固定できません。  
+  
+<a name="controllable_storyboards"></a>   
+## XAML での対話形式でのストーリーボードの制御  
+ [!INCLUDE[TLA#tla_xaml](../../../../includes/tlasharptla-xaml-md.md)] 内でストーリーボードを開始するには、<xref:System.Windows.Media.Animation.BeginStoryboard> トリガー アクションを使用します。  <xref:System.Windows.Media.Animation.BeginStoryboard> は、アニメーション化するオブジェクトおよびプロパティにアニメーションを分配し、ストーリーボードを開始します。  \(このプロセスの詳細については、「[アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)」を参照してください\)。<xref:System.Windows.Media.Animation.BeginStoryboard> は、<xref:System.Windows.Media.Animation.BeginStoryboard.Name%2A> プロパティを指定することによって名前を設定すると、制御可能なストーリーボードになります。  ストーリーボードは、開始されると対話的に制御できます。  ストーリーボードを制御するためにイベント トリガーで使用する、制御可能なストーリーボード アクションの一覧を次に示します。  
+  
+-   <xref:System.Windows.Media.Animation.PauseStoryboard>: ストーリーボードを一時停止します。  
+  
+-   <xref:System.Windows.Media.Animation.ResumeStoryboard>: 一時停止されたストーリーボードを再開します。  
+  
+-   <xref:System.Windows.Media.Animation.SetStoryboardSpeedRatio> : ストーリーボードの速度を変更します。  
+  
+-   <xref:System.Windows.Media.Animation.SkipStoryboardToFill>: ストーリーボードがある場合は、それを区間の最後に進めます。  
+  
+-   <xref:System.Windows.Media.Animation.StopStoryboard>: ストーリーボードを停止します。  
+  
+-   <xref:System.Windows.Media.Animation.RemoveStoryboard> : ストーリーボードを削除します。  
+  
+ 次の例では、制御可能なストーリーボード アクションを使用して、ストーリーボードを対話的に制御しています。  
+  
+ [!code-xml[animation_ovws_snip#ControllableStoryboardExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_snip/CS/ControllableStoryboardExample.xaml#controllablestoryboardexamplewholepage)]  
+  
+<a name="controllable_storyboards_procedural"></a>   
+## コードを使用した対話形式でのストーリーボードの制御  
+ トリガー アクションを使用してアニメーション化する方法については、前の例で説明しました。  コード内で <xref:System.Windows.Media.Animation.Storyboard> クラスの対話型メソッドを使用することにより、ストーリーボードを制御することもできます。  コード内で <xref:System.Windows.Media.Animation.Storyboard> を対話型にするには、ストーリーボードの <xref:System.Windows.Media.Animation.Storyboard.Begin%2A> メソッドの適切なオーバーロードを使用し、制御可能にするために `true` を指定する必要があります。  詳細については、「<xref:System.Windows.Media.Animation.Storyboard.Begin%28System.Windows.FrameworkElement%2CSystem.Boolean%29>」を参照してください。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> の開始後の操作に使用できるメソッドの一覧を次に示します。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Pause%2A>  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Resume%2A>  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Seek%2A>  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.SkipToFill%2A>  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Stop%2A>  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.Remove%2A>  
+  
+ これらのメソッドを使用する利点は、<xref:System.Windows.Trigger> オブジェクトまたは <xref:System.Windows.TriggerAction> オブジェクトを作成する必要がなく、必要なのは操作対象の制御可能な <xref:System.Windows.Media.Animation.Storyboard> への参照だけであることです。  
+  
+ **メモ :**  <xref:System.Windows.Media.Animation.Clock> で実行され、そのため <xref:System.Windows.Media.Animation.Storyboard> でも実行されるすべての対話形式のアクションは、次の描画の少し前に発生する、タイミング エンジンの次の目盛りで実行されます。  たとえば、<xref:System.Windows.Media.Animation.Storyboard.Seek%2A> メソッドを使用してアニメーション内の別のポイントにジャンプするとき、プロパティ値は直ちには変わらず、値はタイミング エンジンの次の目盛りで変わります。  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> クラスの対話型メソッドを使用して、アニメーションを適用および制御する方法を次の例に示します。  
+  
+ [!code-csharp[animation_ovws_procedural_snip#ControllableStoryboardExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/animation_ovws_procedural_snip/CSharp/ControllableStoryboardExample.cs#controllablestoryboardexamplewholepage)]
+ [!code-vb[animation_ovws_procedural_snip#ControllableStoryboardExampleWholePage](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/animation_ovws_procedural_snip/visualbasic/controllablestoryboardexample.vb#controllablestoryboardexamplewholepage)]  
+  
+<a name="usingstoryboardsinstyles"></a>   
+## スタイル内でアニメーション化を行う  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用すると、<xref:System.Windows.Style> 内でアニメーションを定義できます。  <xref:System.Windows.Style> 内の <xref:System.Windows.Media.Animation.Storyboard> によってアニメーション化することは、他の場所の <xref:System.Windows.Media.Animation.Storyboard> を使用することと同じですが、次の 3 点が異なります。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> を指定しない場合、<xref:System.Windows.Media.Animation.Storyboard> は、常に <xref:System.Windows.Style> が適用される要素をターゲットにします。  <xref:System.Windows.Freezable> オブジェクトをターゲットにするには、間接的な対象化を使用する必要があります。  間接的な対象化の詳細については、「[間接的な対象化](#pathsyntaxforchangeable)」を参照してください。  
+  
+-   <xref:System.Windows.EventTrigger> または <xref:System.Windows.Trigger> の <xref:System.Windows.EventTrigger.SourceName%2A> は指定できません。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard> またはアニメーションのプロパティ値を設定する際に、動的リソース参照またはデータ バインディング式は使用できません。  これは、<xref:System.Windows.Style> 内のものはすべてスレッド セーフである必要があり、タイミング システムはこれらをスレッド セーフにする <xref:System.Windows.Freezable.Freeze%2A> <xref:System.Windows.Media.Animation.Storyboard> オブジェクトである必要があるからです。  <xref:System.Windows.Media.Animation.Storyboard> は、それ自身またはその子タイムラインに動的リソース参照またはデータ バインディング式が含まれている場合、固定できません。  フリーズおよびその他の <xref:System.Windows.Freezable> 機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.Media.Animation.Storyboard> またはアニメーション イベントのイベント ハンドラーを宣言できません。  
+  
+ スタイル内でストーリーボードを定義する方法の例については、「[スタイル内でアニメーション化を行う](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-style.md)」の例を参照してください。  
+  
+<a name="defineAStoryboardInAControlTemplateSection"></a>   
+## ControlTemplate 内でアニメーション化を行う  
+ <xref:System.Windows.Media.Animation.Storyboard> オブジェクトを使用すると、<xref:System.Windows.Controls.ControlTemplate> 内でアニメーションを定義できます。  <xref:System.Windows.Controls.ControlTemplate> 内の <xref:System.Windows.Media.Animation.Storyboard> によってアニメーション化することは、他の場所の <xref:System.Windows.Media.Animation.Storyboard> を使用することと同じですが、次の 2 点が異なります。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> が参照できるのは、<xref:System.Windows.Controls.ControlTemplate> の子オブジェクトだけです。  <xref:System.Windows.Media.Animation.Storyboard.TargetName%2A> が指定されていない場合、アニメーションは <xref:System.Windows.Controls.ControlTemplate> が適用される要素をターゲットにします。  
+  
+-   <xref:System.Windows.EventTrigger> または <xref:System.Windows.Trigger> の <xref:System.Windows.EventTrigger.SourceName%2A> が参照できるのは、<xref:System.Windows.Controls.ControlTemplate> の子オブジェクトだけです。  
+  
+-   <xref:System.Windows.Media.Animation.Storyboard> またはアニメーションのプロパティ値を設定する際に、動的リソース参照またはデータ バインディング式は使用できません。  これは、<xref:System.Windows.Controls.ControlTemplate> 内のものはすべてスレッド セーフである必要があり、タイミング システムはこれらをスレッド セーフにする <xref:System.Windows.Freezable.Freeze%2A> <xref:System.Windows.Media.Animation.Storyboard> オブジェクトである必要があるからです。  <xref:System.Windows.Media.Animation.Storyboard> は、それ自身またはその子タイムラインに動的リソース参照またはデータ バインディング式が含まれている場合、固定できません。  フリーズおよびその他の <xref:System.Windows.Freezable> 機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)] では、<xref:System.Windows.Media.Animation.Storyboard> またはアニメーション イベントのイベント ハンドラーを宣言できません。  
+  
+ <xref:System.Windows.Controls.ControlTemplate> でストーリーボードを定義する方法の例については、「[ControlTemplate 内でアニメーション化を行う](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md)」の例を参照してください。  
+  
+<a name="animateWhenAPropertyValueChanges"></a>   
+## プロパティ値が変化したときにアニメーション化を行う  
+ スタイル内およびコントロール テンプレート内では、トリガー オブジェクトを使用して、プロパティが変化したときにストーリーボードを開始します。  使用例については、「[プロパティ値が変化したときにアニメーションをトリガーする](../../../../docs/framework/wpf/graphics-multimedia/how-to-trigger-an-animation-when-a-property-value-changes.md)」および「[ControlTemplate 内でアニメーション化を行う](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-in-a-controltemplate.md)」を参照してください。  
+  
+ プロパティの <xref:System.Windows.Trigger> オブジェクトによって適用されるアニメーションの動作は、<xref:System.Windows.EventTrigger> アニメーション、または <xref:System.Windows.Media.Animation.Storyboard> メソッドを使用して開始されるアニメーションより複雑です。  他の <xref:System.Windows.Trigger> オブジェクトによって定義されるアニメーションで "ハンドオフ" しますが、<xref:System.Windows.EventTrigger> およびメソッドでトリガーされるアニメーションで構成されます。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [プロパティ アニメーションの手法の概要](../../../../docs/framework/wpf/graphics-multimedia/property-animation-techniques-overview.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/tilebrush-overview.md b/docs/framework/wpf/graphics-multimedia/tilebrush-overview.md
new file mode 100644
index 00000000000..92c2646c103
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/tilebrush-overview.md
@@ -0,0 +1,138 @@
+---
+title: "TileBrush の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, TileBrush"
+  - "TileBrush"
+ms.assetid: aa4a7b7e-d09d-44c2-8d61-310c50e08d68
+caps.latest.revision: 16
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# TileBrush の概要
+<xref:System.Windows.Media.TileBrush> オブジェクトを使用すると、イメージ、<xref:System.Windows.Media.Drawing>、または <xref:System.Windows.Media.Visual> で領域を塗りつぶす方法を細かく制御できます。  ここでは、<xref:System.Windows.Media.TileBrush> 機能を使用して、<xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、または <xref:System.Windows.Media.VisualBrush> で領域を塗りつぶす方法を詳細に制御する方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="prerequisite"></a>   
+## 必要条件  
+ このトピックを理解するには、<xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、または <xref:System.Windows.Media.VisualBrush> の各クラスの基本的な機能の使用方法について理解しておくと役立ちます。  これらの型の概要については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="tilebrush"></a>   
+## タイルで領域を塗りつぶす  
+ <xref:System.Windows.Media.ImageBrush>、<xref:System.Windows.Media.DrawingBrush>、および <xref:System.Windows.Media.VisualBrush> は、<xref:System.Windows.Media.TileBrush> オブジェクトの一種です。  タイル ブラシを使用すると、イメージ、描画、またはビジュアルで領域を塗りつぶす方法を細かく制御できます。  たとえば、引き伸ばした単一のイメージで領域をただ塗りつぶすのではなく、パターンを作成する一連のイメージ タイルで領域を塗りつぶすことができます。  
+  
+ タイル ブラシによる領域の塗りつぶしには、コンテンツ、基本タイル、および出力領域の 3 つのコンポーネントが含まれます。  
+  
+ ![TileBrush コンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/wcpsdk-mmgraphics-defaultcontentprojection2.png "wcpsdk\_mmgraphics\_defaultcontentprojection2")  
+1 つのタイルを使用する TileBrush のコンポーネント  
+  
+ ![並べて表示された TileBrush のコンポーネント](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-tiledprojection.png "graphicsmm\_tiledprojection")  
+Tile の TileMode を使用する TileBrush のコンポーネント  
+  
+ 出力領域とは、<xref:System.Windows.Shapes.Ellipse> の <xref:System.Windows.Shapes.Shape.Fill%2A> や <xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.Control.Background%2A> など、塗りつぶされる領域のことです。  次のセクションでは、<xref:System.Windows.Media.TileBrush> の他の 2 つのコンポーネントについて説明します。  
+  
+<a name="brushcontent"></a>   
+## ブラシのコンテンツ  
+ <xref:System.Windows.Media.TileBrush> には 3 つの種類があり、それぞれが異なる種類のコンテンツを使用して塗りつぶしを行います。  
+  
+-   ブラシが <xref:System.Windows.Media.ImageBrush> の場合、このコンテンツはイメージです。<xref:System.Windows.Media.ImageBrush.ImageSource%2A> プロパティは、<xref:System.Windows.Media.ImageBrush> のコンテンツを指定します。  
+  
+-   ブラシが <xref:System.Windows.Media.DrawingBrush> である場合、このコンテンツは描画です。  <xref:System.Windows.Media.DrawingBrush.Drawing%2A> プロパティは、<xref:System.Windows.Media.DrawingBrush> のコンテンツを指定します。  
+  
+-   ブラシが <xref:System.Windows.Media.VisualBrush> である場合、このコンテンツはビジュアルです。  <xref:System.Windows.Media.VisualBrush.Visual%2A> プロパティは、<xref:System.Windows.Media.VisualBrush> のコンテンツを指定します。  
+  
+ <xref:System.Windows.Media.TileBrush.Viewbox%2A> プロパティを使用して、<xref:System.Windows.Media.TileBrush> のコンテンツの位置およびサイズを指定できます。ただし、この <xref:System.Windows.Media.TileBrush.Viewbox%2A> は、通常は既定値のままにしておきます。  既定では、<xref:System.Windows.Media.TileBrush.Viewbox%2A> は、ブラシのコンテンツを完全に含むように構成されます。  <xref:System.Windows.Controls.Viewbox> の構成の詳細については、<xref:System.Windows.Controls.Viewbox> プロパティのページを参照してください。  
+  
+<a name="thebasetile"></a>   
+## 基本タイル  
+ <xref:System.Windows.Media.TileBrush> は、そのコンテンツを基本タイルに投影します。  <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは、<xref:System.Windows.Media.TileBrush> のコンテンツを引き伸ばして基本タイルを塗りつぶす方法を制御します。  <xref:System.Windows.Media.TileBrush.Stretch%2A> プロパティは、<xref:System.Windows.Media.Stretch> 列挙体によって定義された次の値を受け入れます。  
+  
+-   <xref:System.Windows.Media.Stretch> : ブラシのコンテンツは、タイルを塗りつぶすために引き伸ばされません。  
+  
+-   <xref:System.Windows.Media.Stretch> : ブラシのコンテンツは、タイルに合わせてスケーリングされます。  コンテンツの高さと幅は別々にスケーリングされるため、コンテンツの元の縦横比が維持されない場合があります。  つまり、出力タイルを完全に塗りつぶすために、ブラシのコンテンツがいびつになることがあります。  
+  
+-   <xref:System.Windows.Media.Stretch> : ブラシのコンテンツは、タイル内に完全に収まるようにスケーリングされます。  コンテンツの縦横比は維持されます。  
+  
+-   <xref:System.Windows.Media.Stretch> : ブラシのコンテンツは、コンテンツの元の縦横比を維持しながら、出力領域を完全に塗りつぶすようにスケーリングされます。  
+  
+ さまざまな <xref:System.Windows.Media.TileBrush.Stretch%2A> 設定を次のイメージに示します。  
+  
+ ![別の TileBrush Stretch 設定](../../../../docs/framework/wpf/graphics-multimedia/media/img-mmgraphics-stretchenum.png "img\_mmgraphics\_stretchenum")  
+  
+ 次の例では、<xref:System.Windows.Media.ImageBrush> のコンテンツは、引き伸ばして出力領域を塗りつぶすことは行わない設定になっています。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMNoStretchExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/StretchExample.xaml#graphicsmmnostretchexample)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMNoStretchExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/StretchExample.cs#graphicsmmnostretchexample)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMNoStretchExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/stretchexample.vb#graphicsmmnostretchexample)]  
+  
+ 既定では、<xref:System.Windows.Media.TileBrush> は 1 つのタイル \(基本タイル\) を生成し、そのタイルを出力領域と完全に一致するように引き伸ばします。  基本タイルのサイズと位置は、<xref:System.Windows.Media.TileBrush.Viewport%2A> および <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティを設定して変更できます。  
+  
+<a name="basetilesize"></a>   
+### 基本タイルのサイズ  
+ <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティは、基本タイルのサイズと位置を決定し、<xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティは、<xref:System.Windows.Media.TileBrush.Viewport%2A> を指定する際に、絶対座標と相対座標のどちらを使用するかを決定します。  座標が相対的な場合、座標は出力領域のサイズに対して相対的になります。  点 \(0,0\) は出力領域の左上隅を表し、\(1,1\) は出力領域の右下隅を表します。  <xref:System.Windows.Media.TileBrush.Viewport%2A> プロパティで絶対座標を使用するように指定するには、<xref:System.Windows.Media.TileBrush.ViewportUnits%2A> プロパティを <xref:System.Windows.Media.BrushMappingMode> に設定します。  
+  
+ <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> で相対座標を指定した場合と絶対座標を指定した場合の <xref:System.Windows.Media.TileBrush> の出力の違いを次の図に示します。  どの図も、並べて表示するパターンを示しています。次のセクションでは、パターンの指定方法について説明します。  
+  
+ ![ビューポートの絶対単位と相対単位](../../../../docs/framework/wpf/graphics-multimedia/media/absolute-and-relative-viewports.png "absolute\_and\_relative\_viewports")  
+  
+ 次の例では、イメージを使用して幅と高さが 50% のタイルを作成しています。  基本タイルは、出力領域の \(0,0\) の位置にあります。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMRelativeViewportUnitsExample1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileSizeExample.xaml#graphicsmmrelativeviewportunitsexample1)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMRelativeViewportUnitsExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/TileSizeExample.cs#graphicsmmrelativeviewportunitsexample1)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMRelativeViewportUnitsExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/tilesizeexample.vb#graphicsmmrelativeviewportunitsexample1)]  
+  
+ 次の例では、<xref:System.Windows.Media.ImageBrush> のタイルを 25 x 25 [デバイス非依存ピクセル](GTMT)に設定します。  <xref:System.Windows.Media.TileBrush.ViewportUnits%2A> は絶対値であるため、<xref:System.Windows.Media.ImageBrush> のタイルは、塗りつぶす領域のサイズに関係なく常に 25 × 25 ピクセルになります。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMAbsoluteViewportUnitsExample1](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TileSizeExample.xaml#graphicsmmabsoluteviewportunitsexample1)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMAbsoluteViewportUnitsExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/TileSizeExample.cs#graphicsmmabsoluteviewportunitsexample1)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMAbsoluteViewportUnitsExample1](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/tilesizeexample.vb#graphicsmmabsoluteviewportunitsexample1)]  
+  
+<a name="tilingbehavior"></a>   
+### 並べて表示する動作  
+ <xref:System.Windows.Media.TileBrush> は、基本タイルが出力領域を完全に塗りつぶさず、並べて表示するモードが <xref:System.Windows.Media.TileMode> 以外に指定されている場合に、並べて表示するパターンを生成します。  タイル ブラシのタイルが出力領域を完全に塗りつぶさない場合、<xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティは出力領域を塗りつぶすために基本タイルを繰り返す必要があるかどうかを指定します。繰り返す必要がある場合は、繰り返し方法も指定します。  <xref:System.Windows.Media.TileBrush.TileMode%2A> プロパティは、<xref:System.Windows.Media.TileMode> 列挙体によって定義された次の値を受け入れます。  
+  
+-   <xref:System.Windows.Media.TileMode> : 基本タイルのみが描画されます。  
+  
+-   <xref:System.Windows.Media.TileMode> : 基本タイルが描画され、残りの領域は基本タイルの繰り返しによって塗りつぶされます。つまり、1 つのタイルの右端が次のタイルの左端に隣接し、同様に上端と下端も隣接します。  
+  
+-   <xref:System.Windows.Media.TileMode> : タイルが 1 列おきに左右に反転することを除き、<xref:System.Windows.Media.TileMode> と同じです。  
+  
+-   <xref:System.Windows.Media.TileMode> : タイルが 1 行おきに上下に反転することを除き、<xref:System.Windows.Media.TileMode> と同じです。  
+  
+-   <xref:System.Windows.Media.TileMode> : <xref:System.Windows.Media.TileMode> と <xref:System.Windows.Media.TileMode> の組み合わせです。  
+  
+ 並べて表示するさまざまなモードを次のイメージに示します。  
+  
+ ![別の TileBrush TileMode 設定](../../../../docs/framework/wpf/graphics-multimedia/media/img-mmgraphics-tilemodes.png "img\_mmgraphics\_tilemodes")  
+  
+ 次の例では、イメージを使用して幅と高さが 100 ピクセルの四角形が塗りつぶされます。  ブラシの <xref:System.Windows.Media.TileBrush.Viewport%2A> を 0,0,0.25,0.25 に設定することにより、ブラシの基本タイルは出力領域の 1\/4 のサイズになります。  ブラシの <xref:System.Windows.Media.TileBrush.TileMode%2A> は <xref:System.Windows.Media.TileMode> に設定されます。  そのため、四角形はタイルの行で塗りつぶされます。  
+  
+ [!code-xml[BrushOverviewExamples_snip#GraphicsMMFlipXYExample](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/TilingExample.xaml#graphicsmmflipxyexample)]  
+  
+ [!code-csharp[BrushOverviewExamples_procedural_snip#GraphicsMMFlipXYExample](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/CSharp/TilingExample.cs#graphicsmmflipxyexample)]
+ [!code-vb[BrushOverviewExamples_procedural_snip#GraphicsMMFlipXYExample](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushOverviewExamples_procedural_snip/visualbasic/tilingexample.vb#graphicsmmflipxyexample)]  
+  
+## 参照  
+ <xref:System.Windows.Media.ImageBrush>   
+ <xref:System.Windows.Media.DrawingBrush>   
+ <xref:System.Windows.Media.VisualBrush>   
+ <xref:System.Windows.Media.TileBrush>   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)   
+ [VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md b/docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md
new file mode 100644
index 00000000000..f618bd2f24c
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md
@@ -0,0 +1,138 @@
+---
+title: "タイミング動作の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "動作, タイミング"
+  - "タイミング動作"
+ms.assetid: 5b714d46-bd46-48b8-b467-b4be89ba3091
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# タイミング動作の概要
+ここでは、アニメーションおよび他の <xref:System.Windows.Media.Animation.Timeline> オブジェクトのタイミング動作について説明します。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+<a name="prerequisites"></a>   
+## 必要条件  
+ このトピックを理解するには、基本的なアニメーション機能に精通している必要があります。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+<a name="timelinetypes"></a>   
+## タイムラインの型  
+ <xref:System.Windows.Media.Animation.Timeline> は時間のセグメントを表します。  用意されているプロパティを使用して、そのセグメントの長さ、開始時間、繰り返し回数、時間の進行の速度などを指定できます。  
+  
+ Timeline クラスを継承するクラスには、アニメーションやメディアの再生などの追加機能が用意されています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] には、次の <xref:System.Windows.Media.Animation.Timeline> の種類が用意されています。  
+  
+|タイムラインの型|Description|  
+|--------------|-----------------|  
+|<xref:System.Windows.Media.Animation.AnimationTimeline>|プロパティのアニメーション化のための出力値を生成する <xref:System.Windows.Media.Animation.Timeline> オブジェクトの抽象基本クラス。|  
+|<xref:System.Windows.Media.MediaTimeline>|メディア ファイルから出力を生成します。|  
+|<xref:System.Windows.Media.Animation.ParallelTimeline>|子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトをグループ化し、制御する <xref:System.Windows.Media.Animation.TimelineGroup> の型。|  
+|<xref:System.Windows.Media.Animation.Storyboard>|含まれる Timeline オブジェクトの対象情報を持つ <xref:System.Windows.Media.Animation.ParallelTimeline> の型。|  
+|<xref:System.Windows.Media.Animation.Timeline>|タイミング動作を定義する抽象基本クラス。|  
+|<xref:System.Windows.Media.Animation.TimelineGroup>|他の <xref:System.Windows.Media.Animation.Timeline> オブジェクトを含めることができる <xref:System.Windows.Media.Animation.Timeline> オブジェクトの抽象クラス。|  
+  
+<a name="propertiesthatcontroltimelinelength"></a>   
+## タイムラインの長さを制御するプロパティ  
+ <xref:System.Windows.Media.Animation.Timeline> は時間のセグメントを表し、タイムラインの長さはさまざまな方法で示すことができます。  タイムラインの長さを示すいくつかの用語の定義を次の表に示します。  
+  
+|語句|Description|プロパティ||||  
+|--------|-----------------|-----------|-|-|-|  
+|単純継続時間|タイムラインが順方向の反復を 1 回完了するのに要する時間の長さ。|<xref:System.Windows.Media.Animation.Timeline.Duration%2A>||||  
+|1 回の繰り返し|タイムラインが順方向で 1 回再生され、<xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティが true の場合に逆方向で 1 回再生されるのに要する時間の長さ。|<xref:System.Windows.Media.Animation.Timeline.Duration%2A>, <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>||||  
+|アクティブ期間|<xref:System.Windows.Media.Animation.RepeatBehavior> プロパティで指定したすべての繰り返しをタイムラインが完了するのに要する時間の長さ。|<xref:System.Windows.Media.Animation.Timeline.Duration%2A>, <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A>, <xref:System.Windows.Media.Animation.RepeatBehavior>||||  
+  
+<a name="duration"></a>   
+### Duration プロパティ  
+ 前述のように、タイムラインは時間のセグメントを表します。  そのセグメントの長さはタイムラインの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> によって決まります。  タイムラインは、期間の最後に到達すると、再生を停止します。  タイムラインに子タイムラインがある場合は、子も再生を停止します。  アニメーションの場合は、<xref:System.Windows.Media.Animation.Timeline.Duration%2A> は、アニメーションが開始値から終了値まで移行するのに要する時間を指定します。  タイムラインの継続時間は、1 回の反復の継続時間と繰り返しを含むアニメーションの合計再生時間を区別するために、単純継続時間と呼ばれることもあります。  継続時間は、有限の時間値、あるいは特殊な値 <xref:System.Windows.Duration.Automatic%2A> または <xref:System.Windows.Duration.Forever%2A> を使用して指定できます。  アニメーションの継続時間は、アニメーションが値の間を遷移できるように、<xref:System.Windows.Duration.TimeSpan%2A> 値に対して解決される必要があります。  
+  
+ <xref:System.Windows.Media.Animation.Timeline.Duration%2A> が 5 秒間の <xref:System.Windows.Media.Animation.DoubleAnimation> の例を次に示します。  
+  
+  
+  
+ <xref:System.Windows.Media.Animation.Storyboard> や <xref:System.Windows.Media.Animation.ParallelTimeline> などのコンテナー タイムラインの既定の期間は <xref:System.Windows.Duration.Automatic%2A> であり、最後の子が再生を停止した時点で自動的に終了することを意味します。  <xref:System.Windows.Media.Animation.Timeline.Duration%2A> が 5 秒 \(すべての子 <xref:System.Windows.Media.Animation.DoubleAnimation> オブジェクトの完了に要する時間の長さ\) に解決される <xref:System.Windows.Media.Animation.Storyboard> の例を次に示します。  
+  
+  
+  
+ コンテナー タイムラインの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> を <xref:System.Windows.Duration.TimeSpan%2A> 値に設定すると、その再生時間を子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトの再生時間よりも強制的に長くしたり短くしたりすることができます。  <xref:System.Windows.Media.Animation.Timeline.Duration%2A> をコンテナー タイムラインの子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトの長さを下回る値に設定すると、子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトは、コンテナー タイムラインの停止時に再生を停止します。  次の例では、前の例の <xref:System.Windows.Media.Animation.Storyboard> の <xref:System.Windows.Media.Animation.Timeline.Duration%2A> を 3 秒に設定します。  その結果、最初の <xref:System.Windows.Media.Animation.DoubleAnimation> が 3 秒後 \(ターゲットの四角形の幅を 60 にアニメーション化した時点\) に進行を停止します。  
+  
+  
+  
+<a name="repeatinganimations"></a>   
+### RepeatBehavior プロパティ  
+ <xref:System.Windows.Media.Animation.Timeline> コントロールの <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティは、単純継続時間を繰り返す回数を制御します。  <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用して、タイムラインの再生回数 \(反復 <xref:System.Windows.Media.Animation.RepeatBehavior.Count%2A>\) またはタイムラインの再生時間の合計 \(繰り返し <xref:System.Windows.Media.Animation.RepeatBehavior.Duration%2A>\) を指定することができます。  いずれの場合も、アニメーションは、要求されたカウントまたは期間を満たすのに必要な回数だけ実行を繰り返します。  既定では、タイムラインの反復カウントは `1.0` です。これは、再生回数が 1 回で、繰り返されないことを意味します。  
+  
+ <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用し、反復カウントを指定して <xref:System.Windows.Media.Animation.DoubleAnimation> の再生時間を単純継続時間の 2 倍にする例を次に示します。  
+  
+  
+  
+ <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用し、<xref:System.Windows.Media.Animation.DoubleAnimation> の再生時間を単純継続時間の半分にする例を次に示します。  
+  
+  
+  
+ <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを <xref:System.Windows.Media.Animation.RepeatBehavior.Forever%2A> に設定すると、<xref:System.Windows.Media.Animation.Timeline> は、対話的に停止されるかタイミング システムによって停止されるまで繰り返されます。  <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> プロパティを使用して <xref:System.Windows.Media.Animation.DoubleAnimation> を無限に再生する例を次に示します。  
+  
+  
+  
+ 他の例については、「[アニメーションを反復する](../../../../docs/framework/wpf/graphics-multimedia/how-to-repeat-an-animation.md)」を参照してください。  
+  
+<a name="autoreverseproperty"></a>   
+### AutoReverse プロパティ  
+ <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティは、順方向の反復が完了するたびに <xref:System.Windows.Media.Animation.Timeline> を逆方向に再生するかどうかを指定します。  次の例では、<xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティを `true` に設定します。その結果、0 から 100 までアニメーション化された後、100 から 0 までアニメーション化されます。  合計 10 秒間再生されます。  
+  
+  
+  
+ <xref:System.Windows.Media.Animation.RepeatBehavior.Count%2A> 値を使用して <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> を指定し、その <xref:System.Windows.Media.Animation.Timeline> の <xref:System.Windows.Media.Animation.Timeline.AutoReverse%2A> プロパティを `true` に設定した場合、1 回の繰り返しには順方向の反復と逆方向の反復が 1 回ずつ含まれます。  次の例では、前の例の <xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> で <xref:System.Windows.Media.Animation.RepeatBehavior.Count%2A> 値を 2 に設定します。  その結果、<xref:System.Windows.Media.Animation.DoubleAnimation> は 20 秒間 \(順方向に 5 秒間、逆方向に 5 秒間、順方向に再度 5 秒間、および逆方向に 5 秒間\) 再生されます。  
+  
+  
+  
+ コンテナー タイムラインに子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトが含まれる場合、コンテナー タイムラインが反転するとその子オブジェクトも反転します。  その他の例については、「[タイムラインを自動的に反転するかどうかを指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-whether-a-timeline-automatically-reverses.md)」を参照してください。  
+  
+<a name="timelinebegin"></a>   
+## BeginTime プロパティ  
+ <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> プロパティを使用すると、タイムラインを開始するタイミングを指定できます。  タイムラインの開始時間は、親タイムラインを基準とした相対値になります。  開始時間を 0 秒に設定すると、タイムラインはその親が開始されると直ちに開始されます。その他の値に設定すると、親タイムラインの再生開始時点と子タイムラインの再生時点の間のオフセットが作成されます。  たとえば、開始時間を 2 秒に設定すると、タイムラインは、その親が 2 秒の時点に到達すると再生を開始します。  既定では、すべてのタイムラインの開始時間は 0 秒です。  タイムラインの開始時間は、`null` に設定することもできます。この場合、タイムラインは開始されません。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、[x:Null のマークアップ拡張機能](../../../../docs/framework/xaml-services/x-null-markup-extension.md)を使用して null を指定します。  
+  
+ 開始時間は、<xref:System.Windows.Media.Animation.Timeline.RepeatBehavior%2A> の設定によってタイムラインが繰り返されるたびに適用されるわけではないことに注意してください。  <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> が 10 秒、<xref:System.Windows.Media.Animation.RepeatBehavior> が <xref:System.Windows.Media.Animation.RepeatBehavior.Forever%2A> に設定されたアニメーションを作成した場合、アニメーションを最初に再生する前に 10 秒の遅延が発生しますが、後続の各繰り返しでは発生しません。  ただし、アニメーションの親タイムラインの再開または繰り返しが行われた場合は、10 秒の遅延が発生します。  
+  
+ <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> プロパティは、タイムラインをずらす際に役立ちます。  2 つの子 <xref:System.Windows.Media.Animation.DoubleAnimation> オブジェクトを含む <xref:System.Windows.Media.Animation.Storyboard> を作成する例を次に示します。  最初のアニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> は 5 秒で、2 番目のアニメーションの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> は 3 秒です。  この例では、2 番目の <xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.Timeline.BeginTime%2A> を 5 秒に設定し、最初の <xref:System.Windows.Media.Animation.DoubleAnimation> の終了後に再生を開始できるようにします。  
+  
+  
+  
+<a name="fillbehaviorproperty"></a>   
+## FillBehavior プロパティ  
+ <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティは、<xref:System.Windows.Media.Animation.Timeline> がアクティブな継続時間全体の末尾に到達したときに、タイムラインを停止するかその最終的な値を保持するかを指定します。  <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> が <xref:System.Windows.Media.Animation.FillBehavior> に設定されたアニメーションは、その出力値を "保持" します。アニメーション化されているプロパティは、アニメーションの最終的な値を保持します。  値を <xref:System.Windows.Media.Animation.FillBehavior> に設定すると、アニメーションは、終了後にターゲット プロパティへの作用を停止します。  
+  
+ 2 つの子 <xref:System.Windows.Media.Animation.DoubleAnimation> オブジェクトを含む <xref:System.Windows.Media.Animation.Storyboard> を作成する例を次に示します。  両方の <xref:System.Windows.Media.Animation.DoubleAnimation> オブジェクトで、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> が 0 から 100 までアニメーション化されます。  アニメーション化されていないときの <xref:System.Windows.Shapes.Rectangle> 要素の <xref:System.Windows.FrameworkElement.Width%2A> 値は、500 [デバイス非依存ピクセル](GTMT)です。  
+  
+-   最初の <xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティは、既定値の <xref:System.Windows.Media.Animation.FillBehavior> に設定されています。  その結果、四角形の幅は、<xref:System.Windows.Media.Animation.DoubleAnimation> の終了後に 100 のまま保持されます。  
+  
+-   2 番目の <xref:System.Windows.Media.Animation.DoubleAnimation> の <xref:System.Windows.Media.Animation.Timeline.FillBehavior%2A> プロパティは、<xref:System.Windows.Media.Animation.FillBehavior> に設定されています。  その結果、2 番目の <xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.FrameworkElement.Width%2A> は、<xref:System.Windows.Media.Animation.DoubleAnimation> の終了後に 500 に戻ります。  
+  
+  
+  
+<a name="speedproperties"></a>   
+## タイムラインの速度を制御するプロパティ  
+ <xref:System.Windows.Media.Animation.Timeline> クラスでは、その速度を指定するための 3 つのプロパティが提供されます。  
+  
+-   <xref:System.Windows.Media.Animation.Timeline.SpeedRatio%2A> \- <xref:System.Windows.Media.Animation.Timeline> の時間の進行の速度 \(親に対する相対的な速度\) を指定します。  1 を超える値を指定すると <xref:System.Windows.Media.Animation.Timeline> とその子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトの速度が上がり、0 ～ 1 の値を指定するとその速度が下がります。  値 1 は、<xref:System.Windows.Media.Animation.Timeline> がその親と同じ速度で進行することを示します。  コンテナー タイムラインの <xref:System.Windows.Media.Animation.Timeline.SpeedRatio%2A> 設定は、すべての子 <xref:System.Windows.Media.Animation.Timeline> オブジェクトに影響します。  
+  
+-   <xref:System.Windows.Media.Animation.Timeline.AccelerationRatio%2A> \- 加速に費やされるタイムラインの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> の比率を指定します。  例については、「[アニメーションを加速または減速させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md)」を参照してください。  
+  
+-   <xref:System.Windows.Media.Animation.Timeline.DecelerationRatio%2A> \- 減速に費やされるタイムラインの <xref:System.Windows.Media.Animation.Timeline.Duration%2A> の比率を指定します。  例については、「[アニメーションを加速または減速させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-accelerate-or-decelerate-an-animation.md)」を参照してください。  
+  
+## 参照  
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [アニメーションとタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)   
+ [タイミング イベントの概要](../../../../docs/framework/wpf/graphics-multimedia/timing-events-overview.md)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-how-to-topics.md)   
+ [アニメーションのタイミング動作のサンプル](http://go.microsoft.com/fwlink/?LinkID=159970)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/timing-events-overview.md b/docs/framework/wpf/graphics-multimedia/timing-events-overview.md
new file mode 100644
index 00000000000..fab6cf42e56
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/timing-events-overview.md
@@ -0,0 +1,89 @@
+---
+title: "タイミング イベントの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Clock クラス"
+  - "クロックのクラス"
+  - "タイムライン"
+  - "タイミング イベント"
+ms.assetid: 597e3280-0867-4359-a97b-5b2f4149e350
+caps.latest.revision: 14
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# タイミング イベントの概要
+このトピックで使用できる&5; つのタイミング イベントを使用する方法について説明<xref:System.Windows.Media.Animation.Timeline>と<xref:System.Windows.Media.Animation.Clock>のオブジェクト。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+## <a name="prerequisites"></a>必須コンポーネント  
+ このトピックを理解するには、作成し、アニメーションを使用する方法を理解する必要があります。 最初にアニメーションを使用してを参照してください、[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)します。  
+  
+ 複数の方法でプロパティをアニメーション化する[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]:  
+  
+-   **Storyboard オブジェクトを使用して**(マークアップとコード): 使用する<xref:System.Windows.Media.Animation.Storyboard>を配置して、1 つまたは複数のオブジェクトにアニメーションを配布するオブジェクト。 例については、次を参照してください。[ストーリー ボードを使用して、プロパティをアニメーション化](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-a-storyboard.md)します。  
+  
+-   **ローカル アニメーションを使用して**(コードのみ): 適用できる<xref:System.Windows.Media.Animation.AnimationTimeline>アニメーション化するプロパティに直接オブジェクトです。 例については、次を参照してください。[プロパティなしを使用して、ストーリー ボード アニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-without-using-a-storyboard.md)です。  
+  
+-   **クロックを使用して**(コードのみ): 明示的にクロックを作成し、自分でアニメーション クロックを配布できます。  例については、次を参照してください。 [AnimationClock を使用して、プロパティをアニメーション化する](../../../../docs/framework/wpf/graphics-multimedia/how-to-animate-a-property-by-using-an-animationclock.md)です。  
+  
+ この概要の例を使用してマークアップおよびコードで使用することができます、ため<xref:System.Windows.Media.Animation.Storyboard>オブジェクトです。 ただし、プロパティをアニメーション化する他の方法を説明する概念を適用できます。  
+  
+### <a name="what-is-a-clock"></a>クロックは何ですか。  
+ タイムラインには、単独で実際に何もしない以外の時間のセグメントについて説明します。 タイムラインの<xref:System.Windows.Media.Animation.Clock>実際の処理を行うオブジェクト: タイムラインのスペースを実行時のタイミングに関連する状態を維持します。 使用してストーリー ボードなど、ほとんどの場合は、タイムラインで、クロックが自動的に作成します。 作成することも、<xref:System.Windows.Media.Animation.Clock>を使用して明示的に、 <xref:System.Windows.Media.Animation.Timeline.CreateClock%2A>メソッドです。 詳細については<xref:System.Windows.Media.Animation.Clock>、オブジェクトを参照してください、[アニメーションおよびタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)します。  
+  
+## <a name="why-use-events"></a>イベントを使用する理由  
+ 1 つを除く (最後のタイマー刻みに沿ったシーク)、すべての対話型タイミング操作は非同期です。 正確に実行するときを知る方法はありません。 タイミング動作に依存するその他のコードがある場合、問題が存在することができます。 四角形をアニメーション化したタイムラインを停止するようにしたいとします。 タイムラインが停止した後は、四角形の色を変更します。  
+  
+ [!code-csharp[events_procedural#NeedForEventsFragment](../../../../samples/snippets/csharp/VS_Snippets_Wpf/events_procedural/CSharp/EventExample.cs#needforeventsfragment)]
+ [!code-vb[events_procedural#NeedForEventsFragment](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/events_procedural/VisualBasic/EventExample.vb#needforeventsfragment)]  
+  
+ 前の例で、2 つ目のコード行は、ストーリー ボードが停止する前に実行可能性があります。 停止は非同期操作であるためにです。 タイムラインまたは停止する時刻を示すには、「停止要求」のある種のタイミング エンジンの次の目盛りまで処理されていないを作成します。  
+  
+ タイムラインの完了後にコマンドを実行するには、イベントのタイミングを使用します。 次の例では、ストーリー ボードの再生が停止した後に、四角形の色を変更するイベント ハンドラーを使用します。  
+  
+ [!code-csharp[events_procedural#RegisterForStoryboardCurrentStateInvalidatedEvent](../../../../samples/snippets/csharp/VS_Snippets_Wpf/events_procedural/CSharp/EventExample.cs#registerforstoryboardcurrentstateinvalidatedevent)]
+ [!code-vb[events_procedural#RegisterForStoryboardCurrentStateInvalidatedEvent](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/events_procedural/VisualBasic/EventExample.vb#registerforstoryboardcurrentstateinvalidatedevent)]  
+[!code-csharp[events_procedural#StoryboardCurrentStateInvalidatedEvent2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/events_procedural/CSharp/EventExample.cs#storyboardcurrentstateinvalidatedevent2)]
+[!code-vb[events_procedural#StoryboardCurrentStateInvalidatedEvent2](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/events_procedural/VisualBasic/EventExample.vb#storyboardcurrentstateinvalidatedevent2)]  
+  
+ 完全な例では、次を参照してください。[受信通知と、クロックの状態の変化](../../../../docs/framework/wpf/graphics-multimedia/how-to-receive-notification-when-clock-state-changes.md)します。  
+  
+## <a name="public-events"></a>パブリック イベント  
+ <xref:System.Windows.Media.Animation.Timeline>と<xref:System.Windows.Media.Animation.Clock>両方のクラスは、5 つのイベントのタイミングを提供します。 次の表は、これらのイベントとそれらをトリガーする条件を示します。  
+  
+|イベント|対話型操作をトリガーします。|その他のトリガー|  
+|-----------|--------------------------------------|--------------------|  
+|**完了**|保留へスキップ|時計を完了します。|  
+|**CurrentGlobalSpeedInvalidated**|一時停止、再開、シーク、速度比の設定を入力して、停止に進んでください。|クロックでを反転させます、高速化が開始または停止します。|  
+|**CurrentStateInvalidated**|開始、停止を入力してへスキップ|クロックは、開始、停止、または入力します。|  
+|**CurrentTimeInvalidated**|開始、シーク、停止を入力してへスキップ|クロック進行します。|  
+|**RemoveRequested**|削除||  
+  
+## <a name="ticking-and-event-consolidation"></a>タイマー刻みとイベントの統合  
+ 内のオブジェクトをアニメーション化するときに[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]アニメーションを管理するタイミング エンジンです。 タイミング エンジンは、時間の進行状況を追跡し、それぞれのアニメーションの状態を計算します。 1 秒間でこのような多くの評価パスがあったときです。 これらの評価パスは「ティック」と呼ばれます。  
+  
+ タイマー刻みで頻繁に発生しますは、いろいろな目盛りの間で発生する可能性があります。 たとえば、タイムライン可能性があります停止、開始されると、およびここでも、停止している場合、現在の状態変更が完了したら&3; 回です。 理論上は、イベント発生複数回、単一のティックのただし、ティックあたり最大で&1; つは各イベントを発生する可能性があるために、タイミング エンジンはイベントを統合します。  
+  
+## <a name="registering-for-events"></a>イベントの登録  
+ タイミング イベントを登録する&2; つの方法があります。 タイムラインまたはタイムラインから作成された時刻を登録することができます。 コードからのみ実行できますが、クロックを使用して直接、イベントの登録は、かなり簡単です。 マークアップまたはコードからタイムラインを使用してイベントを登録することができます。 次のセクションでは、タイムラインでのクロック イベントに登録する方法について説明します。  
+  
+<a name="registeringforclockeventswithatimeline"></a>   
+## <a name="registering-for-clock-events-with-a-timeline"></a>タイムラインでのクロック イベントの登録  
+ タイムラインの<xref:System.Windows.Media.Animation.Timeline.Completed>、 <xref:System.Windows.Media.Animation.Timeline.CurrentGlobalSpeedInvalidated>、 <xref:System.Windows.Media.Animation.Timeline.CurrentStateInvalidated>、 <xref:System.Windows.Media.Animation.Timeline.CurrentTimeInvalidated>、および<xref:System.Windows.Media.Animation.Timeline.RemoveRequested>タイムライン、対応するこれらのイベントが実際にイベント ハンドラーを関連付けますの登録に関連するイベントが表示されます、<xref:System.Windows.Media.Animation.Clock>タイムラインのスペースを作成します。  
+  
+ 登録する場合、<xref:System.Windows.Media.Animation.Timeline.Completed>タイムラインでイベントをたとえば、実際にすることをシステムに登録する、<xref:System.Windows.Media.Animation.Clock.Completed>タイムラインのスペースを作成する各クロックのイベントです。 コードでは、このイベントの前に登録する必要があります、<xref:System.Windows.Media.Animation.Clock>; このタイムラインの作成は、それ以外の場合、通知を受信しません。 自動的にこの問題は発生[!INCLUDE[TLA2#tla_xaml](../../../../includes/tla2sharptla-xaml-md.md)]; パーサーが自動的に登録する前に、イベントの<xref:System.Windows.Media.Animation.Clock>が作成されます。  
+  
+## <a name="see-also"></a>関連項目  
+ [アニメーションおよびタイミング システムの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-and-timing-system-overview.md)   
+ [アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)   
+ [タイミング動作の概要](../../../../docs/framework/wpf/graphics-multimedia/timing-behaviors-overview.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md
new file mode 100644
index 00000000000..fb2275b49d3
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md
@@ -0,0 +1,44 @@
+---
+title: "変換に関する方法のトピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "2-D 変換クラス"
+  - "変換クラス, 2-D"
+  - "変換, 方法トピック"
+  - "変換, 方法トピック"
+ms.assetid: ff71384e-8811-420f-8cc8-0a3332e0397f
+caps.latest.revision: 77
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# 変換に関する方法のトピック
+このセクションのトピックでは、オブジェクトにさまざまな変換を適用する方法について説明します。  
+  
+## このセクションの内容  
+ [イベントの発生時に要素に変換を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-a-transform-to-an-element-when-an-event-occurs.md)  
+ [オブジェクトに複数の変換を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transforms-to-an-object.md)  
+ [要素のスピンを設定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-make-an-element-spin-in-place.md)  
+ [オブジェクトを回転させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object.md)  
+ [要素をスケーリングする](../../../../docs/framework/wpf/graphics-multimedia/how-to-scale-an-element.md)  
+ [要素を傾斜させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-skew-an-element.md)  
+ [変換の原点を相対値で指定する](../../../../docs/framework/wpf/graphics-multimedia/how-to-specify-the-origin-of-a-transform-by-using-relative-values.md)  
+ [要素を変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-translate-an-element.md)  
+ [MatrixTransform を使用してカスタム変換を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-matrixtransform-to-create-custom-transforms.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/transformations.md b/docs/framework/wpf/graphics-multimedia/transformations.md
new file mode 100644
index 00000000000..327ce813a52
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/transformations.md
@@ -0,0 +1,44 @@
+---
+title: "変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "2-D 変換クラス"
+  - "グラフィックス, 変換"
+  - "回転 (オブジェクトを)"
+  - "スケーリング (オブジェクトを)"
+  - "傾斜 (オブジェクトを)"
+  - "変換クラス, 2-D"
+  - "変換"
+  - "変換, 変換の概要"
+  - "変換"
+  - "変換, 変換の概要"
+  - "変換 (オブジェクトを)"
+ms.assetid: 712b543f-d8b2-4dcf-ba2c-f7921c61c6fd
+caps.latest.revision: 50
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 50
+---
+# 変換
+変換は、<xref:System.Windows.FrameworkElement> オブジェクトを回転、スケーリング、平行移動、または傾斜させるために使用します。  
+  
+## このセクションの内容  
+ [変換の概要](../../../../docs/framework/wpf/graphics-multimedia/transforms-overview.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [レイアウト](../../../../docs/framework/wpf/advanced/layout.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/transforms-overview.md b/docs/framework/wpf/graphics-multimedia/transforms-overview.md
new file mode 100644
index 00000000000..9a7c0648d7d
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/transforms-overview.md
@@ -0,0 +1,164 @@
+---
+title: "変換の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "2-D 変換クラス"
+  - "クラス, 2-D 変換"
+  - "FrameworkElement オブジェクト, 回転"
+  - "FrameworkElement オブジェクト, スケーリング"
+  - "FrameworkElement オブジェクト, 傾斜"
+  - "FrameworkElement オブジェクト, 変換"
+  - "変換クラス, 2-D"
+  - "変換, 変換の概要"
+  - "変換, 変換の概要"
+ms.assetid: 8f153d5e-ed61-4aa5-a7cd-286f0c427a13
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 変換の概要
+ここでは、[!INCLUDE[TLA#tla_2d](../../../../includes/tlasharptla-2d-md.md)] <xref:System.Windows.Media.Transform> クラスを使用して <xref:System.Windows.FrameworkElement> オブジェクトの回転、拡大縮小、移動 \(平行移動\)、および傾斜を行う方法について説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="whatIsATransformSection"></a>   
+## 変換とは  
+ <xref:System.Windows.Media.Transform> は、ある座標空間の点を別の座標空間にマップまたは変換する方法を定義します。  このマッピングは、<xref:System.Double> 値を示す 3 つの列を持つ 3 つの行のコレクションである、変換 <xref:System.Windows.Media.Matrix> によって示されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] では、行優先の行列が使用されます。  ベクターは、列ベクターではなく行ベクターとして表されます。  
+  
+ 次の表は、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] 行列の構造を示しています。  
+  
+### 2\-D 変換行列  
+  
+||||  
+|-|-|-|  
+|<xref:System.Windows.Media.Matrix.M11%2A><br /><br /> 既定値: 1.0|<xref:System.Windows.Media.Matrix.M12%2A><br /><br /> 既定値: 0.0|0.0|  
+|<xref:System.Windows.Media.Matrix.M21%2A><br /><br /> 既定値: 0.0|<xref:System.Windows.Media.Matrix.M22%2A><br /><br /> 既定値: 1.0|0.0|  
+|<xref:System.Windows.Media.Matrix.OffsetX%2A><br /><br /> 既定値: 0.0|<xref:System.Windows.Media.Matrix.OffsetY%2A><br /><br /> 既定値: 0.0|1.0|  
+  
+ 行列値を操作することによって、オブジェクトの回転、拡大縮小、傾斜、および移動 \(平行移動\) を行うことができます。  たとえば、第 3 行の第 1 列にある値 \(<xref:System.Windows.Media.Matrix.OffsetX%2A> 値\) を 100 に変更した場合は、その値を使用し、オブジェクトを x 軸に沿って 100 単位移動できます。  第 2 行の第 2 列にある値を 3 に変更した場合は、この値を使用し、オブジェクトを現在の高さの 3 倍に引き伸ばすことができます。  両方の値を変更した場合、オブジェクトは x 軸に沿って 100 単位移動し、オブジェクトの高さは 3 倍に引き伸ばされます。  [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] はアフィン変換のみをサポートするため、右の列の値は常に 0、0、1 です。  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] では行列値を直接操作できますが、基になる行列構造体の構成方法がわからなくてもオブジェクトを変換できる、いくつかの <xref:System.Windows.Media.Transform> クラスも提供されています。  たとえば、変換行列を操作する代わりに、<xref:System.Windows.Media.ScaleTransform> クラスを使用し、<xref:System.Windows.Media.ScaleTransform.ScaleX%2A> プロパティと <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> プロパティを設定してオブジェクトをスケーリングできます。  同様に、<xref:System.Windows.Media.RotateTransform> クラスを使用すると、<xref:System.Windows.Media.RotateTransform.Angle%2A> プロパティを設定するだけでオブジェクトを回転できます。  
+  
+<a name="transformClassesSection"></a>   
+## 変換クラス  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] には、一般的な変換操作用に次の [!INCLUDE[TLA#tla_2d](../../../../includes/tlasharptla-2d-md.md)] <xref:System.Windows.Media.Transform> クラスが用意されています。  
+  
+|Class|Description|例|図|  
+|-----------|-----------------|-------|-------|  
+|<xref:System.Windows.Media.RotateTransform>|指定した <xref:System.Windows.Media.RotateTransform.Angle%2A> だけ要素を回転します。|[オブジェクトを回転させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-rotate-an-object.md)||  
+|<xref:System.Windows.Media.ScaleTransform>|指定した <xref:System.Windows.Media.ScaleTransform.ScaleX%2A> および <xref:System.Windows.Media.ScaleTransform.ScaleY%2A> の量だけ要素をスケーリングします。|[要素をスケーリングする](../../../../docs/framework/wpf/graphics-multimedia/how-to-scale-an-element.md)||  
+|<xref:System.Windows.Media.SkewTransform>|指定した <xref:System.Windows.Media.SkewTransform.AngleX%2A> および <xref:System.Windows.Media.SkewTransform.AngleY%2A> の量だけ要素を傾斜させます。|[要素を傾斜させる](../../../../docs/framework/wpf/graphics-multimedia/how-to-skew-an-element.md)||  
+|<xref:System.Windows.Media.TranslateTransform>|指定した <xref:System.Windows.Media.TranslateTransform.X%2A> および <xref:System.Windows.Media.TranslateTransform.Y%2A> の量だけ要素を移動 \(平行移動\) します。|[要素を変換する](../../../../docs/framework/wpf/graphics-multimedia/how-to-translate-an-element.md)||  
+  
+ より複雑な変換を作成するために、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は次の 2 つのクラスを提供します。  
+  
+|Class|Description|例|  
+|-----------|-----------------|-------|  
+|<xref:System.Windows.Media.TransformGroup>|複数の <xref:System.Windows.Media.TransformGroup> オブジェクトを、変換プロパティに適用できる単一の <xref:System.Windows.Media.Transform> にグループ化します。|[オブジェクトに複数の変換を適用する](../../../../docs/framework/wpf/graphics-multimedia/how-to-apply-multiple-transforms-to-an-object.md)|  
+|<xref:System.Windows.Media.MatrixTransform>|他の <xref:System.Windows.Media.Transform> クラスによって提供されないカスタム変換を作成します。  <xref:System.Windows.Media.MatrixTransform> を使用する場合は、Matrix を直接操作します。|[MatrixTransform を使用してカスタム変換を作成する](../../../../docs/framework/wpf/graphics-multimedia/how-to-use-a-matrixtransform-to-create-custom-transforms.md)|  
+  
+ [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] は [!INCLUDE[TLA#tla_3d](../../../../includes/tlasharptla-3d-md.md)] 変換も提供します。  詳細については、<xref:System.Windows.Media.Media3D.Transform3D> クラスを参照してください。  
+  
+<a name="transformationproperties"></a>   
+## 一般的な変換プロパティ  
+ オブジェクトを変換する方法の 1 つとして、適切な <xref:System.Windows.Media.Transform> 型を宣言してオブジェクトの変換プロパティに適用する方法があります。  さまざまな型のオブジェクトが、異なる種類の変換プロパティを持ちます。  一般的に使用されるいくつかの [!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] 型とその変換プロパティを次の表に示します。  
+  
+|種類|変換プロパティ|  
+|--------|-------------|  
+|<xref:System.Windows.Media.Brush>|<xref:System.Windows.Media.Brush.Transform%2A>, <xref:System.Windows.Media.Brush.RelativeTransform%2A>|  
+|<xref:System.Windows.Media.ContainerVisual>|<xref:System.Windows.Media.ContainerVisual.Transform%2A>|  
+|<xref:System.Windows.Media.DrawingGroup>|<xref:System.Windows.Media.DrawingGroup.Transform%2A>|  
+|<xref:System.Windows.FrameworkElement>|<xref:System.Windows.UIElement.RenderTransform%2A>, <xref:System.Windows.FrameworkElement.LayoutTransform%2A>|  
+|<xref:System.Windows.Media.Geometry>|<xref:System.Windows.Media.Geometry.Transform%2A>|  
+|<xref:System.Windows.Media.TextEffect>|<xref:System.Windows.Media.TextEffect.Transform%2A>|  
+|<xref:System.Windows.UIElement>|<xref:System.Windows.UIElement.RenderTransform%2A>|  
+  
+<a name="transformcenter"></a>   
+## 変換と座標系  
+ オブジェクトを変換する場合は、オブジェクトを変換するだけでなく、オブジェクトが存在する座標空間を変換します。  既定では、変換の中心 \(0,0\) はターゲット オブジェクトの座標系の基点です。  唯一の例外は <xref:System.Windows.Media.TranslateTransform> です。<xref:System.Windows.Media.TranslateTransform> は、中心の位置に関係なく変換効果が同じであるため、中心を設定するためのプロパティはありません。  
+  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を使用して、<xref:System.Windows.FrameworkElement> の一種である <xref:System.Windows.Shapes.Rectangle> 要素をその既定の位置 \(0, 0\) を中心に 45°回転します。  回転の効果を次の図に示します。  
+  
+ ![&#40;0,0&#41; を軸に 45 度回転した FrameworkElement](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-fe-rotated-about-upperleft-corner.png "graphicsmm\_FE\_rotated\_about\_upperleft\_corner")  
+点 \(0,0\) を中心として 45°回転した四角形要素  
+  
+ [!code-xml[Transforms_snip#TransformsFERotatedAboutTopLeft](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/CoordinateSystemExample.xaml#transformsferotatedabouttopleft)]  
+  
+ 既定では、この要素は左上隅 \(0, 0\) を中心に回転します。  <xref:System.Windows.Media.RotateTransform>、<xref:System.Windows.Media.ScaleTransform>、および <xref:System.Windows.Media.SkewTransform> の各クラスは、変換が適用される点を指定できる CenterX プロパティと CenterY プロパティを提供します。  
+  
+ 次の例でも、<xref:System.Windows.Media.RotateTransform> を使用して <xref:System.Windows.Shapes.Rectangle> 要素を 45°回転していますが、<xref:System.Windows.Media.RotateTransform.CenterX%2A> プロパティと <xref:System.Windows.Media.RotateTransform.CenterY%2A> プロパティは <xref:System.Windows.Media.RotateTransform> の中心が \(25, 25\) になるように設定されています。  回転の効果を次の図に示します。  
+  
+ ![&#40;25, 25&#41; を軸に 45 度回転した Geometry](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-fe-rotated-about-center.png "graphicsmm\_FE\_rotated\_about\_center")  
+点 \(25, 25\) を中心として 45°回転した四角形要素  
+  
+ [!code-xml[Transforms_snip#TransformsFERotatedAboutCenter](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/CoordinateSystemExample.xaml#transformsferotatedaboutcenter)]  
+  
+<a name="layoutTransformsAndRenderTransformsSection"></a>   
+## FrameworkElement の変換  
+ <xref:System.Windows.FrameworkElement> に変換を適用するには、<xref:System.Windows.Media.Transform> を作成して、<xref:System.Windows.FrameworkElement> クラスが提供する 2 つのプロパティのいずれかに適用します。  
+  
+-   <xref:System.Windows.FrameworkElement.LayoutTransform%2A> – レイアウト パスの前に適用される変換。  変換の適用後に、レイアウト システムは要素の変換後のサイズおよび位置を処理します。  
+  
+-   <xref:System.Windows.UIElement.RenderTransform%2A> – 要素の外観を変更する変換。レイアウト パスの完了後に適用されます。  <xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティの代わりに <xref:System.Windows.UIElement.RenderTransform%2A> プロパティを使用すると、パフォーマンスを向上できます。  
+  
+ どちらのプロパティを使用すればよいでしょうか。  パフォーマンスを向上させるために、可能な場合 \(特にアニメーション化された <xref:System.Windows.Media.Transform> オブジェクトを使用する場合\) は必ず、<xref:System.Windows.UIElement.RenderTransform%2A> プロパティを使用してください。  拡大縮小、回転、または傾斜を行うときに、要素の変換後のサイズに合わせるために要素の親が必要になる場合は、<xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティを使用します。  <xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティと共に使用した場合、<xref:System.Windows.Media.TranslateTransform> オブジェクトは、要素に影響していないように見えます。  これは、レイアウト システムが処理の一部として平行移動された要素を元の位置に戻すためです。  
+  
+ [!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のレイアウトの詳細については、「[レイアウト](../../../../docs/framework/wpf/advanced/layout.md)」の概要を参照してください。  
+  
+<a name="exampleRotateAnElement45degSection"></a>   
+## 例 : FrameworkElement を 45°回転する  
+ 次の例では、<xref:System.Windows.Media.RotateTransform> を使用して、ボタンを時計回りに 45°回転します。  このボタンは、他にも 2 つのボタンを持つ <xref:System.Windows.Controls.StackPanel> 内に存在します。  
+  
+ 既定では、<xref:System.Windows.Media.RotateTransform> は点 \(0,0\) を中心として回転します。  この例では中心の値を指定しないため、ボタンはその左上隅の点 \(0, 0\) を中心として回転します。  <xref:System.Windows.Media.RotateTransform> は、<xref:System.Windows.UIElement.RenderTransform%2A> プロパティに適用されます。  変換の結果を次の図に示します。  
+  
+ ![RenderTransform を使用して変換されたボタン](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rendertransformwithdefaultcenter.png "graphicsmm\_RenderTransformWithDefaultCenter")  
+左上隅から時計回りに 45°回転  
+  
+ [!code-xml[Transforms_snip#GraphicsMMRotateButtonExample1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonRotateTransformExample.xaml#graphicsmmrotatebuttonexample1)]  
+  
+ 次の例でも <xref:System.Windows.Media.RotateTransform> を使用してボタンを時計回りに 45 度回転していますが、ボタンの <xref:System.Windows.UIElement.RenderTransformOrigin%2A> を \(0.5, 0.5\) にも設定しています。  <xref:System.Windows.UIElement.RenderTransformOrigin%2A> プロパティの値は、ボタンのサイズに対して相対的です。  その結果、回転はボタンの左上隅ではなく中心に適用されます。  変換の結果を次の図に示します。  
+  
+ ![中心の周りで変換されたボタン](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-rendertransformrelativecenter.png "graphicsmm\_RenderTransformRelativeCenter")  
+中心を軸に時計回りに 45°回転  
+  
+ [!code-xml[Transforms_snip#GraphicsMMRotateButtonExample2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonRotateTransformExample.xaml#graphicsmmrotatebuttonexample2)]  
+  
+ <xref:System.Windows.UIElement.RenderTransform%2A> プロパティの代わりに <xref:System.Windows.FrameworkElement.LayoutTransform%2A> プロパティを使用して、ボタンを回転する例を次に示します。  これにより、変換がボタンのレイアウトに影響し、レイアウト システムで完全パスをトリガーします。  ボタンはサイズが変更されたため、結果として回転し位置が変わります。  変換の結果を次の図に示します。  
+  
+ ![LayoutTransform を使用して変換されたボタン](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-layouttransform.png "graphicsmm\_LayoutTransform")  
+LayoutTransform を使用したボタンの回転  
+  
+ [!code-xml[Transforms_snip#GraphicsMMRotateButtonExample3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonRotateTransformExample.xaml#graphicsmmrotatebuttonexample3)]  
+  
+<a name="animate_transforms"></a>   
+## 変換のアニメーション化  
+ <xref:System.Windows.Media.Transform> クラスは、<xref:System.Windows.Media.Animation.Animatable> を継承するため、アニメーション化することができます。  <xref:System.Windows.Media.Transform> をアニメーション化するには、互換性のある種類のアニメーションをアニメーション化するプロパティに適用します。  
+  
+ 次の例では、<xref:System.Windows.Media.Animation.Storyboard> と <xref:System.Windows.Media.Animation.DoubleAnimation> を、<xref:System.Windows.Media.RotateTransform> で使用して、<xref:System.Windows.Controls.Button> がクリックされたときにその場で回転させます。  
+  
+ [!code-xml[Transforms_snip#GraphicsMMAnimatedRotateButtonExampleWholePage](../../../../samples/snippets/csharp/VS_Snippets_Wpf/Transforms_snip/CS/ButtonAnimatedRotateTransformExample.xaml#graphicsmmanimatedrotatebuttonexamplewholepage)]  
+  
+ サンプル全体については、[2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)を参照してください。  アニメーションの詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+<a name="freezable_features"></a>   
+## Freezable の機能  
+ <xref:System.Windows.Media.Transform> クラスは <xref:System.Windows.Freezable> クラスを継承しているため、<xref:System.Windows.Media.Transform> オブジェクトの[リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)としての宣言、複数のオブジェクトでの共有、読み取り専用に設定することによるパフォーマンスの向上、複製、スレッド セーフの設定など、特殊な機能を備えています。  <xref:System.Windows.Freezable> オブジェクトのさまざまな機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Transform>   
+ <xref:System.Windows.Media.Matrix>   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/transformations-how-to-topics.md)   
+ [2\-D 変換のサンプル](http://go.microsoft.com/fwlink/?LinkID=158252)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md b/docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md
new file mode 100644
index 00000000000..8787c7debea
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md
@@ -0,0 +1,87 @@
+---
+title: "チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ホスティング, ビジュアル オブジェクト (Win32 コードの)"
+  - "ビジュアル オブジェクト (Win32 コードの)"
+  - "Win32 コード, ビジュアル オブジェクト"
+ms.assetid: f0e1600c-3217-43d5-875d-1864fa7fe628
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト
+[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] は、アプリケーションの作成に適した環境を提供します。  ただし、[!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] コードに多くの投資を行った場合は、コードを記述し直すよりも、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の機能をアプリケーションに追加する方が、より効率的である場合があります。  アプリケーション内で現在使用されている [!INCLUDE[TLA#tla_win32](../../../../includes/tlasharptla-win32-md.md)] と [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] グラフィック サブシステムのサポートを提供するため、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウのオブジェクトをホストする機能を提供します。  
+  
+ このチュートリアルでは、[!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウで [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ビジュアル オブジェクトをホストするサンプル アプリケーション \([Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)\) を記述する方法を説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="requirements"></a>   
+## 要件  
+ このチュートリアルは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] および [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] のプログラミングに関する基本的な知識があることを前提としています。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] プログラミングの概要については、「[チュートリアル: WPF の概要](../../../../docs/framework/wpf/getting-started/walkthrough-my-first-wpf-desktop-application.md)」を参照してください。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] プログラミングの概要については多数の書籍が出版されていますので、それらを参照してください。特に『プログラミング Windows』\(Charles Petzold 著\) が参考になります。  
+  
+> [!NOTE]
+>  このチュートリアルには、関連するサンプルからのコード例が数多く含まれています。  ただし、読みやすさのために、完全なサンプル コードは含まれていません。  サンプル コード全体については、[Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)を参照してください。  
+  
+<a name="creating_the_host_win32_window"></a>   
+## ホスト Win32 ウィンドウの作成  
+ [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] オブジェクトをホストするキーとなるのは、<xref:System.Windows.Interop.HwndSource> クラスです。  このクラスは [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] オブジェクトをラップし、そのオブジェクトを子ウィンドウとして [!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] に組み込むことができます。  
+  
+ 次の例では、ビジュアル オブジェクトの [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンテナー ウィンドウとして <xref:System.Windows.Interop.HwndSource> オブジェクトを作成するためのコードを示します。  [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウのウィンドウ スタイル、位置、およびその他のパラメーターを設定する場合は、<xref:System.Windows.Interop.HwndSourceParameters> オブジェクトを使用します。  
+  
+ [!code-csharp[VisualsHitTesting#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyWindow.cs#101)]
+ [!code-vb[VisualsHitTesting#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyWindow.vb#101)]  
+  
+> [!NOTE]
+>  <xref:System.Windows.Interop.HwndSourceParameters.ExtendedWindowStyle%2A> プロパティの値を WS\_EX\_TRANSPARENT に設定することはできません。  これは、ホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウを透明にできないことを意味します。  このため、ホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの背景色はその親ウィンドウと同じ背景色に設定されます。  
+  
+<a name="adding_visual_objects_to_the_host_win32_window"></a>   
+## ホスト Win32 ウィンドウへのビジュアル オブジェクトの追加  
+ ビジュアル オブジェクトのホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] コンテナー ウィンドウを作成したら、そのコンテナー ウィンドウにビジュアル オブジェクトを追加できます。  アニメーションなどでビジュアル オブジェクトが変形しても、ビジュアル オブジェクトがホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウの境界を示す四角形を超えて拡大されないようにする必要があります。  
+  
+ 次の例では、<xref:System.Windows.Interop.HwndSource> オブジェクトを作成し、ビジュアル オブジェクトを追加するコードを示します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティが、ホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウに追加される最初のビジュアル オブジェクトに設定されます。  ルートのビジュアル オブジェクトによりビジュアル オブジェクト ツリーの最上位ノードが定義されます。  ホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウに追加される後続のビジュアル オブジェクトは、子オブジェクトとして追加されます。  
+  
+ [!code-csharp[VisualsHitTesting#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyWindow.cs#100)]
+ [!code-vb[VisualsHitTesting#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyWindow.vb#100)]  
+  
+<a name="implementing_the_win32_message_filter"></a>   
+## Win32 メッセージ フィルターの実装  
+ ビジュアル オブジェクトのホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウでは、アプリケーション キューからウィンドウに送信されるメッセージを処理するために、ウィンドウ メッセージのフィルター プロシージャが必要です。  ウィンドウ プロシージャは [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] システムからのメッセージを受け取ります。  受け取るメッセージは、入力メッセージまたはウィンドウ管理メッセージです。  ウィンドウ プロシージャでメッセージを処理するか、システムにメッセージを渡して既定の処理を行うこともできます。  
+  
+ ビジュアル オブジェクトの親として定義した <xref:System.Windows.Interop.HwndSource> オブジェクトは、提供するウィンドウ メッセージのフィルター プロシージャを参照する必要があります。  <xref:System.Windows.Interop.HwndSource> オブジェクトを作成する場合は、<xref:System.Windows.Interop.HwndSourceParameters.HwndSourceHook%2A> プロパティがウィンドウ プロシージャを参照するように設定します。  
+  
+ [!code-csharp[VisualsHitTesting#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyWindow.cs#102)]
+ [!code-vb[VisualsHitTesting#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyWindow.vb#102)]  
+  
+ 次の例では、左右のマウス ボタンのメッセージを処理するコードを示します。  マウスのヒット位置の座標値は、`lParam`パラメーターの値に格納されます。  
+  
+ [!code-csharp[VisualsHitTesting#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyWindow.cs#103)]
+ [!code-vb[VisualsHitTesting#103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyWindow.vb#103)]  
+  
+<a name="processing_the_win32_messages"></a>   
+## Win32 メッセージの処理  
+ 次のコード例では、ホスト [!INCLUDE[TLA2#tla_win32](../../../../includes/tla2sharptla-win32-md.md)] ウィンドウに格納されたビジュアル オブジェクトの階層に対して、ヒット テストがどのように実行されるかを示します。  <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを使用することにより、ビジュアル オブジェクトのジオメトリ内にポイントがあるかどうかを識別して、ヒット テストを実行するルートのビジュアル オブジェクトと座標値を指定できます。  この場合、ルートのビジュアル オブジェクトは、<xref:System.Windows.Interop.HwndSource> オブジェクトの <xref:System.Windows.Interop.HwndSource.RootVisual%2A> プロパティの値です。  
+  
+ [!code-csharp[VisualsHitTesting#104](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsHitTesting/CSharp/MyCircle.cs#104)]
+ [!code-vb[VisualsHitTesting#104](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsHitTesting/VisualBasic/MyCircle.vb#104)]  
+  
+ ビジュアル オブジェクトに対するヒット テストの詳細については、「[ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Interop.HwndSource>   
+ [Win32 相互運用によるヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159995)   
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md b/docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md
new file mode 100644
index 00000000000..9b739d74392
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md
@@ -0,0 +1,95 @@
+---
+title: "DrawingVisual オブジェクトの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DrawingVisual オブジェクト (ビジュアル層の)"
+  - "ビジュアル層, DrawingVisual オブジェクト"
+ms.assetid: 0b4e711d-e640-40cb-81c3-8f5c59909b7d
+caps.latest.revision: 17
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# DrawingVisual オブジェクトの使用
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ビジュアル層で <xref:System.Windows.Media.DrawingVisual> オブジェクトを使用する方法の概要を説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+<a name="autoTopLevelSectionsOUTLINE0"></a>   
+-   [DrawingVisual オブジェクト](#drawing_visual_object)  
+  
+-   [DrawingVisual ホスト コンテナー](#drawingvisual_host_container)  
+  
+-   [DrawingVisual オブジェクトの作成](#creating_drawingvisual_objects)  
+  
+-   [FrameworkElement メンバーのオーバーライドの作成](#creating_overrides)  
+  
+-   [ヒット テストのサポート](#providing_hit_testing_support)  
+  
+-   [関連トピック](#seeAlsoToggle)  
+  
+<a name="drawingvisual_object"></a>   
+## DrawingVisual オブジェクト  
+ <xref:System.Windows.Media.DrawingVisual> は、図形、イメージ、またはテキストの描画に使用する軽量の描画クラスです。  このクラスが軽量と見なされる理由は、レイアウトやイベントの処理を行わないため、パフォーマンスが向上するからです。  このため、背景やクリップ アートの描画に適しています。  
+  
+<a name="drawingvisual_host_container"></a>   
+## DrawingVisual ホスト コンテナー  
+ <xref:System.Windows.Media.DrawingVisual> オブジェクトを使用するには、オブジェクトのホスト コンテナーを作成する必要があります。  ホスト コンテナー オブジェクトは、<xref:System.Windows.FrameworkElement> クラスから継承する必要があります。このクラスは、<xref:System.Windows.Media.DrawingVisual> クラスがサポートしていないレイアウトやイベント処理をサポートします。  ホスト コンテナー オブジェクトの主な目的は子オブジェクトを格納することなので、ホスト コンテナー オブジェクトには表示プロパティは表示されません。  ただし、ホスト コンテナーの <xref:System.Windows.UIElement.Visibility%2A> プロパティは、<xref:System.Windows.Visibility> に設定する必要があります。この値に設定しない場合、その子要素のいずれも表示されなくなります。  
+  
+ ビジュアル オブジェクトのホスト コンテナー オブジェクトを作成する場合は、<xref:System.Windows.Media.VisualCollection> にビジュアル オブジェクト参照を格納する必要があります。  <xref:System.Windows.Media.VisualCollection.Add%2A> メソッドを使用して、ビジュアル オブジェクトをホスト コンテナーに追加します。  次の例では、ホスト コンテナー オブジェクトを作成し、3 つのビジュアル オブジェクトをその <xref:System.Windows.Media.VisualCollection> に追加します。  
+  
+ [!code-csharp[DrawingVisualSample#100](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#100)]
+ [!code-vb[DrawingVisualSample#100](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#100)]  
+  
+> [!NOTE]
+>  前のコード例を含むコード サンプル全体については、[DrawingVisual を使用したヒット テストのサンプル](http://go.microsoft.com/fwlink/?LinkID=159994)を参照してください。  
+  
+<a name="creating_drawingvisual_objects"></a>   
+## DrawingVisual オブジェクトの作成  
+ <xref:System.Windows.Media.DrawingVisual> オブジェクトの作成時には、オブジェクトに描画内容は含まれていません。  テキスト、グラフィックス、またはイメージ コンテンツを追加するには、オブジェクトの <xref:System.Windows.Media.DrawingContext> を取得し、そのコンテキストに描画します。  <xref:System.Windows.Media.DrawingContext> は、<xref:System.Windows.Media.DrawingVisual> オブジェクトの <xref:System.Windows.Media.DrawingVisual.RenderOpen%2A> メソッドを呼び出すことによって返されます。  
+  
+ <xref:System.Windows.Media.DrawingContext> に四角形を描画するには、<xref:System.Windows.Media.DrawingContext> オブジェクトの <xref:System.Windows.Media.DrawingContext.DrawRectangle%2A> メソッドを使用します。  他の種類のコンテンツを描画するための同様のメソッドがあります。  <xref:System.Windows.Media.DrawingContext> へのコンテンツの描画が完了したら、<xref:System.Windows.Media.DrawingContext.Close%2A> メソッドを呼び出して <xref:System.Windows.Media.DrawingContext> を閉じ、コンテンツを保持します。  
+  
+ 次の例では、<xref:System.Windows.Media.DrawingVisual> オブジェクトを作成し、その <xref:System.Windows.Media.DrawingContext> に四角形を描画します。  
+  
+ [!code-csharp[DrawingVisualSample#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#101)]
+ [!code-vb[DrawingVisualSample#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#101)]  
+  
+<a name="creating_overrides"></a>   
+## FrameworkElement メンバーのオーバーライドの作成  
+ ホスト コンテナー オブジェクトは、ビジュアル オブジェクトのコレクションを管理します。  このため、ホスト コンテナーは派生 <xref:System.Windows.FrameworkElement> クラスのメンバー オーバーライドを実装する必要があります。  
+  
+ オーバーライドする必要がある 2 つのメンバーを次に示します。  
+  
+-   <xref:System.Windows.FrameworkElement.GetVisualChild%2A> : 子要素のコレクションから指定したインデックス位置にある子を返します。  
+  
+-   <xref:System.Windows.FrameworkElement.VisualChildrenCount%2A> : この要素内の子ビジュアル要素の数を取得します。  
+  
+ 次の例では、2 つの <xref:System.Windows.FrameworkElement> メンバーのオーバーライドを実装します。  
+  
+ [!code-csharp[DrawingVisualSample#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#102)]
+ [!code-vb[DrawingVisualSample#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#102)]  
+  
+<a name="providing_hit_testing_support"></a>   
+## ヒット テストのサポート  
+ ホスト コンテナー オブジェクトは、表示プロパティが表示されない場合でもイベント処理を提供できますが、その <xref:System.Windows.UIElement.Visibility%2A> プロパティは必ず <xref:System.Windows.Visibility> に設定する必要があります。  これにより、マウスの左ボタンが離されるなどのマウス イベントをトラップできる、ホスト コンテナーのイベント処理ルーチンを作成できます。  作成されたイベント処理ルーチンは、<xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを呼び出してヒット テストを実装できます。  このメソッドの <xref:System.Windows.Media.HitTestResultCallback> パラメーターは、ヒット テストの結果アクションを決定するために使用できるユーザー定義のプロシージャを参照します。  
+  
+ 次の例では、ホスト コンテナー オブジェクトとその子に対してヒット テストのサポートを実装します。  
+  
+ [!code-csharp[DrawingVisualSample#103](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#103)]
+ [!code-vb[DrawingVisualSample#103](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#103)]  
+  
+## 参照  
+ <xref:System.Windows.Media.DrawingVisual>   
+ <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/visual-layer-programming-how-to-topics.md b/docs/framework/wpf/graphics-multimedia/visual-layer-programming-how-to-topics.md
new file mode 100644
index 00000000000..7e9ccedc263
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/visual-layer-programming-how-to-topics.md
@@ -0,0 +1,41 @@
+---
+title: "ビジュアル層プログラミングに関する「方法」トピック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "描画のサポート (Visual オブジェクトによる)"
+  - "ビジュアル層"
+  - "ビジュアル オブジェクト"
+ms.assetid: ac550423-60a3-43e6-a0bc-d65ef026e0cb
+caps.latest.revision: 77
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# ビジュアル層プログラミングに関する「方法」トピック
+このセクションのトピックでは、ビジュアル層をヒット テストおよび低レベル構成に使用する方法について説明します。  
+  
+## このセクションの内容  
+ [ビジュアルのオフセットを取得する](../../../../docs/framework/wpf/graphics-multimedia/how-to-get-the-offset-of-a-visual.md)  
+ [ビジュアルの描画コンテンツを列挙する](../../../../docs/framework/wpf/graphics-multimedia/how-to-enumerate-drawing-content-of-a-visual.md)  
+ [ビジュアル内のジオメトリのヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-geometry-in-a-visual.md)  
+ [パラメーターとしてジオメトリを使用してヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-geometry-as-a-parameter.md)  
+ [Win32 ホスト コンテナーを使用してヒット テストを実行する](../../../../docs/framework/wpf/graphics-multimedia/how-to-hit-test-using-a-win32-host-container.md)  
+ [CompositionTarget を使用したフレームの間隔ごとの描画](../../../../docs/framework/wpf/graphics-multimedia/how-to-render-on-a-per-frame-interval-using-compositiontarget.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Visual>   
+ <xref:System.Windows.Media.VisualTreeHelper>   
+ <xref:System.Windows.Media.DrawingVisual>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/visual-layer-programming.md b/docs/framework/wpf/graphics-multimedia/visual-layer-programming.md
new file mode 100644
index 00000000000..fa05dfb9084
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/visual-layer-programming.md
@@ -0,0 +1,40 @@
+---
+title: "ビジュアル層のプログラミング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "グラフィックス [WPF], ビジュアル層"
+  - "描画のサポート (Visual オブジェクトによる)"
+  - "ビジュアル層"
+  - "ビジュアル オブジェクト"
+ms.assetid: d82c89db-077f-4c3c-a4f8-310ebfbe0fe2
+caps.latest.revision: 61
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 61
+---
+# ビジュアル層のプログラミング
+<xref:System.Windows.Media.Visual> オブジェクトは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の中心的なオブジェクトであり、その第一の役割は描画をサポートすることです。  <xref:System.Windows.Controls.Button> および <xref:System.Windows.Controls.TextBox> などのユーザー インターフェイス コントロールは、<xref:System.Windows.Media.Visual> クラスから派生し、このクラスを使用して描画データを保持します。  
+  
+## このセクションの内容  
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)  
+ [DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)  
+ [チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](../../../../docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md)  
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/visual-layer-programming-how-to-topics.md)  
+  
+## 参照  
+ <xref:System.Windows.Media.Visual>   
+ <xref:System.Windows.Media.VisualTreeHelper>   
+ <xref:System.Windows.Media.DrawingVisual>   
+ [WPF グラフィックス レンダリングの概要](../../../../docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md)   
+ [グラフィックスとマルチメディア](../../../../docs/framework/wpf/graphics-multimedia/index.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md b/docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md
new file mode 100644
index 00000000000..8a915c3209a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/wpf-brushes-overview.md
@@ -0,0 +1,177 @@
+---
+title: "WPF のブラシの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ブラシ, ブラシの概要"
+ms.assetid: ecea1955-420b-45c6-bf43-c1404c072c41
+caps.latest.revision: 12
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# WPF のブラシの概要
+スクリーン上に表示されるものはすべてブラシによって描画されているため、目で見ることができます。  たとえば、ブラシはボタンの背景、テキストの前景、および図形を塗りつぶすために使用されます。  ここでは、[!INCLUDE[TLA#tla_winclient](../../../../includes/tlasharptla-winclient-md.md)] のブラシを使用した塗りつぶしの概念について説明し、例を示します。  ブラシを使用すると、[!INCLUDE[TLA#tla_ui](../../../../includes/tlasharptla-ui-md.md)] オブジェクトに、純色やパターンとイメージの複雑なセットなどを適用できます。  
+  
+<a name="paintingwithbrush"></a>   
+## ブラシによる塗りつぶし  
+ <xref:System.Windows.Media.Brush> は、その出力で領域を塗りつぶします。  ブラシによって出力の種類がそれぞれ異なります。  純色で領域を塗りつぶすブラシもあれば、グラデーション、パターン、イメージ、または描画で塗りつぶすブラシもあります。  <xref:System.Windows.Media.Brush> のさまざまな種類の例を次の図に示します。  
+  
+ ![ブラシの種類](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brushtypes.png "graphicsmm\_brushtypes")  
+ブラシの例  
+  
+ ほとんどのビジュアル オブジェクトでは、その塗りつぶし方法を指定できます。  <xref:System.Windows.Media.Brush> を使用できる一般的なオブジェクトとプロパティの一部を次の表に示します。  
+  
+|Class|ブラシのプロパティ|  
+|-----------|---------------|  
+|<xref:System.Windows.Controls.Border>|<xref:System.Windows.Controls.Border.BorderBrush%2A>, <xref:System.Windows.Controls.Border.Background%2A>|  
+|<xref:System.Windows.Controls.Control>|<xref:System.Windows.Controls.Control.Background%2A>, <xref:System.Windows.Controls.Control.Foreground%2A>|  
+|<xref:System.Windows.Controls.Panel>|<xref:System.Windows.Controls.Panel.Background%2A>|  
+|<xref:System.Windows.Media.Pen>|<xref:System.Windows.Media.Pen.Brush%2A>|  
+|<xref:System.Windows.Shapes.Shape>|<xref:System.Windows.Shapes.Shape.Fill%2A>, <xref:System.Windows.Shapes.Shape.Stroke%2A>|  
+|<xref:System.Windows.Controls.TextBlock>|<xref:System.Windows.Controls.TextBlock.Background%2A>|  
+  
+ 以下のセクションでは、さまざまな種類の <xref:System.Windows.Media.Brush> について説明し、それぞれの例を示します。  
+  
+<a name="paintwithsolidcolorbrush"></a>   
+## 純色での塗りつぶし  
+ <xref:System.Windows.Media.SolidColorBrush> は、領域を均一の <xref:System.Windows.Media.Color> \(純色\) で塗りつぶします。  <xref:System.Windows.Media.SolidColorBrush> の <xref:System.Windows.Media.SolidColorBrush.Color%2A> を指定するにはさまざまな方法があります。たとえば、アルファ、赤、青、緑の各チャネルを指定したり、<xref:System.Windows.Media.Colors> クラスで提供されている定義済みの色のいずれかを使用したりできます。  
+  
+ <xref:System.Windows.Media.SolidColorBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![SolidColorBrush を使用して描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-solidcolorbrush.png "graphicsmm\_brush\_ovw\_solidcolorbrush")  
+SolidColorBrush を使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMSolidColorBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmsolidcolorbrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMSolidColorBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmsolidcolorbrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMSolidColorBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmsolidcolorbrushexampleinline)]  
+  
+ <xref:System.Windows.Media.SolidColorBrush> クラスの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  
+  
+<a name="paintwithlineargradientbrush"></a>   
+## 線形グラデーションでの塗りつぶし  
+ <xref:System.Windows.Media.LinearGradientBrush> は、線形グラデーションで領域を塗りつぶします。  線形グラデーションは、直線つまりグラデーション軸を境にして 2 つ以上の色をブレンドします。  グラデーション内の色とその位置を指定するには、<xref:System.Windows.Media.GradientStop> オブジェクトを使用します。  
+  
+ <xref:System.Windows.Media.LinearGradientBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![LinearGradientBrush を使用して描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-lineargradientbrush.png "graphicsmm\_brush\_ovw\_lineargradientbrush")  
+LinearGradientBrush を使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMLinearGradientBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmlineargradientbrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMLinearGradientBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmlineargradientbrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMLinearGradientBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmlineargradientbrushexampleinline)]  
+  
+ <xref:System.Windows.Media.LinearGradientBrush> クラスの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  
+  
+<a name="paintwithradialgradientbrush"></a>   
+## 放射状グラデーションでの塗りつぶし  
+ <xref:System.Windows.Media.RadialGradientBrush> は、放射状グラデーションで領域を塗りつぶします。  放射状グラデーションは、円を境にして 2 つ以上の色をブレンドします。  <xref:System.Windows.Media.LinearGradientBrush> クラスと同様、グラデーション内の色とその位置を指定するには、<xref:System.Windows.Media.GradientStop> オブジェクトを使用します。  
+  
+ <xref:System.Windows.Media.RadialGradientBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![RadialGradientBrush を使用して描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-radialgradientbrush.png "graphicsmm\_brush\_ovw\_radialgradientbrush")  
+RadialGradientBrush を使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMRadialGradientBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmradialgradientbrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMRadialGradientBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmradialgradientbrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMRadialGradientBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmradialgradientbrushexampleinline)]  
+  
+ <xref:System.Windows.Media.RadialGradientBrush> クラスの詳細については、「[純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)」を参照してください。  
+  
+<a name="paintwithimage"></a>   
+## イメージでの塗りつぶし  
+ <xref:System.Windows.Media.ImageBrush> は、<xref:System.Windows.Media.ImageSource> で領域を塗りつぶします。  
+  
+ <xref:System.Windows.Media.ImageBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![ImageBrush で描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-imagebrush.png "graphicsmm\_brush\_ovw\_imagebrush")  
+イメージを使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMImageBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmimagebrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMImageBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmimagebrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMImageBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmimagebrushexampleinline)]  
+  
+ <xref:System.Windows.Media.ImageBrush> クラスの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="paintwithdrawing"></a>   
+## 描画での塗りつぶし  
+ <xref:System.Windows.Media.DrawingBrush> は、<xref:System.Windows.Media.Drawing> で領域を塗りつぶします。  <xref:System.Windows.Media.Drawing> は、図形、イメージ、テキスト、および、メディアを含むことができます。  
+  
+ <xref:System.Windows.Media.DrawingBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![DrawingBrush を使用して描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-drawingbrush.png "graphicsmm\_brush\_ovw\_drawingbrush")  
+DrawingBrush を使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMDrawingBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmdrawingbrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMDrawingBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmdrawingbrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMDrawingBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmdrawingbrushexampleinline)]  
+  
+ <xref:System.Windows.Media.DrawingBrush> クラスの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="paintwithvisual"></a>   
+## ビジュアルでの塗りつぶし  
+ <xref:System.Windows.Media.VisualBrush> は、<xref:System.Windows.Media.Visual> オブジェクトで領域を塗りつぶします。  Visual オブジェクトの例としては、<xref:System.Windows.Controls.Button>、<xref:System.Windows.Controls.Page>、<xref:System.Windows.Controls.MediaElement> などがあります。  また、<xref:System.Windows.Media.VisualBrush> を使用すると、アプリケーションのある部分の内容を別の領域に投影することもできます。これは、反射効果を作成し、画面の一部を際立たせる場合に非常に役立ちます。  
+  
+ <xref:System.Windows.Media.VisualBrush> を使用して、<xref:System.Windows.Shapes.Rectangle> の <xref:System.Windows.Shapes.Shape.Fill%2A> を塗りつぶす例を次に示します。  塗りつぶされた四角形を次の図に示します。  
+  
+ ![VisualBrush を使用して描画された四角形](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-brush-ovw-visualbrush.png "graphicsmm\_brush\_ovw\_visualbrush")  
+VisualBrush を使用して塗りつぶされた四角形  
+  
+ [!code-csharp[BrushesIntroduction_snip#GraphicsMMVisualBrushExampleInline](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushesIntroduction_snip/CSharp/BrushTypesExample.cs#graphicsmmvisualbrushexampleinline)]
+ [!code-vb[BrushesIntroduction_snip#GraphicsMMVisualBrushExampleInline](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/BrushesIntroduction_snip/visualbasic/brushtypesexample.vb#graphicsmmvisualbrushexampleinline)]
+ [!code-xml[BrushesIntroduction_snip#GraphicsMMVisualBrushExampleInline](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushesIntroduction_snip/XAML/BrushTypesExample.xaml#graphicsmmvisualbrushexampleinline)]  
+  
+ <xref:System.Windows.Media.VisualBrush> クラスの詳細については、「[イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)」を参照してください。  
+  
+<a name="paintwithpredefinedbrushesandsystemcolors"></a>   
+## 定義済みブラシおよびシステム ブラシを使用した塗りつぶし  
+ 便宜上、[!INCLUDE[TLA#tla_wpf](../../../../includes/tlasharptla-wpf-md.md)] では、オブジェクトの塗りつぶしに使用できる定義済みブラシとシステム ブラシのセットが提供されています。  
+  
+-   使用可能な定義済みブラシの一覧については、<xref:System.Windows.Media.Brushes> クラスを参照してください。  定義済みブラシの使用方法の例については、「[純色で領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-solid-color.md)」を参照してください。  
+  
+-   使用可能なシステム ブラシの一覧については、<xref:System.Windows.SystemColors> クラスを参照してください。  例については、「[システム ブラシで領域を塗りつぶす](../../../../docs/framework/wpf/graphics-multimedia/how-to-paint-an-area-with-a-system-brush.md)」を参照してください。  
+  
+<a name="commonbrushfeatures"></a>   
+## ブラシの共通機能  
+ <xref:System.Windows.Media.Brush> オブジェクトが提供する <xref:System.Windows.Media.Brush.Opacity%2A> プロパティを使用すると、ブラシを透明にしたり、部分的に透明にしたりできます。  <xref:System.Windows.Media.Brush.Opacity%2A> の値を 0 にするとブラシは完全に透明になり、<xref:System.Windows.Media.Brush.Opacity%2A> の値を 1 にするとブラシは完全に不透明になります。  <xref:System.Windows.Media.Brush.Opacity%2A> プロパティを使用して、<xref:System.Windows.Media.SolidColorBrush> の不透明度を 25% にする例を次に示します。  
+  
+ [!code-xml[BrushOverviewExamples_snip#OpacityExample1XAML](../../../../samples/snippets/xaml/VS_Snippets_Wpf/BrushOverviewExamples_snip/XAML/OpacityExample.xaml#opacityexample1xaml)]  
+  
+ [!code-csharp[BrushOverviewExamples_snip#OpacityExample1CSharp](../../../../samples/snippets/csharp/VS_Snippets_Wpf/BrushOverviewExamples_snip/CSharp/OpacityExample.cs#opacityexample1csharp)]  
+  
+ ブラシに部分的に透明な色が含まれる場合は、ブラシの不透明度の値との乗算により、色の不透明度の値が結合されます。  たとえば、ブラシの不透明度の値が 0.5 で、ブラシで使用されている色の不透明度値も 0.5 である場合は、出力される色の不透明度は 0.25 になります。  
+  
+> [!NOTE]
+>  <xref:System.Windows.UIElement.Opacity%2A?displayProperty=fullName> プロパティを使用して要素全体の不透明度を変更するより、ブラシの不透明度の値を変更する方が効率的です。  
+  
+ <xref:System.Windows.Media.Brush.Transform%2A> プロパティまたは <xref:System.Windows.Media.Brush.RelativeTransform%2A> プロパティを使用すると、ブラシのコンテンツの回転、拡大縮小、傾斜、および平行移動を行うことができます。  詳細については、「[ブラシの変換の概要](../../../../docs/framework/wpf/graphics-multimedia/brush-transformation-overview.md)」を参照してください。  
+  
+ これらは <xref:System.Windows.Media.Animation.Animatable> オブジェクトであるため、<xref:System.Windows.Media.Brush> オブジェクトはアニメーション化できます。  詳細については、「[アニメーションの概要](../../../../docs/framework/wpf/graphics-multimedia/animation-overview.md)」を参照してください。  
+  
+<a name="freezable_features"></a>   
+### Freezable の機能  
+ <xref:System.Windows.Freezable> クラスを継承するので、<xref:System.Windows.Media.Brush> クラスはいくつかの特殊な機能を備えています。<xref:System.Windows.Media.Brush> オブジェクトを[リソース](../../../../docs/framework/wpf/advanced/xaml-resources.md)として宣言したり、複数のオブジェクトで共有したり、複製したりできます。  さらに、<xref:System.Windows.Media.VisualBrush> を除くすべての種類の <xref:System.Windows.Media.Brush> は、読み取り専用にして、パフォーマンスを向上させ、スレッド セーフにすることができます。  
+  
+ <xref:System.Windows.Freezable> のさまざまな機能の詳細については、「[Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.VisualBrush> オブジェクトを固定できない理由の詳細については、<xref:System.Windows.Media.VisualBrush> のページを参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Media.Brush>   
+ <xref:System.Windows.Media.Brushes>   
+ [純色およびグラデーションによる塗りつぶしの概要](../../../../docs/framework/wpf/graphics-multimedia/painting-with-solid-colors-and-gradients-overview.md)   
+ [イメージ、描画、およびビジュアルによる塗りつぶし](../../../../docs/framework/wpf/graphics-multimedia/painting-with-images-drawings-and-visuals.md)   
+ [Freezable オブジェクトの概要](../../../../docs/framework/wpf/advanced/freezable-objects-overview.md)   
+ [ブラシのサンプル](http://go.microsoft.com/fwlink/?LinkID=159973)   
+ [ImageBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160005)   
+ [VisualBrush のサンプル](http://go.microsoft.com/fwlink/?LinkID=160049)   
+ [方法のトピック](../../../../docs/framework/wpf/graphics-multimedia/brushes-how-to-topics.md)   
+ [パフォーマンスに関するその他の推奨事項](../../../../docs/framework/wpf/advanced/optimizing-performance-other-recommendations.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md b/docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md
new file mode 100644
index 00000000000..33a661f7f5a
--- /dev/null
+++ b/docs/framework/wpf/graphics-multimedia/wpf-graphics-rendering-overview.md
@@ -0,0 +1,273 @@
+---
+title: "WPF グラフィックス レンダリングの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グラフィックス, 描画"
+  - "描画 (グラフィックスを)"
+ms.assetid: 6dec9657-4d8c-4e46-8c54-40fb80008265
+caps.latest.revision: 51
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 48
+---
+# WPF グラフィックス レンダリングの概要
+ここでは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のビジュアル層の概要について説明します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] モデルのレンダリング サポートに関する <xref:System.Windows.Media.Visual> クラスの役割に重点を置いて説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="role_of_visual_object"></a>   
+## ビジュアル オブジェクトの役割  
+ <xref:System.Windows.Media.Visual> クラスは、すべての <xref:System.Windows.FrameworkElement> オブジェクトの派生元となる基本抽象クラスです。  また、このクラスは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で新しいコントロールを作成するためのエントリ ポイントとしても機能し、多くの点で Win32 アプリケーション モデルのウィンドウ ハンドル \(HWND\) と考えることができます。  
+  
+ <xref:System.Windows.Media.Visual> オブジェクトは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の中心的なオブジェクトであり、その第一の役割は描画をサポートすることです。  <xref:System.Windows.Controls.Button> および <xref:System.Windows.Controls.TextBox> などのユーザー インターフェイス コントロールは、<xref:System.Windows.Media.Visual> クラスから派生し、このクラスを使用して描画データを保持します。  <xref:System.Windows.Media.Visual> オブジェクトは、以下をサポートしています。  
+  
+-   出力表示 : ビジュアルのシリアル化された永続的な描画内容を表示します。  
+  
+-   変換 : ビジュアルで変換を実行します。  
+  
+-   クリッピング : ビジュアルのクリッピング領域をサポートします。  
+  
+-   ヒット テスト : 座標またはジオメトリがビジュアルの境界内に含まれているかどうかを判断します。  
+  
+-   境界ボックスの計算 : ビジュアルの外接する四角形を決定します。  
+  
+ ただし、<xref:System.Windows.Media.Visual> オブジェクトでは、次のような描画以外の機能はサポートしていません。  
+  
+-   イベント処理  
+  
+-   \[レイアウト\]  
+  
+-   スタイル  
+  
+-   データ バインディング  
+  
+-   グローバリゼーション  
+  
+ <xref:System.Windows.Media.Visual> は、パブリック抽象クラスとして公開され、子クラスはこのクラスから派生する必要があります。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] で公開されるビジュアル オブジェクトの階層構造を次の図に示します。  
+  
+ ![Visual オブジェクトから派生したクラスのダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visualclass01.png "VisualClass01")  
+Visual クラスの階層構造  
+  
+### DrawingVisual クラス  
+ <xref:System.Windows.Media.DrawingVisual> は、図形、イメージ、またはテキストの描画に使用する軽量の描画クラスです。  このクラスが軽量と見なされる理由は、レイアウトやイベントの処理を実現しないため、実行時のパフォーマンスが向上するからです。  このため、背景やクリップ アートの描画に適しています。  <xref:System.Windows.Media.DrawingVisual> を使用すると、カスタム ビジュアル オブジェクトを作成できます。  詳細については、「[DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)」を参照してください。  
+  
+### Viewport3DVisual クラス  
+ <xref:System.Windows.Media.Media3D.Viewport3DVisual> は、2D <xref:System.Windows.Media.Visual> と <xref:System.Windows.Media.Media3D.Visual3D> オブジェクト間のブリッジを提供します。  <xref:System.Windows.Media.Media3D.Visual3D> クラスは、すべての 3D ビジュアル要素の基本クラスです。  <xref:System.Windows.Media.Media3D.Viewport3DVisual> では、<xref:System.Windows.Media.Media3D.Viewport3DVisual.Camera%2A> 値と <xref:System.Windows.Media.Media3D.Viewport3DVisual.Viewport%2A> 値を定義する必要があります。  カメラを使用するとシーンを表示できます。  ビューポートは、投影が 2D サーフェイス上にマップされる場所を設定します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の 3D の詳細については、「[3\-D グラフィックスの概要](../../../../docs/framework/wpf/graphics-multimedia/3-d-graphics-overview.md)」を参照してください。  
+  
+### ContainerVisual クラス  
+ <xref:System.Windows.Media.ContainerVisual> クラスは、<xref:System.Windows.Media.Visual> オブジェクトのコレクションのコンテナーとして使用されます。  <xref:System.Windows.Media.DrawingVisual> クラスは、<xref:System.Windows.Media.ContainerVisual> クラスから派生するため、ビジュアル オブジェクトのコレクションを格納できます。  
+  
+### ビジュアル オブジェクトの描画コンテンツ  
+ <xref:System.Windows.Media.Visual> オブジェクトは、レンダリング データをベクター グラフィックス命令リストとして格納します。  命令リスト内の各項目は、シリアル化された形式のグラフィックス データおよび関連リソースの低レベル セットを表します。  描画コンテンツを格納可能なレンダリング データには次の 4 種類があります。  
+  
+|描画コンテンツの種類|Description|  
+|----------------|-----------------|  
+|ベクター グラフィックス|ベクター グラフィックス データと、関連する <xref:System.Windows.Media.Brush> および <xref:System.Windows.Media.Pen> の情報を表します。|  
+|Image|<xref:System.Windows.Rect> で定義されている領域内のイメージを表します。|  
+|グリフ|指定したフォント リソースからの一連のグリフである <xref:System.Windows.Media.GlyphRun> をレンダリングする描画を表します。  これはテキストの表示方法です。|  
+|モニター|ビデオをレンダリングする描画を表します。|  
+  
+ <xref:System.Windows.Media.DrawingContext> を使用すると、<xref:System.Windows.Media.Visual> にビジュアル コンテンツを読み込むことができます。  <xref:System.Windows.Media.DrawingContext> オブジェクトの描画コマンドを使用すると、リアルタイムで画面に描画するのではなく、実際にはグラフィックス システムで今後使用する一連のレンダリング データが格納されます。  
+  
+ <xref:System.Windows.Controls.Button> などの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールを作成した場合、そのコントロールは、それ自身を描画するためのレンダリング データを暗黙的に生成します。  たとえば、<xref:System.Windows.Controls.Button> の <xref:System.Windows.Controls.ContentControl.Content%2A> プロパティを設定すると、グリフのレンダリング表現がコントロールに格納されます。  
+  
+ <xref:System.Windows.Media.Visual> のコンテンツは、<xref:System.Windows.Media.DrawingGroup> 内の 1 つ以上の <xref:System.Windows.Media.Drawing> オブジェクトとして表されます。  <xref:System.Windows.Media.DrawingGroup> は、コンテンツに適用される不透明マスク、変換、ビットマップ効果などの操作も表します。  コンテンツがレンダリングされるときには、<xref:System.Windows.Media.DrawingGroup.OpacityMask%2A>、<xref:System.Windows.Media.DrawingGroup.Opacity%2A>、<xref:System.Windows.Media.DrawingGroup.BitmapEffect%2A>、<xref:System.Windows.Media.DrawingGroup.ClipGeometry%2A>、<xref:System.Windows.Media.DrawingGroup.GuidelineSet%2A>、そして <xref:System.Windows.Media.DrawingGroup.Transform%2A> の順に <xref:System.Windows.Media.DrawingGroup> 操作が適用されます。  
+  
+ レンダリング シーケンス中に <xref:System.Windows.Media.DrawingGroup> 操作が適用される順序を次の図に示します。  
+  
+ ![操作の DrawingGroup 順序](../../../../docs/framework/wpf/graphics-multimedia/media/graphcismm-drawinggroup-order.png "graphcismm\_drawinggroup\_order")  
+DrawingGroup 操作の順序  
+  
+ 詳細については、「[Drawing オブジェクトの概要](../../../../docs/framework/wpf/graphics-multimedia/drawing-objects-overview.md)」を参照してください。  
+  
+#### ビジュアル層での描画コンテンツ  
+ <xref:System.Windows.Media.DrawingContext> を直接インスタンス化することはできませんが、<xref:System.Windows.Media.DrawingGroup.Open%2A?displayProperty=fullName> や <xref:System.Windows.Media.DrawingVisual.RenderOpen%2A?displayProperty=fullName> などの一部のメソッドから描画コンテキストを取得できます。  <xref:System.Windows.Media.DrawingVisual> から <xref:System.Windows.Media.DrawingContext> を取得して四角形の描画に使用する例を次に示します。  
+  
+ [!code-csharp[drawingvisualsample#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingVisualSample/CSharp/Window1.xaml.cs#101)]
+ [!code-vb[drawingvisualsample#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/DrawingVisualSample/visualbasic/window1.xaml.vb#101)]  
+  
+#### ビジュアル層で描画コンテンツを列挙する  
+ <xref:System.Windows.Media.Drawing> オブジェクトは、他の用途に加えて、<xref:System.Windows.Media.Visual> のコンテンツを列挙するためのオブジェクト モデルも提供します。  
+  
+> [!NOTE]
+>  ビジュアルのコンテンツの列挙の際には、ベクター グラフィックス命令リストとして基になるレンダリング データ表現を取得しているのではなく、<xref:System.Windows.Media.Drawing> オブジェクトを取得しています。  
+  
+ <xref:System.Windows.Media.VisualTreeHelper.GetDrawing%2A> メソッドを使用して、<xref:System.Windows.Media.Visual> の <xref:System.Windows.Media.DrawingGroup> 値を取得し列挙する例を次に示します。  
+  
+ [!code-csharp[DrawingMiscSnippets_snip#GraphicsMMRetrieveDrawings](../../../../samples/snippets/csharp/VS_Snippets_Wpf/DrawingMiscSnippets_snip/CSharp/EnumerateDrawingsExample.xaml.cs#graphicsmmretrievedrawings)]  
+  
+<a name="how_visual_objects_are_used_to_build_controls"></a>   
+## ビジュアル オブジェクトを使用してコントロールをビルドする方法  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のオブジェクトの多くは、他のビジュアル オブジェクトで構成されています。これは、子孫オブジェクトのさまざまな階層をこれらのオブジェクトに格納できることを意味します。  [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のユーザー インターフェイス要素 \(コントロールなど\) の多くは、さまざまな種類のレンダリング要素を表す複数のビジュアル オブジェクトで構成されています。  たとえば、<xref:System.Windows.Controls.Button> コントロールは、<xref:Microsoft.Windows.Themes.ClassicBorderDecorator>、<xref:System.Windows.Controls.ContentPresenter>、<xref:System.Windows.Controls.TextBlock> など他の多数のオブジェクトを格納できます。  
+  
+ 次のコードは、マークアップで定義されている <xref:System.Windows.Controls.Button> コントロールを示しています。  
+  
+ [!code-xml[VisualsOverview#VisualsOverviewSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml#visualsoverviewsnippet1)]  
+  
+ 既定の <xref:System.Windows.Controls.Button> コントロールを構成するビジュアル オブジェクトを列挙すると、次の図に示すビジュアル オブジェクトの階層がわかります。  
+  
+ ![ビジュアル ツリー階層のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview03.png "VisualLayerOverview03")  
+ビジュアル ツリー階層の図  
+  
+ <xref:System.Windows.Controls.Button> コントロールには <xref:Microsoft.Windows.Themes.ClassicBorderDecorator> 要素が含まれており、さらにこの要素には <xref:System.Windows.Controls.ContentPresenter> 要素が含まれています。  <xref:Microsoft.Windows.Themes.ClassicBorderDecorator> 要素は、<xref:System.Windows.Controls.Button> の境界線と背景を描画します。  <xref:System.Windows.Controls.ContentPresenter> 要素は、<xref:System.Windows.Controls.Button> の内容を表示します。  この場合、テキストを表示しているため、<xref:System.Windows.Controls.ContentPresenter> 要素には <xref:System.Windows.Controls.TextBlock> 要素が格納されています。  <xref:System.Windows.Controls.Button> コントロールは <xref:System.Windows.Controls.ContentPresenter> を使用します。これは、<xref:System.Windows.Controls.Image> やジオメトリ \(<xref:System.Windows.Media.EllipseGeometry> など\) など他の要素でコンテンツを表現できるということを意味します。  
+  
+### コントロール テンプレート  
+ コントロールをコントロールの階層に拡張する場合、<xref:System.Windows.Controls.ControlTemplate> が重要になります。  コントロール テンプレートは、コントロールの既定のビジュアル階層を指定します。  コントロールを明示的に参照すると、コントロールのビジュアル階層が暗黙的に参照されます。  コントロール テンプレートの既定値をオーバーライドして、コントロールの外観をカスタマイズできます。  たとえば、<xref:System.Windows.Controls.Button> コントロールの背景色の値を変更して、純色値の代わりに線形グラデーション値を使用することができます。  詳細については、「[ボタンのスタイルとテンプレート](../../../../docs/framework/wpf/controls/button-styles-and-templates.md)」を参照してください。  
+  
+ <xref:System.Windows.Controls.Button> コントロールなどのユーザー インターフェイス要素には、コントロールのすべてのレンダリング定義を表す複数のベクター グラフィックス命令リストが含まれています。  次のコードは、マークアップで定義されている <xref:System.Windows.Controls.Button> コントロールを示しています。  
+  
+ [!code-xml[VisualsOverview#VisualsOverviewSnippet2](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml#visualsoverviewsnippet2)]  
+  
+ <xref:System.Windows.Controls.Button> コントロールを構成するビジュアル オブジェクトとベクター グラフィックス命令リストを列挙すると、次の図に示すビジュアル オブジェクトの階層がわかります。  
+  
+ ![ビジュアル ツリーおよび描画データのダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview04.png "VisualLayerOverview04")  
+ビジュアル ツリーおよびレンダリング データの図  
+  
+ <xref:System.Windows.Controls.Button> コントロールには <xref:Microsoft.Windows.Themes.ClassicBorderDecorator> 要素が含まれており、さらにこの要素には <xref:System.Windows.Controls.ContentPresenter> 要素が含まれています。  <xref:Microsoft.Windows.Themes.ClassicBorderDecorator> 要素は、ボタンの境界線と背景を構成する個々のグラフィックス要素をすべて描画します。  <xref:System.Windows.Controls.ContentPresenter> 要素は、<xref:System.Windows.Controls.Button> の内容を表示します。  この場合、イメージを表示しているため、<xref:System.Windows.Controls.ContentPresenter> 要素には <xref:System.Windows.Controls.Image> 要素が格納されています。  
+  
+ ビジュアル オブジェクトとベクター グラフィックス命令リストの階層については、次の点に注意する必要があります。  
+  
+-   階層内の順序は、描画情報のレンダリング順序を表します。  子要素は、ルート ビジュアル要素を起点として、左から右、上から下に走査されます。  要素が子ビジュアル要素を持つ場合、子ビジュアル要素は要素の兄弟の前に走査されます。  
+  
+-   階層内の非リーフ要素 \(<xref:System.Windows.Controls.ContentPresenter> など\) は子要素の格納に使用されます。これらの要素には、命令リストは格納されません。  
+  
+-   ベクター グラフィックス命令リストとビジュアル子の両方がビジュアル要素に含まれている場合、ビジュアル子オブジェクトが描画される前に、親ビジュアル要素の命令リストがレンダリングされます。  
+  
+-   ベクター グラフィックス命令リスト内の項目は、左から右の順にレンダリングされます。  
+  
+<a name="visual_tree"></a>   
+## ビジュアル ツリー  
+ ビジュアル ツリーには、アプリケーションのユーザー インターフェイスで使用するすべてのビジュアル要素が含まれます。  ビジュアル要素には永続化された描画情報が含まれているため、ビジュアル ツリーは、ディスプレイ デバイスへの出力を構成するのに必要なレンダリング情報をすべて含むシーン グラフであると考えることができます。  このツリーは、コードかマークアップかを問わず、アプリケーションで直接作成されたすべてのビジュアル要素を累積したものです。  ビジュアル ツリーには、コントロールやデータ オブジェクトなどの要素のテンプレート拡張によって作成されたビジュアル要素もすべて含まれます。  
+  
+ マークアップで定義された <xref:System.Windows.Controls.StackPanel> 要素を次のコードに示します。  
+  
+ [!code-xml[VisualsOverview#VisualsOverviewSnippet3](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml#visualsoverviewsnippet3)]  
+  
+ マークアップ例の <xref:System.Windows.Controls.StackPanel> 要素を構成するビジュアル オブジェクトを列挙すると、次の図に示すビジュアル オブジェクトの階層がわかります。  
+  
+ ![ビジュアル ツリー階層のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview05.png "VisualLayerOverview05")  
+ビジュアル ツリー階層の図  
+  
+### レンダリング順序  
+ ビジュアル ツリーは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のビジュアル オブジェクトと描画オブジェクトの表示順序を決定します。  検査の順序は、ビジュアル ツリーの最上位ノードであるルート ビジュアルで始まります。  次に、ルート ビジュアルの子が左から右に走査されます。  ビジュアルが子を持つ場合、子はビジュアルの兄弟の前に走査されます。  つまり、子ビジュアルの内容は、そのビジュアル自体の内容の前に表示されます。  
+  
+ ![ビジュアル ツリー描画順序のダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview06.png "VisualLayerOverview06")  
+ビジュアル ツリー レンダリング順序の図  
+  
+### ルート ビジュアル  
+ ルート ビジュアルは、ビジュアル ツリー階層内の最上位の要素です。  ほとんどのアプリケーションでは、ルート ビジュアルの基本クラスは <xref:System.Windows.Window> または <xref:System.Windows.Navigation.NavigationWindow> のいずれかです。  ただし、ビジュアル オブジェクトを Win32 アプリケーションでホストする場合は、Win32 ウィンドウにホストする最上位のビジュアルがルート ビジュアルになります。  詳細については、「[チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](../../../../docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md)」を参照してください。  
+  
+### 論理ツリーとの関係  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] の論理ツリーは、実行時のアプリケーションの要素を表します。  このツリーを直接操作することはありませんが、アプリケーションのこのビューは、プロパティの継承やイベントのルーティングを理解する上で役立ちます。  ビジュアル ツリーとは異なり、論理ツリーは、<xref:System.Windows.Documents.ListItem> などのビジュアル データ オブジェクト以外のオブジェクトを表すことができます。  多くの場合、論理ツリーはアプリケーションのマークアップ定義にほぼ一致します。  マークアップで定義された <xref:System.Windows.Controls.DockPanel> 要素を次のコードに示します。  
+  
+ [!code-xml[VisualsOverview#VisualsOverviewSnippet5](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml#visualsoverviewsnippet5)]  
+  
+ マークアップ例の <xref:System.Windows.Controls.DockPanel> 要素を構成する論理オブジェクトを列挙すると、次の図に示す論理オブジェクトの階層がわかります。  
+  
+ ![ツリー ダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/tree1-wcp.png "Tree1\_wcp")  
+論理ツリーの図  
+  
+ ビジュアル ツリーおよび論理ツリーは、現在のアプリケーション要素のセットと同期し、要素の追加、削除、または変更をすべて反映します。  ただし、ツリーにはアプリケーションの異なるビューが表示されます。  ビジュアル ツリーとは異なり、論理ツリーでは、コントロールの <xref:System.Windows.Controls.ContentPresenter> が展開されません。  これは、論理ツリーとビジュアルツリーが同一のオブジェクト セットに対して 1 対 1 で直接対応しないということを意味します。  実際、同一の要素をパラメーターとして使用して、**LogicalTreeHelper** オブジェクトの <xref:System.Windows.LogicalTreeHelper.GetChildren%2A> メソッドと **VisualTreeHelper** オブジェクトの <xref:System.Windows.Media.VisualTreeHelper.GetChild%2A> メソッドを呼び出すと、異なる結果が返されます。  
+  
+ 論理ツリーの詳細については、「[WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)」を参照してください。  
+  
+### XamlPad を使用したビジュアル ツリーの表示  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] ツールである XamlPad は、現在定義されている[!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] コンテンツに対応するビジュアル ツリーを表示および探索するためのオプションを提供します。  ビジュアル ツリーを表示するには、メニュー バーの \[Show Visual Tree\] ボタンをクリックします。  XamlPad の \[Visual Tree Explorer\] パネルのビジュアル ツリー ノードに展開された [!INCLUDE[TLA#tla_titlexaml](../../../../includes/tlasharptla-titlexaml-md.md)] コンテンツを次の図に示します。  
+  
+ ![XamlPad のビジュアル ツリー エクスプローラー パネル](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview08.png "VisualLayerOverview08")  
+XamlPad の Visual Tree Explorer パネル  
+  
+ XamlPad の \[Visual Tree Explorer\] パネルでは、<xref:System.Windows.Controls.Label>、<xref:System.Windows.Controls.TextBox>、および <xref:System.Windows.Controls.Button> の各コントロールが別々のビジュアル オブジェクト階層を表示していることに注意してください。  これは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] コントロールにそのコントロールのビジュアル ツリーを含む <xref:System.Windows.Controls.ControlTemplate> があるためです。  コントロールを明示的に参照すると、コントロールのビジュアル階層が暗黙的に参照されます。  
+  
+### ビジュアル パフォーマンスのプロファイリング  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] は、アプリケーションの実行時の動作を分析したり、適用可能なパフォーマンス最適化の種類を決定できるパフォーマンス プロファイリング ツール スイートを提供します。  ビジュアル プロファイラー ツール スイートでは、アプリケーションのビジュアル ツリーに直接マップすることにより、パフォーマンス データを多彩なグラフィカル ビューで示します。  このスクリーンショットでは、ビジュアル プロファイラーの **\[CPU 使用率\]** セクションに、レンダリングやレイアウトなど、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] サービスのオブジェクトの使用率の詳細が示されています。  
+  
+ ![Visual Profiler 表示出力](../../../../docs/framework/wpf/graphics-multimedia/media/wpfperf-visualprofiler-04.png "WPFPerf\_VisualProfiler\_04")  
+ビジュアル プロファイラー表示出力  
+  
+<a name="visual_rendering_behavior"></a>   
+## ビジュアル レンダリング動作  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、保持モード グラフィックス、ベクター グラフィックス、デバイスに依存しないグラフィックスといった、ビジュアル オブジェクトのレンダリング動作に影響を及ぼす機能が導入されています。  
+  
+### 保持モード グラフィックス  
+ ビジュアル オブジェクトの役割を理解するためには、即時モードのグラフィックス システムと保持モードのグラフィックス システムの違いについて理解することが重要です。  GDI または GDI\+ に基づく標準的な Win32 アプリケーションでは、即時モードのグラフィックス システムが使用されます。  これは、ウィンドウのサイズ変更やオブジェクトの外観の変更などのアクションによって無効化されたクライアント領域の部分を、アプリケーションが再描画するということを意味します。  
+  
+ ![Win32 レンダリング シーケンスのダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview01.png "VisualLayerOverview01")  
+Win32 レンダリング シーケンスの図  
+  
+ 一方、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、保持モード システムが使用されます。  これは、外観を持つアプリケーション オブジェクトがシリアル化された一連の描画データを定義するということを意味します。  描画データが定義された後は、アプリケーション オブジェクトをレンダリングするために、システムがすべての再描画要求に応答します。  実行時であっても、アプリケーション オブジェクトを変更または作成し、描画要求に対する応答を引き続きシステムに任せることができます。  保持モードのグラフィックス システムでは、アプリケーションによって描画情報が常にシリアル化された状態に保たれます。ただし、レンダリングはシステムによって実行されます。これは保持モードのグラフィックス システムの長所です。  次の図は、アプリケーションが描画要求への応答で [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] に依存しているしくみを示しています。  
+  
+ ![WPF レンダリング シーケンスのダイアグラム](../../../../docs/framework/wpf/graphics-multimedia/media/visuallayeroverview02.png "VisualLayerOverview02")  
+WPF レンダリング シーケンスの図  
+  
+#### 高度な再描画  
+ 保持モード グラフィックスを使用することの最も大きな利点の 1 つは、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] がアプリケーション内の再描画を必要とする項目を効率的に最適化できることです。  さまざまな不透明度を持つ複雑なシーンがある場合でも、特別な目的を持つコードを記述して再描画を最適化する必要は通常ありません。  これと Win32 プログラミングを比較してください。Win32 プログラミングでは、更新領域での再描画量を最小化してアプリケーションを最適化するのに多大な労力を費やすことがあります。  Win32 アプリケーションでの再描画の最適化に関連する複雑さの例については、「[Redrawing in the Update Region](_win32_Redrawing_in_the_Update_Region)」を参照してください。  
+  
+### ベクター グラフィックス  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ベクター グラフィックスがレンダリング データ形式として使用されます。  スケーラブル ベクター グラフィックス \(SVG\)、Windows メタファイル \(.wmf\)、TrueType フォントなどのベクター グラフィックスは、レンダリング データを格納し、グラフィックス プリミティブを使用してイメージを再作成する方法を表す命令リストとして送信します。  たとえば、TrueType フォントは、ピクセル配列ではなく、直線、曲線、およびコマンドのセットを表すアウトライン フォントです。  ベクター グラフィックスの主な利点の 1 つは、任意のサイズおよび解像度にスケーリングできることです。  
+  
+ ベクター グラフィックスとは異なり、ビットマップ グラフィックスは、特定の解像度で事前にレンダリングされたピクセル単位のイメージ表現としてレンダリング データを格納します。  ビットマップ グラフィックス形式とベクター グラフィックス形式の主な違いの 1 つは、元のソース イメージへの忠実性です。  たとえば、ソース イメージのサイズを変更した場合、ビットマップ グラフィックス システムではイメージが伸縮されます。一方、ベクター グラフィックス システムでは、イメージがスケーリングされるため、イメージの忠実性が保持されます。  
+  
+ 3 倍に拡大されたソース イメージを次の図に示します。  ソース イメージをビットマップ グラフィックス イメージとして伸縮した場合、イメージにゆがみが生じることに注意してください。ベクター グラフィックス イメージとしてスケーリングした場合、こうしたゆがみは生じません。  
+  
+ ![ラスター グラフィックスとベクター グラフィックスの違い](../../../../docs/framework/wpf/graphics-multimedia/media/vectorgraphics01.png "VectorGraphics01")  
+ラスター グラフィックスとベクター グラフィックスの違い  
+  
+ 次のマークアップでは、2 つの <xref:System.Windows.Shapes.Path> 要素を定義しています。  2 番目の要素では、<xref:System.Windows.Media.ScaleTransform> を使用して、最初の要素の描画命令を 3 倍に拡大しています。  <xref:System.Windows.Shapes.Path> 要素の描画命令は変更されないことに注意してください。  
+  
+ [!code-xml[VectorGraphicsSnippets#VectorGraphicsSnippet1](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VectorGraphicsSnippets/CS/PageOne.xaml#vectorgraphicssnippet1)]  
+  
+### 解像度およびデバイスに依存しないグラフィックスについて  
+ 画面上のテキストとグラフィックスのサイズを決定するシステム要素には、解像度と DPI の 2 つがあります。  解像度は、画面に表示されるピクセルの数を表します。  解像度が高くなるとピクセルが小さくなり、グラフィックスとテキストがより滑らかに表示されます。  解像度が 1024 x 768 に設定されたモニターに表示されるグラフィックスは、解像度を 1600 x 1200 に変更すると、一段と小さく表示されます。  
+  
+ もう 1 つのシステム設定である DPI は、画面上の 1 インチのサイズをピクセル単位で表したものです。  ほとんどの [!INCLUDE[TLA#tla_mswin](../../../../includes/tlasharptla-mswin-md.md)] システムは 96 DPI であり、これは、画面上の 1 インチが 96 ピクセルであることを意味します。  DPI の設定を上げると、画面上の 1 インチが長くなり、設定を下げると、画面上の 1 インチが短くなります。  このため、画面上の 1 インチと実際の 1 インチは同じサイズでなく、ほとんどのシステムで異なる可能性があります。  DPI を大きくすると、画面上の 1 インチのサイズが大きくなるため、DPI 対応のグラフィックスとテキストは大きくなります。  DPI を大きくすると、特に高解像度の場合にはテキストが読みやすくなります。  
+  
+ すべてのアプリケーションが DPI に対応しているわけではありません。一部のアプリケーションでは、主要な測定単位としてハードウェア ピクセルが使用されているため、システム DPI を変更しても影響がありません。  また、フォント サイズを表す場合は DPI 対応の単位を使用しても、それ以外にはすべてピクセルを使用するアプリケーションも数多くあります。  これらのアプリケーションで DPI を過度に小さくしたり、大きくしたりすると、アプリケーションのテキストがシステムの DPI 設定に従ってスケーリングされても、アプリケーションの UI はスケーリングされないため、レイアウトの問題が発生する可能性があります。  この問題は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] を使用して開発されたアプリケーションでは発生しません。  
+  
+ [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] では、ハードウェア ピクセルの代わりにデバイス非依存ピクセルを主要測定単位として用いた自動拡大縮小機能がサポートされています。つまり、アプリケーション開発者が手を加えなくても、グラフィックスとテキストが適切に拡大縮小されます。  次の図は [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] のテキストとグラフィックスが DPI が異なる場合にどのように表示されるかを示したものです。  
+  
+ ![異なる DPI 設定のグラフィックスとテキスト](../../../../docs/framework/wpf/graphics-multimedia/media/graphicsmm-dpi-setting-examples.png "graphicsmm\_dpi\_setting\_examples")  
+さまざまな DPI 設定のグラフィックとテキスト  
+  
+<a name="visualtreehelper_class"></a>   
+## VisualTreeHelper クラス  
+ <xref:System.Windows.Media.VisualTreeHelper> クラスは、ビジュアル オブジェクト レベルでの低レベルのプログラミング機能を提供する静的なヘルパー クラスです。このプログラミング機能は、高性能のカスタム コントロールの開発など、非常に限定されたシナリオで役立ちます。  ほとんどの場合、より高レベルの [!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)]フレームワーク \(<xref:System.Windows.Controls.Canvas> や <xref:System.Windows.Controls.TextBlock> など\) を使用することで、柔軟性と使いやすさが向上します。  
+  
+### ヒット テスト  
+ <xref:System.Windows.Media.VisualTreeHelper> クラスは、ビジュアル オブジェクトに対するヒット テストのためのメソッドを提供します。既定のヒット テスト サポートが要件を満たさない場合は、これらのメソッドを使用できます。  <xref:System.Windows.Media.VisualTreeHelper> クラスの <xref:System.Windows.Media.VisualTreeHelper.HitTest%2A> メソッドを使用すると、ジオメトリまたはポイントの座標値が特定のオブジェクト \(コントロールやグラフィック要素など\) の境界内にあるかどうかを確認できます。  たとえば、ヒット テストを使用することで、オブジェクトの外接する四角形内でのマウス クリックが円のジオメトリ内にあるかどうかを確認できます。また、ヒット テストの既定の実装をオーバーライドして、独自のカスタム ヒット テスト計算を実行することもできます。  
+  
+ ヒット テストの詳細については、「[ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)」参照してください。  
+  
+### ビジュアル ツリーを列挙する  
+ <xref:System.Windows.Media.VisualTreeHelper> クラスは、ビジュアル ツリーのメンバーを列挙するための機能を提供します。  親を取得するには、<xref:System.Windows.Media.VisualTreeHelper.GetParent%2A> メソッドを呼び出します。  ビジュアル オブジェクトの子または直接の子孫を取得するには、<xref:System.Windows.Media.VisualTreeHelper.GetChild%2A> メソッドを呼び出します。  このメソッドは、指定したインデックス位置にある親の子 <xref:System.Windows.Media.Visual> を返します。  
+  
+ ビジュアル オブジェクトのすべての子孫を列挙する方法を次の例に示します。これは、ビジュアル オブジェクト階層のすべての描画情報のシリアル化が必要である場合に使用できる手法です。  
+  
+ [!code-csharp[VisualsOverview#101](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml.cs#101)]
+ [!code-vb[VisualsOverview#101](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsOverview/visualbasic/window1.xaml.vb#101)]  
+  
+ ほとんどの場合、[!INCLUDE[TLA2#tla_winclient](../../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの要素を表すときには論理ツリーの方が役立ちます。  論理ツリーを直接変更することはありませんが、アプリケーションのこのビューは、プロパティの継承やイベントのルーティングを理解する上で役立ちます。  ビジュアル ツリーとは異なり、論理ツリーは、<xref:System.Windows.Documents.ListItem> などのビジュアル データ オブジェクト以外のオブジェクトを表すことができます。  論理ツリーの詳細については、「[WPF のツリー](../../../../docs/framework/wpf/advanced/trees-in-wpf.md)」を参照してください。  
+  
+ <xref:System.Windows.Media.VisualTreeHelper> クラスは、ビジュアル オブジェクトの外接する四角形を返すメソッドを提供します。  <xref:System.Windows.Media.VisualTreeHelper.GetContentBounds%2A> を呼び出すと、ビジュアル オブジェクトの外接する四角形が返されます。  <xref:System.Windows.Media.VisualTreeHelper.GetDescendantBounds%2A> を呼び出すと、ビジュアル オブジェクトのすべての子孫 \(ビジュアル オブジェクト自体も含む\) の外接する四角形が返されます。  ビジュアル オブジェクトとそのすべての子孫の外接する四角形を計算する方法を次のコード例に示します。  
+  
+ [!code-csharp[VisualsOverview#102](../../../../samples/snippets/csharp/VS_Snippets_Wpf/VisualsOverview/CSharp/Window1.xaml.cs#102)]
+ [!code-vb[VisualsOverview#102](../../../../samples/snippets/visualbasic/VS_Snippets_Wpf/VisualsOverview/visualbasic/window1.xaml.vb#102)]  
+  
+## 参照  
+ <xref:System.Windows.Media.Visual>   
+ <xref:System.Windows.Media.VisualTreeHelper>   
+ <xref:System.Windows.Media.DrawingVisual>   
+ [2D グラフィックスとイメージング](../../../../docs/framework/wpf/advanced/optimizing-performance-2d-graphics-and-imaging.md)   
+ [ビジュアル層でのヒット テスト](../../../../docs/framework/wpf/graphics-multimedia/hit-testing-in-the-visual-layer.md)   
+ [DrawingVisual オブジェクトの使用](../../../../docs/framework/wpf/graphics-multimedia/using-drawingvisual-objects.md)   
+ [チュートリアル : Win32 アプリケーションでのビジュアル オブジェクトのホスト](../../../../docs/framework/wpf/graphics-multimedia/tutorial-hosting-visual-objects-in-a-win32-application.md)   
+ [WPF アプリケーションのパフォーマンスの最適化](../../../../docs/framework/wpf/advanced/optimizing-wpf-application-performance.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/index.md b/docs/framework/wpf/index.md
new file mode 100644
index 00000000000..1e8220c02de
--- /dev/null
+++ b/docs/framework/wpf/index.md
@@ -0,0 +1,40 @@
+---
+title: "Windows Presentation Foundation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+applies_to: 
+  - "Windows 10"
+  - "Windows 7"
+  - "Windows 7 with SP1"
+  - "Windows 8"
+  - "Windows 8 Pro"
+  - "Windows 8.1"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "Windows Presentation Foundation"
+  - "WPF"
+ms.assetid: f667bd15-2134-41e9-b4af-5ced6fafab5d
+caps.latest.revision: 97
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 94
+---
+# Windows Presentation Foundation
+Visual Studio 2015 の Windows Presentation Foundation \(WPF\) は、Windows 上の最新の基幹業務デスクトップ アプリケーションを構築するための統一されたプログラミング モデルを開発者に提供します。  
+  
+ [Windows Presentation Foundation での最新のデスクトップ アプリケーションの作成](../Topic/Create%20Modern%20Desktop%20Applications%20with%20Windows%20Presentation%20Foundation.md)  
+  
+ [Designing XAML in Visual Studio and Blend for Visual Studio](../Topic/Designing%20XAML%20in%20Visual%20Studio.md)  
+  
+ [.NET Framework での WPF](https://msdn.microsoft.com/en-us/library/ms754130\(v=vs.100\).aspx)  
+  
+ [Visual Studio の入手](https://www.visualstudio.com/features/wpf-vs)
\ No newline at end of file
diff --git a/docs/framework/wpf/media/caspermissionsets.png b/docs/framework/wpf/media/caspermissionsets.png
new file mode 100644
index 00000000000..7e8eb7cecee
Binary files /dev/null and b/docs/framework/wpf/media/caspermissionsets.png differ
diff --git a/docs/framework/wpf/media/safetoplevelnavigationfigure.png b/docs/framework/wpf/media/safetoplevelnavigationfigure.png
new file mode 100644
index 00000000000..a435693524e
Binary files /dev/null and b/docs/framework/wpf/media/safetoplevelnavigationfigure.png differ
diff --git a/docs/framework/wpf/media/windowplatformsecurity.PNG b/docs/framework/wpf/media/windowplatformsecurity.PNG
new file mode 100644
index 00000000000..16f8889ae2f
Binary files /dev/null and b/docs/framework/wpf/media/windowplatformsecurity.PNG differ
diff --git a/docs/framework/wpf/media/wpfsecurityfigure1.PNG b/docs/framework/wpf/media/wpfsecurityfigure1.PNG
new file mode 100644
index 00000000000..db1ac69a8fd
Binary files /dev/null and b/docs/framework/wpf/media/wpfsecurityfigure1.PNG differ
diff --git a/docs/framework/wpf/security-wpf.md b/docs/framework/wpf/security-wpf.md
new file mode 100644
index 00000000000..5b845a4da6a
--- /dev/null
+++ b/docs/framework/wpf/security-wpf.md
@@ -0,0 +1,288 @@
+---
+title: "セキュリティ (WPF) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション セキュリティ [WPF]"
+  - "ブラウザーによってホストされるアプリケーションのセキュリティ [WPF]"
+  - "機能コントロール [WPF], セキュリティ"
+  - "Internet Explorer のセキュリティ設定 [WPF]"
+  - "Loose XAML ファイル [WPF], サンドボックスの動作"
+  - "ナビゲーションのセキュリティ [WPF]"
+  - "WebBrowser コントロール [WPF], セキュリティ"
+  - "WPF のセキュリティ"
+  - "XAML ファイル [WPF], サンドボックスの動作"
+  - "XBAP のセキュリティ [WPF]"
+ms.assetid: ee1baea0-3611-4e36-9ad6-fcd5205376fb
+caps.latest.revision: 38
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# セキュリティ (WPF)
+<a name="introduction"></a> [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] のスタンドアロン アプリケーションおよびブラウザー ホスト アプリケーションを開発する場合は、セキュリティ モデルを考慮する必要があります。[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] スタンドアロン アプリケーションは、Windows インストーラー \(.msi\)、XCopy、または [!INCLUDE[TLA2#tla_clickonce](../../../includes/tla2sharptla-clickonce-md.md)] のいずれで配置されても、無制限のアクセス許可 \([!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] **FullTrust** アクセス許可セット\) で実行されます。  部分信頼を配置した場合は、ClickOnce を使用したスタンドアロン WPF アプリケーションはサポートされません。  ただし、完全信頼ホスト アプリケーションは、.NET Framework アドイン モデルを使用して部分信頼 <xref:System.AppDomain> を作成できます。  詳細については、「[WPF アドインの概要](../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] ブラウザー ホスト アプリケーションは、[!INCLUDE[TLA#tla_iegeneric](../../../includes/tlasharptla-iegeneric-md.md)] または Firefox によってホストされ、[!INCLUDE[TLA#tla_xbap#plural](../../../includes/tlasharptla-xbapsharpplural-md.md)] にすることも、Loose [!INCLUDE[TLA#tla_xaml](../../../includes/tlasharptla-xaml-md.md)] ドキュメントにすることもできます。詳細については、「[WPF XAML ブラウザー アプリケーションの概要](../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] ブラウザー ホスト アプリケーションは、既定では部分信頼セキュリティ サンドボックス内で実行され、既定の [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] インターネット ゾーン アクセス許可セットに制限されます。  これにより、一般的な Web アプリケーションが分離されるのと同じ方法で、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] ブラウザー ホスト アプリケーションがクライアント コンピューターから効果的に分離されます。  配置 URL のセキュリティ ゾーンおよびクライアントのセキュリティ構成に応じて、XBAP は特権を完全信頼まで昇格させることができます。  詳細については、「[WPF 部分信頼セキュリティ](../../../docs/framework/wpf/wpf-partial-trust-security.md)」を参照してください。  
+  
+ ここでは、[!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] のスタンドアロン アプリケーションとブラウザー ホストアプリケーションのセキュリティ モデルについて説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [安全なナビゲーション](#SafeTopLevelNavigation)  
+  
+-   [Web ブラウザーのセキュリティ設定](#InternetExplorerSecuritySettings)  
+  
+-   [WebBrowser コントロールと機能コントロール](#webbrowser_control_and_feature_controls)  
+  
+-   [部分信頼クライアント アプリケーションに対する APTCA アセンブリの無効化](#APTCA)  
+  
+-   [Loose XAML ファイルに対するサンドボックスの動作](#LooseContentSandboxing)  
+  
+-   [セキュリティを向上する WPF アプリケーションを開発するためのリソース](#BestPractices)  
+  
+<a name="SafeTopLevelNavigation"></a>   
+## 安全なナビゲーション  
+ [!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] の場合、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] はアプリケーションとブラウザーという 2 種類のナビゲーションを区別します。  
+  
+ アプリケーション ナビゲーションは、ブラウザーによってホストされるアプリケーション内のコンテンツの項目間のナビゲーションです。  ブラウザー ナビゲーションは、ブラウザー自体のコンテンツと場所の URL を変更するナビゲーションです。  アプリケーション ナビゲーション \(通常は XAML\) とブラウザー ナビゲーション \(通常は HTML\) の関係を次の図に示します。  
+  
+ ![ナビゲーションのダイアグラム](../../../docs/framework/wpf/media/safetoplevelnavigationfigure.png "SafeTopLevelNavigationFigure")  
+  
+ [!INCLUDE[TLA2#tla_xbap](../../../includes/tla2sharptla-xbap-md.md)] の移動先として安全と見なされるコンテンツの種類は、主に、使用されるアプリケーション ナビゲーションとブラウザー ナビゲーションによって決まります。  
+  
+<a name="Application_Navigation_Security"></a>   
+### アプリケーション ナビゲーションのセキュリティ  
+ アプリケーション ナビゲーションが安全と見なされるのは、それが、次の 4 種類のコンテンツをサポートするパック [!INCLUDE[TLA2#tla_uri](../../../includes/tla2sharptla-uri-md.md)] で識別できる場合です。  
+  
+|コンテンツ タイプ|Description|URI の例|  
+|---------------|-----------------|------------|  
+|リソース|ビルドの種類が **Resource** のプロジェクトに追加されるファイル。|`pack://application:,,,/MyResourceFile.xaml`|  
+|Content|ビルドの種類が **Content** のプロジェクトに追加されるファイル。|`pack://application:,,,/MyContentFile.xaml`|  
+|起点サイト|ビルドの種類が **None** のプロジェクトに追加されるファイル。|`pack://siteoforigin:,,,/MySiteOfOriginFile.xaml`|  
+|アプリケーション コード|コンパイルされた分離コードを含む XAML リソース、<br /><br /> または<br /><br /> ビルドの種類が **Page** のプロジェクトに追加される XAML ファイル。|`pack://application:,,,/MyResourceFile` `.xaml`|  
+  
+> [!NOTE]
+>  アプリケーション データ ファイルとパック [!INCLUDE[TLA2#tla_uri#plural](../../../includes/tla2sharptla-urisharpplural-md.md)] の詳細については、「[WPF アプリケーションのリソース ファイル、コンテンツ ファイル、およびデータ ファイル](../../../docs/framework/wpf/app-development/wpf-application-resource-content-and-data-files.md)」を参照してください。  
+  
+ これらのコンテンツ タイプのファイルには、ユーザーまたはプログラムによって移動できます。  
+  
+-   **ユーザー ナビゲーション**。  ユーザーは <xref:System.Windows.Documents.Hyperlink> 要素をクリックして移動します。  
+  
+-   **プログラム ナビゲーション**。  アプリケーションは、<xref:System.Windows.Navigation.NavigationWindow.Source%2A?displayProperty=fullName> プロパティを設定するなど、ユーザーとは無関係に移動します。  
+  
+<a name="Browser_Navigation_Security"></a>   
+### ブラウザー ナビゲーションのセキュリティ  
+ ブラウザー ナビゲーションは、次の条件の下でのみ安全と見なされます。  
+  
+-   **ユーザー ナビゲーション**。  ユーザーは、入れ子になった <xref:System.Windows.Controls.Frame> 内ではなく、メインの <xref:System.Windows.Navigation.NavigationWindow> 内にある <xref:System.Windows.Documents.Hyperlink> 要素をクリックすることで移動する。  
+  
+-   **ゾーン**。  移動先のコンテンツが、インターネットまたはローカル イントラネット上に存在する。  
+  
+-   **プロトコル**。  使用されるプロトコルは、**http**、**https**、**file**、または **mailto**。  
+  
+ これらの条件に適合しない方法で [!INCLUDE[TLA2#tla_xbap](../../../includes/tla2sharptla-xbap-md.md)] がコンテンツに移動しようとすると、<xref:System.Security.SecurityException> がスローされます。  
+  
+<a name="InternetExplorerSecuritySettings"></a>   
+## Web ブラウザーのセキュリティ設定  
+ コンピューターのセキュリティ設定により、Web ブラウザーに付与されるアクセス権が決まります。  Web ブラウザーには、Internet Explorer や PresentationHost.exe など、[WinINet](http://go.microsoft.com/fwlink/?LinkId=179379) API または [UrlMon](http://go.microsoft.com/fwlink/?LinkId=179383) API を使用するアプリケーションやコンポーネントがあります。  
+  
+ [!INCLUDE[TLA2#tla_iegeneric](../../../includes/tla2sharptla-iegeneric-md.md)] は、[!INCLUDE[TLA2#tla_iegeneric](../../../includes/tla2sharptla-iegeneric-md.md)] での実行が可能な機能を構成できる機構を備えています。これらの機能には、次のものがあります。  
+  
+-   [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] 依存コンポーネント  
+  
+-   ActiveX コントロールおよびプラグイン  
+  
+-   ダウンロード  
+  
+-   スクリプト  
+  
+-   ユーザー認証  
+  
+ このような方法でセキュリティ保護できる機能のコレクションは、**インターネット**、**イントラネット**、**信頼済みサイト**、および**制限付きサイト**の各ゾーンのゾーン単位で構成されます。  次の手順では、セキュリティ設定を構成する方法について説明します。  
+  
+1.  **コントロール パネル**を開きます。  
+  
+2.  **\[ネットワークとインターネット\]** をクリックし、**\[インターネット オプション\]** をクリックします。  
+  
+     \[インターネット オプション\] ダイアログ ボックスが表示されます。  
+  
+3.  **\[セキュリティ\]** タブで、セキュリティ設定を構成するゾーンを選択します。  
+  
+4.  **\[レベルのカスタマイズ\]** をクリックします。  
+  
+     **\[セキュリティの設定\]** ダイアログ ボックスが表示されるので、選択したゾーンのセキュリティ設定を構成します。  
+  
+     ![&#91;セキュリティ設定&#93; ダイアログ ボックス](../../../docs/framework/wpf/media/wpfsecurityfigure1.PNG "WPFSecurityFigure1")  
+  
+> [!NOTE]
+>  \[インターネット オプション\] ダイアログ ボックスは、Internet Explorer から開くこともできます。  **\[ツール\]** をクリックし、**\[インターネット オプション\]** をクリックします。  
+  
+ [!INCLUDE[TLA#tla_ie7](../../../includes/tlasharptla-ie7-md.md)] 以降では、特に [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] を対象にした次のセキュリティ設定があります。  
+  
+-   **Loose XAML**。  [!INCLUDE[TLA2#tla_iegeneric](../../../includes/tla2sharptla-iegeneric-md.md)] が Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルに移動できるかどうかを制御します  \(\[有効\]、\[無効\]、および \[ダイアログを表示する\] オプション\)。  
+  
+-   **XAML ブラウザー アプリケーション**。  [!INCLUDE[TLA2#tla_iegeneric](../../../includes/tla2sharptla-iegeneric-md.md)] が [!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] に移動して実行できるかどうかを制御します   \(\[有効\]、\[無効\]、および \[ダイアログを表示する\] オプション\)。  
+  
+ 既定では、これらの設定は **\[インターネット\]**、**\[イントラネット\]**、および **\[信頼済みサイト\]** の各ゾーンではすべて有効になり、**\[制限付きサイト\]** ゾーンでは無効になります。  
+  
+<a name="Security_Settings_for_IE6_and_Below"></a>   
+### セキュリティ関連の WPF レジストリの設定  
+ \[インターネット オプション\] から使用できるセキュリティ設定以外に、セキュリティ上重要なさまざまな WPF 機能を選択的にブロックするために次のレジストリ値を使用できます。  値は次のキーで定義されます。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\Windows Presentation Foundation\Features`  
+  
+ 設定可能な値を次の表に示します。  
+  
+|値名|値型|値のデータ|  
+|--------|--------|-----------|  
+|XBAPDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|LooseXamlDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|WebBrowserDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|MediaAudioDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|MediaImageDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|MediaVideoDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+|ScriptInteropDisallow|REG\_DWORD|許可しない場合は 1、許可する場合は 0。|  
+  
+<a name="webbrowser_control_and_feature_controls"></a>   
+## WebBrowser コントロールと機能コントロール  
+ WPF <xref:System.Windows.Controls.WebBrowser> コントロールを使用すると、Web コンテンツをホストできます。  WPF <xref:System.Windows.Controls.WebBrowser> コントロールは、基になる WebBrowser ActiveX コントロールをラップします。  WPF では、WPF <xref:System.Windows.Controls.WebBrowser> コントロールを使用して信頼されていない Web コンテンツをホストするときに、アプリケーションの保護を一部サポートします。  ただし、一部のセキュリティ機能は、<xref:System.Windows.Controls.WebBrowser> コントロールを使用してアプリケーションによって直接適用する必要があります。  WebBrowser ActiveX コントロールの詳細については、「[WebBrowser Control Overviews and Tutorials \(WebBrowser コントロールの概要とチュートリアル\)](http://go.microsoft.com/fwlink/?LinkId=179388)」を参照してください。  
+  
+> [!NOTE]
+>  このセクションの内容は、<xref:System.Windows.Controls.Frame> コントロールにも当てはまります。このコントロールは、<xref:System.Windows.Controls.WebBrowser> を使用して HTML コンテンツに移動するためです。  
+  
+ WPF <xref:System.Windows.Controls.WebBrowser> コントロールを使用して信頼されていない Web コンテンツをホストする場合、アプリケーションでは、部分信頼 <xref:System.AppDomain> を使用して、悪意のある HTML スクリプト コードからアプリケーション コードを分離する必要があります。  これは、特に、アプリケーションが <xref:System.Windows.Controls.WebBrowser.InvokeScript%2A> メソッドと <xref:System.Windows.Controls.WebBrowser.ObjectForScripting%2A> プロパティを使用してホストされたスクリプトと対話している場合に当てはまります。  詳細については、「[WPF アドインの概要](../../../docs/framework/wpf/app-development/wpf-add-ins-overview.md)」を参照してください。  
+  
+ アプリケーションで WPF <xref:System.Windows.Controls.WebBrowser> コントロールを使用する場合は、セキュリティを強化して攻撃を軽減するもう 1 つの方法として、Internet Explorer 機能コントロールを有効にする方法があります。  機能コントロールは Internet Explorer の追加機能で、これにより、管理者および開発者は、WebBrowser ActiveX コントロールをホストする Internet Explorer およびアプリケーションの機能を構成できます。WebBrowser ActiveX コントロールは、WPF <xref:System.Windows.Controls.WebBrowser> コントロールによってラップされます。  機能コントロールを構成するには、[CoInternetSetFeatureEnabled](http://go.microsoft.com/fwlink/?LinkId=179394) 関数を使用するか、レジストリの値を変更します。  機能コントロールの詳細については、「[Introduction to Feature Controls \(機能コントロールの概要\)](http://go.microsoft.com/fwlink/?LinkID=179390)」および「[Internet Feature Controls \(インターネット機能コントロール\)](http://go.microsoft.com/fwlink/?LinkID=179392)」を参照してください。  
+  
+ WPF <xref:System.Windows.Controls.WebBrowser> コントロールを使用するスタンドアロン WPF アプリケーションを開発している場合は、アプリケーションに対して次の機能コントロールが自動的に有効になります。  
+  
+|機能コントロール|  
+|--------------|  
+|FEATURE\_MIME\_HANDLING|  
+|FEATURE\_MIME\_SNIFFING|  
+|FEATURE\_OBJECT\_CACHING|  
+|FEATURE\_SAFE\_BINDTOOBJECT|  
+|FEATURE\_WINDOW\_RESTRICTIONS|  
+|FEATURE\_ZONE\_ELEVATION|  
+|FEATURE\_RESTRICT\_FILEDOWNLOAD|  
+|FEATURE\_RESTRICT\_ACTIVEXINSTALL|  
+|FEATURE\_ADDON\_MANAGEMENT|  
+|FEATURE\_HTTP\_USERNAME\_PASSWORD\_DISABLE|  
+|FEATURE\_SECURITYBAND|  
+|FEATURE\_UNC\_SAVEDFILECHECK|  
+|FEATURE\_VALIDATE\_NAVIGATE\_URL|  
+|FEATURE\_DISABLE\_TELNET\_PROTOCOL|  
+|FEATURE\_WEBOC\_POPUPMANAGEMENT|  
+|FEATURE\_DISABLE\_LEGACY\_COMPRESSION|  
+|FEATURE\_SSLUX|  
+  
+ これらの機能コントロールは無条件で有効になるため、完全信頼アプリケーションに悪影響が及ぶ場合があります。  この場合、特定のアプリケーションとそのアプリケーションがホストしているコンテンツに対するセキュリティ上のリスクがなければ、対応する機能コントロールを無効にできます。  
+  
+ 機能コントロールは、WebBrowser ActiveX オブジェクトをインスタンス化するプロセスによって適用されます。  そのため、信頼されていないコンテンツに移動できるスタンドアロン アプリケーションを作成する場合は、その他の機能コントロールを有効にすることを検討する必要があります。  
+  
+> [!NOTE]
+>  この推奨事項は、MSHTML および SHDOCVW ホスト セキュリティの一般的な推奨事項に基づいています。  詳細については、「[The MSHTML Host Security FAQ: Part I of II \(MSHTML ホスト セキュリティに関する FAQ: 第 I 部\)](http://go.microsoft.com/fwlink/?LinkId=179396)」および「[The MSHTML Host Security FAQ: Part II of II \(MSHTML ホスト セキュリティに関する FAQ: 第 II 部\)](http://go.microsoft.com/fwlink/?LinkId=179415)」を参照してください。  
+  
+ 実行可能ファイルでは、レジストリ値を 1 に設定することで、次の機能コントロールを有効にすることを検討してください。  
+  
+|機能コントロール|  
+|--------------|  
+|FEATURE\_ACTIVEX\_REPURPOSEDETECTION|  
+|FEATURE\_BLOCK\_LMZ\_IMG|  
+|FEATURE\_BLOCK\_LMZ\_OBJECT|  
+|FEATURE\_BLOCK\_LMZ\_SCRIPT|  
+|FEATURE\_RESTRICT\_RES\_TO\_LMZ|  
+|FEATURE\_RESTRICT\_ABOUT\_PROTOCOL\_IE7|  
+|FEATURE\_SHOW\_APP\_PROTOCOL\_WARN\_DIALOG|  
+|FEATURE\_LOCALMACHINE\_LOCKDOWN|  
+|FEATURE\_FORCE\_ADDR\_AND\_STATUS|  
+|FEATURE\_RESTRICTED\_ZONE\_WHEN\_FILE\_NOT\_FOUND|  
+  
+ 実行可能ファイルでは、レジストリ値を 0 に設定することで、次の機能コントロールを無効にすることを検討してください。  
+  
+|機能コントロール|  
+|--------------|  
+|FEATURE\_ENABLE\_SCRIPT\_PASTE\_URLACTION\_IF\_PROMPT|  
+  
+ WPF <xref:System.Windows.Controls.WebBrowser> コントロールを含む部分信頼 [!INCLUDE[TLA#tla_xbap](../../../includes/tlasharptla-xbap-md.md)] を [!INCLUDE[TLA#tla_iegeneric](../../../includes/tlasharptla-iegeneric-md.md)] で実行する場合、WPF は、Internet Explorer プロセスのアドレス空間で WebBrowser ActiveX コントロールをホストします。  WebBrowser ActiveX コントロールは [!INCLUDE[TLA2#tla_iegeneric](../../../includes/tla2sharptla-iegeneric-md.md)] プロセスでホストされるため、Internet Explorer のすべての機能コントロールは、WebBrowser ActiveX コントロールに対しても有効になります。  
+  
+ Internet Explorer で実行されている XBAP にも、標準のスタンドアロン アプリケーションよりも高いレベルのセキュリティが適用されます。  このセキュリティの強化の理由は、[!INCLUDE[TLA#tla_winvista](../../../includes/tlasharptla-winvista-md.md)] および [!INCLUDE[win7](../../../includes/win7-md.md)] では、既定で、Internet Explorer \(および WebBrowser ActiveX コントロール\) が保護モードで実行されるためです。  保護モードの詳細については、「[保護モードの Internet Explorer の理解と機能](http://go.microsoft.com/fwlink/?LinkId=179393)」を参照してください。  
+  
+> [!NOTE]
+>  WPF <xref:System.Windows.Controls.WebBrowser> コントロールを含む XBAP を Firefox で実行しようとすると、インターネット ゾーン内に存在するため、<xref:System.Security.SecurityException> がスローされます。  これは、WPF セキュリティ ポリシーが原因です。  
+  
+<a name="APTCA"></a>   
+## 部分信頼クライアント アプリケーションに対する APTCA アセンブリの無効化  
+ マネージ アセンブリを [!INCLUDE[TLA#tla_gac](../../../includes/tlasharptla-gac-md.md)] にインストールした場合、ユーザーは、インストールの際に明示的なアクセス許可を提供する必要があるので、これらは完全信頼になります。  完全信頼であるため、これらのアセンブリは完全信頼マネージ クライアント アプリケーションのみが使用できます。  それらを部分信頼アプリケーションで使用できるようにする場合は、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> \(APTCA\) という属性を設定する必要があります。  この属性は、部分信頼で実行しても安全であることがテストで確認されたアセンブリだけに設定する必要があります。  
+  
+ ただし、APTCA アセンブリは、[!INCLUDE[TLA2#tla_gac](../../../includes/tla2sharptla-gac-md.md)] にインストールされた後にセキュリティの欠陥を露呈する可能性があります。  セキュリティの欠陥が発見された場合、アセンブリの発行者は、既存のインストールでの問題を解決し、問題の発見後に配置される可能性のあるインストールに備えるためのセキュリティ更新プログラムを作成できます。  更新プログラムの 1 つのオプションは、アセンブリをアンインストールすることですが、アンインストールにより、このアセンブリを使用する完全信頼クライアント アプリケーションが破損するおそれがあります。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、APTCA アセンブリをアンインストールせずに、部分信頼 [!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] アプリケーションに対して APTCA アセンブリを無効にできる機構を備えています。  
+  
+ APTCA アセンブリを無効にするには、特別なレジストリ キーを作成する必要があります。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\policy\APTCA\<AssemblyFullName>, FileVersion=<AssemblyFileVersion>`  
+  
+ 例を次に示します。  
+  
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\policy\APTCA\aptcagac, Version=1.0.0.0, Culture=neutral, PublicKeyToken=215e3ac809a0fea7, FileVersion=1.0.0.0`  
+  
+ このキーにより、APTCA アセンブリのエントリが設定されます。  また、アセンブリを有効または無効にする値をこのキーに作成する必要があります。  値の詳細を次に示します。  
+  
+-   値の名前 : **APTCA\_FLAG**。  
+  
+-   値の型 : **REG\_DWORD**。  
+  
+-   値のデータ : 無効にする場合は **1**、有効にする場合は **0**。  
+  
+ 部分信頼クライアント アプリケーションに対してアセンブリを無効にする必要がある場合は、レジストリ キーおよび値を作成する更新プログラムを作成できます。  
+  
+> [!NOTE]
+>  コア [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] アセンブリは、マネージ アプリケーションを実行するために必要であるため、この方法で無効にしても影響を受けません。  APTCA アセンブリの無効化のサポートは、主に、サードパーティ アプリケーションを対象にしたものです。  
+  
+<a name="LooseContentSandboxing"></a>   
+## Loose XAML ファイルに対するサンドボックスの動作  
+ Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルは、分離コード、イベント ハンドラー、またはアプリケーション固有のアセンブリに依存しない、マークアップのみの XAML ファイルです。  ブラウザーから Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルに直接移動するときは、既定のインターネット ゾーン アクセス許可セットに基づいてファイルがセキュリティ サンドボックスに読み込まれます。  
+  
+ 一方、スタンドアロン アプリケーションの <xref:System.Windows.Navigation.NavigationWindow> または <xref:System.Windows.Controls.Frame> から Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルに移動した場合は、セキュリティ動作が異なります。  
+  
+ どちらの場合も、移動先の Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルは、ホスト アプリケーションのアクセス許可を継承します。  ただし、この動作はセキュリティの観点からは望ましくない場合があります。特に、Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルが信頼されていないエンティティまたは不明エンティティによって生成された場合には問題があります。  この種のコンテンツは外部コンテンツと呼ばれ、外部コンテンツにナビゲートされたときに外部コンテンツを分離するように <xref:System.Windows.Controls.Frame> と <xref:System.Windows.Navigation.NavigationWindow> を構成できます。  分離するには、次の <xref:System.Windows.Controls.Frame> と <xref:System.Windows.Navigation.NavigationWindow> の例に示されているように、**SandboxExternalContent** プロパティを true に設定します。  
+  
+ [!code-xml[SecurityOverviewSnippets#FrameMARKUP](../../../samples/snippets/csharp/VS_Snippets_Wpf/SecurityOverviewSnippets/CS/Window2.xaml#framemarkup)]  
+  
+ [!code-xml[SecurityOverviewSnippets#NavigationWindowMARKUP](../../../samples/snippets/csharp/VS_Snippets_Wpf/SecurityOverviewSnippets/CS/Window1.xaml#navigationwindowmarkup)]  
+  
+ このように設定すると、外部コンテンツは、アプリケーションをホストするプロセスとは異なるプロセスに読み込まれます。  このプロセスは既定のインターネット ゾーン アクセス許可セットに限定されており、ホスト アプリケーションとクライアント コンピューターから外部コンテンツを効果的に分離します。  
+  
+> [!NOTE]
+>  スタンドアロン アプリケーションの <xref:System.Windows.Navigation.NavigationWindow> または <xref:System.Windows.Controls.Frame> から Loose [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルへの移動を、WPF のブラウザーのホスト処理インフラストラクチャ \(PresentationHost プロセスを含む\) に基づいて実装しても、[!INCLUDE[wiprlhext](../../../includes/wiprlhext-md.md)] および [!INCLUDE[win7](../../../includes/win7-md.md)] 上の Internet Explorer でコンテンツを直接読み込む場合 \(この場合も PresentationHost を使用\) よりもセキュリティ レベルは若干低くなります。これは、Web ブラウザーを使用しているスタンドアロン WPF アプリケーションに、Internet Explorer の保護モード セキュリティ機能が追加されていないためです。  
+  
+<a name="BestPractices"></a>   
+## セキュリティを向上する WPF アプリケーションを開発するためのリソース  
+ セキュリティを向上する [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションの開発に役立つその他のリソースを次に示します。  
+  
+|区分|リソース|  
+|--------|----------|  
+|マネージ コード|[patterns & practices アプリケーション セキュリティ ガイダンス インデックス](http://go.microsoft.com/fwlink/?LinkId=117426)|  
+|[!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)]|[コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)|  
+|[!INCLUDE[TLA2#tla_clickonce](../../../includes/tla2sharptla-clickonce-md.md)]|[ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)|  
+|[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)]|[WPF 部分信頼セキュリティ](../../../docs/framework/wpf/wpf-partial-trust-security.md)|  
+  
+## 参照  
+ [WPF 部分信頼セキュリティ](../../../docs/framework/wpf/wpf-partial-trust-security.md)   
+ [WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)   
+ [WPF のセキュリティ方針 \- セキュリティ エンジニアリング](../../../docs/framework/wpf/wpf-security-strategy-security-engineering.md)   
+ [patterns & practices アプリケーション セキュリティ ガイダンス インデックス](http://go.microsoft.com/fwlink/?LinkId=117426)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)   
+ [ClickOnce のセキュリティと配置](../Topic/ClickOnce%20Security%20and%20Deployment.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/wpf-partial-trust-security.md b/docs/framework/wpf/wpf-partial-trust-security.md
new file mode 100644
index 00000000000..05905e1b74a
--- /dev/null
+++ b/docs/framework/wpf/wpf-partial-trust-security.md
@@ -0,0 +1,173 @@
+---
+title: "WPF 部分信頼セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "デバッグ (部分信頼アプリケーションを)"
+  - "検出 (アクセス許可を)"
+  - "機能セキュリティ要件"
+  - "管理 (アクセス許可を)"
+  - "部分信頼アプリケーション, デバッグ"
+  - "部分信頼セキュリティ"
+  - "のアクセス許可, 検出"
+  - "のアクセス許可, 管理"
+  - "Internet Explorer のセキュリティ設定"
+ms.assetid: ef2c0810-1dbf-4511-babd-1fab95b523b5
+caps.latest.revision: 40
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 36
+---
+# WPF 部分信頼セキュリティ
+<a name="introduction"></a> 一般に、悪質な被害を防止するため、インターネット アプリケーションによる重要なシステム リソースへの直接アクセスは制限する必要があります。  既定では、[!INCLUDE[TLA#tla_html](../../../includes/tlasharptla-html-md.md)] およびクライアント側のスクリプト言語は、重要なシステム リソースにはアクセスできません。  [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] ブラウザー ホスト アプリケーションは、ブラウザーから起動できるため、同様に、一連の制限に従う必要があります。  この制限を適用するために、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は [!INCLUDE[TLA#tla_cas](../../../includes/tlasharptla-cas-md.md)] と [!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] の両方に依存します \(「[WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)」を参照\)。  既定では、ブラウザー ホスト アプリケーションは、インターネット、ローカル イントラネット、ローカル コンピューターのどこから起動されたかに関係なく、インターネット ゾーン [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] のアクセス許可セットを要求します。  無制限ではないアクセス許可の元で実行するアプリケーションは、部分信頼で実行しているものと見なされます。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、さまざまなサポートを提供し、最大限の機能を部分信頼で安全に使用できることを実現します。また、[!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] と共に、部分信頼のプログラミングへの追加サポートを提供します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [WPF 機能の部分信頼サポート](#WPF_Feature_Partial_Trust_Support)  
+  
+-   [部分信頼のプログラミング](#Partial_Trust_Programming)  
+  
+-   [アクセス許可の管理](#Managing_Permissions)  
+  
+<a name="WPF_Feature_Partial_Trust_Support"></a>   
+## WPF 機能の部分信頼サポート  
+ 次の表は、インターネット ゾーン アクセス許可セットの制限内で、安全に使用できる [!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] の高レベル機能の一覧です。  
+  
+ 表 1 : 部分信頼で安全な WPF 機能  
+  
+|機能エリア|機能|  
+|-----------|--------|  
+|\[全般\]|ブラウザー ウィンドウ<br /><br /> 起点サイト アクセス<br /><br /> IsolatedStorage \(512 KB 制限\)<br /><br /> UIAutomation プロバイダー<br /><br /> コマンド実行<br /><br /> 入力方式エディター \(IME\)<br /><br /> タブレット スタイラスとインク<br /><br /> マウス キャプチャと移動イベントを使用してシミュレートされたドラッグ\/ドロップ<br /><br /> OpenFileDialog<br /><br /> XAML 逆シリアル化 \(XamlReader.Load 経由\)|  
+|Web 統合|ブラウザー ダウンロード ダイアログ<br /><br /> トップレベル ユーザーが実行するナビゲーション<br /><br /> mailto: リンク<br /><br /> Uniform Resource Identifier パラメーター<br /><br /> HTTPWebRequest<br /><br /> IFRAME でホストされた WPF コンテンツ<br /><br /> フレームを使用した同一サイトの HTML ページのホスト<br /><br /> WebBrowser を使用した同一サイトの HTML ページのホスト<br /><br /> Web サービス \(ASMX\)<br /><br /> Web サービス \(Windows Communication Foundation を使用\)<br /><br /> スクリプト<br /><br /> ドキュメント オブジェクト モデル|  
+|ビジュアル|2D と 3D<br /><br /> アニメーション<br /><br /> メディア \(起点サイトおよびドメイン間\)<br /><br /> イメージング\/オーディオ\/ビデオ|  
+|読み取り|FlowDocument<br /><br /> XPS ドキュメント<br /><br /> 埋め込みフォントとシステム フォント<br /><br /> CFF フォントと TrueType フォント|  
+|編集|スペル チェック<br /><br /> RichTextBox<br /><br /> プレーンテキストおよびインク クリップボード サポート<br /><br /> ユーザーが実行する貼り付け<br /><br /> 選択した内容のコピー|  
+|コントロール|コントロール全般|  
+  
+ この表は、高レベルの [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] 機能を示しています。  詳細情報に関して [!INCLUDE[TLA#tla_lhsdk](../../../includes/tlasharptla-lhsdk-md.md)] では、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] の各メンバーが必要とするアクセス許可について文書化しています。  また、以下の機能については、特別な考慮事項など、部分信頼での実行に関するさらに詳細な情報があります。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] \(「[XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照\)。  
+  
+-   ポップアップ \(<xref:System.Windows.Controls.Primitives.Popup?displayProperty=fullName> を参照\)  
+  
+-   ドラッグ アンド ドロップ \(「[ドラッグ アンド ドロップの概要](../../../docs/framework/wpf/advanced/drag-and-drop-overview.md)」を参照\)。  
+  
+-   クリップボード \(<xref:System.Windows.Clipboard?displayProperty=fullName> を参照\)  
+  
+-   イメージング \(<xref:System.Windows.Controls.Image?displayProperty=fullName> を参照\)  
+  
+-   シリアル化 \(<xref:System.Windows.Markup.XamlReader.Load%2A?displayProperty=fullName>、<xref:System.Windows.Markup.XamlWriter.Save%2A?displayProperty=fullName> を参照\)  
+  
+-   ファイルを開くダイアログ ボックス \(<xref:Microsoft.Win32.OpenFileDialog?displayProperty=fullName> を参照\)。  
+  
+ 次の表は、インターネット ゾーン アクセス許可セットの制限内では、安全に実行できない [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] 機能の一覧です。  
+  
+ 表 2 : 部分信頼で安全でない WPF 機能  
+  
+|機能エリア|機能|  
+|-----------|--------|  
+|\[全般\]|ウィンドウ \(アプリケーションで定義したウィンドウおよびダイアログ ボックス\)<br /><br /> SaveFileDialog<br /><br /> ファイル システム<br /><br /> レジストリへのアクセス<br /><br /> ドラッグ アンド ドロップ<br /><br /> XAML シリアル化 \(XamlWriter.Save 経由\)<br /><br /> UIAutomation クライアント<br /><br /> ソース ウィンドウ アクセス \(HwndHost\)<br /><br /> 完全な音声サポート<br /><br /> Windows フォームの相互運用性|  
+|ビジュアル|ビットマップ効果<br /><br /> イメージ エンコード|  
+|編集|リッチ テキスト形式のクリップボード<br /><br /> 完全な XAML サポート|  
+  
+<a name="Partial_Trust_Programming"></a>   
+## 部分信頼のプログラミング  
+ [!INCLUDE[TLA2#tla_xbap](../../../includes/tla2sharptla-xbap-md.md)] アプリケーションでは、コードが既定のアクセス許可セットを越える場合、セキュリティ ゾーンによって動作が異なります。  ユーザーがアプリケーションをインストールしようとすると警告が表示されることもあります。  ユーザーは、インストールを続行するか取り消すかを選択できます。  次の表は、各セキュリティ ゾーンのアプリケーション動作と、完全信頼を受け取るアプリケーションで行う必要のある操作を示しています。  
+  
+|セキュリティ ゾーン|\[動作\]|完全信頼を受け取るための操作|  
+|----------------|------------|--------------------|  
+|ローカル コンピューター|完全信頼を自動的に受け取る|アクションは必要ありません。|  
+|イントラネットおよび信頼されたサイト|完全信頼のプロンプトを表示|ユーザーへのプロンプトにソースが表示されるように、証明書を使用して XBAP を署名します。|  
+|インターネット|"信頼されていません" というメッセージが表示され、失敗する|証明書を使用して XBAP に署名します。|  
+  
+> [!NOTE]
+>  前の表で説明した動作は、ClickOnce 信頼済み配置モデルに従っていない完全信頼の XBAP の動作です。  
+  
+ 一般に、設定されているアクセス許可を超える可能性のあるコードは、スタンドアロン アプリケーションとブラウザー ホスト アプリケーションの間で共有される通常のコードと考えられます。  [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] と [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] には、このシナリオを処理するためのいくつかの手法が用意されています。  
+  
+<a name="Detecting_Permissions_using_CAS"></a>   
+### CAS を使用したアクセス許可の検出  
+ 状況によっては、ライブラリ アセンブリで共有されるコードを、スタンドアロン アプリケーションと [!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] の両方で使用することができます。  この場合、コードは、アプリケーションに付与されているアクセス許可セットの制限よりも高い許可を要求する機能を実行する可能性があります。  アプリケーションは、[!INCLUDE[TLA#tla_winfx](../../../includes/tlasharptla-winfx-md.md)] セキュリティを使用して、特定のアクセス許可を得ているかどうかを検出できます。  特に、必要なアクセス許可のインスタンスで <xref:System.Security.CodeAccessPermission.Demand%2A> メソッドを呼び出して、特定のアクセス許可を持っているかどうかをテストすることができます。  これを次の例に示します。このコードでは、ローカル ディスクにファイルを保存できるかどうかを照会します。  
+  
+ [!code-csharp[PartialTrustSecurityOverviewSnippets#DetectPermsCODE1](../../../samples/snippets/csharp/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/CSharp/FileHandling.cs#detectpermscode1)]
+ [!code-vb[PartialTrustSecurityOverviewSnippets#DetectPermsCODE1](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/VisualBasic/FileHandling.vb#detectpermscode1)]  
+[!code-csharp[PartialTrustSecurityOverviewSnippets#DetectPermsCODE2](../../../samples/snippets/csharp/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/CSharp/FileHandling.cs#detectpermscode2)]
+[!code-vb[PartialTrustSecurityOverviewSnippets#DetectPermsCODE2](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/VisualBasic/FileHandling.vb#detectpermscode2)]  
+  
+ アプリケーションに必要なアクセス許可がない場合、<xref:System.Security.CodeAccessPermission.Demand%2A> の呼び出しによって、セキュリティ例外がスローされます。  それ以外の場合は、アクセス許可が付与されます。  `IsPermissionGranted` は、この動作をカプセル化し、必要に応じて `true` または `false` を返します。  
+  
+<a name="Graceful_Degradation_of_Functionality"></a>   
+### 機能の正常な低下  
+ コードに必要なアクセス許可があるかどうかを検出できることは、別のゾーンから実行できるコードにとって重要です。  ゾーンが 1 つであることを検出している間に、可能であれば、ユーザーに代替手段を提供する方がより望ましいでしょう。  たとえば、完全信頼アプリケーションを使用すると、通常、ユーザーは任意の場所にファイルを作成できますが、部分信頼アプリケーションでは、ファイルを作成できるのは分離ストレージだけです。  ファイルを作成するコードが、完全信頼 \(スタンドアロン\) アプリケーションと部分信頼 \(ブラウザー ホスト\) アプリケーションとで共有されるアセンブリ内にある場合、ユーザーが両方のアプリケーションでファイルを作成できるようにするには、適切な場所にファイルを作成する前に、この共有されるコードが、部分信頼で実行されているのか完全信頼で実行されているのかを検出する必要があります。  次のコードで両方の例を示します。  
+  
+ [!code-csharp[PartialTrustSecurityOverviewSnippets#DetectPermsGracefulCODE1](../../../samples/snippets/csharp/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/CSharp/FileHandlingGraceful.cs#detectpermsgracefulcode1)]
+ [!code-vb[PartialTrustSecurityOverviewSnippets#DetectPermsGracefulCODE1](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/VisualBasic/FileHandlingGraceful.vb#detectpermsgracefulcode1)]  
+[!code-csharp[PartialTrustSecurityOverviewSnippets#DetectPermsGracefulCODE2](../../../samples/snippets/csharp/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/CSharp/FileHandlingGraceful.cs#detectpermsgracefulcode2)]
+[!code-vb[PartialTrustSecurityOverviewSnippets#DetectPermsGracefulCODE2](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/PartialTrustSecurityOverviewSnippets/VisualBasic/FileHandlingGraceful.vb#detectpermsgracefulcode2)]  
+  
+ 多くの場合、部分信頼の代替を見つける必要があります。  
+  
+ イントラネットなどの制御された環境では、カスタム マネージ フレームワークを、クライアント ベース全体にわたって、[!INCLUDE[TLA#tla_gac](../../../includes/tlasharptla-gac-md.md)] にインストールすることができます。  このライブラリは、完全信頼を必要とするコードを実行することができ、<xref:System.Security.AllowPartiallyTrustedCallersAttribute> を使用することで、部分信頼だけを付与されているアプリケーションからも参照できます \(詳細については、「[セキュリティ](../../../docs/framework/wpf/security-wpf.md)」および「[WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)」を参照してください\)。  
+  
+<a name="Browser_Host_Detection"></a>   
+### ブラウザー ホストの検出  
+ [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] を使用したアクセス許可の確認は、アクセス許可ごとの確認が必要な場合に適した手法です。  ただし、この手法は、通常の処理の一部として例外をキャッチすることに依存し、一般には推奨されません。また、パフォーマンスの問題を抱える可能性があります。  代わりに、[!INCLUDE[TLA#tla_xbap](../../../includes/tlasharptla-xbap-md.md)] がインターネット ゾーンのサンドボックス内でのみ実行される場合、<xref:System.Windows.Interop.BrowserInteropHelper.IsBrowserHosted%2A?displayProperty=fullName> プロパティを使用することができ、これは [!INCLUDE[TLA#tla_xbap#plural](../../../includes/tlasharptla-xbapsharpplural-md.md)] に true を返します。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Interop.BrowserInteropHelper.IsBrowserHosted%2A> は、アプリケーションがブラウザーで実行されているかどうかを区別するだけで、実行中のアプリケーションに付与されているアクセス許可セットについての区別はしません。  
+  
+<a name="Managing_Permissions"></a>   
+## アクセス許可の管理  
+ 既定では、[!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] は、部分信頼 \(既定のインターネット ゾーン アクセス許可セット\) で実行されます。  ただし、アプリケーションの要求に応じて、アクセス許可セットを既定から変更することができます。  たとえば、[!INCLUDE[TLA2#tla_xbap#plural](../../../includes/tla2sharptla-xbapsharpplural-md.md)] がローカル イントラネットから起動される場合、より高いアクセス許可セットを利用できます。これを次の表に示します。  
+  
+ 表 3 : ローカル イントラネットのアクセス許可とインターネットのアクセス許可  
+  
+|Permission|属性|ローカル イントラネット|インターネット|  
+|----------------|--------|------------------|-------------|  
+|DNS|アクセス DNS サーバー|○|Ｘ|  
+|環境変数|Read|○|Ｘ|  
+|ファイル ダイアログ|\[Open\]|○|○|  
+|ファイル ダイアログ|制限なし|○|Ｘ|  
+|分離ストレージ|ユーザーによるアセンブリの分離|○|Ｘ|  
+|分離ストレージ|不明な分離|○|○|  
+|分離ストレージ|無制限のユーザー クォータ|○|Ｘ|  
+|メディア|安全なオーディオ、ビデオ、イメージ|○|○|  
+|印刷|既定の印刷|○|Ｘ|  
+|印刷|安全な印刷|○|○|  
+|リフレクション|出力|○|Ｘ|  
+|セキュリティ|マネージ コードの実行|○|○|  
+|セキュリティ|付与されたアクセス許可の Assert|○|Ｘ|  
+|ユーザー インターフェイス|制限なし|○|Ｘ|  
+|ユーザー インターフェイス|安全なトップレベル ウィンドウ|○|○|  
+|ユーザー インターフェイス|独自のクリップボード|○|○|  
+|Web ブラウザー|HTML への安全なフレーム ナビゲーション|○|○|  
+  
+> [!NOTE]
+>  切り取りと貼り付けは、ユーザーが開始する部分信頼でのみ許可されます。  
+  
+ アクセス許可を増やす必要がある場合は、プロジェクト設定と ClickOnce アプリケーション マニフェストを変更する必要があります。  詳細については、「[WPF XAML ブラウザー アプリケーションの概要](../../../docs/framework/wpf/app-development/wpf-xaml-browser-applications-overview.md)」を参照してください。  次のドキュメントが役に立つこともあります。  
+  
+-   [Mage.exe \(マニフェストの生成および編集ツール\)](../../../docs/framework/tools/mage-exe-manifest-generation-and-editing-tool.md).  
+  
+-   [MageUI.exe \(マニフェスト生成および編集ツールのグラフィカル クライアント\)](../../../docs/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client.md).  
+  
+-   [ClickOnce アプリケーションのセキュリティ](../Topic/Securing%20ClickOnce%20Applications.md).  
+  
+ [!INCLUDE[TLA2#tla_xbap](../../../includes/tla2sharptla-xbap-md.md)] が完全信頼を必要とする場合、同じツールを使用して要求されたアクセス許可を強化できます。  ただし、[!INCLUDE[TLA2#tla_xbap](../../../includes/tla2sharptla-xbap-md.md)] は、イントラネットのローカル コンピューター上にインストールされ、ローカル コンピューターから起動されるか、ブラウザーの信頼されたサイトまたは許可されたサイトのリストに含まれる URL から起動する場合にのみ、完全信頼を受け取ります。  アプリケーションがイントラネットまたは信頼されたサイトからインストールされる場合、アクセス許可が昇格されたことを通知する標準の ClickOnce プロンプトがユーザーに表示されます。  ユーザーは、インストールを続行するか取り消すかを選択できます。  
+  
+ または、任意のセキュリティ ゾーンで完全信頼配置用の ClickOnce 信頼済み配置モデルを使用することもできます。  詳細については、「[信頼されたアプリケーションの配置の概要](../Topic/Trusted%20Application%20Deployment%20Overview.md)」および「[セキュリティ](../../../docs/framework/wpf/security-wpf.md)」を参照してください。  
+  
+## 参照  
+ [セキュリティ](../../../docs/framework/wpf/security-wpf.md)   
+ [WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)   
+ [WPF のセキュリティ方針 \- セキュリティ エンジニアリング](../../../docs/framework/wpf/wpf-security-strategy-security-engineering.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/wpf-samples.md b/docs/framework/wpf/wpf-samples.md
new file mode 100644
index 00000000000..671b7815d27
--- /dev/null
+++ b/docs/framework/wpf/wpf-samples.md
@@ -0,0 +1,23 @@
+---
+title: "WPF のサンプル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "サンプル [WPF]"
+  - "WPF サンプル"
+ms.assetid: 1fc53e12-dfe5-476e-be13-fc3714aaf640
+caps.latest.revision: 24
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# WPF のサンプル
+[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] の使用方法を示すサンプルについては、MSDN Code Gallery の「[WPF Documentation Samples \(WPF ドキュメントのサンプル\)](http://go.microsoft.com/fwlink/?LinkID=159044)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/wpf/wpf-security-strategy-platform-security.md b/docs/framework/wpf/wpf-security-strategy-platform-security.md
new file mode 100644
index 00000000000..c015a0ca233
--- /dev/null
+++ b/docs/framework/wpf/wpf-security-strategy-platform-security.md
@@ -0,0 +1,223 @@
+---
+title: "WPF のセキュリティ方針 - プラットフォーム セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR のセキュリティ機能"
+  - "共通言語ランタイム (CLR) のセキュリティ機能"
+  - "Internet Explorer のセキュリティ機能"
+  - "オペレーティング システムのセキュリティ モデル"
+  - "プラットフォームのセキュリティ モデル"
+  - "セキュリティ モデル"
+  - "セキュリティ モデル, オペレーティング システム"
+  - "セキュリティ モデル, platform"
+  - "セキュリティ クリティカルな方法"
+  - "Windows Presentation Foundation, セキュリティ モデルの概要"
+  - "WPF, セキュリティ モデルの概要"
+ms.assetid: 2a39a054-3e2a-4659-bcb7-8bcea490ba31
+caps.latest.revision: 30
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# WPF のセキュリティ方針 - プラットフォーム セキュリティ
+[!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] は、さまざまなセキュリティ サービスを提供する一方で、基になるプラットフォーム \(オペレーティング システム、[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)]、[!INCLUDE[TLA2#tla_ie](../../../includes/tla2sharptla-ie-md.md)] など\) のセキュリティ機能も活用します。  これらの層を組み合わせることで、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] に強力な多重防御のセキュリティ モデルが提供されます。このセキュリティ モデルでは、次の図に示すように、単一障害点の回避を試みます。  
+  
+ ![WPF セキュリティの図](../../../docs/framework/wpf/media/windowplatformsecurity.PNG "windowplatformsecurity")  
+  
+ このトピックの残りの部分では、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] に関連するこれらの各層の機能について具体的に説明します。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="Operating_System_Security"></a>   
+## オペレーティング システムのセキュリティ  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] が必要とするオペレーティング システムの最小レベルは [!INCLUDE[TLA2#tla_winxpsp2](../../../includes/tla2sharptla-winxpsp2-md.md)] です。  [!INCLUDE[TLA2#tla_winxpsp2](../../../includes/tla2sharptla-winxpsp2-md.md)] の中核には、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] で構築されたセキュリティ機能など、すべての [!INCLUDE[TLA2#tla_win](../../../includes/tla2sharptla-win-md.md)] アプリケーションのセキュリティ基盤を形成する複数のセキュリティ機能があります。  [!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] には、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] のセキュリティ機能が搭載され、それをさらに拡張しています。  このトピックでは、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] にとって重要なセキュリティ機能の一式、および [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] がそれらを統合してさらに多重防御を行う方法について説明します。  
+  
+<a name="Microsoft_Windows_XP_Service_Pack_2__SP2_"></a>   
+### Microsoft Windows XP Service Pack 2 \(SP2\)  
+ [!INCLUDE[TLA2#tla_win](../../../includes/tla2sharptla-win-md.md)] の総括と強化に加えて、このトピックでは、[!INCLUDE[TLA2#tla_winxpsp2](../../../includes/tla2sharptla-winxpsp2-md.md)] にある次の 3 つの主要機能についても説明します。  
+  
+-   \/GS のコンパイル  
+  
+-   [!INCLUDE[TLA#tla_win_update](../../../includes/tlasharptla-win-update-md.md)].  
+  
+#### \/GS のコンパイル  
+ [!INCLUDE[TLA2#tla_winxpsp2](../../../includes/tla2sharptla-winxpsp2-md.md)] は、バッファー オーバーランを軽減するために、[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] など、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] の依存関係のすべてを含む多数のコア システム ライブラリを再コンパイルして、保護を行います。  これは、C や C\+\+ のコマンド ライン コンパイラの \/GS パラメーターを使用して実現されます。  バッファー オーバーランを明示的に避ける必要はありますが、\/GS コンパイルは、故意であるかないかにかかわらずバッファー オーバーランによって生み出される潜在的な脆弱性に対する多重防御の一例となります。  
+  
+ 従来、バッファー オーバーランは、影響が大きいセキュリティ攻撃の多くの原因となっていました。  バッファー オーバーランは、バッファーの境界を超えて書き込む、悪意のあるコードの挿入を許すコードの脆弱性を攻撃者が利用するときに発生します。  これにより、攻撃者はプロセスを乗っ取ることができます。この場合、コードは、攻撃者のコードを実行するように関数のリターン アドレスを上書きすることで実行されます。  結果として、乗っ取ったプロセスと同じ特権を持つ任意のコードを実行する悪意のあるコードが生成されます。  
+  
+ 概略でとらえると、\/GS コンパイラ フラグは、ローカル文字列のバッファーを持つ関数のリターン アドレスを保護する特殊なセキュリティ クッキーを挿入して、潜在的なバッファー オーバーランから保護します。  関数が返されると、セキュリティ クッキーはその前の値と比較されます。  値が変更されている場合、バッファー オーバーランが発生した可能性があるとして、プロセスはエラー状態によって停止されます。  プロセスの停止により、悪意のある可能性があるコードの実行を防止できます。  詳細については、「[\/GS \(バッファーのセキュリティ チェック\)](http://msdn.microsoft.com/library/8dbf701c.aspx)」を参照してください。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、\/GS フラグでコンパイルされて、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションに別の防御層を追加します。  
+  
+#### Microsoft Windows 更新プログラムの拡張機能  
+ [!INCLUDE[TLA2#tla_winxpsp2](../../../includes/tla2sharptla-winxpsp2-md.md)] では、[!INCLUDE[TLA#tla_win_update](../../../includes/tlasharptla-win-update-md.md)] も改善され、更新プログラムのダウンロードとインストールのプロセスが簡略化されました。  これらの変更により、特にセキュリティ更新プログラムに関して、システムを確実に最新の状態にすることで、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] のお客様のセキュリティ保護が大きく拡大しました。  
+  
+<a name="Windows_Vista"></a>   
+### Windows Vista  
+ [!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] の [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] ユーザーは、「最小限の特権によるユーザー アクセス」、コードの整合性チェック、および特権の分離など、オペレーティング システムのさらなるセキュリティ機能強化の恩恵を受けられます。  
+  
+#### ユーザー アカウント制御 \[UAC\]  
+ 現在のところ、[!INCLUDE[TLA2#tla_win](../../../includes/tla2sharptla-win-md.md)] ユーザーは、管理者特権で実行する傾向があります。多くのアプリケーションで、インストールや実行、またはその両方に管理者特権が必要となるためです。  既定のアプリケーションの設定をレジストリに書き込めることが、その一例です。  
+  
+ 管理者特権で実行することの本当の意味は、管理者特権を付与されているプロセスからアプリケーションを実行することです。  これによるセキュリティへの影響は、管理者特権で実行するプロセスを乗っ取る悪意のあるコードが、重要なシステム リソースへのアクセスなど、これらの権限を自動的に継承することです。  
+  
+ このセキュリティの脅威から保護するための 1 つの方法は、必要最小限の特権でアプリケーションを実行することです。  これは、最小特権の原則として知られ、[!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] オペレーティング システムの主要機能となっています。  この機能をユーザー アカウント制御 \(UAC\) といい、[!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] UAC によって主に次の 2 つの方法で使用されます。  
+  
+-   ユーザーが管理者であっても、既定で UAC 特権を持つほとんどのアプリケーションを実行するために、管理者特権を必要とするアプリケーションのみが管理者特権で実行されます。  管理者特権で実行するためには、アプリケーションは、アプリケーション マニフェストで、またはセキュリティ ポリシーのエントリとして明示的にマークされる必要があります。  
+  
+-   仮想化のような互換性に関する解決策を提供します。  たとえば、多くのアプリケーションが C:\\Program Files のような制限された場所への書き込みを試みるなどです。  UAC の下で実行するアプリケーションでは、書き込みに管理者特権が必要でない、ユーザーごとの代替の場所が存在します。  UAC の下で実行するアプリケーションでは、UAC は C:\\Program Files を仮想化して、書き込もうとしているアプリケーションが、実際はユーザーごとの代替の場所に書き込むようにします。  このような互換性の作業により、オペレーティング システムは、以前は UAC で実行できなかった多くのアプリケーションを実行できるようになります。  
+  
+#### コードの整合性チェック  
+ [!INCLUDE[TLA#tla_longhorn](../../../includes/tlasharptla-longhorn-md.md)] には、読み込み時または実行時に、悪意のあるコードがシステム ファイルやカーネルに挿入されないようにするための、より詳細なコード整合性チェックが組み込まれています。  これは、システム ファイルの保護を超えて動作します。  
+  
+<a name="Limited_Rights_Process_for_Browser_Hosted_Applications"></a>   
+### ブラウザーでホストされるアプリケーションの制限付き権限のプロセス  
+ ブラウザーでホストされる [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは、インターネット ゾーンのサンド ボックス内で実行します。  [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] と [!INCLUDE[TLA#tla_ie](../../../includes/tlasharptla-ie-md.md)] を統合すると、この保護が追加のサポートで拡張されます。  
+  
+#### Internet Explorer 6 Service Pack 2 および XP 用の Internet Explorer 7  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、オペレーティング システムのセキュリティを利用して、[!INCLUDE[TLA#tla_winfxwebapp#plural](../../../includes/tlasharptla-winfxwebappsharpplural-md.md)] のプロセスの特権を制限してさらに保護します。  ブラウザーでホストされる [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションを起動する前に、オペレーティング システムは、プロセス トークンから不要な特権を取り除くホスト プロセスを作成します。  取り除かれる特権のいくつかの例として、ユーザーのコンピューターのシャット ダウン機能、ドライバーの読み込み、およびコンピューター上の全ファイルに対する読み取りアクセスがあります。  
+  
+#### Vista 用 Internet Explorer 7  
+ [!INCLUDE[TLA#tla_ie7](../../../includes/tlasharptla-ie7-md.md)] では、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは保護モードで実行します。  具体的には、[!INCLUDE[TLA#tla_xbap#plural](../../../includes/tlasharptla-xbapsharpplural-md.md)] は中レベルの整合性で実行します。  
+  
+#### 多重防御層  
+ [!INCLUDE[TLA#tla_winfxwebapp#plural](../../../includes/tlasharptla-winfxwebappsharpplural-md.md)] は一般に、インターネット ゾーン アクセス許可セットによってセキュリティで保護されるため、互換性の観点から、これらの特権を取り除いても、[!INCLUDE[TLA#tla_winfxwebapp#plural](../../../includes/tlasharptla-winfxwebappsharpplural-md.md)] には害を及ぼしません。  代わりに、追加の多重防御層が作成されます。セキュリティで保護されたアプリケーションが他のレイヤーを利用してプロセスを乗っ取ることができる場合、プロセスの特権は制限されたままとなります。  
+  
+ 「[最小特権のユーザー アカウントを使用する](http://technet.microsoft.com/library/cc700846.aspx)」を参照してください。  
+  
+<a name="Common_Language_Runtime_Security"></a>   
+## 共通言語ランタイムのセキュリティ  
+ [!INCLUDE[TLA#tla_clr](../../../includes/tlasharptla-clr-md.md)] は、確認と検証、[!INCLUDE[TLA#tla_cas](../../../includes/tlasharptla-cas-md.md)]、およびセキュリティ クリティカルな方法などの、多数のセキュリティ上の重要なメリットをもたらします。  
+  
+<a name="Validation_and_Verification"></a>   
+### 確認と検証  
+ アセンブリの分離と整合性を提供するため、[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] は検証のプロセスを使用します。  [!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] の検証では、アセンブリの外部にポイントするアドレスのポータブル実行可能ファイル \(PE\) ファイル形式を検証して、アセンブリが分離されていることを確認します。  また、[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] 検証では、アセンブリ内に埋め込まれているメタデータの整合性を検証します。  
+  
+ タイプ セーフを保証するため、一般的なセキュリティ上の問題 \(例:   バッファー オーバーラン\) を予防します。さらに、サブプロセスの分離を通じてサンドボックスを可能にします。[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] のセキュリティでは、確認の概念を使用します。  
+  
+ マネージ アプリケーションは、Microsoft Intermediate Language \(MSIL\) にコンパイルされます。  マネージ アプリケーション内のメソッドを実行する際、その MSIL は Just\-In\-Time \(JIT\) コンパイルを通じてネイティブ コードにコンパイルされます。  JIT コンパイルには、コードが以下を行わないようにする多数の安全性と堅牢性ルールを適用する検証プロセスがあります。  
+  
+-   型のコントラクトの違反  
+  
+-   バッファー オーバーランの導入  
+  
+-   乱暴なメモリへのアクセス  
+  
+ マネージ コードが信頼されたコードと見なされない限り、検証ルールに適合しないマネージ コードの実行は許可されません。  
+  
+ 検証可能なコードの利点は、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] が [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] 上に構築される主な理由になります。  検証可能なコードを使用する範囲で、起こりうる脆弱性の悪用の可能性が大幅に減少します。  
+  
+<a name="Code_Access_Security"></a>   
+### コード アクセス セキュリティ  
+ クライアント コンピューターは、ファイル システム、レジストリ、印刷サービス、ユーザー インターフェイス、リフレクション、および環境変数など、マネージ アプリケーションがアクセスできる多種多様なリソースを公開します。  マネージ アプリケーションは、クライアント コンピューター上のリソースのいずれかにアクセスするまでに、それを実行するための [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] [!INCLUDE[TLA#tla_cas](../../../includes/tlasharptla-cas-md.md)] のアクセス許可を得る必要があります。  [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] のアクセス許可は、<xref:System.Security.CodeAccessPermission> のサブクラスです。[!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] は、マネージ アプリケーションがアクセスできるリソースごとに 1 つのサブクラスを実装します。  
+  
+ マネージ アプリケーションが実行を開始する際に [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] によって付与される一連のアクセス許可は、アクセス許可セットとして知られ、アプリケーションが提供する証拠によって決定されます。  [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションでは、提供される証拠は、アプリケーションが起動される場所またはゾーンです。  [!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] は次のゾーンを識別します。  
+  
+-   **マイ コンピューター**。  クライアント コンピューターから起動するアプリケーション \(完全信頼\)。  
+  
+-   **ローカル イントラネット**。  イントラネットから起動するアプリケーション。  \(部分信頼\)。  
+  
+-   **インターネット** インターネットから起動するアプリケーション。  \(最小信頼\)。  
+  
+-   **信頼済みサイト**。  ユーザーから信頼すると特定されたアプリケーション。  \(最小信頼\)。  
+  
+-   **信頼されていないサイト** ユーザーから信頼しないと特定されたアプリケーション。  \(非信頼\)。  
+  
+ これらのゾーンごとに、[!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] は、それぞれが関連付けられている信頼レベルと一致するアクセス許可を含む定義済みの権限セットを提供します。  以下に例を示します。  
+  
+-   **FullTrust**。  **マイ コンピューター** ゾーンから起動するアプリケーション向け。  可能性のあるすべてのアクセス許可が付与されます。  
+  
+-   **LocalIntranet**。  **ローカル イントラネット** ゾーンから起動するアプリケーション向け。  分離ストレージ、UI の無制限のアクセス、制約のないファイル ダイアログ、制限付きのリフレクション、環境変数へのアクセス制限など、クライアント コンピューターのリソースへの中程度のアクセスを提供するアクセス許可のサブセットが付与されます。  レジストリのような重要なリソースに対するアクセス許可は提供されません。  
+  
+-   **インターネット** **インターネット**または**信頼済みサイト** ゾーンから起動するアプリケーション向け。  分離ストレージ、ファイルを開くのみ、および制限付きの UI など、クライアント コンピューターに制限付きのアクセス権を付与するため、アクセス許可のサブセットを付与します。  基本的に、このアクセス許可セットでは、アプリケーションはクライアント コンピューターから分離されます。  
+  
+ **信頼されていないサイト** ゾーンのアプリケーションと識別されたアプリケーションは、[!INCLUDE[TLA2#tla_cas](../../../includes/tla2sharptla-cas-md.md)] からアクセス許可を付与されません。  その結果、定義済みのアクセス許可セットは存在しません。  
+  
+ 次の図は、ゾーン、アクセス許可セット、アクセス許可、およびリソース間の関係を示しています。  
+  
+ ![CAS アクセス許可セット](../../../docs/framework/wpf/media/caspermissionsets.png "CASPermissionSets")  
+  
+ インターネット ゾーンのセキュリティ サンドボックスの制約は、[!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] が [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] を含むシステム ライブラリからインポートする任意のコードに等しく適用されます。  これにより、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] であっても、コードはビットごとにロック ダウンされます。  残念ながら、実行できるようにするためには、[!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] は、インターネット ゾーンのセキュリティ サンドボックスで有効化されたアクセス許可より多くのアクセス許可を必要とする機能を実行する必要があります。  
+  
+ 次のページを含む [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] アプリケーションを検討してください。  
+  
+ [!code-csharp[WPFPlatformSecuritySnippets#Permission](../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFPlatformSecuritySnippets/CSharp/Page1.xaml.cs#permission)]
+ [!code-vb[WPFPlatformSecuritySnippets#Permission](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFPlatformSecuritySnippets/VisualBasic/Page1.xaml.vb#permission)]  
+  
+ この [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] を実行するために、基になる [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] コードは、呼び出し元の [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] で使用できるより多くの機能を実行する必要があります。それらは次のとおりです。  
+  
+-   表示するためのウィンドウ ハンドル \(hWnd\) の作成  
+  
+-   メッセージのディスパッチ  
+  
+-   Tahoma フォントの読み込み  
+  
+ セキュリティの観点から、セキュリティで保護されたアプリケーションからこれらの操作のいずれかに直接アクセスを許可すると、致命的な状態になります。  
+  
+ 幸い、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、セキュリティで保護されたアプリケーションの代わりに、これらの操作が昇格した特権で実行できるようにすることで、この状況に対応します。  すべての [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] の操作に対して [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] のアプリケーション ドメインにおける制限付きのインターネット ゾーンのセキュリティのアクセス許可がチェックされます。[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] には、\(その他のシステム ライブラリと同様に、\) 可能性があるすべてのアクセス許可を含むアクセス許可が付与されます。  
+  
+ そのためには、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] が昇格した特権を受け取る一方、それらの特権がホスト アプリケーション ドメインのインターネット ゾーンのアクセス許可セットによって制御されないようにする必要があります。  
+  
+ [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、アクセス許可の **Assert** メソッドを使用してこれを実行します。  次のコードは、その方法を示しています。  
+  
+ [!code-csharp[WPFPlatformSecuritySnippets#Permission](../../../samples/snippets/csharp/VS_Snippets_Wpf/WPFPlatformSecuritySnippets/CSharp/Page1.xaml.cs#permission)]
+ [!code-vb[WPFPlatformSecuritySnippets#Permission](../../../samples/snippets/visualbasic/VS_Snippets_Wpf/WPFPlatformSecuritySnippets/VisualBasic/Page1.xaml.vb#permission)]  
+  
+ 基本的に、**Assert** は、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] が必要とする無制限のアクセス許可が、[!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] のインターネット ゾーンのアクセス許可によって制限されないようにします。  
+  
+ プラットフォームの観点から、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は **Assert** を適切に使用する役割を担います。**Assert** を正しく使用しないと、悪意のあるコードが特権を昇格してしまう恐れがあります。  したがって、**Assert** は必要なときにのみ呼び出し、サンドボックスによる制約は変更しないようにすることが重要です。  たとえば、セキュリティで保護されたコードでは、ランダムなファイルを開くことはできませんが、フォントは使用できます。  [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] は、セキュリティで保護されたアプリケーションが **Assert** を呼び出してフォントの機能を使えるようにするとともに、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] がセキュリティで保護されたアプリケーションの代わりにそれらのフォントが含まれていることが分かっているファイルを読み取れるようにします。  
+  
+<a name="ClickOnce_Deployment"></a>   
+### ClickOnce の配置  
+ [!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] は、[!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] に付属する包括的な配置テクノロジで、[!INCLUDE[TLA#tla_visualstu](../../../includes/tlasharptla-visualstu-md.md)] と統合されています \(詳細については、「[ClickOnce の配置の概要](http://msdn.microsoft.com/library/142dbbz4.aspx)」を参照してください\)。  スタンドアロンの [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションは、[!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] を使用して配置できます。一方、ブラウザーでホストされるアプリケーションは [!INCLUDE[TLA2#tla_clickonce](../../../includes/tla2sharptla-clickonce-md.md)] で配置する必要があります。  
+  
+ [!INCLUDE[TLA2#tla_clickonce](../../../includes/tla2sharptla-clickonce-md.md)] を使用して配置されたアプリケーションには、[!INCLUDE[TLA#tla_cas](../../../includes/tlasharptla-cas-md.md)] の上に追加のセキュリティ層が設けられます。基本的に、[!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] の配置済みのアプリケーションは、必要なアクセス許可を要求します。  これらのアプリケーションが、アプリケーションの配置元ゾーンのアクセス許可セット数を超えていない場合、これらのアプリケーションには必要なアクセス許可のみが付与されます。  アクセス許可セット数を必要な数のみに減らすことで、起動ゾーンのアクセス許可セットが提供するアクセス許可数を下回る場合でも、アプリケーションがアクセスできるリソースの数が最小限まで削減されます。  その結果、アプリケーションが乗っ取られた場合、クライアント コンピューターの損傷の可能性が低減します。  
+  
+<a name="Security_Critical_Methodology"></a>   
+### セキュリティ クリティカルな方法  
+ [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] アプリケーションでインターネット ゾーンのサンド ボックスを有効にするアクセス許可を使用する [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] コードは、セキュリティ監査および制御の程度を可能な限り高く保持する必要があります。  この要件に対応するため、[!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] は、特権を昇格するコードを管理するための新しいサポートを提供します。  具体的には、[!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] は、特権を昇格させるコードを識別して <xref:System.Security.SecurityCriticalAttribute> でマークできるようにします。<xref:System.Security.SecurityCriticalAttribute> でマークされていないコードは、この方法を使用して*透過的*になります。  逆に、<xref:System.Security.SecurityCriticalAttribute> でマークされていないマネージ コードは特権の昇格ができなくなります。  
+  
+ セキュリティ クリティカルな方法では、*セキュリティ クリティカルなカーネル*に特権が昇格する [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] コードの組織が、残りの部分を透過的にすることを許可します。  セキュリティ クリティカルなコードを分離することにより、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] のエンジニアリング チームは、標準的なセキュリティ プラクティスを超えた追加のセキュリティ分析とソース コントロールに重点を置くことができます \([WPF のセキュリティ方針 \- セキュリティ エンジニアリング](../../../docs/framework/wpf/wpf-security-strategy-security-engineering.md)を参照してください\)。  
+  
+ なお [!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] は、開発者が <xref:System.Security.AllowPartiallyTrustedCallersAttribute> \(APTCA\) でマークされ、ユーザーのグローバル アセンブリ キャッシュ \(GAC\) に配置されたマネージ アセンブリに書き込めるようにすることで、信頼されたコードが [!INCLUDE[TLA2#tla_winfxwebapp](../../../includes/tla2sharptla-winfxwebapp-md.md)] のインターネット ゾーンのサンドボックスに拡張することを許可します。  アセンブリを APTCA でマークすることは、機密性の高いセキュリティ操作です。インターネットからの悪意のあるコードなど、いずれのコードもそのアセンブリを呼び出すことができるためです。  これを実施する際は十分注意し、ベスト プラクティスを使用する必要があります。ソフトウェアをインストールするためには、ユーザーがそのソフトウェアを信頼することを選択する必要があります。  
+  
+<a name="Microsoft_Internet_Explorer_Security"></a>   
+## Microsoft Internet Explorer のセキュリティ  
+ セキュリティ上の問題を減らし、セキュリティの構成を簡素化するだけでなく、[!INCLUDE[TLA#tla_ie6sp2](../../../includes/tlasharptla-ie6sp2-md.md)] には、[!INCLUDE[TLA#tla_winfxwebapp#plural](../../../includes/tlasharptla-winfxwebappsharpplural-md.md)] のユーザーのセキュリティを強化するようセキュリティが向上した複数の機能が含まれています。  これらの機能の推進により、ユーザーが閲覧の制御を拡大できるようにしています。  
+  
+ [!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] の前のバージョンでは、ユーザーは次のいずれかの影響を受ける可能性がありました。  
+  
+-   ランダムなポップアップ ウィンドウ。  
+  
+-   スクリプトのリダイレクトの混乱。  
+  
+-   一部の Web サイトでの多数のセキュリティ ダイアログ。  
+  
+ 場合によっては、信頼できない Web サイトで [!INCLUDE[TLA#tla_ui](../../../includes/tlasharptla-ui-md.md)] のインストールのなりすましをしたり、ユーザーがキャンセルしていても [!INCLUDE[TLA#tla_actx](../../../includes/tlasharptla-actx-md.md)] のインストールのダイアログ ボックスを繰り返し表示したりしてユーザーを騙そうとします。  これらの方法によって、大多数のユーザーが騙されて不適切な判断を行い、スパイウェア アプリケーションのインストールにつながる可能性があります。  
+  
+ [!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] には、ユーザーによる開始の概念にまつわるこのような問題を軽減するいくつかの機能があります。  [!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] は、アクションの前にユーザーがリンクやページ要素をクリックしたとき \(*ユーザーによる開始*として知られる\) に検出し、同様のアクションがページのスクリプトによってトリガーされる場合とは異なる処理をします。  たとえば、[!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] には、ページのポップアップを作成する前にユーザーがボタンをクリックすると検出する**ポップアップ ブロック**が組み込まれています。  これにより、[!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] は何の問題もないポップアップを許可する一方、ユーザーが要求も希望もしていないポップアップを防ぎます。  ブロックされたポップアップは、新しい**情報バー**にトラップされます。情報バーを使用すると、ユーザーは手動でブロックをオーバーライドし、ポップアップ ウィンドウを表示できます。  
+  
+ 同じユーザーによる開始のロジックが、**\[開く\]**\/**\[保存\]** のセキュリティに関するメッセージにも適用されています。  [!INCLUDE[TLA2#tla_actx](../../../includes/tla2sharptla-actx-md.md)] のインストールのダイアログ ボックスは、以前インストールされたコントロールからのアップグレードを表す場合を除いて、情報バーにトラップされます。  これらの対策を組み合わせると、より安全かつ制御されたユーザー エクスペリエンスがユーザーに提供されます。ユーザーを攻撃して不要または悪意のあるソフトウェアをインストールさせるサイトからユーザーが保護されるためです。  
+  
+ これらの機能は、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションのダウンロードとインストールを行えるようにする Web サイトを閲覧するために [!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] を使用するお客様も保護します。  特に [!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] では、[!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] を含め、構築にどのテクノロジを使用したかに関係なく、悪意のあるまたは不正なアプリケーションをユーザーがインストールする機会を減らす上でユーザーエクスペリエンスの向上を提供しているからです。  [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] では、[!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] を使用してこのような保護を追加することで、インターネット経由でアプリケーションをダウンロードしやすくします。  [!INCLUDE[TLA#tla_winfxwebapp#plural](../../../includes/tlasharptla-winfxwebappsharpplural-md.md)] はインターネット ゾーンのセキュリティ サンドボックス内で実行するので、シームレスに起動することができます。  一方、スタンドアロンの [!INCLUDE[TLA2#tla_wpf](../../../includes/tla2sharptla-wpf-md.md)] アプリケーションでは、実行するには完全な信頼が必要になります。  これらのアプリケーションでは、起動プロセス中に [!INCLUDE[TLA#tla_clickonce](../../../includes/tlasharptla-clickonce-md.md)] はセキュリティに関するダイアログ ボックスを表示して、アプリケーションの追加のセキュリティ要件を使用するよう通知します。  ただし、これはユーザーが開始する必要があり、ユーザーが開始したロジックによって制御されるとともに、キャンセルが可能です。  
+  
+ [!INCLUDE[TLA2#tla_ie7](../../../includes/tla2sharptla-ie7-md.md)] は、継続的なセキュリティへの取り組みの一環として、[!INCLUDE[TLA2#tla_ie6sp2](../../../includes/tla2sharptla-ie6sp2-md.md)] のセキュリティ機能を強化しています。  
+  
+## 参照  
+ [Windows XP SP2 での Microsoft Internet explorer 6 のセキュリティについて](http://www.microsoft.com/downloads/details.aspx?FamilyId=E550F940-37A0-4541-B5E2-704AB386C3ED&displaylang=jp)   
+ [保護モードの Internet Explorer の理解と機能](http://msdn.microsoft.com/library/bb250462.aspx)   
+ [Windows XP Service Pack 3](http://www.microsoft.com/windows/products/windowsxp/sp3/default.mspx)   
+ [Windows Vista セキュリティ ガイド](http://www.microsoft.com/downloads/details.aspx?familyid=a3d1bbed-7f35-4e72-bfb5-b84a526c1565&displaylang=jp)   
+ [コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)   
+ [セキュリティ](../../../docs/framework/wpf/security-wpf.md)   
+ [WPF 部分信頼セキュリティ](../../../docs/framework/wpf/wpf-partial-trust-security.md)   
+ [WPF のセキュリティ方針 \- セキュリティ エンジニアリング](../../../docs/framework/wpf/wpf-security-strategy-security-engineering.md)
\ No newline at end of file
diff --git a/docs/framework/wpf/wpf-security-strategy-security-engineering.md b/docs/framework/wpf/wpf-security-strategy-security-engineering.md
new file mode 100644
index 00000000000..2c0a17114ad
--- /dev/null
+++ b/docs/framework/wpf/wpf-security-strategy-security-engineering.md
@@ -0,0 +1,110 @@
+---
+title: "WPF のセキュリティ方針 - セキュリティ エンジニアリング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "クリティカル コード管理"
+  - "セキュリティ開発ライフサイクル (SDL), クリティカル コード管理"
+  - "セキュリティ開発ライフサイクル (SDL), セキュリティ分析"
+  - "セキュリティ開発ライフサイクル (SDL), ソース分析ツール"
+  - "セキュリティ開発ライフサイクル (SDL), ソース編集ツール"
+  - "セキュリティ開発ライフサイクル (SDL), テスト手法"
+  - "セキュリティ開発ライフサイクル (SDL), 脅威のモデリング"
+  - "セキュリティ, テスト手法"
+  - "ソース分析ツール"
+  - "ソース編集ツール"
+  - "テスト, セキュリティ"
+  - "脅威のモデリング"
+ms.assetid: 0fc04394-4e47-49ca-b0cf-8cd1161d95b9
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# WPF のセキュリティ方針 - セキュリティ エンジニアリング
+信頼できるコンピューティングは、セキュリティで保護されたコードの実稼働環境を確保するための Microsoft イニシアチブです。  信頼できるコンピューティング イニシアチブの重要な要素は、[!INCLUDE[TLA#tla_sdl](../../../includes/tlasharptla-sdl-md.md)] です。  [!INCLUDE[TLA2#tla_sdl](../../../includes/tla2sharptla-sdl-md.md)] は、セキュリティで保護されたコードの配信を容易にする標準のエンジニアリング プロセスと組み合わせて使用するエンジニアリングの方法です。  [!INCLUDE[TLA2#tla_sdl](../../../includes/tla2sharptla-sdl-md.md)] は、ベスト プラクティスと形式化、測定可能性、追加の構造を組み合わせた 10 のフェーズで構成しています。それらは次のとおりです。  
+  
+-   セキュリティ設計の分析  
+  
+-   ツール ベースの品質チェック  
+  
+-   侵入テスト  
+  
+-   最終的なセキュリティ レビュー  
+  
+-   製品のリリース後のセキュリティ管理  
+  
+## WPF 固有の仕様  
+ [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] エンジニアリング チームは、[!INCLUDE[TLA2#tla_sdl](../../../includes/tla2sharptla-sdl-md.md)] の適用と拡張の両方を行います。この組み合わせには、次の主要な側面があります。  
+  
+ [脅威モデリング](#thread_modeling)  
+  
+ [セキュリティ分析および編集ツール](#tools)  
+  
+ [テスト手法](#techniques)  
+  
+ [クリティカル コードの管理](#critical_code)  
+  
+<a name="threat_modeling"></a>   
+### 脅威モデリング  
+ 脅威モデリングは、[!INCLUDE[TLA2#tla_sdl](../../../includes/tla2sharptla-sdl-md.md)] の主要コンポーネントで、システムをプロファイリングして潜在的なセキュリティの脆弱性を判断するために使用します。  脆弱性が特定されると、脅威モデリングは、常に適切な緩和策が存在することも保証します。  
+  
+ 概略でとらえれば、食料品店を例にすると、脅威モデリングには次の主要な手順が含まれます。  
+  
+1.  **資産の特定**。  食料品店の資産には、従業員、安全、レジ、および在庫などがあります。  
+  
+2.  **エントリ ポイントの列挙**。  食料品店のエントリ ポイントには、玄関と裏口、窓、搬入口、および空調装置などがあります。  
+  
+3.  **エントリ ポイントを使用した資産に対する攻撃の調査**。  可能性のある攻撃の 1 つは、*空調設備* エントリ ポイントを通じた食料品店の*安全*資産をターゲットとするものです。空調装置は、ねじが緩められて、そこから安全が店の外に引き出される可能性があります。  
+  
+ 脅威モデリングは [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] 全体に適用されます。それは次のとおりです。  
+  
+-   [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] パーサーのファイルの読み取り方法、対応するオブジェクト モデルのクラスへのテキストのマッピング方法、および実際のコードの作成方法。  
+  
+-   ウィンドウ ハンドル \(hWnd\) の作成方法、メッセージの送信方法、hWnd を使用したウィンドウの内容の表示方法。  
+  
+-   データ バインドがリソースを取得し、システムと対話する方法。  
+  
+ これらの脅威モデリングは、開発プロセス中のセキュリティ設計要件の識別と脅威の緩和策にとって重要です。  
+  
+<a name="tools"></a>   
+### ソースの分析および編集ツール  
+ [!INCLUDE[TLA2#tla_sdl](../../../includes/tla2sharptla-sdl-md.md)] の手動セキュリティ コード レビュー要素に加えて、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] チームは、ソースの分析と関連する編集のためのいくつかのツールを使用してセキュリティの脆弱性を低減します。  さまざまなソースのツールを使用できます。それらは次のとおりです。  
+  
+-   **FXCop**: アンマネージ コードを安全に相互運用する方法について、継承ルールからコード アクセス セキュリティの使用法までの範囲に及ぶ、マネージ コードの一般的なセキュリティの問題を検出します。  「[FXCop](http://www.gotdotnet.com/team/fxcop/)」を参照してください。  
+  
+-   **Prefix\/Prefast**: バッファー オーバーラン、書式設定文字列の問題、エラー チェックなどのアンマネージ コードのセキュリティの脆弱性および一般的なセキュリティの問題を検出します。  
+  
+-   **Banned APIs**: `strcpy` などのセキュリティの問題の原因としてよく知られている関数の偶発的な使用を識別するソース コードを検索します。  そのような関数が識別されると、よりセキュリティの高い代替手段に置き換えられます。  
+  
+<a name="techniques"></a>   
+### テスト手法  
+ [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] では、さまざまなテスト手法を使用します。それらは次のとおりです。  
+  
+-   **ホワイトボックス テスト**: テスト担当者はソース コードを表示し、脆弱性攻撃のテストをビルドします。  
+  
+-   **ブラックボックス テスト**: テスト担当者は、API と機能を調査してセキュリティの悪用を検出してから、製品を攻撃することを試みます。  
+  
+-   **他の製品からのセキュリティの問題の回帰**: 該当する場合、関連する製品からのセキュリティの問題がテストされます。  たとえば、[!INCLUDE[TLA2#tla_ie](../../../includes/tla2sharptla-ie-md.md)] の約 60 のセキュリティの問題に適した変種を特定して、それが [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] に適用できるかどうかを試します。  
+  
+-   **ファイルのファジー テストを通じたツール ベースの侵入テスト**: ファイルのファジー テストでは、さまざまな入力からファイル リーダーの入力範囲を利用します。  この手法が使用される [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] の一例は、イメージ デコード コードでエラーを確認することです。  
+  
+<a name="critical_code"></a>   
+### クリティカル コードの管理  
+ [!INCLUDE[TLA#tla_xbap#plural](../../../includes/tlasharptla-xbapsharpplural-md.md)] の場合、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] は、特権を昇格させるセキュリティ クリティカルなコードをマークおよび追跡するために、[!INCLUDE[TLA2#tla_winfx](../../../includes/tla2sharptla-winfx-md.md)] のサポートを使用してセキュリティ サンドボックスをビルドします。\(「[WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)」の「**セキュリティ クリティカルな手法**」を参照してください\)。  セキュリティ クリティカルなコードに対して高度なセキュリティの品質要件を指定すると、このようなコードは、追加レベルのソース管理の制御とセキュリティの監査を受けします。  [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] の約 5 ～ 10% はセキュリティ クリティカルなコードで構成され、専用のレビュー チームによって確認されます。  ソース コードとチェックイン プロセスは、セキュリティ クリティカルなコードを追跡し、各クリティカル エンティティ \(つまり  重要なコードを含むメソッド\) をマップしてサイン オフ状態にすることで管理されています。  サイン オフ状態には、1 つ以上のレビュー担当者の名前が含まれています。  毎日の [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] のビルドは、前のビルドのクリティカル コードと比較されて、承認されていない変更がチェックされます。  エンジニアがレビュー チームからの承認を得ずにクリティカル コードを変更すると、そのクリティカル コードはすぐに識別および修正されます。  このプロセスでは、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] サンドボックス コードで特に高いレベルの監視の適用と維持が可能になります。  
+  
+## 参照  
+ [セキュリティ](../../../docs/framework/wpf/security-wpf.md)   
+ [WPF 部分信頼セキュリティ](../../../docs/framework/wpf/wpf-partial-trust-security.md)   
+ [WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)   
+ [信頼できるコンピューティング](http://www.microsoft.com/mscorp/twc/default.mspx)   
+ [アプリケーションの脅威モデリング](http://msdn.microsoft.com/security/securecode/threatmodeling/acetm/)   
+ [Microsoft API とリファレンスのカタログ](http://msdn.microsoft.com/library/default.asp?url=/library/dnpag2/html/PAGGuidelines0003.asp)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/TOC.md b/docs/framework/xaml-services/TOC.md
new file mode 100644
index 00000000000..6deb26d6cd7
--- /dev/null
+++ b/docs/framework/xaml-services/TOC.md
@@ -0,0 +1,45 @@
+# [XAML 2009 Language Features](xaml-2009-language-features.md)
+# [x:ClassModifier Directive](x-classmodifier-directive.md)
+# [x:FieldModifier Directive](x-fieldmodifier-directive.md)
+# [XAML Namespaces](xaml-namespaces-for-net-framework-xaml-services.md)
+# [XAML Namespace (x:) Language Features](xaml-namespace-x-language-features.md)
+# [x:Type Markup Extension](x-type-markup-extension.md)
+# [Type Converters and Markup Extensions for XAML](type-converters-and-markup-extensions-for-xaml.md)
+# [Types Migrated from WPF to System.Xaml](types-migrated-from-wpf-to-system-xaml.md)
+# [Whitespace Processing in XAML](whitespace-processing-in-xaml.md)
+# [x:Shared Attribute](x-shared-attribute.md)
+# [x:Array Markup Extension](x-array-markup-extension.md)
+# [Defining Custom Types for Use with .NET Framework XAML Services](defining-custom-types-for-use-with-net-framework-xaml-services.md)
+# [x:Class Directive](x-class-directive.md)
+# [x:Name Directive](x-name-directive.md)
+# [Service Contexts Available to Type Converters and Markup Extensions](service-contexts-available-to-type-converters-and-markup-extensions.md)
+# [x:Subclass Directive](x-subclass-directive.md)
+# [x:Arguments Directive](x-arguments-directive.md)
+# [x:Code Intrinsic XAML Type](x-code-intrinsic-xaml-type.md)
+# [x:TypeArguments Directive](x-typearguments-directive.md)
+# [Generics in XAML](generics-in-xaml.md)
+# [x:FactoryMethod Directive](x-factorymethod-directive.md)
+# [x:Uid Directive](x-uid-directive.md)
+# [x:XData Intrinsic XAML Type](x-xdata-intrinsic-xaml-type.md)
+# [Understanding XAML Node Stream Structures and Concepts](understanding-xaml-node-stream-structures-and-concepts.md)
+# [xml:lang Handling in XAML](xml-lang-handling-in-xaml.md)
+# [XAMLServices Class and Basic XAML Reading or Writing](xamlservices-class-and-basic-xaml-reading-or-writing.md)
+# [XML Character Entities and XAML](xml-character-entities-and-xaml.md)
+# [x:Property Directive](x-property-directive.md)
+# [xml:space Handling in XAML](xml-space-handling-in-xaml.md)
+# [XAML-Related CLR Attributes for Custom Types and Libraries](xaml-related-clr-attributes-for-custom-types-and-libraries.md)
+# [Collections and Collection Types for XAML](collections-and-collection-types-for-xaml.md)
+# [XAML Security Considerations](xaml-security-considerations.md)
+# [Type Converters for XAML Overview](type-converters-for-xaml-overview.md)
+# [x:Member Directive](x-member-directive.md)
+# [{} Escape Sequence / Markup Extension](escape-sequence-markup-extension.md)
+# [x:Null Markup Extension](x-null-markup-extension.md)
+# [x:Reference Markup Extension](x-reference-markup-extension.md)
+# [Markup Extensions for XAML Overview](markup-extensions-for-xaml-overview.md)
+# [x:Key Directive](x-key-directive.md)
+# [x:Members Directive](x-members-directive.md)
+# [XamlName の文法](xamlname-grammar.md)
+# [Built-in Types for Common XAML Language Primitives](built-in-types-for-common-xaml-language-primitives.md)
+# [XAML Services](index.md)
+# [x:Static Markup Extension](x-static-markup-extension.md)
+# [Default XAML Schema Context and WPF XAML Schema Context](default-xaml-schema-context-and-wpf-xaml-schema-context.md)
diff --git a/docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md b/docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md
new file mode 100644
index 00000000000..fd6ca12f7a1
--- /dev/null
+++ b/docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md
@@ -0,0 +1,137 @@
+---
+title: "Built-in Types for Common XAML Language Primitives | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML language primitives [XAML Services]"
+  - "XAML [XAML Services], built-in types"
+  - "x:String [XAML Services]"
+  - "x:TimeSpan [XAML Services]"
+  - "x:Byte [XAML Services]"
+  - "x:Double [XAML Services]"
+  - "XAML [XAML Services], types"
+  - "x:Uri [XAML Services]"
+  - "XAML built-in types [XAML Services]"
+  - "x:Int64 [XAML Services]"
+  - "x:Single [XAML Services]"
+  - "x:Int32 [XAML Services]"
+ms.assetid: 11de2f08-5b95-4989-b5ec-5178eb968184
+caps.latest.revision: 11
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Built-in Types for Common XAML Language Primitives
+XAML 2009 では、いくつかのデータ型に対する XAML 言語をサポートします。これらのデータ型は、共通言語ランタイム \(CLR: Common Language Runtime\) およびその他のプログラミング言語でよく使用されているプリミティブです。 XAML 2009 でサポートされるようになったのは、`x:Object`、`x:Boolean`、`x:Char`、`x:String`、`x:Decimal`、`x:Single`、`x:Double`、`x:Int16`、`x:Int32`、`x:Int64`、`x:TimeSpan`、`x:Uri`、`x:Byte`、および `x:Array` の各プリミティブです。  
+  
+<a name="previous_techniques_for_language_primitives_in_xaml_markup"></a>   
+## XAML マークアップの言語プリミティブにおける以前の技術  
+ 以前の WPF バージョンの XAML では、.NET Framework の CLR プリミティブ定義クラスを含むアセンブリと名前空間をマッピングすることによって、CLR 言語プリミティブを参照していました。 これらの大半は mscorlib アセンブリおよび <xref:System> 名前空間に含まれています。 たとえば、<xref:System.Int32> を使用するには、次のマッピングを宣言します \(使用例については、その後に示します\)。  
+  
+```  
+<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:sys="clr-namespace:System;assembly=mscorlib"> <Application.Resources> <sys:Int32 x:Key="intMeaning">42</sys:Int32> </Application.Resources> </Application>  
+```  
+  
+<a name="xaml_2009_language_primitives"></a>   
+## XAML 2009 言語プリミティブ  
+ 慣例により、XAML の言語プリミティブとその他すべての XAML 言語要素は、`x:` プレフィックスを含めて示されます。 XAML 言語要素は、実際のマークアップで一般的にこのように使用されます。 WPF の XAML の概念ドキュメントや XAML 仕様書でも、この規則に従っています。  
+  
+### x:Object  
+ CLR バッキングの場合は、`x:Object` プリミティブは <xref:System.Object> に対応しています。  
+  
+ このプリミティブは通常はアプリケーション マークアップでは使用されず、XAML 型システムで割り当てできるかどうかを確認する場合などに便利です。  
+  
+### x:Boolean  
+ CLR バッキングの場合は、`x:Boolean` プリミティブは <xref:System.Boolean> に対応しています。  
+  
+ XAML は、`x:Boolean` の値の大文字と小文字を区別しないで解析します。`x:Bool` は、承諾済みのプリミティブではありません。 XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.17 および 5.4.11](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Char  
+ CLR バッキングの場合は、`x:Char` プリミティブは <xref:System.Char> に対応しています。  
+  
+ 文字列型および char 型は、XML レベルでファイルの全体的なエンコーディングと相互作用しています。 XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.7 および 5.4.1](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:String  
+ CLR バッキングの場合は、`x:String` プリミティブは <xref:System.String> に対応しています。  
+  
+ 文字列型および char 型は、XML レベルでファイルの全体的なエンコーディングと相互作用しています。 XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.6](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Decimal  
+ CLR バッキングの場合は、`x:Decimal` プリミティブは <xref:System.Decimal> に対応しています。  
+  
+ XAML の解析は、本質的に `en-US` カルチャにおいて行われます。`en-US` カルチャでは、開発環境または、XAML が実行時に読み込まれる最終的なクライアント ターゲットのカルチャ設定に関係なく、小数コンポーネントの正しい区切り記号は常にピリオド \(`.`\) です。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.14 および 5.4.8](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Single  
+ CLR バッキングの場合は、`x:Single` プリミティブは <xref:System.Single> に対応しています。  
+  
+ 数値に加え、`x:Single` のテキスト構文はトークン `Infinity`、`-Infinity`、および `NaN` も許可しています。 これらのトークンは、大文字と小文字を区別します。  
+  
+ `x:Single` は、テキスト構文の最初の文字が `e` または `E` の場合は、指数表記形式の値をサポートします。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.8 および 5.4.2](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Double  
+ CLR バッキングの場合は、`x:Double` プリミティブは <xref:System.Double> に対応しています。  
+  
+ 数値に加え、`x:Double` のテキスト構文は、`Infinity`、`-Infinity`、および `NaN` の各トークンも許可しています。 これらのトークンは、大文字と小文字を区別します。  
+  
+ `x:Double` は指数表記形式の値をサポートしています。`e` または `E` という文字を使用して指数部分を示すことができます。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.9 および 5.4.3](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Int16  
+ CLR バッキングの場合は、`x:Int16` プリミティブは <xref:System.Int16> に対応し、`x:Int16` は符号付きとして処理されます。 XAML では、テキスト構文に正 \(`+`\) 符号がない場合でも、暗黙的に正符号値を示しています。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.11 および 5.4.5](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Int32  
+ CLR バッキングの場合は、`x:Int32` プリミティブは <xref:System.Int32> に対応しています。`x:Int32` は符号付きとして処理されます。 XAML では、テキスト構文に正 \(`+`\) 符号がない場合でも、暗黙的に正符号値を示しています。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.12 および 5.4.6](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Int64  
+ CLR バッキングの場合は、`x:Int64` プリミティブは <xref:System.Int64> に対応しています。`x:Int64` は符号付きとして処理されます。 XAML では、テキスト構文に正 \(`+`\) 符号がない場合でも、暗黙的に正符号値を示しています。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.13 および 5.4.7](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:TimeSpan  
+ CLR バッキングの場合は、`x:TimeSpan` プリミティブは <xref:System.TimeSpan> に対応しています。  
+  
+ XAML の時刻\-日付形式での解析は、本質的に `en-US` カルチャにおいて行われます。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.16 および 5.4.10](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Uri  
+ CLR バッキングの場合は、`x:Uri` プリミティブは <xref:System.Uri> に対応しています。  
+  
+ プロトコルのチェックは、`x:Uri` の XAML 定義の一部ではありません。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.15 および 5.4.9](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Byte  
+ CLR バッキングの場合は、`x:Byte` プリミティブは <xref:System.Byte> に対応しています。<xref:System.Byte> \/ `x:Byte` は符号なしとして扱われます。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.10 および 5.4.4](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+### x:Array  
+ CLR バッキングの場合は、`x:Array` プリミティブは <xref:System.Array> に対応しています。  
+  
+ マークアップ拡張構文を使用して配列を XAML 2006 で定義することもできますが、XAML 2009 構文は言語によって定義されたプリミティブであり、マークアップ拡張機能にアクセスする必要がありません。 XAML 2006 のサポートの詳細については、「[x:Array Markup Extension](../../../docs/framework/xaml-services/x-array-markup-extension.md)」を参照してください。  
+  
+ XAML 言語仕様の定義については、[\[MS\-XAML\] セクション 5.2.18](http://go.microsoft.com/fwlink/?LinkId=114525) を参照してください。  
+  
+<a name="wpf_support"></a>   
+## WPF のサポート  
+ WPF では XAML 2009 の機能を使用できますが、マークアップ コンパイルされていない XAML に限定されます。 WPF 向けにマークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 のキーワードと機能をサポートしていません。  
+  
+ WPF と共に XAML 2009 の機能を使用できるシナリオとして、Loose XAML を作成し、その XAML を <xref:System.Windows.Markup.XamlReader.Load%2A?displayProperty=fullName> を使用して WPF ランタイムとオブジェクト グラフに読み込む場合があります。 WPF <xref:System.Windows.Markup.XamlReader?displayProperty=fullName> およびその <xref:System.Windows.Markup.XamlReader.Load%2A> は、XAML 2009 言語キーワードおよび機能を有効なオブジェクト グラフ表現に処理することができます。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/collections-and-collection-types-for-xaml.md b/docs/framework/xaml-services/collections-and-collection-types-for-xaml.md
new file mode 100644
index 00000000000..8467d7d29be
--- /dev/null
+++ b/docs/framework/xaml-services/collections-and-collection-types-for-xaml.md
@@ -0,0 +1,52 @@
+---
+title: "Collections and Collection Types for XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 58f8e7c6-9a41-4f25-8551-c042f1315baa
+caps.latest.revision: 2
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# Collections and Collection Types for XAML
+このトピックではコレクションをサポートするように定義する必要のある親オブジェクトのプロパティ要素または要素の子要素としてコレクション項目のインスタンスを作成するための XAML 構文を説明します。型のプロパティをサポートする方法を示します。  
+  
+## XAML のコレクションの概念  
+ 概念的には複数の子項目が XAML オブジェクト要素または XAML プロパティ要素のスコープ内にある XAML のリレーションシップがコレクションとして実装する必要があります。  このコレクションはリレーションシップの親である XAML 型の特定の XAML プロパティに関連付ける必要があります。  プロパティはXAML プロセッサに対応するコレクション プロパティの新しく追加された項目にマークアップの各項目を割り当てる受け取るためコレクションである必要があります。  
+  
+ XAML 言語レベルでコレクションのサポートの必要条件が完全には定義されていません。  コレクションが一覧になるかまたはディクショナリ \(ただしXAML 言語レベルの両方で\) が定義されているバッキング型を表す概念はXAML 言語にリストまたはディクショナリ定義されません。  
+  
+ .NET Framework XAML サービスではXAML のコレクションをサポートする概念は.NET Framework のバッキング型の点でより明確に定義されます。  具体的にはコレクションの XAML はリストおよびディクショナリの .NET Framework プログラミングに対して一般的に使用される API と .NET Framework の複数の概念に基づいています。  
+  
+1.  <xref:System.Collections.IList> インターフェイスはコレクションの一覧を示します。  
+  
+2.  <xref:System.Collections.IDictionary> のインターフェイスは dicionary コレクションを示しています。  
+  
+3.  <xref:System.Array> は配列と配列の <xref:System.Collections.IList> のメソッドを表します。  
+  
+ これらのコレクションの概念にはそれぞれ.NET Framework XAML サービスの XAML プロセッサはコレクション プロパティの型のインスタンスに `Add` のメソッドを呼び出そうとします。  またはシリアル化の場合XAML プロセッサは各コレクションの項目 「」の概念に基づいた辞書リストまたは配列内で検索項目ごとに別個の XAML 型のインスタンスを生成します。  これらは次のとおりです : <xref:System.Collections.IList.Item%2A>; <xref:System.Collections.IDictionary.Item%2A>; <xref:System.Array> の明示 <xref:System.Array.System%23Collections%23IList%23Item%2A>。  
+  
+## ジェネリック コレクション  
+ ジェネリック コレクションをプログラミングする通常の場合.NET Framework 便利でありXAML のコレクション プロパティに使用できます。  ただしジェネリック インターフェイス <xref:System.Collections.Generic.IList%601> と <xref:System.Collections.Generic.IDictionary%602> が指定されて <xref:System.Collections.IList> または非ジェネリック <xref:System.Collections.IDictionary> と同等として .NET Framework XAML サービスの XAML プロセッサによって。  インターフェイスを実装するのではなくジェネリック コレクション型のプロパティの推奨される方法はクラス <xref:System.Collections.Generic.List%601> または <xref:System.Collections.Generic.Dictionary%602> から派生させることです。  これらのクラスは非ジェネリック インターフェイスを実装し基本の実装として XAML のコレクションに対して予期されるサポートが含まれます。  
+  
+## 読み取り専用コレクションと初期化ロジック  
+ .NET Framework プログラミングでは読み取り専用コレクションとしてコレクションの値を保持するプロパティを生成する一般的なデザイン パターンです。  このパターンの割り当ての動作を制御するコレクションに改善するためにコレクション プロパティを所有するインスタンス。  具体的にはパターンはプロパティを設定すると既存のコレクションの誤ったを置換します。  このパターンでは呼び出し元によってコレクションに対するアクセスが <xref:System.Collections.IList> などのコレクション型やインターフェイスに関連するコレクションをサポートするように呼び出し元のメソッドやプロパティの代わりにを使用して行う必要があります。  
+  
+ このパターンを使用して読み取り専用コレクションのプロパティを公開する空のコレクションを保持するクラスは最初にそのプロパティを初期化する必要があります。  通常初期化はクラスのコンストラクターの動作の一部として実行されます。  XAML のプロパティを処理する前に既定のコンストラクターを呼び出すためこのようなロジックは既定のコンストラクターによって常に参照するよう XAML に役立つことが重要でコレクション プロパティ \(またはそのほか\)。  
+  
+## XAML 型システムのサポートおよびコレクション  
+ XAML の基本メカニズムに解析しコレクション プロパティを設定するかシリアル化.NET Framework XAML サービスで実装される XAML 型システムはXAML のコレクションに関するさまざまな設計できますが含まれています。  
+  
+1.  <xref:System.Xaml.XamlType.IsCollection%2A> はXAML の型が XAML のコレクションをサポートする型によってサポートされている場合は true を返します。  
+  
+2.  コレクション モード XAML 型のサポート <xref:System.Xaml.XamlType.IsDictionary%2A> と <xref:System.Xaml.XamlType.IsArray%2A> では識別できます。  .NET Framework XAML サービスおよびその XAML 型システムに基づいていますが<xref:System.Xaml.XamlWriter> の実装に基づいていないカスタム XAML プロセッサの場合コレクション モードを使用するかはコレクションの処理を開始するためにメソッドを知る必要がある場合があります。  
+  
+3.  前のプロパティ値にはXAML 型の <xref:System.Xaml.XamlType.LookupCollectionKind%2A> のオーバーライドにでも影響を受けます。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/default-xaml-schema-context-and-wpf-xaml-schema-context.md b/docs/framework/xaml-services/default-xaml-schema-context-and-wpf-xaml-schema-context.md
new file mode 100644
index 00000000000..b3a62fc928b
--- /dev/null
+++ b/docs/framework/xaml-services/default-xaml-schema-context-and-wpf-xaml-schema-context.md
@@ -0,0 +1,99 @@
+---
+title: "Default XAML Schema Context and WPF XAML Schema Context | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 04e06a15-09b3-4210-9bdf-9a64c2eccb83
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Default XAML Schema Context and WPF XAML Schema Context
+XAML スキーマ コンテキストは、型の対応付けの解決方法、アセンブリの読み込み方法、特定のリーダーとライターの設定を解釈する方法など、特定の XAML ボキャブラリを使用する XAML 稼働環境がオブジェクトの書き込み動作を操作する方法を修飾する、概念上のエンティティです。  ここでは、.NET Framework XAML サービスの機能と、関連付けられている既定の XAML スキーマ コンテキスト \(CLR 型システムに基づく\) について説明します。  また、WPF で使用される XAML スキーマ コンテキストについても説明します。  
+  
+## 既定の XAML スキーマ コンテキスト  
+ .NET Framework XAML サービスは、既定の XAML スキーマ コンテキストを実装して使用します。  既定の XAML スキーマ コンテキストの動作は、<xref:System.Xaml.XamlSchemaContext> クラスの API で必ずしも完全に確認できるわけではありません。  ただし、多くの場合、既定の XAML スキーマ コンテキストの影響を受ける動作は、<xref:System.Xaml.XamlMember> や <xref:System.Xaml.XamlType> のメンバーなど、XAML 型システムの共通 API や、既定の XAML スキーマ コンテキストを使用する XAML リーダーと XAML ライターで公開される API を通じて確認できます。  
+  
+ <xref:System.Xaml.XamlSchemaContext> コンストラクターを呼び出して、既定の動作をカプセル化する <xref:System.Xaml.XamlSchemaContext> を作成できます。  これにより、既定の XAML スキーマ コンテキストが明示的に作成されます。  <xref:System.Xaml.XamlSchemaContext> 入力パラメーターを明示的に受け取らない API を使用して XAML リーダーまたは XAML ライターを初期化した場合は、同じ既定の XAML スキーマ コンテキストが暗黙的に作成されます。  
+  
+ 既定の XAML スキーマ コンテキストは、型の対応付け動作について CLR リフレクションに依存します。  これには、CLR <xref:System.Type>、および関連する <xref:System.Reflection.PropertyInfo> または <xref:System.Reflection.MethodInfo> の定義の検証が含まれます。  また、型またはメンバーの CLR 属性は、CLR バッキング型を使用する XAML 型または XAML メンバー情報の詳細を指定するために使用されます。  既定の XAML スキーマ コンテキストには、`Invoker` パターンをはじめとする型システム拡張手法は必要ありません。CLR 型システムから必要な情報を得られるためです。  
+  
+ アセンブリ読み込みロジックの場合、既定の XAML スキーマ コンテキストは、主に XAML 名前空間のマッピングで提供されるアセンブリ値に依存します。  また、内部型の読み込みなどのシナリオでは、読み込むアセンブリを <xref:System.Xaml.XamlReaderSettings.LocalAssembly%2A> が示します。  
+  
+## WPF XAML スキーマ コンテキスト  
+ WPF の実装は、既定以外の XAML スキーマ コンテキストの実装により導入できるタイプの機能を示すうえで興味深いテーマであるため、WPF XAML スキーマ コンテキストについてはこのトピックで説明します。  また、XAML スキーマ コンテキストの概念は、WPF XAML に関する WPF のドキュメントではあまり詳しく説明されていません。XAML スキーマ コンテキストが実現する動作は、既定の XAML スキーマ コンテキストの動作と共に説明しなければ、十分に理解できない可能性があります。  WPF XAML スキーマ コンテキストは、次の動作を実装します。  
+  
+ **検索のオーバーライド:** WPF には、XAML 向けのコンテンツ モデルがいくつか存在します。これらのモデルでは、<xref:System.Windows.Markup.ContentPropertyAttribute> 属性がなくても機能する XAML コンテンツ プロパティが使用されます。  WPF の <xref:System.Xaml.XamlType.LookupContentProperty%2A> のオーバーライドがこの動作を実装します。  
+  
+ **WPF 式の遅延:** WPF には、ランタイム コンテキストが使用できるようになるまで値を遅延させる式クラスがいくつかあります。  また、テンプレートの拡張は遅延手法に依存するランタイム動作です。  
+  
+ **型システムの検索の最適化:** WPF には、WPF で定義されている何百ものクラスに継承される基本クラス メンバーの定義など、幅広い XAML ボキャブラリとオブジェクト モデルがあります。  また、WPF 自体も複数のアセンブリにまたがります。  WPF では、ルックアップ テーブルなどの手法を使用して型検索が最適化されます。  その結果、既定の XAML スキーマ コンテキストとその CLR ベースの型検索よりもパフォーマンスが向上します。  型がルックアップ テーブルに存在しない場合は、既定の XAML スキーマ コンテキストに似た XAML スキーマ コンテキストの手法が使用されます。  
+  
+ **XamlType および XamlMember の拡張:** WPF では、依存関係プロパティによりプロパティの概念が拡張され、ルーティング イベントによりイベントの概念が拡張されています。  XAML 処理操作に対するこれらの概念の可視性を高めるために、WPF では <xref:System.Xaml.XamlType> と <xref:System.Xaml.XamlMember> が拡張され、依存関係プロパティとルーティング イベントの特性を報告する内部プロパティが追加されています。  
+  
+### WPF XAML スキーマ コンテキストへのアクセス  
+ WPF <xref:System.Windows.Markup.XamlReader?displayProperty=fullName> または <xref:System.Windows.Markup.XamlWriter?displayProperty=fullName> に基づく XAML 手法を使用している場合、それらの XAML リーダーと XAML ライターの実装で WPF XAML スキーマ コンテキストが既に使用されています。  
+  
+ WPF XAML スキーマ コンテキストを使用して初期化しないその他の XAML リーダーまたは XAML ライターの実装を使用している場合は、有効な WPF XAML スキーマ コンテキストを <xref:System.Windows.Markup.XamlReader.GetWpfSchemaContext%2A?displayProperty=fullName> から入手できます。  そのうえで、<xref:System.Xaml.XamlSchemaContext> を使用する他の API の初期化としてこの値を使用できます。  たとえば、初期化のために <xref:System.Xaml.XamlXmlReader.%23ctor%2A> を呼び出し、WPF XAML スキーマ コンテキストを渡すことができます。  または、XAML 型システムの操作のために WPF XAML スキーマ コンテキストを使用することもできます。  これには、<xref:System.Xaml.XamlType> または <xref:System.Xaml.XamlMember> の構造初期化、または <xref:System.Xaml.XamlSchemaContext.GetXamlType%2A?displayProperty=fullName> の呼び出しが含まれます。  
+  
+ 純粋な XAML ノード ストリーム パースペクティブから WPF XAML の特定の要素にアクセスした場合、一部の WPF フレームワーク機能は動作していない可能性があります。  たとえば、コントロールの WPF テンプレートはまだ適用されていません。  したがって、実行時にビジュアル ツリー全体が設定されるプロパティにアクセスする場合は、テンプレートを参照するプロパティ値だけが表示される可能性があります。  WPF マークアップ拡張機能向けのサービス コンテキストも、実行時以外の状況で提供された場合は正確ではない場合があり、オブジェクト グラフを書き込もうとしたときに例外が発生する可能性があります。  
+  
+## XAML およびアセンブリの読み込み  
+ XAML および .NET Framework XAML サービスのアセンブリの読み込みは、CLR で定義された <xref:System.AppDomain> の概念と統合されています。  XAML スキーマ コンテキストでは、<xref:System.AppDomain> およびその他の要素の使用に基づいて、実行時またはデザイン時にアセンブリの読み込みまたは型の検索を行う方法を解釈します。  XAML が XAML リーダーの Loose XAML であるか、`XamlBuildTask` によって DLL にコンパイルされる XAML であるか、WPF の `PresentationBuildTask` によって生成される BAML であるかによって、ロジックは若干異なります。  
+  
+ WPF の XAML スキーマ コンテキストは WPF アプリケーション モデルと統合され、<xref:System.AppDomain> や、WPF の実装の詳細である他の要素を使用します。  
+  
+#### XAML リーダーの入力 \(Loose XAML\)  
+  
+1.  XAML スキーマ コンテキストは、アプリケーションの <xref:System.AppDomain> を反復処理して、名前のすべての要素が一致する読み込み済みのアセンブリを、最も新しく読み込まれたアセンブリから順に検索します。  一致するアセンブリが見つかった場合、そのアセンブリが解決に使用されます。  
+  
+2.  一致するアセンブリが見つからなかった場合は、CLR <xref:System.Reflection.Assembly> API に基づく次の手法を使用してアセンブリが読み込まれます。  
+  
+    -   マッピングで名前が修飾されている場合は、修飾名で <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+    -   前の手順に失敗した場合は、短い名前と公開キー トークン \(存在する場合\) を使用して <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+    -   マッピングで名前が修飾されていない場合は、<xref:System.Reflection.Assembly.LoadWithPartialName%2A?displayProperty=fullName> を呼び出します。  
+  
+#### XamlBuildTask  
+ `XamlBuildTask` は、[!INCLUDE[vsindigo](../../../includes/vsindigo-md.md)] と [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] で使用されます。  
+  
+ `XamlBuildTask` を通じたアセンブリ参照は、常に完全に修飾されます。  
+  
+1.  修飾名で <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+2.  前の手順に失敗した場合は、短い名前と公開キー トークン \(存在する場合\) を使用して <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+#### BAML \(PresentationBuildTask\)  
+ BAML のアセンブリ読み込みには、BAML をコンポーネントとして内包する初期アセンブリの読み込みと、BAML 稼働環境で参照される任意の型の型バッキング アセンブリの読み込みという 2 つの側面があります。  
+  
+##### 初期マークアップのアセンブリ読み込み:  
+ マークアップの読み込み元アセンブリへの参照は、常に修飾されません。  
+  
+1.  WPF XAML スキーマ コンテキストは、WPF アプリケーションの <xref:System.AppDomain> を反復処理して、名前のすべての要素が一致する読み込み済みのアセンブリを、最も新しく読み込まれたアセンブリから順に検索します。  一致するアセンブリが見つかった場合、そのアセンブリが解決に使用されます。  
+  
+2.  前の手順に失敗した場合は、短い名前と公開キー トークン \(存在する場合\) を使用して <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+##### BAML 型によるアセンブリ参照:  
+ BAML 稼働環境で使用される型のアセンブリ参照は、ビルド タスクの出力として常に完全に修飾されます。  
+  
+1.  WPF XAML スキーマ コンテキストは、WPF アプリケーションの <xref:System.AppDomain> を反復処理して、名前のすべての要素が一致する読み込み済みのアセンブリを、最も新しく読み込まれたアセンブリから順に検索します。  一致するアセンブリが見つかった場合、そのアセンブリが解決に使用されます。  
+  
+2.  一致するアセンブリが見つからなかった場合は、アセンブリの読み込みに次のいずれかの手法を使用します。  
+  
+    -   修飾名で <xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+    -   短い名前と公開キー トークンの組み合わせが、BAML の読み込み元であるアセンブリに一致する場合は、そのアセンブリを使用します。  
+  
+    -   短い名前と公開キー トークンを使用して、<xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> を呼び出します。  
+  
+## 参照  
+ [Understanding XAML Node Stream Structures and Concepts](../../../docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/defining-custom-types-for-use-with-net-framework-xaml-services.md b/docs/framework/xaml-services/defining-custom-types-for-use-with-net-framework-xaml-services.md
new file mode 100644
index 00000000000..3522a310b3d
--- /dev/null
+++ b/docs/framework/xaml-services/defining-custom-types-for-use-with-net-framework-xaml-services.md
@@ -0,0 +1,126 @@
+---
+title: "Defining Custom Types for Use with .NET Framework XAML Services | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "defining custom types [XAML Services]"
+ms.assetid: c2667cbd-2f46-4a7f-9dfc-53696e35e8e4
+caps.latest.revision: 11
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Defining Custom Types for Use with .NET Framework XAML Services
+ビジネス オブジェクトに相当するカスタム型を定義する場合や、特定のフレームワークに依存しない型を定義する場合にも、XAML のベスト プラクティスに従って確実に対応できます。  このベスト プラクティスに従った場合、.NET Framework XAML サービスとその XAML リーダーおよび XAML ライターでは、型の XAML 特性を検出し、XAML 型システムに基づいて XAML ノード ストリームで適切に表現できます。  ここでは、型定義のベスト プラクティスと、型またはメンバーの CLR 属性の設定について説明します。  
+  
+## XAML のコンストラクター パターンと型定義  
+ XAML でカスタム クラスをオブジェクト要素としてインスタンス化できるようにするには、次の要件が満たされている必要があります。  
+  
+-   カスタム クラスがパブリックであり、既定の \(パラメーターなしの\) パブリック コンストラクターが公開されている必要がある。  \(構造体に関する説明は次のセクションを参照してください\)。  
+  
+-   カスタム クラスが入れ子になっていない。  完全パス名に "ドット" を追加すると、クラスと名前空間の区分があいまいになり、添付プロパティなど、他の XAML 機能に干渉します。  
+  
+ オブジェクトをオブジェクト要素としてインスタンス化できる場合、作成したオブジェクトで、そのオブジェクトを基になる型として受け取る任意のプロパティのプロパティ要素形式を読み込むことができます。  
+  
+ 値コンバーターを有効にした場合、これらの条件を満たしていない型のオブジェクト値を指定できます。  詳細については、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」を参照してください。  
+  
+### 構造体  
+ 構造体は常に CLR 定義に基づいて XAML で構築できます。  これは、CLR コンパイラによって構造体の既定のコンストラクターが暗黙的に作成されることに起因します。  このコンストラクターは、すべてのプロパティ値を既定値に初期化します。  
+  
+ 構造体の既定のコンストラクターの動作が望ましくない場合もあります。  これは、構造体が値の入力を目的として、概念上は共用体として機能することに起因すると考えられます。  共用体では、格納されている値は同時には解釈されず、結果として、そのプロパティを設定できなくなる可能性があります。  WPF の語彙では、このような構造体の例に該当するのは <xref:System.Windows.GridLength> です。  このような構造体には、型コンバーターを実装して、構造体の値の異なる解釈やモードを設定する文字列の規則に基づき、値を属性形式で表示できるようにする必要があります。  この構造体では、コード構築が既定以外のコンストラクターによって行われる場合にも、同じ動作が見られると考えられます。  
+  
+### インターフェイス  
+ インターフェイスは、メンバーの基になる型として使用できます。  XAML 型システムでは、割り当て可能なリストがチェックされ、値として提供されたオブジェクトをインターフェイスに割り当てできると想定しています。  関連する割り当て可能な型で XAML の作成要件がサポートされている限り、インターフェイスを XAML 型として表現する方法を考慮する必要はありません。  
+  
+### ファクトリ メソッド  
+ ファクトリ メソッドは XAML 2009 の機能であり、  オブジェクトには既定のコンストラクターを設定する必要があるという XAML の原則に修正を加えます。  ここでは、ファクトリ メソッドの詳細については説明しません。  「[x:FactoryMethod Directive](../../../docs/framework/xaml-services/x-factorymethod-directive.md)」を参照してください。  
+  
+## 列挙型  
+ 列挙型には、XAML のネイティブ型変換の動作が設定されています。  XAML で指定した列挙定数の名前は、基になる列挙型に対して解決され、列挙値が XAML オブジェクト ライターに返されます。  
+  
+ XAML では、<xref:System.FlagsAttribute> を適用した列挙型のフラグ スタイルの使用方法をサポートしています。  詳細については、「[XAML 構文の詳細](../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください   \(「[XAML 構文の詳細](../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」は WPF のユーザー向けに記述されていますが、このトピックの情報のほとんどは XAML に関連しており、特定の実装フレームワークには依存していません\)。  
+  
+## メンバー定義  
+ 型では、XAML の使用方法のメンバーを定義できます。  特定の型が XAML 対応でない場合でも、型で XAML 対応のメンバーを定義できます。  これは、CLR の継承によって可能になります。  メンバーを継承する一部の型で型としての XAML の使用方法をサポートし、基になる型の XAML の使用方法をそのメンバーがサポートしているか、そのメンバーでネイティブな XAML 構文を使用できる限り、そのメンバーは XAML 対応のメンバーです。  
+  
+### プロパティ  
+ 一般的な CLR `get` アクセサー パターンと `set` アクセサー パターン、および言語に応じたキーワードを使用してプロパティをパブリックな CLR プロパティとして定義する場合、XAML 型システムでは、<xref:System.Xaml.XamlMember.IsReadPublic%2A> や <xref:System.Xaml.XamlMember.IsWritePublic%2A> など、<xref:System.Xaml.XamlMember> プロパティに提供された適切な情報により、プロパティをメンバーとして報告できます。  
+  
+ 特定のプロパティでは、<xref:System.ComponentModel.TypeConverterAttribute> を適用することで、テキスト構文を有効にできます。  詳細については、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」を参照してください。  
+  
+ テキスト構文やネイティブな XAML 変換が存在せず、マークアップ拡張機能の使用などの間接指定も存在しない場合、プロパティの型 \(XAML 型システムでは <xref:System.Xaml.XamlMember.TargetType%2A>\) でターゲット型を CLR 型として扱うことで、XAML オブジェクト ライターにインスタンスを返すことができる必要があります。  
+  
+ XAML 2009 を使用する場合、前述の項目が考慮されていない状況でも、型定義よりも使用方法に問題があるときは、値を提供する目的で [x:Reference Markup Extension](../../../docs/framework/xaml-services/x-reference-markup-extension.md) を使用できます。  
+  
+### イベント  
+ パブリックな CLR イベントとしてイベントを定義する場合、XAML 型システムでは、<xref:System.Xaml.XamlMember.IsEvent%2A> を `true` に設定して、イベントをメンバーとして報告できます。  イベント ハンドラーの記述は .NET Framework XAML サービスの機能の範囲外であり、特定のフレームワークや実装で行われます。  
+  
+### メソッド  
+ メソッドのインライン コードは、既定の XAML 機能ではありません。  ほとんどの場合、XAML からメンバーを直接参照することはなく、XAML でのメソッドの役割は特定の XAML パターンに対するサポートを提供することに限定されます。  [x:FactoryMethod Directive](../../../docs/framework/xaml-services/x-factorymethod-directive.md) は例外です。  
+  
+### フィールド  
+ CLR の設計ガイドラインでは、非静的フィールドは推奨されていません。  静的フィールドでは、[x:Static Markup Extension](../../../docs/framework/xaml-services/x-static-markup-extension.md) を介した場合にのみ、静的フィールド値にアクセスできます。この場合、[x:Static](../../../docs/framework/xaml-services/x-static-markup-extension.md) の使用に対してフィールドを公開するために、CLR の定義で特別な対応を行う必要はありません。  
+  
+## アタッチ可能なメンバー  
+ アタッチ可能なメンバーは、定義元の型のアクセサー メソッド パターンを介して XAML に公開されます。  定義元の型自体は、XAML 対応のオブジェクトである必要はありません。  実際には、アタッチ可能なメンバーを所有し、関連の動作を実装するが、UI 表現などのその他の機能を提供しないサービス クラスを宣言するというのが一般的なパターンです。  以降では、プレースホルダー *PropertyName* は、アタッチ可能なメンバーの名前を表します。  この名前は、[XamlName の文法](../../../docs/framework/xaml-services/xamlname-grammar.md) で有効である必要があります。  
+  
+ 型の各パターンおよびその他のメソッドの間では、名前の衝突に注意してください。  いずれかのパターンに一致するメンバーが存在する場合、開発者の意図に関係なく、XAML プロセッサによってアタッチ可能なメンバーの使用経路として解釈される場合があります。  
+  
+#### GetPropertyName アクセサー  
+ `Get` *PropertyName* アクセサーのシグネチャの形式は次のとおりです。  
+  
+ `public static object Get` *PropertyName* `(object`  `target` `)`  
+  
+-   `target` オブジェクトは、実装内で具体的な型として指定できます。  これにより、アタッチ可能なメンバーの使用方法にスコープを設定できます。意図したスコープ外の使用方法では無効なキャスト例外がスローされ、XAML 解析エラーとして通知されます。  パラメーター名 `target` は必須ではありませんが、ほとんどの実装で慣例により、`target` という名前が付けられます。  
+  
+-   戻り値は、実装内で具体的な型として指定できます。  
+  
+ アタッチ可能なメンバーの属性の使用方法で <xref:System.ComponentModel.TypeConverter> 対応のテキスト構文をサポートするには、<xref:System.ComponentModel.TypeConverterAttribute> を `Get`*PropertyName* アクセサーに適用します。  `set` ではなく `get` に適用する方法では、複雑になる場合があります。ただし、この規則では、シリアル化に対応する読み取り専用のアタッチ可能なメンバーをサポートできるので、デザイナーのシナリオによっては役立つ場合があります。  
+  
+#### SetPropertyName アクセサー  
+ Set*PropertyName* アクセサーのシグネチャの形式は次のとおりです。  
+  
+ `public static void Set` *PropertyName* `(object`  `target` `, object`  `value` `)`  
+  
+-   `target` オブジェクトは、前のセクションで説明した同じロジックと結果に基づいて、実際の実装ではさらに詳細な型として指定できます。  
+  
+-   `value` オブジェクトは、実装の中で具体的な型として指定できます。  
+  
+ このメソッドの値は、XAML の使用方法から派生した、通常は属性形式の入力であることに注意してください。  属性形式では、テキスト構文に対する値コンバーターのサポートが必要であり、`Get`*PropertyName* アクセサーに属性を追加します。  
+  
+### アタッチ可能なメンバー ストア  
+ アクセサー メソッドは、一般に、アタッチ可能なメンバー値をオブジェクト グラフに配置したり、オブジェクト グラフから値を取得して適切にシリアル化したりする手段としては、十分ではありません。  この機能を提供するには、前のアクセサー シグネチャの `target` オブジェクトが値を格納できる必要があります。  ストレージ機構は、アタッチ可能なメンバーの原則 \(アタッチ可能なメンバーがメンバー リストに含まれていないターゲットに、メンバーをアタッチできる\) に準拠している必要があります。  .NET Framework XAML サービスでは、API の <xref:System.Xaml.IAttachedPropertyStore> と <xref:System.Xaml.AttachablePropertyServices> を使用して、アタッチ可能なメンバー ストアの実装手法を利用できます。  <xref:System.Xaml.IAttachedPropertyStore> は、XAML ライターがストアの実装を検出するために使用します。これは、アクセサーの `target` に相当する型で実装する必要があります。  静的 <xref:System.Xaml.AttachablePropertyServices> API は、アクセサーの本体で使用され、アタッチ可能なメンバーをその <xref:System.Xaml.AttachableMemberIdentifier> で参照します。  
+  
+## XAML 関連の CLR 属性  
+ XAML 型システム情報を .NET Framework XAML サービスに報告するために、型、メンバー、およびアセンブリに属性を適切に設定することが重要です。  これは、.NET Framework XAML サービスの XAML リーダーおよび XAML ライターにより直接 XAML システムで型を使用する場合と、同じく XAML リーダーおよび XAML ライターにより XAML でフレームワークを定義または使用する場合のどちらにも関連します。  
+  
+ カスタム型の XAML サポートに関連する XAML 関連の各属性のリストについては、「[XAML\-Related CLR Attributes for Custom Types and Libraries](../../../docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md)」を参照してください。  
+  
+## 使用方法  
+ カスタム型を使用する場合、マークアップ作成者がアセンブリのプレフィックスと、カスタム型を含む CLR 名前空間をマッピングする必要があります。  ここでは、その具体的な手順については説明しません。  
+  
+## アクセス レベル  
+ XAML では、アクセス レベルが `internal` である型を読み込んでインスタンス化できます。  この機能は、ユーザー コードで独自の型を定義し、同じユーザー コード スコープの一部でもあるマークアップからこれらのクラスをインスタンス化できるようにするためのものです。  
+  
+ WPF では、アクセス レベルが `public` であるサポート クラスの宣言によって暗示される可能性のある拡張機構の一部としてではなく、UI 動作をリファクタリングするための <xref:System.Windows.Controls.UserControl> をユーザー コードで定義します。  こうした <xref:System.Windows.Controls.UserControl> は、バッキング コードが同じアセンブリ \(ここから XAML 型として参照\) にコンパイルされる場合は `internal` アクセスを使用して宣言できます。  
+  
+ 完全な信頼で XAML を読み込み、<xref:System.Xaml.XamlObjectWriter> を使用するアプリケーションの場合、アクセス レベルが `internal` であるクラスの読み込みは常に有効です。  
+  
+ 部分信頼で XAML を読み込むアプリケーションの場合は、<xref:System.Xaml.Permissions.XamlAccessLevel> API を使用してアクセス レベルの特性を制御できます。  また、遅延機構 \(WPF テンプレート システムなど\) は、アクセス レベルのアクセス許可を反映し、それを最終的な実行時の評価のために保持できる必要があります。これは、<xref:System.Xaml.Permissions.XamlAccessLevel> 情報を渡すことによって内部で処理されます。  
+  
+### WPF 実装  
+ BAML が部分信頼で読み込まれ、BAML ソースに相当するアセンブリに対してアクセスが <xref:System.Xaml.Permissions.XamlAccessLevel.AssemblyAccessTo%2A> に制限されている場合、WPF XAML では、部分信頼のアクセス モデルが使用されます。  遅延のために、WPF ではアクセス レベル情報を渡す機構として <xref:System.Xaml.IXamlObjectWriterFactory.GetParentSettings%2A?displayProperty=fullName> を使用します。  
+  
+ WPF XAML の用語では、*内部型*とは参照元の XAML も含む同じアセンブリによって定義される型のことを表します。  こうした型は、マッピングの assembly\= の部分を意図的に省略した XAML 名前空間を通じてマッピングできます \(例: `xmlns:local="clr-namespace:WPFApplication1"`\)。  BAML が内部型を参照し、その型のアクセス レベルが `internal` である場合は、アセンブリに対して `GeneratedInternalTypeHelper` クラスが生成されます。  `GeneratedInternalTypeHelper` を避けるには、`public` アクセス レベルを使用するか、該当するクラスを別個のアセンブリにファクタリングして、そのアセンブリを依存させる必要があります。  
+  
+## 参照  
+ [XAML\-Related CLR Attributes for Custom Types and Libraries](../../../docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md)   
+ [XAML Services](../../../docs/framework/xaml-services/index.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/escape-sequence-markup-extension.md b/docs/framework/xaml-services/escape-sequence-markup-extension.md
new file mode 100644
index 00000000000..c377dd2b522
--- /dev/null
+++ b/docs/framework/xaml-services/escape-sequence-markup-extension.md
@@ -0,0 +1,69 @@
+---
+title: "{} Escape Sequence / Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/15/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "{}"
+helpviewer_keywords: 
+  - "XAML [XAML Services], quotation mark (")"
+  - "{} escape sequence [XAML Services]"
+  - "XAML [XAML Services], {} escape sequence"
+  - "XAML [XAML Services], escape sequence"
+  - "quotation mark (") [XAML Services]"
+  - "escape sequence [XAML Services]"
+ms.assetid: 3ce3e2ad-a868-43f9-9c98-b29561cb146e
+caps.latest.revision: 21
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+---
+# {} Escape Sequence / Markup Extension
+属性値に XAML エスケープ シーケンスを提供します。  属性にエスケープ シーケンスを使用すると、その後続の値がリテラルとして解釈されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{} literalValue" .../>  
+```  
+  
+## XAML プロパティ要素の使用方法  
+  
+```  
+<object>  
+  <object.property>  
+    {} literalValue  
+  </object.property>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|*literalValue*|エスケープ シーケンスの後に続くリテラル文字列。  通常、この文字列には、始め中かっこまたは終わり中かっこ \({ または }\) が含まれています。|  
+  
+## 解説  
+ エスケープ シーケンス \({}\) を使用すると、XAML で始め中かっこ \({\) 文字をリテラル文字として使用できるようになります。  
+  
+ XAML リーダーは通常、始め中かっこ \({\) を使用してマークアップ拡張機能のエントリ ポイントを示しますが、最初に次の文字をチェックして右中かっこ \(}\) に該当するかどうかを確認します。  2 つの中かっこ \({}\) が隣接しているときに初めて、エスケープ シーケンスと見なされます。  
+  
+ エスケープ シーケンスが検出された場合、文字列の残りの部分はすべて XAML リーダーによって文字列として処理される必要があります。  ただし、型コンバーターを持つメンバーにエスケープ シーケンスが適用された場合、XAML ライターが文字列を解釈するときに、その文字列に型変換が適用されます。  
+  
+ エスケープ シーケンスはマークアップ拡張機能ではなく、クラスによってサポートされません。  ただし、これはエスケープ変換に該当し、XAML リーダー \(カスタム XAML リーダーを含む\) で必ず考慮されます。  
+  
+ この方法では、引用符 \("\) をエスケープ シーケンスとして使用することはできません。  引用符を非コンテンツ プロパティのプロパティ値として設定する必要がある場合は、プロパティ要素構文を使用して引用符をプロパティ要素の内部の文字列として配置するか、または XML の文字エンティティを使用します。  コンテンツ プロパティでは、引用符のみのコンテンツを指定できます。  
+  
+ エスケープ シーケンス \({}\) は、XAML マークアップ拡張機能が使用される可能性のある場所に名前空間修飾子を含める必要がある XML 型を指定するときによく必要になります。  たとえば、XAML 属性値の先頭やマークアップ拡張内での等号記号 \(\=\) の直後などです。  次の例は、XAML 属性値の先頭にある XML 名前空間のエスケープ シーケンスを示しています。  
+  
+ [!code-xml[XLINQExample#StackPanelResources](../../../samples/snippets/csharp/VS_Snippets_Wpf/XLinqExample/CSharp/Window1.xaml#stackpanelresources)]  
+  
+## 参照  
+ [Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)   
+ [XML Character Entities and XAML](../../../docs/framework/xaml-services/xml-character-entities-and-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/generics-in-xaml.md b/docs/framework/xaml-services/generics-in-xaml.md
new file mode 100644
index 00000000000..1ba6fc46c58
--- /dev/null
+++ b/docs/framework/xaml-services/generics-in-xaml.md
@@ -0,0 +1,55 @@
+---
+title: "Generics in XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "generics [XAML Services]"
+ms.assetid: 835bfed7-585c-4216-ae67-b674edab8b92
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Generics in XAML
+System.Xaml に実装されている .NET Framework XAML サービスは、汎用的な CLR 型の使用をサポートします。  このサポートには、型引数としてのジェネリックの制約の指定、およびジェネリック コレクションのケースに適した `Add` メソッドを呼び出すことでの制約の適用が含まれます。  このトピックでは、XAML のジェネリック型の使用および参照に関するさまざまな側面を説明します。  
+  
+## x:TypeArguments  
+ `x:TypeArguments` は、XAML 言語によって定義されているディレクティブです。  ジェネリック型によってサポートされる XAML 型のメンバーとして使用された場合、`x:TypeArguments` は、ジェネリックの制約型引数をバッキング コンストラクターに渡します。  構文例を含む、`x:TypeArguments` の .NET Framework XAML サービスでの使用に関する参照構文については、「[x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)」を参照してください。  
+  
+ `x:TypeArguments` は文字列を受け取り、型コンバーターをサポートしているため、通常、XAML の使用方法においては属性として宣言されます。  
+  
+ XAML ノード ストリームでは、`x:TypeArguments` によって宣言される情報は、ノード ストリーム内の `StartObject` の位置にある <xref:System.Xaml.XamlType.TypeArguments%2A?displayProperty=fullName> から取得できます。  <xref:System.Xaml.XamlType.TypeArguments%2A?displayProperty=fullName> の戻り値は、<xref:System.Xaml.XamlType> 値の一覧です。  <xref:System.Xaml.XamlType.IsGeneric%2A?displayProperty=fullName> を呼び出すことで、XAML の型がジェネリック型を表してるかどうかを判断できます。  
+  
+## XAML におけるジェネリックの規則および構文の表記規則  
+ XAML では、ジェネリック型は常に制約されたジェネリック型として表される必要があります。制約のないジェネリック型は、XAML 型システムまたは XAML ノード ストリームには決して現れず、XAML マークアップで表すことはできません。  ジェネリックの入れ子にされた型の制約が `x:TypeArguments` によって参照されている場合、または `x:Type` がジェネリック型の CLR 型参照を指定している場合は、XAML 属性構文内でジェネリックを参照できます。  これは、.NET Framework XAML サービスによって定義された <xref:System.Xaml.Schema.XamlTypeTypeConverter> クラスを通じてサポートされます。  
+  
+ <xref:System.Xaml.Schema.XamlTypeTypeConverter> によって有効化された XAML 属性構文形式では、型の山かっことジェネリックの制約を使用する通常の MSIL\/CLR 構文表記規則が変更され、代わりに制約コンテナー用のかっこが代用されます。  例については、「[x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)」を参照してください。  
+  
+## ジェネリックと XAML 2009 の機能  
+ 一般的な言語プリミティブの XAML 型を取得するために CLR 基本データ型をマッピングする代わりに、XAML 2009 を使用する場合は、[XAML 2009 組み込み型](../../../docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md)を `x:TypeArguments` の情報項目として使用できます。  たとえば、次を宣言できます \(プレフィックス マッピングは示されていません。`x` は XAML 2009 の XAML 言語 XAML 名前空間です\)。  
+  
+```  
+<my:BusinessObject x:TypeArguments="x:String,x:Int32"/>  
+```  
+  
+## WPF と他の Framework 3.5 でのジェネリックのサポート  
+ 特に WPF を対象として XAML 2006 を使用している場合は、`x:TypeArguments` と同じ要素上に [x:Class](../../../docs/framework/xaml-services/x-class-directive.md) も指定する必要があり、その要素を XAML ドキュメントのルート要素にする必要があります。  ルート要素は最低 1 つの型引数と共にジェネリック型にマッピングする必要があります。  <xref:System.Windows.Navigation.PageFunction%601> はその一例です。  
+  
+ ジェネリックの使用をサポートするための考えられる代替手段として、ジェネリック型を返すことができるカスタム マークアップ拡張を定義するか、ジェネリック型から派生するが自身のクラス定義内でジェネリック制約を平坦化するラッピング クラス定義を提供します。  
+  
+ WPF で、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] を対象としている場合は、XAML 2009 の機能を `x:TypeArguments` と共に使用できますが、Loose XAML \(マークアップ コンパイルされていない XAML\) に限定されます。  WPF 向けにマークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 のキーワードと機能をサポートしていません。  
+  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] の [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] におけるカスタム ワークフローでは、ジェネリック XAML の使用をサポートしていません。  
+  
+## 参照  
+ [x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)   
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)   
+ [Built\-in Types for Common XAML Language Primitives](../../../docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/index.md b/docs/framework/xaml-services/index.md
new file mode 100644
index 00000000000..7a978561350
--- /dev/null
+++ b/docs/framework/xaml-services/index.md
@@ -0,0 +1,114 @@
+---
+title: "XAML Services | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], System.Xaml concepts"
+  - "XAML Services in WPF [XAML Services]"
+  - "System.Xaml [XAML Services], conceptual documentation"
+ms.assetid: 0e11f386-808c-4eae-9ba6-029ad7ba2211
+caps.latest.revision: 13
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# XAML Services
+このトピックでは、.NET Framework XAML サービスと呼ばれる一連の技術の機能について説明します。  説明するサービスや API の大半は、.NET コア アセンブリの [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] セットで導入された System.Xaml アセンブリ内に存在します。  サービスには、リーダーとライター、スキーマ クラスとスキーマ サポート、ファクトリ、クラスの属性、組み込み XAML 言語サポート、その他の XAML 言語機能などが含まれます。  
+  
+## ドキュメントの内容  
+ .NET Framework XAML サービスの概念説明のドキュメントは、読者が XAML 言語の経験があり、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] や [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] などの特定のフレームワークに対して、または <xref:Microsoft.Build.Framework.XamlTypes> のビルド カスタマイズ機能など、特定の技術機能領域に対して XAML 言語がどのように適用されるかを知っていることを想定しています。  このドキュメントでは、マークアップ言語としての XAML の基礎、XAML 構文の用語、またはその他の基本的な内容については説明するのではなく、  System.Xaml アセンブリ ライブラリで有効になっている .NET Framework XAML サービスの使用方法について詳しく説明します。  これらの API の大半は、XAML 言語の統合および拡張性に伴うシナリオで使用されます。  具体的には、次のような例が挙げられます。  
+  
+-   基本的な XAML リーダーまたは XAML ライターの機能の拡張 \(XAML ノード ストリームの直接処理、独自の XAML リーダーまたは XAML ライターの派生\)。  
+  
+-   特定のフレームワークの依存関係がない XAML 対応のカスタム型の定義、XAML 型システムの特性を .NET Framework XAML サービスに伝達するための型の属性設定。  
+  
+-   XAML マークアップ ソース用のビジュアルなデザイナーや対話形式エディターなど、アプリケーションのコンポーネントとしての XAML リーダーまたは XAML ライターのホスティング。  
+  
+-   XAML 値コンバーターの記述 \(マークアップ拡張機能、カスタム型用の型コンバーター\)。  
+  
+-   カスタム XAML スキーマ コンテキストの定義 \(バッキング型ソースに対応するアセンブリ読み込みの代替方法の使用、アセンブリを常に反映する代わりに既知の型をルックアップする方法の使用、CLR `AppDomain` とその関連付けられたセキュリティ モデルを使用しない、読み込まれたアセンブリ概念の使用\)。  
+  
+-   基本的な XAML 型システムの拡張。  
+  
+-   XAML 型システムや型バッキングの評価方法に影響を与える `Lookup` 手法または `Invoker` 手法の使用。  
+  
+ 言語としての XAML の入門資料が必要な場合は、「[XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  このトピックでは、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] と XAML マークアップおよび XAML 言語機能を初めて使用するユーザー向けに、XAML を解説します。  「[XAML language specification \(XAML 言語仕様\)](http://go.microsoft.com/fwlink/?LinkId=114525)」の入門資料も有用です。  
+  
+## .NET アーキテクチャの .NET Framework XAML サービスおよび System.Xaml  
+ 以前のバージョンの [!INCLUDE[TLA#tla_netframewk](../../../includes/tlasharptla-netframewk-md.md)] では、XAML 言語機能のサポートは [!INCLUDE[TLA#tla_netframewk](../../../includes/tlasharptla-netframewk-md.md)] \([!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)]、[!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)]、および [!INCLUDE[vsindigo](../../../includes/vsindigo-md.md)]\) に構築されたフレームワークによって実装されていたので、使用されるフレームワークによって、それぞれの動作と API が異なっていました。  これには、XAML のパーサーとそのオブジェクト グラフの作成機構、組み込み XAML 言語、シリアル化のサポートなどが含まれます。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、.NET Framework XAML サービスと System.Xaml アセンブリによって、XAML 言語機能のサポートに必要な要素の大半が定義されます。  たとえば、XAML リーダーと XAML ライターの基本クラスなどです。  他のフレームワーク固有の XAML 実装には存在しなかった機能で、.NET Framework XAML サービスに追加された最も重要な機能とは、XAML の型システム表現です。  型システム表現では、フレームワークの特定の機能に依存することなく、XAML の機能に重点を置いたオブジェクト指向の方法で XAML を記述できます。  
+  
+ XAML 型システムは、XAML の起点のマークアップ形式やランタイムの詳細にも、特定のバッキング型システムにも制約されません。  XAML 型システムには、型、メンバー、XAML スキーマ コンテキスト、XML レベルの概念、およびその他の XAML 言語概念や組み込みの XAML オブジェクト表現が含まれます。  XAML 型システムを使用または拡張することにより、XAML リーダーや XAML ライターなどのクラスから派生したり、XAML を消費または生成するフレームワーク、技術、またはアプリケーションによって有効化される特定の機能に XAML 表現の機能を拡張したりできます。  XAML スキーマ コンテキストの概念に基づいて、XAML オブジェクト ライターの実装、コンテキストのアセンブリ情報で受け渡される技術のバッキング型システム、および XAML ノード ソースの組み合わせから、実用的なオブジェクト グラフの書き込み操作を実行できます。  XAML スキーマの概念の詳細については、  「[Default XAML Schema Context and WPF XAML Schema Context](../../../docs/framework/xaml-services/default-xaml-schema-context-and-wpf-xaml-schema-context.md)」を参照してください。  
+  
+## XAML ノード ストリーム、XAML リーダー、および XAML ライター  
+ XAML 言語と、XAML を言語として使用する特定の技術との関係において .NET Framework XAML サービスが担う役割を理解するには、XAML ノード ストリームの概念と、その概念に基づいて API や用語がどのように形成されるかを理解しておくと便利です。  XAML ノード ストリームとは、XAML 言語表現と、XAML が表現または定義するオブジェクト グラフ間の中間概念です。  
+  
+-   XAML リーダーとは、なんらかの形で XAML を処理し、XAML ノード ストリームを生成するエンティティです。  API では、XAML リーダーは基本クラス <xref:System.Xaml.XamlReader> で表されます。  
+  
+-   XAML ライターとは、XAML ノード ストリームを処理し、他のものを生成するエンティティです。  API では、XAML ライターは基本クラス <xref:System.Xaml.XamlWriter> で表されます。  
+  
+ XAML に関する 2 つの最も一般的なシナリオとは、XAML を読み込んでオブジェクト グラフをインスタンス化することと、アプリケーションまたはツールからオブジェクト グラフを保存して XAML 表現を作成することです \(通常は、テキスト ファイルとして保存されるマークアップ形式\)。  このドキュメントでは通常、XAML の読み込みとオブジェクト グラフの作成を、読み込みパスと呼びます。  このドキュメントでは通常、既存のオブジェクト グラフを XAML に保存、またはシリアル化することを、保存パスと呼びます。  
+  
+ 最も一般的な種類の読み込みパスは、次のように説明できます。  
+  
+-   UTF エンコードされた XML 形式をテキスト ファイルとして保存した XAML 表現から開始します。  
+  
+-   その XAML を <xref:System.Xaml.XamlXmlReader> に読み込みます。  ここで <xref:System.Xaml.XamlXmlReader> は、<xref:System.Xaml.XamlReader> のサブクラスです。  
+  
+-   その結果、XAML ノード ストリームが生成されます。  <xref:System.Xaml.XamlXmlReader> \/ <xref:System.Xaml.XamlReader> API を使用し、XAML ノード ストリームの個別のノードにアクセスできます。  ここで最も一般的な操作とは、"現在のレコード" 比喩を使用し、各ノードを処理しながら XAML ノード ストリーム内の先に進むことです。  
+  
+-   結果として生成されるノードを XAML ノード ストリームから <xref:System.Xaml.XamlObjectWriter> API に渡します。  ここで <xref:System.Xaml.XamlObjectWriter> は、<xref:System.Xaml.XamlWriter> のサブクラスです。  
+  
+-   <xref:System.Xaml.XamlObjectWriter> は、ソース XAML ノード ストリーム内を進みながらオブジェクトを 1 つずつ記述し、オブジェクト グラフを作成します。  この処理は、XAML スキーマ コンテキストと、バッキング型システムおよびフレームワークのアセンブリと型にアクセスできる実装によって行われます。  
+  
+-   XAML ノード ストリームの最後で <xref:System.Xaml.XamlObjectWriter.Result%2A> を呼び出して、オブジェクト グラフのルート オブジェクトを取得します。  
+  
+ 最も一般的な種類の保存パスは、次のように説明できます。  
+  
+-   アプリケーション ランタイム全体のオブジェクト グラフ、UI コンテンツおよびランタイムの状態、またはランタイム時のアプリケーション全体のオブジェクト表現の小規模なセグメントから開始します。  
+  
+-   アプリケーション ルート、ドキュメント ルートなどの論理的な開始オブジェクトから <xref:System.Xaml.XamlObjectReader> にオブジェクトを読み込みます。  ここで <xref:System.Xaml.XamlObjectReader> は、<xref:System.Xaml.XamlReader> のサブクラスです。  
+  
+-   その結果、XAML ノード ストリームが生成されます。  <xref:System.Xaml.XamlObjectReader> および <xref:System.Xaml.XamlReader> API を使用して、XAML ノード ストリームの個別のノードにアクセスできます。  ここで最も一般的な操作とは、"現在のレコード" 比喩を使用し、各ノードを処理しながら XAML ノード ストリーム内の先に進むことです。  
+  
+-   結果として生成されるノードを XAML ノード ストリームから <xref:System.Xaml.XamlXmlWriter> API に渡します。  ここで <xref:System.Xaml.XamlXmlWriter> は、<xref:System.Xaml.XamlWriter> のサブクラスです。  
+  
+-   <xref:System.Xaml.XamlXmlWriter> は、XML UTF エンコードで XAML を記述します。  これをテキスト ファイル、ストリーム、またはその他のフォームで保存できます。  
+  
+-   <xref:System.Xaml.XamlXmlWriter.Flush%2A> を呼び出して、最終的な出力を取得します。  
+  
+ XAML ノード ストリームの概念の詳細については、「[Understanding XAML Node Stream Structures and Concepts](../../../docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md)」を参照してください。  
+  
+### XamlServices クラス  
+ XAML ノード ストリームは、必ずしも処理する必要はありません。  基本的な読み込みパスまたは基本的な保存パスが必要な場合は、<xref:System.Xaml.XamlServices> クラスの API を使用できます。  
+  
+-   <xref:System.Xaml.XamlServices.Load%2A> のさまざまなシグネチャは、読み込みパスを実装しています。  ファイルまたはストリームを読み込むか、リーダーの API で読み込むことによって XAML 入力をラップする <xref:System.Xml.XmlReader>、<xref:System.IO.TextReader>、または <xref:System.Xaml.XamlReader> を読み込むことができます。  
+  
+-   <xref:System.Xaml.XamlServices.Save%2A> のさまざまなシグネチャがオブジェクト グラフを保存し、ストリーム、ファイル、または <xref:System.Xml.XmlWriter>\/<xref:System.IO.TextWriter> インスタンスとして出力を生成します。  
+  
+-   <xref:System.Xaml.XamlServices.Transform%2A> は、読み込みパスと保存パスを単独の操作としてリンクすることによって、XAML を変換します。  <xref:System.Xaml.XamlReader> および <xref:System.Xaml.XamlWriter> に対して異なるスキーマ コンテキスト、または異なるバッキング型システムを使用できます。これによって、結果として生成される XAML がどのように変換されるかが影響を受けます。  
+  
+ <xref:System.Xaml.XamlServices> の使用方法の詳細については、「[XAMLServices Class and Basic XAML Reading or Writing](../../../docs/framework/xaml-services/xamlservices-class-and-basic-xaml-reading-or-writing.md)」を参照してください。  
+  
+## XAML 型システム  
+ XAML 型システムには、XAML ノード ストリームにおいて指定された個別ノードで作業するために必要となる API が用意されています。  
+  
+ <xref:System.Xaml.XamlType> はオブジェクトの表現であり、開始オブジェクト ノードと終了オブジェクト ノード間で処理されます。  
+  
+ <xref:System.Xaml.XamlMember> はオブジェクトのメンバーの表現で、開始メンバー ノードと終了メンバー ノード間で処理されます。  
+  
+ <xref:System.Xaml.XamlType.GetAllMembers%2A>、<xref:System.Xaml.XamlType.GetMember%2A>、<xref:System.Xaml.XamlMember.DeclaringType%2A> のような API は、<xref:System.Xaml.XamlType> と <xref:System.Xaml.XamlMember> との関係を報告します。  
+  
+ .NET Framework XAML サービスで実装される XAML 型システムの既定の動作は、共通言語ランタイム \(CLR\) と、リフレクションを使用する、アセンブリの CLR 型のスタティック分析に基づいて実装されます。  したがって、特定の CLR 型について、XAML 型システムの既定の実装はその型の XAML スキーマとメンバーを公開し、それを XAML 型システムに基づいて報告できます。  既定の XAML 型システムでは、型が割り当てできるかどうかの概念は CLR の継承にマッピングされ、インスタンスや値の型などの概念も、CLR をサポートする動作や機能にマッピングされます。  
+  
+## XAML 言語機能のリファレンス  
+ XAML をサポートするため、.NET Framework XAML サービスには、XAML 言語の XAML 名前空間に対する定義として、XAML 言語概念の特定の実装が用意されています。  具体的には、固有のリファレンス ページで説明しています。  言語機能については、.NET Framework XAML サービスで定義された XAML リーダーまたは XAML ライターによって処理される際に、各言語機能がどのように動作するかという視点から説明しています。  詳細については、「[XAML Namespace \(x:\) Language Features](../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/markup-extensions-for-xaml-overview.md b/docs/framework/xaml-services/markup-extensions-for-xaml-overview.md
new file mode 100644
index 00000000000..df14b60138d
--- /dev/null
+++ b/docs/framework/xaml-services/markup-extensions-for-xaml-overview.md
@@ -0,0 +1,167 @@
+---
+title: "Markup Extensions for XAML Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "markup extensions [XAML Services], custom"
+  - "XAML [XAML Services], markup extensions"
+ms.assetid: 261b2b11-2dc0-462f-8c66-55b8c9c6e436
+caps.latest.revision: 14
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Markup Extensions for XAML Overview
+マークアップ拡張機能は、プリミティブでも特定の XAML 型でもない値を取得するための XAML の手法です。 属性による使用では、マークアップ拡張機能は、左中かっこ `{` でマークアップ拡張機能スコープに入り、右中かっこ `}` で終了するという、既知の文字シーケンスを使用します。 .NET Framework XAML サービスを使用する場合は、System.Xaml アセンブリから XAML 言語の定義済みのマークアップ拡張機能をいくつか使用できます。 また、System.Xaml で定義された <xref:System.Windows.Markup.MarkupExtension> クラスからサブクラスを作成し、独自のマークアップ拡張機能を定義することもできます。 あるいは、特定のフレームワークを既に参照している場合は、そのフレームワークによって定義されたマークアップ拡張機能を使用することができます。  
+  
+ マークアップ拡張機能の使用にアクセスした XAML オブジェクト ライターは、<xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A?displayProperty=fullName> オーバーライドのサービス接続ポイントを通じて、カスタム <xref:System.Windows.Markup.MarkupExtension> クラスにサービスを提供することができます。 このサービスを使用すると、使用に関するコンテキスト、オブジェクト ライターの特定の機能、XAML スキーマ コンテキストなどを取得することができます。  
+  
+<a name="XAML_Defined_Markup_Extensions"></a>   
+## XAML で定義されたマークアップ拡張機能  
+ XAML 言語をサポートするため、.NET Framework XAML サービスによっていくつかのマークアップ拡張機能が実装されています。 これらのマークアップ拡張機能は、言語としての XAML の仕様の部分に対応しています。 これらは、通常、一般的に使用される構文では `x:` プレフィックスによって識別できます。 これらの XAML 言語要素に対する .NET Framework XAML サービスの実装は、すべて <xref:System.Windows.Markup.MarkupExtension> 基底クラスから派生します。  
+  
+> [!NOTE]
+>  `x:` プレフィックスは、XAML 稼働環境のルート要素で、XAML 言語の名前空間を標準的な XAML 名前空間にマッピングするために使用します。 たとえば、さまざまな特定のフレームワークの [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] プロジェクト テンプレートおよびページ テンプレートでは、この `x:` マッピングを XAML ファイルの先頭に置きます。 独自の XAML 名前空間のマッピングに別のプレフィックス トークンを選択することもできますが、このドキュメントでは、既定の `x:` マッピングを、独自の固有なフレームワークの既定の XAML 名前空間や他の任意の CLR 名前空間または XML 名前空間ではなく、XAML 言語の XAML 名前空間の一部として定義されているエンティティを識別する手段と想定します。  
+  
+### x:Type  
+ `x:Type` は、名前を指定した型の <xref:System.Type> オブジェクトを提供します。 この機能は、基になる CLR 型やそれから派生した型をグループ化のモニカーまたは識別子として使用する遅延メカニズムの中で最も頻繁に使用されます。 具体的な例には、WPF のスタイルとテンプレート、およびそれらにおける `TargetType` プロパティの使用があります。 詳細については、「[x:Type Markup Extension](../../../docs/framework/xaml-services/x-type-markup-extension.md)」を参照してください。  
+  
+### x:Static  
+ `x:Static` は、直接的にはプロパティの値の型ではなくても、その型に評価することができる値型コード エンティティから、静的な値を生成します。 これは、型定義で既知の定数として既に存在する値を指定するときに便利です。 詳細については、「[x:Static Markup Extension](../../../docs/framework/xaml-services/x-static-markup-extension.md)」を参照してください。  
+  
+### x:Null  
+ `x:Null` は、XAML メンバーに対する値として `null` を指定します。 特定の型の設計やフレームワークの広義の概念によっては、`null` がプロパティの既定値に該当しない場合や、空の文字列属性の暗黙的な値に該当しない場合もあります。 詳細については、「[x:Null Markup Extension](../../../docs/framework/xaml-services/x-null-markup-extension.md)」を参照してください。  
+  
+### x:Array  
+ `x:Array` は、XAML 構文での一般的な配列の作成をサポートします。基本要素とコントロール モデルで提供されているコレクションのサポートをあえて使用しない場合に使用します。 詳細については、「[x:Array Markup Extension](../../../docs/framework/xaml-services/x-array-markup-extension.md)」を参照してください。 XAML 2009 では、厳密に言うと、拡張機能としてではなく言語プリミティブとして配列にアクセスします。 詳細については、「[XAML 2009 Language Features](../../../docs/framework/xaml-services/xaml-2009-language-features.md)」を参照してください。  
+  
+### x:Reference  
+ `x:Reference` は XAML 2009 に含まれており、元 \(2006\) の言語セットの拡張機能です。`x:Reference` は、オブジェクト グラフにある別の既存のオブジェクトへの参照を表します。 このオブジェクトは、その `x:Name` によって識別されます。 詳細については、「[x:Reference Markup Extension](../../../docs/framework/xaml-services/x-reference-markup-extension.md)」を参照してください。  
+  
+### その他の x: コンストラクト  
+ XAML 言語機能をサポートするための他の `x:` コンストラクトも存在しますが、マークアップ拡張機能としては実装されていません。 詳細については、「[XAML Namespace \(x:\) Language Features](../../../docs/framework/xaml-services/xaml-namespace-x-language-features.md)」を参照してください。  
+  
+<a name="the_markupextension_base_class"></a>   
+## MarkupExtension 基底クラス  
+ System.Xaml の XAML リーダーと XAML ライターの既定の実装と対話できるカスタム マークアップ拡張機能を定義するには、抽象クラス <xref:System.Windows.Markup.MarkupExtension> からクラスを派生します。 このクラスには、オーバーライドする 1 つのメソッドとして、<xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> があります。 また、マークアップ拡張機能で使用する引数をサポートする追加のコンストラクターと、それに対応する設定可能なプロパティも定義する必要があります。  
+  
+ カスタム マークアップ拡張機能は、<xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> を通じて、マークアップ拡張機能が XAML プロセッサによって実際に起動された環境を報告するサービス コンテキストにアクセスします。 読み込みパスでは、これは通常 <xref:System.Xaml.XamlObjectWriter> です。 保存パスでは、これは通常 <xref:System.Xaml.XamlXmlWriter> です。 これらはそれぞれ、サービス プロバイダー パターンを実装する内部 XAML サービス プロバイダー コンテキスト クラスとして、サービス コンテキストを報告します。 使用できるサービスと、これらのサービスが何を表現するかについての詳細については、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」を参照してください。  
+  
+ マークアップ拡張機能クラスは、パブリックなアクセス レベルを使用する必要があります。XAML プロセッサは、マークアップ拡張機能のサービスを使用するために、そのマークアップ拡張機能のサポート クラスをいつでもインスタンス化できる必要があるからです。  
+  
+<a name="naming_the_support_type"></a>   
+## カスタム マークアップ拡張機能のサポート型の定義  
+ .NET Framework XAML サービス、または .NET Framework XAML サービスに基づいて構築されたフレームワークを使用する場合は、2 種類の方法でマークアップ拡張機能のサポート型に名前を付けることができます。 型名は、XAML オブジェクト ライターが XAML 内でマークアップ拡張機能の使用を検出したときに、マークアップ拡張機能のサポート型にアクセスして呼び出しを試みる方法に関連しています。 次のいずれかの方法で名前を付けます。  
+  
+-   XAML マークアップの使用トークンと完全に一致する型名を付ける。 たとえば、`{Collate ...}` 拡張機能の使用をサポートするためには、サポート型に `Collate` という名前を付けます。  
+  
+-   使用トークンの文字列に `Extension` サフィックスを付加した型名を付ける。 たとえば、`{Collate ...}` 拡張機能の使用をサポートするためには、サポート型に `CollateExtension` という名前を付けます。  
+  
+ 検索は、まずサフィックス `Extension` が付加されたクラス名、次にサフィックス `Extension` が付加されていないクラス名という順序で行われます。  
+  
+ マークアップを使用する観点からは、サフィックス `Extension` を使用名の一部に含めることは有効です。 ただし、この場合、`Extension` は完全にクラス名の一部として扱われます。したがって、サポート クラスにサフィックス `Extension` が付いていない場合、XAML オブジェクト ライターはその使用についてマークアップ拡張機能のサポート クラスを解決できません。  
+  
+### 既定のコンストラクター  
+ すべてのマークアップ拡張機能のサポート型について、パブリックの既定のコンストラクターを公開する必要があります。 既定のコンストラクターは、XAML オブジェクト ライターがオブジェクト要素の使用からマークアップ拡張機能をインスタンス化するすべてのケースで必要です。 マークアップ拡張機能でオブジェクト要素の使用がサポートされることは、特にシリアル化の場合には、正当な予想です。 ただし、マークアップ拡張機能の属性による使用だけをサポートする場合は、パブリック コンストラクターなしでマークアップ拡張機能を実装することができます。  
+  
+ マークアップ拡張機能の使用に引数がない場合、その使用をサポートするには既定のコンストラクターが必要です。  
+  
+<a name="constructor_patterns_and_positional_arguments_for_a_custom_markup_extension"></a>   
+## カスタム マークアップ拡張機能のコンストラクター パターンと位置指定引数  
+ 引数の意図された使用方法のあるマークアップ拡張機能については、パブリック コンストラクターは、意図された使用方法のモードに対応する必要があります。 つまり、有効な使用方法として位置指定引数を 1 つ使用するようにマークアップ拡張機能が設計されている場合であれば、その位置指定引数を取る 1 つの入力パラメーターを使用するパブリック コンストラクターをサポートする必要があります。  
+  
+ たとえば、`Collate` マークアップ拡張機能が、モードを表す位置指定引数 \(`CollationMode` 列挙定数として指定される\) が 1 つのモードのみをサポートするとします。 この場合は、次の形式のコンストラクターが必要になります。  
+  
+```  
+public Collate(CollationMode collationMode) {...}  
+```  
+  
+ 基本的なレベルでは、マークアップ拡張機能に渡される引数は、マークアップの属性値から転送されるので、文字列です。 すべての引数を文字列にし、入力をそのレベルで処理することができます。 ただし、マークアップ拡張機能の引数がサポート クラスに渡される前に実行される特定の処理にアクセスすることもできます。  
+  
+ この処理では、概念としては、マークアップ拡張機能を「作成するオブジェクト」と見なして、そのメンバー値を設定します。 設定するように指定された各プロパティは、作成するオブジェクトに指定されたメンバーが設定される場合と同じように、XAML が解析される時点で評価されます。 次の 2 つの重要な違いがあります。  
+  
+-   前述のとおり、マークアップ拡張機能のサポート型では、XAML でインスタンス化するための既定のコンストラクターが必須ではありません。 オブジェクトの構築は、テキスト構文で使用できる引数が位置指定引数または名前付き引数のいずれかとしてトークン化および評価されるまで遅延され、その時点で適切なコンストラクターが呼び出されます。  
+  
+-   マークアップ拡張機能の使用は入れ子にすることができます。 最も内側のマークアップ拡張機能が最初に評価されます。 そのため、そのような使用を想定して、いずれかの構築パラメーターを、生成するために値コンバーター \(マークアップ拡張機能など\) を必要とする型として宣言できます。  
+  
+ このような処理への依存については、前の例で説明したとおりです。 .NET Framework XAML サービスの XAML オブジェクト ライターは、列挙定数の名前を、ネイティブ レベルでの列挙値に処理します。  
+  
+ また、マークアップ拡張機能の位置指定パラメーターのテキスト構文を処理する際にも、構築引数にある型に関連付けた型コンバーターに依存するようにできます。  
+  
+ 引数が位置指定引数と呼ばれるのは、使用の中でトークンに出会う順序が、割り当てられたコンストラクター パラメーターの位置的な順序に対応するからです。 たとえば、次のようなコンストラクター シグネチャについて考えてみます。  
+  
+```  
+public Collate(CollationMode collationMode, object collateThis) {...}  
+```  
+  
+ XAML プロセッサは、このマークアップ拡張機能に対して、2 つの位置指定引数を予期します。`{Collate AlphaUp,{x:Reference circularFile}}` という使用があった場合、`AlphaUp` トークンが最初のパラメーターに送られ、`CollationMode` 列挙体の名前付き定数として評価されます。 内側の `x:Reference` の結果は 2 つ目のパラメーターに送られ、オブジェクトとして評価されます。  
+  
+ XAML で規定されているマークアップ拡張構文と処理の規則では、引数が位置指定引数の場合でも名前付き引数の場合でも、引数の区切り記号としてコンマが使用されます。  
+  
+### 位置指定引数の重複するアリティ  
+ XAML オブジェクト ライターが位置指定引数によるマークアップ拡張機能の使用を検出したときに、同じ数の引数 \(重複するアリティ\) を受け取る複数のコンストラクターが存在している場合でも、必ずしもエラーには該当しません。 実際の動作は、カスタマイズ可能な XAML スキーマ コンテキスト設定である <xref:System.Xaml.XamlSchemaContextSettings.SupportMarkupExtensionsWithDuplicateArity%2A> によって異なります。<xref:System.Xaml.XamlSchemaContextSettings.SupportMarkupExtensionsWithDuplicateArity%2A> が `true` である場合は、重複するアリティのみを理由に、XAML オブジェクト ライターから例外がスローされることはありません。 それ以上の動作は、厳密には定義されていません。 基本的な設計では、スキーマ コンテキストには特定のパラメーターに対応する型情報が設定されており、明示的なキャストを試みて、重複する候補から最もよく一致するシグネチャを確認できる、ということを前提としています。 それでも、XAML オブジェクト ライターで実行されている特定のスキーマ コンテキストによってテストが行われ、そのテストに合格するシグネチャが存在しない場合に、例外がスローされる可能性があります。  
+  
+ 既定では、<xref:System.Xaml.XamlSchemaContextSettings.SupportMarkupExtensionsWithDuplicateArity%2A> は .NET Framework XAML サービスの CLR ベースの <xref:System.Xaml.XamlSchemaContext> で `false` になります。 したがって、バッキング型のコンストラクターに重複するアリティが存在している状況で、マークアップ拡張機能の使用を検出した場合に、既定の <xref:System.Xaml.XamlObjectWriter> が例外をスローします。  
+  
+<a name="named_arguments_for_a_custom_markup_extension"></a>   
+## カスタム マークアップ拡張機能の名前付き引数  
+ XAML によって指定されるマークアップ拡張機能は、使用の際に名前付き引数の形式を使用することもできます。 トークン化の最初のレベルでは、テキスト構文は引数に分割されます。 引数内に等号 \(\=\) が存在すると、引数は名前付き引数として識別されます。 このような引数は、名前と値のペアにトークン化されます。 この場合の名前は、マークアップ拡張機能のサポート型の、パブリックに設定可能なプロパティの名前を指定します。 名前付き引数の使用をサポートする場合は、これらのパブリックに設定可能なプロパティを用意する必要があります。 プロパティは、パブリックである限りは、継承プロパティを指定できます。  
+  
+<a name="accessing_service_provider_context_from_a_markup_extension_implementation"></a>   
+## マークアップ拡張機能の実装からサービス プロバイダーのコンテキストにアクセスする  
+ 使用可能なサービスは、すべての値コンバーターの場合と同じです。 ただし、それぞれの値コンバーターがサービス コンテキストを受け取る方法が違います。 サービスへのアクセスと、使用できるサービスについては、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」のトピックを参照してください。  
+  
+<a name="property_element_usage_of_a_markup_extension"></a>   
+## マークアップ拡張機能のプロパティ要素の使用方法  
+ マークアップ拡張機能の使用のシナリオは、多くの場合、属性を使用したマークアップ拡張機能の使用を中心にして設計されます。 ただし、プロパティ要素による使用をサポートするバッキング クラスを定義することも可能です。  
+  
+ マークアップ拡張機能のプロパティ要素による使用をサポートするには、パブリックな既定のコンストラクターを定義します。 これは、静的コンストラクターではなく、インスタンス コンストラクターにする必要があります。 これが必要である理由は、XAML プロセッサは、通常、マークアップに基づいて処理する任意のオブジェクト要素に対して既定のコンストラクターを呼び出す必要があり、これにはオブジェクト要素としてのマークアップ拡張機能クラスも含まれるからです。 さらに複雑なシナリオとして、クラスに対して既定以外の構築パスを定義することもできます。 \(詳細については、「[x:FactoryMethod Directive](../../../docs/framework/xaml-services/x-factorymethod-directive.md)」を参照してください\)。 ただし、マークアップ拡張機能の目的では、これらのパターンを使用しないことをお勧めします。未加工のマークアップのデザイナーにとってもユーザーにとっても、使用パターンの検出が非常に困難になるからです。  
+  
+<a name="attributing_for_a_custom_markup_extension"></a>   
+## カスタム マークアップ拡張機能の属性設定  
+ デザイン環境と、特定の XAML オブジェクト ライターのシナリオのどちらをサポートするためにも、マークアップ拡張機能のサポート型にいくつかの CLR 属性を設定する必要があります。 これらの属性は、目的のマークアップ拡張機能の使用を報告します。  
+  
+ <xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute> は、<xref:System.Windows.Markup.ArrayExtension.ProvideValue%2A> が返すオブジェクトの型の <xref:System.Type> 情報を報告します。 純粋なシグネチャとしては、<xref:System.Windows.Markup.ArrayExtension.ProvideValue%2A> は <xref:System.Object> を返します。 ただし、コンシューマーの種類によっては、戻り値の型についてさらに詳細な情報が必要になる場合があります。 バインディングには、以下の項目が含まれます。  
+  
+-   マークアップ拡張機能の使用に関して、型を認識したサポートを提供できるデザイナーや IDE を実現するための情報。  
+  
+-   ターゲット クラスに対する `SetMarkupExtension` ハンドラーの高度な実装のための情報。特定の既知の <xref:System.Windows.Markup.MarkupExtension> 実装を名前で分岐して判別するのではなく、リフレクションに基づいてマークアップ拡張機能の戻り値の型を判別できるようになります。  
+  
+<a name="serialization_of_markup_extension_usages"></a>   
+## マークアップ拡張機能の使用のシリアル化  
+ XAML オブジェクト ライターによってマークアップ拡張機能の使用が処理され、<xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> が呼び出されると、かつてマークアップ拡張機能の使用だったコンテキストは XAML ノード ストリームに残りますが、オブジェクト グラフには残りません。 オブジェクト グラフでは、値だけが保持されます。 元のマークアップ拡張機能の使用をシリアル化された出力として保持する、設計シナリオとしての必要性や他の理由がある場合は、読み込みパスの XAML ノード ストリームからマークアップ拡張機能の使用を追跡するための独自のインフラストラクチャを設計する必要があります。 読み込みパスからノード ストリームの要素を再作成し、ノード ストリームの該当する位置に値を代入しながら、それらを XAML ライターで再生して保存パスにシリアル化する、という動作を実装できます。  
+  
+<a name="markup_extensions_in_the_xaml_node_stream"></a>   
+## XAML ノード ストリームのマークアップ拡張機能  
+ 読み込みパスで XAML ノード ストリームを処理している場合、マークアップ拡張機能の使用は、オブジェクトとしてノード ストリーム内に登場します。  
+  
+ マークアップ拡張機能の使用で位置指定引数が使用される場合、その使用は初期化の値が設定された開始オブジェクトとして表されます。 大まかなテキスト表現では、ノード ストリームは次のようになります。  
+  
+ `StartObject` \(<xref:System.Xaml.XamlType> はマークアップ拡張機能の定義の型であり、戻り値の型ではありません\)  
+  
+ `StartMember` \(<xref:System.Xaml.XamlMember> の名前は `_InitializationText`\)  
+  
+ `Value` \(値は、途中に区切り記号を含む文字列形式の位置指定引数\)  
+  
+ `EndMember`  
+  
+ `EndObject`  
+  
+ 名前付き引数によるマークアップ拡張機能の使用は、その名前のメンバー \(それぞれにテキスト文字列値が設定されている\) を持つオブジェクトとして表されます。  
+  
+ 実際にマークアップ拡張機能の `ProvideValue` 実装を呼び出すには、XAML スキーマ コンテキストが必要です。その呼び出しには、型マッピングと、マークアップ拡張機能のサポート型インスタンスの作成が必要であるからです。 これは、マークアップ拡張機能の使用が、既定の .NET Framework XAML サービスのノード ストリーム内でこのような形式に保たれている理由の 1 つです。多くの場合、読み込みパスのリーダー部分では、必要な XAML スキーマ コンテキストを利用できません。  
+  
+ 保存パスで XAML ノード ストリームを処理している場合は、通常、シリアル化するオブジェクトが当初はマークアップ拡張機能の使用と `ProvideValue` の結果によって提供されたことを知らせる情報はオブジェクト グラフ表現の中に存在しません。 マークアップ拡張機能の使用をラウンドトリップさせ、オブジェクト グラフのその他の変化もキャプチャする必要があるシナリオでは、元の XAML 入力に由来するマークアップ拡張機能の使用の情報を保存するため、独自の手法を考案する必要があります。 たとえば、マークアップ拡張機能の使用を復元するには、保存パス上のノード ストリームを処理してマークアップ拡張機能の使用を復元するか、元の XAML とラウンドトリップされた XAML に対して何らかのマージ処理を実行することができます。 WPF などの一部の XAML 実装フレームワークでは、中間の型 \(式\) を使用して、マークアップ拡張機能の使用が値を提供したケースを表す場合があります。  
+  
+## 参照  
+ <xref:System.Windows.Markup.MarkupExtension>   
+ [Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)   
+ [マークアップ拡張機能と WPF XAML](../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/service-contexts-available-to-type-converters-and-markup-extensions.md b/docs/framework/xaml-services/service-contexts-available-to-type-converters-and-markup-extensions.md
new file mode 100644
index 00000000000..403fb5c490a
--- /dev/null
+++ b/docs/framework/xaml-services/service-contexts-available-to-type-converters-and-markup-extensions.md
@@ -0,0 +1,176 @@
+---
+title: "Service Contexts Available to Type Converters and Markup Extensions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], type converter services how-to"
+ms.assetid: b4dad00f-03da-4579-a4e9-d8d72d2ccbce
+caps.latest.revision: 13
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Service Contexts Available to Type Converters and Markup Extensions
+型コンバーターとマークアップ拡張機能の使用をサポートする型の作成者には、マークアップまたは周辺のオブジェクト グラフ構造体のどこで使用されているかを示す文脈情報が必要です。 情報は、指定されるオブジェクトを正しくインスタンス化するため、またオブジェクト グラフ内の既存オブジェクトへのオブジェクト参照を行うために必要です。 .NET Framework XAML サービスを使用している場合、必要となる可能性のあるコンテキストは一連のサービス インターフェイスとして公開されます。 型コンバーターまたはマークアップ拡張のサポート コードでは、<xref:System.Xaml.XamlObjectWriter> または関連する型から渡される使用可能なサービス プロバイダー コンテキストを使用して、サービスを照会できます。 XAML スキーマ コンテキストは、このようなサービスを通じて直接使用できます。 このトピックでは、値コンバーター実装からサービス コンテキストにアクセスする方法を説明し、通常使用できるサービスとその役割の一覧を示します。  
+  
+<a name="obtaining_services"></a>   
+## サービスの取得  
+ 値コンバーターの実装者は、通常、値コンバーターが適用される何らかの種類のコンテキストにアクセスする必要があります。 たとえば、アクティブな XAML スキーマ コンテキスト、XAML スキーマ コンテキストや XAML オブジェクト ライターが提供する型マッピング システムへのアクセスなどの情報が必要です。 マークアップ拡張機能または型コンバーターの実装で使用されるサービスは、各仮想メソッドのシグネチャの一部であるコンテキスト パラメーターを通じて伝達されます。 いずれの場合でも、コンテキストに <xref:System.IServiceProvider> が実装されているので、<xref:System.IServiceProvider.GetService%2A?displayProperty=fullName> を呼び出してサービスを要求することができます。  
+  
+<a name="services_for_a_markup_extension"></a>   
+## マークアップ拡張機能のサービス  
+ <xref:System.Windows.Markup.MarkupExtension> には、仮想メソッドが 1 つだけあります \(<xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A>\)。 入力パラメーター `serviceProvider` は、XAML プロセッサによってマークアップ拡張機能が呼び出されたときに、サービスが実装に伝達される方法を示します。 次の疑似コードは、マークアップ拡張機能の実装が <xref:System.Windows.Markup.MarkupExtension.ProvideValue%2A> でサービスを照会する方法を示します。  
+  
+```  
+public override object ProvideValue(IServiceProvider serviceProvider) { ... // Get the IXamlTypeResolver from the service provider if (serviceProvider == null) { throw new ArgumentNullException("serviceProvider"); } IXamlTypeResolver xamlTypeResolver = serviceProvider.GetService(typeof(IXamlTypeResolver)) as IXamlTypeResolver; if (xamlTypeResolver == null) { throw new ArgumentException("IXamlTypeResolver")); } ... }  
+```  
+  
+<a name="services_for_a_type_converter"></a>   
+## 型コンバーターのサービス  
+ <xref:System.ComponentModel.TypeConverter> には、サービス コンテキストを使用し、XAML の使用をサポートする仮想メソッドが 4 つあります。 これらのメソッドは、それぞれ入力パラメーター `context` を渡します。 このパラメーターの型は <xref:System.ComponentModel.ITypeDescriptorContext> ですが、そのインターフェイスは <xref:System.IServiceProvider> を継承するため、型コンバーターの実装では <xref:System.IServiceProvider.GetService%2A> メソッドを使用できます。  
+  
+ 次の疑似コードは、XAML の使用に対する型コンバーターの実装が、そのオーバーライドの 1 つ \(このケースでは <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A>\) の中でサービスを照会する方法を示します。  
+  
+```  
+public override object ConvertFrom(ITypeDescriptorContext typeDescriptorContext, CultureInfo cultureInfo, object source) { IRootObjectProvider rootProvider = typeDescriptorContext.GetService(typeof(IRootObjectProvider)) as IRootObjectProvider; if (rootProvider != null && source is String) { //return something, else ... } throw GetConvertFromException(source); }  
+```  
+  
+<a name="services_for_a_value_serializer"></a>   
+## 値シリアライザー サービス  
+ 値シリアライザーのコンテキストでは、<xref:System.Windows.Markup.ValueSerializer> クラスに固有のサービス プロバイダー型 <xref:System.Windows.Markup.IValueSerializerContext> を使用します。 このコンテキストは、<xref:System.Windows.Markup.ValueSerializer> の 4 つの仮想メソッドのオーバーライドに渡されます。 サービスを取得するには、コンテキストから <xref:System.IServiceProvider.GetService%2A> を呼び出します。  
+  
+<a name="using_the_xaml_service_provider_contexts"></a>   
+## XAML サービス プロバイダー コンテキストの使用  
+ マークアップ拡張機能または型コンバーターで使用できる XAML サービスにアクセスするための <xref:System.IServiceProvider.GetService%2A> のサービス プロバイダーは、内部クラスとして実装されており、インターフェイスを通して、および関連コンテキストに渡されるという方法を通してのみ公開されます。 読み込みパスまたは保存パスの既定の .NET Framework XAML サービス実装にある XAML 処理操作が、サービス コンテキストを必要とする関連マークアップ拡張機能または型コンバーター メソッドを呼び出すと、この内部オブジェクトが渡されます。 状況に応じて、システムのサービス コンテキストは `MarkupExtensionContext` か `TextSyntaxContext` を提供しますが、これら両方のクラスの詳細は内部にあります。 これらのクラスとの対話は、<xref:System.IServiceProvider.GetService%2A> を通してサービスを要求することに限定されます。  
+  
+<a name="available_systemxaml_services"></a>   
+## .NET Framework XAML サービス コンテキストから使用できるサービス  
+ .NET Framework XAML サービスは、マークアップ拡張機能、型コンバーター、値シリアライザーに加え、その他の使用も可能なサービスを定義します。 この後のセクションでは、これらの各サービスについて説明し、実装でのサービスの使用方法についてガイダンスを提供します。  
+  
+### IServiceProvider  
+ **リファレンス ドキュメント**: <xref:System.IServiceProvider>  
+  
+ **関連:** <xref:System.IServiceProvider.GetService%2A?displayProperty=fullName> を呼び出すための、.NET Framework でのサービス ベースのインフラストラクチャの基本的な操作。  
+  
+### ITypeDescriptorContext  
+ **リファレンス ドキュメント**: <xref:System.ComponentModel.ITypeDescriptorContext>  
+  
+ <xref:System.IServiceProvider> から派生します。 このクラスは <xref:System.ComponentModel.TypeConverter> の標準シグネチャのコンテキストを表します。<xref:System.ComponentModel.TypeConverter> は、.NET Framework 1.0 の時点から存在していたクラスです。 つまり、XAML や、文字列値の型変換という XAML <xref:System.ComponentModel.TypeConverter> のシナリオが登場する前から使用されていました。 .NET Framework XAML サービスのコンテキストでは、<xref:System.ComponentModel.TypeConverter> のメソッドは明示的に実装されます。 その明示的な実装の動作により、<xref:System.ComponentModel.ITypeDescriptorContext> API が XAML の型システムまたは XAML からのオブジェクトの読み取りや書き込みに関連したものでないことが、呼び出し側に示されます。<xref:System.ComponentModel.ITypeDescriptorContext.Container%2A>、<xref:System.ComponentModel.ITypeDescriptorContext.Instance%2A>、および <xref:System.ComponentModel.ITypeDescriptorContext.PropertyDescriptor%2A> は、一般に、.NET Framework XAML サービス コンテキストから `null` が返されます。  
+  
+### IValueSerializerContext  
+ **リファレンス ドキュメント**: <xref:System.Windows.Markup.IValueSerializerContext>  
+  
+ <xref:System.ComponentModel.ITypeDescriptorContext> から派生します。これについても、XAML の型システムに不適切な影響を与えないようにするために、明示的な実装に依存します。<xref:System.Windows.Markup.ValueSerializer> の静的ルックアップ ヘルパー メソッドをサポートします。  
+  
+### IXamlTypeResolver  
+ **リファレンス ドキュメント**: <xref:System.Windows.Markup.IXamlTypeResolver>  
+  
+ **定義元:**  <xref:System.Windows.Markup> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパスのシナリオ、および XAML スキーマ コンテキストとの対話  
+  
+ **サービス API:**  <xref:System.Windows.Markup.IXamlTypeResolver.Resolve%2A>  
+  
+ XAML ライターがオブジェクト グラフに CLR オブジェクトを構築するときに必要な、XAML から CLR への型マッピングに影響を与えることができます。<xref:System.Windows.Markup.IXamlTypeResolver.Resolve%2A> は、XAML の型名 \(<xref:System.Xaml.XamlType.Name%2A?displayProperty=fullName>\) に対応する、プレフィックス修飾されていることのある文字列を処理し、CLR の <xref:System.Type> を返します。 型の解決は、通常、XAML スキーマ コンテキストに大きく依存します。 XAML スキーマ コンテキストだけが、どのアセンブリが読み込まれているか、これらのアセンブリの中で、型を解決するためにアクセスできる、またはアクセスする必要があるものはどれかといった考慮事項を認識しています。  
+  
+### IUriContext  
+ **リファレンス ドキュメント**: <xref:System.Windows.Markup.IUriContext>  
+  
+ **定義元:**  <xref:System.Windows.Markup> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** URI または `x:Uri` 値であるメンバー値を処理する読み込みパスおよび保存パス。  
+  
+ **サービス API:**  <xref:System.Windows.Markup.IUriContext.BaseUri%2A>  
+  
+ このサービスは、グローバルに使用できる URI ルート \(存在する場合\) を報告します。 URI ルートは、相対 URI を絶対 URI に解決する場合、またはその逆を行う場合に使用できます。 このシナリオは主に、特定のフレームワークによって、またはフレームワークでよく使用されるルート要素クラスの機能によって公開されるアプリケーション サービスに関連しています。 ベース URI は、XAML リーダーの設定として確立することができます。その後、XAML オブジェクト ライターに渡され、このサービスによってレポートされます。  
+  
+### IAmbientProvider  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IAmbientProvider>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 型の参照の遅延または最適化を処理する読み込みパス。  
+  
+ **サービス API:**  <xref:System.Xaml.IAmbientProvider.GetAllAmbientValues%2A>、その他 3 つ。  
+  
+ XAML におけるアンビエンスの概念は、型の特定のメンバーをアンビエントとしてマーク付けする手法です。 あるいは、型のインスタンスを保持するすべてのプロパティ値をアンビエント プロパティと見なす必要がある場合には、型をアンビエントにすることもできます。 XAML ノード ストリームの先にあるか、オブジェクト グラフの下位にあるマークアップ拡張機能または型コンバーターは、読み込み時にアンビエント プロパティまたは型インスタンスにアクセスしたり、保存時にアンビエント構造の情報を活用したりできます。 これにより、<xref:System.Windows.Markup.IXamlTypeResolver> や `x:Type` など、その他のサービスの型解決に必要な修飾の程度が左右されます。 「<xref:System.Xaml.AmbientPropertyValue>」も参照してください。  
+  
+### IXamlSchemaContextProvider  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IXamlSchemaContextProvider>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパス、および XAML 型をバッキング型に解決する必要があるその他の操作。  
+  
+ **サービス API:**  <xref:System.Xaml.IXamlSchemaContextProvider.SchemaContext%2A>  
+  
+ 遅延コンテンツを統合するには、同じスキーマ コンテキストを遅延領域に対しても適用する必要があるので、遅延読み込み操作には XAML スキーマ コンテキストが必要です。 XAML スキーマ コンテキストの役割の詳細については、「[XAML Services](../../../docs/framework/xaml-services/index.md)」を参照してください。  
+  
+### IRootObjectProvider  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IRootObjectProvider>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパス。  
+  
+ **サービス API:**  <xref:System.Xaml.IRootObjectProvider.RootObject%2A>  
+  
+ このサービスは、特定のフレームワークによって、またはフレームワークでよく使用されるルート要素クラスの機能によって公開されるアプリケーション サービスに関連しています。 ルート オブジェクトを取得する 1 つのシナリオは、分離コードとイベント接続をつなげることです。 たとえば、`x:Class` の WPF 実装は、マークアップ コンパイルと、XAML マークアップの他の場所にあるイベント ハンドラー属性の関連付けにおいて使用されます。 マークアップ コンパイルの部分クラスで定義されたマークアップと分離コードのコネクション ポイントは、ルート要素です。  
+  
+### IXamlNamespaceResolver  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IXamlNamespaceResolver>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパス、保存パス。  
+  
+ **サービス API:** 読み込みパスの場合は <xref:System.Xaml.IXamlNamespaceResolver.GetNamespace%2A>、保存パスの場合は <xref:System.Xaml.IXamlNamespaceResolver.GetNamespacePrefixes%2A>。  
+  
+ <xref:System.Xaml.IXamlNamespaceResolver> は、元の XAML マークアップで対応付けられたプレフィックスに基づく XAML 名前空間 ID\/URI を返すことができるサービスです。  
+  
+### IProvideValueTarget  
+ **リファレンス ドキュメント**: <xref:System.Windows.Markup.IProvideValueTarget>  
+  
+ **定義元:**  <xref:System.Windows.Markup> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパス、保存パス。  
+  
+ **サービス API:**  <xref:System.Windows.Markup.IProvideValueTarget.TargetObject%2A>、<xref:System.Windows.Markup.IProvideValueTarget.TargetProperty%2A>。  
+  
+ 型コンバーターまたはマークアップ拡張機能は、<xref:System.Windows.Markup.IProvideValueTarget> を使用して、読み込み時に動作している場所に関するコンテキストを取得できます。 実装では、このコンテキストを使用して、特定の使用を無効にすることもできます。 たとえば、WPF では、<xref:System.Windows.DynamicResourceExtension> などの一部のマークアップ拡張機能内にロジックを保持しています。 そのロジックは、<xref:System.Windows.Markup.IProvideValueTarget.TargetProperty%2A> を確認して、依存関係のあるプロパティ \(または、その他の依存関係のないプロパティの短い一覧\) を設定する場合にのみ拡張機能が使用されるようにできます。  
+  
+### IXamlNameResolver  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IXamlNameResolver>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパスのオブジェクト グラフ定義、`x:Name`、`x:Reference` またはフレームワーク固有の手法によって識別されるオブジェクトの解決。  
+  
+ **サービス API:**  <xref:System.Xaml.IXamlNameResolver.Resolve%2A>、前方参照を処理する場合などの高度なシナリオで使用されるその他の API。  
+  
+ .NET Framework XAML サービスでの `x:Reference` 処理の 実装は、このサービスに依存しています。 特定のフレームワークまたはそのフレームワークをサポートするツールは、このサービスを使用して、`x:Name` の処理、または同等の \(<xref:System.Windows.Markup.RuntimeNamePropertyAttribute> 属性で指定された\) プロパティの処理を行います。  
+  
+### IDestinationTypeProvider  
+ **リファレンス ドキュメント**: <xref:System.Xaml.IDestinationTypeProvider>  
+  
+ **定義元:**  <xref:System.Xaml> 名前空間、System.Xaml アセンブリ  
+  
+ **関連:** 読み込みパスでの間接的な CLR 型情報の解決。  
+  
+ **サービス API:** <xref:System.Xaml.IDestinationTypeProvider.GetDestinationType%2A>  
+  
+ 詳細については、「<xref:System.Xaml.IDestinationTypeProvider>」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Markup.MarkupExtension>   
+ <xref:System.Xaml.XamlObjectWriter>   
+ [Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)   
+ [Type Converters for XAML Overview](../../../docs/framework/xaml-services/type-converters-for-xaml-overview.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md b/docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md
new file mode 100644
index 00000000000..19d2623d0fb
--- /dev/null
+++ b/docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md
@@ -0,0 +1,80 @@
+---
+title: "Type Converters and Markup Extensions for XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], type converter services"
+  - "XAML [XAML Services], value converters"
+  - "XAML [XAML Services], markup extension services"
+  - "value converters for XAML [XAML Services]"
+  - "XAML [XAML Services], service context"
+ms.assetid: db07a952-05ce-4aa4-b6f9-aac7397d0326
+caps.latest.revision: 13
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Type Converters and Markup Extensions for XAML
+型コンバーターとマークアップ拡張機能は、XAML 型システムと XAML ライターが、オブジェクト グラフ コンポーネントを生成するために使用する 2 つの手法です。 型コンバーターとマークアップ拡張機能は、一部の特性を共有しますが、XAML ノード ストリームでは異なる方法で表現されます。 このドキュメント セットでは、型コンバーター、マークアップ拡張機能、およびこれに類似したコンストラクトを、値コンバーターと総称することがあります。  
+  
+<a name="value_converters"></a>   
+## 値コンバーター  
+ XAML では、さまざまなシナリオで値コンバーターが使用されます。 XAML におけるさまざまな種類の値コンバーターは次のとおりです。  
+  
+-   型コンバーター  
+  
+-   マークアップ拡張機能  
+  
+-   値シリアライザー  
+  
+-   XAML テキスト構文のロジックを提供する関連クラスまたはサポート クラス  
+  
+<a name="type_converters"></a>   
+## 型コンバーター  
+ .NET Framework XAML サービスの定義では、型コンバーターは CLR の <xref:System.ComponentModel.TypeConverter> クラスから派生したクラスです。<xref:System.ComponentModel.TypeConverter> は、XAML が登場する前から [!INCLUDE[TLA#tla_netframewk](../../../includes/tlasharptla-netframewk-md.md)] に存在していたクラスです。 当初の目的は、プロパティ ウィンドウや、[!INCLUDE[TLA2#tla_ide](../../../includes/tla2sharptla-ide-md.md)] プロパティの同様のテキスト ベースの編集をサポートすることでした。 .NET Framework に導入された XAML では、<xref:System.ComponentModel.TypeConverter> を使用して、テキスト構文 \(属性値または XAML 値ノードに含まれる\) をオブジェクトに変換します。 また、<xref:System.ComponentModel.TypeConverter> を使用して、オブジェクト値をテキスト構文にシリアル化することもできます。 さらに、<xref:System.ComponentModel.TypeConverter> は、[!INCLUDE[TLA#tla_wpf](../../../includes/tlasharptla-wpf-md.md)] および [!INCLUDE[vsindigo](../../../includes/vsindigo-md.md)] といった以前のフレームワーク固有の XAML 実装でも使用されていました。 XAML の <xref:System.ComponentModel.TypeConverter> の詳細については、「[Type Converters for XAML Overview](../../../docs/framework/xaml-services/type-converters-for-xaml-overview.md)」を参照してください。  
+  
+<a name="markup_extensions"></a>   
+## マークアップ拡張機能  
+ .NET Framework XAML サービスの実装では、マークアップ拡張機能は <xref:System.Windows.Markup.MarkupExtension> クラスから派生したクラスです。 この形式のマークアップ拡張機能は、XAML 言語で考案された概念です。 マークアップ拡張機能は、サービス クラスを呼び出してロジックを提供する、拡張性を持ったエスケープ シーケンスのようなものと考えることができます。 マークアップの観点からすると、XAML プロセッサは、テキスト文字列内の左中かっこ \({\) で始まるテキスト シーケンスによってマークアップ拡張機能を汎用的に認識します。  
+  
+ マークアップ拡張機能は、型コンバーターとは異なります。 型コンバーターは、通常、型またはメンバーに関連付けられ、 オブジェクト グラフの作成またはシリアル化においてそれらのエンティティに関連付けられたテキスト構文が検出されると呼び出されます。  
+  
+ マークアップ拡張機能は、単一のサポート サービス クラスに関連付けられますが、任意のメンバー値に適用できます。 \(ただし、マークアップ拡張機能の実装では、サービス コンテキストを使用することにより、その用途を特定のメンバーまたは変換先の型に意図的に制限することもできます。\) マークアップ拡張機能は、型コンバーターの関連付けをオーバーライドできます。 または、テキスト構文をサポートしないメンバーの属性値を指定するためにマークアップ拡張機能を使用することもできます。  
+  
+ XAML でのマークアップ拡張機能の実装パターンの詳細については、「[Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Windows.Markup.MarkupExtension> 型と <xref:System.Windows.Markup.ValueSerializer> 型はどちらも、<xref:System.Xaml> 名前空間ではなく、<xref:System.Windows.Markup> 名前空間にあります。 このことは、これらの型が WPF テクノロジまたは [!INCLUDE[TLA2#tla_winforms](../../../includes/tla2sharptla-winforms-md.md)] テクノロジのいずれかに固有であることを意味しません \(`Windows` という文字列を含む CLR 名前空間を設定しているとはいえ\)。<xref:System.Windows.Markup.MarkupExtension> と <xref:System.Windows.Markup.ValueSerializer> は System.Xaml アセンブリにあり、特定のフレームワークとの依存関係はありません。[!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では、これらの型は CLR 名前空間に存在し、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] でも引き続き CLR 名前空間に残っているので、既存の WPF プロジェクトの参照は破損しません。 詳細については、「[Types Migrated from WPF to System.Xaml](../../../docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md)」を参照してください。  
+  
+<a name="value_serializers"></a>   
+## 値シリアライザー  
+ <xref:System.Windows.Markup.ValueSerializer> は、オブジェクトを文字列に変換するために最適化された特殊な型コンバーターです。 XAML の <xref:System.Windows.Markup.ValueSerializer> は、`ConvertFrom` メソッドを一切実装しません。<xref:System.Windows.Markup.ValueSerializer> 実装は、<xref:System.ComponentModel.TypeConverter> 実装と同様の方法でサービスを取得します 仮想メソッドは入力 `context` パラメーターを提供しています。`context` パラメーターの型は <xref:System.Windows.Markup.IValueSerializerContext> であり、<xref:System.IServiceProvider> インターフェイスを継承し、<xref:System.IServiceProvider.GetService%2A> メソッドを持ちます。  
+  
+ XAML 型システムと、シリアル化のために XAML ノード ループ処理を使用する XAML ライターの実装では、型またはメンバーに関連付けられた値コンバーターは、独自の <xref:System.Xaml.XamlType.ValueSerializer%2A?displayProperty=fullName> プロパティによって報告されます。 シリアル化を実行する XAML ライターにとっては、<xref:System.Xaml.XamlType.TypeConverter%2A?displayProperty=fullName> と <xref:System.Xaml.XamlType.ValueSerializer%2A?displayProperty=fullName> が存在する場合には、読み込みパス用に型コンバーターを使用し、保存パス用に値シリアライザーを使用する必要があるということを意味しています。<xref:System.Xaml.XamlType.TypeConverter%2A?displayProperty=fullName> は存在するものの、<xref:System.Xaml.XamlType.ValueSerializer%2A?displayProperty=fullName> が `null` の場合は、保存パス用にも型コンバーターを使用します。  
+  
+<a name="other_value_converters"></a>   
+## その他の値コンバーター  
+ 値コンバーターは、型コンバーターまたはマークアップ拡張機能の特定のパターンを超えて拡張できます。 ただし、このカスタマイズを行うには、.NET Framework XAML サービスによって提供される XAML 型システムも再定義する必要があります。 既存の XAML 型システムには、型コンバーター、マークアップ拡張機能、および値シリアライザー向けの表現とレポート システムがありますが、値変換のカスタム形式向けの表現とレポート システムはありません。 カスタム値コンバーターを作成する場合は、<xref:System.Xaml.Schema.XamlValueConverter%601> 型を使用します。  
+  
+<a name="type_converters_and_markup_extensions_in_combination"></a>   
+## 型コンバーターとマークアップ拡張機能の組み合わせ  
+ マークアップ拡張機能と型コンバーターは、XAML の異なる状況で使用されます。 マークアップ拡張機能の使用時にはコンテキストを利用できますが、マークアップ拡張機能が値を提供するプロパティの型変換動作は一般にマークアップ拡張機能の実装ではチェックされません。 つまり、マークアップ拡張機能が `ProvideValue` 出力としてテキスト文字列を返す場合でも、特定のプロパティまたはプロパティ値型に適用される、その文字列に対する型変換動作は呼び出されません。 一般に、マークアップ拡張機能の目的は、型コンバーターを呼び出さずに文字列を処理してオブジェクトを返すことです。  
+  
+<a name="service_context_for_a_value_converter"></a>   
+## 値コンバーターのサービス コンテキスト  
+ 値コンバーターを実装する際には、通常、値コンバーターが適用されるコンテキストにアクセスする必要があります。 このコンテキストは、サービス コンテキストと呼ばれます。 サービス コンテキストには、アクティブな XAML スキーマ コンテキスト、XAML スキーマ コンテキストや XAML オブジェクト ライターが提供する型マッピング システムへのアクセスなどの情報が含まれます。 値コンバーターで使用可能なサービス コンテキストとサービス コンテキストが提供するサービスへのアクセス方法の詳細については、「[Service Contexts Available to Type Converters and Markup Extensions](../../../docs/framework/xaml-services/service-contexts-available-to-type-converters-and-markup-extensions.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Markup.MarkupExtension>   
+ <xref:System.Xaml.XamlObjectWriter>   
+ [Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)   
+ [Type Converters for XAML Overview](../../../docs/framework/xaml-services/type-converters-for-xaml-overview.md)   
+ [Service Contexts Available to Type Converters and Markup Extensions](../../../docs/framework/xaml-services/service-contexts-available-to-type-converters-and-markup-extensions.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/type-converters-for-xaml-overview.md b/docs/framework/xaml-services/type-converters-for-xaml-overview.md
new file mode 100644
index 00000000000..c7ed2eb466b
--- /dev/null
+++ b/docs/framework/xaml-services/type-converters-for-xaml-overview.md
@@ -0,0 +1,120 @@
+---
+title: "Type Converters for XAML Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], type converters"
+  - "XAML [XAML Services], TypeConverter"
+  - "type conversion for XAML [XAML Services]"
+ms.assetid: 51a65860-efcb-4fe0-95a0-1c679cde66b7
+caps.latest.revision: 14
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Type Converters for XAML Overview
+型コンバーターは、XAML マークアップの文字列をオブジェクト グラフの特定のオブジェクトに変換するオブジェクト ライターのロジックを提供します。 .NET Framework XAML サービスでは、型コンバーターは <xref:System.ComponentModel.TypeConverter> から派生したクラスである必要があります。 一部のコンバーターは XAML 保存パスもサポートしており、オブジェクトをシリアル化マークアップの文字列形式にシリアル化するために使用されます。 このトピックでは、XAML の型コンバーターがいつ、どのように起動されるかについて説明し、<xref:System.ComponentModel.TypeConverter> のメソッドのオーバーライドの実装についてアドバイスします。  
+  
+<a name="type_conversion_concepts"></a>   
+## 型変換の概念  
+ 以下のセクションで、XAML が文字列を使用する方法や、.NET Framework XAML サービスのオブジェクト ライターが型コンバーターを使用して XAML ソースに含まれる文字列値の一部を処理する方法について、基本的な概念を説明します。  
+  
+### XAML と文字列値  
+ XAML ファイルで属性値を設定する場合、その値の最初の型は一般的な意味での文字列であり、XML の意味としては文字列の属性値です。<xref:System.Double> など、その他のプリミティブも、XAML プロセッサに対して最初は文字列です。  
+  
+ ほとんどの場合、XAML プロセッサは、属性値を処理するために 2 つの情報を必要とします。 第 1 の情報は、設定しようとしているプロパティの値の型です。 属性値を定義するすべての文字列は、XAML で処理され、最終的にはその型の値に変換 \(解決\) される必要があります。 値が、XAML パーサーで認識できるプリミティブ \(数値など\) である場合は、文字列の直接的な変換が試みられます。 属性の値が列挙体を参照している場合は、指定された文字列がその列挙体の名前付き定数に一致するかどうか確認されます。 値がパーサーで認識されるプリミティブでも列挙体の定数名でもない場合、適用可能な型は、変換後の文字列に基づく値または参照を提供できる必要があります。  
+  
+> [!NOTE]
+>  XAML 言語ディレクティブでは、型コンバーターは使用されません。  
+  
+### 型コンバーターとマークアップ拡張機能  
+ マークアップ拡張機能の使用は、プロパティの型やその他の考慮事項を確認する前に、XAML プロセッサで処理される必要があります。 たとえば、属性として設定されるプロパティが、通常は型変換を行うものの、特定のケースではマークアップ拡張機能を使用して設定するという場合は、マークアップ拡張機能の動作が最初に処理されます。 マークアップ拡張機能が必要になる 1 つの一般的な状況は、既に存在するオブジェクトを参照する場合です。 このシナリオでは、ステートレスな型コンバーターは新しいインスタンスを生成することしかできないため、望ましくありません。 マークアップ拡張機能について詳しくは、「[Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)」をご覧ください。  
+  
+### ネイティブな型コンバーター  
+ WPF および .NET の XAML サービス実装では、特定の CLR 型でネイティブな型の変換処理が行われます。ただし、それらの CLR 型は慣例としてプリミティブとは考えられていません。 このような型の例として、<xref:System.DateTime> が挙げられます。 この理由の 1 つは、.NET Framework のアーキテクチャがどのように機能するかにあります。<xref:System.DateTime> 型は、.NET の最も基本的なライブラリである mscorlib で定義されています。<xref:System.DateTime> の属性を設定する時は、別のアセンブリから来る属性を使用して従属関係を持ち込むことができません \(<xref:System.ComponentModel.TypeConverterAttribute> は System から\)。したがって、属性による通常の型コンバーターの検出機構はサポートできません。 代わりに、XAML パーサーは、ネイティブな処理が必要な型の一覧を保持し、それらの型を通常のプリミティブの処理と類似した方法で処理します。<xref:System.DateTime> の場合、その処理には <xref:System.DateTime.Parse%2A> の呼び出しが含まれます。  
+  
+<a name="Implementing_a_Type_Converter"></a>   
+## 型コンバーターの実装  
+ 以下のセクションで、<xref:System.ComponentModel.TypeConverter> クラスの API について説明します。  
+  
+### TypeConverter  
+ .NET Framework の XAML サービスの下では、XAML の目的で使用されるすべての型コンバーターは、基底クラス <xref:System.ComponentModel.TypeConverter> から派生したクラスです。<xref:System.ComponentModel.TypeConverter> クラスは、XAML が登場するより前のバージョンの .NET Framework にも含まれていました。<xref:System.ComponentModel.TypeConverter> を使用する元々のシナリオの 1 つは、ビジュアル デザイナーのプロパティ エディターに文字列の変換を提供することでした。  
+  
+ XAML では、<xref:System.ComponentModel.TypeConverter> の役割が拡張されました。 XAML の目的では、<xref:System.ComponentModel.TypeConverter> は、特定の文字列への変換と特定の文字列からの変換をサポートする基底クラスです。 文字列からの変換は、XAML から文字列属性値への解析に利用されます。 文字列への変換は、特定のオブジェクト プロパティの実行時の値をシリアル化のために XAML の属性に戻す処理に利用されます。  
+  
+ <xref:System.ComponentModel.TypeConverter> には、XAML を処理する目的で、文字列への変換と文字列からの変換に関連する次の 4 つのメンバーが定義されています。  
+  
+-   <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.ConvertTo%2A>  
+  
+-   <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A>  
+  
+ これらのメンバーの中で最も重要なメソッドは <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> であり、入力文字列を必要なオブジェクトの型に変換します。<xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> メソッドの実装では、さまざまな型をコンバーターの目的とする型に変換する処理を実現できます。 したがって、実行時の変換をサポートするなど、XAML 以外の目的でも使用できます。 ただし、XAML の用途では、<xref:System.String> 入力を処理できるコード パスのみが重要です。  
+  
+ 次に重要なメソッドは <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> です。 アプリケーションをマークアップ表現に変換する場合 \(たとえば、アプリケーションをファイルとして XAML に保存する場合\)、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> は、マークアップ表現を生成する XAML テキスト ライターという、より大きなシナリオに関与します。 この場合、XAML にとって重要なコード パスは、呼び出し元が <xref:System.String> の `destinationType` を渡す時です。  
+  
+ <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> と <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A> は、サービスが <xref:System.ComponentModel.TypeConverter> の実装の機能を照会する時に使用されるサポート メソッドです。 これらのメソッドは、その型について、相当する変換メソッドをコンバーターがサポートしている場合に `true` を返すように実装する必要があります。 XAML の目的では、通常、<xref:System.String> 型であることを意味します。  
+  
+### カルチャ情報と XAML の型コンバーター  
+ 各 <xref:System.ComponentModel.TypeConverter> 実装では、変換に対して有効な文字列を独自に解釈できます。また、パラメーターとして渡される型の説明を使用することも無視することもできます。 カルチャと XAML の型変換については、重要な考慮事項があります。ローカライズ可能な文字列を属性値として使用することは XAML でサポートされていますが、それらのローカライズ可能な文字列を、特定のカルチャ要件を指定して型コンバーターの入力として使用することはできません。 この制限の理由は、XAML 属性値の型コンバーターには、特定の言語に固定して \(`en-US` カルチャを使用して\) 実行しなければならない XAML 処理の動作がどうしても含まれるためです。 この制限の設計上の理由について詳しくは、XAML 言語仕様 \([\[MS\-XAML\]](http://go.microsoft.com/fwlink/?LinkId=114525)\) または「[WPF のグローバリゼーションおよびローカリゼーションの概要](../../../docs/framework/wpf/advanced/wpf-globalization-and-localization-overview.md)」をご覧ください。  
+  
+ カルチャが問題となる例として、一部のカルチャで文字列形式の数値の小数点記号にピリオドではなくコンマが使用されることが挙げられます。 そのように使用した場合、区切り記号としてコンマを使用する多くの既存の型コンバーターで、動作が競合します。 周囲の XAML で `xml:lang` を使用してカルチャを指定しても、この問題は解決しません。  
+  
+### ConvertFrom の実装  
+ XAML をサポートする <xref:System.ComponentModel.TypeConverter> の実装としてコンバーターを使用できるようにするためには、そのコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> メソッドが `value` パラメーターとして文字列を受け入れる必要があります。 文字列が有効な形式であり、<xref:System.ComponentModel.TypeConverter> 実装で変換できる場合、実装から返すオブジェクトは、プロパティで想定される型へのキャストをサポートしている必要があります。 それ以外の場合、<xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> 実装は `null` を返す必要があります。  
+  
+ 各 <xref:System.ComponentModel.TypeConverter> 実装では、変換に対して有効な文字列の構成内容を独自に解釈できます。また、パラメーターとして渡される型の説明やカルチャ コンテキストを使用することも無視することもできます。 ただし、WPF による XAML 処理では、型の説明コンテキストに値を渡さない場合があり、`xml:lang` に基づくカルチャを渡さない場合もあります。  
+  
+> [!NOTE]
+>  文字列の書式の要素として中かっこ \({}\)、特に左中かっこ \({\) は使用しないでください。 これらの文字は、マークアップ拡張シーケンスの開始および終了を示す文字として予約されています。  
+  
+ 型コンバーターが .NET Framework XAML サービスのオブジェクト ライターから XAML サービスにアクセスする必要があるものの、そのコンテキストで <xref:System.IServiceProvider.GetService%2A> を呼び出してもそのサービスが返されない場合は、例外をスローするのが適切です。  
+  
+### ConvertTo の実装  
+ <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> は、シリアル化のサポートで使用される可能性があります。 カスタム型およびその型コンバーターに対して <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> によるシリアル化をサポートすることは、絶対要件ではありません。 ただし、コントロールを実装する場合、またはクラスの機能または設計の一部としてシリアル化を使用する場合は、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> を実装する必要があります。  
+  
+ XAML をサポートする <xref:System.ComponentModel.TypeConverter> の実装としてコンバーターを使用できるようにするためには、そのコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> メソッドが、サポートされる型のインスタンス \(または値\) を `value` パラメーターとして受け入れる必要があります。`destinationType` パラメーターが <xref:System.String> 型の場合、返されるオブジェクトは <xref:System.String> にキャストできる必要があります。 返される文字列は、`value` のシリアル化された値を表している必要があります。 理想としては、採用するシリアル化の形式は、その文字列を同じコンバーターの <xref:System.ComponentModel.TypeConverter.ConvertFrom%2A> の実装に渡した場合と比べて情報の大きな損失が発生することなく、同じ値を生成できる必要があります。  
+  
+ 値をシリアル化できない場合、またはコンバーターがシリアル化をサポートしていない場合は、<xref:System.ComponentModel.TypeConverter.ConvertTo%2A> の実装は `null` を返す必要があり、例外をスローできます。 ただし、例外をスローする場合は、<xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> 実装の一部として、その変換を使用できないことを通知するようにしてください。そうすれば、まず <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> を確認することによって例外を回避するというベスト プラクティスをサポートできます。  
+  
+ `destinationType` パラメーターが <xref:System.String> 型でない場合は、独自のコンバーター処理を実装できます。 通常は、基底の実装の処理に戻り、基底の <xref:System.ComponentModel.TypeConverter.ConvertTo%2A> で特定の例外を発生させます。  
+  
+ 型コンバーターが .NET Framework XAML サービスのオブジェクト ライターから XAML サービスにアクセスする必要があるものの、そのコンテキストで <xref:System.IServiceProvider.GetService%2A> を呼び出してもそのサービスが返されない場合は、例外をスローするのが適切です。  
+  
+### CanConvertFrom の実装  
+ <xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A> の実装は、`sourceType` が <xref:System.String> 型の場合は `true` を返し、それ以外の場合は基底の実装に任せる必要があります。<xref:System.ComponentModel.TypeConverter.CanConvertFrom%2A> から例外をスローしないでください。  
+  
+### CanConvertTo の実装  
+ <xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> の実装は、`destinationType` が <xref:System.String> 型の場合は `true` を返し、それ以外の場合は基底の実装に任せる必要があります。<xref:System.ComponentModel.TypeConverter.CanConvertTo%2A> から例外をスローしないでください。  
+  
+<a name="Applying_the_TypeConverterAttribute"></a>   
+## TypeConverterAttribute の適用  
+ .NET Framework XAML サービスでカスタム型コンバーターがカスタム クラス用の型コンバーターとして実際に使用されるようにするには、[!INCLUDE[TLA#tla_netframewkattr](../../../includes/tlasharptla-netframewkattr-md.md)] の <xref:System.ComponentModel.TypeConverterAttribute> をクラス定義に適用する必要があります。 属性を通して指定する <xref:System.ComponentModel.TypeConverterAttribute.ConverterTypeName%2A> は、カスタム型コンバーターの型名である必要があります。 この属性を適用すると、プロパティの型としてカスタム クラスの型が使用されている値を XAML プロセッサが処理する際に、入力文字列を処理して、オブジェクトのインスタンスを返すことができます。  
+  
+ また、プロパティごとに型コンバーターを提供することもできます。 クラス定義に [!INCLUDE[TLA#tla_netframewkattr](../../../includes/tlasharptla-netframewkattr-md.md)] の <xref:System.ComponentModel.TypeConverterAttribute> を適用する代わりに、プロパティ定義 \(メイン定義内の `get`\/`set` 実装ではなくメイン定義自体\) に適用します。 プロパティの型は、カスタム型コンバーターによって処理される型と一致する必要があります。 この属性を適用すると、プロパティの値を XAML プロセッサが処理する際に、入力文字列を処理して、オブジェクトのインスタンスを返すことができます。 プロパティごとに型コンバーターを提供する手法は、[!INCLUDE[TLA#tla_netframewk](../../../includes/tlasharptla-netframewk-md.md)] やその他のライブラリなど、クラス定義を制御することができず、<xref:System.ComponentModel.TypeConverterAttribute> を適用できないライブラリからプロパティの型を使用する場合に特に便利です。  
+  
+ アタッチされたカスタム メンバーの型変換動作を割り当てるには、アタッチされたメンバーの実装パターンの `Get` アクセサー メソッドに <xref:System.ComponentModel.TypeConverterAttribute> を適用します。  
+  
+<a name="accessing_service_provider_context_from_a_markup_extension_implementation"></a>   
+## マークアップ拡張機能の実装からサービス プロバイダーのコンテキストにアクセスする  
+ 使用可能なサービスは、すべての値コンバーターの場合と同じです。 ただし、それぞれの値コンバーターがサービス コンテキストを受け取る方法が違います。 サービスへのアクセスと、使用できるサービスについては、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」のトピックをご覧ください。  
+  
+<a name="type_converters_in_the_xaml_node_stream"></a>   
+## XAML ノード ストリームでの型コンバーター  
+ XAML ノード ストリームを処理している場合、型コンバーターのアクションや最終結果はまだ実行されていません。 読み込みパスでは、読み込むために最終的に型変換する必要がある属性文字列は、開始メンバーおよび終了メンバー内でテキスト値のままです。 この処理のために最終的に必要になる型コンバーターは、<xref:System.Xaml.XamlMember.TypeConverter%2A?displayProperty=fullName> プロパティを使用することで判別できます。 ただし、<xref:System.Xaml.XamlMember.TypeConverter%2A?displayProperty=fullName> から有効な値を取得するには、基になるメンバー、またはメンバーが使用するオブジェクト値の型を介してこのような情報にアクセスできる XAML スキーマ コンテキストを持っていることが必要です。 型変換の動作を呼び出すためにも、型マッピングと、コンバーター インスタンスの作成が必要であるため、XAML スキーマ コンテキストが必要になります。  
+  
+## 参照  
+ <xref:System.ComponentModel.TypeConverterAttribute>   
+ [Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md b/docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md
new file mode 100644
index 00000000000..b5a895a4d91
--- /dev/null
+++ b/docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md
@@ -0,0 +1,136 @@
+---
+title: "Types Migrated from WPF to System.Xaml | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "WPF XAML [XAML Services], migration to System.Xaml"
+  - "XAML [XAML Services], System.Xaml and WPF"
+  - "System.Xaml [XAML Services], types migrated from WPF"
+ms.assetid: d79dabf5-a2ec-4e8d-a37a-67c4ba8a2b91
+caps.latest.revision: 14
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Types Migrated from WPF to System.Xaml
+[!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] および [!INCLUDE[net_v30_long](../../../includes/net-v30-long-md.md)] では、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] と [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] の両方に XAML 言語の実装が含まれていました。 WPF XAML 実装に拡張性を与えていたパブリック型の多くは、WindowsBase、PresentationCore、および PresentationFramework アセンブリに存在していました。 同様に、[!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] XAML に拡張性を与えていたパブリック型は System.Workflow.ComponentModel アセンブリにありました。[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、XAML 関連の型の一部が System.Xaml アセンブリに移行されました。 XAML 言語サービスの一般的な .NET Framework 実装では、もともと特定のフレームワークの XAML 実装によって定義されていた XAML 機能拡張のシナリオの多くを、今では全体的な [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] XAML 言語サポートの一部として使用できるようになりました。 このトピックでは、移行された型を紹介し、移行に伴う問題について説明します。  
+  
+<a name="assemblies_and_namespaces"></a>   
+## アセンブリと名前空間  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では、WPF が XAML をサポートするために実装していた型は、一般に <xref:System.Windows.Markup> 名前空間にありました。 これらの型の多くは WindowsBase アセンブリにありました。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] には、新しい <xref:System.Xaml> 名前空間と、新しい System.Xaml アセンブリがあります。 当初は WPF XAML 向けとして実装されていた型の多くが、今では XAML の任意の実装用の機能拡張ポイントまたはサービスとして提供されています。 より一般的なシナリオでも使用できるようにするため、型は元の WPF アセンブリから System.Xaml アセンブリに型転送されました。 これにより、他のフレームワーク \(WPF や [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] など\) のアセンブリを含めることなく、XAML 機能拡張シナリオを有効にできるようになりました。  
+  
+ 移行した型のほとんどは、<xref:System.Windows.Markup> 名前空間に残っています。 これは、既存の実装で CLR 名前空間マッピングが破損するのをファイルごとに回避するための策でもあります。 その結果、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の <xref:System.Windows.Markup> 名前空間には、XAML 言語をサポートする一般的な型 \(System.Xaml アセンブリにあったもの\) と、XAML の WPF 実装に固有の型 \(WindowsBase およびその他の WPF アセンブリにあったもの\) が混在しています。 System.Xaml に移行されたものの、以前は WPF アセンブリにあった型は、バージョン 4 の WPF アセンブリで型転送がサポートされています。  
+  
+### ワークフロー XAML サポート型  
+ [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] では XAML のサポート型も提供しており、多くの場合は、WPF に相当する同じ短い名前でした。[!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] の XAML サポート型の一覧を次に示します。  
+  
+-   <xref:System.Workflow.ComponentModel.Serialization.ContentPropertyAttribute>  
+  
+-   <xref:System.Workflow.ComponentModel.Serialization.RuntimeNamePropertyAttribute>  
+  
+-   <xref:System.Workflow.ComponentModel.Serialization.XmlnsPrefixAttribute>  
+  
+ これらのサポート型は引き続き [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] アセンブリ内に存在し、今でも特定の [!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] アプリケーションで使用できますが、[!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] を使用しないアプリケーションまたはフレームワークでは参照できません。  
+  
+<a name="markupextension"></a>   
+## MarkupExtension  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では、WPF の <xref:System.Windows.Markup.MarkupExtension> クラスは WindowsBase アセンブリにありました。[!INCLUDE[TLA#tla_workflow](../../../includes/tlasharptla-workflow-md.md)] の並列クラスである <xref:System.Workflow.ComponentModel.Serialization.MarkupExtension> は、System.Workflow.ComponentModel アセンブリにありました。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、<xref:System.Windows.Markup.MarkupExtension> クラスは System.Xaml アセンブリに移行されています。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、<xref:System.Windows.Markup.MarkupExtension> は、特定のフレームワーク上に構築される XAML 機能拡張シナリオだけではなく、.NET Framework XAML サービスを使用する任意の XAML 機能拡張シナリオを対象としています。 特定のフレームワーク、またはフレームワーク内のユーザー コードも、可能な限り、XAML 機能拡張の <xref:System.Windows.Markup.MarkupExtension> クラス上に構築する必要があります。  
+  
+<a name="markupextension_supporting_service_classes"></a>   
+## MarkupExtension をサポートするサービス クラス  
+ WPF 向けの [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] と [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では、<xref:System.Windows.Markup.MarkupExtension> の実装側で使用できるいくつかのサービスと、XAML での型\/プロパティの使用をサポートする <xref:System.ComponentModel.TypeConverter> の実装が提供されていました。 これらのサービスを次に示します。  
+  
+-   <xref:System.Windows.Markup.IProvideValueTarget>  
+  
+-   <xref:System.Windows.Markup.IUriContext>  
+  
+-   <xref:System.Windows.Markup.IXamlTypeResolver>  
+  
+> [!NOTE]
+>  マークアップ拡張機能に関連するもう 1 つの [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] のサービスとして、<xref:System.Windows.Markup.IReceiveMarkupExtension> インターフェイスがあります。 <xref:System.Windows.Markup.IReceiveMarkupExtension> は移行されず、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では `[Obsolete]` とマーク付けされています。 以前に <xref:System.Windows.Markup.IReceiveMarkupExtension> を使用していたシナリオは、代わりに <xref:System.Windows.Markup.XamlSetMarkupExtensionAttribute> 属性付きコールバックを使用する必要があります。<xref:System.Windows.Markup.AcceptedMarkupExtensionExpressionTypeAttribute> も `[Obsolete]` とマーク付けされています。  
+  
+<a name="xaml_language_features"></a>   
+## XAML 言語機能  
+ WPF 向けのいくつかの XAML 言語機能とコンポーネントは、以前は PresentationFramework アセンブリにありました。 これらの機能やコンポーネントは <xref:System.Windows.Markup.MarkupExtension> のサブクラスとして実装され、XAML マークアップでのマークアップ拡張機能の使用を公開していました。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、これらは System.Xaml アセンブリにあるので、WPF アセンブリを組み込んでいないプロジェクトでも、これらの XAML 言語レベルの機能を使用できます。 WPF では、これと同じ実装を [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] アプリケーションに対して使用しています。 このトピックで示す他のケースと同様に、サポート型は <xref:System.Windows.Markup> 名前空間に引き続き存在するので、以前の参照は破損されません。  
+  
+ System.Xaml で定義されている XAML 機能のサポート クラスを次の表に示します。  
+  
+|XAML 言語機能|使用法|  
+|---------------|---------|  
+|<xref:System.Windows.Markup.ArrayExtension>|`<x:Array ...>`|  
+|<xref:System.Windows.Markup.NullExtension>|`{x:Null}`|  
+|<xref:System.Windows.Markup.StaticExtension>|`{x:Static ...}`|  
+|<xref:System.Windows.Markup.TypeExtension>|`{x:Type ...}`|  
+  
+ System.Xaml には特定のサポート クラスはありませんが、XAML 言語の言語機能を処理するための一般的なロジックは System.Xaml にあり、それを実装した XAML リーダーと XAML ライターにも含まれています。 たとえば、`x:TypeArguments` は System.Xaml 実装の XAML リーダーと XAML ライターによって処理される属性です。これは XAML ノード ストリームで示すことができ、既定の \(CLR ベースの\) XAML スキーマ コンテキストに処理があり、XAML 型システム表現があります。 その結果、XAML 言語レベルのすべての機能に関するリファレンス ドキュメントは、WPF ドキュメント セットに属する「[詳細設定 \(Windows Presentation Foundation\)](../../../docs/framework/wpf/advanced/index.md)」のサブトピックとしてではなく \(3.5 のドキュメント セットは今でもここにあります\)、[XAML Services](../../../docs/framework/xaml-services/index.md)と .NET Framework ドキュメント セットの一般分野のサブトピックとして掲載されています。  
+  
+<a name="valueserializer_and_supporting_classes"></a>   
+## ValueSerializer とサポートするクラス  
+ <xref:System.Windows.Markup.ValueSerializer> クラスは、特に、シリアル化のために出力に複数のモードまたはノードが必要となる XAML シリアル化のケースで、文字列への型変換をサポートしています。[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では、WPF の <xref:System.Windows.Markup.ValueSerializer> は WindowsBase アセンブリにありました。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、<xref:System.Windows.Markup.ValueSerializer> クラスは System.Xaml にあり、WPF 上に構築される XAML 機能拡張シナリオだけではなく、すべての XAML 機能拡張シナリオを対象としています。 <xref:System.Windows.Markup.IValueSerializerContext> \(サポート サービス\) および <xref:System.Windows.Markup.DateTimeValueSerializer> \(固有のサブクラス\) も System.Xaml に移行されました。  
+  
+<a name="xamlrelated_attributes"></a>   
+## XAML 関連の属性  
+ WPF XAML には、XAML の動作について何かを示すために CLR 型に適用される属性がいくつか含まれています。[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] で WPF アセンブリ内に存在していた属性の一覧を次に示します。 [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、これらの属性は System.Xaml に移行されました。  
+  
+-   <xref:System.Windows.Markup.AmbientAttribute>  
+  
+-   <xref:System.Windows.Markup.ContentPropertyAttribute>  
+  
+-   <xref:System.Windows.Markup.ContentWrapperAttribute>  
+  
+-   <xref:System.Windows.Markup.DependsOnAttribute>  
+  
+-   <xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute>  
+  
+-   <xref:System.Windows.Markup.NameScopePropertyAttribute>  
+  
+-   <xref:System.Windows.Markup.RootNamespaceAttribute>  
+  
+-   <xref:System.Windows.Markup.RuntimeNamePropertyAttribute>  
+  
+-   <xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute>  
+  
+-   <xref:System.Windows.Markup.ValueSerializerAttribute>  
+  
+-   <xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute>  
+  
+-   <xref:System.Windows.Markup.XmlLangPropertyAttribute>  
+  
+-   <xref:System.Windows.Markup.XmlnsCompatibleWithAttribute>  
+  
+-   <xref:System.Windows.Markup.XmlnsDefinitionAttribute>  
+  
+-   <xref:System.Windows.Markup.XmlnsPrefixAttribute>  
+  
+<a name="miscellaneous_classes"></a>   
+## その他のクラス  
+ <xref:System.Windows.Markup.IComponentConnector> インターフェイスは、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では WindowsBase にありましたが、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では System.Xaml にあります。 <xref:System.Windows.Markup.IComponentConnector> は、主にツーリングのサポートと XAML マークアップ コンパイラーを目的としています。  
+  
+ <xref:System.Windows.Markup.INameScope> インターフェイスは、[!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] および [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] では WindowsBase にありましたが、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では System.Xaml にあります。 <xref:System.Windows.Markup.INameScope> は、XAML 名前空間に対する基本的な操作を定義します。  
+  
+<a name="xamlrelated_classes_with_shared_names_that_exist_in_wpf_and_systemxaml"></a>   
+## WPF と System.Xaml に存在する共通の名前を持つ XAML 関連クラス  
+ 次に示すクラスは、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] で、WPF アセンブリと System.Xaml アセンブリの両方に存在します。  
+  
+ `XamlReader`  
+  
+ `XamlWriter`  
+  
+ `XamlParseException`  
+  
+ WPF 実装は、<xref:System.Windows.Markup> 名前空間にあり、PresentationFramework アセンブリに含まれています。 System.Xaml 実装は、<xref:System.Xaml> 名前空間にあります。 WPF 型を使用する場合や、WPF 型から派生する場合は、一般に、System.Xaml 実装ではなく <xref:System.Windows.Markup.XamlReader> および <xref:System.Windows.Markup.XamlWriter> の WPF 実装を使用する必要があります。 詳細については、<xref:System.Windows.Markup.XamlReader?displayProperty=fullName> および <xref:System.Windows.Markup.XamlWriter?displayProperty=fullName> の解説セクションを参照してください。  
+  
+ WPF アセンブリと System.Xaml の両方を参照しており、<xref:System.Windows.Markup> 名前空間と <xref:System.Xaml> 名前空間の両方に対して `include` ステートメントを使用している場合は、あいまいさを排除して型を解決するために、これらの API への呼び出しを完全修飾する必要があることがあります。  
+  
+## 参照  
+ [XAML Services](../../../docs/framework/xaml-services/index.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md b/docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md
new file mode 100644
index 00000000000..3fc4bb80fed
--- /dev/null
+++ b/docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md
@@ -0,0 +1,219 @@
+---
+title: "Understanding XAML Node Stream Structures and Concepts | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML node streams [XAML Services]"
+  - "nodes [XAML Services], XAML node stream"
+  - "XAML [XAML Services], XAML node streams"
+ms.assetid: 7c11abec-1075-474c-9d9b-778e5dab21c3
+caps.latest.revision: 14
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Understanding XAML Node Stream Structures and Concepts
+.NET Framework XAML サービスに実装されている XAML リーダーと XAML ライターは、XAML ノード ストリームの設計概念に基づいています。 XAML ノード ストリームは、一連の XAML ノードを概念化したものです。 この概念化では、XAML プロセッサは、XAML 内のノードのリレーションシップの構造を 1 つずつ処理します。 常に、開いている XAML ノード ストリームに存在する現在のレコードまたは現在の位置は 1 つのみで、API の多くの側面がレポートするのは、その位置から入手できる情報のみです。 XAML ノード ストリームの現在のノードは、オブジェクト、メンバー、または値として記述できます。 XAML を XAML ノード ストリームとして扱うことで、XAML リーダーは XAML ライターと通信するとともに、XAML に関するパスの読み込みまたはパスの保存操作中に、XAML ノード ストリームのコンテンツをプログラムが表示、操作、または変更できるようにします。 XAML リーダーおよびライターの API の設計と XAML ノード ストリームの概念は、[!INCLUDE[TLA#tla_xmldom](../../../includes/tlasharptla-xmldom-md.md)] および <xref:System.Xml.XmlReader> クラスと <xref:System.Xml.XmlWriter> クラスなど、以前の関連するリーダーとライターの設計と概念に似ています。 このトピックでは、XAML ノード ストリームの概念について説明するとともに、XAML ノード レベルで XAML 表現と対話するルーチンを記述する方法について説明します。  
+  
+<a name="loading_into_a_xaml_reader"></a>   
+## XAML リーダーに XAML を読み込む  
+ <xref:System.Xaml.XamlReader> 基底クラスは、初期の XAML を XAML リーダーに読み込む特定の手法を宣言しません。 代わりに、派生クラスが、XAML の一般的な特性と入力ソースの制約などの読み込みの手法を宣言および実装します。 たとえば、 <xref:System.Xaml.XamlObjectReader> は、オブジェクト グラフの読み取りを、ルートまたはベースを表す 1 つのオブジェクトの入力ソースから開始します。<xref:System.Xaml.XamlObjectReader> はその後、オブジェクト グラフから XAML ノード ストリームを生成します。  
+  
+ .NET Framework XAML サービスで定義する最も目立つ <xref:System.Xaml.XamlReader> サブクラスは <xref:System.Xaml.XamlXmlReader> です。<xref:System.Xaml.XamlXmlReader> は、初期の XAML を、直接ストリームまたはファイルのパスを経由してテキスト ファイル読み込むか、<xref:System.IO.TextReader> などの関連するリーダー クラスを経由して間接的に読み込みます。<xref:System.Xaml.XamlReader> は、XAML 入力ソースが読み込まれた後には、その全体を格納していると考えることができます。 ただし、 <xref:System.Xaml.XamlReader> のベース API は、リーダーが XAML の 1 つのノードと対話するように設計されています。 初めて読み込まれるときに表示される最初の 1 つのノードは、XAML のルートとその開始オブジェクトです。  
+  
+### XAML ノード ストリームの概念  
+ 全般に DOM、ツリーの比喩、または XML ベースのテクノロジにアクセスするクエリに基づいたアプローチがより使い慣れている場合、XAML ノード ストリームの概念化に役立つ方法は次のとおりです。 読み込まれた XAML が、 DOM またはツリーで、可能な限りすべてのノードが幅広く拡張され、直線的に表示されるところを想像してください。 ノードを進んでいくうちに、DOM に関連するレベルの " in" または "out" レベルを走査することがありますが、これらのレベルの概念はノード ストリームと関係がないため、XAML ノード ストリームは明示的に追跡しません。 ノード ストリームには、「現在の」位置がありますが、参照として自分でストリームのその他の部分を格納していない限り、現在のノードの位置を除くノード ストリームのすべての側面は表示されません。  
+  
+ XAML ノード ストリームの概念には、ノード ストリーム全体を通過すると、XAML 表現全体が処理されたことが保証されるという大きな利点があります。情報を処理するためのクエリ、DOM の操作、またはその他の非線形アプローチで、完全な XAML 表現の一部が不足していると心配する必要はありません。 このため、XAML ノード ストリーム表現は、XAML リーダーと XAML ライターの両方の接続、および XAML 処理操作の読み取りと書き込みの各フェーズの間で動作する独自のプロセスを挿入できるシステムを用意するのに最適です。 多くの場合、XAML ノード ストリーム内のノードの順序付けは、順序がソース テキスト、バイナリ、またはオブジェクト グラフで表示されるしくみと比較して、XAML リーダーによって意図的に最適化または表示されます。 この動作は、ノード ストリームにおいて、XAML ライターが「戻る」必要がある位置に存在しない XAML 処理アーキテクチャを適用することを意図しています。 理想としては、すべての XAML の書き込み操作が、スキーマ コンテキストとノード ストリームの現在の位置に基づいて動作できる必要があります。  
+  
+<a name="a_basic_reading_node_loop"></a>   
+## 基本的な読み取りノードのループ  
+ XAML ノード ストリームを検査するための基本的な読み取りノードのループは、次の概念で構成されます。 このトピックで説明したようなノード ループの目的から、<xref:System.Xaml.XamlXmlReader> を使用して人間が判読できるテキスト ベースの XAML ファイルを読み取ることを想定してください。 このセクションのリンクは、<xref:System.Xaml.XamlXmlReader> が実装する特別な XAML ノード ループ API を指しています。  
+  
+-   XAML ノード ストリームの終わりになっていないことを確認してください \(<xref:System.Xaml.XamlXmlReader.IsEof%2A> を確認するか、<xref:System.Xaml.XamlXmlReader.Read%2A> の戻り値を使用します\)。 ストリームの終わりになっている場合は、現在のノードはないため、終了する必要があります。  
+  
+-   <xref:System.Xaml.XamlXmlReader.NodeType%2A> を呼び出して、XAML ノード ストリームが現在どのような種類のノードを公開しているかを確認します。  
+  
+-   直接接続されている、関連する XAML オブジェクト ライターを使用している場合は、通常はこの時点で <xref:System.Xaml.XamlWriter.WriteNode%2A> を呼び出します。  
+  
+-   どの <xref:System.Xaml.XamlNodeType> が現在のノードまたは現在のレコードとして報告されているかに基づいて、次のいずれかを呼び出して、ノードのコンテンツに関する情報を取得します。  
+  
+    -   <xref:System.Xaml.XamlNodeType> または <xref:System.Xaml.XamlNodeType> の <xref:System.Xaml.XamlXmlReader.NodeType%2A> の場合、<xref:System.Xaml.XamlXmlReader.Member%2A> を呼び出して、メンバーに関する <xref:System.Xaml.XamlMember> の情報を取得します。 メンバーは <xref:System.Xaml.XamlDirective> である可能性があるため、必ずしも前のオブジェクトの従来の型が定義されたメンバーでない可能性があることに注意してください。 たとえば、オブジェクトに適用された `x:Name` は XAML メンバーとして表示されます。ここで、<xref:System.Xaml.XamlMember.IsDirective%2A> は true、メンバーの <xref:System.Xaml.XamlMember.Name%2A> は `Name` で、このディレクティブが XAML 言語の XAML 名前空間の下にあることを示すその他のプロパティがあります。  
+  
+    -   <xref:System.Xaml.XamlNodeType> または <xref:System.Xaml.XamlNodeType> の <xref:System.Xaml.XamlXmlReader.NodeType%2A> の場合は、<xref:System.Xaml.XamlXmlReader.Type%2A> を呼び出して、オブジェクトに関する <xref:System.Xaml.XamlType> の情報を取得します。  
+  
+    -   <xref:System.Xaml.XamlNodeType> の <xref:System.Xaml.XamlXmlReader.NodeType%2A> で、<xref:System.Xaml.XamlXmlReader.Value%2A> を呼び出します。 ノードがメンバーの最も単純な表現である場合、またはオブジェクトの初期化のテキストである場合のみ、ノードは値になります \(ただし、このトピックの以下のセクションに記載する型変換の動作に注意する必要があります\)。  
+  
+    -   <xref:System.Xaml.XamlNodeType> の <xref:System.Xaml.XamlXmlReader.NodeType%2A> の場合は、<xref:System.Xaml.XamlXmlReader.Namespace%2A> を呼び出して、名前空間ノードの名前空間情報を取得します。  
+  
+-   <xref:System.Xaml.XamlXmlReader.Read%2A> を呼び出して、XAML リーダーを XAML ノード ストリームの次のノードに進め、手順を繰り返します。  
+  
+ .NET Framework XAML サービスの XAML リーダーが提供する XAML ノード ストリームは、常に実行可能なすべてのノードの完全かつ詳細なトラバースを提供します。 XAML ノード ループの一般的なフロー制御の手法には、`while (reader.Read())` 内の本文の定義、およびノード ループの各ノード ポイントにおける <xref:System.Xaml.XamlXmlReader.NodeType%2A> の切り替えなどがあります。  
+  
+ ノード ストリームがファイルの終わりにある場合、現在のノードは null です。  
+  
+ リーダーとライターを使用する最も簡単なループは、次の例に似ています。  
+  
+```  
+XamlXmlReader xxr = new XamlXmlReader(new StringReader(xamlStringToLoad)); //where xamlStringToLoad is a string of well formed XAML XamlObjectWriter xow = new XamlObjectWriter(xxr.SchemaContext); while (xxr.Read()) { xow.WriteNode(xxr); }  
+```  
+  
+ 読み込みパスの XAML ノード ループの基本的な例では、XAML リーダーと XAML ライターが透過的に接続されています。<xref:System.Xaml.XamlServices.Parse%2A?displayProperty=fullName> を使用した場合と違いはありません。 しかし、この基本構造は、読み取りと書き込みのシナリオに適用するように拡張されます。 可能なシナリオは次のとおりです。  
+  
+-   <xref:System.Xaml.XamlXmlReader.NodeType%2A> で切り替える。 読み込まれているノードの型によって、さまざまな操作を実行する。  
+  
+-   どの場合にも <xref:System.Xaml.XamlWriter.WriteNode%2A> を呼び出さない。 一部の <xref:System.Xaml.XamlXmlReader.NodeType%2A> の場合のみ <xref:System.Xaml.XamlWriter.WriteNode%2A> を呼び出す。  
+  
+-   特定のノード型のロジックで、そのノードの詳細を分析して操作します。 たとえば、特定の XAML 名前空間からのオブジェクトのみを記述し、その XAML 名前空間以外からのオブジェクトをすべて削除または延期します。 または、XAML システムがメンバーの処理の一部としてサポートしていないすべての XAML ディレクティブを削除または再処理することができます。  
+  
+-   `Write*` メソッドをオーバーライドするカスタムの <xref:System.Xaml.XamlObjectWriter> を定義します。場合によっては XAML スキーマ コンテキストをバイパスする型マッピングを実行します。  
+  
+-   XAML の動作の違いのカスタマイズをリーダーとライターの両方で使用できるように、<xref:System.Xaml.XamlXmlReader> を構築して既定以外の XAML スキーマ コンテキストを使用します。  
+  
+### ノード ループの概念を超えた XAML へのアクセス  
+ XAML ノード ループとして使用する以外に XAML 表現を使用する可能性があるその他の方法があります。 たとえば、インデックス付きのノードを読み取ることができる XAML リーダー、特に `x:Name`、`x:Uid`、またはその他の識別子を介して直接ノードにアクセスする XAML リーダーが存在することがあります。 .NET framework XAML サービスは、完全な実装を提供していませんが、サービスとサポートの種類を通じて推奨されたパターンを提供します。 詳細については、次のトピックを参照してください。<xref:System.Xaml.IXamlIndexingReader> および<xref:System.Xaml.XamlNodeList>.  
+  
+> [!TIP]
+>  Microsoft では、Microsoft XAML Toolkit と呼ばれるアウトオブバンド リリースも生成しています。 このアウトオブバンド リリースは、まだプレリリース段階です。 しかし、プレリリース版のコンポーネントの使用をご希望の場合、Microsoft XAML Toolkit では、XAML ツールと XAML の静的分析用の興味深いリソースが提供されています。 Microsoft XAML Toolkit には、XAML DOM API、FxCop の分析のサポート、および Silverlight の XAML スキーマ コンテキストが含まれています。 詳細については、「[Microsoft XAML Toolkit](http://code.msdn.microsoft.com/XAML)」を参照してください。  
+  
+<a name="working_with_the_current_node"></a>   
+## 現在のノードの操作  
+ XAML ノード ループを使用するほとんどのシナリオは、ノードの読み取りだけを行うわけではありません。 ほとんどのシナリオでは、現在のノードを処理し、<xref:System.Xaml.XamlWriter> の実装に 1 回に 1 ノードずつ渡します。  
+  
+ 一般的な読み込みパスりのシナリオでは、<xref:System.Xaml.XamlXmlReader> は XAML ノード ストリームを生成します。XAML ノードは、ロジックと XAML スキーマ コンテキストに従って処理され、ノードは <xref:System.Xaml.XamlObjectWriter> に渡されます。 続いて、生成されたオブジェクト グラフをアプリケーションまたはフレームワークに統合します。  
+  
+ 一般的な保存パスのシナリオでは、<xref:System.Xaml.XamlObjectReader> がオブジェクト グラフを読み取り、個々の XAML ノードが処理され、<xref:System.Xaml.XamlXmlWriter> が XAML テキスト ファイルとしてシリアル化された結果を出力します。 重要なことは、パスとシナリオの両方で 1 回に 1 つの XAML ノードのみを操作することと、XAML 型のシステムと .NET Framework XAML サービス API が定義する標準化された方法で XAML ノードの処理が行えることです。  
+  
+### フレームとスコープ  
+ XAML ノード ループは、線形的な方法で XAML ノード ストリーム全体を通過します。 ノード ストリームは、オブジェクト、他のオブジェクトを含むメンバーなどを走査します。 フレームとスタックの概念を実装して XAML ノード ストリーム内のスコープを追跡すると役立つことがよくあります。 ノード ストリームの使用中に積極的に調整する場合は、特に役立ちます。 ノード ループのロジックの一部として実装するフレームとスタックのサポートでは、DOM の観点から構造を考える場合、XAML ノードの構造に下りる際に `StartObject` \(または `GetObject`\) と `EndObject` スコープをカウントすることがあります。  
+  
+<a name="traversing_and_entering_object_nodes"></a>   
+## オブジェクトのノードの走査と入力  
+ XAML リーダーによって開かれたときのノード ストリームの最初のノードは、ルート オブジェクトの開始オブジェクト ノードです。 定義上、このオブジェクトは常に 1 つのオブジェクト ノードで、ピアはありません。 現実世界の XAML の例では、ルート オブジェクトがより多くのオブジェクトを保持する 1 つ以上のプロパティを持つように定義されます。これらのプロパティにはメンバー ノードがあります。 メンバー ノードには、1 つ以上のオブジェクト ノードがあるか、代わりに値ノードで終了することもあります。 一般的に、ルート オブジェクトは XAML の名前のスコープを定義します。これは構文的に属性として XAML テキスト マークアップに割り当てられますが、XAML ノード ストリームの表現にある `Namescope` ノードの種類にマップされます。  
+  
+ 次の XAML の例を検討してください \(これは、.NET Framework の既存の型に基づいていない任意の XAML です\)。 このオブジェクト モデルでは、`FavorCollection` は `Favor` の `List<T>` であること、`Balloon` と `NoiseMaker` は `Favor` への割り当てが可能であること、`Balloon.Color` プロパティは `Color` オブジェクトに基づいていること \(WPF が色を既知の色の名前として定義する方法に似ています\)、および `Color` は属性の構文の型コンバーターをサポートすると想定します。  
+  
+|XAML マークアップ|結果となる XAML ノード ストリーム|  
+|-----------------|--------------------------|  
+|`<Party`|`Party` の `Namespace` ノード|  
+|`xmlns="PartyXamlNamespace">`|`Party` の `StartObject` ノード|  
+|`<Party.Favors>`|`Party.Favors` の `StartMember` ノード|  
+||暗黙的な `FavorCollection` の `StartObject` ノード|  
+||暗黙的な `FavorCollection` 項目のプロパティの `StartMember` ノード|  
+|`<Balloon`|`Balloon` の `StartObject` ノード|  
+|`Color="Red"`|`Color` の `StartMember` ノード<br /><br /> 属性値の文字列 `"Red"` の `Value` ノード<br /><br /> `Color` の `EndMember`|  
+|`HasHelium="True"`|`HasHelium` の `StartMember` ノード<br /><br /> 属性値の文字列 `"True"` の `Value` ノード<br /><br /> `HasHelium` の `EndMember`|  
+|`>`|`Balloon` の `EndObject`|  
+|`<NoiseMaker>Loudest</NoiseMaker>`|`NoiseMaker` の `StartObject` ノード<br /><br /> `_Initialization` の `StartMember` ノード<br /><br /> 初期化値の文字列 `"Loudest"` の `Value` ノード<br /><br /> `_Initialization` の `EndMember` ノード<br /><br /> `NoiseMaker` の `EndObject`|  
+||暗黙的な `FavorCollection` 項目のプロパティの `EndMember` ノード|  
+||暗黙的な `FavorCollection` の `EndObject` ノード|  
+|`</Party.Favors>`|`Favors` の `EndMember`|  
+|`</Party>`|`Party` の `EndObject`|  
+  
+ XAML ノード ストリームでは、次の動作に依存することができます。  
+  
+-   `Namespace` ノードが存在する場合は、`xmlns` で XAML 名前空間を宣言した `StartObject` の直前のストリームに追加されます。 もう一度、XAML と使用例のノード ストリームがある上記の表をご覧ください。`StartObject` ノードと `Namespace` ノードがテキストのマークアップでそれらの宣言の位置とどのように入れ替えられているかに注意してください。 これは、ノード ストリームで、名前空間ノードが常に適用するノードの前に表示される動作の典型です。 この設計の目的は、名前空間情報は、オブジェクト ライターにとって重要であり、オブジェクト ライターが型のマッピングの実行を試みる前 \(そうでなければオブジェクトを処理する前\) に知らされる必要があるということです。 ストリームで XAML 名前空間の情報をアプリケーションのスコープの前に配置すると、ノード ストリームを常に表示された順序で処理することが簡単になります。  
+  
+-   前述の考慮事項により、ノードをルートの `StartObject` からではなく最初から走査する場合、ほとんどの現実世界のマークアップのケースで最初に読み取る `Namespace` ノードは 1 つ以上になります。  
+  
+-   `StartObject` ノードの後には `StartMember`、`Value`、またはすぐに `EndObject` が続きます。 別の `StartObject` がすぐに続くことはありません。  
+  
+-   `StartMember` の後には `StartObject`、`Value`、またはすぐに `EndMember` が続きます。 新しい値をインスタンス化する `StartObject` ではなく、値が親オブジェクトの既存の値に由来すると想定されるメンバーの場合は、後に `GetObject` が続きます。 また、`Namespace` ノードも後に続きます。このノードは今後の `StartObject` に適用されます。 別の `StartMember` がすぐに続くことはありません。  
+  
+-   `Value` ノードは値自体を表します。 "EndValue" はありません。 後には `EndMember` のみが続きます。  
+  
+    -   構築で使用される可能性があるオブジェクトの XAML 初期化テキストは、オブジェクト \- 値構造の結果にはなりません。 代わりに、`_Initialization` という名前のメンバーの専用のメンバー ノードが作成されます。 そのメンバー ノードには、初期化値の文字列が含まれています。 存在する場合は、 `_Initialization` が常に最初の `StartMember` になります。 一部の XAML サービス表記では、`_Initialization` が XAML 言語の XAML 名前スコープで修飾して、`_Initialization` がバッキング タイプで定義されたプロパティでないことを明確にすることがあります。  
+  
+    -   メンバーと値の組み合わせは、値の属性設定を表します。 結局、この値の処理に関係する値コンバーターが使用されることがあり、値はプレーン文字列になります。 ただし、これは XAML オブジェクト ライターがこのノード ストリームを処理するまで評価されません。 XAML オブジェクト ライターには、必要な XAML スキーマ コンテキスト、型システムのマッピング、および値の変換に必要なその他のサポートが用意されています。  
+  
+-   `EndMember` ノードの後には、後続のメンバーとして `StartMember` ノード、またはメンバーの所有者として `EndObject` ノードが続きます。  
+  
+-   `EndObject` ノードの後には、`EndMember` ノードが続きます。 さらに、オブジェクトがコレクション アイテムのピアである場合は、`StartObject` ノードが後に続くこともあります。 または、`Namespace` ノードが後に続きます。このノードは今後の  `StartObject` に適用されます。  
+  
+    -   ノード ストリーム全体を閉じるという独特なケースでは、ルートの `EndObject` の後には何も続きません。リーダーはファイルの終わりになり、<xref:System.Xaml.XamlReader.Read%2A> は `false` を返します。  
+  
+<a name="value_converters_and_the_xaml_node_stream"></a>   
+## 値コンバーターと XAML ノード ストリーム  
+ 値コンバーターとは、マークアップ拡張機能、型コンバーター \(値のシリアライザーを含む\)、または XAML 型システムを介して値コンバーターとして報告されている別の専用のクラスの一般用語です。 XAML ノード ストリームでは、型コンバーターの使用法と、マークアップ拡張機能の使用法では、表現が非常に異なります。  
+  
+### XAML ノード ストリームでの型コンバーター  
+ 最終的に型コンバーターの使用になる属性セットは、メンバーの値として XAML ノード ストリームで報告されます。 XAML ノード ストリームは、型コンバーター インスタンス オブジェクトを生成してこれに値を渡そうとはしません。 型コンバーターの変換の実装を使用するには、XAML スキーマ コンテキストを呼び出して、型マッピングに使用する必要があります。 値の処理にどの型コンバーターのクラスを使用する必要があるかを決定する場合でも、XAML スキーマ コンテキストが間接的に必要になります。 既定の XAML スキーマ コンテキストを使用する場合は、対象の情報は XAML 型システムから使用できます。 XAML ライターへの接続の前に XAML ノード ストリーム レベルで型コンバーター クラスの情報が必要な場合、設定されているメンバーの <xref:System.Xaml.XamlMember> 情報から取得することができます。 しかし、それ以外の場合、たとえば XAML オブジェクト ライターによるオブジェクトの作成など、型マッピング システムと XAML スキーマ コンテキストを必要とする操作の残りの部分が実行されるまで、型コンバーターの入力は、プレーンの値として XAML ノード ストリームに保存される必要があります。  
+  
+ たとえば、次のクラス定義の概要とそれに対する XAML の使用を検討してください。  
+  
+```  
+public class BoardSizeConverter : TypeConverter { //converts from string to an int[2] by splitting on an "x" char } public class GameBoard { [TypeConverter(typeof(BoardSizeConverter))] public int[] BoardSize; //2x2 array, initialization not shown }  
+```  
+  
+```  
+<GameBoard BoardSize="8x8"/>  
+```  
+  
+ この使用法向けの XAML ノード ストリームのテキスト表現は、次のように表現できます。  
+  
+ `GameBoard` を表す `StartObject` と <xref:System.Xaml.XamlType>  
+  
+ `BoardSize` を表す `StartMember` と <xref:System.Xaml.XamlMember>  
+  
+ テキスト文字列 "`8x8`" がある `Value` ノード  
+  
+ `BoardSize` と一致する `EndMember`  
+  
+ `GameBoard` と一致する `EndObject`  
+  
+ このノード ストリームには型コンバーター インスタンスがないことに注意してください。 ただし、`BoardSize` の <xref:System.Xaml.XamlMember> で <xref:System.Xaml.XamlMember.TypeConverter%2A?displayProperty=fullName> を呼び出して、型コンバーター情報を取得することができます。 有効な XAML スキーマ コンテキストがある場合は、<xref:System.Xaml.Schema.XamlValueConverter%601.ConverterInstance%2A> からインスタンスを取得することでコンバーターのメソッドを呼び出すこともできます。  
+  
+### XAML ノード ストリームのマークアップ拡張機能  
+ マークアップ拡張機能の使用状況は、メンバー内のオブジェクト ノードとして XAML ノード ストリームで報告されます。ここで、オブジェクトはマークアップ拡張機能のインスタンスを表します。 そのため、マークアップ拡張機能の使用法は、型コンバーターの使用法より明示的にノード ストリームの表現で表され、より多くの情報を伝達できます。<xref:System.Xaml.XamlMember> の情報では、マークアップ拡張機能について何も述べることができませんでした。これは、使用法が状況に左右され、可能な各マークアップのケースで異なるためです。型コンバーターの場合のようには、使用法が型またはメンバーごとに専用かつ暗黙的なのではありません。  
+  
+ オブジェクトのノードとしてのマークアップ拡張機能のノード ストリームの表現は、マークアップ拡張機能の使用法が XAML テキスト マークアップ内の属性の形式である場合でも該当します \(多くの場合該当します\)。 明示的なオブジェクトの要素の形式を使用するマークアップ拡張機能の使用法は同じように扱われます。  
+  
+ マークアップ拡張機能のオブジェクト ノード内には、そのマークアップ拡張機能のメンバーが存在する可能性があります。 XAML ノード ストリームの表現では、位置指定のパラメーターの使用法か、明示的な名前付きパラメーターの使用法によって、そのマークアップ拡張機能の使用法が維持されます。  
+  
+ 位置指定のパラメーターの使用法の場合、XAML ノード ストリームには、使用状況を記録する、XAML 言語で定義されたプロパティ `_PositionalParameters` が含まれます。 このプロパティは、<xref:System.Object> 制約が付いたジェネリック <xref:System.Collections.Generic.List%601> です。 制約は、オブジェクトであり、文字列ではありません。位置指定のパラメーターの使用法では、場合によって、そのパラメーターの中に入れ子になったマークアップ拡張機能の使用法が含まれている可能性があるためです。 使用法から位置指定のパラメーターにアクセスするため、リストを反復処理してから、個々のリストの値にインデクサーを使用することがあります。  
+  
+ 名前付きパラメーターの使用法では、名前付きの各パラメーターは、ノード ストリームでその名前のメンバー ノードとして表されます。 メンバー値は必ずしも文字列とは限りません。入れ子になったマークアップ拡張機能の使用の可能性があるためです。  
+  
+ `ProvideValue` はマークアップ拡張機能から、まだ呼び出されていません。 ただし、ノード ストリームで `WriteEndObject` を確認する際、マークアップ拡張機能ノードで呼び出されるように XAML リーダーと XAML ライターを接続する場合はこれが呼び出されます。 このため、通常は、読み込みパスでオブジェクト グラフを形成するために使用するのと同じ XAML スキーマのコンテキストが使用できる必要があります。 それ以外の場合、すべてのマークアップ拡張機能の `ProvideValue` は、期待されるサービスが使用可能でないため、ここで例外をスローする可能性があります。  
+  
+<a name="xaml_and_xml_languagedefined_members_in_the_xaml_node_stream"></a>   
+## XAML ノード ストリームにおける XAML および XML 言語で定義されたメンバー  
+ 明示的な <xref:System.Xaml.XamlMember> の検索または構築を介してではなく、XAML リーダーの解釈と規約のため、特定のメンバーが XAML ノード ストリームに導入されています。 多くの場合、これらのメンバーは XAML ディレクティブです。 場合によっては、XAML ノード ストリームにディレクティブを導入する XAML の読み取りの動作になります。 つまり、元の XAML 入力テキストでは、メンバーのディレクティブを明示的に指定していませんでしたが、XAML リーダーは、構造的な XAML 規約とレポートの情報が失われる前に、XAML ノード ストリームでその情報を満たすために、ディレクティブを挿入します。  
+  
+ 次のリストは、XAML リーダーでディレクティブの XAML メンバー ノードの導入が期待されるすべてのケースと、.NET Framework XAML サービスの実装でそのメンバーのノードが識別される方法を記載しています。  
+  
+-   **オブジェクト ノードの初期化テキスト:** このメンバー ノードの名前は `_Initialization` です。この名前は XAML ディレクティブを表し、XAML 言語の XAML 名前空間で定義されます。 その静的なエンティティは <xref:System.Xaml.XamlLanguage.Initialization%2A> から取得できます。  
+  
+-   **マークアップ拡張機能の位置指定パラメーター:** このメンバー ノードの名前は `_PositionalParameters` です。この名前は、XAML 言語の XAML 名前空間で定義されます。 それには常にオブジェクトのジェネリック リストが含まれ、それぞれが入力 XAML で指定される `,` 区切り文字で分割して事前に分離された位置指定パラメーターになっています。<xref:System.Xaml.XamlLanguage.PositionalParameters%2A> から、位置指定パラメーター ディレクティブの静的なエンティティを取得できます。  
+  
+-   **不明なコンテンツ:**  このメンバー ノードの名前は `_UnknownContent`です。 厳密に言うと、これは <xref:System.Xaml.XamlDirective> で、XAML 言語の XAML 名前空間で定義されます。 このディレクティブは、XAML オブジェクト要素にソース XAML のコンテンツが含まれている場合は sentinel として使用されますが、現在使用できる XAML スキーマ コンテキストで決定できるコンテンツのプロパティはありません。`_UnknownContent` という名前のメンバーを確認すると、XAML ノード ストリームでこのケースを検出できます。 読み込みパスの XAML ノード ストリームでその他の処理が行われない場合、いずれかのオブジェクトで `_UnknownContent` のメンバーが検出されると、試行した <xref:System.Xaml.XamlObjectWriter> で既定の `WriteEndObject` がスローされます。 既定の <xref:System.Xaml.XamlXmlWriter> はスローされず、メンバーを暗黙の型として処理します。`_UnknownContent` の静的なエンティティは <xref:System.Xaml.XamlLanguage.UnknownContent%2A> から取得できます。  
+  
+-   **コレクションの Collection プロパティ:** XAML で使用されるコレクション クラスのバッキング CLR の型には、コレクション項目を保持する専用の名前が付いたプロパティがありますが、このプロパティは、バッキング型の解決までは XAML 型システムでは既知ではありません。 代わりに、XAML ノード ストリームでは、コレクションの XAML 型のメンバーとして `Items` プレース ホルダーを導入します。 .NET Framework XAML サービスの実装では、ノード ストリームのディレクティブまたはメンバーの名前は `_Items` です。 このディレクティブの定数は <xref:System.Xaml.XamlLanguage.Items%2A> から取得できます。  
+  
+     XAML ノード ストリームは、バッキング型の解決と XAML スキーマのコンテキストに基づいて解析不能になるアイテムがある Items プロパティを含む可能性があることに注意してください。 次に例を示します。  
+  
+-   **XMLで定義されたメンバー:** XML で定義された `xml:base`、`xml:lang`、`xml:space` の各メンバーは、.NET Framework XAML サービスの実装で `base`、`lang`、`space` という名前の XAML ディレクティブとして報告されます。 これらの名前空間は、XML 名前空間 `http://www.w3.org/XML/1998/namespace` です。 これらのそれぞれの定数は <xref:System.Xaml.XamlLanguage> から取得できます。  
+  
+## ノードの順序  
+ 場合によって <xref:System.Xaml.XamlXmlReader> は、マークアップに表示する場合、または XML として処理される場合に、ノードの表示順序と比較して、XAML ノード ストリームの XAML ノードの順序を変更します。 この変更は、<xref:System.Xaml.XamlObjectWriter> が順方向のみにノード ストリームを処理できるようにノードの順序を指定するために行います。  .NET Framework XAML サービスでは、XAML リーダーは、ノード ストリームの XAML オブジェクト ライターのコンシューマーのパフォーマンスの最適化として XAML ライターにこのタスクを任せるのではなく、ノードを並べ替えます。  
+  
+ 特定のディレクティブは、特にオブジェクト要素からオブジェクトを作成するために、より多くの情報を提供することを目的としています。 これらのディレクティブは `Initialization`、`PositionalParameters`、`TypeArguments`、`FactoryMethod`、`Arguments` です。 次のセクションで説明する理由から、.NET Framework XAML サービスの XAML リーダーは、オブジェクトの `StartObject` に続くノード ストリームの最初のメンバーとしてこれらのディレクティブを配置しようとします。  
+  
+### XamlObjectWriter の動作とノードの順序  
+ <xref:System.Xaml.XamlObjectWriter> に対する `StartObject` は、すぐにオブジェクト インスタンスを作成するための XAML オブジェクト ライターへのシグナルであるとは限りません。 XAML には、追加の入力を持つオブジェクトを初期化できるようにするとともに、最初のオブジェクトを生成する既定のコンストラクターを呼び出すことに全体的に依存せず、プロパティの設定のみを行えるようにする、いくつかの言語機能が含まれています。 これらの機能には、<xref:System.Windows.Markup.XamlDeferLoadAttribute>、初期化のテキスト、[x:TypeArguments](../../../docs/framework/xaml-services/x-typearguments-directive.md)、マークアップ拡張機能の位置指定パラメーター、工場出荷時のメソッド、および関連する [x:Arguments](../../../docs/framework/xaml-services/x-arguments-directive.md) ノード \(XAML 2009\) などがあります。 これらの各ケースは、実際のオブジェクトの構築を遅らせます。ノード ストリームの順序が変更されるため、XAML オブジェクト ライターは、具体的にはそのオブジェクトの種類の構築ディレクティブではない開始メンバーが検出されるたびに、実際にインスタンスを構築する動作に依存します。  
+  
+### GetObject  
+ `GetObject` は、XAML オブジェクト ライターが新しいオブジェクトを構築するのではなく、オブジェクトの包含プロパティの値を取得する必要がある XAML ノードを表します。 XAML ノード ストリームで `GetObject` ノードに発生する一般的なケースは、コレクション オブジェクトまたは辞書オブジェクトで、包含するプロパティがバッキング型のオブジェクト モデルで意図的に読み取り専用になる場合です。 このシナリオでは、コレクションまたは辞書は、多くの場合は所有する型の初期化ロジックによって作成および \(通常は空に\) 初期化されます。  
+  
+## 参照  
+ <xref:System.Xaml.XamlObjectReader>   
+ [XAML Services](../../../docs/framework/xaml-services/index.md)   
+ [XAML Namespaces](../../../docs/framework/xaml-services/xaml-namespaces-for-net-framework-xaml-services.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/whitespace-processing-in-xaml.md b/docs/framework/xaml-services/whitespace-processing-in-xaml.md
new file mode 100644
index 00000000000..aadf177464b
--- /dev/null
+++ b/docs/framework/xaml-services/whitespace-processing-in-xaml.md
@@ -0,0 +1,87 @@
+---
+title: "Whitespace Processing in XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "East Asian characters [XAML Services]"
+  - "XAML [XAML Services], whitespace processing"
+  - "whitespace processing in XAML [XAML Services]"
+  - "characters [XAML Services], East Asian"
+ms.assetid: cc9cc377-7544-4fd0-b65b-117b90bb0b23
+caps.latest.revision: 20
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Whitespace Processing in XAML
+XAML の言語規則では、空白の意味は [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] プロセッサの実装によって処理する必要があると定められています。 ここでは、それらの XAML 言語規則について説明します。 また、XAML プロセッサの [!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] 実装およびシリアル化用の XAML ライターで定義されている追加の空白処理についても説明します。  
+  
+<a name="whitespace_definition"></a>   
+## 空白の定義  
+ [!INCLUDE[TLA2#tla_xml](../../../includes/tla2sharptla-xml-md.md)] と調和して、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] の空白文字は、スペース、改行、およびタブです。 これらは、それぞれ [!INCLUDE[TLA#tla_unicode](../../../includes/tlasharptla-unicode-md.md)] 値の 0020、000A、および 0009 に対応します。  
+  
+<a name="whitespace_normalization"></a>   
+## 空白の正規化  
+ 既定では、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] プロセッサで [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] ファイルを処理する際に、次に示す空白の正規化が行われます。  
+  
+1.  東アジア言語の文字間の改行文字が削除されます。 この用語の定義については、後の「東アジア言語の文字」を参照してください。  
+  
+2.  すべての空白文字 \(スペース、改行、タブ\) は、スペースに変換されます。  
+  
+3.  連続した複数のスペースはすべて削除され、1 つのスペースに置換されます。  
+  
+4.  開始タグの直後にあるスペースは削除されます。  
+  
+5.  終了タグの直前にあるスペースは削除されます。  
+  
+ "既定" とは、[xml:space](../../../docs/framework/xaml-services/xml-space-handling-in-xaml.md) 属性の既定値で表される状態に対応します。  
+  
+<a name="whitespace_in_inner_text_and_string_primitives"></a>   
+## 内部テキスト内の空白、および文字列プリミティブ  
+ 前の正規化規則は、XAML 要素内で検出された内部テキストに適用されます。 正規化の後、XAML プロセッサは、次のようにして、すべての内部テキストを適切な型に変換します。  
+  
+-   プロパティの型がコレクションでなく、直接的に <xref:System.Object> 型でもない場合、XAML プロセッサはその型の型コンバーターを使用して、その型への変換を試みます。 その際、変換に失敗すると、コンパイル時のエラーが発生します。  
+  
+-   プロパティの型がコレクションで、内部テキストが連続している \(間に要素タグがない\) 場合、その内部テキストは単一の <xref:System.String> として解析されます。 そのコレクション型が <xref:System.String> を受け入れない場合にも、コンパイル時のエラーが発生します。  
+  
+-   プロパティの型が <xref:System.Object> である場合、その内部テキストは単一の <xref:System.String> として解析されます。 その内部テキストの中に要素タグが含まれている場合には、コンパイル時のエラーが発生します。これは、<xref:System.Object> 型は単一のオブジェクト \(<xref:System.String> またはそれ以外\) であることを意味しているためです。  
+  
+-   プロパティの型がコレクションであり、内部テキストが連続していないことがあります。この場合、最初の部分文字列は <xref:System.String> に変換されてコレクション項目として追加されます。中間にある要素はコレクション項目として追加され、この要素の後に続く部分文字列 \(存在する場合\) は 3 番目の <xref:System.String> 項目としてコレクションに追加されます。  
+  
+<a name="preserving_whitespace"></a>   
+## 空白の保持  
+ ソース[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] で空白を保持し、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] プロセッサによる空白の正規化の影響を受けずに最終的に表示されるようにするには、いくつかの手法があります。  
+  
+ **xml:space \="preserve"**: 空白を保持する必要がある要素のレベルで、この属性を指定します。 この場合、要素を視覚的にわかりやすい入れ子として "美しく表示する" ためにコード編集アプリケーションによって追加されたスペースも含めて、すべての空白が保持されます。 ただし、これらのスペースが表示されるかどうかは、スペースを含んでいる要素のコンテンツ モデルによって決まります。 オブジェクト モデルの大多数では、属性の設定にかかわらず、空白に意味があるとは見なされないため、`xml:space="preserve"` をルート レベルで指定しないでください。 グローバルに `xml:space` を設定すると、一部の実装で XAML 処理 \(特にシリアル化\) のパフォーマンスに影響することがあります。 この属性は、文字列内の空白を表示する必要のある要素のレベル、または空白が意味を持つコレクションである要素のレベルでのみ設定することをお勧めします。  
+  
+ **エンティティおよび改行しないスペース**: [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] では、テキスト オブジェクト モデル内に任意の [!INCLUDE[TLA#tla_unicode](../../../includes/tlasharptla-unicode-md.md)] エンティティを配置できます。 改行しないスペース \(UTF\-8 エンコーディングでは &\#160;\) など、専用のエンティティを使用できます。 また、改行しないスペース文字をサポートするリッチ テキスト コントロールを使用することもできます。 インデントなどのレイアウト特性をシミュレートするためにエンティティを使用する場合には、エンティティの実行時出力が、一般的なレイアウト システムにおけるインデントの生成機能を使用した場合よりも多くの要因 \(パネルや余白の適切な使用など\) に基づいて変化するため、注意が必要です。 たとえば、エンティティはフォントにマッピングされ、ユーザーのフォント選択に応じてサイズが変わる可能性があります。  
+  
+<a name="east_asian_characters"></a>   
+## 東アジア言語の文字  
+ "東アジア言語の文字" は、U\+20000 ～ U\+2FFFD および U\+30000 ～ U\+3FFFD の範囲の [!INCLUDE[TLA2#tla_unicode](../../../includes/tla2sharptla-unicode-md.md)] 文字のセットとして定義されています。 このサブセットは、「CJK 表意文字」と呼ばれることもあります。 詳細については、[http:\/\/www.unicode.org](http://www.unicode.org/) を参照してください。  
+  
+<a name="whitespace_and_text_content_models"></a>   
+## 空白とテキスト コンテンツ モデル  
+ 実際には、空白の保持は、すべてのコンテンツ モデルのサブセットに関してのみ問題になります。 このサブセットに含まれるのは、ある種のシングルトン <xref:System.String> 型、専用の <xref:System.String> コレクション、または <xref:System.Collections.IList> や <xref:System.Collections.Generic.ICollection%601> コレクションでの <xref:System.String> と他の型の組み合わせをとることのできるコンテンツ モデルです。  
+  
+### WPF での空白とテキスト コンテンツ モデル  
+ 一例として、このセクションの残りの部分では、WPF によって定義されている特定の型について説明します。 ここで説明する空白の処理機能は、一般に .NET Framework XAML サービスと WPF の両方に当てはまります。 これらの動作を実際に見るには、何かの WPF XAML マークアップを使用し、オブジェクト グラフでその結果を確認し、再度マークアップにシリアル化してください。  
+  
+ 文字列をとることのできるコンテンツ モデルの場合でも、そのコンテンツ モデル内での既定の動作では、残っているすべての空白は、意味のある空白としては扱われません。 たとえば、<xref:System.Windows.Controls.ListBox> は <xref:System.Collections.IList> を使用しますが、空白 \(各 <xref:System.Windows.Controls.ListBoxItem> の間の改行など\) は保持も表示もされません。 改行文字を <xref:System.Windows.Controls.ListBoxItem> 項目の文字列間の区切り記号として使用しても、まったく機能しません。改行文字で区切られた文字列は、1 つの文字列および 1 つの項目として扱われます。  
+  
+ 空白を意味のあるものとして扱うコレクションは、通常、フロー ドキュメント モデルの一部分です。 空白を保持する動作をサポートする主なコレクションには、<xref:System.Windows.Documents.InlineCollection> があります。 このコレクション クラスは <xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute> を使用して宣言します。この属性が検出されると、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] プロセッサはコレクション内の空白を意味のあるものとして扱います。`xml:space="preserve"` と、<xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute> を指定したコレクション内の空白の組み合わせでは、すべての空白は保持され、表示されます。`xml:space="default"` と、<xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute> 内の空白の組み合わせでは、前に説明した空白の初期正規化が行われます。この場合、一定の位置に 1 つのスペースが残され、そのスペースは保持され、表示されます。 どちらの動作が望ましいかは、開発者の意図によって異なります。そのため、`xml:space` は、必要な動作が有効となるように、選択的に使用する必要があります。  
+  
+ また、フロー ドキュメント モデルで改行を意味する特定のインライン要素では、空白が意味を持つコレクションでも、余分なスペースを挿入しないように注意する必要があります。 たとえば、<xref:System.Windows.Documents.LineBreak> 要素の用途は [!INCLUDE[TLA2#tla_html](../../../includes/tla2sharptla-html-md.md)] の \<BR\/\> タグと同じですが、マークアップの読みやすさのために、<xref:System.Windows.Documents.LineBreak> は通常、改行を入れて後続のテキストから区切られます。 その改行は、正規化されて後続の行の先頭のスペースになってはなりません。 その動作を有効にするために、<xref:System.Windows.Documents.LineBreak> 要素のクラス定義は <xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute> を適用します。これは、<xref:System.Windows.Documents.LineBreak> を囲む空白を常にトリミングするという意味に [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] プロセッサによって解釈されます。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [XML Character Entities and XAML](../../../docs/framework/xaml-services/xml-character-entities-and-xaml.md)   
+ [xml:space Handling in XAML](../../../docs/framework/xaml-services/xml-space-handling-in-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-arguments-directive.md b/docs/framework/xaml-services/x-arguments-directive.md
new file mode 100644
index 00000000000..59c0fd00c3d
--- /dev/null
+++ b/docs/framework/xaml-services/x-arguments-directive.md
@@ -0,0 +1,118 @@
+---
+title: "x:Arguments Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "x:Arguments directive [XAML Services]"
+  - "Arguments directive in XAML [XAML Services]"
+  - "XAML [XAML Services], x:Arguments directive"
+ms.assetid: 87cc10b0-b610-4025-b6b0-ab27ca27c92e
+caps.latest.revision: 12
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# x:Arguments Directive
+XAML の既定以外のコンストラクター オブジェクト要素の宣言またはファクトリ メソッド オブジェクトの宣言の構築引数をパッケージ化します。  
+  
+## XAML 要素の使用方法 \(既定以外のコンストラクター\)  
+  
+```  
+<object ...>  
+  <x:Arguments>  
+    oneOrMoreObjectElements  
+  </x:Arguments>  
+</object>  
+```  
+  
+## XAML 要素の使用方法 \(ファクトリ メソッド\)  
+  
+```  
+<object x:FactoryMethod="methodName"...>  
+  <x:Arguments>  
+    oneOrMoreObjectElements  
+  </x:Arguments>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`oneOrMoreObjectElements`|既定以外のバッキング コンストラクターまたはファクトリ メソッドに渡される引数を指定する 1 つ以上のオブジェクト要素。<br /><br /> 標準的な使用法としては、オブジェクト要素内で初期化テキストを使用して、実際の引数値を指定します。  「例」のセクションを参照してください。<br /><br /> 要素の順序は重要です。  XAML 型の順序は、バッキング コンストラクターまたはファクトリ メソッド オーバーロードの型および型の順序に一致している必要があります。|  
+|`methodName`|`x:Arguments` の引数を処理するファクトリ メソッドの名前。|  
+  
+## 依存関係  
+ `x:FactoryMethod` は、`x:Arguments` が適用されるスコープと動作を修正できます。  
+  
+ `x:FactoryMethod` が指定されていない場合は、`x:Arguments` はバッキング コンストラクターの別の \(既定以外の\) シグネチャに適用されます。  
+  
+ `x:FactoryMethod` が指定されている場合は、`x:Arguments` は名前付きメソッドのオーバーロードに適用されます。  
+  
+## 解説  
+ XAML 2006 では、既定以外の初期化が、初期化テキストを通じてサポートされます。  ただし、初期化テキストの構築方法の実用的な用途には限界があります。  初期化テキストは単一のテキスト文字列として扱われます。したがって、追加される機能は、単一のパラメーターの初期化に限られます \(コンストラクターの動作に型コンバーターが定義され、文字列からカスタム情報項目とカスタム区切り記号を解析できる場合を除く\)。  また、オブジェクト ロジックへのテキスト文字列は、実際の文字列以外のプリミティブ向けに指定された XAML パーサーの、ネイティブの既定の型コンバーターであることがあります。  
+  
+ `x:Arguments` XAML の使用方法は、一般的な意味合いにおけるプロパティ要素の使用方法ではありません。これは、ディレクティブのマークアップは、格納オブジェクトの要素の型を参照しないためです。  これは、マークアップを子コンテンツの既定以外として解釈する必要がある範囲が要素によって区切られる、`x:Code` などの他のディレクティブに似ています。  この場合、各オブジェクト要素の XAML 型が、引数の型に関する情報を伝達します。XAML パーサーはこの情報を基に、`x:Arguments` の使用を通じて参照しようとしているコンストラクター ファクトリ メソッドの具体的なシグネチャを特定します。  
+  
+ 構築するオブジェクト要素の `x:Arguments` は、他の \(そのオブジェクト要素の\) あらゆるプロパティ要素、コンテンツ、内部テキスト、または初期化文字列の前に配置する必要があります。  `x:Arguments` 内のオブジェクト要素には、XAML 型とそのバッキング コンストラクターまたはファクトリ メソッドによって許容される属性と初期化文字列を含めることができます。  オブジェクトまたは引数に関しては、確立されているプレフィックス マッピングを参照することによって、カスタム XAML 型、つまり既定の XAML 名前空間に属さない XAML 型を指定できます。  
+  
+ XAML プロセッサは、`x:Arguments` に指定された引数をオブジェクトの構築に使用するかどうかを、次のガイドラインによって判断します。  `x:FactoryMethod` が指定されている場合、指定された `x:FactoryMethod` との間で情報が比較されます。`x:FactoryMethod` の値はメソッド名であり、名前付きメソッドはオーバーロードを持つことができるという点に注意してください。  `x:FactoryMethod` が指定されていない場合、そのオブジェクトのすべてのパブリック コンストラクター オーバーロードとの間で情報が比較されます。  その後、XAML 処理ロジックは、パラメーターの数を比較し、対応するアリティを持ったオーバーロードを選択します。  複数の一致がある場合、XAML プロセッサは、指定されたオブジェクト要素の XAML 型に基づいてパラメーターの型を比較します。  引き続き複数の一致がある場合、XAML プロセッサの動作は定義されていません。  `x:FactoryMethod` は指定されているが、メソッドを解決できない場合、XAML プロセッサは例外をスローします。  
+  
+ XAML 属性の使用方法 `<x:Arguments>string</x:Arguments>` は技術的には可能です。  しかし、この方法に、初期化テキストと型コンバーターを使って実現できる以上の機能はなく、また、この構文は、XAML 2009 ファクトリ メソッドの機能を意図して設計されたものでもありません。  
+  
+## 例  
+ 次の例では、既定以外のコンストラクター シグネチャと、そのシグネチャに XAML でアクセスする `x:Arguments` の使用法を示しています。  
+  
+```csharp  
+public class Food {  
+    private string _name;  
+    private Int32 _calories;  
+    public Food(string name, Int32 calories) {  
+        _name=name;  
+        _calories=calories;  
+    }  
+}  
+```  
+  
+```  
+<my:Food>  
+    <x:Arguments>  
+        <x:String>Apple</x:String>  
+        <x:Int32>150</x:Int32>  
+    </x:Arguments>  
+</my:Food>  
+```  
+  
+ 次の例では、ターゲット ファクトリ メソッドのシグネチャと、そのシグネチャに XAML でアクセスする `x:Arguments` の使用法を示しています。  
+  
+```csharp  
+public Food TryLookupFood(string name)  
+{  
+  switch (name) {  
+    case "Apple": return new Food("Apple",150);  
+    case "Chocolate": return new Food("Chocolate",200);  
+    case "Cheese": return new Food("Cheese", 450);  
+    default: {return new Food(name,0);  
+  }  
+}  
+```  
+  
+```  
+<my:Food x:FactoryMethod="TryLookupFood">  
+    <x:Arguments>  
+        <x:String>Apple</x:String>  
+    </x:Arguments>  
+</my:Food>  
+```  
+  
+## 参照  
+ [Defining Custom Types for Use with .NET Framework XAML Services](../../../docs/framework/xaml-services/defining-custom-types-for-use-with-net-framework-xaml-services.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-array-markup-extension.md b/docs/framework/xaml-services/x-array-markup-extension.md
new file mode 100644
index 00000000000..d2fa706ee97
--- /dev/null
+++ b/docs/framework/xaml-services/x-array-markup-extension.md
@@ -0,0 +1,81 @@
+---
+title: "x:Array Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:Array"
+  - "xArray"
+helpviewer_keywords: 
+  - "x:Array [XAML Services]"
+  - "XAML [XAML Services], x:Array markup extension"
+ms.assetid: c5358e14-d24c-44c7-b5eb-6062a4fd981c
+caps.latest.revision: 20
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# x:Array Markup Extension
+マークアップ拡張機能を通じ、XAML のオブジェクトの配列を全般的にサポートします。  これは、\[MS\-XAML\] の `x:ArrayExtension` XAML 型に対応します。  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<x:Array Type="typeName">  
+  arrayContents  
+</x:Array>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`typeName`|`x:Array` に格納される型の名前。  `typeName` は、XAML 型定義を含む XAML 名前空間のプレフィックスとなる場合があります \(通常はプレフィックスとなる\)。|  
+|`arrayContents`|組み込みの `ArrayExtension.Items` プロパティに割り当てられた項目コンテンツ。  通常、これらの項目は `x:Array` 開始タグと終了タグに囲まれた 1 つ以上のオブジェクト要素として指定されます。  ここで指定されたオブジェクトは、`typeName` で指定された XAML 型に割り当て可能であることが予期されます。|  
+  
+## 解説  
+ `Type` は、すべての `x:Array` オブジェクト要素に必須の属性です。  `Type` パラメーターの値には必ずしも `x:Type` マークアップ拡張機能を使用する必要はありません。型の短い名前が XAML 型であれば、文字列として指定することができます。  
+  
+ .NET Framework XAML サービス実装では、入力された XAML 型と作成された配列の出力 CLR <xref:System.Type> との関係は、マークアップ拡張機能のサービス コンテキストの影響下にあります。  出力される <xref:System.Type> は、入力された XAML 型の <xref:System.Xaml.XamlType.UnderlyingType%2A> ですが、その前に、XAML スキーマ コンテキストとそのコンテキストが提供する <xref:System.Windows.Markup.IXamlTypeResolver> サービスに基づいて必要な <xref:System.Xaml.XamlType> が検索されます。  
+  
+ 処理時に、配列のコンテンツは `ArrayExtension.Items` 組み込みプロパティに割り当てられます。  <xref:System.Windows.Markup.ArrayExtension> 実装では、これは <xref:System.Windows.Markup.ArrayExtension.Items%2A?displayProperty=fullName> によって表されます。  
+  
+ .NET Framework XAML サービス実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.Markup.ArrayExtension> クラスによって定義されます。  <xref:System.Windows.Markup.ArrayExtension> はシールされておらず、カスタム配列の型にマークアップ拡張機能を実装する際の基礎として使用できます。  
+  
+ `x:Array` は XAML の一般的な言語拡張機能を対象にしています。  ただし `x:Array` は、XAML がサポートするコレクションを構造化プロパティ コンテンツとして受け入れる、特定のプロパティの XAML 値を指定する際にも役に立ちます。  たとえば、`x:Array` を使用して、<xref:System.Collections.IEnumerable> プロパティのコンテンツを指定できます。  
+  
+ `x:Array` はマークアップ拡張機能です。  一般にマークアップ拡張機能を実装するのは、属性値をリテラル値やハンドラー名以外にエスケープする要件が存在し、その要件の適用範囲がグローバルで、特定の型やプロパティに型コンバーターを適用するだけにとどまらない場合です。  `x:Array` は代替の属性値処理を指定する代わりに、その属性値の中のテキスト コンテンツを処理します。このことから、`x:Array` は、この規則とは一部異なります。  この動作によって、既存のコンテンツ モデルではサポートされない型を 1 つの配列にまとめ、後から分離コード内で、指定した配列にアクセスして参照することが可能となります。つまり、<xref:System.Array> を呼び出して、個々の配列項目を取得することができます。  
+  
+ XAML のすべてのマークアップ拡張機能では、それぞれの属性構文で中かっこ \({,}`)` を使用します。これは規約であり、これに従って XAML プロセッサは、マークアップ拡張機能で属性値を処理する必要があることを認識します。  一般的なマークアップ拡張機能の詳細については、「[Type Converters and Markup Extensions for XAML](../../../docs/framework/xaml-services/type-converters-and-markup-extensions-for-xaml.md)」を参照してください。  
+  
+ XAML 2009 では、`x:Array` はマークアップ拡張機能ではなく、言語のプリミティブ型として定義されています。  詳細については、「[Built\-in Types for Common XAML Language Primitives](../../../docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md)」を参照してください。  
+  
+## WPF の使用上の注意  
+ 通常、`x:Array` を設定するオブジェクト要素は、[!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] の XML 名前空間に存在する要素ではないため、既定以外の XAML 名前空間に対してプレフィックスのマッピングが必要です。  
+  
+ たとえば、以下に、2 つの文字列を持つ単純な配列があり、\(`x` に加えて\) `sys` プレフィックスが配列レベルで定義されています。  
+  
+ \[xaml\]  
+  
+ `<x:Array Type="sys:String" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"`  
+  
+ `xmlns:sys="clr-namespace:System;assembly=mscorlib">`  
+  
+ `<sys:String>Hello</sys:String>`  
+  
+ `<sys:String>World</sys:String>`  
+  
+ `</x:Array>`  
+  
+ 配列の要素として使用されるカスタム型については、クラスは XAML でオブジェクト要素としてインスタンス化できるという要件もサポートする必要があります。  詳細については、「[WPF における XAML とカスタム クラス](../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)」を参照してください。  
+  
+## 参照  
+ [マークアップ拡張機能と WPF XAML](../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)   
+ [Types Migrated from WPF to System.Xaml](../../../docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-class-directive.md b/docs/framework/xaml-services/x-class-directive.md
new file mode 100644
index 00000000000..2915d30b552
--- /dev/null
+++ b/docs/framework/xaml-services/x-class-directive.md
@@ -0,0 +1,74 @@
+---
+title: "x:Class Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:Class"
+  - "xClass"
+  - "Class"
+helpviewer_keywords: 
+  - "Class attribute in XAML [XAML Services]"
+  - "XAML [XAML Services], x:Class attribute"
+  - "x:Class attribute [XAML Services]"
+ms.assetid: bc4a3d8e-76e2-423e-a5d1-159a023e82ec
+caps.latest.revision: 27
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# x:Class Directive
+マークアップと分離コード間を部分クラスで結合するように、XAML のマークアップ コンパイルを構成します。  コードの部分クラスは、[!INCLUDE[TLA#tla_cls](../../../includes/tlasharptla-cls-md.md)] 言語で個別のコード ファイル内に定義され、マークアップの部分クラスは、通常 XAML のコンパイル時にコード生成によって作成されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Class="namespace.classname"...>  
+  ...  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`namespace`|省略可能です。  `classname` で識別される部分クラスを含む [!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] 名前空間を指定します。  `namespace` を指定する場合は、`namespace` と `classname` をドット \(.\) で区切ります。  「解説」を参照してください。|  
+|`classname`|必ず指定します。  読み込まれた XAML、およびその XAML の分離コードを接続する部分クラスの [!INCLUDE[TLA2#tla_clr](../../../includes/tla2sharptla-clr-md.md)] 名を指定します。|  
+  
+## 依存関係  
+ `x:Class` は、XAML 稼動環境のルート要素でのみ指定できます。  `x:Class` は、XAML 稼動環境内に親を持つ任意のオブジェクトで無効です。  詳細については、「[\[MS\-XAML\] 第 4.3.1.6 節](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。  
+  
+## 解説  
+ `namespace` の値には、関連する名前空間を名前の階層に編成するために追加のドットを含めることができます。これは、.NET Framework プログラミングの一般的な手法です。  `x:Class` の値の文字列に含まれる最後のドットのみが、`namespace` と `classname` の区切りとして解釈されます。`x:Class` として使用するクラスは、入れ子にできません。  入れ子になったクラスが許可されると `x:Class` 文字列のドットの意味の判断があいまいになるので、入れ子になったクラスは許可されません。  
+  
+ `x:Class` を使用する既存のプログラミング モデルの `x:Class` は、分離コードを一切持たない XAML ページが存在することはまったく問題ないという意味で省略可能です。  ただし、XAML を使用するフレームワークによって実装されたビルド アクションにはこの機能が作用します。  また、さまざまな種類の XAML 固有コンテンツがアプリケーション モデル内や対応するビルド アクションにおいて担う役割も、`x:Class` の機能に影響します。  イベント処理属性の値を XAML で宣言する場合や、\(定義しているクラスが分離コード クラスに存在するような\) カスタム要素を XAML でインスタンス化する場合には、分離コードの該当クラスに対する `x:Class` ディレクティブ参照 \(または [x:Subclass](../../../docs/framework/xaml-services/x-subclass-directive.md)\) を指定する必要があります。  
+  
+ `x:Class` ディレクティブの値は、クラスの完全修飾名を指定する文字列です。ただし、アセンブリの情報は含まれません \(<xref:System.Type.FullName%2A?displayProperty=fullName> に相当します\)。  単純なアプリケーションの場合、CLR 名前空間情報を省略することもできますが、分離コードもそのように構成されている \(コード定義がクラス レベルで開始する\) ことが条件となります。  
+  
+ ページまたはアプリケーション定義の分離コード ファイルは、コンパイル済みアプリケーションを作成しマークアップ コンパイルに関与するプロジェクトの一部として含まれているコード ファイル内にある必要があります。  CLR クラスの名前規則に従う必要があります。  詳細については、「[Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)」を参照してください。  既定では、分離コード クラスは `public` である必要がありますが、[x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)を使用して、異なるアクセス レベルとして定義できます。  
+  
+ この `x:Class` 属性の解釈が当てはまるのは、CLR ベースの XAML 実装、特に、.NET Framework XAML サービスのみです。  CLR に基づかず、.NET Framework XAML サービスを使用しない他の XAML 実装では、XAML マークアップと対応するランタイム コードを関連付けるために異なる解決式を使用する場合があります。  `x:Class` の一般的な解釈の詳細については、「[\[MS\-XAML\]](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。  
+  
+ 特定レベルのアーキテクチャでは、`x:Class` の意味は、.NET Framework XAML サービスで定義されていません。  これは、.NET Framework XAML サービスで、XAML マークアップと対応するコードが関連付けられるプログラミング モデルが指定されていないためです。  `x:Class` ディレクティブの用途は他にも考えられます。XAML マークアップと CLR ベースの分離コードを関連付ける方法を定義する目的で、そうした用途が、プログラミング モデルまたはアプリケーション モデルを使用する特定のフレームワークによって実装される場合があります。  それぞれのフレームワークは、一部の動作を実現する独自のビルド アクションや、ビルド環境に含める必要のある特定のコンポーネントを備えています。  フレームワーク内では、分離コードで使用される特定の CLR 言語に応じてビルド アクションは変化することもあります。  
+  
+## WPF プログラミング モデルの x:Class  
+ WPF アプリケーションおよび WPF アプリケーション モデルでは、`x:Class` を、XAML ファイルのルートで、コンパイルされている任意の要素の属性 \(XAML が `Page` ビルド アクションによって WPF アプリケーション プロジェクトに組み込まれている場合\)、またはコンパイル済み WPF アプリケーションのアプリケーション定義の <xref:System.Windows.Application> ルートの属性として宣言できます。  [!INCLUDE[net_v30_short](../../../includes/net-v30-short-md.md)] および [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] の WPF XAML コンパイラでは、ページ ルートまたはアプリケーション ルート以外の要素、あるいはコンパイルされていない WPF XAML ファイルで `x:Class` を宣言すると、コンパイル時エラーが発生します。  WPF の `x:Class` 処理に関連したその他の情報については、「[WPF における分離コードと XAML](../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)」を参照してください。  
+  
+## Windows Workflow Foundation の x:Class  
+ Windows Workflow Foundation の場合、`x:Class` によって名前指定されるのは、完全に XAML で構成されたカスタム アクティビティのクラスか、または分離コードを持つアクティビティ デザイナー用の XAML ページの部分クラスです。  
+  
+## Silverlight の使用上の注意  
+ Silverlight 用の `x:Class` に関しては、別途ドキュメントが用意されています。  詳細については、「[XAML 名前空間 \(x:\) 言語機能 \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkId=199081)」を参照してください。  
+  
+## 参照  
+ [x:Subclass Directive](../../../docs/framework/xaml-services/x-subclass-directive.md)   
+ [WPF における XAML とカスタム クラス](../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)   
+ [x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)   
+ [Types Migrated from WPF to System.Xaml](../../../docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-classmodifier-directive.md b/docs/framework/xaml-services/x-classmodifier-directive.md
new file mode 100644
index 00000000000..29091a70eb9
--- /dev/null
+++ b/docs/framework/xaml-services/x-classmodifier-directive.md
@@ -0,0 +1,68 @@
+---
+title: "x:ClassModifier Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "xClassModifier"
+  - "x:ClassModifier"
+  - "ClassModifier"
+helpviewer_keywords: 
+  - "XAML [XAML Services], x:ClassModifier attribute"
+  - "x:ClassModifier attribute [XAML Services]"
+  - "ClassModifier attribute in XAML [XAML Services]"
+ms.assetid: ef30ab78-d334-4668-917d-c9f66c3b6aea
+caps.latest.revision: 22
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# x:ClassModifier Directive
+`x:Class` も提供される場合の XAML のコンパイル動作を変更します。  特に、`Public` アクセス レベル \(既定レベル\) を持つ部分 `class` を作成する代わりに、提供された `x:Class` が `NotPublic` アクセス レベルで作成されます。  この動作は、生成されるアセンブリでのクラスのアクセス レベルに影響を与えます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Class="namespace.classname" x:ClassModifier="NotPublic">  
+   ...  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|*NotPublic*|<xref:System.Reflection.TypeAttributes?displayProperty=fullName> か <xref:System.Reflection.TypeAttributes?displayProperty=fullName> かを指定するために渡す正確な文字列は、分離コードで使用されているプログラミング言語によって異なります。  「解説」を参照してください。|  
+  
+## 依存関係  
+ [x:Class](../../../docs/framework/xaml-services/x-class-directive.md) も同じ要素に提供される必要があり、その要素はページのルート要素である必要があります。  詳細については、「[\[MS\-XAML\] 第 4.3.1.8 節](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。  
+  
+## 解説  
+ .NET Framework XAML サービスの使用での `x:ClassModifier` の値は、プログラミング言語によって異なります。  使用する文字列は、各言語の <xref:System.CodeDom.Compiler.CodeDomProvider> の実装方法、その言語が <xref:System.Reflection.TypeAttributes?displayProperty=fullName> と <xref:System.Reflection.TypeAttributes?displayProperty=fullName> の意味を定義するために返す型コンバーター、およびその言語が大文字と小文字を区別するかどうかによって決まります。  
+  
+-   [!INCLUDE[TLA2#tla_cshrp](../../../includes/tla2sharptla-cshrp-md.md)] の場合、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するために渡す文字列は `internal` です。  
+  
+-   [!INCLUDE[TLA2#tla_visualbnet](../../../includes/tla2sharptla-visualbnet-md.md)] の場合、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するために渡す文字列は `Friend` です。  
+  
+-   [!INCLUDE[TLA2#tla_cppcli](../../../includes/tla2sharptla-cppcli-md.md)] の場合、XAML のコンパイルをサポートする既存のターゲットは存在しないため、渡す値は指定されていません。  
+  
+ <xref:System.Reflection.TypeAttributes?displayProperty=fullName> \([!INCLUDE[TLA2#tla_cshrp](../../../includes/tla2sharptla-cshrp-md.md)] では `public`、[!INCLUDE[TLA2#tla_visualb](../../../includes/tla2sharptla-visualb-md.md)] では `Public`\) を指定することもできますが、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> が既定の動作となっているため <xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するのは一般的ではありません。  
+  
+ [!INCLUDE[TLA2#tla_cshrp](../../../includes/tla2sharptla-cshrp-md.md)] の `private` など、同等のユーザー コード アクセス レベル制限を持つ他の値は、`x:ClassModifier` として有効ではありません。XAML では入れ子になったクラス参照がサポートされないためであり、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> 修飾子が同じ効果を持ちます。  
+  
+## セキュリティに関するメモ  
+ `x:ClassModifier` で定義されているアクセス レベルは、特定のフレームワークとその機能によって解釈されます。  WPF には、対象のクラスが Pack URI 参照によって WPF リソースから参照される場合に、`x:ClassModifier` が `internal` である型を読み込んでインスタンス化する機能が用意されています。  このケースおよび他のフレームワークによって実装される同様のケースを踏まえて、可能性のあるすべてのインスタンス化をブロックするために `x:ClassModifier` だけに依存しないでください。  
+  
+## 参照  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)   
+ [WPF における分離コードと XAML](../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)   
+ [x:FieldModifier Directive](../../../docs/framework/xaml-services/x-fieldmodifier-directive.md)   
+ [セキュリティ \(WPF\)](../../../docs/framework/wpf/security-wpf.md)   
+ [Types Migrated from WPF to System.Xaml](../../../docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-code-intrinsic-xaml-type.md b/docs/framework/xaml-services/x-code-intrinsic-xaml-type.md
new file mode 100644
index 00000000000..49560575b78
--- /dev/null
+++ b/docs/framework/xaml-services/x-code-intrinsic-xaml-type.md
@@ -0,0 +1,61 @@
+---
+title: "x:Code Intrinsic XAML Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Code"
+  - "x:Code"
+  - "xCode"
+helpviewer_keywords: 
+  - "Code directive in XAML [XAML Services]"
+  - "x:Code XAML directive element [XAML Services]"
+  - "XAML [XAML Services], x:Code directive element"
+ms.assetid: 87986b13-1a2e-4830-ae36-15f9dc5629e8
+caps.latest.revision: 19
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# x:Code Intrinsic XAML Type
+XAML 稼動環境内にコードを配置できます。  このようなコードは、XAML をコンパイルする XAML プロセッサ実装によってコンパイルすることもできれば、ランタイムによって解釈させるなど、後から使用するために XAML 稼動環境内に残しておくこともできます。  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<x:Code>  
+   // code instructions, usually enclosed by CDATA...  
+</x:Code>  
+```  
+  
+## 解説  
+ `x:Code` XAML ディレクティブ要素内のコードも、指定された汎用 XML 名前空間と XAML 名前空間内で解釈されます。  したがって、`x:Code` 用に使用されるコードを `CDATA` セグメントで囲むことも通常は必要です。  
+  
+ `x:Code` は、どの XAML 稼動環境の配置機構でも使用できるとは限りません。  特定のフレームワーク \(たとえば、WPF\) では、コードはコンパイルする必要があります。  その他のフレームワークでは、`x:Code` の使用は一般に許可されていません。  
+  
+ マネージ `x:Code` コンテンツを許容するフレームワークの場合、`x:Code` コンテンツに対して使用される適切な言語コンパイラは、アプリケーションをコンパイルするために使用される格納元プロジェクトの設定とターゲットによって決定されます。  
+  
+## WPF の使用上の注意  
+ WPF の場合、`x:Code` 内で宣言されるコードに関して、いくつかの制限事項があります。  
+  
+-   `x:Code` ディレクティブ要素は、XAML 稼動環境のルート要素の直接の子要素でなければなりません。  
+  
+-   [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md) は、親ルート要素で提供される必要があります。  
+  
+-   コンパイル時に、`x:Code` 内に配置されているコードは、その XAML ページに対して既に作成された部分クラスのスコープ内にあるものとして扱われます。  このため、定義するすべてのコードは、その部分クラスのメンバーまたは変数である必要があります。  
+  
+-   部分クラスの内側にクラスを入れ子にすること以外の方法で、追加クラスを定義することはできません \(入れ子にすることはできますが、入れ子のクラスは XAML では参照できないので、一般的ではありません\)。  既存の部分クラスに対して使用されている名前空間以外の CLR 名前空間を定義したり追加したりすることはできません。  
+  
+-   部分クラスの CLR 名前空間の外側のコード エンティティに対する参照は、すべて完全修飾されている必要があります。  宣言されるメンバーが、部分クラスのオーバーライド可能なメンバーに対するオーバーライドである場合は、言語固有のオーバーライド キーワードを使用してこのことを指定する必要があります。  `x:Code` のスコープで宣言されたメンバーと、XAML から作成された部分クラスのメンバーとの間に、コンパイラから報告されるような競合がある場合は、XAML ファイルを読み込んだりコンパイルしたりすることはできません。  
+  
+## 参照  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)   
+ [WPF における分離コードと XAML](../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-factorymethod-directive.md b/docs/framework/xaml-services/x-factorymethod-directive.md
new file mode 100644
index 00000000000..09b3de74023
--- /dev/null
+++ b/docs/framework/xaml-services/x-factorymethod-directive.md
@@ -0,0 +1,67 @@
+---
+title: "x:FactoryMethod Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML. x:FactoryMethod directive [XAML Services]"
+  - "FactoryMethod directive in XAML [XAML Services]"
+  - "x:FactoryMethod directive [XAML Services]"
+ms.assetid: 829bcbdf-5318-4afb-9a03-c310e0d2f23d
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# x:FactoryMethod Directive
+XAML プロセッサが、バッキング型を解決した後にオブジェクトを初期化するために使用する、コンストラクター以外のメソッドを指定します。  
+  
+## XAML 属性の使用方法、x:Arguments なし  
+  
+```  
+<object x:FactoryMethod="methodname"...>  
+  ...  
+</object>  
+```  
+  
+## XAML 属性の使用方法、要素としての x:Arguments  
+  
+```  
+<object x:FactoryMethod="methodname"...>  
+  <x:Arguments>  
+    oneOrMoreObjectElements  
+  </x:Arguments>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`methodname`|XAML プロセッサが、`object` として指定されるインスタンスを初期化するために、XAML プロセッサが呼び出すメソッドの文字列メソッド名。  「解説」を参照してください。|  
+|`oneOrMoreObjectElements`|ファクトリ メソッド パラメーターを指定するオブジェクトの、1 つ以上のオブジェクト要素。  ファクトリ メソッドに引数が渡される順序を指定するので、順序は重要です。|  
+  
+## 解説  
+ `methodname` がインスタンス メソッドである場合、修飾できません。  
+  
+ ファクトリ メソッドとしての静的メソッドはサポートされます。  `methodname` が静的メソッドである場合、`methodname` は *typeName*.*methodName* の組み合わせとして指定されます。ここで、*typeName* は、静的ファクトリ メソッドを定義するクラスの名前です。  *typeName* は、マップされた xmlns の型を表す場合は、プレフィックスで修飾されています。  *typeName* は、`typeof(``object``)` とは異なる型のこともあります。  
+  
+ ファクトリ メソッドは、関連するオブジェクト要素をサポートする型の、宣言済みパブリック メソッドである必要があります。  
+  
+ ファクトリ メソッドは、関連オブジェクトに割り当てることができるインスタンスを返す必要があります。  ファクトリ メソッドが null 値を返すことはありません。  
+  
+ `x:Arguments` は、ファクトリ メソッドのシグネチャの最優先の一致の原則に従います。  一致においては、最初にパラメーター数が評価されます。  パラメーター数に 1 つ以上の一致が見られる場合、パラメーター型が評価され、最優先の一致が決定されます。  評価のこのフェーズの後にあいまいさが残る場合は、XAML プロセッサの動作は未定義です。  
+  
+ `x:FactoryMethod` 要素の使用方法は、一般的な意味合いにおけるプロパティ要素の使用方法ではありません。これは、ディレクティブのマークアップは、格納オブジェクトの要素の型を参照しないためです。  要素の使用方法は、属性の使用方法よりも一般的ではないとされています。  `x:Arguments` \(属性または要素の使用方法\) は、`x:FactoryMethod` 要素の使用方法と共に使用できますが、「使用方法」のセクションには具体的に示されません。  
+  
+ 要素としての `x:FactoryMethod` はその他のプロパティ要素、要素として指定される `x:Arguments`、およびコンテンツ\/内部テキスト\/初期化テキストの前に配置される必要があります。  
+  
+## 参照  
+ [x:Arguments Directive](../../../docs/framework/xaml-services/x-arguments-directive.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-fieldmodifier-directive.md b/docs/framework/xaml-services/x-fieldmodifier-directive.md
new file mode 100644
index 00000000000..5578eef539a
--- /dev/null
+++ b/docs/framework/xaml-services/x-fieldmodifier-directive.md
@@ -0,0 +1,65 @@
+---
+title: "x:FieldModifier Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "FieldModifier attribute in XAML [XAML Services]"
+  - "x:FieldModifier attribute [XAML Services]"
+  - "XAML [XAML Services], x:FieldModifier attribute"
+ms.assetid: ed427cd4-2f35-4d24-bd2f-0fa7b71ec248
+caps.latest.revision: 15
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# x:FieldModifier Directive
+指定されているオブジェクト参照のフィールドが、既定動作の <xref:System.Reflection.TypeAttributes?displayProperty=fullName> ではなく <xref:System.Reflection.TypeAttributes?displayProperty=fullName> アクセスで定義されるように、XAML のコンパイル動作を変更します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:FieldModifier="Public".../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|*Public*|<xref:System.Reflection.TypeAttributes?displayProperty=fullName> か <xref:System.Reflection.TypeAttributes?displayProperty=fullName> かを指定するために渡す正確な文字列は、分離コードで使用されているプログラミング言語によって異なります。  「解説」を参照してください。|  
+  
+## 依存関係  
+ XAML 稼動環境が任意の場所で `x:FieldModifier` を使用する場合、XAML 稼動環境のルート要素は [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md) を宣言する必要があります。  
+  
+## 解説  
+ `x:FieldModifier` は、クラスまたはそのメンバーの一般的なアクセス レベルの宣言には関連しません。  XAML 稼動環境の一部である特定の XAML オブジェクトが処理されるときの XAML 処理動作にだけ関係し、アプリケーションのオブジェクト グラフ内で潜在的にアクセスできるオブジェクトとなります。  既定では、このようなオブジェクトのフィールド参照は非公開なので、コントロール コンシューマーはオブジェクト グラフを直接変更できません。  代わりに、コントロール コンシューマーは、レイアウト ルートの取得、子要素のコレクションの取得、専用のパブリック プロパティの取得などのプログラミング モデルによって有効になる標準パターンを使用してオブジェクト グラフを変更します。  
+  
+ `x:FieldModifier` 属性の値はプログラミング言語ごとに異なり、その目的は特定のフレームワークで変わることがあります。  使用する文字列は、各言語の <xref:System.CodeDom.Compiler.CodeDomProvider> の実装方法、その言語が <xref:System.Reflection.TypeAttributes?displayProperty=fullName> と <xref:System.Reflection.TypeAttributes?displayProperty=fullName> の意味を定義するために返す型コンバーター、およびその言語が大文字と小文字を区別するかどうかによって決まります。  
+  
+-   [!INCLUDE[TLA2#tla_cshrp](../../../includes/tla2sharptla-cshrp-md.md)] の場合、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するために渡す文字列は `public` です。  
+  
+-   [!INCLUDE[TLA2#tla_visualbnet](../../../includes/tla2sharptla-visualbnet-md.md)] の場合、<xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するために渡す文字列は `Public` です。  
+  
+-   [!INCLUDE[TLA2#tla_cppcli](../../../includes/tla2sharptla-cppcli-md.md)] の場合、XAML のターゲットは現在存在しないため、渡す文字列は定義されていません。  
+  
+ <xref:System.Reflection.TypeAttributes?displayProperty=fullName> \([!INCLUDE[TLA2#tla_cshrp](../../../includes/tla2sharptla-cshrp-md.md)] では `internal`、[!INCLUDE[TLA2#tla_visualb](../../../includes/tla2sharptla-visualb-md.md)] では `Friend`\) を指定することもできますが、動作としては `NotPublic` が既定となっているため <xref:System.Reflection.TypeAttributes?displayProperty=fullName> を指定するのは一般的ではありません。  
+  
+ <xref:System.Reflection.TypeAttributes?displayProperty=fullName> が既定の動作になっているのは、XAML をコンパイルしたアセンブリの外部のコードから XAML で作成された要素にアクセスする必要があまりないためです。  パブリック アクセスを許可するようにユーザーが明確に `x:FieldModifier` を設定しない限り、WPF のセキュリティ アーキテクチャと XAML のコンパイル動作の組み合わせが、要素のインスタンスを格納するフィールドを Public にすることはありません。  
+  
+ `x:FieldModifier` は、[x:Name Directive](../../../docs/framework/xaml-services/x-name-directive.md)が指定されている要素に対してのみ関係します。これは、フィールドが Public になると、その名前を使用してフィールドを参照するためです。  
+  
+ ルート要素の部分クラスは既定で Public になっていますが、[x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)を使用して NonPublic にすることができます。  [x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)は、ルート要素クラスのインスタンスのアクセス レベルにも影響を与えます。  ルート要素には `x:Name` と `x:FieldModifier` の両方を配置できますが、これはルート要素のパブリック フィールドのコピーを作成するだけであり、実際のルート要素クラスのアクセス レベルは引き続き [x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)によって制御されます。  
+  
+## 参照  
+ [WPF における XAML とカスタム クラス](../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)   
+ [WPF における分離コードと XAML](../../../docs/framework/wpf/advanced/code-behind-and-xaml-in-wpf.md)   
+ [x:Name Directive](../../../docs/framework/xaml-services/x-name-directive.md)   
+ [WPF アプリケーション \(WPF\) のビルド](../../../docs/framework/wpf/app-development/building-a-wpf-application-wpf.md)   
+ [x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-key-directive.md b/docs/framework/xaml-services/x-key-directive.md
new file mode 100644
index 00000000000..8a8e0e3eab2
--- /dev/null
+++ b/docs/framework/xaml-services/x-key-directive.md
@@ -0,0 +1,123 @@
+---
+title: "x:Key Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "xKey"
+  - "Key"
+  - "x:Key"
+helpviewer_keywords: 
+  - "x:Key attribute [XAML Services]"
+  - "Key attribute in XAML [XAML Services]"
+  - "XAML [XAML Services], x:Key attribute"
+ms.assetid: 1985cd45-f197-42d5-b75e-886add64b248
+caps.latest.revision: 25
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# x:Key Directive
+XAML で定義されたディクショナリで作成および参照される要素を一意に識別します。  `x:Key` 値を XAML オブジェクトに追加するのは、リソース ディクショナリ \(<xref:System.Windows.ResourceDictionary> など\) のリソースを識別するための最も一般的な方法です。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Key="stringKeyValue".../>  
+-or-  
+<object x:Key="{markupExtensionUsage}".../>  
+```  
+  
+## XAML 属性の使用方法 \(WPF 固有\)  
+  
+```  
+<object.Resources>  
+  <object x:Key="stringKeyValue".../>  
+</object.Resources>  
+-or-  
+<object.Resources>  
+  <object x:Key="{markupExtensionUsage}".../>  
+</object.Resources>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`stringKeyValue`|キーとして使用するテキスト文字列。  テキスト文字列は、[XamlName の文法](../../../docs/framework/xaml-services/xamlname-grammar.md)に準拠している必要があります。|  
+|`markupExtensionUsage`|マークアップ拡張機能の区切り記号 {} 内では、キーとして使用するオブジェクトを提供するマークアップ拡張機能の使用方法です。  「解説」を参照してください。|  
+  
+## 解説  
+ `x:Key` は XAML のリソース ディクショナリの概念をサポートしています。  言語としての XAML ではリソース ディクショナリの実装は定義されていません。特定の UI フレーム ワークによって定義されています。  WPF での XAML リソース ディクショナリの実装方法の詳細については、「[XAML リソース](../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ XAML 2006 および WPF では、`x:Key` は属性として示す必要があります。  文字列ではないキーも使用できますが、文字列ではない値を属性形式で提供するためには、マークアップ拡張機能を使用する必要があります。  XAML 2009 を使用する場合は、`x:Key` を要素として指定し、マークアップ拡張機能の仲介を必要とすることなく、文字列以外のオブジェクトの種類をキーとするディクショナリを明示的にサポートすることができます。  このトピックの「XAML 2009」のセクションを参照してください。  解説セクションの残りの部分では、XAML 2006 の実装について説明します。  
+  
+ `x:Key` の属性値には、[XamlName の文法](../../../docs/framework/xaml-services/xamlname-grammar.md) で定義されている任意の文字列またはマークアップ拡張機能を使用して評価されたオブジェクトを指定できます。  WPF の例については、「WPF の使用上の注意」を参照してください。  
+  
+ 通常、<xref:System.Collections.IDictionary> の実装である親要素の子要素には、そのディクショナリ内の一意のキー値を指定する `x:Key` 属性を含める必要があります。  フレームワークでは、特定の型の `x:Key` を代用するために、エイリアス化されたキー プロパティを実装する場合があります。このようなプロパティを定義する型には、<xref:System.Windows.Markup.DictionaryKeyPropertyAttribute> 属性を設定する必要があります。  
+  
+ `x:Key` の指定に相当するコードは、基になる <xref:System.Collections.IDictionary> で使用されるキーです。  たとえば、マークアップで適用される WPF のリソースの `x:Key` は、コードでリソースを WPF の <xref:System.Windows.ResourceDictionary> に追加する場合、<xref:System.Windows.ResourceDictionary.Add%2A?displayProperty=fullName> の `key` パラメーターの値と同等です。  
+  
+## WPF の使用上の注意  
+ 通常、WPF の <xref:System.Windows.ResourceDictionary> などの <xref:System.Collections.IDictionary> の実装である親オブジェクトの子オブジェクトには、`x:Key` 属性を含める必要があります。また、キー値は、そのディクショナリ内で一意である必要があります。  ただし、次のように 2 つの重要な例外があります。  
+  
+-   一部の WPF 型は、ディクショナリの使用に対して暗黙のキーを宣言します。  たとえば、<xref:System.Windows.Style.TargetType%2A> が設定された <xref:System.Windows.Style> や、<xref:System.Windows.DataTemplate.DataType%2A> が設定された <xref:System.Windows.DataTemplate> は、<xref:System.Windows.ResourceDictionary> に格納して、暗黙のキーを使用できます。  
+  
+-   WPF は、マージされたリソース ディクショナリの概念をサポートしています。  キーは、マージされたディクショナリ間で共有できます。また、共有されたキーの動作には、<xref:System.Windows.FrameworkContentElement.FindResource%2A> を使用してアクセスできます。  詳細については、「[マージされたリソース ディクショナリ](../../../docs/framework/wpf/advanced/merged-resource-dictionaries.md)」を参照してください。  
+  
+ 通常、WPF XAML の実装およびアプリケーション モデルでは、キーの一意性が XAML マークアップ コンパイラによってチェックされることはありません。  その代わり、`x:Key` 値が指定されていない場合や一意でない場合は、読み込み時に XAML パーサー エラーが発生します。  ただし、WPF のディクショナリに対する [!INCLUDE[vs_current_short](../../../includes/vs-current-short-md.md)] 処理によって、このようなエラーの多くは、デザイン フェーズで指摘されます。  
+  
+ ここに示す構文において、<xref:System.Windows.ResourceDictionary> オブジェクトは WPF XAML プロセッサが <xref:System.Windows.FrameworkElement.Resources%2A> コレクションを取得するためのコレクションを生成する方法を暗黙的に決定することに注意してください。  <xref:System.Windows.ResourceDictionary> は、通常はマークアップで要素として明示的に指定されませんが、わかりやすくするために必要に応じて明示的に指定することもできます \(その場合、このオブジェクトは、<xref:System.Windows.FrameworkElement.Resources%2A> プロパティ要素とディクショナリに設定される項目間のコレクション オブジェクト要素になります\)。  コレクション オブジェクトがマークアップでほぼ必ず暗黙の要素になる理由の詳細については、「[XAML 構文の詳細](../../../docs/framework/wpf/advanced/xaml-syntax-in-detail.md)」を参照してください。  
+  
+ WPF XAML 実装では、リソース ディクショナリ キーの処理は、<xref:System.Windows.ResourceKey> 抽象クラスによって定義されます。  ただし、WPF XAML プロセッサは、使用方法に基づいてキーごとに別の基になる拡張型を生成します。  たとえば、<xref:System.Windows.DataTemplate> または任意の派生クラスのキーは個別に処理され、異なる <xref:System.Windows.DataTemplateKey> オブジェクトを生成します。  
+  
+ 基本的な XAML 定義では、キーと名前で異なるディレクティブと言語要素 \(`x:Key` と `x:Name`\) が使用されます。  また、キーと名前は、それらの概念の WPF 定義およびアプリケーションにより異なる状況において使用されます。  詳細については、「[WPF XAML 名前スコープ](../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)」を参照してください。  
+  
+ 既に説明したように、キー値はマークアップ拡張機能によって指定され、文字列値以外になる場合があります。  WPF シナリオの例としては、`x:Key` の値が [ComponentResourceKey](../../../docs/framework/wpf/advanced/componentresourcekey-markup-extension.md) になる場合が挙げられます。  特定のコントロールでは、スタイルを完全に置き換えることなく、そのコントロールの外観と動作の一部に影響を与えるカスタム スタイル リソースの型に対応するスタイル キーが公開されます。  このようなキーの例として、<xref:System.Windows.Controls.ToolBar.ButtonStyleKey%2A> が挙げられます。  
+  
+ WPF のマージされたディクショナリ機能では、キーの一意性およびキーの検索動作について考慮を要する点があります。  詳細については、「[マージされたリソース ディクショナリ](../../../docs/framework/wpf/advanced/merged-resource-dictionaries.md)」を参照してください。  
+  
+## XAML 2009  
+ XAML 2009 は、`x:Key` を常に属性形式で提供するという制限を緩和します。  
+  
+ WPF では XAML 2009 の機能を使用できますが、マークアップ コンパイルされていない XAML に限定されます。  WPF 向けにマークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 のキーワードと機能をサポートしていません。  
+  
+ XAML 2009 では、次の使用法により、`x:Key` 要素を指定できます。  
+  
+### XAML 要素の使用 \(XAML 2009 のみ\)  
+  
+```  
+<object>  
+  <x:Key>  
+     keyObject  
+  </x:Key>  
+...  
+</object>  
+```  
+  
+### XAML 値  
+  
+|||  
+|-|-|  
+|`keyObject`|専用のディクショナリで指定された `object` のキーとして使用されるオブジェクトの、オブジェクト要素。|  
+  
+-   この種類の使用方法のコンテナー\/親は、ここには示しません。  `object` は、専用のディクショナリの実装を表すオブジェクト要素の子であると想定されます。  `keyObject` は、その専用のディクショナリの実装のキーとして適切なオブジェクト インスタンス \(または値の型の値\) であると想定されます。  
+  
+-   WPF は、この使用方法を必要とするディクショナリを実装しません。  オブジェクト キーは XAML 言語のより一般的な機能であり、カスタム ディクショナリのシナリオで XAML でのディクショナリ作成が望まれる場合に有益であることがあります。  リソースに対して文字列以外のキーを使用する暗黙的なスタイルなどの WPF 機能については、別の方法によってキーを確立、または指定することができるので、オブジェクト キーを使用する必要はありません。  
+  
+-   *keyObject* は、直接オブジェクト インスタンスではなく、オブジェクト要素の形式で、マークアップ拡張機能の使用方法になる場合もあります。  
+  
+## Silverlight の使用上の注意  
+ Silverlight 用の `x:Key` に関しては、別途ドキュメントが用意されています。  詳細については、「[XAML 名前空間 \(X:\) 言語機能 \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkId=199081)」を参照してください。  
+  
+## 参照  
+ [XAML リソース](../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [リソースとコード](../../../docs/framework/wpf/advanced/resources-and-code.md)   
+ [StaticResource のマークアップ拡張機能](../../../docs/framework/wpf/advanced/staticresource-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-member-directive.md b/docs/framework/xaml-services/x-member-directive.md
new file mode 100644
index 00000000000..65eec0e5480
--- /dev/null
+++ b/docs/framework/xaml-services/x-member-directive.md
@@ -0,0 +1,49 @@
+---
+title: "x:Member Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 4d8394ef-644c-4331-b6c5-be855d392980
+caps.latest.revision: 5
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# x:Member Directive
+マークアップで XAML メンバーを宣言します。  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+  
+<object x:Class="className">  
+  <x:Members>  
+    <x:Member Name="propertyName"/>  
+    additionalMembers  
+  </x:Members>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`className`|XAML 運用環境のバッキング クラスまたは部分クラスの名前。|  
+|`memberName`|定義されるプロパティのメンバーの名前。|  
+  
+## 解説  
+ .NET Framework XAML サービス実装では、  `x:Member` には直接の型のバッキングはありませんが、<xref:System.Windows.Markup.MemberDefinition> クラスによってサポートされています。  XAML ノード ストリームでは、`x:Member` 要素は、XAML 言語の XAML 名前空間から `Member` という名前のメンバーとして表されます。  メンバー `Member` は、マークアップによって宣言された属性を保持します。  
+  
+ `Name` と `Type` の意味は、.NET Framework XAML サービス レベルでは割り当てられません。  これらは、特定のフレームワークによって課される可能性がある規則の下で後に解釈される文字列の値として、初期の XAML ノード ストリームに格納されます。  意味は、実装によって、XAML の名前および XAML 型の意味と揃えるか、バッキング型のシステムでのみ有効になることがあります。  
+  
+ マークアップでメンバーの定義を指定する手段として `x:Members` の実用的な使用法をサポートするため、メンバーを変更可能なクラスに関連付ける必要があります。  目的とするモデルは、`x:Members` が `x:Class` を指定する型のメンバーとして存在することです。  ただし、型とメンバーを関連付けたり、動的メンバーの定義を作成したりするメカニズムは、.NET Framework XAML サービス レベルではサポートされません。  これは、XAML のメンバーの定義をサポートするアプリケーション モデルがある個々のフレームワークに残されています。  一般に、XAML をマークアップ コンパイルするとともに、XAML と分離コードの統合または純粋な XAML からのアセンブリの生成を行う MSBUILD のビルド操作が、この機能をサポートするために必要です。  
+  
+## Windows Workflow Foundation の x:Property  
+ Windows Workflow Foundation では、 `x:Property` は、全体が XAML で構成されるカスタム アクティビティのメンバーや、分離コードを含むアクティビティ デザイナーの XAML で定義された動的メンバーを定義します。  `x:Class` は、XAML の運用環境のルート要素にも指定する必要があります。  これは、.NET Framework XAML サービス レベルの要件ではありませんが、全般にカスタム アクティビティと Windows Workflow Foundation の XAML をサポートする MSBUILD のビルド アクションによって XAML の運用環境が読み込まれるときの要件になります。  Windows Workflow Foundation は、`x:Property` `Type` 属性の目的とする値として、純粋な XAML の型名を使用しません。代わりに、このドキュメントで説明されていない規約を使用します。  詳細については、「[DynamicActivity の作成](http://msdn.microsoft.com/library/dd807392.aspx)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-members-directive.md b/docs/framework/xaml-services/x-members-directive.md
new file mode 100644
index 00000000000..7d0676bd703
--- /dev/null
+++ b/docs/framework/xaml-services/x-members-directive.md
@@ -0,0 +1,46 @@
+---
+title: "x:Members Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 155b393d-3b49-4c5a-8c9e-b3d9893af4e4
+caps.latest.revision: 5
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# x:Members Directive
+マークアップで定義された一連の \(親要素の x:Class に適用される\) メンバーを保持します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+  
+<object x:Class="className">  
+  <x:Members>  
+    oneOrMoreMembers  
+  </x:Members  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`className`|XAML 稼動環境のバッキング クラスまたは部分クラスの名前。  「解説」を参照してください。|  
+|`oneOrMoreMembers`|メンバーの定義を表す 1 つ以上のオブジェクト要素。  通常、これらは `x:Property` オブジェクト要素です。  「解説」を参照してください。|  
+  
+## 解説  
+ .NET Framework XAML サービス実装では、`x:Members` に対するバッキング クラスや基になるメンバー実装は存在しません。  `x:Members` は、あらゆる型のメンバーとして存在できる特殊な XAML メンバーです。  XAML ノード ストリームにおいて、`x:Members` は、XAML 言語の XAML 名前空間の `Members` という名前のメンバーとして表されます。  メンバー `Members` には、`Member` オブジェクトの読み取り専用のジェネリック リストが格納されます。  通常のマークアップでは、個々のメンバーが `x:Property` プロパティの要素として指定されます。  `x:Property` は、型のプロパティ専用の明確な型であり、`x:Member` に割り当てることができます。  詳細については、「[x:Property Directive](../../../docs/framework/xaml-services/x-property-directive.md)」を参照してください。  
+  
+ マークアップでメンバー定義を指定する手段として `x:Members` を実際に使用できるようにするためには、変更可能なクラスにメンバーが関連付けられている必要があります。  想定されているモデルは、`x:Class` を指定する型のメンバーとして `x:Members` が存在することです。  ただし、型とメンバーを関連付けたり動的なメンバー定義を生成したりするためのメカニズムは、.NET Framework XAML サービス レベルではサポートされていません。  この点は、XAML に基づくメンバー定義に対応したアプリケーション モデルを持つ個々のフレームワークに委ねられています。  通常、そのような機能をサポートするためには、XAML をマークアップ コンパイルし、分離コードと統合するか、純粋な XAML 由来のアセンブリを生成する MSBUILD ビルド アクションが必要です。  
+  
+## Windows Workflow Foundation の x:Members  
+ Windows Workflow Foundation の場合、`x:Members` に格納されるのは、完全に XAML で構成されたカスタム アクティビティのメンバーか、またはアクティビティ デザイナー用に分離コードと共に XAML で定義された動的メンバーです。  また、XAML 稼動環境のルート要素には、`x:Class` が指定されている必要があります。  これは、.NET Framework XAML サービス レベルの要件ではありませんが、カスタム アクティビティおよび Windows Workflow Foundation XAML 全般をサポートする MSBUILD ビルド アクションによって XAML 稼動環境が読み込まれた場合には、これが要件となります。  `x:Class` を宣言するオブジェクト要素のマークアップにおいて、`x:Members` は最初の子要素である必要があります。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-name-directive.md b/docs/framework/xaml-services/x-name-directive.md
new file mode 100644
index 00000000000..58d0391a0ab
--- /dev/null
+++ b/docs/framework/xaml-services/x-name-directive.md
@@ -0,0 +1,79 @@
+---
+title: "x:Name Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:Name"
+  - "xName"
+  - "Name"
+helpviewer_keywords: 
+  - "x:Name attribute [XAML Services]"
+  - "XAML [XAML Services], x:Name attribute"
+  - "Name attribute in XAML [XAML Services]"
+ms.assetid: b7e61222-e8cf-48d2-acd0-6df3b7685d48
+caps.latest.revision: 27
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# x:Name Directive
+XAML で定義された XAML 名前スコープ内の要素を一意に識別します。  XAML を基に作成されたオブジェクト グラフに対し実行時にアクセスする動作がフレームワークに実装されている場合、またはそのような API が存在する場合、XAML 名前スコープとその一意性モデルを、インスタンス化されたオブジェクトに適用することができます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Name="XAMLNameValue".../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`XAMLNameValue`|[XamlName の文法](../../../docs/framework/xaml-services/xamlname-grammar.md)の制限に準拠する文字列。|  
+  
+## 解説  
+ フレームワークの基になるプログラミング モデルに適用後の `x:Name` は、コンストラクターによって返されるオブジェクト参照またはインスタンスを保持する変数と等価と見なすことができます。  
+  
+ `x:Name` ディレクティブの使用上、その値は、XAML 名前スコープ内で一意である必要があります。  既定では、.NET Framework XAML サービス API によって使用された場合、プライマリ XAML 名前スコープは、単一の XAML 稼動環境の XAML ルート要素で定義され、その XAML 稼動環境内の要素を含みます。  特定のシナリオに対応するために、フレームワークによって追加の個別の \(単一の XAML 稼動環境内に出現する\) XAML 名前スコープを定義できます。  たとえば、WPF では、新しい XAML 名前スコープも、その XAML 稼動環境で定義される任意のテンプレートによって定義および作成されます。  XAML 名前スコープの詳細 \(WPF に関して記述されていますが、多くの XAML 名前スコープの概念にも関連しています\) については、「[WPF XAML 名前スコープ](../../../docs/framework/wpf/advanced/wpf-xaml-namescopes.md)」を参照してください。  
+  
+ 通常、`x:Name` は、`x:Key` も使用する状況には適用しないでください。  特定の既存フレームワークによる XAML 実装では、`x:Key` と `x:Name` の間に代替の概念を導入していますが、それは推奨されるプラクティスではありません。  .NET Framework XAML サービスでは、<xref:System.Windows.Markup.INameScope> や <xref:System.Windows.Markup.DictionaryKeyPropertyAttribute> などの名前\/キー情報を処理するときに、このような代替概念はサポートしていません。  
+  
+ `x:Name` の許可規則と名前の一意性の適用は、特定の実装フレームワークによって潜在的に定義されます。  ただし、.NET Framework XAML サービスと併用できるように、XAML 名前スコープの一意性に対するフレームワーク定義は、このドキュメントの <xref:System.Windows.Markup.INameScope> 情報の定義と整合性を維持し、その情報の適用先に関して同じ規則を使用する必要があります。  たとえば、[!INCLUDE[TLA#tla_winclient](../../../includes/tlasharptla-winclient-md.md)] 実装は、さまざまなマークアップ要素を個別の <xref:System.Windows.NameScope> 範囲 \(リソース ディクショナリ、ページ レベルの XAML によって作成された論理ツリー、テンプレート、その他の遅延コンテンツなど\) に分け、その後、各 XAML 名前スコープで XAML 名の一意性を適用します。  
+  
+ .NET Framework XAML サービス XAML オブジェクト ライターを使用するカスタム型の場合、型の `x:Name` にマッピングするプロパティを設定または変更できます。  この動作は、型定義コード内の <xref:System.Windows.Markup.RuntimeNamePropertyAttribute> で、マッピングするプロパティの名前を参照することによって定義します。  <xref:System.Windows.Markup.RuntimeNamePropertyAttribute> は型レベルの属性です。  
+  
+ .NET Framework XAML サービスを使用すると、<xref:System.Windows.Markup.INameScope> インターフェイスを実装することで、フレームワークに依存しない方法で、XAML 名前スコープをサポートするバッキング ロジックを定義できます。  
+  
+## WPF の使用上の注意  
+ [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] アプリケーションの標準のビルド構成では、XAML、部分クラス、および分離コードを使用します。ここで指定した `x:Name` は、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] がマークアップ コンパイル ビルド タスクによって処理されるときに、基になるコードで生成されるフィールドの名前となり、そのフィールドはオブジェクトへの参照を保持します。作成されるフィールドは、既定では内部型です。  [x:FieldModifier 属性](../../../docs/framework/xaml-services/x-fieldmodifier-directive.md)を指定することによって、フィールド アクセスを変更できます。  WPF および Silverlight では、マークアップ コンパイルによって、まず部分クラスにフィールドが定義され、名前が付けられます。ただし、初期状態では値は空です。  次に、`InitializeComponent` という名前で生成されたメソッドがクラスのコンストラクター内から呼び出されます。  `InitializeComponent` は、一連の `FindName` 呼び出しで構成されます。このとき、部分クラスの XAML 定義部に存在する `x:Name` の値が、それぞれの呼び出しの入力文字列として使用されます。  その戻り値が同名のフィールド参照に代入され、XAML の解析に基づいて作成されたオブジェクトがフィールドの値として設定されます。  `InitializeComponent` が実行されることで、XAML で定義されたオブジェクトの参照が必要になったときに、`FindName` を明示的に呼び出さなくても、いつでも `x:Name`\/フィールド名を直接使用して、ランタイム オブジェクト グラフを参照できるようになります。  
+  
+ [!INCLUDE[TLA#tla_visualb](../../../includes/tlasharptla-visualb-md.md)] のターゲットを使用し `Page` ビルド アクションを持つ XAML ファイルを含む WPF アプリケーションでは、個別の参照プロパティはコンパイル時に作成されます。このコンパイルでは、`x:Name` を持つすべての要素に `WithEvents` キーワードが追加され、イベント ハンドラー デリゲートの `Handles` 構文をサポートします。  このプロパティは常にパブリックです。  詳細については、「[Visual Basic と WPF のイベント処理](../../../docs/framework/wpf/advanced/visual-basic-and-wpf-event-handling.md)」を参照してください。  
+  
+ WPF XAML プロセッサは、`x:Name` を使用して、読み込み時に XAML 名前スコープに名前を登録します。これは、そのページが、ビルド アクションによってマークアップ コンパイルされない場合 \(たとえば、リソース ディクショナリの Loose XAML\) にも当てはまります。  このような動作になっているのは、<xref:System.Windows.Data.Binding.ElementName%2A> バインディングに `x:Name` が必要になる場合があるためです。  詳細については、「[データ バインドの概要](../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+ 前述のとおり、`x:Name` \(または `Name`\) は、`x:Key` も使用する状況では適用しないでください。  [!INCLUDE[TLA2#tla_winclient](../../../includes/tla2sharptla-winclient-md.md)] <xref:System.Windows.ResourceDictionary> は、この動作を適用する方法として、自らを XAML 名前スコープとして定義するにもかかわらず、<xref:System.Windows.Markup.INameScope> API については Not Implemented または null 値を返すという特殊な動作をするためです。  XAML で定義された <xref:System.Windows.ResourceDictionary> 内に WPF XAML パーサーが `Name` または `x:Name` を検出した場合、いずれの XAML 名前スコープにも名前は追加されません。  その名前を XAML 名前スコープから見つけようとしても、`FindName` メソッドからは有効な結果は返されません。  
+  
+### x:Name および Name  
+ WPF アプリケーションで `x:Name` 属性をまったく使用せずに済むケースも多くあります。これは、<xref:System.Windows.FrameworkElement> や <xref:System.Windows.FrameworkContentElement> などのいくつかの重要な基本クラスの既定の XAML 名前空間内で指定される `Name` 依存関係プロパティが、同じ機能を満たすからです。  それでも、フレームワーク レベルで `Name` プロパティのない要素へのコード アクセスが重要となる XAML および WPF の一般的なシナリオもあります。  たとえば、一部のアニメーション サポート クラスおよびストーリーボード サポート クラスは、`Name` プロパティをサポートしていません。しかし、アニメーションを制御するためには、多くの場合、それらをコード内で参照する必要があります。  XAML で作成するタイムラインと変換を後でコードから参照するには、その属性として `x:Name` を指定する必要があります。  
+  
+ <xref:System.Windows.FrameworkElement.Name%2A> をクラスのプロパティとして使用できる場合、<xref:System.Windows.FrameworkElement.Name%2A> と `x:Name` のどちらも属性として使用できますが、両方を同じ要素で指定すると解析例外が発生します。  XAML をマークアップ コンパイルすると、マークアップ コンパイル時に例外が発生します。それ以外の場合は、読み込み時に例外が発生します。  
+  
+ <xref:System.Windows.FrameworkElement.Name%2A> は、XAML 属性構文や <xref:System.Windows.DependencyObject.SetValue%2A> を使用するコードで設定できます。ただし、コードから <xref:System.Windows.FrameworkElement.Name%2A> プロパティを設定した場合、XAML が既に読み込まれているほとんどの状況では、これを表すフィールド参照が XAML 名前スコープ内に作成されない場合があるので注意してください。  コードに <xref:System.Windows.FrameworkElement.Name%2A> を設定する代わりに、コードから適切な名前スコープに対して <xref:System.Windows.NameScope> メソッドを使用します。  
+  
+ <xref:System.Windows.FrameworkElement.Name%2A> は、内部テキストと一緒にプロパティ要素構文を使用して設定することもできますが、これは一般的ではありません。  対照的に、`x:Name` は、XAML プロパティ要素構文で設定したり、<xref:System.Windows.DependencyObject.SetValue%2A> を使用するコードで設定したりすることはできません。ディレクティブであるため、オブジェクトで要素の属性構文を使用する場合にのみ設定できます。  
+  
+## Silverlight の使用上の注意  
+ Silverlight 用の `x:Name` に関しては、別途ドキュメントが用意されています。  詳細については、「[XAML 名前空間 \(x:\) 言語機能 \(Silverlight\)](http://go.microsoft.com/fwlink/?LinkId=199081)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.FrameworkElement.Name%2A?displayProperty=fullName>   
+ <xref:System.Windows.FrameworkContentElement.Name%2A?displayProperty=fullName>   
+ [WPF のツリー](../../../docs/framework/wpf/advanced/trees-in-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-null-markup-extension.md b/docs/framework/xaml-services/x-null-markup-extension.md
new file mode 100644
index 00000000000..c4453bfdc3f
--- /dev/null
+++ b/docs/framework/xaml-services/x-null-markup-extension.md
@@ -0,0 +1,57 @@
+---
+title: "x:Null Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "NullExtension"
+  - "x:NullExtension"
+  - "x:Null"
+  - "Null"
+  - "xNull"
+helpviewer_keywords: 
+  - "Null markup extension in XAML [XAML Services]"
+  - "x:Null markup extension [XAML Services]"
+  - "XAML [XAML Services], x:Null markup extension"
+ms.assetid: 2e3ccc21-4996-481d-91b5-3910d8b3bfa3
+caps.latest.revision: 20
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# x:Null Markup Extension
+XAML メンバーの値として `null` を指定します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{x:Null}" .../>  
+```  
+  
+## 解説  
+ [!INCLUDE[TLA#tla_cshrp](../../../includes/tlasharptla-cshrp-md.md)] および [!INCLUDE[TLA#tla_cpp](../../../includes/tlasharptla-cpp-md.md)] における null 参照のキーワードは null です。  null 参照の [!INCLUDE[TLA#tla_visualb](../../../includes/tlasharptla-visualb-md.md)] キーワードは `Nothing` ですが、どの分離コード言語が XAML と関連付けられているかに関係なく、XAML の使用方法としては常に `{x:Null}` を使用してください。  
+  
+ `x:Null` のマークアップ拡張機能には、設定可能なプロパティはありません。  
+  
+ null の使用方法は多くの場合、CLR <xref:System.Nullable%601> 値の XAML メンバーの公開と関連付けられます。  
+  
+ XAML のあらゆるマークアップ拡張機能と同様、`x:Null` マークアップ拡張機能は、属性値の処理をリテラルやイベント ハンドラー参照以外にエスケープする場合、中かっこ \(`{,}`\) を使用します。  属性構文は、このマークアップ拡張機能で最も多く使用される構文です。  `x:Null` マークアップ拡張機能では位置指定パラメーターや構築引数は使用されないので、オブジェクト要素構文 `<x:Null />` は技術的には使用できますが、使用されることはまれです。  
+  
+ マークアップ拡張機能については、「[マークアップ拡張機能と WPF XAML](../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)」を参照してください。  
+  
+ .NET Framework XAML サービスでは、このマークアップ拡張機能の処理は、<xref:System.Windows.Markup.NullExtension> クラスによって定義されます。  
+  
+## WPF の使用上の注意  
+ `null` は、参照型の依存関係プロパティの初期未設定値であるとは限らないことに注意してください。  初期既定値は、依存関係プロパティごとに異なることがあります。また、プロパティ固有のメタデータに基づいていることがあります。  依存関係プロパティの多くは、その検証コールバックの実装により、マークアップまたはコードのいずれによる場合でも、`null` を値として許容しません。  依存関係プロパティの詳細については、「[依存関係プロパティの概要](../../../docs/framework/wpf/advanced/dependency-properties-overview.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.DependencyProperty.UnsetValue>   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-property-directive.md b/docs/framework/xaml-services/x-property-directive.md
new file mode 100644
index 00000000000..b5c1c1bcc80
--- /dev/null
+++ b/docs/framework/xaml-services/x-property-directive.md
@@ -0,0 +1,50 @@
+---
+title: "x:Property Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 618555a8-c893-455c-810f-ac54cd24ef10
+caps.latest.revision: 6
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# x:Property Directive
+マークアップで XAML プロパティを宣言します。  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+  
+<object x:Class="className">  
+  <x:Members>  
+    <x:Property Name="propertyName" Type="propertyType/>  
+    additionalProperties  
+  </x:Members>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`className`|XAML 運用環境のバッキング クラスまたは部分クラスの名前。|  
+|`propertyName`|定義されるプロパティのメンバーの名前。|  
+|`propertyType`|このプロパティの型を指定する型名 \(またはその他の文字列の形式、フレームワーク固有\)。|  
+  
+## 解説  
+ .NET Framework XAML サービス実装では、  `x:Property` には直接の型のバッキングはありませんが、<xref:System.Windows.Markup.PropertyDefinition> クラスによってサポートされています。  XAML ノード ストリームでは、`x:Property` 要素は、XAML 言語の XAML 名前空間から `Property` という名前のメンバーとして表されます。  メンバー `Property` は、マークアップによって宣言された属性を保持します。  
+  
+ `Name` と `Type` の意味は .NET Framework XAML サービス レベルでは割り当てられません。  これらは、特定のフレームワークによって課される可能性がある規則の下で後に解釈される文字列の値として、初期の XAML ノード ストリームに格納されます。  意味は、実装によって、XAML の名前および XAML 型の意味と揃えるか、バッキング型のシステムでのみ有効になることがあります。  
+  
+ マークアップでメンバーの定義を指定する手段として `x:Members` の実用的な使用法をサポートするため、メンバーを変更可能なクラスに関連付ける必要があります。  目的とするモデルは、`x:Members` が `x:Class` を指定する型のメンバーとして存在することです。  ただし、型とメンバーを関連付けたり、動的メンバーの定義を作成したりするメカニズムは、.NET Framework XAML サービス レベルではサポートされません。  これは、XAML のメンバーの定義をサポートするアプリケーション モデルがある個々のフレームワークに残されています。  一般に、XAML をマークアップ コンパイルするとともに、XAML と分離コードの統合または純粋な XAML からのアセンブリの生成を行う MSBUILD のビルド操作が、この機能をサポートするために必要です。  
+  
+## Windows Workflow Foundation の x:Property  
+ Windows Workflow Foundation では、 `x:Property` は、全体が XAML で構成されるカスタム アクティビティのメンバーや、分離コードを含むアクティビティ デザイナーの XAML で定義された動的メンバーを定義します。  `x:Class` は、XAML の運用環境のルート要素にも指定する必要があります。  これは、.NET Framework XAML サービス レベルの要件ではありませんが、全般にカスタム アクティビティと Windows Workflow Foundation の XAML をサポートする MSBUILD のビルド アクションによって XAML の運用環境が読み込まれるときの要件になります。  Windows Workflow Foundation は、`x:Property` `Type` 属性の目的とする値として、純粋な XAML の型名を使用しません。代わりに、このドキュメントで説明されていない規約を使用します。  詳細については、「[DynamicActivity の作成](http://msdn.microsoft.com/library/dd807392.aspx)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-reference-markup-extension.md b/docs/framework/xaml-services/x-reference-markup-extension.md
new file mode 100644
index 00000000000..1237834b562
--- /dev/null
+++ b/docs/framework/xaml-services/x-reference-markup-extension.md
@@ -0,0 +1,54 @@
+---
+title: "x:Reference Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "x:Reference markup extension [XAML Services]"
+  - "XAML [XAML Services], x:Reference Markup Extension"
+  - "Reference markup extension [XAML Services]"
+ms.assetid: 2982e68b-d26b-4aa3-826a-34c57a9c5199
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# x:Reference Markup Extension
+XAML マークアップの別の場所で宣言されているインスタンスを参照します。  参照は、要素の `x:Name` を参照します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{x:Reference instancexName}" .../>  
+```  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<object>  
+  <object.property>  
+    <x:Reference Name="instancexName"/>  
+  </object.property>  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`instancexName`|参照先のインスタンスの `x:Name` 値 \(または <xref:System.Windows.Markup.RuntimeNamePropertyAttribute> によって識別されるプロパティの値\)。|  
+  
+## 解説  
+ `x:Reference` は、WPF など、特定のフレームワークでは他の方法によって実装されていた要素の参照の概念に対して、XAML 言語レベルのサポートを提供します。  
+  
+## x:Reference と WPF  
+ WPF と XAML 2006 では、要素の参照は、<xref:System.Windows.Data.Binding.ElementName%2A> バインディングのフレームワークレベル機能によって対応していました。  大半の WPF アプリケーションおよびシナリオでは、<xref:System.Windows.Data.Binding.ElementName%2A> バインディングを継続して使用する必要があります。  ただし、データ コンテキストまたはスコープに関するその他の考慮事項によってデータ バインディングが実用的ではなくなる場合や、マークアップ コンパイルを伴わない場合などは例外です。  
+  
+ `x:Reference` は、XAML 2009 で定義されている構造です。  WPF では XAML 2009 の機能を使用できますが、WPF マークアップ コンパイルされていない XAML に限定されます。  マークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 言語のキーワードと機能をサポートしていません。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-shared-attribute.md b/docs/framework/xaml-services/x-shared-attribute.md
new file mode 100644
index 00000000000..32c1e9bb2cd
--- /dev/null
+++ b/docs/framework/xaml-services/x-shared-attribute.md
@@ -0,0 +1,62 @@
+---
+title: "x:Shared Attribute | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], x:Shared attribute"
+  - "x:Shared attribute [XAML Services]"
+  - "Shared attribute in XAML [XAML Services]"
+ms.assetid: c8cff434-2785-405f-9f95-16deb34c9e64
+caps.latest.revision: 16
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# x:Shared Attribute
+`false` に設定されると、WPF リソース取得動作を変更して、すべての要求で同じインスタンスを共有するのではなく、属性付きリソースに対して要求があるたびに新しいインスタンスが作成されるようにします。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<ResourceDictionary>  
+  <object x:Shared="false".../>  
+</ResourceDictionary>  
+```  
+  
+## 解説  
+ `x:Shared` は、XAML 言語 XAML 名前空間にマッピングされ、.NET Framework XAML サービスおよびその XAML リーダーによって有効な XAML 言語要素として認識されます。  ただし、`x:Shared` の規定の機能は、WPF アプリケーションおよび WPF XAML パーサーのみに関連しています。  WPF では、`x:Shared` は、WPF <xref:System.Windows.ResourceDictionary> 内に存在するオブジェクトに適用される場合にだけ属性として有用です。  その他の用途では、解析例外や他のエラーはスローされませんが、効果はありません。  
+  
+ `x:Shared` の意味は、XAML 言語仕様では指定されていません。  .NET Framework XAML サービスに基づいている実装など、その他の XAML 実装は、必ずしもリソース共有をサポートしているとは限りません。  このような XAML 実装は、`x:Shared` 値も使用するフレームワークのサポート時と同様に動作します。  
+  
+ WPF では、リソースに対する `x:Shared` の既定の状態は `true` です。  この状態は、指定したすべてのリソース要求が常に同じインスタンスを返すことを意味します。  
+  
+ <xref:System.Windows.FrameworkElement.FindResource%2A> などのリソース API をとおして返されるオブジェクトを変更するか、または <xref:System.Windows.ResourceDictionary> 内で直接オブジェクトを変更すると、元のリソースが変更されます。  そのリソースへの参照が動的リソース参照であった場合、そのリソースのコンシューマーは変更されたリソースを取得するようになります。  
+  
+ リソースへの参照が静的リソース参照であった場合は、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] 処理後にリソースを変更しても無意味です。  静的リソース参照と動的リソース参照の詳細については、「[XAML リソース](../../../docs/framework/wpf/advanced/xaml-resources.md)」を参照してください。  
+  
+ `x:Shared="true"` は既定の設定であるため、これを明示的に指定することはあまりありません。  WPF オブジェクト モデルには `x:Shared` と同等の直接的なコードはありません。そのようなコードは、XAML の使用方法でのみ指定でき、既定の WPF 動作によって、または .NET Framework XAML サービスとその XAML リーダーを使用して処理される場合は読み込みパス上の中間 XAML ノード ストリーム内で処理されることが必要です。  
+  
+ `x:Shared="false"` を指定するシナリオの 1 つに、<xref:System.Windows.FrameworkElement> 派生クラスまたは <xref:System.Windows.FrameworkContentElement> 派生クラスをリソースとして定義し、その要素リソースをコンテンツ モデルに導入する場合があります。  `x:Shared="false"` を指定することで、要素リソースを同じコレクション \(<xref:System.Windows.Controls.UIElementCollection> など\) に複数回導入できます。  `x:Shared="false"` を指定しない場合は、コレクションの内容が一意であることが強制されるため、この操作が無効になります。  ただし、`x:Shared="false"` の動作は、基本的には同じインスタンスを返すのではなく、リソースの同一インスタンスを新たに作成します。  
+  
+ `x:Shared="false"` を指定するもう 1 つのシナリオは、アニメーションの値用に <xref:System.Windows.Freezable> リソースを使用し、そのリソースをアニメーションごとに変更する場合です。  
+  
+ `false` 文字列の処理では、大文字と小文字が区別されません。  
+  
+ WPF では、`x:Shared` は、次の条件下でのみ有効となります。  
+  
+-   `x:Shared` が指定された項目を含んでいる <xref:System.Windows.ResourceDictionary> をコンパイルする必要があります。  <xref:System.Windows.ResourceDictionary> を Loose XAML 内に含めたり、テーマに使用したりすることはできません。  
+  
+-   項目を含んでいる <xref:System.Windows.ResourceDictionary> を、別の <xref:System.Windows.ResourceDictionary> 内に入れ子にすることはできません。  たとえば、既に <xref:System.Windows.ResourceDictionary> の項目となっている <xref:System.Windows.Style> 内にある <xref:System.Windows.ResourceDictionary> 内の項目には、`x:Shared` を使用できません。  
+  
+## 参照  
+ <xref:System.Windows.ResourceDictionary>   
+ [XAML リソース](../../../docs/framework/wpf/advanced/xaml-resources.md)   
+ [基本要素](../../../docs/framework/wpf/advanced/base-elements.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-static-markup-extension.md b/docs/framework/xaml-services/x-static-markup-extension.md
new file mode 100644
index 00000000000..84114e469b0
--- /dev/null
+++ b/docs/framework/xaml-services/x-static-markup-extension.md
@@ -0,0 +1,88 @@
+---
+title: "x:Static Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "StaticExtension"
+  - "xStatic"
+  - "x:Static"
+helpviewer_keywords: 
+  - "x:Static markup extension [XAML Services]"
+  - "Static markup extension in XAML [XAML Services]"
+  - "XAML [XAML Services], x:Static markup extension"
+ms.assetid: 056aee79-7cdd-434f-8174-dfc856cad343
+caps.latest.revision: 25
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# x:Static Markup Extension
+[!INCLUDE[TLA#tla_cls](../../../includes/tlasharptla-cls-md.md)] に準拠した方法で定義された静的な値渡しコード エンティティを参照します。  参照先の静的プロパティを使用して、XAML でプロパティの値を指定できます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{x:Static prefix:typeName.staticMemberName}" .../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`prefix`|省略可能です。  割り当てられた、既定以外の XAML 名前空間を参照するプレフィックス。  既定の XAML 名前空間から派生した静的プロパティを参照する機会はほとんどないので、実際の用途では `prefix` が明示的に使用されます。  「解説」を参照してください。|  
+|`typeName`|必ず指定します。  目的の静的なメンバーを定義する型の名前です。|  
+|`staticMemberName`|必ず指定します。  目的の静的な値メンバーの名前 \(定数、静的プロパティ、フィールド、または列挙値\)。|  
+  
+## 解説  
+ 参照されるコード エンティティは次のいずれかにする必要があります。  
+  
+-   定数  
+  
+-   静的プロパティ  
+  
+-   フィールド  
+  
+-   列挙値  
+  
+ 非静的プロパティなど、他のコード エンティティを指定すると、XAML のマークアップ コンパイル時にエラーが発生したり、XAML の読み込み時に解析例外が発生したりします。  
+  
+ 現在の XAML ドキュメントの既定の XAML 名前空間内にない静的なフィールドやプロパティに対して `x:Static` 参照を作成することはできますが、これにはプレフィックスの割り当てが必要です。  ほとんどの場合、XAML 名前空間は、XAML ドキュメントのルート要素で定義されます。  
+  
+ 静的プロパティのルックアップ操作は、既定の XAML スキーマ コンテキストで実行する場合、.NET Framework XAML サービスおよびその XAML リーダーと XAML ライターで実行できます。  この XAML スキーマ コンテキストでは、CLR リフレクションを使用して、オブジェクト グラフの構築に必要な静的な値を指定できます。  指定する `typeName` は、実際には XAML の型名であって、CLR の型名ではありません。ただし、既定の XAML スキーマ コンテキストを使用する場合、またはすべて CLR ベースの既存の XAML 実装フレームワークを使用する場合、両者は基本的には同じ名前となります。  
+  
+ 直接にはプロパティの値の型ではない `x:Static` 参照を作成する際には注意が必要です。  XAML の処理シーケンスでは、マークアップ拡張機能で指定した値に対して、さらに値変換が行われることはありません。  これは、`x:Static` 参照によって作成されるのがテキスト文字列でも同じであり、テキスト文字列に基づく属性値の値変換は、通常、特定のメンバーまたは戻り値の型の任意のメンバーに対して行われます。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `x:Static` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.Markup.StaticExtension> 拡張クラスの <xref:System.Windows.Markup.StaticExtension.Member%2A> 値として割り当てられます。  
+  
+ これ以外にも、技術的には可能な XAML の使用方法としては、次の 2 種類が挙げられます。  ただし、次の使用方法は必要以上に冗長なので、あまり一般的ではありません。  
+  
+ **オブジェクト要素構文:** `<x:Static Member="``prefix``:``typeName``.``staticMemberName``" .../>`  
+  
+ **初期化文字列の明示的なメンバー プロパティを含む属性構文:** `<``object````property``="{x:Static Member=``prefix``:``typeName``.``staticMemberName``}" .../>`  
+  
+ .NET Framework XAML サービス実装では、このマークアップ拡張機能の処理は、<xref:System.Windows.Markup.StaticExtension> クラスによって定義されます。  
+  
+ `x:Static` はマークアップ拡張機能です。  XAML のすべてのマークアップ拡張機能では、それぞれの属性構文で `{` と `}` の 2 つの記号を使用します。これは規約であり、これに従って XAML プロセッサは、マークアップ拡張機能で値を指定する必要があることを認識します。  マークアップ拡張機能の詳細については、「[Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)」を参照してください。  
+  
+## WPF の使用上の注意  
+ WPF プログラミングで使用する既定の XAML 名前空間には、有用な静的プロパティはそれほど数多くは用意されていません。また、有用な静的プロパティのほとんどで、型コンバーターなどの機能がサポートされており、特に `{x:Static}` を使用する必要はありません。  次のいずれかに該当する場合、静的プロパティに対して、XAML 名前空間のプレフィックスを割り当てる必要があります。  
+  
+-   WPF 内に存在するが、WPF の既定の XAML 名前空間 \([!INCLUDE[TLA#tla_wpfxmlnsv1](../../../includes/tlasharptla-wpfxmlnsv1-md.md)]\) の一部ではない型を参照している場合。  これは、`x:Static` を使用する非常に一般的なシナリオです。  たとえば、<xref:System.Environment> クラスの静的プロパティを参照するためには、<xref:System> CLR 名前空間と mscorlib アセンブリに割り当てられた XAML 名前空間を持つ `x:Static` 参照を使用できます。  
+  
+-   カスタム アセンブリの型を参照している場合。  
+  
+-   WPF アセンブリ内に存在する型を参照しているが、その型が WPF の既定の XAML 名前空間の一部になるように割り当てられた名前空間以外の CLR 名前空間内にある場合。  WPF の既定の XAML 名前空間への CLR 名前空間の割り当ては、各種 WPF アセンブリ \(この概念の詳細については、「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照\) の定義に基づいて実行されます。  未割り当ての CLR 名前空間は、その CLR 名前空間の大部分が、<xref:System.Windows.Threading> など、通常、XAML では使用されないクラス定義で構成される場合に存在できます。  
+  
+ WPF でのプレフィックスおよび XAML 名前空間の使用方法の詳細については、「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照してください。  
+  
+## 参照  
+ [x:Type Markup Extension](../../../docs/framework/xaml-services/x-type-markup-extension.md)   
+ [Types Migrated from WPF to System.Xaml](../../../docs/framework/xaml-services/types-migrated-from-wpf-to-system-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-subclass-directive.md b/docs/framework/xaml-services/x-subclass-directive.md
new file mode 100644
index 00000000000..f8af9fc9aa7
--- /dev/null
+++ b/docs/framework/xaml-services/x-subclass-directive.md
@@ -0,0 +1,68 @@
+---
+title: "x:Subclass Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "Subclass"
+  - "xSubclass"
+  - "x:Subclass"
+helpviewer_keywords: 
+  - "x:Subclass attribute [XAML Services]"
+  - "XAML [XAML Services], x:Subclass attribute"
+  - "Subclass attribute in XAML [XAML Services]"
+ms.assetid: 99f66072-8107-4362-ab99-8171dc83b469
+caps.latest.revision: 20
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# x:Subclass Directive
+`x:Class` も提供される場合の XAML マークアップのコンパイル動作を変更します。  `x:Class` クラスに基づいて部分クラスを作成する代わりに、提供された `x:Class` を中間クラスとして作成し、ユーザーが提供した派生クラスは `x:Class` に基づくものと想定されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Class="namespace.classname" x:Subclass="subclassNamespace.subclassName">  
+   ...  
+</object>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`namespace`|省略可能です。  `classname` を含む CLR 名前空間を指定します。  `namespace` を指定する場合は、`namespace` と `classname` をドット \(.\) で区切ります。|  
+|`classname`|必ず指定します。  読み込まれた XAML、およびその XAML の分離コードを接続する部分クラスの CLR 名を指定します。  「解説」を参照してください。|  
+|`subclassNamespace`|省略可能です。  各名前空間が他の名前空間を解決できる場合、`namespace` と異なっていてもかまいません。  `subclassName` を含む CLR 名前空間を指定します。  `subclassName` を指定する場合は、`subclassNamespace` と `subclassName` をドット \(.\) で区切ります。|  
+|`subclassName`|必ず指定します。  サブクラスの CLR 名を指定します。|  
+  
+## 依存関係  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md) も同じオブジェクトに提供される必要があり、そのオブジェクトは XAML 稼動環境のルート要素である必要があります。  
+  
+## 解説  
+ `x:Subclass` は、主として、部分クラス宣言をサポートしない言語のためのものです。  
+  
+ `x:Subclass` として使用されるクラスは入れ子のクラスにすることはできず、`x:Subclass` は、「依存関係」のセクションで説明したとおり、ルート オブジェクトを参照している必要があります。  
+  
+ それ以外の点について、`x:Subclass` の概念的な意味は、.NET Framework XAML サービス実装では定義されていません。  これは、.NET Framework XAML サービスの動作で、XAML マークアップと対応するコードが関連付けられるプログラミング モデル全体が指定されていないためです。  `x:Class` と `x:Subclass` に関連するその他の概念の実装は、XAML マークアップ、コンパイルされたマークアップ、および CLR ベースの分離コードを関連付ける方法を定義するために、プログラミング モデルまたはアプリケーション モデルを使用する特定のフレームワークによって実行されます。  それぞれのフレームワークは、一部の動作を実現する独自のビルド アクションや、ビルド環境に含める必要のある特定のコンポーネントを備えています。  フレームワーク内では、分離コードで使用される特定の CLR 言語に応じてビルド アクションは変化することもあります。  
+  
+## WPF の使用上の注意  
+ `x:Subclass` は、ページ ルート上に配置することも、既に `x:Class` を持つアプリケーション定義内の <xref:System.Windows.Application> ルート上に配置することもできます。  `x:Subclass`  を、ページ ルートまたはアプリケーション ルート以外の要素で宣言すると、または `x:Class` が存在しない場所で指定すると、コンパイル時エラーが発生します。  
+  
+ `x:Subclass` のシナリオで正しく動作する派生クラスを作成するのは、かなり複雑な作業です。  中間ファイル \(マークアップ コンパイルによってプロジェクトの obj フォルダーに生成される .g ファイルで、名前には .xaml ファイル名が含まれる\) の確認が必要になる場合があります。  これらの中間ファイルは、コンパイル済みアプリケーション内の結合された部分クラスにおいて、特定のプログラミング構造の起点を特定するのに役立ちます。  
+  
+ コンパイル時に中間クラスで作成されるハンドラーのスタブをオーバーライドするには、派生クラス内のイベント ハンドラーが `internal override` \([!INCLUDE[TLA#tla_visualb](../../../includes/tlasharptla-visualb-md.md)] では `Friend Overrides`\) でなければなりません。  それ以外の場合は、派生クラスの実装が中間クラスの実装を隠し \(シャドウ\)、中間クラスのハンドラーは呼び出されません。  
+  
+ `x:Class` と `x:Subclass` の両方を定義する場合、`x:Class` によって参照されるクラスの実装を提供する必要はありません。  コンパイラが中間ファイルで作成するクラスについてガイダンスを得られるよう、`x:Class` 属性を使用して名前を指定することだけが必要です \(この場合、コンパイラは既定の名前を選択しません\)。  `x:Class` クラスに実装を提供してもかまいませんが、これは `x:Class` と `x:Subclass` の両方を使用する標準的なシナリオでは行いません。  
+  
+## 参照  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)   
+ [WPF における XAML とカスタム クラス](../../../docs/framework/wpf/advanced/xaml-and-custom-classes-for-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-type-markup-extension.md b/docs/framework/xaml-services/x-type-markup-extension.md
new file mode 100644
index 00000000000..70dfaeedcb4
--- /dev/null
+++ b/docs/framework/xaml-services/x-type-markup-extension.md
@@ -0,0 +1,93 @@
+---
+title: "x:Type Markup Extension | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:TypeExtension"
+  - "Type"
+  - "x:Type"
+  - "xType"
+  - "TypeExtension"
+helpviewer_keywords: 
+  - "x:Type markup extension [XAML Services]"
+  - "XAML [XAML Services], x:Type markup extension"
+  - "XAML [XAML Services], TargetType attribute"
+  - "TargetType attribute [XAML Services]"
+  - "Type markup extension in XAML [XAML Services]"
+ms.assetid: e0e0ce6f-e873-49c7-8ad7-8b840eb353ec
+caps.latest.revision: 27
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# x:Type Markup Extension
+指定した XAML 型の基になる型の CLR <xref:System.Type> オブジェクトを指定します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object property="{x:Type prefix:typeNameValue}" .../>  
+```  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<x:Type TypeName="prefix:typeNameValue"/>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`prefix`|省略可能です。  既定以外の XAML 名前空間を割り当てるプレフィックス。  ほとんどの場合、プレフィックスは指定する必要がありません。  「解説」を参照してください。|  
+|`typeNameValue`|必ず指定します。  現在の既定の XAML 名前空間で解決できる型名。`prefix` を指定した場合はその割り当てられたプレフィックス。|  
+  
+## 解説  
+ `x:Type` マークアップ拡張機能は、[!INCLUDE[TLA#tla_cshrp](../../../includes/tlasharptla-cshrp-md.md)] の `typeof()` 演算子または [!INCLUDE[TLA#tla_visualb](../../../includes/tlasharptla-visualb-md.md)] の `GetType` 演算子に似た機能を備えています。  
+  
+ `x:Type` マークアップ拡張機能は、型 <xref:System.Type> を使用するプロパティの文字列からの変換動作を指定します。  入力は XAML 型です。  入力 XAML 型と出力 CLR <xref:System.Type> との関係は、XAML スキーマ コンテキストとそのコンテキストが提供する <xref:System.Windows.Markup.IXamlTypeResolver> サービスに基づいて必須の <xref:System.Xaml.XamlType> を検索した後、出力 <xref:System.Type> が入力 <xref:System.Xaml.XamlType> の <xref:System.Xaml.XamlType.UnderlyingType%2A> であることです。  
+  
+ .NET Framework XAML サービスでは、このマークアップ拡張機能の処理は、<xref:System.Windows.Markup.TypeExtension> クラスによって定義されます。  
+  
+ 特定のフレームワーク実装では、値として <xref:System.Type> を受け取る一部のプロパティは、型の名前 \(型の `Name` の文字列値\) を直接受け入れることができます。  ただし、このような動作を実装するのは複雑なシナリオとなります。  例については、後の「WPF の使用上の注意」を参照してください。  
+  
+ 属性構文は、このマークアップ拡張機能で使用される最も一般的な構文です。  `x:Type` 識別子文字列の後に設定される文字列トークンは、基になる <xref:System.Windows.Markup.TypeExtension> 拡張クラスの <xref:System.Windows.Markup.TypeExtension.TypeName%2A> 値として割り当てられます。  CLR 型に基づく、.NET Framework XAML サービスの既定の XAML スキーマ コンテキストでは、この属性の値は、対象の型の <xref:System.Reflection.MemberInfo.Name%2A> になるか、または、既定以外の XAML 名前空間割り当ての場合はプレフィックスが付加された <xref:System.Reflection.MemberInfo.Name%2A> を含みます。  
+  
+ `x:Type` マークアップ拡張機能は、オブジェクト要素構文で使用できます。  この場合、拡張機能を正しく初期化するには、<xref:System.Windows.Markup.TypeExtension.TypeName%2A> プロパティの値を指定する必要があります。  
+  
+ `x:Type` マークアップ拡張機能は詳細出力属性として使用することもできますが、この用法は一般的ではありません \(`<``object` `property``="{x:Type TypeName=``typeNameValue``}" .../>`\)。  
+  
+## WPF の使用上の注意  
+  
+### 既定の XAML 名前空間および型の割り当て  
+ WPF プログラミングの既定の XAML 名前空間には、通常の XAML シナリオで必要なほとんどの XAML 型が含まれるため、通常は、XAML 型値を参照するときにプレフィックスを回避できます。  カスタム アセンブリ内の型を参照している場合、または WPF アセンブリ内に存在する型ではあるが、その型がある CLR 名前空間が既定の XAML 名前空間に割り当てられていない場合は、プレフィックスの割り当てが必要になることがあります。  プレフィックス、XML 名前空間、および CLR 名前空間の割り当ての詳細については、「[XAML 名前空間および WPF XAML の名前空間の割り当て](../../../docs/framework/wpf/advanced/xaml-namespaces-and-namespace-mapping-for-wpf-xaml.md)」を参照してください。  
+  
+### 文字列としての型名をサポートする型プロパティ  
+ WPF は、`x:Type` マークアップ拡張機能を使用する必要なく、型 <xref:System.Type> の一部のプロパティの値を指定できる技術をサポートしています。  代わりに、型に名前を付ける文字列として値を指定できます。  この例としては、<xref:System.Windows.Controls.ControlTemplate.TargetType%2A?displayProperty=fullName> および <xref:System.Windows.Style.TargetType%2A?displayProperty=fullName> があります。  型コンバーターとマークアップ拡張機能は、どちらもこの動作をサポートしていません。  これは、<xref:System.Windows.FrameworkElementFactory> を通じて実装される遅延動作です。  
+  
+ Silverlight も同様の規則となります。  実際、Silverlight の XAML 言語の対応状況を見ると、現在 `{x:Type}` はサポートされていません。WPF から Silverlight への XAML の移行支援を意図した一部の状況を除いて、`{x:Type}` の使用は認められていません。  したがって、文字列としての型名の動作は、<xref:System.Type> が値となる、Silverlight のすべてのネイティブ プロパティの評価に組み込まれています。  
+  
+## XAML 2009  
+ XAML 2009 はジェネリック型に対するサポートを強化し、このサポートを実現できるよう `x:TypeArguments` および `x:Type` の機能の動作を修正します。  
+  
+-   `x:TypeArguments` および汎用オブジェクトのインスタンス化で使用される関連オブジェクト要素は、ルート以外の要素上にあることがあります。  詳細については、「[x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)」の「XAML 2009」のセクションを参照してください。  
+  
+-   XAML 2009 は、マークアップでジェネリック型の制約を指定する構文をサポートします。  これは、`x:TypeArguments`、`x:Type`、またはこれら 2 つの機能の組み合わせで使用できます。  
+  
+-   XAML 2009 の読み込みを処理する WPF の XAML 実装も、型 <xref:System.Type> を使用する特定のフレームワーク プロパティの暗黙的な型変換動作に対して、この機能を追加します。  
+  
+ WPF では XAML 2009 の機能を使用できますが、Loose XAML \(マークアップ コンパイルされていない XAML\) に限定されます。  WPF 向けにマークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 のキーワードと機能をサポートしていません。  
+  
+## 参照  
+ <xref:System.Windows.Style>   
+ [スタイルとテンプレート](../../../docs/framework/wpf/controls/styling-and-templating.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)   
+ [マークアップ拡張機能と WPF XAML](../../../docs/framework/wpf/advanced/markup-extensions-and-wpf-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-typearguments-directive.md b/docs/framework/xaml-services/x-typearguments-directive.md
new file mode 100644
index 00000000000..03e55dd6d1e
--- /dev/null
+++ b/docs/framework/xaml-services/x-typearguments-directive.md
@@ -0,0 +1,95 @@
+---
+title: "x:TypeArguments Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:TypeArguments"
+  - "xTypeArguments"
+  - "TypeArguments"
+helpviewer_keywords: 
+  - "x:TypeArguments attribute [XAML Services]"
+  - "TypeArguments attribute in XAML [XAML Services]"
+  - "XAML [XAML Services], x:TypeArguments attribute"
+ms.assetid: 86561058-d393-4a44-b5c3-993a4513ea74
+caps.latest.revision: 18
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# x:TypeArguments Directive
+ジェネリックの制約型引数をジェネリック型のコンストラクターに渡します。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:TypeArguments="typeString" .../>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`object`|CLR ジェネリック型によってサポートされる XAML 型のオブジェクト要素の宣言。  `object` が、既定の XAML 名前空間から派生していない XAML 型である場合、`object` は `object` が存在する XAML 名前空間を示すプレフィックスを必要とします。|  
+|`typeString`|CLR ジェネリック型に型引数を提供する、1 つ以上の XAML 型名を文字列として宣言する文字列。  構文の注意事項の詳細については、「解説」を参照してください。|  
+  
+## 解説  
+ ほとんどの場合、`typeString` 文字列の情報項目として使用される XAML 型には、プレフィックスが付加されます。  CLR ジェネリック制約 \(<xref:System.Int32>、<xref:System.String> など\) の一般的な型は、CLR 基本クラス ライブラリから派生します。  これらのライブラリは一般的なフレームワーク固有の既定の XAML 名前空間にマッピングされないので、XAML の使用方法に対応するプレフィックスのマッピングが必要になります。  
+  
+ コンマを区切り記号として使用することで、複数の XAML 型名を指定できます。  
+  
+ ジェネリック制約自体がジェネリック型を使用している場合、ネストされた制約型引数はかっこ \(\) で囲むことができます。  
+  
+ この `x:TypeArguments` の定義は、.NET Framework XAML サービスに固有で、CLR バッキングを使用していることに注意してください。  言語レベルの定義については、「[\[MS\-XAML\] 第 5.3.11 節](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。  
+  
+## 使用例  
+ この例では、次の XAML 名前空間の定義が宣言されていることを前提としています。  
+  
+```  
+xmlns:sys="clr-namespace:System;assembly=mscorlib"  
+xmlns:scg="clr-namespace:System.Collections.Generic;assembly=mscorlib"  
+```  
+  
+### List\<String\>  
+ `<scg:List x:TypeArguments="sys:String" ...>` は、<xref:System.String> 型引数で新しい <xref:System.Collections.Generic.List%601> をインスタンス化します。  
+  
+### Dictionary\<String,String\>  
+ `<scg:Dictionary x:TypeArguments="sys:String,sys:String" ...>` は、2 つの <xref:System.String> 型引数で新しい <xref:System.Collections.Generic.Dictionary%602> をインスタンス化します。  
+  
+### Queue\<KeyValuePair\<String,String\>\>  
+ `<scg:Queue x:TypeArguments="scg:KeyValuePair(sys:String,sys:String)" ...>` は、内部制約型引数 <xref:System.String> および <xref:System.String> で <xref:System.Collections.Generic.KeyValuePair%602> の制約がある新しい <xref:System.Collections.Generic.Queue%601> をインスタンス化します。  
+  
+## XAML 2006 および WPF ジェネリック XAML の使用方法  
+ XAML 2006 の使用方法と、WPF アプリケーションで使用される XAML では、通常、XAML からの `x:TypeArguments` とジェネリック型の使用方法に対して、次のような制約があります。  
+  
+-   ジェネリック型を参照するジェネリック XAML の使用方法をサポートできるのは、XAML ファイルのルート要素のみに限定されます。  
+  
+-   ルート要素は最低 1 つの型引数と共にジェネリック型にマッピングする必要があります。  <xref:System.Windows.Navigation.PageFunction%601> はその一例です。  ページ関数は、WPF でジェネリック XAML の使用方法をサポートする主なシナリオです。  
+  
+-   ジェネリック対応のルート要素の XAML オブジェクト要素も、`x:Class` を使用して特定のクラスを宣言する必要があります。  これは、WPF ビルド アクションを定義する場合にも当てはまります。  
+  
+-   `x:TypeArguments` は、ネストされたジェネリック制約を参照できません。  
+  
+## XAML 2009、または WPF 3.0\/3.5 に依存しない XAML 2006  
+ XAML 2006 または XAML 2009 の .NET Framework XAML サービスでは、ジェネリック XAML の使用方法に対する WPF 関連の制約が緩和されています。  バッキング型システムとオブジェクト モデルがサポートできる XAML マークアップの任意の位置で、汎用オブジェクト要素をインスタンス化できます。  
+  
+ XAML 2009 を使用している場合は、一般的な言語プリミティブを取得するために CLR 基本型をマッピングする代わりに、[共通の XAML 言語プリミティブの組み込み型](../../../docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md)を `typeString` の情報アイテムとして使用できます。  たとえば、次を宣言できます \(プレフィックス マッピングは示されていません。x は XAML 2009 の XAML 言語 XAML 名前空間です\)。  
+  
+```  
+<my:BusinessObject x:TypeArguments="x:String,x:Int32"/>  
+```  
+  
+ WPF で、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] を対象としている場合は、XAML 2009 の機能を `x:TypeArguments` と共に使用できますが、Loose XAML \(マークアップ コンパイルされていない XAML\) に限定されます。  WPF 向けにマークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 のキーワードと機能をサポートしていません。  XAML をマークアップ コンパイルする必要がある場合、「XAML 2006 および WPF ジェネリック XAML の使用方法」に記載された制約に従って操作する必要があります。  
+  
+## 参照  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)   
+ [x:Type Markup Extension](../../../docs/framework/xaml-services/x-type-markup-extension.md)   
+ [共通の XAML 言語プリミティブの組み込み型](../../../docs/framework/xaml-services/built-in-types-for-common-xaml-language-primitives.md)   
+ [Generics in XAML](../../../docs/framework/xaml-services/generics-in-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-uid-directive.md b/docs/framework/xaml-services/x-uid-directive.md
new file mode 100644
index 00000000000..f5d56e8fc0e
--- /dev/null
+++ b/docs/framework/xaml-services/x-uid-directive.md
@@ -0,0 +1,54 @@
+---
+title: "x:Uid Directive | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], localizable content attribute"
+  - "XAML [XAML Services], x:Uid attribute"
+  - "x:Uid attribute [XAML Services]"
+  - "Uid attribute [XAML Services]"
+ms.assetid: 81defade-483b-4a89-b76d-9b25bba34010
+caps.latest.revision: 12
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# x:Uid Directive
+マークアップ要素の一意識別子を提供します。  多くの場合、この一意識別子は XAML のローカリゼーションのプロセスとツールによって使用されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object x:Uid="identifier"... />  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`identifier`|`x:Uid` コンシューマーによる解釈時にファイル内で一意であることが必要となる、手動で作成または自動生成された文字列。|  
+  
+## 解説  
+ \[MS\-XAML\] では、`x:Uid` はディレクティブとして定義されます。  詳細については、「[\[MS\-XAML\] 第 5.3.6 節](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。  
+  
+ 規定された XAML のローカリゼーション シナリオにより、`x:Uid` は `x:Name` から分離しています。したがって、ローカリゼーションで使用される識別子は、プログラミング モデルの関連において `x:Name` への依存関係はありません。  また、`x:Name` が XAML 名前スコープによって制御されるのに対して、`x:Uid` が XAML 言語で定義された一意性の適用の概念によって制御されることはありません。  一般的な意味での XAML プロセッサ \(ローカリゼーション プロセスに関与しないプロセッサ\) では、`x:Uid` 値の一意性を適用する処理は行われません。  概念上、この処理は値を作成する側の責任で行われます。  専用のグローバリゼーションのプロセスやツールなど、この値を使用する側にとっては、単一の XAML ソースに含まれる `x:Uid` 値が一意になっていると想定するのは当然のことになります。  一般的な一意性モデルでは、XAML を表現する XML でエンコードされたファイル内で `x:Uid` 値は一意になります。  
+  
+ 特定の XAML スキーマを十分に認識するツールでは、テキスト文字列値がマークアップで検出されたすべてのケースに対してではなく、本当にローカライズ可能な文字列のみに `x:Uid` を適用するよう選択できます。  
+  
+ フレームワークでは、属性 <xref:System.Windows.Markup.UidPropertyAttribute> を定義元の型に適用することで、オブジェクト モデルに含まれる特定のプロパティを `x:Uid` のエイリアスとして指定できます。  フレームワークで特定のプロパティを指定する場合、同じオブジェクトで `x:Uid` とエイリアス化したメンバーの両方を指定することは無効です。  `x:Uid` とエイリアス化したメンバーの両方を指定した場合、.NET Framework XAML サービス API によって通常、このケースでは <xref:System.Xaml.XamlDuplicateMemberException> がスローされます。  
+  
+## WPF の使用上の注意  
+ WPF ローカリゼーションのプロセスおよび XAML の BAML 形式における `x:Uid` の役割の詳細については、「[WPF のグローバリゼーション](../../../docs/framework/wpf/advanced/globalization-for-wpf.md)」または「<xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A>」を参照してください。  
+  
+## 参照  
+ <xref:System.Windows.Markup.Localizer.BamlLocalizableResourceKey.Uid%2A>   
+ <xref:Microsoft.Build.Tasks.Windows.UidManager>   
+ [WPF のグローバリゼーション](../../../docs/framework/wpf/advanced/globalization-for-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/x-xdata-intrinsic-xaml-type.md b/docs/framework/xaml-services/x-xdata-intrinsic-xaml-type.md
new file mode 100644
index 00000000000..3e50b099c75
--- /dev/null
+++ b/docs/framework/xaml-services/x-xdata-intrinsic-xaml-type.md
@@ -0,0 +1,62 @@
+---
+title: "x:XData Intrinsic XAML Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "x:XData"
+  - "XData"
+  - "xXData"
+helpviewer_keywords: 
+  - "XAML [XAML Services], x:XData directive element"
+  - "XData in XAML [XAML Services]"
+  - "x:XData XAML directive element [XAML Services]"
+ms.assetid: 7ce209c2-621b-4977-b643-565f7e663534
+caps.latest.revision: 17
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# x:XData Intrinsic XAML Type
+XML データ アイランドを XAML 稼動環境内に配置できるようにします。  `x:XData` 内の XML 要素は、動作している既定の XAML 名前空間またはその他の XAML 名前空間の一部として扱うことはできません。  `x:XData` は、任意の整形式 XML を含むことができます。  
+  
+## XAML オブジェクト要素の使用方法  
+  
+```  
+<x:XData>  
+  <elementDataRoot>  
+    [elementData]  
+  </elementDataRoot>  
+</x:XData>  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|`elementDataRoot`|囲まれたデータ アイランドの単一ルート要素。  ほとんどのコンシューマーでは、最終的に、単一のルートを持たない XML は無効と見なされます。  特に、`x:XData` が、WPF \(または XML ソースをデータ バインディングに使用するその他各種テクノロジ\) の XML データ ソースとして使用される場合、単一のルートが必要になります。|  
+|`[elementData]`|省略可能です。  XML データを表す XML。  要素データとして任意の数の要素を含めることができる、入れ子にした要素を他の要素に含めることができるなど、XML の一般規則が適用されます。|  
+  
+## 解説  
+ `x:XData` オブジェクト内の XML 要素は、このデータ内で、格納している側の XMLDOM のすべての考えられる名前空間およびプレフィックスを再宣言できます。  
+  
+ XML データおよび `x:XData` 組み込み XAML 型へのプログラムによるアクセスは、.NET Framework XAML サービスでは、<xref:System.Windows.Markup.XData> クラスを介して実行できます。  
+  
+## WPF の使用上の注意  
+ The `x:XData` オブジェクトは主に、<xref:System.Windows.Data.XmlDataProvider> の子オブジェクトとして使用されるか、<xref:System.Windows.Data.XmlDataProvider.XmlSerializer%2A?displayProperty=fullName> プロパティ \(XAML では、通常、プロパティ要素構文で表される\) の子オブジェクトとして使用されます。  
+  
+ 一般に、データ アイランド内では、基本 XML 名前空間を新しい既定の XML 名前空間として再定義する必要があります \(空の文字列に設定\)。  この方法は、単純なデータ アイランドの場合には最も簡単です。データを参照やバインドに <xref:System.Windows.Data.Binding.XPath%2A> 式を使用することでプレフィックスが不要になるからです。  より複雑なデータ アイランドでは、データのプレフィックスを複数定義し、ルートにある XML 名前空間に特定のプレフィックスを使用するという方法を選択できます。  この場合は、すべての <xref:System.Windows.Data.Binding.XPath%2A> 式参照において、名前空間にマップされた適切なプレフィックスを付ける必要があります。  詳細については、「[データ バインドの概要](../../../docs/framework/wpf/data/data-binding-overview.md)」を参照してください。  
+  
+ 技術的には、`x:XData` は <xref:System.Xml.Serialization.IXmlSerializable> 型の任意のプロパティのコンテンツとして使用できます。  ただし、よく使用されているのは <xref:System.Windows.Data.XmlDataProvider.XmlSerializer%2A?displayProperty=fullName> の実装のみです。  
+  
+## 参照  
+ <xref:System.Windows.Data.XmlDataProvider>   
+ [データ バインドの概要](../../../docs/framework/wpf/data/data-binding-overview.md)   
+ [バインドのマークアップ拡張機能](../../../docs/framework/wpf/advanced/binding-markup-extension.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xaml-2009-language-features.md b/docs/framework/xaml-services/xaml-2009-language-features.md
new file mode 100644
index 00000000000..b04355fc95f
--- /dev/null
+++ b/docs/framework/xaml-services/xaml-2009-language-features.md
@@ -0,0 +1,43 @@
+---
+title: "XAML 2009 Language Features | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML 2009 [XAML Services]"
+  - "XAML [XAML Services], XAML 2009"
+ms.assetid: f6bb18d8-c86a-4549-8862-323e6b32a8dd
+caps.latest.revision: 11
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# XAML 2009 Language Features
+XAML 2009 とは、既存の XAML 言語仕様を拡張した、XAML の新しい言語機能の短縮名です。 XAML 2009 には、いくつかの新しいディレクティブとコンストラクトが導入されています。 たとえば、[x:Arguments Directive](../../../docs/framework/xaml-services/x-arguments-directive.md)、[x:FactoryMethod Directive](../../../docs/framework/xaml-services/x-factorymethod-directive.md)、[x:Reference Markup Extension](../../../docs/framework/xaml-services/x-reference-markup-extension.md)、[x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)、共通言語プリミティブの組み込み型 \(`x:Char` など\) があります。  
+  
+<a name="xaml_2009_support_in_wpf_and_visual_studio"></a>   
+## XAML 2009 は、WPF および Visual Studio でサポートされています。  
+ WPF では XAML 2009 の機能を使用できますが、WPF マークアップ コンパイルされていない XAML に限定されます。 マークアップ コンパイルされた XAML、および XAML の BAML 形式は、現在、XAML 2009 言語のキーワードと機能をサポートしていません。  
+  
+ なお、WPF に Loose XAML を読み込むための既存の方法には、CLR 型および型システムに対するセキュリティ制限およびアクセス制限が課されていることがあります。この制限は、マークアップ コンパイルされた XAML に対する制限よりも限定的です。 詳細については、「[セキュリティ \(WPF\)](../../../docs/framework/wpf/security-wpf.md)」または「[WPF のセキュリティ方針 \- プラットフォーム セキュリティ](../../../docs/framework/wpf/wpf-security-strategy-platform-security.md)」を参照してください。  
+  
+ また、XAML 2009 では、以前の XAML 2006 構造を変更するか、または基本的なマークアップ形式を変更する、追加機能も導入されました。  
+  
+### オブジェクトの要素としての x:Key  
+ XAML 2009 では `x:Key` をオブジェクト \(オブジェクト要素値を持つプロパティ要素\) としてサポートできます。XAML 2006 では、`x:Key` は属性としてのみサポートされていました。 「[x:Key Directive](../../../docs/framework/xaml-services/x-key-directive.md)」の「XAML 2009」のセクションを参照してください。  
+  
+### プロパティ要素の xmlns  
+ XAML 2009 は、プロパティ要素に対する XAML 名前空間 \(xmlns\) の定義をサポートできます。XAML 2006 では、オブジェクト要素に対してのみ xmlns 定義をサポートしていました。  
+  
+### イベント属性  
+ イベントによってサポートされる属性については、XAML 2006 ではマークアップ コンパイルが関係していると仮定されて、イベントはマークアップ コンパイルに送信されます。 XAML 2009 はマークアップ拡張機能に似たマークアップ形式をサポートします。このマークアップ形式は、XAML のランタイム解析と読み込みが行われるまでイベント接続を遅延します。 ただし、WPF アプリケーション、および WPF の UI の XAML シナリオでは、一般にこの機能は使用しません。 WPF およびその XAML 2006 の実装では、イベント属性処理の大部分に対し、<xref:System.Windows.UIElement> レベルで定義されたルーティング イベントのイベント ハンドラー接続と、そのマークアップ コンパイラ手順の組み合わせを使用します。 マークアップ コンパイラは、XAML 内に見つかるすべてのイベント属性を事前に処理し、マークアップ コンパイラが使用されることがビルド アクションによって宣言されます。  
+  
+## 参照  
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xaml-namespace-x-language-features.md b/docs/framework/xaml-services/xaml-namespace-x-language-features.md
new file mode 100644
index 00000000000..46dd55f1479
--- /dev/null
+++ b/docs/framework/xaml-services/xaml-namespace-x-language-features.md
@@ -0,0 +1,47 @@
+---
+title: "XAML Namespace (x:) Language Features | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "AutoGeneratedOrientationPage"
+helpviewer_keywords: 
+  - "XAML namespace [XAML Services]"
+  - "XAML [XAML Services], namespaces"
+ms.assetid: e1f47225-9996-4fbf-ab86-62d2e955f3fc
+caps.latest.revision: 61
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 58
+---
+# XAML Namespace (x:) Language Features
+## このセクションの内容  
+ [x:Array Markup Extension](../../../docs/framework/xaml-services/x-array-markup-extension.md)  
+ [x:Class Directive](../../../docs/framework/xaml-services/x-class-directive.md)  
+ [x:ClassModifier Directive](../../../docs/framework/xaml-services/x-classmodifier-directive.md)  
+ [x:Code Intrinsic XAML Type](../../../docs/framework/xaml-services/x-code-intrinsic-xaml-type.md)  
+ [x:FieldModifier Directive](../../../docs/framework/xaml-services/x-fieldmodifier-directive.md)  
+ [x:Key Directive](../../../docs/framework/xaml-services/x-key-directive.md)  
+ [x:Member Directive](../../../docs/framework/xaml-services/x-member-directive.md)  
+ [x:Members Directive](../../../docs/framework/xaml-services/x-members-directive.md)  
+ [x:Name Directive](../../../docs/framework/xaml-services/x-name-directive.md)  
+ [x:Null Markup Extension](../../../docs/framework/xaml-services/x-null-markup-extension.md)  
+ [x:Shared Attribute](../../../docs/framework/xaml-services/x-shared-attribute.md)  
+ [x:Property Directive](../../../docs/framework/xaml-services/x-property-directive.md)  
+ [x:Static Markup Extension](../../../docs/framework/xaml-services/x-static-markup-extension.md)  
+ [x:Subclass Directive](../../../docs/framework/xaml-services/x-subclass-directive.md)  
+ [x:Type Markup Extension](../../../docs/framework/xaml-services/x-type-markup-extension.md)  
+ [x:TypeArguments Directive](../../../docs/framework/xaml-services/x-typearguments-directive.md)  
+ [x:Uid Directive](../../../docs/framework/xaml-services/x-uid-directive.md)  
+ [x:XData Intrinsic XAML Type](../../../docs/framework/xaml-services/x-xdata-intrinsic-xaml-type.md)  
+ [XamlName の文法](../../../docs/framework/xaml-services/xamlname-grammar.md)  
+ [{} Escape Sequence \/ Markup Extension](../../../docs/framework/xaml-services/escape-sequence-markup-extension.md)  
+ [xml:lang Handling in XAML](../../../docs/framework/xaml-services/xml-lang-handling-in-xaml.md)  
+ [xml:space Handling in XAML](../../../docs/framework/xaml-services/xml-space-handling-in-xaml.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xaml-namespaces-for-net-framework-xaml-services.md b/docs/framework/xaml-services/xaml-namespaces-for-net-framework-xaml-services.md
new file mode 100644
index 00000000000..62d14395d5f
--- /dev/null
+++ b/docs/framework/xaml-services/xaml-namespaces-for-net-framework-xaml-services.md
@@ -0,0 +1,74 @@
+---
+title: "XAML Namespaces for .NET Framework XAML Services | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: e4f15f13-c420-4c1e-aeab-9b6f50212047
+caps.latest.revision: 3
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XAML Namespaces for .NET Framework XAML Services
+XAML 名前空間は、XML 名前空間の定義を拡張する概念です。  XML 名前空間と同様に、マークアップ内で `xmlns` 属性を使用することで XAML 名前空間を定義できます。  XAML 名前空間は XAML ノード ストリームなどの XAML サービス API でも表されます。  このトピックでは、XAML 名前空間の概念について説明し、XAML 名前空間の定義の方法と、XAML スキーマ コンテキストなどの .NET Framework XAML サービスの各要素で XAML 名前空間を使用する方法について説明します。  
+  
+## XML 名前空間と XAML 名前空間  
+ XAML が特殊な形式の XML であるように、XAML 名前空間は特殊な XML 名前空間です。マークアップには XML の基本形式が使用されます。  マークアップ内で、要素に適用される `xmlns` 属性を利用して、XAML 名前空間とそのマッピングを宣言します。  内部で XAML 名前空間が宣言されている同じ要素に対して、`xmlns` 宣言を実行することができます。  要素に対して XAML 名前空間を宣言すると、その要素、その要素のすべての属性、およびその要素のすべての子要素に対してその宣言が有効になります。  属性が含まれている要素と異なる XAML 名前空間をその属性で使用できます。ただし、マークアップ内で、属性名自体からプレフィックスがその属性名の一部として参照されていることが必要です。  
+  
+ XAML 名前空間と XML 名前空間の違いについて説明します。XML 名前空間は、スキーマの参照やエンティティの単純な判別に使用されます。  XAML の場合、XAML で使用される型とメンバーは最終的にバッキング型として解決される必要がありますが、XML スキーマの概念はこの機能に該当しません。  XAML 名前空間には、XAML スキーマ コンテキストでこのような型の対応付けを実行するために必要となる情報が含まれています。  
+  
+## XAML 名前空間の構成要素  
+ XAML 名前空間の定義には、プレフィックスと識別子という 2 つの構成要素が含まれます。  マークアップ内で XAML 名前空間を宣言するとき、または XAML 型システムで XAML 名前空間を定義するときに、このような構成要素がそれぞれ表示されます。  
+  
+ プレフィックスには、[W3C による XML 1.0 名前空間の仕様](http://go.microsoft.com/fwlink/?LinkID=161735)で定められている任意の文字列を使用できます。  一般的なマークアップ ファイルではプレフィックスが頻繁に記述されるため、慣習として非常に短い文字列が使用されます。  複数の XAML 実装で使用するための XAML 名前空間では、慣習的に特定のプレフィックスが使用されます。  たとえば、XAML 言語の XAML 名前空間は一般的にプレフィックス `x` を使用して対応付けされます。  既定の XAML 名前空間を定義することもできます。既定の XAML 名前空間ではプレフィックスが定義で指定されませんが、.NET Framework XAML サービス API から定義または照会された場合は、空の文字列として表されます。  一般的に、XAML を実装するテクノロジとそのシナリオおよびボキャブラリによって、プレフィックスを省略したマークアップを最大限増やすために、意図的に既定の XAML 名前空間が選択されます。  
+  
+ 識別子には、[W3C による XML 1.0 名前空間の仕様](http://go.microsoft.com/fwlink/?LinkID=161735)で定められている任意の文字列を使用できます。  慣習として、XML 名前空間または XAML 名前空間の識別子は URI の形で \(通常はプロトコルで修飾された絶対 URI として\) 指定されるのが一般的です。  多くの場合、特定の XAML ボキャブラリを定義するバージョン情報がパス文字列の中に含まれます。  XAML 名前空間によって、XML URI の規則に加えて新しい識別子規則が追加されます。  XAML 名前空間では、XAML 名前空間で指定された型を解決したり、属性をメンバーとして解決したりするために XAML スキーマ コンテキストで必要となる情報が、識別子によって伝達されます。  
+  
+ XAML スキーマ コンテキストに情報を伝達するために、XAML 名前空間の識別子が URI の形のままになる場合があります。  ただし、この場合、この URI も特定のアセンブリまたは一連のアセンブリ内の一致する識別子として宣言されます。  アセンブリでこれを行うには、<xref:System.Windows.Markup.XmlnsDefinitionAttribute> を使用してアセンブリに属性を設定します。  属性付きのアセンブリ内で、XAML 名前空間を識別し、CLR ベースの型解決処理をサポートするこの方法は、.NET Framework XAML サービスにおける既定の XAML スキーマ コンテキストでサポートされます。  さらに一般的には、XAML スキーマ コンテキストが CLR を含んでいるか、既定の XAML スキーマ コンテキストに基づいている場合 \(CLR アセンブリから CLR 属性を読み取るために必要です\)、この規則を使用できます。  
+  
+ XAML 名前空間も、CLR 名前空間を伝達する規則と、型を定義するアセンブリによって識別できます。  この規則は、型が含まれるアセンブリに <xref:System.Windows.Markup.XmlnsDefinitionAttribute> 属性が存在しない場合に使用されます。  この規則は URI 規則よりも複雑化する可能性があります。また、アセンブリの参照方法が複数あるため、あいまいさや重複が発生する可能性があります。  
+  
+ CLR 名前空間とアセンブリ規則を使用する識別子の、最も基本的な形は、次のようになります。  
+  
+ `clr-namespace:` *clrnsName* `; assembly=` *assemblyShortName*  
+  
+ `clr-namespace:` および `; assembly=` は、この構文のリテラル要素です。  
+  
+ *clrnsName* は、CLR 名前空間を識別する文字列名です。  この文字列名の中に含まれるドット \(.\) は、CLR 名前空間に関するヒントを示し、他の CLR 名前空間との関係を表します。  
+  
+ *assemblyShortName* は、XAML で有用な型を定義するアセンブリの文字列名です。  宣言される XAML 名前空間を利用してアクセスされる型は、アセンブリによって定義され、*clrnsName* で指定された CLR 名前空間内で特別に宣言されることになります。  この文字列名は、通常、<xref:System.Reflection.AssemblyName.Name%2A?displayProperty=fullName> によって報告される情報と一致します。  
+  
+ CLR 名前空間とアセンブリ規則の詳細な定義は、次のようになります。  
+  
+ `clr-namespace:` *clrnsName* `; assembly=` *assemblyName*  
+  
+ *assemblyName* は、<xref:System.Reflection.Assembly.Load%28System.String%29?displayProperty=fullName> 入力として有効な任意の文字列を表します。  この文字列には、カルチャ、公開キー、またはバージョン情報を含めることができます \(このような概念の定義については <xref:System.Reflection.Assembly> のリファレンス トピックを参照してください\)。  COFF の形式および証拠 \(<xref:System.Reflection.Assembly.Load%2A> の他のオーバーロードで使用する場合\) は、XAML アセンブリの読み込み目的には対応しません。すべての読み込み情報は文字列として表される必要があります。  
+  
+ アセンブリに公開キーを指定することは、XAML のセキュリティを確保するために有効な手法です。また、アセンブリが簡易名によって読み込まれる場合に生じるあいまいさや、キャッシュまたはアプリケーション ドメインの既存のあいまいさを解消するためにも役立ちます。  詳細については、「[XAML Security Considerations](../../../docs/framework/xaml-services/xaml-security-considerations.md)」を参照してください。  
+  
+## XAML サービス API における XAML 名前空間宣言  
+ XAML サービス API では、XAML 名前空間宣言は <xref:System.Xaml.NamespaceDeclaration> オブジェクトによって表されます。  コード内で XAML 名前空間を宣言する場合、<xref:System.Xaml.NamespaceDeclaration.%23ctor%28System.String%2CSystem.String%29> コンストラクターを呼び出します。  `ns` パラメーターと `prefix` パラメーターは文字列として指定します。この 2 つのパラメーターの入力内容は、このトピックで既に説明した、XAML 名前空間識別子および XAML 名前空間プレフィックスの定義と対応しています。  
+  
+ XAML ノード ストリームの中で、または XAML 型システムへの他のアクセスを利用して、XAML 名前空間の情報を調べる場合、<xref:System.Xaml.NamespaceDeclaration.Namespace%2A?displayProperty=fullName> を使用すると XAML 名前空間識別子が返され、<xref:System.Xaml.NamespaceDeclaration.Prefix%2A?displayProperty=fullName> を使用すると XAML 名前空間プレフィックスが返されます。  
+  
+ XAML ノード ストリームで、XAML 名前空間の情報は、適用対象のエンティティの前にある XAML ノードとして表示される場合があります。  これは、XAML 名前空間の情報が XAML ルート要素の `StartObject` の前にある場合にも同じです。  詳細については、「[Understanding XAML Node Stream Structures and Concepts](../../../docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md)」を参照してください。  
+  
+ .NET Framework XAML サービス API が使用されるシナリオでは、多くの場合、1 つ以上の XAML 名前空間宣言が存在すると考えられます。その宣言に、XAML スキーマ コンテキストで必要な情報が含まれている、または参照されていることが必要です。  XAML 名前空間には、読み込まれるアセンブリを指定するか、読み込み済みまたは XAML スキーマ コンテキストで認識済みの名前空間とアセンブリの中で特定の型を解決するために役立つアセンブリを指定する必要があります。  
+  
+ XAML ノード ストリームを生成するためには、XAML スキーマ コンテキストによって XAML 型情報が得られることが必要です。  XAML 型情報を決定するには、作成する各ノードに対応する XAML 名前空間を先に決定する必要があります。  この時点ではまだ型のインスタンスは作成されていませんが、XAML スキーマ コンテキストでは、アセンブリの定義とバッキング型の定義から情報を参照する必要がある場合があります。  たとえば、マークアップ `<Party><PartyFavor/></Party>` を処理するには、XAML スキーマ コンテキストで `Party` の `ContentProperty` の名前と型を決定できる必要があるため、`Party` および `PartyFavor` の XAML 名前空間情報も認識されている必要があります。  既定の XAML スキーマ コンテキストの場合、ノード ストリームに XAML 型ノードを生成するために必要な XAML 型システム情報の多くが、静的リフレクションによって取得されます。  
+  
+ XAML ノード ストリームのオブジェクト グラフを生成するには、元のマークアップで使用され、XAML ノード ストリームで記録された、それぞれの XAML プレフィックスに対応する XAML 名前空間宣言が存在していることが必要です。  この時点でインスタンスが作成され、実際の型の対応付けが行われます。  
+  
+ XAML 名前空間の情報を事前に入力する必要がある場合 \(たとえば、XAML スキーマ コンテキストで使用する予定の XAML 名前空間がマークアップで定義されていない場合など\)、<xref:System.Xml.XmlReader> の <xref:System.Xml.XmlParserContext> で XML 名前空間宣言を宣言する手法を使用できます。  次に、その <xref:System.Xml.XmlReader> を XAML リーダー コンストラクター \(<xref:System.Xaml.XamlServices.Load%28System.Xml.XmlReader%29?displayProperty=fullName>\) の入力として使用します。  
+  
+ .NET Framework XAML サービスで XAML 名前空間の処理に対応する、他の 2 つの API は、<xref:System.Windows.Markup.XmlnsDefinitionAttribute> 属性および <xref:System.Windows.Markup.XmlnsPrefixAttribute> 属性です。  これらの属性はアセンブリに適用されます。  <xref:System.Windows.Markup.XmlnsDefinitionAttribute> は、XAML スキーマ コンテキストで、URI を含む XAML 名前空間宣言を解釈するために使用されます。  <xref:System.Windows.Markup.XmlnsPrefixAttribute> は、XAML を出力するツールで使用されます。これによって、特定の XAML 名前空間を予測可能なプレフィックスでシリアル化することができます。  詳細については、「[XAML\-Related CLR Attributes for Custom Types and Libraries](../../../docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md)」を参照してください。  
+  
+## 参照  
+ [Understanding XAML Node Stream Structures and Concepts](../../../docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md b/docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md
new file mode 100644
index 00000000000..a23a87c9701
--- /dev/null
+++ b/docs/framework/xaml-services/xaml-related-clr-attributes-for-custom-types-and-libraries.md
@@ -0,0 +1,280 @@
+---
+title: "XAML-Related CLR Attributes for Custom Types and Libraries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLR attributes for custom types [XAML Services]"
+ms.assetid: 5dfb299a-b6e2-41b8-8694-e6ac987547f1
+caps.latest.revision: 8
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# XAML-Related CLR Attributes for Custom Types and Libraries
+このトピックでは、.NET Framework XAML サービスによって定義される共通言語ランタイム \(CLR: Common Language Runtime\) 属性について説明します。  また、アセンブリまたは型に適用される XAML 関連のシナリオを持つ、.NET Framework で定義されるその他の CLR 属性についても説明します。  アセンブリ、型、およびメンバーに対して、このような CLR 属性を設定すると、型に関連する XAML 型システム情報が提供されます。  情報は、XAML ノード ストリームの直接処理または専用の XAML リーダーおよび XAML ライターによる処理を目的として .NET Framework XAML サービスを使用する、すべての XAML コンシューマーに提供されます。  
+  
+## カスタム型とカスタム メンバー用の XAML 関連の CLR 属性  
+ CLR 属性を使用すると、CLR 全般を使用して型を定義することになります。それ以外の場合は、CLR 属性は使用できません。  CLR を使用して型バッキングを定義した場合、.NET Framework XAML サービスの XAML ライターによって使用される既定の XAML スキーマ コンテキストは、バッキング アセンブリに対するリフレクションを介して CLR 属性を読み取ることができるようになります。  
+  
+ 以降では、カスタム型およびカスタム メンバーに適用できる XAML 関連の属性について説明します。  各 CLR 属性は、XAML 型システムに関連する情報をやり取りします。  読み込みパスでは、属性付きの情報に基づいて、XAML リーダーが有効な XAML ノード ストリームを形成する場合と、XAML ライターが有効なオブジェクト グラフを生成する場合があります。  保存パスでは、属性付きの情報に基づいて、XAML リーダーが有効な XAML ノード ストリームを形成して XAML 型システム情報を再構築する場合と、XAML ライターやその他の XAML コンシューマーに対するシリアル化のヒントおよび要件が宣言される場合があります。  
+  
+### AmbientAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.AmbientAttribute>  
+  
+ **対象:** クラス、プロパティ、またはアタッチ可能なプロパティをサポートする `get` アクセサー メンバー。  
+  
+ **引数:** なし  
+  
+ <xref:System.Windows.Markup.AmbientAttribute> は、プロパティ \(属性付き型を受け取るすべてのプロパティ\) は XAML のアンビエント プロパティの概念に基づいて解釈する必要があることを示します。  アンビエントの概念は XAML プロセッサがメンバーの型の所有者を確認する方法と関連します。  アンビエント プロパティは、オブジェクト グラフの作成時にパーサー コンテキストで値を使用できるという想定のプロパティです。ただし、XAML ノード セットを迅速に作成するために、通常の型メンバーの検索は中断されます。  
+  
+ アンビエントの概念は、CLR 属性で <xref:System.AttributeTargets> を定義する方法に関してプロパティとして表現されない、アタッチ可能なメンバーに適用できます。  メソッド属性の使用は、`get` アクセサーが XAML のアタッチ可能な使用方法をサポートするケースのみに限定する必要があります。  
+  
+### ConstructorArgumentAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.ConstructorArgumentAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 単一のコンストラクター引数と照合されるプロパティ名を指定する文字列。  
+  
+ <xref:System.Windows.Markup.ConstructorArgumentAttribute> は、既定以外のコンストラクター構文を使用してオブジェクトを初期化できることと、指定された名前のプロパティが構造情報を提供することを指定します。  この情報は、主に XAML のシリアル化に使用されます。  詳細については、「<xref:System.Windows.Markup.ConstructorArgumentAttribute>」を参照してください。  
+  
+### ContentPropertyAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.ContentPropertyAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 属性付き型のメンバー名を指定する文字列。  
+  
+ <xref:System.Windows.Markup.ContentPropertyAttribute> は、引数によって名前が指定されたプロパティはその型の XAML コンテンツ プロパティとして機能する必要があることを示します。  XAML コンテンツ プロパティ定義は、定義元の型に割り当て可能なすべての派生型に継承されます。  特定の派生型の定義を無視するには、<xref:System.Windows.Markup.ContentPropertyAttribute> を特定の派生型に適用します。  
+  
+ XAML コンテンツ プロパティとして機能するプロパティの場合、そのプロパティのプロパティ要素に対するタグ付けは XAML の使用方法では省略できます。  通常は、XAML コンテンツ プロパティを指定して、コンテンツおよびコンテインメント モデルの XAML マークアップを簡略化します。  XAML コンテンツ プロパティとして指定できるのは単一のメンバーのみに限定されるので、場合によっては、XAML コンテンツ プロパティとして指定する必要がある、型のいくつかのコンテナー プロパティの種類に関して、デザインを選択することになります。  その他のコンテナー プロパティは、明示的なプロパティ要素と共に使用する必要があります。  
+  
+ XAML ノード ストリームでは、XAML コンテンツ プロパティは <xref:System.Xaml.XamlMember> のプロパティ名に基づいて `StartMember` ノードと `EndMember` ノードを生成します。  メンバーが XAML コンテンツ プロパティであるかどうか判断するには、`StartObject` の位置から <xref:System.Xaml.XamlType> 値を調べ、<xref:System.Xaml.XamlType.ContentProperty%2A> の値を取得します。  
+  
+### ContentWrapperAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.ContentWrapperAttribute>  
+  
+ **対象:** クラス \(特にコレクション型\)。  
+  
+ **引数:** 外部コンテンツ用のコンテンツ ラッパー型として使用する型を指定する <xref:System.Type>。  
+  
+ <xref:System.Windows.Markup.ContentWrapperAttribute> は、外部コンテンツをラップするために使用される関連するコレクション型に対して 1 つ以上の型を指定します。  外部コンテンツは、コンテンツ プロパティの型に対する型システムの制約で、所有する型の XAML 使用方法でサポートされるコンテンツ ケースの一部がキャプチャされないケースを指します。  たとえば、XAML は、厳密に型指定されたジェネリック <xref:System.Collections.ObjectModel.Collection%601> で文字列をサポートする可能性がある、特定の型のコンテンツをサポートします。  コンテンツ ラッパーは、テキスト関連のコンテンツ モデルの移行など、既存のマークアップ規則を、コレクションの割り当て可能な値に関する XAML の概念に移行する場合に役立ちます。  
+  
+ 複数のコンテンツ ラッパー型を指定するには、属性を複数回適用します。  
+  
+### DependsOnAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.DependsOnAttribute>  
+  
+ **対象:** プロパティ  
+  
+ **引数:** 属性付き型の別のメンバー名を指定する文字列。  
+  
+ <xref:System.Windows.Markup.DependsOnAttribute> は、属性付きプロパティが別のプロパティの値に依存することを示します。  この属性をプロパティ定義に適用すると、依存プロパティは XAML オブジェクトの記述で最初に処理されます。  <xref:System.Windows.Markup.DependsOnAttribute> の使用により、例外的なケースを指定して、有効なオブジェクトを作成するために特定の順序で解析を行う必要がある型のプロパティに対応します。  
+  
+ プロパティ定義に対して複数の <xref:System.Windows.Markup.DependsOnAttribute> ケースを適用できます。  
+  
+### MarkupExtensionReturnTypeAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.MarkupExtensionReturnTypeAttribute>  
+  
+ **対象:** <xref:System.Windows.Markup.MarkupExtension> 派生型であると想定されるクラス。  
+  
+ **引数:** 属性付きの <xref:System.Windows.Markup.MarkupExtension> の `ProvideValue` の結果として想定される最も精密な型を指定する <xref:System.Type>。  
+  
+ 詳細については、「[Markup Extensions for XAML Overview](../../../docs/framework/xaml-services/markup-extensions-for-xaml-overview.md)」を参照してください。  
+  
+### NameScopePropertyAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.NameScopePropertyAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 次の 2 つの形式の属性をサポートします。  
+  
+-   属性付き型のプロパティ名を指定する文字列  
+  
+-   プロパティ名を指定する文字列、および名前付きプロパティを定義する型の <xref:System.Type> この形式では、XAML 名前スコープ プロパティとしてアタッチ可能なメンバーを指定します。  
+  
+ <xref:System.Windows.Markup.NameScopePropertyAttribute> は、属性付きクラスに XAML 名前スコープの値を提供するプロパティを指定します。  XAML 名前スコープのプロパティは、<xref:System.Windows.Markup.INameScope> を実装し、実際の XAML 名前スコープ、そのストア、およびその動作を保持するオブジェクトを参照すると想定されます。  
+  
+### RuntimeNamePropertyAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.RuntimeNamePropertyAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 属性付き型のランタイム名のプロパティ名を指定する文字列。  
+  
+ <xref:System.Windows.Markup.RuntimeNamePropertyAttribute> は、XAML の [x:Name Directive](../../../docs/framework/xaml-services/x-name-directive.md) にマップされる属性付き型のプロパティを報告します。  このプロパティは <xref:System.String> 型であると同時に、読み書き可能である必要があります。  
+  
+ この定義は、定義元の型に割り当て可能なすべての派生型に継承されます。  特定の派生型の定義を無視するには、<xref:System.Windows.Markup.RuntimeNamePropertyAttribute> を特定の派生型に適用します。  
+  
+### TrimSurroundingWhitespaceAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute>  
+  
+ **対象:** 型  
+  
+ **引数:** なし。  
+  
+ <xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute> は、空白が意味を持つコンテンツ \(<xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute> を含むコレクションによって保持されるコンテンツ\) 内で子要素として表される可能性がある特定の型に適用されます。  <xref:System.Windows.Markup.TrimSurroundingWhitespaceAttribute> は主に保存パスに関連しますが、<xref:System.Xaml.XamlType.TrimSurroundingWhitespace%2A?displayProperty=fullName> を調べることで、読み込みパスの XAML 型システムでも使用できます。  詳細については、「[Whitespace Processing in XAML](../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)」を参照してください。  
+  
+### TypeConverterAttribute  
+ **リファレンス ドキュメント:**  <xref:System.ComponentModel.TypeConverterAttribute>  
+  
+ **対象:** クラス、プロパティ、メソッド \(XAML 対応の唯一のメソッド ケースは、アタッチ可能なメンバーをサポートする `get` アクセサー\)。  
+  
+ **引数:** <xref:System.ComponentModel.TypeConverter> の <xref:System.Type>。  
+  
+ XAML コンテキストの <xref:System.ComponentModel.TypeConverterAttribute> は、カスタム <xref:System.ComponentModel.TypeConverter> を参照します。  この <xref:System.ComponentModel.TypeConverter> は、カスタム型 \(その型のメンバー\) の型変換動作を提供します。  
+  
+ 型コンバーターの実装を参照し、<xref:System.ComponentModel.TypeConverterAttribute> 属性を型に適用します。  クラス、構造体、およびインターフェイスに対して、XAML の型コンバーターを定義できます。  列挙体に対しては、型変換がネイティブで有効になっているため、型変換を提供する必要はありません。  
+  
+ 型コンバーターは、マークアップで属性または初期化テキストに使用される文字列を目的の型に変換できる必要があります。  詳細については、「[TypeConverters および XAML](../../../docs/framework/wpf/advanced/typeconverters-and-xaml.md)」を参照してください。  
+  
+ XAML の型コンバーターの動作は、型のすべての値を適用する代わりに、特定のプロパティを対象にすることもできます。  このケースでは、<xref:System.ComponentModel.TypeConverterAttribute> をプロパティ定義 \(特定の `get` および `set` 定義以外の定義\) に適用します。  
+  
+ アタッチ可能なカスタム メンバーの XAML の使用に対応する型コンバーターの動作を割り当てるには、XAML の使用をサポートする `get` メソッド アクセサーに <xref:System.ComponentModel.TypeConverterAttribute> を割り当てます。  
+  
+ <xref:System.ComponentModel.TypeConverter> と同様に、<xref:System.ComponentModel.TypeConverterAttribute> は XAML よりも前に .NET Framework に存在しており、型コンバーター モデルはその他の目的に対応していました。  <xref:System.ComponentModel.TypeConverterAttribute> を参照して使用するには、完全修飾するか、<xref:System.ComponentModel> に `using` ステートメントを指定します。  システム アセンブリをプロジェクトに含める必要もあります。  
+  
+### UidPropertyAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.UidPropertyAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 関連プロパティを名前で参照する文字列。  
+  
+ [x:Uid Directive](../../../docs/framework/xaml-services/x-uid-directive.md) をエイリアス化するクラスの CLR プロパティを示します。  
+  
+### UsableDuringInitializationAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.UsableDuringInitializationAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** ブール値。  属性の用途で使用する場合、常に `true` として指定する必要があります。  
+  
+ XAML のオブジェクト グラフの作成中にこの型がトップダウンで構築されるかどうかを示します。  これは高度な概念であり、実際のプログラミング モデルの定義に密接に関連していると考えられます。  詳細については、「<xref:System.Windows.Markup.UsableDuringInitializationAttribute>」を参照してください。  
+  
+### ValueSerializerAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.ValueSerializerAttribute>  
+  
+ **対象:** クラス、プロパティ、メソッド \(XAML 対応の唯一のメソッド ケースは、アタッチ可能なメンバーをサポートする `get` アクセサー\)。  
+  
+ **引数:** 属性付き型のプロパティ \(特定の属性付きプロパティ\) をすべてシリアル化する場合に使用する値のシリアライザーのサポート クラスを指定する <xref:System.Type>。  
+  
+ <xref:System.Windows.Markup.ValueSerializer> は、<xref:System.ComponentModel.TypeConverter> よりも状態とコンテキストを必要とする値のシリアル化クラスを指定します。  アタッチ可能なメンバーの静的な `get` アクセサー メソッド上で <xref:System.Windows.Markup.ValueSerializerAttribute> 属性を適用することにより、アタッチ可能なメンバーに <xref:System.Windows.Markup.ValueSerializer> を関連付けることができます。  値のシリアル化は、列挙体、インターフェイス、および構造体に対しても適用できますが、デリゲートには適用できません。  
+  
+### WhitespaceSignificantCollectionAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute>  
+  
+ **対象:** クラス \(特に、オブジェクト要素周辺の空白が UI 表現で意味を持つ、混合コンテンツをホストする想定のコレクション型\)  
+  
+ **引数:** なし。  
+  
+ <xref:System.Windows.Markup.WhitespaceSignificantCollectionAttribute> は、コレクション内で XAML ノード ストリームの値ノードの作成に影響を及ぼすため、XAML プロセッサで空白が意味を持つものとしてコレクション型を処理する必要があることを示します。  詳細については、「[Whitespace Processing in XAML](../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)」を参照してください。  
+  
+### XamlDeferLoadAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XamlDeferLoadAttribute>  
+  
+ **対象:** クラス、プロパティ。  
+  
+ **引数:** 文字列として 2 つの属性フォーム型、または <xref:System.Type> の型をサポートします。  「<xref:System.Windows.Markup.XamlDeferLoadAttribute>」を参照してください。  
+  
+ クラスまたはプロパティに XAML の遅延読み込みの使用 \(テンプレート動作など\) が含まれていることを示し、遅延動作を有効にするクラスと、その宛先\/コンテンツ タイプを報告します。  
+  
+### XamlSetMarkupExtensionAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XamlSetMarkupExtensionAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** コールバックの名前を指定します。  
+  
+ クラスでマークアップ拡張機能を使用して 1 つ以上のプロパティの値を指定できることを示すと同時に、クラスの任意のプロパティに対してマークアップ拡張機能のセット操作を実行する前に XAML ライターから呼び出す必要のあるハンドラーを参照します。  
+  
+### XamlSetTypeConverterAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XamlSetTypeConverterAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** コールバックの名前を指定します。  
+  
+ クラスで型コンバーターを使用して 1 つ以上のプロパティの値を指定できることを示すと同時に、クラスの任意のプロパティに対して型コンバーターのセット操作を実行する前に XAML ライターから呼び出す必要のあるハンドラーを参照します。  
+  
+### XmlLangPropertyAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XmlLangPropertyAttribute>  
+  
+ **対象:** クラス  
+  
+ **引数:** 属性付き型の `xml:lang` にエイリアス化するプロパティ名を指定する文字列。  
+  
+ <xref:System.Windows.Markup.XmlLangPropertyAttribute> は、XML の `lang` ディレクティブにマッピングされる属性付き型のプロパティを報告します。  このプロパティは必ずしも <xref:System.String> 型である必要はありませんが、文字列からの割り当て \(具体的には、プロパティの型または特定のプロパティと型コンバーターの関連付け\) に対応する必要があります。  このプロパティは読み取り\/書き込み可能である必要があります。  
+  
+ `xml:lang` のマッピングに対応するシナリオでは、特に XMLDOM による処理を必要とせずに、ランタイム オブジェクト モデルが XML 固有の言語情報にアクセスできます。  
+  
+ この定義は、定義元の型に割り当て可能なすべての派生型に継承されます。  特定の派生型の定義を無視するには、<xref:System.Windows.Markup.XmlLangPropertyAttribute> を特定の派生型に適用します。ただし、これは一般的なシナリオではありません。  
+  
+## アセンブリ レベルでの XAML 関連の CLR 属性  
+ 以降では、型やメンバー定義に適用されずにアセンブリに適用される XAML 関連の属性について説明します。  各属性の全体としての目的は、XAML で使用するカスタム型を含むライブラリを定義することです。  一部の属性は XAML ノード ストリームに直接影響を及ぼすわけではありませんが、使用するその他のコンシューマー用にノード ストリームで受け渡されます。  情報のコンシューマーとしては、XAML 名前空間の情報および関連付けられたプレフィックス情報を必要とする、デザイン環境やシリアル化処理が挙げられます。  XAML スキーマ コンテキスト \(既定の .NET Framework XAML サービスを含む\) も、この情報を使用します。  
+  
+### XmlnsCompatibleWithAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XmlnsCompatibleWithAttribute>  
+  
+ **引数:**  
+  
+-   包含する XAML 名前空間の識別子を指定する文字列。  
+  
+-   前の引数から XAML 名前空間を包含できる XAML 名前空間の識別子を指定する文字列。  
+  
+ <xref:System.Windows.Markup.XmlnsCompatibleWithAttribute> は、XAML 名前空間を別の XAML 名前空間で包含できることを指定します。  通常、XAML 名前空間の包含は、あらかじめ定義した <xref:System.Windows.Markup.XmlnsDefinitionAttribute> で示されます。  この方法は、ライブラリ内の XAML の語彙のバージョン管理を目的として使用され、以前のバージョンの語彙に対してあらかじめ定義したマークアップとの互換性を確保します。  
+  
+### XmlnsDefinitionAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XmlnsDefinitionAttribute>  
+  
+ **引数:**  
+  
+-   定義する XAML 名前空間の識別子を指定する文字列。  
+  
+-   CLR 名前空間の名前を付ける文字列。  CLR 名前空間がアセンブリのパブリック型を定義し、CLR 名前空間の型のうち少なくとも 1 つが XAML の使用方法で対象になる必要があります。  
+  
+ <xref:System.Windows.Markup.XmlnsDefinitionAttribute> は、XAML 名前空間と CLR 名前空間の間のアセンブリごとのマッピングを指定します。これは、XAML オブジェクト ライターまたは XAML スキーマ コンテキストによる型解決に使用されます。  
+  
+ アセンブリに対して、複数の <xref:System.Windows.Markup.XmlnsDefinitionAttribute> を適用できます。  この方法は、次の理由のいずれか、または組み合わせに基づいて使用されます。  
+  
+-   ランタイム API アクセスの論理構成に対応する複数の CLR 名前空間がライブラリ デザインに含まれるが、同じ XAML 名前空間を参照して各名前空間のすべての型を XAML で使用可能にする必要がある。  このケースでは、<xref:System.Windows.Markup.XmlnsDefinitionAttribute.XmlNamespace%2A> 値は同じで <xref:System.Windows.Markup.XmlnsDefinitionAttribute.ClrNamespace%2A> 値は異なる複数の <xref:System.Windows.Markup.XmlnsDefinitionAttribute> 属性を適用します。  XAML 名前空間のマッピングを定義するときに、一般的な使用方法でフレームワークまたはアプリケーションが既定の XAML 名前空間になる想定である場合、この方法が役立ちます。  
+  
+-   複数の CLR 名前空間がライブラリ デザインに含まれ、各 CLR 名前空間での型の使用方法に応じて意図的に XAML 名前空間を分離する必要がある。  
+  
+-   アセンブリで CLR 名前空間を定義して、複数の XAML 名前空間からのアクセスを可能にする必要がある。  同じコードベースで複数の語彙をサポートしている場合に、このような必要性が生じます。  
+  
+-   1 つ以上の CLR 名前空間で XAML 言語サポートを定義する。  これらについては、<xref:System.Windows.Markup.XmlnsDefinitionAttribute.XmlNamespace%2A> 値に `http://schemas.microsoft.com/winfx/2006/xaml` を指定する必要があります。  
+  
+### XmlnsPrefixAttribute  
+ **リファレンス ドキュメント:**  <xref:System.Windows.Markup.XmlnsPrefixAttribute>  
+  
+ **引数:**  
+  
+-   XAML 名前空間の識別子を指定する文字列。  
+  
+-   推奨プレフィックスを指定する文字列。  
+  
+ <xref:System.Windows.Markup.XmlnsDefinitionAttribute> は、XAML 名前空間に使用する推奨プレフィックスを指定します。  .NET Framework XAML サービスの <xref:System.Xaml.XamlXmlWriter> によってシリアル化される XAML ファイルに要素および属性を書き込む場合や、XAML 実装ライブラリが XAML の編集機能を備えたデザイン環境とやり取りする場合に、このプレフィックスが役立ちます。  
+  
+ アセンブリに対して、複数の <xref:System.Windows.Markup.XmlnsPrefixAttribute> を適用できます。  この方法は、次の理由のいずれか、または組み合わせに基づいて使用されます。  
+  
+-   アセンブリで複数の XAML 名前空間の型を定義する。  このケースでは、XAML 名前空間ごとに異なるプレフィックス値を定義する必要があります。  
+  
+-   複数の語彙をサポートしている状況で、語彙および XAML 名前空間ごとに異なるプレフィックスを使用する。  
+  
+-   アセンブリで XAML 言語サポートを定義し、<xref:System.Windows.Markup.XmlnsDefinitionAttribute> に `http://schemas.microsoft.com/winfx/2006/xaml` を指定する。  このケースでは通常、プレフィックス `x` を昇格させる必要があります。  
+  
+> [!NOTE]
+>  .NET Framework XAML サービスでは、XAML 関連の属性 <xref:System.Windows.Markup.RootNamespaceAttribute> も定義します。  これは、プロジェクト システム サポート用のアセンブリ レベルの属性であり、XAML のカスタム型には関連しません。  
+  
+## 参照  
+ <xref:System.Attribute>   
+ [Defining Custom Types for Use with .NET Framework XAML Services](../../../docs/framework/xaml-services/defining-custom-types-for-use-with-net-framework-xaml-services.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xaml-security-considerations.md b/docs/framework/xaml-services/xaml-security-considerations.md
new file mode 100644
index 00000000000..25b3cf8ae5d
--- /dev/null
+++ b/docs/framework/xaml-services/xaml-security-considerations.md
@@ -0,0 +1,52 @@
+---
+title: "XAML Security Considerations | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "security [XAML Services], .NET XAML services"
+  - "XAML security [XAML Services]"
+ms.assetid: 544296d4-f38e-4498-af49-c9f4dad28964
+caps.latest.revision: 7
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# XAML Security Considerations
+このトピックでは、XAML および .NET Framework XAML サービス API を使用するときの、アプリケーションのセキュリティのベスト プラクティスについて説明します。  
+  
+## アプリケーションの信頼されていない XAML  
+ 最も一般的な意味では、信頼されていない XAML とは、アプリケーションで明確に含めたり生成したりしていない XAML ソースを指します。  
+  
+ 信頼された署名済みアセンブリ内に `resx` 型のリソースとしてコンパイルまたは格納されている XAML は、本質的には信頼されていない XAML ではありません。  XAML は、アセンブリ全体と同程度に信頼することができます。  ほとんどの場合は、Loose XAML の信頼の側面のみを考慮します。Loose XAML とは、ストリームやその他の IO から読み込む XAML ソースのことです。  Loose XAML は、配置およびパッケージング インフラストラクチャを持つアプリケーション モデルの特定のコンポーネントや機能ではありません。  ただし、アセンブリは Loose XAML の読み込みを伴う動作を実装することがあります。  
+  
+ 信頼されていない XAML は、一般的には、信頼されていないコードと同じように扱う必要があります。  信頼されていない可能性がある XAML が、信頼されているコードにアクセスしないよう、サンドボックス化またはその他の比喩を使用します。  
+  
+ XAML 機能は、性質上、オブジェクトを構築し、プロパティを設定する権利を XAML に与えます。  これらの機能には、型コンバーターへのアクセス、アプリケーション ドメインのアセンブリのマッピングとアクセス、マークアップ拡張機能の使用、`x:Code` ブロックなども含まれます。  
+  
+ 言語レベルの機能に加えて、XAML は、さまざまな技術の UI の定義で使用されています。  信頼されていない XAML を読み込むと、悪意のあるなりすまし UI を読み込む可能性もあります。  
+  
+## リーダーおよびライターによるコンテキストの共有  
+ XAML リーダーおよび XAML ライターの .NET Framework XAML サービス アーキテクチャでは、XAML ライターまたは XAML スキーマ コンテキストに XAML リーダーを共有する必要があります。  XAML ノード ループ ロジックを記述している場合、またはカスタム保存パスを指定する場合には、オブジェクトまたはコンテキストの共有が必要になることがあります。  信頼されているコードと信頼されていないコードの間で、XAML リーダー インスタンス、既定以外の XAML スキーマ コンテキスト、または XAML リーダー\/XAML ライター クラスの設定を共有しないでください。  
+  
+ CLR ベースの型バッキング向けの、XAML オブジェクトの記述を伴う大半のシナリオおよび操作では、既定の XAML スキーマ コンテキストのみを使用できます。  既定の XAML スキーマ コンテキストには、完全な信頼を損なう可能性がある設定は明示的には含まれていません。  そのため、信頼されている XAML リーダー\/ライター コンポーネントと、信頼されていない XAML リーダー\/ライター コンポーネントの間でコンテキストを共有しても安全です。  ただし、そうする場合は、そのようなリーダーとライターを個別の <xref:System.AppDomain> スコープに保持しておき、いずれか 1 つを部分信頼用に指定\/サンドボックス化することをお勧めします。  
+  
+## XAML 名前空間およびアセンブリの信頼  
+ XAML がアセンブリに対するカスタム XAML 名前空間マッピングをどのように解釈するかについての基本的な非修飾構文および定義では、アプリケーション ドメインに読み込まれた、信頼されたアセンブリと信頼されていないアセンブリを区別しません。  そのため、理論的には、信頼されていないアセンブリが信頼されているアセンブリが目的とする XAML 名前空間マッピングになりすまし、XAML ソースの宣言されたオブジェクトおよびプロパティ情報をキャプチャすることはできます。  この状況を回避するためのセキュリティ要件がある場合は、目的の XAML 名前空間マッピングは、次のいずれかの方法によって行われる必要があります。  
+  
+-   アプリケーションの XAML によって作成されたすべての XAML 名前空間マッピングで、厳密な名前を持つ完全修飾アセンブリ名を使用する。  
+  
+-   XAML リーダーおよび XAML オブジェクト ライターに対して特定の <xref:System.Xaml.XamlSchemaContext> を構築し、アセンブリ マッピングを参照アセンブリの固定セットに制限する。  「<xref:System.Xaml.XamlSchemaContext.%23ctor%28System.Collections.Generic.IEnumerable%7BSystem.Reflection.Assembly%7D%29>」を参照してください。  
+  
+## XAML 型マッピングと型システム アクセス  
+ XAML は独自の型システムをサポートしています。この型システムは、CLR が基本的な CLR 型システムを実装する方法と、多くの点で似ています。  ただし、型情報に基づいて型に関する信頼の決定を下すという、型対応の一部の側面では、CLR バッキング型の型情報に従う必要があります。  これは、XAML 型システム固有の一部のレポート機能は仮想メソッドとして開いたままになるため、元の .NET Framework XAML サービス実装の完全な制御下にはないためです。  これらの機能拡張ポイントが存在するのは、既定の CLR バッキング実装および既定の XAML スキーマ コンテキストに比べ、XAML 型システムには XAML 自体の拡張性と、使用できる型マッピング戦略に対応するだけの拡張性があるためです。  詳細については、<xref:System.Xaml.XamlType> および <xref:System.Xaml.XamlMember> のいくつかのプロパティに関するメモを参照してください。  
+  
+## 参照  
+ <xref:System.Xaml.Permissions.XamlAccessLevel>
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xamlname-grammar.md b/docs/framework/xaml-services/xamlname-grammar.md
new file mode 100644
index 00000000000..9e4953e42d5
--- /dev/null
+++ b/docs/framework/xaml-services/xamlname-grammar.md
@@ -0,0 +1,76 @@
+---
+title: "XamlName の文法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DottedXamlName の文法 [XAML サービス]"
+  - "文法 [XAML サービス]、DottedXamlName"
+  - "文法 [XAML サービス]、XamlName"
+  - "XAML の名前 [XAML サービス]"
+  - "XamlName の文法 [XAML サービス]"
+ms.assetid: 11e4cada-41d2-494d-9531-0d3df4dfcbe3
+caps.latest.revision: 13
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# XamlName の文法
+XamlName の文法は、XAML 言語仕様 \[MS\-XAML\] で定義された固有の文法であり、ここでは便宜上、再掲しています。  
+  
+## XAML 仕様  
+ \[MS\-XAML\] 仕様では、型とプロパティに使用される正式なシンボル識別子のセットを識別するために、文法 XamlName が定義されています。  
+  
+ XamlName 型の文字列値は、次の文法に準拠している必要があります。  
+  
+```  
+XamlName ::= NameStartChar ( NameChar )*   
+NameStartChar ::= LetterCharacter | '_'   
+NameChar ::= NameStartChar | DecimalDigit | CombiningCharacter   
+LetterCharacter ::= UnicodeLu | UnicodeLl | UnicodeLo | UnicodeLt | UnicodeNl   
+DecimalDigit ::= UnicodeNd   
+CombiningCharacter ::= UnicodeMn | UnicodeMc  
+  
+```  
+  
+ ここでは、Unicode 文字データベースで定義されている次の一般的なカテゴリ値を想定しています。  
+  
+```  
+  
+Lu  
+Letter, Uppercase  
+Ll  
+Letter, Lowercase  
+Lt  
+Letter, Titlecase  
+Lm  
+Letter, Modifier  
+Lo  
+Letter, Other  
+Mn  
+Mark, Non-Spacing  
+Mc  
+Mark, Spacing Combining  
+Nd  
+Number, Decimal  
+Nl  
+Number, Letter  
+```  
+  
+ XAML では、プロパティとイベントで修飾される参照、およびアタッチされたメンバーで使用される、第 2 の文法 DottedXamlName が定義されています。  詳細については、「<xref:System.Windows.DependencyProperty>」および「[XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)」を参照してください。  
+  
+ DottedXamlName 型の文字列値は、次の文法に準拠している必要があります。  
+  
+```  
+DottedXamlName ::= XamlName '.' XamlName  
+```  
+  
+## 解説  
+ 詳細な仕様については、「[\[MS\-XAML\]](http://go.microsoft.com/fwlink/?LinkId=114525)」を参照してください。
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xamlservices-class-and-basic-xaml-reading-or-writing.md b/docs/framework/xaml-services/xamlservices-class-and-basic-xaml-reading-or-writing.md
new file mode 100644
index 00000000000..58c8c6c9359
--- /dev/null
+++ b/docs/framework/xaml-services/xamlservices-class-and-basic-xaml-reading-or-writing.md
@@ -0,0 +1,74 @@
+---
+title: "XAMLServices Class and Basic XAML Reading or Writing | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], XamlServices class"
+  - "XamlServices class [XAML Services], how to use"
+ms.assetid: 6ac27fad-3687-4d7a-add1-3e90675fdfde
+caps.latest.revision: 11
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# XAMLServices Class and Basic XAML Reading or Writing
+<xref:System.Xaml.XamlServices> は、XAML ノード ストリーム、またはこれらのノードから取得された XAML 型システム情報への固有のアクセスを必要としない XAML シナリオに対応するために使用できる、.NET Framework XAML サービスによって提供されるクラスです。 要約すると、<xref:System.Xaml.XamlServices> API は次のように説明できます。`Load` または `Parse` で XAML 読み込みパスをサポートし、`Save` で XAML 保存パスをサポートし、`Transform` で読み込みパスと保存パスを連結する方法を指定します。`Transform` は、XAML スキーマを別の XAML スキーマに変更するために使用できます。 このトピックでは、それぞれの API 分類について要約し、特定のメソッド オーバーロード間の相違点について説明します。  
+  
+<a name="load"></a>   
+## 読み込み  
+ <xref:System.Xaml.XamlServices.Load%2A> のさまざまなオーバーロードは、読み込みパスのロジック全体を実装しています。 読み込みパスは、ある形式の XAML を使用して XAML ノード ストリームを出力します。 これらの読み込みパスのほとんどは、エンコードされた XML テキスト ファイル形式で XAML を使用します。 ただし、一般的なストリームを読み込むことも、異なる <xref:System.Xaml.XamlReader> 実装に既に含まれているプリロード済みの XAML ソースを読み込むこともできます。  
+  
+ ほとんどのシナリオにおいて最もシンプルなオーバーロードは、<xref:System.Xaml.XamlServices.Load%28System.String%29> です。 このオーバーロードには、読み込まれる XAML を含むテキスト ファイル名を表す `fileName` パラメーターがあります。 これは、以前にローカル コンピューターに対してシリアル化された状態またはデータを持つ、完全信頼アプリケーションなどのアプリケーション シナリオに適しています。 また、アプリケーション モデル \(フレームワーク\) を定義している場合に、アプリケーションの動作、開始 UI、またはフレームワークによって定義された XAML を使用するその他の機能を定義した標準ファイルの 1 つを読み込む場合にも便利です。  
+  
+ <xref:System.Xaml.XamlServices.Load%28System.IO.Stream%29> にも、類似したシナリオがあります。<xref:System.IO.Stream> はファイル システムにアクセスできるその他の <xref:System.IO> API の出力として頻繁に使用されるため、読み込むファイルをユーザーが選択できるようにする場合は、このオーバーロードが便利です。 または、非同期ダウンロードや、ストリームを生成するその他のネットワーク技術を使用して XAML ソースにアクセスすることもできます。 \(ストリームまたはユーザーが選択したソースからの読み込みは、セキュリティに影響が出ることがあります。 詳しくは、「[XAML Security Considerations](../../../docs/framework/xaml-services/xaml-security-considerations.md)」をご覧ください。\)  
+  
+ <xref:System.Xaml.XamlServices.Load%28System.IO.TextReader%29> と <xref:System.Xaml.XamlServices.Load%28System.Xml.XmlReader%29> は、.NET Framework の前のバージョンの形式のリーダーに依存するオーバーロードです。 これらのオーバーロードを使用するには、あらかじめリーダー インスタンスを作成し、その `Create` API を使用して XAML を関連形式 \(テキストまたは XML\) に読み込む必要があります。 レコード ポインターを他のリーダーに既に移動したり、またはレコード ポインターを使用して他の操作を実行したりした場合でも、そのことは問題になりません。<xref:System.Xaml.XamlServices.Load%2A> からの読み込みパス ロジックは、常にルート以下の XAML 入力全体を処理します。 これらのオーバーロードのシナリオには、次のものがあります。  
+  
+-   既存の XML 用テキスト エディターを利用してシンプルな XAML 編集機能を提供するデザイン サーフェイス。  
+  
+-   専用のリーダーを使用してファイルまたはストリームを開く、コア <xref:System.IO> の派生シナリオ。 XAML として読み込む前に、コンテンツの基本的なチェックや処理をロジックで実行します。  
+  
+ ファイルまたはストリームを読み込むか、XAML 入力をラップした <xref:System.Xml.XmlReader>、<xref:System.IO.TextReader>、または <xref:System.Xaml.XamlReader> を \(そのリーダーの API を使用して読み込むことにより\) 読み込むことができます。  
+  
+ 内部的には、上に示した各オーバーロードは最終的に <xref:System.Xaml.XamlServices.Load%28System.Xml.XmlReader%29> になり、渡された <xref:System.Xml.XmlReader> は新しい <xref:System.Xaml.XamlXmlReader> を作成するために使用されます。  
+  
+ より高度なシナリオを提供する `Load` シグネチャは <xref:System.Xaml.XamlServices.Load%28System.Xaml.XamlReader%29> です。 このシグネチャは、次のいずれかのケースで使用できます。  
+  
+-   <xref:System.Xaml.XamlReader> の独自の実装を定義した場合。  
+  
+-   既定の設定とは異なる設定を <xref:System.Xaml.XamlReader> に指定する必要がある場合。  
+  
+ 既定以外の設定は、たとえば次のものに対する設定です: <xref:System.Xaml.XamlReaderSettings.AllowProtectedMembersOnRoot%2A>、<xref:System.Xaml.XamlReaderSettings.BaseUri%2A>、<xref:System.Xaml.XamlReaderSettings.IgnoreUidsOnPropertyElements%2A>、<xref:System.Xaml.XamlReaderSettings.LocalAssembly%2A>、<xref:System.Xaml.XamlReaderSettings.ValuesMustBeString%2A>。<xref:System.Xaml.XamlServices> の既定のリーダーは <xref:System.Xaml.XamlXmlReader> です。 独自の <xref:System.Xaml.XamlXmlReader> を提供する場合の設定では、次のプロパティが既定値以外に設定されます: <xref:System.Xaml.XamlXmlReaderSettings>、<xref:System.Xaml.XamlXmlReaderSettings.CloseInput%2A>、<xref:System.Xaml.XamlXmlReaderSettings.SkipXmlCompatibilityProcessing%2A>、<xref:System.Xaml.XamlXmlReaderSettings.XmlLang%2A>、<xref:System.Xaml.XamlXmlReaderSettings.XmlSpacePreserve%2A>。  
+  
+<a name="parse"></a>   
+## Parse  
+ <xref:System.Xaml.XamlServices.Parse%2A> は、XAML 入力から XAML ノード ストリームを作成する読み込みパス API であるため、`Load` に似ています。 ただし、この場合の XAML 入力は、読み込まれる XAML 全体を含む文字列として直接指定されます。<xref:System.Xaml.XamlServices.Parse%2A> は軽量のアプローチであり、フレームワーク シナリオよりもアプリケーション シナリオにより適しています 詳細については、「<xref:System.Xaml.XamlServices.Parse%2A>」を参照してください。 実際には、<xref:System.Xaml.XamlServices.Parse%2A> はラップされた <xref:System.Xaml.XamlServices.Load%28System.Xml.XmlReader%29> 呼び出しで、内部では <xref:System.IO.StringReader> を使用します。  
+  
+<a name="save"></a>   
+## 保存  
+ <xref:System.Xaml.XamlServices.Save%2A> のさまざまなオーバーロードは、保存パスを実装しています。 どの <xref:System.Xaml.XamlServices.Save%2A> メソッドもオブジェクト グラフを入力として取り、ストリーム、ファイル、または <xref:System.Xml.XmlWriter>\/<xref:System.IO.TextWriter> インスタンスとして出力を生成します。  
+  
+ 入力オブジェクトは、何らかのオブジェクト表現のルート オブジェクトであると想定されます。 ビジネス オブジェクトの単一ルート、UI シナリオでのページのオブジェクト ツリーのルート、デザイン ツールの作業用の編集サーフェイス、またはシナリオに適したその他のルート オブジェクト概念などが考えられます。  
+  
+ 多くのシナリオでは、保存されるオブジェクト ツリーは、<xref:System.Xaml.XamlServices.Load%2A> またはフレームワーク\/アプリケーション モデルによって実装されたその他の API で XAML をロードした元の操作に関連しています。 状態の変更、アプリケーションがユーザーからキャプチャしたランタイム設定の変更、アプリケーションが XAML デザイン サーフェイスであるために発生する XAML の変更などにより、キャプチャされるオブジェクト ツリーに相違が生じることもあります。変更の有無にかかわらず、まずマークアップから XAML を読み込んで再保存し、2 つの XAML マークアップ フォームを比較するという概念は、XAML のラウンド トリップ表現と呼ばれることがあります。  
+  
+ マークアップ形式で設定された複合オブジェクトの保存とシリアル化に伴う課題は、完全な表現によって情報を失われないようにすることと、XAML が詳細すぎてユーザーが判読しにくい状態になることとの間のバランスを取ることです。 さらに、XAML を使用する顧客が異なれば、このバランスをどのように取るかの定義や要求も異なることがあります<xref:System.Xaml.XamlServices.Save%2A> API は、このバランスの定義の 1 つを表します。<xref:System.Xaml.XamlServices.Save%2A> は、使用できる XAML スキーマ コンテキストと、<xref:System.Xaml.XamlType>、<xref:System.Xaml.XamlMember> の既定の CLR ベースの特性、およびその他の組み込み XAML と XAML 型システムの概念を使用し、ある XAML ノード ストリーム構造をマークアップに再保存するときに、どこで最適化するかを決定します。 たとえば、<xref:System.Xaml.XamlServices> の保存パスでは、CLR ベースの既定の XAML スキーマ コンテキストを使用してオブジェクトの <xref:System.Xaml.XamlType> を解決し、<xref:System.Xaml.XamlType.ContentProperty%2A?displayProperty=fullName> を決定したうえで、このオブジェクトの XAML コンテンツにプロパティを記述するときにプロパティ要素タグを省略できます。  
+  
+<a name="transform"></a>   
+## 変換  
+ <xref:System.Xaml.XamlServices.Transform%2A> は、読み込みパスと保存パスを単一の操作としてリンクすることによって、XAML を変換します。<xref:System.Xaml.XamlReader> および <xref:System.Xaml.XamlWriter> に対して異なるスキーマ コンテキストまたは異なるバッキング型システムを使用できます。これは、結果として生成される XAML がどのように変換されるかに影響します。 これは、さまざまな変換操作で機能します。  
+  
+ XAML ノード ストリームの各ノードの確認に依存する操作については、通常、<xref:System.Xaml.XamlServices.Transform%2A> は使用しません。 代わりに、読み込みパスから保存パスへの一連の操作を独自に定義し、独自のロジックを挿入する必要があります。 たとえば、独自のノード ループの中で XAML リーダーと XAML ライターのペアを使用します。 具体的に言うと、<xref:System.Xaml.XamlXmlReader> を使用して最初の XAML を読み込み、<xref:System.Xaml.XamlXmlReader.Read%2A> を連続的に呼び出してノードにステップ インします。 XAML ノード ストリーム レベルの操作では、個々のノード \(型、メンバー、その他のノード\) を調整して変換を適用するか、ノードをそのままにしておくことができます。 その後、ノードを <xref:System.Xaml.XamlObjectWriter> の関連する `Write` API に送り、オブジェクトを書き込みます。 詳細については、「[Understanding XAML Node Stream Structures and Concepts](../../../docs/framework/xaml-services/understanding-xaml-node-stream-structures-and-concepts.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xaml.XamlObjectWriter>   
+ <xref:System.Xaml.XamlServices>   
+ [XAML Services](../../../docs/framework/xaml-services/index.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xml-lang-handling-in-xaml.md b/docs/framework/xaml-services/xml-lang-handling-in-xaml.md
new file mode 100644
index 00000000000..933233c31b5
--- /dev/null
+++ b/docs/framework/xaml-services/xml-lang-handling-in-xaml.md
@@ -0,0 +1,54 @@
+---
+title: "xml:lang Handling in XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], xml:lang attribute"
+  - "xml:lang attribute [XAML Services]"
+  - "RFC 3066 standard [XAML Services]"
+  - "standards [XAML Services], RFC 3066"
+ms.assetid: 7aac0078-a1c5-41f8-b8b0-975510d9dca0
+caps.latest.revision: 16
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# xml:lang Handling in XAML
+`xml:lang` 属性は [!INCLUDE[TLA2#tla_xml](../../../includes/tla2sharptla-xml-md.md)] の定義済み属性の 1 つであり、XML の要素の言語およびカルチャ情報を宣言します。 属性の意味は XAML でも同じですが、いくつかの追加の考慮事項が適用されます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object xml:lang="rfc3066lang" />  
+```  
+  
+## XAML 値  
+  
+|||  
+|-|-|  
+|*rfc3066lang*|[RFC 3066](http://go.microsoft.com/fwlink/?LinkId=132454) 標準で定義されている文字列。1 つの言語、または言語と地域を表します。 後者の場合は、言語と地域が 1 つのハイフンで区切られます。 値と形式の詳細については、「<xref:System.Windows.Markup.XmlLanguage>」を参照してください。|  
+  
+## 解説  
+ [!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] における `xml:lang` 属性の定義は、[!INCLUDE[TLA#tla_w3c](../../../includes/tlasharptla-w3c-md.md)] によって [!INCLUDE[TLA2#tla_xml](../../../includes/tla2sharptla-xml-md.md)] の "特別な属性" として定義された `xml:lang` から派生したものです。 言語およびカルチャ情報が要素によって処理される方法は、実装に応じて異なる可能性がありますが、[!INCLUDE[TLA2#tla_xaml](../../../includes/tla2sharptla-xaml-md.md)] における `xml:lang` 属性の既定の処理というものは存在しません。  
+  
+ `xml:lang` 属性の既定値は、属性レベルで空の文字列です。  
+  
+ `xml:lang` 属性の効果と属性の値が、`xml:lang` 値を処理するシステムによって解釈される場合、これらの効果と値は、通常、子要素に反映されます。  
+  
+ .NET Framework XAML サービスの XAML ライターによって解釈される場合、`xml:lang` 値によって、基になるオブジェクト表現に <xref:System.Windows.Markup.XmlLanguage> オブジェクトや <xref:System.Globalization.CultureInfo> オブジェクトが作成される可能性があります。ただし、この動作は、`xml:lang` に指定されている値が、それらのクラスを構築するための入力として有効であるかどうかに依存します。  
+  
+ フレームワークは、<xref:System.Windows.Markup.XmlLangPropertyAttribute> をプロパティに適用することによって、フレームワーク定義プロパティと XML 内の `xml:lang` の意味を関連付けることができます。  
+  
+## WPF の使用上の注意  
+ 要素が <xref:System.Windows.FrameworkElement> または <xref:System.Windows.FrameworkContentElement> の派生クラスの場合は、`xml:lang` 属性の代わりに、同等の <xref:System.Windows.FrameworkElement.Language%2A> 依存関係プロパティを使用できます。 別途設定されない限り、<xref:System.Windows.FrameworkElement.Language%2A> プロパティの値は既定で "en\-US" となります。このプロパティの値は、このプロパティを通して、または `xml:lang` 属性を処理することによって設定されます。  
+  
+## 参照  
+ [WPF のグローバリゼーション](../../../docs/framework/wpf/advanced/globalization-for-wpf.md)
\ No newline at end of file
diff --git a/docs/framework/xaml-services/xml-space-handling-in-xaml.md b/docs/framework/xaml-services/xml-space-handling-in-xaml.md
new file mode 100644
index 00000000000..a6ffb0c4b71
--- /dev/null
+++ b/docs/framework/xaml-services/xml-space-handling-in-xaml.md
@@ -0,0 +1,52 @@
+---
+title: "xml:space Handling in XAML | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net-framework"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-wpf"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "XAML [XAML Services], xml:space attribute"
+  - "XAML [XAML Services], whitespace processing"
+  - "xml:space attribute [XAML Services]"
+  - "whitespace processing [XAML Services]"
+ms.assetid: 5e1814f0-5b30-43d5-8c88-dede335a89d7
+caps.latest.revision: 15
+author: "wadepickett"
+ms.author: "wpickett"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# xml:space Handling in XAML
+`xml:space` 属性は XML で定義される属性であり、重要な空白の処理動作をオブジェクト要素内で宣言します。  この動作は、`xml:space` が宣言されている要素に含まれるすべてのコンテンツ \(内部テキスト\) に関連すると同時に、そのスコープは子要素にも及びます。  
+  
+## XAML 属性の使用方法  
+  
+```  
+<object xml:space="preserve" />  
+```  
+  
+ または  
+  
+```  
+<object xml:space="default" />  
+```  
+  
+## 解説  
+ 2 つの指定可能な値を含め、XAML の `xml:space` 属性の定義は、XML の W3C 仕様で "特別な属性" として定義されている `xml:space` から派生しています。  
+  
+ `xml:space` 属性の既定値は、リテラル値の `"default"` です。  値が `"default"` の場合、または `xml:space` がまったく示されていない場合、重要な空白の解析は、トピック「[Whitespace Processing in XAML](../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)」で定義されているように、既定の動作で処理されます。  
+  
+ オブジェクト要素のコンテンツ内で空白を保持するには、そのオブジェクト要素で `xml:space="preserve"` を指定します。  
+  
+ ほとんどの解釈では、`xml:space` 属性の効果と属性の値は、子要素に反映されます。  
+  
+ XAML での空白の処理の詳細については、「[Whitespace Processing in XAML](../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)」を参照してください。  
+  
+## 参照  
+ [Whitespace Processing in XAML](../../../docs/framework/xaml-services/whitespace-processing-in-xaml.md)   
+ [XAML の概要 \(WPF\)](../../../docs/framework/wpf/advanced/xaml-overview-wpf.md)
\ No newline at end of file
diff --git a/docs/standard/TOC.md b/docs/standard/TOC.md
new file mode 100644
index 00000000000..3f42c2c8c92
--- /dev/null
+++ b/docs/standard/TOC.md
@@ -0,0 +1,10 @@
+# [Parallel Processing and Concurrency](parallel-processing-and-concurrency.md)
+# [数値](numerics.md)
+# [自動メモリ管理](automatic-memory-management.md)
+# [コンソール アプリケーションの構築](building-console-apps.md)
+# [クラス ライブラリの概要](class-library-overview.md)
+# [アプリケーションの基本事項](application-essentials.md)
+# [言語への非依存性、および言語非依存コンポーネント](language-independence-and-language-independent-components.md)
+# [マネージ実行プロセス](managed-execution-process.md)
+# [メタデータと自己言及的なコンポーネント](metadata-and-self-describing-components.md)
+# [共通言語ランタイム](clr.md)
diff --git a/docs/standard/application-essentials.md b/docs/standard/application-essentials.md
new file mode 100644
index 00000000000..f593685d3aa
--- /dev/null
+++ b/docs/standard/application-essentials.md
@@ -0,0 +1,75 @@
+---
+title: ".NET Framework アプリケーションの基本事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework の開発"
+ms.assetid: 653da4ba-3752-4d1f-a08a-de017dc86ecc
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# .NET Framework アプリケーションの基本事項
+.NET Framework ドキュメントのこのセクションでは、.NET Framework での基本的なアプリケーション開発タスクに関する情報を提供します。  
+  
+## <a name="in-this-section"></a>このセクションの内容  
+ [基本データ型](../../docs/standard/base-types/index.md)  
+ 基本データ型の書式指定と解析、および正規表現を使用したテキストの処理について説明します。  
+  
+ [コレクションとデータ構造体](../../docs/standard/collections/index.md)  
+ .NET Framework で利用できるスタック、キュー、リスト、配列、構造体などのさまざまなコレクション型について説明します。  
+  
+ [ジェネリック](../../docs/standard/generics/index.md)  
+ ジェネリック コレクション、ジェネリック デリゲート、ジェネリック インターフェイスなど、.NET Framework に用意されているジェネリック機能について説明します。 C#、Visual Basic、および Visual C++ の機能についてのドキュメント、およびリフレクションなどのサポート テクノロジへのリンクを示します。  
+  
+ [数値](../../docs/standard/numerics.md)  
+ .NET Framework での数値型について説明します。  
+  
+ [イベント](../../docs/standard/events/index.md)  
+ .NET Framework のイベント モデルについて概説します。  
+  
+ [例外](../../docs/standard/exceptions/index.md)  
+ .NET Framework が提供するエラー処理および例外処理の基本事項について説明します。  
+  
+ [ファイルおよびストリームは、O](../../docs/standard/io/index.md)  
+ ファイルやデータ ストリームに対する同期アクセスおよび非同期アクセスの実行方法と、分離ストレージの使用方法について説明します。  
+  
+ [日付、時刻、およびタイム ゾーン](../../docs/standard/datetime/index.md)  
+ タイム ゾーン対応のアプリケーションでのタイム ゾーンの処理方法とタイム ゾーンの変換について説明します。  
+  
+ [アプリケーション ドメインとアセンブリ](../../docs/framework/app-domains/index.md)  
+ アセンブリとアプリケーション ドメインの作成方法および操作方法について説明します。  
+  
+ [シリアル化](../../docs/framework/serialization/index.md)  
+ オブジェクトの状態を永続化または転送できる形式に変換するプロセスについて説明します。  
+  
+ [デスクトップ アプリでのリソース](../../docs/framework/resources/index.md)  
+ リソースを作成し格納するための .NET Framework のサポートについて説明します。 また、このセクションでは、ローカライズされたリソースに対するサポートについて説明し、それらローカライズされたリソースのパッケージ化および配置のサテライト アセンブリ リソース モデルについて説明します。  
+  
+ [グローバリゼーションとローカリゼーション](../../docs/standard/globalization-localization/index.md)  
+ 国際対応アプリケーションの設計および開発に役立つ情報を提供します。  
+  
+ ユーザー補助  
+ Microsoft UI オートメーションについて説明します。Microsoft UI オートメーションは、ユーザー インターフェイス (UI) に関する情報をプログラムで使用できるようにすることにより、ユーザー補助技術製品および自動テスト フレームワークに対するニーズに応えるアクセシビリティ フレームワークです。  
+  
+ [属性](../../docs/standard/attributes/index.md)  
+ 属性を使用してメタデータをカスタマイズする方法について説明します。  
+  
+ [64 ビット アプリケーション](../../docs/framework/64-bit-apps.md)  
+ Windows 64 ビット オペレーティング システムで動作するアプリケーションの開発に関する問題について説明します。  
+  
+## <a name="related-sections"></a>関連項目  
+ [開発ガイド](../../docs/framework/development-guide.md)  
+ アプリケーションの作成、構成、デバッグ、セキュリティ、配置、および動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理に関する情報を含む、アプリケーション開発用の主要な技術領域とタスクのすべてについての手引書です。  
+  
+ [セキュリティ](../../docs/standard/security/index.md)  
+ 共通言語ランタイムおよび .NET Framework において安全なアプリケーションの開発を促進するクラスおよびサービスに関する情報を提供します。
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/TOC.md b/docs/standard/asynchronous-programming-patterns/TOC.md
new file mode 100644
index 00000000000..be7054b699a
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/TOC.md
@@ -0,0 +1,23 @@
+# [Implementing the Task-based Asynchronous Pattern](implementing-the-task-based-asynchronous-pattern.md)
+# [Interop with Other Asynchronous Patterns and Types](interop-with-other-asynchronous-patterns-and-types.md)
+# [Using an AsyncCallback Delegate and State Object](using-an-asynccallback-delegate-and-state-object.md)
+# [Blocking Application Execution by Ending an Async Operation](blocking-application-execution-by-ending-an-async-operation.md)
+# [Asynchronous Programming Model (APM)](asynchronous-programming-model-apm.md)
+# [Event-based Asynchronous Pattern (EAP)](event-based-asynchronous-pattern-eap.md)
+# [Polling for the Status of an Asynchronous Operation](polling-for-the-status-of-an-asynchronous-operation.md)
+# [Deciding When to Implement the Event-based Asynchronous Pattern](deciding-when-to-implement-the-event-based-asynchronous-pattern.md)
+# [Using an AsyncCallback Delegate to End an Asynchronous Operation](using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md)
+# [Multithreaded Programming with the Event-based Asynchronous Pattern](multithreaded-programming-with-the-event-based-asynchronous-pattern.md)
+# [Task-based Asynchronous Pattern (TAP)](task-based-asynchronous-pattern-tap.md)
+# [Event-based Asynchronous Pattern Overview](event-based-asynchronous-pattern-overview.md)
+# [Walkthrough: Implementing a Component That Supports the Event-based Asynchronous Pattern](component-that-supports-the-event-based-asynchronous-pattern.md)
+# [Asynchronous Programming Patterns](index.md)
+# [イベントベースの非同期パターンを実装するための推奨される手順](best-practices-for-implementing-the-event-based-asynchronous-pattern.md)
+# [イベントベースの非同期パターンの実装](implementing-the-event-based-asynchronous-pattern.md)
+# [Calling Synchronous Methods Asynchronously](calling-synchronous-methods-asynchronously.md)
+# [How to: Implement a Component That Supports the Event-based Asynchronous Pattern](component-that-supports-the-event-based-asynchronous-pattern.md)
+# [Asynchronous Programming Using Delegates](asynchronous-programming-using-delegates.md)
+# [How to: Use Components That Support the Event-based Asynchronous Pattern](how-to-use-components-that-support-the-event-based-asynchronous-pattern.md)
+# [How to: Implement a Client of the Event-based Asynchronous Pattern](how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md)
+# [Calling Asynchronous Methods Using IAsyncResult](calling-asynchronous-methods-using-iasyncresult.md)
+# [Consuming the Task-based Asynchronous Pattern](consuming-the-task-based-asynchronous-pattern.md)
diff --git a/docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md b/docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md
new file mode 100644
index 00000000000..113f2878b7a
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md
@@ -0,0 +1,75 @@
+---
+title: "Asynchronous Programming Model (APM) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ending asynchronous operations"
+  - "starting asynchronous operations"
+  - "beginning asynchronous operations"
+  - "asynchronous programming, ending operations"
+  - "asynchronous programming"
+  - "stopping asynchronous operations"
+  - "asynchronous programming, beginning operations"
+ms.assetid: c9b3501e-6bc6-40f9-8efd-4b6d9e39ccf0
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Asynchronous Programming Model (APM)
+<xref:System.IAsyncResult> デザイン パターンを使用する非同期操作は **Begin** *OperationName* と **End** *OperationName* という名前の、各 *OperationName* 非同期操作を開始および終了する 2 種類のメソッドとして実装されます。 たとえば、<xref:System.IO.FileStream> クラスは、<xref:System.IO.FileStream.BeginRead%2A> および <xref:System.IO.FileStream.EndRead%2A> メソッドを提供して、非同期的にファイルからバイトを読み取ります。 これらのメソッドは非同期バージョンの <xref:System.IO.FileStream.Read%2A> メソッドを実装します。  
+  
+> [!NOTE]
+>  .NET Framework 4 以降では、タスク並列ライブラリによって非同期\/並列プログラミングの新しいモデルが提供されます。 詳細については、「[Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)」および「[Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)」を参照してください。  
+  
+ **Begin** *OperationName* を呼び出した後、アプリケーションは別のスレッドで非同期操作が行われている間も、スレッドの呼び出しに関する命令の実行を続行できます。**Begin** *OperationName* の呼び出しごとに、アプリケーションでは **End** *OperationName* も呼び出して、操作の結果を取得する必要があります。  
+  
+## 非同期操作の開始  
+ **Begin** *OperationName* メソッドは非同期操作 *OperationName* を開始し、<xref:System.IAsyncResult> インターフェイスを実装するオブジェクトを返します。<xref:System.IAsyncResult> オブジェクトは非同期操作に関する情報を格納します。 非同期操作に関する情報を次の表に示します。  
+  
+|メンバー|説明|  
+|----------|--------|  
+|<xref:System.IAsyncResult.AsyncState%2A>|非同期操作についての情報を格納するオプションのアプリケーション固有オブジェクト。|  
+|<xref:System.IAsyncResult.AsyncWaitHandle%2A>|<xref:System.Threading.WaitHandle>。非同期操作が完了するまでアプリケーションの実行をブロックするために使用できます。|  
+|<xref:System.IAsyncResult.CompletedSynchronously%2A>|非同期操作が別の <xref:System.Threading.ThreadPool> スレッドで完了する代わりに、**Begin** *OperationName* の呼び出しに使用されたスレッドで完了したかどうかを示す値。|  
+|<xref:System.IAsyncResult.IsCompleted%2A>|非同期操作が完了したかどうかを示す値。|  
+  
+ **Begin** *OperationName* メソッドは、同期バージョンのメソッドのシグネチャで宣言された、値渡しまたは参照渡しのパラメーターを受け取ります。 どの out パラメーターも、**Begin** *OperationName* メソッド シグネチャの一部ではありません。**Begin** *OperationName* メソッド シグネチャには、2 種類の追加のパラメーターが含まれます。 1 つ目のパラメーターは、非同期操作が完了したときに呼び出されるメソッドを参照する <xref:System.AsyncCallback> デリゲートを定義します。 操作完了時にメソッドを呼び出さない場合、呼び出し元は `null` \(Visual Basic では `Nothing`\) を指定できます。 2 つ目の追加のパラメーターは、ユーザー定義オブジェクトです。 このオブジェクトは、アプリケーション固有の状態情報を、非同期操作が完了したときに呼び出されるメソッドに渡すために使用できます。**Begin** *OperationName* メソッドが、ファイルから読み取ったバイトを格納するバイト配列など操作固有の追加のパラメーターを受け取る場合は、<xref:System.AsyncCallback> とアプリケーション状態オブジェクトが **Begin** *OperationName* メソッド シグネチャの最後のパラメーターになります。  
+  
+ **Begin** *OperationName* は、瞬時にコントロールを呼び出し元スレッドに返します。**Begin** *OperationName* メソッドが例外をスローする場合は、非同期操作が開始される前に例外がスローされます。**Begin** *OperationName* メソッドが例外をスローする場合、コールバック メソッドは呼び出されません。  
+  
+## 非同期操作の終了  
+ **End** *OperationName* メソッドは、非同期操作の *OperationName* を終了します。**End** *OperationName* メソッドの戻り値は、このメソッドの対応する同期操作によって返される型と同じ型であり、非同期操作に固有です。 たとえば、<xref:System.IO.FileStream.EndRead%2A> メソッドは <xref:System.IO.FileStream> から読み取ったバイト数を返し、<xref:System.Net.Dns.EndGetHostByName%2A> メソッドはホスト コンピューターに関する情報を含む <xref:System.Net.IPHostEntry> オブジェクトを返します。**End** *OperationName* メソッドは、メソッドの同期バージョンのシグネチャで宣言された out パラメーターや ref パラメーターをすべて受け取ります。**End** *OperationName* メソッドには、同期メソッドからのパラメーターに加えて <xref:System.IAsyncResult> パラメーターが含まれています。 呼び出し元は、対応する呼び出しから返されたインスタンスを **Begin** *OperationName* に渡す必要があります。  
+  
+ **End** *OperationName* が呼び出されるときに <xref:System.IAsyncResult> オブジェクトによって表される非同期操作が完了していない場合、**End** *OperationName* は非同期操作が完了するまで、呼び出し元スレッドをブロックします。 非同期操作によってスローされた例外は、**End** *OperationName* メソッドからスローされます。 同じ <xref:System.IAsyncResult> を使用して **End** *OperationName* メソッドを複数回呼び出す場合の効果は定義されません。 同様に、関連する Begin メソッドによって返されたのではない <xref:System.IAsyncResult> を使用した **End** *OperationName* メソッドの呼び出しも定義されません。  
+  
+> [!NOTE]
+>  どちらの未定義シナリオの場合でも、実装者は <xref:System.InvalidOperationException> のスローを検討する必要があります。  
+  
+> [!NOTE]
+>  このデザイン パターンの実装者は <xref:System.IAsyncResult.IsCompleted%2A> を true に設定し、非同期コールバック メソッドを呼び出して \(指定されている場合\)、<xref:System.IAsyncResult.AsyncWaitHandle%2A> をシグナリングすることで、非同期操作の完了を呼び出し元に通知する必要があります。  
+  
+ アプリケーション開発者には、非同期操作の結果にアクセスするための、デザイン上の選択肢がいくつかあります。 どの選択が適切になるかは、アプリケーションが操作の完了前に実行できる命令を持っているかどうかによって変わります。 非同期操作の結果を受け取るまで、アプリケーションが別の作業を実行できない場合は、結果が使用可能になるまで、そのアプリケーションをブロックする必要があります。 非同期操作が完了するまでブロックするには、次に示す方法の 1 つを使用します。  
+  
+-   アプリケーションのメイン スレッドから **End** *OperationName* を呼び出し、操作が完了するまでアプリケーションの実行をブロックします。 この手法の例については、「[Blocking Application Execution by Ending an Async Operation](../../../docs/standard/asynchronous-programming-patterns/blocking-application-execution-by-ending-an-async-operation.md)」を参照してください。  
+  
+-   <xref:System.IAsyncResult.AsyncWaitHandle%2A> を使用して、1 つ以上の操作が完了するまでアプリケーションの実行をブロックします。 この手法の例については、「[Blocking Application Execution Using an AsyncWaitHandle](../../../docs/standard/asynchronous-programming-patterns/blocking-application-execution-using-an-asyncwaithandle.md)」を参照してください。  
+  
+ 非同期操作が完了するまでアプリケーションをブロックする必要がない場合は、次のいずれかの方法を使用します。  
+  
+-   <xref:System.IAsyncResult.IsCompleted%2A> プロパティを定期的に確認し、操作が完了したときに **End** *OperationName* を呼び出して、操作完了ステータスをポーリングします。 この手法の例については、「[Polling for the Status of an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md)」を参照してください。  
+  
+-   <xref:System.AsyncCallback> デリゲートを使用して、操作が完了したときに呼び出されるメソッドを指定します。 この手法の例については、「[Using an AsyncCallback Delegate to End an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md)」を参照してください。  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Calling Synchronous Methods Asynchronously](../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)   
+ [Using an AsyncCallback Delegate and State Object](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/asynchronous-programming-using-delegates.md b/docs/standard/asynchronous-programming-patterns/asynchronous-programming-using-delegates.md
new file mode 100644
index 00000000000..3b880f1e7ae
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/asynchronous-programming-using-delegates.md
@@ -0,0 +1,46 @@
+---
+title: "Asynchronous Programming Using Delegates | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BeginInvoke method"
+  - "asynchronous programming, delegates"
+  - "asynchronous delegates"
+  - "calling synchronous methods in asynchronous manner"
+  - "EndInvoke method"
+  - "calling asynchronous methods"
+  - "delegates [.NET Framework], asynchronous"
+  - "synchronous calling in asynchronous manner"
+ms.assetid: 38a345ca-6963-4436-9608-5c9defef9c64
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Asynchronous Programming Using Delegates
+デリゲートを使用すると、同期メソッドを非同期的に呼び出すことができます。  デリゲートを同期的に呼び出すと、`Invoke` メソッドによって対象メソッドが現在のスレッドで直接呼び出されます。  `BeginInvoke` メソッドが呼び出されると、共通言語ランタイム \(CLR: Common Language Runtime\) は要求をキューに置き、すぐに呼び出し元に戻ります。  対象メソッドは、スレッド プールのスレッドで非同期に呼び出されます。  要求を送信した元のスレッドは、対象メソッドと並行して継続実行できます。   `BeginInvoke` メソッドの呼び出しにコールバック メソッドを指定した場合、対象メソッドの終了時に、そのコールバック メソッドが呼び出されます。  コールバック メソッドでは、`EndInvoke` メソッドを使用して、戻り値と、入出力パラメーターまたは出力専用パラメーターを取得します。  `BeginInvoke` の呼び出しにコールバック メソッドを指定しなかった場合は、`BeginInvoke` を呼び出したスレッドから `EndInvoke` を呼び出すことができます。  
+  
+> [!IMPORTANT]
+>  コンパイラは、ユーザーが指定したデリゲート シグネチャを使用して、`Invoke`、`BeginInvoke`、`EndInvoke` の各メソッドを持つデリゲート クラスを出力します。  `BeginInvoke` メソッドと `EndInvoke` メソッドは、ネイティブとして修飾されます。  これら 2 つのメソッドはネイティブとしてマークされるため、クラスの読み込み時には、CLR によって自動的にメソッドが実装されます。  ローダーは、これらのメソッドがオーバーライドされないことを保証します。  
+  
+## このセクションの内容  
+ [Calling Synchronous Methods Asynchronously](../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)  
+ デリゲートを使用した通常のメソッドの非同期呼び出しについて説明すると共に、簡単なコード例を示して、非同期呼び出しが戻るのを待機する 4 つの方法を紹介します。  
+  
+ [非同期デリゲートのプログラミング サンプル](../Topic/Asynchronous%20Delegates%20Programming%20Sample.md)  
+ デリゲートを使用して非同期呼び出しを行う例を示します。ここでは、より複雑なコード例を紹介し、数値の因数分解を実行します。  
+  
+## 関連項目  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)  
+ .NET Framework での非同期プログラミングについて説明します。  
+  
+## 参照  
+ <xref:System.Delegate>
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..1f935ff4bbc
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,163 @@
+---
+title: "イベントベースの非同期パターンを実装するための推奨される手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ベースの非同期パターン"
+  - "ProgressChangedEventArgs クラス"
+  - "BackgroundWorker コンポーネント"
+  - "イベント [.NET Framework], 非同期"
+  - "AsyncOperationManager クラス"
+  - "スレッド処理 [.NET Framework], 非同期機能"
+  - "AsyncOperation クラス"
+  - "AsyncCompletedEventArgs クラス"
+ms.assetid: 4acd2094-4f46-4eff-9190-92d0d9ff47db
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# イベントベースの非同期パターンを実装するための推奨される手順
+イベントベースの非同期パターンは、使い慣れたイベントおよびデリゲートのセマンティクスと共に、クラス内の非同期動作を公開する効果的な方法を提供します。 イベント ベースの非同期パターンを実装するには、いくつかの固有の動作要件に従う必要があります。 以降のセクションでは、イベントベースの非同期パターンに従うクラスを実装する際に検討すべき要件とガイドラインについて説明します。  
+  
+ 概要については、「[Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+## 必要な動作保証  
+ イベントベースの非同期パターンを実装する場合は、クラスが適切に動作し、クラスのクライアントがそのような動作に依存できるようにするため、多数の保証を提供する必要があります。  
+  
+### 完了  
+ 正常完了、エラー、またはキャンセルの場合に常に *MethodName*`Completed` イベント ハンドラーを呼び出します。 アプリケーションがアイドルになり完了しない状態が発生してはなりません。 この規則の唯一の例外として、非同期操作自体は完了することがないように設計されている場合があります。  
+  
+### 完了イベントおよび EventArg  
+ 個別の *MethodName*`Async` メソッドごとに、次の設計要件を適用します。  
+  
+-   メソッドと同じクラスで *MethodName*`Completed` イベントを定義します。  
+  
+-   <xref:System.ComponentModel.AsyncCompletedEventArgs> クラスから派生した *MethodName*`Completed` イベントの <xref:System.EventArgs> クラスと、これに付随するデリゲートを定義します。 既定のクラス名の形式は *MethodName*`CompletedEventArgs` です。  
+  
+-   <xref:System.EventArgs> クラスは、*MethodName* メソッドの戻り値に固有のクラスにしてください。<xref:System.EventArgs> クラスを使用する場合は、開発者に対して結果をキャストすることを義務付けないでください。  
+  
+     設計要件の適切な実装と不適切な実装を次のコード例に示します。  
+  
+```csharp  
+// Good design  
+private void Form1_MethodNameCompleted(object sender, xxxCompletedEventArgs e)   
+{   
+    DemoType result = e.Result;  
+}  
+  
+// Bad design  
+private void Form1_MethodNameCompleted(object sender, MethodNameCompletedEventArgs e)   
+{   
+    DemoType result = (DemoType)(e.Result);  
+}  
+```  
+  
+-   <xref:System.EventArgs> を返すメソッドのために `void` クラスを定義しないでください。 代わりに <xref:System.ComponentModel.AsyncCompletedEventArgs> クラスのインスタンスを使用してください。  
+  
+-   常に *MethodName*`Completed` イベントを発生させてください。 このイベントは、正常完了、エラー、またはキャンセル時に発生する必要があります。 アプリケーションがアイドルになり完了しない状態が発生してはなりません。  
+  
+-   非同期操作で発生した例外をすべてキャッチし、キャッチした例外を <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> プロパティに割り当ててください。  
+  
+-   タスクの実行中にエラーが発生した場合は、結果にアクセスできないようにしてください。<xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> プロパティが `null` ではない場合は、<xref:System.EventArgs> 構造体のプロパティにアクセスすると例外が発生するようにしてください。 この検証を行うには、<xref:System.ComponentModel.AsyncCompletedEventArgs.RaiseExceptionIfNecessary%2A> メソッドを使用します。  
+  
+-   タイムアウトをエラーとしてモデル化します。 タイムアウトが発生したら、*MethodName*`Completed` イベントを発生させ、<xref:System.TimeoutException> を <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> プロパティに割り当てます。  
+  
+-   クラスで複数の同時呼び出しがサポートされている場合は、*MethodName*`Completed` イベントに適切な `userSuppliedState` オブジェクトが含まれるようにしてください。  
+  
+-   *MethodName* `Completed` イベントが、適切なスレッドでアプリケーション サイクルの適切な時点で発生するようにしてください。 詳細については、「スレッド処理およびコンテキスト」を参照してください。  
+  
+### 操作の同時実行  
+  
+-   クラスで複数の同時呼び出しがサポートされている場合は、開発者が各呼び出しを個別に追跡できるようにするため、オブジェクト値状態パラメーターまたはタスク ID `userSuppliedState` を受け取る *MethodName*`Async` オーバーライドを定義します。 このパラメーターは常に *MethodName*`Async` メソッドのシグネチャの最終パラメーターにする必要があります。  
+  
+-   オブジェクト値状態パラメーターまたはタスク ID を受け取る *MethodName*`Async` オーバーロードがクラスによって定義される場合は、そのタスク ID の操作の有効期間を追跡し、完了ハンドラーに戻す必要があります。 役に立つヘルパー クラスがあります。 同時実行管理の詳細については、「[Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+-   クラスによって、状態パラメーターなしで *MethodName*`Async` メソッドが定義され、このクラスで複数の同時呼び出しがサポートされていない場合、直前の *MethodName*`Async` 呼び出しが完了する前に *MethodName*`Async` を呼び出そうとすると、<xref:System.InvalidOperationException> が発生するようにします。  
+  
+-   一般に、`userSuppliedState` パラメーターのない *MethodName*`Async` メソッドを複数回呼び出すときには、複数の未完了操作が存在するようにするため、例外を発生させないでください。 例外を発生させることができるのは、クラスがその状況に対処できないことが明らかであるものの、開発者がこのような区別できない複数のコールバックを処理できる場合です。  
+  
+### 結果へのアクセス  
+  
+-   非同期操作の実行中にエラーが発生した場合、その結果にはアクセスできないようにしてください。<xref:System.ComponentModel.AsyncCompletedEventArgs> が <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> ではない場合に `null` のプロパティにアクセスすると、<xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A> により参照される例外が発生するようにしてください。.<xref:System.ComponentModel.AsyncCompletedEventArgs> クラスには、この目的で使用する <xref:System.ComponentModel.AsyncCompletedEventArgs.RaiseExceptionIfNecessary%2A> メソッドが用意されています。  
+  
+-   結果にアクセスしようとすると、操作がキャンセルされたことを示す <xref:System.InvalidOperationException> が発生するようにしてください。 この検証を行うには、<xref:System.ComponentModel.AsyncCompletedEventArgs.RaiseExceptionIfNecessary%2A?displayProperty=fullName> メソッドを使用します。  
+  
+### 進行状況のレポート  
+  
+-   可能であれば、進行状況レポートをサポートします。 これにより、開発者はクラスを使用する際に、より優れたアプリケーション ユーザー エクスペリエンスを提供できます。  
+  
+-   `ProgressChanged`\/*MethodName*`ProgressChanged` イベントを実装する場合は、操作の *MethodName*`Completed` イベントが発生した後で、特定の非同期操作についてそのようなイベントが発生していないようにしてください。  
+  
+-   標準 <xref:System.ComponentModel.ProgressChangedEventArgs> の値が設定される場合は、<xref:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage%2A> が常にパーセンテージとして解釈できるようにしてください。 パーセンテージは正確である必要はありませんが、パーセンテージを表している必要があります。 進行状況レポート メトリックがパーセンテージ以外でなければならない場合は、<xref:System.ComponentModel.ProgressChangedEventArgs> クラスからクラスを派生し、<xref:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage%2A> は 0 のままにしておきます。 パーセンテージ以外のレポート メトリックは使用しないでください。  
+  
+-   `ProgressChanged` イベントが、適切なスレッドでアプリケーション サイクルの適切な時点で発生するようにしてください。 詳細については、「スレッド処理およびコンテキスト」を参照してください。  
+  
+### IsBusy 実装  
+  
+-   クラスが複数の同時呼び出しをサポートしている場合は、`IsBusy` プロパティを公開しないでください。 たとえば XML Web サービス プロキシは、非同期メソッドの複数同時呼び出しをサポートしているため、`IsBusy` プロパティを公開しません。  
+  
+-   `IsBusy` プロパティは、*MethodName*`Async` メソッドが呼び出されてから、*MethodName*`Completed` イベントが発生するまでの間は、`true` を返します。 それ以外の場合は、`false` を返す必要があります。<xref:System.ComponentModel.BackgroundWorker> プロパティを公開するクラスの例として、<xref:System.Net.WebClient> および `IsBusy` コンポーネントがあります。  
+  
+### キャンセル  
+  
+-   可能であれば、キャンセルをサポートしてください。 これにより、開発者はクラスを使用する際に、より優れたアプリケーション ユーザー エクスペリエンスを提供できます。  
+  
+-   キャンセルの場合、<xref:System.ComponentModel.AsyncCompletedEventArgs.Cancelled%2A> オブジェクトに <xref:System.ComponentModel.AsyncCompletedEventArgs> フラグを設定します。  
+  
+-   結果にアクセスしようとすると、操作がキャンセルされたことを示す <xref:System.InvalidOperationException> が発生するようにしてください。 この検証を行うには、<xref:System.ComponentModel.AsyncCompletedEventArgs.RaiseExceptionIfNecessary%2A?displayProperty=fullName> メソッドを使用します。  
+  
+-   キャンセル メソッドの呼び出しは常に正常に戻り、例外を発生させないようにしてください。 一般に、特定の時点で操作が実際にキャンセル可能かどうかと、前に発行したキャンセルが正常に実行されたかどうかはクライアントに通知されません。 ただし、キャンセルが正常に完了すると常にアプリケーションに通知が送られます。これは、アプリケーションが完了ステータスに関与しているためです。  
+  
+-   操作がキャンセルされた場合は *MethodName*`Completed` イベントを発生させます。  
+  
+### エラーおよび例外  
+  
+-   非同期操作で発生した例外をすべてキャッチし、その例外の <xref:System.ComponentModel.AsyncCompletedEventArgs.Error%2A?displayProperty=fullName> プロパティの値を設定します。  
+  
+### スレッド処理およびコンテキスト  
+ クラスを正しく操作するには、特定のアプリケーション モデル \([!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] および Windows Forms アプリケーションを含む\) の適切なスレッドまたはコンテキストで、クライアントのイベント ハンドラーが呼び出されることが重要です。 非同期クラスがどのアプリケーション モデルでも正しく動作するように、<xref:System.ComponentModel.AsyncOperation> と <xref:System.ComponentModel.AsyncOperationManager> という 2 つの重要なヘルパー クラスが用意されています。  
+  
+ <xref:System.ComponentModel.AsyncOperationManager> にはメソッド <xref:System.ComponentModel.AsyncOperationManager.CreateOperation%2A> が含まれています。このメソッドは <xref:System.ComponentModel.AsyncOperation> を返します。*MethodName*`Async` メソッドは <xref:System.ComponentModel.AsyncOperationManager.CreateOperation%2A> を呼び出し、クラスは返される <xref:System.ComponentModel.AsyncOperation> を使用して非同期タスクの有効期間を追跡します。  
+  
+ 進行状況、インクリメンタル結果、および完了をクライアントに報告するため、<xref:System.ComponentModel.AsyncOperation.Post%2A> で <xref:System.ComponentModel.AsyncOperation.OperationCompleted%2A> メソッドと <xref:System.ComponentModel.AsyncOperation> メソッドを呼び出します。<xref:System.ComponentModel.AsyncOperation> は、クライアントのイベント ハンドラーに対する呼び出しを適切なスレッドまたはコンテキストにマーシャリングします。  
+  
+> [!NOTE]
+>  アプリケーション モデルのポリシーに対し明示的に準拠しないものの、イベント ベースの非同期パターンを使用する他のメリットを利用したい場合は、これらの規則を回避できます。 たとえば、Windows Forms でのクラス操作をフリー スレッド化するとします。 開発者がフリー スレッド化クラスの暗黙的な制限を理解している場合は、フリースレッド化クラスを作成できます。 コンソール アプリケーションは <xref:System.ComponentModel.AsyncOperation.Post%2A> 呼び出しの実行を同期しません。 これが原因で、`ProgressChanged` イベントが正しくない順序で発生することがあります。<xref:System.ComponentModel.AsyncOperation.Post%2A> 呼び出しを順次実行するには、<xref:System.Threading.SynchronizationContext?displayProperty=fullName> クラスを実装およびインストールします。  
+  
+ <xref:System.ComponentModel.AsyncOperation> と <xref:System.ComponentModel.AsyncOperationManager> を使用して非同期操作を使用可能にする方法の詳細については、「[Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+## ガイドライン  
+  
+-   各メソッド呼び出しが相互に独立していることが理想的です。 呼び出しを共有リソースと組み合わせないでください。 リソースを複数の呼び出し間で共有する場合は、実装に適切な同期メカニズムを提供する必要があります。  
+  
+-   クライアントが同期を実装する必要がある設計は推奨されません。 たとえば、グローバルな静的オブジェクトをパラメータとして受け取る非同期メソッドがあり、この非同期メソッドを同時に複数呼び出すと、データの破損またはデッドロックが発生することがあります。  
+  
+-   複数呼び出しのオーバーロード \(シグネチャの `userState`\) を使用してメソッドを実装する場合、ユーザー状態、タスク ID、対応する保留操作のコレクションをクラスで管理する必要があります。 さまざまな呼び出しでこのコレクションの `lock` オブジェクトが追加および削除されるため、このコレクションを `userState` 領域で保護する必要があります。  
+  
+-   可能かつ適切な場合は、`CompletedEventArgs` クラスの再利用を検討してください。 この場合、特定のデリゲートと <xref:System.EventArgs> 型が 1 つのメソッドに関連付けられていないため、名前付けにはメソッド名との整合性がありません。 ただし、開発者に対して <xref:System.EventArgs> のプロパティから取得した値をキャストすることを強制することはできません。  
+  
+-   <xref:System.ComponentModel.Component> から派生したクラスを編集する場合、独自の <xref:System.Threading.SynchronizationContext> クラスを実装およびインストールしないでください。 使用される <xref:System.Threading.SynchronizationContext> を制御するのは、コンポーネントではなくアプリケーション モデルです。  
+  
+-   どのようなマルチスレッドを使用する場合でも、深刻かつ複雑なバグが発生する可能性があります。 マルチスレッドを使用するソリューションを実装する前に、「[Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.ComponentModel.AsyncOperation>   
+ <xref:System.ComponentModel.AsyncOperationManager>   
+ <xref:System.ComponentModel.AsyncCompletedEventArgs>   
+ <xref:System.ComponentModel.ProgressChangedEventArgs>   
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)   
+ [Multithreaded Programming with the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)   
+ [Deciding When to Implement the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)   
+ [Best Practices for Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)   
+ [How to: Use Components That Support the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md)   
+ [Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/blocking-application-execution-by-ending-an-async-operation.md b/docs/standard/asynchronous-programming-patterns/blocking-application-execution-by-ending-an-async-operation.md
new file mode 100644
index 00000000000..4b80192106c
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/blocking-application-execution-by-ending-an-async-operation.md
@@ -0,0 +1,41 @@
+---
+title: "Blocking Application Execution by Ending an Async Operation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "blocks, asynchronous operations"
+  - "AsyncWaitHandle property"
+  - "asynchronous programming, blocking applications"
+  - "blocking application execution"
+ms.assetid: cc5e2834-a65b-4df8-b750-7bdb79997fee
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Blocking Application Execution by Ending an Async Operation
+非同期操作の結果を待っている間に他の作業を行うことができないアプリケーションは、操作が完了するまでブロックする必要があります。  非同期操作の完了を待っている間に、アプリケーションのメイン スレッドをブロックするには、次のいずれかのオプションを使用します。  
+  
+-   非同期操作の **\[終了\]** *OperationName* のメソッドを呼び出します。  この方法については、このトピックで説明します。  
+  
+-   非同期操作の **\[開始\]** *OperationName* のメソッドによって返される <xref:System.IAsyncResult> の <xref:System.IAsyncResult.AsyncWaitHandle%2A> のプロパティを使用します。  この方法の実行例については、「[Blocking Application Execution Using an AsyncWaitHandle](../../../docs/standard/asynchronous-programming-patterns/blocking-application-execution-using-an-asyncwaithandle.md)」を参照してください。  
+  
+ 非同期操作が完了するまでブロックするに **\[終了\]** *OperationName* のメソッドを使用するアプリケーションは、通常 **\[開始\]** *OperationName* のメソッドを呼び出した後、操作の結果がなくても行うことができます。次に、**\[終了\]** *OperationName*を作業を呼び出します。  
+  
+## 例  
+ <xref:System.Net.Dns> クラスで非同期メソッドを使用して、ユーザー指定のコンピューターのドメイン ネーム システム \(DNS\) 情報を取得するコード例を次に示します。  ここで使用する方法では、<xref:System.Net.Dns.BeginGetHostByName%2A> の `requestCallback` パラメーターと `stateObject` パラメーターは不要なので、これらには `null` \(Visual Basic では `Nothing`\) が渡されます。  
+  
+ [!code-csharp[AsyncDesignPattern#1](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDesignPattern/CS/Async_EndBlock.cs#1)]
+ [!code-vb[AsyncDesignPattern#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDesignPattern/VB/Async_EndBlock.vb#1)]  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/calling-asynchronous-methods-using-iasyncresult.md b/docs/standard/asynchronous-programming-patterns/calling-asynchronous-methods-using-iasyncresult.md
new file mode 100644
index 00000000000..8bf0a25eed6
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/calling-asynchronous-methods-using-iasyncresult.md
@@ -0,0 +1,40 @@
+---
+title: "Calling Asynchronous Methods Using IAsyncResult | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ending asynchronous operations"
+  - "waiting for asynchronous operations"
+  - "asynchronous method calling"
+  - "calling asynchronous methods"
+  - "asynchronous programming, calling asynchronous methods"
+  - "IAsyncResult interface, calling asynchronous methods"
+  - "stopping asynchronous operations"
+ms.assetid: 07fba116-045b-473c-a0b7-acdbeb49861f
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Calling Asynchronous Methods Using IAsyncResult
+.NET Framework およびサードパーティ製クラス ライブラリの型は、メイン アプリケーション スレッド以外のスレッドで非同期操作を実行中に、アプリケーションの実行を継続できるメソッドを提供します。  以降のセクションでは、<xref:System.IAsyncResult> デザイン パターンを使用する非同期メソッドを呼び出すことのできる、さまざまなコード例を説明および紹介します。  
+  
+-   [Blocking Application Execution by Ending an Async Operation](../../../docs/standard/asynchronous-programming-patterns/blocking-application-execution-by-ending-an-async-operation.md).  
+  
+-   [Blocking Application Execution Using an AsyncWaitHandle](../../../docs/standard/asynchronous-programming-patterns/blocking-application-execution-using-an-asyncwaithandle.md).  
+  
+-   [Polling for the Status of an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md).  
+  
+-   [Using an AsyncCallback Delegate to End an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md).  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md b/docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md
new file mode 100644
index 00000000000..a79619a7e5d
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md
@@ -0,0 +1,115 @@
+---
+title: "Calling Synchronous Methods Asynchronously | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "asynchronous programming, delegates"
+  - "asynchronous delegates"
+  - "AsyncWaitHandle property"
+  - "callback methods"
+  - "calling synchronous methods in asynchronous manner"
+  - "WaitHandle class, code examples"
+  - "asynchronous programming, status polling"
+  - "polling asynchronous operation status"
+  - "delegates [.NET Framework], asynchronous"
+  - "synchronous calling in asynchronous manner"
+  - "waiting for asynchronous calls"
+  - "status information [.NET Framework], asynchronous operations"
+ms.assetid: 41972034-92ed-450a-9664-ab93fcc6f1fb
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# Calling Synchronous Methods Asynchronously
+.NET Framework では、すべてのメソッドを非同期的に呼び出すことができます。 これを行うには、呼び出すメソッドと同じシグネチャを持つデリゲートを定義します。これにより、共通言語ランタイムによって、適切なシグネチャを持つ、このデリゲートの `BeginInvoke` メソッドと `EndInvoke` メソッドが自動的に定義されます。  
+  
+> [!NOTE]
+>  非同期デリゲート \(具体的には `BeginInvoke` メソッドと `EndInvoke` メソッド\) は、.NET Compact Framework ではサポートされていません。  
+  
+ `BeginInvoke` メソッドは、非同期呼び出しを開始します。 このメソッドは、非同期的に実行するメソッドと同じパラメーターと共に、2 つの省略可能な追加パラメーターを持っています。 最初のパラメーターは、同期呼び出しが完了したときに呼び出されるメソッドを参照する <xref:System.AsyncCallback> デリゲートです。 2 番目のパラメーターは、コールバック メソッドに情報を渡すユーザー定義オブジェクトです。`BeginInvoke` からは制御がすぐに戻り、非同期呼び出しが完了するまで待機しません。`BeginInvoke` は <xref:System.IAsyncResult> を返します。これを使用して非同期呼び出しの進捗状況を監視できます。  
+  
+ `EndInvoke` メソッドは、非同期呼び出しの結果を取得します。 このメソッドは、`BeginInvoke` の後であればいつでも呼び出すことができます。 非同期呼び出しがまだ完了していない場合は、`EndInvoke` は非同期呼び出しが完了するまで呼び出し元スレッドをブロックします。`EndInvoke` のパラメーターには、非同期実行するメソッドの `out` パラメーターと `ref` パラメーター \(Visual Basic では [\<Out\>](../Topic/OutAttribute%20Class.md) `ByRef` と `ByRef`\) と、<xref:System.IAsyncResult> によって返された `BeginInvoke` が含まれます。  
+  
+> [!NOTE]
+>  [!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] の IntelliSense 機能によって `BeginInvoke` および `EndInvoke` のパラメーターが表示されます。 Visual Studio や類似のツールを使っていない場合や、[!INCLUDE[vsprvslong](../../../includes/vsprvslong-md.md)] で C\# を使っている場合、これらのメソッドについて定義されているパラメーターについては、「[Asynchronous Programming Model \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md)」をご覧ください。  
+  
+ このトピックのコード例では、`BeginInvoke` と `EndInvoke` を使用して非同期呼び出しを行う 4 つの一般的な方法を示します。`BeginInvoke` を呼び出した後、次の処理を行うことができます。  
+  
+-   何か処理を実行した後、呼び出しが完了するまでブロックする `EndInvoke` を呼び出します。  
+  
+-   <xref:System.Threading.WaitHandle> プロパティを使用して <xref:System.IAsyncResult.AsyncWaitHandle%2A?displayProperty=fullName> を取得し、その <xref:System.Threading.WaitHandle.WaitOne%2A> メソッドを使用して <xref:System.Threading.WaitHandle> が通知されるまで実行をブロックし、`EndInvoke` を呼び出します。  
+  
+-   <xref:System.IAsyncResult> によって返される `BeginInvoke` をポーリングして非同期呼び出しが完了したかどうかを確認した後、`EndInvoke` を呼び出します。  
+  
+-   コールバック メソッドのデリゲートを `BeginInvoke` に渡します。 このメソッドは、非同期呼び出しが完了すると、<xref:System.Threading.ThreadPool> スレッドで実行されます。 コールバック メソッドは `EndInvoke` を呼び出します。  
+  
+> [!IMPORTANT]
+>  どの手法を使用する場合でも、常に `EndInvoke` を呼び出して、非同期呼び出しを完了します。  
+  
+## テスト メソッドと非同期デリゲートの定義  
+ 次のコード例は、長時間実行される `TestMethod` メソッドの非同期呼び出しを行うさまざまな方法を示します。`TestMethod` メソッドはコンソール メッセージを表示して処理が開始されたことを示し、しばらくスリープした後、終了します。`TestMethod` には `out` パラメーターがあり、`BeginInvoke` および `EndInvoke` のシグネチャへのそのようなパラメーターの追加方法を示します。`ref` パラメーターは同様に処理できます。  
+  
+ 次のコード例は、`TestMethod` と、`AsyncMethodCaller` の非同期呼び出しに使用できる `TestMethod` という名前のデリゲートの定義を示します。 コード例をコンパイルするには、`TestMethod` および `AsyncMethodCaller` デリゲートの定義を含める必要があります。  
+  
+ [!code-cpp[AsyncDelegateExamples#1](../../../samples/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/TestMethod.cpp#1)]
+ [!code-csharp[AsyncDelegateExamples#1](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDelegateExamples/CS/TestMethod.cs#1)]
+ [!code-vb[AsyncDelegateExamples#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/TestMethod.vb#1)]  
+  
+## EndInvoke による非同期呼び出しの待機  
+ メソッドを非同期実行する最も簡単な方法は、デリゲートの `BeginInvoke` メソッドを呼び出してメソッドの実行を開始し、メイン スレッドで何かの処理を実行した後、デリゲートの `EndInvoke` メソッドを呼び出す方法です。`EndInvoke` は非同期呼び出しが完了するまで戻らないので、呼び出し元スレッドがブロックされる場合があります。 この手法はファイルやネットワーク操作を使用するときに適しています。  
+  
+> [!IMPORTANT]
+>  `EndInvoke` でブロックするため、ユーザー インターフェイスにサービスを提供するスレッドからは呼び出さないでください。  
+  
+ [!code-cpp[AsyncDelegateExamples#2](../../../samples/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/EndInvoke.cpp#2)]
+ [!code-csharp[AsyncDelegateExamples#2](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDelegateExamples/CS/EndInvoke.cs#2)]
+ [!code-vb[AsyncDelegateExamples#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/EndInvoke.vb#2)]  
+  
+## WaitHandle による非同期呼び出しの待機  
+ <xref:System.Threading.WaitHandle> を取得するには、<xref:System.IAsyncResult.AsyncWaitHandle%2A> によって返される <xref:System.IAsyncResult> の `BeginInvoke` プロパティを使用します。<xref:System.Threading.WaitHandle> は非同期呼び出しが完了すると通知され、<xref:System.Threading.WaitHandle.WaitOne%2A> メソッドを呼び出すことによってこれを待機できます。  
+  
+ <xref:System.Threading.WaitHandle> を使用する場合は、非同期呼び出しの完了前または完了後、`EndInvoke` を呼び出して結果を取得する前に、追加の処理を実行できます。  
+  
+> [!NOTE]
+>  `EndInvoke` を呼び出す場合、待機ハンドルは自動的に閉じられません。 待機ハンドルへのすべての参照を解放すると、ガベージ コレクションが待機ハンドルをクリアするときにシステム リソースが解放されます。 待機ハンドルの使用が終了すると同時にシステム リソースを解放するには、<xref:System.Threading.WaitHandle.Close%2A?displayProperty=fullName> メソッドを呼び出して破棄します。 破棄可能なオブジェクトが明示的に破棄されると、ガベージ コレクションはより効率的に動作します。  
+  
+ [!code-cpp[AsyncDelegateExamples#3](../../../samples/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/waithandle.cpp#3)]
+ [!code-csharp[AsyncDelegateExamples#3](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDelegateExamples/CS/waithandle.cs#3)]
+ [!code-vb[AsyncDelegateExamples#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/WaitHandle.vb#3)]  
+  
+## 非同期呼び出し完了のポーリング  
+ <xref:System.IAsyncResult.IsCompleted%2A> によって返された <xref:System.IAsyncResult> の `BeginInvoke` プロパティを使用して、非同期呼び出しが完了したことを検出できます。 この方法は、ユーザー インターフェイスにサービスを提供するスレッドから非同期呼び出しを行う場合に使用します。 完了をポーリングすると、呼び出し元スレッドは、<xref:System.Threading.ThreadPool> スレッドで非同期呼び出しを実行しながら、実行を継続できます。  
+  
+ [!code-cpp[AsyncDelegateExamples#4](../../../samples/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/polling.cpp#4)]
+ [!code-csharp[AsyncDelegateExamples#4](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDelegateExamples/CS/polling.cs#4)]
+ [!code-vb[AsyncDelegateExamples#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/polling.vb#4)]  
+  
+## 非同期呼び出し完了時のコールバック メソッドの実行  
+ 非同期呼び出しを開始したスレッドが結果を処理するスレッドである必要がない場合は、呼び出しが完了したときにコールバック メソッドを実行できます。 コールバック メソッドは <xref:System.Threading.ThreadPool> スレッドで実行されます。  
+  
+ コールバック メソッドを使用するには、コールバック メソッドを表す `BeginInvoke` デリゲートを <xref:System.AsyncCallback> に渡す必要があります。 コールバック メソッドで使用される情報を含むオブジェクトを渡すこともできます。 コールバック メソッドでは、唯一のパラメーターである <xref:System.IAsyncResult> を <xref:System.Runtime.Remoting.Messaging.AsyncResult> オブジェクトにキャストします。 こうすると、<xref:System.Runtime.Remoting.Messaging.AsyncResult.AsyncDelegate%2A?displayProperty=fullName> プロパティを使用して、呼び出しを開始するために使用したデリゲートを取得し、`EndInvoke` を呼び出すことができるようになります。  
+  
+ 例に関する注意事項  
+  
+-   `threadId` の `TestMethod` パラメーターは `out` パラメーター \(Visual Basic では [\<Out \>](../Topic/OutAttribute%20Class.md) `ByRef`\) であるため、その入力値が `TestMethod` で使用されることはありません。`BeginInvoke` 呼び出しにはダミー変数が渡されます。`threadId` パラメーターが `ref` パラメーター \(Visual Basic では `ByRef`\) であった場合、`BeginInvoke` と `EndInvoke` の両方に渡すことができるように、変数はクラス レベルのフィールドであることが必要です。  
+  
+-   `BeginInvoke` に渡される状態情報は、コールバック メソッドが出力メッセージを書式指定するために使用する書式指定文字列です。 型 <xref:System.Object> として渡されるため、状態情報を使用するには適切な型にキャストする必要があります。  
+  
+-   コールバックは <xref:System.Threading.ThreadPool> スレッドで作成されます。<xref:System.Threading.ThreadPool> スレッドは、メイン スレッドが終了した場合はアプリケーションの実行を継続しないバックグラウンド スレッドであるため、例で使用するメイン スレッドは、コールバックが終了できるまでスリープする必要があります。  
+  
+ [!code-cpp[AsyncDelegateExamples#5](../../../samples/snippets/cpp/VS_Snippets_CLR/AsyncDelegateExamples/cpp/callback.cpp#5)]
+ [!code-csharp[AsyncDelegateExamples#5](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDelegateExamples/CS/callback.cs#5)]
+ [!code-vb[AsyncDelegateExamples#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDelegateExamples/VB/callback.vb#5)]  
+  
+## 参照  
+ <xref:System.Delegate>   
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..b3c2824fb63
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,262 @@
+---
+title: "Walkthrough: Implementing a Component That Supports the Event-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "Asynchronous Pattern"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "components [.NET Framework], asynchronous"
+  - "AsyncOperation class"
+  - "threading [Windows Forms], asynchronous features"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: 61f676b5-936f-40f6-83ce-f22805ec9c2f
+caps.latest.revision: 21
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Walkthrough: Implementing a Component That Supports the Event-based Asynchronous Pattern
+一部の操作によって著しい遅延が発生する可能性があるクラスを記述する場合は、[Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md) の実装による非同期機能の追加を検討してください。  
+  
+ このチュートリアルでは、イベント ベースの非同期パターンを実装するコンポーネントの作成方法を示します。  これは <xref:System.ComponentModel?displayProperty=fullName> 名前空間からヘルパー クラスを使用して実装されます。これによりコンポーネントは、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)]、コンソール アプリケーション、および Windows フォーム アプリケーションを含む任意のアプリケーション モデルで正常に動作します。  また、このコンポーネントは、<xref:System.Windows.Forms.PropertyGrid> コントロールおよび独自のカスタム デザイナーでデザインが可能です。  
+  
+ これが終了すると、素数を非同期的に計算するアプリケーションの用意ができます。  アプリケーションには、メインのユーザー インターフェイス \(UI\) スレッドと、各素数計算のためのスレッドが含まれます。  大きな数が素数かどうかのテストには時間がかかりますが、メインの UI スレッドがこの遅延によって中断されることはなく、計算中もフォームは応答可能な状態です。  同時にいくつでも計算を実行でき、保留中の計算を個別に選択してキャンセルできます。  
+  
+ このチュートリアルでは、以下のタスクを行います。  
+  
+-   コンポーネントの作成  
+  
+-   パブリック非同期イベントおよびデリゲートの定義  
+  
+-   プライベート デリゲートの定義  
+  
+-   パブリック イベントの実装  
+  
+-   完了メソッドの実装  
+  
+-   ワーカー メソッドの実装  
+  
+-   開始およびキャンセル メソッドの実装  
+  
+ このトピックのコードを単一のリストとしてコピーするには、「[How to: Implement a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+## コンポーネントの作成  
+ 最初に、イベント ベースの非同期パターンを実装するコンポーネントを作成します。  
+  
+#### コンポーネントを作成するには  
+  
+-   <xref:System.ComponentModel.Component> から継承した、`PrimeNumberCalculator` という名前のクラスを作成します。  
+  
+## パブリック非同期イベントおよびデリゲートの定義  
+ コンポーネントは、イベントを使用してクライアントと通信します。  *MethodName*`Completed` イベントは、非同期タスクの完了にクライアントに表示され、*MethodName*`ProgressChanged` イベントは、非同期タスクの進行状況をクライアントに通知します。  
+  
+#### コンポーネントのクライアントの非同期イベントを定義するには  
+  
+1.  <xref:System.Threading?displayProperty=fullName> および <xref:System.Collections.Specialized?displayProperty=fullName> 名前空間をファイルの先頭にインポートします。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#11](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#11)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#11](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#11)]  
+  
+2.  `PrimeNumberCalculator`  クラスの定義の前に、進行状況および完了のイベントのデリゲートを宣言します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#7](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#7)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#7](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#7)]  
+  
+3.  `PrimeNumberCalculator`  クラスの定義の前に、進行状況および完了をクライアントにレポートするイベントを宣言します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#8](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#8)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#8](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#8)]  
+  
+4.  `PrimeNumberCalculator`  クラスの定義の後に、 `CalculatePrimeCompletedEventArgs`  クラスを派生させて、各計算の結果を `CalculatePrimeCompleted`.event のクライアントのイベント ハンドラーにレポートします。  `AsyncCompletedEventArgs` プロパティに加えて、このクラスにより、クライアントはどの数値がテストされたのか、素数かどうか、素数でない場合は最初の除数は何かを判断できます。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#6](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#6)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#6](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#6)]  
+  
+## チェックポイント  
+ この時点で、コンポーネントをビルドできます。  
+  
+#### コンポーネントをテストするには  
+  
+-   コンポーネントをコンパイルします。  
+  
+     次の 2 つのコンパイラの警告が表示されます。  
+  
+    ```  
+    warning CS0067: The event 'AsynchronousPatternExample.PrimeNumberCalculator.ProgressChanged' is never used  
+    warning CS0067: The event 'AsynchronousPatternExample.PrimeNumberCalculator.CalculatePrimeCompleted' is never used  
+    ```  
+  
+     これらの警告は、次のセクションでは消去されます。  
+  
+## プライベート デリゲートの定義  
+ `PrimeNumberCalculator`  コンポーネントの非同期的な側面は、<xref:System.Threading.SendOrPostCallback> と呼ばれる特別なデリゲートと共に、内部的に実装されます。  <xref:System.Threading.SendOrPostCallback> はコールバック メソッドを表し、<xref:System.Threading.ThreadPool> スレッドで実行されます。  コールバック メソッドには、型 <xref:System.Object> の単一のパラメーターを受け取るシグネチャが必要です。つまり、デリゲート間の状態をラッパー クラスに渡す必要があります。  詳細については、「<xref:System.Threading.SendOrPostCallback>」を参照してください。  
+  
+#### コンポーネントの内部的な非同期動作を実装するには  
+  
+1.  `PrimeNumberCalculator`  クラス内に <xref:System.Threading.SendOrPostCallback> デリゲートを宣言および作成します。   `InitializeDelegates` という名前のユーティリティ メソッド内に、<xref:System.Threading.SendOrPostCallback> オブジェクトを作成します。  
+  
+     クライアントに進行状況を報告するためと、クライアントに完了を報告するための 2 つのデリゲートが必要です。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#9](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#9)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#9](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#9)]  
+    [!code-csharp[System.ComponentModel.AsyncOperationManager#20](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#20)]
+    [!code-vb[System.ComponentModel.AsyncOperationManager#20](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#20)]  
+  
+2.  コンポーネントのコンストラクター内で `InitializeDelegates` メソッドを呼び出します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#21](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#21)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#21](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#21)]  
+  
+3.  `PrimeNumberCalculator` クラス内で、非同期的に行われる実際の作業を処理するデリゲートを宣言します。  このデリゲートは、数値が素数かどうかをテストするワーカー メソッドをラップします。  デリゲートは <xref:System.ComponentModel.AsyncOperation> パラメーターを受け取ります。これは、非同期操作の有効期間を追跡するのに使用されます。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#22](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#22)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#22](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#22)]  
+  
+4.  保留中の非同期操作の有効期間を管理するコレクションを作成します。  クライアントには、実行時および完了時に操作を追跡する手段が必要です。クライアントが非同期メソッドを呼び出したときに、クライアントに一意なトークン \(タスク ID\) を渡すように要求することによって、この追跡を行います。  `PrimeNumberCalculator` コンポーネントは、タスク ID を対応する呼び出しに関連付けて、各呼び出しを追跡する必要があります。  クライアントから一意ではないタスク ID が渡された場合は、`PrimeNumberCalculator` コンポーネントで例外を発生させる必要があります。  
+  
+     `PrimeNumberCalculator` コンポーネントは、<xref:System.Collections.Specialized.HybridDictionary> と呼ばれる特別なコレクション クラスを使用して、タスク ID を追跡します。  クラス定義内で、 `userTokenToLifetime` という名前の <xref:System.Collections.Specialized.HybridDictionary> を作成します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#23](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#23)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#23](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#23)]  
+  
+## パブリック イベントの実装  
+ イベント ベースの非同期パターンを実装するコンポーネントは、イベントを使用してクライアントと通信します。  これらのイベントは、<xref:System.ComponentModel.AsyncOperation> クラスのおかげで、適切なスレッドで呼び出されます。  
+  
+#### コンポーネントのクライアントに対してイベントを発生させるには  
+  
+1.  クライアントにレポートするために、パブリック イベントを実装します。  進行状況をレポートするためのイベントと、完了をレポートするためのイベントが必要です。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#24](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#24)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#24](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#24)]  
+  
+## 完了メソッドの実装  
+ 完了デリゲートとは、非同期操作が正常な完了、エラー、またはキャンセルによって終了したときに、基になるフリースレッドの非同期動作を呼び出すメソッドです。  この呼び出しは任意のスレッドで発生します。  
+  
+ このメソッドでは、一意なクライアント トークンの内部コレクションからクライアントのタスク ID を削除します。  また、このメソッドは、対応する <xref:System.ComponentModel.AsyncOperation> で <xref:System.ComponentModel.AsyncOperation.PostOperationCompleted%2A> メソッドを呼び出すことにより、特定の非同期操作の有効期間を終了します。  この呼び出しにより、アプリケーション モデルに適したスレッドで完了イベントが発生します。  <xref:System.ComponentModel.AsyncOperation.PostOperationCompleted%2A> メソッドが呼び出された後、<xref:System.ComponentModel.AsyncOperation> のこのインスタンスは使用できなくなります。これ以降、これを使用しようとすると、例外がスローされます。  
+  
+ `CompletionMethod` シグネチャには、非同期操作の結果を記述するために必要なすべての状態が格納されている必要があります。  これには、この特定の非同期操作によってテストされた数値と、数値が素数かどうか、素数でない場合はその最初の除数の値の状態が格納されます。  また、発生した例外と、この特定のタスクに対応する <xref:System.ComponentModel.AsyncOperation> を示す状態も格納されます。  
+  
+#### 非同期操作を完了するには  
+  
+-   完了メソッドを実装します。  6 つのパラメーターを受け取ります。これらを使用して  `CalculatePrimeCompletedEventArgs` が作成され、クライアントの  `CalculatePrimeCompletedEventHandler` を介してクライアントに返されます。  クライアントのタスク ID トークンを内部コレクションから削除し、<xref:System.ComponentModel.AsyncOperation.PostOperationCompleted%2A> の呼び出しにより、非同期操作の有効期間を終了します。  <xref:System.ComponentModel.AsyncOperation> は、アプリケーション モデルに適したスレッドまたはコンテキストの呼び出しをマーシャリングします。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#26](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#26)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#26](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#26)]  
+  
+## チェックポイント  
+ この時点で、コンポーネントをビルドできます。  
+  
+#### コンポーネントをテストするには  
+  
+-   コンポーネントをコンパイルします。  
+  
+     次のコンパイラの警告が表示されます。  
+  
+    ```  
+    warning CS0169: The private field 'AsynchronousPatternExample.PrimeNumberCalculator.workerDelegate' is never used  
+    ```  
+  
+     この警告は、次のセクションでは解決されます。  
+  
+## ワーカー メソッドの実装  
+ ここまでで、`PrimeNumberCalculator` コンポーネントをサポートしている非同期コードを実装しました。  次に、実際の作業を行うコードを実装します。  `CalculateWorker`、 `BuildPrimeNumberList`、`IsPrime` の 3 つのメソッドを実装します。  `BuildPrimeNumberList` と `IsPrime` は、エラトステネスのふるいと呼ばれる有名なアルゴリズムを構成します。このアルゴリズムは、テスト数値の平方根まですべての素数を検索して、数値が素数かどうかを調べます。  その時点で除数が見つからない場合、そのテスト数値は素数です。  
+  
+ 効率を最大限に高めるためにこのコンポーネントが記述されている場合は、異なるテスト数値のさまざまな呼び出しによって検出されたすべての素数を記憶します。  また、2、3、5 などの単純な除数もチェックします。  この例の目的は、時間のかかる操作を非同期的に実行する方法を示すことですが、練習用にこれらの最適化も残しておきます。  
+  
+ `CalculateWorker` メソッドはデリゲート内にラップされており、`BeginInvoke` の呼び出しによって非同期的に呼び出されます。  
+  
+> [!NOTE]
+>  進行状況の報告は、`BuildPrimeNumberList` メソッドによって実装されます。  高速のコンピューターでは、`ProgressChanged` イベントがすばやく連続して発生する場合があります。  こうしたイベントが発生するクライアント スレッドでは、この状況に対応できる必要があります。  ユーザー インターフェイス コードにメッセージがあふれて処理が追いつかなくなり、ハングする可能性があります。  この状況に対応するユーザー インターフェイス例については、「[How to: Implement a Client of the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+#### 素数の計算を非同期的に実行するには  
+  
+1.  `TaskCanceled` ユーティリティ メソッドを実装します。  これにより、指定したタスク ID のタスクの有効期間コレクションがチェックされ、タスク ID が見つからなかった場合は、`true` が返されます。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#32](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#32)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#32](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#32)]  
+  
+2.  `CalculateWorker` メソッドを実装します。  2 つのパラメーターを受け取ります。テストする数値および <xref:System.ComponentModel.AsyncOperation> です。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#27](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#27)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#27](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#27)]  
+  
+3.  `BuildPrimeNumberList` を実装します。  2 つのパラメーターを受け取ります。テストする数値と <xref:System.ComponentModel.AsyncOperation> です。  <xref:System.ComponentModel.AsyncOperation> を使用して、進行状況およびインクリメンタル結果をレポートします。  これにより、クライアントのイベント ハンドラーが、アプリケーション モデルに適したスレッドまたはコンテキストで呼び出されるようになります。  `BuildPrimeNumberList` は素数を検出すると、これをインクリメンタル結果として、`ProgressChanged` イベントのクライアントのイベント ハンドラーにレポートします。  これには、<xref:System.ComponentModel.ProgressChangedEventArgs> から派生した `CalculatePrimeProgressChangedEventArgs` と呼ばれるクラスが必要です。このクラスには、`LatestPrimeNumber` と呼ばれる追加されたプロパティが 1 つあります。  
+  
+     また、`BuildPrimeNumberList` メソッドは、定期的に `TaskCanceled` メソッドを呼び出し、`true` が返されると終了します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#5)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#5)]  
+  
+4.  `IsPrime` を実装します。  3 つのパラメーターを受け取ります。既知の素数のリスト、テストする数値、および見つかった最初の除数の出力パラメーターです。  素数のリストを指定すると、テスト数値が素数かどうかを確認します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#28](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#28)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#28](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#28)]  
+  
+5.  `CalculatePrimeProgressChangedEventArgs` を <xref:System.ComponentModel.ProgressChangedEventArgs> から派生させます。  このクラスは、`ProgressChanged` イベントのクライアントのイベント ハンドラーに、インクリメンタル結果をレポートするために必要です。  `LatestPrimeNumber` という名前の追加されたプロパティが 1 つあります。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#29](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#29)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#29](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#29)]  
+  
+## チェックポイント  
+ この時点で、コンポーネントをビルドできます。  
+  
+#### コンポーネントをテストするには  
+  
+-   コンポーネントをコンパイルします。  
+  
+     この他に記述する必要があるものは、非同期操作を開始およびキャンセルするためのメソッド \(`CalculatePrimeAsync` および `CancelAsync`\) です。  
+  
+## 開始およびキャンセル メソッドの実装  
+ ワーカー スレッドを独自のスレッドで開始するには、それをラップしているデリゲートで `BeginInvoke` を呼び出します。  特定の非同期操作の有効期間を管理するには、<xref:System.ComponentModel.AsyncOperationManager> ヘルパー クラスで <xref:System.ComponentModel.AsyncOperationManager.CreateOperation%2A> メソッドを呼び出します。  こうすると <xref:System.ComponentModel.AsyncOperation> が返され、適切なスレッドまたはコンテキストへのクライアントのイベント ハンドラーの呼び出しがマーシャリングされます。  
+  
+ 特定の保留中の操作をキャンセルするには、<xref:System.ComponentModel.AsyncOperation.PostOperationCompleted%2A> を対応する <xref:System.ComponentModel.AsyncOperation> で呼び出します。  こうするとその操作が終了し、これ以降その <xref:System.ComponentModel.AsyncOperation> を呼び出すと例外がスローされます。  
+  
+#### 開始およびキャンセル機能を実装するには  
+  
+1.  `CalculatePrimeAsync` メソッドを実装します。  クライアントによって提供されたトークン \(タスク ID\) が、現在保留中のタスクを表すすべてのタスクから見て一意であることを確認します。  クライアントから一意ではないトークンが渡された場合は、`CalculatePrimeAsync` は例外を発生させます。  それ以外の場合は、トークンがタスク ID のコレクションに追加されます。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#3)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#3)]  
+  
+2.  `CancelAsync` メソッドを実装します。  トークン コレクションに `taskId` パラメーターが存在する場合は、削除されます。  これにより、起動されていないキャンセル済みタスクが実行されるのを防止します。  タスクが実行中の場合は、そのタスク ID が有効期間コレクションから削除されたことを `BuildPrimeNumberList` メソッドが検出すると、メソッドは終了します。  
+  
+     [!code-csharp[System.ComponentModel.AsyncOperationManager#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#4)]
+     [!code-vb[System.ComponentModel.AsyncOperationManager#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#4)]  
+  
+## チェックポイント  
+ この時点で、コンポーネントをビルドできます。  
+  
+#### コンポーネントをテストするには  
+  
+-   コンポーネントをコンパイルします。  
+  
+ `PrimeNumberCalculator`  コンポーネントがコンパイルされ、使用できるようになります。  
+  
+ `PrimeNumberCalculator` コンポーネントを使用するクライアントの例については、「[How to: Implement a Client of the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md)」を参照してください。  
+  
+## 次の手順  
+ この例に入力するには、`CalculatePrimeAsync` メソッドの同期用である `CalculatePrime` を記述します。  こうすると、`PrimeNumberCalculator` コンポーネントがイベント ベースの非同期パターンに完全に準拠します。  
+  
+ この例を改善するには、異なるテスト数値のさまざまな呼び出しによって検出された、すべての素数のリストを保持します。  この方法を使用すると、以前のタスクで行われた作業が各タスクに役立ちます。  このリストを `lock` 領域で保護する際には注意が必要です。異なるスレッドによるリストへのアクセスはシリアル化されます。  
+  
+ 2、3、5 などの単純な除数をテストしても、この例を改善できます。  
+  
+## 参照  
+ [方法 : バックグラウンドで操作を実行する](../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)   
+ [NOT IN BUILD: Multithreading in Visual Basic](http://msdn.microsoft.com/ja-jp/c731a50c-09c1-4468-9646-54c86b75d269)   
+ [How to: Implement a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)   
+ [Multithreaded Programming with the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..6766af8bd14
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md
@@ -0,0 +1,880 @@
+---
+title: "Consuming the Task-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, and TAP"
+  - "asynchronous design patterns, .NET Framework"
+  - "TAP, .NET Framework support for"
+  - "Task-based Asynchronous Pattern, .NET Framework support for"
+  - ".NET Framework, asynchronous design patterns"
+ms.assetid: 033cf871-ae24-433d-8939-7a3793e547bf
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Consuming the Task-based Asynchronous Pattern
+タスク ベースの非同期パターン \(TAP\) を使用して非同期操作を行うと、コールバックを使用して、ブロックすることなく待機できます。タスクの場合、<xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> などのメソッドを使用してこれを行うことができます。  言語ベースの非同期サポートが、通常の制御フロー内での非同期操作の待機を許可することで、コールバックを隠し、コンパイラにより生成されたコードはこの同じ API レベルのサポートを提供します。  
+  
+## Await を使って実行を中断する  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、C\# の [await](../Topic/await%20\(C%23%20Reference\).md) キーワードおよび Visual Basic の [Await Operator](../Topic/Await%20Operator%20\(Visual%20Basic\).md) を使って <xref:System.Threading.Tasks.Task> オブジェクトおよび <xref:System.Threading.Tasks.Task%601> オブジェクトを非同期に待機できます。  <xref:System.Threading.Tasks.Task> を待機しているとき、`await` 式の型は `void` です。  <xref:System.Threading.Tasks.Task%601> を待機しているとき、`await` 式の型は `TResult` です。  `await` 式は、非同期メソッドの本体内に含める必要があります。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] における C\# および Visual Basic の言語サポートの詳細については、C\# および Visual Basic の言語仕様を参照してください。  
+  
+ 待機機能は、隠れた状態で継続を使用してタスクにコールバックをインストールします。このコールバックは中断ポイントから非同期メソッドを再開します。  非同期メソッドが再開され、待機していた操作が正常に完了し、<xref:System.Threading.Tasks.Task%601> であった場合に、その `TResult` が返されます。待機していた <xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> が <xref:System.Threading.Tasks.TaskStatus> 状態になった場合は、<xref:System.OperationCanceledException> 例外がスローされます。待機していた <xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> が <xref:System.Threading.Tasks.TaskStatus> 状態になった場合は、エラーの原因になった例外がスローされます。  `Task` は複数の例外の結果としてエラーになることがありますが、反映されるのはこれらの例外の中の 1 つのみです。  ただし、<xref:System.Threading.Tasks.Task.Exception%2A?displayProperty=fullName> プロパティに、すべてのエラーを含む <xref:System.AggregateException> 例外が返されます。  
+  
+ 同期コンテキスト \(<xref:System.Threading.SynchronizationContext> オブジェクト\) が中断時点で非同期メソッドを実行していたスレッドに関連付けられている場合 \(たとえば、<xref:System.Threading.SynchronizationContext.Current%2A?displayProperty=fullName> プロパティが `null` でない場合\)、そのコンテキストの <xref:System.Threading.SynchronizationContext.Post%2A> メソッドを使用して、非同期メソッドが同じ同期コンテキスト上で再開されます。  それ以外の場合は、中断時に実行されていたタスク スケジューラ \(<xref:System.Threading.Tasks.TaskScheduler> オブジェクト\) に基づきます。  通常、これはスレッド プールをターゲットとする既定のタスク スケジューラ \(<xref:System.Threading.Tasks.TaskScheduler.Default%2A?displayProperty=fullName>\) です。  このタスク スケジューラによって、待機していた非同期操作が完了した場合に再開するかどうか、または再開のスケジュールを設定するかどうかが決定されます。  既定のスケジューラは、通常、待機していた操作が完了したスレッド上での実行の継続を許可します。  
+  
+ 非同期メソッドが呼び出された場合、まだ完了していない待機可能なインスタンスの最初の await 式まで、関数の本体を同期をとって実行し、この時点で呼び出しを呼び出し元に返します。  非同期メソッドが `void` を返さない場合、進行中の計算を表すために、<xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> オブジェクトが返されます。  void 以外の非同期メソッドでは、return ステートメントが検出された場合、またはメソッド本体の末尾に到達した場合、タスクが <xref:System.Threading.Tasks.TaskStatus> の終了状態で完了します。  ハンドルされない例外により、非同期メソッドの本体から制御が離れた場合、タスクは <xref:System.Threading.Tasks.TaskStatus> 状態になります。  その例外が <xref:System.OperationCanceledException> の場合、タスクは <xref:System.Threading.Tasks.TaskStatus> 状態になります。  この方法では、結果または例外が最終的に発行されます。  
+  
+ この動作には、いくつかの重要なバリエーションがあります。タスクが待機になる前に既に完了していた場合は、パフォーマンス上の理由から、制御が明け渡されず、関数が実行を継続します。また、元のコンテキストに戻ることが必ずしも望ましい動作ではない場合は変更されることがあります。これは、次のセクションで詳しく説明します。  
+  
+### Yield と ConfigureAwait を使って中断と再開を構成する  
+ 一部のメソッドでは、非同期メソッドの実行をより詳細に制御できます。  たとえば、<xref:System.Threading.Tasks.Task.Yield%2A?displayProperty=fullName> メソッドを使用して非同期メソッドに明け渡しポイントを導入できます。  
+  
+```csharp  
+public class Task : …  
+{  
+    public static YieldAwaitable Yield();  
+    …  
+}  
+  
+```  
+  
+ これは、非同期にポストするか、現在のコンテキストにスケジュールを戻すことと同じです。  
+  
+```csharp  
+Task.Run(async  delegate  
+{  
+    for(int i=0; i<1000000; i++)  
+    {  
+        await Task.Yield(); // fork the continuation into a separate work item  
+        ...  
+    }  
+});  
+  
+```  
+  
+ また、非同期メソッドで中断と再開をより詳細に制御するため <xref:System.Threading.Tasks.Task.ConfigureAwait%2A?displayProperty=fullName> メソッドも使用できます。再開時に非同期メソッドの継続を呼び出すために非同期メソッドが中断され、そのキャプチャされたのコンテキストが使用されている場合、既定では、現在のコンテキストを既に説明したようにキャプチャされます。これは、多くの場合に求められる動作です。その他の場合では、継続のコンテキストが重要でないこともあり、元のコンテキストへのポスト バックを回避することでパフォーマンスを向上できます。このためには、<xref:System.Threading.Tasks.Task.ConfigureAwait%2A?displayProperty=fullName> メソッドを使用して、待機操作にコンテキストをキャプチャして再開するのではなく、待機していた非同期操作がどこで完了したかを問わず、実行を継続するように指示できます。  
+  
+```csharp  
+await someTask.ConfigureAwait(continueOnCapturedContext:false);  
+  
+```  
+  
+## 非同期操作を取り消す  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、取り消しをサポートする TAP メソッドは、キャンセル トークン \(<xref:System.Threading.CancellationToken> オブジェクト\) を受け取るオーバーロードを少なくとも 1 つ用意します。  
+  
+ キャンセル トークンは、キャンセル トークンのソース \(<xref:System.Threading.CancellationTokenSource> オブジェクト\) によって作成されます。ソースの <xref:System.Threading.CancellationTokenSource.Token%2A> プロパティは、ソースの <xref:System.Threading.CancellationTokenSource.Cancel%2A> メソッドが呼び出されたときに通知されるキャンセル トークンを返します。たとえば、単一の Web ページをダウンロードする際に操作を取り消せるようにする場合は、<xref:System.Threading.CancellationTokenSource> オブジェクトを作成し、TAP メソッドにそのオブジェクトのトークンを渡し、操作を取り消す準備ができたらソースの <xref:System.Threading.CancellationTokenSource.Cancel%2A> メソッドを呼び出します。  
+  
+```csharp  
+var cts = new CancellationTokenSource();  
+string result = await DownloadStringAsync(url, cts.Token);  
+… // at some point later, potentially on another thread  
+cts.Cancel();  
+  
+```  
+  
+ 複数の非同期呼び出しを取り消す場合は、すべての呼び出しに同じトークンを渡すことができます。  
+  
+```csharp  
+var cts = new CancellationTokenSource();  
+    IList<string> results = await Task.WhenAll(from url in urls select DownloadStringAsync(url, cts.Token));  
+    // at some point later, potentially on another thread  
+    …  
+    cts.Cancel();  
+  
+```  
+  
+ または、操作の一部を選択して同じトークンを渡すこともできます。  
+  
+```csharp  
+var cts = new CancellationTokenSource();  
+    byte [] data = await DownloadDataAsync(url, cts.Token);  
+    await SaveToDiskAsync(outputPath, data, CancellationToken.None);  
+    … // at some point later, potentially on another thread  
+    cts.Cancel();  
+  
+```  
+  
+ 取り消し要求は任意のスレッドから開始することができます。  
+  
+ 取り消しが要求されないことを示すために、キャンセル トークンを受け取るすべてのメソッドに <xref:System.Threading.CancellationToken.None%2A?displayProperty=fullName> 値を渡すことができます。これにより、<xref:System.Threading.CancellationToken.CanBeCanceled%2A?displayProperty=fullName> プロパティから `false` が返され、呼び出し先のメソッドはそれに応じて最適化できます。テストのためには、トークンが既に取り消された状態か取り消し不可能な状態で開始するかどうかを示すブール値を受け取るコンストラクターを使用してインスタンス化した、事前に取り消されたキャンセル トークンを渡すこともできます。  
+  
+ この取り消し方法には、いくつか利点があります。  
+  
+-   同じキャンセル トークンを、任意の数の同期操作および非同期操作に渡すことができます。  
+  
+-   同じ取り消し要求を、任意の数のリスナーに渡すことができます。  
+  
+-   取り消しが要求されるかどうか、およびそれがいつ実行されるかは、非同期 API の開発者が完全に制御します。  
+  
+-   API を使用するコードにより、取り消し要求が反映される非同期呼び出しが選択され決定されます。  
+  
+## 進行状況の監視  
+ 一部の非同期メソッドは、非同期メソッドに渡される進行状況インターフェイスを通じて進行状況を公開します。たとえば、テキスト文字列を非同期的にダウンロードし、その過程で完了したダウンロードの割合を含む進行状況の更新を発生する関数があるとします。このようなメソッドは、Windows Presentation Foundation \(WPF\) アプリケーションでは次のように使用できます。  
+  
+```csharp  
+private async  void btnDownload_Click(object sender, RoutedEventArgs e)    
+{  
+    btnDownload.IsEnabled = false;  
+    try  
+    {  
+        txtResult.Text = await DownloadStringAsync(txtUrl.Text,   
+            new Progress<int>(p => pbDownloadProgress.Value = p));  
+    }  
+    finally { btnDownload.IsEnabled = true; }  
+}  
+  
+```  
+  
+<a name="combinators"></a>   
+## タスク ベースの組み込み連結子の使用  
+ <xref:System.Threading.Tasks> 名前空間には、タスクを構成および使用するための複数のメソッドがあります。  
+  
+### Task.Run  
+ <xref:System.Threading.Tasks.Task> クラスには <xref:System.Threading.Tasks.Task.Run%2A> メソッドが複数含まれ、たとえば次のように、スレッド プールへの <xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> として作業を簡単にオフロードできるようにします。  
+  
+```csharp  
+public async  void button1_Click(object sender, EventArgs e)  
+{  
+    textBox1.Text = await Task.Run(() =>  
+    {  
+        // … do compute-bound work here  
+        return answer;  
+    });  
+}  
+  
+```  
+  
+ <xref:System.Threading.Tasks.Task.Run%28System.Func%7BSystem.Threading.Tasks.Task%7D%29?displayProperty=fullName> オーバーロードなどの、これらの <xref:System.Threading.Tasks.Task.Run%2A> メソッドの一部は、<xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドの短縮形として提供されています。<xref:System.Threading.Tasks.Task.Run%28System.Func%7BSystem.Threading.Tasks.Task%7D%29?displayProperty=fullName> などの他のオーバーロードでは、次の例のように、オフロードされた作業内で await を使用できるようにします。  
+  
+```csharp  
+public async  void button1_Click(object sender, EventArgs e)  
+{  
+    pictureBox1.Image = await Task.Run(async() =>  
+    {  
+        using(Bitmap bmp1 = await DownloadFirstImageAsync())  
+        using(Bitmap bmp2 = await DownloadSecondImageAsync())  
+        return Mashup(bmp1, bmp2);  
+    });  
+}  
+```  
+  
+ このようなオーバーロードは、タスク並列ライブラリの <xref:System.Threading.Tasks.TaskExtensions.Unwrap%2A> 拡張メソッドと共に <xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドを使用することと論理的に同じです。  
+  
+### Task.FromResult  
+ データが既に利用でき、単に <xref:System.Threading.Tasks.Task%601> にリフトされたタスクを返すメソッドから返す必要があるシナリオでは、<xref:System.Threading.Tasks.Task.FromResult%2A> メソッドを使用できます。  
+  
+```csharp  
+public Task<int> GetValueAsync(string key)  
+{  
+    int cachedValue;  
+    return TryGetCachedValue(out cachedValue) ?  
+        Task.FromResult(cachedValue) :  
+        GetValueAsyncInternal();  
+}  
+  
+private async  Task<int> GetValueAsyncInternal(string key)  
+{  
+    …  
+}  
+  
+```  
+  
+### Task.WhenAll  
+ <xref:System.Threading.Tasks.Task.WhenAll%2A> メソッドは、タスクとして表される複数の非同期操作で非同期に待機するために使用されます。メソッドには、一連の非ジェネリック タスクまたは不均一な一連のジェネリック タスク \(複数の void を返す操作を非同期に待機したり、各値の型が異なる複数の値を返すメソッドを非同期に待機するなど\) に加えて、均一な一連のジェネリック タスク \(複数の `TResult` を返すメソッドを非同期に待機するなど\) をサポートする複数のオーバーロードが含まれます。  
+  
+ 複数の顧客に電子メール メッセージを送信するとします。  このような場合、1 つのメッセージの送信完了を待たずに次のメッセージを送信するような、メッセージのオーバーラップ送信が可能です。  送信操作がいつ完了したか、またエラーが発生したかを確認することもできます。  
+  
+```csharp  
+IEnumerable<Task> asyncOps = from addr in addrs select SendMailAsync(addr);  
+await Task.WhenAll(asyncOps);  
+  
+```  
+  
+ このコードは発生する可能性がある例外を明示的に処理せず、<xref:System.Threading.Tasks.Task.WhenAll%2A> の結果のタスクの `await` から例外を反映します。例外を処理するには、次のようなコードを使用できます。  
+  
+```csharp  
+IEnumerable<Task> asyncOps = from addr in addrs select SendMailAsync(addr);  
+try  
+{  
+    await Task.WhenAll(asyncOps);  
+}  
+catch(Exception exc)  
+{  
+    ...  
+}  
+  
+```  
+  
+ この例では、非同期操作のいずれかが失敗した場合、すべての例外が <xref:System.AggregateException> 例外に統合され <xref:System.Threading.Tasks.Task.WhenAll%2A> メソッドから返された <xref:System.Threading.Tasks.Task> に格納されます。ただし、これらの例外の 1 つだけが `await` キーワードによって反映されます。すべての例外を調べる場合は、上記のコードを次のように書き直します。  
+  
+```csharp  
+Task [] asyncOps = (from addr in addrs select SendMailAsync(addr)).ToArray();  
+try  
+{  
+    await Task.WhenAll(asyncOps);  
+}  
+catch(Exception exc)  
+{  
+    foreach(Task faulted in asyncOps.Where(t => t.IsFaulted))  
+    {  
+        … // work with faulted and faulted.Exception  
+    }  
+}  
+  
+```  
+  
+ Web から複数のファイルを非同期にダウンロードする例を考えてみます。この場合、すべての非同期操作の結果の型が同種で、結果に簡単にアクセスできます。  
+  
+```csharp  
+string [] pages = await Task.WhenAll(  
+    from url in urls select DownloadStringAsync(url));  
+```  
+  
+ 前の void を返す場合で説明したのと同じ例外処理手法を使用できます。  
+  
+```csharp  
+Task [] asyncOps =   
+    (from url in urls select DownloadStringAsync(url)).ToArray();  
+try  
+{  
+    string [] pages = await Task.WhenAll(asyncOps);  
+    ...  
+}  
+catch(Exception exc)  
+{  
+    foreach(Task<string> faulted in asyncOps.Where(t => t.IsFaulted))  
+    {  
+        … // work with faulted and faulted.Exception  
+    }  
+}  
+  
+```  
+  
+### Task.WhenAny  
+ <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使用して、完了するタスクとして表される複数の非同期操作の 1 つのみを非同期に待機できます。このメソッドは、次の 4 つの主なユース ケースで役立ちます。  
+  
+-   冗長性:  操作を複数回実行し、最初に完了した 1 を選択し \(たとえば、一つの結果と最速の完了する\) 1 を選択して値を生成する複数の Web サービスに問い合わせてください。  
+  
+-   インタリーブ:  複数の操作を起動し、待機しますが、処理が完了するまで、あらゆるものを完了します。  
+  
+-   スロットリングする場合:  他のユーザーとして追加操作の開始を許可操作が完了します。これは、インタリーブのシナリオの拡張版です。  
+  
+-   初期のエスケープ:  たとえば、タスク t1 によって表される別のタスク t2 との操作は <xref:System.Threading.Tasks.Task.WhenAny%2A> タスクにグループ化し、<xref:System.Threading.Tasks.Task.WhenAny%2A> タスクで待機できます。  タスク t2 は、タイムアウトか取り消し、または <xref:System.Threading.Tasks.Task.WhenAny%2A> タスクを t1 の前に完了するようなその他のシグナルを表す場合があります。  
+  
+#### 冗長性  
+ 株式を購入するかどうかの決断を行うとします。信頼できるいくつかの株式推薦 Web サービスがありますが、日常的な負荷によっては、時に応じて各サービスがかなり遅くなることがあります。いずれかの操作が完了したときに通知を受け取るには <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使用できます。  
+  
+```csharp  
+var recommendations = new List<Task<bool>>()   
+{   
+    GetBuyRecommendation1Async(symbol),   
+    GetBuyRecommendation2Async(symbol),  
+    GetBuyRecommendation3Async(symbol)  
+};  
+Task<bool> recommendation = await Task.WhenAny(recommendations);  
+if (await recommendation) BuyStock(symbol);  
+  
+```  
+  
+ 正常に完了したすべてのタスクの結果をラップしないで返す <xref:System.Threading.Tasks.Task.WhenAll%2A> とは異なり、<xref:System.Threading.Tasks.Task.WhenAny%2A> は完了したタスクを返します。  タスクが失敗した場合は、そのタスクが失敗したことを把握することが重要です。タスクが成功した場合は、戻り値が関連付けられているタスクを把握することが重要です。この例で示すように、返されたタスクの結果にアクセスする必要がある場合は、引き続き待機。  
+  
+ <xref:System.Threading.Tasks.Task.WhenAll%2A> と同様に、例外に対応できるようにする必要があります。完了したタスクを受け取るので、次のように、適切に `try/catch` で囲んで、エラーが反映されて返されるタスクを待機します。  
+  
+```csharp  
+Task<bool> [] recommendations = …;  
+while(recommendations.Count > 0)  
+{   
+    Task<bool> recommendation = await Task.WhenAny(recommendations);      
+    try  
+    {  
+        if (await recommendation) BuyStock(symbol);  
+        break;  
+    }  
+    catch(WebException exc)  
+    {  
+        recommendations.Remove(recommendation);  
+    }  
+}  
+  
+```  
+  
+ さらに、最初のタスクが正常に完了しても、以降のタスクが失敗する可能性があります。この時点で、例外を処理する方法はいくつかあります。:  <xref:System.Threading.Tasks.Task.WhenAll%2A> のメソッドを使用することも、すべての例外が重要であると判断し、ことを記録する必要がある場合は、すべての開始したタスクが完了するまで待機することができます。この場合は、継続を使用してタスクが非同期に完了した時点で通知を受け取ります。  
+  
+```csharp  
+foreach(Task recommendation in recommendations)  
+{  
+    var ignored = recommendation.ContinueWith(  
+        t => { if (t.IsFaulted) Log(t.Exception); });  
+}  
+  
+```  
+  
+ または  
+  
+```csharp  
+foreach(Task recommendation in recommendations)  
+{  
+    var ignored = recommendation.ContinueWith(  
+        t => Log(t.Exception), TaskContinuationOptions.OnlyOnFaulted);  
+}  
+  
+```  
+  
+ 以下も考えられます。  
+  
+```  
+private static async  void LogCompletionIfFailed(IEnumerable<Task> tasks)  
+{  
+    foreach(var task in tasks)  
+    {  
+        try { await task; }  
+        catch(Exception exc) { Log(exc); }  
+    }  
+}  
+…  
+LogCompletionIfFailed(recommendations);  
+  
+```  
+  
+ 最後に、残りのすべての操作を取り消すこともできます。  
+  
+```csharp  
+var cts = new CancellationTokenSource();  
+var recommendations = new List<Task<bool>>()   
+{   
+    GetBuyRecommendation1Async(symbol, cts.Token),   
+    GetBuyRecommendation2Async(symbol, cts.Token),  
+    GetBuyRecommendation3Async(symbol, cts.Token)  
+};  
+  
+Task<bool> recommendation = await Task.WhenAny(recommendations);  
+cts.Cancel();  
+if (await recommendation) BuyStock(symbol);  
+  
+```  
+  
+#### インターリーブ  
+ Web からイメージをダウンロードして、各イメージを処理するとします \(イメージを UI コントロールに追加するなど\)。UI スレッドで順次処理する必要があるとしても、イメージはできるだけ同時にダウンロードすることを考えています。  また、すべてダウンロードされるまで UI へのイメージの追加を保留するのは望ましくないので、ダウンロードが完了した順に追加します。  
+  
+```csharp  
+List<Task<Bitmap>> imageTasks =   
+    (from imageUrl in urls select GetBitmapAsync(imageUrl)).ToList();  
+while(imageTasks.Count > 0)  
+{  
+    try  
+    {  
+        Task<Bitmap> imageTask = await Task.WhenAny(imageTasks);  
+        imageTasks.Remove(imageTask);  
+  
+        Bitmap image = await imageTask;  
+        panel.AddImage(image);  
+    }  
+    catch{}  
+}  
+  
+```  
+  
+ 次のように、ダウンロードしたイメージの <xref:System.Threading.ThreadPool> でコンピューター処理を集中して行うことが必要になるシナリオでも、インタリーブを適用できます。  
+  
+```csharp  
+List<Task<Bitmap>> imageTasks =   
+    (from imageUrl in urls select GetBitmapAsync(imageUrl)  
+         .ContinueWith(t => ConvertImage(t.Result)).ToList();  
+while(imageTasks.Count > 0)  
+{  
+    try  
+    {  
+        Task<Bitmap> imageTask = await Task.WhenAny(imageTasks);  
+        imageTasks.Remove(imageTask);  
+  
+        Bitmap image = await imageTask;  
+        panel.AddImage(image);  
+    }  
+    catch{}  
+}  
+  
+```  
+  
+#### 調整  
+ インタリーブの例ではユーザーが多くのイメージをダウンロードするため、このダウンロード数を絞り込み、たとえば、特定の数のダウンロードだけを同時実行する必要がある場合を考えます。  これを行うには、非同期操作のサブセットを開始します。操作が完了したら、追加操作を開始して、完了した操作に代えて実行します。  
+  
+```csharp  
+const int CONCURRENCY_LEVEL = 15;  
+Uri [] urls = …;  
+int nextIndex = 0;  
+var imageTasks = new List<Task<Bitmap>>();  
+while(nextIndex < CONCURRENCY_LEVEL && nextIndex < urls.Length)  
+{  
+    imageTasks.Add(GetBitmapAsync(urls[nextIndex]));  
+    nextIndex++;  
+}  
+  
+while(imageTasks.Count > 0)  
+{  
+    try  
+    {  
+        Task<Bitmap> imageTask = await Task.WhenAny(imageTasks);  
+        imageTasks.Remove(imageTask);  
+  
+        Bitmap image = await imageTask;  
+        panel.AddImage(image);  
+    }  
+    catch(Exception exc) { Log(exc); }  
+  
+    if (nextIndex < urls.Length)  
+    {  
+        imageTasks.Add(GetBitmapAsync(urls[nextIndex]));  
+        nextIndex++;  
+    }  
+}  
+  
+```  
+  
+#### 初期のエスケープ  
+ ユーザーの取り消し要求 \(キャンセル ボタンがクリックされたなど\) に同時に対応できるようにしながら、1 つの操作の完了を非同期に待機するとします。  このシナリオのコードを次に示します。  
+  
+```csharp  
+private CancellationTokenSource m_cts;   
+  
+public void btnCancel_Click(object sender, EventArgs e)  
+{  
+    if (m_cts != null) m_cts.Cancel();  
+}  
+  
+public async  void btnRun_Click(object sender, EventArgs e)  
+{  
+    m_cts = new CancellationTokenSource();  
+    btnRun.Enabled = false;  
+    try  
+    {  
+        Task<Bitmap> imageDownload = GetBitmapAsync(txtUrl.Text);   
+        await UntilCompletionOrCancellation(imageDownload, m_cts.Token);  
+        if (imageDownload.IsCompleted)  
+        {  
+            Bitmap image = await imageDownload;  
+            panel.AddImage(image);  
+        }  
+        else imageDownload.ContinueWith(t => Log(t));  
+    }  
+    finally { btnRun.Enabled = true; }  
+}  
+  
+private static async  Task UntilCompletionOrCancellation(  
+    Task asyncOp, CancellationToken ct)  
+{  
+    var tcs = new TaskCompletionSource<bool>();  
+    using(ct.Register(() => tcs.TrySetResult(true)))  
+        await Task.WhenAny(asyncOp, tcs.Task);  
+    return asyncOp;  
+}  
+  
+```  
+  
+ この実装は、エスケープを決めた直後にユーザー インターフェイスを再度使用できるようにしますが、基になる非同期操作は取り消しません。別の方法として、エスケープを決めたときに保留中の操作を取り消すことがありますが、取り消し要求のために途中で終了する場合など、操作が実際に完了するまでユーザー インターフェイスを再確立しません。  
+  
+```csharp  
+private CancellationTokenSource m_cts;  
+  
+public async  void btnRun_Click(object sender, EventArgs e)  
+{  
+    m_cts = new CancellationTokenSource();  
+  
+    btnRun.Enabled = false;  
+    try  
+    {  
+        Task<Bitmap> imageDownload = GetBitmapAsync(txtUrl.Text, m_cts.Token);   
+        await UntilCompletionOrCancellation(imageDownload, m_cts.Token);  
+        Bitmap image = await imageDownload;  
+        panel.AddImage(image);  
+    }  
+    catch(OperationCanceledException) {}  
+    finally { btnRun.Enabled = true; }  
+}  
+  
+```  
+  
+ 初期のエスケープの別の例は、次のセクションで説明するように <xref:System.Threading.Tasks.Task.Delay%2A> メソッドと共に <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使います。  
+  
+### Task.Delay  
+ <xref:System.Threading.Tasks.Task.Delay%2A> メソッドを使用して、非同期メソッドの実行に一時停止を導入できます。これは、ポーリング ループのビルド、あらかじめ指定された期間にわたるユーザー入力処理の遅延など、さまざまな機能に役立ちます。さらに、待機のタイムアウトを実装するために <xref:System.Threading.Tasks.Task.Delay%2A> メソッドを <xref:System.Threading.Tasks.Task.WhenAny%2A> と組み合わせて使用できます。  
+  
+ 大規模な非同期操作 \(ASP.NET Web サービスなど\) の一部を構成するタスクが完了するまで時間がかかる場合、特に操作が終了しない場合には、操作全般に影響が及びます。このため、非同期操作の待機をタイムアウトできるようにすることが重要になります。同期 <xref:System.Threading.Tasks.Task.Wait%2A> メソッド、<xref:System.Threading.Tasks.Task.%2A> WaitAll?qualifyHint=False&autoUpgrade=True メソッド、および <xref:System.Threading.Tasks.Task.%2A> WaitAny?qualifyHint=False&autoUpgrade=True メソッドはタイムアウト値を受け取りますが、対応する <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A>\/<xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドおよび前述の <xref:System.Threading.Tasks.Task.WhenAll%2A>\/<xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドはタイムアウト値を受け取りません。代わりに、<xref:System.Threading.Tasks.Task.Delay%2A> と <xref:System.Threading.Tasks.Task.WhenAny%2A> を組み合わせて使用してタイムアウトを実装することができます。  
+  
+ たとえば、UI アプリケーションで、イメージをダウンロードし、そのダウンロード中は UI を無効にするとします。  ただし、ダウンロードに時間がかかりすぎる場合には、UI を再び有効にしてダウンロードを破棄します。  
+  
+```csharp  
+public async  void btnDownload_Click(object sender, EventArgs e)  
+{  
+    btnDownload.Enabled = false;  
+    try  
+    {  
+        Task<Bitmap> download = GetBitmapAsync(url);  
+        if (download == await Task.WhenAny(download, Task.Delay(3000)))  
+        {  
+            Bitmap bmp = await download;  
+            pictureBox.Image = bmp;  
+            status.Text = “Downloaded”;  
+        }  
+        else  
+        {  
+            pictureBox.Image = null;  
+            status.Text = “Timed out”;  
+            var ignored = download.ContinueWith(  
+                t => Trace(“Task finally completed”));  
+        }  
+    }  
+    finally { btnDownload.Enabled = true; }  
+}  
+  
+```  
+  
+ <xref:System.Threading.Tasks.Task.WhenAll%2A> によりタスクが返されるため、複数のダウンロードでも同じことが当てはまります。  
+  
+```csharp  
+public async  void btnDownload_Click(object sender, RoutedEventArgs e)  
+{  
+    btnDownload.Enabled = false;  
+    try  
+    {  
+        Task<Bitmap[]> downloads =   
+            Task.WhenAll(from url in urls select GetBitmapAsync(url));  
+        if (downloads == await Task.WhenAny(downloads, Task.Delay(3000)))  
+        {  
+            foreach(var bmp in downloads) panel.AddImage(bmp);  
+            status.Text = “Downloaded”;  
+        }  
+        else  
+        {  
+            status.Text = “Timed out”;  
+            downloads.ContinueWith(t => Log(t));  
+        }  
+    }  
+    finally { btnDownload.Enabled = true; }  
+}  
+  
+```  
+  
+## タスク ベースの連結子のビルド  
+ タスクは、非同期操作を完全に表現し、操作の結合、その結果の取得などの同期機能と非同期機能を提供することができるため、大きなパターンをビルドするためのタスクの構成に使用できる有益な連結子ライブラリを構築できるようになります。前のセクションで説明したように、.NET Framework には、いくつかの組み込み連結子が用意されていますが、独自にビルドこともできます。  以下のセクションでは、可能な連結子メソッドと型の例をいくつか示します。  
+  
+### RetryOnFault  
+ 多くの状況では、前の操作が失敗した場合に再試行することが望まれます。同期コードの場合は、次の例のように `RetryOnFault` などのヘルパー メソッドをビルドしてこれを行うことができます。  
+  
+```csharp  
+public static T RetryOnFault<T>(  
+    Func<T> function, int maxTries)  
+{  
+    for(int i=0; i<maxTries; i++)  
+    {  
+        try { return function(); }  
+        catch { if (i == maxTries-1) throw; }  
+    }  
+    return default(T);  
+}  
+  
+```  
+  
+ 非同期操作の場合も、ほとんど同じヘルパー メソッドをビルドでき、TAP を使って非同期操作を実装してタスクを返します。  
+  
+```csharp  
+public static async  Task<T> RetryOnFault<T>(  
+    Func<Task<T>> function, int maxTries)  
+{  
+    for(int i=0; i<maxTries; i++)  
+    {  
+        try { return await function().ConfigureAwait(false); }  
+        catch { if (i == maxTries-1) throw; }  
+    }  
+    return default(T);  
+}  
+```  
+  
+ 次のように、この連結子を使用してアプリケーションのロジックに再試行をエンコードできます。  
+  
+```csharp  
+// Download the URL, trying up to three times in case of failure  
+string pageContents = await RetryOnFault(  
+    () => DownloadStringAsync(url), 3);  
+  
+```  
+  
+ `RetryOnFault` 関数をさらに拡張できます。  たとえば、この関数は別の `Func<Task>` を受け取り、次のように再試行のタイミングを判断するために、再試行の間に呼び出されます。  
+  
+```csharp  
+public static async  Task<T> RetryOnFault<T>(  
+    Func<Task<T>> function, int maxTries, Func<Task> retryWhen)  
+{  
+    for(int i=0; i<maxTries; i++)  
+    {  
+        try { return await function().ConfigureAwait(false); }  
+        catch { if (i == maxTries-1) throw; }  
+        await retryWhen().ConfigureAwait(false);  
+    }  
+    return default(T);  
+}  
+```  
+  
+ 次の関数を使用して、操作を再試行する前に 1 秒待機するようにできます。  
+  
+```csharp  
+// Download the URL, trying up to three times in case of failure,  
+// and delaying for a second between retries  
+string pageContents = await RetryOnFault(  
+    () => DownloadStringAsync(url), 3, () => Task.Delay(1000));  
+  
+```  
+  
+### NeedOnlyOne  
+ 操作の待機時間と成功の確率を改善するために、冗長性を活用できる場合があります。株式相場を提供するいくつかの Web サービスがあるとします。しかし、時間によって、各サービスの品質レベルと応答時間が変化します。この変動に対応するには、すべての Web サービスに要求を出し、最初の応答を取得した時点で残りの要求を取り消します。複数の操作を起動し、応答を待ち、残りの操作を取り消すというこの一般的なパターンの実装は、ヘルパー関数を実装して簡略化できます。  次の例の `NeedOnlyOne` 関数は、このシナリオを示します。  
+  
+```csharp  
+public static async  Task<T> NeedOnlyOne(  
+    params Func<CancellationToken,Task<T>> [] functions)  
+{  
+    var cts = new CancellationTokenSource();  
+    var tasks = (from function in functions  
+                 select function(cts.Token)).ToArray();  
+    var completed = await Task.WhenAny(tasks).ConfigureAwait(false);  
+    cts.Cancel();  
+    foreach(var task in tasks)   
+    {  
+        var ignored = task.ContinueWith(  
+            t => Log(t), TaskContinuationOptions.OnlyOnFaulted);  
+    }  
+    return completed;  
+}  
+```  
+  
+ この関数は次のように使用できます。  
+  
+```csharp  
+double currentPrice = await NeedOnlyOne(  
+    ct => GetCurrentPriceFromServer1Async(“msft”, ct),  
+    ct => GetCurrentPriceFromServer2Async(“msft”, ct),  
+    ct => GetCurrentPriceFromServer3Async(“msft”, ct));  
+```  
+  
+### インタリーブされた操作  
+ 多数のタスクを使用する際に、インタリーブのシナリオをサポートするために <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使用する場合、パフォーマンスの問題が発生することがあります。<xref:System.Threading.Tasks.Task.WhenAny%2A> のすべての呼び出しは、各タスクに登録されている継続になります。  タスクの数を N とすると、インタリーブ操作の有効期間に作成された O \(N2\) の継続になります。多くのタスクを使用する場合は、パフォーマンスの問題に対処 \(次の例の`Interleaved`\) を使用する場合:  
+  
+```csharp  
+static IEnumerable<Task<T>> Interleaved<T>(IEnumerable<Task<T>> tasks)  
+{  
+    var inputTasks = tasks.ToList();  
+    var sources = (from _ in Enumerable.Range(0, inputTasks.Count)   
+                   select new TaskCompletionSource<T>()).ToList();  
+    int nextTaskIndex = -1;  
+    foreach (var inputTask in inputTasks)  
+    {  
+        inputTask.ContinueWith(completed =>  
+        {  
+            var source = sources[Interlocked.Increment(ref nextTaskIndex)];  
+            if (completed.IsFaulted)   
+                source.TrySetException(completed.Exception.InnerExceptions);  
+            else if (completed.IsCanceled)   
+                source.TrySetCanceled();  
+            else   
+                source.TrySetResult(completed.Result);  
+        }, CancellationToken.None,   
+           TaskContinuationOptions.ExecuteSynchronously,   
+           TaskScheduler.Default);  
+    }  
+    return from source in sources   
+           select source.Task;  
+}  
+  
+```  
+  
+ タスクが完了すると、たとえば次のように、連結子を使用してタスクの結果を処理できます。  
+  
+```csharp  
+IEnumerable<Task<int>> tasks = ...;  
+foreach(var task in Interleaved(tasks))  
+{  
+    int result = await task;  
+    …  
+}  
+```  
+  
+### WhenAllOrFirstException  
+ 特定のスキャッター\/ギャザー シナリオでは、すべてのタスクの完了を待機することが考えられますが、そのうちの 1 つがエラーになった場合には、例外の発生時点で待機を停止することが望まれます。これは、次の例の `WhenAllOrFirstException` などの連結子メソッドを使用して実行できます。  
+  
+```csharp  
+public static Task<T[]> WhenAllOrFirstException<T>(IEnumerable<Task<T>> tasks)  
+{  
+    var inputs = tasks.ToList();  
+    var ce = new CountdownEvent(inputs.Count);  
+    var tcs = new TaskCompletionSource<T[]>();  
+  
+    Action<Task> onCompleted = (Task completed) =>  
+    {  
+        if (completed.IsFaulted)   
+            tcs.TrySetException(completed.Exception.InnerExceptions);  
+        if (ce.Signal() && !tcs.Task.IsCompleted)  
+            tcs.TrySetResult(inputs.Select(t => t.Result).ToArray());  
+    };  
+  
+    foreach (var t in inputs) t.ContinueWith(onCompleted);  
+    return tcs.Task;  
+}  
+  
+```  
+  
+## タスク ベースのデータ構造のビルド  
+ カスタム タスク ベースの連結子をビルドする機能に加えて、非同期操作の結果と、結合する必要な同期の両方を表す <xref:System.Threading.Tasks.Task> および <xref:System.Threading.Tasks.Task%601> 内にデータ構造を配置することで、非同期シナリオに使用するカスタム データ構造をビルドするための非常に強力な型になります。  
+  
+### AsyncCache  
+ タスクの重要な側面の 1 つに、タスクを待つ複数のコンシューマーに渡し、タスクに継続を登録し、その結果または例外を取得できることなどがあります \(<xref:System.Threading.Tasks.Task%601> の場合\)。このため、<xref:System.Threading.Tasks.Task> と <xref:System.Threading.Tasks.Task%601> は、非同期キャッシュ インフラストラクチャで使用するのに最適です。次に、<xref:System.Threading.Tasks.Task%601> 上にビルドした小さいながらも強力な非同期キャッシュの例を示します。  
+  
+```csharp  
+public class AsyncCache<TKey, TValue>  
+{  
+    private readonly Func<TKey, Task<TValue>> _valueFactory;  
+    private readonly ConcurrentDictionary<TKey, Lazy<Task<TValue>>> _map;  
+  
+    public AsyncCache(Func<TKey, Task<TValue>> valueFactory)  
+    {  
+        if (valueFactory == null) throw new ArgumentNullException("loader");  
+        _valueFactory = valueFactory;  
+        _map = new ConcurrentDictionary<TKey, Lazy<Task<TValue>>>();  
+    }  
+  
+    public Task<TValue> this[TKey key]  
+    {  
+        get  
+        {  
+            if (key == null) throw new ArgumentNullException("key");  
+            return _map.GetOrAdd(key, toAdd =>   
+                new Lazy<Task<TValue>>(() => _valueFactory(toAdd))).Value;  
+        }  
+    }  
+}  
+  
+```  
+  
+ [AsyncCache\<TKey、TValue\>](http://go.microsoft.com/fwlink/p/?LinkId=251941) クラス コンストラクターにはデリゲートとして `TKey` を受け取り、<xref:System.Threading.Tasks.Task%601>を返す関数を受け取ります。以前にキャッシュからアクセスした値は内部ディクショナリに格納され、`AsyncCache` によって、キャッシュに同時にアクセスしてもキーごとにタスクが 1 つしか生成されないようにします。  
+  
+ たとえば、次のようにダウンロードされた Web ページのキャッシュをビルドできます。  
+  
+```csharp  
+private AsyncCache<string,string> m_webPages =   
+    new AsyncCache<string,string>(DownloadStringAsync);  
+  
+```  
+  
+ Web ページのコンテンツが必要なときはいつでも、非同期メソッドで、このキャッシュを使用できます。  `AsyncCache` クラスは、できるだけ少ない数のページとしてダウンロードしていることを確認し、結果をキャッシュします。  
+  
+```csharp  
+private async  void btnDownload_Click(object sender, RoutedEventArgs e)   
+{  
+    btnDownload.IsEnabled = false;  
+    try  
+    {  
+        txtContents.Text = await m_webPages["http://www.microsoft.com"];  
+    }  
+    finally { btnDownload.IsEnabled = true; }  
+}  
+  
+```  
+  
+### AsyncProducerConsumerCollection  
+ タスクは、非同期アクティビティを調整するためのデータ構造のビルドにも使用できます。プロデューサー\/コンシューマーというクラシックな並列設計パターンの 1 つについて考えてみます。このパターンでは、コンシューマーによって使用されるデータをプロデューサーが生成し、プロデューサーおよびコンシューマーは並列に実行できます。  たとえば、コンシューマーは、項目 2.を生成する前に、プロデューサーが生成した項目 1 を処理します。プロデューサー\/コンシューマー パターンでは、毎回使用できるときにコンシューマーが新しいデータが利用、それを検索するようにあるデータ構造体がプロデューサーが作成した作業を保存する必要があります。  
+  
+ 次に、プロデューサーおよびコンシューマーとして使用する非同期メソッドを有効にするタスク上にビルドされた単純なデータ構造を示します。  
+  
+```csharp  
+public class AsyncProducerConsumerCollection<T>  
+{  
+    private readonly Queue<T> m_collection = new Queue<T>();  
+    private readonly Queue<TaskCompletionSource<T>> m_waiting =   
+        new Queue<TaskCompletionSource<T>>();  
+  
+    public void Add(T item)  
+    {  
+        TaskCompletionSource<T> tcs = null;  
+        lock (m_collection)  
+        {  
+            if (m_waiting.Count > 0) tcs = m_waiting.Dequeue();  
+            else m_collection.Enqueue(item);  
+        }  
+        if (tcs != null) tcs.TrySetResult(item);  
+    }  
+  
+    public Task<T> Take()  
+    {  
+        lock (m_collection)  
+        {  
+            if (m_collection.Count > 0)   
+            {  
+                return Task.FromResult(m_collection.Dequeue());   
+            }  
+            else   
+            {  
+                var tcs = new TaskCompletionSource<T>();  
+                m_waiting.Enqueue(tcs);  
+                return tcs.Task;  
+            }  
+        }  
+    }  
+}  
+  
+```  
+  
+ このデータ構造を使用すると、次のようなコードを作成できます。  
+  
+```csharp  
+private static AsyncProducerConsumerCollection<int> m_data = …;  
+…  
+private static async  Task ConsumerAsync()  
+{  
+    while(true)  
+    {  
+        int nextItem = await m_data.Take();  
+        ProcessNextItem(nextItem);  
+    }  
+}  
+…  
+private static void Produce(int data)  
+{  
+    m_data.Add(data);  
+}  
+```  
+  
+ <xref:System.Threading.Tasks.Dataflow> 名前空間には、同様の方法で使用でき、カスタム コレクション型をビルドする必要がない <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> 型が含まれています。  
+  
+```csharp  
+private static BufferBlock<int> m_data = …;  
+…  
+private static async  Task ConsumerAsync()  
+{  
+    while(true)  
+    {  
+        int nextItem = await m_data.ReceiveAsync();  
+        ProcessNextItem(nextItem);  
+    }  
+}  
+…  
+private static void Produce(int data)  
+{  
+    m_data.Post(data);  
+}  
+  
+```  
+  
+> [!NOTE]
+>  <xref:System.Threading.Tasks.Dataflow> 名前空間は、**NuGet** により [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で使用できます。  <xref:System.Threading.Tasks.Dataflow> 名前空間を含むアセンブリをインストールし、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[Manage NuGet Packages\]** \(NuGet パッケージの管理\) を選択し、Microsoft.Tpl.Dataflow パッケージをオンラインで検索します。  
+  
+## 参照  
+ [Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)   
+ [Implementing the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md)   
+ [Interop with Other Asynchronous Patterns and Types](../../../docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..d82ebd9c85f
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,95 @@
+---
+title: "Deciding When to Implement the Event-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "AsyncOperation class"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: a00046aa-785d-4f7f-a8e5-d06475ea50da
+caps.latest.revision: 8
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Deciding When to Implement the Event-based Asynchronous Pattern
+イベント ベースの非同期パターンは、クラスの非同期動作を公開するためのパターンを提供します。  このパターンを導入すると、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] は、非同期動作を公開するための 2 つのパターンを定義します。<xref:System.IAsyncResult?displayProperty=fullName> インターフェイスに基づく非同期パターンと、イベントベースのパターンです。  このトピックでは、どのような場合にこの 2 つのパターンを実装すればよいかについて説明します。  
+  
+ <xref:System.IAsyncResult> インターフェイスを使用した非同期プログラミングの詳細については、「[Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)」を参照してください。  
+  
+## 一般原則  
+ 一般に、できる限りイベントベースの非同期パターンを使用して非同期機能を公開する必要があります。  ただし、イベント ベースのパターンでは満たすことのできない要件もあります。  その場合は、イベントベースのパターンだけでなく、<xref:System.IAsyncResult> パターンも実装することが必要になることがあります。  
+  
+> [!NOTE]
+>  イベントベースのパターンを実装せずに、<xref:System.IAsyncResult> パターンだけを実装することはまれです。  
+  
+## ガイドライン  
+ イベント ベースの非同期パターンを実装する必要のある場合についてのガイドラインを次に示します。  
+  
+-   イベントベースのパターンを既定の API として使用して、クラスの非同期動作を公開します。  
+  
+-   クラスを Windows フォームなどのクライアント アプリケーションで主に使用する場合は、<xref:System.IAsyncResult> パターンを公開しないでください。  
+  
+-   要件を満たす必要がある場合にだけ、<xref:System.IAsyncResult> パターンを公開します。  たとえば、既存の API との互換性を保つために、<xref:System.IAsyncResult> パターンを公開することが必要な場合があります。  
+  
+-   イベントベースのパターンを公開せずに、<xref:System.IAsyncResult> パターンだけを公開しないでください。  
+  
+-   <xref:System.IAsyncResult> パターンを公開する必要がある場合は、高度なオプションとして公開します。  たとえば、プロキシ オブジェクトを生成する場合、<xref:System.IAsyncResult> パターンを生成するオプションと共に、既定でイベントベースのパターンを生成します。  
+  
+-   <xref:System.IAsyncResult> パターンの実装でイベントベースのパターンの実装を構築します。  
+  
+-   同じクラスでイベントベースのパターンと <xref:System.IAsyncResult> パターンの両方を公開しないようにしてください。  イベントベースのパターンは "高レベル" のクラスで公開し、<xref:System.IAsyncResult> パターンは "低レベル" のクラスで公開します。  たとえば、<xref:System.Net.WebClient> コンポーネントのイベントベースのパターンを、<xref:System.Web.HttpRequest> クラスの <xref:System.IAsyncResult> パターンと比較します。  
+  
+    -   互換性を保つために必要な場合は、イベントベースのパターンと <xref:System.IAsyncResult> パターンを同じクラスで公開します。  たとえば、<xref:System.IAsyncResult> パターンを使用する API を既にリリースしている場合、下位互換性を保つために <xref:System.IAsyncResult> パターンを保持する必要があります。  
+  
+    -   実装を分離すると結果的にオブジェクト モデルが複雑になり、複雑さが実装を分離する利点を上回る場合は、イベントベースのパターンと <xref:System.IAsyncResult> パターンを同じクラスで公開します。  イベントベースのパターンの公開を避けるよりも、単一のクラスで両方のパターンを公開する方が適切です。  
+  
+    -   イベントベースのパターンと <xref:System.IAsyncResult> パターンを単一のクラスで公開する必要がある場合、<xref:System.ComponentModel.EditorBrowsableState> に設定した <xref:System.ComponentModel.EditorBrowsableAttribute> を使用して、<xref:System.IAsyncResult> パターンの実装を高度な機能としてマークします。  これは、<xref:System.IAsyncResult> のプロパティやメソッドを表示するためではなく、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] の IntelliSense などのデザイン環境に対して示します。  これらのプロパティやメソッドも完全に使用できますが、IntelliSense を使用する開発者には API のより明瞭なビューが用意されています。  
+  
+## イベントベースのパターンに加え IAsyncResult パターンを公開する際の判断基準  
+ 前述のシナリオに基づくイベント ベースの非同期パターンには多数の利点がありますが、欠点もいくつかあります。パフォーマンスが最も重要な要件である場合は、これらの欠点を認識しておく必要があります。  
+  
+ イベントベースのパターンが <xref:System.IAsyncResult> パターンと同様には対処できない 3 つのシナリオは次のとおりです。  
+  
+-   1 つの <xref:System.IAsyncResult> での待機のブロッキング  
+  
+-   多数の <xref:System.IAsyncResult> オブジェクトでの待機のブロッキング  
+  
+-   <xref:System.IAsyncResult> での完了のポーリング  
+  
+ イベントベースのパターンを使用してこれらのシナリオに対処できますが、<xref:System.IAsyncResult> パターンを使用するよりも煩雑になります。  
+  
+ 多くの場合、開発者は一般的に高いパフォーマンス要件のサービスに対して <xref:System.IAsyncResult> パターンを使用します。  たとえば、完了のシナリオのポーリングは、高パフォーマンスのサーバーの技法です。  
+  
+ さらに、イベントベースのパターンは、作成するオブジェクト \(特に <xref:System.EventArgs>\) の数が多く、スレッド全体にわたって同期するため、<xref:System.IAsyncResult> パターンに比べ効率が下がります。  
+  
+ <xref:System.IAsyncResult> パターンを使用する場合に従う推奨事項を次に示します。  
+  
+-   <xref:System.Threading.WaitHandle> オブジェクトまたは <xref:System.IAsyncResult> オブジェクトのサポートが特に必要な場合にだけ、<xref:System.IAsyncResult> パターンを公開します。  
+  
+-   <xref:System.IAsyncResult> パターンを使用する既存の API がある場合にだけ、<xref:System.IAsyncResult> パターンを公開します。  
+  
+-   <xref:System.IAsyncResult> パターンに基づく既存の API がある場合は、次回のリリースでイベントベースのパターンも公開するよう考慮します。  
+  
+-   検証済みの高いパフォーマンス要件をイベントベースのパターンでは満たすことができず、<xref:System.IAsyncResult> パターンであれば満たすことができる場合にだけ、<xref:System.IAsyncResult> パターンを公開します。  
+  
+## 参照  
+ [Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)   
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Multithreaded Programming with the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)   
+ [Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)   
+ [イベントベースの非同期パターンを実装するための推奨される手順](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md b/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md
new file mode 100644
index 00000000000..bc7b46266cd
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md
@@ -0,0 +1,72 @@
+---
+title: "Event-based Asynchronous Pattern (EAP) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "asynchronous calls"
+  - "asynchronous programming, design patterns"
+  - "asynchronous programming"
+ms.assetid: c6baed9f-2a25-4728-9a9a-53b7b14840cf
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Event-based Asynchronous Pattern (EAP)
+非同期機能をクライアント コードに公開する方法は数多くあります。  イベント ベースの非同期パターンは、クラスが非同期動作を示す 1 つの方法を規定します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、タスク並列ライブラリによって非同期\/並列プログラミングの新しいモデルが提供されます。  詳細については、「[Parallel Programming](../../../docs/standard/parallel-programming/index.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)  
+ イベント ベースの非同期パターンによって、マルチスレッド デザイン固有の多くの複雑な問題を気にせずに、マルチスレッド アプリケーションの利点を活用できるしくみを説明します。  
+  
+ [Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)  
+ 非同期機能を持つクラスをパッケージ化するための標準的な方法について説明します。  
+  
+ [イベントベースの非同期パターンを実装するための推奨される手順](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンに従って非同期機能を公開するための要件について説明します。  
+  
+ [Deciding When to Implement the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)  
+ どのような場合に、<xref:System.IAsyncResult> パターンではなく、イベント ベースの非同期パターンの実装を選択するかを判断する方法について説明します。  
+  
+ [Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンを実装するコンポーネントの作成方法を示します。  これは、<xref:System.ComponentModel?displayProperty=fullName> 名前空間のヘルパー クラスを使用して実装します。これにより、コンポーネントは任意のアプリケーション モデルで正常に動作します。  
+  
+ [How to: Use Components That Support the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンをサポートするコンポーネントの使用方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ComponentModel.AsyncOperation>  
+ <xref:System.ComponentModel.AsyncOperation> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.ComponentModel.AsyncOperationManager>  
+ <xref:System.ComponentModel.AsyncOperationManager> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ <xref:System.ComponentModel.BackgroundWorker> コンポーネントについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 関連項目  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)  
+ 非同期操作および並列操作のプログラミング モデルについて説明します。  
+  
+ [Threading](../../../docs/standard/threading/index.md)  
+ .NET Framework のマルチスレッド機能について説明します。  
+  
+ [スレッド](../Topic/Threading%20\(C%23%20and%20Visual%20Basic\).md)  
+ C\# 言語と Visual Basic 言語のマルチスレッド機能について説明します。  
+  
+## 参照  
+ [Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)   
+ [イベント](../../../docs/standard/events/index.md)   
+ [コンポーネントのマルチスレッド](../Topic/Multithreading%20in%20Components.md)   
+ [Asynchronous Programming Design Patterns](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md b/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md
new file mode 100644
index 00000000000..f71bbc5d7ec
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md
@@ -0,0 +1,146 @@
+---
+title: "Event-based Asynchronous Pattern Overview | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "Asynchronous Pattern"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "AsyncOperation class"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: 792aa8da-918b-458e-b154-9836b97735f3
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Event-based Asynchronous Pattern Overview
+多数のタスクを同時に実行しながら、ユーザーの操作にも応答するアプリケーションには、通常、複数のスレッドを使用するデザインが必要です。  <xref:System.Threading> 名前空間は、高性能なマルチスレッド アプリケーションを作成するのに必要なすべてのツールを提供します。ただし、これらのツールを効果的に使用するには、マルチスレッド ソフトウェア エンジニアリングの豊富な経験が必要です。  比較的単純なマルチスレッド アプリケーションの場合は、<xref:System.ComponentModel.BackgroundWorker> コンポーネントが簡単なソリューションを提供します。  より高度な非同期アプリケーションの場合は、イベント ベースの非同期パターンに準拠したクラスの実装を検討してください。  
+  
+ イベント ベースの非同期パターンを使用すると、マルチスレッド デザイン固有の多くの複雑な問題を気にせずに、マルチスレッド アプリケーションの利点を活用できます。  このパターンをサポートするクラスを使用すると、次のことが可能になります。  
+  
+-   ダウンロードやデータベース操作などの時間がかかるタスクを、アプリケーションを中断せずに、"バックグラウンド" で行うことができます。  
+  
+-   複数の操作を同時に実行し、それぞれの操作が完了するたびに通知を受け取ることができます。  
+  
+-   アプリケーションを停止 \("ハングアップ"\) せずに、リソースが使用可能な状態になるまで待機できます。  
+  
+-   使い慣れたイベントおよびデリゲートのモデルを使用して、保留中の非同期操作と通信できます。  イベント ハンドラーおよびデリゲートの使い方の詳細については、「[イベント](../../../docs/standard/events/index.md)」を参照してください。  
+  
+ イベント ベースの非同期パターンをサポートするクラスには、*MethodName*`Async` という名前のメソッドが 1 つ以上含まれます。  これらのメソッドは、同期バージョンに対応するもので、現在のスレッドで同じ操作を行います。  クラスには、*MethodName*`Completed` イベントや *MethodName*`AsyncCancel` メソッド \(または単に `CancelAsync` メソッド\) が含まれる場合もあります。  
+  
+ <xref:System.Windows.Forms.PictureBox> は、イベント ベースの非同期パターンをサポートする一般的なコンポーネントです。  イメージを同期的にダウンロードするには、その <xref:System.Windows.Forms.PictureBox.Load%2A>メソッドを呼び出します。ただし、イメージのサイズが大きい場合や、ネットワークの接続速度が遅い場合は、ダウンロード操作が完了して <xref:System.Windows.Forms.PictureBox.Load%2A> の呼び出しから戻るまで、アプリケーションが停止 \("ハングアップ"\) します。  
+  
+ イメージの読み込み中にもアプリケーションを実行し続けるには、<xref:System.Windows.Forms.PictureBox.LoadAsync%2A> メソッドを呼び出して、他のイベントを処理する場合と同様に、<xref:System.Windows.Forms.PictureBox.LoadCompleted> イベントを処理します。  <xref:System.Windows.Forms.PictureBox.LoadAsync%2A> メソッドを呼び出すと、ダウンロードを別のスレッドで \("バックグラウンド" で\) 続行しながら、アプリケーションを実行し続けることができます。  イメージの読み込み操作が完了すると、イベント ハンドラーが呼び出されます。イベント ハンドラーは、<xref:System.ComponentModel.AsyncCompletedEventArgs> パラメーターを調べて、ダウンロードが正常に完了したかどうかを確認できます。  
+  
+ イベント ベースの非同期パターンでは、非同期操作をキャンセルできる必要があります。<xref:System.Windows.Forms.PictureBox> コントロールでは、その <xref:System.Windows.Forms.PictureBox.CancelAsync%2A> メソッドでこの要件をサポートしています。  <xref:System.Windows.Forms.PictureBox.CancelAsync%2A> を呼び出すと、保留中のダウンロードを停止する要求が送信されます。タスクがキャンセルされると、<xref:System.Windows.Forms.PictureBox.LoadCompleted> イベントが発生します。  
+  
+> [!CAUTION]
+>  <xref:System.Windows.Forms.PictureBox.CancelAsync%2A> 要求が作成されると同時に、ダウンロードが終了する可能性もあります。このような場合、<xref:System.ComponentModel.AsyncCompletedEventArgs.Cancelled%2A> にはキャンセルの要求が反映されません。   これは*競合状態*と呼ばれる、マルチスレッド プログラミングの一般的な問題です。  マルチスレッド プログラミングの問題の詳細については、「[Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)」を参照してください。  
+  
+## イベント ベースの非同期パターンの特性  
+ イベント ベースの非同期パターンには、特定のクラスでサポートされている操作の複雑さに応じて、複数の形式があります。  最もシンプルなクラスには、単一の *MethodName*`Async` メソッドと、このメソッドに対応する *MethodName*`Completed` イベントが含まれます。  より複雑なクラスには、複数の *MethodName*`Async` メソッドと、それぞれに対応する *MethodName*`Completed` イベント、これらのメソッドの同期バージョンが含まれます。  クラスでは、各非同期メソッドの、キャンセル、進行状況のレポート、およびインクリメンタル結果をオプションでサポートできます。  
+  
+ また、非同期メソッドでは複数の保留中の呼び出し \(複数の同時呼び出し\) をサポートして、他の保留中の操作が完了するまで、コードを何度も呼び出せるようにできます。  このような状況を適切に処理するには、アプリケーションで各操作の完了を追跡する必要があります。  
+  
+### イベント ベースの非同期パターンの例  
+ <xref:System.Media.SoundPlayer> および <xref:System.Windows.Forms.PictureBox> コンポーネントは、イベント ベースの非同期パターンのシンプルな実装です。  <xref:System.Net.WebClient> および <xref:System.ComponentModel.BackgroundWorker> コンポーネントは、イベント ベースの非同期パターンのより複雑な実装です。  
+  
+ パターンに準拠したクラス宣言の例を次に示します。  
+  
+```vb  
+Public Class AsyncExample  
+    ' Synchronous methods.  
+    Public Function Method1(ByVal param As String) As Integer   
+    Public Sub Method2(ByVal param As Double)   
+  
+    ' Asynchronous methods.  
+    Overloads Public Sub Method1Async(ByVal param As String)   
+    Overloads Public Sub Method1Async(ByVal param As String, ByVal userState As Object)   
+    Public Event Method1Completed As Method1CompletedEventHandler  
+  
+    Overloads Public Sub Method2Async(ByVal param As Double)   
+    Overloads Public Sub Method2Async(ByVal param As Double, ByVal userState As Object)   
+    Public Event Method2Completed As Method2CompletedEventHandler  
+  
+    Public Sub CancelAsync(ByVal userState As Object)   
+  
+    Public ReadOnly Property IsBusy () As Boolean  
+  
+    ' Class implementation not shown.  
+End Class  
+```  
+  
+```csharp  
+public class AsyncExample  
+{  
+    // Synchronous methods.  
+    public int Method1(string param);  
+    public void Method2(double param);  
+  
+    // Asynchronous methods.  
+    public void Method1Async(string param);  
+    public void Method1Async(string param, object userState);  
+    public event Method1CompletedEventHandler Method1Completed;  
+  
+    public void Method2Async(double param);  
+    public void Method2Async(double param, object userState);  
+    public event Method2CompletedEventHandler Method2Completed;  
+  
+    public void CancelAsync(object userState);  
+  
+    public bool IsBusy { get; }  
+  
+    // Class implementation not shown.  
+}  
+```  
+  
+ 架空の `AsyncExample` クラスには 2 つのメソッドがあり、いずれも同期および非同期の呼び出しをサポートしています。  同期のオーバーロードは、呼び出し元スレッドで操作を呼び出しおよび実行する任意のメソッドと同様に動作します。操作に時間がかかる場合は、呼び出しから戻るまでにかなりの遅延が発生する場合があります。  非同期のオーバーロードは、別のスレッドで操作を開始して即座に戻ります。これにより、操作を "バックグラウンド" で実行しながら、呼び出し元スレッドを続行できます。  
+  
+### 非同期メソッドのオーバーロード  
+ 非同期操作には、基本的に単一呼び出しと複数呼び出しの 2 つのオーバーロードがあります。  これら 2 つの形式はそのメソッド シグネチャで区別できます。複数呼び出しの形式には、`userState` という名前の追加のパラメーターがあります。  この形式を使用すると、保留中の非同期操作が完了するのを待たずに、コードで `Method1Async(string param, object userState)` を複数回呼び出すことができます。  一方、直前の呼び出しが完了する前に `Method1Async(string param)` を呼び出そうとすると、メソッドにより <xref:System.InvalidOperationException> が発生します。  
+  
+ 複数呼び出しのオーバーロードの `userState` パラメーターにより、非同期操作を区別できます。   `Method1Async(string param, object userState)` の各呼び出しに一意な値 \(GUID やハッシュ コードなど\) を指定すると、各操作が完了したときに、イベント ハンドラーは、どの操作のインスタンスが完了イベントを発生させたのかを確認できます。  
+  
+### 保留中の操作の追跡  
+ 複数呼び出しのオーバーロードを使用する場合は、保留中のタスクの `userState` オブジェクト \(タスク ID\) を追跡する必要があります。   `Method1Async(string param, object userState)` の呼び出しごとに、通常は新しい一意な `userState` オブジェクトを生成し、それをコレクションに追加します。  この `userState` オブジェクトに対応するタスクが完了イベントを発生させると、完了メソッドの実装は <xref:System.ComponentModel.AsyncCompletedEventArgs.UserState%2A?displayProperty=fullName> を調べて、それをコレクションから削除します。   このように使用すると、`userState` パラメーターはタスク ID の役割を果たします。  
+  
+> [!NOTE]
+>  複数呼び出しのオーバーロードの呼び出しでは、`userState` に一意な値を指定するように注意が必要です。  タスク ID が一意でないと、非同期クラスが <xref:System.ArgumentException> をスローします。  
+  
+### 保留中の操作のキャンセル  
+ 非同期操作を完了前にいつでもキャンセルできることは重要です。  イベント ベースの非同期パターンを実装するクラスには、`CancelAsync` メソッド \(非同期メソッドが 1 つだけの場合\) または *MethodName*`AsyncCancel` メソッド \(複数の非同期メソッドがある場合\) が含まれます。  
+  
+ 複数呼び出しを可能にするメソッドは `userState` パラメーターを受け取ります。これは、各タスクの有効期間を追跡するのに使用できます。  `CancelAsync` は `userState` パラメーターを受け取ります。このパラメーターにより、特定の保留中のタスクを取り消すことができます。  
+  
+ 保留中の操作を一度に 1 つだけサポートする `Method1Async(string param)` のようなメソッドは、キャンセルできません。  
+  
+### 進行状況の更新およびインクリメンタル結果の受信  
+ イベント ベースの非同期パターンに準拠するクラスは、進行状況およびインクリメンタル結果を追跡するイベントをオプションで提供します。  通常、これは `ProgressChanged` または *MethodName*`ProgressChanged` という名前で、その対応するイベント ハンドラーは <xref:System.ComponentModel.ProgressChangedEventArgs> パラメーターを受け取ります。  
+  
+ `ProgressChanged` イベントのイベント ハンドラーは、<xref:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage%2A?displayProperty=fullName> プロパティを調べて、非同期タスクの何パーセントが完了したのかを確認できます。  このプロパティは 0 ～ 100 の範囲です。これを使用すると、<xref:System.Windows.Forms.ProgressBar>ar の <xref:System.Windows.Forms.ProgressBar.Value%2A> プロパティを更新できます。  複数の非同期操作が保留中の場合は、<xref:System.ComponentModel.ProgressChangedEventArgs.UserState%2A?displayProperty=fullName> プロパティを使用して、どの操作が進行状況をレポートしているのかを判別できます。  
+  
+ 一部のクラスは、非同期操作の進行に応じて、インクリメンタル結果をレポートします。  これらの結果は <xref:System.ComponentModel.ProgressChangedEventArgs> から派生したクラス内に保存され、派生クラスのプロパティとして表示されます。  `ProgressChanged` イベントのイベント ハンドラーのこれらの結果へは、<xref:System.ComponentModel.ProgressChangedEventArgs.ProgressPercentage%2A> プロパティにアクセスするのと同じようにアクセスできます。  複数の非同期操作が保留中の場合は、<xref:System.ComponentModel.ProgressChangedEventArgs.UserState%2A> プロパティを使用して、どの操作がインクリメンタル結果をレポートしているのかを判別できます。  
+  
+## 参照  
+ <xref:System.ComponentModel.ProgressChangedEventArgs>   
+ <xref:System.ComponentModel.BackgroundWorker>   
+ <xref:System.ComponentModel.AsyncCompletedEventArgs>   
+ [How to: Use Components That Support the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md)   
+ [方法 : バックグラウンドで操作を実行する](../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [方法 : バックグラウンド操作を使用するフォームを実装する](../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [Multithreaded Programming with the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)   
+ [イベントベースの非同期パターンを実装するための推奨される手順](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)   
+ [Deciding When to Implement the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..0082847a587
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/how-to-implement-a-client-of-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,48 @@
+---
+title: "How to: Implement a Client of the Event-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "Asynchronous Pattern"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "components [.NET Framework], asynchronous"
+  - "AsyncOperation class"
+  - "threading [Windows Forms], asynchronous features"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: 21a858c1-3c99-4904-86ee-0d17b49804fa
+caps.latest.revision: 11
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Implement a Client of the Event-based Asynchronous Pattern
+「[Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)」に従ってコンポーネントを使用する方法のコード例を次に示します。  この例のフォームでは、「[How to: Implement a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)」で説明した  `PrimeNumberCalculator`  コンポーネントを使用します。  
+  
+ この例を使用するプロジェクトを実行すると、"Prime Number Calculator" フォームにグリッドと 2 つのボタン \(**\[Start New Task\]** および **\[Cancel\]**\) が表示されます。  **\[Start New Task\]** ボタンは、続けて何度もクリックできます。クリックするたびに、非同期操作によって計算が開始され、ランダムに生成されたテスト数値が素数かどうかが調べられます。  フォームには定期的に進行状況およびインクリメンタル結果が表示されます。  各操作には一意のタスク ID が割り当てられます。  計算結果は **\[Result\]** 列に表示されます。テスト数値が素数でない場合は、**\[Composite\]** とラベルが付けられ、最初の約数が表示されます。  
+  
+ **\[Cancel\]** ボタンを使用すると、任意の保留中の操作をキャンセルできます。  複数選択できます。  
+  
+> [!NOTE]
+>  大部分の数値は素数ではありません。  いくつもの操作を完了しても素数が見つからない場合は、さらにタスクを開始すると、いずれ素数が見つかります。  
+  
+## 使用例  
+ [!code-csharp[System.ComponentModel.AsyncOperationManager#10](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/CS/primenumbercalculatormain.cs#10)]
+ [!code-vb[System.ComponentModel.AsyncOperationManager#10](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.AsyncOperationManager/VB/primenumbercalculatormain.vb#10)]  
+  
+## 参照  
+ <xref:System.ComponentModel.AsyncOperation>   
+ <xref:System.ComponentModel.AsyncOperationManager>   
+ <xref:System.Windows.Forms.WindowsFormsSynchronizationContext>
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..ba57a9b3273
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,69 @@
+---
+title: "How to: Use Components That Support the Event-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "Asynchronous Pattern"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "components [.NET Framework], asynchronous"
+  - "AsyncOperation class"
+  - "threading [Windows Forms], asynchronous features"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: 35e9549c-1568-4768-ad07-17cc6dff11e1
+caps.latest.revision: 15
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# How to: Use Components That Support the Event-based Asynchronous Pattern
+大部分のコンポーネントは、非同期的に作業を行うオプションを提供します。  たとえば、<xref:System.Media.SoundPlayer> および <xref:System.Windows.Forms.PictureBox> コンポーネントを使用すると、メイン スレッドを中断せずに実行したまま、サウンドおよびイメージを "バックグラウンド" で読み込むことができます。  
+  
+ サポートするクラスで非同期メソッドを使用して、他のイベントの場合と同じように [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md) は場合、イベント ハンドラーをコンポーネントの *MethodName*`Completed` イベントにアタッチする簡単です。  *MethodName*`Async` のメソッドを呼び出すと、アプリケーションが *MethodName*`Completed` イベントが発生させるまで中断されずに実行されます。  イベント ハンドラーで <xref:System.ComponentModel.AsyncCompletedEventArgs> パラメーターを調べると、非同期操作が正常に完了したか、キャンセルされたかを確認できます。  
+  
+ イベンド ハンドラーの使用方法の詳細については、「[イベント ハンドラーの概要](../../../docs/framework/winforms/event-handlers-overview-windows-forms.md)」を参照してください。  
+  
+ 次の手順は、<xref:System.Windows.Forms.PictureBox> コントロールの非同期イメージ読み込み機能を使用する方法を示しています。  
+  
+### PictureBox コントロールを有効にして、非同期的にイメージを読み込むには  
+  
+1.  フォームで <xref:System.Windows.Forms.PictureBox> コンポーネントのインスタンスを作成します。  
+  
+2.  <xref:System.Windows.Forms.PictureBox.LoadCompleted> イベントにイベント ハンドラーを割り当てます。  
+  
+     ここで、非同期ダウンロード中に発生したエラーを確認します。  キャンセルも確認します。  
+  
+     [!code-csharp[System.Windows.Forms.PictureBox.LoadAsync#2](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/CS/Form1.cs#2)]
+     [!code-vb[System.Windows.Forms.PictureBox.LoadAsync#2](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/VB/Form1.vb#2)]  
+  
+     [!code-csharp[System.Windows.Forms.PictureBox.LoadAsync#5](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/CS/Form1.cs#5)]
+     [!code-vb[System.Windows.Forms.PictureBox.LoadAsync#5](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/VB/Form1.vb#5)]  
+  
+3.  フォームに 2 つのボタン \(`loadButton` および `cancelLoadButton`\) を追加します。  <xref:System.Windows.Forms.Control.Click> イベント ハンドラーを追加して、ダウンロードを開始およびキャンセルします。  
+  
+     [!code-csharp[System.Windows.Forms.PictureBox.LoadAsync#3](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/CS/Form1.cs#3)]
+     [!code-vb[System.Windows.Forms.PictureBox.LoadAsync#3](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/VB/Form1.vb#3)]  
+  
+     [!code-csharp[System.Windows.Forms.PictureBox.LoadAsync#4](../../../samples/snippets/csharp/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/CS/Form1.cs#4)]
+     [!code-vb[System.Windows.Forms.PictureBox.LoadAsync#4](../../../samples/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.PictureBox.LoadAsync/VB/Form1.vb#4)]  
+  
+4.  アプリケーションを実行します。  
+  
+     イメージのダウンロードの進行中には、フォームを自由に移動、最小化、最大化できます。  
+  
+## 参照  
+ [方法 : バックグラウンドで操作を実行する](../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)   
+ [NOT IN BUILD: Multithreading in Visual Basic](http://msdn.microsoft.com/ja-jp/c731a50c-09c1-4468-9646-54c86b75d269)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..9ec855d43ee
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,260 @@
+---
+title: "イベントベースの非同期パターンの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント ベースの非同期パターン"
+  - "ProgressChangedEventArgs クラス"
+  - "BackgroundWorker コンポーネント"
+  - "イベント [.NET Framework], 非同期"
+  - "非同期パターン"
+  - "AsyncOperationManager クラス"
+  - "スレッド処理 [.NET Framework], 非同期機能"
+  - "非同期コンポーネント [.NET Framework]"
+  - "AsyncOperation クラス"
+  - "AsyncCompletedEventArgs クラス"
+ms.assetid: 43402d19-8d30-426d-8785-1a4478233bfa
+caps.latest.revision: 20
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# イベントベースの非同期パターンの実装
+いくつかの操作によって顕著な遅延が発生する可能性がありますクラスを作成している場合は、実装することによって、非同期機能を付けることを検討して[非同期パターンの概要をイベントに基づく](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)します。  
+  
+ イベント ベースの非同期パターンは、標準的な非同期機能を持つクラスをパッケージ化する方法を提供します。 ヘルパー クラスで実装される場合と同様に<xref:System.ComponentModel.AsyncOperationManager>、どのアプリケーション モデル、クラスが正しく動作を含む[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)]、コンソール アプリケーション、および Windows フォーム アプリケーションです。  
+  
+ イベント ベースの非同期パターンを実装する例を参照してください。[方法: イベント ベースの非同期パターンをサポートするコンポーネントの実装](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)します。  
+  
+ 検索は、単純な非同期操作の<xref:System.ComponentModel.BackgroundWorker>適切なコンポーネントです。 詳細については<xref:System.ComponentModel.BackgroundWorker>を参照してください[方法: バック グラウンドで操作を実行](../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)します。  
+  
+ 次の一覧では、このトピックで説明するイベント ベースの非同期パターンの機能について説明します。  
+  
+-   イベント ベースの非同期パターンを実装するための機会  
+  
+-   非同期メソッドの名前を付ける  
+  
+-   オプションでキャンセルをサポートします。  
+  
+-   オプションでサポートする場合、IsBusy プロパティ  
+  
+-   進行状況レポートのサポートを必要に応じて指定します。  
+  
+-   必要に応じてインクリメンタル結果を返すためのサポートを提供します。  
+  
+-   処理し、メソッドの Ref パラメーター  
+  
+## <a name="opportunities-for-implementing-the-event-based-asynchronous-pattern"></a>イベント ベースの非同期パターンを実装するための機会  
+ イベント ベースの非同期パターンの実装を検討する場合。  
+  
+-   クラスのクライアントは必要はありません<xref:System.Threading.WaitHandle>と<xref:System.IAsyncResult>非同期操作、つまり、そのポーリングに使用できるオブジェクトと<xref:System.Threading.WaitHandle.WaitAll%2A>または<xref:System.Threading.WaitHandle.WaitAny%2A>クライアントによってに基づいて作成する必要があります。  
+  
+-   使い慣れたイベントのデリゲートのモデルを使用するクライアントで管理するための非同期操作を必要とします。  
+  
+ すべての操作が非同期の実装の候補が、長い待機時間が予想されるものと見なします。 特に適切なは、操作をクライアントがメソッドを呼び出すし、それ以上の介入なしで通知を受けず、です。 適切なは、定期的に進捗状況、インクリメンタル結果や状態の変化をクライアントに通知を継続的に実行される操作です。  
+  
+ イベント ベースの非同期パターンをサポートする時期を決定する際の詳細については、次を参照してください。[を決定するときに、イベント ベースの非同期パターンを実装する](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)です。  
+  
+## <a name="naming-asynchronous-methods"></a>非同期メソッドの名前を付ける  
+ 各同期メソッド*MethodName*の対応する非同期を提供します。  
+  
+ 定義、 *MethodName* `Async`メソッドです。  
+  
+-   `void` を返します。  
+  
+-   同じパラメーターを受け取り、 *MethodName*メソッドです。  
+  
+-   複数の呼び出しを受け入れます。  
+  
+ 必要に応じて定義、 *MethodName* `Async`オーバー ロードのと同じ*MethodName*`Async`と呼ばれますが、追加のオブジェクトの値を持つパラメーターが`userState`です。 その場合、そのメソッドの複数の同時呼び出しを管理する準備を整えておけば場合は、`userState`メソッドの呼び出しを区別するためにすべてのイベント ハンドラーにもたらされる価値です。 できますこれを行う後で利用できるユーザーの状態を格納する場所として単純にします。  
+  
+ 各個別*MethodName* `Async`メソッド シグネチャ。  
+  
+1.  メソッドと同じクラスでは、次のイベントを定義します。  
+  
+    ```vb  
+    Public Event MethodNameCompleted As MethodNameCompletedEventHandler  
+    ```  
+  
+    ```csharp  
+    public event MethodNameCompletedEventHandler MethodNameCompleted;  
+    ```  
+  
+2.  次のデリゲートを定義し、 <xref:System.ComponentModel.AsyncCompletedEventArgs>します。 これらはの場合、同じ名前空間が、クラス自体の外部で定義されます。  
+  
+    ```vb  
+    Public Delegate Sub MethodNameCompletedEventHandler( _  
+        ByVal sender As Object, _  
+        ByVal e As MethodNameCompletedEventArgs)  
+  
+    Public Class MethodNameCompletedEventArgs  
+        Inherits System.ComponentModel.AsyncCompletedEventArgs  
+    Public ReadOnly Property Result() As MyReturnType  
+    End Property  
+    ```  
+  
+    ```csharp  
+    public delegate void MethodNameCompletedEventHandler(object sender,   
+        MethodNameCompletedEventArgs e);  
+  
+    public class MethodNameCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs  
+    {  
+        public MyReturnType Result { get; }  
+    }  
+    ```  
+  
+    -   いることを確認、 *MethodName* `CompletedEventArgs`フィールド、データ バインドできるため、クラスが読み取り専用プロパティとフィールドではなく、メンバーを公開します。  
+  
+    -   いずれかを定義しない<xref:System.ComponentModel.AsyncCompletedEventArgs>の結果が得られないメソッド用のクラスを派生します。 インスタンスを使用するだけ<xref:System.ComponentModel.AsyncCompletedEventArgs>自体です。  
+  
+        > [!NOTE]
+        >  可能かつ適切なデリゲートを再利用するときにまったく問題ありませんが、 <xref:System.ComponentModel.AsyncCompletedEventArgs>型です。 ここでは、名前付けされませんメソッド名に一貫性のある特定のデリゲート以降と<xref:System.ComponentModel.AsyncCompletedEventArgs>&1; つのメソッドに関連付けられているされません。  
+  
+## <a name="optionally-support-cancellation"></a>オプションでキャンセルをサポートします。  
+ クラスでは、非同期操作のキャンセルをサポートする場合、以下に示すようキャンセルは、クライアントに公開する必要があります。 キャンセルのサポートを定義する前に到達する必要がある&2; つの意思決定ポイントがあることに注意してください。  
+  
+-   を、今後の予想される追加機能を含め、クラスはキャンセルをサポートする非同期操作を&1; つだけありますか。  
+  
+-   キャンセルのサポートに複数の保留中の操作をサポートする非同期操作をできるでしょうか。 *MethodName* `Async`メソッドを`userState`パラメーター、おり、いずれかを完了するを待機する前に複数の呼び出しは許可してでしょうか。  
+  
+ 次の表でこれら&2; つの質問に対する回答を使用して、キャンセル メソッドのシグネチャを決定します。  
+  
+### <a name="visual-basic"></a>Visual Basic  
+  
+||サポートされている複数の同時操作|一度に&1; つだけの操作|  
+|------|------------------------------------------------|----------------------------------|  
+|クラス全体で&1; つの非同期操作|`Sub MethodNameAsyncCancel(ByVal userState As Object)`|`Sub MethodNameAsyncCancel()`|  
+|クラスの複数の非同期操作|`Sub CancelAsync(ByVal userState As Object)`|`Sub CancelAsync()`|  
+  
+### <a name="c"></a>C#  
+  
+||サポートされている複数の同時操作|一度に&1; つだけの操作|  
+|------|------------------------------------------------|----------------------------------|  
+|クラス全体で&1; つの非同期操作|`void MethodNameAsyncCancel(object userState);`|`void MethodNameAsyncCancel();`|  
+|クラスの複数の非同期操作|`void CancelAsync(object userState);`|`void CancelAsync();`|  
+  
+ 定義した場合、`CancelAsync(object userState)`メソッドでは、クライアントは、オブジェクトで呼び出されたすべての非同期メソッドを区別できるようにするには、その状態値を選択する場合は注意が必要またはすべての呼び出しで非同期メソッドを&1; つだけでなくにする必要があります。  
+  
+ 1 つの非同期操作のバージョンの名前を決定*MethodName* `AsyncCancel`を Visual Studio の IntelliSense のようなデザイン環境でメソッドをより簡単に検出できないに基づきます。 これにより、関連するメンバーをグループ化し、それらを他のメンバーを持つ非同期機能とは無関係から区別します。 あることを追加する場合の非同期操作で追加今後のバージョンを定義することをお勧め`CancelAsync`します。  
+  
+ 上の表の複数のメソッドを同じクラスに定義されていません。 しないことになる意味では、または、クラス インターフェイスのメソッドの増加に伴うがわかりにくくなります。  
+  
+ これらのメソッド通常がすぐに、れ、操作を実際にはキャンセルできませんか。 イベントのハンドラーで、 *MethodName* `Completed` 、イベント、 *MethodName* `CompletedEventArgs`オブジェクトが含まれています、`Cancelled`フィールドには、クライアントを使用して、キャンセルが発生したかどうかを確認します。  
+  
+ 説明されているキャンセルのセマンティクスに従う[イベント ベースの非同期パターンを実装するためのベスト プラクティス](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)します。  
+  
+## <a name="optionally-support-the-isbusy-property"></a>オプションでサポートする場合、IsBusy プロパティ  
+ クラスが複数の同時呼び出しをサポートしていない場合は、公開することを検討してください、`IsBusy`プロパティです。 これにより、開発者を判断するかどうか、 *MethodName* `Async`から例外をキャッチせずメソッドが実行されている、 *MethodName* `Async`メソッドです。  
+  
+ 遵守、`IsBusy`セマンティクスの記載[イベント ベースの非同期パターンを実装するためのベスト プラクティス](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)します。  
+  
+## <a name="optionally-provide-support-for-progress-reporting"></a>進行状況レポートのサポートを必要に応じて指定します。  
+ その操作中に進行状況を報告する非同期操作のことをお勧めします。 イベント ベースの非同期パターンは、そのためのガイドラインを示します。  
+  
+-   必要に応じて、非同期操作で発生し、適切なスレッドで呼び出されるイベントを定義します。 <xref:System.ComponentModel.ProgressChangedEventArgs>オブジェクトは、0 ~ 100 の範囲であると予想される整数値の進行状況インジケーターを実行します。  
+  
+-   このイベントには、次のように名前を付けます。  
+  
+    -   `ProgressChanged`クラスが複数の非同期操作 (または将来のバージョンで複数の非同期操作を含めると予想されて) です。  
+  
+    -   *MethodName* `ProgressChanged`クラスは、非同期操作を&1; つを持つ場合です。  
+  
+     この名前の付け方は、必要に応じてキャンセルのサポート セクションで説明したキャンセル メソッドに対して行わ対応しています。  
+  
+ このイベントを使用する必要があります、 <xref:System.ComponentModel.ProgressChangedEventHandler>デリゲート シグネチャと<xref:System.ComponentModel.ProgressChangedEventArgs>クラスです。 代わりに、インスタンス、読み取られたバイトと、ダウンロード操作の合計バイト数) (よりドメイン固有の進行状況インジケーターを提供できる場合、必要があります定義の派生クラス<xref:System.ComponentModel.ProgressChangedEventArgs>します。  
+  
+ 1 つだけ`ProgressChanged`または*MethodName* `ProgressChanged`としては、非同期のメソッドの数にかかわらず、クラスのイベントです。 クライアントが使用する必要があります、`userState`に渡されるオブジェクト、 *MethodName* `Async`メソッドを複数の同時操作の進行状況の更新を区別します。  
+  
+ 複数の操作が進行状況をサポートし、進行状況のさまざまなインジケーターを返すそれぞれの状況である可能性があります。 この場合、1 つで`ProgressChanged`イベントが適切でないと、複数のサポートを検討することが`ProgressChanged`イベントです。 ここでの名前付けパターンを使用して*MethodName* `ProgressChanged`各*MethodName* `Async`メソッドです。  
+  
+ 説明した進行状況レポートのセマンティクスに従う[イベント ベースの非同期パターンを実装するためのベスト プラクティス](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)します。  
+  
+## <a name="optionally-provide-support-for-returning-incremental-results"></a>必要に応じてインクリメンタル結果を返すためのサポートを提供します。  
+ 場合もあります非同期操作が完了する前に、インクリメンタル結果を返すことができます。 このシナリオをサポートするために使用できるオプションが多数あります。 次の例をいくつか。  
+  
+### <a name="single-operation-class"></a>単一の操作  
+ クラスは、1 つの非同期操作のみをサポートし、その操作が、インクリメンタル結果を返すことができません: 場合  
+  
+-   拡張、 <xref:System.ComponentModel.ProgressChangedEventArgs>インクリメンタル結果データを実行するために入力し、定義、 *MethodName* `ProgressChanged`イベントと、このデータを拡張します。  
+  
+-   これを発生させる*MethodName* `ProgressChanged`イベントのレポートへの増分の結果があるときです。  
+  
+ このソリューション適用具体的には、単一非同期操作として、「すべての操作」でインクリメンタル結果を返す発生している同じイベントに問題がないため、 *MethodName* `ProgressChanged`イベントがします。  
+  
+### <a name="multiple-operation-class-with-homogeneous-incremental-results"></a>同種のインクリメンタル結果を持つクラスを複数回の操作  
+ この場合をこれらインクリメンタル結果をすべて同じ型のデータがあるクラスはそれぞれ、インクリメンタル結果を返すことのできる、複数の非同期メソッドをサポートします。  
+  
+ クラスについては単一の操作、同じとは、上記で説明したモデルに従う<xref:System.EventArgs>すべてインクリメンタル結果を使用しても構造体。 定義、`ProgressChanged`イベントの代わりに、 *MethodName* `ProgressChanged`イベント、複数の非同期メソッドに適用されるためです。  
+  
+### <a name="multiple-operation-class-with-heterogeneous-incremental-results"></a>異種のインクリメンタル結果を持つクラスを複数回の操作  
+ クラスは、複数の非同期メソッドをサポートする場合、データの別の型を返す各手順に従います。  
+  
+-   インクリメンタル結果の進行状況のレポートからレポートを区切ります。  
+  
+-   別の定義*MethodName* `ProgressChanged`イベントを適切な<xref:System.EventArgs>そのメソッドの増分の結果データを処理する各非同期メソッドのです。  
+  
+ 」の説明に従って、適切なスレッドでは、そのイベント ハンドラーを呼び出す[イベント ベースの非同期パターンを実装するためのベスト プラクティス](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)します。  
+  
+## <a name="handling-out-and-ref-parameters-in-methods"></a>処理し、メソッドの Ref パラメーター  
+ 使用する`out`と`ref`一般に、.NET Framework で避けることを推奨、ここでは、ルールが含まれているときに実行します。  
+  
+ 同期メソッドを指定した*MethodName*:  
+  
+-   `out`パラメーターを*MethodName*の一部をすることはできません*MethodName*`Async`します。 代わりの一部をすることがあります*MethodName* `CompletedEventArgs`と等価で、パラメーターと同じ名前の*MethodName* (がない限りより適切な名前)。  
+  
+-   `ref`パラメーターを*MethodName*の一部として出現する必要があります*MethodName*`Async`の一部として*MethodName* `CompletedEventArgs`と等価で、パラメーターと同じ名前の*MethodName* (がない限りより適切な名前)。  
+  
+ 例を示します。  
+  
+```vb  
+Public Function MethodName(ByVal arg1 As String, ByRef arg2 As String, ByRef arg3 As String) As Integer  
+```  
+  
+```csharp  
+public int MethodName(string arg1, ref string arg2, out string arg3);  
+```  
+  
+ 非同期メソッドとその<xref:System.ComponentModel.AsyncCompletedEventArgs>クラスは次のようになります。  
+  
+```vb  
+Public Sub MethodNameAsync(ByVal arg1 As String, ByVal arg2 As String)  
+  
+Public Class MethodNameCompletedEventArgs  
+    Inherits System.ComponentModel.AsyncCompletedEventArgs  
+    Public ReadOnly Property Result() As Integer   
+    End Property  
+    Public ReadOnly Property Arg2() As String   
+    End Property  
+    Public ReadOnly Property Arg3() As String   
+    End Property  
+End Class  
+```  
+  
+```csharp  
+public void MethodNameAsync(string arg1, string arg2);  
+  
+public class MethodNameCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs  
+{  
+    public int Result { get; };  
+    public string Arg2 { get; };  
+    public string Arg3 { get; };  
+}  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.ComponentModel.ProgressChangedEventArgs>   
+ <xref:System.ComponentModel.AsyncCompletedEventArgs>   
+ [方法: イベント ベースの非同期パターンをサポートするコンポーネントの実装](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)   
+ [方法: バック グラウンドで操作を実行](../../../docs/framework/winforms/controls/how-to-run-an-operation-in-the-background.md)   
+ [方法: フォーム バック グラウンド操作を実装します。](../../../docs/framework/winforms/controls/how-to-implement-a-form-that-uses-a-background-operation.md)   
+ [イベント ベースの非同期パターンを実装する状況の判断](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)   
+ [イベント ベースの非同期パターンではマルチ スレッド プログラミング](../../../docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md)   
+ [イベント ベースの非同期パターンを実装するためのベスト プラクティス](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..9604fb5156d
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md
@@ -0,0 +1,110 @@
+---
+title: "Implementing the Task-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, and TAP"
+  - "asynchronous design patterns, .NET Framework"
+  - "TAP, .NET Framework support for"
+  - "Task-based Asynchronous Pattern, .NET Framework support for"
+  - ".NET Framework, asynchronous design patterns"
+ms.assetid: fab6bd41-91bd-44ad-86f9-d8319988aa78
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Implementing the Task-based Asynchronous Pattern
+タスク ベースの非同期パターン \(TAP\) は、3 つの方法 \(Visual Studio の C\# および Visual Basic コンパイラを使用する方法、手動で行う方法、またはコンパイラと手動による方法を組み合わせた方法\) で実装できます。  以下のセクションでは、それぞれの方法について詳しく説明します。  TAP パターンを使用して、計算主体と I\/O バインドの非同期操作の両方を実装できます \(各種操作については「[作業負荷](#workloads)」セクションで説明します\)。  
+  
+## TAP メソッドの生成  
+  
+### コンパイラの使用方法  
+ [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] および [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、`async` キーワード \(Visual Basic では `Async`\) を使用して属性設定されているメソッドは、非同期メソッドと見なされ、TAP を使用して非同期にメソッドを実装するために必要となる変換が C\# コンパイラおよび Visual Basic コンパイラによって行われます。  非同期メソッドは、<xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトまたは <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> オブジェクトを返す必要があります。  後者の場合、関数の本体は `TResult` を返す必要があり、コンパイラによって、結果として得られるタスク オブジェクトでこの結果が利用可能になっていることが確認されます。  同様に、メソッド本体で処理されない例外は、出力タスクにマーシャリングされ、結果として得られるタスクが <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態で終了する原因となります。  例外は、<xref:System.OperationCanceledException> \(または派生型\) がハンドルされない場合で、結果として得られるタスクは <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態で終了します。  
+  
+### 手動での TAP メソッドの生成  
+ TAP パターンは、実装の制御を強化するために手動で実装することができます。  コンパイラは、<xref:System.Threading.Tasks?displayProperty=fullName> 名前空間から公開されるパブリック アクセス機能および <xref:System.Runtime.CompilerServices?displayProperty=fullName> 名前空間でサポートされている型に依存します。  TAP を実装するには、<xref:System.Threading.Tasks.TaskCompletionSource%601> オブジェクトを作成して非同期操作を実行し、それが完了したら、<xref:System.Threading.Tasks.TaskCompletionSource%601.SetResult%2A>、<xref:System.Threading.Tasks.TaskCompletionSource%601.SetException%2A>、または <xref:System.Threading.Tasks.TaskCompletionSource%601.SetCanceled%2A> メソッド、またはそのいずれかのメソッドの `Try` バージョンを呼び出します。  TAP メソッドを手動で実装する場合には、表現されている非同期操作の完了時に、結果として得られるタスクを完了する必要があります。  次に例を示します。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#1)]
+ [!code-vb[Conceptual.TAP_Patterns#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#1)]  
+  
+### ハイブリッド手法  
+ TAP パターンは手動で実装しても、コア ロジックはコンパイラの実装に委譲すると便利な場合があります。  たとえば、例外を <xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトを使用して公開するのではなく、メソッドの直接の呼び出し元にエスケープするように、コンパイラが生成した非同期メソッドの外部で引数を検証する場合は、ハイブリッド手法を使用します。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#2)]
+ [!code-vb[Conceptual.TAP_Patterns#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#2)]  
+  
+ また、このような委譲が便利なもう 1 つのケースとして、高速パスの最適化を実装し、キャッシュされたタスクを返す場合を挙げられます。  
+  
+<a name="workloads"></a>   
+## 作業負荷  
+ 計算主体および I\/O バインドの非同期操作は、いずれも、TAP のメソッドとして実装することができます。  ただし、TAP メソッドがライブラリから公開される場合には、TAP メソッドは、I\/O バインド操作 \(計算が含まれていても、純粋な計算ではない\) を含む作業負荷にのみ指定する必要があります。  メソッドが純粋に計算主体の場合、同期実装としてのみ公開される必要があります。つまり、そのメソッドを使用するコードによって、別のスレッドに作業をオフロードするため、または並列化を実現するためにその同期メソッドの呼び出しをタスク内にラップするかどうかが選択されます。  
+  
+### 計算主体のタスク  
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスは、計算を集中的に行う操作の表現に適しています。  既定では、このクラスは、<xref:System.Threading.ThreadPool> クラス内の特別なサポートを利用します。また、いつ、どこで、どのように非同期計算を実行するかを細かく制御することもできます。  
+  
+ 計算主体のタスクは、次の方法で生成できます。  
+  
+-   .NET Framework 4 では、デリゲート \(通常、<xref:System.Action%601> または <xref:System.Func%601>\) の非同期実行を許容する <xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドを使用します。  <xref:System.Action%601> のデリゲートを指定する場合、メソッドはデリゲートの非同期実行を表す <xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトを返します。  <xref:System.Func%601> のデリゲートを指定する場合、メソッドは <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> オブジェクトを返します。  <xref:System.Threading.Tasks.TaskFactory.StartNew%2A> メソッドのオーバーロードは、キャンセル トークン \(<xref:System.Threading.CancellationToken>\)、タスクの作成オプション \(<xref:System.Threading.Tasks.TaskCreationOptions>\)、およびタスク スケジューラ \(<xref:System.Threading.Tasks.TaskScheduler>\) を受け取ります。  たとえば、`Task.Factory.StartNew(…)` など、現在のタスク スケジューラをターゲットとするファクトリ インスタンスを、<xref:System.Threading.Tasks.Task.Factory%2A> クラスの静的プロパティ \(<xref:System.Threading.Tasks.Task>\) として使用できます。  
+  
+-   [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、静的な <xref:System.Threading.Tasks.Task.Run%2A?displayProperty=fullName> メソッドを <xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> へのショートカットとして使用します。  スレッド プールをターゲットとする計算主体のタスクを簡単に起動するには、<xref:System.Threading.Tasks.Task.Run%2A> を使用します。  [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、これが計算主体のタスクの推奨起動方法です。  タスクによりきめの細かい制御を行う場合のみ `StartNew` を直接使用します。  
+  
+-   タスクを個別に生成およびスケジュールする場合は、`Task` 型のコンストラクターまたは `Start` メソッドを使用します。  パブリック メソッドは、既に開始されているタスクのみを返す必要があります。  
+  
+-   <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> メソッドのオーバーロードを使用します。  このメソッドは、別のタスクが完了したときにスケジュールされる新しいタスクを作成します。  一部の <xref:System.Threading.Tasks.Task.ContinueWith%2A> オーバーロードは、キャンセル トークン、継続オプション、およびタスク スケジューラを受け取るため、継続タスクのスケジュール設定と実行を細かく制御することができます。  
+  
+-   <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A?displayProperty=fullName> メソッドを使用します。  これらのメソッドは、指定された一連のタスクのすべてまたは一部の完了時にスケジュールされる新しいタスクを作成します。  これらのメソッドには、こうしたタスクのスケジュール設定と実行を制御するためのオーバーロードも用意されています。  
+  
+ 計算主体のタスクでは、実行開始前に取り消し要求を受信した場合に、スケジュール済みのタスクがシステムによって実行されないようにすることができます。  したがって、キャンセル トークン \(<xref:System.Threading.CancellationToken> オブジェクト\) を指定すると、そのトークンを監視する非同期コードにそのトークンを渡すことができます。  また、`StartNew` や `Run` など、前述のメソッドのいずれかにそのトークンを指定し、`Task` ランタイムによって、そのトークンが監視されるようにもできます。  
+  
+ たとえば、イメージをレンダリングする非同期メソッドを考えます。  タスクの本体によってキャンセル トークンをポーリングすることで、レンダリングの実行中に取り消し要求を受信した場合にコードを早期に終了できるようにします。  また、取り消し要求がレンダリングの開始前に発生した場合、レンダリング処理が行われないようにします。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#3)]
+ [!code-vb[Conceptual.TAP_Patterns#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#3)]  
+  
+ 計算主体のタスクは、次の条件のうち最低でも 1 つが true の場合に <xref:System.Threading.Tasks.TaskStatus> 状態で終了します。  
+  
+-   取り消し要求は、タスクが <xref:System.Threading.CancellationToken> 状態に遷移する前に、引数として作成メソッド \(`StartNew` や `Run` など\) に渡される <xref:System.Threading.Tasks.TaskStatus> オブジェクトを使用して受け取ります。  
+  
+-   このようなタスクの本体では、<xref:System.OperationCanceledException> 例外がハンドルされなくなります。この例外にはタスクに渡されたのと同じ <xref:System.Threading.CancellationToken> が含まれていて、このトークンは取り消しが要求されていることを示します。  
+  
+ 別の例外がそのタスク本体でハンドルされないと、タスクは <xref:System.Threading.Tasks.TaskStatus> 状態で終了し、タスクでの待機または結果へのアクセスが試みられると例外をスローします。  
+  
+### I\/O バインドのタスク  
+ スレッドの実行全体に対してスレッドによって直接サポートされないタスクを作成するには、<xref:System.Threading.Tasks.TaskCompletionSource%601> 型を使用します。  この型は、関連する <xref:System.Threading.Tasks.TaskCompletionSource%601.Task%2A> インスタンスを返す <xref:System.Threading.Tasks.Task%601> プロパティを公開します。  このタスクの有効期間は、<xref:System.Threading.Tasks.TaskCompletionSource%601>、<xref:System.Threading.Tasks.TaskCompletionSource%601.SetResult%2A>、<xref:System.Threading.Tasks.TaskCompletionSource%601.SetException%2A>、`TrySet` バリアントなどの <xref:System.Threading.Tasks.TaskCompletionSource%601.SetCanceled%2A> メソッドによって制御されます。  
+  
+ 指定時間が経過すると完了するタスクを作成する場合を考えてみます。  たとえば、ユーザー インターフェイスでアクティビティを遅延させる場合などです。  <xref:System.Threading.Timer?displayProperty=fullName> クラスには、一定時間経過後にデリゲートを非同期に呼び出す機能、また、<xref:System.Threading.Tasks.TaskCompletionSource%601> を使用して、タイマーの前に <xref:System.Threading.Tasks.Task%601> を配置する機能が用意されています。次に例を示します。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#4)]
+ [!code-vb[Conceptual.TAP_Patterns#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#4)]  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、このような目的のために <xref:System.Threading.Tasks.Task.Delay%2A?displayProperty=fullName> メソッドが用意されており、別の非同期メソッド内で使用して、たとえば、非同期ポーリング ループを実装することもできます。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#5)]
+ [!code-vb[Conceptual.TAP_Patterns#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#5)]  
+  
+ <xref:System.Threading.Tasks.TaskCompletionSource%601> クラスには、非ジェネリック クラスがありません。  ただし、<xref:System.Threading.Tasks.Task%601> から <xref:System.Threading.Tasks.Task> が派生されるため、単純にタスクを返す I\/O バインド メソッドに対してジェネリックな <xref:System.Threading.Tasks.TaskCompletionSource%601> オブジェクトを使用できます。  これを行うには、ソースをダミー `TResult` と共に使用します \(<xref:System.Boolean> は適切な既定の選択肢ですが、<xref:System.Threading.Tasks.Task> のユーザーがそれを <xref:System.Threading.Tasks.Task%601> にダウンキャストすることが懸念される場合は、代わりにプライベートな `TResult` を使用することもできます\)。  たとえば、前の例の `Delay` メソッドは、結果として得られるオフセット \(`Task<DateTimeOffset>`\) と共に現在時間を返します。  このような結果値が不要である場合、メソッドのコードは次のように記述できます \(戻り値の型と <xref:System.Threading.Tasks.TaskCompletionSource%601.TrySetResult%2A> の引数が変化することに注意してください\)。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#6)]
+ [!code-vb[Conceptual.TAP_Patterns#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#6)]  
+  
+### 計算主体のタスクと I\/O バインドのタスクの混在  
+ 非同期メソッドは、計算主体の操作や I\/O バインド操作に限らず、この 2 つを混在させた操作を表現できます。  実際、複数の非同期操作は、しばしばより規模の大きな混合操作に合成されます。  たとえば、前の例の `RenderAsync` メソッドでは、いくつかの入力 `imageData` に基づいて、計算を集中的に行う操作を実行してイメージをレンダリングしました。  この `imageData` は、非同期にアクセスする Web サービスから次のように取得される場合があります。  
+  
+ [!code-csharp[Conceptual.TAP_Patterns#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap_patterns/cs/patterns1.cs#7)]
+ [!code-vb[Conceptual.TAP_Patterns#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap_patterns/vb/patterns1.vb#7)]  
+  
+ また、この例では、単一のキャンセル トークンが複数の非同期操作でどのようにスレッド化されるかも示します。  詳細については、「[Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)」のキャンセル使用のセクションを参照してください。  
+  
+## 参照  
+ [Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)   
+ [Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)   
+ [Interop with Other Asynchronous Patterns and Types](../../../docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/index.md b/docs/standard/asynchronous-programming-patterns/index.md
new file mode 100644
index 00000000000..a19e1e371b9
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/index.md
@@ -0,0 +1,80 @@
+---
+title: "Asynchronous Programming Patterns | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "asynchronous design patterns, .NET Framework"
+  - ".NET Framework, asynchronous design patterns"
+ms.assetid: 4ece5c0b-f8fe-4114-9862-ac02cfe5a5d7
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# Asynchronous Programming Patterns
+.NET Framework は、非同期操作を実行するための 3 つのパターンを提供します。  
+  
+-   非同期プログラミング モデル \(APM\) パターン \(<xref:System.IAsyncResult> パターンとも呼ばれます\)。非同期操作には `Begin` メソッドと `End` メソッドが必要です \(たとえば、非同期書き込み操作の場合は `BeginWrite` と `EndWrite`\)。  このパターンは、新規の開発では推奨されなくなりました。  詳細については、「[Asynchronous Programming Model \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md)」を参照してください。  
+  
+-   イベント ベースの非同期パターン \(EAP\)。`Async` サフィックスを持つメソッドと、1 つ以上のイベント、イベント ハンドラー デリゲート型、および `EventArg` 派生型を必要とします。  EAP は、.NET Framework 2.0 で導入されました。  新規の開発では推奨されなくなりました。  詳細については、「[Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)」を参照してください。  
+  
+-   タスク ベースの非同期パターン \(TAP\)。1 つのメソッドを使用して非同期操作の開始と完了を表します。  TAP は .NET Framework 4 で導入され、.NET Framework での非同期プログラミングに推奨されるアプローチです。  C\# の [async](../Topic/async%20\(C%23%20Reference\).md) キーワードと [await](../Topic/await%20\(C%23%20Reference\).md) キーワード、および Visual Basic 言語の [Async](../Topic/Async%20\(Visual%20Basic\).md) 演算子と [Await](../Topic/Await%20Operator%20\(Visual%20Basic\).md) 演算子により、TAP の言語サポートが追加されます。  詳細については、「[Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)」を参照してください。  
+  
+## パターンの比較  
+ 3 つのパターンで非同期操作がどのようにモデリングされるかを簡単に比較するために、指定された量のデータを、指定のバッファーの指定されたオフセットに読み込む `Read` メソッドを考えます。  
+  
+```csharp  
+public class MyClass  
+{  
+    public int Read(byte [] buffer, int offset, int count);  
+}  
+```  
+  
+ APM の場合は、このメソッドにより `BeginRead` メソッドと `EndRead` メソッドが公開されます。  
+  
+```csharp  
+public class MyClass  
+{  
+    public IAsyncResult BeginRead(  
+        byte [] buffer, int offset, int count,   
+        AsyncCallback callback, object state);  
+    public int EndRead(IAsyncResult asyncResult);  
+}  
+```  
+  
+ EAP の場合は次の型とメンバーのセットが公開されます。  
+  
+```csharp  
+public class MyClass  
+{  
+    public void ReadAsync(byte [] buffer, int offset, int count);  
+    public event ReadCompletedEventHandler ReadCompleted;  
+}  
+```  
+  
+ TAP の場合は次の単一の `ReadAsync` メソッドが公開されます。  
+  
+```csharp  
+public class MyClass  
+{  
+    public Task<int> ReadAsync(byte [] buffer, int offset, int count);  
+}  
+```  
+  
+ TAP、APM、および EAP の包括的な説明については、次のセクションに記載のリンクを参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[Asynchronous Programming Model \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md)|<xref:System.IAsyncResult> インターフェイスを使用して非同期動作を提供するレガシ モデルについて説明します。  このモデルは新規の開発では推奨されなくなりました。|  
+|[Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)|非同期動作を提供するイベント ベースのレガシ モデルについて説明します。  このモデルは新規の開発では推奨されなくなりました。|  
+|[Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)|<xref:System.Threading.Tasks> 名前空間に基づく新しい非同期パターンについて説明します。  このモデルは、.NET Framework 4 以降のバージョンでの非同期プログラミングで推奨されるアプローチです。|
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md b/docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md
new file mode 100644
index 00000000000..9cc710088f5
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md
@@ -0,0 +1,120 @@
+---
+title: "Interop with Other Asynchronous Patterns and Types | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, and TAP"
+  - "asynchronous design patterns, .NET Framework"
+  - "TAP, .NET Framework support for"
+  - "Task-based Asynchronous Pattern, .NET Framework support for"
+  - ".NET Framework, asynchronous design patterns"
+ms.assetid: f120a5d9-933b-4d1d-acb6-f034a57c3749
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Interop with Other Asynchronous Patterns and Types
+.NET Framework 1.0 では、<xref:System.IAsyncResult> とも、[Asynchronous Programming Model \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md) パターンとも呼ばれる `Begin/End` パターンが導入されました。  .NET Framework 2.0 では、[Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md) が追加されました。  .NET Framework 4 以降では、[Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md) が APM および EAP よりも優先されますが、以前のパターンからの移行ルーチンを簡単にビルドする機能が提供されます。  
+  
+ このトピックの内容  
+  
+-   [タスクおよび APM](#APM) \(「[APM から TAP へ](#ApmToTap)」または「[TAP から APM へ](#TapToApm)」\)  
+  
+-   [タスクおよび EAP](#EAP)  
+  
+-   [タスクおよび待機ハンドル](#WaitHandles) \(「[待機ハンドルから TAP へ](#WHToTap)」または「[TAP から待機ハンドルへ](#TapToWH)」\)  
+  
+<a name="APM"></a>   
+## タスクおよび非同期プログラミング モデル \(APM\)  
+  
+<a name="ApmToTap"></a>   
+### APM から TAP へ  
+ [Asynchronous Programming Model \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md) パターンは高度に構造化されているため、ラッパーをビルドして APM 実装を TAP 実装として公開するのはとても簡単です。 実際、.NET Framework では、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降で、この変換を行うために <xref:System.Threading.Tasks.TaskFactory.FromAsync%2A> メソッドのオーバーロードという形でヘルパー ルーチンが用意されています。  
+  
+ <xref:System.IO.Stream> クラスと、そのクラスの <xref:System.IO.Stream.BeginRead%2A> および <xref:System.IO.Stream.EndRead%2A> メソッドについて考えてみましょう。これらのメソッドは、同期 <xref:System.IO.Stream.Read%2A> メソッドに対応する APM 側のメソッドです。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Stream1.cs#1)]
+ [!code-vb[Conceptual.AsyncInterop#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/stream1.vb#1)]  
+[!code-csharp[Conceptual.AsyncInterop#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Stream1.cs#2)]
+[!code-vb[Conceptual.AsyncInterop#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/stream1.vb#2)]  
+[!code-csharp[Conceptual.AsyncInterop#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Stream1.cs#3)]
+[!code-vb[Conceptual.AsyncInterop#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/stream1.vb#3)]  
+  
+ <xref:System.Threading.Tasks.TaskFactory%601.FromAsync%2A?displayProperty=fullName> メソッドを次のように使用すると、この操作に対する TAP ラッパーを実装できます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Wrap1.cs#4)]
+ [!code-vb[Conceptual.AsyncInterop#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/Wrap1.vb#4)]  
+  
+ この実装は次のようになります。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Wrap2.cs#5)]
+ [!code-vb[Conceptual.AsyncInterop#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/Wrap2.vb#5)]  
+  
+<a name="TapToApm"></a>   
+### TAP から APM へ  
+ 既存のインフラストラクチャで APM パターンを使用することを想定している場合は、TAP の実装を用意し、APM の実装を想定している場所でその TAP の実装を使用します。  タスクは合成することができ、<xref:System.Threading.Tasks.Task> クラスが <xref:System.IAsyncResult> を実装するため、これは単純なヘルパー関数を使用して実現することができます。 次のコードでは、<xref:System.Threading.Tasks.Task%601> クラスの拡張を使用しますが、ほぼ同じ関数を非ジェネリック タスクに使用できます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/APM1.cs#6)]
+ [!code-vb[Conceptual.AsyncInterop#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/APM1.vb#6)]  
+  
+ ここで、TAP 実装がある次のような例を考えてみます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/APM2.cs#7)]
+ [!code-vb[Conceptual.AsyncInterop#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/APM2.vb#7)]  
+  
+ そして、次の APM 実装を使用します。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/APM2.cs#8)]
+ [!code-vb[Conceptual.AsyncInterop#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/APM2.vb#8)]  
+[!code-csharp[Conceptual.AsyncInterop#9](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/APM2.cs#9)]
+[!code-vb[Conceptual.AsyncInterop#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/APM2.vb#9)]  
+  
+ 次のコードは、APM への移行の一例です。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/APM2.cs#10)]
+ [!code-vb[Conceptual.AsyncInterop#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/APM2.vb#10)]  
+  
+<a name="EAP"></a>   
+## タスクとイベント ベースの非同期パターン \(EAP\)  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md) 実装をラップする手順は、APM パターンをラップするより複雑です。EAP パターンのほうが APM パターンよりもバリエーションが多く、構造化の程度が低いためです。  例を示すために、次のコードでは `DownloadStringAsync` メソッドをラップしています。`DownloadStringAsync` は、URI を受け付け、進行状況として複数の統計情報をレポートするためにダウンロード中に `DownloadProgressChanged` イベントを発生させ、完了時に `DownloadStringCompleted` イベントを発生させます。  最終結果は、指定された URI にあるページのコンテンツを含む文字列です。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#11](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/EAP1.cs#11)]
+ [!code-vb[Conceptual.AsyncInterop#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/EAP1.vb#11)]  
+  
+<a name="WaitHandles"></a>   
+## タスクおよび待機ハンドル  
+  
+<a name="WHToTap"></a>   
+### 待機ハンドルから TAP へ  
+ 待機ハンドルは非同期パターンを実装しませんが、上級開発者は、待機ハンドルが設定されるときに非同期の通知を行うため、<xref:System.Threading.WaitHandle> クラスおよび <xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A?displayProperty=fullName> メソッドを使用できます。<xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A> メソッドをラップすると、待機ハンドルのすべての同期待機をタスク ベースの待機にできます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#12](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Wait1.cs#12)]
+ [!code-vb[Conceptual.AsyncInterop#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/Wait1.vb#12)]  
+  
+ このメソッドにより、非同期メソッドで既存の <xref:System.Threading.WaitHandle> 実装を使用できます。  たとえば、特定の時点に実行する非同期操作の数を絞り込む場合は、セマフォ \(<xref:System.Threading.SemaphoreSlim?displayProperty=fullName> オブジェクト\) を利用できます。  セマフォのカウントを *N* に初期化し、操作を実行するときには常にセマフォを待機し、操作完了時にセマフォを解放することで、同時実行される操作の数を *N* に絞り込むことができます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Semaphore1.cs#13)]
+ [!code-vb[Conceptual.AsyncInterop#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/Semaphore1.vb#13)]  
+  
+ また、待機ハンドルに依存せず、代わりにタスクで完全に動作する非同期セマフォもビルドできます。 これを行うには、<xref:System.Threading.Tasks.Task> の上位にデータ構造をビルドするという「[Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)」で説明されている手法を使用します。  
+  
+<a name="TapToWH"></a>   
+### TAP から待機ハンドルへ  
+ 前述のとおり、<xref:System.Threading.Tasks.Task> クラスは、<xref:System.IAsyncResult> を実装し、その実装は <xref:System.Threading.Tasks.Task.System%23IAsyncResult%23AsyncWaitHandle%2A> プロパティを公開します。このプロパティは、<xref:System.Threading.Tasks.Task> が完了したときに設定される待機ハンドルを返します。<xref:System.Threading.WaitHandle> の <xref:System.Threading.Tasks.Task> は次のように取得できます。  
+  
+ [!code-csharp[Conceptual.AsyncInterop#14](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.AsyncInterop/cs/Wait1.cs#14)]
+ [!code-vb[Conceptual.AsyncInterop#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.AsyncInterop/vb/Wait1.vb#14)]  
+  
+## 参照  
+ [Task\-based Asynchronous Pattern \(TAP\)](../../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md)   
+ [Implementing the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md)   
+ [Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md b/docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md
new file mode 100644
index 00000000000..82037cc05d2
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/multithreaded-programming-with-the-event-based-asynchronous-pattern.md
@@ -0,0 +1,65 @@
+---
+title: "Multithreaded Programming with the Event-based Asynchronous Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Event-based Asynchronous Pattern"
+  - "ProgressChangedEventArgs class"
+  - "BackgroundWorker component"
+  - "events [.NET Framework], asynchronous"
+  - "AsyncOperationManager class"
+  - "threading [.NET Framework], asynchronous features"
+  - "components [.NET Framework], asynchronous"
+  - "AsyncOperation class"
+  - "AsyncCompletedEventArgs class"
+ms.assetid: 958d6617-5e70-4b36-b5db-63c16dc35e43
+caps.latest.revision: 19
+author: "dotnet-bot"
+ms.author: "dotnetcontent"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Multithreaded Programming with the Event-based Asynchronous Pattern
+非同期機能をクライアント コードに公開する方法は数多くあります。  イベント ベースの非同期パターンは、非同期動作を示すクラスに対して推奨される方法を規定します。  
+  
+## このセクションの内容  
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)  
+ イベント ベースの非同期パターンによって、マルチスレッド デザイン固有の多くの複雑な問題を気にせずに、マルチスレッド アプリケーションの利点を活用できるしくみを説明します。  
+  
+ [Implementing the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-event-based-asynchronous-pattern.md)  
+ 非同期機能を持つクラスをパッケージ化するための標準的な方法について説明します。  
+  
+ [イベントベースの非同期パターンを実装するための推奨される手順](../../../docs/standard/asynchronous-programming-patterns/best-practices-for-implementing-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンに従って非同期機能を公開するための要件について説明します。  
+  
+ [Deciding When to Implement the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/deciding-when-to-implement-the-event-based-asynchronous-pattern.md)  
+ どのような場合に、<xref:System.IAsyncResult> パターンではなく、イベント ベースの非同期パターンの実装を選択するかを判断する方法について説明します。  
+  
+ [Walkthrough: Implementing a Component That Supports the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/component-that-supports-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンを実装するコンポーネントの作成方法を示します。  これは、<xref:System.ComponentModel?displayProperty=fullName> 名前空間のヘルパー クラスを使用して実装します。これにより、コンポーネントは任意のアプリケーション モデルで正常に動作します。  
+  
+ [How to: Use Components That Support the Event\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/how-to-use-components-that-support-the-event-based-asynchronous-pattern.md)  
+ イベント ベースの非同期パターンをサポートするコンポーネントの使用方法について説明します。  
+  
+## 関連項目  
+ <xref:System.ComponentModel.AsyncOperation>  
+ <xref:System.ComponentModel.AsyncOperation> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.ComponentModel.AsyncOperationManager>  
+ <xref:System.ComponentModel.AsyncOperationManager> クラスについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ <xref:System.ComponentModel.BackgroundWorker> コンポーネントについて説明し、すべてのメンバーへのリンクの一覧を示します。  
+  
+## 参照  
+ [Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)   
+ [イベント](../../../docs/standard/events/index.md)   
+ [コンポーネントのマルチスレッド](../Topic/Multithreading%20in%20Components.md)   
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md b/docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md
new file mode 100644
index 00000000000..5925c5aabb3
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md
@@ -0,0 +1,38 @@
+---
+title: "Polling for the Status of an Asynchronous Operation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "asynchronous programming, status polling"
+  - "polling asynchronous operation status"
+  - "status information [.NET Framework], asynchronous operations"
+ms.assetid: b541af31-dacb-4e20-8847-1b1ff7c35363
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Polling for the Status of an Asynchronous Operation
+非同期操作の結果を待っている間に他の作業を行うことができるアプリケーションは、操作が完了するまで待機をブロックしないでください。  非同期操作の完了を待っている間に、命令の実行を継続するには、次のいずれかのオプションを使用します。  
+  
+-   操作が完了したかどうかを確認するには、非同期操作の **\[開始\]** *OperationName* のメソッドによって返される <xref:System.IAsyncResult> の <xref:System.IAsyncResult.IsCompleted%2A> のプロパティを使用します。  この方法はポーリングと呼ばれます。これについては、このトピックで説明します。  
+  
+-   <xref:System.AsyncCallback> デリゲートを使用して、個別のスレッド内の非同期操作の結果を処理します。  この方法の実行例については、「[Using an AsyncCallback Delegate to End an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md)」を参照してください。  
+  
+## 例  
+ <xref:System.Net.Dns> クラスで非同期メソッドを使用して、ユーザー指定のコンピューターのドメイン ネーム システム \(DNS\) 情報を取得するコード例を次に示します。  この例では、非同期操作を開始し、操作が完了するまでコンソールにピリオド \("."\) を出力します。  ここで使用する方法では、<xref:System.Net.Dns.BeginGetHostByName%2A> の <xref:System.AsyncCallback> パラメーターと <xref:System.Object> パラメーターは不要なので、これらのパラメーターには **null** \(Visual Basic では **Nothing**\) が渡されます。  
+  
+ [!code-csharp[AsyncDesignPattern#3](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDesignPattern/CS/Async_Poll.cs#3)]
+ [!code-vb[AsyncDesignPattern#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDesignPattern/VB/Async_Poll.vb#3)]  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md b/docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md
new file mode 100644
index 00000000000..5c5aa6c3498
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md
@@ -0,0 +1,203 @@
+---
+title: "Task-based Asynchronous Pattern (TAP) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, and TAP"
+  - "asynchronous design patterns, .NET Framework"
+  - "TAP, .NET Framework support for"
+  - "Task-based Asynchronous Pattern, .NET Framework support for"
+  - ".NET Framework, asynchronous design patterns"
+ms.assetid: 8cef1fcf-6f9f-417c-b21f-3fd8bac75007
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Task-based Asynchronous Pattern (TAP)
+タスク ベースの非同期パターン \(TAP\) は、任意の非同期操作を表すために使用される <xref:System.Threading.Tasks?displayProperty=fullName> 名前空間の <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型および <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> 型に基づいています。  TAP は、新規開発に推奨の非同期デザイン パターンです。  
+  
+## 名前付け、パラメーター、および戻り値の型  
+ TAP では、非同期操作の開始と終了を表すために単一のメソッドが使用されます。  これは、`Begin` メソッドと `End` メソッドが必要になる非同期プログラミング モデル \(APM または `IAsyncResult`\) パターンや、`Async` サフィックスの付いたメソッドと、1 つ以上のイベント、イベント ハンドラーのデリゲート型、および `EventArg` 派生型も必要になるイベント ベースの非同期パターン \(EAP\) とは対照的です。  TAP の非同期操作は、操作名の後に `Async` サフィックスが付きます。たとえば、取得 \(Get\) 操作の場合は `GetAsync` になります。  既に `Async` サフィックスの付いたメソッド名を含むクラスに TAP メソッドを追加する場合は、代わりに `TaskAsync` サフィックスを使用します。  たとえば、既にクラスに `GetAsync` メソッドが含まれている場合は、`GetTaskAsync` という名前を使用します。  
+  
+ 対応する同期メソッドにより void または `TResult` 型が返されるかどうかに応じて、TAP メソッドは <xref:System.Threading.Tasks.Task?displayProperty=fullName> または <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> を返します。  
+  
+ TAP メソッドのパラメーターには、対応する同期メソッドと同じパラメーターを、同じ順序で指定する必要があります。  ただし、`out` パラメーターと `ref` パラメーターはこの規則に該当せず、すべて回避する必要があります。  `out` パラメーターまたは `ref` パラメーターで返されるデータは、代わりに複数の値を格納するために、タプルまたはカスタム データ構造を使用して、<xref:System.Threading.Tasks.Task%601> により返される `TResult` の一部として返す必要があります。  タスクの作成、操作、または組み合わせのためだけに使用されるメソッド \(メソッド名またはメソッドが属する型の名前でメソッドの非同期の意図が明確な場合\) は、この名前付けパターンに従う必要はありません。このようなメソッドは、*連結子*と呼ばれることもあります。  連結子の例には、<xref:System.Threading.Tasks.Task.WhenAll%2A> および <xref:System.Threading.Tasks.Task.WhenAny%2A> があります。詳細については、記事「[Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)」の「[タスク ベースの組み込み連結子の使用](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md#combinators)」セクションを参照してください。  
+  
+ 非同期プログラミング モデル \(APM\) やイベント ベースの非同期パターン \(EAP\) など、従来の非同期プログラミング パターンで使用される構文とは異なる TAP 構文の例については、「[Asynchronous Programming Patterns](../../../docs/standard/asynchronous-programming-patterns/index.md)」を参照してください。  
+  
+## 非同期操作の開始  
+ TAP に基づく非同期メソッドは、引数の検証や非同期操作の開始などの少量の作業を同期をとって実行してから結果のタスクを返すことができます。  このような同期作業は必要最低限にし、非同期メソッドからすぐに制御を戻すようにします。  制御をすぐに戻す理由は次のとおりです。  
+  
+-   非同期メソッドはユーザー インターフェイス \(UI\) スレッドから呼び出される可能性があるため、同期作業の実行に時間がかかると、アプリケーションの応答性が低下します。  
+  
+-   複数の非同期メソッドが同時に起動される可能性があります。  そのため、非同期メソッドの同期部分の作業に時間がかかると、他の非同期操作の開始が遅れ、同時実行の利点が低減します。  
+  
+ 場合によっては、操作の完了に必要な作業の量は、操作を非同期に起動するのに必要な作業量よりも少なくなります。  このようなシナリオの例にはストリームからの読み取りがあり、既にメモリ バッファーにあるデータを読み取ることで読み取り操作が完了する場合です。  このような場合は、操作を同期をとって実行し、既に完了しているタスクを返すことができます。  
+  
+## 例外  
+ 非同期メソッドは、使用エラーに応答して非同期メソッド呼び出しからスローされる例外のみを発生する必要があります。  運用コードでは使用エラーを発生させないようにする必要があります。  たとえば、null 参照 \(Visual Basic では `Nothing`\) がメソッドの引数の 1 つとして渡されたときにエラー状態 \(通常 <xref:System.ArgumentNullException> によって表される\) が発生する場合、呼び出し元のコードを変更して null 参照が渡されないようにします。  他のエラーの場合はすべて、非同期メソッドの実行中に発生する例外を、返されるタスクに割り当てます。これは、タスクが返される前に非同期メソッドが同期をとって行われる場合でも同じです。  通常、タスクに含まれる例外は最大でも 1 つです。  ただし、タスクが複数の操作 \(<xref:System.Threading.Tasks.Task.WhenAll%2A> など\) を表す場合は、複数の例外を単一タスクに関連付けることができます。  
+  
+## 対象の環境  
+ TAP メソッドを実装するときに、非同期実行をどこで行うかを決定できます。  スレッド プールで作業負荷を実行したり、\(操作実行のほとんどでスレッドにバインドされないように\) 非同期 I\/O を使用して実装したり、特定のスレッド \(UI スレッドなど\) で実行したり、任意の数の可能なコンテキストを使用したりすることができます。  TAP メソッドは実行する内容がなく、システム内の他の場所で特定の条件が発生していること \(データがキューに置かれたデータ構造に到達したことを表すタスクなど\) を表す <xref:System.Threading.Tasks.Task> を単に返すこともあります。TAP メソッドの呼び出し元は、結果のタスク上で非同期に待機することで、TAP メソッドが完了するまでの待機をブロックするか、非同期操作が完了したときに追加コード \(継続コード\) を実行することができます。  継続コードの作成者は、そのコードが実行される場所を制御できます。  継続コードは、<xref:System.Threading.Tasks.Task> クラス \(<xref:System.Threading.Tasks.Task.ContinueWith%2A> など\) のメソッドによって明示的に作成するか、継続の上位にビルドされる言語サポート \(C\# の `await`、Visual Basic の `Await`、F\# の `AwaitValue` など\) を使用して暗黙のうちに作成できます。  
+  
+## タスク ステータス  
+ <xref:System.Threading.Tasks.Task> クラスは、非同期操作の有効期間を提供し、そのサイクルは、<xref:System.Threading.Tasks.TaskStatus> 列挙型によって表されます。  <xref:System.Threading.Tasks.Task> および <xref:System.Threading.Tasks.Task%601> から派生する型のコーナー ケースに加え、スケジューリングからの構造の分離をサポートするために、<xref:System.Threading.Tasks.Task> クラスは <xref:System.Threading.Tasks.Task.Start%2A> メソッドを公開します。  <xref:System.Threading.Tasks.Task> パブリック コンストラクターにより作成されるタスクは、ライフ サイクルがスケジュールされていない <xref:System.Threading.Tasks.TaskStatus> 状態から始まり、これらのインスタンスで <xref:System.Threading.Tasks.Task.Start%2A> が呼び出されるときにのみスケジュールされることから、*コールド タスク*と呼ばれます。  他のすべてのタスクは、ホットな状態からライフ サイクルが始まります。つまり、タスクが表す非同期操作が既に開始され、それらのタスクの状態は <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 以外の列挙値であることを意味します。  TAP メソッドから返されるすべてのタスクをアクティブにする必要があります。  TAP メソッドが返すタスクをインスタンス化するためにタスクのコンストラクターを内部使用する場合、TAP メソッドはタスクを返す前に <xref:System.Threading.Tasks.Task.Start%2A> オブジェクトで <xref:System.Threading.Tasks.Task> を呼び出す必要があります。  TAP メソッドのコンシューマーは、返されたタスクがアクティブであるものと推定しても問題はなく、TAP メソッドから返された <xref:System.Threading.Tasks.Task.Start%2A> 上で <xref:System.Threading.Tasks.Task> 呼び出しを試行しないようにする必要があります。  アクティブなタスク上で <xref:System.Threading.Tasks.Task.Start%2A> を呼び出すと、<xref:System.InvalidOperationException> 例外になります。  
+  
+## 取り消し \(省略可能\)  
+ TAP では、取り消しは非同期メソッドの実装側とコンシューマーのどちらでも省略可能です。  操作の取り消しを許可する場合、キャンセル トークン \(<xref:System.Threading.CancellationToken> インスタンス\) を受け取る非同期メソッドのオーバーロードを公開します。  規則により、パラメーターには `cancellationToken` という名前が付けられます。  
+  
+ [!code-csharp[Conceptual.TAP#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap/cs/examples1.cs#1)]
+ [!code-vb[Conceptual.TAP#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap/vb/examples1.vb#1)]  
+  
+ 非同期操作は取り消し要求に対してこのトークンを監視します。  取り消し要求を受け取ると、その要求を受け入れて操作を取り消すことができます。  取り消し要求によって作業が途中で終了する場合、TAP メソッドは <xref:System.Threading.Tasks.TaskStatus> 状態で終了するタスクを返します。使用できる結果はなく、例外もスローされません。  <xref:System.Threading.Tasks.TaskStatus> 状態は、<xref:System.Threading.Tasks.TaskStatus> 状態や <xref:System.Threading.Tasks.TaskStatus> 状態と共に、タスクの最終状態 \(完了状態\) と見なされます。  したがって、タスクが <xref:System.Threading.Tasks.TaskStatus> 状態の場合、<xref:System.Threading.Tasks.Task.IsCompleted%2A> プロパティは `true` を返します。  タスクが <xref:System.Threading.Tasks.TaskStatus> 状態で完了した場合、<xref:System.Threading.Tasks.TaskContinuationOptions> など、継続のオプションを継続から除外するよう指定されていない限り、タスクに登録された継続がスケジュールまたは実行されます。  言語機能を使用して取り消されたタスクを非同期に待機するコードは実行を継続しますが、<xref:System.OperationCanceledException> またはその派生例外を受け取ります。  <xref:System.Threading.Tasks.Task.Wait%2A> や <xref:System.Threading.Tasks.Task.WaitAll%2A> などのメソッドによってタスクでの同期をとって待機している状態をブロックされたコードも、例外を伴って実行を継続します。  
+  
+ キャンセル トークンが、トークンを受け取る TAP メソッドが呼び出される前に取り消しを要求していた場合、TAP メソッドは <xref:System.Threading.Tasks.TaskStatus> タスクを返す必要があります。  ただし、非同期操作の実行中に取り消し要求が出される場合、その非同期操作は取り消し要求を受け取る必要はありません。  取り消し要求の結果として操作が完了した場合にのみ、返されたタスクが <xref:System.Threading.Tasks.TaskStatus> 状態で終了します。  取り消しが要求されても、結果 \(例外\) が依然として生成される場合、タスクは <xref:System.Threading.Tasks.TaskStatus> 状態または <xref:System.Threading.Tasks.TaskStatus> 状態で終了します。  開発者が何よりもまず取り消すことを目的に使用する非同期メソッドの場合は、キャンセル トークンを受け取らないオーバーロードを用意する必要はありません。  取り消せないメソッドの場合、キャンセル トークンを受け取るオーバーロードを用意しません。これにより、ターゲット メソッドが実際に取り消し可能かどうかを呼び出し元に示すことができます。  取り消しを望まないコンシューマー コードは、<xref:System.Threading.CancellationToken> を受け取るメソッドを呼び出し、引数値として <xref:System.Threading.CancellationToken.None%2A> を指定することができます。  <xref:System.Threading.CancellationToken.None%2A> は、既定の <xref:System.Threading.CancellationToken> と機能的には同じです。  
+  
+## 進行状況のレポート \(省略可能\)  
+ 一部の非同期操作では、進行状況の通知を行うことで利点が得られます。進行状況の通知は、通常、非同期操作の進行状況に関する情報でユーザー インターフェイスを更新するために使用されます。  TAP では、進行状況が、通常 `progress` という名前のパラメーターとして非同期メソッドに渡される <xref:System.IProgress%601> インターフェイスによって処理されます。  非同期メソッドの呼び出し時に進行状況インターフェイスを指定することで、不適切な使用方法により発生する競合状態 \(操作の開始後に不適切に登録されたイベント ハンドラーで更新を検出できない場合\) を排除できます。  さらに重要なのは、コンシューマー コードの判断に応じて、進行状況インターフェイスがさまざまな実装方法の進行状況をサポートできるようにすることです。  たとえば、コンシューマー コードが最新の進行状況の更新のみに留意する場合、すべての更新をバッファーに格納することを望む場合、各更新の操作を呼び出すことを望む場合、呼び出しを特定のスレッドにマーシャリングするかどうかの制御を望む場合が考えられます。  これらはすべて、インターフェイスの異なる実装を使用して行うことができ、各実装を特定のコンシューマー ニーズに合わせてカスタマイズできます。  取り消しと同様、TAP の実装では、API が進行状況通知をサポートする場合にのみ、<xref:System.IProgress%601> パラメーターを指定する必要があります。  たとえば、前に説明した `ReadAsync` メソッドが読み取り済みのバイト数の形式で中間進行状況を報告できる場合、進行状況のコールバックは <xref:System.IProgress%601> インターフェイスとなることが考えられます。  
+  
+ [!code-csharp[Conceptual.TAP#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap/cs/examples1.cs#2)]
+ [!code-vb[Conceptual.TAP#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap/vb/examples1.vb#2)]  
+  
+ `FindFilesAsync` メソッドが特定の検索パターンに合ったすべてのファイルのリストを返す場合は、進行状況のコールバックで、完了した作業の割合の見積りに加え、現在の部分的な結果セットを示すことが考えられます。  これは、タプルで行ったり、  
+  
+ [!code-csharp[Conceptual.TAP#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap/cs/examples1.cs#3)]
+ [!code-vb[Conceptual.TAP#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap/vb/examples1.vb#3)]  
+  
+ または次のように API 固有のデータ型で行うことができます。  
+  
+ [!code-csharp[Conceptual.TAP#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.tap/cs/examples1.cs#4)]
+ [!code-vb[Conceptual.TAP#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.tap/vb/examples1.vb#4)]  
+  
+ 後者の場合、特別なデータ型には通常 `ProgressInfo` サフィックスを付けます。  
+  
+ TAP の実装が `progress` パラメーターを受け取るオーバーロードを用意している場合、`null` の引数を許可し、進行状況を報告しないことを許可する必要があります。  TAP の実装は、<xref:System.Progress%601> オブジェクトに進行状況を同期をとって報告して、非同期メソッドが速やかに進行状況を提供し、進行状況のコンシューマーが、最適な情報の処理方法と処理場所を判断できるようにします。  たとえば、進行状況のインスタンスはコールバックをマーシャリングし、キャプチャされた同期コンテキストでイベントを発生するように選択することができます。  
+  
+## IProgress\<T\> の実装  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は、単一の <xref:System.IProgress%601> implementation: <xref:System.Progress%601> 実装を提供します。  <xref:System.Progress%601> クラスは次のように宣言されます。  
+  
+```csharp  
+  
+public class Progress<T> : IProgress<T>  
+{  
+    public Progress();  
+    public Progress(Action<T> handler);  
+    protected virtual void OnReport(T value);  
+    public event EventHandler<T> ProgressChanged;  
+}  
+  
+```  
+  
+```vb  
+  
+Public Class Progress(Of T) : Inherits IProgress(Of T)  
+    Public Sub New()  
+    Public Sub New(handler As Action(Of T))  
+    Protected Overridable Sub OnReport(value As T)  
+    Public Event ProgressChanged As EventHandler(Of T>  
+End Class  
+  
+```  
+  
+ <xref:System.Progress%601> のインスタンスは、非同期操作が進行状況の更新を報告するたびに発生する <xref:System.Progress%601.ProgressChanged> イベントを公開します。  <xref:System.Progress%601.ProgressChanged> イベントは、<xref:System.Threading.SynchronizationContext> インスタンスがインスタンス化されたときにキャプチャされた <xref:System.Progress%601> オブジェクトで発生します。  同期コンテキストを利用できない場合は、スレッド プールをターゲットとして、既定のコンテキストが使用されます。  ハンドラーは、このイベントに登録することができます。  1 つのハンドラーは、利便性のために <xref:System.Progress%601> コンストラクターにも提供でき、<xref:System.Progress%601.ProgressChanged> イベントのイベント ハンドラーと同様に作動します。  進行状況の更新は、イベント ハンドラーの実行中、非同期操作を遅延しないように、非同期に発生します。  別のセマンティクスを適用するため、別の <xref:System.IProgress%601> の実装を選択できます。  
+  
+## 提供するオーバーロードの選択  
+ ともに省略可能な <xref:System.Threading.Tasks.TaskFactory.CancellationToken%2A> パラメーターと <xref:System.IProgress%601> パラメーターの両方を TAP の実装に使用すると、4 つまでオーバーロードを要求することができます。  
+  
+```csharp  
+  
+public Task MethodNameAsync(…);  
+public Task MethodNameAsync(…, CancellationToken cancellationToken);  
+public Task MethodNameAsync(…, IProgress<T> progress);   
+public Task MethodNameAsync(…,   
+    CancellationToken cancellationToken, IProgress<T> progress);  
+  
+```  
+  
+```vb  
+  
+Public MethodNameAsync(…) As Task  
+Public MethodNameAsync(…, cancellationToken As CancellationToken cancellationToken) As Task  
+Public MethodNameAsync(…, progress As IProgress(Of T)) As Task   
+Public MethodNameAsync(…, cancellationToken As CancellationToken,   
+                       progress As IProgress(Of T)) As Task  
+  
+```  
+  
+ ただし、TAP の実装の多くは取り消しまたは進行状況の機能を提供しないため、必要なメソッドは 1 つです。  
+  
+```csharp  
+public Task MethodNameAsync(…);  
+```  
+  
+```vb  
+Public MethodNameAsync(…) As Task  
+```  
+  
+ TAP の実装で取り消しまたは進行状況の両方ではなく、いずれかを一方をサポートする場合は、実装に 2 つのオーバーロードを提供することができます。  
+  
+```csharp  
+  
+public Task MethodNameAsync(…);  
+public Task MethodNameAsync(…, CancellationToken cancellationToken);  
+  
+// … or …  
+  
+public Task MethodNameAsync(…);  
+public Task MethodNameAsync(…, IProgress<T> progress);  
+  
+```  
+  
+```vb  
+  
+Public MethodNameAsync(…) As Task  
+Public MethodNameAsync(…, cancellationToken As CancellationToken) As Task  
+  
+' … or …  
+  
+Public MethodNameAsync(…) As Task  
+Public MethodNameAsync(…, progress As IProgress(Of T)) As Task  
+  
+```  
+  
+ TAP の実装で取り消しおよび進行状況の両方をサポートする場合は、4 種類のオーバーロードをすべて公開できます。  ただし、次の 2 種類のみ提供することもできます。  
+  
+```csharp  
+  
+public Task MethodNameAsync(…);  
+public Task MethodNameAsync(…,   
+    CancellationToken cancellationToken, IProgress<T> progress);  
+  
+```  
+  
+```vb  
+  
+Public MethodNameAsync(…) As Task  
+Public MethodNameAsync(…, cancellationToken As CancellationToken,   
+                       progress As IProgress(Of T)) As Task  
+  
+```  
+  
+ 不足する 2 種類の中間の組み合わせを補足するために、開発者は `cancellationToken` パラメーターに <xref:System.Threading.CancellationToken.None%2A> または既定の <xref:System.Threading.CancellationToken> を渡したり、`progress` パラメーターに `null` を渡すことができます。  
+  
+ TAP メソッドに必ず取り消しや進行状況をサポートすることを想定する場合、必要なパラメーターを受け取らないオーバーロードは省略できます。  
+  
+ TAP メソッドの複数のオーバーロードを公開して取り消しや進行状況を省略可能にする場合、取り消しや進行状況をサポートしないオーバーロードは、これらをサポートするオーバーロードに、取り消しの場合は <xref:System.Threading.CancellationToken.None%2A>、進行状況の場合は `null` が渡されたように機能する必要があります。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[Asynchronous Programming Patterns](../../../docs/standard/asynchronous-programming-patterns/index.md)|非同期操作を実行するための 3 種類のパターンとして、タスク ベースの非同期パターン \(TAP\)、非同期プログラミング モデル \(APM\)、およびイベント ベースの非同期パターン \(EAP\) を紹介します。|  
+|[Implementing the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/implementing-the-task-based-asynchronous-pattern.md)|タスク ベースの非同期パターン \(TAP\) の実装の 3 つの方法として、Visual Studio の C\# および Visual Basic コンパイラを使用する方法、手動で行う方法、またはコンパイラと手動による方法を組み合わせた方法を説明します。|  
+|[Consuming the Task\-based Asynchronous Pattern](../../../docs/standard/asynchronous-programming-patterns/consuming-the-task-based-asynchronous-pattern.md)|タスクとコールバックを使用して、ブロックすることなく待機できる方法を説明します。|  
+|[Interop with Other Asynchronous Patterns and Types](../../../docs/standard/asynchronous-programming-patterns/interop-with-other-asynchronous-patterns-and-types.md)|タスク ベースの非同期パターン \(TAP\) を使用して、非同期プログラミング モデル \(APM\) とイベント ベースの非同期パターン \(EAP\) を実装する方法について説明します。|
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md b/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md
new file mode 100644
index 00000000000..7bf36d298e3
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md
@@ -0,0 +1,36 @@
+---
+title: "Using an AsyncCallback Delegate and State Object | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "asynchronous programming, delegates"
+  - "AsyncCallback delegate, samples"
+  - "asynchronous programming, state objects"
+  - "IAsyncResult interface, samples"
+ms.assetid: e3e5475d-c5e9-43f0-928e-d18df8ca1f1d
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Using an AsyncCallback Delegate and State Object
+別のスレッドで非同期操作の結果を処理するために <xref:System.AsyncCallback> デリゲートを使用するときには、状態オブジェクトを使用すると、コールバック間での情報の受け渡しおよび最終結果の取得ができます。  このトピックでは、「[Using an AsyncCallback Delegate to End an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md)」の例を拡張するその実例を示します。  
+  
+## 例  
+ <xref:System.Net.Dns> クラスで非同期メソッドを使用して、ユーザー指定のコンピューターのドメイン ネーム システム \(DNS\) 情報を取得するコード例を次に示します。  この例では、`HostRequest` クラスを定義および使用して、状態情報を格納します。  `HostRequest` オブジェクトは、ユーザーによって入力されたコンピューター名ごとに作成されます。  このオブジェクトは、<xref:System.Net.Dns.BeginGetHostByName%2A> メソッドに渡されます。  `ProcessDnsInformation` メソッドは、要求が完了するたびに呼び出されます。  `HostRequest` オブジェクトは、<xref:System.IAsyncResult.AsyncState%2A> プロパティを使用して取得されます。  `ProcessDnsInformation` メソッドは `HostRequest` オブジェクトを使用して、要求によって返された <xref:System.Net.IPHostEntry> または要求によってスローされた <xref:System.Net.Sockets.SocketException> を格納します。  すべての要求が完了すると、アプリケーションは `HostRequest` オブジェクトを反復処理し、DNS 情報または <xref:System.Net.Sockets.SocketException> エラー メッセージを表示します。  
+  
+ [!code-csharp[AsyncDesignPattern#5](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDesignPattern/CS/AsyncDelegateWithStateObject.cs#5)]
+ [!code-vb[AsyncDesignPattern#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDesignPattern/VB/AsyncDelegateWithStateObject.vb#5)]  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)   
+ [Using an AsyncCallback Delegate to End an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md)
\ No newline at end of file
diff --git a/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md b/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md
new file mode 100644
index 00000000000..7c04607d058
--- /dev/null
+++ b/docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-to-end-an-asynchronous-operation.md
@@ -0,0 +1,43 @@
+---
+title: "Using an AsyncCallback Delegate to End an Asynchronous Operation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ending asynchronous operations"
+  - "asynchronous programming, ending operations"
+  - "AsyncCallback delegate"
+  - "stopping asynchronous operations"
+ms.assetid: 9d97206c-8917-406c-8961-7d0909d84eeb
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Using an AsyncCallback Delegate to End an Asynchronous Operation
+非同期操作の結果を待っている間に他の作業を行うことができるアプリケーションは、操作が完了するまで待機をブロックしないでください。  非同期操作の完了を待っている間に、命令の実行を継続するには、次のいずれかのオプションを使用します。  
+  
+-   <xref:System.AsyncCallback> デリゲートを使用して、個別のスレッド内の非同期操作の結果を処理します。  この方法については、このトピックで説明します。  
+  
+-   操作が完了したかどうかを確認するには、非同期操作の **\[開始\]** *OperationName* のメソッドによって返される <xref:System.IAsyncResult> の <xref:System.IAsyncResult.IsCompleted%2A> のプロパティを使用します。  この方法の実行例については、「[Polling for the Status of an Asynchronous Operation](../../../docs/standard/asynchronous-programming-patterns/polling-for-the-status-of-an-asynchronous-operation.md)」を参照してください。  
+  
+## 例  
+ <xref:System.Net.Dns> クラスで非同期メソッドを使用して、ユーザー指定のコンピューターのドメイン ネーム システム \(DNS\) 情報を取得するコード例を次に示します。  この例では、`ProcessDnsInformation` メソッドを参照する <xref:System.AsyncCallback> デリゲートを作成します。  このメソッドは、DNS 情報の非同期要求を行うたびに一度だけ呼び出されます。  
+  
+ ユーザー指定のホストが <xref:System.Net.Dns.BeginGetHostByName%2A> <xref:System.Object> パラメーターに渡される点に注意してください。  さらに複雑な状態オブジェクトの定義および使い方の例については、「[Using an AsyncCallback Delegate and State Object](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md)」を参照してください。  
+  
+ [!code-csharp[AsyncDesignPattern#4](../../../samples/snippets/csharp/VS_Snippets_CLR/AsyncDesignPattern/CS/AsyncDelegateNoStateObject.cs#4)]
+ [!code-vb[AsyncDesignPattern#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/AsyncDesignPattern/VB/AsyncDelegateNoState.vb#4)]  
+  
+## 参照  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)   
+ [Event\-based Asynchronous Pattern Overview](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-overview.md)   
+ [Calling Asynchronous Methods Using IAsyncResult](../../../docs/standard/asynchronous-programming-patterns/calling-asynchronous-methods-using-iasyncresult.md)   
+ [Using an AsyncCallback Delegate and State Object](../../../docs/standard/asynchronous-programming-patterns/using-an-asynccallback-delegate-and-state-object.md)
\ No newline at end of file
diff --git a/docs/standard/attributes/TOC.md b/docs/standard/attributes/TOC.md
new file mode 100644
index 00000000000..c001a49cb73
--- /dev/null
+++ b/docs/standard/attributes/TOC.md
@@ -0,0 +1,4 @@
+# [属性の適用](applying-attributes.md)
+# [カスタム属性の記述](writing-custom-attributes.md)
+# [属性に格納されている情報の取得](retrieving-information-stored-in-attributes.md)
+# [属性](index.md)
diff --git a/docs/standard/attributes/applying-attributes.md b/docs/standard/attributes/applying-attributes.md
new file mode 100644
index 00000000000..caf818c30e4
--- /dev/null
+++ b/docs/standard/attributes/applying-attributes.md
@@ -0,0 +1,59 @@
+---
+title: "属性の適用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 属性"
+  - "属性 [.NET Framework], 適用"
+ms.assetid: dd7604eb-9fa3-4b60-b2dd-b47739fa3148
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 属性の適用
+コードの要素に属性を適用するには、次のプロセスを使用します。  
+  
+1.  新しい属性を定義するか、または .NET Framework から名前空間をインポートして既存の属性を使用します。  
+  
+2.  属性をコード要素の直前に記述することで、その要素に属性を適用します。  
+  
+     各言語には独自の属性構文があります。  C\+\+ および C\# では、属性が角かっこで囲まれ、要素とは空白で区切られます。属性と要素の間には改行を入れることもできます。  Visual Basic では、属性が山かっこで囲まれ、同じ論理行に記述されている必要があります。改行が必要な場合は、行連結文字を使用できます。  J\# では、特殊なコメント構文を使用して属性がアタッチされます。  
+  
+3.  属性に、位置指定パラメーターと名前付きパラメーターを指定します。  
+  
+     位置指定パラメーターは必須で、名前付きパラメーターの前に指定する必要があります。位置指定パラメーターは、属性のいずれかのコンストラクターのパラメーターに対応します。  名前付きパラメーターは省略可能で、属性の読み取り\/書き込みプロパティに対応します。  C\+\+、C\#、および J\# では、オプションのパラメーターごとに `name`\=`value` を指定します。`name` はプロパティの名前です。  Visual Basic では、`name`:\=`value` を指定します。  
+  
+ コードをコンパイルすると属性がメタデータに格納され、ランタイム リフレクション サービスを通じて共通言語ランタイム、すべてのカスタム ツールやアプリケーションで使用できるようになります。  
+  
+ 規則では、属性の名前の最後は Attribute にします。  ただし、Visual Basic や C\# など、ランタイムを対象とする言語では、属性をフルネームで指定する必要はありません。  たとえば、<xref:System.ObsoleteAttribute?displayProperty=fullName> を初期化する場合は、**Obsolete** と指定するだけで参照できます。  
+  
+## メソッドへの属性の適用  
+ 次の例では、**System.ObsoleteAttribute** をどのように宣言するかを解説しています。これは、コードを互換性のために残されているものとして記述しておくために使用します。  文字列 `"Will be removed in next version"` が属性に渡されます。  属性が記述されているコードが呼び出された時点で、渡された文字列を示すコンパイラの警告が表示されます。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source1.cpp#3)]
+ [!code-csharp[Conceptual.Attributes.Usage#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source1.cs#3)]
+ [!code-vb[Conceptual.Attributes.Usage#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source1.vb#3)]  
+  
+## アセンブリ レベルでの属性の適用  
+ アセンブリ レベルで属性を適用する場合は、キーワード **assembly** \(Visual Basic では `Assembly`\) を使用します。  **AssemblyTitleAttribute** をアセンブリ レベルで適用するコードを次に示します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source1.cpp#2)]
+ [!code-csharp[Conceptual.Attributes.Usage#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source1.cs#2)]
+ [!code-vb[Conceptual.Attributes.Usage#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source1.vb#2)]  
+  
+ この属性が適用されると、ファイルのメタデータ部分のアセンブリ マニフェストの中に、文字列 `"My Assembly"` が挿入されます。  この属性を表示するには、[MSIL 逆アセンブラー \(Ildasm.exe\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用するか、または属性を取得するためのプログラムを作成します。  
+  
+## 参照  
+ [属性](../../../docs/standard/attributes/index.md)   
+ [属性に格納されている情報の取得](../../../docs/standard/attributes/retrieving-information-stored-in-attributes.md)   
+ [Concepts](../Topic/Attributed%20Programming%20Concepts.md)   
+ [属性](../Topic/Attributes%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/standard/attributes/index.md b/docs/standard/attributes/index.md
new file mode 100644
index 00000000000..42632aeb063
--- /dev/null
+++ b/docs/standard/attributes/index.md
@@ -0,0 +1,44 @@
+---
+title: "属性を使用したメタデータの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "注釈を付ける (プログラミング要素に)"
+  - "属性 [.NET Framework], メタデータ"
+  - "共通言語ランタイム, 属性"
+  - "要素 [.NET Framework], 属性"
+  - "拡張 (メタデータを)"
+  - "キーワードに似た記述的な宣言"
+  - "メタデータ, 拡張"
+  - "ランタイム, 属性"
+ms.assetid: 30386922-1e00-4602-9ebf-526b271a8b87
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 属性を使用したメタデータの拡張
+共通言語ランタイムでは、属性と呼ばれるキーワードに似た記述的な宣言を追加して、型、フィールド、メソッド、プロパティなどのプログラミング要素に注釈を付けることができます。  ランタイム用にコードをコンパイルすると、コードは Microsoft Intermediate Language \(MSIL\) に変換され、コンパイラによって生成されるメタデータと共に、ポータブル実行可能 \(PE\) ファイルに格納されます。  属性を使用すると、ランタイム リフレクション サービスで抽出できる記述的な情報をメタデータに追加できます。  属性は、<xref:System.Attribute?displayProperty=fullName> から派生する特殊なクラスのインスタンスを宣言するときに、コンパイラによって作成されます。  
+  
+ .NET Framework では、属性がさまざまな理由と目的で使用されます。  属性を使用して、データをシリアル化する方法を記述したり、セキュリティの適用に使用する特性を指定したりします。また、コードをデバッグしやすい状態に保つためにジャスト イン タイム \(JIT\) コンパイラによる最適化を制限する場合も、属性を使用します。  さらに、ファイル名やコードの作成者の記録、およびフォームの開発時にコントロールやメンバーを表示するかどうかの制御も、属性で指定します。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[属性の適用](../../../docs/standard/attributes/applying-attributes.md)|コードの要素に属性を適用する方法を説明します。|  
+|[カスタム属性の記述](../../../docs/standard/attributes/writing-custom-attributes.md)|カスタム属性クラスをデザインする方法を説明します。|  
+|[属性に格納されている情報の取得](../../../docs/standard/attributes/retrieving-information-stored-in-attributes.md)|実行コンテキストに読み込まれるコードのカスタム属性を取得する方法を説明します。|  
+|[メタデータと自己言及的なコンポーネント](../../../docs/standard/metadata-and-self-describing-components.md)|メタデータの概要と、.NET Framework のポータブル実行可能 \(PE\) ファイル内でメタデータがどのように実装されるかを説明します。|  
+|[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)|リフレクションのみのコンテキストでカスタム属性情報を取得する方法を説明します。|  
+  
+## 参照  
+ <xref:System.Attribute?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/attributes/retrieving-information-stored-in-attributes.md b/docs/standard/attributes/retrieving-information-stored-in-attributes.md
new file mode 100644
index 00000000000..72540b29e51
--- /dev/null
+++ b/docs/standard/attributes/retrieving-information-stored-in-attributes.md
@@ -0,0 +1,91 @@
+---
+title: "属性に格納されている情報の取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "属性 [.NET Framework], 取得"
+  - "複数の属性インスタンス"
+  - "取得 (属性を)"
+ms.assetid: 37dfe4e3-7da0-48b6-a3d9-398981524e1c
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 属性に格納されている情報の取得
+カスタム属性を取得するプロセスは簡単です。  まず、取得する属性のインスタンスを宣言します。  次に、<xref:System.Attribute.GetCustomAttribute%2A?displayProperty=fullName> メソッドを使用して、取得する属性の値に新しい属性を初期化します。  新しい属性が初期化されたら、そのプロパティを使用して値を取得できます。  
+  
+> [!IMPORTANT]
+>  このトピックでは、実行コンテキストに読み込まれるコードの属性を取得する方法について説明します。  リフレクション専用のコンテキストに読み込むコードの属性を取得するには、「[方法 : リフレクションのみのコンテキストにアセンブリを読み込む](../../../docs/framework/reflection-and-codedom/how-to-load-assemblies-into-the-reflection-only-context.md)」に示されているように、<xref:System.Reflection.CustomAttributeData> クラスを使用する必要があります。  
+  
+ ここでは、属性を取得する方法について説明します。  
+  
+-   [属性の 1 つのインスタンスの取得。](#cpconretrievingsingleinstanceofattribute)  
+  
+-   [同じスコープに適用された属性の複数のインスタンスの取得。](#cpconretrievingmultipleinstancesofattributeappliedtosamescope)  
+  
+-   [他のスコープに適用された属性の複数のインスタンスの取得。](#cpconretrievingmultipleinstancesofattributeappliedtodifferentscopes)  
+  
+<a name="cpconretrievingsingleinstanceofattribute"></a>   
+## 属性の 1 つのインスタンスの取得  
+ 前のセクションで説明した `DeveloperAttribute` が、クラス レベルで `MainApp` クラスに適用されている例を次に示します。  `GetAttribute` メソッドは、**GetCustomAttribute** を使用して、`DeveloperAttribute` に格納されている値をクラス レベルで取得し、コンソールに表示します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#18](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source3.cpp#18)]
+ [!code-csharp[Conceptual.Attributes.Usage#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source3.cs#18)]
+ [!code-vb[Conceptual.Attributes.Usage#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source3.vb#18)]  
+  
+ このプログラムは、実行されると次のテキストを表示します。  
+  
+```  
+The Name Attribute is: Joan Smith.  
+The Level Attribute is: 42.  
+The Reviewed Attribute is: True.  
+```  
+  
+ 属性が見つからない場合、**GetCustomAttribute** メソッドは `MyAttribute` を null 値に初期化します。  この例では、`MyAttribute` をチェックして、属性が見つからない場合はユーザーに通知します。  クラス スコープ内に `DeveloperAttribute` が見つからない場合は、コンソールに次のメッセージが表示されます。  
+  
+```  
+The attribute was not found.   
+```  
+  
+ この例では、属性の定義が現在の名前空間内にあることを想定しています。  属性の定義が現在の名前空間内にないときは、属性の定義がある名前空間をインポートする必要があります。  
+  
+<a name="cpconretrievingmultipleinstancesofattributeappliedtosamescope"></a>   
+## 同じスコープに適用された属性の複数のインスタンスの取得  
+ 前の例では、調べるクラスと検索する属性が <xref:System.Attribute.GetCustomAttribute%2A> に渡されています。  このコードが正常に機能するのは、属性の 1 つのインスタンスだけがクラス レベルで適用されているときです。  属性の複数のインスタンスが同じクラス レベルで適用されている場合は、**GetCustomAttribute** メソッドによってすべての情報を取得することはできません。  同じ属性の複数のインスタンスが同じスコープに適用されている場合は、<xref:System.Attribute.GetCustomAttributes%2A?displayProperty=fullName> を使用して、属性のすべてのインスタンスを配列に格納できます。  たとえば、`DeveloperAttribute` の 2 つのインスタンスが同じクラスのクラス レベルで適用されている場合は、両方の属性で見つかる情報を表示するように `GetAttribute` メソッドを変更できます。  ただし、同じレベルで複数の属性を適用するには、<xref:System.AttributeUsageAttribute> で **AllowMultiple** プロパティを **true** として属性を定義しておく必要があります。  
+  
+ **GetCustomAttributes** メソッドを使用して、指定したクラス内の `DeveloperAttribute` のすべてのインスタンスを参照する配列を作成する方法を次のコード例に示します。  すべての属性の値は、コンソールに表示されます。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#19](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source3.cpp#19)]
+ [!code-csharp[Conceptual.Attributes.Usage#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source3.cs#19)]
+ [!code-vb[Conceptual.Attributes.Usage#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source3.vb#19)]  
+  
+ 属性が見つからない場合、このコードはユーザーに警告を発します。  それ以外の場合は、`DeveloperAttribute` の両方のインスタンスに含まれている情報が表示されます。  
+  
+<a name="cpconretrievingmultipleinstancesofattributeappliedtodifferentscopes"></a>   
+## ほかのスコープに適用された属性の複数のインスタンスの取得  
+ <xref:System.Attribute.GetCustomAttributes%2A> メソッドと <xref:System.Attribute.GetCustomAttribute%2A> メソッドでは、クラス全体を検索してクラス内の属性のすべてのインスタンスを返すことはできません。  これらのメソッドが一度に検索するのは、指定された 1 つのメソッドまたは 1 つのメンバーだけです。  クラスのメンバーすべてに同じ属性が適用されていて、それらのメンバーに適用されたすべての属性の値を取得するには、すべてのメソッドやメンバーを個別に **GetCustomAttributes** と **GetCustomAttribute** に渡す必要があります。  
+  
+ パラメーターとしてクラスをとり、そのクラス レベルとそのクラスの各メソッドすべてについて `DeveloperAttribute` \(前に定義されています\) を検索するコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#20](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source3.cpp#20)]
+ [!code-csharp[Conceptual.Attributes.Usage#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source3.cs#20)]
+ [!code-vb[Conceptual.Attributes.Usage#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source3.vb#20)]  
+  
+ メソッド レベルまたはクラス レベルで `DeveloperAttribute` のインスタンスが見つからない場合、`GetAttribute` メソッドは属性が見つからなかったことをユーザーに通知し、属性が含まれないメソッド名またはクラス名を表示します。  属性が見つかった場合は、`Name`、`Level`、`Reviewed` の各フィールドがコンソールに表示されます。  
+  
+ 渡されたクラス内の各メソッドとメンバーを取得するには、<xref:System.Type> クラスのメンバーを使用します。  この例では、最初に **Type** オブジェクトを問い合わせて、クラス レベルの属性情報を取得しています。  次に、<xref:System.Type.GetMethods%2A?displayProperty=fullName> を使用して、すべてのメソッドのインスタンスを <xref:System.Reflection.MemberInfo?displayProperty=fullName> オブジェクトの配列に格納し、メソッド レベルの属性情報を取得します。  また、<xref:System.Type.GetProperties%2A?displayProperty=fullName> メソッドを使用してプロパティ レベルの属性を調べることも、<xref:System.Type.GetConstructors%2A?displayProperty=fullName> メソッドを使用してコンストラクター レベルの属性を調べることもできます。  
+  
+## 参照  
+ <xref:System.Type?displayProperty=fullName>   
+ <xref:System.Attribute.GetCustomAttribute%2A?displayProperty=fullName>   
+ <xref:System.Attribute.GetCustomAttributes%2A?displayProperty=fullName>   
+ [属性](../../../docs/standard/attributes/index.md)
\ No newline at end of file
diff --git a/docs/standard/attributes/writing-custom-attributes.md b/docs/standard/attributes/writing-custom-attributes.md
new file mode 100644
index 00000000000..dcbb9154480
--- /dev/null
+++ b/docs/standard/attributes/writing-custom-attributes.md
@@ -0,0 +1,162 @@
+---
+title: "カスタム属性の記述 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "AllowMultiple プロパティ"
+  - "属性クラス, 宣言"
+  - "属性 [.NET Framework], カスタム"
+  - "AttributeTargets 列挙型"
+  - "AttributeUsageAttribute クラス, カスタム属性"
+  - "カスタム属性"
+  - "Inherited プロパティ"
+  - "複数の属性インスタンス"
+ms.assetid: 97216f69-bde8-49fd-ac40-f18c500ef5dc
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# カスタム属性の記述
+独自のカスタム属性をデザインするために、多くの新しい概念を習得する必要はありません。 オブジェクト指向プログラミングに精通してクラスをデザインする方法を理解しているなら、必要な知識をほぼすべて持っています。 カスタム属性は、基本的には、<xref:System.Attribute?displayProperty=fullName> から直接的に派生したか間接的に派生した従来のクラスです。 従来のクラスと同じように、カスタム属性には、データを格納したり取得したりするメソッドが含まれます。  
+  
+ カスタム属性クラスを適切にデザインするための主要な手順は次のとおりです。  
+  
+-   [AttributeUsageAttribute を適用する](#cpconapplyingattributeusageattribute)  
+  
+-   [属性クラスを宣言する](#cpcondeclaringattributeclass)  
+  
+-   [コンストラクターを宣言する](#cpcondeclaringconstructors)  
+  
+-   [プロパティを宣言する](#cpcondeclaringproperties)  
+  
+ このセクションでは、これらの各手順について説明し、最後に[カスタム属性の例](#cpconcustomattributeexample)について説明します。  
+  
+<a name="cpconapplyingattributeusageattribute"></a>   
+## AttributeUsageAttribute を適用する  
+ カスタム属性宣言は **AttributeUsageAttribute** で始まり、属性クラスの主な特性のいくつかを定義します。 たとえば、属性が他のクラスによって継承されるかどうかを指定したり、属性を適用する要素を指定したりすることができます。 次のコード フラグメントは、**AttributeUsageAttribute** の使い方を示しています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#5](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#5)]
+ [!code-csharp[Conceptual.Attributes.Usage#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#5)]
+ [!code-vb[Conceptual.Attributes.Usage#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#5)]  
+  
+ <xref:System.AttributeUsageAttribute?displayProperty=fullName> には、カスタム属性を作成するために重要な 3 つのメンバーがあります。それらは、[AttributeTargets](#cpconwritingcustomattributesanchor1)、[Inherited](#cpconwritingcustomattributesanchor2)、[AllowMultiple](#cpconwritingcustomattributesanchor3) です。  
+  
+<a name="cpconwritingcustomattributesanchor1"></a>   
+### AttributeTargets メンバー  
+ 前の例では、**AttributeTargets.All** を指定し、この属性をすべてのプログラム要素に適用できることが示されています。 代わりに、属性をクラスにのみ適用できることを示す **AttributeTargets.Class** を指定するか、属性をメソッドにのみ適用できることを示す **AttributeTargets.Method** を指定できます。 この方法で、カスタム属性を使って、説明としてすべてのプログラム要素をマークすることができます。  
+  
+ また、<xref:System.AttributeTargets> の複数のインスタンスを渡すこともできます。 次のコード フラグメントは、すべてのクラスやメソッドに適用できるカスタム属性を指定します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#6)]
+ [!code-csharp[Conceptual.Attributes.Usage#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#6)]
+ [!code-vb[Conceptual.Attributes.Usage#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#6)]  
+  
+<a name="cpconwritingcustomattributesanchor2"></a>   
+### Inherited プロパティ  
+ <xref:System.AttributeUsageAttribute.Inherited%2A?displayProperty=fullName> プロパティは、属性が、その属性が適用されたクラスから派生したクラスによって継承可能かどうかを示します。 このプロパティは、**true** \(既定\) か **false** フラグのいずれかを使います。 たとえば、次の例で、`MyAttribute` は **true** の既定の <xref:System.AttributeUsageAttribute.Inherited%2A> 値が指定されていますが、`YourAttribute` は **false** の <xref:System.AttributeUsageAttribute.Inherited%2A> 値が指定されています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#7](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#7)]
+ [!code-csharp[Conceptual.Attributes.Usage#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#7)]
+ [!code-vb[Conceptual.Attributes.Usage#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#7)]  
+  
+ その後、2 つの属性が基底クラス `MyClass` に適用されます。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#9](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#9)]
+ [!code-csharp[Conceptual.Attributes.Usage#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#9)]
+ [!code-vb[Conceptual.Attributes.Usage#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#9)]  
+  
+ 最後に、クラス `YourClass` が基底クラス `MyClass` から継承されます。 メソッド `MyMethod` は `MyAttribute` を表示しますが、`YourAttribute` を表示しません。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#10](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#10)]
+ [!code-csharp[Conceptual.Attributes.Usage#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#10)]
+ [!code-vb[Conceptual.Attributes.Usage#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#10)]  
+  
+<a name="cpconwritingcustomattributesanchor3"></a>   
+### AllowMultiple プロパティ  
+ <xref:System.AttributeUsageAttribute.AllowMultiple%2A?displayProperty=fullName> プロパティは、1 つの要素に、属性の複数のインスタンスが存在できるかどうかを示します。**true** に設定されている場合、複数のインスタンスが許可され、**false** \(既定\) に設定されている場合、1 つのインスタンスのみが許可されます。  
+  
+ 次の例では、`MyAttribute` は **false** の既定の <xref:System.AttributeUsageAttribute.AllowMultiple%2A> 値が指定されていますが、`YourAttribute` は **true** の値が指定されています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#11](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#11)]
+ [!code-csharp[Conceptual.Attributes.Usage#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#11)]
+ [!code-vb[Conceptual.Attributes.Usage#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#11)]  
+  
+ これらの属性の複数のインスタンスが適用されると、`MyAttribute` ではコンパイラ エラーが発生します。 次のコード例は、`YourAttribute` の正しい使い方と `MyAttribute` の正しくない使い方を示しています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#13](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#13)]
+ [!code-csharp[Conceptual.Attributes.Usage#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#13)]
+ [!code-vb[Conceptual.Attributes.Usage#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#13)]  
+  
+ <xref:System.AttributeUsageAttribute.AllowMultiple%2A> プロパティと <xref:System.AttributeUsageAttribute.Inherited%2A> プロパティの両方が **true** に設定されている場合、別のクラスから継承されるクラスは属性を継承し、同じ子クラスに適用される同じ属性の別のインスタンスを持つことができます。<xref:System.AttributeUsageAttribute.AllowMultiple%2A> が **false** に設定されている場合、親クラスのすべての属性の値は、子クラスの同じ属性の新しいインスタンスによって上書きされます。  
+  
+<a name="cpcondeclaringattributeclass"></a>   
+## 属性クラスを宣言する  
+ <xref:System.AttributeUsageAttribute> を適用すると、属性を具体的に定義できるようになります。 属性クラスの宣言は、次のコードに示すように、従来のクラスの宣言に似ています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#14](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#14)]
+ [!code-csharp[Conceptual.Attributes.Usage#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#14)]
+ [!code-vb[Conceptual.Attributes.Usage#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#14)]  
+  
+ この属性定義は、次の点を示します。  
+  
+-   属性クラスはパブリック クラスとして宣言する必要があります。  
+  
+-   規則により、属性クラスの名前の終わりに **Attribute** という単語を付けます。 必須ではありませんが、読みやすさの向上のために、この規定をお勧めします。 属性を適用すると、Attribute という単語を含める必要はなくなります。  
+  
+-   すべての属性クラスは、**System.Attribute** から直接的に継承するか間接的に継承する必要があります。  
+  
+-   Microsoft Visual Basic では、すべてのカスタム属性クラスは **AttributeUsageAttribute** 属性が必要です。  
+  
+<a name="cpcondeclaringconstructors"></a>   
+## コンストラクターを宣言する  
+ 属性は、従来のクラスと同じ方法で、コンストラクターで初期化されます。 次のコード フラグメントは、一般的な属性のコンストラクターを示しています。 このパブリック コンストラクターは、パラメーターを使って、メンバー変数と同じ値を設定します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#15](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#15)]
+ [!code-csharp[Conceptual.Attributes.Usage#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#15)]
+ [!code-vb[Conceptual.Attributes.Usage#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#15)]  
+  
+ さまざまな値の組み合わせに対応するように、コンストラクターをオーバーロードできます。 カスタム属性クラスの[プロパティ](../Topic/Properties%20Overview.md)も定義する場合、属性を初期化する際に、名前付きパラメーターと位置指定パラメーターの組み合わせを使うことができます。 通常、必須パラメーターすべてを位置指定パラメーター、省略可能なパラメーターすべてを名前付きパラメーターとして定義します。 この場合、属性は必須パラメーターがないと初期化できません。 その他のすべてのパラメーターは省略できます。 Visual Basic では、属性クラスのコンストラクターで ParamArray 引数を使うべきではないことに注意してください。  
+  
+ 次のコード例は、省略可能なパラメーターと必須パラメーターを使って、前のコンストラクターを使う属性を適用できることを示しています。 ここでは、属性には、必須のブール値 1 つと省略可能な文字列のプロパティ 1 つが含まれていることを前提としています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#17](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#17)]
+ [!code-csharp[Conceptual.Attributes.Usage#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#17)]
+ [!code-vb[Conceptual.Attributes.Usage#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#17)]  
+  
+<a name="cpcondeclaringproperties"></a>   
+## プロパティを宣言する  
+ 名前付きパラメーターを定義するか、属性によって格納される値を簡単に返すことができるようにする場合、[プロパティ](../Topic/Properties%20Overview.md)を宣言します。 属性プロパティは、返されるデータ型の記述を添えて、パブリック エンティティとして宣言する必要があります。 プロパティの値を保持する変数を定義して、その変数を **get** メソッドと **set** メソッドに関連付けます。 次のコード例は、属性に単純なプロパティを実装する方法を示しています。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#16](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#16)]
+ [!code-csharp[Conceptual.Attributes.Usage#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#16)]
+ [!code-vb[Conceptual.Attributes.Usage#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#16)]  
+  
+<a name="cpconcustomattributeexample"></a>   
+## カスタム属性の例  
+ このセクションには、前の情報が含まれており、コードのセクションの作成者に関する情報を文書化する単純な属性をデザインする方法を示しています。 この例の属性は、プログラマの名前とレベル、またコードを確認したかどうかを格納します。 保存する実際の値を格納するため、3 つのプライベート変数を使います。 各変数は、値を取得して設定するパブリック プロパティで表されます。 最後に、コンストラクターを 2 つの必須パラメーターを使って定義します。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#4)]
+ [!code-csharp[Conceptual.Attributes.Usage#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#4)]
+ [!code-vb[Conceptual.Attributes.Usage#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#4)]  
+  
+ 完全名 `DeveloperAttribute` や省略名 `Developer` を使って、次のいずれかの方法でこの属性を適用できます。  
+  
+ [!code-cpp[Conceptual.Attributes.Usage#12](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.attributes.usage/cpp/source2.cpp#12)]
+ [!code-csharp[Conceptual.Attributes.Usage#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.attributes.usage/cs/source2.cs#12)]
+ [!code-vb[Conceptual.Attributes.Usage#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.attributes.usage/vb/source2.vb#12)]  
+  
+ 最初の例は、必須の名前付きパラメーターのみを使って適用された属性を示し、2 番目の例は、必須パラメーターと省略可能なパラメーターの両方を使って適用された属性を示しています。  
+  
+## 参照  
+ <xref:System.Attribute?displayProperty=fullName>   
+ <xref:System.AttributeUsageAttribute>   
+ [属性](../../../docs/standard/attributes/index.md)
\ No newline at end of file
diff --git a/docs/standard/automatic-memory-management.md b/docs/standard/automatic-memory-management.md
new file mode 100644
index 00000000000..d63f59b378f
--- /dev/null
+++ b/docs/standard/automatic-memory-management.md
@@ -0,0 +1,61 @@
+---
+title: "自動メモリ管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "自動メモリ管理"
+  - "共通言語ランタイム, 自動メモリ管理"
+  - "ガベージ コレクション, 自動メモリ管理"
+  - "マネージ ヒープ"
+  - "メモリ, 割り当て"
+  - "メモリ, 自動メモリ管理"
+  - "メモリ, 解放"
+  - "ランタイム, 自動メモリ管理"
+ms.assetid: d4850de5-fa63-4936-a250-5678d118acba
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 自動メモリ管理
+自動メモリ管理は、[マネージ実行](../../docs/standard/managed-execution-process.md)中に共通言語ランタイムが提供するサービスの 1 つです。  共通言語ランタイムのガベージ コレクターは、アプリケーションが使用するメモリの割り当ておよび解放を管理します。  したがって、開発者がマネージ アプリケーションを開発するときに、メモリ管理タスクを実行するためのコードを記述する必要はありません。  自動メモリ管理により、オブジェクトを解放し忘れたためにメモリ リークが発生する、既に解放されているオブジェクトのメモリにアクセスしようとするなどの一般的な問題を回避できます。  ここでは、ガベージ コレクターによるメモリの割り当て方法および解放方法について説明します。  
+  
+## メモリの割り当て  
+ 新しいプロセスが初期化されると、ランタイムは連続したアドレス空間領域をそのプロセスのために予約します。  この予約済みのアドレス空間をマネージ ヒープと呼びます。  マネージ ヒープは、ヒープ内で次のオブジェクトを割り当てるアドレスへのポインターを管理します。  初期状態では、このポインターはマネージ ヒープのベース アドレスに設定されます。  すべての[参照型](../../docs/standard/base-types/common-type-system.md)は、マネージ ヒープ上に割り当てられます。  アプリケーションが最初の参照型を作成すると、マネージ ヒープのベース アドレスの位置にその型のメモリが割り当てられます。  アプリケーションが次のオブジェクトを作成すると、ガベージ コレクターは、アドレス空間で最初のオブジェクトの直後のメモリをそのオブジェクトに割り当てます。  ガベージ コレクターは、使用できるアドレス空間がある限り、この方法で新しいオブジェクトにアドレス空間を割り当てていきます。  
+  
+ マネージ ヒープからのメモリ割り当ては、アンマネージ メモリ割り当てよりも高速に処理されます。  ランタイムはポインターに値を加算することによってオブジェクトにメモリを割り当てるため、この方法によるメモリ割り当ては、スタックからのメモリ割り当てとほとんど同じ速度で行われます。  また、連続してメモリを割り当てられた複数の新規オブジェクトは、マネージ ヒープ内でも連続して格納されるため、アプリケーションからそれらのオブジェクトに高速でアクセスできます。  
+  
+<a name="cpconautomaticmemorymanagementreleasingmemoryanchor1"></a>   
+## メモリの解放  
+ ガベージ コレクターの最適化エンジンは、現在の割り当て状況に基づいて、ガベージ コレクションの実行に最適な時期を判断します。  ガベージ コレクターは、ガベージ コレクションを実行するときに、アプリケーションが使用しなくなったオブジェクトのメモリを解放します。  使用されなくなったオブジェクトを判断するために、アプリケーションのルートを調べます。  すべてのアプリケーションには、ルートのセットがあります。  各ルートは、マネージ ヒープ上のオブジェクトを参照しているか、または null に設定されています。  アプリケーションのルートには、グローバル オブジェクト ポインターと静的オブジェクト ポインター、スレッドのスタック上のローカル変数と参照オブジェクト パラメーター、CPU レジスタなどが含まれています。  ガベージ コレクターは、[ジャスト イン タイム \(JIT\) コンパイラ](../../docs/standard/managed-execution-process.md)とランタイムが管理している、アクティブなルートのリストにアクセスします。  このリストを使用してアプリケーションのルートを調べ、ルートから到達できるすべてのオブジェクトを含むグラフを作成します。  
+  
+ このグラフに含まれないオブジェクトは、アプリケーションのルートからは到達できません。  ガベージ コレクターは、そうした到達できないオブジェクトをガベージ \(ごみ\) であると判断し、それらのオブジェクトに割り当てられたメモリを解放します。  ガベージ コレクション中に、ガベージ コレクターはマネージ ヒープを調べ、到達できないオブジェクトが占有しているアドレス空間ブロックを検索します。  到達できないオブジェクトを検出すると、それらのオブジェクトに割り当てられていたアドレス空間ブロックを解放し、メモリ コピー機能を使用して、到達できるオブジェクトのメモリを圧縮します。  到達できるオブジェクトのメモリを圧縮した後で、ガベージ コレクターは、アプリケーションのルートがそれらのオブジェクトの新しい位置を指すようにポインターを修正します。  また、マネージ ヒープのポインターも、最後の到達できるオブジェクトの後を指すように修正します。  メモリが圧縮されるのは、ガベージ コレクション中に、到達できないオブジェクトが一定数以上検出された場合だけです。  マネージ ヒープ内のすべてのオブジェクトがごみではないと判断された場合は、メモリを圧縮する必要がありません。  
+  
+ パフォーマンスを向上させるために、ランタイムは、大きいオブジェクトのメモリは独立したヒープに割り当てます。  ガベージ コレクターは、これらの大きいオブジェクトのメモリを自動的に解放します。  ただし、メモリ内で大きいオブジェクトを移動するのを避けるため、このメモリは圧縮されません。  
+  
+## ジェネレーションとパフォーマンス  
+ ガベージ コレクターのパフォーマンスを最適化するために、マネージ ヒープは 0、1、および 2 の 3 つのジェネレーションに分割されます。  ランタイムのガベージ コレクション アルゴリズムは、これまでのガベージ コレクション手法の利用経験から、コンピューター ソフトウェア業界で有効だと認識されている次の原則に基づいています。  まず、マネージ ヒープの一部のメモリを圧縮する方が、マネージ ヒープ全体のメモリを圧縮するよりも高速です。  次に、オブジェクトが新しいほどその存続期間は短く、古いほど存続期間は長くなります。  最後に、新しいオブジェクトは相互に関連を持つ傾向にあり、アプリケーションによって同時に頻繁にアクセスされます。  
+  
+ ランタイムのガベージ コレクターは、新しいオブジェクトをジェネレーション 0 に格納します。  アプリケーションの有効期間の初期に作成され、ガベージ コレクションでごみではないと判断されたオブジェクトは昇格してジェネレーション 1 とジェネレーション 2 に格納されます。  オブジェクトの昇格プロセスについては後で説明します。  マネージ ヒープの一部を圧縮する方がヒープ全体を圧縮するよりも高速であるため、この手法では、ガベージ コレクターがコレクションを実行するたびにマネージ ヒープ全体のメモリを解放するのではなく、特定のジェネレーションのメモリだけを解放できるようにします。  
+  
+ 実際には、ガベージ コレクターはジェネレーション 0 がいっぱいになったときにガベージ コレクションを実行します。  ジェネレーション 0 がいっぱいになったときにアプリケーションが新しいオブジェクトを作成しようとすると、ガベージ コレクターは、そのオブジェクトに割り当てるためのアドレス空間がジェネレーション 0 には残っていないことを認識します。  ガベージ コレクターは、ジェネレーション 0 のアドレス空間を解放して新しいオブジェクトに割り当てるために、ガベージ コレクションを実行します。  まず、ガベージ コレクターは、マネージ ヒープ内の全オブジェクトではなく、ジェネレーション 0 のオブジェクトだけを調べます。  一般に新しいオブジェクトの存続期間は短く、ジェネレーション 0 のオブジェクトの多くはガベージ コレクションが実行された時点でアプリケーションによって使用されていないと推測されるため、この方法は最も効率的です。  また、多くの場合、ジェネレーション 0 のガベージ コレクションを行うだけで、アプリケーションが新しいオブジェクトの作成を続行するために十分なメモリを確保できます。  
+  
+ ガベージ コレクターは、ジェネレーション 0 のガベージ コレクションを実行した後で、このトピックの「[メモリの解放](#cpconautomaticmemorymanagementreleasingmemoryanchor1)」で既に説明したように、到達できるオブジェクトのメモリを圧縮します。  次に、ガベージ コレクターはこれらのオブジェクトを昇格させ、それらのオブジェクトが占めているマネージ ヒープ内の部分をジェネレーション 1 と見なします。  一般にガベージ コレクションでごみだと判断されなかったオブジェクトの存続期間は長いので、これらのオブジェクトを上位のジェネレーションに昇格させるのは有効です。  この結果、ガベージ コレクターがジェネレーション 0 のガベージ コレクションを実行するたびに、ジェネレーション 1 とジェネレーション 2 に昇格したオブジェクトを再び調べる必要がなくなります。  
+  
+ ジェネレーション 0 の最初のガベージ コレクションを実行し、到達できるオブジェクトをジェネレーション 1 に昇格させた後で、ガベージ コレクターはマネージ ヒープの残りの部分をジェネレーション 0 と見なします。  ガベージ コレクターは、ジェネレーション 0 がいっぱいになってガベージ コレクションを再び実行する必要が生じるまで、ジェネレーション 0 のメモリを新しいオブジェクトに割り当てます。  この時点で、ガベージ コレクターの最適化エンジンは、古いジェネレーションのオブジェクトを調べる必要があるかどうかを判断します。  たとえば、ジェネレーション 0 のガベージ コレクションを行うだけでは、アプリケーションが新しいオブジェクトを作成するために必要なメモリを確保できない場合、ガベージ コレクターはジェネレーション 1、0 の順にガベージ コレクションを実行します。  これでも必要なメモリを確保できない場合は、ジェネレーション 2、1、および 0 の順にガベージ コレクションを実行します。  ガベージ コレクターは、それぞれのガベージ コレクション後にジェネレーション 0 内にある到達できるオブジェクトを圧縮し、それらのオブジェクトをジェネレーション 1 に昇格させます。  ガベージ コレクションでごみだと判断されなかったジェネレーション 1 のオブジェクトは、ジェネレーション 2 に昇格します。  ガベージ コレクターがサポートするジェネレーションは 3 つしかないため、ガベージ コレクションでごみだと判断されなかったジェネレーション 2 のオブジェクトは、その後のガベージ コレクションで到達できないオブジェクトであると判断されるまで、ジェネレーション 2 に残ります。  
+  
+## アンマネージ リソースのメモリの解放  
+ アプリケーションで作成されるオブジェクトの大部分については、ガベージ コレクターによって、必要なメモリ管理タスクを自動的に実行できます。  しかし、アンマネージ リソースでは、明示的なクリーンアップが必要です。  最も一般的な種類のアンマネージ リソースは、ファイル ハンドル、ウィンドウ ハンドル、ネットワーク接続などのオペレーティング システム リソースをラップしたオブジェクトです。  ガベージ コレクターは、アンマネージ リソースをカプセル化したマネージ オブジェクトの存続期間を追跡することはできますが、そのアンマネージ リソースのクリーンアップ方法については具体的な情報を持っていません。  アンマネージ リソースをカプセル化するオブジェクトを作成する場合は、そのアンマネージ リソースをクリーンアップするために必要なコードをパブリックな **Dispose** メソッドという形で提供することをお勧めします。  **Dispose** メソッドを提供すると、ユーザーがオブジェクトを使い終わったときに、そのオブジェクトのメモリを明示的に解放できます。  アンマネージ リソースをカプセル化するオブジェクトを使用する場合は、**Dispose** メソッドの存在を念頭に置き、必要に応じて呼び出すようにしてください。  アンマネージ リソースのクリーンアップの詳細と、**Dispose** を実装するためのデザイン パターンの例については、「[Garbage Collection](../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.GC>   
+ [Garbage Collection](../../docs/standard/garbage-collection/index.md)   
+ [マネージ実行プロセス](../../docs/standard/managed-execution-process.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/TOC.md b/docs/standard/base-types/TOC.md
new file mode 100644
index 00000000000..4fd2353ff5d
--- /dev/null
+++ b/docs/standard/base-types/TOC.md
@@ -0,0 +1,61 @@
+# [例 : HREFS のスキャン](regular-expression-example-scanning-for-hrefs.md)
+# [文字のエスケープ](character-escapes-in-regular-expressions.md)
+# [方法 : Web コントロールでの数値のユーザー入力を数値に変換する](how-to-convert-numeric-user-input-in-web-controls-to-numbers.md)
+# [方法 : グレゴリオ暦以外の暦の日付を表示する](how-to-display-dates-in-non-gregorian-calendars.md)
+# [正規表現の例](regular-expression-examples.md)
+# [数値文字列の解析](parsing-numeric.md)
+# [列挙型書式指定文字列](enumeration-format-strings.md)
+# [文字列の操作](manipulating-strings.md)
+# [置換](substitutions-in-regular-expressions.md)
+# [その他の文字列の解析](parsing-other.md)
+# [正規表現のオプション](regular-expression-options.md)
+# [.NET Framework における文字エンコーディング](character-encoding.md)
+# [標準の日時書式指定文字列](standard-date-and-time-format-strings.md)
+# [.NET Framework における型変換](type-conversion.md)
+# [文字列を使用するためのベスト プラクティス](best-practices-strings.md)
+# [方法 : 日付と時刻の値をラウンドトリップさせる](how-to-round-trip-date-and-time-values.md)
+# [方法 : 文字列から無効な文字を取り除く](how-to-strip-invalid-characters-from-a-string.md)
+# [方法: 日付および時刻の値のミリ秒部分を表示する](how-to-display-milliseconds-in-date-and-time-values.md)
+# [方法 : URL からプロトコルとポート番号を抽出する](how-to-extract-a-protocol-and-port-number-from-a-url.md)
+# [文字のトリムと削除](trimming.md)
+# [カスタム時間間隔書式指定文字列](custom-timespan-format-strings.md)
+# [方法 : カスタム数値書式プロバイダーを定義して使用する](how-to-define-and-use-custom-numeric-format-providers.md)
+# [標準の時間間隔書式指定文字列](standard-timespan-format-strings.md)
+# [カスタム日時書式指定文字列](custom-date-and-time-format-strings.md)
+# [文字列の比較](comparing.md)
+# [正規表現言語 - クイック リファレンス](regular-expression-language-quick-reference.md)
+# [複合書式指定](composite-formatting.md)
+# [文字列の埋め込み](padding.md)
+# [基本的な文字列操作](basic-string-operations.md)
+# [その他の構成体](miscellaneous-constructs-in-regular-expressions.md)
+# [スレッド セーフ](thread-safety-in-regular-expressions.md)
+# [方法 : 文字列が有効な電子メール形式であるかどうかを検証する](how-to-verify-that-strings-are-in-valid-email-format.md)
+# [カスタム数値書式指定文字列](custom-numeric-format-strings.md)
+# [大文字と小文字の変更](changing-case.md)
+# [正規表現に関するベスト プラクティス](best-practices.md)
+# [例 : 日付形式の変更](regular-expression-example-changing-date-formats.md)
+# [文字列の解析](parsing-strings.md)
+# [StringBuilder クラスの使用](stringbuilder.md)
+# [標準の数値書式指定文字列](standard-numeric-format-strings.md)
+# [前方参照構成体](backreference-constructs-in-regular-expressions.md)
+# [共通型システム](common-type-system.md)
+# [.NET Framework の正規表現](regular-expressions.md)
+# [正規表現のオブジェクト モデル](the-regular-expression-object-model.md)
+# [日付と時刻文字列の解析](parsing-datetime.md)
+# [方法 : ローカライズされた日付/時刻情報を Web ユーザーに表示する](how-to-display-localized-date-and-time-information-to-web-users.md)
+# [書式設定操作の実行](performing-formatting-operations.md)
+# [限定子](quantifiers-in-regular-expressions.md)
+# [バックトラッキング](backtracking-in-regular-expressions.md)
+# [アンカー](anchors-in-regular-expressions.md)
+# [方法 : 特定の日付から曜日を抽出する](how-to-extract-the-day-of-the-week-from-a-specific-date.md)
+# [コンパイルと再利用](compilation-and-reuse-in-regular-expressions.md)
+# [方法: 基本的な文字列操作を実行する](basic-manipulations.md)
+# [グループ化構成体](grouping-constructs-in-regular-expressions.md)
+# [文字クラス](character-classes-in-regular-expressions.md)
+# [正規表現の動作の詳細](details-of-regular-expression-behavior.md)
+# [型変換の表](conversion-tables.md)
+# [型の書式設定](formatting-types.md)
+# [方法: 数値に先行するゼロを埋め込む](how-to-pad-a-number-with-leading-zeros.md)
+# [代替構成体](alternation-constructs-in-regular-expressions.md)
+# [新しい文字列の作成](creating-new.md)
+# [基本型](index.md)
diff --git a/docs/standard/base-types/alternation-constructs-in-regular-expressions.md b/docs/standard/base-types/alternation-constructs-in-regular-expressions.md
new file mode 100644
index 00000000000..a0f05e7159d
--- /dev/null
+++ b/docs/standard/base-types/alternation-constructs-in-regular-expressions.md
@@ -0,0 +1,137 @@
+---
+title: "正規表現での代替構成体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 代替構成体"
+  - "代替構成体"
+  - "代替の一致パターン"
+  - "構成体, 代替"
+  - "OR 一致"
+  - "オプションの一致パターン"
+  - "正規表現, 代替構成体"
+ms.assetid: 071e22e9-fbb0-4ecf-add1-8d2424f9f2d1
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 正規表現での代替構成体
+<a name="top"></a> 代替構成体は、択一条件または条件一致を有効にするように正規表現を変更します。 .NET Framework では、次の 3 つの代替構成体がサポートされています。  
+  
+-   [&#124; を使用したパターン マッチ](#Either_Or)  
+  
+-   [\(?\(expression\)yes&#124;no\) を使用した条件一致](#Conditional_Expr)  
+  
+-   [有効なキャプチャ グループに基づく条件一致](#Conditional_Group)  
+  
+<a name="Either_Or"></a>   
+## &#124; を使用したパターン マッチ  
+ 縦棒 \(`|`\) 文字を使って、`|` 文字で各パターンを区切った一連のパターンのいずれかと照合できます。  
+  
+ 肯定的文字クラスと同じように、`|` 文字を使うと、複数の文字のいずれか 1 文字と照合できます。 次の例は、肯定的文字クラスと `|` 文字との択一パターン マッチを使って、文字列から単語 "gray"や "grey" を検索します。 この場合、`|` 文字を使うと、より詳細な正規表現が生成されます。  
+  
+ [!code-csharp[RegularExpressions.Language.Alternation#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.alternation/cs/alternation1.cs#1)]
+ [!code-vb[RegularExpressions.Language.Alternation#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.alternation/vb/alternation1.vb#1)]  
+  
+ `|` 文字を使う正規表現 `\bgr(a|e)y\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`gr`|文字 "gr" と一致します。|  
+|`(a&#124;e)`|"a" または "e" と一致します。|  
+|`y\b`|ワード境界にある "y" と一致します。|  
+  
+ また、`|` 文字を使って、複数の文字や部分式との択一照合を実行できます。これは、文字リテラルと正規表現言語要素を自由に組み合わせて使うことができます。 \(文字クラスにこの機能はありません\)。 次の例では、`|` 文字を使って、米国の社会保障番号 \(SSN、*ddd*\-*dd*\-*dddd* という形式の 9 桁の数字\)、または米国の雇用者番号 \(EIN、*dd*\-*ddddddd* という形式の 9 桁の数字\) のいずれかを抽出します。  
+  
+ [!code-csharp[RegularExpressions.Language.Alternation#2](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.alternation/cs/alternation2.cs#2)]
+ [!code-vb[RegularExpressions.Language.Alternation#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.alternation/vb/alternation2.vb#2)]  
+  
+ この正規表現 `\b(\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(\d{2}-\d{7}&#124;\d{3}-\d{2}-\d{4})`|「2 桁と 7 桁の 10 進数がハイフンでつながれた文字列」または「3 桁、2 桁、4 桁の 10 進数がそれぞれハイフンでつながれた文字列」のいずれかと一致します。|  
+|`\d`|ワード境界で照合を終了します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Conditional_Expr"></a>   
+## 式を使用した条件一致  
+ この言語要素では、最初のパターンに一致するかどうかに応じて、2 つのパターンのいずれかの照合を実行します。 構文は次のとおりです。  
+  
+ `(?(` *式* `)` *可* `|` *no* `)`  
+  
+ ここで、*expression* は照合する最初のパターン、*yes* は *expression* が一致した場合に照合するパターン、*no* は *expression* が一致しなかった場合に照合するパターン \(省略可能\) です。*expression* は正規表現エンジンによってゼロ幅アサーションとして処理されるので、*expression* が評価された後、正規表現エンジンによる入力ストリーム内の評価位置は前に進みません。 そのため、この構成体は次の構成体と同じです。  
+  
+ `(?(?=` *式* `)` *可* `|` *no* `)`  
+  
+ ここで、`(?=`*expression*`)` はゼロ幅アサーションの構成体として解釈されます  \(詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください\)。 正規表現エンジンによって *expression* はアンカー \(ゼロ幅アサーション\) として解釈されるので、*expression* は、ゼロ幅アサーション \(詳しくは「[アンカー](../../../docs/standard/base-types/anchors-in-regular-expressions.md)」を参照\) か、*yes* にも含まれている部分式のいずれかである必要があります。 それ以外の場合、*yes* パターンには一致しません。  
+  
+> [!NOTE]
+>  *expression* が名前付きキャプチャ グループや番号付きキャプチャ グループである場合、代替構成体はキャプチャ テストとして解釈されます。詳しくは、次のセクション「[有効なキャプチャ グループに基づく条件一致](#Conditional_Group)」をご覧ください。 つまり、正規表現エンジンは、キャプチャした部分文字列を照合しようとはせず、代わりにグループが存在するかどうかをテストします。  
+  
+ 次の例は、前の「[&#124; を使用したパターン マッチ](#Either_Or)」セクションで説明した例を少し変更したものです。 条件一致を使用して、ワード境界の後の最初の 3 文字が「2 桁の数字の後にハイフン」であるかどうかを判定します。 一致した場合は、米国の雇用者番号 \(EIN\) との照合を試みます。 一致しない場合は、米国の社会保険番号 \(SSN\) との照合を試みます。  
+  
+ [!code-csharp[RegularExpressions.Language.Alternation#3](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.alternation/cs/alternation3.cs#3)]
+ [!code-vb[RegularExpressions.Language.Alternation#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.alternation/vb/alternation3.vb#3)]  
+  
+ この正規表現パターン `\b(?(\d{2}-)\d{2}-\d{7}|\d{3}-\d{2}-\d{4})\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(?(\d{2}-)`|次の 3 文字が「2 桁の数字の後にハイフン」で構成されているかどうかを判定します。|  
+|`\d{2}-\d{7}`|前のパターンに一致する場合は、「2 桁の数字の後にハイフン、その後に 7 桁の数字」を照合します。|  
+|`\d{3}-\d{2}-\d{4}`|前のパターンに一致しない場合は、「3 桁の 10 進数、ハイフン、2 桁の 10 進数、もう 1 つのハイフン、および 4 桁の 10 進数」を照合します。|  
+|`\b`|ワード境界に一致します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Conditional_Group"></a>   
+## 有効なキャプチャ グループに基づく条件一致  
+ この言語要素では、指定されたキャプチャ グループに一致するかどうかに応じて、2 つのパターンのいずれかを照合します。 構文は次のとおりです。  
+  
+ `(?(` *name* `)` *可* `|` *no* `)`  
+  
+ または  
+  
+ `(?(` *number* `)` *可* `|` *no* `)`  
+  
+ ここで、*name* はキャプチャ グループの名前、*number* はキャプチャ グループの番号です。*yes* は、*name* または *number* が一致する場合に照合する式です。*no* き、一致しない場合に照合する式 \(省略可能\) です。  
+  
+ *name* が正規表現パターンで使用されているキャプチャ グループの名前に一致しない場合、その代替構成体は式のテスト \(前のセクションで説明したもの\) として解釈されます。 通常、これは *expression* が `false` に評価されることを意味します。*number* が正規表現パターンで使用されている番号付きキャプチャ グループに対応しない場合は、正規表現エンジンが <xref:System.ArgumentException> をスローします。  
+  
+ 次の例は、前の「[&#124; を使用したパターン マッチ](#Either_Or)」セクションで説明した例を少し変更したものです。 「2 桁の数字の後にハイフン」で構成される `n2` という名前付きキャプチャ グループを使用しています。 代替構成体により、このキャプチャ グループが入力文字列に一致したかどうかテストされます。 一致した場合は、場合に、米国の 9 桁の雇用者番号 \(EIN\) との照合を試みます。 一致しなかった場合は、米国の 9 桁の社会保険番号 \(SSN\) との照合を試みます。  
+  
+ [!code-csharp[RegularExpressions.Language.Alternation#4](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.alternation/cs/alternation4.cs#4)]
+ [!code-vb[RegularExpressions.Language.Alternation#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.alternation/vb/alternation4.vb#4)]  
+  
+ この正規表現パターン `\b(?<n2>\d{2}-)*(?(n2)\d{7}|\d{3}-\d{2}-\d{4})\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(?<n2>\d{2}-)*`|「2 桁の数字の後にハイフン」の 0 個または 1 個の出現と照合します。 このキャプチャ グループに `n2` という名前を付けます。|  
+|`(?(n2)`|`n2` への一致が入力文字列内に見つかるかどうかテストします。|  
+|`)\d{7}`|`n2` が一致した場合は、7 桁の 10 進数を照合します。|  
+|`&#124;\d{3}-\d{2}-\d{4}`|`n2` が一致しなかった場合は、「3 桁の 10 進数、ハイフン、2 桁の 10 進数、もう 1 つのハイフン、および 4 桁の 10 進数」を照合します。|  
+|`\b`|ワード境界に一致します。|  
+  
+ この例を少し変更して、名前付きグループではなく番号付きグループを使用する例を次に示します。 正規表現パターンは `\b(\d{2}-)*(?(1)\d{7}|\d{3}-\d{2}-\d{4})\b` です。  
+  
+ [!code-csharp[RegularExpressions.Language.Alternation#5](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.alternation/cs/alternation5.cs#5)]
+ [!code-vb[RegularExpressions.Language.Alternation#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.alternation/vb/alternation5.vb#5)]  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/anchors-in-regular-expressions.md b/docs/standard/base-types/anchors-in-regular-expressions.md
new file mode 100644
index 00000000000..e5a94d326fb
--- /dev/null
+++ b/docs/standard/base-types/anchors-in-regular-expressions.md
@@ -0,0 +1,180 @@
+---
+title: "正規表現のアンカー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, アンカー"
+  - ".NET Framework 正規表現, アトミック ゼロ幅アサーション"
+  - "アンカー, 正規表現で"
+  - "アトミック ゼロ幅アサーション"
+  - "メタ文字, アンカー"
+  - "メタ文字, アトミック ゼロ幅アサーション"
+  - "正規表現, アンカー"
+  - "正規表現, アトミック ゼロ幅アサーション"
+ms.assetid: 336391f6-2614-499b-8b1b-07a6837108a7
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 正規表現のアンカー
+<a name="top"></a> アンカー \(アトミック ゼロ幅アサーション\) は、文字列が一致する位置を指定します。 検索式でアンカーを使用した場合、正規表現エンジンは、後方の文字列を読み込んだり、文字に一致させたりすることはしません。指定された位置での一致のみが検索されます。 たとえば、`^` は、行または文字列の先頭に一致する必要があることを指定します。 したがって、正規表現 `^http:` は、"http:" が行の先頭にある場合にのみ一致します。 次の表は、.NET Framework の正規表現でサポートされているアンカーの一覧です。  
+  
+|アンカー|説明|  
+|----------|--------|  
+|`^`|文字列または行の先頭に一致します。 詳細については、「[文字列または行の先頭](#Start)」を参照してください。|  
+|`$`|文字列または行の末尾に一致するか、文字列または行の末尾にある `\n` の前に一致します。 詳細については、「[文字列または行の末尾](#End)」を参照してください。|  
+|`\A`|文字列の先頭にのみ一致します \(複数行はサポートされません\)。 詳細については、「[文字列の先頭のみ](#StartOnly)」を参照してください。|  
+|`\Z`|文字列の末尾で一致するか、文字列の末尾にある `\n` の前に一致します。 詳細については、「[文字列の末尾または末尾の改行の前](#EndOrNOnly)」を参照してください。|  
+|`\z`|文字列の末尾にのみ一致します。 詳細については、「[文字列の末尾のみ](#EndOnly)」を参照してください。|  
+|`\G`|前回の一致が終了した位置に一致します。 詳細については、「[連続一致](#Contiguous)」を参照してください。|  
+|`\b`|ワード境界に一致します。 詳細については、「[ワード境界](#WordBoundary)」を参照してください。|  
+|`\B`|ワード境界以外に一致します。 詳細については、「[ワード境界以外](#NonwordBoundary)」を参照してください。|  
+  
+<a name="Start"></a>   
+## 文字列または行の先頭: ^  
+ `^` アンカーは、その後に続くパターンが、文字列の最初の文字位置から始まる必要があることを指定します。`^` オプションを指定して <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> を使用した場合は \(「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照\)、各行の先頭に一致します。  
+  
+ 次の例では、正規表現で `^` アンカーを使用して、プロ野球チームが存続した年数に関する情報を抽出します。 この例では、<xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドの 2 つのオーバーロードを呼び出しています。  
+  
+-   <xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%29> オーバーロードの呼び出しでは、入力文字列内で正規表現パターンに一致する最初の部分文字列が検索されます。  
+  
+-   <xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29> パラメーターを `options` に設定した <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オーバーロードの呼び出しでは、5 つのすべての部分文字列が検索されます。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/startofstring1.cs#1)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/startofstring1.vb#1)]  
+  
+ 正規表現パターン `^((\w+(\s?)){2,}),\s(\w+\s\w+),(\s\d{4}(-(\d{4}|present))?,?)+` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力文字列の先頭から \(または、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを指定してメソッドが呼び出された場合は行の先頭から\) 照合を開始します。|  
+|`((\w+(\s?)){2,}`|1 個以上の単語文字の後に 0 個または 1 個の空白が続くパターンが、2 回繰り返される部分に一致します。 これが最初のキャプチャ グループです。 この表現は、2 番目と 3 番目のキャプチャ グループも定義します。2 番目のグループはキャプチャされた単語で構成され、3 番目のグループはキャプチャされた空白で構成されます。|  
+|`,\s`|コンマおよびそれに続く空白文字に一致します。|  
+|`(\w+\s\w+)`|1 個以上の単語文字の後に 1 個の空白が続き、さらに 1 個以上の単語文字が続くパターンに一致します。 これが 4 番目のキャプチャ グループです。|  
+|`,`|コンマに一致します。|  
+|`\s\d{4}`|1 個の空白の後に 4 個の 10 進数字が続くパターンに一致します。|  
+|\(\-`(\d{4}&#124;present))?`|1 個のハイフンの後に 4 個の 10 進数字または文字列 "present" が続くパターンの、0 回または 1 回の繰り返しに一致します。 これが 6 番目のキャプチャ グループです。 7 番目のキャプチャ グループも含まれています。|  
+|`,?`|コンマの 0 回または 1 回の繰り返しに一致します。|  
+|`(\s\d{4}(-(\d{4}&#124;present))?,?)+`|1 個のスペース、4 個の 10 進数字、1 個のハイフンの後に 4 個の 10 進数字または文字列 "present" が続くパターンの 0 回または 1 回の繰り返し、0 個または 1 個のコンマが並んだパターンの、1 回以上の繰り返しに一致します。 これが 5 番目のキャプチャ グループです。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="End"></a>   
+## 文字列または行の末尾: $  
+ `$` アンカーは、その前にあるパターンが、入力文字列の末尾、または入力文字列の末尾にある `\n` の前で一致する必要があることを指定します。  
+  
+ `$` オプションを指定して <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> を使用した場合は、行の末尾にも一致します。`$` は、`\n` に一致しますが、`\r\n` \(復帰文字と改行文字の組み合わせ、つまり CR\/LF\) には一致しないことに注意してください。 CR\/LF 文字の組み合わせに一致させるには、正規表現パターンに `\r?$` を含めます。  
+  
+ 次の例では、「[文字列または行の先頭](#Start)」の例で使用した正規表現パターンに `$` アンカーを追加しています。 5 つのテキスト行を含む元の入力文字列に対して使用した場合、<xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドは一致を見つけることができません。これは、最初の行の末尾が `$` パターンに一致しないためです。 元の入力文字列を文字列配列に分割すると、<xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドは 5 つの各行の一致に成功します。<xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> パラメーターを `options` に設定して <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> メソッドを呼び出すと、一致は見つかりません。これは、正規表現パターンで復帰要素 \(\\u\+000D\) が考慮されないためです。 ただし、`$` を `\r?$` に置き換え、`options` パラメーターを <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> に設定して <xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> メソッドを呼び指すと、正規表現パターンが変更され、再び 5 つの一致が検索されるようになります。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/endofstring1.cs#2)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/endofstring1.vb#2)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="StartOnly"></a>   
+## 文字列の先頭のみ: \\A  
+ `\A` アンカーは、入力文字列の先頭に一致する必要があることを指定します。 これは `^` アンカーと同じですが、`\A` では <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションが無視される点が異なります。 したがって、複数行の入力文字列でも最初の行の先頭にのみ一致することができます。  
+  
+ 次の例は、`^` アンカーおよび `$` アンカーの例と似ています。 この例では、正規表現で `\A` アンカーを使用して、プロ野球チームが存続した年数に関する情報を抽出します。 入力文字列には 5 つの行が含まれます。<xref:System.Text.RegularExpressions.Regex.Matches%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> メソッドを呼び出すと、入力文字列内で正規表現パターンに一致する最初の部分文字列のみが検索されます。 この例からわかるように、<xref:System.Text.RegularExpressions.RegexOptions> オプションの効果はありません。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/startofstring2.cs#3)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/startofstring2.vb#3)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="EndOrNOnly"></a>   
+## 文字列の末尾または末尾の改行の前: \\Z  
+ `\Z` アンカーは、入力文字列の末尾、または入力文字列の末尾にある `\n` の前に一致する必要があることを指定します。 これは `$` アンカーと同じですが、`\Z` では <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションが無視される点が異なります。 したがって、複数行文字列では、最後の行の末尾か、最後の行の `\n` の前にのみ一致することができます。  
+  
+ `\Z` は `\n` に一致しますが、`\r\n` \(CR\/LF 文字の組み合わせ\) には一致しないことに注意してください。 CR\/LF と一致させるには、`\r?\Z` を正規表現パターンに含めます。  
+  
+ 次の例では、正規表現で `\Z` アンカーを使用して、プロ野球チームが存続した年数に関する情報を抽出します。この正規表現は、「[文字列または行の先頭](#Start)」で取り上げた例に似ています。 正規表現 `^((\w+(\s?)){2,}),\s(\w+\s\w+),(\s\d{4}(-(\d{4}|present))?,?)+\r?\Z` 内の部分式 `\r?\Z` は、文字列の末尾に一致するほか、`\n` または `\r\n` で終了する文字列にも一致します。 結果として、配列内の各要素が正規表現パターンに一致します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/endofstring2.cs#4)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/endofstring2.vb#4)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="EndOnly"></a>   
+## 文字列の末尾のみ: \\z  
+ `\z` アンカーは、入力文字列の末尾に一致する必要があることを指定します。`$` 言語要素と同様に、`\z` では <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションが無視されます。`\Z` 言語要素とは異なり、`\z` は文字列末尾にある `\n` 文字には一致しません。 したがって、入力文字列の最後の行にのみ一致することができます。  
+  
+ 次の例では、正規表現で `\z` アンカーを使用して、プロ野球チームが存続した年数に関する情報を抽出します。この正規表現は、アンカーを除けば前のセクションで取り上げた例と同じです。 この例は、文字列配列の 5 つの各要素と正規表現パターン `^((\w+(\s?)){2,}),\s(\w+\s\w+),(\s\d{4}(-(\d{4}|present))?,?)+\r?\z` の一致を試みます。 これらのうち、2 つの文字列は復帰文字と改行文字で終わり、別の 1 つの文字列は改行文字で終わっています。残りの 2 つの文字列の末尾には、復帰文字も改行文字もありません。 出力結果が示すように、復帰文字も改行文字もない文字列だけがパターンに一致します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/endofstring3.cs#5)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/endofstring3.vb#5)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Contiguous"></a>   
+## 連続一致: \\G  
+ `\G` アンカーは、前回の一致が終了した位置に一致する必要があることを指定します。 このアンカーを <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドと共に使用すると、すべての一致が連続することになります。  
+  
+ 次の例では、正規表現を使用して、コンマ区切りの文字列からげっ歯類の名称を抽出します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/contiguous1.cs#6)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/contiguous1.vb#6)]  
+  
+ この正規表現 `\G(\w+\s?\w*),?` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\G`|最後の一致の終了位置から開始します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`\s?`|0 個または 1 個の空白に一致します。|  
+|`\w*`|0 個以上の単語に使用される文字に一致します。|  
+|`(\w+\s?\w*)`|1 個以上の単語文字の後に 0 個または 1 個の空白が続き、さらに 0 個以上の単語文字が続くパターンに一致します。 これが最初のキャプチャ グループです。|  
+|`,?`|リテラルのコンマ文字の 0 回または 1 回の繰り返しに一致します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="WordBoundary"></a>   
+## ワード境界: \\b  
+ `\b` アンカーは、単語文字 \(`\w` 言語要素\) と単語以外の文字 \(`\W` 言語要素\) の境界に一致する必要があることを示します。 単語文字は英数字とアンダースコアで構成され、単語以外の文字は、英数字でもアンダースコアでもない任意の文字で構成されます  \(詳細については、「[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)」を参照してください\)。 文字列の先頭または末尾にあるワード境界にも一致する可能性があります。  
+  
+ `\b` アンカーは、部分式を単語の先頭または末尾ではなく単語全体に一致させる目的で頻繁に使用されます。 次の例の正規表現 `\bare\w*\b` は、この使用方法を示しています。 これは、部分文字列 "are" で始まる任意の単語に一致します。 この例の出力から、`\b` は入力文字列の先頭と末尾の両方に一致することもわかります。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/word1.cs#7)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/word1.vb#7)]  
+  
+ この正規表現パターンの解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`are`|部分文字列 "are" に一致します。|  
+|`\w*`|0 個以上の単語に使用される文字に一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="NonwordBoundary"></a>   
+## ワード境界以外: \\B  
+ `\B` アンカーは、ワード境界には一致しないことを指定します。 これは、`\b` アンカーと逆の働きをします。  
+  
+ 次の例では、`\B` アンカーを使用して、単語内で部分文字列 "qu" が出現する位置を見つけます。 正規表現パターン `\Bqu\w+` は、"qu" で始まり \(単語の先頭ではない\)、単語の終わりまでの部分文字列に一致します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Assertions#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.assertions/cs/nonword1.cs#8)]
+ [!code-vb[Conceptual.RegEx.Language.Assertions#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.assertions/vb/nonword1.vb#8)]  
+  
+ この正規表現パターンの解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\B`|ワード境界では照合を開始しません。|  
+|`qu`|部分文字列 "qu" と一致します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)   
+ [正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/backreference-constructs-in-regular-expressions.md b/docs/standard/base-types/backreference-constructs-in-regular-expressions.md
new file mode 100644
index 00000000000..60a0b5fa590
--- /dev/null
+++ b/docs/standard/base-types/backreference-constructs-in-regular-expressions.md
@@ -0,0 +1,126 @@
+---
+title: "正規表現での前方参照構成体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 前方参照構成体"
+  - "逆参照"
+  - "構成体, 前方参照"
+  - "正規表現, 前方参照構成体"
+ms.assetid: 567a4b8d-0e79-49dc-8df9-f4b1aa376a2a
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 正規表現での前方参照構成体
+前方参照を使用すると、文字列内で繰り返し出現する文字や部分文字列を簡単に特定できます。  たとえば、入力文字列に任意の部分文字列が複数回出現する場合は、最初の出現箇所をキャプチャ グループで一致させた後に、前方参照を使用してそれ以降の出現箇所を一致させることができます。  
+  
+> [!NOTE]
+>  置換文字列の名前付きのキャプチャ グループと番号付きのキャプチャ グループの参照には、別の構文が使用されます。  詳細については、「[置換](../../../docs/standard/base-types/substitutions-in-regular-expressions.md)」を参照してください。  
+  
+ .NET Framework では、番号付きのキャプチャ グループと名前付きのキャプチャ グループを参照する個別の言語要素が定義されています。  キャプチャ グループの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+## 番号付き前方参照  
+ 番号付き前方参照では、次の構文を使用します。  
+  
+ `\` *number*  
+  
+ *number* は、正規表現のキャプチャ グループの位置です。  たとえば、`\4` を使用すると、4 番目のキャプチャ グループの内容と一致します。  *number* が正規表現パターンで定義されていない場合は、解析エラーが発生し、正規表現エンジンは <xref:System.ArgumentException>をスローします。  たとえば、正規表現 `\b(\w+)\s\1` は、`(\w+)` が式の 1 番目の唯一のキャプチャ グループであるので有効です。  これに対して、`\b(\w+)\s\2` は、`\2` の番号が付けられたキャプチャ グループが存在しないので無効であり、引数の例外がスローされます。  
+  
+ 同じ表記を使用する `\`*number* の前方参照と 8 のエスケープ コードがあいまいです \(`\16`など\) にします。  このあいまいさは次のように解決されます。  
+  
+-   `\1` から `\9` までの式は常に前方参照と解釈され、8 進コードとは解釈されません。  
+  
+-   複数桁の式の最初の桁が 8 または 9 の場合 \(`\80` や `\91` など\)、その式はリテラルと解釈されます。  
+  
+-   `\10` 以降の式は、その番号に対応する前方参照がある場合には、前方参照と見なされます。それ以外の場合は、8 進コードと解釈されます。  
+  
+-   未定義のグループ番号への前方参照が正規表現にある場合は、解析エラーが発生し、正規表現エンジンから <xref:System.ArgumentException> がスローされます。  
+  
+ あいまいさが問題になる場合は、明確、8 進文字コードと混同できない `\k<`*name*`>` 表記法を使用できます。  同様に、`\xdd` などの 16 進コードにもあいまいさがないため、前方参照と混同されることはありません。  
+  
+ 次の例では、文字列内で、単語に使用される文字のうち重複する文字を検索します。  この例では、次の要素で構成される正規表現 `(\w)\1` が定義されています。  
+  
+|要素|説明|  
+|--------|--------|  
+|`(\w)`|単語に使用される文字と一致し、その文字を 1 番目のキャプチャ グループに代入します。|  
+|`\1`|次に出現した、1 番目のキャプチャ グループの値と同じ文字と一致します。|  
+  
+ [!code-csharp[RegularExpressions.Language.Backreferences#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.backreferences/cs/backreference1.cs#1)]
+ [!code-vb[RegularExpressions.Language.Backreferences#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.backreferences/vb/backreference1.vb#1)]  
+  
+## 名前付き前方参照  
+ 名前付き前方参照は、次の構文を使用して定義します。  
+  
+ `\k<` *name* `>`  
+  
+ または  
+  
+ `\k'` *name* `'`  
+  
+ *name* が正規表現パターンで定義されているキャプチャ グループの名前です。  *name* が正規表現パターンで定義されていない場合は、解析エラーが発生し、正規表現エンジンは <xref:System.ArgumentException>をスローします。  
+  
+ 次の例では、文字列内で、単語に使用される文字のうち重複する文字を検索します。  この例では、次の要素で構成される正規表現 `(?<char>\w)\k<char>` が定義されています。  
+  
+|要素|説明|  
+|--------|--------|  
+|`(?<char>\w)`|単語に使用される文字と一致し、その文字を `char` という名前のキャプチャ グループに代入します。|  
+|`\k<char>`|次に出現した、`char` キャプチャ グループの値と同じ文字と一致します。|  
+  
+ [!code-csharp[RegularExpressions.Language.Backreferences#2](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.backreferences/cs/backreference2.cs#2)]
+ [!code-vb[RegularExpressions.Language.Backreferences#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.backreferences/vb/backreference2.vb#2)]  
+  
+ *name* には、数値の文字列形式である場合があることに注意してください。  たとえば、次の例では、正規表現 `(?<2>\w)\k<2>` を使用して、文字列内で、単語に使用される文字のうち重複する文字を検索します。  
+  
+ [!code-csharp[RegularExpressions.Language.Backreferences#3](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.backreferences/cs/backreference3.cs#3)]
+ [!code-vb[RegularExpressions.Language.Backreferences#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.backreferences/vb/backreference3.vb#3)]  
+  
+## 前方参照で一致する対象  
+ 前方参照は、最も近いグループ定義 \(左から右に検索する場合、左側の最も近いところにある定義\) を参照します。  1 つのグループで複数のキャプチャが行われる場合、前方参照は最も近いキャプチャを参照します。  
+  
+ 次の例では、\\1 名前付きグループを再定義する正規表現パターン `(?<1>a)(?<1>\1b)*` を使用しています。  この正規表現の各パターンの説明を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(?<1>a)`|文字 "a" と一致し、結果を `1` という名前のキャプチャ グループに代入します。|  
+|`(?<1>\1b)*`|`1` という名前のグループに "b" を加えた文字列に 0 回または 1 回一致し、結果を `1` という名前のキャプチャ グループに代入します。|  
+  
+ [!code-csharp[RegularExpressions.Language.Backreferences#4](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.backreferences/cs/backreference4.cs#4)]
+ [!code-vb[RegularExpressions.Language.Backreferences#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.backreferences/vb/backreference4.vb#4)]  
+  
+ 正規表現と入力文字列 \("aababb"\) の比較時、正規表現エンジンは次の操作を実行します。  
+  
+1.  文字列の先頭から開始し、"a" と式 `(?<1>a)` の一致に成功します。  `1` グループの値は "a" になります。  
+  
+2.  2 番目の文字に進み、文字列 "ab" と式 `\1b` \(つまり "ab"\) の一致に成功します。  結果の "ab" を `\1` に代入します。  
+  
+3.  4 番目の文字に進みます。  式 `(?<1>\1b)` は 0 回以上一致するので、文字列 "abb" と式 `\1b` の一致に成功します。  結果の "abb" を `\1` に代入します。  
+  
+ この例では、`*` はループ量指定子であるので、定義されているパターンと一致する文字列がなくなるまで、繰り返し評価されます。  量指定子によるループが行われても、グループ定義はクリアされません。  
+  
+ あるグループによってキャプチャされる部分文字列がない場合は、そのグループへの前方参照は未定義になるため、一致する文字列は見つかりません。  このことを、次のように定義される正規表現パターン `\b(\p{Lu}{2})(\d{2})?(\p{Lu}{2})\b` を使用して示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\p{Lu}{2})`|2 個の大文字と一致します。  これが最初のキャプチャ グループです。|  
+|`(\d{2})?`|2 桁の 10 進数と 0 回または 1 回一致します。  これが 2 番目のキャプチャ グループです。|  
+|`(\p{Lu}{2})`|2 個の大文字と一致します。  これが 3 番目のキャプチャ グループです。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ 2 番目のキャプチャ グループで定義されている 2 桁の 10 進数が存在しない場合でも、入力文字列とこの正規表現を一致させることができます。  次の例では、一致する対象は見つかりますが、一致する対象が見つかった 2 つのキャプチャ グループの間には空のキャプチャ グループがあります。  
+  
+ [!code-csharp[RegularExpressions.Language.Backreferences#5](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.backreferences/cs/backreference5.cs#5)]
+ [!code-vb[RegularExpressions.Language.Backreferences#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.backreferences/vb/backreference5.vb#5)]  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/backtracking-in-regular-expressions.md b/docs/standard/base-types/backtracking-in-regular-expressions.md
new file mode 100644
index 00000000000..e63bcfef80c
--- /dev/null
+++ b/docs/standard/base-types/backtracking-in-regular-expressions.md
@@ -0,0 +1,224 @@
+---
+title: "正規表現におけるバックトラッキング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, バックトラッキング"
+  - "代替の一致パターン"
+  - "オプションの一致パターン"
+  - "検索 (正規表現を使用した), バックトラッキング"
+  - "パターンマッチング (正規表現を使用した), バックトラッキング"
+  - "バックトラッキング"
+  - "正規表現 [.NET Framework], バックトラッキング"
+  - "文字列 [.NET Framework]、正規表現"
+  - "テキストの解析 (正規表現を使用した), バックトラッキング"
+ms.assetid: 34df1152-0b22-4a1c-a76c-3c28c47b70d8
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 正規表現におけるバックトラッキング
+<a name="top"></a> バックトラッキングは、正規表現パターンに省略可能な[量指定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)または[代替構成体](../../../docs/standard/base-types/alternation-constructs-in-regular-expressions.md)が含まれている場合に発生します。この場合、正規表現エンジンは、一致の検索を継続するために、以前に保存した状態に戻ります。 バックトラッキングは、正規表現を強力にするための中心的な機能で、これにより、非常に複雑なパターンを照合できる強力かつ柔軟な正規表現を作成できるようになります。 その一方で、バックトラッキングにはマイナス面もあり、 多くの場合、正規表現エンジンのパフォーマンスを左右する最大の要因になります。 さいわい、正規表現エンジンの動作とバックトラッキングの使用方法は開発者が制御できます。 ここでは、バックトラッキングの動作のしくみと、バックトラッキングを制御する方法について説明します。  
+  
+> [!NOTE]
+>  一般に、.NET Framework の正規表現エンジンのような非決定性有限オートマトン \(NFA: Nondeterministic Finite Automaton\) エンジンでは、効率的かつ高速な正規表現を作成する責任は開発者にあります。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [バックトラッキングを使用しない直線的な比較](#linear_comparison_without_backtracking)  
+  
+-   [省略可能な量指定子または代替構成体によるバックトラッキング](#backtracking_with_optional_quantifiers_or_alternation_constructs)  
+  
+-   [入れ子になった省略可能な量指定子によるバックトラッキング](#backtracking_with_nested_optional_quantifiers)  
+  
+-   [バックトラッキングの制御](#controlling_backtracking)  
+  
+<a name="linear_comparison_without_backtracking"></a>   
+## バックトラッキングを使用しない直線的な比較  
+ 正規表現パターンに省略可能な量指定子や代替構成体が含まれていない場合、正規表現エンジンは線形時間で実行されます。 つまり、パターンの最初の言語要素を入力文字列のテキストと照合し、パターンの次の言語要素を入力文字列の次の文字または文字グループと照合するという操作が、 照合が最終的に成功または失敗するまで繰り返されます。 いずれの場合も、正規表現エンジンは入力文字列内を 1 文字ずつ進みます。  
+  
+ 具体的な例を次に示します。 正規表現 `e{2}\w\b` は、文字 "e" が 2 回出現した後に任意の単語文字とワード境界が続くパターンを検索します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking1.cs#1)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking1.vb#1)]  
+  
+ この正規表現には量指定子 `{2}` が含まれていますが、この量指定子は直線的に評価されます。 正規表現エンジンがバックトラックしないのは、`{2}` が省略可能な量指定子ではないからです。この量指定子は、前の部分式が一致する必要がある正確な回数 \(可変の回数ではなく\) を指定しています。 結果として、正規表現エンジンは、次の表に示すような方法でこの正規表現パターンを入力文字列と照合します。  
+  
+|操作|パターン内の位置|文字列内の位置|結果|  
+|--------|--------------|-------------|--------|  
+|1|e|"needing a reed" \(インデックス 0\)|一致なし。|  
+|2|e|"eeding a reed" \(インデックス 1\)|一致候補。|  
+|3|e{2}|"eding a reed" \(インデックス 2\)|一致候補。|  
+|4|\\w|"ding a reed" \(インデックス 3\)|一致候補。|  
+|5|\\b|"ing a reed" \(インデックス 4\)|一致候補の失敗。|  
+|6|e|"eding a reed" \(インデックス 2\)|一致候補。|  
+|7|e{2}|"ding a reed" \(インデックス 3\)|一致候補の失敗。|  
+|8|e|"ding a reed" \(インデックス 3\)|照合の失敗。|  
+|9|e|"ing a reed" \(インデックス 4\)|一致なし。|  
+|10|e|"ng a reed" \(インデックス 5\)|一致なし。|  
+|11|e|"g a reed" \(インデックス 6\)|一致なし。|  
+|12|e|" a reed" \(インデックス 7\)|一致なし。|  
+|13|e|"a reed" \(インデックス 8\)|一致なし。|  
+|14|e|" reed" \(インデックス 9\)|一致なし。|  
+|16|e|"reed" \(インデックス 10\)|一致なし。|  
+|16|e|"eed" \(インデックス 11\)|一致候補。|  
+|17|e{2}|"ed" \(インデックス 12\)|一致候補。|  
+|18|\\w|"d" \(インデックス 13\)|一致候補。|  
+|19|\\b|"" \(インデックス 14\)|一致。|  
+  
+ 正規表現パターンに省略可能な量指定子や代替構成体が含まれていない場合、正規表現パターンと入力文字列の照合に必要な比較の最大数は、入力文字列の文字数にほぼ等しくなります。 この場合、正規表現エンジンは、この 13 文字の文字列の一致候補を特定するために 19 回の比較を使用します。  つまり、正規表現エンジンは、省略可能な量指定子や代替構成体が含まれていない場合にはほぼ線形時間で実行されます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="backtracking_with_optional_quantifiers_or_alternation_constructs"></a>   
+## 省略可能な量指定子または代替構成体によるバックトラッキング  
+ 正規表現に省略可能な量指定子または代替構成体が含まれている場合、入力文字列の評価は直線的ではなくなります。 NFA エンジンによるパターン一致の動作は、照合する入力文字列内の文字ではなく、正規表現内の言語要素によって決まります。 したがって、正規表現エンジンは、省略可能な部分式や代替の部分式を完全に照合しようとします。 部分式内の次の言語要素に進んで照合が失敗した場合は、正規表現全体を入力文字列と照合するために、それまでに見つかった部分的な一致を放棄して、以前に保存した状態に戻ることもあります。 このように、一致を見つけるために以前に保存した状態に戻るプロセスを、バックトラッキングと呼びます。  
+  
+ 例として、`.*(es)` という正規表現パターンについて見てみましょう。この正規表現パターンは、文字 "es" と、それに先行するすべての文字に一致します。 次の例に示すように、入力文字列が "Essential services are provided by regular expressions." の場合、このパターンは、"expressions" の "es" までの文字列全体に一致します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking2.cs#2)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking2.vb#2)]  
+  
+ この場合、正規表現エンジンでは次のようにバックトラッキングが使用されます。  
+  
+-   `.*` \(任意の文字の 0 回以上の出現に一致します\) を入力文字列全体と照合します。  
+  
+-   正規表現パターンの "e" との照合を試みますが、 入力文字列にはもう照合する文字がありません。  
+  
+-   最後に成功した照合 \("Essential services are provided by regular expressions."\) にバックトラックして、"e" を文末のピリオドと照合します。 照合に失敗します。  
+  
+-   成功した前の照合へのバックトラッキングを一度に 1 文字ずつ繰り返して、暫定的に一致する部分文字列 "Essential services are provided by regular expr" に到達します。 その後、パターンの "e" を "expressions" の 2 つ目の "e" と比較して、一致を見つけます。  
+  
+-   パターンの "s" を、一致した文字 "e" の後の "s" \("expressions" の 1 つ目の "s"\) と比較します。 照合に成功します。  
+  
+ バックトラッキングを使用した場合、この正規表現パターンを 55 文字の入力文字列と照合するのに 67 回の比較操作が必要になります。 興味深いことに、この正規表現パターンに最短一致の量指定子 .`*?(es)` が含まれていた場合は、照合に必要な比較が増加します。 この場合、正規表現エンジンは、文字列の末尾から "expressions" の "r" までではなく、文字列の先頭までバックトラックして "Es" を見つけなければなりません。その結果、113 回の比較が必要になります。 一般に、正規表現パターンに 1 つの代替構成体または省略可能な量指定子が含まれている場合、パターンの照合に必要な比較操作の回数は入力文字列の文字数の 2 倍以上になります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="backtracking_with_nested_optional_quantifiers"></a>   
+## 入れ子になった省略可能な量指定子によるバックトラッキング  
+ パターンに多数の代替構成体、入れ子になった代替構成体、または \(最もよくあるケースとして\) 入れ子になった省略可能な量指定子が含まれていると、正規表現パターンの照合に必要な比較操作の回数は指数関数的に増加する可能性があります。 例として、1 つ以上の文字 "a" から成る文字列全体に一致するように作られた `^(a+)+$` という正規表現パターンについて見てみましょう。 次の例では、同じ長さの 2 つの入力文字列が渡されていますが、パターンに一致するのは 1 つ目の文字列だけです。<xref:System.Diagnostics.Stopwatch?displayProperty=fullName> クラスは、照合操作にかかる時間を調べるために使用されています。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking3.cs#3)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking3.vb#3)]  
+  
+ 出力を見るとわかるように、入力文字列がパターンに一致しない場合の処理時間は一致する場合の約 2 倍になります。 これは、照合の失敗は常に最悪のシナリオに相当するためです。 正規表現エンジンは、照合の失敗という結論に到達するまでに、正規表現を使用してデータのすべての可能なパスを辿らなければなりません。かっこが入れ子になっていると、データのパスは大幅に増加します。 2 つ目の文字列がパターンに一致しないという結論に到達するまでに正規表現エンジンによって行われる操作を以下に示します。  
+  
+-   文字列の先頭にいることを確認し、文字列の最初の 5 文字をパターン `a+` と照合します。 次に、文字 "a" のグループが文字列内にそれ以上ないことを特定します。 最後に、文字列の終わりをテストします。 文字列にまだ文字が 1 文字残っているため、照合は失敗します。 この照合の失敗に必要な比較は 9 回です。 正規表現エンジンは、"a" \(以降は照合 1 と呼びます\)、"aa" \(照合 2\)、"aaa" \(照合 3\)、および "aaaa" \(照合 4\) の各照合の状態情報を保存します。  
+  
+-   以前に保存した照合 4 に戻ります。 追加のキャプチャ グループに割り当てる必要がある文字 "a" があと 1 つあることを特定します。 最後に、文字列の終わりをテストします。 文字列にまだ文字が 1 文字残っているため、照合は失敗します。 この照合の失敗に必要な比較は 4 回です。 これまでに実行された比較は合計 13 回になります。  
+  
+-   以前に保存した照合 3 に戻ります。 追加のキャプチャ グループに割り当てる必要がある文字 "a" があと 2 つあることを特定しますが、 文字列の終わりのテストに失敗します。 その後、照合 3 に戻り、2 つの追加のキャプチャ グループの 2 つの追加の文字 "a" を照合しようとしますが、 ここでも文字列の終わりのテストに失敗します。 これらの照合の失敗に必要な比較は 12 回です。 これまでに実行された比較は合計 25 回になります。  
+  
+ このようにして、正規表現エンジンがすべての可能な一致の組み合わせを試行し終わるまで入力文字列と正規表現の比較が続けられます。一致しないという結論に到達するのはその後です。 この比較は、入れ子になった量指定子があるため、O\(2<sup>n</sup>\) \(指数演算、*n* は入力文字列の文字数\) です。 そのため、最悪のケースでは、30 文字の入力文字列で約 1,073,741,824 回、40 文字の入力文字列では約 1,099,511,627,776 回の比較が必要になります。 使用する文字列の長さがこのレベル以上になると、正規表現パターンに一致しない入力を処理するときに、正規表現メソッドの完了までに膨大な時間がかかる可能性があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="controlling_backtracking"></a>   
+## バックトラッキングの制御  
+ バックトラッキングを使用すると、強力かつ柔軟な正規表現を作成できますが、 前のセクションで見たように、受け入れられないほどのパフォーマンスの低下が伴うことがあります。 過度なバックトラッキングを回避するには、<xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化したり静的な正規表現の一致メソッドを呼び出したりするときに、タイムアウト間隔を定義する必要があります。 これについては、次のセクションで説明します。 また、.NET Framework では、バックトラッキングを制限または抑制する 3 つの正規表現言語要素がサポートされています。これらを使用すると、パフォーマンスをほとんど低下させずに複雑な正規表現を使用できます。それらの言語要素とは、[非バックトラッキング部分式](#Nonbacktracking)、[後読みアサーション](#Lookbehind)、および[先読みアサーション](#Lookahead)です。 各言語要素の詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+<a name="Timeout"></a>   
+### タイムアウト間隔の定義  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、正規表現エンジンが単一の一致を検索する最長間隔を表すタイムアウト値を設定できます。それを超えると試行が中止され、<xref:System.Text.RegularExpressions.RegexMatchTimeoutException> 例外がスローされます。 タイムアウト間隔を指定するには、インスタンス正規表現の <xref:System.TimeSpan> コンストラクターに <xref:System.Text.RegularExpressions.Regex.%23ctor%28System.String%2CSystem.Text.RegularExpressions.RegexOptions%2CSystem.TimeSpan%29?displayProperty=fullName> 値を指定します。 また、各静的パターン一致メソッドには、<xref:System.TimeSpan> パラメーターを持つオーバーロードがあり、これを使用してタイムアウト値を指定できます。 既定のタイムアウト間隔は <xref:System.Text.RegularExpressions.Regex.InfiniteMatchTimeout?displayProperty=fullName> に設定されており、正規表現エンジンはタイムアウトしません。  
+  
+> [!IMPORTANT]
+>  正規表現がバックトラッキングに依存する場合は、常にタイムアウト間隔を設定することをお勧めします。  
+  
+ <xref:System.Text.RegularExpressions.RegexMatchTimeoutException> 例外は、指定されたタイムアウト間隔中に正規表現エンジンが一致を見つけられなかったことを示しますが、例外がスローされた原因は示しません。 原因は、通常は過度なバックトラッキングですが、例外がスローされたときのシステムの負荷に対して、タイムアウト間隔の設定が短すぎた可能性もあります。 例外を処理するときに、入力文字列との一致の検索をやめるか、タイムアウト間隔を延長して一致操作を再試行するかを選択できます。  
+  
+ たとえば、次のコードは <xref:System.Text.RegularExpressions.Regex.%23ctor%28System.String%2CSystem.Text.RegularExpressions.RegexOptions%2CSystem.TimeSpan%29?displayProperty=fullName> コンストラクターを呼び出して、1 秒のタイムアウト値を持つ <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化します。 正規表現パターン `(a+)+$` は、行の末尾にある 1 つ以上の "a" 文字の 1 つ以上のシーケンスに一致しますが、過度なバックトラッキングの対象になります。 この例では、<xref:System.Text.RegularExpressions.RegexMatchTimeoutException> がスローされたら、タイムアウト値を 3 秒の最大間隔まで大きくします。 その後、パターンに一致させる試行を中止します。  
+  
+ [!code-csharp[System.Text.RegularExpressions.Regex.ctor#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.text.regularexpressions.regex.ctor/cs/ctor1.cs#1)]
+ [!code-vb[System.Text.RegularExpressions.Regex.ctor#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.text.regularexpressions.regex.ctor/vb/ctor1.vb#1)]  
+  
+<a name="Nonbacktracking"></a>   
+### 非バックトラッキング部分式  
+ `(?>`  *subexpression* `)` 言語要素を使用すると、部分式でバックトラッキングがなされないようにすることができます。 これは、照合の失敗に関連するパフォーマンスの問題の防止に役立ちます。  
+  
+ 次の例は、入れ子になった量指定子を使用している場合にバックトラッキングを抑制すると、いかにパフォーマンスが向上するかを示しています。 この例では、入力文字列が 2 つの正規表現に一致しないことが正規表現エンジンによって確認されるまでの時間を測定しています。 1 つ目の正規表現は、1 つ以上の 16 進数、コロン、1 つ以上の 16 進数、2 つのコロンというパターンを 1 つ以上含む文字列を、バックトラッキングを使用して照合します。 2 つ目の正規表現は、バックトラッキングを無効にする以外は 1 つ目と同じです。 出力を見るとわかるように、バックトラッキングを無効にするとパフォーマンスが大幅に向上します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking4.cs#4)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking4.vb#4)]  
+  
+<a name="Lookbehind"></a>   
+### 後読みアサーション  
+ .NET Framework には、入力文字列の前の文字と一致する 2 つの言語要素 \(`(?<=`*subexpression*`)` と `(?<!`*subexpression*`)`\) が含まれています。 これらの言語要素は、どちらもゼロ幅アサーションです。つまり、現在の文字の直前にある文字が *subexpression* に一致するかどうかを、前進もバックトラッキングもせずに確認します。  
+  
+ `(?<=` *subexpression* `)` は肯定後読みアサーションで、現在の位置の前にある文字が *subexpression* に一致する必要があります。`(?<!`*subexpression*`)` は否定後読みアサーションで、現在の位置の前にある文字が *subexpression* に一致しない必要があります。 否定と肯定のどちらの後読みアサーションも、*subexpression* が前の部分式のサブセットである場合に特に役立ちます。  
+  
+ 次の例では、電子メール アドレスのユーザー名を検証する 2 つの同等の正規表現パターンが使用されています。 1 つ目のパターンでは、過度なバックトラッキングのためにパフォーマンスが低下します。 2 つ目のパターンでは、1 つ目の正規表現に変更を加えて、入れ子になった量指定子を肯定後読みアサーションに置き換えています。 この例の出力には、<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドの実行時間が表示されます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking5.cs#5)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking5.vb#5)]  
+  
+ 最初の正規表現パターン `^[0-9A-Z]([-.\w]*[0-9A-Z])*@` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`[0-9A-Z]`|英数字 1 文字に一致します。<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出されているため、この比較では大文字と小文字が区別されません。|  
+|`[-.\w]*`|ハイフン、ピリオド、または単語文字の 0 回以上の出現に一致します。|  
+|`[0-9A-Z]`|英数字 1 文字に一致します。|  
+|`([-.\w]*[0-9A-Z])*`|0 個以上のハイフン、ピリオド、または単語文字の後に英数字が続く組み合わせの 0 回以上の出現に一致します。 これが最初のキャプチャ グループです。|  
+|`@`|アット マーク \("@"\) に一致します。|  
+  
+ 2 つ目の正規表現パターン `^[0-9A-Z][-.\w]*(?<=[0-9A-Z])@` では、肯定後読みアサーションが使用されています。 このパターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`[0-9A-Z]`|英数字 1 文字に一致します。<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出されているため、この比較では大文字と小文字が区別されません。|  
+|`[-.\w]*`|ハイフン、ピリオド、または単語文字の 0 回以上の出現と一致します。|  
+|`(?<=[0-9A-Z])`|最後に照合された文字を後読みして、英数字だった場合は照合を継続します。 英数字は、ピリオド、ハイフン、およびすべての単語文字から成るセットのサブセットです。|  
+|`@`|アット マーク \("@"\) に一致します。|  
+  
+<a name="Lookahead"></a>   
+### 先読みアサーション  
+ .NET Framework には、入力文字列の次の文字と一致する 2 つの言語要素 \(`(?=`*subexpression*`)` と `(?!`*subexpression*`)`\) が含まれています。 これらの言語要素は、どちらもゼロ幅アサーションです。つまり、現在の文字の直後にある文字が *subexpression* に一致するかどうかを、前進もバックトラッキングもせずに確認します。  
+  
+ `(?=` *subexpression* `)` は肯定先読みアサーションで、現在の位置の後にある文字が *subexpression* に一致する必要があります。`(?!`*subexpression*`)` は否定先読みアサーションで、現在の位置の後にある文字が *subexpression* に一致しない必要があります。 肯定と否定のどちらの先読みアサーションも、*subexpression* が次の部分式のサブセットである場合に特に役立ちます。  
+  
+ 次の例では、完全修飾型名を検証する 2 つの同等の正規表現パターンが使用されています。 1 つ目のパターンでは、過度なバックトラッキングのためにパフォーマンスが低下します。 2 つ目のパターンでは、1 つ目の正規表現に変更を加えて、入れ子になった量指定子を肯定先読みアサーションに置き換えています。 この例の出力には、<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドの実行時間が表示されます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.Backtracking#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/cs/backtracking6.cs#6)]
+ [!code-vb[Conceptual.RegularExpressions.Backtracking#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.backtracking/vb/backtracking6.vb#6)]  
+  
+ 最初の正規表現パターン `^(([A-Z]\w*)+\.)*[A-Z]\w*$` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`([A-Z]\w*)+\.`|1 個の英文字 \(A\-Z\) の後に 0 個以上の単語文字が続くパターンの 1 回以上の繰り返しの後にピリオドが続くパターンに一致します。<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出されているため、この比較では大文字と小文字が区別されません。|  
+|`(([A-Z]\w*)+\.)*`|前のパターンの 0 回以上の繰り返しに一致します。|  
+|`[A-Z]\w*`|1 個の英文字の後に 0 個以上の単語文字が続くパターンに一致します。|  
+|`$`|入力文字列の末尾で照合を終了します。|  
+  
+ 2 つ目の正規表現パターン `^((?=[A-Z])\w+\.)*[A-Z]\w*$` では、肯定先読みアサーションが使用されています。 このパターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`(?=[A-Z])`|先頭の文字を先読みして、英文字 \(A\-Z\) だった場合は照合を継続します。<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出されているため、この比較では大文字と小文字が区別されません。|  
+|`\w+\.`|1 個以上の単語文字の後にピリオドが続くパターンに一致します。|  
+|`((?=[A-Z])\w+\.)*`|1 個以上の単語文字の後にピリオドが続くパターンの 0 回以上の繰り返しと一致します。 最初の単語文字は英文字でなければなりません。|  
+|`[A-Z]\w*`|1 個の英文字の後に 0 個以上の単語文字が続くパターンに一致します。|  
+|`$`|入力文字列の末尾で照合を終了します。|  
+  
+ [ページのトップへ](#top)  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)   
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)   
+ [限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)   
+ [代替構成体](../../../docs/standard/base-types/alternation-constructs-in-regular-expressions.md)   
+ [グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/basic-manipulations.md b/docs/standard/base-types/basic-manipulations.md
index bd0d51c9357..87ae4707a50 100644
--- a/docs/standard/base-types/basic-manipulations.md
+++ b/docs/standard/base-types/basic-manipulations.md
@@ -1,307 +1,33 @@
 ---
-title: "方法: 基本的な文字列操作を実行する"
-description: "方法: 基本的な文字列操作を実行する"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 141d5c94-08db-469c-8a33-708c0d3bba42
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: a8c0433564c1922adf338d230c14d0d3a110f44a
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-perform-basic-string-manipulations"></a>方法: 基本的な文字列操作を実行する
-
-次の例では、「[基本的な文字列操作](basic-string-operations.md)」のトピックで説明したいくつかの方法を使用して、実際のアプリケーションで見られる方法で文字列の操作を実行するクラスを構築します。 `MailToData` クラスは、個人の名前とアドレスを個別のプロパティに格納し、`City`、`State`、`Zip` フィールドを組み合わせて、ユーザーに表示する1 つの文字列にする方法を提供します。 さらに、このクラスを使用して、ユーザーが市区町村、都道府県、および郵便番号情報を&1; つの文字列として入力することができます。アプリケーションは自動的に&1; つの文字列を解析し、対応するプロパティに適切な情報を入力します。
-
-わかりやすいように、この例ではコマンド ライン インターフェイスによるコンソール アプリケーションを使用します。
-
-## <a name="example"></a>例
-
-```csharp
-using System;
-
-class MainClass
-{
-   static void Main()
-   {
-      MailToData MyData = new MailToData();
-
-      Console.Write("Enter Your Name: ");
-      MyData.Name = Console.ReadLine();
-      Console.Write("Enter Your Address: ");
-      MyData.Address = Console.ReadLine();
-      Console.Write("Enter Your City, State, and ZIP Code separated by spaces: ");
-      MyData.CityStateZip = Console.ReadLine();
-      Console.WriteLine();
-
-      if (MyData.Validated) {
-         Console.WriteLine("Name: {0}", MyData.Name);
-         Console.WriteLine("Address: {0}", MyData.Address);
-         Console.WriteLine("City: {0}", MyData.City);
-         Console.WriteLine("State: {0}", MyData.State);
-         Console.WriteLine("Zip: {0}", MyData.Zip);
-
-         Console.WriteLine("\nThe following address will be used:");
-         Console.WriteLine(MyData.Address);
-         Console.WriteLine(MyData.CityStateZip);
-      }
-   }
-}
-
-public class MailToData
-{
-   string name = "";
-   string address = ""; 
-   string citystatezip = "";
-   string city = ""; 
-   string state = ""; 
-   string zip = "";
-   bool parseSucceeded = false;
-
-   public string Name
-   {
-      get{return name;}
-      set{name = value;}
-   }
-
-   public string Address
-   {
-      get{return address;}
-      set{address = value;}
-   }
-
-   public string CityStateZip
-   {
-      get { 
-         return String.Format("{0}, {1} {2}", city, state, zip); 
-      }
-      set {
-         citystatezip = value.Trim();
-         ParseCityStateZip();
-      }
-   }
-
-   public string City
-   {
-      get{return city;}
-      set{city = value;}
-   }
-
-   public string State
-   {
-      get{return state;}
-      set{state = value;}
-   }
-
-   public string Zip
-   {
-      get{return zip;}
-      set{zip = value;}
-   }
-
-   public bool Validated
-   {
-      get { return parseSucceeded; }
-   }
-
-   private void ParseCityStateZip()
-   {  
-      string msg = "";
-      const string msgEnd = "\nYou must enter spaces between city, state, and zip code.\n";
-
-      // Throw a FormatException if the user did not enter the necessary spaces
-      // between elements. 
-      try
-      {
-         // City may consist of multiple words, so we'll have to parse the 
-         // string from right to left starting with the zip code.
-         int zipIndex = citystatezip.LastIndexOf(" ");
-         if (zipIndex == -1) { 
-            msg = "\nCannot identify a zip code." + msgEnd;
-            throw new FormatException(msg);
-         }
-         zip = citystatezip.Substring(zipIndex + 1);        
-
-         int stateIndex = citystatezip.LastIndexOf(" ", zipIndex - 1);
-         if (stateIndex == -1) {  
-            msg = "\nCannot identify a state." + msgEnd;
-            throw new FormatException(msg);
-         }
-         state = citystatezip.Substring(stateIndex + 1, zipIndex - stateIndex - 1);        
-         state = state.ToUpper();
-
-         city = citystatezip.Substring(0, stateIndex);
-         if (city.Length == 0) {
-            msg = "\nCannot identify a city." + msgEnd;
-            throw new FormatException(msg);
-         }
-         parseSucceeded = true;
-      }
-      catch (FormatException ex)
-      {
-         Console.WriteLine(ex.Message);
-      } 
-   }
-
-   private string ReturnCityStateZip()
-    {
-        // Make state uppercase.
-        state = state.ToUpper();
-
-        // Put the value of city, state, and zip together in the proper manner.
-        string MyCityStateZip = String.Concat(city, ", ", state, " ", zip);
-
-        return MyCityStateZip;
-    }
-}
-```
-
-```vb
-Class MainClass
-   Public Shared Sub Main()
-      Dim MyData As New MailToData()
-
-      Console.Write("Enter Your Name: ")
-      MyData.Name = Console.ReadLine()
-      Console.Write("Enter Your Address: ")
-      MyData.Address = Console.ReadLine()
-      Console.Write("Enter Your City, State, and ZIP Code separated by spaces: ")
-      MyData.CityStateZip = Console.ReadLine()
-      Console.WriteLine()
-
-      If MyData.Validated Then
-         Console.WriteLine("Name: {0}", MyData.Name)
-         Console.WriteLine("Address: {0}", MyData.Address)
-         Console.WriteLine("City: {0}", MyData.City)
-         Console.WriteLine("State: {0}", MyData.State)
-         Console.WriteLine("ZIP Code: {0}", MyData.Zip)
-
-         Console.WriteLine("The following address will be used:")
-         Console.WriteLine(MyData.Address)
-         Console.WriteLine(MyData.CityStateZip)
-      End If
-   End Sub
-End Class
-
-Public Class MailToData
-   Private strName As String = ""
-   Private strAddress As String = ""
-   Private strCityStateZip As String = ""
-   Private strCity As String = ""
-   Private strState As String = ""
-   Private strZip As String = ""
-   Private parseSucceeded As Boolean = False
-
-   Public Property Name() As String
-      Get
-         Return strName
-      End Get
-      Set
-         strName = value
-      End Set
-   End Property 
-
-   Public Property Address() As String
-      Get
-         Return strAddress
-      End Get
-      Set
-         strAddress = value
-      End Set
-   End Property 
-
-   Public Property CityStateZip() As String
-      Get
-         Return String.Format("{0}, {1} {2}", strCity, strState, strZip)
-      End Get
-      Set
-         strCityStateZip = value.Trim()
-         ParseCityStateZip()
-      End Set
-   End Property
-
-   Public Property City() As String
-      Get
-         Return strCity
-      End Get
-      Set
-         strCity = value
-      End Set
-   End Property 
-
-   Public Property State() As String
-      Get
-         Return strState
-      End Get
-      Set
-         strState = value
-      End Set
-   End Property 
-
-   Public Property Zip() As String
-      Get
-         Return strZip
-      End Get
-      Set
-         strZip = value
-      End Set
-   End Property
-
-   Public ReadOnly Property Validated As Boolean
-      Get
-         Return parseSucceeded 
-      End Get
-   End Property 
-
-   Private Sub ParseCityStateZip()
-      Dim msg As String = Nothing
-      Const msgEnd As String = vbCrLf + 
-                               "You must enter spaces between city, state, and zip code." +
-                               vbCrLf
-
-      ' Throw a FormatException if the user did not enter the necessary spaces
-      ' between elements. 
-      Try
-         ' City may consist of multiple words, so we'll have to parse the 
-         ' string from right to left starting with the zip code.
-         Dim zipIndex As Integer = strCityStateZip.LastIndexOf(" ")
-         If zipIndex = -1 Then 
-            msg = vbCrLf + "Cannot identify a zip code." + msgEnd
-            Throw New FormatException(msg)
-         End If
-         strZip = strCityStateZip.Substring(zipIndex + 1)        
-
-         Dim stateIndex As Integer = strCityStateZip.LastIndexOf(" ", zipIndex - 1)
-         If stateIndex = -1 Then  
-            msg = vbCrLf + "Cannot identify a state." + msgEnd
-            Throw New FormatException(msg)
-         End If
-         strState = strCityStateZip.Substring(stateIndex + 1, zipIndex - stateIndex - 1)        
-         strState = strState.ToUpper()
-
-         strCity = strCityStateZip.Substring(0, stateIndex)
-         If strCity.Length = 0 Then
-            msg = vbCrLf + "Cannot identify a city." + msgEnd
-            Throw New FormatException(msg)
-         End If
-         parseSucceeded = True
-      Catch ex As FormatException
-         Console.WriteLine(ex.Message)  
-      End Try
-   End Sub
-End Class
-```
-
-上記のコードを実行すると、ユーザーは自分の名前とアドレスを入力するように求められます。 アプリケーションは、適切なプロパティに情報を格納し、市区町村、都道府県、および郵便番号情報を表示する&1; つの文字列を作成して、ユーザーに情報を表示します。
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
+title: "方法: .NET Framework で基本的な文字列操作を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "文字列 [.NET Framework], 例"
+ms.assetid: 121d1eae-251b-44c0-8818-57da04b8215e
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: .NET Framework で基本的な文字列操作を実行する
+「[基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)」で説明したいくつかのメソッドを使用して、実際のアプリケーションで行われるような文字列操作を行うクラスを作成する例を次に示します。  `MailToData` クラスは個人の名前と住所を別々のプロパティに格納し、`City`、`State`、`Zip` の各フィールドを連結して 1 つの文字列としてユーザーに表示できるようにします。  さらに、このクラスを使用すると、ユーザーは都市、州、郵便番号を 1 つの文字列として入力でき、アプリケーションがその文字列を自動的に解析し、対応するプロパティに正しい情報を入力します。  
+  
+ わかりやすくするために、この例ではコマンド ライン インターフェイスを持つコンソール アプリケーションを使用します。  
+  
+## 使用例  
+ [!code-csharp[Conceptual.String.BasicOps#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/basicops.cs#1)]
+ [!code-vb[Conceptual.String.BasicOps#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/basicops.vb#1)]  
+  
+ 上のコードを実行すると、ユーザーは名前と住所を入力するように要求されます。  アプリケーションは入力された情報を適切なプロパティに格納し、都市、州、郵便番号の各情報をまとめて表示する 1 つの文字列を作成して、ユーザーに対して表示します。  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/basic-string-operations.md b/docs/standard/base-types/basic-string-operations.md
index db639112c47..c4cda53b99e 100644
--- a/docs/standard/base-types/basic-string-operations.md
+++ b/docs/standard/base-types/basic-string-operations.md
@@ -1,47 +1,52 @@
 ---
-title: "基本的な文字列操作"
-description: "基本的な文字列操作"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 9658098d-de60-4868-ba5b-0c278748a90f
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: b8bdbeccd226c412e725200fcaf81ec568afc5bc
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="basic-string-operations"></a>基本的な文字列操作
-
-アプリケーションは、多くの場合、ユーザー入力に基づいてメッセージを構築することによってユーザーに応答します。 たとえば、Web サイトで、新たにログオンしたユーザーに対して、ユーザーの名前を含む特別なメッセージで応答することは珍しいことではありません。 [System.String](xref:System.String) と [System.Text.StringBuilder](xref:System.Text.StringBuilder) クラスのいくつかのメソッドを使用すると、ユーザー インターフェイスに表示するカスタム文字列を動的に構築できます。 これらのメソッドでは、バイト配列から新しい文字列を作成する、文字列の値を比較する、既存の文字列を変更するなどのいくつかの基本的な文字列操作を実行することもできます。
-
-## <a name="in-this-section"></a>このセクションの内容
-
-[新しい文字列の作成](creating-new.md) - オブジェクトを文字列に変換し、文字列を結合する基本的な方法について説明します。
-
-[文字のトリムと削除](trimming.md) - 文字列内の文字をトリミングまたは削除する方法について説明します。 
-
-[文字列の埋め込み](padding.md) - 文字列に文字または空白を挿入する方法について説明します。
-
-[文字列の比較](comparing.md) -2 つ以上の文字列の内容を比較する方法について説明します。
-
-[大文字と小文字の変更](changing-case.md) - 文字列内の文字の大文字と小文字を変更する方法について説明します。
-
-[StringBuilder クラスの使用](stringbuilder.md) - [StringBuilder](xref:System.Text.StringBuilder) クラスを使用して、動的な文字列オブジェクトを作成して変更する方法について説明します。
-
-[方法: 基本的な文字列操作を実行する](basic-manipulations.md) - 基本的な文字列操作の使用例を示します。
-
-## <a name="related-sections"></a>関連項目
-
-[型変換](type-conversion.md) - 型を変換する方法について説明します。
-
-[型の書式設定](formatting-types.md) - 文字列の書式指定子を使用して文字列の書式を設定する方法について説明します。
-
-
-
+title: ".NET Framework での基本的な文字列操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "文字列 [.NET Framework]、基本的な文字列操作"
+  - "カスタム文字列"
+ms.assetid: 8133d357-90b5-4b62-9927-43323d99b6b6
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# .NET Framework での基本的な文字列操作
+多くの場合、アプリケーションはユーザーが入力した内容に基づいてメッセージを生成することでユーザーに応答します。  たとえば、Web サイトでは、初めてログオンしたユーザーに対して、そのユーザーの名前を含んだ特別なメッセージが表示されることがよくあります。  <xref:System.String?displayProperty=fullName> クラスおよび <xref:System.Text.StringBuilder?displayProperty=fullName> クラスのいくつかのメソッドを使用すると、ユーザー インターフェイスに表示するカスタム文字列を動的に生成できます。  これらのメソッドは、バイト配列から新しい文字列を作成する、文字列の値を比較する、既存の文字列を変更するなどの基本的な文字列操作を行う場合にも役立ちます。  
+  
+## このセクションの内容  
+ [新しい文字列の作成](../../../docs/standard/base-types/creating-new.md)  
+ オブジェクトを文字列に変換したり、文字列を連結したりする基本的な方法について説明します。  
+  
+ [文字のトリムと削除](../../../docs/standard/base-types/trimming.md)  
+ 文字列内の文字をトリムまたは削除する方法について説明します。  
+  
+ [文字列の埋め込み](../../../docs/standard/base-types/padding.md)  
+ 文字列に文字または空白を挿入する方法について説明します。  
+  
+ [文字列の比較](../../../docs/standard/base-types/comparing.md)  
+ 2 つ以上の文字列の値を比較する方法について説明します。  
+  
+ [大文字と小文字の変更](../../../docs/standard/base-types/changing-case.md)  
+ 文字列に含まれる文字の大文字と小文字を変更する方法について説明します。  
+  
+ [StringBuilder クラスの使用](../../../docs/standard/base-types/stringbuilder.md)  
+ <xref:System.Text.StringBuilder> クラスの動的な文字列オブジェクトを作成および変更する方法について説明します。  
+  
+ [方法: 基本的な文字列操作を実行する](../../../docs/standard/base-types/basic-manipulations.md)  
+ 基本的な文字列操作の例を示します。  
+  
+## 関連項目  
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)  
+ ある型から別の型に変換する方法について説明します。  
+  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)  
+ 書式指定子を使用して文字列の書式を指定する方法について説明します。
\ No newline at end of file
diff --git a/docs/standard/base-types/best-practices-strings.md b/docs/standard/base-types/best-practices-strings.md
index d895bfaac88..c910d1457b7 100644
--- a/docs/standard/base-types/best-practices-strings.md
+++ b/docs/standard/base-types/best-practices-strings.md
@@ -1,1106 +1,374 @@
 ---
-title: "文字列を使用するためのベスト プラクティス"
-description: "文字列を使用するためのベスト プラクティス"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-manager: wpickett
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net-core
-ms.technology: .net-core-technologies
-ms.devlang: dotnet
-ms.assetid: b3cefaa4-0a3f-4a96-aba9-1de30fb07c29
-translationtype: Human Translation
-ms.sourcegitcommit: b20713600d7c3ddc31be5885733a1e8910ede8c6
-ms.openlocfilehash: 3efd30bade564fe1b7dbf93237a9ff40c58c5f1e
-
----
-
-# <a name="best-practices-for-using-strings"></a>文字列を使用するためのベスト プラクティス
-
-.NET には、ローカライズされたアプリケーションやグローバル化されたアプリケーションを開発するための広範なサポートが用意されており、文字列の並べ替えや表示などの一般的な操作を実行するときに、現在のカルチャの規則や特定のカルチャの規則を簡単に適用できるようになっています。 しかし、文字列の並べ替えや比較の操作は、必ずしもカルチャに依存するとは限りません。 たとえば、アプリケーションが内部で使用する文字列は、通常、すべてのカルチャで同じように処理される必要があります。 XML タグ、HTML タグ、ユーザー名、ファイル パス、システム オブジェクトの名前などのカルチャに依存しない文字列データがカルチャに依存するかのように解釈されると、アプリケーション コードで軽度のバグが発生したり、パフォーマンスが低下したり、場合によってはセキュリティの問題を引き起こしたりする可能性があります。
-
-ここでは、.NET の文字列の並べ替え、比較、および大文字と小文字の区別のメソッドについて検討し、適切な文字列処理メソッドを選択するための推奨事項と、文字列処理メソッドに関する追加情報を紹介します。 また、数値データ、日時データなど、書式付きデータを表示および格納のために処理する方法についても説明します。 
-
-この記事は、次のセクションで構成されています。
-
-* [文字列の使用に関する推奨事項](#recommendations-for-string-usage)
-
-* [文字列比較の明示的な指定](#specifying-string-comparisons-explicitly)
-
-* [文字列比較の詳細](#the-details-of-string-comparison)
-
-* [メソッド呼び出しに使用する StringComparison メンバーの選択](#choosing-a-stringcomparison-member-for-your-method-call)
-
-* [一般的な文字列比較メソッド](#common-string-comparison-methods)
-
-* [間接的に文字列比較を実行するメソッド](#methods-that-perform-string-comparison-indirectly)
-
-* [書式設定されたデータを表示および保持する](#displaying-and-persisting-formatted-data)
-
-## <a name="recommendations-for-string-usage"></a>文字列の使用に関する推奨事項
-
-.NET による開発で文字列を使用するときの簡単な推奨事項を次に示します。 
-
-* 文字列操作に対して文字列比較の規則を明示的に指定するオーバーロードを使用します。 そのためには、通常、[StringComparison](xref:System.StringComparison) 型のパラメーターを持つメソッド オーバーロードを呼び出します。
-
-* カルチャに依存しない文字列照合の安全な既定の方法として、[StringComparison.Ordinal](xref:System.StringComparison.Ordinal) または [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) を使用して比較を行います。
-
-* パフォーマンスを向上させるには、[StringComparison.Ordinal](xref:System.StringComparison.Ordinal) または [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) による比較を使用します。
-
-* ユーザーに出力を表示する場合は、[StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture) に基づく文字列操作を使用します。
-
-* 比較が言語的な意味を持たない場合 (記号としての比較など) は、[CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) に基づく文字列操作ではなく、非言語的な [StringComparison.Ordinal](xref:System.StringComparison.Ordinal) 値または [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) 値を使用します。
-
-* 比較のために文字列を正規化する場合は、[String.ToLowerInvariant](xref:System.String.ToLowerInvariant) メソッドではなく [String.ToUpperInvariant](xref:System.String.ToUpperInvariant) メソッドを使用します。
-
-* 2 つの文字列が等価かどうかをテストするには、[String](xref:System.String) `Equals` メソッドのオーバーロードを使用します。
-
-* [String](xref:System.String) `Compare` メソッドと [String.CompareTo](xref:System.String.CompareTo(System.String)) メソッドのオーバーロードは、文字列を並べ替える場合に使用し、文字列の等価性を確認する場合には使用しません。
-
-* 数値、日付など、文字列以外のデータをユーザー インターフェイスに表示するには、カルチャに依存する書式設定を使用します。 文字列以外のデータを文字列形式で保持するには、インバリアント カルチャを使用する書式設定を使用します。
-
-文字列を使用する際に避ける必要があることを次に示します。
-
-* 文字列操作に対して文字列比較の規則を明示的または暗黙的に指定しないオーバーロードは使用しないでください。 
-
-* 2 つの文字列が等価かどうかを確認する場合に、[String](xref:System.String) `Compare` メソッドまたは [String.CompareTo](xref:System.String.CompareTo(System.String)) メソッドのオーバーロードで戻り値が 0 かどうかをテストする方法は使用しないでください。
-
-* 数値データや日時データを文字列形式で保持する場合は、カルチャに依存する書式設定を使用しないでください。
-
-## <a name="specifying-string-comparisons-explicitly"></a>文字列比較の明示的な指定
-
-.NET の文字列操作メソッドは、ほとんどがオーバーロードされています。 通常は、既定の設定をそのまま使用する 1 つまたは複数のオーバーロードと、既定の設定を使用せずに文字列の比較または操作の正確な方法を定義するその他のオーバーロードがあります。 既定の設定に依存しないメソッドには、ほとんどの場合、[StringComparison](xref:System.StringComparison) 型のパラメーターが含まれています。これは、カルチャおよび大文字と小文字の区別によって文字列比較の規則を明示的に指定する列挙型です。 [StringComparison](xref:System.StringComparison) 列挙型のメンバーを次の表に示します。 
-
-StringComparison のメンバー | 説明
------------------------ | -----------
-[StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture) | 現在のカルチャを使用して、大文字と小文字を区別する比較を実行します。
-[CurrentCultureIgnoreCase](xref:System.StringComparison.CurrentCultureIgnoreCase) | 現在のカルチャを使用して、大文字と小文字を区別しない比較を実行します。
-[StringComparison.Ordinal](xref:System.StringComparison.Ordinal) | 序数に基づく比較を実行します。
-[StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) | 大文字と小文字を区別しない、序数に基づく比較を実行します。
-
-たとえば、文字または文字列に一致する[String](xref:System.String) オブジェクト内の部分文字列のインデックスを返す [String](xref:System.String) `IndexOf` メソッドには、次の 9 つのオーバーロードがあります。
-
-* [IndexOf(Char)](xref:System.String.IndexOf(System.Char))、[IndexOf(Char, Int32)](xref:System.String.IndexOf(System.Char,System.Int32))、および [IndexOf(Char, Int32, Int32)](xref:System.String.IndexOf(System.Char,System.Int32,System.Int32))。文字列内の文字の序数に基づく (大文字と小文字を区別し、カルチャに依存しない) 検索を既定で実行します。
-
-* [IndexOf(String)](xref:System.String.IndexOf(System.String))、[IndexOf(String, Int32)](xref:System.String.IndexOf(System.String,System.Int32))、および [IndexOf(String, Int32, Int32)](xref:System.String.IndexOf(System.String,System.Int32,System.Int32))。文字列内の部分文字列の、大文字と小文字を区別し、カルチャに依存した検索を既定で実行します。
-
-* [IndexOf(String, StringComparison)](xref:System.String.IndexOf(System.String,System.StringComparison))、[IndexOf(String, Int32, StringComparison)](xref:System.String.IndexOf(System.String,System.Int32,System.StringComparison))、および [IndexOf(String, Int32, Int32, StringComparison)](xref:System.String.IndexOf(System.String,System.Int32,System.Int32,System.StringComparison))。比較の形式を指定できる StringComparison 型のパラメーターが含まれています。
-
-次のような理由から、既定値を使用しないオーバーロードを選択することをお勧めします。
-
-* 既定のパラメーターを持つオーバーロードには、序数に基づく比較を実行するもの (文字列インスタンスで [Char](xref:System.Char) を検索するもの) と、カルチャに依存するもの (文字列インスタンスで文字列を検索するもの) があります。 どのメソッドがどの既定値を使用するのかを覚えておくのは容易ではなく、使用するオーバーロードを間違えやすくなります。
-
-* メソッド呼び出しで既定値に依存するコードは、意図が不明確になります。 たとえば、既定値に依存する次の例では、2 つの文字列の序数に基づく比較と言語に基づく比較のどちらを開発者が意図しているのかや、`protocol` と "http" の大文字と小文字が違っていた場合に等価性テストで `false` が返されるのかどうかがわかりにくくなっています。
-
-  ```csharp
-  string protocol = GetProtocol(url);       
-  if (String.Equals(protocol, "http", StringComparison.OrdinalIgnoreCase)) {
-     // ...Code to handle HTTP protocol.
-  }
-  else {
-     throw new InvalidOperationException();
-  }
-  ```
-
-  ```vb
-  Dim protocol As String = GetProtocol(url)       
-  If String.Equals(protocol, "http") Then
-    ' ...Code to handle HTTP protocol.
-  Else
-     Throw New InvalidOperationException()
-  End If
-  ```
-
-一般的には、既定値に依存しないメソッドを呼び出すことをお勧めします。そうすると、コードの意図が明確になります。 その結果、コードが読みやすくなるため、デバッグや保守も容易になります。 次の例では、前の例で発生した問題に対応します。 序数比較を使用することと、大文字と小文字の違いを無視することを指定します。 
-
-```csharp
-string protocol = GetProtocol(url);       
-if (String.Equals(protocol, "http", StringComparison.OrdinalIgnoreCase)) {
-   // ...Code to handle HTTP protocol.
-}
-else {
-   throw new InvalidOperationException();
-}
-```
-
-```vb
-Dim protocol As String = GetProtocol(url)       
-If String.Equals(protocol, "http", StringComparison.OrdinalIgnoreCase) Then
-   ' ...Code to handle HTTP protocol.
-Else
-   Throw New InvalidOperationException()
-End If
-```
-
-## <a name="the-details-of-string-comparison"></a>文字列比較の詳細
-
-文字列比較は、多くの文字列関連操作 (特に並べ替えおよび等価性テスト) の中核です。 文字列は、決まった順序で並べられています。たとえば、文字列の並べ替え済みリストで "my" が "string" の前にある場合は、比較で "my" が "string" 以下になる必要があります。 また、比較は等価性を暗黙的に定義します。 比較演算では、等価と見なされた文字列に対して 0 が返されます。 これは、どちらの文字列ももう一方の文字列より小さくないという意味に解釈するとわかりやすくなります。 文字列に関係する、意味のある操作のほとんどには、他の文字列との比較か、正しく定義された並べ替え操作の実行のいずれかまたは両方の処理が含まれています。
-
-しかし、2 つの文字列の等価性や並べ替え順序を評価する場合、正しい結果は 1 つではありません。結果は、文字列の比較に使用される基準に依存するためです。 特に、序数に基づく文字列比較や、現在のカルチャまたはインバリアント カルチャ (英語をベースとする、ロケールに依存しないカルチャ) の大文字と小文字の規則や並べ替えの規則に基づく文字列比較では、さまざまな結果が返される可能性があります。
-
-### <a name="string-comparisons-that-use-the-current-culture"></a>現在のカルチャを使用する文字列比較
-
-文字列を比較するときの基準として現在のカルチャの規則が使用される場合があります。 現在のカルチャに基づく比較では、スレッドの現在のカルチャ (ロケール) が使用されます。 言語的な意味を持つデータや、カルチャに依存したユーザー操作を反映するデータに対しては、常に現在のカルチャに基づく比較を使用する必要があります。 
-
-しかし、.NET の比較や大文字と小文字の区別の動作は、カルチャによって変わります。 たとえば、開発されたコンピューターとは異なるカルチャのコンピューターでアプリケーションが実行された場合や、実行中のスレッドのカルチャが変更された場合などに、この変化が生じます。 これは意図的な動作ですが、多くの開発者にはまだあまり知られていません。 次の例は、英語 (米国) ("en-US") とスウェーデン語 ("sv-SE") のカルチャの並べ替え順序の違いを示しています。 並べ替えられた文字列配列で、"ångström"、"Windows"、および "Visual Studio" の位置が違っていることに注目してください。
-
-```csharp
-using System;
-using System.Globalization;
-using System.Threading;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] values= { "able", "ångström", "apple", "Æble", 
-                         "Windows", "Visual Studio" };
-      Array.Sort(values);
-      DisplayArray(values);
-
-      // Change culture to Swedish (Sweden).
-      string originalCulture = CultureInfo.CurrentCulture.Name;
-      Thread.CurrentThread.CurrentCulture = new CultureInfo("sv-SE");
-      Array.Sort(values);
-      DisplayArray(values);
-
-      // Restore the original culture.
-      Thread.CurrentThread.CurrentCulture = new CultureInfo(originalCulture);
-    }
-
-    private static void DisplayArray(string[] values)
-    {
-      Console.WriteLine("Sorting using the {0} culture:",  
-                        CultureInfo.CurrentCulture.Name);
-      foreach (string value in values)
-         Console.WriteLine("   {0}", value);
-
-      Console.WriteLine();
-    }
-}
-// The example displays the following output:
-//       Sorting using the en-US culture:
-//          able
-//          Æble
-//          ångström
-//          apple
-//          Visual Studio
-//          Windows
-//       
-//       Sorting using the sv-SE culture:
-//          able
-//          Æble
-//          apple
-//          Windows
-//          Visual Studio
-//          ångström
-```
-
-```vb
-Imports System.Globalization
-Imports System.Threading
-
-Module Example
-   Public Sub Main()
-      Dim values() As String = { "able", "ångström", "apple", _
-                                 "Æble", "Windows", "Visual Studio" }
-      Array.Sort(values)
-      DisplayArray(values)
-
-      ' Change culture to Swedish (Sweden).
-      Dim originalCulture As String = CultureInfo.CurrentCulture.Name
-      Thread.CurrentThread.CurrentCulture = New CultureInfo("sv-SE")
-      Array.Sort(values)
-      DisplayArray(values)
-
-      ' Restore the original culture.
-      Thread.CurrentThread.CurrentCulture = New CultureInfo(originalCulture)
-    End Sub
-
-    Private Sub DisplayArray(values() As String)
-      Console.WRiteLine("Sorting using the {0} culture:", _ 
-                        CultureInfo.CurrentCulture.Name)
-      For Each value As String In values
-         Console.WriteLine("   {0}", value)
-      Next
-      Console.WriteLine()   
-    End Sub
-End Module
-' The example displays the following output:
-'       Sorting using the en-US culture:
-'          able
-'          Æble
-'          ångström
-'          apple
-'          Visual Studio
-'          Windows
-'       
-'       Sorting using the sv-SE culture:
-'          able
-'          Æble
-'          apple
-'          Windows
-'          Visual Studio
-'          ångström
-```
-
-現在のカルチャを使用する、大文字と小文字を区別しない比較は、スレッドの現在のカルチャの大文字と小文字の区別の規則が無視される以外は、カルチャに依存した比較と同じです。 この動作も、並べ替え順序に影響する場合があります。 
-
-現在のカルチャのセマンティクスを使用する比較は、次のメソッドで既定で使用されます。
-
-* [StringComparison](xref:System.StringComparison) パラメーターを含まない [String](xref:System.String) `Compare` オーバーロード。
-
-* [String.CompareTo](xref:System.String.CompareTo(System.String)) オーバーロード。
-
-* 既定の [String.StartsWith(String)](xref:System.String.StartsWith(System.String)) メソッド。 
-
-* 既定の [String.EndsWith(String)](xref:System.String.EndsWith(System.String)) メソッド。
-
-* 検索パラメーターとして [String](xref:System.String) を受け取る、[StringComparison](xref:System.StringComparison) パラメーターを持たない [String](xref:System.String) `IndexOf` のオーバーロード。
-
-* 検索パラメーターとして [String](xref:System.String) を受け取る、[StringComparison](xref:System.StringComparison) パラメーターを持たない [String](xref:System.String) `LastIndexOf` のオーバーロード。
-
-どのような場合でも、[StringComparison](xref:System.StringComparison) パラメーターを持つオーバーロードを呼び出して、メソッド呼び出しの意図を明確にすることをお勧めします。 
-
-非言語的な文字列データが言語的に解釈されたり、特定のカルチャの文字列データが別のカルチャの規則で解釈されたりすると、軽度のバグやあまり軽度でないバグが発生する可能性があります。 その典型的な例が、トルコ語の I の問題です。
-
-英語 (米国) を含むほぼすべてのラテン アルファベットでは、文字 "i" (\u0069) は "I" (\u0049) の小文字版です。 この大文字と小文字の規則は、このようなカルチャでプログラミングを行う人にとってはすぐに当たり前のことになります。 しかし、トルコ語 ("tr-TR") のアルファベットには、"i" の大文字版である "ドット付きの I" ("İ" (\u0130)) や、 大文字にすると "I" になる小文字の "ドットなしの i" ("ı" (\u0131)) があります。 この動作は、アゼルバイジャン語 ("az") のカルチャでも発生します。
-
-したがって、"i" を大文字にしたり "I" を小文字にしたりする動作に関する前提は、すべてのカルチャで有効なわけではありません。 文字列比較ルーチンの既定のオーバーロードを使用すると、カルチャ間の差異の影響を受けることになります。 また、非言語的なデータを比較する場合も、既定のオーバーロードを使用すると望ましくない結果が返される可能性があります。たとえば次の例では、文字列 "file" と "FILE" の大文字と小文字を区別しない比較を実行しようとしています。
-
-```csharp
-using System;
-using System.Globalization;
-using System.Threading;
-
-public class Example
-{
-   public static void Main()
-   {
-      string fileUrl = "file";
-      Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");
-      Console.WriteLine("Culture = {0}",
-                        Thread.CurrentThread.CurrentCulture.DisplayName);
-      Console.WriteLine("(file == FILE) = {0}", 
-                       fileUrl.StartsWith("FILE", true, null));
-      Console.WriteLine();
-
-      Thread.CurrentThread.CurrentCulture = new CultureInfo("tr-TR");
-      Console.WriteLine("Culture = {0}",
-                        Thread.CurrentThread.CurrentCulture.DisplayName);
-      Console.WriteLine("(file == FILE) = {0}", 
-                        fileUrl.StartsWith("FILE", true, null));
-   }
-}
-// The example displays the following output:
-//       Culture = English (United States)
-//       (file == FILE) = True
-//       
-//       Culture = Turkish (Turkey)
-//       (file == FILE) = False
-```
-
-```vb
-Imports System.Globalization
-Imports System.Threading
-
-Module Example
-   Public Sub Main()
-      Dim fileUrl = "file"
-      Thread.CurrentThread.CurrentCulture = New CultureInfo("en-US")
-      Console.WriteLine("Culture = {0}", _
-                        Thread.CurrentThread.CurrentCulture.DisplayName)
-      Console.WriteLine("(file == FILE) = {0}", _ 
-                       fileUrl.StartsWith("FILE", True, Nothing))
-      Console.WriteLine()
-
-      Thread.CurrentThread.CurrentCulture = New CultureInfo("tr-TR")
-      Console.WriteLine("Culture = {0}", _
-                        Thread.CurrentThread.CurrentCulture.DisplayName)
-      Console.WriteLine("(file == FILE) = {0}", _ 
-                        fileUrl.StartsWith("FILE", True, Nothing))
-   End Sub
-End Module
-' The example displays the following output:
-'       Culture = English (United States)
-'       (file == FILE) = True
-'       
-'       Culture = Turkish (Turkey)
-'       (file == FILE) = False
-```
-
-この比較は、セキュリティが重要となる状況でカルチャが不注意に使用されると、重大な問題を引き起こす可能性があります。 `IsFileURI("file:")` などのメソッド呼び出しは、現在のカルチャが英語 (米国) の場合は `true` を返しますが、現在のカルチャがトルコ語の場合は `false` を返します。 したがって、"FILE:" で始まる URI へのアクセスを大文字と小文字の区別なくブロックするセキュリティ対策は、トルコ語のシステムでは攻略される可能性があります。
-
-```csharp
-public static bool IsFileURI(String path) 
-{
-   return path.StartsWith("FILE:", true, null);
-}
-```
-
-```vb
-Public Shared Function IsFileURI(path As String) As Boolean 
-   Return path.StartsWith("FILE:", True, Nothing)
-End Function
-```
-
-この例の "file:" は、カルチャに依存しない非言語的な識別子として解釈されるものなので、コードを次のように書き換える必要があります。
-
-```csharp
-public static bool IsFileURI(string path) 
-{
-   return path.StartsWith("FILE:", StringComparison.OrdinalIgnoreCase);
-}
-```
-
-```vb
-Public Shared Function IsFileURI(path As String) As Boolean 
-    Return path.StartsWith("FILE:", StringComparison.OrdinalIgnoreCase)
-End Function
-```
-
-## <a name="ordinal-string-operations"></a>序数に基づく文字列操作
-
-メソッド呼び出しで [StringComparison.Ordinal](xref:System.StringComparison.Ordinal) 値または [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) 値を指定すると、非言語的な比較が行われ、自然言語の特性は無視されます。 これらの [StringComparison](xref:System.StringComparison) 値を使用して呼び出されたメソッドでは、文字列操作の判断が、大文字と小文字の指定、またはカルチャでパラメーター化される同等の表ではなく、単純なバイト比較に基づいて行われます。 これにより、ほとんどの場合に文字列が意図されたとおりに解釈され、コードの実行速度と信頼性も向上します。 
-
-序数に基づく比較とは、各文字列の各バイトが言語的に解釈されずに比較される文字列比較です (たとえば、"windows" と "Windows" は一致しません)。 文字列が厳密に一致する必要がある状況や、慎重な照合ポリシーが求められる状況では、この比較を使用します。 また、序数に基づく比較は最も高速な比較演算でもあります。これは、結果を判定するときに言語の規則が適用されないためです。
-
-.NET の文字列には、null 文字が埋め込まれる場合があります。 序数に基づく比較とカルチャに依存した比較 (インバリアント カルチャを使用する比較を含む) の最も明白な違いの 1 つは、文字列に埋め込まれた null 文字の処理に関連しています。 これらの文字は、[String](xref:System.String) `Compare` メソッドや [String](xref:System.String) `Equals` メソッドを使用して、カルチャに依存した比較 (インバリアント カルチャを使用する比較を含む) を実行する場合には無視されます。 その結果、カルチャに依存した比較では、null 文字が埋め込まれた文字列と null 文字が埋め込まれていない文字列が等価と見なされる可能性があります。 
-
+title: ".NET Framework で文字列を使用するためのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "推奨される手順, 文字列の比較と並べ替え"
+  - "比較 (文字列を)"
+  - "並べ替え (文字列を)"
+  - "文字列比較 [.NET Framework], 推奨される手順"
+  - "文字列の並べ替え"
+  - "文字列 [.NET Framework], 基本的な文字列操作"
+  - "文字列 [.NET Framework], 推奨される手順"
+  - "文字列 [.NET Framework], 比較"
+  - "文字列 [.NET Framework], 検索"
+  - "文字列 [.NET Framework], 並べ替え"
+ms.assetid: b9f0bf53-e2de-4116-8ce9-d4f91a1df4f7
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# .NET Framework で文字列を使用するためのベスト プラクティス
+<a name="top"></a> .NET Framework には、ローカライズされたアプリケーションやグローバル化されたアプリケーションを開発するための広範なサポートが用意されており、文字列の並べ替えや表示などの一般的な操作を実行するときに、現在のカルチャの規則や特定のカルチャの規則を簡単に適用できるようになっています。 しかし、文字列の並べ替えや比較の操作は、必ずしもカルチャに依存するとは限りません。 たとえば、アプリケーションが内部で使用する文字列は、通常、すべてのカルチャで同じように処理される必要があります。 XML タグ、HTML タグ、ユーザー名、ファイル パス、システム オブジェクトの名前などのカルチャに依存しない文字列データがカルチャに依存するかのように解釈されると、アプリケーション コードで軽度のバグが発生したり、パフォーマンスが低下したり、場合によってはセキュリティの問題を引き起こしたりする可能性があります。  
+  
+ ここでは、NET Framework の文字列の並べ替え、比較、および大文字と小文字の区別のメソッドについて検討し、適切な文字列処理メソッドを選択するための推奨事項と、文字列処理メソッドに関する追加情報を紹介します。 また、数値データ、日時データなど、書式付きデータを表示および格納のために処理する方法についても説明します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [文字列の使用に関する推奨事項](#recommendations_for_string_usage)  
+  
+-   [文字列比較の明示的な指定](#specifying_string_comparisons_explicitly)  
+  
+-   [文字列比較の詳細](#the_details_of_string_comparison)  
+  
+-   [メソッド呼び出しに使用する StringComparison メンバーの選択](#choosing_a_stringcomparison_member_for_your_method_call)  
+  
+-   [.NET Framework の一般的な文字列比較メソッド](#common_string_comparison_methods_in_the_net_framework)  
+  
+-   [間接的に文字列比較を実行するメソッド](#methods_that_perform_string_comparison_indirectly)  
+  
+-   [書式設定されたデータを表示および保持する](#Formatted)  
+  
+<a name="recommendations_for_string_usage"></a>   
+## 文字列の使用に関する推奨事項  
+ .NET Framework による開発で文字列を使用するときの簡単な推奨事項を次に示します。  
+  
+-   文字列操作に対して文字列比較の規則を明示的に指定するオーバーロードを使用します。 そのためには、通常、<xref:System.StringComparison> 型のパラメーターを持つメソッド オーバーロードを呼び出します。  
+  
+-   カルチャに依存しない文字列照合の安全な既定の方法として、<xref:System.StringComparison?displayProperty=fullName> または <xref:System.StringComparison?displayProperty=fullName> を使用して比較を行います。  
+  
+-   パフォーマンスを向上させるには、<xref:System.StringComparison?displayProperty=fullName> または <xref:System.StringComparison?displayProperty=fullName> による比較を使用します。  
+  
+-   ユーザーに出力を表示する場合は、<xref:System.StringComparison?displayProperty=fullName> に基づく文字列操作を使用します。  
+  
+-   比較が言語的な意味を持たない場合 \(記号としての比較など\) は、<xref:System.StringComparison?displayProperty=fullName> に基づく文字列操作ではなく、非言語的な <xref:System.StringComparison?displayProperty=fullName> 値または <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> 値を使用します。  
+  
+-   比較のために文字列を正規化する場合は、<xref:System.String.ToUpperInvariant%2A?displayProperty=fullName> メソッドではなく <xref:System.String.ToLowerInvariant%2A?displayProperty=fullName> メソッドを使用します。  
+  
+-   2 つの文字列が等価かどうかをテストするには、<xref:System.String.Equals%2A?displayProperty=fullName> メソッドのオーバーロードを使用します。  
+  
+-   <xref:System.String.Compare%2A?displayProperty=fullName> メソッドと <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドは、文字列を並べ替える場合に使用し、文字列の等価性を確認する場合には使用しません。  
+  
+-   数値、日付など、文字列以外のデータをユーザー インターフェイスに表示するには、カルチャに依存する書式設定を使用します。 文字列以外のデータを文字列形式で保持するには、インバリアント カルチャを使用する書式設定を使用します。  
+  
+ 文字列を使用する際に避ける必要があることを次に示します。  
+  
+-   文字列操作に対して文字列比較の規則を明示的または暗黙的に指定しないオーバーロードは使用しないでください。  
+  
+-   ほとんどの場合、<xref:System.StringComparison?displayProperty=fullName> に基づく文字列操作は使用しないでください。 数少ない例外の 1 つは、言語的な意味を持つがカルチャには依存しないデータを永続化する場合です。  
+  
+-   2 つの文字列が等価かどうかを確認する場合に、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドまたは <xref:System.String.CompareTo%2A> メソッドのオーバーロードで戻り値が 0 かどうかをテストする方法は使用しないでください。  
+  
+-   数値データや日時データを文字列形式で保持する場合は、カルチャに依存する書式設定を使用しないでください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="specifying_string_comparisons_explicitly"></a>   
+## 文字列比較の明示的な指定  
+ .NET Framework の文字列操作メソッドは、ほとんどがオーバーロードされています。 通常は、既定の設定をそのまま使用する 1 つまたは複数のオーバーロードと、既定の設定を使用せずに文字列の比較または操作の正確な方法を定義するその他のオーバーロードがあります。 既定の設定に依存しないメソッドには、ほとんどの場合、<xref:System.StringComparison> 型のパラメーターが含まれています。これは、カルチャおよび大文字と小文字の区別によって文字列比較の規則を明示的に指定する列挙型です。<xref:System.StringComparison> 列挙型のメンバーを次の表に示します。  
+  
+|StringComparison のメンバー|説明|  
+|----------------------------|--------|  
+|<xref:System.StringComparison>|現在のカルチャを使用して、大文字と小文字を区別する比較を実行します。|  
+|<xref:System.StringComparison>|現在のカルチャを使用して、大文字と小文字を区別しない比較を実行します。|  
+|<xref:System.StringComparison>|インバリアント カルチャを使用して、大文字と小文字を区別する比較を実行します。|  
+|<xref:System.StringComparison>|インバリアント カルチャを使用して、大文字と小文字を区別しない比較を実行します。|  
+|<xref:System.StringComparison>|序数に基づく比較を実行します。|  
+|<xref:System.StringComparison>|大文字と小文字を区別しない、序数に基づく比較を実行します。|  
+  
+ たとえば、文字または文字列に一致する <xref:System.String.IndexOf%2A> オブジェクト内の部分文字列のインデックスを返す <xref:System.String> メソッドには、次の 9 つのオーバーロードがあります。  
+  
+-   <xref:System.String.IndexOf%28System.Char%29>、<xref:System.String.IndexOf%28System.Char%2CSystem.Int32%29>、および <xref:System.String.IndexOf%28System.Char%2CSystem.Int32%2CSystem.Int32%29>。文字列内の文字の序数に基づく \(大文字と小文字を区別し、カルチャに依存しない\) 検索を既定で実行します。  
+  
+-   <xref:System.String.IndexOf%28System.String%29>、<xref:System.String.IndexOf%28System.String%2CSystem.Int32%29>、および <xref:System.String.IndexOf%28System.String%2CSystem.Int32%2CSystem.Int32%29>。文字列内の部分文字列の、大文字と小文字を区別し、カルチャに依存した検索を既定で実行します。  
+  
+-   <xref:System.String.IndexOf%28System.String%2CSystem.StringComparison%29>、<xref:System.String.IndexOf%28System.String%2CSystem.Int32%2CSystem.StringComparison%29>、および <xref:System.String.IndexOf%28System.String%2CSystem.Int32%2CSystem.Int32%2CSystem.StringComparison%29>。比較の形式を指定できる <xref:System.StringComparison> 型のパラメーターが含まれています。  
+  
+ 次のような理由から、既定値を使用しないオーバーロードを選択することをお勧めします。  
+  
+-   既定のパラメーターを持つオーバーロードには、序数に基づく比較を実行するもの \(文字列インスタンスで <xref:System.Char> を検索するもの\) と、カルチャに依存するもの \(文字列インスタンスで文字列を検索するもの\) があります。 どのメソッドがどの既定値を使用するのかを覚えておくのは容易ではなく、使用するオーバーロードを間違えやすくなります。  
+  
+-   メソッド呼び出しで既定値に依存するコードは、意図が不明確になります。 既定値に依存する次の例では、2 つの文字列の序数に基づく比較と言語に基づく比較のどちらを開発者が意図しているのかや、`protocol` と "http" の大文字と小文字が違っていた場合に等価性テストで `false` が返されるのかどうかがわかりにくくなっています。  
+  
+     [!code-csharp[Conceptual.Strings.BestPractices#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/explicitargs1.cs#1)]
+     [!code-vb[Conceptual.Strings.BestPractices#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/explicitargs1.vb#1)]  
+  
+ 一般的には、既定値に依存しないメソッドを呼び出すことをお勧めします。そうすると、コードの意図が明確になります。 その結果、コードが読みやすくなるため、デバッグや保守も容易になります。 次の例では、前の例で発生した問題に対応します。 序数比較を使用することと、大文字と小文字の違いを無視することを指定します。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/explicitargs1.cs#2)]
+ [!code-vb[Conceptual.Strings.BestPractices#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/explicitargs1.vb#2)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="the_details_of_string_comparison"></a>   
+## 文字列比較の詳細  
+ 文字列比較は、多くの文字列関連操作 \(特に並べ替えおよび等価性テスト\) の中核です。 文字列は、決まった順序で並べられています。たとえば、文字列の並べ替え済みリストで "my" が "string" の前にある場合は、比較で "my" が "string" 以下になる必要があります。 また、比較は等価性を暗黙的に定義します。 比較演算では、等価と見なされた文字列に対して 0 が返されます。 これは、どちらの文字列ももう一方の文字列より小さくないという意味に解釈するとわかりやすくなります。 文字列に関係する、意味のある操作のほとんどには、他の文字列との比較か、正しく定義された並べ替え操作の実行のいずれかまたは両方の処理が含まれています。  
+  
+ しかし、2 つの文字列の等価性や並べ替え順序を評価する場合、正しい結果は 1 つではありません。結果は、文字列の比較に使用される基準に依存するためです。 特に、序数に基づく文字列比較や、現在のカルチャまたはインバリアント カルチャ \(英語をベースとする、ロケールに依存しないカルチャ\) の大文字と小文字の規則や並べ替えの規則に基づく文字列比較では、さまざまな結果が返される可能性があります。  
+  
+<a name="current_culture"></a>   
+### 現在のカルチャを使用する文字列比較  
+ 文字列を比較するときの基準として現在のカルチャの規則が使用される場合があります。 現在のカルチャに基づく比較では、スレッドの現在のカルチャ \(ロケール\) が使用されます。 ユーザーがカルチャを設定していない場合は、コントロール パネルの **\[地域のオプション\]** ウィンドウの設定が既定で使用されます。 言語的な意味を持つデータや、カルチャに依存したユーザー操作を反映するデータに対しては、常に現在のカルチャに基づく比較を使用する必要があります。  
+  
+ しかし、.NET Framework の比較や大文字と小文字の区別の動作は、カルチャによって変わります。 たとえば、開発されたコンピューターとは異なるカルチャのコンピューターでアプリケーションが実行された場合や、実行中のスレッドのカルチャが変更された場合などに、この変化が生じます。 これは意図的な動作ですが、多くの開発者にはまだあまり知られていません。 次の例は、英語 \(米国\) \("en\-US"\) とスウェーデン語 \("sv\-SE"\) のカルチャの並べ替え順序の違いを示しています。 並べ替えられた文字列配列で、"ångström"、"Windows"、および "Visual Studio" の位置が違っていることに注目してください。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/comparison1.cs#3)]
+ [!code-vb[Conceptual.Strings.BestPractices#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/comparison1.vb#3)]  
+  
+ 現在のカルチャを使用する、大文字と小文字を区別しない比較は、スレッドの現在のカルチャの大文字と小文字の区別の規則が無視される以外は、カルチャに依存した比較と同じです。 この動作も、並べ替え順序に影響する場合があります。  
+  
+ 現在のカルチャのセマンティクスを使用する比較は、次のメソッドで既定で使用されます。  
+  
+-   <xref:System.String.Compare%2A?displayProperty=fullName> パラメーターを含まない <xref:System.StringComparison> のオーバーロード。  
+  
+-   <xref:System.String.CompareTo%2A?displayProperty=fullName> のオーバーロード。  
+  
+-   既定の <xref:System.String.StartsWith%28System.String%29?displayProperty=fullName> メソッドと、`null` <xref:System.Globalization.CultureInfo> パラメーターを持つ <xref:System.String.StartsWith%28System.String%2CSystem.Boolean%2CSystem.Globalization.CultureInfo%29?displayProperty=fullName> メソッド。  
+  
+-   既定の <xref:System.String.EndsWith%28System.String%29?displayProperty=fullName> メソッドと、`null` <xref:System.Globalization.CultureInfo> パラメーターを持つ <xref:System.String.EndsWith%28System.String%2CSystem.Boolean%2CSystem.Globalization.CultureInfo%29?displayProperty=fullName> メソッド。  
+  
+-   検索パラメーターとして <xref:System.String.IndexOf%2A?displayProperty=fullName> を受け取る、<xref:System.String> パラメーターを持たない <xref:System.StringComparison> のオーバーロード。  
+  
+-   検索パラメーターとして <xref:System.String.LastIndexOf%2A?displayProperty=fullName> を受け取る、<xref:System.String> パラメーターを持たない <xref:System.StringComparison> のオーバーロード。  
+  
+ どのような場合でも、<xref:System.StringComparison> パラメーターを持つオーバーロードを呼び出して、メソッド呼び出しの意図を明確にすることをお勧めします。  
+  
+ 非言語的な文字列データが言語的に解釈されたり、特定のカルチャの文字列データが別のカルチャの規則で解釈されたりすると、軽度のバグやあまり軽度でないバグが発生する可能性があります。 その典型的な例が、トルコ語の I の問題です。  
+  
+ 英語 \(米国\) を含むほぼすべてのラテン アルファベットでは、文字 "i" \(\\u0069\) は "I" \(\\u0049\) の小文字版です。 この大文字と小文字の規則は、このようなカルチャでプログラミングを行う人にとってはすぐに当たり前のことになります。 しかし、トルコ語 \("tr\-TR"\) のアルファベットには、"i" の大文字版である "ドット付きの I" \("İ" \(\\u0130\)\) や、 大文字にすると "I" になる小文字の "ドットなしの i" \("ı" \(\\u0131\)\) があります。 この動作は、アゼルバイジャン語 \("az"\) のカルチャでも発生します。  
+  
+ したがって、"i" を大文字にしたり "I" を小文字にしたりする動作に関する前提は、すべてのカルチャで有効なわけではありません。 文字列比較ルーチンの既定のオーバーロードを使用すると、カルチャ間の差異の影響を受けることになります。 また、非言語的なデータを比較する場合も、既定のオーバーロードを使用すると望ましくない結果が返される可能性があります。たとえば次の例では、文字列 "file" と "FILE" の大文字と小文字を区別しない比較を実行しようとしています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/turkish1.cs#11)]
+ [!code-vb[Conceptual.Strings.BestPractices#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/turkish1.vb#11)]  
+  
+ この比較は、セキュリティが重要となる状況でカルチャが不注意に使用されると、重大な問題を引き起こす可能性があります。`IsFileURI("file:")` などのメソッド呼び出しは、現在のカルチャが英語 \(米国\) の場合は `true` を返しますが、現在のカルチャがトルコ語の場合は `false` を返します。 したがって、"FILE:" で始まる URI へのアクセスを大文字と小文字の区別なくブロックするセキュリティ対策は、トルコ語のシステムでは攻略される可能性があります。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/turkish1.cs#12)]
+ [!code-vb[Conceptual.Strings.BestPractices#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/turkish1.vb#12)]  
+  
+ この例の "file:" は、カルチャに依存しない非言語的な識別子として解釈されるものなので、コードを次のように書き換える必要があります。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/turkish1.cs#13)]
+ [!code-vb[Conceptual.Strings.BestPractices#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/turkish1.vb#13)]  
+  
+### 序数に基づく文字列操作  
+ メソッド呼び出しで <xref:System.StringComparison?displayProperty=fullName> 値または <xref:System.StringComparison?displayProperty=fullName> 値を指定すると、非言語的な比較が行われ、自然言語の特性は無視されます。 これらの <xref:System.StringComparison> 値を使用して呼び出されたメソッドでは、文字列操作の判断が、大文字と小文字の指定、またはカルチャでパラメーター化される同等の表ではなく、単純なバイト比較に基づいて行われます。 これにより、ほとんどの場合に文字列が意図されたとおりに解釈され、コードの実行速度と信頼性も向上します。  
+  
+ 序数に基づく比較とは、各文字列の各バイトが言語的に解釈されずに比較される文字列比較です \(たとえば、"windows" と "Windows" は一致しません\)。 これは、実質的には C ランタイムの `strcmp` 関数の呼び出しです。 文字列が厳密に一致する必要がある状況や、慎重な照合ポリシーが求められる状況では、この比較を使用します。 また、序数に基づく比較は最も高速な比較演算でもあります。これは、結果を判定するときに言語の規則が適用されないためです。  
+  
+ .NET Framework の文字列には、null 文字が埋め込まれる場合があります。 序数に基づく比較とカルチャに依存した比較 \(インバリアント カルチャを使用する比較を含む\) の最も明白な違いの 1 つは、文字列に埋め込まれた null 文字の処理に関連しています。 これらの文字は、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドや <xref:System.String.Equals%2A?displayProperty=fullName> メソッドを使用して、カルチャに依存した比較 \(インバリアント カルチャを使用する比較を含む\) を実行する場合には無視されます。 その結果、カルチャに依存した比較では、null 文字が埋め込まれた文字列と null 文字が埋め込まれていない文字列が等価と見なされる可能性があります。  
+  
 > [!IMPORTANT]
-> 埋め込まれた null 文字は、文字列比較メソッドでは無視されますが、文字列検索メソッド ([String.Contains](xref:System.String.Contains(System.String))、[String.EndsWith](xref:System.String.EndsWith(System.String))、[String.IndexOf](xref:System.String.IndexOf(System.Char))、[String.LastIndexOf](xref:System.String.LastIndexOf(System.String))、[String.StartsWith](xref:System.String.StartsWith(System.String)) など) では無視されません。 
-
-次の例では、文字列 "Aa" と、"A" と "a" の間にいくつかの null 文字が埋め込まれた類似の文字列とのカルチャに依存した比較を実行して、2 つの文字列が等価と見なされることを示しています。 
-
-```csharp
-using System;
-
-public class Example
-{
-   public static void Main()
-   {
-      string str1 = "Aa";
-      string str2 = "A" + new String('\u0000', 3) + "a";
-      Console.WriteLine("Comparing '{0}' ({1}) and '{2}' ({3}):", 
-                        str1, ShowBytes(str1), str2, ShowBytes(str2));
-      Console.WriteLine("   With String.Compare:");
-      Console.WriteLine("      Current Culture: {0}", 
-                        String.Compare(str1, str2, StringComparison.CurrentCulture));
-      Console.WriteLine("      Invariant Culture: {0}", 
-                        String.Compare(str1, str2, StringComparison.InvariantCulture));
-
-      Console.WriteLine("   With String.Equals:");
-      Console.WriteLine("      Current Culture: {0}", 
-                        String.Equals(str1, str2, StringComparison.CurrentCulture));
-      Console.WriteLine("      Invariant Culture: {0}", 
-                        String.Equals(str1, str2, StringComparison.InvariantCulture));
-   }
-
-   private static string ShowBytes(string str)
-   {
-      string hexString = String.Empty;
-      for (int ctr = 0; ctr < str.Length; ctr++)
-      {
-         string result = String.Empty;
-         result = Convert.ToInt32(str[ctr]).ToString("X4");
-         result = " " + result.Substring(0,2) + " " + result.Substring(2, 2);
-         hexString += result;
-      }
-      return hexString.Trim();
-   }
-}
-// The example displays the following output:
-//    Comparing 'Aa' (00 41 00 61) and 'A   a' (00 41 00 00 00 00 00 00 00 61):
-//       With String.Compare:
-//          Current Culture: 0
-//          Invariant Culture: 0
-//       With String.Equals:
-//          Current Culture: True
-//          Invariant Culture: True
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      Dim str1 As String = "Aa"
-      Dim str2 As String = "A" + New String(Convert.ToChar(0), 3) + "a"
-      Console.WriteLine("Comparing '{0}' ({1}) and '{2}' ({3}):", _
-                        str1, ShowBytes(str1), str2, ShowBytes(str2))
-      Console.WriteLine("   With String.Compare:")
-      Console.WriteLine("      Current Culture: {0}", _
-                        String.Compare(str1, str2, StringComparison.CurrentCulture))
-      Console.WriteLine("      Invariant Culture: {0}", _
-                        String.Compare(str1, str2, StringComparison.InvariantCulture))
-
-      Console.WriteLine("   With String.Equals:")
-      Console.WriteLine("      Current Culture: {0}", _
-                        String.Equals(str1, str2, StringComparison.CurrentCulture))
-      Console.WriteLine("      Invariant Culture: {0}", _
-                        String.Equals(str1, str2, StringComparison.InvariantCulture))
-   End Sub
-
-   Private Function ShowBytes(str As String) As String
-      Dim hexString As String = String.Empty
-      For ctr As Integer = 0 To str.Length - 1
-         Dim result As String = String.Empty
-         result = Convert.ToInt32(str.Chars(ctr)).ToString("X4")
-         result = " " + result.Substring(0,2) + " " + result.Substring(2, 2)
-         hexString += result
-      Next
-      Return hexString.Trim()
-   End Function
-End Module
-```
-
-一方、次の例のように序数に基づく比較を使用すると、これらの文字列は等価とは見なされません。
-
-```csharp
-Console.WriteLine("Comparing '{0}' ({1}) and '{2}' ({3}):", 
-                  str1, ShowBytes(str1), str2, ShowBytes(str2));
-Console.WriteLine("   With String.Compare:");
-Console.WriteLine("      Ordinal: {0}", 
-                  String.Compare(str1, str2, StringComparison.Ordinal));
-
-Console.WriteLine("   With String.Equals:");
-Console.WriteLine("      Ordinal: {0}", 
-                  String.Equals(str1, str2, StringComparison.Ordinal));
-// The example displays the following output:
-//    Comparing 'Aa' (00 41 00 61) and 'A   a' (00 41 00 00 00 00 00 00 00 61):
-//       With String.Compare:
-//          Ordinal: 97
-//       With String.Equals:
-//          Ordinal: False
-```
-
-```vb
-Console.WriteLine("Comparing '{0}' ({1}) and '{2}' ({3}):", _
-                  str1, ShowBytes(str1), str2, ShowBytes(str2))
-Console.WriteLine("   With String.Compare:")
-Console.WriteLine("      Ordinal: {0}", _
-                  String.Compare(str1, str2, StringComparison.Ordinal))
-
-Console.WriteLine("   With String.Equals:")
-Console.WriteLine("      Ordinal: {0}", _
-                  String.Equals(str1, str2, StringComparison.Ordinal))
-' The example displays the following output:
-'    Comparing 'Aa' (00 41 00 61) and 'A   a' (00 41 00 00 00 00 00 00 00 61):
-'       With String.Compare:
-'          Ordinal: 97
-'       With String.Equals:
-'          Ordinal: False
-```
-
-序数に基づく比較の次に慎重な方法は、大文字と小文字を区別しない序数に基づく比較です。 この比較では、大文字と小文字の区別のほとんどが無視されます (たとえば、"windows" と "Windows" は一致します)。 ASCII 文字を操作する場合、このポリシーは [StringComparison.Ordinal](xref:System.StringComparison.Ordinal) と同等ですが、通常の ASCII の大文字と小文字の区別が無視されます。 したがって、[A, Z] (\u0041-\u005A) の任意の文字が [a,z] (\u0061-\007A) の対応する文字と一致します。 ASCII の範囲外の大文字と小文字の区別には、インバリアント カルチャのテーブルが使用されます。 次に例を示します。
-
-```csharp
-String.Compare(strA, strB, StringComparison.OrdinalIgnoreCase);
-```
-
-```vb
-String.Compare(strA, strB, StringComparison.OrdinalIgnoreCase)
-```
-
-この比較は、次の比較と同等です (ただし、より高速です)。 
-
-```csharp
-String.Compare(strA.ToUpperInvariant(), strB.ToUpperInvariant(), 
-               StringComparison.Ordinal);
-```
-
-```vb
-String.Compare(strA.ToUpperInvariant(), strB.ToUpperInvariant(), 
-               StringComparison.Ordinal)
-```
-
-とはいえ、これらの比較はどちらも非常に高速です。
-
-[StringComparison.Ordinal](xref:System.StringComparison.Ordinal) と [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) は、どちらもバイナリ値を直接使用するため、照合に最適です。 比較の設定について確信を持てない場合は、この 2 つのいずれかの値を使用してください。 ただし、これらの値を使用するとバイトごとの比較が行われるため、言語的な順序 (英語の辞書のような順序) ではなくバイナリの順序で並べ替えが行われます。 したがって、結果をユーザーに表示すると、ほとんどの場合不自然に見えます。
-
-序数に基づくセマンティクスは、[StringComparison](xref:System.StringComparison) 引数を含まない [String](xref:System.String) `Equals` のオーバーロード (等値演算子を含む) で既定で使用されます。 どのような場合でも、[StringComparison](xref:System.StringComparison) パラメーターを持つオーバーロードを呼び出すことをお勧めします。
-
-### <a name="string-operations-that-use-the-invariant-culture"></a>インバリアント カルチャを使用する文字列操作
-
-インバリアント カルチャを使用する比較では、静的 [CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) プロパティから返される [CompareInfo](xref:System.Globalization.CompareInfo) プロパティが使用されます。 この動作は、すべてのシステムで同じです。範囲外の文字は、等価のインバリアント文字と見なされる文字に変換されます。 このポリシーは、同じ文字列動作のセットを複数のカルチャにわたって保持する場合に便利ですが、予期しない結果になることもよくあります。
-
-インバリアント カルチャを使用する、大文字と小文字を区別しない比較でも、静的 [CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) プロパティから返される静的 [CompareInfo](xref:System.Globalization.CompareInfo) プロパティが比較情報として使用されます。 変換後の文字の大文字と小文字の違いは無視されます。
-
-[CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) オブジェクトによって、[String](xref:System.String) `Compare` メソッドで特定の文字のセットが等価と解釈されます。 たとえば、次の例が等価になるのは、インバリアント カルチャでは妥当です。
-
-InvariantCulture: a + ̊ = å
-
-latin small lette A 文字 "a" (\u0061) は、combining ring above 文字 "+ " ̊" (\u030a) の横にある場合、latin small letter A with ring above 文字 "å" (\u00e5) として解釈されます。 この動作は、次の例に示すように、序数に基づく比較とは異なります。
-
-```csharp
-string separated = "\u0061\u030a";
-string combined = "\u00e5";
-
-Console.WriteLine("Equal sort weight of {0} and {1} using InvariantCulture: {2}",
-                  separated, combined, 
-                  String.Compare(separated, combined, 
-                                 StringComparison.InvariantCulture) == 0);
-
-Console.WriteLine("Equal sort weight of {0} and {1} using Ordinal: {2}",
-                  separated, combined,
-                  String.Compare(separated, combined, 
-                                 StringComparison.Ordinal) == 0);
-// The example displays the following output:
-//    Equal sort weight of a° and å using InvariantCulture: True
-//    Equal sort weight of a° and å using Ordinal: False 
-```
-
-```vb
-Dim separated As String = ChrW(&h61) + ChrW(&h30a)
-Dim combined As String = ChrW(&he5)
-
-Console.WriteLine("Equal sort weight of {0} and {1} using InvariantCulture: {2}", _
-                  separated, combined, _
-                  String.Compare(separated, combined, _ 
-                                 StringComparison.InvariantCulture) = 0)
-
-Console.WriteLine("Equal sort weight of {0} and {1} using Ordinal: {2}", _
-                  separated, combined, _
-                  String.Compare(separated, combined, _
-                                 StringComparison.Ordinal) = 0)
-' The example displays the following output:
-'    Equal sort weight of a° and å using InvariantCulture: True
-'    Equal sort weight of a° and å using Ordinal: False
-```
-
-ファイル名やクッキーなど、"å" のような組み合わせが出現する可能性がある要素を解釈する場合にも、序数に基づく比較を使用するのが最も明確かつ適切な方法になります。
-
-結局のところ、インバリアント カルチャには、比較に使用する際に便利なプロパティがほとんどありません。 インバリアント カルチャを使用すると、言語的な意味を持つ形で比較が行われるため、記号の完全な等価性は保証されません。その一方で、特定のカルチャでの表示にも適していません。 たとえば、表示する並べ替え済みの識別子のリストを含む大きなデータ ファイルがアプリケーションに付属している場合に、そのリストにエントリを追加するには、インバリアント スタイルの並べ替えを使用する挿入が必要になります。
-
-## <a name="choosing-a-stringcomparison-member-for-your-method-call"></a>メソッド呼び出しに使用する StringComparison メンバーの選択
-
-文字列のセマンティックなコンテキストと [StringComparison](xref:System.StringComparison) 列挙型のメンバーとの対応関係の概要を次の表に示します。
-
-データ | 動作 | 対応する System.StringComparison 値
----- | -------- | -------------------------------------------
-大文字と小文字が区別される内部識別子、XML や HTTP などの標準の、大文字と小文字が区別される識別子、または大文字と小文字が区別されるセキュリティ関連の設定。 | バイトが正確に一致する非言語的識別子。 | [StringComparison.Ordinal](xref:System.StringComparison.Ordinal)
-大文字と小文字が区別されない内部識別子、XML や HTTP などの標準の、大文字と小文字が区別される識別子、ファイル パス、レジストリ キーと値、環境変数、リソース識別子 (ハンドル名など)、または大文字と小文字が区別されないセキュリティ関連の設定。 | 大文字と小文字の区別に関係ない非言語的識別子。 | [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase)
-ユーザーに表示されるデータまたはほとんどのユーザーの入力。 | 特定の言語の規則を必要とするデータ。 | [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture) または [CurrentCultureIgnoreCase](xref:System.StringComparison.CurrentCultureIgnoreCase)
-
-## <a name="common-string-comparison-methods"></a>一般的な文字列比較メソッド
-
-以降では、文字列比較でよく使用されるメソッドについて説明します。
-
-### <a name="stringcompare"></a>String.Compare
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-このメソッドは文字列解釈の中心的な操作となるため、メソッド呼び出しのすべてのインスタンスを調べて、文字列を現在のカルチャに従って解釈するべきか、カルチャから切り離して (記号として) 扱うべきかどうかを確認する必要があります。 ほとんどは後者であるため、その場合は代わりに [StringComparison.Ordinal](xref:System.StringComparison.Ordinal) の比較を使用します。
-
-[CultureInfo.CompareInfo](xref:System.Globalization.CultureInfo.CompareInfo) プロパティから返される [System.Globalization.CompareInfo](xref:System.Globalization.CompareInfo) クラスにも、[CompareOptions](xref:System.Globalization.CompareOptions) フラグ列挙体でさまざまな照合方法 (序数に基づく、空白文字を無視する、カナ型を無視するなど) を指定できる [Compare](xref:System.Globalization.CompareInfo.Compare(System.String,System.Int32,System.String,System.Int32,System.Globalization.CompareOptions)) メソッドが含まれています。 
-
-### <a name="stringcompareto"></a>String.CompareTo
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-このメソッドには、現時点では、[StringComparison](xref:System.StringComparison) 型を指定するオーバーロードはありません。 通常は、このメソッドを推奨される [String.Compare(String, String, StringComparison)](xref:System.String.Compare(System.String,System.String,System.StringComparison)) の形式に変換できます。
-
-このメソッドは、[IComparable](xref:System.IComparable) インターフェイスと [IComparable&lt;T&gt;](xref:System.IComparable%601) インターフェイスを実装する型に実装されます。 このメソッドには[StringComparison](xref:System.StringComparison) パラメーターのオプションがないため、実装する型のコンストラクターで [StringComparer](xref:System.StringComparer) を指定できるようにするのが一般的です。 次の例では、クラス コンストラクターに [StringComparer](xref:System.StringComparer) パラメーターを含む `FileName` クラスを定義しています。 この [StringComparer](xref:System.StringComparer) オブジェクトは、その後、`FileName.CompareTo` メソッドで使用されています。
-
-```csharp
-using System;
-
-public class FileName : IComparable
-{
-   string fname;
-   StringComparer comparer; 
-
-   public FileName(string name, StringComparer comparer)
-   {
-      if (String.IsNullOrEmpty(name))
-         throw new ArgumentNullException("name");
-
-      this.fname = name;
-
-      if (comparer != null)
-         this.comparer = comparer;
-      else
-         this.comparer = StringComparer.OrdinalIgnoreCase;
-   }
-
-   public string Name
-   {
-      get { return fname; }
-   }
-
-   public int CompareTo(object obj)
-   {
-      if (obj == null) return 1;
-
-      if (! (obj is FileName))
-         return comparer.Compare(this.fname, obj.ToString());
-      else
-         return comparer.Compare(this.fname, ((FileName) obj).Name);
-   }
-}
-```
-
-```vb
-Public Class FileName : Implements IComparable
-   Dim fname As String
-   Dim comparer As StringComparer 
-
-   Public Sub New(name As String, comparer As StringComparer)
-      If String.IsNullOrEmpty(name) Then
-         Throw New ArgumentNullException("name")
-      End If
-
-      Me.fname = name
-
-      If comparer IsNot Nothing Then
-         Me.comparer = comparer
-      Else
-         Me.comparer = StringComparer.OrdinalIgnoreCase
-      End If      
-   End Sub
-
-   Public ReadOnly Property Name As String
-      Get
-         Return fname
-      End Get   
-   End Property
-
-   Public Function CompareTo(obj As Object) As Integer _
-          Implements IComparable.CompareTo
-      If obj Is Nothing Then Return 1
-
-      If Not TypeOf obj Is FileName Then
-         obj = obj.ToString()
-      Else
-         obj = CType(obj, FileName).Name
-      End If         
-      Return comparer.Compare(Me.fname, obj)
-   End Function
-End Class
-```
-
-### <a name="stringequals"></a>String.Equals
-
-既定の解釈: [StringComparison.Ordinal](xref:System.StringComparison.Ordinal)。
-
-[String](xref:System.String) クラスで等価性テストを実行するには、`Equals` メソッド (静的メソッドまたはインスタンス メソッド) のオーバーロードを呼び出すか、静的等値演算子を使用します。 これらのオーバーロードと演算子では、序数に基づく比較が既定で使用されますが、 序数に基づく比較を実行する場合でも、[StringComparison](xref:System.StringComparison) 型を明示的に指定するオーバーロードを呼び出すことをお勧めします。これにより、特定の文字列解釈のコードを検索しやすくなります。 
-
-### <a name="stringtoupper-and-stringtolower"></a>String.ToUpper と String.ToLower
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-これらのメソッドを使用するときには注意が必要です。というのも、文字列を大文字や小文字に強制的に変換する操作は、文字列を大文字と小文字の区別に関係なく比較するための小規模の正規化としてよく使用されるからです。 その場合は、大文字と小文字を区別しない比較を使用することを検討してください。 
-
-[String.ToUpperInvariant](xref:System.String.ToUpperInvariant) メソッドと [String.ToLowerInvariant](xref:System.String.ToLowerInvariant) メソッドも使用できます。 [ToUpperInvariant](xref:System.String.ToUpperInvariant) は、大文字と小文字を正規化するための標準的な方法です。 [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) を使用して行われる比較は、動作の内容を見ると、両方の文字列引数に対して [ToUpperInvariant](xref:System.String.ToUpperInvariant) を呼び出し、[StringComparison.Ordinal](xref:System.StringComparison.Ordinal) を使用して比較を行うという、2 つの呼び出しの組み合わせです。
-
-特定のカルチャを表す [CultureInfo](xref:System.Globalization.CultureInfo) オブジェクトを渡してそのカルチャで大文字および小文字への変換を行うためのオーバーロードもあります。
-
-### <a name="chartoupper-and-chartolower"></a>Char.ToUpper と Char.ToLower
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-これらのメソッドの動作は、上で説明した [String.ToUpper](xref:System.String.ToUpper) メソッドおよび [String.ToLower](xref:System.String.ToLower) メソッドと同様です。
-
-### <a name="stringstartswith-and-stringendswith"></a>String.StartsWith と String.EndsWith
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-これらのメソッドは、いずれもカルチャに依存した比較を既定で実行します。
-
-### <a name="stringindexof-and-stringlastindexof"></a>String.IndexOf と String.LastIndexOf
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-これらのメソッドの既定のオーバーロードは、比較の実行方法が一貫していません。 [Char](xref:System.Char) パラメーターを含むすべての [String](xref:System.String) `IndexOf` メソッドと [String](xref:System.String) `LastIndexOf` メソッドは、序数に基づく比較を実行します。一方、[String](xref:System.String) パラメーターを含む既定の [String](xref:System.String) `IndexOf` メソッドと [String`](xref:System.String) `LastIndexOf` メソッドは、カルチャに依存した比較を実行します。 
-
-` `IndexOf` or `LastIndexOf` メソッドを呼び出して、現在のインスタンスで検索する文字列を渡す場合は、[StringComparison](xref:System.StringComparison) 型を明示的に指定するオーバーロードを呼び出すことをお勧めします。 [Char](xref:System.Char) 引数を含むオーバーロードでは、[StringComparison](xref:System.StringComparison) 型を指定することはできません。
-
-## <a name="methods-that-perform-string-comparison-indirectly"></a>間接的に文字列比較を実行するメソッド
-
-文字列比較を中心的な操作とする非文字列メソッドの中には、[StringComparer](xref:System.StringComparer) 型を使用するものがあります。 [StringComparer](xref:System.StringComparer) クラスには、[StringComparer](xref:System.StringComparer) のインスタンスを返す静的プロパティが 4 つ含まれています。これらのインスタンスの `Compare` メソッドは、次の種類の文字列比較を実行します。
-
-* 現在のカルチャを使用する、カルチャに依存した文字列比較。 この [StringComparer](xref:System.StringComparer) オブジェクトは、[StringComparer.CurrentCulture](xref:System.StringComparer.CurrentCulture) プロパティによって返されます。
-
-* 現在のカルチャを使用する、大文字と小文字を区別しない比較。 この [StringComparer](xref:System.StringComparer) オブジェクトは、[StringComparer.CurrentCultureIgnoreCase](xref:System.StringComparer.CurrentCultureIgnoreCase) プロパティによって返されます。
-
-* 序数に基づく比較。 この [StringComparer](xref:System.StringComparer) オブジェクトは、[StringComparer.Ordinal](xref:System.StringComparer.Ordinal) プロパティによって返されます。 
-
-* 大文字と小文字を区別しない、序数に基づく比較。 この [StringComparer](xref:System.StringComparer) オブジェクトは、[StringComparer.OrdinalIgnoreCase](xref:System.StringComparer.OrdinalIgnoreCase) プロパティによって返されます。
-
-### <a name="arraysort-and-arraybinarysearch"></a>Array.Sort と Array.BinarySearch
-
-既定の解釈: [StringComparison.CurrentCulture](xref:System.StringComparison.CurrentCulture)。
-
-データをコレクションに格納したり、永続化されたデータをファイルやデータベースからコレクションに読み取ったりするときに現在のカルチャを切り替えると、コレクション内のインバリアントが無効になる可能性があります。 [Array.BinarySearch](xref:System.Array.BinarySearch(System.Array,System.Object)) メソッドでは、配列内で検索する要素が既に並べ替えられていると見なされます。 [Array.Sort](xref:System.Array.Sort(System.Array)) メソッドは、配列内の文字列要素を並べ替えるために、[String] `Compare` メソッドを呼び出して個々の要素を順序付けます。 配列の並べ替えが行われてから内容の検索が行われるまでの間にカルチャが変更される場合、カルチャに依存した比較子を使用するのは危険です。 たとえば、次のコードでは、`Thread.CurrentThread.CurrentCulture` プロパティによって暗黙的に提供される比較子で格納と取得の操作が行われています。 `StoreNames` の呼び出しと `DoesNameExist` の呼び出しの間にカルチャが変更されると (この 2 つのメソッドの呼び出しの間に配列の内容が永続化された場合には特に)、バイナリ サーチが失敗する可能性があります。 
-
-```csharp
-// Incorrect.
-string []storedNames;
-
-public void StoreNames(string [] names)
-{
-   int index = 0;
-   storedNames = new string[names.Length];
-
-   foreach (string name in names)
-   {
-      this.storedNames[index++] = name;
-   }
-
-   Array.Sort(names); // Line A.
-}
-
-public bool DoesNameExist(string name)
-{
-   return (Array.BinarySearch(this.storedNames, name) >= 0);  // Line B.
-}
-```
-
-```vb
-' Incorrect.
-Dim storedNames() As String
-
-Public Sub StoreNames(names() As String)
-   Dim index As Integer = 0
-   ReDim storedNames(names.Length - 1)
-
-   For Each name As String In names
-      Me.storedNames(index) = name
-      index+= 1
-   Next
-
-   Array.Sort(names)          ' Line A.
-End Sub
-
-Public Function DoesNameExist(name As String) As Boolean
-   Return Array.BinarySearch(Me.storedNames, name) >= 0      ' Line B.
-End Function
-```
-
-次の例は、推奨されるバリエーションを示しています。ここでは、配列の並べ替えと検索の両方に、同じ序数に基づく (カルチャに依存しない) 比較メソッドが使用されています。 コードの変更は、2 つの例の `Line A` および `Line B` というラベルが付いた行に反映されています。
-
-```csharp
-// Correct.
-string []storedNames;
-
-public void StoreNames(string [] names)
-{
-   int index = 0;
-   storedNames = new string[names.Length];
-
-   foreach (string name in names)
-   {
-      this.storedNames[index++] = name;
-   }
-
-   Array.Sort(names, StringComparer.Ordinal);  // Line A.
-}
-
-public bool DoesNameExist(string name)
-{
-   return (Array.BinarySearch(this.storedNames, name, StringComparer.Ordinal) >= 0);  // Line B.
-}
-```
-
-```vb
-' Correct.
-Dim storedNames() As String
-
-Public Sub StoreNames(names() As String)
-   Dim index As Integer = 0
-   ReDim storedNames(names.Length - 1)
-
-   For Each name As String In names
-      Me.storedNames(index) = name
-      index+= 1
-   Next
-
-   Array.Sort(names, StringComparer.Ordinal)           ' Line A.
-End Sub
-
-Public Function DoesNameExist(name As String) As Boolean
-   Return Array.BinarySearch(Me.storedNames, name, StringComparer.Ordinal) >= 0      ' Line B.
-End Function
-```
-
-このデータを永続化して別のカルチャのシステムに移動したり、データをユーザーに表示するために並べ替えたりする場合は、`StringComparison.InvariantCulture` を使用することを検討してください。そうすると、ユーザー出力のために言語的な操作を行っても、カルチャの変更による影響を受けることはありません。 次の例では、前の 2 つの例を変更して、配列の並べ替えと検索にインバリアント カルチャを使用しています。
-
-```csharp
-// Correct.
-string []storedNames;
-
-public void StoreNames(string [] names)
-{
-   int index = 0;
-   storedNames = new string[names.Length];
-
-   foreach (string name in names)
-   {
-      this.storedNames[index++] = name;
-   }
-
-   Array.Sort(names, StringComparer.InvariantCulture);  // Line A.
-}
-
-public bool DoesNameExist(string name)
-{
-   return (Array.BinarySearch(this.storedNames, name, StringComparer.InvariantCulture) >= 0);  // Line B.
-}
-```
-
-```vb
-' Correct.
-Dim storedNames() As String
-
-Public Sub StoreNames(names() As String)
-   Dim index As Integer = 0
-   ReDim storedNames(names.Length - 1)
-
-   For Each name As String In names
-      Me.storedNames(index) = name
-      index+= 1
-   Next
-
-   Array.Sort(names, StringComparer.InvariantCulture)           ' Line A.
-End Sub
-
-Public Function DoesNameExist(name As String) As Boolean
-   Return Array.BinarySearch(Me.storedNames, name, StringComparer.InvariantCulture) >= 0      ' Line B.
-End Function
-```
-
-### <a name="collections-example-hashtable-constructor"></a>コレクションの例: Hashtable のコンストラクター
-
-文字列のハッシュも、文字列の比較方法の影響を受ける操作の 1 つです。 
-
-次の例では、[StringComparer.OrdinalIgnoreCase](xref:System.StringComparer.OrdinalIgnoreCase) プロパティによって返される [StringComparer](xref:System.StringComparer) オブジェクトを渡すことによって [Hashtable](xref:System.Collections.Hashtable) オブジェクトをインスタンス化します。 [StringComparer](xref:System.StringComparer) から派生するクラス [StringComparer](xref:System.StringComparer)は [IEqualityComparer](xref:System.Collections.IEqualityComparer) インターフェイスを実装するため、その [GetHashCode](xref:System.Collections.IEqualityComparer) メソッドを使用して、ハッシュ テーブルの文字列のハッシュ コードを計算しています。
-
-```csharp
-const int initialTableCapacity = 100;
-Hashtable h;
-
-public void PopulateFileTable(string directory)
-{
-   h = new Hashtable(initialTableCapacity, 
-                     StringComparer.OrdinalIgnoreCase);
-
-   foreach (string file in Directory.GetFiles(directory))
-         h.Add(file, File.GetCreationTime(file));
-}
-
-public void PrintCreationTime(string targetFile)
-{
-   Object dt = h[targetFile];
-   if (dt != null)
-   {
-      Console.WriteLine("File {0} was created at time {1}.",
-         targetFile, 
-         (DateTime) dt);
-   }
-   else
-   {
-      Console.WriteLine("File {0} does not exist.", targetFile);
-   }
-}
-```
-
-```vb
-Const initialTableCapacity As Integer = 100
-Dim h As Hashtable
-
-Public Sub PopulateFileTable(dir As String)
-   h = New Hashtable(initialTableCapacity, _
-                     StringComparer.OrdinalIgnoreCase)
-
-   For Each filename As String In Directory.GetFiles(dir)
-      h.Add(filename, File.GetCreationTime(filename))
-   Next                        
-End Sub
-
-Public Sub PrintCreationTime(targetFile As String)
-   Dim dt As Object = h(targetFile)
-   If dt IsNot Nothing Then
-      Console.WriteLine("File {0} was created at {1}.", _
-         targetFile, _
-         CDate(dt))
-   Else
-      Console.WriteLine("File {0} does not exist.", targetFile)
-   End If
-End Sub  
-```
-
-## <a name="displaying-and-persisting-formatted-data"></a>書式設定されたデータを表示および保持する
-
-数値、日時など、文字列以外のデータをユーザーに表示するには、ユーザーのカルチャ設定を使用して書式設定します。 既定では、数値型と日時型の [String.Format](xref:System.String.Format(System.IFormatProvider,System.String,System.Object)) メソッドと `ToString` メソッドは、書式設定の操作に現在のスレッド カルチャを使用します。 書式設定メソッドで現在のカルチャを使用することを明示的に指定するには、provider パラメーターを含む書式設定メソッド ([String.Format(IFormatProvider, String, Object[])](xref:System.String.Format(System.IFormatProvider,System.String,System.Object))、[DateTime.ToString(IFormatProvider)](xref:System.DateTime.ToString(System.IFormatProvider)) など) のオーバーロードを呼び出して、そのパラメーターを [CultureInfo.CurrentCulture](xref:System.Globalization.CultureInfo.CurrentCulture) プロパティに渡します。 
-
-文字列以外のデータは、バイナリ データまたは書式付きデータとして保持できます。 書式付きデータとして保存するには、*provider* パラメーターを含む書式指定メソッドのオーバーロードを呼び出し、そのパラメーターを [CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) プロパティに渡す必要があります。 インバリアント カルチャは、カルチャとコンピューターに依存しない書式付きデータに一貫した書式を提供します。 これに対し、インバリアント カルチャ以外のカルチャを使用して書式設定するデータの保持には、さまざまな制限があります。 
-
-* カルチャが異なるシステムでデータを取得したり、現在のシステムのユーザーが現在のカルチャを変更してデータを取得しようとしたりすると、そのデータは使用できない可能性があります。 
-
-* 特定のコンピューターのカルチャのプロパティは、その標準の値とは異なる場合があります。 常に、ユーザーはカルチャに依存した表示設定をカスタマイズする可能性があります。 このため、ユーザーがカルチャの設定をカスタマイズすると、システムに保存されている書式付きデータが読み取ることができなくなる場合があります。 コンピューター間の書式付きデータの移植性がさらに制限される可能性があります。 
-
-* 数値や日時の書式設定を制御する国際的、地域的、または国内の標準は時間と共に変化するため、これらの変化はオペレーティング システムの更新プログラムに組み込まれています。 書式設定の規則が変わると、以前の規則に従って書式設定されたデータが読み取ることができなくなる場合があります。 
-
-次に、カルチャに依存する書式設定を使用してデータを保持すると移植性が制限される例を示します。 この例では、日時の値の配列をファイルに保存します。 これらは、英語 (米国) のカルチャの規則を使用して書式設定されています。 現在のスレッド カルチャがフランス語 (スイス) に変更されると、アプリケーションは現在のカルチャの書式設定規則を使用して保存された値を読み取ることを試みます。 2 つのデータ項目の読み取りを試みると、[FormatException](xref:System.FormatException) 例外がスローされます。日付の配列には、[MinValue](xref:System.DateTime.MinValue) に等しい 2 つの間違った要素が含まれることになります。 
-
-```csharp
-using System;
-using System.Globalization;
-using System.IO;
-using System.Text;
-using System.Threading;
-
-public class Example
-{
-   private static string filename = @".\dates.dat";
-
-   public static void Main()
-   {
-      DateTime[] dates = { new DateTime(1758, 5, 6, 21, 26, 0), 
-                           new DateTime(1818, 5, 5, 7, 19, 0), 
-                           new DateTime(1870, 4, 22, 23, 54, 0),  
-                           new DateTime(1890, 9, 8, 6, 47, 0), 
-                           new DateTime(1905, 2, 18, 15, 12, 0) }; 
-      // Write the data to a file using the current culture.
-      WriteData(dates);
-      // Change the current culture.
-      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-CH");
-      // Read the data using the current culture.
-      DateTime[] newDates = ReadData();
-      foreach (var newDate in newDates)
-         Console.WriteLine(newDate.ToString("g"));
-   }
-
-   private static void WriteData(DateTime[] dates) 
-   {
-      StreamWriter sw = new StreamWriter(filename, false, Encoding.UTF8);    
-      for (int ctr = 0; ctr < dates.Length; ctr++) {
-         sw.Write("{0}", dates[ctr].ToString("g", CultureInfo.CurrentCulture));
-         if (ctr < dates.Length - 1) sw.Write("|");   
-      }      
-      sw.Close();
-   }
-
-   private static DateTime[] ReadData() 
-   {
-      bool exceptionOccurred = false;
-
-      // Read file contents as a single string, then split it.
-      StreamReader sr = new StreamReader(filename, Encoding.UTF8);
-      string output = sr.ReadToEnd();
-      sr.Close();   
-
-      string[] values = output.Split( new char[] { '|' } );
-      DateTime[] newDates = new DateTime[values.Length]; 
-      for (int ctr = 0; ctr < values.Length; ctr++) {
-         try {
-            newDates[ctr] = DateTime.Parse(values[ctr], CultureInfo.CurrentCulture);
-         }
-         catch (FormatException) {
-            Console.WriteLine("Failed to parse {0}", values[ctr]);
-            exceptionOccurred = true;
-         }
-      }      
-      if (exceptionOccurred) Console.WriteLine();
-      return newDates;
-   }
-}
-// The example displays the following output:
-//       Failed to parse 4/22/1870 11:54 PM
-//       Failed to parse 2/18/1905 3:12 PM
-//       
-//       05.06.1758 21:26
-//       05.05.1818 07:19
-//       01.01.0001 00:00
-//       09.08.1890 06:47
-//       01.01.0001 00:00
-//       01.01.0001 00:00
-```
-
-```vb
-Imports System.Globalization
-Imports System.IO
-Imports System.Text
-Imports System.Threading
-
-Module Example
-   Private filename As String = ".\dates.dat"
-
-   Public Sub Main()
-      Dim dates() As Date = { #5/6/1758 9:26PM#, #5/5/1818 7:19AM#, _ 
-                              #4/22/1870 11:54PM#, #9/8/1890 6:47AM#, _ 
-                              #2/18/1905 3:12PM# }
-      ' Write the data to a file using the current culture.
-      WriteData(dates)
-      ' Change the current culture.
-      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("fr-CH")
-      ' Read the data using the current culture.
-      Dim newDates() As Date = ReadData()
-      For Each newDate In newDates
-         Console.WriteLine(newDate.ToString("g"))
-      Next
-   End Sub
-
-   Private Sub WriteData(dates() As Date)
-      Dim sw As New StreamWriter(filename, False, Encoding.Utf8)    
-      For ctr As Integer = 0 To dates.Length - 1
-         sw.Write("{0}", dates(ctr).ToString("g", CultureInfo.CurrentCulture))
-         If ctr < dates.Length - 1 Then sw.Write("|")   
-      Next      
-      sw.Close()
-   End Sub
-
-   Private Function ReadData() As Date()
-      Dim exceptionOccurred As Boolean = False
-
-      ' Read file contents as a single string, then split it.
-      Dim sr As New StreamReader(filename, Encoding.Utf8)
-      Dim output As String = sr.ReadToEnd()
-      sr.Close()   
-
-      Dim values() As String = output.Split( {"|"c } )
-      Dim newDates(values.Length - 1) As Date 
-      For ctr As Integer = 0 To values.Length - 1
-         Try
-            newDates(ctr) = DateTime.Parse(values(ctr), CultureInfo.CurrentCulture)
-         Catch e As FormatException
-            Console.WriteLine("Failed to parse {0}", values(ctr))
-            exceptionOccurred = True
-         End Try
-      Next      
-      If exceptionOccurred Then Console.WriteLine()
-      Return newDates
-   End Function
-End Module
-' The example displays the following output:
-'       Failed to parse 4/22/1870 11:54 PM
-'       Failed to parse 2/18/1905 3:12 PM
-'       
-'       05.06.1758 21:26
-'       05.05.1818 07:19
-'       01.01.0001 00:00
-'       09.08.1890 06:47
-'       01.01.0001 00:00
-'       01.01.0001 00:00
-'
-```
-
-ただし、[DateTime.ToString(String, IFormatProvider)](xref:System.DateTime.ToString(System.String,System.IFormatProvider)) 呼び出しと [DateTime.Parse(String, IFormatProvider)](xref:System.DateTime.Parse(System.String,System.IFormatProvider)) 呼び出しで [CultureInfo.CurrentCulture](xref:System.Globalization.CultureInfo.CurrentCulture) プロパティを [CultureInfo.InvariantCulture](xref:System.Globalization.CultureInfo.InvariantCulture) に置き換えると、保持されている日時データは正常に復元されます。次にその出力を示します。
-
-```
-// 06.05.1758 21:26
-// 05.05.1818 07:19
-// 22.04.1870 23:54
-// 08.09.1890 06:47
-// 18.02.1905 15:12
-```
-
-## <a name="see-also"></a>関連項目
-
-[文字列の操作](manipulating-strings.md)
-
-
-
-<!--HONumber=Nov16_HO1-->
-
-
+>  埋め込まれた null 文字は、文字列比較メソッドでは無視されますが、文字列検索メソッド \(<xref:System.String.Contains%2A?displayProperty=fullName>、<xref:System.String.EndsWith%2A?displayProperty=fullName>、<xref:System.String.IndexOf%2A?displayProperty=fullName>、<xref:System.String.LastIndexOf%2A?displayProperty=fullName>、<xref:System.String.StartsWith%2A?displayProperty=fullName> など\) では無視されません。  
+  
+ 次の例では、文字列 "Aa" と、"A" と "a" の間にいくつかの null 文字が埋め込まれた類似の文字列とのカルチャに依存した比較を実行して、2 つの文字列が等価と見なされることを示しています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/embeddednulls1.cs#19)]
+ [!code-vb[Conceptual.Strings.BestPractices#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/embeddednulls1.vb#19)]  
+  
+ 一方、次の例のように序数に基づく比較を使用すると、これらの文字列は等価とは見なされません。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/embeddednulls2.cs#20)]
+ [!code-vb[Conceptual.Strings.BestPractices#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/embeddednulls2.vb#20)]  
+  
+ 序数に基づく比較の次に慎重な方法は、大文字と小文字を区別しない序数に基づく比較です。 この比較では、大文字と小文字の区別のほとんどが無視されます \(たとえば、"windows" と "Windows" は一致します\)。 ASCII 文字を操作する場合、このポリシーは <xref:System.StringComparison?displayProperty=fullName> と同等ですが、通常の ASCII の大文字と小文字の区別が無視されます。 したがって、\[A, Z\] \(\\u0041\-\\u005A\) の任意の文字が \[a,z\] \(\\u0061\-\\007A\) の対応する文字と一致します。 ASCII の範囲外の大文字と小文字の区別には、インバリアント カルチャのテーブルが使用されます。 次に例を示します。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/comparison2.cs#4)]
+ [!code-vb[Conceptual.Strings.BestPractices#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/comparison2.vb#4)]  
+  
+ この比較は、次の比較と同等です \(ただし、より高速です\)。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/comparison2.cs#5)]
+ [!code-vb[Conceptual.Strings.BestPractices#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/comparison2.vb#5)]  
+  
+ とはいえ、これらの比較はどちらも非常に高速です。  
+  
+> [!NOTE]
+>  ファイル システム、レジストリのキーと値、および環境変数の文字列の動作は、<xref:System.StringComparison?displayProperty=fullName> によって最もよく表現されます。  
+  
+ <xref:System.StringComparison?displayProperty=fullName> と <xref:System.StringComparison?displayProperty=fullName> は、どちらもバイナリ値を直接使用するため、照合に最適です。 比較の設定について確信を持てない場合は、この 2 つのいずれかの値を使用してください。 ただし、これらの値を使用するとバイトごとの比較が行われるため、言語的な順序 \(英語の辞書のような順序\) ではなくバイナリの順序で並べ替えが行われます。 したがって、結果をユーザーに表示すると、ほとんどの場合不自然に見えます。  
+  
+ 序数に基づくセマンティクスは、<xref:System.String.Equals%2A?displayProperty=fullName> 引数を含まない <xref:System.StringComparison> のオーバーロード \(等値演算子を含む\) で既定で使用されます。 どのような場合でも、<xref:System.StringComparison> パラメーターを持つオーバーロードを呼び出すことをお勧めします。  
+  
+### インバリアント カルチャを使用する文字列操作  
+ インバリアント カルチャを使用する比較では、静的 <xref:System.Globalization.CultureInfo.CompareInfo%2A> プロパティから返される <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティが使用されます。 この動作は、すべてのシステムで同じです。範囲外の文字は、等価のインバリアント文字と見なされる文字に変換されます。 このポリシーは、同じ文字列動作のセットを複数のカルチャにわたって保持する場合に便利ですが、予期しない結果になることもよくあります。  
+  
+ インバリアント カルチャを使用する、大文字と小文字を区別しない比較でも、静的 <xref:System.Globalization.CultureInfo.CompareInfo%2A> プロパティから返される静的 <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティが比較情報として使用されます。 変換後の文字の大文字と小文字の違いは無視されます。  
+  
+ <xref:System.StringComparison?displayProperty=fullName> を使用する比較と <xref:System.StringComparison?displayProperty=fullName> を使用する比較は、ASCII 文字列に対して同じように動作します。 ただし、<xref:System.StringComparison?displayProperty=fullName> では言語的な判断が下されるため、バイト セットとして解釈する必要がある文字列に対しては不適切になることがあります。`CultureInfo.InvariantCulture.CompareInfo` オブジェクトによって、<xref:System.String.Compare%2A> メソッドで特定の文字のセットが等価と解釈されます。 たとえば、次の例が等価になるのは、インバリアント カルチャでは妥当です。  
+  
+ InvariantCulture: a \+ ̊ \= å  
+  
+ LATIN SMALL LETTER A 文字 "a" \(\\u0061\) は、COMBINING RING ABOVE 文字 "\+ " ̊" \(\\u030a\) の横にある場合、LATIN SMALL LETTER A WITH RING ABOVE 文字 "å" \(\\u00e5\) として解釈されます。 この動作は、次の例に示すように、序数に基づく比較とは異なります。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/comparison3.cs#15)]
+ [!code-vb[Conceptual.Strings.BestPractices#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/comparison3.vb#15)]  
+  
+ ファイル名やクッキーなど、"å" のような組み合わせが出現する可能性がある要素を解釈する場合にも、序数に基づく比較を使用するのが最も明確かつ適切な方法になります。  
+  
+ 結局のところ、インバリアント カルチャには、比較に使用する際に便利なプロパティがほとんどありません。 インバリアント カルチャを使用すると、言語的な意味を持つ形で比較が行われるため、記号の完全な等価性は保証されません。その一方で、特定のカルチャでの表示にも適していません。<xref:System.StringComparison?displayProperty=fullName> を比較に使用する数少ない理由の 1 つは、順序付けされたデータを複数のカルチャで同じように表示するために永続化できることです。 たとえば、表示する並べ替え済みの識別子のリストを含む大きなデータ ファイルがアプリケーションに付属している場合に、そのリストにエントリを追加するには、インバリアント スタイルの並べ替えを使用する挿入が必要になります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="choosing_a_stringcomparison_member_for_your_method_call"></a>   
+## メソッド呼び出しに使用する StringComparison メンバーの選択  
+ 文字列のセマンティックなコンテキストと <xref:System.StringComparison> 列挙型のメンバーとの対応関係の概要を次の表に示します。  
+  
+|データ|動作|対応する System.StringComparison<br /><br /> 値|  
+|---------|--------|----------------------------------------|  
+|大文字と小文字が区別される内部識別子。<br /><br /> XML や HTTP などの標準の、大文字と小文字が区別される識別子。<br /><br /> 大文字と小文字が区別されるセキュリティ関連の設定。|バイトが正確に一致する非言語的識別子。|<xref:System.StringComparison>|  
+|大文字と小文字が区別されない内部識別子。<br /><br /> XML や HTTP などの標準の、大文字と小文字が区別されない識別子。<br /><br /> ファイル パス。<br /><br /> レジストリのキーと値。<br /><br /> 環境変数。<br /><br /> リソース識別子 \(ハンドル名など\)。<br /><br /> 大文字と小文字が区別されないセキュリティ関連の設定。|大文字と小文字が区別されない、言語的な意味を持たない識別子 \(ほとんどの Windows システム サービスで格納されるデータなど\)。|<xref:System.StringComparison>|  
+|永続化される、言語的な意味を持つデータの一部。<br /><br /> 一定の並べ替え順序を必要とする言語的なデータの表示。|カルチャに依存しないが、言語的な意味を持つデータ。|<xref:System.StringComparison><br /><br /> または<br /><br /> <xref:System.StringComparison>|  
+|ユーザーに表示されるデータ。<br /><br /> ほとんどのユーザー入力。|特定の言語の規則を必要とするデータ。|<xref:System.StringComparison><br /><br /> または<br /><br /> <xref:System.StringComparison>|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="common_string_comparison_methods_in_the_net_framework"></a>   
+## .NET Framework の一般的な文字列比較メソッド  
+ 以降では、文字列比較でよく使用されるメソッドについて説明します。  
+  
+### String.Compare  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ このメソッドは文字列解釈の中心的な操作となるため、メソッド呼び出しのすべてのインスタンスを調べて、文字列を現在のカルチャに従って解釈するべきか、カルチャから切り離して \(記号として\) 扱うべきかどうかを確認する必要があります。 ほとんどは後者であるため、その場合は代わりに <xref:System.StringComparison?displayProperty=fullName> の比較を使用します。  
+  
+ <xref:System.Globalization.CompareInfo?displayProperty=fullName> プロパティから返される <xref:System.Globalization.CultureInfo.CompareInfo%2A?displayProperty=fullName> クラスにも、<xref:System.Globalization.CompareInfo.Compare%2A> フラグ列挙体でさまざまな照合方法 \(序数に基づく、空白文字を無視する、カナ型を無視するなど\) を指定できる <xref:System.Globalization.CompareOptions> メソッドが含まれています。  
+  
+### String.CompareTo  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ このメソッドには、現時点では、<xref:System.StringComparison> 型を指定するオーバーロードはありません。 通常は、このメソッドを推奨される <xref:System.String.Compare%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> の形式に変換できます。  
+  
+ このメソッドは、<xref:System.IComparable> インターフェイスと <xref:System.IComparable%601> インターフェイスを実装する型に実装されます。 このメソッドには <xref:System.StringComparison> パラメーターのオプションがないため、実装する型のコンストラクターで <xref:System.StringComparer> を指定できるようにするのが一般的です。 次の例では、クラス コンストラクターに `FileName` パラメーターを含む <xref:System.StringComparer> クラスを定義しています。 この <xref:System.StringComparer> オブジェクトは、その後、`FileName.CompareTo` メソッドで使用されています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/api1.cs#6)]
+ [!code-vb[Conceptual.Strings.BestPractices#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/api1.vb#6)]  
+  
+### String.Equals  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ <xref:System.String> クラスで等価性テストを実行するには、<xref:System.String.Equals%2A> メソッド \(静的メソッドまたはインスタンス メソッド\) のオーバーロードを呼び出すか、静的等値演算子を使用します。 これらのオーバーロードと演算子では、序数に基づく比較が既定で使用されますが、 序数に基づく比較を実行する場合でも、<xref:System.StringComparison> 型を明示的に指定するオーバーロードを呼び出すことをお勧めします。これにより、特定の文字列解釈のコードを検索しやすくなります。  
+  
+### String.ToUpper と String.ToLower  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ これらのメソッドを使用するときには注意が必要です。というのも、文字列を大文字や小文字に強制的に変換する操作は、文字列を大文字と小文字の区別に関係なく比較するための小規模の正規化としてよく使用されるからです。 その場合は、大文字と小文字を区別しない比較を使用することを検討してください。  
+  
+ <xref:System.String.ToUpperInvariant%2A?displayProperty=fullName> メソッドと <xref:System.String.ToLowerInvariant%2A?displayProperty=fullName> メソッドを使用することもできます。<xref:System.String.ToUpperInvariant%2A> は、大文字と小文字を正規化するための標準的な方法です。<xref:System.StringComparison?displayProperty=fullName> を使用して行われる比較は、動作の内容を見ると、両方の文字列引数に対して <xref:System.String.ToUpperInvariant%2A> を呼び出し、<xref:System.StringComparison?displayProperty=fullName> を使用して比較を行うという、2 つの呼び出しの組み合わせです。  
+  
+ 特定のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトを渡してそのカルチャで大文字および小文字への変換を行うためのオーバーロードもあります。  
+  
+### Char.ToUpper と Char.ToLower  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ これらのメソッドの動作は、上で説明した <xref:System.String.ToUpper%2A?displayProperty=fullName> メソッドおよび <xref:System.String.ToLower%2A?displayProperty=fullName> メソッドと同様です。  
+  
+### String.StartsWith と String.EndsWith  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ これらのメソッドは、いずれもカルチャに依存した比較を既定で実行します。  
+  
+### String.IndexOf と String.LastIndexOf  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ これらのメソッドの既定のオーバーロードは、比較の実行方法が一貫していません。<xref:System.String.IndexOf%2A?displayProperty=fullName> パラメーターを含むすべての <xref:System.String.LastIndexOf%2A?displayProperty=fullName> メソッドと <xref:System.Char> メソッドは、序数に基づく比較を実行します。一方、<xref:System.String.IndexOf%2A?displayProperty=fullName> パラメーターを含む既定の <xref:System.String.LastIndexOf%2A?displayProperty=fullName> メソッドと <xref:System.String> メソッドは、カルチャに依存した比較を実行します。  
+  
+ <xref:System.String.IndexOf%28System.String%29?displayProperty=fullName> メソッドまたは <xref:System.String.LastIndexOf%28System.String%29?displayProperty=fullName> メソッドを呼び出して、現在のインスタンスで検索する文字列を渡す場合は、<xref:System.StringComparison> 型を明示的に指定するオーバーロードを呼び出すことをお勧めします。<xref:System.Char> 引数を含むオーバーロードでは、<xref:System.StringComparison> 型を指定することはできません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="methods_that_perform_string_comparison_indirectly"></a>   
+## 間接的に文字列比較を実行するメソッド  
+ 文字列比較を中心的な操作とする非文字列メソッドの中には、<xref:System.StringComparer> 型を使用するものがあります。<xref:System.StringComparer> クラスには、<xref:System.StringComparer> のインスタンスを返す静的プロパティが 6 つ含まれています。これらのインスタンスの <xref:System.StringComparer.Compare%2A?displayProperty=fullName> メソッドは、次の種類の文字列比較を実行します。  
+  
+-   現在のカルチャを使用する、カルチャに依存した文字列比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.CurrentCulture%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+-   現在のカルチャを使用する、大文字と小文字を区別しない比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.CurrentCultureIgnoreCase%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+-   インバリアント カルチャの単語ベースの比較規則を使用する、カルチャに依存しない比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+-   インバリアント カルチャの単語ベースの比較規則を使用する、大文字と小文字を区別しない、カルチャに依存しない比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.InvariantCultureIgnoreCase%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+-   序数に基づく比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.Ordinal%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+-   大文字と小文字を区別しない、序数に基づく比較。 この <xref:System.StringComparer> オブジェクトは、<xref:System.StringComparer.OrdinalIgnoreCase%2A?displayProperty=fullName> プロパティによって返されます。  
+  
+### Array.Sort と Array.BinarySearch  
+ 既定の解釈: <xref:System.StringComparison?displayProperty=fullName>  
+  
+ データをコレクションに格納したり、永続化されたデータをファイルやデータベースからコレクションに読み取ったりするときに現在のカルチャを切り替えると、コレクション内のインバリアントが無効になる可能性があります。<xref:System.Array.BinarySearch%2A?displayProperty=fullName> メソッドでは、配列内で検索する要素が既に並べ替えられていると見なされます。<xref:System.Array.Sort%2A?displayProperty=fullName> メソッドは、配列内の文字列要素を並べ替えるために、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドを呼び出して個々の要素を順序付けます。 配列の並べ替えが行われてから内容の検索が行われるまでの間にカルチャが変更される場合、カルチャに依存した比較子を使用するのは危険です。 たとえば、次のコードでは、`Thread.CurrentThread.CurrentCulture` プロパティによって暗黙的に提供される比較子で格納と取得の操作が行われています。`StoreNames` の呼び出しと `DoesNameExist` の呼び出しの間にカルチャが変更されると \(この 2 つのメソッドの呼び出しの間に配列の内容が永続化された場合には特に\)、バイナリ サーチが失敗する可能性があります。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/indirect1.cs#7)]
+ [!code-vb[Conceptual.Strings.BestPractices#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/indirect1.vb#7)]  
+  
+ 次の例は、推奨されるバリエーションを示しています。ここでは、配列の並べ替えと検索の両方に、同じ序数に基づく \(カルチャに依存しない\) 比較メソッドが使用されています。 コードの変更は、2 つの例の `Line A` および `Line B` というラベルが付いた行に反映されています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/indirect1.cs#8)]
+ [!code-vb[Conceptual.Strings.BestPractices#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/indirect1.vb#8)]  
+  
+ このデータを永続化して別のカルチャのシステムに移動したり、データをユーザーに表示するために並べ替えたりする場合は、<xref:System.StringComparison?displayProperty=fullName> を使用することを検討してください。そうすると、ユーザー出力のために言語的な操作を行っても、カルチャの変更による影響を受けることはありません。 次の例では、前の 2 つの例を変更して、配列の並べ替えと検索にインバリアント カルチャを使用しています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/indirect1.cs#9)]
+ [!code-vb[Conceptual.Strings.BestPractices#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/indirect1.vb#9)]  
+  
+### コレクションの例: Hashtable のコンストラクター  
+ 文字列のハッシュも、文字列の比較方法の影響を受ける操作の 1 つです。  
+  
+ 次の例では、<xref:System.Collections.Hashtable> プロパティから返される <xref:System.StringComparer> オブジェクトを渡して <xref:System.StringComparer.OrdinalIgnoreCase%2A?displayProperty=fullName> オブジェクトをインスタンス化しています。<xref:System.StringComparer> から派生するクラス <xref:System.StringComparer> は <xref:System.Collections.IEqualityComparer> インターフェイスを実装するため、その <xref:System.Collections.IEqualityComparer.GetHashCode%2A> メソッドを使用して、ハッシュ テーブルの文字列のハッシュ コードを計算しています。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/indirect2.cs#10)]
+ [!code-vb[Conceptual.Strings.BestPractices#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/indirect2.vb#10)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Formatted"></a>   
+## 書式設定されたデータを表示および保持する  
+ 数値、日時など、文字列以外のデータをユーザーに表示するには、ユーザーのカルチャ設定を使用して書式設定します。 既定では、数値型と日時型の <xref:System.String.Format%2A?displayProperty=fullName> メソッドと `ToString` メソッドは、書式設定の操作に現在のスレッド カルチャを使用します。 書式指定メソッドで現在のカルチャを使用することを明示的に指定するには、`provider` パラメーターを含む書式指定メソッド \([String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName>、<xref:System.DateTime.ToString%28System.IFormatProvider%29?displayProperty=fullName> など\) のオーバーロードを呼び出し、そのパラメーターを <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティに渡すことができます。  
+  
+ 文字列以外のデータは、バイナリ データまたは書式付きデータとして保持できます。 書式付きデータとして保存するには、`provider` パラメーターを含む書式指定メソッドのオーバーロードを呼び出し、そのパラメーターを <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティに渡す必要があります。 インバリアント カルチャは、カルチャとコンピューターに依存しない書式付きデータに一貫した書式を提供します。 これに対し、インバリアント カルチャ以外のカルチャを使用して書式設定するデータの保持には、さまざまな制限があります。  
+  
+-   カルチャが異なるシステムでデータを取得したり、現在のシステムのユーザーが現在のカルチャを変更してデータを取得しようとしたりすると、そのデータは使用できない可能性があります。  
+  
+-   特定のコンピューターのカルチャのプロパティは、その標準の値とは異なる場合があります。 常に、ユーザーはカルチャに依存した表示設定をカスタマイズする可能性があります。 このため、ユーザーがカルチャの設定をカスタマイズすると、システムに保存されている書式付きデータが読み取ることができなくなる場合があります。 コンピューター間の書式付きデータの移植性がさらに制限される可能性があります。  
+  
+-   数値や日時の書式設定を制御する国際的、地域的、または国内の標準は時間と共に変化するため、これらの変化は Windows オペレーティング システムの更新プログラムに組み込まれています。 書式設定の規則が変わると、以前の規則に従って書式設定されたデータが読み取ることができなくなる場合があります。  
+  
+ 次に、カルチャに依存する書式設定を使用してデータを保持すると移植性が制限される例を示します。 この例では、日時の値の配列をファイルに保存します。 これらは、英語 \(米国\) のカルチャの規則を使用して書式設定されています。 現在のスレッド カルチャがフランス語 \(スイス\) に変更されると、アプリケーションは現在のカルチャの書式設定規則を使用して保存された値を読み取ることを試みます。 2 つのデータ項目の読み取りを試みると、<xref:System.FormatException> 例外がスローされます。日付の配列には、<xref:System.DateTime.MinValue> に等しい 2 つの間違った要素が含まれることになります。  
+  
+ [!code-csharp[Conceptual.Strings.BestPractices#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.bestpractices/cs/persistence.cs#21)]
+ [!code-vb[Conceptual.Strings.BestPractices#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.bestpractices/vb/persistence.vb#21)]  
+  
+ しかし、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティを <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> に置き換えて <xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> 呼び出しと <xref:System.DateTime.Parse%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> 呼び出しを行うと、保持されている日時データは正常に復元されます。次にその出力を示します。  
+  
+```  
+  
+06.05.1758 21:26  
+05.05.1818 07:19  
+22.04.1870 23:54  
+08.09.1890 06:47  
+18.02.1905 15:12  
+  
+```  
+  
+## 参照  
+ [文字列の操作](../../../docs/standard/base-types/manipulating-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/best-practices.md b/docs/standard/base-types/best-practices.md
index ad6e8d06b60..9cec5898f3f 100644
--- a/docs/standard/base-types/best-practices.md
+++ b/docs/standard/base-types/best-practices.md
@@ -1,1106 +1,301 @@
 ---
-title: "正規表現に関するベスト プラクティス"
-description: "正規表現に関するベスト プラクティス"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 096fd614-91bf-4296-be24-12f62b062294
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: cf9c83de791fa4990a991689a26d4bbdd84cfe7d
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="best-practices-for-regular-expressions"></a>正規表現に関するベスト プラクティス
-
-.NET の正規表現エンジンは、リテラル テキストの比較と照合ではなくパターン一致に基づいてテキストを処理する、完全な機能を備えた強力なツールです。 ほとんどの場合は、すばやく効率的にパターン一致が実行されますが、 処理が非常に遅く見えることもあります。 極端なケースでは、比較的小さな入力の処理に何時間も何日もかかり、応答しなくなったように見えることさえあります。 
-
-ここでは、正規表現で最適なパフォーマンスを確保するためのいくつかのベスト プラクティスの概要を説明します。 このチュートリアルは、次のセクションで構成されています。
-
-* [入力ソースを考慮に入れる](#consider-the-input-source)
-
-* [オブジェクトのインスタンス化を適切に処理する](#handle-object-instantiation-appropriately)
-
-* [バックトラッキングを管理する](#take-charge-of-backtracking)
-
-* [タイムアウト値を使用する](#use-time-out-values)
-
-* [必要なときにのみキャプチャする](#capture-only-when-necessary)
-
-* [関連トピック](#related-topics)
-
-## <a name="consider-the-input-source"></a>入力ソースを考慮に入れる
-
-一般に、正規表現で受け入れられる入力には、制約のある入力と制約のない入力の&2; 種類があります。 制約のある入力とは、あらかじめ定義された形式に従っている、既知のソースまたは信頼できるソースからのテキストです。 制約のない入力とは、あらかじめ定義された形式や予想される形式に従っていない可能性のある、不確実なソース (Web ユーザーなど) からのテキストです。
-
-正規表現パターンは、有効な入力に一致するように記述されるのが一般的です。 開発者はまず、対象となるテキストを調査して、そのテキストに一致する正規表現パターンを記述します。 記述が完了すると、そのパターンを複数の有効な入力項目でテストして、修正や改善が必要かどうかを確認します。 想定されるすべての有効な入力に一致するようになったら、そのパターンは運用環境で使用する準備が整ったと見なされ、リリースされるアプリケーションに含めることができます。 こうして作成された正規表現パターンは、制約のある入力との照合には適していますが、 制約のない入力との照合に適しているとは言えません。
-
-制約のない入力と照合する正規表現は、次の&3; 種類のテキストを効率的に処理できなければなりません。
-
-• 正規表現パターンに一致するテキスト。
-
-• 正規表現パターンに一致しないテキスト。
-
-• 正規表現パターンにほぼ一致するテキスト。
-
-制約のある入力を処理するために記述された正規表現で特に問題となるのは、最後の種類のテキストです。 その正規表現が広範な[バックトラッキング](backtracking.md)にも依存している場合、一見何の問題もないように見えるテキストの処理に極端に長い時間 (場合によっては何時間も何日も) が費やされる可能性があります。 
-
+title: ".NET Framework での正規表現に関するベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 推奨される手順"
+  - "正規表現, 推奨される手順"
+ms.assetid: 618e5afb-3a97-440d-831a-70e4c526a51c
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# .NET Framework での正規表現に関するベスト プラクティス
+.NET Framework の正規表現エンジンは、リテラル テキストの比較と照合ではなくパターン一致に基づいてテキストを処理する、完全な機能を備えた強力なツールです。  ほとんどの場合は、すばやく効率的にパターン一致が実行されますが、  処理が非常に遅く見えることもあります。  極端なケースでは、比較的小さな入力の処理に何時間も何日もかかり、応答しなくなったように見えることさえあります。  
+  
+ ここでは、正規表現で最適なパフォーマンスを確保するためのいくつかのベスト プラクティスの概要を説明します。  このチュートリアルは、次のセクションで構成されています。  
+  
+-   [入力ソースを考慮に入れる](#InputSource)  
+  
+-   [オブジェクトのインスタンス化を適切に処理する](#ObjectInstantiation)  
+  
+-   [バックトラッキングを管理する](#Backtracking)  
+  
+-   [タイムアウト値を使用する](#Timeouts)  
+  
+-   [必要なときにのみキャプチャする](#Capture)  
+  
+-   [関連トピック](#RelatedTopics)  
+  
+<a name="InputSource"></a>   
+## 入力ソースを考慮に入れる  
+ 一般に、正規表現で受け入れられる入力には、制約のある入力と制約のない入力の 2 種類があります。  制約のある入力とは、あらかじめ定義された形式に従っている、既知のソースまたは信頼できるソースからのテキストです。  制約のない入力とは、あらかじめ定義された形式や予想される形式に従っていない可能性のある、不確実なソース \(Web ユーザーなど\) からのテキストです。  
+  
+ 正規表現パターンは、有効な入力に一致するように記述されるのが一般的です。  開発者はまず、対象となるテキストを調査して、そのテキストに一致する正規表現パターンを記述します。  記述が完了すると、そのパターンを複数の有効な入力項目でテストして、修正や改善が必要かどうかを確認します。  想定されるすべての有効な入力に一致するようになったら、そのパターンは運用環境で使用する準備が整ったと見なされ、リリースされるアプリケーションに含めることができます。  こうして作成された正規表現パターンは、制約のある入力との照合には適していますが、  制約のない入力との照合に適しているとは言えません。  
+  
+ 制約のない入力と照合する正規表現は、次の 3 種類のテキストを効率的に処理できなければなりません。  
+  
+-   正規表現パターンに一致するテキスト。  
+  
+-   正規表現パターンに一致しないテキスト。  
+  
+-   正規表現パターンにほぼ一致するテキスト。  
+  
+ 制約のある入力を処理するために記述された正規表現で特に問題となるのは、最後の種類のテキストです。  その正規表現が広範な[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)にも依存している場合、一見何の問題もないように見えるテキストの処理に極端に長い時間 \(場合によっては何時間も何日も\) が費やされる可能性があります。  
+  
 > [!WARNING]
-> 次の例では、過度なバックトラッキングを生じる傾向があり、有効な電子メール アドレスを拒否する可能性がある正規表現を使用します。 電子メールの検証ルーチンで使用しないでください。 メール アドレスを検証する正規表現が必要な場合は、「[方法: 文字列が有効な電子メール形式であるかどうかを検証する](verify-format.md)」を参照してください。 
-
-
-例として、電子メール アドレスのエイリアスを検証するための正規表現について見てみましょう。このような正規表現はよく使用されますが、きわめて大きな問題もはらんでいます。 有効と見なされる電子メール アドレスを処理するために、`^[0-9A-Z]([-.\w]*[0-9A-Z])*$` という正規表現を記述したとします。有効な電子メール アドレスは、英数字で始まり、その後に&0; 個以上の文字 (英数字、ピリオド、またはハイフン) が続きます。 また、正規表現は英数字で終了する必要があります。 この正規表現は、次の例に示すように、有効な入力は簡単に処理できますが、有効に近い入力を処理するときに極端に処理効率が低下します。
-
-```csharp
-using System;
-using System.Diagnostics;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      Stopwatch sw;    
-      string[] addresses = { "AAAAAAAAAAA@contoso.com", 
-                             "AAAAAAAAAAaaaaaaaaaa!@contoso.com" };
-      // The following regular expression should not actually be used to 
-      // validate an email address.
-      string pattern = @"^[0-9A-Z]([-.\w]*[0-9A-Z])*$";
-      string input; 
-
-      foreach (var address in addresses) {
-         string mailBox = address.Substring(0, address.IndexOf("@"));       
-         int index = 0;
-         for (int ctr = mailBox.Length - 1; ctr >= 0; ctr--) {
-            index++;
-
-            input = mailBox.Substring(ctr, index); 
-            sw = Stopwatch.StartNew();
-            Match m = Regex.Match(input, pattern, RegexOptions.IgnoreCase);
-            sw.Stop();
-            if (m.Success)
-               Console.WriteLine("{0,2}. Matched '{1,25}' in {2}", 
-                                 index, m.Value, sw.Elapsed);
-            else                     
-               Console.WriteLine("{0,2}. Failed  '{1,25}' in {2}", 
-                                 index, input, sw.Elapsed);
-         }
-         Console.WriteLine();
-      }
-   }
-}
-
-// The example displays output similar to the following:
-//     1. Matched '                        A' in 00:00:00.0007122
-//     2. Matched '                       AA' in 00:00:00.0000282
-//     3. Matched '                      AAA' in 00:00:00.0000042
-//     4. Matched '                     AAAA' in 00:00:00.0000038
-//     5. Matched '                    AAAAA' in 00:00:00.0000042
-//     6. Matched '                   AAAAAA' in 00:00:00.0000042
-//     7. Matched '                  AAAAAAA' in 00:00:00.0000042
-//     8. Matched '                 AAAAAAAA' in 00:00:00.0000087
-//     9. Matched '                AAAAAAAAA' in 00:00:00.0000045
-//    10. Matched '               AAAAAAAAAA' in 00:00:00.0000045
-//    11. Matched '              AAAAAAAAAAA' in 00:00:00.0000045
-//    
-//     1. Failed  '                        !' in 00:00:00.0000447
-//     2. Failed  '                       a!' in 00:00:00.0000071
-//     3. Failed  '                      aa!' in 00:00:00.0000071
-//     4. Failed  '                     aaa!' in 00:00:00.0000061
-//     5. Failed  '                    aaaa!' in 00:00:00.0000081
-//     6. Failed  '                   aaaaa!' in 00:00:00.0000126
-//     7. Failed  '                  aaaaaa!' in 00:00:00.0000359
-//     8. Failed  '                 aaaaaaa!' in 00:00:00.0000414
-//     9. Failed  '                aaaaaaaa!' in 00:00:00.0000758
-//    10. Failed  '               aaaaaaaaa!' in 00:00:00.0001462
-//    11. Failed  '              aaaaaaaaaa!' in 00:00:00.0002885
-//    12. Failed  '             Aaaaaaaaaaa!' in 00:00:00.0005780
-//    13. Failed  '            AAaaaaaaaaaa!' in 00:00:00.0011628
-//    14. Failed  '           AAAaaaaaaaaaa!' in 00:00:00.0022851
-//    15. Failed  '          AAAAaaaaaaaaaa!' in 00:00:00.0045864
-//    16. Failed  '         AAAAAaaaaaaaaaa!' in 00:00:00.0093168
-//    17. Failed  '        AAAAAAaaaaaaaaaa!' in 00:00:00.0185993
-//    18. Failed  '       AAAAAAAaaaaaaaaaa!' in 00:00:00.0366723
-//    19. Failed  '      AAAAAAAAaaaaaaaaaa!' in 00:00:00.1370108
-//    20. Failed  '     AAAAAAAAAaaaaaaaaaa!' in 00:00:00.1553966
-//    21. Failed  '    AAAAAAAAAAaaaaaaaaaa!' in 00:00:00.3223372
-```
-
-```vb
-Imports System.Diagnostics
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim sw As Stopwatch    
-      Dim addresses() As String = { "AAAAAAAAAAA@contoso.com", 
-                                 "AAAAAAAAAAaaaaaaaaaa!@contoso.com" }
-      ' The following regular expression should not actually be used to 
-      ' validate an email address.
-      Dim pattern As String = "^[0-9A-Z]([-.\w]*[0-9A-Z])*$"
-      Dim input As String 
-
-      For Each address In addresses
-         Dim mailBox As String = address.Substring(0, address.IndexOf("@"))       
-         Dim index As Integer = 0
-         For ctr As Integer = mailBox.Length - 1 To 0 Step -1
-            index += 1
-            input = mailBox.Substring(ctr, index) 
-            sw = Stopwatch.StartNew()
-            Dim m As Match = Regex.Match(input, pattern, RegexOptions.IgnoreCase)
-            sw.Stop()
-            if m.Success Then
-               Console.WriteLine("{0,2}. Matched '{1,25}' in {2}", 
-                                 index, m.Value, sw.Elapsed)
-            Else                     
-               Console.WriteLine("{0,2}. Failed  '{1,25}' in {2}", 
-                                 index, input, sw.Elapsed)
-            End If                  
-         Next
-         Console.WriteLine()
-      Next
-   End Sub
-End Module
-' The example displays output similar to the following:
-'     1. Matched '                        A' in 00:00:00.0007122
-'     2. Matched '                       AA' in 00:00:00.0000282
-'     3. Matched '                      AAA' in 00:00:00.0000042
-'     4. Matched '                     AAAA' in 00:00:00.0000038
-'     5. Matched '                    AAAAA' in 00:00:00.0000042
-'     6. Matched '                   AAAAAA' in 00:00:00.0000042
-'     7. Matched '                  AAAAAAA' in 00:00:00.0000042
-'     8. Matched '                 AAAAAAAA' in 00:00:00.0000087
-'     9. Matched '                AAAAAAAAA' in 00:00:00.0000045
-'    10. Matched '               AAAAAAAAAA' in 00:00:00.0000045
-'    11. Matched '              AAAAAAAAAAA' in 00:00:00.0000045
-'    
-'     1. Failed  '                        !' in 00:00:00.0000447
-'     2. Failed  '                       a!' in 00:00:00.0000071
-'     3. Failed  '                      aa!' in 00:00:00.0000071
-'     4. Failed  '                     aaa!' in 00:00:00.0000061
-'     5. Failed  '                    aaaa!' in 00:00:00.0000081
-'     6. Failed  '                   aaaaa!' in 00:00:00.0000126
-'     7. Failed  '                  aaaaaa!' in 00:00:00.0000359
-'     8. Failed  '                 aaaaaaa!' in 00:00:00.0000414
-'     9. Failed  '                aaaaaaaa!' in 00:00:00.0000758
-'    10. Failed  '               aaaaaaaaa!' in 00:00:00.0001462
-'    11. Failed  '              aaaaaaaaaa!' in 00:00:00.0002885
-'    12. Failed  '             Aaaaaaaaaaa!' in 00:00:00.0005780
-'    13. Failed  '            AAaaaaaaaaaa!' in 00:00:00.0011628
-'    14. Failed  '           AAAaaaaaaaaaa!' in 00:00:00.0022851
-'    15. Failed  '          AAAAaaaaaaaaaa!' in 00:00:00.0045864
-'    16. Failed  '         AAAAAaaaaaaaaaa!' in 00:00:00.0093168
-'    17. Failed  '        AAAAAAaaaaaaaaaa!' in 00:00:00.0185993
-'    18. Failed  '       AAAAAAAaaaaaaaaaa!' in 00:00:00.0366723
-'    19. Failed  '      AAAAAAAAaaaaaaaaaa!' in 00:00:00.1370108
-'    20. Failed  '     AAAAAAAAAaaaaaaaaaa!' in 00:00:00.1553966
-'    21. Failed  '    AAAAAAAAAAaaaaaaaaaa!' in 00:00:00.3223372
-```
-
-この出力を見るとわかるように、有効な電子メール エイリアスは、その長さに関係なくほとんど同じ時間で処理されます。 一方、有効に近い電子メール アドレスでは、長さが&5; 文字を超えると、文字列の文字が&1; 文字増えるたびに処理時間が約&2; 倍に増加します。 つまり、有効に近い文字列の長さが 28 文字になると処理に 1 時間以上かかり、33 文字になるとほぼ 1 日かかることになります。 
-
-この正規表現は、一致する入力の形式ばかりを念頭に置いて開発されていて、パターンに一致しない入力のことが考慮されていません。 そのため、制約のない入力が正規表現パターンにほぼ一致する場合に、パフォーマンスが大幅に低下する可能性があります。
-
-この問題を解決する方法を以下に示します。
-
-* パターンを開発するときには、バックトラッキングが正規表現エンジンのパフォーマンスに与える影響を考慮に入れます。特に、制約のない入力を処理する正規表現ではこれが重要です。 詳細については、このトピックの「[バックトラッキングを管理する](#take-charge-of-backtracking)」を参照してください。
-
-* 有効な入力だけでなく、無効な入力と有効に近い入力も使用して、正規表現を徹底的にテストします。 特定の正規表現に対する入力をランダムに生成するには、Microsoft Research の正規表現調査ツール [Rex](http://research.microsoft.com/en-us/projects/rex/) を使用できます。
-
-## <a name="handle-object-instantiation-appropriately"></a>オブジェクトのインスタンス化を適切に処理する
-
-.NET の正規表現オブジェクト モデルの中核となるのは、正規表現エンジンを表す [System.Text.RegularExpressions.Regex](xref:System.Text.RegularExpressions.Regex) クラスです。 [Regex](xref:System.Text.RegularExpressions.Regex) エンジンの使用方法は、多くの場合、正規表現のパフォーマンスを左右する最大の要因になります。 正規表現を定義するときには、正規表現エンジンと正規表現パターンを密に結合する必要があります。 この結合のプロセスは、正規表現パターンをコンストラクターに渡して [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化する場合も、分析する文字列と共に正規表現パターンを渡して静的メソッドを呼び出す場合も、必然的にコストが高くなります。
-
-正規表現エンジンを特定の正規表現パターンと結合し、そのエンジンを使用してテキストを照合するには、次のようにいくつかの方法があります。
-
-* パターン一致を実行する静的メソッド [Regex.Match(String, String)](xref:System.Text.RegularExpressions.Regex.Match(System.String,System.String)) などを呼び出します。 この場合は、正規表現オブジェクトをインスタンス化する必要はありません。
-
-* [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化し、解釈される正規表現のパターン一致を実行するインスタンス メソッドを呼び出します。 これは、正規表現エンジンを正規表現パターンにバインドするための既定の方法です。 [RegexOptions.Compiled](xref:System.Text.RegularExpressions.RegexOptions.Compiled) フラグを含むオプション引数を使用せずに [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトがインスタンス化された場合にこのようになります。
-
-* [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化し、コンパイルされた正規表現のパターン一致を実行するインスタンス メソッドを呼び出します。 [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化するときに、[RegexOptions.Compiled](xref:System.Text.RegularExpressions.RegexOptions.Compiled) フラグを含むオプション引数を指定した場合、正規表現オブジェクトはコンパイル済みのパターンを表します。
-
+>  次の例では、過度なバックトラッキングを生じる傾向があり、有効な電子メール アドレスを拒否する可能性がある正規表現を使用します。  電子メールの検証ルーチンで使用しないでください。  電子メール アドレスを検証する正規表現が必要な場合は、「[方法 : 文字列が有効な電子メール形式であるかどうかを検証する](../../../docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md)」を参照してください。  
+  
+ 例として、電子メール アドレスのエイリアスを検証するための正規表現について見てみましょう。このような正規表現はよく使用されますが、きわめて大きな問題もはらんでいます。  有効と見なされる電子メール アドレスを処理するために、`^[0-9A-Z]([-.\w]*[0-9A-Z])*$` という正規表現を記述したとします。有効な電子メール アドレスは、英数字で始まり、その後に 0 個以上の文字 \(英数字、ピリオド、またはハイフン\) が続きます。  また、正規表現は英数字で終了する必要があります。  この正規表現は、次の例に示すように、有効な入力は簡単に処理できますが、有効に近い入力を処理するときに極端に処理効率が低下します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/design2.cs#1)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/design2.vb#1)]  
+  
+ この出力を見るとわかるように、有効な電子メール エイリアスは、その長さに関係なくほとんど同じ時間で処理されます。  一方、有効に近い電子メール アドレスでは、長さが 5 文字を超えると、文字列の文字が 1 文字増えるたびに処理時間が約 2 倍に増加します。  つまり、有効に近い文字列の長さが 28 文字になると処理に 1 時間以上かかり、33 文字になるとほぼ 1 日かかることになります。  
+  
+ この正規表現は、一致する入力の形式ばかりを念頭に置いて開発されていて、パターンに一致しない入力のことが考慮されていません。  そのため、制約のない入力が正規表現パターンにほぼ一致する場合に、パフォーマンスが大幅に低下する可能性があります。  
+  
+ この問題を解決する方法を以下に示します。  
+  
+-   パターンを開発するときには、バックトラッキングが正規表現エンジンのパフォーマンスに与える影響を考慮に入れます。特に、制約のない入力を処理する正規表現ではこれが重要です。  詳細については、このトピックの「[バックトラッキングを管理する](#Backtracking)」を参照してください。  
+  
+-   有効な入力だけでなく、無効な入力と有効に近い入力も使用して、正規表現を徹底的にテストします。  特定の正規表現に対する入力をランダムに生成するには、Microsoft Research の正規表現調査ツール [Rex](http://go.microsoft.com/fwlink/?LinkId=210756) を使用できます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="ObjectInstantiation"></a>   
+## オブジェクトのインスタンス化を適切に処理する  
+ .NET Framework の正規表現オブジェクト モデルの中核となるのは、正規表現エンジンを表す <xref:System.Text.RegularExpressions.Regex?displayProperty=fullName> クラスです。  <xref:System.Text.RegularExpressions.Regex> エンジンの使用方法は、多くの場合、正規表現のパフォーマンスを左右する最大の要因になります。  正規表現を定義するときには、正規表現エンジンと正規表現パターンを密に結合する必要があります。  この結合のプロセスは、正規表現パターンをコンストラクターに渡して <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化する場合も、分析する文字列と共に正規表現パターンを渡して静的メソッドを呼び出す場合も、必然的にコストが高くなります。  
+  
+> [!NOTE]
+>  解釈される正規表現を使用する場合とコンパイルされる正規表現を使用する場合のパフォーマンスへの影響に関する詳細な議論については、BCL チームのブログの「[正規表現のパフォーマンスの最適化、パート II: バックトラッキングの管理](http://go.microsoft.com/fwlink/?LinkId=211566)」を参照してください。  
+  
+ 正規表現エンジンを特定の正規表現パターンと結合し、そのエンジンを使用してテキストを照合するには、次のようにいくつかの方法があります。  
+  
+-   パターン一致を実行する静的メソッド \(<xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%29?displayProperty=fullName> など\) を呼び出します。  この場合は、正規表現オブジェクトをインスタンス化する必要はありません。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化し、解釈される正規表現のパターン一致を実行するインスタンス メソッドを呼び出します。  これは、正規表現エンジンを正規表現パターンにバインドするための既定の方法です。  <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化するときに、`options` フラグを含む <xref:System.Text.RegularExpressions.RegexOptions> 引数を指定しないと、この方法が使用されます。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化し、コンパイルされた正規表現のパターン一致を実行するインスタンス メソッドを呼び出します。  <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化するときに、`options` フラグを含む <xref:System.Text.RegularExpressions.RegexOptions> 引数を指定した場合、正規表現オブジェクトはコンパイル済みのパターンを表します。  
+  
+-   特定の正規表現パターンと密に結合された専用の <xref:System.Text.RegularExpressions.Regex> オブジェクトを作成し、コンパイルして、スタンドアロンのアセンブリに保存します。  これを行うには、<xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+ 正規表現の一致メソッドを呼び出す方法は、アプリケーションのパフォーマンスに大きな影響を与える可能性があります。  以降では、アプリケーションのパフォーマンスを改善するために、静的メソッドの呼び出し、解釈される正規表現、およびコンパイルされる正規表現を使い分ける方法について説明します。  
+  
 > [!IMPORTANT]
-> メソッド呼び出しの形式 (静的、解釈、コンパイル) は、メソッド呼び出しで同じ正規表現が繰り返し使用される場合や、アプリケーションで正規表現オブジェクトが多用される場合に、パフォーマンスに影響を与えます。
- 
-### <a name="static-regular-expressions"></a>静的正規表現
-
-静的正規表現メソッドは、正規表現オブジェクトを同じ正規表現で繰り返しインスタンス化する代わりの方法として推奨されます。 正規表現オブジェクトで使用される正規表現パターンとは異なり、インスタンス メソッドの呼び出しで使用されるパターンの場合は、そのオペレーション コードまたはコンパイルされた Microsoft Intermediate Language (MSIL) が正規表現エンジンによって内部にキャッシュされます。 
-
-たとえば、ユーザー入力を検証するメソッドを呼び出すことができます。 この例では `IsValidCurrency` という名前のメソッドが、ユーザーが少なくとも&1; つの&10; 進数を通貨記号の後に入力したかどうかを確認します。 次の例は、`IsValidCurrency` メソッドのきわめて非効率的な実装を示しています。 この例では、このメソッドが呼び出されるたびに [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトが同じパターンでインスタンス化されます。 そのため、メソッドが呼び出されるたびに正規表現パターンを再コンパイルしなければならなくなります。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class RegexLib
-{
-   public static bool IsValidCurrency(string currencyValue)
-   {
-      string pattern = @"\p{Sc}+\s*\d+";
-      Regex currencyRegex = new Regex(pattern);
-      return currencyRegex.IsMatch(currencyValue);
-   }
-}
-```
-
-```vb
-Public Sub OKButton_Click(sender As Object, e As EventArgs) _ 
-           Handles OKButton.Click
-
-   If Not String.IsNullOrEmpty(sourceCurrency.Text) Then
-      If RegexLib.IsValidCurrency(sourceCurrency.Text) Then
-         PerformConversion()
-      Else
-         status.Text = "The source currency value is invalid."
-      End If          
-   End If
-End Sub
-```
-
-この非効率的なコードは、静的な [Regex.IsMatch(String, String)](xref:System.Text.RegularExpressions.Regex.IsMatch(System.String,System.String)) メソッドの呼び出しに置き換える必要があります。 これにより、パターン一致メソッドを呼び出すたびに [Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化する必要がなくなり、正規表現エンジンがキャッシュからコンパイル済みの正規表現を取得できるようになります。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class RegexLib
-{
-   public static bool IsValidCurrency(string currencyValue)
-   {
-      string pattern = @"\p{Sc}+\s*\d+";
-      return Regex.IsMatch(currencyValue, pattern); 
-   }
-}
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Public Module RegexLib
-   Public Function IsValidCurrency(currencyValue As String) As Boolean
-      Dim pattern As String = "\p{Sc}+\s*\d+"
-      Return Regex.IsMatch(currencyValue, pattern)
-   End Function
-End Module
-```
-
-既定では、最近使用された静的正規表現パターンが 15 個までキャッシュされます。 アプリケーションで多数の静的正規表現をキャッシュする必要がある場合は、[Regex.CacheSize](xref:System.Text.RegularExpressions.Regex.CacheSize) プロパティを設定してキャッシュのサイズを調整できます。
-
-この例で使用されている正規表現 `\p{Sc}+\s*\d+` は、入力文字列が通貨記号と&1; 文字以上の&10; 進数の数字で構成されているかどうかを確認します。 このパターンは、次の表に示すように定義されます。
-
-パターン | 説明
-------- | -----------
-`\p{Sc}+` | Unicode の Symbol, Currency カテゴリの&1; 個以上の文字と一致します。
-`\s*` | 0 個以上の空白文字と一致します。
-`\d+` | 1 個以上の&10; 進数と一致します。
- 
-### <a name="interpreted-vs-compiled-regular-expressions"></a>解釈される正規表現とコンパイルされる正規表現
-
-[RegexOptions.Compiled](xref:System.Text.RegularExpressions.RegexOptions.Compiled) オプションを指定して正規表現エンジンにバインドされていない正規表現パターンは、解釈されます。 正規表現オブジェクトがインスタンス化されるとき、正規表現エンジンは、その正規表現を一連のオペレーション コードに変換します。 インスタンス メソッドが呼び出されると、オペレーション コードが MSIL に変換され、JIT コンパイラによって実行されます。 同様に、静的正規表現メソッドが呼び出され、その正規表現がキャッシュに見つからない場合、正規表現エンジンは、その正規表現を一連のオペレーション コードに変換し、キャッシュに格納します。 それらのオペレーション コードは、その後、JIT コンパイラで実行できるように MSIL に変換されます。 解釈される正規表現では、実行時間が長くなる代わりに、スタートアップ時間が短縮されます。 このため、正規表現を使用するメソッドの呼び出し回数が少ない場合、または正確な回数はわからなくても少ないと予想される場合に適しています。 メソッド呼び出しの回数が増えるにつれて、スタートアップ時間の短縮というメリットよりも、実行速度の低下というデメリットの方が大きくなります。
-
-[RegexOptions.Compiled](xref:System.Text.RegularExpressions.RegexOptions.Compiled) オプションを指定して正規表現エンジンにバインドされている正規表現パターンは、コンパイルされます。 つまり、正規表現オブジェクトがインスタンス化されるとき、または静的正規表現メソッドが呼び出され、その正規表現がキャッシュに見つからないとき、正規表現エンジンは、その正規表現を一連の中間的なオペレーション コードに変換し、さらに MSIL に変換します。 メソッドが呼び出されると、その MSIL が JIT コンパイラによって実行されます。 コンパイルされる正規表現では、解釈される正規表現とは対照的に、スタートアップ時間が長くなる一方で、個々のパターン一致メソッドの実行時間は短くなります。 結果として、正規表現のコンパイルによって得られるパフォーマンス上のメリットは、正規表現メソッドが呼び出される回数に比例して大きくなります。
-
-要約すると、特定の正規表現について正規表現メソッドを呼び出す回数が比較的少ない場合は、解釈される正規表現を使用することをお勧めします。 特定の正規表現について正規表現メソッドを呼び出す回数が比較的多い場合は、コンパイルされる正規表現を使用することをお勧めします。 解釈される正規表現で実行速度の低下がスタートアップ時間の短縮を上回るしきい値や、コンパイルされる正規表現でスタートアップ時間の増加が実行速度の向上を上回るしきい値については、正確な値を特定するのは困難です。 これは、正規表現の複雑さや、処理される個々のデータなど、さまざまな要因に依存します。 特定のアプリケーションのシナリオにおいて、解釈される正規表現とコンパイルされる正規表現のどちらで最適なパフォーマンスが得られるかを特定するには、[Stopwatch](xref:System.Diagnostics.Stopwatch) クラスを使用して実行時間を比較します。
-
-次の例では、Theodore Dreiser の『The Financier』の最初の&10; 個の文を読み取る場合とすべての文を読み取る場合について、コンパイルされる正規表現と解釈される正規表現のパフォーマンスを比較しています。 出力を見るとわかるように、正規表現の一致メソッドの呼び出しが&10; 回だけの場合は、解釈される正規表現の方がコンパイルされる正規表現よりパフォーマンスが高くなります。 しかし、多数の呼び出し (この場合は 13,000 回以上) が行われる場合は、コンパイルされる正規表現の方がパフォーマンスが高くなります。 
-
-```csharp
-using System;
-using System.Diagnostics;
-using System.IO;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string pattern = @"\b(\w+((\r?\n)|,?\s))*\w+[.?:;!]";
-      Stopwatch sw;
-      Match match;
-      int ctr;
-
-      StreamReader inFile = new StreamReader(@".\Dreiser_TheFinancier.txt");
-      string input = inFile.ReadToEnd();
-      inFile.Close();
-
-      // Read first ten sentences with interpreted regex.
-      Console.WriteLine("10 Sentences with Interpreted Regex:");
-      sw = Stopwatch.StartNew();
-      Regex int10 = new Regex(pattern, RegexOptions.Singleline);
-      match = int10.Match(input);
-      for (ctr = 0; ctr <= 9; ctr++) {
-         if (match.Success)
-            // Do nothing with the match except get the next match.
-            match = match.NextMatch();
-         else
-            break;
-      }
-      sw.Stop();
-      Console.WriteLine("   {0} matches in {1}", ctr, sw.Elapsed);
-
-      // Read first ten sentences with compiled regex.
-      Console.WriteLine("10 Sentences with Compiled Regex:");
-      sw = Stopwatch.StartNew();
-      Regex comp10 = new Regex(pattern, 
-                   RegexOptions.Singleline | RegexOptions.Compiled);
-      match = comp10.Match(input);
-      for (ctr = 0; ctr <= 9; ctr++) {
-         if (match.Success)
-            // Do nothing with the match except get the next match.
-            match = match.NextMatch();
-         else
-            break;
-      }
-      sw.Stop();
-      Console.WriteLine("   {0} matches in {1}", ctr, sw.Elapsed);
-
-      // Read all sentences with interpreted regex.
-      Console.WriteLine("All Sentences with Interpreted Regex:");
-      sw = Stopwatch.StartNew();
-      Regex intAll = new Regex(pattern, RegexOptions.Singleline);
-      match = intAll.Match(input);
-      int matches = 0;
-      while (match.Success) {
-         matches++;
-         // Do nothing with the match except get the next match.
-         match = match.NextMatch();
-      }
-      sw.Stop();
-      Console.WriteLine("   {0:N0} matches in {1}", matches, sw.Elapsed);
-
-      // Read all sentnces with compiled regex.
-      Console.WriteLine("All Sentences with Compiled Regex:");
-      sw = Stopwatch.StartNew();
-      Regex compAll = new Regex(pattern, 
-                      RegexOptions.Singleline | RegexOptions.Compiled);
-      match = compAll.Match(input);
-      matches = 0;
-      while (match.Success) {
-         matches++;
-         // Do nothing with the match except get the next match.
-         match = match.NextMatch();
-      }
-      sw.Stop();
-      Console.WriteLine("   {0:N0} matches in {1}", matches, sw.Elapsed);      
-   }
-}
-// The example displays the following output:
-//       10 Sentences with Interpreted Regex:
-//          10 matches in 00:00:00.0047491
-//       10 Sentences with Compiled Regex:
-//          10 matches in 00:00:00.0141872
-//       All Sentences with Interpreted Regex:
-//          13,443 matches in 00:00:01.1929928
-//       All Sentences with Compiled Regex:
-//          13,443 matches in 00:00:00.7635869
-//       
-//       >compare1
-//       10 Sentences with Interpreted Regex:
-//          10 matches in 00:00:00.0046914
-//       10 Sentences with Compiled Regex:
-//          10 matches in 00:00:00.0143727
-//       All Sentences with Interpreted Regex:
-//          13,443 matches in 00:00:01.1514100
-//       All Sentences with Compiled Regex:
-//          13,443 matches in 00:00:00.7432921
-```
-
-```vb
-Imports System.Diagnostics
-Imports System.IO
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim pattern As String = "\b(\w+((\r?\n)|,?\s))*\w+[.?:;!]"
-      Dim sw As Stopwatch
-      Dim match As Match
-      Dim ctr As Integer
-
-      Dim inFile As New StreamReader(".\Dreiser_TheFinancier.txt")
-      Dim input As String = inFile.ReadToEnd()
-      inFile.Close()
-
-      ' Read first ten sentences with interpreted regex.
-      Console.WriteLine("10 Sentences with Interpreted Regex:")
-      sw = Stopwatch.StartNew()
-      Dim int10 As New Regex(pattern, RegexOptions.SingleLine)
-      match = int10.Match(input)
-      For ctr = 0 To 9
-         If match.Success Then
-            ' Do nothing with the match except get the next match.
-            match = match.NextMatch()
-         Else
-            Exit For
-         End If
-      Next
-      sw.Stop()
-      Console.WriteLine("   {0} matches in {1}", ctr, sw.Elapsed)
-
-      ' Read first ten sentences with compiled regex.
-      Console.WriteLine("10 Sentences with Compiled Regex:")
-      sw = Stopwatch.StartNew()
-      Dim comp10 As New Regex(pattern, 
-                   RegexOptions.SingleLine Or RegexOptions.Compiled)
-      match = comp10.Match(input)
-      For ctr = 0 To 9
-         If match.Success Then
-            ' Do nothing with the match except get the next match.
-            match = match.NextMatch()
-         Else
-            Exit For
-         End If
-      Next
-      sw.Stop()
-      Console.WriteLine("   {0} matches in {1}", ctr, sw.Elapsed)
-
-      ' Read all sentences with interpreted regex.
-      Console.WriteLine("All Sentences with Interpreted Regex:")
-      sw = Stopwatch.StartNew()
-      Dim intAll As New Regex(pattern, RegexOptions.SingleLine)
-      match = intAll.Match(input)
-      Dim matches As Integer = 0
-      Do While match.Success
-         matches += 1
-         ' Do nothing with the match except get the next match.
-         match = match.NextMatch()
-      Loop
-      sw.Stop()
-      Console.WriteLine("   {0:N0} matches in {1}", matches, sw.Elapsed)
-
-      ' Read all sentnces with compiled regex.
-      Console.WriteLine("All Sentences with Compiled Regex:")
-      sw = Stopwatch.StartNew()
-      Dim compAll As New Regex(pattern, 
-                     RegexOptions.SingleLine Or RegexOptions.Compiled)
-      match = compAll.Match(input)
-      matches = 0
-      Do While match.Success
-         matches += 1
-         ' Do nothing with the match except get the next match.
-         match = match.NextMatch()
-      Loop
-      sw.Stop()
-      Console.WriteLine("   {0:N0} matches in {1}", matches, sw.Elapsed)      
-   End Sub
-End Module
-' The example displays output like the following:
-'       10 Sentences with Interpreted Regex:
-'          10 matches in 00:00:00.0047491
-'       10 Sentences with Compiled Regex:
-'          10 matches in 00:00:00.0141872
-'       All Sentences with Interpreted Regex:
-'          13,443 matches in 00:00:01.1929928
-'       All Sentences with Compiled Regex:
-'          13,443 matches in 00:00:00.7635869
-'       
-'       >compare1
-'       10 Sentences with Interpreted Regex:
-'          10 matches in 00:00:00.0046914
-'       10 Sentences with Compiled Regex:
-'          10 matches in 00:00:00.0143727
-'       All Sentences with Interpreted Regex:
-'          13,443 matches in 00:00:01.1514100
-'       All Sentences with Compiled Regex:
-'          13,443 matches in 00:00:00.7432921
-```
-
-この例で使用する正規表現パターン `\b(\w+((\r?\n)|,?\s))*\w+[.?:;!]` は、次の表に示すように定義されています。
-
-パターン | 説明
-------- | -----------
-`\b` | ワード境界から照合を開始します。
-`\w+` | 1 つ以上の単語文字に一致します。
-`(\r?\n)|,?\s)` | 0 ～&1; 個の復帰とそれに続く改行文字、または&0; ～&1; 個のコンマとそれに続く空白文字に一致します。
-`(\w+((\r?\n)|,?\s))*` | 1 個以上の単語文字の後に&0; ～&1; 個の復帰と改行文字または&0; ～&1; 個のコンマと空白文字が続くパターンの&0; 回以上の出現に一致します。
-`\w+` | 1 つ以上の単語文字に一致します。
-`[.?:;!]` | ピリオド、疑問符、コロン、セミコロン、または感嘆符に一致します。
- 
-## <a name="take-charge-of-backtracking"></a>バックトラッキングを管理する
-
-通常、正規表現エンジンは入力文字列内を直線的に進んで、入力文字列を正規表現パターンと比較します。 しかし、正規表現パターン内で不定量指定子 (__*__、**+**、**?** など)  が使用されていると、パターン全体に対する一致を検索するために、それまでに見つかった部分的な一致を放棄して、以前に保存した状態に戻る場合があります。 このプロセスをバックトラッキングと呼びます。
-
+>  メソッド呼び出しの形式 \(静的、解釈、コンパイル\) は、メソッド呼び出しで同じ正規表現が繰り返し使用される場合や、アプリケーションで正規表現オブジェクトが多用される場合に、パフォーマンスに影響を与えます。  
+  
+### 静的正規表現  
+ 静的正規表現メソッドは、正規表現オブジェクトを同じ正規表現で繰り返しインスタンス化する代わりの方法として推奨されます。  正規表現オブジェクトで使用される正規表現パターンとは異なり、インスタンス メソッドの呼び出しで使用されるパターンの場合は、そのオペレーション コードまたはコンパイルされた Microsoft Intermediate Language \(MSIL\) が正規表現エンジンによって内部にキャッシュされます。  
+  
+ たとえば、ユーザー入力を検証するために別のメソッドを頻繁に呼び出すイベント ハンドラーがあったとします。  これを反映したコードを次の例に示します。この例では、<xref:System.Windows.Forms.Button> コントロールの <xref:System.Windows.Forms.Control.Click> イベントを使用して `IsValidCurrency` というメソッドを呼び出しています。このメソッドは、ユーザーが通貨記号に続けて 1 文字以上の 10 進数の数字を入力したかどうかを確認します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/static1.cs#2)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/static1.vb#2)]  
+  
+ 次の例は、`IsValidCurrency` メソッドのきわめて非効率的な実装を示しています。  この例では、このメソッドが呼び出されるたびに <xref:System.Text.RegularExpressions.Regex> オブジェクトが同じパターンでインスタンス化されます。  そのため、メソッドが呼び出されるたびに正規表現パターンを再コンパイルしなければならなくなります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/static1.cs#3)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/static1.vb#3)]  
+  
+ この非効率的なコードは、静的な <xref:System.Text.RegularExpressions.Regex.IsMatch%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドの呼び出しに置き換える必要があります。  これにより、パターン一致メソッドを呼び出すたびに <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化する必要がなくなり、正規表現エンジンがキャッシュからコンパイル済みの正規表現を取得できるようになります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/static2.cs#4)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/static2.vb#4)]  
+  
+ 既定では、最近使用された静的正規表現パターンが 15 個までキャッシュされます。  アプリケーションで多数の静的正規表現をキャッシュする必要がある場合は、<xref:System.Text.RegularExpressions.Regex.CacheSize%2A?displayProperty=fullName> プロパティを設定してキャッシュのサイズを調整できます。  
+  
+ この例で使用されている正規表現 `\p{Sc}+\s*\d+` は、入力文字列が通貨記号と 1 文字以上の 10 進数の数字で構成されているかどうかを確認します。  このパターンは、次の表に示すように定義されます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\p{Sc}+`|Unicode の Symbol, Currency カテゴリの 1 個以上の文字と一致します。|  
+|`\s*`|0 個以上の空白文字と一致します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+  
+<a name="Interpreted"></a>   
+### インタープリターによって処理されるとします。コンパイルされた正規表現  
+ <xref:System.Text.RegularExpressions.RegexOptions> オプションを指定して正規表現エンジンにバインドされていない正規表現パターンは、解釈されます。  正規表現オブジェクトがインスタンス化されるとき、正規表現エンジンは、その正規表現を一連のオペレーション コードに変換します。  インスタンス メソッドが呼び出されると、オペレーション コードが MSIL に変換され、JIT コンパイラによって実行されます。  同様に、静的正規表現メソッドが呼び出され、その正規表現がキャッシュに見つからない場合、正規表現エンジンは、その正規表現を一連のオペレーション コードに変換し、キャッシュに格納します。  それらのオペレーション コードは、その後、JIT コンパイラで実行できるように MSIL に変換されます。  解釈される正規表現では、実行時間が長くなる代わりに、スタートアップ時間が短縮されます。  このため、正規表現を使用するメソッドの呼び出し回数が少ない場合、または正確な回数はわからなくても少ないと予想される場合に適しています。  メソッド呼び出しの回数が増えるにつれて、スタートアップ時間の短縮というメリットよりも、実行速度の低下というデメリットの方が大きくなります。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions> オプションを指定して正規表現エンジンにバインドされた正規表現パターンは、コンパイルされます。  つまり、正規表現オブジェクトがインスタンス化されるとき、または静的正規表現メソッドが呼び出され、その正規表現がキャッシュに見つからないとき、正規表現エンジンは、その正規表現を一連の中間的なオペレーション コードに変換し、さらに MSIL に変換します。  メソッドが呼び出されると、その MSIL が JIT コンパイラによって実行されます。  コンパイルされる正規表現では、解釈される正規表現とは対照的に、スタートアップ時間が長くなる一方で、個々のパターン一致メソッドの実行時間は短くなります。  結果として、正規表現のコンパイルによって得られるパフォーマンス上のメリットは、正規表現メソッドが呼び出される回数に比例して大きくなります。  
+  
+ 要約すると、特定の正規表現について正規表現メソッドを呼び出す回数が比較的少ない場合は、解釈される正規表現を使用することをお勧めします。  特定の正規表現について正規表現メソッドを呼び出す回数が比較的多い場合は、コンパイルされる正規表現を使用することをお勧めします。  解釈される正規表現で実行速度の低下がスタートアップ時間の短縮を上回るしきい値や、コンパイルされる正規表現でスタートアップ時間の増加が実行速度の向上を上回るしきい値については、正確な値を特定するのは困難です。  これは、正規表現の複雑さや、処理される個々のデータなど、さまざまな要因に依存します。  特定のアプリケーションのシナリオにおいて、解釈される正規表現とコンパイルされる正規表現のどちらで最適なパフォーマンスが得られるかを特定するには、<xref:System.Diagnostics.Stopwatch> クラスを使用して実行時間を比較します。  
+  
+ 次の例では、Theodore Dreiser の『*The Financier*』の最初の 10 個の文を読み取る場合とすべての文を読み取る場合について、コンパイルされる正規表現と解釈される正規表現のパフォーマンスを比較しています。  出力を見るとわかるように、正規表現の一致メソッドの呼び出しが 10 回だけの場合は、解釈される正規表現の方がコンパイルされる正規表現よりパフォーマンスが高くなります。  しかし、多数の呼び出し \(この場合は 13,000 回以上\) が行われる場合は、コンパイルされる正規表現の方がパフォーマンスが高くなります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/compare1.cs#5)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/compare1.vb#5)]  
+  
+ この例で使用する正規表現パターン `\b(\w+((\r?\n)|,?\s))*\w+[.?:;!]` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`(\r?  \n)&#124;,?  \s)`|0 ～ 1 個の復帰とそれに続く改行文字、または 0 ～ 1 個のコンマとそれに続く空白文字に一致します。|  
+|`(\w+((\r?  \n)&#124;,?  \s))*`|1 個以上の単語文字の後に 0 ～ 1 個の復帰と改行文字または 0 ～ 1 個のコンマと空白文字が続くパターンの 0 回以上の出現に一致します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`[.?:;!]`|ピリオド、疑問符、コロン、セミコロン、または感嘆符に一致します。|  
+  
+### 正規表現: アセンブリへのコンパイル  
+ .NET Framework では、コンパイル済みの正規表現を含むアセンブリを作成することもできます。  これにより、パフォーマンスの低下を招く正規表現のコンパイルを、実行時ではなくデザイン時に行うことができます。  ただし、追加の作業がいくつか必要になります。具体的には、正規表現を事前に定義して、アセンブリにコンパイルしなければなりません。  これにより、アセンブリの正規表現を使用するソース コードをコンパイルするときに、コンパイラがそのアセンブリを参照できるようになります。  アセンブリに含まれるコンパイル済みの各正規表現は、<xref:System.Text.RegularExpressions.Regex> の派生クラスによって表されます。  
+  
+ 正規表現をアセンブリにコンパイルするには、[Regex.CompileToAssembly\(RegexCompilationInfo\<xref:System.Text.RegularExpressions.Regex.CompileToAssembly%28System.Text.RegularExpressions.RegexCompilationInfo%5B%5D%2CSystem.Reflection.AssemblyName%29?displayProperty=fullName> メソッドを呼び出して、コンパイルする正規表現を表す <xref:System.Text.RegularExpressions.RegexCompilationInfo> オブジェクトの配列と、作成するアセンブリに関する情報を含む <xref:System.Reflection.AssemblyName> オブジェクトを渡します。  
+  
+ 次のような状況では、正規表現をアセンブリにコンパイルすることをお勧めします。  
+  
+-   コンポーネント開発者が、再利用できる正規表現のライブラリを作成する場合。  
+  
+-   正規表現のパターン一致メソッドが呼び出される回数を特定できない場合 \(1 ～ 2 回から数千～数万回の範囲\)。  別個のアセンブリにコンパイルされた正規表現では、コンパイルされる正規表現や解釈される正規表現とは違って、メソッド呼び出しの回数に関係なく一貫したパフォーマンスが得られます。  
+  
+ コンパイル済みの正規表現を使用してパフォーマンスを最適化する場合は、アセンブリの作成、正規表現エンジンの読み込み、およびそのパターン一致メソッドの実行にリフレクションを使用しないようにする必要があります。  そのためには、正規表現パターンを動的に構築しないこと、およびパターン一致オプション \(大文字と小文字を区別しないパターン一致など\) をアセンブリの作成時に指定することが要求されます。  さらに、アセンブリを作成するコードを、正規表現を使用するコードから分離する必要もあります。  
+  
+ 次の例は、コンパイル済みの正規表現を含むアセンブリを作成する方法を示しています。  この例では、`RegexLib.dll` という 1 つの正規表現クラスを含む `SentencePattern` という名前のアセンブリを作成しています。このクラスには、「[解釈される正規表現とコンパイルされる正規表現](#Interpreted)」で使用した、文に一致する正規表現パターンが含まれています。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/compile1.cs#6)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/compile1.vb#6)]  
+  
+ この例を実行可能ファイルにコンパイルして実行すると、`RegexLib.dll` という名前のアセンブリが作成されます。  正規表現は、`Utilities.RegularExpressions.SentencePattern` から派生する <xref:System.Text.RegularExpressions.Regex> という名前のクラスによって表されます。  次の例では、このコンパイル済みの正規表現を使用して、Theodore Dreiser の『*The Financier*』のテキストから文を抽出しています。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/compile2.cs#7)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/compile2.vb#7)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Backtracking"></a>   
+## バックトラッキングを管理する  
+ 通常、正規表現エンジンは入力文字列内を直線的に進んで、入力文字列を正規表現パターンと比較します。  しかし、正規表現パターン内で不定量指定子 \(`*`、`+`、`?` など\) が使用されていると、パターン全体に対する一致を検索するために、それまでに見つかった部分的な一致を放棄して、以前に保存した状態に戻る場合があります。  このプロセスをバックトラッキングと呼びます。  
+  
 > [!NOTE]
-> バックトラッキングの詳細については、「[正規表現の動作の詳細](regex-behavior.md)」と「[正規表現におけるバックトラッキング](backtracking.md)」を参照してください。
- 
-バックトラッキングのサポートにより、正規表現はより強力かつ柔軟になります。 同時に、正規表現エンジンの動作を正規表現の開発者が制御することにもなります。 この責任を認識していない開発者によるバックトラッキングの誤用や過度なバックトラッキングへの依存が、多くの場合、正規表現のパフォーマンスを低下させる最大の要因になっています。 最悪のシナリオでは、入力文字列が&1; 文字増えるたびに実行時間が倍増することもあります。 実際、バックトラッキングを過度に使用すると、入力が正規表現パターンにほぼ一致する場合に、プログラム的に無限ループと同等の状態に陥りやすくなります。そのような状態では、正規表現エンジンによる比較的短い入力文字列の処理に何時間も何日もかかることがあります。
-
-照合に必要でないにもかかわらずバックトラッキングを使用した代償として、アプリケーションのパフォーマンスが低下することもよくあります。 例として、`\b\p{Lu}\w*\b` という正規表現について見てみましょう。この正規表現は、次の表に示すように、大文字で始まるすべての単語に一致します。
-
-パターン | 説明
-------- | -----------
-`\b` | ワード境界から照合を開始します。
-`\p{Lu}` | 大文字に一致します。
-`\w*` | 0 個以上の単語に使用される文字に一致します。
-`\b` | ワード境界で照合を終了します。
- 
-ワード境界は単語文字と同じではなく、単語文字のサブセットでもないため、正規表現エンジンが単語文字の照合中にワード境界を越える可能性はありません。 したがって、この正規表現では、バックトラッキングが照合の全体的な成功に寄与することはありません。バックトラッキングを使用すると、正規表現エンジンが単語文字の照合に成功するたびに状態を保存しなければならなくなるため、パフォーマンスを低下させるだけです。
-
-バックトラッキングが不要であることがわかった場合は、**(?>**_subexpression_**)** 言語要素を使用して無効にすることができます。 次の例では、2 つの正規表現を使用して入力文字列を解析しています。 1 つはバックトラッキングに依存する `\b\p{Lu}\w*\b`、 もう&1; つはバックトラッキングを無効にする `\b\p{Lu}(?>\w*)\b` です。 出力を見るとわかるように、どちらも結果は同じになります。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string input = "This this word Sentence name Capital";
-      string pattern = @"\b\p{Lu}\w*\b";
-      foreach (Match match in Regex.Matches(input, pattern))
-         Console.WriteLine(match.Value);
-
-      Console.WriteLine();
-
-      pattern = @"\b\p{Lu}(?>\w*)\b";   
-      foreach (Match match in Regex.Matches(input, pattern))
-         Console.WriteLine(match.Value);
-   }
-}
-// The example displays the following output:
-//       This
-//       Sentence
-//       Capital
-//       
-//       This
-//       Sentence
-//       Capital
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim input As String = "This this word Sentence name Capital"
-      Dim pattern As String = "\b\p{Lu}\w*\b"
-      For Each match As Match In Regex.Matches(input, pattern)
-         Console.WriteLine(match.Value)
-      Next
-      Console.WriteLine()
-
-      pattern = "\b\p{Lu}(?>\w*)\b"   
-      For Each match As Match In Regex.Matches(input, pattern)
-         Console.WriteLine(match.Value)
-      Next
-   End Sub
-End Module
-' The example displays the following output:
-'       This
-'       Sentence
-'       Capital
-'       
-'       This
-'       Sentence
-'       Capital
-```
-
-正規表現パターンと入力テキストの照合にバックトラッキングが欠かせない場合もよくあります。 ただし、過度なバックトラッキングが発生すると、極端にパフォーマンスが低下して、アプリケーションが応答しなくなったように見えることがあります。 この状況が発生するのは、たとえば、量指定子が入れ子になっていて、外側の部分式に一致するテキストが内側の部分式に一致するテキストのサブセットになっている場合です。 
-
+>  バックトラッキングの詳細については、「[正規表現の動作の詳細](../../../docs/standard/base-types/details-of-regular-expression-behavior.md)」と「[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)」を参照してください。  バックトラッキングに関する詳細な議論については、BCL チームのブログの「[正規表現のパフォーマンスの最適化、パート II: バックトラッキングの管理](http://go.microsoft.com/fwlink/?LinkId=211567)」を参照してください。  
+  
+ バックトラッキングのサポートにより、正規表現はより強力かつ柔軟になります。  同時に、正規表現エンジンの動作を正規表現の開発者が制御することにもなります。  この責任を認識していない開発者によるバックトラッキングの誤用や過度なバックトラッキングへの依存が、多くの場合、正規表現のパフォーマンスを低下させる最大の要因になっています。  最悪のシナリオでは、入力文字列が 1 文字増えるたびに実行時間が倍増することもあります。  実際、バックトラッキングを過度に使用すると、入力が正規表現パターンにほぼ一致する場合に、プログラム的に無限ループと同等の状態に陥りやすくなります。そのような状態では、正規表現エンジンによる比較的短い入力文字列の処理に何時間も何日もかかることがあります。  
+  
+ 照合に必要でないにもかかわらずバックトラッキングを使用した代償として、アプリケーションのパフォーマンスが低下することもよくあります。  例として、`\b\p{Lu}\w*\b` という正規表現について見てみましょう。この正規表現は、次の表に示すように、大文字で始まるすべての単語に一致します。  
+  
+|||  
+|-|-|  
+|パターン|説明|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\p{Lu}`|大文字に一致します。|  
+|`\w*`|0 個以上の単語に使用される文字に一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ ワード境界は単語文字と同じではなく、単語文字のサブセットでもないため、正規表現エンジンが単語文字の照合中にワード境界を越える可能性はありません。  したがって、この正規表現では、バックトラッキングが照合の全体的な成功に寄与することはありません。バックトラッキングを使用すると、正規表現エンジンが単語文字の照合に成功するたびに状態を保存しなければならなくなるため、パフォーマンスを低下させるだけです。  
+  
+ バックトラッキングが不要であることがわかった場合は、`(?>``subexpression``)` 言語要素を使用して無効にすることができます。  次の例では、2 つの正規表現を使用して入力文字列を解析しています。  1 つはバックトラッキングに依存する `\b\p{Lu}\w*\b`、  もう 1 つはバックトラッキングを無効にする `\b\p{Lu}(?>\w*)\b` です。  出力を見るとわかるように、どちらも結果は同じになります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/backtrack2.cs#10)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/backtrack2.vb#10)]  
+  
+ 正規表現パターンと入力テキストの照合にバックトラッキングが欠かせない場合もよくあります。  ただし、過度なバックトラッキングが発生すると、極端にパフォーマンスが低下して、アプリケーションが応答しなくなったように見えることがあります。  この状況が発生するのは、たとえば、量指定子が入れ子になっていて、外側の部分式に一致するテキストが内側の部分式に一致するテキストのサブセットになっている場合です。  
+  
 > [!WARNING]
-> 過度なバックトラッキングの回避に加えて、タイムアウト機能を使用して、過度なバックトラッキングによって、正規表現のパフォーマンスが極端に低下するのを防ぐ必要があります。 詳細については、「[タイムアウト値を使用する](#use-time-out-values)」を参照してください。
- 
-例として、部品番号に一致するように作られた `^[0-9A-Z]([-.\w]*[0-9A-Z])*\$$` という正規表現パターンについて見てみましょう。この部品番号は、少なくとも&1; 文字の英数字で構成されます。 追加の文字では、英数字、ハイフン、アンダースコア、およびピリオドが許容されますが、最後の文字は英数字でなければなりません。 部品番号の終わりはドル記号で示されます。 この正規表現パターンは、量指定子が入れ子になっているうえに、部分式 `[0-9A-Z]` が部分式 `[-.\w]*` のサブセットであるため、パフォーマンスが極端に低下する可能性があります。
-
-このような場合に正規表現のパフォーマンスを最適化するには、入れ子になった量指定子を削除して、外側の部分式をゼロ幅の先読みアサーションまたは後読みアサーションに置き換えます。 先読みアサーションと後読みアサーションはアンカーなので、入力文字列内でポインターを移動させることなく、先読みまたは後読みによって、指定された条件が満たされているかどうかを確認します。 たとえば、この部品番号の正規表現は `^[0-9A-Z][-.\w]*(?<=[0-9A-Z])\$$` として書き直すことができます。 この正規表現パターンは、次の表に示すように定義されます。
-
-パターン | 説明
-------- | -----------
-`^` | 入力文字列の先頭から照合を開始します。
-`[0-9A-Z]` | 英数字&1; 文字に一致します。 これは、部品番号に最低限必要な文字です。
-`[-.\w]*` | 任意の単語文字、ハイフン、またはピリオドの&0; 回以上の出現に一致します。
-`\$] | ドル記号に一致します。
-`(?<=[0-9A-Z])` | 末尾のドル記号を先読みし、前の文字が英数字であることを確認します。
-`$` 入力文字列の末尾で照合を終了します。
- 
-次の例では、この正規表現を使用して、部品番号を含む配列を照合しています。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string pattern = @"^[0-9A-Z][-.\w]*(?<=[0-9A-Z])\$$";
-      string[] partNos = { "A1C$", "A4", "A4$", "A1603D$", "A1603D#" };
-
-      foreach (var input in partNos) {
-         Match match = Regex.Match(input, pattern);
-         if (match.Success)
-            Console.WriteLine(match.Value);
-         else
-            Console.WriteLine("Match not found.");
-      }      
-   }
-}
-// The example displays the following output:
-//       A1C$
-//       Match not found.
-//       A4$
-//       A1603D$
-//       Match not found.
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim pattern As String = "^[0-9A-Z][-.\w]*(?<=[0-9A-Z])\$$"
-      Dim partNos() As String = { "A1C$", "A4", "A4$", "A1603D$", 
-                                  "A1603D#" }
-
-      For Each input As String In partNos
-         Dim match As Match = Regex.Match(input, pattern)
-         If match.Success Then
-            Console.WriteLine(match.Value)
-         Else
-            Console.WriteLine("Match not found.")
-         End If
-      Next      
-   End Sub
-End Module
-' The example displays the following output:
-'       A1C$
-'       Match not found.
-'       A4$
-'       A1603D$
-'       Match not found.
-```
-
-.NET の正規表現言語には、入れ子になった量指定子を取り除くために使用できる次の言語要素が含まれています。 詳細については、「[正規表現でのグループ化構成体](grouping.md)」を参照してください。
-
-言語要素 | 説明
----------------- | ----------- 
-**(?**=_subexpression_**)** | ゼロ幅の肯定先読みです。 現在の位置からの先読みにより、*subexpression* が入力文字列に一致するかどうかを確認します。
-**(?!**_subexpression_**)** | ゼロ幅の否定先読みです。 現在の位置からの先読みにより、*subexpression* が入力文字列に一致しないかどうかを確認します。
-**(?<**=_subexpression_**)** | ゼロ幅の肯定後読みです。 現在の位置からの後読みにより、*subexpression* が入力文字列に一致するかどうかを確認します。
-**(?<!**_subexpression_**)** | ゼロ幅の否定後読みです。 現在の位置からの後読みにより、*subexpression* が入力文字列に一致しないかどうかを確認します。
- 
-## <a name="use-time-out-values"></a>タイムアウト値を使用する
-
-正規表現が正規表現パターンにほぼ一致する入力を処理する場合は、パフォーマンスに大きな影響を与える過度なバックトラッキングに依存することがよくあります。 慎重にバックトラッキングの使用を検討し、ほぼ一致する入力に対して正規表現をテストすることに加えて、過度なバックトラッキングが発生した場合にその影響を確実に最小限に抑えるために、必ずタイムアウト値を設定する必要があります。
-
-正規表現のタイムアウト間隔は、タイムアウトする前に正規表現エンジンが単一の一致を検索する期間を定義します。 既定のタイムアウト間隔は [Regex.InfiniteMatchTimeout](xref:System.Text.RegularExpressions.Regex.InfiniteMatchTimeout) で、正規表現がタイムアウトしないことを意味します。 次のようにこの値をオーバーライドし、タイムアウト間隔を定義できます。 
-
-* [Regex(String, RegexOptions, TimeSpan)](xref:System.Text.RegularExpressions.Regex.%23ctor(System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan)) コンストラクターを呼び出すことによって、[Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトをインスタンス化するときに、タイムアウト値を指定します。
-
-* [Regex.Match(String, String, RegexOptions, TimeSpan)](xref:System.Text.RegularExpressions.Regex.Match(System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan))、[Regex.Replace(String, String, String, RegexOptions, TimeSpan)](xref:System.Text.RegularExpressions.Regex.Replace(System.String,System.String,System.String,System.Text.RegularExpressions.RegexOptions,System.TimeSpan)) など、*matchTimeout* パラメーターを含む静的パターン一致メソッドを呼び出します。
-
-タイムアウト間隔を定義していて、その間隔の終了時に一致が見つからない場合、正規表現メソッドは [RegexMatchTimeoutException](xref:System.Text.RegularExpressions.RegexMatchTimeoutException) 例外をスローします。 例外ハンドラーで、タイムアウト間隔を延長して一致を再試行する、一致操作を破棄して一致なしと見なす、または一致操作を破棄して今後の分析のために例外情報を記録することを選択できます。
-
-次の例では、テキスト ドキュメントの単語の数と 1 つの単語に含まれる平均文字数を計算するために、タイムアウト間隔が 350 ミリ秒の正規表現をインスタンス化する `GetWordData` メソッドを定義します。 一致操作がタイムアウトした場合、タイムアウト間隔は 350 ミリ秒ずつ延長され、[Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトが再インスタンス化されます。 新しいタイムアウト間隔が 1 秒を超える場合、メソッドは呼び出し元に例外を再スローします。
-
-```csharp
-using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      RegexUtilities util = new RegexUtilities();
-      string title = "Doyle - The Hound of the Baskervilles.txt";
-      try {
-         var info = util.GetWordData(title);
-         Console.WriteLine("Words:               {0:N0}", info.Item1);
-         Console.WriteLine("Average Word Length: {0:N2} characters", info.Item2); 
-      }
-      catch (IOException e) {
-         Console.WriteLine("IOException reading file '{0}'", title);
-         Console.WriteLine(e.Message);
-      }
-      catch (RegexMatchTimeoutException e) {
-         Console.WriteLine("The operation timed out after {0:N0} milliseconds", 
-                           e.MatchTimeout.TotalMilliseconds);
-      }
-   }
-}
-
-public class RegexUtilities
-{
-   public Tuple<int, double> GetWordData(string filename)
-   { 
-      const int MAX_TIMEOUT = 1000;   // Maximum timeout interval in milliseconds.
-      const int INCREMENT = 350;      // Milliseconds increment of timeout.
-
-      List<string> exclusions = new List<string>( new string[] { "a", "an", "the" });
-      int[] wordLengths = new int[29];        // Allocate an array of more than ample size.
-      string input = null;
-      StreamReader sr = null;
-      try { 
-         sr = new StreamReader(filename);
-         input = sr.ReadToEnd();
-      }
-      catch (FileNotFoundException e) {
-         string msg = String.Format("Unable to find the file '{0}'", filename);
-         throw new IOException(msg, e);
-      }
-      catch (IOException e) {
-         throw new IOException(e.Message, e);
-      }
-      finally {
-         if (sr != null) sr.Close(); 
-      }
-
-      int timeoutInterval = INCREMENT;
-      bool init = false;
-      Regex rgx = null;
-      Match m = null;
-      int indexPos = 0;  
-      do {
-         try {
-            if (! init) {
-               rgx = new Regex(@"\b\w+\b", RegexOptions.None, 
-                               TimeSpan.FromMilliseconds(timeoutInterval));
-               m = rgx.Match(input, indexPos);
-               init = true;
-            }
-            else { 
-               m = m.NextMatch();
-            }
-            if (m.Success) {    
-               if ( !exclusions.Contains(m.Value.ToLower()))
-                  wordLengths[m.Value.Length]++;
-
-               indexPos += m.Length + 1;   
-            }
-         }
-         catch (RegexMatchTimeoutException e) {
-            if (e.MatchTimeout.TotalMilliseconds < MAX_TIMEOUT) {
-               timeoutInterval += INCREMENT;
-               init = false;
-            }
-            else {
-               // Rethrow the exception.
-               throw; 
-            }   
-         }          
-      } while (m.Success);
-
-      // If regex completed successfully, calculate number of words and average length.
-      int nWords = 0; 
-      long totalLength = 0;
-
-      for (int ctr = wordLengths.GetLowerBound(0); ctr <= wordLengths.GetUpperBound(0); ctr++) {
-         nWords += wordLengths[ctr];
-         totalLength += ctr * wordLengths[ctr];
-      }
-      return new Tuple<int, double>(nWords, totalLength/nWords);
-   }
-}
-```
-
-```vb
-Imports System.Collections.Generic
-Imports System.IO
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim util As New RegexUtilities()
-      Dim title As String = "Doyle - The Hound of the Baskervilles.txt"
-      Try
-         Dim info = util.GetWordData(title)
-         Console.WriteLine("Words:               {0:N0}", info.Item1)
-         Console.WriteLine("Average Word Length: {0:N2} characters", info.Item2) 
-      Catch e As IOException
-         Console.WriteLine("IOException reading file '{0}'", title)
-         Console.WriteLine(e.Message)
-      Catch e As RegexMatchTimeoutException
-         Console.WriteLine("The operation timed out after {0:N0} milliseconds", 
-                           e.MatchTimeout.TotalMilliseconds)
-      End Try
-   End Sub
-End Module
-
-Public Class RegexUtilities
-   Public Function GetWordData(filename As String) As Tuple(Of Integer, Double) 
-      Const MAX_TIMEOUT As Integer = 1000  ' Maximum timeout interval in milliseconds.
-      Const INCREMENT As Integer = 350     ' Milliseconds increment of timeout.
-
-      Dim exclusions As New List(Of String)({"a", "an", "the" })
-      Dim wordLengths(30) As Integer        ' Allocate an array of more than ample size.
-      Dim input As String = Nothing
-      Dim sr As StreamReader = Nothing
-      Try 
-         sr = New StreamReader(filename)
-         input = sr.ReadToEnd()
-      Catch e As FileNotFoundException
-         Dim msg As String = String.Format("Unable to find the file '{0}'", filename)
-         Throw New IOException(msg, e)
-      Catch e As IOException
-         Throw New IOException(e.Message, e)
-      Finally
-         If sr IsNot Nothing Then sr.Close() 
-      End Try
-
-      Dim timeoutInterval As Integer = INCREMENT
-      Dim init As Boolean = False
-      Dim rgx As Regex = Nothing
-      Dim m As Match = Nothing
-      Dim indexPos As Integer = 0  
-      Do
-         Try
-            If Not init Then
-               rgx = New Regex("\b\w+\b", RegexOptions.None, 
-                               TimeSpan.FromMilliseconds(timeoutInterval))
-               m = rgx.Match(input, indexPos)
-               init = True
-            Else 
-               m = m.NextMatch()
-            End If
-            If m.Success Then    
-               If Not exclusions.Contains(m.Value.ToLower()) Then
-                  wordLengths(m.Value.Length) += 1
-               End If
-               indexPos += m.Length + 1   
-            End If
-         Catch e As RegexMatchTimeoutException
-            If e.MatchTimeout.TotalMilliseconds < MAX_TIMEOUT Then
-               timeoutInterval += INCREMENT
-               init = False
-            Else
-               ' Rethrow the exception.
-               Throw 
-            End If   
-         End Try          
-      Loop While m.Success
-
-      ' If regex completed successfully, calculate number of words and average length.
-      Dim nWords As Integer
-      Dim totalLength As Long
-
-      For ctr As Integer = wordLengths.GetLowerBound(0) To wordLengths.GetUpperBound(0)
-         nWords += wordLengths(ctr)
-         totalLength += ctr * wordLengths(ctr)
-      Next
-      Return New Tuple(Of Integer, Double)(nWords, totalLength/nWords)
-   End Function
-End Class
-```
-
-## <a name="capture-only-when-necessary"></a>必要なときにのみキャプチャする
-
-.NET の正規表現では、数多くのグループ化構成体がサポートされています。これらを使用すると、正規表現パターンを&1; つ以上の部分式にグループ化することができます。 .NET の正規表現言語で最もよく使用されるグループ化構成体は、番号付きのキャプチャ グループを定義する **(**_subexpression_**)** と、名前付きのキャプチャ グループを定義する **(?<*_name_**>**_subexpression_**)** です。 グループ化構成体は、前方参照を作成したり、量指定子を適用する部分式を定義したりするのに欠かせません。 
-
-しかし、これらの言語要素の使用にはコストが伴います。 まず、[Match.Groups](xref:System.Text.RegularExpressions.Match.Groups) プロパティから返される [GroupCollection](xref:System.Text.RegularExpressions.GroupCollection) オブジェクトに、最新の名前のないキャプチャまたは名前付きキャプチャが設定されます。また、1 つのグループ化構成体によって入力文字列の複数の部分文字列がキャプチャされた場合は、特定のキャプチャ グループの [Group.Captures](xref:System.Text.RegularExpressions.Group.Captures) プロパティから返される [CaptureCollection](xref:System.Text.RegularExpressions.CaptureCollection) オブジェクトに複数の [Capture](xref:System.Text.RegularExpressions.Capture) オブジェクトが設定されます。
-
-正規表現内で量指定子を適用できるようにするためだけにグループ化構成体が使用されていて、それらの部分式によってキャプチャされたグループがその後に使用されていない場合もよくあります。 例として、文全体をキャプチャするために作られた正規表現 `\b(\w+[;,]?\s?)+[.?!]` について見てみましょう。 次の表は、この正規表現パターン内の言語要素と、[Match](xref:System.Text.RegularExpressions.Match) オブジェクトの [Match.Groups](xref:System.Text.RegularExpressions.Match.Groups) コレクションおよび [Group.Captures](xref:System.Text.RegularExpressions.Group.Captures) コレクションに対する影響を示しています。
-
-パターン | 説明
-------- | -----------
-`\b` | ワード境界から照合を開始します。
-`\w+` | 1 つ以上の単語文字に一致します。
-`[;,]?` | 0 個または&1; 個のコンマまたはセミコロンに一致します。
-`\s?` | 0 個または&1; 個の空白文字と一致します。
-`(\w+[;,]?\s?)+` | 1 個以上の単語文字の後に省略可能なコンマまたはセミコロンと省略可能な空白文字が続くパターンの&1; 回以上の出現に一致します。 これにより、最初のキャプチャ グループが定義されます。このグループは、複数の単語文字の組み合わせ (つまり単語) の後に省略可能な区切り記号が続くパターンが、正規表現エンジンが文の終わりに到達するまで繰り返されるようにするために必要です。
-`[.?!]` | ピリオド、疑問符、または感嘆符に一致します。
- 
-次の例に示すように、一致が見つかると、[GroupCollection](xref:System.Text.RegularExpressions.GroupCollection) オブジェクトと [CaptureCollection](xref:System.Text.RegularExpressions.CaptureCollection) オブジェクトの両方に一致からのキャプチャが設定されます。 ここでは、**+** 量指定子を適用できるようにするためにキャプチャ グループ `(\w+[;,]?\s?)` が使用されているため、正規表現パターンが文の各単語に一致します。 そうでない場合は、文の最後の単語に一致します。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string input = "This is one sentence. This is another.";
-      string pattern = @"\b(\w+[;,]?\s?)+[.?!]";
-
-      foreach (Match match in Regex.Matches(input, pattern)) {
-         Console.WriteLine("Match: '{0}' at index {1}.", 
-                           match.Value, match.Index);
-         int grpCtr = 0;
-         foreach (Group grp in match.Groups) {
-            Console.WriteLine("   Group {0}: '{1}' at index {2}.",
-                              grpCtr, grp.Value, grp.Index);
-            int capCtr = 0;
-            foreach (Capture cap in grp.Captures) {
-               Console.WriteLine("      Capture {0}: '{1}' at {2}.",
-                                 capCtr, cap.Value, cap.Index);
-               capCtr++;
-            }
-            grpCtr++;
-         }          
-         Console.WriteLine();        
-      }
-   }
-}
-// The example displays the following output:
-//       Match: 'This is one sentence.' at index 0.
-//          Group 0: 'This is one sentence.' at index 0.
-//             Capture 0: 'This is one sentence.' at 0.
-//          Group 1: 'sentence' at index 12.
-//             Capture 0: 'This ' at 0.
-//             Capture 1: 'is ' at 5.
-//             Capture 2: 'one ' at 8.
-//             Capture 3: 'sentence' at 12.
-//       
-//       Match: 'This is another.' at index 22.
-//          Group 0: 'This is another.' at index 22.
-//             Capture 0: 'This is another.' at 22.
-//          Group 1: 'another' at index 30.
-//             Capture 0: 'This ' at 22.
-//             Capture 1: 'is ' at 27.
-//             Capture 2: 'another' at 30.
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim input As String = "This is one sentence. This is another."
-      Dim pattern As String = "\b(\w+[;,]?\s?)+[.?!]"
-
-      For Each match As Match In Regex.Matches(input, pattern)
-         Console.WriteLine("Match: '{0}' at index {1}.", 
-                           match.Value, match.Index)
-         Dim grpCtr As Integer = 0
-         For Each grp As Group In match.Groups
-            Console.WriteLine("   Group {0}: '{1}' at index {2}.",
-                              grpCtr, grp.Value, grp.Index)
-            Dim capCtr As Integer = 0
-            For Each cap As Capture In grp.Captures
-               Console.WriteLine("      Capture {0}: '{1}' at {2}.",
-                                 capCtr, cap.Value, cap.Index)
-               capCtr += 1
-            Next
-            grpCtr += 1
-         Next          
-         Console.WriteLine()        
-      Next    
-   End Sub
-End Module
-' The example displays the following output:
-'       Match: 'This is one sentence.' at index 0.
-'          Group 0: 'This is one sentence.' at index 0.
-'             Capture 0: 'This is one sentence.' at 0.
-'          Group 1: 'sentence' at index 12.
-'             Capture 0: 'This ' at 0.
-'             Capture 1: 'is ' at 5.
-'             Capture 2: 'one ' at 8.
-'             Capture 3: 'sentence' at 12.
-'       
-'       Match: 'This is another.' at index 22.
-'          Group 0: 'This is another.' at index 22.
-'             Capture 0: 'This is another.' at 22.
-'          Group 1: 'another' at index 30.
-'             Capture 0: 'This ' at 22.
-'             Capture 1: 'is ' at 27.
-'             Capture 2: 'another' at 30.
-```
-
-量指定子を適用するためだけに部分式を使用していて、キャプチャされたテキストは特に必要ないという場合は、グループ キャプチャを無効にする必要があります。 たとえば、**(?:**_subexpression_**)** 言語要素をグループに適用すると、そのグループでは、一致した部分文字列がキャプチャされなくなります。 次の例では、前の例の正規表現パターンが `\b(?:\w+[;,]?\s?)+[.?!]` に変更されています。 出力を見るとわかるように、これにより、[GroupCollection](xref:System.Text.RegularExpressions.GroupCollection) コレクションと [CaptureCollection](xref:System.Text.RegularExpressions.CaptureCollection) コレクションが設定されなくなります。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string input = "This is one sentence. This is another.";
-      string pattern = @"\b(?:\w+[;,]?\s?)+[.?!]";
-
-      foreach (Match match in Regex.Matches(input, pattern)) {
-         Console.WriteLine("Match: '{0}' at index {1}.", 
-                           match.Value, match.Index);
-         int grpCtr = 0;
-         foreach (Group grp in match.Groups) {
-            Console.WriteLine("   Group {0}: '{1}' at index {2}.",
-                              grpCtr, grp.Value, grp.Index);
-            int capCtr = 0;
-            foreach (Capture cap in grp.Captures) {
-               Console.WriteLine("      Capture {0}: '{1}' at {2}.",
-                                 capCtr, cap.Value, cap.Index);
-               capCtr++;
-            }
-            grpCtr++;
-         }          
-         Console.WriteLine();        
-      }
-   }
-}
-// The example displays the following output:
-//       Match: 'This is one sentence.' at index 0.
-//          Group 0: 'This is one sentence.' at index 0.
-//             Capture 0: 'This is one sentence.' at 0.
-//       
-//       Match: 'This is another.' at index 22.
-//          Group 0: 'This is another.' at index 22.
-//             Capture 0: 'This is another.' at 22.
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim input As String = "This is one sentence. This is another."
-      Dim pattern As String = "\b(?:\w+[;,]?\s?)+[.?!]"
-
-      For Each match As Match In Regex.Matches(input, pattern)
-         Console.WriteLine("Match: '{0}' at index {1}.", 
-                           match.Value, match.Index)
-         Dim grpCtr As Integer = 0
-         For Each grp As Group In match.Groups
-            Console.WriteLine("   Group {0}: '{1}' at index {2}.",
-                              grpCtr, grp.Value, grp.Index)
-            Dim capCtr As Integer = 0
-            For Each cap As Capture In grp.Captures
-               Console.WriteLine("      Capture {0}: '{1}' at {2}.",
-                                 capCtr, cap.Value, cap.Index)
-               capCtr += 1
-            Next
-            grpCtr += 1
-         Next          
-         Console.WriteLine()        
-      Next    
-   End Sub
-End Module
-' The example displays the following output:
-'       Match: 'This is one sentence.' at index 0.
-'          Group 0: 'This is one sentence.' at index 0.
-'             Capture 0: 'This is one sentence.' at 0.
-'       
-'       Match: 'This is another.' at index 22.
-'          Group 0: 'This is another.' at index 22.
-'             Capture 0: 'This is another.' at 22.
-```
-
-キャプチャを無効にするには次のような方法があります。
-
-* **(?:**_subexpression_**)** 言語要素を使用します。 この要素をグループに適用すると、そのグループでは、一致した部分文字列がキャプチャされなくなります。 入れ子になったグループによる部分文字列のキャプチャは無効になりません。
-
-* [RegexOptions.ExplicitCapture](xref:System.Text.RegularExpressions.RegexOptions.ExplicitCapture) オプションを使用します。 これにより、正規表現パターン内の名前のないキャプチャ (暗黙的なキャプチャ) がすべて無効になります。 このオプションを使用した場合は、**(?<**_name_**>**_subexpression_**)** 言語要素を使用して定義した名前付きグループに一致する部分文字列のみがキャプチャされます。 [ExplicitCapture](xref:System.Text.RegularExpressions.RegexOptions.ExplicitCapture) フラグは、[Regex](xref:System.Text.RegularExpressions.Regex) クラス コンストラクターの options パラメーターか、[Regex](xref:System.Text.RegularExpressions.Regex) の静的な一致メソッドの options パラメーターに渡すことができます。
-
-* **(?imnsx)** 言語要素の **n** オプションを使用します。 これにより、正規表現パターンでこの要素が出現する位置以降の名前のないキャプチャ (暗黙的なキャプチャ) がすべて無効になります。 パターンの末尾に到達するか、**(-n)** オプションによって名前のないキャプチャ (暗黙的なキャプチャ) が有効になるまで、キャプチャは無効のままです。 詳細については、「[正規表現でのその他の構成体](miscellaneous.md)」を参照してください。
-
-* **(?imnsx:**_subexpression_**)** 言語要素の **n** オプションを使用します。 これにより、*subexpression* 内の名前のないキャプチャ (暗黙的なキャプチャ) がすべて無効になります。 入れ子になった名前のない (暗黙的な) キャプチャ グループによるキャプチャも無効になります。
-
-## <a name="related-topics"></a>関連トピック
-
-タイトル | 説明
------ | ----------- 
-[正規表現の動作の詳細](regex-behavior.md) | .NET の正規表現エンジンの実装について検討します。 正規表現の柔軟性に焦点を当てて、正規表現エンジンの効率的かつ堅牢な動作を確保するための開発者の責任について説明します。
-[正規表現におけるバックトラッキング](backtracking.md) | バックトラッキングの概要と、正規表現のパフォーマンスに与える影響について説明し、バックトラッキングの代わりに使用できる言語要素について検討します。
-[正規表現言語 - クイック リファレンス](quick-ref.md) | .NET の正規表現言語の言語要素について説明します。各言語要素の詳細な説明へのリンクも含まれています。
- 
-
-
+>  過度なバックトラッキングの回避に加えて、タイムアウト機能を使用して、過度なバックトラッキングによって、正規表現のパフォーマンスが極端に低下するのを防ぐ必要があります。  詳細については、「[タイムアウト値を使用する](#Timeouts)」を参照してください。  
+  
+ 例として、部品番号に一致するように作られた `^[0-9A-Z]([-.\w]*[0-9A-Z])*\$$` という正規表現パターンについて見てみましょう。この部品番号は、少なくとも 1 文字の英数字で構成されます。  追加の文字では、英数字、ハイフン、アンダースコア、およびピリオドが許容されますが、最後の文字は英数字でなければなりません。  部品番号の終わりはドル記号で示されます。  この正規表現パターンは、量指定子が入れ子になっているうえに、部分式 `[0-9A-Z]` が部分式 `[-.\w]*` のサブセットであるため、パフォーマンスが極端に低下する可能性があります。  
+  
+ このような場合に正規表現のパフォーマンスを最適化するには、入れ子になった量指定子を削除して、外側の部分式をゼロ幅の先読みアサーションまたは後読みアサーションに置き換えます。  先読みアサーションと後読みアサーションはアンカーなので、入力文字列内でポインターを移動させることなく、先読みまたは後読みによって、指定された条件が満たされているかどうかを確認します。  たとえば、この部品番号の正規表現は `^[0-9A-Z][-.\w]*(?<=[0-9A-Z])\$$` として書き直すことができます。  この正規表現パターンは、次の表に示すように定義されます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力文字列の先頭から照合を開始します。|  
+|`[0-9A-Z]`|英数字 1 文字に一致します。  これは、部品番号に最低限必要な文字です。|  
+|`[-.  \w]*`|任意の単語文字、ハイフン、またはピリオドの 0 回以上の出現に一致します。|  
+|`\$`|ドル記号に一致します。|  
+|`(?<=[0-9A-Z])`|末尾のドル記号を先読みし、前の文字が英数字であることを確認します。|  
+|`$`|入力文字列の末尾で照合を終了します。|  
+  
+ 次の例では、この正規表現を使用して、部品番号を含む配列を照合しています。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/backtrack4.cs#11)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/backtrack4.vb#11)]  
+  
+ .NET Framework の正規表現言語には、入れ子になった量指定子を取り除くために使用できる次の言語要素が含まれています。  詳しくは、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+|言語要素|説明|  
+|----------|--------|  
+|`(?=` `subexpression` `)`|ゼロ幅の肯定先読みです。  現在の位置からの先読みにより、`subexpression` が入力文字列に一致するかどうかを確認します。|  
+|`(?!` `subexpression` `)`|ゼロ幅の否定先読みです。  現在の位置からの先読みにより、`subexpression` が入力文字列に一致しないかどうかを確認します。|  
+|`(?<=` `subexpression` `)`|ゼロ幅の肯定後読みです。  現在の位置からの後読みにより、`subexpression` が入力文字列に一致するかどうかを確認します。|  
+|`(?<!` `subexpression` `)`|ゼロ幅の否定後読みです。  現在の位置からの後読みにより、`subexpression` が入力文字列に一致しないかどうかを確認します。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Timeouts"></a>   
+## タイムアウト値を使用する  
+ 正規表現が正規表現パターンにほぼ一致する入力を処理する場合は、パフォーマンスに大きな影響を与える過度なバックトラッキングに依存することがよくあります。  慎重にバックトラッキングの使用を検討し、ほぼ一致する入力に対して正規表現をテストすることに加えて、過度なバックトラッキングが発生した場合にその影響を確実に最小限に抑えるために、必ずタイムアウト値を設定する必要があります。  
+  
+ 正規表現のタイムアウト間隔は、タイムアウトする前に正規表現エンジンが単一の一致を検索する期間を定義します。  既定のタイムアウト間隔は <xref:System.Text.RegularExpressions.Regex.InfiniteMatchTimeout?displayProperty=fullName> で、正規表現がタイムアウトしないことを意味します。  次のようにこの値をオーバーライドし、タイムアウト間隔を定義できます。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> コンストラクターを呼び出すことによって、<xref:System.Text.RegularExpressions.Regex.%23ctor%28System.String%2CSystem.Text.RegularExpressions.RegexOptions%2CSystem.TimeSpan%29?displayProperty=fullName> オブジェクトをインスタンス化するときに、タイムアウト値を指定します。  
+  
+-   <xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%2CSystem.TimeSpan%29?displayProperty=fullName>、<xref:System.Text.RegularExpressions.Regex.Replace%28System.String%2CSystem.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%2CSystem.TimeSpan%29?displayProperty=fullName> など、`matchTimeout` パラメーターを含む静的パターン一致メソッドを呼び出します。  
+  
+-   <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName> メソッドを呼び出すことによって作成されるコンパイルされる正規表現の場合、<xref:System.TimeSpan> 型のパラメーターを持つコンストラクターを呼び出します。  
+  
+ タイムアウト間隔を定義していて、その間隔の終了時に一致が見つからない場合、正規表現メソッドは <xref:System.Text.RegularExpressions.RegexMatchTimeoutException> 例外をスローします。  例外ハンドラーで、タイムアウト間隔を延長して一致を再試行する、一致操作を破棄して一致なしと見なす、または一致操作を破棄して今後の分析のために例外情報を記録することを選択できます。  
+  
+ 次の例では、テキスト ドキュメントの単語の数と 1 つの単語に含まれる平均文字数を計算するために、タイムアウト間隔が 350 ミリ秒の正規表現をインスタンス化する `GetWordData` メソッドを定義します。  一致操作がタイムアウトした場合、タイムアウト間隔は 350 ミリ秒ずつ延長され、<xref:System.Text.RegularExpressions.Regex> オブジェクトが再インスタンス化されます。  新しいタイムアウト間隔が 1 秒を超える場合、メソッドは呼び出し元に例外を再スローします。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/timeout1.cs#12)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/timeout1.vb#12)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="Capture"></a>   
+## 必要なときにのみキャプチャする  
+ .NET Framework の正規表現では、数多くのグループ化構成体がサポートされています。これらを使用すると、正規表現パターンを 1 つ以上の部分式にグループ化することができます。  .NET Framework の正規表現言語で最もよく使用されるグループ化構成体は、番号付きのキャプチャ グループを定義する `(`*subexpression*`)` と、名前付きのキャプチャ グループを定義する `(?<`*name*`>`*subexpression*`)` です。  グループ化構成体は、前方参照を作成したり、量指定子を適用する部分式を定義したりするのに欠かせません。  
+  
+ しかし、これらの言語要素の使用にはコストが伴います。  まず、<xref:System.Text.RegularExpressions.GroupCollection> プロパティから返される <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> オブジェクトに、最新の名前のないキャプチャまたは名前付きキャプチャが設定されます。また、1 つのグループ化構成体によって入力文字列の複数の部分文字列がキャプチャされた場合は、特定のキャプチャ グループの <xref:System.Text.RegularExpressions.CaptureCollection> プロパティから返される <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> オブジェクトに複数の <xref:System.Text.RegularExpressions.Capture> オブジェクトが設定されます。  
+  
+ 正規表現内で量指定子を適用できるようにするためだけにグループ化構成体が使用されていて、それらの部分式によってキャプチャされたグループがその後に使用されていない場合もよくあります。  例として、文全体をキャプチャするために作られた正規表現 `\b(\w+[;,]?\s?)+[.?!]` について見てみましょう。  次の表は、この正規表現パターン内の言語要素と、<xref:System.Text.RegularExpressions.Match> オブジェクトの <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> コレクションおよび <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> コレクションに対する影響を示しています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`[;,]?`|0 個または 1 個のコンマまたはセミコロンに一致します。|  
+|`\s?`|0 個または 1 個の空白文字と一致します。|  
+|`(\w+[;,]?  \s?)+`|1 個以上の単語文字の後に省略可能なコンマまたはセミコロンと省略可能な空白文字が続くパターンの 1 回以上の出現に一致します。  これにより、最初のキャプチャ グループが定義されます。このグループは、複数の単語文字の組み合わせ \(つまり単語\) の後に省略可能な区切り記号が続くパターンが、正規表現エンジンが文の終わりに到達するまで繰り返されるようにするために必要です。|  
+|`[.?!]`|ピリオド、疑問符、または感嘆符に一致します。|  
+  
+ 次の例に示すように、一致が見つかると、<xref:System.Text.RegularExpressions.GroupCollection> オブジェクトと <xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトの両方に一致からのキャプチャが設定されます。  ここでは、`(\w+[;,]?\s?)` 量指定子を適用できるようにするためにキャプチャ グループ `+` が使用されているため、正規表現パターンが文の各単語に一致します。  そうでない場合は、文の最後の単語に一致します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/group1.cs#8)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/group1.vb#8)]  
+  
+ 量指定子を適用するためだけに部分式を使用していて、キャプチャされたテキストは特に必要ないという場合は、グループ キャプチャを無効にする必要があります。  たとえば、`(?:``subexpression``)` 言語要素をグループに適用すると、そのグループでは、一致した部分文字列がキャプチャされなくなります。  次の例では、前の例の正規表現パターンが `\b(?:\w+[;,]?\s?)+[.?!]` に変更されています。  出力を見るとわかるように、これにより、<xref:System.Text.RegularExpressions.GroupCollection> コレクションと <xref:System.Text.RegularExpressions.CaptureCollection> コレクションが設定されなくなります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.BestPractices#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/cs/group2.cs#9)]
+ [!code-vb[Conceptual.RegularExpressions.BestPractices#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.bestpractices/vb/group2.vb#9)]  
+  
+ キャプチャを無効にするには次のような方法があります。  
+  
+-   `(?:` `subexpression` `)` 言語要素を使用します。  この要素をグループに適用すると、そのグループでは、一致した部分文字列がキャプチャされなくなります。  入れ子になったグループによる部分文字列のキャプチャは無効になりません。  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions> オプションを使用します。  これにより、正規表現パターン内の名前のないキャプチャ \(暗黙的なキャプチャ\) がすべて無効になります。  このオプションを使用した場合は、`(?<``name``>``subexpression``)` 言語要素を使用して定義した名前付きグループに一致する部分文字列のみがキャプチャされます。  <xref:System.Text.RegularExpressions.RegexOptions> フラグは、`options` クラス コンストラクターの <xref:System.Text.RegularExpressions.Regex> パラメーターか、`options` の静的な一致メソッドの <xref:System.Text.RegularExpressions.Regex> パラメーターに渡すことができます。  
+  
+-   `n` 言語要素の `(?imnsx)` オプションを使用します。  これにより、正規表現パターンでこの要素が出現する位置以降の名前のないキャプチャ \(暗黙的なキャプチャ\) がすべて無効になります。  パターンの末尾に到達するか、`(-n)` オプションによって名前のないキャプチャ \(暗黙的なキャプチャ\) が有効になるまで、キャプチャは無効のままです。  詳しくは、「[その他の構成体](../../../docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   `(?imnsx:` `subexpression` `)` 言語要素の `n` オプションを使用します。  これにより、`subexpression` 内の名前のないキャプチャ \(暗黙的なキャプチャ\) がすべて無効になります。  入れ子になった名前のない \(暗黙的な\) キャプチャ グループによるキャプチャも無効になります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="RelatedTopics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[正規表現の動作の詳細](../../../docs/standard/base-types/details-of-regular-expression-behavior.md)|.NET Framework の正規表現エンジンの実装について検討します。  正規表現の柔軟性に焦点を当てて、正規表現エンジンの効率的かつ堅牢な動作を確保するための開発者の責任について説明します。|  
+|[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)|バックトラッキングの概要と、正規表現のパフォーマンスに与える影響について説明し、バックトラッキングの代わりに使用できる言語要素について検討します。|  
+|[正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)|.NET Framework の正規表現言語の言語要素について説明します。各言語要素の詳細な説明へのリンクも含まれています。|
\ No newline at end of file
diff --git a/docs/standard/base-types/changing-case.md b/docs/standard/base-types/changing-case.md
index 6db14c93a1d..b063aed98ba 100644
--- a/docs/standard/base-types/changing-case.md
+++ b/docs/standard/base-types/changing-case.md
@@ -1,77 +1,76 @@
 ---
-title: "大文字と小文字の変更"
-description: "大文字と小文字の変更"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 646c5afd-8aec-4393-9c00-f68ad2580c68
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 023f40969095627242d3652add853eb999c30c4b
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="changing-case"></a>大文字と小文字の変更
-
-ユーザーからの入力を受け付けるアプリケーションを記述する場合、ユーザーがデータ入力に使用するケースを正確に予測することはできません。 多くの場合、特にユーザー インターフェイスにそれを表示する場合には、文字列に一貫性のあるケースを使用することが求められます。 次の表は、2 つのケース変更方式を示しています。
-
-メソッド名 | 使用
------------ | ---
-[String.ToUpper](xref:System.String.ToUpper) | 文字列内のすべての文字を大文字に変換します。
-[String.ToLower](xref:System.String.ToLower) | 文字列内のすべての文字を小文字に変換します。
-
-> [!WARNING]  
-> `String.ToUpper` と `String.ToLower` の方式を使用して、文字列を比較したり等しいかどうかをテストしたりする目的で、それらの文字列を変換するべきではないことに注意してください。 
-
-## <a name="comparing-strings-of-mixed-case"></a>大小混合文字の文字列を比較する
-
-大小混合文字の文字列を比較してそれらが等しいかどうかを判別するには、*comparisonType* パラメーターのある [String](xref:System) `Equals` メソッドのいずれかのオーバーロードを呼び出して、*comparisonType* 引数に [StringComparison.CurrentCultureIgnoreCase](xref:System.StringComparison.CurrentCultureIgnoreCase) または [StringComparison.OrdinalIgnoreCase](xref:System.StringComparison.OrdinalIgnoreCase) の値を指定します。 
-
-詳細については、「[文字列を使用するためのベスト プラクティス](best-practices.md)」を参照してください。 
-
-## <a name="toupper"></a>ToUpper
-
-[String.ToUpper](xref:System.String.ToUpper) メソッドは文字列内のすべての文字を大文字に変換します。 次の例では、文字列 "Hello World!" を 大小混合文字から大文字に変換します。
-
-```csharp
-string properString = "Hello World!";
-Console.WriteLine(properString.ToUpper());
-// This example displays the following output:
-//       HELLO WORLD!
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Console.WriteLine(MyString.ToUpper())
-' This example displays the following output:
-'       HELLO WORLD!
-```
-
-## <a name="tolower"></a>ToLower
-
-[String.ToLower](xref:System.String.ToLower) メソッドは、前のメソッドと似ていますが、代わりに文字列内のすべての文字を小文字に変換します。 次の例では、文字列 "Hello World!" を 小文字に変換します。
-
-```csharp
-string properString = "Hello World!";
-Console.WriteLine(properString.ToLower());
-// This example displays the following output:
-//       hello world!
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Console.WriteLine(MyString.ToLower())
-' This example displays the following output:
-'       hello world!
-```
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
+title: ".NET Framework における大文字と小文字の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "大文字と小文字の区別"
+  - "小文字"
+  - "文字列 [.NET Framework], case"
+  - "ToLower メソッド"
+  - "ToUpper メソッド"
+  - "大文字"
+ms.assetid: 6805f81b-e9ad-4387-9f4c-b9bdb21b87c0
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework における大文字と小文字の変更
+ユーザーからの入力を受け付けるアプリケーションを記述する場合、ユーザーがデータ入力に使用するケースを正確に予測することはできません。  多くの場合、特にユーザー インターフェイスにそれを表示する場合には、文字列に一貫性のあるケースを使用することが求められます。  次の表は、3 つのケース変更方式を示しています。  最初の 2 つの方式は、カルチャを受け入れるオーバーロードを提供します。  
+  
+|メソッド名|用途|  
+|-----------|--------|  
+|<xref:System.String.ToUpper%2A?displayProperty=fullName>|文字列内のすべての文字を大文字に変換します。|  
+|<xref:System.String.ToLower%2A?displayProperty=fullName>|文字列内のすべての文字を小文字に変換します。|  
+|<xref:System.Globalization.TextInfo.ToTitleCase%2A?displayProperty=fullName>|文字列をタイトル ケースに変換します。|  
+  
+> [!WARNING]
+>  <xref:System.String.ToUpper%2A?displayProperty=fullName> と <xref:System.String.ToLower%2A?displayProperty=fullName> の方式を使用して、文字列を比較したり等しいかどうかをテストしたりする目的で、それらの文字列を変換するべきではないことに注意してください。  詳しくは、「[大小混合文字の文字列を比較する](#Comparing)」セクションを参照してください。  
+  
+<a name="Comparing"></a>   
+## 大小混合文字の文字列を比較する  
+ 大小混合文字の文字列を比較してそれらの順序を判別するには、`comparisonType` パラメーターのある <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドのいずれかのオーバーロードを呼び出して、`comparisonType` 引数に <xref:System.StringComparison?displayProperty=fullName>、<xref:System.StringComparison?displayProperty=fullName>、または <xref:System.StringComparison?displayProperty=fullName> の値を指定します。  現在のカルチャ以外の特定のカルチャを使用して比較する場合、`culture` と `options` の両方のパラメーターのある <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドのオーバーロードを呼び出して、`options` 引数に <xref:System.Globalization.CompareOptions?displayProperty=fullName> の値を指定します。  
+  
+ 大小混合文字の文字列を比較してそれらが等しいかどうかを判別するには、`comparisonType` パラメーターのある <xref:System.String.Equals%2A?displayProperty=fullName> メソッドのいずれかのオーバーロードを呼び出して、`comparisonType` 引数に <xref:System.StringComparison?displayProperty=fullName>、<xref:System.StringComparison?displayProperty=fullName>、または <xref:System.StringComparison?displayProperty=fullName> の値を指定します。  
+  
+ 詳しくは、「[文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md)」を参照してください。  
+  
+## ToUpper  
+ <xref:System.String.ToUpper%2A?displayProperty=fullName> メソッドは文字列内のすべての文字を大文字に変換します。  次の例では、文字列 "Hello World\!" を大小混合文字から大文字に変換します。  
+  
+ [!code-csharp[Strings.ChangingCase#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.ChangingCase/cs/Example.cs#1)]
+ [!code-vb[Strings.ChangingCase#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.ChangingCase/vb/Example.vb#1)]  
+  
+ 前の例は、既定でカルチャに依存しています。これには、現在のカルチャのケース表記規則が適用されます。  カルチャに依存しないケース変更を実行したり、特定のカルチャのケース表記規則を適用したりするには、<xref:System.String.ToUpper%28System.Globalization.CultureInfo%29?displayProperty=fullName> メソッドのオーバーロードを使用して、*culture* パラメーターに指定のカルチャを表す <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> または <xref:System.Globalization.CultureInfo?displayProperty=fullName> オブジェクトの値を提供します。  <xref:System.String.ToUpper%2A> メソッドを使用してカルチャに依存しないケース変更を実行する方法を示す例については、「[カルチャを認識しない大文字と小文字の変更の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md)」を参照してください。  
+  
+## ToLower  
+ <xref:System.String.ToLower%2A?displayProperty=fullName> メソッドは、前のメソッドと似ていますが、代わりに文字列内のすべての文字を小文字に変換します。  次の例では、文字列 "Hello World\!" を小文字に変換します。  
+  
+ [!code-csharp[Strings.ChangingCase#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.ChangingCase/cs/Example.cs#2)]
+ [!code-vb[Strings.ChangingCase#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.ChangingCase/vb/Example.vb#2)]  
+  
+ 前の例は、既定でカルチャに依存しています。これには、現在のカルチャのケース表記規則が適用されます。  カルチャに依存しないケース変更を実行したり、特定のカルチャのケース表記規則を適用したりするには、<xref:System.String.ToLower%28System.Globalization.CultureInfo%29?displayProperty=fullName> メソッドのオーバーロードを使用して、*culture* パラメーターに指定のカルチャを表す <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> または <xref:System.Globalization.CultureInfo?displayProperty=fullName> オブジェクトの値を提供します。  <xref:System.String.ToLower%28System.Globalization.CultureInfo%29> メソッドを使用してカルチャに依存しないケース変更を実行する方法を示す例については、「[カルチャを認識しない大文字と小文字の変更の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md)」を参照してください。  
+  
+## ToTitleCase  
+ <xref:System.Globalization.TextInfo.ToTitleCase%2A?displayProperty=fullName> は、各単語の最初の文字を大文字に変換し、残りの文字を小文字に変換します。  ただし、すべて大文字である単語は頭字語であると想定されて、変換されません。  
+  
+ <xref:System.Globalization.TextInfo.ToTitleCase%2A?displayProperty=fullName> メソッドはカルチャに依存しています。つまり、特定のカルチャのケース表記規則を使用します。  メソッドを呼び出すためには、最初に特定のカルチャのケース表記規則を表す <xref:System.Globalization.TextInfo> オブジェクトを、特定のカルチャの <xref:System.Globalization.CultureInfo.TextInfo%2A?displayProperty=fullName> プロパティから取得します。  
+  
+ 次の例は、配列内の各文字列を <xref:System.Globalization.TextInfo.ToTitleCase%2A?displayProperty=fullName> メソッドに渡します。  文字列には、適切なタイトルの文字列と頭字語が含まれています。  文字列は、英語 \(米国\) カルチャのケース表記規則を使用して、タイトル ケースに変換されます。  
+  
+ [!code-csharp[System.Globalization.TextInfo.ToTitleCase#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.globalization.textinfo.totitlecase/cs/totitlecase2.cs#1)]
+ [!code-vb[System.Globalization.TextInfo.ToTitleCase#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.globalization.textinfo.totitlecase/vb/totitlecase2.vb#1)]  
+  
+ カルチャに依存していても、<xref:System.Globalization.TextInfo.ToTitleCase%2A?displayProperty=fullName> メソッドは言語的に正しい大文字小文字の規則を提供しないことに注意してください。  たとえば、前の例で、メソッドは "a tale of two cities" を "A Tale Of Two Cities" に変換します。  しかし、en\-US カルチャで言語的に正しいタイトルの大文字小文字の表記は "A Tale of Two Cities" です。  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/character-classes-in-regular-expressions.md b/docs/standard/base-types/character-classes-in-regular-expressions.md
new file mode 100644
index 00000000000..045e3faff41
--- /dev/null
+++ b/docs/standard/base-types/character-classes-in-regular-expressions.md
@@ -0,0 +1,592 @@
+---
+title: "正規表現での文字クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 文字クラス"
+  - "文字クラス"
+  - "文字, 一致構文"
+  - "正規表現, 文字クラス"
+ms.assetid: 0f8bffab-ee0d-4e0e-9a96-2b4a252bb7e4
+caps.latest.revision: 58
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 52
+---
+# 正規表現での文字クラス
+文字クラスは、いずれかが入力文字列に含まれると一致と見なされる文字のセットを定義します。  .NET Framework の正規表現言語では、次の文字クラスがサポートされます。  
+  
+-   文字グループの肯定。  入力文字列内の文字が指定した文字のセットのいずれかと一致する必要があります。  詳細については、「[文字グループの肯定](#PositiveGroup)」を参照してください。  
+  
+-   文字グループの否定。  入力文字列内の文字が指定した文字のセットのいずれかと一致しない必要があります。  詳細については、「[文字グループの否定](#NegativeGroup)」を参照してください。  
+  
+-   任意の文字。  正規表現の `.` \(ドットまたはピリオド\) 文字は、`\n` を除く任意の文字と一致するワイルドカード文字です。  詳細については、「[任意の文字](#AnyCharacter)」を参照してください。  
+  
+-   Unicode 一般カテゴリまたは名前付きブロック。  入力文字列内の文字が一致と見なされるには、その文字が特定の Unicode カテゴリのメンバーであるか、または Unicode 文字の連続した範囲内に含まれる必要があります。  詳細については、「[Unicode カテゴリまたは Unicode ブロック](#CategoryOrBlock)」を参照してください。  
+  
+-   Unicode 一般カテゴリまたは名前付きブロックの否定。  入力文字列内の文字が一致と見なされるには、その文字が特定の Unicode カテゴリのメンバーでないか、または Unicode 文字の連続した範囲内に含まれない必要があります。  詳細については、「[Unicode カテゴリまたは Unicode ブロックの否定](#NegativeCategoryOrBlock)」を参照してください。  
+  
+-   単語に使用される文字。  入力文字列内の文字が、単語内の文字に適した Unicode カテゴリのいずれかに属することができます。  詳細については、「[単語に使用される文字](#WordCharacter)」を参照してください。  
+  
+-   単語に使用されない文字。  入力文字列内の文字が、単語に使用される文字ではない Unicode カテゴリのいずれかに属することができます。  詳細については、「[単語に使用されない文字](#NonWordCharacter)」を参照してください。  
+  
+-   空白文字。  入力文字列内の文字が、Unicode 区切り記号および各種制御文字のいずれかです。  詳細については、「[空白文字](#WhitespaceCharacter)」を参照してください。  
+  
+-   空白以外の文字。  入力文字列内の文字が、空白文字以外の文字のいずれかです。  詳細については、「[空白以外の文字](#NonWhitespaceCharacter)」を参照してください。  
+  
+-   10 進数。  入力文字列内の文字が、Unicode 10 進数に分類される各種文字のいずれかです。  詳細については、「[10 進数字](#DigitCharacter)」を参照してください。  
+  
+-   10 進数字以外の文字。  入力文字列内の文字が、Unicode 10 進数以外の文字のいずれかです。  詳細については、「[10 進数字](#NonDigitCharacter)」を参照してください。  
+  
+ .NET Framework は、文字クラスの減算式をサポートしています。これにより、ある文字クラスから別の文字クラスを除外した結果を文字のセットとして定義できます。  詳細については、「[文字クラス減算](#CharacterClassSubtraction)」を参照してください。  
+  
+<a name="PositiveGroup"></a>   
+## 文字グループの肯定: \[ \]  
+ 文字グループの肯定では、いずれかが入力文字列に含まれると一致と見なされる文字の一覧を指定します。  この文字の一覧は、個別に指定されることも範囲として指定されることも、その両方であることもあります。  
+  
+ 個別の文字の一覧を指定する構文は次のとおりです。  
+  
+ \[*character\_group*\]  
+  
+ ここで、 *character\_group* は、入力文字列に含まれるなら一致と見なされる個別の文字の一覧です。  *character\_group* は、リテラル文字、[エスケープ文字](../../../docs/standard/base-types/character-escapes-in-regular-expressions.md)、または文字クラスを 1 つ以上組み合わせて構成されます。  
+  
+ 文字の範囲を指定する構文は次のとおりです。  
+  
+```  
+[firstCharacter-lastCharacter]  
+```  
+  
+ ここで、*firstCharacter* は範囲の最初の文字で、*lastCharacter* は範囲の最後の文字です。  文字範囲は連続する一連の文字で、範囲の最初の文字、ハイフン \(\-\)、および範囲の最後の文字を指定することで定義されます。  2 つの文字の Unicode コード ポイントが隣接している場合、それらの文字は連続しています。  
+  
+ 文字クラスの肯定を含む一般的な正規表現パターンをいくつか次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`[aeiou]`|すべての母音と一致します。|  
+|`[\p{P}\d]`|すべての句読点および 10 進数字と一致します。|  
+|`[\s\p{P}]`|すべての空白および句読点と一致します。|  
+  
+ 次の例では、"a" および "e" という文字を含む文字グループの肯定を定義し、入力文字列内で "grey" または "gray" という語の後に別の語が続くと一致と見なされるようにします。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/positivecharclasses.cs#1)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/positivecharclasses.vb#1)]  
+  
+ 正規表現パターン `gr[ae]y\s\S+?[\s|\p{P}]` は、次のように定義されます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`gr`|リテラル文字 "gr" と一致します。|  
+|`[ae]`|"a" または "e" と一致します。|  
+|`y\s`|リテラル文字 "y" の後に空白文字が続く語と一致します。|  
+|`\S+?`|1 つ以上 \(ただし、できるだけ少ない数\) の空白以外の文字と一致します。|  
+|`[\s\p{P}]`|空白文字または句読点と一致します。|  
+  
+ 次の例は、大文字で始まる語と一致します。  部分式 `[A-Z]` を使用して、A から Z の範囲の大文字を表します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/range.cs#3)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/range.vb#3)]  
+  
+ 正規表現 `\b[A-Z]\w*\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`[A-Z]`|A から Z の任意の大文字と一致します。|  
+|`\w*`|0 個以上の単語に使用される文字に一致します。|  
+|`\b`|ワード境界に一致します。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="NegativeGroup"></a>   
+## 文字グループの否定: \[^\]  
+ 文字グループの否定では、入力文字列に含まれなければ一致と見なされる文字の一覧を指定します。  この文字の一覧は、個別に指定されることも範囲として指定されることも、その両方であることもあります。  
+  
+ 個別の文字の一覧を指定する構文は次のとおりです。  
+  
+ \[*^character\_group*\]  
+  
+ ここで、*character\_group* は、入力文字列に含まれない場合に一致と見なされる個別の文字の一覧です。  *character\_group* は、リテラル文字、[エスケープ文字](../../../docs/standard/base-types/character-escapes-in-regular-expressions.md)、または文字クラスを 1 つ以上組み合わせて構成されます。  
+  
+ 文字の範囲を指定する構文は次のとおりです。  
+  
+ \[^*firstCharacter*\-*lastCharacter*\]  
+  
+ ここで、*firstCharacter* は範囲の最初の文字で、*lastCharacter* は範囲の最後の文字です。  文字範囲は連続する一連の文字で、範囲の最初の文字、ハイフン \(\-\)、および範囲の最後の文字を指定することで定義されます。  2 つの文字の Unicode コード ポイントが隣接している場合、それらの文字は連続しています。  
+  
+ 複数の文字範囲を連結することもできます。  たとえば、"0" ～ "9" の範囲の 10 進数、"a" ～ "f" の範囲の小文字、および "A" ～ "F" の範囲の大文字を指定するには、`[0-9a-fA-F]` を使用します。  
+  
+ 文字グループの否定における先頭のキャレット文字 \(`^`\) は、文字グループが文字グループの肯定ではなく文字グループの否定であることを示し、省略できません。  
+  
+> [!IMPORTANT]
+>  大規模な正規表現パターンにおける文字グループの否定は、ゼロ幅アサーションではありません。  つまり、正規表現エンジンは、文字グループの否定を評価した後に、入力文字列内で 1 文字進みます。  
+  
+ 文字グループの否定を含む一般的な正規表現パターンをいくつか次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`[^aeiou]`|母音を除くすべての文字と一致します。|  
+|`[^\p{P}\d]`|句読点および 10 進数字を除くすべての文字と一致します。|  
+  
+ 次の例は、"th" という文字で始まってその後に "o" が続かない語と一致します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/negativecharclasses.cs#2)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/negativecharclasses.vb#2)]  
+  
+ 正規表現 `\bth[^o]\w+\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`th`|リテラル文字 "th" と一致します。|  
+|`[^o]`|"o" 以外の任意の文字と一致します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`\b`|ワード境界で終了します。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="AnyCharacter"></a>   
+## 任意の文字: .  
+ ピリオド文字 \(.\) は、`\n` \(改行文字、\\u000A\) を除く任意の文字と一致しますが、次の 2 つの制限があります。  
+  
+-   正規表現パターンが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションで修飾されている場合、または `.` 文字クラスを含むパターンの一部が `s` オプションで修飾されている場合は、`.` は任意の文字と一致します。  詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。  
+  
+     `.` 文字クラスの既定の動作と <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションが指定されている場合の動作の違いの例を次に示します。  正規表現 `^.+` は文字列の先頭から開始し、すべての文字と一致します。  既定では、照合は 1 行目の末尾で終了します。正規表現パターンは復帰文字 `\r` \(\\u000D\) と一致しますが、`\n` とは一致しません。  <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションは入力文字列全体を単一行として解釈するので、`\n` を含む入力文字列内のすべての文字と一致します。  
+  
+     [!code-csharp[Conceptual.Regex.Language.CharacterClasses#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/any2.cs#5)]
+     [!code-vb[Conceptual.Regex.Language.CharacterClasses#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/any2.vb#5)]  
+  
+> [!NOTE]
+>  `.` 文字クラスは `\n` を除く任意の文字と一致するので、このクラスも `\r` \(復帰文字、\\u000D\) と一致します。  
+  
+-   文字グループの肯定または文字グループの否定に含まれているピリオドは、文字クラスではなくリテラルのピリオド文字として扱われます。  詳細については、このトピックで前述した「[文字グループの肯定](#PositiveGroup)」および「[文字グループの否定](#NegativeGroup)」を参照してください。  ピリオド文字 \(`.`\) を文字クラスとしても文字グループの肯定のメンバーとしても含む正規表現を定義する例を次に示します。  正規表現 `\b.*[.?!;:](\s|\z)` はワード境界から開始し、ピリオドを含む 4 つの句読点のいずれかが検出されるまで任意の文字と一致し、空白文字または文字列の末尾と一致します。  
+  
+     [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/any1.cs#4)]
+     [!code-vb[Conceptual.RegEx.Language.CharacterClasses#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/any1.vb#4)]  
+  
+> [!NOTE]
+>  `.` 言語要素は任意の文字と一致するので、正規表現パターンが任意の文字と複数回一致する場合に最短一致の量指定子と共によく使用されます。  詳細については、\[[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)\] を参照してください:  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="CategoryOrBlock"></a>   
+## Unicode カテゴリまたは Unicode ブロック: \\p{}  
+ Unicode 規格では、各文字に一般カテゴリが割り当てられています。  たとえば、特定の文字は、英大文字 \(`Lu` カテゴリで表されます\)、10 進数 \(`Nd` カテゴリ\)、数学記号 \(`Sm` カテゴリ\)、または段落区切り記号 \(`Zl` カテゴリ\) に分類できます。  また、Unicode 規格の特定の文字セットは、特定の範囲またはブロックの連続したコード ポイントに対応します。  たとえば、基本的なラテン語文字セットは \\u0000 ～ \\u007F で、アラビア語文字セットは \\u0600 ～ \\u06FF です。  
+  
+ 正規表現の構成要素  
+  
+ `\p{` *name* `}`  
+  
+ は、Unicode 一般カテゴリまたは名前付きブロックに属する任意の文字と一致します。ここで、*name* はカテゴリの省略形または名前付きブロックの名前です。  カテゴリの省略形の一覧については、このトピックで後述する「[サポートされている Unicode 一般カテゴリ](#SupportedUnicodeGeneralCategories)」を参照してください。  名前付きブロックの一覧については、このトピックで後述する「[サポートされている名前付きブロック](#SupportedNamedBlocks)」を参照してください。  
+  
+ `\p{` *name* `}` 構成要素を使用して Unicode 一般カテゴリ \(この場合は `Pd` \(Punctuation, Dash: 句読点、ダッシュ\) カテゴリ\) と名前付きブロック \(`IsGreek` 名前付きブロックおよび `IsBasicLatin` 名前付きブロック\) の両方を照合する例を次に示します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/category1.cs#6)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/category1.vb#6)]  
+  
+ 正規表現 `\b(\p{IsGreek}+(\s)?)+\p{Pd}\s(\p{IsBasicLatin}+(\s)?)+` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`\p{IsGreek}+`|1 つ以上のギリシャ文字と一致します。|  
+|`(\s)?`|0 個または 1 個の空白文字と一致します。|  
+|`(\p{IsGreek}+(\s)?)+`|1 つ以上のギリシャ文字の後に 0 個または 1 個の空白文字が 1 回以上続くパターンに一致します。|  
+|`\p{Pd}`|Punctuation, Dash \(句読点、ダッシュ\) 文字と一致します。|  
+|`\s`|空白文字と一致します。|  
+|`\p{IsBasicLatin}+`|1 つ以上の基本的なラテン文字と一致します。|  
+|`(\s)?`|0 個または 1 個の空白文字と一致します。|  
+|`(\p{IsBasicLatin}+(\s)?)+`|1 つ以上の基本的なラテン文字の後に 0 個または 1 個の空白文字が 1 回以上続くパターンに一致します。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="NegativeCategoryOrBlock"></a>   
+## Unicode カテゴリまたは Unicode ブロックの否定: \\P{}  
+ Unicode 規格では、各文字に一般カテゴリが割り当てられています。  たとえば、特定の文字は、英大文字 \(`Lu` カテゴリで表されます\)、10 進数 \(`Nd` カテゴリ\)、数学記号 \(`Sm` カテゴリ\)、または段落区切り記号 \(`Zl` カテゴリ\) に分類できます。  また、Unicode 規格の特定の文字セットは、特定の範囲またはブロックの連続したコード ポイントに対応します。  たとえば、基本的なラテン語文字セットは \\u0000 ～ \\u007F で、アラビア語文字セットは \\u0600 ～ \\u06FF です。  
+  
+ 正規表現の構成要素  
+  
+ `\P{` *name* `}`  
+  
+ は、Unicode 一般カテゴリにも名前付きブロックにも属さない任意の文字と一致します。ここで、*name* はカテゴリの省略形または名前付きブロックの名前です。  カテゴリの省略形の一覧については、このトピックで後述する「[サポートされている Unicode 一般カテゴリ](#SupportedUnicodeGeneralCategories)」を参照してください。  名前付きブロックの一覧については、このトピックで後述する「[サポートされている名前付きブロック](#SupportedNamedBlocks)」を参照してください。  
+  
+ `\P{` *name* `}` 構成要素を使用して通貨記号 \(この場合は `Sc` \(Symbol, Currency: 記号、通貨\) カテゴリ\) を数値文字列から削除する例を次に示します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/notcategory1.cs#7)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/notcategory1.vb#7)]  
+  
+ 正規表現パターン `(\P{Sc})+` は、通貨記号以外の 1 つ以上の文字と一致し、実質的に結果文字列から通貨記号を削除します。  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="WordCharacter"></a>   
+## 単語に使用される文字: \\w  
+ `\w` は、単語に使用される任意の文字と一致します。  単語に使用される文字は、次の表に示す Unicode カテゴリのメンバーです。  
+  
+|カテゴリ|説明|  
+|----------|--------|  
+|Ll|Letter, Lowercase \(字、小文字\)|  
+|Lu|Letter, Uppercase \(字、大文字\)|  
+|Lt|Letter, Titlecase \(字、タイトル文字\)|  
+|Lo|Letter, Other \(字、その他\)|  
+|Lm|Letter, Modifier \(字、修飾\)|  
+|Nd|Number, Decimal Digit \(数、10 進数字\)|  
+|Pc|Punctuation, Connector \(句読点、接続\)。  このカテゴリには 10 文字が含まれ、そのうち最もよく使用される文字は LOWLINE 文字 \(\_\)、u\+005F です。|  
+  
+ ECMAScript 準拠の動作が指定された場合、`\w` は `[a-zA-Z_0-9]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+> [!NOTE]
+>  `\w` 言語要素は単語に使用される任意の文字と一致するので、正規表現パターンが単語に使用される任意の文字の後に特定の単語に使用される文字が続く語と複数回一致する場合に最短一致の量指定子と共によく使用されます。  詳細については、\[[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)\] を参照してください:  
+  
+ `\w` 言語要素を使用して単語内の重複する文字を照合する例を次に示します。  この例では、次のように解釈できる正規表現パターン `(\w)\1` を定義しています。  
+  
+|要素|説明|  
+|--------|--------|  
+|\(\\w\)|単語に使用される文字と一致します。  これが最初のキャプチャ グループです。|  
+|\\1|最初のキャプチャの値と一致します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/wordchar1.cs#8)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/wordchar1.vb#8)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="NonWordCharacter"></a>   
+## 単語に使用されない文字: \\W  
+ `\W` は、単語に使用される文字以外の任意の文字と一致します。  \\W 言語要素は、次の文字クラスと同じ結果をもたらします。  
+  
+```  
+[^\p{Ll}\p{Lu}\p{Lt}\p{Lo}\p{Nd}\p{Pc}\p{Lm}]  
+```  
+  
+ つまり、次の表に示す文字を除く任意の文字と一致します。  
+  
+|カテゴリ|説明|  
+|----------|--------|  
+|Ll|Letter, Lowercase \(字、小文字\)|  
+|Lu|Letter, Uppercase \(字、大文字\)|  
+|Lt|Letter, Titlecase \(字、タイトル文字\)|  
+|Lo|Letter, Other \(字、その他\)|  
+|Lm|Letter, Modifier \(字、修飾\)|  
+|Nd|Number, Decimal Digit \(数、10 進数字\)|  
+|Pc|Punctuation, Connector \(句読点、接続\)。  このカテゴリには 10 文字が含まれ、そのうち最もよく使用される文字は LOWLINE 文字 \(\_\)、u\+005F です。|  
+  
+ ECMAScript 準拠の動作が指定された場合、`\W` は `[^a-zA-Z_0-9]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+> [!NOTE]
+>  `\W` 言語要素は単語に使用されない任意の文字と一致するので、正規表現パターンが単語に使用されない任意の文字の後に特定の単語に使用されない文字が続く語と複数回一致する場合に最短一致の量指定子と共によく使用されます。  詳細については、\[[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)\] を参照してください:  
+  
+ `\W` 文字クラスの例を次に示します。  この例では、単語の後に 1 つまたは 2 つの単語に使用されない文字 \(空白や句読点など\) が続く場合に一致する正規表現パターン `\b(\w+)(\W){1,2}` を定義しています。  この正規表現の解釈を次の表に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|\\b|ワード境界から照合を開始します。|  
+|\(\\w\+\)|1 つ以上の単語文字に一致します。  これが最初のキャプチャ グループです。|  
+|\(\\W\){1,2}|単語に使用されない文字と 1 回または 2 回一致します。  これが 2 番目のキャプチャ グループです。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/nonwordchar1.cs#9)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/nonwordchar1.vb#9)]  
+  
+ 2 番目のキャプチャ グループの <xref:System.Text.RegularExpressions.Group> オブジェクトには、キャプチャされた単語に使用されない文字が 1 つだけ含まれるので、この例では、<xref:System.Text.RegularExpressions.CaptureCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> オブジェクトから、キャプチャされたすべての単語に使用されない文字を取得します。  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="WhitespaceCharacter"></a>   
+## 空白文字: \\s  
+ `\s` は、空白文字と一致します。  次の表に示すエスケープ シーケンスおよび Unicode カテゴリと同じ結果をもたらします。  
+  
+|カテゴリ|説明|  
+|----------|--------|  
+|`\f`|フォーム フィード文字 \(\\u000C\)。|  
+|`\n`|改行文字 \(\\u000A\)。|  
+|`\r`|復帰文字 \(\\u000D\)。|  
+|`\t`|タブ文字 \(\\u0009\)。|  
+|`\v`|垂直タブ文字 \(\\u000B\)。|  
+|`\x85`|省略記号または NEXT LINE \(NEL\) 文字 \(…\) \(\\u0085\)。|  
+|`\p{Z}`|任意の区切り記号と一致します。|  
+  
+ ECMAScript 準拠の動作が指定された場合、`\s` は `[\f\n\r\t\v]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+ `\s` 文字クラスの例を次に示します。  この例では、"s" または "es" で終わる単語の後に空白文字または入力文字列の末尾が続く場合に一致する正規表現パターン `\b\w+(e)?s(\s|$)` を定義しています。  この正規表現の解釈を次の表に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|\\b|ワード境界から照合を開始します。|  
+|\\w\+|1 つ以上の単語文字に一致します。|  
+|\(e\)?|"e" と 0 回または 1 回一致します。|  
+|s|"s" と一致します。|  
+|\(\\s&#124;$\)|空白文字または入力文字列の末尾と一致します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/whitespace1.cs#10)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/whitespace1.vb#10)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="NonWhitespaceCharacter"></a>   
+## 空白以外の文字: \\S  
+ `\S` は、空白文字以外の任意の文字と一致します。  `[^\f\n\r\t\v\x85\p{Z}]` 正規表現パターン、または空白文字と一致する `\s` に相当する正規表現パターンの逆と同じ結果をもたらします。  詳細については、「[空白文字: \\s](#WhitespaceCharacter)」を参照してください。  
+  
+ ECMAScript 準拠の動作が指定された場合、`\S` は `[^ \f\n\r\t\v]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+ `\S` 言語要素の例を次に示します。  正規表現パターン `\b(\S+)\s?` は、空白文字で区切られた文字列と一致します。  一致部分の <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトの 2 番目の要素に一致する文字列が含まれます。  この正規表現の解釈を次の表に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\S+)`|1 つ以上の空白以外の文字と一致します。  これが最初のキャプチャ グループです。|  
+|`\s?`|0 個または 1 個の空白文字と一致します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/nonwhitespace1.cs#11)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/nonwhitespace1.vb#11)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="DigitCharacter"></a>   
+## 10 進数字: \\d  
+ `\d` は、10 進数字と一致します。  標準の 10 進数 0 ～ 9 およびその他の各種文字セットの 10 進数を含む `\p{Nd}` 正規表現パターンと同じ結果をもたらします。  
+  
+ ECMAScript 準拠の動作が指定された場合、`\d` は `[0-9]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+ `\d` 言語要素の例を次に示します。  この例では、入力文字列が米国およびカナダの有効な電話番号を表すかどうかをテストします。  正規表現パターン `^(\(?\d{3}\)?[\s-])?\d{3}-\d{4}$` は、次の表に示すように定義されています。  
+  
+|要素|説明|  
+|--------|--------|  
+|`^`|入力文字列の先頭から照合を開始します。|  
+|`\(?`|0 個または 1 個のリテラル "\(" 文字と一致します。|  
+|`\d{3}`|3 個の 10 進数と一致します。|  
+|`\)?`|0 個または 1 個のリテラル "\)" 文字と一致します。|  
+|`[\s-]`|ハイフンまたは空白文字と一致します。|  
+|`(\(?  \d{3}\)?[\s-])?`|省略可能な左かっこの後に 3 個の 10 進数が続く部分、省略可能な右かっこ、および空白文字またはハイフンと 0 回または 1 回一致します。  これが最初のキャプチャ グループです。|  
+|`\d{3}-\d{4}`|3 個の 10 進数の後にハイフンおよび 4 個以上の 10 進数が続く場合に一致します。|  
+|`$`|入力文字列の末尾と一致します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/digit1.cs#12)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/digit1.vb#12)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="NonDigitCharacter"></a>   
+## 数字以外の文字: \\D  
+ `\D` は、数字以外の文字と一致します。  `\P{Nd}` 正規表現パターンと同じ結果をもたらします。  
+  
+ ECMAScript 準拠の動作が指定された場合、`\D` は `[^0-9]` と同じになります。  ECMAScript 正規表現の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「ECMAScript 一致の動作」のセクションを参照してください。  
+  
+ \\D 言語要素の例を次に示します。  部品番号などの文字列が 10 進数および 10 進数以外の文字を適切に組み合わせて構成されているかどうかをテストします。  正規表現パターン `^\D\d{1,5}\D*$` は、次の表に示すように定義されています。  
+  
+|要素|説明|  
+|--------|--------|  
+|`^`|入力文字列の先頭から照合を開始します。|  
+|`\D`|数字以外の文字と一致します。|  
+|`\d{1,5}`|1 ～ 5 個の 10 進数と一致します。|  
+|`\D*`|0 個または 1 個以上の 10 進数以外の文字と一致します。|  
+|`$`|入力文字列の末尾と一致します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/nondigit1.cs#13)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/nondigit1.vb#13)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="SupportedUnicodeGeneralCategories"></a>   
+## サポートされている Unicode 一般カテゴリ  
+ Unicode は、次の表に示されている一般カテゴリを定義しています。  詳細については、「[Unicode Character Database \(Unicode 文字データベース\)](http://go.microsoft.com/fwlink/?LinkId=57650)」内の「UCD File Format \(UCD ファイル形式\)」および「General Category Values \(一般カテゴリの値\)」を参照してください。  
+  
+|カテゴリ|説明|  
+|----------|--------|  
+|`Lu`|Letter, Uppercase \(字、大文字\)|  
+|`Ll`|Letter, Lowercase \(字、小文字\)|  
+|`Lt`|Letter, Titlecase \(字、タイトル文字\)|  
+|`Lm`|Letter, Modifier \(字、修飾\)|  
+|`Lo`|Letter, Other \(字、その他\)|  
+|`L`|すべてのアルファベット文字。  これには、`Lu`、`Ll`、`Lt`、`Lm`、および `Lo` の各文字が含まれます。|  
+|`Mn`|Mark, Nonspacing \(結合文字、幅なし\)|  
+|`Mc`|Mark, Spacing Combining \(結合文字、幅あり\)|  
+|`Me`|Mark, Enclosing \(結合文字、囲み\)|  
+|`M`|すべての分音記号。  これには、`Mn`、`Mc`、および `Me` の各カテゴリが含まれます。|  
+|`Nd`|Number, Decimal Digit \(数、10 進数字\)|  
+|`Nl`|Number, Letter \(数、字\)|  
+|`No`|Number, Other \(数、その他\)|  
+|`N`|すべての数。  これには、`Nd`、`Nl`、および `No` の各カテゴリが含まれます。|  
+|`Pc`|Punctuation, Connector \(句読点、接続\)|  
+|`Pd`|Punctuation, Dash \(句読点、ダッシュ\)|  
+|`Ps`|Punctuation, Open \(句読点、開き\)|  
+|`Pe`|Punctuation, Close \(句読点、閉じ\)|  
+|`Pi`|Punctuation, Initial quote \(句読点、開始引用符。使用状況に応じて Ps または Pe のように動作\)|  
+|`Pf`|Punctuation, Final quote \(句読点、終了引用符。使用状況に応じて Ps または Pe のように動作\)|  
+|`Po`|Punctuation, Other \(句読点、その他\)|  
+|`P`|すべての句読点。  これには、`Pc`、`Pd`、`Ps`、`Pe`、`Pi`、`Pf`、および `Po` の各カテゴリが含まれます。|  
+|`Sm`|Symbol, Math \(記号、数学\)|  
+|`Sc`|Symbol, Currency \(記号、通貨\)|  
+|`Sk`|Symbol, Modifier \(記号、修飾\)|  
+|`So`|Symbol, Other \(記号、その他\)|  
+|`S`|すべての記号。  これには、`Sm`、`Sc`、`Sk`、および `So` の各カテゴリが含まれます。|  
+|`Zs`|Separator, Space \(区切り、空白\)|  
+|`Zl`|Separator, Line \(区切り、行\)|  
+|`Zp`|Separator, Paragraph \(区切り、段落\)|  
+|`Z`|すべての区切り記号。  これには、`Zs`、`Zl`、および `Zp` の各カテゴリが含まれます。|  
+|`Cc`|Other, Control \(区切り、制御\)|  
+|`Cf`|Other, Format \(その他、書式\)|  
+|`Cs`|Other, Surrogate \(その他、サロゲート\)|  
+|`Co`|Other, Private Use \(その他、プライベート用途\)|  
+|`Cn`|Other, Not Assigned \(その他、未割り当て。このプロパティを持つ文字はありません\)|  
+|`C`|すべての制御文字。  これには、`Cc`、`Cf`、`Cs`、`Co`、および `Cn` の各カテゴリが含まれます。|  
+  
+ 特定の文字の Unicode カテゴリを確認するには、その文字を <xref:System.Char.GetUnicodeCategory%2A> メソッドに渡します。  <xref:System.Char.GetUnicodeCategory%2A> メソッドを使用して、選択したラテン文字を含む配列の各要素のカテゴリを確認する例を次に示します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/getunicodecategory1.cs#14)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/getunicodecategory1.vb#14)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="SupportedNamedBlocks"></a>   
+## サポートされている名前付きブロック  
+ .NET Framework には、次の表に示す名前付きブロックが用意されています。  サポートされている一連の名前付きブロックは、Unicode 4.0 および Perl 5.6 に基づいています。  
+  
+|コード ポイント範囲|ブロック名|  
+|----------------|-----------|  
+|0000 ～ 007F|`IsBasicLatin`|  
+|0080 ～ 00FF|`IsLatin-1Supplement`|  
+|0100 ～ 017F|`IsLatinExtended-A`|  
+|0180 ～ 024F|`IsLatinExtended-B`|  
+|0250 ～ 02AF|`IsIPAExtensions`|  
+|02B0 ～ 02FF|`IsSpacingModifierLetters`|  
+|0300 ～ 036F|`IsCombiningDiacriticalMarks`|  
+|0370 ～ 03FF|`IsGreek`<br /><br /> または<br /><br /> `IsGreekandCoptic`|  
+|0400 ～ 04FF|`IsCyrillic`|  
+|0500 ～ 052F|`IsCyrillicSupplement`|  
+|0530 ～ 058F|`IsArmenian`|  
+|0590 ～ 05FF|`IsHebrew`|  
+|0600 ～ 06FF|`IsArabic`|  
+|0700 ～ 074F|`IsSyriac`|  
+|0780 ～ 07BF|`IsThaana`|  
+|0900 ～ 097F|`IsDevanagari`|  
+|0980 ～ 09FF|`IsBengali`|  
+|0A00 ～ 0A7F|`IsGurmukhi`|  
+|0A80 ～ 0AFF|`IsGujarati`|  
+|0B00 ～ 0B7F|`IsOriya`|  
+|0B80 ～ 0BFF|`IsTamil`|  
+|0C00 ～ 0C7F|`IsTelugu`|  
+|0C80 ～ 0CFF|`IsKannada`|  
+|0D00 ～ 0D7F|`IsMalayalam`|  
+|0D80 ～ 0DFF|`IsSinhala`|  
+|0E00 ～ 0E7F|`IsThai`|  
+|0E80 ～ 0EFF|`IsLao`|  
+|0F00 ～ 0FFF|`IsTibetan`|  
+|1000 ～ 109F|`IsMyanmar`|  
+|10A0 ～ 10FF|`IsGeorgian`|  
+|1100 ～ 11FF|`IsHangulJamo`|  
+|1200 ～ 137F|`IsEthiopic`|  
+|13A0 ～ 13FF|`IsCherokee`|  
+|1400 ～ 167F|`IsUnifiedCanadianAboriginalSyllabics`|  
+|1680 ～ 169F|`IsOgham`|  
+|16A0 ～ 16FF|`IsRunic`|  
+|1700 ～ 171F|`IsTagalog`|  
+|1720 ～ 173F|`IsHanunoo`|  
+|1740 ～ 175F|`IsBuhid`|  
+|1760 ～ 177F|`IsTagbanwa`|  
+|1780 ～ 17FF|`IsKhmer`|  
+|1800 ～ 18AF|`IsMongolian`|  
+|1900 ～ 194F|`IsLimbu`|  
+|1950 ～ 197F|`IsTaiLe`|  
+|19E0 ～ 19FF|`IsKhmerSymbols`|  
+|1D00 ～ 1D7F|`IsPhoneticExtensions`|  
+|1E00 ～ 1EFF|`IsLatinExtendedAdditional`|  
+|1F00 ～ 1FFF|`IsGreekExtended`|  
+|2000 ～ 206F|`IsGeneralPunctuation`|  
+|2070 ～ 209F|`IsSuperscriptsandSubscripts`|  
+|20A0 ～ 20CF|`IsCurrencySymbols`|  
+|20D0 ～ 20FF|`IsCombiningDiacriticalMarksforSymbols`<br /><br /> または<br /><br /> `IsCombiningMarksforSymbols`|  
+|2100 ～ 214F|`IsLetterlikeSymbols`|  
+|2150 ～ 218F|`IsNumberForms`|  
+|2190 ～ 21FF|`IsArrows`|  
+|2200 ～ 22FF|`IsMathematicalOperators`|  
+|2300 ～ 23FF|`IsMiscellaneousTechnical`|  
+|2400 ～ 243F|`IsControlPictures`|  
+|2440 ～ 245F|`IsOpticalCharacterRecognition`|  
+|2460 ～ 24FF|`IsEnclosedAlphanumerics`|  
+|2500 ～ 257F|`IsBoxDrawing`|  
+|2580 ～ 259F|`IsBlockElements`|  
+|25A0 ～ 25FF|`IsGeometricShapes`|  
+|2600 ～ 26FF|`IsMiscellaneousSymbols`|  
+|2700 ～ 27BF|`IsDingbats`|  
+|27C0 ～ 27EF|`IsMiscellaneousMathematicalSymbols-A`|  
+|27F0 ～ 27FF|`IsSupplementalArrows-A`|  
+|2800 ～ 28FF|`IsBraillePatterns`|  
+|2900 ～ 297F|`IsSupplementalArrows-B`|  
+|2980 ～ 29FF|`IsMiscellaneousMathematicalSymbols-B`|  
+|2A00 ～ 2AFF|`IsSupplementalMathematicalOperators`|  
+|2B00 ～ 2BFF|`IsMiscellaneousSymbolsandArrows`|  
+|2E80 ～ 2EFF|`IsCJKRadicalsSupplement`|  
+|2F00 ～ 2FDF|`IsKangxiRadicals`|  
+|2FF0 ～ 2FFF|`IsIdeographicDescriptionCharacters`|  
+|3000 ～ 303F|`IsCJKSymbolsandPunctuation`|  
+|3040 ～ 309F|`IsHiragana`|  
+|30A0 ～ 30FF|`IsKatakana`|  
+|3100 ～ 312F|`IsBopomofo`|  
+|3130 ～ 318F|`IsHangulCompatibilityJamo`|  
+|3190 ～ 319F|`IsKanbun`|  
+|31A0 ～ 31BF|`IsBopomofoExtended`|  
+|31F0 ～ 31FF|`IsKatakanaPhoneticExtensions`|  
+|3200 ～ 32FF|`IsEnclosedCJKLettersandMonths`|  
+|3300 ～ 33FF|`IsCJKCompatibility`|  
+|3400 ～ 4DBF|`IsCJKUnifiedIdeographsExtensionA`|  
+|4DC0 ～ 4DFF|`IsYijingHexagramSymbols`|  
+|4E00 ～ 9FFF|`IsCJKUnifiedIdeographs`|  
+|A000 ～ A48F|`IsYiSyllables`|  
+|A490 ～ A4CF|`IsYiRadicals`|  
+|AC00 ～ D7AF|`IsHangulSyllables`|  
+|D800 ～ DB7F|`IsHighSurrogates`|  
+|DB80 ～ DBFF|`IsHighPrivateUseSurrogates`|  
+|DC00 ～ DFFF|`IsLowSurrogates`|  
+|E000 ～ F8FF|`IsPrivateUse` または `IsPrivateUseArea`|  
+|F900 ～ FAFF|`IsCJKCompatibilityIdeographs`|  
+|FB00 ～ FB4F|`IsAlphabeticPresentationForms`|  
+|FB50 ～ FDFF|`IsArabicPresentationForms-A`|  
+|FE00 ～ FE0F|`IsVariationSelectors`|  
+|FE20 ～ FE2F|`IsCombiningHalfMarks`|  
+|FE30 ～ FE4F|`IsCJKCompatibilityForms`|  
+|FE50 ～ FE6F|`IsSmallFormVariants`|  
+|FE70 ～ FEFF|`IsArabicPresentationForms-B`|  
+|FF00 ～ FFEF|`IsHalfwidthandFullwidthForms`|  
+|FFF0 ～ FFFF|`IsSpecials`|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="CharacterClassSubtraction"></a>   
+## 文字クラスの減算: \[base\_group \- \[excluded\_group\]\]  
+ 文字クラスは、文字のセットを定義します。  文字クラス減算によって、ある文字クラスから別の文字クラスの文字を除外した文字セットが生成されます。  
+  
+ 文字クラス減算式の形式は次のとおりです。  
+  
+ `[` *base\_group* `-[` *excluded\_group* `]]`  
+  
+ 角かっこ \(`[]`\) とハイフン \(`-`\) は省略できません。  *base\_group* は、[文字グループの肯定](#PositiveGroup)または[文字グループの否定](#NegativeGroup)です。  *excluded\_group* は、別の文字グループの肯定または文字グループの否定、あるいは別の文字クラス減算式です \(つまり文字クラス減算式は入れ子にすることができます\)。  
+  
+ たとえば、"a" ～ "z" の文字範囲で構成される基本グループがあるとします。  "m" を除外した基本グループで構成される文字のセットを定義するには、`[a-z-[m]]` を使用します。  "d"、"j" および "p" の文字を除外した基本グループで構成される文字のセットを定義するには、`[a-z-[djp]]` を使用します。  "m" ～ "p" の文字範囲を除外した基本グループで構成される文字のセットを定義するには、`[a-z-[m-p]]` を使用します。  
+  
+ 入れ子になった文字クラス減算式 `[a-z-[d-w-[m-o]]]` について考えてみます。  この式は、最も内部の文字範囲から順に外側へと評価されます。  まず、"m" ～ "o" の文字範囲が "d" ～ "w" の文字範囲から減算されて、"d" ～ "l" および "p" ～ "w" の文字セットが生成されます。  さらにこのセットが "a" ～ "z" の文字範囲から減算されて、`[abcmnoxyz]` という文字セットが生成されます。  
+  
+ 文字クラス減算では、任意の文字クラスを使用できます。  \\u0000 ～ \\uFFFF の Unicode 文字から空白文字 \(`\s`\)、句読点一般カテゴリの文字 \(`\p{P}`\)、`IsGreek` 名前付きブロック内の文字 \(`\p{IsGreek}`\)、および Unicode NEXT LINE 制御文字 \(\\x85\) を除いた文字のセットを定義するには、`[\u0000-\uFFFF-[\s\p{P}\p{IsGreek}\x85]]` を使用します。  
+  
+ 有効な結果を生成する文字クラス減算式の文字クラスを選択します。  どの文字にも一致しない空の文字セットを生成する式、または元の基本グループと同じになる式は避けてください。  たとえば、`[\p{IsBasicLatin}-[\x00-\x7F]]` という式は、`IsBasicLatin` 一般カテゴリから `IsBasicLatin` 文字範囲のすべての文字を減算して空のセットを生成します。  同様に、`[a-z-[0-9]]` という式は元の基本グループと同じセットを生成します。  これは、"a" ～ "z" の文字範囲である基本グループに、"0" ～ "9" という 10 進数字の文字範囲から成る除外対象グループ内の文字が含まれないためです。  
+  
+ 入力文字列内の 0 および奇数と一致する正規表現 `^[0-9-[2468]]+$` を定義する例を次に示します。  この正規表現の解釈を次の表に示します。  
+  
+|要素|説明|  
+|--------|--------|  
+|^|入力文字列の先頭から照合を開始します。|  
+|`[0-9-[2468]]+`|2、4、6、および 8 を除く 0 ～ 9 の文字の 1 回以上の出現と一致します。  つまり、0 または奇数の 1 回以上の出現と一致します。|  
+|$|入力文字列の末尾で照合を終了します。|  
+  
+ [!code-csharp[Conceptual.RegEx.Language.CharacterClasses#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/classsubtraction1.cs#15)]
+ [!code-vb[Conceptual.RegEx.Language.CharacterClasses#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/classsubtraction1.vb#15)]  
+  
+## 参照  
+ <xref:System.Char.GetUnicodeCategory%2A>   
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)   
+ [正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/character-encoding.md b/docs/standard/base-types/character-encoding.md
index b87b2069c38..4818bacac6d 100644
--- a/docs/standard/base-types/character-encoding.md
+++ b/docs/standard/base-types/character-encoding.md
@@ -1,1506 +1,270 @@
 ---
-title: ".NET での文字エンコード"
-description: ".NET での文字エンコード"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: bce54e41-e9dc-493a-8988-1cbadc340fe8
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: a8f42fa6a37f8de6f13186ea2ac17b2b2ced1601
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="character-encoding-in-net"></a>.NET での文字エンコード
-
-文字は、さまざまな方法で表現できる抽象エンティティです。 文字エンコーディングとは、サポートされている文字セットの各文字を、その文字を表す値と組み合わせる体系です。 たとえばモールス符号は、ローマ字の各文字を、電信線での送信に適したドットとダッシュのパターンと組み合わせる文字エンコーディングです。 コンピューターの文字エンコーディングは、サポートされている文字セットの各文字を、その文字を表す数値と組み合わせます。 文字エンコーディングには、次の&2; つの異なるコンポーネントがあります。
-
-* エンコーダー。文字シーケンスを数値 (バイト) シーケンスに変換します。
-
-* デコーダー。バイト シーケンスを文字シーケンスに変換します。
-
-文字エンコーディングは、エンコーダーとデコーダーの動作を決める規則を表します。 たとえば、[UTF8Encoding](xref:System.Text.UTF8Encoding) クラスは、1 ～ 4 バイトを使用して 1 つの Unicode 文字を表現する UTF-8 (8-bit Unicode Transformation Format) をエンコードおよびデコードするための規則を表します。 エンコードとデコードに検証を含めることもできます。 たとえば、[UnicodeEncoding](xref:System.Text.UnicodeEncoding) クラスは、すべてのサロゲートを検証して、有効なサロゲート ペアが構成されていることを確認します  (サロゲート ペアは、U+D800 ～ U+DBFF の範囲のコード ポイントを持つ文字と、それに続く U+DC00 ～ U+DFFF の範囲のコード ポイントを持つ文字で構成されます)。エンコーダーが無効な文字を処理する方法や、デコーダーが無効なバイトを処理する方法は、フォールバック ストラテジによって決まります。 
-
+title: ".NET Framework における文字エンコーディング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "エンコーディング, 選択"
+  - "エンコーディング, フォールバック ストラテジ"
+  - "エンコーディング, 理解"
+ms.assetid: bf6d9823-4c2d-48af-b280-919c5af66ae9
+caps.latest.revision: 33
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# .NET Framework における文字エンコーディング
+文字は、さまざまな方法で表現できる抽象エンティティです。 文字エンコーディングとは、サポートされている文字セットの各文字を、その文字を表す値と組み合わせる体系です。 たとえばモールス符号は、ローマ字の各文字を、電信線での送信に適したドットとダッシュのパターンと組み合わせる文字エンコーディングです。 コンピューターの文字エンコーディングは、サポートされている文字セットの各文字を、その文字を表す数値と組み合わせます。 文字エンコーディングには、次の 2 つの異なるコンポーネントがあります。  
+  
+-   エンコーダー。文字シーケンスを数値 \(バイト\) シーケンスに変換します。  
+  
+-   デコーダー。バイト シーケンスを文字シーケンスに変換します。  
+  
+ 文字エンコーディングは、エンコーダーとデコーダーの動作を決める規則を表します。 たとえば、<xref:System.Text.UTF8Encoding> クラスは、1 ～ 4 バイトを使用して 1 つの Unicode 文字を表現する UTF\-8 \(8\-bit Unicode Transformation Format\) をエンコードおよびデコードするための規則を表します。 エンコードとデコードに検証を含めることもできます。 たとえば、<xref:System.Text.UnicodeEncoding> クラスは、すべてのサロゲートを検証して、有効なサロゲート ペアが構成されていることを確認します  \(サロゲート ペアは、U\+D800 ～ U\+DBFF の範囲のコード ポイントを持つ文字と、それに続く U\+DC00 ～ U\+DFFF の範囲のコード ポイントを持つ文字で構成されます\)。  エンコーダーが無効な文字を処理する方法や、デコーダーが無効なバイトを処理する方法は、フォールバック ストラテジによって決まります。  
+  
 > [!WARNING]
-> .NET のエンコーディング クラスは、文字データを格納および変換するためのものです。 バイナリ データを文字列形式で格納する目的では使用しないでください。 エンコーディング クラスを使用してバイナリ データを文字列形式に変換すると、使用されているエンコーディングによっては、予期しない動作が発生したり、不正確なデータや破損したデータが生成されたりする可能性があります。 バイナリ データを文字列形式に変換するには、[Convert.ToBase64String](xref:System.Convert.ToBase64String(System.Byte[])) メソッドを使用します。 
- 
-.NET では ([UnicodeEncoding](xref:System.Text.UnicodeEncoding) クラスによって表される) UTF-16 エンコーディングを使用して、文字と文字列を表します。 共通言語ランタイムをターゲットとするアプリケーションは、エンコーダーを使用して、共通言語ランタイムによってサポートされている Unicode 文字表現を他のエンコーディング方式に変換し、 デコーダーを使用して、Unicode 以外のエンコーディングの文字を Unicode に変換します。
-
-このトピックは、次のセクションで構成されています。
-
-* [.NET でのエンコード](#encodings-in-net)
-
-* [エンコーディング クラスの選択](#selecting-an-encoding-class)
-
-* [エンコーディング オブジェクトの使用](#using-an-encoding-object)
-
-* [フォールバック ストラテジの選択](#choosing-a-fallback-strategy)
-
-* [カスタム フォールバック ストラテジの実装](#implementing-a-custom-fallback-strategy)
-
-## <a name="encodings-in-net"></a>.NET でのエンコード
-
-.NET のすべての文字エンコーディング クラスは、すべての文字エンコーディングに共通の機能を定義する抽象クラスの [System.Text.Encoding](xref:System.Text.Encoding) クラスを継承します。 .NET に実装されている個々のエンコーディング オブジェクトにアクセスするには次の方法があります。
-
-* [Encoding](xref:System.Text.Encoding) クラスの静的プロパティを使用します。これらのプロパティは、.NET で使用できる標準の文字エンコーディング (ASCII、UTF-7、UTF-8、UTF-16、および UTF-32) を表すオブジェクトを返します。 たとえば、[Encoding.Unicode](xref:System.Text.Encoding.Unicode) プロパティは [UnicodeEncoding](xref:System.Text.UnicodeEncoding) オブジェクトを返します。 各オブジェクトでは、エンコードできない文字列とデコードできないバイトを処理するために、置換フォールバックが使用されます  (詳細については、「[置換フォールバック](#replacement-fallback)」を参照してください)。
-
-* エンコーディングのクラス コンストラクターを呼び出します。 ASCII、UTF-7、UTF-8、UTF-16、および UTF-32 の各エンコーディングのオブジェクトは、この方法でインスタンス化できます。 既定では、各オブジェクトはエンコードできない文字列とデコードできないバイトを処理するために置換フォールバックを使用します。ただし、代わりに例外がスローされるように指定することもできます  (詳細については、「[置換フォールバック](#replacement-fallback)」と「[例外フォールバック](#exception-fallback)」を参照してください)。
-
-* [Encoding.Encoding(Int32)](xref:System.Text.Encoding.GetEncoding(System.Int32)) コンストラクターを呼び出して、エンコーディングを表す整数を渡します。 エンコードできない文字列とデコードできないバイトの処理には、標準エンコーディングのエンコーディング オブジェクトでは置換フォールバックが、コード ページ エンコーディングと&2; バイト文字セット (DBCS) エンコーディングのエンコーディング オブジェクトでは最適フォールバックが使用されます  (詳細については、「[最適フォールバック](#best-fit-fallback)」を参照してください)。
-
-* [Encoding.GetEncoding](xref:System.Text.Encoding.GetEncoding(System.Int32)) メソッドを呼び出します。このメソッドは、.NET で使用できる任意のエンコーディング (標準、コード ページ、または DBCS) を返します。 オーバーロードを使用すると、エンコーダーおよびデコーダーの両方のフォールバック オブジェクトを指定できます。
-
-> [!NOTE]
-> Unicode 規格では、サポートされるすべてのスクリプトについて、各文字にコード ポイント (数値) と名前を割り当てています。 たとえば、文字 "A" は U+0041 というコード ポイントと、"LATIN CAPITAL LETTER A" という名前で表されます。 UTF (Unicode Transformation Format) エンコーディングは、そのコード ポイントを&1; つ以上のバイトのシーケンスにエンコードする方法を定義します。 Unicode エンコーディング方式を使用すると、任意の文字セットの文字を&1; つのエンコーディング方式で表現できるため、国際対応アプリケーションの開発が簡素化されます。 これにより、アプリケーション開発者が、特定の言語または書記体系の文字を表すために使用されるエンコーディング方式を追跡する必要はなくなります。また、データを破損することなく、各国のシステム間でデータを共有できます。
->
->  .NET では、Unicode 規格によって定義されている UTF-8、UTF-16、および UTF-32 の&3; つのエンコーディングをサポートしています。 詳細については、[Unicode](http://www.unicode.org/) ホーム ページの Unicode 標準を参照してください。
- 
-.NET でサポートされている文字エンコーディング システムを次の表に示します。
-
-エンコード | クラス | 説明 | 長所/短所
--------- | ----- | ----------- | ------------------------ 
-ASCII | [ASCIIEncoding](xref:System.Text.ASCIIEncoding) | バイトの下位&7; ビットを使用して、限られた範囲の文字をエンコードします。 | ASCII エンコーディングでは、U+0000 から U+007F までの文字値しかサポートされていないため、ほとんどの場合、国際対応アプリケーションでは ASCII エンコーディングの使用は不適切です。
-UTF-7 | [UTF7Encoding](xref:System.Text.UTF7Encoding) | 文字を 7 ビット ASCII 文字のシーケンスとして表します。 ASCII 以外の Unicode 文字は、ASCII 文字のエスケープ シーケンスによって表します。 | UTF-7 は、電子メールやニュースグループなどのプロトコルをサポートします。 ただし、UTF-7 は特に安全でも堅牢でもありません。 場合によっては、1 ビットの変更により、UTF-7 文字列全体の解釈が完全に変わる場合があります。 他の場合には、異なる UTF-7 文字列がエンコードによって同じテキストになる可能性もあります。 ASCII 以外の文字を含むシーケンスの場合、UTF-7 は UTF-8 よりも多くの空間を必要とし、エンコードとデコードに時間がかかります。 したがって、可能であれば、UTF-7 ではなく UTF-8 を使用してください。
-UTF-8 | [UTF8Encoding](xref:System.Text.UTF8Encoding) | 各 Unicode コード ポイントが、1 バイトから&4; バイトのシーケンスとして表現されます。 | UTF-8 では、8 ビット データ サイズがサポートされており、既存の多くのオペレーティング システムに対応できます。 ASCII 範囲の文字については、UTF-8 は ASCII エンコーディングと一致し、より広範な文字を提供します。 ただし、CJK (中国語、日本語、韓国語) スクリプトでは、UTF-8 の各文字に&3; バイトが必要となることがあり、データ サイズが UTF-16 より大きくなる可能性があります。 ただし、CJK 範囲によるサイズの増加が HTML タグなどの ASCII データのサイズによって相殺されることもあります。
-UTF-16 | [UnicodeEncoding](xref:System.Text.UnicodeEncoding) | 各 Unicode コード ポイントが、1 つまたは 2 つの 16 ビット整数のシーケンスとして表現されます。 ほとんどの一般的な Unicode 文字で必要とされる UTF-16 コード ポイントは&1; つだけです。ただし、Unicode の補助文字 (U+10000 以上) には&2; つの UTF-16 サロゲート コード ポイントが必要です。 リトル エンディアンとビッグ エンディアンの両方のバイト順をサポートしています。 | UTF-16 エンコーディングは、共通言語ランタイムでは Char および String の値を表現するために、Windows オペレーティング システムでは WCHAR の値を表現するために使用されています。
-UTF-32 | [UTF32Encoding](xref:System.Text.UTF32Encoding) | 各 Unicode コード ポイントが 32 ビット整数として表現されます。 リトル エンディアンとビッグ エンディアンの両方のバイト順をサポートしています。 | UTF-32 エンコーディングは、エンコードされた空白がきわめて重要な意味を持つオペレーティング システムで、アプリケーションが UTF-16 エンコーディングのサロゲート コード ポイント動作を回避する必要がある場合に使用します。 ディスプレイ上でレンダリングされる&1; つのグリフも複数の UTF-32 文字でエンコードされることがあります。
-
-これらのエンコーディングを使用することにより、Unicode 文字だけでなく、レガシ アプリケーションで最もよく使用されているエンコーディングにも対応できます。 また、[Encoding](xref:System.Text.Encoding) から派生するクラスを定義し、そのメンバーをオーバーライドして、カスタム エンコーディングを作成することもできます。
-
+>  .NET Framework のエンコーディング クラスは、文字データを格納および変換するためのものです。 バイナリ データを文字列形式で格納する目的では使用しないでください。 エンコーディング クラスを使用してバイナリ データを文字列形式に変換すると、使用されているエンコーディングによっては、予期しない動作が発生したり、不正確なデータや破損したデータが生成されたりする可能性があります。 バイナリ データを文字列形式に変換するには、<xref:System.Convert.ToBase64String%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ .NET Framework では \(<xref:System.Text.UnicodeEncoding> クラスによって表される\) UTF\-16 エンコーディングを使用して、文字と文字列を表します。 共通言語ランタイムをターゲットとするアプリケーションは、エンコーダーを使用して、共通言語ランタイムによってサポートされている Unicode 文字表現を他のエンコーディング方式に変換し、 デコーダーを使用して、Unicode 以外のエンコーディングの文字を Unicode に変換します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [.NET Framework のエンコーディング](../../../docs/standard/base-types/character-encoding.md#Encodings)  
+  
+-   [エンコーディング クラスの選択](../../../docs/standard/base-types/character-encoding.md#Selecting)  
+  
+-   [エンコーディング オブジェクトの使用](../../../docs/standard/base-types/character-encoding.md#Using)  
+  
+-   [フォールバック ストラテジの選択](../../../docs/standard/base-types/character-encoding.md#FallbackStrategy)  
+  
+-   [カスタム フォールバック ストラテジの実装](../../../docs/standard/base-types/character-encoding.md#Custom)  
+  
+<a name="Encodings"></a>   
+## .NET Framework のエンコーディング  
+ .NET Framework のすべての文字エンコーディング クラスは、すべての文字エンコーディングに共通の機能を定義する抽象クラスの <xref:System.Text.Encoding?displayProperty=fullName> クラスを継承します。 .NET Framework に実装されている個々のエンコーディング オブジェクトにアクセスするには次の方法があります。  
+  
+-   <xref:System.Text.Encoding> クラスの静的プロパティを使用します。これらのプロパティは、.NET Framework で使用できる標準の文字エンコーディング \(ASCII、UTF\-7、UTF\-8、UTF\-16、および UTF\-32\) を表すオブジェクトを返します。 たとえば、<xref:System.Text.Encoding.Unicode%2A?displayProperty=fullName> プロパティは <xref:System.Text.UnicodeEncoding> オブジェクトを返します。 各オブジェクトでは、エンコードできない文字列とデコードできないバイトを処理するために、置換フォールバックが使用されます  \(詳しくは、「[置換フォールバック](../../../docs/standard/base-types/character-encoding.md#Replacement)」セクションをご覧ください。\)  
+  
+-   エンコーディングのクラス コンストラクターを呼び出します。 ASCII、UTF\-7、UTF\-8、UTF\-16、および UTF\-32 の各エンコーディングのオブジェクトは、この方法でインスタンス化できます。 既定では、各オブジェクトはエンコードできない文字列とデコードできないバイトを処理するために置換フォールバックを使用します。ただし、代わりに例外がスローされるように指定することもできます  \(詳しくは、「[置換フォールバック](../../../docs/standard/base-types/character-encoding.md#Replacement)」セクションおよび「[例外フォールバック](../../../docs/standard/base-types/character-encoding.md#Exception)」セクションをご覧ください。\)  
+  
+-   <xref:System.Text.Encoding.%23ctor%28System.Int32%29?displayProperty=fullName> コンストラクターを呼び出して、エンコーディングを表す整数を渡します。 エンコードできない文字列とデコードできないバイトの処理には、標準エンコーディングのエンコーディング オブジェクトでは置換フォールバックが、コード ページ エンコーディングと 2 バイト文字セット \(DBCS\) エンコーディングのエンコーディング オブジェクトでは最適フォールバックが使用されます  \(詳しくは、「[最適フォールバック](../../../docs/standard/base-types/character-encoding.md#BestFit)」セクションをご覧ください。\)  
+  
+-   <xref:System.Text.Encoding.GetEncoding%2A?displayProperty=fullName> メソッドを呼び出します。このメソッドは、.NET Framework で使用できる任意のエンコーディング \(標準、コード ページ、または DBCS\) を返します。 オーバーロードを使用すると、エンコーダーおよびデコーダーの両方のフォールバック オブジェクトを指定できます。  
+  
 > [!NOTE]
-> 既定で、.NET Core では、コード ページ 28591 以外のコード ページ エンコーディングや Unicode エンコーディング (UTF-8 や UTF-16 など) を使用できません。 ただし、使用するアプリに、.NET Framework を対象とする標準の Windows アプリに含まれているコード ページ エンコーディングを追加できます。 詳細については、「[EncodingProvider](xref:System.Text.EncodingProvider)」のトピックを参照してください。 
-
-## <a name="selecting-an-encoding-class"></a>エンコーディング クラスの選択
-
-アプリケーションで使用するエンコーディングを選択できる場合は、Unicode エンコーディング (できれば [UTF8Encoding](xref:System.Text.UTF8Encoding) または [UnicodeEncoding](xref:System.Text.UnicodeEncoding)) を使用するようにしてください  (.NET でサポートされている Unicode エンコーディングには、そのほかに [UTF32Encoding](xref:System.Text.UTF32Encoding) もあります)。 
-
-ASCII エンコーディング ([ASCIIEncoding](xref:System.Text.ASCIIEncoding)) を使用しようとしている場合は、代わりに [UTF8Encoding](xref:System.Text.UTF8Encoding) を選択してください。 この&2; つのエンコーディングは、ASCII 文字セットに対する動作は変わりませんが、[UTF8Encoding](xref:System.Text.UTF8Encoding) には次のような利点があります。 
-
-* すべての Unicode 文字を表現できます ([ASCIIEncoding](xref:System.Text.ASCIIEncoding) でサポートされているのは U+0000 ～ U+007F の Unicode 文字値だけです)。
-
-* エラー検出に対応しており、セキュリティも強化されます。
-
-* できるだけ高速になるように調整されているため、他のエンコーディングよりも高速です。 全体が ASCII のコンテンツの場合でも、[UTF8Encoding](xref:System.Text.UTF8Encoding) で実行される演算は、[ASCIIEncoding](xref:System.Text.ASCIIEncoding) で実行される演算よりも高速になります。
-
-[ASCIIEncoding](xref:System.Text.ASCIIEncoding) は、レガシ アプリケーションの場合にのみ使用を検討するようにしてください。 ただし、レガシ アプリケーションでも、次のような理由で [UTF8Encoding](xref:System.Text.UTF8Encoding) の方が適していることもあります (既定の設定の場合)。
-
-* 厳密には ASCII でないコンテンツがアプリケーションに含まれている場合、それを [ASCIIEncoding](xref:System.Text.ASCIIEncoding) でエンコードすると、ASCII 以外の各文字は疑問符 (?) としてエンコードされます。 アプリケーションがこのデータをデコードすると、情報は失われます。
-
-
-* 厳密には ASCII でないコンテンツがアプリケーションに含まれている場合、それを [UTF8Encoding](xref:System.Text.UTF8Encoding) でエンコードすると、結果を ASCII として解釈しようとしても一見理解不能になります。 ただし、アプリケーションがこのデータを UTF-8 デコーダーを使用してデコードすると、データのラウンド トリップが正常に行われます。
-
-Web アプリケーションでは、Web 要求への応答としてクライアントに送信される文字に、クライアントで使用されているエンコーディングが反映されるようにする必要があります。 ほとんどの場合は、ユーザーが期待するエンコーディングでテキストを表示するために、[HttpResponse.ContentEncoding](xref:System.Net.HttpResponseHeader.ContentEncoding) プロパティを [HttpRequestHeader.ContentEncoding](xref:System.Net.HttpRequestHeader.ContentEncoding) プロパティの戻り値に設定する必要があります。
-
-## <a name="using-an-encoding-object"></a>エンコーディング オブジェクトの使用
-
-エンコーダーは、文字列 (通常は Unicode 文字) を対応する数値 (バイト) に変換します。 たとえば、ASCII エンコーダーを使用すると、Unicode 文字を ASCII に変換してコンソールに表示することができます。 この変換を実行するには、[Encoding.GetBytes](xref:System.Text.Encoding.GetBytes(System.Char[])) メソッドを呼び出します。 エンコードされた文字列を格納するために必要なバイト数をエンコードの実行前に確認するには、[GetByteCount](xref:System.Text.Encoding.GetByteCount(System.Char[])) メソッドを呼び出します。
-
-次の例では、1 つのバイト配列を使用して、文字列を&2; つの個別の操作でエンコードしています。 バイト配列内の次の ASCII エンコード済みバイト セットの開始位置を示すインデックスが保持されています。 この例では、[ASCIIEncoding.GetByteCount(String)](xref:System.Text.ASCIIEncoding.GetByteCount(System.String)) メソッドを呼び出して、エンコードされた文字列を格納するために十分な大きさがバイト配列にあるかどうかを確認します。 次に、[ASCIIEncoding.GetBytes(String, Int32, Int32, Byte[], Int32)](xref:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)) メソッドを呼び出して、文字列内の文字をエンコードします。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] strings= { "This is the first sentence. ", 
-                          "This is the second sentence. " };
-      Encoding asciiEncoding = Encoding.ASCII;
-
-      // Create array of adequate size.
-      byte[] bytes = new byte[49];
-      // Create index for current position of array.
-      int index = 0;
-
-      Console.WriteLine("Strings to encode:");
-      foreach (var stringValue in strings) {
-         Console.WriteLine("   {0}", stringValue);
-
-         int count = asciiEncoding.GetByteCount(stringValue);
-         if (count + index >=  bytes.Length)
-            Array.Resize(ref bytes, bytes.Length + 50);
-
-         int written = asciiEncoding.GetBytes(stringValue, 0, 
-                                              stringValue.Length, 
-                                              bytes, index);    
-
-         index = index + written; 
-      } 
-      Console.WriteLine("\nEncoded bytes:");
-      Console.WriteLine("{0}", ShowByteValues(bytes, index));
-      Console.WriteLine();
-
-      // Decode Unicode byte array to a string.
-      string newString = asciiEncoding.GetString(bytes, 0, index);
-      Console.WriteLine("Decoded: {0}", newString);
-   }
-
-   private static string ShowByteValues(byte[] bytes, int last ) 
-   {
-      string returnString = "   ";
-      for (int ctr = 0; ctr <= last - 1; ctr++) {
-         if (ctr % 20 == 0)
-            returnString += "\n   ";
-         returnString += String.Format("{0:X2} ", bytes[ctr]);
-      }
-      return returnString;
-   }
-}
-// The example displays the following output:
-//       Strings to encode:
-//          This is the first sentence.
-//          This is the second sentence.
-//       
-//       Encoded bytes:
-//       
-//          54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
-//          6E 74 65 6E 63 65 2E 20 54 68 69 73 20 69 73 20 74 68 65 20
-//          73 65 63 6F 6E 64 20 73 65 6E 74 65 6E 63 65 2E 20
-//       
-//       Decoded: This is the first sentence. This is the second sentence.
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim strings() As String = { "This is the first sentence. ", 
-                                  "This is the second sentence. " }
-      Dim asciiEncoding As Encoding = Encoding.ASCII
-
-      ' Create array of adequate size.
-      Dim bytes(50) As Byte
-      ' Create index for current position of array.
-      Dim index As Integer = 0
-
-      Console.WriteLine("Strings to encode:")
-      For Each stringValue In strings
-         Console.WriteLine("   {0}", stringValue)
-
-         Dim count As Integer = asciiEncoding.GetByteCount(stringValue)
-         If count + index >=  bytes.Length Then
-            Array.Resize(bytes, bytes.Length + 50)
-         End If
-         Dim written As Integer = asciiEncoding.GetBytes(stringValue, 0, 
-                                                         stringValue.Length, 
-                                                         bytes, index)    
-
-         index = index + written 
-      Next 
-      Console.WriteLine()
-      Console.WriteLine("Encoded bytes:")
-      Console.WriteLine("{0}", ShowByteValues(bytes, index))
-      Console.WriteLine()
-
-      ' Decode Unicode byte array to a string.
-      Dim newString As String = asciiEncoding.GetString(bytes, 0, index)
-      Console.WriteLine("Decoded: {0}", newString)
-   End Sub
-
-   Private Function ShowByteValues(bytes As Byte(), last As Integer) As String
-      Dim returnString As String = "   "
-      For ctr As Integer = 0 To last - 1
-         If ctr Mod 20 = 0 Then returnString += vbCrLf + "   "
-         returnString += String.Format("{0:X2} ", bytes(ctr))
-      Next
-      Return returnString
-   End Function
-End Module
-' The example displays the following output:
-'       Strings to encode:
-'          This is the first sentence.
-'          This is the second sentence.
-'       
-'       Encoded bytes:
-'       
-'          54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
-'          6E 74 65 6E 63 65 2E 20 54 68 69 73 20 69 73 20 74 68 65 20
-'          73 65 63 6F 6E 64 20 73 65 6E 74 65 6E 63 65 2E 20
-'       
-'       Decoded: This is the first sentence. This is the second sentence.
-```
-
-デコーダーは、特定の文字エンコーディングが反映されたバイト配列を、文字配列または文字列の一連の文字に変換します。 バイト配列を文字配列にデコードするには、[Encoding.GetChars](xref:System.Text.Encoding.GetChars(System.Byte[])) メソッドを呼び出します。 バイト配列を文字列にデコードするには、[GetString](xref:System.Text.Encoding.GetString(System.Byte[])) メソッドを呼び出します。 デコードされたバイトを格納するために必要な文字数をデコードの実行前に確認するには、[GetCharCount](xref:System.Text.Encoding.GetCharCount(System.Byte[])) メソッドを呼び出します。
-
-次の例では、3 つの文字列をエンコードした後、1 つの文字配列にデコードしています。 文字配列内の次のデコード済み文字セットの開始位置を示すインデックスが保持されています。 この例では、[GetCharCount](xref:System.Text.Encoding.GetCharCount(System.Byte[])) メソッドを呼び出して、デコードされたすべての文字を格納するために十分な大きさが文字配列にあるかどうかを確認します。 次に、[ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)](xref:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)) メソッドを呼び出して、バイト配列をデコードします。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] strings = { "This is the first sentence. ", 
-                           "This is the second sentence. ",
-                           "This is the third sentence. " };
-      Encoding asciiEncoding = Encoding.ASCII;
-      // Array to hold encoded bytes.
-      byte[] bytes;
-      // Array to hold decoded characters.
-      char[] chars = new char[50];
-      // Create index for current position of character array.
-      int index = 0;     
-
-      foreach (var stringValue in strings) {
-         Console.WriteLine("String to Encode: {0}", stringValue);
-         // Encode the string to a byte array.
-         bytes = asciiEncoding.GetBytes(stringValue);
-         // Display the encoded bytes.
-         Console.Write("Encoded bytes: ");
-         for (int ctr = 0; ctr < bytes.Length; ctr++)
-            Console.Write(" {0}{1:X2}", 
-                          ctr % 20 == 0 ? Environment.NewLine : "", 
-                          bytes[ctr]);
-         Console.WriteLine();
-
-         // Decode the bytes to a single character array.
-         int count = asciiEncoding.GetCharCount(bytes);
-         if (count + index >=  chars.Length)
-            Array.Resize(ref chars, chars.Length + 50);
-
-         int written = asciiEncoding.GetChars(bytes, 0, 
-                                              bytes.Length, 
-                                              chars, index);              
-         index = index + written;
-         Console.WriteLine();       
-      }
-
-      // Instantiate a single string containing the characters.
-      string decodedString = new string(chars, 0, index - 1);
-      Console.WriteLine("Decoded string: ");
-      Console.WriteLine(decodedString);
-   }
-}
-// The example displays the following output:
-//    String to Encode: This is the first sentence.
-//    Encoded bytes:
-//    54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
-//    6E 74 65 6E 63 65 2E 20
-//    
-//    String to Encode: This is the second sentence.
-//    Encoded bytes:
-//    54 68 69 73 20 69 73 20 74 68 65 20 73 65 63 6F 6E 64 20 73
-//    65 6E 74 65 6E 63 65 2E 20
-//    
-//    String to Encode: This is the third sentence.
-//    Encoded bytes:
-//    54 68 69 73 20 69 73 20 74 68 65 20 74 68 69 72 64 20 73 65
-//    6E 74 65 6E 63 65 2E 20
-//    
-//    Decoded string:
-//    This is the first sentence. This is the second sentence. This is the third sentence.
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim strings() As String = { "This is the first sentence. ", 
-                                  "This is the second sentence. ",
-                                  "This is the third sentence. " }
-      Dim asciiEncoding As Encoding = Encoding.ASCII
-      ' Array to hold encoded bytes.
-      Dim bytes() As Byte
-      ' Array to hold decoded characters.
-      Dim chars(50) As Char
-      ' Create index for current position of character array.
-      Dim index As Integer     
-
-      For Each stringValue In strings
-         Console.WriteLine("String to Encode: {0}", stringValue)
-         ' Encode the string to a byte array.
-         bytes = asciiEncoding.GetBytes(stringValue)
-         ' Display the encoded bytes.
-         Console.Write("Encoded bytes: ")
-         For ctr As Integer = 0 To bytes.Length - 1
-            Console.Write(" {0}{1:X2}", If(ctr Mod 20 = 0, vbCrLf, ""), 
-                                        bytes(ctr))
-         Next         
-         Console.WriteLine()
-
-         ' Decode the bytes to a single character array.
-         Dim count As Integer = asciiEncoding.GetCharCount(bytes)
-         If count + index >=  chars.Length Then
-            Array.Resize(chars, chars.Length + 50)
-         End If
-         Dim written As Integer = asciiEncoding.GetChars(bytes, 0, 
-                                                         bytes.Length, 
-                                                         chars, index)              
-         index = index + written
-         Console.WriteLine()       
-      Next
-
-      ' Instantiate a single string containing the characters.
-      Dim decodedString As New String(chars, 0, index - 1)
-      Console.WriteLine("Decoded string: ")
-      Console.WriteLine(decodedString)
-   End Sub
-End Module
-' The example displays the following output:
-'    String to Encode: This is the first sentence.
-'    Encoded bytes:
-'    54 68 69 73 20 69 73 20 74 68 65 20 66 69 72 73 74 20 73 65
-'    6E 74 65 6E 63 65 2E 20
-'    
-'    String to Encode: This is the second sentence.
-'    Encoded bytes:
-'    54 68 69 73 20 69 73 20 74 68 65 20 73 65 63 6F 6E 64 20 73
-'    65 6E 74 65 6E 63 65 2E 20
-'    
-'    String to Encode: This is the third sentence.
-'    Encoded bytes:
-'    54 68 69 73 20 69 73 20 74 68 65 20 74 68 69 72 64 20 73 65
-'    6E 74 65 6E 63 65 2E 20
-'    
-'    Decoded string:
-'    This is the first sentence. This is the second sentence. This is the third sentence.
-```
-
-[Encoding](xref:System.Text.Encoding) から派生するクラスのエンコード メソッドとデコード メソッドは、データ全体を処理するように設計されています。つまり、エンコードまたはデコードするすべてのデータが&1; 回のメソッド呼び出しで渡されます。 ただし、場合によっては、データがストリームで提供され、エンコードまたはデコードするデータを複数の読み取り操作で取得しなければならないこともあります。 このような場合は、エンコード操作またはデコード操作で、前回の実行時に保存した状態を呼び出す必要があります。 [Encoder](xref:System.Text.Encoder) および [Decoder](xref:System.Text.Decoder) から派生するクラスのメソッドでは、複数のメソッド呼び出しにまたがるエンコード操作とデコード操作を処理できます。
-
-特定のエンコーディングの [Encoder](xref:System.Text.Encoder) オブジェクトは、そのエンコーディングの [Encoding.GetEncoder](xref:System.Text.Encoding.GetEncoder) プロパティから取得できます。 特定のエンコーディングの [Decoder](xref:System.Text.Decoder) オブジェクトは、そのエンコーディングの [Encoding.GetDecoder](xref:System.Text.Encoding.GetDecoder) プロパティから取得できます。 デコード操作の場合、[Decoder](xref:System.Text.Decoder) から派生するクラスに含まれるのは [Decoder.GetChars](xref:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)) メソッドで、[Encoding.GetString](xref:System.Text.Encoding.GetString(System.Byte[])) に対応するメソッドはありません。
-
-次の例は、Unicode のバイト配列のデコードに [Encoding.GetChars](xref:System.Text.Encoding.GetChars(System.Byte[])) メソッドを使用する場合と [Decoder.GetChars](xref:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)) メソッドを使用する場合の違いを示しています。 この例では、いくつかの Unicode 文字を含む文字列をファイルにエンコードした後、この&2; つのデコード メソッドを使用して一度に&10; バイトずつデコードしています。 10 番目と&11; 番目のバイトに出現するサロゲート ペアは、別のメソッド呼び出しでデコードされます。 出力を見るとわかるように、[Encoding.GetChars](xref:System.Text.Encoding.GetChars(System.Byte[])) メソッドではこれらのバイトが正しくデコードされず、U+FFFD (REPLACEMENT CHARACTER) に置き換えられます。 一方、[Decoder.GetChars](xref:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)) メソッドでは、このバイト配列が正しくデコードされて、元の文字列を取得できます。
-
-```csharp
-using System;
-using System.IO;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      // Use default replacement fallback for invalid encoding.
-      UnicodeEncoding enc = new UnicodeEncoding(true, false, false);
-
-      // Define a string with various Unicode characters.
-      string str1 = "AB YZ 19 \uD800\udc05 \u00e4"; 
-      str1 += "Unicode characters. \u00a9 \u010C s \u0062\u0308"; 
-      Console.WriteLine("Created original string...\n");
-
-      // Convert string to byte array.                     
-      byte[] bytes = enc.GetBytes(str1);
-
-      FileStream fs = File.Create(@".\characters.bin");
-      BinaryWriter bw = new BinaryWriter(fs);
-      bw.Write(bytes);
-      bw.Close();
-
-      // Read bytes from file.
-      FileStream fsIn = File.OpenRead(@".\characters.bin");
-      BinaryReader br = new BinaryReader(fsIn);
-
-      const int count = 10;            // Number of bytes to read at a time. 
-      byte[] bytesRead = new byte[10]; // Buffer (byte array).
-      int read;                        // Number of bytes actually read. 
-      string str2 = String.Empty;      // Decoded string.
-
-      // Try using Encoding object for all operations.
-      do { 
-         read = br.Read(bytesRead, 0, count);
-         str2 += enc.GetString(bytesRead, 0, read); 
-      } while (read == count);
-      br.Close();
-      Console.WriteLine("Decoded string using UnicodeEncoding.GetString()...");
-      CompareForEquality(str1, str2);
-      Console.WriteLine();
-
-      // Use Decoder for all operations.
-      fsIn = File.OpenRead(@".\characters.bin");
-      br = new BinaryReader(fsIn);
-      Decoder decoder = enc.GetDecoder();
-      char[] chars = new char[50];
-      int index = 0;                   // Next character to write in array.
-      int written = 0;                 // Number of chars written to array.
-      do { 
-         read = br.Read(bytesRead, 0, count);
-         if (index + decoder.GetCharCount(bytesRead, 0, read) - 1 >= chars.Length) 
-            Array.Resize(ref chars, chars.Length + 50);
-
-         written = decoder.GetChars(bytesRead, 0, read, chars, index);
-         index += written;                          
-      } while (read == count);
-      br.Close();            
-      // Instantiate a string with the decoded characters.
-      string str3 = new String(chars, 0, index); 
-      Console.WriteLine("Decoded string using UnicodeEncoding.Decoder.GetString()...");
-      CompareForEquality(str1, str3); 
-   }
-
-   private static void CompareForEquality(string original, string decoded)
-   {
-      bool result = original.Equals(decoded);
-      Console.WriteLine("original = decoded: {0}", 
-                        original.Equals(decoded, StringComparison.Ordinal));
-      if (! result) {
-         Console.WriteLine("Code points in original string:");
-         foreach (var ch in original)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-         Console.WriteLine();
-
-         Console.WriteLine("Code points in decoded string:");
-         foreach (var ch in decoded)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-         Console.WriteLine();
-      }
-   }
-}
-// The example displays the following output:
-//    Created original string...
-//    
-//    Decoded string using UnicodeEncoding.GetString()...
-//    original = decoded: False
-//    Code points in original string:
-//    0041 0042 0020 0059 005A 0020 0031 0039 0020 D800 DC05 0020 00E4 0055 006E 0069 0063 006F
-//    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
-//    0020 0073 0020 0062 0308
-//    Code points in decoded string:
-//    0041 0042 0020 0059 005A 0020 0031 0039 0020 FFFD FFFD 0020 00E4 0055 006E 0069 0063 006F
-//    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
-//    0020 0073 0020 0062 0308
-//    
-//    Decoded string using UnicodeEncoding.Decoder.GetString()...
-//    original = decoded: True
-```
-
-```vb
-Imports System.IO
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      ' Use default replacement fallback for invalid encoding.
-      Dim enc As New UnicodeEncoding(True, False, False)
-
-      ' Define a string with various Unicode characters.
-      Dim str1 As String = String.Format("AB YZ 19 {0}{1} {2}", 
-                                         ChrW(&hD800), ChrW(&hDC05), ChrW(&h00e4))
-      str1 += String.Format("Unicode characters. {0} {1} s {2}{3}", 
-                            ChrW(&h00a9), ChrW(&h010C), ChrW(&h0062), ChrW(&h0308))
-      Console.WriteLine("Created original string...")
-      Console.WriteLine()
-
-      ' Convert string to byte array.                     
-      Dim bytes() As Byte = enc.GetBytes(str1)
-
-      Dim fs As FileStream = File.Create(".\characters.bin")
-      Dim bw As New BinaryWriter(fs)
-      bw.Write(bytes)
-      bw.Close()
-
-      ' Read bytes from file.
-      Dim fsIn As FileStream = File.OpenRead(".\characters.bin")
-      Dim br As New BinaryReader(fsIn)
-
-      Const count As Integer = 10      ' Number of bytes to read at a time. 
-      Dim bytesRead(9) As Byte         ' Buffer (byte array).
-      Dim read As Integer              ' Number of bytes actually read. 
-      Dim str2 As String = ""          ' Decoded string.
-
-      ' Try using Encoding object for all operations.
-      Do 
-         read = br.Read(bytesRead, 0, count)
-         str2 += enc.GetString(bytesRead, 0, read) 
-      Loop While read = count
-      br.Close()
-      Console.WriteLine("Decoded string using UnicodeEncoding.GetString()...")
-      CompareForEquality(str1, str2)
-      Console.WriteLine()
-
-      ' Use Decoder for all operations.
-      fsIn = File.OpenRead(".\characters.bin")
-      br = New BinaryReader(fsIn)
-      Dim decoder As Decoder = enc.GetDecoder()
-      Dim chars(50) As Char
-      Dim index As Integer = 0         ' Next character to write in array.
-      Dim written As Integer = 0       ' Number of chars written to array.
-      Do 
-         read = br.Read(bytesRead, 0, count)
-         If index + decoder.GetCharCount(bytesRead, 0, read) - 1 >= chars.Length Then 
-            Array.Resize(chars, chars.Length + 50)
-         End If   
-         written = decoder.GetChars(bytesRead, 0, read, chars, index)
-         index += written                          
-      Loop While read = count
-      br.Close()            
-      ' Instantiate a string with the decoded characters.
-      Dim str3 As New String(chars, 0, index) 
-      Console.WriteLine("Decoded string using UnicodeEncoding.Decoder.GetString()...")
-      CompareForEquality(str1, str3) 
-   End Sub
-
-   Private Sub CompareForEquality(original As String, decoded As String)
-      Dim result As Boolean = original.Equals(decoded)
-      Console.WriteLine("original = decoded: {0}", 
-                        original.Equals(decoded, StringComparison.Ordinal))
-      If Not result Then
-         Console.WriteLine("Code points in original string:")
-         For Each ch In original
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next
-         Console.WriteLine()
-
-         Console.WriteLine("Code points in decoded string:")
-         For Each ch In decoded
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next
-         Console.WriteLine()
-      End If
-   End Sub
-End Module
-' The example displays the following output:
-'    Created original string...
-'    
-'    Decoded string using UnicodeEncoding.GetString()...
-'    original = decoded: False
-'    Code points in original string:
-'    0041 0042 0020 0059 005A 0020 0031 0039 0020 D800 DC05 0020 00E4 0055 006E 0069 0063 006F
-'    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
-'    0020 0073 0020 0062 0308
-'    Code points in decoded string:
-'    0041 0042 0020 0059 005A 0020 0031 0039 0020 FFFD FFFD 0020 00E4 0055 006E 0069 0063 006F
-'    0064 0065 0020 0063 0068 0061 0072 0061 0063 0074 0065 0072 0073 002E 0020 00A9 0020 010C
-'    0020 0073 0020 0062 0308
-'    
-'    Decoded string using UnicodeEncoding.Decoder.GetString()...
-'    original = decoded: True
-```
-
-## <a name="choosing-a-fallback-strategy"></a>フォールバック ストラテジの選択
-
-メソッドから文字のエンコードまたはデコードを行おうとしたときにマッピングが存在しない場合は、失敗したマッピングの処理方法を決めるフォールバック ストラテジを実装する必要があります。 次の&3; 種類のフォールバック ストラテジがあります。 
-
-* 最適フォールバック
-
-* 置換フォールバック
-
-* 例外フォールバック
-
+>  Unicode 規格では、サポートされるすべてのスクリプトについて、各文字にコード ポイント \(数値\) と名前を割り当てています。 たとえば、文字 "A" は U\+0041 というコード ポイントと、"LATIN CAPITAL LETTER A" という名前で表されます。 UTF \(Unicode Transformation Format\) エンコーディングは、そのコード ポイントを 1 つ以上のバイトのシーケンスにエンコードする方法を定義します。 Unicode エンコーディング方式を使用すると、任意の文字セットの文字を 1 つのエンコーディング方式で表現できるため、国際対応アプリケーションの開発が簡素化されます。 これにより、アプリケーション開発者が、特定の言語または書記体系の文字を表すために使用されるエンコーディング方式を追跡する必要はなくなります。また、データを破損することなく、各国のシステム間でデータを共有できます。  
+>   
+>  .NET Framework では、Unicode 規格によって定義されている UTF\-8、UTF\-16、および UTF\-32 の 3 つのエンコーディングをサポートしています。 詳しくは、[Unicode ホーム ページ](http://go.microsoft.com/fwlink/?LinkId=37123)の Unicode 標準をご覧ください。  
+  
+ .NET Framework で使用できるすべてのエンコーディングに関する情報を取得するには、<xref:System.Text.Encoding.GetEncodings%2A?displayProperty=fullName> メソッドを呼び出します。 .NET Framework でサポートされている文字エンコーディング システムを次の表に示します。  
+  
+|エンコード|クラス|説明|長所\/短所|  
+|-----------|---------|--------|------------|  
+|ASCII|<xref:System.Text.ASCIIEncoding>|バイトの下位 7 ビットを使用して、限られた範囲の文字をエンコードします。|ASCII エンコーディングでは、U\+0000 から U\+007F までの文字値しかサポートされていないため、ほとんどの場合、国際対応アプリケーションでは ASCII エンコーディングの使用は不適切です。|  
+|UTF\-7|<xref:System.Text.UTF7Encoding>|文字を 7 ビット ASCII 文字のシーケンスとして表します。 ASCII 以外の Unicode 文字は、ASCII 文字のエスケープ シーケンスによって表します。|UTF\-7 は、電子メールやニュースグループなどのプロトコルをサポートします。 ただし、UTF\-7 は特に安全でも堅牢でもありません。 場合によっては、1 ビットの変更により、UTF\-7 文字列全体の解釈が完全に変わる場合があります。 他の場合には、異なる UTF\-7 文字列がエンコードによって同じテキストになる可能性もあります。 ASCII 以外の文字を含むシーケンスの場合、UTF\-7 は UTF\-8 よりも多くの空間を必要とし、エンコードとデコードに時間がかかります。 したがって、可能であれば、UTF\-7 ではなく UTF\-8 を使用してください。|  
+|UTF\-8|<xref:System.Text.UTF8Encoding>|各 Unicode コード ポイントが、1 バイトから 4 バイトのシーケンスとして表現されます。|UTF\-8 では、8 ビット データ サイズがサポートされており、既存の多くのオペレーティング システムに対応できます。 ASCII 範囲の文字については、UTF\-8 は ASCII エンコーディングと一致し、より広範な文字を提供します。 ただし、CJK \(中国語、日本語、韓国語\) スクリプトでは、UTF\-8 の各文字に 3 バイトが必要となることがあり、データ サイズが UTF\-16 より大きくなる可能性があります。 ただし、CJK 範囲によるサイズの増加が HTML タグなどの ASCII データのサイズによって相殺されることもあります。|  
+|UTF\-16|<xref:System.Text.UnicodeEncoding>|各 Unicode コード ポイントが、1 つまたは 2 つの 16 ビット整数のシーケンスとして表現されます。 ほとんどの一般的な Unicode 文字で必要とされる UTF\-16 コード ポイントは 1 つだけです。ただし、Unicode の補助文字 \(U\+10000 以上\) には 2 つの UTF\-16 サロゲート コード ポイントが必要です。 リトル エンディアンとビッグ エンディアンの両方のバイト順をサポートしています。|UTF\-16 エンコーディングは、共通言語ランタイムでは <xref:System.Char> および <xref:System.String> の値を表現するために、Windows オペレーティング システムでは `WCHAR` の値を表現するために使用されています。|  
+|UTF\-32|<xref:System.Text.UTF32Encoding>|各 Unicode コード ポイントが 32 ビット整数として表現されます。 リトル エンディアンとビッグ エンディアンの両方のバイト順をサポートしています。|UTF\-32 エンコーディングは、エンコードされた空白がきわめて重要な意味を持つオペレーティング システムで、アプリケーションが UTF\-16 エンコーディングのサロゲート コード ポイント動作を回避する必要がある場合に使用します。 ディスプレイ上でレンダリングされる 1 つのグリフも複数の UTF\-32 文字でエンコードされることがあります。|  
+|ANSI\/ISO エンコーディング||さまざまなコード ページがサポートされています。 Windows オペレーティング システムでは、特定の言語または言語グループをサポートするためにコード ページが使用されます。 .NET Framework でサポートされているコード ページの一覧表については、<xref:System.Text.Encoding> クラスを参照してください。 特定のコード ページのエンコーディング オブジェクトを取得するには、<xref:System.Text.Encoding.GetEncoding%28System.Int32%29?displayProperty=fullName> メソッドを呼び出します。|コード ページには、0 から始まる 256 個のコード ポイントが含まれています。 コード ポイント 0 ～ 127 は、ほとんどのコード ページで ASCII 文字セットを表しますが、コード ポイント 128 ～ 255 が表す文字は、コード ページによって異なります。 たとえば、コード ページ 1252 には、英語、ドイツ語、フランス語などのラテン語書記体系の文字を表す文字コードが含まれています。 このコード ページ 1252 の最後の 128 個のコード ポイントには、アクセント記号付き文字が含まれています。 また、コード ページ 1253 には、ギリシャ語書記体系で必要とされる文字コードが含まれています。 このコード ページ 1253 の最後の 128 個のコード ポイントには、ギリシャ文字が含まれています。 このため、ANSI コード ページに依存するアプリケーションでギリシャ語とドイツ語を同じテキスト ストリームに格納する場合には、参照先コード ページを示す識別子を含める必要があります。|  
+|2 バイト文字セット \(DBCS\) エンコーディング||中国語、日本語、韓国語など、256 個以上の文字から成る言語をサポートします。 DBCS では、コード ポイントのペア \(2 バイト\) が 1 つの文字を表します。 DBCS エンコーディングでは、<xref:System.Text.Encoding.IsSingleByte%2A?displayProperty=fullName> プロパティは `false` を返します。 特定の DBCS のエンコーディング オブジェクトを取得するには、<xref:System.Text.Encoding.GetEncoding%28System.Int32%29?displayProperty=fullName> メソッドを呼び出します。|DBCS では、コード ポイントのペア \(2 バイト\) が 1 つの文字を表します。 アプリケーションで DBCS データを処理する場合、DBCS 文字の最初のバイト \(先頭バイト\) は、その後に続く後続バイトと組み合わせて処理されます。 このスキームでは、日本語や中国語など、2 種類の言語を組み合わせて同じデータ ストリームで使用することはできません。これは、2 バイト コード ポイントのペアが表す文字が、コード ページによって異なるためです。|  
+  
+ これらのエンコーディングを使用することにより、Unicode 文字だけでなく、レガシ アプリケーションで最もよく使用されているエンコーディングにも対応できます。 また、<xref:System.Text.Encoding> から派生するクラスを定義し、そのメンバーをオーバーライドして、カスタム エンコーディングを作成することもできます。  
+  
+### プラットフォームに関する注意事項: [!INCLUDE[net_core](../../../includes/net-core-md.md)]  
+ 既定で、[!INCLUDE[net_core](../../../includes/net-core-md.md)] では、コード ページ 28591 以外のコード ページ エンコーディングや Unicode エンコーディング \(UTF\-8 や UTF\-16 など\) を使用できません。 ただし、使用するアプリに、.NET Framework を対象とする標準の Windows アプリに含まれているコード ページ エンコーディングを追加できます。 詳細については、「<xref:System.Text.CodePagesEncodingProvider>」のトピックを参照してください。  
+  
+<a name="Selecting"></a>   
+## エンコーディング クラスの選択  
+ アプリケーションで使用するエンコーディングを選択できる場合は、Unicode エンコーディング \(できれば <xref:System.Text.UTF8Encoding> または <xref:System.Text.UnicodeEncoding>\) を使用するようにしてください  \(.NET Framework でサポートされている Unicode エンコーディングには、そのほかに <xref:System.Text.UTF32Encoding> もあります\)。  
+  
+ ASCII エンコーディング \(<xref:System.Text.ASCIIEncoding>\) を使用しようとしている場合は、代わりに <xref:System.Text.UTF8Encoding> を選択してください。 この 2 つのエンコーディングは、ASCII 文字セットに対する動作は変わりませんが、<xref:System.Text.UTF8Encoding> には次のような利点があります。  
+  
+-   すべての Unicode 文字を表現できます \(<xref:System.Text.ASCIIEncoding> でサポートされているのは U\+0000 ～ U\+007F の Unicode 文字値だけです\)。  
+  
+-   エラー検出に対応しており、セキュリティも強化されます。  
+  
+-   できるだけ高速になるように調整されているため、他のエンコーディングよりも高速です。 全体が ASCII のコンテンツの場合でも、<xref:System.Text.UTF8Encoding> で実行される演算は、<xref:System.Text.ASCIIEncoding> で実行される演算よりも高速になります。  
+  
+ <xref:System.Text.ASCIIEncoding> は、レガシ アプリケーションの場合にのみ使用を検討するようにしてください。 ただし、レガシ アプリケーションでも、次のような理由で <xref:System.Text.UTF8Encoding> の方が適していることもあります \(既定の設定の場合\)。  
+  
+-   厳密には ASCII でないコンテンツがアプリケーションに含まれている場合、それを <xref:System.Text.ASCIIEncoding> でエンコードすると、ASCII 以外の各文字は疑問符 \(?\) としてエンコードされます。 アプリケーションがこのデータをデコードすると、情報は失われます。  
+  
+-   厳密には ASCII でないコンテンツがアプリケーションに含まれている場合、それを <xref:System.Text.UTF8Encoding> でエンコードすると、結果を ASCII として解釈しようとしても一見理解不能になります。 ただし、アプリケーションがこのデータを UTF\-8 デコーダーを使用してデコードすると、データのラウンド トリップが正常に行われます。  
+  
+ Web アプリケーションでは、Web 要求への応答としてクライアントに送信される文字に、クライアントで使用されているエンコーディングが反映されるようにする必要があります。 ほとんどの場合は、ユーザーが期待するエンコーディングでテキストを表示するために、<xref:System.Web.HttpResponse.ContentEncoding%2A?displayProperty=fullName> プロパティを <xref:System.Web.HttpRequest.ContentEncoding%2A?displayProperty=fullName> プロパティの戻り値に設定する必要があります。  
+  
+<a name="Using"></a>   
+## エンコーディング オブジェクトの使用  
+ エンコーダーは、文字列 \(通常は Unicode 文字\) を対応する数値 \(バイト\) に変換します。 たとえば、ASCII エンコーダーを使用すると、Unicode 文字を ASCII に変換してコンソールに表示することができます。 この変換を実行するには、<xref:System.Text.Encoding.GetBytes%2A?displayProperty=fullName> メソッドを呼び出します。 エンコードされた文字列を格納するために必要なバイト数をエンコードの実行前に確認するには、<xref:System.Text.Encoding.GetByteCount%2A> メソッドを呼び出します。  
+  
+ 次の例では、1 つのバイト配列を使用して、文字列を 2 つの個別の操作でエンコードしています。 バイト配列内の次の ASCII エンコード済みバイト セットの開始位置を示すインデックスが保持されています。 この例では、<xref:System.Text.ASCIIEncoding.GetByteCount%28System.String%29?displayProperty=fullName> メソッドを呼び出して、エンコードされた文字列を格納するために十分な大きさがバイト配列にあるかどうかを確認します。 次に、[ASCIIEncoding.GetBytes\(String, Int32, Int32, Byte\<xref:System.Text.ASCIIEncoding.GetBytes%28System.String%2CSystem.Int32%2CSystem.Int32%2CSystem.Byte%5B%5D%2CSystem.Int32%29?displayProperty=fullName> メソッドを呼び出して、文字列の文字をエンコードします。  
+  
+ [!code-csharp[Conceptual.Encoding#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/getbytes1.cs#8)]
+ [!code-vb[Conceptual.Encoding#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/getbytes1.vb#8)]  
+  
+ デコーダーは、特定の文字エンコーディングが反映されたバイト配列を、文字配列または文字列の一連の文字に変換します。 バイト配列を文字配列にデコードするには、<xref:System.Text.Encoding.GetChars%2A?displayProperty=fullName> メソッドを呼び出します。 バイト配列を文字列にデコードするには、<xref:System.Text.Encoding.GetString%2A> メソッドを呼び出します。 デコードされたバイトを格納するために必要な文字数をデコードの実行前に確認するには、<xref:System.Text.Encoding.GetCharCount%2A> メソッドを呼び出します。  
+  
+ 次の例では、3 つの文字列をエンコードした後、1 つの文字配列にデコードしています。 文字配列内の次のデコード済み文字セットの開始位置を示すインデックスが保持されています。 この例では、<xref:System.Text.ASCIIEncoding.GetCharCount%2A> メソッドを呼び出して、デコードされたすべての文字を格納するために十分な大きさが文字配列にあるかどうかを確認します。 次に、[ASCIIEncoding.GetChars\(Byte\[\], Int32, Int32, Char\<xref:System.Text.ASCIIEncoding.GetChars%28System.Byte%5B%5D%2CSystem.Int32%2CSystem.Int32%2CSystem.Char%5B%5D%2CSystem.Int32%29?displayProperty=fullName> メソッドを呼び出して、バイト配列をデコードします。  
+  
+ [!code-csharp[Conceptual.Encoding#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/getchars1.cs#9)]
+ [!code-vb[Conceptual.Encoding#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/getchars1.vb#9)]  
+  
+ <xref:System.Text.Encoding> から派生するクラスのエンコード メソッドとデコード メソッドは、データ全体を処理するように設計されています。つまり、エンコードまたはデコードするすべてのデータが 1 回のメソッド呼び出しで渡されます。 ただし、場合によっては、データがストリームで提供され、エンコードまたはデコードするデータを複数の読み取り操作で取得しなければならないこともあります。 このような場合は、エンコード操作またはデコード操作で、前回の実行時に保存した状態を呼び出す必要があります。<xref:System.Text.Encoder> および <xref:System.Text.Decoder> から派生するクラスのメソッドでは、複数のメソッド呼び出しにまたがるエンコード操作とデコード操作を処理できます。  
+  
+ 特定のエンコーディングの <xref:System.Text.Encoder> オブジェクトは、そのエンコーディングの <xref:System.Text.Encoding.GetEncoder%2A?displayProperty=fullName> プロパティから取得できます。 特定のエンコーディングの <xref:System.Text.Decoder> オブジェクトは、そのエンコーディングの <xref:System.Text.Encoding.GetDecoder%2A?displayProperty=fullName> プロパティから取得できます。 デコード操作の場合、<xref:System.Text.Decoder> から派生するクラスに含まれるのは <xref:System.Text.Decoder.GetChars%2A?displayProperty=fullName> メソッドだけで、<xref:System.Text.Encoding.GetString%2A?displayProperty=fullName> に対応するメソッドはありません。  
+  
+ 次の例は、Unicode のバイト配列のデコードに <xref:System.Text.Encoding.GetChars%2A?displayProperty=fullName> メソッドを使用する場合と <xref:System.Text.Decoder.GetChars%2A?displayProperty=fullName> メソッドを使用する場合の違いを示しています。 この例では、いくつかの Unicode 文字を含む文字列をファイルにエンコードした後、この 2 つのデコード メソッドを使用して一度に 10 バイトずつデコードしています。 10 番目と 11 番目のバイトに出現するサロゲート ペアは、別のメソッド呼び出しでデコードされます。 出力を見るとわかるように、<xref:System.Text.Encoding.GetChars%2A?displayProperty=fullName> メソッドではこれらのバイトが正しくデコードされず、U\+FFFD \(REPLACEMENT CHARACTER\) に置き換えられます。 一方、<xref:System.Text.Decoder.GetChars%2A?displayProperty=fullName> メソッドでは、このバイト配列が正しくデコードされて、元の文字列を取得できます。  
+  
+ [!code-csharp[Conceptual.Encoding#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/stream1.cs#10)]
+ [!code-vb[Conceptual.Encoding#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/stream1.vb#10)]  
+  
+<a name="FallbackStrategy"></a>   
+## フォールバック ストラテジの選択  
+ メソッドから文字のエンコードまたはデコードを行おうとしたときにマッピングが存在しない場合は、失敗したマッピングの処理方法を決めるフォールバック ストラテジを実装する必要があります。 次の 3 種類のフォールバック ストラテジがあります。  
+  
+-   最適フォールバック  
+  
+-   置換フォールバック  
+  
+-   例外フォールバック  
+  
 > [!IMPORTANT]
-> エンコード操作で最も一般的な問題は、Unicode 文字を特定のコード ページ エンコーディングにマップできない場合に発生します。 デコード操作で最も一般的な問題は、無効なバイト シーケンスを有効な Unicode 文字に変換できない場合に発生します。 そのため、個々のエンコーディング オブジェクトで使用されるフォールバック ストラテジを把握しておく必要があります。 エンコーディング オブジェクトをインスタンス化するときには、可能な限り、そのオブジェクトで使用されるフォールバック ストラテジを指定するようにしてください。
- 
-### <a name="best-fit-fallback"></a>最適フォールバック
-
-ターゲット エンコード内に厳密な一致がない文字について、エンコーダーは類似した文字へのマッピングを試みることができます  (最適フォールバックは主にエンコード時の問題であり、デコード時の問題ではありません。 Unicode に正常にマッピングできない文字を含むコード ページはほとんどありません)。最適フォールバックは、[Encoding.GetEncoding(Int32)](xref:System.Text.Encoding.GetEncoding(System.Int32)) および [Encoding.GetEncoding(String)](xref:System.Text.Encoding.GetEncoding(System.String)) の各オーバーロードによって取得されるコード ページ エンコーディングと&2; バイト文字セット エンコーディングの既定のフォールバック ストラテジです。
-
+>  エンコード操作で最も一般的な問題は、Unicode 文字を特定のコード ページ エンコーディングにマップできない場合に発生します。 デコード操作で最も一般的な問題は、無効なバイト シーケンスを有効な Unicode 文字に変換できない場合に発生します。 そのため、個々のエンコーディング オブジェクトで使用されるフォールバック ストラテジを把握しておく必要があります。 エンコーディング オブジェクトをインスタンス化するときには、可能な限り、そのオブジェクトで使用されるフォールバック ストラテジを指定するようにしてください。  
+  
+<a name="BestFit"></a>   
+### 最適フォールバック  
+ ターゲット エンコード内に厳密な一致がない文字について、エンコーダーは類似した文字へのマッピングを試みることができます  \(最適フォールバックは主にエンコード時の問題であり、デコード時の問題ではありません。 Unicode に正常にマッピングできない文字を含むコード ページはほとんどありません\)。 最適フォールバックは、<xref:System.Text.Encoding.GetEncoding%28System.Int32%29?displayProperty=fullName> および <xref:System.Text.Encoding.GetEncoding%28System.String%29?displayProperty=fullName> の各オーバーロードによって取得されるコード ページ エンコーディングと 2 バイト文字セット エンコーディングの既定のフォールバック ストラテジです。  
+  
+> [!NOTE]
+>  .NET Framework の Unicode エンコーディング クラス \(<xref:System.Text.UTF8Encoding>、<xref:System.Text.UnicodeEncoding>、および <xref:System.Text.UTF32Encoding>\) では、理論上すべての文字セットのすべての文字がサポートされているため、これらのクラスを使用すると最適フォールバックの問題を解消できます。  
+  
+ 最適なストラテジはコード ページごとに異なるため、詳細には文書化されていません。 たとえば、全角のアルファベットがより一般的な半角のアルファベットにマッピングされるコード ページもあれば、 そのようなマッピングが行われないコード ページもあります。 積極的な最適ストラテジでも、一部のエンコーディングの一部の文字には可能な対応がない場合があります。 たとえば、中国語の漢字からコード ページ 1252 への適切なマッピングはありません。 その場合は、置換文字列が使用されます。 既定では、この文字列は単一の QUESTION MARK \(疑問符\) \(U\+003F\) です。  
+  
+ 次の例では、コード ページ 1252 \(西ヨーロッパ言語の Windows コード ページ\) を使用して、最適マッピングとその欠点を示しています。 まず、<xref:System.Text.Encoding.GetEncoding%28System.Int32%29?displayProperty=fullName> メソッドを使用して、コード ページ 1252 のエンコーディング オブジェクトを取得します。 このエンコーディング オブジェクトは、サポートされていない Unicode 文字に対して既定で最適マッピングを使用します。 次に、スペースで区切られた 3 つの非 ASCII 文字 \(CIRCLED LATIN CAPITAL LETTER S \(U\+24C8\)、SUPERSCRIPT FIVE \(U\+2075\)、および INFINITY \(U\+221E\)\) を含む文字列をインスタンス化します。 出力を見るとわかるように、この文字列をエンコードすると、スペースを除く元の 3 つの文字が、QUESTION MARK \(U\+003F\)、DIGIT FIVE \(U\+0035\)、および DIGIT EIGHT \(U\+0038\) に置き換えられます。 DIGIT EIGHT は、サポートされていない INFINITY 文字の代替として最適とは言えません。QUESTION MARK は、元の文字に対応するマッピングがなかったことを示します。  
+  
+ [!code-csharp[Conceptual.Encoding#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/bestfit1.cs#1)]
+ [!code-vb[Conceptual.Encoding#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/bestfit1.vb#1)]  
+  
+ 最適マッピングは、Unicode データをコード ページ データにエンコードする <xref:System.Text.Encoding> オブジェクトの既定の動作です。レガシ アプリケーションの中には、この動作に依存するものがあります。 ただし、ほとんどの新しいアプリケーションでは、セキュリティ上の理由から、最適動作の使用を避ける必要があります。 たとえば、アプリケーションで、最適エンコードを使用してドメイン名を付けないでください。  
+  
 > [!NOTE]
-> .NET の Unicode エンコーディング クラス ([UTF8Encoding](xref:System.Text.UTF8Encoding)、[UnicodeEncoding](xref:System.Text.UnicodeEncoding)、および [UTF32Encoding](xref:System.Text.UTF32Encoding)) では、理論上すべての文字セットのすべての文字がサポートされているため、これらのクラスを使用すると最適フォールバックの問題を解消できます。 
- 
-
-最適なストラテジはコード ページごとに異なるため、詳細には文書化されていません。 たとえば、全角のアルファベットがより一般的な半角のアルファベットにマッピングされるコード ページもあれば、 そのようなマッピングが行われないコード ページもあります。 積極的な最適ストラテジでも、一部のエンコーディングの一部の文字には可能な対応がない場合があります。 たとえば、中国語の漢字からコード ページ 1252 への適切なマッピングはありません。 その場合は、置換文字列が使用されます。 既定では、この文字列は単一の QUESTION MARK (疑問符) (U+003F) です。
-
-次の例では、コード ページ 1252 (西ヨーロッパ言語の Windows コード ページ) を使用して、最適マッピングとその欠点を示しています。 まず、[Encoding.GetEncoding(Int32](xref:System.Text.Encoding.GetEncoding(System.Int32)) メソッドを使用して、コード ページ 1252 のエンコーディング オブジェクトを取得します。 このエンコーディング オブジェクトは、サポートされていない Unicode 文字に対して既定で最適マッピングを使用します。 次に、スペースで区切られた&3; つの非 ASCII 文字 (CIRCLED LATIN CAPITAL LETTER S (U+24C8)、SUPERSCRIPT FIVE (U+2075)、および INFINITY (U+221E)) を含む文字列をインスタンス化します。 出力を見るとわかるように、この文字列をエンコードすると、スペースを除く元の&3; つの文字が、QUESTION MARK (U+003F)、DIGIT FIVE (U+0035)、および DIGIT EIGHT (U+0038) に置き換えられます。 DIGIT EIGHT は、サポートされていない INFINITY 文字の代替として最適とは言えません。QUESTION MARK は、元の文字に対応するマッピングがなかったことを示します。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      // Get an encoding for code page 1252 (Western Europe character set).
-      Encoding cp1252 = Encoding.GetEncoding(1252);
-
-      // Define and display a string.
-      string str = "\u24c8 \u2075 \u221e";
-      Console.WriteLine("Original string: " + str);
-      Console.Write("Code points in string: ");
-      foreach (var ch in str)
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-      Console.WriteLine("\n");   
-
-      // Encode a Unicode string.
-      Byte[] bytes = cp1252.GetBytes(str);
-      Console.Write("Encoded bytes: ");
-      foreach (byte byt in bytes)
-         Console.Write("{0:X2} ", byt);
-      Console.WriteLine("\n");
-
-      // Decode the string.
-      string str2 = cp1252.GetString(bytes);
-      Console.WriteLine("String round-tripped: {0}", str.Equals(str2));
-      if (! str.Equals(str2)) {
-         Console.WriteLine(str2);
-         foreach (var ch in str2)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-      }
-   }
-}
-// The example displays the following output:
-//       Original string: Ⓢ ⁵ ∞
-//       Code points in string: 24C8 0020 2075 0020 221E
-//       
-//       Encoded bytes: 3F 20 35 20 38
-//       
-//       String round-tripped: False
-//       ? 5 8
-//       003F 0020 0035 0020 0038
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      ' Get an encoding for code page 1252 (Western Europe character set).
-      Dim cp1252 As Encoding = Encoding.GetEncoding(1252)
-
-      ' Define and display a string.
-      Dim str As String = String.Format("{0} {1} {2}", ChrW(&h24c8), ChrW(&H2075), ChrW(&h221E))
-      Console.WriteLine("Original string: " + str)
-      Console.Write("Code points in string: ")
-      For Each ch In str
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-      Next
-      Console.WriteLine()   
-      Console.WriteLine()
-
-      ' Encode a Unicode string.
-      Dim bytes() As Byte = cp1252.GetBytes(str)
-      Console.Write("Encoded bytes: ")
-      For Each byt In bytes
-         Console.Write("{0:X2} ", byt)
-      Next
-      Console.WriteLine()
-      Console.WriteLine()
-
-      ' Decode the string.
-      Dim str2 As String = cp1252.GetString(bytes)
-      Console.WriteLine("String round-tripped: {0}", str.Equals(str2))
-      If Not str.Equals(str2) Then
-         Console.WriteLine(str2)
-         For Each ch In str2
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next
-      End If
-   End Sub
-End Module
-' The example displays the following output:
-'       Original string: Ⓢ ⁵ ∞
-'       Code points in string: 24C8 0020 2075 0020 221E
-'       
-'       Encoded bytes: 3F 20 35 20 38
-'       
-'       String round-tripped: False
-'       ? 5 8
-'       003F 0020 0035 0020 0038
-```
-
-最適マッピングは、Unicode データをコード ページ データにエンコードする [Encoding](xref:System.Text.Encoding) オブジェクトの既定の動作です。レガシ アプリケーションの中には、この動作に依存するものがあります。 ただし、ほとんどの新しいアプリケーションでは、セキュリティ上の理由から、最適動作の使用を避ける必要があります。 たとえば、アプリケーションで、最適エンコードを使用してドメイン名を付けないでください。
-
-> [!Note]
-> エンコーディングに対してカスタムの最適フォールバック マッピングを実装することもできます。 詳細については、「[カスタム フォールバック ストラテジの実装](#implementing-a-custom-fallback-strategy)」を参照してください。
- 
-エンコーディング オブジェクトの既定値が最適フォールバックである場合、[Encoding](xref:System.Text.Encoding) オブジェクトを取得するときに別のフォールバック ストラテジを選択することもできます。そのためには、[Encoding.GetEncoding(Int32, EncoderFallback, DecoderFallback)](xref:System.Text.Encoding.GetEncoding(System.Int32,System.Text.EncoderFallback,System.Text.DecoderFallback)) または [Encoding.GetEncoding(String, EncoderFallback, DecoderFallback)](xref:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)) のオーバーロードを呼び出します。 次のセクションでは、コード ページ 1252 にマップできない文字をアスタリスク (\*) に置き換える例を紹介します。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      Encoding cp1252r = Encoding.GetEncoding(1252, 
-                                  new EncoderReplacementFallback("*"),
-                                  new DecoderReplacementFallback("*"));
-
-      string str1 = "\u24C8 \u2075 \u221E";
-      Console.WriteLine(str1);
-      foreach (var ch in str1)
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-      Console.WriteLine();
-
-      byte[] bytes = cp1252r.GetBytes(str1);
-      string str2 = cp1252r.GetString(bytes);
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2));
-      if (! str1.Equals(str2)) {
-         Console.WriteLine(str2);
-         foreach (var ch in str2)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-         Console.WriteLine();
-      } 
-   }
-}
-// The example displays the following output:
-//       Ⓢ ⁵ ∞
-//       24C8 0020 2075 0020 221E
-//       Round-trip: False
-//       * * *
-//       002A 0020 002A 0020 002A
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim cp1252r As Encoding = Encoding.GetEncoding(1252, 
-                                         New EncoderReplacementFallback("*"),
-                                         New DecoderReplacementFallback("*"))
-
-      Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
-      Console.WriteLine(str1)
-      For Each ch In str1
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-      Next    
-      Console.WriteLine()
-
-      Dim bytes() As Byte = cp1252r.GetBytes(str1)
-      Dim str2 As String = cp1252r.GetString(bytes)
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
-      If Not str1.Equals(str2) Then
-         Console.WriteLine(str2)
-         For Each ch In str2
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next    
-         Console.WriteLine()
-      End If 
-   End Sub
-End Module
-' The example displays the following output:
-'       Ⓢ ⁵ ∞
-'       24C8 0020 2075 0020 221E
-'       Round-trip: False
-'       * * *
-'       002A 0020 002A 0020 002A
-```
-
-### <a name="replacement-fallback"></a>置換フォールバック
-
-ターゲット スキームに厳密な一致がなく、マップできる適切な文字もない文字について、アプリケーションで置換文字または置換文字列を指定することができます。 これは Unicode デコーダーの既定の動作です。Unicode デコーダーでは、デコードできない&2; バイトのシーケンスが REPLACEMENT_CHARACTER (U+FFFD) に置き換えられます。 また、[ASCIIEncoding](xref:System.Text.ASCIIEncoding) クラスの既定の動作でもあり、その場合はエンコードまたはデコードできない文字が疑問符に置き換えられます。 次の例は、前の例の Unicode 文字列に対する文字置換を示しています。 出力を見るとわかるように、ASCII バイト値にデコードできない文字は 0x3F (疑問符に対応する ASCII コード) に置き換えられます。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      Encoding enc = Encoding.ASCII;
-
-      string str1 = "\u24C8 \u2075 \u221E";
-      Console.WriteLine(str1);
-      foreach (var ch in str1)
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-      Console.WriteLine("\n");
-
-      // Encode the original string using the ASCII encoder.
-      byte[] bytes = enc.GetBytes(str1);
-      Console.Write("Encoded bytes: ");
-      foreach (var byt in bytes)
-         Console.Write("{0:X2} ", byt);
-      Console.WriteLine("\n");
-
-      // Decode the ASCII bytes.
-      string str2 = enc.GetString(bytes);
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2));
-      if (! str1.Equals(str2)) {
-         Console.WriteLine(str2);
-         foreach (var ch in str2)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-         Console.WriteLine();
-      } 
-   }
-}
-// The example displays the following output:
-//       Ⓢ ⁵ ∞
-//       24C8 0020 2075 0020 221E
-//       
-//       Encoded bytes: 3F 20 3F 20 3F
-//       
-//       Round-trip: False
-//       ? ? ?
-//       003F 0020 003F 0020 003F
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim enc As Encoding = Encoding.Ascii
-
-      Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
-      Console.WriteLine(str1)
-      For Each ch In str1
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-      Next    
-      Console.WriteLine()
-      Console.WriteLine() 
-
-      ' Encode the original string using the ASCII encoder.
-      Dim bytes() As Byte = enc.GetBytes(str1)
-      Console.Write("Encoded bytes: ")
-      For Each byt In bytes
-         Console.Write("{0:X2} ", byt)
-      Next
-      Console.WriteLine()
-      Console.WriteLine()
-
-      ' Decode the ASCII bytes.
-      Dim str2 As String = enc.GetString(bytes)
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
-      If Not str1.Equals(str2) Then
-         Console.WriteLine(str2)
-         For Each ch In str2
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next    
-         Console.WriteLine()
-      End If 
-   End Sub
-End Module
-' The example displays the following output:
-'       Ⓢ ⁵ ∞
-'       24C8 0020 2075 0020 221E
-'       
-'       Encoded bytes: 3F 20 3F 20 3F
-'       
-'       Round-trip: False
-'       ? ? ?
-'       003F 0020 003F 0020 003F
-```
-
-.NET には、エンコード操作またはデコード操作で正確にマップできない文字を置換文字列に置き換える [EncoderReplacementFallback](xref:System.Text.EncoderReplacementFallback) クラスと [DecoderReplacementFallback](xref:System.Text.DecoderReplacementFallback) クラスが含まれています。 この置換文字列は、既定では疑問符ですが、クラス コンストラクターのオーバーロードを呼び出して別の文字列を選択することもできます。 通常は単一の文字を使用しますが、単一でなくてもかまいません。 次の例では、置換文字列としてアスタリスク (\*) を使用する [EncoderReplacementFallback](xref:System.Text.EncoderReplacementFallback) オブジェクトをインスタンス化して、コード ページ 1252 のエンコーダーの動作を変更しています。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      Encoding cp1252r = Encoding.GetEncoding(1252, 
-                                  new EncoderReplacementFallback("*"),
-                                  new DecoderReplacementFallback("*"));
-
-      string str1 = "\u24C8 \u2075 \u221E";
-      Console.WriteLine(str1);
-      foreach (var ch in str1)
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-      Console.WriteLine();
-
-      byte[] bytes = cp1252r.GetBytes(str1);
-      string str2 = cp1252r.GetString(bytes);
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2));
-      if (! str1.Equals(str2)) {
-         Console.WriteLine(str2);
-         foreach (var ch in str2)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-         Console.WriteLine();
-      } 
-   }
-}
-// The example displays the following output:
-//       Ⓢ ⁵ ∞
-//       24C8 0020 2075 0020 221E
-//       Round-trip: False
-//       * * *
-//       002A 0020 002A 0020 002A
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim cp1252r As Encoding = Encoding.GetEncoding(1252, 
-                                         New EncoderReplacementFallback("*"),
-                                         New DecoderReplacementFallback("*"))
-
-      Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
-      Console.WriteLine(str1)
-      For Each ch In str1
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-      Next    
-      Console.WriteLine()
-
-      Dim bytes() As Byte = cp1252r.GetBytes(str1)
-      Dim str2 As String = cp1252r.GetString(bytes)
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
-      If Not str1.Equals(str2) Then
-         Console.WriteLine(str2)
-         For Each ch In str2
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next    
-         Console.WriteLine()
-      End If 
-   End Sub
-End Module
-' The example displays the following output:
-'       Ⓢ ⁵ ∞
-'       24C8 0020 2075 0020 221E
-'       Round-trip: False
-'       * * *
-'       002A 0020 002A 0020 002A
-```
-
+>  エンコーディングに対してカスタムの最適フォールバック マッピングを実装することもできます。 詳しくは、「[カスタム フォールバック ストラテジの実装](../../../docs/standard/base-types/character-encoding.md#Custom)」セクションをご覧ください。  
+  
+ エンコーディング オブジェクトの既定のフォールバック ストラテジが最適フォールバックである場合、<xref:System.Text.Encoding> オブジェクトを取得するときに別のフォールバック ストラテジを選択することもできます。そのためには、<xref:System.Text.Encoding.GetEncoding%28System.Int32%2CSystem.Text.EncoderFallback%2CSystem.Text.DecoderFallback%29?displayProperty=fullName> または <xref:System.Text.Encoding.GetEncoding%28System.String%2CSystem.Text.EncoderFallback%2CSystem.Text.DecoderFallback%29?displayProperty=fullName> のオーバーロードを呼び出します。 次のセクションでは、コード ページ 1252 にマップできない文字をアスタリスク \(\*\) に置き換える例を紹介します。  
+  
+ [!code-csharp[Conceptual.Encoding#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/bestfit1a.cs#3)]
+ [!code-vb[Conceptual.Encoding#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/bestfit1a.vb#3)]  
+  
+<a name="Replacement"></a>   
+### 置換フォールバック  
+ ターゲット スキームに厳密な一致がなく、マップできる適切な文字もない文字について、アプリケーションで置換文字または置換文字列を指定することができます。 これは Unicode デコーダーの既定の動作です。Unicode デコーダーでは、デコードできない 2 バイトのシーケンスが REPLACEMENT\_CHARACTER \(U\+FFFD\) に置き換えられます。 また、<xref:System.Text.ASCIIEncoding> クラスの既定の動作でもあり、その場合はエンコードまたはデコードできない文字が疑問符に置き換えられます。 次の例は、前の例の Unicode 文字列に対する文字置換を示しています。 出力を見るとわかるように、ASCII バイト値にデコードできない文字は 0x3F \(疑問符に対応する ASCII コード\) に置き換えられます。  
+  
+ [!code-csharp[Conceptual.Encoding#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/replacementascii.cs#2)]
+ [!code-vb[Conceptual.Encoding#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/replacementascii.vb#2)]  
+  
+ .NET Framework には、エンコード操作またはデコード操作で正確にマップできない文字を置換文字列に置き換える <xref:System.Text.EncoderReplacementFallback> クラスと <xref:System.Text.DecoderReplacementFallback> クラスが含まれています。 この置換文字列は、既定では疑問符ですが、クラス コンストラクターのオーバーロードを呼び出して別の文字列を選択することもできます。 通常は単一の文字を使用しますが、単一でなくてもかまいません。 次の例では、置換文字列としてアスタリスク \(\*\) を使用する <xref:System.Text.EncoderReplacementFallback> オブジェクトをインスタンス化して、コード ページ 1252 のエンコーダーの動作を変更しています。  
+  
+ [!code-csharp[Conceptual.Encoding#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/bestfit1a.cs#3)]
+ [!code-vb[Conceptual.Encoding#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/bestfit1a.vb#3)]  
+  
 > [!NOTE]
-> エンコーディング用の置換クラスを実装することもできます。 詳細については、「[カスタム フォールバック ストラテジの実装](#implementing-a-custom-fallback-strategy)」を参照してください。
- 
-置換文字列としては、QUESTION MARK (U+003F) のほか、特に Unicode 文字列に正しく変換できないバイト シーケンスをデコードする場合に、Unicode REPLACEMENT CHARACTER (U+FFFD) がよく使用されます。 ただし、置換文字列は自由に選択できます。置換文字列に複数の文字を含めることもできます。
-
-### <a name="exception-fallback"></a>例外フォールバック
-
-最適フォールバックや置換文字列を提供する代わりに、エンコーダーで一連の文字をエンコードできない場合に [EncoderFallbackException](xref:System.Text.EncoderFallbackException) をスローしたり、デコーダーでバイト配列をデコードできない場合に [DecoderFallbackException](xref:System.Text.DecoderFallbackException) をスローしたりすることもできます。 エンコードおよびデコード操作で例外をスローするには、[EncoderFallbackException](xref:System.Text.EncoderFallbackException) オブジェクトと [DecoderFallbackException](xref:System.Text.DecoderFallbackException) オブジェクトをそれぞれ [Encoding.GetEncoding(String, EncoderFallback, DecoderFallback)](xref:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)) メソッドに指定します。 次の例は、ASCIIEncoding クラスによる例外フォールバックを示しています。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      Encoding enc = Encoding.GetEncoding("us-ascii", 
-                                          new EncoderExceptionFallback(), 
-                                          new DecoderExceptionFallback());
-
-      string str1 = "\u24C8 \u2075 \u221E";
-      Console.WriteLine(str1);
-      foreach (var ch in str1)
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-      Console.WriteLine("\n");
-
-      // Encode the original string using the ASCII encoder.
-      byte[] bytes = {};
-      try {
-         bytes = enc.GetBytes(str1);
-         Console.Write("Encoded bytes: ");
-         foreach (var byt in bytes)
-            Console.Write("{0:X2} ", byt);
-
-         Console.WriteLine();
-      }
-      catch (EncoderFallbackException e) {
-         Console.Write("Exception: ");
-         if (e.IsUnknownSurrogate())
-            Console.WriteLine("Unable to encode surrogate pair 0x{0:X4} 0x{1:X3} at index {2}.", 
-                              Convert.ToUInt16(e.CharUnknownHigh), 
-                              Convert.ToUInt16(e.CharUnknownLow), 
-                              e.Index);
-         else
-            Console.WriteLine("Unable to encode 0x{0:X4} at index {1}.", 
-                              Convert.ToUInt16(e.CharUnknown), 
-                              e.Index);
-         return;
-      }
-      Console.WriteLine();
-
-      // Decode the ASCII bytes.
-      try {
-         string str2 = enc.GetString(bytes);
-         Console.WriteLine("Round-trip: {0}", str1.Equals(str2));
-         if (! str1.Equals(str2)) {
-            Console.WriteLine(str2);
-            foreach (var ch in str2)
-               Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-            Console.WriteLine();
-         } 
-      }
-      catch (DecoderFallbackException e) {
-         Console.Write("Unable to decode byte(s) ");
-         foreach (byte unknown in e.BytesUnknown)
-            Console.Write("0x{0:X2} ");
-
-         Console.WriteLine("at index {0}", e.Index);
-      }
-   }
-}
-// The example displays the following output:
-//       Ⓢ ⁵ ∞
-//       24C8 0020 2075 0020 221E
-//       
-//       Exception: Unable to encode 0x24C8 at index 0.
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim enc As Encoding = Encoding.GetEncoding("us-ascii", 
-                                                 New EncoderExceptionFallback(), 
-                                                 New DecoderExceptionFallback())
-
-      Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&h24C8), ChrW(&h2075), ChrW(&h221E))
-      Console.WriteLine(str1)
-      For Each ch In str1
-         Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-      Next    
-      Console.WriteLine()
-      Console.WriteLine() 
-
-      ' Encode the original string using the ASCII encoder.
-      Dim bytes() As Byte = {}
-      Try
-         bytes = enc.GetBytes(str1)
-         Console.Write("Encoded bytes: ")
-         For Each byt In bytes
-            Console.Write("{0:X2} ", byt)
-         Next
-         Console.WriteLine()
-      Catch e As EncoderFallbackException
-         Console.Write("Exception: ")
-         If e.IsUnknownSurrogate() Then
-            Console.WriteLine("Unable to encode surrogate pair 0x{0:X4} 0x{1:X3} at index {2}.", 
-                              Convert.ToUInt16(e.CharUnknownHigh), 
-                              Convert.ToUInt16(e.CharUnknownLow), 
-                              e.Index)
-         Else
-            Console.WriteLine("Unable to encode 0x{0:X4} at index {1}.", 
-                              Convert.ToUInt16(e.CharUnknown), 
-                              e.Index)
-         End If                              
-         Exit Sub
-      End Try
-      Console.WriteLine()
-
-      ' Decode the ASCII bytes.
-      Try
-         Dim str2 As String = enc.GetString(bytes)
-         Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
-         If Not str1.Equals(str2) Then
-            Console.WriteLine(str2)
-            For Each ch In str2
-               Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-            Next    
-            Console.WriteLine()
-         End If 
-      Catch e As DecoderFallbackException
-         Console.Write("Unable to decode byte(s) ")
-         For Each unknown As Byte In e.BytesUnknown
-            Console.Write("0x{0:X2} ")
-         Next
-         Console.WriteLine("at index {0}", e.Index)
-      End Try
-   End Sub
-End Module
-' The example displays the following output:
-'       Ⓢ ⁵ ∞
-'       24C8 0020 2075 0020 221E
-'       
-'       Exception: Unable to encode 0x24C8 at index 0.
-```
-
+>  エンコーディング用の置換クラスを実装することもできます。 詳しくは、「[カスタム フォールバック ストラテジの実装](../../../docs/standard/base-types/character-encoding.md#Custom)」セクションをご覧ください。  
+  
+ 置換文字列としては、QUESTION MARK \(U\+003F\) のほか、特に Unicode 文字列に正しく変換できないバイト シーケンスをデコードする場合に、Unicode REPLACEMENT CHARACTER \(U\+FFFD\) がよく使用されます。 ただし、置換文字列は自由に選択できます。置換文字列に複数の文字を含めることもできます。  
+  
+<a name="Exception"></a>   
+### 例外フォールバック  
+ 最適フォールバックや置換文字列を提供する代わりに、エンコーダーで一連の文字をエンコードできない場合に <xref:System.Text.EncoderFallbackException> をスローしたり、デコーダーでバイト配列をデコードできない場合に <xref:System.Text.DecoderFallbackException> をスローしたりすることもできます。 エンコード操作およびデコード操作で例外をスローするには、<xref:System.Text.EncoderExceptionFallback> メソッドに <xref:System.Text.DecoderExceptionFallback> オブジェクトおよび <xref:System.Text.Encoding.GetEncoding%28System.String%2CSystem.Text.EncoderFallback%2CSystem.Text.DecoderFallback%29?displayProperty=fullName> オブジェクトを渡します。 次の例は、<xref:System.Text.ASCIIEncoding> クラスによる例外フォールバックを示しています。  
+  
+ [!code-csharp[Conceptual.Encoding#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/exceptionascii.cs#4)]
+ [!code-vb[Conceptual.Encoding#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/exceptionascii.vb#4)]  
+  
 > [!NOTE]
-> エンコード操作用のカスタム例外ハンドラーを実装することもできます。 詳細については、「[カスタム フォールバック ストラテジの実装](#implementing-a-custom-fallback-strategy)」を参照してください。
- 
-[EncoderFallbackException](xref:System.Text.EncoderFallbackException) オブジェクトと [DecoderFallbackException](xref:System.Text.DecoderFallbackException) オブジェクトは、例外を引き起こした状況について以下の情報を提供します。 
-
-* [EncoderFallbackException](xref:System.Text.EncoderFallbackException) オブジェクトに含まれている [IsUnknownSurrogate](xref:System.Text.EncoderFallbackException.IsUnknownSurrogate) メソッドにより、エンコードできない文字が不明なサロゲート ペアか (この場合は `true` が返されます)、不明な単一文字か (この場合は `false` が返されます) が示されます。 サロゲート ペアの文字は、[EncoderFallbackException.CharUnknownHigh](xref:System.Text.EncoderFallbackException.CharUnknownHigh) プロパティと [EncoderFallbackException.CharUnknownLow](xref:System.Text.EncoderFallbackException.CharUnknownLow) プロパティから取得できます。 不明な単一文字は、[EncoderFallbackException.CharUnknown](xref:System.Text.EncoderFallbackException.CharUnknown) プロパティから取得できます。 また、[EncoderFallbackException.Index](xref:System.Text.EncoderFallbackException.Index) プロパティにより、エンコードできない最初の文字が見つかった文字列内の位置が示されます。
-
-* [DecoderFallbackException](xref:System.Text.DecoderFallbackException) オブジェクトに含まれている [BytesUnknown](xref:System.Text.DecoderFallbackException.BytesUnknown) プロパティにより、デコードできないバイト配列が返されます。 また、[DecoderFallbackException.Index](xref:System.Text.DecoderFallbackException.Index) プロパティにより、不明なバイトの開始位置が示されます。
-
-[EncoderFallbackException](xref:System.Text.EncoderFallbackException) オブジェクトと [DecoderFallbackException](xref:System.Text.DecoderFallbackException) オブジェクトでは、例外に関する診断情報は十分に入手できますが、エンコード バッファーやデコード バッファーにアクセスすることはできません。 したがって、エンコード メソッド内またはデコード メソッド内で無効なデータを置換したり修正したりすることはできません。
-
-## <a name="implementing-a-custom-fallback-strategy"></a>カスタム フォールバック ストラテジの実装
-
-.NET には、コード ページによって内部的に実装される最適マッピングに加えて、フォールバック ストラテジを実装するための次のクラスが含まれています。
-
-* [EncoderReplacementFallback](xref:System.Text.EncoderReplacementFallback) および [EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer)。エンコード操作中に文字を置換します。
-
-* [DecoderReplacementFallback](xref:System.Text.DecoderReplacementFallback) および [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer)。デコード操作中に文字を置換します。
-
-* [EncoderExceptionFallback](xref:System.Text.EncoderExceptionFallback) および [EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer)。文字をエンコードできない場合に [EncoderFallbackException](xref:System.Text.EncoderFallbackException) をスローします。
-
-* [DecoderExceptionFallback](xref:System.Text.DecoderExceptionFallback) および [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer)。文字をエンコードできない場合に [DecoderFallbackException](xref:System.Text.DecoderFallbackException) をスローします。
-
-さらに、次の手順に従って、最適フォールバック、置換フォールバック、または例外フォールバックを使用するカスタム ソリューションを実装できます。 
-
-1. エンコード操作の場合は [EncoderFallback](xref:System.Text.EncoderFallback)、デコード操作の場合は [DecoderFallback](xref:System.Text.DecoderFallback) の派生クラスを作成します。
-
-2. エンコード操作の場合は [EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer)、デコード操作の場合は [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer) の派生クラスを作成します。
-
-3. 例外フォールバックにおいて、あらかじめ定義されている [EncoderFallbackException](xref:System.Text.EncoderFallbackException) クラスと [DecoderFallbackException](xref:System.Text.DecoderFallbackException) クラスが目的に合わない場合は、[Exception](xref:System.Exception) や [ArgumentException](xref:System.ArgumentException) などの例外オブジェクトから派生クラスを作成します。
-
-### <a name="deriving-from-encoderfallback-or-decoderfallback"></a>EncoderFallback または DecoderFallback からの派生
-
-カスタム フォールバック ソリューションを実装するには、エンコード操作の場合は [EncoderFallback](xref:System.Text.EncoderFallback)、デコード操作の場合は [DecoderFallback](xref:System.Text.DecoderFallback) を継承するクラスを作成する必要があります。 これらのクラスのインスタンスは [Encoding.GetEncoding(String, EncoderFallback, DecoderFallback)](xref:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)) メソッドに渡され、エンコーディング クラスとフォールバックの実装の仲介役として機能します。
-
-エンコーダーまたはデコーダーのカスタム フォールバック ソリューションを作成するときには、次のメンバーを実装する必要があります。
-
-* [EncoderFallback.MaxCharCount](xref:System.Text.EncoderFallback.MaxCharCount) プロパティまたは [DecoderFallback.MaxCharCount](xref:System.Text.DecoderFallback.MaxCharCount) プロパティ。最適、置換、例外の各フォールバックで単一の文字を置き換えるために返すことのできる文字の最大数を返します。 カスタム例外フォールバックの場合は&0; になります。 
-
-* [EncoderFallback.CreateFallbackBuffer](xref:System.Text.EncoderFallback.CreateFallbackBuffer) メソッドまたは [DecoderFallback.CreateFallbackBuffer](xref:System.Text.DecoderFallback.CreateFallbackBuffer) メソッド。[EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer) または [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer) のカスタム実装を返します。 このメソッドは、エンコーダーで正しくエンコードできない文字が初めて検出されたとき、またはデコーダーで正しくデコードできないバイトが初めて検出されたときに呼び出されます。
-
-### <a name="deriving-from-encoderfallbackbuffer-or-decoderfallbackbuffer"></a>EncoderFallbackBuffer または DecoderFallbackBuffer からの派生
-
-カスタム フォールバック ソリューションを実装するには、エンコード操作の場合は [EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer)、デコード操作の場合は [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer) を継承するクラスも作成する必要があります。 これらのクラスのインスタンスは、[EncoderFallback](xref:System.Text.EncoderFallback) クラスおよび [DecoderFallback](xref:System.Text.DecoderFallback) クラスの `CreateFallbackBuffer` メソッドによって返されます。 [EncoderFallback.CreateFallbackBuffer](xref:System.Text.EncoderFallback.CreateFallbackBuffer) メソッドは、エンコーダーでエンコードできない文字が初めて検出されたときに呼び出され、[DecoderFallback.CreateFallbackBuffer](xref:System.Text.DecoderFallback.CreateFallbackBuffer) メソッドは、デコーダーでデコードできないバイトが検出されたときに呼び出されます。 [EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer) クラスと[DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer) クラスは、フォールバックの実装を提供します。 各インスタンスは、エンコードできない文字またはデコードできないバイト シーケンスを置き換えるフォールバック文字を含むバッファーを表します。
-
-エンコーダーまたはデコーダーのカスタム フォールバック ソリューションを作成するときには、次のメンバーを実装する必要があります。
-
-* [EncoderFallbackBuffer.Fallback](xref:System.Text.EncoderFallbackBuffer.%23ctor) メソッドまたは [DecoderFallbackBuffer.Fallback](xref:System.Text.DecoderFallbackBuffer.Fallback(System.Byte[],System.Int32)) メソッド。 [EncoderFallbackBuffer.Fallback](xref:System.Text.EncoderFallbackBuffer.Fallback(System.Char,System.Char,System.Int32)) は、エンコーダーによって呼び出され、エンコードできない文字に関する情報をフォールバック バッファーに提供します。 エンコードされる文字はサロゲート ペアである場合もあるため、このメソッドはオーバーロードされます。 最初のオーバーロードには、エンコードされる文字と、その文字列内のインデックスが渡されます。 2 番目のオーバーロードには、上位および下位のサロゲートと、その文字列内のインデックスが渡されます。 [DecoderFallbackBuffer.Fallback](xref:System.Text.DecoderFallbackBuffer.Fallback(System.Byte[],System.Int32)) メソッドは、デコーダーによって呼び出され、デコードできないバイトに関する情報をフォールバック バッファーに提供します。 このメソッドには、デコードできないバイト配列と、最初のバイトのインデックスが渡されます。 フォールバック メソッドは、フォールバック バッファーが最適な文字または置換文字を提供できる場合は `true`、それ以外の場合は `false` を返します。 例外フォールバックの場合は例外をスローします。
-
-* [EncoderFallbackBuffer.GetNextChar](xref:System.Text.EncoderFallbackBuffer.GetNextChar) メソッドまたは [DecoderFallbackBuffer.GetNextChar](xref:System.Text.DecoderFallbackBuffer.GetNextChar) メソッド。フォールバック バッファーから次の文字を取得するために、エンコーダーまたはデコーダーによって繰り返し呼び出されます。 すべてのフォールバック文字を返し終わったら、このメソッドは U+0000 を返す必要があります。 
-
-* [EncoderFallbackBuffer.Remaining](xref:System.Text.EncoderFallbackBuffer.Remaining) プロパティまたは [DecoderFallbackBuffer.Remaining](xref:System.Text.DecoderFallbackBuffer.Remaining) プロパティ。フォールバック バッファー内の残りの文字数を返します。
-
-* [EncoderFallbackBuffer.MovePrevious](xref:System.Text.EncoderFallbackBuffer.MovePrevious) メソッドまたは [DecoderFallbackBuffer.MovePrevious](xref:System.Text.DecoderFallbackBuffer.MovePrevious) メソッド。フォールバック バッファー内の現在の位置を前の文字に移動します。
-
-* [EncoderFallbackBuffer.Reset](xref:System.Text.EncoderFallbackBuffer.Reset) メソッドまたは [DecoderFallbackBuffer.Reset](xref:System.Text.DecoderFallbackBuffer.Reset) メソッド。フォールバック バッファーを再初期化します。
-
-フォールバックの実装が最適フォールバックまたは置換フォールバックの場合は、[EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer) と [DecoderFallbackBuffer](xref:System.Text.DecoderFallbackBuffer) の派生クラスで、2 つのプライベート インスタンス フィールド (バッファー内の正確な文字数と、次に返される文字のインデックス) も保持します。
-
-### <a name="an-encoderfallback-example"></a>EncoderFallback の例
-
-前の例では、置換フォールバックを使用して、対応する ASCII 文字がない Unicode 文字をアスタリスク (\*) に置き換えました。 次の例では、代わりに最適フォールバックのカスタム実装を使用して、非 ASCII 文字のマッピングを改善しています。
-
-次のコードでは、[EncoderFallback](xref:System.Text.EncoderFallback) から派生する `CustomMapper` という名前のクラスを定義して、非 ASCII 文字の最適マッピングを処理します。 このクラスの `CreateFallbackBuffer` メソッドは、[EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer) の実装を提供する `CustomMapperFallbackBuffer` オブジェクトを返します。 `CustomMapper` クラスは、[Dictionary&lt;TKey, TValue&gt;](xref:System.Collections.Generic.Dictionary%602) オブジェクトを使用して、サポートされていない Unicode 文字 (キー値) と、それらに対応する 8 ビット文字とのマッピングを格納します (64 ビット整数の 2 つの連続するバイトに格納されます)。 このマッピングをフォールバック バッファーで使用できるようにするには、`CustomMapper` のインスタンスを `CustomMapperFallbackBuffer` のクラス コンストラクターにパラメーターとして渡します。 最も長いマッピングは Unicode 文字 U+221E に対応する文字列 "INF" なので、`MaxCharCount` プロパティは 3 を返します。 
-
-```csharp
-public class CustomMapper : EncoderFallback
-{
-   public string DefaultString;
-   internal Dictionary<ushort, ulong> mapping;
-
-   public CustomMapper() : this("*")
-   {   
-   }
-
-   public CustomMapper(string defaultString)
-   {
-      this.DefaultString = defaultString;
-
-      // Create table of mappings
-      mapping = new Dictionary<ushort, ulong>();
-      mapping.Add(0x24C8, 0x53);
-      mapping.Add(0x2075, 0x35);
-      mapping.Add(0x221E, 0x49004E0046);
-   }
-
-   public override EncoderFallbackBuffer CreateFallbackBuffer()
-   {
-      return new CustomMapperFallbackBuffer(this);
-   }
-
-   public override int MaxCharCount
-   {
-      get { return 3; }
-   } 
-}
-```
-
-```vb
-Public Class CustomMapper : Inherits EncoderFallback
-   Public DefaultString As String
-   Friend mapping As Dictionary(Of UShort, ULong)
-
-   Public Sub New()
-      Me.New("?")
-   End Sub
-
-   Public Sub New(ByVal defaultString As String)
-      Me.DefaultString = defaultString
-
-      ' Create table of mappings
-      mapping = New Dictionary(Of UShort, ULong)
-      mapping.Add(&H24C8, &H53)
-      mapping.Add(&H2075, &H35)
-      mapping.Add(&H221E, &H49004E0046)
-   End Sub
-
-   Public Overrides Function CreateFallbackBuffer() As System.Text.EncoderFallbackBuffer
-      Return New CustomMapperFallbackBuffer(Me)
-   End Function
-
-   Public Overrides ReadOnly Property MaxCharCount As Integer
-      Get
-         Return 3
-      End Get
-   End Property
-End Class
-```
-
-次のコードでは、[EncoderFallbackBuffer](xref:System.Text.EncoderFallbackBuffer) から派生する `CustomMapperFallbackBuffer` クラスを定義しています。 `CustomMapper` インスタンスで定義されている、最適マッピングを含むディクショナリは、クラス コンストラクターから取得できます。 このクラスの `Fallback` メソッドは、ASCII エンコーダーでエンコードできない Unicode 文字がマッピング ディクショナリで定義されている場合は `true` を返し、それ以外の場合は `false` を返します。 フォールバックのたびに、プライベート変数 `count` は返される残りの文字数を示し、プライベート変数 `index` は次に返される文字の文字列バッファー内 (`charsToReturn` 内) の位置を示します。 
-
-```csharp
-public class CustomMapperFallbackBuffer : EncoderFallbackBuffer
-{
-   int count = -1;                   // Number of characters to return
-   int index = -1;                   // Index of character to return
-   CustomMapper fb; 
-   string charsToReturn; 
-
-   public CustomMapperFallbackBuffer(CustomMapper fallback)
-   {
-      this.fb = fallback;
-   }
-
-   public override bool Fallback(char charUnknownHigh, char charUnknownLow, int index)
-   {
-      // Do not try to map surrogates to ASCII.
-      return false;
-   }
-
-   public override bool Fallback(char charUnknown, int index)
-   {
-      // Return false if there are already characters to map.
-      if (count >= 1) return false;
-
-      // Determine number of characters to return.
-      charsToReturn = String.Empty;
-
-      ushort key = Convert.ToUInt16(charUnknown);
-      if (fb.mapping.ContainsKey(key)) {
-         byte[] bytes = BitConverter.GetBytes(fb.mapping[key]);
-         int ctr = 0;
-         foreach (var byt in bytes) {
-            if (byt > 0) {
-               ctr++;
-               charsToReturn += (char) byt;
-            }
-         }
-         count = ctr;
-      }
-      else {
-         // Return default.
-         charsToReturn = fb.DefaultString;
-         count = 1;
-      }
-      this.index = charsToReturn.Length - 1;
-
-      return true;
-   }
-
-   public override char GetNextChar()
-   {
-      // We'll return a character if possible, so subtract from the count of chars to return.
-      count--;
-      // If count is less than zero, we've returned all characters.
-      if (count < 0) 
-         return '\u0000';
-
-      this.index--;
-      return charsToReturn[this.index + 1];
-   }
-
-   public override bool MovePrevious()
-   {
-      // Original: if count >= -1 and pos >= 0
-      if (count >= -1) {
-         count++;
-         return true;
-      }
-      else {
-         return false;
-      }
-   }
-
-   public override int Remaining 
-   {
-      get { return count < 0 ? 0 : count; }
-   }
-
-   public override void Reset()
-   {
-      count = -1;
-      index = -1;
-   }
-}
-```
-
-```vb
-Public Class CustomMapperFallbackBuffer : Inherits EncoderFallbackBuffer
-
-   Dim count As Integer = -1        ' Number of characters to return
-   Dim index As Integer = -1        ' Index of character to return
-   Dim fb As CustomMapper
-   Dim charsToReturn As String
-
-   Public Sub New(ByVal fallback As CustomMapper)
-      MyBase.New()
-      Me.fb = fallback
-   End Sub
-
-   Public Overloads Overrides Function Fallback(ByVal charUnknownHigh As Char, ByVal charUnknownLow As Char, ByVal index As Integer) As Boolean
-      ' Do not try to map surrogates to ASCII.
-      Return False
-   End Function
-
-   Public Overloads Overrides Function Fallback(ByVal charUnknown As Char, ByVal index As Integer) As Boolean
-      ' Return false if there are already characters to map.
-      If count >= 1 Then Return False
-
-      ' Determine number of characters to return.
-      charsToReturn = String.Empty
-
-      Dim key As UShort = Convert.ToUInt16(charUnknown)
-      If fb.mapping.ContainsKey(key) Then
-         Dim bytes() As Byte = BitConverter.GetBytes(fb.mapping.Item(key))
-         Dim ctr As Integer
-         For Each byt In bytes
-            If byt > 0 Then
-               ctr += 1
-               charsToReturn += Chr(byt)
-            End If
-         Next
-         count = ctr
-      Else
-         ' Return default.
-         charsToReturn = fb.DefaultString
-         count = 1
-      End If
-      Me.index = charsToReturn.Length - 1
-
-      Return True
-   End Function
-
-   Public Overrides Function GetNextChar() As Char
-      ' We'll return a character if possible, so subtract from the count of chars to return.
-      count -= 1
-      ' If count is less than zero, we've returned all characters.
-      If count < 0 Then Return ChrW(0)
-
-      Me.index -= 1
-      Return charsToReturn(Me.index + 1)
-   End Function
-
-   Public Overrides Function MovePrevious() As Boolean
-      ' Original: if count >= -1 and pos >= 0
-      If count >= -1 Then
-         count += 1
-         Return True
-      Else
-         Return False
-      End If
-   End Function
-
-   Public Overrides ReadOnly Property Remaining As Integer
-      Get
-         Return If(count < 0, 0, count)
-      End Get
-   End Property
-
-   Public Overrides Sub Reset()
-      count = -1
-      index = -1
-   End Sub
-End Class
-```
-
-次のコードでは、`CustomMapper` オブジェクトをインスタンス化して、そのインスタンスを [Encoding.GetEncoding(String, EncoderFallback, DecoderFallback)](xref:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)) メソッドに渡しています。 出力を見るとわかるように、この最適フォールバックの実装では、元の文字列の&3; つの非 ASCII 文字が正しく処理されます。
-
-```csharp
-using System;
-using System.Collections.Generic;
-using System.Text;
-
-class Program
-{
-   static void Main()
-   {
-      Encoding enc = Encoding.GetEncoding("us-ascii", new CustomMapper(), new DecoderExceptionFallback());
-
-      string str1 = "\u24C8 \u2075 \u221E";
-      Console.WriteLine(str1);
-      for (int ctr = 0; ctr <= str1.Length - 1; ctr++) {
-         Console.Write("{0} ", Convert.ToUInt16(str1[ctr]).ToString("X4"));
-         if (ctr == str1.Length - 1) 
-            Console.WriteLine();
-      }
-      Console.WriteLine();
-
-      // Encode the original string using the ASCII encoder.
-      byte[] bytes = enc.GetBytes(str1);
-      Console.Write("Encoded bytes: ");
-      foreach (var byt in bytes)
-         Console.Write("{0:X2} ", byt);
-
-      Console.WriteLine("\n");
-
-      // Decode the ASCII bytes.
-      string str2 = enc.GetString(bytes);
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2));
-      if (! str1.Equals(str2)) {
-         Console.WriteLine(str2);
-         foreach (var ch in str2)
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"));
-
-         Console.WriteLine();
-      }
-   }
-}
-```
-
-```vb
-Imports System.Text
-Imports System.Collections.Generic
-
-Module Module1
-
-   Sub Main()
-      Dim enc As Encoding = Encoding.GetEncoding("us-ascii", New CustomMapper(), New DecoderExceptionFallback())
-
-      Dim str1 As String = String.Format("{0} {1} {2}", ChrW(&H24C8), ChrW(&H2075), ChrW(&H221E))
-      Console.WriteLine(str1)
-      For ctr As Integer = 0 To str1.Length - 1
-         Console.Write("{0} ", Convert.ToUInt16(str1(ctr)).ToString("X4"))
-         If ctr = str1.Length - 1 Then Console.WriteLine()
-      Next
-      Console.WriteLine()
-
-      ' Encode the original string using the ASCII encoder.
-      Dim bytes() As Byte = enc.GetBytes(str1)
-      Console.Write("Encoded bytes: ")
-      For Each byt In bytes
-         Console.Write("{0:X2} ", byt)
-      Next
-      Console.WriteLine()
-      Console.WriteLine()
-
-      ' Decode the ASCII bytes.
-      Dim str2 As String = enc.GetString(bytes)
-      Console.WriteLine("Round-trip: {0}", str1.Equals(str2))
-      If Not str1.Equals(str2) Then
-         Console.WriteLine(str2)
-         For Each ch In str2
-            Console.Write("{0} ", Convert.ToUInt16(ch).ToString("X4"))
-         Next
-         Console.WriteLine()
-      End If
-   End Sub
-End Module
-```
-
-## <a name="see-also"></a>関連項目
-
-[System.Text.Encoder](xref:System.Text.Encoder)
-
-[System.Text.EncoderFallback](xref:System.Text.EncoderFallback)
-
-[System.Text.Decoder](xref:System.Text.Decoder)
-
-[System.Text.DecoderFallback](xref:System.Text.DecoderFallback)
-
-[System.Text.Encoding](xref:System.Text.Encoding)
-
-
-
-
-
+>  エンコード操作用のカスタム例外ハンドラーを実装することもできます。 詳しくは、「[カスタム フォールバック ストラテジの実装](../../../docs/standard/base-types/character-encoding.md#Custom)」セクションをご覧ください。  
+  
+ <xref:System.Text.EncoderFallbackException> オブジェクトと <xref:System.Text.DecoderFallbackException> オブジェクトは、例外を引き起こした状況について以下の情報を提供します。  
+  
+-   <xref:System.Text.EncoderFallbackException> オブジェクトに含まれている <xref:System.Text.EncoderFallbackException.IsUnknownSurrogate%2A> メソッドにより、エンコードできない文字が不明なサロゲート ペアか \(この場合は `true` が返されます\)、不明な単一文字か \(この場合は `false` が返されます\) が示されます。 サロゲート ペアの文字は、<xref:System.Text.EncoderFallbackException.CharUnknownHigh%2A?displayProperty=fullName> プロパティと <xref:System.Text.EncoderFallbackException.CharUnknownLow%2A?displayProperty=fullName> プロパティから取得できます。 不明な単一文字は、<xref:System.Text.EncoderFallbackException.CharUnknown%2A?displayProperty=fullName> プロパティから取得できます。 また、<xref:System.Text.EncoderFallbackException.Index%2A?displayProperty=fullName> プロパティにより、エンコードできない最初の文字が見つかった文字列内の位置が示されます。  
+  
+-   <xref:System.Text.DecoderFallbackException> オブジェクトに含まれている <xref:System.Text.DecoderFallbackException.BytesUnknown%2A> プロパティにより、デコードできないバイト配列が返されます。 また、<xref:System.Text.DecoderFallbackException.Index%2A?displayProperty=fullName> プロパティにより、不明なバイトの開始位置が示されます。  
+  
+ <xref:System.Text.EncoderFallbackException> オブジェクトと <xref:System.Text.DecoderFallbackException> オブジェクトでは、例外に関する診断情報は十分に入手できますが、エンコード バッファーやデコード バッファーにアクセスすることはできません。 したがって、エンコード メソッド内またはデコード メソッド内で無効なデータを置換したり修正したりすることはできません。  
+  
+<a name="Custom"></a>   
+## カスタム フォールバック ストラテジの実装  
+ .NET Framework には、コード ページによって内部的に実装される最適マッピングに加えて、フォールバック ストラテジを実装するための次のクラスが含まれています。  
+  
+-   <xref:System.Text.EncoderReplacementFallback> および <xref:System.Text.EncoderReplacementFallbackBuffer>。エンコード操作中に文字を置換します。  
+  
+-   <xref:System.Text.DecoderReplacementFallback> および <xref:System.Text.DecoderReplacementFallbackBuffer>。デコード操作中に文字を置換します。  
+  
+-   <xref:System.Text.EncoderExceptionFallback> および <xref:System.Text.EncoderExceptionFallbackBuffer>。文字をエンコードできない場合に <xref:System.Text.EncoderFallbackException> をスローします。  
+  
+-   <xref:System.Text.DecoderExceptionFallback> および <xref:System.Text.DecoderExceptionFallbackBuffer>。文字をデコードできない場合に <xref:System.Text.DecoderFallbackException> をスローします。  
+  
+ さらに、次の手順に従って、最適フォールバック、置換フォールバック、または例外フォールバックを使用するカスタム ソリューションを実装できます。  
+  
+1.  エンコード操作の場合は <xref:System.Text.EncoderFallback>、デコード操作の場合は <xref:System.Text.DecoderFallback> の派生クラスを作成します。  
+  
+2.  エンコード操作の場合は <xref:System.Text.EncoderFallbackBuffer>、デコード操作の場合は <xref:System.Text.DecoderFallbackBuffer> の派生クラスを作成します。  
+  
+3.  例外フォールバックにおいて、あらかじめ定義されている <xref:System.Text.EncoderFallbackException> クラスと <xref:System.Text.DecoderFallbackException> クラスが目的に合わない場合は、<xref:System.Exception> や <xref:System.ArgumentException> などの例外オブジェクトから派生クラスを作成します。  
+  
+### EncoderFallback または DecoderFallback からの派生  
+ カスタム フォールバック ソリューションを実装するには、エンコード操作の場合は <xref:System.Text.EncoderFallback>、デコード操作の場合は <xref:System.Text.DecoderFallback> を継承するクラスを作成する必要があります。 これらのクラスのインスタンスは <xref:System.Text.Encoding.GetEncoding%28System.String%2CSystem.Text.EncoderFallback%2CSystem.Text.DecoderFallback%29?displayProperty=fullName> メソッドに渡され、エンコーディング クラスとフォールバックの実装の仲介役として機能します。  
+  
+ エンコーダーまたはデコーダーのカスタム フォールバック ソリューションを作成するときには、次のメンバーを実装する必要があります。  
+  
+-   <xref:System.Text.EncoderFallback.MaxCharCount%2A?displayProperty=fullName> プロパティまたは <xref:System.Text.DecoderFallback.MaxCharCount%2A?displayProperty=fullName> プロパティ。最適、置換、例外の各フォールバックで単一の文字を置き換えるために返すことのできる文字の最大数を返します。 カスタム例外フォールバックの場合は 0 になります。  
+  
+-   <xref:System.Text.EncoderFallback.CreateFallbackBuffer%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.DecoderFallback.CreateFallbackBuffer%2A?displayProperty=fullName> メソッド。<xref:System.Text.EncoderFallbackBuffer> または <xref:System.Text.DecoderFallbackBuffer> のカスタム実装を返します。 このメソッドは、エンコーダーで正しくエンコードできない文字が初めて検出されたとき、またはデコーダーで正しくデコードできないバイトが初めて検出されたときに呼び出されます。  
+  
+### EncoderFallbackBuffer または DecoderFallbackBuffer からの派生  
+ カスタム フォールバック ソリューションを実装するには、エンコード操作の場合は <xref:System.Text.EncoderFallbackBuffer>、デコード操作の場合は <xref:System.Text.DecoderFallbackBuffer> を継承するクラスを作成する必要もあります。 これらのクラスのインスタンスは、<xref:System.Text.EncoderFallback.CreateFallbackBuffer%2A> クラスおよび <xref:System.Text.EncoderFallback> クラスの <xref:System.Text.DecoderFallback> メソッドによって返されます。<xref:System.Text.EncoderFallback.CreateFallbackBuffer%2A?displayProperty=fullName> メソッドは、エンコーダーでエンコードできない文字が初めて検出されたときに呼び出され、<xref:System.Text.DecoderFallback.CreateFallbackBuffer%2A?displayProperty=fullName> メソッドは、デコーダーでデコードできないバイトが検出されたときに呼び出されます。<xref:System.Text.EncoderFallbackBuffer> クラスと <xref:System.Text.DecoderFallbackBuffer> クラスは、フォールバックの実装を提供します。 各インスタンスは、エンコードできない文字またはデコードできないバイト シーケンスを置き換えるフォールバック文字を含むバッファーを表します。  
+  
+ エンコーダーまたはデコーダーのカスタム フォールバック ソリューションを作成するときには、次のメンバーを実装する必要があります。  
+  
+-   <xref:System.Text.EncoderFallbackBuffer.Fallback%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.DecoderFallbackBuffer.Fallback%2A?displayProperty=fullName> メソッド。<xref:System.Text.EncoderFallbackBuffer.Fallback%2A?displayProperty=fullName> は、エンコーダーによって呼び出され、エンコードできない文字に関する情報をフォールバック バッファーに提供します。 エンコードされる文字はサロゲート ペアである場合もあるため、このメソッドはオーバーロードされます。 最初のオーバーロードには、エンコードされる文字と、その文字列内のインデックスが渡されます。 2 番目のオーバーロードには、上位および下位のサロゲートと、その文字列内のインデックスが渡されます。<xref:System.Text.DecoderFallbackBuffer.Fallback%2A?displayProperty=fullName> メソッドは、デコーダーによって呼び出され、デコードできないバイトに関する情報をフォールバック バッファーに提供します。 このメソッドには、デコードできないバイト配列と、最初のバイトのインデックスが渡されます。 フォールバック メソッドは、フォールバック バッファーが最適な文字または置換文字を提供できる場合は `true`、それ以外の場合は `false` を返します。 例外フォールバックの場合は例外をスローします。  
+  
+-   <xref:System.Text.EncoderFallbackBuffer.GetNextChar%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.DecoderFallbackBuffer.GetNextChar%2A?displayProperty=fullName> メソッド。フォールバック バッファーから次の文字を取得するために、エンコーダーまたはデコーダーによって繰り返し呼び出されます。 すべてのフォールバック文字を返し終わったら、このメソッドは U\+0000 を返す必要があります。  
+  
+-   <xref:System.Text.EncoderFallbackBuffer.Remaining%2A?displayProperty=fullName> プロパティまたは <xref:System.Text.DecoderFallbackBuffer.Remaining%2A?displayProperty=fullName> プロパティ。フォールバック バッファー内の残りの文字数を返します。  
+  
+-   <xref:System.Text.EncoderFallbackBuffer.MovePrevious%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.DecoderFallbackBuffer.MovePrevious%2A?displayProperty=fullName> メソッド。フォールバック バッファー内の現在の位置を前の文字に移動します。  
+  
+-   <xref:System.Text.EncoderFallbackBuffer.Reset%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.DecoderFallbackBuffer.Reset%2A?displayProperty=fullName> メソッド。フォールバック バッファーを再初期化します。  
+  
+ フォールバックの実装が最適フォールバックまたは置換フォールバックの場合は、<xref:System.Text.EncoderFallbackBuffer> と <xref:System.Text.DecoderFallbackBuffer> の派生クラスで、2 つのプライベート インスタンス フィールド \(バッファー内の正確な文字数と、次に返される文字のインデックス\) も保持します。  
+  
+### EncoderFallback の例  
+ 前の例では、置換フォールバックを使用して、対応する ASCII 文字がない Unicode 文字をアスタリスク \(\*\) に置き換えました。 次の例では、代わりに最適フォールバックのカスタム実装を使用して、非 ASCII 文字のマッピングを改善しています。  
+  
+ 次のコードでは、`CustomMapper` から派生する <xref:System.Text.EncoderFallback> という名前のクラスを定義して、非 ASCII 文字の最適マッピングを処理します。 このクラスの `CreateFallbackBuffer` メソッドは、`CustomMapperFallbackBuffer` の実装を提供する <xref:System.Text.EncoderFallbackBuffer> オブジェクトを返します。`CustomMapper` クラスは、<xref:System.Collections.Generic.Dictionary%602> オブジェクトを使用して、サポートされていない Unicode 文字 \(キー値\) と、それらに対応する 8 ビット文字とのマッピングを格納します \(64 ビット整数の 2 つの連続するバイトに格納されます\)。 このマッピングをフォールバック バッファーで使用できるようにするには、`CustomMapper` のインスタンスを `CustomMapperFallbackBuffer` のクラス コンストラクターにパラメーターとして渡します。 最も長いマッピングは Unicode 文字 U\+221E に対応する文字列 "INF" なので、`MaxCharCount` プロパティは 3 を返します。  
+  
+ [!code-csharp[Conceptual.Encoding#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/custom1.cs#5)]
+ [!code-vb[Conceptual.Encoding#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/custom1.vb#5)]  
+  
+ 次のコードでは、`CustomMapperFallbackBuffer` から派生する <xref:System.Text.EncoderFallbackBuffer> クラスを定義しています。`CustomMapper` インスタンスで定義されている、最適マッピングを含むディクショナリは、クラス コンストラクターから取得できます。 このクラスの `Fallback` メソッドは、ASCII エンコーダーでエンコードできない Unicode 文字がマッピング ディクショナリで定義されている場合は `true` を返し、それ以外の場合は `false` を返します。 フォールバックのたびに、プライベート変数 `count` は返される残りの文字数を示し、プライベート変数 `index` は次に返される文字の文字列バッファー内 \(`charsToReturn` 内\) の位置を示します。  
+  
+ [!code-csharp[Conceptual.Encoding#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/custom1.cs#6)]
+ [!code-vb[Conceptual.Encoding#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/custom1.vb#6)]  
+  
+ 次のコードでは、`CustomMapper` オブジェクトをインスタンス化して、そのインスタンスを <xref:System.Text.Encoding.GetEncoding%28System.String%2CSystem.Text.EncoderFallback%2CSystem.Text.DecoderFallback%29?displayProperty=fullName> メソッドに渡しています。 出力を見るとわかるように、この最適フォールバックの実装では、元の文字列の 3 つの非 ASCII 文字が正しく処理されます。  
+  
+ [!code-csharp[Conceptual.Encoding#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.encoding/cs/custom1.cs#7)]
+ [!code-vb[Conceptual.Encoding#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.encoding/vb/custom1.vb#7)]  
+  
+## 参照  
+ <xref:System.Text.Encoder>   
+ <xref:System.Text.Decoder>   
+ <xref:System.Text.DecoderFallback>   
+ <xref:System.Text.Encoding>   
+ <xref:System.Text.EncoderFallback>   
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/character-escapes-in-regular-expressions.md b/docs/standard/base-types/character-escapes-in-regular-expressions.md
new file mode 100644
index 00000000000..6c30a8200f9
--- /dev/null
+++ b/docs/standard/base-types/character-escapes-in-regular-expressions.md
@@ -0,0 +1,74 @@
+---
+title: "正規表現での文字のエスケープ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 文字のエスケープ"
+  - "文字, エスケープ"
+  - "構成体, 文字のエスケープ"
+  - "エスケープ文字"
+  - "正規表現, 文字のエスケープ"
+  - "置換パターン"
+  - "エスケープされない文字"
+ms.assetid: f49cc9cc-db7d-4058-8b8a-422bc08b29b0
+caps.latest.revision: 31
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# 正規表現での文字のエスケープ
+正規表現の円記号 \(\\\) は、次のいずれかを示します。  
+  
+-   後に続く文字が、次のセクションの表に示す特殊文字であること。  たとえば、`\b` は、正規表現の一致がワード境界から開始する必要があることを示すアンカーであり、`\t` はタブを表します。`\x020` は空白を表します。  
+  
+-   エスケープされていない言語構成要素として解釈される文字は、文字どおりに解釈する必要があること。  たとえば、中かっこ \(`{`\) は量指定子の定義を開始しますが、円記号とそれに続く中かっこ \(`\{`\) は、正規表現エンジンで中かっこに一致させる必要があることを示します。  同様に、1 つの円記号はエスケープされた言語構成要素の開始を示しますが、2 つの円記号 \(`\\`\) は、正規表現エンジンで円記号に一致させる必要があることを示します。  
+  
+> [!NOTE]
+>  文字エスケープは、正規表現では認識されますが、置換パターンでは認識されません。  
+  
+## .NET Framework の文字エスケープ  
+ 次の表は、.NET Framework の正規表現でサポートされている文字エスケープの一覧です。  
+  
+|文字または文字シーケンス|説明|  
+|------------------|--------|  
+|次の文字を除くすべての文字:<br /><br /> .  $ ^ { \[ \( &#124; \) \* \+ ?  \\|**文字またはシーケンス**の列にリストされているもの以外の文字は、正規表現で特別な意味を持ちません。それらは、その文字自体と一致します。<br /><br /> **文字またはシーケンス**の列に含まれる文字は、特殊な正規表現言語要素です。  正規表現でそれらの文字と一致するためには、エスケープするか、[ppositive 文字グループ](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)に含める必要があります。  たとえば、正規表現の `\$\d+` または `[$]\d+`は「$1200」と一致します。|  
+|`\a`|ビープ音 \(アラーム\) 文字の `\u0007`。|  
+|`\b`|`[` *character\_group* `]` 文字クラスでバックスペースの `\u0008` と一致します。  \(「[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)」を参照してください。\) 文字クラスの外部では、`\b` はワード境界と一致するアンカーです   \(「[アンカー](../../../docs/standard/base-types/anchors-in-regular-expressions.md)」を参照してください。\)|  
+|`\t`|タブの `\u0009`。|  
+|`\r`|キャリッジ リターンの `\u000D`。  `\r` の機能は `\n` という改行文字と同じではありません。|  
+|`\v`|垂直タブの `\u000B`。|  
+|`\f`|フォーム フィードの `\u000C`。|  
+|`\n`|改行文字の `\u000A`。|  
+|`\e`|エスケープ文字の `\u001B`。|  
+|`\` *nnn*|ASCII 文字と一致します。*nnn* は、8 進文字コードを表す 2 桁または 3 桁で構成されます。  たとえば、`\040` は、空白文字を表します。  この構成体は、1 桁のみの場合 \(`\2` など\)、またはキャプチャ グループの番号に対応する場合には前方参照として解釈されます。  \(「[前方参照構成体](../../../docs/standard/base-types/backreference-constructs-in-regular-expressions.md)」を参照してください。\)|  
+|`\x` *nn*|ASCII 文字と一致します。*nn* は 2 桁の 16 進文字コードです。|  
+|`\c` *X*|ASCII の制御文字と一致します。X は制御文字です。  たとえば、`\cC` は CTRL\-C です。|  
+|`\u` *nnnn*|値が *nnnn* の 16 進数である UTF\-16 コード単位と一致します。 **Note:**  .NET Framework では、Unicode を指定するために使用する Perl5 の文字エスケープはサポートされません。  Perl 5 の文字エスケープは `\x{`*\#\#\#\#*`…}` の形式です。ここで、*\#\#\#\#*`…` は一連の 16 進数です。  代わりに、`\u`*nnnn* を使用します。|  
+|`\`|エスケープ文字として認識されない文字が後ろに付いている場合は、その文字と一致します。  たとえば、`\*` はアスタリスク \(\*\) と一致し、`\x2A` と同じです。|  
+  
+## 例  
+ 正規表現の文字エスケープの使用例を次に示します。  2009 年の世界最大規模の都市の名前と人口を含む文字列を解析します。  各都市名は、タブ \(`\t`\) または縦棒 \(&#124; または `\u007c`\) で区切られます。  個々の都市とその人口は、復帰とライン フィードで互いに区切られています。  
+  
+ [!code-csharp[RegularExpressions.Language.Escapes#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.escapes/cs/escape1.cs#1)]
+ [!code-vb[RegularExpressions.Language.Escapes#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.escapes/vb/escape1.vb#1)]  
+  
+ この正規表現 `\G(.+)[\t|\u007c](../../../amples/snippets/visualbasic/VS_Snippets_Wpf/DocumentStructure/visualbasic/spec_withstructure-xps/_rels/.rels)\r?\n` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\G`|最後の一致の終了位置から照合を開始します。|  
+|`(.+)`|任意の文字と 1 回以上、一致します。  これが最初のキャプチャ グループです。|  
+|`[\t\u007c]`|タブ \(`\t`\) または縦棒 \(&#124;\) と一致します。|  
+|`(.+)`|任意の文字と 1 回以上、一致します。  これが 2 番目のキャプチャ グループです。|  
+|`\r?  \n`|復帰とそれに続く改行に、0 回または 1 回一致します。|  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/common-type-system.md b/docs/standard/base-types/common-type-system.md
index 5845cd01cb7..e11d902a7eb 100644
--- a/docs/standard/base-types/common-type-system.md
+++ b/docs/standard/base-types/common-type-system.md
@@ -1,535 +1,327 @@
 ---
-title: "共通型システムの詳細"
-description: "共通型システムの詳細"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: b5482a1d-7bdc-40fe-aa45-10df930ceb5b
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 6be672acc84a76106e25b82574acad16beb4a8ac
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="common-type-system-in-depth"></a>共通型システムの詳細
-
-このトピックには、共通型システムの詳細を説明する次のセクションが含まれています。
-
-* [.NET の型](#types-in-net)
-
-* [型定義](#type-definitions)
-
-* [型のメンバー](#type-members)
-
-* [型のメンバーの特性](#characteristics-of-type-members)
-
-
-## <a name="types-in-net"></a>.NET の型
-
-.NET に存在するすべての型は、値型と参照型のどちらかに区別されます。 
-
-値型は、オブジェクトがその実際の値で表されるデータ型です。 変数に値型のインスタンスが割り当てられると、その変数には値の新しいコピーが代入されます。
-
-参照型は、オブジェクトがその実際の値を指す参照 (ポインターのようなもの) によって表されるデータ型です。 参照型が変数に割り当てられている場合、その変数は元の値を参照します (つまり、元の値を指します)。 コピーは作成されません。 
-
-.NET の共通型システムは、次の&5; つの型のカテゴリをサポートしています。
-
-* [クラス](#classes)
-
-* [構造体](#structures)
-
-* [列挙型](#enumerations)
-
-* [インターフェイス](#interfaces)
-
-* [デリゲート](#delegates)
-
-### <a name="classes"></a>クラス
-
-クラスは参照型であり、他のクラスから直接派生させることも、[System.Object](xref:System.Object) から暗黙的に派生させることもできます。 クラスは、オブジェクト (クラスのインスタンス) が実行できる操作 (メソッド、イベント、またはプロパティ) およびオブジェクトが保持するデータ (フィールド) を定義するものです。 通常、クラスは、たとえば定義のみを持ち実装は持たないインターフェイスとは対照的に、定義と実装の両方を持ちます。しかし、実装を持たないメンバーが&1; つ以上存在するクラスもあります。
-
-クラスが持つことのできる特性のいくつかを次の表で説明します。 ランタイムをサポートする言語にはそれぞれ、クラスまたはクラス メンバーに対し、こうした特性の&1; つ以上を指定する手段が用意されています。 ただし、.NET を対象とするすべてのプログラミング言語で、これらすべての特性を利用できるわけではありません。
-
-特徴 | 説明
--------------- | -----------
-sealed | 型から別のクラスを派生できないことを示します。
-実装 | クラスが、インターフェイスのメンバーの実装を提供することによって、1 つ以上のインターフェイスを使用することを示します。
-abstract | クラスをインスタンス化できないことを示します。 クラスを使用するには、このクラスから別のクラスを派生させる必要があります。
-継承 | クラスのインスタンスを、基底クラスが指定されている任意の場所で使用できることを示します。 基底クラスから継承する派生クラスは、基底クラスによって提供されるすべてのパブリック メンバーの実装を使用できます。または、派生クラスは、パブリック メンバーの実装をその独自の実装でオーバーライドできます。
-exported または not exported | クラスが定義されているアセンブリの外部から、そのクラスを参照できるかどうかを示します。 この特性は、最上位のクラスにのみ適用され、入れ子にされたクラスには適用されません。
-
-> [!NOTE]
-> クラスは、親クラスまたは構造体で入れ子にすることもできます。 入れ子にされたクラスにも、メンバー特性を適用できます。 詳細については、「[入れ子にされた型](#nested-types)」を参照してください。
-
-実装を持たないクラス メンバーは抽象メンバーです。 1 つ以上の抽象メンバーを持つクラスは、それ自体が抽象クラスとなり、新しいインスタンスを作成できません。 ランタイムに対応する言語の中には、抽象メンバーを持たないクラスも抽象クラスとしてマークできるものがあります。 抽象クラスは、派生クラスが必要に応じて継承したりオーバーライドしたりできる基本的な一連の機能をカプセル化する必要がある場合に使用できます。 抽象クラスでないクラスを具象クラスと呼びます。
-
-クラスで実装できるインターフェイスの数に制限はありませんが、すべてのクラスが暗黙的に継承する [System.Object](xref:System.Object) を除き、継承できる基底クラスは&1; つだけです。 すべてのクラスには少なくとも&1; つのコンストラクターが必要で、このコンストラクターにより、各クラスの新しいインスタンスが初期化されます。 コンストラクターを明示的に定義しなかった場合、ほとんどのコンパイラでは、自動的に既定の (パラメーターなしの) コンストラクターが使用されます。
-
-### <a name="structures"></a>構造体
-
-構造体は、[System.Object](xref:System.Object) から派生する [System.ValueType](xref:System.ValueType) から暗黙的に派生する値型です。 構造体は、メモリ要件が小さい値を表す場合や、厳密に型指定されたパラメーターを持つメソッドに対してパラメーターを値渡しする場合などに、非常に便利です。 .NET では、すべてのプリミティブ データ型 ([Boolean](xref:System.Boolean)、[Byte](xref:System.Byte)、[Char](xref:System.Char)、[DateTime](xref:System.DateTime)、[Decimal](xref:System.Decimal)、[Double](xref:System.Double)、[Int16](xref:System.Int16)、[Int32](xref:System.Int32)、[Int64](xref:System.Int64)、[SByte](xref:System.SByte)、[Single](xref:System.Single)、[UInt16](xref:System.UInt16)、[UInt32](xref:System.UInt32)、[UInt64](xref:System.UInt64)) が構造体として定義されています。
-
-クラスと同様、構造体にもデータ (構造体のフィールド) と、そのデータに対して実行できる操作 (構造体のメソッド) が定義されます。 これは、[System.Object](xref:System.Object) クラスと [System.ValueType](xref:System.ValueType) クラスで定義されている仮想メソッドなどのメソッドと、値型そのものに定義されているすべてのメソッドを、構造体に対して呼び出すことができることを意味します。 言い換えれば、構造体には、静的メソッドと非静的メソッドに加え、フィールド、プロパティ、およびイベントを持たせることができます。 構造体のインスタンスを作成したり、構造体をパラメーターとして渡したりできるほか、構造体をローカル変数として格納することも、別の値型または参照型のフィールドに格納することもできます。 構造体でインターフェイスを実装することもできます。
-
-ただし、値型は、いくつかの点でクラスとは異なります。 まず、値型は [System.ValueType](xref:System.ValueType) を暗黙的に継承しますが、他の型を直接継承することはできません。 同様に、すべての値型には、値型から他の型が派生できないことを示す sealed 属性が適用されます。 また、値型はコンストラクターを必要としません。
-
-共通言語ランタイムは、それぞれの値型に対応するボックス化された型を提供します。ボックス化された型とは、値型と同じ状態および動作を備えたクラスのことです。 値型のインスタンスは、[System.Object](xref:System.Object) 型のパラメーターを受け入れるメソッドに渡されると、ボックス化されます。 参照渡しのパラメーターとして値型を受け入れるメソッドの呼び出しから制御が返されると、ボックス化が解除 (つまり、クラスのインスタンスから値型のインスタンスに変換) されます。 言語によっては、ボックス化された型が必要なときに特別な構文を使用する必要がありますが、ボックス化された型を必要に応じて自動的に使用する言語もあります。 値型を定義するときには、ボックス化された型とボックス化解除された型の両方を定義します。
-
-### <a name="enumerations"></a>列挙体
-
-列挙型 (enum) は、[System.Enum](xref:System.Enum) から直接継承される値型で、基になるプリミティブ型の値に対して別名を割り当てます。 列挙型には名前、基になる型、および一連のフィールドが存在します。基になる型は、組み込みの符号付きまたは符号なし整数型 ([Byte](xref:System.Byte)、[Int32](xref:System.Int32)、[UInt64](xref:System.UInt64) など) であることが必要です。 フィールドは静的リテラル フィールドで、各フィールドが&1; つの定数を表します。 複数のフィールドに同じ値を割り当てることもできます。 その場合は、リフレクションや文字列変換を行うために、いずれかの値をプライマリ列挙値としてマークしておく必要があります。
-
-基になる型の値を列挙型に割り当てることも、その逆も可能です (キャストは必要ありません)。 列挙型のインスタンスを作成し、[System.Enum](xref:System.Enum) のメソッドや、その列挙型の基となる型に定義されている任意のメソッドを呼び出すことができます。 しかし、言語によっては、基になる型のインスタンスが必要とされるときに、列挙型をパラメーターとして渡すことが許可されていない場合もあります (またはその逆)。
-
-また、列挙型には次のような制限があります。 
-
-* 独自のメソッドは定義できません。
-
-* インターフェイスを実装できません。
-
-* プロパティまたはイベントを定義できません。
-
-* 列挙型は、ジェネリック型に入れ子にされているという理由だけでジェネリックである場合を除き、ジェネリックにはなりません。 つまり、列挙型は、独自の型パラメーターを持つことができません。 
-
+title: "共通型システム | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アセンブリ [.NET Framework], 型"
+  - "共通型システム"
+  - "言語間の相互運用性"
+  - "名前空間 [.NET Framework], 型"
+  - "参照型"
+  - "型システム"
+  - "型, 型の概要"
+  - "値型"
+ms.assetid: 53c57c96-83e1-4ee3-9543-9ac832671a89
+caps.latest.revision: 25
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 共通型システム
+共通型システム \(CTS: Common Type System\) は、共通言語ランタイムにおける型の宣言、使用、および管理の方法を定義しており、ランタイムによる言語間統合のサポートにおいても重要な役割を果たします。  共通型システムには次のような機能があります。  
+  
+-   言語間の統合、タイプ セーフ、およびパフォーマンスの高いコードの実行を可能にするフレームワークを確立します。  
+  
+-   さまざまなプログラミング言語の完全な実装をサポートするオブジェクト指向モデルを提供します。  
+  
+-   異なる言語で記述されたオブジェクトが相互に対話できるように、各言語が準拠すべき規則を定義します。  
+  
+-   アプリケーション開発に使用されるプリミティブ データ型 \(<xref:System.Boolean>、<xref:System.Byte>、<xref:System.Char>、<xref:System.Int32>、<xref:System.UInt64> など\) を含んだライブラリを提供します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [.NET Framework の型](#types_in_the_net_framework)  
+  
+-   [型定義](#type_definitions)  
+  
+-   [型のメンバー](#type_members)  
+  
+-   [型のメンバーの特性](#characteristics_of_type_members)  
+  
+<a name="types_in_the_net_framework"></a>   
+## .NET Framework の型  
+ .NET Framework に存在するすべての型は、値型と参照型のどちらかに区別されます。  
+  
+ 値型は、オブジェクトがその実際の値で表されるデータ型です。  変数に値型のインスタンスが割り当てられると、その変数には値の新しいコピーが代入されます。  
+  
+ 参照型は、オブジェクトがその実際の値を指す参照 \(ポインターのようなもの\) によって表されるデータ型です。  参照型が変数に割り当てられている場合、その変数は元の値を参照します \(つまり、元の値を指します\)。  コピーは作成されません。  
+  
+ .NET Framework の共通型システムは、次の 5 つの型のカテゴリをサポートしています。  
+  
+-   [クラス](#Classes)  
+  
+-   [構造体](#Structures)  
+  
+-   [列挙](#Enumerations)  
+  
+-   [インターフェイス](#Interfaces)  
+  
+-   [デリゲート](#Delegates)  
+  
+<a name="Classes"></a>   
+### クラス  
+ クラスは参照型であり、他のクラスから直接派生させることも、<xref:System.Object?displayProperty=fullName> から暗黙的に派生させることもできます。  クラスは、オブジェクト \(クラスのインスタンス\) が実行できる操作 \(メソッド、イベント、またはプロパティ\) およびオブジェクトが保持するデータ \(フィールド\) を定義するものです。  通常、クラスは、たとえば定義のみを持ち実装は持たないインターフェイスとは対照的に、定義と実装の両方を持ちます。しかし、実装を持たないメンバーが 1 つ以上存在するクラスもあります。  
+  
+ クラスが持つことのできる特性のいくつかを次の表で説明します。  ランタイムをサポートする言語にはそれぞれ、クラスまたはクラス メンバーに対し、こうした特性の 1 つ以上を指定する手段が用意されています。  ただし、.NET Framework を対象とするすべてのプログラミング言語で、これらすべての特性を利用できるわけではありません。  
+  
+|特徴|説明|  
+|--------|--------|  
+|sealed|型から別のクラスを派生できないことを示します。|  
+|実装|クラスが、インターフェイスのメンバーの実装を提供することによって、1 つ以上のインターフェイスを使用することを示します。|  
+|abstract|クラスをインスタンス化できないことを示します。  クラスを使用するには、このクラスから別のクラスを派生させる必要があります。|  
+|継承|クラスのインスタンスを、基底クラスが指定されている任意の場所で使用できることを示します。  基底クラスから継承する派生クラスは、基底クラスによって提供されるすべてのパブリック メンバーの実装を使用できます。または、派生クラスは、パブリック メンバーの実装をその独自の実装でオーバーライドできます。|  
+|exported または not exported|クラスが定義されているアセンブリの外部から、そのクラスを参照できるかどうかを示します。  この特性は、最上位のクラスにのみ適用され、入れ子にされたクラスには適用されません。|  
+  
 > [!NOTE]
-> C# で作成された入れ子にされた型 (列挙型を含む) は、それを囲むすべてのジェネリック型の型パラメーターを含むため、独自の型パラメーターは持ちませんが、ジェネリックです。 詳細については、[Type.MakeGenericType](xref:System.Type.MakeGenericType(System.Type[])) のリファレンス トピックを参照してください。 
-
-[FlagsAttribute](xref:System.FlagsAttribute) 属性は、ビット フィールドと呼ばれる特別な種類の列挙型を表します。 ランタイム自体は通常の列挙型とビット フィールドを区別しませんが、言語の中にはそれらを区別するものもあります。 列挙型とビット フィールドが区別される場合、ビット フィールドではビットごとの演算子を使用して名前のない値を生成できますが、列挙型ではビットごとの演算子は使用できません。 通常、列挙型は、曜日、国名、地域名などの一意の要素のリストに使用されます。 通常、ビット フィールドは、`Red And Big And Fast` のような、特性や数量を組み合わせて示すリストに使用されます。
-
-ビット フィールドと通常の列挙型を両方とも使用する方法を次の例に示します。
-
-```csharp
-using System;
-using System.Collections.Generic;
-
-// A traditional enumeration of some root vegetables.
-public enum SomeRootVegetables
-{
-    HorseRadish,
-    Radish,
-    Turnip
-}
-
-// A bit field or flag enumeration of harvesting seasons.
-[Flags]
-public enum Seasons
-{
-    None = 0,
-    Summer = 1,
-    Autumn = 2,
-    Winter = 4,
-    Spring = 8,
-    All = Summer | Autumn | Winter | Spring
-}
-
-public class Example
-{
-   public static void Main()
-   {
-       // Hash table of when vegetables are available.
-       Dictionary<SomeRootVegetables, Seasons> AvailableIn = new Dictionary<SomeRootVegetables, Seasons>();
-
-       AvailableIn[SomeRootVegetables.HorseRadish] = Seasons.All;
-       AvailableIn[SomeRootVegetables.Radish] = Seasons.Spring;
-       AvailableIn[SomeRootVegetables.Turnip] = Seasons.Spring | 
-            Seasons.Autumn;
-
-       // Array of the seasons, using the enumeration.
-       Seasons[] theSeasons = new Seasons[] { Seasons.Summer, Seasons.Autumn, 
-            Seasons.Winter, Seasons.Spring };
-
-       // Print information of what vegetables are available each season.
-       foreach (Seasons season in theSeasons)
-       {
-          Console.Write(String.Format(
-              "The following root vegetables are harvested in {0}:\n", 
-              season.ToString("G")));
-          foreach (KeyValuePair<SomeRootVegetables, Seasons> item in AvailableIn)
-          {
-             // A bitwise comparison.
-             if (((Seasons)item.Value & season) > 0)
-                 Console.Write(String.Format("  {0:G}\n", 
-                      (SomeRootVegetables)item.Key));
-          }
-       }
-   }
-}
-// The example displays the following output:
-//    The following root vegetables are harvested in Summer:
-//      HorseRadish
-//    The following root vegetables are harvested in Autumn:
-//      Turnip
-//      HorseRadish
-//    The following root vegetables are harvested in Winter:
-//      HorseRadish
-//    The following root vegetables are harvested in Spring:
-//      Turnip
-//      Radish
-//      HorseRadish
-```
-
-```vb
-Imports System.Collections.Generic
-
-' A traditional enumeration of some root vegetables.
-Public Enum SomeRootVegetables
-   HorseRadish
-   Radish
-   Turnip
-End Enum 
-
-' A bit field or flag enumeration of harvesting seasons.
-<Flags()> Public Enum Seasons
-   None = 0
-   Summer = 1
-   Autumn = 2
-   Winter = 4
-   Spring = 8
-   All = Summer Or Autumn Or Winter Or Spring
-End Enum 
-
-' Entry point.
-Public Class Example
-   Public Shared Sub Main()
-      ' Hash table of when vegetables are available.
-      Dim AvailableIn As New Dictionary(Of SomeRootVegetables, Seasons)()
-
-      AvailableIn(SomeRootVegetables.HorseRadish) = Seasons.All
-      AvailableIn(SomeRootVegetables.Radish) = Seasons.Spring
-      AvailableIn(SomeRootVegetables.Turnip) = Seasons.Spring Or _
-                                               Seasons.Autumn
-
-      ' Array of the seasons, using the enumeration.
-      Dim theSeasons() As Seasons = {Seasons.Summer, Seasons.Autumn, _
-                                     Seasons.Winter, Seasons.Spring}
-
-      ' Print information of what vegetables are available each season.
-      For Each season As Seasons In theSeasons
-         Console.WriteLine(String.Format( _
-              "The following root vegetables are harvested in {0}:", _
-              season.ToString("G")))
-         For Each item As KeyValuePair(Of SomeRootVegetables, Seasons) In AvailableIn
-            ' A bitwise comparison.
-            If(CType(item.Value, Seasons) And season) > 0 Then
-               Console.WriteLine("  " + _
-                     CType(item.Key, SomeRootVegetables).ToString("G"))
-            End If
-         Next
-      Next
-   End Sub 
-End Class 
-' The example displays the following output:
-'    The following root vegetables are harvested in Summer:
-'      HorseRadish
-'    The following root vegetables are harvested in Autumn:
-'      Turnip
-'      HorseRadish
-'    The following root vegetables are harvested in Winter:
-'      HorseRadish
-'    The following root vegetables are harvested in Spring:
-'      Turnip
-'      Radish
-'      HorseRadish
-```
-
-### <a name="interfaces"></a>インターフェイス
-
-インターフェイスは、"can do" 関係または "has a" 関係を指定するコントラクトを定義します。 インターフェイスは、多くの場合、比較と並べ替え ([IComparable](xref:System.IComparable) インターフェイスや [IComparable&lt;T&gt;](xref:System.IComparable%601) インターフェイス)、等価テスト ( [IEquatable&lt;T&gt;](xref:System.IEquatable%601) インターフェイス)、コレクション内の項目の列挙 ([IEnumerable](xref:System.Collections.IEnumerable) インターフェイスや [IEnumerable&lt;T&gt;](xref:System.Collections.Generic.IEnumerable%601) インターフェイス) などの機能を実装するために使用されます。 インターフェイスには、プロパティ、メソッド、およびイベント (すべて抽象メンバー) を設定できます。つまり、インターフェイスは、メンバーとメンバーの署名を定義しますが、インターフェイス メンバーの機能を定義するインターフェイスを実装する型に依存します。 これは、インターフェイスを実装するクラスまたは構造体が、そのインターフェイスで宣言されている抽象メンバーの定義を提供する必要があることを意味します。 インターフェイスは、そのインターフェイスを実装するクラスまたは構造体に対して、1 つ以上の他のインターフェイスも同時に実装するように要求できます。
-
-インターフェイスには、次のような制限があります。 
-
-* 任意のアクセシビリティを指定してインターフェイスを宣言できますが、そのすべてのメンバーのアクセシビリティは public であることが必要です。
-
-* インターフェイスでコンストラクターを定義することはできません。
-
-* インターフェイスでフィールドを定義することはできません。
-
-* インターフェイスで定義できるのはインスタンスのメンバーだけです。 静的メンバーを定義することはできません。
-
-各言語には、メンバーの実装をそのメンバーを要求するインターフェイスに割り当てるための規則があります。これは、複数のインターフェイスで同じシグネチャを持つメンバーを宣言でき、それらのメンバーが別個の実装を持つことができるためです。
-
-### <a name="delegates"></a>デリゲート
-
-デリゲートは、C++ の関数ポインターと類似の目的で使用される参照型です。 これらは、.NET のイベント ハンドラーとコールバック関数に使用されます。 関数ポインターとは異なり、デリゲートは安全で、検証可能で、タイプ セーフです。 デリゲート型は、互換性のあるシグネチャを持つすべてのインスタンス メソッドまたは静的メソッドを表すことができます。 
-
-デリゲートのパラメーターにメソッドのパラメーターよりも限定的な型が指定された場合、両者のパラメーター間に型の互換性があると見なされます。これによって、デリゲートに渡された引数が、メソッドに対して安全に渡されることが保証されます。
-
-同様に、メソッドの戻り値の型の制限がデリゲートの戻り値の型より多いと、メソッドの戻り値がデリゲートの戻り値の型に安全にキャストされることが保証されるため、デリゲートの戻り値の型とメソッドの戻り値の型には互換性があります。
-
-たとえば、[IEnumerable](xref:System.Collections.IEnumerable) 型のパラメーターおよび [Object](xref:System.Object) 型の戻り値を持つデリゲートは、[Object](xref:System.Object) 型のパラメーターおよび [IEnumerable](xref:System.Collections.IEnumerable) 型の戻り値を持ったメソッドを表すことができます。 
-
- よく "デリゲートは、それが表すメソッドにバインドされる" と言われます。 デリゲートは、メソッドにバインドされる以外にも、オブジェクトにバインドされる場合もあります。 オブジェクトはメソッドの第&1; パラメーターを表し、デリゲートが呼び出されるたびにメソッドに渡されます。 インスタンス メソッドの場合、バインドされたオブジェクトは、暗黙的な `this` パラメーター (Visual Basic では `Me`) として渡されます。静的メソッドの場合、オブジェクトは、メソッドの&1; つ目の仮パラメーターとして渡され、デリゲートのシグネチャは、その残りのパラメーターと完全に一致している必要があります。 
- 
- すべてのデリゲートが [System.MulticastDelegate](xref:System.MulticastDelegate) を継承し、System.MulticastDelegate は [System.Delegate](xref:System.Delegate) を継承します。 C# および Visual Basic 言語では、これらの型からの継承は許可されていません。 代わりに、デリゲートを宣言するためのキーワードが用意されています。
- 
- デリゲートは [MulticastDelegate](xref:System.MulticastDelegate) を継承するため、デリゲートには呼び出しリストがあります。これは、デリゲートが表し、デリゲートが呼び出されたときに実行されるメソッドのリストです。 リストのすべてのメソッドは、デリゲートが呼び出されたときに指定される引数を受け取ります。
-
+>  クラスは、親クラスまたは構造体で入れ子にすることもできます。  入れ子にされたクラスにも、メンバー特性を適用できます。  詳細については、「[入れ子にされた型](#NestedTypes)」を参照してください。  
+  
+ 実装を持たないクラス メンバーは抽象メンバーです。  1 つ以上の抽象メンバーを持つクラスは、それ自体が抽象クラスとなり、新しいインスタンスを作成できません。  ランタイムに対応する言語の中には、抽象メンバーを持たないクラスも抽象クラスとしてマークできるものがあります。  抽象クラスは、派生クラスが必要に応じて継承したりオーバーライドしたりできる基本的な一連の機能をカプセル化する必要がある場合に使用できます。  抽象クラスでないクラスを具象クラスと呼びます。  
+  
+ クラスで実装できるインターフェイスの数に制限はありませんが、すべてのクラスが暗黙的に継承する <xref:System.Object?displayProperty=fullName> を除き、継承できる基底クラスは 1 つだけです。  すべてのクラスには少なくとも 1 つのコンストラクターが必要で、このコンストラクターにより、各クラスの新しいインスタンスが初期化されます。  コンストラクターを明示的に定義しなかった場合、ほとんどのコンパイラでは、自動的に既定の \(パラメーターなしの\) コンストラクターが使用されます。  
+  
+<a name="Structures"></a>   
+### 構造体  
+ 構造体は、<xref:System.ValueType?displayProperty=fullName> から派生する <xref:System.Object?displayProperty=fullName> から暗黙的に派生する値型です。  構造体は、メモリ要件が小さい値を表す場合や、厳密に型指定されたパラメーターを持つメソッドに対してパラメーターを値渡しする場合などに、非常に便利です。  .NET Framework クラス ライブラリでは、すべてのプリミティブ データ型 \(<xref:System.Boolean>、<xref:System.Byte>、<xref:System.Char>、<xref:System.DateTime>、<xref:System.Decimal>、<xref:System.Double>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.SByte>、<xref:System.Single>、<xref:System.UInt16>、<xref:System.UInt32>、および <xref:System.UInt64>\) が構造体として定義されています。  
+  
+ クラスと同様、構造体にもデータ \(構造体のフィールド\) と、そのデータに対して実行できる操作 \(構造体のメソッド\) が定義されます。  これは、<xref:System.Object?displayProperty=fullName> クラスと <xref:System.ValueType?displayProperty=fullName> クラスで定義されている仮想メソッドなどのメソッドと、値型そのものに定義されているすべてのメソッドを、構造体に対して呼び出すことができることを意味します。  言い換えれば、構造体には、静的メソッドと非静的メソッドに加え、フィールド、プロパティ、およびイベントを持たせることができます。  構造体のインスタンスを作成したり、構造体をパラメーターとして渡したりできるほか、構造体をローカル変数として格納することも、別の値型または参照型のフィールドに格納することもできます。  構造体でインターフェイスを実装することもできます。  
+  
+ ただし、値型は、いくつかの点でクラスとは異なります。  まず、値型は <xref:System.ValueType?displayProperty=fullName> を暗黙的に継承しますが、他の型を直接継承することはできません。  同様に、すべての値型には、値型から他の型が派生できないことを示す sealed 属性が適用されます。  また、値型はコンストラクターを必要としません。  
+  
+ 共通言語ランタイムは、それぞれの値型に対応するボックス化された型を提供します。ボックス化された型とは、値型と同じ状態および動作を備えたクラスのことです。  値型のインスタンスは、<xref:System.Object?displayProperty=fullName> 型のパラメーターを受け入れるメソッドに渡されると、ボックス化されます。  参照渡しのパラメーターとして値型を受け入れるメソッドの呼び出しから制御が返されると、ボックス化が解除 \(つまり、クラスのインスタンスから値型のインスタンスに変換\) されます。  言語によっては、ボックス化された型が必要なときに特別な構文を使用する必要がありますが、ボックス化された型を必要に応じて自動的に使用する言語もあります。  値型を定義するときには、ボックス化された型とボックス化解除された型の両方を定義します。  
+  
+<a name="Enumerations"></a>   
+### 列挙  
+ 列挙型 \(enum\) は、<xref:System.Enum?displayProperty=fullName> から直接継承される値型で、基になるプリミティブ型の値に対して別名を割り当てます。  列挙型には名前、基になる型、および一連のフィールドが存在します。基になる型は、組み込みの符号付きまたは符号なし整数型 \(<xref:System.Byte>、<xref:System.Int32>、<xref:System.UInt64> など\) であることが必要です。  フィールドは静的リテラル フィールドで、各フィールドが 1 つの定数を表します。  複数のフィールドに同じ値を割り当てることもできます。  その場合は、リフレクションや文字列変換を行うために、いずれかの値をプライマリ列挙値としてマークしておく必要があります。  
+  
+ 基になる型の値を列挙型に割り当てることも、その逆も可能です \(キャストは必要ありません\)。  列挙型のインスタンスを作成し、<xref:System.Enum?displayProperty=fullName> のメソッドや、その列挙型の基となる型に定義されている任意のメソッドを呼び出すことができます。  しかし、言語によっては、基になる型のインスタンスが必要とされるときに、列挙型をパラメーターとして渡すことが許可されていない場合もあります \(またはその逆\)。  
+  
+ また、列挙型には次のような制限があります。  
+  
+-   独自のメソッドは定義できません。  
+  
+-   インターフェイスを実装できません。  
+  
+-   プロパティまたはイベントを定義できません。  
+  
+-   列挙型は、ジェネリック型に入れ子にされているという理由だけでジェネリックである場合を除き、ジェネリックにはなりません。  つまり、列挙型は、独自の型パラメーターを持つことができません。  
+  
+    > [!NOTE]
+    >  Visual Basic、C\#、および C\+\+ で作成された入れ子にされた型 \(列挙型を含む\) は、それを囲むすべてのジェネリック型の型パラメーターを含むため、独自の型パラメーターは持ちませんが、ジェネリックです。  詳細については、「<xref:System.Type.MakeGenericType%2A?displayProperty=fullName>」のリファレンス トピックの「入れ子にされた型」を参照してください。  
+  
+ <xref:System.FlagsAttribute> 属性は、ビット フィールドと呼ばれる特別な種類の列挙型を表します。  ランタイム自体は通常の列挙型とビット フィールドを区別しませんが、言語の中にはそれらを区別するものもあります。  列挙型とビット フィールドが区別される場合、ビット フィールドではビットごとの演算子を使用して名前のない値を生成できますが、列挙型ではビットごとの演算子は使用できません。  通常、列挙型は、曜日、国名、地域名などの一意の要素のリストに使用されます。  通常、ビット フィールドは、`Red And Big And Fast` のような、特性や数量を組み合わせて示すリストに使用されます。  
+  
+ ビット フィールドと通常の列挙型を両方とも使用する方法を次の例に示します。  
+  
+ [!code-csharp[Conceptual.Types.Enum#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.enum/cs/example.cs#1)]
+ [!code-vb[Conceptual.Types.Enum#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.enum/vb/example.vb#1)]  
+  
+<a name="Interfaces"></a>   
+### インターフェイス  
+ インターフェイスは、"can do" 関係または "has a" 関係を指定するコントラクトを定義します。  インターフェイスは、多くの場合、比較と並べ替え \(<xref:System.IComparable> インターフェイスや <xref:System.IComparable%601> インターフェイス\)、等価テスト \(<xref:System.IEquatable%601> インターフェイス\)、コレクション内の項目の列挙 \(<xref:System.Collections.IEnumerable> インターフェイスや <xref:System.Collections.Generic.IEnumerable%601> インターフェイス\) などの機能を実装するために使用されます。  インターフェイスには、プロパティ、メソッド、およびイベント \(すべて抽象メンバー\) を設定できます。つまり、インターフェイスは、メンバーとメンバーの署名を定義しますが、インターフェイス メンバーの機能を定義するインターフェイスを実装する型に依存します。  これは、インターフェイスを実装するクラスまたは構造体が、そのインターフェイスで宣言されている抽象メンバーの定義を提供する必要があることを意味します。  インターフェイスは、そのインターフェイスを実装するクラスまたは構造体に対して、1 つ以上の他のインターフェイスも同時に実装するように要求できます。  
+  
+ インターフェイスには、次のような制限があります。  
+  
+-   任意のアクセシビリティを指定してインターフェイスを宣言できますが、そのすべてのメンバーのアクセシビリティは public であることが必要です。  
+  
+-   インターフェイスでコンストラクターを定義することはできません。  
+  
+-   インターフェイスでフィールドを定義することはできません。  
+  
+-   インターフェイスで定義できるのはインスタンスのメンバーだけです。  静的メンバーを定義することはできません。  
+  
+ 各言語には、メンバーの実装をそのメンバーを要求するインターフェイスに割り当てるための規則があります。これは、複数のインターフェイスで同じシグネチャを持つメンバーを宣言でき、それらのメンバーが別個の実装を持つことができるためです。  
+  
+<a name="Delegates"></a>   
+### デリゲート  
+ デリゲートは、C\+\+ の関数ポインターと類似の目的で使用される参照型です。  これらは、.NET Framework のイベント ハンドラーとコールバック関数に使用されます。  関数ポインターとは異なり、デリゲートは安全で、検証可能で、タイプ セーフです。  デリゲート型は、互換性のあるシグネチャを持つすべてのインスタンス メソッドまたは静的メソッドを表すことができます。  
+  
+ デリゲートのパラメーターにメソッドのパラメーターよりも限定的な型が指定された場合、両者のパラメーター間に型の互換性があると見なされます。これによって、デリゲートに渡された引数が、メソッドに対して安全に渡されることが保証されます。  
+  
+ 同様に、メソッドの戻り値の型の制限がデリゲートの戻り値の型より多いと、メソッドの戻り値がデリゲートの戻り値の型に安全にキャストされることが保証されるため、デリゲートの戻り値の型とメソッドの戻り値の型には互換性があります。  
+  
+ たとえば、<xref:System.Collections.IEnumerable> 型のパラメーターおよび <xref:System.Object> 型の戻り値を持つデリゲートは、<xref:System.Object> 型のパラメーターおよび <xref:System.Collections.IEnumerable> 型の戻り値を持ったメソッドを表すことができます。  詳細およびプログラム例については、「<xref:System.Delegate.CreateDelegate%28System.Type%2CSystem.Object%2CSystem.Reflection.MethodInfo%29?displayProperty=fullName>」を参照してください。  
+  
+ よく "デリゲートは、それが表すメソッドにバインドされる" と言われます。  デリゲートは、メソッドにバインドされる以外にも、オブジェクトにバインドされる場合もあります。  オブジェクトはメソッドの第 1 パラメーターを表し、デリゲートが呼び出されるたびにメソッドに渡されます。  インスタンス メソッドの場合、バインドされたオブジェクトは、暗黙的な `this` パラメーター \(Visual Basic では `Me`\) として渡されます。静的メソッドの場合、オブジェクトは、メソッドの 1 つ目の仮パラメーターとして渡され、デリゲートのシグネチャは、その残りのパラメーターと完全に一致している必要があります。  詳細およびプログラム例については、「<xref:System.Delegate?displayProperty=fullName>」を参照してください。  
+  
+ すべてのデリゲートが <xref:System.MulticastDelegate?displayProperty=fullName> を継承し、System.MulticastDelegate は <xref:System.Delegate?displayProperty=fullName> を継承します。  C\#、Visual Basic、および C\+\+ 言語では、これらの型からの継承は許可されていません。  代わりに、デリゲートを宣言するためのキーワードが用意されています。  
+  
+ デリゲートは <xref:System.MulticastDelegate> を継承するため、デリゲートには呼び出しリストがあります。これは、デリゲートが表し、デリゲートが呼び出されたときに実行されるメソッドのリストです。  リストのすべてのメソッドは、デリゲートが呼び出されたときに指定される引数を受け取ります。  
+  
 > [!NOTE]
-> デリゲートに戻り値が含まれていても、呼び出しリストに複数のメソッドが含まれているデリゲートに対しては、戻り値は定義されません。
-
-コールバック メソッドの場合のように、多くの場合、デリゲートは&1; つのメソッドのみを表すため、デリゲートを作成し、呼び出す以外の処理は必要ありません。 
-
-複数のメソッドを表すデリゲートの場合、.NET は [Delegate](xref:System.Delegate) と [MulticastDelegate](xref:System.MulticastDelegate) デリゲート クラスのメソッドを提供し、デリゲートの呼び出しリスト ([Delegate.Combine](xref:System.Delegate.Combine(System.Delegate,System.Delegate)) メソッド) にメソッドを追加したり、メソッド ([Delegate.Remove](xref:System.Delegate.Remove(System.Delegate,System.Delegate)) メソッド) を削除したり、呼び出しリスト ([Delegate.GetInvocationList](xref:System.Delegate.GetInvocationList) メソッド) を取得したりする操作をサポートしています。
-
+>  デリゲートに戻り値が含まれていても、呼び出しリストに複数のメソッドが含まれているデリゲートに対しては、戻り値は定義されません。  
+  
+ コールバック メソッドの場合のように、多くの場合、デリゲートは 1 つのメソッドのみを表すため、デリゲートを作成し、呼び出す以外の処理は必要ありません。  
+  
+ 複数のメソッドを表すデリゲートの場合、.NET Framework は <xref:System.Delegate> と <xref:System.MulticastDelegate> デリゲート クラスのメソッドを提供し、デリゲートの呼び出しリスト \(<xref:System.Delegate.Combine%2A?displayProperty=fullName> メソッド\) にメソッドを追加したり、メソッド \(<xref:System.Delegate.Remove%2A?displayProperty=fullName> メソッド\) を削除したり、呼び出しリスト \(<xref:System.Delegate.GetInvocationList%2A?displayProperty=fullName>メソッド\) を取得したりする操作をサポートしています。  
+  
 > [!NOTE]
-> C# または Visual Basic では、イベント ハンドラー デリゲートに対して、これらのメソッドを使用する必要はありません。これらの言語には、イベント ハンドラーの追加および削除に使用する構文が用意されているためです。
-
-## <a name="type-definitions"></a>型定義
-
-型定義には、次のものが含まれます。 
-
-* 型に対して定義される属性
-
-* 型のアクセシビリティ (参照範囲)
-
-* 型の名前
-
-* 型の基本型
-
-* 型が実装するインターフェイス
-
-* 型の各メンバーの定義
-
-### <a name="attributes"></a>属性
-
-属性を使用して、ユーザー定義のメタデータを追加できます。 属性の最も一般的な用途は、型についての補足的な情報をそのアセンブリに保存したり、型のメンバーの動作をデザイン時または実行時環境で変更したりすることです。 
-
-属性は、それ自体が [System.Attribute](xref:System.Attribute) を継承するクラスです。 属性を使用できる言語にはそれぞれ、言語要素に属性を適用するための固有の構文があります。 属性はほぼすべての言語要素に適用できます。具体的にどの要素に属性を適用できるかは、その属性クラスに適用されている [AttributeUsageAttribute](xref:System.AttributeUsageAttribute) によって定義されます。
-
-### <a name="type-accessibility"></a>型のアクセシビリティ
-
-すべての型には、他の型からのアクセシビリティを制御する修飾子があります。 ランタイムによってサポートされる型のアクセシビリティについて次の表で説明します。
-
-ユーザー補助 | 説明
-------------- | -----------
-public | すべてのアセンブリから型にアクセスできます。
-アセンブリ | 同じアセンブリ内からだけ型にアクセスできます。
-
-入れ子にされた型のアクセシビリティは、その型のアクセシビリティ ドメインによって決まります。このアクセシビリティ ドメインは、そのメンバーに対して宣言されているアクセシビリティと、そのメンバーの直接のコンテナーである型のアクセシビリティ ドメインの両方によって決定されます。 ただし、入れ子にされた型のアクセシビリティ ドメインが、その型を含んでいる型のアクセシビリティ ドメインを上回ることはできません。
-
-`P` というプログラム内の `T` という型で宣言された `M` という入れ子にされたメンバーのアクセシビリティ ドメインは、次のように定義されます (`M` 自体も型である可能性があります)。 
-
-* `M` に対して宣言されたアクセシビリティが `public` の場合、`M` のアクセシビリティ ドメインは `T` のアクセシビリティ ドメインになります。
-
-* `M` に対して宣言されているアクセシビリティが `protected internal` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと、`P` のプログラム テキストおよび `T` の外側で宣言された `P` から派生した任意の型のプログラム テキストとの積集合になります。
-
-* `M` に対して宣言されているアクセシビリティが `protected` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと、`T` のプログラム テキストおよび `T` から派生した任意の型との積集合になります。
-
-* `M` に対して宣言されているアクセシビリティが `internal` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと `P` のプログラム テキストとの積集合になります。
-
-* `M` に対して宣言されているアクセシビリティが `private` の場合、`M` のアクセシビリティ ドメインは `T` のプログラム テキストになります。
-
-### <a name="type-names"></a>型名
-
-共通型システムでは、名前に関して適用される制限は次の&2; つだけです。 
-
-* すべての名前は Unicode (16 ビット) 文字列としてエンコードされます。
-
-* 名前には、値 0x0000 (16 ビット) を埋め込むことはできません。
-
-ただし、ほとんどの言語に型名に関する追加の制約が存在します。 すべての比較はバイト単位で行われるため、大文字と小文字を区別し、ロケールに依存しません。
-
-型は、他のモジュールおよびアセンブリの型を参照する場合もありますが、1 つの .NET モジュール内で完全に定義されます  (ただし、コンパイラがサポートしていれば、複数のソース コード ファイルに分割できる場合もあります)。型名は&1; つの名前空間内で一意である必要があります。 型が完全に識別されるようにするため、その型名は、その型の実装を含んでいる名前空間によって修飾される必要があります。
-
-### <a name="base-types-and-interfaces"></a>基本型とインターフェイス
-
-型は、別の型から値と動作を継承できます。 共通型システムでは、複数の基本型から継承する型を作成することはできません。
-
-型は任意の数のインターフェイスを実装できます。 型にインターフェイスを実装するには、そのインターフェイスのすべての仮想メンバーをその型に実装する必要があります。 仮想メソッドは派生型によって実装でき、静的または動的に呼び出すことができます。
-
-## <a name="type-members"></a>型のメンバー
-
-ランタイムでは、型の動作と状態を指定する型のメンバーを定義できます。 型のメンバーには、次のようなものがあります。
-
-* [フィールド](#fields)
-
-* [プロパティ](#properties)
-
-* [メソッド](#methods)
-
-* [コンストラクター](#constructors)
-
-* [イベント](#events)
-
-* [入れ子にされた型](#nested-types)
-
-### <a name="fields"></a>フィールド
-
-フィールドは、型の状態の一部を表し、格納するものです。 フィールドは、ランタイムがサポートする任意の型にすることができます。 通常、フィールドは、同じクラスまたはその派生クラスからしかアクセスできないように、`private` または `protected` のいずれかに設定されます。 フィールドの値を型の外部から変更できるようにする場合は、プロパティの set アクセサーを使用するのが一般的です。 パブリックに公開されたフィールドは、通常、読み取り専用であり、次の&2; 種類に分けることができます。 
-
-* 定数。その値は、デザイン時に割り当てられます。 これらはクラスの静的メンバーですが、`static` (Visual Basic では `Shared`) キーワードを使用して定義されません。
-
-* 読み取り専用の変数。その値は、クラスのコンストラクターで割り当てることができます。
-
-次の例は、読み取り専用フィールドの&2; つの用法を示しています。
-
-```csharp
-using System;
-
-public class Constants
-{
-   public const double Pi = 3.1416;
-   public readonly DateTime BirthDate;
-
-   public Constants(DateTime birthDate)
-   {
-      this.BirthDate = birthDate;
-   }
-}
-
-public class Example
-{
-   public static void Main()
-   {
-      Constants con = new Constants(new DateTime(1974, 8, 18));
-      Console.Write(Constants.Pi + "\n");
-      Console.Write(con.BirthDate.ToString("d") + "\n");
-   }
-}
-// The example displays the following output if run on a system whose current
-// culture is en-US:
-//    3.1417
-//    8/18/1974
-```
-
-```vb
-Public Class Constants
-   Public Const Pi As Double = 3.1416
-   Public ReadOnly BirthDate As Date
-
-   Public Sub New(birthDate As Date)
-      Me.BirthDate = birthDate
-   End Sub
-End Class
-
-Public Module Example
-   Public Sub Main()
-      Dim con As New Constants(#8/18/1974#)
-      Console.WriteLine(Constants.Pi.ToString())
-      Console.WriteLine(con.BirthDate.ToString("d"))
-   End Sub
-End Module
-' The example displays the following output if run on a system whose current
-' culture is en-US:
-'    3.1417
-'    8/18/1974
-```
-
-### <a name="properties"></a>プロパティ
-
-プロパティは、型の値または状態に名前を付け、そのプロパティの値を取得または設定するためのメソッドを定義します。 プロパティは、プリミティブ型、プリミティブ型のコレクション、ユーザー定義型、ユーザー定義型のコレクションにすることができます。 多くの場合、プロパティは、型のパブリックなインターフェイスを、その型の個々の実装とは切り離すために使用されます。 これにより、クラスに直接格納されていない値をプロパティに反映させたり (プロパティが計算後の値を返す場合など)、プライベート フィールドに割り当てる値を事前に検証したりすることが可能です。 後者のパターンを説明する例を次に示します。
-
-```csharp
-using System;
-
-public class Person
-{
-   private int m_Age;
-
-   public int Age
-   { 
-      get { return m_Age; }
-      set {
-         if (value < 0 || value > 125)
-         {
-            throw new ArgumentOutOfRangeException("The value of the Age property must be between 0 and 125.");
-         }
-         else
-         {
-            m_Age = value;
-         }         
-      }
-   }
-}
-```
-
-```vb
-Public Class Person
-   Private m_Age As Integer
-
-   Public Property Age As Integer
-      Get
-         Return m_Age
-      End Get
-      Set
-         If value < 0 Or value > 125 Then
-            Throw New ArgumentOutOfRangeException("The value of the Age property must be between 0 and 125.")
-         Else
-            m_Age = value
-         End If
-      End Set
-   End Property
-End Class
-```
-
-読み取り可能なプロパティを含んだ型の Microsoft Intermediate Language (MSIL) には、プロパティそのもののほかに、`get`*_propertyname* メソッドが含まれています。また、書き込み可能なプロパティを含んだ型の MSIL には、`set`*_propertyname* メソッドが含まれています。
-
-### <a name="methods"></a>メソッド
-
-メソッドは、その型で利用できる操作を表します。 メソッドのシグネチャは、そのメソッドのパラメーターの型および戻り値の型として許可される型を示します。
-
-ほとんどのメソッドでは、メソッド呼び出しに必要なパラメーターの厳密な個数が定義されていますが、いくつかのメソッドは可変個のパラメーターをサポートしています。 このようなメソッドで最後に宣言されるパラメーターには、[ParamArrayAttribute](xref:System.ParamArrayAttribute) 属性が適用されます。 通常、言語コンパイラには、C# の `params` や Visual Basic の `ParamArray` など、[ParamArrayAttribute](xref:System.ParamArrayAttribute) の明示的な使用を不要にするキーワードがあります。
-
-### <a name="constructors"></a>コンストラクター
-
-コンストラクターは、クラスまたは構造体の新しいインスタンスを作成する特殊なメソッドです。 他のメソッドと同様に、コンストラクターには、パラメーターを指定することができます。ただし、コンストラクターには戻り値はありません (つまり、`void` が返されます)。 
-
-クラスのソース コードに明示的にコンストラクターが定義されていない場合は、コンパイラによって既定の (パラメーターなしの) コンストラクターが追加されます。 ただし、パラメーター化されたコンストラクターのみがクラスのソース コードで定義されている場合は、C# のコンパイラが、パラメーターなしのコンストラクターを生成しません。
-
-構造体のソース コードでコンストラクターが定義される場合は、それらのコンストラクターがパラメーター化されている必要があります。構造体では既定の (パラメーターなしの) コンストラクターを定義できず、コンパイラは、構造体および他の値型のいずれに対しても、パラメーターなしのコンストラクターを生成しません。 すべての値型には、暗黙の既定コンストラクターがあります。 このコンストラクターは、共通言語ランタイムによって実装され、構造体のすべてのフィールドを既定の値に初期化します。 
-
-### <a name="events"></a>イベント
-
-イベントは、応答可能な事象 (イベント) を定義し、イベントへのサブスクライブ、イベントからのサブスクライブ解除、およびイベントの発生用のメソッドを定義します。 多くの場合、イベントは、他の型に対して状態の変更を通知するために使用されます。
-
-### <a name="nested-types"></a>入れ子にされた型
-
-入れ子にされた型とは、他の型のメンバーである型です。 入れ子にされた型はその親の型と密に結合されているため、汎用型としては使用できません。 入れ子にされた型は、宣言型で、入れ子にされた型のインスタンスを使用したり作成したりする場合に便利で、入れ子にされた型の使用はパブリック メンバーに公開されません。
-
-入れ子にされた型は、混乱を招くおそれがあるため、特別な理由がない限り、パブリックに参照可能にすることはお勧めできません。 適切にデザインされたライブラリでは、入れ子にされた型を使ってオブジェクトをインスタンス化したり、変数を宣言したりすることが必要になることはほとんどありません。
-
-## <a name="characteristics-of-type-members"></a>型のメンバーの特性
-
-共通型システムでは、型のメンバーにさまざまな特性を適用できますが、各言語で、これらの特性がすべてサポートされている必要はありません。 メンバーの特性について次の表で説明します。
-
-特徴 | 適用対象 | 説明
--------------- | ------------ | -----------
-abstract | メソッド、プロパティ、およびイベント | 型はメソッドの実装を提供しません。 抽象メソッドを継承または実装する型は、そのメソッドの実装を提供する必要があります。 唯一の例外は、派生型自体が抽象型である場合です。 すべての抽象メソッドは仮想メソッドです。
-private | すべて | メンバーが含まれているのと同じ型の内部、またはその型に入れ子にされた型の内部からだけアクセスできます。
-family | すべて | メンバーが含まれているのと同じ型の内部、およびその型を継承した派生型からアクセスできます。
-assemby | すべて | 型が定義されているアセンブリ内でだけアクセスできます。
-family and assembly | すべて | family アクセスと assembly アクセスの両特性を満たす型からだけアクセスできます。
-family または assemby | すべて | family アクセスまたは assembly アクセスのいずれかの特性を満たす型からだけアクセスできます。
-public | すべて | すべての型からアクセスできます。
-final | メソッド、プロパティ、およびイベント | その仮想メソッドを派生型ではオーバーライドできません。
-initialize-only | フィールド | 値を初期化することだけでき、初期化後の書き込みは実行できません。
-インスタンス | フィールド、メソッド、プロパティ、およびイベント | メンバーが `static` (C# )、`Shared` (Visual Basic)、`virtual` (C# )、または `Overridable` (Visual Basic) でマークされていない場合、それはインスタンス メンバーです (instance キーワードはありません)。 このようなメンバーについては、型を使用するオブジェクトと同数のコピーがメモリ内に格納されます。
-リテラル | フィールド | このフィールドには、組み込みの値型の、コンパイル時点の固定値が割り当てられます。 リテラル フィールドを定数と呼ぶこともあります。
-newslot または override | すべて | メンバーが、同じシグネチャを持つ継承メンバーとどのようにやり取りするかを定義します。`newslot` は、同じシグネチャを持つ継承されたメンバーを隠します。`override` は、継承された仮想メソッドの定義を置き換えます。 既定値は newslot です。
-静的 | フィールド、メソッド、プロパティ、およびイベント | メンバーは、型の特定のインスタンスではなく、そのメンバーが定義されている型に属します。つまり、メンバーは型がインスタンス化されていなくても存在し、その型のすべてのインスタンスによって共有されます。
-virtual | メソッド、プロパティ、およびイベント | メソッドは、派生型で実装でき、静的または動的に呼び出すことができます。 動的呼び出しが使用される場合は、実行時に呼び出しを行うインスタンスの型によって (コンパイル時に判明する型ではなく)、メソッドのどの実装が呼び出されるかが決定されます。 仮想メソッドを静的に呼び出すには、目的のバージョンのメソッドを使用する型に、変数をキャストする必要が生じる場合があります。
-
-### <a name="overloading"></a>オーバーロード
-
-型のメンバーには、それぞれ固有のシグネチャがあります。 メソッドのシグネチャは、メソッドの名前とパラメーター リスト (メソッドの引数の順序と型) で構成されます。 シグネチャが同じでなければ、同じ名前を持つ複数のメソッドを&1; つの型の中で定義できます。 同じ名前を持つ&2; つ以上のメソッドが定義されている場合、そのメソッドはオーバーロードされている、と言います。 たとえば、[System.Char](xref:System.Char) では、`IsDigit` メソッドがオーバーロードされています。 一方のメソッドは [Char](xref:System.Char) を受け取ります。 もう一方のメソッドは、[String](xref:System.String) および [Int32](xref:System.Int32) を受け取ります。 
-
+>  C\#、C\+\+、および Visual Basic では、イベント ハンドラー デリゲートに対して、これらのメソッドを使用する必要はありません。これらの言語には、イベント ハンドラーの追加および削除に使用する構文が用意されているためです。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="type_definitions"></a>   
+## 型定義  
+ 型定義には、次のものが含まれます。  
+  
+-   型に対して定義される属性  
+  
+-   型のアクセシビリティ \(参照範囲\)  
+  
+-   型の名前  
+  
+-   型の基本型  
+  
+-   型が実装するインターフェイス  
+  
+-   型の各メンバーの定義  
+  
+### 属性  
+ 属性を使用して、ユーザー定義のメタデータを追加できます。  属性の最も一般的な用途は、型についての補足的な情報をそのアセンブリに保存したり、型のメンバーの動作をデザイン時または実行時環境で変更したりすることです。  
+  
+ 属性は、それ自体が <xref:System.Attribute?displayProperty=fullName> を継承するクラスです。  属性を使用できる言語にはそれぞれ、言語要素に属性を適用するための固有の構文があります。  属性はほぼすべての言語要素に適用できます。具体的にどの要素に属性を適用できるかは、その属性クラスに適用されている <xref:System.AttributeUsageAttribute> によって定義されます。  
+  
+### 型のアクセシビリティ  
+ すべての型には、他の型からのアクセシビリティを制御する修飾子があります。  ランタイムによってサポートされる型のアクセシビリティについて次の表で説明します。  
+  
+|ユーザー補助|説明|  
+|------------|--------|  
+|public|すべてのアセンブリから型にアクセスできます。|  
+|アセンブリ|同じアセンブリ内からだけ型にアクセスできます。|  
+  
+ 入れ子にされた型のアクセシビリティは、その型のアクセシビリティ ドメインによって決まります。このアクセシビリティ ドメインは、そのメンバーに対して宣言されているアクセシビリティと、そのメンバーの直接のコンテナーである型のアクセシビリティ ドメインの両方によって決定されます。  ただし、入れ子にされた型のアクセシビリティ ドメインが、その型を含んでいる型のアクセシビリティ ドメインを上回ることはできません。  
+  
+ `M` というプログラム内の `T` という型で宣言された `P` という入れ子にされたメンバーのアクセシビリティ ドメインは、次のように定義されます \(`M` 自体も型である可能性があります\)。  
+  
+-   `M` に対して宣言されたアクセシビリティが `public` の場合、`M` のアクセシビリティ ドメインは `T` のアクセシビリティ ドメインになります。  
+  
+-   `M` に対して宣言されているアクセシビリティが `protected internal` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと、`P` のプログラム テキストおよび `T` の外側で宣言された `P` から派生した任意の型のプログラム テキストとの積集合になります。  
+  
+-   `M` に対して宣言されているアクセシビリティが `protected` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと、`T` のプログラム テキストおよび `T` から派生した任意の型との積集合になります。  
+  
+-   `M` に対して宣言されているアクセシビリティが `internal` の場合、`M` のアクセシビリティ ドメインは、`T` のアクセシビリティ ドメインと `P` のプログラム テキストとの積集合になります。  
+  
+-   `M` に対して宣言されているアクセシビリティが `private` の場合、`M` のアクセシビリティ ドメインは `T` のプログラム テキストになります。  
+  
+### 型名  
+ 共通型システムでは、名前に関して適用される制限は次の 2 つだけです。  
+  
+-   すべての名前は Unicode \(16 ビット\) 文字列としてエンコードされます。  
+  
+-   名前には、値 0x0000 \(16 ビット\) を埋め込むことはできません。  
+  
+ ただし、ほとんどの言語に型名に関する追加の制約が存在します。  すべての比較はバイト単位で行われるため、大文字と小文字を区別し、ロケールに依存しません。  
+  
+ 型は、他のモジュールおよびアセンブリの型を参照する場合もありますが、1 つの .NET Framework モジュール内で完全に定義されます   \(ただし、コンパイラがサポートしていれば、複数のソース コード ファイルに分割できる場合もあります\)。 型名は 1 つの名前空間内で一意である必要があります。  型が完全に識別されるようにするため、その型名は、その型の実装を含んでいる名前空間によって修飾される必要があります。  
+  
+### 基本型とインターフェイス  
+ 型は、別の型から値と動作を継承できます。  共通型システムでは、複数の基本型から継承する型を作成することはできません。  
+  
+ 型は任意の数のインターフェイスを実装できます。  型にインターフェイスを実装するには、そのインターフェイスのすべての仮想メンバーをその型に実装する必要があります。  仮想メソッドは派生型によって実装でき、静的または動的に呼び出すことができます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="type_members"></a>   
+## 型のメンバー  
+ ランタイムでは、型の動作と状態を指定する型のメンバーを定義できます。  型のメンバーには、次のようなものがあります。  
+  
+-   [フィールド](#Fields)  
+  
+-   [プロパティ](#Properties)  
+  
+-   [メソッド](#Methods)  
+  
+-   [コンストラクター](#Constructors)  
+  
+-   [イベント](#Events)  
+  
+-   [入れ子にされた型](#NestedTypes)  
+  
+<a name="Fields"></a>   
+### フィールド  
+ フィールドは、型の状態の一部を表し、格納するものです。  フィールドは、ランタイムがサポートする任意の型にすることができます。  通常、フィールドは、同じクラスまたはその派生クラスからしかアクセスできないように、`private` または `protected` のいずれかに設定されます。  フィールドの値を型の外部から変更できるようにする場合は、プロパティの set アクセサーを使用するのが一般的です。  パブリックに公開されたフィールドは、通常、読み取り専用であり、次の 2 種類に分けることができます。  
+  
+-   定数。その値は、デザイン時に割り当てられます。  これらはクラスの静的メンバーですが、`static` \(Visual Basic では `Shared`\) キーワードを使用して定義されません。  
+  
+-   読み取り専用の変数。その値は、クラスのコンストラクターで割り当てることができます。  
+  
+ 次の例は、読み取り専用フィールドの 2 つの用法を示しています。  
+  
+ [!code-csharp[Conceptual.Types.Members.Fields#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.members.fields/cs/example.cs#1)]
+ [!code-vb[Conceptual.Types.Members.Fields#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.members.fields/vb/example.vb#1)]  
+  
+<a name="Properties"></a>   
+### プロパティ  
+ プロパティは、型の値または状態に名前を付け、そのプロパティの値を取得または設定するためのメソッドを定義します。  プロパティは、プリミティブ型、プリミティブ型のコレクション、ユーザー定義型、ユーザー定義型のコレクションにすることができます。  多くの場合、プロパティは、型のパブリックなインターフェイスを、その型の個々の実装とは切り離すために使用されます。  これにより、クラスに直接格納されていない値をプロパティに反映させたり \(プロパティが計算後の値を返す場合など\)、プライベート フィールドに割り当てる値を事前に検証したりすることが可能です。  後者のパターンを説明する例を次に示します。  
+  
+ [!code-csharp[Conceptual.Types.Members.Properties#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.types.members.properties/cs/example.cs#1)]
+ [!code-vb[Conceptual.Types.Members.Properties#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.types.members.properties/vb/example.vb#1)]  
+  
+ 読み取り可能なプロパティを含んだ型の Microsoft Intermediate Language \(MSIL\) には、プロパティそのもののほかに、`get_`*propertyname* メソッドが含まれています。また、書き込み可能なプロパティを含んだ型の MSIL には、`set_`*propertyname* メソッドが含まれています。  
+  
+<a name="Methods"></a>   
+### メソッド  
+ メソッドは、その型で利用できる操作を表します。  メソッドのシグネチャは、そのメソッドのパラメーターの型および戻り値の型として許可される型を示します。  
+  
+ ほとんどのメソッドでは、メソッド呼び出しに必要なパラメーターの厳密な個数が定義されていますが、いくつかのメソッドは可変個のパラメーターをサポートしています。  このようなメソッドで最後に宣言されるパラメーターには、<xref:System.ParamArrayAttribute> 属性が適用されます。  通常、言語コンパイラには、C\# の `params` や Visual Basic の `ParamArray` など、<xref:System.ParamArrayAttribute> の明示的な使用を不要にするキーワードがあります。  
+  
+<a name="Constructors"></a>   
+### コンストラクター  
+ コンストラクターは、クラスまたは構造体の新しいインスタンスを作成する特殊なメソッドです。  他のメソッドと同様に、コンストラクターには、パラメーターを指定することができます。ただし、コンストラクターには戻り値はありません \(つまり、`void` が返されます\)。  
+  
+ クラスのソース コードに明示的にコンストラクターが定義されていない場合は、コンパイラによって既定の \(パラメーターなしの\) コンストラクターが追加されます。  ただし、パラメーター化されたコンストラクターのみがクラスのソース コードで定義されている場合は、Visual Basic および C\# のコンパイラが、パラメーターなしのコンストラクターを生成しません。  
+  
+ 構造体のソース コードでコンストラクターが定義される場合は、それらのコンストラクターがパラメーター化されている必要があります。構造体では既定の \(パラメーターなしの\) コンストラクターを定義できず、コンパイラは、構造体および他の値型のいずれに対しても、パラメーターなしのコンストラクターを生成しません。  すべての値型には、暗黙の既定コンストラクターがあります。  このコンストラクターは、共通言語ランタイムによって実装され、構造体のすべてのフィールドを既定の値に初期化します。  
+  
+<a name="Events"></a>   
+### イベント  
+ イベントは、応答可能な事象 \(イベント\) を定義し、イベントへのサブスクライブ、イベントからのサブスクライブ解除、およびイベントの発生用のメソッドを定義します。  多くの場合、イベントは、他の型に対して状態の変更を通知するために使用されます。  詳細については、「[イベント](../../../docs/standard/events/index.md)」を参照してください。  
+  
+<a name="NestedTypes"></a>   
+### 入れ子にされた型  
+ 入れ子にされた型とは、他の型のメンバーである型です。  入れ子にされた型はその親の型と密に結合されているため、汎用型としては使用できません。  入れ子にされた型は、宣言型で、入れ子にされた型のインスタンスを使用したり作成したりする場合に便利で、入れ子にされた型の使用はパブリック メンバーに公開されません。  
+  
+ 入れ子にされた型は、混乱を招くおそれがあるため、特別な理由がない限り、パブリックに参照可能にすることはお勧めできません。  適切にデザインされたライブラリでは、入れ子にされた型を使ってオブジェクトをインスタンス化したり、変数を宣言したりすることが必要になることはほとんどありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="characteristics_of_type_members"></a>   
+## 型のメンバーの特性  
+ 共通型システムでは、型のメンバーにさまざまな特性を適用できますが、各言語で、これらの特性がすべてサポートされている必要はありません。  メンバーの特性について次の表で説明します。  
+  
+|特徴|適用対象|説明|  
+|--------|----------|--------|  
+|abstract|メソッド、プロパティ、およびイベント|型はメソッドの実装を提供しません。  抽象メソッドを継承または実装する型は、そのメソッドの実装を提供する必要があります。  唯一の例外は、派生型自体が抽象型である場合です。  すべての抽象メソッドは仮想メソッドです。|  
+|private、family、assembly、family and assembly、family or assembly、または public|すべて|メンバーのアクセシビリティを次のように定義します。<br /><br /> private<br /> メンバーが含まれているのと同じ型の内部、またはその型に入れ子にされた型の内部からだけアクセスできます。<br /><br /> family<br /> メンバーが含まれているのと同じ型の内部、およびその型を継承した派生型からアクセスできます。<br /><br /> アセンブリ<br /> 型が定義されているアセンブリ内でだけアクセスできます。<br /><br /> family and assembly<br /> family アクセスと assembly アクセスの両特性を満たす型からだけアクセスできます。<br /><br /> family or assembly<br /> family アクセスまたは assembly アクセスのいずれかの特性を満たす型からだけアクセスできます。<br /><br /> public<br /> すべての型からアクセスできます。|  
+|final|メソッド、プロパティ、およびイベント|その仮想メソッドを派生型ではオーバーライドできません。|  
+|initialize\-only|フィールド|値を初期化することだけでき、初期化後の書き込みは実行できません。|  
+|インスタンス|フィールド、メソッド、プロパティ、およびイベント|メンバーが `static` \(C\# および C\+\+\)、`Shared` \(Visual Basic\)、`virtual` \(C\# および C\+\+\)、または `Overridable` \(Visual Basic\) でマークされていない場合、それはインスタンス メンバーです \(instance キーワードはありません\)。  このようなメンバーについては、型を使用するオブジェクトと同数のコピーがメモリ内に格納されます。|  
+|リテラル|フィールド|このフィールドには、組み込みの値型の、コンパイル時点の固定値が割り当てられます。  リテラル フィールドを定数と呼ぶこともあります。|  
+|newslot または override|すべて|メンバーが、同じシグネチャを持つ継承メンバーとどのようにやり取りするかを定義します。<br /><br /> newslot<br /> 同じシグネチャを持つ継承されたメンバーを隠ぺいします。<br /><br /> override<br /> 継承された仮想メソッドの定義を置き換えます。<br /><br /> 既定値は newslot です。|  
+|静的|フィールド、メソッド、プロパティ、およびイベント|メンバーは、型の特定のインスタンスではなく、そのメンバーが定義されている型に属します。つまり、メンバーは型がインスタンス化されていなくても存在し、その型のすべてのインスタンスによって共有されます。|  
+|virtual|メソッド、プロパティ、およびイベント|メソッドは、派生型で実装でき、静的または動的に呼び出すことができます。  動的呼び出しが使用される場合は、実行時に呼び出しを行うインスタンスの型によって \(コンパイル時に判明する型ではなく\)、メソッドのどの実装が呼び出されるかが決定されます。  仮想メソッドを静的に呼び出すには、目的のバージョンのメソッドを使用する型に、変数をキャストする必要が生じる場合があります。|  
+  
+### オーバーロード  
+ 型のメンバーには、それぞれ固有のシグネチャがあります。  メソッドのシグネチャは、メソッドの名前とパラメーター リスト \(メソッドの引数の順序と型\) で構成されます。  シグネチャが同じでなければ、同じ名前を持つ複数のメソッドを 1 つの型の中で定義できます。  同じ名前を持つ 2 つ以上のメソッドが定義されている場合、そのメソッドはオーバーロードされている、と言います。  たとえば、<xref:System.Char?displayProperty=fullName> では、<xref:System.Char.IsDigit%2A> メソッドがオーバーロードされています。  一方のメソッドは <xref:System.Char> を受け取ります。  もう一方のメソッドは、<xref:System.String> および <xref:System.Int32> を受け取ります。  
+  
 > [!NOTE]
-> 戻り値の型は、メソッドのシグネチャの一部として見なされません。 つまり、戻り値の型が異なっているだけでは、メソッドをオーバーロードすることはできません。
-
-### <a name="inheriting-overriding-and-hiding-members"></a>メンバーの継承、オーバーライド、および隠ぺい
-
-派生型は、その基本型のすべてのメンバーを継承します。つまり、基本型のすべてのメンバーは、派生型に対しても定義されており、使用可能です。 継承されたメンバーの動作または特性は、次の&2; つの方法で変更できます。 
-
-* 派生型で、同じシグネチャを持つ新しいメンバーを定義することによって、継承されたメンバーを隠ぺいできます。 この方法は、public のメンバーを private に変更したり、`final` としてマークされている継承メソッドに新しい動作を定義したりするために使用します。
-
-* 派生型で、継承された仮想メソッドをオーバーライドできます。 オーバーライドするメソッドでは、コンパイル時点の変数の型ではなく、実行時の値の型に基づいて呼び出される、メソッドの新しい定義を提供します。 メソッドが仮想メソッドをオーバーライドできるのは、その仮想メソッドが `final` としてマークされておらず、新しいメソッドのアクセシビリティがその仮想メソッドと少なくとも同じ場合に限られます。
-
-## <a name="see-also"></a>関連項目
-
-[.NET Framework における型変換](type-conversion.md)
+>  戻り値の型は、メソッドのシグネチャの一部として見なされません。  つまり、戻り値の型が異なっているだけでは、メソッドをオーバーロードすることはできません。  
+  
+### メンバーの継承、オーバーライド、および隠ぺい  
+ 派生型は、その基本型のすべてのメンバーを継承します。つまり、基本型のすべてのメンバーは、派生型に対しても定義されており、使用可能です。  継承されたメンバーの動作または特性は、次の 2 つの方法で変更できます。  
+  
+-   派生型で、同じシグネチャを持つ新しいメンバーを定義することによって、継承されたメンバーを隠ぺいできます。  この方法は、public のメンバーを private に変更したり、`final` としてマークされている継承メソッドに新しい動作を定義したりするために使用します。  
+  
+-   派生型で、継承された仮想メソッドをオーバーライドできます。  オーバーライドするメソッドでは、コンパイル時点の変数の型ではなく、実行時の値の型に基づいて呼び出される、メソッドの新しい定義を提供します。  メソッドが仮想メソッドをオーバーライドできるのは、その仮想メソッドが `final` としてマークされておらず、新しいメソッドのアクセシビリティがその仮想メソッドと少なくとも同じ場合に限られます。  
+  
+## 参照  
+ [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkID=217856)   
+ [共通言語ランタイム](../../../docs/standard/clr.md)   
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/comparing.md b/docs/standard/base-types/comparing.md
index 2a79df8384f..91bfab5ab6b 100644
--- a/docs/standard/base-types/comparing.md
+++ b/docs/standard/base-types/comparing.md
@@ -1,221 +1,155 @@
 ---
-title: "文字列の比較"
-description: "文字列の比較"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 920ee5e8-3d61-4941-b5af-fc50eaee427c
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 47ee37886fa2662a89730e9d52ee04987e37da2f
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="comparing-strings"></a>文字列の比較
-
-.NET は、文字列の値を比較するためのメソッドをいくつか提供します。 これらの値の比較メソッドとその説明を次の表に示します。
-
-メソッド名 | 使用
------------ | ---
-[String.Compare](xref:System.String.Compare(System.String,System.Int32,System.String,System.Int32,System.Int32)) | 2 つの文字列の値を比較します。 整数値を返します。
-[String.CompareOrdinal](xref:System.String.CompareOrdinal(System.String,System.Int32,System.String,System.Int32,System.Int32)) | ローカル カルチャに関係なく、2 つの文字列を比較します。 整数値を返します。
-[String.CompareTo](xref:System.String.CompareTo(System.String)) | 現在の文字列オブジェクトを別の文字列と比較します。 整数値を返します。
-[String.StartsWith](xref:System.String.StartsWith(System.String)) | 文字列が、渡された文字列で始まるかどうかを確認します。 Boolean 値を返します。
-[String.EndsWith](xref:System.String.CompareTo(System.String)) | 文字列が、渡された文字列で終わるかどうかを確認します。 Boolean 値を返します。
-[String.Equals](xref:System.String.CompareTo(System.String)) | 2 つの文字列が等しいかどうかを確認します。 Boolean 値を返します。
-[String.IndexOf](xref:System.String.IndexOf(System.Char)) | 検索対象文字列の先頭から開始して、特定の文字または文字列が見つかったインデックス位置を返します。 整数値を返します。
-[String.LastIndexOf](xref:System.String.LastIndexOf(System.Char)) | 検索対象文字列の末尾から開始して、特定の文字または文字列が見つかったインデックス位置を返します。 整数値を返します。
-
-## <a name="compare"></a>比較
-
-静的な [String.Compare](xref:System.String.Compare(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドは、2 つの文字列を詳細に比較する手段を提供します。 このメソッドはカルチャに対応しています。 この機能は、2 つの文字列、または&2; つの文字列の部分文字列を比較するために使用できます。 また、大文字と小文字の区別やカルチャの違いを考慮または無視するためのオーバーロードも用意されています。 このメソッドによって返される可能性のある&3; つの整数値を次の表に示します。 
-
-戻り値 | 条件
------------- | ---------
-負の整数 | 最初の文字列は、並べ替え順序が&2; 番目の文字列の前に置かれます。そうでない場合、最初の文字列は `null` です。
-0 | 最初の文字列と&2; 番目の文字列は等価です。そうでない場合、両方の文字列が `null` です。
-正の整数、または 1 | 最初の文字列は、並べ替え順序が&2; 番目の文字列の後に続きます。そうでない場合、2 番目の文字列は null です。
- 
+title: ".NET Framework における文字列の比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Compare メソッド"
+  - "CompareOrdinal メソッド"
+  - "CompareTo メソッド"
+  - "EndsWith メソッド"
+  - "Equals メソッド"
+  - "IndexOf メソッド"
+  - "LastIndexOf メソッド"
+  - "StartsWith メソッド"
+  - "文字列 [.NET Framework], 比較"
+  - "値比較 (文字列の)"
+ms.assetid: 977dc094-fe19-4955-98ec-d2294d04a4ba
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework における文字列の比較
+.NET Framework は、文字列の値を比較するためのメソッドをいくつか提供します。 これらの値の比較メソッドとその説明を次の表に示します。  
+  
+|メソッド名|用途|  
+|-----------|--------|  
+|<xref:System.String.Compare%2A?displayProperty=fullName>|2 つの文字列の値を比較します。 整数値を返します。|  
+|<xref:System.String.CompareOrdinal%2A?displayProperty=fullName>|ローカル カルチャに関係なく、2 つの文字列を比較します。 整数値を返します。|  
+|<xref:System.String.CompareTo%2A?displayProperty=fullName>|現在の文字列オブジェクトを別の文字列と比較します。 整数値を返します。|  
+|<xref:System.String.StartsWith%2A?displayProperty=fullName>|文字列が、渡された文字列で始まるかどうかを確認します。 Boolean 値を返します。|  
+|<xref:System.String.EndsWith%2A?displayProperty=fullName>|文字列が、渡された文字列で終わるかどうかを確認します。 Boolean 値を返します。|  
+|<xref:System.String.Equals%2A?displayProperty=fullName>|2 つの文字列が等しいかどうかを確認します。 Boolean 値を返します。|  
+|<xref:System.String.IndexOf%2A?displayProperty=fullName>|検索対象文字列の先頭から開始して、特定の文字または文字列が見つかったインデックス位置を返します。 整数値を返します。|  
+|<xref:System.String.LastIndexOf%2A?displayProperty=fullName>|検索対象文字列の末尾から開始して、特定の文字または文字列が見つかったインデックス位置を返します。 整数値を返します。|  
+  
+## 比較  
+ 静的な <xref:System.String.Compare%2A?displayProperty=fullName> メソッドは、2 つの文字列を詳細に比較する手段を提供します。 このメソッドはカルチャに対応しています。 この機能は、2 つの文字列、または 2 つの文字列の部分文字列を比較するために使用できます。 また、大文字と小文字の区別やカルチャの違いを考慮または無視するためのオーバーロードも用意されています。 このメソッドによって返される可能性のある 3 つの整数値を次の表に示します。  
+  
+|戻り値|条件|  
+|---------|--------|  
+|負の整数|最初の文字列は、並べ替え順序が 2 番目の文字列の前に置かれます。<br /><br /> または<br /><br /> 最初の文字列は `null` です。|  
+|0|最初の文字列と 2 番目の文字列は等価です。<br /><br /> または<br /><br /> 両方の文字列が `null`です。|  
+|正の整数<br /><br /> または<br /><br /> 1|最初の文字列は、並べ替え順序が 2 番目の文字列の後に続きます。<br /><br /> または<br /><br /> 第 2 文字列は `null` です。|  
+  
 > [!IMPORTANT]
-> [String.Compare](xref:System.String.Compare(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする (つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する) 目的では、[String.Compare](xref:System.String.Compare(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、[String.Equals(String, String, StringComparison)](xref:System.String.Equals(System.String,System.String,System.StringComparison)) メソッドを使用してください。
-
-[String.Compare](xref:System.String.Compare(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドを使用して、2 つの文字列の相対値を確認する例を次に示します。
-
-```csharp
-string string1 = "Hello World!";
-Console.WriteLine(String.Compare(string1, "Hello World?"));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(String.Compare(string1, "Hello World?"))
-```
-
-この例は、コンソールに `-1` と出力します。
-
-## <a name="compareordinal"></a>CompareOrdinal
-
-[String.CompareOrdinal](xref:System.String.CompareOrdinal(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドは、ローカル カルチャを考慮せずに&2; つの文字列オブジェクトを比較します。 このメソッドの戻り値は、上の表で示した `Compare` メソッドによって返される値と同じです。
-
+>  <xref:System.String.Compare%2A?displayProperty=fullName> メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする \(つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する\) 目的では、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、<xref:System.String.Equals%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> メソッドを使用してください。  
+  
+ <xref:System.String.Compare%2A?displayProperty=fullName> メソッドを使用して、2 つの文字列の相対値を確認する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#6)]
+ [!code-csharp[Conceptual.String.BasicOps#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#6)]
+ [!code-vb[Conceptual.String.BasicOps#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#6)]  
+  
+ この例は、コンソールに `-1` と出力します。  
+  
+ 既定では、上の例はカルチャによって異なります。 カルチャに依存しない文字列操作を実行するには、*culture* パラメーターを指定することによって使用するカルチャを指定することを可能にする <xref:System.String.Compare%2A?displayProperty=fullName> メソッドのオーバーロードを使用します。<xref:System.String.Compare%2A?displayProperty=fullName> メソッドを使用してカルチャに依存しない比較を実行する例については、「[カルチャを認識しない文字列比較の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md)」を参照してください。  
+  
+## CompareOrdinal  
+ <xref:System.String.CompareOrdinal%2A?displayProperty=fullName> メソッドは、ローカル カルチャを考慮せずに 2 つの文字列オブジェクトを比較します。 このメソッドの戻り値は、上の表で示した **Compare** メソッドによって返される値と同じです。  
+  
 > [!IMPORTANT]
-> [String.CompareOrdinal](xref:System.String.CompareOrdinal(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする (つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する) 目的では、[String.CompareOrdinal](xref:System.String.CompareOrdinal(System.String,System.Int32,System.String,System.Int32,System.Int32)) メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、[String.Equals(String, String, StringComparison)](xref:System.String.Equals(System.String,System.String,System.StringComparison)) メソッドを使用してください。
-
-`CompareOrdinal` メソッドを使用して、2 つの文字列の値を比較する例を次に示します。
-
-```csharp
-string string1 = "Hello World!";
-Console.WriteLine(String.CompareOrdinal(string1, "hello world!"));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(String.CompareOrdinal(string1, "hello world!"))
-```
-
-この例は、コンソールに `-32` と出力します。
-
-## <a name="compareto"></a>CompareTo
-
-[String.CompareTo](xref:System.String.CompareTo(System.String)) メソッドは、現在の文字列オブジェクトがカプセル化している文字列を別の文字列またはオブジェクトと比較します。 このメソッドの戻り値は、上の表で示した `String.Compare` メソッドによって返される値と同じです。
-
+>  <xref:System.String.CompareOrdinal%2A?displayProperty=fullName> メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする \(つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する\) 目的では、<xref:System.String.CompareOrdinal%2A?displayProperty=fullName> メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、<xref:System.String.Equals%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> メソッドを使用してください。  
+  
+ **CompareOrdinal** メソッドを使用して、2 つの文字列の値を比較する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#7](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#7)]
+ [!code-csharp[Conceptual.String.BasicOps#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#7)]
+ [!code-vb[Conceptual.String.BasicOps#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#7)]  
+  
+ この例は、コンソールに `-32` と出力します。  
+  
+## CompareTo  
+ <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドは、現在の文字列オブジェクトがカプセル化している文字列を別の文字列またはオブジェクトと比較します。 このメソッドの戻り値は、上の表で示した <xref:System.String.Compare%2A?displayProperty=fullName> メソッドによって返される値と同じです。  
+  
 > [!IMPORTANT]
-> [String.CompareTo](xref:System.String.CompareTo(System.String)) メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする (つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する) 目的では、[String.CompareTo](xref:System.String.CompareTo(System.String)) メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、[String.Equals(String, String, StringComparison)](xref:System.String.Equals(System.String,System.String,System.StringComparison)) メソッドを使用してください。
-
-`String.CompareTo` メソッドを使用して、`string1` オブジェクトを `string2` オブジェクトと比較する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-string string2 = "Hello World!";
-int MyInt = string1.CompareTo(string2);
-Console.WriteLine( MyInt );
-```
-
-```vb
-Dim string1 As String = "Hello World"
-Dim string2 As String = "Hello World!"
-Dim MyInt As Integer = string1.CompareTo(string2)
-Console.WriteLine(MyInt)
-```
-
-この例は、コンソールに `-1` と出力します。
-
-## <a name="equals"></a>次の値に等しい
-
-[String.Equals](xref:System.String.CompareTo(System.String)) メソッドを使用すると、2 つの文字列が等しいかどうかを簡単に確認できます。 このメソッドは大文字と小文字を区別し、`true` または `false` の Boolean 値を返します。 このメソッドは、次の例に示すように、既存のクラスで使用できます。 `Equals` メソッドを使用して、文字列オブジェクトに "Hello World" という語句が含まれているかどうかを確認する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-Console.WriteLine(string1.Equals("Hello World"));
-```
-
-```vb
-Dim string1 As String = "Hello World"
-Console.WriteLine(string1.Equals("Hello World"))
-```
-
-この例は、コンソールに `true` と出力します。
-
-このメソッドは、静的メソッドとしても使用できます。 静的メソッドを使用して、2 つの文字列オブジェクトを比較する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-string string2 = "Hello World";
-Console.WriteLine(String.Equals(string1, string2));
-```
-
-```vb
-Dim string1 As String = "Hello World"
-Dim string2 As String = "Hello World"
-Console.WriteLine(String.Equals(string1, string2))
-```
-
-この例は、コンソールに `true` と出力します。
-
-## <a name="startswith-and-endswith"></a>StartsWith と EndsWith
-
-[String.StartsWith](xref:System.String.StartsWith(System.String)) メソッドを使用すると、文字列オブジェクトが、別の文字列を構成している文字と同じ文字で始まっているかどうかを確認できます。 このメソッドは大文字と小文字を区別し、現在の文字列オブジェクトが、渡された文字列で始まる場合は `true`、それ以外の場合は `false` を返します。 このメソッドを使用して、文字列オブジェクトが "Hello" で始まるかどうかを確認する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-Console.WriteLine(string1.StartsWith("Hello"));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(string1.StartsWith("Hello"))
-```
-
-この例は、コンソールに `true` と出力します。
-
-[String.EndsWith](xref:System.String.CompareTo(System.String)) メソッドは、渡された文字列を現在の文字列オブジェクトの末尾にある文字列と比較します。 このメソッドも Boolean 値を返します。 `EndsWith` メソッドを使用して、文字列の末尾を確認する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-Console.WriteLine(string1.EndsWith("Hello"));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(string1.EndsWith("Hello"))
-```
-
-この例は、コンソールに `false` と出力します。
-
-## <a name="indexof-and-lastindexof"></a>IndexOf と LastIndexOf
-
-[String.IndexOf](xref:System.String.IndexOf(System.Char)) メソッドを使用すると、特定の文字が文字列内で最初に出現する位置を確認できます。 このメソッドは大文字と小文字を区別し、文字列の先頭からカウントを開始し、0 から始まるインデックスを使用して、渡された文字が出現する位置を返します。 指定した文字が見つからない場合は、値 –1 を返します。
-
-`IndexOf` メソッドを使用して、'`l`' という文字が文字列内で最初に出現する位置を検索する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-Console.WriteLine(string1.IndexOf('l'));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(string1.IndexOf("l"))
-```
-
-この例は、コンソールに `2` と出力します。
-
-[String.LastIndexOf](xref:System.String.LastIndexOf(System.Char)) メソッドは `String.IndexOf` メソッドに似ていますが、指定した文字列が文字列内で最後に出現する位置を返すという点が異なります。 このメソッドは大文字と小文字を区別し、0 から始まるインデックスを使用します。 
-
-`LastIndexOf` メソッドを使用して、'`l`' という文字が文字列内で最後に出現する位置を検索する例を次に示します。
-
-```csharp
-string string1 = "Hello World";
-Console.WriteLine(string1.LastIndexOf('l'));
-```
-
-```vb
-Dim string1 As String = "Hello World!"
-Console.WriteLine(string1.LastIndexOf("l"))
-```
-
-この例は、コンソールに `9` と出力します。
-
-いずれのメソッドも、[String.Remove](xref:System.String.Remove(System.Int32)) メソッドと組み合わせて使用すると便利です。 `IndexOf` メソッドまたは `LastIndexOf` メソッドのいずれかを使用して文字の位置を取得し、その位置を `Remove method` メソッドに渡すことによって、その文字またはその文字で始まる単語を削除できます。
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
-
-
-
-
-
-
-
-
-
-
-
-
+>  <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドは、主に文字列の並べ替えに使用するものです。 等価性をテストする \(つまり、ある文字列が別の文字列より大きいか小さいかを問題にせずに戻り値 0 を明示的に検索する\) 目的では、<xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドを使用しないでください。 2 つの文字列が等価かどうかを判断するには、<xref:System.String.Equals%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> メソッドを使用してください。  
+  
+ <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドを使用して、`string1` オブジェクトを `string2` オブジェクトと比較する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#8](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#8)]
+ [!code-csharp[Conceptual.String.BasicOps#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#8)]
+ [!code-vb[Conceptual.String.BasicOps#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#8)]  
+  
+ この例は、コンソールに `-1` と出力します。  
+  
+ <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドのすべてのオーバーロードは、既定で、カルチャに依存して大文字小文字を区別する比較を実行します。 このメソッドのオーバーロードで、カルチャに依存しない比較を実行できるものはありません。 コードを理解しやすくするために、**String.Compare** メソッドを使用することをお勧めします。その際、カルチャに依存する操作には <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> を指定し、カルチャに依存しない操作には <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> を指定します。**String.Compare** メソッドを使用してカルチャに依存する比較とカルチャに依存しない比較の両方を実行する例については、「[カルチャを認識しない文字列比較の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md)」を参照してください。  
+  
+## 次の値に等しい  
+ **String.Equals** メソッドを使用すると、2 つの文字列が等しいかどうかを簡単に確認できます。 このメソッドは大文字と小文字を区別し、**True** または **False** の Boolean 値を返します。 このメソッドは、次の例に示すように、既存のクラスで使用できます。**Equals** メソッドを使用して、文字列オブジェクトに "Hello World" という語句が含まれているかどうかを確認する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#9](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#9)]
+ [!code-csharp[Conceptual.String.BasicOps#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#9)]
+ [!code-vb[Conceptual.String.BasicOps#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#9)]  
+  
+ この例は、コンソールに `True` と出力します。  
+  
+ このメソッドは、静的メソッドとしても使用できます。 静的メソッドを使用して、2 つの文字列オブジェクトを比較する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#10](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#10)]
+ [!code-csharp[Conceptual.String.BasicOps#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#10)]
+ [!code-vb[Conceptual.String.BasicOps#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#10)]  
+  
+ この例は、コンソールに `True` と出力します。  
+  
+## StartsWith と EndsWith  
+ **String.StartsWith** メソッドを使用すると、文字列オブジェクトが、別の文字列を構成している文字と同じ文字で始まっているかどうかを確認できます。 このメソッドは大文字と小文字を区別し、現在の文字列オブジェクトが、渡された文字列で始まる場合は **true**、それ以外の場合は **false** を返します。 このメソッドを使用して、文字列オブジェクトが "Hello" で始まるかどうかを確認する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#11](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#11)]
+ [!code-csharp[Conceptual.String.BasicOps#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#11)]
+ [!code-vb[Conceptual.String.BasicOps#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#11)]  
+  
+ この例は、コンソールに `True` と出力します。  
+  
+ **String.EndsWith** メソッドは、渡された文字列を現在の文字列オブジェクトの末尾にある文字列と比較します。 このメソッドも Boolean 値を返します。**EndsWith** メソッドを使用して、文字列の末尾を確認する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#12](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#12)]
+ [!code-csharp[Conceptual.String.BasicOps#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#12)]
+ [!code-vb[Conceptual.String.BasicOps#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#12)]  
+  
+ この例は、コンソールに `False`  と出力します。  
+  
+## IndexOf と LastIndexOf  
+ **String.IndexOf** メソッドを使用すると、特定の文字が文字列内で最初に出現する位置を確認できます。 このメソッドは大文字と小文字を区別し、文字列の先頭からカウントを開始し、0 から始まるインデックスを使用して、渡された文字が出現する位置を返します。 指定した文字が見つからない場合は、値 –1 を返します。  
+  
+ **IndexOf** メソッドを使用して、'`l`' という文字が文字列内で最初に出現する位置を検索する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#13](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#13)]
+ [!code-csharp[Conceptual.String.BasicOps#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#13)]
+ [!code-vb[Conceptual.String.BasicOps#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#13)]  
+  
+ この例は、コンソールに `2` と出力します。  
+  
+ **String.LastIndexOf** メソッドは **String.IndexOf** メソッドに似ていますが、指定した文字列が文字列内で最後に出現する位置を返すという点が異なります。 このメソッドは大文字と小文字を区別し、0 から始まるインデックスを使用します。  
+  
+ **LastIndexOf** メソッドを使用して、'`l`' という文字が文字列内で最後に出現する位置を検索する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#14](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/compare.cpp#14)]
+ [!code-csharp[Conceptual.String.BasicOps#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/compare.cs#14)]
+ [!code-vb[Conceptual.String.BasicOps#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/compare.vb#14)]  
+  
+ この例は、コンソールに `9` と出力します。  
+  
+ いずれのメソッドも、**String.Remove** メソッドと組み合わせて使用すると便利です。**IndexOf** メソッドまたは **LastIndexOf** メソッドのいずれかを使用して文字の位置を取得し、その位置を **Remove** メソッドに渡すことによって、その文字またはその文字で始まる単語を削除できます。  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md b/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md
new file mode 100644
index 00000000000..303ddabd03f
--- /dev/null
+++ b/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md
@@ -0,0 +1,57 @@
+---
+title: "正規表現におけるコンパイルと再利用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, コンパイル"
+  - ".NET Framework 正規表現, エンジン"
+  - "コンパイル, 正規表現"
+  - "解析 (正規表現を使用したテキストを), コンパイル"
+  - "パターン一致 (正規表現を使用した), コンパイル"
+  - "正規表現, コンパイル"
+  - "正規表現, エンジン"
+  - "検索 (正規表現を使用した), コンパイル"
+ms.assetid: 182ec76d-5a01-4d73-996c-0b0d14fcea18
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 正規表現におけるコンパイルと再利用
+正規表現エンジンが表現をどのようにコンパイルするか、および正規表現がどのようにキャッシュされるかを理解すると、正規表現を多く使用するアプリケーションのパフォーマンスを最適化できます。  このトピックでは、コンパイルとキャッシュの両方について説明します。  
+  
+## コンパイルされた正規表現  
+ 既定では、正規表現エンジンは正規表現をコンパイルして内部命令のシーケンスを生成します。これらは Microsoft Intermediate Language \(MSIL\) とは別の高水準コードです。  エンジンは正規表現を実行するときに、その内部コードを解釈します。  
+  
+ <xref:System.Text.RegularExpressions.Regex> オブジェクトを構築するときに <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用すると、正規表現エンジンは、高水準の正規表現内部命令ではなく、明示的な MSIL コードに正規表現をコンパイルします。  これにより、.NET Framework の JIT \(Just\-In\-Time\) コンパイラは、正規表現をネイティブな機械語コードに変換してパフォーマンスの向上を図ることができます。  
+  
+ ただし、生成された MSIL はアンロードできません。  コードをアンロードする唯一の方法は、アプリケーション ドメイン全体をアンロードする \(つまり、アプリケーションのコードをすべてアンロードする\) ことです。  実際、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して正規表現をコンパイルした場合は、その正規表現を作成した <xref:System.Text.RegularExpressions.Regex> オブジェクト自体がガベージ コレクションで解放されたとしても、コンパイル済みの正規表現によって使用されるリソースを .NET Framework が解放することはありません。  
+  
+ このため、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用してコンパイルする正規表現の数を制限することで、リソースの消費が過度にならないように注意する必要があります。  大量または無制限の正規表現をアプリケーションで使用する必要がある場合、**Options.Compiled** オプションを使用したコンパイルを行わないようにします。  ただし、少数の正規表現を繰り返して使用する場合は、パフォーマンスを向上させるために、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> を使用して正規表現をコンパイルする必要があります。  別の方法として、プリコンパイル済みの正規表現を使用することもできます。  <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A> メソッドを使用すると、再利用できる DLL にすべての表現をコンパイルできます。  これにより、実行時にコンパイルする必要がなくなり、コンパイルされた正規表現の処理速度も維持されます。  
+  
+## 正規表現キャッシュ  
+ パフォーマンスを向上させるために、正規表現エンジンは、コンパイル済みの正規表現のキャッシュをアプリケーション全体で保持します。  このキャッシュには、静的メソッド呼び出しでのみ使用される正規表現パターンが格納されます \(インスタンス メソッドに渡される正規表現パターンはキャッシュされません\)。これにより、正規表現を使用するたびに解析し直して高水準のバイト コードを生成する必要がなくなります。  
+  
+ キャッシュされる正規表現の最大数は、`static` \(Visual Basic では `Shared`\) <xref:System.Text.RegularExpressions.Regex.CacheSize%2A?displayProperty=fullName> プロパティの値で決まります。  既定では、正規表現エンジンは最大で 15 個のコンパイル済み正規表現をキャッシュします。  コンパイル済み正規表現の数がキャッシュ サイズを超えると、最後に使用されてからの時間が最も長い正規表現が破棄され、新しい正規表現がキャッシュされます。  
+  
+> [!IMPORTANT]
+>  .NET Framework Version 2.0 での正規表現のキャッシュ方法は、.NET Framework Version 1.0 および 1.1 とは大きく異なります。  .NET Framework 1.0 および 1.1 では、静的メソッド呼び出しとインスタンス メソッド呼び出しの両方で使用されるすべての正規表現がキャッシュされます。  このキャッシュは、新しい正規表現を格納するために自動的に拡張されます。  .NET Framework 2.0 では、静的メソッド呼び出しで使用された正規表現のみがキャッシュされます。  既定では最新の 15 個の正規表現だけがキャッシュされますが、キャッシュのサイズは <xref:System.Text.RegularExpressions.Regex.CacheSize%2A> プロパティの値を設定することで調整できます。  
+  
+ アプリケーションでは、次の 2 つの方法のいずれかにより、プリコンパイル済みの正規表現を利用できます。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> オブジェクトの静的メソッドを使用して、正規表現を定義します。  別の静的メソッド呼び出しで既に定義されている正規表現パターンを使用する場合、正規表現エンジンはその表現をキャッシュから取得します。  それ以外の場合、エンジンは正規表現をコンパイルしてキャッシュに追加します。  
+  
+-   正規表現パターンが必要な場合に、既存の <xref:System.Text.RegularExpressions.Regex> オブジェクトを再利用します。  
+  
+ オブジェクトのインスタンス化と正規表現のコンパイルによって生じるオーバーヘッドのため、多数の <xref:System.Text.RegularExpressions.Regex> オブジェクトを作成してすぐに破棄するのは効率が良くありません。  多数の異なる正規表現を使用するアプリケーションでは、静的な `Regex` メソッドの呼び出しを使用することと、必要に応じて正規表現キャッシュのサイズを大きくすることで、パフォーマンスを最適化できます。  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/composite-formatting.md b/docs/standard/base-types/composite-formatting.md
new file mode 100644
index 00000000000..0cba2576c83
--- /dev/null
+++ b/docs/standard/base-types/composite-formatting.md
@@ -0,0 +1,170 @@
+---
+title: "複合書式指定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "複合書式設定"
+  - "書式指定子, 複合書式設定"
+  - "オブジェクト [.NET Framework], 書式設定 (複数のオブジェクトの)"
+  - "パラメーター指定子"
+  - "文字列 [.NET Framework], 配置"
+  - "文字列 [.NET Framework], 複合"
+ms.assetid: 87b7d528-73f6-43c6-b71a-f23043039a49
+caps.latest.revision: 36
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# 複合書式指定
+.NET Framework の複合書式指定機能は、オブジェクトのリストおよび複合書式指定文字列を入力として使用します。  複合書式指定文字列は、固定テキストに、書式指定項目と呼ばれるインデックス化されたプレースホルダーが混合されて構成されます。このプレースホルダーはリスト内のオブジェクトに対応します。  書式設定操作によって生成される結果の文字列は、元の固定テキストに文字列で表されたリスト内のオブジェクトが混合されて構成されます。  
+  
+ 複合書式指定機能をサポートするメソッドには、次のようなものがあります。  
+  
+-   <xref:System.String.Format%2A?displayProperty=fullName>。書式設定された結果文字列を返します。  
+  
+-   <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName>。書式設定された結果文字列を <xref:System.Text.StringBuilder> オブジェクトに追加します。  
+  
+-   <xref:System.Console.WriteLine%2A?displayProperty=fullName> メソッドの一部のオーバーロード。書式設定された結果文字列をコンソールに表示します。  
+  
+-   <xref:System.IO.TextWriter.WriteLine%2A?displayProperty=fullName> メソッドの一部のオーバーロード。書式設定された結果文字列をストリームまたはファイルに書き込みます。  <xref:System.IO.TextWriter> から派生したクラス \(<xref:System.IO.StreamWriter>、<xref:System.Web.UI.HtmlTextWriter> など\) も、この機能を共有します。  
+  
+-   [Debug.WriteLine\(String, Object\<xref:System.Diagnostics.Debug.WriteLine%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName>。書式設定されたメッセージをトレース リスナーに出力します。  
+  
+-   [Trace.TraceError\(String, Object\<xref:System.Diagnostics.Trace.TraceError%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName>、[Trace.TraceInformation\(String, Object\<xref:System.Diagnostics.Trace.TraceInformation%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName>、および [Trace.TraceWarning\(String, Object\<xref:System.Diagnostics.Trace.TraceWarning%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッド。書式設定されたメッセージをトレース リスナーに出力します。  
+  
+-   [TraceSource.TraceInformation\(String, Object\<xref:System.Diagnostics.TraceSource.TraceInformation%28System.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッド。情報提供メソッドをトレース リスナーに書き込みます。  
+  
+## 複合書式指定文字列  
+ 複合書式指定文字列とオブジェクト リストは、複合書式指定機能をサポートするメソッドの引数として使用されます。  複合書式指定文字列は、1 つ以上の書式指定項目が混合された 0 個以上の固定テキストで構成されます。  固定テキストはユーザーが任意に選択した文字列で、各書式指定項目はリスト内のオブジェクトまたはボックス化された構造体に対応します。  複合書式指定機能は、各書式指定項目がリスト内の対応するオブジェクトの文字列表現で置換された新しい文字列を返します。  
+  
+ 次の <xref:System.String.Format%2A> コードがあるとします。  
+  
+ [!code-csharp[Formatting.Composite#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Composite1.cs#1)]
+ [!code-vb[Formatting.Composite#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Composite1.vb#1)]  
+  
+ 固定テキストは、"`Name =` " および "`, hours =` " です。  書式指定項目の 1 つは、インデックスが 0 である "`{0}`" であり、オブジェクト  `myName` に対応します。もう 1 つはインデックスが 1 である "`{1:hh}`" であり、オブジェクト  `DateTime.Now` に対応します。  
+  
+## 書式指定項目の構文  
+ 各書式指定項目は、次の形式を使用し、次のコンポーネントで構成されます。  
+  
+ `{` *index*\[`,`*alignment*\]\[`:`*formatString*\]`}`  
+  
+ 対になった中かっこ \("{" と "}"\) が必要です。  
+  
+### Index コンポーネント  
+ 必須の *index* コンポーネントは、パラメーター指定子とも呼ばれ、オブジェクトのリスト内で対応する項目を識別するための 0 から始まる数値です。  つまり、パラメーター指定子が 0 である書式指定項目はリスト内の最初のオブジェクトを書式設定し、パラメーター指定子が 1 である書式指定項目はリスト内の 2 番目のオブジェクトを書式設定します。  次の例には、10 未満の素数を表す 5 つのパラメーター指定子が含まれています。  
+  
+ [!code-csharp[Formatting.Composite#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/index1.cs#7)]
+ [!code-vb[Formatting.Composite#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/index1.vb#7)]  
+  
+ 同じパラメーター指定子を指定することによって、複数の書式指定項目でオブジェクトのリスト内の同じ要素を参照できます。  たとえば、複合書式指定文字列で "0x{0:X} {0:E} {0:N}" のように指定することによって、1 つの数値を 16 進形式、指数形式、および数値形式で書式設定できます。以下に例を示します。  
+  
+ [!code-csharp[Formatting.Composite#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/index1.cs#10)]
+ [!code-vb[Formatting.Composite#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/index1.vb#10)]  
+  
+ 各書式指定項目は、リスト内のどのオブジェクトでも参照できます。  たとえば、3 つのオブジェクトが存在する場合、2 番目、1 番目、3 番目のオブジェクトを書式設定するには、"{1} {0} {2}" のような複合書式指定文字列を指定します。  書式指定項目で参照されないオブジェクトは無視されます。  パラメーター指定子がオブジェクトのリストの範囲外の項目を指定する場合は、ランタイムに <xref:System.FormatException> がスローされます。  
+  
+### Alignment コンポーネント  
+ 省略可能な *alignment* コンポーネントは、書式設定フィールドの幅を指定する符号付き整数です。  *alignment* の値が書式設定する文字列の長さよりも小さい場合、*alignment* は無視され、書式設定する文字列の長さがフィールドの幅として使用されます。  フィールド内の書式設定されたデータは、*alignment* が正の場合は右揃え、*alignment* が負の場合は左揃えされます。  埋め込みが必要な場合は、空白が使用されます。  *alignment* を指定する場合は、コンマが必要です。  
+  
+ 次の例では、2 つの配列を定義します。1 つの配列には従業員の名前が含まれていて、もう 1 つの配列には従業員が 2 週間にわたって作業した時間数が含まれています。  複合書式指定文字列では、名前が 20 文字のフィールドに左揃えに指定され、時間数が 5 文字のフィールドに右揃えに指定されます。  "N1" 標準書式指定文字列も、時間を 1 桁の小数部で書式設定するために使用されることに注意してください。  
+  
+ [!code-csharp[Formatting.Composite#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/alignment1.cs#8)]
+ [!code-vb[Formatting.Composite#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/alignment1.vb#8)]  
+  
+### Format String コンポーネント  
+ オプションの *formatString* コンポーネントは、書式設定されるオブジェクトの種類に適した書式指定文字列です。  対応するオブジェクトが数値の場合は標準またはカスタムの数値書式指定文字列を指定し、対応するオブジェクトが <xref:System.DateTime> オブジェクトの場合は標準またはカスタムの日時書式指定文字列を指定し、対応するオブジェクトが列挙値の場合は[列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)を指定します。  *formatString* が指定されない場合は、数値、日付と時刻、または列挙型の汎用 \("G"\) 書式指定子が使用されます。  *formatString* を指定する場合はコロンが必要です。  
+  
+ 次の表は、定義済みの一連の書式指定文字列をサポートする .NET Framework クラス ライブラリ内の型または型のカテゴリの一覧です。サポートされている書式指定文字列が示されているトピックへのリンクも含まれています。  文字列の書式設定とは拡張可能な機構で、既存のすべての型に対する新しい書式指定文字列を定義できるだけでなく、アプリケーション定義の型でサポートされる一連の書式指定文字列も定義できます。  詳しくは、<xref:System.IFormattable> および <xref:System.ICustomFormatter> のインターフェイスに関するトピックを参照してください。  
+  
+|型または型のカテゴリ|参照トピック|  
+|----------------|------------|  
+|日付と時刻の型 \(<xref:System.DateTime>、<xref:System.DateTimeOffset>\)|[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)<br /><br /> [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)|  
+|列挙型 \(<xref:System.Enum?displayProperty=fullName> から派生したすべての型\)|[列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)|  
+|数値型 \(<xref:System.Numerics.BigInteger>、<xref:System.Byte>、<xref:System.Decimal>、<xref:System.Double>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.SByte>、<xref:System.Single>、<xref:System.UInt16>、<xref:System.UInt32>、<xref:System.UInt64>\)|[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)<br /><br /> [カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)|  
+|<xref:System.Guid>|<xref:System.Guid.ToString%28System.String%29?displayProperty=fullName>|  
+|<xref:System.TimeSpan>|[標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)<br /><br /> [カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)|  
+  
+### エスケープ中かっこ \({}\)  
+ 左中かっこ \({\) および右中かっこ \(}\) は、書式指定項目の開始および終了として解釈されます。  したがって、左中かっこおよび右中かっこを文字として表示するためには、エスケープ シーケンスを使用する必要があります。  左中かっこを 1 つ \("{"\) 表示するには、左中かっこ 2 つ \("{{"\) を固定テキストに指定します。また、右中かっこを 1 つ \("}"\) 表示するには、右中かっこ 2 つ \("}}"\) を指定します。  書式指定項目に使用されている中かっこは、指定されている順序に従って解釈されます。  入れ子になった中かっこを解釈する機能はサポートされていません。  
+  
+ エスケープされた中かっこの解釈によっては、予測しない結果になる場合があります。  たとえば、"{{{0:D}}}" という書式指定項目について考えます。この書式指定項目は、左中かっこ、10 進数として書式設定された数値、および右中かっこを表示することを意図しています。  しかし、この書式指定項目は、実際には、次のように解釈されます。  
+  
+1.  最初の 2 つの左中かっこ \("{{"\) がエスケープされ、左中かっこ 1 つが作成されます。  
+  
+2.  次の 3 文字 \("{0:"\) は、書式指定項目の開始として解釈されます。  
+  
+3.  次の文字 \("D"\) は、Decimal 標準数値書式指定子として解釈できますが、エスケープされた次の 2 つの右中かっこ \("}}"\) からは単一の中かっこが作成されます。  結果として作成される文字列 \("D}"\) は、標準数値書式指定子ではないため、リテラル文字列 "D}" の表示を意味するカスタム書式指定文字列として解釈されます。  
+  
+4.  最後の中かっこ \("}"\) は、書式指定項目の終わりとして解釈されます。  
+  
+5.  最終的には、"{D}" というリテラル文字列が表示されます。  書式設定対象だった数値は、表示されません。  
+  
+ エスケープした中かっこと書式指定項目とが誤って解釈されないコードを記述するためには、中かっこと書式指定項目を別々に書式設定するという方法があります。  つまり、最初の書式設定操作でリテラルの開く中かっこを表示し、次の書式設定操作で書式指定項目の結果を表示し、最後の操作でリテラルの閉じる中かっこを表示します。  このアプローチの例を次に示します。  
+  
+ [!code-csharp[Formatting.Composite#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Escaping1.cs#2)]
+ [!code-vb[Formatting.Composite#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Escaping1.vb#2)]  
+  
+### 処理の順序  
+ 複合書式指定メソッドの呼び出しに、値が <xref:System.IFormatProvider> でない `null` 引数が含まれている場合、ランタイムはその <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> メソッドを呼び出して、<xref:System.ICustomFormatter> 実装を要求します。  このメソッドが <xref:System.ICustomFormatter> 実装を返すことができる場合、実装は後で使用できるようにキャッシュされます。  
+  
+ 書式指定項目に対応するパラメーター リストのそれぞれの値は、次の手順を実行することで文字列に変換されます。  最初の 3 つの手順の条件のいずれかに該当する場合は、その手順で値の文字列形式が返され、後続の手順は実行されません。  
+  
+1.  書式設定する値が `null` の場合は、空の文字列 \(""\) が返されます。  
+  
+2.  <xref:System.ICustomFormatter> 実装が利用できる場合、ランタイムはその <xref:System.ICustomFormatter.Format%2A> メソッドを呼び出します。  メソッドには書式指定項目の *formatString* 値 \(ある場合\) または `null` \(ない場合\) と、<xref:System.IFormatProvider> 実装が渡されます。  
+  
+3.  値が <xref:System.IFormattable> インターフェイスを実装している場合は、インターフェイスの <xref:System.IFormattable.ToString%28System.String%2CSystem.IFormatProvider%29> メソッドが呼び出されます。  メソッドは、*formatString* 値 \(書式指定項目内に値がある場合\) または `null` \(ない場合\) を受け取ります。  <xref:System.IFormatProvider> 引数は、次のように判断されます。  
+  
+    -   数値の場合、null 以外の <xref:System.IFormatProvider> 引数を持つ複合書式指定メソッドが呼び出されると、ランタイムは <xref:System.Globalization.NumberFormatInfo> メソッドから <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> オブジェクトを要求します。  オブジェクトを 1 つも取得できないか、引数の値が `null` であるか、または複合書式指定メソッドに <xref:System.IFormatProvider> パラメーターがない場合は、現在のスレッド カルチャの <xref:System.Globalization.NumberFormatInfo> オブジェクトが使用されます。  
+  
+    -   日付と時刻の値の場合、null 以外の <xref:System.IFormatProvider> 引数を持つ複合書式指定メソッドが呼び出されると、ランタイムは <xref:System.Globalization.DateTimeFormatInfo> メソッドから <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> オブジェクトを要求します。  オブジェクトを 1 つも取得できないか、引数の値が `null` であるか、または複合書式指定メソッドに <xref:System.IFormatProvider> パラメーターがない場合は、現在のスレッド カルチャの <xref:System.Globalization.DateTimeFormatInfo> オブジェクトが使用されます。  
+  
+    -   他の型のオブジェクトの場合、<xref:System.IFormatProvider> 引数を持つ複合書式指定が呼び出されると、その値 \(`null` オブジェクトが指定されない場合の <xref:System.IFormatProvider> を含む\) は <xref:System.IFormattable.ToString%2A?displayProperty=fullName> 実装に直接渡されます。  それ以外の場合は、現在のスレッド カルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトが <xref:System.IFormattable.ToString%2A?displayProperty=fullName> 実装に渡されます。  
+  
+4.  `ToString` をオーバーライドするか、基底クラスの動作を継承する、型のパラメーターなしの <xref:System.Object.ToString?displayProperty=fullName> メソッドが呼び出されます。  この場合、書式指定項目の *formatString* コンポーネントで指定されている書式指定文字列は、存在していても無視されます。  
+  
+ 前の手順が実行された後、アラインメントが適用されます。  
+  
+## コード例  
+ 複合書式指定を使用して文字列を作成する方法と、オブジェクトの `ToString` メソッドを使用して文字列を作成する方法を示すコード例を次に示します。  この 2 つの書式設定方法では、等価の文字列が作成されます。  
+  
+ [!code-csharp[Formatting.Composite#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Composite1.cs#3)]
+ [!code-vb[Formatting.Composite#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Composite1.vb#3)]  
+  
+ 現在の曜日が木曜日であり、月が 5 月であり、現在のカルチャが英語 \(U.S.\) の場合、上記のコード例で作成される 2 つの文字列の値はどちらも `Thursday May` です。  
+  
+ <xref:System.Console.WriteLine%2A?displayProperty=fullName> は、<xref:System.String.Format%2A?displayProperty=fullName> と同じ機能を公開します。  これら 2 つのメソッドの唯一の違いは、<xref:System.String.Format%2A?displayProperty=fullName> が結果を文字列で返すのに対し、<xref:System.Console.WriteLine%2A?displayProperty=fullName> は、<xref:System.Console> オブジェクトに関連付けられた出力ストリームに結果を書き出す点です。  <xref:System.Console.WriteLine%2A?displayProperty=fullName> メソッドを使用して値 `MyInt` を通貨値として書式設定するコード例を次に示します。  
+  
+ [!code-csharp[Formatting.Composite#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Composite1.cs#4)]
+ [!code-vb[Formatting.Composite#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Composite1.vb#4)]  
+  
+ 1 つのオブジェクトを 2 つの方法で書式設定する例を含め、複数のオブジェクトを書式設定する例を次に示します。  
+  
+ [!code-csharp[Formatting.Composite#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Composite1.cs#5)]
+ [!code-vb[Formatting.Composite#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Composite1.vb#5)]  
+  
+ 書式設定でアラインメントを使用する方法を示す例を次に示します。  アラインメント結果を強調表示するため、書式が設定される引数を縦棒 \(&#124;\) で囲んでいます。  
+  
+ [!code-csharp[Formatting.Composite#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Composite/cs/Composite1.cs#6)]
+ [!code-vb[Formatting.Composite#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Composite/vb/Composite1.vb#6)]  
+  
+## 参照  
+ <xref:System.Console.WriteLine%2A>   
+ <xref:System.String.Format%2A?displayProperty=fullName>   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)   
+ [カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)   
+ [標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)   
+ [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)   
+ [標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)   
+ [カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)   
+ [列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/conversion-tables.md b/docs/standard/base-types/conversion-tables.md
index 66c7a52cbed..3a82ff95a43 100644
--- a/docs/standard/base-types/conversion-tables.md
+++ b/docs/standard/base-types/conversion-tables.md
@@ -1,77 +1,80 @@
 ---
-title: "型変換の表"
-description: "型変換の表"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/22/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: d602f260-e7cf-49c8-a37f-731f40e4a538
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: a27f78bc3c0753a7c5bc752bb6391839bfc21e75
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="type-conversion-tables"></a>型変換の表
-
-拡大変換は、1 つの型の値が、サイズが同じかそれ以上の別の型に変換されるときに発生します。 縮小変換は、1 つの型の値が、サイズがより小さい別の型の値に変換されるときに発生します。 このトピックの表は、両方の種類の変換の動作を示しています。
-
-## <a name="widening-conversions"></a>拡大変換
-
-型 | データ損失なしに次の型に変換可能
----- | -------------------------------------
-[Byte](xref:System.Byte) | [UInt16](xref:System.UInt16)、[Int16](xref:System.Int16)、[UInt32](xref:System.UInt32)、[Int32](xref:System.Int32)、[UInt64](xref:System.UInt64)、[Int64](xref:System.Int64)、[Single](xref:System.Single)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[SByte](xref:System.SByte) | [Int16](xref:System.Int16)、[Int32](xref:System.Int32)、[Int64](xref:System.Int64)、[Single](xref:System.Single)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[Int16](xref:System.Int16) | [Int32](xref:System.Int32)、[Int64](xref:System.Int64)、[Single](xref:System.Single)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[UInt16](xref:System.UInt16) | [UInt32](xref:System.UInt32)、[Int32](xref:System.Int32)、[UInt64](xref:System.UInt64)、[Int64](xref:System.Int64)、[Single](xref:System.Single)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[Char](xref:System.Char) | [UInt16](xref:System.UInt16)、[UInt32](xref:System.UInt32)、[Int32](xref:System.Int32)、[UInt64](xref:System.UInt64)、[Int64](xref:System.Int64)、[Single](xref:System.Single)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[Int32](xref:System.Int32) | [Int64](xref:System.Int64)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[UInt32](xref:System.UInt32) | [Int64](xref:System.Int64)、[UInt64](xref:System.UInt64)、[Double](xref:System.Double)、[Decimal](xref:System.Decimal)
-[Int64](xref:System.Int64) | [Decimal](xref:System.Decimal)
-[UInt64](xref:System.UInt64) | [Decimal](xref:System.Decimal)
-[Single](xref:System.Single) | [Double](xref:System.Double)
-
-一部の [Single](xref:System.Single) または [Double](xref:System.Double) への拡大変換では、精度が損なわれる可能性があります。 次の表は、情報が失われる可能性のある拡大変換を示しています。
-
-型 | 次の型に変換可能
----- | -------------------
-[Int32](xref:System.Int32) | [Single](xref:System.Single)
-[UInt32](xref:System.UInt32) | [Single](xref:System.Single)
-[Int64](xref:System.Int64) | [Single](xref:System.Single)、[Double](xref:System.Double)
-[UInt64](xref:System.UInt64) | [Single](xref:System.Single)、[Double](xref:System.Double)
-[Decimal](xref:System.Decimal) | [Single](xref:System.Single)、[Double](xref:System.Double)
-
-## <a name="narrowing-conversions"></a>縮小変換
-
-[Single](xref:System.Single) または [Double](xref:System.Double) への縮小変換では、情報が失われる可能性があります。 ターゲット型がソースの大きさを正確に表現できない場合、結果の型は定数 `PositiveInfinity` または `NegativeInfinity` に設定されます。 `PositiveInfinity` は、正の数を&0; で除算した結果であり、[Single](xref:System.Single) または [Double](xref:System.Double) の値が `MaxValue` フィールドの値を超える場合にも返されます。 `NegativeInfinity` は、負の数を&0; で除算した結果であり、[Single](xref:System.Single) または [Double](xref:System.Double) の値が `MinValue` フィールドの値を下回る場合にも返されます。 [Double](xref:System.Double) から [Single](xref:System.Single) への変換は、`PositiveInfinity` または `NegativeInfinity` になる場合があります。
-
-その他のデータ型についても、縮小変換によって情報が失われる可能性があります。 ただし、変換される型の値が、ターゲット型の `MaxValue` フィールドと `MinValue` フィールドで指定された範囲外にある場合は、[OverflowException](xref:System.OverflowException) がスローされます。また、ターゲット型の値がその `MaxValue` または `MinValue` を超えないことを確認するために、ランタイムによって変換がチェックされます。 [System.Convert](xref:System.Convert) クラスを使用して実行される変換は、常にこの方法でチェックされます。
-
-次の表は、[System.Convert](xref:System.Convert) を使用して [OverflowException](xref:System.OverflowException) をスローする変換、または、変換される型の値が結果の型の定義済みの範囲外にあるかどうかのチェックを行うすべての変換を示しています。
-
-型 | 次の型に変換可能
----- | -------------------
-[Byte](xref:System.Byte) | [SByte](xref:System.SByte)
-[SByte](xref:System.SByte) | [Byte](xref:System.Byte)、[UInt16](xref:System.UInt16)、[UInt32](xref:System.UInt32)、[UInt64](xref:System.UInt64)
-[Int16](xref:System.Int16) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[UInt16](xref:System.UInt16)
-[UInt16](xref:System.UInt16) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)
-[Int32](xref:System.Int32) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[UInt32](xref:System.UInt32)
-[UInt32](xref:System.UInt32) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)
-[Int64](xref:System.Int64) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)、[UInt32](xref:System.UInt32)、[UInt64](xref:System.UInt64)
-[UInt64](xref:System.UInt64) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)、[UInt32](xref:System.UInt32)、[Int64](xref:System.Int64)
-[Decimal](xref:System.Decimal) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)、[UInt32](xref:System.UInt32)、[Int64](xref:System.Int64)、[UInt64](xref:System.UInt64)
-[Single](xref:System.Single) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)、[UInt32](xref:System.UInt32)、[Int64](xref:System.Int64)、[UInt64](xref:System.UInt64)
-[Double](xref:System.Double) | [Byte](xref:System.Byte)、[SByte](xref:System.SByte)、[Int16](xref:System.Int16)、[UInt16](xref:System.UInt16)、[Int32](xref:System.Int32)、[UInt32](xref:System.UInt32)、[Int64](xref:System.Int64)、[UInt64](xref:System.UInt64)
-
-## <a name="see-also"></a>関連項目
-
-[System.Convert](xref:System.Convert)
-
-[型変換](type-conversion.md)
-
-
+title: ".NET Framework における型変換の表 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "拡大変換"
+  - "縮小変換"
+  - "型変換、表"
+  - "変換 (型を)、縮小変換"
+  - "変換 (型を)、拡大変換"
+  - "基本型、変換"
+  - "表 [.NET Framework]、型変換"
+  - "データ型 [.NET Framework]、変換"
+ms.assetid: 0ea65c59-85eb-4a52-94ca-c36d3bd13058
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# .NET Framework における型変換の表
+拡大変換は、ある型の値をそれよりサイズが大きいかまたは等しい別の型に変換するときに実行されます。  縮小変換は、ある型の値をそれよりサイズが小さい別の型の値に変換するときに実行されます。  このトピックの表では、この 2 種類の変換の動作を示します。  
+  
+## 拡大変換  
+ 情報を失わずに実行できる拡大変換について次の表にまとめます。  
+  
+|型|データを失わない変換後の型|  
+|-------|-------------------|  
+|<xref:System.Byte>|<xref:System.UInt16>, <xref:System.Int16>, <xref:System.UInt32>, <xref:System.Int32>, <xref:System.UInt64>, <xref:System.Int64>, <xref:System.Single>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.SByte>|<xref:System.Int16>, <xref:System.Int32>, <xref:System.Int64>, <xref:System.Single>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.Int16>|<xref:System.Int32>, <xref:System.Int64>, <xref:System.Single>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.UInt16>|<xref:System.UInt32>, <xref:System.Int32>, <xref:System.UInt64>, <xref:System.Int64>, <xref:System.Single>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.Char>|<xref:System.UInt16>, <xref:System.UInt32>, <xref:System.Int32>, <xref:System.UInt64>, <xref:System.Int64>, <xref:System.Single>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.Int32>|<xref:System.Int64>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.UInt32>|<xref:System.Int64>, <xref:System.UInt64>, <xref:System.Double>, <xref:System.Decimal>|  
+|<xref:System.Int64>|<xref:System.Decimal>|  
+|<xref:System.UInt64>|<xref:System.Decimal>|  
+|<xref:System.Single>|<xref:System.Double>|  
+  
+ <xref:System.Single> または <xref:System.Double> への拡大変換では、精度が失われることがあります。  情報が失われる可能性のある拡大変換について次の表にまとめます。  
+  
+|型|変換後の型|  
+|-------|-----------|  
+|<xref:System.Int32>|<xref:System.Single>|  
+|<xref:System.UInt32>|<xref:System.Single>|  
+|<xref:System.Int64>|<xref:System.Single>, <xref:System.Double>|  
+|<xref:System.UInt64>|<xref:System.Single>, <xref:System.Double>|  
+|<xref:System.Decimal>|<xref:System.Single>, <xref:System.Double>|  
+  
+## 縮小変換  
+ <xref:System.Single> または <xref:System.Double> への縮小変換では、情報が失われることがあります。  変換先の型が変換元の絶対値を正確に表現できない場合、結果の型は定数 `PositiveInfinity` または `NegativeInfinity` に設定されます。  `PositiveInfinity` の値は、正の数を 0 で除算した結果であり、<xref:System.Single> または <xref:System.Double> の値が `MaxValue` フィールドの値を上回った場合にも返されます。  `NegativeInfinity` の値は、負の数を 0 で除算した結果であり、<xref:System.Single> または <xref:System.Double> の値が `MinValue` フィールドの値を下回った場合にも返されます。  <xref:System.Double> から <xref:System.Single> に変換すると、結果が `PositiveInfinity` または `NegativeInfinity` になります。  
+  
+ ほかのデータ型の縮小変換でも、情報が失われることがあります。  ただし、変換結果の型の値が、変換先の型の `MaxValue` フィールドおよび `MinValue` フィールドで指定されている範囲外になる場合は <xref:System.OverflowException> がスローされ、変換先の型の値が `MaxValue` または `MinValue` を超えないことを保証するためにランタイムによってその変換がチェックされます。  <xref:System.Convert?displayProperty=fullName> クラスを使用して実行される変換は、必ずこの方法でチェックされます。  
+  
+ <xref:System.Convert?displayProperty=fullName> を使用した変換や、チェックを伴うその他の変換で、変換結果の型の値が結果の型で定義されている範囲外の値になる場合に <xref:System.OverflowException> がスローされるケースを次の表にまとめます。  
+  
+|型|変換後の型|  
+|-------|-----------|  
+|<xref:System.Byte>|<xref:System.SByte>|  
+|<xref:System.SByte>|<xref:System.Byte>, <xref:System.UInt16>, <xref:System.UInt32>, <xref:System.UInt64>|  
+|<xref:System.Int16>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.UInt16>|  
+|<xref:System.UInt16>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>|  
+|<xref:System.Int32>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>,<xref:System.UInt32>|  
+|<xref:System.UInt32>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>|  
+|<xref:System.Int64>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>,<xref:System.UInt32>,<xref:System.UInt64>|  
+|<xref:System.UInt64>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>, <xref:System.UInt32>, <xref:System.Int64>|  
+|<xref:System.Decimal>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>, <xref:System.UInt32>, <xref:System.Int64>, <xref:System.UInt64>|  
+|<xref:System.Single>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>, <xref:System.UInt32>, <xref:System.Int64>, <xref:System.UInt64>|  
+|<xref:System.Double>|<xref:System.Byte>, <xref:System.SByte>, <xref:System.Int16>, <xref:System.UInt16>, <xref:System.Int32>, <xref:System.UInt32>, <xref:System.Int64>, <xref:System.UInt64>|  
+  
+## 参照  
+ <xref:System.Convert?displayProperty=fullName>   
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/creating-new.md b/docs/standard/base-types/creating-new.md
index 5efb19faea6..4cd998a79d4 100644
--- a/docs/standard/base-types/creating-new.md
+++ b/docs/standard/base-types/creating-new.md
@@ -1,167 +1,86 @@
 ---
-title: "新しい文字列の作成"
-description: "新しい文字列の作成"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 639397c7-e694-43e0-845b-1681c62bd9fd
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 793b5bc4b26967104459fa2559c6127bb82f3a9d
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="creating-new-strings"></a>新しい文字列の作成
-
-.NET は、単純な割り当てを使用した文字列の作成をサポートしています。また、多数の異なるパラメーターを使用した文字列の作成をサポートするために、クラス コンストラクターをオーバーロードします。 また、.NET は、複数の文字列、文字列の配列、またはオブジェクトを組み合わせて新しい文字列オブジェクトを作成する、[System.String](xref:System.String) クラスの複数のメソッドを提供します。 
-
-## <a name="creating-strings-using-assignment"></a>割り当てを使用した文字列の作成
-
-新しい [String](xref:System.String) オブジェクトを作成する最も簡単な方法としては、単に文字列リテラルを [String](xref:System.String) オブジェクトに割り当てます。 
-
-## <a name="creating-strings-using-a-class-constructor"></a>クラス コンストラクターを使用した文字列の作成
-
-[String](xref:System.String) クラス コンストラクターのオーバーロードを使用すると、文字配列から文字列を作成できます。 また、指定した回数だけ特定の文字を複製することで、新しい文字列を作成することもできます。 
-
-## <a name="methods-that-return-strings"></a>文字列を返すメソッド
-
-次の表は、新しい文字列オブジェクトを返すいくつかの便利なメソッドを示しています。
-
-メソッド名 | 使用
------------ | ---
-[String.Format](xref:System.String.Format(System.String,System.Object)) | 入力オブジェクトのセットから、書式設定された文字列をビルドします。
-[String.Concat](xref:System.String.Concat(System.String,System.String)) | 2 つ以上の文字列から文字列をビルドします。
-[String.Join](xref:System.String.Join(System.String,System.String[])) |文字列の配列を組み合わせることで、新しい文字列をビルドします。
-[String.Insert](xref:System.String.Insert(System.Int32,System.String)) | 既存の文字列の指定のインデックスに文字列を挿入することで、新しい文字列をビルドします。
-[String.CopyTo](xref:System.String.CopyTo(System.Int32,System.Char[],System.Int32,System.Int32)) | 文字配列内の指定の位置に、文字列内の指定の文字をコピーします。
-
-### <a name="format"></a>形式
-
-`String.Format` メソッドを使用すると、書式設定された文字列を作成し、複数のオブジェクトを表す文字列を連結できます。 このメソッドは、渡されたすべてのオブジェクトを文字列に自動的に変換します。 たとえば、アプリケーションでユーザーに対して [Int32](xref:System.Int32) 値と [DateTime](xref:System.DateTime) 値を表示する必要がある場合、`Format` メソッドを使用して、これらの値を表す文字列を簡単に作成できます。 このメソッドで使用される書式設定規則については、[複合書式指定](composite-format.md)に関するセクションを参照してください。
-
-次の例では、`Format` メソッドを使用して、整数型の変数を使用する文字列を作成します。
-
-```csharp
-int numberOfFleas = 12;
-string miscInfo = String.Format("Your dog has {0} fleas. " +
-                                "It is time to get a flea collar. " + 
-                                "The current universal date is: {1:u}.", 
-                                numberOfFleas, DateTime.Now);
-Console.WriteLine(miscInfo);
-// The example displays the following output:
-//       Your dog has 12 fleas. It is time to get a flea collar. 
-//       The current universal date is: 2008-03-28 13:31:40Z.
-```
-
-```vb
-Dim numberOfFleas As Integer = 12
-Dim miscInfo As String = String.Format("Your dog has {0} fleas. " & _
-                                       "It is time to get a flea collar. " & _ 
-                                       "The current universal date is: {1:u}.", _ 
-                                       numberOfFleas, Date.Now)
-Console.WriteLine(miscInfo)
-' The example displays the following output:
-'       Your dog has 12 fleas. It is time to get a flea collar. 
-'       The current universal date is: 2008-03-28 13:31:40Z.
-```
-
-この例では、[DateTime.Now](xref:System.DateTime.Now) は、現在のスレッドに関連付けられているカルチャで指定された方法で現在の日時を表示します。
-
-### <a name="concat"></a>Concat
-
-`String.Concat` メソッドを使用すると、2 つ以上の既存のオブジェクトから新しい文字列オブジェクトを簡単に作成できます。 言語に依存せずに文字列を連結する方法を提供します。 このメソッドは、`System.Object` から派生したすべてのクラスを受け入れます。 次の例では、2 つの既存の文字列オブジェクトおよび区切り文字から文字列を作成します。
-
-```csharp
-string helloString1 = "Hello";
-string helloString2 = "World!";
-Console.WriteLine(String.Concat(helloString1, ' ', helloString2));
-// The example displays the following output:
-//      Hello World!
-```
-
-```vb
-Dim helloString1 As String = "Hello"
-Dim helloString2 As String = "World!"
-Console.WriteLine(String.Concat(helloString1, " "c, helloString2))
-' The example displays the following output:
-'      Hello World!
-```
-
-### <a name="join"></a>Join
-
-`String.Join` メソッドは、文字列の配列および区切り文字列から新しい文字列を作成します。 このメソッドは、複数の文字列を連結して、たとえばコンマで区切られたリストを作成する場合に便利です。
-
-次の例では、スペースを使用して文字列の配列をバインドします。
-
-```csharp
-string[] words = {"Hello", "and", "welcome", "to", "my" , "world!"};
-Console.WriteLine(String.Join(" ", words));
-// The example displays the following output:
-//      Hello and welcome to my world!
-```
-
-```vb
-Dim words() As String = {"Hello", "and", "welcome", "to", "my" , "world!"}
-Console.WriteLine(String.Join(" ", words))
-' The example displays the following output:
-'      Hello and welcome to my world!
-```
-
-### <a name="insert"></a>挿入
-
-`String.Insert` メソッドは、別の文字列内の指定の位置に文字列を挿入することで、新しい文字列を作成します。 このメソッドは、0 から始まるインデックスを使用します。 次の例では、`MyString` の&5; 番目のインデックス位置に文字列を挿入し、この値を持つ新しい文字列を作成します。
-
-```csharp
-string sentence = "Once a time.";   
- Console.WriteLine(sentence.Insert(4, " upon"));
- // The example displays the following output:
- //      Once upon a time.
-```
-
-```vb
-Dim sentence As String = "Once a time."   
- Console.WriteLine(sentence.Insert(4, " upon"))
- ' The example displays the 
-```
-
-### <a name="copyto"></a>CopyTo
-
-`String.CopyTo` メソッドは、文字配列に文字列の部分をコピーします。 文字列の開始インデックスと、コピーする文字数の両方を指定できます。 このメソッドは、ソース インデックス、文字配列、コピー先のインデックス、およびコピーする文字数を受け取ります。 すべてのインデックスは&0; から始まります。
-
-次の例では、`CopyTo` メソッドを使用して、文字列オブジェクトから文字配列の最初のインデックス位置に、単語 "Hello" の文字をコピーします。
-
-```csharp
-string greeting = "Hello World!";
-char[] charArray = {'W','h','e','r','e'};
-Console.WriteLine("The original character array: {0}", new string(charArray));
-greeting.CopyTo(0, charArray,0 ,5);
-Console.WriteLine("The new character array: {0}", new string(charArray));
-// The example displays the following output:
-//       The original character array: Where
-//       The new character array: Hello
-```
-
-```vb
-Dim greeting As String = "Hello World!"
-Dim charArray() As Char = {"W"c, "h"c, "e"c, "r"c, "e"c}
-Console.WriteLine("The original character array: {0}", New String(charArray))
-greeting.CopyTo(0, charArray,0 ,5)
-Console.WriteLine("The new character array: {0}", New String(charArray))
-' The example displays the following output:
-'       The original character array: Where
-'       The new character array: Hello
-```
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
-[複合書式指定](composite-format.md)
-
-
+title: ".NET Framework における新しい文字列の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Concat メソッド"
+  - "CopyTo メソッド"
+  - "Format メソッド"
+  - "Insert メソッド"
+  - "Join メソッド"
+  - "文字列 [.NET Framework], 作成"
+ms.assetid: 06fdf123-2fac-4459-8904-eb48ab908a30
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# .NET Framework における新しい文字列の作成
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、簡単な代入を使用して文字列を作成できます。また、コンストラクターをオーバーロードして、多数のパラメーターを使用した文字列の作成をサポートすることもできます。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] にも、文字列、文字列配列、またはオブジェクトを結合して新しい文字列オブジェクトを作成するメソッドが <xref:System.String?displayProperty=fullName> クラスに用意されています。  
+  
+## 代入を使用した文字列の作成  
+ 新しい <xref:System.String> オブジェクトを作成する最も簡単な方法は、単純にリテラル文字列を <xref:System.String> オブジェクトに割り当てることです。  
+  
+## クラス コンストラクターを使用した文字列の作成  
+ <xref:System.String> クラス コンストラクターのオーバーロードを使用して、文字の配列から文字列を作成できます。  また、特定の文字を指定された数だけ複製して、新しい文字列を作成することもできます。  
+  
+## 文字列を返すメソッド  
+ 新しい文字列オブジェクトを返す、便利なメソッドの一覧を次の表に示します。  
+  
+|メソッド名|使用方法|  
+|-----------|----------|  
+|<xref:System.String.Format%2A?displayProperty=fullName>|一連の入力オブジェクトから、書式設定された文字列を作成します。|  
+|<xref:System.String.Concat%2A?displayProperty=fullName>|2 つ以上の文字列を連結して文字列を作成します。|  
+|<xref:System.String.Join%2A?displayProperty=fullName>|文字列の配列を結合して新しい文字列を作成します。|  
+|<xref:System.String.Insert%2A?displayProperty=fullName>|既存の文字列内の指定したインデックス位置に文字列を挿入して、新しい文字列を作成します。|  
+|<xref:System.String.CopyTo%2A?displayProperty=fullName>|文字の配列内の指定した位置に、文字列内の指定した文字をコピーします。|  
+  
+### 書式  
+ **String.Format** メソッドを使用すると、書式指定された文字列を作成し、複数のオブジェクトを表す文字列を連結できます。  このメソッドは、渡された任意のオブジェクトを文字列に自動変換します。  たとえば、アプリケーションでユーザーに対して **Int32** 値と **DateTime** 値を表示する必要がある場合、これらの値を表す文字列を **Format** メソッドを使用して簡単に作成できます。  このメソッドで使用される書式指定規則の詳細については、[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)に関するセクションを参照してください。  
+  
+ **Format** メソッドを使用して、整数変数を使用する文字列を作成する例を次に示します。  
+  
+ [!code-csharp[Strings.Creating#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.Creating/cs/Example.cs#1)]
+ [!code-vb[Strings.Creating#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.Creating/vb/Example.vb#1)]  
+  
+ この例では、<xref:System.DateTime.Now%2A?displayProperty=fullName> は現在のスレッドに関連付けられているカルチャで指定される形式で現在の日時を表示します。  
+  
+### Concat  
+ **String.Concat** メソッドを使用すると、2 つ以上の既存のオブジェクトを連結して新しい文字列オブジェクトを簡単に作成できます。  このメソッドは、言語に依存することなく文字列を連結します。  このメソッドは、**System.Object** クラスから派生したすべてのクラスを受け入れます。  既存の 2 つの文字列オブジェクトおよび区切り文字から文字列を作成する例を次に示します。  
+  
+ [!code-csharp[Strings.Creating#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.Creating/cs/Example.cs#2)]
+ [!code-vb[Strings.Creating#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.Creating/vb/Example.vb#2)]  
+  
+### Join  
+ **String.Join** メソッドは、文字列の配列と区切り文字から新しい文字列を作成します。  このメソッドは、複数の文字列をコンマなどで区切って連結したリストを作成する場合に便利です。  
+  
+ 文字列の配列を空白で区切って連結する例を次に示します。  
+  
+ [!code-csharp[Strings.Creating#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.Creating/cs/Example.cs#3)]
+ [!code-vb[Strings.Creating#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.Creating/vb/Example.vb#3)]  
+  
+### 挿入  
+ **String.Insert** メソッドは、ある文字列を別の文字列内の指定した位置に挿入することによって新しい文字列を作成します。  このメソッドでは、0 から始まるインデックスが使用されます。  文字列を `MyString` 内の 5 番目のインデックス位置に挿入し、挿入した値を含む新しい文字列を作成する例を次に示します。  
+  
+ [!code-csharp[Strings.Creating#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.Creating/cs/Example.cs#4)]
+ [!code-vb[Strings.Creating#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.Creating/vb/Example.vb#4)]  
+  
+### CopyTo  
+ **String.CopyTo** メソッドは、文字列の一部を文字配列にコピーします。  文字列のコピー開始位置を示すインデックスと、コピーする文字数の両方を指定できます。  このメソッドには、コピー元のインデックス、文字の配列、コピー先のインデックス、およびコピーする文字数を渡します。  すべてのインデックスは 0 から始まります。  
+  
+ **CopyTo** メソッドを使用して、文字列オブジェクトに含まれる単語 "Hello" を構成する文字を文字配列の 1 番目のインデックス位置にコピーする例を次に示します。  
+  
+ [!code-csharp[Strings.Creating#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Strings.Creating/cs/Example.cs#5)]
+ [!code-vb[Strings.Creating#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Strings.Creating/vb/Example.vb#5)]  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)   
+ [複合書式指定](../../../docs/standard/base-types/composite-formatting.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/custom-date-and-time-format-strings.md b/docs/standard/base-types/custom-date-and-time-format-strings.md
new file mode 100644
index 00000000000..60846e42081
--- /dev/null
+++ b/docs/standard/base-types/custom-date-and-time-format-strings.md
@@ -0,0 +1,667 @@
+---
+title: "カスタム日時書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタムの日付と時刻の書式指定文字列"
+  - "カスタムの DateTime の書式指定文字列"
+  - "書式指定子, カスタムの日付と時刻"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 日付"
+  - "書式指定 [.NET Framework], 時間"
+ms.assetid: 98b374e3-0cc2-4c78-ab44-efb671d71984
+caps.latest.revision: 79
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 77
+---
+# カスタム日時書式指定文字列
+日時書式指定文字列は、<xref:System.DateTime> 値または <xref:System.DateTimeOffset> 値の書式設定操作によって生成されるテキスト表現を定義します。 また、文字列を日時に正常に変換するために解析操作で必要となる日時値の表現も定義します。 カスタム書式指定文字列は、1 つ以上のカスタム日時書式指定子で構成されます。[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)以外の文字列は、すべてカスタム日時書式指定文字列として解釈されます。  
+  
+ カスタム日時書式指定文字列は、<xref:System.DateTime> 値で使用することも、<xref:System.DateTimeOffset> 値で使用することもできます。  
+  
+> [!TIP]
+>  [書式設定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)をダウンロードできます。このアプリケーションを使用すると、書式指定文字列を日付と時刻の値または数値に適用して、結果の文字列を表示できます。  
+  
+<a name="table"></a> 書式設定操作では、日時インスタンスの `ToString` メソッドまたは複合書式指定をサポートするメソッドで、カスタム日時書式指定文字列を使用できます。 両方の使用例を次に示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#17](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/custandformatting1.cs#17)]
+ [!code-vb[Formatting.DateAndTime.Custom#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/custandformatting1.vb#17)]  
+  
+ 解析操作では、<xref:System.DateTime.ParseExact%2A?displayProperty=fullName>、<xref:System.DateTime.TryParseExact%2A?displayProperty=fullName>、<xref:System.DateTimeOffset.ParseExact%2A?displayProperty=fullName>、および <xref:System.DateTimeOffset.TryParseExact%2A?displayProperty=fullName> の各メソッドで、カスタム日時書式指定文字列を使用できます。 これらのメソッドでは、解析操作が成功するための特定のパターンに入力文字列が完全に一致している必要があります。 日付に日、月、2 桁の年が含まれているかどうかを解析する <xref:System.DateTimeOffset.ParseExact%28System.String%2CSystem.String%2CSystem.IFormatProvider%29?displayProperty=fullName> メソッドを呼び出す例を次に示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#18](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/custandparsing1.cs#18)]
+ [!code-vb[Formatting.DateAndTime.Custom#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/custandparsing1.vb#18)]  
+  
+ 次の表に、カスタム日時書式指定子の説明および書式指定子ごとの書式設定後の文字列を示します。 既定では、結果の文字列は、en\-US カルチャの書式指定規則を反映します。 特定の書式指定子でローカライズされた文字列が書式設定後に生成される場合、例には書式設定後の文字列が適用されるカルチャも示されます。 カスタム日時書式指定文字列の使用方法については、「メモ」を参照してください。  
+  
+|書式指定子|説明|例|  
+|-----------|--------|-------|  
+|"d"|月の日にち \(1 ～ 31\)。<br /><br /> 詳細については、「["d" カスタム書式指定子](#dSpecifier)」を参照してください。|2009\-06\-01T13:45:30 \-\> 1<br /><br /> 2009\-06\-15T13:45:30 \-\> 15|  
+|"dd"|月の日にち \(01 ～ 31\)。<br /><br /> 詳細については、「["dd" カスタム書式指定子](#ddSpecifier)」を参照してください。|2009\-06\-01T13:45:30 \-\> 01<br /><br /> 2009\-06\-15T13:45:30 \-\> 15|  
+|"ddd"|曜日の省略名。<br /><br /> 詳細については、「["ddd" カスタム書式指定子](#dddSpecifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> Mon \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Пн \(ru\-RU\)<br /><br /> 2009\-06\-15T13:45:30 \-\> lun. \(fr\-FR\)|  
+|"dddd"|曜日の完全名。<br /><br /> 詳細については、「["dddd" カスタム書式指定子](#ddddSpecifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> Monday \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> понедельник \(ru\-RU\)<br /><br /> 2009\-06\-15T13:45:30 \-\> lundi \(fr\-FR\)|  
+|"f"|日時値の秒部分の 1\/10。<br /><br /> 詳細については、「["f" カスタム書式指定子](#fSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> 6<br /><br /> 2009\-06\-15T13:45:30.05 \-\> 0|  
+|"ff"|日時値の秒部分の 1\/100。<br /><br /> 詳細については、「["ff" カスタム書式指定子](#ffSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> 61<br /><br /> 2009\-06\-15T13:45:30.0050000 \-\> 00|  
+|"fff"|日時値の秒部分の 1\/1000。<br /><br /> 詳細については、「["fff" カスタム書式指定子](#fffSpecifier)」を参照してください。|6\/15\/2009 13:45:30.617 \-\> 617<br /><br /> 6\/15\/2009 13:45:30.0005 \-\> 000|  
+|"ffff"|日時値の秒部分の 1\/10000。<br /><br /> 詳細については、「["ffff" カスタム書式指定子](#ffffSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6175000 \-\> 6175<br /><br /> 2009\-06\-15T13:45:30.0000500  \-\> 0000|  
+|"fffff"|日時値の秒部分の 1\/100000。<br /><br /> 詳細については、「["fffff" カスタム書式指定子](#fffffSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6175400 \-\> 61754<br /><br /> 6\/15\/2009 13:45:30.000005 \-\> 00000|  
+|"ffffff"|日時値の秒部分の 1\/1000000。<br /><br /> 詳細については、「["ffffff" カスタム書式指定子](#ffffffSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6175420 \-\> 617542<br /><br /> 2009\-06\-15T13:45:30.0000005 \-\> 000000|  
+|"fffffff"|日時値の秒部分の 1\/10000000。<br /><br /> 詳細については、「["fffffff" カスタム書式指定子](#fffffffSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6175425 \-\> 6175425<br /><br /> 2009\-06\-15T13:45:30.0001150 \-\> 0001150|  
+|"F"|日時値の秒部分の 1\/10 \(0 以外の場合\)。<br /><br /> 詳細については、「["F" カスタム書式指定子](#F_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> 6<br /><br /> 2009\-06\-15T13:45:30.0500000 \-\> \(no output\)|  
+|"FF"|日時値の秒部分の 1\/100 \(0 以外の場合\)。<br /><br /> 詳細については、「["FF" カスタム書式指定子](#FF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> 61<br /><br /> 2009\-06\-15T13:45:30.0050000 \-\> \(no output\)|  
+|"FFF"|日時値の秒部分の 1\/1000 \(0 以外の場合\)。<br /><br /> 詳細については、「["FFF" カスタム書式指定子](#FFF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> 617<br /><br /> 2009\-06\-15T13:45:30.0005000 \-\> \(no output\)|  
+|"FFFF"|日時値の秒部分の 1\/10000 \(0 以外の場合\)。<br /><br /> 詳細については、「["FFFF" カスタム書式指定子](#FFFF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.5275000 \-\> 5275<br /><br /> 2009\-06\-15T13:45:30.0000500 \-\> \(no output\)|  
+|"FFFFF"|日時値の秒部分の 1\/100000 \(0 以外の場合\)。<br /><br /> 詳細については、「["FFFFF" カスタム書式指定子](#FFFFF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6175400 \-\> 61754<br /><br /> 2009\-06\-15T13:45:30.0000050 \-\> \(no output\)|  
+|"FFFFFF"|日時値の秒部分の 1\/1000000 \(0 以外の場合\)。<br /><br /> 詳細については、「["FFFFFF" カスタム書式指定子](#FFFFFF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6175420 \-\> 617542<br /><br /> 2009\-06\-15T13:45:30.0000005 \-\> \(no output\)|  
+|"FFFFFFF"|日時値の秒部分の 1\/10000000 \(0 以外の場合\)。<br /><br /> 詳細については、「["FFFFFFF" カスタム書式指定子](#FFFFFFF_Specifier)」を参照してください。|2009\-06\-15T13:45:30.6175425 \-\> 6175425<br /><br /> 2009\-06\-15T13:45:30.0001150 \-\> 000115|  
+|"g"、"gg"|時期または時代 \(年号\)。<br /><br /> 詳細については、「["g" または "gg" カスタム書式指定子](#gSpecifier)」を参照してください。|2009\-06\-15T13:45:30.6170000 \-\> A.D.|  
+|"h"|12 時間形式の時間 \(1 ～ 12\)。<br /><br /> 詳細については、「["h" カスタム書式指定子](#hSpecifier)」を参照してください。|2009\-06\-15T01:45:30 \-\> 1<br /><br /> 2009\-06\-15T13:45:30 \-\> 1|  
+|"hh"|12 時間形式の時間 \(01 ～ 12\)。<br /><br /> 詳細については、「["hh" カスタム書式指定子](#hhSpecifier)」を参照してください。|2009\-06\-15T01:45:30 \-\> 01<br /><br /> 2009\-06\-15T13:45:30 \-\> 01|  
+|"H"|24 時間形式の時間 \(0 ～ 23\)。<br /><br /> 詳細については、「["H" カスタム書式指定子](#H_Specifier)」を参照してください。|2009\-06\-15T01:45:30 \-\> 1<br /><br /> 2009\-06\-15T13:45:30 \-\> 13|  
+|"HH"|24 時間形式の時間 \(00 ～ 23\)。<br /><br /> 詳細については、「["HH" カスタム書式指定子](#HH_Specifier)」を参照してください。|2009\-06\-15T01:45:30 \-\> 01<br /><br /> 2009\-06\-15T13:45:30 \-\> 13|  
+|"K"|タイム ゾーン情報。<br /><br /> 詳細については、「["K" カスタム書式指定子](#KSpecifier)」を参照してください。|<xref:System.DateTime> 値の場合:<br /><br /> 2009\-06\-15T13:45:30, Kind Unspecified \-\><br /><br /> 2009\-06\-15T13:45:30, Kind Utc \-\> Z<br /><br /> 2009\-06\-15T13:45:30, Kind Local \-\> \-07:00 \(depends on local computer settings\)<br /><br /> <xref:System.DateTimeOffset> 値の場合:<br /><br /> 2009\-06\-15T01:45:30\-07:00 \-\-\> \-07:00<br /><br /> 2009\-06\-15T08:45:30\+00:00 \-\-\> \+00:00|  
+|"m"|分 \(0 ～ 59\)。<br /><br /> 詳細については、「["m" カスタム書式指定子](#mSpecifier)」を参照してください。|2009\-06\-15T01:09:30 \-\> 9<br /><br /> 2009\-06\-15T13:29:30 \-\> 29|  
+|"mm"|分 \(00 ～ 59\)。<br /><br /> 詳細については、「["mm" カスタム書式指定子](#mmSpecifier)」を参照してください。|2009\-06\-15T01:09:30 \-\> 09<br /><br /> 2009\-06\-15T01:45:30 \-\> 45|  
+|"M"|月 \(1 ～ 12\)。<br /><br /> 詳細については、「["M" カスタム書式指定子](#M_Specifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> 6|  
+|"MM"|月 \(01 ～ 12\)。<br /><br /> 詳細については、「["MM" カスタム書式指定子](#MM_Specifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> 06|  
+|"MMM"|月の省略名。<br /><br /> 詳細については、「["MMM" カスタム書式指定子](#MMM_Specifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> Jun \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> juin \(fr\-FR\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Jun \(zu\-ZA\)|  
+|"MMMM"|月の完全名。<br /><br /> 詳細については、「["MMMM" カスタム書式指定子](#MMMM_Specifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> June \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> juni \(da\-DK\)<br /><br /> 2009\-06\-15T13:45:30 \-\> uJuni \(zu\-ZA\)|  
+|"s"|秒 \(0 ～ 59\)。<br /><br /> 詳細については、「["s" カスタム書式指定子](#sSpecifier)」を参照してください。|2009\-06\-15T13:45:09 \-\> 9|  
+|"ss"|秒 \(00 ～ 59\)。<br /><br /> 詳細については、「["ss" カスタム書式指定子](#ssSpecifier)」を参照してください。|2009\-06\-15T13:45:09 \-\> 09|  
+|"t"|AM\/PM 指定子の最初の文字。<br /><br /> 詳細については、「["t" カスタム書式指定子](#tSpecifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> P \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 午 \(ja\-JP\)<br /><br /> 2009\-06\-15T13:45:30 \-\>  \(fr\-FR\)|  
+|"tt"|AM\/PM 指定子。<br /><br /> 詳細については、「["tt" カスタム書式指定子](#ttSpecifier)」を参照してください。|2009\-06\-15T13:45:30 \-\> PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 午後 \(ja\-JP\)<br /><br /> 2009\-06\-15T13:45:30 \-\>  \(fr\-FR\)|  
+|"y"|年 \(0 ～ 99\)。<br /><br /> 詳細については、「["y" カスタム書式指定子](#ySpecifier)」を参照してください。|0001\-01\-01T00:00:00 \-\> 1<br /><br /> 0900\-01\-01T00:00:00 \-\> 0<br /><br /> 1900\-01\-01T00:00:00 \-\> 0<br /><br /> 2009\-06\-15T13:45:30 \-\> 9<br /><br /> 2019\-06\-15T13:45:30 \-\> 19|  
+|"yy"|年 \(00 ～ 99\)。<br /><br /> 詳細については、「["yy" カスタム書式指定子](#yySpecifier)」を参照してください。|0001\-01\-01T00:00:00 \-\> 01<br /><br /> 0900\-01\-01T00:00:00 \-\> 00<br /><br /> 1900\-01\-01T00:00:00 \-\> 00<br /><br /> 2019\-06\-15T13:45:30 \-\> 19|  
+|"yyy"|年 \(3 桁以上\)。<br /><br /> 詳細については、「["yyy" カスタム書式指定子](#yyySpecifier)」を参照してください。|0001\-01\-01T00:00:00 \-\> 001<br /><br /> 0900\-01\-01T00:00:00 \-\> 900<br /><br /> 1900\-01\-01T00:00:00 \-\> 1900<br /><br /> 2009\-06\-15T13:45:30 \-\> 2009|  
+|"yyyy"|年 \(4 桁の数値\)。<br /><br /> 詳細については、「["yyyy" カスタム書式指定子](#yyyySpecifier)」を参照してください。|0001\-01\-01T00:00:00 \-\> 0001<br /><br /> 0900\-01\-01T00:00:00 \-\> 0900<br /><br /> 1900\-01\-01T00:00:00 \-\> 1900<br /><br /> 2009\-06\-15T13:45:30 \-\> 2009|  
+|"yyyyy"|年 \(5 桁の数値\)。<br /><br /> 詳細については、「["yyyyy" カスタム書式指定子](#yyyyySpecifier)」を参照してください。|0001\-01\-01T00:00:00 \-\> 00001<br /><br /> 2009\-06\-15T13:45:30 \-\> 02009|  
+|"z"|UTC を基準とする時間単位のオフセット \(先行ゼロなし\)。<br /><br /> 詳細については、「["z" カスタム書式指定子](#zSpecifier)」を参照してください。|2009\-06\-15T13:45:30\-07:00 \-\> \-7|  
+|"zz"|UTC を基準とする時間単位のオフセット \(先行ゼロ付きの 1 桁の値\)。<br /><br /> 詳細については、「["zz" カスタム書式指定子](#zzSpecifier)」を参照してください。|2009\-06\-15T13:45:30\-07:00 \-\> \-07|  
+|"zzz"|UTC を基準とする時間および分単位のオフセット。<br /><br /> 詳細については、「["zzz" カスタム書式指定子](#zzzSpecifier)」を参照してください。|2009\-06\-15T13:45:30\-07:00 \-\> \-07:00|  
+|":"|時刻の区切り記号。<br /><br /> 詳細については、「[":" カスタム書式指定子](#timeSeparator)」を参照してください。|2009\-06\-15T13:45:30 \-\> : \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> . \(it\-IT\)<br /><br /> 2009\-06\-15T13:45:30 \-\> : \(ja\-JP\)|  
+|"\/"|日付の区切り記号。<br /><br /> 詳細については、「["\/" カスタム書式指定子](#dateSeparator)」を参照してください。|2009\-06\-15T13:45:30 \-\> \/ \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> \- \(ar\-DZ\)<br /><br /> 2009\-06\-15T13:45:30 \-\> . \(tr\-TR\)|  
+|"*文字列*"<br /><br /> '*文字列*'|リテラル文字列の区切り記号。|2009\-06\-15T13:45:30 \("arr:" h:m t\) \-\> arr: 1:45 P<br /><br /> 2009\-06\-15T13:45:30 \('arr:' h:m t\) \-\> arr: 1:45 P|  
+|%|後続の文字をカスタム書式指定子として定義します。<br /><br /> 詳細については、「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。|2009\-06\-15T13:45:30 \(%h\) \-\> 1|  
+|\\|エスケープ文字。|2009\-06\-15T13:45:30 \(h \\h\) \-\> 1 h|  
+|その他の文字|文字が結果の文字列にそのままコピーされます。<br /><br /> 詳細については、「[エスケープ文字の使用](#escape)」を参照してください。|2009\-06\-15T01:45:30 \(arr hh:mm t\) \-\> arr 01:45 A|  
+  
+ 以降では、それぞれのカスタム日時書式指定子について詳しく説明します。 特に明記されない限り、各指定子は、<xref:System.DateTime> 値で使用しても、<xref:System.DateTimeOffset> 値で使用してもまったく同じ文字列形式を生成します。  
+  
+<a name="dSpecifier"></a>   
+## "d" カスタム書式指定子  
+ "d" カスタム書式指定子は、月の日にちを 1 ～ 31 の数値として表します。 1 桁の日にちは、先行ゼロなしで書式設定されます。  
+  
+ "d" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"d" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、複数の書式指定文字列の中に "d" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#1)]
+ [!code-vb[Formatting.DateAndTime.Custom#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#1)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ddSpecifier"></a>   
+## "dd" カスタム書式指定子  
+ "dd" カスタム書式指定文字列は、月の日にちを 01 ～ 31 の数値として表します。 1 桁の日にちは、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "dd" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#2)]
+ [!code-vb[Formatting.DateAndTime.Custom#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#2)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="dddSpecifier"></a>   
+## "ddd" カスタム書式指定子  
+ "ddd" カスタム書式指定子は、曜日の省略名を表します。 曜日のローカライズされた省略名は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.AbbreviatedDayNames%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "ddd" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#3)]
+ [!code-vb[Formatting.DateAndTime.Custom#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#3)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ddddSpecifier"></a>   
+## "dddd" カスタム書式指定子  
+ "dddd" カスタム書式指定子 \(任意の数の "d" 指定子を追加可能\) は、曜日の完全名を表します。 曜日のローカライズされた名前は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.DayNames%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "dddd" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#4)]
+ [!code-vb[Formatting.DateAndTime.Custom#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#4)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="fSpecifier"></a>   
+## "f" カスタム書式指定子  
+ "f" カスタム書式指定子は、秒の端数の最上位桁 \(つまり、日時値の秒部分の 1\/10\) を表します。  
+  
+ "f" 書式指定子が単独で使用され、その他の書式指定子がない場合、"f" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ <xref:System.DateTime.ParseExact%2A>、<xref:System.DateTime.TryParseExact%2A>、<xref:System.DateTimeOffset.ParseExact%2A>、<xref:System.DateTimeOffset.TryParseExact%2A> のいずれかのメソッドに渡す書式指定文字列の一部として "f" 書式指定子を使用する場合、"f" 書式指定子の数は、文字列を正しく解析するために、秒の端数の最上位桁数が何桁存在している必要があるかを表します。  
+  
+ 次の例では、カスタム書式指定文字列の中に "f" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ffSpecifier"></a>   
+## "ff" カスタム書式指定子  
+ "ff" カスタム書式指定子は、秒の端数の最上位 2 桁 \(つまり、日時値の秒部分の 1\/100\) を表します。  
+  
+ 次の例では、カスタム書式指定文字列の中に "ff" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="fffSpecifier"></a>   
+## "fff" カスタム書式指定子  
+ "fff" カスタム書式指定子は、秒の端数の最上位 3 桁 \(つまり、日時値の秒部分の 1\/1000\) を表します。  
+  
+ 次の例では、カスタム書式指定文字列の中に "fff" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ffffSpecifier"></a>   
+## "ffff" カスタム書式指定子  
+ "ffff" カスタム書式指定子は、秒の端数の最上位 4 桁 \(つまり、日時値の秒部分の 1\/10000\) を表します。  
+  
+ 時刻値の 1\/10000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT Version 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="fffffSpecifier"></a>   
+## "fffff" カスタム書式指定子  
+ "fffff" カスタム書式指定子は、秒の端数の最上位 5 桁 \(つまり、日時値の秒部分の 1\/100000\) を表します。  
+  
+ 時刻値の 1\/100000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="ffffffSpecifier"></a>   
+## "ffffff" カスタム書式指定子  
+ "ffffff" カスタム書式指定子は、秒の端数の最上位 6 桁 \(つまり、日時値の秒部分の 1\/1000000\) を表します。  
+  
+ 時刻値の 1\/1000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="fffffffSpecifier"></a>   
+## "fffffff" カスタム書式指定子  
+ "fffffff" カスタム書式指定子は、秒の端数の最上位 7 桁 \(つまり、日時値の秒部分の 1\/10000000\) を表します。  
+  
+ 時刻値の 1\/10000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="F_Specifier"></a>   
+## "F" カスタム書式指定子  
+ "F" カスタム書式指定子は、秒の端数の最上位桁 \(つまり、日時値の秒部分の 1\/10\) を表します。 その桁がゼロの場合には、何も表示されません。  
+  
+ "F" 書式指定子が単独で使用され、その他の書式指定子がない場合、"F" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ <xref:System.DateTime.ParseExact%2A>、<xref:System.DateTime.TryParseExact%2A>、<xref:System.DateTimeOffset.ParseExact%2A>、<xref:System.DateTimeOffset.TryParseExact%2A> のいずれかのメソッドの引数として使用された場合、"F" 書式指定子の数は、文字列を正しく解析するために、秒の端数の最上位桁数が最大何桁存在している必要があるかを表します。  
+  
+ 次の例では、カスタム書式指定文字列の中に "F" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FF_Specifier"></a>   
+## "FF" カスタム書式指定子  
+ "FF" カスタム書式指定子は、秒の端数の最上位 2 桁 \(つまり、日時値の秒部分の 1\/100\) を表します。 ただし、後続のゼロは表示されません。また、2 桁のゼロも表示されません。  
+  
+ 次の例では、カスタム書式指定文字列の中に "FF" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFF_Specifier"></a>   
+## "FFF" カスタム書式指定子  
+ "FFF" カスタム書式指定子は、秒の端数の最上位 3 桁 \(つまり、日時値の秒部分の 1\/1000\) を表します。 ただし、後続のゼロは表示されません。また、3 桁のゼロも表示されません。  
+  
+ 次の例では、カスタム書式指定文字列の中に "FFF" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFFF_Specifier"></a>   
+## "FFFF" カスタム書式指定子  
+ "FFFF" カスタム書式指定子は、秒の端数の最上位 4 桁 \(つまり、日時値の秒部分の 1\/10000\) を表します。 ただし、後続のゼロは表示されません。また、4 桁のゼロも表示されません。  
+  
+ 時刻値の 1\/10000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFFFF_Specifier"></a>   
+## "FFFFF" カスタム書式指定子  
+ "FFFFF" カスタム書式指定子は、秒の端数の最上位 5 桁 \(つまり、日時値の秒部分の 1\/100000\) を表します。 ただし、後続のゼロは表示されません。また、5 桁のゼロも表示されません。  
+  
+ 時刻値の 1\/100000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFFFFF_Specifier"></a>   
+## "FFFFFF" カスタム書式指定子  
+ "FFFFFF" カスタム書式指定子は、秒の端数の最上位 6 桁 \(つまり、日時値の秒部分の 1\/1000000\) を表します。 ただし、後続のゼロは表示されません。また、6 桁のゼロも表示されません。  
+  
+ 時刻値の 1\/1000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFFFFFF_Specifier"></a>   
+## "FFFFFFF" カスタム書式指定子  
+ "FFFFFFF" カスタム書式指定子は、秒の端数の最上位 7 桁 \(つまり、日時値の秒部分の 1\/10000000\) を表します。 ただし、後続のゼロは表示されません。また、7 桁のゼロも表示されません。  
+  
+ 時刻値の 1\/10000000 秒要素を表示することもできますが、このような値は意味を持たない場合があります。 日付および時刻の値の精度は、システム クロックの分解能に依存します。 Windows NT 3.5 \(およびそれ以降\) および Windows Vista オペレーティング システムでは、システム時計の解像力は約 10 ～ 15 ミリ秒です。  
+  
+ [表のトップへ](#table)  
+  
+<a name="gSpecifier"></a>   
+## "g" または "gg" カスタム書式指定子  
+ "g" または "gg" カスタム書式指定子 \(任意の数の "g" 指定子を追加可能\) は、A.D. などの時期または時代 \(年号\) を表します。書式設定される日付に時期または時代 \(年号\) の文字列が関連付けられていない場合、この指定子は無視されます。  
+  
+ "g" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"g" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "g" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#6)]
+ [!code-vb[Formatting.DateAndTime.Custom#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#6)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="hSpecifier"></a>   
+## "h" カスタム書式指定子  
+ "h" カスタム書式指定子は、時間を 1 ～ 12 の数値として表します。つまり、午前 0 時と午後 0 時から時間をカウントする 12 時間制で時間が表されます。 午前 0 時からの特定の時間を、午後 0 時からの同じ時間と区別できません。 時間は丸められず、1 桁の時間は先行ゼロなしで書式設定されます。 たとえば、午前と午後の 5:43 という時間は、このカスタム書式指定子によって "5" と表示されます。  
+  
+ "h" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"h" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "h" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#7)]
+ [!code-vb[Formatting.DateAndTime.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="hhSpecifier"></a>   
+## "hh" カスタム書式指定子  
+ "hh" カスタム書式指定子 \(任意の数の "h" 指定子を追加可能\) は、時間を 1 ～ 12 の数値として表します。つまり、午前 0 時と午後 0 時から時間をカウントする 12 時間制で時間が表されます。 午前 0 時からの特定の時間を、午後 0 時からの同じ時間と区別できません。 時間は丸められず、1 桁の時間は先行ゼロ付きで書式設定されます。 たとえば、午前と午後の 5:43 という時間は、この書式指定子によって "05" と表示されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "hh" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#8)]
+ [!code-vb[Formatting.DateAndTime.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#8)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="H_Specifier"></a>   
+## "H" カスタム書式指定子  
+ "H" カスタム書式指定子は、時間を 0 ～ 23 の数値として表します。つまり、午前 0 時から時間をカウントする 24 時間制で時間が表されます。 1 桁の時間は、先行ゼロなしで書式設定されます。  
+  
+ "H" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"H" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "H" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#9](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#9)]
+ [!code-vb[Formatting.DateAndTime.Custom#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#9)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="HH_Specifier"></a>   
+## "HH" カスタム書式指定子  
+ "HH" カスタム書式指定子 \(任意の数の "H" 指定子を追加可能\) は、時間を 00 ～ 23 の数値として表します。つまり、午前 0 時から時間をカウントする 24 時間制で時間が表されます。 1 桁の時間は、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "HH" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#10)]
+ [!code-vb[Formatting.DateAndTime.Custom#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#10)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="KSpecifier"></a>   
+## "K" カスタム書式指定子  
+ "K" カスタム書式指定子は、日付と時刻の値のタイム ゾーン情報を表します。 この書式指定子を <xref:System.DateTime> 値で使用した場合、書式設定後の文字列は、<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティの値によって定義されます。  
+  
+-   ローカル タイム ゾーンの場合 \(<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティ値 \= <xref:System.DateTimeKind?displayProperty=fullName>\)、この指定子は "zzz" 指定子に相当し、書式設定後の文字列には世界協定時刻 \(UTC: Coordinated Universal Time\) からのローカル オフセットが含まれます \("\-07:00" など\)。  
+  
+-   UTC 時刻の場合 \(<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティ値 \= <xref:System.DateTimeKind?displayProperty=fullName>\)、書式設定後の文字列には UTC 日付を表す "Z" 文字が含まれます。  
+  
+-   タイム ゾーンが指定されていない時刻の場合 \(<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティ \= <xref:System.DateTimeKind?displayProperty=fullName>\)、<xref:System.String.Empty?displayProperty=fullName> と同じ結果になります。  
+  
+ "K" 書式指定子を <xref:System.DateTimeOffset> 値で使用した場合、この指定子は "zz" 書式指定子に相当し、書式設定後の文字列には <xref:System.DateTimeOffset> 値の UTC を基準としたオフセットが含まれます。  
+  
+ "K" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"K" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、米国太平洋標準時タイム ゾーンのシステムで、"K" カスタム書式指定子と各種の <xref:System.DateTime> 値および <xref:System.DateTimeOffset> 値を組み合わせた結果の文字列を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#12](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#12)]
+ [!code-vb[Formatting.DateAndTime.Custom#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#12)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="mSpecifier"></a>   
+## "m" カスタム書式指定子  
+ "m" カスタム書式指定子は、分を 0 ～ 59 の数値として表します。 この分は、直前の時間から経過した分数です。 1 桁の分は、先行ゼロなしで書式設定されます。  
+  
+ "m" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"m" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "m" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#7)]
+ [!code-vb[Formatting.DateAndTime.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="mmSpecifier"></a>   
+## "mm" カスタム書式指定子  
+ "mm" カスタム書式指定子 \(任意の数の "m" 指定子を追加可能\) は、分を 00 ～ 59 の数値として表します。 この分は、直前の時間から経過した分数です。 1 桁の分は、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "mm" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#8)]
+ [!code-vb[Formatting.DateAndTime.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#8)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="M_Specifier"></a>   
+## "M" カスタム書式指定子  
+ "M" カスタム書式指定子は、月を 1 ～ 12 \(13 の月がある暦の場合は 1 ～ 13\) の数値として表します。 1 桁の月は、先行ゼロなしで書式設定されます。  
+  
+ "M" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"M" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "M" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#11](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#11)]
+ [!code-vb[Formatting.DateAndTime.Custom#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#11)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="MM_Specifier"></a>   
+## "MM" カスタム書式指定子  
+ "MM" カスタム書式指定子は、月を 01 ～ 12 \(13 の月がある暦の場合は 1 ～ 13\) の数値として表します。 1 桁の月は、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "MM" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#2)]
+ [!code-vb[Formatting.DateAndTime.Custom#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#2)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="MMM_Specifier"></a>   
+## "MMM" カスタム書式指定子  
+ "MMM" カスタム書式指定子は、月の省略名を表します。 月のローカライズされた省略名は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.AbbreviatedMonthNames%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "MMM" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#3)]
+ [!code-vb[Formatting.DateAndTime.Custom#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#3)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="MMMM_Specifier"></a>   
+## "MMMM" カスタム書式指定子  
+ "MMMM" カスタム書式指定子は、月の完全名を表します。 月のローカライズされた名前は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "MMMM" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#4)]
+ [!code-vb[Formatting.DateAndTime.Custom#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#4)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="sSpecifier"></a>   
+## "s" カスタム書式指定子  
+ "s" カスタム書式指定子は、秒を 0 ～ 59 の数値として表します。 この秒は、直前の分から経過した秒数です。 1 桁の秒は、先行ゼロなしで書式設定されます。  
+  
+ "s" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"s" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "s" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#7)]
+ [!code-vb[Formatting.DateAndTime.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ssSpecifier"></a>   
+## "ss" カスタム書式指定子  
+ "ss" カスタム書式指定子 \(任意の数の "s" 指定子を追加可能\) は、秒を 00 ～ 59 の数値として表します。 この秒は、直前の分から経過した秒数です。 1 桁の秒は、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "ss" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#8)]
+ [!code-vb[Formatting.DateAndTime.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#8)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="tSpecifier"></a>   
+## "t" カスタム書式指定子  
+ "t" カスタム書式指定子は、AM\/PM 指定子の最初の文字を表します。 ローカライズされた適切な指定子は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A?displayProperty=fullName> プロパティまたは <xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A?displayProperty=fullName> プロパティから取得されます。 AM 指定子は、0:00:00 \(午前 0 時\) から 11:59:59.999 までのすべての時刻に使用されます。 PM 指定子は、12:00:00 \(正午\) から 23:59:59.999 までのすべての時刻に使用されます。  
+  
+ "t" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"t" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "t" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#7)]
+ [!code-vb[Formatting.DateAndTime.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ttSpecifier"></a>   
+## "tt" カスタム書式指定子  
+ "tt" カスタム書式指定子 \(任意の数の "t" 指定子を追加可能\) は、AM\/PM 指定子全体を表します。 ローカライズされた適切な指定子は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A?displayProperty=fullName> プロパティまたは <xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A?displayProperty=fullName> プロパティから取得されます。 AM 指定子は、0:00:00 \(午前 0 時\) から 11:59:59.999 までのすべての時刻に使用されます。 PM 指定子は、12:00:00 \(正午\) から 23:59:59.999 までのすべての時刻に使用されます。  
+  
+ AM と PM を区別する必要のある言語の場合、必ず "tt" 指定子を使用する必要があります。 たとえば、日本語の場合、AM\/PM 指定子の 2 番目の文字は異なりますが、先頭文字は同じです。  
+  
+ 次の例では、カスタム書式指定文字列の中に "tt" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#8)]
+ [!code-vb[Formatting.DateAndTime.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#8)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ySpecifier"></a>   
+## "y" カスタム書式指定子  
+ "y" カスタム書式指定子は、年を 1 桁または 2 桁の数値として表します。 年が 2 桁を超える場合は、下 2 桁のみが結果に表示されます。 2 桁の年の 1 桁目がゼロで始まる場合 \(2008 など\)、先行ゼロが省略されます。  
+  
+ "y" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"y" は標準の日時書式指定子として解釈されます。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "y" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="yySpecifier"></a>   
+## "yy" カスタム書式指定子  
+ "yy" カスタム書式指定子は、年を 2 桁の数値として表します。 年が 2 桁を超える場合は、下 2 桁のみが結果に表示されます。 年が 2 桁に満たない場合は、2 桁になるまで数値が先行ゼロで埋められます。  
+  
+ 解析操作では、"yy" カスタム形式指定子を使用した 2 桁の年は、書式プロバイダーの現在のカレンダーの <xref:System.Globalization.Calendar.TwoDigitYearMax%2A?displayProperty=fullName> プロパティに基づいて解釈されます。 次の例は、このケースでは現在のカルチャである en\-US カルチャの既定のグレゴリオ暦を使用して、2 桁の年を持つ日付の文字列形式を解析します。 次に、<xref:System.Globalization.CultureInfo> プロパティが変更された <xref:System.Globalization.GregorianCalendar> オブジェクトが使用されるように、現在のカルチャの <xref:System.Globalization.GregorianCalendar.TwoDigitYearMax%2A> オブジェクトを変更します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#19](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/parseexact2digityear1.cs#19)]
+ [!code-vb[Formatting.DateAndTime.Custom#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/parseexact2digityear1.vb#19)]  
+  
+ 次の例では、カスタム書式指定文字列の中に "yy" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="yyySpecifier"></a>   
+## "yyy" カスタム書式指定子  
+ "yyy" カスタム書式指定子は、年を 3 桁以上で表します。 年が 3 桁を超える場合は、それらの数字も結果に含まれます。 年が 3 桁に満たない場合は、3 桁になるまで数値が先行ゼロで埋められます。  
+  
+> [!NOTE]
+>  年が 5 桁になることがあるタイ仏暦については、この書式指定子ですべての有効桁が表示されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "yyy" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="yyyySpecifier"></a>   
+## "yyyy" カスタム書式指定子  
+ "yyyy" カスタム書式指定子は、年を 4 桁以上で表します。 年が 4 桁を超える場合は、それらの数字も結果に含まれます。 年が 4 桁に満たない場合は、4 桁になるまで数値が先行ゼロで埋められます。  
+  
+> [!NOTE]
+>  年が 5 桁になることがあるタイ仏暦については、この書式指定子で 4 桁以上が表示されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "yyyy" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="yyyyySpecifier"></a>   
+## "yyyyy" カスタム書式指定子  
+ "yyyyy" カスタム書式指定子 \(任意の数の "y" 指定子を追加可能\) は、年を 5 桁以上で表します。 年が 5 桁を超える場合は、それらの数字も結果に含まれます。 年が 5 桁に満たない場合は、5 桁になるまで数値が先行ゼロで埋められます。  
+  
+ "y" 指定子を追加すると、"y" 指定子の数と同じ桁数になるまで数値が先行ゼロで埋められます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "yyyyy" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="zSpecifier"></a>   
+## "z" カスタム書式指定子  
+ <xref:System.DateTime> 値で使用した場合、"z" カスタム書式指定子は、オペレーティング システムのローカル タイム ゾーンの、世界協定時刻 \(UTC\) を基準とした符号付きオフセット \(時間単位\) を表します。 インスタンスの <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティの値は反映されません。 そのため、<xref:System.DateTime> 値に対して "z" 書式指定子を使用することはお勧めできません。  
+  
+ <xref:System.DateTimeOffset> 値で使用した場合、この書式指定子は、<xref:System.DateTimeOffset> 値の、UTC を基準とするオフセット \(時間単位\) を表します。  
+  
+ このオフセットは、常に先頭の符号と共に表示されます。 正符号 \(\+\) は UTC より時間が進んでいることを示し、負符号 \(\-\) は UTC より時間が遅れていることを示します。 1 桁のオフセットは、先行ゼロなしで書式設定されます。  
+  
+ "z" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"z" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ 次の例では、カスタム書式指定文字列の中に "z" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#14](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#14)]
+ [!code-vb[Formatting.DateAndTime.Custom#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#14)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="zzSpecifier"></a>   
+## "zz" カスタム書式指定子  
+ <xref:System.DateTime> 値で使用した場合、"zz" カスタム書式指定子は、オペレーティング システムのローカル タイム ゾーンの、UTC を基準とした符号付きオフセット \(時間単位\) を表します。 インスタンスの <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティの値は反映されません。 そのため、<xref:System.DateTime> 値に対して "zz" 書式指定子を使用することはお勧めできません。  
+  
+ <xref:System.DateTimeOffset> 値で使用した場合、この書式指定子は、<xref:System.DateTimeOffset> 値の、UTC を基準とするオフセット \(時間単位\) を表します。  
+  
+ このオフセットは、常に先頭の符号と共に表示されます。 正符号 \(\+\) は UTC より時間が進んでいることを示し、負符号 \(\-\) は UTC より時間が遅れていることを示します。 1 桁のオフセットは、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "zz" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#14](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#14)]
+ [!code-vb[Formatting.DateAndTime.Custom#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#14)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="zzzSpecifier"></a>   
+## "zzz" カスタム書式指定子  
+ <xref:System.DateTime> 値で使用した場合、"zzz" カスタム書式指定子は、オペレーティング システムのローカル タイム ゾーンの、UTC を基準とした符号付きオフセット \(時間および分単位\) を表します。 インスタンスの <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティの値は反映されません。 そのため、<xref:System.DateTime> 値に対して "zzz" 書式指定子を使用することはお勧めできません。  
+  
+ <xref:System.DateTimeOffset> 値で使用した場合、この書式指定子は、<xref:System.DateTimeOffset> 値の、UTC を基準とするオフセット \(時間および分単位\) を表します。  
+  
+ このオフセットは、常に先頭の符号と共に表示されます。 正符号 \(\+\) は UTC より時間が進んでいることを示し、負符号 \(\-\) は UTC より時間が遅れていることを示します。 1 桁のオフセットは、先行ゼロ付きで書式設定されます。  
+  
+ 次の例では、カスタム書式指定文字列の中に "zzz" カスタム書式指定子が含まれます。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#14](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/Custom1.cs#14)]
+ [!code-vb[Formatting.DateAndTime.Custom#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/Custom1.vb#14)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="timeSeparator"></a>   
+## ":" カスタム書式指定子  
+ ":" カスタム書式指定子は、時、分、および秒を区別するための時刻の区切り記号を表します。 ローカライズされた適切な時刻の区切り記号は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+> [!NOTE]
+>  特定の日付と時刻の文字列について時刻の区切り記号を変更するには、リテラル文字列の区切り記号内に区切り記号を指定します。 たとえば、カスタム書式指定文字列 `hh'_'dd'_'ss` は、常に時刻の区切り記号として "\_" \(アンダースコア\) が使用される結果文字列を生成します。 カルチャのすべての日付について時刻の区切り記号を変更するには、現在のカルチャの <xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A?displayProperty=fullName> プロパティ値を変更するか、<xref:System.Globalization.DateTimeFormatInfo> オブジェクトのインスタンスを作成し、その <xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A> プロパティに文字を割り当てて、<xref:System.IFormatProvider> パラメーターを含む書式設定メソッドのオーバーロードを呼び出します。  
+  
+ ":" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、":" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ [表のトップへ](#table)  
+  
+<a name="dateSeparator"></a>   
+## "\/" カスタム書式指定子  
+ "\/" カスタム書式指定子は、年、月、および日を区別するための日付の区切り記号を表します。 ローカライズされた適切な日付の区切り記号は、現在のカルチャまたは特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A?displayProperty=fullName> プロパティから取得されます。  
+  
+> [!NOTE]
+>  特定の日付と時刻の文字列について日付の区切り記号を変更するには、リテラル文字列の区切り記号内に区切り記号を指定します。 たとえば、カスタム書式指定文字列 `mm'/'dd'/'yyyy` は、常に日付の区切り記号として "\/" が使用される結果文字列を生成します。 カルチャのすべての日付について日付の区切り記号を変更するには、現在のカルチャの <xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A?displayProperty=fullName> プロパティ値を変更するか、<xref:System.Globalization.DateTimeFormatInfo> オブジェクトのインスタンスを作成し、その <xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A> プロパティに文字を割り当てて、<xref:System.IFormatProvider> パラメーターを含む書式設定メソッドのオーバーロードを呼び出します。  
+  
+ "\/" 書式指定子が単独で使用され、その他のカスタム書式指定子がない場合、"\/" は標準の日時書式指定子として解釈され、<xref:System.FormatException> をスローします。 単一の書式指定子を使用する方法の詳細については、このトピックで後述する「[単一のカスタム書式指定子の使用](#UsingSingleSpecifiers)」を参照してください。  
+  
+ [表のトップへ](#table)  
+  
+<a name="Notes"></a>   
+## ノート  
+  
+<a name="UsingSingleSpecifiers"></a>   
+### 単一のカスタム書式指定子の使用  
+ カスタム日時書式指定文字列は、複数の文字で構成されます。 日時書式指定メソッドでは、1 文字の文字列が標準の日時書式指定文字列として解釈されます。 文字が有効な書式指定子として認識されない場合は <xref:System.FormatException> がスローされます。 たとえば、"h" 指定子のみで構成される書式指定文字列は、標準の日時書式指定文字列として解釈されます。 ただし、この場合では、"h"``という標準の日時書式指定子が存在しないため、例外がスローされます。  
+  
+ カスタム日時書式指定子のいずれかを書式指定文字列内の唯一の指定子として使用するには \(つまり、"d"、"f"、"F"、"g"、"h"、"H"、"K"、"m"、"M"、"s"、"t"、"y"、"z"、":"、"\/" のいずれかのカスタム書式指定子を単体で使用するには\)、指定子の前または後に空白を挿入するか、または単一のカスタム日時指定子の前にパーセント \("%"\) 書式指定子を挿入します。  
+  
+ たとえば、"`%h"` は、現在の日時値が表す時要素を表示するカスタム日時書式指定文字列として解釈されます。 また、" h" または "h " の各書式指定文字列も使用できますが、書式設定後の文字列に時間と共に空白が挿入されます。 これらの 3 つの書式指定文字列の例を次に示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#16](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/literal1.cs#16)]
+ [!code-vb[Formatting.DateAndTime.Custom#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/literal1.vb#16)]  
+  
+<a name="escape"></a>   
+### エスケープ文字の使用  
+ 書式指定文字列内の "d"、"f"、"F"、"g"、"h"、"H"、"K"、"m"、"M"、"s"、"t"、"y"、"z"、":"、"\/" の各文字は、リテラル文字ではなくカスタム書式指定子として解釈されます。 文字が書式指定子として解釈されないようにするには、その文字の前に、エスケープ文字の円記号 \(\\\) を付けます。 エスケープ文字は、その後に続く文字が、そのまま結果の文字列に含める必要がある文字リテラルであることを示します。  
+  
+ 結果の文字列に円記号を含める場合は、円記号をもう 1 つ付加して、円記号自体をエスケープする必要があります \(`\\`\)。  
+  
+> [!NOTE]
+>  C\+\+ コンパイラや C\# コンパイラなど、一部のコンパイラでは、同様に、1 つの円記号がエスケープ文字として解釈されることがあります。 書式設定時に文字列が正しく解釈されるようにするには、C\# では、逐語的文字列リテラル文字 \(@ 文字\) を文字列の前に使用します。また、C\# および C\+\+ では、円記号の前にもう 1 つ円記号を付ける方法もあります。 両方の方法を次の C\# の例に示します。  
+  
+ 次の例では、エスケープ文字を使用して、書式設定操作で "h" と "m" の各文字が書式指定子として解釈されないようにします。  
+  
+ [!code-csharp[Formatting.DateAndTime.Custom#15](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Custom/cs/escape1.cs#15)]
+ [!code-vb[Formatting.DateAndTime.Custom#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Custom/vb/escape1.vb#15)]  
+  
+### コントロール パネルの設定  
+ コントロール パネルの **\[地域と言語のオプション\]** の設定は、各種のカスタム日時書式指定子を使った書式設定操作によって生成される結果の文字列に影響します。 これらの設定は、書式設定の制御に使用される値を提供する現在のスレッド カルチャに関連付けられた <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを初期化するために使用されます。 コンピューターで使用する設定が異なる場合は、生成される文字列も異なります。  
+  
+ また、<xref:System.Globalization.CultureInfo.%23ctor%28System.String%29?displayProperty=fullName> コンストラクターを使用して、現在のシステム カルチャと同じカルチャを表す新しい <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化した場合、コントロール パネルの **\[地域と言語のオプション\]** 項目で設定されたカスタマイズが新しい <xref:System.Globalization.CultureInfo> オブジェクトに適用されます。<xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを使用すると、システムに対するカスタマイズが反映されない <xref:System.Globalization.CultureInfo> オブジェクトを作成できます。  
+  
+### DateTimeFormatInfo のプロパティ  
+ 書式設定は、現在の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティの影響を受けます。このオブジェクトは、現在のスレッド カルチャによって暗黙的に指定されるか、または書式設定を実行するメソッドの <xref:System.IFormatProvider> パラメーターによって明示的に指定されます。<xref:System.IFormatProvider> パラメーターには、カルチャを表す <xref:System.Globalization.CultureInfo> オブジェクト、または <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを指定します。  
+  
+ 各種のカスタム日時書式指定子によって生成される書式設定後の文字列も、現在の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティに依存します。 カスタム日時書式指定子によって生成される結果は、対応する <xref:System.Globalization.DateTimeFormatInfo> プロパティを変更することによって変えることができます。 たとえば、"ddd" 書式指定子を使用した場合、書式設定後の文字列には、<xref:System.Globalization.DateTimeFormatInfo.AbbreviatedDayNames%2A> 文字列配列に指定されている曜日の省略名が追加されます。 同様に、"MMMM" 書式指定子を使用した場合、書式設定後の文字列には、<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A> 文字列配列に指定されている月の正式名が追加されます。  
+  
+## 参照  
+ <xref:System.DateTime?displayProperty=fullName>   
+ <xref:System.IFormatProvider?displayProperty=fullName>   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)   
+ [サンプル: .NET Framework 4 の書式設定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)
\ No newline at end of file
diff --git a/docs/standard/base-types/custom-numeric-format-strings.md b/docs/standard/base-types/custom-numeric-format-strings.md
new file mode 100644
index 00000000000..6a522b8a87e
--- /dev/null
+++ b/docs/standard/base-types/custom-numeric-format-strings.md
@@ -0,0 +1,236 @@
+---
+title: "カスタム数値書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム数値書式指定文字列"
+  - "書式指定子, カスタム数値書式指定文字列"
+  - "書式指定子, 数値"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 数"
+  - "書式指定 (数値の) [.NET Framework]"
+  - "数値 [.NET Framework], 書式指定"
+  - "数値書式指定文字列 [.NET Framework]"
+ms.assetid: 6f74fd32-6c6b-48ed-8241-3c2b86dea5f4
+caps.latest.revision: 54
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 54
+---
+# カスタム数値書式指定文字列
+1 つ以上のカスタム数値指定子で構成されるカスタム数値書式指定文字列を作成して、数値データの書式設定方法を定義できます。 カスタム数値書式指定文字列は、[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)ではない任意の書式指定文字列です。  
+  
+ カスタム数値書式指定文字列は、すべての数値型の `ToString` メソッドの一部のオーバーロードでサポートされています。 たとえば、<xref:System.Int32.ToString%28System.String%29> 型の <xref:System.Int32.ToString%28System.String%2CSystem.IFormatProvider%29> メソッドおよび <xref:System.Int32> メソッドに数値書式指定文字列を指定できます。 カスタム数値書式指定文字列は、.NET Framework の[複合書式指定機能](../../../docs/standard/base-types/composite-formatting.md)でもサポートされています。この機能を使用するメソッドには、`Write` クラスおよび `WriteLine` クラスの一部の <xref:System.Console> メソッドと <xref:System.IO.StreamWriter> メソッド、<xref:System.String.Format%2A?displayProperty=fullName> メソッド、および <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName> メソッドがあります。  
+  
+> [!TIP]
+>  [書式指定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)をダウンロードできます。このアプリケーションを使用すると、書式指定文字列を数値または日付と時刻の値に適用して、結果の文字列を表示できます。  
+  
+<a name="table"></a> 次の表に、カスタム数値書式指定子の説明および書式指定子ごとのサンプル出力を示します。 カスタム数値書式指定文字列の使用方法については、「[メモ](#NotesCustomFormatting)」を参照してください。それらを使用する包括的な例については、「[例](#example)」を参照してください。  
+  
+|書式指定子|名前|説明|例|  
+|-----------|--------|--------|-------|  
+|"0"|ゼロ プレースホルダー|対応する数字でゼロを置き換えます。置き換えが行われるのは、対応する数字が存在する場合です。それ以外の場合は、結果の文字列にはゼロが表示されます。<br /><br /> 詳細については、「["0" カスタム指定子](#Specifier0)」を参照してください。|1234.5678 \("00000"\) \-\> 01235<br /><br /> 0.45678 \("0.00", en\-US\) \-\> 0.46<br /><br /> 0.45678 \("0.00", fr\-FR\) \-\> 0,46|  
+|"\#"|桁プレースホルダー|対応する数字で "\#" 記号を置き換えます。置き換えが行われるのは、対応する数字が存在する場合です。それ以外の場合は、結果の文字列に数字は表示されません。<br /><br /> 入力文字列の対応する数字が意味を持たない 0 の場合、結果の文字列に数字は表示されません。 たとえば、0003 \("\#\#\#\#"\) \-\> 3 です。<br /><br /> 詳細については、「["\#" カスタム指定子](#SpecifierD)」を参照してください。|1234.5678 \("\#\#\#\#\#"\) \-\> 1235<br /><br /> 0.45678 \("\#.\#\#", en\-US\) \-\> .46<br /><br /> 0.45678 \("\#.\#\#", fr\-FR\) \-\> ,46|  
+|"."|小数点|結果の文字列の小数点位置を決定します。<br /><br /> 詳細については、「["."カスタム指定子](#SpecifierPt)」を参照してください。|0.45678 \("0.00", en\-US\) \-\> 0.46<br /><br /> 0.45678 \("0.00", fr\-FR\) \-\> 0,46|  
+|","|桁区切り記号および数値の位取り|桁区切り記号および数値位取り指定子の両方として機能します。 桁区切り記号としては、各グループの間に、ローカライズされた桁区切り記号文字を挿入します。 数値位取り指定子としては、指定されたコンマごとに、数値を 1000 で除算します。<br /><br /> 詳細については、「["," カスタム指定子](#SpecifierTh)」を参照してください。|桁区切り記号:<br /><br /> 2147483647 \("\#\#,\#", en\-US\) \-\> 2,147,483,647<br /><br /> 2147483647 \("\#\#,\#", es\-ES\) \-\> 2.147.483.647<br /><br /> 位取り指定子:<br /><br /> 2147483647 \("\#,\#,,", en\-US\) \-\> 2,147<br /><br /> 2147483647 \("\#,\#,,", es\-ES\) \-\> 2.147|  
+|"%"|パーセント プレースホルダー|数値に 100 を乗算し、結果の文字列に、ローカライズされたパーセント記号を挿入します。<br /><br /> 詳細については、「["%" カスタム指定子](#SpecifierPct)」を参照してください。|0.3697 \("%\#0.00", en\-US\) \-\> %36.97<br /><br /> 0.3697 \("%\#0.00", el\-GR\) \-\> %36,97<br /><br /> 0.3697 \("\#\#.0 %", en\-US\) \-\> 37.0 %<br /><br /> 0.3697 \("\#\#.0 %", el\-GR\) \-\> 37,0 %|  
+|"‰"|パーミル プレースホルダー|数値に 1000 を乗算し、結果の文字列にローカライズされたパーミル記号を挿入します。<br /><br /> 詳細については、「["‰" カスタム指定子](#SpecifierPerMille)」を参照してください。|0.03697 \("\#0.00‰", en\-US\) \-\> 36.97‰<br /><br /> 0.03697 \("\#0.00‰", ru\-RU\) \-\> 36,97‰|  
+|"E0"<br /><br /> "E\+0"<br /><br /> "E\-0"<br /><br /> "e0"<br /><br /> "e\+0"<br /><br /> "e\-0"|指数表記|後に 0 \(ゼロ\) が 1 つ以上続く場合に、指数表記を使用して結果の書式を設定します。 大文字 "E" と小文字 "e" は、結果の文字列の指数記号を大文字にするか小文字にするかを示します。 "E" 文字または "e" 文字の後に続くゼロの数によって、指数部の最小桁数が決まります。 正符号 \(\+\) は、符号文字が指数部の前に常に挿入されることを示します。 負符号 \(\-\) は、指数部が負の値の場合にだけその前に符号文字が挿入されることを示します。<br /><br /> 詳細については、「["E" カスタム指定子と "e" カスタム指定子](#SpecifierExponent)」を参照してください。|987654 \("\#0.0e0"\) \-\> 98.8e4<br /><br /> 1503.92311 \("0.0\#\#e\+00"\) \-\> 1.504e\+03<br /><br /> 1.8901385E\-16 \("0.0e\+00"\) \-\> 1.9e\-16|  
+|\\|エスケープ文字|この文字の次の文字はカスタム書式指定子ではなくリテラルとして解釈されます。<br /><br /> 詳細については、「["\\" エスケープ文字](#SpecifierEscape)」を参照してください。|987654 \("\\\#\#\#00\\\#"\) \-\> \#987654\#|  
+|'*文字列*'<br /><br /> "*文字列*"|リテラル文字列区切り記号|囲まれた文字列が結果の文字列にそのままコピーされることを示します。|68 \("\#' degrees'"\) \-\> 68 degrees<br /><br /> 68 \("\#' degrees'"\) \-\> 68 degrees|  
+|;|セクション区切り記号|正の数値、負の数値、およびゼロの数値に対して、別々の書式指定文字列を使用してセクションを定義します。<br /><br /> 詳細については、「[";" セクション区切り記号](#SectionSeparator)」を参照してください。|12.345 \("\#0.0\#;\(\#0.0\#\);\-\\0\-"\) \-\> 12.35<br /><br /> 0 \("\#0.0\#;\(\#0.0\#\);\-\\0\-"\) \-\> \-0\-<br /><br /> \-12.345 \("\#0.0\#;\(\#0.0\#\);\-\\0\-"\) \-\> \(12.35\)<br /><br /> 12.345 \("\#0.0\#;\(\#0.0\#\)"\) \-\> 12.35<br /><br /> 0 \("\#0.0\#;\(\#0.0\#\)"\) \-\> 0.0<br /><br /> \-12.345 \("\#0.0\#;\(\#0.0\#\)"\) \-\> \(12.35\)|  
+|その他|上記以外のすべての文字|文字が結果の文字列にそのままコピーされます。|68 \("\# °"\) \-\> 68 °|  
+  
+ 以降では、それぞれのカスタム数値書式指定子について詳しく説明します。  
+  
+<a name="Specifier0"></a>   
+## "0" カスタム指定子  
+ "0" カスタム書式指定子は、ゼロ プレースホルダー記号として機能します。 書式が設定される値で、書式指定文字列のゼロに対応する位置に数字がある場合には、この数字が結果の文字列にコピーされます。それ以外の場合は、結果の文字列にゼロが表示されます。 整数部の左端のゼロの位置と、小数部の右端のゼロの位置によって、常に結果の文字列に示される桁数が決まります。  
+  
+ 指定子が "00" の場合、値は一の位で丸められ、小数点以下のゼロは常に切り捨てられます。 たとえば、"00" を指定して 34.5 を書式設定すると、結果の値は 35 になります。  
+  
+ 次の例では、ゼロ プレースホルダーを含むカスタム書式指定文字列を使って書式設定された複数の値を表示します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#1](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#1)]
+ [!code-csharp[Formatting.Numeric.Custom#1](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#1)]
+ [!code-vb[Formatting.Numeric.Custom#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#1)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierD"></a>   
+## "\#" カスタム指定子  
+ "\#" カスタム書式指定子は、桁プレースホルダー記号として機能します。 書式が指定される値で、書式指定文字列の "\#" 記号に対応する位置に数字がある場合には、この数字が結果の文字列にコピーされます。 それ以外の場合は、結果の文字列のこの位置には何も格納されません。  
+  
+ この指定子では、文字列の唯一の桁の値がゼロであっても、この桁が有効桁でない場合には、ゼロは表示されません。 表示される数値の有効桁である場合にのみゼロが表示されます。  
+  
+ 書式指定文字列が "\#\#" の場合は、値は一の位で丸められ、小数点以下のゼロは常に切り捨てられます。 たとえば、"\#\#" を指定して 34.5 を書式設定すると、結果の値は 35 になります。  
+  
+ 次の例では、桁プレースホルダーを含むカスタム書式指定文字列を使って書式設定された複数の値を表示します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#2](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#2)]
+ [!code-csharp[Formatting.Numeric.Custom#2](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#2)]
+ [!code-vb[Formatting.Numeric.Custom#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#2)]  
+  
+ 欠落している数字や先頭のゼロをスペースに置き換える結果の文字列を戻すには、次の例に示すように、[複合書式指定機能](../../../docs/standard/base-types/composite-formatting.md)を使用して、フィールド幅を指定します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#12](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/SpaceOrDigit1.cpp#12)]
+ [!code-csharp[Formatting.Numeric.Custom#12](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/SpaceOrDigit1.cs#12)]
+ [!code-vb[Formatting.Numeric.Custom#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/SpaceOrDigit1.vb#12)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierPt"></a>   
+## "." カスタム指定子  
+ "." カスタム書式指定子は、ローカライズされた小数点を結果の文字列に挿入します。 書式指定文字列の 1 番目のピリオドによって、書式設定後の値での小数点の位置が決定します。指定されている他のピリオドは無視されます。  
+  
+ 結果の文字列の中で小数点として使用される文字は、ピリオドであるとは限りません。書式設定を制御する <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> オブジェクトの <xref:System.Globalization.NumberFormatInfo> プロパティによって決定されます。  
+  
+ 次の例では、結果として得られるさまざまな文字列の小数点位置を、"." 書式指定子を使って定義しています。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#3](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#3)]
+ [!code-csharp[Formatting.Numeric.Custom#3](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#3)]
+ [!code-vb[Formatting.Numeric.Custom#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#3)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierTh"></a>   
+## "," カスタム指定子  
+ "," 文字は、桁区切り記号および数値位取り指定子の両方として機能します。  
+  
+-   桁区切り記号: 数値の整数部の桁を書式設定する 2 つの桁プレースホルダー \(0 または \#\) の間に 1 つ以上のコンマが指定されている場合は、出力の整数部分で各数値グループの間に桁区切り記号文字が挿入されます。  
+  
+     現在の <xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator%2A> オブジェクトの <xref:System.Globalization.NumberFormatInfo.NumberGroupSizes%2A> プロパティと <xref:System.Globalization.NumberFormatInfo> プロパティによって、桁区切り記号として使用される文字および各数値グループのサイズが決まります。 たとえば、文字列 "\#,\#" およびインバリアント カルチャを使用して数値 1000 が書式設定される場合は、出力が "1,000" となります。  
+  
+-   数値位取り指定子: 明示的または暗黙的な小数点のすぐ左側に 1 つ以上のコンマが指定されている場合は、コンマごとに書式設定対象の数値が 1000 で除算されます。 たとえば、"0,," 文字列を使用して数値 1 億が書式設定された場合、出力は "100" となります。  
+  
+ 桁区切り記号および数値位取り指定子は、同じ書式指定文字列で使用できます。 たとえば、"\#,0,," 文字列およびインバリアント カルチャを使用して 10 億の数値を書式設定した場合、出力は "1,000" となります。  
+  
+ 桁区切り記号としてコンマを使用する例を次に示します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#4](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#4)]
+ [!code-csharp[Formatting.Numeric.Custom#4](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#4)]
+ [!code-vb[Formatting.Numeric.Custom#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#4)]  
+  
+ 数値の位取り指定子としてコンマを使用する例を次に示します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#5](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#5)]
+ [!code-csharp[Formatting.Numeric.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#5)]
+ [!code-vb[Formatting.Numeric.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierPct"></a>   
+## "%" カスタム指定子  
+ 書式指定文字列にパーセント記号 \(%\) があると、書式設定前に数値に 100 が乗算されます。 数値では、書式指定文字列の % に対応する位置にローカライズされたパーセント記号が挿入されます。 使用されるパーセント記号は、現在の <xref:System.Globalization.NumberFormatInfo.PercentSymbol%2A> オブジェクトの <xref:System.Globalization.NumberFormatInfo> プロパティによって定義されます。  
+  
+ 次の例では、"%" カスタム指定子を含むさまざまなカスタム書式指定文字列を定義します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#6](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#6)]
+ [!code-csharp[Formatting.Numeric.Custom#6](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#6)]
+ [!code-vb[Formatting.Numeric.Custom#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#6)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierPerMille"></a>   
+## "‰" カスタム指定子  
+ 書式指定文字列にパーミル文字 \(‰ または \\u2030\) があると、書式設定前に数値に 1000 が乗算されます。 返される文字列では、書式指定文字列の ‰ に対応する位置に適切なパーミル記号が挿入されます。 使用されるパーミル文字は、カルチャ固有の書式設定情報を指定するオブジェクトの <xref:System.Globalization.NumberFormatInfo.PerMilleSymbol%2A?displayProperty=fullName> プロパティによって定義されます。  
+  
+ 次の例では、"‰" カスタム指定子を含むカスタム書式指定文字列を定義します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#9](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#9)]
+ [!code-csharp[Formatting.Numeric.Custom#9](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#9)]
+ [!code-vb[Formatting.Numeric.Custom#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#9)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierExponent"></a>   
+## "E" カスタム指定子と "e" カスタム指定子  
+ 書式指定文字列に "E"、"E\+"、"E\-"、"e"、"e\+"、または "e\-" が含まれており、これらの文字の直後にゼロが 1 つ以上続く場合には、指数表記を使用して数値の書式が設定されます。また、数値と指数の間に "E" または "e" が挿入されます。 指数表記インジケーターの後に続くゼロの数によって、出力の指数部の最小桁数が決まります。 書式 "E\+" または "e\+" は、正符号または負符号が指数部の前に常に挿入されることを示します。 書式 "E"、"E\-"、"e"、または "e\-" は、指数部が負の値の場合にだけその前に符号文字が挿入されることを示します。  
+  
+ 次の例では、指数表記の指定子を使用して、さまざまな数値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#7](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#7)]
+ [!code-csharp[Formatting.Numeric.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#7)]
+ [!code-vb[Formatting.Numeric.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SpecifierEscape"></a>   
+## "\\" エスケープ文字  
+ 書式指定文字列内の "\#"、"0"、"."、","、"%"、"‰" の各記号は、リテラル文字ではなく書式指定子として解釈されます。 カスタム書式指定文字列内での位置によっては、大文字および小文字の "E"、および \+ 記号と \- 記号も書式指定子として解釈されます。  
+  
+ 文字が書式指定子として解釈されないようにするには、その文字の前に、エスケープ文字の円記号を付けます。 エスケープ文字は、その後に続く文字が、そのまま結果の文字列に含める必要がある文字リテラルであることを示します。  
+  
+ 結果の文字列に円記号を含める場合は、円記号をもう 1 つ付加して、円記号自体をエスケープする必要があります \(`\\`\)。  
+  
+> [!NOTE]
+>  C\+\+ コンパイラや C\# コンパイラなど、一部のコンパイラでは、同様に、1 つの円記号がエスケープ文字として解釈されることがあります。 書式設定時に文字列が正しく解釈されるようにするには、C\# では、逐語的文字列リテラル文字 \(@ 文字\) を文字列の前に使用します。また、C\# および C\+\+ では、円記号の前にもう 1 つ円記号を付ける方法もあります。 両方の方法を次の C\# の例に示します。  
+  
+ 次の例では、エスケープ文字を使用して、書式設定操作で "\#"、"0"、"\\" の各文字がエスケープ文字としても書式指定子としても解釈されないようにします。 この C\# の例では、円記号をもう 1 つ付けて、円記号がリテラル文字として解釈されるようにしています。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#11](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/escape1.cpp#11)]
+ [!code-csharp[Formatting.Numeric.Custom#11](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/escape1.cs#11)]
+ [!code-vb[Formatting.Numeric.Custom#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/escape1.vb#11)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="SectionSeparator"></a>   
+## ";" セクション区切り記号  
+ セミコロン \(;\) は、値が正、負、ゼロのいずれであるかに応じて異なる書式設定を数値に適用する条件付き書式指定子です。 このように数値の内容によって適用する書式を変更するには、カスタム書式指定文字列に、セミコロンで区切ったセクションを最大 3 つまで作成します。 これらのセクションの説明を次に示します。  
+  
+|セクションの数|説明|  
+|-------------|--------|  
+|1 つ|書式指定文字列はすべての値に適用されます。|  
+|2 つ|最初のセクションが正の値とゼロに適用され、2 番目のセクションが負の値に適用されます。<br /><br /> 書式設定対象の数値が負の数値であるが、2 番目のセクションの書式指定に従って丸めた結果ゼロになる場合には、1 番目のセクションの書式に従ってこのゼロが書式設定されます。|  
+|3 つ|最初のセクションが正の値、2 番目のセクションが負の値、3 番目のセクションがゼロに適用されます。<br /><br /> ゼロ以外の値すべてに 1 番目のセクションが適用される場合には、2 番目のセクションが空になる \(セミコロンの間に何も表示されない\) ことがあります。<br /><br /> 書式設定対象の数値がゼロ以外の負の数値であるが、1 番目または 2 番目のセクションの書式に従って丸めた結果ゼロになる場合には、3 番目のセクションの書式に従ってこのゼロが書式設定されます。|  
+  
+ セクション区切り記号は、最後の値が書式設定されるときに、数値に関連付けられた既存の書式設定をすべて無視します。 たとえば、セクション区切り記号を使用する場合、負の値はマイナス記号を付けずに表示されます。 最終的に書式設定された値にマイナス記号を付ける場合は、カスタム書式指定子の中に明示的にマイナス記号を含める必要があります。  
+  
+ 次の例では、";" 書式指定子を使用して、正数、負数、ゼロの各部分に対し、それぞれ異なる書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#8](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/custom.cpp#8)]
+ [!code-csharp[Formatting.Numeric.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/custom.cs#8)]
+ [!code-vb[Formatting.Numeric.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/Custom.vb#8)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="NotesCustomFormatting"></a>   
+## ノート  
+  
+### 浮動小数点の無限大値と NaN \(非数\) 値  
+ <xref:System.Single> の浮動小数点型または <xref:System.Double> の浮動小数点型が正の無限大、負の無限大、または NaN \(非数\) である場合は、書式指定文字列とは関係なく、現在適用可能な <xref:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol%2A> オブジェクトによって指定される <xref:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol%2A>、<xref:System.Globalization.NumberFormatInfo.NaNSymbol%2A>、または <xref:System.Globalization.NumberFormatInfo> の各プロパティの値は、書式設定された文字列となります。  
+  
+### コントロール パネルの設定  
+ コントロール パネルの **\[地域と言語のオプション\]** での設定は、書式設定操作によって生成される結果の文字列に影響します。 これらの設定は、現在のスレッド カルチャに関連付けられた <xref:System.Globalization.NumberFormatInfo> オブジェクトを初期化するために使用され、現在のスレッド カルチャから書式設定の制御に使用される値が提供されます。 コンピューターで使用する設定が異なる場合は、生成される文字列も異なります。  
+  
+ また、<xref:System.Globalization.CultureInfo.%23ctor%28System.String%29?displayProperty=fullName> コンストラクターを使用して、現在のシステム カルチャと同じカルチャを表す新しい <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化した場合、コントロール パネルの **\[地域と言語のオプション\]** 項目で設定されたカスタマイズが新しい <xref:System.Globalization.CultureInfo> オブジェクトに適用されます。<xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを使用すると、システムに対するカスタマイズが反映されない <xref:System.Globalization.CultureInfo> オブジェクトを作成できます。  
+  
+### 丸めと固定小数点の書式指定文字列  
+ 固定小数点の書式指定文字列 \(つまり指数表記の書式指定文字を含まない書式指定文字列\) の場合は、小数点以下の桁数が小数点の右側にある桁プレースホルダーの数と同じである数値に丸められます。 書式指定文字列に小数点が含まれていない場合には、最も近い整数に丸められます。 数値の桁数が、整数部の桁プレースホルダーの数よりも大きい場合には、桁プレースホルダーに収まらない桁が、結果の文字列の 1 番目の桁プレースホルダーの直前にコピーされます。  
+  
+ [表のトップへ](#table)  
+  
+<a name="example"></a>   
+## 例  
+ 2 つのカスタム数値書式指定文字列の例を次に示します。 どちらの場合も、桁プレースホルダー \(`#`\) によって数値データが表示され、それ以外の文字はすべて結果の文字列にコピーされます。  
+  
+ [!code-cpp[Formatting.Numeric.Custom#10](../../../samples/snippets/cpp/VS_Snippets_CLR/formatting.numeric.custom/cpp/example1.cpp#10)]
+ [!code-csharp[Formatting.Numeric.Custom#10](../../../samples/snippets/csharp/VS_Snippets_CLR/formatting.numeric.custom/cs/example1.cs#10)]
+ [!code-vb[Formatting.Numeric.Custom#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/formatting.numeric.custom/vb/example1.vb#10)]  
+  
+ [表のトップへ](#table)  
+  
+## 参照  
+ <xref:System.Globalization.NumberFormatInfo>   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)   
+ [方法: 数値に先行するゼロを埋め込む](../../../docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md)   
+ [サンプル: .NET Framework 4 の書式設定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)
\ No newline at end of file
diff --git a/docs/standard/base-types/custom-timespan-format-strings.md b/docs/standard/base-types/custom-timespan-format-strings.md
new file mode 100644
index 00000000000..235903ee2eb
--- /dev/null
+++ b/docs/standard/base-types/custom-timespan-format-strings.md
@@ -0,0 +1,398 @@
+---
+title: "カスタム時間間隔書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム時間間隔書式指定文字列"
+  - "カスタムの TimeSpan 書式指定文字列"
+  - "書式指定子, カスタム時間間隔"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 時間"
+  - "書式指定 [.NET Framework], 時間間隔"
+ms.assetid: a63ebf55-7269-416b-b4f5-286f6c03bf0e
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# カスタム時間間隔書式指定文字列
+<xref:System.TimeSpan> 書式指定文字列は、書式設定操作によって生成される <xref:System.TimeSpan> 値の文字列形式を定義します。  カスタム書式指定文字列は、1 つ以上のカスタム <xref:System.TimeSpan> 書式指定子と任意の数のリテラル文字で構成されます。  [標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)以外の文字列は、すべてカスタム <xref:System.TimeSpan> 書式指定文字列として解釈されます。  
+  
+> [!IMPORTANT]
+>  カスタム <xref:System.TimeSpan> 書式指定子には、日と時間、時間と分、または秒と秒の小数部を区切る記号などのプレースホルダー区切り記号は含まれません。  これらの記号は、カスタム書式指定文字列にリテラル文字列として含まれている必要があります。  たとえば、`"dd\.hh\:mm"` は、ピリオド \(.\) を日と時間の間の区切り記号として定義し、コロンを時間と分の間の区切り記号として定義します。  
+>   
+>  カスタム <xref:System.TimeSpan> 書式指定子には、負と正の時間間隔の区別に使用できる符号も含まれていません。  符号を含めるには、条件ロジックを使用して書式指定文字列を構成する必要があります。  例については、「[その他の文字](#Other)」を参照してください。  
+  
+ <xref:System.TimeSpan> 値の文字列形式は、<xref:System.TimeSpan.ToString%2A?displayProperty=fullName> メソッドのオーバーロードの呼び出しと、<xref:System.String.Format%2A?displayProperty=fullName> などの複合書式指定をサポートするメソッドによって生成されます。  詳細については、「[型の書式設定](../../../docs/standard/base-types/formatting-types.md)」および「[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)」を参照してください。  次のコード例では、書式設定操作でカスタム書式指定文字列を使用する方法を示しています。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customformatexample1.cs#1)]
+ [!code-vb[Conceptual.TimeSpan.Custom#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customformatexample1.vb#1)]  
+  
+ カスタム <xref:System.TimeSpan> 書式指定文字列は、解析操作に必要な入力文字列の書式を定義するために <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドと <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドでも使用されます \(解析では、特定の値の文字列形式が、その値に変換されます\)。次のコード例では、解析操作で標準書式指定文字列を使用する方法を示しています。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customparseexample1.cs#2)]
+ [!code-vb[Conceptual.TimeSpan.Custom#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customparseexample1.vb#2)]  
+  
+<a name="table"></a> カスタム日時書式指定子を次の表に示します。  
+  
+|書式指定子|説明|例|  
+|-----------|--------|-------|  
+|"d" または "%d"|時間間隔の日数。<br /><br /> 詳細については、「["d" カスタム書式指定子](#dSpecifier)」を参照してください。|`new TimeSpan(6, 14, 32, 17, 685):`<br /><br /> `%d` \-\-\> "6"<br /><br /> `d\.hh\:mm` \-\-\> "6.14:32"|  
+|"dd" ～ "dddddddd"|必要に応じて先行ゼロで埋められた、時間間隔の日数。<br /><br /> 詳細については、「["dd" ～ "dddddddd" カスタム書式指定子](#ddSpecifier)」を参照してください。|`new TimeSpan(6, 14, 32, 17, 685):`<br /><br /> `ddd` \-\-\> "006"<br /><br /> `dd\.hh\:mm` \-\-\> "06.14:32"|  
+|"h" または "%h"|日数の一部としてカウントされない、時間間隔の時間数。  1 桁の時間に先行ゼロは付きません。<br /><br /> 詳細については、「["h" カスタム書式指定子](#hSpecifier)」を参照してください。|`new TimeSpan(6, 14, 32, 17, 685):`<br /><br /> `%h` \-\-\> "14"<br /><br /> `hh\:mm` \-\-\> "14:32"|  
+|"hh"|日数の一部としてカウントされない、時間間隔の時間数。  1 桁の時間には、先頭に 0 が付けられます。<br /><br /> 詳細については、「["hh" カスタム書式指定子](#hhSpecifier)」を参照してください。|`new TimeSpan(6, 14, 32, 17, 685):`<br /><br /> `hh` \-\-\> "14"<br /><br /> `new TimeSpan(6, 8, 32, 17, 685):`<br /><br /> `hh` \-\-\> 08|  
+|"m" または "%m"|時間数および日数のいずれの一部としても含まれない、時間間隔の分数。  1 桁の分に先行ゼロは付きません。<br /><br /> 詳細については、「["m" カスタム書式指定子](#mSpecifier)」を参照してください。|`new TimeSpan(6, 14, 8, 17, 685):`<br /><br /> `%m` \-\-\> "8"<br /><br /> `h\:m` \-\-\> "14:8"|  
+|"mm"|時間数および日数のいずれの一部としても含まれない、時間間隔の分数。  1 桁の分には、先頭に 0 が付きます。<br /><br /> 詳細については、「["mm" カスタム書式指定子](#mmSpecifier)」を参照してください。|`new TimeSpan(6, 14, 8, 17, 685):`<br /><br /> `mm` \-\-\> "08"<br /><br /> `new TimeSpan(6, 8, 5, 17, 685):`<br /><br /> `d\.hh\:mm\:ss` \-\-\> 6.08:05:17|  
+|"s" または "%s"|時間数、日数、および分数のいずれの一部としても含まれない、時間間隔の秒数。  1 桁の秒に先行ゼロは付きません。<br /><br /> 詳細については、「["s" カスタム書式指定子](#sSpecifier)」を参照してください。|`TimeSpan.FromSeconds(12.965)`:<br /><br /> `%s` \-\-\> 12<br /><br /> `s\.fff` \-\-\> 12.965|  
+|"ss"|時間数、日数、および分数のいずれの一部としても含まれない、時間間隔の秒数。1 桁の秒には、先頭に 0 が付きます。<br /><br /> 詳細については、「["ss" カスタム書式指定子](#ssSpecifier)」を参照してください。|`TimeSpan.FromSeconds(6.965)`:<br /><br /> `ss` \-\-\> 06<br /><br /> `ss\.fff` \-\-\> 06.965|  
+|"f" または "%f"|時間間隔の秒部分の 1\/10。<br /><br /> 詳細については、「["f" カスタム書式指定子](#fSpecifier)」を参照してください。|`TimeSpan.FromSeconds(6.895)`:<br /><br /> `f` \-\-\> 8<br /><br /> `ss\.f` \-\-\> 06.8|  
+|"ff"|時間間隔の秒部分の 1\/100。<br /><br /> 詳細については、「["ff" カスタム書式指定子](#ffSpecifier)」を参照してください。|`TimeSpan.FromSeconds(6.895)`:<br /><br /> `ff` \-\-\> 89<br /><br /> `ss\.ff` \-\-\> 06.89|  
+|"fff"|時間間隔の秒部分の 1\/1000。<br /><br /> 詳細については、「["fff" カスタム書式指定子](#f3Specifier)」を参照してください。|`TimeSpan.FromSeconds(6.895)`:<br /><br /> `fff` \-\-\> 895<br /><br /> `ss\.fff` \-\-\> 06.895|  
+|"ffff"|時間間隔の秒部分の 1\/10000。<br /><br /> 詳細については、「["ffff" カスタム書式指定子](#f4Specifier)」を参照してください。|`TimeSpan.Parse("0:0:6.8954321")`:<br /><br /> `ffff` \-\-\> 8954<br /><br /> `ss\.ffff` \-\-\> 06.8954|  
+|"fffff"|時間間隔の秒部分の 1\/100000。<br /><br /> 詳細については、「["fffff" カスタム書式指定子](#f5Specifier)」を参照してください。|`TimeSpan.Parse("0:0:6.8954321")`:<br /><br /> `fffff` \-\-\> 89543<br /><br /> `ss\.fffff` \-\-\> 06.89543|  
+|"ffffff"|時間間隔の秒部分の 1\/1000000。<br /><br /> 詳細については、「["ffffff" カスタム書式指定子](#f6Specifier)」を参照してください。|`TimeSpan.Parse("0:0:6.8954321")`:<br /><br /> `ffffff` \-\-\> 895432<br /><br /> `ss\.ffffff` \-\-\> 06.895432|  
+|"fffffff"|時間間隔の秒部分の 1\/10000000 \(またはタイマー刻みの小数部\)。<br /><br /> 詳細については、「["fffffff" カスタム書式指定子](#f7Specifier)」を参照してください。|`TimeSpan.Parse("0:0:6.8954321")`:<br /><br /> `fffffff` \-\-\> 8954321<br /><br /> `ss\.fffffff` \-\-\> 06.8954321|  
+|"F" または "%F"|時間間隔の秒部分の 1\/10。  その桁がゼロの場合には、何も表示されません。<br /><br /> 詳細については、「["F" カスタム書式指定子](#F_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.32")`:<br /><br /> `%F`: 3<br /><br /> `TimeSpan.Parse("0:0:3.091")`:<br /><br /> `ss\.F`: 03.|  
+|"FF"|時間間隔の秒部分の 1\/100。  小数の後続のゼロは表示されません。また、2 桁のゼロも含まれません。<br /><br /> 詳細については、「["FF" カスタム書式指定子](#FF_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.329")`:<br /><br /> `FF`: 32<br /><br /> `TimeSpan.Parse("0:0:3.101")`:<br /><br /> `ss\.FF`: 03.1|  
+|"FFF"|時間間隔の秒部分の 1\/1000。  小数の後続のゼロは含まれません。<br /><br /> 詳細情報:|`TimeSpan.Parse("00:00:06.3291")`:<br /><br /> `FFF`: 329<br /><br /> `TimeSpan.Parse("0:0:3.1009")`:<br /><br /> `ss\.FFF`: 03.1|  
+|"FFFF"|時間間隔の秒部分の 1\/10000。  小数の後続のゼロは含まれません。<br /><br /> 詳細については、「["FFFF" カスタム書式指定子](#F4_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.32917")`:<br /><br /> `FFFFF`: 3291<br /><br /> `TimeSpan.Parse("0:0:3.10009")`:<br /><br /> `ss\.FFFF`: 03.1|  
+|"FFFFF"|時間間隔の秒部分の 1\/100000。  小数の後続のゼロは含まれません。<br /><br /> 詳細については、「["FFFFF" カスタム書式指定子](#F5_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.329179")`:<br /><br /> `FFFFF`: 32917<br /><br /> `TimeSpan.Parse("0:0:3.100009")`:<br /><br /> `ss\.FFFFF`: 03.1|  
+|"FFFFFF"|時間間隔の秒部分の 1\/1000000。  小数の後続のゼロは表示されません。<br /><br /> 詳細については、「["FFFFFF" カスタム書式指定子](#F6_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.3291791")`:<br /><br /> `FFFFFF`: 329179<br /><br /> `TimeSpan.Parse("0:0:3.1000009")`:<br /><br /> `ss\.FFFFFF`: 03.1|  
+|"FFFFFFF"|時間間隔の秒部分の 1\/10000000。  小数の後続のゼロは表示されません。また、7 桁のゼロも表示されません。<br /><br /> 詳細については、「["FFFFFFF" カスタム書式指定子](#F7_Specifier)」を参照してください。|`TimeSpan.Parse("00:00:06.3291791")`:<br /><br /> `FFFFFF`: 3291791<br /><br /> `TimeSpan.Parse("0:0:3.1900000")`:<br /><br /> `ss\.FFFFFF`: 03.19|  
+|*'string*'|リテラル文字列の区切り記号。<br /><br /> 詳細については、「[その他の文字](#Other)」を参照してください。|`new TimeSpan(14, 32, 17):`<br /><br /> `hh':'mm':'ss` \-\-\> "14:32:17"|  
+|\\|エスケープ文字。<br /><br /> 詳細については、「[その他の文字](#Other)」を参照してください。|`new TimeSpan(14, 32, 17):`<br /><br /> `hh\:mm\:ss` \-\-\> "14:32:17"|  
+|その他の文字|エスケープされないその他の文字はすべて、カスタム書式指定子として解釈されます。<br /><br /> 詳細については、「[その他の文字](#Other)」を参照してください。|`new TimeSpan(14, 32, 17):`<br /><br /> `hh\:mm\:ss` \-\-\> "14:32:17"|  
+  
+<a name="dSpecifier"></a>   
+## "d" カスタム書式指定子  
+ "d" カスタム書式指定子は、時間間隔の日数を表す <xref:System.TimeSpan.Days%2A?displayProperty=fullName> プロパティの値を出力します。  値が 1 桁を超える場合でも、<xref:System.TimeSpan> 値の完全な日数が出力されます。  <xref:System.TimeSpan.Days%2A?displayProperty=fullName> プロパティの値が 0 の場合、指定子は "0" を出力します。  
+  
+ "d" カスタム書式指定子が単独で使用される場合は、間違って標準書式指定文字列として解釈されないように "%d" を指定します。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#3)]
+ [!code-vb[Conceptual.TimeSpan.Custom#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#3)]  
+  
+ "d" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#4)]
+ [!code-vb[Conceptual.TimeSpan.Custom#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#4)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ddSpecifier"></a>   
+## "dd" ～ "dddddddd" カスタム書式指定子  
+ "dd"、"ddd"、"dddd"、"ddddd"、"dddddd"、"ddddddd"、および "dddddddd" カスタム書式指定子は、時間間隔の日数を表す <xref:System.TimeSpan.Days%2A?displayProperty=fullName> プロパティの値を出力します。  
+  
+ 出力文字列には、書式指定子の "d" 文字の数で指定される桁数以上が含まれ、必要に応じて、先行ゼロで埋められます。  日数の桁数が書式指定子の "d" 文字の数を超える場合は、結果文字列に完全な日数が出力されます。  
+  
+ 次の例では、これらの書式指定子を使用して、2 つの <xref:System.TimeSpan> 値の文字列形式を表示します。  最初の時間間隔の日の部分の値は 0 です。2 番目の時間間隔の日の部分の値は 365 です。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#5)]
+ [!code-vb[Conceptual.TimeSpan.Custom#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="hSpecifier"></a>   
+## "h" カスタム書式指定子  
+ "h" カスタム書式指定子は、日の部分の一部としてカウントされない、時間間隔の時間数を表す <xref:System.TimeSpan.Hours%2A?displayProperty=fullName> プロパティの値を出力します。  <xref:System.TimeSpan.Hours%2A?displayProperty=fullName> プロパティの値が 0 ～ 9 の場合は 1 桁の文字列値を返し、<xref:System.TimeSpan.Hours%2A?displayProperty=fullName> プロパティの値が 10 ～ 23 の場合は 2 桁の文字列値を返します。  
+  
+ "h" カスタム書式指定子が単独で使用される場合は、誤って標準書式指定文字列として解釈されないように "%h" を指定します。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#6)]
+ [!code-vb[Conceptual.TimeSpan.Custom#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#6)]  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "%h" カスタム書式指定子を使用すると、数値文字列を時間数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#8)]
+ [!code-vb[Conceptual.TimeSpan.Custom#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#8)]  
+  
+ "h" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#7)]
+ [!code-vb[Conceptual.TimeSpan.Custom#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="hhSpecifier"></a>   
+## "hh" カスタム書式指定子  
+ "hh" カスタム書式指定子は、日の部分の一部としてカウントされない、時間間隔の時間数を表す <xref:System.TimeSpan.Hours%2A?displayProperty=fullName> プロパティの値を出力します。  0 ～ 9 の値の場合は、出力文字列に先行ゼロが含まれます。  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "hh" カスタム書式指定子を使用すると、数値文字列を時間数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#9)]
+ [!code-vb[Conceptual.TimeSpan.Custom#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#9)]  
+  
+ "hh" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#10)]
+ [!code-vb[Conceptual.TimeSpan.Custom#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#10)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="mSpecifier"></a>   
+## "m" カスタム書式指定子  
+ "m" カスタム書式指定子は、日の部分の一部としてカウントされない、時間間隔の分数を表す <xref:System.TimeSpan.Minutes%2A?displayProperty=fullName> プロパティの値を出力します。  <xref:System.TimeSpan.Minutes%2A?displayProperty=fullName> プロパティの値が 0 ～ 9 の場合は 1 桁の文字列値を返し、<xref:System.TimeSpan.Minutes%2A?displayProperty=fullName> プロパティの値が 10 ～ 59 の場合は 2 桁の文字列値を返します。  
+  
+ "m" カスタム書式指定子が単独で使用される場合は、誤って標準書式指定文字列として解釈されないように "%m" を指定します。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#6)]
+ [!code-vb[Conceptual.TimeSpan.Custom#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#6)]  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "%m" カスタム書式指定子を使用すると、数値文字列を分数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#11)]
+ [!code-vb[Conceptual.TimeSpan.Custom#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#11)]  
+  
+ "m" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#12)]
+ [!code-vb[Conceptual.TimeSpan.Custom#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#12)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="mmSpecifier"></a>   
+## "mm" カスタム書式指定子  
+ "mm" カスタム書式指定子は、時間または日の部分の一部として含まれない、時間間隔の分数を表す <xref:System.TimeSpan.Minutes%2A?displayProperty=fullName> プロパティの値を出力します。  0 ～ 9 の値の場合は、出力文字列に先行ゼロが含まれます。  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "mm" カスタム書式指定子を使用すると、数値文字列を分数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#13)]
+ [!code-vb[Conceptual.TimeSpan.Custom#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#13)]  
+  
+ "mm" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#14)]
+ [!code-vb[Conceptual.TimeSpan.Custom#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#14)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="sSpecifier"></a>   
+## "s" カスタム書式指定子  
+ "s" カスタム書式指定子は、時間、日、および分の部分のいずれの一部としても含まれない、時間間隔の秒数を表す <xref:System.TimeSpan.Seconds%2A?displayProperty=fullName> プロパティの値を出力します。  <xref:System.TimeSpan.Seconds%2A?displayProperty=fullName> プロパティの値が 0 ～ 9 の場合は 1 桁の文字列値を返し、<xref:System.TimeSpan.Seconds%2A?displayProperty=fullName> プロパティの値が 10 ～ 59 の場合は 2 桁の文字列値を返します。  
+  
+ "s" カスタム書式指定子が単独で使用される場合は、誤って標準書式指定文字列として解釈されないように "%s" を指定します。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#15)]
+ [!code-vb[Conceptual.TimeSpan.Custom#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#15)]  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "%s" カスタム書式指定子を使用すると、数値文字列を秒数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#17)]
+ [!code-vb[Conceptual.TimeSpan.Custom#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#17)]  
+  
+ "s" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#16)]
+ [!code-vb[Conceptual.TimeSpan.Custom#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#16)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ssSpecifier"></a>   
+## "ss" カスタム書式指定子  
+ "ss" カスタム書式指定子は、時間、日、および分の部分のいずれの一部としても含まれない、時間間隔の秒数を表す <xref:System.TimeSpan.Seconds%2A?displayProperty=fullName> プロパティの値を出力します。  0 ～ 9 の値の場合は、出力文字列に先行ゼロが含まれます。  
+  
+ 通常、解析操作では、1 つの数値のみを含む入力文字列は日数として解釈されます。  代わりに "ss" カスタム書式指定子を使用すると、数値文字列を秒数として解釈できます。  具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#18)]
+ [!code-vb[Conceptual.TimeSpan.Custom#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#18)]  
+  
+ "ss" カスタム書式指定子の使用例を次に示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/customexamples1.cs#19)]
+ [!code-vb[Conceptual.TimeSpan.Custom#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/customexamples1.vb#19)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="fSpecifier"></a>   
+## "f" カスタム書式指定子  
+ "f" カスタム書式指定子は、時間間隔の秒部分の 1\/10 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 1 桁の小数部が含まれている必要があります。  
+  
+ "f" カスタム書式指定子が単独で使用される場合は、誤って標準書式指定文字列として解釈されないように "%f" を指定します。  
+  
+ 次の例では、"f" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/10 を表示します。"f" は最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ffSpecifier"></a>   
+## "ff" カスタム書式指定子  
+ "ff" カスタム書式指定子は、時間間隔の秒部分の 1\/100 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 2 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"ff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/100 を表示します。"ff" は最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="f3Specifier"></a>   
+## "fff" カスタム書式指定子  
+ "fff" カスタム書式指定子 \("f" 文字が 3 つ\) は、時間間隔の秒部分の 1\/1000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 3 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"fff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/1000 を表示します。"fff" は最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="f4Specifier"></a>   
+## "ffff" カスタム書式指定子  
+ "ffff" カスタム書式指定子 \("f" 文字が 4 つ\) は、時間間隔の秒部分の 1\/10000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 4 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"ffff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/10000 を表示します。"ffff" は最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="f5Specifier"></a>   
+## "fffff" カスタム書式指定子  
+ "fffff" カスタム書式指定子 \("f" 文字が 5 つ\) は、時間間隔の秒部分の 1\/100000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 5 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"fffff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/100000 を表示します。"fffff" は最初に、唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="f6Specifier"></a>   
+## "ffffff" カスタム書式指定子  
+ "ffffff" カスタム書式指定子 \("f" 文字が 6 つ\) は、時間間隔の秒部分の 1\/1000000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 6 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"ffffff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/1000000 を表示します。  最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="f7Specifier"></a>   
+## "fffffff" カスタム書式指定子  
+ "fffffff" カスタム書式指定子 \("f" 文字が 7 つ\) は、時間間隔の秒部分の 1\/10000000 \(またはタイマー刻みの小数部\) を出力します。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列に 7 桁の小数部が含まれている必要があります。  
+  
+ 次の例では、"fffffff" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値のタイマー刻みの小数部を表示します。  最初に唯一の書式指定子として使用されてから、カスタム書式指定文字列で "s" 指定子と結合されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/fspecifiers1.cs#20)]
+ [!code-vb[Conceptual.TimeSpan.Custom#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/fspecifiers1.vb#20)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F_Specifier"></a>   
+## "F" カスタム書式指定子  
+ "F" カスタム書式指定子は、時間間隔の秒部分の 1\/10 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  時間間隔の秒部分の 1\/10 が 0 の場合、それは結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10 の桁を使用するかどうかはオプションです。  
+  
+ "F" カスタム書式指定子が単独で使用される場合は、誤って標準書式指定文字列として解釈されないように "%F" を指定します。  
+  
+ 次の例では、"F" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/10 を表示します。  このカスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#21)]
+ [!code-vb[Conceptual.TimeSpan.Custom#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#21)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FF_Specifier"></a>   
+## "FF" カスタム書式指定子  
+ "FF" カスタム書式指定子は、時間間隔の秒部分の 1\/100 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10 および 1\/100 の桁を使用するかどうかはオプションです。  
+  
+ 次の例では、"FF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/100 を表示します。  このカスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#22](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#22)]
+ [!code-vb[Conceptual.TimeSpan.Custom#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#22)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F3_Specifier"></a>   
+## "FFF" カスタム書式指定子  
+ "FFF" カスタム書式指定子 \("F" 文字が 3 つ\) は、時間間隔の秒部分の 1\/1000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10、1\/100、および 1\/1000 の桁を使用するかどうかはオプションです。  
+  
+ 次の例では、"FFF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/1000 を表示します。  このカスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#23](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#23)]
+ [!code-vb[Conceptual.TimeSpan.Custom#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#23)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F4_Specifier"></a>   
+## "FFFF" カスタム書式指定子  
+ "FFFF" カスタム書式指定子 \("F" 文字が 4 つ\) は、時間間隔の秒部分の 1\/10000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10、1\/100、1\/1000、および 1\/10000 の桁を使用するかどうかはオプションです。  
+  
+ 次の例では、"FFFF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/10000 を表示します。  "FFFF" カスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#24](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#24)]
+ [!code-vb[Conceptual.TimeSpan.Custom#24](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#24)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F5_Specifier"></a>   
+## "FFFFF" カスタム書式指定子  
+ "FFFFF" カスタム書式指定子 \("F" 文字が 5 つ\) は、時間間隔の秒部分の 1\/100000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10、1\/100、1\/1000、1\/10000、および 1\/100000 の桁を使用するかどうかはオプションです。  
+  
+ 次の例では、"FFFFF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/100000 を表示します。  "FFFFF" カスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#25](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#25)]
+ [!code-vb[Conceptual.TimeSpan.Custom#25](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#25)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F6_Specifier"></a>   
+## "FFFFFF" カスタム書式指定子  
+ "FFFFFF" カスタム書式指定子 \("F" 文字が 6 つ\) は、時間間隔の秒部分の 1\/1000000 を出力します。  書式指定操作では、これより下位の小数桁は切り捨てられます。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、秒の 1\/10、1\/100、1\/1000、1\/10000、1\/100000 および 1\/1000000 の桁を使用するかどうかはオプションです。  
+  
+ 次の例では、"FFFFFF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の 1\/1000000 を表示します。  このカスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#26](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#26)]
+ [!code-vb[Conceptual.TimeSpan.Custom#26](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#26)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="F7_Specifier"></a>   
+## "FFFFFFF" カスタム書式指定子  
+ "FFFFFFF" カスタム書式指定子 \("F" 文字が 7 つ\) は、時間間隔の秒部分の 1\/10000000 \(またはタイマー刻みの小数部\) を出力します。  後続の小数のゼロがある場合、それらの数字は結果文字列に含まれません。  <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドを呼び出す解析操作では、入力文字列の 7 桁の小数部を使用するかどうかはオプションです。  
+  
+ 次の例では、"FFFFFFF" カスタム書式指定子を使用して、<xref:System.TimeSpan> 値の秒部分の小数部を表示します。  このカスタム書式指定子は解析操作でも使用されます。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#27](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/f_specifiers1.cs#27)]
+ [!code-vb[Conceptual.TimeSpan.Custom#27](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/f_specifiers1.vb#27)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="Other"></a>   
+## その他の文字  
+ 空白文字など、書式指定文字列内のエスケープされないその他の文字は、カスタム書式指定子として解釈されます。  ほとんどの場合、エスケープされないその他の文字が存在すると、<xref:System.FormatException> が発生します。  
+  
+ 書式指定文字列にリテラル文字を含める方法は 2 つあります。  
+  
+-   単一引用符 \(リテラル文字列の区切り記号\) で囲みます。  
+  
+-   エスケープ文字として解釈される円記号 \("\\"\) を前に付けます。  このため、C\# では、書式指定文字列に @ を付けるか、リテラル文字の前に追加の円記号が指定されている必要があります。  
+  
+     条件ロジックを使用してエスケープされたリテラルを書式指定文字列に含めることが必要になる場合もあります。  次の例では、条件ロジックを使用して負の時間間隔の符号を含めます。  
+  
+     [!code-csharp[Conceptual.TimeSpan.Custom#29](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/negativevalues1.cs#29)]
+     [!code-vb[Conceptual.TimeSpan.Custom#29](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/negativevalues1.vb#29)]  
+  
+ .NET Framework では、時間間隔の区切り記号の文法が定義されていません。  そのため、日と時間、時間と分、分と秒、および秒と秒の小数部の間の区切り記号は、書式指定文字列ですべて文字リテラルとして扱う必要があります。  
+  
+ 次の例では、エスケープ文字と単一引用符の両方を使用して、出力文字列に "minutes" という単語を含むカスタム書式指定文字列を定義しています。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Custom#28](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.custom/cs/literal1.cs#28)]
+ [!code-vb[Conceptual.TimeSpan.Custom#28](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.custom/vb/literal1.vb#28)]  
+  
+ [表のトップへ](#table)  
+  
+## 参照  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/details-of-regular-expression-behavior.md b/docs/standard/base-types/details-of-regular-expression-behavior.md
new file mode 100644
index 00000000000..1d123f985ea
--- /dev/null
+++ b/docs/standard/base-types/details-of-regular-expression-behavior.md
@@ -0,0 +1,158 @@
+---
+title: "正規表現の動作の詳細 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現、動作"
+  - ".NET Framework 正規表現、動作"
+ms.assetid: 0ee1a6b8-caac-41d2-917f-d35570021b10
+caps.latest.revision: 27
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# 正規表現の動作の詳細
+.NET Framework の正規表現エンジンはバックトラッキング正規表現検索エンジンであり、Perl、Python、Emacs、および Tcl で使用されているのと同じ従来型の非決定性有限オートマトン \(NFA: Nondeterministic Finite Automaton\) エンジンを採用しています。  このエンジンは、awk、egrep、または lex に見られるような、高速であるが制限が多い、純粋な正規表現決定性有限オートマトン \(DFA: Deterministic Finite Automaton\) エンジンとは異なります。  また、標準化されているが低速な POSIX NFA とも異なります。  次のセクションでは、3 種類の正規表現エンジンについて説明し、.NET Framework の正規表現が従来型 NFA エンジンを使用して実装されている理由について説明します。  
+  
+## NFA エンジンの利点  
+ DFA エンジンがパターン一致を実行する場合、その処理順序は入力文字列によって決定されます。  このエンジンは入力文字列の先頭で開始し、順番に進んで、次の文字が正規表現パターンと一致するかどうかを判断します。  このエンジンでは、想定され得る最長の文字列を確実に検索できます。  同じ文字が 2 回テストされることはないため、DFA エンジンはバックトラッキングをサポートしません。  しかし、DFA エンジンには限定された状態しか含まれないため、前方参照を使用してパターンを検索することはできません。また、明示的な展開形式が作成されないため、部分式をキャプチャできません。  
+  
+ DFA エンジンとは異なり、従来型 NFA エンジンがパターン一致を実行する場合、その処理順序は正規表現パターンによって決定されます。  特定の言語要素を処理するときに、エンジンは最長一致を使用します。つまり、できるだけ多くの入力文字列と一致します。  しかし、部分式の一致が見つかった後の状態も保存します。  一致が最終的に見つからなかった場合、エンジンは保存した状態に戻すことができるため、さらに照合を試行できます。  正規表現の後の言語要素も照合できるようにするための、この見つかった部分式の一致を破棄するプロセスを*バックトラッキング*と呼びます。  NFA エンジンは、バックトラッキングを使用して、ある正規表現から展開できるすべての形式を特定の順序でテストし、最初に一致した文字列を採用します。  NFA エンジンでは、見つかった文字列用にその正規表現固有の展開形式が作成されるため、部分式に一致する文字列、および一致する前方参照をキャプチャできます。  しかし、従来型 NFA ではバックトラックが行われるため、1 つの状態に到達する経路が複数ある場合には、同じ状態に何度も到達することがあり得ます。  その結果、最悪の場合には指数関数的に実行速度が遅くなることがあります。  従来型 NFA エンジンでは、最初に見つかった文字列が採用されるため、その他の \(おそらくはより長い\) 一致文字列が見つからないままになる場合もあります。  
+  
+ POSIX NFA エンジンは従来型 NFA エンジンと似ていますが、一致する最長の文字列が見つかるまでバックトラックが継続される点が異なります。  その結果、POSIX NFA エンジンは従来型 NFA エンジンよりも遅くなります。また、POSIX NFA エンジンを使用する場合は、バックトラッキング検索の順序を変更して、短い一致文字列を長い一致文字列よりも優先させることはできません。  
+  
+ 従来型 NFA エンジンは、DFA エンジンや POSIX NFA エンジンよりも文字列の一致をより厳密に制御するため、プログラマに人気があります。  NFA エンジンは、最悪の場合には実行速度が遅くなることもありますが、あいまいさを少なくし、バックトラッキングを制限するパターンを使用することで、一致する文字列を線形時間または多項式時間で見つけるように調整できます。  言い換えると、NFA エンジンはパフォーマンスと引き換えに能力と柔軟性を向上させますが、ほとんどの場合、正規表現が適切に記述されていれば十分に許容できるパフォーマンスを実現でき、バックトラッキングによってパフォーマンスが指数関数に低下する状況を回避します。  
+  
+> [!NOTE]
+>  過度なバックトラッキングによって発生するパフォーマンスの低下およびそのような問題を回避する正規表現の作成方法については、「[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)」を参照してください。  
+  
+## .NET Framework エンジンの機能  
+ 従来型の NFA エンジンの長所を利用するために、.NET Framework 正規表現エンジンには、プログラマがバックトラッキング エンジンを調整できるようにするための構成体セットが組み込まれています。  それらの構成体を使用すると、高速検索を実行したり、他の展開形式よりも特定の展開形式を優先させたりできます。  
+  
+ .NET Framework の正規表現エンジンのその他の機能は、次のとおりです。  
+  
+-   最短一致の量指定子: `??`、`*?`、`+?`、`{`*n*`,`*m*`}?`。  これらの構成体は、バックトラッキング エンジンに対し、繰り返しの回数が最も少ない文字列を最初に検索するように指示します。  逆に、通常の最長一致の量指定子は、繰り返し回数の最も多い文字列を最初に検索しようとします。  2 つの量指定子の動作の違いを次の例に示します。  正規表現は、数字で終わる文を照合し、キャプチャ グループはその数字を抽出します。  正規表現 `.+(\d+)\.` には、最長一致の量指定子 `.+` が含まれます。これにより、正規表現エンジンは、数字の最後の桁のみキャプチャします。  対照的に、正規表現 `.+?(\d+)\.` には、最短一致の量指定子 `.+?` が含まれます。これにより、正規表現エンジンは数字全体をキャプチャします。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/lazy1.cs#1)]
+     [!code-vb[Conceptual.RegularExpressions.Design#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/lazy1.vb#1)]  
+  
+     この正規表現の最長一致バージョンと最短一致バージョンは、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |----------|--------|  
+    |`.+` \(最長一致の量指定子\)|任意の文字の 1 回以上の出現に一致します。  これにより、正規表現エンジンは文字列全体を照合してから、必要に応じてバックトラックし、パターンの残りの部分を照合します。|  
+    |`.+?` \(最短一致の量指定子\)|任意の文字の 1 回以上の出現 \(ただし、可能な限り少ない回数\) に一致します。|  
+    |`(\d+)`|1 文字以上の数字と一致し、その文字を 1 番目のキャプチャ グループに代入します。|  
+    |`\.`|ピリオドと一致します。|  
+  
+     最短一致の量指定子の詳細については、「[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)」を参照してください。  
+  
+-   肯定先読み: `(?=`*subexpression*`)`。  この機能により、バックトラッキング エンジンは部分式と一致する文字列を見つけた後で、テキスト内の同じ位置に戻ることができます。  同じ位置から複数のパターンを確認しながらテキスト全体を検索する場合に便利です。  エンジンは、一致するテキストに部分文字列を含めずに、一致文字列の末尾に部分文字列が存在するかどうかも検証できます。  次の例では、肯定先読みを使用して、後に区切り記号が続かない文中の単語を抽出します。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/lookahead1.cs#2)]
+     [!code-vb[Conceptual.RegularExpressions.Design#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/lookahead1.vb#2)]  
+  
+     正規表現 `\b[A-Z]+\b(?=\P{P})` は、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |----------|--------|  
+    |`\b`|ワード境界から照合を開始します。|  
+    |`[A-Z]+`|任意の英字と 1 回以上、一致します。  <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出されているため、比較では大文字と小文字が区別されません。|  
+    |`\b`|ワード境界で照合を終了します。|  
+    |`(?=\P{P})`|先読みして次の文字が区切り記号かどうかを判定します。  区切り記号でない場合は一致と見なされます。|  
+  
+     肯定先読みアサーションの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   負のな先読み: `(?!`*subexpression*`)`。  この機能により、部分式に一致する文字列が見つからなかった場合だけ、式に一致できるようになります。  ある文字列を除外する表現の方が、含める表現よりも単純になることが多いため、この機能は検索を簡略化する場合に特に力を発揮します。  たとえば、"non" で始まらない単語を表す表現を記述するのは簡単ではありません。  次の例では、否定先読みを使用してこれらを除外します。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/lookahead2.cs#3)]
+     [!code-vb[Conceptual.RegularExpressions.Design#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/lookahead2.vb#3)]  
+  
+     正規表現パターン `\b(?!non)\w+\b` は、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |----------|--------|  
+    |`\b`|ワード境界から照合を開始します。|  
+    |`(?!non)`|先読みして、現在の文字列が "non" で始まらないことを確認します。  "non" で始まる場合は、一致と見なされません。|  
+    |`(\w+)`|1 つ以上の単語文字に一致します。|  
+    |`\b`|ワード境界で照合を終了します。|  
+  
+     否定先読みアサーションの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   条件付き評価: `(?(`*expression*`)`*yes* `|` *no* `)` および `(?(`*name*`)`*yes* `|` *expression* は照合する部分式の*no*`)`は、*name* キャプチャ グループの名前です *expression* が一致しない場合、または *name* が空でない有効なキャプチャ グループの場合に *name* が空でない有効なキャプチャ グループと一致するか、*no* は照合する部分式で *expression* である場合 *yes* は一致する文字列です。  この機能により、エンジンは直前の部分式の一致結果またはゼロ幅アサーションの結果に従って、複数の代替パターンを使用した検索を実行できます。  そのため、より強力な前方参照が可能になります。たとえば、直前の部分式が一致したかどうかに基づいて部分式を照合できます。  次の例の正規表現は、パブリック使用と内部使用の両方を目的とした段落と一致します。  内部使用のみを目的とした段落は `<PRIVATE>` タグで始まります。  正規表現パターン `^(?<Pvt>\<PRIVATE\>\s)?(?(Pvt)((\w+\p{P}?\s)+)|((\w+\p{P}?\s)+))\r?$` は、条件付き評価を使用して、パブリック使用と内部使用を目的とした段落の内容を別のキャプチャ グループに代入します。  これらの段落は、異なる方法で処理できます。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/conditional1.cs#4)]
+     [!code-vb[Conceptual.RegularExpressions.Design#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/conditional1.vb#4)]  
+  
+     正規表現パターンは、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |----------|--------|  
+    |`^`|行の先頭から照合を開始します。|  
+    |`(?<Pvt>\<PRIVATE\>\s)?`|文字列 `<PRIVATE>` の後に空白文字が続くパターンの 0 回以上の出現と一致します。  一致を `Pvt` という名前のキャプチャ グループに代入します。|  
+    |`(?(Pvt)((\w+\p{P}?\s)+)`|`Pvt` キャプチャ グループが存在する場合は、1 個以上の単語文字の後に 0 個または 1 個の区切り記号と 1 つの空白文字が続くパターンの 1 回以上の出現と一致します。  部分文字列を最初のキャプチャ グループに代入します。|  
+    |`&#124;((\w+\p{P}?\s)+))`|`Pvt` キャプチャ グループが存在しない場合は、1 個以上の単語文字の後に 0 個または 1 個の区切り記号と 1 つの空白文字が続くパターンの 1 回以上の出現と一致します。  部分文字列を 3 番目のキャプチャ グループに代入します。|  
+    |`\r?$`|行末または文字列の末尾と一致します。|  
+  
+     条件付き評価の詳細については、「[代替構成体](../../../docs/standard/base-types/alternation-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   グループ定義の均等化: `(?<`*name1*`-`*name2*`>`*subexpression*`)`。  この機能により、正規表現エンジンは、かっこや左右の角かっこなどの入れ子になった構成体を追跡できます。  例については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   非バックトラッキング部分式 \(別名最長一致部分式\) : `(?>`*subexpression*`)`。  この機能により、バックトラッキング エンジンは、部分式と最初に一致した文字列だけを確実に検索できるようになります。この場合、表現は、部分式を含む表現とは関係ないように処理されます。  この構成体を使用しない場合は、より大きな正規表現によるバックトラッキング検索時に、部分式の動作が変化する可能性があります。  たとえば、正規表現 `(a+)\w` は 1 つ以上の "a" 文字を、一連の "a" 文字に続く単語文字と共に照合し、一連の "a" 文字を最初のキャプチャ グループに代入します。ただし、入力文字列の最後の文字も "a" の場合は、`\w` 言語要素によって照合し、キャプチャ グループには含められません。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/nonbacktracking2.cs#7)]
+     [!code-vb[Conceptual.RegularExpressions.Design#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/nonbacktracking2.vb#7)]  
+  
+     正規表現 `((?>a+))\w` ではこの動作は回避されます。  連続するすべての "a" 文字はバックトラッキングなしで照合されるため、最初のキャプチャ グループにはすべての連続する "a" 文字が含まれます。  "a" 文字の後に "a" 以外の文字が少なくとも 1 つ続かない場合は、一致と見なされません。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/nonbacktracking1.cs#8)]
+     [!code-vb[Conceptual.RegularExpressions.Design#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/nonbacktracking1.vb#8)]  
+  
+     非バックトラッキング部分式の詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> クラス コンストラクターまたは静的インスタンス一致メソッドに <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを指定することで指定される右から左への一致。  この機能は、左から右ではなく右から左に向かって検索する場合や、パターンの左側ではなく右側で検索を開始した方が効果的な場合に便利です。  次の例に示すように、右から左への一致を使用すると、最長一致の量指定子の動作を変更できます。  例では、数字で終わる文に対して 2 つの検索を実行します。  最長一致の量指定子 `+` を使用する左から右への検索は、文中の 6 桁の 1 つと一致しますが、右から左への検索は 6 桁すべてと一致します。  正規表現パターンの説明については、このセクションで前に示した最短一致の量指定子の例を参照してください。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/rtl1.cs#6)]
+     [!code-vb[Conceptual.RegularExpressions.Design#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/rtl1.vb#6)]  
+  
+     右から左への一致の詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。  
+  
+-   正の数値、負のな後読み: 正の後読みの `(?<=`*subexpression*`)`、負のな後読みの `(?<!`*subexpression*`)`。  この機能は、このトピックで前に説明した先読みと同様です。  この正規表現エンジンを使用すると完全な右から左への一致を実行できるため、制限のない後読みが可能になります。  正と負の後読みを使用して、入れ子になった部分式が外側の式のスーパーセットである場合に入れ子の量指定子を回避することもできます。  このような入れ子の量指定子の正規表現は、多くの場合にパフォーマンスを低下させます。  たとえば、次の例では、文字列が英数字で始まって英数字で終わることと、文字列内の他の文字がより大きなサブセットの 1 つでないことを検証します。  電子メール アドレスの検証に使用される正規表現の一部を形成します。詳細については、「[方法 : 文字列が有効な電子メール形式であるかどうかを検証する](../../../docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md)」を参照してください。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.Design#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.design/cs/lookbehind1.cs#5)]
+     [!code-vb[Conceptual.RegularExpressions.Design#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.design/vb/lookbehind1.vb#5)]  
+  
+     正規表現 `^[A-Z0-9]([-!#$%&'.*+/=?^`{}|~\w])*(?<=[A-Z0-9])$` は、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |----------|--------|  
+    |`^`|文字列の先頭から照合を開始します。|  
+    |`[A-Z0-9]`|任意の英数字と一致します。\(比較では、大文字と小文字を区別しません\)。|  
+    |`([-!#$%&'.*+/=?^`{}&#124;~\w])*`|単語文字のゼロ以上の発生、または次の文字:  \-、\!、\#、$、%、&"。、\*、\+、\/、\= か。、^、\`、{、} &#124;、~。|  
+    |`(?<=[A-Z0-9])`|前の文字を後読みします。これは数字または英数字である必要があります \(比較では、大文字と小文字を区別しません\)。|  
+    |`$`|入力文字列の末尾で照合を終了します。|  
+  
+     正と負の後読みの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)|正規表現のバックトラッキングを使用して、分岐処理によって別の一致を検索する方法について説明します。|  
+|[コンパイルと再利用](../../../docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md)|パフォーマンスを向上させるための正規表現のコンパイルと再利用について説明します。|  
+|[スレッド セーフ](../../../docs/standard/base-types/thread-safety-in-regular-expressions.md)|正規表現のスレッド セーフと、正規表現オブジェクトへのアクセスを同期することが必要なケースについて説明します。|  
+|[.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)|正規表現のプログラミング言語的な面の概要について説明します。|  
+|[正規表現のオブジェクト モデル](../../../docs/standard/base-types/the-regular-expression-object-model.md)|正規表現クラスの使用方法について詳しく説明し、コードの例を示します。|  
+|[正規表現の例](../../../docs/standard/base-types/regular-expression-examples.md)|一般的なアプリケーションで正規表現を使用するときのコード例を示します。|  
+|[正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)|正規表現を定義するために使用できる一連の文字、演算子、および構成体について説明します。|  
+  
+## 参照  
+ <xref:System.Text.RegularExpressions?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/base-types/enumeration-format-strings.md b/docs/standard/base-types/enumeration-format-strings.md
new file mode 100644
index 00000000000..5b38972a54f
--- /dev/null
+++ b/docs/standard/base-types/enumeration-format-strings.md
@@ -0,0 +1,56 @@
+---
+title: "列挙型書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙型書式指定文字列"
+  - "書式指定子, 列挙型書式指定文字列"
+  - "書式指定 [.NET Framework], 列挙型"
+ms.assetid: dd1ff672-1052-42cf-8666-4924fb6cd1a1
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 列挙型書式指定文字列
+<xref:System.Enum.ToString%2A?displayProperty=fullName> メソッドを使用すると、列挙型のメンバーの数値、16 進数値、または文字列値を表す新しい文字列オブジェクトを作成できます。  `ToString` メソッドでは、返す値を指定するために列挙型書式指定文字列が使用されます。  
+  
+ 列挙型書式指定文字列と、各書式指定文字列が返す値の一覧を次の表に示します。  列挙型書式指定子では、大文字と小文字は区別されません。  
+  
+|書式指定文字列|結果|  
+|-------------|--------|  
+|G または g|列挙型エントリを文字列値として表示できる場合は、文字列値として表示されます。文字列値として表示できない場合には、現在のインスタンスの整数値が表示されます。  **Flags** 属性が設定されており、これによって列挙型が定義されている場合には、有効な各エントリの文字列値がコンマで区切られた形式で連結されます。  **Flags** 属性が設定されていない場合には、無効な値が数値エントリとして表示されます。  G 書式指定子の例を次に示します。<br /><br /> [!code-csharp[Formatting.Enum#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#1)]
+ [!code-vb[Formatting.Enum#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#1)]|  
+|F または f|列挙エントリを文字列値として表示できる場合には、文字列値として表示されます。  **Flags** 属性がない場合でも、列挙値の各エントリの合計値として値を完全に表示できる場合には、有効な各エントリの文字列値が、コンマで区切った形式で連結されます。  列挙エントリによって値を完全に決定できない場合は、この値は整数値として書式指定されます。  F 書式指定子の例を次に示します。<br /><br /> [!code-csharp[Formatting.Enum#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#2)]
+ [!code-vb[Formatting.Enum#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#2)]|  
+|D または d|列挙エントリが、表現可能な最も短い整数値として表示されます。  D 書式指定子の例を次に示します。<br /><br /> [!code-csharp[Formatting.Enum#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#3)]
+ [!code-vb[Formatting.Enum#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#3)]|  
+|X または x|列挙エントリが 16 進数値として表示されます。  最小桁数である 8 桁で値を表示するため、必要に応じて先行ゼロが埋め込まれます。  X 書式指定子の例を次に示します。<br /><br /> [!code-csharp[Formatting.Enum#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#4)]
+ [!code-vb[Formatting.Enum#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#4)]|  
+  
+## 例  
+ `Red`、`Blue`、および `Green` の 3 つのエントリから成る `Colors` という列挙型を定義する例を次に示します。  
+  
+ [!code-csharp[Formatting.Enum#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#5)]
+ [!code-vb[Formatting.Enum#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#5)]  
+  
+ 列挙値の定義が完了したら、次の方法でインスタンスを宣言できます。  
+  
+ [!code-csharp[Formatting.Enum#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#6)]
+ [!code-vb[Formatting.Enum#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#6)]  
+  
+ その後、`Color.ToString(System.String)` メソッドを使用して、それに渡される書式指定子に応じてさまざまな方法で列挙値を表示できます。  
+  
+ [!code-csharp[Formatting.Enum#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Enum/cs/enum1.cs#7)]
+ [!code-vb[Formatting.Enum#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Enum/vb/enum1.vb#7)]  
+  
+## 参照  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/formatting-types.md b/docs/standard/base-types/formatting-types.md
index a3c9369fa51..351b434e000 100644
--- a/docs/standard/base-types/formatting-types.md
+++ b/docs/standard/base-types/formatting-types.md
@@ -1,1404 +1,428 @@
 ---
-title: "型の書式設定"
-description: "型の書式設定"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: cf497639-9f91-45cb-836f-998d1cea2f43
-translationtype: Human Translation
-ms.sourcegitcommit: b967d8e55347f44a012e4ad8e916440ae228c8ec
-ms.openlocfilehash: e9b8ad13a48dd43236769b130d6f8a75b7b023ca
-ms.lasthandoff: 03/10/2017
-
----
-
-# <a name="formatting-types"></a>型の書式設定
-
-書式設定とはクラス、構造体、または列挙値のインスタンスを文字列形式に変換するプロセスのことで、多くの場合、変換した文字列をユーザーに表示したり、逆シリアル化して元のデータ型を復元したりするために行います。 この変換には次のような問題がある場合があります。
-
-* 値の内部での格納方法に、ユーザーが望む表示方法が反映されない場合がある。 たとえば、電話番号が **8009999999** という形式で格納されることがあります。これではユーザーにはわかりにくいため、 代わりに **800-999-9999** と表示する必要があります。 数値をこのように書式指定する例については、「[カスタム書式指定文字列](#custom-format-strings)」を参照してください。 
-
-* オブジェクトから文字列形式への変換が直観的に理解しづらい場合がある。 たとえば、**Temperature** オブジェクトや **Person** オブジェクトの文字列形式がどのようになるのか、明確ではありません。 **Temperature** オブジェクトをさまざまな方法で書式指定する例については、「[標準書式指定文字列](#standard-format-strings)」を参照してください。
-
-* 通常、カルチャ依存の書式指定が必要になる。 たとえば、通貨値を数字で表すアプリケーションでは、数値文字列にカルチャ別の通貨記号、桁区切り記号 (ほとんどのカルチャでは 1000 単位)、および小数点を含める必要があります。 例については、「[書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定](#culture-sensitive-formatting-with-format-providers-and-the-iformatprovider-interface)」を参照してください。 
-
-* アプリケーションによっては、同じ値をさまざまな方法で表示する必要がある。 たとえば、列挙型のメンバーを表すために、その名前の文字列形式を表示する場合や、基になる値を表示する場合が考えられます。 [DayOfWeek](xref:System.DayOfWeek) 列挙体のメンバーをさまざまな方法で書式指定する例については、「[標準書式指定文字列](#standard-format-strings)」を参照してください。
-
-.NET は書式設定機能が充実しているため、開発者はこうした要件を満たすことができます。 
-
+title: ".NET Framework における型の書式設定 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データの書式設定 [.NET Framework]"
+  - "日付 [.NET Framework]、書式設定"
+  - "日付の書式設定 [.NET Framework]"
+  - "数値の書式指定 [.NET Framework]"
+  - "ToString メソッド"
+  - "カスタム カルチャ文字列 [.NET Framework]"
+  - "数値 [.NET Framework]、書式設定"
+  - "書式指定 (文字列の) [.NET Framework]"
+  - "時刻 [.NET Framework]、書式設定"
+  - "通貨 [.NET Framework]、書式設定"
+  - "型 [.NET Framework]、書式設定"
+  - "書式指定子 [.NET Framework]"
+  - "時刻 [.NET Framework]、書式設定"
+  - "カルチャ [.NET Framework]、書式設定"
+  - "書式指定 [.NET Framework]、サポートされる型"
+  - "基本型 [.NET Framework]、書式設定"
+  - "カスタム書式指定 [.NET Framework]"
+  - "文字列 [.NET Framework]、書式設定"
+ms.assetid: 0d1364da-5b30-4d42-8e6b-03378343343f
+caps.latest.revision: 43
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 43
+---
+# .NET Framework における型の書式設定
+<a name="Introduction"></a> 書式設定とはクラス、構造体、または列挙値のインスタンスを文字列形式に変換するプロセスのことで、多くの場合、変換した文字列をユーザーに表示したり、逆シリアル化して元のデータ型を復元したりするために行います。 この変換には次のような問題がある場合があります。  
+  
+-   値の内部での格納方法に、ユーザーが望む表示方法が反映されない場合がある。 たとえば、電話番号が 8009999999 という形式で格納されることがあります。これではユーザーにはわかりにくいため、 代わりに 800\-999\-9999 と表示する必要があります。 数値をこのように書式指定する例については、「[カスタム書式指定文字列](#customStrings)」を参照してください。  
+  
+-   オブジェクトから文字列形式への変換が直観的に理解しづらい場合がある。 たとえば、Temperature オブジェクトや Person オブジェクトの文字列形式がどのようになるのか、明確ではありません。 Temperature オブジェクトをさまざまな方法で書式指定する例については、「[標準書式指定文字列](#standardStrings)」を参照してください。  
+  
+-   通常、カルチャ依存の書式指定が必要になる。 たとえば、通貨値を数字で表すアプリケーションでは、数値文字列にカルチャ別の通貨記号、桁区切り記号 \(ほとんどのカルチャでは 1000 単位\)、および小数点を含める必要があります。 例については、「[書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定](#FormatProviders)」を参照してください。  
+  
+-   アプリケーションによっては、同じ値をさまざまな方法で表示する必要がある。 たとえば、列挙型のメンバーを表すために、その名前の文字列形式を表示する場合や、基になる値を表示する場合が考えられます。<xref:System.DayOfWeek> 列挙体のメンバーをさまざまな方法で書式指定する例については、「[標準書式指定文字列](#standardStrings)」を参照してください。  
+  
 > [!NOTE]
-> 書式設定は型の値を文字列形式に変換します。 解析は書式設定の逆の操作で、 文字列形式からデータ型のインスタンスを作成します。 他のデータ型への文字列の変換については、「[文字列の解析](parsing-strings.md)」を参照してください。
-
-この概要は、次のセクションで構成されています。
-
-* [.NET での書式設定](#formatting-in-net)
-
-* [ToString メソッドを使用した既定の書式設定](#default-formatting-using-the-tostring-method)
-
-* [ToString メソッドのオーバーライド](#overriding-the-tostring-method)
-
-* [ToString メソッドと書式指定文字列](#the-tostring-method-and-format-strings)
-
-    * [標準の書式指定文字列](#standard-format-strings)
-    
-    * [カスタム書式指定文字列](#custom-format-strings)
-    
-    * [書式指定文字列と .NET 型](#format-strings-and-net-types)
-    
-* [書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定](#culture-sensitive-formatting-with-format-providers-and-the-iformatprovider-interface)
-
-    * [数値のカルチャに依存した書式設定](#culture-sensitive-formatting-of-numeric-values)
-    
-    * [日付と時刻の値のカルチャに依存した書式設定](#culture-sensitive-formatting-of-date-and-time-values)
-    
-* [IFormattable インターフェイス](#the-iformattable-interface)
-
-* [複合書式指定](#composite-formatting)
-
-* [ICustomFormatter を使用したカスタム書式設定](#custom-formatting-with-icustomformatter)
-
-* [関連トピック](#related-topics)
-
-* [参照](#reference)
-
-## <a name="formatting-in-net"></a>.NET での書式設定
-
-基本的な書式設定の方式は、[Object.ToString](xref:System.Object.ToString) メソッドによって既定として実装されます。このメソッドについては、このトピックの「[ToString メソッドを使用した既定の書式設定](#default-formatting-using-the-tostring-method)」のセクションを参照してください。 ただし、.NET には、この既定の書式設定機能を変更および拡張する方法がいくつかあります。 次に例を示します。
-
-* [Object.ToString](xref:System.Object.ToString) メソッドをオーバーライドして、オブジェクトの値のカスタム文字列形式を定義する方法。 詳細については、このトピックの「[ToString メソッドのオーバーライド](#overriding-the-tostring-method)」のセクションを参照してください。
-
-* オブジェクトの値の文字列形式に複数の形式を持たせる書式指定子を定義する方法。 たとえば、次のステートメントでは "X" 書式指定子を使用して整数を 16 進値の文字列形式に変換します。
-
-  ```csharp
-  int integerValue = 60312;
-  Console.WriteLine(integerValue.ToString("X"));   // Displays EB98.
-  ```
-
-  ```vb
-  Dim integerValue As Integer = 60312
-  Console.WriteLine(integerValue.ToString("X"))   ' Displays EB98.
-  ```
-  
-  書式指定子の詳細については、「[ToString メソッドと書式指定文字列](#the-tostring-method-and-format-strings)」のセクションを参照してください。
-  
-* 書式プロバイダーを使用して、特定のカルチャの書式指定規則を利用する方法。 たとえば、次のステートメントでは en-US カルチャの書式指定規則を使用して通貨値を表示します。 
-
-  ```csharp
-  double cost = 1632.54; 
-  Console.WriteLine(cost.ToString("C", 
-                  new System.Globalization.CultureInfo("en-US")));   
-  // The example displays the following output:
-  //       $1,632.54
-  ```
-
-  ```vb
-  Dim cost As Double = 1632.54
-  Console.WriteLine(cost.ToString("C", New System.Globalization.CultureInfo("en-US")))
-  ' The example displays the following output:
-  '       $1,632.54
-  ```
-  
-  書式プロバイダーを使用した書式設定の詳細については、「[書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定](#culture-sensitive-formatting-with-format-providers-and-the-iformatprovider-interface)」のセクションを参照してください。  
-  
-* [IFormattable](xref:System.IFormattable) インターフェイスを実装して、[Convert](xref:System.Convert) クラスによる文字列変換と複合書式指定の両方をサポートする方法。 詳細については、「[IFormattable インターフェイス](#the-iformattable-interface)」のセクションを参照してください。
-
-* 複合書式指定を使用して、値の文字列形式を大きな文字列に埋め込む方法。 詳細については、「[複合書式指定](#composite-formatting)」のセクションを参照してください。
-
-* [ICustomFormatter](xref:System.ICustomFormatter) および [IFormatProvider](xref:System.IFormatProvider) を実装して、完全なカスタム書式設定ソリューションを提供する方法。 詳細については、「[ICustomFormatter を使用したカスタム書式設定](#custom-formatting-with-icustomformatter)」のセクションを参照してください。
-
-以降のセクションでは、オブジェクトを文字列形式に変換するこれらの方法について説明します。
-
-## <a name="default-formatting-using-the-tostring-method"></a>ToString メソッドを使用した既定の書式設定
-
-[System.Object](xref:System.Object) から派生したすべての型は、既定で型の名前を返す、パラメーターなしの [ToString](xref:System.Object.ToString) メソッドを自動的に継承します。 既定の [ToString](xref:System.Object.ToString) メソッドの例を次に示します。 このコード例では、実装を持たない `Automobile` という名前のクラスを定義します。 このクラスがインスタンス化され、[ToString](xref:System.Object.ToString) メソッドが呼び出されると、その型の名前が表示されます。 サンプルでは、[ToString](xref:System.Object.ToString) メソッドが明示的に呼び出されないことに注意してください。 [Console.WriteLine(Object)](xref:System.Console.WriteLine(System.Object)) メソッドは引数として渡されたオブジェクトの [ToString](xref:System.Object.ToString) メソッドを暗黙的に呼び出します。 
-
-```csharp
-using System;
-
-public class Automobile
-{
-   // No implementation. All members are inherited from Object.
-}
-
-public class Example
-{
-   public static void Main()
-   {
-      Automobile firstAuto = new Automobile();
-      Console.WriteLine(firstAuto);
-   }
-}
-// The example displays the following output:
-//       Automobile
-```
-
-```vb 
-Public Class Automobile
-   ' No implementation. All members are inherited from Object.
-End Class
-
-Module Example
-   Public Sub Main()
-      Dim firstAuto As New Automobile()
-      Console.WriteLine(firstAuto)
-   End Sub
-End Module
-' The example displays the following output:
-'       Automobile
-```
-
-インターフェイス以外の型はすべて [Object](xref:System.Object) から派生するため、この機能はカスタムのクラスまたは構造体に自動的に提供されます。 ただし、既定の [ToString](xref:System.Object.ToString) メソッドによって提供される機能には制限があり、型の識別は行いますが、型のインスタンスに関する情報は提供しません。 それ自体に関する情報を提供するオブジェクトの文字列形式を提供するには、[ToString](xref:System.Object.ToString) メソッドをオーバーライドする必要があります。
-
+>  書式設定は型の値を文字列形式に変換します。 解析は書式設定の逆の操作で、 文字列形式からデータ型のインスタンスを作成します。 他のデータ型への文字列の変換については、「[文字列の解析](../../../docs/standard/base-types/parsing-strings.md)」を参照してください。  
+  
+ .NET Framework は書式設定機能が充実しているため、開発者はこうした要件を満たすことができます。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [.NET Framework における書式設定](#NetFormatting)  
+  
+-   [ToString メソッドを使用した既定の書式設定](#DefaultToString)  
+  
+-   [ToString メソッドのオーバーライド](#OverrideToString)  
+  
+-   [ToString メソッドと書式指定文字列](#FormatStrings)  
+  
+    -   [標準書式指定文字列](#standardStrings)  
+  
+    -   [カスタム書式指定文字列](#customStrings)  
+  
+    -   [書式指定文字列と .NET Framework クラス ライブラリ型](#stringRef)  
+  
+-   [書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定](#FormatProviders)  
+  
+    -   [数値のカルチャに依存した書式設定](#numericCulture)  
+  
+    -   [日付と時刻の値のカルチャに依存した書式設定](#dateCulture)  
+  
+-   [IFormattable インターフェイス](#IFormattable)  
+  
+-   [複合書式指定](#CompositeFormatting)  
+  
+-   [ICustomFormatter を使用したカスタム書式設定](#Custom)  
+  
+-   [関連トピック](#RelatedTopics)  
+  
+-   [参照](#Reference)  
+  
+<a name="NetFormatting"></a>   
+## .NET Framework における書式設定  
+ 基本的な書式設定の方式は、<xref:System.Object.ToString%2A?displayProperty=fullName> メソッドによって既定として実装されます。このメソッドについては、このトピックの「[ToString メソッドを使用した既定の書式設定](#DefaultToString)」のセクションを参照してください。 ただし、.NET Framework には、この既定の書式設定機能を変更および拡張する方法がいくつかあります。 次に例を示します。  
+  
+-   <xref:System.Object.ToString%2A?displayProperty=fullName> メソッドをオーバーライドして、オブジェクトの値のカスタム文字列形式を定義する方法。 詳細については、このトピックの「[ToString メソッドのオーバーライド](#OverrideToString)」のセクションを参照してください。  
+  
+-   オブジェクトの値の文字列形式に複数の形式を持たせる書式指定子を定義する方法。 たとえば、次のステートメントでは "X" 書式指定子を使用して整数を 16 進値の文字列形式に変換します。  
+  
+     [!code-csharp[Conceptual.Formatting.Overview#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/specifier1.cs#3)]
+     [!code-vb[Conceptual.Formatting.Overview#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/specifier1.vb#3)]  
+  
+     書式指定子の詳細については、「[ToString メソッドと書式指定文字列](#FormatStrings)」のセクションを参照してください。  
+  
+-   書式プロバイダーを使用して、特定のカルチャの書式指定規則を利用する方法。 たとえば、次のステートメントでは en\-US カルチャの書式指定規則を使用して通貨値を表示します。  
+  
+     [!code-csharp[Conceptual.Formatting.Overview#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/specifier1.cs#10)]
+     [!code-vb[Conceptual.Formatting.Overview#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/specifier1.vb#10)]  
+  
+     書式プロバイダーを使用した書式設定の詳細については、「[書式プロバイダーおよび IFormatProvider インターフェイス](#FormatProviders)」のセクションを参照してください。  
+  
+-   <xref:System.IFormattable> インターフェイスを実装して、<xref:System.Convert> クラスによる文字列変換と複合書式指定の両方をサポートする方法。 詳細については、「[IFormattable インターフェイス](#IFormattable)」のセクションを参照してください。  
+  
+-   複合書式指定を使用して、値の文字列形式を大きな文字列に埋め込む方法。 詳細については、「[複合書式指定](#CompositeFormatting)」のセクションを参照してください。  
+  
+-   <xref:System.ICustomFormatter> および <xref:System.IFormatProvider> を実装して、完全なカスタム書式設定ソリューションを提供する方法。 詳細については、「[ICustomFormatter を使用したカスタム書式設定](#Custom)」のセクションを参照してください。  
+  
+ 以降のセクションでは、オブジェクトを文字列形式に変換するこれらの方法について説明します。  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="DefaultToString"></a>   
+## ToString メソッドを使用した既定の書式設定  
+ <xref:System.Object?displayProperty=fullName> から派生したすべての型は、既定で型の名前を返す、パラメーターなしの `ToString` メソッドを自動的に継承します。 既定の `ToString` メソッドの例を次に示します。 このコード例では、実装を持たない `Automobile` という名前のクラスを定義します。 このクラスがインスタンス化され、`ToString` メソッドが呼び出されると、その型の名前が表示されます。 サンプルでは、`ToString` メソッドが明示的に呼び出されないことに注意してください。<xref:System.Console.WriteLine%28System.Object%29?displayProperty=fullName> メソッドは引数として渡されたオブジェクトの `ToString` メソッドを暗黙的に呼び出します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/default1.cs#1)]
+ [!code-vb[Conceptual.Formatting.Overview#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/default1.vb#1)]  
+  
+> [!WARNING]
+>  [!INCLUDE[win81](../../../includes/win81-md.md)] 以降、[!INCLUDE[wrt](../../../includes/wrt-md.md)]には、既定の書式指定をサポートする単一のメソッド [IStringable.ToString](http://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.tostring.aspx) を備えた [IStringable](http://msdn.microsoft.com/library/windows/apps/windows.foundation.istringable.aspx) インターフェイスが含まれています。 ただし、マネージ型では `IStringable` インターフェイスを実装しないことをお勧めします。 詳細については、[!INCLUDE[wrt](../../../includes/wrt-md.md)] リファレンス ページの「The `IStringable` and the <xref:System.Object.ToString%2A?displayProperty=fullName> Interface \(Windows ランタイムと IStringable インターフェイス\)」を参照してください。  
+  
+ インターフェイス以外の型はすべて <xref:System.Object> から派生するため、この機能はカスタムのクラスまたは構造体に自動的に提供されます。 ただし、既定の `ToString` メソッドによって提供される機能には制限があり、型の識別は行いますが、型のインスタンスに関する情報は提供しません。 それ自体に関する情報を提供するオブジェクトの文字列形式を提供するには、`ToString` メソッドをオーバーライドする必要があります。  
+  
 > [!NOTE]
-> 構造体は、[Object](xref:System.Object) から派生した [ValueType](xref:System.ValueType) を継承します。 [ValueType](xref:System.ValueType) は [Object.ToString](xref:System.Object.ToString) をオーバーライドしますが、その実装は同じです。
-
-## <a name="overriding-the-tostring-method"></a>ToString メソッドのオーバーライド
-
-型の名前の表示は用途が限定され、型のコンシューマー側でインスタンスを別のインスタンスと区別することはできません。 ただし、[ToString](xref:System.Object.ToString) メソッドをオーバーライドして、より役に立つオブジェクトの値の形式を作成することができます。 次の例では `Temperature` オブジェクトを定義し、その [ToString](xref:System.Object.ToString) メソッドをオーバーライドして、温度を摂氏で表示します。
-
-```csharp
-using System;
-
-public class Temperature
-{
-   private decimal temp;
-
-   public Temperature(decimal temperature)
-   {
-      this.temp = temperature;   
-   }
-
-   public override string ToString()
-   {
-      return this.temp.ToString("N1") + "°C";
-   }
-}
-
-public class Example
-{
-   public static void Main()
-   {
-      Temperature currentTemperature = new Temperature(23.6m);
-      Console.WriteLine("The current temperature is " +
-                        currentTemperature.ToString());
-   }
-}
-// The example displays the following output:
-//       The current temperature is 23.6°C.
-```
-
-```vb
-Public Class Temperature
-   Private temp As Decimal
-
-   Public Sub New(temperature As Decimal)
-      Me.temp = temperature
-   End Sub
-
-   Public Overrides Function ToString() As String
-      Return Me.temp.ToString("N1") + "°C"   
-   End Function
-End Class
-
-Module Example
-   Public Sub Main()
-      Dim currentTemperature As New Temperature(23.6d)
-      Console.WriteLine("The current temperature is " +
-                        currentTemperature.ToString())
-   End Sub
-End Module
-' The example displays the following output:
-'       The current temperature is 23.6°C.
-```
-
-.NET では、各プリミティブ値型の [ToString](xref:System.Object.ToString) メソッドは名前の代わりにオブジェクトの値を表示するようにオーバーライドされています。 各プリミティブ型のオーバーライドを次の表に示します。 オーバーライドされているメソッドのほとんどは [ToString](xref:System.Object.ToString) メソッドの別のオーバーロードを呼び出し、それにその型の一般書式を定義する "G" 書式指定子と、現在のカルチャを表す [IFormatProvider](xref:System.IFormatProvider) オブジェクトを渡します。
-
-型 | ToString のオーバーライド
----- | -----------------
-[Boolean](xref:System.Boolean) | [Boolean.TrueString](xref:System.Boolean.TrueString) または [Boolean.FalseString](xref:System.Boolean.FalseString) のいずれかを返します。
-[Byte](xref:System.Byte) | `Byte.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Byte](xref:System.Byte) 値の書式設定をします。
-[Char](xref:System.Char) | 文字を文字列として返します。
-[DateTime](xref:System.DateTime) | `DateTime.ToString("G", DatetimeFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて日付と時刻の値の書式設定をします。 
-[Decimal](xref:System.Decimal) | `Decimal.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Decimal](xref:System.Decimal) 値の書式設定をします。
-[Double](xref:System.Double) | `Double.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Double](xref:System.Double) 値の書式設定をします。
-[Int16](xref:System.Int16) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Int16](xref:System.Int16) 値の書式設定をします。
-[Int32](xref:System.Int32) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Int32](xref:System.Int32) 値の書式設定をします。
-[Int64](xref:System.Int64) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Int64](xref:System.Int64) 値の書式設定をします。
-[SByte](xref:System.SByte) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて[SByte](xref:System.SByte) 値の | 書式設定をします。
-[Single](xref:System.Single) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [Single](xref:System.Single) 値の書式設定をします。
-[UInt32](xref:System.UInt32) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [UInt32](xref:System.UInt32) 値の書式設定をします。
-[UInt32](xref:System.UInt32) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [UInt32](xref:System.UInt32) 値の書式設定をします。
-[UInt64](xref:System.UInt64) | `Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて [UInt64](xref:System.UInt64) 値の書式設定をします。
-
-## <a name="the-tostring-method-and-format-strings"></a>ToString メソッドと書式指定文字列
-
-既定の [ToString](xref:System.Object.ToString) メソッドや [ToString](xref:System.Object.ToString) のオーバーライドの使用は、オブジェクトの文字列形式が 1 つの場合に適しています。 しかし、多くの場合オブジェクトの値には複数の形式があります。 たとえば、温度は華氏、摂氏、またはケルビンで表現できます。 また、整数値 10 は 10、10.0、1.0e01、$10.00 などの多くの方法で表すことができます。
-
-.NET では、書式指定文字列を使用することで、1 つの値に複数の文字列形式を持たせることができます。 書式指定文字列とは定義済みの書式指定子を 1 つ以上含む文字列です。書式指定子とは、[ToString](xref:System.Object.ToString) メソッドによるその出力の書式設定方法を定義する 1 文字または文字グループです。 書式指定文字列はパラメーターとしてオブジェクトの [ToString](xref:System.Object.ToString) メソッドに渡され、オブジェクトの値の文字列形式の表示方法を決定します。
-
-.NET では、すべての数値型、日付/時刻型、および列挙型で、定義済みの一連の書式指定子をサポートしています。 書式指定文字列を使用して、アプリケーションで定義されたデータ型の文字列形式を複数定義することもできます。
-
-### <a name="standard-format-strings"></a>標準の書式指定文字列
-
-標準書式指定文字列には、適用先のオブジェクトの文字列形式を定義する英字の単一の書式指定子と、結果文字列に表示される桁数に影響するオプションの精度指定子が含まれます。 精度指定子が省略されるかサポートされていない場合、標準書式指定子は標準書式指定文字列と同じになります。 
-
-.NET では、すべての数値型、すべての日付/時刻型、およびすべての列挙型に対して一連の標準書式指定子が定義されています。 たとえば、それらのカテゴリごとに、対応する型の値の一般的な文字列形式を定義する "G" 標準書式指定子がサポートされています。
-
-列挙型の標準書式指定文字列は、値の文字列形式を直接制御します。 列挙値の [ToString](xref:System.Object.ToString) メソッドに渡された書式指定文字列によって、文字列名 ("G" 書式指定子および "F" 書式指定子)、基になる整数値 ("D" 書式指定子)、または 16 進値 ("X" 書式指定子) のどの形式で値を表示するかが決定します。 次のコード例では、標準書式指定文字列を使用して、[DayOfWeek](xref:System.DayOfWeek) 列挙値の書式を設定する方法を示しています。 
-
-```csharp
-DayOfWeek thisDay = DayOfWeek.Monday;
-string[] formatStrings = {"G", "F", "D", "X"};
-
-foreach (string formatString in formatStrings)
-   Console.WriteLine(thisDay.ToString(formatString));
-// The example displays the following output:
-//       Monday
-//       Monday
-//       1
-//       00000001
-```
-
-```vb
-Dim thisDay As DayOfWeek = DayOfWeek.Monday
-Dim formatStrings() As String = {"G", "F", "D", "X"}
-
-For Each formatString As String In formatStrings
-   Console.WriteLine(thisDay.ToString(formatString))
-Next
-' The example displays the following output:
-'       Monday
-'       Monday
-'       1
-'       00000001
-```
-
-列挙型書式指定文字列については、「[列挙型書式指定文字列](enumeration-format.md)」を参照してください。
-
-数値型の標準書式指定文字列は、通常、表示される桁数が 1 つ以上のプロパティ値によって制御される結果文字列を定義します。 たとえば、"C" 書式指定子は数字を通貨値として書式設定します。 唯一のパラメーターとして "C" 書式指定子を渡して [ToString](xref:System.Object.ToString) メソッドを呼び出した場合、現在のカルチャの [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトの次のプロパティ値を使用して数値の文字列形式を定義します。
-
-* [CurrencySymbol](xref:System.Globalization.NumberFormatInfo.CurrencySymbol) プロパティ。現在のカルチャの通貨記号を指定します。
-
-* [CurrencyNegativePattern](xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern) プロパティまたは [CurrencyPositivePattern](xref:System.Globalization.NumberFormatInfo.CurrencyPositivePattern) プロパティ。次の情報を特定する整数を返します。 
-
-    * 通貨記号の位置。
-    
-    * 負の値を表すために、先頭の負の符号、末尾の負の符号、またはかっこのどれを使用するか。
-    
-    * 数値と通貨記号の間にスペース文字を表示するかどうか。
-    
-* [CurrencyDecimalDigits](xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits) プロパティ。結果文字列の小数点以下の桁数を定義します。
-
-* [CurrencyDecimalSeparator](xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator) プロパティ。結果文字列の小数点の記号を定義します。
-
-* [CurrencyGroupSeparator](xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator) プロパティ。桁区切り記号を定義します。
-
-* [CurrencyGroupSizes](xref:System.Globalization.NumberFormatInfo.CurrencyGroupSizes) プロパティ。整数部の各グループの桁数を定義します。
-
-* [NegativeSign](xref:System.Globalization.NumberFormatInfo.NegativeSign) プロパティ。かっこを使用せずに負の値を表す場合に結果文字列で使用する負の符号を決定します。
-
-さらに、数値書式指定文字列には、精度指定子が含まれる場合があります。 この指定子の意味は一緒に使用される書式指定文字列によって異なりますが、通常は、結果文字列に表示される合計桁数か小数点以下の桁数を示します。 たとえば、次の例では、"X4" の標準数値文字列と精度指定子を使用して、4 桁の 16 進数から成る文字列値を作成します。
-
-```csharp
-byte[] byteValues = { 12, 163, 255 };
-foreach (byte byteValue in byteValues)
-   Console.WriteLine(byteValue.ToString("X4"));
-// The example displays the following output:
-//       000C
-//       00A3
-//       00FF
-```
-
-```vb
-Dim byteValues() As Byte = { 12, 163, 255 }
-For Each byteValue As Byte In byteValues
-   Console.WriteLine(byteValue.ToString("X4"))
-Next
-' The example displays the following output:
-'       000C
-'       00A3
-'       00FF
-```
-
-標準の数値書式指定文字列の詳細については、「[標準の数値書式指定文字列](standard-numeric.md)」を参照してください。 
-
-日付と時刻の値の標準書式指定文字列は、特定の [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) クラスに格納されているカスタム書式指定文字列のエイリアスです。 たとえば、"D" 書式指定子を渡して日付と時刻の値の [ToString](xref:System.Object.ToString) メソッドを呼び出すと、現在のカルチャの [DateTimeFormatInfo.LongDatePattern](xref:System.Globalization.DateTimeFormatInfo.LongDatePattern) プロパティに格納されているカスタム書式指定文字列を使用して日付と時刻が表示されます (カスタム書式指定文字列の詳細については、「[カスタム書式指定文字列](#custom-format-strings)」のセクションを参照してください)。この関係を次の例に示します。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      DateTime date1 = new DateTime(2017, 6, 30);
-      Console.WriteLine("D Format Specifier:     {0:D}", date1);
-      string longPattern = CultureInfo.CurrentCulture.DateTimeFormat.LongDatePattern;
-      Console.WriteLine("'{0}' custom format string:     {1}", 
-                        longPattern, date1.ToString(longPattern));
-   }
-}
-// The example displays the following output when run on a system whose
-// current culture is en-US:
-//    D Format Specifier:     Tuesday, June 30, 2017
-//    'dddd, MMMM dd, yyyy' custom format string:     Tuesday, June 30, 2017
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim date1 As Date = #6/30/2009#
-      Console.WriteLine("D Format Specifier:     {0:D}", date1)
-      Dim longPattern As String = CultureInfo.CurrentCulture.DateTimeFormat.LongDatePattern
-      Console.WriteLine("'{0}' custom format string:     {1}", _
-                        longPattern, date1.ToString(longPattern))
-   End Sub
-End Module
-' The example displays the following output when run on a system whose
-' current culture is en-US:
-'    D Format Specifier:     Tuesday, June 30, 2009
-'    'dddd, MMMM dd, yyyy' custom format string:     Tuesday, June 30, 2009
-```
-
-標準の日時書式指定文字列の詳細については、「[標準の日時書式指定文字列](standard-datetime.md)」を参照してください。
-
-また、標準書式指定文字列を使用して、オブジェクトの `ToString(String)` メソッドによって生成された、アプリケーション定義のオブジェクトの文字列形式を定義することもできます。 オブジェクトでサポートする特定の標準書式指定子を定義したり、それらで大文字と小文字を区別するかしないかを決定したりすることができます。 `ToString(String)` メソッドの実装で、以下がサポートされます。
-
-* オブジェクトの一般的な書式または共通の書式を表す "G" 書式指定子。 オブジェクトの `ToString` メソッドのパラメーターなしのオーバーロードで、その `ToString(String)` オーバーロードを呼び出し、それに "G" 標準書式指定文字列を渡します。
-
-* null 参照に相当する書式指定子。 null 参照に相当する書式指定子は "G" 書式指定子と同等に扱う必要があります。
-
-たとえば、`Temperature` クラスの場合、内部的には温度を摂氏で格納し、書式指定子を使用して `Temperature` オブジェクトの値を摂氏、華氏、およびケルビンで表すことができます。 具体的な例を次に示します。
-
-```csharp
-using System;
-
-public class Temperature
-{
-   private decimal m_Temp;
-
-   public Temperature(decimal temperature)
-   {
-      this.m_Temp = temperature;
-   }
-
-   public decimal Celsius
-   {
-      get { return this.m_Temp; }
-   }
-
-   public decimal Kelvin
-   {
-      get { return this.m_Temp + 273.15m; }   
-   }
-
-   public decimal Fahrenheit
-   {
-      get { return Math.Round(((decimal) (this.m_Temp * 9 / 5 + 32)), 2); }
-   }
-
-   public override string ToString()
-   {
-      return this.ToString("C");
-   }
-
-   public string ToString(string format)
-   {  
-      // Handle null or empty string.
-      if (String.IsNullOrEmpty(format)) format = "C";
-      // Remove spaces and convert to uppercase.
-      format = format.Trim().ToUpperInvariant();      
-
-      // Convert temperature to Fahrenheit and return string.
-      switch (format)
-      {
-         // Convert temperature to Fahrenheit and return string.
-         case "F":
-            return this.Fahrenheit.ToString("N2") + " °F";
-         // Convert temperature to Kelvin and return string.
-         case "K":
-            return this.Kelvin.ToString("N2") + " K";
-         // return temperature in Celsius.
-         case "G":
-         case "C":
-            return this.Celsius.ToString("N2") + " °C";
-         default:
-            throw new FormatException(String.Format("The '{0}' format string is not supported.", format));
-      }      
-   }
-}
-
-public class Example
-{
-   public static void Main()
-   {
-      Temperature temp1 = new Temperature(0m);
-      Console.WriteLine(temp1.ToString());
-      Console.WriteLine(temp1.ToString("G"));
-      Console.WriteLine(temp1.ToString("C"));
-      Console.WriteLine(temp1.ToString("F"));
-      Console.WriteLine(temp1.ToString("K"));
-
-      Temperature temp2 = new Temperature(-40m);
-      Console.WriteLine(temp2.ToString());
-      Console.WriteLine(temp2.ToString("G"));
-      Console.WriteLine(temp2.ToString("C"));
-      Console.WriteLine(temp2.ToString("F"));
-      Console.WriteLine(temp2.ToString("K"));
-
-      Temperature temp3 = new Temperature(16m);
-      Console.WriteLine(temp3.ToString());
-      Console.WriteLine(temp3.ToString("G"));
-      Console.WriteLine(temp3.ToString("C"));
-      Console.WriteLine(temp3.ToString("F"));
-      Console.WriteLine(temp3.ToString("K"));
-
-      Console.WriteLine(String.Format("The temperature is now {0:F}.", temp3));
-   }
-}
-// The example displays the following output:
-//       0.00 °C
-//       0.00 °C
-//       0.00 °C
-//       32.00 °F
-//       273.15 K
-//       -40.00 °C
-//       -40.00 °C
-//       -40.00 °C
-//       -40.00 °F
-//       233.15 K
-//       16.00 °C
-//       16.00 °C
-//       16.00 °C
-//       60.80 °F
-//       289.15 K
-//       The temperature is now 16.00 °C.
-```
-
-```vb
-Public Class Temperature
-   Private m_Temp As Decimal
-
-   Public Sub New(temperature As Decimal)
-      Me.m_Temp = temperature
-   End Sub
-
-   Public ReadOnly Property Celsius() As Decimal
-      Get
-         Return Me.m_Temp
-      End Get   
-   End Property
-
-   Public ReadOnly Property Kelvin() As Decimal
-      Get
-         Return Me.m_Temp + 273.15d   
-      End Get
-   End Property
-
-   Public ReadOnly Property Fahrenheit() As Decimal
-      Get
-         Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
-      End Get      
-   End Property
-
-   Public Overrides Function ToString() As String
-      Return Me.ToString("C")
-   End Function
-
-   Public Overloads Function ToString(format As String) As String  
-      ' Handle null or empty string.
-      If String.IsNullOrEmpty(format) Then format = "C"
-      ' Remove spaces and convert to uppercase.
-      format = format.Trim().ToUpperInvariant()      
-
-      Select Case format
-         Case "F"
-           ' Convert temperature to Fahrenheit and return string.
-            Return Me.Fahrenheit.ToString("N2") & " °F"
-         Case "K"
-            ' Convert temperature to Kelvin and return string.
-            Return Me.Kelvin.ToString("N2") & " K"
-         Case "C", "G"
-            ' Return temperature in Celsius.
-            Return Me.Celsius.ToString("N2") & " °C"
-         Case Else
-            Throw New FormatException(String.Format("The '{0}' format string is not supported.", format))
-      End Select      
-   End Function
-End Class
-
-Public Module Example
-   Public Sub Main()
-      Dim temp1 As New Temperature(0d)
-      Console.WriteLine(temp1.ToString())
-      Console.WriteLine(temp1.ToString("G"))
-      Console.WriteLine(temp1.ToString("C"))
-      Console.WriteLine(temp1.ToString("F"))
-      Console.WriteLine(temp1.ToString("K"))
-
-      Dim temp2 As New Temperature(-40d)
-      Console.WriteLine(temp2.ToString())
-      Console.WriteLine(temp2.ToString("G"))
-      Console.WriteLine(temp2.ToString("C"))
-      Console.WriteLine(temp2.ToString("F"))
-      Console.WriteLine(temp2.ToString("K"))
-
-      Dim temp3 As New Temperature(16d)
-      Console.WriteLine(temp3.ToString())
-      Console.WriteLine(temp3.ToString("G"))
-      Console.WriteLine(temp3.ToString("C"))
-      Console.WriteLine(temp3.ToString("F"))
-      Console.WriteLine(temp3.ToString("K"))
-
-      Console.WriteLine(String.Format("The temperature is now {0:F}.", temp3))
-   End Sub
-End Module
-' The example displays the following output:
-'       0.00 °C
-'       0.00 °C
-'       0.00 °C
-'       32.00 °F
-'       273.15 K
-'       -40.00 °C
-'       -40.00 °C
-'       -40.00 °C
-'       -40.00 °F
-'       233.15 K
-'       16.00 °C
-'       16.00 °C
-'       16.00 °C
-'       60.80 °F
-'       289.15 K
-'       The temperature is now 16.00 °C.
-```
-
-### <a name="custom-format-strings"></a>カスタム書式指定文字列
-
-.NET では、標準書式指定文字列のほかに、数値および日付と時刻の値の両方のカスタム書式指定文字列が定義されています。 カスタム書式指定文字列は、値の文字列形式を定義する 1 つ以上のカスタム書式指定子で構成されます。 たとえば、"yyyy/mm/dd hh:mm:ss.ffff t zzz" というカスタム日時書式指定文字列の場合、en-US カルチャでは日付が "2008/11/15 07:45:00.0000 P -08:00" という文字列形式に変換されます。 また、"0000" というカスタム書式指定文字列の場合、整数値 12 は "0012" に変換されます。 カスタム書式指定文字列の一覧については、「[カスタム日時書式指定文字列](custom-datetime.md)」および「[カスタム数値書式指定文字列](custom-numeric.md)」を参照してください。
-
-書式指定文字列が単一のカスタム書式指定子で構成される場合は、標準書式指定子と混同しないように、書式指定子の前にパーセント (%) 記号を付ける必要があります。 次の例では、"M" カスタム書式指定子を使用して、特定の日付の月を表す 1 桁または 2 桁の数値を表示します。
-
-```csharp
-DateTime date1 = new DateTime(2009, 9, 8);
-Console.WriteLine(date1.ToString("%M"));       
-// Displays 9
-```
-
-```vb
-Dim date1 As Date = #09/08/2009#
-Console.WriteLine(date1.ToString("%M"))      ' Displays 9
-```
-
-日付および時刻の値の標準書式指定文字列の多くは、[DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトのプロパティによって定義されているカスタム書式指定文字列のエイリアスです。 また、カスタム書式指定文字列を使用することで、数値または日付と時刻の値に対して、柔軟にアプリケーション定義の書式を指定できます。 複数のカスタム書式指定子を 1 つのカスタム書式指定文字列に結合することによって、数値および日付と時刻の値の両方に対するカスタムの結果文字列を独自に定義することができます。 次の例では、月の名前、日付、および年の後に、かっこで囲んで曜日を表示するカスタム書式指定文字列を定義しています。
-
-```csharp
-string customFormat = "MMMM dd, yyyy (dddd)";
-DateTime date1 = new DateTime(2009, 8, 28);
-Console.WriteLine(date1.ToString(customFormat));   
-// The example displays the following output if run on a system
-// whose language is English:
-//       August 28, 2009 (Friday) 
-```
-
-```vb
-Dim customFormat As String = "MMMM dd, yyyy (dddd)"
-Dim date1 As Date = #8/28/2009#
-Console.WriteLine(date1.ToString(customFormat))   
-' The example displays the following output if run on a system
-' whose language is English:
-'       August 28, 2009 (Friday) 
-```
-
-次の例では、[Int64](xref:System.Int64) 値を米国で標準的な 7 桁の電話番号を市外局番と共に表示するカスタム書式指定文字列を定義します。 
-
-```csharp
-using System;
-
-public class Example
-{
-   public static void Main()
-   {
-      long number = 8009999999;
-      string fmt = "000-000-0000";
-      Console.WriteLine(number.ToString(fmt));
-   }
-}
-// The example displays the following output:
-//        800-999-9999
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      Dim number As Long = 8009999999
-      Dim fmt As String = "000-000-0000"
-      Console.WriteLine(number.ToString(fmt))
-   End Sub
-End Module
-' The example displays the following output:
-
-' The example displays the following output:
-'       800-999-9999
-```
-
-一般には、アプリケーション定義の型に対する書式設定のほとんどのニーズに標準書式指定文字列を使用して対応できますが、カスタム書式指定子を定義して型の書式を設定することもできます。 
-
-### <a name="format-strings-and-net-types"></a>書式指定文字列と .NET 型
-
-すべての数値型 (つまり、[Byte](xref:System.Byte)、[Decimal](xref:System.Decimal)、[Double](xref:System.Double)、[Int16](xref:System.Int16)、[Int32](xref:System.Int32)、[Int64](xref:System.Int64)、[SByte](xref:System.SByte)、[Single](xref:System.Single)、[UInt16](xref:System.UInt16)、[UInt32](xref:System.UInt32)、[UInt64](xref:System.UInt64)、[BigInteger](xref:System.Numerics.BigInteger) 型)、および [DateTime](xref:System.DateTime)、[DateTimeOffset](xref:System.DateTimeOffset)、[TimeSpan](xref:System.TimeSpan)、[Guid](xref:System.Guid) と、すべての列挙型が書式指定文字列による書式設定に対応しています。 各型でサポートされている特定の書式指定文字列については、次のトピックを参照してください。 
-
-タイトル | 定義
------ | ----------
-[標準の数値書式指定文字列](standard-numeric.md) | 数値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。 
-[カスタム数値書式指定文字列](custom-numeric.md) | 数値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[標準の日時書式指定文字列](standard-datetime.md) | [DateTime](xref:System.DateTime) 値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。
-[カスタム日時書式指定文字列](custom-datetime.md) | [DateTime](xref:System.DateTime) 値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[標準 TimeSpan 書式指定文字列](standard-timespan.md) | 時間間隔に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。
-[カスタム TimeSpan 書式指定文字列](custom-timespan.md) | 時間間隔に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[列挙型書式指定文字列](enumeration-format.md) | 列挙型の文字列形式を作成するために使用される標準書式指定文字列について説明します。
-[Guid.ToString(String)](xref:System.Guid.ToString(System.String)) | [Guid](xref:System.Guid) 値の標準的書式指定文字列について説明します。
-
-## <a name="culture-sensitive-formatting-with-format-providers-and-the-iformatprovider-interface"></a>書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定
-
-書式指定子を利用することでオブジェクトの書式をカスタマイズできますが、多くの場合、意味のあるオブジェクトの文字列形式を生成するには追加の書式設定情報が必要です。 たとえば、"C" 標準書式指定文字列または "$ #,#.00" などのカスタム書式指定文字列を使用して数字を通貨値として書式設定する場合、少なくとも、正しい通貨記号、桁区切り記号、および小数点記号についての情報を書式設定された文字列に含めることができる必要があります。 .NET では、[IFormatProvider](xref:System.IFormatProvider) インターフェイスによって、この追加の書式設定情報を利用できるようにします。このインターフェイスは、数値型および日付/時刻型の `ToString` メソッドの 1 つ以上のオーバーロードに対するパラメーターとして提供されます。 [IFormatProvider](xref:System.IFormatProvider) の実装は .NET で使用され、カルチャ固有の書式指定をサポートします。 それぞれ異なるカルチャを示す 3 つの [IFormatProvider](xref:System.IFormatProvider) オブジェクトを使用してオブジェクトの書式を設定した場合に、その文字列形式がどのように変化するかを次の例に示します。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      decimal value = 1603.42m;
-      Console.WriteLine(value.ToString("C3", new CultureInfo("en-US")));
-      Console.WriteLine(value.ToString("C3", new CultureInfo("fr-FR")));
-      Console.WriteLine(value.ToString("C3", new CultureInfo("de-DE")));
-   }
-}
-// The example displays the following output:
-//       $1,603.420
-//       1 603,420 €
-//       1.603,420 €
-```
-
-```vb
-Imports System.Globalization
-
-Public Module Example
-   Public Sub Main()
-      Dim value As Decimal = 1603.42d
-      Console.WriteLine(value.ToString("C3", New CultureInfo("en-US")))
-      Console.WriteLine(value.ToString("C3", New CultureInfo("fr-FR")))
-      Console.WriteLine(value.ToString("C3", New CultureInfo("de-DE")))
-   End Sub
-End Module
-' The example displays the following output:
-'       $1,603.420
-'       1 603,420 €
-'       1.603,420 €
-```
-
-[IFormatProvider](xref:System.IFormatProvider) インターフェイスには、[GetFormat(Type)](xref:System.IFormatProvider.GetFormat(System.Type)) という 1 つのメソッドが含まれています。このメソッドには、書式設定情報を提供するオブジェクトの型を指定する 1 つのパラメーターがあります。 このメソッドがその型のオブジェクトを提供できる場合は、それが返されます。 それ以外の場合は、null 参照を返します。
-
-[IFormatProvider.GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) はコールバック メソッドです。 [IFormatProvider](xref:System.IFormatProvider) パラメーターを含む `ToString` メソッド オーバーロードを呼び出すと、その [IFormatProvider](xref:System.IFormatProvider) オブジェクトの [GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) メソッドが呼び出されます。 [GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) メソッドは、*formatType* パラメーターで指定された、必要な書式設定情報を提供するオブジェクトを `ToString` メソッドに返します。 
-
-数多くの書式指定メソッドや文字列変換メソッドに [IFormatProvider](xref:System.IFormatProvider) 型のパラメーターが含まれていますが、多くの場合、メソッドを呼び出すときはパラメーターの値は無視されます。 [IFormatProvider.GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) メソッドに渡される [Type](xref:System.Type) オブジェクトのパラメーターと型を使用する書式指定メソッドの一部を次の表に示します。 
-
-メソッド | *formatType* パラメーターの型
------- | ------------------------------
-数値型の `ToString` メソッド | [System.Globalization.NumberFormatInfo](xref:System.Globalization.NumberFormatInfo)
-日付/時刻型の `ToString` メソッド | [System.Globalization.DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo)
-[String.Format](xref:System.String.Format(System.IFormatProvider,System.String,System.Object)) | [System.ICustomFormatter](xref:System.ICustomFormatter)
-[StringBuilder.AppendFormat](xref:System.Text.StringBuilder.AppendFormat(System.IFormatProvider,System.String,System.Object)) | [System.ICustomFormatter](xref:System.ICustomFormatter)
-
-.NET には、[IFormatProvider](xref:System.IFormatProvider) を実装する次の 3 つのクラスが用意されています。 
-
-* [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo)。このクラスは、特定のカルチャの日付と時刻の値に対する書式設定情報を提供します。 対応する [IFormatProvider.GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) の実装では、それ自身のインスタンスが返されます。
-
-* [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo)。このクラスは、特定のカルチャの数値に対する書式設定情報を提供します。 対応する [IFormatProvider.GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) の実装では、それ自身のインスタンスが返されます。
-
-* [CultureInfo](xref:System.Globalization.CultureInfo)。 対応する [IFormatProvider.GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) の実装では、数値に対する書式設定情報を提供する [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトか、日付と時刻の値に対する書式設定情報を提供する [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトのいずれかが返されます。 
-
-また、これらのクラスのうちのいずれかを置き換える独自の書式プロバイダーを実装できます。 ただし、実装の `GetFormat` メソッドは、書式設定情報を `ToString` メソッドに渡す場合、前の表に示した型のオブジェクトを返す必要があります。
-
-### <a name="culture-sensitive-formatting-of-numeric-values"></a>数値のカルチャに依存した書式設定
-
-既定では、数値の書式指定はカルチャに依存します。 書式指定メソッドを呼び出すときにカルチャを指定しない場合は、現在のスレッド カルチャの書式指定規則が使用されます。 次に示す例では、現在のスレッド カルチャを 4 回変更した後に、[Decimal.ToString(String)](xref:System.Decimal.ToString(System.String)) メソッドを呼び出します。 各ケースでは、結果の文字列は、現在のカルチャの書式指定規則を反映します。 これは、各数値型の `ToString` メソッドへの呼び出しを、`ToString(String)` メソッドと `ToString(String, IFormatProvider)` メソッドがラップするためです。 
-
-```csharp
-using System;
-using System.Globalization;
-using System.Threading;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] cultureNames = { "en-US", "fr-FR", "es-MX", "de-DE" };
-      Decimal value = 1043.17m;
-
-      foreach (var cultureName in cultureNames) {
-         // Change the current thread culture.
-         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(cultureName);
-         Console.WriteLine("The current culture is {0}", 
-                           Thread.CurrentThread.CurrentCulture.Name);
-         Console.WriteLine(value.ToString("C2"));
-         Console.WriteLine();
-      }   
-   }
-}
-// The example displays the following output:
-//       The current culture is en-US
-//       $1,043.17
-//       
-//       The current culture is fr-FR
-//       1 043,17 €
-//       
-//       The current culture is es-MX
-//       $1,043.17
-//       
-//       The current culture is de-DE
-//       1.043,17 €
-```
-
-```vb
-Imports System.Globalization
-Imports System.Threading 
-
-Module Example
-   Public Sub Main()
-      Dim cultureNames() As String = { "en-US", "fr-FR", "es-MX", "de-DE" }
-      Dim value As Decimal = 1043.17d 
-
-      For Each cultureName In cultureNames
-         ' Change the current thread culture.
-         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(cultureName)
-         Console.WriteLine("The current culture is {0}", 
-                           Thread.CurrentThread.CurrentCulture.Name)
-         Console.WriteLine(value.ToString("C2"))
-         Console.WriteLine()
-      Next                  
-   End Sub
-End Module
-' The example displays the following output:
-'       The current culture is en-US
-'       $1,043.17
-'       
-'       The current culture is fr-FR
-'       1 043,17 €
-'       
-'       The current culture is es-MX
-'       $1,043.17
-'       
-'       The current culture is de-DE
-'       1.043,17 €
-```
-
-また、*provider* パラメーターを持つ `ToString` オーバーロードを呼び出して、次のどちらかを渡すことにより、特定カルチャの数値を書式指定することもできます。 
-
-* 使用される書式指定規則のカルチャを表す [CultureInfo](xref:System.Globalization.CultureInfo) オブジェクト。 その [CultureInfo.GetFormat](xref:System.Globalization.CultureInfo.GetFormat(System.Type)) メソッドは、[CultureInfo.NumberFormat](xref:System.Globalization.CultureInfo.NumberFormat) プロパティの値を返します。このプロパティは、数値にカルチャ固有の書式指定情報を提供する [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトです。
-
-* 使用されるカルチャ固有の書式指定規則を定義する [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクト。 その [GetFormat](xref:System.Globalization.NumberFormatInfo.GetFormat(System.Type)) メソッドでは、それ自身のインスタンスが返されます。
-
-次の例では、浮動小数点数を書式指定する際に、英語 (米国) と英語 (英国) のカルチャおよびフランス語とロシア語のニュートラル カルチャを表す [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトを使用します。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {                                                                                                    
-      Double value = 1043.62957;
-      string[] cultureNames = { "en-US", "en-GB", "ru", "fr" };
-
-      foreach (var name in cultureNames) {
-         NumberFormatInfo nfi = CultureInfo.CreateSpecificCulture(name).NumberFormat;
-         Console.WriteLine("{0,-6} {1}", name + ":", value.ToString("N3", nfi));
-      }   
-   }
-}
-// The example displays the following output:
-//       en-US: 1,043.630
-//       en-GB: 1,043.630
-//       ru:    1 043,630
-//       fr:    1 043,630
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim value As Double = 1043.62957
-      Dim cultureNames() As String = { "en-US", "en-GB", "ru", "fr" }
-
-      For Each name In cultureNames
-         Dim nfi As NumberFormatInfo = CultureInfo.CreateSpecificCulture(name).NumberFormat
-         Console.WriteLine("{0,-6} {1}", name + ":", value.ToString("N3", nfi))
-      Next   
-   End Sub
-End Module
-' The example displays the following output:
-'       en-US: 1,043.630
-'       en-GB: 1,043.630
-'       ru:    1 043,630
-'       fr:    1 043,630
-```
-
-### <a name="culture-sensitive-formatting-of-date-and-time-values"></a>日付と時刻の値のカルチャに依存した書式設定
-
-既定では、日時の値の書式指定はカルチャに依存します。 書式指定メソッドを呼び出すときにカルチャを指定しない場合は、現在のスレッド カルチャの書式指定規則が使用されます。 次に示す例では、現在のスレッド カルチャを 4 回変更した後に、[DateTime.ToString(String)](xref:System.DateTime.ToString(System.String)) メソッドを呼び出します。 各ケースでは、結果の文字列は、現在のカルチャの書式指定規則を反映します。 これは、[DateTime.ToString()](xref:System.DateTime.ToString)、[DateTime.ToString(String)](xref:System.DateTime.ToString(System.String))、[DateTimeOffset.ToString()](xref:System.DateTimeOffset.ToString(System.String))、[DateTimeOffset.ToString(String)](xref:System.DateTimeOffset.ToString(System.String)) の各メソッドが、[DateTime.ToString(String, IFormatProvider)](xref:System.DateTime.ToString(System.String,System.IFormatProvider)) メソッドおよび [DateTimeOffset.ToString(String, IFormatProvider)](xref:System.DateTimeOffset.ToString(System.String,System.IFormatProvider)) メソッドへの呼び出しをラップするためです。
-
-```csharp
-using System;
-using System.Globalization;
-using System.Threading;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] cultureNames = { "en-US", "fr-FR", "es-MX", "de-DE" };
-      DateTime dateToFormat = new DateTime(2012, 5, 28, 11, 30, 0);
-
-      foreach (var cultureName in cultureNames) {
-         // Change the current thread culture.
-         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(cultureName);
-         Console.WriteLine("The current culture is {0}", 
-                           Thread.CurrentThread.CurrentCulture.Name);
-         Console.WriteLine(dateToFormat.ToString("F"));
-         Console.WriteLine();
-      }   
-   }
-}
-// The example displays the following output:
-//       The current culture is en-US
-//       Monday, May 28, 2012 11:30:00 AM
-//       
-//       The current culture is fr-FR
-//       lundi 28 mai 2012 11:30:00
-//       
-//       The current culture is es-MX
-//       lunes, 28 de mayo de 2012 11:30:00 a.m.
-//       
-//       The current culture is de-DE
-//       Montag, 28. Mai 2012 11:30:00
-```
-
-```vb
-Imports System.Globalization
-Imports System.Threading 
-
-Module Example
-   Public Sub Main()
-      Dim cultureNames() As String = { "en-US", "fr-FR", "es-MX", "de-DE" }
-      Dim dateToFormat As Date = #5/28/2012 11:30AM#
-
-      For Each cultureName In cultureNames
-         ' Change the current thread culture.
-         Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(cultureName)
-         Console.WriteLine("The current culture is {0}", 
-                           Thread.CurrentThread.CurrentCulture.Name)
-         Console.WriteLine(dateToFormat.ToString("F"))
-         Console.WriteLine()
-      Next                  
-   End Sub
-End Module
-' The example displays the following output:
-'       The current culture is en-US
-'       Monday, May 28, 2012 11:30:00 AM
-'       
-'       The current culture is fr-FR
-'       lundi 28 mai 2012 11:30:00
-'       
-'       The current culture is es-MX
-'       lunes, 28 de mayo de 2012 11:30:00 a.m.
-'       
-'       The current culture is de-DE
-'       Montag, 28. Mai 2012 11:30:00
-```
-
-provider パラメーターを持つ [DateTime.ToString](xref:System.DateTime.ToString(System.String,System.IFormatProvider)) または [DateTimeOffset.ToString](xref:System.DateTimeOffset.ToString(System.String,System.IFormatProvider)) オーバーロードを呼び出して、次のどちらかを渡すことにより、特定カルチャの日時の値を書式指定することもできます。 
-
-* 使用される書式指定規則のカルチャを表す [CultureInfo](xref:System.Globalization.CultureInfo) オブジェクト。 その [CultureInfo.GetFormat](xref:System.Globalization.CultureInfo.GetFormat(System.Type)) メソッドは、[CultureInfo.NumberFormat](xref:System.Globalization.CultureInfo.NumberFormat) プロパティの値を返します。このプロパティは、数値にカルチャ固有の書式指定情報を提供する [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトです。
-
-* 使用されるカルチャ固有の書式指定規則を定義する [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクト。 その [GetFormat](xref:System.Globalization.DateTimeFormatInfo.GetFormat(System.Type)) メソッドでは、それ自身のインスタンスが返されます。
-
-次の例では、日付を書式指定する際に、英語 (米国) と英語 (英国) のカルチャおよびフランス語とロシア語のニュートラル カルチャを表す [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトを使用します。 
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {                                                                                                    
-      DateTime dat1 = new DateTime(2012, 5, 28, 11, 30, 0);
-      string[] cultureNames = { "en-US", "en-GB", "ru", "fr" };
-
-      foreach (var name in cultureNames) {
-         DateTimeFormatInfo dtfi = CultureInfo.CreateSpecificCulture(name).DateTimeFormat;
-         Console.WriteLine("{0}: {1}", name, dat1.ToString(dtfi));
-      }   
-   }
-}
-// The example displays the following output:
-//       en-US: 5/28/2012 11:30:00 AM
-//       en-GB: 28/05/2012 11:30:00
-//       ru: 28.05.2012 11:30:00
-//       fr: 28/05/2012 11:30:00
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim dat1 As Date = #5/28/2012 11:30AM#
-      Dim cultureNames() As String = { "en-US", "en-GB", "ru", "fr" }
-
-      For Each name In cultureNames
-         Dim dtfi As DateTimeFormatInfo = CultureInfo.CreateSpecificCulture(name).DateTimeFormat
-         Console.WriteLine("{0}: {1}", name, dat1.ToString(dtfi))
-      Next   
-   End Sub
-End Module
-' The example displays the following output:
-'       en-US: 5/28/2012 11:30:00 AM
-'       en-GB: 28/05/2012 11:30:00
-'       ru: 28.05.2012 11:30:00
-'       fr: 28/05/2012 11:30:00
-```
-
-## <a name="the-iformattable-interface"></a>IFormattable インターフェイス
-
-通常、書式指定文字列および [IFormatProvider](xref:System.IFormatProvider) パラメーターを使用して `ToString` メソッドをオーバーロードする型は、[IFormattable](xref:System.IFormattable) インターフェイスも実装します。 このインターフェイスには、[IFormattable.ToString(String, IFormatProvider)](xref:System.IFormattable.ToString(System.String,System.IFormatProvider)) という単一のメンバーがあります。このメンバーには、パラメーターとして書式指定文字列と書式プロバイダーの両方が含まれています。
-
-アプリケーション定義のクラスに [IFormattable](xref:System.IFormattable) インターフェイスを実装した場合、2 つの利点があります。 
-
-* [Convert](xref:System.Convert) クラスによる文字列変換がサポートされます。 [Convert.ToString(Object)](xref:System.Convert.ToString(System.Object)) メソッドおよび [Convert.ToString(Object, IFormatProvider)](xref:System.Convert.ToString(System.Object,System.IFormatProvider)) メソッドを呼び出すと、自動的に [IFormattable](xref:System.IFormattable) の実装が呼び出されます。
-
-* 複合書式指定がサポートされます。 書式指定文字列を含む書式指定項目を使用してカスタムの型の書式を設定する場合に、共通言語ランタイムによって自動的に [IFormattable](xref:System.IFormattable) の実装が呼び出され、それに書式指定文字列が渡されます。 `String.Format` メソッドや `Console.WriteLine` メソッドを使用した複合書式指定の詳細については、「[複合書式指定](#composite-formatting)」のセクションを参照してください。
-
-次の例では、[IFormattable](xref:System.IFormattable) インターフェイスを実装する `Temperature` クラスを定義しています。 このクラスでは、温度を摂氏で表示するために "C" 書式指定子または "G" 書式指定子、華氏で表示するために "F" 書式指定子、ケルビンで表示するために "K" 書式指定子をそれぞれサポートしています。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Temperature : IFormattable
-{
-   private decimal m_Temp;
-
-   public Temperature(decimal temperature)
-   {
-      this.m_Temp = temperature;
-   }
-
-   public decimal Celsius
-   {
-      get { return this.m_Temp; }
-   }
-
-   public decimal Kelvin
-   {
-      get { return this.m_Temp + 273.15m; }   
-   }
-
-   public decimal Fahrenheit
-   {
-      get { return Math.Round((decimal) this.m_Temp * 9 / 5 + 32, 2); }
-   }
-
-   public override string ToString()
-   {
-      return this.ToString("G", null);
-   }
-
-   public string ToString(string format)
-   {
-      return this.ToString(format, null);
-   }
-
-   public string ToString(string format, IFormatProvider provider)  
-   {
-      // Handle null or empty arguments.
-      if (String.IsNullOrEmpty(format)) format = "G";
-      // Remove any white space and convert to uppercase.
-      format = format.Trim().ToUpperInvariant();
-
-      if (provider == null) provider = NumberFormatInfo.CurrentInfo;
-
-      switch (format)
-      {
-         // Convert temperature to Fahrenheit and return string.
-         case "F":
-            return this.Fahrenheit.ToString("N2", provider) + "°F";
-         // Convert temperature to Kelvin and return string.
-         case "K":
-            return this.Kelvin.ToString("N2", provider) + "K";
-         // Return temperature in Celsius.
-         case "C":
-         case "G":
-            return this.Celsius.ToString("N2", provider) + "°C";
-         default:
-            throw new FormatException(String.Format("The '{0}' format string is not supported.", format));
-      }      
-   }
-}
-```
-
-```vb
-Imports System.Globalization
-
-Public Class Temperature : Implements IFormattable
-   Private m_Temp As Decimal
-
-   Public Sub New(temperature As Decimal)
-      Me.m_Temp = temperature
-   End Sub
-
-   Public ReadOnly Property Celsius() As Decimal
-      Get
-         Return Me.m_Temp
-      End Get   
-   End Property
-
-   Public ReadOnly Property Kelvin() As Decimal
-      Get
-         Return Me.m_Temp + 273.15d   
-      End Get
-   End Property
-
-   Public ReadOnly Property Fahrenheit() As Decimal
-      Get
-         Return Math.Round(CDec(Me.m_Temp * 9 / 5 + 32), 2)
-      End Get      
-   End Property
-
-   Public Overrides Function ToString() As String
-      Return Me.ToString("G", Nothing)
-   End Function
-
-   Public Overloads Function ToString(format As String) As String
-      Return Me.ToString(format, Nothing)
-   End Function
-
-   Public Overloads Function ToString(format As String, provider As IFormatProvider) As String _  
-      Implements IFormattable.ToString
-
-      ' Handle null or empty arguments.
-      If String.IsNullOrEmpty(format) Then format = "G"
-      ' Remove any white space and convert to uppercase.
-      format = format.Trim().ToUpperInvariant()
-
-      If provider Is Nothing Then provider = NumberFormatInfo.CurrentInfo
-
-      Select Case format
-         ' Convert temperature to Fahrenheit and return string.
-         Case "F"
-            Return Me.Fahrenheit.ToString("N2", provider) & "°F"
-         ' Convert temperature to Kelvin and return string.
-         Case "K"
-            Return Me.Kelvin.ToString("N2", provider) & "K"
-         ' Return temperature in Celsius.
-         Case "C", "G"
-            Return Me.Celsius.ToString("N2", provider) & "°C"
-         Case Else
-            Throw New FormatException(String.Format("The '{0}' format string is not supported.", format))
-      End Select      
-   End Function
-End Class
-```
-
-次の例では、`Temperature` オブジェクトをインスタンス化しています。 その後、[ToString](xref:System.Convert.ToString(System.Object,System.IFormatProvider)) メソッドを呼び出し、いくつかの複合書式指定文字列を使用して `Temperature` オブジェクトのさまざまな文字列形式を取得します。 さらに、それらの各メソッド呼び出しで、`Temperature` クラスの [IFormattable](xref:System.IFormattable) 実装を呼び出しています。
-
-```csharp
-public class Example
-{
-   public static void Main()
-   {
-      Temperature temp1 = new Temperature(22m);
-      Console.WriteLine(Convert.ToString(temp1, new CultureInfo("ja-JP")));
-      Console.WriteLine("Temperature: {0:K}", temp1);
-      Console.WriteLine("Temperature: {0:F}", temp1);
-      Console.WriteLine(String.Format(new CultureInfo("fr-FR"), "Temperature: {0:F}", temp1));
-   }
-}
-// The example displays the following output:
-//       22.00°C
-//       Temperature: 295.15°K
-//       Temperature: 71.60°F
-//       Temperature: 71,60°F
-```
-
-```vb
-Public Module Example
-   Public Sub Main()
-      Dim temp1 As New Temperature(22d)
-      Console.WriteLine(Convert.ToString(temp1, New CultureInfo("ja-JP")))
-      Console.WriteLine("Temperature: {0:K}", temp1)
-      Console.WriteLine("Temperature: {0:F}", temp1)
-      Console.WriteLine(String.Format(New CultureInfo("fr-FR"), "Temperature: {0:F}", temp1)) 
-   End Sub
-End Module
-' The example displays the following output:
-'       22.00°C
-'       Temperature: 295.15°K
-'       Temperature: 71.60°F
-'       Temperature: 71,60°F
-```
-
-## <a name="composite-formatting"></a>複合書式指定
-
-`String.Format` や `StringBuilder.AppendFormat` などの一部のメソッドでは、複合書式指定がサポートされます。 複合書式指定文字列は一種のテンプレートで、0 個以上のオブジェクトの文字列形式が組み込まれた単一の文字列を返します。 各オブジェクトは、インデックス付きの書式指定項目によって、複合書式指定文字列で表現されます。 書式指定項目のインデックスは、それが表すオブジェクトのメソッドのパラメーター リスト内の位置と対応しています。 インデックスは 0 から始まります。 たとえば、`String.Format` メソッドの次のメソッド呼び出しでは、最初の書式指定項目 `{0:D}` は `thatDate` の文字列形式に、2 番目の書式指定項目 `{1}` は `item1` の文字列形式に、3 番目の書式指定項目 `{2:C2}` は `item1.Value` の文字列形式に置き換えられます。
-
-```csharp
-result = String.Format("On {0:d}, the inventory of {1} was worth {2:C2}.", 
-                       thatDate, item1, item1.Value);
-Console.WriteLine(result);                            
-// The example displays output like the following if run on a system
-// whose current culture is en-US:
-//       On 5/1/2009, the inventory of WidgetA was worth $107.44.
-```
-
-```vb
-result = String.Format("On {0:d}, the inventory of {1} was worth {2:C2}.", _
-                       thatDate, item1, item1.Value)
-Console.WriteLine(result)                            
-' The example displays output like the following if run on a system
-' whose current culture is en-US:
-'       On 5/1/2009, the inventory of WidgetA was worth $107.44.
-```
-
-書式項目をそれに対応するオブジェクトの文字列形式に置換することに加えて、書式項目は以下を制御することもできます。 
-
-* オブジェクトを文字列として表現する特定の方法 (オブジェクトが [IFormattable](xref:System.IFormattable) インターフェイスを実装し、書式文字列をサポートする場合)。 これは、: (コロン) 付きの書式項目のインデックスに、有効な書式文字列を続けることによります。 前の例では、日付の値を "d" (短い日付のパターン) 書式文字列 (`{0:d}` など) を書式設定し、数値を "C2" 書式文字列 (`{2:C2}` など) で書式設定して数値を 2 桁の小数部を含む 10 進数を持つ通貨値で表していました。 
-
-* オブジェクトの文字列形式を含むフィールドの幅、およびそのフィールドの文字列形式の配置。 これは、, (コンマ) 付きの書式項目のインデックスに、フィールドの幅を続けることによります。 フィールドの幅が正の値の場合、文字列はフィールドで右揃えにし、フィールドの幅が負の値の場合、左揃えにします。 次の例では、20 文字のフィールドで日付の値を左揃えにし、11 文字のフィールドで、1 桁の小数部を含む 10 進数値を右揃えにします。 
-
-```csharp
-DateTime startDate = new DateTime(2015, 8, 28, 6, 0, 0);
-decimal[] temps = { 73.452m, 68.98m, 72.6m, 69.24563m,
-                   74.1m, 72.156m, 72.228m };
-Console.WriteLine("{0,-20} {1,11}\n", "Date", "Temperature");
-for (int ctr = 0; ctr < temps.Length; ctr++)
-   Console.WriteLine("{0,-20:g} {1,11:N1}", startDate.AddDays(ctr), temps[ctr]);
-
-// The example displays the following output:
-//       Date                 Temperature
-//
-//       8/28/2015 6:00 AM           73.5
-//       8/29/2015 6:00 AM           69.0
-//       8/30/2015 6:00 AM           72.6
-//       8/31/2015 6:00 AM           69.2
-//       9/1/2015 6:00 AM            74.1
-//       9/2/2015 6:00 AM            72.2
-//       9/3/2015 6:00 AM            72.2
-```
-
-```vb
-Dim startDate As New Date(2015, 8, 28, 6, 0, 0)
-Dim temps() As Decimal = { 73.452, 68.98, 72.6, 69.24563,
-                           74.1, 72.156, 72.228 }
-Console.WriteLine("{0,-20} {1,11}", "Date", "Temperature")
-Console.WriteLine()
-For ctr As Integer = 0 To temps.Length - 1
-   Console.WriteLine("{0,-20:g} {1,11:N1}", startDate.AddDays(ctr), temps(ctr))
-Next
-' The example displays the following output:
-'       Date                 Temperature
-'
-'       8/28/2015 6:00 AM           73.5
-'       8/29/2015 6:00 AM           69.0
-'       8/30/2015 6:00 AM           72.6
-'       8/31/2015 6:00 AM           69.2
-'       9/1/2015 6:00 AM            74.1
-'       9/2/2015 6:00 AM            72.2
-'       9/3/2015 6:00 AM            72.2
-```
-
-配置文字列コンポーネントと書式文字列コンポーネントの両方が存在する場合、前者は後者の前にきます (たとえば `{0,-20:g}`)。 
-
-複合書式指定の詳細については、「[複合書式指定](composite-format.md)」を参照してください。
-
-## <a name="custom-formatting-with-icustomformatter"></a>ICustomFormatter を使用したカスタム書式設定
-
-[String.Format(IFormatProvider, String, Object[])](xref:System.String.Format(System.IFormatProvider,System.String,System.Object[])) および [StringBuilder.AppendFormat(IFormatProvider, String, Object[])](xref:System.Text.StringBuilder.AppendFormat(System.IFormatProvider,System.String,System.Object)) の 2 つの複合書式指定メソッドには、カスタム書式設定をサポートしている書式プロバイダー パラメーターが含まれています。 これらの書式指定メソッドのいずれかを呼び出すと、書式プロバイダーの `GetFormat` メソッドに [ICustomFormatter](xref:System.ICustomFormatter) インターフェイスを表す [Type](xref:System.Type) オブジェクトが渡されます。 次に、`GetFormat` メソッドによって、カスタム書式設定を提供する [ICustomFormatter](xref:System.ICustomFormatter) の実装が返されます。
-
-[ICustomFormatter](xref:System.ICustomFormatter) インターフェイスには、[Format(String, Object, IFormatProvider)](xref:System.ICustomFormatter.Format(System.String,System.Object,System.IFormatProvider)) という単一のメソッドがあります。このメソッドは、複合書式指定文字列の書式指定項目ごとに 1 回、複合書式指定メソッドによって自動的に呼び出されます。 [Format(String, Object, IFormatProvider)](xref:System.ICustomFormatter.Format(System.String,System.Object,System.IFormatProvider)) メソッドには、3 つのパラメーターがあります。書式指定項目の *formatString* 引数を表す書式指定文字列、書式を設定するオブジェクト、および書式指定サービスを提供する [IFormatProvider](xref:System.IFormatProvider) オブジェクトの 3 つです。 通常は、[ICustomFormatter](xref:System.ICustomFormatter) を実装するクラスでは [IFormatProvider](xref:System.IFormatProvider) も実装するため、この最後のパラメーターはカスタム書式指定クラス自体への参照になります。 このメソッドは、書式を設定するオブジェクトのカスタム書式の文字列形式を返します。 オブジェクトの書式を設定できない場合は、null 参照を返します。
-
-整数値を 2 桁の 16 進値とそれに続く 1 つの空白のシーケンスとして表示する、`ByteByByteFormatter` という名前の [ICustomFormatter](xref:System.ICustomFormatter) の実装の例を次に示します。
-
-```csharp
-public class ByteByByteFormatter : IFormatProvider, ICustomFormatter
-{
-   public object GetFormat(Type formatType)
-   { 
-      if (formatType == typeof(ICustomFormatter))
-         return this;
-      else
-         return null;
-   }
-
-   public string Format(string format, object arg, 
-                          IFormatProvider formatProvider)
-   {   
-      if (! formatProvider.Equals(this)) return null;
-
-      // Handle only hexadecimal format string.
-      if (! format.StartsWith("X")) return null;
-
-      byte[] bytes;
-      string output = null;
-
-      // Handle only integral types.
-      if (arg is Byte) 
-         bytes = BitConverter.GetBytes((Byte) arg);
-      else if (arg is Int16)
-         bytes = BitConverter.GetBytes((Int16) arg);
-      else if (arg is Int32)
-         bytes = BitConverter.GetBytes((Int32) arg);
-      else if (arg is Int64)   
-         bytes = BitConverter.GetBytes((Int64) arg);
-      else if (arg is SByte)
-         bytes = BitConverter.GetBytes((SByte) arg);
-      else if (arg is UInt16)
-         bytes = BitConverter.GetBytes((UInt16) arg);
-      else if (arg is UInt32)
-         bytes = BitConverter.GetBytes((UInt32) arg);
-      else if (arg is UInt64)
-         bytes = BitConverter.GetBytes((UInt64) arg);
-      else
-         return null;
-
-      for (int ctr = bytes.Length - 1; ctr >= 0; ctr--)
-         output += String.Format("{0:X2} ", bytes[ctr]);   
-
-      return output.Trim();
-   }
-}
-```
-
-```vb
-Public Class ByteByByteFormatter : Implements IFormatProvider, ICustomFormatter
-   Public Function GetFormat(formatType As Type) As Object _
-                   Implements IFormatProvider.GetFormat
-      If formatType Is GetType(ICustomFormatter) Then
-         Return Me
-      Else
-         Return Nothing
-      End If
-   End Function
-
-   Public Function Format(fmt As String, arg As Object, 
-                          formatProvider As IFormatProvider) As String _
-                          Implements ICustomFormatter.Format
-
-      If Not formatProvider.Equals(Me) Then Return Nothing
-
-      ' Handle only hexadecimal format string.
-      If Not fmt.StartsWith("X") Then 
-            Return Nothing
-      End If
-
-      ' Handle only integral types.
-      If Not typeof arg Is Byte AndAlso
-         Not typeof arg Is Int16 AndAlso
-         Not typeof arg Is Int32 AndAlso
-         Not typeof arg Is Int64 AndAlso
-         Not typeof arg Is SByte AndAlso
-         Not typeof arg Is UInt16 AndAlso
-         Not typeof arg Is UInt32 AndAlso
-         Not typeof arg Is UInt64 Then _
-            Return Nothing
-
-      Dim bytes() As Byte = BitConverter.GetBytes(arg)
-      Dim output As String = Nothing
-
-      For ctr As Integer = bytes.Length - 1 To 0 Step -1
-         output += String.Format("{0:X2} ", bytes(ctr))   
-      Next
-
-      Return output.Trim()
-   End Function
-End Class
-```
-
-`ByteByByteFormatter` クラスを使用して整数値の書式を設定する例を次に示します。 [ICustomFormatter.Format](xref:System.ICustomFormatter.Format(System.String,System.Object,System.IFormatProvider)) メソッドが 2 回目の [String.Format(IFormatProvider, String, Object[])](xref:System.ICustomFormatter.Format(System.String,System.Object,System.IFormatProvider)) メソッド呼び出しで複数回呼び出されることに注意してください。また、`.ByteByByteFormatter.Format` メソッドが "N0" 書式指定文字列を認識せず、null 参照を返すため、3 回目のメソッド呼び出しでは既定の [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) プロバイダーが使用されていることに注意してください。
-
-```csharp
-public class Example
-{
-   public static void Main()
-   {
-      long value = 3210662321; 
-      byte value1 = 214;
-      byte value2 = 19;
-
-      Console.WriteLine(String.Format(new ByteByByteFormatter(), "{0:X}", value));
-      Console.WriteLine(String.Format(new ByteByByteFormatter(), "{0:X} And {1:X} = {2:X} ({2:000})", 
-                                      value1, value2, value1 & value2));                                
-      Console.WriteLine(String.Format(new ByteByByteFormatter(), "{0,10:N0}", value));
-   }
-}
-// The example displays the following output:
-//       00 00 00 00 BF 5E D1 B1
-//       00 D6 And 00 13 = 00 12 (018)
-//       3,210,662,321
-```
-
-```vb
-Public Module Example
-   Public Sub Main()
-      Dim value As Long = 3210662321 
-      Dim value1 As Byte = 214
-      Dim value2 As Byte = 19
-
-      Console.WriteLine((String.Format(New ByteByByteFormatter(), "{0:X}", value)))
-      Console.WriteLine((String.Format(New ByteByByteFormatter(), "{0:X} And {1:X} = {2:X} ({2:000})", 
-                                      value1, value2, value1 And value2)))                                
-      Console.WriteLine(String.Format(New ByteByByteFormatter(), "{0,10:N0}", value))
-   End Sub
-End Module
-' The example displays the following output:
-'       00 00 00 00 BF 5E D1 B1
-'       00 D6 And 00 13 = 00 12 (018)
-'       3,210,662,321
-```
-
-## <a name="related-topics"></a>関連トピック
-
-タイトル | 定義
------ | ----------
-[標準の数値書式指定文字列](standard-numeric.md) | 数値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。 
-[カスタム数値書式指定文字列](custom-numeric.md) | 数値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[標準の日時書式指定文字列](standard-datetime.md) |  [DateTime](xref:System.DateTime) 値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。
-[カスタム日時書式指定文字列](custom-datetime.md) | [DateTime](xref:System.DateTime) 値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[標準 TimeSpan 書式指定文字列](standard-timespan.md) | 時間間隔に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。
-[カスタム TimeSpan 書式指定文字列](custom-timespan.md) | 時間間隔に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。
-[列挙型書式指定文字列](enumeration-format.md) | 列挙型の文字列形式を作成するために使用される標準書式指定文字列について説明します。
-[複合書式指定](composite-format.md) | 文字列に 1 つ以上の書式指定された値を埋め込む方法について説明します。 この文字列は、コンソールに表示したり、ストリームに書き込んだりできます。
-[書式設定操作の実行](performing-formatting-operations.md) | 特定の書式設定操作を行うための手順を説明するトピックの一覧を示します。
-[文字列の解析](parsing-strings.md) | オブジェクトの文字列表現によって指定された値にオブジェクトを初期化する方法について説明します。 解析は書式設定の逆の操作です。
-
-## <a name="reference"></a>参照
-
-[System.IFormattable](xref:System.IFormattable)
-
-[System.IFormatProvider](xref:System.IFormatProvider)
-
-[System.ICustomFormatter](xref:System.ICustomFormatter)
-
+>  構造体は、<xref:System.ValueType> から派生した <xref:System.Object> を継承します。<xref:System.ValueType> は <xref:System.Object.ToString%2A?displayProperty=fullName> をオーバーライドしますが、その実装は同じです。  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="OverrideToString"></a>   
+## ToString メソッドのオーバーライド  
+ 型の名前の表示は用途が限定され、型のコンシューマー側でインスタンスを別のインスタンスと区別することはできません。 ただし、`ToString` メソッドをオーバーライドして、もっと役に立つオブジェクトの値の形式を作成することができます。 次の例では `Temperature` オブジェクトを定義し、その `ToString` メソッドをオーバーライドして、温度を摂氏で表示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/overrides1.cs#2)]
+ [!code-vb[Conceptual.Formatting.Overview#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/overrides1.vb#2)]  
+  
+ .NET Framework では、各プリミティブ値型の `ToString` メソッドは名前の代わりにオブジェクトの値を表示するようにオーバーライドされています。 各プリミティブ型のオーバーライドを次の表に示します。 オーバーライドされているメソッドのほとんどは `ToString` メソッドの別のオーバーロードを呼び出し、それにその型の一般書式を定義する "G" 書式指定子と、現在のカルチャを表す <xref:System.IFormatProvider> オブジェクトを渡します。  
+  
+|型|ToString のオーバーライド|  
+|-------|-----------------------|  
+|<xref:System.Boolean>|<xref:System.Boolean.TrueString?displayProperty=fullName> または <xref:System.Boolean.FalseString?displayProperty=fullName> を返します。|  
+|<xref:System.Byte>|`Byte.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Byte> 値の書式設定をします。|  
+|<xref:System.Char>|文字を文字列として返します。|  
+|<xref:System.DateTime>|`DateTime.ToString("G", DatetimeFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて日付と時刻の値の書式設定をします。|  
+|<xref:System.Decimal>|`Decimal.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Decimal> 値の書式設定をします。|  
+|<xref:System.Double>|`Double.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Double> 値の書式設定をします。|  
+|<xref:System.Int16>|`Int16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Int16> 値の書式設定をします。|  
+|<xref:System.Int32>|`Int32.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Int32> 値の書式設定をします。|  
+|<xref:System.Int64>|`Int64.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Int64> 値の書式設定をします。|  
+|<xref:System.SByte>|`SByte.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.SByte> 値の書式設定をします。|  
+|<xref:System.Single>|`Single.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.Single> 値の書式設定をします。|  
+|<xref:System.UInt16>|`UInt16.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.UInt16> 値の書式設定をします。|  
+|<xref:System.UInt32>|`UInt32.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.UInt32> 値の書式設定をします。|  
+|<xref:System.UInt64>|`UInt64.ToString("G", NumberFormatInfo.CurrentInfo)` を呼び出して、現在のカルチャに合わせて <xref:System.UInt64> 値の書式設定をします。|  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="FormatStrings"></a>   
+## ToString メソッドと書式指定文字列  
+ 既定の `ToString` メソッドや `ToString` のオーバーライドの使用は、オブジェクトの文字列形式が 1 つの場合に適しています。 しかし、多くの場合オブジェクトの値には複数の形式があります。 たとえば、温度は華氏、摂氏、またはケルビンで表現できます。 また、整数値 10 は 10、10.0、1.0e01、$10.00 などの多くの方法で表すことができます。  
+  
+ .NET Framework では、書式指定文字列を使用することで、1 つの値に複数の文字列形式を持たせることができます。 書式指定文字列とは定義済みの書式指定子を 1 つ以上含む文字列です。書式指定子とは、`ToString` メソッドによるその出力の書式設定方法を定義する 1 文字または文字グループです。 書式指定文字列はパラメーターとしてオブジェクトの `ToString` メソッドに渡され、オブジェクトの値の文字列形式の表示方法を決定します。  
+  
+ .NET Framework では、すべての数値型、日付\/時刻型、および列挙型で、定義済みの一連の書式指定子をサポートしています。 書式指定文字列を使用して、アプリケーションで定義されたデータ型の文字列形式を複数定義することもできます。  
+  
+<a name="standardStrings"></a>   
+### 標準書式指定文字列  
+ 標準書式指定文字列には、適用先のオブジェクトの文字列形式を定義する英字の単一の書式指定子と、結果文字列に表示される桁数に影響するオプションの精度指定子が含まれます。 精度指定子が省略されるかサポートされていない場合、標準書式指定子は標準書式指定文字列と同じになります。  
+  
+ .NET Framework では、すべての数値型、すべての日付\/時刻型、およびすべての列挙型に対して一連の標準書式指定子が定義されています。 たとえば、それらのカテゴリごとに、対応する型の値の一般的な文字列形式を定義する "G" 標準書式指定子がサポートされています。  
+  
+ 列挙型の標準書式指定文字列は、値の文字列形式を直接制御します。 列挙値の `ToString` メソッドに渡された書式指定文字列によって、文字列名 \("G" 書式指定子および "F" 書式指定子\)、基になる整数値 \("D" 書式指定子\)、または 16 進値 \("X" 書式指定子\) のどの形式で値を表示するかが決定します。 次のコード例では、標準書式指定文字列を使用して、<xref:System.DayOfWeek> 列挙値の書式を設定する方法を示しています。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/standard1.cs#4)]
+ [!code-vb[Conceptual.Formatting.Overview#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/standard1.vb#4)]  
+  
+ 列挙型書式指定文字列については、「[列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)」を参照してください。  
+  
+ 数値型の標準書式指定文字列は、通常、表示される桁数が 1 つ以上のプロパティ値によって制御される結果文字列を定義します。 たとえば、"C" 書式指定子は数字を通貨値として書式設定します。 唯一のパラメーターとして "C" 書式指定子を渡して `ToString` メソッドを呼び出した場合、現在のカルチャの <xref:System.Globalization.NumberFormatInfo> オブジェクトの次のプロパティ値を使用して数値の文字列形式を定義します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A> プロパティ。現在のカルチャの通貨記号を指定します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A> プロパティまたは <xref:System.Globalization.NumberFormatInfo.CurrencyPositivePattern%2A> プロパティ。次の情報を特定する整数を返します。  
+  
+    -   通貨記号の位置。  
+  
+    -   負の値を表すために、先頭の負の符号、末尾の負の符号、またはかっこのどれを使用するか。  
+  
+    -   数値と通貨記号の間にスペース文字を表示するかどうか。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A> プロパティ。結果文字列の小数点以下の桁数を定義します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A> プロパティ。結果文字列の小数点の記号を定義します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator%2A> プロパティ。桁区切り記号を定義します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSizes%2A> プロパティ。整数部の各グループの桁数を定義します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A> プロパティ。かっこを使用せずに負の値を表す場合に結果文字列で使用する負の符号を決定します。  
+  
+ さらに、数値書式指定文字列には、精度指定子が含まれる場合があります。 この指定子の意味は一緒に使用される書式指定文字列によって異なりますが、通常は、結果文字列に表示される合計桁数か小数点以下の桁数を示します。 たとえば、次の例では、"X4" の標準数値文字列と精度指定子を使用して、4 桁の 16 進数から成る文字列値を作成します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/precisionspecifier1.cs#6)]
+ [!code-vb[Conceptual.Formatting.Overview#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/precisionspecifier1.vb#6)]  
+  
+ 標準の数値書式指定文字列の詳細については、「[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)」を参照してください。  
+  
+ 日付と時刻の値の標準書式指定文字列は、特定の <xref:System.Globalization.DateTimeFormatInfo> プロパティに格納されているカスタム書式指定文字列のエイリアスです。 たとえば、"D" 書式指定子を渡して日付と時刻の値の `ToString` メソッドを呼び出すと、現在のカルチャの <xref:System.Globalization.DateTimeFormatInfo.LongDatePattern%2A?displayProperty=fullName> プロパティに格納されているカスタム書式指定文字列を使用して日付と時刻が表示されます \(カスタム書式指定文字列の詳細については、[次のセクション](#customStrings)を参照してください\)。 この関係を次の例に示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/alias1.cs#5)]
+ [!code-vb[Conceptual.Formatting.Overview#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/alias1.vb#5)]  
+  
+ 標準の日時書式指定文字列の詳細については、「[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)」を参照してください。  
+  
+ また、標準書式指定文字列を使用して、オブジェクトの `ToString(String)` メソッドによって生成された、アプリケーション定義のオブジェクトの文字列形式を定義することもできます。 オブジェクトでサポートする特定の標準書式指定子を定義したり、それらで大文字と小文字を区別するかしないかを決定したりすることができます。`ToString(String)` メソッドの実装で、以下がサポートされます。  
+  
+-   オブジェクトの一般的な書式または共通の書式を表す "G" 書式指定子。 オブジェクトの `ToString` メソッドのパラメーターなしのオーバーロードで、その `ToString(String)` オーバーロードを呼び出し、それに "G" 標準書式指定文字列を渡します。  
+  
+-   null 参照 \(Visual Basic の場合は `Nothing`\) に相当する書式指定子。 null 参照に相当する書式指定子は "G" 書式指定子と同等に扱う必要があります。  
+  
+ たとえば、`Temperature` クラスの場合、内部的には温度を摂氏で格納し、書式指定子を使用して `Temperature` オブジェクトの値を摂氏、華氏、およびケルビンで表すことができます。 具体的な例を次に示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/appstandard1.cs#7)]
+ [!code-vb[Conceptual.Formatting.Overview#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/appstandard1.vb#7)]  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="customStrings"></a>   
+### カスタム書式指定文字列  
+ .NET Framework では、標準書式指定文字列のほかに、数値および日付と時刻の値の両方のカスタム書式指定文字列が定義されています。 カスタム書式指定文字列は、値の文字列形式を定義する 1 つ以上のカスタム書式指定子で構成されます。 たとえば、"yyyy\/mm\/dd hh:mm:ss.ffff t zzz" というカスタム日時書式指定文字列の場合、en\-US カルチャでは日付が "2008\/11\/15 07:45:00.0000 P \-08:00" という文字列形式に変換されます。 また、"0000" というカスタム書式指定文字列の場合、整数値 12 は "0012" に変換されます。 カスタム書式指定文字列の一覧については、「[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)」および「[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)」を参照してください。  
+  
+ 書式指定文字列が単一のカスタム書式指定子で構成される場合は、標準書式指定子と混同しないように、書式指定子の前にパーセント \(%\) 記号を付ける必要があります。 次の例では、"M" カスタム書式指定子を使用して、特定の日付の月を表す 1 桁または 2 桁の数値を表示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/singlecustom1.cs#8)]
+ [!code-vb[Conceptual.Formatting.Overview#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/singlecustom1.vb#8)]  
+  
+ 日付および時刻の値の標準書式指定文字列の多くは、<xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティによって定義されているカスタム書式指定文字列のエイリアスです。 また、カスタム書式指定文字列を使用することで、数値または日付と時刻の値に対して、柔軟にアプリケーション定義の書式を指定できます。 複数のカスタム書式指定子を 1 つのカスタム書式指定文字列に結合することによって、数値および日付と時刻の値の両方に対するカスタムの結果文字列を独自に定義することができます。 次の例では、月の名前、日付、および年の後に、かっこで囲んで曜日を表示するカスタム書式指定文字列を定義しています。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/custom1.cs#9)]
+ [!code-vb[Conceptual.Formatting.Overview#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/custom1.vb#9)]  
+  
+ 次の例では、<xref:System.Int64> 値を米国で標準的な 7 桁の電話番号を市外局番と共に表示するカスタム書式指定文字列を定義します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/telnumber1.cs#21)]
+ [!code-vb[Conceptual.Formatting.Overview#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/telnumber1.vb#21)]  
+  
+ 一般には、アプリケーション定義の型に対する書式設定のほとんどのニーズに標準書式指定文字列を使用して対応できますが、カスタム書式指定子を定義して型の書式を設定することもできます。  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="stringRef"></a>   
+### 書式指定文字列と .NET Framework クラス ライブラリ型  
+ すべての数値型 \(つまり、<xref:System.Byte>、<xref:System.Decimal>、<xref:System.Double>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.SByte>、<xref:System.Single>、<xref:System.UInt16>、<xref:System.UInt32>、<xref:System.UInt64>、<xref:System.Numerics.BigInteger> 型\)  
+  
+ 、<xref:System.DateTime>、<xref:System.DateTimeOffset>、<xref:System.TimeSpan>、<xref:System.Guid>、すべての列挙型が書式指定文字列による書式設定に対応しています。 各型でサポートされている特定の書式指定文字列については、次のトピックを参照してください  
+  
+|タイトル|定義|  
+|----------|--------|  
+|[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)|数値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)|数値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)|<xref:System.DateTime> 値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)|<xref:System.DateTime> 値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)|時間間隔に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)|時間間隔に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)|列挙型の文字列形式を作成するために使用される標準書式指定文字列について説明します。|  
+|<xref:System.Guid.ToString%28System.String%29?displayProperty=fullName>|<xref:System.Guid> 値の標準的書式指定文字列について説明します。|  
+  
+<a name="FormatProviders"></a>   
+## 書式プロバイダーと IFormatProvider インターフェイスによるカルチャに依存した書式指定  
+ 書式指定子を利用することでオブジェクトの書式をカスタマイズできますが、多くの場合、意味のあるオブジェクトの文字列形式を生成するには追加の書式設定情報が必要です。 たとえば、"C" 標準書式指定文字列または "$ \#,\#.00" などのカスタム書式指定文字列を使用して数字を通貨値として書式設定する場合、少なくとも、正しい通貨記号、桁区切り記号、および小数点記号についての情報を書式設定された文字列に含めることができる必要があります。 .NET Framework では、<xref:System.IFormatProvider> インターフェイスによって、この追加の書式設定情報を利用できるようにします。このインターフェイスは、数値型および日付\/時刻型の `ToString` メソッドの 1 つ以上のオーバーロードに対するパラメーターとして提供されます。<xref:System.IFormatProvider> の実装は .NET Framework で使用され、カルチャ固有の書式指定をサポートします。 それぞれ異なるカルチャを示す 3 つの <xref:System.IFormatProvider> オブジェクトを使用してオブジェクトの書式を設定した場合に、その文字列形式がどのように変化するかを次の例に示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/iformatprovider1.cs#11)]
+ [!code-vb[Conceptual.Formatting.Overview#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/iformatprovider1.vb#11)]  
+  
+ <xref:System.IFormatProvider> インターフェイスには、<xref:System.IFormatProvider.GetFormat%28System.Type%29> という 1 つのメソッドが含まれています。このメソッドには、書式設定情報を提供するオブジェクトの型を指定する 1 つのパラメーターがあります。 このメソッドがその型のオブジェクトを提供できる場合は、それが返されます。 それ以外の場合は、null 参照 \(Visual Basic の場合は `Nothing`\) が返されます。  
+  
+ <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> はコールバック メソッドです。`ToString` パラメーターを含む <xref:System.IFormatProvider> メソッド オーバーロードを呼び出すと、その <xref:System.IFormatProvider.GetFormat%2A> オブジェクトの <xref:System.IFormatProvider> メソッドが呼び出されます。<xref:System.IFormatProvider.GetFormat%2A> メソッドは、`formatType` パラメーターで指定された、必要な書式設定情報を提供するオブジェクトを `ToString` メソッドに返します。  
+  
+ 数多くの書式指定メソッドや文字列変換メソッドに <xref:System.IFormatProvider> 型のパラメーターが含まれていますが、多くの場合、メソッドを呼び出すときはパラメーターの値は無視されます。<xref:System.Type> メソッドに渡される <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> オブジェクトのパラメーターと型を使用する書式指定メソッドの一部を次の表に示します。  
+  
+|メソッド|`formatType` パラメーターの型|  
+|----------|---------------------------|  
+|数値型の `ToString` メソッド|<xref:System.Globalization.NumberFormatInfo?displayProperty=fullName>|  
+|日付\/時刻型の `ToString` メソッド|<xref:System.Globalization.DateTimeFormatInfo?displayProperty=fullName>|  
+|<xref:System.String.Format%2A?displayProperty=fullName>|<xref:System.ICustomFormatter?displayProperty=fullName>|  
+|<xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName>|<xref:System.ICustomFormatter?displayProperty=fullName>|  
+  
+> [!NOTE]
+>  数値型および日付\/時刻型の `ToString` メソッドはオーバーロードされますが、<xref:System.IFormatProvider> パラメーターが含まれるのはそのうちの一部のオーバーロードだけです。 メソッドに <xref:System.IFormatProvider> 型のパラメーターがない場合は、代わりに <xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティによって返されるオブジェクトが渡されます。 たとえば、既定の <xref:System.Int32.ToString?displayProperty=fullName> メソッドの呼び出しの場合は、最終的には `Int32.ToString("G", System.Globalization.CultureInfo.CurrentCulture)` のようなメソッド呼び出しになります。  
+  
+ .NET Framework には、<xref:System.IFormatProvider> を実装する次の 3 つのクラスが用意されています。  
+  
+-   <xref:System.Globalization.DateTimeFormatInfo>。このクラスは、特定のカルチャの日付と時刻の値に対する書式設定情報を提供します。 対応する <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> の実装では、単にそれ自身のインスタンスが返されます。  
+  
+-   <xref:System.Globalization.NumberFormatInfo>。このクラスは、特定のカルチャの数値に対する書式設定情報を提供します。 対応する <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> の実装では、単にそれ自身のインスタンスが返されます。  
+  
+-   <xref:System.Globalization.CultureInfo>. 対応する <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> の実装では、数値に対する書式設定情報を提供する <xref:System.Globalization.NumberFormatInfo> オブジェクトか、日付と時刻の値に対する書式設定情報を提供する <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのいずれかが返されます。  
+  
+ また、これらのクラスのうちのいずれかを置き換える独自の書式プロバイダーを実装できます。 ただし、実装の <xref:System.IFormatProvider.GetFormat%2A> メソッドは、書式設定情報を `ToString` メソッドに渡す場合、前の表に示した型のオブジェクトを返す必要があります。  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="numericCulture"></a>   
+### 数値のカルチャに依存した書式設定  
+ 既定では、数値の書式指定はカルチャに依存します。 書式指定メソッドを呼び出すときにカルチャを指定しない場合は、現在のスレッド カルチャの書式指定規則が使用されます。 次に示す例では、現在のスレッド カルチャを 4 回変更した後に、<xref:System.Decimal.ToString%28System.String%29?displayProperty=fullName> メソッドを呼び出します。 各ケースでは、結果の文字列は、現在のカルチャの書式指定規則を反映します。 これは、各数値型の `ToString` メソッドへの呼び出しを、`ToString(String)` メソッドと `ToString(String, IFormatProvider)` メソッドがラップするためです。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/culturespecific3.cs#19)]
+ [!code-vb[Conceptual.Formatting.Overview#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/culturespecific3.vb#19)]  
+  
+ また、`ToString` パラメーターを持つ `provider` オーバーロードを呼び出して、次のどちらかを渡すことにより、特定カルチャの数値を書式指定することもできます。  
+  
+-   使用される書式指定規則のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクト。 その <xref:System.Globalization.CultureInfo.GetFormat%2A?displayProperty=fullName> メソッドは、<xref:System.Globalization.CultureInfo.NumberFormat%2A?displayProperty=fullName> プロパティの値を返します。このプロパティは、数値にカルチャ固有の書式指定情報を提供する <xref:System.Globalization.NumberFormatInfo> オブジェクトです。  
+  
+-   使用されるカルチャ固有の書式指定規則を定義する <xref:System.Globalization.NumberFormatInfo> オブジェクト。 その <xref:System.Globalization.NumberFormatInfo.GetFormat%2A> メソッドでは、それ自身のインスタンスが返されます。  
+  
+ 次の例では、浮動小数点数を書式指定する際に、英語 \(米国\) と英語 \(英国\) のカルチャおよびフランス語とロシア語のニュートラル カルチャを表す <xref:System.Globalization.NumberFormatInfo> オブジェクトを使用します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/culturespecific4.cs#20)]
+ [!code-vb[Conceptual.Formatting.Overview#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/culturespecific4.vb#20)]  
+  
+<a name="dateCulture"></a>   
+### 日付と時刻の値のカルチャに依存した書式設定  
+ 既定では、日時の値の書式指定はカルチャに依存します。 書式指定メソッドを呼び出すときにカルチャを指定しない場合は、現在のスレッド カルチャの書式指定規則が使用されます。 次に示す例では、現在のスレッド カルチャを 4 回変更した後に、<xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> メソッドを呼び出します。 各ケースでは、結果の文字列は、現在のカルチャの書式指定規則を反映します。 これは、<xref:System.DateTime.ToString?displayProperty=fullName>、<xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName>、<xref:System.DateTimeOffset.ToString?displayProperty=fullName>、<xref:System.DateTimeOffset.ToString%28System.String%29?displayProperty=fullName> の各メソッドが、<xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> メソッドおよび <xref:System.DateTimeOffset.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> メソッドへの呼び出しをラップするためです。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/culturespecific1.cs#17)]
+ [!code-vb[Conceptual.Formatting.Overview#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/culturespecific1.vb#17)]  
+  
+ <xref:System.DateTime.ToString%2A?displayProperty=fullName> パラメーターを持つ <xref:System.DateTimeOffset.ToString%2A?displayProperty=fullName> または `provider` オーバーロードを呼び出して、次のどちらかを渡すことにより、特定カルチャの日時の値を書式指定することもできます。  
+  
+-   使用される書式指定規則のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクト。 その <xref:System.Globalization.CultureInfo.GetFormat%2A?displayProperty=fullName> メソッドは、<xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティの値を返します。このプロパティは、日時の値にカルチャ固有の書式指定情報を提供する <xref:System.Globalization.DateTimeFormatInfo> オブジェクトです。  
+  
+-   使用されるカルチャ固有の書式指定規則を定義する <xref:System.Globalization.DateTimeFormatInfo> オブジェクト。 その <xref:System.Globalization.DateTimeFormatInfo.GetFormat%2A> メソッドでは、それ自身のインスタンスが返されます。  
+  
+ 次の例では、日付を書式指定する際に、英語 \(米国\) と英語 \(英国\) のカルチャおよびフランス語とロシア語のニュートラル カルチャを表す <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを使用します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/culturespecific2.cs#18)]
+ [!code-vb[Conceptual.Formatting.Overview#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/culturespecific2.vb#18)]  
+  
+<a name="IFormattable"></a>   
+## IFormattable インターフェイス  
+ 通常、書式指定文字列および `ToString` パラメーターを使用して <xref:System.IFormatProvider> メソッドをオーバーロードする型は、<xref:System.IFormattable> インターフェイスも実装します。 このインターフェイスには、<xref:System.IFormattable.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> という単一のメンバーがあります。このメンバーには、パラメーターとして書式指定文字列と書式プロバイダーの両方が含まれています。  
+  
+ アプリケーション定義のクラスに <xref:System.IFormattable> インターフェイスを実装した場合、2 つの利点があります。  
+  
+-   <xref:System.Convert> クラスによる文字列変換がサポートされます。<xref:System.Convert.ToString%28System.Object%29?displayProperty=fullName> メソッドおよび <xref:System.Convert.ToString%28System.Object%2CSystem.IFormatProvider%29?displayProperty=fullName> メソッドを呼び出すと、自動的に <xref:System.IFormattable> の実装が呼び出されます。  
+  
+-   複合書式指定がサポートされます。 書式指定文字列を含む書式指定項目を使用してカスタムの型の書式を設定する場合に、共通言語ランタイムによって自動的に <xref:System.IFormattable> の実装が呼び出され、それに書式指定文字列が渡されます。<xref:System.String.Format%2A?displayProperty=fullName> メソッドや <xref:System.Console.WriteLine%2A?displayProperty=fullName> メソッドを使用した複合書式指定の詳細については、「[複合書式指定](#CompositeFormatting)」のセクションを参照してください。  
+  
+ 次の例では、`Temperature` インターフェイスを実装する <xref:System.IFormattable> クラスを定義しています。 このクラスでは、温度を摂氏で表示するために "C" 書式指定子または "G" 書式指定子、華氏で表示するために "F" 書式指定子、ケルビンで表示するために "K" 書式指定子をそれぞれサポートしています。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/iformattable.cs#12)]
+ [!code-vb[Conceptual.Formatting.Overview#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/iformattable.vb#12)]  
+  
+ 次の例では、`Temperature` オブジェクトをインスタンス化しています。 その後、<xref:System.Convert.ToString%2A> メソッドを呼び出し、いくつかの複合書式指定文字列を使用して `Temperature` オブジェクトのさまざまな文字列形式を取得します。 さらに、それらの各メソッド呼び出しで、<xref:System.IFormattable> クラスの `Temperature` 実装を呼び出しています。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/iformattable.cs#13)]
+ [!code-vb[Conceptual.Formatting.Overview#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/iformattable.vb#13)]  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="CompositeFormatting"></a>   
+## 複合書式指定  
+ <xref:System.String.Format%2A?displayProperty=fullName> や <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName> などの一部のメソッドでは、複合書式指定がサポートされます。 複合書式指定文字列は一種のテンプレートで、0 個以上のオブジェクトの文字列形式が組み込まれた単一の文字列を返します。 各オブジェクトは、インデックス付きの書式指定項目によって、複合書式指定文字列で表現されます。 書式指定項目のインデックスは、それが表すオブジェクトのメソッドのパラメーター リスト内の位置と対応しています。 インデックスは 0 から始まります。 たとえば、<xref:System.String.Format%2A?displayProperty=fullName> メソッドの次のメソッド呼び出しでは、最初の書式指定項目 `{0:D}` は `thatDate` の文字列形式に、2 番目の書式指定項目 `{1}` は `item1` の文字列形式に、3 番目の書式指定項目 `{2:C2}` は `item1.Value` の文字列形式に置き換えられます。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/composite1.cs#14)]
+ [!code-vb[Conceptual.Formatting.Overview#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/composite1.vb#14)]  
+  
+ 書式項目をそれに対応するオブジェクトの文字列形式に置換することに加えて、書式項目は以下を制御することもできます。  
+  
+-   オブジェクトを文字列として表現する特定の方法 \(オブジェクトが <xref:System.IFormattable> インターフェイスを実装し、書式文字列をサポートする場合\)。 これは、`:` \(コロン\) 付きの書式項目のインデックスに、有効な書式文字列を続けることによります。 前の例では、日付の値を "d" \(短い日付のパターン\) 書式文字列 \(`{0:d}` など\) を書式設定し、数値を "C2" 書式文字列 \(`{2:C2}` など\) で書式設定して数値を 2 桁の小数部を含む 10 進数を持つ通貨値で表していました。  
+  
+-   オブジェクトの文字列形式を含むフィールドの幅、およびそのフィールドの文字列形式の配置。 これは、`,` \(コンマ\) 付きの書式項目のインデックスに、フィールドの幅を続けることによります。 フィールドの幅が正の値の場合、文字列はフィールドで右揃えにし、フィールドの幅が負の値の場合、左揃えにします。 次の例では、20 文字のフィールドで日付の値を左揃えにし、11 文字のフィールドで、1 桁の小数部を含む 10 進数値を右揃えにします。  
+  
+     [!code-csharp[Conceptual.Formatting.Overview#22](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/composite2.cs#22)]
+     [!code-vb[Conceptual.Formatting.Overview#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/composite2.vb#22)]  
+  
+     配置文字列コンポーネントと書式文字列コンポーネントの両方が存在する場合、前者は後者の前にきます \(たとえば `{0,-20:g}`\)。  
+  
+ 複合書式指定の詳細については、「[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)」を参照してください。  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="Custom"></a>   
+## ICustomFormatter を使用したカスタム書式設定  
+ [String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> および [StringBuilder.AppendFormat\(IFormatProvider, String, Object\<xref:System.Text.StringBuilder.AppendFormat%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> の 2 つの複合書式指定メソッドには、カスタム書式設定をサポートしている書式プロバイダー パラメーターが含まれています。 これらの書式指定メソッドのいずれかを呼び出すと、書式プロバイダーの <xref:System.Type> メソッドに <xref:System.ICustomFormatter> インターフェイスを表す <xref:System.IFormatProvider.GetFormat%2A> オブジェクトが渡されます。 次に、<xref:System.IFormatProvider.GetFormat%2A> メソッドによって、カスタム書式設定を提供する <xref:System.ICustomFormatter> の実装が返されます。  
+  
+ <xref:System.ICustomFormatter> インターフェイスには、<xref:System.ICustomFormatter.Format%28System.String%2CSystem.Object%2CSystem.IFormatProvider%29> という単一のメソッドがあります。このメソッドは、複合書式指定文字列の書式指定項目ごとに 1 回、複合書式指定メソッドによって自動的に呼び出されます。<xref:System.ICustomFormatter.Format%28System.String%2CSystem.Object%2CSystem.IFormatProvider%29> メソッドには、3 つのパラメーターがあります。書式指定項目の `formatString` 引数を表す書式指定文字列、書式を設定するオブジェクト、および書式指定サービスを提供する <xref:System.IFormatProvider> オブジェクトの 3 つです。 通常は、<xref:System.ICustomFormatter> を実装するクラスでは <xref:System.IFormatProvider> も実装するため、この最後のパラメーターはカスタム書式指定クラス自体への参照になります。 このメソッドは、書式を設定するオブジェクトのカスタム書式の文字列形式を返します。 オブジェクトの書式を設定できない場合は、null 参照 \(Visual Basic の場合は `Nothing`\) を返します。  
+  
+ 整数値を 2 桁の 16 進値とそれに続く 1 つの空白のシーケンスとして表示する、<xref:System.ICustomFormatter> という名前の `ByteByByteFormatter` の実装の例を次に示します。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/icustomformatter1.cs#15)]
+ [!code-vb[Conceptual.Formatting.Overview#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/icustomformatter1.vb#15)]  
+  
+ `ByteByByteFormatter` クラスを使用して整数値の書式を設定する例を次に示します。<xref:System.ICustomFormatter.Format%2A?displayProperty=fullName> メソッドが 2 回目の [String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッド呼び出しで複数回呼び出されることに注意してください。また、<xref:System.Globalization.NumberFormatInfo> メソッドが "N0" 書式指定文字列を認識せず、null 参照 \(Visual Basic の場合は `ByteByByteFormatter.Format`\) を返すため、3 回目のメソッド呼び出しでは既定の `Nothing` プロバイダーが使用されていることに注意してください。  
+  
+ [!code-csharp[Conceptual.Formatting.Overview#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.formatting.overview/cs/icustomformatter1.cs#16)]
+ [!code-vb[Conceptual.Formatting.Overview#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.formatting.overview/vb/icustomformatter1.vb#16)]  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="RelatedTopics"></a>   
+## 関連トピック  
+  
+|タイトル|定義|  
+|----------|--------|  
+|[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)|数値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)|数値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)|<xref:System.DateTime> 値に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)|<xref:System.DateTime> 値に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[標準の時間間隔書式指定文字列](../../../docs/standard/base-types/standard-timespan-format-strings.md)|時間間隔に対して一般的に使用される文字列形式を作成する標準書式指定文字列について説明します。|  
+|[カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)|時間間隔に対するアプリケーション固有の文字列形式を作成するカスタム書式指定文字列について説明します。|  
+|[列挙型書式指定文字列](../../../docs/standard/base-types/enumeration-format-strings.md)|列挙型の文字列形式を作成するために使用される標準書式指定文字列について説明します。|  
+|[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)|文字列に 1 つ以上の書式指定された値を埋め込む方法について説明します。 この文字列は、コンソールに表示したり、ストリームに書き込んだりできます。|  
+|[書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)|特定の書式設定操作を行うための手順を説明するトピックの一覧を示します。|  
+|[文字列の解析](../../../docs/standard/base-types/parsing-strings.md)|オブジェクトの文字列表現によって指定された値にオブジェクトを初期化する方法について説明します。 解析は書式設定の逆の操作です。|  
+  
+ [ページのトップへ](#Introduction)  
+  
+<a name="Reference"></a>   
+## 参照  
+ <xref:System.IFormattable?displayProperty=fullName>  
+  
+ <xref:System.IFormatProvider?displayProperty=fullName>  
+  
+ <xref:System.ICustomFormatter?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/base-types/grouping-constructs-in-regular-expressions.md b/docs/standard/base-types/grouping-constructs-in-regular-expressions.md
new file mode 100644
index 00000000000..aed514dfcd8
--- /dev/null
+++ b/docs/standard/base-types/grouping-constructs-in-regular-expressions.md
@@ -0,0 +1,476 @@
+---
+title: "正規表現でのグループ化構成体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, グループ化構成体"
+  - "構成体, グループ化"
+  - "グループ化構成体"
+  - "先読み"
+  - "後読み"
+  - "正規表現, グループ化構成体"
+ms.assetid: 0fc18634-f590-4062-8d5c-f0b71abe405b
+caps.latest.revision: 33
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# 正規表現でのグループ化構成体
+グループ化構成体は、正規表現の部分式を表し、入力文字列の部分文字列をキャプチャします。 グループ化構成体を使用して、以下を実行できます。  
+  
+-   入力文字列で繰り返し使用されている部分式を照合する。  
+  
+-   複数の正規表現言語要素を含む部分式に量指定子を適用する。 量指定子について詳しくは、「[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)」をご覧ください。  
+  
+-   <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドおよび <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドによって返される文字列に部分式を含める。  
+  
+-   <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> プロパティから個々の部分式を取得し、一致したテキスト全体とは別に処理する。  
+  
+ 次の表に、.NET Framework 正規表現エンジンでサポートされているグループ化構成体と、これらの構成体がキャプチャまたは非キャプチャのいずれであるかを示します。  
+  
+|グループ化構成体|キャプチャまたは非キャプチャ|  
+|--------------|--------------------|  
+|[一致した部分式](#matched_subexpression)|キャプチャ|  
+|[一致した名前付き部分式](#named_matched_subexpression)|キャプチャ|  
+|[グループ定義の均等化](#balancing_group_definition)|キャプチャ|  
+|[非キャプチャ グループ](#noncapturing_group)|非キャプチャ|  
+|[グループ オプション](#group_options)|非キャプチャ|  
+|[ゼロ幅の肯定先読みアサーション](#zerowidth_positive_lookahead_assertion)|非キャプチャ|  
+|[ゼロ幅の否定先読みアサーション](#zerowidth_negative_lookahead_assertion)|非キャプチャ|  
+|[ゼロ幅の正の後読みアサーション](#zerowidth_positive_lookbehind_assertion)|非キャプチャ|  
+|[ゼロ幅の負の後読みアサーション](#zerowidth_negative_lookbehind_assertion)|非キャプチャ|  
+|[非バックトラッキング部分式](#nonbacktracking_subexpression)|非キャプチャ|  
+  
+ グループと正規表現オブジェクト モデルの詳細については、「[グループ化構成体および正規表現オブジェクト](#Objects)」を参照してください。  
+  
+<a name="matched_subexpression"></a>   
+## 一致した部分式  
+ 次のグループ化構成体は、一致した部分式をキャプチャします。  
+  
+ `(` *subexpression* `)`  
+  
+ ここで、*subexpression* は有効な正規表現パターンです。 かっこを使用するキャプチャには、正規表現の左かっこの順番に基づいて、左から右に自動的に 1 から始まる番号が付けられます。 番号が 0 になるキャプチャは、正規表現パターン全体と一致するテキストです。  
+  
+> [!NOTE]
+>  既定では、`(`*subexpression*`)` 言語要素が、一致する部分式をキャプチャします。 ただし、正規表現パターン一致メソッドの <xref:System.Text.RegularExpressions.RegexOptions> パラメーターに <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> フラグが含まれる場合や、`n` オプションがこの部分式に適用される場合は \(このトピックで後述する「[グループ オプション](#group_options)」を参照\)、一致した部分式はキャプチャされません。  
+  
+ キャプチャされたグループにアクセスする方法は 4 つあります。  
+  
+-   正規表現内で前方参照構成体を使用する。`\`*number* という構文を使うと、一致した部分式が同じ正規表現内で参照されます。ここで、*number* はキャプチャされた部分式の序数です。  
+  
+-   正規表現内で名前付き前方参照構成体を使用する。`\k<`*name*`>` \(*name* はキャプチャ グループの名前\) や、`\k<`*number*`>` \(*number* はキャプチャ グループの序数\) という構文を使うと、一致した部分式が同じ正規表現内で参照されます。 キャプチャ グループには、その序数と同じ既定の名前が付いています。 詳細については、このトピックで後述する「[一致した名前付き部分式](#named_matched_subexpression)」を参照してください。  
+  
+-   `$` *number* 置換シーケンスを <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドや <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドの呼び出しで使用する。ここで、*number* はキャプチャされた部分式の序数です。  
+  
+-   プログラムで <xref:System.Text.RegularExpressions.GroupCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> オブジェクトを使用する。 コレクション内の位置 0 にあるメンバーは、正規表現に一致した文字列全体を表します。 後続の各メンバーは、一致した部分式を表します。 詳しくは、「[グループ化構成体および正規表現オブジェクト](#Objects)」セクションをご覧ください。  
+  
+ 次の例は、テキスト内で重複している単語を識別する正規表現を示しています。 正規表現パターンの 2 つのキャプチャ グループは、2 つの重複する単語を表します。 2 番目の単語は、入力文字列内の開始位置を報告するためにキャプチャされます。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/grouping1.cs#1)]
+ [!code-vb[RegularExpressions.Language.Grouping#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/grouping1.vb#1)]  
+  
+ 正規表現パターンは次のとおりです。  
+  
+```  
+(\w+)\s(\1)\W  
+```  
+  
+ 次の表に、正規表現パターンがどのように解釈されるかを示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これが最初のキャプチャ グループです。|  
+|`\s`|空白文字と一致します。|  
+|`(\1)`|最初のキャプチャ グループの文字列と一致します。 これが 2 番目のキャプチャ グループです。 例では、これをキャプチャ グループに割り当てて、重複する単語の開始位置を `Match.Index` プロパティから取得できるようにしています。|  
+|`\W`|空白や句読点などの単語文字以外の文字と一致します。 これにより、正規表現パターンが、最初のキャプチャ グループの単語で始まる単語と一致しなくなります。|  
+  
+<a name="named_matched_subexpression"></a>   
+## 一致した名前付き部分式  
+ 次のグループ化構成体は、一致した部分式をキャプチャし、その部分式に名前または番号でアクセスできるようにします。  
+  
+```  
+(?<name>subexpression)  
+```  
+  
+ または  
+  
+```  
+(?'name'subexpression)  
+```  
+  
+ ここで、*name* は有効なグループ名、*subexpression* は有効な正規表現パターンです。*name* は区切り記号を含まず、先頭が数字以外である必要があります。  
+  
+> [!NOTE]
+>  正規表現パターン一致メソッドの <xref:System.Text.RegularExpressions.RegexOptions> パラメーターに <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> フラグが含まれる場合や、`n` オプションがこの部分式に適用される場合 \(このトピックで後述する「[グループ オプション](#group_options)」を参照\)、部分式をキャプチャする唯一の方法は、キャプチャ グループの名前を明示的に指定することです。  
+  
+ キャプチャされた名前付きグループには次の方法でアクセスできます。  
+  
+-   正規表現内で名前付き前方参照構成体を使用する。`\k<`*name*`>` という構文を使うと、一致した部分式が同じ正規表現内で参照されます。ここで、*name* はキャプチャされた部分式の名前です。  
+  
+-   正規表現内で前方参照構成体を使用する。`\`*number* という構文を使うと、一致した部分式が同じ正規表現内で参照されます。ここで、*number* はキャプチャされた部分式の序数です。 一致した名前付き部分式には、一致した部分式の後、左から右に連続した番号が付けられます。  
+  
+-   `${` *name* `}` 置換シーケンスを、<xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドや <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドの呼び出しで使用する。ここで、*name* はキャプチャされた部分式の名前です。  
+  
+-   `$` *number* 置換シーケンスを <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドや <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドの呼び出しで使用する。ここで、*number* はキャプチャされた部分式の序数です。  
+  
+-   プログラムで <xref:System.Text.RegularExpressions.GroupCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> オブジェクトを使用する。 コレクション内の位置 0 にあるメンバーは、正規表現に一致した文字列全体を表します。 後続の各メンバーは、一致した部分式を表します。 キャプチャされた名前付きグループは、キャプチャされた番号付きグループの後にコレクションに格納されます。  
+  
+-   プログラムで <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトのインデクサー \(C\# の場合\) またはその <xref:System.Text.RegularExpressions.GroupCollection.Item%2A> プロパティ \(Visual Basic の場合\) に部分式名を指定する。  
+  
+ 簡単な正規表現パターンで、プログラムまたは正規表現言語構文を使用して番号付き \(名前のない\) グループおよび名前付きグループをどのように参照できるかを示します。 正規表現 `((?<One>abc)\d+)?(?<Two>xyz)(.*)`  からは、次のように番号と名前の付いたキャプチャ グループが作成されます。 最初のキャプチャ グループ \(番号 0\) は、常にパターン全体を指します。  
+  
+|Number|名前|パターン|  
+|------------|--------|----------|  
+|0|0 \(既定名\)|`((?<One>abc)\d+)?(?<Two>xyz)(.*)`|  
+|1|1 \(既定名\)|`((?<One>abc)\d+)`|  
+|2|2 \(既定名\)|`(.*)`|  
+|3|1|`(?<One>abc)`|  
+|4|2|`(?<Two>xyz)`|  
+  
+ 次の例は、重複している単語、および重複している各単語の直後にある単語を識別する正規表現を示しています。 この正規表現パターンでは、重複している単語を表す `duplicateWord` と重複している単語の後にある単語を表す `nextWord` の 2 つの名前付き部分式を定義しています。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#2](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/grouping2.cs#2)]
+ [!code-vb[RegularExpressions.Language.Grouping#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/grouping2.vb#2)]  
+  
+ 正規表現パターンは次のとおりです。  
+  
+```  
+(?<duplicateWord>\w+)\s\k<duplicateWord>\W(?<nextWord>\w+)  
+```  
+  
+ 次の表に、正規表現がどのように解釈されるかを示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(?<duplicateWord>\w+)`|1 つ以上の単語文字に一致します。 このキャプチャ グループに `duplicateWord` という名前を付けます。|  
+|`\s`|空白文字と一致します。|  
+|`\k<duplicateWord>`|`duplicateWord` という名前のキャプチャ済みグループの文字列と一致します。|  
+|`\W`|空白や句読点などの単語文字以外の文字と一致します。 これにより、正規表現パターンが、最初のキャプチャ グループの単語で始まる単語と一致しなくなります。|  
+|`(?<nextWord>\w+)`|1 つ以上の単語文字に一致します。 このキャプチャ グループに `nextWord` という名前を付けます。|  
+  
+ グループ名は、正規表現で繰り返し使用できます。 たとえば、次の例が示すように、複数のグループに `digit` という名前を付けることができます。 名前が重複する場合、<xref:System.Text.RegularExpressions.Group> オブジェクトの値は、入力文字列の最後の正常なキャプチャによって決定されます。 さらに、グループ名が重複されない場合と同じように、各キャプチャについての情報が <xref:System.Text.RegularExpressions.CaptureCollection> 格納されます。  
+  
+ 次の例では、正規表現 `\D+(?<digit>\d+)\D+(?<digit>\d+)?` に `digit` という名前のグループの 2 回の出現が含まれています。 最初の `digit` という名前のグループは、1 桁以上の数字をキャプチャします。 2 番目の `digit` という名前のグループは、1 桁以上の数字の 0 回か 1 回の出現をキャプチャします。 例の出力が示すように、2 番目のキャプチャ グループがテキストと正常に一致する場合、そのテキストの値は <xref:System.Text.RegularExpressions.Group> オブジェクトの値を定義します。 2 番目のキャプチャ グループが入力文字列と一致しない場合、最後に成功した一致の値によって <xref:System.Text.RegularExpressions.Group> オブジェクトの値が定義されます。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#12](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/duplicate1.cs#12)]
+ [!code-vb[RegularExpressions.Language.Grouping#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/duplicate1.vb#12)]  
+  
+ 次の表に、正規表現がどのように解釈されるかを示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\D+`|1 個以上の 10 進数以外の文字と一致します。|  
+|`(?<digit>\d+)`|1 個以上の 10 進数の文字と一致します。 一致を `digit` という名前のグループに割り当てます。|  
+|\\D\+|1 個以上の 10 進数以外の文字と一致します。|  
+|`(?<digit>\d+)?`|1 つ以上の 10 進数の文字の 0 回または 1 回の出現と一致します。 一致を `digit` という名前のグループに割り当てます。|  
+  
+<a name="balancing_group_definition"></a>   
+## グループ定義の均等化  
+ グループ定義の均等化では、既に定義されていたグループの定義を削除し、既に定義されていたグループと現在のグループの間隔を現在のグループに格納します。 このグループ化構成体の形式は次のとおりです。  
+  
+```  
+(?<name1-name2>subexpression)  
+```  
+  
+ または  
+  
+```  
+(?'name1-name2' subexpression)  
+```  
+  
+ ここで、*name1* は現在のグループ \(省略可能\) で、*name2* は既に定義されていたグループで、*subexpression* は有効な正規表現パターンです。 グループ定義の均等化では、*name2* の定義を削除し、*name2* と *name1* の間隔を *name1* に格納します。*name2* グループが定義されていない場合、一致はバックトラックされます。*name2* の最後の定義を削除すると、*name2* の以前の定義がわかるため、この構成体によって、かっこや左右の角かっこなど入れ子になった構成体を追跡するカウンターとして *name2* グループのキャプチャのスタックを使用できます。  
+  
+ グループ定義の均等化では、*name2* をスタックとして使用します。 入れ子になった各構成体の開始文字が、グループとその <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> コレクションに配置されます。 終了文字が一致すると、対応する開始文字がグループから削除され、<xref:System.Text.RegularExpressions.Group.Captures%2A> コレクションが 1 つ減らされます。 入れ子になったすべての構成体の開始文字と終了文字が一致したら、*name1* は空になります。  
+  
+> [!NOTE]
+>  入れ子になった構成体の適切な開始文字と終了文字を使用するように次の例の正規表現を変更すると、その正規表現を使用して、複数の入れ子になったメソッド呼び出しを含む数式やプログラム コード行などのほとんどの入れ子になった構成体を処理できるようになります。  
+  
+ 次の例では、グループ定義の均等化を使用して、入力文字列内の左と右の山かっこ \(\<\>\) を一致させています。 この例では、一致する山かっこのペアを追跡するスタックのように使用される `Open` および `Close` という 2 つの名前付きグループを定義しています。 キャプチャされた各左山かっこは `Open` グループのキャプチャ コレクションに挿入され、キャプチャされた各右山かっこは `Close` グループのキャプチャ コレクションに挿入されます。 グループ定義の均等化によって、各左山かっこに一致する右山かっこが存在することが確認されます。 存在しない場合、最後のサブパターンの `(?(Open)(?!))` は、`Open` グループが空でない場合 \(したがって、いくつかの入れ子になった構成体に右山かっこがない場合\) にのみ評価されます。 最後のサブパターンが評価されると、`(?!)` サブパターンが必ず失敗するゼロ幅の否定先読みアサーションであるため、照合は失敗します。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#3](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/grouping3.cs#3)]
+ [!code-vb[RegularExpressions.Language.Grouping#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/grouping3.vb#3)]  
+  
+ 正規表現パターンは次のとおりです。  
+  
+```  
+^[^<>]*(((?'Open'<)[^<>]*)+((?'Close-Open'>)[^<>]*)+)*(?(Open)(?!))$  
+```  
+  
+ この正規表現パターンは、次のように解釈されます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から始まります。|  
+|`[^<>]*`|左または右の山かっこではない 0 個以上の文字と一致します。|  
+|`(?'Open'<)`|左山かっこと一致し、そのかっこを `Open` という名前のグループに代入します。|  
+|`[^<>]*`|左または右の山かっこではない 0 個以上の文字と一致します。|  
+|`((?'Open'<)[^<>]*) +`|左山かっこの後に左または右の山かっこではない 0 個以上の文字が続くパターンの 1 回以上の出現と一致します。 これが 2 番目のキャプチャ グループです。|  
+|`(?'Close-Open'>)`|右山かっこと一致し、`Open` グループと現在のグループの間の部分文字列を `Close` グループに代入して、`Open` グループの定義を削除します。|  
+|`[^<>]*`|左または右の山かっこではない任意の文字の 0 回以上の出現と一致します。|  
+|`((?'Close-Open'>)[^<>]*)+`|右山かっこの後に左または右の山かっこではない任意の文字の 0 回以上の出現が続くパターンの 1 回以上の出現と一致します。 右山かっこと一致したときに、`Open` グループと現在のグループの間の部分文字列を `Close` グループに代入して、`Open` グループの定義を削除します。 これが 3 番目のキャプチャ グループです。|  
+|`(((?'Open'<)[^<>]*)+((?'Close-Open'>)[^<>]*)+)*`|左山かっこの 1 回以上の出現の後に山かっこではない 0 個以上の文字が続き、その後に右山かっこの 1 回以上の出現が続き、その後に山かっこ以外の 0 回以上の出現が続くパターンの 0 回以上の出現と一致します。 右山かっこと一致したときに、`Open` グループの定義を削除して、`Open` グループと現在のグループの間の部分文字列を `Close` グループに代入します。 これが最初のキャプチャ グループです。|  
+|`(?(Open)(?!))`|`Open` グループが存在し、空の文字列が一致する場合、照合を破棄してください。ただし、文字列内での正規表現エンジンの位置は進めないでください。 これはゼロ幅の否定先読みアサーションです。 空の文字列が常に入力文字列に暗黙的に存在するため、この照合は必ず失敗します。 この照合の失敗は、山かっこの数が一致していないことを示します。|  
+|`$`|入力文字列の末尾と一致します。|  
+  
+ 最後の部分式の `(?(Open)(?!))` は、入力文字列内の入れ子の構成体の数が一致しているかどうかを示します \(各左山かっこに一致する右山かっこが存在するかどうかなど\)。 有効なキャプチャ グループに基づく条件一致を使います。詳しくは、「[代替構成体](../../../docs/standard/base-types/alternation-constructs-in-regular-expressions.md)」をご覧ください。`Open` グループが定義されている場合は、正規表現エンジンによって、入力文字列内で部分式 `(?!)` の照合が試行されます。`Open` グループは、入れ子の構成体の数が一致していない場合にのみ定義する必要があります。 したがって、入力文字列で照合されるパターンでは、照合は常に失敗します。 この場合、`(?!)` は、常に失敗するゼロ幅の否定先読みアサーションです。入力文字列内の次の位置に、必ず空の文字列が暗黙的に存在するためです。  
+  
+ この例では、正規表現エンジンによって、次の表に示すように入力文字列 "\<abc\>\<mno\<xyz\>\>" が評価されます。  
+  
+|手順|パターン|結果|  
+|--------|----------|--------|  
+|1|`^`|入力文字列の先頭から照合を開始します。|  
+|2|`[^<>]*`|左山かっこの前にある山かっこではない文字を検索します。一致する項目は見つかりません。|  
+|3|`(((?'Open'<)`|"\<abc\>" の左山かっこと一致し、そのかっこを `Open` グループに代入します。|  
+|4|`[^<>]*`|"abc" と一致します。|  
+|5|`)+`|"\<abc" が 2 番目のキャプチャ グループの値になります。<br /><br /> 入力文字列内の次の文字は左山かっこではないので、正規表現エンジンは `(?'Open'<)[^<>]*)` サブパターンに戻りません。|  
+|6|`((?'Close-Open'>)`|"\<abc\>" の右山かっこと一致し、`Open` グループと右山かっこの間の部分文字列である "abc" を `Close` グループに代入して、`Open` グループの現在の値 \("\<"\) を削除してグループを空にします。|  
+|7|`[^<>]*`|右山かっこの後にある山かっこではない文字を検索します。一致する項目は見つかりません。|  
+|8|`)+`|3 番目のキャプチャ グループの値は "\>" です。<br /><br /> 入力文字列内の次の文字は右山かっこではないので、正規表現エンジンは `((?'Close-Open'>)[^<>]*)` サブパターンに戻りません。|  
+|9|`)*`|最初のキャプチャ グループの値は "\<abc\>" です。<br /><br /> 入力文字列内の次の文字は左山かっこなので、正規表現エンジンは `(((?'Open'<)` サブパターンに戻ります。|  
+|10|`(((?'Open'<)`|"\<mno\>" の左山かっこと一致し、そのかっこを `Open` グループに代入します。 その <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> コレクションには、現在、単一の値 "\<" が含まれています。|  
+|11|`[^<>]*`|"mno" と一致します。|  
+|12|`)+`|"\<mno" が 2 番目のキャプチャ グループの値になります。<br /><br /> 入力文字列内の次の文字は左山かっこなので、正規表現エンジンは `(?'Open'<)[^<>]*)` サブパターンに戻ります。|  
+|13|`(((?'Open'<)`|"\<xyz\>" の左山かっこと一致し、そのかっこを `Open` グループに代入します。<xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> グループの `Open` コレクションには、現在、"\<mno\>" の左山かっこと "\<xyz\>" の左山かっこの 2 つのキャプチャが含まれています。|  
+|14|`[^<>]*`|"xyz" と一致します。|  
+|15|`)+`|"\<xyz" が 2 番目のキャプチャ グループの値になります。<br /><br /> 入力文字列内の次の文字は左山かっこではないので、正規表現エンジンは `(?'Open'<)[^<>]*)` サブパターンに戻りません。|  
+|16|`((?'Close-Open'>)`|"\<xyz\>" の右山かっこと一致します。 "xyz" は `Open` グループと右山かっこの間の部分文字列を `Close` グループに代入して、`Open` グループの現在の値を削除します。 前のキャプチャの値 \("\<mno\>" の左山かっこ\) が `Open` グループの現在の値になります。<xref:System.Text.RegularExpressions.Group.Captures%2A> グループの `Open` コレクションには、現在、単一のキャプチャ \("\<xyz\>" の左山かっこ\) が含まれています。|  
+|17|`[^<>]*`|山かっこではない文字を検索します。一致する項目は見つかりません。|  
+|18|`)+`|3 番目のキャプチャ グループの値は "\>" です。<br /><br /> 入力文字列内の次の文字は右山かっこなので、正規表現エンジンは `((?'Close-Open'>)[^<>]*)` サブパターンに戻ります。|  
+|19|`((?'Close-Open'>)`|"xyz\>\>" の最後の右山かっこと一致し、"mno\<xyz\>" \(`Open` グループと右山かっこの間の部分文字列\) を `Close` グループに代入して、`Open` グループの現在の値を削除します。`Open` グループは空になります。|  
+|20|`[^<>]*`|山かっこではない文字を検索します。一致する項目は見つかりません。|  
+|21|`)+`|3 番目のキャプチャ グループの値は "\>" です。<br /><br /> 入力文字列内の次の文字は右山かっこではないので、正規表現エンジンは `((?'Close-Open'>)[^<>]*)` サブパターンに戻りません。|  
+|22|`)*`|最初のキャプチャ グループの値は "\<mno\<xyz\>\>" です。<br /><br /> 入力文字列内の次の文字は左山かっこではないので、正規表現エンジンは `(((?'Open'<)` サブパターンに戻りません。|  
+|23|`(?(Open)(?!))`|`Open` グループは定義されていないので、照合は試行されません。|  
+|24|`$`|入力文字列の末尾と一致します。|  
+  
+<a name="noncapturing_group"></a>   
+## 非キャプチャ グループ  
+ 次のグループ化構成体は、部分式と一致した部分文字列をキャプチャしません。  
+  
+```  
+(?:subexpression)  
+```  
+  
+ ここで、*subexpression* は有効な正規表現パターンです。 非キャプチャ グループ構成体は、通常、量指定子がグループに適用されるがグループによってキャプチャされた部分文字列は対象にならない場合に使用されます。  
+  
+> [!NOTE]
+>  正規表現に入れ子になったグループ化構成体が含まれる場合、外側の非キャプチャ グループ構成体は内側の入れ子になったグループ構成体には適用されません。  
+  
+ 次の例は、非キャプチャ グループを含む正規表現を示しています。 出力には、キャプチャされたグループは含まれません。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#5](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/noncapture1.cs#5)]
+ [!code-vb[RegularExpressions.Language.Grouping#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/noncapture1.vb#5)]  
+  
+ 正規表現 `(?:\b(?:\w+)\W*)+\.` は、ピリオドで終了する文と一致します。 この正規表現は個々の単語ではなく文に焦点を合わせているので、グループ化構成体は量指定子としてのみ使用されます。 この正規表現パターンの解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(?:\w+)`|1 つ以上の単語文字に一致します。 一致したテキストをキャプチャされたグループに代入しません。|  
+|`\W*`|0 個以上の単語文字に使用されない文字と一致します。|  
+|`(?:\b(?:\w+)\W*)+`|ワード境界から始まる 1 個以上の単語文字、および 0 個以上の単語文字に使用されない文字が 1 回以上続くパターンと一致します。 一致したテキストをキャプチャされたグループに代入しません。|  
+|`\.`|ピリオドと一致します。|  
+  
+<a name="group_options"></a>   
+## グループ オプション  
+ 次のグループ化構成体は、指定したオプションを部分式に適用または無効にします。  
+  
+ `(?imnsx-imnsx:` *subexpression* `)`  
+  
+ ここで、*subexpression* は有効な正規表現パターンです。 たとえば、`(?i-s:)` によって、大文字小文字の区別が有効になり単一行モードが無効になります。 指定できるインライン オプションの詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。  
+  
+> [!NOTE]
+>  <xref:System.Text.RegularExpressions.Regex?displayProperty=fullName> クラス コンストラクターまたは静的メソッドを使用すると、部分式ではなく正規表現全体に適用されるオプションを指定できます。 また、`(?imnsx-imnsx)` 言語コンストラクトを使うと、正規表現内の特定の位置より後に適用されるインライン オプションを指定できます。  
+  
+ グループ オプション構成体はキャプチャ グループではありません。 つまり、*subexpression* によってキャプチャされる文字列の一部は一致に含まれますが、キャプチャ グループに含まれることも <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトにデータを設定するために使用されることもありません。  
+  
+ たとえば、次の例の正規表現 `\b(?ix: d \w+)\s` では、グループ化構成体のインライン オプションを使用して、文字 "d" で始まるすべての単語を識別するときに、大文字と小文字を区別しない一致を有効にすると同時に、パターンの空白を無視します。 正規表現は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(?ix: d \w+)`|大文字と小文字を区別しない一致を使用してこのパターンの空白を無視し、"d" の後に単語文字に使用される文字が 1 個以上続くパターンと一致します。|  
+|`\s`|空白文字と一致します。|  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/example1.cs#8)]
+ [!code-vb[Conceptual.Regex.Language.Options#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/example1.vb#8)]  
+  
+<a name="zerowidth_positive_lookahead_assertion"></a>   
+## ゼロ幅の肯定先読みアサーション  
+ 次のグループ化構成体は、ゼロ幅の肯定先読みアサーションを定義します。  
+  
+ `(?=` *subexpression* `)`  
+  
+ ここで、*subexpression* は正規表現パターンです。 一致と見なされるためには、入力文字列が *subexpression* の正規表現パターンと一致する必要がありますが、一致した部分文字列は一致結果には含まれません。 ゼロ幅の肯定先読みアサーションはバックトラックしません。  
+  
+ 通常、ゼロ幅の肯定先読みアサーションは正規表現パターンの末尾にあります。 一致と見なされるには文字列の末尾にある必要がありますが、一致には含まれない部分文字列を定義します。 これは、過度なバックトラッキングを防ぐためにも役立ちます。 ゼロ幅の肯定先読みアサーションを使用して、特定のキャプチャされたグループの先頭テキストが、そのキャプチャされたグループに対して定義されたパターンのサブセットと一致するテキストになるようにすることができます。 たとえば、キャプチャ グループが連続する単語文字と一致する場合に、ゼロ幅の肯定先読みアサーションを使用して、先頭の文字がアルファベット大文字になるように要求できます。  
+  
+ 次の例では、ゼロ幅の肯定先読みアサーションを使用して、入力文字列内の動詞 "is" の前にある単語を照合します。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#6](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/lookahead1.cs#6)]
+ [!code-vb[RegularExpressions.Language.Grouping#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/lookahead1.vb#6)]  
+  
+ この正規表現 `\b\w+(?=\sis\b)` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`(?=\sis\b)`|単語文字に使用される文字の後に、空白文字とワード境界で終了する文字列 "is" が続くかどうかを確認します。 該当する場合は一致と見なされます。|  
+  
+<a name="zerowidth_negative_lookahead_assertion"></a>   
+## ゼロ幅の否定先読みアサーション  
+ 次のグループ化構成体は、ゼロ幅の否定先読みアサーションを定義します。  
+  
+ `(?!` *subexpression* `)`  
+  
+ ここで、*subexpression* は正規表現パターンです。 一致と見なされるためには、入力文字列が *subexpression* の正規表現パターンと一致しない必要がありますが、一致した文字列は一致結果には含まれません。  
+  
+ 通常、ゼロ幅の否定先読みアサーションは正規表現の先頭または末尾で使用されます。 正規表現の先頭の場合は、類似してもより一般的なパターンを照合するように正規表現の先頭で定義されているときに、一致しない必要がある特定のパターンを定義できます。 この場合は、バックトラッキングを制限するためによく使用されます。 正規表現の末尾の場合は、一致の末尾に出現できない部分式を定義できます。  
+  
+ 次の例では、正規表現の先頭でゼロ幅の先読みアサーションを使用して、"un" で始まらない単語を照合する正規表現を定義します。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#7](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/negativelookahead1.cs#7)]
+ [!code-vb[RegularExpressions.Language.Grouping#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/negativelookahead1.vb#7)]  
+  
+ この正規表現 `\b(?!un)\w+\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(?!un)`|次の 2 文字が "un" であるかどうかを確認します。 該当しない場合は一致と考えられます。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ 次の例では、正規表現の末尾でゼロ幅の先読みアサーションを使用して、区切り文字で終わらない単語を照合する正規表現を定義します。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#8](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/negativelookahead2.cs#8)]
+ [!code-vb[RegularExpressions.Language.Grouping#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/negativelookahead2.vb#8)]  
+  
+ この正規表現 `\b\w+\b(?!\p{P})` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+|`\p{P})`|次の文字が区切り記号 \(ピリオドやコンマなど\) ではない場合は一致と見なされます。|  
+  
+<a name="zerowidth_positive_lookbehind_assertion"></a>   
+## ゼロ幅の正の後読みアサーション  
+ 次のグループ化構成体は、ゼロ幅の正の後読みアサーションを定義します。  
+  
+ `(?<=` *subexpression* `)`  
+  
+ ここで、*subexpression* は正規表現パターンです。 一致と見なされるためには、*subexpression* が入力文字列の現在の位置の左側に出現する必要がありますが、`subexpression` は一致結果には含まれません。 ゼロ幅の正の後読みアサーションはバックトラックしません。  
+  
+ 通常、ゼロ幅の正の後読みアサーションは正規表現の先頭で使用されます。 定義されるパターンは一致の事前条件ですが、一致結果には含まれません。  
+  
+ たとえば、次の例では、21 世紀の西暦下 2 桁を照合します \(つまり、一致する文字列の前に数字 "20" がある必要があります\)。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#9](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/lookbehind1.cs#9)]
+ [!code-vb[RegularExpressions.Language.Grouping#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/lookbehind1.vb#9)]  
+  
+ この正規表現パターン `(?<=\b20)\d{2}\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\d{2}`|2 桁の 10 進数と一致します。|  
+|`{?<=\b20)`|ワード境界で 2 桁の 10 進数の前に 10 進数 "20" がある場合は照合を続行します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ ゼロ幅の正の後読みアサーションは、キャプチャされたグループの最後の文字がそのグループの正規表現パターンと一致する文字のサブセットになる必要がある場合に、バックトラッキングを制限するためにも使用されます。 たとえば、グループが連続するすべての単語文字をキャプチャする場合に、ゼロ幅の正の後読みアサーションを使用して、最後の文字がアルファベットになるように要求できます。  
+  
+<a name="zerowidth_negative_lookbehind_assertion"></a>   
+## ゼロ幅の負の後読みアサーション  
+ 次のグループ化構成体は、ゼロ幅の負の後読みアサーションを定義します。  
+  
+ `(?<!` *subexpression* `)`  
+  
+ ここで、*subexpression* は正規表現パターンです。 一致と見なされるためには、*subexpression* が入力文字列の現在の位置の左側に出現しない必要があります。 ただし、`subexpression` と一致しない部分文字列は一致結果には含まれません。  
+  
+ 通常、ゼロ幅の負の後読みアサーションは正規表現の先頭で使用されます。 定義されるパターンでは、後に続く文字列内の一致が除外されます。 このアサーションは、キャプチャされたグループの最後の文字がそのグループの正規表現パターンと一致する 1 つ以上の文字にならない必要がある場合に、バックトラッキングを制限するためにも使用されます。 たとえば、グループが連続するすべての単語文字をキャプチャする場合に、ゼロ幅の正の後読みアサーションを使用して、最後の文字がアンダースコア \(\_\) にならないように要求できます。  
+  
+ 次の例では、週末でない \(土曜日や日曜日でない\) 曜日の日付を照合します。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#10](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/negativelookbehind1.cs#10)]
+ [!code-vb[RegularExpressions.Language.Grouping#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/negativelookbehind1.vb#10)]  
+  
+ この正規表現パターン `(?<!(Saturday|Sunday) )\b\w+ \d{1,2}, \d{4}\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\w+`|1 個以上の単語文字の後に空白文字が続くパターンと一致します。|  
+|`\d{1,2},`|1 桁または 2 桁の 10 進数の後に空白文字とコンマが続くパターンと一致します。|  
+|`\d{4}\b`|4 桁の 10 進数と一致し、ワード境界で照合を終了します。|  
+|`(?<!(Saturday&#124;Sunday) )`|文字列 "Saturday" または "Sunday" の後に空白が続くパターン以外が一致の前にある場合は、一致と見なされます。|  
+  
+<a name="nonbacktracking_subexpression"></a>   
+## 非バックトラッキング部分式  
+ 次のグループ化構成体は、非バックトラッキング部分式を表します。"最長" 部分式とも呼ばれます。  
+  
+ `(?>` *subexpression* `)`  
+  
+ ここで、*subexpression* は正規表現パターンです。  
+  
+ 通常、正規表現にオプションまたは代替の一致パターンが含まれる場合に一致する文字列が見つからなかったときは、正規表現エンジンは複数の方向に分岐することで入力文字列とパターンを照合できます。 最初の分岐で一致する文字列が見つからなかった場合、正規表現エンジンは最初に一致した時点まで戻り \(バックトラック\)、2 番目の分岐を使用して照合を試みることができます。 すべての分岐が試されるまでこの処理を続行できます。  
+  
+ `(?>` *subexpression* `)` 言語コンストラクトでは、バックトラッキングが無効になります。 正規表現エンジンは、入力文字列内の文字をできるだけ多く照合します。 一致する文字列が見つからなくなっても、バックトラックして代替パターン一致を試みることはありません。 つまり、部分式はその部分式単体と一致する文字列のみと一致します。部分式とその後続の部分式に基づく文字列の照合は試行しません。  
+  
+ バックトラッキングが成功しないことがわかっている場合は、このオプションを使用することをお勧めします。 正規表現エンジンで不要な検索が実行されないようにすることで、パフォーマンスが向上します。  
+  
+ 次の例は、非バックトラッキング部分式によってパターン一致の結果がどのように変わるかを示しています。 バックトラッキング正規表現は、ワード境界で一連の文字の繰り返しの後に同じ文字がもう一度出現するパターンと一致しますが、非バックトラッキング正規表現は一致しません。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#11](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/nonbacktracking1.cs#11)]
+ [!code-vb[RegularExpressions.Language.Grouping#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/nonbacktracking1.vb#11)]  
+  
+ 非バックトラッキング正規表現 `(?>(\w)\1+).\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(\w)`|単語文字に使用される 1 文字と一致し、その文字を 1 番目のキャプチャ グループに代入します。|  
+|`\1+`|最初にキャプチャされた部分文字列の値と 1 回以上一致します。|  
+|`.`|任意の文字と一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+|`(?>(\w)\1+)`|重複する単語文字の 1 回以上の出現と一致しますが、バックトラックしてワード境界の最後の文字と一致することはありません。|  
+  
+<a name="Objects"></a>   
+## グループ化構成体および正規表現オブジェクト  
+ 正規表現キャプチャ グループと一致する部分文字列は、<xref:System.Text.RegularExpressions.Group?displayProperty=fullName> オブジェクトで表されます。このオブジェクトは、<xref:System.Text.RegularExpressions.GroupCollection?displayProperty=fullName> プロパティによって返される <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> オブジェクトから取得できます。<xref:System.Text.RegularExpressions.GroupCollection> オブジェクトの値は次のように設定されます。  
+  
+-   コレクション内の最初の <xref:System.Text.RegularExpressions.Group> オブジェクト \(インデックス 0 の位置にあるオブジェクト\) は、一致した文字列全体を表します。  
+  
+-   次の <xref:System.Text.RegularExpressions.Group> オブジェクト セットは、名前のない \(番号付き\) キャプチャ グループを表します。 正規表現で定義されている順序で左から右に並びます。 これらのグループのインデックス値の範囲は、1 からコレクション内の名前のないキャプチャ グループの数までです。 \(特定のグループのインデックスは、その番号付き前方参照と同等です。 前方参照について詳しくは、「[前方参照構成体](../../../docs/standard/base-types/backreference-constructs-in-regular-expressions.md)」をご覧ください。\)  
+  
+-   最後の <xref:System.Text.RegularExpressions.Group> オブジェクト セットは、名前付きキャプチャ グループを表します。 正規表現で定義されている順序で左から右に並びます。 最初の名前付きキャプチャ グループのインデックス値は、最後の名前のないキャプチャ グループのインデックスよりも 1 大きい数値になります。 正規表現に名前のないキャプチャ グループがない場合、最初の名前付きキャプチャ グループのインデックス値は 1 になります。  
+  
+ 量指定子をキャプチャ グループに適用する場合、対応する <xref:System.Text.RegularExpressions.Group> オブジェクトの <xref:System.Text.RegularExpressions.Capture.Value%2A?displayProperty=fullName>、<xref:System.Text.RegularExpressions.Capture.Index%2A?displayProperty=fullName>、および <xref:System.Text.RegularExpressions.Capture.Length%2A?displayProperty=fullName> の各プロパティには、キャプチャ グループによってキャプチャされた最後の部分文字列が反映されます。 量指定子を持つグループによってキャプチャされたすべての部分文字列は、<xref:System.Text.RegularExpressions.CaptureCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> オブジェクトから取得できます。  
+  
+ 次の例では、<xref:System.Text.RegularExpressions.Group> オブジェクトと <xref:System.Text.RegularExpressions.Capture> オブジェクトの関係を明確にします。  
+  
+ [!code-csharp[RegularExpressions.Language.Grouping#4](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.grouping/cs/objectmodel1.cs#4)]
+ [!code-vb[RegularExpressions.Language.Grouping#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.grouping/vb/objectmodel1.vb#4)]  
+  
+ 正規表現パターン `\b(\w+)\W+)+` は、文字列から単語を個別に抽出します。 このパターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これらの文字が集まって、単語を形成します  これが 2 番目のキャプチャ グループです。|  
+|`\W+`|1 個以上の単語文字に使用されない文字と一致します。|  
+|`(\w+)\W+)+`|1 個以上の単語文字、および 1 個以上の単語文字に使用されない文字が 1 回以上続くパターンと一致します。 これが最初のキャプチャ グループです。|  
+  
+ 最初のキャプチャ グループは、文の各単語と一致します。 2 番目のキャプチャ グループは、各単語およびその単語に続く句読点や空白と一致します。 インデックスが 2 の <xref:System.Text.RegularExpressions.Group> オブジェクトは、2 番目のキャプチャ グループと一致したテキストの情報を保持します。 キャプチャ グループによってキャプチャされたすべての単語は、<xref:System.Text.RegularExpressions.CaptureCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> オブジェクトから取得できます。  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)   
+ [バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-convert-numeric-user-input-in-web-controls-to-numbers.md b/docs/standard/base-types/how-to-convert-numeric-user-input-in-web-controls-to-numbers.md
new file mode 100644
index 00000000000..01251415cbd
--- /dev/null
+++ b/docs/standard/base-types/how-to-convert-numeric-user-input-in-web-controls-to-numbers.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : Web コントロールでの数値のユーザー入力を数値に変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変換 (数字のユーザー入力を数値に)"
+  - "書式指定 [.NET Framework], 数"
+  - "数値の書式指定 [.NET Framework]"
+  - "数値 [.NET Framework], 変換 (数字のユーザー入力を数値に)"
+  - "数値書式指定文字列 [.NET Framework]"
+  - "解析 (文字列を) [.NET Framework], 数値文字列"
+ms.assetid: f27ddfb8-7479-4b79-8879-02a3bd8402d4
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : Web コントロールでの数値のユーザー入力を数値に変換する
+Web ページは世界中どこでも表示可能なため、ユーザーは <xref:System.Web.UI.WebControls.TextBox> コントロールの中に多種多様な形式で数値データを入力する可能性があります。  このため、Web ページのユーザーのロケールとカルチャを判別することは非常に重要です。  ユーザー入力を解析するとき、ユーザーのロケールとカルチャによって定義された書式指定規則を適用できます。  
+  
+### Web TextBox コントロールでの数値入力を数値に変換するには  
+  
+1.  <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティによって返された文字列配列にデータが含まれているかどうかを判別します。  含まれない場合は、手順 6. に進みます。  
+  
+2.  <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列にデータが含まれる場合は、その最初の要素を取得します。  最初の要素は、ユーザーの既定の言語と地域、または優先される言語と地域を表します。  
+  
+3.  <xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを呼び出すことにより、ユーザーが選択したカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化します。  
+  
+4.  ユーザー入力の変換先となる数値型の `TryParse` メソッドまたは `Parse` メソッドを呼び出します。  `TryParse` メソッドまたは `Parse` メソッドの `provider` パラメーターを指定するオーバーロードを使用して、次のいずれかを渡します。  
+  
+    -   手順 3. で作成した <xref:System.Globalization.CultureInfo> オブジェクト。  
+  
+    -   手順 3. で作成した <xref:System.Globalization.CultureInfo> オブジェクトの <xref:System.Globalization.CultureInfo.NumberFormat%2A> プロパティによって返される <xref:System.Globalization.NumberFormatInfo> オブジェクト。  
+  
+5.  変換が失敗した場合、<xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返される文字列配列内の他の要素ごとに手順 2. から 4. を繰り返します。  
+  
+6.  変換が引き続き失敗する場合、または <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列が空の場合には、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されるインバリアント カルチャを使って文字列を解析します。  
+  
+## 使用例  
+ 次の例は、<xref:System.Web.UI.WebControls.TextBox> コントロールに数値を入力するようユーザーに要求して、それを数値に変換する Web フォームの完全な分離コード ページです。  その後、その数値を 2 倍にして、元の入力と同じ書式指定規則を使って表示します。  
+  
+ [!code-csharp[Formatting.HowTo.ParseNumericInput#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.ParseNumericInput/cs/NumericUserInput1.aspx.cs#1)]
+ [!code-vb[Formatting.HowTo.ParseNumericInput#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.ParseNumericInput/vb/NumericUserInput1.aspx.vb#1)]  
+  
+ <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティには、HTTP 要求の `Accept-Language` ヘッダーに含まれるカルチャ名からデータが入ります。  ただし、すべてのブラウザーの要求に `Accept-Language` ヘッダーが含まれるとは限りません。ユーザーがヘッダーを完全に禁止する場合もあります。  このため、ユーザー入力を解析する際にはフォールバック カルチャが重要になります。  通常、フォールバック カルチャは、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> によって返されるインバリアント カルチャです。  また、テキスト ボックスへの入力によってユーザーがカルチャ名を Internet Explorer に提供する場合もありますが、無効なカルチャ名が指定される可能性があります。  このため、<xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化する際には、例外処理が重要になります。  
+  
+ Internet Explorer によって送信された HTTP 要求から取得される <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> 配列には、ユーザー側の優先度設定の順序でデータが入ります。  配列の先頭の要素には、ユーザーの最優先カルチャ\/地域の名前が格納されます。  何らかの追加項目が配列に含まれる場合、Internet Explorer はそれらに任意のクオリティ識別子を割り当てます。この識別子はセミコロンによってカルチャから区切られます。  たとえば、fr\-FR カルチャの項目は `fr-FR;q=0.7` という形式になります。  
+  
+ この例では、`useUserOverride` パラメーターを `false` に設定して <xref:System.Globalization.CultureInfo.%23ctor%2A> コンストラクターを呼び出し、新しい <xref:System.Globalization.CultureInfo> オブジェクトを作成します。  これによって、カルチャ名がサーバー上の既定のカルチャ名である場合、クラス コンストラクターによって作成される新しい <xref:System.Globalization.CultureInfo> オブジェクトにはカルチャの既定の設定が含まれ、サーバーの **\[地域と言語のオプション\]** アプリケーションを使ってオーバーライドされた設定は反映されません。  通常、サーバーでオーバーライドされた設定値はユーザーのシステムに存在せず、ユーザー入力に反映されることもありません。  
+  
+ ユーザー入力の変換先となる数値型の `Parse` メソッドまたは `TryParse` メソッドをコードで呼び出すことができます。  1 つの解析操作で解析メソッドを繰り返し呼び出す必要が生じる場合があります。  したがって、解析操作が失敗した場合に `false` を返す `TryParse` メソッドの方が適切です。  これに対して、`Parse` メソッドによって繰り返しスローされる例外を Web アプリケーションで処理する場合、コストが非常に大きくなる可能性があります。  
+  
+## コードのコンパイル  
+ コードをコンパイルするには、既存のすべてのコードに置き換える形で、このコードを [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] 分離コード ページの中にコピーします。  [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] Web ページには、次のコントロールを含める必要があります。  
+  
+-   コード内で参照されない <xref:System.Web.UI.WebControls.Label> コントロール。  その <xref:System.Web.UI.WebControls.TextBox.Text%2A> プロパティを "Enter a Number:" に設定します。  
+  
+-   `NumericString` という名前の <xref:System.Web.UI.WebControls.TextBox> コントロール。  
+  
+-   `OKButton` という名前の <xref:System.Web.UI.WebControls.Button> コントロール。  その <xref:System.Web.UI.WebControls.Button.Text%2A> プロパティを "OK" に設定します。  
+  
+ クラスの名前を、`NumericUserInput` から、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] ページの `Page` ディレクティブの `Inherits` 属性で定義されるクラス名に変更します。  `NumericInput` オブジェクト参照の名前を、[!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] ページの `form` タグの `id` 属性で定義される名前に変更します。  
+  
+## .NET Framework セキュリティ  
+ ユーザーが HTML ストリーム内にスクリプトを挿入するのを防ぐために、サーバー応答の中でユーザー入力を直接エコー バックしないでください。  そうする代わりに、<xref:System.Web.HttpServerUtility.HtmlEncode%2A?displayProperty=fullName> メソッドを使ってこれをエンコードする必要があります。  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)   
+ [数値文字列の解析](../../../docs/standard/base-types/parsing-numeric.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-define-and-use-custom-numeric-format-providers.md b/docs/standard/base-types/how-to-define-and-use-custom-numeric-format-providers.md
new file mode 100644
index 00000000000..2fd12430e08
--- /dev/null
+++ b/docs/standard/base-types/how-to-define-and-use-custom-numeric-format-providers.md
@@ -0,0 +1,96 @@
+---
+title: "方法 : カスタム数値書式プロバイダーを定義して使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "カスタム書式指定文字列"
+  - "カスタム数値書式指定文字列"
+  - "表示 (日付と時刻のデータを)"
+  - "書式プロバイダー [.NET Framework]"
+  - "書式指定 [.NET Framework], 数"
+  - "数値の書式指定 [.NET Framework]"
+  - "数値 [.NET Framework], カスタム数値書式指定文字列"
+  - "数値書式指定文字列 [.NET Framework]"
+ms.assetid: a281bfbf-6596-45ed-a2d6-3782d535ada2
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : カスタム数値書式プロバイダーを定義して使用する
+[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、数値の文字列表現を広範に制御することができます。  数値の書式をカスタマイズするための、次のような機能がサポートされています。  
+  
+-   標準の数値書式指定文字列。これは、数値を文字列形式に変換するための定義済み形式のセットです。  `format` パラメーターを持つ、<xref:System.Decimal.ToString%28System.String%29?displayProperty=fullName> などの任意の数値書式指定メソッドでこれらを使用できます。  詳細については、「[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)」を参照してください。  
+  
+-   カスタム数値書式指定文字列。これはシンボルのセットで、これらのシンボルを組み合わせてカスタム数値書式指定子を定義できます。  これらもまた、<xref:System.Decimal.ToString%28System.String%29?displayProperty=fullName> などの、`format` パラメーターを持つ任意の数値書式指定メソッドで使用できます。  詳細については、「[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)」を参照してください。  
+  
+-   カスタム <xref:System.Globalization.CultureInfo> または <xref:System.Globalization.NumberFormatInfo> オブジェクト。これらは、数値の文字列表現の表示で使用されるシンボルと書式パターンを定義します。  `provider` パラメーターを持つ、<xref:System.Int32.ToString%2A> などの任意の数値書式指定メソッドでこれらを使用できます。  通常は、カルチャ固有の書式設定を指定するために `provider` パラメーターを使用します。  
+  
+ これら 3 つの技法が不適切な場合もあります。書式設定されたアカウント番号、識別番号、または郵便番号をアプリケーションで表示する必要がある場合などです。  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、数値の書式を決定するために、<xref:System.Globalization.CultureInfo> オブジェクトでも <xref:System.Globalization.NumberFormatInfo> オブジェクトでもない書式設定オブジェクトを定義することもできます。  ここでは、そのようなオブジェクトの実装方法を手順を追って説明し、電話番号の書式を設定する例を示します。  
+  
+### カスタム書式プロバイダーを定義するには  
+  
+1.  <xref:System.IFormatProvider> インターフェイスと <xref:System.ICustomFormatter> インターフェイスを実装するクラスを定義します。  
+  
+2.  <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> メソッドを実装します。  <xref:System.IFormatProvider.GetFormat%2A> はコールバック メソッドで、カスタム書式指定を実際に行うオブジェクトを取得するために \([String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッドなどの\) 書式指定メソッドによって呼び出されます。  通常、<xref:System.IFormatProvider.GetFormat%2A> の実装は次のような操作を実行します。  
+  
+    1.  メソッド パラメーターとして渡される <xref:System.Type> オブジェクトが <xref:System.ICustomFormatter> インターフェイスを表すかどうかを判断します。  
+  
+    2.  パラメーターが <xref:System.ICustomFormatter> インターフェイスを表す場合、<xref:System.IFormatProvider.GetFormat%2A> は、カスタム書式指定を行う <xref:System.ICustomFormatter> インターフェイスを実装するオブジェクトを返します。  通常は、カスタム書式指定オブジェクト自身が返されます。  
+  
+    3.  パラメーターが <xref:System.ICustomFormatter> インターフェイスを表さない場合、<xref:System.IFormatProvider.GetFormat%2A> は `null` を返します。  
+  
+3.  <xref:System.ICustomFormatter.Format%2A> メソッドを実装します。  このメソッドは [String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッドによって呼び出され、数値の文字列表現を返します。  このメソッドを実装する場合には、通常、次のような操作を行う必要があります。  
+  
+    1.  必要に応じて、`provider` パラメーターを検査することにより、このメソッドが適切な書式設定サービスを提供することを確認します。  <xref:System.IFormatProvider> と <xref:System.ICustomFormatter> の両方を実装する書式設定オブジェクトの場合、現在の書式設定オブジェクトと等しいかどうか `provider` パラメーターを検査する必要があります。  
+  
+    2.  書式設定オブジェクトがカスタム書式指定子をサポートするかどうかを判断します。\(たとえば、「N」書式指定子は ITU\-T の推奨 E.123 形式で出力を示す場合があります。"」米国の電話番号が NANP 形式で「出力する必要があることを示すことがあります。\) 書式指定子が使用される場合、メソッドで特定の書式指定子を処理する必要があります。  これは `format` パラメーターでメソッドに渡されます。  指定子が存在しない場合、`format` パラメーターの値は <xref:System.String.Empty?displayProperty=fullName> です。  
+  
+    3.  `arg` パラメーターとしてメソッドに渡される数値を取得します。  それを文字列形式に変換するために必要な操作をすべて実行します。  
+  
+    4.  `arg` パラメーターの文字列表現を返します。  
+  
+### カスタム数値書式設定オブジェクトを使用するには  
+  
+1.  カスタム書式設定クラスの新しいインスタンスを作成します。  
+  
+2.  書式指定メソッド [String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> を呼び出します。その際、カスタム書式設定オブジェクト、書式指定子 \(使用しない場合は <xref:System.String.Empty?displayProperty=fullName>\)、および書式設定の対象となる数値を渡します。  
+  
+## 使用例  
+ 次の例では `TelephoneFormatter` という NANP または E.123 形式に米国の電話番号を表す数値を変換するカスタム数値書式のプロバイダーを定義します。  このメソッドは、"N" \(NANP 形式を出力\) および "I" \(国際 E.123 形式を出力\) の 2 つの書式指定子を処理します。  
+  
+ [!code-csharp[Formatting.HowTo.NumericValue#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.NumericValue/cs/Telephone1.cs#1)]
+ [!code-vb[Formatting.HowTo.NumericValue#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.NumericValue/vb/Telephone1.vb#1)]  
+  
+ このカスタム数値書式プロバイダーは、[String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッドでのみ使用可能です。  <xref:System.IFormatProvider> 型のパラメーターを持つ数値書式指定メソッドの他のすべてのオーバーロード \(たとえば `ToString`\) は、<xref:System.Globalization.NumberFormatInfo> 型を表す <xref:System.Type> オブジェクトを <xref:System.IFormatProvider.GetFormat%2A?displayProperty=fullName> 実装に渡します。  これらは、メソッドから <xref:System.Globalization.NumberFormatInfo> オブジェクトが返されることを期待します。  これが返されない場合、カスタム数値書式プロバイダーは無視され、現在のカルチャの <xref:System.Globalization.NumberFormatInfo> オブジェクトが代わりに使用されます。  この例の `TelephoneFormatter.GetFormat` メソッドは、数値書式指定メソッドに渡されるものが適切でない場合に備えて、メソッド パラメーターを検査し、それが <xref:System.ICustomFormatter> 以外の型を表す場合には `null` を返します。  
+  
+ カスタム数値書式プロバイダーで書式指定子のセットをサポートする場合には、[String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッド呼び出しの書式指定項目に書式指定子が含まれない場合の既定の動作を必ず実装してください。  この例では、"N" が既定の書式指定子です。  こうして書式指定子を明示的に指定することで、数値を書式設定された電話番号に変換できます。  次の例は、このようなメソッド呼び出しを示しています。  
+  
+ [!code-csharp[Formatting.HowTo.NumericValue#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.NumericValue/cs/Telephone1.cs#2)]
+ [!code-vb[Formatting.HowTo.NumericValue#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.NumericValue/vb/Telephone1.vb#2)]  
+  
+ 加えて、書式指定子が存在しない場合にも変換が可能です。  次の例は、このようなメソッド呼び出しを示しています。  
+  
+ [!code-csharp[Formatting.HowTo.NumericValue#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.NumericValue/cs/Telephone1.cs#3)]
+ [!code-vb[Formatting.HowTo.NumericValue#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.NumericValue/vb/Telephone1.vb#3)]  
+  
+ 既定の書式指定子が定義されない場合、コードがサポートしない書式設定を .NET Framework で提供できるように、<xref:System.ICustomFormatter.Format%2A?displayProperty=fullName> メソッドの実装に次のようなコードを含める必要があります。  
+  
+ [!code-csharp[System.ICustomFormatter.Format#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.ICustomFormatter.Format/cs/format.cs#1)]
+ [!code-vb[System.ICustomFormatter.Format#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.ICustomFormatter.Format/vb/Format.vb#1)]  
+  
+ この例では、<xref:System.ICustomFormatter.Format%2A?displayProperty=fullName> を実装するメソッドが [String.Format\(IFormatProvider, String, Object\<xref:System.String.Format%28System.IFormatProvider%2CSystem.String%2CSystem.Object%5B%5D%29?displayProperty=fullName> メソッドのコールバック メソッドとして機能するようになっています。  このため、このメソッドは `formatProvider` パラメーターを検査して、現在の `TelephoneFormatter` オブジェクトへの参照が含まれるかどうかを判別します。  また、コードからこのメソッドを直接呼び出すこともできます。  その場合には、カルチャ固有の書式設定情報を指定する <xref:System.Globalization.CultureInfo> オブジェクトまたは <xref:System.Globalization.NumberFormatInfo> オブジェクトを提供するために `formatProvider` パラメーターを使用できます。  
+  
+## コードのコンパイル  
+ コマンド ラインで csc.exe または vb.exe を使用してコードをコンパイルします。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-display-dates-in-non-gregorian-calendars.md b/docs/standard/base-types/how-to-display-dates-in-non-gregorian-calendars.md
new file mode 100644
index 00000000000..f609494fcfa
--- /dev/null
+++ b/docs/standard/base-types/how-to-display-dates-in-non-gregorian-calendars.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : グレゴリオ暦以外の暦の日付を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式指定 [.NET Framework]、日付"
+  - "日付 [.NET Framework]、書式設定"
+  - "暦 [.NET Framework]、表示 (日付を)"
+  - "表示 (日付と時刻のデータを)"
+ms.assetid: ed324eff-4aff-4a76-b6c0-04e6c0d8f5a9
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : グレゴリオ暦以外の暦の日付を表示する
+<xref:System.DateTime> 型と <xref:System.DateTimeOffset> 型は、既定の暦としてグレゴリオ暦を使用します。  つまり、日付および時刻の値の `ToString` メソッドを呼び出すと、その日付および時刻が別の暦を使って作成された場合でも、グレゴリオ暦でその日付および時刻を表した文字列表現が表示されます。  この動作を次のコード例に示します。ここでは、2 つの異なる方法でペルシャ暦の日付および時刻の値を作成しますが、<xref:System.DateTime.ToString%2A> メソッドを呼び出すときにはグレゴリオ暦で日付および時刻の値を表示します。  この例の 2 つの技法はよく使用されますが、特定の暦で日付を表示する方法としては適切ではありません。  
+  
+ [!code-csharp[Formatting.HowTo.Calendar#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.Calendar/cs/Calendar1.cs#1)]
+ [!code-vb[Formatting.HowTo.Calendar#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.Calendar/vb/Calendar1.vb#1)]  
+  
+ 特定の暦で日付を表示するために 2 つの異なる技法を使用できます。  最初の方法では、暦は特定のカルチャの既定の暦である必要があります。  2 番目の方法は、任意の暦で使用できます。  
+  
+### カルチャの既定の暦で日付を表示するには  
+  
+1.  使用する暦 \(カレンダー\) を表す、<xref:System.Globalization.Calendar> クラスから派生したカレンダー オブジェクトをインスタンス化します。  
+  
+2.  日付の表示に使われる書式設定が属するカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化します。  
+  
+3.  <xref:System.Array.Exists%2A?displayProperty=fullName> メソッドを呼び出すことにより、カレンダー オブジェクトが <xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> プロパティによって返される配列のメンバーかどうかを判別します。  これは、そのカレンダー \(暦\) を <xref:System.Globalization.CultureInfo> オブジェクトの既定の暦に指定できることを示します。  配列のメンバーでない場合には、「任意の暦で日付を表示するには」の説明に従ってください。  
+  
+4.  カレンダー オブジェクトを、<xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの <xref:System.Globalization.DateTimeFormatInfo.Calendar%2A> プロパティに割り当てます。  
+  
+    > [!NOTE]
+    >  <xref:System.Globalization.CultureInfo> クラスには、<xref:System.Globalization.CultureInfo.Calendar%2A> プロパティもあります。  ただし、これは読み取り専用の定数であるため、<xref:System.Globalization.DateTimeFormatInfo.Calendar%2A?displayProperty=fullName> プロパティに割り当てられた新しい既定の暦を表すようには変更されません。  
+  
+5.  <xref:System.DateTime.ToString%2A> メソッドまたは <xref:System.DateTime.ToString%2A> メソッドを呼び出して、前の手順で既定の暦が変更された <xref:System.Globalization.CultureInfo> オブジェクトをそれに渡します。  
+  
+### 任意の暦で日付を表示するには  
+  
+1.  使用する暦 \(カレンダー\) を表す、<xref:System.Globalization.Calendar> クラスから派生したカレンダー オブジェクトをインスタンス化します。  
+  
+2.  日付および時刻の値の文字列表現にどの日付および時刻要素を表示させるかを決定します。  
+  
+3.  表示させるそれぞれの日付および時刻要素ごとに、カレンダー オブジェクトの `Get`… メソッドを呼び出します。  次のメソッドを使用できます。  
+  
+    -   <xref:System.Globalization.Calendar.GetYear%2A> は、適切な暦の年を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetMonth%2A> は、適切な暦の月を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetDayOfMonth%2A> は、適切な暦の月の日付を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetHour%2A> は、適切な暦の日付の時間を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetMinute%2A> は、適切な暦の時刻の分を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetSecond%2A> は、適切な暦の時刻の秒を表示します。  
+  
+    -   <xref:System.Globalization.Calendar.GetMilliseconds%2A> は、適切な暦の時刻のミリ秒を表示します。  
+  
+## 使用例  
+ この例では、2 つの異なる暦を使って日付を表示します。  ar\-JO カルチャの既定の暦としてヒジュラ暦を定義した後、日付を表示します。さらに、fa\-IR カルチャのオプションの暦としてサポートされないペルシャ暦を使って日付を表示します。  
+  
+ [!code-csharp[Formatting.HowTo.Calendar#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.Calendar/cs/Calendar1.cs#2)]
+ [!code-vb[Formatting.HowTo.Calendar#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.Calendar/vb/Calendar1.vb#2)]  
+  
+ それぞれの <xref:System.Globalization.CultureInfo> オブジェクトは、<xref:System.Globalization.CultureInfo.OptionalCalendars%2A> プロパティによって示される暦を 1 つ以上サポートすることができます。  このうち 1 つがカルチャの既定の暦として指定され、読み取り専用の <xref:System.Globalization.CultureInfo.Calendar%2A?displayProperty=fullName> プロパティによって返されます。  オプションの暦の 1 つを既定として指定するには、その暦を表す <xref:System.Globalization.Calendar> オブジェクトを、<xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo.Calendar%2A?displayProperty=fullName> プロパティに割り当てます。  ただし、\(<xref:System.Globalization.PersianCalendar> クラスによって表されるペルシャ暦のような\) いくつかの暦は、どのカルチャのオプションの暦としても機能しません。  
+  
+ この例では、特定の暦を使って日付の文字列表現を生成する際の多くの詳細な処理を行うために、再利用可能なカレンダー ユーティリティ クラス `CalendarUtility` を定義します。  `CalendarUtility` クラスには、次のメンバーがあります。  
+  
+-   パラメーター化されたコンストラクター。その単一のパラメーターは、日付を表す際に使用される <xref:System.Globalization.Calendar> オブジェクトです。  クラスのプライベート フィールドにこれが割り当てられます。  
+  
+-   プライベート メソッド `CalendarExists`。これは、`CalendarUtility` オブジェクトによって表される暦が、パラメーターとしてメソッドに渡される <xref:System.Globalization.CultureInfo> オブジェクトでサポートされるかどうかを示すブール値を返します。  このメソッドは、<xref:System.Array.Exists%2A?displayProperty=fullName> メソッドへの呼び出しをラップし、<xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> 配列をこのメソッドに渡します。  
+  
+-   プライベート メソッド `HasSameName`。これは、<xref:System.Array.Exists%2A?displayProperty=fullName> メソッドにパラメーターとして渡される <xref:System.Predicate%601> デリゲートに割り当てられます。  メソッドが `true` を返すまで、配列の各メンバーがメソッドに渡されます。  このメソッドは、オプションの暦の名前が、`CalendarUtility` オブジェクトによって表される暦と同じかどうかを判断します。  
+  
+-   オーバーロードされたパブリック メソッド `DisplayDate`。これに渡されるパラメーターは、`CalendarUtility` オブジェクトによって表される暦で表示する <xref:System.DateTime> または <xref:System.DateTimeOffset> 値と、使用する書式指定規則が属するカルチャの 2 つです。  日付の文字列表現を返す際の動作は、使用する書式指定規則が属するカルチャにおいて、対象となる暦がサポートされるかどうかに依存します。  
+  
+ この例の <xref:System.DateTime> または <xref:System.DateTimeOffset> 値を作成するのにどんな暦が使われたかにかかわらず、この値は通常、グレゴリオ暦の日付で表現されます。  これは、暦の情報が <xref:System.DateTime> 型と <xref:System.DateTimeOffset> 型に保持されないためです。  内部的には、これは 0001 年 1 月 1 日の真夜中から数えたタイマー刻みの回数として表されます。  この回数の解釈は、暦によって異なります。  ほとんどのカルチャでは、既定の暦はグレゴリオ暦です。  
+  
+## コードのコンパイル  
+ この例では System.Core.dll を参照する必要があります。  
+  
+ コマンド ラインで csc.exe または vb.exe を使用してコードをコンパイルします。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-display-localized-date-and-time-information-to-web-users.md b/docs/standard/base-types/how-to-display-localized-date-and-time-information-to-web-users.md
new file mode 100644
index 00000000000..561b36379d1
--- /dev/null
+++ b/docs/standard/base-types/how-to-display-localized-date-and-time-information-to-web-users.md
@@ -0,0 +1,119 @@
+---
+title: "方法 : ローカライズされた日付/時刻情報を Web ユーザーに表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "表示 (日付と時刻のデータを)"
+  - "書式指定 [.NET Framework], 日付"
+  - "書式指定 [.NET Framework], ローカライズされたデータ"
+  - "ローカリゼーション [.NET Framework], 日付と時刻の表示"
+  - "ローカライズされた日付の表示 [.NET Framework]"
+  - "解析 (文字列を) [.NET Framework], 日付と時刻文字列"
+ms.assetid: 377fe93c-32be-421a-a30a-be639a46ede8
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ローカライズされた日付/時刻情報を Web ユーザーに表示する
+Web ページは世界中どこでも表示可能なため、日付\/時刻値を解析して書式設定する操作では、ユーザーと対話する際に既定の書式 \(ほとんどの場合、Web サーバーのローカル カルチャの書式\) に依存するのは不適切です。  ユーザー入力された日付\/時刻文字列を扱う Web フォームは、ユーザーの選んだカルチャを使用して文字列を解析する必要があります。  同様に、ユーザーのカルチャに適合した書式で、日付\/時刻データをユーザーに表示する必要があります。  このトピックでは、これらを行う方法について示します。  
+  
+### ユーザー入力による日付\/時刻文字列を解析するには  
+  
+1.  <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティによって返された文字列配列にデータが含まれているかどうかを判別します。  含まれない場合は、手順 6. に進みます。  
+  
+2.  <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列にデータが含まれる場合は、その最初の要素を取得します。  最初の要素は、ユーザーの既定の言語と地域、または優先される言語と地域を表します。  
+  
+3.  <xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを呼び出すことにより、ユーザーが選択したカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化します。  
+  
+4.  <xref:System.DateTime> 型または <xref:System.DateTimeOffset> 型の `TryParse` メソッドまたは `Parse` メソッドを呼び出して、変換を試みます。  `TryParse` メソッドまたは `Parse` メソッドの `provider` パラメーターを指定するオーバーロードを使用して、次のいずれかを渡します。  
+  
+    -   手順 3. で作成した <xref:System.Globalization.CultureInfo> オブジェクト。  
+  
+    -   手順 3. で作成した <xref:System.Globalization.CultureInfo> オブジェクトの <xref:System.Globalization.CultureInfo.DateTimeFormat%2A> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo> オブジェクト。  
+  
+5.  変換が失敗した場合、<xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返される文字列配列内の他の要素ごとに手順 2. から 4. を繰り返します。  
+  
+6.  変換が引き続き失敗する場合、または <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列が空の場合には、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されるインバリアント カルチャを使って文字列を解析します。  
+  
+### ユーザーが要求したローカル日付\/時刻を解析するには  
+  
+1.  <xref:System.Web.UI.WebControls.HiddenField> コントロールを Web フォームに追加します。  
+  
+2.  現在の日付\/時刻、および世界協定時刻 \(UTC\) からのローカル タイム ゾーンのオフセットを <xref:System.Web.UI.WebControls.HiddenField.Value%2A> プロパティに書き込むことによって、`Submit` ボタンの `onClick` イベントを処理する JavaScript 関数を作成します。  文字列の 2 つの構成要素を分けるために、区切り記号 \(たとえばセミコロン\) を使用します。  
+  
+3.  スクリプトのテキストを <xref:System.Web.UI.ClientScriptManager.RegisterClientScriptBlock%28System.Type%2CSystem.String%2CSystem.String%2CSystem.Boolean%29?displayProperty=fullName> メソッドに渡すことにより、Web フォームの <xref:System.Web.UI.Control.PreRender> イベントを使用して HTML 出力ストリームの中に関数を挿入します。  
+  
+4.  JavaScript 関数の名前を `Submit` ボタンの `OnClientClick` 属性に渡すことにより、イベント ハンドラーを `Submit` ボタンの `onClick` イベントに接続します。  
+  
+5.  `Submit` ボタンの <xref:System.Web.UI.WebControls.Button.Click> イベントのハンドラーを作成します。  
+  
+6.  イベント ハンドラー内で、<xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティによって返される文字列配列にデータが入っているかどうかを判別します。  入っていない場合は、手順 14. に進みます。  
+  
+7.  <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列にデータが含まれる場合は、その最初の要素を取得します。  最初の要素は、ユーザーの既定の言語と地域、または優先される言語と地域を表します。  
+  
+8.  <xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを呼び出すことにより、ユーザーが選択したカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化します。  
+  
+9. ユーザーのローカル日付\/時刻の文字列表現、およびユーザーのローカル タイム ゾーン オフセットの文字列表現を別々の配列要素に保存するために、<xref:System.Web.UI.WebControls.HiddenField.Value%2A> プロパティに割り当てられた文字列を <xref:System.String.Split%2A> メソッドに渡します。  
+  
+10. ユーザー側の日付\/時刻を <xref:System.DateTime> 値に変換するために、<xref:System.DateTime.Parse%2A?displayProperty=fullName> メソッドまたは <xref:System.DateTime.TryParse%28System.String%2CSystem.IFormatProvider%2CSystem.Globalization.DateTimeStyles%2CSystem.DateTime%40%29?displayProperty=fullName> メソッドを呼び出します。  メソッドのオーバーロードを使用し、`provider` パラメーターを指定して、次のいずれかを渡します。  
+  
+    -   手順 8. で作成した <xref:System.Globalization.CultureInfo> オブジェクト。  
+  
+    -   手順 8. で作成した <xref:System.Globalization.CultureInfo> オブジェクトの <xref:System.Globalization.CultureInfo.DateTimeFormat%2A> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo> オブジェクト。  
+  
+11. 手順 10. の解析操作が失敗する場合は、手順 13. に進みます。  それ以外の場合は、ユーザーのタイム ゾーン オフセットの文字列形式を整数に変換するために、<xref:System.UInt32.Parse%28System.String%29?displayProperty=fullName> メソッドを呼び出します。  
+  
+12. <xref:System.DateTimeOffset.%23ctor%28System.DateTime%2CSystem.TimeSpan%29?displayProperty=fullName> コンストラクターを呼び出すことにより、ユーザーのローカル時間を表す <xref:System.DateTimeOffset> をインスタンス化します。  
+  
+13. 手順 10. の変換が失敗した場合、<xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返される文字列配列内の他の要素ごとに手順 7. から 12. を繰り返します。  
+  
+14. 変換が引き続き失敗する場合、または <xref:System.Web.HttpRequest.UserLanguages%2A> プロパティによって返された文字列配列が空の場合には、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されるインバリアント カルチャを使って文字列を解析します。  その後、手順 7. から 12. を繰り返します。  
+  
+ 結果として、Web ページのユーザー側のローカル時間を表す <xref:System.DateTimeOffset> オブジェクトが生成されます。  その後、<xref:System.DateTimeOffset.ToUniversalTime%2A> メソッドを呼び出すことで、対応する UTC を判別できます。  また、<xref:System.TimeZoneInfo.ConvertTime%28System.DateTimeOffset%2CSystem.TimeZoneInfo%29?displayProperty=fullName> メソッドを呼び出し、時間の変換先のタイム ゾーンとして <xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> の値を渡すことによって、Web サーバー側の対応する日付\/時刻を判別することもできます。  
+  
+## 使用例  
+ 次の例は、日付\/時刻値の入力をユーザーに求める ASP.NET Web フォームの HTML ソースとコードの両方を含んでいます。  また、クライアント側スクリプトは、ユーザー側のローカル日付\/時刻に関する情報、およびユーザーのタイム ゾーンと UTC とのオフセットに関する情報を隠しフィールドに書き込みます。  その後、この情報はサーバーによって解析され、ユーザー入力を表示する Web ページが返されます。  さらに、ユーザーのローカル時間、サーバーの時間、および UTC を使用して、ユーザー側の日付\/時刻も表示されます。  
+  
+ [!code-csharp[Formatting.HowTo.ParseDateInput#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.ParseDateInput/cs/GetDateInfo.aspx#1)]
+ [!code-vb[Formatting.HowTo.ParseDateInput#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.ParseDateInput/vb/GetDateInfo.aspx#1)]  
+  
+ クライアント側スクリプトは、JavaScript `toLocaleString` メソッドを呼び出します。  これにより、サーバー上で正常に解析される可能性がより高い、ユーザー ロケールの書式指定規則に従う文字列が生成されます。  
+  
+ <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティには、HTTP 要求の `Accept-Language` ヘッダーに含まれるカルチャ名からデータが入ります。  ただし、すべてのブラウザーの要求に `Accept-Language` ヘッダーが含まれるとは限りません。ユーザーがヘッダーを完全に禁止する場合もあります。  このため、ユーザー入力を解析する際にはフォールバック カルチャが重要になります。  通常、フォールバック カルチャは、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> によって返されるインバリアント カルチャです。  また、テキスト ボックスへの入力によってユーザーがカルチャ名を Internet Explorer に提供する場合もありますが、無効なカルチャ名が指定される可能性があります。  このため、<xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化する際には、例外処理が重要になります。  
+  
+ Internet Explorer によって送信された HTTP 要求から取得される <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> 配列には、ユーザー側の優先度設定の順序でデータが入ります。  配列の先頭の要素には、ユーザーの最優先カルチャ\/地域の名前が格納されます。  何らかの追加項目が配列に含まれる場合、Internet Explorer はそれらに任意のクオリティ識別子を割り当てます。この識別子はセミコロンによってカルチャから区切られます。  たとえば、fr\-FR カルチャの項目は `fr-FR;q=0.7` という形式になります。  
+  
+ この例では、`useUserOverride` パラメーターを `false` に設定して <xref:System.Globalization.CultureInfo.%23ctor%2A> コンストラクターを呼び出し、新しい <xref:System.Globalization.CultureInfo> オブジェクトを作成します。  これによって、カルチャ名がサーバー上の既定のカルチャ名である場合、クラス コンストラクターによって作成される新しい <xref:System.Globalization.CultureInfo> オブジェクトにはカルチャの既定の設定が含まれ、サーバーの **\[地域と言語のオプション\]** アプリケーションを使ってオーバーライドされた設定は反映されません。  通常、サーバーでオーバーライドされた設定値はユーザーのシステムに存在せず、ユーザー入力に反映されることもありません。  
+  
+ この例では 1 つの日付\/時刻の 2 つの文字列表現 \(1 つはユーザー入力、もう 1 つは隠しフィールドに格納されたもの\) を解析するため、必要になる可能性のある <xref:System.Globalization.CultureInfo> オブジェクトが事前に定義されます。  <xref:System.Web.HttpRequest.UserLanguages%2A?displayProperty=fullName> プロパティによって返される要素数より 1 つ多い <xref:System.Globalization.CultureInfo> オブジェクトから成る配列が作成されます。  その後、それぞれの言語\/地域文字列ごとに 1 つの <xref:System.Globalization.CultureInfo> オブジェクトがインスタンス化され、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> を表す <xref:System.Globalization.CultureInfo> オブジェクトもインスタンス化されます。  
+  
+ ユーザーの日付\/時刻の文字列表現を <xref:System.DateTime> 値に変換するために、コードの中で <xref:System.DateTime.Parse%2A> メソッドまたは <xref:System.DateTime.TryParse%2A> メソッドのどちらでも呼び出すことができます。  1 つの解析操作で解析メソッドを繰り返し呼び出す必要が生じる場合があります。  このため、解析操作が失敗した場合に `false` を返す <xref:System.DateTime.TryParse%2A> メソッドを使用する方が適切です。  これに対して、<xref:System.DateTime.Parse%2A> メソッドによって繰り返しスローされる例外を Web アプリケーションで処理する場合、コストが非常に大きくなる可能性があります。  
+  
+## コードのコンパイル  
+ コードをコンパイルするには、分離コードのない [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] Web ページを作成します。  その後、この例を Web ページ内にコピーして、既存のすべてのコードを置き換えます。  [!INCLUDE[vstecasp](../../../includes/vstecasp-md.md)] Web ページには、次のコントロールを含める必要があります。  
+  
+-   コード内で参照されない <xref:System.Web.UI.WebControls.Label> コントロール。  その <xref:System.Web.UI.WebControls.TextBox.Text%2A> プロパティを "Enter a Number:" に設定します。  
+  
+-   `DateString` という名前の <xref:System.Web.UI.WebControls.TextBox> コントロール。  
+  
+-   `OKButton` という名前の <xref:System.Web.UI.WebControls.Button> コントロール。  その <xref:System.Web.UI.WebControls.Button.Text%2A> プロパティを "OK" に設定します。  
+  
+-   `DateInfo` という名前の <xref:System.Web.UI.WebControls.HiddenField> コントロール。  
+  
+## .NET Framework セキュリティ  
+ ユーザーが HTML ストリーム内にスクリプトを挿入するのを防ぐために、サーバー応答の中でユーザー入力を直接エコー バックしないでください。  そうする代わりに、<xref:System.Web.HttpServerUtility.HtmlEncode%2A?displayProperty=fullName> メソッドを使ってこれをエンコードする必要があります。  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)   
+ [標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)   
+ [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)   
+ [日付と時刻文字列の解析](../../../docs/standard/base-types/parsing-datetime.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-display-milliseconds-in-date-and-time-values.md b/docs/standard/base-types/how-to-display-milliseconds-in-date-and-time-values.md
new file mode 100644
index 00000000000..4d589bd906f
--- /dev/null
+++ b/docs/standard/base-types/how-to-display-milliseconds-in-date-and-time-values.md
@@ -0,0 +1,60 @@
+---
+title: "方法: 日付および時刻の値のミリ秒部分を表示する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "日付 [.NET Framework], ミリ秒"
+  - "DateTime.ToString メソッド"
+  - "表示 (日付と時刻のデータを)"
+  - "ミリ秒 [.NET Framework]"
+  - "時刻 [.NET Framework], ミリ秒"
+ms.assetid: ae1a0610-90b9-4877-8eb6-4e30bc5e00cf
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法: 日付および時刻の値のミリ秒部分を表示する
+<xref:System.DateTime.ToString?displayProperty=fullName> などの既定の日付および時刻書式指定メソッドは時刻値の時間、分、秒を含めますが、ミリ秒の部分は含めません。  ここでは、書式設定された日付および時刻文字列の中にミリ秒部分を含める方法について説明します。  
+  
+### DateTime 値のミリ秒部分を表示するには  
+  
+1.  日付を表す文字列形式を処理している場合には、静的 <xref:System.DateTime.Parse%28System.String%29?displayProperty=fullName> または <xref:System.DateTimeOffset.Parse%28System.String%29?displayProperty=fullName> メソッドを使用して、それを <xref:System.DateTime> 値または <xref:System.DateTimeOffset> 値に変換します。  
+  
+2.  時刻のミリ秒部分の文字列表現を抽出するには、日付および時刻の値の <xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> メソッドまたは <xref:System.DateTimeOffset.ToString%2A> メソッドを呼び出して、カスタム書式パターン `fff` または `FFF` を単独で、あるいは他のカスタム書式指定子と共に `format` パラメーターとして渡します。  
+  
+## 使用例  
+ この例では、<xref:System.DateTime> および <xref:System.DateTimeOffset> 値のミリ秒の部分をコンソールに表示します。単独で表示する場合と、より長い日付および時刻文字列に含める場合の両方を示します。  
+  
+ [!code-csharp[Formatting.HowTo.Millisecond#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.Millisecond/cs/Millisecond.cs#1)]
+ [!code-vb[Formatting.HowTo.Millisecond#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.Millisecond/vb/Millisecond.vb#1)]  
+  
+ `fff` 書式パターンを使うと、ミリ秒値に後続のゼロがあればこれは含められます。  `FFF` 書式パターンでは、これが除外されます。  この違いを次の例に示します。  
+  
+ [!code-csharp[Formatting.HowTo.Millisecond#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.Millisecond/cs/Millisecond.cs#2)]
+ [!code-vb[Formatting.HowTo.Millisecond#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.Millisecond/vb/Millisecond.vb#2)]  
+  
+ 日付および時刻のミリ秒部分を含む完全なカスタム書式指定子を定義する場合、アプリケーションの現在のカルチャの時間要素の取り決めに対応しない可能性のあるハードコーディングされた書式を定義するという問題が生じます。  これに代わるより良い方法は、現在のカルチャの <xref:System.Globalization.DateTimeFormatInfo> オブジェクトで定義されているいずれかの日付および時刻表示パターンを取得して、ミリ秒を含むようにそれを修正することです。  この例では、この方法も示されています。  現在のカルチャの完全な日付および時刻パターンを <xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A?displayProperty=fullName> プロパティから取得した後、その秒パターンの後にカスタム パターン `.ffff` を挿入します。  この例では、1 つのメソッド呼び出しでこの操作を実行するために正規表現が使われていることに注意してください。  
+  
+ また、カスタム書式指定子を使用して、ミリ秒以外の秒の端数を表示することもできます。  たとえば、カスタム書式指定子 `f` または `F` は 1\/10 秒を表示し、カスタム書式指定子 `ff` または `FF` は 1\/100 秒、カスタム書式指定子 `ffff` または `FFFF` は 1\/10000 秒をそれぞれ表示します。  返される文字列内では、ミリ秒の端数は丸められるのではなく、切り捨てられます。  次の例では、これらの書式指定子が使用されています。  
+  
+ [!code-csharp[Formatting.HowTo.Millisecond#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.Millisecond/cs/Millisecond.cs#3)]
+ [!code-vb[Formatting.HowTo.Millisecond#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.Millisecond/vb/Millisecond.vb#3)]  
+  
+> [!NOTE]
+>  1\/10000 秒、1\/100000 秒などの非常に小さな端数単位を表示することが可能です。  ただし、このような値を表示してもあまり意味がない可能性があります。  日付および時刻の値の精度は、システム クロックの分解能に依存します。  Windows NT 3.5 以降および [!INCLUDE[windowsver](../../../includes/windowsver-md.md)] オペレーティング システムでは、クロックの分解能は約 10 ～ 15 ミリ秒です。  
+  
+## コードのコンパイル  
+ コマンド ラインで csc.exe または vb.exe を使用してコードをコンパイルします。  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] でコードをコンパイルするには、コンソール アプリケーション プロジェクト テンプレートの中にコードを配置します。  
+  
+## 参照  
+ <xref:System.Globalization.DateTimeFormatInfo>   
+ [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-extract-a-protocol-and-port-number-from-a-url.md b/docs/standard/base-types/how-to-extract-a-protocol-and-port-number-from-a-url.md
new file mode 100644
index 00000000000..a6a74efffbd
--- /dev/null
+++ b/docs/standard/base-types/how-to-extract-a-protocol-and-port-number-from-a-url.md
@@ -0,0 +1,54 @@
+---
+title: "方法 : URL からプロトコルとポート番号を抽出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 例"
+  - "解析 (正規表現を使用したテキストを), 例"
+  - "パターン一致 (正規表現を使用した), 例"
+  - "正規表現 [.NET Framework], 例"
+  - "正規表現, 例"
+  - "検索 (正規表現を使用した), 例"
+ms.assetid: ab7f62b3-6d2c-4efb-8ac6-28600df5fd5c
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : URL からプロトコルとポート番号を抽出する
+URL からプロトコルとポート番号を抽出する例を次に示します。  
+  
+## 使用例  
+ この例では、<xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドを使用して、プロトコルとそれに続くコロンおよびポート番号を返します。  
+  
+ [!code-csharp[RegularExpressions.Examples.Protocol#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.Protocol/cs/Example.cs#1)]
+ [!code-vb[RegularExpressions.Examples.Protocol#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.Protocol/vb/Example.vb#1)]  
+  
+ 正規表現パターン `^(?<proto>\w+)://[^/]+?(?<port>:\d+)?/` は、次の表に示すように解釈できます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`(?<proto>\w+)`|1 つ以上の単語文字に一致します。  このグループに `proto` という名前を付けます。|  
+|`://`|コロンとそれに続く 2 つのスラッシュ記号に一致します。|  
+|`[^/]+?`|スラッシュ記号以外の任意の文字の 1 回以上の出現 \(ただし、可能な限り少ない回数\) に一致します。|  
+|`(?<port>:\d+)?`|コロンとそれに続く 1 つ以上の 10 進数字の 0 回以上の出現に一致します。  このグループに `port` という名前を付けます。|  
+|`/`|スラッシュ記号に一致します。|  
+  
+ <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドは、正規表現パターンでキャプチャされた 2 つの名前付きグループを連結する `${proto}${port}` 置換シーケンスを展開します。  これは、<xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> プロパティによって返されたコレクション オブジェクトから取得された文字列を明示的に連結する便利な代替方法です。  
+  
+ 例では、`${proto}` と `${port}` の 2 つの置換がある <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドを使用して、キャプチャされたグループを出力文字列に含めています。  次のコードに示すように、一致部分の <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトから、キャプチャされたグループを取得できます。  
+  
+ [!code-csharp[RegularExpressions.Examples.Protocol#2](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.Protocol/cs/example2.cs#2)]
+ [!code-vb[RegularExpressions.Examples.Protocol#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.Protocol/vb/example2.vb#2)]  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-extract-the-day-of-the-week-from-a-specific-date.md b/docs/standard/base-types/how-to-extract-the-day-of-the-week-from-a-specific-date.md
new file mode 100644
index 00000000000..149f470ec1d
--- /dev/null
+++ b/docs/standard/base-types/how-to-extract-the-day-of-the-week-from-a-specific-date.md
@@ -0,0 +1,107 @@
+---
+title: "方法 : 特定の日付から曜日を抽出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式指定 [.NET Framework]、日付"
+  - "DateTime.DayOfWeek プロパティ"
+  - "DateTime.ToString メソッド"
+  - "日付 [.NET Framework], 週の情報を取得する"
+  - "DateTimeOffset.DayOfWeek プロパティ"
+  - "日付 [.NET Framework], 曜日"
+  - "Weekday 関数"
+  - "曜日 [.NET Framework]"
+  - "抽出 (曜日を)"
+  - "曜日の名前"
+  - "WeekdayName 関数"
+  - "数値 [.NET Framework], 曜日"
+  - "書式指定 [.NET Framework], 時刻"
+  - "DateTimeOffset.ToString メソッド"
+  - "曜日の正式名"
+ms.assetid: 1c9bef76-5634-46cf-b91c-9b9eb72091d7
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 特定の日付から曜日を抽出する
+.NET Framework では、特定の日付が週の何日目であるかを容易に判別でき、また特定の日付のローカライズされた曜日名を表示できます。 特定の日付に対応する曜日を示す列挙値は、<xref:System.DateTime.DayOfWeek%2A> または <xref:System.DateTimeOffset.DayOfWeek%2A> プロパティから取得できます。 対照的に、曜日名の取得は、書式指定メソッド （日付と時刻の値の `ToString` メソッドや <xref:System.String.Format%2A?displayProperty=fullName> メソッドなど） を呼び出して実行できる書式指定操作です。 このトピックでは、このような書式指定操作を実行する方法について説明します。  
+  
+### 特定の日付から曜日を示す番号を抽出するには  
+  
+1.  文字列形式の日付を処理している場合には、静的 <xref:System.DateTime> または <xref:System.DateTimeOffset> メソッドを使用して、その日付を<xref:System.DateTime.Parse%2A?displayProperty=fullName> 値または <xref:System.DateTimeOffset.Parse%2A?displayProperty=fullName> 値に変換します。  
+  
+2.  <xref:System.DateTime.DayOfWeek%2A?displayProperty=fullName> プロパティまたは <xref:System.DateTimeOffset.DayOfWeek%2A?displayProperty=fullName> プロパティを使用して、曜日を示す <xref:System.DayOfWeek> 値を取得します。  
+  
+3.  必要に応じて、<xref:System.DayOfWeek> 値を整数にキャスト （C\#） または変換 （Visual Basic） します。  
+  
+ 次の例は、特定の日付の曜日を表す整数を表示します。  
+  
+ [!code-csharp[Formatting.Howto.WeekdayName#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/weekdaynumber7.cs#7)]
+ [!code-vb[Formatting.Howto.WeekdayName#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/weekdaynumber7.vb#7)]  
+  
+### 特定の日付から曜日の省略名を抽出するには  
+  
+1.  文字列形式の日付を処理している場合には、静的 <xref:System.DateTime> または <xref:System.DateTimeOffset> メソッドを使用して、その日付を<xref:System.DateTime.Parse%2A?displayProperty=fullName> 値または <xref:System.DateTimeOffset.Parse%2A?displayProperty=fullName> 値に変換します。  
+  
+2.  次の手順で現在のカルチャまたは特定のカルチャの曜日の省略名を抽出できます。  
+  
+    1.  現在のカルチャの曜日の省略名を抽出するには、日付と時刻の値の <xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> インスタンス メソッドまたは <xref:System.DateTimeOffset.ToString%28System.String%29?displayProperty=fullName> インスタンス メソッドを呼び出し、`format` パラメーターとして文字列 "ddd" を渡します。 次の例に、<xref:System.DateTime.ToString%28System.String%29> メソッドの呼び出しを示します。  
+  
+         [!code-csharp[Formatting.Howto.WeekdayName#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/abbrname1.cs#1)]
+         [!code-vb[Formatting.Howto.WeekdayName#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/abbrname1.vb#1)]  
+  
+    2.  特定のカルチャの曜日の省略名を抽出するには、日付と時刻の値の <xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> インスタンス メソッドまたは <xref:System.DateTimeOffset.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> インスタンス メソッドを呼び出します。`format` パラメーターとして文字列 "ddd" を渡します。 曜日名を取得するカルチャを表す <xref:System.Globalization.CultureInfo> または <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのいずれかを`provider` パラメーターとして渡します。 次のコードは、fr\-FR カルチャを表す <xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29> オブジェクトを使用した <xref:System.Globalization.CultureInfo> メソッドの呼び出しを示します。  
+  
+         [!code-csharp[Formatting.Howto.WeekdayName#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/abbrname2.cs#2)]
+         [!code-vb[Formatting.Howto.WeekdayName#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/abbrname2.vb#2)]  
+  
+### 特定の日付から曜日の正式な名前を抽出するには  
+  
+1.  文字列形式の日付を処理している場合には、静的 <xref:System.DateTime> または <xref:System.DateTimeOffset> メソッドを使用して、その日付を<xref:System.DateTime.Parse%2A?displayProperty=fullName> 値または <xref:System.DateTimeOffset.Parse%2A?displayProperty=fullName> 値に変換します。  
+  
+2.  現在のカルチャまたは特定のカルチャでの曜日の正式な名前を抽出できます。  
+  
+    1.  現在のカルチャの曜日名を抽出するには、日付と時刻の値の <xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> インスタンス メソッドまたは <xref:System.DateTimeOffset.ToString%28System.String%29?displayProperty=fullName> インスタンス メソッドを呼び出し、`format` パラメーターとして文字列 "dddd" を渡します。 次の例に、<xref:System.DateTime.ToString%28System.String%29> メソッドの呼び出しを示します。  
+  
+         [!code-csharp[Formatting.Howto.WeekdayName#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/fullname4.cs#4)]
+         [!code-vb[Formatting.Howto.WeekdayName#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/fullname4.vb#4)]  
+  
+    2.  特定のカルチャの曜日名を抽出するには、日付と時刻の値の <xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> インスタンス メソッドまたは <xref:System.DateTimeOffset.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> インスタンス メソッドを呼び出します。`format` パラメーターとして文字列 "dddd" を渡します。 曜日名を取得するカルチャを表す <xref:System.Globalization.CultureInfo> または <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのいずれかを`provider` パラメーターとして渡します。 次のコードは、es\-ES カルチャを表す <xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29> オブジェクトを使用した <xref:System.Globalization.CultureInfo> メソッドの呼び出しを示します。  
+  
+         [!code-csharp[Formatting.Howto.WeekdayName#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/fullname5.cs#5)]
+         [!code-vb[Formatting.Howto.WeekdayName#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/fullname5.vb#5)]  
+  
+## 使用例  
+ この例は、<xref:System.DateTime.DayOfWeek%2A?displayProperty=fullName> プロパティと<xref:System.DateTimeOffset.DayOfWeek%2A?displayProperty=fullName> プロパティ、および<xref:System.DateTime.ToString%2A?displayProperty=fullName> メソッドと <xref:System.DateTimeOffset.ToString%2A?displayProperty=fullName> メソッドを呼び出し、特定の日付の曜日を表す番号、曜日の省略名、および正式な名前を取得します。  
+  
+ [!code-csharp[Formatting.Howto.WeekdayName#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/example6.cs#6)]
+ [!code-vb[Formatting.Howto.WeekdayName#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/example6.vb#6)]  
+  
+ それぞれの言語には、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の機能と重複する機能または補足する機能が存在していることがあります。 たとえば Visual Basic には次の 2 つの関数があります。  
+  
+-   `Weekday`: 特定の日付の曜日を示す番号を返します。 この関数では週の初日の序数値が 1 ですが、<xref:System.DateTime.DayOfWeek%2A?displayProperty=fullName> プロパティでは週の初日の序数値はゼロです。  
+  
+-   `WeekdayName`: 現在のカルチャで、特定の曜日番号に対応する曜日名を返します。  
+  
+ 次の例は、Visual Basic の `Weekday` 関数と `WeekdayName` 関数の使い方を示します。  
+  
+ [!code-vb[Formatting.HowTo.WeekdayName#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/example9.vb#9)]  
+  
+ また、特定の日付の曜日名を取得するには <xref:System.DateTime.DayOfWeek%2A?displayProperty=fullName> プロパティから返される値も使用できます。 このためには、プロパティから返された <xref:System.Enum.ToString%2A> 値に対して <xref:System.DayOfWeek> メソッドを呼び出す操作だけが必要です。 ただしこの手法では、次の例に示すように、現在のカルチャでのローカライズされた曜日名は作成されません。  
+  
+ [!code-csharp[Formatting.HowTo.WeekdayName#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/cs/Howto1.cs#8)]
+ [!code-vb[Formatting.HowTo.WeekdayName#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.WeekdayName/vb/Howto1.vb#8)]  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)   
+ [標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)   
+ [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md b/docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md
new file mode 100644
index 00000000000..bf48191df31
--- /dev/null
+++ b/docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md
@@ -0,0 +1,100 @@
+---
+title: "方法: 数値に先行するゼロを埋め込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式指定 [.NET Framework], 数"
+  - "数値の書式指定 [.NET Framework]"
+  - "数値 [.NET Framework], 書式指定文字列"
+  - "数値書式指定文字列 [.NET Framework]"
+ms.assetid: 0b2c2cb5-c580-4891-8d81-cb632f5ec384
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法: 数値に先行するゼロを埋め込む
+整数値に先行ゼロを追加するには、精度指定子と[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md) "D" を使用します。  整数値と浮動小数点数値の両方に先行ゼロを追加するには、[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)を使用します。  このトピックでは、この両方の方法で数値に先行ゼロを埋め込む方法を説明します。  
+  
+### 特定の長さになるまで整数値に先行ゼロを埋め込むには  
+  
+1.  整数値を表示する際の最小桁数を決定します。  この数には先行桁数も含みます。  
+  
+2.  整数値を 10 進数値と 16 進数値のどちらで表示するかを決定します。  
+  
+    -   整数値を 10 進数値として表示するには、`ToString(String)` メソッドを呼び出し、パラメーターの値として文字列 "D*n*"`format` を渡します。この*n* は、文字列の最小長を表します。  
+  
+    -   整数値を 16 進数値として表示するには、`ToString(String)` メソッドを呼び出し、パラメーターの値として文字列 "X`format` *n*" を渡します。この*n* は、文字列の最小長を表します。  
+  
+     また、<xref:System.String.Format%2A> や <xref:System.Console.WriteLine%2A> など、[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)を使用するメソッドでもこの書式指定文字列を使用できます。  
+  
+ 次の例は、書式指定された数値全体の長さが 8 文字以上になるように、先行ゼロを使用してさまざまな数値を書式指定します。  
+  
+ [!code-csharp[Formatting.HowTo.PadNumber#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.PadNumber/cs/Pad1.cs#1)]
+ [!code-vb[Formatting.HowTo.PadNumber#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.PadNumber/vb/Pad1.vb#1)]  
+  
+### 特定の数の先行ゼロを整数値に埋め込むには  
+  
+1.  整数値に表示する先行ゼロの数を決定します。  
+  
+2.  整数値を 10 進数値と 16 進数値のどちらで表示するかを決定します。  10 進数値として書式指定する場合には標準書式指定子 "D" を使用する必要があります。16 進数値として書式指定する場合には標準書式指定子 "X" を使用する必要があります。  
+  
+3.  整数値の `ToString("D").Length` メソッドまたは `ToString("X").Length` メソッドを使用して、先行ゼロが埋め込まれていない数値文字列の長さを決定します。  
+  
+4.  書式指定した文字列に埋め込む先行ゼロの数を、埋め込まれていない数値の文字列の長さに加算します。  これにより、埋め込み文字列全体の長さが定義されます。  
+  
+5.  整数値の `ToString(String)` メソッドを呼び出し、10 進数値文字列の場合は "D*n*"、16 進数値の場合は "X*n*" を渡します。*n* は埋め込み文字列全体の長さを表します。  書式指定文字列 "D*n*" または "X*n*"は、複合書式指定をサポートするメソッドでも使用できます。  
+  
+ 次の例は、整数値に 5 つの先行ゼロを埋め込みます。  
+  
+ [!code-csharp[Formatting.HowTo.PadNumber#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.PadNumber/cs/Pad1.cs#2)]
+ [!code-vb[Formatting.HowTo.PadNumber#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.PadNumber/vb/Pad1.vb#2)]  
+  
+### 特定の長さになるまで数値に先行ゼロを埋め込むには  
+  
+1.  文字列形式の数値の整数部分の桁数を決定します。  合計桁数には先行ゼロも含みます。  
+  
+2.  ゼロの最小数を表すゼロ プレースホルダー \("0"\) を使用するカスタム数値書式指定文字列を定義します。  
+  
+3.  数値の `ToString(String)` メソッドを呼び出し、カスタム書式指定文字列を渡します。  カスタム書式指定文字列は、複合書式指定をサポートしているメソッドでも使用できます。  
+  
+ 次の例は、書式指定された数値全体の長さが 8 文字以上の整数になるように、先行ゼロを使用してさまざまな数値を書式指定します。  
+  
+ [!code-csharp[Formatting.HowTo.PadNumber#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.PadNumber/cs/Pad1.cs#3)]
+ [!code-vb[Formatting.HowTo.PadNumber#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.PadNumber/vb/Pad1.vb#3)]  
+  
+### 特定の数の先行ゼロを数値に埋め込むには  
+  
+1.  数値に埋め込む先行ゼロの数を決定します。  
+  
+2.  埋め込みのない数値文字列での整数部の桁数を決定します。  この操作を行うには、次の手順を実行します。  
+  
+    1.  文字列形式の数値に小数点が含まれるかどうかを決定します。  
+  
+    2.  小数点記号を含める場合は、整数部分の文字数を決定します。  
+  
+         または  
+  
+         小数点記号を含めない場合は、文字列の長さを決定します。  
+  
+3.  文字列に表示する各先行ゼロの位置にゼロ プレースホルダー \("0"\) を使用し、既定の文字列の各桁の位置にゼロ プレースホルダーまたは桁プレースホルダー \("\#"\) を使用するカスタム書式指定文字列を作成します。  
+  
+4.  数値の `ToString(String)` メソッド、または複合書式指定をサポートするメソッドのパラメーターとして、カスタム書式指定文字列を指定します。  
+  
+ 次の例は、2 つの <xref:System.Double> 値を 5 つの先行ゼロで埋め込みます。  
+  
+ [!code-csharp[Formatting.HowTo.PadNumber#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.PadNumber/cs/Pad1.cs#4)]
+ [!code-vb[Formatting.HowTo.PadNumber#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.PadNumber/vb/Pad1.vb#4)]  
+  
+## 参照  
+ [カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)   
+ [標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)   
+ [複合書式指定](../../../docs/standard/base-types/composite-formatting.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-round-trip-date-and-time-values.md b/docs/standard/base-types/how-to-round-trip-date-and-time-values.md
new file mode 100644
index 00000000000..e59abe256bd
--- /dev/null
+++ b/docs/standard/base-types/how-to-round-trip-date-and-time-values.md
@@ -0,0 +1,106 @@
+---
+title: "方法 : 日付と時刻の値をラウンドトリップさせる | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ラウンドトリップ (日付と時刻の値を)"
+  - "日付 [.NET Framework]、ラウンドトリップ (値を)"
+  - "タイム ゾーン [.NET Framework]、ラウンドトリップ (日付と時刻の値を)"
+  - "時刻 [.NET Framework]、ラウンドトリップ (値を)"
+  - "書式指定 (文字列の) [.NET Framework]、ラウンドトリップ (値を)"
+ms.assetid: b609b277-edc6-4c74-b03e-ea73324ecbdb
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 日付と時刻の値をラウンドトリップさせる
+ある特定の時点を明確に表すように日付と時刻の値を保つことは、多くのアプリケーションに共通する要件です。  このトピックでは、<xref:System.DateTime> 値、<xref:System.DateTimeOffset> 値、およびタイム ゾーン情報を持った日時値を保存する方法、および、保存した日時とまったく同じ時点を表すように復元する方法について説明します。  
+  
+### DateTime 値をラウンドトリップさせるには  
+  
+1.  <xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> メソッドと "o" 書式指定子を使用して、<xref:System.DateTime> 値を対応する文字列形式に変換します。  
+  
+2.  <xref:System.DateTime> 値の文字列形式をファイルに保存するか、プロセス、アプリケーション ドメイン、またはマシン境界に渡します。  
+  
+3.  <xref:System.DateTime> 値を表す文字列を取得します。  
+  
+4.  <xref:System.DateTime.Parse%28System.String%2CSystem.IFormatProvider%2CSystem.Globalization.DateTimeStyles%29?displayProperty=fullName> メソッドを呼び出し、`styles` パラメーターの値として <xref:System.Globalization.DateTimeStyles?displayProperty=fullName> を渡します。  
+  
+ <xref:System.DateTime> の値をラウンドトリップさせる方法を次の例に示します。  
+  
+ [!code-csharp[Formatting.HowTo.RoundTrip#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/cs/RoundTrip.cs#1)]
+ [!code-vb[Formatting.HowTo.RoundTrip#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/vb/RoundTrip.vb#1)]  
+  
+ <xref:System.DateTime> の値をラウンドトリップさせる場合、この方法により、あらゆる現地時刻と協定世界時刻を適切に保存できます。  たとえば、<xref:System.DateTime> ローカル値は米国の太平洋標準時タイム ゾーンのシステムに格納され、米国の中部標準時ゾーンのシステムで保存した場合、元の時刻は 2 個のタイム ゾーン間の時差を反映し、元の時刻より後の 2 時間です。  ただし、タイム ゾーンが指定されていない時刻の場合、この方法では必ずしも正確な結果を得ることができません。  <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind> である <xref:System.DateTime> 値はすべて現地時刻として扱われます。  現地時刻以外では、<xref:System.DateTime> が間違った時点を示すことになります。  この制限は、日付と時刻の値に、該当するタイム ゾーンを確実に関連付けた上で、保存操作と復元操作を行うことによって回避できます。  
+  
+### DateTimeOffset 値をラウンドトリップさせるには  
+  
+1.  <xref:System.DateTimeOffset.ToString%28System.String%29?displayProperty=fullName> メソッドと "o" 書式指定子を使用して、<xref:System.DateTimeOffset> 値を対応する文字列形式に変換します。  
+  
+2.  <xref:System.DateTimeOffset> 値の文字列形式をファイルに保存するか、プロセス、アプリケーション ドメイン、またはマシン境界に渡します。  
+  
+3.  <xref:System.DateTimeOffset> 値を表す文字列を取得します。  
+  
+4.  <xref:System.DateTimeOffset.Parse%28System.String%2CSystem.IFormatProvider%2CSystem.Globalization.DateTimeStyles%29?displayProperty=fullName> メソッドを呼び出し、`styles` パラメーターの値として <xref:System.Globalization.DateTimeStyles?displayProperty=fullName> を渡します。  
+  
+ <xref:System.DateTimeOffset> の値をラウンドトリップさせる方法を次の例に示します。  
+  
+ [!code-csharp[Formatting.HowTo.RoundTrip#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/cs/RoundTrip.cs#2)]
+ [!code-vb[Formatting.HowTo.RoundTrip#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/vb/RoundTrip.vb#2)]  
+  
+ この方法により、<xref:System.DateTimeOffset> の値が、常にある特定の時点として明確に識別されます。  その後、<xref:System.DateTimeOffset.ToUniversalTime%2A?displayProperty=fullName> メソッドを呼び出すことによって、この値を世界協定時刻 \(UTC\) に変換できます。また、<xref:System.DateTimeOffset.ToOffset%2A?displayProperty=fullName> メソッドまたは <xref:System.TimeZoneInfo.ConvertTime%28System.DateTimeOffset%2CSystem.TimeZoneInfo%29?displayProperty=fullName> メソッドを呼び出すことによって、特定のタイム ゾーンの時刻に変換することもできます。  この方法には、特定のタイム ゾーンの時刻を表す <xref:System.DateTimeOffset> の値に対して日付と時刻の演算を行った場合、そのタイム ゾーンにおける正確な結果を得ることができないという重要な制限があります。  これは、<xref:System.DateTimeOffset> の値をインスタンス化すると、対応するタイム ゾーンとの関連付けが解除されるためです。  したがって、日付と時刻の計算を実行した場合、タイム ゾーンの調整規則は適用されません。  この問題は、日付値と時刻値、および付随するタイム ゾーンを保持するカスタム型を定義することによって回避できます。  
+  
+### 対応するタイム ゾーンと共に日付と時刻の値をラウンドトリップさせるには  
+  
+1.  2 つのフィールドを持ったクラスまたは構造体を定義します。  1 つ目のフィールドは <xref:System.DateTime> オブジェクトまたは <xref:System.DateTimeOffset> オブジェクトに、2 つ目のフィールドは <xref:System.TimeZoneInfo> オブジェクトにします。  これを踏まえた単純な型の例を次に示します。  
+  
+     [!code-csharp[Formatting.HowTo.RoundTrip#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/cs/RoundTrip.cs#3)]
+     [!code-vb[Formatting.HowTo.RoundTrip#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/vb/RoundTrip.vb#3)]  
+  
+2.  このクラスに <xref:System.SerializableAttribute> 属性を適用します。  
+  
+3.  <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Serialize%2A?displayProperty=fullName> メソッドを使用してオブジェクトをシリアル化します。  
+  
+4.  <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize%2A> メソッドを使用してオブジェクトを復元します。  
+  
+5.  逆シリアル化したオブジェクトを適切な型のオブジェクトにキャスト \(C\# の場合\) または変換 \(Visual Basic の場合\) します。  
+  
+ 日付値と時刻値およびタイム ゾーン情報が格納されたオブジェクトをラウンドトリップさせる方法を次の例に示します。  
+  
+ [!code-csharp[Formatting.HowTo.RoundTrip#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/cs/RoundTrip.cs#4)]
+ [!code-vb[Formatting.HowTo.RoundTrip#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.HowTo.RoundTrip/vb/RoundTrip.vb#4)]  
+  
+ この方法では、日付、時刻、およびタイム ゾーンの組み合わせを保持するオブジェクトが、日付値とタイム ゾーン値を確実に同期するように実装されている場合、保存と復元の前後で正確な時点が常に明確に反映されます。  
+  
+## コードのコンパイル  
+ これらの例では、次の項目が必要です。  
+  
+-   C\# の `using` ステートメントまたは [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の `Imports` ステートメントで次の名前空間がインポートされていること。  
+  
+    -   <xref:System> \(C\# のみ\)。  
+  
+    -   <xref:System.Globalization?displayProperty=fullName>.  
+  
+    -   <xref:System.IO?displayProperty=fullName>.  
+  
+    -   <xref:System.Runtime.Serialization?displayProperty=fullName>.  
+  
+    -   <xref:System.Runtime.Serialization.Formatters.Binary?displayProperty=fullName>.  
+  
+-   System.Core.dll が参照設定されていること。  
+  
+-   `DateInTimeZone` クラス以外のすべてのコード例は、クラスまたは Visual Basic のモジュールのメソッドとして記述し、`Main` メソッドから呼び出すこと。  
+  
+## 参照  
+ [書式設定操作の実行](../../../docs/standard/base-types/performing-formatting-operations.md)   
+ [DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](../../../docs/standard/datetime/choosing-between-datetime.md)   
+ [標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-strip-invalid-characters-from-a-string.md b/docs/standard/base-types/how-to-strip-invalid-characters-from-a-string.md
new file mode 100644
index 00000000000..e6b45f160a0
--- /dev/null
+++ b/docs/standard/base-types/how-to-strip-invalid-characters-from-a-string.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : 文字列から無効な文字を取り除く | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現、例"
+  - "整形 (入力の)"
+  - "ユーザー入力、例"
+  - ".NET Framework 正規表現、例"
+  - "正規表現 [.NET Framework]、例"
+  - "Regex.Replace メソッド"
+  - "削除 (無効な文字列を)"
+  - "Replace メソッド"
+  - "検証 (ユーザー入力の)"
+ms.assetid: b4319c8a-9032-4129-a9d5-6f6fc28e7f32
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : 文字列から無効な文字を取り除く
+静的な <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドを使用して、文字列から無効な文字を取り除く例を次に示します。  
+  
+## 使用例  
+ この例で定義した `CleanInput` メソッドを使用すると、ユーザーがテキスト フィールドで入力した文字列の中から、潜在的な危険性がある文字を取り除くことができます。  この場合、`CleanInput` は、ピリオド \(.\)、アット マーク \(@\)、およびハイフン \(\-\) 以外のすべての非英数文字を取り除き、残りの文字列を返します。  ただし、入力文字列に含めてはいけないすべての文字を取り除くように正規表現パターンを変更することができます。  
+  
+ [!code-csharp[RegularExpressions.Examples.StripChars#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.StripChars/cs/Example.cs#1)]
+ [!code-vb[RegularExpressions.Examples.StripChars#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.StripChars/vb/Example.vb#1)]  
+  
+ 正規表現パターン `[^\w\.@-]` は、単語に使用される文字、ピリオド、@ 記号、またはハイフン以外の任意の文字と一致します。  単語に使用される文字は、任意の文字、10 進数字、またはアンダースコアなどのコネクタ区切り記号です。  このパターンに一致する文字は、置換パターンで定義された文字列である <xref:System.String.Empty?displayProperty=fullName> に置き換えられます。  ユーザー入力でその他の文字を許可するには、それらの文字を正規表現パターンの文字クラスに追加します。  たとえば、正規表現パターン `[^\w\.@-\\%]` は、入力文字列でパーセント記号と円記号も許可します。  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md b/docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md
new file mode 100644
index 00000000000..d5df8ade53b
--- /dev/null
+++ b/docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md
@@ -0,0 +1,111 @@
+---
+title: "方法 : 文字列が有効な電子メール形式であるかどうかを検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現、例"
+  - "ユーザー入力、例"
+  - "Regex.IsMatch メソッド"
+  - "正規表現 [.NET Framework]、例"
+  - "例 [Visual Basic]、文字列"
+  - "IsValidEmail"
+  - "検証、電子メールの文字列"
+  - "入力、確認"
+  - "文字列 [.NET Framework]、例 [Visual Basic]"
+  - "電子メール [.NET Framework]、検証"
+  - "IsMatch メソッド"
+ms.assetid: 7536af08-4e86-4953-98a1-a8298623df92
+caps.latest.revision: 30
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# 方法 : 文字列が有効な電子メール形式であるかどうかを検証する
+正規表現を使用して文字列の形式が有効な電子メール形式であるかどうかを検証する例を次に示します。  
+  
+## 使用例  
+ 次の例では、`IsValidEmail` メソッドを定義します。このメソッドは、文字列に有効な電子メール アドレスが含まれている場合に `true` を返し、含まれていない場合に `false` を返します。それ以外の動作は行いません。  
+  
+ 電子メール アドレスが有効であることを確認するため、`IsValidEmail` メソッドは <xref:System.Text.RegularExpressions.Regex.Replace%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.MatchEvaluator%29?displayProperty=fullName> メソッドを呼び出し、`(@)(.+)$` の正規表現パターンを指定して、電子メール アドレスからドメイン名を切り離します。 3 番目のパラメーターは、一致したテキストを操作また置換するメソッドを表す <xref:System.Text.RegularExpressions.MatchEvaluator> デリゲートです。 正規表現パターンは次のように解釈されます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(@)`|@ 文字と一致します。 これが最初のキャプチャ グループです。|  
+|`(.+)`|任意の文字の 1 回以上の出現に一致します。 これが 2 番目のキャプチャ グループです。|  
+|`$`|入力文字列の末尾で照合を終了します。|  
+  
+ ドメイン名は @ 文字と合わせて `DomainMapper` メソッドに渡されます。このメソッドは <xref:System.Globalization.IdnMapping> クラスを使用して、US\-ASCII 文字の範囲に含まれない Unicode 文字を Punycode に変換します。 また、このメソッドは、`invalid` メソッドがドメイン名に無効な文字を検出すると、`True` フラグを <xref:System.Globalization.IdnMapping.GetAscii%2A?displayProperty=fullName> に設定します。 このメソッドは、Punycode ドメイン名の前に @ 記号を付けて、これを `IsValidEmail` メソッドに返します。  
+  
+ 次に、`IsValidEmail` メソッドは <xref:System.Text.RegularExpressions.Regex.IsMatch%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドを呼び出して、電子メール アドレスが正規表現パターンに準拠するかどうかを確認します。  
+  
+ `IsValidEmail` メソッドは、認証によって電子メール アドレスを検証するわけではありません。 電子メール アドレスの形式として有効かどうかを判断しているだけです。 さらに、`IsValidEmail` メソッドは、最上位ドメイン名が [IANA ルート ゾーン データベース](https://www.iana.org/domains/root/db)に掲載されている有効なドメイン名であることを確認しません \(これには検索操作が必要です\)。 代わりに、正規表現によって単に最上位ドメイン名が 2 ～ 24 文字の ASCII 英数字で構成されており、最初の文字と末尾の文字は英数字、その他の文字は英数字またはハイフン \(\-\) であることを確認します。  
+  
+ [!code-csharp[RegularExpressions.Examples.Email#7](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.Email/cs/example4.cs#7)]
+ [!code-vb[RegularExpressions.Examples.Email#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.Email/vb/example4.vb#7)]  
+  
+ この例の正規表現パターン `^(?(")(".+?(?<!\\)"@)|(([0-9a-z]((\.(?!\.))|[-!#\$%&'\*\+/=\?\^`\{\}\|~\w])*)(?<=[0-9a-z])@))(?(\[)(\[(\d{1,3}\.){3}\d{1,3}\])|(([0-9a-z][-\w]*[0-9a-z]*\.)+[a-z0-9][\-a-z0-9]{0,22}[a-z0-9]))$` の意味を次の表に示します。 正規表現のコンパイルでは、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> フラグが使用されることに注意してください。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|文字列の先頭から照合を開始します。|  
+|`(?(")`|最初の文字が引用符であるかどうかを確認します。`(?(")` は代替構成体の開始位置です。|  
+|`(?("")("".+?(?<!\\)""@)`|最初の文字が引用符である場合、始まりの引用符に続く 1 つ以上の任意の文字と終わりの引用符に一致します。 終わりの引用符の前には円記号 \(\\\) を使用できません。`(?<!` はゼロ幅の否定先読みアサーションの開始です。 文字列はアット マーク \(@\) で終わる必要があります。|  
+|`&#124;(([0-9a-z]`|最初の文字が引用符でない場合は、a ～ z または A ～ Z の任意の英字または 0 ～ 9 の任意の数字と一致します \(比較では大文字小文字は区別されません\)。|  
+|`(\.(?!\.))`|次の文字がピリオドの場合は、その文字と一致します。 ピリオドでない場合は、次の文字を先読みして照合を継続します。`(?!\.)` は、2 つの連続するピリオドが電子メール アドレスのローカル部分に出現することを防ぐゼロ幅の負の先読みアサーションです。|  
+|`&#124;[-!#\$%&'\*\+/=\?\^`\{\}\&#124;~\w]`|次の文字がピリオドでない場合は、任意の単語文字または \-\!\#$%'\*\+\=?^\`{}&#124;~ のいずれかの文字と一致します。|  
+|`((\.(?!\.))&#124;[-!#\$%'\*\+/=\?\^`\{\}\&#124;~\w])*`|0 回以上の代替パターン \(ピリオドとそれに続くピリオド以外の文字、または複数の文字のうちのいずれかの 1 文字\) と一致します。|  
+|`@`|@ 文字と一致します。|  
+|`(?<=[0-9a-z])`|@ 文字の前にくる文字が A ～ Z、a ～ z、または 0 ～ 9 である場合に照合を継続します。`(?<=[0-9a-z])` 構成体は、ゼロ幅の正の後読みアサーションを定義します。|  
+|`(?(\[)`|@ に続く文字が左角かっこかどうかを確認します。|  
+|`(\[(\d{1,3}\.){3}\d{1,3}\])`|左角かっこの場合は、左角かっこ、それに続く IP アドレス \(各セットがピリオドで区切られた、4 セットの 1 ～ 3 桁の数字\)、および右角かっこと一致します。|  
+|`&#124;(([0-9a-z][-\w]*[0-9a-z]*\.)+`|@ に続く文字が左角かっこでない場合は、値が A ～ Z、a ～ z、または 0 ～ 9 の 1 つの英数字の後に、単語文字またはハイフンの 0 回以上の出現、A ～ Z、a ～ z、または 0 ～ 9 の値の 0 個または 1 つの英数字、さらにピリオドが続くパターンと一致します。 このパターンは 1 回以上繰り返すことができ、後ろに最上位ドメイン名が続く必要があります。|  
+|`[a-z0-9][\-a-z0-9]{0,22}[a-z0-9]))`|最上位ドメイン名では、最初の文字と最後の文字が英数字文字 \(a ～ z、A ～ Z、0 ～ 9\) である必要があります。 また、0 ～ 22 文字の ASCII 文字 \(英数字またはハイフン\) を含めることができます。|  
+|`$`|入力文字列の末尾で照合を終了します。|  
+  
+> [!NOTE]
+>  電子メール アドレスの検証に正規表現を使用する代わりに、<xref:System.Net.Mail.MailAddress?displayProperty=fullName> クラスを使用できます。 電子メール アドレスが有効であるかどうかを判別するには、電子メール アドレスを<xref:System.Net.Mail.MailAddress.%23ctor%28System.String%29?displayProperty=fullName> クラス コンストラクターに渡します。  
+  
+## コードのコンパイル  
+ `IsValidEmail` メソッドと `DomainMapper` メソッドは、正規表現ユーティリティ メソッドのライブラリに含めることができるほか、アプリケーション クラス内のプライベートな静的メソッドやインスタンス メソッドとして含めることもできます。  
+  
+ これらを正規表現ライブラリに含めるには、Visual Studio のクラス ライブラリ プロジェクトにコードをコピーして貼り付けるか、コードをテキスト ファイルにコピーして貼り付けて、次のようなコマンドでコマンド ラインからコンパイルします \(ソース コード ファイルの名前を RegexUtilities.cs または RegexUtilities.vb と仮定しています\)。  
+  
+```csharp  
+csc /t:library RegexUtilities.cs  
+```  
+  
+```vb  
+vbc /t:library RegexUtilities.vb  
+```  
+  
+ また、<xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName> メソッドを使用して、この正規表現を正規表現ライブラリに追加できます。  
+  
+ 正規表現ライブラリ内で使用した場合は、次のようなコードを使用して呼び出すことができます。  
+  
+ [!code-csharp[RegularExpressions.Examples.Email#8](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.Email/cs/example4.cs#8)]
+ [!code-vb[RegularExpressions.Examples.Email#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.Email/vb/example4.vb#8)]  
+  
+ 電子メール検証の正規表現を含む RegexUtilities.dll という名前のクラス ライブラリを作成してあると仮定した場合、この例は次の方法のいずれかでコンパイルできます。  
+  
+-   Visual Studio では、コンソール アプリケーションを作成して、RegexUtilities.dll への参照をプロジェクトに追加します。  
+  
+-   コマンド ラインからは、ソース コードをテキスト ファイルにコピーして貼り付け、次のようなコマンドでコンパイルします \(ソース コード ファイルの名前を Example.cs または Example.vb と仮定しています\)。  
+  
+    ```csharp  
+    csc Example.cs /r:RegexUtilities.dll  
+    ```  
+  
+    ```vb  
+    vbc Example.vb /r:RegexUtilities.dll  
+    ```  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/index.md b/docs/standard/base-types/index.md
index 8245ab72770..a060bb53e33 100644
--- a/docs/standard/base-types/index.md
+++ b/docs/standard/base-types/index.md
@@ -1,35 +1,44 @@
 ---
-title: "基本型の操作"
-description: "基本型の操作"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/22/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: e53e414f-e0b6-4076-a6ab-189ba93e23cd
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 2be90e0a3e6627152532ff607768dbbb333045d7
-ms.lasthandoff: 04/05/2017
-
----
-
-# <a name="working-with-base-types"></a>基本型の操作
-
-このセクションでは、書式設定、変換、および一般的な操作を含む、.NET 基本型の操作について説明します。
-
-## <a name="in-this-section"></a>このセクションの内容
-
-[型変換](type-conversion.md) - 型を変換する方法について説明します。
-
-[型の書式設定](formatting-types.md) - 文字列の書式指定子を使用して文字列の書式を設定する方法について説明します。
-
-[文字列の操作](manipulating-strings.md) - 文字列を操作し、書式設定する方法について説明します。
-
-[文字列の解析](parsing-strings.md) - 文字列を型に変換する方法について説明します。
-
-[共通型システム](common-type-system.md) - .NET で使用される型について説明します。
-
+title: ".NET Framework における基本型の作業 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "型、基本"
+  - "基本型"
+  - "型システム、基本型"
+ms.assetid: 028d0ce8-ebc2-4a88-a16f-17508f6d0bd6
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# .NET Framework における基本型の作業
+ここでは、.NET Framework の基本型の操作 \(書式指定、変換、一般的な操作など\) について説明します。  
+  
+## このセクションの内容  
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)  
+ 型を別の型に変換する方法について説明します。  
+  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)  
+ 文字列書式指定子を使用して文字列の書式を指定する方法について説明します。  
+  
+ [文字列の操作](../../../docs/standard/base-types/manipulating-strings.md)  
+ 文字列の操作と書式指定の方法について説明します。  
+  
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)  
+ 文字列を .NET Framework の型に変換する方法について説明します。  
+  
+## 関連項目  
+ [共通型システム](../../../docs/standard/base-types/common-type-system.md)  
+ .NET Framework で使用される型について説明します。  
+  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)  
+ タイム ゾーン対応のアプリケーションでのタイム ゾーンの処理方法とタイム ゾーンの変換について説明します。
\ No newline at end of file
diff --git a/docs/standard/base-types/manipulating-strings.md b/docs/standard/base-types/manipulating-strings.md
index 9315946bb0c..084c7317bd4 100644
--- a/docs/standard/base-types/manipulating-strings.md
+++ b/docs/standard/base-types/manipulating-strings.md
@@ -1,40 +1,43 @@
 ---
-title: "文字列の操作"
-description: "文字列の操作"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/22/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: da3c277e-b06e-48bd-ae1f-1e7e4240b93e
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 0ad6a7ef456e7967b3c23e58cd7afa97a4b786de
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="manipulating-strings"></a>文字列の操作
-
-.NET では、文字列を効率的に作成、比較、変更できるだけでなく、検索、削除、およびテキスト パターンを置換するために、大量のテキストとデータをすばやく解析できる広範囲のルーチンのセットを提供しています。
-
-## <a name="in-this-section"></a>このセクションの内容
-
-[文字列の使用のベスト プラクティス](best-practices-strings.md) - .NET での文字列の並べ替え、比較、および大文字小文字の区別の方法を調査し、文字列処理方法を選択する場合の推奨事項を示します。 
-
-[正規表現](regular-expressions.md) -言語要素、正規表現の動作、例などの .NET の正規表現の詳細について説明します。
-
-[基本的な文字列操作](basic-string-operations.md) - バイト配列からの新しい文字列の作成、文字列値の比較、既存の文字列の変更など、@System.String および @System.Text.StringBuilder クラスによって提供される文字列の操作について説明します。
-
-[.NET での文字エンコード](character-encoding.md) - Unicode などの文字形式をエンコードおよびデコードする方法について説明します。
-
-[型変換](type-conversion.md) - 型を変換する方法について説明します。
-
-[型の書式設定](formatting-types.md) - 文字列の書式指定子を使用して文字列の書式を設定する方法について説明します。
-
-[文字列の解析](parsing-strings.md) - 文字列を型に変換する方法について説明します。
-
-
+title: ".NET Framework における文字列の操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "操作 (文字列を)"
+  - "文字列 [.NET Framework], 操作"
+ms.assetid: d4568ff3-9f83-4549-acd8-47aec2194ac0
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# .NET Framework における文字列の操作
+.NET Framework は広範囲にわたるルーチン セットを提供しており、それらを使用することで効率的に文字列を作成、比較、修正したり、大量のテキストおよびデータをすばやく解析して検索、削除したり、テキスト パターンと置換したりできます。  
+  
+## このセクションの内容  
+ [文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md)  
+ .NET Framework の文字列の並べ替え、比較、および大文字と小文字の区別のメソッドについて検討し、文字列処理メソッドを選択するための推奨事項を示します。  
+  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)  
+ 言語要素、正規表現の動作、例など、.NET Framework 正規表現について詳しく説明します。  
+  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)  
+ バイト配列から新しい文字列を作成する、文字列の値を比較する、既存の文字列を変更するなど、<xref:System.String?displayProperty=fullName> クラスと <xref:System.Text.StringBuilder?displayProperty=fullName> クラスに用意されている文字列操作について説明します。  
+  
+## 関連項目  
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)  
+ .NET Framework を使用した型の変換で使用される手法と規則について説明します。  
+  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)  
+ 基本クラス ライブラリによる書式指定機能の実装方法、数値型の書式指定方法、文字列型の書式指定方法、特定のカルチャでの書式指定方法について説明します。  
+  
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)  
+ オブジェクトの文字列表現によって指定された値にオブジェクトを初期化する方法について説明します。  解析は書式設定の逆の操作です。
\ No newline at end of file
diff --git a/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md b/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md
new file mode 100644
index 00000000000..15cc051f6a2
--- /dev/null
+++ b/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md
@@ -0,0 +1,107 @@
+---
+title: "正規表現でのその他の構成体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, その他の構成体"
+  - "構成体, その他"
+  - "正規表現, その他の構成体"
+ms.assetid: 7d10d11f-680f-4721-b047-fb136316b4cd
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 正規表現でのその他の構成体
+.NET Framework の正規表現には、その他の言語構成要素が 3 つ含まれています。  そのうちの 1 つを使用すると、正規表現パターンの途中で特定の一致オプションを有効または無効にできます。  残りの 2 つを使用すると、正規表現にコメントを含めることができます。  
+  
+## インライン オプション  
+ 次の構文を使用すると、正規表現の一部に対して、特定のパターン一致オプションを設定したり、無効にしたりできます。  
+  
+```  
+(?imnsx-imnsx)  
+```  
+  
+ 有効にするオプションは疑問符の後に、無効にするオプションはマイナス記号の後に指定します。  各オプションの説明を次の表に示します。  各オプションの詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`i`|大文字と小文字を区別しない一致を指定します。|  
+|`m`|複数行モードを指定します。|  
+|`n`|明示的なキャプチャのみを指定します。かっこはキャプチャ グループとして機能しません。|  
+|`s`|単一行モードを指定します。|  
+|`x`|エスケープされない空白を無視し、x モード コメントを許可します。|  
+  
+ `(?imnsx-imnsx)` 構成体で定義した正規表現オプションの変更は、包含するグループの末尾まで有効です。  
+  
+> [!NOTE]
+>  `(?imnsx-imnsx:` *subexpression* `)` のグループ化構成体は、部分式と同じ機能を提供します。  詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+ 次の例では、`i`、`n`、および `x` の各オプションを使用して、正規表現の途中で、大文字と小文字を区別しないようにし、明示的なキャプチャを有効にし、正規表現パターン内の空白を無視するようにしています。  
+  
+ [!code-csharp[RegularExpressions.Language.Miscellaneous#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.miscellaneous/cs/miscellaneous1.cs#1)]
+ [!code-vb[RegularExpressions.Language.Miscellaneous#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.miscellaneous/vb/miscellaneous1.vb#1)]  
+  
+ この例では、2 つの正規表現を定義しています。  最初の `\b(D\w+)\s(d\w+)\b` は、大文字の "D" と小文字の "d" で始まる連続する 2 語に一致します。  2 番目の正規表現 `\b(D\w+)(?ixn) \s (d\w+) \b` は、インライン オプションを使用して、このパターンを次の表に示すように変更しています。  結果の比較により、`(?ixn)` 構成要素の効果が確認できます。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(D\w+)`|大文字の "D" の後に単語に使用される文字が 1 個以上続くパターンに一致します。  これが最初のキャプチャ グループです。|  
+|`(?ixn)`|これ以降、比較で大文字と小文字を区別しないようにし、明示的なキャプチャのみを行い、正規表現パターン内の空白を無視します。|  
+|`\s`|空白文字と一致します。|  
+|`(d\w+)`|大文字または小文字の "d" の後に単語に使用される文字が 1 個以上続くパターンに一致します。  `n` \(明示的なキャプチャ\) オプションが有効になっているため、このグループはキャプチャされません。|  
+|`\b`|ワード境界に一致します。|  
+  
+## インライン コメント  
+ `(?#` *comment* `)` 構造体が正規表現にインライン コメントを含めることができます。  コメントのいずれの部分も、正規表現エンジンによるパターン一致に使用されません。ただし、<xref:System.Text.RegularExpressions.Regex.ToString%2A?displayProperty=fullName> メソッドで返される文字列には、コメントが含まれます。  コメントは、最初の閉じかっこで終了します。  
+  
+ 次の例では、前のセクションの例のうち、最初の正規表現パターンを使用しています。  正規表現に 2 つのインライン コメントを追加して、比較で大文字と小文字を区別するかどうかを示しています。  正規表現パターン `\b((?# case-sensitive comparison)D\w+)\s((?#case-insensitive comparison)d\w+)\b` は、次のように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(?# case-sensitive comparison)`|コメント。  これは、パターン一致動作に影響しません。|  
+|`(D\w+)`|大文字の "D" の後に単語に使用される文字が 1 個以上続くパターンに一致します。  これが最初のキャプチャ グループです。|  
+|`\s`|空白文字と一致します。|  
+|`(?ixn)`|これ以降、比較で大文字と小文字を区別しないようにし、明示的なキャプチャのみを行い、正規表現パターン内の空白を無視します。|  
+|`(?#case-insensitive comparison)`|コメント。  これは、パターン一致動作に影響しません。|  
+|`(d\w+)`|大文字または小文字の "d" の後に単語に使用される文字が 1 個以上続くパターンに一致します。  これが 2 番目のキャプチャ グループです。|  
+|`\b`|ワード境界に一致します。|  
+  
+ [!code-csharp[RegularExpressions.Language.Miscellaneous#2](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.miscellaneous/cs/miscellaneous2.cs#2)]
+ [!code-vb[RegularExpressions.Language.Miscellaneous#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.miscellaneous/vb/miscellaneous2.vb#2)]  
+  
+## 行末コメント  
+ シャープ記号 \(`#`\) は x モード コメントを示します。このコメントは、正規表現パターンの末尾にあるエスケープされない \# 文字から行末までです。  この構成体を使用するには、`x` オプションを \(インライン オプションで\) 有効にするか、<xref:System.Text.RegularExpressions.Regex> オブジェクトのインスタンス化時または <xref:System.Text.RegularExpressions.Regex> 静的メソッドの呼び出し時に <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> 値を `option` パラメーターに指定する必要があります。  
+  
+ 行末コメント構成体を次の例に示します。  この例では、文字列が、1 つ以上の書式指定項目を含む複合書式指定文字列であるかどうかを判断しています。  正規表現パターンの構成要素の説明を次の表に示します。  
+  
+ `\{\d+(,-*\d+)*(\:\w{1,4}?)*\}(?x) # Looks for a composite format item.`  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\{`|左中かっこ \({\) に一致します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`(,-*\d+)*`|コンマの後に省略可能なマイナス記号、その後に 1 個以上の 10 進数が続くパターンに 0 回または 1 回一致します。|  
+|`(\:\w{1,4}?)*`|コロンの後に 1 ～ 4 個の \(できるだけ少ない\) 空白文字が続くパターンに 0 回または 1 回一致します。|  
+|`(?#case insensitive comparison)`|インライン コメントです。  これは、パターン一致動作に影響しません。|  
+|`\}`|右中かっこ \(}\) に一致します。|  
+|`(?x)`|行末コメントが認識されるように、パターンの空白を無視するオプションを有効にします。|  
+|`# Looks for a composite format item.`|行末コメントです。|  
+  
+ [!code-csharp[RegularExpressions.Language.Miscellaneous#3](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.language.miscellaneous/cs/miscellaneous3.cs#3)]
+ [!code-vb[RegularExpressions.Language.Miscellaneous#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.language.miscellaneous/vb/miscellaneous3.vb#3)]  
+  
+ 正規表現に `(?x)` 構成要素を指定する代わりに、<xref:System.Text.RegularExpressions.Regex.IsMatch%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> メソッドを呼び出して <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> 列挙値を渡すことによっても、コメントを認識されるようにすることができます。  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/padding.md b/docs/standard/base-types/padding.md
index 8ea444a5dcd..d3a6aec0999 100644
--- a/docs/standard/base-types/padding.md
+++ b/docs/standard/base-types/padding.md
@@ -1,65 +1,52 @@
 ---
-title: "文字列の埋め込み"
-description: "文字列の埋め込み"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 1c8b3b44-d370-49e1-90b5-64ac81c02ae91c8b3b44-d370-49e1-90b5-64ac81c02ae9
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: bc3cc9028b232cc2ba6ca3130c4bdb261c4a0a42
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="padding-strings"></a>文字列の埋め込み
-
-ある文字の先頭または末尾に文字を埋め込み、合計を指定の長さにするとき、元の文字列で構成される新しい文字列を次の [System.String](xref:System.String) メソッドの&1; つを利用して作成します。 埋め込み文字にはスペースや指定した文字を利用できます。結果的に、右揃えまたは左揃えのように見えます。
-
-メソッド名 | 使用
------------ | ---
-[String.PadLeft](xref:System.String.PadLeft(System.Int32)) | 文字列の先頭に文字を埋め込み、合計を指定の長さにします。
-[String.PadRight](xref:System.String.PadRight(System.Int32)) | 文字列の末尾に文字を埋め込み、合計を指定の長さにします。
-
-## <a name="padleft"></a>PadLeft
-
-[String.PadLeft](xref:System.String.PadLeft(System.Int32)) メソッドでは、元の文字列の先頭に埋め込み文字をつなげ、合計を指定の長さにすることで新しい文字列を作成します。 [String.PadLeft(Int32)](xref:System.String.PadLeft(System.Int32)) メソッドでは、空白文字が埋め込み文字として利用されます。[String.PadLeft(Int32, Char)](xref:System.String.PadLeft(System.Int32,System.Char)) メソッドでは、独自の埋め込み文字を指定できます。
-
-次のコード例では、[PadLeft(Int32, Char)](xref:System.String.PadLeft(System.Int32,System.Char)) メソッドを利用し、長さが&20; 文字の新しい文字列を作成します。 この例は、コンソールに "`--------Hello World!`" と出力します。
-
-```csharp
-string MyString = "Hello World!";
-Console.WriteLine(MyString.PadLeft(20, '-'));
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Console.WriteLine(MyString.PadLeft(20, "-"c))
-```
-
-## <a name="padright"></a>PadRight
-
-[String.PadRight](xref:System.String.PadRight(System.Int32)) メソッドでは、元の文字列の末尾に埋め込み文字をつなげ、合計を指定の長さにすることで新しい文字列を作成します。 [String.PadRight(Int32)](xref:System.String.PadRight(System.Int32)) メソッドでは、空白文字が埋め込み文字として利用されます。[String.PadRight(Int32, Char)](xref:System.String.PadRight(System.Int32,System.Char)) メソッドでは、独自の埋め込み文字を指定できます。
-
-次のコード例では、[PadRight(Int32, Char)](xref:System.String.PadRight(System.Int32,System.Char)) メソッドを利用し、長さが&20; 文字の新しい文字列を作成します。 この例は、コンソールに "`Hello World!--------`" と出力します。
-
-```csharp
-string MyString = "Hello World!";
-Console.WriteLine(MyString.PadRight(20, '-'));
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Console.WriteLine(MyString.PadRight(20, "-"c))
-```
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
-
+title: ".NET Framework における文字列の埋め込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "埋め込み (文字列の)"
+  - "PadLeft メソッド"
+  - "PadRight メソッド"
+  - "文字列 [.NET Framework], 埋め込み"
+  - "空白"
+ms.assetid: 84a9f142-3244-4c90-ba02-21af9bbaff71
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# .NET Framework における文字列の埋め込み
+次の <xref:System.String> メソッドのいずれかを使用すると、元の文字列の先頭または末尾に指定した合計長になるまで文字が埋め込まれた新しい文字列が作成されます。  埋め込む文字には空白または指定の文字のいずれかが使用され、結果的にそれらの文字は右寄せまたは左寄せで表示されます。  
+  
+|メソッド名|使用方法|  
+|-----------|----------|  
+|<xref:System.String.PadLeft%2A?displayProperty=fullName>|指定された合計長になるまで文字列の先頭に文字を埋めます。|  
+|<xref:System.String.PadRight%2A?displayProperty=fullName>|指定された合計長になるまで文字列の末尾に文字を埋めます。|  
+  
+## PadLeft  
+ <xref:System.String.PadLeft%2A?displayProperty=fullName> メソッドは、指定された合計長に達するように元の文字列に先頭の埋め込み文字を連結することで、新しい文字列を作成します。  <xref:System.String.PadLeft%28System.Int32%29?displayProperty=fullName> メソッドでは空白が埋め込み文字として使用され、<xref:System.String.PadLeft%28System.Int32%2CSystem.Char%29?displayProperty=fullName> メソッドでは独自の埋め込み文字を指定できます。  
+  
+ <xref:System.String.PadLeft%2A> メソッドを使用して全長が 20 文字の新しい文字列を作成する例を次に示します。  この例は、コンソールに `--------Hello World!` と出力します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/padding.cpp#3)]
+ [!code-csharp[Conceptual.String.BasicOps#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/padding.cs#3)]
+ [!code-vb[Conceptual.String.BasicOps#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/padding.vb#3)]  
+  
+## PadRight  
+ <xref:System.String.PadRight%2A?displayProperty=fullName> メソッドは、指定された合計長に達するように元の文字列に末尾の埋め込み文字を連結することで、新しい文字列を作成します。  <xref:System.String.PadRight%28System.Int32%29?displayProperty=fullName> メソッドでは空白が埋め込み文字として使用され、<xref:System.String.PadRight%28System.Int32%2CSystem.Char%29?displayProperty=fullName> メソッドでは独自の埋め込み文字を指定できます。  
+  
+ <xref:System.String.PadRight%2A> メソッドを使用して全長が 20 文字の新しい文字列を作成する例を次に示します。  この例は、コンソールに `Hello World!--------` と出力します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/padding.cpp#4)]
+ [!code-csharp[Conceptual.String.BasicOps#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/padding.cs#4)]
+ [!code-vb[Conceptual.String.BasicOps#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/padding.vb#4)]  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/parsing-datetime.md b/docs/standard/base-types/parsing-datetime.md
index 6886b6b73ba..b65013481db 100644
--- a/docs/standard/base-types/parsing-datetime.md
+++ b/docs/standard/base-types/parsing-datetime.md
@@ -1,193 +1,71 @@
 ---
-title: ".NET での日付と時刻文字列の解析"
-description: ".NET での日付と時刻文字列の解析"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/29/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: e61514cd-5329-4eb8-b122-482fffb54ab7
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: f0131baa0874880b6697458426da5ae9ce1705b7
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="parsing-date-and-time-strings-in-net"></a>.NET での日付と時刻文字列の解析
-
-解析メソッドは、日付と時刻の文字列形式を等価の [DateTime](xref:System.DateTime) オブジェクトに変換します。 [Parse](xref:System.DateTime.Parse(System.String)) と [TryParse](xref:System.DateTime.TryParse(System.String,System.DateTime@)) メソッドでは、日付と時刻のいくつかの共通表現のいずれかを変換します。 [ParseExact](xref:System.DateTime.ParseExact(System.String,System.String,System.IFormatProvider)) と [TryParseExact](xref:System.DateTime.TryParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.DateTimeStyles,System.DateTime@)) メソッドでは、日付と時刻の書式指定文字列で指定されたパターンに適合する文字列形式を変換します。 ([標準の日付と時刻の書式指定文字列](standard-datetime.md)と[カスタムの日付と時刻の書式指定文字列](custom-datetime.md)に関するトピックをご覧ください)。 
-
-解析は、日付と時刻の区切り記号、および月、日、および年号の名前に使用される文字列などの情報を提供する書式プロバイダーのプロパティの影響を受けます。 書式プロバイダーは、現在の [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトです。このオブジェクトは、現在のスレッド カルチャによって暗黙的に指定されるか、または解析するメソッドの [IFormatProvider](xref:System.IFormatProvider) パラメーターによって明示的に指定されます。 [IFormatProvider](xref:System.IFormatProvider) パラメーターには、カルチャ ([DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクト) を表す [CultureInfo](xref:System.Globalization.CultureInfo) オブジェクトを指定します。 
-
-解析される日付の文字列形式には、月と、少なくとも日付または年を含める必要があります。 時刻の文字列形式は、時間と、少なくとも分または AM/PM 指定子を含める必要があります。 ただし、可能な場合は、解析により省略されたコンポーネントに既定値が指定されます。 欠落している日付には現在の日付が規定で設定され、欠落している年には現在の年が規定で設定され、欠落している月の日付には月の最初の日が規定で設定され、欠落している時刻には午前&0; 時が規定で設定されます。 
-
-文字列形式で時刻のみを指定する場合、解析は、[Today](xref:System.DateTime.Today) プロパティの対応する値に、その [Year](xref:System.DateTime.Year)、[Month](xref:System.DateTime.Month)、および [Day](xref:System.DateTime.Day) プロパティを設定した [DateTime](xref:System.DateTime) オブジェクトを返します。 ただし、[DateTimeStyles.NoCurrentDateDefault](xref:System.Globalization.DateTimeStyles.NoCurrentDateDefault) 定数が解析メソッドで指定されている場合、結果の年、月、日付のプロパティの値は 1 に設定されます。
-
-日付と時刻のコンポーネントだけでなく、日付と時刻の文字列形式には、世界協定時刻 (UTC) と何時間異なるかを示すオフセットを含めることができます。 たとえば、文字列 "2/14/2007 5:32:00 -7:00" は、UTC より 7 時間早い時刻を定義します。 オフセットが時刻の文字列形式から省略される場合、解析では、その [Kind](xref:System.DateTime.Kind) プロパティに [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) を設定して、[DateTime](xref:System.DateTime) オブジェクトを返します。 オフセットが指定されている場合、解析では、その [Kind](xref:System.DateTime.Kind) プロパティに [Local](xref:System.DateTimeKind.Local) を設定した [DateTime](xref:System.DateTime) オブジェクトと、使用しているマシンのローカル タイム ゾーンに調整された値を返します。 解析メソッドで [DateTimeStyles](xref:System.Globalization.DateTimeStyles) 定数を使用して、この動作を変更できます。
-
-書式プロバイダーは、あいまいな数値の日付を解釈するためにも使用されます。 たとえば、文字列 "02/03/04" で示された日付は、どのコンポーネントが月、日、年であるのかが明確ではありません。 この場合、コンポーネントは、書式プロバイダーの日付形式と同様の順序で解釈されます。 
-
-## <a name="parse"></a>Parse
-
-次のコード例では、文字列を `DateTime` に変換するために、`Parse` メソッドを使用する方法を示します。 この例では、現在のスレッドに関連付けられているカルチャを使用して、解析が実行されます。 現在のカルチャに関連付けられている [CultureInfo](xref:System.Globalization.CultureInfo) で入力文字列を解析できない場合は、[FormatException](xref:System.FormatException) がスローされます。
-
-```csharp
-string MyString = "Jan 1, 2009";
-DateTime MyDateTime = DateTime.Parse(MyString);
-Console.WriteLine(MyDateTime);
-// Displays the following output on a system whose culture is en-US:
-//       1/1/2009 12:00:00 AM
-```
-
-```vb
-Dim MyString As String = "Jan 1, 2009"
-Dim MyDateTime As DateTime = DateTime.Parse(MyString)
-Console.WriteLine(MyDateTime)
-' Displays the following output on a system whose culture is en-US:
-'       1/1/2009 12:00:00 AM
-```
-
-また、そのオブジェクトで定義されているカルチャのいずれかに設定される `CultureInfo` を指定するか、または [CultureInfo.DateTimeFormat](xref:System.Globalization.CultureInfo.DateTimeFormat) プロパティによって返される標準の [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトのいずれかを指定することもできます。 次のコード例は、書式プロバイダーを使用して、ドイツ語の文字列を `DateTime` に解析します。 この特定の文字列を正常に解析できるように、de-DE カルチャを示す `CultureInfo` が定義され、解析されている文字列と共に渡されます。 これによって、`CurrentThread` の `CurrentCulture` がどのように設定されていても除外されます。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      CultureInfo MyCultureInfo = new CultureInfo("de-DE");
-      string MyString = "12 Juni 2008";
-      DateTime MyDateTime = DateTime.Parse(MyString, MyCultureInfo);
-      Console.WriteLine(MyDateTime);
-   }
-}
-// The example displays the following output:
-//       6/12/2008 12:00:00 AM
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim MyCultureInfo As CultureInfo = new CultureInfo("de-DE")
-      Dim MyString As String = "12 Juni 2008"
-      Dim MyDateTime As DateTime = DateTime.Parse(MyString, MyCultureInfo)
-      Console.WriteLine(MyDateTime)
-   End Sub
-End Module
-' The example displays the following output:
-'       6/12/2008 12:00:00 AM
-```
-
-ただし、[Parse](xref:System.DateTime.Parse(System.String)) メソッドのオーバーロードを使用して、カスタム書式プロバイダーを指定することができますが、このメソッドでは非標準の書式プロバイダーの使用をサポートしていません。 非標準の書式設定で示された日付と時刻を解析するには、代わりに [ParseExact](xref:System.DateTime.ParseExact(System.String,System.String,System.IFormatProvider)) メソッドを使用します。
-
-次のコード例では、[DateTimeStyles](xref:System.Globalization.DateTimeStyles) 列挙体を使用して、現在の日付と時刻の情報を、文字列で定義しないフィールドの `DateTime` に追加しないことを指定します。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      CultureInfo MyCultureInfo = new CultureInfo("de-DE");
-      string MyString = "12 Juni 2008";
-      DateTime MyDateTime = DateTime.Parse(MyString, MyCultureInfo, 
-                                           DateTimeStyles.NoCurrentDateDefault);
-      Console.WriteLine(MyDateTime);
-   }
-}
-// The example displays the following output if the current culture is en-US:
-//      6/12/2008 12:00:00 AM
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim MyCultureInfo As CultureInfo = new CultureInfo("de-DE")
-      Dim MyString As String = "12 Juni 2008"
-      Dim MyDateTime As DateTime = DateTime.Parse(MyString, MyCultureInfo)
-      Console.WriteLine(MyDateTime)
-   End Sub
-End Module
-' The example displays the following output:
-'       6/12/2008 12:00:00 AM
-```
-
-## <a name="parseexact"></a>ParseExact
-
-[DateTime.ParseExact]((xref:System.DateTime.ParseExact(System.String,System.String,System.IFormatProvider)) メソッドは、指定された文字列パターンに適合する文字列を `DateTime` オブジェクトに変換します。 指定された形式ではない文字列がこのメソッドに渡された場合、[FormatException](xref:System.FormatException) がスローされます。 標準の日付と時刻の書式指定子のいずれか、またはカスタムの日付と時刻の書式指定子の制限された組み合わせを指定することができます。 カスタムの書式指定子を使用すると、カスタムの認識文字列を構成することができます。 (指定子の詳細については、[標準の日付と時刻の書式指定文字列](standard-datetime.md)と[カスタムの日付と時刻の書式指定文字列](custom-datetime.md)に関するトピックをご覧ください)。 
-
-[ParseExact](xref:System.DateTime.ParseExact(System.String,System.String,System.IFormatProvider)) メソッドのオーバーロードごとに、通常は文字列の書式設定に関するカルチャ固有の情報を指定する [IFormatProvider](xref:System.IFormatProvider) パラメーターもあります。 通常、この [IFormatProvider](xref:System.IFormatProvider) オブジェクトは、標準カルチャを表す [CultureInfo](xref:System.Globalization.CultureInfo) オブジェクト、または [CultureInfo.DateTimeFormat](xref:System.Globalization.CultureInfo.DateTimeFormat) プロパティによって返される [DateTimeFormatInfo](xref:System.Globalization.DateTimeFormatInfo) オブジェクトです。 ただし、その他の日付と時刻の解析関数とは異なり、このメソッドでは、非標準の日付と時刻の書式を定義する [IFormatProvider](xref:System.IFormatProvider) もサポートしています。 
-
-次のコード例では、`ParseExact` メソッドに解析する文字列オブジェクト、書式指定子、`CultureInfo` オブジェクトが順に渡されます。 この `ParseExact` メソッドでは、en-US カルチャで長い形式の日付パターンを示す文字列のみを解析できます。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      CultureInfo MyCultureInfo = new CultureInfo("en-US");
-      string[] MyString = {" Friday, April 10, 2009", "Friday, April 10, 2009"};
-      foreach (string dateString in MyString)
-      {
-         try {
-            DateTime MyDateTime = DateTime.ParseExact(dateString, "D", MyCultureInfo);
-            Console.WriteLine(MyDateTime);
-         }
-         catch (FormatException) {
-            Console.WriteLine("Unable to parse '{0}'", dateString);
-         }
-      }
-   }
-}
-// The example displays the following output:
-//       Unable to parse ' Friday, April 10, 2009'
-//       4/10/2009 12:00:00 AM
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim MyCultureInfo As CultureInfo = new CultureInfo("en-US")
-      Dim MyString() As String = {" Friday, April 10, 2009", "Friday, April 10, 2009"}
-      For Each dateString As String In MyString
-         Try
-            Dim MyDateTime As DateTime = DateTime.ParseExact(dateString, "D", _
-                                                             MyCultureInfo)
-            Console.WriteLine(MyDateTime)
-         Catch e As FormatException
-            Console.WriteLine("Unable to parse '{0}'", dateString)
-         End Try
-      Next
-   End Sub
-End Module
-' The example displays the following output:
-'       Unable to parse ' Friday, April 10, 2009'
-'       4/10/2009 12:00:00 AM
-```
-
-## <a name="see-also"></a>関連項目
-
-[.NET での文字列の解析](parsing-strings.md)
-
-[.NET での型の書式設定](formatting-types.md)
-
-[.NET での型変換](type-conversion.md)
-
-
+title: ".NET Framework における日付と時刻文字列の解析の解析 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "基本型, 解析 (文字列を)"
+  - "日付と時刻文字列"
+  - "DateTime オブジェクト"
+  - "列挙型 [.NET Framework], 解析 (文字列を)"
+  - "ParseExact メソッド"
+  - "解析 (文字列を), 日付と時刻文字列"
+  - "時間の文字列"
+ms.assetid: 43bae51e-9b1d-41a6-a187-772c0d096d90
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# .NET Framework における日付と時刻文字列の解析の解析
+解析メソッドは、日付と時刻の文字列形式を、等価の <xref:System.DateTime> オブジェクトに変換します。  <xref:System.DateTime.Parse%2A> メソッドと <xref:System.DateTime.TryParse%2A> メソッドは、複数ある日付と時刻の共通形式をどれでも変換します。  <xref:System.DateTime.ParseExact%2A> メソッドと <xref:System.DateTime.TryParseExact%2A> メソッドは、日時書式指定文字列で指定されるパターンに準拠する文字列形式を変換します \([標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)および[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)に関するトピックを参照してください\)。  
+  
+ 解析は、日付と時刻の区切り記号に使用される文字列または月、日、年号の名前などの情報を提供する書式プロバイダーのプロパティに影響されます。  書式プロバイダーは、現在の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトであり、現在のスレッド カルチャによって暗黙的に指定されるか、または解析メソッドの <xref:System.IFormatProvider> パラメーターによって明示的に指定されます。  <xref:System.IFormatProvider> パラメーターには、カルチャを表す <xref:System.Globalization.CultureInfo> オブジェクト、または <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを指定します。  
+  
+ 解析される日付の文字列形式には、月と、日または年の少なくともどちらかが含まれている必要があります。  時刻の文字列形式には、時間と、分または AM\/PM 指定子の少なくともどちらかが含まれている必要があります。  ただし可能であれば、省略された構成要素に対して解析が既定値を使用します。  日付がない場合は現在の日付、年がない場合は現在の年、月の日付がない場合はその月の初日、時刻がない場合は午前 0 時が、それぞれ既定で設定されます。  
+  
+ 文字列形式が時刻のみを指定している場合は、解析が <xref:System.DateTime> オブジェクトの <xref:System.DateTime.Year%2A>、<xref:System.DateTime.Month%2A>、および <xref:System.DateTime.Day%2A> の各プロパティを <xref:System.DateTime.Today%2A> プロパティの対応する値に設定して、このオブジェクトを返します。  ただし、解析メソッドに <xref:System.Globalization.DateTimeStyles> 定数が指定された場合は、結果の年、月、および日の各プロパティが値 `1` に設定されます。  
+  
+ 日付と時刻の文字列形式には、日付と時刻の構成要素に加えて、世界協定時刻 \(UTC: Coordinated Universal Time\) との時間の差を示すオフセットを含めることができます。  たとえば、"2\/14\/2007 5:32:00 \-7:00" という文字列は、UTC より 7 時間早い時刻を定義します。  時刻の文字列形式でオフセットが省略されている場合、解析は <xref:System.DateTime> オブジェクトの <xref:System.DateTime.Kind%2A> プロパティを <xref:System.DateTimeKind?displayProperty=fullName> に設定して返します。  オフセットが指定されている場合、解析は <xref:System.DateTime> オブジェクトの <xref:System.DateTime.Kind%2A> プロパティを <xref:System.DateTimeKind> に設定し、値をコンピューターのローカル タイム ゾーンに調整して返します。  この動作は、解析メソッドに <xref:System.Globalization.DateTimeStyles> 定数を使用することで変更できます。  
+  
+ 書式プロバイダーは、あいまいな数値の日付を解釈する際にも使用されます。  たとえば、文字列 "02\/03\/04" で表された日付は、どの構成要素が月、日、年であるかが明確ではありません。  この場合は、書式プロバイダーの類似する日付形式の順序に従って構成要素が解釈されます。  
+  
+## Parse  
+ **Parse** メソッドを使用して文字列を **DateTime** に変換するコード例を次に示します。  この例では、現在のスレッドに関連付けられているカルチャを使用して解析が実行されます。  現在のカルチャに関連付けられている <xref:System.Globalization.CultureInfo> で入力文字列を解析できない場合は、<xref:System.FormatException> がスローされます。  
+  
+ [!code-csharp[Parsing.DateAndTime#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Parsing.DateAndTime/cs/Example.cs#1)]
+ [!code-vb[Parsing.DateAndTime#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Parsing.DateAndTime/vb/Example.vb#1)]  
+  
+ カルチャの 1 つを定義するように **CultureInfo** を設定して、そのオブジェクトを指定するか、<xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティによって返される標準の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの 1 つを指定することもできます。  書式プロバイダーを使用してドイツ語文字列を **DateTime** に変換するコード例を次に示します。  この文字列を正しく解析するには、de\-DE \(ドイツのドイツ語\) カルチャを表す **CultureInfo** を定義し、解析する文字列と共に渡します。  これにより、**CurrentThread** の **CurrentCulture** の設定が無視されます。  
+  
+ [!code-csharp[Parsing.DateAndTime#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Parsing.DateAndTime/cs/Example2.cs#2)]
+ [!code-vb[Parsing.DateAndTime#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Parsing.DateAndTime/vb/Example2.vb#2)]  
+  
+ ただし、<xref:System.DateTime.Parse%2A> メソッドのオーバーロードを使用するとカスタム書式プロバイダーを指定できますが、このメソッド自体は標準以外の書式プロバイダーの使用をサポートしていません。  標準以外の形式で表された日付と時刻を解析するには、代わりに <xref:System.DateTime.ParseExact%2A> メソッドを使用します。  
+  
+ <xref:System.Globalization.DateTimeStyles> 列挙体を使用して、文字列で定義されていないフィールドについて、現在の日付と時刻の情報を **DateTime** に追加しないように指定するコード例を次に示します。  
+  
+ [!code-csharp[Parsing.DateAndTime#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Parsing.DateAndTime/cs/Example3.cs#3)]
+ [!code-vb[Parsing.DateAndTime#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Parsing.DateAndTime/vb/Example3.vb#3)]  
+  
+## ParseExact  
+ <xref:System.DateTime.ParseExact%2A?displayProperty=fullName> メソッドは、指定した文字列パターンに準拠する文字列を **DateTime** オブジェクトに変換します。  指定された書式に従っていない文字列をこのメソッドに渡すと、<xref:System.FormatException> がスローされます。  標準の日付と時刻書式指定子のいずれかを指定するか、またはカスタムの日付と時刻書式指定子の限定された組み合わせを指定できます。  カスタムの書式指定子を使用すると、カスタムの認識文字列を生成できます。  指定子の説明については、[標準の日時書式指定文字列](../../../docs/standard/base-types/standard-date-and-time-format-strings.md)および[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)に関するトピックを参照してください。  
+  
+ <xref:System.DateTime.ParseExact%2A> メソッドの各オーバーロードは、<xref:System.IFormatProvider> パラメーターも受け取ります。このパラメーターは、通常、文字列の書式に関するカルチャ固有の情報を指定します。  多くの場合、この <xref:System.IFormatProvider> オブジェクトは、標準のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトか、または <xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo> オブジェクトです。  ただし、日付と時刻を解析する他の関数とは異なり、このメソッドは標準以外の日付と時刻の形式を定義する <xref:System.IFormatProvider> もサポートします。  
+  
+ 次のコード例では、解析する文字列オブジェクト、書式指定子、および **CultureInfo** オブジェクトを **ParseExact** メソッドに渡しています。  この **ParseExact** メソッドは、en\-US カルチャの Long Date パターンを表す文字列だけを解析できます。  
+  
+ [!code-csharp[Parsing.DateAndTime#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Parsing.DateAndTime/cs/Example4.cs#4)]
+ [!code-vb[Parsing.DateAndTime#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Parsing.DateAndTime/vb/Example4.vb#4)]  
+  
+## 参照  
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/parsing-numeric.md b/docs/standard/base-types/parsing-numeric.md
index 6f47e2a6c9e..a676defffea 100644
--- a/docs/standard/base-types/parsing-numeric.md
+++ b/docs/standard/base-types/parsing-numeric.md
@@ -1,329 +1,90 @@
 ---
-title: ".NET での数値文字列の解析"
-description: ".NET での数値文字列の解析"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/29/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: e393430a-731a-49fa-83de-ff7ed52d5704
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 85cd57d33b03f7a2105ee3f770b2f8bcc0a57ee4
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="parsing-numeric-strings-in-net"></a>.NET での数値文字列の解析
-
-すべての数値型には、2 つの静的解析メソッド (`Parse` と `TryParse`) があり、数字の文字列形式を数値型に変換するために使用できます。 これらのメソッドでは、[標準の数値書式指定文字列](standard-numeric.md)と[カスタム数値書式指定文字列](custom-numeric.md)で記述されている書式指定文字列を使用して、生成された文字列を解析できます。 既定では、`Parse` と `TryParse` メソッドは、10 進数の整数を含む文字列を整数値のみに正常に変換することができます。 これらのメソッドは、整数部と小数部、グループ区切り、および小数点記号を含む文字列を浮動小数点値に正常に変換できます。 `TryParse` メソッドが `false` を返すのに対して、`Parse` メソッドは操作が失敗した場合に例外をスローします。
-
-## <a name="parsing-and-format-providers"></a>解析と書式プロバイダー
-
-通常、数値の文字列形式はカルチャによって異なります。 通貨記号、グループ (または千単位) 区切り、および小数点記号などの数値文字列の要素は、カルチャによって大きく異なります。 暗黙的または明示的のいずれかの解析メソッドでは、これらのカルチャ固有のバリエーションを認識する書式プロバイダーを使用します。 書式プロバイダーが `Parse` または `TryParse` メソッドの呼び出しで指定されない場合、現在のスレッド カルチャ ([NumberFormatInfo.CurrentInfo](xref:System.Globalization.NumberFormatInfo.CurrentInfo) プロパティで返された [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクト) と関連付けられた書式プロバイダーが使用されます。 
-
-書式プロバイダーは、[IFormatProvider](xref:System.Globalization.NumberFormatInfo.CurrentInfo) 実装によって示されます。 このインターフェイスには、1 つのメンバー ([GetFormat](xref:System.IFormatProvider.GetFormat(System.Type)) メソッド) があり、その&1; つのパラメーターは、書式設定される型を示す [Type](xref:System.Type) オブジェクトです。 このメソッドは、書式情報を示すオブジェクトを返します。 .NET では、数値文字列を解析するために、次の&2; つの [IFormatProvider](xref:System.Globalization.NumberFormatInfo.CurrentInfo) の実装をサポートします。
-
-* [CultureInfo.GetFormat](xref:System.Globalization.CultureInfo.GetFormat(System.Type)) メソッドが、カルチャ固有の書式情報を提供する [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトを返す、[CultureInfo](xref:System.Globalization.CultureInfo) オブジェクト。
-
-* [NumberFormatInfo.GetFormat](xref:System.Globalization.NumberFormatInfo.GetFormat(System.Type)) メソッドがそれ自体を返す、[NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクト。
-
-次の例では、配列内の各文字列を [Double](xref:System.Double) 値に変換しようとします。 最初に、英語 (米国) カルチャの規則を反映する書式プロバイダーを使用して、文字列を解析しようとします。 この操作が [FormatException](xref:System.FormatException) をスローする場合、フランス語 (フランス) カルチャの規則を反映する書式プロバイダーを使用して、文字列を解析しようとしています。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      string[] values = { "1,304.16", "$1,456.78", "1,094", "152", 
-                          "123,45 €", "1 304,16", "Ae9f" };
-      double number;
-      CultureInfo culture = null;
-
-      foreach (string value in values) {
-         try {
-            culture = CultureInfo.CreateSpecificCulture("en-US");
-            number = Double.Parse(value, culture);
-            Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number);
-         }   
-         catch (FormatException) {
-            Console.WriteLine("{0}: Unable to parse '{1}'.", 
-                              culture.Name, value);
-            culture = CultureInfo.CreateSpecificCulture("fr-FR");
-            try {
-               number = Double.Parse(value, culture);
-               Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number);
-            }
-            catch (FormatException) {
-               Console.WriteLine("{0}: Unable to parse '{1}'.", 
-                                 culture.Name, value);
-            }
-         }
-         Console.WriteLine();
-      }   
-   }
-}
-// The example displays the following output:
-//    en-US: 1,304.16 --> 1304.16
-//    
-//    en-US: Unable to parse '$1,456.78'.
-//    fr-FR: Unable to parse '$1,456.78'.
-//    
-//    en-US: 1,094 --> 1094
-//    
-//    en-US: 152 --> 152
-//    
-//    en-US: Unable to parse '123,45 €'.
-//    fr-FR: Unable to parse '123,45 €'.
-//    
-//    en-US: Unable to parse '1 304,16'.
-//    fr-FR: 1 304,16 --> 1304.16
-//    
-//    en-US: Unable to parse 'Ae9f'.
-//    fr-FR: Unable to parse 'Ae9f'.
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim values() As String = { "1,304.16", "$1,456.78", "1,094", "152", 
-                                 "123,45 €", "1 304,16", "Ae9f" }
-      Dim number As Double
-      Dim culture As CultureInfo = Nothing
-
-      For Each value As String In values
-         Try
-            culture = CultureInfo.CreateSpecificCulture("en-US")
-            number = Double.Parse(value, culture)
-            Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number)
-         Catch e As FormatException
-            Console.WriteLine("{0}: Unable to parse '{1}'.", 
-                              culture.Name, value)
-            culture = CultureInfo.CreateSpecificCulture("fr-FR")
-            Try
-               number = Double.Parse(value, culture)
-               Console.WriteLine("{0}: {1} --> {2}", culture.Name, value, number)
-            Catch ex As FormatException
-               Console.WriteLine("{0}: Unable to parse '{1}'.", 
-                                 culture.Name, value)
-            End Try
-         End Try
-         Console.WriteLine()
-      Next
-   End Sub
-End Module
-' The example displays the following output:
-'    en-US: 1,304.16 --> 1304.16
-'    
-'    en-US: Unable to parse '$1,456.78'.
-'    fr-FR: Unable to parse '$1,456.78'.
-'    
-'    en-US: 1,094 --> 1094
-'    
-'    en-US: 152 --> 152
-'    
-'    en-US: Unable to parse '123,45 €'.
-'    fr-FR: Unable to parse '123,45 €'.
-'    
-'    en-US: Unable to parse '1 304,16'.
-'    fr-FR: 1 304,16 --> 1304.16
-'    
-'    en-US: Unable to parse 'Ae9f'.
-'    fr-FR: Unable to parse 'Ae9f'.
-```
-
-## <a name="parsing-and-numberstyles-values"></a>解析と NumberStyles 値
-
-解析操作が処理できるスタイル要素 (空白文字、グループ区切り、小数点の記号など) は、[NumberStyles](xref:System.Globalization.NumberStyles) 列挙値によって定義されます。 既定では、整数値を表す文字列は、[NumberStyles.Integer](xref:System.Globalization.NumberStyles.Integer) 値を使用して解析されます。これは、数値、先頭と末尾の空白、および先頭の符号のみを許可します。 浮動小数点値を表す文字列は、[NumberStyles.Float](xref:System.Globalization.NumberStyles.Float) と [NumberStyles.AllowThousands](xref:System.Globalization.NumberStyles.AllowThousands) 値の組み合わせを使用して解析されます。この複合スタイルは、先頭と末尾の空白、先頭の符号、小数点記号、グループ区切り、および指数と共に&10; 進数を許可します。 [NumberStyles](xref:System.Globalization.NumberStyles) 型のパラメーターを含む、`Parse` または `TryParse` メソッドのオーバーロードを呼び出し、1 つ以上の [NumberStyles](xref:System.Globalization.NumberStyles) フラグを設定すると、解析操作が成功するように、文字列で示すことができるスタイル要素を制御することができます。 
-
-たとえば、グループ区切りを含む文字列は、[Int32.Parse(String)](xref:System.Int32.Parse(System.String)) メソッドを使用して、[Int32](xref:System.Int32) 値に変換することはできません。 ただし、次の例に示すように、[NumberStyles.AllowThousands](xref:System.Globalization.NumberStyles.AllowThousands) フラグを使用した場合、この変換は成功します。
-
-```csharp
-using System;
-using System.Globalization;
-
-public class Example
-{
-   public static void Main()
-   {
-      string value = "1,304";
-      int number;
-      IFormatProvider provider = CultureInfo.CreateSpecificCulture("en-US");
-      if (Int32.TryParse(value, out number))
-         Console.WriteLine("{0} --> {1}", value, number);
-      else
-         Console.WriteLine("Unable to convert '{0}'", value);
-
-      if (Int32.TryParse(value, NumberStyles.Integer | NumberStyles.AllowThousands, 
-                        provider, out number))
-         Console.WriteLine("{0} --> {1}", value, number);
-      else
-         Console.WriteLine("Unable to convert '{0}'", value);
-   }
-}
-// The example displays the following output:
-//       Unable to convert '1,304'
-//       1,304 --> 1304
-```
-
-```vb
-Imports System.Globalization
-
-Module Example
-   Public Sub Main()
-      Dim value As String = "1,304"
-      Dim number As Integer
-      Dim provider As IFormatProvider = CultureInfo.CreateSpecificCulture("en-US")
-      If Int32.TryParse(value, number) Then
-         Console.WriteLine("{0} --> {1}", value, number)
-      Else
-         Console.WriteLine("Unable to convert '{0}'", value)
-      End If
-
-      If Int32.TryParse(value, NumberStyles.Integer Or NumberStyles.AllowThousands, 
-                        provider, number) Then
-         Console.WriteLine("{0} --> {1}", value, number)
-      Else
-         Console.WriteLine("Unable to convert '{0}'", value)
-      End If
-   End Sub
-End Module
-' The example displays the following output:
-'       Unable to convert '1,304'
-'       1,304 --> 1304
-```
-
-> **警告**
->
-> 解析操作は、常に特定のカルチャの書式規則を使用します。 [CultureInfo](xref:System.Globalization.CultureInfo) または [NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトを渡してカルチャを指定しない場合、現在のスレッドに関連付けられているカルチャが使用されます。
- 
-次の表では、[NumberStyles](xref:System.Globalization.NumberStyles) 列挙体のメンバーを一覧し、そのメンバーが解析操作に与える影響について説明します。
-
-NumberStyles 値 | 解析する文字列への影響
------------------- | --------------------------------- 
-[NumberStyles.None](xref:System.Globalization.NumberStyles.None) | 数字のみが許可されます。
-[NumberStyles.AllowDecimalPoint](xref:System.Globalization.NumberStyles.AllowDecimalPoint) | 小数点の記号と桁数が許可されます。 整数値の場合、0 のみが小数点の桁数として許可されます。 有効な小数点記号は、[NumberFormatInfo.NumberDecimalSeparator](xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator) または [NumberFormatInfo.CurrencyDecimalSeparator](xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator) プロパティによって決定されます。
-[NumberStyles.AllowExponent](xref:System.Globalization.NumberStyles.AllowExponent) | "e" または "E" の文字は、指数表記を示すために使用できます。
-[NumberStyles.AllowLeadingWhite](xref:System.Globalization.NumberStyles.AllowLeadingWhite) | 先頭の空白が許可されます。
-[NumberStyles.AllowTrailingWhite](xref:System.Globalization.NumberStyles.AllowTrailingWhite) | 末尾の空白が許可されます。
-[NumberStyles.AllowLeadingSign](xref:System.Globalization.NumberStyles.AllowLeadingSign) | 正または負の符号には、数字の先頭に追加できます。
-[NumberStyles.AllowTrailingSign](xref:System.Globalization.NumberStyles.AllowTrailingSign) | 正または負の符号は、数字の後に続けることができます。
-[NumberStyles.AllowParentheses](xref:System.Globalization.NumberStyles.AllowParentheses) | かっこは、負の符号を示すために使用できます。
-[NumberStyles.AllowThousands](xref:System.Globalization.NumberStyles.AllowThousands) | グループ区切りが許可されます。 グループ区切りは、[NumberFormatInfo.NumberGroupSeparator](xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator) または [NumberFormatInfo.CurrencyGroupSeparator](xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator) プロパティによって決定されます。
-[NumberStyles.AllowCurrencySymbol](xref:System.Globalization.NumberStyles.AllowCurrencySymbol) | 通貨記号が許可されます。 通貨記号は、[NumberFormatInfo.CurrencySymbol](xref:System.Globalization.NumberFormatInfo.CurrencySymbol) プロパティによって定義されます。
-[NumberStyles.AllowHexSpecifier](xref:System.Globalization.NumberStyles.AllowHexSpecifier) | 解析する文字列は、16 進数として解釈されます。 これには、16 進数の値の 0 ～ 9、A ～ F、a ～ f を含めることができます。 このフラグは、整数値を解析するためにだけに使用できます。
- 
-さらに、[NumberStyles](xref:System.Globalization.NumberStyles) 列挙体は、複数の [NumberStyles](xref:System.Globalization.NumberStyles) フラグを含む、次の複合スタイルを指定します。 
-
-複合 NumberStyles 値 | 数値を含む
----------------------------- | ---------------- 
-[NumberStyles.Integer](xref:System.Globalization.NumberStyles.Integer) | [NumberStyles.AllowLeadingWhite](xref:System.Globalization.NumberStyles.AllowLeadingWhite)、[NumberStyles.AllowTrailingWhite](xref:System.Globalization.NumberStyles.AllowTrailingWhite)、および [NumberStyles.AllowLeadingSign](xref:System.Globalization.NumberStyles.AllowLeadingSign) のスタイルを含みます。 これは、整数値を解析するために使用される既定のスタイルです。
-[NumberStyles.Number](xref:System.Globalization.NumberStyles.Number) | [NumberStyles.AllowLeadingWhite](xref:System.Globalization.NumberStyles.AllowLeadingWhite)、[NumberStyles.AllowTrailingWhite](xref:System.Globalization.NumberStyles.AllowTrailingWhite)、[NumberStyles.AllowLeadingSign](xref:System.Globalization.NumberStyles.AllowLeadingSign)、[NumberStyles.AllowTrailingSign](xref:System.Globalization.NumberStyles.AllowTrailingSign)、[NumberStyles.AllowDecimalPoint](xref:System.Globalization.NumberStyles.AllowDecimalPoint)、および [NumberStyles.AllowThousands](xref:System.Globalization.NumberStyles.AllowThousands) のスタイルを含みます。
-[NumberStyles.Float](xref:System.Globalization.NumberStyles.Float) | [NumberStyles.AllowLeadingWhite](xref:System.Globalization.NumberStyles.AllowLeadingWhite)、[NumberStyles.AllowTrailingWhite](xref:System.Globalization.NumberStyles.AllowTrailingWhite)、[NumberStyles.AllowLeadingSign](xref:System.Globalization.NumberStyles.AllowLeadingSign)、[NumberStyles.AllowDecimalPoint](xref:System.Globalization.NumberStyles.AllowDecimalPoint)、および [NumberStyles.AllowExponent](xref:System.Globalization.NumberStyles.AllowExponent) のスタイルを含みます。
-[NumberStyles.Currency](xref:System.Globalization.NumberStyles.Currency) | [NumberStyles.AllowExponent](xref:System.Globalization.NumberStyles.AllowExponent) および [NumberStyles.AllowHexSpecifier](xref:System.Globalization.NumberStyles.AllowHexSpecifier) を除く、すべてのスタイルを含みます。
-[NumberStyles.Any](xref:System.Globalization.NumberStyles.Any) | [NumberStyles.AllowHexSpecifier](xref:System.Globalization.NumberStyles.AllowHexSpecifier) を除く、すべてのスタイルを含みます。
-[NumberStyles.HexNumber](xref:System.Globalization.NumberStyles.HexNumber) | [NumberStyles.AllowLeadingWhite](xref:System.Globalization.NumberStyles.AllowLeadingWhite)、[NumberStyles.AllowTrailingWhite](xref:System.Globalization.NumberStyles.AllowTrailingWhite)、および [NumberStyles.AllowHexSpecifier](xref:System.Globalization.NumberStyles.AllowHexSpecifier) のスタイルを含みます。
- 
-## <a name="parsing-and-unicode-digits"></a>解析と Unicode 数字
-
-Unicode 標準では、さまざまな書記体系で数字のコード ポイントを定義します。 たとえば、U+0030 ～ U+0039 のコード ポイントは、0 ～ 9 の基本ラテンの数字を示し、U+09E6 ～ U+09EF のコード ポイントは、0 ～ 9 の数字のバングラ語の数字を示し、U+FF10 ～ U+FF19 のコード ポイントは、0 ～ 9 の全角の数字を示します。 ただし、解析メソッドで認識される数字は、U+0030 ～ U+0039 のコード ポイントの基本ラテンの数字 0 ～ 9 のみです。 数値解析メソッドがその他の数字を含む文字列を渡す場合、メソッドは [FormatException](xref:System.FormatException) をスローします。
-
-次の例では、[Int32.Parse](xref:System.Int32.Parse(System.String)) メソッドを使用して、異なる書記体系の数字で構成される文字列を解析します。 例の出力に示されているように、基本ラテンの数字を解析する試行は成功しますが、全角、アラビア インド、バングラ語の数字を解析する試行は失敗します。
-
-```csharp
-using System;
-
-public class Example
-{
-   public static void Main()
-   {
-      string value;
-      // Define a string of basic Latin digits 1-5.
-      value = "\u0031\u0032\u0033\u0034\u0035";
-      ParseDigits(value);
-
-      // Define a string of Fullwidth digits 1-5.
-      value = "\uFF11\uFF12\uFF13\uFF14\uFF15";
-      ParseDigits(value);
-
-      // Define a string of Arabic-Indic digits 1-5.
-      value = "\u0661\u0662\u0663\u0664\u0665";
-      ParseDigits(value);
-
-      // Define a string of Bangla digits 1-5.
-      value = "\u09e7\u09e8\u09e9\u09ea\u09eb";
-      ParseDigits(value);
-   }
-
-   static void ParseDigits(string value)
-   {
-      try {
-         int number = Int32.Parse(value);
-         Console.WriteLine("'{0}' --> {1}", value, number);
-      }   
-      catch (FormatException) {
-         Console.WriteLine("Unable to parse '{0}'.", value);      
-      }     
-   }
-}
-// The example displays the following output:
-//       '12345' --> 12345
-//       Unable to parse '１２３４５'.
-//       Unable to parse '١٢٣٤٥'.
-//       Unable to parse '১২৩৪৫'.
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      Dim value As String
-      ' Define a string of basic Latin digits 1-5.
-      value = ChrW(&h31) + ChrW(&h32) + ChrW(&h33) + ChrW(&h34) + ChrW(&h35)
-      ParseDigits(value)
-
-      ' Define a string of Fullwidth digits 1-5.
-      value = ChrW(&hff11) + ChrW(&hff12) + ChrW(&hff13) + ChrW(&hff14) + ChrW(&hff15)
-      ParseDigits(value)
-
-      ' Define a string of Arabic-Indic digits 1-5.
-      value = ChrW(&h661) + ChrW(&h662) + ChrW(&h663) + ChrW(&h664) + ChrW(&h665)
-      ParseDigits(value)
-
-      ' Define a string of Bangla digits 1-5.
-      value = ChrW(&h09e7) + ChrW(&h09e8) + ChrW(&h09e9) + ChrW(&h09ea) + ChrW(&h09eb)
-      ParseDigits(value)
-   End Sub
-
-   Sub ParseDigits(value As String)
-      Try
-         Dim number As Integer = Int32.Parse(value)
-         Console.WriteLine("'{0}' --> {1}", value, number)
-      Catch e As FormatException
-         Console.WriteLine("Unable to parse '{0}'.", value)      
-      End Try     
-   End Sub
-End Module
-' The example displays the following output:
-'       '12345' --> 12345
-'       Unable to parse '１２３４５'.
-'       Unable to parse '١٢٣٤٥'.
-'       Unable to parse '১২৩৪৫'.
-```
-
-## <a name="see-also"></a>関連項目
-
-[System.Globalization.NumberStyles](xref:System.Globalization.NumberStyles)
-
-[.NET での文字列の解析](parsing-strings.md)
-
-[.NET での型の書式設定](formatting-types.md)
-
-
+title: ".NET Framework における数値文字列の解析 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "解析 (文字列を)、数値文字列"
+  - "数値文字列"
+  - "列挙体 [.NET Framework]、解析 (文字列を)"
+  - "基本型、解析 (文字列を)"
+ms.assetid: e39324ee-72e5-42d4-a80d-bf3ee7fc6c59
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# .NET Framework における数値文字列の解析
+すべての数値型には、その数値の文字列形式を数値型に変換するための静的な解析メソッドとして、`Parse` および `TryParse` という 2 つのメソッドがあります。  これらのメソッドを使用すると、「[標準の数値書式指定文字列](../../../docs/standard/base-types/standard-numeric-format-strings.md)」および「[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)」で説明する書式指定文字列を使用して作成した文字列を解析できます。  `Parse` メソッドと `TryParse` メソッドは、既定で、整数部のみを含む文字列を整数値に正しく変換できます。  また、整数部と小数部、桁区切り記号、および小数点記号を含む文字列を浮動小数点値に正しく変換できます。  操作が失敗すると、`Parse` メソッドからは例外がスローされ、`TryParse` メソッドからは `false` が返されます。  
+  
+## 解析と書式プロバイダー  
+ 通常、数値の文字列形式はカルチャごとに異なります。  通貨記号、桁区切り記号、および小数点記号すべてなどの数値文字列の要素はカルチャによって異なります。  解析メソッドは、明示的または暗黙的に、それらのカルチャによる違いを認識する書式プロバイダーを使用します。  `Parse` メソッドまたは `TryParse` メソッドの呼び出しで書式プロバイダーが指定されていない場合は、現在のスレッドのカルチャ \(<xref:System.Globalization.NumberFormatInfo.CurrentInfo%2A?displayProperty=fullName> プロパティによって返される <xref:System.Globalization.NumberFormatInfo> オブジェクト\) に関連付けられている書式プロバイダーが使用されます。  
+  
+ 書式プロバイダーは <xref:System.IFormatProvider> の実装で表されます。  このインターフェイスには、<xref:System.IFormatProvider.GetFormat%2A> メソッドという単一のメンバーがあります。このメソッドの単一のパラメーターは、書式を指定する型を表す <xref:System.Type> オブジェクトです。  このメソッドが、書式情報を提供するオブジェクトを返します。  .NET Framework では、数値文字列を解析するために、次の 2 つの <xref:System.IFormatProvider> の実装がサポートされています。  
+  
+-   <xref:System.Globalization.CultureInfo> オブジェクト。このオブジェクトの <xref:System.Globalization.CultureInfo.GetFormat%2A?displayProperty=fullName> メソッドは、カルチャ固有の書式情報を提供する <xref:System.Globalization.NumberFormatInfo> オブジェクトを返します。  
+  
+-   <xref:System.Globalization.NumberFormatInfo> オブジェクト。このオブジェクトの <xref:System.Globalization.NumberFormatInfo.GetFormat%2A?displayProperty=fullName> メソッドは、このオブジェクト自体を返します。  
+  
+ 次の例では、配列の各文字列を <xref:System.Double> 値に変換しようとしています。  まず、英語 \(米国\) カルチャの規則を反映する書式プロバイダーを使用して文字列の解析を試みます。  この操作で <xref:System.FormatException> がスローされると、フランス語 \(フランス\) カルチャの規則を反映する書式プロバイダーを使用して文字列の解析を試みます。  
+  
+ [!code-csharp[Parsing.Numbers#1](../../../samples/snippets/csharp/VS_Snippets_CLR/parsing.numbers/cs/formatproviders1.cs#1)]
+ [!code-vb[Parsing.Numbers#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/parsing.numbers/vb/formatproviders1.vb#1)]  
+  
+## 解析と NumberStyles の値  
+ 解析操作で処理できるスタイル要素 \(空白文字、桁区切り記号、小数点記号など\) は、<xref:System.Globalization.NumberStyles> 列挙値で定義されます。  既定では、整数値を表す文字列は、<xref:System.Globalization.NumberStyles?displayProperty=fullName> 値を使用して解析されます。このスタイルでは、数字、先頭と末尾の空白文字、および先頭の符号だけを使用できます。  浮動小数点値を表す文字列は、<xref:System.Globalization.NumberStyles?displayProperty=fullName> 値と <xref:System.Globalization.NumberStyles?displayProperty=fullName> 値の組み合わせで解析されます。この複合スタイルでは、10 進数の数字に加え、先頭と末尾の空白文字、先頭の符号、小数点記号、桁区切り記号、および指数を使用できます。  <xref:System.Globalization.NumberStyles> 型のパラメーターを含む `Parse` メソッドまたは `TryParse` メソッドのオーバーロードを呼び出し、<xref:System.Globalization.NumberStyles> フラグを 1 つ以上設定することで、解析操作を成功させるために文字列で使用できるスタイル要素を制御することができます。  
+  
+ たとえば、桁区切り記号を含む文字列を <xref:System.Int32> 値に <xref:System.Int32.Parse%28System.String%29?displayProperty=fullName> のメソッドを使用して変換できません。  ただし、次の例に示すよう <xref:System.Globalization.NumberStyles?displayProperty=fullName> フラグを使用すると、呼び出しが成功します。  
+  
+ [!code-csharp[Parsing.Numbers#2](../../../samples/snippets/csharp/VS_Snippets_CLR/parsing.numbers/cs/styles1.cs#2)]
+ [!code-vb[Parsing.Numbers#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/parsing.numbers/vb/styles1.vb#2)]  
+  
+> [!WARNING]
+>  解析操作では、常に特定のカルチャの書式指定規則が使用されます。  <xref:System.Globalization.CultureInfo> オブジェクトまたは <xref:System.Globalization.NumberFormatInfo> オブジェクトを渡すことによってカルチャを指定していない場合は、現在のスレッドに関連付けられているカルチャが使用されます。  
+  
+ 次の表に、<xref:System.Globalization.NumberStyles> 列挙体のメンバーと、それらによる解析操作への影響を示します。  
+  
+|NumberStyles の値|解析対象の文字列に対する影響|  
+|---------------------|--------------------|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|数字だけを使用できます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|小数点記号と小数を使用できます。  整数値については、小数部の数値として 0 だけを使用できます。  有効な小数点記号は、<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A?displayProperty=fullName> プロパティまたは <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A?displayProperty=fullName> プロパティによって決まります。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|"e" または "E" という文字を使用して指数表記を示すことができます。  詳細については、「<xref:System.Globalization.NumberStyles>」を参照してください。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|先頭の空白文字を使用できます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|末尾の空白文字を使用できます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|数字の前に正または負の符号を使用できます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|数字の後に正または負の符号を使用できます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|かっこを使用して負の値を示すことができます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|桁区切り記号を使用できます。  桁区切り記号文字は、<xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator%2A?displayProperty=fullName> プロパティまたは <xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator%2A?displayProperty=fullName> プロパティによって決まります。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|通貨記号を使用できます。  通貨記号は <xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A?displayProperty=fullName> プロパティで定義されます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|解析対象の文字列が 16 進数と解釈されます。  16 進数の数字を表す 0 ～ 9、A ～ F、および a ～ f を使用できます。  このフラグは、整数値の解析でのみ使用できます。|  
+  
+ さらに、<xref:System.Globalization.NumberStyles> 列挙体には、複数の <xref:System.Globalization.NumberStyles> フラグで構成される次の複合スタイルも用意されています。  
+  
+|NumberStyles の複合値|含まれるメンバー|  
+|-----------------------|--------------|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、および <xref:System.Globalization.NumberStyles?displayProperty=fullName> の各スタイルが含まれます。  整数値の解析には、既定ではこのスタイルが使用されます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、および <xref:System.Globalization.NumberStyles?displayProperty=fullName> の各スタイルが含まれます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、および <xref:System.Globalization.NumberStyles?displayProperty=fullName> の各スタイルが含まれます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName> と <xref:System.Globalization.NumberStyles?displayProperty=fullName> を除くすべてのスタイルが含まれます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName> を除くすべてのスタイルが含まれます。|  
+|<xref:System.Globalization.NumberStyles?displayProperty=fullName>|<xref:System.Globalization.NumberStyles?displayProperty=fullName>、<xref:System.Globalization.NumberStyles?displayProperty=fullName>、および <xref:System.Globalization.NumberStyles?displayProperty=fullName> の各スタイルが含まれます。|  
+  
+## 解析と Unicode の数字  
+ Unicode 規格では、さまざまな書記体系での数字に対応するコード ポイントが定義されています。  たとえば、U\+0030 ~ U\+0039 のコード ポイントは基本ラテン数字の 0 ~ 9 を表し、U\+09E6 ~ U\+09EF のコード ポイントは Bangla の数字 0 ~ 9 を表し、U\+FF10 から U\+FF19 のコード ポイントはフル幅の数字 0 ~ 9.を表します。  ただし、解析メソッドで認識される数字は、コード ポイントが U\+0030 ～ U\+0039 の基本ラテン数字の 0 ～ 9 だけです。  それ以外の数字を含む文字列を数値解析メソッドに渡した場合、メソッドから <xref:System.FormatException> がスローされます。  
+  
+ <xref:System.Int32.Parse%2A?displayProperty=fullName> メソッドを使用して、複数の書記体系の数字で構成された文字列を解析する例を次に示します。  この例の出力結果が示すように、基本ラテン数字の解析は成功しますが、フル幅、アラブインド言語と Bangla 数字の解析は失敗します。  
+  
+ [!code-csharp[Parsing.Numbers#3](../../../samples/snippets/csharp/VS_Snippets_CLR/parsing.numbers/cs/unicode1.cs#3)]
+ [!code-vb[Parsing.Numbers#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/parsing.numbers/vb/unicode1.vb#3)]  
+  
+## 参照  
+ <xref:System.Globalization.NumberStyles>   
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/parsing-other.md b/docs/standard/base-types/parsing-other.md
index 9d0224ef3b8..b0dcc9488cc 100644
--- a/docs/standard/base-types/parsing-other.md
+++ b/docs/standard/base-types/parsing-other.md
@@ -1,86 +1,56 @@
 ---
-title: ".NET でのその他の文字列の解析"
-description: ".NET でのその他の文字列の解析"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/29/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 67670b10-3df4-45ea-8908-5ba3f056887c
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: db80cc5f37e814f224ff76b14a906bb4d41064fb
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="parsing-other-strings-in-net"></a>.NET でのその他の文字列の解析
-
-数値および [DateTime](xref:System.DateTime) 文字列だけでなく、[Char](xref:System.Char)、[Boolean](xref:System.Boolean)、および [Enum](xref:System.Enum) 型を表す文字列をデータ型に解析することもできます。
-
-## <a name="char"></a>Char
-
-[Char](xref:System.Char) データ型に関連付けられている静的解析メソッドは、1 つの文字を含む文字列をUnicode 値に変換するのに便利です。 次のコードの例では、文字列を Unicode 文字に解析します。
-
-```csharp
-string MyString1 = "A";
-char MyChar = Char.Parse(MyString1);
-// MyChar now contains a Unicode "A" character.
-```
-
-```vb
-Dim MyString1 As String = "A"
-Dim MyChar As Char = Char.Parse(MyString1)
-' MyChar now contains a Unicode "A" character.
-```
-
-## <a name="boolean"></a>ブール型
-
-[Boolean](xref:System.Boolean) データ型には、[Parse](xref:System.Boolean.Parse(System.String)) メソッドが含まれ、`Boolean` 値を示す文字列を実際の `Boolean` 型に変換するために使用できます。 このメソッドは大文字と小文字を区別しません。また、"True" または "False" を含む文字列を正常に解析することができます。 `Boolean` 型に関連付けられる `Parse` メソッドは、空白で囲まれた文字列を解析することもできます。 その他の文字列が渡された場合、[FormatException](xref:System.FormatException) がスローされます。
-
-次のコードの例では、`Parse` メソッドを使用して、文字列を `Boolean` 値に変換します。
-
-```csharp
-string MyString2 = "True";
-bool MyBool = bool.Parse(MyString2);
-// MyBool now contains a True Boolean value.
-```
-
-```vb
-Dim MyString1 As String = "A"
-Dim MyChar As Char = Char.Parse(MyString1)
-' MyChar now contains a Unicode "A" character.
-```
-
-## <a name="enumeration"></a>列挙
-
-静的 [Parse](xref:System.Enum.Parse(System.Type,System.String)) メソッドを使用して、列挙型を文字列の値に初期化できます。 このメソッドでは、解析している列挙型、解析する文字列、および解析が大文字小文字を区別するかどうかを示す省略可能な `Boolean` フラグを受け入れます。 解析している文字列は、コンマで区切られた複数の値を含めることができます。これは、1 つ以上の空の領域 (空白とも呼ばれます) が前後にある場合があります。 文字列に複数の値がある場合、返されたオブジェクトの値は、ビット演算 OR 演算と組み合わされたすべての指定された値の値です。
-
-次の例では、`Parse` メソッドを使用して、文字列形式を列挙値に変換します。 [DayOfWeek](xref:System.DayOfWeek) 列挙体は、文字列から Thursday に初期化されます。
-
-```csharp
-string MyString3 = "Thursday";
-DayOfWeek MyDays = (DayOfWeek)Enum.Parse(typeof(DayOfWeek), MyString3);
-Console.WriteLine(MyDays);
-// The result is Thursday.
-```
-
-```vb
-Dim MyString3 As String = "Thursday"
-Dim MyDays As DayOfWeek = CType([Enum].Parse(GetType(DayOfWeek), MyString3), DayOfWeek)
-Console.WriteLine("{0:G}", MyDays)
-' The result is Thursday.
-```
-
-## <a name="see-also"></a>関連項目
-
-[.NET での文字列の解析](parsing-strings.md)
-
-[.NET での型の書式設定](formatting-types.md)
-
-[.NET での型変換](type-conversion.md)
-
-
+title: ".NET Framework におけるその他の文字列の解析 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Char データ型、解析 (文字列を)"
+  - "列挙体 [.NET Framework]、解析 (文字列を)"
+  - "基本型、解析 (文字列を)"
+  - "解析 (文字列を)、その他の文字列"
+  - "Boolean データ型、解析 (文字列を)"
+ms.assetid: d139bc00-3c4e-4d78-ac9a-5c951b258d28
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# .NET Framework におけるその他の文字列の解析
+数値文字列や <xref:System.DateTime> 文字列のほかに、<xref:System.Char> 型、<xref:System.Boolean> 型、および <xref:System.Enum> 型を表す文字列もデータ型に変換できます。  
+  
+## Char  
+ **Char** データ型に関連付けられている静的な解析メソッドは、単一の文字を含む文字列を Unicode 値に変換するときに便利です。  文字列を Unicode 文字に変換するコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.Parse#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.parse/cpp/parse.cpp#2)]
+ [!code-csharp[Conceptual.String.Parse#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.parse/cs/parse.cs#2)]
+ [!code-vb[Conceptual.String.Parse#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.parse/vb/parse.vb#2)]  
+  
+## Boolean  
+ **Boolean** データ型には、Boolean 値を表す文字列を実際の **Boolean** 型に変換するために使用できる **Parse** メソッドがあります。  このメソッドは、大文字と小文字を区別せず、"True" または "False" を含む文字列を正しく解析します。**Boolean** 型に関連付けられた **Parse** メソッドは、空白で囲まれた文字列も解析できます。  それ以外の文字列を渡すと、<xref:System.FormatException> がスローされます。  
+  
+ **Parse** メソッドを使用して文字列を Boolean 値に変換するコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.Parse#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.parse/cpp/parse.cpp#3)]
+ [!code-csharp[Conceptual.String.Parse#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.parse/cs/parse.cs#3)]
+ [!code-vb[Conceptual.String.Parse#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.parse/vb/parse.vb#3)]  
+  
+## 列挙型  
+ 静的な **Parse** メソッドを使用して、列挙型を文字列の値に初期化できます。  このメソッドは、解析する列挙型、解析する文字列、および解析で大文字小文字を区別するかどうかを示すオプションの Boolean フラグを受け入れます。  解析する文字列には、コンマで区切った複数の数値を含めることができます。コンマの前後に 1 つ以上の空白があってもかまいません。  文字列に複数の値が含まれている場合、返されるオブジェクトの値は、指定したすべての値をビットごとの OR 演算で組み合わせた値になります。  
+  
+ **Parse** メソッドを使用して、文字列形式を列挙値に変換するコード例を次に示します。  <xref:System.DayOfWeek> 列挙体が、文字列から **Thursday** に初期化されます。  
+  
+ [!code-cpp[Conceptual.String.Parse#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.parse/cpp/parse.cpp#4)]
+ [!code-csharp[Conceptual.String.Parse#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.parse/cs/parse.cs#4)]
+ [!code-vb[Conceptual.String.Parse#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.parse/vb/parse.vb#4)]  
+  
+## 参照  
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/parsing-strings.md b/docs/standard/base-types/parsing-strings.md
index 07d46f6f6fc..c3bdc157737 100644
--- a/docs/standard/base-types/parsing-strings.md
+++ b/docs/standard/base-types/parsing-strings.md
@@ -1,38 +1,46 @@
 ---
-title: ".NET での文字列の解析"
-description: ".NET での文字列の解析"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/22/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 8103c0a6-61d3-40dd-a3e9-2a32ba6a4c05
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: c741ae793d491f691a355df6ad064b81d609c7e5
-ms.lasthandoff: 03/03/2017
-
----
-
-# <a name="parsing-strings-in-net"></a>.NET での文字列の解析
-
-解析操作では、.NET の基本データ型を表す文字列をその基本データ型に変換します。 たとえば解析操作は、文字列を浮動小数点数や日付と時刻の値に変換するために使用します。 解析操作を実行するには、`Parse` メソッドがよく使用されます。 解析は書式設定の逆の操作 (基本データ型のその文字列形式への変換を含む) であるため、多くの同じ規則が適用されます。 カルチャに依存する書式情報を指定するために、書式設定で [IFormatProvider](xref:System.IFormatProvider) インターフェイスを実装するオブジェクトを使用するのと同じように、解析でも [IFormatProvider](xref:System.IFormatProvider) インターフェイスを実装するオブジェクトを使用し、文字列形式を解釈する方法を決定します。 詳細については、「[.NET での型の書式設定](formatting-types.md)」をご覧ください。
-
-## <a name="in-this-section"></a>このセクションの内容
-
-[.NET での数値文字列の解析](parsing-numeric.md) - 文字列を .NET の数値文字列に変換する方法について説明します。
-
-[.NET での日付と時刻文字列の解析](parsing-datetime.md) - 文字列を .NET の `DateTime` 型に変換する方法について説明します。
-
-[.NET でのその他の文字列の解析](parsing-other.md) - 文字列を [Char](xref:System.Char)、[Boolean](xref:System.Boolean)、および [Enum](xref:System.Enum) 型に変換する方法について説明します。
-
-[.NET での型の書式設定](formatting-types.md) - 書式指定子および書式プロバイダーなどの基本書式の概念について説明します。
-
-[.NET での型変換](type-conversion.md) - 型を変換する方法について説明します。
-
-[.NET での基本データ型の操作](index.md) - .NET の基本データ型で実行できる一般的な操作について説明します。
-
-
+title: ".NET Framework における文字列の解析 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "解析 (文字列を)、文字列の解析の概要"
+  - "IFormatProvider インターフェイス、解析 (文字列を)"
+  - "基本型、解析 (文字列を)"
+  - "Parse メソッド"
+  - "解析 (文字列を)"
+ms.assetid: 5e758b41-db93-456b-8999-99b7304b090d
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# .NET Framework における文字列の解析
+解析操作では、.NET Framework の基本型を表す文字列を .NET Framework 基本型に変換します。  たとえば、解析操作は、文字列を浮動小数点値または日付と時刻の値に変換するために使用されます。  解析操作に使用される最も一般的なメソッドは `Parse` メソッドです。  解析は、基本型をその文字列形式に変換する書式指定の逆の操作であるため、書式指定時の規則の多くが解析にも適用されます。  書式指定で <xref:System.IFormatProvider> インターフェイスを実装するオブジェクトを使用してカルチャに依存した書式指定情報を提供するのと同じように、解析でも <xref:System.IFormatProvider> インターフェイスを実装するオブジェクトを使用して、文字列形式の解釈方法が決定されます。  詳細については、「[型の書式設定](../../../docs/standard/base-types/formatting-types.md)」を参照してください。  
+  
+## このセクションの内容  
+ [数値文字列の解析](../../../docs/standard/base-types/parsing-numeric.md)  
+ 文字列を .NET Framework の数値型に変換する方法について説明します。  
+  
+ [日付と時刻文字列の解析](../../../docs/standard/base-types/parsing-datetime.md)  
+ 文字列を .NET Framework の **DateTime** 型に変換する方法について説明します。  
+  
+ [その他の文字列の解析](../../../docs/standard/base-types/parsing-other.md)  
+ 文字列を **Char** 型、**Boolean** 型、および **Enum** 型に変換する方法について説明します。  
+  
+## 関連項目  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)  
+ 書式指定子や書式プロバイダーなど、基本的な書式指定の概念について説明します。  
+  
+ [.NET Framework における型変換](../../../docs/standard/base-types/type-conversion.md)  
+ 型の変換方法について説明します。  
+  
+ [基本型](../../../docs/standard/base-types/index.md)  
+ .NET Framework の基本型に対して実行できる一般的な操作について説明します。
\ No newline at end of file
diff --git a/docs/standard/base-types/performing-formatting-operations.md b/docs/standard/base-types/performing-formatting-operations.md
index 518f6f9b81f..6880d7811fb 100644
--- a/docs/standard/base-types/performing-formatting-operations.md
+++ b/docs/standard/base-types/performing-formatting-operations.md
@@ -1,39 +1,46 @@
 ---
-title: "書式設定操作の実行"
-description: "書式設定操作の実行"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/25/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 982f0b64-7e69-4bbe-a688-0117f86a603c
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: e464c4014ce315c88d5c281f6fd0d0299b640716
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="performing-formatting-operations"></a>書式設定操作の実行
-
-次のトピックで、特定の書式設定操作を行うための手順を説明します。
-
-* [方法: 先行するゼロを数値に埋め込む](pad-number.md)
-
-* [方法: カスタム数値書式プロバイダーを定義して使用する](define-custom.md)
-
-* [方法: 特定の日付から曜日を抽出する](extract-day.md)
-
-* [方法: 日付と時刻の値をラウンドトリップさせる](roundtrip.md)
-
-* [方法: 日付および時刻の値のミリ秒部分を表示する](display-milliseconds.md)
-
-* [方法: グレゴリオ暦以外の暦の日付を表示する](display-dates.md)
-
-## <a name="see-also"></a>関連項目
-
-[型の書式設定](formatting-types.md)
-
+title: "書式設定操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "日付の書式設定 [.NET Framework]"
+  - "書式指定 [.NET Framework], 基本型"
+  - "書式指定 [.NET Framework], 方法トピック"
+  - "書式指定 (文字列の) [.NET Framework], 方法トピック"
+  - "文字列 [.NET Framework], 書式指定"
+  - "時刻の書式設定 [.NET Framework]"
+ms.assetid: 36e7e096-4e6c-4cf2-9ab6-68073026ea0e
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 書式設定操作の実行
+次の各トピックでは、特定の書式設定操作を行うための手順を説明しています。  
+  
+-   [方法: 数値に先行するゼロを埋め込む](../../../docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md)  
+  
+-   [方法 : カスタム数値書式プロバイダーを定義して使用する](../../../docs/standard/base-types/how-to-define-and-use-custom-numeric-format-providers.md)  
+  
+-   [方法 : Web コントロールでの数値のユーザー入力を数値に変換する](../../../docs/standard/base-types/how-to-convert-numeric-user-input-in-web-controls-to-numbers.md)  
+  
+-   [方法 : 特定の日付から曜日を抽出する](../../../docs/standard/base-types/how-to-extract-the-day-of-the-week-from-a-specific-date.md).  
+  
+-   [方法 : 日付と時刻の値をラウンドトリップさせる](../../../docs/standard/base-types/how-to-round-trip-date-and-time-values.md)  
+  
+-   [方法 : ローカライズされた日付\/時刻情報を Web ユーザーに表示する](../../../docs/standard/base-types/how-to-display-localized-date-and-time-information-to-web-users.md)  
+  
+-   [方法: 日付および時刻の値のミリ秒部分を表示する](../../../docs/standard/base-types/how-to-display-milliseconds-in-date-and-time-values.md)  
+  
+-   [方法 : グレゴリオ暦以外の暦の日付を表示する](../../../docs/standard/base-types/how-to-display-dates-in-non-gregorian-calendars.md)  
+  
+## 参照  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/quantifiers-in-regular-expressions.md b/docs/standard/base-types/quantifiers-in-regular-expressions.md
new file mode 100644
index 00000000000..18e4d6db8bc
--- /dev/null
+++ b/docs/standard/base-types/quantifiers-in-regular-expressions.md
@@ -0,0 +1,277 @@
+---
+title: "正規表現での量指定子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現、量指定子"
+  - "メタ文字、量指定子"
+  - "最小一致の量指定子"
+  - "量指定子 (正規表現)"
+  - ".NET Framework 正規表現、量指定子"
+  - "量指定子"
+  - "最短一致の量指定子"
+ms.assetid: 36b81212-6511-49ed-a8f1-ff080415312f
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# 正規表現での量指定子
+量指定子は、一致と見なすために、入力中に文字、グループ、または文字クラスがいくつ存在しなければならないかを指定します。.NET Framework でサポートされている量指定子を次の表に示します。  
+  
+|最長一致の量指定子|最短一致の量指定子|説明|  
+|---------------|---------------|--------|  
+|`*`|`*?`|0 回以上の繰り返しに一致します。|  
+|`+`|`+?`|1 回以上の繰り返しに一致します。|  
+|`?`|`??`|0 回または 1 回の繰り返しに一致します。|  
+|`{` *n* `}`|`{` *n* `}?`|*n* の繰り返しに一致します。|  
+|`{` *n* `,}`|`{` *n* `,}?`|少なくとも *n* の繰り返しに一致します。|  
+|`{` *n* `,` *m* `}`|`{` *n* `,` *m* `}?`|*n* から *m* の繰り返しに一致します。|  
+  
+ 量 `n` および `m` は、整数定数です。  通常、量指定子は最長一致です。最長一致の場合、正規表現エンジンでは、特定のパターンの繰り返しができるだけ多くなるように照合が行われます。  量指定子に `?` 文字を付けると最短一致になります。最短一致の場合は、繰り返しができるだけ少なくなるように照合が行われます。  最長一致の量指定子と最短一致の量指定子の違いの詳細については、このトピックの「[最長一致の量指定子と最短一致の量指定子](#Greedy)」のセクションを参照してください。  
+  
+> [!IMPORTANT]
+>  量指定子を入れ子にすると \(正規表現パターン `(a*)*` などの場合\)、入力文字列の文字数に応じて指数関数的に、正規表現エンジンで実行する必要がある比較の回数が増加する可能性があります。  この動作と回避方法の詳細については、「[バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)」を参照してください。  
+  
+## 正規表現の量指定子  
+ 以降のセクションでは、.NET Framework の正規表現でサポートされている量指定子について説明します。  
+  
+> [!NOTE]
+>  正規表現エンジンでは、正規表現パターンで \*、\+、?、{、および } の各文字を検出すると、[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)に含まれているもの以外は量指定子または量指定子構造の一部として解釈します。  文字クラスの外側でこれらをリテラル文字として解釈するには、文字の前に円記号を付けてエスケープする必要があります。  たとえば、正規表現パターン内の `\*` という文字列は、リテラルのアスタリスク \("\*"\) 文字と解釈されます。  
+  
+### 0 回以上の繰り返しに一致: \*  
+ `*` 量指定子は、直前の要素の 0 回以上の繰り返しに一致します。  これは `{0,}` 指定子と同じです。  `*` は最長一致の量指定子であり、最短一致でこれに対応するのは `*?` です。  
+  
+ 以下の例はこの正規表現を示しています。  入力文字列の 9 つの数字のうち、5 つがパターンに一致し、4 つ \(`95`、`929`、`9129`、および `9919`\) が一致しません。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#1)]
+ [!code-vb[RegularExpressions.Quantifiers#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#1)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`91*`|"9" の後に文字 "1" が 0 個以上続くパターンに一致します。|  
+|`9*`|0 個以上の文字 "9" に一致します。|  
+|`\b`|ワード境界で終了します。|  
+  
+### 1 回以上の繰り返しに一致: \+  
+ `+` 量指定子は、直前の要素の 1 回以上の繰り返しに一致します。  これは `{1,}` と同じです。  `+` は最長一致の量指定子であり、最短一致でこれに対応するのは `+?` です。  
+  
+ たとえば、正規表現 `\ban+\w*?\b` は、文字 `a` で始まり、文字 `n` が 1 回以上繰り返されるすべての単語に一致を試みます。  以下の例はこの正規表現を示しています。  この正規表現は、単語 `an`、`annual`、`announcement`、および `antique` に一致し、`autumn` と `all` では正しく不一致となります。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#2](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#2)]
+ [!code-vb[RegularExpressions.Quantifiers#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#2)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`an+`|"a" の後に文字 "n" が 1 個以上続くパターンに一致します。|  
+|`\w*?`|単語に使用される文字の 0 回以上の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。|  
+|`\b`|ワード境界で終了します。|  
+  
+### 0 回または 1 回の繰り返しに一致: ?  
+ `?` 量指定子は、直前の要素の 0 回または 1 回の繰り返しに一致します。  これは `{0,1}` と同じです。  `?` は最長一致の量指定子であり、最短一致でこれに対応するのは `??` です。  
+  
+ たとえば、正規表現 `\ban?\b` は、文字 `a` で始まり、文字 `n` が 0 回または 1 回繰り返されるすべての単語に一致を試みます。  つまり、単語 `a` と `an` に一致を試みます。  以下の例はこの正規表現を示しています。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#3](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#3)]
+ [!code-vb[RegularExpressions.Quantifiers#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#3)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`an?`|"a" の後に文字 "n" が 0 個または 1 個続くパターンに一致します。|  
+|`\b`|ワード境界で終了します。|  
+  
+### ちょうど n 回の繰り返しに一致: {n}  
+ `{` *n* `}` の量指定子は *n* が整数である要素の *n* の前の場合に一致します。  `{`*n*`}` は 遅延が等価 `{`*n*`}?`の最長一致の量指定子です。  
+  
+ たとえば、正規表現 `\b\d+\,\d{3}\b` は、ワード境界、1 つ以上の数字、3 つの数字、ワード境界の順に続く文字列に一致を試みます。  以下の例はこの正規表現を示しています。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#4](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#4)]
+ [!code-vb[RegularExpressions.Quantifiers#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#4)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`\,`|コンマ文字と一致します。|  
+|`\d{3}`|3 個の 10 進数と一致します。|  
+|`\b`|ワード境界で終了します。|  
+  
+### n 回以上の繰り返しに一致: {n,}  
+ `{` *n* `,}` の量指定子は、要素の *n* が整数である一つ以上 *n* に先行する時に一致します。  `{`*n*`,}` は 遅延が等価 `{`*n*`}?`の最長一致の量指定子です。  
+  
+ たとえば、正規表現 `\b\d{2,}\b\D+` は、ワード境界、2 つ以上の数字、ワード境界、数字以外の文字の順に続く文字列に一致を試みます。  以下の例はこの正規表現を示しています。  この正規表現は、`"7 days"` という語句に一致しません。これは、10 進数字が 1 つしか含まれていないためです。しかし、`"10 weeks and 300 years"` という語句には正常に一致します。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#5](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#5)]
+ [!code-vb[RegularExpressions.Quantifiers#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#5)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`\d{2,}`|2 個以上の 10 進数と一致します。|  
+|`\b`|ワード境界に一致します。|  
+|`\D+`|1 個以上の 10 進数以外の文字と一致します。|  
+  
+### n 回以上 m 回以下の繰り返しに一致: {n,m}  
+ `{` *n* `,` *m* `}` の量指定子は、要素の少なくとも *n* の先行するときに、*n* と *m* が整数である *m* 時間よりも一致しませんが。  `{`*n*`,`*m*`}` は遅延 が等価 `{`*n*`,`*m*`}?`の最長一致の量指定子です。  
+  
+ 次の例では、正規表現 `(00\s){2,4}` は、2 つの 0 とスペースが、2 回以上 4 回以下だけ現れる文字列に一致を試みます。  入力文字列の最後の部分には、このパターンが最大の 4 回ではなく 5 回含まれていることに注意してください。  しかし、この部分文字列の最初の部分 \(5 つ目の 0 のペアの前のスペースまで\) だけが、正規表現パターンに一致します。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#6](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#6)]
+ [!code-vb[RegularExpressions.Quantifiers#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#6)]  
+  
+### 0 回以上の繰り返しに一致 \(最短一致\): \*?  
+ `*?` 量指定子は、直前の要素の 0 回以上の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。  これは、最長一致の量指定子 `*` に対応する、最短一致の量指定子です。  
+  
+ 次の例では、正規表現 `\b\w*?oo\w*?\b` は、文字列 `oo` を含むすべての単語に一致します。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#7](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#7)]
+ [!code-vb[RegularExpressions.Quantifiers#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#7)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`\w*?`|0 個以上の単語に使用される文字と一致しますが、できるだけ少ない繰り返しを探します。|  
+|`oo`|文字列 "oo" と一致します。|  
+|`\w*?`|0 個以上の単語に使用される文字と一致しますが、できるだけ少ない繰り返しを探します。|  
+|`\b`|ワード境界で終了します。|  
+  
+### 1 回以上の繰り返しに一致 \(最短一致\): \+?  
+ `+?` 量指定子は、直前の要素の 1 回以上の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。  これは、最長一致の量指定子 `+` に対応する、最短一致の量指定子です。  
+  
+ たとえば、正規表現 `\b\w+?\b` は、ワード境界で区切られた 1 つ以上の文字に一致します。  以下の例はこの正規表現を示しています。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#8](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#8)]
+ [!code-vb[RegularExpressions.Quantifiers#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#8)]  
+  
+### 0 回または 1 回の繰り返しに一致 \(最短一致\): ??  
+ `??` 量指定子は、直前の要素の 0 回または 1 回の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。  これは、最長一致の量指定子 `?` に対応する、最短一致の量指定子です。  
+  
+ たとえば、正規表現 `^\s*(System.)??Console.Write(Line)??\(??` は、文字列 "Console.Write" または "Console.WriteLine" に一致します。  この文字列には、"Console" の前に "System." が含まれていてもよく、最後に左かっこがあってもかまいません。  文字列は行の先頭にある必要がありますが、その前に空白があってもかまいません。  以下の例はこの正規表現を示しています。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#9](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#9)]
+ [!code-vb[RegularExpressions.Quantifiers#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#9)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力ストリームの先頭と一致します。|  
+|`\s*`|0 個以上の空白文字と一致します。|  
+|`(System.)??`|文字列 "System." の 0 回または 1 回の繰り返しに一致します。|  
+|`Console.Write`|文字列 "Console.Write" と一致します。|  
+|`(Line)??`|文字列 "Line" の 0 回または 1 回の繰り返しに一致します。|  
+|`\(??`|左かっこの 0 回または 1 回の繰り返しに一致します。|  
+  
+### ちょうど n 回の繰り返しに一致 \(最短一致\): {n}?  
+ `{` *n* `}?` の量指定子は *n* が整数である要素の `n` の前の場合に一致します。  これは、最長一致の量指定子 `{`*n*`}+`のこれに相当します。  
+  
+ 次の例では、正規表現 `\b(\w{3,}?\.){2}?\w{3,}?\b` を使用して Web サイトのアドレスを識別します。  "www.microsoft.com" と "msdn.microsoft.com" には一致しますが、"mywebsite" や "mycompany.com" には一致しない点に注意してください。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#10](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#10)]
+ [!code-vb[RegularExpressions.Quantifiers#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#10)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`(\w{3,}?\.)`|3 個以上の単語に使用される文字の後にドット \(ピリオド\) 文字が続くパターンに一致しますが、できるだけ少ない繰り返しを探します。  これが最初のキャプチャ グループです。|  
+|`(\w{3,}?\.){2}?`|最初のグループのパターンの 2 回の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+### n 回以上の繰り返しに一致 \(最短一致\): {n,}?  
+ `{` *n* `,}?` の量指定子は、一致します要素の *n* が整数\)、できるだけ少ないと一致します `n` 少なくともに先行する時に。  これは、最長一致の量指定子 `{`*n*`,}`のこれに相当します。  
+  
+ 図の前のセクションで `{`*n*`}?` の量指定子の例を参照してください。  この例の正規表現はピリオドが続く少なくとも 3 文字が続く文字列に一致させるために `{`*n*`,}` の量指定子を使用します。  
+  
+### n 回以上 m 回以下の繰り返しに一致 \(最短一致\): {n,m}?  
+ `{` *n* `,` *m* `}?` の量指定子は `n` と *n* と *m* は整数ですが、できるだけ少ない回数\) して直前の要素にも一致します `m` の時間 \(。  これは、最長一致の量指定子 `{`*n*`,`*m*`}`のこれに相当します。  
+  
+ 次の例では、正規表現 `\b[A-Z](../../../amples/snippets/visualbasic/VS_Snippets_Remoting/SoapAttributes1/VB/s.vb){1,10}?[.!?]` は、1 個以上 10 個以下の単語を含んだ文に一致します。  これは、18 個の単語が含まれている 1 つの文を除き、入力文字列中のすべての文に一致します。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers#12](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers/cs/Quantifiers1.cs#12)]
+ [!code-vb[RegularExpressions.Quantifiers#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers/vb/Quantifiers1.vb#12)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から開始します。|  
+|`[A-Z]`|A から Z の大文字と一致します。|  
+|`(\w*\s+)`|0 個以上の単語に使用される文字の後に空白文字が 1 個以上続くパターンに一致します。  これが最初のキャプチャ グループです。|  
+|`{1,10}?`|最初のパターンの 1 回以上 10 回以下の繰り返しに一致しますが、できるだけ少ない繰り返しを探します。|  
+|`[.!?]`|区切り文字 "."、"\!"、"?" のいずれか 1 文字と一致します。|  
+  
+<a name="Greedy"></a>   
+## 最長一致の量指定子と最短一致の量指定子  
+ いくつかの量指定子には以下の 2 つのバージョンがあります。  
+  
+-   最長一致バージョン  
+  
+     最長一致の量指定子は、要素をできるだけ多く一致させようとします。  
+  
+-   最短一致バージョン  
+  
+     最短一致の量指定子は、要素をできるだけ少なく一致させようとします。  最長一致の量指定子に `?` を追加するだけで最短一致の量指定子にすることができます。  
+  
+ クレジット カード番号などの数値の列から最後の 4 つの数字を取り出す、単純な正規表現について考えてみます。  最長一致の量指定子 `*` を使用するバージョンの正規表現は、`\b.*([0-9]{4})\b` です。  しかし、2 つの数値が含まれている文字列の場合、この正規表現は、以下の例に示すように 2 番目の数値の最後の 4 つの数字だけに一致します。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers.Greedy#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers.Greedy/cs/Greedy.cs#1)]
+ [!code-vb[RegularExpressions.Quantifiers.Greedy#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers.Greedy/vb/Greedy.vb#1)]  
+  
+ この正規表現は最初の数値の一致に失敗します。量指定子 `*` では、直前の要素をできるだけ頻繁に文字列全体に一致させようとし、文字列の最後まで一致と見なされるためです。  
+  
+ これは期待した動作ではありません。  この場合は、以下の例に示すように、代わりに最短一致の `*?` ``  量指定子を使用すると、両方の数値から数字を抽出できます。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers.Greedy#2](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Quantifiers.Greedy/cs/Greedy.cs#2)]
+ [!code-vb[RegularExpressions.Quantifiers.Greedy#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Quantifiers.Greedy/vb/Greedy.vb#2)]  
+  
+ 多くの場合、最長一致と最短一致の量指定子を使用した正規表現は、同じ一致結果を返します。  異なる結果を返すことが最も多いのは、どの文字にも一致するメタ文字のワイルドカード \(`.`\) を使用した場合です。  
+  
+## 量指定子と空一致  
+ キャプチャの最小数は量指定子 `*`、`+`と `{`*n*`,`*m*`}` とこれに対応するメソッドは空一致の後には繰り返されません。  この規則により、可能なグループ キャプチャの最大回数が無限またはほぼ無限のときに、量指定子が空の部分式一致の無限ループに入ることを回避できます。  
+  
+ たとえば、次のコードは、0 個以上の文字 "a" と 0 回以上一致する正規表現パターン `(a?)*` を指定して <xref:System.Text.RegularExpressions.Regex.Match%2A?displayProperty=fullName> メソッドを呼び出した結果を表示します。  単一のキャプチャ グループによって各 "a" および <xref:System.String.Empty?displayProperty=fullName> がキャプチャされますが、2 番目の空一致はないことに注意してください。これは、最初の空一致により量指定子が繰り返しを停止するためです。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers.EmptyMatch#1](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.quantifiers.emptymatch/cs/emptymatch1.cs#1)]
+ [!code-vb[RegularExpressions.Quantifiers.EmptyMatch#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.quantifiers.emptymatch/vb/emptymatch1.vb#1)]  
+  
+ キャプチャの最大回数および最小回数を定義するキャプチャ グループとキャプチャの固定回数を定義するキャプチャ グループとの実際の違いを確認するために、正規表現パターンの `(a\1|(?(1)\1)){0,2}` と `(a\1|(?(1)\1)){2}` について検討します。  どちらの正規表現も、次の表に示すように定義される単一のキャプチャ グループで構成されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`(a\1`|"a" と最初のキャプチャ グループの値に一致します。|  
+|`&#124;(?(1)`|または、最初のキャプチャ グループが定義されているかどうかをテストします\(`(?(1)` 構成要素ではキャプチャ グループは定義されないことに注意してください\)。|  
+|`\1))`|最初のキャプチャ グループが存在する場合、その値と一致します。  グループが存在しない場合、そのグループは <xref:System.String.Empty?displayProperty=fullName> と一致します。|  
+  
+ 最初の正規表現では、0 ～ 2 回、このパターンとの照合が行われます。2 番目の正規表現では、厳密に 2 回です。  最初のパターンは <xref:System.String.Empty?displayProperty=fullName> の最初のキャプチャでキャプチャの最小回数に達するため、`a\1` との照合は繰り返されません。`{0,2}` 量指定子では、最後の反復処理の空一致だけが許可されます。  一方、2 番目の正規表現では、2 回目の `a\1` が評価されるため、"a" に一致します。反復の最小回数は 2 で、空一致の後でエンジンが繰り返さなければならない回数になります。  
+  
+ [!code-csharp[RegularExpressions.Quantifiers.EmptyMatch#2](../../../samples/snippets/csharp/VS_Snippets_CLR/regularexpressions.quantifiers.emptymatch/cs/emptymatch4.cs#2)]
+ [!code-vb[RegularExpressions.Quantifiers.EmptyMatch#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/regularexpressions.quantifiers.emptymatch/vb/emptymatch4.vb#2)]  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)   
+ [バックトラッキング](../../../docs/standard/base-types/backtracking-in-regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expression-example-changing-date-formats.md b/docs/standard/base-types/regular-expression-example-changing-date-formats.md
new file mode 100644
index 00000000000..e959c10aac3
--- /dev/null
+++ b/docs/standard/base-types/regular-expression-example-changing-date-formats.md
@@ -0,0 +1,62 @@
+---
+title: "正規表現の例: 日付形式の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "検索 (正規表現を使用した)、例"
+  - "テキストの解析 (正規表現を使用した)、例"
+  - "正規表現、例"
+  - ".NET Framework 正規表現、例"
+  - "正規表現 [.NET Framework]、例"
+  - "パターン マッチング (正規表現を使用した)、例"
+ms.assetid: 5fcc75a5-09d7-45ae-a4c0-9ad6085ac83d
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 正規表現の例: 日付形式の変更
+次のコード例はフォーム *dd*\-*mm*\-*yy*の日付でフォーム *mm*\/*dd*\/*yy* の日付を置き換えるに <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> のメソッドを使用します。  
+  
+## 例  
+ [!code-csharp[RegularExpressions.Examples.ChangeDateFormats#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.ChangeDateFormats/cs/Example_ChangeDateFormats1.cs#1)]
+ [!code-vb[RegularExpressions.Examples.ChangeDateFormats#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.ChangeDateFormats/vb/Example_ChangeDateFormats1.vb#1)]  
+  
+ 次のコードは、アプリケーションの中で `MDYToDMY` メソッドを呼び出す方法を示しています。  
+  
+ [!code-csharp[RegularExpressions.Examples.ChangeDateFormats#2](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.ChangeDateFormats/cs/Example_ChangeDateFormats1.cs#2)]
+ [!code-vb[RegularExpressions.Examples.ChangeDateFormats#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.ChangeDateFormats/vb/Example_ChangeDateFormats1.vb#2)]  
+  
+## コメント  
+ 正規表現パターン `\b(?<month>\d{1,2})/(?<day>\d{1,2})/(?<year>\d{2,4})\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(?<month>\d{1,2})`|1 桁または 2 桁の 10 進数と一致します。  これが `month` キャプチャ グループです。|  
+|`/`|スラッシュ記号に一致します。|  
+|`(?<day>\d{1,2})`|1 桁または 2 桁の 10 進数と一致します。  これが `day` キャプチャ グループです。|  
+|`/`|スラッシュ記号に一致します。|  
+|`(?<year>\d{2,4})`|2 ～ 4 個の 10 進数と一致します。  これが `year` キャプチャ グループです。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ パターン `${day}-${month}-${year}` による置換文字列の定義を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`$(day)`|`day` キャプチャ グループによってキャプチャされた文字列を追加します。|  
+|`-`|ハイフンを追加します。|  
+|`$(month)`|`month` キャプチャ グループによってキャプチャされた文字列を追加します。|  
+|`-`|ハイフンを追加します。|  
+|`$(year)`|`year` キャプチャ グループによってキャプチャされた文字列を追加します。|  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expression-example-scanning-for-hrefs.md b/docs/standard/base-types/regular-expression-example-scanning-for-hrefs.md
new file mode 100644
index 00000000000..548a4e0dcff
--- /dev/null
+++ b/docs/standard/base-types/regular-expression-example-scanning-for-hrefs.md
@@ -0,0 +1,61 @@
+---
+title: "正規表現の例: HREFS のスキャン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "検索 (正規表現を使用した)、例"
+  - "解析 (テキストを正規表現で)、例"
+  - "正規表現、例"
+  - ".NET Framework 正規表現、例"
+  - "正規表現 [.NET Framework]、例"
+  - "パターン一致 (正規表現を使用した)、例"
+ms.assetid: fae2c15b-7adf-4b15-b118-58eb3906994f
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# 正規表現の例: HREFS のスキャン
+次の例では、入力文字列を検索して、表示されるすべての href\=」…」 文字列の値と場所。  
+  
+## Regex オブジェクト  
+ `DumpHRefs` メソッドは、ユーザー コードから複数回呼び出される可能性があるため、`static` \(Visual Basic では `Shared`\) <xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> メソッドを使用します。  これにより、正規表現エンジンが正規表現をキャッシュできるようになり、メソッドを呼び出すたびに新しい <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化するオーバーヘッドを回避できます。  <xref:System.Text.RegularExpressions.Match> オブジェクトは、文字列内のすべての一致を反復処理するために使用されます。  
+  
+ [!code-csharp[RegularExpressions.Examples.HREF#1](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.HREF/cs/example.cs#1)]
+ [!code-vb[RegularExpressions.Examples.HREF#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.HREF/vb/example.vb#1)]  
+  
+ `DumpHRefs` メソッドを呼び出す例を次に示します。  
+  
+ [!code-csharp[RegularExpressions.Examples.HREF#2](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Examples.HREF/cs/example.cs#2)]
+ [!code-vb[RegularExpressions.Examples.HREF#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Examples.HREF/vb/example.vb#2)]  
+  
+ 正規表現パターン `href\s*=\s*(?:["'](?<1>[^"']*)["']|(?<1>\S+))` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`href`|リテラル文字列 "href" と一致します。  一致では、大文字と小文字を区別しません。|  
+|`\s*`|0 個以上の空白文字と一致します。|  
+|`=`|等号と一致します。|  
+|`\s*`|0 個以上の空白文字と一致します。|  
+|`(?:["'](?<1>[^"']*)"&#124;(?<1>\S+))`|次のいずれかと一致し、結果をキャプチャされたグループに代入しません。<br /><br /> -   引用符または二重引用符またはアポストロフィ以外の任意の文字のゼロ以上の後に続くアポストロフィ引用符またはアポストロフィしています。  このパターンには `1` という名前のグループが含まれています。<br />-   1 つ以上の空白以外の文字。  このパターンには `1` という名前のグループが含まれています。|  
+|`(?<1>[^"']*)`|引用符以外の文字または `1`という名前のキャプチャ グループに代入アポストロフィのゼロ以上の繰り返しを検索します。|  
+|`"(?<1>\S+)`|空白以外の 1 個以上の文字を、`1` という名前のキャプチャ グループに代入します。|  
+  
+## Match 結果クラス  
+ 検索結果は <xref:System.Text.RegularExpressions.Match> クラス内に格納されます。これにより、検索処理によって抽出されたすべての部分文字列にアクセスできます。  このクラスは、検索対象となった文字列や、使用された正規表現も記憶しているため、最後に検索が実行された位置から別の検索を実行するときに、<xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドを呼び出すことができます。  
+  
+## 明示的に指定したキャプチャ  
+ 従来の正規表現では、キャプチャするためのかっこに自動的に連番が割り当てられます。  その結果、2 つの問題が発生します。  1 つ目の問題は、かっこのペアの挿入や削除により、ある正規表現が修正されると、新しい番号を反映するために、番号付きのキャプチャを参照するコードをすべて書き直す必要があることです。  2 つ目の問題は、ある文字列の検索用に 2 つの代替表現を用意するにあたって、さまざまなかっこを使用することがあるため、実際にどちらの代替表現から結果が返されたのかを判断するのが難しくなる可能性があることです。  
+  
+ これらの問題に対処するために、<xref:System.Text.RegularExpressions.Regex> クラスは指定されたスロットに一致文字列をキャプチャするための構文 `(?<name>…)` をサポートしています。このスロットには、文字列または整数の名前を付けることができます。整数の名前を付けた方が、よりすばやく再呼び出しできます。  この方法により、同一文字列に対する代替表現に一致した文字列をすべて同じスロットにキャプチャできます。  競合が発生する場合は、スロットに最後にキャプチャされた一致文字列が、正当な一致文字列と見なされます。\(しかし、1 つのスロットに対して複数の一致対象の完全なリストを使用できます。  詳細については、<xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> コレクションを参照してください。\)  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expression-examples.md b/docs/standard/base-types/regular-expression-examples.md
new file mode 100644
index 00000000000..6e2b0cf56c7
--- /dev/null
+++ b/docs/standard/base-types/regular-expression-examples.md
@@ -0,0 +1,60 @@
+---
+title: "正規表現の例 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現 [.NET Framework]、例"
+  - "正規表現 [.NET Framework]"
+  - "文字列 [.NET Framework]、正規表現"
+ms.assetid: e9fd53f2-ed56-4b09-b2ea-e9bc9d65e6d6
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 正規表現の例
+このセクションでは、一般的なアプリケーションで正規表現を使用するときのコード例を示します。  
+  
+> [!NOTE]
+>  <xref:System.Web.RegularExpressions> 名前空間には、HTML、XML、および ASP.NET ドキュメントの文字列を解析するための定義済み正規表現パターンを実装する多数の正規表現オブジェクトがあります。  たとえば、<xref:System.Web.RegularExpressions.TagRegex> クラスは文字列内の開始タグを識別し、<xref:System.Web.RegularExpressions.CommentRegex> クラスは文字列内の ASP.NET コメントを識別します。  
+  
+## このセクションの内容  
+ [例 : HREFS のスキャン](../../../docs/standard/base-types/regular-expression-example-scanning-for-hrefs.md)  
+ 入力文字列を検索して、文字列内のすべての href\="..." の値と位置を出力する例を示します。  
+  
+ [例 : 日付形式の変更](../../../docs/standard/base-types/regular-expression-example-changing-date-formats.md)  
+ mm\/dd\/yy 形式の日付を dd\-mm\-yy 形式の日付に置換する例を示します。  
+  
+ [方法 : URL からプロトコルとポート番号を抽出する](../../../docs/standard/base-types/how-to-extract-a-protocol-and-port-number-from-a-url.md)  
+ URL を含む文字列からプロトコルとポート番号を抽出する例を示します。  たとえば、"http:\/\/www.contoso.com:8080\/letters\/readme.html" の場合は "http:8080" が返されます。  
+  
+ [方法 : 文字列から無効な文字を取り除く](../../../docs/standard/base-types/how-to-strip-invalid-characters-from-a-string.md)  
+ 文字列から無効な非英数文字を取り除く例を示します。  
+  
+ [方法 : 文字列が有効な電子メール形式であるかどうかを検証する](../../../docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md)  
+ 文字列が有効な電子メール形式であることを確認するために使用できる例を示します。  
+  
+## 関連項目  
+ <xref:System.Text.RegularExpressions>  
+ .NET Framework **System.Text.RegularExpressions** 名前空間のクラス ライブラリ リファレンス情報が用意されています。  
+  
+## 関連項目  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)  
+ 正規表現のプログラミング言語的な面の概要について説明します。  
+  
+ [正規表現のオブジェクト モデル](../../../docs/standard/base-types/the-regular-expression-object-model.md)  
+ `System.Text.RegularExpression` 名前空間に含まれている正規表現クラスについて説明し、その使用方法の例を示します。  
+  
+ [正規表現の動作の詳細](../../../docs/standard/base-types/details-of-regular-expression-behavior.md)  
+ .NET Framework 正規表現の機能と動作について説明します。  
+  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)  
+ 正規表現を定義するために使う一連の文字、演算子、および構成体について説明します。
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expression-language-quick-reference.md b/docs/standard/base-types/regular-expression-language-quick-reference.md
new file mode 100644
index 00000000000..1652bc97bc9
--- /dev/null
+++ b/docs/standard/base-types/regular-expression-language-quick-reference.md
@@ -0,0 +1,230 @@
+---
+title: "正規表現言語 - クイック リファレンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+f1_keywords: 
+  - "VS.RegularExpressionBuilder"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 言語要素"
+  - "カンニング ペーパー"
+  - "解析 (正規表現を使用したテキストを), 言語要素"
+  - "パターン一致 (正規表現を使用した), 言語要素"
+  - "regex カンニング ペーパー"
+  - "正規表現 [.NET Framework]"
+  - "正規表現, 言語要素"
+  - "検索 (正規表現を使用した), 言語要素"
+ms.assetid: 930653a6-95d2-4697-9d5a-52d11bb6fd4c
+caps.latest.revision: 56
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 56
+---
+# 正規表現言語 - クイック リファレンス
+<a name="top"></a> 正規表現とは、入力テキスト内で正規表現エンジンによる照合が試行されるパターンです。 パターンは、1 個以上の文字リテラル、演算子、または構成体で構成されます。  簡単な紹介については、「[.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)」を参照してください。  
+  
+ このクイック リファレンスの各セクションでは、正規表現の定義に使用できる特定カテゴリの文字、演算子、および構成体を一覧表示します。  
+  
+ [文字のエスケープ](#character_escapes)  
+ [文字クラス](#character_classes)  
+ [アンカー](#atomic_zerowidth_assertions)  
+ [グループ化構成体](#grouping_constructs)  
+ [量指定子](#quantifiers)  
+ [前方参照構成体](#backreference_constructs)  
+ [代替構成体](#alternation_constructs)  
+ [置換](#substitutions)  
+ [正規表現のオプション](#options)  
+ [その他の構成体](#miscellaneous_constructs)  
+  
+ また、ダウンロードして印刷し、簡単に参照できるように、この情報を 2 種類の形式で提供します  
+  
+ [Word \(.docx\) 形式でダウンロード](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.docx)  
+[PDF \(.pdf\) 形式でダウンロード](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.pdf)  
+  
+<a name="character_escapes"></a>   
+## 文字のエスケープ  
+ 正規表現内の円記号 \(\\\) は、直後の文字が特殊文字 \(次の表を参照\) であるか、文字どおりに解釈する必要があることを示します。 詳細については、「[文字のエスケープ](../../../docs/standard/base-types/character-escapes-in-regular-expressions.md)」を参照してください。  
+  
+|エスケープ文字|説明|パターン|一致件数|  
+|-------------|--------|----------|----------|  
+|`\a`|ビープ音文字の \\u0007 と一致します。|`\a`|"Error\!" \+ '\\u0007'  の "\\u0007"|  
+|`\b`|文字クラスでバックスペースの \\u0008 と一致します。|`[\b]{3,}`|"\\b\\b\\b\\b" の "\\b\\b\\b\\b"|  
+|`\t`|タブの \\u0009 と一致します。|`(\w+)\t`|"item1\\titem2\\t" の "item1\\t"、"item2\\t"|  
+|`\r`|キャリッジ リターンの \\u000D と一致します。 \(`\r` は改行文字 `\n` とは異なります。\)|`\r\n(\w+)`|"\\r\\nThese are\\ntwo lines." の "\\r\\nThese"|  
+|`\v`|垂直タブの \\u000B と一致します。|`[\v]{2,}`|"\\v\\v\\v" の "\\v\\v\\v"|  
+|`\f`|フォーム フィードの \\u000C と一致します。|`[\f]{2,}`|"\\f\\f\\f" の "\\f\\f\\f"|  
+|`\n`|改行文字の \\u000A と一致します。|`\r\n(\w+)`|"\\r\\nThese are\\ntwo lines." の "\\r\\nThese"|  
+|`\e`|エスケープ文字の \\u001B と一致します。|`\e`|"\\x001B" の "\\x001B"|  
+|`\` *nnn*|8 進数表現で文字を指定します \(*nnn* は 2 桁または 3 桁で構成されます\)。|`\w\040\w`|"a bc d" の<br /><br /> "a b"、"c d"|  
+|`\x` *nn*|16 進数表現で文字を指定します \(*nn* は 2 桁で構成されます\)。|`\w\x20\w`|"a bc d" の<br /><br /> "a b"、"c d"|  
+|`\c` *X*<br /><br /> `\c` *x*|*X* または *x* で指定された ASCII の制御文字と一致します。*X* または *x* は制御文字です。|`\cC`|"\\x0003" \(Ctrl\-C\) の "\\x0003"|  
+|`\u` *nnnn*|16 進数形式で表される Unicode 文字 \(*nnnn* で表される 4 桁の数字\) と一致します。|`\w\u0020\w`|"a bc d" の<br /><br /> "a b"、"c d"|  
+|`\`|このトピック内の表に示されているエスケープ文字として認識されない文字が後ろに付いている場合は、その文字と一致します。 たとえば、`\*` は `\x2A` と同じであり、`\.` は `\x2E` と同じです。 これを使用すると、正規表現エンジンによって言語要素 \(\* や ? など\)  と文字リテラル \( や  で表されたもの\) のあいまいさが解消されます。|`\d+[\+-x\*]\d+`|"\(2\+2\) \* 3\*9" の "2\+2" および "3\*9"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="character_classes"></a>   
+## 文字クラス  
+ 文字クラスは、文字セットのいずれかと一致します。 文字クラスに含まれる言語要素を次の表に示します。 詳細については、「[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)」を参照してください。  
+  
+|文字クラス|説明|パターン|一致件数|  
+|-----------|--------|----------|----------|  
+|`[` *character\_group* `]`|*character\_group* 内の任意の 1 文字と一致します。 既定では、大文字と小文字が区別されます。|`[ae]`|"gray" の "a"<br /><br /> "lane" の "a"、"e"|  
+|`[^` *character\_group* `]`|否定: *character\_group* 内にない任意の 1 文字と一致します。 既定では、*character\_group* の文字について、大文字と小文字が区別されます。|`[^aei]`|"reign" の "r"、"g"、"n"|  
+|`[` *先頭* `-` *last* `]`|文字範囲: *first* から *last* までの範囲にある任意の 1 文字と一致します。|`[A-Z]`|"AB123" の "A"、"B"|  
+|`.`|ワイルドカード: \\n を除く任意の 1 文字と一致します。<br /><br /> リテラルのピリオド文字 \(.  または `\u002E`\) と一致させるには、この文字の前にエスケープ文字 \(`\.`\) を指定します。|`a.e`|"nave" の "ave"<br /><br /> "water" の "ate"|  
+|`\p{` *name* `}`|*name* で指定された名前付きブロックまたは Unicode 一般カテゴリ内の任意の 1 文字と一致します。|`\p{Lu}`<br /><br /> `\p{IsCyrillic}`|"City Lights" の "C"、"L"<br /><br /> "ДЖem" の "Д"、"Ж"|  
+|`\P{` *name* `}`|*name* で指定された名前付きブロックまたは Unicode 一般カテゴリにない任意の 1 文字と一致します。|`\P{Lu}`<br /><br /> `\P{IsCyrillic}`|"City" の "i"、"t"、"y"<br /><br /> "ДЖem" の "e"、"m"|  
+|`\w`|単語に使用される任意の文字と一致します。|`\w`|"ID A1.3" の "I"、"D"、"A"、"1"、"3"|  
+|`\W`|単語に使用される文字以外の任意の文字と一致します。|`\W`|"ID A1.3" の " "、"."|  
+|`\s`|空白文字と一致します。|`\w\s`|"ID A1.3" の "D "|  
+|`\S`|空白以外の文字と一致します。|`\s\S`|"int \_\_ctr" の " \_"|  
+|`\d`|10 進数字と一致します。|`\d`|"4 \= IV" の "4"|  
+|`\D`|10 進数以外の任意の文字と一致します。|`\D`|"4 \= IV" の " "、"\="、" "、"I"、"V"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="atomic_zerowidth_assertions"></a>   
+## アンカー  
+ アンカー \(アトミック ゼロ幅アサーション\) を使用すると、文字列内での現在位置によって一致するかどうかが決まります。しかし、エンジンで後方の文字列が読み込まれたり、複数の文字と一致したりすることはありません。 アンカーであるメタ文字を次の表に示します。 詳細については、「[アンカー](../../../docs/standard/base-types/anchors-in-regular-expressions.md)」を参照してください。  
+  
+|アサーション|説明|パターン|一致件数|  
+|------------|--------|----------|----------|  
+|`^`|文字列または行の先頭で一致する必要があります。|`^\d{3}`|"901"<br /><br /> \("901\-333\-" の\)|  
+|`$`|文字列の末尾で一致するか、行または文字列の末尾にある `\n` の前で一致する必要があります。|`-\d{3}$`|"\-333"<br /><br /> \("\-901\-333" の\)|  
+|`\A`|文字列の先頭で一致する必要があります。|`\A\d{3}`|"901"<br /><br /> \("901\-333\-" の\)|  
+|`\Z`|文字列の末尾で一致するか、文字列の末尾にある `\n` の前で一致する必要があります。|`-\d{3}\Z`|"\-333"<br /><br /> \("\-901\-333" の\)|  
+|`\z`|文字列の末尾で一致する必要があります。|`-\d{3}\z`|"\-333"<br /><br /> \("\-901\-333" の\)|  
+|`\G`|前回の一致が終了した位置で一致する必要があります。|`\G\(\d\)`|"\(1\)\(3\)\(5\)\[7\]\(9\)" の "\(1\)"、"\(3\)"、"\(5\)"|  
+|`\b`|`\w` \(英数字\) と `\W` \(英数字以外\) 文字の境界位置で一致する必要があります。|`\b\w+\s\w+\b`|"them theme them them" の "them theme"|  
+|`\B`|`\b` 境界以外で一致する必要があります。|`\Bend\w*\b`|"end sends endure lender" の "ends"、"ender"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="grouping_constructs"></a>   
+## グループ化構成体  
+ グループ化構成体は、正規表現の部分式を表し、通常は入力文字列の部分文字列をキャプチャします。 グループ化構成体に含まれる言語要素を次の表に示します。 詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+|グループ化構成体|説明|パターン|一致件数|  
+|--------------|--------|----------|----------|  
+|`(` *subexpression* `)`|一致した部分式をキャプチャして、1 から始まる序数を代入します。|`(\w)\1`|"deep" の "ee"|  
+|`(?<` *name* `>` *subexpression*`)`|一致した部分式を名前付きグループにキャプチャします。|`(?<double>\w)\k<double>`|"deep" の "ee"|  
+|`(?<` *name1* `-` *name2* `>` *subexpression*`)`|グループ定義の均等化を定義します。 詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」の「グループ定義の均等化」を参照してください。|`(((?'Open'\()[^\(\)]*)+((?'Close-Open'\))[^\(\)]*)+)*(?(Open)(?!))$`|"3\+2^\(\(1\-3\)\*\(3\-1\)\)" の "\(\(1\-3\)\*\(3\-1\)\)"|  
+|`(?:` *subexpression*`)`|非キャプチャ グループを定義します。|`Write(?:Line)?`|"Console.WriteLine\(\)" の "WriteLine"<br /><br /> "Console.Write\(value\)" の "Write"|  
+|`(?imnsx-imnsx:` *subexpression*`)`|指定したオプションを *subexpression* に適用するか、または無効にします。 詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。|`A\d{2}(?i:\w+)\b`|"A12xl A12XL a12xl" の "A12xl"、"A12XL"|  
+|`(?=` *subexpression*`)`|ゼロ幅の肯定先読みアサーションです。|`\w+(?=\.)`|"He is. The dog ran. The sun is out." の "is"、"ran"、および "out"|  
+|`(?!` *subexpression*`)`|ゼロ幅の否定先読みアサーションです。|`\b(?!un)\w+\b`|"unsure sure unity used" の "sure"、"used"|  
+|`(?<=` *subexpression*`)`|ゼロ幅の正の後読みアサーションです。|`(?<=19)\d{2}\b`|"1851 1999 1950 1905 2003" の "99"、"50"、"05"|  
+|`(?<!` *subexpression*`)`|ゼロ幅の負の後読みアサーションです。|`(?<!19)\d{2}\b`|"1851 1999 1950 1905 2003" の "51"、"03"|  
+|`(?>` *subexpression*`)`|非バックトラッキング \("最長"\) 部分式です。|`[13579](?>A+B+)`|"1ABB 3ABBC 5AB 5AC" の "1ABB"、"3ABB"、および "5AB"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="quantifiers"></a>   
+## 限定子  
+ 量指定子は、一致するために、入力文字列中に直前の要素 \(文字、グループ、または文字クラス\) がいくつ存在しなければならないかを指定します。 量指定子に含まれる言語要素を次の表に示します。 詳細については、「[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)」を参照してください。  
+  
+|量指定子|説明|パターン|一致件数|  
+|----------|--------|----------|----------|  
+|`*`|直前の要素と 0 回以上一致します。|`\d*\.\d`|".0"、"19.9"、"219.9"|  
+|`+`|直前の要素と 1 回以上一致します。|`"be+"`|"been" の "bee"、"bent" の "be"|  
+|`?`|直前の要素と 0 回または 1 回一致します。|`"rai?n"`|"ran"、"rain"|  
+|`{` *n* `}`|直前の要素とちょうど *n* 回一致します。|`",\d{3}"`|"1,043.6" の ",043"、"9,876,543,210" の ",876"、",543"、および ",210"|  
+|`{` *n* `,}`|直前の要素と *n* 回以上一致します。|`"\d{2,}"`|"166"、"29"、"1930"|  
+|`{` *n* `,` *分* `}`|直前の要素と *n* 回以上 *m* 回以下で一致します。|`"\d{3,5}"`|"166"、"17668"<br /><br /> "193024" の "19302"|  
+|`*?`|直前の要素と 0 回以上 \(ただし、できるだけ少ない回数\) 一致します。|`\d*?\.\d`|".0"、"19.9"、"219.9"|  
+|`+?`|直前の要素と 1 回以上 \(ただし、できるだけ少ない回数\) 一致します。|`"be+?"`|"been" の "be"、"bent" の "be"|  
+|`??`|直前の要素と 0 回または 1 回 \(ただし、できるだけ少ない回数\) 一致します。|`"rai??n"`|"ran"、"rain"|  
+|`{` *n* `}?`|直前の要素とちょうど *n* 回一致します。|`",\d{3}?"`|"1,043.6" の ",043"、"9,876,543,210" の ",876"、",543"、および ",210"|  
+|`{` *n* `,}?`|直前の要素と *n* 回以上 \(ただし、できるだけ少ない回数\) 一致します。|`"\d{2,}?"`|"166"、"29"、"1930"|  
+|`{` *n* `,` *分* `}?`|直前の要素と *n* 回以上 *m* 回以下 \(ただし、できるだけ少ない回数\) 一致します。|`"\d{3,5}?"`|"166"、"17668"<br /><br /> "193024" の "193"、"024"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="backreference_constructs"></a>   
+## 前方参照構成体  
+ 前方参照を使用すると、以前に一致した部分式を、同じ正規表現内で引き続き識別できます。 .NET Framework の正規表現でサポートされている前方参照構成体を、次の表に示します。 詳細については、「[前方参照構成体](../../../docs/standard/base-types/backreference-constructs-in-regular-expressions.md)」を参照してください。  
+  
+|前方参照構成体|説明|パターン|一致件数|  
+|-------------|--------|----------|----------|  
+|`\` *number*|前方参照。 番号付き部分式の値に一致します。|`(\w)\1`|"seek" の "ee"|  
+|`\k<` *name* `>`|名前付き前方参照。 名前付きの式の値に一致します。|`(?<char>\w)\k<char>`|"seek" の "ee"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="alternation_constructs"></a>   
+## 代替構成体  
+ 代替構成体は、OR 一致を有効にするように正規表現を変更します。 これらの構成体に含まれる言語要素を次の表に示します。 詳細については、「[代替構成体](../../../docs/standard/base-types/alternation-constructs-in-regular-expressions.md)」を参照してください。  
+  
+|代替構成体|説明|パターン|一致件数|  
+|-----------|--------|----------|----------|  
+|`&#124;`|縦棒 \(&#124;\) 文字で区切られた要素のいずれかと一致します。|`th(e&#124;is&#124;at)`|"this is the day." の "the"、"this "|  
+|`(?(` *式* `)` *可* `&#124;` *no* `)`|*expression* で指定される正規表現パターンが一致する場合は *yes* と一致します。それ以外の場合は、*no* \(省略可能\) 部分と一致します。*expression* はゼロ幅アサーションとして解釈されます。|`(?(A)A\d{2}\b&#124;\b\d{3}\b)`|"A10 C103 910" の "A10"、"910"|  
+|`(?(` *name* `)` *可* `&#124;` *no* `)`|名前付きまたは番号付きのキャプチャ グループ *name* に一致が見つかった場合は *yes* と一致します。それ以外の場合は *no* \(省略可能\) と一致します。|`(?<quoted>")?(?(quoted).+?"&#124;\S+\s)`|"Dogs.jpg "Yiska playing.jpg"" の Dogs.jpg、"Yiska playing.jpg"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="substitutions"></a>   
+## 置換  
+ 置換は、置換パターンでサポートされる正規表現言語要素です。 詳細については、「[置換](../../../docs/standard/base-types/substitutions-in-regular-expressions.md)」を参照してください。 アトミック ゼロ幅アサーションであるメタ文字を次の表に示します。  
+  
+|文字|説明|パターン|置換パターン|入力文字列|結果文字列|  
+|--------|--------|----------|------------|-----------|-----------|  
+|`$` *number*|グループの *number* と一致した部分文字列に置換されます。|`\b(\w+)(\s)(\w+)\b`|`$3$2$1`|"one two"|"two one"|  
+|`${` *name* `}`|名前付きグループの *name* と一致した部分文字列に置換されます。|`\b(?<word1>\w+)(\s)(?<word2>\w+)\b`|`${word2} ${word1}`|"one two"|"two one"|  
+|`$$`|"$" リテラルに置換されます。|`\b(\d+)\s?USD`|`$$$1`|"103 USD"|"$103"|  
+|`$&`|一致したパターン全体と同じパターンに置換されます。|`\$?\d*\.?\d+`|`**$&**`|"$1.30"|"\*\*$1.30\*\*"|  
+|`$``|一致した場所より前にある入力文字列のすべてに置換されます。|`B+`|`$``|"AABBCC"|"AAAACC"|  
+|`$'`|一致した場所より後にある入力文字列のすべてに置換されます。|`B+`|`$'`|"AABBCC"|"AACCCC"|  
+|`$+`|キャプチャされた最後のグループに置換されます。|`B+(C+)`|`$+`|"AABBCCDD"|AACCDD|  
+|`$_`|入力文字列全体に置換されます。|`B+`|`$_`|"AABBCC"|"AAAABBCCCC"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="options"></a>   
+## 正規表現のオプション  
+ 正規表現エンジンで正規表現パターンを解釈する方法を制御するオプションを指定できます。 これらのオプションの多くは、インラインで \(正規表現パターンで\) 指定することも、1 つ以上の <xref:System.Text.RegularExpressions.RegexOptions> 定数として指定することもできます。 このクイック リファレンスでは、インライン オプションのみを示しています。 インライン オプションと <xref:System.Text.RegularExpressions.RegexOptions> オプションの詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。  
+  
+ インライン オプションは、次の 2 種類の方法で指定できます。  
+  
+-   [その他の構成体](../../../docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md) `(?imnsx-imnsx)` の使用。オプションまたはオプション セットの前に負符号 \(\-\) がある場合、そのオプションが無効になります。 たとえば、`(?i-mn)` では、大文字と小文字を区別しない一致 \(`i`\) がオン、複数行モード \(`m`\) がオフ、名前のないグループ キャプチャ \(`n`\) がオフになります。 このオプションは、このオプションが定義されている位置から正規表現パターンに適用され、パターンの末尾まで、または別の構成体によってオプションが反転する位置まで有効になります。  
+  
+-   [グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md) `(?imnsx-imnsx:`*subexpression*`)` の使用。これは、指定されたグループのみに対するオプションを定義します。  
+  
+ .NET Framework 正規表現エンジンでは、次のインライン オプションがサポートされます。  
+  
+|オプション|説明|パターン|一致件数|  
+|-----------|--------|----------|----------|  
+|`i`|大文字と小文字を区別しない一致を使用します。|`\b(?i)a(?-i)a\w+\b`|"aardvark AAAuto aaaAuto Adam breakfast" の "aardvark"、"aaaAuto"|  
+|`m`|複数行モードを使用します。`^` と `$` は、\(入力文字列の先頭および末尾ではなく\) 各行の先頭および末尾と一致します。|例については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「複数行モード」を参照してください。||  
+|`n`|名前のないグループをキャプチャしません。|例については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「明示的なキャプチャのみ」を参照してください。||  
+|`s`|単一行モードを使用します。|例については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」の「単一行モード」を参照してください。||  
+|`x`|正規表現パターンでエスケープされていない空白を無視します。|`\b(?x) \d+ \s \w+`|"1 aardvark 2 cats IV centurions" の "1 aardvark"、"2 cats"|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="miscellaneous_constructs"></a>   
+## その他の構成体  
+ その他の構成体は、正規表現パターンを変更するか、それに関する情報を指定します。 .NET Framework でサポートされているその他の構成体を、次の表に示します。 詳細については、「[その他の構成体](../../../docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md)」を参照してください。  
+  
+|構成体|定義|例|  
+|---------|--------|-------|  
+|`(?imnsx-imnsx)`|パターンの途中で、大文字と小文字の区別などのオプションを設定または無効化します。 詳細については、「[正規表現のオプション](../../../docs/standard/base-types/regular-expression-options.md)」を参照してください。|`\bA(?i)b\w+\b` は、"ABA Able Act" の "ABA"、"Able" に一致します。|  
+|`(?#` *comment*`)`|インライン コメントです。 コメントは、最初の閉じかっこで終了します。|`\bA(?#Matches words starting with A)\w+\b`|  
+|`#` \[to end of line\]|X モード コメントです。 コメントの先頭はエスケープされない `#` で、コメントは行末まで継続します。|`(?x)\bA\w+\b#Matches words starting with A`|  
+  
+## 参照  
+ <xref:System.Text.RegularExpressions?displayProperty=fullName>   
+ <xref:System.Text.RegularExpressions.Regex>   
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)   
+ [正規表現クラス](../../../docs/standard/base-types/the-regular-expression-object-model.md)   
+ [正規表現の例](../../../docs/standard/base-types/regular-expression-examples.md)   
+ [正規表現 \- クイック リファレンス \(Word 形式でダウンロード\)](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.docx)   
+ [正規表現 \- クイック リファレンス \(PDF 形式でダウンロード\)](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.pdf)
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expression-options.md b/docs/standard/base-types/regular-expression-options.md
new file mode 100644
index 00000000000..bbc5467ccbe
--- /dev/null
+++ b/docs/standard/base-types/regular-expression-options.md
@@ -0,0 +1,399 @@
+---
+title: "正規表現のオプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "正規表現のオプション"
+  - "オプションは、コンス トラクター"
+  - ".NET framework 正規表現のオプション"
+  - "インライン オプション構成体"
+  - "options パラメーター"
+ms.assetid: c82dc689-7e82-4767-a18d-cd24ce5f05e9
+caps.latest.revision: 27
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 27
+---
+# 正規表現のオプション
+<a name="Top"></a>既定では、正規表現パターンにリテラル文字を含む入力文字列の比較では大文字小文字を区別、正規表現パターン内の空白はリテラルの空白文字として解釈されますおよび正規表現のキャプチャ グループは、明示的にも暗黙的にという名前です。 正規表現のオプションを指定することで、これらの正規表現の既定の動作とそのいくつかの側面を変更できます。 次の表に示す各オプションは、正規表現パターンの一部としてインラインで記述することも、<xref:System.Text.RegularExpressions.Regex?displayProperty=fullName> クラス コンストラクターまたは静的パターン一致メソッドに <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> 列挙値として渡すこともできます。  
+  
+|RegexOptions のメンバー|インライン文字|効果|  
+|-------------------------|----------------------|------------|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|使用できません|既定の動作を使用します。 詳細については、「[既定のオプション](#Default)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|`i`|大文字と小文字を区別しない一致を使用します。 詳細については、「[大文字と小文字を区別しない一致](#Case)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|`m`|複数行モードを使用します。`^` と `$` は、(入力文字列の先頭および末尾ではなく) 各行の先頭および末尾と一致します。 詳細については、「[複数行モード](#Multiline)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|`s`|単一行モードを使用します。このモードでは、ピリオド (.) は任意の&1; 文字と一致します (`\n` を除くすべての文字の代用)。 詳細については、「[単一行モード](#Singleline)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|`n`|名前のないグループをキャプチャしません。 唯一の有効なキャプチャを明示的に名前または形式のグループを示す番号付き`(?<`*名*`>` *subexpression*`)`します。 詳細については、「[明示的なキャプチャのみ](#Explicit)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|使用できません|正規表現をアセンブリにコンパイルします。 詳細については、「[コンパイルされた正規表現](#Compiled)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|`x`|エスケープされていない空白をパターンから除外し、シャープ記号 (`#`) の後ろのコメントを有効にします。 詳細については、「[空白を無視](#Whitespace)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|使用できません|検索の方向を変更します。 左から右ではなく、右から左に検索します。 詳細については、「[右から左モード](#RightToLeft)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|使用できません|式の ECMAScript 準拠の動作を有効にします。 詳細については、「[ECMAScript 一致の動作](#ECMAScript)」を参照してください。|  
+|<xref:System.Text.RegularExpressions.RegexOptions>|使用できません|言語のカルチャの違いを無視します。 詳細については、「[インバリアント カルチャを使用した比較](#Invariant)」を参照してください。|  
+  
+## <a name="specifying-the-options"></a>オプションの指定  
+ 正規表現のオプションは、次の&3; 種類の方法のいずれかで指定できます。  
+  
+-   `options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex?displayProperty=fullName>クラスのコンス トラクターまたは静的な (`Shared` Visual Basic で)、パターン一致メソッドなど、 <xref:System.Text.RegularExpressions.Regex.%23ctor%28System.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName>または<xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName>します。 `options`パラメーターは、ビットごとの OR の組み合わせ<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>列挙値。  
+  
+     オプションを指定すると、 <xref:System.Text.RegularExpressions.Regex>インスタンスを使用して、`options`クラスのコンス トラクターのパラメーターには、オプションに割り当てられている、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>プロパティです。 ただし、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> プロパティは、正規表現パターン自体でのインライン オプションを反映しません。  
+  
+     具体的な例を次に示します。 使用して、`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName>小文字を区別しない一致を有効にして、文字"d"で始まる単語を識別するときに、パターンの空白を無視する方法です。  
+  
+     [!code-csharp[Conceptual.Regex.Language.Options#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/example1.cs#6)]
+     [!code-vb[Conceptual.Regex.Language.Options#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/example1.vb#6)]  
+  
+-   `(?imnsx-imnsx)` という構文で、インライン オプションを正規表現パターンに適用します。 この場合、オプションが定義されているパターンの先頭から、パターンの末尾を含むポイントまで、または別のインライン オプションでオプションが定義されていないポイントまでを範囲として、オプションがパターンに適用されます。 <xref:System.Text.RegularExpressions.Regex> インスタンスの <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> プロパティはこれらのインライン オプションを反映しないことに注意してください。 詳細については、次を参照してください。、 [(その他) を構築](../../../docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md)トピックです。  
+  
+     具体的な例を次に示します。 インライン オプションを使用して、文字 "d" で始まる単語を識別するときに、大文字と小文字を区別しない一致を有効にすると同時に、パターンの空白を無視します。  
+  
+     [!code-csharp[Conceptual.Regex.Language.Options#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/example1.cs#7)]
+     [!code-vb[Conceptual.Regex.Language.Options#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/example1.vb#7)]  
+  
+-   特定のグループ化でのインライン オプションを適用することによって構成体構文を使用して正規表現パターンに`(?imnsx-imnsx:` *subexpression*`)`します。 オプション セットの前にマイナス記号を付けないとそのオプション セットはオンになり、マイナス記号を付けるとオフになります  (`?` は言語構成要素の構文の固定部分であり、オプションが有効であるか無効であるかにかかわらず、必要になります)。オプションは、そのグループに対してのみ適用されます。 詳細については、次を参照してください。[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)します。  
+  
+     具体的な例を次に示します。 グループ化構成体のインライン オプションを使用して、文字 "d" で始まる単語を識別するときに、大文字と小文字を区別しない一致を有効にすると同時に、パターンの空白を無視します。  
+  
+     [!code-csharp[Conceptual.Regex.Language.Options#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/example1.cs#8)]
+     [!code-vb[Conceptual.Regex.Language.Options#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/example1.vb#8)]  
+  
+ オプションをインラインで指定した場合は、オプションまたはオプション セットの前にマイナス記号 (`-`) を付けると、そのオプションはオフになります。 たとえば、インライン構成体`(?ix-ms)`電源をオン、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>と<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプションで、オフに、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>と<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション。 既定では、すべての正規表現のオプションがオフです。  
+  
+> [!NOTE]
+>  コンストラクターまたはメソッド呼び出しの `options` パラメーターで指定した正規表現オプションが正規表現パターンのインラインで指定したオプションと競合した場合は、インラインで指定したオプションが使用されます。  
+  
+ 次に示す&5; 種類の正規表現オプションは、options パラメーターとインラインの両方で設定できます。  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+ 次に示す&5; 種類の正規表現オプションは `options` パラメーターを使用して設定することはできますが、インラインで設定することはできません。  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+-   <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>  
+  
+## <a name="determining-the-options"></a>オプションの確認  
+ インスタンス化されたときに <xref:System.Text.RegularExpressions.Regex> オブジェクトに渡されたオプションの種類を確認するには、読み取り専用の <xref:System.Text.RegularExpressions.Regex.Options%2A?displayProperty=fullName> プロパティの値を取得します。 によって作成されたコンパイル済みの正規表現で定義されているオプションを確認する場合に特に、このプロパティは、 <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName>メソッドです。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> を除くオプションが存在するかどうかをテストするには、目的の <xref:System.Text.RegularExpressions.Regex.Options%2A?displayProperty=fullName> プロパティの値と <xref:System.Text.RegularExpressions.RegexOptions> の値を使用して AND 演算を実行します。 次に、この結果が <xref:System.Text.RegularExpressions.RegexOptions> の値と等しいかどうかをテストします。 次の例は、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションが設定されているかどうかをテストします。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/determine1.cs#19)]
+ [!code-vb[Conceptual.Regex.Language.Options#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/determine1.vb#19)]  
+  
+ テストする<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>を決定するかどうかの値、 <xref:System.Text.RegularExpressions.Regex.Options%2A?displayProperty=fullName>プロパティに等しい<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>次の例に示すようにします。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/determine1.cs#20)]
+ [!code-vb[Conceptual.Regex.Language.Options#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/determine1.vb#20)]  
+  
+ 以降のセクションでは、.NET Framework の正規表現でサポートされているオプションについて説明します。  
+  
+<a name="Default"></a>   
+## <a name="default-options"></a>既定のオプション  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションは、オプションが指定されていないことを示します。正規表現エンジンは、このオプションの既定の動作を使用します。 次に例を示します。  
+  
+-   このパターンは、ECMAScript 正規表現ではなく、標準の形式として解釈されます。  
+  
+-   正規表現パターンは、左から右に入力文字列と照合されます。  
+  
+-   比較では大文字と小文字が区別されます。  
+  
+-   `^` 言語要素および `$` 言語要素は、入力文字列の先頭および末尾と一致します。  
+  
+-   `.` 言語要素は、`\n` を除く任意の&1; 文字と一致します。  
+  
+-   正規表現パターンに含まれる空白は、リテラルの空白文字として解釈されます。  
+  
+-   パターンを入力文字列と比較するときに、現在のカルチャの規則が使用されます。  
+  
+-   正規表現パターンのキャプチャ グループは、暗黙的に指定される場合と明示的に指定される場合があります。  
+  
+> [!NOTE]
+>  <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションには、等価なインライン オプションは存在しません。 正規表現オプションがインラインで適用されたときに、特定のオプションをオフにすると、既定の動作がオプションごとに復元されます。 たとえば、`(?i)` は大文字と小文字を区別しない比較をオンにし、`(?-i)` は既定の動作 (大文字と小文字を区別する比較) を復元します。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションは正規表現エンジンの既定の動作を表しているので、メソッド呼び出しで明示的に指定されることはほとんどありません。 代わりに、`options` パラメーターを使用せずにコンストラクターまたは静的パターン一致メソッドが呼び出されます。  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Case"></a>   
+## <a name="case-insensitive-matching"></a>大文字と小文字を区別しない一致  
+ <xref:System.Text.RegularExpressions.RegexOptions>オプション、または`i`インライン オプションは小文字を区別しない一致を実行します。 既定では、現在のカルチャの大文字と小文字の表記規則が使用されます。  
+  
+ 次の例では、"the" で始まるすべての単語と一致する正規表現パターン `\bthe\w*\b` を定義します。 最初の呼び出しのため、<xref:System.Text.RegularExpressions.Regex.Match%2A>メソッドは、既定の大文字小文字を区別比較を使用して、出力は、"The"を文の開始文字列が一致しないことを示します。 これが一致として処理されるのは、オプションを <xref:System.Text.RegularExpressions.RegexOptions> に設定して <xref:System.Text.RegularExpressions.Regex.Match%2A> メソッドが呼び出された場合です。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/case1.cs#1)]
+ [!code-vb[Conceptual.Regex.Language.Options#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/case1.vb#1)]  
+  
+ 次の例では、前の例の正規表現パターンを変更し、`options` パラメーターを使用する代わりに、インライン オプションを使用して、大文字と小文字を区別しない比較を行っています。 最初のパターンでは、文字列 "the" の文字 "t" のみに適用されるよう、グループ化構成体の大文字と小文字を区別しないオプションを定義しています。 オプションの構成体がパターンの先頭にあるので、2 番目のパターンでは、大文字と小文字を区別しないオプションが正規表現全体に適用されています。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/case2.cs#2)]
+ [!code-vb[Conceptual.Regex.Language.Options#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/case2.vb#2)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Multiline"></a>   
+## <a name="multiline-mode"></a>複数行モード  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション、または`m`正規表現エンジンは、複数の行で構成される入力文字列の処理により、インライン オプションを指定します。 具体的には、`^` 言語要素および `$` 言語要素の解釈を変更して、入力文字列の先頭および末尾ではなく、行の先頭および末尾に一致するものとします。  
+  
+ 既定では、`$` は入力文字列の末尾とのみ一致します。 指定した場合、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション、改行文字と一致する (`\n`) または入力文字列の末尾。 ただし、復帰とライン フィード文字の組み合わせとは一致しません。 この組み合わせと正常に一致させるには、`\r?$` を単独で使用する代わりに、部分式 `$` を使用します。  
+  
+ 次の例は、ボウリング参加者の名前とスコアを抽出しに追加、 <xref:System.Collections.Generic.SortedList%602>それらを降順に並べ替えるコレクション</TKey, TValue>。 <xref:System.Text.RegularExpressions.Regex.Matches%2A> メソッドは&2; 回呼び出されています。 最初のメソッド呼び出しでは、`^(\w+)\s(\d+)$` という正規表現が使用され、オプションは設定されていません。 出力結果が示すように、正規表現エンジンは入力パターンを入力文字列の先頭および末尾と一致させることができないので、一致は検出されません。 2 番目のメソッド呼び出しでは、正規表現は `^(\w+)\s(\d+)\r?$` に変更されており、オプションは <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> に設定されています。 出力結果が示すように、名前とスコアの照合は正常に行われ、スコアは降順で表示されています。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/multiline1.cs#3)]
+ [!code-vb[Conceptual.Regex.Language.Options#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/multiline1.vb#3)]  
+  
+ 正規表現パターン `^(\w+)\s(\d+)\r*$` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|-------------|-----------------|  
+|`^`|行の先頭から始まります。|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これが最初のキャプチャ グループです。|  
+|`\s`|空白文字と一致します。|  
+|`(\d+)`|1 個以上の&10; 進数と一致します。 これが&2; 番目のキャプチャ グループです。|  
+|`\r?`|0 個または&1; 個の復帰文字と一致します。|  
+|`$`|行の末尾で終了します。|  
+  
+ 次の例は、前の例と等価ですが、インライン オプション `(?m)` を使用して複数行オプションを設定している点が異なります。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/multiline2.cs#4)]
+ [!code-vb[Conceptual.Regex.Language.Options#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/multiline2.vb#4)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Singleline"></a>   
+## <a name="single-line-mode"></a>単一行モード  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション、または`s`と、単一行で構成されていますかのように入力の文字列を処理する正規表現エンジンのインライン オプションを指定します。 具体的には、ピリオド (`.`) 言語要素の動作を変更して、改行文字 (`\n` または \u000A) を除く任意の文字ではなく、改行文字を含む任意の&1; 文字と一致するようにします。  
+  
+ 次の例に示す方法の動作、`.`言語要素を変更するときに、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション。 正規表現 `^.+` は文字列の先頭から開始し、すべての文字と一致します。 既定では、照合は&1; 行目の末尾で終了します。正規表現パターンは復帰文字 `\r` (\u000D) と一致しますが、`\n` とは一致しません。 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプションが入力文字列全体を単一行として解釈し、入力文字列内のすべての文字と一致を含む`\n`します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.CharacterClasses#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.characterclasses/cs/any2.cs#5)]
+ [!code-vb[Conceptual.Regex.Language.CharacterClasses#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.characterclasses/vb/any2.vb#5)]  
+  
+ 次の例は、前の例と等価ですが、インライン オプション `(?s)` を使用して単一行モードを有効にしている点が異なります。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/singleline1.cs#5)]
+ [!code-vb[Conceptual.Regex.Language.Options#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/singleline1.vb#5)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Explicit"></a>   
+## <a name="explicit-captures-only"></a>明示的なキャプチャのみ  
+ 既定では、キャプチャ グループは正規表現パターンでかっこを使用することで定義されます。 名前付きグループは、名前を割り当てられたか、または番号を`(?<`*名*`>`*subexpression* `)`言語のオプション、名前のないグループはインデックスでアクセスします。 <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトでは、名前のないグループが名前付きのグループよりも優先されます。  
+  
+ グループ化構成体は通常、複数の言語要素に量指定子を適用する場合にのみ使用され、キャプチャされた部分文字列は対象になりません。 たとえば、次の正規表現について考えます。  
+  
+```  
+\b\(?((\w+),?\s?)+[\.!?]\)?  
+```  
+  
+ この正規表現は、ドキュメントから文末がピリオド、感嘆符、または疑問符である文を抽出することのみを目的とし、結果の文 (<xref:System.Text.RegularExpressions.Match> オブジェクトで表される) のみを対象としています。 コレクション内の個々の単語は対象ではありません。  
+  
+ 正規表現エンジンで <xref:System.Text.RegularExpressions.GroupCollection> コレクション オブジェクトと <xref:System.Text.RegularExpressions.CaptureCollection> コレクション オブジェクトの両方を設定する必要があるので、キャプチャ グループが以後、使用されない場合は、この設定の処理が無駄になる可能性があります。 別の方法として、いずれかを使用できます、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプションまたは`n`インライン オプションのみを有効なキャプチャが明示的に名前または番号で指定されていることを指定する、 `(?<`*名*`>` *部分式*`)`を構築します。  
+  
+ 次の例は、`\b\(?((\w+),?\s?)+[\.!?]\)?` 正規表現パターンによって返された一致に関する情報を示しています (<xref:System.Text.RegularExpressions.Regex.Match%2A> メソッドが <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して呼び出された場合、および使用せずに呼び出された場合)。 最初のメソッド呼び出しの出力結果が示すように、正規表現エンジンでは、キャプチャした部分文字列に関する情報に基づいて、<xref:System.Text.RegularExpressions.GroupCollection> コレクション オブジェクトおよび <xref:System.Text.RegularExpressions.CaptureCollection> コレクション オブジェクトが完全に設定されています。 2 番目のメソッドが呼び出されたため`options`設定<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>、グループに関する情報をキャプチャしません。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/explicit1.cs#9)]
+ [!code-vb[Conceptual.Regex.Language.Options#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/explicit1.vb#9)]  
+  
+ 正規表現パターン`\b\(?((?>\w+),?\s?)+[\.!?]\)?`の次の表に示すように定義します。  
+  
+|パターン|説明|  
+|-------------|-----------------|  
+|`\b`|ワード境界から始まります。|  
+|`\(?`|左かっこ ("(") の&0; 回または&1; 回の繰り返しと一致します。|  
+|`(?>\w+),?`|1 個以上の単語文字の後に&0; 個または&1; 個のコンマが続くパターンと一致します。 単語文字の照合中にバックトラックは実行されません。|  
+|`\s?`|0 個または&1; 個の空白文字と一致します。|  
+|`((\w+),?\s?)+`|1 個以上の単語文字、0 個または&1; 個のコンマ、および&0; 個または&1; 個の空白文字が&1; 回以上続くパターンと一致します。|  
+|`[\.!?]\)?`|3 種類の区切り記号のいずれかの後に&0; 個または&1; 個の右かっこ (")") が続くパターンと一致します。|  
+  
+ `(?n)` インライン要素を使用して、自動的なキャプチャを抑制することもできます。 次の例では、前の正規表現パターンを使用する、`(?n)`インライン要素の代わりに、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/explicit2.cs#10)]
+ [!code-vb[Conceptual.Regex.Language.Options#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/explicit2.vb#10)]  
+  
+ 最後に、`(?n:)` インライン グループ要素を使用して、グループごとに自動的なキャプチャを抑制することもできます。 次の例では、前のパターンを変更して、外部グループ `((?>\w+),?\s?)` で名前のないキャプチャを抑制しています。 この処理では、内部グループでの名前のないキャプチャも抑制されることに注意してください。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/explicit3.cs#11)]
+ [!code-vb[Conceptual.Regex.Language.Options#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/explicit3.vb#11)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Compiled"></a>   
+## <a name="compiled-regular-expressions"></a>コンパイルされた正規表現  
+ 既定では、.NET Framework の正規表現は解釈の対象になります。 <xref:System.Text.RegularExpressions.Regex> オブジェクトがインスタンス化されるか、静的 <xref:System.Text.RegularExpressions.Regex> メソッドが呼び出されたときに、正規表現パターンはカスタム オペコードのセットに解析され、インタープリターがこのオペコードに基づいて正規表現を実行します。 この場合、正規表現エンジンの初期化処理を優先すると、実行時のパフォーマンスが低下するというトレードオフが伴います。  
+  
+ 正規表現を逐次解釈する代わりに、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用してコンパイルされた正規表現を使用できます。 この場合、パターンは正規表現エンジンに渡され、オペコードのセットに解析されてから、Microsoft Intermediate Language (MSIL) に変換されます。変換されたコードは、共通言語ランタイムに直接渡すことができます。 コンパイルされた正規表現を使用すると、初期化処理に時間を要しますが、実行時のパフォーマンスは向上します。  
+  
+> [!NOTE]
+>  正規表現を指定することをコンパイルすることができます、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>値を`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex>クラス コンス トラクターまたは静的パターン一致メソッドです。 インライン オプションとしては使用できません。  
+  
+ コンパイルされた正規表現は、静的正規表現とインスタンス正規表現の両方の呼び出しに使用できます。 静的正規表現で、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>にオプションが渡される、`options`正規表現パターン一致メソッドのパラメーターです。 渡されるインスタンスの正規表現、`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex>クラスのコンス トラクターです。 どちらの場合も、パフォーマンスが向上します。  
+  
+ ただし、パフォーマンスが向上するのは、次の条件を満たしている場合に限定されます。  
+  
+-   特定の正規表現を表す <xref:System.Text.RegularExpressions.Regex> オブジェクトが正規表現パターン一致メソッドの複数の呼び出しで使用されている。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> オブジェクトがスコープの外に出ることが許可されておらず、再利用できる。  
+  
+-   静的正規表現が正規表現パターン一致メソッドの複数の呼び出しで使用されている (静的メソッド呼び出しで使用した正規表現は正規表現エンジンによってキャッシュされるので、パフォーマンスの向上が可能になります)。  
+  
+> [!NOTE]
+>  <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプションのとは無関係に、 <xref:System.Text.RegularExpressions.Regex.CompileToAssembly%2A?displayProperty=fullName>メソッドで、定義済みのコンパイルされた正規表現を含む特殊な目的のアセンブリを作成します。  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Whitespace"></a>   
+## <a name="ignore-white-space"></a>空白を無視  
+ 既定では、正規表現パターンに含まれる空白には重要な意味があり、正規表現エンジンでは、入力文字列内の空白文字との照合が強制されます。 このため、正規表現"`\b\w+\s`「と」`\b\w+` "とほぼ同等の正規表現。 さらに、シャープ記号 (#) が正規表現パターンに含まれている場合は、照合する対象のリテラル文字として解釈されます。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>オプション、または`x`インライン オプションは、この既定の動作を次のように変更します。  
+  
+-   正規表現パターンでエスケープされていない空白は無視されます。 正規表現パターンの一部にするには、空白文字をエスケープする必要があります (たとえば、として`\s`または"`\` ") です。  
+  
+-   シャープ記号 (#) は、リテラル文字ではなく、コメントの先頭として解釈されます。 # 記号から文字列の末尾まで、正規表現パターンに含まれるすべてのテキストは、コメントとして解釈されます。  
+  
+ ただし次に説明する状況では、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用している場合でも、正規表現の空白文字は無視されません。  
+  
+-   文字クラス内の空白は常に、空白として解釈されます。 たとえば、正規表現パターン `[ .,;:]` は、空白文字、ピリオド、コンマ、セミコロン、またはコロンの任意の&1; 文字と一致します。  
+  
+-   White space isn't allowed within a bracketed quantifier, such as `{`*n*`}`, `{`*n*`,}`, and `{`*n*`,`*m*`}`. たとえば、正規表現パターン `\d{1. 3}` は、空白文字が含まれているため、1 ～ 3 桁の数値のどのシーケンスにも一致しません。  
+  
+-   言語要素を導入する文字シーケンス内では空白を使用できません。 例:  
+  
+    -   言語要素`(?:`*部分式*`)`は非キャプチャ グループを表し、`(?:`要素の部分は空白を埋め込むことはできませんがします。 パターン`(? :`*部分式*`)`スロー、 <xref:System.ArgumentException>実行時に、正規表現エンジンは、パターン、およびパターンを解析できないため`( ?:`*部分式*`)`にも一致しません*subexpression*します。  
+  
+    -   言語要素`\p{`*名*`}`、Unicode カテゴリを表すまたは名前付きブロックに埋め込まれたスペースを含めることはできません、`\p{`要素の部分です。 空白を追加すると、この要素は実行時に <xref:System.ArgumentException> をスローします。  
+  
+ このオプションを有効にすると、多くの場合、解析や理解が困難な正規表現を簡略化できます。 正規表現が読みやすくなり、説明も記述できます。  
+  
+ 次の例では、正規表現パターンを定義しています。  
+  
+ `\b \(? ( (?>\w+) ,?\s? )+  [\.!?] \)? # Matches an entire sentence.`  
+  
+ このパターンは、「[明示的なキャプチャのみ](#Explicit)」セクションで定義したパターンと似ています。ただし、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用して、パターンの空白を無視している点が異なります。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/whitespace1.cs#12)]
+ [!code-vb[Conceptual.Regex.Language.Options#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/whitespace1.vb#12)]  
+  
+ 次の例では、`(?x)` インライン オプションを使用して、パターンの空白を無視しています。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/whitespace2.cs#13)]
+ [!code-vb[Conceptual.Regex.Language.Options#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/whitespace2.vb#13)]  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="RightToLeft"></a>   
+## <a name="right-to-left-mode"></a>右から左モード  
+ 既定では、正規表現エンジンは左から右の方向に検索します。 この検索の方向を反転するには、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用します。 検索は、文字列の最後の文字位置から自動的に開始されます。 <xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.Int32%29?displayProperty=fullName> など、開始位置のパラメーターを含むパターン一致メソッドの場合は、検索の開始位置である右端の文字位置のインデックスが開始位置になります。  
+  
+> [!NOTE]
+>  右から左へのパターンのモードは、指定することによってのみ使用可能な<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>値を`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex>クラスのコンス トラクターまたは静的パターン一致メソッドです。 インライン オプションとしては使用できません。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションは、検索の方向のみを変更します。このオプションを指定すると、正規表現パターンが右から左に解釈されるわけではありません。 たとえば、正規表現 `\bb\w+\s` は、文字 "b" で始まる単語とそれに続く空白文字と一致します。 次の例では、入力文字列は、1 文字以上の "b" を含む&3; つの単語で構成されています。 最初の単語は "b" で始まり、2 番目の単語は "b" で終わり、3 番目の単語は語内に&2; 文字の "b" を含んでいます。 この例の出力結果が示すように、最初の単語のみが正規表現パターンと一致しています。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/righttoleft1.cs#17)]
+ [!code-vb[Conceptual.Regex.Language.Options#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/righttoleft1.vb#17)]  
+  
+ また先読みアサーション (、 `(?=`*部分式*`)`言語要素) と後読みアサーション (、 `(?<=`*部分式*`)`言語要素) 方向が変更されません。 先読みアサーションでは右方向へ、後読みアサーションでは左方向へ参照が行われます。 たとえば、正規表現 `(?<=\d{1,2}\s)\w+,?\s\d{4}` は後読みアサーションを使用して、月の名前の前にある日付をテストします。 次に、この正規表現は、月と年を照合しています。 詳細については、先読みアサーションと後読みアサーションは、次を参照してください。[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/righttoleft2.cs#18)]
+ [!code-vb[Conceptual.Regex.Language.Options#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/righttoleft2.vb#18)]  
+  
+ 正規表現パターンは、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|-------------|-----------------|  
+|`(?<=\d{1,2}\s)`|一致の先頭の前には、1 桁または&2; 桁の&10; 進数とそれに続く空白が必要です。|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`,?`|0 個または&1; 個のコンマと一致します。|  
+|`\s`|空白文字と一致します。|  
+|`\d{4}`|4 桁の&10; 進数と一致します。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="ECMAScript"></a>   
+## <a name="ecmascript-matching-behavior"></a>ECMAScript 一致の動作  
+ 既定では、正規表現パターンを入力テキストに照合するときに、正規表現エンジンは標準の動作を使用します。 ただし、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用することで、ECMAScript 一致の動作を使用するように正規表現エンジンに指示できます。  
+  
+> [!NOTE]
+>  ECMAScript 準拠の動作を指定することによってのみ使用できる、 <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>値を`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex>クラスのコンス トラクターまたは静的パターン一致メソッドです。 インライン オプションとしては使用できません。  
+  
+ <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションは、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションか <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションとのみ組み合わせることができます。 これ以外のオプションと同時に正規表現で使用すると、<xref:System.ArgumentOutOfRangeException> が発生します。  
+  
+ ECMAScript と標準正規表現は、文字クラスの構文、自己参照キャプチャ グループ、および&8; 進数と前方参照の解釈という&3; つの点で動作が異なります。  
+  
+-   文字クラスの構文。 標準正規表現が Unicode をサポートしているのに対して、ECMAScript は Unicode をサポートしていないので、ECMAScript の文字クラスの構文には制限が多く、文字クラスの言語要素によっては意味が異なります。 たとえば ECMAScript は、Unicode カテゴリやブロック要素 (`\p` および `\P`) などの言語要素をサポートしていません。 同様に、単語文字と一致する `\w` 要素は、ECMAScript を使用した場合は `[a-zA-Z_0-9]` 文字クラスと等価になり、標準の動作を使用した場合は `[\p{Ll}\p{Lu}\p{Lt}\p{Lo}\p{Nd}\p{Pc}\p{Lm}]` と等価になります。 詳細については、次を参照してください。[文字クラス](../../../docs/standard/base-types/character-classes-in-regular-expressions.md)します。  
+  
+     次の例は、標準パターン一致と ECMAScript パターン一致の違いを示しています。 この例では、単語とそれに続く空白文字と一致する正規表現 `\b(\w+\s*)+` を定義しています。 入力は&2; つの文字列で構成され、一方の文字列ではラテン語文字セットが使用され、もう一方の文字列ではキリル文字セットが使用されています。 出力結果が示すように、ECMAScript 一致を使用した <xref:System.Text.RegularExpressions.Regex.IsMatch%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> メソッドの呼び出しではキリル文字の単語が照合されないのに対して、標準一致を使用したメソッドの呼び出しではキリル文字の単語が照合されています。  
+  
+     [!code-csharp[Conceptual.Regex.Language.Options#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/ecmascript1.cs#16)]
+     [!code-vb[Conceptual.Regex.Language.Options#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/ecmascript1.vb#16)]  
+  
+-   自己参照キャプチャ グループ。 正規表現キャプチャ クラスが、それ自体への前方参照を持っている場合は、キャプチャの反復処理のたびに更新する必要があります。 次の例に示すように、この機能では、正規表現 `((a+)(\1) ?)+` による入力文字列 " aa aaaa aaaaaa "との照合は、ECMAScript を使用した場合は有効になり、標準一致を使用した場合は無効になります。  
+  
+     [!code-csharp[Conceptual.Regex.Language.Options#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/ecmascript2.cs#21)]
+     [!code-vb[Conceptual.Regex.Language.Options#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/ecmascript2.vb#21)]  
+  
+     正規表現は、次の表に示すように定義されています。  
+  
+    |パターン|説明|  
+    |-------------|-----------------|  
+    |(a+)|文字 "a" と&1; 回以上一致します。 これが&2; 番目のキャプチャ グループです。|  
+    |(\1)|最初のキャプチャ グループによってキャプチャされた部分文字列と一致します。 これが&3; 番目のキャプチャ グループです。|  
+    |?|0 個または&1; 個の空白文字と一致します。|  
+    |((a+)(\1) ?)+|1 文字以上の "a"、最初のキャプチャ グループと一致する文字列、および&0; 個または&1; 個の空白文字が&1; 回以上続くパターンと一致します。 これが最初のキャプチャ グループです。|  
+  
+-   8 進数エスケープと前方参照のあいまいさの解決方法。 標準正規表現と ECMAScript 正規表現による&8; 進数と前方参照の解釈の違いの概要を次の表に示します。  
+  
+    |正規表現|標準の動作|ECMAScript の動作|  
+    |------------------------|------------------------|-------------------------|  
+    |`\0` の後に 0 ～ 2 桁の 8 進数字が続く場合|8 進数として解釈されます。 たとえば、`\044` は常に&8; 進数値として解釈され、"$" を意味します。|同じ動作です。|  
+    |`\` の後に 1 ～ 9 の数字が続き、その後に 10 進数字が続かない場合|前方参照として解釈されます。 たとえば、9 番目のキャプチャ グループが存在しない場合でも、`\9` は常に前方参照 9 です。 キャプチャ グループが存在しない場合、正規表現パーサーをスローする<xref:System.ArgumentException>します。|単一の&10; 進数字のキャプチャ グループが存在する場合は、その数字への前方参照です。 それ以外の場合は、値はリテラルとして解釈されます。|  
+    |`\` の後に 1 ～ 9 の数字が続き、その後に 10 進数字が続く場合|数字は&10; 進数値として解釈されます。 そのキャプチャ グループが存在する場合は、式は前方参照として解釈されます。<br /><br /> それ以外の場合は、先行する数字が 377 までの範囲で 8 進数として解釈されます。つまり、値の下位 8 ビットのみが処理の対象になります。 残りの数字はリテラルとして解釈されます。 たとえば、式 `\3000` では、キャプチャ グループ 300 が存在する場合は前方参照 300 として解釈されます。キャプチャ グループ 300 が存在しない場合は 8 進数 300 とそれに続く 0 として解釈されます。|キャプチャを参照できる範囲で、できるだけ多くの桁数が&10; 進値に変換され、前方参照として解釈されます。 変換できる数字がない場合は、先行する数字が 377 までの範囲で 8 進数として解釈され、残りの数字はリテラルとして解釈されます。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Invariant"></a>   
+## <a name="comparison-using-the-invariant-culture"></a>インバリアント カルチャを使用した比較  
+ 既定では、大文字と小文字を区別しない比較を実行するときに、正規表現エンジンは現在のカルチャの大文字と小文字の表記規則を使用して、等価な大文字および小文字を決定します。  
+  
+ ただし、この動作は、比較の種類によっては望ましくない場合があります。具体的な例としては、ユーザー入力と、パスワード、ファイル、URL など、システム リソースの名前を比較する場合が挙げられます。 この場合に該当する例を次に示します。 このコードは、URL の先頭を任意のリソースへのアクセスをブロックする、 **FILE://**します。 `$FILE://` という正規表現を使用して、文字列に対する大文字と小文字を区別しない一致が試みられます。 ただし、現在のシステム カルチャが tr-TR (トルコ語 (トルコ)) である場合、"I" は "i" の大文字表現には該当しません。 呼び出しの結果として、 <xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName>メソッドを返します。 `false`、およびファイルへのアクセスを許可します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/culture1.cs#14)]
+ [!code-vb[Conceptual.Regex.Language.Options#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/culture1.vb#14)]  
+  
+> [!NOTE]
+>  大文字と小文字を区別する文字列比較とインバリアント カルチャを使用する文字列比較の詳細については、「[文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md)」を参照してください。  
+  
+ 現在のカルチャで大文字と小文字を区別しない比較を行う代わりに、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを指定すると、言語のカルチャの違いを無視して、インバリアント カルチャの規則を使用できます。  
+  
+> [!NOTE]
+>  インバリアント カルチャを使用して、比較は、指定することによってのみ使用可能な<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName>値を`options`のパラメーター、 <xref:System.Text.RegularExpressions.Regex>クラスのコンス トラクターまたは静的パターン一致メソッドです。 インライン オプションとしては使用できません。  
+  
+ 次の例は前の例と同じものですが、<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> を含むオプションを指定して、静的メソッド <xref:System.Text.RegularExpressions.Regex.IsMatch%28System.String%2CSystem.String%2CSystem.Text.RegularExpressions.RegexOptions%29?displayProperty=fullName> が呼び出されている点が異なります。 現在のカルチャがトルコ語 (トルコ) に設定されている場合でも、正規表現エンジンでは "FILE" と "file" が正常に一致し、ファイル リソースへのアクセスが拒否されます。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Options#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.options/cs/culture1.cs#15)]
+ [!code-vb[Conceptual.Regex.Language.Options#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.options/vb/culture1.vb#15)]  
+  
+## <a name="see-also"></a>関連項目  
+ [正規表現言語 - クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/regular-expressions.md b/docs/standard/base-types/regular-expressions.md
index 9f17ea3cafc..a679d4c9154 100644
--- a/docs/standard/base-types/regular-expressions.md
+++ b/docs/standard/base-types/regular-expressions.md
@@ -1,314 +1,126 @@
 ---
-title: ".NET の正規表現"
-description: ".NET の正規表現"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: d1a640cf-09ca-48f7-800c-a627a6d549c9
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: ac26821819b22aa3ea47e6945bb5c8575dcd9807
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="regular-expressions-in-net"></a>.NET の正規表現
-
-正規表現を使用すると、強力、柔軟、そして効率的な方法でテキストを処理できます。 正規表現の広範なパターン一致表記法を使用することで、大量のテキストをすばやく解析して特定の文字パターンを検索したり、決められたパターン (電子メール アドレスなど) と照らしてテキストを検証したりできるほか、テキストの部分文字列を抽出、編集、置換、または削除したり、抽出した文字列をコレクションに追加してレポートを生成したりすることもできます。 文字列処理や大量のテキストを解析する多くのアプリケーションにとって、正規表現は欠くことのできないツールです。
-
-## <a name="how-regular-expressions-work"></a>正規表現の動作
-
-正規表現を使ったテキスト処理の最も重要な部分は、.NET の [System.Text.RegularExpressions.Regex](xref:System.Text.RegularExpressions.Regex) オブジェクトによって表される正規表現エンジンです。 正規表現を使ったテキスト処理では、正規表現エンジンに対し、最低でも次の&2; つの情報を与える必要があります。
-
-* テキストを識別する正規表現パターン。 
+title: ".NET Framework の正規表現 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現"
+  - ".NET Framework 正規表現, 概要"
+  - "文字 [.NET Framework], 正規表現"
+  - "解析 (正規表現を使用したテキストを)"
+  - "解析 (正規表現を使用したテキストを), 概要"
+  - "パターン一致 (正規表現を使用した)"
+  - "パターン一致 (正規表現を使用した), パターン一致の概要"
+  - "正規表現 [.NET Framework]"
+  - "正規表現 [.NET Framework], 正規表現の概要"
+  - "検索 (正規表現を使用した)"
+  - "検索 (正規表現を使用した), 正規表現の概要"
+  - "文字列 [.NET Framework], 正規表現"
+  - "部分文字列"
+ms.assetid: 521b3f6d-f869-42e1-93e5-158c54a6895d
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# .NET Framework の正規表現
+正規表現を使用すると、強力、柔軟、そして効率的な方法でテキストを処理できます。  正規表現の広範なパターン一致表記法を使用することで、大量のテキストをすばやく解析して特定の文字パターンを検索したり、決められたパターン \(電子メール アドレスなど\) と照らしてテキストを検証したりできるほか、テキストの部分文字列を抽出、編集、置換、または削除したり、抽出した文字列をコレクションに追加してレポートを生成したりすることもできます。  文字列処理や大量のテキストを解析する多くのアプリケーションにとって、正規表現は欠くことのできないツールです。  
+  
+## 正規表現の動作  
+ 正規表現を使ったテキスト処理の最も重要な部分は、.NET Framework の <xref:System.Text.RegularExpressions.Regex?displayProperty=fullName> オブジェクトによって表される正規表現エンジンです。  正規表現を使ったテキスト処理では、正規表現エンジンに対し、最低でも次の 2 つの情報を与える必要があります。  
+  
+-   テキストを識別する正規表現パターン。  
+  
+     .NET Framework では、正規表現のパターンが特殊な構文または言語で定義されます。この構文または言語には、Perl 5 の正規表現と互換性があるほか、右から左への一致処理など、いくつかの機能が追加されています。  詳細については、「[正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)」を参照してください。  
+  
+-   正規表現パターンの解析対象となるテキスト。  
+  
+ <xref:System.Text.RegularExpressions.Regex> クラスのメソッドを使用すると、次のような処理を実行できます。  
+  
+-   入力されたテキストに特定の正規表現パターンが出現するかどうかを調べるには、<xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドを呼び出します。  テキストを検証するために <xref:System.Text.RegularExpressions.Regex.IsMatch%2A> メソッドを使用する例については、「[方法 : 文字列が有効な電子メール形式であるかどうかを検証する](../../../docs/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format.md)」を参照してください。  
+  
+-   正規表現パターンと一致したテキストを 1 つまたは全部取得するには、<xref:System.Text.RegularExpressions.Regex.Match%2A?displayProperty=fullName> メソッドまたは <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドを呼び出します。  前者は、一致したテキストの情報を保持する <xref:System.Text.RegularExpressions.Match?displayProperty=fullName> オブジェクトを返します。  後者は、解析対象のテキストに見つかった各一致につき 1 つの <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトを含む <xref:System.Text.RegularExpressions.Match?displayProperty=fullName> オブジェクトを返します。  
+  
+-   正規表現パターンと一致したテキストを置換するには、<xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドを呼び出します。  <xref:System.Text.RegularExpressions.Regex.Replace%2A> メソッドを使用して日付形式を変更したり文字列から無効な文字を削除したりする例については、「[方法 : 文字列から無効な文字を取り除く](../../../docs/standard/base-types/how-to-strip-invalid-characters-from-a-string.md)」および「[例 : 日付形式の変更](../../../docs/standard/base-types/regular-expression-example-changing-date-formats.md)」を参照してください。  
+  
+ 正規表現のオブジェクト モデルの概要については、「[正規表現のオブジェクト モデル](../../../docs/standard/base-types/the-regular-expression-object-model.md)」を参照してください。  
+  
+ 正規表現の言語の詳細については、「[正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)」を参照するか、次の資料のいずれかをダウンロードして印刷してください。  
+  
+ [Quick Reference: Word \(.docx\) 形式](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.docx)   
+ [Quick Reference: PDF \(.pdf\) 形式](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.pdf)  
+  
+## 正規表現の例  
+ <xref:System.String> クラスには、文字列内のリテラル文字列を検索する際に使用できる文字列の検索メソッドと置換メソッドが数多く含まれています。  正規表現は、次の例に示すように、文字列内の部分文字列のいずれかを検索する場合、または文字列内のパターンを識別する場合に最も役立ちます。  
+  
+### 例 1: 部分文字列の置換  
+ 氏名に敬称 \(Mr.、Mrs.、Miss、または Ms.\) が付いている場合がある名前が、宛先リストに含まれるとします。  そのリストから封筒のラベルを生成する場合に敬称が含まれないようにするには、次の例に示すように、正規表現を使用して敬称を削除します。  
+  
+ [!code-csharp[Conceptual.Regex#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex/cs/example1.cs#2)]
+ [!code-vb[Conceptual.Regex#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex/vb/example1.vb#2)]  
+  
+ 正規表現パターン `(Mr\.? |Mrs\.? |Miss |Ms\.? )` は、"Mr "、"Mr."  、"Mrs "、"Mrs.  "、"Miss "、"Ms"、または "Ms." の出現と一致します。  からドラッグします。  <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドを呼び出すと、一致する文字列が <xref:System.String.Empty?displayProperty=fullName> に置き換えられます。つまり、元の文字列から削除されます。  
+  
+### 例 2: 重複する単語の識別  
+ 記述者が単語を誤って重複入力するというエラーがよくあります。  次の例に示すように、正規表現を使用して重複する単語を識別できます。  
+  
+ [!code-csharp[Conceptual.Regex#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex/cs/example2.cs#3)]
+ [!code-vb[Conceptual.Regex#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex/vb/example2.vb#3)]  
+  
+ 正規表現パターン `\b(\w+?)\s\1\b` は、次のように解釈できます。  
+  
+|||  
+|-|-|  
+|`\b`|ワード境界から開始します。|  
+|\(\\w\+?\)|1 つ以上 \(ただし、できるだけ少ない文字数\) の単語文字と一致します。  同時に、`\1` というグループを形成します。|  
+|`\s`|空白文字と一致します。|  
+|`\1`|`\1` という名前のグループと等しい部分文字列と一致します。|  
+|`\b`|ワード境界に一致します。|  
+  
+ <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドは、正規表現オプションを <xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> に設定して呼び出されます。  したがって、照合操作では大文字と小文字が区別されず、この例では部分文字列 "This this" が重複として識別されます。  
+  
+ 入力文字列には部分文字列 "this?  This" が含まれています。  ただし、句読点が介在するので、重複として識別されません。  
+  
+### 例 3: カルチャに依存した正規表現の動的な構築  
+ ここでは、正規表現による強力なテキスト処理と、.NET Framework の柔軟なグローバリゼーション機能とを組み合わせて使用する例を紹介します。  この例では、システムの現在のカルチャで用いられている通貨値の形式を調べるために、<xref:System.Globalization.NumberFormatInfo> オブジェクトが使用されています。  さらに、その情報を基に、テキストから通貨値を抽出する正規表現を動的に構築します。  検出された一致ごとに、数値文字列のみを含んだサブグループを抽出し、<xref:System.Decimal> 値に変換して、通算の合計を計算します。  
+  
+ [!code-csharp[Conceptual.Regex#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex/cs/example.cs#1)]
+ [!code-vb[Conceptual.Regex#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex/vb/example.vb#1)]  
+  
+ 現在 "英語 \- 米国" \(en\-US\) カルチャが使用されているコンピューターでは、`\$\s*[-+]?([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)` という正規表現が動的に作成されます。  この正規表現パターンは、次のように解釈できます。  
+  
+|||  
+|-|-|  
+|`\$`|入力文字列に含まれる単一のドル記号 \($\) を検索します。  この正規表現パターン文字列に使用されている円記号は、ドル記号を正規表現のアンカーではなく、文字として扱うことを意味します。  ドル記号 \($\) を単独で指定した場合、正規表現エンジンは、比較の開始位置を文字列の終端に設定します。 現在のカルチャの通貨記号が正規表現記号として解釈されるのを防ぐため、この例では、<xref:System.Text.RegularExpressions.Regex.Escape%2A> メソッドを呼び出して文字をエスケープしています。|  
+|`\s*`|空白文字の 0 回以上の繰り返しを検索します。|  
+|`[-+]?`|正の符号または負の符号の 0 回または 1 回の繰り返しを検索します。|  
+|`([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)`|外側の丸かっこで囲まれている表現は、キャプチャ グループまたは部分式として定義されます。  一致が見つかった場合、その一致した文字列の、この部分に関する情報が、<xref:System.Text.RegularExpressions.Group> プロパティから返された <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトの 2 つ目の <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> オブジェクトから取得できます   \(コレクションの 1 つ目の要素は、一致した文字列全体を表します\)。|  
+|`[0-9]{0,3}`|10 進数字 \(0 ～ 9\) の 0 回以上、3 回以下の繰り返しを検索します。|  
+|`(,[0-9]{3})*`|桁区切り記号と 3 桁の 10 進数字の 0 回以上の繰り返しを検索します。|  
+|`\.`|単一の小数点を検索します。|  
+|`[0-9]+`|10 進数字の 1 回以上の繰り返しを検索します。|  
+|`(\.[0-9]+)?`|小数点と 1 桁以上の数字の 0 回または 1 回の繰り返しを検索します。|  
+  
+ 以上の各サブパターンが入力文字列内に見つかると一致と判断され、その一致に関する情報を含んだ <xref:System.Text.RegularExpressions.Match> オブジェクトが <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトに追加されます。  
+  
+## 関連トピック  
   
-  .NET では、正規表現のパターンが特殊な構文または言語で定義されます。この構文または言語には、Perl 5 の正規表現と互換性があるほか、右から左への一致処理など、いくつかの機能が追加されています。 詳細については、「[正規表現言語 - クイック リファレンス](quick-ref.md)」をご覧ください。
+|タイトル|説明|  
+|----------|--------|  
+|[正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)|正規表現を定義するために使う一連の文字、演算子、および構成体について説明します。|  
+|[正規表現のオブジェクト モデル](../../../docs/standard/base-types/the-regular-expression-object-model.md)|正規表現クラスの使用方法について詳しく説明し、コード例を示します。|  
+|[正規表現の動作の詳細](../../../docs/standard/base-types/details-of-regular-expression-behavior.md)|.NET Framework 正規表現の機能と動作について説明します。|  
+|[正規表現の例](../../../docs/standard/base-types/regular-expression-examples.md)|正規表現の一般的な使用方法を示すコード例が用意されています。|  
   
-* 正規表現パターンの解析対象となるテキスト。
-
-[Regex](xref:System.Text.RegularExpressions.Regex) クラスのメソッドを使用すると、次のような処理を実行できます。
-
-* 入力されたテキストに特定の正規表現パターンが出現するかどうかを調べるには、[Regex.IsMatch](xref:System.Text.RegularExpressions.Regex.IsMatch(System.String)) メソッドを呼び出します。 テキストを検証するために [IsMatch](xref:System.Text.RegularExpressions.Regex.IsMatch(System.String)) メソッドを使用する例については、「[方法: 文字列が有効な電子メール形式であるかどうかを検証する](verify-format.md)」をご覧ください。
-
-* 正規表現パターンと一致したテキストを&1; つまたはすべて取得するには、[Regex.Match](xref:System.Text.RegularExpressions.Regex.Match(System.String)) メソッドまたは [Regex.Matches](xref:System.Text.RegularExpressions.Regex.Matches(System.String)) メソッドを呼び出します。 前者は、一致したテキストの情報を保持する [System.Text.RegularExpressions.Match](xref:System.Text.RegularExpressions.Match) オブジェクトを返します。 後者は、解析対象のテキストに見つかった各一致につき&1; つの [System.Text.RegularExpressions.Match](xref:System.Text.RegularExpressions.Match) オブジェクトを含む [MatchCollection](xref:System.Text.RegularExpressions.MatchCollection) オブジェクトを返します。 
-
-* 正規表現パターンと一致したテキストを置換するには、[Regex.Replace](xref:System.Text.RegularExpressions.Regex.Replace(System.String,System.String)) メソッドを呼び出します。 [Replace](xref:System.Text.RegularExpressions.Regex.Replace(System.String,System.String)) メソッドを使用して日付形式を変更したり文字列から無効な文字を削除したりする例については、「[方法: 文字列から無効な文字を取り除く](strip-characters.md)」および「[正規表現の例: 日付形式の変更](changing-formats.md)」をご覧ください。
-
-正規表現のオブジェクト モデルの概要については、「[正規表現のオブジェクト モデル](object-model.md)」をご覧ください。
-
-正規表現言語の詳細については、「[正規表現言語 - クイック リファレンス](quick-ref.md)」をご覧ください。
-
-## <a name="regular-expression-examples"></a>正規表現の例
-
-[String](xref:System.String) クラスには、より大きな文字列内のリテラル文字列を検索する際に使用できる文字列の検索メソッドと置換メソッドが数多く含まれています。 正規表現は、次の例に示すように、文字列内の部分文字列のいずれかを検索する場合、または文字列内のパターンを識別する場合に最も役立ちます。 
-
-### <a name="example-1-replacing-substrings"></a>例 1: 部分文字列の置換
-
-氏名に敬称 (Mr.、Mrs.、Miss、または Ms.) が付いている場合がある名前が、宛先リストに含まれるとします。 そのリストから封筒のラベルを生成する場合に敬称が含まれないようにするには、次の例に示すように、正規表現を使用して敬称を削除します。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      string pattern = "(Mr\\.? |Mrs\\.? |Miss |Ms\\.? )";
-      string[] names = { "Mr. Henry Hunt", "Ms. Sara Samuels", 
-                         "Abraham Adams", "Ms. Nicole Norris" };
-      foreach (string name in names)
-         Console.WriteLine(Regex.Replace(name, pattern, String.Empty));
-   }
-}
-// The example displays the following output:
-//    Henry Hunt
-//    Sara Samuels
-//    Abraham Adams
-//    Nicole Norris
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module Example
-   Public Sub Main()
-      Dim pattern As String = "(Mr\.? |Mrs\.? |Miss |Ms\.? )"
-      Dim names() As String = { "Mr. Henry Hunt", "Ms. Sara Samuels", _
-                                "Abraham Adams", "Ms. Nicole Norris" }
-      For Each name As String In names
-         Console.WriteLine(Regex.Replace(name, pattern, String.Empty))
-      Next                                
-   End Sub
-End Module
-' The example displays the following output:
-'    Henry Hunt
-'    Sara Samuels
-'    Abraham Adams
-'    Nicole Norris
-```
-
-正規表現パターン `(Mr\.? |Mrs\.? |Miss |Ms\.? )` は、"Mr "、"Mr. "、"Mrs "、"Mrs. "、"Miss "、"Ms"、または "Ms. " の出現と一致します。 [Regex.Replace](xref:System.Text.RegularExpressions.Regex.Replace(System.String,System.String)) メソッドを呼び出すと、一致する文字列が [String.Empty](xref:System.String.Empty) に置き換えられます。つまり、元の文字列から削除されます。
-
-### <a name="example-2-identifying-duplicated-words"></a>例 2: 重複する単語の識別
-
-記述者が単語を誤って重複入力するというエラーがよくあります。 次の例に示すように、正規表現を使用して重複する単語を識別できます。
-
-```csharp
-using System;
-using System.Text.RegularExpressions;
-
-public class Class1
-{
-   public static void Main()
-   {
-      string pattern = @"\b(\w+?)\s\1\b";
-      string input = "This this is a nice day. What about this? This tastes good. I saw a a dog.";
-      foreach (Match match in Regex.Matches(input, pattern, RegexOptions.IgnoreCase))
-         Console.WriteLine("{0} (duplicates '{1}') at position {2}", 
-                           match.Value, match.Groups[1].Value, match.Index);
-   }
-}
-// The example displays the following output:
-//       This this (duplicates 'This)' at position 0
-//       a a (duplicates 'a)' at position 66
-```
-
-```vb
-Imports System.Text.RegularExpressions
-
-Module modMain
-   Public Sub Main()
-      Dim pattern As String = "\b(\w+?)\s\1\b"
-      Dim input As String = "This this is a nice day. What about this? This tastes good. I saw a a dog."
-      For Each match As Match In Regex.Matches(input, pattern, RegexOptions.IgnoreCase)
-         Console.WriteLine("{0} (duplicates '{1}') at position {2}", _
-                           match.Value, match.Groups(1).Value, match.Index)
-      Next
-   End Sub
-End Module
-' The example displays the following output:
-'       This this (duplicates 'This)' at position 0
-'       a a (duplicates 'a)' at position 66
-```
-
-正規表現パターン `\b(\w+?)\s\1\b` は、次のように解釈できます。
-
-構文 | 説明
------- | -------
-`\b` | ワード境界から開始します。
-`(\w+?)` | 1 つ以上 (ただし、できるだけ少ない文字数) の単語文字と一致します。 同時に、`\1` というグループを形成します。
-`\s` | 空白文字と一致します。
-`\1` | `\1` という名前のグループと等しい部分文字列と一致します。
-`\b` | ワード境界に一致します。
-
-[Regex.Matches](xref:System.Text.RegularExpressions.Regex.Matches(System.String,System.String,System.Text.RegularExpressions.RegexOptions)) メソッドは、正規表現オプションを [RegexOptions.IgnoreCase](xref:System.Text.RegularExpressions.RegexOptions.IgnoreCase) に設定して呼び出されます。 したがって、照合操作では大文字と小文字が区別されず、この例では部分文字列 "This this" が重複として識別されます。
-
-入力文字列には部分文字列 "this? This" が含まれています。 ただし、句読点が介在するので、重複として識別されません。
-
-### <a name="example-3-dynamically-building-a-culture-sensitive-regular-expression"></a>例 3: カルチャに依存した正規表現の動的な構築
-
-ここでは、正規表現による強力なテキスト処理と、.NET の柔軟なグローバリゼーション機能を組み合わせて使用する例を紹介します。 この例では、システムの現在のカルチャで用いられている通貨値の形式を調べるために、[NumberFormatInfo](xref:System.Globalization.NumberFormatInfo) オブジェクトが使用されています。 さらに、その情報を基に、テキストから通貨値を抽出する正規表現を動的に構築します。 検出された一致ごとに、数値文字列のみを含んだサブグループを抽出し、[Decimal](xref:System.Decimal) 値に変換して、通算の合計を計算します。 
-
-```csharp
-using System;
-using System.Collections.Generic;
-using System.Globalization;
-using System.Text.RegularExpressions;
-
-public class Example
-{
-   public static void Main()
-   {
-      // Define text to be parsed.
-      string input = "Office expenses on 2/13/2008:\n" + 
-                     "Paper (500 sheets)                      $3.95\n" + 
-                     "Pencils (box of 10)                     $1.00\n" + 
-                     "Pens (box of 10)                        $4.49\n" + 
-                     "Erasers                                 $2.19\n" + 
-                     "Ink jet printer                        $69.95\n\n" + 
-                     "Total Expenses                        $ 81.58\n"; 
-
-      // Get current culture's NumberFormatInfo object.
-      NumberFormatInfo nfi = CultureInfo.CurrentCulture.NumberFormat;
-      // Assign needed property values to variables.
-      string currencySymbol = nfi.CurrencySymbol;
-      bool symbolPrecedesIfPositive = nfi.CurrencyPositivePattern % 2 == 0;
-      string groupSeparator = nfi.CurrencyGroupSeparator;
-      string decimalSeparator = nfi.CurrencyDecimalSeparator;
-
-      // Form regular expression pattern.
-      string pattern = Regex.Escape( symbolPrecedesIfPositive ? currencySymbol : "") + 
-                       @"\s*[-+]?" + "([0-9]{0,3}(" + groupSeparator + "[0-9]{3})*(" + 
-                       Regex.Escape(decimalSeparator) + "[0-9]+)?)" + 
-                       (! symbolPrecedesIfPositive ? currencySymbol : ""); 
-      Console.WriteLine( "The regular expression pattern is:");
-      Console.WriteLine("   " + pattern);      
-
-      // Get text that matches regular expression pattern.
-      MatchCollection matches = Regex.Matches(input, pattern, 
-                                              RegexOptions.IgnorePatternWhitespace);               
-      Console.WriteLine("Found {0} matches.", matches.Count); 
-
-      // Get numeric string, convert it to a value, and add it to List object.
-      List<decimal> expenses = new List<Decimal>();
-
-      foreach (Match match in matches)
-         expenses.Add(Decimal.Parse(match.Groups[1].Value));      
-
-      // Determine whether total is present and if present, whether it is correct.
-      decimal total = 0;
-      foreach (decimal value in expenses)
-         total += value;
-
-      if (total / 2 == expenses[expenses.Count - 1]) 
-         Console.WriteLine("The expenses total {0:C2}.", expenses[expenses.Count - 1]);
-      else
-         Console.WriteLine("The expenses total {0:C2}.", total);
-   }  
-}
-// The example displays the following output:
-//       The regular expression pattern is:
-//          \$\s*[-+]?([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)
-//       Found 6 matches.
-//       The expenses total $81.58.
-```
-
-```vb
-Imports System.Collections.Generic
-Imports System.Globalization
-Imports System.Text.RegularExpressions
-
-Public Module Example
-   Public Sub Main()
-      ' Define text to be parsed.
-      Dim input As String = "Office expenses on 2/13/2008:" + vbCrLf + _
-                            "Paper (500 sheets)                      $3.95" + vbCrLf + _
-                            "Pencils (box of 10)                     $1.00" + vbCrLf + _
-                            "Pens (box of 10)                        $4.49" + vbCrLf + _
-                            "Erasers                                 $2.19" + vbCrLf + _
-                            "Ink jet printer                        $69.95" + vbCrLf + vbCrLf + _
-                            "Total Expenses                        $ 81.58" + vbCrLf
-      ' Get current culture's NumberFormatInfo object.
-      Dim nfi As NumberFormatInfo = CultureInfo.CurrentCulture.NumberFormat
-      ' Assign needed property values to variables.
-      Dim currencySymbol As String = nfi.CurrencySymbol
-      Dim symbolPrecedesIfPositive As Boolean = CBool(nfi.CurrencyPositivePattern Mod 2 = 0)
-      Dim groupSeparator As String = nfi.CurrencyGroupSeparator
-      Dim decimalSeparator As String = nfi.CurrencyDecimalSeparator
-
-      ' Form regular expression pattern.
-      Dim pattern As String = Regex.Escape(CStr(IIf(symbolPrecedesIfPositive, currencySymbol, ""))) + _
-                              "\s*[-+]?" + "([0-9]{0,3}(" + groupSeparator + "[0-9]{3})*(" + _
-                              Regex.Escape(decimalSeparator) + "[0-9]+)?)" + _
-                              CStr(IIf(Not symbolPrecedesIfPositive, currencySymbol, "")) 
-      Console.WriteLine("The regular expression pattern is: ")
-      Console.WriteLine("   " + pattern)      
-
-      ' Get text that matches regular expression pattern.
-      Dim matches As MatchCollection = Regex.Matches(input, pattern, RegexOptions.IgnorePatternWhitespace)               
-      Console.WriteLine("Found {0} matches. ", matches.Count)
-
-      ' Get numeric string, convert it to a value, and add it to List object.
-      Dim expenses As New List(Of Decimal)
-
-      For Each match As Match In matches
-         expenses.Add(Decimal.Parse(match.Groups.Item(1).Value))      
-      Next
-
-      ' Determine whether total is present and if present, whether it is correct.
-      Dim total As Decimal
-      For Each value As Decimal In expenses
-         total += value
-      Next
-
-      If total / 2 = expenses(expenses.Count - 1) Then
-         Console.WriteLine("The expenses total {0:C2}.", expenses(expenses.Count - 1))
-      Else
-         Console.WriteLine("The expenses total {0:C2}.", total)
-      End If   
-   End Sub
-End Module
-' The example displays the following output:
-'       The regular expression pattern is:
-'          \$\s*[-+]?([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)
-'       Found 6 matches.
-'       The expenses total $81.58.
-```
-
-現在 "英語 - 米国" (en-US) カルチャが使用されているコンピューターでは、`\$\s*[-+]?([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)` という正規表現が動的に作成されます。 この正規表現パターンは、次のように解釈できます。
-
-構文 | 説明
------- | -------
-`\$` | 入力文字列に含まれる単一のドル記号 ($) を検索します。 この正規表現パターン文字列に使用されている円記号は、ドル記号を正規表現のアンカーではなく、文字として扱うことを意味します。 ドル記号 ($) を単独で指定した場合、正規表現エンジンは、比較の開始位置を文字列の終端に設定します。現在のカルチャの通貨記号が正規表現記号として解釈されるのを防ぐため、この例では、[Escape](xref:System.Text.RegularExpressions.Regex.Escape(System.String)) メソッドを呼び出して文字をエスケープしています。
-`\s*` | 空白文字の&0; 回以上の繰り返しを検索します。
-`[-+]?` | 正の符号または負の符号の&0; 回または&1; 回の繰り返しを検索します。
-`([0-9]{0,3}(,[0-9]{3})*(\.[0-9]+)?)` | 外側の丸かっこで囲まれている表現は、キャプチャ グループまたは部分式として定義されます。 一致が見つかった場合、一致文字列のその部分に関する情報を、[Match.Groups](xref:System.Text.RegularExpressions.Match.Groups) プロパティから返された [GroupCollection](xref:System.Text.RegularExpressions.GroupCollection) オブジェクトの&2; つ目の [Group](xref:System.Text.RegularExpressions.Group) オブジェクトから取得できます。 (コレクションの&1; つ目の要素は、一致した文字列全体を表します)。
-`[0-9]{0,3}` | 10 進数字 (0 ～ 9) の 0 回以上、3 回以下の繰り返しを検索します。
-`(,[0-9]{3})*` | 桁区切り記号と&3; 桁の&10; 進数字の&0; 回以上の繰り返しを検索します。
-`\.` | 単一の小数点を検索します。
-`[0-9]+` | 10 進数字の&1; 回以上の繰り返しを検索します。
-`(\.[0-9]+)?` | 小数点と&1; 桁以上の数字の&0; 回または&1; 回の繰り返しを検索します。
-
-## <a name="related-topics"></a>関連トピック
-
-タイトル | 説明
------ | -----------
-[正規表現言語 - クイック リファレンス](quick-ref.md) | 正規表現を定義するために使う一連の文字、演算子、および構成体について説明します。
-[正規表現のオブジェクト モデル](object-model.md) | 正規表現クラスの使用方法について詳しく説明し、コード例を示します。
-[正規表現の動作の詳細](regex-behavior.md) | .NET の正規表現の機能と動作について説明します。
-[正規表現の例](regex-examples.md) | 正規表現の一般的な使用方法を示すコード例が用意されています。
-
-
-## <a name="reference"></a>参照
-
-[System.Text.RegularExpressions](xref:System.Text.RegularExpressions)
-
-[System.Text.RegularExpressions.Regex](xref:System.Text.RegularExpressions.Regex)
-
-
+## 参照  
+ <xref:System.Text.RegularExpressions?displayProperty=fullName>   
+ <xref:System.Text.RegularExpressions.Regex?displayProperty=fullName>  
+ [Regular Expressions \- Quick Reference \(Word 形式でダウンロード\)](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.docx)  
+ [Regular Expressions \- Quick Reference \(PDF 形式でダウンロード\)](http://download.microsoft.com/download/D/2/4/D240EBF6-A9BA-4E4F-A63F-AEB6DA0B921C/Regular%20expressions%20quick%20reference.pdf)
\ No newline at end of file
diff --git a/docs/standard/base-types/standard-date-and-time-format-strings.md b/docs/standard/base-types/standard-date-and-time-format-strings.md
new file mode 100644
index 00000000000..f8065ed0f6a
--- /dev/null
+++ b/docs/standard/base-types/standard-date-and-time-format-strings.md
@@ -0,0 +1,421 @@
+---
+title: "標準の日時書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "日付 [.NET Framework], 書式指定"
+  - "書式指定子, 日付と時刻"
+  - "書式指定子, 標準の日付と時刻"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 日付"
+  - "書式指定 [.NET Framework], 時間"
+  - "標準の日付と時刻の書式指定文字列"
+  - "標準の DateTime の書式指定文字列"
+  - "標準の書式指定文字列, 日付と時刻"
+  - "時刻 [.NET Framework], 書式指定"
+ms.assetid: bb79761a-ca08-44ee-b142-b06b3e2fc22b
+caps.latest.revision: 92
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 90
+---
+# 標準の日時書式指定文字列
+標準の日時書式指定文字列は、単一の書式指定子を使用して日付と時刻の値のテキスト表現を定義します。 空白を含む複数の文字で構成される日時書式文字列は、カスタム日時書式文字列として解釈されます。詳しくは、「[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)」をご覧ください。 標準またはカスタムの書式指定文字列には、次の 2 とおりの使用方法があります。  
+  
+-   書式設定操作によって生成される文字列を定義する。  
+  
+-   解析操作によって <xref:System.DateTime> 値または <xref:System.DateTimeOffset> 値に変換できる日付と時刻の値のテキスト表現を定義する。  
+  
+ 標準の日時書式指定文字列は、<xref:System.DateTime> 値で使用することも、<xref:System.DateTimeOffset> 値で使用することもできます。  
+  
+> [!TIP]
+>  [書式指定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)をダウンロードできます。このアプリケーションを使用すると、書式指定文字列を数値または日付と時刻の値に適用して、結果の文字列を表示できます。  
+  
+<a name="table"></a> 標準日時書式指定子を次の表に示します。 特に明記されない限り、特定の標準日時書式指定子は、<xref:System.DateTime> 値で使用しても、<xref:System.DateTimeOffset> 値で使用してもまったく同じ文字列形式を生成します。 標準の日時書式指定文字列の使用方法については、「[メモ](#Notes)」を参照してください。  
+  
+|書式指定子|説明|例|  
+|-----------|--------|-------|  
+|"d"|短い形式の日付パターン。<br /><br /> 詳細については、「[短い形式の日付 \("d"\) 書式指定子](#ShortDate)」を参照してください。|2009\-06\-15T13:45:30 \-\> 6\/15\/2009 \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15\/06\/2009 \(fr\-FR\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 2009\/06\/15 \(ja\-JP\)|  
+|"D"|長い形式の日付パターン。<br /><br /> 詳細については、「[長い形式の日付 \("D"\) 書式指定子](#LongDate)」を参照してください。|2009\-06\-15T13:45:30 \-\> Monday, June 15, 2009 \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15 июня 2009 г. \(ru\-RU\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Montag, 15. Juni 2009 \(de\-DE\)|  
+|"f"|完全な日付と時刻のパターン \(短い形式の時刻\)。<br /><br /> 詳細については、「[完全な日付と短い形式の時刻 \("f"\) 書式指定子](#FullDateShortTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> Monday, June 15, 2009 1:45 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> den 15 juni 2009 13:45 \(sv\-SE\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Δευτέρα, 15 Ιουνίου 2009 1:45 μμ \(el\-GR\)|  
+|"F"|完全な日付と時刻のパターン \(長い形式の時刻\)。<br /><br /> 詳細については、「[完全な日付と長い形式の時刻 \("F"\) 書式指定子](#FullDateLongTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> Monday, June 15, 2009 1:45:30 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> den 15 juni 2009 13:45:30 \(sv\-SE\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Δευτέρα, 15 Ιουνίου 2009 1:45:30 μμ \(el\-GR\)|  
+|"g"|一般の日付と時刻のパターン \(短い形式の時刻\)。<br /><br /> 詳細については、「[一般の日付と短い形式の時刻 \("g"\) 書式指定子](#GeneralDateShortTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> 6\/15\/2009 1:45 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15\/06\/2009 13:45 \(es\-ES\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 2009\/6\/15 13:45 \(zh\-CN\)|  
+|"G"|一般の日付と時刻のパターン \(長い形式の時刻\)。<br /><br /> 詳細については、「[一般の日付と長い形式の時刻 \("G"\) 書式指定子](#GeneralDateLongTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> 6\/15\/2009 1:45:30 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15\/06\/2009 13:45:30 \(es\-ES\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 2009\/6\/15 13:45:30 \(zh\-CN\)|  
+|"M"、"m"|月日パターン。<br /><br /> 詳細については、「[月 \("M"、"m"\) 書式指定子](#MonthDay)」を参照してください。|2009\-06\-15T13:45:30 \-\> June 15 \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15. juni \(da\-DK\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 15 Juni \(id\-ID\)|  
+|"O"、"o"|ラウンドトリップする日付と時刻のパターン。<br /><br /> 詳細については、「[ラウンドトリップ \("O"、"o"\) 書式指定子](#Roundtrip)」を参照してください。|<xref:System.DateTime> の値:<br /><br /> 2009\-06\-15T13:45:30 \(DateTimeKind.Local\) \-\-\> 2009\-06\-15T13:45:30.0000000\-07:00<br /><br /> 2009\-06\-15T13:45:30 \(DateTimeKind.Utc\) \-\-\> 2009\-06\-15T13:45:30.0000000Z<br /><br /> 2009\-06\-15T13:45:30 \(DateTimeKind.Unspecified\) \-\-\> 2009\-06\-15T13:45:30.0000000<br /><br /> <xref:System.DateTimeOffset> の値:<br /><br /> 2009\-06\-15T13:45:30\-07:00 \-\-\> 2009\-06\-15T13:45:30.0000000\-07:00|  
+|"R"、"r"|RFC1123 パターン。<br /><br /> 詳細については、「[RFC1123 \("R"、"r"\) 書式指定子](#RFC1123)」を参照してください。|2009\-06\-15T13:45:30 \-\> Mon, 15 Jun 2009 20:45:30 GMT|  
+|"s"|並べ替え可能な日付と時刻のパターン。<br /><br /> 詳細については、「[並べ替え可能な日付と時刻 \("s"\) 書式指定子](#Sortable)」を参照してください。|2009\-06\-15T13:45:30 \(DateTimeKind.Local\) \-\> 2009\-06\-15T13:45:30<br /><br /> 2009\-06\-15T13:45:30 \(DateTimeKind.Utc\) \-\> 2009\-06\-15T13:45:30|  
+|"t"|短い形式の時刻パターン。<br /><br /> 詳細については、「[短い形式の時刻 \("t"\) 書式指定子](#ShortTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> 1:45 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 13:45 \(hr\-HR\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 01:45 م \(ar\-EG\)|  
+|"T"|長い形式の時刻パターン。<br /><br /> 詳細については、「[長い形式の時刻 \("T"\) 書式指定子](#LongTime)」を参照してください。|2009\-06\-15T13:45:30 \-\> 1:45:30 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 13:45:30 \(hr\-HR\)<br /><br /> 2009\-06\-15T13:45:30 \-\> 01:45:30 م \(ar\-EG\)|  
+|"u"|並べ替え可能な日付と時刻のパターン \(世界時刻\)。<br /><br /> 詳細については、「[世界共通の並べ替え可能な日付と時刻 \("u"\) 書式指定子](#UniversalSortable)」を参照してください。|<xref:System.DateTime> 値の場合: 2009\-06\-15T13:45:30 \-\> 2009\-06\-15 13:45:30Z<br /><br /> <xref:System.DateTimeOffset> 値の場合: 2009\-06\-15T13:45:30 \-\> 2009\-06\-15 20:45:30Z|  
+|"U"|完全な日付と時刻のパターン \(世界時刻\)。<br /><br /> 詳細については、「[世界共通の完全な日付と時刻 \("U"\) 書式指定子](#UniversalFull)」を参照してください。|2009\-06\-15T13:45:30 \-\> Monday, June 15, 2009 8:45:30 PM \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> den 15 juni 2009 20:45:30 \(sv\-SE\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Δευτέρα, 15 Ιουνίου 2009 8:45:30 μμ \(el\-GR\)|  
+|"Y"、"y"|年月パターン。<br /><br /> 詳細については、「[年月 \("Y"\) 書式指定子](#YearMonth)」を参照してください。|2009\-06\-15T13:45:30 \-\> June, 2009 \(en\-US\)<br /><br /> 2009\-06\-15T13:45:30 \-\> juni 2009 \(da\-DK\)<br /><br /> 2009\-06\-15T13:45:30 \-\> Juni 2009 \(id\-ID\)|  
+|その他の 1 文字|未定義の指定子。|ランタイム <xref:System.FormatException> をスローします。|  
+  
+## 標準書式指定文字列の動作  
+ 書式設定操作では、標準書式指定文字列はカスタム書式指定文字列のエイリアスにすぎません。 エイリアスを使ってカスタム書式指定文字列を表すことの利点は、カスタム書式指定文字列はそれ自体が変化する場合があるのに対し、エイリアスは不変であるという点です。 通常、日付と時刻の値の文字列形式はカルチャによって変わるため、この点は重要です。 たとえば、"d" 標準書式指定文字列は、日付と時刻の値を短い日付形式のパターンで表示することを意味します。 インバリアント カルチャでは、このパターンは "MM\/dd\/yyyy" になります。 fr\-FR カルチャでは、これが "dd\/MM\/yyyy" になります。 ja\-JP カルチャでは、これが "yyyy\/MM\/dd" になります。  
+  
+ 書式設定操作の標準書式指定文字列が特定のカルチャのカスタム書式指定文字列に対応付けられている場合は、使用するカスタム書式指定文字列に該当するカルチャを次のいずれかの方法で定義できます。  
+  
+-   既定の \(現在の\) カルチャを使用できます。 次の例では、現在のカルチャの短い日付形式を使って日付を表示します。 この場合、現在のカルチャは en\-US です。  
+  
+     [!code-csharp[System.DateTime.Conceptual.Formatting#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/cs/StandardFormats1.cs#1)]
+     [!code-vb[System.DateTime.Conceptual.Formatting#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/vb/StandardFormats1.vb#1)]  
+  
+-   使用する書式のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトを、<xref:System.IFormatProvider> パラメーターを持つメソッドに渡すことができます。 次の例では、pt\-BR カルチャの短い日付形式を使って日付を表示します。  
+  
+     [!code-csharp[System.DateTime.Conceptual.Formatting#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/cs/StandardFormats1.cs#2)]
+     [!code-vb[System.DateTime.Conceptual.Formatting#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/vb/StandardFormats1.vb#2)]  
+  
+-   書式情報を提供する <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを、<xref:System.IFormatProvider> パラメーターを持つメソッドに渡すことができます。 次の例では、hr\-HR カルチャの <xref:System.Globalization.DateTimeFormatInfo> オブジェクトに基づく短い日付形式で日付を表示します。  
+  
+     [!code-csharp[System.DateTime.Conceptual.Formatting#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/cs/StandardFormats1.cs#3)]
+     [!code-vb[System.DateTime.Conceptual.Formatting#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTime.Conceptual.Formatting/vb/StandardFormats1.vb#3)]  
+  
+> [!NOTE]
+>  日付と時刻の値の書式設定に使用するパターンまたは文字列のカスタマイズの詳細については、<xref:System.Globalization.NumberFormatInfo> クラスに関するトピックを参照してください。  
+  
+ 標準書式指定文字列には、長いカスタム書式指定文字列に代わる、不変の省略形としての利用価値もあります。 このカテゴリに該当する標準書式指定文字列は、"O" \(または "o"\)、"R" \(または "r"\)、"s"、"u" の 4 つです。 これらの文字列は、インバリアント カルチャで定義されたカスタム書式指定文字列に対応します。 これらの書式指定文字列によって生成される日時値の文字列形式は、カルチャに関係なく一定です。 次の表で、この 4 つの標準日時書式指定文字列について説明します。  
+  
+|標準書式指定文字列|DateTimeFormatInfo.InvariantInfo プロパティによる定義|カスタム書式指定文字列|  
+|---------------|-------------------------------------------------|-----------------|  
+|"O" または "o"|なし|yyyy'\-'MM'\-'dd'T'HH':'mm':'ss'.'fffffffzz|  
+|"R" または "r"|<xref:System.Globalization.DateTimeFormatInfo.RFC1123Pattern%2A>|ddd, dd MMM yyyy HH':'mm':'ss 'GMT'|  
+|"s"|<xref:System.Globalization.DateTimeFormatInfo.SortableDateTimePattern%2A>|yyyy'\-'MM'\-'dd'T'HH':'mm':'ss|  
+|"u"|<xref:System.Globalization.DateTimeFormatInfo.UniversalSortableDateTimePattern%2A>|yyyy'\-'MM'\-'dd HH':'mm':'ss'Z'|  
+  
+ 標準書式指定文字列は、解析操作の <xref:System.DateTime.ParseExact%2A?displayProperty=fullName> メソッドまたは <xref:System.DateTimeOffset.ParseExact%2A?displayProperty=fullName> メソッドで使用することもできます。これらのメソッドでは、解析操作が成功するための特定のパターンに入力文字列が完全に一致している必要があります。 標準書式指定文字列の多くは複数のカスタム書式指定文字列に対応付けられるため、日付と時刻の値はさまざまな書式で表されることがありますが、解析操作は成功します。<xref:System.Globalization.DateTimeFormatInfo.GetAllDateTimePatterns%28System.Char%29?displayProperty=fullName> メソッドを呼び出すことにより、標準書式指定文字列に対応する 1 つまたは複数のカスタム書式指定文字列を確認できます。 次の例では、"d" \(短い日付形式のパターン\) 標準書式指定文字列に対応付けられているカスタム書式指定文字列を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#17](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/stdandparsing1.cs#17)]
+ [!code-vb[Formatting.DateAndTime.Standard#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/stdandparsing1.vb#17)]  
+  
+ 以降では、<xref:System.DateTime> 値および <xref:System.DateTimeOffset> 値の標準書式指定子について説明します。  
+  
+<a name="ShortDate"></a>   
+## 短い形式の日付 \("d"\) 書式指定子  
+ "d" 標準書式指定子は、特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャの <xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A> プロパティによって返されるカスタム書式指定文字列は "MM\/dd\/yyyy" です。  
+  
+ 返される文字列の書式を制御する <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A>|日付の構成要素、つまり年、月、および日を区切る文字列を定義します。|  
+  
+ 次の例では、"d" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#1)]
+ [!code-vb[Formatting.DateAndTime.Standard#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#1)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="LongDate"></a>   
+## 長い形式の日付 \("D"\) 書式指定子  
+ "D" 標準書式指定子は、現在の <xref:System.Globalization.DateTimeFormatInfo.LongDatePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "dddd, dd MMMM yyyy" です。  
+  
+ 返される文字列の書式を制御する <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.LongDatePattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DayNames%2A>|結果文字列に含まれるローカライズされた日付の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+  
+ 次の例では、"D" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#2)]
+ [!code-vb[Formatting.DateAndTime.Standard#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#2)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FullDateShortTime"></a>   
+## 完全な日付と短い形式の時刻 \("f"\) 書式指定子  
+ "f" 標準書式指定子は、長い形式の日付 \("D"\) パターンと短い形式の時刻 \("t"\) パターンを空白で区切って組み合わせて表します。  
+  
+ 結果文字列は、特定の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.LongDatePattern%2A?displayProperty=fullName> プロパティおよび <xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A?displayProperty=fullName> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.LongDatePattern%2A>|結果文字列の日付要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A>|結果文字列の時刻要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DayNames%2A>|結果文字列に含まれるローカライズされた日付の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"f" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#3)]
+ [!code-vb[Formatting.DateAndTime.Standard#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#3)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FullDateLongTime"></a>   
+## 完全な日付と長い形式の時刻 \("F"\) 書式指定子  
+ "F" 標準書式指定子は、現在の <xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "dddd, dd MMMM yyyy HH:mm:ss" です。  
+  
+ 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DayNames%2A>|結果文字列に含まれるローカライズされた日付の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"F" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#4)]
+ [!code-vb[Formatting.DateAndTime.Standard#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#4)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="GeneralDateShortTime"></a>   
+## 一般の日付と短い形式の時刻 \("g"\) 書式指定子  
+ "g" 標準書式指定子は、短い形式の日付 \("d"\) パターンと短い形式の時刻 \("t"\) パターンを空白で区切って組み合わせて表します。  
+  
+ 結果文字列は、特定の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A?displayProperty=fullName> プロパティおよび <xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A?displayProperty=fullName> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A>|結果文字列の日付要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A>|結果文字列の時刻要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A>|日付の構成要素、つまり年、月、および日を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"g" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#5)]
+ [!code-vb[Formatting.DateAndTime.Standard#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="GeneralDateLongTime"></a>   
+## 一般の日付と長い形式の時刻 \("G"\) 書式指定子  
+ "G" 標準書式指定子は、短い形式の日付 \("d"\) パターンと長い形式の時刻 \("T"\) パターンを空白で区切って組み合わせて表します。  
+  
+ 結果文字列は、特定の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A?displayProperty=fullName> プロパティおよび <xref:System.Globalization.DateTimeFormatInfo.LongTimePattern%2A?displayProperty=fullName> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortDatePattern%2A>|結果文字列の日付要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.LongTimePattern%2A>|結果文字列の時刻要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DateSeparator%2A>|日付の構成要素、つまり年、月、および日を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"G" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#6)]
+ [!code-vb[Formatting.DateAndTime.Standard#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#6)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="MonthDay"></a>   
+## 月 \("M"、"m"\) 書式指定子  
+ "M" または "m" 標準書式指定子は、現在の <xref:System.Globalization.DateTimeFormatInfo.MonthDayPattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "MMMM dd" です。  
+  
+ 返される文字列の書式を制御する <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthDayPattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+  
+ 次の例では、"m" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#7)]
+ [!code-vb[Formatting.DateAndTime.Standard#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="Roundtrip"></a>   
+## ラウンドトリップ \("O"、"o"\) 書式指定子  
+ "O" または "o" 標準書式指定子は、タイム ゾーン情報を保持するパターンを使用するカスタム日時書式指定文字列を表し、ISO 8601 に準拠する結果文字列を生成します。 この書式指定子は、<xref:System.DateTime> 値の日付と時刻の値を、<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティと共にテキストとして保持できるように設計されています。<xref:System.DateTime.Parse%28System.String%2CSystem.IFormatProvider%2CSystem.Globalization.DateTimeStyles%29?displayProperty=fullName> パラメーターが <xref:System.DateTime.ParseExact%2A?displayProperty=fullName> に設定されている場合は、`styles` メソッドまたは <xref:System.Globalization.DateTimeStyles?displayProperty=fullName> メソッドを使用して、書式設定された文字列を変換前の文字列に戻すことができます。  
+  
+ "O" または "o" 標準書式指定子は、<xref:System.DateTime> 値の "yyyy'\-'MM'\-'dd'T'HH':'mm':'ss'.'fffffffK" カスタム書式指定文字列と <xref:System.DateTimeOffset> 値の "yyyy'\-'MM'\-'dd'T'HH':'mm':'ss'.'fffffffzzz" カスタム書式指定文字列に対応します。 この文字列の中で、個々の文字 \(ハイフン、コロン、アルファベットの "T" など\) を区切る一対の単一引用符は、各文字がリテラルであって変更できないことを示します。 アポストロフィは、出力された文字列には現れません。  
+  
+ "O" または "o" 標準書式指定子 \(および "yyyy'\-'MM'\-'dd'T'HH':'mm':'ss'.'fffffffK" カスタム書式指定文字列\) は、<xref:System.DateTime.Kind%2A> 値の <xref:System.DateTime> プロパティを保持するため、ISO 8601 の 3 種類のタイム ゾーン情報表記形式を利用します。  
+  
+-   <xref:System.DateTimeKind?displayProperty=fullName> 日時値のタイム ゾーン コンポーネントは、UTC からのオフセットです \(例:\+01:00、\-07:00\)。<xref:System.DateTimeOffset> のすべての値もこの形式で表記されます。  
+  
+-   <xref:System.DateTimeKind?displayProperty=fullName> 日時値のタイム ゾーン コンポーネントは、"Z" \(ゼロ オフセットを示す\) を使用して UTC を表記します。  
+  
+-   <xref:System.DateTimeKind?displayProperty=fullName> 日時値にはタイム ゾーン情報はありません。  
+  
+ "O" または "o" 標準書式指定子は国際基準に準拠しているため、この指定子を使用する書式設定操作または解析操作では常に、インバリアント カルチャとグレゴリオ暦が使用されます。  
+  
+ <xref:System.DateTime> と <xref:System.DateTimeOffset> の `Parse` メソッド、`TryParse` メソッド、`ParseExact` メソッド、`TryParseExact` メソッドに渡される文字列が、これらのいずれかの書式である場合、書式指定子 "O" や "o" を使用して解析できます。<xref:System.DateTime> オブジェクトの場合、呼び出す解析オーバーロードの `styles` パラメーターに値 <xref:System.Globalization.DateTimeStyles?displayProperty=fullName> が指定されている必要があります。 "O" または "o" 書式指定子に対応するカスタム書式文字列を使用して解析メソッドを呼び出した結果は、"O" または "o" を使用した場合の結果と同じではないことに注意してください。 これは、カスタム書式文字列を使用する解析メソッドでは、タイム ゾーン コンポーネントがない日時値または "Z" を使用して UTC を示している日時値の文字列形式を解析できないためです。  
+  
+ 次の例では、米国太平洋標準時タイム ゾーンのシステム上で "o" 書式指定子を使用して、一連の <xref:System.DateTime> 値および <xref:System.DateTimeOffset> 値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/o1.cs#8)]
+ [!code-vb[Formatting.DateAndTime.Standard#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/o1.vb#8)]  
+  
+ 次の例では、"o" 書式指定子を使用して書式設定された文字列を作成し、日付と時刻の `Parse` メソッドを呼び出して元の日付と時刻の値を復元します。  
+  
+ [!code-csharp[Formatting.DateandTime.Standard#16](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Roundtrip1.cs#16)]
+ [!code-vb[Formatting.DateandTime.Standard#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/RoundTrip1.vb#16)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="RFC1123"></a>   
+## RFC1123 \("R"、"r"\) 書式指定子  
+ "R" または "r" 標準書式指定子は、<xref:System.Globalization.DateTimeFormatInfo.RFC1123Pattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 このパターンは定義済みの標準を反映し、プロパティは読み取り専用です。 したがって、使用されるカルチャまたは指定された書式プロバイダーに関係なく、常に同じです。 カスタム書式指定文字列は、"ddd, dd MMM yyyy HH':'mm':'ss 'GMT'" です。 この標準書式指定子を使用した場合、書式設定操作または解析操作で常にインバリアント カルチャが使用されます。  
+  
+ 結果文字列は、インバリアント カルチャを表す <xref:System.Globalization.DateTimeFormatInfo> プロパティによって返される <xref:System.Globalization.DateTimeFormatInfo.InvariantInfo%2A?displayProperty=fullName> オブジェクトの次のプロパティに影響されます。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.RFC1123Pattern%2A>|結果文字列の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AbbreviatedDayNames%2A>|結果文字列に含まれる日付の省略名を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AbbreviatedMonthNames%2A>|結果文字列に含まれる月の省略名を定義します。|  
+  
+ RFC 1123 標準では、時刻は世界協定時刻 \(UTC: Coordinated Universal Time\) で表されますが、書式設定操作では、書式設定される <xref:System.DateTime> オブジェクトの値は変更されません。 そのため、書式設定操作を行う前に <xref:System.DateTime> メソッドを呼び出して、<xref:System.DateTime.ToUniversalTime%2A?displayProperty=fullName> 値を UTC に変換する必要があります。 一方、<xref:System.DateTimeOffset> 値では、この変換が自動的に行われます。書式設定操作の前に <xref:System.DateTimeOffset.ToUniversalTime%2A?displayProperty=fullName> メソッドを呼び出す必要はありません。  
+  
+ 次の例では、米国太平洋標準時タイム ゾーンのシステム上で "r" 書式指定子を使用して、<xref:System.DateTime> 値および <xref:System.DateTimeOffset> 値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#9](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#9)]
+ [!code-vb[Formatting.DateAndTime.Standard#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#9)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="Sortable"></a>   
+## 並べ替え可能な日付と時刻 \("s"\) 書式指定子  
+ "s" 標準書式指定子は、<xref:System.Globalization.DateTimeFormatInfo.SortableDateTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 このパターンは定義済みの標準 \(ISO 8601\) を反映し、プロパティは読み取り専用です。 したがって、使用されるカルチャまたは指定された書式プロバイダーに関係なく、常に同じです。 カスタム書式指定文字列は、"yyyy'\-'MM'\-'dd'T'HH':'mm':'ss" です。  
+  
+ "s" 書式指定子の目的は、日付と時刻の値に基づいて、一貫して昇順または降順で並べ替える結果の文字列を作成することです。 そのため、"s" 標準書式指定子は一貫性のある形式での日付と時刻の値を表していますが、書式設定操作によって、書式設定の対象となる日付と時刻のオブジェクトの値が <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティやその <xref:System.DateTimeOffset.Offset%2A?displayProperty=fullName> 値を反映するように変更されることはありません。 たとえば、日付と時刻値の 2014\-11\-15T18:32:17\+00:00 と 2014\-11\-15T18:32:17\+08:00 を書式設定することで生成される結果文字列は同じになります。  
+  
+ この標準書式指定子を使用した場合、書式設定操作または解析操作で常にインバリアント カルチャが使用されます。  
+  
+ 次の例では、米国太平洋標準時タイム ゾーンのシステム上で "s" 書式指定子を使用して、<xref:System.DateTime> 値および <xref:System.DateTimeOffset> 値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#10)]
+ [!code-vb[Formatting.DateAndTime.Standard#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#10)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="ShortTime"></a>   
+## 短い形式の時刻 \("t"\) 書式指定子  
+ "t" 標準書式指定子は、現在の <xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "HH:mm" です。  
+  
+ 結果文字列は、特定の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A?displayProperty=fullName> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.ShortTimePattern%2A>|結果文字列の時刻要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"t" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#11](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#11)]
+ [!code-vb[Formatting.DateAndTime.Standard#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#11)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="LongTime"></a>   
+## 長い形式の時刻 \("T"\) 書式指定子  
+ "T" 標準書式指定子は、特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.LongTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "HH:mm:ss" です。  
+  
+ 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.LongTimePattern%2A?displayProperty=fullName> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.LongTimePattern%2A>|結果文字列の時刻要素の書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ 次の例では、"T" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#12](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#12)]
+ [!code-vb[Formatting.DateAndTime.Standard#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#12)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="UniversalSortable"></a>   
+## 世界共通の並べ替え可能な日付と時刻 \("u"\) 書式指定子  
+ "u" 標準書式指定子は、<xref:System.Globalization.DateTimeFormatInfo.UniversalSortableDateTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 このパターンは定義済みの標準を反映し、プロパティは読み取り専用です。 したがって、使用されるカルチャまたは指定された書式プロバイダーに関係なく、常に同じです。 カスタム書式指定文字列は、"yyyy'\-'MM'\-'dd HH':'mm':'ss'Z'" です。 この標準書式指定子を使用した場合、書式設定操作または解析操作で常にインバリアント カルチャが使用されます。  
+  
+ 結果文字列では、時刻は世界協定時刻 \(UTC\) で表される必要がありますが、書式設定操作では、元の <xref:System.DateTime> 値の変換は実行されません。 そのため、書式設定する前に <xref:System.DateTime> メソッドを呼び出して、<xref:System.DateTime.ToUniversalTime%2A?displayProperty=fullName> 値を UTC に変換する必要があります。  一方、<xref:System.DateTimeOffset> 値では、この変換が自動的に行われます。書式設定操作の前に <xref:System.DateTimeOffset.ToUniversalTime%2A?displayProperty=fullName> メソッドを呼び出す必要はありません。  
+  
+ 次の例では、"u" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#13](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#13)]
+ [!code-vb[Formatting.DateAndTime.Standard#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#13)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="UniversalFull"></a>   
+## 世界共通の完全な日付と時刻 \("U"\) 書式指定子  
+ "U" 標準書式指定子は、特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 このパターンは、"F" パターンと同じです。 ただし、<xref:System.DateTime> 値は、書式設定される前に、自動的に UTC に変換されます。  
+  
+ 返される文字列の書式を制御できる <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。 一部のカルチャの <xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A> プロパティによって返されるカスタム書式指定子では、一部のプロパティが使用されない場合があります。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.FullDateTimePattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.DayNames%2A>|結果文字列に含まれるローカライズされた日付の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.TimeSeparator%2A>|時刻の構成要素、つまり時間、分、および秒を区切る文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.AMDesignator%2A>|午前 0 時から正午前までの時刻を 12 時間形式で示す文字列を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.PMDesignator%2A>|正午から午前 0 時前までの時刻を 12 時間形式で示す文字列を定義します。|  
+  
+ "U" 書式指定子は、<xref:System.DateTimeOffset> 型ではサポートされません。この書式指定子を使って <xref:System.FormatException> 値の書式を設定しようとすると、<xref:System.DateTimeOffset> がスローされます。  
+  
+ 次の例では、"U" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#14](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#14)]
+ [!code-vb[Formatting.DateAndTime.Standard#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#14)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="YearMonth"></a>   
+## 年月 \("Y"、"y"\) 書式指定子  
+ "Y" または "y" 標準書式指定子は、特定のカルチャの <xref:System.Globalization.DateTimeFormatInfo.YearMonthPattern%2A?displayProperty=fullName> プロパティで定義されるカスタム日時書式指定文字列を表します。 たとえば、インバリアント カルチャのカスタム書式指定文字列は "yyyy MMMM" です。  
+  
+ 返される文字列の書式を制御する <xref:System.Globalization.DateTimeFormatInfo> オブジェクト プロパティの一覧を次の表に示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Globalization.DateTimeFormatInfo.YearMonthPattern%2A>|結果文字列の全体的な書式を定義します。|  
+|<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A>|結果文字列に含まれるローカライズされた月の名前を定義します。|  
+  
+ 次の例では、"y" 書式指定子を使用して、日付と時刻の値を表示します。  
+  
+ [!code-csharp[Formatting.DateAndTime.Standard#15](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.DateAndTime.Standard/cs/Standard1.cs#15)]
+ [!code-vb[Formatting.DateAndTime.Standard#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.DateAndTime.Standard/vb/Standard1.vb#15)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="Notes"></a>   
+## ノート  
+  
+### コントロール パネルの設定  
+ コントロール パネルの **\[地域と言語のオプション\]** での設定は、書式設定操作によって生成される結果の文字列に影響します。 これらの設定は、書式設定の制御に使用される値を提供する現在のスレッド カルチャに関連付けられた <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを初期化するために使用されます。 コンピューターで使用する設定が異なる場合は、生成される文字列も異なります。  
+  
+ また、<xref:System.Globalization.CultureInfo.%23ctor%28System.String%29?displayProperty=fullName> コンストラクターを使用して、現在のシステム カルチャと同じカルチャを表す新しい <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化した場合、コントロール パネルの **\[地域と言語のオプション\]** 項目で設定されたカスタマイズが新しい <xref:System.Globalization.CultureInfo> オブジェクトに適用されます。<xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを使用すると、システムに対するカスタマイズが反映されない <xref:System.Globalization.CultureInfo> オブジェクトを作成できます。  
+  
+### DateTimeFormatInfo のプロパティ  
+ 書式設定は、現在の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティの影響を受けます。このオブジェクトは、現在のスレッド カルチャによって暗黙的に指定されるか、または書式設定を実行するメソッドの <xref:System.IFormatProvider> パラメーターによって明示的に指定されます。<xref:System.IFormatProvider> パラメーターには、カルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトを指定するか、特定のカルチャの日時書式設定規則を表す <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを指定する必要があります。 標準日時書式指定子の多くは、現在の <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティによって定義されている書式設定パターンのエイリアスです。 標準日時書式指定子によって生成される結果は、対応する <xref:System.Globalization.DateTimeFormatInfo> プロパティの、対応する日時形式パターンを変更することによって変えることができます。  
+  
+## 参照  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)   
+ [サンプル: .NET Framework 4 の書式設定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)
\ No newline at end of file
diff --git a/docs/standard/base-types/standard-numeric-format-strings.md b/docs/standard/base-types/standard-numeric-format-strings.md
new file mode 100644
index 00000000000..fe75a886ee9
--- /dev/null
+++ b/docs/standard/base-types/standard-numeric-format-strings.md
@@ -0,0 +1,342 @@
+---
+title: "標準の数値書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式指定子, 数値"
+  - "書式指定子, 標準の数値書式指定文字列"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 数"
+  - "書式指定 (数値の) [.NET Framework]"
+  - "数値 [.NET Framework], 書式指定"
+  - "数値書式指定文字列 [.NET Framework]"
+  - "標準の書式指定文字列, 数値"
+  - "標準の数値書式指定文字列"
+ms.assetid: 580e57eb-ac47-4ffd-bccd-3a1637c2f467
+caps.latest.revision: 99
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 95
+---
+# 標準の数値書式指定文字列
+一般的な数値型を書式設定するには、標準の数値書式指定文字列を使用します。 標準の数値書式指定文字列の形式は `Axx` です。  
+  
+-   `A` は *書式指定子* です。これは 1 文字の英文字です。 空白を含む複数の英文字で構成される数値書式指定文字列は、カスタム数値書式指定文字列として解釈されます。 詳細については、「[カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)」を参照してください。  
+  
+-   `xx` は *精度指定子* です。これは省略可能な整数値です。 精度指定子は 0 ～ 99 の範囲で指定され、結果の桁数に影響します。 精度指定子は、文字列形式の数値の桁数を制御することに注意してください。 精度指定子では、数値を丸めません。 丸め操作を実行するには、<xref:System.Math.Ceiling%2A?displayProperty=fullName>、<xref:System.Math.Floor%2A?displayProperty=fullName>、または <xref:System.Math.Round%2A?displayProperty=fullName> の各メソッドを使用します。  
+  
+     *精度指定子*が結果文字列内の小数部の桁数を制御する際、結果文字列は、ゼロから離れる方向に丸められる数を反映します \(つまり、<xref:System.MidpointRounding?displayProperty=fullName> を使用します\)。  
+  
+ 標準の数値書式指定文字列は、すべての数値型の `ToString` メソッドの一部のオーバーロードでサポートされています。 たとえば、<xref:System.Int32.ToString%28System.String%29> 型の <xref:System.Int32.ToString%28System.String%2CSystem.IFormatProvider%29> メソッドおよび <xref:System.Int32> メソッドに数値書式指定文字列を指定できます。 標準の数値書式指定文字列は、.NET Framework の[複合書式指定機能](../../../docs/standard/base-types/composite-formatting.md)でもサポートされています。この機能を使用するメソッドには、`Write` クラスおよび `WriteLine` クラスの一部の <xref:System.Console> メソッドと <xref:System.IO.StreamWriter> メソッド、<xref:System.String.Format%2A?displayProperty=fullName> メソッド、および <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName> メソッドがあります。 複合書式指定機能により、複数のデータ項目の文字列表現を 1 つの文字列にまとめ、フィールド幅を指定し、フィールドの数値の位置を揃えることができます。 詳細については、「[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)」を参照してください。  
+  
+> [!TIP]
+>  [書式指定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)をダウンロードできます。このアプリケーションを使用すると、書式指定文字列を数値または日付と時刻の値に適用して、結果の文字列を表示できます。  
+  
+<a name="table"></a> 次の表に、標準数値書式指定子の説明および書式指定子ごとのサンプル出力を示します。 標準の数値書式指定文字列の使用方法については、「[メモ](#NotesStandardFormatting)」を参照してください。それらを使用する包括的な例については、「[例](#example)」を参照してください。  
+  
+|書式指定子|名前|説明|例|  
+|-----------|--------|--------|-------|  
+|"C" または "c"|通貨|結果: 通貨値。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 小数部の桁数。<br /><br /> 既定の精度指定子: <xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A?displayProperty=fullName> によって定義されます。<br /><br /> 詳細については、「[通貨 \("C"\) 書式指定子](#CFormatString)」を参照してください。|123.456 \("C", en\-US\) \-\> $123.46<br /><br /> 123.456 \("C", fr\-FR\) \-\> 123,46 €<br /><br /> 123.456 \("C", ja\-JP\) \-\> ¥123<br /><br /> \-123.456 \("C3", en\-US\) \-\> \($123.456\)<br /><br /> \-123.456 \("C3", fr\-FR\) \-\> \-123,456 €<br /><br /> \-123.456 \("C3", ja\-JP\) \-\> \-¥123.456|  
+|"D" または "d"|Decimal \(10 進数型\)|結果: 必要に応じて負の符号が付く整数。<br /><br /> サポート: 整数型のみ。<br /><br /> 精度指定子: 最小桁数。<br /><br /> 既定の精度指定子: 必要な最小桁数。<br /><br /> 詳細については、「[10 進数 \("D"\) 書式指定子](#DFormatString)」を参照してください。|1234 \("D"\) \-\> 1234<br /><br /> \-1234 \("D6"\) \-\> \-001234|  
+|"E" または "e"|指数|結果: 指数表記。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 小数部の桁数。<br /><br /> 既定の精度指定子: 6。<br /><br /> 詳細については、「[指数 \("E"\) 書式指定子](#EFormatString)」を参照してください。|1052.0329112756 \("E", en\-US\) \-\> 1.052033E\+003<br /><br /> 1052.0329112756 \("e", fr\-FR\) \-\> 1,052033e\+003<br /><br /> \-1052.0329112756 \("e2", en\-US\) \-\> \-1.05e\+003<br /><br /> \-1052.0329112756 \("E2", fr\_FR\) \-\> \-1,05E\+003|  
+|"F" または "f"|固定小数点|結果: 必要に応じて負の符号が付く整数と小数。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 小数部の桁数。<br /><br /> 既定の精度指定子: <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A?displayProperty=fullName> によって定義されます。<br /><br /> 詳細については、「[固定小数点 \("F"\) 書式指定子](#FFormatString)」を参照してください。|1234.567 \("F", en\-US\) \-\> 1234.57<br /><br /> 1234.567 \("F", de\-DE\) \-\> 1234,57<br /><br /> 1234 \("F1", en\-US\) \-\> 1234.0<br /><br /> 1234 \("F1", de\-DE\) \-\> 1234,0<br /><br /> \-1234.56 \("F4", en\-US\) \-\> \-1234.5600<br /><br /> \-1234.56 \("F4", de\-DE\) \-\> \-1234,5600|  
+|"G" または "g"|全般|結果: 固定小数点表記または指数表記のいずれかの最も簡潔な形式。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 有効桁数。<br /><br /> 既定の精度指定子: 数値型によって異なります。<br /><br /> 詳細については、「[一般 \("G"\) 書式指定子](#GFormatString)」を参照してください。|\-123.456 \("G", en\-US\) \-\> \-123.456<br /><br /> \-123.456 \("G", sv\-SE\) \-\> \-123,456<br /><br /> 123.4546 \("G4", en\-US\) \-\> 123.5<br /><br /> 123.4546 \("G4", sv\-SE\) \-\> 123,5<br /><br /> \-1.234567890e\-25 \("G", en\-US\) \-\> \-1.23456789E\-25<br /><br /> \-1.234567890e\-25 \("G", sv\-SE\) \-\> \-1,23456789E\-25|  
+|"N" または "n"|Number|結果: 必要に応じて負の符号が付く整数と小数、桁区切り記号、および小数点記号。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 小数部の桁数。<br /><br /> 既定の精度指定子: <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A?displayProperty=fullName> によって定義されます。<br /><br /> 詳細については、「[数値 \("N"\) 書式指定子](#NFormatString)」を参照してください。|1234.567 \("N", en\-US\) \-\> 1,234.57<br /><br /> 1234.567 \("N", ru\-RU\) \-\> 1 234,57<br /><br /> 1234 \("N1", en\-US\) \-\> 1,234.0<br /><br /> 1234 \("N1", ru\-RU\) \-\> 1 234,0<br /><br /> \-1234.56 \("N3", en\-US\) \-\> \-1,234.560<br /><br /> \-1234.56 \("N3", ru\-RU\) \-\> \-1 234,560|  
+|"P" または "p"|パーセント|結果: 数値に 100 を掛けて、パーセント記号を付けて表示します。<br /><br /> サポート: すべての数値型。<br /><br /> 精度指定子: 小数部の桁数。<br /><br /> 既定の精度指定子: <xref:System.Globalization.NumberFormatInfo.PercentDecimalDigits%2A?displayProperty=fullName> によって定義されます。<br /><br /> 詳細については、「[パーセント \("P"\) 書式指定子](#PFormatString)」を参照してください。|1 \("P", en\-US\) \-\> 100.00 %<br /><br /> 1 \("P", fr\-FR\) \-\> 100,00 %<br /><br /> \-0.39678 \("P1", en\-US\) \-\> \-39.7 %<br /><br /> \-0.39678 \("P1", fr\-FR\) \-\> \-39,7 %|  
+|"R" または "r"|ラウンドトリップ|結果: 同じ数値にラウンドトリップできる文字列。<br /><br /> サポート: <xref:System.Single>、<xref:System.Double>、および <xref:System.Numerics.BigInteger>。<br /><br /> 精度指定子: 無視されます。<br /><br /> 詳細については、「[ラウンドトリップ \("R"\) 書式指定子](#RFormatString)」を参照してください。|123456789.12345678 \("R"\) \-\> 123456789.12345678<br /><br /> \-1234567890.12345678 \("R"\) \-\> \-1234567890.1234567|  
+|"X" または "x"|16 進数|結果: 16 進数文字列。<br /><br /> サポート: 整数型のみ。<br /><br /> 精度指定子: 結果文字列の桁数。<br /><br /> 詳細については、「[16 進数 \("X"\) 書式指定子](#XFormatString)」を参照してください。|255 \("X"\) \-\> FF<br /><br /> \-1 \("x"\) \-\> ff<br /><br /> 255 \("x4"\) \-\> 00ff<br /><br /> \-1 \("X4"\) \-\> 00FF|  
+|その他の 1 文字|未定義の指定子|結果: 実行時に <xref:System.FormatException> をスローします。||  
+  
+<a name="Using"></a>   
+## 標準の数値書式指定文字列の使用  
+ 標準の数値書式指定文字列を使用すると、次のいずれかの方法で数値の書式を定義できます。  
+  
+-   `ToString` パラメーターを持つ `format` メソッドのオーバーロードに渡す。 次の例では、数値の書式を現在のカルチャ \(ここでは en\-US\) の通貨文字列に設定しています。  
+  
+     [!code-cpp[Formatting.Numeric.Standard#10](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/standardusage1.cpp#10)]
+     [!code-csharp[Formatting.Numeric.Standard#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/standardusage1.cs#10)]
+     [!code-vb[Formatting.Numeric.Standard#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/standardusage1.vb#10)]  
+  
+-   <xref:System.String.Format%2A?displayProperty=fullName>、<xref:System.Console.WriteLine%2A?displayProperty=fullName>、<xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName> などのメソッドで使用される書式指定項目の `formatString` 引数として渡す。 詳細については、「[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)」を参照してください。 次の例では、書式指定項目を使用して文字列に通貨値を挿入しています。  
+  
+     [!code-cpp[Formatting.Numeric.Standard#11](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/standardusage1.cpp#11)]
+     [!code-csharp[Formatting.Numeric.Standard#11](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/standardusage1.cs#11)]
+     [!code-vb[Formatting.Numeric.Standard#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/standardusage1.vb#11)]  
+  
+     オプションで、`alignment` 引数を渡して数値フィールドの幅と、その値を右揃えまたは左揃えにするかどうかを指定します。 次の例では、通貨の値が 28 文字フィールドでは左揃えになっており、14 文字フィールドでは右揃えになっています。  
+  
+     [!code-cpp[Formatting.Numeric.Standard#12](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/standardusage1.cpp#12)]
+     [!code-csharp[Formatting.Numeric.Standard#12](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/standardusage1.cs#12)]
+     [!code-vb[Formatting.Numeric.Standard#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/standardusage1.vb#12)]  
+  
+ 以降では、それぞれの標準の数値書式指定文字列について詳しく説明します。  
+  
+<a name="CFormatString"></a>   
+## 通貨 \("C"\) 書式指定子  
+ "C" \(通貨\) 書式指定子は、金額を表す文字列に数値を変換します。 精度指定子は、結果文字列の小数部の桁数を示します。 精度指定子を省略すると、<xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A?displayProperty=fullName> プロパティによって既定の桁数が定義されます。  
+  
+ 書式指定される値が指定または既定の小数部の桁数を超えている場合、小数値は結果文字列で丸められます。 指定した小数部の桁数の右側にある値が 5 以上の場合、結果文字列の最後の桁はゼロから離れる方向に丸められます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyPositivePattern%2A>|正の値の通貨記号の位置を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A>|負の値の通貨記号の位置を定義し、かっこと <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A> プロパティのどちらによって負の符号が表されるかを指定します。|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|<xref:System.Globalization.NumberFormatInfo.CurrencyNegativePattern%2A> でかっこを使用しないように示されている場合に使用される負の符号を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencySymbol%2A>|通貨記号を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyDecimalDigits%2A>|通貨値の既定の小数点以下桁数を定義します。 この値は、精度指定子を使用してオーバーライドできます。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyGroupSeparator%2A>|整数の桁を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.CurrencyGroupSizes%2A>|桁を何桁ごとに区切るかを定義します。|  
+  
+ 次の例では、通貨書式指定子を使って <xref:System.Double> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#1](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#1)]
+ [!code-csharp[Formatting.Numeric.Standard#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#1)]
+ [!code-vb[Formatting.Numeric.Standard#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#1)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="DFormatString"></a>   
+## 10 進数 \("D"\) 書式指定子  
+ "D" \(10 進数\) 書式指定子は、0 ～ 9 の数字から成る文字列に数値を変換します。負の数値の場合は、文字列の先頭にマイナス記号が挿入されます。 この書式指定は整数型でだけサポートされています。  
+  
+ 精度指定子は、変換後の文字列の最小桁数を示します。 必要に応じて、精度指定子によって指定された桁数に達するまで、数値の左側にゼロが埋め込まれます。 精度指定子が指定されていない場合の既定値は、先行するゼロを含めずに整数を表すために必要な最小値です。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 次の表に示すように、結果文字列の書式に影響を与えるプロパティは 1 つです。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+  
+ 次の例では、10 進数の書式指定子を使って <xref:System.Int32> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#2](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#2)]
+ [!code-csharp[Formatting.Numeric.Standard#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#2)]
+ [!code-vb[Formatting.Numeric.Standard#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#2)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="EFormatString"></a>   
+## 指数 \("E"\) 書式指定子  
+ 指数 \("E"\) 書式指定子は、"\-d.ddd…E\+ddd" または "\-d.ddd…e\+ddd" という形式の文字列に数値を変換します。この "d" は 0 ～ 9 の 1 桁の数字を示します。 負の数値の場合、変換後の文字列の先頭にマイナス記号が挿入されます。 小数点の前には 1 桁の数字が必ず示されます。  
+  
+ 精度指定子は、小数部の桁数を示します。 精度指定子を省略すると、小数部の桁数として既定の 6 桁が使用されます。  
+  
+ 書式指定子が大文字の場合は指数部の前に "E" が挿入され、小文字の場合は "e" が挿入されます。 指数部は常に、プラス記号またはマイナス記号のいずれかと、3 桁以上の桁で構成されます。 指数部の桁数が最小桁数の 3 桁よりも少ない場合には、3 桁になるようにゼロが埋め込まれます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 返される文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|係数と指数部の両方で数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A>|係数の整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PositiveSign%2A>|指数部が正であることを示す文字列を定義します。|  
+  
+ 次の例では、指数書式指定子を使って <xref:System.Double> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#3](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#3)]
+ [!code-csharp[Formatting.Numeric.Standard#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#3)]
+ [!code-vb[Formatting.Numeric.Standard#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#3)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="FFormatString"></a>   
+## 固定小数点 \("F"\) 書式指定子  
+ 固定小数点 \("F\) 書式指定子は、"\-ddd.ddd…" という形式の文字列に数値を変換します。 この "d" は 0 ～ 9 の 1 桁の数字を示します。 負の数値の場合、変換後の文字列の先頭にマイナス記号が挿入されます。  
+  
+ 精度指定子は、小数部の桁数を示します。 精度指定子を省略すると、現在の <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A?displayProperty=fullName> プロパティによって桁数が指定されます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 結果文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> オブジェクトのプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A>|既定の小数点以下桁数を定義します。 この値は、精度指定子を使用してオーバーライドできます。|  
+  
+ 次の例では、固定小数点の書式指定子を使って <xref:System.Double> および <xref:System.Int32> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#4](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#4)]
+ [!code-csharp[Formatting.Numeric.Standard#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#4)]
+ [!code-vb[Formatting.Numeric.Standard#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#4)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="GFormatString"></a>   
+## 一般 \("G"\) 書式指定子  
+ 一般 \("G"\) 書式指定子は、数値の型や、精度指定子が指定されているかどうかに応じて、固定小数点表記または指数表記のいずれかの最も簡潔な形式に数値を変換します。 精度指定子は、結果文字列の有効桁数の最大値を定義します。 精度指定子が省略されている場合や、0 である場合は、次の表に示すように、数値の型によって既定の精度が決定されます。  
+  
+|数値型|既定の精度|  
+|---------|-----------|  
+|<xref:System.Byte> または <xref:System.SByte>|3 桁|  
+|<xref:System.Int16> または <xref:System.UInt16>|5 桁|  
+|<xref:System.Int32> または <xref:System.UInt32>|10 桁|  
+|<xref:System.Int64>|19 桁|  
+|<xref:System.UInt64>|20 桁|  
+|<xref:System.Numerics.BigInteger>|50 桁|  
+|<xref:System.Single>|7 桁|  
+|<xref:System.Double>|15 桁|  
+|<xref:System.Decimal>|29 桁|  
+  
+ 数値を指数表記で表した結果の指数部が \-5 よりも大きく、精度指定子よりも小さい場合は、固定小数点表記が使用されます。それ以外の場合は、指数表記が使用されます。 結果には必要に応じて小数点が含まれ、小数点の後続のゼロは省略されます。 精度指定子が存在し、指定された精度を結果の有効桁数が超える場合は、超過した桁は丸められ削除されます。  
+  
+ ただし、数値が <xref:System.Decimal> で、精度指定子が省略されている場合は、常に固定小数点表記が使用され、後続のゼロは保持されます。  
+  
+ 指数表記が使用される場合、結果の指数部には、書式指定子が "G" のときには "E"、書式指定子が "g" のときには "e" というプレフィックスが付きます。 指数部には少なくとも 2 桁が含まれます。 これは、指数部に少なくとも 3 桁が含まれる、指数書式指定子によって生成される指数表記の書式とは異なります。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 結果文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PositiveSign%2A>|指数部が正であることを示す文字列を定義します。|  
+  
+ 次の例では、一般書式指定子を使って、さまざまな浮動小数点値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#5](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#5)]
+ [!code-csharp[Formatting.Numeric.Standard#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#5)]
+ [!code-vb[Formatting.Numeric.Standard#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="NFormatString"></a>   
+## 数値 \("N"\) 書式指定子  
+ "N" \(Numeric: 数値\) は、数値を "\-d,ddd,ddd.ddd…" という形式の文字列に変換する書式指定子です。"\-" は負数記号を示し \(必要な場合\)、"d" は数字 \(0 ～ 9\) を示し、"," は桁区切り記号を示し、"." は小数点記号を示します。 精度指定子は、小数部の桁数を示します。 精度指定子を省略すると、現在の <xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A?displayProperty=fullName> プロパティによって小数部の桁数が定義されます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 結果文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberNegativePattern%2A>|負の値の書式を定義し、かっこと <xref:System.Globalization.NumberFormatInfo.NegativeSign%2A> プロパティのどちらによって負の符号が表されるかを指定します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberGroupSizes%2A>|桁区切り記号の間の桁数を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberGroupSeparator%2A>|整数の桁を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalDigits%2A>|既定の小数点以下桁数を定義します。 この値は、精度指定子を使用してオーバーライドできます。|  
+  
+ 次の例では、数値書式指定子を使って、さまざまな浮動小数点値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#6](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#6)]
+ [!code-csharp[Formatting.Numeric.Standard#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#6)]
+ [!code-vb[Formatting.Numeric.Standard#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#6)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="PFormatString"></a>   
+## パーセント \("P"\) 書式指定子  
+ パーセント \("P"\) 書式指定子は、数値に 100 を掛けて、パーセントを表す文字列に変換します。 精度指定子は、小数部の桁数を示します。 精度指定子を省略すると、現在の <xref:System.Globalization.NumberFormatInfo.PercentDecimalDigits%2A> プロパティによって指定される既定の桁数が使用されます。  
+  
+ 返される文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.PercentPositivePattern%2A>|正の値のパーセント記号の位置を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentNegativePattern%2A>|負の値のパーセント記号と負の符号の位置を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentSymbol%2A>|パーセント記号を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentDecimalDigits%2A>|パーセント値の既定の小数点以下桁数を定義します。 この値は、精度指定子を使用してオーバーライドできます。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentGroupSeparator%2A>|整数の桁を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PercentGroupSizes%2A>|桁を何桁ごとに区切るかを定義します。|  
+  
+ 次の例では、パーセント書式指定子を使って、浮動小数点値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#7](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#7)]
+ [!code-csharp[Formatting.Numeric.Standard#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#7)]
+ [!code-vb[Formatting.Numeric.Standard#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#7)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="RFormatString"></a>   
+## ラウンドトリップ \("R"\) 書式指定子  
+ ラウンドトリップ \("R"\) 書式指定子は、数値の変換後の文字列が、変換前と同じ数値へ戻るように解析されること確認するために使用されます。 この書式指定は、<xref:System.Single> 型、<xref:System.Double> 型、および <xref:System.Numerics.BigInteger> 型でだけサポートされています。  
+  
+ この指定子を使用して <xref:System.Numerics.BigInteger> 値の書式を設定すると、その文字列形式に <xref:System.Numerics.BigInteger> 値の有効桁数がすべて含まれます。 この指定子を使用して <xref:System.Single> 値または <xref:System.Double> 値の書式を設定すると、最初に一般書式を使用して数値がテストされます。このとき、<xref:System.Double> の場合は 15 桁、<xref:System.Single> の場合は 7 桁の有効桁数が使用されます。 変換後の文字列を解析して変換前の数値へ戻った場合には、一般書式指定子を使用してこの数値の書式が設定されます。 変換後の文字列が解析によって変換前の数値に戻らなかった場合、<xref:System.Double> は 17 桁、<xref:System.Single> は 9 桁の有効桁数でこの値の形式が設定されます。  
+  
+ 精度指定子は、指定できますが無視されます。 ラウンドトリップ指定子と精度指定子の両方を指定すると、ラウンドトリップ指定子が優先されます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されます。 結果文字列の書式を制御する <xref:System.Globalization.NumberFormatInfo> のプロパティの一覧を次の表に示します。  
+  
+|NumberFormatInfo のプロパティ|説明|  
+|-----------------------------|--------|  
+|<xref:System.Globalization.NumberFormatInfo.NegativeSign%2A>|数値が負であることを示す文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A>|整数部と小数部を区切る文字列を定義します。|  
+|<xref:System.Globalization.NumberFormatInfo.PositiveSign%2A>|指数部が正であることを示す文字列を定義します。|  
+  
+ 次の例では、ラウンドトリップ書式指定子を使って <xref:System.Double> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#8](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#8)]
+ [!code-csharp[Formatting.Numeric.Standard#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#8)]
+ [!code-vb[Formatting.Numeric.Standard#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#8)]  
+  
+> [!IMPORTANT]
+>  場合によっては、`/platform:x64` スイッチまたは `/platform:anycpu` スイッチを使用してコンパイルして 64 ビット システムで実行すると、"R" 標準の数値書式指定文字列で書式設定される <xref:System.Double> 値のラウンドトリップに失敗することがあります。 詳細については、次の段落を参照してください。  
+  
+ `/platform:x64` スイッチまたは `/platform:anycpu` スイッチを使用してコンパイルして 64 ビット システムで実行すると、「R」標準の数値書式指定文字列を使用して書式設定される <xref:System.Double> 値のラウンドトリップが失敗するという問題を回避するために、<xref:System.Double> 値を「G17」標準の数値書式指定文字列を使用して書式設定することができます。 次の例では、ラウンドトリップに失敗する <xref:System.Double> 値を持つ "R" 書式指定文字列を使用しています。元の値のラウンドトリップに成功する "G17" 書式指定文字列も使用しています。  
+  
+ [!code-csharp[System.Double.ToString#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Double.ToString/cs/roundtripex1.cs#5)]
+ [!code-vb[System.Double.ToString#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Double.ToString/vb/roundtripex1.vb#5)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="XFormatString"></a>   
+## 16 進数 \("X"\) 書式指定子  
+ 16 進数 \("X"\) 書式指定子は、16 進数文字列に数値を変換します。 書式指定子の大文字と小文字によって、9 よりも大きい 16 進数値を示すアルファベット文字が大文字と小文字のどちらで表示されるかが決まります。 たとえば、"X" を指定すると "ABCDEF" となり、"x" を指定すると "abcdef" となります。 この書式指定は整数型でだけサポートされています。  
+  
+ 精度指定子は、変換後の文字列の最小桁数を示します。 必要に応じて、精度指定子によって指定された桁数に達するまで、数値の左側にゼロが埋め込まれます。  
+  
+ 結果文字列は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトの書式情報に影響されません。  
+  
+ 次の例では、16 進数の書式指定子を使って <xref:System.Int32> 値の書式を設定します。  
+  
+ [!code-cpp[Formatting.Numeric.Standard#9](../../../samples/snippets/cpp/VS_Snippets_CLR/Formatting.Numeric.Standard/cpp/Standard.cpp#9)]
+ [!code-csharp[Formatting.Numeric.Standard#9](../../../samples/snippets/csharp/VS_Snippets_CLR/Formatting.Numeric.Standard/cs/Standard.cs#9)]
+ [!code-vb[Formatting.Numeric.Standard#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Formatting.Numeric.Standard/vb/Standard.vb#9)]  
+  
+ [表のトップへ](#table)  
+  
+<a name="NotesStandardFormatting"></a>   
+## ノート  
+  
+### コントロール パネルの設定  
+ コントロール パネルの **\[地域と言語のオプション\]** での設定は、書式設定操作によって生成される結果の文字列に影響します。 これらの設定は、書式設定の制御に使用される値を提供する現在のスレッド カルチャに関連付けられた <xref:System.Globalization.NumberFormatInfo> オブジェクトを初期化するために使用されます。 コンピューターで使用する設定が異なる場合は、生成される文字列も異なります。  
+  
+ また、<xref:System.Globalization.CultureInfo.%23ctor%28System.String%29?displayProperty=fullName> コンストラクターを使用して、現在のシステム カルチャと同じカルチャを表す新しい <xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化した場合、コントロール パネルの **\[地域と言語のオプション\]** 項目で設定されたカスタマイズが新しい <xref:System.Globalization.CultureInfo> オブジェクトに適用されます。<xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを使用すると、システムに対するカスタマイズが反映されない <xref:System.Globalization.CultureInfo> オブジェクトを作成できます。  
+  
+### NumberFormatInfo のプロパティ  
+ 書式設定は、現在の <xref:System.Globalization.NumberFormatInfo> オブジェクトのプロパティの影響を受けます。このオブジェクトは、現在のスレッド カルチャによって暗黙的に指定されるか、または書式設定を実行するメソッドの <xref:System.IFormatProvider> パラメーターによって明示的に指定されます。 このパラメーターには、<xref:System.Globalization.NumberFormatInfo> オブジェクトまたは <xref:System.Globalization.CultureInfo> オブジェクトを指定してください。  
+  
+> [!NOTE]
+>  数値の書式設定に使用するパターンまたは文字列のカスタマイズの詳細については、<xref:System.Globalization.NumberFormatInfo> クラスに関するトピックを参照してください。  
+  
+### 整数数値型と浮動小数点数値型  
+ 標準の数値書式指定子の記述で、整数数値型または浮動小数点数値型が参照されている場合があります。 整数数値型には、<xref:System.Byte>、<xref:System.SByte>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.UInt16>、<xref:System.UInt32>、<xref:System.UInt64>、および <xref:System.Numerics.BigInteger> があります。 浮動小数点数値型には、<xref:System.Decimal>、<xref:System.Single>、および <xref:System.Double> があります。  
+  
+### 浮動小数点の無限大値と NaN \(非数\) 値  
+ <xref:System.Single> の浮動小数点型または <xref:System.Double> の浮動小数点型が正の無限大、負の無限大、または NaN \(非数\) である場合は、書式指定文字列とは関係なく、現在適用可能な <xref:System.Globalization.NumberFormatInfo.PositiveInfinitySymbol%2A> オブジェクトによって指定される <xref:System.Globalization.NumberFormatInfo.NegativeInfinitySymbol%2A>、<xref:System.Globalization.NumberFormatInfo.NaNSymbol%2A>、または <xref:System.Globalization.NumberFormatInfo> の各プロパティの値は、書式設定された文字列となります。  
+  
+<a name="example"></a>   
+## 例  
+ 次の例では、en\-US カルチャおよびすべての標準数値書式指定子を使用して、整数値と浮動小数点数値を書式設定します。 この例では 2 つの特定の数値型 \(<xref:System.Double> および <xref:System.Int32>\) を使用していますが、他の数値基本型 \(<xref:System.Byte>、<xref:System.SByte>、<xref:System.Int16>、<xref:System.Int32>、<xref:System.Int64>、<xref:System.UInt16>、<xref:System.UInt32>、<xref:System.UInt64><xref:System.Numerics.BigInteger>、<xref:System.Decimal>、および <xref:System.Single>\) でも類似した結果が得られます。  
+  
+ [!code-csharp[system.x.tostring-and-culture#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.X.ToString-and-Culture/cs/xts.cs#1)]
+ [!code-vb[system.x.tostring-and-culture#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.X.ToString-and-Culture/vb/xts.vb#1)]  
+  
+## 参照  
+ <xref:System.Globalization.NumberFormatInfo>   
+ [カスタム数値書式指定文字列](../../../docs/standard/base-types/custom-numeric-format-strings.md)   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [方法: 数値に先行するゼロを埋め込む](../../../docs/standard/base-types/how-to-pad-a-number-with-leading-zeros.md)   
+ [サンプル: .NET Framework 4 の書式設定ユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Formatting-9c4dae8d)   
+ [複合書式指定](../../../docs/standard/base-types/composite-formatting.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/standard-timespan-format-strings.md b/docs/standard/base-types/standard-timespan-format-strings.md
new file mode 100644
index 00000000000..616d784d71c
--- /dev/null
+++ b/docs/standard/base-types/standard-timespan-format-strings.md
@@ -0,0 +1,137 @@
+---
+title: "標準の時間間隔書式指定文字列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書式指定子, 標準時間間隔"
+  - "書式指定子, 時間間隔"
+  - "書式指定文字列"
+  - "書式指定 [.NET Framework], 時間"
+  - "書式指定 [.NET Framework], 時間間隔"
+  - "標準の書式指定文字列, 時間間隔"
+  - "標準時間間隔書式指定文字列"
+  - "標準の TimeSpan 書式指定文字列"
+  - "時刻 [.NET Framework], 書式指定"
+  - "時間間隔 [.NET Framework], 書式指定"
+ms.assetid: 9f6c95eb-63ae-4dcc-9c32-f81985c75794
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 標準の時間間隔書式指定文字列
+標準の <xref:System.TimeSpan> 書式指定文字列は、単一の書式指定子を使用して、書式設定操作によって生成される <xref:System.TimeSpan> 値のテキスト表現を定義します。  空白を含む複数の文字で構成される書式指定文字列は、カスタムの <xref:System.TimeSpan> 書式指定文字列として解釈されます。  詳細については、「[カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)」を参照してください。  
+  
+ <xref:System.TimeSpan> 値の文字列形式は、<xref:System.TimeSpan.ToString%2A?displayProperty=fullName> メソッドのオーバーロードの呼び出しと、<xref:System.String.Format%2A?displayProperty=fullName> などの複合書式指定をサポートするメソッドによって生成されます。  詳細については、「[型の書式設定](../../../docs/standard/base-types/formatting-types.md)」および「[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)」を参照してください。  次の例では、書式設定操作で標準書式指定文字列を使用する方法を示しています。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Standard#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.standard/cs/formatexample1.cs#2)]
+ [!code-vb[Conceptual.TimeSpan.Standard#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.standard/vb/formatexample1.vb#2)]  
+  
+ 標準の <xref:System.TimeSpan> 書式指定文字列は、解析操作に必要な入力文字列の書式を定義するために <xref:System.TimeSpan.ParseExact%2A?displayProperty=fullName> メソッドと <xref:System.TimeSpan.TryParseExact%2A?displayProperty=fullName> メソッドでも使用されます   \(解析では、特定の値の文字列形式が、その値に変換されます\)。次のコード例では、解析操作で標準書式指定文字列を使用する方法を示しています。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Standard#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.standard/cs/parseexample1.cs#3)]
+ [!code-vb[Conceptual.TimeSpan.Standard#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.standard/vb/parseexample1.vb#3)]  
+  
+<a name="top"></a> 標準の時間間隔書式指定子を次の表に示します。  
+  
+|書式指定子|名前|説明|例|  
+|-----------|--------|--------|-------|  
+|"c"|固定 \(不変\) 書式|この指定子はカルチャに依存しません。  `[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]` の書式を使用します。<br /><br /> \("t" と "T" の各書式指定文字列によって生成される結果は同じになります。\)<br /><br /> 詳細については、「[固定の \("c"\) 書式指定子](#Constant)」を参照してください。|`TimeSpan.Zero` \-\> 00:00:00<br /><br /> `New TimeSpan(0, 0, 30, 0)` \-\> 00:30:00<br /><br /> `New TimeSpan(3, 17, 25, 30, 500)` \-\> 3.17:25:30.5000000|  
+|"g"|一般の短い書式|この指定子は必要なものだけを出力します。  カルチャに依存し、`[-][d’:’]h’:’mm’:’ss[.FFFFFFF]` の書式になります。<br /><br /> 詳細については、「[一般の短い \("g"\) 書式指定子](#GeneralShort)」を参照してください。|`New TimeSpan(1, 3, 16, 50, 500)` \-\> 1:3:16:50.5 \(en\-US\)<br /><br /> `New TimeSpan(1, 3, 16, 50, 500)` \-\> 1:3:16:50,5 \(fr\-FR\)<br /><br /> `New TimeSpan(1, 3, 16, 50, 599)` \-\> 1:3:16:50.599 \(en\-US\)<br /><br /> `New TimeSpan(1, 3, 16, 50, 599)` \-\> 1:3:16:50,599 \(fr\-FR\)|  
+|"G"|一般の長い書式|この指定子は、常に日数と 7 桁の小数部を出力します。  カルチャに依存し、`[-]d’:’hh’:’mm’:’ss.fffffff` の書式になります。<br /><br /> 詳細については、「[一般の長い \("G"\) 書式指定子](#GeneralLong)」を参照してください。|`New TimeSpan(18, 30, 0)` \-\> 0:18:30:00.0000000 \(en\-US\)<br /><br /> `New TimeSpan(18, 30, 0)` \-\> 0:18:30:00,0000000 \(fr\-FR\)|  
+  
+<a name="Constant"></a>   
+## 固定の \("c"\) 書式指定子  
+ "c" 書式指定子は、次の書式で <xref:System.TimeSpan> 値の文字列形式を返します。  
+  
+ \[\-\]\[*d*.\]*hh*:*mm*:*ss*\[.*fffffff*\]  
+  
+ 角かっこ \(\[ および \]\) 内の要素は省略可能です。  コロン \(:\) とピリオド \(.\) は、リテラル文字です。  残りの要素について次の表で説明します。  
+  
+|要素|説明|  
+|--------|--------|  
+|*\-*|負の時間間隔を示す、省略可能なマイナス記号。|  
+|*d*|先行ゼロを付けない、省略可能な日数。|  
+|*hh*|"00" ～ "23" の範囲の時間数。|  
+|*mm*|"00" ～ "59" の範囲の分数。|  
+|*ss*|"0" ～ "59" の範囲の秒数。|  
+|*fffffff*|省略可能な秒の小数部。  "0000001" \(1 ティック、つまり 1,000 万分の 1 秒\) ～ "9999999" \(1,000 万分の 9,999,999 秒、つまり 1 秒より 1 ティック少ない\) までの範囲の値が可能です。|  
+  
+ "g" および "G" 書式指定子とは異なり、"c" 書式指定子はカルチャに依存しません。  不変で、かつ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] より前のすべての .NET Framework バージョンに共通する、<xref:System.TimeSpan> 値の文字列形式を生成します。"  c" は、既定の <xref:System.TimeSpan> 書式文字列です。<xref:System.TimeSpan.ToString?displayProperty=fullName> メソッドは、"c" 書式指定文字列を使用して時間間隔値の書式を設定します。  
+  
+> [!NOTE]
+>  <xref:System.TimeSpan> では、動作が "c" 標準書式指定文字列と同じである "t" と "T" の標準書式指定文字列もサポートされます。  
+  
+ 次の例では、2 つの <xref:System.TimeSpan> オブジェクトのインスタンスを作成し、これらを使用して算術演算を実行し、結果を表示します。  いずれの場合も、複合書式指定を使用し、"c" 書式指定子を使用して <xref:System.TimeSpan> 値を表示します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Standard#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.standard/cs/standardc1.cs#1)]
+ [!code-vb[Conceptual.TimeSpan.Standard#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.standard/vb/standardc1.vb#1)]  
+  
+ [表のトップへ](#Top)  
+  
+<a name="GeneralShort"></a>   
+## 一般の短い \("g"\) 書式指定子  
+ "g" <xref:System.TimeSpan> 書式指定子は、必要な要素のみを含めることによって、コンパクトな形式で <xref:System.TimeSpan> 値の文字列形式を返します。  次の書式を使用します。  
+  
+ \[\-\]\[*d*:\]*h*:*mm*:*ss*\[.*FFFFFFF*\]  
+  
+ 角かっこ \(\[ および \]\) 内の要素は省略可能です。  コロン \(:\) は、リテラル文字です。  残りの要素について次の表で説明します。  
+  
+|要素|説明|  
+|--------|--------|  
+|*\-*|負の時間間隔を示す、省略可能なマイナス記号。|  
+|*d*|先行ゼロを付けない、省略可能な日数。|  
+|*h*|先行ゼロを付けない、"0" ～ "23" の範囲の時間数。|  
+|*mm*|"00" ～ "59" の範囲の分数。|  
+|*ss*|"00" ～ "59" の範囲の秒数。|  
+|*.*|秒の小数部の区切り記号。  ユーザー オーバーライドなしで指定されているカルチャの <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> プロパティと同等です。|  
+|*FFFFFFF*|秒の小数部。  可能な限り少ない桁数が表示されます。|  
+  
+ "G" 書式指定子と同様に、"g" 書式指定子はローカライズされます。  その秒の小数部の区切り記号は、現在のカルチャまたは指定されているカルチャの <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> プロパティに基づきます。  
+  
+ 次の例では、2 つの <xref:System.TimeSpan> オブジェクトのインスタンスを作成し、これらを使用して算術演算を実行し、結果を表示します。  いずれの場合も、複合書式指定を使用し、"g" 書式指定子を使用して <xref:System.TimeSpan> 値を表示します。  また、現在のシステム カルチャ \(この場合は、英語 \- 米国 \(en\-US\)\) とフランス語 \- フランス \(fr\-FR\) カルチャの書式指定規則を使用して、<xref:System.TimeSpan> 値の書式を設定します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Standard#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.standard/cs/standardshort1.cs#4)]
+ [!code-vb[Conceptual.TimeSpan.Standard#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.standard/vb/standardshort1.vb#4)]  
+  
+ [表のトップへ](#Top)  
+  
+<a name="GeneralLong"></a>   
+## 一般の長い \("G"\) 書式指定子  
+ "G" <xref:System.TimeSpan> 書式指定子は、常に日数と秒の小数部の両方を含む長い形式で、<xref:System.TimeSpan> 値の文字列形式を返します。  "G" 標準書式指定子によって生成される文字列は、次の書式になります。  
+  
+ \[\-\]*d*:*hh*:*mm*:*ss*.*fffffff*  
+  
+ 角かっこ \(\[ および \]\) 内の要素は省略可能です。  コロン \(:\) は、リテラル文字です。  残りの要素について次の表で説明します。  
+  
+|要素|説明|  
+|--------|--------|  
+|*\-*|負の時間間隔を示す、省略可能なマイナス記号。|  
+|*d*|先行ゼロを付けない日数。|  
+|*hh*|"00" ～ "23" の範囲の時間数。|  
+|*mm*|"00" ～ "59" の範囲の分数。|  
+|*ss*|"00" ～ "59" の範囲の秒数。|  
+|*.*|秒の小数部の区切り記号。  ユーザー オーバーライドなしで指定されているカルチャの <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> プロパティと同等です。|  
+|*fffffff*|秒の小数部。|  
+  
+ "G" 書式指定子と同様に、"g" 書式指定子はローカライズされます。  その秒の小数部の区切り記号は、現在のカルチャまたは指定されているカルチャの <xref:System.Globalization.NumberFormatInfo.NumberDecimalSeparator%2A> プロパティに基づきます。  
+  
+ 次の例では、2 つの <xref:System.TimeSpan> オブジェクトのインスタンスを作成し、これらを使用して算術演算を実行し、結果を表示します。  いずれの場合も、複合書式指定を使用し、"G" 書式指定子を使用して <xref:System.TimeSpan> 値を表示します。  また、現在のシステム カルチャ \(この場合は、英語 \- 米国 \(en\-US\)\) とフランス語 \- フランス \(fr\-FR\) カルチャの書式指定規則を使用して、<xref:System.TimeSpan> 値の書式を設定します。  
+  
+ [!code-csharp[Conceptual.TimeSpan.Standard#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.timespan.standard/cs/standardlong1.cs#5)]
+ [!code-vb[Conceptual.TimeSpan.Standard#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.timespan.standard/vb/standardlong1.vb#5)]  
+  
+ [表のトップへ](#Top)  
+  
+## 参照  
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)   
+ [カスタム時間間隔書式指定文字列](../../../docs/standard/base-types/custom-timespan-format-strings.md)   
+ [文字列の解析](../../../docs/standard/base-types/parsing-strings.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/stringbuilder.md b/docs/standard/base-types/stringbuilder.md
index ea83cbb97e0..378388e062e 100644
--- a/docs/standard/base-types/stringbuilder.md
+++ b/docs/standard/base-types/stringbuilder.md
@@ -1,255 +1,117 @@
 ---
-title: "StringBuilder クラスの使用"
-description: "StringBuilder クラスの使用"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: f4f5d1c7-d84d-4867-810f-2708cd6de0da
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 076e10e095b50cc96187f2ec13ade2365d83dad3
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="using-the-stringbuilder-class"></a>StringBuilder クラスの使用
-
-[String](xref:System.String) オブジェクトは、変更できません。 [System.String](xref:System.String) クラスのメソッドのいずれかを使用するたびに、新しい文字列オブジェクトをメモリ内に作成します。その際、その新しいオブジェクトに対して領域を新たに割り当てる必要があります。 文字列に対して何度も変更を実行する必要がある場合、新しい [String](xref:System.String) オブジェクトの作成に関連したオーバーヘッドが高コストになる可能性があります。 新しいオブジェクトを作成せずに文字列を変更したい場合は、[System.Text.StringBuilder](xref:System.Text.StringBuilder) クラスを使用することができます。 たとえば、ループで多数の文字列を連結する場合に、[StringBuilder](xref:System.Text.StringBuilder) クラスを使用してパフォーマンスを向上させることができます。
-
-## <a name="importing-the-systemtext-namespace"></a>System.Text 名前空間のインポート
-
-[StringBuilder](xref:System.Text.StringBuilder) は [System.Text](xref:System.Text) 名前空間にあります。 完全修飾型名をコードに指定しなくてもすむように、[System.Text](xref:System.Text) 名前空間をインポートすることができます。 
-
-```csharp
-using System;
-using System.Text;
-```
-
-```vb
-Imports System.Text
-```
-
-## <a name="instantiating-a-stringbuilder-object"></a>StringBuilder オブジェクトのインスタンス化
-
-以下の例に示すように、オーバーロードされたコンストラクター メソッドの&1; つで変数を初期化することにより、[StringBuilder](xref:System.Text.StringBuilder) クラスの新しいインスタンスを作成することができます。
-
-```csharp
-StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!")
-```
-
-## <a name="setting-the-capacity-and-length"></a>容量と長さの設定
-
-[StringBuilder](xref:System.Text.StringBuilder) は、カプセル化する文字列内の文字数を拡張できるようにする動的オブジェクトですが、保持可能な最大文字数の値を指定することができます。 この値を、オブジェクトの容量と呼びます。これを現行の [StringBuilder](xref:System.Text.StringBuilder) が保持する文字列の長さと混同すべきではありません。 たとえば、"Hello" という長さ 5 の文字列を持つ [StringBuilder](xref:System.Text.StringBuilder) クラスの新しいインスタンスを作成するときに、オブジェクトの最大容量として 25 を指定することができます。 [StringBuilder](xref:System.Text.StringBuilder) を変更する際、容量に達するまでは、自動再割り当ては発生しません。 容量に達すると、新しい領域が自動的に割り当てられ、容量が&2; 倍になります。 オーバーロードされたコンストラクターのいずれかを使用して、[StringBuilder](xref:System.Text.StringBuilder) クラスの容量を指定することができます。 次の例は、`MyStringBuilder` オブジェクトを最大 25 の領域に拡張できることを示しています。
-
-```csharp
-StringBuilder MyStringBuilder = new StringBuilder("Hello World!", 25);
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!", 25) 
-```
-
-また、[Capacity](xref:System.Text.StringBuilder.Capacity) の読み取り/書き込みプロパティを使用して、オブジェクトの最大長を設定することができます。 次の例では、[Capacity](xref:System.Text.StringBuilder.Capacity) プロパティを使用して、オブジェクトの最大長を定義しています。
-
-```csharp
-MyStringBuilder.Capacity = 25;
-```
-
-```vb
-MyStringBuilder.Capacity = 25
-```
-
-[EnsureCapacity](xref:System.Text.StringBuilder.EnsureCapacity(System.Int32)) メソッドを使用して、現行 [StringBuilder](xref:System.Text.StringBuilder) の容量を確認することができます。 容量が渡された値よりも大きい場合、変更は行われません。しかし、容量が渡された値より小さい場合は、渡された値と一致するよう現行の容量が変更されます。
-
-[Length](xref:System.Text.StringBuilder.Length) プロパティを表示または設定することもできます。 [Length](xref:System.Text.StringBuilder.Length) プロパティを、[Capacity](xref:System.Text.StringBuilder.Capacity) プロパティより大きな値に設定する場合、[Capacity](xref:System.Text.StringBuilder.Capacity) プロパティは [Length](xref:System.Text.StringBuilder.Length) プロパティと同じ値に自動的に変更されます。 [Length](xref:System.Text.StringBuilder.Length) プロパティを、現行の [StringBuilder](xref:System.Text.StringBuilder) 内の文字列の長さより小さい値に設定すると、文字列は短縮されます。
-
-## <a name="modifying-the-stringbuilder-string"></a>StringBuilder 文字列の変更
-
-[StringBuilder](xref:System.Text.StringBuilder) の内容の変更に使用できるメソッドを次の表に一覧表示します。
-
-メソッド名 | 使用
------------ | ---
-[StringBuilder.Append](xref:System.Text.StringBuilder.Append(System.Char)) | 現行の [StringBuilder](xref:System.Text.StringBuilder) の末尾に情報を追加します。
-[StringBuilder.AppendFormat](xref:System.Text.StringBuilder.AppendFormat(System.IFormatProvider,System.String,System.Object)) | 文字列に渡される書式指定子を、書式設定されたテキスト文字列で置き換えます。
-[StringBuilder.Insert](xref:System.Text.StringBuilder.Insert(System.Int32,System.Char)) | 現行の [StringBuilder](xref:System.Text.StringBuilder) の指定されたインデックスに、文字列またはオブジェクトを挿入します。
-[StringBuilder.Remove](xref:System.Text.StringBuilder.Remove(System.Int32,System.Int32)) | 現行の [StringBuilder](xref:System.Text.StringBuilder) から、指定された文字数を削除します。
-[StringBuilder.Replace](xref:System.Text.StringBuilder.Replace(System.Char,System.Char)) | 指定されたインデックスで、指定された文字を置き換えます。
-
-### <a name="append"></a>追加
-
-[StringBuilder.Append](xref:System.Text.StringBuilder.Append(System.Char)) メソッドを使用して、現行 [StringBuilder](xref:System.Text.StringBuilder) によって表される文字列の末尾にオブジェクトのテキストまたは文字列形式を追加することができます。 次の例では、[StringBuilder](xref:System.Text.StringBuilder) を "Hello World" に初期設定し、テキストをオブジェクトの末尾に追加しています。 領域は、必要に応じて自動的に割り当てられます。
-
-```csharp
-StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
-MyStringBuilder.Append(" What a beautiful day.");
-Console.WriteLine(MyStringBuilder);
-// The example displays the following output:
-//       Hello World! What a beautiful day.
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!")
-MyStringBuilder.Append(" What a beautiful day.")
-Console.WriteLine(MyStringBuilder)
-' The example displays the following output:
-'       Hello World! What a beautiful day.
-```
-
-### <a name="appendformat"></a>AppendFormat
-
-[StringBuilder.AppendFormat](xref:System.Text.StringBuilder.AppendFormat(System.IFormatProvider,System.String,System.Object)) メソッドは、[StringBuilder](xref:System.Text.StringBuilder) オブジェクトの末尾にテキストを追加します。 これは、書式設定される&1; つ以上のオブジェクトの [IFormattable](xref:System.IFormattable) 実装を呼び出すことにより、複合書式機能をサポートしています (詳細については、[Composite Formatting](composite-format.md) を参照してください)。 そのため、数値、日時、および列挙の値に対して標準書式文字列を受け取り、数値と日時の値、およびカスタム型に定義されている書式文字列に対してカスタム書式文字列を受け取ります。 (書式設定については、「[型の書式設定](formatting-types.md)」を参照してください。)このメソッドを使用して、変数の書式をカスタマイズし、その値を [StringBuilder](xref:System.Text.StringBuilder) に追加することができます。 次の例では、AppendFormat メソッドを使用して、[StringBuilder](xref:System.Text.StringBuilder) オブジェクトの末尾に、通貨値として書式設定されている整数値を挿入しています。
-
-```csharp
-int MyInt = 25; 
-StringBuilder MyStringBuilder = new StringBuilder("Your total is ");
-MyStringBuilder.AppendFormat("{0:C} ", MyInt);
-Console.WriteLine(MyStringBuilder);
-// The example displays the following output:
-//       Your total is $25.00
-```
-
-```vb
-Dim MyInt As Integer = 25
-Dim MyStringBuilder As New StringBuilder("Your total is ")
-MyStringBuilder.AppendFormat("{0:C} ", MyInt)
-Console.WriteLine(MyStringBuilder)
-' The example displays the following output:
-'     Your total is $25.00 
-```
-
-### <a name="insert"></a>挿入
-
-[StringBuilder.Insert](xref:System.Text.StringBuilder.Insert(System.Int32,System.Char)) メソッドは、現行の [StringBuilder](xref:System.Text.StringBuilder) オブジェクトの指定された位置に、文字列またはオブジェクトを追加します。 次の例では、このメソッドを使用して、[StringBuilder](xref:System.Text.StringBuilder) オブジェクトの&6; 番目の位置に単語を挿入しています。
-
-```csharp
-StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
-MyStringBuilder.Insert(6,"Beautiful ");
-Console.WriteLine(MyStringBuilder);
-// The example displays the following output:
-//       Hello Beautiful World!
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!")
-MyStringBuilder.Insert(6, "Beautiful ")
-Console.WriteLine(MyStringBuilder)
-' The example displays the following output:
-'      Hello Beautiful World!
-```
-
-### <a name="remove"></a>削除
-
-[StringBuilder.Remove](xref:System.Text.StringBuilder.Remove(System.Int32,System.Int32)) メソッドを使用して、現行の [StringBuilder](xref:System.Text.StringBuilder) オブジェクトから指定された文字数を削除します (0 から始まる指定されたインデックスで開始します)。 次の例では、[Remove](xref:System.Text.StringBuilder.Remove(System.Int32,System.Int32)) メソッドを使用して、[StringBuilder](xref:System.Text.StringBuilder) オブジェクトを短縮しています。
-
-```csharp
-StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
-MyStringBuilder.Remove(5,7);
-Console.WriteLine(MyStringBuilder);
-// The example displays the following output:
-//       Hello
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!")
-MyStringBuilder.Remove(5, 7)
-Console.WriteLine(MyStringBuilder)
-' The example displays the following output:
-'       Hello
-```
-
-### <a name="replace"></a>置換
-
-[StringBuilder.Replace](xref:System.Text.StringBuilder.Replace(System.Char,System.Char)) | 指定されたインデックスで、指定された文字を置き換えます。
-メソッドを使用して、[StringBuilder](xref:System.Text.StringBuilder) オブジェクト内の文字を、指定された別の文字で置き換えることができます。 次の例では、[Replace](xref:System.Text.StringBuilder.Replace(System.Char,System.Char)) | 指定されたインデックスで、指定された文字を置き換えます。
-メソッドを使用して、感嘆符 (!) のすべてのインスタンスを求めて [StringBuilder](xref:System.Text.StringBuilder) オブジェクトを検索し、疑問符 (?) で置き換えています。
- 
- ```csharp
- StringBuilder MyStringBuilder = new StringBuilder("Hello World!");
-MyStringBuilder.Replace('!', '?');
-Console.WriteLine(MyStringBuilder);
-// The example displays the following output:
-//       Hello World?
-```
-
-```vb
-Dim MyStringBuilder As New StringBuilder("Hello World!")
-MyStringBuilder.Replace("!"c, "?"c)
-Console.WriteLine(MyStringBuilder)
-' The example displays the following output:
-'       Hello World?
-```
-
-## <a name="converting-a-stringbuilder-object-to-a-string"></a>文字列への StringBuilder オブジェクトの変換
-
-[StringBuilder](xref:System.Text.StringBuilder) オブジェクトで表される文字列を [String](xref:System.String) パラメーターを持つメソッドに渡すかそれをユーザー インターフェイスに表示するには、事前に [StringBuilder](xref:System.Text.StringBuilder) オブジェクトを [String](xref:System.String) オブジェクトに変換する必要があります。 この変換は、[StringBuilder.ToString](xref:System.Text.StringBuilder.ToString) メソッドを呼び出すことによって行います。 次の例では、いくつかの [StringBuilder](xref:System.Text.StringBuilder) メソッドを呼び出し、その後、[StringBuilder.ToString](xref:System.Text.StringBuilder.ToString) メソッドを呼び出して文字列を表示しています。
-
-```csharp
-using System;
-using System.Text;
-
-public class Example
-{
-   public static void Main()
-   {
-      StringBuilder sb = new StringBuilder();
-      bool flag = true;
-      string[] spellings = { "recieve", "receeve", "receive" };
-      sb.AppendFormat("Which of the following spellings is {0}:", flag);
-      sb.AppendLine();
-      for (int ctr = 0; ctr <= spellings.GetUpperBound(0); ctr++) {
-         sb.AppendFormat("   {0}. {1}", ctr, spellings[ctr]);
-         sb.AppendLine();
-      }
-      sb.AppendLine();
-      Console.WriteLine(sb.ToString());
-   }
-}
-// The example displays the following output:
-//       Which of the following spellings is True:
-//          0. recieve
-//          1. receeve
-//          2. receive
-```
-
-```vb
-Imports System.Text
-
-Module Example
-   Public Sub Main()
-      Dim sb As New StringBuilder()
-      Dim flag As Boolean = True
-      Dim spellings() As String = { "recieve", "receeve", "receive" }
-      sb.AppendFormat("Which of the following spellings is {0}:", flag)
-      sb.AppendLine()
-      For ctr As Integer = 0 To spellings.GetUpperBound(0)
-         sb.AppendFormat("   {0}. {1}", ctr, spellings(ctr))
-         sb.AppendLine()
-      Next
-      sb.AppendLine()
-      Console.WriteLine(sb.ToString())
-   End Sub
-End Module
-' The example displays the following output:
-'       Which of the following spellings is True:
-'          0. recieve
-'          1. receeve
-'          2. receive
-```
-
-## <a name="see-also"></a>関連項目
-
-[System.Text.StringBuilder](xref:System.Text.StringBuilder)
-
-[基本的な文字列操作](basic-string-operations.md)
-
-[型の書式設定](formatting-types.md)
-
+title: ".NET Framework における StringBuilder クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Remove メソッド"
+  - "文字列 [.NET Framework]、容量"
+  - "StringBuilder オブジェクト"
+  - "Replace メソッド"
+  - "AppendFormat メソッド"
+  - "Append メソッド"
+  - "Insert メソッド"
+  - "文字列 [.NET Framework]、StringBuilder オブジェクト"
+ms.assetid: 5c14867c-9a99-45bc-ae7f-2686700d377a
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# .NET Framework における StringBuilder クラスの使用
+<xref:System.String> オブジェクトは、変更できません。<xref:System.String?displayProperty=fullName> クラスのメソッドのいずれかを使用するたびに、新しい文字列オブジェクトをメモリ内に作成します。その際、その新しいオブジェクトに対して領域を新たに割り当てる必要があります。 文字列に対して何度も変更を実行する必要がある場合、新しい <xref:System.String> オブジェクトの作成に関連したオーバーヘッドが高コストになる可能性があります。 新しいオブジェクトを作成せずに文字列を変更したい場合は、<xref:System.Text.StringBuilder?displayProperty=fullName> クラスを使用することができます。 たとえば、ループで多数の文字列を連結する場合に、<xref:System.Text.StringBuilder> クラスを使用してパフォーマンスを向上させることができます。  
+  
+## System.Type 名前空間のインポート  
+ <xref:System.Text.StringBuilder> クラスは、<xref:System.Text> 名前空間にあります。  完全修飾型名をコードに指定しなくてもすむように、<xref:System.Text> 名前空間をインポートすることができます。  
+  
+ [!code-cpp[Conceptual.StringBuilder#11](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#11)]
+ [!code-csharp[Conceptual.StringBuilder#11](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#11)]
+ [!code-vb[Conceptual.StringBuilder#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#11)]  
+  
+## StringBuilder オブジェクトのインスタンス化  
+ 以下の例に示すように、オーバーロードされたコンストラクター メソッドの 1 つで変数を初期化することにより、<xref:System.Text.StringBuilder> クラスの新しいインスタンスを作成することができます。  
+  
+ [!code-cpp[Conceptual.StringBuilder#1](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#1)]
+ [!code-csharp[Conceptual.StringBuilder#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#1)]
+ [!code-vb[Conceptual.StringBuilder#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#1)]  
+  
+## 容量と長さの設定  
+ <xref:System.Text.StringBuilder> は、カプセル化する文字列内の文字数を拡張できるようにする動的オブジェクトですが、保持可能な最大文字数の値を指定することができます。 この値を、オブジェクトの容量と呼びます。これを現行の <xref:System.Text.StringBuilder> が保持する文字列の長さと混同すべきではありません。 たとえば、"Hello" という長さ 5 の文字列を持つ <xref:System.Text.StringBuilder> クラスの新しいインスタンスを作成するときに、オブジェクトの最大容量として 25 を指定することができます。<xref:System.Text.StringBuilder> を変更する際、容量に達するまでは、自動再割り当ては発生しません。 容量に達すると、新しい領域が自動的に割り当てられ、容量が 2 倍になります。 オーバーロードされたコンストラクターのいずれかを使用して、<xref:System.Text.StringBuilder> クラスの容量を指定することができます。 次の例は、`MyStringBuilder` オブジェクトを最大 25 の領域に拡張できることを示しています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#2](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#2)]
+ [!code-csharp[Conceptual.StringBuilder#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#2)]
+ [!code-vb[Conceptual.StringBuilder#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#2)]  
+  
+ また、<xref:System.Text.StringBuilder.Capacity%2A> の読み取り\/書き込みプロパティを使用して、オブジェクトの最大長を設定することができます。 次の例では、**Capacity** プロパティを使用して、オブジェクトの最大長を定義しています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#3](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#3)]
+ [!code-csharp[Conceptual.StringBuilder#3](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#3)]
+ [!code-vb[Conceptual.StringBuilder#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#3)]  
+  
+ <xref:System.Text.StringBuilder.EnsureCapacity%2A> メソッドを使用して、現行 **StringBuilder** の容量を確認することができます。 容量が渡された値よりも大きい場合、変更は行われません。しかし、容量が渡された値より小さい場合は、渡された値と一致するよう現行の容量が変更されます。  
+  
+ <xref:System.Text.StringBuilder.Length%2A> プロパティを表示または設定することもできます。**Length** プロパティを、**Capacity** プロパティより大きな値に設定する場合、**Capacity** プロパティは **Length** プロパティと同じ値に自動的に変更されます。**Length** プロパティを、現行の **StringBuilder** 内の文字列の長さより小さい値に設定すると、文字列は短縮されます。  
+  
+## StringBuilder 文字列の変更  
+ **StringBuilder** の内容の変更に使用できるメソッドを次の表に一覧表示します。  
+  
+|メソッド名|使用|  
+|-----------|--------|  
+|<xref:System.Text.StringBuilder.Append%2A?displayProperty=fullName>|現行の **StringBuilder** の末尾に情報を追加します。|  
+|<xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName>|文字列に渡される書式指定子を、書式設定されたテキスト文字列で置き換えます。|  
+|<xref:System.Text.StringBuilder.Insert%2A?displayProperty=fullName>|現行の **StringBuilder** の指定されたインデックスに、文字列またはオブジェクトを挿入します。|  
+|<xref:System.Text.StringBuilder.Remove%2A?displayProperty=fullName>|現行の **StringBuilder** から、指定された文字数を削除します。|  
+|<xref:System.Text.StringBuilder.Replace%2A?displayProperty=fullName>|指定されたインデックスで、指定された文字を置き換えます。|  
+  
+### 追加  
+ **Append** メソッドを使用して、現行 **StringBuilder** によって表される文字列の末尾にオブジェクトのテキストまたは文字列形式を追加することができます。 次の例では、**StringBuilder** を "Hello World" に初期設定し、テキストをオブジェクトの末尾に追加しています。 領域は、必要に応じて自動的に割り当てられます。  
+  
+ [!code-cpp[Conceptual.StringBuilder#4](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#4)]
+ [!code-csharp[Conceptual.StringBuilder#4](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#4)]
+ [!code-vb[Conceptual.StringBuilder#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#4)]  
+  
+### AppendFormat  
+ <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=fullName> メソッドは、<xref:System.Text.StringBuilder> オブジェクトの末尾にテキストを追加します。 これは、書式設定される 1 つ以上のオブジェクトの <xref:System.IFormattable> 実装を呼び出すことにより、複合書式機能をサポートしています \(詳細については、[複合書式指定](../../../docs/standard/base-types/composite-formatting.md) を参照してください\)。 そのため、数値、日時、および列挙の値に対して標準書式文字列を受け取り、数値と日時の値、およびカスタム型に定義されている書式文字列に対してカスタム書式文字列を受け取ります。 \(書式設定については、[型の書式設定](../../../docs/standard/base-types/formatting-types.md) を参照してください。\) このメソッドを使用して、変数の書式をカスタマイズし、その値を <xref:System.Text.StringBuilder> に追加することができます。 次の例では、<xref:System.Text.StringBuilder.AppendFormat%2A> メソッドを使用して、<xref:System.Text.StringBuilder> オブジェクトの末尾に、通貨値として書式設定されている整数値を挿入しています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#5](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#5)]
+ [!code-csharp[Conceptual.StringBuilder#5](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#5)]
+ [!code-vb[Conceptual.StringBuilder#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#5)]  
+  
+### 挿入  
+ <xref:System.Text.StringBuilder.Insert%2A> メソッドは、現行の <xref:System.Text.StringBuilder> オブジェクトの指定された位置に、文字列またはオブジェクトを追加します。 次の例では、このメソッドを使用して、<xref:System.Text.StringBuilder> オブジェクトの 6 番目の位置に単語を挿入しています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#6](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#6)]
+ [!code-csharp[Conceptual.StringBuilder#6](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#6)]
+ [!code-vb[Conceptual.StringBuilder#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#6)]  
+  
+### 削除  
+ **Remove** メソッドを使用して、現行の <xref:System.Text.StringBuilder> オブジェクトから指定された文字数を削除します \(0 から始まる指定されたインデックスで開始します\)。 次の例では、**Remove** メソッドを使用して、<xref:System.Text.StringBuilder> オブジェクトを短縮しています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#7](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#7)]
+ [!code-csharp[Conceptual.StringBuilder#7](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#7)]
+ [!code-vb[Conceptual.StringBuilder#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#7)]  
+  
+### 以前の型  
+ **Replace** メソッドを使用して、<xref:System.Text.StringBuilder> オブジェクト内の文字を、指定された別の文字で置き換えることができます。 次の例では、**Replace** メソッドを使用して、感嘆符 \(\!\) のすべてのインスタンスを求めて <xref:System.Text.StringBuilder> オブジェクトを検索し、疑問符 \(?\) で置き換えています。  
+  
+ [!code-cpp[Conceptual.StringBuilder#8](../../../samples/snippets/cpp/VS_Snippets_CLR/Conceptual.StringBuilder/cpp/example.cpp#8)]
+ [!code-csharp[Conceptual.StringBuilder#8](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/Example.cs#8)]
+ [!code-vb[Conceptual.StringBuilder#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/Example.vb#8)]  
+  
+## 文字列への StringBuilder オブジェクトの変換  
+ <xref:System.Text.StringBuilder> オブジェクトで表される文字列を <xref:System.String> パラメーターを持つメソッドに渡すかそれをユーザー インターフェイスに表示するには、事前に <xref:System.Text.StringBuilder> オブジェクトを <xref:System.String> オブジェクトに変換する必要があります。 この変換は、<xref:System.Text.StringBuilder.ToString%2A?displayProperty=fullName> メソッドを呼び出すことによって行います。 次の例では、いくつかの <xref:System.Text.StringBuilder> メソッドを呼び出し、その後、<xref:System.Text.StringBuilder.ToString?displayProperty=fullName> メソッドを呼び出して文字列を表示しています。  
+  
+ [!code-csharp[Conceptual.StringBuilder#10](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/tostringexample1.cs#10)]
+ [!code-vb[Conceptual.StringBuilder#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/tostringexample1.vb#10)]  
+  
+## 参照  
+ <xref:System.Text.StringBuilder?displayProperty=fullName>   
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)   
+ [型の書式設定](../../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/substitutions-in-regular-expressions.md b/docs/standard/base-types/substitutions-in-regular-expressions.md
new file mode 100644
index 00000000000..1a717444723
--- /dev/null
+++ b/docs/standard/base-types/substitutions-in-regular-expressions.md
@@ -0,0 +1,224 @@
+---
+title: "正規表現での置換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 置換"
+  - "構成体, 置換"
+  - "メタ文字, 置換"
+  - "正規表現, 置換"
+  - "置換パターン"
+  - "置換"
+ms.assetid: d1f52431-1c7d-4dc6-8792-6b988256892e
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 正規表現での置換
+<a name="Top"></a> 置換は、置換パターン内でのみ認識される言語要素です。 置換では、正規表現パターンを使用して、入力文字列内の一致するテキストを置換するテキストの全体または一部を定義します。 置換パターンは、1 個以上の置換と、リテラル文字で構成されます。 置換パターンは、<xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> パラメーターを持つ `replacement` メソッドのオーバーロードおよび <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドに対して用意されています。 メソッドは、一致するパターンを、`replacement` パラメーターで定義されているパターンで置換します。  
+  
+ .NET Framework では、次の表に示す置換要素が定義されています。  
+  
+|代入|説明|  
+|--------|--------|  
+|`$` *number*|*number* で識別されるキャプチャ グループに一致する最後の部分文字列を置換文字列に含めます。*number* は 10 進値です。 詳細については、「[番号付きグループの置換](#Numbered)」を参照してください。|  
+|`${` *name* `}`|`(?<` *name* `> )` で指定された名前付きグループに一致する最後の部分文字列を置換文字列に含めます。 詳細については、「[名前付きグループの置換](#Named)」を参照してください。|  
+|`$$`|置換文字列に 1 つの "$" リテラルを含めます。 詳細については、「["$" 文字の置換](#DollarSign)」を参照してください。|  
+|`$&`|一致した文字列全体のコピーを置換文字列に含めます。 詳細については、「[一致した文字列全体の置換](#EntireMatch)」を参照してください。|  
+|`$``|一致した場所より前にある入力文字列のテキストすべてを置換文字列に含めます。 詳細については、「[一致した文字列より前にあるテキストの置換](#BeforeMatch)」を参照してください。|  
+|`$'`|一致した場所より後にある入力文字列のテキストすべてを置換文字列に含めます。 詳細については、「[一致した文字列より後にあるテキストの置換](#AfterMatch)」を参照してください。|  
+|`$+`|最後にキャプチャされたグループを置換文字列に含めます。 詳細については、「[キャプチャされた最後のグループの置換](#LastGroup)」を参照してください。|  
+|`$_`|入力文字列全体を置換文字列に含めます。 詳細については、「[入力文字列全体の置換](#EntireString)」を参照してください。|  
+  
+## 置換要素と置換パターン  
+ 置換構成体は、置換パターンで認識される特殊な構成体です。 文字エスケープやピリオド \(`.`\) など、任意の文字に一致する他の正規表現言語要素はいずれもサポートされていません。 同様に、置換言語要素は置換パターン内でのみ認識され、正規表現パターン内では有効ではありません。  
+  
+ 正規表現パターンと置換の両方に使用できる文字は `$` 文字だけですが、この文字の意味はコンテキストによって異なります。 正規表現パターンでは、`$` は文字列の末尾に一致するアンカーです。 置換パターンでは、`$` は置換の先頭を示します。  
+  
+> [!NOTE]
+>  正規表現の中で置換パターンに似た機能を利用するには、前方参照を使用します。 前方参照の詳細については、「[前方参照構成体](../../../docs/standard/base-types/backreference-constructs-in-regular-expressions.md)」を参照してください。  
+  
+<a name="Numbered"></a>   
+## 番号付きグループの置換  
+ `$` *number* 言語要素は、*number* キャプチャ グループに一致する最後の部分文字列を置換文字列に含めます。*number* は、キャプチャ グループのインデックスです。 たとえば、置換パターン `$1` は、一致した部分文字列がキャプチャされた最初のグループに置き換えられることを示します。 番号付きキャプチャ グループの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+ `$` 以降のすべての数字が、*number* グループに所属すると解釈されます。 そうしたくない場合は、代わりに名前付きグループを使用できます。 たとえば、`${1}1` の代わりに、置換文字列 `$11` を使用して、最初のキャプチャ グループの値と数字 "1" を置換文字列として定義できます。 詳細については、「[名前付きグループの置換](#Named)」を参照してください。  
+  
+ `(?<` *name* `>)` 構文を使用して名前が明示的に割り当てられていないキャプチャ グループには、1 から開始する番号が左から右の順に割り当てられます。 名前付きグループにも、最後の名前のないグループのインデックスよりも 1 つ大きい数値から開始する番号が、左から右へと順に割り当てられます。 たとえば、正規表現 `(\w)(?<digit>\d)` では、`digit` という名前付きグループのインデックスは 2 です。  
+  
+ *number* が、正規表現パターンで定義される有効なキャプチャ グループを指定していない場合は、`$`*number* が、一致した各文字列の置換に使用されるリテラル文字列シーケンスとして解釈されます。  
+  
+ 次の例では、`$`*number* の置換を使用して、10 進値から通貨記号を削除しています。 通貨値の先頭または末尾に見つかった通貨記号を削除し、最も一般的な 2 つの桁区切り記号 \("." および ","\) を認識します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Substitutions#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/numberedgroup1.cs#1)]
+ [!code-vb[Conceptual.RegEx.Language.Substitutions#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/numberedgroup1.vb#1)]  
+  
+ 正規表現パターン `\p{Sc}*(\s?\d+[.,]?\d*)\p{Sc}*` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\p{Sc}*`|0 個以上の通貨記号文字と一致します。|  
+|`\s?`|0 個または 1 個の空白文字と一致します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`[.,]?`|0 個または 1 個のピリオドまたはコンマと一致します。|  
+|`\d*`|0 個以上の 10 進数と一致します。|  
+|`(\s?\d+[.,]?\d*)`|空白の後に 1 つ以上の 10 進数、0 個または 1 個のピリオドまたはコンマ、さらに 0 個以上の 10 進数が続くパターンに一致します。 これが最初のキャプチャ グループです。 置換パターンは `$1` であるため、<xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドを呼び出すと、一致する部分文字列全体がこのキャプチャされたグループに置き換えられます。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="Named"></a>   
+## 名前付きのグループの置換  
+ `${` *name* `}` 言語要素は、*name* キャプチャ グループに一致する最後の部分文字列を置換します。ここで、*name* は `(?<`*name*`>)` 言語要素で定義されているキャプチャ グループの名前です。 名前付きキャプチャ グループの詳細については、「[グループ化構成体](../../../docs/standard/base-types/grouping-constructs-in-regular-expressions.md)」を参照してください。  
+  
+ *name* が正規表現パターンで定義されている有効な名前付きキャプチャ グループを指定していないものの、数字で構成されている場合、`${`*name*`}` は番号付きグループとして解釈されます。  
+  
+ *name* が、正規表現パターンで定義されている有効な名前付きキャプチャ グループも有効な番号付きキャプチャ グループも指定していない場合、`${`*name*`}` は、一致した各文字列の置換に使用されるリテラル文字列シーケンスとして解釈されます。  
+  
+ 次の例では、`${`*name*`}` の置換を使用して、10 進値から通貨記号を削除しています。 通貨値の先頭または末尾に見つかった通貨記号を削除し、最も一般的な 2 つの桁区切り記号 \("." および ","\) を認識します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Substitutions#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/namedgroup1.cs#2)]
+ [!code-vb[Conceptual.RegEx.Language.Substitutions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/namedgroup1.vb#2)]  
+  
+ 正規表現パターン `\p{Sc}*(?<amount>\s?\d[.,]?\d*)\p{Sc}*` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\p{Sc}*`|0 個以上の通貨記号文字と一致します。|  
+|`\s?`|0 個または 1 個の空白文字と一致します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`[.,]?`|0 個または 1 個のピリオドまたはコンマと一致します。|  
+|`\d*`|0 個以上の 10 進数と一致します。|  
+|`(?<amount>\s?\d[.,]?\d*)`|空白の後に 1 つ以上の 10 進数、0 個または 1 個のピリオドまたはコンマ、さらに 0 個以上の 10 進数が続くパターンに一致します。 これは、`amount` という名前のキャプチャ グループです。 置換パターンは `${amount}` であるため、<xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドを呼び出すと、一致する部分文字列全体がこのキャプチャされたグループに置き換えられます。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="DollarSign"></a>   
+## "$" 文字の置換  
+ `$$` の置換は、リテラル文字 "$" を置換文字列に挿入します。  
+  
+ 次の例では、<xref:System.Globalization.NumberFormatInfo> オブジェクトを使用して、現在のカルチャの通貨記号と、通貨文字列内でのその配置を決定します。 次に、正規表現パターンと置換パターンの両方を動的に構築します。 現在 en\-US カルチャが使用されているコンピューターでこの例を実行すると、`\b(\d+)(\.(\d+))?` という正規表現パターンと `$$ $1$2` という置換パターンが生成されます。 置換パターンは、一致するテキストを、通貨記号と空白に続いて、キャプチャされた最初および 2 番目のグループで置換します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Substitutions#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/dollarsign1.cs#8)]
+ [!code-vb[Conceptual.Regex.Language.Substitutions#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/dollarsign1.vb#8)]  
+  
+ 正規表現パターン `\b(\d+)(\.(\d+))?` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界の先頭から照合を開始します。|  
+|`(\d+)`|1 個以上の 10 進数と一致します。 これが最初のキャプチャ グループです。|  
+|`\.`|ピリオド \(桁区切り記号\) と一致します。|  
+|`(\d+)`|1 個以上の 10 進数と一致します。 これが 3 番目のキャプチャ グループです。|  
+|`(\.(\d+))?`|ピリオドの後に 1 つ以上の 10 進数が続くパターンの 0 回または 1 回の出現と一致します。 これが 2 番目のキャプチャ グループです。|  
+  
+<a name="EntireMatch"></a>   
+## 一致した文字列全体の置換  
+ `$&` の置換は、一致した文字列全体を置換文字列に含めます。 通常は、一致した文字列の先頭または末尾に部分文字列を追加するために使用されます。 たとえば、`($&)` という置換パターンは、一致した各文字列の先頭と末尾にかっこを追加します。 一致する文字列がない場合、`$&` の置換は無効です。  
+  
+ `$&` の置換を使用して、文字列配列に格納されている書籍タイトルの先頭と末尾に引用符を追加する例を次に示します。  
+  
+ [!code-csharp[Conceptual.RegEx.Language.Substitutions#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/entirematch1.cs#3)]
+ [!code-vb[Conceptual.RegEx.Language.Substitutions#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/entirematch1.vb#3)]  
+  
+ 正規表現パターン `^(\w+\s?)+$` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力文字列の先頭から照合を開始します。|  
+|`(\w+\s?)+`|1 つ以上の単語文字の後に 0 個または 1 個の空白文字が 1 回以上続くパターンに一致します。|  
+|`$`|入力文字列の末尾と一致します。|  
+  
+ `"$&"` という置換パターンは、各一致文字列の先頭と末尾にリテラルの一重引用符を追加します。  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="BeforeMatch"></a>   
+## 一致した文字列より前にあるテキストの置換  
+ `$`` の置換は、一致した場所より前にある入力文字列全体で一致した文字列を置換します。 つまり、一致した場所までの入力文字列を複製し、一致したテキストを削除します。 結果文字列では、一致したテキストに続くテキストは変更されません。 入力文字列に複数の一致文字列がある場合、置換テキストは、テキストが前の一致で置換された文字列からではなく、元の入力文字列から派生します  \(具体的な例を次に示します\)。 一致する文字列がない場合、`$`` の置換は無効です。  
+  
+ 次の例では、正規表現パターン `\d+` を使用して、入力文字列内の 1 つ以上の 10 進数のシーケンスを照合します。 置換文字列 `$`` は、これらの数字を、一致文字列より前にあるテキストで置換します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Substitutions#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/before1.cs#4)]
+ [!code-vb[Conceptual.Regex.Language.Substitutions#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/before1.vb#4)]  
+  
+ この例では、入力文字列 `"aa1bb2cc3dd4ee5"` に 5 つの一致が含まれています。`$`` の置換によって、正規表現エンジンが入力文字列の各一致文字列をどのように置換するかを、次の表に示します。 挿入されたテキストは結果列に太字で示されています。  
+  
+|一致したもの|位置|一致した場所より前にある文字列|結果文字列|  
+|------------|--------|---------------------|-----------|  
+|1|2|aa|aa`aa`bb2cc3dd4ee5|  
+|2|5|aa1bb|aaaabb`aa1bb`cc3dd4ee5|  
+|3|8|aa1bb2cc|aaaabbaa1bbcc`aa1bb2cc`dd4ee5|  
+|4|11|aa1bb2cc3dd|aaaabbaa1bbccaa1bb2ccdd`aa1bb2cc3dd`ee5|  
+|5|14|aa1bb2cc3dd4ee|aaaabbaa1bbccaa1bb2ccddaa1bb2cc3ddee `aa1bb2cc3dd4ee`|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="AfterMatch"></a>   
+## 一致した文字列より後にあるテキストの置換  
+ `$'` の置換は、一致した場所より後にある入力文字列全体で一致した文字列を置換します。 つまり、一致した場所より後にある入力文字列を複製し、一致したテキストを削除します。 結果文字列では、一致したテキストより前にあるテキストは変更されません。 一致する文字列がない場合、`$'` の置換は無効です。  
+  
+ 次の例では、正規表現パターン `\d+` を使用して、入力文字列内の 1 つ以上の 10 進数のシーケンスを照合します。 置換文字列 `$'` は、これらの数字を、一致文字列に続くテキストで置換します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Substitutions#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/after1.cs#5)]
+ [!code-vb[Conceptual.Regex.Language.Substitutions#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/after1.vb#5)]  
+  
+ この例では、入力文字列 `"aa1bb2cc3dd4ee5"` に 5 つの一致が含まれています。`$'` の置換によって、正規表現エンジンが入力文字列の各一致文字列をどのように置換するかを、次の表に示します。 挿入されたテキストは結果列に太字で示されています。  
+  
+|一致したもの|位置|一致した場所より後にある文字列|結果文字列|  
+|------------|--------|---------------------|-----------|  
+|1|2|bb2cc3dd4ee5|aa`bb2cc3dd4ee5`bb2cc3dd4ee5|  
+|2|5|cc3dd4ee5|aabb2cc3dd4ee5bb`cc3dd4ee5`cc3dd4ee5|  
+|3|8|dd4ee5|aabb2cc3dd4ee5bbcc3dd4ee5cc`dd4ee5`dd4ee5|  
+|4|11|ee5|aabb2cc3dd4ee5bbcc3dd4ee5ccdd4ee5dd`ee5`ee5|  
+|5|14|<xref:System.String.Empty?displayProperty=fullName>|aabb2cc3dd4ee5bbcc3dd4ee5ccdd4ee5ddee5ee|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="LastGroup"></a>   
+## キャプチャされた最後のグループの置換  
+ `$+` の置換は、キャプチャされた最後のグループで一致した文字列を置換します。 キャプチャされたグループがない場合、またはキャプチャされた最後のグループの値が <xref:System.String.Empty?displayProperty=fullName> の場合、`$+` の置換は無効です。  
+  
+ 次の例では、文字列内の重複する単語を識別し、`$+` の置換を使用して、これらの単語をその単語 1 つに置換します。<xref:System.Text.RegularExpressions.RegexOptions?displayProperty=fullName> オプションを使用すると、大文字と小文字の違いを除いて同一である単語が重複と見なされるようになります。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Substitutions#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/lastmatch1.cs#6)]
+ [!code-vb[Conceptual.Regex.Language.Substitutions#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/lastmatch1.vb#6)]  
+  
+ 正規表現パターン `\b(\w+)\s\1\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これが最初のキャプチャ グループです。|  
+|`\s`|空白文字と一致します。|  
+|`\1`|キャプチャされた最初のグループと一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ [ページのトップへ](#Top)  
+  
+<a name="EntireString"></a>   
+## 入力文字列全体の置換  
+ `$_` の置換は、一致した文字列を入力文字列全体で置換します。 つまり、一致したテキストを削除し、一致したテキストを含む文字列全体でそのテキストを置換します。  
+  
+ 次の例では、入力文字列の 1 つ以上の 10 進数を照合します。`$_` の置換を使用して、これらを入力文字列全体で置換します。  
+  
+ [!code-csharp[Conceptual.Regex.Language.Substitutions#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regex.language.substitutions/cs/entire1.cs#7)]
+ [!code-vb[Conceptual.Regex.Language.Substitutions#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regex.language.substitutions/vb/entire1.vb#7)]  
+  
+ この例では、入力文字列 `"ABC123DEF456"` に 2 つの一致が含まれています。`$_` の置換によって、正規表現エンジンが入力文字列の各一致文字列をどのように置換するかを、次の表に示します。 挿入されたテキストは結果列に太字で示されています。  
+  
+|一致したもの|位置|一致したもの|結果文字列|  
+|------------|--------|------------|-----------|  
+|1|3|123|ABC`ABC123DEF456`DEF456|  
+|2|5|456|ABCABC123DEF456DEF`ABC123DEF456`|  
+  
+## 参照  
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/the-regular-expression-object-model.md b/docs/standard/base-types/the-regular-expression-object-model.md
new file mode 100644
index 00000000000..d85efa735dd
--- /dev/null
+++ b/docs/standard/base-types/the-regular-expression-object-model.md
@@ -0,0 +1,358 @@
+---
+title: "正規表現のオブジェクト モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, 逆参照"
+  - ".NET Framework 正規表現, クラス"
+  - "逆参照"
+  - "Capture クラス"
+  - "CaptureCollection クラス"
+  - "文字 [.NET Framework], 逆参照"
+  - "文字 [.NET Framework], メタ文字"
+  - "文字 [.NET Framework], 正規表現"
+  - "クラス [.NET Framework], 正規表現"
+  - "Group クラス"
+  - "GroupCollection クラス"
+  - "Match クラス"
+  - "MatchCollection クラス"
+  - "メタ文字, 逆参照"
+  - "メタ文字, 正規表現クラス"
+  - "解析 (正規表現を使用したテキストを), 逆参照"
+  - "解析 (正規表現を使用したテキストを), クラス"
+  - "パターン一致 (正規表現を使用した), 逆参照"
+  - "パターン一致 (正規表現を使用した), クラス"
+  - "Regex クラス"
+  - "正規表現 [.NET Framework]"
+  - "正規表現 [.NET Framework], 逆参照"
+  - "正規表現 [.NET Framework], クラス"
+  - "繰り返し出現する文字グループ"
+  - "検索 (正規表現を使用した), 逆参照"
+  - "検索 (正規表現を使用した), クラス"
+  - "文字列 [.NET Framework], 正規表現"
+  - "部分文字列"
+ms.assetid: 49a21470-64ca-4b5a-a889-8e24e3c0af7e
+caps.latest.revision: 26
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 26
+---
+# 正規表現のオブジェクト モデル
+<a name="introduction"></a> ここでは、.NET Framework の正規表現を扱うときに使用するオブジェクト モデルについて説明します。 このチュートリアルは、次のセクションで構成されています。  
+  
+-   [正規表現エンジン](#Engine)  
+  
+-   [MatchCollection オブジェクトと Match オブジェクト](#Match_and_MCollection)  
+  
+-   [GroupCollection](#GroupCollection)  
+  
+-   [キャプチャ グループ](#the_captured_group)  
+  
+-   [CaptureCollection](#CaptureCollection)  
+  
+-   [個々のキャプチャ](#the_individual_capture)  
+  
+<a name="Engine"></a>   
+## 正規表現エンジン  
+ .NET Framework の正規表現エンジンは、<xref:System.Text.RegularExpressions.Regex> クラスによって表されます。 正規表現エンジンは、正規表現の解析とコンパイル、および正規表現パターンと入力文字列を照合する操作を実行します。 エンジンは、.NET Framework 正規表現のオブジェクト モデルの中核となるコンポーネントです。  
+  
+ 正規表現エンジンは、次のいずれかの方法で使用できます。  
+  
+-   <xref:System.Text.RegularExpressions.Regex> クラスの静的メソッドを呼び出す。 メソッドのパラメーターには、入力文字列と正規表現パターンが含まれます。 静的メソッド呼び出しで使用した正規表現は、正規表現エンジンによってキャッシュされるので、同じ正規表現を使用する静的正規表現メソッドを繰り返し呼び出す場合、パフォーマンスが比較的向上します。  
+  
+-   正規表現をクラス コンストラクターに渡して <xref:System.Text.RegularExpressions.Regex> オブジェクトをインスタンス化する。 この場合、<xref:System.Text.RegularExpressions.Regex> オブジェクトは変更不可 \(読み取り専用\) で、単一の正規表現と密に結合された正規表現エンジンを表します。<xref:System.Text.RegularExpressions.Regex> インスタンスによって使用される正規表現はキャッシュされないので、同じ正規表現で <xref:System.Text.RegularExpressions.Regex> オブジェクトを複数回インスタンス化しないでください。  
+  
+ <xref:System.Text.RegularExpressions.Regex> クラスのメソッドを呼び出すと、次のような処理を実行できます。  
+  
+-   文字列が正規表現パターンと一致するかどうかを確認する。  
+  
+-   単一の一致または最初の一致を抽出する。  
+  
+-   すべての一致を抽出する。  
+  
+-   一致した部分文字列を置換する。  
+  
+-   単一の文字列を文字列配列に分割する。  
+  
+ ここでは、これらの操作について説明します。  
+  
+### 正規表現パターンの照合  
+ <xref:System.Text.RegularExpressions.Regex.IsMatch%2A?displayProperty=fullName> メソッドは、文字列がパターンと一致する場合は `true` を返し、一致しない場合は `false` を返します。<xref:System.Text.RegularExpressions.Regex.IsMatch%2A> メソッドは、文字列入力を検証する場合によく使用されます。 たとえば、次のコードでは、文字列は米国の有効な社会保障番号と一致します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/validate1.cs#1)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/validate1.vb#1)]  
+  
+ この正規表現パターン `^\d{3}-\d{2}-\d{4}$` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力文字列の先頭と一致します。|  
+|`\d{3}`|3 個の 10 進数と一致します。|  
+|`-`|ハイフンと一致します。|  
+|`\d{2}`|2 桁の 10 進数と一致します。|  
+|`-`|ハイフンと一致します。|  
+|`\d{4}`|4 桁の 10 進数と一致します。|  
+|`$`|入力文字列の末尾と一致します。|  
+  
+### 単一の一致または最初の一致の抽出  
+ <xref:System.Text.RegularExpressions.Regex.Match%2A?displayProperty=fullName> メソッドは、正規表現パターンに一致する最初の部分文字列の情報を含む <xref:System.Text.RegularExpressions.Match> オブジェクトを返します。`Match.Success` プロパティが `true` \(一致する文字列が見つかったことを示す\) を返す場合は、<xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドを呼び出すと後続の一致する文字列の情報を取得できます。 これらのメソッド呼び出しは、`Match.Success` プロパティによって `false` が返されるまで続行できます。 たとえば、次のコードでは、<xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドを使用して、重複する単語が文字列内で最初に出現する位置を検索します。 次に、<xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドを呼び出してその他の出現位置を検索します。 この例では、メソッドを呼び出すごとに `Match.Success` プロパティを調べ、現在の一致が成功したかどうか、および続けて <xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドを呼び出す必要があるかどうかを確認します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/match1.cs#2)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/match1.vb#2)]  
+  
+ この正規表現パターン `\b(\w+)\W+(\1)\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これが最初のキャプチャ グループです。|  
+|`\W+`|1 個以上の単語文字に使用されない文字と一致します。|  
+|`(\1)`|最初にキャプチャされた文字列と一致します。 これが 2 番目のキャプチャ グループです。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+### すべての一致の抽出  
+ <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドは、入力文字列で正規表現エンジンによって検出されたすべての一致文字列の情報を含む <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトを返します。 たとえば、前の例を書き換えて、<xref:System.Text.RegularExpressions.Regex.Matches%2A> メソッドと <xref:System.Text.RegularExpressions.Regex.Match%2A> メソッドではなく <xref:System.Text.RegularExpressions.Match.NextMatch%2A> メソッドを呼び出すことができます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/matches1.cs#3)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/matches1.vb#3)]  
+  
+### 一致した部分文字列の置換  
+ <xref:System.Text.RegularExpressions.Regex.Replace%2A?displayProperty=fullName> メソッドは、正規表現パターンに一致した各部分文字列を指定された文字列または正規表現パターンに置き換えて、置換が適用された入力文字列全体を返します。 たとえば、次のコードでは、文字列内の 10 進数の前に米国の通貨記号が追加されます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/replace1.cs#4)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/replace1.vb#4)]  
+  
+ この正規表現パターン `\b\d+\.\d{2}\b` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`\.`|ピリオドと一致します。|  
+|`\d{2}`|2 桁の 10 進数と一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ 置換パターン `$$$&` の解釈を次の表に示します。  
+  
+|パターン|置換文字列|  
+|----------|-----------|  
+|`$$`|ドル記号 \($\) 文字。|  
+|`$&`|一致した部分文字列全体。|  
+  
+### 単一の文字列の文字列配列への分割  
+ <xref:System.Text.RegularExpressions.Regex.Split%2A?displayProperty=fullName> メソッドは、正規表現によって定義されている位置で、入力文字列を分割します。 たとえば、次のコードでは、番号付きリストの項目を文字列配列に配置します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/split1.cs#5)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/split1.vb#5)]  
+  
+ この正規表現パターン `\b\d{1,2}\.\s` の解釈を次の表に示します。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\d{1,2}`|1 桁または 2 桁の 10 進数と一致します。|  
+|`\.`|ピリオドと一致します。|  
+|`\s`|空白文字と一致します。|  
+  
+<a name="Match_and_MCollection"></a>   
+## MatchCollection オブジェクトと Match オブジェクト  
+ Regex メソッドは、正規表現のオブジェクト モデルに含まれる <xref:System.Text.RegularExpressions.MatchCollection> と <xref:System.Text.RegularExpressions.Match> の 2 つのオブジェクトを返します。  
+  
+<a name="the_match_collection"></a>   
+### MatchCollection  
+ <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドは、正規表現エンジンによって検出されたすべての一致文字列を入力文字列に出現する順序で表す <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトを含む <xref:System.Text.RegularExpressions.Match> オブジェクトを返します。 一致文字列がない場合、このメソッドはメンバーを持たない <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトを返します。<xref:System.Text.RegularExpressions.MatchCollection.Item%2A?displayProperty=fullName> プロパティを使用すると、コレクションの個々のメンバーに、0 から <xref:System.Text.RegularExpressions.MatchCollection.Count%2A?displayProperty=fullName> プロパティの値より 1 小さい値までの範囲のインデックスでアクセスできます。<xref:System.Text.RegularExpressions.MatchCollection.Item%2A> は、コレクションのインデクサー \(C\# の場合\) および既定のプロパティ \(Visual Basic の場合\) です。  
+  
+ 既定では、<xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> メソッドを呼び出すと、遅延評価を使用して <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトに値が設定されます。 値の設定が完了しているコレクションを必要とするプロパティ \(<xref:System.Text.RegularExpressions.MatchCollection.Count%2A?displayProperty=fullName> プロパティや <xref:System.Text.RegularExpressions.MatchCollection.Item%2A?displayProperty=fullName> プロパティなど\) にアクセスする場合は、パフォーマンスが低下する可能性があります。 そのため、<xref:System.Collections.IEnumerator> メソッドによって返される <xref:System.Text.RegularExpressions.MatchCollection.GetEnumerator%2A?displayProperty=fullName> オブジェクトを使用してコレクションにアクセスすることをお勧めします。 個々の言語には、コレクションの `For` インターフェイスをラップする構成体 \(Visual Basic の `Each``foreach` や C\# の <xref:System.Collections.IEnumerator> など\) が用意されています。  
+  
+ 次の例では、<xref:System.Text.RegularExpressions.Regex.Matches%28System.String%29?displayProperty=fullName> メソッドを使用して、入力文字列の中で見つかったすべての一致を <xref:System.Text.RegularExpressions.MatchCollection> オブジェクトに設定します。 この例では、コレクションを列挙して一致文字列を文字列配列にコピーし、文字位置を整数配列に記録します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/matchcollection1.cs#6)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/matchcollection1.vb#6)]  
+  
+<a name="the_match"></a>   
+### Match  
+ <xref:System.Text.RegularExpressions.Match> クラスは、1 回の正規表現検索に一致した結果を表します。<xref:System.Text.RegularExpressions.Match> オブジェクトには 2 つの方法でアクセスできます。  
+  
+-   <xref:System.Text.RegularExpressions.MatchCollection> メソッドから返される <xref:System.Text.RegularExpressions.Regex.Matches%2A?displayProperty=fullName> オブジェクトから取得する。 個々の <xref:System.Text.RegularExpressions.Match> オブジェクトを取得するには、`foreach` 構成体 \(C\# の場合\) または `For Each`...`Next` 構成体 \(Visual Basic の場合\) を使用してコレクションを反復処理するか、<xref:System.Text.RegularExpressions.MatchCollection.Item%2A?displayProperty=fullName> プロパティを使用してインデックスまたは名前で特定の <xref:System.Text.RegularExpressions.Match> オブジェクトを取得します。 また、0 からコレクションのオブジェクト数より 1 小さい値までの範囲のインデックスでコレクションを反復処理して、コレクションから個々の <xref:System.Text.RegularExpressions.Match> オブジェクトを取得することもできます。 ただし、このメソッドは <xref:System.Text.RegularExpressions.MatchCollection.Count%2A?displayProperty=fullName> プロパティにアクセスするので、遅延評価を活用できません。  
+  
+     次の例では、<xref:System.Text.RegularExpressions.Match> 構成体または <xref:System.Text.RegularExpressions.MatchCollection>...`foreach` 構成体を使用してコレクションを反復処理することで、個々の `For Each` オブジェクトを `Next` オブジェクトから取得します。 この正規表現は、単純に入力文字列内の文字列 "abc" と一致します。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.ObjectModel#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/match2.cs#7)]
+     [!code-vb[Conceptual.RegularExpressions.ObjectModel#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/match2.vb#7)]  
+  
+-   文字列または文字列の一部で最初に一致する文字列を表す <xref:System.Text.RegularExpressions.Regex.Match%2A?displayProperty=fullName> オブジェクトを返す <xref:System.Text.RegularExpressions.Match> メソッドを呼び出す。`Match.Success` プロパティの値を取得すると、一致文字列が見つかったかどうかを確認できます。 後続の一致する文字列を表す <xref:System.Text.RegularExpressions.Match> オブジェクトを取得するには、返された <xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> オブジェクトの `Success` プロパティが <xref:System.Text.RegularExpressions.Match> になるまで `false` メソッドを繰り返し呼び出します。  
+  
+     次の例では、入力文字列内の文字列 "abc" と一致する <xref:System.Text.RegularExpressions.Regex.Match%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドと <xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドを使用します。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.ObjectModel#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/match3.cs#8)]
+     [!code-vb[Conceptual.RegularExpressions.ObjectModel#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/match3.vb#8)]  
+  
+ <xref:System.Text.RegularExpressions.Match> クラスの 2 つのプロパティによってコレクション オブジェクトが返されます。  
+  
+-   <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> プロパティは、正規表現パターンのキャプチャ グループに一致する部分文字列の情報を含む <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトを返します。  
+  
+-   `Match.Captures` プロパティは、用途が限定された <xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトを返します。<xref:System.Text.RegularExpressions.Match> オブジェクトの `Success` プロパティが `false` の場合、コレクションに値は設定されません。 それ以外の場合は、<xref:System.Text.RegularExpressions.Capture> オブジェクトと同じ情報を含む単一の <xref:System.Text.RegularExpressions.Match> オブジェクトが格納されます。  
+  
+ これらのオブジェクトの詳細については、このトピックで後述する「[GroupCollection](#GroupCollection)」および「[CaptureCollection](#CaptureCollection)」を参照してください。  
+  
+ <xref:System.Text.RegularExpressions.Match> クラスの 2 つの追加プロパティに、一致文字列の情報が保持されます。`Match.Value` プロパティは、正規表現パターンに一致する入力文字列内の部分文字列を返します。`Match.Index` プロパティは、入力文字列内の一致する文字列の 0 から始まる開始位置を返します。  
+  
+ <xref:System.Text.RegularExpressions.Match> クラスには、2 つのパターン一致メソッドもあります。  
+  
+-   <xref:System.Text.RegularExpressions.Match.NextMatch%2A?displayProperty=fullName> メソッドは、現在の <xref:System.Text.RegularExpressions.Match> オブジェクトで表される一致文字列の後の一致文字列を検索し、その一致文字列を表す <xref:System.Text.RegularExpressions.Match> オブジェクトを返します。  
+  
+-   <xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドは、一致した文字列に対して指定された置換操作を実行し、その結果を返します。  
+  
+ 次の例では、<xref:System.Text.RegularExpressions.Match.Result%2A?displayProperty=fullName> メソッドを使用して、2 桁の小数部を含むすべての数値の前に $ 記号および空白を付加します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/result1.cs#9)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/result1.vb#9)]  
+  
+ 正規表現パターン `\b\d+(,\d{3})*\.\d{2}\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`\d+`|1 個以上の 10 進数と一致します。|  
+|`(,\d{3})*`|コンマの後に 3 桁の 10 進数字が続くパターンの 0 回以上の出現と一致します。|  
+|`\.`|小数点文字と一致します。|  
+|`\d{2}`|2 桁の 10 進数と一致します。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ 置換パターン `$$ $&` は、一致した部分文字列がドル記号 \($\) \(`$$` パターン\)、空白、および一致文字列の値 \(`$&` パターン\) に置き換えられることを示します。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="GroupCollection"></a>   
+## GroupCollection  
+ <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> プロパティは、単一の一致でキャプチャされたグループを表す <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトを含む <xref:System.Text.RegularExpressions.Group> オブジェクトを返します。 コレクション内の最初の <xref:System.Text.RegularExpressions.Group> オブジェクト \(インデックス 0 の位置にあるオブジェクト\) は、一致した文字列全体を表します。 後続の各オブジェクトは、1 つのキャプチャ グループによるキャプチャの結果を表します。  
+  
+ コレクション内の個々の <xref:System.Text.RegularExpressions.Group> オブジェクトを取得するには、<xref:System.Text.RegularExpressions.GroupCollection.Item%2A?displayProperty=fullName> プロパティを使用します。 名前のないグループはコレクション内の順序位置で取得でき、名前付きグループは名前または順序位置で取得できます。 名前のないキャプチャはコレクションの最初に位置し、正規表現パターンで定義されている順序で左から右にインデックスが付けられます。 名前付きキャプチャは、名前のないキャプチャの後に、正規表現パターンで定義されている順序で左から右にインデックスが付けられます。 特定の正規表現一致メソッドで返されたコレクションで使用可能な番号付きグループを判別するには、インスタンス <xref:System.Text.RegularExpressions.Regex.GetGroupNumbers%2A?displayProperty=fullName> メソッドを呼び出すことができます。 コレクションで使用可能な名前付きグループを判別するには、インスタンス <xref:System.Text.RegularExpressions.Regex.GetGroupNames%2A?displayProperty=fullName> メソッドを呼び出すことができます。 どちらのメソッドも、正規表現によって検出された一致を分析する汎用ルーチンで特に役立ちます。  
+  
+ <xref:System.Text.RegularExpressions.GroupCollection.Item%2A?displayProperty=fullName> プロパティは、コレクションのインデクサー \(C\# の場合\) およびコレクション オブジェクトの既定のプロパティ \(Visual Basic の場合\) です。 つまり、個々の <xref:System.Text.RegularExpressions.Group> オブジェクトには、次のようにインデックスで \(または名前付きグループの場合は名前で\) アクセスできます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/groupsyntax1.cs#13)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/groupsyntax1.vb#13)]  
+  
+ 次の例では、グループ化構成体を使用して日付の月、日、および年をキャプチャする正規表現を定義します。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/groupcollection1.cs#10)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/groupcollection1.vb#10)]  
+  
+ 正規表現パターン `\b(\w+)\s(\d{1,2}),\s(\d{4})\b` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\b`|ワード境界から照合を開始します。|  
+|`(\w+)`|1 つ以上の単語文字に一致します。 これが最初のキャプチャ グループです。|  
+|`\s`|空白文字と一致します。|  
+|`(\d{1,2})`|1 桁または 2 桁の 10 進数と一致します。 これが 2 番目のキャプチャ グループです。|  
+|`,`|コンマに一致します。|  
+|`\s`|空白文字と一致します。|  
+|`(\d{4})`|4 桁の 10 進数と一致します。 これが 3 番目のキャプチャ グループです。|  
+|`\b`|ワード境界で照合を終了します。|  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="the_captured_group"></a>   
+## キャプチャ グループ  
+ <xref:System.Text.RegularExpressions.Group> クラスは、1 つのキャプチャ グループによるキャプチャの結果を表します。 正規表現で定義されているキャプチャ グループを表すグループ オブジェクトは、<xref:System.Text.RegularExpressions.GroupCollection.Item%2A> プロパティによって返される <xref:System.Text.RegularExpressions.GroupCollection> オブジェクトの <xref:System.Text.RegularExpressions.Match.Groups%2A?displayProperty=fullName> プロパティによって返されます。<xref:System.Text.RegularExpressions.GroupCollection.Item%2A> プロパティは、<xref:System.Text.RegularExpressions.Group> クラスのインデクサー \(C\# の場合\) および既定のプロパティ \(Visual Basic の場合\) です。`foreach` 構成体または `For``Each` 構成体を使用してコレクションを反復処理することで、個々のメンバーを取得することもできます。 例については、前のセクションを参照してください。  
+  
+ 次の例では、入れ子にしたグループ化構成体を使用して部分文字列をキャプチャし、グループ化します。 正規表現パターン `(a(b))c` は、文字列 "abc" と一致します。 部分文字列 "ab" を最初のキャプチャ グループに代入し、部分文字列 "b" を 2 番目のキャプチャ グループに代入します。  
+  
+ [!code-csharp[RegularExpressions.Classes#6](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Classes/cs/Example.cs#6)]
+ [!code-vb[RegularExpressions.Classes#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Classes/vb/Example.vb#6)]  
+  
+ 次の例では、名前付きグループ化構成体を使用して、"DATANAME:VALUE" 形式のデータを含む文字列から部分文字列をキャプチャします。この正規表現は、コロン \(:\) でデータを分割します。  
+  
+ [!code-csharp[RegularExpressions.Classes#8](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Classes/cs/Example.cs#8)]
+ [!code-vb[RegularExpressions.Classes#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Classes/vb/Example.vb#8)]  
+  
+ 正規表現パターン `^(?<name>\w+):(?<value>\w+)` は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`^`|入力文字列の先頭から照合を開始します。|  
+|`(?<name>\w+)`|1 つ以上の単語文字に一致します。 このキャプチャ グループの名前は `name` です。|  
+|`:`|コロンと一致します。|  
+|`(?<value>\w+)`|1 つ以上の単語文字に一致します。 このキャプチャ グループの名前は `value` です。|  
+  
+ <xref:System.Text.RegularExpressions.Group> クラスのプロパティには、キャプチャ グループの情報が保持されます。キャプチャされた部分文字列が `Group.Value` プロパティに含まれ、キャプチャ グループの入力テキスト内での開始位置が `Group.Index` プロパティによって示され、キャプチャされたテキストの長さが `Group.Length` プロパティに含まれ、部分文字列がキャプチャ グループによって定義されたパターンと一致したかどうかが `Group.Success` プロパティによって示されます。  
+  
+ 量指定子をグループに適用する場合 \(詳細については、「[限定子](../../../docs/standard/base-types/quantifiers-in-regular-expressions.md)」を参照\)、キャプチャ グループごとに 1 つのキャプチャという関係が 2 つの方法で変更されます。  
+  
+-   `*` 量指定子または `*?` 量指定子 \(0 回以上の一致を指定する\) をグループに適用した場合、キャプチャ グループには入力文字列で一致した文字列が含まれない可能性があります。 キャプチャされたテキストがない場合、<xref:System.Text.RegularExpressions.Group> オブジェクトのプロパティは次の表に示すように設定されます。  
+  
+    |Group プロパティ|値|  
+    |-----------------|-------|  
+    |`Success`|`false`|  
+    |`Value`|<xref:System.String.Empty?displayProperty=fullName>|  
+    |`Length`|0|  
+  
+     具体的な例を次に示します。 正規表現パターン `aaa(bbb)*ccc` では、最初のキャプチャ グループ \(部分文字列 "bbb"\) は 0 回以上一致できます。 入力文字列 "aaaccc" はパターンに一致するので、キャプチャ グループには一致文字列が含まれません。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.ObjectModel#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/nocapture1.cs#11)]
+     [!code-vb[Conceptual.RegularExpressions.ObjectModel#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/nocapture1.vb#11)]  
+  
+-   量指定子は、キャプチャ グループによって定義されたパターンの複数回の出現と一致できます。 この場合、`Value` オブジェクトの `Length` プロパティと <xref:System.Text.RegularExpressions.Group> プロパティには、最後にキャプチャされた部分文字列の情報のみが保持されます。 たとえば、次の正規表現は、ピリオドで終わる 1 文と一致します。 この正規表現では 2 つのグループ化構成体が使用されています。最初のグループ化構成体は個々の単語および空白文字をキャプチャし、2 番目のグループ化構成体は個々の単語をキャプチャします。 この例の出力結果が示すように、正規表現では文全体が正常にキャプチャされますが、2 番目のキャプチャ グループでは最後の単語のみがキャプチャされます。  
+  
+     [!code-csharp[Conceptual.RegularExpressions.ObjectModel#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/lastcapture1.cs#12)]
+     [!code-vb[Conceptual.RegularExpressions.ObjectModel#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/lastcapture1.vb#12)]  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="CaptureCollection"></a>   
+## CaptureCollection  
+ <xref:System.Text.RegularExpressions.Group> オブジェクトには、最後のキャプチャの情報のみが格納されます。 ただし、キャプチャ グループによって行われたキャプチャのセット全体は、<xref:System.Text.RegularExpressions.CaptureCollection> プロパティによって返される <xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> オブジェクトから取得できます。 コレクションの各メンバーは、キャプチャ グループによって行われたキャプチャを表す <xref:System.Text.RegularExpressions.Capture> オブジェクトです。キャプチャされた順序 \(したがって、キャプチャされた文字列が左から右に入力文字列と照合された順序\) で並びます。 コレクション内の個々の <xref:System.Text.RegularExpressions.Capture> オブジェクトは、次のいずれかの方法で取得できます。  
+  
+-   `foreach` \(C\# の場合\) や `For``Each` \(Visual Basic の場合\) などの構成体を使用してコレクションを反復処理する。  
+  
+-   <xref:System.Text.RegularExpressions.CaptureCollection.Item%2A?displayProperty=fullName> プロパティを使用して特定のオブジェクトをインデックスで取得する。<xref:System.Text.RegularExpressions.CaptureCollection.Item%2A> プロパティは、<xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトの既定のプロパティ \(Visual Basic の場合\) またはインデクサー \(C\# の場合\) です。  
+  
+ 量指定子がキャプチャ グループに適用されない場合、<xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトには <xref:System.Text.RegularExpressions.Capture> オブジェクトと同じ一致文字列の情報が保持されるので、関心の低い単一の <xref:System.Text.RegularExpressions.Group> オブジェクトが含まれます。 量指定子がキャプチャ グループに適用される場合、<xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトにはキャプチャ グループによって行われたすべてのキャプチャが含まれ、コレクションの最後のメンバーは <xref:System.Text.RegularExpressions.Group> オブジェクトと同じキャプチャを表します。  
+  
+ たとえば、正規表現パターン `((a(b))c)+` \(量指定子 \+ は 1 つ以上の文字列が一致することを指定\) を使用して文字列 "abcabcabc" から一致する文字列をキャプチャする場合、各 <xref:System.Text.RegularExpressions.CaptureCollection> オブジェクトの <xref:System.Text.RegularExpressions.Group> オブジェクトには、3 個のメンバーが含まれることになります。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/capturecollection1.cs#14)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/capturecollection1.vb#14)]  
+  
+ 次の例では、正規表現 `(Abc)+` を使用して、文字列 "XYZAbcAbcAbcXYZAbcAb" の中から文字列 "Abc" の連続した出現を 1 つ以上検索します。 この例は、<xref:System.Text.RegularExpressions.Group.Captures%2A?displayProperty=fullName> プロパティを使用して、キャプチャした部分文字列の複数のグループを返す方法を示しています。  
+  
+ [!code-csharp[RegularExpressions.Classes#5](../../../samples/snippets/csharp/VS_Snippets_CLR/RegularExpressions.Classes/cs/Example.cs#5)]
+ [!code-vb[RegularExpressions.Classes#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/RegularExpressions.Classes/vb/Example.vb#5)]  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="the_individual_capture"></a>   
+## 個々のキャプチャ  
+ <xref:System.Text.RegularExpressions.Capture> クラスには、単一の部分式キャプチャの結果が含まれます。 一致したテキストが <xref:System.Text.RegularExpressions.Capture.Value%2A?displayProperty=fullName> プロパティに含まれ、一致した部分文字列の入力文字列内での開始位置 \(起点を 0 とする\) が <xref:System.Text.RegularExpressions.Capture.Index%2A?displayProperty=fullName> プロパティによって示されます。  
+  
+ 次の例では、選択した都市の気温の入力文字列を解析します。 都市とその気温を区切るためにコンマ \(","\) が使用され、各都市のデータを区切るためにセミコロン \(";"\) が使用されています。 入力文字列全体が単一の一致を表します。 文字列の解析に使用される正規表現パターン `((\w+(\s\w+)*),(\d+);)+` では、都市名が 2 番目のキャプチャ グループに代入され、気温が 4 番目のキャプチャ グループに代入されます。  
+  
+ [!code-csharp[Conceptual.RegularExpressions.ObjectModel#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/cs/capture1.cs#16)]
+ [!code-vb[Conceptual.RegularExpressions.ObjectModel#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.regularexpressions.objectmodel/vb/capture1.vb#16)]  
+  
+ 正規表現は、次の表に示すように定義されています。  
+  
+|パターン|説明|  
+|----------|--------|  
+|`\w+`|1 つ以上の単語文字に一致します。|  
+|`(\s\w+)*`|空白文字の後に 1 個以上の単語文字が続くパターンの 0 回以上の出現と一致します。 このパターンは、複数の単語で構成される都市名と一致します。 これが 3 番目のキャプチャ グループです。|  
+|`(\w+(\s\w+)*)`|1 個以上の単語文字の後に空白文字および 1 個以上の単語文字の 0 回以上の出現が続くパターンと一致します。 これが 2 番目のキャプチャ グループです。|  
+|`,`|コンマに一致します。|  
+|`(\d+)`|1 桁以上の数字と一致します。 これが 4 番目のキャプチャ グループです。|  
+|`;`|セミコロンと一致します。|  
+|`((\w+(\s\w+)*),(\d+);)+`|単語、追加の単語、コンマ、1 桁以上の数字、およびセミコロンが 1 回以上続くパターンと一致します。 これが最初のキャプチャ グループです。|  
+  
+## 参照  
+ <xref:System.Text.RegularExpressions>   
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)   
+ [正規表現言語 \- クイック リファレンス](../../../docs/standard/base-types/regular-expression-language-quick-reference.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/thread-safety-in-regular-expressions.md b/docs/standard/base-types/thread-safety-in-regular-expressions.md
new file mode 100644
index 00000000000..256749a70dd
--- /dev/null
+++ b/docs/standard/base-types/thread-safety-in-regular-expressions.md
@@ -0,0 +1,35 @@
+---
+title: "正規表現におけるスレッド セーフ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework 正規表現, スレッド"
+  - "解析 (正規表現を使用したテキストを), スレッド"
+  - "パターン一致 (正規表現を使用した), スレッド"
+  - "正規表現, スレッド"
+  - "検索 (正規表現を使用した), スレッド"
+ms.assetid: 7c4a167b-5236-4cde-a2ca-58646230730f
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 正規表現におけるスレッド セーフ
+<xref:System.Text.RegularExpressions.Regex> クラス自体はスレッド セーフであり、変更不可 \(読み込み専用\) です。  つまり、任意のスレッドで **Regex** オブジェクトを作成し、それを複数スレッドで共有できます。一致メソッドは任意のスレッドから呼び出すことができますが、グローバルな状態を変更することはありません。  
+  
+ ただし、**Regex** から返される結果オブジェクト \(**Match** および **MatchCollection**\) は、シングル スレッドで使用する必要があります。  そのようなオブジェクトの多くは論理的には変更できません。ただし、それらの実装では、いくつかの結果の計算を遅らせることで、パフォーマンスの向上を図る場合があります。このため、それらのオブジェクトへのアクセスを、呼び出し元でシリアル化する必要が生じます。  
+  
+ **Regex** の結果オブジェクトを複数スレッドで共有する必要がある場合は、同期化されたメソッドを呼び出すことによって、それらのオブジェクトをスレッド セーフなインスタンスに変換できます。  列挙子を例外として、すべての正規表現クラスはスレッド セーフであるか、または同期化されたメソッドによってスレッド セーフなオブジェクトに変換できます。  
+  
+ 列挙子は唯一の例外です。  アプリケーションは、コレクション列挙子への呼び出しをシリアル化する必要があります。  あるコレクションを複数のスレッドで同時に列挙できる場合は、列挙子の対象となるコレクションのルート オブジェクトで、列挙子メソッドを同期させる必要があるという決まりがあります。  
+  
+## 参照  
+ [.NET Framework の正規表現](../../../docs/standard/base-types/regular-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/base-types/trimming.md b/docs/standard/base-types/trimming.md
index 6187f4eb2fe..ae784a70780 100644
--- a/docs/standard/base-types/trimming.md
+++ b/docs/standard/base-types/trimming.md
@@ -1,212 +1,94 @@
 ---
-title: "文字列からの文字のトリムと削除"
-description: "文字列からの文字のトリムと削除"
-keywords: .NET, .NET Core
-author: stevehoag
-manager: wpickett
-ms.date: 07/26/2016
-ms.topic: article
-ms.prod: .net-core
-ms.technology: .net-core-technologies
-ms.devlang: dotnet
-ms.assetid: 95d818bc-2661-43f6-adb8-13b53abf9682
-translationtype: Human Translation
-ms.sourcegitcommit: fb00da6505c9edb6a49d2003ae9bcb8e74c11d6c
-ms.openlocfilehash: 96cf08c0de8ba73d931d561187369ccf8b091651
-
----
-
-# <a name="trimming-and-removing-characters-from-strings"></a>文字列からの文字のトリムと削除
-
-文章を個々の単語に分割すると、単語の先頭または末尾に空白が残る場合があります。 そのような場合は、[System.String](https://docs.microsoft.com/dotnet/core/api/System.String) クラスのトリム メソッドのいずれかを使用して、文字列内の指定した位置から任意の数の空白またはその他の文字を削除できます。 使用できるトリム メソッドとその説明を次の表に示します。
-
-メソッド名 | 使用
------------ | ---
-[String.Trim](https://docs.microsoft.com/dotnet/core/api/System.String.Trim) | 文字列の先頭と末尾から、空白または文字配列で指定した文字を削除します。
-[String.TrimEnd](https://docs.microsoft.com/dotnet/core/api/System.String.TrimEnd(System.Char[])) | 文字列の末尾から、文字配列で指定した文字を削除します。
-[String.TrimStart](https://docs.microsoft.com/dotnet/core/api/System.String.TrimStart(System.Char[])) | 文字列の先頭から、文字配列で指定した文字を削除します。
-[String.Remove](https://docs.microsoft.com/dotnet/core/api/System.String.Remove(System.Int32)) | 文字列内の指定したインデックス位置から、指定した数の文字を削除します。
-
-
-## <a name="trim"></a>Trim
-
-[String.Trim](https://docs.microsoft.com/dotnet/core/api/System.String.Trim) メソッドを使用すると、文字列の両端から空白を簡単に削除できます。メソッドの使用例を次に示します。
-
-```csharp
-string MyString = " Big   ";
-Console.WriteLine("Hello{0}World!", MyString);
-string TrimString = MyString.Trim();
-Console.WriteLine("Hello{0}World!", TrimString);
-//       The example displays the following output:
-//             Hello Big   World!
-//             HelloBigWorld!
-```
-
-```vb
-Dim MyString As String = " Big   "
-Console.WriteLine("Hello{0}World!", MyString)
-Dim TrimString As String = MyString.Trim()
-Console.WriteLine("Hello{0}World!", TrimString)
-' The example displays the following output:
-'       Hello Big   World!
-'       HelloBigWorld!
-```
-
-文字列の先頭と末尾から、文字配列で指定した文字を削除することもできます。 次に、空白文字、ピリオド、およびアスタリスクを削除する例を示します。
-
-```csharp
-using System;
-
-public class Example
-{
-   public static void Main()
-   {
-      String header = "* A Short String. *";
-      Console.WriteLine(header);
-      Console.WriteLine(header.Trim( new Char[] { ' ', '*', '.' } ));
-   }
-}
-// The example displays the following output:
-//       * A Short String. *
-//       A Short String
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      Dim header As String = "* A Short String. *"
-      Console.WriteLine(header)
-      Console.WriteLine(header.Trim( { " "c, "*"c, "."c } ))
-   End Sub
-End Module
-' The example displays the following output:
-'       * A Short String. *
-'       A Short String
-```
-
-## <a name="trimend"></a>TrimEnd
-
-[String.TrimEnd](https://docs.microsoft.com/dotnet/core/api/System.String.TrimEnd(System.Char[])) メソッドは、文字列の末尾から文字を削除して新しい文字列オブジェクトを作成します。 このメソッドには、削除する文字を指定する文字配列が渡されます。 文字配列内での要素の順序は、トリム操作に影響しません。 トリム操作は、文字配列で指定された文字が見つからなくなった時点で停止します。
-
-TrimEnd メソッドを使用して文字列の末尾の数文字を削除する例を次に示します。 この例では、文字配列内の文字の順序が操作に影響しないことを示すために、`'r'` という文字と `'W'` という文字の順序を逆にしてあります。 このコードは、`MyString` の最後の単語だけでなく、最初の単語の一部も削除します。
-
-```csharp
-string MyString = "Hello World!";
-char[] MyChar = {'r','o','W','l','d','!',' '};
-string NewString = MyString.TrimEnd(MyChar);
-Console.WriteLine(NewString);
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Dim MyChar() As Char = {"r","o","W","l","d","!"," "}
-Dim NewString As String = MyString.TrimEnd(MyChar)
-Console.WriteLine(NewString)
-```
-
-このコードは、コンソールに `He` と出力します。
-
-[TrimEnd](https://docs.microsoft.com/dotnet/core/api/System.String.TrimEnd(System.Char[])) メソッドを使用して、文字列の最後の単語を削除する例を次に示します。 このコードでは、`Hello` という単語の後にコンマがありますが、削除する文字の配列にコンマは指定されていないため、コンマの位置でトリムが停止します。
-
-```csharp
-string MyString = "Hello, World!";
-char[] MyChar = {'r','o','W','l','d','!',' '};
-string NewString = MyString.TrimEnd(MyChar);
-Console.WriteLine(NewString);
-```
-
-```vb
-Dim MyString As String = "Hello, World!"
-Dim MyChar() As Char = {"r","o","W","l","d","!"," "}
-Dim NewString As String = MyString.TrimEnd(MyChar)
-Console.WriteLine(NewString)
-```
-
-このコードは、コンソールに `Hello,` と出力します。
-
-## <a name="trimstart"></a>TrimStart
-
-[String.TrimStart](https://docs.microsoft.com/dotnet/core/api/System.String.TrimStart(System.Char[])) メソッドは [String.TrimEnd](https://docs.microsoft.com/dotnet/core/api/System.String.TrimEnd(System.Char[])) メソッドと似ていますが、既存の文字列オブジェクトの先頭から文字を削除して新しい文字列を作成する点が異なります。 [TrimStart](https://docs.microsoft.com/dotnet/core/api/System.String.TrimStart(System.Char[])) メソッドには、削除する文字を指定する文字配列が渡されます。 [TrimEnd](https://docs.microsoft.com/dotnet/core/api/System.String.TrimEnd(System.Char[])) メソッドの場合と同様に、文字配列内での要素の順序はトリム操作に影響しません。 トリム操作は、文字配列で指定された文字が見つからなくなった時点で停止します。
-
-文字列の最初の単語を削除する例を次に示します。 この例では、文字配列内の文字の順序が操作に影響しないことを示すために、`'l'` という文字と `'H'` という文字の順序を逆にしてあります。
-
-```csharp
-string MyString = "Hello World!";
-char[] MyChar = {'e', 'H','l','o',' ' };
-string NewString = MyString.TrimStart(MyChar);
-Console.WriteLine(NewString);
-```
-
-```vb
-Dim MyString As String = "Hello World!"
-Dim MyChar() As Char = {"e","H","l","o"," " }
-Dim NewString As String = MyString.TrimStart(MyChar)
-Console.WriteLine(NewString)
-```
-
-このコードは、コンソールに `World!` と出力します。
-
-## <a name="remove"></a>削除
-
-[String.Remove](https://docs.microsoft.com/dotnet/core/api/System.String.Remove(System.Int32)) メソッドは、既存の文字列内の指定した位置を開始位置として、指定した数の文字を削除します。 このメソッドは、インデックスが 0 から始まっていることを前提としています。
-
-文字列の 0 から始まる 5 番目のインデックスを開始位置として、10 文字を削除する例を次に示します。
-
-```csharp
-string MyString = "Hello Beautiful World!";
-Console.WriteLine(MyString.Remove(5,10));
-// The example displays the following output:
-//         Hello World!  
-```
-
-```vb
-Dim MyString As String = "Hello Beautiful World!"
-Console.WriteLine(MyString.Remove(5,10))
-' The example displays the following output:
-'         Hello World!
-```
-
-また、[String.Replace(String, String)](https://docs.microsoft.com/dotnet/core/api/System.String.Replace(System.String,System.String)) メソッドを呼び出し、置換対象として空の文字列 ([String.Empty](https://docs.microsoft.com/dotnet/core/api/System.String.Empty)) を指定することで、文字列から指定した文字または部分文字列を削除することもできます。 文字列からすべてのコンマを削除する例を次に示します。
-
-```csharp
-using System;
-
-public class Example
-{
-   public static void Main()
-   {
-      String phrase = "a cold, dark night";
-      Console.WriteLine("Before: {0}", phrase);
-      phrase = phrase.Replace(",", "");
-      Console.WriteLine("After: {0}", phrase);
-   }
-}
-// The example displays the following output:
-//       Before: a cold, dark night
-//       After: a cold dark night
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      Dim phrase As String = "a cold, dark night"
-      Console.WriteLine("Before: {0}", phrase)
-      phrase = phrase.Replace(",", "")
-      Console.WriteLine("After: {0}", phrase)
-   End Sub
-End Module
-' The example displays the following output:
-'       Before: a cold, dark night
-'       After: a cold dark night
-```
-
-## <a name="see-also"></a>関連項目
-
-[基本的な文字列操作](basic-string-operations.md)
-
-
-
-
-<!--HONumber=Nov16_HO1-->
-
-
+title: ".NET Framework における文字列からの文字のトリムと削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Remove メソッド"
+  - "削除 (文字を)"
+  - "文字列 [.NET Framework], 削除 (文字を)"
+  - "Trim メソッド"
+  - "TrimEnd メソッド"
+  - "トリム (文字の)"
+  - "TrimStart メソッド"
+ms.assetid: ab248dab-70d4-4413-81c6-542d153fd195
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# .NET Framework における文字列からの文字のトリムと削除
+文章を個々の単語に分割すると、単語の先頭または末尾に空白が残る場合があります。  そのような場合は、**System.String** クラスのトリム メソッドのいずれかを使用して、文字列内の指定した位置から任意の数の空白またはその他の文字を削除できます。  使用できるトリム メソッドとその説明を次の表に示します。  
+  
+|メソッド名|使用方法|  
+|-----------|----------|  
+|<xref:System.String.Trim%2A?displayProperty=fullName>|文字列の先頭と末尾から、空白または文字配列で指定した文字を削除します。|  
+|<xref:System.String.TrimEnd%2A?displayProperty=fullName>|文字列の末尾から、文字配列で指定した文字を削除します。|  
+|<xref:System.String.TrimStart%2A?displayProperty=fullName>|文字列の先頭から、文字配列で指定した文字を削除します。|  
+|<xref:System.String.Remove%2A?displayProperty=fullName>|文字列内の指定したインデックス位置から、指定した数の文字を削除します。|  
+  
+## Trim  
+ <xref:System.String.Trim%2A?displayProperty=fullName> メソッドを使用すると、文字列の両端から空白を簡単に削除できます。メソッドの使用例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#17](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/trimming.cpp#17)]
+ [!code-csharp[Conceptual.String.BasicOps#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trimming.cs#17)]
+ [!code-vb[Conceptual.String.BasicOps#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trimming.vb#17)]  
+  
+ 文字列の先頭と末尾から、文字配列で指定した文字を削除することもできます。  次に、空白文字、ピリオド、およびアスタリスクを削除する例を示します。  
+  
+ [!code-csharp[Conceptual.String.BasicOps#22](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trim2.cs#22)]
+ [!code-vb[Conceptual.String.BasicOps#22](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trim2.vb#22)]  
+  
+## TrimEnd  
+ **String.TrimEnd** メソッドは、文字列の末尾から文字を削除して新しい文字列オブジェクトを作成します。  このメソッドには、削除する文字を指定する文字配列が渡されます。  文字配列内での要素の順序は、トリム操作に影響しません。  トリム操作は、文字配列で指定された文字が見つからなくなった時点で停止します。  
+  
+ **TrimEnd** メソッドを使用して文字列の末尾の数文字を削除する例を次に示します。  この例では、文字配列内の文字の順序が操作に影響しないことを示すために、`'r'` という文字と `'W'` という文字の順序を逆にしてあります。  このコードは、`MyString` の最後の単語だけでなく、最初の単語の一部も削除します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#18](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/trimming.cpp#18)]
+ [!code-csharp[Conceptual.String.BasicOps#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trimming.cs#18)]
+ [!code-vb[Conceptual.String.BasicOps#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trimming.vb#18)]  
+  
+ このコードは、コンソールに `He` と出力します。  
+  
+ **TrimEnd** メソッドを使用して、文字列の最後の単語を削除する例を次に示します。  このコードでは、`Hello` という単語の後にコンマがありますが、削除する文字の配列にコンマは指定されていないため、コンマの位置でトリムが停止します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#19](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/trimming.cpp#19)]
+ [!code-csharp[Conceptual.String.BasicOps#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trimming.cs#19)]
+ [!code-vb[Conceptual.String.BasicOps#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trimming.vb#19)]  
+  
+ このコードは、コンソールに `Hello,` と出力します。  
+  
+## TrimStart  
+ **String.TrimStart** メソッドは **String.TrimEnd** メソッドと似ていますが、既存の文字列オブジェクトの先頭から文字を削除して新しい文字列を作成する点が異なります。  **TrimStart** メソッドには、削除する文字を指定する文字配列が渡されます。  **TrimEnd** メソッドの場合と同様に、文字配列内での要素の順序はトリム操作に影響しません。  トリム操作は、文字配列で指定された文字が見つからなくなった時点で停止します。  
+  
+ 文字列の最初の単語を削除する例を次に示します。  この例では、文字配列内の文字の順序が操作に影響しないことを示すために、`'l'` という文字と `'H'` という文字の順序を逆にしてあります。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#20](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/trimming.cpp#20)]
+ [!code-csharp[Conceptual.String.BasicOps#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trimming.cs#20)]
+ [!code-vb[Conceptual.String.BasicOps#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trimming.vb#20)]  
+  
+ このコードは、コンソールに `World!` と出力します。  
+  
+## 削除  
+ <xref:System.String.Remove%2A?displayProperty=fullName> メソッドは、既存の文字列内の指定した位置を開始位置として、指定した数の文字を削除します。  このメソッドは、インデックスが 0 から始まっていることを前提としています。  
+  
+ 文字列の 0 から始まる 5 番目のインデックスを開始位置として、10 文字を削除する例を次に示します。  
+  
+ [!code-cpp[Conceptual.String.BasicOps#21](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.string.basicops/cpp/trimming.cpp#21)]
+ [!code-csharp[Conceptual.String.BasicOps#21](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/trimming.cs#21)]
+ [!code-vb[Conceptual.String.BasicOps#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/trimming.vb#21)]  
+  
+ また、<xref:System.String.Replace%28System.String%2CSystem.String%29?displayProperty=fullName> メソッドを呼び出し、置換対象として空の文字列 \(<xref:System.String.Empty?displayProperty=fullName>\) を指定することで、文字列から指定した文字または部分文字列を削除することもできます。  文字列からすべてのコンマを削除する例を次に示します。  
+  
+ [!code-csharp[Conceptual.String.BasicOps#23](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.string.basicops/cs/replace1.cs#23)]
+ [!code-vb[Conceptual.String.BasicOps#23](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.string.basicops/vb/replace1.vb#23)]  
+  
+## 参照  
+ [基本的な文字列操作](../../../docs/standard/base-types/basic-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/building-console-apps.md b/docs/standard/building-console-apps.md
new file mode 100644
index 00000000000..047775f59a0
--- /dev/null
+++ b/docs/standard/building-console-apps.md
@@ -0,0 +1,41 @@
+---
+title: ".NET Framework におけるコンソール アプリケーションの構築 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, ビルド (コンソール アプリケーションを)"
+  - "アプリケーション開発 [.NET Framework], コンソール"
+  - "コンソール アプリケーション"
+ms.assetid: c21fb997-9f0e-40a5-8741-f73bba376bd8
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# .NET Framework におけるコンソール アプリケーションの構築
+.NET Framework のアプリケーションは、<xref:System.Console?displayProperty=fullName> クラスを使用して、コンソールから文字を読み取り、コンソールに文字を書き込みます。  コンソールからのデータは標準入力ストリームから読み取られ、コンソールへのデータは標準出力ストリームに書き込まれ、コンソールへのエラー データは標準エラー出力ストリームに書き込まれます。  これらのストリームは、アプリケーションの起動時に自動的にコンソールに関連付けられ、それぞれ <xref:System.Console.In%2A> プロパティ、<xref:System.Console.Out%2A> プロパティ、および <xref:System.Console.Error%2A> プロパティとして示されます。  
+  
+ <xref:System.Console.In%2A?displayProperty=fullName> プロパティの値が <xref:System.IO.TextReader?displayProperty=fullName> オブジェクトであるのに対し、<xref:System.Console.Out%2A?displayProperty=fullName> および <xref:System.Console.Error%2A?displayProperty=fullName> プロパティの値は <xref:System.IO.TextWriter?displayProperty=fullName> オブジェクトです。  これらのプロパティを、コンソールを表さないストリームに関連付けることがができます。これにより、ストリームの出力先または入力元として異なる位置を指定できます。  たとえば、<xref:System.Console.Out%2A?displayProperty=fullName> プロパティを <xref:System.Console.SetOut%2A?displayProperty=fullName> メソッドで <xref:System.IO.FileStream?displayProperty=fullName> をカプセル化する <xref:System.IO.StreamWriter?displayProperty=fullName> に設定することにより、出力をファイルにリダイレクトできます。  <xref:System.Console.In%2A?displayProperty=fullName> プロパティと <xref:System.Console.Out%2A?displayProperty=fullName> プロパティとが同じストリームを参照する必要はありません。  
+  
+> [!NOTE]
+>  コンソール アプリケーション \(C\#、Visual Basic、および C\+\+ の例を含む\) をビルドする方法の詳細については <xref:System.Console> クラスのドキュメントを参照してください。  
+  
+ Windows ベースのアプリケーションなどでコンソールが存在しない場合には、情報を書き込む先のコンソールがないため、標準出力ストリームに書き込まれた出力を参照できません。  アクセスできないコンソールに情報を書き込んでも、例外は発生しません。  
+  
+ Visual Studio を使用して開発した Windows ベースのアプリケーション内で読み取りおよび書き込み用のコンソールを有効にするには、プロジェクトの **\[プロパティ\]** ダイアログ ボックスを開き、**\[アプリケーション\]** タブをクリックして、**\[アプリケーションの種類\]** を **\[コンソール アプリケーション\]** に設定します。  
+  
+ コンソール アプリケーションには、既定で起動されるメッセージ ポンプがありません。  したがって、コンソールが Microsoft Win32 タイマーを呼び出すと、失敗する場合があります。  
+  
+ **System.Console** クラスには、コンソールから個々の文字または行全体を読み取ることができるメソッドがあります。  その他のメソッドは、まずデータと書式指定文字列を変換してから、書式設定された文字列をコンソールに書き込みます。  書式指定文字列の詳細については、「[型の書式設定](../../docs/standard/base-types/formatting-types.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Console?displayProperty=fullName>   
+ [型の書式設定](../../docs/standard/base-types/formatting-types.md)
\ No newline at end of file
diff --git a/docs/standard/class-library-overview.md b/docs/standard/class-library-overview.md
new file mode 100644
index 00000000000..58f3d45c5af
--- /dev/null
+++ b/docs/standard/class-library-overview.md
@@ -0,0 +1,115 @@
+---
+title: ".NET Framework クラス ライブラリの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework クラス ライブラリ, 概要"
+  - ".NET Framework, クラス ライブラリ"
+  - "基本型, クラス ライブラリ"
+  - "組み込み型"
+  - "クラス ライブラリ [.NET Framework]"
+  - "クラス オブジェクト値型"
+  - "クラス [.NET Framework], ライブラリ概要"
+  - "CLS"
+  - "共通言語仕様"
+  - "データ型 [.NET Framework]"
+  - "データ型 [.NET Framework], C#"
+  - "データ型 [.NET Framework], C++"
+  - "データ型 [.NET Framework], JScript"
+  - "データ型 [.NET Framework], Visual Basic"
+  - "浮動小数点値型"
+  - "整数値型"
+  - "JScript, データ型"
+  - "ライブラリ, .NET Framework クラス ライブラリ"
+  - "論理値型"
+  - "メンバー [.NET Framework], 型"
+  - "名前空間 [.NET Framework]"
+  - "名前空間 [.NET Framework], 名前空間の概要"
+  - "名前付け規則 [.NET Framework]"
+  - "System 名前空間"
+  - "型システム [.NET Framework]"
+  - "型, .NET Framework"
+  - "ユーザー定義型"
+  - "値型"
+  - "Visual Basic, データ型"
+  - "Visual C#, データ型"
+  - "Visual C++, データ型"
+ms.assetid: 7e4c5921-955d-4b06-8709-101873acf157
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# .NET Framework クラス ライブラリの概要
+[!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] には、開発プロセスを高速化および最適化し、システム機能へのアクセスを提供する、クラス、インターフェイス、および値型があります。  言語間での相互運用性を確保するために、.NET Framework のほとんどの型は共通言語仕様 \(CLS: Common Language Specification\) に準拠しています。このため、コンパイラが CLS に準拠しているすべてのプログラミング言語でこれらの型を使用できます。  
+  
+ .NET Framework の型は、.NET アプリケーション、.NET コンポーネント、および .NET コントロールを構築するときの基礎となります。  [!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] には、次の機能を実行する型が用意されています。  
+  
+-   基本データ型と例外を表す。  
+  
+-   データ構造をカプセル化する。  
+  
+-   入出力を実行する。  
+  
+-   読み込まれた型についての情報にアクセスする。  
+  
+-   .NET Framework セキュリティ チェックを呼び出す。  
+  
+-   データ アクセス、豊富なクライアント側 GUI、およびサーバー制御式のクライアント側 GUI を提供する。  
+  
+ [!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] には、豊富なインターフェイスのセットに加えて、抽象クラスと具象 \(抽象ではない\) クラスが用意されています。  具象クラスはそのまま使用できますが、多くの場合は、具象クラスから独自のクラスを派生させます。  インターフェイスの機能を使用するには、インターフェイスを実装するクラスを作成するか、またはインターフェイスを実装する .NET Framework クラスの 1 つからクラスを派生させます。  
+  
+## 名前付け規則  
+ .NET Framework の型では、階層構造を伴うドット構文の名前付け方法が使われます。  この方法では、関連する型が名前空間にグループ化されるため、検索と参照を簡単に行うことができます。  フルネームのうち右端のドットまでの最初の部分は、名前空間の名前です。  名前の最後の部分は型名です。  たとえば、**System.Collections.ArrayList** は **ArrayList** 型であり、名前空間 **System.Collections** に属します。  **System.Collections** 内の型を使用することで、オブジェクトのコレクションを操作できます。  
+  
+ この名前付け方法によって、[!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] を拡張するライブラリ開発者は、型の階層構造のグループを簡単に作成し、一貫性のあるわかりやすい名前を付けることができます。  また、型の完全名 \(つまり名前空間と型名\) によって型を明確に特定できるため、型名の競合を防ぐことができます。  ライブラリ開発者は、次の規則に従って名前空間の名前を付けてください。  
+  
+ *CompanyName*.*TechnologyName*  
+  
+ たとえば、名前空間 Microsoft.Word はこのガイドラインに従っています。  
+  
+ 名前付けパターンを使用して関連する型を名前空間にグループ化する方法は、クラス ライブラリを構築および文書化するのに便利です。  ただし、この名前付け方法は、参照可能範囲、メンバー アクセス、継承、セキュリティ、バインディングには影響しません。  名前空間は複数のアセンブリにまたがって分割でき、また 1 つのアセンブリに複数の名前空間からの型を含めることができます。  アセンブリは、共通言語ランタイムにおけるバージョン管理、配置、セキュリティ、読み込み、および参照可能範囲のための構造を提供します。  
+  
+ 名前空間と型の名前の詳細については、「[共通型システム](../../docs/standard/base-types/common-type-system.md)」を参照してください。  
+  
+## 名前空間 System  
+ <xref:System> 名前空間は、[!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] における基本的な型のルート名前空間です。  この名前空間には、<xref:System.Object> \(継承階層構造のルート\)、<xref:System.Byte>、<xref:System.Char>、<xref:System.Array>、<xref:System.Int32>、<xref:System.String> など、すべてのアプリケーションで使用される基本データ型を表すクラスが含まれます。  これらの型の多くは、プログラミング言語で使われるプリミティブなデータ型に対応します。  .NET Framework の型を使用してコードを記述するときには、.NET Framework の基本データ型が使用されるところに、プログラミング言語側の対応するキーワードを使用できます。  
+  
+ 次の表では、[!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] に用意されているそれぞれの基本型の一覧を示し、各型について簡単に説明し、Visual Basic、C\#、C\+\+、JScript での対応する型を示します。  
+  
+|カテゴリ|クラス名|説明|Visual Basic のデータ型|C\# のデータ型|C\+\+ データ型|JScript のデータ型|  
+|----------|----------|--------|------------------------|---------------|----------------|-------------------|  
+|整数|<xref:System.Byte>|8 ビット符号なし整数。|**Byte**|**byte**|**unsigned char**|**Byte**|  
+||<xref:System.SByte>|8 ビット符号付き整数。<br /><br /> 非 CLS 準拠|**SByte**|**sbyte**|**char**<br /><br /> または<br /><br /> **signed** **char**|**SByte**|  
+||<xref:System.Int16>|16 ビット符号付き整数。|**Short**|**short**|**short**|**short**|  
+||<xref:System.Int32>|32 ビット符号付き整数。|**整数**|**int**|**int**<br /><br /> または<br /><br /> **long**|**int**|  
+||<xref:System.Int64>|64 ビット符号付き整数|**Long**|**long**|**\_\_int64**|**long**|  
+||<xref:System.UInt16>|16 ビット符号なし整数。<br /><br /> 非 CLS 準拠|**UShort**|**ushort**|**unsigned short**|**UInt16**|  
+||<xref:System.UInt32>|32 ビット符号なし整数。<br /><br /> 非 CLS 準拠|**UInteger**|**uint**|**unsigned int**<br /><br /> または<br /><br /> **unsigned long**|**UInt32**|  
+||<xref:System.UInt64>|64 ビット符号なし整数。<br /><br /> 非 CLS 準拠|**ULong**|**ulong**|**unsigned \_\_int64**|**UInt64**|  
+|浮動小数点数|<xref:System.Single>|単精度 \(32 ビット\) 浮動小数点数|**Single**|**float**|**float**|**float**|  
+||<xref:System.Double>|倍精度 \(64 ビット\) 浮動小数点数|**Double \(倍精度浮動小数点型\)**|**double**|**double**|**double**|  
+|論理|<xref:System.Boolean>|ブール値 \(true または false\)|**Boolean**|**bool**|**bool**|**bool**|  
+|その他|<xref:System.Char>|Unicode \(16 ビット\) 文字|**Char**|**char**|**wchar\_t**|**char**|  
+||<xref:System.Decimal>|十進数 \(128 ビット\) の値です。|**Decimal \(10 進数型\)**|**decimal**|**Decimal \(10 進数型\)**|**Decimal \(10 進数型\)**|  
+||<xref:System.IntPtr>|基になるプラットフォームによってサイズが決まる符号付き整数 \(32 ビットのプラットフォームでは 32 ビット値、64 ビットのプラットフォームでは 64 ビット値\)|**IntPtr**<br /><br /> 非組み込み型|**IntPtr**<br /><br /> 非組み込み型|**IntPtr**<br /><br /> 非組み込み型|**IntPtr**|  
+||<xref:System.UIntPtr>|基になるプラットフォームによってサイズが決まる符号なし整数 \(32 ビットのプラットフォームでは 32 ビット値、64 ビットのプラットフォームでは 64 ビット値\)<br /><br /> 非 CLS 準拠|**UIntPtr**<br /><br /> 非組み込み型|**UIntPtr**<br /><br /> 非組み込み型|**UIntPtr**<br /><br /> 非組み込み型|**UIntPtr**|  
+|クラス オブジェクト|<xref:System.Object>|オブジェクト階層構造のルート|**Object**|**object**|**Object\***|**Object**|  
+||<xref:System.String>|Unicode 文字の不変固定長文字列|**String**|**string**|**String\***|**String**|  
+  
+ 基本データ型に加えて、<xref:System> 名前空間には、例外を処理するクラスから、核となるランタイム概念 \(アプリケーション ドメインやガベージ コレクターなど\) を扱うクラスまで、100 以上のクラスが含まれます。  <xref:System> 名前空間には、2 次レベルの名前空間も数多く含まれています。  
+  
+ 名前空間の詳細については、「[.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkID=227195)」を参照してください。  参照ドキュメントには、各名前空間の簡単な概要と、各型とそのメンバーについての説明が記載されています。  
+  
+## 参照  
+ [共通型システム](../../docs/standard/base-types/common-type-system.md)   
+ [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkID=227195)   
+ [概要](../../docs/framework/get-started/overview.md)
\ No newline at end of file
diff --git a/docs/standard/clr.md b/docs/standard/clr.md
index 96f6c0e6afc..dd15ef2de1a 100644
--- a/docs/standard/clr.md
+++ b/docs/standard/clr.md
@@ -1,76 +1,90 @@
 ---
-title: "共通言語ランタイム (CLR)"
-description: "共通言語ランタイム (CLR)"
-keywords: .NET, .NET Core
-author: rpetrusha
-ms.author: ronpet
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 7704d9c9-e5fa-4969-a423-081cce0e21e6
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: b789ed861a5df583162f901c1c5bc765c55f7b30
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="common-language-runtime-clr"></a>共通言語ランタイム (CLR)
-
-.NET Framework には、共通言語ランタイムと呼ばれるランタイム環境が用意されています。共通言語ランタイムは、コードを実行し、開発プロセスを支援するサービスを提供します。
-
-コンパイラとツールにより、共通言語ランタイムの機能が公開されることによって、このマネージ実行環境の利点を活用するコードを記述できるようになります。 このような共通言語ランタイムに対応した言語コンパイラを使用して作成したコードはマネージ コードと呼ばれます。マネージ コードは、言語間の統合、言語間の例外処理、強化されたセキュリティ、バージョン管理と配置のサポート、コンポーネント間の対話の簡易モデル、デバッグ サービスとプロファイル サービスなど、さまざまな機能を利用できます。
-
-> [!NOTE]
-> 型システム、メタデータの書式、およびランタイム環境 (仮想実行システム) はすべて公的な標準規格の ECMA 共通言語基盤仕様により定義されているため、コンパイラおよびツールは共通言語ランタイムが使用できる出力を生成できます。 詳細については、「[ECMA C# and Common Language Infrastructure Specifications (ECMA C# および共通言語基盤の仕様)](https://www.visualstudio.com/en-us/mt639507)」を参照してください。
-
-マネージ コードが共通言語ランタイムからサービスを受けられるようにするために、言語コンパイラは、そのコード内の型、メンバー、および参照を記述したメタデータを生成する必要があります。 メタデータはコード内に格納されます。つまり、共通言語ランタイムの読み込み可能なすべてのポータブル実行可能 (PE) ファイルには、メタデータが含まれていることになります。 共通言語ランタイムは、クラスの検索と読み込み、メモリ内でのインスタンスのレイアウト、メソッドの呼び出しの解決、ネイティブ コードの生成、セキュリティの強化、およびランタイムのコンテキスト境界の設定にメタデータを使用します。
-
-共通言語ランタイムはオブジェクトのレイアウトを自動的に処理し、それらのオブジェクトへの参照を管理し、不要になったオブジェクトを解放します。 このような方法で有効期間を管理されるオブジェクトをマネージ データと呼びます。 ガベージ コレクションによって、一般的なプログラミング エラーだけでなくメモリ リークもなくなります。 コードがマネージ コードの場合、作成する .NET Framework アプリケーションではマネージ データ、アンマネージ データ、またはマネージ データとアンマネージ データの両方を使用できます。 プリミティブ型などのデータ型は言語コンパイラが独自に提供しているため、データがマネージ データかどうかが不明な (または把握する必要がない) 場合もあります。
-
-共通言語ランタイムでは、複数の言語間で対話できるオブジェクトを含むコンポーネントやアプリケーションを簡単にデザインできます。 異なる言語で記述されたオブジェクトが相互に対話でき、それらのオブジェクトの動作が緊密に統合されます。 たとえば、あるクラスを定義してから、そのクラスの派生クラスを別の言語で作成したり、そのクラスに対して別の言語で記述したメソッドを呼び出したりできます。 また、あるクラスのインスタンスを別の言語で記述されたクラスのメソッドに渡すこともできます。 このような言語間の統合を実現できるのは、共通言語ランタイムに対応した言語コンパイラとツールが、共通言語ランタイムによって定義されている共通型システムを採用し、型の作成、使用、永続化、型へのバインディング、および新しい型の定義に関する共通言語ランタイムの規則に従っているためです。
-
-すべてのマネージ コンポーネントは、関連するコンポーネントとリソースについての情報をメタデータの一部として保持しています。 共通言語ランタイムはこの情報を使用して、作成したコンポーネントまたはアプリケーションが必要とする特定バージョンのコンポーネントやリソースがあることを確認します。これにより、不明な依存関係によってコードが中断される確率が低くなります。 定義した型 (およびその依存関係) に関する情報はコードと共にメタデータとして保存されます。これによって、コンポーネントのレプリケーションと削除のタスクがより簡単に実行できるようになります。
-
-言語コンパイラおよびツールは、開発者にとってわかりやすく役に立つ方法で共通言語ランタイムの機能を公開します。 つまり、ある環境では重視されている共通言語ランタイムの機能が、別の環境ではそれほど重視されていないという場合もあります。 共通言語ランタイムがどのような利点をもたらすかは、使用するコンパイラやツールによって異なります。 ランタイムの利点は次のとおりです。 
-
-* 異なる言語で開発されたコンポーネントを簡単に利用可能。
-
-* クラス ライブラリによって提供される拡張性のある型。
-
-* 継承、インターフェイス、オーバーロードなどのオブジェクト指向プログラミングの言語機能。
-
-* マルチスレッドでスケーラブルなアプリケーションの作成を可能にする明示的なフリー スレッドのサポート。
-
-* 構造化例外処理のサポート。
-
-* カスタム属性のサポート。
-
-* ガベージ コレクション。
-
-* タイプ セーフとセキュリティを強化するために関数ポインターではなくデリゲートを使用。
-
-## <a name="versions-of-the-common-language-runtime"></a>共通言語ランタイムのバージョン
-
-.NET Framework のバージョン番号はそれに含まれている CLR のバージョン番号には必ずしも対応しません。 2 つのバージョン番号がどのように対応しているかを次の表に示します。 
-
-.NET Framework のバージョン | 含まれている CLR のバージョン 
----------------------- | --------------------
-1.0 | 1.0
-1.1 | 1.1
-2.0 | 2.0
-3.0 | 2.0
-3.5 | 2.0
-4 | 4
-4.5 (4.5.1 および 4.5.2 を含む) | 4
-4.6 (4.6.1 と 4.6.2 を含む) | 4
-
-## <a name="see-also"></a>関連項目
-
-[自動メモリ管理](garbagecollection/index.md)
-
- 
-
-
+title: "共通言語ランタイム (CLR) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, 共通言語ランタイム"
+  - "コード, 実行"
+  - "コード, ランタイム機能"
+  - "共通言語ランタイム"
+  - "コンパイル (ソース コードを), ランタイム機能"
+  - "言語コンパイラ"
+  - "マネージ コード"
+  - "マネージ データ"
+  - "メタデータ, ランタイム機能"
+  - "ランタイム"
+  - "ソース コード実行"
+ms.assetid: 059a624e-f7db-4134-ba9f-08b676050482
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 共通言語ランタイム (CLR)
+.NET Framework には、共通言語ランタイムと呼ばれるランタイム環境が用意されています。共通言語ランタイムは、コードを実行し、開発プロセスを支援するサービスを提供します。  
+  
+ コンパイラとツールにより、共通言語ランタイムの機能が公開されることによって、このマネージ実行環境の利点を活用するコードを記述できるようになります。  このような共通言語ランタイムに対応した言語コンパイラを使用して作成したコードはマネージ コードと呼ばれます。マネージ コードは、言語間の統合、言語間の例外処理、強化されたセキュリティ、バージョン管理と配置のサポート、コンポーネント間の対話の簡易モデル、デバッグ サービスとプロファイル サービスなど、さまざまな機能を利用できます。  
+  
+> [!WARNING]
+>  型システム、メタデータの書式、およびランタイム環境 \(仮想実行システム\) はすべて公的な標準規格の ECMA 共通言語基盤仕様により定義されているため、コンパイラおよびツールは共通言語ランタイムが使用できる出力を生成できます。  詳細については、「[ECMA C\# and Common Language Infrastructure Specifications \(ECMA C\# および共通言語基盤の仕様\)](http://go.microsoft.com/fwlink/?LinkId=99212)」を参照してください。  
+  
+ マネージ コードが共通言語ランタイムからサービスを受けられるようにするために、言語コンパイラは、そのコード内の型、メンバー、および参照を記述したメタデータを生成する必要があります。  メタデータはコード内に格納されます。つまり、共通言語ランタイムの読み込み可能なすべてのポータブル実行可能 \(PE\) ファイルには、メタデータが含まれていることになります。  共通言語ランタイムは、クラスの検索と読み込み、メモリ内でのインスタンスのレイアウト、メソッドの呼び出しの解決、ネイティブ コードの生成、セキュリティの強化、およびランタイムのコンテキスト境界の設定にメタデータを使用します。  
+  
+ 共通言語ランタイムはオブジェクトのレイアウトを自動的に処理し、それらのオブジェクトへの参照を管理し、不要になったオブジェクトを解放します。  このような方法で有効期間を管理されるオブジェクトをマネージ データと呼びます。  ガベージ コレクションによって、一般的なプログラミング エラーだけでなくメモリ リークもなくなります。  コードがマネージ コードの場合、作成する .NET Framework アプリケーションではマネージ データ、アンマネージ データ、またはマネージ データとアンマネージ データの両方を使用できます。  プリミティブ型などのデータ型は言語コンパイラが独自に提供しているため、データがマネージ データかどうかが不明な \(または把握する必要がない\) 場合もあります。  
+  
+ 共通言語ランタイムでは、複数の言語間で対話できるオブジェクトを含むコンポーネントやアプリケーションを簡単にデザインできます。  異なる言語で記述されたオブジェクトが相互に対話でき、それらのオブジェクトの動作が緊密に統合されます。  たとえば、あるクラスを定義してから、そのクラスの派生クラスを別の言語で作成したり、そのクラスに対して別の言語で記述したメソッドを呼び出したりできます。  また、あるクラスのインスタンスを別の言語で記述されたクラスのメソッドに渡すこともできます。  このような言語間の統合を実現できるのは、共通言語ランタイムに対応した言語コンパイラとツールが、共通言語ランタイムによって定義されている共通型システムを採用し、型の作成、使用、永続化、型へのバインディング、および新しい型の定義に関する共通言語ランタイムの規則に従っているためです。  
+  
+ すべてのマネージ コンポーネントは、関連するコンポーネントとリソースについての情報をメタデータの一部として保持しています。  共通言語ランタイムはこの情報を使用して、作成したコンポーネントまたはアプリケーションが必要とする特定バージョンのコンポーネントやリソースがあることを確認します。これにより、不明な依存関係によってコードが中断される確率が低くなります。  登録情報や状態データはレジストリ内では設定や保守が難しくなるため、レジストリには格納されなくなりました。  代わりに、定義した型 \(およびその依存関係\) に関する情報はコードと共にメタデータとして保存されます。これによって、コンポーネントのレプリケーションと削除がより簡単に実行できるようになります。  
+  
+ 言語コンパイラおよびツールは、開発者にとってわかりやすく役に立つ方法で共通言語ランタイムの機能を公開します。  つまり、ある環境では重視されている共通言語ランタイムの機能が、別の環境ではそれほど重視されていないという場合もあります。  共通言語ランタイムがどのような利点をもたらすかは、使用するコンパイラやツールによって異なります。  たとえば、Visual Basic の開発者が共通言語ランタイムを使用した場合は、Visual Basic 言語のオブジェクト指向機能が強化されたと感じるでしょう。  ランタイムの利点は次のとおりです。  
+  
+-   パフォーマンスの向上。  
+  
+-   異なる言語で開発されたコンポーネントを簡単に利用可能。  
+  
+-   クラス ライブラリによって提供される拡張性のある型。  
+  
+-   継承、インターフェイス、オーバーロードなどのオブジェクト指向プログラミングの言語機能。  
+  
+-   マルチスレッドでスケーラブルなアプリケーションの作成を可能にする明示的なフリー スレッドのサポート。  
+  
+-   構造化例外処理のサポート。  
+  
+-   カスタム属性のサポート。  
+  
+-   ガベージ コレクション。  
+  
+-   タイプ セーフとセキュリティを強化するために関数ポインターではなくデリゲートを使用。  デリゲートの詳細については、「[共通型システム](../../docs/standard/base-types/common-type-system.md)」を参照してください。  
+  
+## 共通言語ランタイムのバージョン  
+ .NET Framework のバージョン番号はそれに含まれている CLR のバージョン番号には必ずしも対応しません。  2 つのバージョン番号がどのように対応しているかを次の表に示します。  
+  
+|.NET Framework のバージョン|含まれている CLR のバージョン|  
+|---------------------------|-----------------------|  
+|1.0|1.0|  
+|1.1|1.1|  
+|2.0|2.0|  
+|3.0|2.0|  
+|3.5|2.0|  
+|4|4|  
+|4.5 \(4.5.1 および 4.5.2 を含む\)|4|  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[マネージ実行プロセス](../../docs/standard/managed-execution-process.md)|共通言語ランタイム利用するために必要な手順について説明します。|  
+|[自動メモリ管理](../../docs/standard/automatic-memory-management.md)|ガベージ コレクターによるメモリの割り当て方法および解放方法について説明します。|  
+|[NIB: Overview of the .NET Framework](http://msdn.microsoft.com/ja-jp/ea38ac1e-92af-4d1b-8db1-e8a5ea10ed85)|共通型システム、言語間での相互運用性、マネージ実行、アプリケーション ドメイン、アセンブリなどの .NET Framework の主要な概念について説明します。|  
+|[共通型システム](../../docs/standard/base-types/common-type-system.md)|言語間の統合をサポートするために共通言語ランタイムで型を宣言、使用、および管理する方法について説明します。|  
+  
+## 参照  
+ [バージョンおよび依存関係](../../docs/framework/migration-guide/versions-and-dependencies.md)
\ No newline at end of file
diff --git a/docs/standard/collections/commonly-used-collection-types.md b/docs/standard/collections/commonly-used-collection-types.md
index 166b9133947..a5adabe154a 100644
--- a/docs/standard/collections/commonly-used-collection-types.md
+++ b/docs/standard/collections/commonly-used-collection-types.md
@@ -1,59 +1,63 @@
 ---
-title: "一般的に使用されるコレクション型"
-description: "一般的に使用されるコレクション型"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 55861611-1e40-4cc2-9ec5-0b2df4ba6c0c
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: f44b8a87bf263032b991fc1bbc70712136910106
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="commonly-used-collection-types"></a>一般的に使用されるコレクション型
-
-コレクション型は、ハッシュ テーブル、キュー、スタック、バッグ、ディクショナリ、リストなど、一般的な種類のデータ コレクションです。
-
-コレクションは、[`ICollection`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ICollection) インターフェイス、[`IList`](https://docs.microsoft.com/dotnet/core/api/System.Collections.IList) インターフェイス、[`IDictionary`](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary) インターフェイス、または対応するジェネリックに基づきます。 `IList` インターフェイスと `IDictionary` インターフェイスはどちらも `ICollection` インターフェイスから派生したインターフェイスです。したがって、すべてのコレクションが直接または間接的に `ICollection` インターフェイスに基づきます。 `IList` インターフェイスに基づくコレクション ([`Array`](https://docs.microsoft.com/dotnet/core/api/System.Array)、[`ArrayList`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ArrayList), or [`List<T>)`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) など) または `ICollection` インターフェイスに直接基づくコレクション ([`Queue`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Queue)、[`ConcurrentQueue<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentQueue-1)、[`Stack`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Stack)、[`ConcurrentStack<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentStack-1)、[`LinkedList<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.LinkedList-1) など) では、すべての要素に値のみが含まれます。 `IDictionary` インターフェイスに基づくコレクション ([`Hashtable`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) クラスと [`SortedList`](https://docs.microsoft.com/dotnet/core/api/System.Collections.SortedList) クラス、[`Dictionary<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) ジェネリック クラスと [`SortedList<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラスなど)、または [`ConcurrentDictionary<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2) クラスでは、すべての要素にキーと値の両方が含まれます。 [`KeyedCollection<TKey, TItem>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) クラスは、キーが値に埋め込まれている値リストであるために独特で、そのために、リストのようにもディクショナリのようにも動作します。
-
-ジェネリック コレクションは、厳密な型指定に対する最適なソリューションです。 ただし、使用する言語でジェネリックがサポートされていない場合、[`System.Collections`](https://docs.microsoft.com/dotnet/core/api/System.Collections) 名前空間には [`CollectionBase`](https://docs.microsoft.com/dotnet/core/api/System.Collections.CollectionBase)、[`ReadOnlyCollectionBase`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ReadOnlyCollectionBase)、[`DictionaryBase`](https://docs.microsoft.com/dotnet/core/api/System.Collections.DictionaryBase) などの基本コレクションが含まれており、これらは抽象基本クラスで、厳密に型指定されたコレクション クラスを作成するために拡張できます。 効率的なマルチスレッド コレクション アクセスが必要な場合は、[`System.Collections.Concurrent`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent) 名前空間のジェネリック コレクションを使用します。
-
-コレクションは、要素の格納方法、要素の並べ替え方法、検索の実行方法、および比較の実行方法によって異なります。 [`Queue`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Queue) クラスと [`Queue<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Queue-1) ジェネリック クラスは先入れ先出しのリストを提供しますが、[`Stack`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Stack) クラスと [`Stack<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Stack-1) ジェネリック クラスは後入れ先出しのリストを提供します。 [`SortedList`](https://docs.microsoft.com/dotnet/core/api/System.Collections.SortedList) クラスと [`SortedList<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラスは、[`Hashtable`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) クラスと [`Dictionary<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) ジェネリック クラスの並べ替えバージョンを提供します。 `Hashtable` または `Dictionary<TKey, TValue>` の要素は、要素のキーによってのみアクセスできますが、`SortedList` または [`KeyedCollection<TKey, TItem>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) の要素は、キーまたは要素のインデックスによってアクセスできます。 すべてのコレクションのインデックスがゼロから始まりますが、[`Array`](https://docs.microsoft.com/dotnet/core/api/System.Array) は例外で、ゼロから始まらない配列を使用できます。
-
-LINQ to Objects 機能では、オブジェクト型で [`IEnumerable`](https://docs.microsoft.com/dotnet/core/api/System.Collections.IEnumerable) または [`IEnumerable<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEnumerable-1) を実装している限り、LINQ クエリを使用してメモリ内オブジェクトにアクセスできます。 LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の foreach ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化の機能を備えています。 さらに、LINQ クエリによってパフォーマンスを向上させることができます。
-
-## <a name="related-topics"></a>関連トピック
-
-タイトル | 説明
------ | -----------
-[`Collections and Data Structures`](index.md) | .NET Framework で利用できるスタック、キュー、リスト、配列、ディクショナリなどのさまざまなコレクション型について説明します。
-[`Hashtable and Dictionary Collection Types`](hashtable-and-dictionary-collection-types.md) | ジェネリックと非ジェネリックのハッシュをベースにしたディクショナリ型の機能について説明します。
-[`Sorted Collection Types`](sorted-collection-types.md) | 並べ替えられたコレクションのパフォーマンスと特性について説明します。
-
-## <a name="reference"></a>参照
-
-[`System.Collections`](https://docs.microsoft.com/dotnet/core/api/System.Collections)
-
-[`System.Collections.Generic`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic)
-
-[`System.Collections.ICollection`](https://docs.microsoft.com/dotnet/core/api/System.Collections.ICollection)
-
-[`System.Collections.Generic.ICollection<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.ICollection-1)
-
-[`System.Collections.IList`](https://docs.microsoft.com/dotnet/core/api/System.Collections.IList)
-
-[`System.Collections.Generic.IList<T>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IList-1)
-
-[`System.Collections.IDictionary`](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary)
-
-[`System.Collections.Generic.IDictionary<TKey, TValue>`](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2)
-
-[`System.Linq`](https://docs.microsoft.com/dotnet/core/api/System.Linq)
-
+title: "一般的に使用されるコレクション型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], 汎用"
+  - "Collections クラス"
+  - "ジェネリック コレクション"
+  - "ジェネリック [.NET Framework], コレクション"
+  - "グループ化 (コレクションによるデータの), ジェネリック コレクション型"
+  - "IDictionary インターフェイス, グループ化 (コレクションによるデータの)"
+  - "IList インターフェイス, グループ化 (コレクションによるデータの)"
+  - "オブジェクト [.NET Framework], グループ化 (コレクションによる)"
+ms.assetid: f5d4c6a4-0d7b-4944-a9fb-3b12d9ebfd55
+caps.latest.revision: 29
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# 一般的に使用されるコレクション型
+コレクション型は、ハッシュ テーブル、キュー、スタック、バッグ、ディクショナリ、リストなど、一般的な種類のデータ コレクションです。  
+  
+ コレクションは、<xref:System.Collections.ICollection> インターフェイス、<xref:System.Collections.IList> インターフェイス、<xref:System.Collections.IDictionary> インターフェイス、または対応するジェネリックに基づきます。  <xref:System.Collections.IList> インターフェイスと <xref:System.Collections.IDictionary> インターフェイスはどちらも <xref:System.Collections.ICollection> インターフェイスから派生したインターフェイスです。したがって、すべてのコレクションが直接または間接的に <xref:System.Collections.ICollection> インターフェイスに基づきます。  <xref:System.Collections.IList> インターフェイスに基づくコレクション \(<xref:System.Array>、<xref:System.Collections.ArrayList>、または <xref:System.Collections.Generic.List%601> など\) または <xref:System.Collections.ICollection> インターフェイスに直接基づくコレクション \(<xref:System.Collections.Queue>、<xref:System.Collections.Concurrent.ConcurrentQueue%601>、<xref:System.Collections.Stack>、<xref:System.Collections.Concurrent.ConcurrentStack%601>、または <xref:System.Collections.Generic.LinkedList%601> など\) では、すべての要素に値のみが含まれます。  <xref:System.Collections.IDictionary> インターフェイスに基づくコレクション \(<xref:System.Collections.Hashtable> クラスと <xref:System.Collections.SortedList> クラス、<xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスと <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスなど\)、または <xref:System.Collections.Concurrent.ConcurrentDictionary%602> クラスでは、すべての要素にキーと値の両方が含まれます。  <xref:System.Collections.ObjectModel.KeyedCollection%602> クラスは、キーが値に埋め込まれている値リストであるために独特で、そのために、リストのようにもディクショナリのようにも動作します。  
+  
+ ジェネリック コレクションは、厳密な型指定に対する最適なソリューションです。  ただし、使用する言語でジェネリックがサポートされていない場合、<xref:System.Collections> 名前空間には <xref:System.Collections.CollectionBase>、<xref:System.Collections.ReadOnlyCollectionBase>、<xref:System.Collections.DictionaryBase> などの基本コレクションが含まれており、これらは抽象基本クラスで、厳密に型指定されたコレクション クラスを作成するために拡張できます。  効率的なマルチスレッド コレクション アクセスが必要な場合は、<xref:System.Collections.Concurrent> 名前空間のジェネリック コレクションを使用します。  
+  
+ コレクションは、要素の格納方法、要素の並べ替え方法、検索の実行方法、および比較の実行方法によって異なります。  <xref:System.Collections.Queue> クラスと <xref:System.Collections.Generic.Queue%601> ジェネリック クラスは先入れ先出しのリストを提供しますが、<xref:System.Collections.Stack> クラスと <xref:System.Collections.Generic.Stack%601> ジェネリック クラスは後入れ先出しのリストを提供します。  <xref:System.Collections.SortedList> クラスと <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスは、<xref:System.Collections.Hashtable> クラスと <xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスの並べ替えバージョンを提供します。  <xref:System.Collections.Hashtable> または <xref:System.Collections.Generic.Dictionary%602> の要素は、要素のキーによってのみアクセスできますが、<xref:System.Collections.SortedList> または <xref:System.Collections.ObjectModel.KeyedCollection%602> の要素は、キーまたは要素のインデックスによってアクセスできます。  すべてのコレクションのインデックスがゼロから始まりますが、<xref:System.Array> は例外で、ゼロから始まらない配列を使用できます。  
+  
+ LINQ to Objects 機能では、オブジェクト型で <xref:System.Collections.IEnumerable> または <xref:System.Collections.Generic.IEnumerable%601> を実装している限り、LINQ クエリを使用してメモリ内オブジェクトにアクセスできます。  LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の `foreach` ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化機能を備えています。  さらに、LINQ クエリによってパフォーマンスを向上させることができます。  詳しくは、「[LINQ to Objects](../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-objects.md)」および「[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[コレクションとデータ構造体](../../../docs/standard/collections/index.md)|スタック、キュー、リスト、配列、ディクショナリなど、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] で利用できるさまざまなコレクション型について説明します。|  
+|[Hashtable コレクション型と Dictionary コレクション型](../../../docs/standard/collections/hashtable-and-dictionary-collection-types.md)|ジェネリックと非ジェネリックのハッシュ ベースのディクショナリ型の機能について説明します。|  
+|[Sorted コレクション型](../../../docs/standard/collections/sorted-collection-types.md)|リストとセットの並べ替え機能を提供するクラスについて説明します。|  
+|[ジェネリック](../../../docs/standard/generics/index.md)|ジェネリック コレクション、汎用デリゲート、ジェネリック インターフェイスなど、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] に用意されているジェネリック機能について説明します。  C\#、Visual Basic、および Visual C\+\+ の機能についてのドキュメント、およびリフレクションなどのサポート テクノロジへのリンクを示します。|  
+  
+## 参照  
+ <xref:System.Collections?displayProperty=fullName>  
+  
+ <xref:System.Collections.Generic?displayProperty=fullName>  
+  
+ <xref:System.Collections.ICollection?displayProperty=fullName>  
+  
+ <xref:System.Collections.Generic.ICollection%601?displayProperty=fullName>  
+  
+ <xref:System.Collections.IList?displayProperty=fullName>  
+  
+ <xref:System.Collections.Generic.IList%601?displayProperty=fullName>  
+  
+ <xref:System.Collections.IDictionary?displayProperty=fullName>  
+  
+ <xref:System.Collections.Generic.IDictionary%602?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/collections/comparisons-and-sorts-within-collections.md b/docs/standard/collections/comparisons-and-sorts-within-collections.md
index 370fc4b38f5..2bb8d0eb56e 100644
--- a/docs/standard/collections/comparisons-and-sorts-within-collections.md
+++ b/docs/standard/collections/comparisons-and-sorts-within-collections.md
@@ -1,204 +1,68 @@
 ---
-title: "コレクション内での比較と並べ替え"
-description: "コレクション内での比較と並べ替え"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: c7b7c005-628d-427a-91ad-af0c3958c00e
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 6826c0c2e86d0a1add1f88b001c13143ee098634
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="comparisons-and-sorts-within-collections"></a>コレクション内での比較と並べ替え
-
-[System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections) クラスは、削除する要素を検索するか、キーと値のペアの値を返すかに関係なく、コレクションの管理に関連するほぼすべての処理において比較を実行します。
-
-通常、コレクションは等値比較子か順序比較子、またはその両方を使用します。 比較には&2; つのコンストラクターが使用されます。 
-
-## <a name="checking-for-equality"></a>等価性のチェック
-
-`Contains`、`IndexOf`、`LastIndexOf`、`Remove` などのメソッドは、コレクション要素に対して等値比較子を使用します。 コレクションがジェネリックの場合、次のガイドラインに従ってアイテムの等価性が比較されます。
-
-*   T 型で [IEquatable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IEquatable-1) ジェネリック インターフェイスが実装されている場合、等値比較子はそのインターフェイスの `Equals` メソッドです。
-
-*   T 型で `IEquatable<T>` が実装されていない場合、`Object.Equals` が使用されます。
-
-また、ディクショナリ コレクションの一部のコンストラクター オーバーロードでは、[IEqualityComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEqualityComparer-1) 実装が受け取られ、これを使用してキーの等価性が比較されます。
-
-## <a name="determining-sort-order"></a>並べ替え順序の決定
-
-`BinarySearch`、`Sort` などのメソッドは、コレクション要素に対して順序比較子を使用します。 コレクションの要素間または要素と指定された値との間で比較を実行できます。 オブジェクトの比較には、既定の比較子と明示的な比較子の概念が適用されます。 
-
-既定の比較子は、比較される&1; つ以上のオブジェクトに依存して `IComparable` インターフェイスを実装します。 リスト コレクションの値として使用されるか、またはディクショナリ コレクションのキーとして使用されるすべてのクラスで、`IComparable` を実装することをお勧めします。 ジェネリック コレクションの場合、等価比較は次の基準に従って決定されます。
-
-*   T 型で [System.IComparable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IComparable-1) ジェネリック インターフェイスが実装されている場合、既定の比較子はそのインターフェイスの `CompareTo(T)` メソッドです。
-
-*   T 型で非ジェネリックの [System.IComparable](https://docs.microsoft.com/dotnet/core/api/System.IComparable) インターフェイスが実装されている場合、既定の比較子はそのインターフェイスの `CompareTo`(Object) メソッドです。
-
-*   T 型でいずれのインターフェイスも実装されていない場合、既定の比較子は存在せず、比較子または比較デリゲートを明示的に指定する必要があります。
-
-明示的な比較を指定するために、一部のメソッドではパラメーターとして `IComparer` 実装を受け取ります。 たとえば、`List<T>.Sort` メソッドは [System.Collections.Generic.IComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IComparer-1) 実装を受け取ります。 
-
-## <a name="equality-and-sort-example"></a>等価性と並べ替えの例
-
-次のコードは、単純なビジネス オブジェクトでの [IEquatable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IEquatable-1) と [IComparable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IComparable-1) の実装を示しています。 また、オブジェクトがリストに格納され、並べ替えられている場合、`Sort()` メソッドを呼び出すと、結果的に 'Part' 型の既定の比較子と、匿名メソッドを使用して実装された `Sort(Comparison<T>)` メソッドを使用することになります。
-
-C#
-
-```csharp
-using System;
-using System.Collections.Generic;
-// Simple business object. A PartId is used to identify the type of part 
-// but the part name can change. 
-public class Part : IEquatable<Part> , IComparable<Part>
-{
-    public string PartName { get; set; }
-
-    public int PartId { get; set; }
-
-    public override string ToString()
-    {
-        return "ID: " + PartId + "   Name: " + PartName;
-    }
-    public override bool Equals(object obj)
-    {
-        if (obj == null) return false;
-        Part objAsPart = obj as Part;
-        if (objAsPart == null) return false;
-        else return Equals(objAsPart);
-    }
-    public int SortByNameAscending(string name1, string name2)
-    {
-
-        return name1.CompareTo(name2);
-    }
-
-    // Default comparer for Part type.
-    public int CompareTo(Part comparePart)
-    {
-          // A null value means that this object is greater.
-        if (comparePart == null)
-            return 1;
-
-        else
-            return this.PartId.CompareTo(comparePart.PartId);
-    }
-    public override int GetHashCode()
-    {
-        return PartId;
-    }
-    public bool Equals(Part other)
-    {
-        if (other == null) return false;
-        return (this.PartId.Equals(other.PartId));
-    }
-    // Should also override == and != operators.
-
-}
-public class Example
-{
-    public static void Main()
-    {
-        // Create a list of parts.
-        List<Part> parts = new List<Part>();
-
-        // Add parts to the list.
-        parts.Add(new Part() { PartName = "regular seat", PartId = 1434 });
-        parts.Add(new Part() { PartName= "crank arm", PartId = 1234 });
-        parts.Add(new Part() { PartName = "shift lever", PartId = 1634 }); ;
-        // Name intentionally left null.
-        parts.Add(new Part() {  PartId = 1334 });
-        parts.Add(new Part() { PartName = "banana seat", PartId = 1444 });
-        parts.Add(new Part() { PartName = "cassette", PartId = 1534 });
-
-
-        // Write out the parts in the list. This will call the overridden 
-        // ToString method in the Part class.
-        Console.WriteLine("\nBefore sort:");
-        foreach (Part aPart in parts)
-        {
-            Console.WriteLine(aPart);
-        }
-
-
-        // Call Sort on the list. This will use the 
-        // default comparer, which is the Compare method 
-        // implemented on Part.
-        parts.Sort();
-
-
-        Console.WriteLine("\nAfter sort by part number:");
-        foreach (Part aPart in parts)
-        {
-            Console.WriteLine(aPart);
-        }
-
-        // This shows calling the Sort(Comparison(T) overload using 
-        // an anonymous method for the Comparison delegate. 
-        // This method treats null as the lesser of two values.
-        parts.Sort(delegate(Part x, Part y)
-        {
-            if (x.PartName == null && y.PartName == null) return 0;
-            else if (x.PartName == null) return -1;
-            else if (y.PartName == null) return 1;
-            else return x.PartName.CompareTo(y.PartName);
-        });
-
-        Console.WriteLine("\nAfter sort by name:");
-        foreach (Part aPart in parts)
-        {
-            Console.WriteLine(aPart);
-        }
-
-        /*
-
-            Before sort:
-        ID: 1434   Name: regular seat
-        ID: 1234   Name: crank arm
-        ID: 1634   Name: shift lever
-        ID: 1334   Name:
-        ID: 1444   Name: banana seat
-        ID: 1534   Name: cassette
-
-        After sort by part number:
-        ID: 1234   Name: crank arm
-        ID: 1334   Name:
-        ID: 1434   Name: regular seat
-        ID: 1444   Name: banana seat
-        ID: 1534   Name: cassette
-        ID: 1634   Name: shift lever
-
-        After sort by name:
-        ID: 1334   Name:
-        ID: 1444   Name: banana seat
-        ID: 1534   Name: cassette
-        ID: 1234   Name: crank arm
-        ID: 1434   Name: regular seat
-        ID: 1634   Name: shift lever
-
-         */
-
-    }
-}
-```
-
-## <a name="see-also"></a>関連項目
-
-[IComparer](https://docs.microsoft.com/dotnet/core/api/System.Collections.IComparer)
-
-[IEquatable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IEquatable-1)
-
-[IComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IComparer-1)
-
-[IComparable](https://docs.microsoft.com/dotnet/core/api/System.IComparable)
-
-[IComparable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.IComparable-1)
-
+title: "コレクション内での比較と並べ替え | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], 比較"
+  - "Collections クラス"
+  - "Equals メソッド"
+  - "IComparable.CompareTo メソッド"
+  - "並べ替え (データの), コレクション"
+ms.assetid: 5e4d3b45-97f0-423c-a65f-c492ed40e73b
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# コレクション内での比較と並べ替え
+<xref:System.Collections> クラスは、削除する要素を検索するか、キーと値のペアの値を返すかに関係なく、コレクションの管理に関連するほぼすべての処理において比較を実行します。  
+  
+ 通常、コレクションは等値比較子か順序比較子、またはその両方を使用します。 比較には 2 つのコンストラクターが使用されます。  
+  
+<a name="BKMK_Checkingforequality"></a>   
+## 等価性のチェック  
+ `Contains`、<xref:System.Collections.IList.IndexOf%2A>、<xref:System.Collections.Generic.List%601.LastIndexOf%2A>、`Remove` などのメソッドは、コレクション要素に対して等値比較子を使用します。 コレクションがジェネリックの場合、次のガイドラインに従ってアイテムの等価性が比較されます。  
+  
+-   T 型で <xref:System.IEquatable%601> ジェネリック インターフェイスが実装されている場合、等値比較子はそのインターフェイスの <xref:System.IEquatable%601.Equals%2A> メソッドです。  
+  
+-   T 型で <xref:System.IEquatable%601> が実装されていない場合、<xref:System.Object.Equals%2A?displayProperty=fullName> が使用されます。  
+  
+ また、ディクショナリ コレクションの一部のコンストラクター オーバーロードでは、<xref:System.Collections.Generic.IEqualityComparer%601> 実装が受け取られ、これを使用してキーの等価性が比較されます。 例については、<xref:System.Collections.Generic.Dictionary%602.%23ctor%2A?displayProperty=fullName> コンストラクターに関する説明を参照してください。  
+  
+<a name="BKMK_Determiningsortorder"></a>   
+## 並べ替え順序の決定  
+ `BinarySearch`、`Sort` などのメソッドは、コレクション要素に対して順序比較子を使用します。 コレクションの要素間または要素と指定された値との間で比較を実行できます。 オブジェクトの比較には、`default comparer`と`explicit comparer`の概念が適用されます。  
+  
+ 既定の比較子は、比較される 1 つ以上のオブジェクトに依存して **IComparable** インターフェイスを実装します。 リスト コレクションの値として使用されるか、またはディクショナリ コレクションのキーとして使用されるすべてのクラスで、**IComparable** を実装することをお勧めします。 ジェネリック コレクションの場合、等価比較は次の基準に従って決定されます。  
+  
+-   T 型で <xref:System.IComparable%601?displayProperty=fullName> ジェネリック インターフェイスが実装されている場合、既定の比較子はそのインターフェイスの <xref:System.IComparable%601.CompareTo%28%600%29?displayProperty=fullName> メソッドです。  
+  
+-   T 型で非ジェネリックの <xref:System.IComparable?displayProperty=fullName> インターフェイスが実装されている場合、既定の比較子はそのインターフェイスの <xref:System.IComparable.CompareTo%28System.Object%29?displayProperty=fullName> メソッドです。  
+  
+-   T 型でいずれのインターフェイスも実装されていない場合、既定の比較子は存在せず、比較子または比較デリゲートを明示的に指定する必要があります。  
+  
+ 明示的な比較を指定するために、一部のメソッドではパラメーターとして **IComparer** 実装を受け取ります。 たとえば、<xref:System.Collections.Generic.List%601.Sort%2A?displayProperty=fullName> メソッドは <xref:System.Collections.Generic.IComparer%601?displayProperty=fullName> 実装を受け取ります。  
+  
+ システムの現在のカルチャ設定は、コレクション内の比較と並べ替えに影響を与える可能性があります。 既定では、**Collections** クラスの比較と並べ替えはカルチャに依存します。 カルチャ設定を無視して一貫した比較と並べ替えの結果を得るには、<xref:System.Globalization.CultureInfo.InvariantCulture%2A> を受け取るメンバー オーバーロードと共に <xref:System.Globalization.CultureInfo> を使用します。 詳細については、次のトピックを参照してください。[カルチャを認識しないコレクションの操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md) および[カルチャを認識しない配列の操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-arrays.md).  
+  
+<a name="BKMK_Equalityandsortexample"></a>   
+## 等価性と並べ替えの例  
+ 次のコードは、単純なビジネス オブジェクトでの <xref:System.IEquatable%601> と <xref:System.IComparable%601> の実装を示しています。 また、オブジェクトがリストに格納され、並べ替えられている場合、<xref:System.Collections.Generic.List%601.Sort> メソッドを呼び出すと、結果的に `Part` 型の既定の比較子と、匿名メソッドを使用して実装された <xref:System.Collections.Generic.List%601.Sort%28System.Comparison%7B%600%7D%29> メソッドを使用することになります。  
+  
+ [!code-csharp[System.Collections.Generic.List.Sort#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.collections.generic.list.sort/cs/program.cs#1)]
+ [!code-vb[System.Collections.Generic.List.Sort#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.collections.generic.list.sort/vb/module1.vb#1)]  
+  
+## 参照  
+ <xref:System.Collections.IComparer>   
+ <xref:System.IEquatable%601>   
+ <xref:System.Collections.Generic.IComparer%601>   
+ <xref:System.IComparable>   
+ <xref:System.IComparable%601>
\ No newline at end of file
diff --git a/docs/standard/collections/hashtable-and-dictionary-collection-types.md b/docs/standard/collections/hashtable-and-dictionary-collection-types.md
index af3d6990a10..1c5bfe8a377 100644
--- a/docs/standard/collections/hashtable-and-dictionary-collection-types.md
+++ b/docs/standard/collections/hashtable-and-dictionary-collection-types.md
@@ -1,52 +1,50 @@
 ---
-title: "Hashtable コレクション型と Dictionary コレクション型"
-description: "Hashtable コレクション型と Dictionary コレクション型"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 0f18fac7-fd0d-4f25-a046-1d3d51de062e
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 58c87f9e86b5b97feb654e92a56f81940c201a6a
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="hashtable-and-dictionary-collection-types"></a>Hashtable コレクション型と Dictionary コレクション型
-
-[System.Collections.Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) クラスと、[System.Collections.Generic.Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) および [System.Collections.Concurrent.ConcurrentDictionary<T>](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2) ジェネリック クラスは、[System.Collections.IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary) インターフェイスを実装します。 `Dictionary<T>` ジェネリック クラスも、[IDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2) ジェネリック インターフェイスを実装します。 そのため、これらのコレクション内の各要素は、キーと値のペアになります。
-
-`Hashtable` オブジェクトは、コレクションの要素を含むバケットので構成されます。 バケットは`Hashtable` に含まれる要素の仮想サブグループで、これを使用することにより、ほとんどのコレクションで検索と取得がより簡単で高速になります。 各バケットは、ハッシュ関数を使用して生成され、要素のキーに基づいている、ハッシュ コードに関連付けられています。
-
-ジェネリック [HashSet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.HashSet-1) クラスは、一意の要素を格納するための順序付けられていないコレクションです。 
-
-ハッシュ関数は、キーに基づく数値のハッシュ コードを返すアルゴリズムです。 キーは、格納されているオブジェクトのいくつかのプロパティの値です。 ハッシュ関数は、同じキーに対して常に同じハッシュ コードを返す必要があります。 ハッシュ関数によって&2; つの異なるキーを持つ同一のハッシュ コードを生成することも可能ですが、一意のキーごとに一意のハッシュ コードを生成するハッシュ関数のほうが、ハッシュ テーブルから要素を取得する際により優れたパフォーマンスを実現します。
-
-`Hashtable` で要素として使用されている各オブジェクトは、`GetHashCode` メソッドの実装を使用して、それ自体のハッシュ コードを生成できる必要があります。 
-
-オブジェクトは、`Hashtable` に追加されるとき、そのオブジェクトのハッシュ コードと一致するハッシュ コードに関連付けられたバケットに格納されます。 値が `Hashtable` 内で検索されるとき、その値のハッシュ コードが生成されて、そのハッシュ コードに関連付けられたバケットが検索されます。
-
-たとえば、文字列のハッシュ関数は、文字列内の各文字の ASCII コードを取得し、それらを加え合わせて&1; つのハッシュ コードを生成することができます。 その場合、文字列「picnic」のハッシュ コードは文字列「basket」のハッシュ コードと異なるので、文字列「picnic」と「basket」は異なるバケットに格納されます。 それに対して、「stressed」と「desserts」は同じハッシュ コードを持つので、同じバケットに格納されます。
-
-`Dictionary<T>` および `ConcurrentDictionary<T>` クラスには、`Hashtable` クラスと同じ機能があります。 特定の型 (`Object` を除く) の`Dictionary<T>` は、値型の `Hashtable` よりも優れたパフォーマンスを実現します。 これは、`Hashtable` の要素の型が `Object` であるため、値型を格納したり取得したりすると、ボックス化とボックス化解除が通常発生するためです。 複数のスレッドが同時にコレクションにアクセスするときには、`ConcurrentDictionary<T>` クラスを使用する必要があります。
-
-## <a name="see-also"></a>関連項目
-
-[Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable)
-
-[IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary)
-
-[Dictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2)
-
-[System.Collections.Generic.IDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2)
-
-[System.Collections.Concurrent.ConcurrentDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2)
-
-[一般的に使用されるコレクション型](commonly-used-collection-types.md)
-
-
+title: "Hashtable コレクション型と Dictionary コレクション型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], Hashtable コレクション型"
+  - "グループ化 (コレクションによるデータの), Hashtable コレクション型"
+  - "hash 関数"
+  - "ハッシュ テーブル"
+  - "Hashtable クラス, グループ化 (コレクションによるデータの)"
+  - "Hashtable コレクション型"
+ms.assetid: bfc20837-3d02-4fc7-8a8f-c5215b6b7913
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Hashtable コレクション型と Dictionary コレクション型
+<xref:System.Collections.Hashtable?displayProperty=fullName> クラス、および <xref:System.Collections.Generic.Dictionary%602?displayProperty=fullName> と <xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName> ジェネリック クラスは、<xref:System.Collections.IDictionary?displayProperty=fullName> インターフェイスを実装します。  <xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスも <xref:System.Collections.Generic.IDictionary%602> ジェネリック インターフェイスを実装します。  そのため、これらのコレクション内の各要素は、キーと値のペアになります。  
+  
+ <xref:System.Collections.Hashtable> オブジェクトは、コレクションの要素を含むバケットので構成されます。  バケットは<xref:System.Collections.Hashtable> に含まれる要素の仮想サブグループで、これを使用することにより、ほとんどのコレクションで検索と取得がより簡単で高速になります。  各バケットは、ハッシュ関数を使用して生成され、要素のキーに基づいている、ハッシュ コードに関連付けられています。  
+  
+ ジェネリック <xref:System.Collections.Generic.HashSet%601> クラスは、一意の要素を格納するための順序付けられていないコレクションです。  
+  
+ ハッシュ関数は、キーに基づく数値のハッシュ コードを返すアルゴリズムです。  キーは、格納されているオブジェクトのいくつかのプロパティの値です。  ハッシュ関数は、同じキーに対して常に同じハッシュ コードを返す必要があります。  ハッシュ関数によって 2 つの異なるキーを持つ同一のハッシュ コードを生成することも可能ですが、一意のキーごとに一意のハッシュ コードを生成するハッシュ関数のほうが、ハッシュ テーブルから要素を取得する際により優れたパフォーマンスを実現します。  
+  
+ <xref:System.Collections.Hashtable> で要素として使用されている各オブジェクトは、<xref:System.Object.GetHashCode%2A> メソッドの実装を使用して、それ自体のハッシュ コードを生成できる必要があります。  ただし、<xref:System.Collections.IHashCodeProvider> 実装をパラメーターの 1 つとして受け入れる <xref:System.Collections.Hashtable> コンストラクターを使用して、<xref:System.Collections.Hashtable> のすべての要素のハッシュ関数を指定することもできます。  
+  
+ オブジェクトは、<xref:System.Collections.Hashtable> に追加されるとき、そのオブジェクトのハッシュ コードと一致するハッシュ コードに関連付けられたバケットに格納されます。  値が <xref:System.Collections.Hashtable> 内で検索されるとき、その値のハッシュ コードが生成されて、そのハッシュ コードに関連付けられたバケットが検索されます。  
+  
+ たとえば、文字列のハッシュ関数は、文字列内の各文字の ASCII コードを取得し、それらを加え合わせて 1 つのハッシュ コードを生成することができます。  その場合、文字列「picnic」のハッシュ コードは文字列「basket」のハッシュ コードと異なるので、文字列「picnic」と「basket」は異なるバケットに格納されます。  それに対して、「stressed」と「desserts」は同じハッシュ コードを持つので、同じバケットに格納されます。  
+  
+ <xref:System.Collections.Generic.Dictionary%602> と <xref:System.Collections.Concurrent.ConcurrentDictionary%602> `` クラスには、<xref:System.Collections.Hashtable> クラスと同じ機能があります。  特定の型 \(<xref:System.Object> を除く\) の<xref:System.Collections.Generic.Dictionary%602> は、値型の <xref:System.Collections.Hashtable> よりも優れたパフォーマンスを実現します。  これは、<xref:System.Collections.Hashtable> の要素の型が <xref:System.Object> であるため、値型を格納したり取得したりすると、ボックス化とボックス化解除が通常発生するためです。  複数のスレッドが同時にコレクションにアクセスするときには、<xref:System.Collections.Concurrent.ConcurrentDictionary%602> ``  クラスを使用する必要があります。  
+  
+## 参照  
+ <xref:System.Collections.Hashtable>   
+ <xref:System.Collections.IDictionary>   
+ <xref:System.Collections.IHashCodeProvider>   
+ <xref:System.Collections.Generic.Dictionary%602>   
+ <xref:System.Collections.Generic.IDictionary%602?displayProperty=fullName>   
+ <xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName>   
+ [一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)
\ No newline at end of file
diff --git a/docs/standard/collections/index.md b/docs/standard/collections/index.md
index e1309132966..2da97e454ef 100644
--- a/docs/standard/collections/index.md
+++ b/docs/standard/collections/index.md
@@ -1,99 +1,109 @@
 ---
-title: "コレクションとデータ構造体"
-description: "コレクションとデータ構造体"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 9e70255a-c02a-4046-86b7-10c84bab2d38
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 30e53c38bd58e15668e01f2af79defb0a0918192
-ms.lasthandoff: 04/05/2017
-
----
-
-# <a name="collections-and-data-structures"></a>コレクションとデータ構造体
-
-多くの場合、類似するデータはコレクションとして格納および操作すると、より効率的に処理できます。 [System.Array](https://docs.microsoft.com/dotnet/core/api/System.Array) クラス、または [System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections)、 [System.Collections.Generic](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic)、[System.Collections.Concurrent](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent) の各名前空間のクラスを使用して、コレクションの個々の要素または一定の範囲の要素を追加、削除、または変更することができます。
-
-主要なコレクションの型として、ジェネリック コレクションと非ジェネリック コレクションの&2; つがあります。 ジェネリック コレクションはコンパイル時にタイプ セーフです。 このため、通常、ジェネリック コレクションの方がパフォーマンスが高くなります。 ジェネリック コレクションは構築時に型パラメーターを受け取りますが、項目をコレクションに追加またはコレクションから削除するときに [Object](https://docs.microsoft.com/dotnet/core/api/System.Object) 型との間でキャストする必要はありません。 非ジェネリック コレクションでは、項目が [Object](https://docs.microsoft.com/dotnet/core/api/System.Object) として項目が保存され、キャストが必要です。 以前のコードには非ジェネリック コレクションが含まれている場合があります。
-
-[System.Collections.Concurrent](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent) 名前空間のコレクションによって、複数のスレッドからコレクション項目にアクセスするための効率的なスレッド セーフ操作が可能になります。
-
-## <a name="common-collection-features"></a>一般的なコレクションの機能
-
-すべてのコレクションに、コレクション内の項目を追加、削除、または検索するためのメソッドが用意されています。 また、[ICollection](https://docs.microsoft.com/dotnet/core/api/System.Collections.ICollection) インターフェイスまたは [ICollection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.ICollection-1) インターフェイスを直接または間接的に実装するすべてのコレクションで、次の機能を共有しています。 
-
-* **コレクションを列挙する機能**
-
-   .NET Framework コレクションは [System.Collections.IEnumerable](https://docs.microsoft.com/dotnet/core/api/System.Collections.IEnumerable) または [System.Collections.Generic.IEnumerable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEnumerable-1) のどちらかを実装して、コレクションの反復を可能にします。 列挙子は、コレクション内の任意の要素への移動可能なポインターと考えることができます。 `foreach, in` ステートメント (C#) では、`GetEnumerator` メソッドによって公開される列挙子を使用して、列挙子の操作の複雑さを隠しています。 また、[System.Collections.Generic.IEnumerable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEnumerable-1) を実装するコレクションはいずれもクエリ可能型と見なされ、LINQ で照会できます。 LINQ クエリでは、データにアクセスするための共通パターンが提供されます。 通常、これらは、標準のループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化の機能を利用できます。 さらに、LINQ クエリによってパフォーマンスを向上させることができます。
-    
-* **コレクションの内容を配列にコピーする機能**
-
-   `CopyTo` メソッドを使用してすべてのコレクションを配列にコピーできます。ただし、新しい配列の要素の順序は、列挙子が返す順序に基づきます。 結果の配列は、常に下限がゼロの&1; 次元です。
-    
-また、多くのコレクション クラスに次の機能が含まれています。
-
-* **容量とカウントのプロパティ**
-
-   コレクションの容量とは、そこに含むことのできる要素の数です。 コレクションのカウントとは、実際に含まれている要素の数です。 コレクションによっては、容量またはカウント、あるいはその両方を内部で処理する場合があります。
-    
-   ほとんどのコレクションで、現在の容量に達すると自動的に容量が拡張されます。 メモリが再割り当てされ、要素は古いコレクションから新しいコレクションにコピーされます。 これにより、コレクションを使用するために必要なコードが削減されます。ただし、コレクションのパフォーマンスに悪影響を及ぼす可能性があります。 たとえば、[List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) では、`Count` が `Capacity` 未満の場合、項目の追加は O(1) 操作になります。 容量を増やして新しい要素を格納する必要がある場合、項目の追加は O(n) 操作になります。ここで、n は `Count` です。 複数の再割り当てによるパフォーマンスの低下を回避するには、初期容量をコレクションの見積もりサイズに設定しておくことが最善の方法です。 
-    
-   [BitArray](https://docs.microsoft.com/dotnet/core/api/System.Collections.BitArray) は特殊なケースで、その容量はその長さと同じで、長さはそのカウントと同じです。
-    
-*   **一貫した下限**
-
-   コレクションの下限とは、最初の要素のインデックスです。 [System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections) 名前空間のすべてのインデックス付きコレクションの下限がゼロです。つまり、インデックスがゼロから始まります。 [Array](https://docs.microsoft.com/dotnet/core/api/System.Array) の下限は既定でゼロですが、`Array.CreateInstance` を使用して `Array` クラスのインスタンスを作成する場合には、別の下限を定義できます。
-
-*   **複数のスレッドからのアクセスの同期** ([System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections) クラスのみ)。
-
-   [System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections) 名前空間の非ジェネリック コレクション型では、同期によるスレッド セーフが提供され、通常、`SyncRoot` メンバーと `IsSynchronized` メンバーを介して公開されます。 既定では、これらのコレクションはスレッド セーフではありません。 拡張性が高く効率的な、コレクションへのマルチスレッド アクセスが必要な場合は、[System.Collections.Concurrent](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent) 名前空間のいずれかのクラスを使用するか、変更できないコレクションを使用することを検討します。 詳しくは、「[スレッド セーフなコレクション](threadsafe/index.md)」を参照してください。    
-    
-## <a name="choosing-a-collection"></a>コレクションの選択 
-
-通常は、ジェネリック コレクションを使用します。 次の表では、一般的なコレクションのシナリオとこれらのシナリオに使用できるコレクション クラスについて説明します。 ジェネリック コレクションに対する知識がない場合、このテーブルは、タスクに最適なジェネリック コレクションを選択するのに役立ちます。
-
-やりたいこと | ジェネリック コレクションのオプション | 非ジェネリック コレクションのオプション
----------- | ---------------------------- | --------------------------------
-キーによるクイック検索用のキー/値のペアとして項目を保存する | [System.Collections.Generic.Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) | [Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable)
-インデックスで項目にアクセスする | [System.Collections.Generic.List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) | [System.Array](https://docs.microsoft.com/dotnet/core/api/System.Array), [System.Collections.ArrayList](https://docs.microsoft.com/dotnet/core/api/System.Collections.ArrayList)
-先入れ先出し (FIFO) で項目を使用する | [System.Collections.Generic.Queue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Queue-1) | [System.Collections.Queue](https://docs.microsoft.com/dotnet/core/api/System.Collections.Queue)
-後入れ先出し (LIFO) でデータを使用する | [System.Collections.Generic.Stack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Stack-1) | [System.Collections.Stack](https://docs.microsoft.com/dotnet/core/api/System.Collections.Stack)
-項目に順次アクセスする | [System.Collections.Generic.LinkedList&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.LinkedList-1) | 推奨しません
-項目がコレクションから削除またはコレクションに追加されるときに通知を受け取る。 ([INotifyPropertyChanged](https://docs.microsoft.com/dotnet/core/api/System.ComponentModel.INotifyPropertyChanged) および [INotifyCollectionChanged](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.INotifyCollectionChanged) を実装) | [System.Collections.ObjectModel.ObservableCollection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.ObservableCollection-1) | 推奨しません
-Sorted コレクションを使用する | [System.Collections.Generic.SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) | [System.Collections.SortedList](https://docs.microsoft.com/dotnet/core/api/System.Collections.SortedList)
-一意の要素の効率的な格納とアクセスを管理する | [System.Collections.Generic.HashSet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.HashSet-1), [System.Collections.Generic.SortedSet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedSet-1) | 推奨しません
-
-## <a name="related-topics"></a>関連トピック
-
-タイトル | 説明
------ | -----------
-[コレクション クラスの選択](selecting-a-collection-class.md) | さまざまなコレクションについて説明し、いずれかのシナリオを選択できるよう支援します。
-[一般的に使用されるコレクション型](commonly-used-collection-types.md) | [System.Array](https://docs.microsoft.com/dotnet/core/api/System.Array)、[System.Collections.Generic.List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1)、[System.Collections.Generic.Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) などの、一般的に使用されるジェネリックおよび非ジェネリックのコレクション型について説明します。 
-[ジェネリック コレクションの使用に適した状況](when-to-use-generic-collections.md) | ジェネリック コレクション型の使用について説明します。
-[コレクション内での比較と並べ替え](comparisons-and-sorts-within-collections.md) | コレクションでの等価比較と並べ替え比較の使用について説明します。
-[Sorted コレクション型](sorted-collection-types.md) | 並べ替えられたコレクションのパフォーマンスと特性について説明します。
-[Hashtable コレクション型と Dictionary コレクション型](hashtable-and-dictionary-collection-types.md) | ジェネリックと非ジェネリックのハッシュをベースにしたディクショナリ型の機能について説明します。
-[スレッドセーフなコレクション](threadsafe/index.md) | 複数のスレッドからの安全で効率的な同時アクセスをサポートする [System.Collections.Concurrent.BlockingCollection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.BlockingCollection-1) や [System.Collections.Concurrent.ConcurrentBag&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentBag-1) などのコレクション型について説明します。
-
-## <a name="reference"></a>参照
-
-[System.Array](https://docs.microsoft.com/dotnet/core/api/System.Array)
-
-[System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections)
-
-[System.Collections.Concurrent](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent)
-
-[System.Collections.Generic](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic)
-
-[System.Collections.Specialized](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized)
-
-[System.Linq](https://docs.microsoft.com/dotnet/core/api/System.Linq)
-  
-
+title: "コレクションとデータ構造体 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グループ化 (コレクションによるデータの)"
+  - "オブジェクト [.NET Framework], コレクションでのグループ化"
+  - "Array クラス, コレクションでのデータのグループ化"
+  - "スレッド処理 [.NET Framework], 安全性"
+  - "Collections クラス"
+  - "コレクション [.NET Framework]"
+ms.assetid: 60cc581f-1db5-445b-ba04-a173396bf872
+caps.latest.revision: 36
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 35
+---
+# コレクションとデータ構造体
+多くの場合、類似するデータはコレクションとして格納および操作すると、より効率的に処理できます。 使用することができます、 <xref:System.Array?displayProperty=fullName>クラスまたはクラスに、 <xref:System.Collections>、 <xref:System.Collections.Generic>、 <xref:System.Collections.Concurrent>System.Collections.Immutable の名前空間を追加するには、削除、および、個々 の要素またはコレクション内の要素の範囲を変更します。  
+  
+ 主要なコレクションの型として、ジェネリック コレクションと非ジェネリック コレクションの&2; つがあります。 ジェネリック コレクションは .NET Framework 2.0 で追加されたもので、コンパイル時にタイプ セーフなコレクションを提供します。 このため、通常、ジェネリック コレクションの方がパフォーマンスが高くなります。 ジェネリック コレクションは構築時に型パラメーターを受け取りますが、項目をコレクションに追加またはコレクションから削除するときに <xref:System.Object> 型との間でキャストする必要はありません。  また、ほとんどのジェネリック コレクションが [!INCLUDE[win8_appstore_long](../../../includes/win8-appstore-long-md.md)] アプリでサポートされています。 非ジェネリック コレクションの項目を格納する<xref:System.Object>キャストが必要で、ほとんどはサポートされていません[!INCLUDE[win8_appstore_long](../../../includes/win8-appstore-long-md.md)]アプリ開発します。 ただし、以前のコードに非ジェネリック コレクションが含まれている場合があります。  
+  
+ 以降で、 [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)]、内のコレクション、 <xref:System.Collections.Concurrent>名前空間は、複数のスレッドからコレクション項目にアクセスするための効率的なスレッド セーフな操作を提供します。 System.Collections.Immutable 名前空間の変更できないコレクション クラス ([NuGet パッケージ](https://www.nuget.org/packages/System.Collections.Immutable)) は、元のコレクションのコピーで操作が実行され、元のコレクションを変更できないために、本質的にスレッド セーフです。  
+  
+ [!INCLUDE[autoOutline](../Token/autoOutline_md.md)]  
+  
+<a name="BKMK_Commoncollectionfeatures"></a>   
+## <a name="common-collection-features"></a>一般的なコレクションの機能  
+ すべてのコレクションに、コレクション内の項目を追加、削除、または検索するためのメソッドが用意されています。 さらに、すべてのコレクションを直接または間接的に実装、 <xref:System.Collections.ICollection>インターフェイスまたは<xref:System.Collections.Generic.ICollection%601>インターフェイスは、これらの機能を共有します。  
+  
+-   **コレクションを列挙する機能**  
+  
+     .NET framework のコレクションを実装するか<xref:System.Collections.IEnumerable?displayProperty=fullName>または<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName>を反復収集を有効にします。 列挙子は、コレクション内の任意の要素への移動可能なポインターと考えることができます。 [Foreach で、](../Topic/foreach,%20in%20\(C%23%20Reference\).md)ステートメントおよび[ごとにしています.次のステートメントの](../Topic/For%20Each...Next%20Statement%20\(Visual%20Basic\).md)によって公開されている列挙子を使用して、 <xref:System.Collections.IEnumerable.GetEnumerator%2A>メソッドと非表示にする列挙子の操作の複雑さです。 さらに、すべてのコレクションを実装する<xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName>と見なされますが、*クエリ可能型*し、LINQ で照会できます。 LINQ クエリでは、データにアクセスするための共通パターンが提供されます。 通常、これらは、標準の `foreach` ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化の機能を利用できます。 さらに、LINQ クエリによってパフォーマンスを向上させることができます。 詳細については、次を参照してください。 [LINQ to Objects](../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-objects.md)、 [Parallel LINQ (PLINQ)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)と[LINQ クエリ (c#) の概要](../Topic/Introduction%20to%20LINQ%20Queries%20\(C%23\).md)します。  
+  
+-   **コレクションの内容を配列にコピーする機能**  
+  
+     すべてのコレクションを使用して、配列にコピーできます、 **CopyTo**メソッドです。 ただし、新しい配列内の要素の順序をベースに、列挙子が返す順序にします。 結果の配列は、常に下限がゼロの&1; 次元です。  
+  
+ また、多くのコレクション クラスに次の機能が含まれています。  
+  
+-   **容量とカウントのプロパティ**  
+  
+     コレクションの容量とは、そこに含むことのできる要素の数です。 コレクションのカウントとは、実際に含まれている要素の数です。 コレクションによっては、容量またはカウント、あるいはその両方を内部で処理する場合があります。  
+  
+     ほとんどのコレクションで、現在の容量に達すると自動的に容量が拡張されます。 メモリが再割り当てされ、要素は古いコレクションから新しいコレクションにコピーされます。 これにより、コレクションを使用するために必要なコードが削減されます。ただし、コレクションのパフォーマンスに悪影響を及ぼす可能性があります。 たとえば、<xref:System.Collections.Generic.List%601>場合は、<xref:System.Collections.Generic.List%601.Count%2A>がより小さい<xref:System.Collections.Generic.List%601.Capacity%2A>、o (1) 操作は、アイテムを追加します。 ここで n は o (n) 操作になりますアイテムを追加する場合は、容量は、新しい要素を格納するために必要がある、<xref:System.Collections.Generic.List%601.Count%2A>します。 複数の再割り当てによるパフォーマンスの低下を回避するには、初期容量をコレクションの見積もりサイズに設定しておくことが最善の方法です。  
+  
+     <xref:System.Collections.BitArray> は特殊なケースで、その容量はその長さと同じで、長さはそのカウントと同じです。  
+  
+-   **一貫した下限**  
+  
+     コレクションの下限とは、最初の要素のインデックスです。 <xref:System.Collections> 名前空間のすべてのインデックス付きコレクションの下限がゼロです。つまり、インデックスがゼロから始まります。 <xref:System.Array>下限は既定では、0 のインスタンスを作成するときに、別の下限を定義することができますが、**配列**クラスを使用して<xref:System.Array.CreateInstance%2A?displayProperty=fullName>します。  
+  
+-   **複数のスレッドからのアクセスの同期** (<xref:System.Collections> クラスのみ)。  
+  
+     非ジェネリック コレクション型で、 <xref:System.Collections>名前空間は、同期によるスレッド セーフが提供; を通じて公開される通常の<xref:System.Collections.ICollection.SyncRoot%2A>と<xref:System.Collections.ICollection.IsSynchronized%2A>メンバーです。 既定では、これらのコレクションはスレッド セーフではありません。 拡張性が高く効率的な、コレクションへのマルチスレッド アクセスが必要な場合は、<xref:System.Collections.Concurrent> 名前空間のいずれかのクラスを使用するか、変更できないコレクションを使用することを検討します。 詳しくは、「[スレッド セーフなコレクション](../../../docs/standard/collections/thread-safe/index.md)」を参照してください。  
+  
+<a name="BKMK_Choosingacollection"></a>   
+## <a name="choosing-a-collection"></a>コレクションの選択  
+ 通常は、ジェネリック コレクションを使用します。 次の表では、一般的なコレクションのシナリオとこれらのシナリオに使用できるコレクション クラスについて説明します。 ジェネリック コレクションに対する知識がない場合、このテーブルは、タスクに最適なジェネリック コレクションを選択するのに役立ちます。  
+  
+|||||  
+|-|-|-|-|  
+|やりたいこと|ジェネリック コレクションのオプション|非ジェネリック コレクションのオプション|スレッド セーフまたは変更できないコレクションのオプション|  
+|キーによるクイック検索用のキー/値のペアとして項目を保存する|<xref:System.Collections.Generic.Dictionary%602?displayProperty=fullName></TKey, TValue>|<xref:System.Collections.Hashtable><br /><br /> (キーのハッシュ コードに基づいて編成された、キーと値のペアのコレクション。)|<xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName>\</TKey, TValue><br /><br /> <xref:System.Collections.ObjectModel.ReadOnlyDictionary%602?displayProperty=fullName>\</TKey, TValue><br /><br /> [ImmutableDictionary (TKey, TValue) クラス](../Topic/ImmutableDictionary\(TKey,%20TValue\)%20Class.md)|  
+|インデックスで項目にアクセスする|<xref:System.Collections.Generic.List%601?displayProperty=fullName>|<xref:System.Array?displayProperty=fullName><br /><br /> <xref:System.Collections.ArrayList?displayProperty=fullName>|[ImmutableList(T) クラス](../Topic/ImmutableList\(T\)%20Class.md)<br /><br /> [ImmutableArray クラス](../Topic/ImmutableArray%20Class.md)|  
+|先入れ先出し (FIFO) で項目を使用する|<xref:System.Collections.Generic.Queue%601?displayProperty=fullName>|<xref:System.Collections.Queue?displayProperty=fullName>|<xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName><br /><br /> [ImmutableQueue(T) クラス](../Topic/ImmutableQueue\(T\)%20Class.md)|  
+|後入れ先出し (LIFO) でデータを使用する|<xref:System.Collections.Generic.Stack%601?displayProperty=fullName>|<xref:System.Collections.Stack?displayProperty=fullName>|<xref:System.Collections.Concurrent.ConcurrentStack%601?displayProperty=fullName><br /><br /> [ImmutableStack(T) クラス](../Topic/ImmutableStack\(T\)%20Class.md)|  
+|項目に順次アクセスする|<xref:System.Collections.Generic.LinkedList%601?displayProperty=fullName>|推奨しません|推奨しません|  
+|項目がコレクションから削除またはコレクションに追加されるときに通知を受け取る。 (実装<xref:System.ComponentModel.INotifyPropertyChanged>と<xref:System.Collections.Specialized.INotifyCollectionChanged?displayProperty=fullName>)|<xref:System.Collections.ObjectModel.ObservableCollection%601?displayProperty=fullName>|推奨しません|推奨しません|  
+|並べ替えられたコレクション|<xref:System.Collections.Generic.SortedList%602?displayProperty=fullName>\</TKey, TValue>|<xref:System.Collections.SortedList?displayProperty=fullName>|[ImmutableSortedDictionary (TKey, TValue) クラス](../Topic/ImmutableSortedDictionary\(TKey,%20TValue\)%20Class.md)<br /><br /> [ImmutableSortedSet(T) クラス](../Topic/ImmutableSortedSet\(T\)%20Class.md)|  
+|数学関数のセット|<xref:System.Collections.Generic.HashSet%601?displayProperty=fullName><br /><br /> <xref:System.Collections.Generic.SortedSet%601?displayProperty=fullName>|推奨しません|[ImmutableHashSet(T) クラス](../Topic/ImmutableHashSet\(T\)%20Class.md)<br /><br /> [ImmutableSortedSet(T) クラス](../Topic/ImmutableSortedSet\(T\)%20Class.md)|  
+  
+<a name="BKMK_RelatedTopics"></a>   
+## <a name="related-topics"></a>関連トピック  
+  
+|タイトル|説明|  
+|-----------|-----------------|  
+|[コレクション クラスの選択](../../../docs/standard/collections/selecting-a-collection-class.md)|さまざまなコレクションについて説明し、いずれかのシナリオを選択できるよう支援します。|  
+|[ 一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)|などの一般的に使用されるジェネリックと非ジェネリック コレクション型について説明<xref:System.Array?displayProperty=fullName>、 <xref:System.Collections.Generic.List%601?displayProperty=fullName>、および<xref:System.Collections.Generic.Dictionary%602?displayProperty=fullName>.\</TKey, TValue>|  
+|[ジェネリック コレクションを使用する状況](../../../docs/standard/collections/when-to-use-generic-collections.md)|ジェネリック コレクション型の使用について説明します。|  
+|[コレクション内での比較と並べ替え](../../../docs/standard/collections/comparisons-and-sorts-within-collections.md)|コレクションでの等価比較と並べ替え比較の使用について説明します。|  
+|[Sorted コレクション型](../../../docs/standard/collections/sorted-collection-types.md)|並べ替えられたコレクションのパフォーマンスと特性について説明します|  
+|[Hashtable コレクション型と Dictionary コレクション型](../../../docs/standard/collections/hashtable-and-dictionary-collection-types.md)|ジェネリックと非ジェネリックのハッシュをベースにしたディクショナリ型の機能について説明します。|  
+|[スレッドセーフなコレクション](../../../docs/standard/collections/thread-safe/index.md)|などのコレクション型について説明<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName>と<xref:System.Collections.Concurrent.ConcurrentBag%601?displayProperty=fullName>複数のスレッドから同時アクセスを安全で効率的なサポートします。|  
+|System.Collections.Immutable|変更できないコレクションを導入し、コレクション型へのリンクを提供します。|  
+  
+<a name="BKMK_Reference"></a>   
+## <a name="reference"></a>参照  
+ <xref:System.Array?displayProperty=fullName>  
+  
+ <xref:System.Collections?displayProperty=fullName>  
+  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>  
+  
+ <xref:System.Collections.Generic?displayProperty=fullName>  
+  
+ <xref:System.Collections.Specialized?displayProperty=fullName>  
+  
+ <xref:System.Linq?displayProperty=fullName>  
+  
+ System.Collections.Immutable
\ No newline at end of file
diff --git a/docs/standard/collections/selecting-a-collection-class.md b/docs/standard/collections/selecting-a-collection-class.md
index f81408b1456..5b3b52bc821 100644
--- a/docs/standard/collections/selecting-a-collection-class.md
+++ b/docs/standard/collections/selecting-a-collection-class.md
@@ -1,85 +1,90 @@
 ---
-title: "コレクション クラスの選択"
-description: "コレクション クラスの選択"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 0a60fca7-e082-48d4-9dda-30b0d3e67ec7
-translationtype: Human Translation
-ms.sourcegitcommit: 763433b00ae7d01cfa0c7fa250f51d23a95f6f15
-ms.openlocfilehash: d174d0cb910035340fb317521f3ad930d16853c2
-ms.lasthandoff: 01/18/2017
-
----
-
-# <a name="selecting-a-collection-class"></a>コレクション クラスの選択
-
-コレクション クラスは慎重に選択してください。 間違った型を使用すると、コレクションの使用が制限されることがあります。 タイプ セーフの強化や他の改善があるため、コレクションの汎用および同時実行バージョンをお勧めします。 一般に、.NET Framework バージョン 1.1 を特に対象としている場合を除いて、System.Collections 名前空間にある型は使用しないでください。 
-
-以下の質問を検討します。
-
-* 値が取得された後に要素が通常は破棄されるシーケンシャル リストが必要ですか。 
-
-    * 「はい」の場合、先入れ先出し (FIFO) の動作が必要であれば、[System.Collections.Generic.Queue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Queue-1) ジェネリック クラスの使用を検討してください。 後入れ先出し (LIFO) の動作が必要であれば、[System.Collections.Generic.Stack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Stack-1) ジェネリック クラスの使用を検討します。 複数のスレッドから安全にアクセスできるように、同時実行バージョンの [System.Collections.Concurrent.ConcurrentQueue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentQueue-1) と [System.Collections.Concurrent.ConcurrentStack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentStack-1) を使用します。
-    
-    * それ以外の場合は、その他のコレクションの使用を検討してください。
-    
-* FIFO や LIFO など特定の順序で要素にアクセスする必要がありますか。またはランダムにアクセスできますか。
-
-    * [System.Collections.Generic.Queue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Queue-1) または [System.Collections.Concurrent.ConcurrentQueue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentQueue-1) ジェネリック クラスは、FIFO アクセスを提供します。 詳細については、「[スレッド セーフなコレクションを使用する状況](threadsafe/when-to-use-a-thread-safe-collection.md)」をご覧ください。
-    
-    * [System.Collections.Generic.Stack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Stack-1) または [System.Collections.Concurrent.ConcurrentStack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentStack-1) ジェネリック クラスは、LIFO アクセスを提供します。 詳細については、「[スレッド セーフなコレクションを使用する状況](threadsafe/when-to-use-a-thread-safe-collection.md)」をご覧ください。
-    
-    * [System.Collections.Generic.LinkedList&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.LinkedList-1) ジェネリック クラスは、先頭から末尾または末尾から先頭へのシーケンシャル アクセスを可能にします。
-    
-* インデックスで各要素にアクセスする必要があるでしょうか。 
-
-    * [System.Collections.Specialized.StringCollection](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.StringCollection) クラス、および [System.Collections.Generic.List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) ジェネリック クラスは、要素の 0 から始まるインデックスによってその要素へのアクセスを提供します。 
-    
-    * [System.Collections.Specialized.ListDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.ListDictionary) および [System.Collections.Specialized.StringDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.StringDictionary) クラス、さらに [System.Collections.Generic.Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) および [System.Collections.Generic.SortedDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) ジェネリック クラスは、要素のキーによってその要素へのアクセスを提供します。
-    
-    * [System.Collections.Specialized.NameObjectCollectionBase](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.NameObjectCollectionBase) および [System.Collections.Specialized.NameValueCollection](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.NameValueCollection) クラス、さらに [System.Collections.ObjectModel.KeyedCollection&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) および [System.Collections.Generic.SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラスは、要素の 0 から始まるインデックスまたは要素のキーのいずれかによって、その要素へのアクセスを提供します。
-    
-* 各要素に含まれることになるのは、1 つの値、1 つのキーと 1 つの値の組み合わせ、または 1 つのキーと複数の値の組み合わせのどれですか。 
-
-    * 1 つの値: [System.Collections.Generic.IList&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IList-1) ジェネリック インターフェイスに基づくいずれかのコレクションを使用します。
-    
-    * 1 つのキーと 1 つの値: [System.Collections.Generic.IDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2) ジェネリック インターフェイスに基づくいずれかのコレクションを使用します。
-    
-    * 埋め込みのキーを持つ 1 つの値: [System.Collections.ObjectModel.KeyedCollection&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) ジェネリック クラスを使用します。
-    
-    * 複数の値を持つ 1 つのキー: [System.Collections.Specialized.NameValueCollection](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.NameValueCollection) クラスを使用します。
-    
-* 要素を入力されたときとは異なる方法で並べ替える必要がありますか。 
-
-    * [System.Collections.Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) クラスは、ハッシュ コードによってその要素を並べ替えます。
-    
-    * [System.Collections.Generic.SortedDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) および [System.Collections.Generic.SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラスは、[System.Collections.IComparer](https://docs.microsoft.com/dotnet/core/api/System.Collections.IComparer) インターフェイスと [System.Collections.Generic.IComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IComparer-1) ジェネリック インターフェイスの実装に基づき、キーによってその要素を並べ替えます。
-    
-    * [System.Collections.Generic.List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) ジェネリック クラスは、`IComparer<T>` ジェネリック インターフェイスの実装をパラメーターとして受け取る `Sort` メソッドを提供します。
-    
-* 文字列だけを受け入れるコレクションは必要ですか。 
-
-    * [StringCollection](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.StringCollection) ([System.Collections.IList](https://docs.microsoft.com/dotnet/core/api/System.Collections.IList) に基づく) および [StringDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized.StringDictionary) ([System.Collections.IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary) に基づく) は、[System.Collections.Specialized](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized) 名前空間にあります。 
-    
-    * さらに、ジェネリック型の引数に `String` クラスを指定して、[System.Collections.Generic](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic) 名前空間にある任意のジェネリック コレクション クラスを厳密に型指定された文字列コレクションとして使用できます。
-    
-## <a name="linq-to-objects"></a>LINQ to Objects
-
-LINQ to Objects を使用すると、開発者は、オブジェクト型で [System.Collections.IEnumerable](https://docs.microsoft.com/dotnet/core/api/System.Collections.IEnumerable) または [System.Collections.Generic.IEnumerable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEnumerable-1) を実装している場合に、LINQ クエリを使用してインメモリ オブジェクトにアクセスできます。 LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の foreach ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化の機能を備えています。 詳細については、「[統合言語クエリ (LINQ)](../../csharp/linq/index.md)」をご覧ください。
-
-## <a name="see-also"></a>関連項目
-
-[System.Collections](https://docs.microsoft.com/dotnet/core/api/System.Collections)
-
-[System.Collections.Specialized](https://docs.microsoft.com/dotnet/core/api/System.Collections.Specialized)
-
-[System.Collections.Generic](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic)
-
-[スレッドセーフなコレクション](threadsafe/index.md)
-
+title: "コレクション クラスの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], コレクション クラスの選択"
+  - "Collections クラス"
+  - "先入れ先出しのコレクション"
+  - "グループ化 (コレクションによるデータの), コレクション クラスの選択"
+  - "インデックス付きコレクション"
+  - "後入れ先出しのコレクション"
+ms.assetid: ba049f9a-ce87-4cc4-b319-3f75c8ddac8a
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# コレクション クラスの選択
+コレクション クラスは慎重に選択してください。  間違った型を使用すると、コレクションの使用が制限されることがあります。  一般に、.NET Framework バージョン 1.1 を特に対象としている場合を除いて、<xref:System.Collections> 名前空間にある型は使用しないでください。  タイプ セーフの強化や他の改善があるため、コレクションの汎用および同時実行バージョンをお勧めします。  
+  
+ 以下の質問を検討します。  
+  
+-   値が取得された後に要素が通常は破棄されるシーケンシャル リストが必要ですか。  
+  
+    -   そうである場合は、先入れ先出し \(FIFO\) の動作が必要であれば、<xref:System.Collections.Queue> クラスまたは <xref:System.Collections.Generic.Queue%601> ジェネリック クラスの使用を検討してください。  後入れ先出し \(LIFO\) の動作が必要であれば、<xref:System.Collections.Stack> クラスまたは <xref:System.Collections.Generic.Stack%601> ジェネリック クラスの使用を検討します。  複数のスレッドから安全にアクセスできるように、同時実行バージョンの <xref:System.Collections.Concurrent.ConcurrentQueue%601> と <xref:System.Collections.Concurrent.ConcurrentStack%601> を使用します。  
+  
+    -   それ以外の場合は、その他のコレクションの使用を検討してください。  
+  
+-   FIFO や LIFO など特定の順序で要素にアクセスする必要がありますか。またはランダムにアクセスできますか。  
+  
+    -   <xref:System.Collections.Queue> クラスおよび <xref:System.Collections.Generic.Queue%601> または <xref:System.Collections.Concurrent.ConcurrentQueue%601> ジェネリック クラスは、FIFO アクセスを提供します。  詳しくは、「[スレッド セーフなコレクションを使用する状況](../../../docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md)」を参照してください。  
+  
+    -   <xref:System.Collections.Stack> クラスおよび <xref:System.Collections.Generic.Stack%601> または <xref:System.Collections.Concurrent.ConcurrentStack%601> ジェネリック クラスは、LIFO アクセスを提供します。  詳しくは、「[スレッド セーフなコレクションを使用する状況](../../../docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md)」を参照してください。  
+  
+    -   <xref:System.Collections.Generic.LinkedList%601> ジェネリック クラスは、先頭から末尾または末尾から先頭への順次アクセスを可能にします。  
+  
+-   インデックスで各要素にアクセスする必要があるでしょうか。  
+  
+    -   <xref:System.Collections.ArrayList> と <xref:System.Collections.Specialized.StringCollection> クラス、および <xref:System.Collections.Generic.List%601> ジェネリック クラスは、要素の 0 から始まるインデックスによってその要素へのアクセスを提供します。  
+  
+    -   <xref:System.Collections.Hashtable>、<xref:System.Collections.SortedList>、<xref:System.Collections.Specialized.ListDictionary>、<xref:System.Collections.Specialized.StringDictionary> クラス、および <xref:System.Collections.Generic.Dictionary%602>、<xref:System.Collections.Generic.SortedDictionary%602> ジェネリック クラスは、要素のキーによってその要素へのアクセスを提供します。  
+  
+    -   <xref:System.Collections.Specialized.NameObjectCollectionBase> と <xref:System.Collections.Specialized.NameValueCollection> クラス、および <xref:System.Collections.ObjectModel.KeyedCollection%602> と <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスは、要素の 0 から始まるインデックスまたはキーのいずれかによって、その要素へのアクセスを提供します。  
+  
+-   各要素に含まれることになるのは、1 つの値、1 つのキーと 1 つの値の組み合わせ、または 1 つのキーと複数の値の組み合わせのどれですか。  
+  
+    -   1 つの値: <xref:System.Collections.IList> インターフェイスまたは <xref:System.Collections.Generic.IList%601> ジェネリック インターフェイスに基づくいずれかのコレクションを使用します。  
+  
+    -   1 つのキーと 1 つの値: <xref:System.Collections.IDictionary> インターフェイスまたは <xref:System.Collections.Generic.IDictionary%602> ジェネリック インターフェイスに基づくいずれかのコレクションを使用します。  
+  
+    -   埋め込みのキーを持つ 1 つの値: <xref:System.Collections.ObjectModel.KeyedCollection%602> ジェネリック クラスを使用します。  
+  
+    -   複数の値を持つ 1 つのキー: <xref:System.Collections.Specialized.NameValueCollection> クラスを使用します。  
+  
+-   要素を入力されたときとは異なる方法で並べ替える必要がありますか。  
+  
+    -   <xref:System.Collections.Hashtable> クラスは、ハッシュ コードによってその要素を並べ替えます。  
+  
+    -   <xref:System.Collections.SortedList> クラスおよび <xref:System.Collections.Generic.SortedDictionary%602> と <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスは、<xref:System.Collections.IComparer> インターフェイスおよび <xref:System.Collections.Generic.IComparer%601> ジェネリック インターフェイスの実装に基づいて、キーによってその要素を並べ替えます。  
+  
+    -   <xref:System.Collections.ArrayList> は、<xref:System.Collections.IComparer> 実装をパラメーターとして受け取る、<xref:System.Collections.ArrayList.Sort%2A> メソッドを提供します。  それに対応するジェネリックである <xref:System.Collections.Generic.List%601> ジェネリック クラスは、<xref:System.Collections.Generic.IComparer%601> ジェネリック インターフェイスの実装をパラメーターとして受け取る、<xref:System.Collections.Generic.List%601.Sort%2A> メソッドを提供します。  
+  
+-   高速な検索と情報の取得が必要ですか。  
+  
+    -   <xref:System.Collections.Specialized.ListDictionary> は、小規模なコレクション \(10 個以下のアイテム\) では <xref:System.Collections.Hashtable> より高速です。  <xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスは、<xref:System.Collections.Generic.SortedDictionary%602> ジェネリック クラスよりも高速の参照を提供します。  マルチスレッドの実装は <xref:System.Collections.Concurrent.ConcurrentDictionary%602> です。  <xref:System.Collections.Concurrent.ConcurrentBag%601> は、順序指定されていないデータのために、高速なマルチスレッドの挿入を提供します。  両方の種類のマルチスレッドについて詳しくは、「[スレッド セーフなコレクションを使用する状況](../../../docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md)」を参照してください。  
+  
+-   文字列だけを受け入れるコレクションは必要ですか。  
+  
+    -   <xref:System.Collections.Specialized.StringCollection> \(<xref:System.Collections.IList> に基づく\) および <xref:System.Collections.Specialized.StringDictionary> \(<xref:System.Collections.IDictionary> に基づく\) は、<xref:System.Collections.Specialized> 名前空間にあります。  
+  
+    -   さらに、ジェネリック型の引数として <xref:System.String> クラスを指定することにより、<xref:System.Collections.Generic> 名前空間にある任意のジェネリック コレクション クラスを厳密に型指定された文字列コレクションとして使用できます。  
+  
+## LINQ to Objects および PLINQ  
+ LINQ to Objects により、開発者は、オブジェクト型で <xref:System.Collections.IEnumerable> または <xref:System.Collections.Generic.IEnumerable%601> を実装している限り、LINQ クエリを使用してインメモリ オブジェクトにアクセスできます。  LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の `foreach` ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化機能を備えています。  詳細については、「[LINQ to Objects](../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-objects.md)」を参照してください。  
+  
+ PLINQ は、マルチコア コンピューターをより効率的に使用することにより、多くのシナリオでより高速にクエリを実行できる LINQ to Objects の並列実装を提供します。  詳細については、「[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Collections>   
+ <xref:System.Collections.Specialized>   
+ <xref:System.Collections.Generic>   
+ [スレッド セーフなコレクション](../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/sorted-collection-types.md b/docs/standard/collections/sorted-collection-types.md
index ad7a474c164..fc11f4c3ee1 100644
--- a/docs/standard/collections/sorted-collection-types.md
+++ b/docs/standard/collections/sorted-collection-types.md
@@ -1,60 +1,59 @@
 ---
-title: "Sorted コレクション型"
-description: "Sorted コレクション型"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: bdc9c13e-e56a-433b-a293-c92364f6e9cb
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 28d5024f759b3a7474aef1fa344d39f9933b6322
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="sorted-collection-types"></a>Sorted コレクション型  
- 
- [System.Collections.SortedList](https://docs.microsoft.com/dotnet/core/api/System.Collections.SortedList) クラス、[System.Collections.Generic.SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラス、および [System.Collections.Generic.SortedDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) ジェネリック クラスは、[IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary) インターフェイスを実装する点において [Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) クラスと [Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) ジェネリック クラスに似ていますが、キーによる並べ替え順序で自身の要素を維持し、ハッシュ テーブルの O(1) 挿入と取得の特性を備えていません。 これら&3; つのクラスには、次のような共通の特徴があります。  
-
- *   3 つのすべてのクラスは、[System.Collections.IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary) インターフェイスを実装します。 2 つのジェネリック クラスは、[System.Collections.Generic.IDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2) ジェネリック インターフェイスも実装します。  
- 
- *   各要素は、列挙で使用できるようにキーと値のペアになっています。   
-  
-> [!NOTE]  
-> [SortedList](https://docs.microsoft.com/dotnet/core/api/System.Collections.SortedList) 非ジェネリック クラスは列挙されると [DictionaryEntry](https://docs.microsoft.com/dotnet/core/api/System.Collections.DictionaryEntry) オブジェクトを返しますが、2 つのジェネリック型のクラスは [KeyValuePair&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.KeyValuePair-2) オブジェクトを返します。  
-   
-*   要素の並べ替えは、[System.Collections.IComparer](https://docs.microsoft.com/dotnet/core/api/System.Collections.IComparer) 実装 (非ジェネリック クラス `SortedList` の場合) または [System.Collections.Generic.IComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IComparer-1) 実装 (2 つのジェネリック クラスの場合) に基づいて実行されます。  
-   
- *   各クラスが提供するプロパティは、キーのみまたは値のみを含むコレクションを返します。  
-   
-次の表に、2 つの並べ替えられたリスト クラスと [SortedDictionary<TKey, TValue>](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) クラスの違いをいくつか示します。  
-   
- `SortedList`非ジェネリック クラスと `SortedList<TKey, TValue>` ジェネリック クラス | `SortedDictionary<TKey, TValue>` ジェネリック クラス  
- --------------------------------------------------------------------------------- | ------------------------------  
- キーと値を返すプロパティにはインデックスが付けられるため、インデックスを使用して効率的に取得できます。 | インデックスを使用して取得することはできません。  
- 取得は O(log n) です。 | 取得は O(log n) です。  
- 挿入と削除は一般に O(n) ですが、既に並べ替えられているデータの挿入は O(1) であるため、各要素はリストの最後に追加されます。 (これは、サイズの変更が不要であることを前提としています。) | 挿入と削除は O(log n) です。  
- 使用するメモリは `SortedDictionary<TKey, TValue>` より少なくなります。 | `SortedList` 非ジェネリック クラスと `SortedList<TKey, TValue>` ジェネリック クラスより多くのメモリを使用します。  
-  
- 並べ替えられたリストや辞書に複数のスレッドから同時にアクセスできる必要がある場合、[ConcurrentDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2) から派生するクラスに並べ替えロジックを追加できます。  
-  
- > [!NOTE]  
- > 独自のキーを含む値 (従業員 ID 番号を含む従業員レコードなど) では、[KeyedCollection&lt;TKey, TItem&gt;]() ジェネリック クラスから派生することによってリストの特性と辞書の特性を合わせ持つキー付きのコレクションを作成できます。  
-   
- [SortedSet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedSet-1) クラスは、挿入、削除、および検索の操作後に並べ替えられた順序でデータを保持する自己平衡ツリーを提供します。 このクラスと [HashSet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.HashSet-1) クラスは、[ISet&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.ISet-1) インターフェイスを実装します。  
-   
-## <a name="see-also"></a>関連項目  
-  
-[System.Collections.IDictionary](https://docs.microsoft.com/dotnet/core/api/System.Collections.IDictionary)  
-   
-[System.Collections.Generic.IDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IDictionary-2)  
-   
-[ConcurrentDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2)  
- 
-[一般的に使用されるコレクション型](commonly-used-collection-types.md) 
-
+title: "Sorted コレクション型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], SortedList コレクション型"
+  - "グループ化 (コレクションによるデータの), SortedList コレクション型"
+  - "SortedDictionary コレクション型"
+  - "SortedList クラス, グループ化 (コレクションによるデータの)"
+  - "SortedList コレクション型"
+ms.assetid: 3db965b2-36a6-4b12-b76e-7f074ff7275a
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Sorted コレクション型
+<xref:System.Collections.SortedList?displayProperty=fullName> クラス、<xref:System.Collections.Generic.SortedList%602?displayProperty=fullName> ジェネリック クラス、および <xref:System.Collections.Generic.SortedDictionary%602?displayProperty=fullName> ジェネリック クラスは、<xref:System.Collections.IDictionary> インターフェイスを実装する点において <xref:System.Collections.Hashtable> クラスと <xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスに似ていますが、キーによる並べ替え順序で自身の要素を維持し、ハッシュ テーブルの O\(1\) 挿入と取得の特性はありません。  この 3 つのクラスには、次のような共通の特徴があります。  
+  
+-   3 つのすべてのクラスは、<xref:System.Collections.IDictionary?displayProperty=fullName> インターフェイスを実装します。  2 つのジェネリック クラスは、<xref:System.Collections.Generic.IDictionary%602?displayProperty=fullName> ジェネリック インターフェイスも実装します。  
+  
+-   各要素は、列挙で使用できるようにキーと値の組み合わせになっています。  
+  
+    > [!NOTE]
+    >  <xref:System.Collections.SortedList> 非ジェネリック クラスは列挙されると <xref:System.Collections.DictionaryEntry> オブジェクトを返しますが、2 つのジェネリック型のクラスは <xref:System.Collections.Generic.KeyValuePair%602> オブジェクトを返します。  
+  
+-   要素は <xref:System.Collections.IComparer?displayProperty=fullName> の実装 \(非ジェネリック クラスの <xref:System.Collections.SortedList>\) または <xref:System.Collections.Generic.IComparer%601?displayProperty=fullName> 実装 \(2 つのジェネリック クラス\) に基づいて並べ替えられます。  
+  
+-   各クラスは、キーのみまたは値のみを含むコレクションを返すプロパティを提供します。  
+  
+ 次の表に、2 つの並べ替えリスト クラスと <xref:System.Collections.Generic.SortedDictionary%602> クラスの違いを示します。  
+  
+|<xref:System.Collections.SortedList> 非ジェネリック クラスと <xref:System.Collections.Generic.SortedList%602> ジェネリック クラス|<xref:System.Collections.Generic.SortedDictionary%602> ジェネリック クラス|  
+|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|キーと値を返すプロパティにはインデックスが付けられるため、インデックスを使用して効率的に取得できます。|インデックスを使用して取得することはできません。|  
+|取得は O\(log `n`\) です。|取得は O\(log `n`\) です。|  
+|挿入と削除は一般に O\(`n`\) ですが、既に並べ替えられているデータの挿入は O\(1\) のため、各要素はリストの最後に追加されます。これは、サイズを変更する必要がないことを前提にしています。|挿入と削除は O\(log `n`\) です。|  
+|<xref:System.Collections.Generic.SortedDictionary%602> より使用するメモリが少なくなります。|<xref:System.Collections.SortedList> 非ジェネリック クラスと <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスより多くのメモリを使用します。|  
+  
+ 複数のスレッドから同時にアクセスできる必要がある並べ替えリストまたは辞書の場合、<xref:System.Collections.Concurrent.ConcurrentDictionary%602> から派生するクラスに並べ替えロジックを追加できます。  
+  
+> [!NOTE]
+>  対応するキーを含む値 \(従業員 ID 番号を含む従業員レコードなど\) に対しては、<xref:System.Collections.ObjectModel.KeyedCollection%602> ジェネリック クラスから派生することによってリストの特性と辞書の特性を合わせ持つキー付きのコレクションを作成できます。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、<xref:System.Collections.Generic.SortedSet%601> クラスは、データを挿入、削除、および検索した後にデータの並べ替え順序を保持する自動調整ツリーを提供します。  このクラスおよび <xref:System.Collections.Generic.HashSet%601> クラスは、<xref:System.Collections.Generic.ISet%601> インターフェイスを実装します。  
+  
+## 参照  
+ <xref:System.Collections.IDictionary?displayProperty=fullName>   
+ <xref:System.Collections.Generic.IDictionary%602?displayProperty=fullName>   
+ <xref:System.Collections.Concurrent.ConcurrentDictionary%602>   
+ [一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/blockingcollection-overview.md b/docs/standard/collections/thread-safe/blockingcollection-overview.md
new file mode 100644
index 00000000000..d8e7b267718
--- /dev/null
+++ b/docs/standard/collections/thread-safe/blockingcollection-overview.md
@@ -0,0 +1,87 @@
+---
+title: "BlockingCollection の概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BlockingCollection、概要"
+ms.assetid: 987ea3d7-0ad5-4238-8b64-331ce4eb3f0b
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# BlockingCollection の概要
+<xref:System.Collections.Concurrent.BlockingCollection%601> は、次のような機能を提供するスレッド セーフなコレクション クラスです。  
+  
+-   プロデューサー\/コンシューマー パターンの実装。  
+  
+-   複数のスレッドからの項目の同時追加と同時取得。  
+  
+-   最大容量 \(オプション\)。  
+  
+-   コレクションが空またはいっぱいになったときにブロックする挿入操作と削除操作。  
+  
+-   ブロックせずに実行されるか、指定された時間が経過するまでブロックする、挿入および削除の "試行" 操作。  
+  
+-   <xref:System.Collections.Concurrent.IProducerConsumerCollection%601> を実装する任意のコレクション型のカプセル化。  
+  
+-   キャンセル トークンを使用したキャンセル。  
+  
+-   `foreach` \(Visual Basic では `For Each`\) を使用した 2 種類の列挙。  
+  
+    1.  読み取り専用の列挙。  
+  
+    2.  列挙された項目を削除する列挙。  
+  
+## 境界とブロッキングのサポート  
+ <xref:System.Collections.Concurrent.BlockingCollection%601> は境界とブロッキングをサポートします。  境界は、コレクションの最大容量を設定できることを意味します。  境界を使用すると、メモリ内のコレクションの最大サイズを制御し、producer スレッドが consumer スレッドよりも先に進行しすぎるのを防ぐことができます。これは、特定のシナリオで重要になります。  
+  
+ コレクションには、複数のスレッドやタスクが同時に項目を追加できます。コレクションが指定された最大容量に達すると、producer スレッドは項目が削除されるまでブロックします。  複数の cosumer が同時に項目を削除できます。コレクションが空になった場合、consumer スレッドは、producer が項目を追加するまでブロックします。  producer スレッドでは、それ以上項目が追加されないことを示すために、<xref:System.Collections.Concurrent.BlockingCollection%601.CompleteAdding%2A> を呼び出すことができます。  consumer では、<xref:System.Collections.Concurrent.BlockingCollection%601.IsCompleted%2A> プロパティを監視して、コレクションが空になったときや、それ以上の項目は追加されないことになったときを把握できます。  次の例は、容量の上限が 100 に設定された単純な BlockingCollection を示しています。  いくつかの外部条件が true である間、producer タスクはコレクションに項目を追加し、<xref:System.Collections.Concurrent.BlockingCollection%601.CompleteAdding%2A> を呼び出します。  consumer タスクは、<xref:System.Collections.Concurrent.BlockingCollection%601.IsCompleted%2A> プロパティが true になるまで項目を取得します。  
+  
+ [!code-csharp[CDS_BlockingCollection#04](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/blockingcollection.cs#04)]
+ [!code-vb[CDS_BlockingCollection#04](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/introsnippetsbc.vb#04)]  
+  
+ コード例全体については、「[方法: BlockingCollection の項目を個別に追加および取得する](../../../../docs/standard/collections/thread-safe/how-to-add-and-take-items.md)」を参照してください。  
+  
+## 時間制限付きのブロッキング操作  
+ 境界のあるコレクションにおける時間制限付きの <xref:System.Collections.Concurrent.BlockingCollection%601.TryAdd%2A> 操作および <xref:System.Collections.Concurrent.BlockingCollection%601.TryTake%2A> 操作では、メソッドは項目を追加または取得しようと試みます。  項目を使用できる場合、その項目は参照渡しで渡された変数に格納され、メソッドは true を返します。  指定されたタイムアウト期間を経過しても項目が取得されない場合、メソッドは false を返します。  その後、再びコレクションへのアクセスを試みる前に、他の必要な処理をスレッドで自由に実行できます。  時間制限付きのブロッキング アクセスの例については、「[方法: BlockingCollection の項目を個別に追加および取得する](../../../../docs/standard/collections/thread-safe/how-to-add-and-take-items.md)」の 2 番目の例を参照してください。  
+  
+## 追加操作と取得操作の取り消し  
+ 追加操作と取得操作は、通常、ループ内で実行されます。  <xref:System.Collections.Concurrent.BlockingCollection%601.TryAdd%2A> メソッドまたは <xref:System.Collections.Concurrent.BlockingCollection%601.TryTake%2A> メソッドに <xref:System.Threading.CancellationToken> を渡し、各イテレーションでトークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティの値を確認するようにすると、ループを取り消すことができます。  値が true である場合は、キャンセル要求に応答するかどうかを決定できます。応答するには、リソースをクリーンアップし、ループを終了します。  次の例は、キャンセル トークンを受け取る <xref:System.Collections.Concurrent.BlockingCollection%601.TryAdd%2A> のオーバーロードと、それを使用するコードを示しています。  
+  
+ [!code-csharp[CDS_BlockingCollection#05](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/blockingcollection.cs#05)]
+ [!code-vb[CDS_BlockingCollection#05](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/introsnippetsbc.vb#05)]  
+  
+ キャンセルのサポートを追加する方法の例については、「[方法: BlockingCollection の項目を個別に追加および取得する](../../../../docs/standard/collections/thread-safe/how-to-add-and-take-items.md)」の 2 番目の例を参照してください。  
+  
+## コレクション型の指定  
+ <xref:System.Collections.Concurrent.BlockingCollection%601> の作成時には、容量の上限だけでなく、使用するコレクションの型も指定できます。  たとえば、先入れ先出し方式 \(FIFO\) の動作には <xref:System.Collections.Concurrent.ConcurrentQueue%601> を、後入れ先出し方式 \(LIFO\) の動作には <xref:System.Collections.Concurrent.ConcurrentStack%601> を指定できます。  <xref:System.Collections.Concurrent.IProducerConsumerCollection%601> インターフェイスを実装する任意のコレクション クラスを使用できます。  <xref:System.Collections.Concurrent.BlockingCollection%601> の既定のコレクション型は <xref:System.Collections.Concurrent.ConcurrentQueue%601> です。  1000 の容量があり、<xref:System.Collections.Concurrent.ConcurrentBag%601>を使用して次のコード例は文字列の <xref:System.Collections.Concurrent.BlockingCollection%601> を作成する方法の設定:  
+  
+```vb  
+Dim bc = New BlockingCollection(Of String)(New ConcurrentBag(Of String()), 1000)  
+```  
+  
+```csharp  
+BlockingCollection<string> bc = new BlockingCollection<string>(new ConcurrentBag<string>(), 1000 );  
+```  
+  
+ 詳細については、「[方法: 境界ブロッキング機能をコレクションに追加する](../../../../docs/standard/collections/thread-safe/how-to-add-bounding-and-blocking.md)」を参照してください。  
+  
+## IEnumerable のサポート  
+ <xref:System.Collections.Concurrent.BlockingCollection%601> は、<xref:System.Collections.Concurrent.BlockingCollection%601.GetConsumingEnumerable%2A> メソッドを提供します。これにより、consumer は `foreach` \([!INCLUDE[vbprvb](../../../../includes/vbprvb-md.md)] では `For Each`\) を使用して、コレクションが完成するまで \(コレクションが空になり、それ以上項目が追加されなくなるまで\) 項目を削除できます。  詳細については、「[方法: ForEach を使用して BlockingCollection 内の項目を削除する](../../../../docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md)」を参照してください。  
+  
+## 多数の BlockingCollection を 1 つとして使用  
+ consumer が複数のコレクションから同時に項目を取得する必要のあるシナリオでは、<xref:System.Collections.Concurrent.BlockingCollection%601> の配列を作成し、<xref:System.Collections.Concurrent.BlockingCollection%601.TakeFromAny%2A> や <xref:System.Collections.Concurrent.BlockingCollection%601.AddToAny%2A> などの静的メソッドを使用できます。これらのメソッドでは、配列内の任意のコレクションを対象に追加または取得の操作を実行できます。  いずれかのコレクションがブロックしている場合、メソッドはすぐに別のコレクションを試します。これは、操作を実行できるコレクションが見つかるまで続行されます。  詳細については、「[方法: パイプラインでブロッキング コレクションの配列を使用する](../../../../docs/standard/collections/thread-safe/how-to-use-arrays-of-blockingcollections.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [コレクションとデータ構造体](../../../../docs/standard/collections/index.md)   
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-add-and-remove-items.md b/docs/standard/collections/thread-safe/how-to-add-and-remove-items.md
new file mode 100644
index 00000000000..a090215e5d5
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-add-and-remove-items.md
@@ -0,0 +1,54 @@
+---
+title: "方法: ConcurrentDictionary の項目を追加および削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、同時実行ディクショナリ"
+ms.assetid: 81b64b95-13f7-4532-9249-ab532f629598
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法: ConcurrentDictionary の項目を追加および削除する
+この例では、<xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName> の項目を追加、取得、更新、および削除する方法を示します。  このコレクション クラスはスレッド セーフな実装です。  複数のスレッドが要素に同時にアクセスしようとする可能性がある場合は、このクラスを使用することをお勧めします。  
+  
+ <xref:System.Collections.Concurrent.ConcurrentDictionary%602> には、コードでデータの追加または削除を試行する前に、まずキーが存在するかどうかをチェックする必要がなくなる便利なメソッドがいくつか用意されています。  これらの便利なメソッドとそのメソッドを使用する状況を次の表に示します。  
+  
+|方法|使用する状況|  
+|--------|------------|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602.AddOrUpdate%2A>|指定したキーの新しい値を追加する。キーが既に存在する場合は、その値を置き換える。|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A>|指定したキーの既存の値を取得する。キーが存在しない場合は、キーと値のペアを指定する。|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602.TryAdd%2A>, <xref:System.Collections.Concurrent.ConcurrentDictionary%602.TryGetValue%2A> , <xref:System.Collections.Concurrent.ConcurrentDictionary%602.TryUpdate%2A> , <xref:System.Collections.Concurrent.ConcurrentDictionary%602.TryRemove%2A>|キーと値のペアを追加、取得、更新、または削除する。キーが既に存在する場合、または他の何らかの理由で試行が失敗した場合は、代わりの操作を実行する。|  
+  
+## 使用例  
+ 次の例では、2 つの <xref:System.Threading.Tasks.Task> インスタンスを使用していくつかの要素を <xref:System.Collections.Concurrent.ConcurrentDictionary%602> に同時に追加し、すべての内容を出力して要素が正常に追加されたことを示します。  この例では、<xref:System.Collections.Concurrent.ConcurrentDictionary%602.AddOrUpdate%2A>、<xref:System.Collections.Generic.Dictionary%602.TryGetValue%2A>とコレクションの項目を追加、更新したり、取得するために <xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A> のメソッドを使用する方法を示します。  
+  
+ [!code-csharp[CDS#16](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds/cs/cds_dictionaryhowto.cs#16)]
+ [!code-vb[CDS#16](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds/vb/cds_concdict.vb#16)]  
+  
+ <xref:System.Collections.Concurrent.ConcurrentDictionary%602> は、マルチスレッドのシナリオ用に設計されています。  コレクションの項目を追加または削除するためにコードでロックを使用する必要はありません。  ただし、あるスレッドが値を取得し、別のスレッドが同じキーに新しい値を指定してコレクションをすぐに更新できます。  
+  
+ また、<xref:System.Collections.Concurrent.ConcurrentDictionary%602> のメソッドはすべてスレッド セーフですが、すべてのメソッドが分割不可能というわけではありません。具体的には、<xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A> と <xref:System.Collections.Concurrent.ConcurrentDictionary%602.AddOrUpdate%2A> は分割できます。  それらのメソッドに渡されるユーザー デリゲートは、ディクショナリの内部ロックの外で呼び出されます \(不明なコードによってすべてのスレッドがブロックされるのを防止するためです\)。そのため、次の一連のイベントが発生する可能性があります。  
+  
+ 1\) threadA が <xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A> を呼び出します。項目が見つからないため、valueFactory デリゲートを呼び出して、追加する新しい項目を作成します。  
+  
+ 2\) 同時に threadB も <xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A> を呼び出します。valueFactory デリゲートが呼び出され、threadA よりも先に内部ロックに到達するため、新しいキーと値のペアがディクショナリに追加されます。  
+  
+ 3\) threadA のユーザー デリゲートが完了し、スレッドがロックに到達しますが、この時点で既に項目は存在しています。  
+  
+ 4\) threadA は "Get" を実行し、threadB で先に作成されたデータを返します。  
+  
+ したがって、<xref:System.Collections.Concurrent.ConcurrentDictionary%602.GetOrAdd%2A> から返されるデータが、スレッドの valueFactory によって作成されたデータと同じになるとは限りません。  <xref:System.Collections.Concurrent.ConcurrentDictionary%602.AddOrUpdate%2A> を呼び出す場合にも、これと同様の一連のイベントが発生する可能性があります。  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-add-and-take-items.md b/docs/standard/collections/thread-safe/how-to-add-and-take-items.md
new file mode 100644
index 00000000000..1482f9cddbe
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-add-and-take-items.md
@@ -0,0 +1,40 @@
+---
+title: "方法: BlockingCollection の項目を個別に追加および取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、ブロッキング ディクショナリ"
+ms.assetid: 38f2f3d8-15e5-4bf4-9c83-2b5b6f22bad1
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法: BlockingCollection の項目を個別に追加および取得する
+この例では、ブロッキングと非ブロッキングの 2 つの方法で <xref:System.Collections.Concurrent.BlockingCollection%601> の項目を追加、削除する方法を示します。<xref:System.Collections.Concurrent.BlockingCollection%601> の詳細については、「[BlockingCollection の概要](../../../../docs/standard/collections/thread-safe/blockingcollection-overview.md)」を参照してください。  
+  
+ 空になって追加する要素がなくなるまで <xref:System.Collections.Concurrent.BlockingCollection%601> を列挙する方法の例については、「[方法: ForEach を使用して BlockingCollection 内の項目を削除する](../../../../docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md)」を参照してください。  
+  
+## 使用例  
+ この最初の例では、コレクションが一時的に空 \(取得時\) または最大容量 \(追加時\) になるか、指定されたタイムアウト期間が経過したときに、操作をブロックするように、項目を追加および取得する方法を示します。 最大容量のブロックは、BlockingCollection が、コンストラクターで指定された最大容量で作成された場合にのみ有効になることに注意してください。  
+  
+ [!code-csharp[CDS_BlockingCollection#01](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/example01.cs#01)]
+ [!code-vb[CDS_BlockingCollection#01](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/simpleblocking.vb#01)]  
+  
+## 使用例  
+ この 2 番目の例では、操作をブロックしないように、項目を追加および取得する方法を示します。 項目が存在しない場合、サイズ制限のあるコレクションの最大容量に達した場合、またはタイムアウト期間が経過した場合、<xref:System.Collections.Concurrent.BlockingCollection%601.TryAdd%2A> または <xref:System.Collections.Concurrent.BlockingCollection%601.TryTake%2A> 操作は false を返します。 これによりスレッドはしばらくの間、他の何らかの有益な処理を行い、後からもう一度新しいアイテムを取得するか、以前に追加できなかった項目を追加しようとします。 このプログラムはまた、<xref:System.Collections.Concurrent.BlockingCollection%601> へのアクセス時にキャンセルを実装する方法も示しています。  
+  
+ [!code-csharp[CDS_BlockingCollection#02](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/example02.cs#02)]
+ [!code-vb[CDS_BlockingCollection#02](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/nonblockingbc.vb#02)]  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [BlockingCollection の概要](../../../../docs/standard/collections/thread-safe/blockingcollection-overview.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-add-bounding-and-blocking.md b/docs/standard/collections/thread-safe/how-to-add-bounding-and-blocking.md
new file mode 100644
index 00000000000..0d97de20e81
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-add-bounding-and-blocking.md
@@ -0,0 +1,36 @@
+---
+title: "方法: 境界ブロッキング機能をコレクションに追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、カスタム ブロッキング コレクション"
+ms.assetid: 4c2492de-3876-4873-b5a1-000bb404d770
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法: 境界ブロッキング機能をコレクションに追加する
+この例では、境界ブロッキング機能をカスタム コレクション クラスに追加する方法を示します。この機能を追加するには、<xref:System.Collections.Concurrent.IProducerConsumerCollection%601?displayProperty=fullName> インターフェイスをそのクラスで実装し、クラス インスタンスを <xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> の内部ストレージ機構として使用します。  境界ブロッキングの詳細については、「[BlockingCollection の概要](../../../../docs/standard/collections/thread-safe/blockingcollection-overview.md)」を参照してください。  
+  
+## 使用例  
+ カスタム コレクション クラスは、優先順位が <xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName> オブジェクトの配列として表される基本の優先順位キューです。  各キュー内で追加の順序付けは実行されません。  
+  
+ クライアント コードで、3 つのタスクが開始されます。  最初のタスクは、キーボード入力をポーリングして、実行時にいつでも取り消すことができるようにします。  2 番目のタスクは producer スレッドです。新しい項目をブロッキング コレクションに追加し、乱数値に基づいて各項目の優先順位を指定します。  3 番目のタスクは、使用できるようになった項目をコレクションから削除します。  
+  
+ いずれかのスレッドの実行速度を他のスレッドよりも速くすることで、アプリケーションの動作を調整できます。  プロデューサーの実行速度が速い場合は、コンストラクターで指定された項目数が既に含まれているとブロッキング コレクションで項目が追加されなくなるので、境界機能になります。  コンシューマーの実行速度が速い場合は、コンシューマーが新しい項目の追加を待機するので、ブロッキング機能になります。  
+  
+ [!code-csharp[CDS_BlockingCollection#06](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/prodcon.cs#06)]  
+  
+ 既定では、<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> のストレージは <xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName> になります。  
+  
+## 参照  
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-create-an-object-pool.md b/docs/standard/collections/thread-safe/how-to-create-an-object-pool.md
new file mode 100644
index 00000000000..19b76f7427c
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-create-an-object-pool.md
@@ -0,0 +1,31 @@
+---
+title: "方法: ConcurrentBag を使用してオブジェクト プールを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "オブジェクト プール、.NET Framework での"
+ms.assetid: 0480e7ff-b6f9-480e-a889-2ed4264d8372
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 方法: ConcurrentBag を使用してオブジェクト プールを作成する
+この例では、同時実行バッグを使用してオブジェクト プールを実装する方法を示します。  オブジェクト プールを実装すると、クラスの複数のインスタンスが必要で、クラスの作成時または破棄時の負荷が高い場合に、アプリケーションのパフォーマンスを向上できます。  クライアント プログラムによって新しいオブジェクトが要求されると、オブジェクト プールはまず、既に作成されてプールに返されているオブジェクトを提供しようとします。  オブジェクトが存在しない場合にのみ、新しいオブジェクトが作成されます。  
+  
+ <xref:System.Collections.Concurrent.ConcurrentBag%601> は高速な挿入と削除をサポートするので、オブジェクトの格納に使用されます。特に、同じスレッドが項目の追加と削除の両方を行っている場合に役立ちます。  この例は、<xref:System.Collections.Concurrent.ConcurrentQueue%601> および <xref:System.Collections.Concurrent.ConcurrentStack%601> と同様に、バッグ データ構造によって実装される <xref:System.Collections.Concurrent.IProducerConsumerCollection%601> を中心に構築してさらに強化することができます。  
+  
+## 使用例  
+ [!code-csharp[CDS#04](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds/cs/objectpool.cs#04)]
+ [!code-vb[CDS#04](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds/vb/objectpool04.vb#04)]  
+  
+## 参照  
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-use-arrays-of-blockingcollections.md b/docs/standard/collections/thread-safe/how-to-use-arrays-of-blockingcollections.md
new file mode 100644
index 00000000000..f8eebb7db6a
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-use-arrays-of-blockingcollections.md
@@ -0,0 +1,32 @@
+---
+title: "方法: パイプラインでブロッキング コレクションの配列を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、ブロッキング コレクション (パイプラインの)"
+ms.assetid: a39c7ec3-3ad7-4f4d-8fe4-b3e9dbabe2ed
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: パイプラインでブロッキング コレクションの配列を使用する
+次の例は、<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> オブジェクトの配列を <xref:System.Collections.Concurrent.BlockingCollection%601.TryAddToAny%2A> や <xref:System.Collections.Concurrent.BlockingCollection%601.TryTakeFromAny%2A> などの静的メソッドと共に使用して、コンポーネント間の高速で柔軟性のあるデータ転送を実装する方法を示しています。  
+  
+## 使用例  
+ 次の例は、各オブジェクトが入力コレクションからデータを同時に取得して変換し、出力コレクションに渡す基本的なパイプラインの実装を示しています。  
+  
+ [!code-csharp[CDS_BlockingCollection#07](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/example07.cs#07)]
+ [!code-vb[CDS_BlockingCollection#07](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/bcpipeline.vb#07)]  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md b/docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md
new file mode 100644
index 00000000000..b9d2e7f4f57
--- /dev/null
+++ b/docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md
@@ -0,0 +1,38 @@
+---
+title: "方法: ForEach を使用して BlockingCollection 内の項目を削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、方法 (ブロッキング コレクションを列挙する)"
+ms.assetid: 2096103c-22f7-420d-b631-f102bc33a6dd
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法: ForEach を使用して BlockingCollection 内の項目を削除する
+<xref:System.Collections.Concurrent.BlockingCollection%601.Take%2A> メソッドおよび <xref:System.Collections.Concurrent.BlockingCollection%601.TryTake%2A> メソッドを使用して <xref:System.Collections.Concurrent.BlockingCollection%601> からアイテムを取得するだけでなく、[foreach](../Topic/foreach,%20in%20\(C%23%20Reference\).md) \(Visual Basic では [For Each](../Topic/For%20Each...Next%20Statement%20\(Visual%20Basic\).md)\) を使用して、追加が完了してコレクションが空になるまで、アイテムを削除することもできます。  これは、*列挙の変更*または*列挙の消費*と呼ばれます。この列挙子は、通常の `foreach` \(`For Each`\) ループとは異なり、アイテムを削除することでソース コレクションを変更するためです。  
+  
+## 使用例  
+ `foreach` \(`For Each`\) ループを使用して <xref:System.Collections.Concurrent.BlockingCollection%601> 内のすべてのアイテムを削除する方法を次の例に示します。  
+  
+ [!code-csharp[CDS_BlockingCollection#03](../../../../samples/snippets/csharp/VS_Snippets_Misc/cds_blockingcollection/cs/example03.cs#03)]
+ [!code-vb[CDS_BlockingCollection#03](../../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_blockingcollection/vb/enumeratebc.vb#03)]  
+  
+ この例では、consumer スレッドの <xref:System.Collections.Concurrent.BlockingCollection%601.GetConsumingEnumerable%2A?displayProperty=fullName> メソッドで `foreach` ループを使用します。これにより、各アイテムは、列挙されるときにコレクションから削除されます。  <xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> では常に、コレクションに含まれるアイテムの最大数が制限されます。  この方法でコレクションを列挙すると、使用できるアイテムがない場合、またはコレクションが空の場合に、consumer スレッドがブロックされます。  この例では、producer スレッドによるアイテムの追加が、アイテムの使用よりも迅速に行われるため、ブロックは問題にはなりません。  
+  
+ producer スレッドによって追加されたときの順序と同じ順序でアイテムが列挙されるという保証はありません。  
+  
+ コレクションを変更せずに列挙するには、<xref:System.Collections.Concurrent.BlockingCollection%601.GetConsumingEnumerable%2A> メソッドを使用せずに `foreach` \(`For Each`\) を使用します。  ただし、この種の列挙が表しているのは、ある特定の時点のコレクションのスナップショットであることを理解する必要があります。  ループの実行中に他のスレッドがアイテムを同時に追加または削除した場合は、ループがコレクションの実際の状態を表していないことがあります。  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [Parallel Programming](../../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/index.md b/docs/standard/collections/thread-safe/index.md
new file mode 100644
index 00000000000..8c14c1738e2
--- /dev/null
+++ b/docs/standard/collections/thread-safe/index.md
@@ -0,0 +1,63 @@
+---
+title: "スレッド セーフなコレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、概要"
+ms.assetid: 2e7ca21f-786c-4367-96be-0cf3f3dcc6bd
+caps.latest.revision: 24
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# スレッド セーフなコレクション
+[!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] では、スレッド セーフかつスケーラブルなコレクション クラスをいくつか含む <xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間が導入されています。  ユーザー コードで同期を追加することなく、複数のスレッドでこのようなコレクションの項目を安全かつ効率的に追加または削除できます。  新しいコードを記述するときに、コレクションが複数のスレッドに同時に書き込みを行う場合は、常に同時実行コレクション クラスを使用します。  共有コレクションの読み取りのみを行う場合は、<xref:System.Collections.Generic?displayProperty=fullName> 名前空間のクラスを使用できます。  .NET Framework 1.1 以前のランタイムを対象にする必要がない場合は、1.0 コレクション クラスを使用しないことをお勧めします。  
+  
+## .NET Framework 1.0 と 2.0 のコレクションのスレッドの同期  
+ .NET Framework 1.0 で導入されたコレクションは、<xref:System.Collections?displayProperty=fullName> 名前空間にあります。  一般的に使用される <xref:System.Collections.ArrayList> や <xref:System.Collections.Hashtable> を含むこのコレクションは、コレクションのスレッド セーフ ラッパーを返す `Synchronized` プロパティを通じてスレッド セーフを確保します。  このラッパーは、すべての追加操作または削除操作でコレクション全体をロックすることで機能します。  したがって、コレクションにアクセスしようとする各スレッドは、ロックを取得する順番を待機する必要があります。  これはスケーラブルではなく、大規模なコレクションの場合はパフォーマンスが大幅に低下するおそれがあります。  また、競合状態を完全に防ぐことはできません。  詳細については、MSDN Web サイトの「[Synchronization in Generic Collections \(ジェネリック コレクションでの同期\)](http://go.microsoft.com/fwlink/?LinkID=161130)」を参照してください。  
+  
+ .NET Framework 2.0 で導入されたコレクション クラスは、<xref:System.Collections.Generic?displayProperty=fullName> 名前空間にあります。  これには、<xref:System.Collections.Generic.List%601>、<xref:System.Collections.Generic.Dictionary%602> などがあります。  これらのクラスを使用すると、.NET Framework 1.0 クラスと比較して、タイプ セーフおよびパフォーマンスが向上します。  ただし、.NET Framework 2.0 コレクション クラスではスレッドの同期は行われません。複数のスレッドで同時に項目を追加または削除する場合は、ユーザー コードですべての同期を行う必要があります。  
+  
+ [!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] の同時実行コレクション クラスを使用することをお勧めします。このクラスは、.NET Framework 2.0 コレクション クラスのタイプ セーフを確保するだけでなく、[!INCLUDE[net_v10_short](../../../../includes/net-v10-short-md.md)] コレクションよりも効率的で完全なスレッド セーフも確保します。  
+  
+## 粒度の細かいロック機構とロック制御の不要な機構  
+ 同時実行コレクション型には、[!INCLUDE[net_v40_short](../../../../includes/net-v40-short-md.md)] の新機能である <xref:System.Threading.SpinLock>、<xref:System.Threading.SpinWait>、<xref:System.Threading.SemaphoreSlim>、<xref:System.Threading.CountdownEvent> などの軽量な同期機構を使用するものもあります。  これらの同期型では、通常、スレッドを実際の待機状態にする前の短期間に*ビジー スピン*が使用されます。  待機時間が非常に短くなると予測される場合は、スピンを使用すると、負荷がかかるカーネル遷移を伴う待機を行うよりも負荷が格段に小さくなります。  スピンを使用するコレクション クラスでは、この効率性は、複数のスレッドで項目を高速で追加および削除できることを意味します。  スピンとブロッキングの詳細については、「[SpinLock](../../../../docs/standard/threading/spinlock.md)」および「[SpinWait](../../../../docs/standard/threading/spinwait.md)」を参照してください。  
+  
+ <xref:System.Collections.Concurrent.ConcurrentQueue%601> クラスと <xref:System.Collections.Concurrent.ConcurrentStack%601> クラスでは、ロックは使用されません。  代わりに、<xref:System.Threading.Interlocked> 操作によってスレッド セーフを確保します。  
+  
+> [!NOTE]
+>  同時実行コレクション クラスでは <xref:System.Collections.ICollection> がサポートされるので、<xref:System.Collections.ICollection.IsSynchronized%2A> プロパティと <xref:System.Collections.ICollection.SyncRoot%2A> プロパティの実装が、これらのプロパティが無関係の場合でも提供されます。  `IsSynchronized` は常に `false` を返し、`SyncRoot` は常に `null` \(Visual Basic の場合は `Nothing`\) になります。  
+  
+ <xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間に属するコレクション型を次の表に示します。  
+  
+|型|説明|  
+|-------|--------|  
+|<xref:System.Collections.Concurrent.BlockingCollection%601>|<xref:System.Collections.Concurrent.IProducerConsumerCollection%601> を実装する任意の型の境界ブロッキング機能を提供します。  詳細については、「[BlockingCollection の概要](../../../../docs/standard/collections/thread-safe/blockingcollection-overview.md)」を参照してください。|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602>|キーと値のペアのディクショナリのスレッド セーフな実装。|  
+|<xref:System.Collections.Concurrent.ConcurrentQueue%601>|先入れ先出し \(FIFO: First In First Out\) キューのスレッド セーフな実装。|  
+|<xref:System.Collections.Concurrent.ConcurrentStack%601>|後入れ先出し \(LIFO: Last In First Out\) スタックのスレッド セーフな実装。|  
+|<xref:System.Collections.Concurrent.ConcurrentBag%601>|要素の順序付けられていないコレクションのスレッド セーフな実装。|  
+|<xref:System.Collections.Concurrent.IProducerConsumerCollection%601>|`BlockingCollection` で使用するために型が実装する必要があるインターフェイス。|  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[BlockingCollection の概要](../../../../docs/standard/collections/thread-safe/blockingcollection-overview.md)|<xref:System.Collections.Concurrent.BlockingCollection%601> 型で提供される機能について説明します。|  
+|[方法: ConcurrentDictionary の項目を追加および削除する](../../../../docs/standard/collections/thread-safe/how-to-add-and-remove-items.md)|<xref:System.Collections.Concurrent.ConcurrentDictionary%602> の要素を追加および削除する方法について説明します。|  
+|[方法: BlockingCollection の項目を個別に追加および取得する](../../../../docs/standard/collections/thread-safe/how-to-add-and-take-items.md)|読み取り専用の列挙子を使用せずにブロッキング コレクションの項目を追加および取得する方法について説明します。|  
+|[方法: 境界ブロッキング機能をコレクションに追加する](../../../../docs/standard/collections/thread-safe/how-to-add-bounding-and-blocking.md)|任意のコレクション クラスを <xref:System.Collections.Concurrent.IProducerConsumerCollection%601> コレクションの基になるストレージ機構として使用する方法について説明します。|  
+|[方法: ForEach を使用して BlockingCollection 内の項目を削除する](../../../../docs/standard/collections/thread-safe/how-to-use-foreach-to-remove.md)|`foreach` \(Visual Basic の場合は `For Each`\) を使用してブロッキング コレクションのすべての項目を削除する方法について説明します。|  
+|[方法: パイプラインでブロッキング コレクションの配列を使用する](../../../../docs/standard/collections/thread-safe/how-to-use-arrays-of-blockingcollections.md)|複数のブロッキング コレクションを同時に使用してパイプラインを実装する方法について説明します。|  
+|[方法: ConcurrentBag を使用してオブジェクト プールを作成する](../../../../docs/standard/collections/thread-safe/how-to-create-an-object-pool.md)|新しいオブジェクトを頻繁に作成する代わりにオブジェクトを再利用できるシナリオで、同時実行バッグを使用してパフォーマンスを向上させる方法について説明します。|  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/collections/thread-safe/toc.md b/docs/standard/collections/thread-safe/toc.md
index ff3b3ad78d3..aa6bb531f0f 100644
--- a/docs/standard/collections/thread-safe/toc.md
+++ b/docs/standard/collections/thread-safe/toc.md
@@ -1,9 +1,9 @@
-# [スレッドセーフなコレクション](index.md)
-## [BlockingCollection の概要](blockingcollection-overview.md)
-## [スレッドセーフなコレクションを使用する状況](when-to-use-a-thread-safe-collection.md)
-## [方法: BlockingCollection の項目を個別に追加および取得する](how-to-add-and-take-items.md)
-## [方法: ForEach を使用して BlockingCollection 内の項目を削除する](how-to-use-foreach-to-remove.md)
-## [方法: ConcurrentDictionary の項目を追加および削除する](how-to-add-and-remove-items.md)
-## [方法: 境界ブロッキング機能をコレクションに追加する](how-to-add-bounding-and-blocking.md)
-## [方法: パイプラインでブロッキング コレクションの配列を使用する](how-to-use-arrays-of-blockingcollections.md)
-## [方法: ConcurrentBag を使用してオブジェクト プールを作成する](how-to-create-an-object-pool.md)
+# [スレッド セーフなコレクションを使用する状況](when-to-use-a-thread-safe-collection.md)
+# [方法: パイプラインでブロッキング コレクションの配列を使用する](how-to-use-arrays-of-blockingcollections.md)
+# [BlockingCollection の概要](blockingcollection-overview.md)
+# [方法: ConcurrentDictionary の項目を追加および削除する](how-to-add-and-remove-items.md)
+# [方法: 境界ブロッキング機能をコレクションに追加する](how-to-add-bounding-and-blocking.md)
+# [方法: BlockingCollection の項目を個別に追加および取得する](how-to-add-and-take-items.md)
+# [スレッド セーフなコレクション](index.md)
+# [方法: ForEach を使用して BlockingCollection 内の項目を削除する](how-to-use-foreach-to-remove.md)
+# [方法: ConcurrentBag を使用してオブジェクト プールを作成する](how-to-create-an-object-pool.md)
diff --git a/docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md b/docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md
new file mode 100644
index 00000000000..6284af7ca54
--- /dev/null
+++ b/docs/standard/collections/thread-safe/when-to-use-a-thread-safe-collection.md
@@ -0,0 +1,72 @@
+---
+title: "スレッド セーフなコレクションを使用する状況 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッドセーフなコレクション、アップグレードするタイミング"
+ms.assetid: a9babe97-e457-4ff3-b528-a1bc940d5320
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# スレッド セーフなコレクションを使用する状況
+[!INCLUDE[net_v40_long](../../../../includes/net-v40-long-md.md)] では、マルチスレッドの追加操作と削除操作をサポートするために特別に設計された 5 つの新しいコレクション型が導入されています。  スレッド セーフを確保するために、これらの新しい型では、さまざまな種類の効率的なロック同期機構とロック制御の不要な同期機構が使用されます。  同期を行うと操作にオーバーヘッドが追加されます。  オーバーヘッドの量は、使用する同期の種類、実行する操作の種類、およびその他の要因 \(コレクションに同時にアクセスしようとするスレッドの数など\) によって異なります。  
+  
+ 場合によっては、同期のオーバーヘッドがほとんどなく、外部ロックで保護されるスレッド セーフでない同等の型よりもマルチスレッド型の方が、パフォーマンスとスケーラビリティが大幅に向上することがあります。  また、オーバーヘッドが原因で、スレッド セーフな型のパフォーマンスとスケーラビリティが、外部からロックされるスレッド セーフでないバージョンの型と同等かそれ以下になることもあります。  
+  
+ 以降では、スレッド セーフなコレクションと、読み取り操作および書き込み操作でユーザー指定のロックを使用するスレッド セーフでない同等のコレクションの使い分けに関する一般的なガイダンスを示します。  パフォーマンスはさまざまな要因に左右されるので、このガイダンスは特定の状況には沿っておらず、すべての状況で有効であるとは限りません。  パフォーマンスが非常に重要な場合、使用するコレクション型を判断する最適な方法は、典型的なコンピューター構成および負荷に基づいてパフォーマンスを計測することです。  このドキュメントでは、次の用語が使用されています。  
+  
+ *純粋なプロデューサー\/コンシューマー シナリオ*  
+ 任意のスレッドで要素の追加と削除のどちらか一方のみが実行されます。  
+  
+ *混合プロデューサー\/コンシューマー シナリオ*  
+ 任意のスレッドで要素の追加と削除の両方が実行されます。  
+  
+ *高速化*  
+ 同じシナリオで別の型と比較してアルゴリズムのパフォーマンスが向上すること。  
+  
+ *スケーラビリティ*  
+ コンピューターのコア数に比例したパフォーマンスの向上。  スケーリングするアルゴリズムのパフォーマンスは、コア数が 2 の場合よりも 8 の場合の方が向上します。  
+  
+## ConcurrentQueue \(T\) とキュー \(T\)  
+ 純粋なプロデューサー\/コンシューマー シナリオでは、各要素の処理時間が非常に短い \(命令が少ない\) 場合、<xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName> のパフォーマンスは外部ロックを使用する <xref:System.Collections.Generic.Queue%601?displayProperty=fullName> よりも若干優れる程度です。  このシナリオでは、<xref:System.Collections.Concurrent.ConcurrentQueue%601> は、キューへの配置とキューからの取り出しをそれぞれ専用のスレッドが実行している場合に最大のパフォーマンスを発揮します。  この規則を適用しない場合、複数のコアを備えたコンピューターでは、<xref:System.Collections.Generic.Queue%601> の方が <xref:System.Collections.Concurrent.ConcurrentQueue%601> よりもパフォーマンスが若干向上する可能性があります。  
+  
+ 処理時間が 500 FLOPS \(浮動小数点演算\) 以上の場合、2 つのスレッドを使用する規則は <xref:System.Collections.Concurrent.ConcurrentQueue%601> に適用されません。この型で非常に優れたスケーラビリティが実現します。  このシナリオでは、<xref:System.Collections.Generic.Queue%601> はスケーラビリティの点で劣ります。  
+  
+ 混合プロデューサー\/コンシューマー シナリオでは、処理時間が非常に短い場合、外部ロックを使用する <xref:System.Collections.Generic.Queue%601> のスケーラビリティは <xref:System.Collections.Concurrent.ConcurrentQueue%601> よりも優れています。  ただし、処理時間が 500 FLOPS 以上の場合は、<xref:System.Collections.Concurrent.ConcurrentQueue%601> の方がスケーラビリティに優れます。  
+  
+## ConcurrentStack とスタック  
+ 純粋なプロデューサー\/コンシューマー シナリオでは、処理時間が非常に短い場合、プッシュとポップをそれぞれ専用のスレッドが実行しているときは、<xref:System.Collections.Concurrent.ConcurrentStack%601?displayProperty=fullName> および外部ロックを使用する <xref:System.Collections.Generic.Stack%601?displayProperty=fullName> のパフォーマンスはほぼ同じであると考えられます。  ただし、スレッド数が増えると、競合が増えることで両方の型のパフォーマンスが低下し、<xref:System.Collections.Generic.Stack%601> の方が <xref:System.Collections.Concurrent.ConcurrentStack%601> よりも優れたパフォーマンスを示すことがあります。  処理時間が 500 FLOPS 以上の場合は、両方の型がほぼ同じスケーラビリティを示します。  
+  
+ 混合プロデューサー\/コンシューマー シナリオでは、作業負荷の大小にかかわらず、<xref:System.Collections.Concurrent.ConcurrentStack%601> の方が高速です。  
+  
+ <xref:System.Collections.Concurrent.ConcurrentStack%601.PushRange%2A> の使用と <xref:System.Collections.Concurrent.ConcurrentStack%601.TryPopRange%2A>、アクセス時間が大幅に短縮される可能性があります。  
+  
+## ConcurrentDictionary と辞書  
+ 一般に、複数のスレッドから同時にキーまたは値を追加および更新するシナリオでは、<xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName> を使用します。  更新を頻繁に行い、読み取りは比較的少ないシナリオでは、通常、<xref:System.Collections.Concurrent.ConcurrentDictionary%602> には大きな利点はありません。  読み取りも更新も多いシナリオでは、通常、コンピューターに任意の数のコアを備えられる場合は <xref:System.Collections.Concurrent.ConcurrentDictionary%602> の方が大幅に高速です。  
+  
+ 更新を頻繁に行うシナリオでは、<xref:System.Collections.Concurrent.ConcurrentDictionary%602> で同時実行の程度を上げて、コンピューターのコア数が多いほどパフォーマンスが向上するかどうかを計測できます。  同時実行レベルを変更する場合、グローバル操作はできるだけ避けてください。  
+  
+ キーまたは値の読み取りのみを行う場合、ディクショナリがスレッドによって変更されないときは同期が不要なので、<xref:System.Collections.Generic.Dictionary%602> の方が高速です。  
+  
+## ConcurrentBag  
+ 純粋なプロデューサー\/コンシューマー シナリオでは、<xref:System.Collections.Concurrent.ConcurrentBag%601?displayProperty=fullName> は他の同時実行コレクション型よりもパフォーマンスの点で劣ると考えられます。  
+  
+ 混合プロデューサー\/コンシューマー シナリオでは、通常、作業負荷の大小にかかわらず、<xref:System.Collections.Concurrent.ConcurrentBag%601> は他の同時実行コレクション型よりもはるかに高速でスケーラビリティに優れます。  
+  
+## BlockingCollection  
+ 境界ブロッキング セマンティクスが必要な場合は、<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> の方がカスタム実装よりもパフォーマンスの点で優れると考えられます。  この型では、高度なキャンセル、列挙、および例外処理もサポートされます。  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ [スレッド セーフなコレクション](../../../../docs/standard/collections/thread-safe/index.md)   
+ [Parallel Programming](../../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/collections/toc.md b/docs/standard/collections/toc.md
index ffbd3ab0136..8c1f2cb01c3 100644
--- a/docs/standard/collections/toc.md
+++ b/docs/standard/collections/toc.md
@@ -1,8 +1,7 @@
-# [コレクションとデータ構造体](index.md)
-# [コレクション クラスの選択](selecting-a-collection-class.md)
-# [ 一般的に使用されるコレクション型](commonly-used-collection-types.md)
-# [ジェネリック コレクションを使用する状況](when-to-use-generic-collections.md)
-# [コレクション内での比較と並べ替え](comparisons-and-sorts-within-collections.md)
-# [Sorted コレクション型](sorted-collection-types.md)
-# [Hashtable コレクション型と Dictionary コレクション型](hashtable-and-dictionary-collection-types.md)
-# [スレッドセーフなコレクション](thread-safe/)
\ No newline at end of file
+# [一般的に使用されるコレクション型](commonly-used-collection-types.md)
+# [ジェネリック コレクションを使用する状況](when-to-use-generic-collections.md)
+# [Hashtable コレクション型と Dictionary コレクション型](hashtable-and-dictionary-collection-types.md)
+# [コレクション クラスの選択](selecting-a-collection-class.md)
+# [コレクションとデータ構造体](index.md)
+# [コレクション内での比較と並べ替え](comparisons-and-sorts-within-collections.md)
+# [Sorted コレクション型](sorted-collection-types.md)
diff --git a/docs/standard/collections/when-to-use-generic-collections.md b/docs/standard/collections/when-to-use-generic-collections.md
index cc415fc7025..46fd81b111a 100644
--- a/docs/standard/collections/when-to-use-generic-collections.md
+++ b/docs/standard/collections/when-to-use-generic-collections.md
@@ -1,67 +1,63 @@
 ---
-title: "ジェネリック コレクションを使用する状況"
-description: "ジェネリック コレクションを使用する状況"
-keywords: .NET, .NET Core
-author: mairaw
-ms.author: mairaw
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 971e08bd-b63f-4832-9e61-9f65cbedd352
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: bde317c165981775330e1d0d8261d355e2401bc9
-ms.lasthandoff: 03/03/2017
-
----
-
-# <a name="when-to-use-generic-collections"></a>ジェネリック コレクションを使用する状況
-
-通常は、ジェネリック コレクションを使用することをお勧めします。これは、基本コレクション型から派生して型固有のメンバーを実装することなく、タイプ セーフの利点を即座に得ることができるためです。 また、ジェネリックでは要素をボックス化する必要がないため、コレクションの要素が値型である場合、一般的に、ジェネリック コレクション型は、対応する非ジェネリック コレクション型 (および、非ジェネリックの基本コレクション型から派生した型) よりもパフォーマンスに優れています。 
-
-複数のスレッドで同時に項目をコレクションに追加またはコレクションから削除する可能性がある場合は、[System.Collections.Concurrent](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent) 名前空間のジェネリック コレクション クラスを使用する必要があります。
-
-次のジェネリック型は、既存のコレクション型に対応しています。 
-
-*   [List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) は、[ArrayList](https://docs.microsoft.com/dotnet/core/api/System.Collections.ArrayList) に対応するジェネリック クラスです。
-
-*   [Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) と [ConcurrentDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentDictionary-2) は、[Hashtable](https://docs.microsoft.com/dotnet/core/api/System.Collections.Hashtable) に対応するジェネリック クラスです。 
-
-*   [Collection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.Collection-1) は、[CollectionBase](https://docs.microsoft.com/dotnet/core/api/System.Collections.CollectionBase) に対応するジェネリック クラスです。 `Collection<T>` は基本クラスとして使用できますが、`CollectionBase` とは異なり、抽象クラスではありません。 そのため、より簡単に使用できます。
-
-*   [ReadOnlyCollection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.ReadOnlyCollection-1) は、[ReadOnlyCollectionBase](https://docs.microsoft.com/dotnet/core/api/System.Collections.ReadOnlyCollectionBase) に対応するジェネリック クラスです。 `ReadOnlyCollection<T>` は抽象クラスではなく、既存の [List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) を読み取り専用のコレクションとして簡単に公開できるようにするコンストラクターを含んでいます。
-
-*   [Queue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Queue-1)、[ConcurrentQueue&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentQueue-1)、[Stack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Stack-1)、[ConcurrentStack&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentStack-1)、および [SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) ジェネリック クラスは、同じ名前を持つそれぞれの非ジェネリック クラスに対応しています。
-
-## <a name="additional-types"></a>その他の型
-
-いくつかのジェネリック コレクション型には、対応する非ジェネリック型がありません。 次に例を示します。 
-
-*   [LinkedList&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.LinkedList-1) は、挿入と削除の O(1) 操作を提供する汎用のリンク リストです。
-
-*   [SortedDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) は、挿入と取得の O(log n) 操作で並べ替えられたディクショナリで、[SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) の代替として役立ちます。 
-
-*   [KeyedCollection&lt;TKey, TItem&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) は、リストとディクショナリを組み合わせたもので、独自のキーを含むオブジェクトの格納方法を提供します。
-
-*   [BlockingCollection&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.BlockingCollection-1) は、境界ブロッキング機能を備えたコレクション クラスを実装します。
-
-*   [ConcurrentBag&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Concurrent.ConcurrentBag-1) は、順序のない要素の高速な挿入および削除を提供します。
-
-## <a name="linq-to-objects"></a>LINQ to Objects
-
-LINQ to Objects 機能では、オブジェクト型が [System.Collections.IEnumerable](https://docs.microsoft.com/dotnet/core/api/System.Collections.IEnumerable) または [System.Collections.Generic.IEnumerable&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IEnumerable-1) インターフェイスを実装している限り、LINQ クエリを使用してメモリ内オブジェクトにアクセスできます。 LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の `foreach` ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化機能を備えています。 さらに、LINQ クエリによってパフォーマンスを向上させることができます。
-
-## <a name="additional-functionality"></a>その他の機能
-
-一部のジェネリック型には、非ジェネリック コレクション型にはない機能があります。 たとえば、非ジェネリックの [ArrayList](https://docs.microsoft.com/dotnet/core/api/System.Collections.ArrayList) クラスに対応する [List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) クラスには、リストを検索するメソッドを指定できる [Predicate&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Predicate-1) デリゲートや、リストの各要素に作用するメソッドを表す [Action&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Action-1) デリゲートなどの、汎用デリゲートを受け取るメソッドが多数あります。
-
-[List&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.List-1) クラスを使用すると、リストの並べ替えと検索を行う独自の [IComparer&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.IComparer-1) ジェネリック インターフェイス実装を指定できます。 [SortedDictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedDictionary-2) と [SortedList&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.SortedList-2) クラスにもこの機能があります。 また、これらのクラスを使用すると、コレクションの作成時に比較演算子を指定できます。 同様に、[Dictionary&lt;TKey, TValue&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.Generic.Dictionary-2) と [KeyedCollection&lt;TKey, TItem&gt;](https://docs.microsoft.com/dotnet/core/api/System.Collections.ObjectModel.KeyedCollection-2) クラスでも独自の等値比較子を指定できます。
-
-## <a name="see-also"></a>関連項目
-
-[コレクションとデータ構造体](index.md) 
-
-[一般的に使用されるコレクション型](commonly-used-collection-types.md)
-
+title: "ジェネリック コレクションを使用する状況 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コレクション [.NET Framework], ジェネリック"
+  - "ジェネリック コレクション [.NET Framework]"
+ms.assetid: e7b868b1-11fe-4ac5-bed3-de68aca47739
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ジェネリック コレクションを使用する状況
+通常は、ジェネリック コレクションを使用することをお勧めします。これは、基本コレクション型から派生して型固有のメンバーを実装することなく、タイプ セーフの利点を即座に得ることができるためです。 また、ジェネリックでは要素をボックス化する必要がないため、コレクションの要素が値型である場合、一般的に、ジェネリック コレクション型は、対応する非ジェネリック コレクション型 \(および、非ジェネリックの基本コレクション型から派生した型\) よりもパフォーマンスに優れています。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降を対象にしたプログラムで、複数のスレッドで同時に項目をコレクションに追加またはコレクションから削除する可能性がある場合は、<xref:System.Collections.Concurrent> 名前空間のジェネリック コレクション クラスを使用する必要があります。  
+  
+ 次のジェネリック型は、既存のコレクション型に対応しています。  
+  
+-   <xref:System.Collections.Generic.List%601> は、<xref:System.Collections.ArrayList> に対応するジェネリック クラスです。  
+  
+-   <xref:System.Collections.Generic.Dictionary%602> および <xref:System.Collections.Concurrent.ConcurrentDictionary%602> は、<xref:System.Collections.Hashtable> に対応するジェネリック クラスです。  
+  
+-   <xref:System.Collections.ObjectModel.Collection%601> は、<xref:System.Collections.CollectionBase> に対応するジェネリック クラスです。<xref:System.Collections.ObjectModel.Collection%601> は基本クラスとして使用できますが、<xref:System.Collections.CollectionBase> とは異なり、抽象クラスではありません。 そのため、より簡単に使用できます。  
+  
+-   <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> は、<xref:System.Collections.ReadOnlyCollectionBase> に対応するジェネリック クラスです。<xref:System.Collections.ObjectModel.ReadOnlyCollection%601> は抽象クラスではなく、既存の <xref:System.Collections.Generic.List%601> を読み取り専用のコレクションとして簡単に公開できるようにするコンストラクターを含んでいます。  
+  
+-   <xref:System.Collections.Generic.Queue%601>、<xref:System.Collections.Concurrent.ConcurrentQueue%601>、<xref:System.Collections.Generic.Stack%601>、<xref:System.Collections.Concurrent.ConcurrentStack%601>、および <xref:System.Collections.Generic.SortedList%602> ジェネリック クラスは、同じ名前を持つそれぞれの非ジェネリック クラスに対応しています。  
+  
+## その他の型  
+ いくつかのジェネリック コレクション型には、対応する非ジェネリック型がありません。 次に例を示します。  
+  
+-   <xref:System.Collections.Generic.LinkedList%601> は、挿入と削除の O\(1\) 操作を提供する汎用のリンク リストです。  
+  
+-   <xref:System.Collections.Generic.SortedDictionary%602> は、挿入と取得の O\(log `n`\) 操作で並べ替えられたディクショナリで、<xref:System.Collections.Generic.SortedList%602> の代替として役立ちます。  
+  
+-   <xref:System.Collections.ObjectModel.KeyedCollection%602> は、リストとディクショナリを組み合わせたもので、独自のキーを含むオブジェクトの格納方法を提供します。  
+  
+-   <xref:System.Collections.Concurrent.BlockingCollection%601> は、境界ブロッキング機能を備えたコレクション クラスを実装します。  
+  
+-   <xref:System.Collections.Concurrent.ConcurrentBag%601> は、順序のない要素の高速な挿入および削除を提供します。  
+  
+## LINQ to Objects  
+ LINQ to Objects 機能では、オブジェクト型が <xref:System.Collections.IEnumerable?displayProperty=fullName> インターフェイスまたは <xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> インターフェイスを実装している限り、LINQ クエリを使用してメモリ内オブジェクトにアクセスできます。 LINQ クエリはデータ アクセス用の一般的なパターンです。通常、これは標準の `foreach` ループよりも簡潔で読みやすく、フィルター処理、並べ替え、およびグループ化機能を備えています。 さらに、LINQ クエリによってパフォーマンスを向上させることができます。 詳細については、[LINQ to Objects](../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-objects.md) および [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md) を参照してください。  
+  
+## その他の機能  
+ 一部のジェネリック型には、非ジェネリック コレクション型にはない機能があります。 たとえば、非ジェネリックの <xref:System.Collections.Generic.List%601> クラスに対応する <xref:System.Collections.ArrayList> クラスには、リストを検索するメソッドを指定できる <xref:System.Predicate%601> デリゲートや、リストの各要素に作用するメソッドを表す <xref:System.Action%601> デリゲートや、型間の変換を定義できるようにする <xref:System.Converter%602> デリゲートなどの、汎用デリゲートを受け取るメソッドが多数あります。  
+  
+ <xref:System.Collections.Generic.List%601> クラスを使用すると、リストの並べ替えと検索を行う独自の <xref:System.Collections.Generic.IComparer%601> ジェネリック インターフェイス実装を指定できます。<xref:System.Collections.Generic.SortedDictionary%602> クラスと <xref:System.Collections.Generic.SortedList%602> クラスにもこの機能があります。 また、これらのクラスを使用すると、コレクションの作成時に比較演算子を指定できます。 同様に、<xref:System.Collections.Generic.Dictionary%602> クラスと <xref:System.Collections.ObjectModel.KeyedCollection%602> クラスを使用すると、独自の等値比較子を指定できます。  
+  
+## 参照  
+ [コレクションとデータ構造体](../../../docs/standard/collections/index.md)   
+ [一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)   
+ [ジェネリック](../../../docs/standard/generics/index.md)
\ No newline at end of file
diff --git a/docs/standard/cross-platform/TOC.md b/docs/standard/cross-platform/TOC.md
new file mode 100644
index 00000000000..2645e2f773a
--- /dev/null
+++ b/docs/standard/cross-platform/TOC.md
@@ -0,0 +1,7 @@
+# [WindowsRuntimeStreamExtensions.AsRandomAccessStream(System.IO.Stream) メソッド](windowsruntimestreamextensions-asrandomaccessstream-method.md)
+# [ポータブル クラス ライブラリ](cross-platform-development-with-the-portable-class-library.md)
+# [複数のプラットフォームの開発](index.md)
+# [複数のプラットフォームを対象とするライブラリのアプリケーション リソース](app-resources-for-libraries-that-target-multiple-platforms.md)
+# [Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](support-for-windows-store-apps-and-windows-runtime.md)
+# [MVVM を利用した汎用性のあるクラス ライブラリの使用](using-portable-class-library-with-model-view-view-model.md)
+# [Windows ランタイムへの URI の引き渡し](passing-a-uri-to-the-windows-runtime.md)
diff --git a/docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md b/docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md
new file mode 100644
index 00000000000..cacbbf4ace0
--- /dev/null
+++ b/docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md
@@ -0,0 +1,114 @@
+---
+title: "複数のプラットフォームを対象とするライブラリのアプリケーション リソース | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, 複数のプラットフォームを対象とする場合のリソース"
+  - "複数のプラットフォーム, リソース"
+  - "リソース [.NET Framework]"
+  - "リソース, 複数のプラットフォーム"
+  - "複数のプラットフォームを対象とする, リソース"
+ms.assetid: 72c76f0b-7255-4576-9261-3587f949669c
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 複数のプラットフォームを対象とするライブラリのアプリケーション リソース
+.NET Framework の[ポータブル クラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md) プロジェクトの種類を使用すると、複数のプラットフォームからクラス ライブラリのリソースにアクセスできることを保証できます。  このプロジェクトの種類は [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] で利用でき、.NET Framework クラス ライブラリの移植性の高いサブセットを対象としています。  [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] を使用すると、デスクトップ アプリケーション、Silverlight アプリケーション、Windows Phone アプリケーション、および [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションからライブラリにアクセスできます。  
+  
+ [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトでは、アプリケーションで使用できるのは <xref:System.Resources> 名前空間内の非常に限られた型のサブセットのみですが、<xref:System.Resources.ResourceManager> クラスを使用してリソースを取得することはできます。  ただし、Visual Studio を使用してアプリケーションを作成する場合は、<xref:System.Resources.ResourceManager> クラス ライブラリを使用するのではなく、Visual Studio によって作成された厳密に型指定されたラッパーを使用する必要があります。  
+  
+ Visual Studio で厳密に型指定されたラッパーを作成するには、Visual Studio リソース デザイナーでメイン リソース ファイルの **\[アクセス修飾子\]** を **\[パブリック\]** に設定します。  これにより、厳密に型指定された ResourceManager ラッパーを含む \[resourceFileName\].designer.cs または \[resourceFileName\].designer.vb ファイルが作成されます。  厳密に型指定されたリソース ラッパーの使用方法の詳細については、トピック「[Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)」の「厳密に型指定されたリソース クラスの生成」を参照してください。  
+  
+## [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] のリソース マネージャー  
+ [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトでは、リソースへのすべてのアクセスは <xref:System.Resources.ResourceManager> クラスによって処理されます。  <xref:System.Resources> や <xref:System.Resources.ResourceReader> などの <xref:System.Resources.ResourceSet> 名前空間の型には [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトからアクセスできないため、これらはリソースへのアクセスには使用できません。  
+  
+ [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトには、以下の表に示す 4 つの <xref:System.Resources.ResourceManager> メンバーが含まれています。  これらのコンストラクターおよびメソッドを使用すると、<xref:System.Resources.ResourceManager> オブジェクトをインスタンス化して文字列リソースを取得できます。  
+  
+|`ResourceManager` のメンバー|説明|  
+|-----------------------------|--------|  
+|<xref:System.Resources.ResourceManager.%23ctor%28System.String%2CSystem.Reflection.Assembly%29>|<xref:System.Resources.ResourceManager> インスタンスを作成し、指定されたアセンブリ内にある、名前の指定されたリソース ファイルにアクセスします。|  
+|<xref:System.Resources.ResourceManager.%23ctor%28System.Type%29>|指定された型に対応する <xref:System.Resources.ResourceManager> インスタンスを作成します。|  
+|<xref:System.Resources.ResourceManager.GetString%28System.String%29>|現在のカルチャに対する、名前の指定されたリソースを取得します。|  
+|<xref:System.Resources.ResourceManager.GetString%28System.String%2CSystem.Globalization.CultureInfo%29>|指定されたカルチャに属する、名前の指定されたリソースを取得します。|  
+  
+ <xref:System.Resources.ResourceManager> の他の [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] メンバーを除外すると、シリアル化されたオブジェクト、文字列以外のデータ、およびイメージはリソース ファイルから取得できなくなります。  [!INCLUDE[net_portable](../../../includes/net-portable-md.md)]からリソースを使用するには、すべてのオブジェクト データを文字列形式で格納する必要があります。  たとえば、数値を文字列に変換してリソース ファイルに格納し、これらを取得して、数値データ型の `Parse` メソッドまたは `TryParse` メソッドを使用して数値に戻すことができます。  イメージや他のバイナリ データを文字列形式に変換するには <xref:System.Convert.ToBase64String%2A?displayProperty=fullName> メソッドを呼び出し、バイト配列に戻すには <xref:System.Convert.FromBase64String%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+## [!INCLUDE[net_portable](../../../includes/net-portable-md.md)]と Windows ストア アプリ  
+ [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトでは、リソースを .resx ファイルに格納します。これらのファイルはその後 .resources ファイルにコンパイルされ、コンパイル時にメイン アセンブリまたはサテライト アセンブリに埋め込まれます。  一方、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションではリソースを .resw ファイルに格納する必要があります。このファイルはその後、単一のパッケージ リソース インデックス \(PRI\) ファイルにコンパイルされます。  ただし、ファイル形式に互換性がないにもかかわらず、[!INCLUDE[net_portable](../../../includes/net-portable-md.md)] は [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションで機能します。  
+  
+ クラス ライブラリを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションで使用するには、Windows ストア アプリケーション プロジェクトでその参照を追加します。  Visual Studio ではアセンブリのリソースを .resw ファイルに透過的に抽出し、それを使用して PRI ファイルを生成して、そこから [!INCLUDE[wrt](../../../includes/wrt-md.md)] がリソースを抽出できるようにします。  実行時に [!INCLUDE[wrt](../../../includes/wrt-md.md)] は [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] 内のコードを実行しますが、汎用性のあるクラス ライブラリのリソースは PRI ファイルから取得します。  
+  
+ ローカライズされたリソースが [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトに含まれている場合は、デスクトップ アプリケーション内のライブラリの場合と同様に、ハブ アンド スポーク モデルを使用してこれらを配置します。  メイン リソース ファイルおよびローカライズされたリソース ファイルを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションで使用するには、参照をメイン アセンブリに追加します。  コンパイル時に、Visual Studio はメイン リソース ファイルとローカライズされているリソース ファイルからリソースを個別の .resw ファイルに抽出します。  次に、実行時に [!INCLUDE[wrt](../../../includes/wrt-md.md)] によってアクセスされる単一の PRI ファイルに .resw ファイルをコンパイルします。  
+  
+<a name="NonLoc"></a>   
+## 例: ローカライズされていない [!INCLUDE[net_portable](../../../includes/net-portable-md.md)]  
+ 以下の単純なローカライズされていない [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] の例では、リソースを使用して列名を格納し、表形式データ用に予約する文字数を決定します。  この例では LibResources.resx という名前のファイルを使用して、次の表に示す文字列リソースを格納します。  
+  
+|リソース名|リソースの値|  
+|-----------|------------|  
+|Born|Birthdate|  
+|BornLength|12|  
+|Hired|Hire Date|  
+|HiredLength|12|  
+|ID|ID|  
+|ID.Length|12|  
+|名前|名前|  
+|NameLength|25|  
+|タイトル|従業員データベース|  
+  
+ 次のコードは、ファイルの `UILibrary`**\[アクセス修飾子\]** を `resources`**\[パブリック\]** に変更したときに Visual Studio によって生成された  という名前のリソース マネージャーのラッパーを使用する  クラスを定義します。  UILibrary クラスは必要に応じて文字列データを解析します。  .  このクラスは `MyCompany.Employees` 名前空間にあることに注意してください。  
+  
+ [!code-csharp[Conceptual.Resources.Portable#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.portable/cs/uilibrary.cs#1)]
+ [!code-vb[Conceptual.Resources.Portable#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.portable/vb/uilibrary.vb#1)]  
+  
+ 次のコードは、`UILibrary` クラスとそのリソースをコンソールモード アプリケーションからアクセスする方法を示します。  コンソール アプリケーションのプロジェクトに追加するには UILIbrary.dll への参照が必要です。  
+  
+ [!code-csharp[Conceptual.Resources.Portable#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.portable/cs/program.cs#2)]
+ [!code-vb[Conceptual.Resources.Portable#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.portable/vb/module1.vb#2)]  
+  
+ 次のコードは、`UILibrary` クラスとそのリソースを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションからアクセスする方法を示します。  Windows ストア アプリケーション プロジェクトに追加するには UILIbrary.dll への参照が必要です。  
+  
+ [!code-csharp[Conceptual.Resources.PortableMetro#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.portablemetro/cs/blankpage.xaml.cs#1)]  
+  
+## 例: ローカライズされている [!INCLUDE[net_portable](../../../includes/net-portable-md.md)]  
+ 以下のローカライズされている [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] の例には、フランス語 \(フランス\) と英語 \(米国\) のカルチャのリソースが含まれています。  英語 \(米国\) のカルチャはアプリケーションの既定のカルチャです。そのリソースは[前のセクション](../../../docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md#NonLoc)の表に示されています。  フランス語 \(フランス\) のカルチャのリソース ファイルは LibResources.fr\-FR.resx という名前で、以下の表に示す文字列リソースで構成されています。  `UILibrary` クラスのソース コードは前のセクションに示すものと同じです。  
+  
+|リソース名|リソースの値|  
+|-----------|------------|  
+|Born|Date de naissance|  
+|BornLength|20|  
+|Hired|Date embauché|  
+|HiredLength|16|  
+|ID|ID|  
+|名前|Nom|  
+|タイトル|Base de données des employés|  
+  
+ 次のコードは、`UILibrary` クラスとそのリソースをコンソールモード アプリケーションからアクセスする方法を示します。  コンソール アプリケーションのプロジェクトに追加するには UILIbrary.dll への参照が必要です。  
+  
+ [!code-csharp[Conceptual.Resources.Portable#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.portable/cs/program2.cs#3)]
+ [!code-vb[Conceptual.Resources.Portable#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.portable/vb/module2.vb#3)]  
+  
+ 次のコードは、`UILibrary` クラスとそのリソースを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションからアクセスする方法を示します。  Windows ストア アプリケーション プロジェクトに追加するには UILIbrary.dll への参照が必要です。  静的な `ApplicationLanguages.PrimaryLanguageOverride` プロパティを使用してアプリケーションの優先言語をフランス語に設定します。  
+  
+ [!code-csharp[Conceptual.Resources.PortableMetroLoc#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.resources.portablemetroloc/cs/blankpage.xaml.cs#1)]
+ [!code-vb[Conceptual.Resources.PortableMetroLoc#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.resources.portablemetroloc/vb/blankpage.xaml.vb#1)]  
+  
+## 参照  
+ <xref:System.Resources.ResourceManager>   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)   
+ [リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)
\ No newline at end of file
diff --git a/docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md b/docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md
new file mode 100644
index 00000000000..e592aae4e7b
--- /dev/null
+++ b/docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md
@@ -0,0 +1,238 @@
+---
+title: "汎用性のあるクラス ライブラリを使用したプラットフォーム間の開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "汎用性のあるクラス ライブラリ [.NET Framework]"
+  - "複数のプラットフォームを対象とする"
+  - "対象とする複数のプラットフォーム"
+ms.assetid: c31e1663-c164-4e65-b66d-d3aa8750a154
+caps.latest.revision: 95
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 95
+---
+# 汎用性のあるクラス ライブラリを使用したプラットフォーム間の開発
+Visual Studio の .NET Framework ポータブル クラス ライブラリ プロジェクト タイプにより、Microsoft プラットフォームを対象としたクロスプラットフォーム アプリとライブラリをすばやく簡単に開発できます。  
+  
+ ポータブル クラス ライブラリにより、コードの開発とテストにかかる時間とコストを削減できます。 このプロジェクト タイプを使用してポータブル .NET Framework アセンブリを記述およびビルドし、Windows や Windows Phone など複数のプラットフォームを対象としたアプリから、これらのアセンブリを参照します。  
+  
+ Visual Studio でポータブル クラス ライブラリ プロジェクトを作成し、プロジェクトの開発を開始した後でも、ターゲット プラットフォームを変更できます。 Visual Studio は新しいアセンブリを使用してライブラリをコンパイルするので、コードに対して行う必要がある変更を確認できます。  
+  
+ この記事では、Visual Studio でのアプリの開発について説明します。しかし、Microsoft は、Xamarin などのほかのツールを使用してアプリとライブラリを開発するときに使用できるポータブル クラス ライブラリ参照アセンブリも提供します。 このようなアプリとライブラリは、Microsoft 以外のプラットフォーム上で .NET Framework ベースのランタイムで使用できます。 参照アセンブリに関する詳細については、ブログ記事を参照してください。[ポータブル クラス ライブラリ (PCL)、すべてのプラットフォームで使用可能](http://blogs.msdn.com/b/dotnet/archive/2013/10/14/portable-class-library-pcl-now-available-on-all-platforms.aspx)します。 アセンブリをダウンロードするには、「 [Microsoft .NET ポータブル ライブラリ参照アセンブリ](http://www.microsoft.com/download/details.aspx?id=40727)Microsoft ダウンロード センターからです。 Xamarin でのアセンブリを使用する方法の詳細については、ブログ記事を参照してください。 [PCL および .NET NuGet ライブラリの Xamarin のようになりました](http://blogs.msdn.com/b/dotnet/archive/2013/11/13/pcl-and-net-nuget-libraries-are-now-enabled-for-xamarin.aspx)します。  
+  
+ Visual Studio には、ポータブル クラス ライブラリの開発に役立つテンプレートがあります。 使用している Visual Studio のバージョンによっては、使用可能なテンプレートやメニューはこの記事で説明するものとは異なることがあります。  
+  
+> [!WARNING]
+>  [Visual Studio 2013 Update 2](http://go.microsoft.com/fwlink/p/?LinkId=393658)にポータブル クラス ライブラリ テンプレートの更新が含まれています。 以前のバージョンの Visual Studio と同じコンピューターにインストールされている Visual Studio 2013 があるし、更新プログラム 2、変更をインストールする場合、**ターゲット フレームワーク**の選択肢は、Visual Studio の両方のバージョンに適用されます。  
+  
+ このトピックの内容  
+  
+ [Visual Studio のサポート](#vs_support)   
+ [ポータブル クラス ライブラリ プロジェクトを作成します。](#create_pcl)   
+ [ターゲット オプション](#platforms)   
+ [ターゲットの変更](#change_targets)   
+ [サポートされている機能](#features)   
+ [サポートされている型とメンバー](#members)   
+ [ポータブル クラス ライブラリ API の相違点](#API_diff)   
+ [ポータブル クラス ライブラリを使用します。](#using)  
+  
+<a name="vs_support"></a>   
+## <a name="visual-studio-support"></a>Visual Studio のサポート  
+ Visual Studio のポータブル クラス ライブラリのサポートは、ご使用の Visual Studio のバージョンで異なります。 次の表に示すように、必要なアイテムがすべて揃っている場合と、追加のアイテムをインストールする必要がある場合があります。  
+  
+|Visual Studio SKU|ポータブル クラス ライブラリ プロジェクト作成のサポート|  
+|-----------------------|---------------------------------------------------|  
+|Visual Studio 2010、Professional、Premium、または Ultimate|[はい] をインストールするときに、[ポータブル ライブラリ ツール](http://go.microsoft.com/fwlink/?LinkId=210823)します。|  
+|Visual Studio Express 2010 の各バージョン|いいえ。|  
+|Visual Studio 2012、Professional、Premium、または Ultimate|はい。 電話サポートをインストール、 [Windows Phone SDK 8.0](http://go.microsoft.com/fwlink/?LinkId=265772)します。|  
+|Visual Studio Express 2012 の各バージョン|いいえ。|  
+|Visual Studio 2013、Professional、Premium、または Ultimate|はい。 Windows Phone 8.1 をサポートする、インストール[Visual Studio 2013 Update 2](http://go.microsoft.com/fwlink/p/?LinkId=393658)します。|  
+|Visual Studio Express 2013 for Windows|[はい] をインストールするときに、[最新バージョンの Visual Studio Express](http://go.microsoft.com/fwlink/p/?LinkId=394629)、更新プログラム 2 が含まれていますが、または追加[Visual Studio 2013 Update 2](http://go.microsoft.com/fwlink/p/?LinkId=393658)します。|  
+  
+<a name="create_pcl"></a>   
+## <a name="creating-a-portable-class-library-project"></a>ポータブル クラス ライブラリ プロジェクトの作成  
+ ポータブル クラス ライブラリを作成するには、Visual Studio に用意されているテンプレートのいずれかを使用してください。 新しいプロジェクトを作成し、、**新しいプロジェクト**ダイアログ ボックスで、**テンプレート**(c# または Visual Basic) で、目的の言語を選択して、対象となるプラットフォームのいずれかを選択します。 次のステップで追加のプラットフォームを選択できます。  
+  
+ Visual Studio 2013 Update 2 で選択できます、**クラス ライブラリ (ポータブル)**選択した言語とポータブル クラス ライブラリを作成するためのプラットフォーム用のテンプレートです。 このテンプレートは次のプラットフォームで表示されます。  
+  
+-   ストア アプリ  
+  
+-   Windows デスクトップ  
+  
+-   Silverlight  
+  
+ または Windows 8.1 を対象 Windows Phone 8.1 にライブラリを c# で作成する場合は、選択**ストア アプリ**、にして**クラス ライブラリ (ユニバーサル アプリ用ポータブル)**します。  
+  
+ ![ストア アプリ用ポータブル クラス ライブラリ](../../../docs/standard/cross-platform/media/storeuniversalpcl.png "StoreUniversalPCL")  
+  
+ このテンプレートでは、ターゲットとして Windows 8.1 と Windows Phone 8.1 が自動的に選択されます。 Windows 8.1 と Windows Phone 8.1 のみをターゲットとするライブラリを作成する場合は、後でターゲット プラットフォームを変更したり、プラットフォームを追加したりできます。  
+  
+ Visual Studio 2012 または更新プログラム 2 なしの Visual Studio 2013 を使用している場合、新しいプロジェクトを作成し、選択、**ポータブル クラス ライブラリ**Visual c# または Visual Basic でのテンプレートです。  
+  
+ ![選択されたポータブル ライブラリ プロジェクト](../../../docs/standard/cross-platform/media/portablelibrary-start.png "PortableLibrary_start")  
+  
+ **ポータブル クラス ライブラリの追加** ダイアログ ボックスが表示され、追加のプラットフォームを選択することができます。 このダイアログ ボックスに、選択したターゲットに基づいて互換性に関する警告が表示されます。  
+  
+ ![VS2013 の [ターゲット フレームワーク] ダイアログを変更します。](../Image/CLR_PCL_ChangeFrameworks.png "CLR_PCL_ChangeFrameworks")  
+Visual Studio 2013 更新プログラム 2 の [ポータブル クラス ライブラリの追加] ダイアログ ボックス  
+  
+ Visual Studio 2012 と Visual Studio 2013 のどちらを使用している場合でも、ポータブル クラス ライブラリ プロジェクトを作成するときにプラットフォームを選択できます。また、プロジェクトの作成後にプロジェクトのプロパティを使用してターゲット プラットフォームを変更できます。  
+  
+<a name="platforms"></a>   
+## <a name="target-options"></a>ターゲット オプション  
+ ポータブル クラス ライブラリ プロジェクトを作成するときに、ターゲットにするオペレーティング システムと .NET Framework バージョンを選択できます。 Visual Studio 2013 を使用するいるし、更新プログラム 2 をインストールした後で、選択した場合、**クラス ライブラリ (ユニバーサル アプリ用ポータブル)** Windows 8.1 と Windows Phone 8.1 を対象とするポータブル クラス ライブラリを作成するテンプレートです。 Visual Studio のバージョン別に選択可能なターゲットを次の表に示します。  
+  
+|||||  
+|-|-|-|-|  
+|ターゲット オプション|Visual Studio 2012|Visual Studio 2013|Visual Studio 2013 Update 2 以降|  
+|.NET Framework|.NET framework 4 以降<br /><br /> .NET framework 4.0.3 以上<br /><br /> .NET framework 4.5|.NET framework 4 以降<br /><br /> .NET framework 4.0.3 以上<br /><br /> .NET framework 4.5 以上<br /><br /> .NET framework 4.5.1|.NET framework 4<br /><br /> .NET framework 4.0.3<br /><br /> .NET framework 4.5<br /><br /> .NET framework 4.5.1|  
+|Windows Phone|-Windows Phone 7 以降<br /><br /> -Windows Phone 7.5 以上<br /><br /> -Windows Phone 8|-Windows Phone 8|-Windows Phone Silverlight 8<br /><br /> -Windows Phone Silverlight 8.1<br /><br /> Windows ランタイムと XAML をサポートするには、次を選択してください。<br /><br /> -Windows Phone 8.1|  
+|Windows ストア|Windows ストア アプリ用 .NET|Windows ストア アプリ (Windows 8) 以降<br /><br /> Windows ストア アプリ (Windows 8.1)|Windows 8<br /><br /> Windows 8.1|  
+|Silverlight|Silverlight 4 以上<br /><br /> Silverlight 5|Silverlight 5|Silverlight 5|  
+|Xbox|Xbox 360|N/A|N/A|  
+  
+<a name="change_targets"></a>   
+## <a name="changing-targets"></a>ターゲットの変更  
+ ポータブル クラス ライブラリ テンプレートを選択すると、既定のプラットフォームが自動的に選択されます。ただしこの既定値は、インストールされている Visual Studio のバージョンと、以前に選択したターゲットに応じて異なります。 ポータブル クラス ライブラリの作成時、またはポータブル クラス ライブラリの開発開始後、プラットフォームを変更できます。  
+  
+ プロジェクトを作成した後のターゲットを変更する場合は、**ソリューション エクスプ ローラー**(ソリューションではありません)、ポータブル クラス ライブラリ プロジェクトのショートカット メニューを開きを選択し、**プロパティ**します。 [プロジェクトのプロパティ] ページで、**ライブラリ**タブは、プロジェクトが現在ターゲット プラットフォームを表示します。  
+  
+ ![プロジェクトのプロパティ](../../../docs/standard/cross-platform/media/portablelibrary-projectproperties.png "PortableLibrary_ProjectProperties")  
+Visual Studio 2013 更新プログラム 2 のポータブル クラス ライブラリ プロパティ ページ  
+  
+ 追加またはターゲットを削除、選択、**変更** ボタンをクリックし、続いてを選択し、該当するチェック ボックスをオフにします。  
+  
+ ターゲットを変更すると、変更後のターゲットに合わせて、プロジェクトの開発に使用できる API が変更されます。 Visual Studio は、ターゲットを変更したことで発生する可能性があるエラーと警告を報告します。  
+  
+ Visual Studio での変更を行う前にアセンブリの移植性を評価する場合は、使用することができます、 [.NET Portability Analyzer](http://visualstudiogallery.msdn.microsoft.com/1177943e-cfb7-4822-a8a6-e56c7905292b)します。  
+  
+ メニュー オプションは、ご使用の Visual Studio のバージョンによって異なります。  
+  
+ ![ターゲットの変更](../../../docs/standard/cross-platform/media/portablelibrary.png "PortableLibrary_")  
+Visual Studio 2012 の [ターゲットの変更] ダイアログ ボックス  
+  
+<a name="features"></a>   
+## <a name="supported-features"></a>サポートされている機能  
+ 次の表に、各プラットフォームでサポートされている機能とバージョンを示します。 中には Microsoft がNuGet パッケージのリリースのサポートを追加しているものがありますが、その場合は注記が付されています。 .NET Framework の NuGet パッケージの詳細については、次を参照してください。 [.NET Framework および特別のリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)します。  
+  
+|機能|.NET Framework|.NET Framework|.NET Framework|Windows ストア|Windows ストア|Windows Phone ストア|Windows Phone Silverlight|Windows Phone Silverlight|Windows Phone Silverlight|Silverlight|Silverlight|Xbox 360|  
+|-------------|--------------------|--------------------|--------------------|-------------------|-------------------|-------------------------|-------------------------------|-------------------------------|-------------------------------|-----------------|-----------------|--------------|  
+||**4**|**4.0.3**|**4.5**|**8**|**8.1**|**8.1**|**7.5**|**8**|**8.1**|**4**|**5**||  
+|コア ライブラリ|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|  
+|非同期サポート|➊|➊|✓|✓|✓|✓|➊|➊|✓|➊|➊||  
+|[圧縮]|||✓|✓|✓|✓||➋|➋||||  
+|データの注釈||✓|✓|✓|✓|||||✓|✓||  
+|Dynamic キーワード|✓|✓|✓|✓|✓|||||✓|✓||  
+|HTTPClient|➌|➌|✓|✓|✓|✓|➌|➌|➌|➌|➌||  
+|IQueryable|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓||  
+|統合言語クエリ (LINQ)|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓||  
+|Managed Extensibility Network (MEF)|✓|✓|✓|✓|✓|||||✓|✓||  
+|Network Class Library (NCL)|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓||  
+|シリアル化 (データ コントラクト、XML、JSON)|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓||  
+|System.Numerics|✓|✓|✓|✓|✓|||||✓|✓||  
+|ビュー モデル (MVVM)|||✓|✓|✓|✓|✓|✓|✓|✓|✓||  
+|Windows Communication Foundation (WCF)|✓|✓|✓|✓|✓||✓|✓|✓|✓|✓||  
+|Windows ランタイム API|||||✓|✓|||||||  
+|Windows.UI.XAML|||||✓|✓|||||||  
+|XLINQ||✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|✓|  
+  
+ ➊ 必要[Microsoft Async](https://www.nuget.org/packages/Microsoft.Bcl.Async/)パッケージ  
+ ➋ 必要[Microsoft Compression](https://www.nuget.org/packages/Microsoft.Bcl.Compression)パッケージ  
+ ➌ 必要[Microsoft HTTP Client Libraries](http://www.nuget.org/packages/Microsoft.Net.Http)パッケージ  
+  
+> [!WARNING]
+>  参照するときにエラーが発生する可能性があります、 [Microsoft Compression](https://www.nuget.org/packages/Microsoft.Bcl.Compression)と[Microsoft HTTP Client Libraries](http://www.nuget.org/packages/Microsoft.Net.Http) Windows Phone Silverlight 8.1 アプリで使用するポータブル ライブラリからのパッケージです。 詳細については、次を参照してください。[プラットフォームの互換性と最新の Windows Phone Silverlight 8.1 アプリの変更](http://go.microsoft.com/fwlink/p/?LinkId=394744)します。  
+  
+<a name="members"></a>   
+## <a name="supported-types-and-members"></a>サポートされている型とメンバー  
+ ポータブル クラス ライブラリのプロジェクトで使用できる型とメンバーは、互換性に関するいくつかの要因による制約を受けます。  
+  
+-   選択したターゲット間で共有される必要があります。  
+  
+-   それらのターゲット間で同様に動作する必要があります。  
+  
+-   廃止候補であってはなりません。  
+  
+-   特にサポートしているメンバーがポータブルでない場合は、ポータブルな環境に意味がある必要があります。  
+  
+ たとえば、ターゲットが Windows 8.1 と Windows Phone 8.1 の場合、ポータブル クラス ライブラリには UI 関連の型のみが含まれます。 また、ポータブル クラス ライブラリが導入される前にリリースされたプラットフォーム (Xbox、.NET Framework 4、Windows Phone 7 など) を対象とする場合、制限が課せられる可能性があります。 .NET Framework は NuGet でパッケージをリリースしています。これにより、このような古いプラットフォームの一部でのポータブル クラス ライブラリのサポートが向上します。 NuGet パッケージの一覧および詳細については、次を参照してください。 [.NET Framework および特別のリリース](../../../docs/framework/get-started/the-net-framework-and-out-of-band-releases.md)します。  
+  
+ メンバーがポータブル クラス ライブラリでサポートされており、選択したターゲットのメンバーである場合、IntelliSense でプロジェクトにこのメンバーが表示されます。 さらに、ポータブル クラス ライブラリ アイコン![ポータブル ライブラリでサポートされている](../../../docs/standard/cross-platform/media/portablelibrary-referenceicon.png "PortableLibrary_ReferenceIcon")のメンバー テーブルに表示、 [.NET Framework クラス ライブラリ](http://go.microsoft.com/fwlink/?LinkId=211358) の隣にメンバーをサポートします。 例を次のメンバー テーブルを示します、 <xref:System.String.Chars%2A>内のプロパティ、<xref:System.String>クラスは、ポータブル クラス ライブラリのサポートします。  
+  
+ ![[サポートされているメンバー] アイコン](../Image/PlibSupportedMemberList.png "PlibSupportedMemberList")  
+ポータブル クラス ライブラリのアイコン  
+  
+ 検索することも、**バージョン情報**型またはメンバーがポータブル クラス ライブラリ プロジェクトでサポートされていることを示す注を参照トピックのセクション。  
+  
+ ![ポータブル ライブラリのバージョン情報](../../../docs/standard/cross-platform/media/plibversioninformation.png "PlibVersionInformation")  
+バージョン情報の例  
+  
+ ただし、API がポータブル クラス ライブラリでサポートされている可能性があります。API を使用できるかどうかは、選択したターゲットによって異なります。  
+  
+<a name="API_diff"></a>   
+## <a name="api-differences-in-the-portable-class-library"></a>ポータブル クラス ライブラリでの API の相違点  
+ サポートされるすべてのプラットフォームでポータブル クラス ライブラリ アセンブリの互換性を確保するために、ポータブル クラス ライブラリでは一部のメンバーが若干変更されています。  
+  
+<a name="using"></a>   
+## <a name="using-the-portable-class-library"></a>ポータブル クラス ライブラリの使用  
+ ポータブル クラス ライブラリ プロジェクトをビルドしたら、他のプロジェクトからそのプロジェクトを参照します。 プロジェクトを参照することも、アクセスする必要のあるクラスを含む特定のアセンブリを参照することもできます。  
+  
+ ポータブル クラス ライブラリ アセンブリを参照するアプリを実行するには、ターゲット プラットフォームの必要なバージョン (またはそれ以上のバージョン) がコンピューターにインストールされている必要があります。 Visual Studio には必要なすべてのフレームワークが含まれるため、さらに変更を加えることなく、アプリケーションの開発に使用したコンピューターでアプリケーションを実行できます。  
+  
+### <a name="deploying-a-windows-store-or-windows-phone-app"></a>Windows Store アプリまたは Windows Phone アプリの配置  
+ ポータブル クラス ライブラリ アセンブリを参照する Windows ストア アプリまたは Windows Phone アプリを作成する場合、そのアプリを配置するために必要なすべての機能はアプリ パッケージに含まれており、追加の作業は不要です。  
+  
+### <a name="deploying-a-net-framework-app"></a>.NET Framework アプリの配置  
+ ポータブル クラス ライブラリ アセンブリを参照する .NET Framework アプリを配置するときは、.NET Framework の正しいバージョンに対する依存関係を指定する必要があります。 この依存関係を指定することで、必要なバージョンがアプリケーションと共に確実にインストールされます。 対象とする .NET Framework 4 または .NET Framework 4 とする、コンピューターが、後で必要である場合、[更新](http://go.microsoft.com/fwlink/?LinkId=210824)の更新プログラム 4.0.3、.NET Framework 4 または .NET Framework 4.5 がインストールされています。  
+  
+-   ClickOnce 配置で依存関係を作成する: で**ソリューション エクスプ ローラー**、発行するプロジェクトのプロジェクト ノードを選択します。 (これは、ポータブル クラス ライブラリ プロジェクトを参照するプロジェクトです。)メニュー バー**プロジェクト**、**プロパティ**を選択し、**発行** タブをクリックします。 **発行**ページで、選択**の前提条件**します。 必須コンポーネントとして、必要な .NET Framework のバージョン (または .NET Framework 4 の更新プログラム) を選択します。  
+  
+-   セットアップ プロジェクトで依存関係を作成する: で**ソリューション エクスプ ローラー**、セットアップ プロジェクトを選択します。 メニュー バー**プロジェクト**、**プロパティ**、**の前提条件**します。 必須コンポーネントとして、必要な .NET Framework のバージョンを選択します。  
+  
+ .NET Framework アプリの展開に関する詳細については、次を参照してください。[開発者向け配置ガイド](../../../docs/framework/deployment/deployment-guide-for-developers.md)します。  
+  
+### <a name="deploying-a-silverlight-based-app"></a>Silverlight ベースのアプリの配置  
+ ポータブル クラス ライブラリ アセンブリを参照する Silverlight ベースのアプリを配置するときは、アプリに必要な最小ランタイム バージョンが、対象とするバージョンに対応していることを確認する必要があります。 Silverlight 4 を対象とする場合は、バージョンは 4.0.60129.0 以降である必要があります。 Silverlight ベースのアプリケーションをホストする Web ページに `<param name="minRuntimeVersion" value="4.0.60129.0" />` を含めることでバージョンを設定します。  
+  
+```xaml  
+<div id="silverlightControlHost">  
+    <object data="data:application/x-silverlight-2,"   
+           type="application/x-silverlight-2" width="100%" height="100%">  
+    <param name="source" value="ClientBin/SilverlightApplication.xap"/>  
+    <param name="onError" value="onSilverlightError" />  
+    <param name="background" value="white" />  
+    <param name="minRuntimeVersion" value="4.0.60129.0" />  
+    <param name="autoUpgrade" value="true" />  
+    <a href="http://go.microsoft.com/fwlink/?LinkID=149156&v=4.0.50826.0"   
+             style="text-decoration:none">  
+      <img src=http://go.microsoft.com/fwlink/?LinkId=161376  
+             alt="Get Microsoft Silverlight" style="border-style:none"/>  
+    </a>  
+  </object>  
+   <iframe id="_sl_historyFrame"   
+              style="visibility:hidden;height:0px;width:0px;border:0px">  
+   </iframe>  
+</div>  
+  
+```  
+  
+## <a name="see-also"></a>関連項目  
+ [MVVM でポータブル クラス ライブラリの使用](../../../docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md)   
+ [複数のプラットフォームを対象とするライブラリのアプリケーション リソース](../../../docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md)   
+ [.NET portability Analyzer](http://visualstudiogallery.msdn.microsoft.com/1177943e-cfb7-4822-a8a6-e56c7905292b)   
+ [Windows ストア アプリおよび Windows Runtime 用 .NET framework のサポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)   
+ [展開](../../../docs/framework/deployment/net-framework-and-applications.md)
\ No newline at end of file
diff --git a/docs/standard/cross-platform/index.md b/docs/standard/cross-platform/index.md
new file mode 100644
index 00000000000..f70e56f598f
--- /dev/null
+++ b/docs/standard/cross-platform/index.md
@@ -0,0 +1,37 @@
+---
+title: ".NET Framework による複数のプラットフォームの開発 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b153baaa-130c-4169-860b-e580591de91e
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# .NET Framework による複数のプラットフォームの開発
+.NET Framework と Visual Studio を使用して、Microsoft プラットフォームと Microsoft 以外のプラットフォームの両方を対象としたアプリを開発できます。  
+  
+## クロスプラットフォーム開発のオプション  
+ 複数プラットフォームを対象として開発する場合は、ソース コードやバイナリを共有し、.NET Framework コードと Windows ランタイム API の間で呼び出しを実行できます。  
+  
+|目的|用途|  
+|--------|--------|  
+|Windows Phone 8.1 アプリと Windows 8.1 アプリの間でソース コードを共有する|**共有プロジェクト** \(Visual Studio 2013 更新プログラム 2 のユニバーサル アプリ テンプレート\).<br /><br /> -   Visual Basic は現在サポートされていません。<br />-   \#`if` ステートメントを使用してプラットフォーム固有のコードを分離できます。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [Visual Studio を使用した Windows と Windows Phone を対象とするアプリの構築](http://msdn.microsoft.com/library/windows/apps/dn609832.aspx) \(MSDN 文書\)<br />-   [Using Visual Studio to build Universal XAML Apps \(Visual Studio を使用したユニバーサル XAML アプリの開発\)](http://blogs.msdn.com/b/visualstudio/archive/2014/04/14/using-visual-studio-to-build-universal-xaml-apps.aspx) \(ブログの投稿\)<br />-   [Using Visual Studio to Build XAML Converged Apps \(Visual Studio を使用した XAML コンバージド アプリの開発\)](http://channel9.msdn.com/Events/Build/2014/3-591) \(ビデオ\)|  
+|異なるプラットフォームを対象とするアプリ間でバイナリを共有する|プラットフォームに依存しないコードの**ポータブル クラス ライブラリ プロジェクト**。<br /><br /> -   この方法は通常、ビジネス ロジックを実装するコードに使用されます。<br />-   Visual Basic または Visual C\# を使用できます。<br />-   API のサポートはプラットフォームによって異なります。<br />-   Windows 8.1 および Windows Phone 8.1 を対象としたポータブル クラス ライブラリのプロジェクトでは、Windows ランタイム API と XAML がサポートされます。  これらの機能は、古いバージョンのポータブル クラス ライブラリでは使用できません。<br />-   必要に応じて、インターフェイスまたは抽象クラスを使用してプラットフォーム固有のコードを抽象化できます。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [汎用性のあるクラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md) \(MSDN 記事\)<br />-   [How to Make Portable Class Libraries Work for You \(ポータブル クラス ライブラリを活用する方法\)](http://blogs.msdn.com/b/dsplaisted/archive/2012/08/27/how-to-make-portable-class-libraries-work-for-you.aspx) \(ブログ記事\)<br />-   [MVVM を利用した汎用性のあるクラス ライブラリの使用](../../../docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md) \(MSDN 記事\)<br />-   [複数のプラットフォームを対象とするライブラリのアプリケーション リソース](../../../docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md) \(MSDN 記事\)<br />-   [.NET 移植性アナライザー](http://visualstudiogallery.msdn.microsoft.com/1177943e-cfb7-4822-a8a6-e56c7905292b) \(Visual Studio の拡張機能\)|  
+|Windows 8.1 および Windows Phone 8.1 以外のプラットフォームを対象としたアプリの間でソース コードを共有する|**\[リンクとして追加\]** 機能。<br /><br /> -   この方法は、両方のアプリに共通しているが、何らかの理由で移植できないアプリ ロジックに適しています。  この機能は Visual Basic または Visual C\# のコードに使用できます。<br />     たとえば Windows Phone 8 と Windows 8 は Windows ランタイム API を共有しますが、ポータブル クラス ライブラリはこれらのプラットフォームでは Windows ランタイムをサポートしていません。  Windows Phone 8 アプリと、Windows 8 を対象とした Windows ストア アプリの間で共通する Windows ランタイム コードを共有するには、`Add as link` を使用できます。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [\[リンクとして追加\] を使用してコードを共有する](http://msdn.microsoft.com/library/windowsphone/develop/jj714082\(v=vs.105\).aspx) \(MSDN article\)<br />-   [方法 : プロジェクトに既存の項目を追加する](http://msdn.microsoft.com/library/vstudio/9f4t9t92\(v=vs.100\).aspx) \(MSDN 文書\)|  
+|.NET Framework を使用して Windows ストア アプリを作成するか、または .NET Framework コードから Windows ランタイム API を呼び出します。|.NET Framework C\# または Visual Basic コードの **Windows ランタイム API**。.NET Framework を使用して Windows ストア アプリを作成します。  2 つのプラットフォーム間の API の違いについて注意してください。  ただし、これらの違いに対処するためのクラスがあります。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md) \(MSDN 記事\)<br />-   [Windows ランタイムへの URI の引き渡し](../../../docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md) \(MSDN 記事\)<br />-   <xref:System.IO.WindowsRuntimeStreamExtensions> \(MSDN API リファレンス ページ\)<br />-   <xref:System.WindowsRuntimeSystemExtensions> \(MSDN API リファレンス ページ\)|  
+|Microsoft 以外のプラットフォームに対応した .NET Framework アプリの開発|.NET Framework, の **ポータブル クラス ライブラリの参照アセンブリ**と、Visual Studio 拡張機能またはサードパーティ ツール \(Xamarin など\)。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [Portable Class Library now available on all platforms \(ポータブル クラス ライブラリ、全プラットフォームで使用可能に\)](http://blogs.msdn.com/b/dotnet/archive/2013/10/14/portable-class-library-pcl-now-available-on-all-platforms.aspx) \(ブログの投稿\)<br />-   [Xamarin](http://xamarin.com/visual-studio) \(Xamarin Web サイト\)|  
+|JavaScript および HTML を使用したクロスプラットフォーム開発|Visual Studio 2013 更新プログラム 2 の**ユニバーサル アプリ テンプレート**。このテンプレートを使用して、Windows 8.1 と Windows Phone 8.1 の Windows ランタイム API に対する開発を行います。  現在、クロスプラットフォーム アプリを開発するときに .NET Framework API で JavaScript と HTML を使用することはできません。<br /><br /> 詳細については、以下の資料を参照してください。<br /><br /> -   [JavaScript プロジェクト テンプレート](http://msdn.microsoft.com/library/windows/apps/hh758331.aspx)<br />-   [JavaScript を使った Windows ランタイム アプリを Windows Phone に移植する方法](http://msdn.microsoft.com/library/windows/apps/dn636144.aspx)|
\ No newline at end of file
diff --git a/docs/standard/cross-platform/media/plibversioninformation.png b/docs/standard/cross-platform/media/plibversioninformation.png
new file mode 100644
index 00000000000..343e48ee761
Binary files /dev/null and b/docs/standard/cross-platform/media/plibversioninformation.png differ
diff --git a/docs/standard/cross-platform/media/portablelibrary-projectproperties.png b/docs/standard/cross-platform/media/portablelibrary-projectproperties.png
new file mode 100644
index 00000000000..9664aa4171d
Binary files /dev/null and b/docs/standard/cross-platform/media/portablelibrary-projectproperties.png differ
diff --git a/docs/standard/cross-platform/media/portablelibrary-start.png b/docs/standard/cross-platform/media/portablelibrary-start.png
new file mode 100644
index 00000000000..b03d6b94e83
Binary files /dev/null and b/docs/standard/cross-platform/media/portablelibrary-start.png differ
diff --git a/docs/standard/cross-platform/media/portablelibrary.png b/docs/standard/cross-platform/media/portablelibrary.png
new file mode 100644
index 00000000000..9ae3537afaf
Binary files /dev/null and b/docs/standard/cross-platform/media/portablelibrary.png differ
diff --git a/docs/standard/cross-platform/media/portablemvvmdiagram.png b/docs/standard/cross-platform/media/portablemvvmdiagram.png
new file mode 100644
index 00000000000..1db299aaeec
Binary files /dev/null and b/docs/standard/cross-platform/media/portablemvvmdiagram.png differ
diff --git a/docs/standard/cross-platform/media/storeuniversalpcl.png b/docs/standard/cross-platform/media/storeuniversalpcl.png
new file mode 100644
index 00000000000..f3e0d593455
Binary files /dev/null and b/docs/standard/cross-platform/media/storeuniversalpcl.png differ
diff --git a/docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md b/docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md
new file mode 100644
index 00000000000..935352faa62
--- /dev/null
+++ b/docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md
@@ -0,0 +1,47 @@
+---
+title: "Windows ランタイムへの URI の引き渡し | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows ランタイム、.NET Framework のサポート"
+  - "Windows ランタイム, URL を渡す"
+ms.assetid: 3eb5ce6f-f304-4f87-8e81-0f25092f5ad4
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Windows ランタイムへの URI の引き渡し
+Windows ランタイムのメソッドは絶対 URI だけを受け取ります。[!INCLUDE[wrt](../../../includes/wrt-md.md)] メソッドに相対 URI を渡すと、<xref:System.ArgumentException> 例外がスローされます。 これは、.NET Framework コードで [!INCLUDE[wrt](../../../includes/wrt-md.md)] を使用する場合、[Windows.Foundation.Uri](http://go.microsoft.com/fwlink/p/?LinkId=238376) クラスは Intellisense では <xref:System.Uri?displayProperty=fullName> として示されるためです。<xref:System.Uri?displayProperty=fullName> クラスでは相対 URI を使用できますが、[Windows.Foundation.Uri](http://go.microsoft.com/fwlink/p/?LinkId=238376) クラスでは相対 URI は使用できません。[!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントで公開するメソッドでも同様です。 URI を受け取るメソッドをコンポーネントで公開する場合、コードのシグネチャには <xref:System.Uri?displayProperty=fullName> が含まれます。 ただし、コンポーネントのユーザーに対しては、シグネチャに [Windows.Foundation.Uri](http://go.microsoft.com/fwlink/p/?LinkId=238376) が含まれます。 コンポーネントに渡す URI は、絶対 URI でなければなりません。  
+  
+ このトピックでは、絶対 URI を検出する方法と、アプリ パッケージ内のリソースを参照するときに絶対 URI を作成する方法を説明します。  
+  
+## 絶対 URI の検出と使用  
+ URI を <xref:System.Uri.IsAbsoluteUri%2A?displayProperty=fullName>に渡す前にそれが絶対 URI であることを確認するには、[!INCLUDE[wrt](../../../includes/wrt-md.md)] プロパティを使用します。 このプロパティを使用する方が、<xref:System.ArgumentException> 例外をキャッチして処理するより効率的です。  
+  
+## アプリ パッケージのリソースに対する絶対 URI の使用  
+ アプリのパッケージに含まれるリソースに対して URI を指定するには、`ms-appx` スキームまたは `ms-appx-web` スキームを使用して絶対 URI を作成します。  
+  
+ 次の例に、XAML とコードの両方を使用して、Pages という名前のフォルダーに含まれるリソースに、[WebView](http://msdn.microsoft.com/library/windows/apps/xaml/windows.ui.xaml.controls.webview.aspx) コントロールの [Source](http://msdn.microsoft.com/library/windows/apps/xaml/windows.ui.xaml.controls.webview.source.aspx) プロパティと [Image](http://msdn.microsoft.com/library/windows/apps/br242752.aspx) コントロールの [Source](http://msdn.microsoft.com/library/windows/apps/windows.ui.xaml.controls.image.source.aspx) プロパティを設定する方法を示します。  
+  
+ [!code-xml[System.URIToWindowsURI#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.uritowindowsuri/cs/mainpage.xaml#1)]  
+[!code-csharp[System.URIToWindowsURI#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.uritowindowsuri/cs/mainpage.xaml.cs#2)]
+[!code-vb[System.URIToWindowsURI#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.uritowindowsuri/vb/mainpage.xaml.vb#2)]  
+  
+ これらのスキームの詳細については、Windows デベロッパー センターの「[URI スキーム](http://msdn.microsoft.com/library/windows/apps/jj655406.aspx)」を参照してください。  
+  
+## 参照  
+ [Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート](../../../docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md)
\ No newline at end of file
diff --git a/docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md b/docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md
new file mode 100644
index 00000000000..c17441fd7f6
--- /dev/null
+++ b/docs/standard/cross-platform/support-for-windows-store-apps-and-windows-runtime.md
@@ -0,0 +1,163 @@
+---
+title: "Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Windows ストア アプリ、.NET Framework のサポート"
+  - "Windows ランタイム、.NET Framework のサポート"
+  - "Windows ストア アプリ用 .NET"
+  - ".NET Framework、Windows ストア アプリ"
+  - ".NET Framework、Windows ランタイム"
+ms.assetid: 6fa7d044-ae12-4c54-b8ee-50915607a565
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# Windows ストア アプリおよび Windows ランタイムのための .NET Framework サポート
+[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] は [!INCLUDE[wrt](../../../includes/wrt-md.md)]のさまざまなソフトウェア開発シナリオをサポートします。 これらのシナリオは次の&3; つのカテゴリに分類されます。  
+  
+-   開発[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)]」の説明に従って、XAML コントロールにアプリ[Windows ストア アプリのロードマップ c# または Visual Basic を使用して](http://go.microsoft.com/fwlink/p/?LinkID=242212)、 [Windows ストア アプリの開発 (VB/c#/+ と XAML)](http://go.microsoft.com/fwlink/p/?LinkId=238311)、および[.NET Windows ストア アプリの概要](http://go.microsoft.com/fwlink/p/?LinkId=238312)Windows デベロッパー センターでします。  
+  
+-   .NET Framework で作成する [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリで使用するクラス ライブラリを開発する。  
+  
+-   .WinMD ファイルにパッケージ化され、[!INCLUDE[wrt](../../../includes/wrt-md.md)]をサポートするすべてのプログラミング言語で使用できる、[!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントを開発する。 たとえばを参照してください[c# および Visual Basic での Windows ランタイム コンポーネントの作成](http://go.microsoft.com/fwlink/p/?LinkId=238313)Windows デベロッパー センターにします。  
+  
+ このトピックでは、3 つのカテゴリすべてに対して .NET Framework が提供するサポートの概略と、[!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネント用シナリオについて説明します。 最初のセクションでは、.NET Framework と [!INCLUDE[wrt](../../../includes/wrt-md.md)]の関係についての基本情報と、ヘルプ システムや IDE で見られる可能性がある特異な状況について説明します。 [2 番目のセクション](#WindowsRuntimeComponents)を開発するためのシナリオについて説明[!INCLUDE[wrt](../../../includes/wrt-md.md)]コンポーネントです。  
+  
+## <a name="the-basics"></a>基本事項  
+ .NET Framework は、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] を提供することと [!INCLUDE[wrt](../../../includes/wrt-md.md)]自体をサポートすることによって、前述の&3; つの開発シナリオをサポートします。  
+  
+-   [Windows ストア アプリ用 .NET](http://go.microsoft.com/fwlink/p/?LinkId=247912) .NET Framework クラス ライブラリの効率化されたビューを提供し、型と作成に使用できるメンバーのみを含める[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)]アプリと[!INCLUDE[wrt](../../../includes/wrt-md.md)]コンポーネントです。  
+  
+    -   [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] アプリまたは [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] コンポーネントの開発に Visual Studio ([!INCLUDE[wrt](../../../includes/wrt-md.md)] 以降) を使用すると、参照アセンブリのセットでは、関連する型およびメンバーのみが表示されます。  
+  
+    -   この簡素化された API セットは、.NET Framework 内で重複した機能、または [!INCLUDE[wrt](../../../includes/wrt-md.md)]の機能と重複した機能を削除すると、さらに単純化できます。 たとえば、簡素化された API セットにはコレクション型のジェネリック バージョンのみが含まれ、XML ドキュメント オブジェクト モデルは削除されて、代わりに [!INCLUDE[wrt](../../../includes/wrt-md.md)] XML API セットが使用されます。  
+  
+    -   オペレーティング システムの API をラップするだけの機能も削除されます。これは、[!INCLUDE[wrt](../../../includes/wrt-md.md)] をマネージ コードから簡単に呼び出すことができるためです。  
+  
+     詳細について、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)]を参照してください、 [.NET Windows ストア アプリの概要](http://go.microsoft.com/fwlink/p/?LinkId=238312)API 選択プロセスについて説明する Windows デベロッパー センターを参照してください、 [Windows ストア アプリ用 .NET](http://go.microsoft.com/fwlink/p/?LinkId=251061) .NET ブログ エントリです。  
+  
+-   [Windows ランタイム](http://go.microsoft.com/fwlink/p/?LinkId=238319)を構築するため、ユーザー インターフェイス要素を提供[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)]アプリ、およびオペレーティング システム機能へのアクセスを提供します。 .NET Framework と同様、[!INCLUDE[wrt](../../../includes/wrt-md.md)]には、C# や Visual Basic のコンパイラが .NET Framework クラス ライブラリを使用するのと同じ方法で [!INCLUDE[wrt](../../../includes/wrt-md.md)]を使用するためのメタデータが含まれています。 .NET Framework では、一部の相違点を非表示にすることで [!INCLUDE[wrt](../../../includes/wrt-md.md)]が使いやすくなっています。  
+  
+    -   .NET Framework と [!INCLUDE[wrt](../../../includes/wrt-md.md)]間のプログラミング パターン (イベント ハンドラーを追加および削除するパターンなど) の違いの一部が非表示になります。 ユーザーは .NET Framework のパターンを使用するとよいだけです。  
+  
+    -   よく使用される型 (たとえばプリミティブ型やコレクション) の違いの一部が非表示になります。 説明したように単純に、.NET Framework の型を使用する[表示相違点は、IDE で](#DifferencesVisibleInIDE)、この記事で後述します。  
+  
+ ほとんどの場合、[!INCLUDE[wrt](../../../includes/wrt-md.md)]の .NET Framework サポートは透過的です。 次のセクションでは、マネージ コードと [!INCLUDE[wrt](../../../includes/wrt-md.md)]との明確な違いのいくつかについて説明します。  
+  
+<a name="AboutReferenceDocumentation"></a>   
+### <a name="the-net-framework-and-the-includewrttokenwrtmdmd-reference-documentation"></a>.NET Framework と [!INCLUDE[wrt](../../../includes/wrt-md.md)]のリファレンス ドキュメント  
+ Windows と .NET Framework では、ドキュメント セットがそれぞれ別になっています。 型またはメンバーに関するヘルプを表示するために F1 キーを押すと、該当するセットのリファレンス ドキュメントが表示されます。 ただしを参照する場合、 [Windows ランタイム リファレンス](http://go.microsoft.com/fwlink/p/?LinkId=238319)に理解しにくいと思われる例が発生する可能性があります。  
+  
+-   」などのトピック、 [IIterable インターフェイス](http://go.microsoft.com/fwlink/p/?LinkId=238321)Visual Basic または c# の宣言の構文はありません。 代わりに、メモの上側に「構文」セクション (この場合は、".NET: このインターフェイスは、配列として表示されます<>\>") です。 これは、.NET Framework と [!INCLUDE[wrt](../../../includes/wrt-md.md)]で、同様の機能が異なるインターフェイスにより用意されているためです。 さらに、動作の違いがある:`IIterable`が、`First`メソッドの代わりに、 <xref:System.Collections.Generic.IEnumerable%601.GetEnumerator%2A>列挙子を返します。 .NET Framework では、一般的なタスクを実行する別の方法をユーザーが学習する必要はなく、使い慣れた型を使用できるようマネージ コードを表示して [!INCLUDE[wrt](../../../includes/wrt-md.md)]をサポートします。 IDE では `IIterable` インターフェイスを使用しないため、[!INCLUDE[wrt](../../../includes/wrt-md.md)]のリファレンス ドキュメントでこのインターフェイスを目にするのは、ドキュメントを直接参照する場合のみです。  
+  
+-   [SyndicationFeed コンス トラクター](http://go.microsoft.com/fwlink/p/?LinkId=238322)ドキュメントが密接に関連する問題を示しています。 別の言語によって異なるそのパラメーターの型が表示されます。 C# および Visual Basic の場合は、パラメーターの型は<xref:System.String?displayProperty=fullName>と<xref:System.Uri?displayProperty=fullName>します。 これもやはり、.NET Framework で独自の `String` 型と `Uri` 型が使われるためであり、このようなよく使用される型について、.NET Framework ユーザーが処理を実行する別の方法を学習しても意味はありません。 IDE では、これに対応する [!INCLUDE[wrt](../../../includes/wrt-md.md)]の型が .NET Framework によって非表示にされます。  
+  
+-   いくつかの場合など、 [Windows.UI.Xaml.GridLength](http://go.microsoft.com/fwlink/p/?LinkId=251059)構造、.NET Framework は多くの機能は、同じ名前を持つ型を提供します。 たとえば、一連のコンストラクターとプロパティのトピックは `GridLength` に関連付けられますが、メンバーがマネージ コードでのみ使用可能であるために、Visual Basic と C# に関してのみ構文ブロックの機能を備えています。 [!INCLUDE[wrt](../../../includes/wrt-md.md)]では、構造体にフィールドがあるだけです。 [!INCLUDE[wrt](../../../includes/wrt-md.md)]構造はヘルパー クラスを必要と[Windows.UI.Xaml.GridLengthHelper](http://go.microsoft.com/fwlink/p/?LinkId=251060)、同等の機能を提供します。 このヘルパー クラスは、マネージ コードを記述している間は IDE に表示されません。  
+  
+-   IDE では、[!INCLUDE[wrt](../../../includes/wrt-md.md)]型から派生に表示される<xref:System.Object?displayProperty=fullName>します。 継承されたメンバーが表示される<xref:System.Object>など<xref:System.Object.ToString%2A?displayProperty=fullName>します。 これらのメンバーが、型が実際にから継承されたかのように動作<xref:System.Object>、および[!INCLUDE[wrt](../../../includes/wrt-md.md)]型にキャストすることができます<xref:System.Object>します。 この機能は、.NET Framework が [!INCLUDE[wrt](../../../includes/wrt-md.md)]用に用意しているサポートの一部です。 ただし、[!INCLUDE[wrt](../../../includes/wrt-md.md)]のリファレンス ドキュメントで型を表示しても、このようなメンバーは表示されません。 提供すると、これらの見かけ上の継承されたメンバーのドキュメント、 <xref:System.Object?displayProperty=fullName>のドキュメントを参照します。  
+  
+<a name="DifferencesVisibleInIDE"></a>   
+### <a name="differences-that-are-visible-in-the-ide"></a>IDE で表示される相違点  
+ より高度なプログラミング シナリオ (例: C# で記述された [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントを使い、JavaScript を使用して Windows 用にビルドされた [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリのアプリケーション ロジックを提供する) では、ドキュメントと同様 IDE でもこのような相違点が表示されます。 コンポーネントから JavaScript に `IDictionary<int, string>` が返され、それを JavaScript デバッガーで調べると、JavaScript が `IMap<int, string>`の型を使用するので、[!INCLUDE[wrt](../../../includes/wrt-md.md)] のメソッドが表示されます。 よく使用されるコレクション型のうち、この&2; 言語で表示が異なる型の一部を次の表に示します。  
+  
+|[!INCLUDE[wrt](../../../includes/wrt-md.md)] 型|対応する .NET Framework の型|  
+|--------------------------------------------------------------|---------------------------------------|  
+|`IIterable<T>`|`IEnumerable<T>`|  
+|`IIterator<T>`|`IEnumerator<T>`|  
+|`IVector<T>`|`IList<T>`|  
+|`IVectorView<T>`|`IReadOnlyList<T>`|  
+|`IMap<K, V>`|`IDictionary<TKey, TValue>`|  
+|`IMapView<K, V>`|`IReadOnlyDictionary<TKey, TValue>`|  
+|`IBindableIterable`|`IEnumerable`|  
+|`IBindableVector`|`IList`|  
+|`Windows.UI.Xaml.Data.INotifyPropertyChanged`|`System.ComponentModel.INotifyPropertyChanged`|  
+|`Windows.UI.Xaml.Data.PropertyChangedEventHandler`|`System.ComponentModel.PropertyChangedEventHandler`|  
+|`Windows.UI.Xaml.Data.PropertyChangedEventArgs`|`System.ComponentModel.PropertyChangedEventArgs`|  
+  
+ [!INCLUDE[wrt](../../../includes/wrt-md.md)]では、`IMap<K, V>` と `IMapView<K, V>` は `IKeyValuePair` を使用して反復されます。 これらをマネージ コードに渡すと、`IDictionary<TKey, TValue>` および `IReadOnlyDictionary<TKey, TValue>` として表示されるため、これを列挙するには必然的に `System.Collections.Generic.KeyValuePair<TKey, TValue>` を使用します。  
+  
+ インターフェイスがマネージ コード内に表示される方法によって、これらのインターフェイスを実装する型の表示方法が決まります。 たとえば、`PropertySet` クラスは `IMap<K, V>` を実装しますが、これはマネージ コードでは `IDictionary<TKey, TValue>` として表示されます。 `PropertySet` では、`IMap<K, V>` ではなく `IDictionary<TKey, TValue>` が実装されたように見えるため、マネージ コードでは .NET Framework ディクショナリの `Add` メソッドのように動作する `Add` メソッドがあるように表示されます。 `Insert` メソッドがないように見えます。  
+  
+ .NET Framework を使用して作成する方法について、[!INCLUDE[wrt](../../../includes/wrt-md.md)]コンポーネント、および、このようなコンポーネントを JavaScript を使用する方法を説明したチュートリアルを参照してください。 [c# および Visual Basic での Windows ランタイム コンポーネントの作成](http://go.microsoft.com/fwlink/p/?LinkId=238313)Windows デベロッパー センターにします。  
+  
+### <a name="primitive-types"></a>プリミティブ型  
+ マネージ コードで [!INCLUDE[wrt](../../../includes/wrt-md.md)]のナチュラルな使用を有効にすると、[!INCLUDE[wrt](../../../includes/wrt-md.md)]のプリミティブ型ではなく .NET Framework のプリミティブ型がコードに表示されます。 .NET Framework では、`Int32` 構造体などのプリミティブ型には、`Int32.TryParse` メソッドなどの便利なプロパティとメソッドが多くあります。 一方、[!INCLUDE[wrt](../../../includes/wrt-md.md)]のプリミティブ型と構造体にはフィールドしかありません。 マネージ コードでプリミティブを使用すると、.NET Framework の型のように表示され、通常どおりに .NET Framework 型のプロパティとメソッドを使用できます。 要約すると、次のようになります。  
+  
+-   [!INCLUDE[wrt](../../../includes/wrt-md.md)]のプリミティブ `Int32`、`Int64`、`Single`、`Double`、`Boolean`、`String` (Unicode 文字の変更できないコレクション)、`Enum`、`UInt32`、`UInt64`、および `Guid` では、`System` 名前空間内の同じ名前の型を使用します。  
+  
+-   `UInt8` では、`System.Byte` を使用します。  
+  
+-   `Char16` では、`System.Char` を使用します。  
+  
+-   `IInspectable` インターフェイスでは、`System.Object` を使用します。  
+  
+-   `HRESULT` では、`System.Int32` のメンバーを&1; つ含む構造体を使用します。  
+  
+ インターフェイス型の場合と同様、この表示の証拠が表示されるのは、.NET Framework プロジェクトが、JavaScript を使用してビルドされた [!INCLUDE[wrt](../../../includes/wrt-md.md)] アプリで使用される [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] コンポーネントである場合に限られます。  
+  
+ よく使用されるその他の基本的[!INCLUDE[wrt](../../../includes/wrt-md.md)]、.NET Framework の同等が含まれるのでに表示される型のマネージ コード、`Windows.Foundation.DateTime`としてマネージ コードに表示される構造体、 <xref:System.DateTimeOffset?displayProperty=fullName>構造体、および`Windows.Foundation.TimeSpan`として表示される構造体、 <xref:System.TimeSpan?displayProperty=fullName>構造体。  
+  
+### <a name="other-differences"></a>その他の相違点  
+ コードで [!INCLUDE[wrt](../../../includes/wrt-md.md)]の型ではなく .NET Framework の型が表示されるために、ユーザー側のアクションが必要になる場合があります。 たとえば、 [Windows.Foundation.Uri](http://go.microsoft.com/fwlink/p/?LinkId=238376)クラスとして位置付け<xref:System.Uri?displayProperty=fullName> .NET Framework コードでします。 <xref:System.Uri?displayProperty=fullName>により、相対 URI が、 [Windows.Foundation.Uri](http://go.microsoft.com/fwlink/p/?LinkId=238376)絶対 URI が必要です。 したがって、[!INCLUDE[wrt](../../../includes/wrt-md.md)] メソッドに URI を渡すときには、絶対 URI にする必要があります。 (参照[Windows ランタイムへの URI の引き渡し](../../../docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md))。  
+  
+<a name="WindowsRuntimeComponents"></a>   
+## <a name="scenarios-for-developing-windows-runtime-components"></a>Windows ランタイム コンポーネントの開発シナリオ  
+ [!INCLUDE[wrt](../../../includes/wrt-md.md)]のマネージ コンポーネントでサポートされるシナリオは、次の原則に依存します。  
+  
+-   .NET Framework を使用してビルドされる [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントとその他の [!INCLUDE[wrt](../../../includes/wrt-md.md)] ライブラリの間に、明確な違いはありません。 たとえば、マネージ コードを使用して [!INCLUDE[wrt](../../../includes/wrt-md.md)]のネイティブ コンポーネントを再実装する場合、この&2; つのコンポーネントは外部から見て区別が付きません。 コンポーネントがマネージ コードで記述されているという事実は、そのコード自体がマネージ コードであったとしても、そのコンポーネントを使用するコードには表示されません。 ただし内部的には、そのコンポーネントは真のマネージ コードであり、共通言語ランタイム (CLR) 上で実行されます。  
+  
+-   コンポーネントには、アプリケーション ロジック、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] UI コントロール、またはその両方を実装する型を含めることができます。  
+  
+    > [!NOTE]
+    >  アプリケーション ロジックから UI 要素を分離することをお勧めします。 また、JavaScript や HTML を使用して Windows 用にビルドされた [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでは、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] UI コントロールを使用できません。  
+  
+-   コンポーネントは、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリ用 Visual Studio ソリューション内のプロジェクトの場合もあれば、複数のソリューションに追加できる再利用可能なコンポーネントの場合もあります。  
+  
+    > [!NOTE]
+    >  コンポーネントが C# または Visual Basic でのみ使用される場合は、それを [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントにする必要はありません。 代わりにそれを通常の .NET Framework クラス ライブラリにすると、そのパブリック API サーフェイスを [!INCLUDE[wrt](../../../includes/wrt-md.md)]の型に制限する必要はありません。  
+  
+-   使用して再利用可能なコンポーネントのバージョンをリリースできます、 [!INCLUDE[wrt](../../../includes/wrt-md.md)] [VersionAttribute](http://go.microsoft.com/fwlink/p/?LinkId=238563)さまざまなバージョンで追加された属性をどの型 (および型のメンバー) を指定します。  
+  
+-   コンポーネントの型は [!INCLUDE[wrt](../../../includes/wrt-md.md)]の型から派生できます。 コントロールがのプリミティブ コントロール型から派生させることができます、 [Windows.UI.Xaml.Controls.Primitives](http://go.microsoft.com/fwlink/p/?LinkId=238564)名前空間または終了コントロールなどの詳細から[ボタン](http://go.microsoft.com/fwlink/p/?LinkId=238565)します。  
+  
+    > [!IMPORTANT]
+    >  [!INCLUDE[win8](../../../includes/win8-md.md)] および [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降では、[!INCLUDE[wrt](../../../includes/wrt-md.md)] マネージ コンポーネントのすべてのパブリック型をシールする必要があります。 別の [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネント内の型はそこから派生できません。 コンポーネントでポリモーフィックな動作を提供するには、インターフェイスを作成し、そのインターフェイスをポリモーフィックな型に実装します。  
+  
+-   コンポーネント内のパブリック型で指定されるすべてのパラメーターと戻り値の型は、[!INCLUDE[wrt](../../../includes/wrt-md.md)]の型 (コンポーネントで定義する [!INCLUDE[wrt](../../../includes/wrt-md.md)]の型を含む) である必要があります。  
+  
+ 次のセクションでは、一般的なシナリオの例を示します。  
+  
+### <a name="application-logic-for-a-includewin8appnamelongtokenwin8appnamelongmdmd-app-with-javascript"></a>JavaScript による [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリ用アプリケーション ロジック  
+ JavaScript を使用して Windows の [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを開発する場合、アプリケーション ロジックの一部が、他の部分に比べてマネージ コードでより適切に機能したり、開発が容易であったりすることがあります。 JavaScript では .NET Framework クラス ライブラリを直接使用できませんが、クラス ライブラリを .WinMD ファイルにすることができます。 このシナリオでは、[!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントがアプリに不可欠な部分であるため、バージョン属性を提供する意味がありません。  
+  
+### <a name="reusable-includewin8appnamelongtokenwin8appnamelongmdmd-ui-controls"></a>再利用可能な [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] UI コントロール  
+ 関連する UI コントロールのセットを再利用可能な [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントにパッケージ化できます。 コンポーネントは、単独で商品化することも、作成するアプリの要素として使用することもできます。 このシナリオは、使用する、 [!INCLUDE[wrt](../../../includes/wrt-md.md)] [VersionAttribute](http://go.microsoft.com/fwlink/p/?LinkId=238563)互換性を向上させる属性です。  
+  
+### <a name="reusable-application-logic-from-existing-net-framework-apps"></a>既存の .NET Framework アプリからの再利用可能なアプリケーション ロジック  
+ 既存のデスクトップ アプリからマネージ コードをスタンドアロンの [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントとしてパッケージ化できます。 これによって、C# または Visual Basic を使用してビルドされる [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリに加えて、C++ または JavaScript を使用してビルドされる [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでも、コンポーネントを使用できるようになります。 コードに再利用シナリオが複数ある場合、バージョン管理はオプションです。  
+  
+## <a name="related-topics"></a>関連トピック  
+  
+|タイトル|説明|  
+|-----------|-----------------|  
+|[.NET Windows ストア アプリの概要](http://go.microsoft.com/fwlink/p/?LinkId=238312)|[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリと [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントの作成に使用できる .NET Framework の型およびメンバーについて説明します  (Windows デベロッパー センター内)。|  
+|[C# または Visual Basic を使った Windows ストア アプリのロードマップ](http://go.microsoft.com/fwlink/p/?LinkId=242212)|C# または Visual Basic を使用して [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリの開発を開始するときに役立つ主要リソース (各種のクイック スタート トピック、ガイドライン、ベスト プラクティスなど) が用意されています  (Windows デベロッパー センター内)。|  
+|[Windows ストア アプリの開発 (VB/c# または C++ と XAML)](http://go.microsoft.com/fwlink/p/?LinkId=238311)|C# または Visual Basic を使用して [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリの開発を開始するときに役立つ主要リソース (各種のクイック スタート トピック、ガイドライン、ベスト プラクティスなど) が用意されています  (Windows デベロッパー センター内)。|  
+|[C# および Visual Basic での Windows ランタイム コンポーネントの作成](http://go.microsoft.com/fwlink/p/?LinkId=238313)|.NET Framework を使用して [!INCLUDE[wrt](../../../includes/wrt-md.md)] コンポーネントを作成する方法、JavaScript を使用して Windows 用にビルドされた [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリの一部としてそのコンポーネントを使用する方法、Visual Studio との組み合わせをデバッグする方法について説明します  (Windows デベロッパー センター内)。|  
+|[Windows ランタイムのリファレンス](http://go.microsoft.com/fwlink/?LinkId=238319)|[!INCLUDE[wrt](../../../includes/wrt-md.md)]のリファレンス ドキュメント  (Windows デベロッパー センター内)。|  
+|[Windows ランタイムへの URI の引き渡し](../../../docs/standard/cross-platform/passing-a-uri-to-the-windows-runtime.md)|マネージ コードから [!INCLUDE[wrt](../../../includes/wrt-md.md)]に URI を渡すときに発生する可能性がある問題と、その回避方法について説明します。|
\ No newline at end of file
diff --git a/docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md b/docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md
new file mode 100644
index 00000000000..ba82221b021
--- /dev/null
+++ b/docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md
@@ -0,0 +1,99 @@
+---
+title: "Model-View-View Model を利用した汎用性のあるクラス ライブラリの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "汎用性のあるクラス ライブラリ [.NET Framework]、および MVVM"
+  - "MVVM、および汎用性のあるクラス ライブラリ"
+ms.assetid: 41a0b9f8-15a2-431a-bc35-e310b2953b03
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Model-View-View Model を利用した汎用性のあるクラス ライブラリの使用
+Model\-View\-View Model \(MVVM\) パターンを実装し、複数のプラットフォーム間でアセンブリを共有するには、.NET Framework [ポータブル クラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md) を使用できます。  
+  
+ MVVM は、基になるビジネス ロジックからのユーザー インターフェイスを分離するアプリケーション パターンです。  [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)]の [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] のプロジェクトのモデルおよびビュー モデル クラスを実装し、異なるプラットフォーム用にカスタマイズされたビューを作成します。  この方法は一度だけデータ モデルおよびビジネス ロジックを記述できるようになり、次の図に示すように、.NET Framework、Silverlight、Windows Phone、および [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] のアプリケーションからのコードを使用します。  
+  
+ ![MVVM を使用したポータブルのダイアグラム](../../../docs/standard/cross-platform/media/portablemvvmdiagram.png "PortableMVVMdiagram")  
+  
+ このトピックには MVVM パターンに関する一般的な情報は含まれていません。  [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] を使用して MVVM を実装する方法についてのみ説明します。  MVVM の詳細については、MSDN [MVVM Quickstart](http://go.microsoft.com/fwlink/?LinkId=234934) ライブラリを参照します。  
+  
+## MVVM をサポートしているクラス  
+ [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトに対し、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)]、Silverlight、または Windows Phone 7.5 を対象とする場合は、MVVM パターンの実装に次のクラスを使用できます。  
+  
+-   <xref:System.Collections.ObjectModel.ObservableCollection%601?displayProperty=fullName> クラス  
+  
+-   <xref:System.Collections.ObjectModel.ReadOnlyObservableCollection%601?displayProperty=fullName> クラス  
+  
+-   <xref:System.Collections.Specialized.INotifyCollectionChanged?displayProperty=fullName> クラス  
+  
+-   <xref:System.Collections.Specialized.NotifyCollectionChangedAction?displayProperty=fullName> クラス  
+  
+-   <xref:System.Collections.Specialized.NotifyCollectionChangedEventArgs?displayProperty=fullName> クラス  
+  
+-   <xref:System.Collections.Specialized.NotifyCollectionChangedEventHandler?displayProperty=fullName> クラス  
+  
+-   <xref:System.ComponentModel.DataErrorsChangedEventArgs?displayProperty=fullName> クラス  
+  
+-   <xref:System.ComponentModel.INotifyDataErrorInfo?displayProperty=fullName> クラス  
+  
+-   <xref:System.ComponentModel.INotifyPropertyChanged?displayProperty=fullName> クラス  
+  
+-   <xref:System.Windows.Input.ICommand?displayProperty=fullName> クラス  
+  
+-   <xref:System.ComponentModel.DataAnnotations?displayProperty=fullName> 名前空間のすべてのクラス  
+  
+## MVVM の実装  
+ MVVM を実装するには、通常はモデルとビュー モデルの両方を [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクト内に作成します。[!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトは非移植性のプロジェクトを参照できないためです。  モデルおよびビュー モデルは、同じプロジェクトに含めることも、個別のプロジェクトに含めることもできます。  異なるプロジェクトを使用する場合は、ビュー モデル プロジェクトからの参照をモデル プロジェクトに追加します。  
+  
+ モデルおよびビュー モデルのプロジェクトをコンパイルした後は、ビューを含むアプリケーションでこれらのアセンブリを参照します。  ビューがビュー モデルのみと対話する場合は、ビュー モデルを含むアセンブリを参照するだけで済みます。  
+  
+### モデル  
+ 次の例は、[!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトに含めることのできる簡易モデル クラスを示しています。  
+  
+ [!code-csharp[PortableClassLibraryMVVM#1](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/customer.cs#1)]
+ [!code-vb[PortableClassLibraryMVVM#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/portableclasslibrarymvvm/vb/customer.vb#1)]  
+  
+ 以下に、[!INCLUDE[net_portable](../../../includes/net-portable-md.md)] プロジェクトでのデータの挿入、取得、および更新の簡単な方法例を示します。  実際のアプリケーションでは、データは Windows Communication Foundation \(WCF\) サービスなどのソースから取得します。  
+  
+ [!code-csharp[PortableClassLibraryMVVM#2](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/customerrepository.cs#2)]
+ [!code-vb[PortableClassLibraryMVVM#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/portableclasslibrarymvvm/vb/customerrepository.vb#2)]  
+  
+### ビュー モデル  
+ ビュー モデルの基本クラスは MVVM パターンの実装時に追加されることがよくあります。  基本クラスの例を次に示します。  
+  
+ [!code-csharp[PortableClassLibraryMVVM#3](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/viewmodelbase.cs#3)]
+ [!code-vb[PortableClassLibraryMVVM#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/portableclasslibrarymvvm/vb/viewmodelbase.vb#3)]  
+  
+ MVVM パターンでは <xref:System.Windows.Input.ICommand> インターフェイスの実装がよく使用されます。  <xref:System.Windows.Input.ICommand> インターフェイスを実装する例を次に示します。  
+  
+ [!code-csharp[PortableClassLibraryMVVM#4](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/relaycommand.cs#4)]
+ [!code-vb[PortableClassLibraryMVVM#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/portableclasslibrarymvvm/vb/relaycommand.vb#4)]  
+  
+ 簡易ビュー モデルの例を次に示します。  
+  
+ [!code-csharp[PortableClassLibraryMVVM#5](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/mainpageviewmodel.cs#5)]
+ [!code-vb[PortableClassLibraryMVVM#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/portableclasslibrarymvvm/vb/customerviewmodel.vb#5)]  
+  
+### ビュー  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] アプリケーション、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーション、Silverlight ベースのアプリケーション、または Windows Phone 7.5 アプリケーションでは、モデルおよびビュー モデルのプロジェクトを含むアセンブリを参照できます。次に、ビュー モデルと対話するビューを作成します。  次の例では、ビュー モデルからデータを取得し、更新する簡易 Windows Presentation Foundation \(WPF\) アプリケーションを示します。  似たようなビューは Silverlight、Windows Phone、または [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリケーションでも作成できます。  
+  
+ [!code-xml[PortableClassLibraryMVVM#6](../../../samples/snippets/csharp/VS_Snippets_CLR/portableclasslibrarymvvm/cs/mainwindow.xaml#6)]  
+  
+## 参照  
+ [汎用性のあるクラス ライブラリ](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md)
\ No newline at end of file
diff --git a/docs/standard/cross-platform/windowsruntimestreamextensions-asrandomaccessstream-method.md b/docs/standard/cross-platform/windowsruntimestreamextensions-asrandomaccessstream-method.md
new file mode 100644
index 00000000000..56f6e000037
--- /dev/null
+++ b/docs/standard/cross-platform/windowsruntimestreamextensions-asrandomaccessstream-method.md
@@ -0,0 +1,75 @@
+---
+title: "WindowsRuntimeStreamExtensions.AsRandomAccessStream(System.IO.Stream) メソッド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+apiname: 
+  - "System.IO.WindowsRuntimeStreamExtensions.AsRandomAccessStream"
+apilocation: 
+  - "System.Runtime.WindowsRuntime.dll"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: dcc72283-caed-49ee-b45d-ccaf94e97129
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# WindowsRuntimeStreamExtensions.AsRandomAccessStream(System.IO.Stream) メソッド
+\[.NET Framework 4.5.1 以上でサポート\]  
+  
+ 特定のストリームをランダム アクセス ストリームに変換します。  
+  
+ **名前空間**: <xref:System.IO?displayProperty=fullName>   
+ **アセンブリ**: System.Runtime.WindowsRuntime \(System.Runtime.WindowsRuntime.dll 内\)  
+  
+## 構文  
+  
+```csharp  
+[CLSCompliantAttribute(false)] public static  IRandomAccessStream AsRandomAccessStream(Stream stream)   
+```  
+  
+```vb  
+'Declaration <ExtensionAttribute> _ <CLSCompliantAttribute(False)> _ Public Shared Function AsRandomAccessStream ( _         stream As Stream) As IRandomAccessStream   
+```  
+  
+#### パラメーター  
+ `stream`  
+  
+ 型: <xref:System.IO.Stream?displayProperty=fullName>   
+ 変換するストリーム。  
+  
+## 戻り値  
+ 型: [Windows.Storage.Streams.RandomAccessStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.randomaccessstream.aspx)   
+ 変換されたストリームを表す [!INCLUDE[wrt](../../../includes/wrt-md.md)] ランダム アクセス、ストリーム。  
+  
+## 例外  
+  
+|例外|状態|  
+|--------|--------|  
+|<xref:System.NotSupportedException>|変換するストリームがシークをサポートしていません。|  
+  
+## 解説  
+ この拡張メソッドは、Windows ストア アプリを開発する場合のみに使用できます。  このメソッドは、Windows ストア アプリのストリームを使用する便利な方法を提供します。  変換する .NET Framework ストリームはシークをサポートする必要があります。  詳細については、<xref:System.IO.Stream.Seek%2A?displayProperty=fullName> メソッドを参照してください。  
+  
+> [!IMPORTANT]
+>  この API は .NET Framework 4.5.1 以上ではサポートされますが、Version 4.5 ではサポートされません。  
+  
+## バージョン情報  
+ **Windows ストア アプリ用 .NET**  
+  
+ Windows 8.1 でサポート  
+  
+## 参照  
+ <xref:System.IO.WindowsRuntimeStreamExtensions>   
+ [方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う](../../../docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/TOC.md b/docs/standard/data/xml/TOC.md
new file mode 100644
index 00000000000..50b4206ca9e
--- /dev/null
+++ b/docs/standard/data/xml/TOC.md
@@ -0,0 +1,126 @@
+# [保持されずに展開されるエンティティ参照](entity-references-are-expanded-and-not-preserved.md)
+# [XSLT のセキュリティに関する考慮事項](xslt-security-considerations.md)
+# [XSLT パラメーター](xslt-parameters.md)
+# [XML スキーマのインクルードまたはインポート](including-or-importing-xml-schemas.md)
+# [msxsl:script を使用したスクリプト ブロック](script-blocks-using-msxsl-script.md)
+# [XML スキーマの編集](editing-xml-schemas.md)
+# [XslCompiledTransform クラスの使用](using-the-xslcompiledtransform-class.md)
+# [XML とリレーショナル データおよび ADO.NET との統合](xml-integration-with-relational-data-and-adonet.md)
+# [XML ドキュメントからのスキーマの推論](inferring-schemas-from-xml-documents.md)
+# [DOM における名前空間のサポート](namespace-support-in-the-dom.md)
+# [XPath クエリおよび名前空間](xpath-queries-and-namespaces.md)
+# [XML ドキュメントと XML データ](index.md)
+# [XPathNavigator によるノードの一致](matching-nodes-using-xpathnavigator.md)
+# [コンパイルされた XPath 式](compiled-xpath-expressions.md)
+# [XSLT スタイル シートの拡張](extending-xslt-style-sheets.md)
+# [変換での結果ツリー フラグメントの処理](result-tree-fragment-in-transformations.md)
+# [スタイル シート パラメーターと拡張オブジェクト用の XsltArgumentList](xsltargumentlist-for-style-sheet-parameters-and-extension-objects.md)
+# [DOM の要素に対する新しい属性の作成](creating-new-attributes-for-elements-in-the-dom.md)
+# [.NET Framework 型の文字列への変換](converting-dotnet-types-to-strings.md)
+# [XML ドキュメントからのノード、コンテンツ、値の削除](removing-nodes-content-and-values-from-an-xml-document.md)
+# [ドキュメントに埋め込まれたスタイル シート ディレクティブ](style-sheet-directives-embedded-in-a-document.md)
+# [スキーマのノード型および構造を推論するときの規則](rules-for-inferring-schema-node-types-and-structure.md)
+# [名前空間プレフィックス プロパティの変更](changing-namespace-prefix-properties.md)
+# [XslTransform クラスの随意動作の実装](implementation-of-discretionary-behaviors-in-the-xsltransform-class.md)
+# [msxsl:node-set() 関数のサポート](support-for-the-msxsl-node-set-function.md)
+# [ドキュメント フラグメントのコピー](copying-document-fragments.md)
+# [DOM の属性へのアクセス](accessing-attributes-in-the-dom.md)
+# [XML スキーマの走査](traversing-xml-schemas.md)
+# [XML データ型から CLR 型へのマッピング](mapping-xml-data-types-to-clr-types.md)
+# [XPathNavigator による XML データへのアクセス](accessing-xml-data-using-xpathnavigator.md)
+# [XPathNavigator を使用した XML データの選択](select-xml-data-using-xpathnavigator.md)
+# [XML スキーマの使用](working-with-xml-schemas.md)
+# [XML ドキュメント オブジェクト モデル (DOM)](xml-document-object-model-dom.md)
+# [XML スキーマの読み取りと書き込み](reading-and-writing-xml-schemas.md)
+# [DOM の拡張](extending-the-dom.md)
+# [新しいノードの作成時における XML 要素名および属性名の検証](xml-element-and-attribute-name-verification-when-creating-new-nodes.md)
+# [XPathNavigator による XML データの編集](editing-xml-data-using-xpathnavigator.md)
+# [XML スキーマの推論](inferring-an-xml-schema.md)
+# [外部リソースの解決](resolving-external-resources.md)
+# [XmlSchemaCollection を使用した XML スキーマ (XSD) 検証](xml-schema-xsd-validation-with-xmlschemacollection.md)
+# [変換におけるノード セット](node-sets-in-transformations.md)
+# [XML スキーマ オブジェクト モデル (SOM)](xml-schema-object-model-som.md)
+# [XML ドキュメントの DOM への読み取り](reading-an-xml-document-into-the-dom.md)
+# [XSLT 拡張オブジェクト](xslt-extension-objects.md)
+# [新しいエンティティ参照の作成](creating-new-entity-references.md)
+# [XML データ型の変換](conversion-of-xml-data-types.md)
+# [XML ドキュメントの名前空間宣言の変更](changing-namespace-declarations-in-an-xml-document.md)
+# [XslTransform への XmlDataDocument の入力](xmldatadocument-input-to-xsltransform.md)
+# [XPathNavigator による XML データの削除](remove-xml-data-using-xpathnavigator.md)
+# [XML ドキュメント オブジェクト モデル (DOM) の階層構造](xml-document-object-model-dom-hierarchy.md)
+# [XslTransform への XmlDocument の入力](xmldocument-input-to-xsltransform.md)
+# [XslTransform クラスからの移行](migrating-from-the-xsltransform-class.md)
+# [外部の XSLT スタイル シートとドキュメントの解決](resolving-external-xslt-style-sheets-and-documents.md)
+# [XslCompiledTransform クラスの出力オプション](output-options-on-the-xslcompiledtransform-class.md)
+# [XmlSchemaValidator のプッシュ ベースの検証](xmlschemavalidator-push-based-validation.md)
+# [方法 : XslTransform コードを移行する](how-to-migrate-your-xsltransform-code.md)
+# [XPath ナビゲーションによるノードの選択](select-nodes-using-xpath-navigation.md)
+# [XslTransform からの出力](outputs-from-an-xsltransform.md)
+# [XmlNameTable によるオブジェクトの比較](object-comparison-using-xmlnametable.md)
+# [XML スキーマの作成](building-xml-schemas.md)
+# [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](accessing-strongly-typed-xml-data-using-xpathnavigator.md)
+# [XML スキーマ オブジェクト モデルの概要](xml-schema-object-model-overview.md)
+# [XML ドキュメントへのノードの挿入](inserting-nodes-into-an-xml-document.md)
+# [XML ドキュメントの作成](xml-document-creation.md)
+# [エンティティ宣言とエンティティ参照の DOM への読み込み](reading-entity-declarations-and-entity-references-into-the-dom.md)
+# [XslCompiledTransform クラスへの入力](inputs-to-the-xslcompiledtransform-class.md)
+# [XPathNavigator を使用したスキーマ検証](schema-validation-using-xpathnavigator.md)
+# [スキーマのコンパイル後の情報セット](post-schema-compilation-infoset.md)
+# [DOM の要素ノードからの属性の削除](removing-attributes-from-an-element-node-in-the-dom.md)
+# [リーダーからのデータの読み込み](load-data-from-a-reader.md)
+# [XslTransform への XPathDocument の入力](xpathdocument-input-to-xsltransform.md)
+# [XmlSchemaCollection スキーマのコンパイル](xmlschemacollection-schema-compilation.md)
+# [方法 : アセンブリを使用して XSLT 変換を実行する](how-to-perform-an-xslt-transformation-by-using-an-assembly.md)
+# [NodeLists および NamedNodeMaps の動的更新](dynamic-updates-to-nodelists-and-namednodemaps.md)
+# [XML ドキュメントのノード、コンテンツ、値の変更](modifying-nodes-content-and-values-in-an-xml-document.md)
+# [方法 : ノード フラグメントを変換する](how-to-transform-a-node-fragment.md)
+# [XML ノードの種類](types-of-xml-nodes.md)
+# [DOM への新しいノードの作成](create-new-nodes-in-the-dom.md)
+# [XML ドキュメントでの名前空間の管理](managing-namespaces-in-an-xml-document.md)
+# [XSLT コンパイラ (xsltc.exe)](xslt-compiler-xsltc-exe.md)
+# [文字列の .NET Framework データ型への変換](converting-strings-to-dotnet-data-types.md)
+# [要素と属性を含む新しいノードでのエンティティ参照の展開に対する名前空間の影響](namespace-affect-on-entity-ref-expansion-for-new-nodes.md)
+# [System.Xml クラスでの型のサポート](type-support-in-the-system-xml-classes.md)
+# [DOM のノード コンテンツの削除](removing-node-content-in-the-dom.md)
+# [<msxsl:script> を使用した XSLT スタイルシートのスクリプト](xslt-stylesheet-scripting-using-msxsl-script.md)
+# [XPathDocument および XmlDocument を使用した XML データの読み取り](reading-xml-data-using-xpathdocument-and-xmldocument.md)
+# [DOM モデルを使用した XML データの処理](process-xml-data-using-the-dom-model.md)
+# [スキーマをコンパイルするための XmlSchemaSet](xmlschemaset-for-schema-compilation.md)
+# [インデックスによる順序付けられたノードの取得](ordered-node-retrieval-by-index.md)
+# [XPath データ モデルを使用した XML データの処理](process-xml-data-using-the-xpath-data-model.md)
+# [XslTransform クラスを使用した XSLT 変換](xslt-transformations-with-the-xsltransform-class.md)
+# [XSLT エラーの解決](recoverable-xslt-errors.md)
+# [ユーザー定義の関数と変数](user-defined-functions-and-variables.md)
+# [XPathNavigator を使用した XML データの選択、評価、および照合](selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)
+# [オブジェクト階層の XML データへのマップ](mapping-the-object-hierarchy-to-xml-data.md)
+# [ドキュメント間での既存のノードのコピー](copying-existing-nodes-from-one-document-to-another.md)
+# [XSLT 処理中の外部リソースの解決](resolving-external-resources-during-xslt-processing.md)
+# [単純型を推論するときの規則](rules-for-inferring-simple-types.md)
+# [異なるストアでの XSLT 変換](xslt-transformations-over-different-stores.md)
+# [XmlSchemaSet による XML スキーマ (XSD) 検証](xml-schema-xsd-validation-with-xmlschemaset.md)
+# [XML の処理オプション](xml-processing-options.md)
+# [XPathNavigator による XML データの挿入](insert-xml-data-using-xpathnavigator.md)
+# [DOM における XML ドキュメントの検証](validating-an-xml-document-in-the-dom.md)
+# [変換における XPathNodeIterator](xpathnodeiterator-in-transformations.md)
+# [既存のノードのコピー](copy-existing-nodes.md)
+# [XPathNavigator による Xpath 式の評価](evaluate-xpath-expressions-using-xpathnavigator.md)
+# [XML 型サポートの実装に関するメモ](xml-type-support-implementation-notes.md)
+# [XPathNavigator を使用する属性と名前空間のナビゲーション](attribute-and-namespace-node-navigation-using-xpathnavigator.md)
+# [名前またはインデックスによる順序付けられていないノードの取得](unordered-node-retrieval-by-name-or-index.md)
+# [XSLT 変換](xslt-transformations.md)
+# [DOM における名前空間と DTD](namespaces-and-dtds-in-the-dom.md)
+# [XPath クエリで認識されるノード型](node-types-recognized-with-xpath-queries.md)
+# [メモリ内の XML データの処理](processing-xml-data-in-memory.md)
+# [DOM を読み込むときの空白および有意の空白の処理](white-space-and-significant-white-space-handling-when-loading-the-dom.md)
+# [XPathNavigator を使用するノード セットのナビゲーション](node-set-navigation-using-xpathnavigator.md)
+# [変換における XPathNavigator](xpathnavigator-in-transformations.md)
+# [XmlNodeChangedEventArgs による XML ドキュメントのイベント処理](event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md)
+# [DOM からのノードの削除](removing-nodes-from-the-dom.md)
+# [ドキュメントの保存と書き込み](saving-and-writing-a-document.md)
+# [XpathNavigator を使用した XML データの抽出](extract-xml-data-using-xpathnavigator.md)
+# [XPath 名前空間のナビゲーション](xpath-namespace-navigation.md)
+# [LINQ to XML を使用した XML データの処理](process-xml-data-using-linq-to-xml.md)
+# [XpathNavigator による XML データの変更](modify-xml-data-using-xpathnavigator.md)
+# [NamedNodeMaps と NodeLists のノード コレクション](node-collections-in-namednodemaps-and-nodelists.md)
+# [XmlSchemaCollection を使用した XDR 検証](xdr-validation-with-xmlschemacollection.md)
+# [保持されるエンティティ参照](entity-references-are-preserved.md)
diff --git a/docs/standard/data/xml/accessing-attributes-in-the-dom.md b/docs/standard/data/xml/accessing-attributes-in-the-dom.md
new file mode 100644
index 00000000000..0455fa02e4f
--- /dev/null
+++ b/docs/standard/data/xml/accessing-attributes-in-the-dom.md
@@ -0,0 +1,270 @@
+---
+title: "DOM の属性へのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ce2df341-a1a4-4e97-8e1b-cd45b8e3e71e
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM の属性へのアクセス
+属性は要素のプロパティであり、要素の子ではありません。  この区別は、XML ドキュメント オブジェクト モデル \(DOM\) の兄弟ノード、親ノード、および子ノードの間の移動に使用するメソッドで重要な意味を持ちます。  たとえば、**PreviousSibling** メソッドと **NextSibling** メソッドは、要素から属性への移動や属性間の移動には使われません。  属性は要素のプロパティであり、要素によって所有されているため、**OwnerElement** プロパティを持ちますが、**parentNode** プロパティはありません。また、移動には専用のメソッドを使います。  
+  
+ 現在のノードが要素のとき、その要素に関連付けられている属性があるかどうかを調べるには、**HasAttribute** メソッドを使用します。  要素に属性がある場合は、各種のメソッドで属性にアクセスできます。  **XmlElement** の **GetAttribute** メソッドと **GetAttributeNode** メソッドを使用して要素から 1 つの属性を取得するか、すべての属性をコレクションとして取得することができます。  コレクションに対して反復処理を行う必要がある場合は、コレクションを取得すると便利です。  要素のすべての属性が必要な場合は、要素の **Attributes** プロパティを使用して、すべての属性をコレクションに取得できます。  
+  
+## コレクションへのすべての属性の取得  
+ 要素ノードのすべての属性をコレクションに取得するには、**XmlElement.Attributes** プロパティを呼び出します。  **XmlElement.Attributes** プロパティにより、要素のすべての属性を含む **XmlAttributeCollection** を取得できます。  **XmlAttributeCollection** クラスは **XmlNamedNode** マップから継承されます。  このため、コレクションで使用できるメソッドとプロパティには、**ItemOf** プロパティや **Append** メソッドのような **XmlAttributeCollection** クラスに固有のメソッドやプロパティだけでなく、名前付きノード マップで使用できるメソッドとプロパティも含まれます。  属性コレクション内の各項目は、**XmlAttribute** ノードを表します。  要素の属性の数を調べるには、**XmlAttributeCollection** を取得し、**Count** プロパティを使用して、そのコレクションに含まれる **XmlAttribute** ノードの数を調べます。  
+  
+ 属性コレクションを取得し、**Count** メソッドをループ インデックスとして使用して、コレクションに対して反復処理を行うコード サンプルを次に示します。  このコードは、その後、コレクションから属性を 1 つ取得して、その値を表示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+Public Class Sample  
+  
+    Public Shared Sub Main()  
+  
+        Dim doc As XmlDocument = New XmlDocument()  
+        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _  
+               "<title>The Handmaid's Tale</title>" & _  
+               "<price>14.95</price>" & _  
+               "</book>")  
+  
+        ' Move to an element.   
+        Dim myElement As XmlElement = doc.DocumentElement  
+  
+        ' Create an attribute collection from the element.  
+        Dim attrColl As XmlAttributeCollection = myElement.Attributes  
+  
+        ' Show the collection by iterating over it.  
+        Console.WriteLine("Display all the attributes in the collection...")  
+        Dim i As Integer  
+        For i = 0 To attrColl.Count - 1  
+            Console.Write("{0} = ", attrColl.ItemOf(i).Name)  
+            Console.Write("{0}", attrColl.ItemOf(i).Value)  
+            Console.WriteLine()  
+        Next  
+  
+        ' Retrieve a single attribute from the collection; specifically, the  
+        ' attribute with the name "misc".  
+        Dim attr As XmlAttribute = attrColl("misc")  
+  
+        ' Retrieve the value from that attribute.  
+        Dim miscValue As String = attr.InnerXml  
+  
+        Console.WriteLine("Display the attribute information.")  
+        Console.WriteLine(miscValue)  
+  
+    End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+  
+    public static void Main()  
+    {  
+        XmlDocument doc = new XmlDocument();  
+        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" +  
+                      "<title>The Handmaid's Tale</title>" +  
+                      "<price>14.95</price>" +  
+                      "</book>");  
+  
+        // Move to an element.  
+        XmlElement myElement = doc.DocumentElement;  
+  
+        // Create an attribute collection from the element.  
+        XmlAttributeCollection attrColl = myElement.Attributes;  
+  
+        // Show the collection by iterating over it.  
+        Console.WriteLine("Display all the attributes in the collection...");  
+        for (int i = 0; i < attrColl.Count; i++)  
+        {  
+            Console.Write("{0} = ", attrColl[i].Name);  
+            Console.Write("{0}", attrColl[i].Value);  
+            Console.WriteLine();  
+        }  
+  
+        // Retrieve a single attribute from the collection; specifically, the  
+        // attribute with the name "misc".  
+        XmlAttribute attr = attrColl["misc"];  
+  
+        // Retrieve the value from that attribute.  
+        String miscValue = attr.InnerXml;  
+  
+        Console.WriteLine("Display the attribute information.");  
+        Console.WriteLine(miscValue);  
+  
+    }  
+}  
+```  
+  
+ この例を実行すると、次の出力が表示されます。  
+  
+ **出力**  
+  
+ コレクション内のすべての属性を表示します。  
+  
+```  
+genre = novel  
+ISBN = 1-861001-57-5  
+misc = sale item  
+Display the attribute information.  
+sale item  
+```  
+  
+ 属性コレクションの情報は、名前またはインデックス番号によって取得できます。  上の例では、名前を指定してデータを取得しています。  次の例では、インデックス番号を指定してデータを取得します。  
+  
+ **XmlAttributeCollection** はコレクションであり、名前またはインデックスを使って反復処理ができるため、次の例では、ゼロベースのインデックスを使用してコレクションの最初の属性を選択しています。入力には、**baseuri.xml** というファイルを使用しています。  
+  
+### 入力  
+  
+```  
+<!-- XML fragment -->  
+<book genre="novel">  
+  <title>Pride And Prejudice</title>  
+</book>  
+```  
+  
+```vb  
+Option Explicit On  
+Option Strict On  
+  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+Public Class Sample  
+  
+    Public Shared Sub Main()  
+        ' Create the XmlDocument.  
+        Dim doc As New XmlDocument()  
+        doc.Load("http://localhost/baseuri.xml")  
+  
+        ' Display information on the attribute node. The value  
+        ' returned for BaseURI is 'http://localhost/baseuri.xml'.  
+        Dim attr As XmlAttribute = doc.DocumentElement.Attributes(0)  
+        Console.WriteLine("Name of the attribute:  {0}", attr.Name)  
+        Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI)  
+        Console.WriteLine("The value of the attribtue:  {0}", attr.InnerText)  
+    End Sub 'Main   
+End Class 'Sample  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+  public static void Main()  
+  {  
+    // Create the XmlDocument.  
+    XmlDocument doc = new XmlDocument();  
+  
+    doc.Load("http://localhost/baseuri.xml");  
+  
+    // Display information on the attribute node. The value  
+    // returned for BaseURI is 'http://localhost/baseuri.xml'.  
+    XmlAttribute attr = doc.DocumentElement.Attributes[0];  
+    Console.WriteLine("Name of the attribute:  {0}", attr.Name);  
+    Console.WriteLine("Base URI of the attribute:  {0}", attr.BaseURI);  
+    Console.WriteLine("The value of the attribtue:  {0}", attr.InnerText);  
+  }  
+}  
+```  
+  
+## 個別の属性ノードの取得  
+ 要素から属性ノードを 1 つ取得するには、<xref:System.Xml.XmlElement.GetAttributeNode%2A?displayProperty=fullName> メソッドを使用します。  このメソッドは、**XmlAttribute** 型のオブジェクトを返します。  **XmlAttribute** の取得後は、[XmlAttribute](frlrfsystemxmlxmlattributeclasstopic) クラスのすべてのメソッドとプロパティを使用できます。たとえば、**OwnerElement** で、どの要素に所属しているかを調べることができます。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+Public Class Sample  
+  
+    Public Shared Sub Main()  
+  
+        Dim doc As XmlDocument = New XmlDocument()  
+        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5' misc='sale item'>" & _  
+               "<title>The Handmaid's Tale</title>" & _  
+               "<price>14.95</price>" & _  
+               "</book>")  
+  
+        ' Move to an element.  
+        Dim root As XmlElement  
+        root = doc.DocumentElement  
+  
+        ' Get an attribute.  
+        Dim attr As XmlAttribute  
+        attr = root.GetAttributeNode("ISBN")  
+  
+        ' Display the value of the attribute.  
+        Dim attrValue As String  
+        attrValue = attr.InnerXml  
+        Console.WriteLine(attrValue)  
+  
+    End Sub  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+ public class Sample  
+ {  
+      public static void Main()  
+      {  
+    XmlDocument doc = new XmlDocument();  
+     doc.LoadXml("<book genre='novel' ISBN='1-861003-78' misc='sale item'>" +  
+                   "<title>The Handmaid's Tale</title>" +  
+                   "<price>14.95</price>" +  
+                   "</book>");   
+  
+    // Move to an element.  
+     XmlElement root = doc.DocumentElement;  
+  
+    // Get an attribute.  
+     XmlAttribute attr = root.GetAttributeNode("ISBN");  
+  
+    // Display the value of the attribute.  
+     String attrValue = attr.InnerXml;  
+     Console.WriteLine(attrValue);  
+  
+    }  
+}  
+```  
+  
+ 前の例で示したように、属性コレクションから 1 つの属性ノードを取得することもできます。  インデックス番号を指定して、XML ドキュメント ツリーのルートから 1 つの属性を取得する処理を 1 行で記述したコード サンプルを次に示します。**DocumentElement** プロパティを使用します。  
+  
+```  
+XmlAttribute attr = doc.DocumentElement.Attributes[0];  
+```  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..a07f7ec851a
--- /dev/null
+++ b/docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md
@@ -0,0 +1,202 @@
+---
+title: "厳密に型指定された XML データへの XPathNavigator を使用したアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 898e0f52-8a7c-4d1f-afcd-6ffb28b050b4
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 厳密に型指定された XML データへの XPathNavigator を使用したアクセス
+XPath 2.0 データ モデルの一例として、<xref:System.Xml.XPath.XPathNavigator> クラスは、共通言語ランタイム \(CLR\) 型に対応した厳密に型指定されたデータを含むことができます。  XPath 2.0 のデータ モデルに従い、要素と属性のみが厳密に型指定されたデータを含むことができます。  <xref:System.Xml.XPath.XPathNavigator> クラスは、データ型を変換する機構に加えて、厳密に型指定されたデータとして <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のデータにアクセスする機構を提供します。  
+  
+## XPathNavigator が公開する型情報  
+ DTD、XML スキーマ定義言語 \(XSD\) のスキーマ、または他の機構を使用して処理しない限り、XML 1.0 データに型はありません。  XML 要素や属性と関連付けられる型情報のカテゴリは多数あります。  
+  
+-   単純 CLR 型 : XML スキーマ言語で共通言語ランタイム \(CLR\) 型を直接サポートするものはありません。  要素や属性の単純コンテンツを最適な CLR 型として見ることができると便利なので、コンテンツをさらに適切な型に細分化する追加のスキーマ情報がない場合、すべての単純コンテンツは <xref:System.String> として型指定できます。  <xref:System.Xml.XPath.XPathNavigator.ValueType%2A> プロパティを使用することにより、要素と属性の単純コンテンツに最も一致する CLR 型を見つけることができます。  スキーマの組み込み型から CLR 型への対応の詳細については、「[System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)」を参照してください。  
+  
+-   単純 \(CLR\) 型のリスト : 単純コンテンツを持つ要素と属性には、空白で区切られた値のリストを含めることができます。  値は XML スキーマで "リスト型" として指定します。XML スキーマがない場合、こうした単純型は 1 つのテキスト ノードとして取り扱われます。  XML スキーマが使用可能な場合、この単純コンテンツは、各項が CLR オブジェクトの 1 つのコレクションに対応した単純型を持つ、これ以上分割不可能な一連の値として取り扱うことができます。  スキーマの組み込み型から CLR 型への対応の詳細については、「[System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)」を参照してください。  
+  
+-   型指定された値 : スキーマにより検証された単純型の属性と要素は、型指定された値を持ちます。  この値は、数値型、文字列型、または日付型などのプリミティブ型です。  XSD のすべての組み込みの単純型は、単に <xref:System.String> としてでなく、さらに適当な型としてノードの値にアクセスできる CLR 型と対応をとることができます。  属性や子要素を持つ要素は複合型と考えられます。  単純コンテンツ \(子としてテキスト ノードのみ\) を持つ複合型の型指定された値は、そのコンテンツの単純型のそれと同じです。  複合コンテンツ \(1 つ以上の子要素\) を持つ複合型の型指定された値は、<xref:System.String> として返されたすべての子テキスト ノードの連結された文字列値です。  スキーマの組み込み型から CLR 型への対応の詳細については、「[System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)」を参照してください。  
+  
+-   スキーマ言語固有の型名 : 多くの場合、ノードの値へのアクセスに使用されるのは \(外部スキーマを適用したため設定された\) CLR 型です。  しかし、XML ドキュメントに適用された特定のスキーマに関連付けられた型を調べる必要がある場合もあります。  たとえば、XML ドキュメントを検索して、添付されたスキーマに従って "PurchaseOrder" 型の内容を持つすべての要素を抽出したいが場合があります。  このような型情報はスキーマ検証の結果としてのみ設定され、この情報には <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.XmlType%2A> プロパティと <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティを通じてアクセスできます。  詳細については、下の「スキーマ検証後の情報セット \(PSVI\)」のセクションを参照してください。  
+  
+-   スキーマ言語固有の型のリフレクション : また、XML ドキュメントに適用されたスキーマ固有の型の詳細をさらに取得する必要が生じる場合があります。  たとえば、何か特別な計算をするために、XML ファイルの読み込み中に XML ドキュメント中の有効な各ノードについて `maxOccurs` 属性を抽出する必要がある場合があります。  この情報はスキーマ検証を通じてのみ設定されるので、<xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティを通じてアクセスされます。  詳細については、下の「スキーマ検証後の情報セット \(PSVI\)」のセクションを参照してください。  
+  
+## XPathNavigator の型指定されたアクセサー  
+ 次の表に、ノードの型情報へのアクセスに使用できる <xref:System.Xml.XPath.XPathNavigator> クラスの各種プロパティとメソッドを示します。  
+  
+|プロパティ|説明|  
+|-----------|--------|  
+|<xref:System.Xml.XPath.XPathNavigator.XmlType%2A>|有効な場合、ノードの XML スキーマ型の情報を含みます。|  
+|<xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A>|検証後に追加されたノードのスキーマ検証後の情報セットを含みます。  これには、検証情報に加えて、XML スキーマ型情報も含まれます。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueType%2A>|ノードの型指定された値の CLR 型。|  
+|<xref:System.Xml.XPath.XPathNavigator.TypedValue%2A>|型がノードの XML スキーマ型に最も一致する 1 つ以上の CLR 値としてのノードの内容。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAsBoolean%2A>|XPath 2.0 の `xs:boolean` のキャスト規則に従って、<xref:System.Boolean> 値にキャストされた現在のノードの <xref:System.String> 値。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAsDateTime%2A>|XPath 2.0 の `xs:datetime` のキャスト規則に従って、<xref:System.DateTime> 値にキャストされた現在のノードの <xref:System.String> 値。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAsDouble%2A>|XPath 2.0 の `xsd:double` のキャスト規則に従って、<xref:System.Double> 値にキャストされた現在のノードの <xref:System.String> 値。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAsInt%2A>|XPath 2.0 の `xs:integer` のキャスト規則に従って、<xref:System.Int32> 値にキャストされた現在のノードの <xref:System.String> 値。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAsLong%2A>|XPath 2.0 の `xs:integer` のキャスト規則に従って、<xref:System.Int64> 値にキャストされた現在のノードの <xref:System.String> 値。|  
+|<xref:System.Xml.XPath.XPathNavigator.ValueAs%2A>|XPath 2.0 のキャスト規則に従って、変換先の型にキャストされたノードのコンテンツ。|  
+  
+ スキーマの組み込み型から CLR 型への対応の詳細については、「[System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)」を参照してください。  
+  
+## スキーマ検証後の情報セット \(PSVI\)  
+ XML スキーマ プロセッサは、XML 情報セットを入力として受け入れ、それをスキーマ検証後の情報セット \(PSVI\) に変換します。  PSVI は、元の入力 XML 情報セットに新しい情報項目を追加し、新しいプロパティを追加したものです。  <xref:System.Xml.XPath.XPathNavigator> によって公開される PSVI 中の XML 情報セットに追加される情報には 3 つの広範なクラスがあります。  
+  
+1.  検証結果 : 要素または属性が問題なく検証されたかどうかの情報。  これは、<xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティの <xref:System.Xml.Schema.IXmlSchemaInfo.Validity%2A> プロパティによって公開されます。  
+  
+2.  既定の情報 : 要素または属性の値が、スキーマに定義された既定値により得られたものかどうかを示します。  これは、<xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティの <xref:System.Xml.Schema.IXmlSchemaInfo.IsDefault%2A> プロパティによって公開されます。  
+  
+3.  型のコメント : スキーマ コンポーネントへの参照。これは型の定義や、要素と属性の宣言である場合があります。  ノードが有効な場合、<xref:System.Xml.XPath.XPathNavigator> の <xref:System.Xml.XPath.XPathNavigator.XmlType%2A> プロパティは、ノード固有の型情報を含みます。  検証された後に編集されているときなど、ノードの有効性が不明な場合は、  <xref:System.Xml.XPath.XPathNavigator.XmlType%2A> プロパティが `null` に設定されますが、この場合でも、<xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティの各種プロパティから型情報を入手できます。  
+  
+ 次の例は、<xref:System.Xml.XPath.XPathNavigator> によって公開されるスキーマ検証後の情報セット内の情報の使用方法を示します。  
+  
+```vb  
+Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+settings.Schemas.Add("http://www.contoso.com/books", "books.xsd")  
+settings.ValidationType = ValidationType.Schema  
+  
+Dim reader As XmlReader = XmlReader.Create("books.xml", settings)  
+  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load(reader)  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+navigator.MoveToChild("books", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("published", "http://www.contoso.com/books")  
+  
+Console.WriteLine(navigator.SchemaInfo.SchemaType.Name)  
+Console.WriteLine(navigator.SchemaInfo.Validity)  
+Console.WriteLine(navigator.SchemaInfo.SchemaElement.MinOccurs)  
+```  
+  
+```csharp  
+XmlReaderSettings settings = new XmlReaderSettings();  
+settings.Schemas.Add("http://www.contoso.com/books", "books.xsd");  
+settings.ValidationType = ValidationType.Schema;  
+  
+XmlReader reader = XmlReader.Create("books.xml", settings);  
+  
+XmlDocument document = new XmlDocument();  
+document.Load(reader);  
+XPathNavigator navigator = document.CreateNavigator();  
+navigator.MoveToChild("books", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("published", "http://www.contoso.com/books");  
+  
+Console.WriteLine(navigator.SchemaInfo.SchemaType.Name);  
+Console.WriteLine(navigator.SchemaInfo.Validity);  
+Console.WriteLine(navigator.SchemaInfo.SchemaElement.MinOccurs);  
+```  
+  
+ この例は、`books.xml` ファイルを入力として使用します。  
+  
+```  
+<books xmlns="http://www.contoso.com/books">  
+    <book>  
+        <title>Title</title>  
+        <price>10.00</price>  
+        <published>2003-12-31</published>  
+    </book>  
+</books>  
+```  
+  
+ また、`books.xsd` スキーマも入力として使用します。  
+  
+```  
+<xs:schema xmlns="http://www.contoso.com/books"   
+attributeFormDefault="unqualified" elementFormDefault="qualified"   
+targetNamespace="http://www.contoso.com/books"   
+xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+    <xs:simpleType name="publishedType">  
+        <xs:restriction base="xs:date">  
+            <xs:minInclusive value="2003-01-01" />  
+            <xs:maxInclusive value="2003-12-31" />  
+        </xs:restriction>  
+    </xs:simpleType>  
+    <xs:complexType name="bookType">  
+        <xs:sequence>  
+            <xs:element name="title" type="xs:string"/>  
+            <xs:element name="price" type="xs:decimal"/>  
+            <xs:element name="published" type="publishedType"/>  
+        </xs:sequence>  
+    </xs:complexType>  
+    <xs:complexType name="booksType">  
+        <xs:sequence>  
+            <xs:element name="book" type="bookType" />  
+        </xs:sequence>  
+    </xs:complexType>  
+    <xs:element name="books" type="booksType" />  
+</xs:schema>  
+```  
+  
+## ValueAs プロパティによる型指定された値の取得  
+ ノードの型指定された値は、<xref:System.Xml.XPath.XPathNavigator> の <xref:System.Xml.XPath.XPathNavigator.TypedValue%2A> プロパティにアクセスして取得することができます。  場合により、ノードの型指定された値を別の型に変換する必要がある場合があります。  一般的な例として、XML ノードから数値を取得する場合があります。  たとえば、次のような未検証で型指定されていない XML ドキュメントがあるとします。  
+  
+```  
+<books>  
+    <book>  
+        <title>Title</title>  
+        <price>10.00</price>  
+        <published>2003-12-31</published>  
+    </book>  
+</books>  
+```  
+  
+ <xref:System.Xml.XPath.XPathNavigator> が `price` 要素上に位置している場合、<xref:System.Xml.XPath.XPathNavigator.XmlType%2A> プロパティは `null` となり、<xref:System.Xml.XPath.XPathNavigator.ValueType%2A> プロパティは <xref:System.String> であり、<xref:System.Xml.XPath.XPathNavigator.TypedValue%2A> プロパティは文字列 `10.00` です。  
+  
+ しかし、<xref:System.Xml.XPath.XPathItem.ValueAs%2A>、<xref:System.Xml.XPath.XPathNavigator.ValueAsDouble%2A>、<xref:System.Xml.XPath.XPathNavigator.ValueAsInt%2A>、または <xref:System.Xml.XPath.XPathNavigator.ValueAsLong%2A> のメソッドとプロパティを使用して、値を数値として抽出することは可能です。  次の例では、<xref:System.Xml.XPath.XPathItem.ValueAs%2A> メソッドを使用してキャストを実行します。  
+  
+```vb  
+Dim document As New XmlDocument()  
+document.Load("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+navigator.MoveToChild("books", "")  
+navigator.MoveToChild("book", "")  
+navigator.MoveToChild("price", "")  
+  
+Dim price = navigator.ValueAs(GetType(Decimal))  
+Dim discount As Decimal = 0.2  
+  
+Console.WriteLine("The price of the book has been dropped 20% from {0:C} to {1:C}", navigator.Value, (price - price * discount))  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+navigator.MoveToChild("books", "");  
+navigator.MoveToChild("book", "");  
+navigator.MoveToChild("price", "");  
+  
+Decimal price = (decimal)navigator.ValueAs(typeof(decimal));  
+  
+Console.WriteLine("The price of the book has been dropped 20% from {0:C} to {1:C}", navigator.Value, (price - price * (decimal)0.20));  
+```  
+  
+ スキーマの組み込み型から CLR 型への対応の詳細については、「[System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)   
+ [XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)   
+ [XpathNavigator を使用した XML データの抽出](../../../../docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..99523338eda
--- /dev/null
+++ b/docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md
@@ -0,0 +1,51 @@
+---
+title: "XPathNavigator による XML データへのアクセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: c57b46e6-5c77-408f-bc4e-67a5dcc9cc05
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator による XML データへのアクセス
+<xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内でのノード間の移動、XML データの抽出、および厳密に型指定された XML データにアクセスするメソッドを提供します。  
+  
+## このセクションの内容  
+ [XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で、ノードの移動に使用される <xref:System.Xml.XPath.XPathNavigator> クラスでのノード セットの移動メソッドについて説明します。  
+  
+ [XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスにおける属性ノードと名前空間ノードの移動メソッドについて説明します。  
+  
+ [XpathNavigator を使用した XML データの抽出](../../../../docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクトから XML データを抽出する各種のメソッドについて説明します。  
+  
+ [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](../../../../docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で <xref:System.Xml.XPath.XPathNavigator> クラスを使用して、厳密に型指定された XML データにアクセスする方法について説明します。  
+  
+ [ユーザー定義の関数と変数](../../../../docs/standard/data/xml/user-defined-functions-and-variables.md)  
+ カスタム クラス <xref:System.Xml.Xsl.XsltContext> を、拡張関数および変数をサポートする <xref:System.Xml.Xsl.IXsltContextFunction> インターフェイスおよび <xref:System.Xml.Xsl.IXsltContextVariable> インターフェイスと共に実装する方法について説明します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)   
+ [XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの編集](../../../../docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md b/docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md
new file mode 100644
index 00000000000..8c883fa44dd
--- /dev/null
+++ b/docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md
@@ -0,0 +1,115 @@
+---
+title: "XPathNavigator を使用する属性と名前空間のナビゲーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 23975f88-e0af-4b88-93de-9e20e11880ad
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator を使用する属性と名前空間のナビゲーション
+<xref:System.Xml.XPath.XPathNavigator> クラスは、2 セットの移動メソッドを提供します。「[XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)」に記載されている最初のセットは <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノード セットの移動に使用されます。  ここに記載されている 2 つ目のセットは、<xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内の属性ノードおよび名前空間ノードの移動に使用されます。  
+  
+## 属性ノードの移動  
+ 属性は要素のプロパティであり、要素の子ではありません。  兄弟ノード、親ノード、および子ノードの移動には <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドが使用されるため、この区別が重要になります。  
+  
+ たとえば、<xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A> と <xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A> メソッドは、要素から属性への移動や属性間の移動には使われません。  代わりに、属性には異なる移動メソッドがあります。  
+  
+ 以下は、<xref:System.Xml.XPath.XPathNavigator> クラスの属性移動メソッドです。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToAttribute%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToFirstAttribute%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToNextAttribute%2A>  
+  
+ 現在のノードが要素のとき、その要素に関連付けられている属性があるかどうかを調べるには、<xref:System.Xml.XPath.XPathNavigator.HasAttributes%2A> プロパティを使用できます。  要素に属性がある場合は、各種のメソッドで属性にアクセスできます。  要素から 1 つの属性を取り出すには、<xref:System.Xml.XPath.XPathNavigator.GetAttribute%2A> メソッドを使用します。  <xref:System.Xml.XPath.XPathNavigator> を特定の属性に移動するには、<xref:System.Xml.XPath.XPathNavigator.MoveToAttribute%2A> メソッドを使用します。  <xref:System.Xml.XPath.XPathNavigator.MoveToFirstAttribute%2A> メソッドに続けて複数の <xref:System.Xml.XPath.XPathNavigator.MoveToNextAttribute%2A> メソッド呼び出しを使用し、要素の各属性について繰り返すこともできます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator> オブジェクトが属性ノードまたは名前空間ノードの位置にある場合、<xref:System.Xml.XPath.XPathNavigator.MoveToChild%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFirst%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFirstChild%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFollowing%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToId%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A>、および <xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A> メソッドは常に `false` を返し、<xref:System.Xml.XPath.XPathNavigator> の位置には影響を与えません。  この例外は、<xref:System.Xml.XPath.XPathNavigator.MoveTo%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToParent%2A>、および <xref:System.Xml.XPath.XPathNavigator.MoveToRoot%2A> メソッドです。  
+  
+## 名前空間ノードの移動  
+ 各要素は関連する名前空間ノードの集合を持ちます。名前空間ノードは、要素のスコープ内にある名前空間 URI に関連付けられた異なる名前空間プレフィックス \(`http://www.w3.org/XML/1998/namespace` に関連付けられた XML プレフィックスを含みます。XML プレフィックスはすべての XML ドキュメントで暗黙に宣言されます\) それぞれについて 1 つ、さらに要素のスコープ内に既定の名前空間がある場合は、それに 1 つあります。  要素はこれら名前空間ノードの親です。ただし、名前空間ノードはその親要素の子ではありません。  
+  
+ 属性の場合と同様に、<xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A> および <xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A> メソッドは、要素から名前空間ノードへの移動や名前空間ノード間の移動には使われません。  代わりに、名前空間ノードには異なる移動メソッドがあります。  
+  
+ 以下は、<xref:System.Xml.XPath.XPathNavigator> クラスの名前空間移動メソッドです。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToNamespace%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A>  
+  
+ XML ドキュメント内のすべての要素には常に少なくとも 1 つの名前空間ノードがあります。  これは、プレフィックス `xml` および名前空間 URI `http://www.w3.org/XML/1998/namespace` を持つ名前空間ノードです。  特定のプレフィックスを指定してスコープ内の名前空間 URI を取り出すには、<xref:System.Xml.XPath.XPathNavigator.GetNamespace%2A> メソッドを使用します。  <xref:System.Xml.XPath.XPathNavigator> オブジェクトを特定の名前空間ノードに移動するには、<xref:System.Xml.XPath.XPathNavigator.MoveToNamespace%2A> メソッドを使用します。  <xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> メソッドに続けて複数の <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッド呼び出しを使用し、要素のスコープ内の各名前空間ノードについて繰り返すこともできます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator> オブジェクトが属性ノードまたは名前空間ノードの位置にある場合、<xref:System.Xml.XPath.XPathNavigator.MoveToChild%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFirst%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFirstChild%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToFollowing%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToId%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A>、および <xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A> メソッドは常に `false` を返し、<xref:System.Xml.XPath.XPathNavigator> の位置には影響を与えません。  この例外は、<xref:System.Xml.XPath.XPathNavigator.MoveTo%2A>、<xref:System.Xml.XPath.XPathNavigator.MoveToParent%2A>、および <xref:System.Xml.XPath.XPathNavigator.MoveToRoot%2A> メソッドです。  
+  
+### XPathNamespaceScope 列挙体  
+ 名前空間ノードの移動時には、<xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> および <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッドを <xref:System.Xml.XPath.XPathNamespaceScope> パラメーターを使用して呼び出すことができます。  これらのメソッドは、パラメーターなしで呼び出された場合と異なる動作をします。  <xref:System.Xml.XPath.XPathNamespaceScope> 列挙体には、<xref:System.Xml.XPath.XPathNamespaceScope>、<xref:System.Xml.XPath.XPathNamespaceScope>、または <xref:System.Xml.XPath.XPathNamespaceScope> の値があります。  
+  
+ 次の例は、XML ドキュメント内のさまざまなスコープで <xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> および <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッドによって返される値を表示します。  
+  
+```  
+<root>  
+    <element1 xmlns="http://www.contoso.com" xmlns:books="http://www.contoso.com/books">  
+        <element2 />  
+    </element1>  
+</root>  
+```  
+  
+ 名前空間の順序 \(<xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> メソッドとそれに続く一連の <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッド呼び出し後に <xref:System.Xml.XPath.XPathNavigator> が位置する名前空間\) は次のとおりです。  
+  
+-   `element2` の位置にある場合 : `xmlns:books="http://www.contoso.com/books"`、`xmlns="http://www.contoso.com"`、`xmlns:xml="http://www.w3.org/XML/1998/namespace"`。  
+  
+-   `element1` の位置にある場合 : `xmlns:books="http://www.contoso.com/books"`、`xmlns="http://www.contoso.com"`、`xmlns:xml="http://www.w3.org/XML/1998/namespace"`。  
+  
+-   `root` の位置にある場合 : `xmlns:xml="http://www.w3.org/XML/1998/namespace".`  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator> クラスは、ドキュメントの逆順で名前空間ノードを返します。  したがって、<xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> は原則的に、現在のスコープ内の最後の名前空間ノードに移動します。  
+  
+ 次の例は、XML ドキュメント内のさまざまなスコープで、<xref:System.Xml.XPath.XPathNamespaceScope> 列挙体が指定された <xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> および <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッドによって返される値を示します。  
+  
+```  
+<root xmlns="http://www.contoso.com" xmlns:a="http://www.contoso.com/a" xmlns:b="http://www.contoso.com/b">  
+    <child1 xmlns="" xmlns:a="urn:a">  
+        <child2 xmlns:c="urn:c" />  
+    </child1>  
+</root>  
+```  
+  
+ `child2` の位置にある場合、名前空間の順序 \(<xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> メソッドとそれに続く一連の <xref:System.Xml.XPath.XPathNavigator.MoveToNextNamespace%2A> メソッド呼び出し後に <xref:System.Xml.XPath.XPathNavigator> が位置する名前空間\) は次のとおりです。  
+  
+-   <xref:System.Xml.XPath.XPathNamespaceScope>: `xmlns:c="urn:c"`、`xmlns:a="urn:a"`、`xmlns=""`、`xmlns:b="http://www.contoso.com/b"`、`xmlns:a="http://www.contoso.com/a"`、`xmlns="http://www.contoso.com"`、および `xmlns:xml="http://www.w3.org/XML/1998/namespace"`。  
+  
+-   <xref:System.Xml.XPath.XPathNamespaceScope>: `xmlns:c="urn:c"`、`xmlns:a="urn:a"`、`xmlns=""`、`xmlns:b="http://www.contoso.com/b"`、`xmlns:a="http://www.contoso.com/a"`、および `xmlns="http://www.contoso.com"`。  
+  
+-   <xref:System.Xml.XPath.XPathNamespaceScope>: `xmlns:c="urn:c"`.  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator> クラスは、ドキュメントの逆順で名前空間ノードを返します。  したがって、<xref:System.Xml.XPath.XPathNavigator.MoveToFirstNamespace%2A> は原則的に、現在のスコープ内の最後の名前空間ノードに移動します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)   
+ [XpathNavigator を使用した XML データの抽出](../../../../docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md)   
+ [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](../../../../docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/building-xml-schemas.md b/docs/standard/data/xml/building-xml-schemas.md
new file mode 100644
index 00000000000..ec347804029
--- /dev/null
+++ b/docs/standard/data/xml/building-xml-schemas.md
@@ -0,0 +1,103 @@
+---
+title: "XML スキーマの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8a5ea56c-0140-4b51-8997-875ae6a8e0cb
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマの作成
+<xref:System.Xml.Schema?displayProperty=fullName> 名前空間のクラスは、W3C \(World Wide Web Consortium\) 勧告『XML Schema』で定義された構造に割り当てられ、メモリ内に XML スキーマを作成する場合に使用できます。  
+  
+## XML スキーマの作成  
+ 以下のコード サンプルでは、SOM API を使用してカスタム XML スキーマをメモリ内に作成します。  
+  
+### 要素と属性の作成  
+ このコード サンプルでは、カスタム スキーマを最初から作成するため、子要素、属性、およびそれらに対応する型を作成した後で最上位要素を作成します。  
+  
+ 以下のコード サンプルでは、SOM の <xref:System.Xml.Schema.XmlSchemaElement> クラスおよび <xref:System.Xml.Schema.XmlSchemaAttribute> クラスを使用して、カスタム スキーマの `CustomerId` 属性に加え、`FirstName` 要素および `LastName` 要素を作成します。  XML スキーマの `<xs:element />` 要素および `<xs:attribute />` 要素の name 属性に対応する <xref:System.Xml.Schema.XmlSchemaElement> クラスおよび <xref:System.Xml.Schema.XmlSchemaAttribute> クラスの <xref:System.Xml.Schema.XmlSchemaElement.Name%2A> プロパティを除いて、このスキーマで使用できる他のすべての属性 \(`defaultValue`、`fixedValue`、`form` など\) には、<xref:System.Xml.Schema.XmlSchemaElement> クラスおよび <xref:System.Xml.Schema.XmlSchemaAttribute> クラスに対応するプロパティが存在します。  
+  
+ [!code-cpp[XmlSchemaCreateExample#2](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaCreateExample/CPP/XmlSchemaCreateExample.cpp#2)]
+ [!code-csharp[XmlSchemaCreateExample#2](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaCreateExample/CS/XmlSchemaCreateExample.cs#2)]
+ [!code-vb[XmlSchemaCreateExample#2](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaCreateExample/VB/XmlSchemaCreateExample.vb#2)]  
+  
+### スキーマの型の作成  
+ 要素および属性のコンテンツは、その型によって定義されます。  組み込みのスキーマの型を持つ要素と属性を作成するには、<xref:System.Xml.XmlQualifiedName> クラスを使用する組み込みの修飾名を使用して、<xref:System.Xml.Schema.XmlSchemaElement> クラスまたは <xref:System.Xml.Schema.XmlSchemaAttribute> クラスの <xref:System.Xml.Schema.XmlSchemaElement.SchemaTypeName%2A> プロパティを設定します。  要素と属性のユーザー定義型を作成するには、<xref:System.Xml.Schema.XmlSchemaSimpleType> または <xref:System.Xml.Schema.XmlSchemaComplexType> クラスを使用して単純型または複合型を新しく作成します。  
+  
+> [!NOTE]
+>  要素または属性の匿名の子である名前のない単純型または複合型 \(属性に適用されるのは単純型のみ\) を作成するには、<xref:System.Xml.Schema.XmlSchemaElement> クラスまたは <xref:System.Xml.Schema.XmlSchemaAttribute> クラスの <xref:System.Xml.Schema.XmlSchemaElement.SchemaTypeName%2A> プロパティではなく、<xref:System.Xml.Schema.XmlSchemaElement> クラスまたは <xref:System.Xml.Schema.XmlSchemaAttribute> クラスの <xref:System.Xml.Schema.XmlSchemaElement.SchemaType%2A> プロパティを設定します。  
+  
+ XML スキーマを使用すると、匿名の単純型と名前付きの単純型の両方を、他の単純型 \(組み込み型またはユーザー定義型\) から制限付きで派生させるか、または、他の単純型のリストまたは和集合として作成することができます。  <xref:System.Xml.Schema.XmlSchemaSimpleTypeRestriction> クラスを使用して単純型を作成する場合には、組み込みの `xs:string` 型を制限します。  また、<xref:System.Xml.Schema.XmlSchemaSimpleTypeList> または <xref:System.Xml.Schema.XmlSchemaSimpleTypeUnion> クラスを使用すると、リストまたは和集合の型を作成できます。  <xref:System.Xml.Schema.XmlSchemaSimpleType.Content%2A?displayProperty=fullName> プロパティは、単純型の制限、リスト、または和集合を表します。  
+  
+ 以下のコード サンプルでは、`FirstName` 要素の型は組み込み型の `xs:string`、`LastName` 要素の型は組み込み型 `xs:string` の制限となる名前付き単純型 \(`MaxLength` ファセット値 20\)、`CustomerId` 属性の型は組み込み型 `xs:positiveInteger` です。  `Customer` 要素は匿名の複合型で、そのパーティクルは `FirstName` 要素および `LastName` 要素のシーケンスとなり、その属性には `CustomerId` 属性が含まれます。  
+  
+> [!NOTE]
+>  また、複合型のパーティクルとして <xref:System.Xml.Schema.XmlSchemaChoice> クラスまたは <xref:System.Xml.Schema.XmlSchemaAll> クラスを使用して、`<xs:choice />` または `<xs:all />` セマンティクスをレプリケートすることもできます。  
+  
+ [!code-cpp[XmlSchemaCreateExample#3](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaCreateExample/CPP/XmlSchemaCreateExample.cpp#3)]
+ [!code-csharp[XmlSchemaCreateExample#3](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaCreateExample/CS/XmlSchemaCreateExample.cs#3)]
+ [!code-vb[XmlSchemaCreateExample#3](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaCreateExample/VB/XmlSchemaCreateExample.vb#3)]  
+  
+### スキーマの作成とコンパイル  
+ この時点で、子要素と属性 \(それらに対応する型\) および最上位の `Customer` 要素が SOM API を使用してメモリ内に作成されています。  以下のコード サンプルでは、<xref:System.Xml.Schema.XmlSchema> クラスを使用してスキーマ要素が作成され、<xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> プロパティを使用して最上位の要素と型が追加されます。また、<xref:System.Xml.Schema.XmlSchemaSet> クラスを使用して完全なスキーマがコンパイルされて、コンソールに出力されます。  
+  
+ [!code-cpp[XmlSchemaCreateExample#4](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaCreateExample/CPP/XmlSchemaCreateExample.cpp#4)]
+ [!code-csharp[XmlSchemaCreateExample#4](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaCreateExample/CS/XmlSchemaCreateExample.cs#4)]
+ [!code-vb[XmlSchemaCreateExample#4](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaCreateExample/VB/XmlSchemaCreateExample.vb#4)]  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A?displayProperty=fullName> メソッドは、XML スキーマの規則を基準としてカスタム スキーマを検証し、スキーマ コンパイル後のプロパティを使用できるようにします。  
+  
+> [!NOTE]
+>  SOM API のスキーマ コンパイル後のプロパティは、スキーマ検証後の情報セットとは異なります。  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> に追加される <xref:System.Xml.Schema.ValidationEventHandler> は、コールバック メソッド `ValidationCallback` を呼び出してスキーマ検証時の警告およびエラーを処理するデリゲートになります。  
+  
+ 以下に、完全なコード サンプルおよびコンソールに出力されるカスタム スキーマを示します。  
+  
+ [!code-cpp[XmlSchemaCreateExample#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaCreateExample/CPP/XmlSchemaCreateExample.cpp#1)]
+ [!code-csharp[XmlSchemaCreateExample#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaCreateExample/CS/XmlSchemaCreateExample.cs#1)]
+ [!code-vb[XmlSchemaCreateExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaCreateExample/VB/XmlSchemaCreateExample.vb#1)]  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema xmlns:tns="http://www.tempuri.org" targetNamespace="http://www.tempuri.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+   <xs:element name="Customer">  
+      <xs:complexType>  
+         <xs:sequence>  
+            <xs:element name="FirstName" type="xs:string" />  
+            <xs:element name="LastName" type="tns:LastNameType" />  
+         </xs:sequence>  
+         <xs:attribute name="CustomerId" type="xs:positiveInteger" use="required" />  
+      </xs:complexType>  
+   </xs:element>  
+   <xs:simpleType name="LastNameType">  
+      <xs:restriction base="xs:string">  
+         <xs:maxLength value="20" />  
+      </xs:restriction>  
+   </xs:simpleType>  
+</xs:schema>  
+```  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)   
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)   
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)   
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)   
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [スキーマのコンパイル後の情報セット](../../../../docs/standard/data/xml/post-schema-compilation-infoset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/changing-namespace-declarations-in-an-xml-document.md b/docs/standard/data/xml/changing-namespace-declarations-in-an-xml-document.md
new file mode 100644
index 00000000000..14fe2c4d617
--- /dev/null
+++ b/docs/standard/data/xml/changing-namespace-declarations-in-an-xml-document.md
@@ -0,0 +1,54 @@
+---
+title: "XML ドキュメントの名前空間宣言の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a2758f40-e497-4964-8d8d-1bb68af14dcd
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントの名前空間宣言の変更
+**XmlDocument** は、名前空間宣言と **xmlns** 属性をドキュメント オブジェクト モデルの一部として公開します。  名前空間宣言と **xmlns** 属性は **XmlDocument** に格納されるため、ドキュメントの保存時にはこれらの属性の場所を保持できます。  これらの属性を変更しても、ツリーに既に存在する別のノードの **Name**、**NamespaceURI**、および **Prefix** プロパティは影響を受けません。  たとえば、次のドキュメントを読み込むと、`test` 要素の **NamespaceURI** は `123.` になります。  
+  
+```  
+<test xmlns="123"/>  
+```  
+  
+ その後、次のように `xmlns` 要素を削除しても、`test` 要素の **NamespaceURI** は `123` のまま変わりません。  
+  
+```vb  
+doc.documentElement.RemoveAttribute("xmlns")  
+```  
+  
+```csharp  
+doc.documentElement.RemoveAttribute("xmlns");  
+```  
+  
+ 同様に、次のように別の `xmlns` 属性を `doc` 要素に追加しても、`test` 要素の **NamespaceURI** は `123` のまま変わりません。  
+  
+```vb  
+doc.documentElement.SetAttribute("xmlns","456");  
+```  
+  
+```csharp  
+doc.documentElement.SetAttribute("xmlns","456");  
+```  
+  
+ つまり、`xmlns` 属性を変更しても、**XmlDocument** オブジェクトを保存して再び読み込むまで、プロパティは影響を受けません。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/changing-namespace-prefix-properties.md b/docs/standard/data/xml/changing-namespace-prefix-properties.md
new file mode 100644
index 00000000000..1247c0b4f70
--- /dev/null
+++ b/docs/standard/data/xml/changing-namespace-prefix-properties.md
@@ -0,0 +1,76 @@
+---
+title: "名前空間プレフィックス プロパティの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d5c87cbe-4d69-429f-aad5-3103c2ca2770
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 名前空間プレフィックス プロパティの変更
+**XmlNode** クラスを使用すると、特定のノードに関連付けられた名前空間プレフィックスを変更できます。  たとえば、要素のプレフィックスを変更するコードを次に示します。  
+  
+```vb  
+Dim doc as XmlDocument = new XmlDocument()  
+doc.LoadXml("<a:test xmlns:a='123' xmlns:b='456'/>")  
+Dim e as XmlElement = doc.DocumentElement  
+e.Prefix = "b"  
+Console.WriteLine(doc.InnerXml)  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+doc.LoadXml("<a:test xmlns:a='123' xmlns:b='456'/>");  
+XmlElement e = doc.DocumentElement;         
+e.Prefix = "b";  
+Console.WriteLine(doc.InnerXml);  
+```  
+  
+ **出力**  
+  
+```  
+<b:test xmlns:a="123" xmlns:b="456" />  
+```  
+  
+ ノードのプレフィックスを変更しても、名前空間は変更されません。  名前空間を設定できるのは、ノードを作成するときだけです。  ツリーを永続化するときには、設定したプレフィックスに適合するように新しい名前空間の属性も永続化されます。  新しい名前空間を作成できない場合は、プレフィックスが変更され、ノードにはそのローカル名と名前空間が保持されます。  名前空間の属性を追加する例を次に示します。  
+  
+```vb  
+Dim doc as XmlDocument = new XmlDocument()  
+doc.LoadXml("<test xmlns='123'/>")  
+Dim e as XmlElement = doc.DocumentElement  
+e.Prefix = "a"  
+Console.WriteLine(doc.InnerXml)  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+doc.LoadXml("<test xmlns='123'/>");  
+XmlElement e = doc.DocumentElement;         
+e.Prefix = "a";  
+Console.WriteLine(doc.InnerXml);  
+```  
+  
+ **出力**  
+  
+```  
+<a:test xmlns="123" xmlns:a="123" />  
+```  
+  
+ **doc.InnerXml** の呼び出しの結果としてツリーが文字列に永続化されるとき、`test` 要素の名前空間を保持するために `xmlns:a='123'` という属性が追加されます。  `xmlns:a` の元の値は `'123'` だったので、そのまま `'123'` として残ります。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/compiled-xpath-expressions.md b/docs/standard/data/xml/compiled-xpath-expressions.md
new file mode 100644
index 00000000000..42500f4ac69
--- /dev/null
+++ b/docs/standard/data/xml/compiled-xpath-expressions.md
@@ -0,0 +1,137 @@
+---
+title: "コンパイルされた XPath 式 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: e25dd95f-b64c-4d8b-a3a4-379e1aa0ad55
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# コンパイルされた XPath 式
+<xref:System.Xml.XPath.XPathExpression> オブジェクトは、<xref:System.Xml.XPath.XPathExpression> クラスの静的 <xref:System.Xml.XPath.XPathExpression.Compile%2A> メソッドまたは <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.Compile%2A> メソッドから返されるコンパイル済み XPath クエリを表します。  
+  
+## XPathExpression クラス  
+ <xref:System.Xml.XPath.XPathExpression> オブジェクトにより表されるコンパイル済み XPath クエリは、同じ XPath クエリが複数回使用されるときに有用です。  
+  
+ たとえば、<xref:System.Xml.XPath.XPathNavigator.Select%2A> メソッドを複数回呼び出すとき、毎回 XPath クエリを表す文字列を使用する代わりに、再使用とパフォーマンスの向上のために、<xref:System.Xml.XPath.XPathExpression> クラスの <xref:System.Xml.XPath.XPathExpression.Compile%2A> メソッド、または <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.Compile%2A> メソッドを使用して、XPath クエリを <xref:System.Xml.XPath.XPathExpression> オブジェクトにコンパイルしてキャッシュします。  
+  
+ いったんコンパイルされると、<xref:System.Xml.XPath.XPathExpression> オブジェクトは、XPath クエリから返される型に応じて、次の <xref:System.Xml.XPath.XPathNavigator> クラス メソッドの入力として使用することができます。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A?displayProperty=fullName>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A?displayProperty=fullName>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Matches%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Select%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A>  
+  
+ 次の表では、W3C XPath の戻り型、それに等価の Microsoft .NET Framework 型、および戻り型に応じて <xref:System.Xml.XPath.XPathExpression> オブジェクトで使用できるメソッドについて説明します。  
+  
+|W3C XPath の戻り型|.NET Framework の等価の型|説明|メソッド|  
+|--------------------|--------------------------|--------|----------|  
+|`Node set`|<xref:System.Xml.XPath.XPathNodeIterator>|重複がなく順序付けされていない、ドキュメント順に作成されたノードのコレクション。|<xref:System.Xml.XPath.XPathNavigator.Select%2A> または<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A>|  
+|`Boolean`|<xref:System.Boolean>|`true` または `false` の値。|<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> または<br /><br /> <xref:System.Xml.XPath.XPathNavigator.Matches%2A>|  
+|`Number`|<xref:System.Double>|浮動小数点数。|<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A>|  
+|`String`|<xref:System.String>|UCS 文字のシーケンス。|<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A>|  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドは、XPath 式をパラメーターとして受け取ります。  <xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A> メソッドは W3C XPath の戻り型の 1 つではなく、1 つの <xref:System.Xml.XPath.XPathNavigator> オブジェクトを返します。  
+  
+### 戻り型のプロパティ  
+ XPath クエリが <xref:System.Xml.XPath.XPathExpression> オブジェクトにコンパイルされた後、<xref:System.Xml.XPath.XPathExpression> オブジェクトの <xref:System.Xml.XPath.XPathExpression.ReturnType%2A> プロパティを使用して、XPath クエリで何が返されるかを知ることができます。  
+  
+ <xref:System.Xml.XPath.XPathExpression.ReturnType%2A> プロパティは、W3C XPath 戻り値を表す、次の <xref:System.Xml.XPath.XPathResultType> 列挙値の 1 つを返します。  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+-   <xref:System.Xml.XPath.XPathResultType>  
+  
+ 次の例は、<xref:System.Xml.XPath.XPathExpression> オブジェクトを使用して、`books.xml` ファイルから 1 つの数値とノード セットを返します。  各 <xref:System.Xml.XPath.XPathExpression> オブジェクトの <xref:System.Xml.XPath.XPathExpression.ReturnType%2A> プロパティと共に、<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> および <xref:System.Xml.XPath.XPathNavigator.Select%2A> メソッドからの結果がコンソールに出力されます。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+' Returns a number.  
+Dim query1 As XPathExpression = navigator.Compile("bookstore/book/price/text()*10")  
+Console.WriteLine(query1.ReturnType)  
+  
+Dim number As Double = CType(navigator.Evaluate(query1), Double)  
+Console.WriteLine(number)  
+  
+' Returns a node set.  
+Dim query2 As XPathExpression = navigator.Compile("bookstore/book/price")  
+Console.WriteLine(query2.ReturnType)  
+  
+Dim nodes As XPathNodeIterator = navigator.Select(query2)  
+nodes.MoveNext()  
+Console.WriteLine(nodes.Current.Value)  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+// Returns a number.  
+XPathExpression query1 = navigator.Compile("bookstore/book/price/text()*10");  
+Console.WriteLine(query1.ReturnType);  
+  
+Double number = (Double)navigator.Evaluate(query1);  
+Console.WriteLine(number);  
+  
+// Returns a node set.  
+XPathExpression query2 = navigator.Compile("bookstore/book/price");  
+Console.WriteLine(query2.ReturnType);  
+  
+XPathNodeIterator nodes = navigator.Select(query2);  
+nodes.MoveNext();  
+Console.WriteLine(nodes.Current.Value);  
+```  
+  
+ この例は、`books.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#1](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/books.xml#1)]  
+  
+### XPath 式のパフォーマンスの向上  
+ パフォーマンスを向上させるには、クエリで可能な限り特定した XPath 式を使用します。  たとえば、`book` が `bookstore` ノードの子ノードであり `bookstore` ノードが XML ドキュメントで最上位のノードの場合は、XPath 式 `/bookstore/book` を使用すると `//book` を使用した場合より高速です。  `//book` XPath 式は、XML ツリーのすべてのノードをスキャンしてノードとの一致を調べます。  
+  
+ さらに、選択基準が単純な場合は <xref:System.Xml.XPath.XPathNavigator> クラスが提供するノード セット ナビゲーション メソッドは、<xref:System.Xml.XPath.XPathNavigator> クラスが提供する選択メソッドに比べてパフォーマンスが高いことがあります。  たとえば、現在のノードの最初の子を選択する場合、<xref:System.Xml.XPath.XPathNavigator.MoveToFirst%2A> メソッドを使用した方が `child::*[1]` XPath 式と <xref:System.Xml.XPath.XPathNavigator.Select%2A> メソッドを使用するよりも高速です。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスのノード セット ナビゲーション メソッドの詳細については「[XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)   
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)   
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)   
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/conversion-of-xml-data-types.md b/docs/standard/data/xml/conversion-of-xml-data-types.md
new file mode 100644
index 00000000000..d0e54a8eba4
--- /dev/null
+++ b/docs/standard/data/xml/conversion-of-xml-data-types.md
@@ -0,0 +1,79 @@
+---
+title: "XML データ型の変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a2aa99ba-8239-4818-9281-f1d72ee40bde
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML データ型の変換
+**XmlConvert** クラスのメソッドのほとんどは、文字列と厳密に型指定された形式との間のデータ変換に使われます。  これらのメソッドはロケールに依存しません。  つまり、変換の実行時にはロケールの設定は考慮されません。  
+  
+## 文字列を型として読み込む  
+ 文字列を読み込んで **DateTime** 型に変換するサンプルを次に示します。  
+  
+ 入力として次の XML を使用します。  
+  
+ **入力**  
+  
+```  
+<Element>2001-02-27T11:13:23</Element>  
+```  
+  
+ 次のコードは、文字列を **DateTime** 形式に変換します。  
+  
+```vb  
+reader.ReadStartElement()  
+Dim vDateTime As DateTime = XmlConvert.ToDateTime(reader.ReadString())  
+Console.WriteLine(vDateTime)  
+  
+```  
+  
+```csharp  
+reader.ReadStartElement();  
+DateTime vDateTime = XmlConvert.ToDateTime(reader.ReadString());  
+Console.WriteLine(vDateTime);  
+```  
+  
+## 文字列を型として書き込む  
+ **Int32** を読み込んで文字列に変換するサンプルを次に示します。  
+  
+ 入力として次の XML を使用します。  
+  
+ **入力**  
+  
+```  
+<TestInt32>-2147483648</TestInt32>  
+```  
+  
+ 次のコードは、**Int32** を **String** に変換します。  
+  
+```vb  
+Dim vInt32 As Int32 = -2147483648  
+writer.WriteElementString("TestInt32", XmlConvert.ToString(vInt32))  
+  
+```  
+  
+```csharp  
+Int32 vInt32=-2147483648;  
+writer.WriteElementString("TestInt32",XmlConvert.ToString(vInt32));  
+```  
+  
+## 参照  
+ [文字列の .NET Framework データ型への変換](../../../../docs/standard/data/xml/converting-strings-to-dotnet-data-types.md)   
+ [.NET Framework 型の文字列への変換](../../../../docs/standard/data/xml/converting-dotnet-types-to-strings.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/converting-dotnet-types-to-strings.md b/docs/standard/data/xml/converting-dotnet-types-to-strings.md
new file mode 100644
index 00000000000..d3bba1c2a9f
--- /dev/null
+++ b/docs/standard/data/xml/converting-dotnet-types-to-strings.md
@@ -0,0 +1,39 @@
+---
+title: ".NET Framework 型の文字列への変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: dc2e2b65-f623-4dc3-938b-d2a054d6832c
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# .NET Framework 型の文字列への変換
+.NET Framework 型を文字列に変換するには、**ToString** メソッドを使用します。  **ToString** メソッドは、渡された型の文字列表現を返します。  XML スキーマ \(XSD\) 仕様に対応する形式で文字列を返す .NET Framework 型を、次の表に示します。  
+  
+|.NET Framework 型|返される文字列型|  
+|----------------------|--------------|  
+|Boolean|"true"、"false"|  
+|Single.PositiveInfinity|"INF"|  
+|Single.NegativeInfinity|"\-INF"|  
+|Double.PositiveInfinity|"INF"|  
+|Double.NegativeInfinity|"\-INF"|  
+|DateTime|形式は、yyyy\-MM\-ddTHH:mm:sszzzzzz およびそのサブセットです。|  
+|Timespan|PnYnMnTnHnMnS の形式。たとえば、`P2Y10M15DT10H30M20S` は 2 年 10 か月 15 日 10 時間 30 分 20 秒の期間です。|  
+  
+## 参照  
+ [XML データ型の変換](../../../../docs/standard/data/xml/conversion-of-xml-data-types.md)   
+ [文字列の .NET Framework データ型への変換](../../../../docs/standard/data/xml/converting-strings-to-dotnet-data-types.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/converting-strings-to-dotnet-data-types.md b/docs/standard/data/xml/converting-strings-to-dotnet-data-types.md
new file mode 100644
index 00000000000..4a5ec8c514e
--- /dev/null
+++ b/docs/standard/data/xml/converting-strings-to-dotnet-data-types.md
@@ -0,0 +1,148 @@
+---
+title: "文字列の .NET Framework データ型への変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 65455ef3-9120-412c-819b-d0f59f88ac09
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 文字列の .NET Framework データ型への変換
+文字列を .NET Framework データ型に変換するには、アプリケーションの要件に適合する **XmlConvert** メソッドを使用します。  **XmlConvert** クラスで利用可能なすべての変換メソッドの一覧については、「[XmlConvert メンバー](frlrfSystemXmlXmlConvertMembersTopic)」を参照してください。  
+  
+ **ToString** メソッドから返される文字列は、渡したデータを文字列に変換したものです。  変換に **XmlConvert** クラスを使用する .NET Framework 型の中には、**System.Convert** クラスのメソッドを使用しないものがいくつかあります。  **XmlConvert** クラスは XML Schema \(XSD\) のデータ型に準拠しており、**XmlConvert** によって変換できるデータ型は決まっています。  
+  
+ 次の表は、.NET Framework データ型の一覧と、XML スキーマ \(XSD\) のデータ型マップを使用した場合に返される文字列を示しています。  これらの .NET Framework 型は、**System.Convert** で処理することはできません。  
+  
+|.NET Framework 型|返される文字列|  
+|----------------------|-------------|  
+|Boolean|"true"、"false"|  
+|Single.PositiveInfinity|"INF"|  
+|Single.NegativeInfinity|"\-INF"|  
+|Double.PositiveInfinity|"INF"|  
+|Double.NegativeInfinity|"\-INF"|  
+|DateTime|形式は、yyyy\-MM\-ddTHH:mm:sszzzzzz およびそのサブセットです。|  
+|Timespan|PnYnMnTnHnMnS の形式。つまり、`P2Y10M15DT10H30M20S` は 2 年 10 か月 15 日 10 時間 30 分 20 秒の期間です。|  
+  
+> [!NOTE]
+>  表中の .NET Framework 型を **ToString** メソッドを使用して文字列に変換したときに返される文字列は基本型ではなく、XML スキーマ \(XSD\) 文字列型です。  
+  
+ **DateTime** 値型と **Timespan** 値型の違いは、**DateTime** が瞬間を表すのに対して、**TimeSpan** が時間間隔を表すことです。  **DateTime** および **Timespan** の形式は、XML スキーマ \(XSD\) のデータ型仕様で指定されています。  次に例を示します。  
+  
+```vb  
+Dim writer As New XmlTextWriter("myfile.xml", Nothing)  
+Dim [date] As New DateTime(2001, 8, 4)  
+writer.WriteElementString("Date", XmlConvert.ToString([date]))  
+  
+```  
+  
+```csharp  
+XmlTextWriter writer = new XmlTextWriter("myfile.xml", null);  
+DateTime date = new DateTime (2001, 08, 04);  
+writer.WriteElementString("Date", XmlConvert.ToString(date));  
+```  
+  
+ **出力**  
+  
+ `<Date>2001-08-04T00:00:00</Date>`.  
+  
+ 整数を文字列に変換するコードを次に示します。  
+  
+```vb  
+Dim writer As New XmlTextWriter("myfile.xml", Nothing)  
+Dim value As Int32 = 200  
+writer.WriteElementString("Number", XmlConvert.ToString(value))  
+  
+```  
+  
+```csharp  
+XmlTextWriter writer = new XmlTextWriter("myfile.xml", null);  
+Int32 value = 200;  
+writer.WriteElementString("Number", XmlConvert.ToString(value));  
+```  
+  
+ **出力**  
+  
+ `<Number>200</Number>`  
+  
+ ただし、文字列を **Boolean**、**Single**、または **Double** に変換する場合、返される .NET Framework 型は、**System.Convert** クラスを使用したときに返される型とは異なります。  
+  
+## String から Boolean  
+ **ToBoolean** メソッドを使用して文字列を **Boolean** に変換するときの入力文字列と生成される型の対応を次の表に示します。  
+  
+|有効な文字列入力パラメーター|出力される .NET Framework 型|  
+|--------------------|----------------------------|  
+|"true"|Boolean.True|  
+|"1"|Boolean.True|  
+|"false"|Boolean.False|  
+|"0"|Boolean.False|  
+  
+ たとえば、次のような XML があるとします。  
+  
+ **入力**  
+  
+```  
+<Boolean>true</Boolean>  
+<Boolean>1</Boolean>   
+```  
+  
+ いずれも次のコードによって解釈することができ、**bvalue** は **System.Boolean.True** になります。  
+  
+```vb  
+Dim bvalue As Boolean = _  
+   XmlConvert.ToBoolean(reader.ReadElementString())  
+Console.WriteLine(bvalue)  
+  
+```  
+  
+```csharp  
+Boolean bvalue = XmlConvert.ToBoolean(reader.ReadElementString());  
+Console.WriteLine(bvalue);  
+```  
+  
+## String から Single  
+ **ToSingle** メソッドを使用して文字列を **Single** に変換するときの入力文字列と生成される型の対応を次の表に示します。  
+  
+|有効な文字列入力パラメーター|出力される .NET Framework 型|  
+|--------------------|----------------------------|  
+|"INF"|Single.PositiveInfinity|  
+|"\-INF"|Single.NegativeInfinity|  
+  
+## String から Double  
+ **ToDouble** メソッドを使用して文字列を **Double** に変換するときの入力文字列と生成される型の対応を次の表に示します。  
+  
+|有効な文字列入力パラメーター|出力される .NET Framework 型|  
+|--------------------|----------------------------|  
+|"INF"|Double.PositiveInfinity|  
+|"\-INF"|Double.NegativeInfinity|  
+  
+ 次のコードは、`<Infinity>INF</Infinity>` を書き込みます。  
+  
+```vb  
+Dim value As Double = Double.PositiveInfinity  
+writer.WriteElementString("Infinity", XmlConvert.ToString(value))  
+  
+```  
+  
+```csharp  
+Double value = Double.PositiveInfinity;  
+writer.WriteElementString("Infinity", XmlConvert.ToString(value));  
+```  
+  
+## 参照  
+ [XML データ型の変換](../../../../docs/standard/data/xml/conversion-of-xml-data-types.md)   
+ [.NET Framework 型の文字列への変換](../../../../docs/standard/data/xml/converting-dotnet-types-to-strings.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/copy-existing-nodes.md b/docs/standard/data/xml/copy-existing-nodes.md
new file mode 100644
index 00000000000..0fdfdf27b3b
--- /dev/null
+++ b/docs/standard/data/xml/copy-existing-nodes.md
@@ -0,0 +1,28 @@
+---
+title: "既存のノードのコピー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2aa8f65c-cc62-4638-9c46-129dc15be786
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 既存のノードのコピー
+XML ドキュメント オブジェクト モデル \(DOM\) には、**SelectSingleNode**、**ChildNodes\[int i\]**、**Attributes\[int i\]** など、ノードの選択に使用できるメソッドとプロパティが多数用意されています。  ノードを選択すると、その特定のノード型で利用できる挿入メソッドを使用してツリーに挿入できます。  ノードをツリーに挿入するときの唯一の制約は、ノードを挿入した後もドキュメントが整形式になっていなければならないことです。  既存のノードを DOM ツリーに挿入すると、そのノードは元の位置から削除され、挿入先の位置に追加されます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/copying-document-fragments.md b/docs/standard/data/xml/copying-document-fragments.md
new file mode 100644
index 00000000000..1f9bca5a884
--- /dev/null
+++ b/docs/standard/data/xml/copying-document-fragments.md
@@ -0,0 +1,28 @@
+---
+title: "ドキュメント フラグメントのコピー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: cf424bbe-81b7-40d2-9978-9b727da94d80
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# ドキュメント フラグメントのコピー
+**XmlDocumentFragment** ノードを作成し、その下にノードを追加できます。  **InsertNode** メソッドを使って **XmlDocumentFragment** を挿入する場合、**XmlDocumentFragment** ノードはコピーされず、その子ノードが XML ドキュメント オブジェクト モデル \(DOM\) に挿入されます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/copying-existing-nodes-from-one-document-to-another.md b/docs/standard/data/xml/copying-existing-nodes-from-one-document-to-another.md
new file mode 100644
index 00000000000..316ada04629
--- /dev/null
+++ b/docs/standard/data/xml/copying-existing-nodes-from-one-document-to-another.md
@@ -0,0 +1,53 @@
+---
+title: "ドキュメント間での既存のノードのコピー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 3caa78c1-3448-4b7b-b83c-228ee857635e
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# ドキュメント間での既存のノードのコピー
+**ImportNode** メソッドを使用すると、ある **XmlDocument** から別の **XmlDocument** へ、ノードまたはノードのサブツリー全体をコピーできます。  呼び出しから返されるノードは、ソース ドキュメントのノードのコピーであり、そこには属性値、ノード名、ノード型が含まれます。さらに、プレフィックス、ローカル名、名前空間 URI \(Uniform Resource Identifier\) など、名前空間に関連するすべての属性も含まれます。  ソース ドキュメントは変更されません。  インポートしたノードは、ノードを挿入するメソッドの 1 つを使用してツリーに追加する必要があります。  
+  
+ 新しいドキュメントにノードを追加すると、その新しいドキュメントがそのノードを所有します。  これは、ノードが別のドキュメント フラグメントに作成される場合でも、各ノードの作成時には所有元のドキュメントが設定されるためです。  これは XML ドキュメント オブジェクト モデル \(DOM\) の要件であり、**XmlDocument** クラスの設計仕様です。  たとえば、**CreateElement** は、新しいノードを作成する唯一の手段です。  
+  
+ インポートされたノード型と *deep* パラメーターの値によって、必要に応じて追加情報がコピーされます。  XML では、あるドキュメントから別のドキュメントへ XML ソースまたは HTML ソースのフラグメントをコピーしたときに 2 つのドキュメントのドキュメント型定義 \(DTD\) が別々になることがありますが、このメソッドでは、その動作を再現しようとします。  
+  
+ インポートできるノードの型について、それぞれに固有の動作を次の表に示します。  
+  
+|ノード型|*deep* パラメーターが true|*deep* パラメーターが false|  
+|----------|-------------------------|--------------------------|  
+|XmlAttribute|XmlAttribute では、[XmlAttribute.Specified プロパティ](frlrfSystemXmlXmlAttributeClassSpecifiedTopic)が **true** に設定されます。  ソース **XmlAttribute** の子孫は再帰的にインポートされます。結果として得られるノードは再アセンブルされ、対応するサブツリーが形成されます。|**XmlAttribute** ノードは常に子ノードと共にインポートされるため、**XmlAttribute** ノードには *deep* パラメーターは適用されません。|  
+|XmlCDataSection|ノードをそのデータと共にコピーします。|ノードをそのデータと共にコピーします。|  
+|XmlComment|ノードをそのデータと共にコピーします。|ノードをそのデータと共にコピーします。|  
+|XmlDocumentFragment|ソース ノードの子孫が再帰的にインポートされます。結果として得られるノードは再アセンブルされ、対応するサブツリーが形成されます。|空の **XmlDocumentFragment** が作成されます。|  
+|XmlDocumentType|ノードがデータと共にコピーされます。\*|ノードがデータと共にコピーされます。\*|  
+|XmlElement|ソース要素の子孫が再帰的にインポートされます。結果として得られるノードは再アセンブルされ、対応するサブツリーが形成されます。 **Note:**  既存の属性はコピーされません。  インポートされるドキュメントでこの要素名に対する既定の属性が定義されている場合は、それらが割り当てられます。|指定された属性ノードがソース要素からインポートされ、生成された **XmlAttribute** ノードが新しい要素に追加されます。  子孫ノードはコピーされません。 **Note:**  既存の属性はコピーされません。  インポートされるドキュメントでこの要素名に対する既定の属性が定義されている場合は、それらが割り当てられます。|  
+|XmlEntityReference|ソース ドキュメントとターゲット ドキュメントではエンティティの定義が異なる可能性があるため、このメソッドは **XmlEntityReference** ノードだけをコピーします。  置換テキストは含まれません。  インポート先のドキュメントに同じエンティティが定義されている場合は、その値が割り当てられます。|ソース ドキュメントとターゲット ドキュメントではエンティティの定義が異なる可能性があるため、このメソッドは **XmlEntityReference** ノードだけをコピーします。  置換テキストは含まれません。  インポート先のドキュメントに同じエンティティが定義されている場合は、その値が割り当てられます。|  
+|XmlProcessingInstruction|インポートされたノードから、ターゲットおよびデータの値がコピーされます。|インポートされたノードから、ターゲットおよびデータの値がコピーされます。|  
+|XmlText|ノードをそのデータと共にコピーします。|ノードをそのデータと共にコピーします。|  
+|XmlSignificantWhitespace|ノードをそのデータと共にコピーします。|ノードをそのデータと共にコピーします。|  
+|XmlWhitespace|ノードをそのデータと共にコピーします。|ノードをそのデータと共にコピーします。|  
+|XmlDeclaration|インポートされたノードから、ターゲットおよびデータの値がコピーされます。|インポートされたノードから、ターゲットおよびデータの値がコピーされます。|  
+|その他のすべてのノード型|これらのノード型はインポートできません。|これらのノード型はインポートできません。|  
+  
+> [!NOTE]
+>  DocumentType ノードはインポートできますが、1 つのドキュメントは 1 つの DocumentType しか持てません。  したがって、ドキュメント型をインポートした場合は、それをツリーに挿入する前に、ドキュメント内にドキュメント型がないことを確認する必要があります。  ノードの削除については、「[XML ドキュメントからのノード、コンテンツ、値の削除](../../../../docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/create-new-nodes-in-the-dom.md b/docs/standard/data/xml/create-new-nodes-in-the-dom.md
new file mode 100644
index 00000000000..6a18c9bf3ae
--- /dev/null
+++ b/docs/standard/data/xml/create-new-nodes-in-the-dom.md
@@ -0,0 +1,64 @@
+---
+title: "DOM への新しいノードの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 6c2b9789-b61a-49f9-b33f-db01a945edf2
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# DOM への新しいノードの作成
+<xref:System.Xml.XmlDocument>のすべてのノードの種類を作成するメソッドがあります。 このメソッドに、名前が必要な場合は名前を渡し、コンテンツを持つノードではコンテンツやその他のパラメーターを指定すると、そのノードが作成されます。コンテンツを持つノードには、たとえばテキスト ノードがあります。 次のメソッドは、ノードを適切に作成するために、名前といくつかのパラメーターの指定が必要なメソッドです。  
+  
+-   <xref:System.Xml.XmlDocument.CreateCDataSection%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateComment%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateDocumentFragment%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateDocumentType%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateElement%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateNode%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateProcessingInstruction%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateSignificantWhitespace%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateTextNode%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateWhitespace%2A>  
+  
+-   <xref:System.Xml.XmlDocument.CreateXmlDeclaration%2A>  
+  
+ その他のノード型では、パラメーターにデータを与えるだけでなく、他の要件を満たす必要もあります。  
+  
+ 属性については、次を参照してください。 [DOM の要素の新しい属性の作成](../../../../docs/standard/data/xml/creating-new-attributes-for-elements-in-the-dom.md)します。 要素と属性名の検証方法については、次を参照してください。 [XML 要素と属性名の検証を作成するときに新しいノード](../../../../docs/standard/data/xml/xml-element-and-attribute-name-verification-when-creating-new-nodes.md)します。 エンティティ参照を作成するには、次を参照してください。[新しいエンティティ参照の作成](../../../../docs/standard/data/xml/creating-new-entity-references.md)します。 エンティティ参照の展開の名前空間の影響については、次を参照してください。 [Namespace に影響を及ぼす新しいノードを含む要素と属性のエンティティ参照の展開](../../../../docs/standard/data/xml/namespace-affect-on-entity-ref-expansion-for-new-nodes.md)します。  
+  
+ 新しく作成したノードをツリーに挿入するには、いくつかのメソッドを使用できます。 使用できるメソッドと、そのメソッドによって DOM のどこに新しいノードが作成されるかの説明を次の表に示します。  
+  
+|メソッド|ノードの位置|  
+|------------|--------------------|  
+|<xref:System.Xml.XmlNode.InsertBefore%2A>|参照ノードの前に挿入されます。 たとえば、5 番目の位置に新しいノードを挿入するには、次のようにします。<br /><br /> `Dim refChild As XmlNode = node.ChildNodes(4) 'The reference is zero-based.node.InsertBefore(newChild, refChild);`<br /><br /> `XmlNode refChild = node.ChildNodes[4]; //The reference is zero-based. node.InsertBefore(newChild, refChild);`<br /><br /> 詳細については、次を参照してください。、 <xref:System.Xml.XmlNode.InsertBefore%2A>メソッドです。|  
+|<xref:System.Xml.XmlNode.InsertAfter%2A>|参照ノードの後に挿入されます。 例:<br /><br /> `node.InsertAfter(newChild, refChild)`<br /><br /> `node.InsertAfter(newChild, refChild);`<br /><br /> 詳細については、次を参照してください。、 <xref:System.Xml.XmlNode.InsertAfter%2A>メソッドです。|  
+|<xref:System.Xml.XmlNode.AppendChild%2A>|当該ノードの子ノードのリストの末尾にノードを追加します。 追加するノードが場合、 <xref:System.Xml.XmlDocumentFragment>、ドキュメント フラグメントの内容全体がこのノードの子リストに移動されます。 詳細については、次を参照してください。、 <xref:System.Xml.XmlNode.AppendChild%2A>メソッドです。|  
+|<xref:System.Xml.XmlNode.PrependChild%2A>|当該ノードの子ノードのリストの先頭にノードを追加します。 追加するノードが場合、 <xref:System.Xml.XmlDocumentFragment>、ドキュメント フラグメントの内容全体がこのノードの子リストに移動されます。 詳細については、次を参照してください。、 <xref:System.Xml.XmlNode.PrependChild%2A>メソッドです。|  
+|<xref:System.Xml.XmlAttributeCollection.Append%2A>|追加、 <xref:System.Xml.XmlAttribute>要素に関連付けられている属性のコレクションの末尾にノードです。 詳細については、次を参照してください。、 <xref:System.Xml.XmlAttributeCollection.Append%2A>メソッドです。|  
+  
+## <a name="see-also"></a>関連項目  
+ [XML ドキュメント オブジェクト モデル (DOM)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/creating-new-attributes-for-elements-in-the-dom.md b/docs/standard/data/xml/creating-new-attributes-for-elements-in-the-dom.md
new file mode 100644
index 00000000000..0572073f9b1
--- /dev/null
+++ b/docs/standard/data/xml/creating-new-attributes-for-elements-in-the-dom.md
@@ -0,0 +1,134 @@
+---
+title: "DOM の要素に対する新しい属性の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: dd6dc920-b011-418a-b3db-f1580a7d9251
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM の要素に対する新しい属性の作成
+属性はノードではなく、要素ノードのプロパティであり、要素に関連付けられた **XmlAttributeCollection** に格納されるため、新しい属性を作成する方法は、他のノード型を作成する方法と異なります。  属性を作成して要素に追加するには、次の 2 つの方法があります。  
+  
+-   要素ノードを取得し、**SetAttribute** を使用してその要素の属性コレクションに属性を追加します。  
+  
+-   **CreateAttribute** メソッドを使用して **XmlAttribute** ノードを作成します。要素ノードを取得し、**SetAttributeNode** を使用してその要素の属性コレクションにノードを追加します。  
+  
+ **SetAttribute** メソッドを使用して属性を要素に追加する方法を次の例に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+public class Sample  
+  
+  public shared sub Main()  
+  
+  Dim doc as XmlDocument = new XmlDocument()  
+  doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" & _  
+              "<title>Pride And Prejudice</title>" & _  
+              "</book>")  
+  Dim root as XmlElement = doc.DocumentElement  
+  
+  'Add a new attribute.  
+  root.SetAttribute("genre", "urn:samples", "novel")  
+  
+  Console.WriteLine("Display the modified XML...")  
+  Console.WriteLine(doc.InnerXml)  
+  
+  end sub  
+end class  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+  public static void Main()  
+  {  
+    XmlDocument doc = new XmlDocument();  
+    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +  
+                "<title>Pride And Prejudice</title>" +  
+                "</book>");  
+    XmlElement root = doc.DocumentElement;  
+  
+    // Add a new attribute.  
+    root.SetAttribute("genre", "urn:samples", "novel");  
+  
+    Console.WriteLine("Display the modified XML...");  
+    Console.WriteLine(doc.InnerXml);  
+  }  
+```  
+  
+ **CreateAttribute** メソッドを使用して新しい属性を作成する例を次に示します。  属性の作成後、**SetAttributeNode** メソッドを使用して、その属性を **book** 要素の属性コレクションに追加します。  
+  
+ 次の XML を使用します。  
+  
+```  
+<book genre='novel' ISBN='1-861001-57-5'>  
+<title>Pride And Prejudice</title>  
+</book>  
+```  
+  
+ 新しい属性を作成し、その属性の値を設定します。  
+  
+```vb  
+Dim attr As XmlAttribute = doc.CreateAttribute("publisher")  
+   attr.Value = "WorldWide Publishing"  
+```  
+  
+```csharp  
+XmlAttribute attr = doc.CreateAttribute("publisher");  
+attr.Value = "WorldWide Publishing";  
+```  
+  
+ 作成した属性を要素に追加します。  
+  
+```vb  
+doc.DocumentElement.SetAttributeNode(attr)  
+```  
+  
+```csharp  
+doc.DocumentElement.SetAttributeNode(attr);  
+```  
+  
+ **出力**  
+  
+```  
+<book genre="novel" ISBN="1-861001-57-5" publisher="WorldWide Publishing">  
+<title>Pride And Prejudice</title>  
+</book>  
+```  
+  
+ 完全なコード サンプルは、[XmlDocument.CreateAttribute メソッド](frlrfSystemXmlXmlDocumentClassCreateAttributeTopic)のトピックにあります。  
+  
+ **XmlAttribute** ノードを作成した後、**InsertBefore** メソッドまたは **InsertAfter** メソッドを使用して、コレクション内の適切な位置にそのノードを配置することもできます。  同じ名前の属性が属性コレクションに既に含まれている場合、既存の **XmlAttribute** ノードはコレクションから削除され、新しい **XmlAttribute** ノードが挿入されます。  これは、**SetAttribute** メソッドで行われる処理と同じです。  これらのメソッドは、**InsertBefore** や **InsertAfter** を実行するときに、参照ポイントとなる既存のノードをパラメーターとして受け取ります。  新しいノードの挿入位置を示す参照ノードが指定されていないと、**InsertAfter** メソッドは、既定でコレクションの先頭に新しいノードを挿入します。  参照ノードが指定されなかった場合の **InsertBefore** の既定の挿入位置は、コレクションの末尾です。  
+  
+ 属性の **XmlNamedNodeMap** を作成し、[SetNamedItem メソッド](frlrfSystemXmlXmlNamedNodeMapClassSetNamedItemTopic)を使用すると、名前を指定して属性を追加できます。  詳細については、「[NamedNodeMaps と NodeLists のノード コレクション](../../../../docs/standard/data/xml/node-collections-in-namednodemaps-and-nodelists.md)」を参照してください。  
+  
+## 既定の属性  
+ 既定の属性を持つと宣言された要素を作成すると、既定値を持つ新しい既定の属性が XML ドキュメント オブジェクト モデル \(DOM\) によって作成され、その要素に割り当てられます。  既定の属性の子ノードも同時に作成されます。  
+  
+## 属性の子ノード  
+ 属性ノードの値は、その属性の子ノードになります。  有効な子ノードの型は **XmlText** ノードと **XmlEntityReference** ノードの 2 つだけです。  これらのノードは、**FirstChild** や **LastChild** のようなメソッドが子ノードとして処理するという意味で、子ノードと見なされます。  属性が子ノードを持つという点は、属性または属性の子ノードを削除するときに重要になります。  詳細については、「[DOM の要素ノードからの属性の削除](../../../../docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/creating-new-entity-references.md b/docs/standard/data/xml/creating-new-entity-references.md
new file mode 100644
index 00000000000..442ac92da9a
--- /dev/null
+++ b/docs/standard/data/xml/creating-new-entity-references.md
@@ -0,0 +1,35 @@
+---
+title: "新しいエンティティ参照の作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a42f81b3-0403-4e34-b346-7d2129804e54
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 新しいエンティティ参照の作成
+**CreateEntityReference** メソッドによって新しい **XmlEntityReference** ノードを作成できます。  XML ドキュメント オブジェクト モデル \(DOM\) は、参照されているエンティティ名が既に宣言されているかどうかを確認します。  宣言されている場合は、エンティティ宣言ノードから **XmlEntityReference** ノードの子ノードがコピーされます。  一致するエンティティ宣言がない場合、エンティティ参照ノードには、唯一の子として空のテキスト ノードが追加されます。  **XmlEntityReference** ノードの子ノードは別のノードのコピーなので、これらの子ノードは読み取り専用になり、変更はできません。  
+  
+ ノードがコピーされるとき、そのエンティティ参照が存在する位置のスコープに、名前空間が適用されていることがあります。  生成される要素ノードまたは属性ノードの構成は、この名前空間の影響を受けます。  
+  
+> [!NOTE]
+>  DOM は、ドキュメントに **EntityReference** ノードが挿入されたときだけ **EntityReference** に子ノードを追加します。  新しく作成された **EntityReference** ノードには、子ノードはありません。  
+  
+ **XmlDataDocument** は **XmlDocument** の派生クラスですが、**XmlDataDocument** はエンティティ参照の作成をサポートしていません。  **EntityReference** の子が読み取り専用であるためです。  **EntityReference** ノードの子の範囲は、複数の領域にまたがることができます。  この場合は、**EntityReference** の一部を含む領域と関連付けられている行の部分が読み取り専用になります。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/dynamic-updates-to-nodelists-and-namednodemaps.md b/docs/standard/data/xml/dynamic-updates-to-nodelists-and-namednodemaps.md
new file mode 100644
index 00000000000..f14f770a138
--- /dev/null
+++ b/docs/standard/data/xml/dynamic-updates-to-nodelists-and-namednodemaps.md
@@ -0,0 +1,28 @@
+---
+title: "NodeLists および NamedNodeMaps の動的更新 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 76c511fd-6704-4ca4-8078-860a68d898ad
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# NodeLists および NamedNodeMaps の動的更新
+**XmlNodeList** と **XmlNamedNodeMap** にはノード セットが格納されますが、XML ドキュメントはメモリに読み込まれ、変更されるため、W3C \(World Wide Web Consortium\) では、ノード セットが格納されるこれらのオブジェクトは動的でなければならないと規定しています。  つまり、基になっているドキュメントが変更されたら、これら 2 つのオブジェクトも変更される必要があります。  したがって、特定の要素 \(たとえば要素 X\) のすべての子要素が **XmlNodeList** に格納されている場合、別の要素である要素 Q は、要素 X の下のドキュメントに追加されます。  **XmlNodeList** のコレクションにも、その新しい要素 Q を追加する必要があります。  逆の場合も同様です。  **XmlNodeList** にノードが追加された場合は、基になっているドキュメントも同様に更新されます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..a93868406e3
--- /dev/null
+++ b/docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md
@@ -0,0 +1,45 @@
+---
+title: "XPathNavigator による XML データの編集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b1f91616-3115-4264-9821-c66589d11d11
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator による XML データの編集
+<xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XmlDocument> オブジェクトに含まれる XML ドキュメントでノードと値の挿入、変更、および削除を行うメソッドを提供します。  ノードと値の挿入、変更、および削除を行うこれらのメソッドを使用するには、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが編集可能である必要があります。つまり、その <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパティを true にする必要があります。  
+  
+## このセクションの内容  
+ [XPathNavigator による XML データの挿入](../../../../docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスを使用して <xref:System.Xml.XmlDocument> オブジェクトに兄弟、子、および属性のノードと値を挿入する方法について説明します。  
+  
+ [XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスを使用して <xref:System.Xml.XmlDocument> オブジェクトのノードと値を変更する方法について説明します。  
+  
+ [XPathNavigator による XML データの削除](../../../../docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスを使用して <xref:System.Xml.XmlDocument> オブジェクトからノードと値を削除する方法について説明します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)   
+ [XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/editing-xml-schemas.md b/docs/standard/data/xml/editing-xml-schemas.md
new file mode 100644
index 00000000000..8cbe518d909
--- /dev/null
+++ b/docs/standard/data/xml/editing-xml-schemas.md
@@ -0,0 +1,162 @@
+---
+title: "XML スキーマの編集 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: fa09c8e5-c2b9-49d2-bb0d-40330cd13e4d
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマの編集
+XML スキーマの編集は、スキーマ オブジェクト モデル \(SOM\) の最も重要な機能の 1 つです。  XML スキーマの既存の値を変更する場合、SOM のスキーマ コンパイル前のすべてのプロパティを使用できます。  その後、XML スキーマを再コンパイルすると、変更が反映されます。  
+  
+ SOM に読み込まれたスキーマを編集する場合、最初にスキーマの走査を行います。  スキーマを編集する際には、事前に SOM API を使用したスキーマの走査をよく理解しておく必要があります。  また、スキーマのコンパイル後の情報セット \(PSCI\) のうち、スキーマのコンパイル前のプロパティとコンパイル後のプロパティについてもよく理解しておく必要があります。  
+  
+## XML スキーマの編集  
+ このセクションには、2 種類のコード サンプルが用意されています。これらはいずれも「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」で作成したカスタム スキーマを編集します。  最初のコード サンプルは、`Customer` 要素に新しい `PhoneNumber` 要素を追加します。2 番目のコード サンプルは、`FirstName` 要素に新しい `Title` 属性を追加します。  また、最初のサンプルは、スキーマのコンパイル前の <xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName> コレクションをカスタム スキーマを走査する手段として使用しますが、2 番目のコード サンプルはスキーマのコンパイル後の <xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> コレクションを使用します。  
+  
+### PhoneNumber 要素の例  
+ この最初のコード サンプルでは、カスタム スキーマの `Customer` 要素に新しい `PhoneNumber` 要素を追加します。  このコード サンプルでは、次の手順でカスタム スキーマの編集を行います。  
+  
+1.  カスタム スキーマを新しい <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトに追加し、コンパイルします。  スキーマの読み取りまたはコンパイル時に発生するスキーマ検証に関する警告とエラーは、<xref:System.Xml.Schema.ValidationEventHandler> デリゲートで処理されます。  
+  
+2.  <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを反復処理して、<xref:System.Xml.Schema.XmlSchemaSet> からコンパイルされた <xref:System.Xml.Schema.XmlSchema> オブジェクトを取得します。  スキーマはコンパイルされているため、スキーマのコンパイル後の情報セット \(PSCI\) プロパティにアクセスできます。  
+  
+3.  <xref:System.Xml.Schema.XmlSchemaElement> クラスを使用する `PhoneNumber` 要素を作成し、<xref:System.Xml.Schema.XmlSchemaSimpleType> クラスおよび <xref:System.Xml.Schema.XmlSchemaSimpleTypeRestriction> クラスを使用する `xs:string` 単純型の制限を作成し、制限の <xref:System.Xml.Schema.XmlSchemaSimpleTypeRestriction.Facets%2A> プロパティに pattern ファセットを追加し、単純型の <xref:System.Xml.Schema.XmlSchemaSimpleType.Content%2A> プロパティに制限を追加して、`PhoneNumber` 要素の <xref:System.Xml.Schema.XmlSchemaElement.SchemaType%2A> に単純型を追加します。  
+  
+4.  スキーマ コンパイル後の <xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName> コレクションの <xref:System.Xml.Schema.XmlSchemaObjectTable.Values%2A> コレクションで、それぞれの <xref:System.Xml.Schema.XmlSchemaElement> を反復処理します。  
+  
+5.  要素の <xref:System.Xml.Schema.XmlSchemaElement.QualifiedName%2A> が `"Customer"` である場合、<xref:System.Xml.Schema.XmlSchemaComplexType> クラスを使用する複合型の `Customer` 要素と <xref:System.Xml.Schema.XmlSchemaSequence> クラスを使用する複合型の sequence のパーティクルを取得します。  
+  
+6.  シーケンスのスキーマ コンパイル前の <xref:System.Xml.Schema.XmlSchemaSequence.Items%2A> コレクションを使用する既存の `FirstName` 要素および `LastName` 要素を格納するシーケンスに、新しい `PhoneNumber` 要素を追加します。  
+  
+7.  最後に、<xref:System.Xml.Schema.XmlSchemaSet> クラスの <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> および <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドを使用して、変更された <xref:System.Xml.Schema.XmlSchema> オブジェクトの再処理とコンパイルを行って、コンソールに出力します。  
+  
+ 完全なコード サンプルを次に示します。  
+  
+ [!code-cpp[XmlSchemaEditExample1#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaEditExample1/CPP/XmlSchemaEditExample1.cpp#1)]
+ [!code-csharp[XmlSchemaEditExample1#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaEditExample1/CS/XmlSchemaEditExample1.cs#1)]
+ [!code-vb[XmlSchemaEditExample1#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaEditExample1/VB/XmlSchemaEditExample1.vb#1)]  
+  
+ 変更後のカスタム スキーマ \(「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」で作成\) を次に示します。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema xmlns:tns="http://www.tempuri.org" targetNamespace="http://www.tempuri.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:element name="Customer">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="FirstName" type="xs:string" />  
+        <xs:element name="LastName" type="tns:LastNameType" />  
+        <xs:element name="PhoneNumber">  
+          <xs:simpleType>  
+            <xs:restriction base="xs:string">  
+              <xs:pattern value="\d{3}-\d{3}-\d(4)" />  
+            </xs:restriction>  
+          </xs:simpleType>  
+        </xs:element>  
+      </xs:sequence>  
+      <xs:attribute name="CustomerId" type="xs:positiveInteger" use="required" /  
+>  
+    </xs:complexType>  
+  </xs:element>  
+  <xs:simpleType name="LastNameType">  
+    <xs:restriction base="xs:string">  
+      <xs:maxLength value="20" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+```  
+  
+### Title 属性の例  
+ この 2 番目のコード サンプルでは、カスタム スキーマの `FirstName` 要素に新しい `Title` 属性を追加します。  最初のコード サンプルでは、`FirstName` 要素の型が `xs:string` になっています。  `FirstName` 要素が文字列のコンテンツと同時に属性を持つには、単純なコンテンツの拡張コンテンツ モデルを使用してこの要素の型を複合型に変更する必要があります。  
+  
+ このコード サンプルでは、次の手順でカスタム スキーマの編集を行います。  
+  
+1.  カスタム スキーマを新しい <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトに追加し、コンパイルします。  スキーマの読み取りまたはコンパイル時に発生するスキーマ検証に関する警告とエラーは、<xref:System.Xml.Schema.ValidationEventHandler> デリゲートで処理されます。  
+  
+2.  <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを反復処理して、<xref:System.Xml.Schema.XmlSchemaSet> からコンパイルされた <xref:System.Xml.Schema.XmlSchema> オブジェクトを取得します。  スキーマはコンパイルされているため、スキーマのコンパイル後の情報セット \(PSCI\) プロパティにアクセスできます。  
+  
+3.  <xref:System.Xml.Schema.XmlSchemaComplexType> クラスを使用して `FirstName` 要素に対する複合型を新しく作成します。  
+  
+4.  <xref:System.Xml.Schema.XmlSchemaSimpleContent> および <xref:System.Xml.Schema.XmlSchemaSimpleContentExtension> クラスを使用して、`xs:string` の基本型を使った単純なコンテンツの拡張型を新しく作成します。  
+  
+5.  `xs:string` の <xref:System.Xml.Schema.XmlSchemaAttribute.SchemaTypeName%2A> を使用して、<xref:System.Xml.Schema.XmlSchemaAttribute> クラスを使用する `Title` 属性を新しく作成し、その属性を単純なコンテンツの拡張型に追加します。  
+  
+6.  単純なコンテンツのコンテンツ モデルを単純なコンテンツの拡張型に設定し、複合型のコンテンツ モデルを単純なコンテンツに設定します。  
+  
+7.  スキーマ コンパイル前の <xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> コレクションに、新しい複合型を追加します。  
+  
+8.  スキーマのコンパイル前の <xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> コレクションで、それぞれの <xref:System.Xml.Schema.XmlSchemaObject> を反復処理します。  
+  
+> [!NOTE]
+>  `FirstName` 要素はスキーマのグローバル要素ではないため、<xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> または <xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName> コレクションでは使用できません。  コード サンプルでは、`FirstName` 要素を検索するために、最初に `Customer` 要素の検索を行います。  
+>   
+>  最初のコード サンプルでは、スキーマ コンパイル後の <xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName> コレクションを使用してスキーマを走査しました。  このサンプルでは、スキーマ コンパイル前の <xref:System.Xml.Schema.XmlSchema.Items%2A?displayProperty=fullName> コレクションを使用してスキーマを走査します。  どちらのコレクションでもスキーマのグローバル要素にアクセスできますが、<xref:System.Xml.Schema.XmlSchema.Items%2A> コレクションで反復処理を行う場合、スキーマ内のすべてのグローバル要素に対して反復処理を行う必要があり、スキーマに PSCI プロパティが存在しないため、処理時間が長くなります。  PSCI コレクション \(<xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName>、<xref:System.Xml.Schema.XmlSchema.Attributes%2A?displayProperty=fullName>、<xref:System.Xml.Schema.XmlSchema.SchemaTypes%2A?displayProperty=fullName> など\) では、グローバルな要素、属性、型、および PSCI プロパティに直接アクセスできます。  
+  
+1.  <xref:System.Xml.Schema.XmlSchemaObject> が要素 \(その <xref:System.Xml.Schema.XmlSchemaElement.QualifiedName%2A> が `"Customer"`\) である場合、<xref:System.Xml.Schema.XmlSchemaComplexType> クラスを使用する複合型の `Customer` 要素と <xref:System.Xml.Schema.XmlSchemaSequence> クラスを使用する複合型の sequence のパーティクルを取得します。  
+  
+2.  スキーマのコンパイル前の <xref:System.Xml.Schema.XmlSchemaSequence.Items%2A?displayProperty=fullName> コレクションで、それぞれの <xref:System.Xml.Schema.XmlSchemaParticle> を反復処理します。  
+  
+3.  <xref:System.Xml.Schema.XmlSchemaParticle> が要素 \(その <xref:System.Xml.Schema.XmlSchemaElement.QualifiedName%2A> が `"FirstName"`\) である場合、`FirstName` 要素の <xref:System.Xml.Schema.XmlSchemaElement.SchemaTypeName%2A> を新しい `FirstName` 複合型に設定します。  
+  
+4.  最後に、<xref:System.Xml.Schema.XmlSchemaSet> クラスの <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> および <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドを使用して、変更された <xref:System.Xml.Schema.XmlSchema> オブジェクトの再処理とコンパイルを行って、コンソールに出力します。  
+  
+ 完全なコード サンプルを次に示します。  
+  
+ [!code-cpp[XmlSchemaEditExample2#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaEditExample2/CPP/XmlSchemaEditExample2.cpp#1)]
+ [!code-csharp[XmlSchemaEditExample2#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaEditExample2/CS/XmlSchemaEditExample2.cs#1)]
+ [!code-vb[XmlSchemaEditExample2#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaEditExample2/VB/XmlSchemaEditExample2.vb#1)]  
+  
+ 変更後のカスタム スキーマ \(「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」で作成\) を次に示します。  
+  
+```  
+<?xml version="1.0" encoding=" utf-8"?>  
+<xs:schema xmlns:tns="http://www.tempuri.org" targetNamespace="http://www.tempuri.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:element name="Customer">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="FirstName" type="tns:FirstNameComplexType" />  
+        <xs:element name="LastName" type="tns:LastNameType" />  
+      </xs:sequence>  
+      <xs:attribute name="CustomerId" type="xs:positiveInteger" use="required" /  
+>  
+    </xs:complexType>  
+  </xs:element>  
+  <xs:simpleType name="LastNameType">  
+    <xs:restriction base="xs:string">  
+      <xs:maxLength value="20" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+  <xs:complexType name="FirstNameComplexType">  
+    <xs:simpleContent>  
+      <xs:extension base="xs:string">  
+        <xs:attribute name="Title" type="xs:string" />  
+      </xs:extension>  
+    </xs:simpleContent>  
+  </xs:complexType>  
+</xs:schema>  
+```  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)   
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)   
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)   
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)   
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [スキーマのコンパイル後の情報セット](../../../../docs/standard/data/xml/post-schema-compilation-infoset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/entity-references-are-expanded-and-not-preserved.md b/docs/standard/data/xml/entity-references-are-expanded-and-not-preserved.md
new file mode 100644
index 00000000000..5a646693454
--- /dev/null
+++ b/docs/standard/data/xml/entity-references-are-expanded-and-not-preserved.md
@@ -0,0 +1,53 @@
+---
+title: "保持されずに展開されるエンティティ参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ffd97806-ab43-4538-8de2-5828bfbbde57
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 保持されずに展開されるエンティティ参照
+エンティティ参照が展開され、それが表すテキストに置き換えられる場合には、**XmlEntityReference** ノードは作成されません。  この場合はエンティティ宣言が解析され、宣言のコンテンツから作成されたノードが **XmlEntityReference** の代わりにコピーされます。  したがって、`&publisher;` の例では、`&publisher;` は保存されず、代わりに **XmlText** ノードが作成されます。  
+  
+ ![展開されたツリー構造](../../../../docs/standard/data/xml/media/xmlentityref-expanded-nodes.png "xmlentityref\_expanded\_nodes")  
+エンティティ参照が展開される場合のツリー構造  
+  
+ `B` や `<` などの文字エンティティは保持されません。  文字エンティティは常に展開され、テキスト ノードとして表されます。  
+  
+ **XmlEntityReference** ノードと、それに付随するエンティティ参照の子ノードを保持するには、**EntityHandling** フラグを **ExpandCharEntities** に設定します。  それ以外の場合は、**EntityHandling** フラグを既定の **ExpandEntities** のままにしておきます。  その場合、DOM ではエンティティ参照ノードが認識されません。  エンティティ参照ノードは、エンティティ宣言の子ノードのコピーに置き換えられます。  
+  
+ エンティティ参照を保持しない場合の副作用の 1 つとして、そのドキュメントを保存して別のアプリケーションに渡したとき、受け取る側のアプリケーションでは、エンティティ参照によってノードが生成されたことを識別できないという点があります。  しかし、エンティティ参照を保持する場合は、受け取り側アプリケーションがエンティティ参照を認識し、子ノードを読み取ります。  子ノードが、エンティティ宣言に含まれていた情報を表していることは明らかです。  たとえば、エンティティ参照が保持される場合、DOM の構造は理論的に次のようになります。  
+  
+ XmlElement: publisher  
+  
+ XmlEntityReference: `&publisher;`  
+  
+ XmlText: Microsoft Press  
+  
+ DOM でエンティティ参照が展開される場合は、次のようなツリー構造になります。既定のメソッドでは、エンティティ参照が展開されます。  
+  
+ XmlElement: publisher  
+  
+ XmlText: Microsoft Press  
+  
+ エンティティ参照がないため、受け取る側のアプリケーションでは、"Microsoft Press" を含む **XmlText** ノードがエンティティ宣言から作成されたことを識別できません。  
+  
+ エンティティを解決できないリーダーを使用すると、**Load** メソッドは、エンティティ参照を見つけたときに例外をスローします。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/entity-references-are-preserved.md b/docs/standard/data/xml/entity-references-are-preserved.md
new file mode 100644
index 00000000000..2c70060a01c
--- /dev/null
+++ b/docs/standard/data/xml/entity-references-are-preserved.md
@@ -0,0 +1,47 @@
+---
+title: "保持されるエンティティ参照 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 000a6cae-5972-40d6-bd6c-a9b7d9649b3c
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 保持されるエンティティ参照
+エンティティ参照を展開せずに保持する場合、XML ドキュメント オブジェクト モデル \(DOM\) は、エンティティ参照を検出すると **XmlEntityReference** ノードを構築します。  
+  
+ たとえば、次の XML を使用します。  
+  
+```  
+<author>Fred</author>  
+<pubinfo>Published by &publisher;</pubinfo>  
+```  
+  
+ DOM は、`&publisher;`  参照を検出すると **XmlEntityReference** ノードを構築します。  **XmlEntityReference** には、エンティティ宣言のコンテンツからコピーされた子ノードが格納されます。  上記のコード サンプルでは、エンティティ宣言にテキストが含まれているため、エンティティ参照ノードの子ノードとして **XmlText** ノードが作成されます。  
+  
+ ![保持されているエンティティ参照のツリー構造](../../../../docs/standard/data/xml/media/xmlentityref-notexpanded-nodes.gif "xmlentityref\_notexpanded\_nodes")  
+エンティティ参照が保持される場合のツリー構造  
+  
+ **XmlEntityReference** の子ノードは、エンティティ宣言が検出されたときに **XmlEntity** ノードから作成されたすべての子ノードのコピーです。  
+  
+> [!NOTE]
+>  **XmlEntity** からコピーされたノードは、エンティティ参照ノードの下に配置されると、必ずしも元のノードの完全なコピーにはなりません。  エンティティ参照ノードが現れた位置のスコープに名前空間が適用されていると、それが子ノードの最終的な構成に影響する可能性があります。  
+  
+ 既定では、`&abc;` のような一般エンティティは保持され、常に **XmlEntityReference** ノードが作成されます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md b/docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md
new file mode 100644
index 00000000000..4eb14d86e9f
--- /dev/null
+++ b/docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md
@@ -0,0 +1,64 @@
+---
+title: "XPathNavigator による Xpath 式の評価 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2913ccf3-f932-4363-8028-9e2d22ce6093
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator による Xpath 式の評価
+<xref:System.Xml.XPath.XPathNavigator> クラスは、XPath 式を評価する <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドを提供します。  <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドは XPath 式を受け取って評価し、XPath 式の結果に基づいて W3C XPath 型のブール値、数字、文字列、またはノード セットを返します。  
+  
+## Evaluate メソッド  
+ <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドは XPath 式を受け取って評価し、XPath 式の結果に基づいて W3C XPath 型のブール値 \(<xref:System.Boolean>\)、数字 \(<xref:System.Double>\)、文字列 \(<xref:System.String>\)、またはノード セット \(<xref:System.Xml.XPath.XPathNodeIterator>\) を返します。  たとえば、<xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドは数値演算メソッドで使用できます。  次のサンプル コードは、`books.xml` ファイル内の本すべての総額を計算します。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+Dim query As XPathExpression = navigator.Compile("sum(//price/text())")  
+Dim total As Double = CType(navigator.Evaluate(query), Double)  
+Console.WriteLine(total)  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+XPathExpression query = navigator.Compile("sum(//price/text())");  
+Double total = (Double)navigator.Evaluate(query);  
+Console.WriteLine(total);  
+```  
+  
+ この例は、`books.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#1](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/books.xml#1)]  
+  
+### position 関数と last 関数  
+ <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドはオーバーロードされます。  <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドの 1 つは、パラメーターとして <xref:System.Xml.XPath.XPathNodeIterator> オブジェクトを受け取ります。  この特定の <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドは、現在の評価対象コンテキストを指定するノード セット引数を許可することを除き、パラメーターとして <xref:System.Xml.XPath.XPathExpression> オブジェクトだけを受け取る <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドと同じです。  XPath の `position()` 関数および `last()` 関数は現在のコンテキスト ノードに相対的であるため、これらの関数ではコンテキストが必須です。  ロケーション ステップで述語として使用される場合を除き、XPath の `position()` 関数および `last()` 関数では、ノード セットへの参照が評価のために必須です。ノード セットへの参照がない場合、`position` 関数および `last` 関数は `0` を返します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)   
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)   
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)   
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md b/docs/standard/data/xml/event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md
new file mode 100644
index 00000000000..fc773c0b934
--- /dev/null
+++ b/docs/standard/data/xml/event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md
@@ -0,0 +1,218 @@
+---
+title: "XmlNodeChangedEventArgs による XML ドキュメントのイベント処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 0fe844e3-5b6f-4fe7-ad15-22459501738b
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XmlNodeChangedEventArgs による XML ドキュメントのイベント処理
+イベント処理のために **XmlDocument** オブジェクトに登録されたイベント ハンドラーでは、渡された引数が **XmlNodeChangedEventArgs** によってカプセル化されます。  各イベントとその発生するタイミングを次の表に示します。  
+  
+|Event|発生するタイミング|  
+|-----------|---------------|  
+|<xref:System.Xml.XmlDocument.NodeInserting>|現在のドキュメントに属するノードが別のノードに挿入されるとき。|  
+|<xref:System.Xml.XmlDocument.NodeInserted>|現在のドキュメントに属するノードが別のノードに挿入されたとき。|  
+|<xref:System.Xml.XmlDocument.NodeRemoving>|このドキュメントに属するノードがドキュメントから削除されるとき。|  
+|<xref:System.Xml.XmlDocument.NodeRemoved>|このドキュメントに属するノードがその親から削除されたとき。|  
+|<xref:System.Xml.XmlDocument.NodeChanging>|ノードの値が変更されるとき。|  
+|<xref:System.Xml.XmlDocument.NodeChanged>|ノードの値が変更されたとき。|  
+  
+> [!NOTE]
+>  **XmlDataDocument** のメモリの用途が **DataSet** ストレージの利用に完全に最適化されている場合は、基になる **DataSet** が変更された場合でも、上に示したどのイベントも発生しない場合があります。  これらのイベントが必要な場合は、**XmlDocument** 全体を 1 回走査して、メモリ使用の最適化が完全でない状態にします。  
+  
+ イベント ハンドラーを定義する方法、およびイベント ハンドラーをイベントに追加する方法を次のコード サンプルに示します。  
+  
+```vb  
+' Attach the event handler, NodeInsertedHandler, to the NodeInserted  
+' event.  
+Dim doc as XmlDocument = new XmlDocument()  
+Dim XmlNodeChgEHdlr as XmlNodeChangedEventHandler = new XmlNodeChangedEventHandler(addressof MyNodeChangedEvent)   
+AddHandler doc.NodeInserted, XmlNodeChgEHdlr   
+  
+Dim n as XmlNode = doc.CreateElement( "element" )  
+Console.WriteLine( "Before Event Inserting" )   
+  
+' This is the point where the new node is being inserted in the tree,  
+' and this is the point where the NodeInserted event is raised.  
+doc.AppendChild( n )  
+Console.WriteLine( "After Event Inserting" )   
+  
+' Define the event handler that handles the NodeInserted event.  
+sub NodeInsertedHandler(src as Object, args as XmlNodeChangedEventArgs)  
+    Console.WriteLine("Node " + args.Node.Name + " inserted!!")  
+end sub  
+```  
+  
+```csharp  
+// Attach the event handler, NodeInsertedHandler, to the NodeInserted  
+// event.  
+XmlDocument doc = new XmlDocument();  
+doc.NodeInserted += new XmlNodeChangedEventHandler(NodeInsertedHandler);  
+XmlNode n = doc.CreateElement( "element" );  
+Console.WriteLine( "Before Event Inserting" );  
+  
+// This is the point where the new node is being inserted in the tree,  
+// and this is the point where the NodeInserted event is raised.  
+doc.AppendChild( n );  
+Console.WriteLine( "After Event Inserting" );   
+  
+// Define the event handler that handles the NodeInserted event.  
+void NodeInsertedHandler(Object src, XmlNodeChangedEventArgs args)  
+{  
+    Console.WriteLine("Node " + args.Node.Name + " inserted!!");  
+}  
+```  
+  
+ XML ドキュメント オブジェクト モデル \(DOM\) の操作の中には、複数のイベントが発生する複合操作があります。  たとえば **AppendChild** では、追加されるノードを以前の親から削除する必要が生じることがあります。  この場合は、最初に **NodeRemoved** イベントが発生し、次に **NodeInserted** イベントが発生します。  **InnerXml** を設定する操作なども、複数のイベントが発生する結果になります。  
+  
+ イベント ハンドラーを作成する方法および **NodeInserted** イベントを処理する方法を次のコード サンプルに示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports Microsoft.VisualBasic  
+  
+Public Class Sample  
+  
+    Private Const filename As String = "books.xml"  
+  
+    Shared Sub Main()  
+        Dim mySample As Sample = New Sample()  
+        mySample.Run(filename)  
+    End Sub  
+  
+    Public Sub Run(ByVal args As String)  
+        ' Create and load the XML document.  
+        Console.WriteLine("Loading file 0 ...", args)  
+        Dim doc As XmlDocument = New XmlDocument()  
+        doc.Load(args)  
+  
+        ' Create the event handlers.  
+        Dim XmlNodeChgEHdlr As XmlNodeChangedEventHandler = New XmlNodeChangedEventHandler(AddressOf MyNodeChangedEvent)  
+        Dim XmlNodeInsrtEHdlr As XmlNodeChangedEventHandler = New XmlNodeChangedEventHandler(AddressOf MyNodeInsertedEvent)  
+        AddHandler doc.NodeChanged, XmlNodeChgEHdlr  
+        AddHandler doc.NodeInserted, XmlNodeInsrtEHdlr  
+  
+        ' Change the book price.  
+        doc.DocumentElement.LastChild.InnerText = "5.95"  
+  
+        ' Add a new element.  
+        Dim newElem As XmlElement = doc.CreateElement("style")  
+        newElem.InnerText = "hardcover"  
+        doc.DocumentElement.AppendChild(newElem)  
+  
+        Console.WriteLine(Chr(13) + Chr(10) + "Display the modified XML...")  
+        Console.WriteLine(doc.OuterXml)  
+    End Sub  
+  
+    ' Handle the NodeChanged event.  
+    Public Sub MyNodeChangedEvent(ByVal src As Object, ByVal args As XmlNodeChangedEventArgs)  
+        Console.Write("Node Changed Event: <0> changed", args.Node.Name)  
+        If Not (args.Node.Value Is Nothing) Then  
+            Console.WriteLine(" with value  0", args.Node.Value)  
+        Else  
+            Console.WriteLine("")  
+        End If  
+    End Sub  
+  
+    ' Handle the NodeInserted event.  
+    Public Sub MyNodeInsertedEvent(ByVal src As Object, ByVal args As XmlNodeChangedEventArgs)  
+        Console.Write("Node Inserted Event: <0> inserted", args.Node.Name)  
+        If Not (args.Node.Value Is Nothing) Then  
+            Console.WriteLine(" with value 0", args.Node.Value)  
+        Else  
+            Console.WriteLine("")  
+        End If  
+    End Sub  
+  
+End Class        ' End class  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+  private const String filename = "books.xml";  
+  
+  public static void Main()  
+  {  
+     Sample mySample = new Sample();  
+     mySample.Run(filename);  
+  }  
+  
+  public void Run(String args)  
+  {  
+  
+     // Create and load the XML document.  
+     Console.WriteLine ("Loading file {0} ...", args);  
+     XmlDocument doc = new XmlDocument();  
+     doc.Load (args);  
+  
+     // Create the event handlers.  
+     doc.NodeChanged += new XmlNodeChangedEventHandler(this.MyNodeChangedEvent);  
+     doc.NodeInserted += new XmlNodeChangedEventHandler(this.MyNodeInsertedEvent);  
+  
+     // Change the book price.  
+     doc.DocumentElement.LastChild.InnerText = "5.95";  
+  
+     // Add a new element.  
+     XmlElement newElem = doc.CreateElement("style");  
+     newElem.InnerText = "hardcover";  
+     doc.DocumentElement.AppendChild(newElem);  
+  
+     Console.WriteLine("\r\nDisplay the modified XML...");  
+     Console.WriteLine(doc.OuterXml);             
+  
+  }  
+  
+  // Handle the NodeChanged event.  
+  public void MyNodeChangedEvent(Object src, XmlNodeChangedEventArgs args)  
+  {  
+     Console.Write("Node Changed Event: <{0}> changed", args.Node.Name);  
+     if (args.Node.Value != null)  
+     {  
+        Console.WriteLine(" with value  {0}", args.Node.Value);  
+     }  
+     else  
+       Console.WriteLine("");  
+  }  
+  
+  // Handle the NodeInserted event.  
+  public void MyNodeInsertedEvent(Object src, XmlNodeChangedEventArgs args)  
+  {  
+     Console.Write("Node Inserted Event: <{0}> inserted", args.Node.Name);  
+     if (args.Node.Value != null)  
+     {  
+        Console.WriteLine(" with value {0}", args.Node.Value);  
+     }  
+     else  
+        Console.WriteLine("");  
+  }  
+  
+} // End class   
+```  
+  
+ 詳細については、「[XmlNodeChangedEventArgs メンバー](frlrfSystemXmlXmlNodeChangedEventArgsMembersTopic)」および「[XmlNodeChangedEventHandler デリゲート](frlrfSystemXmlXmlNodeChangedEventHandlerClassTopic)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/extending-the-dom.md b/docs/standard/data/xml/extending-the-dom.md
new file mode 100644
index 00000000000..7d15d11b512
--- /dev/null
+++ b/docs/standard/data/xml/extending-the-dom.md
@@ -0,0 +1,258 @@
+---
+title: "DOM の拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b5489c96-4afd-439a-a25d-fc82eb4a148d
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# DOM の拡張
+Microsoft .NET Framework は、XML ドキュメント オブジェクト モデル \(DOM\) の実装を提供するクラスの基本セットを備えています。  <xref:System.Xml.XmlNode> およびその派生クラスのメソッドとプロパティを利用して、XML ドキュメントの内容および構造の中で移動し、それらに対してクエリを実行し、それらを変更することができます。  
+  
+ DOM を使用して XML コンテンツをメモリに読み込むと、作成されたノードには、ノード名やノード型などの情報が格納されます。  場合によっては、基本クラスによっては提供されない特定のノード情報が必要になることもあります。  たとえば、ノードの行番号と位置が必要な場合です。  このような場合は、既存の DOM クラスから新しいクラスを派生させ、追加機能を持たせることができます。  
+  
+ 新しいクラスを派生させるときの一般的なガイドラインは、次の 2 つです。  
+  
+-   <xref:System.Xml.XmlNode> クラスからはクラスを派生させないことをお勧めします。  その代わりに、目的とするノード型に対応するクラスからクラスを派生させることをお勧めします。  たとえば、属性ノードの追加情報を返すようにする場合は、<xref:System.Xml.XmlAttribute> クラスからクラスを派生させます。  
+  
+-   ノード作成メソッド以外の関数をオーバーライドするときは、常にその関数の基本バージョンを呼び出してから、他の処理を追加することをお勧めします。  
+  
+## 独自のノード インスタンスの作成  
+ <xref:System.Xml.XmlDocument> クラスは、ノード作成メソッドを持っています。  XML ファイルが読み込まれると、ノード作成メソッドが呼び出され、ノードが作成されます。  これらのメソッドをオーバーライドすると、ドキュメントが読み込まれるときに独自のノード インスタンスを作成できます。  たとえば、<xref:System.Xml.XmlElement> クラスを拡張すると、<xref:System.Xml.XmlDocument> クラスが継承され、<xref:System.Xml.XmlDocument.CreateElement%2A> メソッドがオーバーライドされます。  
+  
+ <xref:System.Xml.XmlDocument.CreateElement%2A> メソッドをオーバーライドし、<xref:System.Xml.XmlElement> クラスの独自の実装を返す方法を次の例に示します。  
+  
+```vb  
+Class LineInfoDocument  
+    Inherits XmlDocument  
+        Public Overrides Function CreateElement(prefix As String, localname As String, nsURI As String) As XmlElement  
+        Dim elem As New LineInfoElement(prefix, localname, nsURI, Me)  
+        Return elem  
+    End Function 'CreateElement  
+End Class 'LineInfoDocument  
+```  
+  
+```csharp  
+class LineInfoDocument : XmlDocument {  
+  public override XmlElement CreateElement(string prefix, string localname, string nsURI) {  
+  LineInfoElement elem = new LineInfoElement(prefix, localname, nsURI, this);  
+  return elem;  
+  }  
+```  
+  
+## クラスの拡張  
+ クラスを拡張するには、既存の DOM クラスの 1 つから独自のクラスを派生させます。  その後、基本クラスの仮想メソッドやプロパティをオーバーライドしたり、独自のメソッドやプロパティを追加します。  
+  
+ 次の例では、<xref:System.Xml.XmlElement> クラスと <xref:System.Xml.IXmlLineInfo> インターフェイスを実装する新しいクラスを作成しています。  行番号を収集できるようにする追加のメソッドとプロパティが定義されます。  
+  
+```vb  
+Class LineInfoElement  
+   Inherits XmlElement  
+   Implements IXmlLineInfo  
+   Private lineNumber As Integer = 0  
+   Private linePosition As Integer = 0  
+  
+   Friend Sub New(prefix As String, localname As String, nsURI As String, doc As XmlDocument)  
+      MyBase.New(prefix, localname, nsURI, doc)  
+      CType(doc, LineInfoDocument).IncrementElementCount()  
+   End Sub 'New  
+  
+   Public Sub SetLineInfo(linenum As Integer, linepos As Integer)  
+      lineNumber = linenum  
+      linePosition = linepos  
+   End Sub 'SetLineInfo  
+  
+   Public ReadOnly Property LineNumber() As Integer  
+      Get  
+         Return lineNumber  
+      End Get  
+   End Property  
+  
+   Public ReadOnly Property LinePosition() As Integer  
+      Get  
+         Return linePosition  
+      End Get  
+   End Property  
+  
+   Public Function HasLineInfo() As Boolean  
+      Return True  
+   End Function 'HasLineInfo  
+End Class 'LineInfoElement ' End LineInfoElement class.  
+```  
+  
+```csharp  
+class LineInfoElement : XmlElement, IXmlLineInfo {  
+   int lineNumber = 0;  
+   int linePosition = 0;  
+   internal LineInfoElement( string prefix, string localname, string nsURI, XmlDocument doc ) : base( prefix, localname, nsURI, doc ) {  
+       ( (LineInfoDocument)doc ).IncrementElementCount();  
+  }     
+  public void SetLineInfo( int linenum, int linepos ) {  
+      lineNumber = linenum;  
+      linePosition = linepos;  
+  }  
+  public int LineNumber {  
+     get {  
+       return lineNumber;  
+     }  
+  }  
+  public int LinePosition {  
+      get {  
+        return linePosition;  
+      }  
+  }  
+  public bool HasLineInfo() {   
+    return true;   
+  }  
+} // End LineInfoElement class.  
+```  
+  
+### 例  
+ XML ドキュメントの要素数を数える例を次に示します。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+Imports System.IO  
+  
+ _  
+  
+Class LineInfoDocument  
+   Inherits XmlDocument  
+  
+   Private elementCount As Integer  
+  
+   Friend Sub New()  
+      elementCount = 0  
+   End Sub 'New  
+  
+   Public Overrides Function CreateElement(prefix As String, localname As String, nsURI As String) As XmlElement  
+      Dim elem As New LineInfoElement(prefix, localname, nsURI, Me)  
+      Return elem  
+   End Function 'CreateElement  
+  
+   Public Sub IncrementElementCount()  
+      elementCount += 1  
+   End Sub 'IncrementElementCount  
+  
+   Public Function GetCount() As Integer  
+      Return elementCount  
+   End Function 'GetCount  
+End Class 'LineInfoDocument  
+ _ 'End LineInfoDocument class.  
+  
+Class LineInfoElement  
+   Inherits XmlElement  
+  
+   Friend Sub New(prefix As String, localname As String, nsURI As String, doc As XmlDocument)  
+      MyBase.New(prefix, localname, nsURI, doc)  
+      CType(doc, LineInfoDocument).IncrementElementCount()  
+   End Sub 'New  
+End Class 'LineInfoElement  
+ _ 'End LineInfoElement class.   
+  
+Public Class Test  
+  
+   Private filename As [String] = "book.xml"  
+  
+   Public Shared Sub Main()  
+  
+      Dim doc As New LineInfoDocument()  
+      doc.Load(filename)  
+      Console.WriteLine("Number of elements in {0}: {1}", filename, doc.GetCount())  
+   End Sub 'Main   
+End Class 'Test  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+using System.IO;  
+  
+class LineInfoDocument : XmlDocument {  
+  
+  int elementCount;  
+  internal LineInfoDocument():base() {  
+    elementCount = 0;  
+  }  
+  
+  public override XmlElement CreateElement( string prefix, string localname, string nsURI) {  
+    LineInfoElement elem = new LineInfoElement(prefix, localname, nsURI, this );  
+    return elem;  
+  }  
+  
+  public void IncrementElementCount() {  
+     elementCount++;  
+  }  
+  
+  public int GetCount() {  
+     return elementCount;  
+  }  
+} // End LineInfoDocument class.  
+  
+class LineInfoElement:XmlElement {  
+  
+    internal LineInfoElement( string prefix, string localname, string nsURI, XmlDocument doc ):base( prefix,localname,nsURI, doc ){  
+      ((LineInfoDocument)doc).IncrementElementCount();  
+    }     
+} // End LineInfoElement class.  
+  
+public class Test {  
+  
+  const String filename = "book.xml";  
+  public static void Main() {  
+  
+     LineInfoDocument doc =new LineInfoDocument();  
+     doc.Load(filename);      
+     Console.WriteLine("Number of elements in {0}: {1}", filename, doc.GetCount());  
+  
+  }  
+}   
+```  
+  
+##### 入力  
+ book.xml  
+  
+```  
+<!--sample XML fragment-->  
+<book genre='novel' ISBN='1-861001-57-5' misc='sale-item'>  
+  <title>The Handmaid's Tale</title>  
+  <price>14.95</price>  
+</book>  
+```  
+  
+##### 出力  
+  
+```  
+Number of elements in book.xml: 3  
+```  
+  
+ XML DOM クラス \(System.Xml\) を拡張する方法の例については、www.gotdotnet.com\/userfiles\/XMLDom\/extendDOM.zip を参照してください。  
+  
+## ノード イベント ハンドラー  
+ .NET Framework による DOM の実装には、XML ドキュメントのノードが変更されたときにイベントを受け取って処理できるようにする、イベント システムも含まれています。  <xref:System.Xml.XmlNodeChangedEventHandler> クラスと <xref:System.Xml.XmlNodeChangedEventArgs> クラスを使用して、`NodeChanged` イベント、`NodeChanging` イベント、`NodeInserted` イベント、`NodeInserting` イベント、`NodeRemoved` イベント、および `NodeRemoving` イベントをキャプチャできます。  
+  
+ イベント処理プロセスは、派生クラスでも、元の DOM クラスとまったく同じように動作します。  
+  
+ ノード イベント処理の詳細については、「[イベント](../../../../docs/standard/events/index.md)」および「[XmlNodeChangedEventHandler デリゲート](frlrfSystemXmlXmlNodeChangedEventHandlerClassTopic)」を参照してください。  
+  
+## 既定の属性と CreateElement メソッド  
+ 派生クラスの <xref:System.Xml.XmlDocument.CreateElement%2A> メソッドをオーバーライドした場合は、ドキュメントの編集中に新しい要素を作成しても、既定の属性は追加されません。  これは編集中だけの問題です。  <xref:System.Xml.XmlDocument.CreateElement%2A> メソッドが既定の属性を <xref:System.Xml.XmlDocument> に追加する機能を実行するため、この機能は <xref:System.Xml.XmlDocument.CreateElement%2A> メソッドにコーディングする必要があります。  既定の属性が含まれた <xref:System.Xml.XmlDocument> を読み込めば、既定の属性が正しく処理されます。  既定の属性の詳細については、「[DOM の要素に対する新しい属性の作成](../../../../docs/standard/data/xml/creating-new-attributes-for-elements-in-the-dom.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/extending-xslt-style-sheets.md b/docs/standard/data/xml/extending-xslt-style-sheets.md
new file mode 100644
index 00000000000..e0fa9e237cc
--- /dev/null
+++ b/docs/standard/data/xml/extending-xslt-style-sheets.md
@@ -0,0 +1,38 @@
+---
+title: "XSLT スタイル シートの拡張 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: df4ba2bf-a99e-4d22-bbf3-04fc67669dbc
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XSLT スタイル シートの拡張
+このセクションでは、XSLT の機能を拡張するさまざまな方法について説明します。  拡張オブジェクトまたはパラメーターは、<xref:System.Xml.Xsl.XsltArgumentList> クラスを使用して追加できます。  その後、スタイル シートから拡張オブジェクトまたはパラメーターを呼び出すことができます。  また、`msxsl:script` 要素を使用すると、スタイル シートにスクリプト ブロックを埋め込むことができます。  
+  
+## このセクションの内容  
+ [XSLT 拡張オブジェクト](../../../../docs/standard/data/xml/xslt-extension-objects.md)  
+ <xref:System.Xml.Xsl.XsltArgumentList> クラスを使用して XSLT 拡張オブジェクトを処理する方法を説明します。  
+  
+ [XSLT パラメーター](../../../../docs/standard/data/xml/xslt-parameters.md)  
+ <xref:System.Xml.Xsl.XsltArgumentList> クラスを使用して XSLT パラメーターを処理する方法を説明します。  
+  
+ [msxsl:script を使用したスクリプト ブロック](../../../../docs/standard/data/xml/script-blocks-using-msxsl-script.md)  
+ `msxsl:script` 要素の使い方を説明します。  
+  
+## 関連項目  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..870adf9ac48
--- /dev/null
+++ b/docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md
@@ -0,0 +1,178 @@
+---
+title: "XpathNavigator を使用した XML データの抽出 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 095b0987-ee4b-4595-a160-da1c956ad576
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XpathNavigator を使用した XML データの抽出
+Microsoft .NET Framework において XML ドキュメントを表現する方法はいくつかあります。  これには、<xref:System.String> を使用する方法、または <xref:System.Xml.XmlReader>、<xref:System.Xml.XmlWriter>、<xref:System.Xml.XmlDocument>、<xref:System.Xml.XPath.XPathDocument> クラスを使用する方法があります。  XML ドキュメントの異なる表現の間での移行を容易にするため、<xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.String>, <xref:System.Xml.XmlReader> オブジェクトまたは <xref:System.Xml.XmlWriter> オブジェクトとして XML を抽出するためのメソッドおよびプロパティを多数提供しています。  
+  
+## XPathNavigator から文字列への変換  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、XML ドキュメント全体のマークアップ、または 1 つのノードとその子ノードのマークアップだけを取得するために使用されます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティは、ノードの子ノードのマークアップだけを取得します。  
+  
+ 以下は、1 つのノードとその子ノードを保存する方法と、<xref:System.Xml.XPath.XPathNavigator> オブジェクトに含まれる XML ドキュメント全体を <xref:System.String> として保存する方法について説明するサンプル コードです。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("input.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+' Save the entire input.xml document to a string.  
+Dim xml As String = navigator.OuterXml  
+  
+' Now save the Root element and its child nodes to a string.  
+navigator.MoveToChild(XPathNodeType.Element)  
+Dim root As String = navigator.OuterXml  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("input.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+// Save the entire input.xml document to a string.  
+string xml = navigator.OuterXml;  
+  
+// Now save the Root element and its child nodes to a string.  
+navigator.MoveToChild(XPathNodeType.Element);  
+string root = navigator.OuterXml;  
+```  
+  
+## XPathNavigator から XmlReader への変換  
+ <xref:System.Xml.XPath.XPathNavigator.ReadSubtree%2A> メソッドは、XML ドキュメントのコンテンツ全体、または 1 つのノードとその子ノードを <xref:System.Xml.XmlReader> オブジェクトにストリーム出力するために使用されます。  
+  
+ <xref:System.Xml.XmlReader> オブジェクトが現在のノードとその子で作成されている場合、<xref:System.Xml.XmlReader> オブジェクトの <xref:System.Xml.XmlReader.ReadState%2A> プロパティは <xref:System.Xml.ReadState> に設定されます。  <xref:System.Xml.XmlReader> オブジェクトの <xref:System.Xml.XmlReader.Read%2A> メソッドが初めて呼び出されたときに、<xref:System.Xml.XmlReader> が <xref:System.Xml.XPath.XPathNavigator> の現在のノードに移動されます。  新しい <xref:System.Xml.XmlReader> オブジェクトは、XML ツリーの末尾に到達するまで読み取りを継続します。  この時点で、<xref:System.Xml.XmlReader.Read%2A> メソッドは `false` を返し、<xref:System.Xml.XmlReader> オブジェクトの <xref:System.Xml.XmlReader.ReadState%2A> プロパティは <xref:System.Xml.ReadState> に設定されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置は、<xref:System.Xml.XmlReader> オブジェクトの作成または移動によって変更されことはありません。  <xref:System.Xml.XPath.XPathNavigator.ReadSubtree%2A> メソッドは、要素ノードまたはルート ノードに位置している場合にだけ有効です。  
+  
+ 1 つのノードとその子ノードを取得する方法と、<xref:System.Xml.XPath.XPathDocument> オブジェクト内の XML ドキュメント全体を含む <xref:System.Xml.XmlReader> オブジェクトを取得する方法の例を次に示します。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+' Stream the entire XML document to the XmlReader.  
+Dim xml As XmlReader = navigator.ReadSubtree()  
+  
+While xml.Read()  
+    Console.WriteLine(xml.ReadInnerXml())  
+End While  
+  
+xml.Close()  
+  
+' Stream the book element and its child nodes to the XmlReader.  
+navigator.MoveToChild("bookstore", "")  
+navigator.MoveToChild("book", "")  
+  
+Dim book As XmlReader = navigator.ReadSubtree()  
+  
+While book.Read()  
+    Console.WriteLine(book.ReadInnerXml())  
+End While  
+  
+book.Close()  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+// Stream the entire XML document to the XmlReader.  
+XmlReader xml = navigator.ReadSubtree();  
+  
+while (xml.Read())  
+{  
+    Console.WriteLine(xml.ReadInnerXml());  
+}  
+  
+xml.Close();  
+  
+// Stream the book element and its child nodes to the XmlReader.  
+navigator.MoveToChild("bookstore", "");  
+navigator.MoveToChild("book", "");  
+  
+XmlReader book = navigator.ReadSubtree();  
+  
+while (book.Read())  
+{  
+    Console.WriteLine(book.ReadInnerXml());  
+}  
+  
+book.Close();  
+```  
+  
+ この例は、`books.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#1](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/books.xml#1)]  
+  
+## XPathNavigator から XmlWriter への変換  
+ <xref:System.Xml.XPath.XPathNavigator.WriteSubtree%2A> メソッドは、XML ドキュメントのコンテンツ全体、または 1 つのノードとその子ノードを <xref:System.Xml.XmlWriter> オブジェクトにストリーム出力するために使用されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置は、<xref:System.Xml.XmlWriter> オブジェクトの作成によって変更されことはありません。  
+  
+ 1 つのノードとその子ノードを取得する方法と、<xref:System.Xml.XPath.XPathDocument> オブジェクト内の XML ドキュメント全体を含む <xref:System.Xml.XmlWriter> オブジェクトを取得する方法の例を次に示します。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+' Stream the entire XML document to the XmlWriter.  
+Dim xml As XmlWriter = XmlWriter.Create("newbooks.xml")  
+navigator.WriteSubtree(xml)  
+xml.Close()  
+  
+' Stream the book element and its child nodes to the XmlWriter.  
+navigator.MoveToChild("bookstore", "")  
+navigator.MoveToChild("book", "")  
+  
+Dim book As XmlWriter = XmlWriter.Create("book.xml")  
+navigator.WriteSubtree(book)  
+book.Close()  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+// Stream the entire XML document to the XmlWriter.  
+XmlWriter xml = XmlWriter.Create("newbooks.xml");  
+navigator.WriteSubtree(xml);  
+xml.Close();  
+  
+// Stream the book element and its child nodes to the XmlWriter.  
+navigator.MoveToChild("bookstore", "");  
+navigator.MoveToChild("book", "");  
+  
+XmlWriter book = XmlWriter.Create("book.xml");  
+navigator.WriteSubtree(book);  
+book.Close();  
+```  
+  
+ この例は、このトピックの前の方にある `books.xml` ファイルを入力として使用します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)   
+ [XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)   
+ [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](../../../../docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/how-to-migrate-your-xsltransform-code.md b/docs/standard/data/xml/how-to-migrate-your-xsltransform-code.md
new file mode 100644
index 00000000000..3b8ce50cedc
--- /dev/null
+++ b/docs/standard/data/xml/how-to-migrate-your-xsltransform-code.md
@@ -0,0 +1,104 @@
+---
+title: "方法 : XslTransform コードを移行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 910beb2f-cfb3-4e8e-9936-f7e0c5f4064a
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 方法 : XslTransform コードを移行する
+新しい XSLT クラスは、従来のクラスに非常に近いものとなるように設計されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスは <xref:System.Xml.Xsl.XslTransform> クラスを置き換えます。  スタイル シートは <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドを使用してコンパイルされます。  変換は <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドを使用して行われます。  次の手順では、一般的な XSLT 作業を挙げ、<xref:System.Xml.Xsl.XslTransform> クラスと <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコードを比較します。  
+  
+### ファイルを変換して URI に出力するには  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#9](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#9)]
+     [!code-vb[XML_Migration#9](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#9)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#10](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#10)]
+     [!code-vb[XML_Migration#10](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#10)]  
+  
+### スタイル シートをコンパイルして、既定の資格情報でリゾルバーを使用するには  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#11](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#11)]
+     [!code-vb[XML_Migration#11](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#11)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#12](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#12)]
+     [!code-vb[XML_Migration#12](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#12)]  
+  
+### XSLT パラメーターを使用するために必要な処理  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#13](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#13)]
+     [!code-vb[XML_Migration#13](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#13)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#14](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#14)]
+     [!code-vb[XML_Migration#14](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#14)]  
+  
+### XSLT スクリプトを有効にするには  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#15](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#15)]
+     [!code-vb[XML_Migration#15](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#15)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#16](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#16)]
+     [!code-vb[XML_Migration#16](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#16)]  
+  
+### 結果を DOM オブジェクトに読み込むには  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#19](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#19)]
+     [!code-vb[XML_Migration#19](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#19)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+    > [!NOTE]
+    >  <xref:System.Xml.Xsl.XslCompiledTransform> クラスには、XSLT 変換結果を <xref:System.Xml.XmlReader> オブジェクトとして返すメソッドはありません。  しかし、XML ファイルに出力して、その XML ファイルを別のオブジェクトに読み込むことができます。  
+  
+     [!code-csharp[XML_Migration#20](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#20)]
+     [!code-vb[XML_Migration#20](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#20)]  
+  
+### 結果を別のデータ ストアにストリーム出力するには  
+  
+-   <xref:System.Xml.Xsl.XslTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#17](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#17)]
+     [!code-vb[XML_Migration#17](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#17)]  
+  
+-   <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用したコード。  
+  
+     [!code-csharp[XML_Migration#18](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#18)]
+     [!code-vb[XML_Migration#18](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#18)]  
+  
+## 参照  
+ [XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)   
+ [XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md b/docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md
new file mode 100644
index 00000000000..030325a3290
--- /dev/null
+++ b/docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md
@@ -0,0 +1,194 @@
+---
+title: "方法 : アセンブリを使用して XSLT 変換を実行する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 76ee440b-d134-4f8f-8262-b917ad6dcbf6
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 方法 : アセンブリを使用して XSLT 変換を実行する
+XSLT コンパイラ \(xsltc.exe\) は、XSLT スタイル シートをコンパイルしてアセンブリを生成します。  このアセンブリを <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Type%29?displayProperty=fullName> メソッドに直接渡すことができます。  
+  
+### XML ファイルと XSLT ファイルをローカル コンピューターにコピーするには  
+  
+-   XSLT ファイルをローカル コンピューターにコピーし、Transform.xsl という名前を付けます。  
+  
+    ```  
+    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+      xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+      xmlns:user="urn:my-scripts">  
+      <msxsl:script language="C#" implements-prefix="user">  
+        <![CDATA[  
+      public string discount(string price){  
+        char[] trimChars = { '$' };  
+        //trim leading $, convert price to type double  
+        double discount_value = Convert.ToDouble(price.TrimStart(trimChars));  
+        //apply 10% discount and round appropriately  
+        discount_value = .9*discount_value;  
+        //convert value to decimal and format as currency  
+        string discount_price = discount_value.ToString("C");  
+        return discount_price;  
+      }  
+      ]]>  
+      </msxsl:script>  
+      <xsl:template match="catalog">  
+        <html>  
+          <head></head>  
+          <body>  
+            <table border="1">  
+              <tr>  
+                <th align="left">Title</th>  
+                <th align="left">Author</th>  
+                <th align="left">Genre</th>  
+                <th align="left">Publish Date</th>  
+                <th align="left">Price</th>  
+              </tr>  
+              <xsl:for-each select="book">  
+                <tr>  
+                  <td>  
+                    <xsl:value-of select="title"/>  
+                  </td>  
+                  <td>  
+                    <xsl:value-of select="author"/>  
+                  </td>  
+                  <td>  
+                    <xsl:value-of select="genre"/>  
+                  </td>  
+                  <td>  
+                    <xsl:value-of select="publish_date"/>  
+                  </td>  
+                  <xsl:choose>  
+                    <xsl:when test="genre = 'Fantasy'">  
+                      <td>  
+                        <xsl:value-of select="user:discount(price)"/>  
+                      </td>  
+                    </xsl:when>  
+                    <xsl:otherwise>  
+                      <td>  
+                        <xsl:value-of select="price"/>  
+                      </td>  
+                    </xsl:otherwise>  
+                  </xsl:choose>  
+                </tr>  
+              </xsl:for-each>  
+            </table>  
+          </body>  
+        </html>  
+      </xsl:template>  
+    </xsl:stylesheet>  
+    ```  
+  
+-   XML ファイルをローカル コンピューターにコピーし、`books.xml` という名前を付けます。  
+  
+    ```  
+    <?xml version="1.0"?>  
+    <catalog>  
+       <book id="bk101">  
+          <author>Gambardella, Matthew</author>  
+          <title>XML Developer's Guide</title>  
+          <genre>Computer</genre>  
+          <price>$44.95</price>  
+          <publish_date>2000-10-01</publish_date>  
+       </book>  
+       <book id="bk102">  
+          <author>Ralls, Kim</author>  
+          <title>Midnight Rain</title>  
+          <genre>Fantasy</genre>  
+          <price>$5.95</price>  
+          <publish_date>2000-12-16</publish_date>  
+       </book>  
+       <book id="bk103">  
+          <author>Corets, Eva</author>  
+          <title>Maeve Ascendant</title>  
+          <genre>Fantasy</genre>  
+          <price>$5.95</price>  
+          <publish_date>2000-11-17</publish_date>  
+       </book>  
+       <book id="bk106">  
+          <author>Randall, Cynthia</author>  
+          <title>Lover Birds</title>  
+          <genre>Romance</genre>  
+          <price>$4.95</price>  
+          <publish_date>2000-09-02</publish_date>  
+       </book>  
+       <book id="bk107">  
+          <author>Thurman, Paula</author>  
+          <title>Splish Splash</title>  
+          <genre>Romance</genre>  
+          <price>$4.95</price>  
+          <publish_date>2000-11-02</publish_date>  
+       </book>  
+    </catalog>  
+    ```  
+  
+### スクリプトを有効にしてスタイル シートをコンパイルするには  
+  
+1.  コマンド ラインで次のコマンドを実行すると、`Transform.dll` および `Transform_Script1.dll` という名前で 2 つのアセンブリが作成されます \(これが既定の動作です。  他に指定しなければ、既定のクラス名とアセンブリ名はメインのスタイル シートの名前になります\)。  
+  
+    ```  
+    xsltc /settings:script+ Transform.xsl  
+    ```  
+  
+ 次のコマンドを実行すると、クラス名が明示的に Transform に設定されます。  
+  
+```  
+xsltc /settings:script+ /class:Transform Transform.xsl  
+```  
+  
+### コードをコンパイルするときにコンパイル済みアセンブリを参照として含めるには  
+  
+1.  ソリューション エクスプローラーまたはコマンド ラインで参照を追加することで、Visual Studio にアセンブリを含めることができます。  
+  
+2.  コマンド ラインで C\# を使用する場合、次のように入力します。  
+  
+    ```  
+    csc myCode.cs /r:system.dll;system.xml.dll;Transform.dll  
+    ```  
+  
+3.  コマンド ラインで Visual Basic を使用する場合、次のように入力します。  
+  
+    ```  
+    vbc myCode.vb /r:system.dll;system.xml.dll;Transform.dll  
+    ```  
+  
+### コンパイル済みアセンブリをコードで使用するには  
+  
+1.  コンパイルしたスタイル シートを使用して XSLT 変換を実行する方法を次の例に示します。  
+  
+ [!code-csharp[XslTransform_XSLTC#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XslTransform_XSLTC/CS/XslTransform_XSLTC.cs#1)]
+ [!code-vb[XslTransform_XSLTC#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XslTransform_XSLTC/VB/XslTransform_XSLTC.vb#1)]  
+  
+ 上記の例で、コンパイル済みアセンブリへのダイナミック リンクを作成するには、  
+  
+```  
+xslt.Load(typeof(Transform))  
+```  
+  
+ with  
+  
+```  
+xslt.Load(System.Reflection.Assembly.Load("Transform").GetType("Transform"))  
+```  
+  
+ に置き換えます。  Assembly.Load メソッドの詳細については、「<xref:System.Reflection.Assembly.Load%2A>」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XslCompiledTransform>   
+ [XSLT コンパイラ \(xsltc.exe\)](../../../../docs/standard/data/xml/xslt-compiler-xsltc-exe.md)   
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)   
+ [csc.exe を使用したコマンド ラインからのビルド](../../../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/how-to-transform-a-node-fragment.md b/docs/standard/data/xml/how-to-transform-a-node-fragment.md
new file mode 100644
index 00000000000..907409190a8
--- /dev/null
+++ b/docs/standard/data/xml/how-to-transform-a-node-fragment.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : ノード フラグメントを変換する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 73a6c582-b9d7-4fa7-9a05-6d931e1f3de8
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# 方法 : ノード フラグメントを変換する
+<xref:System.Xml.XmlDocument> オブジェクトまたは <xref:System.Xml.XPath.XPathDocument> オブジェクトに含まれるデータを変換すると、XSLT 変換はドキュメント全体に適用されます。  つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。  1 つのノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを別に作成し、そのオブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡します。  
+  
+## 手順  
+  
+#### 1 つのノード フラグメントを変換するには  
+  
+1.  ソース ドキュメントを含むオブジェクトを作成します。  
+  
+2.  変換するノード フラグメントを見つけます。  
+  
+3.  そのノード フラグメントだけの別のオブジェクトを作成します。  
+  
+4.  ノード フラグメントを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡します。  
+  
+## 例  
+ 次の例は、1 つのノード フラグメントを変換して、結果をコンソールに出力します。  
+  
+ [!code-csharp[XSLT_NodeFrag#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XSLT_NodeFrag/CS/xslt_frag.cs#1)]
+ [!code-vb[XSLT_NodeFrag#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XSLT_NodeFrag/VB/xslt_frag.vb#1)]  
+  
+### 入力  
+  
+##### books.xml  
+ [!code-xml[XML_Core_Files#1](../../../../samples/snippets/xml/VS_Snippets_Data/XML_Core_Files/XML/books.xml#1)]  
+  
+##### single.xsl  
+ [!code-xml[XSLT_NodeFrag#2](../../../../samples/snippets/xml/VS_Snippets_Data/XSLT_NodeFrag/XML/single.xsl#2)]  
+  
+### 出力  
+ Book title is The Confidence Man.  
+  
+## 参照  
+ [XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/implementation-of-discretionary-behaviors-in-the-xsltransform-class.md b/docs/standard/data/xml/implementation-of-discretionary-behaviors-in-the-xsltransform-class.md
new file mode 100644
index 00000000000..64f3e940a55
--- /dev/null
+++ b/docs/standard/data/xml/implementation-of-discretionary-behaviors-in-the-xsltransform-class.md
@@ -0,0 +1,95 @@
+---
+title: "XslTransform クラスの随意動作の実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d2758ea1-03f6-47bd-88d2-0fb7ccdb2fab
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XslTransform クラスの随意動作の実装
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslTransform> では、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] クラスが廃止されています。<xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。 詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ 随意動作とは、W3C \(World Wide Web Consortium\) 勧告『XSL Transformations \(XSLT\) Version 1.0』\(www.w3.org\/TR\/xslt\) で列挙されている動作で、ある状況に対処する手段として、実装プロバイダーが複数のオプションから 1 つ選択するものです。 たとえば、W3C Recommendation は、セクション 7.3「Creating Processing Instructions」で、`xsl:processing-instruction` の内容をインスタンス化したときに、テキスト ノード以外のノードが作成されるのはエラーであるとしています。 いくつかの問題に関しては、プロセッサがエラー状態から回復するときにどのような対処をするべきかを、W3C が規定しています。 セクション 7.3 に記述されている問題に関しては、W3C では、作成されたノードとその内容を無視することで、このエラーから回復できるとしています。  
+  
+ W3C で許可されている随意動作について、[!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の <xref:System.Xml.Xsl.XslTransform> クラスに実装されている随意動作と、その問題について記述している W3C 勧告『XSLT 1.0』のセクションを次の表に示します。  
+  
+|問題|動作|セクション|  
+|--------|--------|-----------|  
+|テキスト ノードが `xsl:strip-space` と `xsl:preserve-space` の両方に適合している。|復元|3.4|  
+|ソース ノードが複数のテンプレート規則に適合している。|復元|5.5|  
+|1 つの名前空間 URI \(Uniform Resource Identifier\) が同じインポート優先順位を持つ複数の名前空間 URI のエイリアスとして宣言されている。|復元|7.1.1|  
+|属性値テンプレートから生成された `xsl:attribute` と `xsl:element` 内の名前属性が有効な QName \(修飾名\) ではない。|例外をスロー|7.1.2 および 7.1.3|  
+|要素ノードに子ノードが既に追加されているにもかかわらず、その要素に属性が追加される。|復元|7.1.3|  
+|要素ノード以外のノードに属性が追加される。|復元|7.1.3|  
+|`xsl:attribute` 要素のコンテンツをインスタンス化してもテキスト ノードが作成されない。|復元|7.1.3|  
+|2 つの属性セットが同じインポート優先順位と展開名を持っている。 両方が同じ属性を持っており、同じ名前を持ち、より重要度の高い共通の属性が含まれた属性セットが他にない。|復元|7.1.4|  
+|`xsl:processing-instruction` 名前属性が NCName \(コロンが含まれていない名前\) も処理命令ターゲットも生成しない。|復元|7.3|  
+|`xsl:processing-instruction` の内容をインスタンス化すると、テキスト ノード以外のノードが作成される。|復元|7.3|  
+|`xsl:processing-instruction` の内容をインスタンス化した結果に文字列 "`?>`" が含まれている。|復元|7.3|  
+|`xsl:comment`  の内容をインスタンス化した結果に文字列 "\-\-" が含まれているか、結果が "\-" で終了している。|復元|7.4|  
+|`xsl:comment` の内容をインスタンス化した結果、テキスト ノード以外のノードが作成される。|復元|7.4|  
+|変数バインディング要素内のテンプレートが属性ノードまたは名前空間ノードを返す。|復元|11.2|  
+|document 関数に渡された URI からのリソースの取得時にエラーが発生する。|例外をスロー|12.1|  
+|document 関数内の URI 参照にフラグメント ID が含まれており、その ID を処理するとエラーが発生する。|例外をスロー|12.1|  
+|同じ名前 \(`cdata-section-elements` の `xls:output` 以外\) を持つ複数の属性があり、これらの属性が同じインポート優先順位を持つ。|復元|16|  
+|プロセッサが `encoding` 要素の `xsl:output` 属性で指定されている文字エンコード値をサポートしない。|復元|16.1|  
+|`disable-output-escaping` がテキスト ノードに使用されており、そのテキスト ノードを使用して、結果ツリーにテキスト ノード以外のものが作成されている。|`disable-output-escaping` 属性を無視|16.4|  
+|出力エスケープが有効に設定されているテキスト ノードが結果ツリー フラグメントに含まれている場合に、そのフラグメントが数値や文字列に変換される。|無視|16.4|  
+|XSLT プロセッサが出力に使用しているエンコーディングで表すことができない文字に対して、出力エスケープが無効に設定される。|無視|16.4|  
+|要素に子または属性が追加された後で、その要素に名前空間ノードが追加される。|復元|正誤表 e25|  
+|`xsl:number` が NaN、無限、または 0.5 未満である。|復元|正誤表 e24|  
+|document 関数への 2 番目の引数ノード セットが空であり、URI 参照が相対 URI 参照である。|復元|正誤表 e14|  
+  
+ 正誤表は、W3C \(World Wide Web Consortium\) の『XSL Transformations \(XSLT\) Version 1.0 Specification Errata』\(www.w3.org\/1999\/11\/REC\-xslt\-19991116\-errata\/\) にあります。  
+  
+## カスタム定義の動作の実装  
+ <xref:System.Xml.Xsl.XslTransform> クラスの実装には固有の動作があります。 このセクションでは、`xsl:sort` のプロバイダー固有の実装と、<xref:System.Xml.Xsl.XslTransform> クラスでサポートされているオプション機能について説明します。  
+  
+## xsl:sort  
+ W3C 勧告『XSLT 1.0』には、変換を使用した並べ替えに関する留意事項の記述があります。 それらは次のとおりです。  
+  
+-   2 つの XSLT プロセッサの両方が勧告に準拠している場合でも、それらの並べ替え動作は異なることがあります。  
+  
+-   すべての XSLT プロセッサが同じ言語をサポートするわけではありません。  
+  
+-   言語については、`xsl:sort.` で指定されていない特定の言語での並べ替え動作がプロセッサによって異なる場合があります。  
+  
+ <xref:System.Xml.Xsl.XslTransform> を使用した変換の .NET Framework の実装で各データ型に対して実装されている並べ替え動作を次の表に示します。  
+  
+|データ型|並べ替え動作|  
+|----------|------------|  
+|Text|データは、共通言語ランタイム \(CLR: Common Language Runtime\) の String.Compare メソッドとカルチャ ロケールを使用して並べ替えられます。 データ型が "テキスト" である場合、<xref:System.Xml.Xsl.XslTransform> クラスの並べ替え動作は、CLR の文字列比較動作と同じです。|  
+|Number|数値は、XPath \(XML Path Language\) 数値として処理され、W3C 勧告『XML Path Language \(XPath\) Version 1.0』のセクション 3.5 \(www.w3.org\/TR\/xpath.html\#numbers\) に記述されている方法に従って並べ替えられます。|  
+  
+## サポートされているオプション機能  
+ XSLT プロセッサがオプションで実装する機能を次に示します。これらの機能は、<xref:System.Xml.Xsl.XslTransform> クラスに実装されます。  
+  
+|機能|参照先|メモ|  
+|--------|---------|--------|  
+|`disable-output-escaping` タグと `<xsl:text...>` タグの `<xsl:value-of...>` 属性|W3C 勧告『XSLT 1.0』<br /><br /> セクション 16.4|`disable-output-escaping` 要素または `xsl:text` 要素が `xsl:value-of`、`xsl:comment`、または `xsl:processing-instruction` のいずれかの要素で使用される場合、`xsl:attribute` 属性は無視されます。<br /><br /> テキストが含まれた結果ツリー フラグメントおよびエスケープされたテキスト出力はサポートされません。<br /><br /> <xref:System.Xml.XmlReader> オブジェクトまたは <xref:System.Xml.XmlWriter> オブジェクトへの変換時には、disable\-output\-escaping 属性が無視されます。|  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XslTransform>   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)   
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [変換における XPathNavigator](../../../../docs/standard/data/xml/xpathnavigator-in-transformations.md)   
+ [変換における XPathNodeIterator](../../../../docs/standard/data/xml/xpathnodeiterator-in-transformations.md)   
+ [XslTransform への XPathDocument の入力](../../../../docs/standard/data/xml/xpathdocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDataDocument の入力](../../../../docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDocument の入力](../../../../docs/standard/data/xml/xmldocument-input-to-xsltransform.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/including-or-importing-xml-schemas.md b/docs/standard/data/xml/including-or-importing-xml-schemas.md
new file mode 100644
index 00000000000..871ee1c6c6a
--- /dev/null
+++ b/docs/standard/data/xml/including-or-importing-xml-schemas.md
@@ -0,0 +1,114 @@
+---
+title: "XML スキーマのインクルードまたはインポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: fe1b4a11-37f4-4e1a-93c9-239f4fe736c0
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマのインクルードまたはインポート
+XML スキーマには、`<xs:import />` 要素、`<xs:include />` 要素、および `<xs:redefine />` 要素を含めることができます。  これらのスキーマ要素は、インクルードまたはインポートするスキーマの構造を補足するために使用できる他の XML スキーマを参照します。  <xref:System.Xml.Schema.XmlSchemaImport> クラス、<xref:System.Xml.Schema.XmlSchemaInclude> クラス、および <xref:System.Xml.Schema.XmlSchemaRedefine> クラスは、スキーマ オブジェクト モデル \(SOM\) API でこれらの要素にマップされます。  
+  
+## XML スキーマのインクルードまたはインポート  
+ 次のコード サンプルは、アドレス スキーマを使用して「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」で作成したカスタム スキーマを補足します。  アドレス スキーマを使用してカスタム スキーマを補足すると、カスタム スキーマでアドレス型が使用できるようになります。  
+  
+ アドレス スキーマを統合するには、`<xs:include />` 要素または `<xs:import />` 要素を使用して、アドレス スキーマのコンポーネントをそのまま使用するか、または `<xs:redefine />` 要素を使用して、カスタム スキーマのニーズに合わせてコンポーネントを変更します。  アドレス スキーマの `targetNamespace` はカスタム スキーマのものとは異なっているため、`<xs:import />` 要素 \(インポートのセマンティクス\) が使用されます。  
+  
+ このコード サンプルでは、アドレス スキーマのインクルードを次の手順で行います。  
+  
+1.  カスタム スキーマとアドレス スキーマを新しい <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトに追加し、コンパイルします。  スキーマの読み込みまたはコンパイル時に発生するスキーマ検証に関する警告とエラーは、<xref:System.Xml.Schema.ValidationEventHandler> デリゲートによって処理されます。  
+  
+2.  <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを反復処理して、<xref:System.Xml.Schema.XmlSchemaSet> からカスタム スキーマとアドレス スキーマの両方に対するコンパイルされた <xref:System.Xml.Schema.XmlSchema> オブジェクトを取得します。  これらのスキーマはコンパイルされているため、スキーマのコンパイル後の情報セット \(PSCI\) プロパティにアクセスできます。  
+  
+3.  <xref:System.Xml.Schema.XmlSchemaImport> オブジェクトを作成し、インポートの <xref:System.Xml.Schema.XmlSchemaImport.Namespace%2A> プロパティをアドレス スキーマの名前空間に設定し、インポートの <xref:System.Xml.Schema.XmlSchemaExternal.Schema%2A> プロパティをアドレス スキーマの <xref:System.Xml.Schema.XmlSchema> オブジェクトに設定して、カスタム スキーマの <xref:System.Xml.Schema.XmlSchema.Includes%2A> プロパティにインポートを追加します。  
+  
+4.  <xref:System.Xml.Schema.XmlSchemaSet> クラスの <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドおよび <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドを使用して、カスタム スキーマの変更された <xref:System.Xml.Schema.XmlSchema> オブジェクトの再処理とコンパイルを行って、コンソールに出力します。  
+  
+5.  最後に、カスタム スキーマの <xref:System.Xml.Schema.XmlSchema.Includes%2A> プロパティを使用して、カスタム スキーマにインポートされたすべてのスキーマを再帰的にコンソールに出力します。  <xref:System.Xml.Schema.XmlSchema.Includes%2A> プロパティを使用すると、スキーマに追加されたすべてのインクルード、インポート、および再定義にアクセスできます。  
+  
+ 以下に、完全なコード サンプルおよびコンソールに出力されるカスタム スキーマとアドレス スキーマを示します。  
+  
+ [!code-cpp[XmlSchemaImportExample#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaImportExample/CPP/XmlSchemaImportExample.cpp#1)]
+ [!code-csharp[XmlSchemaImportExample#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaImportExample/CS/XmlSchemaImportExample.cs#1)]
+ [!code-vb[XmlSchemaImportExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaImportExample/VB/XmlSchemaImportExample.vb#1)]  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<xs:schema xmlns:tns="http://www.tempuri.org" targetNamespace="http://www.tempuri.org" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+  <xs:import namespace="http://www.example.com/IPO" />  
+  <xs:element name="Customer">  
+    <xs:complexType>  
+      <xs:sequence>  
+        <xs:element name="FirstName" type="xs:string" />  
+        <xs:element name="LastName" type="tns:LastNameType" />  
+      </xs:sequence>  
+      <xs:attribute name="CustomerId" type="xs:positiveInteger" use="required" /  
+>  
+    </xs:complexType>  
+  </xs:element>  
+  <xs:simpleType name="LastNameType">  
+    <xs:restriction base="xs:string">  
+      <xs:maxLength value="20" />  
+    </xs:restriction>  
+  </xs:simpleType>  
+</xs:schema>  
+<schema targetNamespace="http://www.example.com/IPO" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:ipo="http://www.example.com/IPO">  
+  <annotation>  
+    <documentation xml:lang="en">  
+      Addresses for International Purchase order schema  
+      Copyright 2000 Example.com. All rights reserved.  
+    </documentation>  
+  </annotation>  
+  <complexType name="Address">  
+    <sequence>  
+      <element name="name"   type="string"/>  
+      <element name="street" type="string"/>  
+      <element name="city"   type="string"/>  
+    </sequence>  
+  </complexType>  
+  <complexType name="USAddress">  
+    <complexContent>  
+      <extension base="ipo:Address">  
+        <sequence>  
+          <element name="state" type="ipo:USState"/>  
+          <element name="zip"   type="positiveInteger"/>  
+        </sequence>  
+      </extension>  
+    </complexContent>  
+  </complexType>  
+  <!-- other Address derivations for more countries or regions -->  
+  <simpleType name="USState">  
+    <restriction base="string">  
+      <enumeration value="AK"/>  
+      <enumeration value="AL"/>  
+      <enumeration value="AR"/>  
+      <!-- and so on ... -->  
+    </restriction>  
+  </simpleType>  
+</schema>  
+```  
+  
+ `<xs:import />` 要素、`<xs:include />` 要素、`<xs:redefine />` 要素、および<xref:System.Xml.Schema.XmlSchemaImport> クラス、<xref:System.Xml.Schema.XmlSchemaInclude> クラス、<xref:System.Xml.Schema.XmlSchemaRedefine> クラスの詳細については、「[W3C XML スキーマ](http://go.microsoft.com/fwlink/?LinkId=45242)」および <xref:System.Xml.Schema?displayProperty=fullName> 名前空間クラスのリファレンス ドキュメントを参照してください。  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)   
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)   
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)   
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)   
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/index.md b/docs/standard/data/xml/index.md
new file mode 100644
index 00000000000..e0b11ec0d9e
--- /dev/null
+++ b/docs/standard/data/xml/index.md
@@ -0,0 +1,99 @@
+---
+title: "XML ドキュメントと XML データ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: e695047f-3c0f-4045-8708-5baea91cc380
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# XML ドキュメントと XML データ
+.NET Framework には、XML 対応アプリを容易に構築するための、包括的で統合された一連のクラスが用意されています。  次の名前空間のクラスでは、XML の解析と書き込み、メモリ内での XML データの編集、データの検証、および XSLT 変換がサポートされます。  
+  
+-   <xref:System.Xml>  
+  
+-   <xref:System.Xml.XPath>  
+  
+-   <xref:System.Xml.Xsl>  
+  
+-   <xref:System.Xml.Schema>  
+  
+-   <xref:System.Xml.Linq>  
+  
+ 一覧については、「[System.Xml 名前空間](http://msdn.microsoft.com/library/gg145036.aspx)」Web ページを参照してください。  
+  
+ 次の名前空間のクラスでは、World Wide Web Consortium \(W3C\) 勧告がサポートされます。  次に例を示します。  
+  
+-   <xref:System.Xml.XmlDocument?displayProperty=fullName> クラスは、[W3C ドキュメント オブジェクト モデル \(DOM\) 勧告の DOM Level 1 Core](http://www.w3.org/TR/REC-DOM-Level-1/) および [DOM Level 2 Core](http://www.w3.org/TR/DOM-Level-2-Core/) を実装しています。  
+  
+-   <xref:System.Xml.XmlReader?displayProperty=fullName> クラスと <xref:System.Xml.XmlWriter?displayProperty=fullName> クラスは、W3C 勧告『[XML 1.0](http://www.w3.org/TR/2006/REC-xml-20060816/)』および『[Namespaces in XML](http://www.w3.org/TR/REC-xml-names/)』をサポートしています。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaSet?displayProperty=fullName> クラスのスキーマは、W3C 勧告『[XML Schema Part 1: Structures](http://www.w3.org/TR/xmlschema-1/)』および『[XML Schema Part 2: Datatypes](http://www.w3.org/TR/xmlschema-2/)』をサポートしています。  
+  
+-   <xref:System.Xml.Xsl?displayProperty=fullName> 名前空間のクラスは、W3C 勧告『[XSLT 1.0](http://www.w3.org/TR/xslt)』に準拠する XSLT 変換をサポートしています。  
+  
+ .NET Framework の XML クラスの利点を次に示します。  
+  
+-   **生産性。** [LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) により XML でのプログラミングがさらに容易になるほか、SQL と同じようにクエリを利用できます。  
+  
+-   **機能拡張。**.NET Framework の XML クラスは、抽象基本クラスと仮想メソッドを使用することによって拡張できます。  たとえば、キャッシュ ストリームをローカルのディスクに格納する <xref:System.Xml.XmlUrlResolver> クラスの派生クラスを作成できます。  
+  
+-   **プラグ可能なアーキテクチャ。**.NET Framework が提供するアーキテクチャでは、コンポーネントが相互に利用できます。また、コンポーネント間でデータをストリーム転送できます。  たとえば、<xref:System.Xml.XPath.XPathDocument> オブジェクト、<xref:System.Xml.XmlDocument> オブジェクトなどのデータ ストアは、<xref:System.Xml.Xsl.XslCompiledTransform> クラスを使って変換でき、その出力は、別のストアにストリーム転送することも、Web サービスからのストリームとして返すこともできます。  
+  
+-   **パフォーマンス。**アプリのパフォーマンスを高めるために、.NET Framework の一部の XML クラスはストリーム ベースのモデルをサポートし、次の特性を備えています。  
+  
+    -   キャッシング処理を最小限に抑える前方参照専用のプル モデル解析 \(<xref:System.Xml.XmlReader>\)。  
+  
+    -   前方参照専用の検証 \(<xref:System.Xml.XmlReader>\)。  
+  
+    -   作成するノードを単一の仮想ノードに抑えながら、ドキュメントへのランダム アクセスを可能にする、カーソル スタイルのナビゲーション \(<xref:System.Xml.XPath.XPathNavigator>\)。  
+  
+     XSLT 処理が必要になるときのパフォーマンスを常に高めるために、<xref:System.Xml.XPath.XPathDocument> クラスを使用できます。このクラスは、<xref:System.Xml.Xsl.XslCompiledTransform> クラスと効率よく連携するように設計された、XPath クエリ用の最適化された読み取り専用ストアです。  
+  
+-   **ADO.NET との統合。**XML クラスと [ADO.NET](../../../../docs/framework/data/adonet/index.md) が緊密に統合されることで、リレーショナル データと XML が結合されます。  <xref:System.Data.DataSet> クラスは、データベースから取得されたデータのメモリ内キャッシュです。  <xref:System.Data.DataSet> クラスは、<xref:System.Xml.XmlReader> クラスと <xref:System.Xml.XmlWriter> クラスを使用して XML を読み書きする機能、内部リレーショナル スキーマ構造を XML スキーマ \(XSD\) として永続化する機能、および XML ドキュメントからスキーマ構造を推論する機能を備えています。  
+  
+## このセクションの内容  
+ [XML の処理オプション](../../../../docs/standard/data/xml/xml-processing-options.md)  
+ XML データの処理に関するオプションについて説明します。  
+  
+ [メモリ内の XML データの処理](../../../../docs/standard/data/xml/processing-xml-data-in-memory.md)  
+ XML データをメモリ内で処理する 3 つの方法について説明します。  [LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md)、<xref:System.Xml.XmlDocument> クラス \(W3C ドキュメント オブジェクト モデルに基づく\)、および <xref:System.Xml.XPath.XPathDocument> クラス \(XPath データ モデルに基づく\)。  
+  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)  
+ XSLT プロセッサの使い方について説明します。  
+  
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)  
+ スキーマの読み込みと編集のための <xref:System.Xml.Schema.XmlSchema> クラスを提供することで、XML スキーマ \(XSD\) の作成と操作に使用されるクラスについて説明します。  
+  
+ [XML とリレーショナル データおよび ADO.NET との統合](../../../../docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md)  
+ .NET Framework が <xref:System.Data.DataSet> オブジェクトと <xref:System.Xml.XmlDataDocument> オブジェクトを介して、データのリレーショナル表現および階層表現の両方に対するリアルタイムの同期アクセスを実現するしくみついて説明します。  
+  
+ [XML ドキュメントでの名前空間の管理](../../../../docs/standard/data/xml/managing-namespaces-in-an-xml-document.md)  
+ <xref:System.Xml.XmlNamespaceManager> クラスを使用して、名前空間情報を格納および保持する方法について説明します。  
+  
+ [System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)  
+ XML データ型を CLR 型にマップする方法、XML データ型を変換する方法、および <xref:System.Xml> クラスのその他の型サポート機能について説明します。  
+  
+## 関連項目  
+ [ADO.NET](../../../../docs/framework/data/adonet/index.md)  
+ ADO.NET を使用してデータにアクセスする方法について説明します。  
+  
+ [セキュリティ](../../../../docs/standard/security/index.md)  
+ .NET Framework セキュリティ システムの概要を説明します。  
+  
+ [XML デベロッパー センター](http://go.microsoft.com/fwlink/?linkid=42458)  
+ 追加の技術情報、ダウンロード、ニュースグループ、および XML 開発者向けのその他のリソースを提供します。
\ No newline at end of file
diff --git a/docs/standard/data/xml/inferring-an-xml-schema.md b/docs/standard/data/xml/inferring-an-xml-schema.md
new file mode 100644
index 00000000000..57fbd88635a
--- /dev/null
+++ b/docs/standard/data/xml/inferring-an-xml-schema.md
@@ -0,0 +1,42 @@
+---
+title: "XML スキーマの推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b18e7ffd-3c04-482d-9934-ba2f6a59b2c9
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマの推論
+スキーマ オブジェクト モデル \(SOM\) <xref:System.Xml.Schema.XmlSchemaInference> クラスを使用して、XML ドキュメントの構造から XML スキーマ定義言語 \(XSD\) スキーマを推論する方法を説明します。  
+  
+ <xref:System.Xml.Schema?displayProperty=fullName> 名前空間内のスキーマ オブジェクト モデル \(SOM\) <xref:System.Xml.Schema.XmlSchemaInference> クラスを使用すれば、XML ドキュメントの構造から XML スキーマ定義言語 \(XSD\) スキーマを推論できます。  <xref:System.Xml.Schema.XmlSchemaInference> クラスは XML ドキュメントの検証に使える XML スキーマを出力します。  
+  
+## このセクションの内容  
+ [XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスを使用して XML ドキュメントの構造からスキーマを推論する方法を説明します。  
+  
+ [スキーマのノード型および構造を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md)  
+ XML ドキュメントで検出されたノード型をスキーマ構造に変換する推論のプロセスを説明します。  
+  
+ [単純型を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-simple-types.md)  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスが属性と要素のデータ型を推論する方法を説明します。  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)   
+ [XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)   
+ [スキーマのノード型および構造を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/inferring-schemas-from-xml-documents.md b/docs/standard/data/xml/inferring-schemas-from-xml-documents.md
new file mode 100644
index 00000000000..2b322eb7e54
--- /dev/null
+++ b/docs/standard/data/xml/inferring-schemas-from-xml-documents.md
@@ -0,0 +1,95 @@
+---
+title: "XML ドキュメントからのスキーマの推論 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f3d97d53-614d-4a04-a174-87965b7405f6
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML ドキュメントからのスキーマの推論
+このトピックでは、<xref:System.Xml.Schema.XmlSchemaInference> クラスを使用して、XML ドキュメントの構造から XML スキーマ定義言語 \(XSD\) スキーマを推論する方法を説明します。  
+  
+## スキーマの推論プロセス  
+ <xref:System.Xml.Schema?displayProperty=fullName> 名前空間の <xref:System.Xml.Schema.XmlSchemaInference> クラスを使用して、XML ドキュメントの構造から 1 つ以上の XML スキーマ定義言語 \(XSD\) スキーマを生成できます。  生成されるスキーマは、元の XML ドキュメントの検証に使用できます。  
+  
+ XML ドキュメントは <xref:System.Xml.Schema.XmlSchemaInference> クラスによって処理されます。<xref:System.Xml.Schema.XmlSchemaInference> クラスは、XML ドキュメント上の要素と属性を定義するスキーマ コンポーネントに関する推測を行います。  <xref:System.Xml.Schema.XmlSchemaInference> クラスは、特定の要素または属性について最も限定的な型を推論することにより、制限された方法でスキーマ コンポーネントを推論します。  XML ドキュメントに関する情報の蓄積が進むほど、より限定度の低い型が推論されることで、制約が緩和されます。  最も限定度が低い推論可能な型は `xs:string` です。  
+  
+ たとえば、次の XML ドキュメントを見てみましょう。  
+  
+```  
+<parent attribute1="6">  
+    <child>One</child>  
+    <child>Two</child>  
+</parent>  
+<parent attribute1="A">  
+```  
+  
+ 上の例で `attribute1` 属性の値 `6` が <xref:System.Xml.Schema.XmlSchemaInference> プロセスによって検出されると、この属性は `xs:unsignedByte` 型であると想定されます。  2 番目の `parent` 要素が <xref:System.Xml.Schema.XmlSchemaInference> プロセスによって検出されると、`attribute1` 属性の値が `A` であるため、型が `xs:string` に変更され、制限が緩和されます。  同様に、2 番目の親要素が子要素を持っていないため、スキーマで推論されるすべての `child` 要素の `minOccurs` 属性が `minOccurs="0"` に緩和されます。  
+  
+## XML ドキュメントからのスキーマの推論  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスでは、2 つのオーバーロードされた <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドを使用して XML ドキュメントからスキーマを推論します。  
+  
+ 最初の <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A?displayProperty=fullName> メソッドは、XML ドキュメントに基づくスキーマの作成に使用されます。  2 番目の <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A?displayProperty=fullName> メソッドは、複数の XML ドキュメントを記述するスキーマの推論に使用されます。  たとえば、複数の XML ドキュメントを 1 つずつ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A?displayProperty=fullName> メソッドに渡すことで、XML ドキュメントのセット全体を記述する 1 つのスキーマを生成できます。  
+  
+ 最初の <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A?displayProperty=fullName> メソッドは、<xref:System.Xml.XmlReader> オブジェクトに含まれている XML ドキュメントからスキーマを推論し、推論されたスキーマが含まれる <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトを返します。  2 番目の <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A?displayProperty=fullName> メソッドは、<xref:System.Xml.Schema.XmlSchemaSet> オブジェクトを対象として、<xref:System.Xml.XmlReader> オブジェクトに含まれている XML ドキュメントと同じ対象の名前空間を持つスキーマを検索し、既存のスキーマを限定し、推論されたスキーマが含まれる <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトを返します。  
+  
+ 限定されたスキーマに加えられた変更は、XML ドキュメントで検出された新しい構造に基づいています。  たとえば、XML ドキュメントが詳細に検討されるときは、検出されるデータ型が想定され、その想定に基づいてスキーマが作成されます。  しかし、2 回目の推論で検出されたデータが最初の想定と異なっている場合は、スキーマが限定されます。  次の例は限定のプロセスを示しています。  
+  
+ [!code-cpp[XmlSchemaInferenceExamples#4](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaInferenceExamples/CPP/XmlSchemaInferenceExamples.cpp#4)]
+ [!code-csharp[XmlSchemaInferenceExamples#4](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaInferenceExamples/CS/XmlSchemaInferenceExamples.cs#4)]
+ [!code-vb[XmlSchemaInferenceExamples#4](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaInferenceExamples/VB/XmlSchemaInferenceExamples.vb#4)]  
+  
+ この例では、次に示す `item1.xml` というファイルを最初の入力として受け取ります。  
+  
+ [!code-xml[XmlSchemaInferenceExamples#13](../../../../samples/snippets/xml/VS_Snippets_Data/XmlSchemaInferenceExamples/XML/item1.xml#13)]  
+  
+ この例では、さらに `item2.xml` というファイルを 2 番目の入力として受け取ります。  
+  
+ [!code-xml[XmlSchemaInferenceExamples#14](../../../../samples/snippets/xml/VS_Snippets_Data/XmlSchemaInferenceExamples/XML/item2.xml#14)]  
+  
+ 最初の XML ドキュメントで `productID` 属性が検出されると、値 `123456789` は `xs:unsignedInt` 型であると想定されます。  しかし、2 番目の XML ドキュメントが読み取られ、値 `A53-246` が検出されると、`xs:unsignedInt` 型だとは想定できなくなります。  そこで、スキーマは限定され、`productID` の型が `xs:string` に変更されます。  さらに、2 番目の XML ドキュメントに `supplierID` 要素が含まれていないため、`supplierID` 要素の `minOccurs` 属性が `0` に設定されます。  
+  
+ 次に示すのは、最初の XML ドキュメントから推論されたスキーマです。  
+  
+ [!code-xml[XmlSchemaInferenceExamples#15](../../../../samples/snippets/xml/VS_Snippets_Data/XmlSchemaInferenceExamples/XML/InferSchema1.xml#15)]  
+  
+ 次に示すのは、最初の XML ドキュメントから推論され、2 番目の XML ドキュメントによって限定されたスキーマです。  
+  
+ [!code-xml[XmlSchemaInferenceExamples#16](../../../../samples/snippets/xml/VS_Snippets_Data/XmlSchemaInferenceExamples/XML/InferSchema2.xml#16)]  
+  
+## インライン スキーマ  
+ <xref:System.Xml.Schema.XmlSchemaInference> プロセスの実行中にインライン XML スキーマ定義言語 \(XSD\) スキーマが検出されると、<xref:System.Xml.Schema.XmlSchemaInferenceException> がスローされます。  たとえば、次のインライン スキーマが検出されると、<xref:System.Xml.Schema.XmlSchemaInferenceException> がスローされます。  
+  
+```  
+<root xmlns:ex="http://www.contoso.com" xmlns="http://www.tempuri.org">  
+    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.contoso.com">  
+        <xs:element name="Contoso" type="xs:normalizedString" />  
+    </xs:schema>  
+    <ex:Contoso>Test</ex:Contoso>  
+</root>  
+```  
+  
+## 限定できないスキーマ  
+ 限定を目的として型を渡されたときに、XML スキーマ定義言語 \(XSD\) スキーマの <xref:System.Xml.Schema.XmlSchemaInference> プロセスが処理できず、例外をスローする W3C XML スキーマ構造があります。  最上位のコンポジターがシーケンス以外のものである複合型がその例です。  スキーマ オブジェクト モデル \(SOM\) では、<xref:System.Xml.Schema.XmlSchemaComplexType.Particle%2A> プロパティが <xref:System.Xml.Schema.XmlSchemaSequence> のインスタンスでない <xref:System.Xml.Schema.XmlSchemaComplexType> がそれに相当します。  
+  
+## 参照  
+ <xref:System.Xml.Schema.XmlSchemaInference>   
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)   
+ [XML スキーマの推論](../../../../docs/standard/data/xml/inferring-an-xml-schema.md)   
+ [スキーマのノード型および構造を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md)   
+ [単純型を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-simple-types.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/inputs-to-the-xslcompiledtransform-class.md b/docs/standard/data/xml/inputs-to-the-xslcompiledtransform-class.md
new file mode 100644
index 00000000000..61e74518ddc
--- /dev/null
+++ b/docs/standard/data/xml/inputs-to-the-xslcompiledtransform-class.md
@@ -0,0 +1,64 @@
+---
+title: "XslCompiledTransform クラスへの入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 834049f1-ab41-449e-9f10-4a1d0701bc48
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XslCompiledTransform クラスへの入力
+<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドには、<xref:System.Xml.XPath.IXPathNavigable> インターフェイスを実装するオブジェクト、ソース ドキュメントを読み取る <xref:System.Xml.XmlReader> オブジェクト、文字列 URI という 3 種類のソース ドキュメントを入力できます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslCompiledTransform> クラスは既定で空白を維持します。  このことは、W3C XSLT 1.0 勧告 \(セクション 3.4、http:\/\/www.w3.org\/TR\/xslt.html\#strip\) のセクション 3.4 に準拠しています。  
+  
+## IXPathNavigable インターフェイス  
+ <xref:System.Xml.XPath.IXPathNavigable> インターフェイスは、<xref:System.Xml.XmlNode> および <xref:System.Xml.XPath.XPathDocument> クラスに実装されています。  これらのクラスは XML データのメモリ内のキャッシュを表します。  
+  
+-   <xref:System.Xml.XmlNode> クラスは W3C ドキュメント オブジェクト モデル \(DOM\) を基礎とし、編集機能も含んでいます。  
+  
+-   <xref:System.Xml.XPath.XPathDocument> クラスは、XPath データ モデルに基づいた読み取り専用のデータ ストアです。  <xref:System.Xml.XPath.XPathDocument> は、XSLT 処理に推奨されるクラスです。  これは、<xref:System.Xml.XmlNode> クラスと比較して、より高速なパフォーマンスを提供します。  
+  
+> [!NOTE]
+>  変換はドキュメント全体に対して行われます。  つまり、ドキュメント ルート ノード以外のノードを指定しても、変換処理では、読み込んだドキュメントのすべてのノードがアクセスされます。  ノード フラグメントを変換するには、ノード フラグメントだけを含むオブジェクトを作成し、そのオブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡します。  詳細については、「[方法 : ノード フラグメントを変換する](../../../../docs/standard/data/xml/how-to-transform-a-node-fragment.md)」を参照してください。  
+  
+ 次の例では、<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A?displayProperty=fullName> メソッドにより、transform.xsl スタイル シートを使用して books.xml ファイルを books.html ファイルに変換しています。  books.xml ファイルおよび transform.xsl ファイルについては、「[方法 : アセンブリを使用して XSLT 変換を実行する](../../../../docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md)」を参照してください。  
+  
+ [!code-csharp[XslCompiledTransform.Transform2#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XslCompiledTransform.Transform2/CS/Program.cs#1)]
+ [!code-vb[XslCompiledTransform.Transform2#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XslCompiledTransform.Transform2/VB/Module1.vb#1)]  
+  
+## XmlReader オブジェクト  
+ <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドは、<xref:System.Xml.XmlReader> の現在のノードから、そのすべての子を通して読み込みます。  これにより、ドキュメントの一部をコンテキスト ドキュメントとして使用することができます。  <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドから帰った後、<xref:System.Xml.XmlReader> は、コンテキスト ドキュメントの終了後の次のノード上に位置します。  ドキュメントの末尾に到達すると、<xref:System.Xml.XmlReader> はファイルの末尾 \(EOF\) に位置します。  
+  
+ 次の例では、<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A?displayProperty=fullName> メソッドにより、transform.xsl スタイル シートを使用して books.xml ファイルを books.html ファイルに変換しています。  books.xml ファイルおよび transform.xsl ファイルについては、「[方法 : アセンブリを使用して XSLT 変換を実行する](../../../../docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md)」を参照してください。  
+  
+ [!code-csharp[XslCompiledTransform.Transform2#2](../../../../samples/snippets/csharp/VS_Snippets_Data/XslCompiledTransform.Transform2/CS/Program.cs#2)]
+ [!code-vb[XslCompiledTransform.Transform2#2](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XslCompiledTransform.Transform2/VB/Module1.vb#2)]  
+  
+## 文字列 URI  
+ XSLT の入力としてソース ドキュメントの URI を指定することもできます。  URI の解決には <xref:System.Xml.XmlResolver> が使用されます。  <xref:System.Xml.XmlResolver> を <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡して、使用するリゾルバーを指定することができます。  <xref:System.Xml.XmlResolver> が指定されていない場合、<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドは既定の <xref:System.Xml.XmlUrlResolver> を資格情報なしで使用します。  
+  
+ 次の例では、<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A?displayProperty=fullName> メソッドにより、transform.xsl スタイル シートを使用して books.xml ファイルを books.html ファイルに変換しています。  books.xml ファイルおよび transform.xsl ファイルについては、「[方法 : アセンブリを使用して XSLT 変換を実行する](../../../../docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md)」を参照してください。  
+  
+ [!code-csharp[XslCompiledTransform.Transform2#3](../../../../samples/snippets/csharp/VS_Snippets_Data/XslCompiledTransform.Transform2/CS/Program.cs#3)]
+ [!code-vb[XslCompiledTransform.Transform2#3](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XslCompiledTransform.Transform2/VB/Module1.vb#3)]  
+  
+ 詳細については、「[XSLT 処理中の外部リソースの解決](../../../../docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md)」を参照してください。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..557bcea3f78
--- /dev/null
+++ b/docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md
@@ -0,0 +1,344 @@
+---
+title: "XPathNavigator による XML データの挿入 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2ed8c28b-b88d-4be7-9c87-92df01f0821f
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator による XML データの挿入
+<xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメント内に兄弟ノード、子ノード、および属性ノードを挿入するためのメソッドのセットを提供します。  これらのメソッドを使用するには、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが編集可能である必要があります。つまり、その <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパティを `true` にする必要があります。  
+  
+ XML ドキュメントを編集できる <xref:System.Xml.XPath.XPathNavigator> オブジェクトは、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.CreateNavigator%2A> メソッドによって作成されます。  <xref:System.Xml.XPath.XPathDocument> クラスによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトは読み取り専用であり、<xref:System.Xml.XPath.XPathDocument> オブジェクトによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトの編集メソッドを使用しようとすると、<xref:System.NotSupportedException> が発生します。  
+  
+ 編集可能な <xref:System.Xml.XPath.XPathNavigator> オブジェクトの作成に関する詳細については、「[XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)」を参照してください。  
+  
+## ノードの挿入  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメント内に兄弟ノード、子ノード、および属性ノードを挿入するためのメソッドを提供します。  これらのメソッドによって、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置に関連した異なる場所にノードまたは属性を挿入できます。これらのメソッドについて以下に説明します。  
+  
+### 兄弟ノードの挿入  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、兄弟ノードを挿入する次のメソッドを提供します。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.InsertElementAfter%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.InsertElementBefore%2A>  
+  
+ これらのメソッドは <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの前と後に兄弟ノードを挿入します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A> および <xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A> メソッドは、オーバーロードされ、`string`、<xref:System.Xml.XmlReader> オブジェクト、または追加する兄弟ノードをパラメーターとして含む <xref:System.Xml.XPath.XPathNavigator> オブジェクトを受け取ります。  両方のメソッドは、兄弟ノードの挿入に使用される <xref:System.Xml.XmlWriter> オブジェクトも返します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InsertElementAfter%2A> および <xref:System.Xml.XPath.XPathNavigator.InsertElementBefore%2A> メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの前と後に、1 つの兄弟ノードを挿入します。  
+  
+ 次の例では、新しい `pages` 要素が `contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 子要素の前に挿入されます。  
+  
+ [!code-cpp[XPathNavigatorMethods#19](../../../../samples/snippets/cpp/VS_Snippets_Data/XPathNavigatorMethods/CPP/xpathnavigatormethods.cpp#19)]
+ [!code-csharp[XPathNavigatorMethods#19](../../../../samples/snippets/csharp/VS_Snippets_Data/XPathNavigatorMethods/CS/xpathnavigatormethods.cs#19)]
+ [!code-vb[XPathNavigatorMethods#19](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XPathNavigatorMethods/VB/xpathnavigatormethods.vb#19)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A>、<xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A>、<xref:System.Xml.XPath.XPathNavigator.InsertElementAfter%2A>、および <xref:System.Xml.XPath.XPathNavigator.InsertElementBefore%2A> メソッドの詳細については、<xref:System.Xml.XPath.XPathNavigator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 子ノードの挿入  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、子ノードを挿入する次のメソッドを提供します。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.AppendChild%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.PrependChild%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.AppendChildElement%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.PrependChildElement%2A>  
+  
+ これらのメソッドは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの一連の子ノードの最後と最初に、子ノードを追加します。  
+  
+ 「兄弟ノードの挿入」のメソッドと同様、<xref:System.Xml.XPath.XPathNavigator.AppendChild%2A> および <xref:System.Xml.XPath.XPathNavigator.PrependChild%2A> メソッドは、`string`、<xref:System.Xml.XmlReader> オブジェクト、または追加する子ノードをパラメーターとして含む <xref:System.Xml.XPath.XPathNavigator> オブジェクトを受け取ります。  両方のメソッドは、子ノードの挿入に使用される <xref:System.Xml.XmlWriter> オブジェクトも返します。  
+  
+ また、「兄弟ノードの挿入」のメソッドと同様、<xref:System.Xml.XPath.XPathNavigator.AppendChildElement%2A> および <xref:System.Xml.XPath.XPathNavigator.PrependChildElement%2A> メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの一連の子ノードの最初と最後に 1 つの子ノードを追加します。  
+  
+ 次の例では、新しい `pages` 子要素が `contosoBooks.xml` ファイル内の最初の `book` 要素の一連の子要素に追加されます。  
+  
+ [!code-cpp[XPathNavigatorMethods#2](../../../../samples/snippets/cpp/VS_Snippets_Data/XPathNavigatorMethods/CPP/xpathnavigatormethods.cpp#2)]
+ [!code-csharp[XPathNavigatorMethods#2](../../../../samples/snippets/csharp/VS_Snippets_Data/XPathNavigatorMethods/CS/xpathnavigatormethods.cs#2)]
+ [!code-vb[XPathNavigatorMethods#2](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XPathNavigatorMethods/VB/xpathnavigatormethods.vb#2)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ <xref:System.Xml.XPath.XPathNavigator.AppendChild%2A>、<xref:System.Xml.XPath.XPathNavigator.PrependChild%2A>、<xref:System.Xml.XPath.XPathNavigator.AppendChildElement%2A>、および <xref:System.Xml.XPath.XPathNavigator.PrependChildElement%2A> メソッドの詳細については、<xref:System.Xml.XPath.XPathNavigator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 属性ノードの挿入  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、属性ノードを挿入する次のメソッドを提供します。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.CreateAttribute%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.CreateAttributes%2A>  
+  
+ これらのメソッドは <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある要素ノードに属性ノードを挿入します。  <xref:System.Xml.XPath.XPathNavigator.CreateAttribute%2A> メソッドは、パラメーターとして指定された名前空間プレフィックス、ローカル名、名前空間 URI、および値を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある要素ノードに、属性ノードを作成します。  <xref:System.Xml.XPath.XPathNavigator.CreateAttributes%2A> メソッドは、属性ノードの挿入に使用される <xref:System.Xml.XmlWriter> オブジェクトも返します。  
+  
+ 次の例では、<xref:System.Xml.XPath.XPathNavigator.CreateAttributes%2A> メソッドから返された <xref:System.Xml.XmlWriter> オブジェクトを使用して、新しい `discount` および `currency` 属性が `contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 子要素に作成されます。  
+  
+ [!code-cpp[XPathNavigatorMethods#8](../../../../samples/snippets/cpp/VS_Snippets_Data/XPathNavigatorMethods/CPP/xpathnavigatormethods.cpp#8)]
+ [!code-csharp[XPathNavigatorMethods#8](../../../../samples/snippets/csharp/VS_Snippets_Data/XPathNavigatorMethods/CS/xpathnavigatormethods.cs#8)]
+ [!code-vb[XPathNavigatorMethods#8](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XPathNavigatorMethods/VB/xpathnavigatormethods.vb#8)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ <xref:System.Xml.XPath.XPathNavigator.CreateAttribute%2A> および <xref:System.Xml.XPath.XPathNavigator.CreateAttributes%2A> メソッドの詳細については、<xref:System.Xml.XPath.XPathNavigator> クラスのリファレンス ドキュメントを参照してください。  
+  
+## ノードのコピー  
+ 別の XML ドキュメントの内容を使用して XML ドキュメントを作成する場合があります。  <xref:System.Xml.XPath.XPathNavigator> クラスおよび <xref:System.Xml.XmlWriter> クラスは、既存の <xref:System.Xml.XmlReader> オブジェクトまたは <xref:System.Xml.XPath.XPathNavigator> オブジェクトから <xref:System.Xml.XmlDocument> オブジェクトへノードをコピーできます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.AppendChild%2A>、<xref:System.Xml.XPath.XPathNavigator.PrependChild%2A>、<xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A>、および <xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A> メソッドにはすべて、パラメーターとして <xref:System.Xml.XPath.XPathNavigator> オブジェクトまたは <xref:System.Xml.XmlReader> オブジェクトの受け取りが可能なオーバーロードがあります。  
+  
+ <xref:System.Xml.XmlWriter> クラスの <xref:System.Xml.XmlWriter.WriteNode%2A> メソッドには、<xref:System.Xml.XmlNode>、<xref:System.Xml.XmlReader>、または <xref:System.Xml.XPath.XPathNavigator> オブジェクトの受け取りが可能なオーバーロードがあります。  
+  
+ 次の例では、あるドキュメントからすべての `book` 要素を別のドキュメントにコピーします。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", String.Empty)  
+  
+Dim newBooks As XPathDocument = New XPathDocument("newBooks.xml")  
+Dim newBooksNavigator As XPathNavigator = newBooks.CreateNavigator()  
+  
+Dim nav As XPathNavigator  
+For Each nav in newBooksNavigator.SelectDescendants("book", "", false)  
+    navigator.AppendChild(nav)  
+Next  
+  
+document.Save("newBooks.xml");  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", String.Empty);  
+  
+XPathDocument newBooks = new XPathDocument("newBooks.xml");  
+XPathNavigator newBooksNavigator = newBooks.CreateNavigator();  
+  
+foreach (XPathNavigator nav in newBooksNavigator.SelectDescendants("book", "", false))  
+{  
+    navigator.AppendChild(nav);  
+}  
+  
+document.Save("newBooks.xml");  
+```  
+  
+## 値の挿入  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XmlDocument> オブジェクトにノードの値を挿入する <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> および <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドを提供しています。  
+  
+### 型指定されていない値の挿入  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドは、パラメーターとして渡された型指定されていない `string` 値を挿入するだけです。このパラメーターは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの値です。  値に型は設定されず、スキーマ情報が使用可能な場合でも、ノードの型に対して新しい値が有効どうかを検証せずに挿入されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドを使用して `contosoBooks.xml` フィァイル内のすべての `price` 要素を更新する例を次に示します。  
+  
+ [!code-cpp[XPathNavigatorMethods#47](../../../../samples/snippets/cpp/VS_Snippets_Data/XPathNavigatorMethods/CPP/xpathnavigatormethods.cpp#47)]
+ [!code-csharp[XPathNavigatorMethods#47](../../../../samples/snippets/csharp/VS_Snippets_Data/XPathNavigatorMethods/CS/xpathnavigatormethods.cs#47)]
+ [!code-vb[XPathNavigatorMethods#47](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XPathNavigatorMethods/VB/xpathnavigatormethods.vb#47)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+### 型指定された値の挿入  
+ ノードの型が W3C XML スキーマの単純型の場合、<xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドによって挿入される新しい値は、値の設定前に、単純型のファセットに対してチェックされます。  新しい値がノードの型に対して無効な場合 \(たとえば、型が `xs:positiveInteger` の要素に、値 `-1` を設定するような場合\)、例外が返されます。  
+  
+ 次の例では、`contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 要素の値を <xref:System.DateTime> 値に変更しようとしています。  `price` 要素の XML スキーマ型は、`contosoBooks.xsd` ファイル内で `xs:decimal` として定義されているため、結果は例外になります。  
+  
+```vb  
+Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+settings.ValidationType = ValidationType.Schema  
+  
+Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
+  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load(reader)  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.SetTypedValue(DateTime.Now)  
+```  
+  
+```csharp  
+XmlReaderSettings settings = new XmlReaderSettings();  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+settings.ValidationType = ValidationType.Schema;  
+  
+XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
+  
+XmlDocument document = new XmlDocument();  
+document.Load(reader);  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.SetTypedValue(DateTime.Now);  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+## InnerXml および OuterXml プロパティ  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> および <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある XML マークアップを変更します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティは、与えられた XML `string` の解析済みの内容を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードの XML マークアップを変更します。  同様に、<xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードと現在のノード自体の XML マークアップを変更します。  
+  
+ このトピックで説明したメソッドに加えて、<xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティと <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、XML ドキュメントからノードに値を挿入するために使用できます。  <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティと <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティを使用してノードと値を挿入する方法の詳細については「[XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)」を参照してください。  
+  
+## 名前空間と xml:lang の競合  
+ パラメーターとして <xref:System.Xml.XmlReader> オブジェクトを受け取る <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A>、<xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A>、<xref:System.Xml.XPath.XPathNavigator.AppendChild%2A>、および <xref:System.Xml.XPath.XPathNavigator.PrependChild%2A> メソッドを使用して XML データを挿入する場合、名前空間のスコープと `xml:lang` 宣言に関連する競合が発生する可能性があります。  
+  
+ 発生する可能性のある名前空間の競合は次のとおりです。  
+  
+-   <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内のスコープに名前空間があり、プレフィックスから名前空間 URI へのマッピングが <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内にない場合、新たに挿入されたノードに関する新しい名前空間宣言が追加されます。  
+  
+-   <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内と <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内の両方のスコープに同じ名前空間 URI があるが、両方のコンテキスト内で別のプレフィックスにマップされている場合、<xref:System.Xml.XmlReader> オブジェクトからのプレフィックスと名前空間 URI を使用して、新たに挿入されたノードに対する新しい名前空間宣言が追加されます。  
+  
+-   <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内と <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内の両方のスコープに同じ名前空間プレフィックスがあるが、両方のコンテキスト内で別の名前空間 URI にマップされている場合、新たに挿入されたノードに対する新しい名前空間宣言が追加され、<xref:System.Xml.XmlReader> オブジェクトからの名前空間 URI を使用してそのプレフィックスを再宣言します。  
+  
+-   <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内と <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内の両方で、プレフィックスと名前空間 URI が同じ場合、新たに挿入されたノードに対する新しい名前空間宣言は追加されません。  
+  
+> [!NOTE]
+>  上記の説明は、プレフィックスとして空の `string` \(たとえば、既定の名前空間宣言\) を使用した名前空間宣言にも適用されます。  
+  
+ 発生する可能性のある `xml:lang` の競合は次のとおりです。  
+  
+-   `xml:lang` 属性が <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内のスコープにあるが、<xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内にはない場合、<xref:System.Xml.XmlReader> オブジェクトから受け取った値を持つ `xml:lang` 属性が、新たに挿入されたノードに対して追加されます。  
+  
+-   `xml:lang` 属性が <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内と <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内の両方のスコープにあるが、それぞれの値が異なる場合、<xref:System.Xml.XmlReader> オブジェクトから受け取った値を持つ `xml:lang` 属性が、新たに挿入されたノードに対して追加されます。  
+  
+-   `xml:lang` 属性が <xref:System.Xml.XmlReader> オブジェクトのコンテキスト内と <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内の両方のスコープにあるが、それぞれの値が同じ場合、新たに挿入されたノードに対して新しい `xml:lang` 属性は追加されません。  
+  
+-   `xml:lang` 属性が <xref:System.Xml.XPath.XPathNavigator> オブジェクトのコンテキスト内のスコープにあるが、<xref:System.Xml.XmlReader> オブジェクトのコンテキスト内にはない場合、新たに挿入されたノードに対して `xml:lang` 属性は追加されません。  
+  
+## XmlWriter によるノードの挿入  
+ 「ノードと値の挿入」に記載されている兄弟ノード、子ノード、および属性ノードの挿入に使用されるメソッドはオーバーロードされます。  <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.InsertAfter%2A>、<xref:System.Xml.XPath.XPathNavigator.InsertBefore%2A>、<xref:System.Xml.XPath.XPathNavigator.AppendChild%2A>、<xref:System.Xml.XPath.XPathNavigator.PrependChild%2A>、および <xref:System.Xml.XPath.XPathNavigator.CreateAttributes%2A> メソッドは、ノードの挿入に使用される <xref:System.Xml.XmlWriter> オブジェクトを返します。  
+  
+### サポートされていない XmlWriter メソッド  
+ XPath データ モデルとドキュメント オブジェクト モデル \(DOM\) には相違点があるため、<xref:System.Xml.XmlWriter> クラスによる XML ドキュメントへの情報の書き込みで使用されるメソッドのすべてが <xref:System.Xml.XPath.XPathNavigator> クラスによってサポートされているわけではありません。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスによってサポートされない <xref:System.Xml.XmlWriter> クラス メソッドについて次の表で説明します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Xml.XmlWriter.WriteEntityRef%2A>|<xref:System.NotSupportedException> 例外をスローします。|  
+|<xref:System.Xml.XmlWriter.WriteDocType%2A>|ルート レベルでは無視され、XML ドキュメント内の他のレベルで呼び出された場合は、<xref:System.NotSupportedException> 例外をスローします。|  
+|<xref:System.Xml.XmlWriter.WriteCData%2A>|同じ文字または文字列についての <xref:System.Xml.XmlWriter.WriteString%2A> メソッドの呼び出しとして扱われます。|  
+|<xref:System.Xml.XmlWriter.WriteCharEntity%2A>|同じ文字または文字列についての <xref:System.Xml.XmlWriter.WriteString%2A> メソッドの呼び出しとして扱われます。|  
+|<xref:System.Xml.XmlWriter.WriteSurrogateCharEntity%2A>|同じ文字または文字列についての <xref:System.Xml.XmlWriter.WriteString%2A> メソッドの呼び出しとして扱われます。|  
+  
+ <xref:System.Xml.XmlWriter> クラスに関する詳細については、<xref:System.Xml.XmlWriter> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 複数の XmlWriter オブジェクト  
+ 1 つ以上の開いた <xref:System.Xml.XmlWriter> オブジェクトを使用して、XML ドキュメントの異なる部分を指す複数の <xref:System.Xml.XPath.XPathNavigator> オブジェクトを持つことができます。  複数の <xref:System.Xml.XmlWriter> オブジェクトは、単一スレッドのシナリオで許可されサポートされます。  
+  
+ 以下は、複数の <xref:System.Xml.XmlWriter> オブジェクト使用時の重要な注意事項です。  
+  
+-   それぞれの <xref:System.Xml.XmlWriter> オブジェクトの <xref:System.Xml.XmlWriter.Close%2A> メソッドが呼び出されるときに、<xref:System.Xml.XmlWriter> オブジェクトによって書き込まれる XML フラグメントが XML ドキュメントに追加されます。  その時点まで、<xref:System.Xml.XmlWriter> オブジェクトは、まとまっていないフラグメントを書き込んでいます。  XML ドキュメントに対する操作が実行される場合、<xref:System.Xml.XmlWriter.Close%2A> の呼び出し前に <xref:System.Xml.XmlWriter> オブジェクトによって書き込まれているフラグメントは影響を受けません。  
+  
+-   特定の XML サブツリー上に、開いた <xref:System.Xml.XmlWriter> オブジェクトがあり、そのサブツリーが削除された場合、<xref:System.Xml.XmlWriter> オブジェクトが引き続きそのサブツリーに追加する可能性があります。  サブツリーは単に削除済みフラグメントになります。  
+  
+-   XML ドキュメント内の同じ位置で、複数の <xref:System.Xml.XmlWriter> オブジェクトが開かれた場合、<xref:System.Xml.XmlWriter> オブジェクトが開かれた順序ではなく、それらが閉じられる順序で XML ドキュメントにそれらが追加されます。  
+  
+ 次の例では、<xref:System.Xml.XmlDocument> オブジェクトを作成し、<xref:System.Xml.XPath.XPathNavigator> オブジェクトを作成した後、<xref:System.Xml.XPath.XPathNavigator.PrependChild%2A> メソッドによって返される <xref:System.Xml.XmlWriter> オブジェクトを使用して、`books.xml` ファイル内に最初の book 構造体を作成します。  この例は、それを `book.xml` ファイルとして保存します。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+Using writer As XmlWriter = navigator.PrependChild()  
+  
+    writer.WriteStartElement("bookstore")  
+    writer.WriteStartElement("book")  
+    writer.WriteAttributeString("genre", "autobiography")  
+    writer.WriteAttributeString("publicationdate", "1981-03-22")  
+    writer.WriteAttributeString("ISBN", "1-861003-11-0")  
+    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin")  
+    writer.WriteStartElement("author")  
+    writer.WriteElementString("first-name", "Benjamin")  
+    writer.WriteElementString("last-name", "Franklin")  
+    writer.WriteElementString("price", "8.99")  
+    writer.WriteEndElement()  
+    writer.WriteEndElement()  
+    writer.WriteEndElement()  
+  
+End Using  
+  
+document.Save("book.xml")  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+using (XmlWriter writer = navigator.PrependChild())  
+{  
+    writer.WriteStartElement("bookstore");  
+    writer.WriteStartElement("book");  
+    writer.WriteAttributeString("genre", "autobiography");  
+    writer.WriteAttributeString("publicationdate", "1981-03-22");  
+    writer.WriteAttributeString("ISBN", "1-861003-11-0");  
+    writer.WriteElementString("title", "The Autobiography of Benjamin Franklin");  
+    writer.WriteStartElement("author");  
+    writer.WriteElementString("first-name", "Benjamin");  
+    writer.WriteElementString("last-name", "Franklin");  
+    writer.WriteElementString("price", "8.99");  
+    writer.WriteEndElement();  
+    writer.WriteEndElement();  
+    writer.WriteEndElement();  
+}  
+document.Save("book.xml");  
+```  
+  
+## XML ドキュメントの保存  
+ ここに記載されているメソッドによる <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存は、<xref:System.Xml.XmlDocument> クラスのメソッドを使用して実行されます。  <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存に関する詳細については、「[ドキュメントの保存と書き込み](../../../../docs/standard/data/xml/saving-and-writing-a-document.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの削除](../../../../docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/inserting-nodes-into-an-xml-document.md b/docs/standard/data/xml/inserting-nodes-into-an-xml-document.md
new file mode 100644
index 00000000000..780519ff0d7
--- /dev/null
+++ b/docs/standard/data/xml/inserting-nodes-into-an-xml-document.md
@@ -0,0 +1,28 @@
+---
+title: "XML ドキュメントへのノードの挿入 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 891e54f5-54f6-4bb4-b624-9d1b6a1f1216
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントへのノードの挿入
+新しいノードを挿入してドキュメントを変更できます。  ノードは、新しく作成したり、同じドキュメントの既存のノードから作成したり、別のドキュメントからインポートしたりできます。  新しいノードを作成する方法の詳細については、「[DOM への新しいノードの作成](../../../../docs/standard/data/xml/create-new-nodes-in-the-dom.md)」を参照してください。  既存のノードをコピーする方法の詳細については、「[既存のノードのコピー](../../../../docs/standard/data/xml/copy-existing-nodes.md)」、「[ドキュメント間での既存のノードのコピー](../../../../docs/standard/data/xml/copying-existing-nodes-from-one-document-to-another.md)」、または「[ドキュメント フラグメントのコピー](../../../../docs/standard/data/xml/copying-document-fragments.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/load-data-from-a-reader.md b/docs/standard/data/xml/load-data-from-a-reader.md
new file mode 100644
index 00000000000..bb29b2ccdb9
--- /dev/null
+++ b/docs/standard/data/xml/load-data-from-a-reader.md
@@ -0,0 +1,42 @@
+---
+title: "リーダーからのデータの読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 7e74918c-bc72-4977-a49b-e1520a6d8f60
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# リーダーからのデータの読み込み
+<xref:System.Xml.XmlDocument.Load%2A> メソッドに <xref:System.Xml.XmlReader> パラメーターを渡して XML ドキュメントを読み込むと、他の形式からデータを読み込む場合と比較して、その動作に違いがあります。  リーダーが初期状態のとき、<xref:System.Xml.XmlDocument.Load%2A> メソッドは、リーダーからのコンテンツ全体を使用して、リーダー内のすべてのデータから XML ドキュメント オブジェクト モデル \(DOM\) を構築します。  
+  
+ 既にリーダーがドキュメント内のあるノード上に位置している場合、リーダーが <xref:System.Xml.XmlDocument.Load%2A> メソッドに渡されると、<xref:System.Xml.XmlDocument.Load%2A> は現在のノードと、現在の深さを閉じる終了タグまで、その兄弟すべてをメモリに読み込もうとします。  <xref:System.Xml.XmlDocument.Load%2A> はリーダーからの XML が整形式かどうかを検証するので、<xref:System.Xml.XmlDocument.Load%2A> が成功するかどうかは、読み込みを試みた時点でリーダーが位置していたノードに依存します。  XML が整形式でない場合、<xref:System.Xml.XmlDocument.Load%2A> は例外をスローします。  たとえば、次のノード セットは、ルート レベルの要素が 2 つ含まれ、XML が整形式ではないため、<xref:System.Xml.XmlDocument.Load%2A> は例外をスローします。  
+  
+-   Comment ノード、Element ノード、Element ノード、EndElement ノードの順序のノード セット  
+  
+ 次のノード セットは、ルート レベルの要素が存在しないため、不完全な DOM が作成されます。  
+  
+-   Comment ノード、ProcessingInstruction ノード、Comment ノード、EndElement ノードの順序のノード セット  
+  
+ この場合、例外はスローされず、データが読み込まれます。  これらのノードの最上位にルート要素を追加すると、エラーなしで保存できる整形式の XML を作成できます。  
+  
+ ドキュメントのルート レベルとしては無効なリーフ ノード \(たとえば空白ノードや属性ノード\) にリーダーが位置している場合、リーダーはルートとして使用できるノードに移動するまで読み込みを続行します。  ドキュメントの読み込みは、この位置から開始されます。  
+  
+ 既定では、<xref:System.Xml.XmlDocument.Load%2A> は、ドキュメント型定義 \(DTD\) またはスキーマ検証を使用して、XML が有効かどうかを検証しません。  チェックするのは、XML が整形式かどうかだけです。  検証を行うには、<xref:System.Xml.XmlReaderSettings> クラスを使用して <xref:System.Xml.XmlReader> を作成する必要があります。  <xref:System.Xml.XmlReader> クラスは、DTD またはスキーマ定義言語 \(XSD\) のスキーマを使用して検証を強制できます。  <xref:System.Xml.XmlReaderSettings> クラスの <xref:System.Xml.ValidationType> プロパティによって、<xref:System.Xml.XmlReader> インスタンスが検証を強制するかどうかが決まります。  XML データの検証の詳細については、<xref:System.Xml.XmlReader> のリファレンス ページの「解説」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/managing-namespaces-in-an-xml-document.md b/docs/standard/data/xml/managing-namespaces-in-an-xml-document.md
new file mode 100644
index 00000000000..aa6ba9adf7d
--- /dev/null
+++ b/docs/standard/data/xml/managing-namespaces-in-an-xml-document.md
@@ -0,0 +1,93 @@
+---
+title: "XML ドキュメントでの名前空間の管理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 682643fc-b848-4e42-8c0d-50deeaeb5f2a
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# XML ドキュメントでの名前空間の管理
+XML 名前空間は、XML ドキュメントの要素名と属性名をカスタムの定義済み URI に関連付けます。  この関係を作成するには、名前空間 URI のプレフィックスを定義し、そのプレフィックスを使用して XML データ内の要素名と属性名を修飾します。  名前空間は要素名や属性名の競合を防ぎ、同じ名前の要素や属性を個別に処理および評価できるようにします。  
+  
+<a name="declare"></a>   
+## 名前空間の宣言  
+ 要素で名前空間を宣言するには、`xmlns:` 属性を使用します。  
+  
+ `xmlns:<name>=<"uri">`  
+  
+ ここで、`<name>` は名前空間プレフィックスで、`<"uri">` は名前空間を識別する URI です。  プレフィックスを宣言したら、そのプレフィックスを使用して XML ドキュメント内の要素と属性を修飾し、名前空間 URI と関連付けることができます。  名前空間プレフィックスはドキュメント全体を通じて使用されるため、短くする必要があります。  
+  
+ この例では、2 つの `BOOK` 要素を定義しています。  1 つ目の要素はプレフィックス `mybook` で修飾され、2 つ目の要素はプレフィックス `bb` で修飾されています。  プレフィックスはそれぞれ、異なる名前空間 URI に関連付けられています。  
+  
+```  
+<mybook:BOOK xmlns:mybook="http://www.contoso.com/books.dtd">  
+<bb:BOOK xmlns:bb="urn:blueyonderairlines">  
+```  
+  
+ ある要素が特定の名前空間の一部であることを指定するには、名前空間プレフィックスをその要素に追加します。  たとえば、`Author` 要素が `mybook` 名前空間に属する場合は、`<mybook:Author>` として宣言されます。  
+  
+<a name="scope"></a>   
+## 宣言のスコープ  
+ 名前空間の有効な範囲は、宣言された位置から、宣言された要素の最後までです。  この例では、`BOOK` 要素で定義されている名前空間は、`Publisher` 要素など、`BOOK` 要素の外側にある要素には適用されません。  
+  
+```  
+<Author>Joe Smith</Author>  
+<BOOK xmlns:book="http://www.contoso.com">  
+    <title>My Wonderful Day</title>  
+      <price>$3.95</price>  
+</BOOK>  
+<Publisher>  
+    <Name>MSPress</Name>  
+</Publisher>  
+```  
+  
+ 名前空間は使用する前に宣言されている必要がありますが、必ずしも XML ドキュメントの先頭に示されている必要はありません。  
+  
+ 1 つの XML ドキュメントで複数の名前空間を使用する場合は、そのうちの 1 つを既定の名前空間として定義することで、ドキュメントの外観を見やすくできます。  既定の名前空間はルート要素で宣言され、ドキュメント内の修飾されていないすべての要素に適用されます。  既定の名前空間は要素にのみ適用されます。属性には適用されません。  
+  
+ 既定の名前空間を使用するには、要素の宣言でプレフィックスとコロンを省略します。  
+  
+```  
+<BOOK xmlns="http://www.contoso.com/books.dtd">  
+```  
+  
+## 名前空間の管理  
+ <xref:System.Xml.XmlNamespaceManager> クラスには、名前空間 URI とそのプレフィックスのコレクションが格納されます。このクラスを使用すると、コレクションで名前空間を検索、追加、および削除できます。  このクラスは、特定のコンテキストで、XML の処理のパフォーマンスを向上させるために必要です。  たとえば、XPath をサポートするには、<xref:System.Xml.Xsl.XsltContext> クラスで <xref:System.Xml.XmlNamespaceManager> を使用します。  
+  
+ 名前空間マネージャーでは名前空間の検証は一切実行されません。このマネージャーでは、プレフィックスと名前空間が既に確認され、[W3C 名前空間](http://www.w3.org/TR/REC-xml-names/)仕様に準拠していることが前提となっています。  
+  
+> [!NOTE]
+>  [LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) では、名前空間の管理に <xref:System.Xml.XmlNamespaceManager> が使用されません。  LINQ to XML を使用する場合の名前空間の管理については、LINQ ドキュメントの「[Working with XML Namespaces](../../../../ocs/visual-basic/programming-guide/concepts/linq/working-with-xml-namespaces.md)」を参照してください。  
+  
+ <xref:System.Xml.XmlNamespaceManager> クラスを使用して実行できる管理タスクと検索タスクをいくつか次に示します。  使用例を含む詳細については、各メソッドまたはプロパティのリファレンス ページへのリンクをクリックしてください。  
+  
+|目的|用途|  
+|--------|--------|  
+|名前空間を追加する|<xref:System.Xml.XmlNamespaceManager.AddNamespace%2A> メソッド|  
+|名前空間を削除する|<xref:System.Xml.XmlNamespaceManager.RemoveNamespace%2A> メソッド|  
+|既定の名前空間の URI を検索する|<xref:System.Xml.XmlNamespaceManager.DefaultNamespace%2A> プロパティ|  
+|名前空間プレフィックスの URI を検索する|<xref:System.Xml.XmlNamespaceManager.LookupNamespace%2A> メソッド|  
+|名前空間 URI のプレフィックスを検索する|<xref:System.Xml.XmlNamespaceManager.LookupPrefix%2A> メソッド|  
+|現在のノードの名前空間の一覧を取得する|<xref:System.Xml.XmlNamespaceManager.GetNamespacesInScope%2A> メソッド|  
+|名前空間のスコープを指定する|<xref:System.Xml.XmlNamespaceManager.PushScope%2A> メソッドおよび <xref:System.Xml.XmlNamespaceManager.PopScope%2A> メソッド|  
+|現在のスコープ内にプレフィックスが定義されているかどうかを確認する|<xref:System.Xml.XmlNamespaceManager.HasNamespace%2A> メソッド|  
+|プレフィックスおよび URI を検索するときに使用する名前テーブルを取得する|<xref:System.Xml.XmlNamespaceManager.NameTable%2A> プロパティ|  
+  
+## 参照  
+ <xref:System.Xml.XmlNamespaceManager>   
+ [XML ドキュメントと XML データ](../../../../docs/standard/data/xml/index.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md b/docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md
new file mode 100644
index 00000000000..516ebf9f809
--- /dev/null
+++ b/docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md
@@ -0,0 +1,231 @@
+---
+title: "オブジェクト階層の XML データへのマップ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 450e350b-6a68-4634-a2a5-33f4dc33baf0
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# オブジェクト階層の XML データへのマップ
+メモリに読み込まれた XML ドキュメントは、ツリーという概念で表現されます。  プログラミングでは、オブジェクト階層を利用してツリーのノードにアクセスします。  XML コンテンツがどのようにノードに変換されるかを次の例に示します。  
+  
+ XML が XML ドキュメント オブジェクト モデル \(DOM\) に読み込まれると、各部がノードに変換されます。これらのノードは、ノード型や値など、ノード自身に関する付加的なメタデータを保持しています。  ノード型はノードのオブジェクトであり、ノード型によって実行可能なアクションおよび設定や取得が可能なプロパティが決まります。  
+  
+ 次のような簡単な XML があるとします。  
+  
+ **入力**  
+  
+```  
+<book>  
+    <title>The Handmaid's Tale</title>  
+</book>  
+```  
+  
+ この入力は、メモリ上で次のようなノード ツリーとして表現され、ノード型プロパティが割り当てられます。  
+  
+ ![サンプル ノード ツリー](../../../../docs/standard/data/xml/media/simple-xml.gif "Simple\_XML")  
+book と title のノード ツリー表現  
+  
+ `book` 要素と  **要素は `title`XmlElement** になり、要素コンテンツは **XmlText** オブジェクトになります。  **XmlElement** のメソッドとプロパティは、**XmlText** オブジェクトで使用できるメソッドとプロパティとは異なります。  実行可能なアクションはノード型によって決定されるため、XML マークアップがどのノード型になるかを理解することがきわめて重要です。  
+  
+ XML データを読み込み、ノード型に応じて異なるテキストを書き出す例を次に示します。  入力として、次の **items.xml** という XML データ ファイルを使用します。  
+  
+ **入力**  
+  
+```  
+<?xml version="1.0"?>  
+<!-- This is a sample XML document -->  
+<!DOCTYPE Items [<!ENTITY number "123">]>  
+<Items>  
+  <Item>Test with an entity: &number;</Item>  
+  <Item>test with a child element <more/> stuff</Item>  
+  <Item>test with a CDATA section <![CDATA[<456>]]> def</Item>  
+  <Item>Test with a char entity: A</Item>  
+  <!-- Fourteen chars in this element.-->  
+  <Item>1234567890ABCD</Item>  
+</Items>  
+```  
+  
+ **items.xml** ファイルを読み込み、それぞれのノード型の情報を表示するコード サンプルを次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+Public Class Sample  
+    Private Const filename As String = "items.xml"  
+  
+    Public Shared Sub Main()  
+  
+        Dim reader As XmlTextReader = Nothing  
+  
+        Try  
+            ' Load the reader with the data file and   
+            'ignore all white space nodes.   
+            reader = New XmlTextReader(filename)  
+            reader.WhitespaceHandling = WhitespaceHandling.None  
+  
+            ' Parse the file and display each of the nodes.  
+            While reader.Read()  
+                Select Case reader.NodeType  
+                    Case XmlNodeType.Element  
+                        Console.Write("<{0}>", reader.Name)  
+                    Case XmlNodeType.Text  
+                        Console.Write(reader.Value)  
+                    Case XmlNodeType.CDATA  
+                        Console.Write("<![CDATA[{0}]]>", reader.Value)  
+                    Case XmlNodeType.ProcessingInstruction  
+                        Console.Write("<?{0} {1}?>", reader.Name, reader.Value)  
+                    Case XmlNodeType.Comment  
+                        Console.Write("<!--{0}-->", reader.Value)  
+                    Case XmlNodeType.XmlDeclaration  
+                        Console.Write("<?xml version='1.0'?>")  
+                    Case XmlNodeType.Document  
+                    Case XmlNodeType.DocumentType  
+                        Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)  
+                    Case XmlNodeType.EntityReference  
+                        Console.Write(reader.Name)  
+                    Case XmlNodeType.EndElement  
+                        Console.Write("</{0}>", reader.Name)  
+                End Select  
+            End While  
+  
+        Finally  
+            If Not (reader Is Nothing) Then  
+                reader.Close()  
+            End If  
+        End Try  
+    End Sub 'Main ' End class  
+End Class 'Sample  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+    private const String filename = "items.xml";  
+  
+    public static void Main()  
+    {  
+        XmlTextReader reader = null;  
+  
+        try  
+        {  
+            // Load the reader with the data file and ignore   
+            // all white space nodes.  
+            reader = new XmlTextReader(filename);  
+            reader.WhitespaceHandling = WhitespaceHandling.None;  
+  
+            // Parse the file and display each of the nodes.  
+            while (reader.Read())  
+            {  
+                switch (reader.NodeType)  
+                {  
+                    case XmlNodeType.Element:  
+                        Console.Write("<{0}>", reader.Name);  
+                        break;  
+                    case XmlNodeType.Text:  
+                        Console.Write(reader.Value);  
+                        break;  
+                    case XmlNodeType.CDATA:  
+                        Console.Write("<![CDATA[{0}]]>", reader.Value);  
+                        break;  
+                    case XmlNodeType.ProcessingInstruction:  
+                        Console.Write("<?{0} {1}?>", reader.Name, reader.Value);  
+                        break;  
+                    case XmlNodeType.Comment:  
+                        Console.Write("<!--{0}-->", reader.Value);  
+                        break;  
+                    case XmlNodeType.XmlDeclaration:  
+                        Console.Write("<?xml version='1.0'?>");  
+                        break;  
+                    case XmlNodeType.Document:  
+                        break;  
+                    case XmlNodeType.DocumentType:  
+                        Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);  
+                        break;  
+                    case XmlNodeType.EntityReference:  
+                        Console.Write(reader.Name);  
+                        break;  
+                    case XmlNodeType.EndElement:  
+                        Console.Write("</{0}>", reader.Name);  
+                        break;  
+                }  
+            }  
+        }  
+  
+        finally  
+        {  
+            if (reader != null)  
+                reader.Close();  
+        }  
+    }  
+} // End class  
+```  
+  
+ この例の出力を確認すると、データからノード型へのマップがわかります。  
+  
+ **出力**  
+  
+```  
+  
+<?xml version='1.0'?><!--This is a sample XML document --><!DOCTYPE Items [<!ENTITY number "123">]<Items><Item>Test with an entity: 123</Item><Item>test with a child element <more> stuff</Item><Item>test with a CDATA section <![CDATA[<456>]]> def</Item><Item>Test with a char entity: A</Item><--Fourteen chars in this element.--><Item>1234567890ABCD</Item></Items>  
+```  
+  
+ 入力と、コードから生成された出力を 1 行ずつ対比させた以下の表を見れば、どのノード テストによってどの出力行が生成されたのかを分析でき、どの XML データがどのノード型になったかがわかります。  
+  
+|入力|出力|ノード型のテスト|  
+|--------|--------|--------------|  
+|\<?xml version\="1.0"?\>|\<?xml version\='1.0'?\>|XmlNodeType.XmlDeclaration|  
+|\<\!\-\- This is a sample XML document \-\-\>|\<\!\-\-This is a sample XML document \-\-\>|XmlNodeType.Comment|  
+|\<\!DOCTYPE Items \[\<\!ENTITY number "123"\>\]\>|\<\!DOCTYPE Items \[\<\!ENTITY number "123"\>\]|XmlNodeType.DocumentType|  
+|\<Items\>|\<Items\>|XmlNodeType.Element|  
+|\<Item\>|\<Item\>|XmlNodeType.Element|  
+|Test with an entity: &number;|Test with an entity:|XmlNodeType.Text|  
+|\<\/Item\>|\<\/Item\>|XmlNodeType.EndElement|  
+|\<Item\>|\<Item\>|XmNodeType.Element|  
+|test with a child element|test with a child element|XmlNodeType.Text|  
+|\<more\>|\<more\>|XmlNodeType.Element|  
+|stuff|stuff|XmlNodeType.Text|  
+|\<\/Item\>|\<\/Item\>|XmlNodeType.EndElement|  
+|\<Item\>|\<Item\>|XmlNodeType.Element|  
+|test with a CDATA section|test with a CDATA section|XmlTest.Text|  
+|\<\!\[CDATA\[\<456\>\]\]\>|\<\!\[CDATA\[\<456\>\]\]\>|XmlTest.CDATA|  
+|def|def|XmlNodeType.Text|  
+|\<\/Item\>|\<\/Item\>|XmlNodeType.EndElement|  
+|\<Item\>|\<Item\>|XmlNodeType.Element|  
+|Test with a char entity: &\#65;|Test with a char entity: A|XmlNodeType.Text|  
+|\<\/Item\>|\<\/Item\>|XmlNodeType.EndElement|  
+|\<\!\-\- Fourteen chars in this element.\-\-\>|\<\-\-Fourteen chars in this element.\-\-\>|XmlNodeType.Comment|  
+|\<Item\>|\<Item\>|XmlNodeType.Element|  
+|1234567890ABCD|1234567890ABCD|XmlNodeType.Text|  
+|\<\/Item\>|\<\/Item\>|XmlNodeType.EndElement|  
+|\<\/Items\>|\<\/Items\>|XmlNodeType.EndElement|  
+  
+ 有効なアクションの種類と設定および取得できるプロパティの種類はノード型によって決まるため、割り当てられているノード型を知っておく必要があります。  
+  
+ 空白ノードの作成は、データが DOM に読み込まれるときに **PreserveWhitespace** フラグによって制御されます。  詳細については、「[DOM を読み込むときの空白および有意の空白の処理](../../../../docs/standard/data/xml/white-space-and-significant-white-space-handling-when-loading-the-dom.md)」を参照してください。  
+  
+ DOM に新しいノードを追加するには、「[XML ドキュメントへのノードの挿入](../../../../docs/standard/data/xml/inserting-nodes-into-an-xml-document.md)」を参照してください。  DOM からノードを削除するには、「[XML ドキュメントからのノード、コンテンツ、値の削除](../../../../docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md)」を参照してください。  DOM のノードのコンテンツを編集するには、「[XML ドキュメントのノード、コンテンツ、値の変更](../../../../docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/mapping-xml-data-types-to-clr-types.md b/docs/standard/data/xml/mapping-xml-data-types-to-clr-types.md
new file mode 100644
index 00000000000..af9a950874d
--- /dev/null
+++ b/docs/standard/data/xml/mapping-xml-data-types-to-clr-types.md
@@ -0,0 +1,92 @@
+---
+title: "XML データ型から CLR 型へのマッピング | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: cabdfcad-f359-479b-b71c-8b2fad42ca49
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML データ型から CLR 型へのマッピング
+XML データ型と共通言語ランタイム \(CLR\) 型の既定のマッピングを次の表に示します。  
+  
+## 次の表は、XML データ型から CLR 型への既定のマッピングを示しています。  
+  
+> [!NOTE]
+>  `xs` および `xdt` のプレフィックスは、それぞれ http:\/\/www.w3.org\/2001\/XMLSchema および http:\/\/www.w3.org\/2003\/05\/xpath\-datatypes 名前空間 URI に対応します。  
+  
+|XML 型|CLR 型|  
+|-----------|-----------|  
+|`xs:anyURI`|<xref:System.Uri>|  
+|`xs:base64Binary`|`Byte[]`|  
+|`xs:boolean`|<xref:System.Boolean>|  
+|`xs:byte`|<xref:System.SByte>|  
+|`xs:date`|<xref:System.DateTime>|  
+|`xs:dateTime`|<xref:System.DateTime>|  
+|`xs:decimal`|<xref:System.Decimal>|  
+|`xs:double`|<xref:System.Double>|  
+|`xs:duration`|<xref:System.TimeSpan>|  
+|`xs:ENTITIES`|`String[]`|  
+|`xs:ENTITY`|<xref:System.String>|  
+|`xs:float`|<xref:System.Single>|  
+|`xs:gDay`|<xref:System.DateTime>|  
+|`xs:gMonthDay`|<xref:System.DateTime>|  
+|`xs:gYear`|<xref:System.DateTime>|  
+|`xs:gYearMonth`|<xref:System.DateTime>|  
+|`xs:hexBinary`|`Byte[]`|  
+|`xs:ID`|<xref:System.String>|  
+|`xs:IDREF`|<xref:System.String>|  
+|`xs:IDREFS`|`String[]`|  
+|`xs:int`|<xref:System.Int32>|  
+|`xs:integer`|<xref:System.Decimal>|  
+|`xs:language`|<xref:System.String>|  
+|`xs:long`|<xref:System.Int64>|  
+|`xs:gMmonth`|<xref:System.DateTime>|  
+|`xs:Name`|<xref:System.String>|  
+|`xs:NCName`|<xref:System.String>|  
+|`xs:negativeInteger`|<xref:System.Decimal>|  
+|`xs:NMTOKEN`|<xref:System.String>|  
+|`xs:NMTOKENS`|`String[]`|  
+|`xs:nonNegativeInteger`|<xref:System.Decimal>|  
+|`xs:nonPositiveInteger`|<xref:System.Decimal>|  
+|`xs:normalizedString`|<xref:System.String>|  
+|`xs:NOTATION`|<xref:System.Xml.XmlQualifiedName>|  
+|`xs:positiveInteger`|<xref:System.Decimal>|  
+|`xs:QName`|<xref:System.Xml.XmlQualifiedName>|  
+|`xs:short`|<xref:System.Int16>|  
+|`xs:string`|<xref:System.String>|  
+|`xs:time`|<xref:System.DateTime>|  
+|`xs:token`|<xref:System.String>|  
+|`xs:unsignedByte`|<xref:System.Byte>|  
+|`xs:unsignedInt`|<xref:System.UInt32>|  
+|`xs:unsignedLong`|<xref:System.UInt64>|  
+|`xs:unsignedShort`|<xref:System.UInt16>|  
+|`xdt:dayTimeDuration`|<xref:System.TimeSpan>|  
+|`xdt:yearMonthDuration`|<xref:System.TimeSpan>|  
+|`xdt:untypedAtomic`|<xref:System.String>|  
+|`xdt:anyAtomicType`|<xref:System.Object>|  
+|`xs:anySimpleType`|<xref:System.String>|  
+|\[ドキュメント\] ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|要素ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|属性ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|名前空間ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|テキスト ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|コメント ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+|処理命令ノード|<xref:System.Xml.XPath.XPathNavigator>|  
+  
+## 参照  
+ [System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/matching-nodes-using-xpathnavigator.md b/docs/standard/data/xml/matching-nodes-using-xpathnavigator.md
new file mode 100644
index 00000000000..e643da6040a
--- /dev/null
+++ b/docs/standard/data/xml/matching-nodes-using-xpathnavigator.md
@@ -0,0 +1,56 @@
+---
+title: "XPathNavigator によるノードの一致 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: e6848c47-ee5d-401a-89a5-50b5eed40f30
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator によるノードの一致
+<xref:System.Xml.XPath.XPathNavigator> クラスは、ノードが XPath 式に一致するかどうかを調べる <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドを提供します。  <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドは XPath 式を入力として取り、現在のノードが与えられた XPath 式またはコンパイル済み <xref:System.Xml.XPath.XPathExpression> オブジェクトと一致するかどうかを示す <xref:System.Boolean> を返します。  
+  
+## ノードの一致  
+ <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドは、現在のノードが指定した XPath 式と一致すると `true` を返します。  たとえば次のコード サンプルで、<xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドは、現在のノードが要素 `b` であり、要素 `b` が属性 `c` を持つ場合に `true` を返します。  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドは <xref:System.Xml.XPath.XPathNavigator> の状態を変えません。  
+  
+```vb  
+Dim document as XPathDocument = New XPathDocument("input.xml")  
+Dim navigator as XPathNavigator = document.CreateNavigator()  
+  
+navigator.Matches("b[@c]")  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("input.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.Matches("b[@c]");  
+```  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)   
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)   
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)   
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/media/dom-class-hierarchy.gif b/docs/standard/data/xml/media/dom-class-hierarchy.gif
new file mode 100644
index 00000000000..f54841c2194
Binary files /dev/null and b/docs/standard/data/xml/media/dom-class-hierarchy.gif differ
diff --git a/docs/standard/data/xml/media/entity-hierarchy.gif b/docs/standard/data/xml/media/entity-hierarchy.gif
new file mode 100644
index 00000000000..8cb031de9ba
Binary files /dev/null and b/docs/standard/data/xml/media/entity-hierarchy.gif differ
diff --git a/docs/standard/data/xml/media/simple-xml.gif b/docs/standard/data/xml/media/simple-xml.gif
new file mode 100644
index 00000000000..a91802e4e9a
Binary files /dev/null and b/docs/standard/data/xml/media/simple-xml.gif differ
diff --git a/docs/standard/data/xml/media/xml-entitydeclaration-node2.png b/docs/standard/data/xml/media/xml-entitydeclaration-node2.png
new file mode 100644
index 00000000000..3fe2ac00aa2
Binary files /dev/null and b/docs/standard/data/xml/media/xml-entitydeclaration-node2.png differ
diff --git a/docs/standard/data/xml/media/xml-to-domtree.gif b/docs/standard/data/xml/media/xml-to-domtree.gif
new file mode 100644
index 00000000000..2907a2f0920
Binary files /dev/null and b/docs/standard/data/xml/media/xml-to-domtree.gif differ
diff --git a/docs/standard/data/xml/media/xmlentityref-notexpanded-nodes.gif b/docs/standard/data/xml/media/xmlentityref-notexpanded-nodes.gif
new file mode 100644
index 00000000000..1cd3d13dc5a
Binary files /dev/null and b/docs/standard/data/xml/media/xmlentityref-notexpanded-nodes.gif differ
diff --git a/docs/standard/data/xml/media/xmlintegrationwithrelationaldataandadodotnet.gif b/docs/standard/data/xml/media/xmlintegrationwithrelationaldataandadodotnet.gif
new file mode 100644
index 00000000000..06a35799ec7
Binary files /dev/null and b/docs/standard/data/xml/media/xmlintegrationwithrelationaldataandadodotnet.gif differ
diff --git a/docs/standard/data/xml/media/xslttransformationswithxsltransformclass.gif b/docs/standard/data/xml/media/xslttransformationswithxsltransformclass.gif
new file mode 100644
index 00000000000..3c27c145c78
Binary files /dev/null and b/docs/standard/data/xml/media/xslttransformationswithxsltransformclass.gif differ
diff --git a/docs/standard/data/xml/migrating-from-the-xsltransform-class.md b/docs/standard/data/xml/migrating-from-the-xsltransform-class.md
new file mode 100644
index 00000000000..d13b77cb400
--- /dev/null
+++ b/docs/standard/data/xml/migrating-from-the-xsltransform-class.md
@@ -0,0 +1,128 @@
+---
+title: "XslTransform クラスからの移行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 9404d758-679f-4ffb-995d-3d07d817659e
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XslTransform クラスからの移行
+XSLT アーキテクチャは、[!INCLUDE[vsprvslong](../../../../includes/vsprvslong-md.md)] リリースで設計が変更されました。  <xref:System.Xml.Xsl.XslTransform> クラスは <xref:System.Xml.Xsl.XslCompiledTransform> クラスで置き換えられています。  
+  
+ 以降では、<xref:System.Xml.Xsl.XslCompiledTransform> クラスと <xref:System.Xml.Xsl.XslTransform> クラスの主な相違点について説明します。  
+  
+## パフォーマンス テスト  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスでは多くのパフォーマンスの向上が図られています。  新しい XSLT プロセッサは XSLT スタイル シートを、共通言語ランタイム \(CLR\) が他のプログラム言語で行うのと同様に、共通の中間形式にコンパイルします。  いったんスタイル シートがコンパイルされると、それをキャッシュして再利用することができます。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスには、このクラスを <xref:System.Xml.Xsl.XslTransform> クラスよりも大幅に高速化する他の最適化も含まれています。  
+  
+> [!NOTE]
+>  全体的なパフォーマンスは <xref:System.Xml.Xsl.XslCompiledTransform> クラスの方が <xref:System.Xml.Xsl.XslTransform> クラスより優れていますが、<xref:System.Xml.Xsl.XslCompiledTransform> クラスの <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドが変換で初めて呼び出されたときは、<xref:System.Xml.Xsl.XslTransform> クラスの <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドよりパフォーマンスが劣る場合があります。  これは、XSLT ファイルを読み込む前にコンパイルする必要があるためです。  詳細については、ブログの投稿「[XslCompiledTransform は XslTransform より遅い?](http://go.microsoft.com/fwlink/?LinkId=130590)」を参照してください。  
+  
+## セキュリティ  
+ 既定で、<xref:System.Xml.Xsl.XslCompiledTransform> クラスでは XSLT `document()` 関数と埋め込みスクリプトのサポートが無効になっています。  これらの機能を有効にするには、機能が有効になっている <xref:System.Xml.Xsl.XsltSettings> オブジェクトを作成し、それを <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドに渡します。  スクリプト作成を有効にして XSLT 変換を実行する方法を次の例に示します。  
+  
+ [!code-csharp[XML_Migration#16](../../../../samples/snippets/csharp/VS_Snippets_Data/XML_Migration/CS/migration.cs#16)]
+ [!code-vb[XML_Migration#16](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XML_Migration/VB/migration.vb#16)]  
+  
+ 詳細については、「[XSLT のセキュリティに関する考慮事項](../../../../docs/standard/data/xml/xslt-security-considerations.md)」を参照してください。  
+  
+## 新機能  
+  
+### 一時テーブル  
+ XSLT の処理中に一時ファイルが生成されることがあります。  スタイル シートにスクリプト ブロックが含まれる場合、またはデバッグ設定を true に設定してスタイル シートをコンパイルした場合、%TEMP% フォルダーに一時ファイルが作成されます。  タイミングの問題で、一部の一時ファイルが削除されない場合があります。  たとえば、一時ファイルが現在の AppDomain やデバッガーにより使用されると、<xref:System.CodeDom.Compiler.TempFileCollection> オブジェクトの終了処理でそのファイルを削除できなくなります。  
+  
+ クライアントのすべての一時ファイルが削除されるように、<xref:System.Xml.Xsl.XslCompiledTransform.TemporaryFiles%2A> プロパティを使用して追加のクリーンアップを実行することができます。  
+  
+### xsl:output 要素と XmlWriter のサポート  
+ 変換出力が <xref:System.Xml.XmlWriter> オブジェクトに送られる場合、<xref:System.Xml.Xsl.XslTransform> クラスでは `xsl:output` の設定が無視されていました。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスには、スタイル シートの `xsl:output` 要素から取得された出力情報を含む <xref:System.Xml.XmlWriterSettings> オブジェクトを返す <xref:System.Xml.Xsl.XslCompiledTransform.OutputSettings%2A> プロパティがあります。  <xref:System.Xml.XmlWriterSettings> オブジェクトを使用して、適切に設定された <xref:System.Xml.XmlWriter> オブジェクトを作成し、それを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡すことができます。  次の C\# コードに、この処理を示します。  
+  
+```  
+// Create the XslTransform object and load the style sheet.  
+XslCompiledTransform xslt = new XslCompiledTransform();  
+xslt.Load(stylesheet);  
+  
+// Load the file to transform.  
+XPathDocument doc = new XPathDocument(filename);  
+  
+// Create the writer.  
+XmlWriter writer = XmlWriter.Create(Console.Out, xslt.OutputSettings);  
+  
+// Transform the file and send the output to the console.  
+xslt.Transform(doc, writer);  
+writer.Close();  
+```  
+  
+### デバッグ オプション  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスによりデバッグ情報を生成できます。この機能を利用して、Microsoft [!INCLUDE[vsprvs](../../../../includes/vsprvs-md.md)] デバッガーを使用してスタイル シートをデバッグすることができます。  詳細については、「<xref:System.Xml.Xsl.XslCompiledTransform.%23ctor%28System.Boolean%29>」を参照してください。  
+  
+## 動作の違い  
+  
+### XmlReader への変換  
+ <xref:System.Xml.Xsl.XslTransform> クラスには、変換結果を <xref:System.Xml.XmlReader> オブジェクトとして返す Transform オーバーロードが数種類あります。  このオーバーロードを使用することで、生成される XML ツリーのシリアル化と逆シリアル化によるオーバーヘッドを生じることなく、変換結果をメモり内表現 \(<xref:System.Xml.XmlDocument> または <xref:System.Xml.XPath.XPathDocument>\) に読み込むことができます。  次の C\# コード例で、<xref:System.Xml.XmlDocument> オブジェクトに変換結果を読み込む方法を示します。  
+  
+```  
+// Load the style sheet  
+XslTransform xslt = new XslTransform();  
+xslt.Load("MyStylesheet.xsl");  
+  
+// Transform input document to XmlDocument for additional processing  
+XmlDocument doc = new XmlDocument();  
+doc.Load(xslt.Transform(input, (XsltArgumentList)null));  
+```  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスでは、<xref:System.Xml.XmlReader> オブジェクトへの変換がサポートされません。  ただし、<xref:System.Xml.XPath.XPathNavigator.CreateNavigator%2A> メソッドを使用して、生成される XML ツリーを <xref:System.Xml.XmlWriter> から直接読み込むことはできます。  次の C\# コード例では、同じ操作を <xref:System.Xml.Xsl.XslCompiledTransform> を使用して行う方法を示します。  
+  
+```  
+// Transform input document to XmlDocument for additional processing  
+XmlDocument doc = new XmlDocument();  
+using (XmlWriter writer = doc.CreateNavigator().AppendChild()) {  
+    xslt.Transform(input, (XsltArgumentList)null, writer);  
+}  
+```  
+  
+### 随意動作  
+ W3C 勧告『XSL Transformations \(XSLT\) Version 1.0』には、対処方法を実装者が決定できる事項があります。  このような事項は、随意動作と見なされています。  事項によっては、<xref:System.Xml.Xsl.XslCompiledTransform> クラスと <xref:System.Xml.Xsl.XslTransform> クラスで動作が異なります。  詳細については、「[XSLT エラーの解決](../../../../docs/standard/data/xml/recoverable-xslt-errors.md)」を参照してください。  
+  
+### 拡張オブジェクトとスクリプト関数  
+ <xref:System.Xml.Xsl.XslCompiledTransform> では、スクリプト関数の使用に関して新たに 2 つの制限が加えられています。  
+  
+-   XPath 式からはパブリック メソッドのみを呼び出すことができる。  
+  
+-   オーバーロードは引数の数に基づいて区別される。  引数の数が同じオーバーロードが複数存在する場合、例外が発生します。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> では、スクリプト関数へのバインド \(メソッド名参照\) がコンパイル時に実行されます。XslTranform を利用するスタイル シートを <xref:System.Xml.Xsl.XslCompiledTransform> によって読み込むと、例外が発生する場合があります。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> では、`msxsl:script` 要素内に子要素として `msxsl:using` および `msxsl:assembly` を含めることがサポートされます。  `msxsl:using` 要素と `msxsl:assembly` 要素を使用して、スクリプト ブロックで使用する追加の名前空間とアセンブリを宣言できます。  詳細については、「[msxsl:script を使用したスクリプト ブロック](../../../../docs/standard/data/xml/script-blocks-using-msxsl-script.md)」を参照してください。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> では、複数のオーバーロードおよびそれと同数の引数を含む拡張オブジェクトは使用できません。  
+  
+### MSXML 関数  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスでは、新しい MSXML 関数のサポートが追加されました。  新しい関数または強化された関数は次のとおりです。  
+  
+-   msxsl:node\-set : <xref:System.Xml.Xsl.XslTransform> では、[node\-set 関数](http://msdn.microsoft.com/ja-jp/87b6b3f4-16f4-4fa3-8103-d62a679ac2a7) 関数の引数を結果ツリー フラグメントにする必要がありました。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスでは、この要件がありません。  
+  
+-   msxsl:version : この関数は、<xref:System.Xml.Xsl.XslCompiledTransform> でサポートされます。  
+  
+-   XPath 拡張関数 : [ms:string\-compare 関数](http://msdn.microsoft.com/ja-jp/20616b82-9e27-444c-b714-4f1e09b73aee)、[ms:utc 関数](http://msdn.microsoft.com/ja-jp/ef26fc88-84c6-4fb9-9c3b-f2f5264b864f)、[ms:namespace\-uri 関数](http://msdn.microsoft.com/ja-jp/91f9cabf-ab93-4dbe-9c12-e6a75214f4c7)、[ms:local\-name 関数](http://msdn.microsoft.com/ja-jp/10ed60a1-17a9-4d74-8b98-7940ac97c0b5)、[ms:number 関数](http://msdn.microsoft.com/ja-jp/b94fc08e-1f31-4f48-b1a8-6d78c1b5d954)、[ms:format\-date 関数](http://msdn.microsoft.com/ja-jp/51f35609-89a9-4098-a166-88bf01300bf5)、および [ms:format\-time 関数](http://msdn.microsoft.com/ja-jp/e5c2df2d-e8fb-4a8f-bfc0-db84ea12a5d5) の各関数が新たにサポートされました。  
+  
+-   スキーマ関連の XPath 拡張関数 : これは、<xref:System.Xml.Xsl.XslCompiledTransform> ではネイティブでサポートされません。  ただし、拡張関数として実装することはできます。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)   
+ [XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..0570f403b06
--- /dev/null
+++ b/docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md
@@ -0,0 +1,262 @@
+---
+title: "XpathNavigator による XML データの変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 03a7c5a1-b296-4af4-b209-043c958dc0a5
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XpathNavigator による XML データの変更
+<xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメント内のノードを変更するためのメソッドのセットを提供します。  これらのメソッドを使用するには、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが編集可能である必要があります。つまり、その <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパティを `true` にする必要があります。  
+  
+ XML ドキュメントを編集できる <xref:System.Xml.XPath.XPathNavigator> オブジェクトは、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.CreateNavigator%2A> メソッドによって作成されます。  <xref:System.Xml.XPath.XPathDocument> クラスによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトは読み取り専用で、<xref:System.Xml.XPath.XPathDocument> オブジェクトによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトの編集メソッドを使用しようとすると、<xref:System.NotSupportedException> が発生します。  
+  
+ 編集可能な <xref:System.Xml.XPath.XPathNavigator> オブジェクトの作成に関する詳細については、「[XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)」を参照してください。  
+  
+## ノードの変更  
+ ノードの値を簡単に変更するには、<xref:System.Xml.XPath.XPathNavigator.SetValue%2A> と <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドを使用します。  
+  
+ 次の表は、異なるノード型に対するこれらメソッドの効果の一覧です。  
+  
+|<xref:System.Xml.XPath.XPathNodeType>|変更されるデータ。|  
+|---------------------------------------------------------------------------------------------------------------------------------------------|---------------|  
+|<xref:System.Xml.XPath.XPathNodeType>|サポートされていません。|  
+|<xref:System.Xml.XPath.XPathNodeType>|要素のコンテンツ。|  
+|<xref:System.Xml.XPath.XPathNodeType>|属性の値。|  
+|<xref:System.Xml.XPath.XPathNodeType>|テキスト コンテンツ。|  
+|<xref:System.Xml.XPath.XPathNodeType>|ターゲットを除くコンテンツ。|  
+|<xref:System.Xml.XPath.XPathNodeType>|コメントの内容。|  
+|<xref:System.Xml.XPath.XPathNodeType>|サポート範囲外。|  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNodeType> ノードまたは <xref:System.Xml.XPath.XPathNodeType> ノードの編集はサポートされません。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、ノードの挿入および削除に使用されるメソッドのセットも提供しています。  XML ドキュメントのノードの挿入および削除に関する詳細については、「[XPathNavigator による XML データの挿入](../../../../docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md)」および「[XPathNavigator による XML データの削除](../../../../docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md)」を参照してください。  
+  
+### 型指定されていない値の変更  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドは、パラメーターとして渡された型指定されていない `string` 値を挿入するだけです。このパラメーターは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの値です。  値に型は設定されず、スキーマ情報が使用可能な場合でも、ノードの型に対して新しい値が有効どうかを検証せずに挿入されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドを使用して `contosoBooks.xml` フィァイル内のすべての `price` 要素を更新する例を次に示します。  
+  
+ [!code-cpp[XPathNavigatorMethods#47](../../../../samples/snippets/cpp/VS_Snippets_Data/XPathNavigatorMethods/CPP/xpathnavigatormethods.cpp#47)]
+ [!code-csharp[XPathNavigatorMethods#47](../../../../samples/snippets/csharp/VS_Snippets_Data/XPathNavigatorMethods/CS/xpathnavigatormethods.cs#47)]
+ [!code-vb[XPathNavigatorMethods#47](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XPathNavigatorMethods/VB/xpathnavigatormethods.vb#47)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+### 型指定された値の変更  
+ ノードの型が W3C XML スキーマの単純型の場合、<xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドによって挿入される新しい値は、値の設定前に、単純型のファセットに対してチェックされます。  新しい値がノードの型に対して無効な場合 \(たとえば、型が `xs:positiveInteger` の要素に、値 `-1` を設定するような場合\)、例外が返されます。  
+  
+ 次の例では、`contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 要素の値を <xref:System.DateTime> 値に変更しようとしています。  `price` 要素の XML スキーマ型は、`contosoBooks.xsd` ファイル内で `xs:decimal` として定義されているため、結果は例外になります。  
+  
+```vb  
+Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+settings.ValidationType = ValidationType.Schema  
+  
+Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
+  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load(reader)  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.SetTypedValue(DateTime.Now)  
+```  
+  
+```csharp  
+XmlReaderSettings settings = new XmlReaderSettings();  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+settings.ValidationType = ValidationType.Schema;  
+  
+XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
+  
+XmlDocument document = new XmlDocument();  
+document.Load(reader);  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.SetTypedValue(DateTime.Now);  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+#### 厳密に型指定された XML データの効果  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、厳密に型指定された XML の記述の基本に W3C XML スキーマを使用します。  要素および属性には、W3C XML スキーマ ドキュメントに対する検証に基づいて、型情報を使用して注釈を付けることができます。  他の要素または属性を含めることができる要素は、複合型と呼ばれ、テキストの内容だけを含めることのできる要素は単純型と呼ばれます。  
+  
+> [!NOTE]
+>  属性には単純型しかありません。  
+  
+ 要素または属性は、その型定義に固有のすべての規則に準拠している場合、スキーマ有効と見なされます。  単純型の要素 `xs:int` がスキーマ有効であるためには、\-2,147,483,648 ～ 2,147,483,647 の数値を含む必要があります。  複合型の場合、要素のスキーマ有効性は、その子の要素および属性のスキーマ有効性に依存します。  したがって、要素が複合型定義に対して有効な場合、その子の要素および属性はすべて、それらの型定義に対して有効です。  同様に、要素の子の要素または属性のうち 1 つでもその型定義に対して無効か有効性が不明な場合、その要素も無効か有効性が不明になります。  
+  
+ 要素の有効性がその子の要素および属性の有効性に依存することを考えると、要素が以前有効だった場合、どちらを変更しても要素の有効性が変わる結果になります。  具体的には、要素の子要素または属性が挿入、更新または削除されると、その要素の有効性は不明になります。  これは、要素の <xref:System.Xml.XPath.XPathNavigator.SchemaInfo%2A> プロパティの <xref:System.Xml.Schema.IXmlSchemaInfo.Validity%2A> プロパティが <xref:System.Xml.Schema.XmlSchemaValidity> に設定されることによって表されます。  さらに、要素の親要素 \(およびその親、そのまた親と続く\) の有効性も不明になるため、この効果は、XML ドキュメント全体で再帰的に上方向にカスケードされます。  
+  
+ スキーマ検証および <xref:System.Xml.XPath.XPathNavigator> の詳細については、「[XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)」を参照してください。  
+  
+### 属性の変更  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> および <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドは、型指定されていない属性ノードと型指定された属性ノード、および「ノードの変更」に記載されているその他のノード型の変更に使用できます。  
+  
+ 次の例では、`books.xml` ファイル内の最初の `book` 要素の `genre` 属性の値を変更しています。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", String.Empty)  
+navigator.MoveToChild("book", String.Empty)  
+navigator.MoveToAttribute("genre", String.Empty)  
+  
+navigator.SetValue("non-fiction")  
+  
+navigator.MoveToRoot()  
+Console.WriteLine(navigator.OuterXml)  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", String.Empty);  
+navigator.MoveToChild("book", String.Empty);  
+navigator.MoveToAttribute("genre", String.Empty);  
+  
+navigator.SetValue("non-fiction");  
+  
+navigator.MoveToRoot();  
+Console.WriteLine(navigator.OuterXml);  
+```  
+  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> および <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドに関する詳細については、「型指定されていない値の変更」および「型指定された値の変更」を参照してください。  
+  
+## InnerXml および OuterXml プロパティ  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> および <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある XML マークアップを変更します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティは、与えられた XML `string` の解析済みの内容を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードの XML マークアップを変更します。  同様に、<xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードと現在のノード自体の XML マークアップを変更します。  
+  
+ 次の例では、<xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティを使用して、`contosoBooks.xml` ファイル内の最初の `book` 要素に対して `price` 要素の値を変更し、新しい `discount` 属性を挿入しています。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("contosoBooks.xml");  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.OuterXml = "<price discount=\"0\">10.99</price>"  
+  
+navigator.MoveToRoot()  
+Console.WriteLine(navigator.OuterXml)  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("contosoBooks.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.OuterXml = "<price discount=\"0\">10.99</price>";  
+  
+navigator.MoveToRoot();  
+Console.WriteLine(navigator.OuterXml);  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+## 名前空間ノードの変更  
+ ドキュメント オブジェクト モデル \(DOM\) で、名前空間宣言は挿入、更新、および削除が可能な普通の属性のように扱われます。  <xref:System.Xml.XPath.XPathNavigator> クラスでは、名前空間ノードに対してそのような操作は許可されません。これは、次の例で説明されているように、名前空間ノードの値を変更すると、名前空間ノードのスコープ内の要素および属性の ID が変更される可能性があるためです。  
+  
+```  
+<root xmlns="http://www.contoso.com">  
+    <child />  
+</root>  
+```  
+  
+ 上記の XML 例を次のように変更すると、各要素の名前空間 URI が変更されるため、事実上、ドキュメント内のすべての要素の名前が変更されます。  
+  
+```  
+<root xmlns="urn:contoso.com">  
+    <child />  
+</root>  
+```  
+  
+ 挿入先のスコープでの名前空間宣言と競合しない名前空間の挿入は、<xref:System.Xml.XPath.XPathNavigator> クラスによって許可されます。  この場合、次の例で説明されているように、名前空間宣言は XML ドキュメント内の下位のスコープで宣言されず、名前の変更が発生しません。  
+  
+```  
+<root xmlns:a="http://www.contoso.com">  
+    <parent>  
+        <a:child />  
+    </parent>  
+</root>  
+```  
+  
+ 上記の XML 例を次のように変更すると、名前空間宣言が XML ドキュメント全体で他の名前空間宣言のスコープより下位に正しく反映されます。  
+  
+```  
+<root xmlns:a="http://www.contoso.com">  
+    <parent a:parent-id="1234" xmlns:a="http://www.contoso.com/parent-id">  
+        <a:child xmlns:a="http://www.contoso.com/">  
+    </parent>  
+</root>  
+```  
+  
+ 上記の XML の例では、属性 `a:parent-id` が `http://www.contoso.com/parent-id` 名前空間名の `parent` 要素に挿入されます。  <xref:System.Xml.XPath.XPathNavigator.CreateAttribute%2A> メソッドは、`parent` 要素上に位置しているときの属性の挿入に使用されます。  XML ドキュメントの残りの部分の一貫性を保持するために、`http://www.contoso.com` 名前空間宣言が <xref:System.Xml.XPath.XPathNavigator> クラスによって自動的に挿入されます。  
+  
+## エンティティ参照ノードの変更  
+ <xref:System.Xml.XmlDocument> オブジェクト内のエンティティ参照ノードは、読み取り専用で、<xref:System.Xml.XPath.XPathNavigator> または <xref:System.Xml.XmlNode> クラスのどちらを使用しても編集できません。  エンティティ参照ノードを変更しようとすると、<xref:System.InvalidOperationException> が発生します。  
+  
+## xsi:nil ノードの変更  
+ W3C XML スキーマ勧告では、nillable 状態の要素という概念が導入されました。  要素が nillable の場合、要素は内容を持たなくても有効になります。  nillable 状態の要素という概念は、`null` 状態のオブジェクトという概念に似ています。  主な相違点は、`null` オブジェクトにはアクセスできないのに対して、`xsi:nil` 要素には、内容 \(子要素またはテキスト\) はなくとも、アクセスできる属性などのプロパティがあることです。  XML ドキュメント内では、要素に内容がないことを示すために、要素に `true` の値を持つ `xsi:nil` 属性が使用されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> オブジェクトを使用して、`true` の値の `xsi:nil` 属性を持つ有効な要素に内容を追加すると、その `xsi:nil` 属性の値は `false` に設定されます。  
+  
+> [!NOTE]
+>  `xsi:nil` 属性が `false` に設定された要素のコンテンツが削除されても、その属性の値は `true` に変更されません。  
+  
+## XML ドキュメントの保存  
+ ここに記載されている編集メソッドによる <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存は、<xref:System.Xml.XmlDocument> クラスのメソッドを使用して実行されます。  <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存に関する詳細については、「[ドキュメントの保存と書き込み](../../../../docs/standard/data/xml/saving-and-writing-a-document.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator による XML データの挿入](../../../../docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの削除](../../../../docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md b/docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md
new file mode 100644
index 00000000000..2ab18fbaa2a
--- /dev/null
+++ b/docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md
@@ -0,0 +1,59 @@
+---
+title: "XML ドキュメントのノード、コンテンツ、値の変更 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 761773e0-db72-4986-b9f5-a522213d8397
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントのノード、コンテンツ、値の変更
+ドキュメントのノードおよびコンテンツを変更するには、さまざまな方法があります。  次の操作を行うことができます。  
+  
+-   <xref:System.Xml.XmlNode.Value%2A> プロパティを使用してノードの値を変更する。  
+  
+-   ノードを新しいノードに置き換えることにより、ノード セット全体を変更します。  これは <xref:System.Xml.XmlNode.InnerXml%2A> プロパティを使用して実行できます。  
+  
+-   <xref:System.Xml.XmlNode.RemoveChild%2A> メソッドを使用して既存のノードを新しいノードに置き換える。  
+  
+-   <xref:System.Xml.XmlCharacterData.AppendData%2A>、<xref:System.Xml.XmlCharacterData.InsertData%2A>、または <xref:System.Xml.XmlCharacterData.ReplaceData%2A> メソッドを使用して <xref:System.Xml.XmlCharacterData> クラスから継承した追加の文字をノードに追加する。  
+  
+-   <xref:System.Xml.XmlCharacterData> から継承したノード型に対し、<xref:System.Xml.XmlCharacterData.DeleteData%2A> メソッドを使用することにより、文字範囲を削除してコンテンツを変更する。  
+  
+ ノードの値を簡単に変更するには、`node.Value = "new value";` を使用します。  この 1 行のコードを実行できるノード型と、そのノード型で変更されるデータを次の表に示します。  
+  
+|ノード型|変更されるデータ|  
+|----------|--------------|  
+|属性|属性の値。|  
+|CDATASection|CDATASection のコンテンツ。|  
+|コメント|コメントの内容。|  
+|ProcessingInstruction|ターゲットを除くコンテンツ。|  
+|Text|テキストのコンテンツ。|  
+|XmlDeclaration|`<?xml` と `?>` のマークアップを除く、宣言のコンテンツ。|  
+|Whitespace|空白の値。  この値は、スペース、タブ、CR、LF という 4 つの認識可能 XML 空白文字のいずれかに設定できます。|  
+|SignificantWhitespace|有意の空白の値。  この値は、スペース、タブ、CR、LF という 4 つの認識可能 XML 空白文字のいずれかに設定できます。|  
+  
+ この表に記載されていないノード型は、値を設定できるノード型ではありません。  これら以外のノード型に値を設定すると、<xref:System.InvalidOperationException> がスローされます。  
+  
+ <xref:System.Xml.XmlNode.InnerXml%2A> プロパティによって、現在のノードの子ノードのマークアップを変更できます。  このプロパティを設定すると、指定した文字列から解析されたコンテンツで子ノードが置き換えられます。  文字列の解析は、現在の名前空間コンテキストで実行されます。  さらに、<xref:System.Xml.XmlNode.InnerXml%2A> は冗長な名前空間宣言を削除します。  この結果、カット アンド ペースト操作を何度も実行しても、冗長な名前空間宣言によってドキュメント サイズが増加することはありません。  <xref:System.Xml.XmlNode.InnerXml%2A>の操作における名前空間の影響を示すコード サンプルについては、「<xref:System.Xml.XmlDocument.InnerXml%2A>」を参照してください。  
+  
+ <xref:System.Xml.XmlCharacterData.ReplaceData%2A> メソッドと <xref:System.Xml.XmlNode.RemoveChild%2A> メソッドを使用すると、これらのメソッドによって置換または削除されたノードが返されます。  このノードは XML ドキュメント オブジェクト モデル \(DOM\) のどこかに再度挿入することができます。  <xref:System.Xml.XmlCharacterData.ReplaceData%2A> メソッドは、ドキュメントに挿入されるノードに対し、2 種類の検証チェックを実行します。  最初のチェックでは、そのノードの親となるノードが、挿入されるノード型の子ノードを持つことができるかどうかを確認します。  2 番目のチェックでは、挿入されるノードが、その親となるノードの祖先でないことを確認します。  これらの条件のいずれかに違反すると、<xref:System.InvalidOperationException> がスローされます。  
+  
+ 編集可能なノードに読み取り専用の子を追加したり、削除したりするのは有効な操作です。  しかし、読み取り専用のノードそのものを変更しようとすると、<xref:System.InvalidOperationException> がスローされます。  この一例として、<xref:System.Xml.XmlEntityReference> ノードの子を変更しようとした場合が当てはまります。  このノードの子は読み取り専用であり、変更できません。  それらを変更しようとすると、<xref:System.InvalidOperationException> がスローされます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/namespace-affect-on-entity-ref-expansion-for-new-nodes.md b/docs/standard/data/xml/namespace-affect-on-entity-ref-expansion-for-new-nodes.md
new file mode 100644
index 00000000000..9579b220ec3
--- /dev/null
+++ b/docs/standard/data/xml/namespace-affect-on-entity-ref-expansion-for-new-nodes.md
@@ -0,0 +1,33 @@
+---
+title: "要素と属性を含む新しいノードでのエンティティ参照の展開に対する名前空間の影響 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 64359aee-aab0-4042-9a32-d19789af6ca7
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 要素と属性を含む新しいノードでのエンティティ参照の展開に対する名前空間の影響
+エンティティ宣言には、原則として任意のコンテンツを含めることができるため、`<!ENTITY aname "<elem>test</elem>">` のような要素が含まれている可能性もあります。  
+  
+ `&aname;` の置換コンテンツへの展開は、XML の解析時に行われるのではありません。  ノードがドキュメントに配置されるまでは、要素に対する名前空間を解決できないため、XML の展開は実行されません。  スコープ内の名前空間が判明するのは、ノードが配置された後になります。  ノードがドキュメントに配置されると、名前空間の解決が行われ、結果として得られたエンティティ コンテンツが適切なノードに解析されます。  
+  
+> [!NOTE]
+>  新しく作成されたエンティティ参照ノードがいったん展開された後、再び展開されることはありません。  したがって、要素の置換テキストで使われる名前空間は、親ノードの設定時にバインドされます。  ただし、既存のエンティティ参照ノードを削除して別の場所に挿入すると、そのノードに対する名前空間が変更される可能性があります。また、**CloneNode** メソッドで複製されたエンティティ参照ノードにおいても、名前空間が変わる可能性があります。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/namespace-support-in-the-dom.md b/docs/standard/data/xml/namespace-support-in-the-dom.md
new file mode 100644
index 00000000000..7ea59e7455f
--- /dev/null
+++ b/docs/standard/data/xml/namespace-support-in-the-dom.md
@@ -0,0 +1,38 @@
+---
+title: "DOM における名前空間のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f0548ead-0fed-41ee-b33e-117ba900d3bc
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM における名前空間のサポート
+XML ドキュメント オブジェクト モデル \(DOM\) は名前空間に完全に対応しています。  名前空間に対応している XML ドキュメントだけがサポートされます。  W3C \(World Wide Web Consortium\) の仕様によれば、DOM Level 1 を実装する DOM アプリケーションは名前空間に対応していなくてもかまいませんが、DOM Level 2 の機能は名前空間に対応しています。  ただし、メソッドが DOM 勧告の Level 1 または Level 2 のどちらに準拠しているかに関係なく、XML DOM のすべての機能は名前空間に対応しています。  
+  
+ たとえば、名前空間に対応していない環境では、DOM Level 1 勧告の規定に従って `setAttribute("A:b", "123")` を呼び出しても、プレフィックス `A` とローカル名 `b` を持つ属性は設定されません。  この結果は、`A:b` という値の属性になります。  
+  
+ 名前空間に対応している環境では、DOM Level 2 の `setAttribute("A:b", "123")` を呼び出すと、属性のプレフィックスが `A` になり、ローカル名が `b` になります。  これが Microsoft .NET DOM の動作です。  
+  
+ したがって、名前パラメーターを受け取るすべてのメソッドは、名前を修飾するプレフィックスも受け取ります。  DOM Level 1 の **setAttribute** メソッドの `A:b` のような名前パラメーターは、次のように解析されます。  
+  
+-   コロン \(:\) が含まれない場合は、ローカル名が `name` パラメーターに設定され、プレフィックスと名前空間 URI は空の文字列になります。  
+  
+-   コロンが見つかると、最初のコロンの位置に基づいて名前が 2 つの部分に分割されます。  プレフィックスはコロンより前の文字列に設定され、ローカル名はコロンより後の文字列に設定されます。  名前空間 URI の値をとらないメソッドでは、名前空間 URI は解決されず、空の文字列のままになります。  それ以外の場合は、メソッドに渡された文字列が名前空間 URI として設定されます。  プレフィックスが定義されていない場合、**Save** メソッド、**InnerXml** プロパティ、および **OuterXml** プロパティは失敗します。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/namespaces-and-dtds-in-the-dom.md b/docs/standard/data/xml/namespaces-and-dtds-in-the-dom.md
new file mode 100644
index 00000000000..fe85769749b
--- /dev/null
+++ b/docs/standard/data/xml/namespaces-and-dtds-in-the-dom.md
@@ -0,0 +1,46 @@
+---
+title: "DOM における名前空間と DTD | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 1e9b55c4-76ad-4f54-8d96-7ce4b4cf1e05
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM における名前空間と DTD
+ドキュメント型定義 \(DTD\) によって名前空間のサポートは複雑になります。  たとえば、次の XML では、既定の属性の名前にコロンが含まれています。  
+  
+```  
+<!ATTLIST item x:id CDATA #IMPLIED>  
+```  
+  
+ この構造が許容される場合は、次のように解決される可能性があります。  
+  
+-   `x:` は名前空間プレフィックスとして扱われますが、このプレフィックスは `xmlns:x` という名前空間宣言によって解決されなければならないため、名前空間宣言を DTD のどこかに記述する必要があります。  このプレフィックスをインスタンス ドキュメント内の別の対象に割り当てるとエラーになります。  
+  
+-   `x:` は名前空間プレフィックスとして扱われますが、このプレフィックスは常にインスタンス要素のコンテキストで解決されます。  つまり、`item` 要素が現れる名前空間スコープに応じて、プレフィックスが別々の名前空間 URI \(Uniform Resource Identifier\) に割り当てられる可能性があります。  これは上記の解決よりも予測しやすい動作ですが、既定の属性を実体化する必要があるため、別の複雑な問題が発生します。  
+  
+-   コロンは DTD 内にあるために無視され、属性の名前はプレフィックスと名前空間 URI のない `x:y` になります。  
+  
+-   既定の属性にコロンが含まれているため、DTD 内の名前でコロンを使用することはサポートされていないことを示す例外がスローされます。  これは予測可能な動作ですが、W3C \(World Wide Web Consortium\) が公開している DTD の多くは読み込めないことになります。  
+  
+-   ユーザーが DTD 検証を要求すると、ドキュメント全体に対する名前空間のサポートがオフになります。  これによって W3C DTD の読み込みが可能になり、結果は予測可能な動作になります。  
+  
+ Microsoft .NET Framework の XML には、W3C との互換性を最大限に保つための第 2 のオプションが実装されています。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/node-collections-in-namednodemaps-and-nodelists.md b/docs/standard/data/xml/node-collections-in-namednodemaps-and-nodelists.md
new file mode 100644
index 00000000000..382301d4a03
--- /dev/null
+++ b/docs/standard/data/xml/node-collections-in-namednodemaps-and-nodelists.md
@@ -0,0 +1,30 @@
+---
+title: "NamedNodeMaps と NodeLists のノード コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 025954b8-7aa8-47c5-a1c1-f81064fb4d65
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# NamedNodeMaps と NodeLists のノード コレクション
+ノードのセットを取得し、順序付けられた、または順序付けられていないコレクションに格納できます。  ノード セットが格納された順序付けられていないコレクションは、W3C \(World Wide Web Consortium\) では NamedNodeMap と呼ばれています。このタイプのコレクションからは、名前またはインデックスによってデータを取得できます。  ノード セットが格納された順序付けられたコレクションは、W3C では NodeList と呼ばれています。このコレクションのデータは、0 から始まるインデックスによって取得できます。  NamedNodeMaps および NodeLists は、W3C で規定されています。  Microsoft .NET Framework での NamedNodeMap の実装は **XmlNamedNodeMap** であり、NodeList の実装は **XmlNodeList** です。  
+  
+ 順序付けられていないコレクションについては、「[名前またはインデックスによる順序付けられていないノードの取得](../../../../docs/standard/data/xml/unordered-node-retrieval-by-name-or-index.md)」を参照してください。  順序付けられたコレクションについては、「[インデックスによる順序付けられたノードの取得](../../../../docs/standard/data/xml/ordered-node-retrieval-by-index.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md b/docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md
new file mode 100644
index 00000000000..543fab0625c
--- /dev/null
+++ b/docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md
@@ -0,0 +1,71 @@
+---
+title: "XPathNavigator を使用するノード セットのナビゲーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 1a954b41-7173-40bc-8544-d430f209b1e5
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator を使用するノード セットのナビゲーション
+<xref:System.Xml.XPath.XPathNavigator> クラスのノード セット ナビゲーション メソッドを使用して、<xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノード間を移動できます。  すべてのノード間の移動、または <xref:System.Xml.XPath.XPathNavigator> クラスの選択メソッドによって返される選択されたノード セット間を移動できます。  
+  
+## 要素ノード セットのナビゲーション  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、要素ノードの移動に使用されるいくつかのメソッドを提供します。  利用可能なナビゲーション メソッドおよびその移動方法を次の表に示します。これには、属性および名前空間のノードのナビゲートに使用されるメソッドは含まれません。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> オブジェクトでのノードの選択に関する詳細については、「[XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)」を参照してください。  属性および名前空間の移動に関する詳細については、「[XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)」を参照してださい。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveTo%2A>|<xref:System.Xml.XPath.XPathNavigator> を指定された <xref:System.Xml.XPath.XPathNavigator> と同じ位置に移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToChild%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの子ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToFirst%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの最初の兄弟ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToFirstChild%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの最初の子ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToFollowing%2A>|<xref:System.Xml.XPath.XPathNavigator> をドキュメント順で指定された要素に移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToId%2A>|<xref:System.Xml.XPath.XPathNavigator> を、与えられた <xref:System.String> に一致する値の `ID` 型の属性を持つノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの次の兄弟ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToParent%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの親ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A>|<xref:System.Xml.XPath.XPathNavigator> を現在のノードの前の兄弟ノードに移動します。|  
+|<xref:System.Xml.XPath.XPathNavigator.MoveToRoot%2A>|<xref:System.Xml.XPath.XPathNavigator> を XML ドキュメントのルート ノードに移動します。|  
+  
+## コメントおよび処理命令ノードのナビゲーション  
+ 次の <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドは XML ドキュメント内の他のノードからコメントまたは処理命令に移動するのに有効です。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveTo%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToNext%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToPrevious%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToFirst%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToFirstChild%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToChild%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToParent%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.MoveToId%2A>  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)   
+ [XpathNavigator を使用した XML データの抽出](../../../../docs/standard/data/xml/extract-xml-data-using-xpathnavigator.md)   
+ [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](../../../../docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/node-sets-in-transformations.md b/docs/standard/data/xml/node-sets-in-transformations.md
new file mode 100644
index 00000000000..9822847f8dc
--- /dev/null
+++ b/docs/standard/data/xml/node-sets-in-transformations.md
@@ -0,0 +1,89 @@
+---
+title: "変換におけるノード セット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ad034f0e-ff8b-4a71-9a4c-528c754263c4
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 変換におけるノード セット
+ノード セットは、XPath \(XML Path Language\) 式が返す 4 つの基本データ型のうちの 1 つです。 ノード セットは、ドキュメントの順番で作成された、重複がなくソートされていないノードのコレクションであり、スタイル シートの変数に割り当てることができます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslTransform> では、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] クラスが廃止されています。<xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。 詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ ノード セットは、XPath 式が返す 4 つの基本データ型のうちの 1 つです。 ノード セットは、ドキュメントの順番で作成された、重複がなくソートされていないノードのコレクションであり、スタイル シートの変数に割り当てることができます。 変換の `select` 属性で使用される XPath 式の結果であるこのノード セットは、XML ドキュメント オブジェクト モデル \(DOM\) のノード セットと同じ動作をします。 移動に [XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md) を使用する結果ツリー フラグメントと異なり、ノード セットの場合は「<xref:System.Xml.XPath.XPathNodeIterator>」で説明している各種のメソッドを使用してノード セット間を移動します。  
+  
+ スタイル シートの `variable` 要素または `parameter` 要素がノード セットとして評価される場合のノード セットに対する反復処理を、次のコード サンプルに示します。  
+  
+## スタイル シート  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">  
+  
+    <xsl:variable name="x" select="bookstore/book/title"></xsl:variable>  
+  
+    <xsl:template match="/">  
+        <xsl:for-each select="$x">  
+            ******  
+            <xsl:value-of select="."></xsl:value-of>  
+            ******  
+        </xsl:for-each>  
+    </xsl:template>  
+  
+</xsl:stylesheet>  
+```  
+  
+## 入力  
+  
+```  
+<bookstore>  
+   <book style="autobiography">  
+      <title>Seven Years in Trenton</title>  
+   </book>  
+  
+   <book style="autobiography">  
+      <title>Seven Years in Trenton2</title>  
+   </book>  
+  
+   <book style="textbook">  
+      <title>History of Trenton Vol 3</title>  
+   </book>  
+</bookstore>  
+```  
+  
+## 出力  
+  
+```  
+******  
+Seven Years in Trenton  
+******  
+  
+******  
+Seven Years in Trenton2  
+******  
+  
+******  
+History of Trenton Vol 3  
+******  
+```  
+  
+## 参照  
+ <xref:System.Xml.XPath.XPathNodeIterator>   
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/node-types-recognized-with-xpath-queries.md b/docs/standard/data/xml/node-types-recognized-with-xpath-queries.md
new file mode 100644
index 00000000000..37500438d7a
--- /dev/null
+++ b/docs/standard/data/xml/node-types-recognized-with-xpath-queries.md
@@ -0,0 +1,67 @@
+---
+title: "XPath クエリで認識されるノード型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 1d33e22d-18e5-43f8-a466-2e3d0a8dd094
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPath クエリで認識されるノード型
+XPath クエリで認識されるノードの型は、ドキュメント オブジェクト モデル \(DOM\) のノード型と同じではありません。  
+  
+## W3C XPath のノード型  
+ XPath クエリで認識されるノードの型は、ドキュメント オブジェクト モデル \(DOM\) のノード型ではありません。  以下は、<xref:System.Xml.XPath.XPathNodeType> 列挙体によって表される XPath のノード型です。  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+-   <xref:System.Xml.XPath.XPathNodeType>  
+  
+ これらのノード型は、XPath データ モデルに基づいており、ノードは XML 情報セットから派生しています。  <xref:System.Xml.XPath.XPathNodeType> および <xref:System.Xml.XPath.XPathNodeType> ノード型は、XPath データ モデルに記載されている基本のノード型に対する Microsoft .NET Framework の拡張です。  
+  
+ XPath における属性ノード型の使用法は DOM と異なります。  XPath データ モデルでは、要素ノードには関連する属性ノードのセットがあり、要素ノードはそれぞれの属性ノードの親になっています。  しかし、DOM では要素ノードは所有者であり、親ではありません。  いずれのモデルにおいても、属性ノードと名前空間ノードは要素ノードの子ノードとは見なされません。  
+  
+ 名前空間ノード型は XPath データ モデルに追加されたノード型であり、DOM で認識されるノード型ではありません。  
+  
+ 要素ノード、属性ノードおよび名前空間ノードの移動に関する詳細については、「[XPathNavigator を使用するノード セットのナビゲーション](../../../../docs/standard/data/xml/node-set-navigation-using-xpathnavigator.md)」と「[XPathNavigator を使用する属性と名前空間のナビゲーション](../../../../docs/standard/data/xml/attribute-and-namespace-node-navigation-using-xpathnavigator.md)」を参照してださい。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)   
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)   
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)   
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/object-comparison-using-xmlnametable.md b/docs/standard/data/xml/object-comparison-using-xmlnametable.md
new file mode 100644
index 00000000000..1e84008f52c
--- /dev/null
+++ b/docs/standard/data/xml/object-comparison-using-xmlnametable.md
@@ -0,0 +1,63 @@
+---
+title: "XmlNameTable によるオブジェクトの比較 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8d94e041-d340-4ddf-9a2c-d7319e3f4f86
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XmlNameTable によるオブジェクトの比較
+**XmlDocuments** の作成時には、そのドキュメント用の名前テーブルが作成されます。  XML がドキュメントに読み込まれるか、新しい要素または属性が作成されると、その属性名と要素名が **XmlNameTable** に格納されます。  別のドキュメントからの既存の **NameTable** を使用して **XmlDocument** を作成することもできます。  **XmlNameTable** パラメーターをとるコンストラクターを使用して **XmlDocuments** を作成すると、ドキュメントは、その **XmlNameTable** に既に保存されているノード名、名前空間、プレフィックスにアクセスするようになります。  どのような方法で名前テーブルと名前が読み込まれたとしても、いったんテーブルに名前が格納されると、文字列比較によってではなく、オブジェクト比較を利用して高速に名前を比較できます。  [NameTable.Add メソッド](frlrfSystemXmlNameTableClassAddTopic)を使用して、名前テーブルに文字列を追加することもできます。  名前テーブルを作成し、そのテーブルに **MyString** という文字列を追加するコード サンプルを次に示します。  その後、そのテーブルを使用して **XmlDocument** を作成し、**Myfile.xml** の要素名と属性名を既存の名前テーブルに追加します。  
+  
+```vb  
+Dim nt As New NameTable()  
+nt.Add("MyString")  
+Dim doc As New XmlDocument(nt)  
+doc.Load("Myfile.xml")  
+```  
+  
+```csharp  
+NameTable nt = new NameTable();  
+nt.Add("MyString");  
+XmlDocument doc = new XmlDocument(nt);  
+doc.Load("Myfile.xml");  
+```  
+  
+ ドキュメントを作成し、ドキュメントに 2 つの新しい要素を追加し、それらの要素をドキュメントの名前テーブルにも追加して、名前のオブジェクト比較を実行するコード サンプルを次に示します。  
+  
+```vb  
+Dim doc1 As XmlDocument = imp.CreateDocument()  
+Dim node1 As XmlElement = doc.CreateElement("node1")  
+Dim doc2 As XmlDocument = imp.CreateDocument()  
+Dim node2 As XmlElement = doc.CreateElement("node2")  
+if (CType(node1.Name, object) = CType(node2.Name, object))  
+```  
+  
+```csharp  
+XmlDocument doc1 = imp.CreateDocument();  
+node1 = doc1.CreateElement ("node1");  
+XmlDocument doc2 = imp.CreateDocument();  
+node2 = doc2.CreateElement ("node1");  
+if (((object)node1.Name) == ((object)node2.Name))  
+{ ...  
+```  
+  
+ 上記のように 2 つのドキュメント間で名前テーブルが渡される状況は、同じタイプのドキュメントを繰り返し処理する場合によく発生します。たとえば、XML スキーマ定義言語 \(XSD\) スキーマまたはドキュメント型定義 \(DTD\) に準拠し、同じ文字列が繰り返し使われる発注ドキュメントを e コマース サイトで処理する場合などです。  このような場合は、同じ要素名が複数のドキュメントに現れるため、同じ名前テーブルを使用することによってパフォーマンスが向上します。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/ordered-node-retrieval-by-index.md b/docs/standard/data/xml/ordered-node-retrieval-by-index.md
new file mode 100644
index 00000000000..a25d9809bc2
--- /dev/null
+++ b/docs/standard/data/xml/ordered-node-retrieval-by-index.md
@@ -0,0 +1,105 @@
+---
+title: "インデックスによる順序付けられたノードの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 5412c90f-2703-4aa8-a9c4-1b8a35183c37
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# インデックスによる順序付けられたノードの取得
+W3C \(World Wide Web Consortium\) の XML ドキュメント オブジェクト モデル \(DOM\) では、**XmlNamedNodeMap** によって処理される順序付けられていないノード セットとは対照的に、順序付けられたノードのリストを処理する機能を持った NodeList も定義しています。  Microsoft .NET Framework の NodeList は **XmlNodeList** と呼ばれています。  **XmlNodeList** を返すメソッドとプロパティは次のとおりです。  
+  
+-   XmlNode.ChildNodes  
+  
+-   XmlDocument.GetElementsByTagName  
+  
+-   XmlElement.GetElementsByTagName  
+  
+-   XmlNode.SelectNodes  
+  
+ **XmlNodeList** には **Count** プロパティがあり、次のコード サンプルに示すように、ループを記述して **XmlNodeList** のノードを反復処理するために使用できます。  
+  
+```vb  
+Dim doc as XmlDocument = new XmlDocument()  
+   doc.Load("books.xml")  
+  
+    ' Retrieve all book titles.  
+    Dim root as XmlElement = doc.DocumentElement  
+    Dim elemList as XmlNodeList = root.GetElementsByTagName("title")  
+    Dim i as integer  
+    for i=0  to elemList.Count-1  
+        ' Display all book titles in the Node List.  
+        Console.WriteLine(elemList.ItemOf(i).InnerXml)  
+    next  
+  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+doc.Load("books.xml");  
+// Retrieve all book titles.  
+XmlElement root = doc.DocumentElement;  
+XmlNodeList elemList = root.GetElementsByTagName("title");  
+for (int i=0; i < elemList.Count; i++)  
+{     
+   // Display all book titles in the Node List.  
+   Console.WriteLine(elemList[i].InnerXml);  
+}   
+```  
+  
+ **Count** プロパティの他に、**XmlNodeList** 内のノード コレクションに対して `foreach` スタイルの反復処理を実行する **GetEnumerator** メソッドがあります。  `foreach` ステートメントの使用方法を次のコード サンプルに示します。  
+  
+```vb  
+Dim doc As New XmlDocument()  
+doc.Load("books.xml")  
+  
+' Get book titles.  
+Dim root As XmlElement = doc.DocumentElement  
+Dim elemList As XmlNodeList = root.GetElementsByTagName("title")  
+Dim ienum As IEnumerator = elemList.GetEnumerator()  
+' Loop over the XmlNodeList using the enumerator ienum          
+While ienum.MoveNext()  
+    ' Display the book title.  
+    Dim title As XmlNode = CType(ienum.Current, XmlNode)  
+    Console.WriteLine(title.InnerText)  
+End While  
+```  
+  
+```csharp  
+{  
+     XmlDocument doc = new XmlDocument();  
+     doc.Load("books.xml");  
+  
+     // Get book titles.  
+     XmlElement root = doc.DocumentElement;  
+     XmlNodeList elemList = root.GetElementsByTagName("title");  
+     IEnumerator ienum = elemList.GetEnumerator();    
+     // Loop over the XmlNodeList using the enumerator ienum          
+     while (ienum.MoveNext())  
+     {  
+          // Display the book title.  
+           XmlNode title = (XmlNode) ienum.Current;  
+           Console.WriteLine(title.InnerText);  
+     }  
+  }  
+```  
+  
+ **XmlNodeList** で利用可能なメソッドとプロパティの詳細については、「[XmlNodeList メンバー](frlrfSystemXmlXmlNodeListMembersTopic)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/output-options-on-the-xslcompiledtransform-class.md b/docs/standard/data/xml/output-options-on-the-xslcompiledtransform-class.md
new file mode 100644
index 00000000000..40e5252356f
--- /dev/null
+++ b/docs/standard/data/xml/output-options-on-the-xslcompiledtransform-class.md
@@ -0,0 +1,70 @@
+---
+title: "XslCompiledTransform クラスの出力オプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 91ce8cba-386c-411e-bb38-0891a0393c0a
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XslCompiledTransform クラスの出力オプション
+このトピックでは、XSLT で使用できる出力オプションについて説明します。  出力オプションは、スタイル シート内で、または <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドで指定できます。  
+  
+## xsl:output 要素  
+ `xsl:output` 要素は出力のオプションを指定します。  <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドで指定する出力の種類により、`xsl:output` オプションの動作が決定されます。  
+  
+ 次の表では、出力の種類がストリームか <xref:System.IO.TextWriter> の場合に `xsl:output` 要素で使用できる各属性の動作について説明します。  
+  
+|属性名|動作|  
+|---------|--------|  
+|メソッド|サポートされています。|  
+|version|無視されます。  バージョンは常に XML では 1.0、そして HTML では 4.0 です。|  
+|encoding|<xref:System.IO.TextWriter> への出力時には無視されます。  <xref:System.IO.TextWriter.Encoding%2A?displayProperty=fullName> プロパティが代わりに使用されます。|  
+|omit\-xml\-declaration|サポートされています。|  
+|スタンドアロン|サポートされています。|  
+|doctype\-public|サポートされています。|  
+|doctype\-system|サポートされています。|  
+|cdata\-section\-elements|サポートされています。|  
+|indent|サポートされています。|  
+|media\-type|サポートされています。|  
+  
+#### XmlWriter への出力の送出  
+ スタイル シートで `xsl:output` 要素が使用され、出力の種類が <xref:System.Xml.XmlWriter> オブジェクトの場合は、<xref:System.Xml.XmlWriter> オブジェクトを作成する際に <xref:System.Xml.Xsl.XslCompiledTransform.OutputSettings%2A?displayProperty=fullName> プロパティを使用します。  <xref:System.Xml.Xsl.XslCompiledTransform.OutputSettings%2A?displayProperty=fullName> プロパティは、コンパイル済みスタイル シートの `xsl:output` 要素から派生した情報を含む <xref:System.Xml.XmlWriterSettings> オブジェクトを返します。  この <xref:System.Xml.XmlWriterSettings> オブジェクトを <xref:System.Xml.XmlWriter.Create%2A?displayProperty=fullName> メソッドに渡して、正しい設定の <xref:System.Xml.XmlWriter> オブジェクトを作成することができます。  
+  
+## 出力の種類  
+ 次の一覧では、<xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> コマンドで使用できる出力の種類について説明します。  
+  
+#### XmlWriter  
+ <xref:System.Xml.XmlWriter> クラスは XML ストリームまたはファイルを書き出します。  <xref:System.Xml.XmlWriterSettings> クラスを使用して、出力オプションも含め、<xref:System.Xml.XmlWriter> オブジェクトでサポートする機能を指定できます。  <xref:System.Xml.XmlWriter> クラスは <xref:System.Xml> フレームワークの重要な一部分です。  出力結果を別の XML プロセスにパイプラインして送るには、この出力を使用します。  
+  
+#### String  
+ 出力ファイルの URI を指定するには、この出力を使用します。  
+  
+#### ストリーム  
+ ストリームとは、ファイル、入出力デバイス、プロセス間通信のパイプ、または TCP\/IP ソケットなどのバイト シーケンスを抽象化したものです。  <xref:System.IO.Stream> クラスとその派生クラスは、これら各種の入出力にジェネリックな視点を提供し、プログラマがオペレーティング システムや下位のデバイスに固有の詳細を考慮する必要をなくします。  
+  
+ <xref:System.IO.FileStream>、<xref:System.IO.MemoryStream>、または出力ストリーム \(`Response.OutputStream`\) にデータを送るには、この出力の種類を使用します。  
+  
+#### TextWriter  
+ <xref:System.IO.TextWriter> は、文字シーケンスを書き出します。  これは <xref:System.IO.StringWriter> クラスおよび <xref:System.IO.StreamWriter> クラスに実装され、それぞれ文字を文字列に、またはストリームに書き出します。  文字列に出力する場合は、この出力の種類を使用します。  
+  
+## メモ  
+  
+-   空要素タグを書き出すとき、要素名の最後の文字とバック主ラッシュとの間に 1 つのスペースが書かれます。たとえば `<myElement />` です。  これにより、生成された HTML ページが古いブラウザーで正しく表示されます。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/outputs-from-an-xsltransform.md b/docs/standard/data/xml/outputs-from-an-xsltransform.md
new file mode 100644
index 00000000000..01e3f7a94de
--- /dev/null
+++ b/docs/standard/data/xml/outputs-from-an-xsltransform.md
@@ -0,0 +1,70 @@
+---
+title: "XslTransform からの出力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8e149d32-4b2f-493f-9e4b-d0d93475acde
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XslTransform からの出力
+スタイル シートは、`<xsl:output>` ステートメントと `method` 属性を使って出力形式を決定できます。次の表では、<xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを使用して出力を書き出し、出力形式を <xref:System.IO.Stream> または <xref:System.IO.TextWriter> として宣言した場合に出力形式がどうなるかを説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ スタイル シートは、`<xsl:output>` ステートメントと `method` 属性を使って出力形式を決定できます。次の表では、<xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを使用して出力を書き出し、出力形式を <xref:System.IO.Stream> または <xref:System.IO.TextWriter> として宣言した場合に出力形式がどうなるかを説明します。  <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを `<xsl:output>` ステートメントと共に使用して出力の種類を宣言した場合に得られる結果を次の表に示します。  
+  
+|\<xsl:output method \= \> attribute|結果の形式|  
+|-----------------------------------------|-----------|  
+|method\="xml"|XML|  
+|method\="html"|HTML|  
+|method\="text"|Text|  
+  
+> [!NOTE]
+>  メモ: <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドの出力が <xref:System.Xml.XmlReader> または <xref:System.Xml.XmlWriter> である場合、`<xsl:output>` ステートメントは無視されます。  
+  
+ <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドの出力が <xref:System.IO.Stream> または <xref:System.IO.TextWriter> である場合は、次の属性がサポートされます。  
+  
+-   encoding\*  
+  
+-   omit\-xml\-declaration  
+  
+-   スタンドアロン  
+  
+-   doctype\-public  
+  
+-   doctype\-system  
+  
+-   cdata\-section\-elements  
+  
+-   indent  
+  
+    > [!NOTE]
+    >  \*<xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドが出力を <xref:System.IO.TextWriter> に送信する場合、encoding 属性は無視されます。  その場合は、encoding 属性の代わりに <xref:System.IO.TextWriter> の encoding プロパティが使用されます。  
+  
+ <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドの出力が <xref:System.IO.Stream> の場合、次の属性は無視されます。  
+  
+-   version : バージョンは常に 1.0 です。  
+  
+-   media\-type : メディア タイプです。  
+  
+## 特殊文字のエスケープ  
+ `"<"` 記号の代わりに `<&lt>` を使用するなど、特殊文字を XML 形式にエスケープする必要があるかどうかを示すには、`<xsl:text disable-output-escaping>` タグを使用します。  <xref:System.Xml.XmlReader> オブジェクトまたは <xref:System.Xml.XmlWriter> オブジェクトへの変換では `disable-output-escaping` 属性が無視されるため、特殊文字はこのタグの影響を受けません。  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/post-schema-compilation-infoset.md b/docs/standard/data/xml/post-schema-compilation-infoset.md
new file mode 100644
index 00000000000..842af722b14
--- /dev/null
+++ b/docs/standard/data/xml/post-schema-compilation-infoset.md
@@ -0,0 +1,49 @@
+---
+title: "スキーマのコンパイル後の情報セット | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 7f1bc7f4-401b-459f-9078-f099cc711fde
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# スキーマのコンパイル後の情報セット
+W3C 勧告『[XML Schema](http://go.microsoft.com/fwlink/?linkid=45242)』では、スキーマ検証前とスキーマ コンパイル後に必ず公開する情報セットについて解説されています。  XML スキーマ オブジェクト モデル \(SOM\) は、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドが呼び出される前と後について、この公開内容を調べます。  
+  
+ スキーマの検証前の情報セットは、スキーマの編集時に作成されます。  スキーマ コンパイル後の情報セットは、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドが呼び出された後、スキーマのコンパイル時に生成され、プロパティとして公開されます。  
+  
+ SOM はスキーマ検証前とスキーマ コンパイル後の情報セットを表すオブジェクト モデルです。これは <xref:System.Xml.Schema?displayProperty=fullName> 名前空間内のクラスで構成されます。  <xref:System.Xml.Schema> 名前空間内のクラスの読み書き可能なプロパティは、すべてスキーマ検証前の情報セットに属し、一方 <xref:System.Xml.Schema> 名前空間のクラスの読み取り専用プロパティは、すべてスキーマ コンパイル後の情報セットに属します。  この規則の例外は、スキーマ検証前の情報セットとスキーマ コンパイル後の情報セットの両方のプロパティである、次のプロパティです。  
+  
+|クラス|プロパティ|  
+|---------|-----------|  
+|<xref:System.Xml.Schema.XmlSchemaObject>|<xref:System.Xml.Schema.XmlSchemaObject.Parent%2A>|  
+|<xref:System.Xml.Schema.XmlSchema>|<xref:System.Xml.Schema.XmlSchema.AttributeFormDefault%2A>, <xref:System.Xml.Schema.XmlSchema.BlockDefault%2A>, <xref:System.Xml.Schema.XmlSchema.ElementFormDefault%2A>, <xref:System.Xml.Schema.XmlSchema.FinalDefault%2A>, <xref:System.Xml.Schema.XmlSchema.TargetNamespace%2A>|  
+|<xref:System.Xml.Schema.XmlSchemaExternal>|<xref:System.Xml.Schema.XmlSchemaExternal.Schema%2A>|  
+|<xref:System.Xml.Schema.XmlSchemaAttributeGroup>|<xref:System.Xml.Schema.XmlSchemaAttributeGroup.AnyAttribute%2A>|  
+|<xref:System.Xml.Schema.XmlSchemaParticle>|<xref:System.Xml.Schema.XmlSchemaParticle.MaxOccurs%2A>, <xref:System.Xml.Schema.XmlSchemaParticle.MinOccurs%2A>|  
+|<xref:System.Xml.Schema.XmlSchemaComplexType>|<xref:System.Xml.Schema.XmlSchemaComplexType.AnyAttribute%2A>|  
+  
+ たとえば、<xref:System.Xml.Schema.XmlSchemaElement> クラスと <xref:System.Xml.Schema.XmlSchemaComplexType> クラスには `BlockResolved` プロパティと `FinalResolved` プロパティがあります。  これらのプロパティは、スキーマがコンパイルおよび検証された後に、`Block` プロパティと `Final` プロパティの値を格納するために使用されます。  `BlockResolved` プロパティと `FinalResolved` プロパティは、スキーマ コンパイル後の情報セットの一部であり、読み取り専用のプロパティです。  
+  
+ スキーマの検証後に設定される <xref:System.Xml.Schema.XmlSchemaElement> クラスの <xref:System.Xml.Schema.XmlSchemaElement.ElementSchemaType%2A> プロパティを次の例に示します。  検証の前の時点では、このプロパティには `null` 参照が含まれており、<xref:System.Xml.Schema.XmlSchemaElement.SchemaTypeName%2A> には問題の型の名前が設定されています。  検証後、<xref:System.Xml.Schema.XmlSchemaElement.SchemaTypeName%2A> は有効な型に解決され、型オブジェクトは <xref:System.Xml.Schema.XmlSchemaElement.ElementSchemaType%2A> プロパティを通じて利用できます。  
+  
+ [!code-cpp[PsciSample#1](../../../../samples/snippets/cpp/VS_Snippets_Data/PsciSample/CPP/PsciSample.cpp#1)]
+ [!code-csharp[PsciSample#1](../../../../samples/snippets/csharp/VS_Snippets_Data/PsciSample/CS/PsciSample.cs#1)]
+ [!code-vb[PsciSample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/PsciSample/VB/PsciSample.vb#1)]  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/process-xml-data-using-linq-to-xml.md b/docs/standard/data/xml/process-xml-data-using-linq-to-xml.md
new file mode 100644
index 00000000000..9ec488c70b4
--- /dev/null
+++ b/docs/standard/data/xml/process-xml-data-using-linq-to-xml.md
@@ -0,0 +1,37 @@
+---
+title: "LINQ to XML を使用した XML データの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 059d6b9d-63f7-4011-9ba8-8406f0bbae7d
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# LINQ to XML を使用した XML データの処理
+LINQ to XML は、XML データの処理を目的とした Microsoft .NET Framework version 3.5 の新しいモデルです。  LINQ to XML を使用することで、XML ドキュメントのクエリ、変更、作成、保存、シリアル化など、XML データを扱う際に必要な処理をすべて実行できます。  特に、クエリと作成の機能が役立ちます。  
+  
+ LINQ to XML のクエリでは、XPath や XQuery よりも SQL に類似した構文が使用され、簡潔で表現力に優れています。  クエリの結果を要素や属性のコレクションとして返すことができ、XElement オブジェクトのパラメーターとして使用できるため、XML ツリーの形を簡単に変換することができます。  
+  
+ LINQ to XML では、.NET Framework version 3.5 の統合言語クエリ \(LINQ\) テクノロジを利用しています。  LINQ は C\# および Visual Basic の言語構文を拡張したもので、潜在的には任意のデータ ストアまで拡張できる強力なクエリ機能を備えています。  
+  
+ LINQ の詳細な使用方法については、「[LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md)」を参照してください。LINQ フレームワークの概要については、「[LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.Linq>   
+ <xref:System.Linq>   
+ [LINQ to XML vs. DOM](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml-vs-dom.md)   
+ [LINQ to XML vs. Other XML Technologies](../Topic/LINQ%20to%20XML%20vs.%20Other%20XML%20Technologies1.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/process-xml-data-using-the-dom-model.md b/docs/standard/data/xml/process-xml-data-using-the-dom-model.md
new file mode 100644
index 00000000000..fb8ae4bc6c0
--- /dev/null
+++ b/docs/standard/data/xml/process-xml-data-using-the-dom-model.md
@@ -0,0 +1,71 @@
+---
+title: "DOM モデルを使用した XML データの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 56b6e9c7-ed82-4a65-a647-7be32c83bcc8
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# DOM モデルを使用した XML データの処理
+XML ドキュメント オブジェクト モデル \(DOM\) は、XML データをメモリ内で処理するために使用され、XML データを標準の一連のオブジェクトとして取り扱います。  `System.Xml` 名前空間は、XML ドキュメント、フラグメント、ノード、またはノードセットのプログラム表現を提供します。  これは、W3C \(World Wide Web Consortium\) の DOM Level 1 Core および DOM Level 2 Core 勧告に基づいています。  
+  
+ <xref:System.Xml.XmlDocument> クラスは、XML ドキュメントを表します。  これには、他のすべての XML オブジェクトの取り出しと作成のためのメンバーが含まれます。  <xref:System.Xml.XmlDocument> およびその関連クラスを使用して、XML ドキュメントの作成、データの読み込みとアクセス、データの変更、および変更の保存が可能です。  
+  
+## このセクションの内容  
+  
+-   [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)  
+  
+-   [XML ノードの種類](../../../../docs/standard/data/xml/types-of-xml-nodes.md)  
+  
+-   [XML ドキュメント オブジェクト モデル \(DOM\) の階層構造](../../../../docs/standard/data/xml/xml-document-object-model-dom-hierarchy.md)  
+  
+-   [オブジェクト階層の XML データへのマップ](../../../../docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md)  
+  
+-   [XML ドキュメントの作成](../../../../docs/standard/data/xml/xml-document-creation.md)  
+  
+-   [XML ドキュメントの DOM への読み取り](../../../../docs/standard/data/xml/reading-an-xml-document-into-the-dom.md)  
+  
+-   [XML ドキュメントへのノードの挿入](../../../../docs/standard/data/xml/inserting-nodes-into-an-xml-document.md)  
+  
+-   [XML ドキュメントからのノード、コンテンツ、値の削除](../../../../docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md)  
+  
+-   [XML ドキュメントのノード、コンテンツ、値の変更](../../../../docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md)  
+  
+-   [DOM における XML ドキュメントの検証](../../../../docs/standard/data/xml/validating-an-xml-document-in-the-dom.md)  
+  
+-   [ドキュメントの保存と書き込み](../../../../docs/standard/data/xml/saving-and-writing-a-document.md)  
+  
+-   [XPath ナビゲーションによるノードの選択](../../../../docs/standard/data/xml/select-nodes-using-xpath-navigation.md)  
+  
+-   [外部リソースの解決](../../../../docs/standard/data/xml/resolving-external-resources.md)  
+  
+-   [XmlNameTable によるオブジェクトの比較](../../../../docs/standard/data/xml/object-comparison-using-xmlnametable.md)  
+  
+-   [NamedNodeMaps と NodeLists のノード コレクション](../../../../docs/standard/data/xml/node-collections-in-namednodemaps-and-nodelists.md)  
+  
+-   [NodeLists および NamedNodeMaps の動的更新](../../../../docs/standard/data/xml/dynamic-updates-to-nodelists-and-namednodemaps.md)  
+  
+-   [DOM における名前空間のサポート](../../../../docs/standard/data/xml/namespace-support-in-the-dom.md)  
+  
+-   [XmlNodeChangedEventArgs による XML ドキュメントのイベント処理](../../../../docs/standard/data/xml/event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md)  
+  
+-   [DOM の拡張](../../../../docs/standard/data/xml/extending-the-dom.md)  
+  
+## 関連項目  
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスによる XML の処理について説明します。
\ No newline at end of file
diff --git a/docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md b/docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md
new file mode 100644
index 00000000000..40d1f62773f
--- /dev/null
+++ b/docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md
@@ -0,0 +1,51 @@
+---
+title: "XPath データ モデルを使用した XML データの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 536c6fce-1453-4654-9c72-bca54d47e081
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPath データ モデルを使用した XML データの処理
+<xref:System.Xml?displayProperty=fullName> 名前空間は、<xref:System.Xml.XmlDocument> または <xref:System.Xml.XPath.XPathDocument> クラスを使用して、メモリ内の XML ドキュメント、フラグメント、ノード、またはノードセットのプログラム表現を提供します。  
+  
+ <xref:System.Xml.XPath.XPathDocument> クラスは、XPath データ モデルによる XML ドキュメントの高速、読み取り専用のメモリ内表現を提供します。  <xref:System.Xml.XmlDocument> クラスは、W3C ドキュメント オブジェクト モデル \(DOM\) の DOM Level 1 Core および DOM Level 2 Core を実装する XML ドキュメントの編集可能なメモリ内表現です。  どちらのクラスも <xref:System.Xml.XPath.IXPathNavigable> インターフェイスを実装し、基になる XML データの選択、評価、移動、および \(場合によっては\) 編集に使用される <xref:System.Xml.XPath.XPathNavigator> オブジェクトを返します。  
+  
+ 以下では、<xref:System.Xml.XPath.XPathNavigator> クラスの機能を、それを返すクラスに基づいて説明します。  
+  
+## このセクションの内容  
+ [XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)  
+ XML ドキュメントを読むために読み取り専用の <xref:System.Xml.XPath.XPathDocument> クラス オブジェクトを作成する方法、および XML ドキュメントを読み込んで編集するために編集可能な <xref:System.Xml.XmlDocument> クラス オブジェクトを作成する方法について説明します。  このトピックでは、各クラスから <xref:System.Xml.XPath.XPathNavigator> オブジェクトを返して、XML ドキュメント内を移動して編集する方法について説明します。  
+  
+ [XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)  
+ XPath クエリによる <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノードの選択、XPath 式の結果の評価と検査、および XML ドキュメントのノードが指定された XPath 式に一致するかどうかの判定に使用される <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドについて説明します。  
+  
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で、ノード間の移動、XML データの抽出、および厳密に型指定された XML データへのアクセスに使用される <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドについて説明します。  
+  
+ [XPathNavigator による XML データの編集](../../../../docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XmlDocument> オブジェクトに含まれる XML ドキュメントでノードと値の挿入、変更、および削除に使用される <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドについて説明します。  
+  
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクトに含まれる XML コンテンツの検証方法について説明します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [DOM モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-dom-model.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/processing-xml-data-in-memory.md b/docs/standard/data/xml/processing-xml-data-in-memory.md
new file mode 100644
index 00000000000..43672f857d1
--- /dev/null
+++ b/docs/standard/data/xml/processing-xml-data-in-memory.md
@@ -0,0 +1,44 @@
+---
+title: "メモリ内の XML データの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 1bbb4d05-ead7-4bda-8ece-f86d35c57ad4
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# メモリ内の XML データの処理
+Microsoft .NET Framework には、XML データを処理するためのモデルとして、<xref:System.Xml.XmlDocument> クラス、<xref:System.Xml.XPath.XPathDocument> クラス、[LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) の 3 つが用意されています。  
+  
+ <xref:System.Xml.XmlDocument> クラスは、W3C ドキュメント オブジェクト モデル \(DOM\) 勧告の DOM Level 1 Core および DOM Level 2 Core を実装しています。  DOM は XML ドキュメントのメモリ内 \(キャッシュ\) ツリー表現です。  <xref:System.Xml.XmlDocument> およびその関連クラスを使用すると、XML ドキュメントの作成、データの読み込みとアクセス、データの変更、および変更の保存が可能です。  
+  
+ <xref:System.Xml.XPath.XPathDocument> クラスは、XPath データ モデルに基づく、読み取り専用のメモリ内データ ストアです。  <xref:System.Xml.XPath.XPathNavigator> クラスは、読み取り専用の <xref:System.Xml.XPath.XPathDocument> クラスと <xref:System.Xml.XmlDocument> クラス内の XML ドキュメント全体にカーソル モデルを使用して、いくつかの編集オプションとナビゲーション機能を提供します。  
+  
+ [LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) は、XML データの処理を目的とした Microsoft .NET Framework version 3.5 の新しいモデルです。  これは [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md) を利用したメモリ内モデルです。  LINQ では C\# および Visual Basic の言語構文を拡張することで、新しいクエリ機能を実現しています。  
+  
+## このセクションの内容  
+ [DOM モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-dom-model.md)  
+ <xref:System.Xml.XmlDocument> とその関連クラスを使用した XML データの処理について説明します。  
+  
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)  
+ <xref:System.Xml.XPath.XPathDocument>、<xref:System.Xml.XmlDocument>、および <xref:System.Xml.XPath.XPathNavigator> クラスを使用した XML データの処理について説明します。  
+  
+ [LINQ to XML を使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-linq-to-xml.md)  
+ LINQ to XML の概要を簡単に説明し、LINQ to XML に関する参照先のリンクを示します。  
+  
+## 関連項目  
+ [XML ドキュメントと XML データ](../../../../docs/standard/data/xml/index.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/reading-an-xml-document-into-the-dom.md b/docs/standard/data/xml/reading-an-xml-document-into-the-dom.md
new file mode 100644
index 00000000000..200deca51f8
--- /dev/null
+++ b/docs/standard/data/xml/reading-an-xml-document-into-the-dom.md
@@ -0,0 +1,80 @@
+---
+title: "XML ドキュメントの DOM への読み取り | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a4fb291f-5630-49ba-a49a-5b66c3b71e49
+caps.latest.revision: 3
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントの DOM への読み取り
+XML 情報は、さまざまな形式からメモリに読み取られます。  XML 情報は、文字列、ストリーム、URL、テキスト リーダー、および <xref:System.Xml.XmlReader> から派生したクラスから読み取ることができます。  
+  
+ ドキュメントをメモリに読み取る <xref:System.Xml.XmlDocument.Load%2A> メソッドには、オーバーロードされたメソッドが用意されており、異なる形式からデータを取得するために使用できます。  また、文字列から XML を読み取る <xref:System.Xml.XmlDocument.LoadXml%2A> メソッドもあります。  
+  
+ 各 <xref:System.Xml.XmlDocument.Load%2A> メソッドによって、XML ドキュメント オブジェクト モデル \(DOM\) が読み込まれるときに作成されるノードは異なります。  各種の <xref:System.Xml.XmlDocument.Load%2A> メソッド間の違いと、それについて説明しているトピックを次の表に示します。  
+  
+|Subject|トピック|  
+|-------------|----------|  
+|空白ノードの作成|DOM を読み込むために使用したオブジェクトに応じて、DOM で生成される空白ノードと有意の空白ノードの処理が異なります。  詳細については、「[DOM を読み込むときの空白および有意の空白の処理](../../../../docs/standard/data/xml/white-space-and-significant-white-space-handling-when-loading-the-dom.md)」を参照してください。|  
+|特定ノード以降の XML の読み込み、または XML ドキュメント全体の読み込み|<xref:System.Xml.XmlDocument.Load%2A?displayProperty=fullName> メソッドを使用して、データを特定のノードから DOM に読み込むことができます。  詳細については、「[リーダーからのデータの読み込み](../../../../docs/standard/data/xml/load-data-from-a-reader.md)」を参照してください。|  
+|XML の読み込み時の検証|DOM に読み込む XML データは、読み込みながら検証することができます。  これは検証型の <xref:System.Xml.XmlReader> を使用して行えます。  XML の検証の詳細については、「[DOM における XML ドキュメントの検証](../../../../docs/standard/data/xml/validating-an-xml-document-in-the-dom.md)」を参照してください。|  
+  
+ <xref:System.Xml.XmlDocument.LoadXml%2A> メソッドによって XML を読み込む例を次に示します。読み込まれたデータは、`data.xml` というテキスト ファイルに保存されます。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+  
+Public Class Sample  
+  
+    Public Shared Sub Main()  
+        ' Create the XmlDocument.  
+        Dim doc As New XmlDocument()  
+        doc.LoadXml(("<book genre='novel' ISBN='1-861001-57-5'>" & _  
+                    "<title>Pride And Prejudice</title>" & _  
+                    "</book>"))  
+        ' Save the document to a file.  
+        doc.Save("data.xml")  
+    End Sub 'Main  
+End Class 'Sample  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+  
+public class Sample  
+{  
+    public static void Main()  
+    {  
+        // Create the XmlDocument.  
+        XmlDocument doc = new XmlDocument();  
+        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +  
+                    "<title>Pride And Prejudice</title>" +  
+                    "</book>");  
+  
+        // Save the document to a file.  
+        doc.Save("data.xml");  
+    }  
+}  
+```  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/reading-and-writing-xml-schemas.md b/docs/standard/data/xml/reading-and-writing-xml-schemas.md
new file mode 100644
index 00000000000..54c905093ac
--- /dev/null
+++ b/docs/standard/data/xml/reading-and-writing-xml-schemas.md
@@ -0,0 +1,63 @@
+---
+title: "XML スキーマの読み取りと書き込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b5757c4a-ea59-467e-ac62-be2bfe24eb77
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマの読み取りと書き込み
+スキーマ オブジェクト モデル \(SOM\) API を使用すると、ファイルまたは他のソースから XML スキーマ定義言語 \(XSD\) スキーマを読み取ったり、書き込んだりできます。また、W3C \(World Wide Web Consortium\) 勧告『XML Schema』で定義された構造に割り当てられた <xref:System.Xml.Schema?displayProperty=fullName> 名前空間のクラスを使用してメモリ内に XML スキーマを作成することもできます。  
+  
+## XML スキーマの読み取りと書き込み  
+ <xref:System.Xml.Schema.XmlSchema> クラスでは、<xref:System.Xml.Schema.XmlSchema.Read%2A> メソッドおよび <xref:System.Xml.Schema.XmlSchema.Write%2A> メソッドを利用して XML スキーマの読み取りと書き込みを行うことができます。  <xref:System.Xml.Schema.XmlSchema.Read%2A> メソッドは XML スキーマを表す <xref:System.Xml.Schema.XmlSchema> オブジェクトを返し、オプションの <xref:System.Xml.Schema.ValidationEventHandler> をパラメーターとして受け取って XML スキーマの読み取り時に発生するスキーマ検証に関する警告とエラーを処理します。  
+  
+ <xref:System.Xml.Schema.XmlSchema.Write%2A> メソッドは <xref:System.IO.Stream>、<xref:System.IO.TextWriter> および <xref:System.Xml.XmlWriter> オブジェクトに XML スキーマを書き込んで、オプションで <xref:System.Xml.XmlNamespaceManager> オブジェクトをパラメーターとして受け取ることができます。  <xref:System.Xml.XmlNamespaceManager> は、XML スキーマ内で検出される名前空間の処理に使用されます。  <xref:System.Xml.XmlNamespaceManager> クラスの詳細については、「[XML ドキュメントでの名前空間の管理](../../../../docs/standard/data/xml/managing-namespaces-in-an-xml-document.md)」を参照してください。  
+  
+ 次のコード サンプルでは、XML スキーマのファイルからの読み込みとファイルへの書き込みを説明します。  このコード サンプルは、`static` <xref:System.Xml.Schema.XmlSchema.Read%2A> メソッドを使用して <xref:System.Xml.Schema.XmlSchema> オブジェクトに `example.xsd` ファイルを読み込み、その後、このファイルをコンソールに出力して新しい `new.xsd` ファイルに書き込みます。  また、このコード サンプルでは、`static` <xref:System.Xml.Schema.XmlSchema.Read%2A> メソッドに <xref:System.Xml.Schema.ValidationEventHandler> をパラメーターとして指定して、XML スキーマを読み込む際に検出されるスキーマ検証時の警告やエラーの処理を行います。  <xref:System.Xml.Schema.ValidationEventHandler> を指定しないと \(`null`\)、警告やエラーは報告されません。  
+  
+ [!code-cpp[XmlSchemaReadWriteExample#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaReadWriteExample/CPP/XmlSchemaReadWriteExample.cpp#1)]
+ [!code-csharp[XmlSchemaReadWriteExample#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaReadWriteExample/CS/XmlSchemaReadWriteExample.cs#1)]
+ [!code-vb[XmlSchemaReadWriteExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaReadWriteExample/VB/XmlSchemaReadWriteExample.vb#1)]  
+  
+ この例は、入力として `example.xsd` を使用します。  
+  
+```  
+<?xml version="1.0"?>  
+<xs:schema id="play" targetNamespace="http://tempuri.org/play.xsd" elementFormDefault="qualified" xmlns="http://tempuri.org/play.xsd" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+    <xs:element name='myShoeSize'>  
+        <xs:complexType>  
+            <xs:simpleContent>  
+                <xs:extension base='xs:decimal'>  
+                    <xs:attribute name='sizing' type='xs:string' />  
+                </xs:extension>  
+            </xs:simpleContent>  
+        </xs:complexType>  
+    </xs:element>  
+</xs:schema>  
+```  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)   
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)   
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)   
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)   
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [スキーマのコンパイル後の情報セット](../../../../docs/standard/data/xml/post-schema-compilation-infoset.md)   
+ [XML ドキュメントでの名前空間の管理](../../../../docs/standard/data/xml/managing-namespaces-in-an-xml-document.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/reading-entity-declarations-and-entity-references-into-the-dom.md b/docs/standard/data/xml/reading-entity-declarations-and-entity-references-into-the-dom.md
new file mode 100644
index 00000000000..c754b4b4a0e
--- /dev/null
+++ b/docs/standard/data/xml/reading-entity-declarations-and-entity-references-into-the-dom.md
@@ -0,0 +1,67 @@
+---
+title: "エンティティ宣言とエンティティ参照の DOM への読み込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 86dba977-5cc4-4567-964f-027ffabc47b2
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# エンティティ宣言とエンティティ参照の DOM への読み込み
+エンティティとは、コンテンツやマークアップの代わりに XML で使われる名前を指定する宣言です。  エンティティを使用するには、2 つの手順が必要です。  まず、エンティティ宣言を使用して、置換するコンテンツに名前を結び付ける必要があります。  エンティティ宣言は、ドキュメント型定義 \(DTD\) または XML スキーマの中で、`<!ENTITY name "value">` 構文を使って作成します。  次に、エンティティ宣言で定義した名前を XML で使用します。  XML で使用するときは、エンティティ参照と呼ばれます。  たとえば、次のエンティティ宣言は、`publisher` という名前のエンティティを宣言し、それを "Microsoft Press" というコンテンツに関連付けます。  
+  
+```  
+<!ENTITY publisher "Microsoft Press">  
+```  
+  
+ このエンティティ宣言を、XML でエンティティ参照として使用する例を次に示します。  
+  
+```  
+<author>Fred</author>  
+<pubinfo>Published by &publisher;</pubinfo>  
+```  
+  
+ パーサーの中には、ドキュメントをメモリに読み込むとき、エンティティを自動的に展開するものがあります。  この場合は、XML がメモリに読み込まれるときに、エンティティ宣言が記憶されて保存されます。  その後、一般エンティティ参照を識別する `&;` 文字を検出すると、パーサーはその名前をエンティティ宣言テーブルで検索します。  `&publisher;` という参照は、それが表すコンテンツに置き換えられます。  たとえば、次の XML を使用します。  
+  
+```  
+<author>Fred</author>  
+<pubinfo>Published by &publisher;</pubinfo>  
+```  
+  
+ エンティティ参照は展開され、`&publisher;` が Microsoft Press というコンテンツに置き換えられます。展開された XML は次のようになります。  
+  
+ **出力**  
+  
+```  
+<author>Fred</author>  
+<pubinfo>Published by Microsoft Press</pubinfo>  
+```  
+  
+ エンティティには多くの種類があります。  エンティティの分類と用語を次の図に示します。  
+  
+ ![エンティティ型階層のフロー チャート](../../../../docs/standard/data/xml/media/entity-hierarchy.gif "Entity\_hierarchy")  
+  
+ XML ドキュメント オブジェクト モデル \(DOM\) の Microsoft .NET Framework の実装では、XML の読み込み時に既定でエンティティ参照を保持し、エンティティを展開しません。  つまり、ドキュメントが DOM に読み込まれるときには、 **という参照変数を含む `&publisher;`XmlEntityReference** ノードが作成され、その子ノードとして、DTD に宣言されたエンティティのコンテンツを表すノードが作成されます。  
+  
+ `<!ENTITY publisher "Microsoft Press">` というエンティティ宣言を使用した場合に、この宣言によって作成される **XmlEntity** ノードと **XmlText** ノードを次の図に示します。  
+  
+ ![エンティティ宣言により作成されたノード](../../../../docs/standard/data/xml/media/xml-entitydeclaration-node2.png "xml\_entitydeclaration\_node2")  
+  
+ エンティティ参照が展開されるかどうかによって、メモリの DOM ツリーに生成されるノードが変わります。  生成されるノードの違いについては、「[保持されるエンティティ参照](../../../../docs/standard/data/xml/entity-references-are-preserved.md)」と「[保持されずに展開されるエンティティ参照](../../../../docs/standard/data/xml/entity-references-are-expanded-and-not-preserved.md)」で説明しています。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md b/docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md
new file mode 100644
index 00000000000..350ad721ff8
--- /dev/null
+++ b/docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md
@@ -0,0 +1,88 @@
+---
+title: "XPathDocument および XmlDocument を使用した XML データの読み取り | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 5711b225-6aa2-4e4f-9898-19f2d518ad1a
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathDocument および XmlDocument を使用した XML データの読み取り
+<xref:System.Xml.XPath?displayProperty=fullName> 名前空間で XML ドキュメントを読み取る方法は 2 つあります。  1 つは読み取り専用の <xref:System.Xml.XPath.XPathDocument> クラスを使用して XML ドキュメントを読み取る方法で、もう 1 つは、<xref:System.Xml?displayProperty=fullName> 名前空間で編集可能な <xref:System.Xml.XmlDocument> クラスを使用して XML ドキュメントを読み取る方法です。  
+  
+## XPathDocument クラスを使用した XML ドキュメントの読み取り  
+ <xref:System.Xml.XPath.XPathDocument> クラスは、XPath データ モデルによる XML ドキュメントの高速、読み取り専用のメモリ内表現を提供します。  <xref:System.Xml.XPath.XPathDocument> クラスのインスタンスは、その 6 つのコンストラクターの 1 つを使用して作成されます。  これらのコンストラクターでは、<xref:System.IO.Stream>、<xref:System.IO.TextReader>、または <xref:System.Xml.XmlReader> オブジェクトを使用して XML ドキュメントを読み取ることも、XML ファイルへの `string` パスを使用して XML ドキュメントを読み取ることもできます。  
+  
+ 以下は、<xref:System.Xml.XPath.XPathDocument> クラスの `string` コンストラクターを使用して XML ドキュメントを読み取る例です。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+```  
+  
+## XmlDocument クラスを使用した XML ドキュメントの読み取り  
+ <xref:System.Xml.XmlDocument> クラスは、W3C ドキュメント オブジェクト モデル \(DOM\) の DOM Level 1 Core および DOM Level 2 Core を実装する XML ドキュメントの編集可能なメモリ内表現です。  <xref:System.Xml.XmlDocument> クラスのインスタンスは、その 3 つのコンストラクターの 1 つを使用して作成されます。  <xref:System.Xml.XmlDocument> クラス コンストラクターをパラメーターなしで呼び出すことによって、新しい空の <xref:System.Xml.XmlDocument> オブジェクトを作成できます。  コンストラクターの呼び出し後、<xref:System.Xml.XmlDocument.Load%2A> メソッドを使用するか、XML ファイルへの `string` パスを使用して、<xref:System.IO.Stream>、<xref:System.IO.TextReader>、または <xref:System.Xml.XmlReader> オブジェクトから新しい <xref:System.Xml.XmlDocument> オブジェクトに XML データを読み込みます。  
+  
+ 以下は、パラメーターなしの <xref:System.Xml.XmlDocument> クラス コンストラクターと <xref:System.Xml.XmlDocument.Load%2A> メソッドを使用して XML ドキュメントを読み込む例です。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("books.xml")  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("books.xml");  
+```  
+  
+## XML ドキュメントのエンコーディングの判定  
+ 前に示されているように、<xref:System.Xml.XmlReader> オブジェクトを使用して XML ドキュメントを読み取り、<xref:System.Xml.XPath.XPathDocument> および <xref:System.Xml.XmlDocument> オブジェクトを作成できます。  ただし、<xref:System.Xml.XmlReader> オブジェクトは、エンコードされていないデータを読み取り、その結果、エンコード情報を提供しない場合があります。  
+  
+ <xref:System.Xml.XmlTextReader> クラスは、<xref:System.Xml.XmlReader> クラスを継承し、その <xref:System.Xml.XmlTextReader.Encoding%2A> プロパティを使用してエンコード情報を提供します。また、このクラスは、<xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクトの作成に使用できます。  
+  
+ <xref:System.Xml.XmlTextReader> クラスよって提供されるエンコード情報に関する詳細については、<xref:System.Xml.XmlTextReader> クラスのリファレンス ドキュメントの「<xref:System.Xml.XmlTextReader.Encoding%2A>」プロパティを参照してください。  
+  
+## XPathNavigator オブジェクトの作成  
+ <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクトのどちらからに XML ドキュメントを読み込んだ後、<xref:System.Xml.XPath.XPathNavigator> オブジェクト作成して、基になる XML データを選択、評価、移動、および \(一部の状況で\) 編集できます。  
+  
+ <xref:System.Xml.XmlNode> クラスに加えて、<xref:System.Xml.XPath.XPathDocument> および <xref:System.Xml.XmlDocument> クラスは両方とも、<xref:System.Xml.XPath?displayProperty=fullName> 名前空間の <xref:System.Xml.XPath.IXPathNavigable> インターフェイスを実装しています。  結果として、3 つのクラスはすべて <xref:System.Xml.XPath.XPathNavigator> オブジェクトを返す <xref:System.Xml.XPath.IXPathNavigable.CreateNavigator%2A> メソッドを提供します。  
+  
+### XPathNavigator クラスによる XML ドキュメントの編集  
+ XML データの選択、評価、および移動に加えて、<xref:System.Xml.XPath.XPathNavigator> クラスは、作成元のオブジェクトに基づき、一部の状況で XML ドキュメントの編集に使用できます。  
+  
+ <xref:System.Xml.XPath.XPathDocument> クラスは読み取り専用ですが、<xref:System.Xml.XmlDocument> クラスは編集可能です。その結果、<xref:System.Xml.XPath.XPathDocument> オブジェクトから作成された <xref:System.Xml.XPath.XPathNavigator> オブジェクトは XML ドキュメントの編集に使用できませんが、<xref:System.Xml.XmlDocument> オブジェクトから作成された場合は編集に使用できます。  <xref:System.Xml.XPath.XPathDocument> クラスは XML ドキュメントの読み取りだけに使用する必要があります。  XML ドキュメントを編集する必要がある場合、またはイベント処理など <xref:System.Xml.XmlDocument> クラスによって提供される追加の機能が必要な場合は、<xref:System.Xml.XmlDocument> クラスを使用する必要があります。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパテイは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが XML データを編集できるかどうかを指定します。  
+  
+ 各クラスの <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパティ値についての説明を次に示します。  
+  
+|<xref:System.Xml.XPath.IXPathNavigable> 実装|<xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> 値|  
+|--------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Xml.XPath.XPathDocument>|`false`|  
+|<xref:System.Xml.XmlDocument>|`true`|  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの編集](../../../../docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/recoverable-xslt-errors.md b/docs/standard/data/xml/recoverable-xslt-errors.md
new file mode 100644
index 00000000000..a5fe0c33d7e
--- /dev/null
+++ b/docs/standard/data/xml/recoverable-xslt-errors.md
@@ -0,0 +1,67 @@
+---
+title: "XSLT エラーの解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 484929b0-fefb-4629-87ee-ebdde70ff1f8
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XSLT エラーの解決
+W3C 勧告『XSL Transformations \(XSLT\) Version 1.0』には、対処方法を実装者が決定できる事項があります。  このような事項は、随意動作と見なされています。  たとえば、XSLT 1.0 Recommendation は、セクション 7.3「Creating Processing Instructions」で、`xsl:processing-instruction` の内容をインスタンス化したときに、テキスト ノード以外のノードが作成されるのはエラーであるとしています。  いくつかの問題に関しては、プロセッサがエラー状態から回復するときにどのような対処をするべきかを、XSLT 1.0 Recommendation が規定しています。  セクション 7.3 に記述されている問題に関しては、W3C では、作成されたノードとその内容を無視することで、このエラーから回復できるとしています。  
+  
+## 随意動作  
+ XSLT 1.0 Recommendation で許可されている随意動作と <xref:System.Xml.Xsl.XslCompiledTransform> クラスによるこれらの動作の処理方法を次の表に示します。  
+  
+-   復元は、<xref:System.Xml.Xsl.XslCompiledTransform> クラスがこのエラーから回復することを示しています。  <xref:System.Xml.Xsl.XsltArgumentList.XsltMessageEncountered?displayProperty=fullName> イベントを使用すると、XSLT プロセッサのすべてのイベントを通知できます。  
+  
+-   エラーは、この状態に対する例外が発生したことを示します。  
+  
+-   詳細については、W3C 勧告『[XSL Transformations \(XSLT\) Version 1.0 Recommendation](http://go.microsoft.com/fwlink/?LinkId=49919)』および『[XSL Transformations \(XSLT\) Version 1.0 Specification Errata](http://go.microsoft.com/fwlink/?LinkId=49917)』を参照してください。  
+  
+|XSLT の状態|セクション|XslCompiledTransform の動作|  
+|--------------|-----------|------------------------------|  
+|テキスト ノードが `xsl:strip-space` と `xsl:preserve-space` の両方に適合している。|3.4|復元|  
+|ソース ノードが複数のテンプレート規則に適合している。|5.5|復元|  
+|1 つの名前空間 URI が同じインポート優先順位を持つ複数の名前空間 URI のエイリアスとして宣言されている。|7.1.1|復元|  
+|属性値から生成された `xsl:attribute` と `xsl:element` 内の `name` 属性が QName ではない。|7.1.2, 7.1.3|エラー\*|  
+|同じインポートおよび展開名を持つ 2 つの属性セットに共通の属性が含まれており、これらの属性セット以外に、同じ名前で優先順位の高い共通属性を含む属性セットがない。|7.1.4|復元|  
+|要素に子が既に追加されているにもかかわらず、その要素に属性が追加される。|7.1.3|エラー\*|  
+|'xmlns' という名前を持つ属性が作成される。|7.1.3|エラー\*|  
+|要素ではないノードに属性が追加される。|7.1.3|エラー\*|  
+|`xsl:attribute` 属性の内容をインスタンス化する際にテキスト ノード以外のノードが作成される。|7.1.3|エラー\*|  
+|`xsl:processing-instruction` の `name` 属性が NCName と処理命令ターゲットのどちらも生成しない。|7.3|エラー\*|  
+|`xsl:processing-instruction` の内容をインスタンス化すると、テキスト ノード以外のノードが作成される。|7.3|エラー\*|  
+|`xsl:processing-instruction` の内容をインスタンス化した結果に文字列 "?\>" が含まれている。|7.3|復元|  
+|`xsl:processing-instruction` の内容をインスタンス化した結果に文字列 "\-\-" が含まれているか、または "\-" で終了している。|7.4|復元|  
+|`xsl:comment` の内容をインスタンス化した結果、テキスト ノード以外のノードが作成される。|7.4|エラー\*|  
+|変数バインディング要素内のテンプレートが属性ノードまたは名前空間ノードを返す。|11.2|エラー\*|  
+|document 関数に渡された URI からのリソースの取得時にエラーが発生する。|12.1|Error|  
+|document 関数内の URI 参照にフラグメント ID が含まれており、その ID を処理するとエラーが発生する。|12.1|復元\*|  
+|同じ名前とさまざまな値を持つ複数の属性があり、これらの属性が同じインポート優先順位を持つ `xsl:output` の名前付き cdata\-section 要素にならない。|16|復元|  
+|プロセッサが `xsl:output` の encoding 属性のエンコーディングをサポートしない。|16.1|復元|  
+|テキスト ノードの出力エスケープが無効で、そのテキスト ノードが結果ツリーのテキスト ノード以外のもののために使用されている。|16.4|復元\*|  
+|出力エスケープが有効に設定されているテキスト ノードが結果ツリー フラグメントに含まれている場合に、そのフラグメントが数値や文字列に変換される。|16.4|復元\*|  
+|XSLT プロセッサが出力に使用しているエンコーディングで表すことができない文字に対して、出力エスケープが無効に設定される。|16.4|復元\*|  
+|要素に子または属性が追加された後で、その要素に名前空間ノードが追加される。|errata 25|エラー\*|  
+|`xsl:number` の `value` 属性が NAN、無限、または 0.5 未満である。|errata 24|復元|  
+|document 関数への 2 番目の引数ノード セットが空であり、URI 参照が相対 URI 参照である。|errata 14|復元|  
+  
+ <sup>*</sup> この動作は、<xref:System.Xml.Xsl.XslTransform> クラスの動作とは異なります。  詳細については、「[XslTransform クラスの随意動作の実装](../../../../docs/standard/data/xml/implementation-of-discretionary-behaviors-in-the-xsltransform-class.md)」を参照してください。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..bdb66773626
--- /dev/null
+++ b/docs/standard/data/xml/remove-xml-data-using-xpathnavigator.md
@@ -0,0 +1,196 @@
+---
+title: "XPathNavigator による XML データの削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 9f436bca-1b96-494b-a6d2-e102c7551752
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator による XML データの削除
+<xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメントからノードを削除するためのメソッドのセットを提供します。  これらのメソッドを使用するには、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが編集可能である必要があります。つまり、その <xref:System.Xml.XPath.XPathNavigator.CanEdit%2A> プロパティを `true` にする必要があります。  
+  
+ XML ドキュメントを編集できる <xref:System.Xml.XPath.XPathNavigator> オブジェクトは、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.CreateNavigator%2A> メソッドによって作成されます。  <xref:System.Xml.XPath.XPathDocument> クラスによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトは読み取り専用であり、<xref:System.Xml.XPath.XPathDocument> オブジェクトによって作成される <xref:System.Xml.XPath.XPathNavigator> オブジェクトの編集メソッドを使用しようとすると、<xref:System.NotSupportedException> が発生します。  
+  
+ 編集可能な <xref:System.Xml.XPath.XPathNavigator> オブジェクトの作成に関する詳細については、「[XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)」を参照してください。  
+  
+## ノードの削除  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメントからノードを削除する <xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを提供します。  
+  
+### 1 つのノードの削除  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、XML ドキュメントから、<xref:System.Xml.XPath.XPathNavigator> オブジェクトが現在位置している現在のノードを削除する <xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを提供します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを使用してノードを削除した後は、<xref:System.Xml.XmlDocument> オブジェクトのルートからそのノードに到達することはできません。  ノードの削除後、<xref:System.Xml.XPath.XPathNavigator> は削除されたノードの親ノード上に位置します。  
+  
+ 削除操作により、削除されたノード上に位置していた <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置に影響はありません。  これらの <xref:System.Xml.XPath.XPathNavigator> オブジェクトは削除されたサブツリー内を移動できるという点で有効ですが、<xref:System.Xml.XPath.XPathNavigator> クラスの通常のノード セットの移動メソッドを使用して、主ノード ツリーには移動できません。  
+  
+> [!NOTE]
+>  <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.MoveTo%2A> メソッドは、これらの <xref:System.Xml.XPath.XPathNavigator> オブジェクトを主ノード ツリーに戻したり、主ノード ツリーから削除されたサブツリーに移動したりするために使用できます。  
+  
+ 次の例では、`contosoBooks.xml` ファイルの最初の `book` 要素の `price` 要素を、<xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを使用して削除します。  `price` 要素が削除された後の <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置は、親の `book` 要素上です。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("contosoBooks.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.DeleteSelf()  
+  
+Console.WriteLine("Position after delete: {0}", navigator.Name)  
+Console.WriteLine(navigator.OuterXml)  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("contosoBooks.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.DeleteSelf();  
+  
+Console.WriteLine("Position after delete: {0}", navigator.Name);  
+Console.WriteLine(navigator.OuterXml);  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+### 属性ノードの削除  
+ 属性ノードは <xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを使用して XML ドキュメントから削除します。  
+  
+ 削除後、<xref:System.Xml.XmlDocument> オブジェクトのルート ノードから属性ノードには到達できません。<xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置は親要素上になります。  
+  
+#### 既定の属性  
+ XML ドキュメントの既定の属性として、DTD または XML スキーマに定義されている属性を削除するときは、使用するメソッドにかかわらず、特別な制限が適用されます。  既定の属性は、その属性が含まれている要素も削除しない限り削除できません。  既定の属性が宣言されている要素に既定の属性は常に存在します。その結果、既定の属性を削除すると、その要素に代替の属性が挿入され、宣言された既定の値に初期化されます。  
+  
+## 値の削除  
+ <xref:System.Xml.XPath.XPathNavigator> クラスには、XML ドキュメントから型指定された値と型指定されていない値を削除する <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドと <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドがあります。  
+  
+### 型指定されていない値の削除  
+ <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドは、パラメーターとして渡された型指定されていない `string` 値を挿入するだけです。このパラメーターは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にあるノードの値です。  <xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドに空の文字列を渡すと、現在のノードの値が削除されます。  
+  
+ 次の例では、<xref:System.Xml.XPath.XPathNavigator.SetValue%2A> メソッドを使用して、`contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 要素の値を削除します。  
+  
+```vb  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load("contosoBooks.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.SetValue("")  
+  
+navigator.MoveToRoot()  
+Console.WriteLine(navigator.OuterXml)  
+```  
+  
+```csharp  
+XmlDocument document = new XmlDocument();  
+document.Load("contosoBooks.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.SetValue("");  
+  
+navigator.MoveToRoot();  
+Console.WriteLine(navigator.OuterXml);  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+### 型指定された値の削除  
+ ノードの型が W3C XML スキーマの単純型の場合、<xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドによって挿入される新しい値は、値の設定前に、単純型のファセットに対してチェックされます。  新しい値がノードの型に対して無効な場合 \(たとえば、型が `xs:positiveInteger` の要素に、値 `-1` を設定するような場合\)、例外が返されます。  <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドにもパラメーターとして `null` を渡すことはできません。  結果として、型指定されたノードの値の削除は、ノードのスキーマの型に従う必要があります。  
+  
+ 次の例では、<xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドを使用して、値を `0` に設定することにより、`contosoBooks.xml` ファイル内の最初の `book` 要素の `price` 要素の値を削除します。  ノードの値は削除されませんが、本の価格はそのデータ型 `xs:decimal` に従って削除されました。  
+  
+```vb  
+Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+settings.ValidationType = ValidationType.Schema  
+  
+Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
+  
+Dim document As XmlDocument = New XmlDocument()  
+document.Load(reader)  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+navigator.MoveToChild("book", "http://www.contoso.com/books")  
+navigator.MoveToChild("price", "http://www.contoso.com/books")  
+  
+navigator.SetTypedValue(0)  
+  
+navigator.MoveToRoot()  
+Console.WriteLine(navigator.OuterXml)  
+```  
+  
+```csharp  
+XmlReaderSettings settings = new XmlReaderSettings();  
+settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+settings.ValidationType = ValidationType.Schema;  
+  
+XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
+  
+XmlDocument document = new XmlDocument();  
+document.Load(reader);  
+XPathNavigator navigator = document.CreateNavigator();  
+  
+navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+navigator.MoveToChild("book", "http://www.contoso.com/books");  
+navigator.MoveToChild("price", "http://www.contoso.com/books");  
+  
+navigator.SetTypedValue(0);  
+  
+navigator.MoveToRoot();  
+Console.WriteLine(navigator.OuterXml);  
+```  
+  
+## 名前空間ノード  
+ 名前空間ノードは <xref:System.Xml.XmlDocument> オブジェクトから削除できません。  <xref:System.Xml.XPath.XPathNavigator.DeleteSelf%2A> メソッドを使用して名前空間ノードを削除しようとすると、例外が発生します。  
+  
+## InnerXml および OuterXml プロパティ  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> および <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある XML マークアップを変更します。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティは、与えられた XML `string` の解析済みの内容を使用して <xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードの XML マークアップを変更します。  同様に、<xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトの現在位置にある子ノードと現在のノード自体の XML マークアップを変更します。  
+  
+ このトピックで説明したメソッドに加えて、<xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティと <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティは、XML ドキュメントからノードと値を削除するために使用できます。  <xref:System.Xml.XPath.XPathNavigator.InnerXml%2A> プロパティと <xref:System.Xml.XPath.XPathNavigator.OuterXml%2A> プロパティを使用してノードを変更する方法の詳細については「[XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)」を参照してください。  
+  
+## XML ドキュメントの保存  
+ ここに記載されているメソッドによる <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存は、<xref:System.Xml.XmlDocument> クラスのメソッドを使用して実行されます。  <xref:System.Xml.XmlDocument> オブジェクトに対する変更の保存に関する詳細については、「[ドキュメントの保存と書き込み](../../../../docs/standard/data/xml/saving-and-writing-a-document.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator による XML データの挿入](../../../../docs/standard/data/xml/insert-xml-data-using-xpathnavigator.md)   
+ [XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md b/docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md
new file mode 100644
index 00000000000..2121a1513b1
--- /dev/null
+++ b/docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md
@@ -0,0 +1,52 @@
+---
+title: "DOM の要素ノードからの属性の削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 7ede6f9e-a3ac-49a4-8488-ab8360a44aa4
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM の要素ノードからの属性の削除
+属性を削除するには、さまざまな方法があります。  その 1 つとして、属性コレクションから属性を削除する方法があります。  属性コレクションから属性を削除するには、次の手順を実行します。  
+  
+1.  `XmlAttributeCollection attrs = elem.Attributes;` を使用して要素から属性コレクションを取得します。  
+  
+2.  属性コレクションから属性を削除するには、次の 3 つのメソッドのいずれかを使用します。  
+  
+    -   <xref:System.Xml.XmlAttributeCollection.Remove%2A> メソッドを使用して、特定の属性を削除する。  
+  
+    -   <xref:System.Xml.XmlAttributeCollection.RemoveAll%2A> メソッドを使用して、コレクションからずべての属性を削除し、属性のない要素を残す。  
+  
+    -   <xref:System.Xml.XmlAttributeCollection.RemoveAt%2A> メソッドを使用して、コレクションのインデックス番号を使用して 1 つの属性を属性コレクションから削除する。  
+  
+ 要素ノードから属性を削除するには、次のメソッドを使用します。  
+  
+-   <xref:System.Xml.XmlElement.RemoveAllAttributes%2A> メソッドを使用して、属性のコレクションを削除する。  
+  
+-   <xref:System.Xml.XmlElement.RemoveAttribute%2A> メソッドを使用して、名前を指定して単一の属性をコレクションから削除する。  
+  
+-   <xref:System.Xml.XmlElement.RemoveAttributeAt%2A> メソッドを使用して、インデックス番号を指定して単一の属性をコレクションから削除する。  
+  
+ もう 1 つの方法として、要素を取得し、属性コレクションから属性を取得して、属性ノードを直接削除する方法もあります。  属性コレクションから属性を取得するには、名前 \(`XmlAttribute attr = attrs["attr_name"];`\)、インデックス \(`XmlAttribute attr = attrs[0];`\)、または名前空間を指定した完全修飾名 \(`XmlAttribute attr = attrs["attr_localName", "attr_namespace"]`\) を使用できます。  
+  
+ 既定の属性としてドキュメント型定義 \(DTD\) に定義されている属性を削除するときは、使用するメソッドにかかわらず、特別な制限が適用されます。  既定の属性は、その属性が含まれている要素を削除しない限り削除できません。  既定の属性が宣言されている要素には、常に既定の属性が存在します。  <xref:System.Xml.XmlAttributeCollection> または <xref:System.Xml.XmlElement> から既定の属性を削除すると、代わりの属性が要素の <xref:System.Xml.XmlAttributeCollection> に挿入され、宣言されている既定値に初期化されます。  たとえば、`<book att1="1" att2="2" att3="3"></book>` として定義された要素がある場合、`book` 要素には、宣言された 3 つの既定の属性が設定されます。  XML ドキュメント オブジェクト モデル \(DOM\) の実装によって、この `book` 要素が存在する限り、`att1`、`att2`、および `att3` という 3 つの既定の属性が存在することが保証されます。  
+  
+ <xref:System.Xml.XmlAttribute> を呼び出した場合、<xref:System.Xml.XmlAttributeCollection.RemoveAll%2A> メソッドにより、属性の値が String.Empty に設定されます。これは、値のない属性が存在できないためです。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/removing-node-content-in-the-dom.md b/docs/standard/data/xml/removing-node-content-in-the-dom.md
new file mode 100644
index 00000000000..136e7835340
--- /dev/null
+++ b/docs/standard/data/xml/removing-node-content-in-the-dom.md
@@ -0,0 +1,28 @@
+---
+title: "DOM のノード コンテンツの削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 615d81a7-f44f-416c-a9ab-bfe03f85e6e4
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM のノード コンテンツの削除
+<xref:System.Xml.XmlCharacterData> を継承するノード型、つまり <xref:System.Xml.XmlComment>、<xref:System.Xml.XmlText>、<xref:System.Xml.XmlCDataSection>、<xref:System.Xml.XmlWhitespace>、および <xref:System.Xml.XmlSignificantWhitespace> ノード型では、ノードから文字範囲を削除する <xref:System.Xml.XmlCharacterData.DeleteData%2A> メソッドを使用して文字を削除できます。  コンテンツを完全に削除するには、そのコンテンツが含まれているノードを削除します。  ノードを保持する必要があり、コンテンツが正しくない場合は、そのコンテンツを変更します。  ノードのコンテンツを変更する方法については、「[XML ドキュメントのノード、コンテンツ、値の変更](../../../../docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md b/docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md
new file mode 100644
index 00000000000..db058503c7f
--- /dev/null
+++ b/docs/standard/data/xml/removing-nodes-content-and-values-from-an-xml-document.md
@@ -0,0 +1,30 @@
+---
+title: "XML ドキュメントからのノード、コンテンツ、値の削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d818a29a-6ee5-4725-97c4-78cf60a156b6
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントからのノード、コンテンツ、値の削除
+XML ドキュメント オブジェクト モデル \(DOM\) がメモリに読み込まれたら、ツリーからノードを削除したり、特定のノード型からコンテンツや値を削除したりできます。  ドキュメントから葉ノードまたはノード サブツリー全体を削除する方法については、「[DOM からのノードの削除](../../../../docs/standard/data/xml/removing-nodes-from-the-dom.md)」を参照してください。  要素の属性を削除する方法については、「[DOM の要素ノードからの属性の削除](../../../../docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md)」を参照してください。  ノードのコンテンツだけを削除してツリーにノードを残す方法については、「[DOM のノード コンテンツの削除](../../../../docs/standard/data/xml/removing-node-content-in-the-dom.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)   
+ [XML ドキュメントへのノードの挿入](../../../../docs/standard/data/xml/inserting-nodes-into-an-xml-document.md)   
+ [XML ドキュメントのノード、コンテンツ、値の変更](../../../../docs/standard/data/xml/modifying-nodes-content-and-values-in-an-xml-document.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/removing-nodes-from-the-dom.md b/docs/standard/data/xml/removing-nodes-from-the-dom.md
new file mode 100644
index 00000000000..3a0225d733a
--- /dev/null
+++ b/docs/standard/data/xml/removing-nodes-from-the-dom.md
@@ -0,0 +1,34 @@
+---
+title: "DOM からのノードの削除 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 0a98e0ca-0555-45c1-ab69-0d8d20ca1abd
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM からのノードの削除
+XML ドキュメント オブジェクト モデル \(DOM\) からノードを削除するには、<xref:System.Xml.XmlNode.RemoveChild%2A> メソッドを使用して特定のノードを削除します。  ノードを削除すると、削除しようとしたノードがリーフ ノードでない場合は、そのノードに含まれるサブツリーも削除されます。  
+  
+ DOM から複数のノードを削除するには、<xref:System.Xml.XmlNode.RemoveAll%2A> メソッドを使用します。現在のノードに子や属性があれば、それらがすべて削除されます。  
+  
+ <xref:System.Xml.XmlNamedNodeMap> を使用している場合は、<xref:System.Xml.XmlNamedNodeMap.RemoveNamedItem%2A> メソッドを使用してノードを削除できます。  
+  
+ 属性を削除するには、「[DOM の要素ノードからの属性の削除](../../../../docs/standard/data/xml/removing-attributes-from-an-element-node-in-the-dom.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md b/docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md
new file mode 100644
index 00000000000..8d3aef43271
--- /dev/null
+++ b/docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md
@@ -0,0 +1,56 @@
+---
+title: "XSLT 処理中の外部リソースの解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 3a59d31c-0ec5-4de6-a2a9-558531c8116e
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XSLT 処理中の外部リソースの解決
+XSLT 変換中には、外部リソースの解決が必要になる場合があります。  
+  
+## XmlResolver クラスの使い方  
+ 外部リソースを解決するには、<xref:System.Xml.XmlResolver> クラスを使用します。  XSLT 処理中に <xref:System.Xml.XmlResolver> が使用される場合を次の表に示します。  
+  
+|XSLT タスク|XmlResolver が使用される場合|  
+|--------------|--------------------------|  
+|スタイル シートのコンパイル。|スタイル シートの URI の解決。<br /><br /> および<br /><br /> `xsl:import` 要素または `xsl:include` 要素の URI リファレンスの解決。|  
+|スタイル シートの実行。|コンテキスト ドキュメントの URI の解決。<br /><br /> および<br /><br /> XSLT の `document()` 関数での URI リファレンスの解決。|  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドおよび <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドには、<xref:System.Xml.XmlResolver> オブジェクトを引数の 1 つとして受け取るオーバーロードが含まれます。  <xref:System.Xml.XmlResolver> を指定しない場合は、資格情報を持たない既定の <xref:System.Xml.XmlUrlResolver> が使用されます。  
+  
+ <xref:System.Xml.XmlResolver> オブジェクトを使用する場合の説明を次の一覧に示します。  
+  
+-   XSLT 処理で認証が必要なネットワーク リソースにアクセスする必要がある場合、必要な資格情報に対して <xref:System.Xml.XmlResolver> を使用します。  
+  
+-   XSLT 処理がアクセスできるリソースを制限する場合、適切なアクセス許可セットに対して <xref:System.Xml.XmlSecureResolver> を使用します。  制御対象外の \(信頼できない\) リソースを開く場合には、<xref:System.Xml.XmlSecureResolver> クラスを使用します。  
+  
+-   動作をカスタマイズする場合は、独自の <xref:System.Xml.XmlResolver> クラスを実装し、これを使用してリソースを解決することができます。  
+  
+-   外部リソースにアクセスできないようにする場合は、<xref:System.Xml.XmlResolver> の引数に `null` を指定します。  
+  
+## 例  
+ ネットワーク リソースに格納されているスタイル シートをコンパイルする例を次に示します。  <xref:System.Xml.XmlUrlResolver> オブジェクトには、スタイル シートにアクセスするのに必要な資格情報を指定します。  
+  
+ [!code-csharp[XslCompiledTransform.Load#11](../../../../samples/snippets/csharp/VS_Snippets_Data/XslCompiledTransform.Load/CS/Xslt_Load_v2.cs#11)]
+ [!code-vb[XslCompiledTransform.Load#11](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XslCompiledTransform.Load/VB/Xslt_Load_v2.vb#11)]  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XslCompiledTransform>   
+ <xref:System.Xml.Xsl.XsltSettings>   
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/resolving-external-resources.md b/docs/standard/data/xml/resolving-external-resources.md
new file mode 100644
index 00000000000..be038476c4c
--- /dev/null
+++ b/docs/standard/data/xml/resolving-external-resources.md
@@ -0,0 +1,65 @@
+---
+title: "外部リソースの解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ad3fa320-4b8f-4e5c-b549-01157591007a
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 外部リソースの解決
+**XmlDocument** クラスでは、外部のドキュメント型定義 \(DTD\)、エンティティ、スキーマなど、XML データのインラインでないリソースを検索するときに **XmlDocument** の **XmlResolver** プロパティを使用します。  これらのリソースは、ネットワーク上やローカル ドライブ上にあり、URI \(Uniform Resource Identifier\) で識別できます。  そのため、**XmlDocument** は、ドキュメント内にある **EntityReference** ノードを解決し、外部の DTD またはスキーマに基づいてドキュメントを検証することができます。  
+  
+## 完全に信頼されている XmlDocument  
+ **XmlResolver** プロパティは、**XmlDocument.Load** メソッドの機能に影響を与えることがあります。  **XmlDocument** オブジェクトが完全に信頼されている場合の **XmlDocument.XmlResolver** プロパティの動作を次の表に示します。  Load への入力が **TextReader**、**String**、**Stream**、または **URI** である場合の **XmlDocument.Load** メソッドが対象です。  **XmlDocument** が **XmlReader** から読み込まれた場合の **Load** メソッドは対象外です。  
+  
+|XmlResolver プロパティ|関数|メモ|  
+|-----------------------|--------|--------|  
+|プロパティが、以前作成され、ユーザーの設定したプロパティを持っている **XmlResolver** クラスに設定されている。|**XmlDocument** は、ファイル名を解決するために指定された **XmlResolver** を使用し、DTD、エンティティ、スキーマなどの外部リソースへの参照を解決します。<br /><br /> **XmlResolver** は、**XmlDocument** のノードの追加や編集に必要な外部リソースを解決するときにも使用されます。|**XmlDocument** に指定された **XmlResolver** は、外部リソースの検索と解決が必要な場合に常に使用されるリゾルバーです。|  
+|プロパティが **null** \(Microsoft Visual Basic .NET では **Nothing**\) に設定されている。|外部のスキーマや DTD の検索など、外部リソースを必要とする機能はサポートされていません。  外部エンティティの解決も行われず、解決が必要なエンティティ ノードの挿入などの編集機能もサポートされません。|**XmlDocument** は、ファイルを匿名で読み込みます。他のリソースを解決しようとはしません。|  
+|プロパティが設定されておらず、既定状態のままである。|ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、NULL 資格情報を持つ **XmlUrlResolver** のインスタンスが作成され、**XmlDocument** によって使用されます。ノードを編集するときは、**null** 資格情報が使用されます。||  
+  
+ **Load** への入力が **XmlReader** であり、**XmlDocument** が完全に信頼されている場合の **XmlDocument.Load** メソッドを次の表に示します。  
+  
+|XmlResolver プロパティ|関数|メモ|  
+|-----------------------|--------|--------|  
+|**XmlDocument** で使用される **XmlResolver** クラスが、**XmlReader** で使用されるクラスと同じである。|**XmlDocument** は、**XmlReader** に割り当てられた **XmlResolver** を使用します。<br /><br /> **XmlDocument** は **XmlReader** から **XmlResolver** を取得しているため、**XmlDocument** の信頼レベルにかかわらず、**XmlDocument.Resolver** プロパティは設定できません。  **XmlDocument** の **XmlResolver** プロパティを設定することによって **XmlReaders** の **XmlResolver** の設定をオーバーライドすることはできません。|**XmlReader** は、**XmlTextReader**、**XmlValidatingReader**、または独自に作成したリーダーにすることができます。  使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。  渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。|  
+  
+## 信頼性の高くない XmlDocument  
+ オブジェクトの信頼性が高くない場合の **XmlDocument.XmlResolver** プロパティの動作を次の表に示します。  Load への入力が **TextReader**、**String**、**Stream**、または **URI** である場合の **XmlDocument.Load** メソッドが対象です。  **XmlDocument** が **XmlReader** から読み込まれた場合の **Load** メソッドは対象外です。  
+  
+|XmlResolver プロパティ|関数|メモ|  
+|-----------------------|--------|--------|  
+|信頼性が高くないシナリオでは、**XmlResolver** プロパティは null 以外に設定できない。|ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、**null** 資格情報を持つ **XmlUrlResolver** のインスタンスが作成され、**XmlDocument** によって使用されます。ノードを編集するときは、**null** 資格情報が使用されます。|この動作は、**XmlResolver** プロパティが設定されておらず、既定状態のままである場合と同じ動作になります。<br /><br /> **XmlDocument** では、すべての処理で、匿名のアクセス許可を使用します。|  
+|プロパティが **null** \(Microsoft Visual Basic .NET では **Nothing**\) に設定されている。|外部のスキーマや DTD の検索など、外部リソースを必要とする機能はサポートされていません。  外部エンティティの解決も行われず、解決が必要なエンティティ ノードの挿入などの編集機能もサポートされません。|プロパティが **null** の場合の動作は、**XmlDocument** の信頼性の高低に関係なく、同じです。|  
+|プロパティが設定されておらず、既定状態のままである。|ファイル名を解決したり、外部の DTD、エンティティ、スキーマを検索するときは、**null** 資格情報を持つ **XmlUrlResolver** のインスタンスが作成され、**XmlDocument** によって使用されます。ノードを編集するときは、**null** 資格情報が使用されます。|**XmlDocument** では、すべての処理で、匿名のアクセス許可を使用します。|  
+  
+ **Load** への入力が **XmlReader** であり、**XmlDocument** の信頼性が高くない場合の **XmlDocument.Load** メソッドを次の表に示します。  
+  
+|XmlResolver プロパティ|関数|メモ|  
+|-----------------------|--------|--------|  
+|**XmlDocument** で使用される **XmlResolver** クラスが、**XmlReader** で使用されるクラスと同じである。|**XmlDocument** は、**XmlReader** に割り当てられた **XmlResolver** を使用します。<br /><br /> **XmlDocument** は **XmlReader** から **XmlResolver** を取得しているため、**XmlDocument** の信頼レベルにかかわらず、**XmlDocument.Resolver** プロパティは設定できません。  **XmlDocument** の **XmlResolver** プロパティを設定することによって **XmlReaders** の **XmlResolver** の設定をオーバーライドすることはできません。|**XmlTextReader**、検証用の <xref:System.Xml.XmlReader>、または独自に作成したリーダーを **XmlReader** として使用できます。  使用するリーダーでエンティティ解決がサポートされている場合は、外部エンティティが解決されます。  渡されたリーダーでエンティティ参照がサポートされていない場合は、エンティティ参照は解決されません。|  
+  
+ XmlResolver が正しい資格情報を持つように設定すれば、外部リソースにアクセスできます。  
+  
+> [!NOTE]
+>  **XmlResolver** プロパティを取得する方法はありません。  これは、資格情報が設定されている **XmlResolver** をユーザーが再利用するのを防ぐためです。  また、**XmlTextReader** または検証用の <xref:System.Xml.XmlReader> を使用して、リゾルバーが設定されている **XmlDocument** を読み込んだ場合、**XmlDocument** は、セキュリティ リスクを回避するために、**Load** フェーズの後、これらのリーダーのリゾルバーをキャッシュしません。  
+  
+ 詳細については、<xref:System.Xml.XmlResolver> のリファレンス ページの「解説」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/resolving-external-xslt-style-sheets-and-documents.md b/docs/standard/data/xml/resolving-external-xslt-style-sheets-and-documents.md
new file mode 100644
index 00000000000..8e4ed703279
--- /dev/null
+++ b/docs/standard/data/xml/resolving-external-xslt-style-sheets-and-documents.md
@@ -0,0 +1,67 @@
+---
+title: "外部の XSLT スタイル シートとドキュメントの解決 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 920cfe3b-d525-4bb2-abf6-9431651f9cf9
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 外部の XSLT スタイル シートとドキュメントの解決
+変換中には、外部リソースの解決が必要になるときがあります。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  
+  
+ 変換中には、外部リソースの解決が必要になるときがあります。  
+  
+-   <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドの実行時における外部スタイル シートの検索。  
+  
+-   <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドの実行時におけるスタイル シート内の `<xsl:include>` 要素または `<xsl:import>` 要素の解決。  
+  
+-   <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドの実行時におけるすべての `document()` 関数の解決。  
+  
+## XmlResolver クラスの使い方  
+ ネットワーク リソースにアクセスするのに認証が必要な場合は、<xref:System.Xml.XmlResolver> パラメーターを持っている <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドを使用して、必要な資格情報プロパティが設定された <xref:System.Xml.XmlResolver> オブジェクトを渡します。  
+  
+ 独自の <xref:System.Xml.XmlResolver> を使用する場合や、異なる資格情報を指定する必要がある場合は、次の表に示すように、解決する必要のある外部リソースの処理に応じて、適切な作業を実行する必要があります。  
+  
+|解決する必要のある処理|必要な作業タスク|  
+|-----------------|--------------|  
+|<xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドの実行時におけるスタイル シートの検索。|スタイル シートが資格情報を必要とするリソース上にある場合は、<xref:System.Xml.XmlResolver> をパラメーターとして受け取るオーバーロードされた <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドを指定します。|  
+|<xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドの実行時における `<xsl:include>` または `<xsl:import>` の解決。|<xref:System.Xml.XmlResolver> をパラメーターとして受け取るオーバーロードされた <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドを指定します。  <xref:System.Xml.XmlResolver> を使用して、`import` ステートメントまたは `include` ステートメントが参照しているスタイル シートを読み込みます。  `null` を渡すと、外部リソースは解決されません。|  
+|変換中のすべての `document()` 関数の解決。|<xref:System.Xml.XmlResolver> 引数を受け取る <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを使用して、変換中に <xref:System.Xml.XmlResolver> を指定します。|  
+  
+ `document()` 関数は、入力ストリームで提供される XML 初期データの他に、スタイル シートから別の XML リソースを取得します。  この関数には別の場所にある XML データを含めることができるため、`null` 値が設定された <xref:System.Xml.XmlResolver> を <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡すと、`document()` 関数は実行されません。  `document()` 関数を使用する場合は、適切なアクセス許可セットを取得したうえで、<xref:System.Xml.XmlResolver> をパラメーターとして受け取る <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを使用します。  
+  
+ <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドと、このメソッドでの <xref:System.Xml.XmlResolver> の使い方の詳細については、「<xref:System.Xml.Xsl.XslTransform.Load%28System.String%2CSystem.Xml.XmlResolver%29?displayProperty=fullName>」を参照してください。  
+  
+ <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを呼び出すと、読み込み時に指定された証拠に基づいてアクセス許可が計算され、そのアクセス許可セットが変換処理全体に割り当てられます。  `document()` 関数で、アクセス許可セットにないアクセス許可を必要とする処理を実行しようとすると、例外がスローされます。  
+  
+## 参照  
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)   
+ [XslTransform からの出力](../../../../docs/standard/data/xml/outputs-from-an-xsltransform.md)   
+ [異なるストアでの XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-over-different-stores.md)   
+ [スタイル シート パラメーターと拡張オブジェクト用の XsltArgumentList](../../../../docs/standard/data/xml/xsltargumentlist-for-style-sheet-parameters-and-extension-objects.md)   
+ [\<msxsl:script\> を使用した XSLT スタイルシートのスクリプト](../../../../docs/standard/data/xml/xslt-stylesheet-scripting-using-msxsl-script.md)   
+ [msxsl:node\-set\(\) 関数のサポート](../../../../docs/standard/data/xml/support-for-the-msxsl-node-set-function.md)   
+ [変換における XPathNavigator](../../../../docs/standard/data/xml/xpathnavigator-in-transformations.md)   
+ [変換における XPathNodeIterator](../../../../docs/standard/data/xml/xpathnodeiterator-in-transformations.md)   
+ [XslTransform への XPathDocument の入力](../../../../docs/standard/data/xml/xpathdocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDataDocument の入力](../../../../docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDocument の入力](../../../../docs/standard/data/xml/xmldocument-input-to-xsltransform.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/result-tree-fragment-in-transformations.md b/docs/standard/data/xml/result-tree-fragment-in-transformations.md
new file mode 100644
index 00000000000..9a8615dcf43
--- /dev/null
+++ b/docs/standard/data/xml/result-tree-fragment-in-transformations.md
@@ -0,0 +1,207 @@
+---
+title: "変換での結果ツリー フラグメントの処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: df363480-ba02-4233-9ddf-8434e421c4f1
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 変換での結果ツリー フラグメントの処理
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ 結果ツリー フラグメントは、ノード セットの特殊な型にすぎません。  ノード フラグメントでは、ノード セットで実行できる任意の関数を実行できます。  `node-set()` 関数を使用して結果ツリー フラグメントをノード セットに変換し、ノード セットを使用できる任意の場所でそれを使用することもできます。  
+  
+ 結果ツリー フラグメントは、スタイル シートで `<xsl:variable>` 要素または `<xsl:param>` 要素を特定の方法で使用した結果として作成されます。  `variable` 要素と `parameter` 要素の構文は次のとおりです。  
+  
+```  
+<xsl:param name=Qname select= XPath Expression >  
+    template body  
+</xsl:param>  
+  
+<xsl:variable name=Qname select=XPath Expression >  
+    template body  
+</xsl:variable>  
+```  
+  
+ `parameter` 要素では、いくつかの方法で修飾名 \(`Qname`\) に値を割り当てます。  パラメーターに既定値を割り当てるには、`select` 属性の XPath \(XML Path Language\) 式から内容を返すか、テンプレート本体の内容をパラメーターに割り当てます。  
+  
+ `variable` 要素でも、いくつかの方法で値が割り当てられます。  `select` 属性の XPath 式から内容を返すか、テンプレート本体の内容を割り当てることができます。  
+  
+ `parameter` 要素でも `variable` 要素でも、XPath 式で値を割り当てた場合は、4 つの基本 XPath 型であるブール値、文字列、数値、ノード セットのうちのいずれかが返されます。  テンプレート本体で値を指定した場合は、XPath 型でないデータ型である結果ツリー フラグメントが返されます。  
+  
+ 変数が、4 つの基本 XPath データ型のうちの 1 つではなく、結果ツリー フラグメントに関連付けられたときにだけ、XPath クエリからは 4 つの基本 XPath オブジェクト型以外の型が返されます。  結果ツリー フラグメントとその動作については、W3C \(World Wide Web Consortium\) 仕様 \(http:\/\/www.w3.org\/XSLT\) のセクション 11.1「Result Tree Fragments」からセクション 11.6「Passing Parameters to Templates」に記述されています。  セクション 1「Introduction」でも、結果ツリー フラグメントを返したり結果ツリー フラグメントを作成したりする XSLT 名前空間の要素をテンプレートに含める方法について説明しています。  
+  
+ 結果ツリー フラグメントは、概念的には、1 つのルート ノードだけを持つノード セットと同じ動作をします。  ただし、返されるその他のノードは子ノードになります。  プログラムで子ノードを参照するには、`<xsl:copy-of>` 要素を使用して結果ツリー フラグメントを結果ツリーにコピーします。  copy\-of を実行すると、すべての子ノードも結果ツリーに順番にコピーされます。  `copy` または `copy-of` を使用するまで、結果ツリー フラグメントは、結果ツリーの一部や変換の出力の一部にはなりません。  
+  
+ 結果ツリー フラグメントの返されたノードを反復処理するには、<xref:System.Xml.XPath.XPathNavigator> を使用します。  XML を含む `fragment` パラメーターを指定して関数を呼び出すことにより、スタイル シート内で結果ツリー フラグメントを作成するコード サンプルを次に示します。  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+                xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+                xmlns:user="http://www.adventure-works.com"  
+                version="1.0">  
+    <xsl:var name="fragment">  
+        <node1>  
+            <node2/>  
+        </node1>  
+    <xsl:var>  
+  
+  <msxsl:script language="C#" implements-prefix="user">  
+    function NodeFragment(XPathNavigator nav)  
+    {  
+      if (nav.HasSelection == false)  
+        XPathNavigator.MoveToNext();  
+      return;  
+    }  
+  </msxsl:script>  
+  
+    <xsl:template match="/">  
+            <xsl:value-of select="user:NodeFragment(msxml:node-set($fragment))"/>  
+    </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+ 結果ツリー フラグメントの一種である RTF \(Rich Text Format\) 形式の変数がノード セットに変換されない例を次に示します。  この場合、変数はスクリプト関数に渡され、ノード間の移動には <xref:System.Xml.XPath.XPathNavigator> が使用されます。  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+        xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+        xmlns:user="urn:books"  
+        exclude-result-prefixes="msxsl">  
+  
+<xsl:output method="xml" indent="yes" omit-xml-declaration="yes"/>  
+  
+<xsl:variable name="node-fragment">  
+    <book>Book1</book>  
+    <book>Book2</book>  
+    <book>Book3</book>  
+    <book>Book4</book>  
+</xsl:variable>  
+  
+<msxsl:script implements-prefix="user" language="c#">  
+  
+<![CDATA[  
+    string func(XPathNavigator nav)  
+    {  
+        bool b = nav.MoveToFirstChild();  
+        if (b)  
+            return nav.Value;  
+        else  
+            return "Does not exist";  
+    }  
+  
+]]>  
+  
+</msxsl:script>  
+  
+<xsl:template match="/">  
+    <first_book>  
+        <xsl:value-of select="user:func($node-fragment)"/>  
+    </first_book>  
+</xsl:template>  
+  
+</xsl:stylesheet>  
+```  
+  
+ このスタイル シートを使用して XML を変換した結果を次に示します。  
+  
+## 出力  
+  
+```  
+<first_book xmlns:user="urn:books">Book1</first_book>  
+```  
+  
+ 上で説明したように、`node-set` 関数を使用すると、結果ツリー フラグメントをノード セットに変換できます。  結果として得られるノードには、ツリーのルート ノードである単一のノードが常に含まれます。  結果ツリー フラグメントから変換したノード セットは、for\-each ステートメントや `select` 属性の値など、標準ノード セットを使用できる任意の場所で使用できます。  フラグメントをノード セットに変換し、ノード セットとして使用するコードを次に示します。  
+  
+ `<xsl:for-each select="msxsl:node-set($node-fragment)">`  
+  
+ `<xsl:value-of select="user:func(msxsl:node-set($node-fragment))"/>`  
+  
+ フラグメントをノード セットに変換した後は、ノード間の移動に <xref:System.Xml.XPath.XPathNavigator> を使用しません。  ノード セットでは、<xref:System.Xml.XPath.XPathNodeIterator> を使用します。  
+  
+ `$var` という変数がスタイル シート内のノード ツリーである例を次に示します。  for\-each ステートメントを `node-set` 関数と組み合わせて使用すると、このツリーをノード セットとして反復処理できます。  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+                xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+                xmlns:user="http://www.adventure-works.com"  
+                version="1.0">  
+    <xsl:variable name="states">  
+        <node1>AL</node1>  
+        <node1>CA</node1>  
+        <node1>CO</node1>  
+        <node1>WA</node1>  
+    </xsl:variable>  
+  
+    <xsl:template match="/">  
+            <xsl:for-each select="msxsl:node-set($states)"/>   
+    </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+ 次の例も、結果ツリー フラグメントの一種である RTF 形式の変数ですが、この場合は、変数をノード セットに変換した後、XPathNodeIterator としてスクリプト関数に渡しています。  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+        xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+        xmlns:user="urn:books"  
+        exclude-result-prefixes="msxsl">  
+  
+<xsl:output method="xml" indent="yes" omit-xml-declaration="yes"/>  
+  
+<xsl:variable name="node-fragment">  
+    <book>Book1</book>  
+    <book>Book2</book>  
+    <book>Book3</book>  
+    <book>Book4</book>  
+</xsl:variable>  
+  
+<msxsl:script implements-prefix="user" language="c#">  
+  
+<![CDATA[  
+    string func(XPathNodeIterator it)  
+    {  
+        it.MoveNext();   
+        return it.Current.Value;   
+        //it.Current returns XPathNavigator positioned on the current node  
+    }  
+  
+]]>  
+  
+</msxsl:script>  
+<xsl:template match="/">  
+    <books>  
+        <xsl:value-of select="user:func(msxsl:node-set($node-fragment))"/>  
+    </books>  
+</xsl:template>  
+  
+</xsl:stylesheet>  
+```  
+  
+ このスタイル シートを使用して XML を変換した結果を次に示します。  
+  
+```  
+<books xmlns:user="urn:books">Book1Book2Book3Book4</books>  
+```  
+  
+## 参照  
+ <xref:System.Xml.XPath.XPathNodeIterator>   
+ <xref:System.Xml.XPath.XPathNodeIterator>   
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md b/docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md
new file mode 100644
index 00000000000..4b697063bc7
--- /dev/null
+++ b/docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md
@@ -0,0 +1,163 @@
+---
+title: "スキーマのノード型および構造を推論するときの規則 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d74ce896-717d-4871-8fd9-b070e2f53cb0
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# スキーマのノード型および構造を推論するときの規則
+このトピックでは、スキーマ推論プロセスで、XML ドキュメント内のノード型を XML スキーマ定義言語 \(XSD\) 構造に変換する方法を説明します。  
+  
+## 要素を推論するときの規則  
+ このセクションでは、要素宣言を推論するときの規則を説明します。  推論される要素宣言には 8 つの構造があります。  
+  
+1.  単純型の要素  
+  
+2.  空要素  
+  
+3.  属性を持つ空要素  
+  
+4.  属性と単純内容を持つ要素  
+  
+5.  子要素のシーケンスを持つ要素  
+  
+6.  子要素のシーケンスと属性を持つ要素  
+  
+7.  子要素のシーケンスと choice を持つ要素  
+  
+8.  子要素のシーケンスと choice を持つ要素  
+  
+> [!NOTE]
+>  すべての `complexType` 宣言は匿名型として推論されます。  推論されるグローバル要素はルート要素だけであり、その他すべての要素はローカル要素です。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+### 単純型要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、単純型要素から推論されるスキーマです。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root>text</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root" type="xs:string" />`<br /><br /> `\</xs:schema>`|  
+  
+### 空の要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、空要素から推論されるスキーマです。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<empty/>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="empty" />`<br /><br /> `\</xs:schema>`|  
+  
+### 属性を持つ空要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、属性を持つ空要素から推論されるスキーマです。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<empty attribute1="text"/>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="empty">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:attribute name="attribute1" type="xs:string" use="required" />`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 属性と単純内容を持つ要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、属性と単純内容を持つ要素から推論されるスキーマです。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root attribute1="text">value</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:simpleContent>`<br /><br /> `\<xs:extension base="xs:string">`<br /><br /> `\<xs:attribute name="attribute1" type="xs:string" use="required" />`<br /><br /> `\</xs:extension>`<br /><br /> `\</xs:simpleContent>`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 子要素のシーケンスを持つ要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、子要素のシーケンスを持つ要素から推論されるスキーマです。  
+  
+> [!NOTE]
+>  要素が子要素を 1 つしか持っていない場合でも、子要素はシーケンスとして扱われます。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root>`<br /><br /> `<subElement/>`<br /><br /> `</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:sequence>`<br /><br /> `\<xs:element name="subElement" />`<br /><br /> `\</xs:sequence>`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 子要素のシーケンスと属性を持つ要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、子要素のシーケンスと属性を持つ要素から推論されるスキーマです。  
+  
+> [!NOTE]
+>  要素が子要素を 1 つしか持っていない場合でも、子要素はシーケンスとして扱われます。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root attribute1="text">`<br /><br /> `<subElement1/>`<br /><br /> `<subElement2/>`<br /><br /> `</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:sequence>`<br /><br /> `\<xs:element name="subElement1" />`<br /><br /> `\<xs:element name="subElement2" />`<br /><br /> `\</xs:sequence>`<br /><br /> `\<xs:attribute name="attribute1" type="xs:string" use="required" />`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 子要素のシーケンスと choice を持つ要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっているスキーマは、子要素のシーケンスと choice を持つ要素から推論されるスキーマです。  
+  
+> [!NOTE]
+>  `xs:choice` 要素の `maxOccurs` 属性は、推論されるスキーマでは `"unbounded"` に設定されます。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root>`<br /><br /> `<subElement1/>`<br /><br /> `<subElement2/>`<br /><br /> `<subElement1/>`<br /><br /> `</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:sequence>`<br /><br /> `\<xs:choice maxOccurs="unbounded">`<br /><br /> `\<xs:element name="subElement1" />`<br /><br /> `\<xs:element name="subElement2" />`<br /><br /> `\</xs:choice>`<br /><br /> `\</xs:sequence>`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 子要素のシーケンスと choice および属性を持つ要素  
+ <xref:System.Xml.Schema.XmlSchemaInference.InferSchema%2A> メソッドへの XML 入力と、生成される XML スキーマを次の表に示します。  太字になっている要素は、子要素のシーケンスと choice および属性を持つ要素から推論されるスキーマです。  
+  
+> [!NOTE]
+>  `xs:choice` 要素の `maxOccurs` 属性は、推論されるスキーマでは `"unbounded"` に設定されます。  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+|XML|Schema|  
+|---------|------------|  
+|`<?xml version="1.0"?>`<br /><br /> `<root attribute1="text">`<br /><br /> `<subElement1/>`<br /><br /> `<subElement2/>`<br /><br /> `<subElement1/>`<br /><br /> `</root>`|`<?xml version="1.0" encoding="utf-8"?>`<br /><br /> `<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xml`<br /><br /> `ns:xs="http://www.w3.org/2001/XMLSchema">`<br /><br /> ``   `\<xs:element name="root">`<br /><br /> `\<xs:complexType>`<br /><br /> `\<xs:sequence>`<br /><br /> `\<xs:choice maxOccurs="unbounded">`<br /><br /> `\<xs:element name="subElement1" />`<br /><br /> `\<xs:element name="subElement2" />`<br /><br /> `\</xs:choice>`<br /><br /> `\</xs:sequence>`<br /><br /> `\<xs:attribute name="attribute1" type="xs:string" use="required" />`<br /><br /> `\</xs:complexType>`<br /><br /> `\</xs:element>`<br /><br /> `\</xs:schema>`|  
+  
+### 属性の処理  
+ ノード内で新しい属性が検出されるたびに、その属性は推論されるノードの定義に `use="required"` として追加されます。  そのインスタンスで同じノードが再び検出されると、推論プロセスでは、現在のインスタンスの属性と、既に推論されている属性を比較します。  既に推論されている属性の一部がインスタンスにない場合は、属性の定義に `use="optional"` が追加されます。  新しい属性は、既存の宣言に `use="optional"` として追加されます。  
+  
+### 出現回数に関する制約  
+ スキーマ推論プロセスでは、推論されるスキーマのコンポーネントに対して、値が `"0"` または `"1"` の `minOccurs` 属性と、値が `"1"` または `"unbounded"` の `maxOccurs` 属性が生成されます。   値 `"1"` および `"unbounded"` は、値 `"0"` および `"1"` では XML ドキュメントを検証できない場合にのみ使われます \(たとえば、`MinOccurs="0"` では要素を正確に記述できない場合は、`minOccurs="1"` が使われます\)。  
+  
+### 混合コンテンツ  
+ テキストに要素が混じっているなど、要素に混合コンテンツが含まれている場合は、推論される複合型の定義に対して `mixed="true"` 属性が生成されます。  
+  
+## その他のノードの型推論規則  
+ 処理命令、コメント、エンティティ参照、CDATA、ドキュメント型、名前空間の各ノード型に関する推論の規則を次の表に示します。  
+  
+|ノード型|変換|  
+|----------|--------|  
+|処理命令|無視されます。|  
+|コメント|無視されます。|  
+|エンティティ参照|<xref:System.Xml.Schema.XmlSchemaInference> クラスではエンティティ参照を処理しません。  XML ドキュメントにエンティティ参照が含まれている場合は、エンティティを展開するリーダーを使用する必要があります。  たとえば、<xref:System.Xml.XmlTextReader.EntityHandling%2A> プロパティを <xref:System.Xml.EntityHandling> に設定した <xref:System.Xml.XmlTextReader> をパラメーターとして渡すことができます。  エンティティ参照が検出されたにもかかわらず、リーダーがエンティティを展開しない場合は、例外がスローされます。|  
+|CDATA|XML ドキュメント内のすべての `<![CDATA[   ]]` セクションが `xs:string` として推論されます。|  
+|ドキュメント型|無視されます。|  
+|名前空間|無視されます。|  
+  
+ スキーマ推論プロセスの詳細については、「[XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.Schema.XmlSchemaInference>   
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)   
+ [XML スキーマの推論](../../../../docs/standard/data/xml/inferring-an-xml-schema.md)   
+ [XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)   
+ [単純型を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-simple-types.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/rules-for-inferring-simple-types.md b/docs/standard/data/xml/rules-for-inferring-simple-types.md
new file mode 100644
index 00000000000..0f8df93d8d8
--- /dev/null
+++ b/docs/standard/data/xml/rules-for-inferring-simple-types.md
@@ -0,0 +1,90 @@
+---
+title: "単純型を推論するときの規則 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 394624d6-4da0-430a-8a88-46efe40f14de
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 単純型を推論するときの規則
+Describes how the <xref:System.Xml.Schema.XmlSchemaInference> class infers the data type for attributes and elements.  
+  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスは、属性と要素のデータ型を単純型として推論します。  このセクションでは、推論される可能性がある型、複数の異なる値を 1 つの型に調整する方法、スキーマ定義 `xsi` 属性の取り扱いについて説明します。  
+  
+## 推論型  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスは、要素値と属性値を単純型として推論し、生成されるスキーマに型属性をインクルードします。  推論型はすべて単純型です。  生成されるスキーマの一部として基本型またはファセットがインクルードされることはありません。  
+  
+ XML ドキュメントで値が検出されるたびに、その値が個別に調べられます。  値が調べられるときに、その値の型が推論されます。  属性または要素の型が既に推論されており、その属性または要素に対して新たに検出された値が現在推論されている型と一致しない場合、<xref:System.Xml.Schema.XmlSchemaInference> クラスは、一定の規則に基づいてその型を昇格させます。  型を昇格させるときの規則については、このトピックの「型の昇格」のセクションで説明します。  
+  
+ 生成されるスキーマに含まれる可能性がある推論型を次の表に示します。  
+  
+|単純型|説明|  
+|---------|--------|  
+|boolean|true、false、0、1|  
+|byte|\-128 ～ 127 の整数|  
+|unsignedByte|0 ～ 255 の整数|  
+|short|\-32768 ～ 32767 の整数|  
+|unsignedShort|0 ～ 65535 の整数|  
+|int|\-2147483648 ～ 2147483647 の整数|  
+|unsignedInt|0 ～ 4294967295 の整数|  
+|long|\-9223372036854775808 ～ 9223372036854775807 の整数|  
+|unsignedLong|0 ～ 18446744073709551615 の整数|  
+|整数|先頭に "\-" 記号が付く可能性がある有限桁の数値。|  
+|decimal|精度が 0 ～ 28 桁の数値。|  
+|float|小数点数。指数を表す整数値を伴った、省略可能な "E" または "e" を付ける表記法もあります。  仮数部の範囲は \-16777216 ～ 16777216 です。  指数部の範囲は \-149 ～ 104 です。<br /><br /> float では、無限大および非数を表す特殊値が使用可能です。  float の特殊値は、0、\-0、INF、\-INF、NaN です。|  
+|double|仮数部の範囲が \-9007199254740992 ～ 9007199254740992 で、指数部の範囲が \-1075 ～ 970 である点を除いて、float と同じです。<br /><br /> double では、無限大および非数を表す特殊値が使えます。  float の特殊値は、0、\-0、INF、\-INF、NaN です。|  
+|duration|W3C の持続時間形式|  
+|dateTime|W3C の日付時刻形式|  
+|時間|W3C の時刻形式|  
+|date|年に使用できる値は 0001 ～ 9999 に制限されています。|  
+|gYearMonth|W3C のグレゴリオ暦の年月形式|  
+|string|1 つ以上の Unicode 文字|  
+  
+## 型の上位変換  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスは属性値と要素値を 1 つずつ調べます。  値が検出されると、最も制限の厳しい、符号なし型が推論されます。  属性または要素の型が推論されている状態で、現在推論されている型と一致しない新しい値が検出されると、推論型が現在の推論型と新しい値の両方に当てはまる新しい型に昇格します。  <xref:System.Xml.Schema.XmlSchemaInference> クラスは、推論型を昇格させるときに前の値を考慮します。  
+  
+ たとえば、2 つの XML ドキュメントから取得された次の XML フラグメントを見てみましょう。  
+  
+ `<MyElement1 attr1="12" />`  
+  
+ `<MyElement1 attr1="52344" />`  
+  
+ 最初に `attr1` の値が検出されると、`attr1` の型は、値 `unsignedByte` に基づいて `12` と推論されます。  `attr1` の 2 番目の値が検出されると、現在推論されている型 `unsignedShort` と現在の値 `unsignedByte` に基づいて、型が `52344` に昇格します。  
+  
+ 次に、2 つの XML ドキュメントから取得された次の XML を見てみましょう。  
+  
+ `<MyElement2 attr2="0" />`  
+  
+ `<MyElement2 attr2="true" />`  
+  
+ 最初に `attr2` の値が検出されると、`attr2` の型は、値 `unsignedByte` に基づいて `0` と推論されます。  `attr2` の 2 番目の値が検出されると、現在推論されている型 `string` と現在の値 `unsignedByte` に基づいて、型が `true` に昇格します。これは、<xref:System.Xml.Schema.XmlSchemaInference> クラスが推論型を昇格させるときに前の値を考慮するためです。  ただし、`attr2` の 2 つのインスタンスが、上記の説明のように 2 つの別々の XML ドキュメントで検出されたのではなく、同じ XML ドキュメントで検出された場合、`attr2` は `boolean` と推論されます。  
+  
+### 無視される http:\/\/www.w3.org\/2001\/XMLSchema\-instance 名前空間の属性  
+ スキーマの推論で無視されるスキーマ定義属性を次に示します。  
+  
+|属性|説明|  
+|--------|--------|  
+|`xsi:type`|`xsi:type` が指定されている要素が検出された場合、`xsi:type` は無視されます。|  
+|`xsi:nil`|`xsi:nil` 属性を持った要素が検出されると、推論されるスキーマ内の要素宣言の値が `nillable="true"` に設定されます。  `xsi:nil` 属性が `true` に設定された要素は子要素を持つことができません。|  
+|`xsi:schemaLocation`|`xsi:schemaLocation` は検出されても無視されます。|  
+|`xsi:noNamespaceSchemaLocation`|`xsi:noNamespaceSchemaLocation` は検出されても無視されます。|  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)   
+ [XML ドキュメントからのスキーマの推論](../../../../docs/standard/data/xml/inferring-schemas-from-xml-documents.md)   
+ [スキーマのノード型および構造を推論するときの規則](../../../../docs/standard/data/xml/rules-for-inferring-schema-node-types-and-structure.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/saving-and-writing-a-document.md b/docs/standard/data/xml/saving-and-writing-a-document.md
new file mode 100644
index 00000000000..f8590711989
--- /dev/null
+++ b/docs/standard/data/xml/saving-and-writing-a-document.md
@@ -0,0 +1,100 @@
+---
+title: "ドキュメントの保存と書き込み | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 097b0cb1-5743-4c3a-86ef-caf5cbe6750d
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# ドキュメントの保存と書き込み
+<xref:System.Xml.XmlDocument> を読み込んで保存した場合、保存されたドキュメントは、元のドキュメントとは次のように異なる可能性があります。  
+  
+-   <xref:System.Xml.XmlDocument.Save%2A> メソッドを呼び出す前に <xref:System.Xml.XmlDocument.PreserveWhitespace%2A> プロパティが `true` に設定されている場合は、ドキュメント内の空白が出力でも保持されますが、`false` に設定されている場合は、<xref:System.Xml.XmlDocument> が出力を自動的にインデントします。  
+  
+-   属性間のすべての空白は 1 つの空白文字になります。  
+  
+-   要素間の空白が変更されます。  有意の空白は保持され、意味のない空白は保持されません。  しかし、ドキュメントの保存時には、出力が読みやすくなるように、既定で <xref:System.Xml.XmlTextWriter> のインデント モードが使用されます。  
+  
+-   属性値を囲む引用符は、既定で二重引用符に変更されます。  <xref:System.Xml.XmlTextWriter> の <xref:System.Xml.XmlTextReader.QuoteChar%2A> プロパティを使用すると、引用符を二重引用符または一重引用符のいずれかに設定できます。  
+  
+-   既定では、`{` のような数値エンティティは展開されます。  
+  
+-   入力ドキュメントのバイト順マークは保持されません。  別のエンコーディングを指定する XML 宣言を明示的に作成しない限り、UCS\-2 は UTF\-8 として保存されます。  
+  
+-   <xref:System.Xml.XmlDocument> をファイルまたはストリームに書き出す場合、書き出される出力はドキュメントのコンテンツと同じになります。  つまり、<xref:System.Xml.XmlDeclaration> が書き出されるのは、ドキュメントに <xref:System.Xml.XmlDeclaration> が 1 つ含まれていて、ドキュメントの出力時に使われるエンコーディングが宣言ノードで指定されたエンコーディングと同じ場合だけです。  
+  
+## XmlDeclaration の書き込み  
+ <xref:System.Xml.XmlDocument.Save%2A> および <xref:System.Xml.XmlDocument.WriteContentTo%2A> の <xref:System.Xml.XmlDocument> メソッドに加えて、<xref:System.Xml.XmlNode.OuterXml%2A>、<xref:System.Xml.XmlNode.InnerXml%2A>、および <xref:System.Xml.XmlNode.WriteTo%2A> の <xref:System.Xml.XmlDocument> および <xref:System.Xml.XmlDeclaration> メンバーは XML 宣言を作成します。  
+  
+ <xref:System.Xml.XmlNode.OuterXml%2A>、<xref:System.Xml.XmlDocument.InnerXml%2A> の <xref:System.Xml.XmlDocument> プロパティ、<xref:System.Xml.XmlDocument.Save%2A>、<xref:System.Xml.XmlDocument.WriteTo%2A> メソッド、および <xref:System.Xml.XmlDocument.WriteContentTo%2A> メソッドについて、XML 宣言に書き出されるエンコーディングは <xref:System.Xml.XmlDeclaration> ノードから取り出されます。  <xref:System.Xml.XmlDeclaration> ノードが存在しない場合、<xref:System.Xml.XmlDeclaration> は書き出されません。  <xref:System.Xml.XmlDeclaration> ノードにエンコーディングが含まれていない場合、エンコーディングは XML 宣言に書き出されません。  
+  
+ <xref:System.Xml.XmlDocument.Save%2A?displayProperty=fullName> および <xref:System.Xml.XmlDocument.Save%2A?displayProperty=fullName> メソッドは、常に <xref:System.Xml.XmlDeclaration> を書き出します。  これらのメソッドは、書き込みを行っているライターからエンコーディングを取得します。  つまり、ライターのエンコーディングの値によって、ドキュメントと <xref:System.Xml.XmlDeclaration> オブジェクトのエンコーディングがオーバーライドされます。  たとえば、次のコードでは、出力ファイル `out.xml` の XML 宣言にはエンコーディングは書き込まれません。  
+  
+```vb  
+Dim doc As New XmlDocument()  
+Dim tw As XmlTextWriter = New XmlTextWriter("out.xml", Nothing)  
+doc.Load("text.xml")  
+doc.Save(tw)  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+XmlTextWriter tw = new XmlTextWriter("out.xml", null);  
+doc.Load("text.xml");  
+doc.Save(tw);  
+```  
+  
+ <xref:System.Xml.XmlDocument.Save%2A> メソッドでは、<xref:System.Xml.XmlWriter> クラスの <xref:System.Xml.XmlWriter.WriteStartDocument%2A> メソッドを使用して XML 宣言が書き出されます。  そのため、<xref:System.Xml.XmlWriter.WriteStartDocument%2A> メソッドをオーバーライドすると、ドキュメントの先頭部分の出力方法が変わります。  
+  
+ <xref:System.Xml.XmlNode.OuterXml%2A>、<xref:System.Xml.XmlDeclaration.WriteTo%2A>、および <xref:System.Xml.XmlNode.InnerXml%2A> の <xref:System.Xml.XmlDeclaration> メンバーについて、<xref:System.Xml.XmlDeclaration.Encoding%2A> プロパティが設定されていないと、エンコーディングは書き出されません。  それ以外の場合は、<xref:System.Xml.XmlDeclaration.Encoding%2A> プロパティのエンコーディングと同じエンコーディングが XML 宣言に書き出されます。  
+  
+## OuterXml プロパティを使用したドキュメント内容の書き込み  
+ <xref:System.Xml.XmlNode.OuterXml%2A> プロパティは、W3C XML ドキュメント オブジェクト モデル \(DOM\) 標準に対するマイクロソフトの拡張機能です。  <xref:System.Xml.XmlNode.OuterXml%2A> プロパティは、XML ドキュメント全体のマークアップ、または 1 つのノードとその子ノードのマークアップだけを取得するために使用されます。  <xref:System.Xml.XmlNode.OuterXml%2A> は、指定されたノードとそのすべての子ノードを表すマークアップを返します。  
+  
+ ドキュメント全体を文字列として保存するコード サンプルを次に示します。  
+  
+```vb  
+Dim mydoc As New XmlDocument()  
+' Perform application needs here, like mydoc.Load("myfile");  
+' Now save the entire document to a string variable called "xml".  
+Dim xml As String = mydoc.OuterXml  
+```  
+  
+```csharp  
+XmlDocument mydoc = new XmlDocument();  
+// Perform application needs here, like mydoc.Load("myfile");  
+// Now save the entire document to a string variable called "xml".  
+string xml = mydoc.OuterXml;  
+```  
+  
+ ドキュメント要素だけを保存するコード サンプルを次に示します。  
+  
+```vb  
+' For the content of the Document Element only.  
+Dim xml As String = mydoc.DocumentElement.OuterXml  
+```  
+  
+```csharp  
+// For the content of the Document Element only.  
+string xml = mydoc.DocumentElement.OuterXml;  
+```  
+  
+ 一方、子ノードの内容が必要な場合は、<xref:System.Xml.XmlNode.InnerText%2A> プロパティを使用します。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/schema-validation-using-xpathnavigator.md b/docs/standard/data/xml/schema-validation-using-xpathnavigator.md
new file mode 100644
index 00000000000..e7c313ea5c3
--- /dev/null
+++ b/docs/standard/data/xml/schema-validation-using-xpathnavigator.md
@@ -0,0 +1,376 @@
+---
+title: "XPathNavigator を使用したスキーマ検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 81fa0e41-d9c9-46f0-b22b-50da839c77f5
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XPathNavigator を使用したスキーマ検証
+<xref:System.Xml.XmlDocument> クラスを使用して、<xref:System.Xml.XmlDocument> オブジェクトに含まれる XML コンテンツを 2 つの方法で検証することができます。  最初の方法は、検証型 <xref:System.Xml.XmlReader> オブジェクトを使用して XML コンテンツを検証する方法で、2 番目の方法は、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用する方法です。  <xref:System.Xml.XPath.XPathDocument> クラスを使用して XML コンテンツの読み取り専用の検証を行うこともできます。  
+  
+## XML データの検証  
+ <xref:System.Xml.XmlDocument> クラスは、既定では DTD または XML スキーマ定義言語 \(XSD\) のスキーマ検証を使用した XML ドキュメントの検証は行いません。  XML ドキュメントが整形式であることを確認するだけです。  
+  
+ XML ドキュメントを検証する最初の方法は、検証型の <xref:System.Xml.XmlReader> オブジェクトを使用して、ドキュメントが <xref:System.Xml.XmlDocument> オブジェクトに読み込まれる際に検証する方法です。  2 番目の方法は、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して、以前に型指定されていない XML ドキュメントを検証する方法です。  いずれの場合も、検証済みの XML ドキュメントに対して行った変更は、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して再度検証することができます。  
+  
+### 読み込み時のドキュメントの検証  
+ 検証型 <xref:System.Xml.XmlReader> オブジェクトは、<xref:System.Xml.XmlReaderSettings> オブジェクトをパラメーターとして受け取る <xref:System.Xml.XmlReader> クラスの <xref:System.Xml.XmlReader.Create%2A> メソッドに <xref:System.Xml.XmlReaderSettings> オブジェクトを渡すことで作成できます。  パラメーターとして渡された <xref:System.Xml.XmlReaderSettings> オブジェクトには、[Schema](assetId:///Schema?qualifyHint=False&amp;autoUpgrade=True) が設定された `P:System.Xml.XmlReaderSettings.ValidationType` プロパティがあり、<xref:System.Xml.XmlDocument> オブジェクトに含まれる XML ドキュメントの XML スキーマが <xref:System.Xml.XmlReaderSettings.Schemas%2A> プロパティに追加されています。  検証型 <xref:System.Xml.XmlReader> オブジェクトは、次に <xref:System.Xml.XmlDocument> オブジェクトを作成するために使用されます。  
+  
+ 次の例では、検証型 <xref:System.Xml.XmlReader> オブジェクトを使用して、<xref:System.Xml.XmlDocument> オブジェクトを作成することにより、`contosoBooks.xml` ファイルを <xref:System.Xml.XmlDocument> オブジェクトに読み込む際に検証を行います。  この XML ドキュメントはそのスキーマに照らして有効なので、スキーマの検証エラーや警告は何も生成されません。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+Imports System.Xml.Schema  
+Imports System.Xml.XPath  
+  
+Class ValidatingReaderExample  
+  
+    Shared Sub Main(ByVal args() As String)  
+  
+        Try  
+            Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+            settings.ValidationType = ValidationType.Schema  
+  
+            Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
+  
+            Dim document As XmlDocument = New XmlDocument()  
+            document.Load(reader)  
+            Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+        Catch e As Exception  
+            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message)  
+        End Try  
+  
+    End Sub  
+  
+    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
+  
+        Select Case e.Severity  
+            Case XmlSeverityType.Error  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
+                Exit Sub  
+            Case XmlSeverityType.Warning  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
+                Exit Sub  
+        End Select  
+  
+    End Sub  
+  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+using System.Xml.Schema;  
+using System.Xml.XPath;  
+  
+class ValidatingReaderExample  
+{  
+    static void Main(string[] args)  
+    {  
+        try  
+        {  
+            XmlReaderSettings settings = new XmlReaderSettings();  
+            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+            settings.ValidationType = ValidationType.Schema;  
+  
+            XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
+  
+            XmlDocument document = new XmlDocument();  
+            document.Load(reader);  
+            XPathNavigator navigator = document.CreateNavigator();  
+        }  
+        catch (Exception e)  
+        {  
+            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message);  
+        }  
+    }  
+  
+    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
+    {  
+        switch (e.Severity)  
+        {  
+            case XmlSeverityType.Error:  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
+                break;  
+            case XmlSeverityType.Warning:  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
+                break;  
+        }  
+    }  
+}  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+ 上記の例では、<xref:System.Xml.XmlDocument.Load%2A> を呼び出したときに属性や要素の型が検証スキーマで指定されている型と一致しなかった場合、<xref:System.Xml.Schema.XmlSchemaValidationException> がスローされます。  検証を行う <xref:System.Xml.XmlReader> に <xref:System.Xml.XmlReaderSettings.ValidationEventHandler> が設定されている場合、無効な型が検出されるたびに <xref:System.Xml.XmlReaderSettings.ValidationEventHandler> が呼び出されます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.TypedValue%2A> が `invalid` に設定されている属性または要素が <xref:System.Xml.XPath.XPathNavigator> によりアクセスされると、<xref:System.Xml.Schema.XmlSchemaException> がスローされます。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> を使用して属性または要素にアクセスするとき、<xref:System.Xml.Schema.XmlSchemaInfo.Validity%2A> プロパティを使用して、個々の属性または要素が有効かどうかを判断できます。  
+  
+> [!NOTE]
+>  XML ドキュメントが既定値を定義した関連付けられたスキーマと共に <xref:System.Xml.XmlDocument> オブジェクトに読み込まれる場合、<xref:System.Xml.XmlDocument> オブジェクトは、これらの既定値があたかも XML ドキュメント内にあるかのように扱います。  これは、XML ドキュメントで空要素として書かれていても、スキーマから既定値を得た要素に対して <xref:System.Xml.XPath.XPathNavigator.IsEmptyElement%2A> プロパティは常に `false` を返すことを意味します。  
+  
+### Validate メソッドを使用したドキュメントの検証  
+ <xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドは、<xref:System.Xml.XmlDocument> オブジェクトの <xref:System.Xml.XmlDocument.Schemas%2A> プロパティで指定されたスキーマに対して、<xref:System.Xml.XmlDocument> オブジェクトに含まれる XML ドキュメントを検証し、情報セットの拡大を実施します。  結果として、<xref:System.Xml.XmlDocument> オブジェクト中の以前は型指定されていない XML ドキュメントは型指定されたドキュメントに置き換わります。  
+  
+ <xref:System.Xml.XmlDocument> オブジェクトは、<xref:System.Xml.XmlDocument.Validate%2A> メソッドへのパラメーターとして渡された <xref:System.Xml.Schema.ValidationEventHandler> デリゲートを使用してスキーマ検証のエラーと警告を報告します。  
+  
+ 次の例では、<xref:System.Xml.XmlDocument> オブジェクトの <xref:System.Xml.XmlDocument.Schemas%2A> プロパティに含まれる `contosoBooks.xsd` スキーマに対して、<xref:System.Xml.XmlDocument> オブジェクトに含まれる `contosoBooks.xml` ファイルを検証します。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+Imports System.Xml.Schema  
+Imports System.Xml.XPath  
+  
+Class ValidateExample  
+  
+    Shared Sub Main(ByVal args() As String)  
+  
+        Dim document As XmlDocument = New XmlDocument()  
+        document.Load("contosoBooks.xml")  
+        Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+        document.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+        Dim validation As ValidationEventHandler = New ValidationEventHandler(AddressOf SchemaValidationHandler)  
+  
+        document.Validate(validation)  
+  
+    End Sub  
+  
+    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
+  
+        Select Case e.Severity  
+            Case XmlSeverityType.Error  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
+                Exit Sub  
+            Case XmlSeverityType.Warning  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
+                Exit Sub  
+        End Select  
+  
+    End Sub  
+  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+using System.Xml.Schema;  
+using System.Xml.XPath;  
+  
+class ValidateExample  
+{  
+    static void Main(string[] args)  
+    {  
+        XmlDocument document = new XmlDocument();  
+        document.Load("contosoBooks.xml");  
+        XPathNavigator navigator = document.CreateNavigator();  
+  
+        document.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+        ValidationEventHandler validation = new ValidationEventHandler(SchemaValidationHandler);  
+  
+        document.Validate(validation);  
+    }  
+  
+    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
+    {  
+        switch (e.Severity)  
+        {  
+            case XmlSeverityType.Error:  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
+                break;  
+            case XmlSeverityType.Warning:  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
+                break;  
+        }  
+    }  
+}  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+### 変更点の検証  
+ XML ドキュメントに変更が施された後、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して、変更点を XML ドキュメントのスキーマに対して検証できます。  
+  
+ 次の例では、検証型 <xref:System.Xml.XmlReader> オブジェクトを使用して、<xref:System.Xml.XmlDocument> オブジェクトを作成することにより、`contosoBooks.xml` ファイルを <xref:System.Xml.XmlDocument> オブジェクトに読み込む際に検証を行います。  XML ドキュメントは、スキーマ検証のエラーや警告を生成せずに、読み込み時に問題なく検証されます。  次に、この例で `contosoBooks.xsd` スキーマに従うと無効な 2 つの変更が XML ドキュメントに施されます。  最初の変更点は、無効な子要素を挿入してスキーマ検証エラーを引き起こします。2 番目の変更点は、型指定されたノードにノードの型に反して無効な値を設定し、例外が発生します。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+Imports System.Xml.Schema  
+Imports System.Xml.XPath  
+  
+Class ValidatingReaderExample  
+  
+    Shared Sub Main(ByVal args() As String)  
+  
+        Try  
+            Dim settings As XmlReaderSettings = New XmlReaderSettings()  
+            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
+            settings.ValidationType = ValidationType.Schema  
+  
+            Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
+  
+            Dim document As XmlDocument = New XmlDocument()  
+            document.Load(reader)  
+            Dim navigator As XPathNavigator = document.CreateNavigator()  
+  
+            Dim validation As ValidationEventHandler = New ValidationEventHandler(AddressOf SchemaValidationHandler)  
+  
+            navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
+            navigator.MoveToChild("book", "http://www.contoso.com/books")  
+            navigator.MoveToChild("author", "http://www.contoso.com/books")  
+  
+            navigator.AppendChild("<title>Book Title</title>")  
+  
+            document.Validate(validation)  
+  
+            navigator.MoveToParent()  
+            navigator.MoveToChild("price", "http://www.contoso.com/books")  
+            navigator.SetTypedValue(DateTime.Now)  
+        Catch e As Exception  
+            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message)  
+        End Try  
+  
+    End Sub  
+  
+    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
+  
+        Select Case e.Severity  
+            Case XmlSeverityType.Error  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
+                Exit Sub  
+            Case XmlSeverityType.Warning  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
+                Exit Sub  
+        End Select  
+  
+    End Sub  
+  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+using System.Xml.Schema;  
+using System.Xml.XPath;  
+  
+class ValidatingReaderExample  
+{  
+    static void Main(string[] args)  
+    {  
+        try  
+        {  
+            XmlReaderSettings settings = new XmlReaderSettings();  
+            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
+            settings.ValidationType = ValidationType.Schema;  
+  
+            XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
+  
+            XmlDocument document = new XmlDocument();  
+            document.Load(reader);  
+            XPathNavigator navigator = document.CreateNavigator();  
+  
+            ValidationEventHandler validation = new ValidationEventHandler(SchemaValidationHandler);  
+  
+            navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
+            navigator.MoveToChild("book", "http://www.contoso.com/books");  
+            navigator.MoveToChild("author", "http://www.contoso.com/books");  
+  
+            navigator.AppendChild("<title>Book Title</title>");  
+  
+            document.Validate(validation);  
+  
+            navigator.MoveToParent();  
+            navigator.MoveToChild("price", "http://www.contoso.com/books");  
+            navigator.SetTypedValue(DateTime.Now);  
+        }  
+        catch (Exception e)  
+        {  
+            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message);  
+        }  
+    }  
+  
+    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
+    {  
+        switch (e.Severity)  
+        {  
+            case XmlSeverityType.Error:  
+                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
+                break;  
+            case XmlSeverityType.Warning:  
+                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
+                break;  
+        }  
+    }  
+}  
+```  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+ 上の例では、<xref:System.Xml.XmlDocument> オブジェクトに含まれる XML ドキュメントに 2 つの変更が施されます。  XML ドキュメントが読み込まれるに従い、発見されたスキーマ検証エラーは検証イベント ハンドラー メソッドで処理され、コンソールに書き出されました。  
+  
+ この例では、XML ドキュメントが読み込まれた後に検証エラーが挿入され、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して発見されました。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドを使用して行われた変更は、新しい値がノードのスキーマ型に照らして無効だったので、<xref:System.InvalidCastException> が発生しました。  
+  
+ <xref:System.Xml.XPath.XPathNavigator.SetTypedValue%2A> メソッドを使用した値の変更の詳細については、「[XpathNavigator による XML データの変更](../../../../docs/standard/data/xml/modify-xml-data-using-xpathnavigator.md)」のトピックを参照してください。  
+  
+### 読み取り専用の検証  
+ <xref:System.Xml.XPath.XPathDocument> クラスは、XML ドキュメントの読み取り専用のメモリ内表現です。  <xref:System.Xml.XPath.XPathDocument> クラスと <xref:System.Xml.XmlDocument> クラスは両方とも、XML ドキュメントを編集しナビゲートするために <xref:System.Xml.XPath.XPathNavigator> オブジェクトを作成します。  <xref:System.Xml.XPath.XPathDocument> クラスは読み取り専用のクラスなので、<xref:System.Xml.XPath.XPathDocument> オブジェクトから返された <xref:System.Xml.XPath.XPathNavigator> オブジェクトは <xref:System.Xml.XPath.XPathDocument> オブジェクトに含まれる XML ドキュメントを編集できません。  
+  
+ このトピックで前述したように、検証の場合は、検証型 <xref:System.Xml.XmlReader> オブジェクトを使用して <xref:System.Xml.XmlDocument> オブジェクトを作成したのと同様にして、<xref:System.Xml.XPath.XPathDocument> オブジェクトを作成できます。  <xref:System.Xml.XPath.XPathDocument> オブジェクトは読み込みの際に XML ドキュメントを検証しますが、<xref:System.Xml.XPath.XPathDocument> オブジェクト内の XML データは編集できないので、XML ドキュメントの再検証はできません。  
+  
+ 読み取り専用と編集可能な <xref:System.Xml.XPath.XPathNavigator> オブジェクトの詳細については、「[XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)」のトピックを参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)   
+ [XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの編集](../../../../docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/script-blocks-using-msxsl-script.md b/docs/standard/data/xml/script-blocks-using-msxsl-script.md
new file mode 100644
index 00000000000..0d866dd48b2
--- /dev/null
+++ b/docs/standard/data/xml/script-blocks-using-msxsl-script.md
@@ -0,0 +1,159 @@
+---
+title: "msxsl:script を使用したスクリプト ブロック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: fde6f43f-c594-486f-abcb-2211197fae20
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# msxsl:script を使用したスクリプト ブロック
+<xref:System.Xml.Xsl.XslCompiledTransform> クラスは、`msxsl:script` 要素を使用した埋め込みスクリプトをサポートしています。  スタイル シートが読み込まれると、定義されているすべての関数はコード ドキュメント オブジェクト モデル \(CodeDOM\) によって Microsoft intermediate language \(MSIL\) にコンパイルされ、実行時に実行されます。  埋め込みのスクリプト ブロックから生成されたアセンブリは、スタイル シートに対して生成されるアセンブリとは区別されます。  
+  
+## XSLT スクリプトの有効化  
+ 埋め込みスクリプトのサポートは、<xref:System.Xml.Xsl.XslCompiledTransform> クラスではオプションの XSLT 設定です。  スクリプトのサポートは既定で無効になっています。  スクリプトのサポートを有効にするには、<xref:System.Xml.Xsl.XsltSettings.EnableScript%2A> プロパティを `true` に設定して <xref:System.Xml.Xsl.XsltSettings> オブジェクトを作成し、そのオブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドに渡します。  
+  
+> [!NOTE]
+>  XSLT スクリプトは、スクリプトのサポートが必要であり、完全に信頼された環境で作業している場合のみ有効にします。  
+  
+## msxsl:script 要素の定義  
+ `msxsl:script` 要素は XSLT 1.0 勧告に対するマイクロソフトの拡張機能であり、次のように定義されます。  
+  
+```  
+<msxsl:script language = "language-name" implements-prefix = "prefix of user namespace"> </msxsl:script>  
+```  
+  
+ `msxsl` プレフィックスは `urn:schemas-microsoft-com:xslt` 名前空間 URI に関連付けられています。  スタイル シートには `xmlns:msxsl=urn:schemas-microsoft-com:xslt` という名前空間の宣言が必要です。  
+  
+ `language` 属性は省略できます。  その値は、埋め込みコード ブロックのコード言語です。  言語は <xref:System.CodeDom.Compiler.CodeDomProvider.CreateProvider%2A?displayProperty=fullName> メソッドを使用して、適切な CodeDOM コンパイラに対応付けられます。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスは、適切なプロバイダーがコンピューターにインストールされ、machine.config ファイルの system.codedom セクションに登録されている限り、任意の Microsoft .NET 言語をサポートできます。  `language` 属性を指定しない場合、既定の言語は JScript です。  言語名では大文字小文字が区別されないため、"JavaScript" と "javascript" は同じと見なされます。  
+  
+ `implements-prefix` 属性は必須です。  この属性は、名前空間を宣言し、それをスクリプト ブロックに関連付けるために使用されます。  この属性の値は、名前空間を表すプレフィックスです。  このプレフィックスは、スタイル シート内の任意の場所で定義できます。  
+  
+> [!NOTE]
+>  `msxsl:script` 要素を使用するときは、どの言語でも、スクリプトを CDATA セクション内に配置することをお勧めします。  スクリプトは、その言語で使用する演算子、識別子、または区切り記号を含むことがあり、CDATA セクション内に配置しないと、誤って XML として解釈される可能性があります。  次の XML は、コードを配置できる CDATA セクションのテンプレートです。  
+  
+```  
+<msxsl:script implements-prefix='your-prefix' language='CSharp'>  
+<![CDATA[  
+// Code block.  
+]]>  
+</msxsl:script>  
+```  
+  
+## スクリプト関数  
+ 関数は、`msxsl:script` 要素内で宣言できます。  関数が宣言されると、その関数はスクリプト ブロックに含まれます。  スタイル シートには、相互に独立して機能する複数のスクリプト ブロックを含めることができます。  このため、1 つのスクリプト ブロック内で実行しているときに、別のスクリプト ブロックで定義した関数を呼び出すことはできません。ただし、そのブロックが同じ名前空間とスクリプト言語を持つように宣言されている場合は例外です。  各スクリプト ブロックは独自の言語で記述でき、ブロックはその言語に対応するパーサーの文法規則に従って解析されるため、使われている言語の正しい構文を使用することを推奨します。  たとえば、Microsoft C\# スクリプト内では C\# のコメント構文を使用します。  
+  
+ 関数に渡される引数と戻り値の型は任意です。  W3C XPath 型は共通言語ランタイム \(CLR\) 型のサブセットなので、XPath 型とは考えられない型については型変換が行われます。  W3C 型と等価な CLR 型を次の表に示します。  
+  
+|W3C 型|CLR 型|  
+|-----------|-----------|  
+|`String`|<xref:System.String>|  
+|`Boolean`|<xref:System.Boolean>|  
+|`Number`|<xref:System.Double>|  
+|`Result Tree Fragment`|<xref:System.Xml.XPath.XPathNavigator>|  
+|`Node Set`|<xref:System.Xml.XPath.XPathNodeIterator>|  
+  
+ CLR 数値型は <xref:System.Double> に変換されます。  <xref:System.DateTime> 型は <xref:System.String> に変換されます。  <xref:System.Xml.XPath.IXPathNavigable> 型は <xref:System.Xml.XPath.XPathNavigator> に変換されます。  **XPathNavigator\[\]** は <xref:System.Xml.XPath.XPathNodeIterator> に変換されます。  
+  
+ その他の型はエラーになります。  
+  
+### 名前空間とアセンブリのインポート  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスには、既定で `msxsl:script` 要素がサポートする一連のアセンブリと名前空間が事前定義されています。  しかし、アセンブリと名前空間を `msxsl:script` ブロックにインポートすることにより、事前定義の一覧にない 1 つの名前空間に属するクラスとメンバーを使用することができます。  
+  
+#### アセンブリ  
+ 次の 2 つのアセンブリは既定で参照されます。  
+  
+-   System.dll  
+  
+-   System.Xml.dll  
+  
+-   Microsoft.VisualBasic.dll \(スクリプト言語が VB の場合\)  
+  
+ `msxsl:assembly` 要素を使用して、追加のアセンブリをインポートすることができます。  これには、スタイル シートがコンパイルされたときのアセンブリも含まれます。  `msxsl:assembly` 要素は、次のように定義されます。  
+  
+```  
+<msxsl:script>  
+  <msxsl:assembly name="system.assemblyName" />  
+  <msxsl:assembly href="path-name" />  
+    <![CDATA[  
+    // User code  
+    ]]>  
+</msxsl:script>  
+```  
+  
+ `name` 属性にはアセンブリの名前が含まれ、`href` 属性にはアセンブリへのパスが含まれます。  アセンブリの名前は "System.Data, Version\=2.0.3600.0, Culture\=neutral, PublicKeyToken\=b77a5c561934e089" などの完全な名前でも、"System.Web" などの短い名前でもかまいません。  
+  
+#### 名前空間  
+ 次の名前空間は既定で含まれます。  
+  
+-   システム  
+  
+-   System.Collection  
+  
+-   System.Text  
+  
+-   System.Text.RegularExpressions  
+  
+-   System.Xml  
+  
+-   System.Xml.Xsl  
+  
+-   System.Xml.XPath  
+  
+-   Microsoft.VisualBasic \(スクリプト言語が VB の場合\)  
+  
+ `namespace` 属性を使用して、追加の名前空間のサポートを追加することができます。  属性値は名前空間の名前です。  
+  
+```  
+<msxsl:script>  
+  <msxsl:using namespace="system.namespaceName" />  
+    <![CDATA[  
+    // User code  
+    ]]>  
+</msxsl:script>  
+```  
+  
+## 例  
+ 埋め込みスクリプトを使用して、半径が指定された円の円周を算出する例を次に示します。  
+  
+ [!code-csharp[XSLT_Script#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XSLT_Script/CS/xslt_script.cs#1)]
+ [!code-vb[XSLT_Script#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XSLT_Script/VB/xslt_script.vb#1)]  
+  
+#### number.xml  
+ [!code-xml[XSLT_Script#2](../../../../samples/snippets/xml/VS_Snippets_Data/XSLT_Script/XML/number.xml#2)]  
+  
+#### calc.xsl  
+ [!code-xml[XSLT_Script#3](../../../../samples/snippets/xml/VS_Snippets_Data/XSLT_Script/XML/calc.xsl#3)]  
+  
+### 出力  
+  
+```  
+<circles xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">  
+  <circle>  
+    <radius>12</radius>  
+    <circumference>75.36</circumference>  
+  </circle>  
+  <circle>  
+    <radius>37.5</radius>  
+    <circumference>235.5</circumference>  
+  </circle>  
+</circles>  
+```  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)   
+ [動的なソース コードの生成とコンパイル](../../../../docs/framework/reflection-and-codedom/dynamic-source-code-generation-and-compilation.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/select-nodes-using-xpath-navigation.md b/docs/standard/data/xml/select-nodes-using-xpath-navigation.md
new file mode 100644
index 00000000000..e34e946d2e7
--- /dev/null
+++ b/docs/standard/data/xml/select-nodes-using-xpath-navigation.md
@@ -0,0 +1,172 @@
+---
+title: "XPath ナビゲーションによるノードの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 8e4450dc-56b3-472b-b467-32f5694f83ad
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XPath ナビゲーションによるノードの選択
+XML ドキュメント オブジェクト モデル \(DOM\) には、DOM 内の情報を照会するための XPath \(XML Path Language\) ナビゲーションに使用できるメソッドが含まれています。  XPath を使用すると、特定の単一ノードを見つけたり、条件に一致するすべてのノードを検索したりできます。  
+  
+## XPath の選択メソッド  
+ DOM クラスは、XPath による選択に、<xref:System.Xml.XmlNode.SelectSingleNode%2A> および <xref:System.Xml.XmlNode.SelectNodes%2A> という 2 つのメソッドを提供します。  <xref:System.Xml.XmlNode.SelectSingleNode%2A> メソッドは、選択基準に一致した最初のノードを返します。  <xref:System.Xml.XmlNode.SelectNodes%2A> メソッドは、一致したノードを含む <xref:System.Xml.XmlNodeList> を返します。  
+  
+ 次の例では、<xref:System.Xml.XmlNode.SelectSingleNode%2A> メソッドを使用して、著者の姓が指定した条件と一致する最初の `book` ノードを選択しています。  bookstore.xml ファイル \(このトピックの最後にあります\) を入力ファイルとして使用します。  
+  
+```vb  
+Dim doc As New XmlDocument()  
+doc.Load("bookstore.xml")  
+Dim root As XmlNode = doc.DocumentElement  
+  
+' Add the namespace.  
+Dim nsmgr As New XmlNamespaceManager(doc.NameTable)  
+nsmgr.AddNamespace("bk", "urn:newbooks-schema")  
+  
+' Select and display the first node in which the author's   
+' last name is Kingsolver.  
+Dim node As XmlNode = root.SelectSingleNode( _  
+     "descendant::bk:book[bk:author/bk:last-name='Kingsolver']", nsmgr)  
+Console.WriteLine(node.InnerXml)  
+```  
+  
+```csharp  
+// Load the document and set the root element.  
+XmlDocument doc = new XmlDocument();  
+doc.Load("bookstore.xml");  
+XmlNode root = doc.DocumentElement;  
+  
+// Add the namespace.  
+XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);  
+nsmgr.AddNamespace("bk", "urn:newbooks-schema");  
+  
+// Select and display the first node in which the author's   
+// last name is Kingsolver.  
+XmlNode node = root.SelectSingleNode(  
+    "descendant::bk:book[bk:author/bk:last-name='Kingsolver']", nsmgr);  
+Console.WriteLine(node.InnerXml);  
+```  
+  
+ 次の例では、<xref:System.Xml.XmlNode.SelectNodes%2A> メソッドを使用して、指定した値より高い価格の book ノードをすべて選択しています。  その後、選択されたリストに含まれる各書籍の価格を、プログラムで 10% 安くしています。  最後に、更新したファイルをコンソールに書き出します。  bookstore.xml ファイル \(このトピックの最後にあります\) を入力ファイルとして使用します。  
+  
+```vb  
+' Load the document and set the root element.  
+Dim doc As New XmlDocument()  
+doc.Load("bookstore.xml")  
+Dim root As XmlNode = doc.DocumentElement  
+  
+' Add the namespace.  
+Dim nsmgr As New XmlNamespaceManager(doc.NameTable)  
+nsmgr.AddNamespace("bk", "urn:newbooks-schema")  
+  
+' Select all nodes where the book price is greater than 10.00.  
+Dim nodeList As XmlNodeList = root.SelectNodes( _  
+     "descendant::bk:book[bk:price>10.00]", nsmgr)  
+For Each book As XmlNode In nodeList  
+     Dim price As Double  
+     price = Math.Round(Convert.ToSingle( _  
+          book.LastChild.InnerText) * 0.9, 2)  
+     book.LastChild.InnerText = price.ToString()  
+Next  
+  
+' Display the updated document.  
+doc.Save(Console.Out)  
+```  
+  
+```csharp  
+// Load the document and set the root element.  
+XmlDocument doc = new XmlDocument();  
+doc.Load("bookstore.xml");  
+XmlNode root = doc.DocumentElement;  
+  
+// Add the namespace.  
+XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);  
+nsmgr.AddNamespace("bk", "urn:newbooks-schema");  
+  
+// Select all nodes where the book price is greater than 10.00.  
+XmlNodeList nodeList = root.SelectNodes(  
+     "descendant::bk:book[bk:price>10.00]", nsmgr);  
+foreach (XmlNode book in nodeList)  
+{  
+     // Discount prices by 10%.  
+     double price;  
+     price = Math.Round(Convert.ToSingle(  
+          book.LastChild.InnerText) * 0.9, 2);  
+     book.LastChild.InnerText = price.ToString();  
+}  
+  
+// Display the updated document.  
+doc.Save(Console.Out);  
+```  
+  
+ 上の例で、XPath クエリはドキュメント要素から開始されます。  XPath クエリの始点を設定すると、コンテキスト ノードが設定され、XPath クエリの開始点になります。  ドキュメント要素からではなく、ドキュメント要素の最初の子から開始するには、次のように選択ステートメントを記述します。  
+  
+```vb  
+doc.DocumentElement.FirstChild.SelectNodes(. . . )  
+```  
+  
+```csharp  
+this doc.DocumentElement.FirstChild.SelectNodes(. . .);  
+```  
+  
+ すべての <xref:System.Xml.XmlNodeList> オブジェクトは、元のドキュメントに同期されます。  そのため、ノード リストを反復処理してノードの値を変更すると、そのノードは元のドキュメントにおいても更新されます。  前の例で、選択した <xref:System.Xml.XmlNodeList> でノードが変更されると、基になっているドキュメントも変更されることに注意してください。  
+  
+> [!NOTE]
+>  元のドキュメントが変更された場合は、選択を再実行するのが適切です。  変更されたノードが、以前はノード リストに含まれておらず、ノード リストに追加されるものであったり、ノード リストから削除されるものであったりした場合は、ノード リストの正確さは保証されなくなります。  
+  
+## XPath 式の名前空間  
+ XPath 式は名前空間を含むことができます。  名前空間の解決は <xref:System.Xml.XmlNamespaceManager> を使用してサポートされます。  XPath 式にプレフィックスが含まれる場合は、プレフィックスと名前空間 URI のペアを <xref:System.Xml.XmlNamespaceManager> に追加して、<xref:System.Xml.XmlNamespaceManager> を <xref:System.Xml.XmlNode.SelectNodes%28System.String%2CSystem.Xml.XmlNamespaceManager%29> メソッド、または <xref:System.Xml.XmlNode.SelectSingleNode%28System.String%2CSystem.Xml.XmlNamespaceManager%29> メソッドに渡す必要があります。  前のコード例では、<xref:System.Xml.XmlNamespaceManager> を使用して bookstore.xml ドキュメントの名前空間を解決しています。  
+  
+> [!NOTE]
+>  XPath 式にプレフィックスが含まれない場合は、名前空間 URI は空の名前空間であると仮定されます。  XML に既定の名前空間が含まれる場合でも、プレフィックスと名前空間 URI を <xref:System.Xml.XmlNamespaceManager> に追加する必要があります。そうしないと、ノードは選択されません。  
+  
+#### 入力ファイル  
+ 次に示すのは、このトピックの例で入力ファイルとして使用している bookstore.xml ファイルです。  
+  
+```  
+<?xml version='1.0'?>  
+<bookstore xmlns="urn:newbooks-schema">  
+  <book genre="novel" style="hardcover">  
+    <title>The Handmaid's Tale</title>  
+    <author>  
+      <first-name>Margaret</first-name>  
+      <last-name>Atwood</last-name>  
+    </author>  
+    <price>19.95</price>  
+  </book>  
+  <book genre="novel" style="other">  
+    <title>The Poisonwood Bible</title>  
+    <author>  
+      <first-name>Barbara</first-name>  
+      <last-name>Kingsolver</last-name>  
+    </author>  
+    <price>11.99</price>  
+  </book>  
+  <book genre="novel" style="paperback">  
+    <title>The Bean Trees</title>  
+    <author>  
+      <first-name>Barbara</first-name>  
+      <last-name>Kingsolver</last-name>  
+    </author>  
+    <price>5.99</price>  
+  </book>  
+</bookstore>  
+```  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/select-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/select-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..5bdb45a7b60
--- /dev/null
+++ b/docs/standard/data/xml/select-xml-data-using-xpathnavigator.md
@@ -0,0 +1,80 @@
+---
+title: "XPathNavigator を使用した XML データの選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: c268c49e-32b9-4171-b782-dcb7b065fa73
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator を使用した XML データの選択
+<xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で XPath 式を使用してノード セットを選択するための一連のメソッドを提供します。  選択した後、選択されたノード セットに対して反復して処理を行うことができます。  
+  
+## XPathNavigator の選択メソッド  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で XPath 式を使用してノード セットを選択するための一連のメソッドを提供します。  <xref:System.Xml.XPath.XPathNavigator> クラスは、祖先、子、および子孫のノードを、XPath 式を使用するよりも高速に選択できる最適化された一連のメソッドも提供します。  選択されたノード セットは、<xref:System.Xml.XPath.XPathNodeIterator> オブジェクトまたは、選択されたノードが単一の場合は <xref:System.Xml.XPath.XPathNavigator> オブジェクトとして返されます。  
+  
+### XPath 式によるノードの選択  
+ XPath 式を使用して 1 つのノード セットを選択するには、次のいずれかの選択メソッドを使用します。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Select%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A>  
+  
+ 呼び出されると、これらのメソッドは <xref:System.Xml.XPath.XPathNodeIterator> オブジェクト、または選択が単一ノードの場合は <xref:System.Xml.XPath.XPathNavigator> オブジェクトを使用して、自由に移動できる 1 つのノード セットを返します。  
+  
+ <xref:System.Xml.XPath.XPathNodeIterator> オブジェクトを使用して移動しても、その作成に使用された <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置に影響ありません。  <xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A> メソッドから返された <xref:System.Xml.XPath.XPathNavigator> オブジェクトは、返された単一ノード上に位置し、この場合もその作成に使用された <xref:System.Xml.XPath.XPathNavigator> オブジェクトの位置には影響しません。  
+  
+ 次の例は、<xref:System.Xml.XPath.XPathDocument> オブジェクトからの <xref:System.Xml.XPath.XPathNavigator> オブジェクトの作成、<xref:System.Xml.XPath.XPathNavigator.Select%2A> メソッドを使用した <xref:System.Xml.XPath.XPathDocument> オブジェクト内のノードの選択、および <xref:System.Xml.XPath.XPathNodeIterator> オブジェクトを使用した選択ノード上の繰り返し処理について示しています。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+Dim nodes As XPathNodeIterator = navigator.Select("/bookstore/book")  
+  
+While nodes.MoveNext()  
+    Console.WriteLine(nodes.Current.Name)  
+End While  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+XPathNodeIterator nodes = navigator.Select("/bookstore/book");  
+  
+while(nodes.MoveNext())  
+{  
+    Console.WriteLine(nodes.Current.Name);  
+}  
+```  
+  
+ この例は、`books.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#1](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/books.xml#1)]  
+  
+### 最適化された選択メソッド  
+ <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.SelectChildren%2A>、<xref:System.Xml.XPath.XPathNavigator.SelectAncestors%2A>、および <xref:System.Xml.XPath.XPathNavigator.SelectDescendants%2A> メソッドは、子、子孫、および祖先のノードにアクセスする一般的な XPath 式に相当します。  これらのメソッドのパフォーマンスは最適化されており、対応する XPath 式よりも高速です。  <xref:System.Xml.XPath.XPathNavigator.SelectChildren%2A>、<xref:System.Xml.XPath.XPathNavigator.SelectAncestors%2A>、および <xref:System.Xml.XPath.XPathNavigator.SelectDescendants%2A> メソッドは、<xref:System.Xml.XPath.XPathNodeType> 値または選択するノードのローカル名と名前空間 URI を基にして祖先、子、および子孫のノードを選択します。  選択された祖先、子、および子孫のノードは <xref:System.Xml.XPath.XPathNodeIterator> オブジェクトとして返されます。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)   
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)   
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)   
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)   
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md b/docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md
new file mode 100644
index 00000000000..c5771ed6c40
--- /dev/null
+++ b/docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md
@@ -0,0 +1,54 @@
+---
+title: "XPathNavigator を使用した XML データの選択、評価、および照合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 46e059f8-4dc8-4185-9236-784be95228ed
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPathNavigator を使用した XML データの選択、評価、および照合
+<xref:System.Xml.XPath.XPathNavigator> クラスは、XPath クエリによる <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノードの選択、XPath 式の結果の評価と検査、および <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノードが指定された XPath 式に一致するかどうかの判定のためのメソッドを提供します。  以下のトピックでは、これらの概念および <xref:System.Xml.XPath.XPathDocument> または <xref:System.Xml.XmlDocument> オブジェクト内のノードの選択、評価、および照合に関連する他の概念について説明します。  
+  
+## このセクションの内容  
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクト内で XPath 式を使用してノード セットを選択するために使用される <xref:System.Xml.XPath.XPathNavigator> クラスの一連のメソッドについて説明します。  
+  
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)  
+ XPath 式の評価に使用される <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A> メソッドについて説明します。  
+  
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)  
+ ノードが XPath 式に一致するかどうかを判定するために使用される <xref:System.Xml.XPath.XPathNavigator> クラスの <xref:System.Xml.XPath.XPathNavigator.Matches%2A> メソッドについて説明します。  
+  
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)  
+ XPath クエリで認識されるノードの型について説明します。  
+  
+ [XPath クエリおよび名前空間](../../../../docs/standard/data/xml/xpath-queries-and-namespaces.md)  
+ XPath クエリでの名前空間の使用について説明します。  
+  
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)  
+ コンパイル済みの XPath クエリを表す <xref:System.Xml.XPath.XPathExpression> クラスについて説明します。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathDocument および XmlDocument を使用した XML データの読み取り](../../../../docs/standard/data/xml/reading-xml-data-using-xpathdocument-and-xmldocument.md)   
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による XML データの編集](../../../../docs/standard/data/xml/editing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/style-sheet-directives-embedded-in-a-document.md b/docs/standard/data/xml/style-sheet-directives-embedded-in-a-document.md
new file mode 100644
index 00000000000..edaa7108f38
--- /dev/null
+++ b/docs/standard/data/xml/style-sheet-directives-embedded-in-a-document.md
@@ -0,0 +1,49 @@
+---
+title: "ドキュメントに埋め込まれたスタイル シート ディレクティブ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d79fb295-ebc7-438d-ba1b-05be7d534834
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# ドキュメントに埋め込まれたスタイル シート ディレクティブ
+既存の XML に `<?xml:stylesheet?>` というスタイル シート ディレクティブが含まれていることがあります。  Microsoft Internet Explorer は、これを `<?xml-stylesheet?>` 構文に代わるものとして受け入れます。  次のように `<?xml:stylesheet?>` ディレクティブが含まれている XML データを XML ドキュメント オブジェクト モデル \(DOM\) に読み込もうとすると、例外がスローされます。  
+  
+```  
+<?xml version="1.0" ?>  
+<?xml:stylesheet type="text/xsl" href="test2.xsl"?>  
+<root>  
+    <test>Node 1</test>  
+    <test>Node 2</test>  
+</root>  
+```  
+  
+ 例外が発生するのは、`<?xml:stylesheet?>` が DOM に対する無効な **ProcessingInstruction** と見なされるからです。  『Namespaces in XML』仕様によれば、**ProcessingInstruction** は、QNames \(修飾名\) ではなく、NCNames \(コロンが含まれない名前\) にする必要があります。  
+  
+ 『Namespaces in XML』仕様書のセクション 6 によると、**Load** メソッドと **LoadXml** メソッドをこの仕様に準拠させた場合の影響として、ドキュメントには次の規則が適用されることになります。  
+  
+-   すべての要素型と属性名は、0 個または 1 個のコロンを含みます。  
+  
+-   エンティティ名、処理命令ターゲット、記法名は、いずれもコロンを含みません。  
+  
+ コロンが含まれた `<?xml:stylesheet?>` は、2 番目の規則に違反します。  
+  
+ www.w3.org\/TR\/xml\-stylesheet で公開されている W3C \(World Wide Web Consortium\) 勧告『Associating Style Sheets with XML documents Version 1.0』によれば、XSLT スタイル シートを XML ドキュメントに関連付ける処理命令は、コロンをダッシュに置き換えた `<?xml-stylesheet?>` です。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/support-for-the-msxsl-node-set-function.md b/docs/standard/data/xml/support-for-the-msxsl-node-set-function.md
new file mode 100644
index 00000000000..f5ca9ff01d0
--- /dev/null
+++ b/docs/standard/data/xml/support-for-the-msxsl-node-set-function.md
@@ -0,0 +1,66 @@
+---
+title: "msxsl:node-set() 関数のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: d0cbf517-d9f6-4097-9851-4fa62903decd
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# msxsl:node-set() 関数のサポート
+`msxsl:node-set` 関数を使用すると、結果ツリー フラグメントをノード セットに変換できます。  結果として得られるノード セットには、常に単一のノードが含まれています。また、このノード セットは、常にそのツリーのルート ノードです。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ `msxsl:node-set` 関数を使用すると、結果ツリー フラグメントをノード セットに変換できます。  結果として得られるノード セットには、常に単一のノードが含まれています。また、このノード セットは、常にそのツリーのルート ノードです。  
+  
+## 例  
+ `$var` という変数がスタイル シート内のノード ツリーである例を次に示します。  for\-each ステートメントを `node-set` 関数と組み合わせて使用すれば、このノード ツリーをノード セットとして反復処理できます。  
+  
+## nodeset.xsl  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+                xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+                xmlns:user="http://www.contoso.com"  
+                version="1.0">  
+    <xsl:variable name="books">  
+        <book author="Michael Howard">Writing Secure Code</book>  
+        <book author="Michael Kay">XSLT Reference</book>  
+    </xsl:variable>  
+  
+    <xsl:template match="/">  
+        <authors>  
+            <xsl:for-each select="msxsl:node-set($books)/book">   
+                <author><xsl:value-of select="@author"/)</author>  
+            </xsl:for-each>  
+        </authors>  
+    </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+## 出力  
+ 変換による出力は次のとおりです。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<authors><author>Michael Howard</author><author>Michael Kay</author></authors>  
+```  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/traversing-xml-schemas.md b/docs/standard/data/xml/traversing-xml-schemas.md
new file mode 100644
index 00000000000..1492c78661b
--- /dev/null
+++ b/docs/standard/data/xml/traversing-xml-schemas.md
@@ -0,0 +1,82 @@
+---
+title: "XML スキーマの走査 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: cce69574-5861-4a30-b730-2e18d915d8ee
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマの走査
+スキーマ オブジェクト モデル \(SOM\) API を使用して XML スキーマを走査すると、SOM に格納されている要素、属性、および型にアクセスできます。  また、SOM API を使用して XML スキーマを編集する際には、最初に SOM に読み込まれた XML スキーマを走査します。  
+  
+## XML スキーマの走査  
+ <xref:System.Xml.Schema.XmlSchema> クラスの次のプロパティを使用すると、XML スキーマに追加されたすべてのグローバル要素のコレクションにアクセスできます。  
+  
+|プロパティ|コレクションまたは配列に格納されているオブジェクトの型|  
+|-----------|---------------------------------|  
+|<xref:System.Xml.Schema.XmlSchema.Elements%2A>|<xref:System.Xml.Schema.XmlSchemaElement>|  
+|<xref:System.Xml.Schema.XmlSchema.Attributes%2A>|<xref:System.Xml.Schema.XmlSchemaAttribute>|  
+|<xref:System.Xml.Schema.XmlSchema.AttributeGroups%2A>|<xref:System.Xml.Schema.XmlSchemaAttributeGroup>|  
+|<xref:System.Xml.Schema.XmlSchema.Groups%2A>|<xref:System.Xml.Schema.XmlSchemaGroup>|  
+|<xref:System.Xml.Schema.XmlSchema.Includes%2A>|<xref:System.Xml.Schema.XmlSchemaExternal>、<xref:System.Xml.Schema.XmlSchemaInclude>、<xref:System.Xml.Schema.XmlSchemaImport>、または <xref:System.Xml.Schema.XmlSchemaRedefine>|  
+|<xref:System.Xml.Schema.XmlSchema.Items%2A>|<xref:System.Xml.Schema.XmlSchemaObject> \(グローバル レベルのすべての要素、属性、および型にアクセスできる\)|  
+|<xref:System.Xml.Schema.XmlSchema.Notations%2A>|<xref:System.Xml.Schema.XmlSchemaNotation>|  
+|<xref:System.Xml.Schema.XmlSchema.SchemaTypes%2A>|<xref:System.Xml.Schema.XmlSchemaType>, <xref:System.Xml.Schema.XmlSchemaSimpleType>, <xref:System.Xml.Schema.XmlSchemaComplexType>|  
+|<xref:System.Xml.Schema.XmlSchema.UnhandledAttributes%2A>|<xref:System.Xml.XmlAttribute> \(スキーマの名前空間に属さない属性にアクセスできる\)|  
+  
+> [!NOTE]
+>  上記の表に記載されているすべてのプロパティ \(<xref:System.Xml.Schema.XmlSchema.Items%2A> プロパティを除く\) は、スキーマのコンパイル後の情報セット \(PSCI\) プロパティで、スキーマがコンパイルされるまで使用できません。  <xref:System.Xml.Schema.XmlSchema.Items%2A> プロパティは、スキーマのコンパイル前のプロパティで、スキーマがコンパイルされる前に使用できます。このプロパティを使用すると、グローバル レベルのすべての要素、属性、および型にアクセスできます。  
+>   
+>  <xref:System.Xml.Schema.XmlSchema.UnhandledAttributes%2A> プロパティを使用すると、スキーマの名前空間に属さないすべての属性にアクセスできます。  これらの属性はスキーマ プロセッサで処理されません。  
+  
+ 以下のコード サンプルでは、「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」で作成されたカスタム スキーマの走査の例を示します。  このコード サンプルは、上記のコレクションを使用してスキーマを走査し、スキーマのすべての要素と属性をコンソールに出力する例を示します。  
+  
+ このサンプルでは、次の手順でカスタム スキーマの走査を行います。  
+  
+1.  カスタム スキーマを新しい <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトに追加し、コンパイルします。  スキーマの読み取りまたはコンパイル時に発生するスキーマ検証に関する警告とエラーは、<xref:System.Xml.Schema.ValidationEventHandler> デリゲートで処理されます。  
+  
+2.  <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを反復処理して、<xref:System.Xml.Schema.XmlSchemaSet> からコンパイルされた <xref:System.Xml.Schema.XmlSchema> オブジェクトを取得します。  スキーマはコンパイルされているため、スキーマのコンパイル後の情報セット \(PSCI\) プロパティにアクセスできます。  
+  
+3.  各要素の名前をコンソールに出力するスキーマ コンパイル後の <xref:System.Xml.Schema.XmlSchema.Elements%2A?displayProperty=fullName> コレクションの <xref:System.Xml.Schema.XmlSchemaObjectTable.Values%2A> コレクションで、各 <xref:System.Xml.Schema.XmlSchemaElement> を反復処理します。  
+  
+4.  <xref:System.Xml.Schema.XmlSchemaComplexType> クラスを使用して `Customer` 要素の複合型を取得します。  
+  
+5.  複合型に何らかの属性がある場合、それぞれの <xref:System.Xml.Schema.XmlSchemaAttribute> を列挙する <xref:System.Collections.IDictionaryEnumerator> を取得して、その名前をコンソールに出力します。  
+  
+6.  <xref:System.Xml.Schema.XmlSchemaSequence> クラスを使用して、複合型の sequence のパーティクルを取得します。  
+  
+7.  各子要素の名前をコンソールに出力する <xref:System.Xml.Schema.XmlSchemaSequence.Items%2A?displayProperty=fullName> コレクション内で、それぞれの <xref:System.Xml.Schema.XmlSchemaElement> を反復処理します。  
+  
+ 完全なコード サンプルを次に示します。  
+  
+ [!code-cpp[XmlSchemaTraverseExample#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaTraverseExample/CPP/XmlSchemaTraverseExample.cpp#1)]
+ [!code-csharp[XmlSchemaTraverseExample#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaTraverseExample/CS/XmlSchemaTraverseExample.cs#1)]
+ [!code-vb[XmlSchemaTraverseExample#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaTraverseExample/VB/XmlSchemaTraverseExample.vb#1)]  
+  
+ <xref:System.Xml.Schema.XmlSchemaElement.ElementSchemaType%2A?displayProperty=fullName> プロパティには、<xref:System.Xml.Schema.XmlSchemaSimpleType> \(ユーザー定義の単純型または複合型の場合は <xref:System.Xml.Schema.XmlSchemaComplexType>\) を使用できます。  また、W3C 勧告『XML Schema』で定義されている組み込みデータ型の場合には、<xref:System.Xml.Schema.XmlSchemaDatatype> を使用することもできます。  カスタム スキーマの場合、`Customer` 要素の <xref:System.Xml.Schema.XmlSchemaElement.ElementSchemaType%2A> は <xref:System.Xml.Schema.XmlSchemaComplexType> で、`FirstName` 要素および `LastName` 要素は <xref:System.Xml.Schema.XmlSchemaSimpleType> です。  
+  
+ 「[XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)」のコード サンプルでは、<xref:System.Xml.Schema.XmlSchemaComplexType.Attributes%2A?displayProperty=fullName> コレクションを使用して、`Customer` 要素に属性 `CustomerId` を追加しました。  これは、スキーマのコンパイル前のプロパティです。  対応するスキーマのコンパイル後の情報セット プロパティは、<xref:System.Xml.Schema.XmlSchemaComplexType.AttributeUses%2A?displayProperty=fullName> コレクションで、複合型のすべての属性 \(型の派生を通じて継承される属性を含む\) を持っています。  
+  
+## 参照  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)   
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)   
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)   
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)   
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [スキーマのコンパイル後の情報セット](../../../../docs/standard/data/xml/post-schema-compilation-infoset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/type-support-in-the-system-xml-classes.md b/docs/standard/data/xml/type-support-in-the-system-xml-classes.md
new file mode 100644
index 00000000000..a16b4006916
--- /dev/null
+++ b/docs/standard/data/xml/type-support-in-the-system-xml-classes.md
@@ -0,0 +1,51 @@
+---
+title: "System.Xml クラスでの型のサポート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 63570538-06e3-4401-ad4d-ac50be90c7bf
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# System.Xml クラスでの型のサポート
+.NET Framework Version 2.0 では、コアの XML クラスが強化され、型サポート機能が追加されています。  <xref:System.Xml.XmlReader>、<xref:System.Xml.XmlWriter>、および <xref:System.Xml.XPath.XPathNavigator> クラスには、XML スキーマ型と共通言語ランタイム \(CLR\) 型の間の変換機能を含む型サポート機能が含まれています。  
+  
+ .NET Framework Version 2.0 では、<xref:System.Xml.XmlReader>、<xref:System.Xml.XmlWriter>、および <xref:System.Xml.XPath.XPathNavigator> クラスが強化され、型サポート機能が追加されています。  
+  
+-   <xref:System.Xml.XmlReader> および <xref:System.Xml.XPath.XPathNavigator> クラスにはそれぞれ、ノードのスキーマ情報を返す **SchemaInfo** プロパティが含まれています。  
+  
+-   <xref:System.Xml.XmlReader> クラスの **ReadContentAs** と **ReadElementContentAs** メソッドは、1 回のメソッド呼び出しでテキスト値を読み取り、それを CLR 値に変換します。  
+  
+-   <xref:System.Xml.XmlWriter> クラスの <xref:System.Xml.XmlWriter.WriteValue%2A> メソッドは、XML の書き出し時に、CLR 型を XML スキーマ型に変換します。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator> クラスの **ValueAs** および <xref:System.Xml.XPath.XPathNavigator.TypedValue%2A> プロパティは、1 回のメソッド呼び出しでノード値を返し、それを CLR 値に変換します。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 では、XML スキーマ型と CLR 型の間の変換に <xref:System.Xml.XmlConvert> クラスが必要でした。  
+  
+## このセクションの内容  
+ [XML データ型から CLR 型へのマッピング](../../../../docs/standard/data/xml/mapping-xml-data-types-to-clr-types.md)  
+ XML データ型から CLR 型への既定のマッピングについて説明します。  
+  
+ [XML 型サポートの実装に関するメモ](../../../../docs/standard/data/xml/xml-type-support-implementation-notes.md)  
+ 型サポート実装の詳細のいくつかについて説明します。  
+  
+ [XML データ型の変換](../../../../docs/standard/data/xml/conversion-of-xml-data-types.md)  
+ XML スキーマ型と CLR 型の間の変換に <xref:System.Xml.XmlConvert> クラスを使用する方法について説明します。  
+  
+## 関連項目  
+ [厳密に型指定された XML データへの XPathNavigator を使用したアクセス](../../../../docs/standard/data/xml/accessing-strongly-typed-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/types-of-xml-nodes.md b/docs/standard/data/xml/types-of-xml-nodes.md
new file mode 100644
index 00000000000..222ef3d9111
--- /dev/null
+++ b/docs/standard/data/xml/types-of-xml-nodes.md
@@ -0,0 +1,59 @@
+---
+title: "XML ノードの種類 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 71d03b78-6898-4ce7-b0fc-1282573f31f7
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ノードの種類
+XML ドキュメントがノードのツリーとしてメモリに読み込まれると、ノードの作成時にノード型が決まります。  XML ドキュメント オブジェクト モデル \(DOM\) では複数のノード型が定義されています。これらのノード型は W3C \(World Wide Web Consortium\) で規定されているもので、セクション 1.1.1「The DOM Structure Model」に記載されています。  ノード型、ノード型に割り当てられるオブジェクト、およびそれぞれの簡単な説明を次の表に示します。  
+  
+|DOM ノード型|Object|説明|  
+|--------------|------------|--------|  
+|Document|[XmlDocument クラス](frlrfSystemXmlXmlDocumentClassTopic)|ツリー内のすべてのノードのコンテナーです。  ドキュメントのルートとも呼ばれますが、常にルート要素と一致するとは限りません。|  
+|DocumentFragment|[XmlDocumentFragment クラス](frlrfSystemXmlXmlDocumentFragmentClassTopic)|1 つ以上のノードを非ツリー構造で格納する一時的なバッグです。|  
+|DocumentType|[XmlDocumentType クラス](frlrfSystemXmlXmlDocumentTypeClassTopic)|`<!DOCTYPE >` ノードを表します。|  
+|EntityReference|[XmlEntityReference クラス](frlrfSystemXmlXmlEntityReferenceClassTopic)|展開されていないエンティティ参照テキストを表します。|  
+|要素|[XmlElement クラス](frlrfSystemXmlXmlElementClassTopic)|要素ノードを表します。|  
+|Attr|[XmlAttribute クラス](frlrfSystemXmlXmlAttributeClassTopic)|要素の属性です。|  
+|ProcessingInstruction|[XmlProcessingInstruction クラス](frlrfSystemXmlXmlProcessingInstructionClassTopic)|処理命令ノードです。|  
+|コメント|[XmlComment クラス](frlrfSystemXmlXmlCommentClassTopic)|コメント ノードです。|  
+|Text|[XmlText クラス](frlrfSystemXmlXmlTextClassTopic)|要素または属性に含まれるテキストです。|  
+|CDATASection|[XmlCDataSection クラス](frlrfSystemXmlXmlCDataSectionClassTopic)|CDATA を表します。|  
+|Entity|[XmlEntity クラス](frlrfSystemXmlXmlEntityClassTopic)|内部ドキュメント型定義 \(DTD\) のサブセットまたは外部 DTD とパラメーター エンティティから取得され、XML ドキュメントに含まれている `<!ENTITY >` 宣言を表します。|  
+|Notation|[XmlNotation クラス](frlrfSystemXmlXmlNotationClassTopic)|DTD で宣言された記法を表します。|  
+  
+ 属性 \(*attr*\) は、W3C DOM Level 1 のセクション 1.2「Fundamental Interfaces」ではノードとして記載されていますが、どの要素ノードの子とも見なされません。  
+  
+ W3C では定義されていない追加のノード型を次の表に示します。ただし、これらのノード型は **XmlNodeType** 列挙値としてのみ Microsoft .NET Framework オブジェクト モデルで使用できます。  そのため、これらのノード型に対応する DOM ノード型の列はありません。  
+  
+|ノード型|説明|  
+|----------|--------|  
+|<xref:System.Xml.XmlDeclaration>|宣言ノード `<?xml version="1.0" >` を表します。|  
+|<xref:System.Xml.XmlSignificantWhitespace>|有意の空白を表します。これは混合コンテンツの空白です。|  
+|<xref:System.Xml.XmlWhitespace>|要素コンテンツ内の空白を表します。|  
+|EndElement|**XmlReader** が要素の末尾に達したときに返されます。<br /><br /> XML サンプル: **\<\/item\>**<br /><br /> 詳細については、「[XmlNodeType 列挙体](frlrfSystemXmlXmlNodeTypeClassTopic)」を参照してください。|  
+|EndEntity|<xref:System.Xml.XmlReader.ResolveEntity%2A> を呼び出した後、置換するエンティティの末尾に **XmlReader** が達したときに返されます。  詳細については、「[XmlNodeType 列挙体](frlrfSystemXmlXmlNodeTypeClassTopic)」を参照してください。|  
+  
+ XML を読み込み、case 構成体を使用してノード型を判定し、ノードとその内容についての情報を出力するコード サンプルについては、「[NodeType プロパティ](frlrfSystemXmlXmlSignificantWhitespaceClassNodeTypeTopic)」を参照してください。  
+  
+ ノード型のオブジェクト階層構造とそれぞれに対応するオブジェクト名の詳細については、「[XML ドキュメント オブジェクト モデル \(DOM\) の階層構造](../../../../docs/standard/data/xml/xml-document-object-model-dom-hierarchy.md)」を参照してください。  ノード ツリーで作成したオブジェクトの詳細については、「[オブジェクト階層の XML データへのマップ](../../../../docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/unordered-node-retrieval-by-name-or-index.md b/docs/standard/data/xml/unordered-node-retrieval-by-name-or-index.md
new file mode 100644
index 00000000000..149687c7fc6
--- /dev/null
+++ b/docs/standard/data/xml/unordered-node-retrieval-by-name-or-index.md
@@ -0,0 +1,129 @@
+---
+title: "名前またはインデックスによる順序付けられていないノードの取得 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2038a90b-92af-4a0a-baaa-08e688d95194
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 名前またはインデックスによる順序付けられていないノードの取得
+W3C \(World Wide Web Consortium\) 仕様で NamedNodeMap として定義されている **XmlNamedNodeMap** は、名前またはインデックスでノードを参照する機能を持っており、順序付けられていないノード セットを処理する必要があります。  **XmlNamedNodeMap** にアクセスできるのは、メソッドまたはプロパティから **XmlNamedNodeMap** が返されたときだけです。  **XmlNamedNodeMap** を返すメソッドやプロパティには、次の 3 つがあります。  
+  
+-   XmlElement.Attributes  
+  
+-   XmlDocumentType.Entities  
+  
+-   XmlDocumentType.Notations  
+  
+ たとえば、**XmlDocumentType.Entities** プロパティは、ドキュメント型宣言で宣言された **XmlEntity** ノードのコレクションを取得します。  このコレクションは **XmlNamedNodeMap** として返され、**Count** プロパティを使用してコレクションを反復処理し、エンティティ情報を表示できます。  **XmlNamedNodeMap** の反復処理の例については、「[XmlDocumentType.Entities プロパティ](frlrfSystemXmlXmlDocumentTypeClassEntitiesTopic)」を参照してください。  
+  
+ **XmlAttributeCollection** は **XmlNamedNodeMap** から派生しており、属性だけは変更できますが、記法とエンティティは読み取り専用です。  属性に対して **XmlNamedNodeMap** を使用すると、XML 名に基づいて属性のノードを取得できます。  これは、要素ノードの属性コレクションを操作する簡単な方法です。  **XmlNodeList** にも **IEnumerable** インターフェイスが実装されていますが、文字列ではなくインデックス アクセサーを使用するという点で **XmlNamedNodeMap** とは異なります。  **RemoveNamedItem** メソッドと **SetNamedItem** メソッドは **XmlAttributeCollection** に対してだけ使用します。  属性コレクションに追加したり、属性コレクションから削除すると、**AttributeCollection** または **XmlNamedNodeMap** のどちらの実装を使用した場合でも、要素の属性コレクションが変更されます。  属性を移動する方法と新しい属性を作成する方法を次のコード サンプルに示します。  
+  
+```vb  
+Imports System  
+Imports System.Xml  
+  
+Class test  
+  
+    Public Shared Sub Main()  
+        Dim doc As New XmlDocument()  
+        doc.LoadXml("<root> <child1 attr1='val1' attr2='val2'> text1 </child1> <child2 attr3='val3'> text2 </child2> </root> ")  
+  
+        ' Get the attributes of node "child2 "  
+        Dim ac As XmlAttributeCollection = doc.DocumentElement.ChildNodes(1).Attributes  
+  
+        ' Print out the number of attributes and their names.  
+        Console.WriteLine(("Number of Attributes: " + ac.Count))  
+        Dim i As Integer  
+        For i = 0 To ac.Count - 1  
+            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
+        Next i  
+        ' Get the 'attr1' from child1.  
+        Dim attr As XmlAttribute = doc.DocumentElement.ChildNodes(0).Attributes(0)  
+  
+        ' Add this attribute to the attributecollection "ac".  
+        ac.SetNamedItem(attr)  
+  
+        ''attr1' will be removed from 'child1' and added to 'child2'.  
+        ' Print out the number of attributes and their names.  
+        Console.WriteLine(("Number of Attributes: " + ac.Count))  
+  
+        For i = 0 To ac.Count - 1  
+            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
+        Next i  
+        ' Create a new attribute and add to the collection.  
+        Dim attr2 As XmlAttribute = doc.CreateAttribute("attr4")  
+        attr2.Value = "val4"  
+        ac.SetNamedItem(attr2)  
+  
+        ' Print out the number of attributes and their names.  
+        Console.WriteLine(("Number of Attributes: " + ac.Count))  
+  
+        For i = 0 To ac.Count - 1  
+            Console.WriteLine((i + 1 + ".  Attribute Name: '" + ac(i).Name + "'  Attribute Value:  '" + ac(i).Value + "'"))  
+        Next i  
+    End Sub 'Main  
+End Class 'test  
+```  
+  
+```csharp  
+using System;  
+using System.Xml;  
+class test {  
+    public static void Main() {  
+        XmlDocument doc = new XmlDocument();  
+        doc.LoadXml( "<root> <child1 attr1='val1' attr2='val2'> text1 </child1> <child2 attr3='val3'> text2 </child2> </root> " );  
+  
+        // Get the attributes of node "child2"  
+        XmlAttributeCollection ac = doc.DocumentElement.ChildNodes[1].Attributes;  
+  
+        // Print out the number of attributes and their names.  
+        Console.WriteLine( "Number of Attributes: "+ac.Count );  
+        for( int i = 0; i < ac.Count; i++ )  
+            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );   
+  
+        // Get the 'attr1' from child1.  
+        XmlAttribute attr = doc.DocumentElement.ChildNodes[0].Attributes[0];  
+  
+        // Add this attribute to the attributecollection "ac".  
+        ac.SetNamedItem( attr );  
+  
+        // 'attr1' will be removed from 'child1' and added to 'child2'.  
+        // Print out the number of attributes and their names.  
+        Console.WriteLine( "Number of Attributes: "+ac.Count );          
+        for( int i = 0; i < ac.Count; i++ )  
+            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );   
+  
+        // Create a new attribute and add to the collection.  
+        XmlAttribute attr2 = doc.CreateAttribute( "attr4" );  
+        attr2.Value = "val4";  
+        ac.SetNamedItem( attr2 );  
+  
+        // Print out the number of attributes and their names.  
+        Console.WriteLine( "Number of Attributes: "+ac.Count );          
+        for( int i = 0; i < ac.Count; i++ )  
+            Console.WriteLine( (i+1) + ".  Attribute Name: '" +ac[i].Name+ "'  Attribute Value:  '"+ ac[i].Value +"'" );           
+  
+    }  
+}  
+```  
+  
+ **AttributeCollection** から属性を削除するコード サンプルについては、「[XmlNamedNodeMap.RemoveNamedItem メソッド](frlrfSystemXmlXmlNamedNodeMapClassRemoveNamedItemTopic)」を参照してください。  メソッドとプロパティの詳細については、「[XmlNamedNodeMap メンバー](frlrfSystemXmlXmlNamedNodeMapMembersTopic)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/user-defined-functions-and-variables.md b/docs/standard/data/xml/user-defined-functions-and-variables.md
new file mode 100644
index 00000000000..b138d55d64b
--- /dev/null
+++ b/docs/standard/data/xml/user-defined-functions-and-variables.md
@@ -0,0 +1,59 @@
+---
+title: "ユーザー定義の関数と変数 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 4772f20e-1e7f-496e-93c2-1484473be555
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# ユーザー定義の関数と変数
+<xref:System.Xml.XPath.XPathNavigator> クラスは、<xref:System.Xml.XPath.XPathDocument> データの操作に使用されるメソッドのセットを提供します。  XPath クエリ式で使用する拡張関数および変数を実装することで、標準の XPath 関数を補完できます。  <xref:System.Xml.XPath.XPathExpression.SetContext%2A> メソッドは、<xref:System.Xml.Xsl.XsltContext> から派生した、ユーザー定義のコンテキストを受け取ることができます。  ユーザー定義の関数は、カスタム コンテキストで解決されます。  
+  
+ 拡張関数および変数は、XML インジェクション攻撃を防止するのに役立ちます。  このようなシナリオでは、処理命令と連結された生の入力としてではなく、ユーザー入力がカスタム変数に割り当てられ、拡張関数で処理されます。  拡張関数および変数にユーザー入力が含まれて、設計者が意図したように、XML データに対してだけ機能します。  
+  
+ 拡張関数および変数を使用するには、カスタム クラス <xref:System.Xml.Xsl.XsltContext> を、拡張関数および変数をサポートする <xref:System.Xml.Xsl.IXsltContextFunction> インターフェイスおよび <xref:System.Xml.Xsl.IXsltContextVariable> インターフェイスと共に実装します。  <xref:System.Xml.XPath.XPathExpression> は、ユーザー入力をその <xref:System.Xml.Xsl.XsltArgumentList> と共にカスタム <xref:System.Xml.Xsl.XsltContext> に追加します。  
+  
+ <xref:System.Xml.XPath.XPathExpression> は、式で識別されるノードを見つけて処理するのに <xref:System.Xml.XPath.XPathNavigator> が使用する、コンパイル済みクエリを表します。  
+  
+ <xref:System.Xml.Xsl.XsltContext> から派生したカスタム コンテキスト クラスの実装を次の例に示します。  コード コメントは、クラスのメンバーと、カスタム関数でのそれらのメンバーの使用法を説明しています。  このコードの後に、関数および変数の実装と、それらの実装を使用するサンプル アプリケーションがあります。  
+  
+ [!code-csharp[XPathExtensionFunctions#2](../../../../samples/snippets/csharp/VS_Snippets_Data/xpathextensionfunctions/cs/xpathextensionfunctions.cs#2)]
+ [!code-vb[XPathExtensionFunctions#2](../../../../samples/snippets/visualbasic/VS_Snippets_Data/xpathextensionfunctions/vb/xpathextensionfunctions.vb#2)]  
+  
+ 次のコードでは <xref:System.Xml.Xsl.IXsltContextFunction> を実装します。  <xref:System.Xml.Xsl.IXsltContextFunction> を実装するクラスは、ユーザー定義の関数を解決し、実行します。  この例では、宣言 `private int CountChar(string title, char charTocount)` で識別される関数を使用します。  
+  
+ コード コメントでは、クラスのメンバーを示しています。  
+  
+ [!code-csharp[XPathExtensionFunctions#3](../../../../samples/snippets/csharp/VS_Snippets_Data/xpathextensionfunctions/cs/xpathextensionfunctions.cs#3)]
+ [!code-vb[XPathExtensionFunctions#3](../../../../samples/snippets/visualbasic/VS_Snippets_Data/xpathextensionfunctions/vb/xpathextensionfunctions.vb#3)]  
+  
+ 次のコードでは <xref:System.Xml.Xsl.IXsltContextVariable> を実装します。  このクラスは、実行時に XPath クエリ式内のユーザー定義変数への参照を解決します。  このクラスのインスタンスは、カスタム クラス <xref:System.Xml.Xsl.XsltContext> の、オーバーライドされた <xref:System.Xml.Xsl.XsltContext.ResolveVariable%2A> メソッドによって作成され、返されます。  
+  
+ コード コメントでは、クラスのメンバーを示しています。  
+  
+ [!code-csharp[XPathExtensionFunctions#4](../../../../samples/snippets/csharp/VS_Snippets_Data/xpathextensionfunctions/cs/xpathextensionfunctions.cs#4)]
+ [!code-vb[XPathExtensionFunctions#4](../../../../samples/snippets/visualbasic/VS_Snippets_Data/xpathextensionfunctions/vb/xpathextensionfunctions.vb#4)]  
+  
+ 前のクラス定義がスコープ内にある次のコードでは、カスタム関数を使用して `Tasks.xml` ドキュメントの要素内の文字をカウントします。  コード コメントでは、カスタム関数をコンパイルし、それを `Tasks.xml` ドキュメントに対して実行するコードについて説明しています。  
+  
+ [!code-csharp[XPathExtensionFunctions#1](../../../../samples/snippets/csharp/VS_Snippets_Data/xpathextensionfunctions/cs/xpathextensionfunctions.cs#1)]
+ [!code-vb[XPathExtensionFunctions#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/xpathextensionfunctions/vb/xpathextensionfunctions.vb#1)]  
+  
+ この例では、次の XML データを使用しています。  
+  
+ [!code-xml[XPathExtensionFunctions#5](../../../../samples/snippets/xml/VS_Snippets_Data/xpathextensionfunctions/XML/tasks.xml#5)]
\ No newline at end of file
diff --git a/docs/standard/data/xml/using-the-xslcompiledtransform-class.md b/docs/standard/data/xml/using-the-xslcompiledtransform-class.md
new file mode 100644
index 00000000000..ee60d6239e4
--- /dev/null
+++ b/docs/standard/data/xml/using-the-xslcompiledtransform-class.md
@@ -0,0 +1,54 @@
+---
+title: "XslCompiledTransform クラスの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f9b074f6-d6f4-49dd-a093-df510bf0cf7b
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XslCompiledTransform クラスの使用
+<xref:System.Xml.Xsl.XslCompiledTransform> クラスは Microsoft .NET Framework XSLT プロセッサです。  このクラスは、スタイル シートをコンパイルし、XSLT 変換を実行するために使用されます。  
+  
+> [!NOTE]
+>  全体的なパフォーマンスは <xref:System.Xml.Xsl.XslCompiledTransform> クラスの方が <xref:System.Xml.Xsl.XslTransform> クラスより優れていますが、<xref:System.Xml.Xsl.XslCompiledTransform> クラスの <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドが変換で初めて呼び出されたときは、<xref:System.Xml.Xsl.XslTransform> クラスの <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドよりパフォーマンスが劣る場合があります。  これは、XSLT ファイルを読み込む前にコンパイルする必要があるためです。  詳細については、ブログの投稿「[XslCompiledTransform は XslTransform より遅い?](http://go.microsoft.com/fwlink/?LinkId=130590)」を参照してください。  
+  
+## このセクションの内容  
+ [XslCompiledTransform クラスへの入力](../../../../docs/standard/data/xml/inputs-to-the-xslcompiledtransform-class.md)  
+ 使用可能な XSLT 入力オプションについて説明します。  
+  
+ [XslCompiledTransform クラスの出力オプション](../../../../docs/standard/data/xml/output-options-on-the-xslcompiledtransform-class.md)  
+ 使用可能な XSLT 出力オプションについて説明します。  
+  
+ [XSLT 処理中の外部リソースの解決](../../../../docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md)  
+ 外部リソースを解決するための <xref:System.Xml.XmlResolver> クラスの使用について説明します。  
+  
+ [XSLT スタイル シートの拡張](../../../../docs/standard/data/xml/extending-xslt-style-sheets.md)  
+ XSLT の拡張機能のサポートについて説明します。  
+  
+|||  
+|-|-|  
+|[XSLT エラーの解決](../../../../docs/standard/data/xml/recoverable-xslt-errors.md)|W3C \(World Wide Web Consortium\) 勧告『XSLT 1.0』で許可されている随意動作を示し、<xref:System.Xml.Xsl.XslCompiledTransform> クラスによるこれらの動作の処理方法を説明します。|  
+|[方法 : ノード フラグメントを変換する](../../../../docs/standard/data/xml/how-to-transform-a-node-fragment.md)|ノード フラグメントの変換方法を説明します。|  
+  
+## 関連項目  
+ [XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)  
+ <xref:System.Xml.Xsl.XslTransform> クラスからコードを移行する方法について説明します。  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XsltSettings>   
+ <xref:System.Xml.Xsl.XsltMessageEncounteredEventArgs>
\ No newline at end of file
diff --git a/docs/standard/data/xml/validating-an-xml-document-in-the-dom.md b/docs/standard/data/xml/validating-an-xml-document-in-the-dom.md
new file mode 100644
index 00000000000..bfd54482576
--- /dev/null
+++ b/docs/standard/data/xml/validating-an-xml-document-in-the-dom.md
@@ -0,0 +1,96 @@
+---
+title: "DOM における XML ドキュメントの検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2c61c920-d0f8-4c72-bfcc-6524570f3060
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# DOM における XML ドキュメントの検証
+既定では、<xref:System.Xml.XmlDocument> クラスは、ドキュメント オブジェクト モデル \(DOM\) 内の XML ドキュメントを XML スキーマ定義言語 \(XSD\) スキーマまたはドキュメント型定義 \(DTD\) に対して検証しません。XML が整形式であることだけが検証されます。  
+  
+ DOM 内の XML を検証するには、スキーマ検証型 <xref:System.Xml.XmlReader> を <xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Load%2A> メソッドに渡して、DOM への読み込み時に XML を検証するか、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して、まだ未検証の DOM 内の XML ドキュメントを検証することができます。  
+  
+## DOM への読み込み時の XML ドキュメントの検証  
+ 検証型 <xref:System.Xml.XmlReader> が <xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Load%2A> メソッドに渡されると、<xref:System.Xml.XmlDocument> クラスは DOM への読み込み時に XML データを検証します。  
+  
+ 検証が正常に終了すると、スキーマの既定値が適用され、必要に応じてテキスト値がアトミック値に変換され、型情報が検証済みの情報項目に関連付けられます。  その結果、以前の型指定されていない XML データは、型指定された XML データに置き換わります。  
+  
+### XML スキーマ検証型 XmlReader の作成  
+ XML スキーマ検証型 <xref:System.Xml.XmlReader> を作成するには、次の手順を実行します。  
+  
+1.  新しい <xref:System.Xml.XmlReaderSettings> インスタンスを作成します。  
+  
+2.  XML スキーマを <xref:System.Xml.XmlReaderSettings> インスタンスの <xref:System.Xml.XmlReaderSettings.Schemas%2A> プロパティに追加します。  
+  
+3.  `Schema` を <xref:System.Xml.XmlReaderSettings.ValidationType%2A> として指定します。  
+  
+4.  オプションとして、検証中に検出したスキーマ検証エラーおよび警告を処理する <xref:System.Xml.XmlReaderSettings.ValidationFlags%2A> と <xref:System.Xml.XmlReaderSettings.ValidationEventHandler> を指定します。  
+  
+5.  最後に、<xref:System.Xml.XmlReaderSettings> オブジェクトを、スキーマ検証型 <xref:System.Xml.XmlReader> を作成する <xref:System.Xml.XmlReader> クラスの <xref:System.Xml.XmlReader.Create%2A> メソッドに、XML ドキュメントと共に渡します。  
+  
+### 例  
+ 次のコード サンプルでは、スキーマ検証型 <xref:System.Xml.XmlReader> が DOM に読み込まれた XML データを検証します。  無効な変更を加えられた後、XML ドキュメントが再検証され、スキーマ検証エラーが発生します。  最後に、エラーの 1 つが修正された後、XML ドキュメントの一部が部分的に検証されます。  
+  
+ [!code-cpp[XmlDocumentValidation.Load#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlDocumentValidation.Load/CPP/XmlDocumentValidationExample.cpp#1)]
+ [!code-csharp[XmlDocumentValidation.Load#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlDocumentValidation.Load/CS/XmlDocumentValidationExample.cs#1)]
+ [!code-vb[XmlDocumentValidation.Load#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlDocumentValidation.Load/VB/XmlDocumentValidationExample.vb#1)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+ DOM への読み込み時に XML データを検証する場合は、以下を検討します。  
+  
+-   上の例では、無効な型が見つかるたびに <xref:System.Xml.XmlReaderSettings.ValidationEventHandler> が呼び出されます。  検証を行う <xref:System.Xml.XmlReader> で <xref:System.Xml.XmlReaderSettings.ValidationEventHandler> を設定しなかった場合は、<xref:System.Xml.XmlDocument.Load%2A> を呼び出したときに属性や要素の型が検証スキーマで指定されている型と一致しないと、<xref:System.Xml.Schema.XmlSchemaValidationException> がスローされます。  
+  
+-   XML ドキュメントが既定値を定義した関連付けられたスキーマと共に <xref:System.Xml.XmlDocument> オブジェクトに読み込まれる場合、<xref:System.Xml.XmlDocument> は、これらの既定値があたかも XML ドキュメント内にあるかのように扱います。  これは、スキーマから既定値を得た要素に対して <xref:System.Xml.XmlReader.IsEmptyElement%2A> プロパティは常に `false` を返すことを意味します。  XML ドキュメント内で空要素として書かれている場合も同様です。  
+  
+## DOM における XML ドキュメントの検証  
+ <xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドは、DOM に読み込まれた XML データを <xref:System.Xml.XmlDocument> オブジェクトの <xref:System.Xml.XmlDocument.Schemas%2A> プロパティに対して検証します。  検証が正常に終了すると、スキーマの既定値が適用され、必要に応じてテキスト値がアトミック値に変換され、型情報が検証済みの情報項目に関連付けられます。  その結果、以前の型指定されていない XML データは、型指定された XML データに置き換わります。  
+  
+ 以下の例は、上記の「DOM への読み込み時の XML ドキュメントの検証」の例に似ています。  この例では、XML ドキュメントは DOM への読み込み時には検証されませんが、DOM への読み込み後に、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドを使用して検証されます。  <xref:System.Xml.XmlDocument.Validate%2A> メソッドは XML ドキュメントを <xref:System.Xml.XmlDocument> の <xref:System.Xml.XmlDocument.Schemas%2A> プロパティに含まれている XML スキーマに対して検証します。  その後、無効な変更を加えられた後、XML ドキュメントが再検証され、スキーマ検証エラーが発生します。  最後に、エラーの 1 つが修正された後、XML ドキュメントの一部が部分的に検証されます。  
+  
+ [!code-csharp[XmlDocumentValidation.Validate#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlDocumentValidation.Validate/CS/XmlDocumentValidationExample.cs#1)]
+ [!code-vb[XmlDocumentValidation.Validate#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlDocumentValidation.Validate/VB/XmlDocumentValidationExample.vb#1)]  
+  
+ この例は入力として、上記の「DOM への読み込み時の XML ドキュメントの検証」で参照されている `contosoBooks.xml` ファイルと `contosoBooks.xsd` ファイルを使用します。  
+  
+## 検証エラーおよび警告の処理  
+ XML スキーマ検証エラーは、DOM に読み込まれる XML データの検証時に報告されます。  XML データ読み込み時の検証中またはまだ未検証の XML ドキュメントの検証時に検出されたスキーマ検証エラーのすべてについて通知されます。  
+  
+ 検証エラーは <xref:System.Xml.Schema.ValidationEventHandler> によって処理されます。  <xref:System.Xml.Schema.ValidationEventHandler> が <xref:System.Xml.XmlReaderSettings> インスタンスに割り当てられているか、<xref:System.Xml.XmlDocument> クラスの <xref:System.Xml.XmlDocument.Validate%2A> メソッドに渡されている場合、<xref:System.Xml.Schema.ValidationEventHandler> がスキーマ検証エラーを処理します。それ以外の場合は、スキーマ検証エラーの検出時に <xref:System.Xml.Schema.XmlSchemaValidationException> が発生します。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.ValidationEventHandler> がプロセスを停止する例外を生成しない限り、スキーマ検証エラーが発生しても XML データは DOM に読み込まれます。  
+>   
+>  <xref:System.Xml.Schema.XmlSchemaValidationFlags> フラグが <xref:System.Xml.XmlReaderSettings> オブジェクトに指定されていない場合、スキーマ検証警告は報告されません。  
+  
+ <xref:System.Xml.Schema.ValidationEventHandler> を説明する例については、上記の「DOM への読み込み時の XML ドキュメントの検証」と「DOM における XML ドキュメントの検証」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XmlReader>   
+ <xref:System.Xml.Schema.ValidationEventHandler>   
+ <xref:System.Xml.XmlReaderSettings>   
+ [DOM モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-dom-model.md)   
+ [XML スキーマの使用](../../../../docs/standard/data/xml/working-with-xml-schemas.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/white-space-and-significant-white-space-handling-when-loading-the-dom.md b/docs/standard/data/xml/white-space-and-significant-white-space-handling-when-loading-the-dom.md
new file mode 100644
index 00000000000..acd5039d0b7
--- /dev/null
+++ b/docs/standard/data/xml/white-space-and-significant-white-space-handling-when-loading-the-dom.md
@@ -0,0 +1,30 @@
+---
+title: "DOM を読み込むときの空白および有意の空白の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 1b141a0a-50d8-4ebd-83cd-a84449bb22b2
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# DOM を読み込むときの空白および有意の空白の処理
+ドキュメントを読み込むときには、空白を保持するオプションを設定して、ドキュメント ツリーに **XmlWhitespace** ノードを作成できます。  空白ノードを作成するには、**PreserveWhitespace** プロパティを true に設定します。  このプロパティが既定の **false** に設定されている場合、空白ノードは作成されません。  **PreserveWhitespace** フラグの設定に関係なく、有意の空白ノードは常に保持され、そのデータを表す **XmlSignificantWhitespace** ノードが常にメモリ内に作成されます。  
+  
+ ドキュメントがリーダーから読み込まれた場合は、**XmlTextReader** の **WhitespaceHandling** プロパティが **WhitespaceHandling.None** に設定されていない場合にのみ、**XmlDocument** クラスの **PreserveWhitespace** フラグ プロパティの設定が **XmlWhitespace** ノードの作成に影響を及ぼします。  リーダーの **WhitespaceHandling** プロパティの値の方が **XmlDocument** のこのフラグの設定より優先されます。  **XmlSignificantWhitespace** の詳細については、「[XmlSignificantWhitespace クラス](frlrfSystemXmlXmlSignificantWhitespaceClassTopic)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/working-with-xml-schemas.md b/docs/standard/data/xml/working-with-xml-schemas.md
new file mode 100644
index 00000000000..f741e873fca
--- /dev/null
+++ b/docs/standard/data/xml/working-with-xml-schemas.md
@@ -0,0 +1,50 @@
+---
+title: "XML スキーマの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: bbbcc70c-bf9a-4f6a-af72-1bab5384a187
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML スキーマの使用
+XML ドキュメントの構造、その要素間のリレーションシップ、データ型、および内容の制約を定義するには、ドキュメント型定義 \(DTD: Document Type Definition\) または XML スキーマ定義言語 \(XSD\) スキーマを使用します。  XML ドキュメントは、W3C \(World Wide Web Consortium\) 勧告『Extensible Markup Language \(XML\) 1.0』で定義されている構文要件をすべて満たしている場合には整形式と見なされますが、整形式であると同時に DTD またはスキーマに定義されている制約に準拠していなければ有効とは見なされません。  したがって、有効な XML ドキュメントはすべて整形式ですが、整形式の XML ドキュメントがすべて有効であるとは限りません。  
+  
+ XML の詳細については、W3C 勧告『[XML 1.0](http://go.microsoft.com/fwlink/?linkid=7269)』を参照してください。  XML スキーマの詳細については、W3C 勧告『[XML Schema Part 1: Structures](http://go.microsoft.com/fwlink/?linkid=48881)』および W3C 勧告『[XML Schema Part 2: Datatypes](http://go.microsoft.com/fwlink/?linkid=17392)』を参照してください。  
+  
+## このセクションの内容  
+ [XML スキーマ オブジェクト モデル \(SOM\)](../../../../docs/standard/data/xml/xml-schema-object-model-som.md)  
+ <xref:System.Xml.Schema?displayProperty=fullName> 名前空間のスキーマ オブジェクト モデル \(SOM\) について説明します。SOM は、ファイルからスキーマ定義言語 \(XSD\) スキーマを読み取ったり、プログラムを使用してメモリ内にスキーマを作成したりできる一連のクラスを提供します。  
+  
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)  
+ <xref:System.Xml.Schema.XmlSchemaSet> クラスについて説明します。このクラスは、XSD スキーマを格納または検証できるキャッシュです。  
+  
+ [XmlSchemaValidator のプッシュ ベースの検証](../../../../docs/standard/data/xml/xmlschemavalidator-push-based-validation.md)  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスについて説明します。このクラスは、プッシュ ベース方式で、XSD スキーマを基準として XML データを検証する、効率的かつ高性能なしくみを提供します。  
+  
+ [XML スキーマの推論](../../../../docs/standard/data/xml/inferring-an-xml-schema.md)  
+ <xref:System.Xml.Schema.XmlSchemaInference> クラスを使用して XML ドキュメントの構造から XSD スキーマを推論する方法を説明します。  
+  
+## 関連項目  
+ <xref:System.Xml.Schema.XmlSchemaSet> &#124; <xref:System.Xml.Schema.XmlSchemaInference> &#124; <xref:System.Xml.XmlReader>  
+  
+## 関連項目  
+ [DOM における XML ドキュメントの検証](../../../../docs/standard/data/xml/validating-an-xml-document-in-the-dom.md)  
+ ドキュメント オブジェクト モデル \(DOM\) の XML を検証する方法を説明します。  検証できる XML は、DOM に読み込まれている XML か、または事前に検証されていない DOM の XML ドキュメントです。  
+  
+ [XPathNavigator を使用したスキーマ検証](../../../../docs/standard/data/xml/schema-validation-using-xpathnavigator.md)  
+ <xref:System.Xml.XPath.XPathNavigator> クラスを使用して操作中および編集中の XML を検証する方法を説明します。
\ No newline at end of file
diff --git a/docs/standard/data/xml/xdr-validation-with-xmlschemacollection.md b/docs/standard/data/xml/xdr-validation-with-xmlschemacollection.md
new file mode 100644
index 00000000000..502f5524e6f
--- /dev/null
+++ b/docs/standard/data/xml/xdr-validation-with-xmlschemacollection.md
@@ -0,0 +1,169 @@
+---
+title: "XmlSchemaCollection を使用した XDR 検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 00833027-1428-4586-83c1-42f5de3323d1
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XmlSchemaCollection を使用した XDR 検証
+検証の基準とする XDR \(XML\-Data Reduced\) スキーマが **XmlSchemaCollection** に格納されている場合、そのスキーマは、**XmlSchemaCollection** に追加したときに指定された名前空間 URI に関連付けられています。  **XmlValidatingReader** は、XML ドキュメント内の名前空間 URI を、コレクション内のその URI に対応するスキーマに割り当てます。  
+  
+> [!IMPORTANT]
+>  <xref:System.Xml.Schema.XmlSchemaCollection> クラスは廃止されており、<xref:System.Xml.Schema.XmlSchemaSet> クラスに置き換えられています。  <xref:System.Xml.Schema.XmlSchemaSet> の詳細については、「[スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)」を参照してください。  
+  
+ たとえば、XML ドキュメントのルート要素が `<bookstore xmlns="urn:newbooks-schema">` の場合、スキーマを **XmlSchemaCollection** に追加するときに、そのスキーマも、次に示すように同じ名前空間を参照します。  
+  
+```  
+xsc.Add("urn:newbooks-schema", "newbooks.xdr")  
+```  
+  
+ **XmlTextReader** を受け取り、XDR スキーマ HeadCount.xdr を **XmlSchemaCollection** に追加する **XmlValidatingReader** を作成するコード サンプルを次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.Schema  
+  
+Namespace ValidationSample  
+  
+   Class Sample  
+  
+      Public Shared Sub Main()  
+         Dim tr As New XmlTextReader("HeadCount.xml")  
+         Dim vr As New XmlValidatingReader(tr)  
+  
+         vr.Schemas.Add("xdrHeadCount", "HeadCount.xdr")  
+         vr.ValidationType = ValidationType.XDR  
+         AddHandler vr.ValidationEventHandler, AddressOf ValidationHandler  
+  
+         While vr.Read()  
+            PrintTypeInfo(vr)  
+            If vr.NodeType = XmlNodeType.Element Then  
+               While vr.MoveToNextAttribute()  
+                  PrintTypeInfo(vr)  
+               End While  
+            End If  
+         End While  
+         Console.WriteLine("Validation finished")  
+      End Sub  
+      ' Main  
+  
+      Public Shared Sub PrintTypeInfo(vr As XmlValidatingReader)  
+         If Not (vr.SchemaType Is Nothing) Then  
+            If TypeOf vr.SchemaType Is XmlSchemaDatatype Or TypeOf vr.SchemaType Is XmlSchemaSimpleType Then  
+               Dim value As Object = vr.ReadTypedValue()  
+               Console.WriteLine("{0}({1},{2}):{3}", vr.NodeType, vr.Name, value.GetType().Name, value)  
+            End If  
+         End If  
+      End Sub  
+      ' PrintTypeInfo  
+  
+      Public Shared Sub ValidationHandler(sender As Object, args As ValidationEventArgs)  
+         Console.WriteLine("***Validation error")  
+         Console.WriteLine("Severity:{0}", args.Severity)  
+         Console.WriteLine("Message:{0}", args.Message)  
+      End Sub  
+      ' ValidationHandler  
+   End Class  
+   ' Sample  
+End Namespace  
+' ValidationSample  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Schema;  
+  
+namespace ValidationSample  
+{  
+   class Sample  
+   {  
+      public static void Main()  
+      {  
+         XmlTextReader tr = new XmlTextReader("HeadCount.xml");  
+         XmlValidatingReader vr = new XmlValidatingReader(tr);  
+  
+         vr.Schemas.Add("xdrHeadCount", "HeadCount.xdr");  
+         vr.ValidationType = ValidationType.XDR;  
+         vr.ValidationEventHandler += new ValidationEventHandler (ValidationHandler);  
+  
+         while(vr.Read())  
+         {  
+            PrintTypeInfo(vr);  
+            if(vr.NodeType == XmlNodeType.Element)  
+            {  
+               while(vr.MoveToNextAttribute())  
+                  PrintTypeInfo(vr);  
+            }  
+         }  
+         Console.WriteLine("Validation finished");  
+      }  
+  
+      public static void PrintTypeInfo(XmlValidatingReader vr)  
+      {  
+         if(vr.SchemaType != null)  
+         {  
+            if(vr.SchemaType is XmlSchemaDatatype || vr.SchemaType is XmlSchemaSimpleType)  
+            {  
+               object value = vr.ReadTypedValue();  
+               Console.WriteLine("{0}({1},{2}):{3}", vr.NodeType, vr.Name, value.GetType().Name, value);  
+            }  
+         }  
+      }  
+  
+      public static void ValidationHandler(object sender, ValidationEventArgs args)  
+      {  
+         Console.WriteLine("***Validation error");  
+         Console.WriteLine("\tSeverity:{0}", args.Severity);  
+         Console.WriteLine("\tMessage:{0}", args.Message);  
+      }  
+   }  
+}  
+```  
+  
+ 検証対象の入力ファイル HeadCount.xml の内容について、次に概略を示します。  
+  
+```  
+<!--Load HeadCount.xdr in SchemaCollection for Validation-->  
+<HeadCount xmlns='xdrHeadCount'>  
+   <Name>Waldo Pepper</Name>  
+   <Name>Red Pepper</Name>  
+</HeadCount>  
+```  
+  
+ 検証の基準とする XDR スキーマ ファイル HeadCount.xdr の内容について、次に概略を示します。  
+  
+```  
+<Schema xmlns="urn:schemas-microsoft-com:xml-data" xmlns:dt="urn:schemas-microsoft-com:datatypes">  
+   <ElementType name="Name" content="textOnly"/>  
+   <AttributeType name="Bldg" default="2"/>  
+   <ElementType name="HeadCount" content="eltOnly">  
+      <element type="Name"/>  
+      <attribute type="Bldg"/>  
+   </ElementType>  
+</Schema>  
+```  
+  
+## 参照  
+ <xref:System.Xml.XmlValidatingReader.ValidationType%2A>   
+ <xref:System.Xml.XmlValidatingReader.Settings%2A>   
+ [XmlSchemaCollection スキーマのコンパイル](../../../../docs/standard/data/xml/xmlschemacollection-schema-compilation.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-document-creation.md b/docs/standard/data/xml/xml-document-creation.md
new file mode 100644
index 00000000000..e2cd54d5b3e
--- /dev/null
+++ b/docs/standard/data/xml/xml-document-creation.md
@@ -0,0 +1,40 @@
+---
+title: "XML ドキュメントの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 877e9c62-b082-4bfb-bc5b-f47297eb30ef
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメントの作成
+XML ドキュメントは、2 とおりの方法で作成できます。  1 つは、パラメーターを使用せずに **XmlDocument** を作成する方法です。  もう 1 つは、**XmlDocument** の作成時に **XmlNameTable** をパラメーターとして渡す方法です。  パラメーターを使用せず、新しい空の **XmlDocument** を作成する方法を次の例に示します。  
+  
+```vb  
+Dim doc As New XmlDocument()  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+```  
+  
+ ドキュメントを作成すると、**Load** メソッドを使用することにより、文字列、ストリーム、URL、テキスト リーダー、または **XmlReader** から派生したクラスのデータを読み込むことができます。  文字列から XML を読み込む **LoadXML** メソッドという読み込みメソッドもあります。  各種の **Load** メソッドの詳細については、「[XML ドキュメントの DOM への読み込み](../../../../docs/standard/data/xml/reading-an-xml-document-into-the-dom.md)」を参照してください。  
+  
+ **XmlNameTable** というクラスがあります。  このクラスは、分解された文字列オブジェクトのテーブルです。  このテーブルを使用すると、パーサーは XML ドキュメント内で繰り返されているすべての要素名と属性名に同じ文字列オブジェクトを使用でき、効率が向上します。  **XmlNameTable** は、前述のようにドキュメントの作成時に自動的に作成され、ドキュメントの読み込み時に属性名および要素名と共に読み込まれます。  名前テーブルのあるドキュメントが既に存在し、それらの名前が別のドキュメントで役に立つ場合は、**XmlNameTable** をパラメーターとしてとる **Load** メソッドを使用して新しいドキュメントを作成できます。  このメソッドによるドキュメントの作成時には、別のドキュメントからの既存の **XmlNameTable** と、既に読み込まれているすべての属性および要素が使われます。  **XmlNameTable** を使用すると、要素名と属性名を効率的に比較できます。  **XmlNameTable** の詳細については、「[XmlNameTable によるオブジェクトの比較](../../../../docs/standard/data/xml/object-comparison-using-xmlnametable.md)」を参照してください。  リファレンスは、「[XmlNameTable メンバー](frlrfSystemXmlXmlNameTableMembersTopic)」を参照してください。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-document-object-model-dom-hierarchy.md b/docs/standard/data/xml/xml-document-object-model-dom-hierarchy.md
new file mode 100644
index 00000000000..9ddcee49a47
--- /dev/null
+++ b/docs/standard/data/xml/xml-document-object-model-dom-hierarchy.md
@@ -0,0 +1,51 @@
+---
+title: "XML ドキュメント オブジェクト モデル (DOM) の階層構造 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 9d187d4f-c76e-4223-a670-cc290783ce47
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XML ドキュメント オブジェクト モデル (DOM) の階層構造
+XML ドキュメント オブジェクト モデル \(DOM\) のクラスの階層構造を次の図に示します。クラス名に続くかっこ内の名前は、W3C \(World Wide Web Consortium\) 名です。  
+  
+ ![XML ドキュメント オブジェクト モデル &#40;DOM&#41; の階層構造](../../../../docs/standard/data/xml/media/dom-class-hierarchy.gif "Dom\_class\_hierarchy")  
+XML ドキュメント オブジェクト モデル \(DOM\) の階層構造  
+  
+ 次のクラスは **XmlNode** から継承したものではありません。  
+  
+-   **XmlImplementation**  
+  
+-   **XmlNamedNodeMap**  
+  
+-   **XmlNodeList**  
+  
+-   **XmlNodeChangedEventArgs**  
+  
+ **XmlImplementation** クラスは、XML ドキュメントを作成するために使われます。  詳細については、「[XML ドキュメントの作成](../../../../docs/standard/data/xml/xml-document-creation.md)」を参照してください。  
+  
+ **XmlNamedNodeMap** クラスは、順序付けられていないノード セットを処理します。  詳細については、「[名前またはインデックスによる順序付けられていないノードの取得](../../../../docs/standard/data/xml/unordered-node-retrieval-by-name-or-index.md)」を参照してください。  
+  
+ **XmlNodeList** クラスは、順序付けられたノード リストを処理します。  詳細については、「[インデックスによる順序付けられたノードの取得](../../../../docs/standard/data/xml/ordered-node-retrieval-by-index.md)」を参照してください。  
+  
+ **XmlNodeChangedEventArgs** クラスは、**XmlDocument** に登録されたイベント ハンドラーを処理します。  詳細については、「[XmlNodeChangedEventArgs による XML ドキュメントのイベント処理](../../../../docs/standard/data/xml/event-handling-in-an-xml-document-using-the-xmlnodechangedeventargs.md)」を参照してください。  
+  
+ **XmlLinkedNode** クラスは **XmlNode** から継承しています。  その目的は、**XmlNode** の **PreviousSibling** と **NextSibling** という 2 つのメソッドをオーバーライドすることです。  これらのオーバーライドされたメソッドは、前後に兄弟を持つ **XmlCharacterData**、**XmlDeclaration**、**XmlDocumentType**、**XmlElement**、**XmlEntityReference**、および **XmlProcessingInstruction** クラスによって継承され、使用されます。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-document-object-model-dom.md b/docs/standard/data/xml/xml-document-object-model-dom.md
new file mode 100644
index 00000000000..87497e29118
--- /dev/null
+++ b/docs/standard/data/xml/xml-document-object-model-dom.md
@@ -0,0 +1,90 @@
+---
+title: "XML ドキュメント オブジェクト モデル (DOM) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b5e52844-4820-47c0-a61d-de2da33e9f54
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XML ドキュメント オブジェクト モデル (DOM)
+XML ドキュメント オブジェクト モデル \(DOM\) クラスは、XML ドキュメントのメモリ内表現です。  DOM を使用すると、XML ドキュメントの読み込み、操作、および変更をプログラムから実行できます。  **XmlReader** クラスも XML を読み込めますが、非キャッシュ、前方参照専用、読み取り専用のアクセスしか実行できません。  つまり、**XmlReader** には、属性の値または要素のコンテンツを編集する機能や、ノードを挿入したり削除したりする機能はありません。  DOM の主な機能は編集です。  XML データは、通常、メモリ上では構造的に表現されますが、実際の XML データをファイルに保存したり、別のオブジェクトから取り込む場合は、直線的な形式で格納されます。  XML データの例を次に示します。  
+  
+## 入力  
+  
+```  
+<?xml version="1.0"?>  
+  <books>  
+    <book>  
+        <author>Carson</author>  
+        <price format="dollar">31.95</price>  
+        <pubdate>05/01/2001</pubdate>  
+    </book>  
+    <pubinfo>  
+        <publisher>MSPress</publisher>  
+        <state>WA</state>  
+    </pubinfo>  
+  </books>   
+```  
+  
+ この XML データが DOM 構造に読み込まれるとき、メモリがどのように構造化されるかを次の図に示します。  
+  
+ ![XML ドキュメントの構造](../../../../docs/standard/data/xml/media/xml-to-domtree.gif "XML\_To\_DOMTree")  
+XML ドキュメントの構造  
+  
+ 図中のそれぞれの円は、XML ドキュメント構造における 1 つのノードを表します。これは **XmlNode** オブジェクトと呼ばれます。  **XmlNode** オブジェクトは、DOM ツリーの基本オブジェクトです。  **XmlNode** を拡張する **XmlDocument** クラスは、たとえばドキュメントをメモリに読み込んだり、XML をファイルに保存するなど、ドキュメント全体を操作するメソッドをサポートしています。  さらに **XmlDocument** では、XML ドキュメント全体のノードを参照して操作する手段も提供されます。  **XmlNode** と **XmlDocument** は、いずれもパフォーマンスと使いやすさが向上しており、次の操作を実行するメソッドとプロパティを持っています。  
+  
+-   要素ノード、エンティティ参照ノードなど、DOM に固有のノードへのアクセスと変更。  
+  
+-   要素ノードのテキストなど、ノードに格納されている情報およびノード全体の取得。  
+  
+    > [!NOTE]
+    >  アプリケーションが DOM の提供する構造や編集機能を必要としない場合は、**XmlReader** クラスと **XmlWriter** クラスを使って XML への非キャッシュ、前方参照専用のストリーム アクセスを実行できます。  詳細については、<xref:System.Xml.XmlReader> および <xref:System.Xml.XmlWriter> を参照してください。  
+  
+ **Node** オブジェクトには、適切に定義された基本的な特性と、メソッドおよびプロパティのセットが含まれます。  オブジェクトが持つ特性のいくつかを次に示します。  
+  
+-   ノードは 1 つの親ノードを持っています。親ノードはノードの 1 つ上のノードです。  ドキュメント ルートは最上位のノードであり、ドキュメント自身とドキュメント フラグメントしか格納されていないため、親ノードを持っていないノードはドキュメント ルートだけです。  
+  
+-   ほとんどのノードは、複数の子ノードを持つことができます。子ノードは、ノードの 1 つ下のノードです。  子ノードを持つことができるノード型の一覧を次に示します。  
+  
+    -   **ドキュメント**  
+  
+    -   **DocumentFragment**  
+  
+    -   **EntityReference**  
+  
+    -   **要素**  
+  
+    -   **属性**  
+  
+     **XmlDeclaration** ノード、**Notation** ノード、**Entity** ノード、**CDATASection** ノード、**Text** ノード、**Comment** ノード、**ProcessingInstruction** ノード、**DocumentType** ノードは子ノードを持ちません。  
+  
+-   図中に **book** および **pubinfo** として同レベルに表現されているノードは兄弟です。  
+  
+ DOM の特性の 1 つは、属性の取り扱い方法にあります。  属性は、互いに親子関係や兄弟関係を持つノードではありません。  属性は要素ノードのプロパティと見なされ、名前と値ペアから構成されます。  たとえば、要素 `format="dollar` に関連付けられている `price`" という形式の XML データがある場合は、単語 `format` が名前になり、`format` 属性の値は `dollar` になります。  `format="dollar"`price ノードの  **属性を取得するには、カーソルが  要素ノード上にあるときに `price`GetAttribute メソッドを呼び出します。** 詳細については、「[DOM の属性へのアクセス](../../../../docs/standard/data/xml/accessing-attributes-in-the-dom.md)」を参照してください。  
+  
+ XML をメモリに読み込むと、ノードが作成されます。  ただし、すべてのノードが同じタイプというわけではありません。  XML の要素の規則と構文は、処理命令の規則と構文とは異なります。  したがって、さまざまなデータが読み込まれるときに、個々のノードにノード型が割り当てられます。  このノード型によって、ノードの特性と機能が決定されます。  
+  
+ メモリに生成されるノード型の詳細については、「[XML ノードの種類](../../../../docs/standard/data/xml/types-of-xml-nodes.md)」を参照してください。  ノード ツリーに作成されるオブジェクトの詳細については、「[オブジェクト階層の XML データへのマップ](../../../../docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md)」を参照してください。  
+  
+ Microsoft では、XML ドキュメントの操作を容易にするために、W3C \(World Wide Web Consortium\) DOM Level 1 および Level 2 で規定されている API を拡張しています。  W3C の標準を完全にサポートする一方で、追加のクラス、メソッド、プロパティにより、W3C の XML DOM で実現できる以上の機能が付加されています。  新しいクラスを使用すると、リレーショナル データにアクセスし、ADO.NET との同期をとりながら、データを XML として公開できます。  詳細については、「[Dataset と XmlDataDocument の同期](../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)」を参照してください。  
+  
+ DOM が最も役に立つのは、XML データをメモリに読み込み、その構造を変更したり、ノードを追加または削除したり、要素内のテキストとしてノードが保持しているデータを変更したりする場合です。  ただし、他のクラスも用意されており、シナリオによっては DOM より高速になる場合もあります。  XML に対して高速、非キャッシュ、前方参照専用のストリーム アクセスを行うには、**XmlReader** と **XmlWriter** を使用します。  カーソル モデルと **XPath** を使用したランダム アクセスが必要な場合は、**XPathNavigator** クラスを使用します。  
+  
+## 参照  
+ [XML ノードの種類](../../../../docs/standard/data/xml/types-of-xml-nodes.md)   
+ [オブジェクト階層の XML データへのマップ](../../../../docs/standard/data/xml/mapping-the-object-hierarchy-to-xml-data.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-element-and-attribute-name-verification-when-creating-new-nodes.md b/docs/standard/data/xml/xml-element-and-attribute-name-verification-when-creating-new-nodes.md
new file mode 100644
index 00000000000..14e149948c8
--- /dev/null
+++ b/docs/standard/data/xml/xml-element-and-attribute-name-verification-when-creating-new-nodes.md
@@ -0,0 +1,28 @@
+---
+title: "新しいノードの作成時における XML 要素名および属性名の検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: b489f647-a175-4659-ada4-170058bb41d0
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# 新しいノードの作成時における XML 要素名および属性名の検証
+XML ドキュメント オブジェクト モデル \(DOM\) は、新しい要素ノードまたは属性ノードを作成するときに名前の有効性を確認します。  名前に無効な文字が含まれていると、例外がスローされます。  名前が正しくエンコードされ、有効であることを保証するには、**XmlConvert** クラスを使用して名前をエンコードし、アプリケーション レベルで名前をデコードする必要があります。  **XmlWriter** には、整形式の XML を生成するための追加の処理を行うメソッドが用意されています。  
+  
+## 参照  
+ [XML ドキュメント オブジェクト モデル \(DOM\)](../../../../docs/standard/data/xml/xml-document-object-model-dom.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md b/docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md
new file mode 100644
index 00000000000..a0df35337f7
--- /dev/null
+++ b/docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md
@@ -0,0 +1,60 @@
+---
+title: "XML とリレーショナル データおよび ADO.NET との統合 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: f6ebb1a1-f2ca-49b9-92c9-0150940cf6e6
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XML とリレーショナル データおよび ADO.NET との統合
+**XmlDocument** の派生クラスである **XmlDataDocument** クラスには XML データが格納されます。  **XmlDataDocument** の利点は、リレーショナル データと階層データとを仲介できることです。  **DataSet** に連結できるのは **XmlDocument** であり、どちらのクラスも、それぞれが格納しているデータが変更されたときに、変更内容の同期をとることができます。  **DataSet** に連結した **XmlDocument** では XML をリレーショナル データと統合できるため、データ表現は XML でもリレーショナル形式でもかまいません。  両方の処理ができ、一方のデータ表現だけに制限されることもありません。  
+  
+ 2 つの形式でデータが使用できる利点は次のとおりです。  
+  
+-   XML ドキュメントの構造部分はデータセットに対応付けることができ、効率的な格納、インデックス付け、および検索ができる。  
+  
+-   リレーション形式で格納された XML データに対して、カーソル モデルを使用して、効率的な変換、検証、および移動ができる。  **XmlDocument** モデルに XML が格納されている場合よりも、リレーショナル構造の方が効率的に処理できる場合があります。  
+  
+-   **DataSet** に XML の一部を格納できる。  **XPath** または **XslTransform** を使用して、目的の要素や属性だけを **DataSet** に格納できます。  この場合は、抽出された部分的なデータに対して変更を行い、その変更を **XmlDataDocument** 内のデータに反映させることができます。  
+  
+ SQL サーバーから **DataSet** に読み込まれたデータを変換することもできます。  また、.NET Framework のクラスの形式で管理されている WinForm および WebForm のコントロールを、XML 入力ストリームからデータを読み込んだ **DataSet** に連結することもできます。  
+  
+ **XslTransform** のサポートの他に、**XmlDataDocument** は、リレーショナル データに対する **XPath** クエリと検証もサポートします。  基本的には、すべての XML サービスをリレーショナル データで利用でき、コントロールの連結やコード生成などのすべてのリレーショナル機能を XML に基づく構造化データで、XML の厳密性を損なうことなく利用できます。  
+  
+ **XmlDataDocument** は **XmlDocument** から継承されているため、W3C DOM が実装されています。  **XmlDataDocument** は、**DataSet** に関連付けられており、そのデータの一部を格納していますが、**XmlDocument** として使用する場合に制限や特別な対応が必要になることはありません。  **XmlDocument** を使用しているコードは、**XmlDataDocument** を使用する場合でも、修正せずに動作させることができます。  **DataSet** は、テーブル、列、リレーション、および制約を定義することで、データをリレーショナル形式で提示できる、スタンドアロンかつインメモリのユーザー データ ストアです。  
+  
+ XML データと **DataSet** の関係と、XML データと **XmlDataDocument** の関連との違いを次の図に示します。  
+  
+ ![XML データセット](../../../../docs/standard/data/xml/media/xmlintegrationwithrelationaldataandadodotnet.gif "xmlIntegrationWithRelationalDataAndADOdotNet")  
+  
+ この図では、XML データは **DataSet** に直接読み込むことができ、XML をリレーショナルな方法で直接操作できることが示されています。  また、XML を DOM の派生クラスである **XmlDataDocument** に読み込み、その後、**DataSet** と同期させることができることも示されています。  **DataSet** と **XmlDataDocument** は、1 つのデータ セットを基にして同期がとられているため、一方のデータ ストアのデータを変更すると、他方のストアに反映されます。  
+  
+ **XmlDataDocument** は、**XmlDocument** のすべての編集機能と移動機能を継承します。  状況によっては、XML を直接 **DataSet** に読み込む方法よりも、**XmlDataDocument** とその継承された機能を使用して **DataSet** と同期する方法の方が適している場合があります。  **DataSet** にデータを読み込む場合に、どちらの方法を採用すればよいかを判断するための条件を次の表に示します。  
+  
+|XML を DataSet に直接読み込む方がよい場合|XmlDataDocument と DataSet の同期をとる方がよい場合|  
+|---------------------------------|--------------------------------------------|  
+|**DataSet** のデータに対するクエリで、XPath よりも SQL を使用する方が簡単である。|**DataSet** のデータに対して XPath クエリが必要である。|  
+|ソース XML 内での要素の順序を保つ必要がない。|ソース XML 内での要素の順序を保つ必要がある。|  
+|要素間の空白や形式をソース XML で保持する必要がない。|空白や形式をソース XML で保持する必要がある。|  
+  
+ **DataSet** に XML を直接読み込んだり、[DataSet](../../../../docs/framework/data/adonet/dataset-datatable-dataview/loading-a-dataset-from-xml.md) から XML を書き出す方法については、「[XML からの DataSet の読み込み](../../../../docs/framework/data/adonet/dataset-datatable-dataview/writing-dataset-contents-as-xml-data.md)」と「XML データとしての DataSet の書き込み」を参照してください。  
+  
+ **XmlDataDocument** から **DataSet** にデータを読み込む方法については、「[Dataset と XmlDataDocument の同期](../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)」を参照してください。  
+  
+## 参照  
+ [DataSet での XML の使用](../../../../docs/framework/data/adonet/dataset-datatable-dataview/using-xml-in-a-dataset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-processing-options.md b/docs/standard/data/xml/xml-processing-options.md
new file mode 100644
index 00000000000..8a94842e483
--- /dev/null
+++ b/docs/standard/data/xml/xml-processing-options.md
@@ -0,0 +1,48 @@
+---
+title: "XML の処理オプション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 33ced8ee-1745-4e71-8dee-ebe70ec067c7
+caps.latest.revision: 5
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# XML の処理オプション
+XML データの処理に使用できる Microsoft テクノロジの一覧については、次の表を参照してください。  
+  
+## .NET Framework のオプション  
+  
+|**オプション**|**処理の種類**|**説明**|  
+|---------------|---------------|------------|  
+|[LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) <br /> \(<xref:System.Xml.Linq> 名前空間\)|メモリ内|-   .NET Framework の統合言語クエリ \(LINQ\) テクノロジに基づいています。<br />-   オブジェクト、リレーショナル データ、および XML データに対して SQL と同じようにクエリを利用できます。<br />-   直観的なドキュメント作成および変換機能を提供します。<br />-   このオプションは、新しいコードを記述する場合に使用します。|  
+|<xref:System.Xml.XmlReader?displayProperty=fullName>|ストリーム ベース|-   高速、非キャッシュ、前方参照専用の XML データ アクセス手段を提供します。<br />-   <xref:System.Xml.XmlReader.Create%2A?displayProperty=fullName> メソッドを使用してオブジェクトを作成し、<xref:System.Xml.XmlReaderSettings> クラスを使用して、そのオブジェクトで有効にする一連の機能を指定できます。|  
+|<xref:System.Xml.XmlWriter?displayProperty=fullName>|ストリーム ベース|-   高速、非キャッシ、前方参照専用の XML データ生成手段を提供します。<br />-   <xref:System.Xml.XmlWriter.Create%2A?displayProperty=fullName> メソッドを使用してオブジェクトを作成し、<xref:System.Xml.XmlWriterSettings> クラスを使用して、そのオブジェクトで有効にする一連の機能を指定できます。|  
+|<xref:System.Xml.XmlDocument?displayProperty=fullName>|メモリ内|-   [W3C ドキュメント オブジェクト モデル \(DOM\) 勧告の DOM Level 1 Core](http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html) および [DOM Level 2 Core](http://www.w3.org/TR/DOM-Level-2-Core/) を実装しています。<br />-   使い慣れた DOM モデルに基づくメソッドとプロパティを使用して、ノードを作成、挿入、削除、および変更できます。<br />-   このオプションは、W3C DOM を利用する既存のコードを変更する場合に使用します。|  
+|<xref:System.Xml.XPath.XPathNavigator?displayProperty=fullName>|メモリ内|-   カーソル モデルを利用する複数の編集オプションとナビゲーション機能を提供します。<br />-   XML ドキュメントを <xref:System.Xml.XPath.XPathDocument> オブジェクトまたは <xref:System.Xml.XmlDocument> オブジェクトに格納できます。<br />-   XML の読み取り専用処理で優れたパフォーマンスを発揮します。<br />-   このオプションは、WXPath クエリや XSLT 変換を使用して既存のコードを変更する場合に使用します。|  
+|<xref:System.Xml.Xsl.XslCompiledTransform>|メモリ内|-   XSL 変換を使用して XML データを変換するためのオプションを提供します。<br />-   [XSLT コンパイラ \(xsltc.exe\)](../../../../docs/standard/data/xml/xslt-compiler-xsltc-exe.md) を使用すると、プリコンパイルした変換をアプリで参照できます。|  
+  
+## Win32 オプションと COM ベースのオプション  
+  
+|**オプション**|**説明**|  
+|---------------|------------|  
+|[XmlLite](http://go.microsoft.com/fwlink/?LinkId=93723)|-   高性能 XML アプリの構築に役立つ高速、安全、非キャッシュ、前方参照専用の XML パーサー。<br />-   ダイナミック リンク ライブラリ \(DLL\) を使用できる任意の言語で動作します。C\+\+ の使用をお勧めします。|  
+|[MSXML](http://go.microsoft.com/fwlink/?LinkId=93722)|-   Windows オペレーティング システムに付属する、XML 処理のための COM ベース テクノロジ。<br />-   DOM をネイティブで実装し、XPath と XSLT をサポートしています。<br />-   SAX2 イベントベース パーサーが含まれます。|  
+  
+## 参照  
+ [DOM モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-dom-model.md)   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XSLT コンパイラ \(xsltc.exe\)](../../../../docs/standard/data/xml/xslt-compiler-xsltc-exe.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-schema-object-model-overview.md b/docs/standard/data/xml/xml-schema-object-model-overview.md
new file mode 100644
index 00000000000..0f9d94246a6
--- /dev/null
+++ b/docs/standard/data/xml/xml-schema-object-model-overview.md
@@ -0,0 +1,57 @@
+---
+title: "XML スキーマ オブジェクト モデルの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 896a1e12-5655-42c6-8cdd-89c12862b34b
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XML スキーマ オブジェクト モデルの概要
+Microsoft .NET Framework のスキーマ オブジェクト モデル \(SOM\) は豊富な機能を備えた API で、スキーマの作成、編集、および検証をプログラムで実行できます。  SOM は、ドキュメント オブジェクト モデル \(DOM\) が XML ドキュメント上で機能するのと同様に、XML スキーマ ドキュメント上で機能します。  XML スキーマ ドキュメントは有効な XML ファイルで、SOM に読み込まれると、スキーマに準拠した他の XML ドキュメントの構造および有効性に関する情報を伝えます。  
+  
+ スキーマは、特定のスキーマに対して XML ドキュメントの構造またはモデルを指定することによって XML ドキュメントのクラスを定義する、XML ドキュメントです。  スキーマは、XML ドキュメントの内容に対する制約を指定し、特定のスキーマと照合して有効と見なされるように、規定に準拠した XML ドキュメントが従う表現形式 \(規則または文法\) を記述します。  XML ドキュメントの検証は、ドキュメントがスキーマによって指定された文法に準拠しているかどうかを確認するプロセスです。  
+  
+ .NET Framework の SOM API を使用すると、スキーマの作成、編集、および検証に関する次の操作を行うことができます。  
+  
+-   有効なスキーマをファイルから読み込み、ファイルへ保存します。  
+  
+-   厳密に型指定されたクラスを使用し、メモリ内にスキーマを作成します。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaSet> クラスと対話し、スキーマのキャッシュ、コンパイル、および取得を行います。  
+  
+-   <xref:System.Xml.XmlReader.Create%2A> クラスの <xref:System.Xml.XmlReader> メソッドと対話し、スキーマを基準として XML インスタンス ドキュメントを検証します。  
+  
+-   スキーマの作成および保守に使用するエディターを作成します。  
+  
+-   XML インスタンス ドキュメントの検証で使用するためにコンパイルと保存が可能なスキーマを動的に編集します。  
+  
+## スキーマ オブジェクト モデル  
+ SOM は、XML スキーマの要素に相当する <xref:System.Xml.Schema?displayProperty=fullName> 名前空間の広範囲にわたるクラスで構成されています。  たとえば、`<xsd:schema>...</xsd:schema>` 要素は <xref:System.Xml.Schema.XmlSchema?displayProperty=fullName> クラスにマップしているため、`<xsd:schema/>` 要素に格納できる情報はすべて <xref:System.Xml.Schema.XmlSchema> クラスを使って表すことができます。  同様に、`<xsd:element>...</xsd:element>` 要素と `<xsd:attribute>...</xsd:attribute>` 要素は、それぞれ <xref:System.Xml.Schema.XmlSchemaElement?displayProperty=fullName> クラスと <xref:System.Xml.Schema.XmlSchemaAttribute?displayProperty=fullName> クラスにマップしています。  このマッピングは、次の図に示す <xref:System.Xml.Schema> 名前空間の XML スキーマ オブジェクト モデルを作成する XML スキーマのすべての要素に適用されます。  
+  
+ ![System.Xml.Schema オブジェクト モデル](../../../../docs/standard/data/xml/media/xmlschemaobjmodeloverview.png "XMLSchemaObjModelOverview")  
+  
+ <xref:System.Xml.Schema> 名前空間の各クラスの詳細については、.NET Framework クラス ライブラリの <xref:System.Xml.Schema> 名前空間のリファレンス ドキュメントを参照してください。  
+  
+## 参照  
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)   
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)   
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)   
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)   
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)   
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [スキーマのコンパイル後の情報セット](../../../../docs/standard/data/xml/post-schema-compilation-infoset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-schema-object-model-som.md b/docs/standard/data/xml/xml-schema-object-model-som.md
new file mode 100644
index 00000000000..4de66cf9d50
--- /dev/null
+++ b/docs/standard/data/xml/xml-schema-object-model-som.md
@@ -0,0 +1,46 @@
+---
+title: "XML スキーマ オブジェクト モデル (SOM) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a897a599-ffd1-43f9-8807-e58c8a7194cd
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML スキーマ オブジェクト モデル (SOM)
+XML スキーマは、XML ドキュメント準拠の構造を作成し検証する、強力な複合ツールです。  リレーショナル データベースのデータ モデリングと同様に、スキーマでは XML ドキュメントの構造を定義する方法を提供しています。これは、ドキュメントで使用する要素と、これらの要素に固有のスキーマを有効にするために準拠する構造や型を指定することによって実現します。  
+  
+ スキーマ オブジェクト モデル \(SOM\) は、クラスのセットを <xref:System.Xml.Schema?displayProperty=fullName> 名前空間に提供し、それによってファイルからスキーマを読み取ったり、プログラムを使用してスキーマをメモリ内に作成したりできるようになります。  その後、スキーマの走査、編集、コンパイル、検証、またはファイルへの書き込みが可能になります。  
+  
+## このセクションの内容  
+ [XML スキーマ オブジェクト モデルの概要](../../../../docs/standard/data/xml/xml-schema-object-model-overview.md)  
+ スキーマ オブジェクト モデル \(SOM\) とその機能およびクラスについて説明します。  
+  
+ [XML スキーマの読み取りと書き込み](../../../../docs/standard/data/xml/reading-and-writing-xml-schemas.md)  
+ ファイルまたは他のソースから XML スキーマの読み取りおよび書き込みを行う方法を説明します。  
+  
+ [XML スキーマの作成](../../../../docs/standard/data/xml/building-xml-schemas.md)  
+ <xref:System.Xml.Schema?displayProperty=fullName> 名前空間のクラスを使用して、XML スキーマをメモリ内に作成する方法を説明します。  
+  
+ [XML スキーマの走査](../../../../docs/standard/data/xml/traversing-xml-schemas.md)  
+ XML スキーマを走査して、SOM に格納されている要素、属性、および型にアクセスする方法を説明します。  
+  
+ [XML スキーマの編集](../../../../docs/standard/data/xml/editing-xml-schemas.md)  
+ XML スキーマを編集する方法を説明します。  
+  
+ [XML スキーマのインクルードまたはインポート](../../../../docs/standard/data/xml/including-or-importing-xml-schemas.md)  
+ 他の XML スキーマをインクルードまたはインポートして、インクルードまたはインポートするスキーマの構造を補足する方法を説明します。
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemacollection.md b/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemacollection.md
new file mode 100644
index 00000000000..6dfcb9561f2
--- /dev/null
+++ b/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemacollection.md
@@ -0,0 +1,221 @@
+---
+title: "XmlSchemaCollection を使用した XML スキーマ (XSD) 検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ad0b5717-3d32-41ad-a4d7-072c3e492b82
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XmlSchemaCollection を使用した XML スキーマ (XSD) 検証
+<xref:System.Xml.Schema.XmlSchemaCollection> を使用して、XML スキーマ定義言語 \(XSD\) スキーマを基準として XML ドキュメントを検証できます。  <xref:System.Xml.Schema.XmlSchemaCollection> は、検証を行うたびにスキーマをメモリに読み込まなくてもいいように、スキーマをコレクションに格納することによってパフォーマンスの向上を図ります。  スキーマがスキーマ コレクション内にある場合、コレクション内のスキーマの位置を特定するには `schemaLocation` 属性を使用します。  
+  
+> [!IMPORTANT]
+>  <xref:System.Xml.Schema.XmlSchemaCollection> クラスは廃止されており、<xref:System.Xml.Schema.XmlSchemaSet> クラスに置き換えられています。  <xref:System.Xml.Schema.XmlSchemaSet> の詳細については、「[スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)」を参照してください。  
+  
+ データ ファイルのルート要素の例を次に示します。  
+  
+```  
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"  
+    xmlns="urn:bookstore-schema"  
+    elementFormDefault="qualified"  
+    targetNamespace="urn:bookstore-schema">  
+```  
+  
+ この例では、`targetNamespace` 属性の値として、スキーマを <xref:System.Xml.Schema.XmlSchemaCollection> に追加するときに使用される名前空間と同じ `urn:bookstore-schema` が指定されています。  
+  
+ XML スキーマを <xref:System.Xml.Schema.XmlSchemaCollection> に追加するコード サンプルを次に示します。  
+  
+```vb  
+Dim xsc As New XmlSchemaCollection()  
+' XML Schema.  
+xsc.Add("urn:bookstore-schema", schema)   
+reader = New XmlTextReader(filename)  
+vreader = New XmlValidatingReader(reader)  
+vreader.Schemas.Add(xsc)  
+```  
+  
+```csharp  
+XmlSchemaCollection xsc = new XmlSchemaCollection();  
+// XML Schema.  
+xsc.Add("urn:bookstore-schema", schema);  
+reader = new XmlTextReader (filename);  
+vreader = new XmlValidatingReader (reader);  
+vreader.Schemas.Add(xsc);  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaCollection> の <xref:System.Xml.Schema.XmlSchemaCollection.Add%2A> メソッドで `namespaceURI` プロパティを追加する場合、一般的に、`targetNamespace` 属性が使用されます。  スキーマを <xref:System.Xml.Schema.XmlSchemaCollection> に追加する前に、null 参照を指定することもできます。  名前空間が関連付けられていないスキーマに対しては、空の文字列 \(""\) を使用する必要があります。  <xref:System.Xml.Schema.XmlSchemaCollection> には、名前空間が関連付けられていないスキーマを 1 つだけ含めることができます。  
+  
+ XML スキーマ HeadCount.xsd を <xref:System.Xml.Schema.XmlSchemaCollection> に追加し、HeadCount.xml を検証するコード サンプルを次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.Schema  
+  
+Namespace ValidationSample  
+  
+   Class Sample  
+  
+      Public Shared Sub Main()  
+         Dim tr As New XmlTextReader("HeadCount.xml")  
+         Dim vr As New XmlValidatingReader(tr)  
+  
+         vr.Schemas.Add("xsdHeadCount", "HeadCount.xsd")  
+         vr.ValidationType = ValidationType.Schema  
+         AddHandler vr.ValidationEventHandler, AddressOf ValidationHandler  
+  
+         While vr.Read()  
+         End While  
+         Console.WriteLine("Validation finished")  
+      End Sub  
+      ' Main  
+  
+      Public Shared Sub ValidationHandler(sender As Object, args As ValidationEventArgs)  
+         Console.WriteLine("***Validation error")  
+         Console.WriteLine("Severity:{0}", args.Severity)  
+         Console.WriteLine("Message:{0}", args.Message)  
+      End Sub  
+      ' ValidationHandler  
+   End Class  
+   ' Sample  
+End Namespace  
+' ValidationSample  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Schema;  
+  
+namespace ValidationSample  
+{  
+   class Sample  
+   {  
+      public static void Main()  
+      {  
+         XmlTextReader tr = new XmlTextReader("HeadCount.xml");  
+         XmlValidatingReader vr = new XmlValidatingReader(tr);  
+  
+         vr.Schemas.Add("xsdHeadCount", "HeadCount.xsd");  
+         vr.ValidationType = ValidationType.Schema;  
+         vr.ValidationEventHandler += new ValidationEventHandler (ValidationHandler);  
+  
+         while(vr.Read());  
+         Console.WriteLine("Validation finished");  
+      }  
+  
+      public static void ValidationHandler(object sender, ValidationEventArgs args)  
+      {  
+         Console.WriteLine("***Validation error");  
+         Console.WriteLine("\tSeverity:{0}", args.Severity);  
+         Console.WriteLine("\tMessage  :{0}", args.Message);  
+      }  
+   }  
+}  
+```  
+  
+ 検証対象の入力ファイル HeadCount.xml の内容について、次に概略を示します。  
+  
+```  
+<!--Load HeadCount.xsd in SchemaCollection for Validation-->  
+<hc:HeadCount xmlns:hc='xsdHeadCount'>  
+   <Name>Waldo Pepper</Name>  
+   <Name>Red Pepper</Name>  
+</hc:HeadCount>  
+```  
+  
+ 検証の基準とする XML スキーマ ファイル HeadCount.xsd の内容について、次に概略を示します。  
+  
+```  
+<xs:schema xmlns="xsdHeadCount" targetNamespace="xsdHeadCount" xmlns:xs="http://www.w3.org/2001/XMLSchema">  
+   <xs:element name='HeadCount' type="HEADCOUNT"/>  
+   <xs:complexType name="HEADCOUNT">  
+      <xs:sequence>  
+         <xs:element name='Name' type='xs:string' maxOccurs='unbounded'/>  
+      </xs:sequence>  
+      <xs:attribute name='division' type='xs:int' use='optional' default='8'/>  
+   </xs:complexType>  
+</xs:schema>  
+```  
+  
+ <xref:System.Xml.XmlTextReader> を受け取る <xref:System.Xml.XmlValidatingReader> を作成するコード サンプルを次に示します。  XML スキーマ sample4.xsd を基準として、入力ファイル sample4.xml を検証します。  
+  
+```vb  
+Dim tr As New XmlTextReader("sample4.xml")  
+Dim vr As New XmlValidatingReader(tr)  
+vr.ValidationType = ValidationType.Schema  
+vr.Schemas.Add("datatypesTest", "sample4.xsd")  
+AddHandler vr.ValidationEventHandler, AddressOf ValidationCallBack  
+While vr.Read()  
+   Console.WriteLine("NodeType: {0} NodeName: {1}", vr.NodeType, vr.Name)  
+End While  
+```  
+  
+```csharp  
+XmlTextReader tr = new XmlTextReader("sample4.xml");  
+XmlValidatingReader vr = new XmlValidatingReader(tr);  
+vr.ValidationType = ValidationType.Schema;  
+        vr.Schemas.Add("datatypesTest", "sample4.xsd");  
+vr.ValidationEventHandler += new ValidationEventHandler(ValidationCallBack);  
+while(vr.Read()) {  
+    Console.WriteLine("NodeType: {0} NodeName: {1}", vr.NodeType, vr.Name);  
+    }  
+```  
+  
+ 検証対象とする入力ファイル sample4.xml の内容について、次に概略を示します。  
+  
+```  
+<datatypes xmlns="datatypesTest">  
+    <number>  
+        <number_1>123</number_1>  
+    </number>  
+</datatypes>  
+```  
+  
+ 検証の基準とする XML スキーマ ファイル sample4.xsd の内容について、次に概略を示します。  
+  
+```  
+<xs:schema   
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"   
+    xmlns:tns="datatypesTest"   
+    targetNamespace="datatypesTest"  
+    elementFormDefault="qualified">  
+  
+<xs:element name = "datatypes">  
+  <xs:complexType>  
+    <xs:all>  
+        <xs:element name="number">  
+            <xs:complexType>  
+                <xs:sequence>  
+                    <xs:element name="number_1" type="xs:decimal" maxOccurs="unbounded"/>  
+                </xs:sequence>  
+            </xs:complexType>  
+        </xs:element>  
+    </xs:all>  
+  </xs:complexType>  
+</xs:element>  
+</xs:schema>  
+```  
+  
+## 参照  
+ <xref:System.Xml.XmlParserContext>   
+ <xref:System.Xml.XmlValidatingReader.ValidationEventHandler?displayProperty=fullName>   
+ <xref:System.Xml.XmlValidatingReader.Schemas%2A?displayProperty=fullName>   
+ [XmlSchemaCollection スキーマのコンパイル](../../../../docs/standard/data/xml/xmlschemacollection-schema-compilation.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemaset.md b/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemaset.md
new file mode 100644
index 00000000000..09c8af128ad
--- /dev/null
+++ b/docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemaset.md
@@ -0,0 +1,53 @@
+---
+title: "XmlSchemaSet による XML スキーマ (XSD) 検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 359b10eb-ec05-4cc6-ac96-c2b060afc4de
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XmlSchemaSet による XML スキーマ (XSD) 検証
+XML ドキュメントは、<xref:System.Xml.Schema.XmlSchemaSet> の XML スキーマ定義言語 \(XSD\) スキーマを基準として検証できます。  
+  
+## XML ドキュメントの検証  
+ XML ドキュメントは、<xref:System.Xml.XmlReader> クラスの <xref:System.Xml.XmlReader.Create%2A> メソッドを使用して検証します。  XML ドキュメントを検証するには、XML ドキュメントの検証に使用する XML スキーマ定義言語 \(XSD\) スキーマを持つ <xref:System.Xml.XmlReaderSettings> オブジェクトを作成します。  
+  
+> [!NOTE]
+>  [LINQ to XML](../../../../ocs/visual-basic/programming-guide/concepts/linq/linq-to-xml.md) を使用する際、<xref:System.Xml.Schema> 名前空間に含まれる拡張メソッドによって、XSD ファイルを基準として XML ツリーを簡単に検証することができます。  LINQ to XML を使用した XML ドキュメントの検証に関する詳細については、「[How to: Validate Using XSD](../Topic/How%20to:%20Validate%20Using%20XSD%20\(LINQ%20to%20XML\).md)」を参照してください。  
+  
+ 独立したスキーマまたはスキーマのセット \(<xref:System.Xml.Schema.XmlSchemaSet> を使用\) を <xref:System.Xml.Schema.XmlSchemaSet> に追加するには、そのどちらかを <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドにパラメーターとして渡します。  ドキュメントを検証する際には、ドキュメントの対象名前空間がスキーマ セット内のスキーマの対象名前空間と一致している必要があります。  
+  
+ XML ドキュメントのサンプルを次に示します。  
+  
+ [!code-xml[XSDInference Examples#5](../../../../samples/snippets/xml/VS_Snippets_Data/XSDInference Examples/XML/contosoBooks.xml#5)]  
+  
+ XML ドキュメントのサンプルを検証するスキーマを次に示します。  
+  
+ [!code-xml[XSDInference Examples#6](../../../../samples/snippets/xml/VS_Snippets_Data/XSDInference Examples/XML/contosoBooks.xsd#6)]  
+  
+ 以下のコード サンプルでは、<xref:System.Xml.XmlReaderSettings> オブジェクトの <xref:System.Xml.Schema.XmlSchemaSet> <xref:System.Xml.XmlReaderSettings.Schemas%2A> プロパティに上記のスキーマが追加されます。  <xref:System.Xml.XmlReaderSettings> オブジェクトは、上記の XML ドキュメントを検証する <xref:System.Xml.XmlReader> オブジェクトの <xref:System.Xml.XmlReader.Create%2A> メソッドにパラメーターとして渡されます。  
+  
+ <xref:System.Xml.XmlReaderSettings> オブジェクトの <xref:System.Xml.XmlReaderSettings.ValidationType%2A> プロパティが `Schema` に設定されて、<xref:System.Xml.XmlReader> オブジェクトの <xref:System.Xml.XmlReader.Create%2A> メソッドによる XML ドキュメントの検証が行われます。  XML のドキュメントおよびスキーマの検証中に発見されたエラーによって発生する <xref:System.Xml.Schema.XmlSeverityType> イベントまたは <xref:System.Xml.Schema.XmlSeverityType> イベントを処理するために、<xref:System.Xml.XmlReaderSettings> オブジェクトに <xref:System.Xml.Schema.ValidationEventHandler> を追加します。  
+  
+ [!code-cpp[XmlSchemaSetOverall Example#1](../../../../samples/snippets/cpp/VS_Snippets_Data/XmlSchemaSetOverall Example/CPP/xmlschemasetexample.cpp#1)]
+ [!code-csharp[XmlSchemaSetOverall Example#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaSetOverall Example/CS/xmlschemasetexample.cs#1)]
+ [!code-vb[XmlSchemaSetOverall Example#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaSetOverall Example/VB/xmlschemasetexample.vb#1)]  
+  
+## 参照  
+ [スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [XML スキーマの使用](../../../../docs/standard/data/xml/working-with-xml-schemas.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xml-type-support-implementation-notes.md b/docs/standard/data/xml/xml-type-support-implementation-notes.md
new file mode 100644
index 00000000000..ecbdd317bfd
--- /dev/null
+++ b/docs/standard/data/xml/xml-type-support-implementation-notes.md
@@ -0,0 +1,60 @@
+---
+title: "XML 型サポートの実装に関するメモ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 26b071f3-1261-47ef-8690-0717f5cd93c1
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XML 型サポートの実装に関するメモ
+このトピックでは、認識しておく必要があるいくつかの実装上の詳細について説明します。  
+  
+## リストのマッピング  
+ <xref:System.Collections.IList>、<xref:System.Collections.ICollection>、<xref:System.Collections.IEnumerable>、および <xref:System.String> 型は、XML スキーマ定義言語 \(XSD\) のリスト型を表現するために使用されます。  
+  
+## ユニオンのマッピング  
+ ユニオン型は <xref:System.Xml.Schema.XmlAtomicValue> 型または <xref:System.String> 型を使用して表現されます。  したがって、変換前の型または変換後の型は常に <xref:System.String> または <xref:System.Xml.Schema.XmlAtomicValue> のどちらかである必要があります。  
+  
+ <xref:System.Xml.Schema.XmlSchemaDatatype> オブジェクトがリスト型を表す場合、このオブジェクトは入力文字列値をリストまたは複数のオブジェクトに変換します。  <xref:System.Xml.Schema.XmlSchemaDatatype> がユニオン型を表す場合は、ユニオンのメンバーの型として入力値が解析されます。  解析が失敗した場合は、変換が成功するか他のメンバーの型がなくなるまで、ユニオンの次のメンバーを使用して変換が試行されます。変換を試行するメンバーの型がなくなると、例外がスローされます。  
+  
+## CLR 型と XML データ型の違い  
+ CLR 型と XML データ型の間で発生する可能性のある不一致とその処理方法を次に示します。  
+  
+> [!NOTE]
+>  `xs` プレフィックスは、http:\/\/www.w3.org\/2001\/XMLSchema と名前空間の URI. にマップされます。  
+  
+### System.TimeSpan と xs:duration  
+ `xs:duration` 型は、値は異なるが同等の継続時間値として、部分的な順序付けが行われます。  これは、たとえば 1 か月 \(P1M\) という `xs:duration` 型の値が、32 日 \(P32D\) より小さく、27 日 \(P27D\) より大きく、28 日、29 日または 30 日と同等であることを意味します。  
+  
+ <xref:System.TimeSpan> クラスは、この部分的な順序付けをサポートしません。  その代わりに、1 年および 1 か月に特定の日数 \(それぞれ 365 日と 30 日\) を使用します。  
+  
+ `xs:duration` の詳細については、http:\/\/www.w3.org\/TR\/xmlschema\-2\/ にアクセスして『W3C XML Schema Part 2: Datatypes Recommendation』を参照してください。  
+  
+### xs:time、グレオリオ暦の日付、および System.DateTime  
+ `xs:time` 値が <xref:System.DateTime> オブジェクトにマップされている場合、<xref:System.DateTime.MinValue> フィールドは <xref:System.DateTime> オブジェクトの日付プロパティ \(<xref:System.DateTime.Year%2A>、<xref:System.DateTime.Month%2A>、<xref:System.DateTime.Day%2A> など\) を可能な最小の <xref:System.DateTime> 値に初期化するために使用されます。  
+  
+ 同様に、`xs:gMonth`、`xs:gDay`、`xs:gYear`、`xs:gYearMonth`、および `xs:gMonthDay` のインスタンスは、<xref:System.DateTime> オブジェクトにマップされます。  <xref:System.DateTime> オブジェクトの未使用のプロパティは、<xref:System.DateTime.MinValue> の値で初期化されます。  
+  
+> [!NOTE]
+>  内容が `xs:gMonthDay` として型指定されている場合は、<xref:System.DateTime.Year%2A?displayProperty=fullName> 値は信頼できません。  この場合、<xref:System.DateTime.Year%2A?displayProperty=fullName> 値は常に 1,904 に設定されています。  
+  
+### xs:anyURI および System.Uri  
+ 相対 URI を表す `xs:anyURI` のインスタンスが <xref:System.Uri> にマップされている場合、<xref:System.Uri> オブジェクトには基本 URI がありません。  
+  
+## 参照  
+ [System.Xml クラスでの型のサポート](../../../../docs/standard/data/xml/type-support-in-the-system-xml-classes.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md b/docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md
new file mode 100644
index 00000000000..ff8a9449673
--- /dev/null
+++ b/docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md
@@ -0,0 +1,42 @@
+---
+title: "XslTransform への XmlDataDocument の入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a0b536b6-cdb3-4a44-86c2-3b2ebc7bd4c9
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XslTransform への XmlDataDocument の入力
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslTransform> では、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] クラスが廃止されています。<xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。 詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ Microsoft [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] は、XML ドキュメント内のデータにアクセスするための XML ドキュメント オブジェクト モデル \(DOM\) を実装しているほか、XML ドキュメント内で読み込み、書き込み、移動を行うためのさまざまなクラスも実装しています。<xref:System.Xml.XmlDataDocument> 名前空間にある <xref:System.Xml> は、<xref:System.Data.DataSet> 内のデータへのリレーショナル アクセス機能およびリレーショナル データとの同期機能を備えています。<xref:System.Data.DataSet> のリレーショナル表現を介して構造化 XML を表示すると同時に操作したり、<xref:System.Xml.XmlDataDocument> の DOM 表現を介して半構造化 XML を操作したりすることができます。 したがって、<xref:System.Xml.XmlDataDocument> は、XML 環境とリレーショナル環境の境界を越えて機能します。  
+  
+ データがリレーショナル構造に格納されている場合、そのデータを XSLT 変換への入力として使用するには、そのリレーショナル データを <xref:System.Data.DataSet> に読み込み、<xref:System.Xml.XmlDataDocument> に関連付けます。<xref:System.Xml.XPath.XPathNavigator> への入力である <xref:System.Xml.Xsl.XslTransform> は、<xref:System.Xml.XmlDataDocument> インターフェイスを介して <xref:System.Xml.XPath.IXPathNavigable> に実装されます。 リレーショナル データを受け取り、それを <xref:System.Data.DataSet> に読み込み、<xref:System.Xml.XmlDataDocument> 内の同期機能を利用することで、そのリレーショナル データに対する XSLT 変換を実行できます。  
+  
+ リレーショナル データへの変換の適用については、「[DataSet への XSLT 変換の適用](../../../../docs/framework/data/adonet/dataset-datatable-dataview/applying-an-xslt-transform-to-a-dataset.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.XmlDataDocument>   
+ [DataSet と XmlDataDocument の同期](../../../../docs/framework/data/adonet/dataset-datatable-dataview/dataset-and-xmldatadocument-synchronization.md)   
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)   
+ [変換における XPathNavigator](../../../../docs/standard/data/xml/xpathnavigator-in-transformations.md)   
+ [変換における XPathNodeIterator](../../../../docs/standard/data/xml/xpathnodeiterator-in-transformations.md)   
+ [XslTransform への XPathDocument の入力](../../../../docs/standard/data/xml/xpathdocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDocument の入力](../../../../docs/standard/data/xml/xmldocument-input-to-xsltransform.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xmldocument-input-to-xsltransform.md b/docs/standard/data/xml/xmldocument-input-to-xsltransform.md
new file mode 100644
index 00000000000..24c64851414
--- /dev/null
+++ b/docs/standard/data/xml/xmldocument-input-to-xsltransform.md
@@ -0,0 +1,63 @@
+---
+title: "XslTransform への XmlDocument の入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 97115892-410a-4657-ab47-1e14dfba73f8
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XslTransform への XmlDocument の入力
+<xref:System.Xml.XmlDocument> クラスは、XML ドキュメントの編集機能を持っています。 XML を <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに送信する前に編集または変更する必要がある場合は、XML を <xref:System.Xml.XmlDocument> に読み込み、編集し、<xref:System.Xml.Xsl.XslTransform> に送信します。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslTransform> では、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] クラスが廃止されています。<xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。 詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ <xref:System.Xml.XmlDocument> は <xref:System.Xml.XPath.IXPathNavigable> インターフェイスを実装しているため、ドキュメントを編集した後で <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡すことができます。  
+  
+ <xref:System.Xml.XmlDocument> は編集機能を持っているのに対して、<xref:System.Xml.XmlDocument> は内部ストレージを利用して XPath \(XML Path Language\) クエリに最適化されているため、<xref:System.Xml.XPath.XPathDocument> クラスを変換への入力として使用する方法は、<xref:System.Xml.XPath.XPathDocument> を XSLT \(Extensible Stylesheet Language for Transformations\) 変換に使用する方法より動作が遅くなります。  
+  
+## 例  
+ <xref:System.Xml.XmlDocument> を <xref:System.Xml.Xsl.XslTransform> に渡し、出力を <xref:System.Xml.XmlReader> に送信するコード サンプルを次に示します。  
+  
+```vb  
+Dim doc as XmlDocument = new XmlDocument()  
+doc.Load("books.xml")  
+Dim trans As XslTransform = new XslTransform()  
+trans.Load("book.xsl")  
+Dim rdr As XmlReader = trans.Transform(doc, Nothing, Nothing)  
+while (rdr.Read())  
+end while  
+```  
+  
+```csharp  
+XmlDocument doc = new XmlDocument();  
+doc.Load("books.xml");  
+XslTransform trans = new XslTransform();  
+trans.Load("book.xsl");  
+XmlReader rdr = trans.Transform(doc, null, null);  
+while (rdr.Read()) {}  
+```  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)   
+ [変換における XPathNavigator](../../../../docs/standard/data/xml/xpathnavigator-in-transformations.md)   
+ [変換における XPathNodeIterator](../../../../docs/standard/data/xml/xpathnodeiterator-in-transformations.md)   
+ [XslTransform への XPathDocument の入力](../../../../docs/standard/data/xml/xpathdocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDataDocument の入力](../../../../docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xmlschemacollection-schema-compilation.md b/docs/standard/data/xml/xmlschemacollection-schema-compilation.md
new file mode 100644
index 00000000000..5e431c8874e
--- /dev/null
+++ b/docs/standard/data/xml/xmlschemacollection-schema-compilation.md
@@ -0,0 +1,68 @@
+---
+title: "XmlSchemaCollection スキーマのコンパイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 76f28770-7126-428f-9ed5-7b5ae8bad5ee
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XmlSchemaCollection スキーマのコンパイル
+**XmlSchemaCollection** は、XDR \(XML\-Data Reduced\) スキーマや XML スキーマ定義言語 \(XSD\) スキーマを格納および検証できるキャッシュ \(ライブラリ\) です。  **XmlSchemaCollection** は、ファイルや URL からスキーマにアクセスしなくて済むようにスキーマをメモリにキャッシュすることによって、パフォーマンスの向上を図ります。  
+  
+> [!NOTE]
+>  **XmlSchemaCollection** クラスには XDR スキーマと XML スキーマの両方が格納されますが、**XmlSchema** オブジェクトを受け取ったり返したりするメソッドおよびプロパティは XML スキーマのみをサポートします。  
+  
+> [!IMPORTANT]
+>  <xref:System.Xml.Schema.XmlSchemaCollection> クラスは廃止されており、<xref:System.Xml.Schema.XmlSchemaSet> クラスに置き換えられています。  <xref:System.Xml.Schema.XmlSchemaSet> の詳細については、「[スキーマをコンパイルするための XmlSchemaSet](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)」を参照してください。  
+  
+## コレクションへのスキーマの追加  
+ スキーマを **XmlSchemaCollection** に読み込むには、そのコレクションの **Add** メソッドを使用します。読み込み時に、スキーマは名前空間 URI に関連付けられます。  XML スキーマの場合、通常、この名前空間 URI がスキーマのターゲット名前空間になります。  また、XDR スキーマの場合は、この名前空間 URI は、スキーマがコレクションに追加されたときに指定された名前空間です。  
+  
+## コレクション内のスキーマの確認  
+ スキーマがコレクション内にあるかどうかを確認するには、**Contains** メソッドを使用します。  **Contains** メソッドは、**XmlSchema** オブジェクト \(XML スキーマ専用\) またはスキーマに関連付けられた名前空間 URI を表す文字列 \(XML スキーマと XDR スキーマ用\) のいずれかを受け取ります。  
+  
+## コレクションからのスキーマの取得  
+ コレクションからスキーマを取得するには、**Item** プロパティを使用します。  **Item** プロパティは、スキーマに関連付けられた名前空間 URI \(通常は、そのスキーマのターゲット名前空間\) を表す文字列を受け取り、**XmlSchema** オブジェクトを返します。  **Item** プロパティは、XML スキーマにだけ適用されます。  XDR スキーマの場合は、使用できるオブジェクト モデルがないため、戻り値は常に null 参照です。  
+  
+## XmlSchemaCollection を使用した XML ドキュメントの検証  
+ **XmlSchemaCollection** を使用して XML インスタンス ドキュメントを検証するには、**XmlSchemaCollection** オブジェクトを作成し、開発者が作成したスキーマをそのコレクションに追加し、**XmlValidatingReader** の **Schemas** プロパティを設定して、作成した **XmlSchemaCollection** をその **XmlValidatingReader** に割り当てます。  
+  
+### パフォーマンスの向上  
+ 同じスキーマを基準として複数のドキュメントを検証する場合は、**XmlSchemaCollection** を使用することをお勧めします。このコレクションを使用すると、そのスキーマをメモリ内にキャッシュしてパフォーマンスの向上を図ることができます。  
+  
+ **XmlSchemaCollection** オブジェクトを作成し、そのコレクションにスキーマを追加し、**Schemas** プロパティを設定するコード サンプルを次に示します。  
+  
+```vb  
+Dim tr as XmlTextReader = new XmlTextReader("Books.xml")  
+Dim vr as XmlValidatingReader = new XmlValidatingReader(tr)  
+Dim xsc as XmlSchemaCollection = new XmlSchemaCollection  
+xsc.Add("urn:bookstore-schema", "Books.xsd")  
+vr.Schemas.Add(xsc)  
+```  
+  
+```csharp  
+XmlTextReader tr = new XmlTextReader("Books.xml");  
+XmlValidatingReader vr = new XmlValidatingReader(tr);  
+XmlSchemaCollection xsc = new XmlSchemaCollection();  
+xsc.Add("urn:bookstore-schema", "Books.xsd");    
+vr.Schemas.Add(xsc);  
+```  
+  
+## 参照  
+ [XmlSchemaCollection を使用した XDR 検証](../../../../docs/standard/data/xml/xdr-validation-with-xmlschemacollection.md)   
+ [XmlSchemaCollection を使用した XML スキーマ \(XSD\) 検証](../../../../docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemacollection.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xmlschemaset-for-schema-compilation.md b/docs/standard/data/xml/xmlschemaset-for-schema-compilation.md
new file mode 100644
index 00000000000..67dc108586b
--- /dev/null
+++ b/docs/standard/data/xml/xmlschemaset-for-schema-compilation.md
@@ -0,0 +1,269 @@
+---
+title: "スキーマをコンパイルするための XmlSchemaSet | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 55c4b175-3170-4071-9d60-dd5a42f79b54
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# スキーマをコンパイルするための XmlSchemaSet
+XML スキーマ定義言語 \(XSD\) スキーマの格納と検証が可能なキャッシュである <xref:System.Xml.Schema.XmlSchemaSet> について説明します。  
+  
+## XmlSchemaSet クラス  
+ <xref:System.Xml.Schema.XmlSchemaSet> は、XML スキーマ定義言語 \(XSD\) スキーマの格納と検証が可能なキャッシュです。  
+  
+ <xref:System.Xml?displayProperty=fullName> Version 1.0 では、XML スキーマはスキーマのライブラリとして <xref:System.Xml.Schema.XmlSchemaCollection> クラスに読み込まれました。  <xref:System.Xml?displayProperty=fullName> Version 2.0 では、<xref:System.Xml.XmlValidatingReader> クラスおよび <xref:System.Xml.Schema.XmlSchemaCollection> クラスは廃止され、それぞれ <xref:System.Xml.XmlReader.Create%2A> メソッドおよび <xref:System.Xml.Schema.XmlSchemaSet> クラスによって置き換えられています。  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> は、標準との互換性、パフォーマンス、廃止された Microsoft XDR \(XML\-Data Reduced\) スキーマ形式など、多くの問題を解決するために導入されました。  
+  
+ 以下は、<xref:System.Xml.Schema.XmlSchemaCollection> クラスと <xref:System.Xml.Schema.XmlSchemaSet> クラスの比較です。  
+  
+|XmlSchemaCollection|XmlSchemaSet|  
+|-------------------------|------------------|  
+|Microsoft XDR と W3C XML スキーマをサポート。|W3C XML スキーマだけをサポート。|  
+|スキーマは、<xref:System.Xml.Schema.XmlSchemaCollection.Add%2A> メソッドの呼び出し時にコンパイルされます。|スキーマは、<xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドの呼び出し時にコンパイルされません。  これによって、スキーマ ライブラリ作成時のパフォーマンスが向上します。|  
+|各スキーマが個別のコンパイル済みバージョンを生成するため、"スキーマ アイランド" が発生する可能性があります。結果として、すべての include および import はそのスキーマ内だけにスコープ設定されます。|コンパイル済みスキーマは、1 つの論理スキーマ \(スキーマの集合を 1 つ\) を生成します。  1 つのスキーマ内の、その集合にインポートされ追加されるすべてのスキーマは、集合自体に直接追加されます。  これは、すべてのスキーマに対して、すべての型を使用できることを意味しています。|  
+|コレクション内では、特定の対象名前空間に対して 1 つのスキーマだけが存在可能です。|型の競合がない限り、同じ対象名前空間に対して複数のスキーマを追加できます。|  
+  
+## XmlSchemaSet への移行  
+ 次のサンプル コードでは、廃止された <xref:System.Xml.Schema.XmlSchemaCollection> クラスから新しい <xref:System.Xml.Schema.XmlSchemaSet> クラスへの移行のガイドを提供します。  このコード サンプルは、次に挙げるこれら 2 つのクラスの主な相違点を説明するものです。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaCollection> クラスの <xref:System.Xml.Schema.XmlSchemaCollection.Add%2A> メソッドとは異なり、スキーマは <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッド呼び出し時にはコンパイルされません。  サンプル コード内では、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドが明示的に呼び出されます。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaSet> を繰り返すには、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを使用する必要があります。  
+  
+ 廃止された <xref:System.Xml.Schema.XmlSchemaCollection> のコード サンプルを次に示します。  
+  
+```vb  
+Dim schemaCollection As XmlSchemaCollection = New XmlSchemaCollection()  
+schemaCollection.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd")  
+schemaCollection.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd")  
+  
+Dim schema As XmlSchema  
+  
+For Each schema in schemaCollection  
+  
+   Console.WriteLine(schema.TargetNamespace)  
+  
+Next  
+```  
+  
+```csharp  
+XmlSchemaCollection schemaCollection = new XmlSchemaCollection();  
+schemaCollection.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd");  
+schemaCollection.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd");  
+  
+foreach(XmlSchema schema in schemaCollection)  
+{  
+   Console.WriteLine(schema.TargetNamespace);  
+}  
+```  
+  
+ 対応する <xref:System.Xml.Schema.XmlSchemaSet> のコード サンプルを次に示します。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
+schemaSet.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd")  
+schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd")  
+schemaSet.Compile()  
+  
+Dim schema As XmlSchema  
+  
+For Each schema in schemaSet.Schemas()  
+  
+   Console.WriteLine(schema.TargetNamespace)  
+  
+Next  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd");  
+schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd");  
+schemaSet.Compile();  
+  
+foreach(XmlSchema schema in schemaSet.Schemas())  
+{  
+   Console.WriteLine(schema.TargetNamespace);  
+}  
+```  
+  
+## スキーマの追加と取り出し  
+ スキーマは <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドを使用して <xref:System.Xml.Schema.XmlSchemaSet> に追加されます。  スキーマが <xref:System.Xml.Schema.XmlSchemaSet> に追加される場合、そのスキーマは対象名前空間の URI に関連付けられます。  対象名前空間の URI は、<xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドへのパラメーターとして指定するか、名前空間が指定されていない場合、<xref:System.Xml.Schema.XmlSchemaSet> がスキーマ内に定義されている名前空間を使用するかのどちらかです。  
+  
+ スキーマは <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティを使用して <xref:System.Xml.Schema.XmlSchemaSet> から取り出されます。  <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティでは、<xref:System.Xml.Schema.XmlSchemaSet> に含まれる <xref:System.Xml.Schema.XmlSchema> オブジェクトに対して繰り返すことができます。  <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティは、<xref:System.Xml.Schema.XmlSchemaSet> に含まれるすべての <xref:System.Xml.Schema.XmlSchema> オブジェクトを返すか、または対象名前空間のパラメーターが指定された場合、その名前空間に属するすべての <xref:System.Xml.Schema.XmlSchema> オブジェクトを返すかのどちらかです。  対象名前空間として `null` が指定された場合、<xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティは名前空間のないスキーマをすべて返します。  
+  
+ 次の例では、`http://www.contoso.com/books` 名前空間内の `books.xsd` スキーマを <xref:System.Xml.Schema.XmlSchemaSet> に追加し、`http://www.contoso.com/books` 名前空間に属しているすべてのスキーマを <xref:System.Xml.Schema.XmlSchemaSet> から取り出した後、それらのスキーマを <xref:System.Console> に書き出します。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet  
+schemaSet.Add("http://www.contoso.com/books", "books.xsd")  
+  
+Dim schema As XmlSchema  
+  
+For Each schema In schemaSet.Schemas("http://www.contoso.com/books")  
+  
+   schema.Write(Console.Out)  
+  
+Next  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add("http://www.contoso.com/books", "books.xsd");  
+  
+foreach (XmlSchema schema in schemaSet.Schemas("http://www.contoso.com/books"))  
+{  
+   schema.Write(Console.Out);  
+}  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトのスキーマの追加と取り出しに関する詳細については、<xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドおよび <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A> プロパティのリファレンス ドキュメントを参照してください。  
+  
+## スキーマのコンパイル  
+ <xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマは、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドによって、1 つの論理スキーマにコンパイルされます。  
+  
+> [!NOTE]
+>  廃止された <xref:System.Xml.Schema.XmlSchemaCollection> クラスとは異なり、スキーマは <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドの呼び出し時にはコンパイルされません。  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドの実行が成功した場合、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティは `true` に設定されます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティは、スキーマが <xref:System.Xml.Schema.XmlSchemaSet> 内にあるときに編集されても、影響を受けません。  <xref:System.Xml.Schema.XmlSchemaSet> 内の個別のスキーマの更新は追跡されません。  その結果、<xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティは、<xref:System.Xml.Schema.XmlSchemaSet> のスキーマが追加または削除されない限り、<xref:System.Xml.Schema.XmlSchemaSet> に含まれるスキーマの 1 つが変更されていても、`true` になる可能性があります。  
+  
+ 次の例では、`books.xsd` ファイルを <xref:System.Xml.Schema.XmlSchemaSet> に追加した後、<xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドを呼び出します。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
+schemaSet.Add("http://www.contoso.com/books", "books.xsd")  
+schemaSet.Compile()  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add("http://www.contoso.com/books", "books.xsd");  
+schemaSet.Compile();  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマのコンパイルに関する詳細については、<xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドのリファレンス ドキュメントを参照してください。  
+  
+## スキーマの再処理  
+ <xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマの再処理は、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッド呼び出し時にスキーマに対して実行されるすべての前処理手順を実行します。  <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドの呼び出しが成功した場合、<xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティは `false` に設定されます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> のコンパイル後、<xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマが変更された場合は、<xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドを使用する必要があります。  
+  
+ 次の例は、<xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドを使用して <xref:System.Xml.Schema.XmlSchemaSet> に追加されたスキーマの再処理を示しています。  <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A> メソッドを使用して <xref:System.Xml.Schema.XmlSchemaSet> がコンパイルされた後、<xref:System.Xml.Schema.XmlSchemaSet> に追加されたスキーマが変更された場合、<xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマは変更されているのに、<xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティは `true` に設定されています。  <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドの呼び出しは、<xref:System.Xml.Schema.XmlSchemaSet.Add%2A> メソッドによって実行されるすべての前処理を実行し、<xref:System.Xml.Schema.XmlSchemaSet.IsCompiled%2A> プロパティを `false` に設定します。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
+Dim schema As XmlSchema = schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd")  
+schemaSet.Compile()  
+  
+Dim element As XmlSchemaElement = New XmlSchemaElement()  
+schema.Items.Add(element)  
+element.Name = "book"  
+element.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")  
+  
+schemaSet.Reprocess(schema)  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+XmlSchema schema = schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd");  
+schemaSet.Compile();  
+  
+XmlSchemaElement element = new XmlSchemaElement();  
+schema.Items.Add(element);  
+element.Name = "book";  
+element.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");  
+  
+schemaSet.Reprocess(schema);  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマの前処理に関する詳細については、<xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A> メソッドのリファレンス ドキュメントを参照してください。  
+  
+## スキーマの確認  
+ <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> メソッドを使用して、<xref:System.Xml.Schema.XmlSchemaSet> 内にスキーマが含まれているかどうかを確認できます。  <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> メソッドは、確認対象に対象名前空間または <xref:System.Xml.Schema.XmlSchema> オブジェクトのどちらかを受け取ります。  どちらの場合も、<xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> メソッドは、<xref:System.Xml.Schema.XmlSchemaSet> 内にスキーマが含まれている場合 `true` を、それ以外の場合 `false` を返します。  
+  
+ スキーマの確認に関する詳細については、<xref:System.Xml.Schema.XmlSchemaSet.Contains%2A> メソッドのリファレンス ドキュメントを参照してださい。  
+  
+## スキーマの削除  
+ スキーマは <xref:System.Xml.Schema.XmlSchemaSet> の <xref:System.Xml.Schema.XmlSchemaSet.Remove%2A> および <xref:System.Xml.Schema.XmlSchemaSet.RemoveRecursive%2A> メソッドを使用して <xref:System.Xml.Schema.XmlSchemaSet> から削除されます。  <xref:System.Xml.Schema.XmlSchemaSet.Remove%2A> メソッドは、指定されたスキーマを <xref:System.Xml.Schema.XmlSchemaSet> から削除し、<xref:System.Xml.Schema.XmlSchemaSet.RemoveRecursive%2A> メソッドは、指定されたスキーマとそのスキーマがインポートしているすべてのスキーマを <xref:System.Xml.Schema.XmlSchemaSet> から削除します。  
+  
+ 以下は、複数のスキーマを <xref:System.Xml.Schema.XmlSchemaSet> に追加してから、<xref:System.Xml.Schema.XmlSchemaSet.RemoveRecursive%2A> メソッドを使用して、それらのスキーマの 1 つとそのスキーマがインポートしているすべてのスキーマを削除する例を示しています。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
+schemaSet.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd")  
+schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd")  
+schemaSet.Add("http://www.contoso.com/music", "http://www.contoso.com/music.xsd")  
+  
+Dim schema As XmlSchema  
+  
+For Each schema In schemaSet.Schemas()  
+  
+   If schema.TargetNamespace = "http://www.contoso.com/music" Then  
+      schemaSet.RemoveRecursive(schema)  
+   End If  
+  
+Next  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add("http://www.contoso.com/retail", "http://www.contoso.com/retail.xsd");  
+schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd");  
+schemaSet.Add("http://www.contoso.com/music", "http://www.contoso.com/music.xsd");  
+  
+foreach (XmlSchema schema in schemaSet.Schemas())  
+{  
+   if (schema.TargetNamespace == "http://www.contoso.com/music")  
+   {  
+      schemaSet.RemoveRecursive(schema);  
+   }  
+}  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> からのスキーマの削除に関する詳細については、<xref:System.Xml.Schema.XmlSchemaSet.Remove%2A> メソッドおよび <xref:System.Xml.Schema.XmlSchemaSet.RemoveRecursive%2A> メソッドのリファレンス ドキュメントを参照してください。  
+  
+## スキーマの解決と xs:import  
+ 次の例は、<xref:System.Xml.Schema.XmlSchemaSet> 内で、指定された名前空間に対して複数のスキーマが存在するときに、スキーマをインポートする場合の <xref:System.Xml.Schema.XmlSchemaSet> の動作を示しています。  
+  
+ 例として、`http://www.contoso.com` 名前空間に関する複数のスキーマを含む <xref:System.Xml.Schema.XmlSchemaSet> を考えます。  次の `xs:import` ディレクティブを持つスキーマが <xref:System.Xml.Schema.XmlSchemaSet> に追加されます。  
+  
+```  
+<xs:import namespace="http://www.contoso.com" schemaLocation="http://www.contoso.com/schema.xsd" />  
+```  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> は、`http://www.contoso.com/schema.xsd` URL から読み込むことによって、`http://www.contoso.com` 名前空間に関するスキーマをインポートしようとします。  `http://www.contoso.com` 名前空間に関する他のスキーマ ドキュメントが <xref:System.Xml.Schema.XmlSchemaSet> 内にある場合でも、インポート元のスキーマでは、スキーマ宣言とそのスキーマ ドキュメント内で定義した型だけしか使用できません。  `schema.xsd` ファイルが `http://www.contoso.com/schema.xsd` URL で見つからない場合、`http://www.contoso.com` 名前空間に関するスキーマは、インポート元のスキーマにインポートされません。  
+  
+## XML ドキュメントの検証  
+ XML ドキュメントは、<xref:System.Xml.Schema.XmlSchemaSet> 内のスキーマに対して検証できます。  スキーマを <xref:System.Xml.XmlReaderSettings> オブジェクトの <xref:System.Xml.Schema.XmlSchemaSet> <xref:System.Xml.XmlReaderSettings.Schemas%2A> プロパティに追加するか、<xref:System.Xml.Schema.XmlSchemaSet> を <xref:System.Xml.XmlReaderSettings> オブジェクトの <xref:System.Xml.XmlReaderSettings.Schemas%2A> プロパティに追加することによって、XML ドキュメントを検証します。  次に、<xref:System.Xml.XmlReader> オブジェクトを作成して、XML ドキュメントを検証するために、<xref:System.Xml.XmlReaderSettings> オブジェクトが <xref:System.Xml.XmlReader> クラスの <xref:System.Xml.XmlReader.Create%2A> メソッドによって使用されます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaSet> による XML ドキュメントの検証に関する詳細については、「[XmlSchemaSet による XML スキーマ \(XSD\) 検証](../../../../docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemaset.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Xml.Schema.XmlSchemaSet.Add%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.Schemas%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.Contains%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.Compile%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.Reprocess%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.Remove%2A>   
+ <xref:System.Xml.Schema.XmlSchemaSet.RemoveRecursive%2A>   
+ [XmlSchemaSet as a Schema Cache](../../../../docs/standard/data/xml/xmlschemaset-for-schema-compilation.md)   
+ [XmlSchemaSet による XML スキーマ \(XSD\) 検証](../../../../docs/standard/data/xml/xml-schema-xsd-validation-with-xmlschemaset.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xmlschemavalidator-push-based-validation.md b/docs/standard/data/xml/xmlschemavalidator-push-based-validation.md
new file mode 100644
index 00000000000..a259258532d
--- /dev/null
+++ b/docs/standard/data/xml/xmlschemavalidator-push-based-validation.md
@@ -0,0 +1,457 @@
+---
+title: "XmlSchemaValidator のプッシュ ベースの検証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 911d4460-dd91-4958-85b2-2ca3299f9ec6
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 1
+---
+# XmlSchemaValidator のプッシュ ベースの検証
+<xref:System.Xml.Schema.XmlSchemaValidator> は、プッシュ ベース方式で、XML スキーマを基準として XML データを検証する、効率的かつ高性能なしくみを提供します。  たとえば、<xref:System.Xml.Schema.XmlSchemaValidator> クラスでは、XML 情報セットを XML ドキュメントにシリアル化してから検証型 XML リーダーを使用してドキュメントを再解析する必要なしに、情報セットをそのまま検証することができます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスは、カスタム XML データ ソースに対する検証エンジンの構築や検証型 XML ライターを構築する 1 つの手段とするなど、上級のシナリオで使用することができます。  
+  
+ 次は、<xref:System.Xml.Schema.XmlSchemaValidator> クラスを使用して、`contosoBooks.xml` ファイルを `contosoBooks.xsd` スキーマに対して検証する一例です。  この例では、<xref:System.Xml.Serialization.XmlSerializer> クラスを使用して、`contosoBooks.xml` ファイルを逆シリアル化し、ノードの値を <xref:System.Xml.Schema.XmlSchemaValidator> クラスのメソッドに渡します。  
+  
+> [!NOTE]
+>  この例は、このトピックの各セクションを通じて使用されます。  
+  
+ [!code-csharp[XmlSchemaValidatorExamples#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XmlSchemaValidatorExamples/CS/XmlSchemaValidatorExamples.cs#1)]
+ [!code-vb[XmlSchemaValidatorExamples#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XmlSchemaValidatorExamples/VB/XmlSchemaValidatorExamples.vb#1)]  
+  
+ この例は、`contosoBooks.xml` ファイルを入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#2](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xml#2)]  
+  
+ また、`contosoBooks.xsd` ファイルも入力として使用します。  
+  
+ [!code-xml[XPathXMLExamples#3](../../../../samples/snippets/xml/VS_Snippets_Data/XPathXMLExamples/XML/contosoBooks.xsd#3)]  
+  
+## XmlSchemaValidator を使用した XML データの検証  
+ XML 情報セットの検証を開始するには、最初に <xref:System.Xml.Schema.XmlSchemaValidator.%23ctor%2A> コンストラクターを使用して <xref:System.Xml.Schema.XmlSchemaValidator> クラスの新しいインスタンスを初期化する必要があります。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.%23ctor%2A> コンストラクターはパラメーターとして <xref:System.Xml.Schema.XmlSchemaValidationFlags> 値の他に、<xref:System.Xml.XmlNameTable>、<xref:System.Xml.Schema.XmlSchemaSet>、および <xref:System.Xml.XmlNamespaceManager> オブジェクトをパラメーターとして取ります。  <xref:System.Xml.XmlNameTable> オブジェクトは、スキーマの名前空間や XML 名前空間などの既知の名前空間文字列を分解するために使用され、単純コンテンツの検証中に、<xref:System.Xml.Schema.XmlSchemaDatatype.ParseValue%2A> メソッドに渡されます。  <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトには XML 情報セットを検証するために使用される XML スキーマが含まれています。  <xref:System.Xml.XmlNamespaceManager> オブジェクトは検証中に遭遇する名前空間を解決するために使用されます。  <xref:System.Xml.Schema.XmlSchemaValidationFlags> 値は、検証の特定の機能を無効にするために使用されます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.%23ctor%2A> コンストラクターの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 検証の初期化  
+ <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトの構築後に、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトの状態の初期化に使用される 2 つのオーバーロードされた <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドがあります。  次が、その 2 つの <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドです。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName>  
+  
+ 既定の <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName> メソッドは <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを開始状態に初期化し、オーバーロードされた <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName> メソッドは <xref:System.Xml.Schema.XmlSchemaObject> をパラメーターとして取り、部分検証のために <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを開始状態に初期化します。  
+  
+ 両方の <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドは、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトが構築された直後、または <xref:System.Xml.Schema.XmlSchemaValidator.EndValidation%2A> の呼び出し後のみ呼び出し可能です。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName> メソッドの例については、最初の例を参照してください。  <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+#### 部分検証  
+ <xref:System.Xml.Schema.XmlSchemaObject> をパラメーターとして取る <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName> メソッドは、部分検証のために <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを開始状態に初期化します。  
+  
+ 次の例で <xref:System.Xml.Schema.XmlSchemaObject> は、部分検証のために <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A?displayProperty=fullName> メソッドを使用して初期化されます。  <xref:System.Xml.Schema.XmlSchemaSet> オブジェクトの <xref:System.Xml.Schema.XmlSchemaSet.GlobalElements%2A> プロパティによって返された <xref:System.Xml.Schema.XmlSchemaObjectTable> コレクション内の <xref:System.Xml.XmlQualifiedName> によってスキーマ要素を選択することにより、`orderNumber` スキーマ要素が渡されます。  <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトは、次にこの特定の要素を検証します。  
+  
+```vb  
+Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
+schemaSet.Add(Nothing, "schema.xsd")  
+schemaSet.Compile()  
+Dim nameTable As NameTable = New NameTable()  
+Dim manager As XmlNamespaceManager = New XmlNamespaceManager(nameTable)  
+  
+Dim validator As XmlSchemaValidator = New XmlSchemaValidator(nameTable, schemaSet, manager, XmlSchemaValidationFlags.None)  
+validator.Initialize(schemaSet.GlobalElements.Item(New XmlQualifiedName("orderNumber")))  
+  
+validator.ValidateElement("orderNumber", "", Nothing)  
+validator.ValidateEndOfAttributes(Nothing)  
+validator.ValidateText("123")  
+validator.ValidateEndElement(Nothing)  
+```  
+  
+```csharp  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add(null, "schema.xsd");  
+schemaSet.Compile();  
+NameTable nameTable = new NameTable();  
+XmlNamespaceManager manager = new XmlNamespaceManager(nameTable);  
+  
+XmlSchemaValidator validator = new XmlSchemaValidator(nameTable, schemaSet, manager, XmlSchemaValidationFlags.None);  
+validator.Initialize(schemaSet.GlobalElements[new XmlQualifiedName("orderNumber")]);  
+  
+validator.ValidateElement("orderNumber", "", null);  
+validator.ValidateEndOfAttributes(null);  
+validator.ValidateText("123");  
+validator.ValidateEndElement(null);  
+```  
+  
+ この例は、次の XML スキーマを入力として使用します。  
+  
+ `<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">`  
+  
+ `<xs:element name="orderNumber" type="xs:int" />`  
+  
+ `</xs:schema>`  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 追加のスキーマの追加  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスの <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドは、検証中に使用するスキーマ セットに 1 つの XML スキーマを追加するために使用します。  <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドは、XML 情報セットの検証中に、インライン XML スキーマに遭遇した場合の効果をシミュレートするために使用できます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchema> パラメーターの対象名前空間は、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトが既に遭遇したすべての要素と属性の名前空間と一致してはなりません。  
+>   
+>  <xref:System.Xml.Schema.XmlSchemaValidator.%23ctor%2A> コンストラクターに <xref:System.Xml.Schema.XmlSchemaValidationFlags?displayProperty=fullName> 値がパラメーターとして渡されなかった場合、<xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドは何も行いません。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドの結果は、検証中の現在の XML ノードのコンテキストに依存します。  検証コンテキストの詳細については、このトピックの「検証コンテキスト」を参照してください。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 要素、属性、およびコンテンツの検証  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスは、XML 情報セット中の要素、属性、およびコンテンツを XML スキーマに対して検証するために使用するいくつかのメソッドを提供します。  各メソッドに関する説明を次の表に示します。  
+  
+|メソッド|説明|  
+|----------|--------|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A>|現在のコンテキスト中の要素名を検証します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>|現在の要素コンテキスト中の属性を検証します。または <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドにパラメーターとして渡された <xref:System.Xml.Schema.XmlSchemaAttribute> オブジェクトに対して属性を検証します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndOfAttributes%2A>|要素コンテキスト中の必須属性がすべて揃っていることを検証し、要素の子コンテンツを検証するために <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを準備します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A>|現在の要素コンテキスト中でテキストが許されるかどうかを検証し、現在の要素に単純コンテンツがある場合は検証のためにテキストを収集します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A>|現在の要素コンテキスト中で空白が許されるかどうかを検証し、現在の要素に単純コンテンツがある場合は検証のために空白を収集します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A>|要素のテキスト コンテンツが、単純コンテンツの要素のデータ型に従って有効なことを検証し、現在の要素のコンテンツが複合コンテンツの要素として完全であることを検証します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A>|現在の要素コンテンツの検証をスキップし、親要素のコンテキストでコンテンツの検証するために <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを準備します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.EndValidation%2A>|検証を終了し、<xref:System.Xml.Schema.XmlSchemaValidationFlags> 検証オプションが設定されている場合は XML ドキュメント全体について ID 制約をチェックします。|  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator> クラスには、上の表で定義された各メソッド呼び出しの発生と順序を強制する、定義済みの状態遷移があります。  <xref:System.Xml.Schema.XmlSchemaValidator> クラスの状態遷移の詳細は、このトピックの「XmlSchemaValidator の状態遷移」セクションで説明されています。  
+  
+ XML 情報セット内の要素、属性、およびコンテンツの検証に使用されるメソッドの例については、前のセクションの例を参照してください。  これらのメソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+#### XmlValueGetter を使用したコンテンツの検証  
+ <xref:System.Xml.Schema.XmlValueGetter> `delegate` は、属性、テキスト、または空白のノードの値を、属性、テキスト、または空白ノードの XML スキーマ定義言語 \(XSD\) 型と互換性のある共通言語ランタイム \(CLR\) 型として渡すために使用できます。  <xref:System.Xml.Schema.XmlValueGetter> `delegate` は、属性、テキスト、または空白のノードの CLR 値が既に使用可能な場合、それを `string` に変換してから検証のために再度解析する手間を省くために役立ちます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>、<xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A>、および <xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A> メソッドはオーバーロードされ、属性、テキスト、または空白ノードの値を `string` または <xref:System.Xml.Schema.XmlValueGetter> `delegate` として受け入れます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスの次のメソッドは、<xref:System.Xml.Schema.XmlValueGetter> `delegate` をパラメーターとして受け入れます。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A>  
+  
+ 次は、最初の <xref:System.Xml.Schema.XmlSchemaValidator> クラスの例から取られた <xref:System.Xml.Schema.XmlValueGetter> `delegate` の例です。  <xref:System.Xml.Schema.XmlValueGetter> `delegate` は属性の値を <xref:System.DateTime> オブジェクトとして返します。  <xref:System.Xml.Schema.XmlValueGetter> から返された <xref:System.DateTime> オブジェクトを検証するために、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトは、最初にそれを属性のデータ型の ValueType \(ValueType は XSD 型に対する既定の CLR の割り当て\) に変換し、次に変換された値のファセットをチェックします。  
+  
+```vb  
+Shared dateTimeGetterContent As Object  
+  
+Shared Function dateTimeGetterHandle() As Object  
+    Return dateTimeGetterContent  
+End Function  
+  
+Shared Function dateTimeGetter(ByVal dateTime As DateTime) As XmlValueGetter  
+    dateTimeGetterContent = dateTime  
+    Return New XmlValueGetter(AddressOf dateTimeGetterHandle)  
+End Function  
+```  
+  
+```csharp  
+static object dateTimeGetterContent;  
+  
+static object dateTimeGetterHandle()  
+{  
+    return dateTimeGetterContent;  
+}  
+  
+static XmlValueGetter dateTimeGetter(DateTime dateTime)  
+{  
+    dateTimeGetterContent = dateTime;  
+    return new XmlValueGetter(dateTimeGetterHandle);  
+}  
+```  
+  
+ <xref:System.Xml.Schema.XmlValueGetter> `delegate` の例については、最初の例を参照してください。  <xref:System.Xml.Schema.XmlValueGetter> `delegate` の詳細については、<xref:System.Xml.Schema.XmlValueGetter> および <xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+#### スキーマの検証後の情報  
+ <xref:System.Xml.Schema.XmlSchemaInfo> クラスは <xref:System.Xml.Schema.XmlSchemaValidator> クラスによって検証された 1 つの XML ノードのスキーマ検証後情報のいくつかを表します。  <xref:System.Xml.Schema.XmlSchemaValidator> クラスの種々のメソッドは <xref:System.Xml.Schema.XmlSchemaInfo> オブジェクトをオプションの \(`null`\) `out` パラメーターとして受け入れます。  
+  
+ 検証が成功した後、<xref:System.Xml.Schema.XmlSchemaInfo> オブジェクトには検証の結果が設定されています。  たとえば、<xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> メソッドを使用した検証の成功時には、<xref:System.Xml.Schema.XmlSchemaInfo> オブジェクトの \(指定した場合\) <xref:System.Xml.Schema.XmlSchemaInfo.SchemaAttribute%2A>、<xref:System.Xml.Schema.XmlSchemaInfo.SchemaType%2A>、<xref:System.Xml.Schema.XmlSchemaInfo.MemberType%2A>、および <xref:System.Xml.Schema.XmlSchemaInfo.Validity%2A> プロパティに検証結果が設定されています。  
+  
+ 次の <xref:System.Xml.Schema.XmlSchemaValidator> クラスのメソッドは、<xref:System.Xml.Schema.XmlSchemaInfo> オブジェクトを Out パラメーターとして受け入れます。  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A>  
+  
+-   <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndOfAttributes%2A>  
+  
+ <xref:System.Xml.Schema.XmlSchemaInfo> クラスの完全な例については、最初の例を参照してください。  <xref:System.Xml.Schema.XmlSchemaInfo> クラスに関する詳細については、<xref:System.Xml.Schema.XmlSchemaInfo> クラスのリファレンス ドキュメントを参照してください。  
+  
+### 期待されるパーティクル、属性、および未指定の既定の属性の取得  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスは、現在の検証コンテキスト中で期待されるパーティクル、属性、および未指定の既定の属性を取得するための <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A>、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A>、および <xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A> メソッドを提供します。  
+  
+#### 期待されるパーティクルの取得  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドは、現在の要素コンテキストで期待されるパーティクルを含む <xref:System.Xml.Schema.XmlSchemaParticle> オブジェクトの配列を返します。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドが返せる有効なパーティクルは、<xref:System.Xml.Schema.XmlSchemaElement> クラスと <xref:System.Xml.Schema.XmlSchemaAny> クラスのインスタンスです。  
+  
+ コンテンツ モデルのコンポジターが `xs:sequence` の場合、シーケンス中の次のパーティクルのみが返されます。  コンテンツ モデルのコンポジターが `xs:all` または `xs:choice` の場合、現在の要素コンテキストに続くことができる有効なパーティクルすべてが返されます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドが <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドの呼び出し直後に呼ばれると、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドはすべてのグローバル要素を返します。  
+  
+ たとえば、XSD \(XML スキーマ定義言語\) スキーマと続く XML ドキュメントで、`book` 要素の検証後、`book` 要素は現在の要素コンテキストになります。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドは、`title` 要素を表す単一の <xref:System.Xml.Schema.XmlSchemaElement> オブジェクトを含む配列を返します。  検証コンテキストが `title` 要素の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドは空の配列を返します。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドが `title` 要素の検証後で `description` 要素の検証前に呼び出されると、このメソッドは `description` 要素を表す単一の <xref:System.Xml.Schema.XmlSchemaElement> オブジェクトを含む配列を返します。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドが `description` 要素の検証後に呼び出されると、メソッドはワイルドカードを表す単一の <xref:System.Xml.Schema.XmlSchemaAny> オブジェクトを含む配列を返します。  
+  
+```vb  
+Dim reader As XmlReader =  XmlReader.Create("input.xml")   
+  
+Dim schemaSet As XmlSchemaSet =  New XmlSchemaSet()   
+schemaSet.Add(Nothing, "schema.xsd")  
+Dim manager As XmlNamespaceManager =  New XmlNamespaceManager(reader.NameTable)   
+  
+Dim validator As XmlSchemaValidator =  New XmlSchemaValidator(reader.NameTable,schemaSet,manager,XmlSchemaValidationFlags.None)  
+validator.Initialize()  
+  
+validator.ValidateElement("book", "", Nothing)  
+  
+validator.ValidateEndOfAttributes(Nothing)  
+For Each element As XmlSchemaElement In validator.GetExpectedParticles()  
+    Console.WriteLine(element.Name)  
+Next  
+  
+validator.ValidateElement("title", "", Nothing)  
+validator.ValidateEndOfAttributes(Nothing)  
+For Each element As XmlSchemaElement In validator.GetExpectedParticles()  
+    Console.WriteLine(element.Name)  
+Next  
+validator.ValidateEndElement(Nothing)  
+  
+For Each element As XmlSchemaElement In validator.GetExpectedParticles()  
+    Console.WriteLine(element.Name)  
+Next  
+  
+validator.ValidateElement("description", "", Nothing)  
+validator.ValidateEndOfAttributes(Nothing)  
+validator.ValidateEndElement(Nothing)  
+  
+For Each particle As XmlSchemaParticle In validator.GetExpectedParticles()  
+    Console.WriteLine(particle.GetType())  
+Next  
+  
+validator.ValidateElement("namespace", "", Nothing)  
+validator.ValidateEndOfAttributes(Nothing)  
+validator.ValidateEndElement(Nothing)  
+  
+validator.ValidateEndElement(Nothing)  
+```  
+  
+```csharp  
+XmlReader reader = XmlReader.Create("input.xml");  
+  
+XmlSchemaSet schemaSet = new XmlSchemaSet();  
+schemaSet.Add(null, "schema.xsd");  
+XmlNamespaceManager manager = new XmlNamespaceManager(reader.NameTable);  
+  
+XmlSchemaValidator validator = new XmlSchemaValidator(reader.NameTable, schemaSet, manager, XmlSchemaValidationFlags.None);  
+validator.Initialize();  
+  
+validator.ValidateElement("book", "", null);  
+  
+validator.ValidateEndOfAttributes(null);  
+foreach (XmlSchemaElement element in validator.GetExpectedParticles())  
+{  
+    Console.WriteLine(element.Name);  
+}  
+  
+validator.ValidateElement("title", "", null);  
+validator.ValidateEndOfAttributes(null);  
+foreach (XmlSchemaElement element in validator.GetExpectedParticles())  
+{  
+    Console.WriteLine(element.Name);  
+}  
+validator.ValidateEndElement(null);  
+  
+foreach (XmlSchemaElement element in validator.GetExpectedParticles())  
+{  
+    Console.WriteLine(element.Name);  
+}  
+  
+validator.ValidateElement("description", "", null);  
+validator.ValidateEndOfAttributes(null);  
+validator.ValidateEndElement(null);  
+  
+foreach (XmlSchemaParticle particle in validator.GetExpectedParticles())  
+{  
+    Console.WriteLine(particle.GetType());  
+}  
+  
+validator.ValidateElement("namespace", "", null);  
+validator.ValidateEndOfAttributes(null);  
+validator.ValidateEndElement(null);  
+  
+validator.ValidateEndElement(null);  
+```  
+  
+ この例は、次の XML を入力として使用します。  
+  
+ `<xs:schema xmlns:xs="http://www.w3c.org/2001/XMLSchema">`  
+  
+ `<xs:element name="book">`  
+  
+ `<xs:sequence>`  
+  
+ `<xs:element name="title" type="xs:string" />`  
+  
+ `<xs:element name="description" type="xs:string" />`  
+  
+ `<xs:any processContent="lax" maxOccurs="unbounded" />`  
+  
+ `</xs:sequence>`  
+  
+ `</xs:element>`  
+  
+ `</xs:schema>`  
+  
+ この例は、次の XSD スキーマを入力として使用します。  
+  
+ `<book>`  
+  
+ `<title>My Book</title>`  
+  
+ `<description>My Book's Description</description>`  
+  
+ `<namespace>System.Xml.Schema</namespace>`  
+  
+ `</book>`  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator> クラスの <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A>、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A>、および <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドの結果は、検証中の現在のコンテキストに依存します。  詳細については、このトピックの「検証コンテキスト」を参照してください。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドの例については、最初の例を参照してください。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+#### 期待される属性の取得  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドは、現在の要素コンテキストで期待される属性を含む <xref:System.Xml.Schema.XmlSchemaAttribute> オブジェクトの配列を返します。  
+  
+ たとえば最初の例で、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドは `book` 要素のすべての属性を取得するために使用されます。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドを <xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A> メソッドの直後に呼び出すと、その XML ドキュメントで使用可能なすべての属性が返されます。  ただし、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドを <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> メソッドの 1 回以上の呼び出し後に呼び出すと、現在の要素でまだ検証されていない属性が返されます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator> クラスの <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A>、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A>、および <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドの結果は、検証中の現在のコンテキストに依存します。  詳細については、このトピックの「検証コンテキスト」を参照してください。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドの例については、最初の例を参照してください。  <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+#### 未指定の既定の属性の取得  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A> メソッドは、要素コンテキスト中でこれまでに <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> メソッドを使用して検証されていない既定値を持つ属性の <xref:System.Xml.Schema.XmlSchemaAttribute> オブジェクトを指定された <xref:System.Collections.ArrayList> に読み込みます。  <xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A> メソッドは、要素コンテキスト中の各属性について <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> メソッドを呼び出した後で呼び出します。  <xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A> メソッドは、検証中の XML ドキュメントに挿入される既定の属性を決定するために使用します。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A> メソッドの詳細については、<xref:System.Xml.Schema.XmlSchemaValidator> クラスのリファレンス ドキュメントを参照してください。  
+  
+### スキーマ検証イベントの処理  
+ 検証中に発生したスキーマ検証の警告とエラーは、<xref:System.Xml.Schema.XmlSchemaValidator> クラスの <xref:System.Xml.Schema.XmlSchemaValidator.ValidationEventHandler> イベントで取り扱われます。  
+  
+ スキーマ検証の警告は、<xref:System.Xml.Schema.XmlSeverityType> 値が <xref:System.Xml.Schema.XmlSeverityType> であり、スキーマ検証エラーは、<xref:System.Xml.Schema.XmlSeverityType> 値が <xref:System.Xml.Schema.XmlSeverityType> です。  <xref:System.Xml.Schema.XmlSchemaValidator.ValidationEventHandler> が何も割り当てられていない場合、すべてのスキーマ検証エラーについて <xref:System.Xml.Schema.XmlSchemaValidationException> が <xref:System.Xml.Schema.XmlSeverityType> 値 <xref:System.Xml.Schema.XmlSeverityType> でスローされます。  ただし、<xref:System.Xml.Schema.XmlSeverityType> 値が <xref:System.Xml.Schema.XmlSeverityType> であるスキーマ検証警告については、<xref:System.Xml.Schema.XmlSchemaValidationException> はスローされません。  
+  
+ 次は最初の例から取られたもので、スキーマ検証中に発見したスキーマ検証警告とエラーを受け取る <xref:System.Xml.Schema.ValidationEventHandler> の一例です。  
+  
+```vb  
+Shared Sub SchemaValidationEventHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
+  
+    Select Case e.Severity  
+        Case XmlSeverityType.Error  
+            Console.WriteLine(vbCrLf & "Error: {0}", e.Message)  
+            Exit Sub  
+        Case XmlSeverityType.Warning  
+            Console.WriteLine(vbCrLf & "Warning: {0}", e.Message)  
+            Exit Sub  
+    End Select  
+End Sub  
+```  
+  
+```csharp  
+static void SchemaValidationEventHandler(object sender, ValidationEventArgs e)  
+{  
+    switch (e.Severity)  
+    {  
+        case XmlSeverityType.Error:  
+            Console.WriteLine("\nError: {0}", e.Message);  
+            break;  
+        case XmlSeverityType.Warning:  
+            Console.WriteLine("\nWarning: {0}", e.Message);  
+            break;  
+    }  
+}  
+```  
+  
+ <xref:System.Xml.Schema.ValidationEventHandler> の完全な例については、最初の例を参照してください。  詳細については、<xref:System.Xml.Schema.XmlSchemaInfo> クラスのリファレンス ドキュメントを参照してください。  
+  
+## XmlSchemaValidator の状態遷移  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスには、XML 情報セット内の要素、属性、およびコンテンツを検証するために、各メソッド呼び出しの発生と順序を強制する定義済みの状態遷移があります。  
+  
+ 次の表では、<xref:System.Xml.Schema.XmlSchemaValidator> クラスの状態遷移と、各状態で可能なメソッド呼び出しとその順序について説明します。  
+  
+|状態|切り替え効果|  
+|--------|------------|  
+|検証|<xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> \(<xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> &#124; TopLevel\*\) <xref:System.Xml.Schema.XmlSchemaValidator.EndValidation%2A>|  
+|TopLevel|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A> &#124; <xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A> &#124; Element|  
+|要素|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A> <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>\* \(<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndOfAttributes%2A> Content\*\)?  <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A> &#124;<br /><br /> <xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A> <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>\* <xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A> &#124;<br /><br /> <xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A> <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>\* <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndOfAttributes%2A> Content\* <xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A> &#124;|  
+|Content|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A> &#124; <xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A> &#124; Element|  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトの現在の状態に従って、メソッドの呼び出しが正しい順序で行われないと、上表の各メソッドによって <xref:System.InvalidOperationException> がスローされます。  
+  
+ 上の状態遷移表では、<xref:System.Xml.Schema.XmlSchemaValidator> クラスの状態遷移の各状態で呼び出せるメソッドと他の状態を説明するために、記号が使われています。  使用される記号は、ドキュメント型定義 \(DTD\) の XML 標準リファレンスで見られる記号と同一です。  
+  
+ 次の表は、上の状態遷移表で見られる記号が <xref:System.Xml.Schema.XmlSchemaValidator> クラスの状態遷移中の各状態について、呼び出せるメソッドと状態にどう影響を与えるかを説明するものです。  
+  
+|シンボル|説明|  
+|----------|--------|  
+|&#124;|メソッドと状態 \(縦棒の前後の項目\) のいずれかを呼び出し可能です。|  
+|?|疑問符の前のメソッドか状態はオプションです。呼び出す場合は 1 回しか呼べません。|  
+|\*|\* 記号の前のメソッドか状態はオプションです。複数回の呼び出しが可能です。|  
+  
+## 検証コンテキスト  
+ XML 情報セット内の要素、属性、コンテンツの検証に使用される <xref:System.Xml.Schema.XmlSchemaValidator> クラスのメソッドは、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトの検証コンテキストを変更します。  たとえば、<xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A> メソッドは、現在の要素コンテンツの検証をスキップし、親要素のコンテキスト中のコンテンツを検証するために <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトを準備します。これは、現在の要素のすべての子要素の検証をスキップして <xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A> メソッドを呼ぶのと同じです。  
+  
+ <xref:System.Xml.Schema.XmlSchemaValidator> クラスの <xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A>、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A>、および <xref:System.Xml.Schema.XmlSchemaValidator.AddSchema%2A> メソッドの結果は、検証中の現在のコンテキストに依存します。  
+  
+ 次の表では、XML 情報セット内の要素、属性、およびコンテンツの検証に使用する <xref:System.Xml.Schema.XmlSchemaValidator> クラスのメソッドの 1 つを呼び出した後で、これらのメソッドを呼び出した場合の結果について説明します。  
+  
+|メソッド|GetExpectedParticles|GetExpectedAttributes|AddSchema|  
+|----------|--------------------------|---------------------------|---------------|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A>|既定の <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドが呼び出されると、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> はすべてのグローバル要素を含む配列を返します。<br /><br /> 1 つの要素の部分検証を初期化するために、<xref:System.Xml.Schema.XmlSchemaObject> をパラメーターとして取るオーバーロードされた <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドが呼び出された場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトが初期化された対象の要素だけを返します。|既定の <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドが呼び出されると、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空の配列を返します。<br /><br /> 1 つの属性の部分検証を初期化するために <xref:System.Xml.Schema.XmlSchemaObject> をパラメーターとして取るオーバーロードの <xref:System.Xml.Schema.XmlSchemaValidator.Initialize%2A> メソッドが呼び出された場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は、<xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトが初期化された対象の属性だけを返します。|プリプロセス エラーがない場合は、スキーマを <xref:System.Xml.Schema.XmlSchemaValidator> オブジェクトの <xref:System.Xml.Schema.XmlSchemaSet> に追加します。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateElement%2A>|コンテキスト要素が有効な場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> はコンテキスト要素の子として期待される一連の要素を返します。<br /><br /> コンテキスト要素が無効な場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は空の配列を返します。|コンテキスト要素が有効で、これまで <xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A> の呼び出しが行われていない場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> はコンテキスト要素上に定義されたすべての属性のリストを返します。<br /><br /> いくつかの属性が既に検証されている場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は残りの検証すべき属性のリストを返します。<br /><br /> コンテキスト要素が無効な場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空の配列を返します。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateAttribute%2A>|コンテキスト属性が最上位の属性である場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は空の配列を返します。<br /><br /> それ以外の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、コンテキスト要素の最初の子として期待される一連の要素を返します。|コンテキスト属性が最上位の属性である場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空の配列を返します。<br /><br /> それ以外の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は検証する残りの属性のリストを返します。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.GetUnspecifiedDefaultAttributes%2A>|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、コンテキスト要素の最初の子として期待される一連の要素を返します。|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は、コンテキスト要素についてまだ検証されていない必須の属性とオプションの属性の一覧を返します。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndOfAttributes%2A>|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、コンテキスト要素の最初の子として期待される一連の要素を返します。|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空の配列を返します。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A>|コンテキスト要素の contentType が Mixed の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、次の位置で期待される一連の要素を返します。<br /><br /> コンテキスト要素の contentType が TextOnly または Empty の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は空の配列を返します。<br /><br /> コンテキスト要素の contentType が ElementOnly の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は、検証エラーが既に発生しているものを除いて、次の位置で期待される一連の要素を返します。|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> はコンテキスト要素の検証されていない属性リストを返します。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateWhitespace%2A>|コンテキストの空白が最上位の空白である場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> は空の配列を返します。<br /><br /> それ以外の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> メソッドの動作は <xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A> の場合と同じです。|コンテキストの空白が最上位の空白である場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空の配列を返します。<br /><br /> それ以外の場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> メソッドの動作は <xref:System.Xml.Schema.XmlSchemaValidator.ValidateText%2A> の場合と同じです。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A>|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedParticles%2A> はコンテキスト要素以降に期待される一連の要素を返します \(兄弟の可能性\)。|<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> はコンテキスト要素の検証されていない属性リストを返します。<br /><br /> コンテキスト要素に親がない場合、<xref:System.Xml.Schema.XmlSchemaValidator.GetExpectedAttributes%2A> は空のリストを返します \(コンテキスト要素が、<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A> を呼び出した対象である現在の要素の親\)。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.SkipToEndElement%2A>|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A> と同じ。|<xref:System.Xml.Schema.XmlSchemaValidator.ValidateEndElement%2A> と同じ。|上と同じ。|  
+|<xref:System.Xml.Schema.XmlSchemaValidator.EndValidation%2A>|空の配列を返します。|空の配列を返します。|上と同じ。|  
+  
+> [!NOTE]
+>  <xref:System.Xml.Schema.XmlSchemaValidator> クラスの各種プロパティで返される値は、上の表のどのメソッドを呼び出しても変わることはありません。  
+  
+## 参照  
+ <xref:System.Xml.Schema.XmlSchemaValidator>
\ No newline at end of file
diff --git a/docs/standard/data/xml/xpath-namespace-navigation.md b/docs/standard/data/xml/xpath-namespace-navigation.md
new file mode 100644
index 00000000000..041b40ea206
--- /dev/null
+++ b/docs/standard/data/xml/xpath-namespace-navigation.md
@@ -0,0 +1,86 @@
+---
+title: "XPath 名前空間のナビゲーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 06cc7abb-7416-415c-9dd6-67751b8cabd5
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XPath 名前空間のナビゲーション
+XML ドキュメントで XPath クエリを使用するには、XML 名前空間およびそれらの名前空間に含まれる要素を、正しくアドレス指定する必要があります。  名前空間は、名前が複数のコンテキストで使用される場合に生じる可能性がある、あいまいさを防ぎます。たとえば、`ID` という名前は、XML ドキュメントの複数の異なる要素に関連付けられた複数の ID を参照する場合があります。  名前空間の構文では、XML ドキュメントの各要素を識別する、URI、名前、およびプレフィックスを指定します。  
+  
+ このトピックの例では、<xref:System.Xml.XPath.XPathNavigator> で XML ドキュメントをナビゲーションする際のプレフィックスの使用方法を示します。  名前空間と構文の詳細については、「[XML 名前空間入門](http://go.microsoft.com/fwlink/?linkid=140245)」を参照してください。  
+  
+## 名前空間の宣言  
+ 名前空間の宣言によって、<xref:System.Xml.XPath.XPathNavigator> のインスタンスを使用する際に、XML ドキュメントの各要素の識別とアドレス指定が可能になります。  名前空間のプレフィックスでは、アドレス名前空間用の短い構文が指定されます。  
+  
+ プレフィックスは、`<e:Envelope xmlns:e=http://schemas.xmlsoap.org/soap/envelope/>.` という形式で定義されます。この構文では、プレフィックス "`e`" が、名前空間の正式な URI の省略形になります。  `e:Body` という構文を使用して、`Body` 要素を `Envelope` 名前空間のメンバーとして識別できます。  
+  
+ 次の XML ドキュメントは、次のセクションで示すナビゲーション例で `response.xml` として参照されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8" ?>  
+<e:Envelope xmlns:e="http://schemas.xmlsoap.org/soap/envelope/">  
+  <e:Body>  
+    <s:Search xmlns:s="http://schemas.microsoft.com/v1/Search">  
+      <r:request xmlns:r="http://schemas.microsoft.com/v1/Search/metadata"   
+                 xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
+      </r:request>  
+    </s:Search>  
+  </e:Body>  
+</e:Envelope>  
+  
+```  
+  
+## 名前空間プレフィックスによるナビゲーション  
+ このセクションで示すコードでは、<xref:System.Xml.XPath.XPathNavigator> オブジェクトと <xref:System.Xml.XmlNamespaceManager> オブジェクトを使用して、前のセクションで示した XML ドキュメントの `Search` 要素を選択します。  `xpath` クエリには、パス内の各要素の名前空間プレフィックスが含まれています。  各要素が含まれている名前空間の正確な ID を指定することによって、<xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A> メソッドで `Search` 要素に正しく移動できます。  
+  
+```  
+using (XmlReader reader = XmlReader.Create("response.xml"))  
+            {  
+                XPathDocument doc = new XPathDocument(reader);  
+                XPathNavigator nav = doc.CreateNavigator();  
+                XmlNamespaceManager nsmgr =  
+                         new XmlNamespaceManager(nav.NameTable);  
+                nsmgr.AddNamespace("e",   
+                         @"http://schemas.xmlsoap.org/soap/envelope/");  
+                nsmgr.AddNamespace("s",   
+                            @"http://schemas.microsoft.com/v1/Search");  
+                nsmgr.AddNamespace("r",   
+                   @"http://schemas.microsoft.com/v1/Search/metadata");  
+                nsmgr.AddNamespace("i",   
+                         @"http://www.w3.org/2001/XMLSchema-instance");  
+  
+                string xpath = "/e:Envelope/e:Body/s:Search";  
+  
+                XPathNavigator element = nav.SelectSingleNode(xpath, nsmgr);  
+  
+                Console.WriteLine("Element Prefix:" + element.Prefix +   
+                           " Local name:" + element.LocalName);  
+                Console.WriteLine("Namespace URI: " +   
+                            element.NamespaceURI);  
+  
+            }  
+  
+```  
+  
+ 名前空間で完全修飾された名前を使用するのは、利便性のためだけではありません。  前に示したドキュメント定義とコードでは、要素名を完全修飾せずにナビゲーションすると例外がスローされることがわかります。  たとえば、要素の定義が `<Search xmlns="http://schemas.microsoft.com/v1/Search">` で、クエリ文字列が `xpath = "/s:Envelope/s:Body/Search";` の場合、`Search` 要素に名前空間プレフィックスがないので、`Search` 要素ではなく `null` が返されます。  
+  
+## 参照  
+ [XPathNavigator による XML データへのアクセス](../../../../docs/standard/data/xml/accessing-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator を使用した XML データの選択、評価、および照合](../../../../docs/standard/data/xml/selecting-evaluating-and-matching-xml-data-using-xpathnavigator.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xpath-queries-and-namespaces.md b/docs/standard/data/xml/xpath-queries-and-namespaces.md
new file mode 100644
index 00000000000..2c92edb4c3a
--- /dev/null
+++ b/docs/standard/data/xml/xpath-queries-and-namespaces.md
@@ -0,0 +1,96 @@
+---
+title: "XPath クエリおよび名前空間 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: ef6402be-2f8e-4be2-8d3e-a80891cdef8b
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XPath クエリおよび名前空間
+XPath クエリは XML ドキュメント中の名前空間を認識し、名前空間プレフィックスを使用して要素と属性名を修飾することができます。  名前空間プレフィックスで要素や属性の名前を修飾すると、XPath クエリで返されるノードを特定の名前空間に属するノードだけに限定することができます。  
+  
+ たとえば、プレフィックス `books` が名前空間 `http://www.contoso.com/books` に割り当てられると、XPath クエリ `/books:books/books:book` は名前空間 `http://www.contoso.com/books` 内の `book` 要素だけを選択します。  
+  
+## XmlNamespaceManager  
+ XPath クエリで名前空間を使用するために、<xref:System.Xml.XmlNamespaceManager> クラスに似た <xref:System.Xml.IXmlNamespaceResolver> インターフェイスから派生したオブジェクトが、名前空間 URI と XPath クエリに含まれるプレフィックスを使用して作成されます。  
+  
+ <xref:System.Xml.XmlNamespaceManager> オブジェクトは次の方法でクエリで使用することができます。  
+  
+-   <xref:System.Xml.XPath.XPathExpression> オブジェクトの <xref:System.Xml.XPath.XPathExpression.SetContext%2A> メソッドを使用して、<xref:System.Xml.XmlNamespaceManager> オブジェクトを既存の <xref:System.Xml.XPath.XPathExpression> オブジェクトに関連付ける。  静的 <xref:System.Xml.XPath.XPathExpression.Compile%2A> メソッドを使用して、新しい <xref:System.Xml.XPath.XPathExpression> オブジェクトをコンパイルすることもできます。このメソッドは XPath 式を表す文字列と <xref:System.Xml.XmlNamespaceManager> オブジェクトをパラメーターとして取り、新しい <xref:System.Xml.XPath.XPathExpression> オブジェクトを返します。  
+  
+-   XPath 式を表す文字列と共に <xref:System.Xml.XmlNamespaceManager> オブジェクト自体をパラメーターとして受け入れ側の <xref:System.Xml.XPath.XPathNavigator> クラス メソッドに渡す。  
+  
+ 次は、<xref:System.Xml.IXmlNamespaceResolver> インターフェイスから派生したオブジェクトをパラメーターとして受け付ける <xref:System.Xml.XPath.XPathNavigator> クラスのメソッドです。  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Evaluate%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.Select%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNavigator.SelectSingleNode%2A>  
+  
+### 既定の名前空間  
+ 次の XML ドキュメントでは、`http://www.contoso.com/books` 名前空間を宣言するために、空のプレフィックスの既定の名前空間が使用されています。  
+  
+```  
+<books xmlns="http://www.example.com/books">  
+    <book>  
+        <title>Title</title>  
+        <author>Author Name</author>  
+        <price>5.50</price>  
+    </book>  
+</books>  
+```  
+  
+ XPath は空のプレフィックスを `null` 名前空間として取り扱います。  つまり、XPath クエリでは、名前空間に割り当てられたプレフィックスだけを使用できます。  このことは、XML ドキュメント内の名前空間に対してクエリする場合、たとえそれが既定の名前空間であっても、そのプレフィックスを定義する必要があることを意味します。  
+  
+ たとえば、上記の XML ドキュメントでプレフィックスを定義しなければ、XPath クエリ `/books/book` は何も結果を返しません。  
+  
+ ドキュメントで、名前空間内にないノードと既定の名前空間内のノードに対してクエリを行う場合には、あいまいさを避けるために、プレフィックスを付加しなければなりません。  
+  
+ 次のコードは、既定の名前空間のプレフィックスを定義し、`http://www.contoso.com/books` 名前空間からすべての `book` 要素を選択します。  
+  
+```vb  
+Dim document As XPathDocument = New XPathDocument("books.xml")  
+Dim navigator As XPathNavigator = document.CreateNavigator()  
+Dim query As XPathExpression = navigator.Compile("/books:books/books:book")  
+Dim manager As XmlNamespaceManager = New XmlNamespaceManager(navigator.NameTable)  
+manager.AddNamespace("books", "http://www.contoso.com/books")  
+query.SetContext(manager)  
+Dim nodes As XPathNodeIterator = navigator.Select(query)  
+```  
+  
+```csharp  
+XPathDocument document = new XPathDocument("books.xml");  
+XPathNavigator navigator = document.CreateNavigator();  
+XPathExpression query = navigator.Compile("/books:books/books:book");  
+XmlNamespaceManager manager = new XmlNamespaceManager(navigator.NameTable);  
+manager.AddNamespace("books", "http://www.contoso.com/books");  
+query.SetContext(manager);  
+XPathNodeIterator nodes = navigator.Select(query);  
+```  
+  
+## 参照  
+ <xref:System.Xml.XmlDocument>   
+ <xref:System.Xml.XPath.XPathDocument>   
+ <xref:System.Xml.XPath.XPathNavigator>   
+ [XPath データ モデルを使用した XML データの処理](../../../../docs/standard/data/xml/process-xml-data-using-the-xpath-data-model.md)   
+ [XPathNavigator を使用した XML データの選択](../../../../docs/standard/data/xml/select-xml-data-using-xpathnavigator.md)   
+ [XPathNavigator による Xpath 式の評価](../../../../docs/standard/data/xml/evaluate-xpath-expressions-using-xpathnavigator.md)   
+ [XPathNavigator によるノードの一致](../../../../docs/standard/data/xml/matching-nodes-using-xpathnavigator.md)   
+ [XPath クエリで認識されるノード型](../../../../docs/standard/data/xml/node-types-recognized-with-xpath-queries.md)   
+ [コンパイルされた XPath 式](../../../../docs/standard/data/xml/compiled-xpath-expressions.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xpathdocument-input-to-xsltransform.md b/docs/standard/data/xml/xpathdocument-input-to-xsltransform.md
new file mode 100644
index 00000000000..296fa1e2d58
--- /dev/null
+++ b/docs/standard/data/xml/xpathdocument-input-to-xsltransform.md
@@ -0,0 +1,50 @@
+---
+title: "XslTransform への XPathDocument の入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 7d1bbe8b-ed43-4e62-a5ba-d602d244f4ae
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XslTransform への XPathDocument の入力
+<xref:System.Xml.XPath.XPathDocument> は、<xref:System.Xml.Xsl.XslTransform> でドキュメントを処理するための読み取り専用キャッシュです。  <xref:System.Xml.XPath.XPathDocument> は、構造的には XML ドキュメント オブジェクト モデル \(DOM\) に似ていますが、<xref:System.Xml.XPath.XPathNavigator> で XPath 最適化関数を使用することで、XSLT \(Extensible Stylesheet Language for Transformations\) による処理と XPath \(XML Path Language\) データ モデルに高度に最適化されています。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ 変換への入力として <xref:System.Xml.XPath.XPathDocument> を作成するコード サンプルを次に示します。  
+  
+```vb  
+Dim xslt as XslTransform = new XslTransform()  
+Xslt.Load(someStylesheet)  
+Dim doc as XPathDocument = New XPathDocument("books.xml")  
+Dim fs as StringWriter = new StringWriter()  
+Xslt.Transform(doc, Nothing, fs, Nothing);  
+  
+```  
+  
+```csharp  
+XslTransform xslt = new XslTransform();  
+Xslt.Load(someStylesheet);  
+XPathDocument doc = XPathDocument("books.xml");  
+StringWriter fs = new StringWriter();  
+Xslt.Transform(doc, null, fs, null);  
+```  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xpathnavigator-in-transformations.md b/docs/standard/data/xml/xpathnavigator-in-transformations.md
new file mode 100644
index 00000000000..2a1f69de112
--- /dev/null
+++ b/docs/standard/data/xml/xpathnavigator-in-transformations.md
@@ -0,0 +1,129 @@
+---
+title: "変換における XPathNavigator | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 118f97d1-7110-4d1b-b0bd-4143252c0bb0
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 変換における XPathNavigator
+<xref:System.Xml.XPath.XPathNavigator> クラスは、データへの読み取り専用のランダム アクセスを提供し、XSLT \(Extensible Stylesheet Language for Transformations\) への入力として使用することを目的に設計されています。  このクラスは、<xref:System.Xml.XPath.XPathDocument>、<xref:System.Xml.XmlDataDocument>、および <xref:System.Xml.XmlDocument> に実装されます。  <xref:System.Xml.XPath.XPathNavigator> は、『XML Path Language \(XPath\)』勧告のセクション 5 で規定されている W3C \(World Wide Web Consortium\) データ モデルに準拠しています。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> は、任意のストアに対するカーソル モデルを定義し、任意のデータ ストアに対する高速で読み取り専用の XPath クエリを提供します。  <xref:System.Xml.XPath.XPathNavigator> クラスは、結果ツリー フラグメントの反復処理でも使用されます。  
+  
+ この API を使用すると、ストア内の現在のノードから情報を取得し、接続されているノードに移動することができます。  <xref:System.Xml.XPath.XPathNavigator> は、一連の **Move** メソッドを使用してストアの走査を実行するカーソル スタイルのモデルです。  <xref:System.Xml.XPath.XPathNavigator> は、常にノード上に配置されます。  **Move** メソッドが失敗した場合、<xref:System.Xml.XPath.XPathNavigator> は変更されません。  
+  
+ <xref:System.Xml.XPath.XPathNavigator> クラスは、結果ツリー フラグメントの反復処理で使用されます。  XML を含む `fragment` パラメーターを指定して関数を呼び出すことにより、スタイル シート内で結果ツリー フラグメントを作成するコード サンプルを次に示します。  
+  
+## test.xsl  
+  
+```  
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+                xmlns:msxsl ="urn:schemas-microsoft-com:xslt"  
+                xmlns:user="http://www.adventure-works.com"  
+                version="1.0">  
+  
+<xsl:variable name="fragment">  
+    <authorlist>  
+       <author>Joe</author>  
+    </authorlist>  
+</xsl:variable>  
+  
+<msxsl:script language="C#" implements-prefix="user">  
+<![CDATA[  
+   string NodeFragment(XPathNavigator nav)  
+   {  
+      if (nav.HasChildren)  
+        return nav.Value;  
+      else  
+        return "";  
+   }  
+]]>  
+</msxsl:script>  
+  
+<xsl:template match="/">  
+     <xsl:value-of select="user:NodeFragment($fragment)"/>  
+</xsl:template>  
+  
+</xsl:stylesheet>  
+  
+```  
+  
+## test.xml  
+  
+```  
+<root>Some text</root>  
+```  
+  
+ 次の例では、**test.xsl** スタイル シートと **test.xml** 入力データを使用しています。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.Xsl  
+Imports System.Xml.XPath  
+Imports System.Text  
+Public Class sample  
+  
+    Public Shared Sub Main()  
+        Dim xslt As New XslTransform()  
+        xslt.Load("test.xsl")  
+  
+        Dim xd As New XPathDocument("test.xml")  
+  
+        Dim strmTemp = New FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite)  
+        xslt.Transform(xd, Nothing, strmTemp, Nothing)  
+    End Sub 'Main  
+End Class 'sample  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Xsl;  
+using System.Xml.XPath;  
+using System.Text;  
+  
+public class sample  
+{  
+    public static void Main()  
+    {  
+        XslTransform xslt = new XslTransform();  
+        xslt.Load("test.xsl");  
+  
+        XPathDocument xd = new XPathDocument("test.xml");  
+  
+        Stream strmTemp = new FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite);  
+        xslt.Transform(xd, null, strmTemp, null);  
+    }  
+}  
+```  
+  
+## 出力  
+ 変換結果はファイル **out.xml** に出力されます。  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>Joe  
+  
+```  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xpathnodeiterator-in-transformations.md b/docs/standard/data/xml/xpathnodeiterator-in-transformations.md
new file mode 100644
index 00000000000..a1cb2477973
--- /dev/null
+++ b/docs/standard/data/xml/xpathnodeiterator-in-transformations.md
@@ -0,0 +1,169 @@
+---
+title: "変換における XPathNodeIterator | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 2bc6ddc6-674a-4f75-b264-abc35e4e5857
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 変換における XPathNodeIterator
+<xref:System.Xml.XPath.XPathNodeIterator> は、XPath \(XML Path Language\) クエリの結果として作成されたノード セット、または node\-set メソッドを使用して結果ツリー フラグメントから変換されたノード セットの反復処理を行うためのメソッドを提供します。  <xref:System.Xml.XPath.XPathNodeIterator> を使用すれば、そのノード セット内のノードの反復処理を実行できます。  ノード セットが取得されると、<xref:System.Xml.XPath.XPathNodeIterator> クラスは、選択されたノード セットへの読み取り専用、前方参照専用のカーソルを提供します。  ノード セットはドキュメント順に作成されるため、このメソッドを呼び出すと、ドキュメント順で次のノードに移動します。  <xref:System.Xml.XPath.XPathNodeIterator> は、セット内のすべてのノードのノード ツリーを構築するわけではありません。  その代わりに、**XPathNodeIterator** は、データへの単一ノード ウィンドウを提供し、ツリー内での移動に合わせて、自身が指している基になるノードを公開します。  <xref:System.Xml.XPath.XPathNodeIterator> クラスで利用できるメソッドとプロパティを使用すると、現在のノードから情報を取得できます。  メソッドとプロパティの一覧については、「[XPathNodeIterator メンバー](frlrfsystemxmlxpathxpathnodeiteratormemberstopic)」を参照してください。  
+  
+ <xref:System.Xml.XPath.XPathNodeIterator> は XPath クエリの結果作成されたノード セット内を前方にのみ移動するため、移動するときは <xref:System.Xml.XPath.XPathNodeIterator.MoveNext%2A> メソッドを使用します。  このメソッドの戻り値の型は  `Boolean` であり、選択されている次のノードに移動すると `true` が返り、選択されているノードがそれ以上ないと `false` が返ります。  このメソッドが `true` を返した場合は、次のプロパティを使用できます。  
+  
+-   <xref:System.Xml.XPath.XPathNodeIterator.Current%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNodeIterator.CurrentPosition%2A>  
+  
+-   <xref:System.Xml.XPath.XPathNodeIterator.Count%2A>  
+  
+ ノード セットを初めて参照するときは、<xref:System.Xml.XPath.XPathNodeIterator.MoveNext%2A> を呼び出して、選択されているセットの最初のノードに <xref:System.Xml.XPath.XPathNodeIterator> を移動する必要があります。  これにより、while ループによる書き込みが可能になります。  
+  
+ <xref:System.Xml.XPath.XPathNodeIterator> を <xref:System.Xml.Xsl.XslTransform> に <xref:System.Xml.Xsl.XsltArgumentList> 内のパラメーターとして渡すコード サンプルを次に示します。  コードへの入力は **books.xml** で、スタイル シートは **text.xsl** です。  ファイル **test.xml** は、<xref:System.Xml.XPath.XPathDocument> です。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.Xsl  
+Imports System.Xml.XPath  
+Imports System.Text  
+  
+Public Class sample  
+  
+   Public Shared Sub Main()  
+      Dim Doc As New XPathDocument("books.xml")  
+      Dim nav As XPathNavigator = Doc.CreateNavigator()  
+      Dim Iterator As XPathNodeIterator = nav.Select("/bookstore/book")  
+  
+      Dim arg As New XsltArgumentList()  
+      arg.AddParam("param1", "", Iterator)  
+  
+      Dim xslt As New XslTransform()  
+      xslt.Load("test.xsl")  
+  
+      Dim xd As New XPathDocument("test.xml")  
+  
+      Dim strmTemp = New FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite)  
+      xslt.Transform(xd, arg, strmTemp, Nothing)  
+   End Sub 'Main  
+End Class 'sample  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.Xsl;  
+using System.Xml.XPath;  
+using System.Text;  
+  
+public class sample  
+{  
+    public static void Main()  
+    {  
+        XPathDocument Doc = new XPathDocument("books.xml");  
+        XPathNavigator nav = Doc.CreateNavigator();  
+        XPathNodeIterator Iterator = nav.Select("/bookstore/book");  
+  
+        XsltArgumentList arg = new XsltArgumentList();  
+        arg.AddParam("param1", "", Iterator);  
+  
+        XslTransform xslt = new XslTransform();  
+        xslt.Load("test.xsl");  
+  
+        XPathDocument xd = new XPathDocument("test.xml");  
+  
+        Stream strmTemp = new FileStream("out.xml", FileMode.Create, FileAccess.ReadWrite);  
+        xslt.Transform(xd, arg, strmTemp, null);  
+    }  
+}  
+```  
+  
+## books.xml  
+  
+```  
+<?xml version='1.0'?>  
+<!-- This file represents a fragment of a book store inventory database. -->  
+<bookstore specialty="novel">  
+    <book style="autobiography">  
+    <title>Seven Years in Trenton</title>  
+        <author>  
+            <first-name>Jay</first-name>  
+            <last-name>Adams</last-name>  
+            <award>Trenton Literary Review Honorable Mention</award>  
+            <country>USA</country>  
+        </author>  
+        <price>12</price>  
+    </book>  
+    <book style="textbook">  
+        <title>History of Trenton</title>  
+        <author>  
+            <first-name>Kim</first-name>  
+            <last-name>Akers</last-name>  
+            <publication>  
+                Selected Short Stories of  
+                <first-name>Scott</first-name>  
+                <last-name>Bishop</last-name>  
+                <country>US</country>  
+            </publication>  
+        </author>  
+        <price>55</price>  
+    </book>  
+</bookstore>  
+```  
+  
+## test.xsl  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+xmlns:msxsl="urn:schemas-microsoft-com:xslt" exclude-result-prefixes="msxsl">  
+  
+<xsl:output method="xml" indent="yes"/>  
+<xsl:param name="param1"/>  
+  
+<xsl:template match="/">  
+    <out>  
+        <xsl:for-each select="$param1/title">  
+            <title><xsl:value-of select="."/></title>  
+        </xsl:for-each>  
+    </out>  
+</xsl:template>  
+  
+</xsl:stylesheet>  
+```  
+  
+## test.xml  
+  
+```  
+<Title attr="Test">this is a test</Title>  
+```  
+  
+## 出力 \(out.xml\)  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<out>  
+  <title>Seven Years in Trenton</title>  
+  <title>History of Trenton</title>  
+</out>  
+```  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-compiler-xsltc-exe.md b/docs/standard/data/xml/xslt-compiler-xsltc-exe.md
new file mode 100644
index 00000000000..6124b70d848
--- /dev/null
+++ b/docs/standard/data/xml/xslt-compiler-xsltc-exe.md
@@ -0,0 +1,97 @@
+---
+title: "XSLT コンパイラ (xsltc.exe) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 672a5ac8-8305-4d28-ba10-11089c2c0924
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XSLT コンパイラ (xsltc.exe)
+XSLT コンパイラ \(xsltc.exe\) は、XSLT スタイル シートをコンパイルしてアセンブリを生成します。  コンパイルしたスタイル シートを <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Type%29?displayProperty=fullName> メソッドに直接渡すことができます。  xsltc.exe を使用して署名があるアセンブリを生成することはできません。  
+  
+ xsltc.exe ツールは Visual Studio 2008 に付属しています。  詳細については、「[Microsoft ダウンロード センター](http://go.microsoft.com/fwlink/?LinkId=89463)」を参照してください。  
+  
+## 構文  
+  
+```  
+xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]  
+```  
+  
+## 引数  
+  
+|引数|説明|  
+|--------|--------|  
+|`sourceFile`|スタイル シートの名前を指定します。  スタイル シートはローカル ファイルであるか、イントラネット上に置かれていることが必要です。|  
+  
+## オプション  
+  
+|オプション|説明|  
+|-----------|--------|  
+|`/c[lass]:` `name`|以降のスタイル シートのクラス名を指定します。  クラス名には完全修飾名を指定できます。<br /><br /> 既定のクラス名は、スタイル シートの名前です。  たとえば、スタイル シート customers.xsl をコンパイルした場合、既定のクラス名は customers になります。|  
+|`/debug[`\+&#124;\-`]`|デバッグ情報を生成するかどうかを指定します。<br /><br /> `+` または `/debug` を指定すると、コンパイラによりデバッグ情報が生成され、プログラム データベース \(PDB\) ファイルに記録されます。  生成される PDB ファイルの名前は `assemblyName`.pdb です。<br /><br /> `/debug` を指定しない場合、`-` の指定が有効となります。これを指定した場合、デバッグ情報は作成されません。  製品版のアセンブリが生成されます。 **Note:**  デバッグ モードでコンパイルすると、XSLT のパフォーマンスが大きな影響を受けることがあります。|  
+|`/help`|このツールのコマンド構文とオプションを表示します。|  
+|`/nologo`|コンパイラの著作権メッセージが表示されないようにします。|  
+|`/platform:` `string`|アセンブリを実行できるプラットフォームを指定します。  次に、有効なプラットフォームの値を示します。<br /><br /> `x86` : 32 ビット x86 互換共通言語ランタイムにより実行できるように、アセンブリをコンパイルします。<br /><br /> `x64` : AMD64 または EM64T 命令セットをサポートするコンピューターで 64 ビット共通言語ランタイムにより実行できるように、アセンブリをコンパイルします<br /><br /> [!INCLUDE[vcpritanium](../../../../includes/vcpritanium-md.md)] : [!INCLUDE[vcpritanium](../../../../includes/vcpritanium-md.md)] プロセッサを搭載したコンピューターで 64 ビット共通言語ランタイムにより実行できるように、アセンブリをコンパイルします。<br /><br /> `anycpu` : 任意のプラットフォーム上で実行できるように、アセンブリをコンパイルします。  既定値です。|  
+|`/out:` `assemblyName`|出力となるアセンブリの名前を指定します。  複数のスタイル シートが存在している場合、既定のアセンブリ名はメインのスタイル シートか最初のスタイル シートの名前になります。<br /><br /> スタイル シートにスクリプトが含まれている場合、スクリプトは別のアセンブリに保存されます。  スクリプト アセンブリ名は、メインのアセンブリ名から生成されます。  たとえば、アセンブリ名を CustOrders.dll と指定した場合、最初のスクリプト アセンブリは CustOrders\_Script1.dll という名前になります。|  
+|`/settings:` `document+-, script+-, DTD+-,`|スタイル シートで `document()` 関数、XSLT スクリプト、またはドキュメント型定義 \(DTD\) を許可するかどうかを指定します。<br /><br /> 既定では、DTD、`document()` 関数、スクリプトのサポートは無効になっています。|  
+|`@` `file`|コンパイラ オプションを含むファイルを指定できます。|  
+|`?`|このツールのコマンド構文とオプションを表示します。|  
+  
+## 解説  
+ XSLT ソリューションは、複数のスタイル シート モジュールで構成できます。  xsltc.exe ツールを使用して、スタイル シートからアセンブリを生成できます。  このアセンブリを <xref:System.Xml.Xsl.XslCompiledTransform.Load%28System.Type%29?displayProperty=fullName> メソッドに直接渡すことができます。  XSLT の配置シナリオによっては、これによってパフォーマンス コストを削減できます。  
+  
+> [!NOTE]
+>  アプリケーションには、コンパイル済みのアセンブリも参照として含める必要があります。  
+  
+ xsltc.exe ツールでは、クラス名 \(`/class:``name`\) やアセンブリ名 \(`/out:``assemblyName`\) が検証されません。  名前が無効である場合、共通言語ランタイムによってエラーがスローされます。  
+  
+## 例  
+ 次のコマンドを実行すると、スタイル シートがコンパイルされ、booksort.dll という名前のアセンブリが作成されます。  
+  
+```  
+xsltc booksort.xsl  
+```  
+  
+ 次のコマンドを実行すると、スタイル シートがコンパイルされ、booksort.dll という名前のアセンブリと booksort.pdb という名前の PDB ファイルが作成されます。  
+  
+```  
+xsltc booksort.xsl /debug  
+```  
+  
+ 次のコマンドを実行すると、msxsl:script 要素を含むスタイル シートがコンパイルされ、calc.dll および calc\_Script1.dll という 2 つのアセンブリが作成されます。  
+  
+```  
+xsltc /settings:script+ calc.xsl  
+```  
+  
+ 次のコマンドを実行すると、DTD 処理とスタイルのサポートが有効になり、myTest.dll および myTest\_Script1.dll という 2 つのアセンブリが作成されます。  
+  
+```  
+xsltc /settings:DTD+,script+ /out:myTest calc.xsl  
+```  
+  
+ 次のコマンドを実行すると、2 つのスタイル シート モジュールがコンパイルされ、booksort.dll という名前のアセンブリが 1 つ作成されます。  
+  
+```  
+xsltc booksort.xsl output.xsl  
+```  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XslCompiledTransform>   
+ [方法 : アセンブリを使用して XSLT 変換を実行する](../../../../docs/standard/data/xml/how-to-perform-an-xslt-transformation-by-using-an-assembly.md)   
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-extension-objects.md b/docs/standard/data/xml/xslt-extension-objects.md
new file mode 100644
index 00000000000..ce949279292
--- /dev/null
+++ b/docs/standard/data/xml/xslt-extension-objects.md
@@ -0,0 +1,52 @@
+---
+title: "XSLT 拡張オブジェクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: a4ebdbad-087c-4cfe-acc0-17c48142f81a
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XSLT 拡張オブジェクト
+拡張オブジェクトは、スタイル シートの機能を拡張する場合に使用します。  拡張オブジェクトは、<xref:System.Xml.Xsl.XsltArgumentList> クラスによって維持されます。  
+  
+ 埋め込みスクリプトではなく、拡張オブジェクトを使用する利点を次に示します。  
+  
+-   クラスをより効果的にカプセル化および再利用できます。  
+  
+-   スタイル シートを小さくすることができ、管理が簡単になります。  
+  
+ XSLT 拡張オブジェクトを <xref:System.Xml.Xsl.XsltArgumentList> オブジェクトに追加するには、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを使用します。  その時点で、修飾名と名前空間 URI がその拡張オブジェクトに関連付けられます。  
+  
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを呼び出すには、FullTrust アクセス許可セットが必要です。  詳細については、「[Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)」および「[NIB: Named Permission Sets](http://msdn.microsoft.com/ja-jp/08250d67-c99d-4ab0-8d2b-b0e12019f6e3)」を参照してください。  
+  
+ 拡張オブジェクトが返すデータ型は、4 つの基本 XPath データ型である `number`、`string`、`Boolean`、および `node set` のうちのいずれかになります。  
+  
+ 現在、`params` キーワードを使用して定義されるメソッド \(不特定数のパラメーターを渡すことができる\) は、<xref:System.Xml.Xsl.XslCompiledTransform> クラスでサポートされていません。  `params` キーワードを使用して定義されたメソッドを使用する XSLT スタイル シートは、正しく動作しません。  詳細については、「[params](../Topic/params%20\(C%23%20Reference\).md)」を参照してください。  
+  
+### XSLT 拡張オブジェクトを使用するために必要な処理  
+  
+1.  <xref:System.Xml.Xsl.XsltArgumentList> オブジェクトを作成し、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを使用して拡張オブジェクトを追加します。  
+  
+2.  スタイル シートから拡張オブジェクトを呼び出します。  
+  
+3.  <xref:System.Xml.Xsl.XsltArgumentList> オブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡します。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)   
+ [XSLT のセキュリティに関する考慮事項](../../../../docs/standard/data/xml/xslt-security-considerations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-parameters.md b/docs/standard/data/xml/xslt-parameters.md
new file mode 100644
index 00000000000..c3e6fe20cb5
--- /dev/null
+++ b/docs/standard/data/xml/xslt-parameters.md
@@ -0,0 +1,78 @@
+---
+title: "XSLT パラメーター | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: fe60aaa0-ae43-4b1c-9be1-426af66ba757
+caps.latest.revision: 2
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 2
+---
+# XSLT パラメーター
+XSLT パラメーターを <xref:System.Xml.Xsl.XsltArgumentList> に追加するには、<xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> メソッドを使用します。  その時点で、修飾名と名前空間 URI がそのパラメーター オブジェクトに関連付けられます。  
+  
+### XSLT パラメーターを使用するために必要な処理  
+  
+1.  <xref:System.Xml.Xsl.XsltArgumentList> オブジェクトを作成し、<xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> メソッドを使用してパラメーターを追加します。  
+  
+2.  スタイル シートからパラメーターを呼び出します。  
+  
+3.  <xref:System.Xml.Xsl.XsltArgumentList> オブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドに渡します。  
+  
+## パラメーターの型  
+ このパラメーター オブジェクトは、W3C 型に対応している必要があります。  対応する W3C 型、これと同等の Microsoft .NET のクラス \(型\)、および W3C 型が XPath 型か XSLT 型であるかを次の表に示します。  
+  
+|W3C 型|対応する .NET クラス \(型\)|XPath 型または XSLT 型|  
+|-----------|-------------------------|-----------------------|  
+|`String`|<xref:System.String?displayProperty=fullName>|XPath|  
+|`Boolean`|<xref:System.Boolean?displayProperty=fullName>|XPath|  
+|`Number`|<xref:System.Double?displayProperty=fullName>|XPath|  
+|`Result Tree Fragment`|<xref:System.Xml.XPath.XPathNavigator?displayProperty=fullName>|XSLT|  
+|`Node*`|<xref:System.Xml.XPath.XPathNavigator?displayProperty=fullName>|XPath|  
+|`Node Set`|<xref:System.Xml.XPath.XPathNodeIterator><br /><br /> **XPathNavigator\[\]**|XPath|  
+  
+ \* これは単一のノードを含むノード セットに相当します。  
+  
+ パラメーター オブジェクトが上記のクラスのいずれでもない場合、次の規則に従って型が変換されます。  共通言語ランタイム \(CLR\) の数値型は、<xref:System.Double> に変換されます。  <xref:System.DateTime> 型は <xref:System.String> に変換されます。  <xref:System.Xml.XPath.IXPathNavigable> 型は <xref:System.Xml.XPath.XPathNavigator> に変換されます。  **XPathNavigator\[\]** は <xref:System.Xml.XPath.XPathNodeIterator> に変換されます。  
+  
+ その他の型はエラーになります。  
+  
+## 例  
+ 算出された割引日を保持するパラメーターを <xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> メソッドを使用して作成する例を次に示します。  割引日は、発注日から 20 日後として算出されます。  
+  
+ [!code-csharp[XSLT_Param#1](../../../../samples/snippets/csharp/VS_Snippets_Data/XSLT_Param/CS/xsltparam.cs#1)]
+ [!code-vb[XSLT_Param#1](../../../../samples/snippets/visualbasic/VS_Snippets_Data/XSLT_Param/VB/xsltparam.vb#1)]  
+  
+### 入力  
+  
+##### order.xml  
+ [!code-xml[XSLT_Param#2](../../../../samples/snippets/xml/VS_Snippets_Data/XSLT_Param/XML/order.xml#2)]  
+  
+##### discount.xsl  
+ [!code-xml[XSLT_Param#3](../../../../samples/snippets/xml/VS_Snippets_Data/XSLT_Param/XML/discount.xsl#3)]  
+  
+### 出力  
+  
+```  
+<?xml version="1.0" encoding="utf-8"?>  
+<order>  
+  <total>36.9</total>  
+     15% discount if paid by: 2/4/2004 12:00:00 AM  
+</order>  
+```  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-security-considerations.md b/docs/standard/data/xml/xslt-security-considerations.md
new file mode 100644
index 00000000000..5bc3047cab0
--- /dev/null
+++ b/docs/standard/data/xml/xslt-security-considerations.md
@@ -0,0 +1,71 @@
+---
+title: "XSLT のセキュリティに関する考慮事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: fea695be-617c-4977-9567-140e820436fc
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# XSLT のセキュリティに関する考慮事項
+XSLT 言語には、優れた性能と柔軟性を兼ね備えた豊富な機能が用意されています。  ただし、多くの機能を利用できることが便利であると同時に、外部から不正に利用される可能性もあります。  XSLT を安全に使用するために、XSLT の使用に伴うさまざまなセキュリティ上の問題とそのリスクを軽減するための基本的な対策を理解しておく必要があります。  
+  
+## XSLT 拡張機能  
+ スタイル シート スクリプトと拡張オブジェクトの 2 つは、XSLT の一般的な拡張機能です。  これらの拡張機能を使用すると、XSLT プロセッサでコードを実行できます。  
+  
+-   拡張オブジェクトは、XSLT にプログラミング機能を追加します。  
+  
+-   スクリプトは、拡張要素である `msxsl:script` 要素を使用してスタイル シートに埋め込むことができます。  
+  
+### 拡張オブジェクト  
+ 拡張オブジェクトは、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを使用して追加します。  拡張オブジェクトをサポートするには、FullTrust アクセス許可セットが必要です。  このアクセス許可セットを設定すれば、拡張オブジェクト コードの実行時にアクセス許可の昇格が起こりません。  FullTrust アクセス許可なしで <xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを呼び出そうとすると、セキュリティ例外がスローされます。  
+  
+### スタイル シート スクリプト  
+ スクリプトは、`msxsl:script` 拡張要素を使用してスタイル シートに埋め込むことができます。  スクリプトのサポートは、<xref:System.Xml.Xsl.XslCompiledTransform> クラス \(既定で無効\) のオプションの機能です。  スクリプト機能を有効にするには、<xref:System.Xml.Xsl.XsltSettings.EnableScript%2A?displayProperty=fullName> プロパティを `true` に設定して、<xref:System.Xml.Xsl.XsltSettings> オブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドに渡します。  
+  
+#### ガイドライン  
+ スクリプト機能を有効にするのは、スタイル シートの作成元が信頼できる場合のみにしてください。  スタイル シートの作成元が確認できない場合、またはスタイル シートの作成元が信頼できない場合には、XSLT 設定の引数に `null` を渡してください。  
+  
+## 外部リソース  
+ XSLT 言語には、`xsl:import`、`xsl:include`、または `document()` 関数などの機能があります。これらの機能では、プロセッサが URI リファレンスを解決する必要があります。  外部リソースを解決するには、<xref:System.Xml.XmlResolver> クラスを使用します。  外部リソースの解決が必要になる可能性があるのは、次の 2 つの場合です。  
+  
+-   スタイル シートをコンパイルする場合には、`xsl:import` および `xsl:include` を解決するために <xref:System.Xml.XmlResolver> を使用します。  
+  
+-   変換を実行する場合には、`document()` 関数を解決するために <xref:System.Xml.XmlResolver> を使用します。  
+  
+    > [!NOTE]
+    >  <xref:System.Xml.Xsl.XslCompiledTransform> クラスでは、`document()` 関数は既定で無効になっています。  この機能を有効にするには、<xref:System.Xml.Xsl.XsltSettings.EnableDocumentFunction%2A?displayProperty=fullName> プロパティを `true` に設定して、<xref:System.Xml.Xsl.XsltSettings> オブジェクトを <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> メソッドに渡します。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform.Load%2A> および <xref:System.Xml.Xsl.XslCompiledTransform.Transform%2A> メソッドには、<xref:System.Xml.XmlResolver> を引数の 1 つとして許容するオーバーロードがそれぞれ含まれます。  <xref:System.Xml.XmlResolver> を指定しない場合は、資格情報を持たない既定の <xref:System.Xml.XmlUrlResolver> が使用されます。  
+  
+#### ガイドライン  
+ `document()` 関数を有効にするのは、スタイル シートの作成元が信頼できる場合のみにしてください。  
+  
+ <xref:System.Xml.XmlResolver> オブジェクトを使用する場合の説明を次の一覧に示します。  
+  
+-   XSLT 処理で認証が必要なネットワーク リソースにアクセスする必要がある場合、必要な資格情報に対して <xref:System.Xml.XmlResolver> を使用します。  
+  
+-   XSLT 処理がアクセスできるリソースを制限する場合、適切なアクセス許可セットに対して <xref:System.Xml.XmlSecureResolver> を使用します。  制御対象外の \(信頼できない\) リソースを開く場合には、<xref:System.Xml.XmlSecureResolver> クラスを使用します。  
+  
+-   動作をカスタマイズする場合は、独自の <xref:System.Xml.XmlResolver> クラスを実装し、これを使用してリソースを解決することができます。  
+  
+-   外部リソースにアクセスできないようにする場合は、<xref:System.Xml.XmlResolver> の引数に `null` を指定します。  
+  
+## 参照  
+ [XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations.md)   
+ [XSLT 処理中の外部リソースの解決](../../../../docs/standard/data/xml/resolving-external-resources-during-xslt-processing.md)   
+ [Code Access Security](http://msdn.microsoft.com/ja-jp/23a20143-241d-4fe5-9d9f-3933fd594c03)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-stylesheet-scripting-using-msxsl-script.md b/docs/standard/data/xml/xslt-stylesheet-scripting-using-msxsl-script.md
new file mode 100644
index 00000000000..633ae194008
--- /dev/null
+++ b/docs/standard/data/xml/xslt-stylesheet-scripting-using-msxsl-script.md
@@ -0,0 +1,240 @@
+---
+title: "&lt;msxsl:script&gt; を使用した XSLT スタイルシートのスクリプト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 60e2541b-0cea-4b2e-a4fa-85f4c50f1bef
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# &lt;msxsl:script&gt; を使用した XSLT スタイルシートのスクリプト
+<xref:System.Xml.Xsl.XslTransform> クラスは、`script` 要素を使用した埋め込みスクリプトをサポートしています。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ <xref:System.Xml.Xsl.XslTransform> クラスは、`script` 要素を使用した埋め込みスクリプトをサポートしています。  スタイル シートが読み込まれると、定義されているすべての関数がクラス定義でラップされることによって Microsoft Intermediate Language \(MSIL\) にコンパイルされるため、パフォーマンスが低下しません。  
+  
+ `<msxsl:script>` 要素は、次のように定義されます。  
+  
+```  
+<msxsl:script language = "language-name" implements-prefix = "prefix of user namespace"> </msxsl:script>  
+```  
+  
+ `msxsl` は、名前空間 `urn:schemas-microsoft-com:xslt` に関連付けられたプレフィックスです。  
+  
+ `language` 属性は必須ではありませんが、指定する場合は、値を C\#、VB、JScript、JavaScript、VisualBasic、または CSharp のいずれかにする必要があります。  **language** 属性を指定しない場合、既定の言語は JScript です。  `language-name` では大文字小文字が区別されないため、"JavaScript" と "javascript" は同じものと見なされます。  
+  
+ `implements-prefix` 属性は必須です。  この属性は、名前空間を宣言し、それをスクリプト ブロックに関連付けるために使用されます。  この属性の値は、名前空間を表すプレフィックスです。  この名前空間は、スタイル シート内の任意の場所で定義できます。  
+  
+ `msxsl:script` 要素は名前空間 `urn:schemas-microsoft-com:xslt` に属しているため、スタイル シートには、名前空間宣言 `xmlns:msxsl=urn:schemas-microsoft-com:xslt` が含まれている必要があります。  
+  
+ スクリプトの呼び出し元が [UnmanagedCode](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) へのアクセス許可を持っていない場合は、スタイル シート内のスクリプトがコンパイルされず、<xref:System.Xml.Xsl.XslTransform.Load%2A> への呼び出しが失敗します。  
+  
+ 呼び出し元が `UnmanagedCode` へのアクセス許可を持っている場合、スクリプトはコンパイルされますが、許可される操作は、読み込み時に指定される証拠によって異なります。  
+  
+ <xref:System.Xml.XmlReader> または <xref:System.Xml.XPath.XPathNavigator> を受け取る <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドを使用してスタイル シートを読み込む場合は、<xref:System.Security.Policy.Evidence> パラメーターを引数として受け取る <xref:System.Xml.Xsl.XslTransform.Load%2A> オーバーロードを使用する必要があります。  証拠を指定する場合、呼び出し元は、スクリプト アセンブリの `Evidence` を渡すための [ControlEvidence](frlrfSystemSecurityPermissionsSecurityPermissionFlagClassTopic) へのアクセス許可を持っている必要があります。  呼び出し元がこのアクセス許可を持っていない場合は、`Evidence` パラメーターが `null` に設定されることがあります。  その場合は、<xref:System.Xml.Xsl.XslTransform.Load%2A> 関数がスクリプトを見つけると、処理が失敗します。  `ControlEvidence` へのアクセス許可は、非常に強力なアクセス権であるため、信頼性の高いコード以外に与えてはいけません。  
+  
+ アセンブリから証拠を取得するには、`this.GetType().Assembly.Evidence` を使用します。  URI \(Uniform Resource Identifier\) から証拠を取得するには、`Evidence e = XmlSecureResolver.CreateEvidenceForUrl(stylesheetURI)` を使用します。  
+  
+ <xref:System.Xml.XmlResolver> を受け取り、`Evidence` を受け取らない <xref:System.Xml.Xsl.XslTransform.Load%2A> メソッドを使う場合、アセンブリのセキュリティ ゾーンは既定で Full Trust に設定されます。  詳細については、「<xref:System.Security.SecurityZone>」と「[名前付き権限セット](http://msdn.microsoft.com/ja-jp/08250d67-c99d-4ab0-8d2b-b0e12019f6e3)」を参照してください。  
+  
+ 関数は、`msxsl:script` 要素内で宣言できます。  既定でサポートされる名前空間を次の表に示します。  表に示す名前空間の外側でもクラスを使用できます。  ただし、これらのクラスには、完全修飾名が指定されている必要があります。  
+  
+|既定の名前空間|説明|  
+|-------------|--------|  
+|システム|システム クラス|  
+|System.Collection|コレクション クラス|  
+|System.Text|テキスト クラス|  
+|System.Text.RegularExpressions|正規表現クラス|  
+|System.Xml|コア XML クラス|  
+|System.Xml.Xsl|XSLT クラス|  
+|System.Xml.XPath|XPath \(XML Path Language\) クラス|  
+|Microsoft.VisualBasic|Microsoft Visual Basic スクリプト用のクラス|  
+  
+ 関数が宣言されると、その関数はスクリプト ブロックに含まれます。  スタイル シートには、相互に独立して機能する複数のスクリプト ブロックを含めることができます。  このため、1 つのスクリプト ブロック内で実行しているときに、別のスクリプト ブロックで定義した関数を呼び出すことはできません。ただし、そのブロックが同じ名前空間とスクリプト言語を持つように宣言されている場合は例外です。  各スクリプト ブロックは独自の言語で記述でき、ブロックはその言語に対応するパーサーの文法規則に従って解析されるため、使われている言語の正しい構文を使用する必要があります。  たとえば、C\# スクリプト ブロック内で XML コメント ノード `<!-- an XML comment -->` を使用すると、エラーが発生します。  
+  
+ スクリプト関数で定義されている引数および戻り値は、W3C \(World Wide Web Consortium\) XPath 型または XSLT 型のいずれかである必要があります。  対応する W3C 型、それと同等の .NET Framework のクラス \(型\)、および W3C 型が XPath 型または XSLT 型のどちらかを次の表に示します。  
+  
+|種類|対応する .NET Framework クラス \(型\)|XPath 型または XSLT 型|  
+|--------|-----------------------------------|-----------------------|  
+|String|System.String|XPath|  
+|Boolean|System.Boolean|XPath|  
+|Number|System.Double|XPath|  
+|Result Tree Fragment|System.Xml.XPath.XPathNavigator|XSLT|  
+|Node Set|System.Xml.XPath.XPathNodeIterator|XPath|  
+  
+ スクリプト関数が数値型 Int16、UInt16、Int32、UInt32、Int64、UInt64、Single、または Decimal を使用する場合、これらの数値型は、W3C XPath 数値型に対応する Double に強制的に変換されます。  その他の型はすべて、`ToString` メソッドを呼び出して強制的に文字列に変換されます。  
+  
+ スクリプト関数が上記以外の型を使用したり、スタイル シートが <xref:System.Xml.Xsl.XslTransform> オブジェクトに読み込まれるときにスクリプト関数がコンパイルを実行しなかったりすると、例外がスローされます。  
+  
+ `msxsl:script` 要素を使用するときは、言語に関係なく、スクリプトを CDATA セクション内に配置することをお勧めします。  コードが配置されている CDATA セクションのテンプレートを示す XML の例を次に示します。  
+  
+```  
+<msxsl:script implements-prefix='yourprefix' language='CSharp'>  
+    <![CDATA[  
+    ... your code here ...  
+    ]]>  
+</msxsl:script>  
+```  
+  
+ 特定の言語の演算子、識別子、または区切り記号が誤って XML として解釈される可能性があるため、スクリプトのすべての内容を CDATA セクション内に配置することをお勧めします。  スクリプトで論理 AND 演算子を使用する例を次に示します。  
+  
+```  
+<msxsl:script implements-prefix='yourprefix' language='CSharp>  
+    public string book(string abc, string xyz)  
+    {  if ((abc== abc)&&(abc== xyz)) return bar+xyz;  
+        else return null;  
+    }  
+</msxsl:script>  
+```  
+  
+ この例では、アンパサンドがエスケープされないため、結果として例外がスローされます。  このドキュメントは XML として読み込まれ、`msxsl:script` 要素タグ間にあるテキストに対して特別な処理は適用されません。  
+  
+## 例  
+ 埋め込みスクリプトを使用して、半径が指定された円の円周を算出する例を次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.XPath  
+Imports System.Xml.Xsl  
+  
+Public Class Sample  
+  
+   Private Const filename As String = "number.xml"  
+   Private Const stylesheet As String = "calc.xsl"  
+  
+   Public Shared Sub Main()  
+  
+    'Create the XslTransform and load the style sheet.  
+    Dim xslt As XslTransform = New XslTransform  
+    xslt.Load(stylesheet)  
+  
+    'Load the XML data file.  
+    Dim doc As XPathDocument = New XPathDocument(filename)  
+  
+    'Create an XmlTextWriter to output to the console.               
+    Dim writer As XmlTextWriter = New XmlTextWriter(Console.Out)  
+    writer.Formatting = Formatting.Indented  
+  
+    'Transform the file.  
+    xslt.Transform(doc, Nothing, writer, Nothing)  
+    writer.Close()  
+  End Sub   
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.XPath;  
+using System.Xml.Xsl;  
+  
+public class Sample  
+{  
+   private const String filename = "number.xml";  
+   private const String stylesheet = "calc.xsl";  
+  
+   public static void Main() {  
+  
+    //Create the XslTransform and load the style sheet.  
+    XslTransform xslt = new XslTransform();  
+    xslt.Load(stylesheet);  
+  
+    //Load the XML data file.  
+    XPathDocument doc = new XPathDocument(filename);  
+  
+    //Create an XmlTextWriter to output to the console.               
+    XmlTextWriter writer = new XmlTextWriter(Console.Out);  
+    writer.Formatting = Formatting.Indented;  
+  
+    //Transform the file.  
+    xslt.Transform(doc, null, writer, null);  
+    writer.Close();  
+  }   
+}  
+```  
+  
+## 入力  
+ number.xml  
+  
+```  
+<?xml version='1.0'?>  
+<data>  
+  <circle>  
+    <radius>12</radius>  
+  </circle>  
+  <circle>  
+    <radius>37.5</radius>  
+  </circle>  
+</data>  
+```  
+  
+ calc.xsl  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+    xmlns:msxsl="urn:schemas-microsoft-com:xslt"  
+    xmlns:user="urn:my-scripts">  
+  
+  <msxsl:script language="C#" implements-prefix="user">  
+     <![CDATA[  
+     public double circumference(double radius){  
+       double pi = 3.14;  
+       double circ = pi*radius*2;  
+       return circ;  
+     }  
+      ]]>  
+   </msxsl:script>  
+  
+  <xsl:template match="data">    
+  <circles>  
+  
+  <xsl:for-each select="circle">  
+    <circle>  
+    <xsl:copy-of select="node()"/>  
+       <circumference>  
+          <xsl:value-of select="user:circumference(radius)"/>   
+       </circumference>  
+    </circle>  
+  </xsl:for-each>  
+  </circles>  
+  </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+## 出力  
+  
+```  
+<circles xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">  
+  <circle>  
+    <radius>12</radius>  
+    <circumference>75.36</circumference>  
+  </circle>  
+  <circle>  
+    <radius>37.5</radius>  
+    <circumference>235.5</circumference>  
+  </circle>  
+</circles>    
+```  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-transformations-over-different-stores.md b/docs/standard/data/xml/xslt-transformations-over-different-stores.md
new file mode 100644
index 00000000000..31476494675
--- /dev/null
+++ b/docs/standard/data/xml/xslt-transformations-over-different-stores.md
@@ -0,0 +1,33 @@
+---
+title: "異なるストアでの XSLT 変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 369850e9-004a-45d2-b5c3-5060d9135adb
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# 異なるストアでの XSLT 変換
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ ADO.NET と [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の XML クラスは、データ アクセス用の統合プログラミング モデルとして機能します。  そのデータは、XML データ \(タグで区切られたテキスト\) とリレーショナル データ \(行と列で構成されたテーブル\) のどちらとしても表されます。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の XML は、XML データを任意のデータ ストリームから XML ドキュメント オブジェクト モデル \(DOM\) ノード ツリーに読み込みます。読み込まれたデータにはプログラムからアクセスできます。一方、ADO.NET は、<xref:System.Data.DataSet> オブジェクト内のリレーショナル データにアクセスし、それを操作する手段を提供します。  
+  
+ XML DOM により、XML ドキュメント内のデータや追加のクラスにアクセスして、XML ドキュメント内で読み取り、書き込み、および移動を行うことができます。  これらのクラスは、<xref:System.Xml> 名前空間でサポートされます。この名前空間は、XML DOM と ADO.NET が提供するデータ アクセス サービスを統合する役割も果たします。  <xref:System.Xml.XmlDataDocument> は、データへのリレーショナル アクセスを可能にします。  <xref:System.Xml.XmlDataDocument> は、XML を ADO.NET <xref:System.Data.DataSet> 内のリレーショナル データに対応付けます。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] ベースのアプリケーションであれば、<xref:System.Xml> 名前空間内のクラスを使用して、XML ドキュメントと <xref:System.Xml.XmlDataDocument> 内のリレーショナル データの両方にアクセスし、それらを操作できます。  この実装は、データを収集したり、分散させたりするための n 層アーキテクチャをサポートします。  詳細については、「[XML とリレーショナル データおよび ADO.NET との統合](../../../../docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md)」を参照してください。  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md b/docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md
new file mode 100644
index 00000000000..233e518852b
--- /dev/null
+++ b/docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md
@@ -0,0 +1,111 @@
+---
+title: "XslTransform クラスを使用した XSLT 変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 500335af-f9b5-413b-968a-e6d9a824478c
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XslTransform クラスを使用した XSLT 変換
+> [!NOTE]
+>  <xref:System.Xml.Xsl.XslTransform> では、[!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT \(Extensible Stylesheet Language for Transformations\) 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」と「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ XSLT の目的は、たとえば、XML を Web サイトで使われる HTML に変換したり、XML ドキュメントをアプリケーションが必要とするフィールドのみが含まれたドキュメントに変換するなど、ソース XML ドキュメントの内容を形式や構造の異なる別のドキュメントに変換することです。  この変換処理の仕様は、www.w3.org\/TR\/xslt にある W3C \(World Wide Web Consortium\) 勧告『XSLT Version 1.0』で規定されています。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] では、<xref:System.Xml.Xsl.XslTransform> 名前空間にある <xref:System.Xml.Xsl> クラスが、この仕様の機能を実装する XSLT プロセッサです。  W3C 勧告『XSLT Version 1.0』から実装された機能の他に、「[XslTransform からの出力](../../../../docs/standard/data/xml/outputs-from-an-xsltransform.md)」に記載されている機能がいくつかあります。  [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の変換アーキテクチャを次の図に示します。  
+  
+## 概要  
+ ![XSLT 変換アーキテクチャ](../../../../docs/standard/data/xml/media/xslttransformationswithxsltransformclass.gif "xsltTransformationsWithXslTransformClass")  
+変換アーキテクチャ  
+  
+ XSLT 勧告では、XPath \(XML Path Language\) を使って XML ドキュメントの一部を選択します。XPath とは、ドキュメント ツリーのノード間を移動するのに使われるクエリ言語です。  図に示すように、XPath の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] の実装は、<xref:System.Xml.XmlDocument>、<xref:System.Xml.XmlDataDocument>、<xref:System.Xml.XPath.XPathDocument> など、複数のクラスに格納されている XML の一部を選択するのに使用されます。  <xref:System.Xml.XPath.XPathDocument> は最適化された XSLT データ ストアであり、これを <xref:System.Xml.Xsl.XslTransform> と共に使用することで、パフォーマンスの高い XSLT 変換を実行できます。  
+  
+ <xref:System.Xml.Xsl.XslTransform> と XPath を使用するときによく使われるクラスと、それぞれの機能を次の表に示します。  
+  
+|クラスまたはインターフェイス|関数|  
+|--------------------|--------|  
+|<xref:System.Xml.XPath.XPathNavigator>|ストア内で移動するためのカーソル スタイルのモデルを提供し、XPath クエリをサポートする API です。  元になるストアを編集する機能は提供しません。  編集には <xref:System.Xml.XmlDocument> クラスを使用します。|  
+|<xref:System.Xml.XPath.IXPathNavigable>|`CreateNavigator` に <xref:System.Xml.XPath.XPathNavigator> メソッドを提供するストア用のインターフェイスです。|  
+|<xref:System.Xml.XmlDocument>|対象のドキュメントの編集を有効にします。  このクラスは <xref:System.Xml.XPath.IXPathNavigable> を実装しているため、後で XSLT 変換が必要になるドキュメントの編集が可能です。  詳細については、「[XslTransform への XmlDocument の入力](../../../../docs/standard/data/xml/xmldocument-input-to-xsltransform.md)」を参照してください。|  
+|<xref:System.Xml.XmlDataDocument>|これは <xref:System.Xml.XmlDocument> の派生クラスです。  このクラスは、<xref:System.Data.DataSet> を使用してリレーショナル環境と XML 環境との橋渡しをし、<xref:System.Data.DataSet> で指定された対応付けに従って XML ドキュメント内の構造化データのストレージを最適化します。  このクラスは <xref:System.Xml.XPath.IXPathNavigable> を実装しているため、データベースから取得したリレーショナル データに対して XSLT 変換を実行できます。  詳細については、「[XML とリレーショナル データおよび ADO.NET との統合](../../../../docs/standard/data/xml/xml-integration-with-relational-data-and-adonet.md)」を参照してください。|  
+|<xref:System.Xml.XPath.XPathDocument>|このクラスは、<xref:System.Xml.Xsl.XslTransform> の処理および XPath クエリ用に最適化されており、パフォーマンスの高い読み取り専用キャッシュを提供します。  このクラスは <xref:System.Xml.XPath.IXPathNavigable> を実装しており、XSLT 変換に使用するストアとして適しています。|  
+|<xref:System.Xml.XPath.XPathNodeIterator>|XPath ノード セット内を移動できるようにします。  <xref:System.Xml.XPath.XPathNavigator> のすべての XPath 選択メソッドは <xref:System.Xml.XPath.XPathNodeIterator> を返します。  同じストアに対して、選択されているノード セットを表す複数の <xref:System.Xml.XPath.XPathNodeIterator> オブジェクトを作成できます。|  
+  
+## MSXML XSLT 拡張機能  
+ `msxsl:script` クラスがサポートしている Microsoft XML コア サービス \(MSXML\) XSLT 拡張機能は、`msxsl:node-set` 関数と <xref:System.Xml.Xsl.XslTransform> 関数のみです。  
+  
+## 例  
+ XSL スタイル シートを読み込み、mydata.xml というファイルを <xref:System.Xml.XPath.XPathDocument> に読み込み、myStyleSheet.xsl という架空のファイルに格納されているデータの変換を実行し、書式設定された出力をコンソールに送信するコード サンプルを次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.XPath  
+Imports System.Xml.Xsl  
+  
+Public Class Sample  
+    Private filename As [String] = "mydata.xml"  
+    Private stylesheet As [String] = "myStyleSheet.xsl"  
+  
+    Public Shared Sub Main()  
+        Dim xslt As New XslTransform()  
+        xslt.Load(stylesheet)  
+        Dim xpathdocument As New XPathDocument(filename)  
+        Dim writer As New XmlTextWriter(Console.Out)  
+        writer.Formatting = Formatting.Indented  
+  
+        xslt.Transform(xpathdocument, Nothing, writer, Nothing)  
+    End Sub 'Main  
+End Class 'Sample  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.XPath;  
+using System.Xml.Xsl;  
+  
+public class Sample   
+{  
+    private const String filename = "mydata.xml";  
+    private const String stylesheet = "myStyleSheet.xsl";  
+  
+    public static void Main()   
+    {  
+    XslTransform xslt = new XslTransform();  
+    xslt.Load(stylesheet);  
+    XPathDocument xpathdocument = new  
+    XPathDocument(filename);  
+    XmlTextWriter writer = new XmlTextWriter(Console.Out);  
+    writer.Formatting=Formatting.Indented;  
+  
+    xslt.Transform(xpathdocument, null, writer, null);      
+    }  
+}  
+```  
+  
+## 参照  
+ <xref:System.Xml.Xsl.XslTransform>   
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)   
+ [XslTransform クラスの随意動作の実装](../../../../docs/standard/data/xml/implementation-of-discretionary-behaviors-in-the-xsltransform-class.md)   
+ [変換における XPathNavigator](../../../../docs/standard/data/xml/xpathnavigator-in-transformations.md)   
+ [変換における XPathNodeIterator](../../../../docs/standard/data/xml/xpathnodeiterator-in-transformations.md)   
+ [XslTransform への XPathDocument の入力](../../../../docs/standard/data/xml/xpathdocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDataDocument の入力](../../../../docs/standard/data/xml/xmldatadocument-input-to-xsltransform.md)   
+ [XslTransform への XmlDocument の入力](../../../../docs/standard/data/xml/xmldocument-input-to-xsltransform.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xslt-transformations.md b/docs/standard/data/xml/xslt-transformations.md
new file mode 100644
index 00000000000..f35fd34fd50
--- /dev/null
+++ b/docs/standard/data/xml/xslt-transformations.md
@@ -0,0 +1,55 @@
+---
+title: "XSLT 変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 202f8820-224c-494f-b61e-cd127eac6e03
+caps.latest.revision: 4
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# XSLT 変換
+XSLT \(Extensible Stylesheet Language Transformation\) を使用すれば、ソース XML ドキュメントの内容を、形式や構造が異なる別のドキュメントに変換できます。  たとえば、XSLT を使用して、XML を Web サイトで使われる HTML に変換したり、アプリケーションが必要とするフィールドだけが含まれたドキュメントに変換したりできます。  この変換処理の仕様は、W3C 勧告『[XSL Transformations \(XSLT\) Version 1.0](http://go.microsoft.com/fwlink/?LinkID=49919)』で規定されています。  
+  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスは .NET Framework の XSLT プロセッサです。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスは、W3C 勧告『XSLT 1.0』をサポートしています。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では <xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスが XSLT エンジンの新しい実装です。  このクラスは、パフォーマンスが向上しており、新しいセキュリティ機能を備えています。  XSLT アプリケーションの作成には <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用することが推奨されています。  
+  
+## このセクションの内容  
+ [XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)  
+ <xref:System.Xml.Xsl.XslCompiledTransform> クラスの使用方法について説明します。  
+  
+ [XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)  
+ <xref:System.Xml.Xsl.XslTransform> クラスからコードを移行する方法について説明します。  
+  
+ [XSLT コンパイラ \(xsltc.exe\)](../../../../docs/standard/data/xml/xslt-compiler-xsltc-exe.md)  
+ XSLT コンパイラの使用方法について説明します。  
+  
+ [XslTransform クラスを使用した XSLT 変換](../../../../docs/standard/data/xml/xslt-transformations-with-the-xsltransform-class.md)  
+ <xref:System.Xml.Xsl.XslTransform> クラスの使用方法について説明します。  
+  
+ **メモ** .NET Framework 2.0 リリースでは <xref:System.Xml.Xsl.XslTransform> クラスが廃止されています。  
+  
+## 関連項目  
+ <xref:System.Xml.Xsl.XslCompiledTransform>  
+  
+ <xref:System.Xml.Xsl.XsltArgumentList>  
+  
+ <xref:System.Xml.Xsl.XsltSettings>  
+  
+## 関連項目  
+ [XML ドキュメントと XML データ](../../../../docs/standard/data/xml/index.md)
\ No newline at end of file
diff --git a/docs/standard/data/xml/xsltargumentlist-for-style-sheet-parameters-and-extension-objects.md b/docs/standard/data/xml/xsltargumentlist-for-style-sheet-parameters-and-extension-objects.md
new file mode 100644
index 00000000000..c70891f88e7
--- /dev/null
+++ b/docs/standard/data/xml/xsltargumentlist-for-style-sheet-parameters-and-extension-objects.md
@@ -0,0 +1,376 @@
+---
+title: "スタイル シート パラメーターと拡張オブジェクト用の XsltArgumentList | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: de2f0dce-6b98-4908-bba7-ed150cc50355
+caps.latest.revision: 3
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 3
+---
+# スタイル シート パラメーターと拡張オブジェクト用の XsltArgumentList
+<xref:System.Xml.Xsl.XsltArgumentList> クラスには、XSLT \(Extensible Stylesheet Language for Transformations\) パラメーターと XSLT 拡張オブジェクトが含まれています。  これらのパラメーターと拡張オブジェクトは、<xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡すことで、スタイル シートから呼び出せるようになります。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnext](../../../../includes/dnprdnext-md.md)] では、<xref:System.Xml.Xsl.XslTransform> クラスと <xref:System.Xml.Xsl.XsltArgumentList> クラスが廃止されています。  <xref:System.Xml.Xsl.XslCompiledTransform> クラスを使用して XSLT 変換を実行できます。  詳細については、「[XslCompiledTransform クラスの使用](../../../../docs/standard/data/xml/using-the-xslcompiledtransform-class.md)」および「[XslTransform クラスからの移行](../../../../docs/standard/data/xml/migrating-from-the-xsltransform-class.md)」を参照してください。  
+  
+ <xref:System.Xml.Xsl.XsltArgumentList> クラスには、XSLT パラメーターと XSLT 拡張オブジェクトが含まれています。  これらのパラメーターと拡張オブジェクトは、<xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡すことで、スタイル シートから呼び出せるようになります。  
+  
+ 埋め込みスクリプトを使用するのではなく、オブジェクトを渡す利点を次に示します。  
+  
+-   クラスをより効果的にカプセル化および再利用できます。  
+  
+-   スタイル シートを小さくすることができ、管理が簡単になります。  
+  
+-   サポートされている <xref:System> 名前空間のセット内で定義されているもの以外の名前空間に属しているクラスのメソッドを呼び出すことができます。  
+  
+-   <xref:System.Xml.XPath.XPathNodeIterator> を使用して結果ツリー フラグメントをスタイル シートに渡す操作がサポートされます。  
+  
+## XSLT スタイル シートのパラメーター  
+ XSLT パラメーターを <xref:System.Xml.Xsl.XsltArgumentList> に追加するには、<xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> メソッドを使用します。  パラメーターが追加された時点で、修飾名と名前空間 URI \(Uniform Resource Identifier\) がそのパラメーター オブジェクトに関連付けられます。  
+  
+ パラメーター オブジェクトは、W3C \(World Wide Web Consortium\) 型に対応している必要があります。  対応する W3C 型、それと同等の [!INCLUDE[dnprdnshort](../../../../includes/dnprdnshort-md.md)] のクラス \(型\)、および W3C 型が XPath \(XML Path Language\) 型または XSLT 型のどちらかを次の表に示します。  
+  
+|W3C 型|対応する .NET Framework クラス \(型\)|XPath 型または XSLT 型|  
+|-----------|-----------------------------------|-----------------------|  
+|String|System.String|XPath|  
+|Boolean|System.Boolean|XPath|  
+|Number|System.Double|XPath|  
+|Result Tree Fragment|System.Xml.XPath.XPathNavigator|XSLT|  
+|Node Set|System.Xml.XPath.XPathNodeIterator|XPath|  
+  
+ パラメーター オブジェクトが上に示したクラスでない場合は、クラスの種類に応じて、Double または String に強制的に変換されます。  Int16、UInt16、Int32、UInt32、Int64、UInt64、Single、Decimal の各型は、強制的に Double に変換されます。  その他すべての型は、`ToString` メソッドを使用して強制的に文字列に変換されます。  
+  
+#### XSLT パラメーターを使用するために必要な処理  
+  
+1.  <xref:System.Xml.Xsl.XsltArgumentList> を作成し、<xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> を使用してオブジェクトを追加します。  
+  
+2.  スタイル シートからパラメーターを呼び出します。  
+  
+3.  <xref:System.Xml.Xsl.XsltArgumentList> を <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡します。  
+  
+### 例  
+ 算出された割引日を保持するパラメーターを <xref:System.Xml.Xsl.XsltArgumentList.AddParam%2A> メソッドを使用して作成する例を次に示します。  割引日は、発注日から 20 日後として算出されます。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.XPath  
+Imports System.Xml.Xsl  
+  
+Public class Sample  
+  
+   Private Const filename As String = "order.xml"  
+   Private Const stylesheet As String = "discount.xsl"  
+  
+   Public Shared Sub Main()  
+  
+    'Create the XslTransform and load the style sheet.  
+    Dim xslt As XslTransform = New XslTransform  
+    xslt.Load(stylesheet)  
+  
+    'Load the XML data file.  
+    Dim doc As XPathDocument = New XPathDocument(filename)  
+  
+    'Create an XsltArgumentList.  
+    Dim xslArg As XsltArgumentList = New XsltArgumentList  
+  
+    'Calculate the discount date.  
+    Dim today As DateTime = DateTime.Now  
+    Dim d As DateTime = today.AddDays(20)  
+    xslArg.AddParam("discount", "", d.ToString())  
+  
+    'Create an XmlTextWriter to handle the output.  
+    Dim writer As XmlTextWriter = New XmlTextWriter("orderout.xml", Nothing)  
+  
+    'Transform the file.  
+    xslt.Transform(doc, xslArg, writer, Nothing)  
+  
+    writer.Close()  
+  
+  End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.XPath;  
+using System.Xml.Xsl;  
+  
+public class Sample  
+{  
+   private const String filename = "order.xml";  
+   private const String stylesheet = "discount.xsl";  
+  
+   public static void Main() {  
+  
+    //Create the XslTransform and load the style sheet.  
+    XslTransform xslt = new XslTransform();  
+    xslt.Load(stylesheet);  
+  
+    //Load the XML data file.  
+    XPathDocument doc = new XPathDocument(filename);  
+  
+    //Create an XsltArgumentList.  
+    XsltArgumentList xslArg = new XsltArgumentList();  
+  
+    //Calculate the discount date.  
+    DateTime today = DateTime.Now;  
+    DateTime d = today.AddDays(20);  
+    xslArg.AddParam("discount", "", d.ToString());  
+  
+    //Create an XmlTextWriter to handle the output.  
+    XmlTextWriter writer = new XmlTextWriter("orderout.xml", null);  
+  
+    //Transform the file.  
+    xslt.Transform(doc, xslArg, writer, null);  
+    writer.Close();  
+  }  
+}  
+```  
+  
+### 入力  
+ order.xml  
+  
+```  
+<!--Represents a customer order-->  
+<order>  
+  <book ISBN='10-861003-324'>  
+    <title>The Handmaid's Tale</title>  
+    <price>19.95</price>  
+  </book>  
+  <cd ISBN='2-3631-4'>  
+    <title>Americana</title>  
+    <price>16.95</price>  
+  </cd>  
+</order>  
+```  
+  
+ discount.xsl  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">  
+  <xsl:param name="discount"/>  
+  <xsl:template match="/">  
+    <order>  
+      <xsl:variable name="sub-total" select="sum(//price)"/>  
+      <total><xsl:value-of select="$sub-total"/></total>  
+      15% discount if paid by: <xsl:value-of select="$discount"/>  
+    </order>  
+  </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+### 出力  
+  
+```  
+<order>  
+   <total>36.9</total>   
+   15% discount if paid by: 5/6/2001 5:01:15 PM   
+</order>  
+```  
+  
+## XSLT 拡張オブジェクト  
+ XSLT 拡張オブジェクトを <xref:System.Xml.Xsl.XsltArgumentList> に追加するには、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> メソッドを使用します。  その時点で、修飾名と名前空間 URI がその拡張オブジェクトに関連付けられます。  
+  
+ オブジェクトを追加する場合、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> の呼び出し元は、セキュリティ ポリシーで完全に信頼されている必要があります。  呼び出し元の信頼性が低いと、処理は失敗します。  
+  
+ オブジェクトは正常に追加されますが、正常に実行されるかどうかは保証されません。  <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドを呼び出すと、<xref:System.Xml.Xsl.XslTransform.Load%2A> の実行時に指定された証拠に基づいてアクセス許可が計算され、そのアクセス許可セットが変換処理全体に割り当てられます。  拡張オブジェクトが、アクセス許可セットにないアクセス許可を必要とする処理を実行しようとすると、例外がスローされます。  
+  
+ 拡張オブジェクトが返すデータ型は、4 つの基本 XPath 型である数値、文字列、ブール、ノード セットのうちのいずれかになります。  
+  
+#### XSLT 拡張オブジェクトを使用するために必要な処理  
+  
+1.  <xref:System.Xml.Xsl.XsltArgumentList> を作成し、<xref:System.Xml.Xsl.XsltArgumentList.AddExtensionObject%2A> を使用して拡張オブジェクトを追加します。  
+  
+2.  スタイル シートから拡張オブジェクトを呼び出します。  
+  
+3.  <xref:System.Xml.Xsl.XsltArgumentList> を <xref:System.Xml.Xsl.XslTransform.Transform%2A> メソッドに渡します。  
+  
+### 例  
+ 半径が指定された円の円周を算出する例を次に示します。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Xml  
+Imports System.Xml.XPath  
+Imports System.Xml.Xsl  
+  
+Public Class Sample  
+   Private Const filename As String = "number.xml"  
+   Private Const stylesheet As String = "circle.xsl"  
+  
+   Public Shared Sub Main()  
+        Dim test As Sample = New Sample  
+   End Sub  
+  
+  Public Sub New()  
+    'Create the XslTransform and load the style sheet.  
+    Dim xslt As XslTransform = New XslTransform  
+    xslt.Load(stylesheet)  
+  
+    'Load the XML data file.  
+    Dim doc As XPathDocument = New XPathDocument(filename)  
+  
+    'Create an XsltArgumentList.  
+    Dim xslArg As XsltArgumentList = New XsltArgumentList  
+  
+    'Add an object to calculate the circumference of the circle.  
+    Dim obj As Calculate = New Calculate  
+    xslArg.AddExtensionObject("urn:myObj", obj)  
+  
+    'Create an XmlTextWriter to output to the console.  
+    Dim writer As XmlTextWriter = New XmlTextWriter(Console.Out)  
+  
+    'Transform the file.  
+    xslt.Transform(doc, xslArg, writer, Nothing)  
+    writer.Close()  
+  
+  End Sub  
+  
+  'Calculates the circumference of a circle given the radius.  
+  Public Class Calculate  
+  
+    Private circ As double = 0  
+  
+    Public Function Circumference(radius As Double) As Double  
+       circ = Math.PI*2*radius  
+       Return circ  
+    End Function  
+  End Class  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Xml;  
+using System.Xml.XPath;  
+using System.Xml.Xsl;  
+  
+public class Sample  
+{  
+   private const String filename = "number.xml";  
+   private const String stylesheet = "circle.xsl";  
+  
+   public static void Main() {  
+  
+        Sample test = new Sample();  
+    }  
+  
+  public Sample() {  
+  
+    //Create the XslTransform and load the style sheet.  
+    XslTransform xslt = new XslTransform();  
+    xslt.Load(stylesheet);  
+  
+    //Load the XML data file.  
+    XPathDocument doc = new XPathDocument(filename);  
+  
+    //Create an XsltArgumentList.  
+    XsltArgumentList xslArg = new XsltArgumentList();  
+  
+    //Add an object to calculate the circumference of the circle.  
+    Calculate obj = new Calculate();  
+    xslArg.AddExtensionObject("urn:myObj", obj);  
+  
+    //Create an XmlTextWriter to output to the console.  
+    XmlTextWriter writer = new XmlTextWriter(Console.Out);  
+  
+    //Transform the file.  
+    xslt.Transform(doc, xslArg, writer, null);  
+    writer.Close();  
+  
+  }  
+  
+  //Calculates the circumference of a circle given the radius.  
+  public class Calculate{  
+  
+    private double circ = 0;  
+  
+    public double Circumference(double radius){  
+       circ = Math.PI*2*radius;  
+       return circ;  
+    }  
+  }  
+}  
+```  
+  
+### 入力  
+ number.xml  
+  
+```  
+<?xml version='1.0'?>  
+<data>  
+  <circle>  
+    <radius>12</radius>  
+  </circle>  
+  <circle>  
+    <radius>37.5</radius>  
+  </circle>  
+</data>    
+```  
+  
+ circle.xsl  
+  
+```  
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"  
+    xmlns:myObj="urn:myObj">  
+  
+  <xsl:template match="data">  
+  <circles>  
+  <xsl:for-each select="circle">  
+    <circle>  
+    <xsl:copy-of select="node()"/>  
+       <circumference>  
+          <xsl:value-of select="myObj:Circumference(radius)"/>          
+       </circumference>  
+    </circle>  
+  </xsl:for-each>  
+  </circles>  
+  </xsl:template>  
+</xsl:stylesheet>  
+```  
+  
+### 出力  
+ `<circles xmlns:myObj="urn:myObj">`  
+  
+ `<circle>`  
+  
+ `<radius>12</radius>`  
+  
+ `<circumference>75.398223686155</circumference>`  
+  
+ `</circle>`  
+  
+ `<circle>`  
+  
+ `<radius>37.5</radius>`  
+  
+ `<circumference>235.61944901923448</circumference>`  
+  
+ `</circle>`  
+  
+ `</circles>`  
+  
+## 参照  
+ [XslTransform クラスによる XSLT プロセッサの実装](../../../../docs/standard/data/xml/xsltransform-class-implements-the-xslt-processor.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/TOC.md b/docs/standard/datetime/TOC.md
new file mode 100644
index 00000000000..b9d8ad1d751
--- /dev/null
+++ b/docs/standard/datetime/TOC.md
@@ -0,0 +1,20 @@
+# [方法 : 調整規則のあるタイム ゾーンを作成する](create-time-zones-with-adjustment-rules.md)
+# [タイム ゾーンの概要](time-zone-overview.md)
+# [方法 : ユーザーがあいまいな時刻を解決できるようにする](let-users-resolve-ambiguous-times.md)
+# [方法 : コンピューター上に存在するタイム ゾーンを列挙する](enumerate-time-zones.md)
+# [DateTime と DateTimeOffset 間の変換](converting-between-datetime-and-offset.md)
+# [方法 : 調整規則のないタイム ゾーンを作成する](create-time-zones-without-adjustment-rules.md)
+# [タイム ゾーン間での時刻の変換](converting-between-time-zones.md)
+# [DateTimeOffset オブジェクトのインスタンス化](instantiating-a-datetimeoffset-object.md)
+# [方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](access-utc-and-local.md)
+# [方法 : TimeZoneInfo オブジェクトをインスタンス化する](instantiate-time-zone-info.md)
+# [日付と時刻を使用した算術演算の実行](performing-arithmetic-operations.md)
+# [方法 : 日付と時刻の演算でタイム ゾーンを使用する](use-time-zones-in-arithmetic.md)
+# [方法 : 埋め込みリソースからタイム ゾーンを復元する](restore-time-zones-from-an-embedded-resource.md)
+# [タイム ゾーンの保存と復元](saving-and-restoring-time-zones.md)
+# [ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)
+# [方法 : 埋め込みリソースにタイム ゾーンを保存する](save-time-zones-to-an-embedded-resource.md)
+# [方法 : あいまいな時刻を解決する](resolve-ambiguous-times.md)
+# [日付、時刻、およびタイム ゾーン](index.md)
+# [カレンダーの使用](working-with-calendars.md)
+# [DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](choosing-between-datetime.md)
diff --git a/docs/standard/datetime/access-utc-and-local.md b/docs/standard/datetime/access-utc-and-local.md
index 91b28e48306..5be2c864395 100644
--- a/docs/standard/datetime/access-utc-and-local.md
+++ b/docs/standard/datetime/access-utc-and-local.md
@@ -1,120 +1,59 @@
 ---
-title: "方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする"
-description: "方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/11/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 13454d47-d957-421b-9ecd-940058b8835e
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: fcc48e40cdad25c6142dbc3a86513b816378fa4b
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-access-the-predefined-utc-and-local-time-zone-objects"></a>方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスに用意されている&2; つのプロパティ、`Utc` および `Local` を使用すると、コードから定義済みのタイム ゾーン オブジェクトにアクセスできます。 このトピックでは、これらのプロパティから返される `TimeZoneInfo` オブジェクトにアクセスする方法について説明します。
-
-## <a name="to-access-the-coordinated-universal-time-utc-timezoneinfo-object"></a>世界協定時刻 (UTC) の TimeZoneInfo オブジェクトにアクセスするには
-
-1. **static** (Visual Basic では **Shared**) [TimeZoneInfo.Utc](xref:System.TimeZoneInfo.Utc) プロパティを使用して、世界協定時刻にアクセスします。
-
-2. プロパティから返された [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをオブジェクト変数に割り当てるのではなく、そのまま [TimeZoneInfo.Utc](xref:System.TimeZoneInfo.Utc) プロパティを使用して世界協定時刻にアクセスします。
-
-
-## <a name="to-access-the-local-time-zone"></a>ローカル タイム ゾーンにアクセスするには
-
-1. **static** (Visual Basic では **Shared**) [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティを使用して、ローカル タイム ゾーンにアクセスします。
-
-2. プロパティから返された [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをオブジェクト変数に割り当てるのではなく、そのまま [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティを使用してローカル タイム ゾーンにアクセスします。
-
-## <a name="example"></a>例
-
-次のコードでは、[TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティと [TimeZoneInfo.Utc](xref:System.TimeZoneInfo.Utc) プロパティを使用して、米国およびカナダ東部標準時タイム ゾーンの時刻を変換し、コンソールにタイム ゾーンの名前を表示します。
-
-```csharp
-// Create Eastern Standard Time value and TimeZoneInfo object      
-DateTime estTime = new DateTime(2007, 1, 1, 00, 00, 00);
-string timeZoneName = "Eastern Standard Time";
-try
-{
-   TimeZoneInfo est = TimeZoneInfo.FindSystemTimeZoneById(timeZoneName);
-
-   // Convert EST to local time
-   DateTime localTime = TimeZoneInfo.ConvertTime(estTime, est, TimeZoneInfo.Local);
-   Console.WriteLine("At {0} {1}, the local time is {2} {3}.", 
-           estTime, 
-           est, 
-           localTime, 
-           TimeZoneInfo.Local.IsDaylightSavingTime(localTime) ?
-                     TimeZoneInfo.Local.DaylightName : 
-                     TimeZoneInfo.Local.StandardName);
-
-   // Convert EST to UTC
-   DateTime utcTime = TimeZoneInfo.ConvertTime(estTime, est, TimeZoneInfo.Utc);
-   Console.WriteLine("At {0} {1}, the time is {2} {3}.", 
-           estTime, 
-           est, 
-           utcTime, 
-           TimeZoneInfo.Utc.StandardName);
-}
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("The {0} zone cannot be found in the registry.", 
-                     timeZoneName);
-}
-catch (InvalidTimeZoneException)
-{
-   Console.WriteLine("The registry contains invalid data for the {0} zone.", 
-                     timeZoneName);
-}
-```
-
-```vb
-' Create Eastern Standard Time value and TimeZoneInfo object      
-Dim estTime As Date = #01/01/2007 00:00:00#
-Dim timeZoneName As String = "Eastern Standard Time"
-Try
-   Dim est As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(timeZoneName)
-
-   ' Convert EST to local time
-   Dim localTime As Date = TimeZoneInfo.ConvertTime(estTime, est, TimeZoneInfo.Local)
-   Console.WriteLine("At {0} {1}, the local time is {2} {3}.", _
-           estTime, _
-           est, _
-           localTime, _
-           IIf(TimeZoneInfo.Local.IsDaylightSavingTime(localTime), _
-               TimeZoneInfo.Local.DaylightName, _
-               TimeZoneInfo.Local.StandardName))
-
-   ' Convert EST to UTC
-   Dim utcTime As Date = TimeZoneInfo.ConvertTime(estTime, est, TimeZoneInfo.Utc)
-   Console.WriteLine("At {0} {1}, the time is {2} {3}.", _
-           estTime, _
-           est, _
-           utcTime, _
-           TimeZoneInfo.Utc.StandardName)
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("The {0} zone cannot be found in the registry.", _
-                     timeZoneName)
-Catch e As InvalidTimeZoneException
-   Console.WriteLine("The registry contains invalid data for the {0} zone.", _
-                     timeZoneName)
-End Try
-```
-
-ローカル タイム ゾーンにアクセスする場合は、ローカル タイム ゾーンを [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクト変数に割り当てることはせず、常に [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティを使用してください。 同様に、世界協定時刻にアクセスする場合は、UTC ゾーンを [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクト変数に割り当てることはせず、常に [TimeZoneInfo.Utc](xref:System.TimeZoneInfo.Utc) プロパティを使用してください。 これにより、[TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクト変数が外部メソッドによって無効になるのを防ぐことができます。
-
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)
-
+title: "方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ローカル タイム ゾーンへのアクセス"
+  - "定義済みのタイム ゾーン"
+  - "タイム ゾーン [.NET Framework], local"
+  - "タイム ゾーン [.NET Framework], 取得"
+  - "タイム ゾーン [.NET Framework], UTC"
+  - "UTC 時刻, 定義済み"
+ms.assetid: 961fb70b-83f0-4dab-a042-cb5fcd817cf5
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする
+<xref:System.TimeZoneInfo> クラスに用意されている 2 つのプロパティ、<xref:System.TimeZoneInfo.Utc%2A> および <xref:System.TimeZoneInfo.Local%2A> を使用すると、コードから定義済みのタイム ゾーン オブジェクトにアクセスできます。  このトピックでは、これらのプロパティから返される <xref:System.TimeZoneInfo> オブジェクトにアクセスする方法について説明します。  
+  
+### 世界協定時刻 \(UTC: Coordinated Universal Time\) の TimeZoneInfo オブジェクトにアクセスするには  
+  
+1.  `static` \(Visual Basic では `Shared`\) <xref:System.TimeZoneInfo.Utc%2A?displayProperty=fullName> プロパティを使用して、世界協定時刻にアクセスします。  
+  
+2.  プロパティから返された <xref:System.TimeZoneInfo> オブジェクトをオブジェクト変数に割り当てることはせず、そのまま <xref:System.TimeZoneInfo.Utc%2A?displayProperty=fullName> プロパティを使用して世界協定時刻にアクセスします。  
+  
+### ローカル タイム ゾーンにアクセスするには  
+  
+1.  `static` \(Visual Basic では `Shared`\) <xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> プロパティを使用して、ローカル システム タイム ゾーンにアクセスします。  
+  
+2.  プロパティから返された <xref:System.TimeZoneInfo> オブジェクトをオブジェクト変数に割り当てることはせず、そのまま <xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> プロパティを使用してローカル タイム ゾーンにアクセスします。  
+  
+## 使用例  
+ 次のコードは、米国およびカナダ東部標準時タイム ゾーンの時刻に変換し、コンソールにタイム ゾーンの名前を表示するために <xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> と <xref:System.TimeZoneInfo.Utc%2A?displayProperty=fullName> のプロパティを使用します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#13](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#13)]
+ [!code-vb[System.TimeZone2.Concepts#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#13)]  
+  
+ ローカル タイム ゾーンにアクセスする場合は、<xref:System.TimeZoneInfo> オブジェクト変数にローカル タイム ゾーンを割り当てることはせず、必ず <xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> プロパティを使用してください。  同様に、世界協定時刻にアクセスする場合は、UTC ゾーンを <xref:System.TimeZoneInfo> オブジェクト変数に割り当てることはせず、必ず <xref:System.TimeZoneInfo.Utc%2A?displayProperty=fullName> プロパティを使用してください。これにより、<xref:System.TimeZoneInfo> オブジェクト変数が <xref:System.TimeZoneInfo.ClearCachedData%2A?displayProperty=fullName> メソッド呼び出しによって無効になるのを防ぐことができます。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   <xref:System> 名前空間を `using` ステートメントでインポートする \(C\# のコードで必要\)。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md)   
+ [方法 : TimeZoneInfo オブジェクトをインスタンス化する](../../../docs/standard/datetime/instantiate-time-zone-info.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/choosing-between-datetime.md b/docs/standard/datetime/choosing-between-datetime.md
index 862e8bc607f..f6370a7a8ac 100644
--- a/docs/standard/datetime/choosing-between-datetime.md
+++ b/docs/standard/datetime/choosing-between-datetime.md
@@ -1,357 +1,120 @@
 ---
-title: "DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け"
-description: "DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/11/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 2dd84ee8-9f0f-4054-9537-155857a460cd
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: aeb1928be32584ee4b6acf7c9a4f4330daedc590
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="choosing-between-datetime-datetimeoffset-timespan-and-timezoneinfo"></a>DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け
-
-日時情報を使用する .NET アプリケーションは非常に多様であり、その情報をさまざまな方法で使用できます。 より一般的な日時情報の用途には、次の&1; つ以上が含まれます。
-
-* 日付のみを反映する (時刻情報は重要ではない)。
-
-* 時刻のみを反映する (日付情報は重要ではない)。
-
-* 特定の時刻と場所に関連付けられていない抽象日時を反映する (たとえば、国際的チェーンのほとんどのストアは週中の午前 9:00 にオープンする)。
-
-* .NET アプリケーションの外部ソースから日時情報を取得する (通常、日時情報は単純なデータ型に格納される)。
-
-* 単一の時点を一意かつ明確に識別する。 ホスト システムでのみ日付と時刻を明確にする必要があるアプリケーションもあれば、システム全体で明確にする必要があるアプリケーションもあります (つまり、1 つのシステムでシリアル化される日付は有意に逆シリアル化し、世界中のどの場所においても別のシステムで使用できます)。 
-
-* 関連する複数の時刻を保持する (要求元の現地時刻やサーバーの Web 要求受信時刻など)。
-
-* 日付と時刻の演算を実行する (これにより、おそらく単一時点が一意かつ明確に識別される)。 
-
-.NET には、[System.DateTime](xref:System.DateTime)、[System.DateTimeOffset](xref:System.DateTimeOffset)、[System.TimeSpan](xref:System.TimeSpan)、[System.TimeZoneInfo](xref:System.TimeZoneInfo) の各型が含まれます。このすべては、日付と時刻を使用するアプリケーションを構築するために使用できます。 
-
+title: "DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "DateTimeOffset 構造体"
+  - "TimeZoneInfo クラス"
+  - "タイム ゾーン [.NET Framework]、一般的な使用方法"
+  - "日付と時刻のクラス [.NET Framework]"
+  - "タイム ゾーン [.NET Framework]、型のオプション"
+  - "DateTime 構造体"
+ms.assetid: 07f17aad-3571-4014-9ef3-b695a86f3800
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け
+日時情報を使用する [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションは非常に多様であり、その情報をさまざまな方法で使用できます。 より一般的な日時情報の用途には、次の 1 つ以上が含まれます。  
+  
+-   日付のみを反映する \(時刻情報は重要ではない\)。  
+  
+-   時刻のみを反映する \(日付情報は重要ではない\)。  
+  
+-   特定の時刻と場所に関連付けられていない抽象日時を反映する \(たとえば、国際的チェーンのほとんどのストアは週中の午前 9:00 にオープンする\)。  
+  
+-   [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の外部ソースから日時情報を取得する \(通常、日時情報は単純なデータ型に格納される\)。  
+  
+-   単一の時点を一意かつ明確に識別する。 ホスト システムでのみ日付と時刻を明確にする必要があるアプリケーションもあれば、システム全体で明確にする必要があるアプリケーションもあります \(つまり、1 つのシステムでシリアル化される日付は有意に逆シリアル化し、世界中のどの場所においても別のシステムで使用できます\)。  
+  
+-   関連する複数の時刻を保持する \(要求元の現地時刻やサーバーの Web 要求受信時刻など\)。  
+  
+-   日付と時刻の演算を実行する \(これにより、おそらく単一時点が一意かつ明確に識別される\)。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、<xref:System.DateTime>、<xref:System.DateTimeOffset>、<xref:System.TimeSpan>、<xref:System.TimeZoneInfo> の各型が含まれます。このすべては、日付と時刻を使用するアプリケーションを構築するために使用できます。  
+  
 > [!NOTE]
-> このトピックでは古い `TimeZone` 型については説明されません。その機能は、[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスにほぼ完全に組み込まれているからです。 開発者は可能な限り、`TimeZone` クラスの代わりに [System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスを使用する必要があります。
-
-
-## <a name="the-datetime-structure"></a>DateTime 構造体
-
-[System.DateTime](xref:System.DateTime) 値は、特定の日付と時刻を定義します。 これには日付と時刻が属するタイム ゾーンに関する限られた情報を提供する [Kind](xref:System.DateTime.Kind) プロパティが含まれています。 [Kind](xref:System.DateTime.Kind) プロパティによって返される [DateTimeKind](xref:System.DateTimeKind) 値は、[DateTime](xref:System.DateTime) 値が現地時刻 ([DateTimeKind.Local](xref:System.DateTimeKind.Local))、世界協定時刻 (UTC) ([DateTimeKind.Utc](xref:System.DateTimeKind.Utc))、指定されていない時刻 ([DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified)) のうちのどれを表すかを示します。
-
-[DateTime](xref:System.DateTime) 構造体は、次の操作を実行するアプリケーションに適しています。 
-
-* 日付のみを使用するアプリケーション。
-
-* 時刻のみを使用するアプリケーション。
-
-* 抽象日時を使用するアプリケーション。
-
-* タイム ゾーン情報がない日時を使用するアプリケーション。 
-
-* UTC 日時のみを使用するアプリケーション。 
-
-* SQL データベースなど、.NET Framework の外部ソースから日時情報を取得します。 通常、これらのソースは、[DateTime](xref:System.DateTime) 構造体と互換性のある単純な形式で日時情報を格納します。
-
-* 日付と時刻の演算を実行しますが、これは一般的な結果に関するものです。 たとえば、6 カ月を特定の日付と時刻に加算する加算演算では、多くの場合、結果を夏時間に合わせて調整するかどうかは重要ではありません。
-
-特定の [DateTime](xref:System.DateTime) 値が UTC を表さない場合、通常、その日付と時刻の値は、あいまいであるか、その移植性に限定されます。 たとえば、[DateTime](xref:System.DateTime) 値が現地時刻を表す場合、そのローカル タイム ゾーン内で移植することができます (つまり、同じタイム ゾーンにある別のシステムで値が逆シリアル化されると、その値は明確に単一時点を識別します)。 ローカル タイム ゾーン外では、その [DateTime](xref:System.DateTime) 値は複数の意味を持つ場合があります。 値の [Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) の場合、移植性は低くなります。同じタイム ゾーン内であいまいになり、最初にシリアル化したのと同じシステムにおいてさえもあいまいになる可能性があります。 [DateTime](xref:System.DateTime) 値が UTC を表す場合のみ、値が使用されるシステムまたはタイム ゾーンに関係なく、その値は明確に単一時点を識別します。
-
+>  このトピックには 4 番目の型の <xref:System.TimeZone> については説明されません。その機能は、<xref:System.TimeZoneInfo> クラスに完全に組み込まれているからです。 開発者は可能な限り、<xref:System.TimeZone> クラスの代わりに <xref:System.TimeZoneInfo> クラスを使用する必要があります。  
+  
+## DateTime 構造体  
+ <xref:System.DateTime> 値は、特定の日付と時刻を定義します。[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のバージョン 2.0 以降、これには日付と時刻が属するタイム ゾーンに関する限られた情報を提供する <xref:System.DateTime.Kind%2A> プロパティが含まれています。<xref:System.DateTime.Kind%2A> プロパティによって返される <xref:System.DateTimeKind> 値は、<xref:System.DateTime> 値が現地時刻 \(<xref:System.DateTimeKind?displayProperty=fullName>\)、世界協定時刻 \(UTC\) \(<xref:System.DateTimeKind?displayProperty=fullName>\)、指定されていない時刻 \(<xref:System.DateTimeKind?displayProperty=fullName>\) のうちのどれを表すかを示します。  
+  
+ <xref:System.DateTime> 構造体は、次の操作を実行するアプリケーションに適しています。  
+  
+-   日付のみを使用するアプリケーション。  
+  
+-   時刻のみを使用するアプリケーション。  
+  
+-   抽象日時を使用するアプリケーション。  
+  
+-   タイム ゾーン情報がない日時を使用するアプリケーション。  
+  
+-   UTC 日時のみを使用するアプリケーション。  
+  
+-   SQL データベースなど、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の外部ソースから日時情報を取得します。 通常、これらのソースは、<xref:System.DateTime> 構造体と互換性のある単純な形式で日時情報を格納します。  
+  
+-   日付と時刻の演算を実行しますが、これは一般的な結果に関するものです。 たとえば、6 カ月を特定の日付と時刻に加算する加算演算では、多くの場合、結果を夏時間に合わせて調整するかどうかは重要ではありません。  
+  
+ 特定の <xref:System.DateTime> 値が UTC を表さない場合、通常、その日付と時刻の値は、あいまいであるか、その移植性に限定されます。 たとえば、<xref:System.DateTime> 値が現地時刻を表す場合、そのローカル タイム ゾーン内で移植することができます \(つまり、同じタイム ゾーンにある別のシステムで値が逆シリアル化されると、その値は明確に単一時点を識別します\)。 ローカル タイム ゾーン外では、その <xref:System.DateTime> 値は複数の意味を持つ場合があります。 値の <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> の場合、移植性は低くなります。同じタイム ゾーン内であいまいになり、最初にシリアル化したのと同じシステムにおいてさえもあいまいになる可能性があります。<xref:System.DateTime> 値が UTC を表す場合のみ、値が使用されるシステムまたはタイム ゾーンに関係なく、その値は明確に単一時点を識別します。  
+  
 > [!IMPORTANT]
-> [DateTime](xref:System.DateTime) データを保存または共有する際、UTC を使用する必要があり、[DateTime](xref:System.DateTime) 値の [Kind](xref:System.DateTime.Kind) プロパティを [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) に設定する必要があります。
-
-## <a name="the-datetimeoffset-structure"></a>DateTimeOffset 構造体
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 構造体は、日付と時刻の値、およびその値と UTC との差異を示すオフセットを表します。 そのため、値は常に明確に単一時点を識別します。 
-
-[DateTimeOffset](xref:System.DateTimeOffset) 型には、[DateTime](xref:System.DateTime) 型のすべての機能に加え、タイム ゾーンの処理機能が含まれます。 そのため、次の操作を実行するアプリケーションに適しています。 
-
-* 単一の時点を一意かつ明確に識別する。 [DateTimeOffset](xref:System.DateTimeOffset) 型を使用して、「現在」の意味を明確に定義し、トランザクションの時刻を記録し、システム イベントまたはアプリケーション イベントの時刻を記録し、ファイル作成時刻とファイル変更時刻を記録することができます。 
-
-* 一般的な日付と時刻の演算を実行する。
-
-* その時刻が&2; つの別々の値または構造体の&2; つのメンバーである場合、関連する複数の時刻を保持する。
-
+>  <xref:System.DateTime> データを保存または共有する際、UTC を使用する必要があり、<xref:System.DateTime> 値の <xref:System.DateTime.Kind%2A> プロパティを <xref:System.DateTimeKind?displayProperty=fullName> に設定する必要があります。  
+  
+## DateTimeOffset 構造体  
+ <xref:System.DateTimeOffset> 構造体は、日付と時刻の値、およびその値と UTC との差異を示すオフセットを表します。 そのため、値は常に明確に単一時点を識別します。  
+  
+ <xref:System.DateTimeOffset> 型には、<xref:System.DateTime> 型のすべての機能に加え、タイム ゾーンの処理機能が含まれます。 そのため、次の操作を実行するアプリケーションに適しています。  
+  
+-   単一の時点を一意かつ明確に識別する。<xref:System.DateTimeOffset> 型を使用して、「現在」の意味を明確に定義し、トランザクションの時刻を記録し、システム イベントまたはアプリケーション イベントの時刻を記録し、ファイル作成時刻とファイル変更時刻を記録することができます。  
+  
+-   一般的な日付と時刻の演算を実行する。  
+  
+-   その時刻が 2 つの別々の値または構造体の 2 つのメンバーである場合、関連する複数の時刻を保持する。  
+  
 > [!NOTE]
-> [DateTimeOffset](xref:System.DateTimeOffset) 値のこの用途は、[DateTime](xref:System.DateTime) 値の用途と比べてはるかに一般的です。 その結果、[DateTimeOffset](xref:System.DateTimeOffset) はアプリケーション開発の既定の日付時刻型と見なされます。
-
-[DateTimeOffset](xref:System.DateTimeOffset) 値は特定のタイム ゾーンと関連付けられていませんが、さまざまなタイム ゾーンから派生することができます。 これを説明するために、いくつかの [DateTimeOffset](xref:System.DateTimeOffset) 値 (ローカルの太平洋標準時を含む) が属することができるタイム ゾーンの一覧を次の例に示します。
-
-```csharp
-using System;
-using System.Collections.ObjectModel;
-
-public class TimeOffsets
-{
-   public static void Main()
-   {
-      DateTime thisDate = new DateTime(2007, 3, 10, 0, 0, 0);
-      DateTime dstDate = new DateTime(2007, 6, 10, 0, 0, 0);
-      DateTimeOffset thisTime;
-
-      thisTime = new DateTimeOffset(dstDate, new TimeSpan(-7, 0, 0));
-      ShowPossibleTimeZones(thisTime);
-
-      thisTime = new DateTimeOffset(thisDate, new TimeSpan(-6, 0, 0));  
-      ShowPossibleTimeZones(thisTime);
-
-      thisTime = new DateTimeOffset(thisDate, new TimeSpan(+1, 0, 0));
-      ShowPossibleTimeZones(thisTime);
-   }
-
-   private static void ShowPossibleTimeZones(DateTimeOffset offsetTime)
-   {
-      TimeSpan offset = offsetTime.Offset;
-      ReadOnlyCollection<TimeZoneInfo> timeZones;
-
-      Console.WriteLine("{0} could belong to the following time zones:", 
-                        offsetTime.ToString());
-      // Get all time zones defined on local system
-      timeZones = TimeZoneInfo.GetSystemTimeZones();     
-      // Iterate time zones 
-      foreach (TimeZoneInfo timeZone in timeZones)
-      {
-         // Compare offset with offset for that date in that time zone
-         if (timeZone.GetUtcOffset(offsetTime.DateTime).Equals(offset))
-            Console.WriteLine("   {0}", timeZone.DisplayName);
-      }
-      Console.WriteLine();
-   } 
-}
-// This example displays the following output to the console:
-//       6/10/2007 12:00:00 AM -07:00 could belong to the following time zones:
-//          (GMT-07:00) Arizona
-//          (GMT-08:00) Pacific Time (US & Canada)
-//          (GMT-08:00) Tijuana, Baja California
-//       
-//       3/10/2007 12:00:00 AM -06:00 could belong to the following time zones:
-//          (GMT-06:00) Central America
-//          (GMT-06:00) Central Time (US & Canada)
-//          (GMT-06:00) Guadalajara, Mexico City, Monterrey - New
-//          (GMT-06:00) Guadalajara, Mexico City, Monterrey - Old
-//          (GMT-06:00) Saskatchewan
-//       
-//       3/10/2007 12:00:00 AM +01:00 could belong to the following time zones:
-//          (GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna
-//          (GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague
-//          (GMT+01:00) Brussels, Copenhagen, Madrid, Paris
-//          (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb
-//          (GMT+01:00) West Central Africa
-```
-
-```vb
-Imports System.Collections.ObjectModel
-
-Module TimeOffsets
-   Public Sub Main()
-      Dim thisTime As DateTimeOffset 
-
-      thisTime = New DateTimeOffset(#06/10/2007#, New TimeSpan(-7, 0, 0))
-      ShowPossibleTimeZones(thisTime) 
-
-      thisTime = New DateTimeOffset(#03/10/2007#, New TimeSpan(-6, 0, 0))  
-      ShowPossibleTimeZones(thisTime)
-
-      thisTime = New DateTimeOffset(#03/10/2007#, New TimeSpan(+1, 0, 0))
-      ShowPossibleTimeZones(thisTime)
-   End Sub
-
-   Private Sub ShowPossibleTimeZones(offsetTime As DateTimeOffset)
-      Dim offset As TimeSpan = offsetTime.Offset
-      Dim timeZones As ReadOnlyCollection(Of TimeZoneInfo)
-
-      Console.WriteLine("{0} could belong to the following time zones:", _
-                        offsetTime.ToString())
-      ' Get all time zones defined on local system
-      timeZones = TimeZoneInfo.GetSystemTimeZones()     
-      ' Iterate time zones
-      For Each timeZone As TimeZoneInfo In timeZones
-         ' Compare offset with offset for that date in that time zone
-         If timeZone.GetUtcOffset(offsetTime.DateTime).Equals(offset) Then
-            Console.WriteLine("   {0}", timeZone.DisplayName)
-         End If   
-      Next
-      Console.WriteLine()
-   End Sub
-End Module
-' This example displays the following output to the console:
-'       6/10/2007 12:00:00 AM -07:00 could belong to the following time zones:
-'          (GMT-07:00) Arizona
-'          (GMT-08:00) Pacific Time (US & Canada)
-'          (GMT-08:00) Tijuana, Baja California
-'       
-'       3/10/2007 12:00:00 AM -06:00 could belong to the following time zones:
-'          (GMT-06:00) Central America
-'          (GMT-06:00) Central Time (US & Canada)
-'          (GMT-06:00) Guadalajara, Mexico City, Monterrey - New
-'          (GMT-06:00) Guadalajara, Mexico City, Monterrey - Old
-'          (GMT-06:00) Saskatchewan
-'       
-'       3/10/2007 12:00:00 AM +01:00 could belong to the following time zones:
-'          (GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna
-'          (GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague
-'          (GMT+01:00) Brussels, Copenhagen, Madrid, Paris
-'          (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb
-'          (GMT+01:00) West Central Africa
-```
-
-この例の日付と時刻の値はそれぞれ少なくとも&3; つの異なるタイム ゾーンに属することができることを出力は示しています。 [DateTimeOffset](xref:System.DateTimeOffset) 値の 6/10/2007 は、日付と時刻の値が夏時間を表す場合、UTC のそのオフセットは必ずしも元のタイム ゾーンの基本 UTC オフセット、またはその表示名から見つかる UTC のオフセットと一致しないことを示しています。 これは、単一の [DateTimeOffset](xref:System.DateTimeOffset) 値はそのタイム ゾーンと密接に関連していないために夏時間との間のタイム ゾーンの遷移を反映することができないことを意味しています。 これは特に、日付と時刻の演算を使用して [DateTimeOffset](xref:System.DateTimeOffset) 値を操作する際に問題となる可能性があります。 タイム ゾーンの調整規則を考慮に入れた日付と時刻の演算を実行する方法については、「[日付と時刻を使用した算術演算の実行](performing-arithmetic-operations.md)」を参照してください。
-
-## <a name="the-timespan-structure"></a>TimeSpan 構造体
-
-[System.TimeSpan](xref:System.TimeSpan) 構造体は、時間間隔を表します。 その&2; つの一般的な用途は、次のとおりです。 
-
-* 2 つの日付と時刻の値の間の時間を反映する。 たとえば、ある値から [DateTime](xref:System.DateTime) 値を減算すると、[TimeSpan](xref:System.TimeSpan) 値が返されます。 
-
-* 経過時間を測定する。 たとえば、[Stopwatch.Elapsed](xref:System.Diagnostics.Stopwatch.Elapsed) プロパティは、経過時間の測定を開始する [System.Diagnostics.Stopwatch](xref:System.Diagnostics.Stopwatch) メソッドの&1; つを呼び出してから経過した時間間隔を反映する [TimeSpan](xref:System.TimeSpan) 値を返します。
-
-値が特定時刻への参照がない値が時間を反映する際、[DateTime](xref:System.DateTime) 値の代わりに [TimeSpan](xref:System.TimeSpan) 値を使用することもできます。 この用途は [DateTime.TimeOfDay](xref:System.DateTime.TimeOfDay) および [DateTimeOffset.TimeOfDay](xref:System.DateTimeOffset.TimeOfDay) プロパティと似ています。これらのプロパティは、日付への参照なしの時間を表す [TimeSpan](xref:System.TimeSpan) 値を返します。 たとえば、[TimeSpan](xref:System.TimeSpan) 構造体を使用して、ストアの開店時刻または閉店時刻を反映したり、標準イベントが発生したときの時刻を表したりするために使用できます。
-
-以下の例では、開店時刻と閉店時刻用の [TimeSpan](xref:System.TimeSpan) オブジェクト、およびストアのタイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを含む `StoreInfo` 構造体を定義します。 構造体には、`IsOpenNow`、`IsOpenAt` という&2; つのメソッドも含まれます。これは、ローカル タイム ゾーンにいると想定されるユーザーによって指定された時刻にストアがオープンするかどうかを示します。  
-
-```csharp
-using System;
-
-public struct StoreInfo
-{
-   public String store;
-   public TimeZoneInfo tz;
-   public TimeSpan open;
-   public TimeSpan close;
-
-   public bool IsOpenNow()
-   {
-      return IsOpenAt(DateTime.TimeOfDay);
-   }
-
-   public bool IsOpenAt(TimeSpan time)
-   {
-      TimeZoneInfo local = TimeZoneInfo.Local;
-      TimeSpan offset = TimeZoneInfo.BaseUtcOffset;
-
-      // Is the store in the same time zone?
-      if (tz.Equals(local)) {
-         return time >= open & time <= close;
-      }
-   }
-}
-```
-
-```vb
-Public Structure StoreInfo
-   Dim store As String
-   Dim tz As TimeZoneInfo
-   Dim open As TimeSpan
-   Dim close As TimeSpan
-
-   Public Function IsOpenNow() As Boolean
-      Return IsOpenAt(Date.Now.TimeOfDay)
-   End Function
-
-   Public Function IsOpenAt(time As TimeSpan) As Boolean
-      Dim local As TimeZoneInfo = TimeZoneInfo.Local
-      Dim offset As TimeSpan = TimeZoneInfo.Local.BaseUtcOffset
-
-      ' Is the store in the same time zone?
-      If tz.Equals(local) Then
-         Return time >= open And time <= close
-      Else
-         Dim delta As TimeSpan = TimeSpan.Zero
-         Dim storeDelta As TimeSpan = TimeSpan.Zero
-
-         ' Is it daylight saving time in either time zone?
-         If local.IsDaylightSavingTime(Date.Now.Date + time) Then
-            delta = local.GetAdjustmentRules(local.GetAdjustmentRules().Length - 1).DaylightDelta
-         End If
-         If tz.IsDaylightSavingTime(TimeZoneInfo.ConvertTime(Date.Now.Date + time, local, tz))
-            storeDelta = tz.GetAdjustmentRules(local.GetAdjustmentRules().Length - 1).DaylightDelta
-         End If
-         Dim comparisonTime As TimeSpan = time + (offset - tz.BaseUtcOffset).Negate() + (delta - storeDelta).Negate
-         Return (comparisonTime >= open And comparisonTime <= close)
-      End If
-   End Function
-End Structure
-```
-
-`StoreInfo` 構造体をクライアント コードで次のように使用できます。 
-
-```csharp
-public class Example
-{
-   public static void Main()
-   {
-      // Instantiate a StoreInfo object.
-      var store103 = new StoreInfo();
-      store103.store = "Store #103";
-      store103.tz = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
-      // Store opens at 8:00.
-      store103.open = new TimeSpan(8, 0, 0);
-      // Store closes at 9:30.
-      store103.close = new TimeSpan(21, 30, 0);
-
-      Console.WriteLine("Store is open now at {0}: {1}",
-                        DateTime.TimeOfDay, store103.IsOpenNow());
-      TimeSpan[] times = { new TimeSpan(8, 0, 0), new TimeSpan(21, 0, 0),
-                           new TimeSpan(4, 59, 0), new TimeSpan(18, 31, 0) };
-      foreach (var time in times)
-         Console.WriteLine("Store is open at {0}: {1}",
-                           time, store103.IsOpenAt(time));
-   }
-}
-// The example displays the following output:
-//       Store is open now at 15:29:01.6129911: True
-//       Store is open at 08:00:00: True
-//       Store is open at 21:00:00: False
-//       Store is open at 04:59:00: False
-//       Store is open at 18:31:00: False
-```
-
-```vb
-Module Example
-   Public Sub Main()
-      ' Instantiate a StoreInfo object.
-      Dim store103 As New StoreInfo()
-      store103.store = "Store #103"
-      store103.tz = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
-      ' Store opens at 8:00.
-      store103.open = new TimeSpan(8, 0, 0)
-      ' Store closes at 9:30.
-      store103.close = new TimeSpan(21, 30, 0)
-
-      Console.WriteLine("Store is open now at {0}: {1}",
-                        Date.Now.TimeOfDay, store103.IsOpenNow())
-      Dim times() As TimeSpan = { New TimeSpan(8, 0, 0),
-                                  New TimeSpan(21, 0, 0),
-                                  New TimeSpan(4, 59, 0),
-                                  New TimeSpan(18, 31, 0) }
-      For Each time In times
-         Console.WriteLine("Store is open at {0}: {1}",
-                           time, store103.IsOpenAt(time))
-      Next
-   End Sub
-End Module
-' The example displays the following output:
-'       Store is open now at 15:29:01.6129911: True
-'       Store is open at 08:00:00: True
-'       Store is open at 21:00:00: False
-'       Store is open at 04:59:00: False
-'       Store is open at 18:31:00: False
-```
-
-## <a name="the-timezoneinfo-class"></a>TimeZoneInfo クラス
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスは地球のタイム ゾーンを表し、1 つのタイム ゾーンの日付と時刻の値を、別のタイム ゾーンの日付と時刻の値に変換できるようにします。 [TimeZoneInfo](xref:System.TimeZoneInfo) クラスにより、日付と時刻を使用して、どの日付と時刻の値も明確に単一時点を識別できるようにすることができます。
-
-場合によっては、[TimeZoneInfo](xref:System.TimeZoneInfo) クラスをフル活用するために、開発作業をさらに実行する必要が生じることもあります。 日付と時刻の値は、それが属するタイム ゾーンに密接に関連付けられていません。 結果として、アプリケーションが日付と時刻をその関連タイム ゾーンとリンクするメカニズムを提供していない場合、特定の日付と時刻の値とそのタイム ゾーンの関連付けは簡単に解除されます。 この情報をリンクする&1; つの方法は、日付と時刻の値とその関連タイム ゾーン オブジェクトの両方を含むクラスまたは構造体を定義するという方法です。
-
-日付と時刻のオブジェクトをインスタンスするときにその日付と時刻の値が属するタイム ゾーンがわかっている場合のみ、.NET でタイム ゾーンのサポートを利用できます。 特に Web またはネットワーク アプリケーションでは、これは該当しません。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
+>  <xref:System.DateTimeOffset> 値のこの用途は、<xref:System.DateTime> 値の用途と比べてはるかに一般的です。 その結果、<xref:System.DateTimeOffset> はアプリケーション開発の既定の日付時刻型と見なされます。  
+  
+ <xref:System.DateTimeOffset> 値は特定のタイム ゾーンと関連付けられていませんが、さまざまなタイム ゾーンから派生することができます。 これを説明するために、いくつかの <xref:System.DateTimeOffset> 値 \(ローカルの太平洋標準時を含む\) が属することができるタイム ゾーンの一覧を次の例に示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual1.cs#1)]
+ [!code-vb[System.DateTimeOffset.Conceptual#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual1.vb#1)]  
+  
+ この例の日付と時刻の値はそれぞれ少なくとも 3 つの異なるタイム ゾーンに属することができることを出力は示しています。<xref:System.DateTimeOffset> 値の 6\/10\/2007 は、日付と時刻の値が夏時間を表す場合、UTC のそのオフセットは必ずしも元のタイム ゾーンの基本 UTC オフセット、またはその表示名から見つかる UTC のオフセットと一致しないことを示しています。 これは、単一の <xref:System.DateTimeOffset> 値はそのタイム ゾーンと密接に関連していないために夏時間との間のタイム ゾーンの遷移を反映することができないことを意味しています。 これは特に、日付と時刻の演算を使用して <xref:System.DateTimeOffset> 値を操作する際に問題となる可能性があります。 \(タイム ゾーンの調整規則を考慮に入れた日付と時刻の演算を実行する方法については、「[日付と時刻を使用した算術演算の実行](../../../docs/standard/datetime/performing-arithmetic-operations.md)」をご覧ください\)。  
+  
+## TimeSpan 構造体  
+ <xref:System.TimeSpan> 構造体は、時間間隔を表します。 その 2 つの一般的な用途は、次のとおりです。  
+  
+-   2 つの日付と時刻の値の間の時間を反映する。 たとえば、ある値から <xref:System.DateTime> 値を減算すると、<xref:System.TimeSpan> 値が返されます。  
+  
+-   経過時間を測定する。 たとえば、<xref:System.Diagnostics.Stopwatch.Elapsed%2A?displayProperty=fullName> プロパティは、経過時間の測定を開始する <xref:System.Diagnostics.Stopwatch> メソッドの 1 つを呼び出してから経過した時間間隔を反映する  <xref:System.TimeSpan> 値を返します。  
+  
+ 値が特定時刻への参照がない値が時間を反映する際、<xref:System.TimeSpan> 値の代わりに <xref:System.DateTime> 値を使用することもできます。 この用途は <xref:System.DateTime.TimeOfDay%2A?displayProperty=fullName> および <xref:System.DateTimeOffset.TimeOfDay%2A?displayProperty=fullName> プロパティと似ています。これらのプロパティは、日付への参照なしの時間を表す <xref:System.TimeSpan> 値を返します。 たとえば、<xref:System.TimeSpan> 構造体を使用して、ストアの開店時刻または閉店時刻を反映したり、標準イベントが発生したときの時刻を表したりするために使用できます。  
+  
+ 以下の例では、開店時刻と閉店時刻用の <xref:System.TimeSpan> オブジェクト、およびストアのタイム ゾーンを表す <xref:System.TimeZoneInfo> オブジェクトを含む `StoreInfo` 構造体を定義します。 構造体には、`IsOpenNow`、`IsOpenAt` という 2 つのメソッドも含まれます。これは、ローカル タイム ゾーンにいると想定されるユーザーによって指定された時刻にストアがオープンするかどうかを示します。  
+  
+ [!code-csharp[Conceptual.ChoosingDates#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.choosingdates/cs/datetimereplacement1.cs#1)]
+ [!code-vb[Conceptual.ChoosingDates#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.choosingdates/vb/datetimereplacement1.vb#1)]  
+  
+ `StoreInfo` 構造体をクライアント コードで次のように使用できます。  
+  
+ [!code-csharp[Conceptual.ChoosingDates#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.choosingdates/cs/datetimereplacement1.cs#2)]
+ [!code-vb[Conceptual.ChoosingDates#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.choosingdates/vb/datetimereplacement1.vb#2)]  
+  
+## TimeZoneInfo クラス  
+ <xref:System.TimeZoneInfo> クラスは地球のタイム ゾーンを表し、1 つのタイム ゾーンの日付と時刻の値を、別のタイム ゾーンの日付と時刻の値に変換できるようにします。<xref:System.TimeZoneInfo> クラスにより、日付と時刻を使用して、どの日付と時刻の値も明確に単一時点を識別できるようにすることができます。<xref:System.TimeZoneInfo> クラスを拡張することもできます。 Windows システムで提供され、レジストリで定義されているタイム ゾーン情報に依存していますが、カスタムのタイム ゾーンの作成もサポートされています。 また、タイム ゾーン情報のシリアル化と逆シリアル化もサポートされています。  
+  
+ 場合によっては、<xref:System.TimeZoneInfo> クラスをフル活用するために、開発作業をさらに実行する必要が生じることもあります。 1 つ目に、日付と時刻の値は、それが属するタイム ゾーンに密接に関連付けられていません。 結果として、アプリケーションが日付と時刻をその関連タイム ゾーンとリンクするメカニズムを提供していない場合、特定の日付と時刻の値とそのタイム ゾーンの関連付けは簡単に解除されます。 \(この情報をリンクする 1 つの方法は、日付と時刻の値とその関連タイム ゾーン オブジェクトの両方を含むクラスまたは構造体を定義するという方法です。\) 2 つ目に、Windows XP および Windows の以前のバージョンには履歴タイム ゾーン情報に関するサポートがなく、[!INCLUDE[windowsver](../../../includes/windowsver-md.md)] には限られたサポートのみがあります。 履歴日時を処理するように設計されているアプリケーションは、カスタム タイム ゾーンを広範に利用する必要があります。  
+  
+ 日付と時刻のオブジェクトをインスタンスするときにその日付と時刻の値が属するタイム ゾーンがわかっている場合のみ、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] でタイム ゾーンのサポートを利用できます。 特に Web またはネットワーク アプリケーションでは、これは該当しません。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/converting-between-datetime-and-offset.md b/docs/standard/datetime/converting-between-datetime-and-offset.md
index 8fb7aca39a8..9785765b566 100644
--- a/docs/standard/datetime/converting-between-datetime-and-offset.md
+++ b/docs/standard/datetime/converting-between-datetime-and-offset.md
@@ -1,533 +1,128 @@
 ---
-title: "DateTime と DateTimeOffset 間の変換"
-description: "DateTime と DateTimeOffset 間の変換"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: fab3af5b-5d0f-4384-a40a-1b5d99b30dd1
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 2ba70e9ea39148d040bdb46d5e00ea50dcbb8980
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="converting-between-datetime-and-datetimeoffset"></a>DateTime と DateTimeOffset 間の変換
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 構造体は、[System.DateTime](xref:System.DateTime) 構造体よりも高度なタイム ゾーン対応を実現しますが、メソッド呼び出しでは [DateTime](xref:System.DateTime) パラメーターがよく使用されます。 このため、[DateTimeOffset](xref:System.DateTimeOffset) 値を [DateTime](xref:System.DateTime) 値に、またはその逆方向に変換する機能が特に重要です。 この記事では、タイム ゾーン情報をできるだけ多く保持するようにこれらの変換を実行する方法を示します。
-
+title: "DateTime と DateTimeOffset 間の変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変換 (DateTimeOffset 値と DateTime 値を)"
+  - "変換 (時間を)"
+  - "Date データ型, 変換"
+  - "日付 [.NET Framework], 変換"
+  - "DateTime 構造体, 変換"
+  - "DateTimeOffset 構造体, 変換"
+  - "ローカル タイムの変換"
+  - "タイム ゾーン [.NET Framework], 変換"
+  - "UTC 時刻, 変換"
+ms.assetid: b605ff97-0c45-4c24-833f-4c6a3e8be64c
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# DateTime と DateTimeOffset 間の変換
+<xref:System.DateTimeOffset> 構造体は <xref:System.DateTime> 構造体と比較してタイム ゾーンへの対応の程度が高くなっていますが、メソッドの呼び出しでは <xref:System.DateTime> パラメーターを使用するのが一般的です。  このため、<xref:System.DateTimeOffset> と <xref:System.DateTime> との間で値を変換する機能は、特に重要になります。  ここでは、タイム ゾーン情報を可能な限り保持しながら、これらの変換を実行する方法について説明します。  
+  
 > [!NOTE]
-> [DateTime](xref:System.DateTime) 型と [DateTimeOffset](xref:System.DateTimeOffset) 型は両方とも、タイム ゾーンの時刻を表す場合に制限があります。 [DateTime](xref:System.DateTime) は、その [Kind](xref:System.DateTime.Kind) プロパティによって世界協定時刻 (UTC) とシステムのローカル タイム ゾーンのみを反映できます。 [DateTimeOffset](xref:System.DateTimeOffset) は、UTC からの時間のオフセットを反映しますが、そのオフセットが所属する実際のタイム ゾーンは反映しません。 時刻の値とタイム ゾーンのサポートの詳細については、「[DateTime DateTimeOffset TimeSpan、および TimeZoneInfo の使い分け](choosing-between-datetime.md)」を参照してください。
-
-## <a name="conversions-from-datetime-to-datetimeoffset"></a>DateTime から DateTimeOffset への変換
-
-[DateTimeOffset](xref:System.DateTimeOffset) 構造体は、ほとんどの変換に適した、[DateTime](xref:System.DateTime) から [DateTimeOffset](xref:System.DateTimeOffset) への変換を実行する次の&2; つの相当する方法を提供します。
-
-* [DateTimeOffset(DateTime)](xref:System.DateTimeOffset) コンストラクター。[DateTime](xref:System.DateTime) 値に基づいて新しい [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトを作成します。
-
-* 暗黙的な変換演算子。[DateTime](xref:System.DateTime) 値を [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトに割り当て可能にします。
-
-UTC と現地の [DateTime](xref:System.DateTime) 値について、変換後の [DateTimeOffset](xref:System.DateTimeOffset) 値の [DateTimeOffset.Offset](xref:System.DateTimeOffset.Offset) プロパティは、UTC またはローカル タイム ゾーン オフセットを正確に反映します。 たとえば、次のコードは、UTC 時刻を同等の [DateTimeOffset](xref:System.DateTimeOffset) 値に変換します。 
-
-```csharp
-DateTime utcTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
-utcTime1 = DateTime.SpecifyKind(utcTime1, DateTimeKind.Utc);
-DateTimeOffset utcTime2 = utcTime1;
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
-                  utcTime1, 
-                  utcTime1.Kind.ToString(), 
-                  utcTime2);
-// This example displays the following output to the console:
-//    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM +00:00
-```
-
-```vb
-Dim utcTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, _
-                                        DateTimeKind.Utc)
-Dim utcTime2 As DateTimeOffset = utcTime1
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
-                  utcTime1, _
-                  utcTime1.Kind.ToString(), _
-                  utcTime2)
-' This example displays the following output to the console:
-'    Converted 6/19/2008 7:00:00 AM Utc to a DateTimeOffset value of 6/19/2008 7:00:00 AM  +00:00
-```
-
-この場合、`utcTime2` 変数のオフセットは 00:00 です。 同様に、次のコードは、現地時刻を同等の [DateTimeOffset](xref:System.DateTimeOffset) 値に変換します。
-
-```csharp
-DateTime localTime1 = new DateTime(2008, 6, 19, 7, 0, 0);
-localTime1 = DateTime.SpecifyKind(localTime1, DateTimeKind.Local);
-DateTimeOffset localTime2 = localTime1;
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
-                  localTime1, 
-                  localTime1.Kind.ToString(), 
-                  localTime2);
-// This example displays the following output to the console:
-//    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00
-```
-
-```vb
-Dim localTime1 As Date = Date.SpecifyKind(#06/19/2008 7:00AM#, DateTimeKind.Local)
-Dim localTime2 As DateTimeOffset = localTime1
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
-                  localTime1, _
-                  localTime1.Kind.ToString(), _
-                  localTime2)
-' This example displays the following output to the console:
-'    Converted 6/19/2008 7:00:00 AM Local to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00
-```
-
-ただし、[Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) である [DateTime](xref:System.DateTime) 値については、これらの&2; つの変換メソッドは、オフセットがローカル タイム ゾーンのオフセットである [DateTimeOffset](xref:System.DateTimeOffset) 値を生成します。 米国の太平洋標準時ゾーンでの実行例を次に示します。
-
-```csharp
-DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);  // Kind is DateTimeKind.Unspecified
-DateTimeOffset time2 = time1;
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", 
-                  time1, 
-                  time1.Kind.ToString(), 
-                  time2);
-// This example displays the following output to the console:
-//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00
-```
-
-```vb
-Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
-Dim time2 As DateTimeOffset = time1
-Console.WriteLine("Converted {0} {1} to a DateTimeOffset value of {2}", _
-                  time1, _
-                  time1.Kind.ToString(), _
-                  time2)
-' This example displays the following output to the console:
-'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTimeOffset value of 6/19/2008 7:00:00 AM -07:00
-```
-
-[DateTime](xref:System.DateTime) 値がローカル タイム ゾーンまたは UTC 以外の何らかの日時を反映している場合は、オーバーロードされた [DateTimeOffset(DateTime, TimeSpan)](xref:System.DateTimeOffset) コンストラクターを呼び出して、この値を [DateTimeOffset](xref:System.DateTimeOffset) 値に変換し、そのタイム ゾーン情報を保持することができます。 たとえば、次の例では、中部標準時を反映する [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトをインスタンス化します。
-
-```csharp
-DateTime time1 = new DateTime(2008, 6, 19, 7, 0, 0);     // Kind is DateTimeKind.Unspecified
-try
-{
-   DateTimeOffset time2 = new DateTimeOffset(time1, 
-                  TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1)); 
-   Console.WriteLine("Converted {0} {1} to a DateTime value of {2}", 
-                     time1, 
-                     time1.Kind.ToString(), 
-                     time2);
-}
-// Handle exception if time zone is not defined in registry
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("Unable to identify target time zone for conversion.");
-}
-// This example displays the following output to the console:
-//    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00
-```
-
-```vb
-Dim time1 As Date = #06/19/2008 7:00AM#      ' Kind is DateTimeKind.Unspecified
-Try
-   Dim time2 As New DateTimeOffset(time1, _
-                    TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(time1)) 
-   Console.WriteLine("Converted {0} {1} to a DateTime value of {2}", _
-                     time1, _
-                     time1.Kind.ToString(), _
-                     time2)
-' Handle exception if time zone is not defined in registry
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("Unable to identify target time zone for conversion.")
-End Try
-' This example displays the following output to the console:
-'    Converted 6/19/2008 7:00:00 AM Unspecified to a DateTime value of 6/19/2008 7:00:00 AM -05:00
-```
-
-このコンストラクター オーバーロードの&2; 番目のパラメーターは、UTC からの時刻のオフセットを表す [System.TimeSpan](xref:System.TimeSpan) オブジェクトです。このオブジェクトは、時刻の対応するタイム ゾーンの [TimeZoneInfo.GetUtcOffset(DateTime)](xref:System.TimeZoneInfo) メソッドを呼び出して取得する必要があります。 このメソッドの単一のパラメーターは、変換する日時を表す [DateTime](xref:System.DateTime) 値です。 タイム ゾーンで夏時間がサポートされている場合、このパラメーターにより、このメソッドはその特定の日時に対して適切なオフセットを決定できます。
-
-## <a name="conversions-from-datetimeoffset-to-datetime"></a>DateTimeOffset から DateTime への変換
-
-[DateTimeOffset](xref:System.DateTimeOffset) から [DateTime](xref:System.DateTime) への変換の実行には、[DateTime](xref:System.DateTime) プロパティが最もよく使用されます。 ただし、次の例に示すように、このプロパティは、[Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) である [DateTime](xref:System.DateTime) 値を返します。 
-
-```csharp
-DateTime baseTime = new DateTime(2008, 6, 19, 7, 0, 0);
-DateTimeOffset sourceTime;
-DateTime targetTime;
-
-// Convert UTC to DateTime value
-sourceTime = new DateTimeOffset(baseTime, TimeSpan.Zero);
-targetTime = sourceTime.DateTime;
-Console.WriteLine("{0} converts to {1} {2}", 
-                  sourceTime, 
-                  targetTime, 
-                  targetTime.Kind.ToString());
-
-// Convert local time to DateTime value
-sourceTime = new DateTimeOffset(baseTime, 
-                                TimeZoneInfo.Local.GetUtcOffset(baseTime));
-targetTime = sourceTime.DateTime;
-Console.WriteLine("{0} converts to {1} {2}", 
-                  sourceTime, 
-                  targetTime, 
-                  targetTime.Kind.ToString());
-
-// Convert Central Standard Time to a DateTime value
-try
-{
-   TimeSpan offset = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime);
-   sourceTime = new DateTimeOffset(baseTime, offset);
-   targetTime = sourceTime.DateTime;
-   Console.WriteLine("{0} converts to {1} {2}", 
-                     sourceTime, 
-                     targetTime, 
-                     targetTime.Kind.ToString());
-}
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.");
-} 
-// This example displays the following output to the console:
-//    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
-//    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
-//    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified 
-```
-
-```vb
-Const baseTime As Date = #06/19/2008 7:00AM#
-Dim sourceTime As DateTimeOffset
-Dim targetTime As Date
-
-' Convert UTC to DateTime value
-sourceTime = New DateTimeOffset(baseTime, TimeSpan.Zero)
-targetTime = sourceTime.DateTime
-Console.WriteLine("{0} converts to {1} {2}", _
-                  sourceTime, _
-                  targetTime, _
-                  targetTime.Kind.ToString())
-
-' Convert local time to DateTime value
-sourceTime = New DateTimeOffset(baseTime, _
-                                TimeZoneInfo.Local.GetUtcOffset(baseTime))
-targetTime = sourceTime.DateTime
-Console.WriteLine("{0} converts to {1} {2}", _
-                  sourceTime, _
-                  targetTime, _
-                  targetTime.Kind.ToString())
-
-' Convert Central Standard Time to a DateTime value
-Try
-   Dim offset As TimeSpan = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(baseTime)
-   sourceTime = New DateTimeOffset(baseTime, offset)
-   targetTime = sourceTime.DateTime
-Console.WriteLine("{0} converts to {1} {2}", _
-                  sourceTime, _
-                  targetTime, _
-                  targetTime.Kind.ToString())
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("Unable to create DateTimeOffset based on U.S. Central Standard Time.")
-End Try 
-' This example displays the following output to the console:
-'    6/19/2008 7:00:00 AM +00:00 converts to 6/19/2008 7:00:00 AM Unspecified
-'    6/19/2008 7:00:00 AM -07:00 converts to 6/19/2008 7:00:00 AM Unspecified
-'    6/19/2008 7:00:00 AM -05:00 converts to 6/19/2008 7:00:00 AM Unspecified 
-```
-
-つまり、[DateTime](xref:System.DateTime) プロパティを使用すると、変換によって [DateTimeOffset](xref:System.DateTimeOffset) 値と UTC との関係に関するすべての情報が失われます。 このことは、UTC 時刻またはシステムの現地時刻に対応する [DateTimeOffset](xref:System.DateTimeOffset) 値に影響を与えます。これは、[DateTime](xref:System.DateTime) 構造体が、その [Kind](xref:System.DateTime.Kind) プロパティでこれらの&2; つのタイム ゾーンのみを反映するためです。
-
-[DateTimeOffset](xref:System.DateTimeOffset) を [DateTime](xref:System.DateTime) 値に変換するときにできるだけ多くのタイム ゾーン情報を保持するには、[DateTimeOffset.UtcDateTime](xref:System.DateTimeOffset.UtcDateTime) プロパティと [DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティを使用します。 
-
-## <a name="converting-a-utc-time"></a>UTC 時刻の変換
-
-変換された [DateTime](xref:System.DateTime) 値が UTC 時刻であることを示すには、[DateTimeOffset.UtcDateTime](xref:System.DateTimeOffset.UtcDateTime) プロパティの値を取得します。 このプロパティは、[DateTimeOffset.DateTime](xref:System.DateTimeOffset.DateTime) プロパティと次の&2; つの点で異なります。
-
-* [Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) である [DateTime](xref:System.DateTime) 値を返します。
-
-* [DateTimeOffset.Offset](xref:System.DateTimeOffset.Offset) プロパティ値が [TimeSpan.Zero](xref:System.TimeSpan.Zero) と等しくない場合、時刻を UTC に変換します。
-
+>  <xref:System.DateTime> 型と <xref:System.DateTimeOffset> 型には、タイム ゾーンで時刻を表すときにいくつかの制限事項があります。  <xref:System.DateTime.Kind%2A> プロパティを使用すると、<xref:System.DateTime> は世界協定時刻 \(UTC: Coordinated Universal Time\) とシステムのローカル タイム ゾーンのみを反映できます。  <xref:System.DateTimeOffset> は、UTC からの時刻のオフセットを反映しますが、そのオフセットが属する実際のタイム ゾーンは反映しません。  時刻の値とタイム ゾーンのサポートの詳細については、「[DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](../../../docs/standard/datetime/choosing-between-datetime.md)」を参照してください。  
+  
+## DateTime から DateTimeOffset への変換  
+ <xref:System.DateTimeOffset> 構造体は、大部分の変換処理に適する、<xref:System.DateTime> から <xref:System.DateTimeOffset> への変換を実行するための方法を 2 つ提供します。これらはどちらも同等の効果があります。  
+  
+-   <xref:System.DateTimeOffset.%23ctor%2A> コンストラクター。<xref:System.DateTime> 値に基づいて、新しい <xref:System.DateTimeOffset> オブジェクトを作成します。  
+  
+-   暗黙の変換演算子。<xref:System.DateTimeOffset> オブジェクトに対し、<xref:System.DateTime> 値を割り当てることができます。  
+  
+ UTC およびローカルの <xref:System.DateTime> 値では、結果として出力された <xref:System.DateTimeOffset> 値の <xref:System.DateTimeOffset.Offset%2A> プロパティに、UTC またはローカル タイム ゾーン オフセットが正確に反映されます。  たとえば、次に示すコードでは、UTC 時刻を同等の <xref:System.DateTimeOffset> 値に変換します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#1)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#1)]  
+  
+ この場合、`utcTime2` 変数のオフセットは 00:00 です。  同様に、次に示すコードでは、ローカル タイムを同等の <xref:System.DateTimeOffset> 値に変換します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#2)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#2)]  
+  
+ ただし、<xref:System.DateTime> 値 \(<xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName>\) である場合は、これらの 2 つの変換メソッドにより、オフセットにローカル タイム ゾーンが設定された <xref:System.DateTimeOffset> 値が生成されます。  これは米国の太平洋標準時タイム ゾーンで実行するには、次の例に示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#3)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#3)]  
+  
+ <xref:System.DateTime> 値がローカル タイム ゾーンでも UTC でもない日付と時刻を反映する場合は、その値を <xref:System.DateTimeOffset> 値に変換し、オーバーロードされた <xref:System.DateTimeOffset.%23ctor%2A> コンストラクターを呼び出すことによって、タイム ゾーン情報を保持できます。  たとえば、中部標準時を反映する <xref:System.DateTimeOffset> オブジェクトをインスタンス化する例を次に示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#4)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#4)]  
+  
+ 時刻の対応するタイム ゾーンの <xref:System.TimeZoneInfo.GetUtcOffset%28System.DateTime%29?displayProperty=fullName> メソッドを呼び出して、コンストラクター オーバーロードに対する 2 番目のパラメーターである <xref:System.TimeSpan> オブジェクト \(UTC からの時刻のオフセットを表す\) を取得する必要があります。  このメソッドの唯一のパラメーターは、変換される日付と時刻を表す <xref:System.DateTime> 値です。  夏時間をサポートするタイム ゾーンである場合にこのパラメーターを使用すると、メソッドによって特定の日付と時刻に対する適切なオフセットを決定できます。  
+  
+## DateTimeOffset から DateTime への変換  
+ <xref:System.DateTimeOffset.DateTime%2A> プロパティは、一般に <xref:System.DateTimeOffset> から <xref:System.DateTime> への変換を実行するときに使用されます。  ただし、次の例に示すように、<xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind> である <xref:System.DateTime> 値を返します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#5)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#5)]  
+  
+ これは、<xref:System.DateTimeOffset.DateTime%2A> プロパティが設定された状態で変換を行うと、UTC に対する <xref:System.DateTimeOffset> 値の関係が削除されることを意味します。  これは、UTC 時刻またはシステムの現地時刻に対応する <xref:System.DateTimeOffset> 値に影響します。その理由は、<xref:System.DateTimeOffset.DateTime%2A> 構造体が反映するのは <xref:System.DateTime.Kind%2A> プロパティに設定されている 2 つのタイム ゾーンだけであるからです。  
+  
+ タイム ゾーン情報を可能な限り保持しながら <xref:System.DateTimeOffset> から <xref:System.DateTime> 値への変換を行うためには、<xref:System.DateTimeOffset.UtcDateTime%2A?displayProperty=fullName> プロパティと <xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティを使用します。  
+  
+### UTC 時刻の変換  
+ 変換後の <xref:System.DateTimeOffset.DateTime%2A> 値が UTC 時刻であることを確認するには、<xref:System.DateTimeOffset.UtcDateTime%2A?displayProperty=fullName> プロパティの値を取得します。  これは、<xref:System.DateTimeOffset.DateTime%2A> プロパティと 2 つの点で異なります。  
+  
+-   <xref:System.DateTime> 値を返します。このとき、<xref:System.DateTime.Kind%2A> プロパティは <xref:System.DateTimeKind> に設定されています。  
+  
+-   <xref:System.DateTimeOffset.Offset%2A> プロパティの値が <xref:System.TimeSpan.Zero?displayProperty=fullName> ではない場合、時刻を UTC に変換します。  
+  
 > [!NOTE]
-> アプリケーションで、[DateTime](xref:System.DateTime) 値によってある時点を明確に識別する必要がある場合、[DateTimeOffset](xref:System.DateTimeOffset) から [DateTime](xref:System.DateTime) へのすべての変換を処理するために、[DateTimeOffset.UtcDateTime](xref:System.DateTimeOffset.UtcDateTime) プロパティの使用を検討してください。
-
-次のコードは、[UtcDateTime](xref:System.DateTimeOffset.UtcDateTime) プロパティを使用して、オフセットが [TimeSpan.Zero](xref:System.TimeSpan.Zero) と等しい [DateTimeOffset](xref:System.DateTimeOffset) 値を [DateTime](xref:System.DateTime) 値に変換します。
-
-```csharp
-DateTimeOffset utcTime1 = new DateTimeOffset(2008, 6, 19, 7, 0, 0, TimeSpan.Zero);
-DateTime utcTime2 = utcTime1.UtcDateTime;
-Console.WriteLine("{0} converted to {1} {2}", 
-                  utcTime1, 
-                  utcTime2, 
-                  utcTime2.Kind.ToString());
-// The example displays the following output to the console:
-//   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
-```
-
-```vb
-Dim utcTime1 As New DateTimeOffset(#06/19/2008 7:00AM#, TimeSpan.Zero)
-Dim utcTime2 As Date = utcTime1.UtcDateTime
-Console.WriteLine("{0} converted to {1} {2}", _
-                  utcTime1, _
-                  utcTime2, _
-                  utcTime2.Kind.ToString())
-' The example displays the following output to the console:
-'   6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
-```
-
-次のコードは、UtcDateTime プロパティを使用して、[DateTimeOffset](xref:System.DateTimeOffset) 値に対してタイム ゾーン変換と型変換の両方を実行します。
-
-```csharp
-DateTimeOffset originalTime = new DateTimeOffset(2008, 6, 19, 7, 0, 0, new TimeSpan(5, 0, 0));
-DateTime utcTime = originalTime.UtcDateTime;
-Console.WriteLine("{0} converted to {1} {2}", 
-                  originalTime, 
-                  utcTime, 
-                  utcTime.Kind.ToString());
-// The example displays the following output to the console:
-//       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc
-```
-
-```vb
-Dim originalTime As New DateTimeOffset(#6/19/2008 7:00AM#, _
-                                       New TimeSpan(5, 0, 0))
-Dim utcTime As Date = originalTime.UtcDateTime
-Console.WriteLine("{0} converted to {1} {2}", _ 
-                  originalTime, _
-                  utcTime, _
-                  utcTime.Kind.ToString())
-' The example displays the following output to the console:
-'       6/19/2008 7:00:00 AM +05:00 converted to 6/19/2008 2:00:00 AM Utc
-```
-
-## <a name="converting-a-local-time"></a>現地時刻の変換
-
-[DateTimeOffset](xref:System.DateTimeOffset) 値が現地時刻を表すことを示すには、[DateTimeOffset.DateTime](xref:System.DateTimeOffset.DateTime) プロパティによって返される [DateTime](xref:System.DateTime) 値を静的な [DateTime.SpecifyKind(DateTime, DateTimeKind)](xref:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)) メソッドに渡します。 このメソッドは、その最初のパラメーターとして渡された日時を返しますが、[Kind](xref:System.DateTime.Kind) プロパティを、その&2; 番目のパラメーターによって指定された値に設定します。 次のコードは、オフセットがローカル タイム ゾーンのオフセットに対応する [DateTimeOffset](xref:System.DateTimeOffset) 値を変換する際に、[SpecifyKind(DateTime, DateTimeKind)](xref:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)) メソッドを使用します。
-
-```csharp
-DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
-DateTimeOffset utcTime1 = new DateTimeOffset(sourceDate, 
-                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
-DateTime utcTime2 = utcTime1.DateTime;
-if (utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime))) 
-   utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local);
-
-Console.WriteLine("{0} converted to {1} {2}", 
-                  utcTime1, 
-                  utcTime2, 
-                  utcTime2.Kind.ToString());
-// The example displays the following output to the console:
-//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
-```
-
-```vb
-Dim sourceDate As Date = #06/19/2008 7:00AM#
-Dim utcTime1 As New DateTimeOffset(sourceDate, _
-                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
-Dim utcTime2 As Date = utcTime1.DateTime
-If utcTime1.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(utcTime1.DateTime)) Then
-   utcTime2 = DateTime.SpecifyKind(utcTime2, DateTimeKind.Local)
-End If   
-Console.WriteLine("{0} converted to {1} {2}", _
-                  utcTime1, _
-                  utcTime2, _
-                  utcTime2.Kind.ToString())
-' The example displays the following output to the console:
-'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
-```
-
-[DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティを使用して、[DateTimeOffset](xref:System.DateTimeOffset) 値をローカルの [DateTime](xref:System.DateTime) 値に変換することもできます。 返される [DateTime](xref:System.DateTime) 値の [Kind](xref:System.DateTime.Kind) プロパティは、[DateTimeKind.Local](xref:System.DateTimeKind.Local) です。 次のコードは、オフセットがローカル タイム ゾーンのオフセットに対応する [DateTimeOffset](xref:System.DateTimeOffset) 値を変換する際に、[DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティを使用します。
-
-```csharp
-DateTime sourceDate = new DateTime(2008, 6, 19, 7, 0, 0);
-DateTimeOffset localTime1 = new DateTimeOffset(sourceDate, 
-                          TimeZoneInfo.Local.GetUtcOffset(sourceDate));
-DateTime localTime2 = localTime1.LocalDateTime;
-
-Console.WriteLine("{0} converted to {1} {2}", 
-                  localTime1, 
-                  localTime2, 
-                  localTime2.Kind.ToString());
-// The example displays the following output to the console:
-//   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
-```
-
-```vb
-Dim sourceDate As Date = #06/19/2008 7:00AM#
-Dim localTime1 As New DateTimeOffset(sourceDate, _
-                                   TimeZoneInfo.Local.GetUtcOffset(sourceDate))
-Dim localTime2 As Date = localTime1.LocalDateTime
-Console.WriteLine("{0} converted to {1} {2}", _
-                  localTime1, _
-                  localTime2, _
-                  localTime2.Kind.ToString())
-' The example displays the following output to the console:
-'   6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local 
-```
-
-[DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティを使用して [DateTime](xref:System.DateTime) 値を取得する場合、このプロパティの `get` アクセサーは、最初に [DateTimeOffset](xref:System.DateTimeOffset) 値を UTC に変換してから、[DateTimeOffset.ToLocalTime](xref:System.DateTimeOffset) メソッドを呼び出して現地時刻に変換します。 つまり、[DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティから値を取得して、型変換を実行するのと同時にタイム ゾーン変換を実行できます。 また、変換の実行にローカル タイム ゾーンの調整規則が適用されることも意味します。 次のコードは、[DateTimeOffset.LocalDateTime](xref:System.DateTimeOffset.LocalDateTime) プロパティを使用して型変換とタイム ゾーン変換の両方を実行する例を示しています。
-
-```csharp
-DateTimeOffset originalDate;
-DateTime localDate;
-
-// Convert time originating in a different time zone
-originalDate = new DateTimeOffset(2008, 6, 18, 7, 0, 0, 
-                                  new TimeSpan(-5, 0, 0));
-localDate = originalDate.LocalDateTime;
-Console.WriteLine("{0} converted to {1} {2}", 
-                  originalDate, 
-                  localDate, 
-                  localDate.Kind.ToString());
-// Convert time originating in a different time zone 
-// so local time zone's adjustment rules are applied
-originalDate = new DateTimeOffset(2007, 11, 4, 4, 0, 0, 
-                                  new TimeSpan(-5, 0, 0));
-localDate = originalDate.LocalDateTime;
-Console.WriteLine("{0} converted to {1} {2}", 
-                  originalDate, 
-                  localDate, 
-                  localDate.Kind.ToString());
-// The example displays the following output to the console:
-//       6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 5:00:00 AM Local
-//       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local
-```
-
-```vb
-Dim originalDate As DateTimeOffset
-Dim localDate As Date
-
-' Convert time originating in a different time zone
-originalDate = New DateTimeOffset(#06/19/2008 7:00AM#, _
-                                  New TimeSpan(-5, 0, 0))
-localDate = originalDate.LocalDateTime
-Console.WriteLine("{0} converted to {1} {2}", _
-                  originalDate, _
-                  localDate, _
-                  localDate.Kind.ToString())
-' Convert time originating in a different time zone 
-' so local time zone's adjustment rules are applied
-originalDate = New DateTimeOffset(#11/04/2007 4:00AM#, _
-                                  New TimeSpan(-5, 0, 0))
-localDate = originalDate.LocalDateTime
-Console.WriteLine("{0} converted to {1} {2}", _
-                  originalDate, _
-                  localDate, _
-                  localDate.Kind.ToString())
-' The example displays the following output to the console:
-'       6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 5:00:00 AM Local
-'       11/4/2007 4:00:00 AM -05:00 converted to 11/4/2007 1:00:00 AM Local
-```
-
-## <a name="a-general-purpose-conversion-method"></a>汎用変換メソッド
-
-次の例では、[DateTimeOffset](xref:System.DateTimeOffset) 値を [DateTime](xref:System.DateTime) 値に変換する `ConvertFromDateTimeOffset` という名前のメソッドを定義します。 オフセットに基づき、[DateTimeOffset](xref:System.DateTimeOffset) 値が UTC 時刻、現地時刻、またはその他の時刻であるかどうかを判断し、その結果に応じて、返される日時値の [Kind](xref:System.DateTime.Kind) プロパティを定義します。 
-
-```csharp
-static DateTime ConvertFromDateTimeOffset(DateTimeOffset dateTime)
-{
-   if (dateTime.Offset.Equals(TimeSpan.Zero))
-      return dateTime.UtcDateTime;
-   else if (dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime)))
-      return DateTime.SpecifyKind(dateTime.DateTime, DateTimeKind.Local);
-   else
-      return dateTime.DateTime;   
-}
-```
-
-```vb
-Function ConvertFromDateTimeOffset(dateTime As DateTimeOffset) As Date
-   If dateTime.Offset.Equals(TimeSpan.Zero) Then
-      Return dateTime.UtcDateTime
-   ElseIf dateTime.Offset.Equals(TimeZoneInfo.Local.GetUtcOffset(dateTime.DateTime))
-      Return Date.SpecifyKind(dateTime.DateTime, DateTimeKind.Local)
-   Else
-      Return dateTime.DateTime   
-   End If
-```
-
-次の例では、`ConvertFromDateTimeOffset` メソッドを呼び出して、UTC 時刻、現地時刻、および米国の中部標準時ゾーンの時刻を表す [DateTimeOffset](xref:System.DateTimeOffset) 値を変換します。
-
-```csharp
-DateTime timeComponent = new DateTime(2008, 6, 19, 7, 0, 0);
-DateTime returnedDate; 
-
-// Convert UTC time
-DateTimeOffset utcTime = new DateTimeOffset(timeComponent, TimeSpan.Zero);
-returnedDate = ConvertFromDateTimeOffset(utcTime); 
-Console.WriteLine("{0} converted to {1} {2}", 
-                  utcTime, 
-                  returnedDate, 
-                  returnedDate.Kind.ToString());
-
-// Convert local time
-DateTimeOffset localTime = new DateTimeOffset(timeComponent, 
-                           TimeZoneInfo.Local.GetUtcOffset(timeComponent)); 
-returnedDate = ConvertFromDateTimeOffset(localTime);                                          
-Console.WriteLine("{0} converted to {1} {2}", 
-                  localTime, 
-                  returnedDate, 
-                  returnedDate.Kind.ToString());
-
-// Convert Central Standard Time
-DateTimeOffset cstTime = new DateTimeOffset(timeComponent, 
-               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent));
-returnedDate = ConvertFromDateTimeOffset(cstTime);
-Console.WriteLine("{0} converted to {1} {2}", 
-                  cstTime, 
-                  returnedDate, 
-                  returnedDate.Kind.ToString());
-// The example displays the following output to the console:
-//    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
-//    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
-//    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified
-```
-
-```vb
-Dim timeComponent As Date = #06/19/2008 7:00AM#
-Dim returnedDate As Date 
-
-' Convert UTC time
-Dim utcTime As New DateTimeOffset(timeComponent, TimeSpan.Zero)
-returnedDate = ConvertFromDateTimeOffset(utcTime) 
-Console.WriteLine("{0} converted to {1} {2}", _
-                  utcTime, _
-                  returnedDate, _
-                  returnedDate.Kind.ToString())
-
-' Convert local time
-Dim localTime As New DateTimeOffset(timeComponent, _
-                                    TimeZoneInfo.Local.GetUtcOffset(timeComponent)) 
-returnedDate = ConvertFromDateTimeOffset(localTime)                                                                  
-Console.WriteLine("{0} converted to {1} {2}", _
-                  localTime, _
-                  returnedDate, _
-                  returnedDate.Kind.ToString())
-
-' Convert Central Standard Time
-Dim cstTime As New DateTimeOffset(timeComponent, _
-               TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time").GetUtcOffset(timeComponent))
-returnedDate = ConvertFromDateTimeOffset(cstTime)                                                                  
-Console.WriteLine("{0} converted to {1} {2}", _
-                  cstTime, _
-                  returnedDate, _
-                  returnedDate.Kind.ToString())
-' The example displays the following output to the console:
-'    6/19/2008 7:00:00 AM +00:00 converted to 6/19/2008 7:00:00 AM Utc
-'    6/19/2008 7:00:00 AM -07:00 converted to 6/19/2008 7:00:00 AM Local
-'    6/19/2008 7:00:00 AM -05:00 converted to 6/19/2008 7:00:00 AM Unspecified
-```
-
-このコードは次の&2; つのことを前提としますが、アプリケーションおよびその日時値のソースによっては常に有効とは限らないことに注意してください。
-
-* オフセットが [TimeSpan.Zero](xref:System.TimeSpan.Zero) である日時値が UTC を表すことを前提とします。 実際には、UTC は特定のタイム ゾーンの時刻ではなく、世界のタイム ゾーンの時刻を標準化する際に基準となる時刻です。 タイム ゾーンのオフセットが [Zero](xref:System.TimeSpan.Zero) である場合もあります。
-
-* オフセットがローカル タイム ゾーンのオフセットと等しい日時が、ローカル タイム ゾーンを表すことを前提とします。 日時値は元のタイム ゾーンとの関連付けが解除されているので、これは該当しない場合があります。日時は、同じオフセットを持つ別のタイム ゾーンに由来する可能性があります。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-
-
-
-
+>  変換後の <xref:System.DateTime> 値が特定の時刻を明確に示すことが必要なアプリケーションでは、<xref:System.DateTimeOffset.UtcDateTime%2A?displayProperty=fullName> プロパティを使用してすべての <xref:System.DateTimeOffset> を <xref:System.DateTime> に変換する処理を行うことを検討してください。  
+  
+ 次のコード例は、<xref:System.DateTimeOffset.UtcDateTime%2A> プロパティを使用して、<xref:System.DateTimeOffset> 値 \(オフセットは <xref:System.TimeSpan.Zero?displayProperty=fullName>\) を <xref:System.DateTime> 値に変換します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#6)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#6)]  
+  
+ 次のコード例は、<xref:System.DateTimeOffset.UtcDateTime%2A> プロパティを使用して、<xref:System.DateTimeOffset> 値に対してタイム ゾーン変換と型変換の両方を実行します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#12](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#12)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#12)]  
+  
+### 現地時刻の変換  
+ <xref:System.DateTimeOffset> 値が現地時刻を表していることを確認するには、<xref:System.DateTimeOffset.DateTime%2A?displayProperty=fullName> プロパティによって返される <xref:System.DateTime> 値を `static` \(Visual Basic では `Shared`\) <xref:System.DateTime.SpecifyKind%2A> メソッドに渡します。  このメソッドは、最初のパラメーターとして渡された日付と時刻を返しますが、<xref:System.DateTime.Kind%2A> プロパティは 2 番目のパラメーターで指定された値に設定されています。  次のコード例は、<xref:System.DateTime.SpecifyKind%2A> メソッドを使用して、<xref:System.DateTimeOffset> 値の変換を行います。この値のオフセットはローカル タイム ゾーンのオフセットに対応します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#7)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#7)]  
+  
+ <xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティを使用して、<xref:System.DateTimeOffset> 値をローカルな <xref:System.DateTime> 値に変換することもできます。  返される <xref:System.DateTime> 値の <xref:System.DateTime.Kind%2A> プロパティには、<xref:System.DateTimeKind> が設定されています。  次のコード例は、<xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティを使用して、<xref:System.DateTimeOffset> 値の変換を行います。この値のオフセットはローカル タイム ゾーンのオフセットに対応します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#10](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#10)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#10)]  
+  
+ <xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティを使用して <xref:System.DateTime> 値を取得すると、プロパティの `get` アクセサーは、まず <xref:System.DateTimeOffset> 値を UTC に変換し、次に <xref:System.DateTimeOffset.ToLocalTime%2A> メソッドを呼び出して現地時刻に変換します。  これは、<xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティの値を取得して、型変換の実行と同時にタイム ゾーンの変換も実行できることを意味します。  また、変換実行時にはローカル タイム ゾーンの調整規則が適用されることにもなります。  次のコード例は、<xref:System.DateTimeOffset.LocalDateTime%2A?displayProperty=fullName> プロパティを使用して、型変換とタイム ゾーン変換の両方を実行します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#11](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#11)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#11)]  
+  
+### 汎用変換メソッド  
+ 次の例では、`ConvertFromDateTimeOffset` というメソッドを定義します。このメソッドは、<xref:System.DateTimeOffset> 値を <xref:System.DateTime> 値に変換します。  そのオフセットに基づいて、<xref:System.DateTimeOffset> 値が UTC 時刻、現地時刻、その他の時刻のいずれであるかを判断し、それに応じて、返される日付と時刻の値の <xref:System.DateTime.Kind%2A> プロパティを定義します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#8](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#8)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#8)]  
+  
+ 次の例では、米国の中部標準時ゾーンの UTC 時刻、現地時間と時刻を表す <xref:System.DateTimeOffset> 値を変換するに `ConvertFromDateTimeOffset` のメソッドを呼び出します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Conversions#9](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/cs/Conversions.cs#9)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Conversions#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Conversions/vb/Conversions.vb#9)]  
+  
+ このコードでは、アプリケーションおよび日付と時刻の値のソースに応じて、必ずしも常に有効ではない 2 つの前提条件が想定されます。  
+  
+-   オフセットが <xref:System.TimeSpan.Zero?displayProperty=fullName> に設定されている日付と時刻の値は、UTC 時刻を表すことを前提とします。  実際には、UTC は特定のタイム ゾーンの時刻ではありませんが、この時刻を基準として世界のタイム ゾーンの時刻が標準化されます。  タイム ゾーンには、<xref:System.TimeSpan.Zero> のオフセットを設定することもできます。  
+  
+-   ローカル タイム ゾーンのオフセットに等しいオフセットが設定された日付と時刻は、ローカル タイム ゾーンを表すことを前提とします。  日付と時刻の値と元のタイム ゾーンとの関連付けが解除されていることが理由となって、この前提条件に該当しないことがあります。日付と時刻には、同じオフセットが設定された他のタイム ゾーンの日付と時刻を設定できます。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/converting-between-time-zones.md b/docs/standard/datetime/converting-between-time-zones.md
index 743fef09b81..23472297cd4 100644
--- a/docs/standard/datetime/converting-between-time-zones.md
+++ b/docs/standard/datetime/converting-between-time-zones.md
@@ -1,385 +1,123 @@
 ---
-title: "タイム ゾーン間での時刻の変換"
-description: "タイム ゾーン間での時刻の変換"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-manager: wpickett
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net-core
-ms.technology: .net-core-technologies
-ms.devlang: dotnet
-ms.assetid: bf8f74e6-e7f2-4c2a-a04c-57db0e28dd36
-translationtype: Human Translation
-ms.sourcegitcommit: b20713600d7c3ddc31be5885733a1e8910ede8c6
-ms.openlocfilehash: c2baa48c3b79dfbc5d39652cc57fe015a2313d6e
-
----
-
-# <a name="converting-times-between-time-zones"></a>タイム ゾーン間での時刻の変換
-
-日時を使用するすべてのアプリケーションで、タイム ゾーン間の違いを処理することの重要性が高まっています。 アプリケーションでは、すべての時刻を現地時刻で表現できることを前提とはしていません。現地時刻は、[System.DateTime](xref:System.DateTime) 構造体から取得できる時刻です。 たとえば、米国東部の現在の時刻を表示する Web ページには、東アジアの顧客に対する信頼性を欠いています。 このトピックでは、時刻をあるタイム ゾーンから別のタイム ゾーンに変換する方法、およびタイム ゾーン対応に制限のある [System.DateTimeOffset](xref:System.DateTimeOffset) 値を変換する方法について説明します。
-
-## <a name="converting-to-coordinated-universal-time"></a>世界協定時刻への変換
-
-世界協定時刻 (UTC) は、高精度の原子時標準です。 世界のタイム ゾーンは、UTC からの正または負のオフセットとして表現されます。 したがって、UTC はタイム ゾーンの影響を受けない、またはタイム ゾーンに依存しない種類の時刻を提供します。 コンピューター間の日時の移植性が重要となる場合には、UTC 時刻の使用が推奨されます。 個別のタイム ゾーンを UTC に変換すると、時間の比較が容易になります。
-
+title: "タイム ゾーン間での時刻の変換 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "変換 (時間を)"
+  - "ローカル タイムの変換"
+  - "タイム ゾーン [.NET Framework], 変換"
+  - "時刻 [.NET Framework], 変換"
+  - "UTC 時刻, 変換"
+ms.assetid: a51e1a3b-c983-4320-b31a-1f9fa3cf824a
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# タイム ゾーン間での時刻の変換
+タイム ゾーン間での日時の違いを処理するアプリケーションの重要性が増しています。  アプリケーションは、<xref:System.DateTime> 構造体にある現地時刻ですべての時刻を表現するだけで良いとは想定できなくなりました。  たとえば、米国東部の現在時刻を表示する Web ページは、東アジアの顧客にとっては妥当なものではありません。  このトピックでは、あるタイム ゾーンから別のタイム ゾーンに時刻を変換する方法、およびタイム ゾーンの取り扱いが不適切な <xref:System.DateTimeOffset> 値を変換する方法について説明します。  
+  
+## 世界協定時刻への変換  
+ 世界協定時刻 \(UTC\) は、高精度で、原子時計に基づく時刻基準です。  世界のタイム ゾーンは、UTC からの正または負のオフセットとして表されます。  したがって、UTC は、タイム ゾーンの影響を受けない時刻、またはどのタイム ゾーンからも中立の時刻を提供します。  コンピューター間での日時の統一性が重要な場合は、UTC 時刻を使用することをお勧めします。\(日付と時刻を使用して詳細および他のベスト プラクティスについては、"参照して [.NET Framework の DateTime を使用してコーディング Best Practices](http://go.microsoft.com/fwlink/?LinkId=92342)ください。個別のタイム ゾーンを UTC に変換すると、時刻の比較が容易になります。  
+  
 > [!NOTE]
-> また、ある時点を明確に表すように [DateTimeOffset](xref:System.DateTimeOffset) 構造体をシリアル化することもできます。 [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトは日時値を UTC からのオフセットと共に格納するので、特定の時点を常に UTC と関連付けて表します。
-
-時刻を UTC に変換する最も簡単な方法としては、`static` (Visual Basic では `Shared`) [TimeZoneInfo.ConvertTimeToUtc(DateTime)](https://msdn.microsoft.com/en-us/library/bb381744(v=vs.110).aspx) メソッドを呼び出します。 
-
-> [!IMPORTANT]
-> `TimeZoneInfo.ConvertTimeToUtc(DateTime)` メソッドは現在 .NET Core で使用できません。 
-
-次の表に示すように、このメソッドによって実行される実際の変換は、`DateTime` パラメーターの [Kind](xref:System.DateTime.Kind) プロパティの値によって異なります。
-
-[DateTime.Kind](xref:System.DateTimeKind) プロパティ | 変換
----------------------------------------------------------------------------------------------- | ----------
-[DateTimeKind.Local](xref:System.DateTimeKind.Local) | 現地時刻を UTC に変換します。
-[DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) | `DateTime` パラメーターが現地時刻であることを前提とし、現地時刻を UTC に変換します。
-[DateTimeKind.Utc](xref:System.DateTimeKind.Utc) | `DateTime` パラメーターを変更せずに返します。
-
-次のコードは、現在の現地時刻を UTC に変換し、コンソールに結果を表示します。
-
-```csharp
-DateTime dateNow = DateTime.Now;
-Console.WriteLine("The date and time are {0} UTC.", 
-                   TimeZoneInfo.ConvertTimeToUtc(dateNow));
-```
-
-```vb
-Dim dateNow As Date = Date.Now      
-Console.WriteLine("The date and time are {0} UTC.", _
-                  TimeZoneInfo.ConvertTimeToUtc(dateNow))
-```
-
+>  <xref:System.DateTimeOffset> 構造体をシリアル化して、ある時刻を明確に表すこともできます。  <xref:System.DateTimeOffset> オブジェクトは UTC からのオフセットで日時の値を格納するので、常に UTC に対する相対値で特定の時刻を表します。  
+  
+ 時刻を UTC に変換する最も簡単な方法は、`static` \(Visual Basic では `Shared`\) の <xref:System.TimeZoneInfo.ConvertTimeToUtc%28System.DateTime%29?displayProperty=fullName> メソッドを呼び出す方法です。  メソッドで実行される具体的な変換は、次の表に示すように、`dateTime` パラメーターの <xref:System.DateTime.Kind%2A> プロパティの値によって決まります。  
+  
+|DateTime.Kind プロパティ|変換|  
+|-------------------------|--------|  
+|<xref:System.DateTimeKind?displayProperty=fullName>|現地時刻を UTC に変換します。|  
+|<xref:System.DateTimeKind?displayProperty=fullName>|`dateTime` パラメーターが現地時刻だと想定し、現地時刻を UTC に変換します。|  
+|<xref:System.DateTimeKind?displayProperty=fullName>|`dateTime` パラメーターを変更しないで返します。|  
+  
+ 次に示すコードは、現在の現地時刻を UTC に変換し、結果をコンソールに表示します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#6)]
+ [!code-vb[System.TimeZone2.Concepts#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#6)]  
+  
 > [!NOTE]
->[TimeZoneInfo.ConvertTimeToUtc(DateTime)](https://msdn.microsoft.com/en-us/library/bb381744(v=vs.110).aspx) メソッドは、[TimeZone.ToUniversalTime](https://msdn.microsoft.com/en-us/library/System.TimeZone.ToUniversalTime(v=vs.110).aspx) メソッドおよび [DateTime.ToUniversalTime](xref:System.DateTime.ToUniversalTime) メソッドと同じ結果を必ずしも生成するとは限りません。 ホスト システムのローカル タイム ゾーンに複数の調整規則が含まれる場合、[TimeZoneInfo.ConvertTimeToUtc(DateTime)](https://msdn.microsoft.com/en-us/library/System.TimeZone.ConvertTimeToUtc(v=vs.110).aspx) は特定の日時に適切な規則を適用します。 他の 2 つのメソッドは、常に最新の調整規則を適用します。
-
-日時値が現地時刻と UTC のどちらかを表さない場合、[ToUniversalTime](https://msdn.microsoft.com/en-us/library/System.TimeZone.ToUniversalTime(v=vs.110).aspx) メソッドは不正な結果を返す可能性があります。 ただし、[TimeZoneInfo.ConvertTimeToUtc](https://msdn.microsoft.com/en-us/library/bb381744(v=vs.110).aspx) メソッドを使用して、指定したタイム ゾーンから日時を変換できます (変換先のタイム ゾーンを表す TimeZoneInfo オブジェクトを取得する方法の詳細については、「[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)」を参照してください)。 次のコードは、[TimeZoneInfo.ConvertTimeToUtc](https://msdn.microsoft.com/en-us/library/bb381744(v=vs.110).aspx) メソッドを使用して東部標準時を UTC に変換します。
-
-```csharp
-DateTime easternTime = new DateTime(2007, 01, 02, 12, 16, 00);
-string easternZoneId = "Eastern Standard Time";
-try
-{
-   TimeZoneInfo easternZone = TimeZoneInfo.FindSystemTimeZoneById(easternZoneId);
-   Console.WriteLine("The date and time are {0} UTC.", 
-                     TimeZoneInfo.ConvertTimeToUtc(easternTime, easternZone));
-}
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("Unable to find the {0} zone in the registry.", 
-                     easternZoneId);
-}                           
-catch (InvalidTimeZoneException)
-{
-   Console.WriteLine("Registry data on the {0} zone has been corrupted.", 
-                     easternZoneId);
-}
-```
-
-```vb
-Dim easternTime As New Date(2007, 01, 02, 12, 16, 00)
-Dim easternZoneId As String = "Eastern Standard Time"
-Try
-   Dim easternZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(easternZoneId)
-   Console.WriteLine("The date and time are {0} UTC.", _ 
-                     TimeZoneInfo.ConvertTimeToUtc(easternTime, easternZone))
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("Unable to find the {0} zone in the registry.", _
-                     easternZoneId)
-Catch e As InvalidTimeZoneException
-   Console.WriteLine("Registry data on the {0} zone has been corrupted.", _ 
-                     easternZoneId)
-End Try    
-```
-
-[DateTime](xref:System.DateTime) オブジェクトの [Kind](xref:System.DateTimeKind) プロパティとタイム ゾーンが一致しない場合、このメソッドは [ArgumentException](xref:System.ArgumentException) をスローします。 Kind プロパティが [DateTimeKind.Local](xref:System.DateTimeKind.Local) であるが [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトがローカル タイム ゾーンを表さない場合、または Kind プロパティが [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) であるが [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトが [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) と等しくない場合に、不一致が発生します。
-
-これらすべてのメソッドは、パラメーターとして [DateTime](xref:System.DateTime) 値を受け取り、[DateTime](xref:System.DateTime) 値を返します。 [DateTimeOffset](xref:System.DateTimeOffset) 値について、[DateTimeOffset](xref:System.DateTimeOffset) 構造体には、現在のインスタンスの日時を UTC に変換する [ToUniversalTime](xref:System.DateTimeOffset.ToUniversalTime) インスタンス メソッドが含まれます。 次の例では、[ToUniversalTime](xref:System.DateTimeOffset.ToUniversalTime) メソッドを呼び出して、現地時刻およびその他のいくつかの時刻を世界協定時刻 (UTC) に変換します。
-
-```csharp
-DateTimeOffset localTime, otherTime, universalTime;
-
-// Define local time in local time zone
-localTime = new DateTimeOffset(new DateTime(2007, 6, 15, 12, 0, 0));
-Console.WriteLine("Local time: {0}", localTime);
-Console.WriteLine();
-
-// Convert local time to offset 0 and assign to otherTime
-otherTime = localTime.ToOffset(TimeSpan.Zero);
-Console.WriteLine("Other time: {0}", otherTime);
-Console.WriteLine("{0} = {1}: {2}", 
-                  localTime, otherTime, 
-                  localTime.Equals(otherTime));
-Console.WriteLine("{0} exactly equals {1}: {2}", 
-                  localTime, otherTime, 
-                  localTime.EqualsExact(otherTime));
-Console.WriteLine();
-
-// Convert other time to UTC
-universalTime = localTime.ToUniversalTime(); 
-Console.WriteLine("Universal time: {0}", universalTime);
-Console.WriteLine("{0} = {1}: {2}", 
-                  otherTime, universalTime, 
-                  universalTime.Equals(otherTime));
-Console.WriteLine("{0} exactly equals {1}: {2}", 
-                  otherTime, universalTime, 
-                  universalTime.EqualsExact(otherTime));
-Console.WriteLine();
-// The example produces the following output to the console:
-//    Local time: 6/15/2007 12:00:00 PM -07:00
-//    
-//    Other time: 6/15/2007 7:00:00 PM +00:00
-//    6/15/2007 12:00:00 PM -07:00 = 6/15/2007 7:00:00 PM +00:00: True
-//    6/15/2007 12:00:00 PM -07:00 exactly equals 6/15/2007 7:00:00 PM +00:00: False
-//    
-//    Universal time: 6/15/2007 7:00:00 PM +00:00
-//    6/15/2007 7:00:00 PM +00:00 = 6/15/2007 7:00:00 PM +00:00: True
-//    6/15/2007 7:00:00 PM +00:00 exactly equals 6/15/2007 7:00:00 PM +00:00: True 
-```
-
-```vb
-Dim localTime, otherTime, universalTime As DateTimeOffset
-
-' Define local time in local time zone
-localTime = New DateTimeOffset(#6/15/2007 12:00:00PM#)
-Console.WriteLine("Local time: {0}", localTime)
-Console.WriteLine()
-
-' Convert local time to offset 0 and assign to otherTime
-otherTime = localTime.ToOffset(TimeSpan.Zero)
-Console.WriteLine("Other time: {0}", otherTime)
-Console.WriteLine("{0} = {1}: {2}", _
-                  localTime, otherTime, _
-                  localTime.Equals(otherTime))
-Console.WriteLine("{0} exactly equals {1}: {2}", _ 
-                  localTime, otherTime, _
-                  localTime.EqualsExact(otherTime))
-Console.WriteLine()
-
-' Convert other time to UTC
-universalTime = localTime.ToUniversalTime() 
-Console.WriteLine("Universal time: {0}", universalTime)
-Console.WriteLine("{0} = {1}: {2}", _
-                  otherTime, universalTime, _ 
-                  universalTime.Equals(otherTime))
-Console.WriteLine("{0} exactly equals {1}: {2}", _ 
-                  otherTime, universalTime, _
-                  universalTime.EqualsExact(otherTime))
-Console.WriteLine()
-' The example produces the following output to the console:
-'    Local time: 6/15/2007 12:00:00 PM -07:00
-'    
-'    Other time: 6/15/2007 7:00:00 PM +00:00
-'    6/15/2007 12:00:00 PM -07:00 = 6/15/2007 7:00:00 PM +00:00: True
-'    6/15/2007 12:00:00 PM -07:00 exactly equals 6/15/2007 7:00:00 PM +00:00: False
-'    
-'    Universal time: 6/15/2007 7:00:00 PM +00:00
-'    6/15/2007 7:00:00 PM +00:00 = 6/15/2007 7:00:00 PM +00:00: True
-'    6/15/2007 7:00:00 PM +00:00 exactly equals 6/15/2007 7:00:00 PM +00:00: True 
-```
-
-## <a name="converting-utc-to-a-designated-time-zone"></a>UTC から指定したタイム ゾーンへの変換
-
-UTC を現地時刻に変換するには、後の「[UTC から現地時刻への変換](#converting-utc-to-local-time)」セクションを参照してください。 
-
-UTC を、指定した任意のタイム ゾーンの時刻に変換するには、[ConvertTimeFromUtc](https://msdn.microsoft.com/en-us/library/System.TimeZoneInfo.converttimefromutc(v=vs.110).aspx) メソッドを呼び出します。 
-
-> [!IMPORTANT]
-> .NET Core では、`TimeZoneInfo.ConvertTimeFromUtc' メソッドは現在使用できません。 
-
-このメソッドは、次の 2 つのパラメーターを受け取ります。
-
-* 変換対象の UTC。 これは、[Kind](xref:System.DateTime.Kind) にプロパティが [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) または [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) に設定されている [DateTime](xref:System.DateTime) 値でなければなりません。 
-
-* UTC の変換先のタイム ゾーン。 
-
-次のコードは、UTC を中部標準時に変換します。
-
-```csharp
-DateTime timeUtc = DateTime.UtcNow;
-try
-{
-   TimeZoneInfo cstZone = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time");
-   DateTime cstTime = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone);
-   Console.WriteLine("The date and time are {0} {1}.", 
-                     cstTime, 
-                     cstZone.IsDaylightSavingTime(cstTime) ?
-                             cstZone.DaylightName : cstZone.StandardName);
-}
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("The registry does not define the Central Standard Time zone.");
-}                           
-catch (InvalidTimeZoneException)
-{
-   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.");
-}
-```
-
-```vb
-Dim timeUtc As Date = Date.UtcNow
-Try
-   Dim cstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Central Standard Time")
-   Dim cstTime As Date = TimeZoneInfo.ConvertTimeFromUtc(timeUtc, cstZone)
-   Console.WriteLine("The date and time are {0} {1}.", _
-                     cstTime, _
-                     IIf(cstZone.IsDaylightSavingTime(cstTime), _
-                         cstZone.DaylightName, cstZone.StandardName))
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("The registry does not define the Central Standard Time zone.")
-Catch e As InvalidTimeZoneException
-   Console.WriteLine("Registry data on the Central Standard Time zone has been corrupted.")
-End Try
-``` 
-
-## <a name="converting-utc-to-local-time"></a>UTC から現地時刻への変換
-
-UTC を現地時刻に変換するには、時刻を変換する対象の [DateTime](xref:System.DateTime) オブジェクトの [DateTime.ToLocalTime](xref:System.DateTime) メソッドを呼び出します。 次の表に示すように、このメソッドの実際の動作は、オブジェクトの [Kind](xref:System.DateTime.Kind) プロパティの値によって異なります。
-
-[DateTime.Kind](xref:System.DateTimeKind) プロパティ | 変換
----------------------------------------------------------------------------------------------- | ----------
-[DateTimeKind.Local](xref:System.DateTimeKind.Local) | [DateTime](xref:System.DateTime) 値を変更せずに返します。
-[DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) | [DateTime](xref:System.DateTime) 値が UTC であることを前提とし、UTC を現地時刻に変換します。
-[DateTimeKind.Utc](xref:System.DateTimeKind.Utc) | [DateTime](xref:System.DateTime) 値を現地時刻に変換します。
-
-## <a name="converting-between-any-two-time-zones"></a>任意の 2 つのタイム ゾーン間での変換
-
-静的な [TimeZoneInfo.ConvertTime](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo)) メソッドを使用すると、任意の 2 つのタイム ゾーン間で変換を行うことができます。 このメソッドのパラメーターは、変換対象の [DateTime](xref:System.DateTime) 値、日時値のタイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクト、および日時値の変換先のタイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトです。
-
-このメソッドでは、変換対象の日時値の [Kind](xref:System.DateTime.Kind) プロパティと、タイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトまたはタイム ゾーン識別子とが、相互に対応する必要があります。 それ以外の場合は、[ArgumentException](xref:System.ArgumentException) がスローされます。 たとえば、日時値の [Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Local](xref:System.DateTimeKind.Local) である場合に、このメソッドにパラメーターとして渡された [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトが [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) と等しくなければ、例外がスローされます。 また、このメソッドにパラメーターとして渡された識別子が [TimeZoneInfo.Id](xref:System.TimeZoneInfo.Id) と等しくない場合にも、例外がスローされます。
-
-次の例では、[ConvertTime](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo)) メソッドを使用してハワイ標準時を現地時刻に変換します。
-
-```csharp
-DateTime hwTime = new DateTime(2007, 02, 01, 08, 00, 00);
-try
-{
-   TimeZoneInfo hwZone = TimeZoneInfo.FindSystemTimeZoneById("Hawaiian Standard Time");
-   Console.WriteLine("{0} {1} is {2} local time.", 
-           hwTime, 
-           hwZone.IsDaylightSavingTime(hwTime) ? hwZone.DaylightName : hwZone.StandardName, 
-           TimeZoneInfo.ConvertTime(hwTime, hwZone, TimeZoneInfo.Local));
-}
-catch (TimeZoneNotFoundException)
-{
-   Console.WriteLine("The registry does not define the Hawaiian Standard Time zone.");
-}                           
-catch (InvalidTimeZoneException)
-{
-   Console.WriteLine("Registry data on the Hawaiian STandard Time zone has been corrupted.");
-}
-```
-
-```vb
-Dim hwTime As Date = #2/01/2007 8:00:00 AM#
-Try
-   Dim hwZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Hawaiian Standard Time")
-   Console.WriteLine("{0} {1} is {2} local time.", _
-                     hwTime, _
-                     IIf(hwZone.IsDaylightSavingTime(hwTime), hwZone.DaylightName, hwZone.StandardName), _
-                     TimeZoneInfo.ConvertTime(hwTime, hwZone, TimeZoneInfo.Local))
-Catch e As TimeZoneNotFoundException
-   Console.WriteLine("The registry does not define the Hawaiian Standard Time zone.")
-Catch e As InvalidTimeZoneException
-   Console.WriteLine("Registry data on the Hawaiian Standard Time zone has been corrupted.")
-End Try
-```
-
-## <a name="converting-datetimeoffset-values"></a>DateTimeOffset 値の変換
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) オブジェクトによって表される日時値は、完全にはタイム ゾーン対応ではありません。これは、オブジェクトがインスタンス化された時点でそのタイム ゾーンとの関連付けが解除されるためです。 ただし、アプリケーションでは多くの場合、特定のタイム ゾーンの時刻ではなく、単に UTC からの 2 つの異なるオフセットに基づいて日時を変換する必要があります。 この変換を実行するには、現在のインスタンスの [ToOffset](xref:System.DateTimeOffset.ToOffset(System.TimeSpan)) メソッドを呼び出します。 このメソッドの単一のパラメーターは、メソッドが返す新しい日時値のオフセットを表す [TimeSpan](xref:System.TimeSpan) です。  
-
-たとえば、Web ページに対するユーザー要求の日時が既知であり、MM/dd/yyyy hh:mm:ss zzzz の形式で文字列としてシリアル化される場合、次の `ReturnTimeOnServer` メソッドは、この日時値を Web サーバー上の日時に変換します。
-
-```csharp
-public DateTimeOffset ReturnTimeOnServer(string clientString)
-{
-   string format = @"M/d/yyyy H:m:s zzz";
-   TimeSpan serverOffset = TimeZoneInfo.Local.GetUtcOffset(DateTimeOffset.Now);
-
-   try
-   {      
-      DateTimeOffset clientTime = DateTimeOffset.ParseExact(clientString, format, CultureInfo.InvariantCulture);
-      DateTimeOffset serverTime = clientTime.ToOffset(serverOffset);
-      return serverTime;
-   }
-   catch (FormatException)
-   {
-      return DateTimeOffset.MinValue;
-   }
-}
-```
-
-```vb
-Public Function ReturnTimeOnServer(clientString As String) As DateTimeOffset
-   Dim format As String = "M/d/yyyy H:m:s zzz"
-   Dim serverOffset As TimeSpan = TimeZoneInfo.Local.GetUtcOffset(DateTimeOffset.Now)
-
-   Try      
-      Dim clientTime As DateTimeOffset = DateTimeOffset.ParseExact(clientString, format, CultureInfo.InvariantCulture)
-      Dim serverTime As DateTimeOffset = clientTime.ToOffset(serverOffset)
-      Return serverTime
-   Catch e As FormatException
-      Return DateTimeOffset.MinValue
-   End Try    
-End Function
-```
-
-このメソッドが、UTC よりも 5 時間遅いタイム ゾーンの日時を表す文字列 "9/1/2007 5:32:07 -05:00" を渡された場合、米国の太平洋標準時ゾーンにあるサーバー用に 9/1/2007 3:32:07 AM -07:00 を返します。
-
-[TimeZoneInfo](xref:System.TimeZoneInfo) クラスには、[System.DateTimeOffset](xref:System.DateTimeOffset) 値によるタイム ゾーン変換を実行する、オーバーロードされた [TimeZoneInfo.ConvertTime (DateTimeOffset、TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)) メソッドも含まれます。 このメソッドのパラメーターは、[System.DateTimeOffset](xref:System.DateTimeOffset) 値と、時刻の変換先となるタイム ゾーンへの参照です。 このメソッド呼び出しは、[System.DateTimeOffset](xref:System.DateTimeOffset) 値を返します。 たとえば、前の例の `ReturnTimeOnServer` メソッドを次のように書き換えて、[ConvertTime(DateTimeOffset, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo)) メソッドを呼び出すことができます。
-
-```csharp
-public DateTimeOffset ReturnTimeOnServer(string clientString)
-{
-   string format = @"M/d/yyyy H:m:s zzz";
-
-   try
-   {      
-      DateTimeOffset clientTime = DateTimeOffset.ParseExact(clientString, format, 
-                                  CultureInfo.InvariantCulture);
-      DateTimeOffset serverTime = TimeZoneInfo.ConvertTime(clientTime, 
-                                  TimeZoneInfo.Local);
-      return serverTime;
-   }
-   catch (FormatException)
-   {
-      return DateTimeOffset.MinValue;
-   }
-}
-```
-
-```vb
-Public Function ReturnTimeOnServer(clientString As String) As DateTimeOffset
-   Dim format As String = "M/d/yyyy H:m:s zzz"
-
-   Try      
-      Dim clientTime As DateTimeOffset = DateTimeOffset.ParseExact(clientString, format, CultureInfo.InvariantCulture)
-      Dim serverTime As DateTimeOffset = TimeZoneInfo.ConvertTime(clientTime, TimeZoneInfo.Local)
-      Return serverTime
-   Catch e As FormatException
-      Return DateTimeOffset.MinValue
-   End Try    
-End Function
-```
-
-## <a name="see-also"></a>関連項目
-
-[TimeZoneInfo](xref:System.TimeZoneInfo)
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)
-
-
-
-
-
-<!--HONumber=Nov16_HO3-->
-
-
+>  <xref:System.TimeZoneInfo.ConvertTimeToUtc%28System.DateTime%29?displayProperty=fullName> メソッドでは、<xref:System.TimeZone.ToUniversalTime%2A?displayProperty=fullName> メソッドおよび <xref:System.DateTime.ToUniversalTime%2A?displayProperty=fullName> メソッドと同一の結果が生成されるとは限りません。  ホスト システムのローカル タイム ゾーンに複数の調整規則が含まれる場合、<xref:System.TimeZoneInfo.ConvertTimeToUtc%28System.DateTime%29?displayProperty=fullName> は、適切な規則を特定の日付および時刻に適用します。  他の 2 つのメソッドは、最新の調整規則を常に適用します。  
+  
+ 日時値が現地時刻または UTC のどちらも表していない場合、<xref:System.DateTime.ToUniversalTime%2A> メソッドは正しくない結果を返す可能性があります。  ただし、<xref:System.TimeZoneInfo.ConvertTimeToUtc%2A?displayProperty=fullName> メソッドを使用すると、指定したターム ゾーンから日時を変換できます。目的のタイム ゾーンを表す <xref:System.TimeZoneInfo> オブジェクトを取得する方法の詳細については、「[ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md)」を参照してください。次に示すコードでは、<xref:System.TimeZoneInfo.ConvertTimeToUtc%2A?displayProperty=fullName> メソッドを使用して、米国東部標準時を UTC に変換しています。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#7)]
+ [!code-vb[System.TimeZone2.Concepts#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#7)]  
+  
+ <xref:System.DateTime> オブジェクトの <xref:System.DateTime.Kind%2A> プロパティとタイム ゾーンが一致してない場合、このメソッドは <xref:System.ArgumentException> をスローします。  不一致が発生するのは、<xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> であるのに <xref:System.TimeZoneInfo> オブジェクトがローカル タイム ゾーンを表していない場合、または <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> であるのに <xref:System.TimeZoneInfo> オブジェクトが <xref:System.DateTimeKind?displayProperty=fullName> と等しくない場合です。  
+  
+ これらのメソッドはすべて、<xref:System.DateTime> 値をパラメーターとして受け取り、<xref:System.DateTime> 値を返します。  <xref:System.DateTimeOffset> 値の場合、<xref:System.DateTimeOffset> 構造体には、現在のインスタンスの日時を UTC に変換する <xref:System.DateTimeOffset.ToUniversalTime%2A> インスタンス メソッドがあります。次に示す例では、<xref:System.DateTimeOffset.ToUniversalTime%2A> メソッドを呼び出して、現地時刻と他のいくつかの時刻を UTC に変換しています。  
+  
+ [!code-csharp[System.DateTimeOffset.Methods#16](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Methods/cs/Methods.cs#16)]
+ [!code-vb[System.DateTimeOffset.Methods#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Methods/vb/Methods.vb#16)]  
+  
+## 指定したタイム ゾーンへの UTC の変換  
+ UTC から現地時刻への変換については、後の「UTC から現地時刻への変換」を参照してください。  任意のタイム ゾーンを指定して、UTC をそのタイム ゾーンの時刻に変換するには、<xref:System.TimeZoneInfo.ConvertTimeFromUtc%2A> メソッドを呼び出します。  このメソッドは、次の 2 つのパラメーターを受け取ります。  
+  
+-   変換対象の UTC。  このパラメーターは、<xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> または <xref:System.DateTimeKind?displayProperty=fullName> に設定された <xref:System.DateTime> 値である必要があります。  
+  
+-   UTC の変換先となるタイム ゾーン。  
+  
+ 次に示すコードでは、UTC を米国中部標準時に変換しています。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#8](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#8)]
+ [!code-vb[System.TimeZone2.Concepts#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#8)]  
+  
+## UTC から現地時刻への変換  
+ UTC を現地時刻に変換するには、変換する時刻を表す <xref:System.DateTime> オブジェクトの <xref:System.DateTime.ToLocalTime%2A> メソッドを呼び出します。  メソッドの具体的な動作は、次の表に示すように、オブジェクトの <xref:System.DateTime.Kind%2A> プロパティの値によって異なります。  
+  
+|`DateTime.Kind` プロパティ|変換|  
+|---------------------------|--------|  
+|`DateTimeKind.Local`|<xref:System.DateTime> の値を変更しないで返します。|  
+|`DateTimeKind.Unspecified`|<xref:System.DateTime> の値を UTC と想定し、UTC を現地時刻に変換します。|  
+|`DateTimeKind.Utc`|<xref:System.DateTime> の値を現地時刻に変換します。|  
+  
+ **メモ** <xref:System.TimeZone.ToLocalTime%2A?displayProperty=fullName> メソッドの動作は、`DateTime.ToLocalTime` メソッドと同じです。受け取るパラメーターは、変換する日時の値 1 つだけです。  
+  
+ `static` \(Visual Basic では `Shared`\) <xref:System.TimeZoneInfo.ConvertTime%2A?displayProperty=fullName> メソッドを使用すると、任意のタイム ゾーンの時刻を指定して、現地時刻に変換することもできます。  この方法については、次のセクションで説明します。  
+  
+## 任意の 2 つのタイム ゾーン間での時刻の変換  
+ 次に示す <xref:System.TimeZoneInfo> クラスの 2 つの `static` \(Visual Basic では `Shared`\) メソッドを使用すると、任意の 2 つのタイム ゾーン間で時刻を変換できます。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTime%2A>  
+  
+     このメソッドのパラメーターは、変換する日時値、その日時値のタイム ゾーンを表す `TimeZoneInfo` オブジェクト、および変換後のタイム ゾーンを表す `TimeZoneInfo` オブジェクトです。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId%2A>  
+  
+     このメソッドのパラメーターは、変換する日時値、その日時値のタイム ゾーンの識別子、および変換後のタイム ゾーンの識別子です。  
+  
+ どちらのメソッドでも、変換する日時値の <xref:System.DateTime.Kind%2A> プロパティと、もう 1 つの日時値に対応するタイム ゾーンを表す <xref:System.TimeZoneInfo> オブジェクトまたはタイム ゾーン識別子が必要です。  それ以外の場合は、<xref:System.ArgumentException> がスローされます。  たとえば、日時値の `Kind` プロパティが `DateTimeKind.Local` の場合、メソッドにパラメーターとして渡される `TimeZoneInfo` オブジェクトが `TimeZoneInfo.Local` ではないと、例外がスローされます。  また、メソッドにパラメーターとして渡される識別子が `TimeZoneInfo.Local.Id` に等しくない場合にも、例外がスローされます。  
+  
+ <xref:System.TimeZoneInfo.ConvertTime%2A> メソッドを使用してハワイ標準時を現地時刻に変換する例を次に示します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#9](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#9)]
+ [!code-vb[System.TimeZone2.Concepts#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#9)]  
+  
+## DateTimeOffset 値の変換  
+ <xref:System.DateTimeOffset> オブジェクトはインスタンス化されるときにタイム ゾーンとの関連付けを解除されるので、このオブジェクトによって表される日時値は、完全なタイム ゾーン対応ではありません。  ただし、多くの場合、アプリケーションで必要になるのは、特定のタイム ゾーンでの時刻ではなく、UTC に対する 2 つの異なるオフセットに基づいて日時を変換することだけです。  この変換は、現在のインスタンスの <xref:System.DateTimeOffset.ToOffset%2A> メソッドを呼び出すことで実行できます。  このメソッドの唯一のパラメーターは、メソッドから返される新しい日時値のオフセットです。  
+  
+ たとえば、Web ページに対するユーザー要求の日時がわかっていて、MM\/dd\/yyyy hh:mm:ss zzzz の形式で文字列としてシリアル化されている場合、次の `ReturnTimeOnServer` メソッドは、この日時値を Web サーバーでの日時に変換します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.OffsetConversions#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.OffsetConversions/cs/TimeConversions.cs#1)]
+ [!code-vb[System.DateTimeOffset.Conceptual.OffsetConversions#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.OffsetConversions/vb/TimeConversions.vb#1)]  
+  
+ メソッドが文字列に「9\/1\/5:32 の場合: 07 \-05:00」、タイム ゾーンの時刻を UTC より 5 時間早い表す、9\/1\/3:32:を返します米国の太平洋標準時タイム ゾーンにあるサーバーの 07 年の場合は \-07:00。  
+  
+ <xref:System.TimeZoneInfo> クラスには、複数の <xref:System.DateTimeOffset> 値を使用してタイム ゾーンの変換を実行する <xref:System.TimeZoneInfo.ConvertTime%28System.DateTimeOffset%2CSystem.TimeZoneInfo%29?displayProperty=fullName> メソッドのオーバーロードも含まれます。  このメソッドのパラメーターは、<xref:System.DateTimeOffset> 値と、変換後のタイム ゾーンへの参照です。  このメソッドを呼び出すと、<xref:System.DateTimeOffset> 値が返ります。  たとえば、前の例の `ReturnTimeOnServer` メソッドは、<xref:System.TimeZoneInfo.ConvertTime%28System.DateTimeOffset%2CSystem.TimeZoneInfo%29> メソッドの呼び出しを使用して、次のように書き換えることができます。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.OffsetConversions#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.OffsetConversions/cs/timeconversions2.cs#2)]
+ [!code-vb[System.DateTimeOffset.Conceptual.OffsetConversions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.OffsetConversions/vb/TimeConversions2.vb#2)]  
+  
+## 参照  
+ <xref:System.TimeZoneInfo>   
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/create-time-zones-with-adjustment-rules.md b/docs/standard/datetime/create-time-zones-with-adjustment-rules.md
new file mode 100644
index 00000000000..cb006ca0167
--- /dev/null
+++ b/docs/standard/datetime/create-time-zones-with-adjustment-rules.md
@@ -0,0 +1,97 @@
+---
+title: "方法 : 調整規則のあるタイム ゾーンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "調整規則 [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], および調整規則"
+  - "タイム ゾーン [.NET Framework], 作成"
+ms.assetid: c52ef192-13a9-435f-8015-3b12eae8c47c
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : 調整規則のあるタイム ゾーンを作成する
+アプリケーションで必要な正確なタイム ゾーン情報が、次のような理由で特定のシステムに存在しない場合があります。  
+  
+-   ローカル システムのレジストリでタイム ゾーンが定義されていない。  
+  
+-   タイム ゾーンに関するデータがレジストリで変更または削除されている。  
+  
+-   タイム ゾーンに、過去の特定の期間のタイム ゾーン調整に関する正確な情報がない。  
+  
+ このような場合は、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを呼び出して、アプリケーションで必要なタイム ゾーンを定義できます。  このメソッドのオーバーロードを使用すると、調整規則のあるタイム ゾーンまたは調整規則のないタイム ゾーンを作成できます。  タイム ゾーンが夏時間をサポートする場合は、固定調整規則または浮動調整規則の調整を定義できます。これらの用語の定義については、「[タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)」の「タイム ゾーンの用語」の節を参照してください。  
+  
+> [!IMPORTANT]
+>  <xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを呼び出すことで作成されるカスタム タイム ゾーンは、レジストリには追加されません。  カスタム タイム ゾーンには、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドの呼び出しによって返されるオブジェクト参照を通してのみアクセスできます。  
+  
+ このトピックでは、調整規則のあるタイム ゾーンを作成する方法について説明します。  夏時間調整規則をサポートしないタイム ゾーンを作成する方法については、「[方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)」を参照してください。  
+  
+### 浮動調整規則のあるタイム ゾーンを作成するには  
+  
+1.  調整ごとに \(つまり、特定の期間における標準時間からの切り替えと標準時間への切り替えのそれぞれについて\)、次の操作を行います。  
+  
+    1.  タイム ゾーン調整の切り替え開始時刻を定義します。  
+  
+         <xref:System.TimeZoneInfo.TransitionTime.CreateFloatingDateRule%2A?displayProperty=fullName> メソッドを呼び出して、切り替えの時刻を定義する <xref:System.DateTime> 値、切り替えの月を定義する整数値、切り替えを行う週を定義する整数値、および切り替えを行う曜日を定義する <xref:System.DayOfWeek> 値を渡します。  このメソッド呼び出しにより、<xref:System.TimeZoneInfo.TransitionTime> オブジェクトがインスタンス化されます。  
+  
+    2.  タイム ゾーン調整の切り替え終了時刻を定義します。  これには、<xref:System.TimeZoneInfo.TransitionTime.CreateFloatingDateRule%2A?displayProperty=fullName> メソッドをもう一度呼び出す必要があります。  このメソッド呼び出しでは、2 番目の <xref:System.TimeZoneInfo.TransitionTime> オブジェクトがインスタンス化されます。  
+  
+    3.  <xref:System.TimeZoneInfo.AdjustmentRule.CreateAdjustmentRule%2A> メソッドを呼び出して、その調整が有効になる開始日と終了日、切り替えによって変動する時間数を定義する <xref:System.TimeSpan> オブジェクト、および夏時間への切り替えと夏時間からの切り替えが行われる日時を定義する 2 つの <xref:System.TimeZoneInfo.TransitionTime> オブジェクトを渡します。  このメソッド呼び出しにより、<xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトがインスタンス化されます。  
+  
+    4.  <xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトを、<xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトの配列に割り当てます。  
+  
+2.  タイム ゾーンの表示名を指定します。  表示名は、世界協定時刻 \(UTC: Coordinated Universal Time\) からのタイム ゾーンのオフセットをかっこで囲み、その後にタイム ゾーン、タイム ゾーン内の 1 つ以上の都市、またはタイム ゾーン内の 1 つ以上の国や地域を表す文字列が続く標準形式に従います。  
+  
+3.  タイム ゾーンの標準時間の名前を指定します。  通常は、この文字列がタイム ゾーンの ID としても使用されます。  
+  
+4.  タイム ゾーンの夏時間の名前を指定します。  
+  
+5.  タイム ゾーンの標準名とは異なる ID を使用する場合は、タイム ゾーン ID を指定します。  
+  
+6.  UTC からのタイム ゾーンのオフセットを定義する <xref:System.TimeSpan> オブジェクトをインスタンス化します。  UTC より後の時刻のタイム ゾーンでは正のオフセットになります。  UTC より前の時刻のタイム ゾーンでは負のオフセットになります。  
+  
+7.  [TimeZoneInfo.CreateCustomTimeZone\(String, TimeSpan, String, String, String, TimeZoneInfo.AdjustmentRule\<xref:System.TimeZoneInfo.CreateCustomTimeZone%28System.String%2CSystem.TimeSpan%2CSystem.String%2CSystem.String%2CSystem.String%2CSystem.TimeZoneInfo.AdjustmentRule%5B%5D%29?displayProperty=fullName> メソッドを呼び出して、新しいタイム ゾーンをインスタンス化します。  
+  
+## 使用例  
+ 次の例では、1918 年から現在までのさまざまな期間に対する調整規則が含まれる、米国の中部標準時ゾーンを定義します。  
+  
+ [!code-csharp[System.TimeZone2.CreateTimeZone#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/cs/System.TimeZone2.CreateTimeZone.cs#5)]
+ [!code-vb[System.TimeZone2.CreateTimeZone#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/vb/System.TimeZone2.CreateTimeZone.vb#5)]  
+  
+ この例で作成されるタイム ゾーンには、複数の調整規則があります。  ある調整規則の有効期間の開始日と終了日が、別の調整規則の期間と重ならないように注意する必要があります。  重なる期間があると、<xref:System.InvalidTimeZoneException> がスローされます。  
+  
+ 浮動調整規則の場合、特定の月の最終週に切り替えを行うことを示すには、<xref:System.TimeZoneInfo.TransitionTime.CreateFloatingDateRule%2A> メソッドの `week` パラメーターに値 5 を渡します。  
+  
+ [TimeZoneInfo.CreateCustomTimeZone\(String, TimeSpan, String, String, String, TimeZoneInfo.AdjustmentRule\<xref:System.TimeZoneInfo.CreateCustomTimeZone%28System.String%2CSystem.TimeSpan%2CSystem.String%2CSystem.String%2CSystem.String%2CSystem.TimeZoneInfo.AdjustmentRule%5B%5D%29?displayProperty=fullName> メソッドの呼び出しで使用する <xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトの配列を作成するときは、タイム ゾーンに対して作成する調整の数に合わせて配列のサイズを初期化してもかまいません。  このコード例では、代わりに、<xref:System.Collections.Generic.List%601.Add%2A> メソッドを呼び出して、各調整規則を <xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトのジェネリック <xref:System.Collections.Generic.List%601> コレクションに追加しています。  その後、<xref:System.Collections.Generic.List%601.CopyTo%2A> メソッドを呼び出して、このコレクションのメンバーを配列にコピーします。  
+  
+ この例では、<xref:System.TimeZoneInfo.TransitionTime.CreateFixedDateRule%2A> メソッドを使用して、固定日付の調整も定義しています。  これは <xref:System.TimeZoneInfo.TransitionTime.CreateFloatingDateRule%2A> メソッドの呼び出しと似ていますが、切り替えパラメーターの時刻、月、および日以外は必要とされない点が異なります。  
+  
+ この例は、次のようなコードを使用してテストできます。  
+  
+ [!code-csharp[System.TimeZone2.CreateTimeZone#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/cs/System.TimeZone2.CreateTimeZone.cs#7)]
+ [!code-vb[System.TimeZone2.CreateTimeZone#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/vb/System.TimeZone2.CreateTimeZone.vb#7)]  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   次の名前空間をインポートする。  
+  
+     [!code-csharp[System.TimeZone2.CreateTimeZone#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/cs/System.TimeZone2.CreateTimeZone.cs#6)]
+     [!code-vb[System.TimeZone2.CreateTimeZone#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/vb/System.TimeZone2.CreateTimeZone.vb#6)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)   
+ [方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/create-time-zones-without-adjustment-rules.md b/docs/standard/datetime/create-time-zones-without-adjustment-rules.md
new file mode 100644
index 00000000000..43946b77a4a
--- /dev/null
+++ b/docs/standard/datetime/create-time-zones-without-adjustment-rules.md
@@ -0,0 +1,74 @@
+---
+title: "方法 : 調整規則のないタイム ゾーンを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "調整規則 [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], 調整規則"
+  - "タイム ゾーン [.NET Framework], 作成"
+ms.assetid: a6af8647-7893-4f29-95a9-d94c65a6e8dd
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 調整規則のないタイム ゾーンを作成する
+アプリケーションで必要な正確なタイム ゾーン情報が、次のような理由で特定のシステムに存在しない場合があります。  
+  
+-   ローカル システムのレジストリでタイム ゾーンが定義されていない。  
+  
+-   タイム ゾーンに関するデータがレジストリで変更または削除されている。  
+  
+-   タイム ゾーンは存在するが、過去の特定の期間のタイム ゾーン調整に関する正確な情報がない。  
+  
+ このような場合は、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを呼び出して、アプリケーションで必要なタイム ゾーンを定義できます。  このメソッドのオーバーロードを使用すると、調整規則のあるタイム ゾーンまたは調整規則のないタイム ゾーンを作成できます。  タイム ゾーンが夏時間をサポートする場合は、固定調整規則または浮動調整規則の調整を定義できます。これらの用語の定義については、「[タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)」の「タイム ゾーンの用語」の節を参照してください。  
+  
+> [!IMPORTANT]
+>  <xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを呼び出すことで作成されるカスタム タイム ゾーンは、レジストリには追加されません。  カスタム タイム ゾーンには、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドの呼び出しによって返されるオブジェクト参照を通してのみアクセスできます。  
+  
+ このトピックでは、調整規則のないタイム ゾーンを作成する方法について説明します。  夏時間調整規則をサポートするタイム ゾーンを作成する方法については、「[方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)」を参照してください。  
+  
+### 調整規則のないタイム ゾーンを作成するには  
+  
+1.  タイム ゾーンの表示名を指定します。  
+  
+     表示名は、世界協定時刻 \(UTC: Coordinated Universal Time\) からのタイム ゾーンのオフセットをかっこで囲み、その後にタイム ゾーン、タイム ゾーン内の 1 つ以上の都市、またはタイム ゾーン内の 1 つ以上の国や地域を表す文字列が続く標準形式に従います。  
+  
+2.  タイム ゾーンの標準時間の名前を指定します。  通常は、この文字列がタイム ゾーンの ID としても使用されます。  
+  
+3.  タイム ゾーンの標準名とは異なる ID を使用する場合は、タイム ゾーン ID を指定します。  
+  
+4.  UTC からのタイム ゾーンのオフセットを定義する <xref:System.TimeSpan> オブジェクトをインスタンス化します。  UTC より後の時刻のタイム ゾーンでは正のオフセットになります。  UTC より前の時刻のタイム ゾーンでは負のオフセットになります。  
+  
+5.  <xref:System.TimeZoneInfo.CreateCustomTimeZone%28System.String%2CSystem.TimeSpan%2CSystem.String%2CSystem.String%29?displayProperty=fullName> メソッドを呼び出して、新しいタイム ゾーンをインスタンス化します。  
+  
+## 使用例  
+ 次の例では、南極のモーソンの、調整規則のないカスタム タイム ゾーンを定義します。  
+  
+ [!code-csharp[System.TimeZone2.CreateTimeZone#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/cs/System.TimeZone2.CreateTimeZone.cs#1)]
+ [!code-vb[System.TimeZone2.CreateTimeZone#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/vb/System.TimeZone2.CreateTimeZone.vb#1)]  
+  
+ <xref:System.TimeZoneInfo.DisplayName%2A> プロパティに割り当てる文字列は、UTC からのタイム ゾーンのオフセットの後に、タイム ゾーンのわかりやすい説明を続ける標準形式に従います。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   次の名前空間をインポートする。  
+  
+     [!code-csharp[System.TimeZone2.CreateTimeZone#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/cs/System.TimeZone2.CreateTimeZone.cs#6)]
+     [!code-vb[System.TimeZone2.CreateTimeZone#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.CreateTimeZone/vb/System.TimeZone2.CreateTimeZone.vb#6)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)   
+ [方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/enumerate-time-zones.md b/docs/standard/datetime/enumerate-time-zones.md
index 92370f3b979..b3b0eb21dcb 100644
--- a/docs/standard/datetime/enumerate-time-zones.md
+++ b/docs/standard/datetime/enumerate-time-zones.md
@@ -1,56 +1,75 @@
 ---
-title: "方法: コンピューター上に存在するタイム ゾーンを列挙する"
-description: "方法: コンピューター上に存在するタイム ゾーンを列挙する"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: c5ae4a6c-1790-4355-b5b1-879aaf956129
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: f30ba2a483ff7e5867417969946c2774175d5e3d
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-enumerate-time-zones-present-on-a-computer"></a>方法: コンピューター上に存在するタイム ゾーンを列挙する
-
-指定されたタイム ゾーンを正しく処理するには、そのタイム ゾーンに関する情報がシステムで使用できる必要があります。 たとえば、Windows オペレーティング システムでは、この情報はレジストリに格納されます。 しかし、世界中に存在するタイム ゾーンの合計数は大きいものの、レジストリにはそれらの一部に関する情報しか含まれません。 さらに、レジストリ自体は、内容が意図的に、および誤って変更される可能性がある動的な構造です。 その結果、アプリケーションは、特定のタイム ゾーンがシステムで定義され、使用できると常に想定することができません。 タイム ゾーン情報のアプリケーションを使用する多くのアプリケーションの最初の手順は、必要なタイム ゾーンがローカル システムで使用できるかどうかを判断する、またはタイム ゾーンの一覧をユーザーに提供して選択させることです。 これには、アプリケーションがローカル システムで定義されているタイム ゾーンを列挙する必要があります。 
-
-## <a name="to-enumerate-the-time-zones-present-on-the-local-system"></a>ローカル システムに存在するタイム ゾーンを列挙するには
-
-1. [TimeZoneInfo.GetSystemTimeZones](xref:System.TimeZoneInfo.GetSystemTimeZones) メソッドを呼び出します。 メソッドは [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトのジェネリック [ReadOnlyCollection&lt;T&gt;](xref:System.Collections.ObjectModel.ReadOnlyCollection%601) コレクションを返します。 コレクション内のエントリは、[DisplayName](xref:System.TimeZoneInfo.DisplayName) プロパティによって並べ替えられます。 例:
-
-    ```csharp
-    ReadOnlyCollection<TimeZoneInfo> tzCollection;
-    tzCollection = TimeZoneInfo.GetSystemTimeZones();
-    ```
-
-    ```vb
-    Dim tzCollection As ReadOnlyCollection(Of TimeZoneInfo) = TimeZoneInfo.GetSystemTimeZones
-    ```
-
-2. `foreach` ループ (C#) または `For Each…Next` ループ (Visual Basic) を使用して、コレクション内の個々の [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを列挙し、各オブジェクトに対して必要な処理を実行します。 たとえば、次のコードは、ステップ 1 で返された [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトの [ReadOnlyCollection&lt;T&gt;](xref:System.Collections.ObjectModel.ReadOnlyCollection%601) コレクションを列挙し、各タイム ゾーンの表示名をコンソールに一覧表示します。
-
-    ```csharp
-    foreach (TimeZoneInfo timeZone in tzCollection)
-    Console.WriteLine("   {0}: {1}", timeZone.Id, timeZone.DisplayName);
-    ```
-
-    ```vb
-    For Each timeZone As TimeZoneInfo In tzCollection
-        Console.WriteLine("   {0}: {1}", timeZone.Id, timeZone.DisplayName)
-    Next
-    ```
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)
-
-
+title: "方法 : コンピューター上に存在するタイム ゾーンを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙 (タイム ゾーンを) [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], 列挙"
+ms.assetid: bb7a42ab-6bd9-4c5c-b734-5546d51f8669
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : コンピューター上に存在するタイム ゾーンを列挙する
+指定されたタイム ゾーンを正しく処理するには、システムで使用できるタイム ゾーンについての情報が必要です。  Windows XP オペレーティング システムと Windows Vista オペレーティング システムは、この情報をレジストリに格納します。  しかし、世界中に存在するタイム ゾーンの総数は多く、レジストリに含まれている情報はそのサブセットにすぎません。  さらに、レジストリ自体が動的な構造であり、その内容は意図的に、または偶然に変更される可能性があります。  そのため、アプリケーションでは、特定のタイム ゾーンがシステム上に定義されていて使用できるものと常に想定することはできません。  タイム ゾーン情報を使用する多くのアプリケーションでは、最初の手順として、必要なタイム ゾーンがローカル システムで使用できることを確認するか、またはタイム ゾーンの一覧をユーザーに表示して選択を促します。  そのためには、ローカル システムで定義されているタイム ゾーンをアプリケーションで列挙する必要があります。  
+  
+> [!NOTE]
+>  ローカル システムで定義されていない可能性のある特定のタイム ゾーンの存在に依存するアプリケーションは、そのタイム ゾーンに関する情報をシリアル化および逆シリアル化することで、タイム ゾーンを確実に存在させることができます。  その後、タイム ゾーンをリスト コントロールに追加して、アプリケーションのユーザーが選択できるようにします。  詳細については、「[方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)」および「[方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)」を参照してください。  
+  
+### ローカル システムに存在するタイム ゾーンを列挙するには  
+  
+1.  <xref:System.TimeZoneInfo.GetSystemTimeZones%2A?displayProperty=fullName> メソッドを呼び出します。  メソッドは、<xref:System.TimeZoneInfo> オブジェクトのジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> コレクションを返します。  コレクションのエントリは、<xref:System.TimeZoneInfo.DisplayName%2A> プロパティの順に並んでいます。  たとえば、次のようになります。  
+  
+     [!code-csharp[System.TimeZone2.Concepts#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#1)]
+     [!code-vb[System.TimeZone2.Concepts#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#1)]  
+  
+2.  `foreach` ループ \(C\# の場合\) または `For Each`...`Next` ループ \(Visual Basic の場合\) を使用して、コレクション内の個々の <xref:System.TimeZoneInfo> オブジェクトを列挙し、各オブジェクトに対して必要な処理を実行します。  たとえば、次の例では、手順 1. で返された <xref:System.TimeZoneInfo> オブジェクトの <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> コレクションを列挙し、各タイム ゾーンの表示名の一覧をコンソールに表示します。  
+  
+     [!code-csharp[System.TimeZone2.Concepts#12](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#12)]
+     [!code-vb[System.TimeZone2.Concepts#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#12)]  
+  
+### ローカル システムに存在するタイム ゾーンの一覧をユーザーに表示するには  
+  
+1.  <xref:System.TimeZoneInfo.GetSystemTimeZones%2A?displayProperty=fullName> メソッドを呼び出します。  メソッドは、<xref:System.TimeZoneInfo> オブジェクトのジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> コレクションを返します。  
+  
+2.  手順 1. で返されたコレクションを、Windows フォームの `DataSource` プロパティまたは ASP.NET のリスト コントロールに割り当てます。  
+  
+3.  ユーザーが選択した <xref:System.TimeZoneInfo> オブジェクトを取得します。  
+  
+ Windows アプリケーションでの例を次に示します。  
+  
+## 使用例  
+ この例は、システムで定義されているタイム ゾーンをリスト ボックスに表示する Windows アプリケーションを起動します。  次に、ユーザーが選択したタイム ゾーン オブジェクトの <xref:System.TimeZoneInfo.DisplayName%2A> プロパティの値を含むダイアログ ボックスを表示します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#2)]
+ [!code-vb[System.TimeZone2.Concepts#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#2)]  
+  
+ ほとんどのリスト コントロール \(<xref:System.Windows.Forms.ListBox?displayProperty=fullName> コントロールや <xref:System.Web.UI.WebControls.BulletedList?displayProperty=fullName> コントロールなど\) では、コレクションが <xref:System.Collections.IEnumerable> インターフェイスを実装していれば、オブジェクト変数のコレクションを `DataSource` プロパティに割り当てることができます \(ジェネリック <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> クラスはこれを実装しています\)。コレクション内の個々のオブジェクトを表示するために、コントロールはオブジェクトの `ToString` メソッドを呼び出して、オブジェクトを表すために使用される文字列を抽出します。  <xref:System.TimeZoneInfo> オブジェクトの場合、`ToString` メソッドは <xref:System.TimeZoneInfo> オブジェクトの表示名 \(<xref:System.TimeZoneInfo.DisplayName%2A> プロパティの値\) を返します。  
+  
+> [!NOTE]
+>  リスト コントロールはオブジェクトの `ToString` メソッドを呼び出すので、コントロールに <xref:System.TimeZoneInfo> オブジェクトのコレクションを割り当てて、各オブジェクトの意味のある名前を表示させることができます。さらに、ユーザーが選択した <xref:System.TimeZoneInfo> オブジェクトも取得できます。  これにより、コレクション内の各オブジェクトの文字列を抽出し、文字列をコレクションに割り当て、そのコレクションをコントロールの `DataSource` プロパティに割り当て、ユーザーが選択した文字列を取得し、その文字列を使用して対象のオブジェクトを抽出するという手間をかける必要がなくなります。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   次の名前空間をインポートする。  
+  
+     <xref:System> \(C\# コードの場合\)  
+  
+     <xref:System.Collections.ObjectModel>  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)   
+ [方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/finding-the-time-zones-on-local-system.md b/docs/standard/datetime/finding-the-time-zones-on-local-system.md
index f7d4b14b26d..b2819035674 100644
--- a/docs/standard/datetime/finding-the-time-zones-on-local-system.md
+++ b/docs/standard/datetime/finding-the-time-zones-on-local-system.md
@@ -1,44 +1,45 @@
 ---
-title: "ローカル システムで定義されているタイム ゾーンの検索"
-description: "ローカル システムで定義されているタイム ゾーンの検索"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 3a6ee323-f3cf-486d-aa0c-103931f1eba9
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: e61017e2a0e26295c3be7e8265674b1a5d2ae5a3
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="finding-the-time-zones-defined-on-a-local-system"></a>ローカル システムで定義されているタイム ゾーンの検索
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスは、パブリック コンストラクターを公開しません。 そのため、`new` キーワードを使用して新しい [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを作成することはできません。 [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化するには、代わりに、定義済みのタイム ゾーンの情報をオペレーティング システムから取得します。 このトピックでは、オペレーティング システムによって格納されているデータからタイム ゾーンをインスタンス化する方法について説明します。 また、[TimeZoneInfo](xref:System.TimeZoneInfo) クラスの `static` (Visual Basic では `Shared`) プロパティを使用すると、世界協定時刻 (UTC: Coordinated Universal Time) およびローカル タイム ゾーンにアクセスできます。
-
-## <a name="accessing-individual-time-zones"></a>個別のタイム ゾーンへのアクセス
-
-[TimeZoneInfo](xref:System.TimeZoneInfo) クラスには、UTC 時刻とローカル タイム ゾーンを表す&2; つの定義済みタイム ゾーン オブジェクトがあります。 これらは、それぞれ [TimeZoneInfo.Utc](xref:System.TimeZoneInfo.Utc) プロパティと [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティから取得できます。 UTC またはローカル タイム ゾーンにアクセスする方法については、「[方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](access-utc-and-local.md)」を参照してください。 
-
-また、オペレーティング システムで定義されているタイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化することもできます。 特定のタイム ゾーン オブジェクトをインスタンス化する方法については、「[方法: TimeZoneInfo オブジェクトをインスタンス化する](instantiate-time-zone-info.md)」を参照してください。
-
-## <a name="time-zone-identifiers"></a>タイム ゾーン ID
-
-タイム ゾーン ID は、タイム ゾーンを一意に識別するキー フィールドです。 ほとんどのキーは比較的短いですが、タイム ゾーン ID はいくぶん長めです。 ほとんどの場合、ID の値は、タイム ゾーンの標準時刻の名前を表すために使用される [TimeZoneInfo.StandardName](xref:System.TimeZoneInfo.StandardName) プロパティに対応します。 ただし、例外もあります。 有効な ID を確実に指定する最良の方法は、システムで使用できるタイム ゾーンを列挙し、それに対応するタイム ゾーン ID を記録することです。 タイム ゾーンを列挙する方法については、「[方法: コンピューター上に存在するタイム ゾーンを列挙する](enumerate-time-zones.md)」を参照してください。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](access-utc-and-local.md)
-
-[方法: TimeZoneInfo オブジェクトをインスタンス化する](instantiate-time-zone-info.md)
-
-[方法: コンピューター上に存在するタイム ゾーンを列挙する](enumerate-time-zones.md)
-
-[タイム ゾーン間での時刻の変換](converting-between-time-zones.md)
+title: "ローカル システムで定義されているタイム ゾーンの検索 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ローカル タイム ゾーンへのアクセス"
+  - "タイム ゾーン ID [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], 検索 (ローカル システムのタイム ゾーンを)"
+  - "タイム ゾーン [.NET Framework], local"
+  - "タイム ゾーン [.NET Framework], 取得"
+  - "タイム ゾーン [.NET Framework], UTC"
+  - "UTC 時刻, 検索 (ローカル システムのタイム ゾーンを)"
+ms.assetid: 3f63b1bc-9a4b-4bde-84ea-ab028a80d3e1
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ローカル システムで定義されているタイム ゾーンの検索
+<xref:System.TimeZoneInfo> クラスは、パブリック コンストラクターを公開しません。  そのため、`new` キーワードを使用して新しい <xref:System.TimeZoneInfo> オブジェクトを作成することはできません。  <xref:System.TimeZoneInfo> オブジェクトをインスタンス化するには、代わりに、定義済みのタイム ゾーンの情報をレジストリから取得するか、カスタム タイム ゾーンを作成します。  このトピックでは、レジストリに格納されているデータからタイム ゾーンをインスタンス化する方法について説明します。  また、<xref:System.TimeZoneInfo> クラスの `static` \(Visual Basic では `shared`\) プロパティを使用すると、世界協定時刻 \(UTC: Coordinated Universal Time\) およびローカル タイム ゾーンにアクセスできます。  
+  
+> [!NOTE]
+>  レジストリで定義されていないタイム ゾーンの場合は、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドのオーバーロードを呼び出すことによりカスタム タイム ゾーンを作成できます。  カスタム タイム ゾーンを作成する方法については、「[方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)」と「[方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)」の各トピックを参照してください。  さらに、<xref:System.TimeZoneInfo.FromSerializedString%2A> メソッドを使用して、シリアル化された文字列から復元することにより、<xref:System.TimeZoneInfo> オブジェクトをインスタンス化することもできます。  <xref:System.TimeZoneInfo> オブジェクトのシリアル化と逆シリアル化については、「[方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)」および「[方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)」の各トピックを参照してください。  
+  
+## 個別のタイム ゾーンへのアクセス  
+ <xref:System.TimeZoneInfo> クラスには、UTC 時刻とローカル タイム ゾーンを表す 2 つの定義済みタイム ゾーン オブジェクトがあります。  これらは、それぞれ <xref:System.TimeZoneInfo.Utc%2A> プロパティと <xref:System.TimeZoneInfo.Local%2A> プロパティから取得できます。  UTC またはローカル タイム ゾーンにアクセスする方法については、「[方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](../../../docs/standard/datetime/access-utc-and-local.md)」を参照してください。  
+  
+ また、レジストリで定義されているタイム ゾーンを表す <xref:System.TimeZoneInfo> オブジェクトをインスタンス化することもできます。  特定のタイム ゾーン オブジェクトをインスタンス化する方法については、「[方法 : TimeZoneInfo オブジェクトをインスタンス化する](../../../docs/standard/datetime/instantiate-time-zone-info.md)」を参照してください。  
+  
+## タイム ゾーン ID  
+ タイム ゾーン ID は、タイム ゾーンを一意に識別するキー フィールドです。  ほとんどのキーは比較的短いですが、タイム ゾーン ID はいくぶん長めです。  ほとんどの場合、ID の値は、タイム ゾーンの標準時刻の名前を表すために使用される <xref:System.TimeZoneInfo.StandardName%2A?displayProperty=fullName> プロパティに対応します。  ただし、例外もあります。  有効な ID を確実に指定する最良の方法は、システムで使用できるタイム ゾーンを列挙し、それに対応するタイム ゾーン ID を記録することです。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](../../../docs/standard/datetime/access-utc-and-local.md)   
+ [方法 : TimeZoneInfo オブジェクトをインスタンス化する](../../../docs/standard/datetime/instantiate-time-zone-info.md)   
+ [タイム ゾーン間での時刻の変換](../../../docs/standard/datetime/converting-between-time-zones.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/index.md b/docs/standard/datetime/index.md
index 823bc9f98e0..5331245d673 100644
--- a/docs/standard/datetime/index.md
+++ b/docs/standard/datetime/index.md
@@ -1,73 +1,98 @@
 ---
-title: "日付、時刻、およびタイム ゾーン"
-description: "日付、時刻、およびタイム ゾーン"
-keywords: .NET, .NET Core
-author: stevehoag
-manager: wpickett
-ms.date: 07/22/2016
-ms.topic: article
-ms.prod: .net-core
-ms.technology: .net-core-technologies
-ms.devlang: dotnet
-ms.assetid: 76e6cacc-1c0c-4a71-8cb8-018c112385ba
-translationtype: Human Translation
-ms.sourcegitcommit: c40c28da09e8a122b542463c197196c82c81dd19
-ms.openlocfilehash: 74ba5a2e350db21cdb5a8c228c745ac3f54ed930
-
----
-
-# <a name="dates-times-and-time-zones"></a>日付、時刻、およびタイム ゾーン
-
-.NET は基本的な [System.DateTime](xref:System.DateTime) 構造体だけでなく、タイム ゾーンでの作業をサポートする次のクラスも提供しています。
-
-* [System.TimeZoneInfo](xref:System.TimeZoneInfo)
-    
-  システムのローカル タイム ゾーンおよび世界協定時刻 (UTC) ゾーンでの作業を行うには、このクラスを使用します。
-  
-* [System.DateTimeOffset](xref:System.DateTimeOffset)  
-
-  UTC からのオフセット (つまり時差) がわかっている日付および時刻で作業を行う場合は、この構造体を使用します。 [DateTimeOffset](xref:System.DateTimeOffset) 構造体は、日付および時刻の値と、その時刻の UTC からのオフセットを組み合わせたものです。 UTC との関係により、個々の日付と時刻の値によって具体的な日時が明確に特定されます。 これにより、[DateTime](xref:System.DateTime) の値よりも、[DateTimeOffset](xref:System.DateTimeOffset) の値の方がコンピューター間で移植しやすくなります。 
-  
-ドキュメントのこのセクションでは、タイム ゾーンでの作業を行ったり、あるタイム ゾーンから別のタイム ゾーンに日付と時刻を変換できる、タイム ゾーンに対応したアプリケーションを作成するために必要な情報を提供します。
-
-## <a name="in-this-section"></a>このセクションの内容
-
-[タイムゾーンの概要](time-zone-overview.md) - タイム ゾーンに対応したアプリケーションの作成に関連する用語、概念、問題について説明します。
-    
-[DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](choosing-between-datetime.md) - 日付および時刻のデータでの作業を行う場合、どのようなときに [System.DateTime](xref:System.DateTime)、[System.DateTimeOffset](xref:System.DateTimeOffset)、[System.TimeZoneInfo](xref:System.TimeZoneInfo) の型を使用するかについて説明します。
-    
-[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md) - ローカル システムで検出されたタイム ゾーンを列挙する方法について説明します。
-
-[DateTimeOffset オブジェクトのインスタンス化](instantiating-a-datetimeoffset-object.md) - [System.DateTimeOffset](xref:System.DateTimeOffset) オブジェクトをインスタンス化する方法、および [System.DateTime](xref:System.DateTime) の値を [System.DateTimeOffset](xref:System.DateTimeOffset) の値に変換する方法について説明します。
-
-[日付と時刻を使用した算術演算の実行](performing-arithmetic-operations.md) - [System.DateTime](xref:System.DateTime) および [System.DateTimeOffset](xref:System.DateTimeOffset) の値の加算、減算、比較に関連する問題について説明します。
-
-[DateTime と DateTimeOffset 間の変換](converting-between-datetime-and-offset.md) - [System.DateTime](xref:System.DateTime) の値と [System.DateTimeOffset](xref:System.DateTimeOffset) の値の変換方法について説明します。
-
-[タイム ゾーン間での時刻の変換](converting-between-time-zones.md) - タイム ゾーン間での時刻の変換方法について説明します。
-
-[方法: コンピューター上に存在するタイム ゾーンを列挙する](enumerate-time-zones.md) - コンピューターのレジストリに定義されているタイム ゾーンを列挙して、ユーザーが一覧から事前定義のタイム ゾーンを選択できるようにするための例を提供します。
-
-[方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](access-utc-and-local.md) - 世界協定時刻とローカル タイム ゾーンにアクセスする方法について説明します。
-
-[方法: TimeZoneInfo オブジェクトをインスタンス化する](instantiate-time-zone-info.md) - ローカル システムのレジストリから [System.TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化する方法について説明します。
-
-[方法: 日付と時刻の演算でタイム ゾーンを使用する](use-time-zones-in-arithmetic.md) - タイム ゾーンの調整規則を反映する日付と時刻の演算を実行する方法について説明します。
-
-[方法: あいまいな時刻を解決する](resolve-ambiguous-times.md) - 時刻をタイム ゾーンの標準時刻に対応させることで、あいまいな時刻を解決する方法について説明します。
-
-[方法: ユーザーがあいまいな時刻を解決できるようにする](let-users-resolve-ambiguous-times.md) - ユーザーがあいまいな現地時刻と世界協定時刻の対応を決定できるようにする方法について説明します。
-
-## <a name="reference"></a>参照
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo)
-
-[System.DateTimeOffset](xref:System.DateTimeOffset)
-
-[System.DateTime](xref:System.DateTime)
-
-
-
-<!--HONumber=Nov16_HO3-->
-
-
+title: "日付、時刻、およびタイム ゾーン | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "日付と時刻のデータ [.NET Framework]"
+  - "時刻 [.NET Framework], タイム ゾーン"
+  - "タイム ゾーン オブジェクト [.NET Framework]"
+  - "タイム ゾーン [.NET Framework]"
+  - "時刻 [.NET Framework], タイム ゾーン"
+ms.assetid: 295c16e0-641b-4771-94b3-39c1ffa98c13
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# 日付、時刻、およびタイム ゾーン
+基本的な <xref:System.DateTime> 構造体に加えて、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] にはタイム ゾーンを扱う次のようなクラスも用意されています。  
+  
+-   <xref:System.TimeZone>  
+  
+     システムのローカル タイム ゾーンと世界協定時刻 \(UTC: Coordinated Universal Time\) タイム ゾーンを扱うには、このクラスを使用します。<xref:System.TimeZone> クラスのほとんどの機能は、<xref:System.TimeZoneInfo> クラスに引き継がれています。  
+  
+-   <xref:System.TimeZoneInfo>  
+  
+     このクラスを使用すると、システムに事前に定義されている任意のタイム ゾーンを処理し、新しいタイム ゾーンを作成して、1 つのタイム ゾーンから別のタイム ゾーンに日付\/時刻を簡単に変換できます。  新たに開発する場合は、<xref:System.TimeZone> クラスではなく <xref:System.TimeZoneInfo> クラスを使用してください。  
+  
+-   <xref:System.DateTimeOffset>  
+  
+     この構造体を使用すると、UTC とのオフセット \(つまり時差\) がわかっている日付\/時刻を処理できます。  <xref:System.DateTimeOffset> 構造体は、日付\/時刻値、およびその時刻と UTC とのオフセットを組み合わせます。  UTC との相対関係が示されるため、個々の日付\/時刻値は 1 つの特定の日時を明確に表すことになります。  このため、<xref:System.DateTimeOffset> 値は <xref:System.DateTime> 値に比べて、コンピューター間での移植性に優れています。  
+  
+ ここでは、タイム ゾーンを処理するために必要な情報、および 1 つのタイム ゾーンから別のタイム ゾーンに日付\/時刻を変換するタイム ゾーン対応アプリケーションを作成するために必要な情報について説明します。  
+  
+## このセクションの内容  
+ [タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)  
+ タイム ゾーン対応アプリケーションの作成に関連した用語、概念、および問題について説明します。  
+  
+ [DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](../../../docs/standard/datetime/choosing-between-datetime.md)  
+ 日付\/時刻データを扱う際、どのような場合に <xref:System.DateTime>、<xref:System.DateTimeOffset>、および <xref:System.TimeZoneInfo> の各型を使用できるかについて説明します。  
+  
+ [ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md)  
+ ローカル システム上で検出されるタイム ゾーンを列挙する方法について説明します。  
+  
+ [方法 : コンピューター上に存在するタイム ゾーンを列挙する](../../../docs/standard/datetime/enumerate-time-zones.md)  
+ コンピューターのレジストリに定義されているタイム ゾーンを列挙し、1 つの定義済みタイム ゾーンをユーザーがリストから選択できるようにする例を示します。  
+  
+ [方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](../../../docs/standard/datetime/access-utc-and-local.md)  
+ 世界協定時刻とローカル タイム ゾーンにアクセスする方法について説明します。  
+  
+ [方法 : TimeZoneInfo オブジェクトをインスタンス化する](../../../docs/standard/datetime/instantiate-time-zone-info.md)  
+ ローカル システムのレジストリから <xref:System.TimeZoneInfo> オブジェクトをインスタンス化する方法について説明します。  
+  
+ [DateTimeOffset オブジェクトのインスタンス化](../../../docs/standard/datetime/instantiating-a-datetimeoffset-object.md)  
+ <xref:System.DateTimeOffset> オブジェクトをインスタンス化する方法、および <xref:System.DateTime> 値を <xref:System.DateTimeOffset> 値に変換する方法について説明します。  
+  
+ [方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)  
+ 夏時間の調整をサポートしないカスタム タイム ゾーンを作成する方法について説明します。  
+  
+ [方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)  
+ 1 つ以上の夏時間調整をサポートするカスタム タイム ゾーンを作成する方法について説明します。  
+  
+ [タイム ゾーンの保存と復元](../../../docs/standard/datetime/saving-and-restoring-time-zones.md)  
+ タイム ゾーン データのシリアル化と逆シリアル化が <xref:System.TimeZoneInfo> でどのようにサポートされるかを説明し、これらの機能を使用できるいくつかのシナリオを示します。  
+  
+ [方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)  
+ カスタム タイム ゾーンを作成し、その情報をリソース ファイルに保存する方法について説明します。  
+  
+ [方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)  
+ 埋め込みリソース ファイルに保存されているカスタム タイム ゾーンをインスタンス化する方法について説明します。  
+  
+ [日付と時刻を使用した算術演算の実行](../../../docs/standard/datetime/performing-arithmetic-operations.md)  
+ <xref:System.DateTime> 値と <xref:System.DateTimeOffset> 値の加算、減算、および比較に関連した問題について説明します。  
+  
+ [方法 : 日付と時刻の演算でタイム ゾーンを使用する](../../../docs/standard/datetime/use-time-zones-in-arithmetic.md)  
+ タイム ゾーンの調整規則を考慮して日付と時刻の演算を実行する方法について説明します。  
+  
+ [DateTime と DateTimeOffset 間の変換](../../../docs/standard/datetime/converting-between-datetime-and-offset.md)  
+ <xref:System.DateTime> 値と <xref:System.DateTimeOffset> 値を相互に変換する方法について説明します。  
+  
+ [タイム ゾーン間での時刻の変換](../../../docs/standard/datetime/converting-between-time-zones.md)  
+ 1 つのタイム ゾーンから別のタイム ゾーンに時刻を変換する方法について説明します。  
+  
+ [方法 : あいまいな時刻を解決する](../../../docs/standard/datetime/resolve-ambiguous-times.md)  
+ あいまいな時刻をタイム ゾーンの標準時刻に対応付けることによって解決する方法を示します。  
+  
+ [方法 : ユーザーがあいまいな時刻を解決できるようにする](../../../docs/standard/datetime/let-users-resolve-ambiguous-times.md)  
+ あいまいなローカル時刻と世界協定時刻との対応付けをユーザーが決定できるようにする方法を示します。  
+  
+## 関連項目  
+ <xref:System.TimeZoneInfo?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/datetime/instantiate-time-zone-info.md b/docs/standard/datetime/instantiate-time-zone-info.md
index daba3d1104c..bcfa1492e68 100644
--- a/docs/standard/datetime/instantiate-time-zone-info.md
+++ b/docs/standard/datetime/instantiate-time-zone-info.md
@@ -1,112 +1,48 @@
 ---
-title: "方法 : TimeZoneInfo オブジェクトをインスタンス化する"
-description: "方法 : TimeZoneInfo オブジェクトをインスタンス化する"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: bff137e5-d550-44c3-b460-b3f2dabd4035
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: f2584d446c92d2df2f6d74533ef07fe96888d36a
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-instantiate-a-timezoneinfo-object"></a>方法 : TimeZoneInfo オブジェクトをインスタンス化する
-
-[TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化する最も一般的な方法は、オペレーティング システムからオブジェクトに関する情報を取得することです。 このトピックでは、ローカル システムから [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化する方法について説明します。
-
-## <a name="to-instantiate-a-timezoneinfo-object"></a>TimeZoneInfo オブジェクトをインスタンス化するには
-
-1. [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを宣言します。
-
-2. `static` (Visual Basic の場合は `Shared`) [TimeZoneInfo.FindSystemTimeZoneById](xref:System.TimeZoneInfo.FindSystemTimeZoneById(System.String)) メソッドを呼び出します。
-
-3. メソッドによってスローされた例外を処理します。
-
-## <a name="example"></a>例
-
-次のコードでは、東部標準時のタイム ゾーンを表す [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを取得し、現地時刻に対応する東部標準時の時刻を表示します。
-
-```csharp
-DateTime timeNow = DateTime.Now;
-try
-{
-   TimeZoneInfo easternZone = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time");
-   DateTime easternTimeNow = TimeZoneInfo.ConvertTime(timeNow, TimeZoneInfo.Local, 
-                                                   easternZone);
-   Console.WriteLine("{0} {1} corresponds to {2} {3}.",
-                     timeNow, 
-                     TimeZoneInfo.Local.IsDaylightSavingTime(timeNow) ?
-                               TimeZoneInfo.Local.DaylightName : 
-                               TimeZoneInfo.Local.StandardName,
-                     easternTimeNow, 
-                     easternZone.IsDaylightSavingTime(easternTimeNow) ?
-                                 easternZone.DaylightName : 
-                                 easternZone.StandardName);
-}
-// Handle exception
-//
-// As an alternative to simply displaying an error message, an alternate Eastern
-// Standard Time TimeZoneInfo object could be instantiated here either by restoring
-// it from a serialized string or by providing the necessary data to the
-// CreateCustomTimeZone method.
-catch (InvalidTimeZoneException)
-{
-   Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.");
-}
-catch (SecurityException)
-{
-   Console.WriteLine("The application lacks permission to read time zone information from the registry.");
-}
-catch (OutOfMemoryException)
-{
-   Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.");
-}
-// If we weren't passing FindSystemTimeZoneById a literal string, we also 
-// would handle an ArgumentNullException.
-```
-
-```vb
-Dim timeNow As Date = Date.Now
-Try
-   Dim easternZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Eastern Standard Time")
-   Dim easternTimeNow As Date = TimeZoneInfo.ConvertTime(timeNow, TimeZoneInfo.Local, easternZone)
-   Console.WriteLine("{0} {1} corresponds to {2} {3}.", _
-                     timeNow, _
-                     IIf(TimeZoneInfo.Local.IsDaylightSavingTime(timeNow), _
-                         TimeZoneInfo.Local.DaylightName, TimeZoneInfo.Local.StandardName), _
-                     easternTimeNow, _
-                     IIf(easternZone.IsDaylightSavingTime(easternTimeNow), _
-                         easternZone.DaylightName, easternZone.StandardName))
-' Handle exception
-'
-' As an alternative to simply displaying an error message, an alternate Eastern
-' Standard Time TimeZoneInfo object could be instantiated here either by restoring
-' it from a serialized string or by providing the necessary data to the
-' CreateCustomTimeZone method.
-Catch e As InvalidTimeZoneException
-   Console.WriteLine("The Eastern Standard Time Zone contains invalid or missing data.")   
-Catch e As SecurityException
-   Console.WriteLine("The application lacks permission to read time zone information from the registry.")
-Catch e As OutOfMemoryException
-   Console.WriteLine("Not enough memory is available to load information on the Eastern Standard Time zone.")
-' If we weren't passing FindSystemTimeZoneById a literal string, we also 
-' would handle an ArgumentNullException.
-End
-``` 
-
-[TimeZoneInfo.FindSystemTimeZoneById](xref:System.TimeZoneInfo.FindSystemTimeZoneById(System.String)) メソッドの唯一のパラメーターは、取得するタイム ゾーンの識別子です。これは、オブジェクトの [TimeZoneInfo.Id](xref:System.TimeZoneInfo.Id) プロパティに対応します。 タイム ゾーン ID は、タイム ゾーンを一意に識別するキー フィールドです。 ほとんどのキーは比較的短いですが、タイム ゾーン ID はいくぶん長めです。 ほとんどの場合、ID の値は、タイム ゾーンの標準時刻の名前を表すために使用される [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトの [StandardName](xref:System.TimeZoneInfo.StandardName) プロパティに対応します。 ただし、例外もあります。 有効な識別子を確実に指定する最良の方法は、システムで使用できるタイム ゾーンを列挙し、対応するタイム ゾーン識別子を記録しておくことです。 例については、「[方法 : コンピューター上に存在するタイム ゾーンを列挙する](enumerate-time-zones.md)」を参照してください。 「[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)」のトピックには、選択したタイム ゾーン ID の一覧も掲載されています。
-
-タイム ゾーンが見つかると、メソッドは [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトを返します。 タイム ゾーンが見つかっても、そのデータが破損しているか不完全な場合には、メソッドから [InvalidTimeZoneException](xref:System.InvalidTimeZoneException) がスローされます。 
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[ローカル システムで定義されているタイム ゾーンの検索](finding-the-time-zones-on-local-system.md)
+title: "方法 : TimeZoneInfo オブジェクトをインスタンス化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インスタンス化 (タイム ゾーン オブジェクトを)"
+  - "タイム ゾーン オブジェクト [.NET Framework], インスタンス化"
+ms.assetid: 8cb620e5-c6a6-4267-a52e-beeb73cd1a34
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : TimeZoneInfo オブジェクトをインスタンス化する
+<xref:System.TimeZoneInfo> オブジェクトをインスタンス化する最も一般的な方法は、レジストリからオブジェクトに関する情報を取得することです。 このトピックでは、ローカル システムのレジストリから <xref:System.TimeZoneInfo> オブジェクトをインスタンス化する方法について説明します。  
+  
+### TimeZoneInfo オブジェクトをインスタンス化するには  
+  
+1.  <xref:System.TimeZoneInfo> オブジェクトを宣言します。  
+  
+2.  `static` \(Visual Basic では `Shared`\) <xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+3.  メソッドによってスローされる例外 \(特に、タイム ゾーンがレジストリで定義されていない場合にスローされる <xref:System.TimeZoneNotFoundException>\) を処理します。  
+  
+## 使用例  
+ 次のコードでは、東部標準時のタイム ゾーンを表す <xref:System.TimeZoneInfo> オブジェクトを取得し、現地時刻に対応する東部標準時の時刻を表示します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#5)]
+ [!code-vb[System.TimeZone2.Concepts#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#5)]  
+  
+ <xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A?displayProperty=fullName> メソッドの唯一のパラメーターは、取得するタイム ゾーンの識別子です。これは、オブジェクトの <xref:System.TimeZoneInfo.Id%2A?displayProperty=fullName> プロパティに対応します。 タイム ゾーン ID は、タイム ゾーンを一意に識別するキー フィールドです。 ほとんどのキーは比較的短いですが、タイム ゾーン ID はいくぶん長めです。 ほとんどの場合、ID の値は、タイム ゾーンの標準時刻の名前を表すために使用される <xref:System.TimeZoneInfo> オブジェクトの <xref:System.TimeZoneInfo.StandardName%2A> プロパティに対応します。 ただし、例外もあります。 有効な識別子を確実に指定する最良の方法は、システムで使用できるタイム ゾーンを列挙し、対応するタイム ゾーン識別子を記録しておくことです。 この具体例については、「[方法 : コンピューター上に存在するタイム ゾーンを列挙する](../../../docs/standard/datetime/enumerate-time-zones.md)」を参照してください。[ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md) トピックにも、選択したタイム ゾーン識別子の一覧があります。  
+  
+ タイム ゾーンが見つかると、メソッドは <xref:System.TimeZoneInfo> オブジェクトを返します。  タイム ゾーンが見つからない場合、メソッドから <xref:System.TimeZoneNotFoundException> がスローされます。 タイム ゾーンが見つかっても、そのデータが破損しているか不完全な場合には、メソッドから <xref:System.InvalidTimeZoneException> がスローされます。  
+  
+ アプリケーションが依存するタイム ゾーンが必ず存在していなければならない場合は、最初に <xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A> メソッドを呼び出して、レジストリからタイム ゾーンの情報を取得する必要があります。 メソッドの呼び出しが失敗した場合は、例外ハンドラーで、タイム ゾーンの新しいインスタンスを作成するか、シリアル化された <xref:System.TimeZoneInfo> オブジェクトを逆シリアル化してインスタンスを作成し直す必要があります。 例については、「[方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)」を参照してください。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [ローカル システムで定義されているタイム ゾーンの検索](../../../docs/standard/datetime/finding-the-time-zones-on-local-system.md)   
+ [方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](../../../docs/standard/datetime/access-utc-and-local.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/instantiating-a-datetimeoffset-object.md b/docs/standard/datetime/instantiating-a-datetimeoffset-object.md
index 54786922117..98cf1533e96 100644
--- a/docs/standard/datetime/instantiating-a-datetimeoffset-object.md
+++ b/docs/standard/datetime/instantiating-a-datetimeoffset-object.md
@@ -1,487 +1,94 @@
 ---
-title: "DateTimeOffset オブジェクトのインスタンス化"
-description: "DateTimeOffset オブジェクトのインスタンス化"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 476fe67b-6be4-4435-88ab-ced37304f1d1
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 26be324eb5d58b94a71e89aba213f107cf8dfd1e
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="instantiating-a-datetimeoffset-object"></a>DateTimeOffset オブジェクトのインスタンス化
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 構造体は、新しい [DateTimeOffset](xref:System.DateTimeOffset) 値を作成するためのさまざまな方法を提供します。 それらの多くは新しい [System.DateTime](xref:System.DateTime) 値をインスタンス化するために使用できるメソッドに直接対応し、世界協定時刻 (UTC) からの日時値のオフセットを指定できる拡張が加えられています。 特に、次の方法で、[DateTimeOffset](xref:System.DateTimeOffset) 値をインスタンス化できます。
-
-* [DateTimeOffset](xref:System.DateTimeOffset) コンストラクターを呼び出す。
-
-* 値を [DateTimeOffset](xref:System.DateTimeOffset) 値に暗黙的に変換する。
-
-* 日付と時刻の文字列形式を解析する。
-
-## <a name="date-and-time-literals"></a>日付と時刻のリテラル
-
-これをサポートしている言語では、[DateTime](xref:System.DateTime) 値をインスタンス化する最も一般的な方法の&1; つが、ハード コーディングされたリテラル値として日付と時刻を指定することです。 たとえば、次の Visual Basic コードでは、値が 2008 年 1 月 1 日午前 10時 00分の [DateTime](xref:System.DateTime) オブジェクトを作成しています。
-
-```vb
-Dim literalDate1 As Date = #05/01/2008 8:06:32 AM#
-Console.WriteLine(literalDate1.ToString())
-' Displays:
-'              5/1/2008 8:06:32 AM
-```
-
-[DateTime](xref:System.DateTime) リテラルをサポートする言語を使用している場合は、日付と時刻のリテラルを使用して、[DateTimeOffset](xref:System.DateTimeOffset) 値を初期化することもできます。 たとえば、次の Visual Basic コードでは、[DateTimeOffset](xref:System.DateTimeOffset) オブジェクトを作成しています。
-
-```vb
-Dim literalDate As DateTimeOffset = #05/01/2008 8:06:32 AM#
-Console.WriteLine(literalDate.ToString())
-' Displays:
-'              5/1/2008 8:06:32 AM -07:00
-```
-
-コンソール出力に示すように、このように作成された [DateTimeOffset](xref:System.DateTimeOffset) 値には、ローカル タイム ゾーンのオフセットが割り当てられます。 つまり、文字リテラルを使用して割り当てられた [DateTimeOffset](xref:System.DateTimeOffset) 値は、別のコンピューターでコードが実行された場合に、単一の特定の時点を識別しないことを意味します。
-
-## <a name="datetimeoffset-constructors"></a>DateTimeOffset コンストラクター
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 型は、5 つのコンストラクターを定義します。 それらのうちの&3; つは、[DateTime](xref:System.DateTime) コンストラクターに直接対応し、UTC からの日付と時刻のオフセットを定義する [System.TimeSpan](xref:System.TimeSpan) 型のパラメーターが追加されています。 これらにより、個々の日付と時刻のコンポーネントの値に基づいて、[DateTimeOffset](xref:System.DateTimeOffset) 値を定義できます。 たとえば、次のコードはこれらの 3 つのコンストラクターを使用して、7/1/2008 12:05 AM +01:00 の同じ値で [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトをインスタンス化しています。
-
-```csharp
-DateTimeOffset dateAndTime;
-
-// Instantiate date and time using years, months, days, 
-// hours, minutes, and seconds
-dateAndTime = new DateTimeOffset(2008, 5, 1, 8, 6, 32, 
-                                 new TimeSpan(1, 0, 0));
-Console.WriteLine(dateAndTime);
-// Instantiate date and time using years, months, days,
-// hours, minutes, seconds, and milliseconds
-dateAndTime = new DateTimeOffset(2008, 5, 1, 8, 6, 32, 545, 
-                                 new TimeSpan(1, 0, 0));
-Console.WriteLine("{0} {1}", dateAndTime.ToString("G"), 
-                             dateAndTime.ToString("zzz"));
-
-// Instantiate date and time using number of ticks
-// 05/01/2008 8:06:32 AM is 633,452,259,920,000,000 ticks
-dateAndTime = new DateTimeOffset(633452259920000000, new TimeSpan(1, 0, 0));  
-Console.WriteLine(dateAndTime);
-// The example displays the following output to the console:
-//       5/1/2008 8:06:32 AM +01:00
-//       5/1/2008 8:06:32 AM +01:00
-//       5/1/2008 8:06:32 AM +01:00
-```
-
-```vb
-Dim dateAndTime As DateTimeOffset
-
-' Instantiate date and time using years, months, days, 
-' hours, minutes, and seconds
-dateAndTime = New DateTimeOffset(2008, 5, 1, 8, 6, 32, _
-                                 New TimeSpan(1, 0, 0))
-Console.WriteLine(dateAndTime)
-' Instantiate date and time using years, months, days,
-' hours, minutes, seconds, and milliseconds
-dateAndTime = New DateTimeOffset(2008, 5, 1, 8, 6, 32, 545, _
-                                 New TimeSpan(1, 0, 0))
-Console.WriteLine("{0} {1}", dateAndTime.ToString("G"), _
-                             dateAndTime.ToString("zzz"))
-
-' Instantiate date and time using Persian calendar with years,
-' months, days, hours, minutes, seconds, and milliseconds
-dateAndTime = New DateTimeOffset(1387, 2, 12, 8, 6, 32, 545, New PersianCalendar, New TimeSpan(1, 0, 0))
-' Note that the console output displays the date in the Gregorian
-' calendar, not the Persian calendar. 
-Console.WriteLine("{0} {1}", dateAndTime.ToString("G"), _
-                             dateAndTime.ToString("zzz"))
-
-' Instantiate date and time using number of ticks
-' 05/01/2008 8:06:32 AM is 633,452,259,920,000,000 ticks
-dateAndTime = New DateTimeOffset(633452259920000000, New TimeSpan(1, 0, 0))  
-Console.WriteLine(dateAndTime)
-' The example displays the following output to the console:
-'       5/1/2008 8:06:32 AM +01:00
-'       5/1/2008 8:06:32 AM +01:00
-'       5/1/2008 8:06:32 AM +01:00
-'       5/1/2008 8:06:32 AM +01:00
-```
-
-[PersianCalendar](xref:System.Globalization.PersianCalendar) オブジェクトをそのコンストラクターへの引数の&1; つとして使用して、インスタンス化された [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトの値がコンソールに表示されると、ペルシャ暦ではなく、グレゴリオ暦の日付として表されることに注意してください。 
-
-他の&2; つのコンストラクターは、DateTime 値から [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトを作成します。 1 つ目のコンストラクターには、[DateTimeOffset](xref:System.DateTimeOffset) 値に変換される&1; つのパラメーター [DateTime](xref:System.DateTime) 値があります。 結果の [DateTimeOffset](xref:System.DateTimeOffset) 値のオフセットは、コンストラクターの単一の [DateTime](xref:System.DateTime) パラメーターの [Kind](xref:System.DateTime.Kind) プロパティによって異なります。 その値が [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) の場合、オフセットは [TimeSpan.Zero](xref:System.TimeSpan.Zero) に等しい値に設定されます。 それ以外の場合、オフセットはローカル タイム ゾーンのオフセットと等しい値に設定されます。 次の例に、このコンストラクターを使用して、UTC とローカル タイム ゾーンを表す [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトをインスタンス化する方法を示します。
-
-```csharp
-// Declare date; Kind property is DateTimeKind.Unspecified
-DateTime sourceDate = new DateTime(2008, 5, 1, 8, 30, 0);
-DateTimeOffset targetTime;
-
-// Instantiate a DateTimeOffset value from a UTC time 
-DateTime utcTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Utc);
-targetTime = new DateTimeOffset(utcTime);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM +00:00
-// Because the Kind property is DateTimeKind.Utc, 
-// the offset is TimeSpan.Zero.
-
-// Instantiate a DateTimeOffset value from a UTC time with a zero offset
-targetTime = new DateTimeOffset(utcTime, TimeSpan.Zero);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM +00:00
-// Because the Kind property is DateTimeKind.Utc, 
-// the call to the constructor succeeds
-
-// Instantiate a DateTimeOffset value from a UTC time with a negative offset
-try
-{
-   targetTime = new DateTimeOffset(utcTime, new TimeSpan(-2, 0, 0));
-   Console.WriteLine(targetTime);
-}
-catch (ArgumentException)
-{
-   Console.WriteLine("Attempt to create DateTimeOffset value from {0} failed.", 
-                      targetTime);
-}   
-// Throws exception and displays the following to the console:
-//   Attempt to create DateTimeOffset value from 5/1/2008 8:30:00 AM +00:00 failed.
-
-// Instantiate a DateTimeOffset value from a local time
-DateTime localTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Local);
-targetTime = new DateTimeOffset(localTime);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM -07:00
-// Because the Kind property is DateTimeKind.Local, 
-// the offset is that of the local time zone.
-
-// Instantiate a DateTimeOffset value from an unspecified time
-targetTime = new DateTimeOffset(sourceDate);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM -07:00
-// Because the Kind property is DateTimeKind.Unspecified, 
-// the offset is that of the local time zone.
-```
-
-```vb
-' Declare date; Kind property is DateTimeKind.Unspecified
-Dim sourceDate As Date = #5/1/2008 8:30 AM#
-Dim targetTime As DateTimeOffset
-
-' Instantiate a DateTimeOffset value from a UTC time 
-Dim utcTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Utc)
-targetTime = New DateTimeOffset(utcTime)
-Console.WriteLine(targetTime)
-' Displays 5/1/2008 8:30:00 AM +00:00
-' Because the Kind property is DateTimeKind.Utc, 
-' the offset is TimeSpan.Zero.
-
-
-' Instantiate a DateTimeOffset value from a local time
-Dim localTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Local)
-targetTime = New DateTimeOffset(localTime)
-Console.WriteLine(targetTime)
-' Displays 5/1/2008 8:30:00 AM -07:00
-' Because the Kind property is DateTimeKind.Local, 
-' the offset is that of the local time zone.
-
-' Instantiate a DateTimeOffset value from an unspecified time
-targetTime = New DateTimeOffset(sourceDate)
-Console.WriteLine(targetTime)
-' Displays 5/1/2008 8:30:00 AM -07:00
-' Because the Kind property is DateTimeKind.Unspecified, 
-' the offset is that of the local time zone.
-```
-
+title: "DateTimeOffset オブジェクトのインスタンス化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "インスタンス化 (タイム ゾーン オブジェクトを)"
+  - "タイム ゾーン オブジェクト [.NET Framework]、インスタンス化"
+  - "DateTimeOffset 構造体、変換 (DateTime に)"
+  - "DateTimeOffset 構造体、インスタンス化"
+ms.assetid: 9648375f-d368-4373-a976-3332ece00c0a
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# DateTimeOffset オブジェクトのインスタンス化
+<xref:System.DateTimeOffset> 構造体は <xref:System.DateTimeOffset> 新しい値を作成する方法を示します。  大部分の方法は、新しい <xref:System.DateTime> 値のインスタンス化に利用できるメソッドに直接対応しています。このメソッドには拡張が施されており、世界協定時刻 \(UTC: Coordinated Universal Time\) からの日付と時刻の値のオフセットを指定できます。  具体的には、次の方法を使用して <xref:System.DateTimeOffset> 値をインスタンス化できます。  
+  
+-   日付リテラルと時刻リテラルを使用する。  
+  
+-   <xref:System.DateTimeOffset> コンストラクターを呼び出す。  
+  
+-   値を <xref:System.DateTimeOffset> 値に暗黙に変換する。  
+  
+-   日付と時刻の文字列形式を解析する。  
+  
+ このトピックでは、これらの方法を使用して新しい <xref:System.DateTimeOffset> 値をインスタンス化する方法を詳述し、コード例を示します。  
+  
+## 日付リテラルと時刻リテラル  
+ <xref:System.DateTime> 値をインスタンス化する最も一般的な方法は、日付と時刻を、ハードコーディングされたリテラル値としてインスタンス化することです \(言語がサポートしている場合\)。  たとえば、次の Visual Basic コードは、値が 2008 年 1 月 1 日午前 10 時を示す <xref:System.DateTime> オブジェクトを作成します。  
+  
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#1)]  
+  
+ <xref:System.DateTime> リテラルをサポートする言語を使用する場合は、日付リテラルと時刻リテラルを使用して <xref:System.DateTimeOffset> 値を初期化することもできます。  たとえば、次の Visual Basic コードは、<xref:System.DateTimeOffset> オブジェクトを作成します。  
+  
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#2)]  
+  
+ ファイルの出力を見てわかるように、この方法で作成した <xref:System.DateTimeOffset> 値には、ローカル タイム ゾーンのオフセットが割り当てられます。  これは、文字リテラルを使用して割り当てられた <xref:System.DateTimeOffset> 値は、コードが別のコンピューターで実行されると、単一の時点の時刻を指すものではないことを意味しています。  
+  
+## DateTimeOffset コンストラクター  
+ <xref:System.DateTimeOffset> 型は、6 つのコンストラクターを定義します。  そのうちの 4 つは、<xref:System.DateTime> コンストラクターに直接対応し、UTC からの日付と時刻のオフセットを定義する型 <xref:System.TimeSpan> の追加のパラメーターを提供します。  これにより、日付と時刻に関する各コンポーネントの値に基づいて、<xref:System.DateTimeOffset> 値を定義できます。  たとえば、次のコードでは 4 つのコンストラクターを使用して、7\/1\/2008 12:05 AM \+01:00 という同一の値を持つ <xref:System.DateTimeOffset> オブジェクトをインスタンス化します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Instantiate#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/cs/Instantiate.cs#3)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#3)]  
+  
+ コンストラクターに対する引数の 1 つである、<xref:System.Globalization.PersianCalendar> オブジェクトを使用してインスタンス化した <xref:System.DateTimeOffset> オブジェクトの値は、コンソールにはペルシャ暦ではなくグレゴリオ暦として表示されることに注意してください。  ペルシャ暦を使用した日付を出力するには、トピック「<xref:System.Globalization.PersianCalendar>」にある例を参照してください。  
+  
+ 残りの 2 つのコンストラクターは、<xref:System.DateTime> 値から <xref:System.DateTimeOffset> オブジェクトを作成します。  このうちの 1 つのコンストラクターには、1 つのパラメーターがあります。このパラメーターを使用して、<xref:System.DateTime> 値を <xref:System.DateTimeOffset> 値に変換します。  結果として得られる <xref:System.DateTimeOffset> 値のオフセットは、コンストラクターの単一のパラメーターの <xref:System.DateTime.Kind%2A> プロパティに依存します。  その値が <xref:System.DateTimeKind?displayProperty=fullName> である場合、オフセットは <xref:System.TimeSpan.Zero?displayProperty=fullName> と等しい値に設定されます。  それ以外の場合は、オフセットはローカル タイム ゾーンの値と等しい値に設定されます。  次に、このコンストラクターを使用して、UTC およびローカル タイム ゾーンを表す <xref:System.DateTimeOffset> オブジェクトをインスタンス化する例を示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Instantiate#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/cs/Instantiate.cs#4)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#4)]  
+  
 > [!NOTE]
-> 単一の [DateTime](xref:System.DateTime) パラメーターを持つ [DateTimeOffset](xref:System.DateTimeOffset) コンストラクターのオーバーロードを呼び出すことは、[DateTime](xref:System.DateTime) 値の [DateTimeOffset](xref:System.DateTimeOffset) への暗黙の変換を実行することと同じです。
-
-[DateTime](xref:System.DateTime) 値から [DateTimeOffset](xref:System.DateTimeOffset) オブジェクトを作成する&2; つ目のコンストラクターには、変換する [DateTime](xref:System.DateTime) 値と UTC からの日付と時刻のオフセットを表す [TimeSpan](xref:System.TimeSpan) 値の&2; つのパラメーターがあります。 このオフセット値はコンストラクターの最初のパラメーターの [Kind](xref:System.DateTime.Kind) プロパティに対応している必要があり、そうでないと、[System.ArgumentException](xref:System.ArgumentException) がスローされます。 最初のパラメーターの [Kind](xref:System.DateTime.Kind) プロパティが、[DateTimeKind.Utc](xref:System.DateTimeKind.Utc) である場合、2 番目のパラメーターの値は [TimeSpan.Zero](xref:System.TimeSpan.Zero) である必要があります。 最初のパラメーターの [Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Local](xref:System.DateTimeKind.Local) である場合、2 番目のパラメーターの値はローカル システムのタイム ゾーンのオフセットである必要があります。 最初のパラメーターの [Kind](xref:System.DateTime.Kind) プロパティが [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) である場合は、オフセットに任意の有効な値を指定できます。 次のコードは、[DateTime](xref:System.DateTime) 値を [DateTimeOffset](xref:System.DateTimeOffset) 値に変換するためのこのコンストラクターの呼び出しを示しています。
-
-```csharp
-DateTime sourceDate = new DateTime(2008, 5, 1, 8, 30, 0);
-DateTimeOffset targetTime;
-
-// Instantiate a DateTimeOffset value from a UTC time with a zero offset.
-DateTime utcTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Utc);
-targetTime = new DateTimeOffset(utcTime, TimeSpan.Zero);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM +00:00
-// Because the Kind property is DateTimeKind.Utc,  
-// the call to the constructor succeeds
-
-// Instantiate a DateTimeOffset value from a UTC time with a non-zero offset.
-try
-{
-   targetTime = new DateTimeOffset(utcTime, new TimeSpan(-2, 0, 0));
-   Console.WriteLine(targetTime);
-}
-catch (ArgumentException)
-{
-   Console.WriteLine("Attempt to create DateTimeOffset value from {0} failed.", 
-                      utcTime);
-}   
-// Throws exception and displays the following to the console:
-//   Attempt to create DateTimeOffset value from 5/1/2008 8:30:00 AM failed.
-
-// Instantiate a DateTimeOffset value from a local time with 
-// the offset of the local time zone
-DateTime localTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Local);
-targetTime = new DateTimeOffset(localTime, 
-                                TimeZoneInfo.Local.GetUtcOffset(localTime));
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM -07:00
-// Because the Kind property is DateTimeKind.Local and the offset matches
-// that of the local time zone, the call to the constructor succeeds.
-
-// Instantiate a DateTimeOffset value from a local time with a zero offset.
-try
-{
-   targetTime = new DateTimeOffset(localTime, TimeSpan.Zero);
-   Console.WriteLine(targetTime);
-}
-catch (ArgumentException)
-{
-   Console.WriteLine("Attempt to create DateTimeOffset value from {0} failed.", 
-                      localTime);
-}   
-// Throws exception and displays the following to the console:
-//   Attempt to create DateTimeOffset value from 5/1/2008 8:30:00 AM failed.
-
-// Instantiate a DateTimeOffset value with an arbitary time zone. 
-string timeZoneName = "Central Standard Time";
-TimeSpan offset = TimeZoneInfo.FindSystemTimeZoneById(timeZoneName). 
-                         GetUtcOffset(sourceDate); 
-targetTime = new DateTimeOffset(sourceDate, offset);
-Console.WriteLine(targetTime);
-// Displays 5/1/2008 8:30:00 AM -05:00
-```
-
-```vb
-Dim sourceDate As Date = #5/1/2008 8:30 AM#
-Dim targetTime As DateTimeOffset
-
-' Instantiate a DateTimeOffset value from a UTC time with a zero offset.
-Dim utcTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Utc)
-targetTime = New DateTimeOffset(utcTime, TimeSpan.Zero)
-Console.WriteLine(targetTime)
-' Displays 5/1/2008 8:30:00 AM +00:00
-' Because the Kind property is DateTimeKind.Utc,  
-' the call to the constructor succeeds.
-
-' Instantiate a DateTimeOffset value from a UTC time with a non-zero offset.
-Try
-   targetTime = New DateTimeOffset(utcTime, New TimeSpan(-2, 0, 0))
-   Console.WriteLine(targetTime)
-Catch e As ArgumentException
-   Console.WriteLine("Attempt to create DateTimeOffset value from {0} failed.", _
-                      utcTime)
-End Try   
-' Throws exception and displays the following to the console:
-'   Attempt to create DateTimeOffset value from 5/1/2008 8:30:00 AM failed.
-
-' Instantiate a DateTimeOffset value from a local time with 
-' the offset of the local time zone.
-Dim localTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Local)
-targetTime = New DateTimeOffset(localTime, _
-                                TimeZoneInfo.Local.GetUtcOffset(localTime))
-Console.WriteLine(targetTime)
-' Because the Kind property is DateTimeKind.Local and the offset matches
-' that of the local time zone, the call to the constructor succeeds.
-
-' Instantiate a DateTimeOffset value from a local time with a zero offset.
-Try
-   targetTime = New DateTimeOffset(localTime, TimeSpan.Zero)
-   Console.WriteLine(targetTime)
-Catch e As ArgumentException
-   Console.WriteLine("Attempt to create DateTimeOffset value from {0} failed.", _
-                      localTime)
-End Try   
-' Throws exception and displays the following to the console:
-'   Attempt to create DateTimeOffset value from 5/1/2008 8:30:00 AM failed.
-
-' Instantiate a DateTimeOffset value with an arbitary time zone. 
-Dim timeZoneName As String = "Central Standard Time"
-Dim offset As TimeSpan = TimeZoneInfo.FindSystemTimeZoneById(timeZoneName). _
-                         GetUtcOffset(sourceDate) 
-targetTime = New DateTimeOffset(sourceDate, offset)
-Console.WriteLine(targetTime)
-' Displays 5/1/2008 8:30:00 AM -05:00
-```
-
-## <a name="implicit-type-conversion"></a>無効な型変換
- 
-[System.DateTimeOffset](xref:System.DateTimeOffset) 型は、[System.DateTime](xref:System.DateTime) 値から [DateTimeOffset](xref:System.DateTimeOffset) 値への&1; つの暗黙的な型変換をサポートしています (暗黙的な型変換とは、明示的なキャスト (C# の場合) または変換 (Visual Basic の場合) を必要とせず、情報を失わない&1; つの型から別の型への変換です)。 これにより、次のようなコードが可能となります。
-
-```csharp
-DateTimeOffset targetTime;
-
-// The Kind property of sourceDate is DateTimeKind.Unspecified
-DateTime sourceDate = new DateTime(2008, 5, 1, 8, 30, 0);
-targetTime = sourceDate;
-Console.WriteLine(targetTime);   
-// Displays 5/1/2008 8:30:00 AM -07:00
-
-// define a UTC time (Kind property is DateTimeKind.Utc)
-DateTime utcTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Utc);
-targetTime = utcTime;
-Console.WriteLine(targetTime);   
-// Displays 5/1/2008 8:30:00 AM +00:00
-
-// Define a local time (Kind property is DateTimeKind.Local)
-DateTime localTime = DateTime.SpecifyKind(sourceDate, DateTimeKind.Local);
-targetTime = localTime;
-Console.WriteLine(targetTime);      
-// Displays 5/1/2008 8:30:00 AM -07:00
-```
-
-```vb
-Dim targetTime As DateTimeOffset
-
-' The Kind property of sourceDate is DateTimeKind.Unspecified
-Dim sourceDate As Date = #5/1/2008 8:30 AM#
-targetTime = sourceDate
-Console.WriteLine(targetTime)   
-' Displays 5/1/2008 8:30:00 AM -07:00
-
-' define a UTC time (Kind property is DateTimeKind.Utc)
-Dim utcTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Utc)
-targetTime = utcTime
-Console.WriteLine(targetTime)   
-' Displays 5/1/2008 8:30:00 AM +00:00
-
-' Define a local time (Kind property is DateTimeKind.Local)
-Dim localTime As Date = Date.SpecifyKind(sourceDate, DateTimeKind.Local)
-targetTime = localTime
-Console.WriteLine(targetTime)      
-' Displays 5/1/2008 8:30:00 AM -07:00
-```
-
-結果の [DateTimeOffset](xref:System.DateTimeOffset) 値のオフセットは、DateTime.Kind](xref:System.DateTime.Kind) プロパティ値によって異なります。 その値が [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) の場合、オフセットは [TimeSpan.Zero](xref:System.TimeSpan.Zero) に等しい値に設定されます。 その値が [DateTimeKind.Local](xref:System.DateTimeKind.Local) または [DateTimeKind.Unspecified](xref:System.DateTimeKind.Unspecified) のいずれかの場合、オフセットはローカル タイム ゾーンのオフセットに等しい値に設定されます。
-
-## <a name="parsing-the-string-representation-of-a-date-and-time"></a>日付と時刻の文字列形式の解析
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 型は、日付と時刻の文字列形式を [DateTimeOffset](xref:System.DateTimeOffset) 値に変換できる&4; つのメソッドをサポートしています。
-
-* [Parse](xref:System.DateTimeOffset.Parse(System.String)) は、日付と時刻の文字列形式を [DateTimeOffset](xref:System.DateTimeOffset) 値に変換し、変換が失敗した場合、例外をスローします。
-
-* [TryParse](xref:System.DateTimeOffset.TryParse(System.String,System.DateTimeOffset@)) は、日付と時刻の文字列形式を [DateTimeOffset](xref:System.DateTimeOffset) 値に変換し、変換が失敗した場合は、`false` を返します。
-
-* [ParseExact](xref:System.DateTimeOffset.ParseExact(System.String,System.String,System.IFormatProvider)) は、指定した形式の日付と時刻の文字列形式を、[DateTimeOffset](xref:System.DateTimeOffset) 値に変換しようと試みます。 変換が失敗すると、メソッドは例外をスローします。
-
-* [TryParseExact](xref:System.DateTimeOffset.TryParseExact(System.String,System.String,System.IFormatProvider,System.Globalization.DateTimeStyles,System.DateTimeOffset@)) は、指定した形式の日付と時刻の文字列形式を、[DateTimeOffset](xref:System.DateTimeOffset) 値に変換しようと試みます。 変換が失敗すると、メソッドは `false` を返します。
-
-次の例では、[DateTimeOffset](xref:System.DateTimeOffset) 値をインスタンス化するこれらの&4; つの各文字列変換メソッドの呼び出しを示しています。
-
-```csharp
-string timeString; 
-DateTimeOffset targetTime;
-
-timeString = "05/01/2008 8:30 AM +01:00";
-try
-{
-   targetTime = DateTimeOffset.Parse(timeString);
-   Console.WriteLine(targetTime);
-}
-catch (FormatException)
-{
-   Console.WriteLine("Unable to parse {0}.", timeString);   
-}   
-
-timeString = "05/01/2008 8:30 AM";
-if (DateTimeOffset.TryParse(timeString, out targetTime))
-   Console.WriteLine(targetTime);
-else
-   Console.WriteLine("Unable to parse {0}.", timeString);   
-
-timeString = "Thursday, 01 May 2008 08:30";
-try
-{
-   targetTime = DateTimeOffset.ParseExact(timeString, "f", 
-                CultureInfo.InvariantCulture);
-   Console.WriteLine(targetTime);
-}
-catch (FormatException)
-{
-   Console.WriteLine("Unable to parse {0}.", timeString);   
-}   
-
-timeString = "Thursday, 01 May 2008 08:30 +02:00";
-string formatString; 
-formatString = CultureInfo.InvariantCulture.DateTimeFormat.LongDatePattern +
-                " " +
-                CultureInfo.InvariantCulture.DateTimeFormat.ShortTimePattern +
-                " zzz"; 
-if (DateTimeOffset.TryParseExact(timeString, 
-                                formatString, 
-                                CultureInfo.InvariantCulture, 
-                                DateTimeStyles.AllowLeadingWhite, 
-                                out targetTime))
-   Console.WriteLine(targetTime);
-else
-   Console.WriteLine("Unable to parse {0}.", timeString);
-// The example displays the following output to the console:
-//    5/1/2008 8:30:00 AM +01:00
-//    5/1/2008 8:30:00 AM -07:00
-//    5/1/2008 8:30:00 AM -07:00
-//    5/1/2008 8:30:00 AM +02:00
-```
-
-```vb
-Dim timeString As String 
-Dim targetTime As DateTimeOffset
-
-timeString = "05/01/2008 8:30 AM +01:00"
-Try
-   targetTime = DateTimeOffset.Parse(timeString)
-   Console.WriteLine(targetTime)
-Catch e As FormatException
-   Console.WriteLine("Unable to parse {0}.", timeString)   
-End Try   
-
-timeString = "05/01/2008 8:30 AM"
-If DateTimeOffset.TryParse(timeString, targetTime) Then
-   Console.WriteLine(targetTime)
-Else
-   Console.WriteLine("Unable to parse {0}.", timeString)   
-End If
-
-timeString = "Thursday, 01 May 2008 08:30"
-Try
-   targetTime = DateTimeOffset.ParseExact(timeString, "f", _
-                CultureInfo.InvariantCulture)
-   Console.WriteLine(targetTime)
-Catch e As FormatException
-   Console.WriteLine("Unable to parse {0}.", timeString)   
-End Try   
-
-timeString = "Thursday, 01 May 2008 08:30 +02:00"
-Dim formatString As String 
-formatString = CultureInfo.InvariantCulture.DateTimeFormat.LongDatePattern & _
-                " " & _
-                CultureInfo.InvariantCulture.DateTimeFormat.ShortTimePattern & _
-                " zzz" 
-If DateTimeOffset.TryParseExact(timeString, _
-                                formatString, _
-                                CultureInfo.InvariantCulture, _
-                                DateTimeStyles.AllowLeadingWhite, _
-                                targetTime) Then
-   Console.WriteLine(targetTime)
-Else
-   Console.WriteLine("Unable to parse {0}.", timeString)
-End If      
-' The example displays the following output to the console:
-'    5/1/2008 8:30:00 AM +01:00
-'    5/1/2008 8:30:00 AM -07:00
-'    5/1/2008 8:30:00 AM -07:00
-'    5/1/2008 8:30:00 AM +02:00
-```
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-
+>  単一の <xref:System.DateTime> パラメーターを持つ <xref:System.DateTimeOffset> コンストラクターのオーバーロードを呼び出すことは、<xref:System.DateTime> 値の <xref:System.DateTimeOffset> 値への暗黙の変換を実行することと同じです。  
+  
+ 残りの 2 つのコンストラクターのうち、もう 1 つのコンストラクターは、<xref:System.DateTime> 値から <xref:System.DateTimeOffset> オブジェクトを作成します。この値には、変換する値である <xref:System.DateTime> と、UTC からの日付と時刻のオフセットを表す <xref:System.TimeSpan> の 2 つのパラメーターがあります。  このオフセット値は、コンストラクターの最初のパラメーターの <xref:System.DateTime.Kind%2A> プロパティに対応する必要があります。対応していないと、<xref:System.ArgumentException> がスローされます。  最初のパラメーターの <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> である場合、2 番目のパラメーターの値は <xref:System.TimeSpan.Zero?displayProperty=fullName> であることが必要です。  最初のパラメーターの <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> である場合、2 番目のパラメーターの値はローカル システムのタイム ゾーンのオフセットであることが必要です。  最初のパラメーターの <xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind?displayProperty=fullName> である場合、どのようなオフセットでも有効になります。  次のコードは、このコンストラクターを呼び出して <xref:System.DateTime> を <xref:System.DateTimeOffset> 値に変換する例を示したものです。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Instantiate#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/cs/Instantiate.cs#5)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#5)]  
+  
+## 暗黙の型変換  
+ <xref:System.DateTimeOffset> 型は、<xref:System.DateTime> 値から <xref:System.DateTimeOffset> 値への暗黙の型変換をサポートします。暗黙の型変換とは、明示的なキャスト \(C\# の場合\) や明示的な変換 \(Visual Basic の場合\) を要求せず、かつ情報を失わずに、ある型を別の型に変換することを言います。  次に、コード例を示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Instantiate#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/cs/Instantiate.cs#6)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#6)]  
+  
+ 結果として得られる <xref:System.DateTimeOffset> 値のオフセットは、<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティの値に依存します。  その値が <xref:System.DateTimeKind?displayProperty=fullName> である場合、オフセットは <xref:System.TimeSpan.Zero?displayProperty=fullName> と等しい値に設定されます。  値が <xref:System.DateTimeKind?displayProperty=fullName> または <xref:System.DateTimeKind?displayProperty=fullName> である場合、オフセットはローカル タイム ゾーンの値と等しい値に設定されます。  
+  
+## 日付と時刻の文字列形式の解析  
+ <xref:System.DateTimeOffset> 型は、日付と時刻の文字列形式を <xref:System.DateTimeOffset> 値に変換する 4 つのメソッドをサポートしています。  
+  
+-   <xref:System.DateTimeOffset.Parse%2A> メソッド。日付と時刻の文字列形式を <xref:System.DateTimeOffset> 値に変換します。変換に失敗した場合には例外をスローします。  
+  
+-   <xref:System.DateTimeOffset.TryParse%2A> メソッド。日付と時刻の文字列形式を <xref:System.DateTimeOffset> 値に変換します。変換に失敗した場合には `false` を返します。  
+  
+-   <xref:System.DateTimeOffset.ParseExact%2A> メソッド。指定の形式での日付と時刻の文字列形式を <xref:System.DateTimeOffset> 値に変換します。  変換に失敗した場合には例外をスローします。  
+  
+-   <xref:System.DateTimeOffset.TryParseExact%2A> メソッド。指定の形式での日付と時刻の文字列形式を <xref:System.DateTimeOffset> 値に変換します。  変換に失敗した場合には `false` を返します。  
+  
+ 次に、これらの 4 つの文字列変換メソッドを個別に呼び出して、<xref:System.DateTimeOffset> 値をインスタンス化する例を示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual.Instantiate#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/cs/Instantiate.cs#7)]
+ [!code-vb[System.DateTimeOffset.Conceptual.Instantiate#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual.Instantiate/vb/Instantiate.vb#7)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/let-users-resolve-ambiguous-times.md b/docs/standard/datetime/let-users-resolve-ambiguous-times.md
index 736b875aaca..547913781b5 100644
--- a/docs/standard/datetime/let-users-resolve-ambiguous-times.md
+++ b/docs/standard/datetime/let-users-resolve-ambiguous-times.md
@@ -1,169 +1,64 @@
 ---
-title: "方法 : ユーザーがあいまいな時刻を解決できるようにする"
-description: "方法 : ユーザーがあいまいな時刻を解決できるようにする"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/15/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: d6858a5c-02ab-4367-9e08-fa22c051c38d
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: ede8d021a4f524cf37f7ad00b6aed89d1b1729f8
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-let-users-resolve-ambiguous-times"></a>方法 : ユーザーがあいまいな時刻を解決できるようにする
-
-あいまいな時刻は複数の世界協定時刻 (UTC) にマップされる時刻です。 これは、あるタイム ゾーンの夏時間から標準時間に移行する際など、時計の時刻を前に戻すときに発生します。 あいまいな時刻を処理する場合は、次のいずれかの操作を行います。
-
-* あいまいな時刻が、ユーザーによって入力されたデータの項目の場合は、あいまいさの解決をユーザーに任せることができます。
-
-* 時刻が UTC にどのようにマップされるかを想定します。 たとえば、あいまいな時刻は常にタイム ゾーンの標準時刻で表されると想定できます。
-
-この記事では、ユーザーにあいまいな時刻を解決させる方法を示します。
-
-## <a name="to-let-a-user-resolve-an-ambiguous-time"></a>ユーザーにあいまいな時刻を解決させるには
-
-1. ユーザーによって入力された日付と時刻を取得します。
-
-2. [IsAmbiguousTime(DateTime)](xref:System.TimeZoneInfo.IsAmbiguousTime(System.DateTime)) または [IsAmbiguousTime(DateTimeOffset)](xref:System.TimeZoneInfo.IsAmbiguousTime(System.DateTimeOffset)) メソッドを呼び出して、時刻があいまいかどうかを判断します。
-
-3. ユーザーに目的のオフセットを選択させます。
-
-4. ローカル時刻からユーザーによって選択されたオフセットを減算して、UTC の日時を取得します。
-
-5. `static` ( Visual Basic では `Shared`) [SpecifyKind](xref:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)) メソッドを呼び出して、UTC の日時値の [Kind](xref:System.DateTime.Kind) プロパティを [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) に設定します。
-
-## <a name="example"></a>例
-
-次の例では、ユーザーに日付と時刻を入力するように求め、それがあいまいである場合は、ユーザーにあいまいな時刻をマップする UTC 時刻を選択させています。 この例では、[DateTime](xref:System.DateTime) オブジェクトを使用しています。必要に応じて、[DateTimeOffset](xref:System.DateTimeOffset) オブジェクトに置き換えることができます。
-
-```csharp
-private void GetUserDateInput()
-{
-   // Get date and time from user
-   DateTime inputDate = GetUserDateTime();
-   DateTime utcDate;
-
-   // Exit if date has no significant value
-   if (inputDate == DateTime.MinValue) return;
-
-   if (TimeZoneInfo.Local.IsAmbiguousTime(inputDate))
-   {
-      Console.WriteLine("The date you've entered is ambiguous.");
-      Console.WriteLine("Please select the correct offset from Universal Coordinated Time:");
-      TimeSpan[] offsets = TimeZoneInfo.Local.GetAmbiguousTimeOffsets(inputDate);
-      for (int ctr = 0; ctr < offsets.Length; ctr++)
-      {
-         Console.WriteLine("{0}.) {1} hours, {2} minutes", ctr, offsets[ctr].Hours, offsets[ctr].Minutes);
-      }
-      Console.Write("> ");
-      int selection = Convert.ToInt32(Console.ReadLine());
-
-      // Convert local time to UTC, and set Kind property to DateTimeKind.Utc
-      utcDate = DateTime.SpecifyKind(inputDate - offsets[selection], DateTimeKind.Utc);
-
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", inputDate, utcDate, utcDate.Kind.ToString());
-   }
-   else
-   {
-      utcDate = inputDate.ToUniversalTime();
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", inputDate, utcDate, utcDate.Kind.ToString());    
-   }
-}
-
-private DateTime GetUserDateTime() 
-{
-   bool exitFlag = false;             // flag to exit loop if date is valid
-   string dateString;  
-   DateTime inputDate = DateTime.MinValue;
-
-   Console.Write("Enter a local date and time: ");
-   while (! exitFlag)
-   {
-      dateString = Console.ReadLine();
-      if (dateString.ToUpper() == "E")
-         exitFlag = true;
-
-      if (DateTime.TryParse(dateString, out inputDate))
-         exitFlag = true;
-      else
-         Console.Write("Enter a valid date and time, or enter 'e' to exit: ");
-   }
-
-   return inputDate;        
-}
-```
-
-```vb
-Private Sub GetUserDateInput()
-   ' Get date and time from user
-   Dim inputDate As Date = GetUserDateTime()
-   Dim utcDate As Date
-
-   ' Exit if date has no significant value
-   If inputDate = Date.MinValue Then Exit Sub
-
-   If TimeZoneInfo.Local.IsAmbiguousTime(inputDate) Then
-      Console.WriteLine("The date you've entered is ambiguous.")
-      Console.WriteLine("Please select the correct offset from Universal Coordinated Time:")
-      Dim offsets() As TimeSpan = TimeZoneInfo.Local.GetAmbiguousTimeOffsets(inputDate)
-      For ctr As Integer = 0 to offsets.Length - 1
-         Dim zoneDescription As String
-         If offsets(ctr).Equals(TimeZoneInfo.Local.BaseUtcOffset) Then 
-            zoneDescription = TimeZoneInfo.Local.StandardName
-         Else
-            zoneDescription = TimeZoneInfo.Local.DaylightName
-         End If
-         Console.WriteLine("{0}.) {1} hours, {2} minutes ({3})", _
-                           ctr, offsets(ctr).Hours, offsets(ctr).Minutes, zoneDescription)
-      Next         
-      Console.Write("> ")
-      Dim selection As Integer = CInt(Console.ReadLine())
-
-      ' Convert local time to UTC, and set Kind property to DateTimeKind.Utc
-      utcDate = Date.SpecifyKind(inputDate - offsets(selection), DateTimeKind.Utc)
-
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", inputDate, utcDate, utcDate.Kind.ToString())
-   Else
-      utcDate = inputDate.ToUniversalTime()
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", inputDate, utcDate, utcDate.Kind.ToString())    
-   End If
-End Sub
-
-Private Function GetUserDateTime() As Date
-   Dim exitFlag As Boolean = False            ' flag to exit loop if date is valid
-   Dim dateString As String 
-   Dim inputDate As Date = Date.MinValue
-
-   Console.Write("Enter a local date and time: ")
-   Do While Not exitFlag
-      dateString = Console.ReadLine()
-      If dateString.ToUpper = "E" Then exitFlag = True
-      If Date.TryParse(dateString, inputDate) Then
-         exitFlag = true
-      Else   
-         Console.Write("Enter a valid date and time, or enter 'e' to exit: ")
-      End If
-   Loop
-
-   Return inputDate        
-End Function
-```
-
-このコード例の核心は、[TimeSpan](xref:System.TimeSpan) オブジェクトの配列を使用して、UTC からのあいまいな時刻の可能性のあるオフセットを示すことです。 ただし、これらのオフセットは、ユーザーにとって意味がない可能性があります。 オフセットの意味を明確にするには、コードで、オフセットがローカル タイム ゾーンの標準時刻を表すか、または夏時間を表すかに注意します。 コードで標準時間と夏時間を判断するには、そのオフセットと [BaseUtcOffset](xref:System.TimeZoneInfo.BaseUtcOffset) プロパティの値を比較します。 このプロパティは、UTC とタイム ゾーンの標準時間の差を示します。
-
-この例では、ローカル タイム ゾーンへのすべての参照は [TimeZoneInfo.Local](xref:System.TimeZoneInfo.Local) プロパティによって行われます。ローカル タイム ゾーンが、オブジェクト変数に割り当てられることはありません。 これは、別の呼び出しがキャッシ データをクリアして、ローカル タイム ゾーンが割り当てられているオブジェクトが無効にされる可能性があるために、推奨される方法です。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[方法: あいまいな時刻を解決する](resolve-ambiguous-times.md)
-
-
+title: "方法 : ユーザーがあいまいな時刻を解決できるようにする | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "あいまいな時刻 [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], あいまいな時刻"
+ms.assetid: bca874ee-5b68-4654-8bbd-3711220ef332
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ユーザーがあいまいな時刻を解決できるようにする
+あいまいな時刻とは、複数の世界協定時刻 \(UTC: Coordinated Universal Time\) に対応する時刻です。  このようなことは、あるタイム ゾーンで夏時間から標準時間に移行する際など、クロック時刻を元に戻すときに発生します。  あいまいな時刻は、次のいずれかの方法で対処できます。  
+  
+-   あいまいな時刻がユーザーによって入力されたデータの項目である場合は、あいまいさの解決をユーザーに任せることができます。  
+  
+-   UTC に対する時刻の対応方法を想定します。  たとえば、あいまいな時刻は常にタイム ゾーンの標準時刻を表す、などと想定できます。  
+  
+ このトピックでは、あいまいな時刻をユーザーに解決させる方法について説明します。  
+  
+### あいまいな時刻をユーザーに解決させるには  
+  
+1.  ユーザーが入力した日付と時刻を取得します。  
+  
+2.  <xref:System.TimeZoneInfo.IsAmbiguousTime%2A> メソッドを呼び出して、時刻があいまいかどうかを判定します。  
+  
+3.  時刻があいまいな場合は、<xref:System.TimeZoneInfo.GetAmbiguousTimeOffsets%2A> メソッドを呼び出して、<xref:System.TimeSpan> オブジェクトの配列を取得します。  配列の各要素には、あいまいな時刻に対応する可能性のある UTC オフセットが格納されています。  
+  
+4.  適切なオフセットを選択するようにユーザーに促します。  
+  
+5.  ユーザーが選択したオフセットを現地時刻から減算して、UTC の日付と時刻を取得します。  
+  
+6.  `static` \(Visual Basic .NET では `Shared`\) <xref:System.DateTime.SpecifyKind%2A> メソッドを呼び出して、UTC の日時の値の <xref:System.DateTime.Kind%2A> プロパティに <xref:System.DateTimeKind?displayProperty=fullName> を設定します。  
+  
+## 使用例  
+ 次の例では、日付と時刻の入力をユーザーに要求し、入力された値があいまいな場合は、あいまいな時刻に対応する UTC 時刻をユーザーが選択できるようにします。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#11](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#11)]
+ [!code-vb[System.TimeZone2.Concepts#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#11)]  
+  
+ この例の中核となるコードでは、<xref:System.TimeSpan> オブジェクトの配列を使用して、UTC からのあいまいな時刻のオフセットとして可能性のある値を示しています。  しかし、これらのオフセットはユーザーにとっては意味がないものと考えられます。  オフセットの意味を明確にするため、コードでは、オフセットがローカル タイム ゾーンの標準時刻を表すのか、または夏時間を表すのかも示します。  時刻が標準時刻なのか夏時間なのかを判定するには、オフセットを <xref:System.TimeZoneInfo.BaseUtcOffset%2A> プロパティの値と比較します。  このプロパティは、UTC とタイム ゾーンの標準時刻の間の差を示します。  
+  
+ この例では、ローカル タイム ゾーンに対するすべての参照は、<xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> プロパティを通して行います。ローカル タイム ゾーンをオブジェクト変数に割り当てることはしません。  <xref:System.TimeZoneInfo.ClearCachedData%2A?displayProperty=fullName> メソッドを呼び出すと、ローカル タイム ゾーンが割り当てられているオブジェクトは無効になるので、これが推奨される方法です。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   <xref:System> 名前空間を `using` ステートメントでインポートする \(C\# のコードで必要\)。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [方法 : あいまいな時刻を解決する](../../../docs/standard/datetime/resolve-ambiguous-times.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/performing-arithmetic-operations.md b/docs/standard/datetime/performing-arithmetic-operations.md
index e3449c296f0..ac231b34ab2 100644
--- a/docs/standard/datetime/performing-arithmetic-operations.md
+++ b/docs/standard/datetime/performing-arithmetic-operations.md
@@ -1,320 +1,87 @@
 ---
-title: "日付と時刻を使用した算術演算の実行"
-description: "日付と時刻を使用した算術演算の実行"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/16/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 589ac5ec-8365-4a0d-bc38-72183718110c
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: b872cc4c2b799ddafc9df263795d860754d1ec17
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="performing-arithmetic-operations-with-dates-and-times"></a>日付と時刻を使用した算術演算の実行
-
-[System.DateTime](xref:System.DateTime) 構造体と [System.DateTimeOffset](xref:System.DateTimeOffset) 構造体には、その値に対して算術演算を実行するメンバーが用意されていますが、算術演算の結果は大きく異なります。 この記事では、それらの相違点を検討し、日付と時刻のデータがどの程度タイム ゾーンに対応しているかを明らかにして、日付と時刻のデータを使用してタイム ゾーンに完全に対応した操作を実行する方法について説明します。
-
-## <a name="comparisons-and-arithmetic-operations-with-datetime-values"></a>DateTime 値を使用した比較および算術演算
-
-[System.DateTime](xref:System.DateTime) 値は、制限付きでタイム ゾーンに対応しています。 [DateTime.Kind](xref:System.DateTime.Kind) プロパティでは、[System.DateTimeKind](xref:System.DateTimeKind) 値を日付と時刻に割り当てて、その日付と時刻が現地時刻、世界協定時刻 (UTC)、またはタイム ゾーンが指定されていない時刻のどれを表すかを示すことができます。 ただし、この制限付きのタイム ゾーン情報は、[DateTime](xref:System.DateTime) 値に対して比較操作を行うか、日付と時刻の算術演算を実行するときには無視されます。 次の例では、現在の現地時刻と現在の UTC 時刻を比較することで、この問題を示しています。
-
-```csharp
-using System;
-
-public enum TimeComparison
-{
-   EarlierThan = -1,
-   TheSameAs = 0,
-   LaterThan = 1
-}
-
-public class DateManipulation
-{
-   public static void Main()
-   {
-      DateTime localTime = DateTime.Now;
-      DateTime utcTime = DateTime.UtcNow;
-
-      Console.WriteLine("Difference between {0} and {1} time: {2}:{3} hours", 
-                        localTime.Kind.ToString(), 
-                        utcTime.Kind.ToString(), 
-                        (localTime - utcTime).Hours, 
-                        (localTime - utcTime).Minutes);
-      Console.WriteLine("The {0} time is {1} the {2} time.", 
-                        localTime.Kind.ToString(), 
-                        Enum.GetName(typeof(TimeComparison), localTime.CompareTo(utcTime)), 
-                        utcTime.Kind.ToString());  
-   }
-}
-// If run in the U.S. Pacific Standard Time zone, the example displays 
-// the following output to the console:
-//    Difference between Local and Utc time: -7:0 hours
-//    The Local time is EarlierThan the Utc time.
-```
-
-```vb
-Public Enum TimeComparison As Integer
-   EarlierThan = -1
-   TheSameAs = 0
-   LaterThan = 1
-End Enum
-
-Module DateManipulation
-   Public Sub Main()
-      Dim localTime As Date = Date.Now
-      Dim utcTime As Date = Date.UtcNow
-
-      Console.WriteLine("Difference between {0} and {1} time: {2}:{3} hours", _
-                        localTime.Kind.ToString(), _
-                        utcTime.Kind.ToString(), _
-                        (localTime - utcTime).Hours, _
-                        (localTime - utcTime).Minutes)
-      Console.WriteLine("The {0} time is {1} the {2} time.", _
-                        localTime.Kind.ToString(), _ 
-                        [Enum].GetName(GetType(TimeComparison), localTime.CompareTo(utcTime)), _
-                        utcTime.Kind.ToString())  
-      ' If run in the U.S. Pacific Standard Time zone, the example displays 
-      ' the following output to the console:
-      '    Difference between Local and Utc time: -7:0 hours
-      '    The Local time is EarlierThan the Utc time.                                                    
-   End Sub
-End Module
-```
-
-[DateTime.CompareTo(DateTime, DateTime)](xref:System.DateTime.Compare(System.DateTime,System.DateTime)) メソッドは、現地時刻が UTC 時刻より早い (より小さい) という結果を出力しており、減算の操作は、UTC と米国の太平洋標準時ゾーンにあるシステムの現地時刻との差が7 時間であることを示しています。 しかし、これら&2; つの値は、ある特定の時点を異なる表現で示したものであるため、この場合、時間差の原因は、UTC を基準としたローカル タイム ゾーンのオフセットにあることは明らかです。 
-
-一般的に、[DateTimeKind](xref:System.DateTimeKind) プロパティは、[DateTime](xref:System.DateTime) の比較および算術メソッドによって返される結果に影響を与えません (2 つの同じ時点の比較結果が示すとおり)。ただし、その結果の解釈には影響を与えることがあります。 例:
-
-* 算術演算の実行対象となる&2; つの日付と時刻の値の [DateTimeKind](xref:System.DateTimeKind) プロパティが両方とも [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) である場合、実行結果には、2 つの値の実際の時間差が反映されます。 同様に、そのような&2; つの日付と時刻の値を比較した結果には、2 つの時間の関係が正確に反映されます。
-
-* 算術演算または比較操作の実行対象となる&2; つの日付と時刻の値の [DateTimeKind](xref:System.DateTimeKind) プロパティが両方とも [DateTimeKind.Local](xref:System.DateTimeKind.Local) であるか、または&2; つの日付と時刻の値の [DateTimeKind](xref:System.DateTimeKind) プロパティ値が異なる場合、実行結果には、2 つの値の間の時刻差が反映されます。 
-
-* ローカルの日付と時刻の値に対する算術演算または比較操作では、特定の値があいまいであるかや、無効であるかどうかは考慮されず、ローカル タイム ゾーンでの夏時間の開始や終了による調整規則の影響についても考慮されません。
-
-* UTC と現地時刻の差を比較または計算する操作の結果には、UTC を基準としたローカル タイム ゾーンのオフセットに等しい時間差が含まれます。 
-
-* タイム ゾーンが指定されていない時刻と UTC または現地時刻との差を比較または計算する操作では、単純な時刻差が反映されます。 タイム ゾーンの違いは考慮されず、結果にはタイム ゾーン調整規則の適用が反映されません。 
-
-* タイム ゾーンが指定されていない&2; つの時刻の差を比較または計算する操作の結果には、2 つの異なるタイム ゾーンの時刻の差を反映した未知の時間差が含まれる場合があります。
-
-多くの場合、タイム ゾーンの違いは日付と時刻の計算には影響しないか、または日付と時刻のデータのコンテキストによって比較操作や算術演算の意味が規定されます。 これらの詳細については、「[DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](choosing-between-datetime.md)」をご覧ください。
-
-## <a name="comparisons-and-arithmetic-operations-with-datetimeoffset-values"></a>DateTimeOffset 値を使用した比較および算術演算
-
-[System.DateTimeOffset](xref:System.DateTimeOffset) 値には、日付と時刻だけでなく、UTC を基準としてその日付と時刻を明確に定義するオフセットが含まれています。 このため、[System.DateTime](xref:System.DateTime) 値とはいくらか異なる等価性を規定できるようになります。 [DateTime](xref:System.DateTime) 値が等しくなるのは日付と時刻の値が同じ場合ですが、[DateTimeOffset](xref:System.DateTimeOffset) 値が等しくなるのは、両方の値が同じ時点を表す場合です。 これにより、2 つの日付と時刻の間隔を決定する比較操作やほとんどの算術演算では、[DateTimeOffset](xref:System.DateTimeOffset) 値を使用すると、より正確な結果を得ることができ、結果を正しく解釈する手間を減らすことができます。 次の例では、現地時刻と UTC の DateTime 値を比較した前の例に [DateTimeOffset](xref:System.DateTimeOffset) を使用して、動作の違いを示しています。
-
-```csharp
-using System;
-
-public enum TimeComparison
-{
-   EarlierThan = -1,
-   TheSameAs = 0,
-   LaterThan = 1
-}
-
-public class DateTimeOffsetManipulation
-{
-   public static void Main()
-   {
-      DateTimeOffset localTime = DateTimeOffset.Now;
-      DateTimeOffset utcTime = DateTimeOffset.UtcNow;
-
-      Console.WriteLine("Difference between local time and UTC: {0}:{1:D2} hours", 
-                        (localTime - utcTime).Hours, 
-                        (localTime - utcTime).Minutes);
-      Console.WriteLine("The local time is {0} UTC.", 
-                        Enum.GetName(typeof(TimeComparison), localTime.CompareTo(utcTime)));  
-   }
-}
-// Regardless of the local time zone, the example displays 
-// the following output to the console:
-//    Difference between local time and UTC: 0:00 hours.
-//    The local time is TheSameAs UTC.
-```
-
-```vb
-Public Enum TimeComparison As Integer
-   EarlierThan = -1
-   TheSameAs = 0
-   LaterThan = 1
-End Enum
-
-Module DateTimeOffsetManipulation
-   Public Sub Main()
-      Dim localTime As DateTimeOffset = DateTimeOffset.Now
-      Dim utcTime As DateTimeOffset = DateTimeOffset.UtcNow
-
-      Console.WriteLine("Difference between local time and UTC: {0}:{1:D2} hours.", _
-                        (localTime - utcTime).Hours, _
-                        (localTime - utcTime).Minutes)
-      Console.WriteLine("The local time is {0} UTC.", _
-                        [Enum].GetName(GetType(TimeComparison), localTime.CompareTo(utcTime)))  
-   End Sub
-End Module
-' Regardless of the local time zone, the example displays 
-' the following output to the console:
-'    Difference between local time and UTC: 0:00 hours.
-'    The local time is TheSameAs UTC.
-'          Console.WriteLine(e.GetType().Name)
-```
-
-この例では、[DateTimeOffset.CompareTo](xref:System.DateTimeOffset.CompareTo(System.DateTimeOffset)) メソッドが、現在の現地時刻と現在の UTC 時刻が等しいことを示しており、[DateTimeOffset](xref:System.DateTimeOffset) 値を減算することで、2 つの時刻の差が [TimeSpan.Zero](xref:System.TimeSpan.Zero) であることを示しています。 
-
-日付と時刻の算術演算に [DateTimeOffset](xref:System.DateTimeOffset) 値を使用する際の主な制限は、[DateTimeOffset](xref:System.DateTimeOffset) 値はタイム ゾーンに一部対応していますが、完全対応しているわけではないことです。 [DateTimeOffset](xref:System.DateTimeOffset) 値のオフセットには、[DateTimeOffset](xref:System.DateTimeOffset) 変数に最初に値が割り当てられたときに UTC を基準としたタイム ゾーンのオフセットが反映されますが、その後は、タイム ゾーンと関連付けられなくなります。 特定可能な時刻との直接の関連付けは失われるため、日付と時刻の間隔に対して加算や減算を行っても、タイム ゾーンの調整規則は考慮されません。 
-
-たとえば、米国の中部標準時のタイム ゾーンが夏時間に移行するのは、 2008 年 3 月 9 日の午前 2 時です。 つまり、中部標準時の 2008 年 3 月 9 日の午前 1 時 30 分に 2 時間 30 分の間隔を加算すると、日付と時刻は 2008 年 3 月 9 日の 午前 5 時になります。 しかし、次の例に示すように、加算の結果は 2008 年 3 月 9 日の 午前 4 時です。 この操作の結果は正しい時点を表していますが、目的のタイム ゾーンの時刻ではありません (つまり、予想されるタイム ゾーンのオフセットが適用されていません)。
-
-```csharp
-using System;
-
-public class IntervalArithmetic
-{
-   public static void Main()
-   {
-      DateTime generalTime = new DateTime(2008, 3, 9, 1, 30, 0);
-      const string tzName = "Central Standard Time";
-      TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);
-
-      // Instantiate DateTimeOffset value to have correct CST offset
-      try
-      {
-         DateTimeOffset centralTime1 = new DateTimeOffset(generalTime, 
-                    TimeZoneInfo.FindSystemTimeZoneById(tzName).GetUtcOffset(generalTime));
-
-         // Add two and a half hours      
-         DateTimeOffset centralTime2 = centralTime1.Add(twoAndAHalfHours);
-         // Display result
-         Console.WriteLine("{0} + {1} hours = {2}", centralTime1, 
-                                                    twoAndAHalfHours.ToString(), 
-                                                    centralTime2);  
-      }
-      catch (TimeZoneNotFoundException)
-      {
-         Console.WriteLine("Unable to retrieve Central Standard Time zone information.");
-      }
-   }
-}
-// The example displays the following output to the console:
-//    3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 4:00:00 AM -06:00
-```
-
-```vb
-Module IntervalArithmetic
-   Public Sub Main()
-      Dim generalTime As Date = #03/09/2008 1:30AM#
-      Const tzName As String = "Central Standard Time"
-      Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)
-
-      ' Instantiate DateTimeOffset value to have correct CST offset
-      Try
-         Dim centralTime1 As New DateTimeOffset(generalTime, _
-                    TimeZoneInfo.FindSystemTimeZoneById(tzName).GetUtcOffset(generalTime))
-
-         ' Add two and a half hours      
-         Dim centralTime2 As DateTimeOffset = centralTime1.Add(twoAndAHalfHours)
-         ' Display result
-         Console.WriteLine("{0} + {1} hours = {2}", centralTime1, _
-                                                    twoAndAHalfHours.ToString(), _
-                                                    centralTime2)   
-      Catch e As TimeZoneNotFoundException
-         Console.WriteLine("Unable to retrieve Central Standard Time zone information.")
-      End Try
-   End Sub
-End Module
-' The example displays the following output to the console:
-'    3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 4:00:00 AM -06:00
-```
-
-## <a name="arithmetic-operations-with-times-in-time-zones"></a>タイム ゾーンの時刻を使用した算術演算
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスには、日付と時刻の算術演算を実行するときに調整規則を自動的に適用するメソッドは用意されていません。 ただし、あるタイム ゾーンの時刻を UTC に変換してから算術演算を実行し、その後 UTC から元のタイム ゾーンの時刻に再変換することで、調整規則を適用したときと同じ結果を得ることができます。 詳細については、「[方法 : 日付と時刻の演算でタイム ゾーンを使用する](use-time-zones-in-arithmetic.md)」をご覧ください。
-
-たとえば、次のコードは、2008 年 3 月 9 日の午前 2 時に 2 時間 30 分を加算する 前のコードと似ています。 ただし、中部標準時を UTC に変換した後に日付と時刻の算術演算を実行し、その結果を UTC から中部標準時に変換するため、得られた時刻は中部標準時タイム ゾーンの夏時間への移行を反映しています。
-
-```csharp
-using System;
-
-public class TimeZoneAwareArithmetic
-{
-   public static void Main()
-   {
-      const string tzName = "Central Standard Time";
-
-      DateTime generalTime = new DateTime(2008, 3, 9, 1, 30, 0);
-      TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById(tzName);
-      TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);
-
-      // Instantiate DateTimeOffset value to have correct CST offset
-      try
-      {
-         DateTimeOffset centralTime1 = new DateTimeOffset(generalTime, 
-                                       cst.GetUtcOffset(generalTime));
-
-         // Add two and a half hours
-         DateTimeOffset utcTime = centralTime1.ToUniversalTime();
-         utcTime += twoAndAHalfHours;
-
-         DateTimeOffset centralTime2 = TimeZoneInfo.ConvertTime(utcTime, cst);
-         // Display result
-         Console.WriteLine("{0} + {1} hours = {2}", centralTime1, 
-                                                    twoAndAHalfHours.ToString(), 
-                                                    centralTime2);  
-      }
-      catch (TimeZoneNotFoundException)
-      {
-         Console.WriteLine("Unable to retrieve Central Standard Time zone information.");
-      }
-   }
-}
-// The example displays the following output to the console:
-//    3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 5:00:00 AM -05:00
-```
-
-```vb
-Module TimeZoneAwareArithmetic
-   Public Sub Main()
-      Const tzName As String = "Central Standard Time"
-
-      Dim generalTime As Date = #03/09/2008 1:30AM#
-      Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(tzName) 
-      Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)
-
-      ' Instantiate DateTimeOffset value to have correct CST offset
-      Try
-         Dim centralTime1 As New DateTimeOffset(generalTime, _
-                    cst.GetUtcOffset(generalTime))
-
-         ' Add two and a half hours 
-         Dim utcTime As DateTimeOffset = centralTime1.ToUniversalTime()
-         utcTime += twoAndAHalfHours
-
-         Dim centralTime2 As DateTimeOffset = TimeZoneInfo.ConvertTime(utcTime, cst)
-         ' Display result
-         Console.WriteLine("{0} + {1} hours = {2}", centralTime1, _
-                                                    twoAndAHalfHours.ToString(), _
-                                                    centralTime2)   
-      Catch e As TimeZoneNotFoundException
-         Console.WriteLine("Unable to retrieve Central Standard Time zone information.")
-      End Try
-   End Sub
-End Module
-' The example displays the following output to the console:
-'    3/9/2008 1:30:00 AM -06:00 + 02:30:00 hours = 3/9/2008 5:00:00 AM -05:00
-```
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[方法: 日付と時刻の演算でタイム ゾーンを使用する](use-time-zones-in-arithmetic.md)
-
-
-
+title: "日付と時刻を使用した算術演算の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "算術演算 [.NET Framework], 日付と時刻"
+  - "日付 [.NET Framework], 算術演算"
+  - "日付 [.NET Framework], 比較"
+  - "DateTime 構造体, 算術演算"
+  - "DateTimeOffset 構造体, 算術演算"
+  - "タイム ゾーン [.NET Framework], 算術演算"
+  - "時刻 [.NET Framework], 算術演算"
+ms.assetid: 87c7ddf2-f15e-48af-8602-b3642237e6d0
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 日付と時刻を使用した算術演算の実行
+<xref:System.DateTime> 構造体と <xref:System.DateTimeOffset> 構造体はいずれも、構造体の値に対して算術演算を実行するメンバーを提供しますが、演算の結果は大きく異なります。  ここでは、その相違点について考察し、日付と時刻のデータにおけるタイム ゾーンへの対応の程度について詳述します。さらに、日付と時刻のデータを使用して、タイム ゾーンに完全に対応した操作を実行する方法について解説します。  
+  
+## DateTime 値を使用した比較演算と算術演算  
+ .NET Framework Version 2.0 以降では、<xref:System.DateTime> 値でのタイム ゾーンへの対応は限られたものになっています。  <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティを使用すると、<xref:System.DateTimeKind> 値を日付と時刻に割り当てて、それが表す内容が現地時刻、世界協定時刻 \(UTC: Coordinated Universal Time\)、タイム ゾーンが指定されていない時刻のいずれであるかを示すことができます。  ただし、<xref:System.DateTime> 値で日付と時刻の比較演算や算術演算が実行されるときには、このタイム ゾーンについての制限された情報は無視されます。  この例を次に示します。例では、現在の現地時刻を現在の UTC 時刻と比較します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual2.cs#2)]
+ [!code-vb[System.DateTimeOffset.Conceptual#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual2.vb#2)]  
+  
+ <xref:System.DateTime.CompareTo%28System.DateTime%29> のメソッドは米国の太平洋標準時タイム ゾーンのシステムの UTC と現地時間の違いを 7 時間であることを現地時間 \(または未満\) は UTC 時刻よりも早い\)、および減算演算は次のことを報告します。  しかし、これらの 2 つの値では時刻の表現方法が異なるため、この例では明らかに、時間間隔は UTC からのローカル タイム ゾーンのオフセットに完全に帰属します。  
+  
+ より一般的な例としては、<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティは <xref:System.DateTime> 比較演算および算術演算によって返される結果には影響しないことが挙げられます \(同じ 2 つの時刻の比較が行われるため\)。ただし、結果の解釈には影響することがあります。  たとえば、次のようになります。  
+  
+-   2 つの日付と時刻の値 \(<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティはいずれも <xref:System.DateTimeKind> に設定されている\) に対して実行した算術演算の結果には、2 つの値の間の実際の時間間隔が反映されます。  同様に、このような 2 つの日付と時刻の値を比較すると、時刻間の関係が正確に反映されます。  
+  
+-   2 つの日付と時刻の値 \(<xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティがいずれも <xref:System.DateTimeKind> に設定されているか、2 つの日付と時刻の値にはそれぞれ異なる <xref:System.DateTime.Kind%2A?displayProperty=fullName> プロパティ値が設定されている\) に対して実行した算術演算または比較演算の結果には、2 つの値の間のクロック時間の差異が反映されます。  
+  
+-   ローカルの日付と時刻の値に対して実行される算術演算と比較演算では、特定の値が不明確または無効であるかは考慮されません。また、ローカル タイム ゾーンの夏時間への移行または夏時間からの移行によって生じる調整規則の影響についても考慮されません。  
+  
+-   UTC 時刻と現地時刻との差異を比較または算出する演算には、時間間隔が含まれます。この時間間隔は、結果として求められる UTC からのローカル タイム ゾーンのオフセットに等しくなります。  
+  
+-   タイム ゾーンが指定されていない時刻と UTC 時刻または現地時刻との差異を比較または算出する演算には、単にクロック時間が反映されます。  タイム ゾーン間の差異は考慮されず、結果にはタイム ゾーン調整規則のアプリケーションは反映されません。  
+  
+-   タイム ゾーンが指定されていない 2 つの時刻間での差異を比較または算出する演算には、未知の間隔が含まれます。この時間間隔には、2 つの異なるタイム ゾーンにおける時差が反映されます。  
+  
+ タイム ゾーンの相違が日付と時刻の計算に影響しないシナリオ \(詳細については、「[DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け](../../../docs/standard/datetime/choosing-between-datetime.md)」を参照\) や、日付と時刻のデータのコンテキストによって比較演算と算術演算の意味を定義するシナリオなど、さまざまなシナリオがあります。  
+  
+## DateTimeOffset 値を使用した比較演算と算術演算  
+ <xref:System.DateTimeOffset> 値には、日付と時刻だけでなく、UTC に対する日付と時刻を明確に定義するオフセットも定義されます。  これにより、<xref:System.DateTime> 値とはいくぶん異なる等値性を定義できるようになります。  <xref:System.DateTime> 値は日付と時刻の値が同じである場合に等しくなりますが、<xref:System.DateTimeOffset> 値は同じ時刻を参照している場合に等しくなります。  これによって <xref:System.DateTimeOffset> 値の精度が高まり、2 つの日付と時刻の間隔を判定する比較演算や大部分の算術演算で使用するときに解釈を行う必要性が低くなります。  次の例では、現地時刻および UTC 時刻の <xref:System.DateTime> 値を比較した前述の例と同じ <xref:System.DateTimeOffset> を使用して、その動作の違いを示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual3.cs#3)]
+ [!code-vb[System.DateTimeOffset.Conceptual#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual3.vb#3)]  
+  
+ この例では、<xref:System.DateTimeOffset.CompareTo%2A> メソッドにより、現在の現地時刻と現在の UTC 時刻が等しいことが示されます。また、<xref:System.DateTimeOffset> 値の減算により、2 つの時刻の差が <xref:System.TimeSpan.Zero?displayProperty=fullName> であることが示されます。  
+  
+ 日付と時刻の算術演算で <xref:System.DateTimeOffset> 値を使用するときの主な制限事項は、<xref:System.DateTimeOffset> 値はタイム ゾーンに対応しているものの、それが完全ではないことです。  <xref:System.DateTimeOffset> 変数に最初に値が割り当てられ、タイム ゾーンとの関連付けが解除されたときに、<xref:System.DateTimeOffset> 値のオフセットに UTC からのローカル タイム ゾーンのオフセットが反映されます。  識別できる時間に直接関連付けられていないため、日付と時刻の間隔の加算と減算では、タイム ゾーンの調整規則は考慮されません。  
+  
+ 実際の例では、米国の中部標準時ゾーンの夏時間への移行が 2008 \(3 年 12 月 9 日の午前 2:00 で発生します。  これは、2 種類を追加したことを意味し、2008 年 1 月 3 日 9 時に午前 1:30 の中部標準時に 30 分の間隔は 2008 \(3 年 12 月 9 日の午前 5:00 の日時を生成します。  ただし、次の例に示すように、追加の結果が 2008 \(3 年 12 月 9 日の午前 4:00 です。  この時刻は目的のタイム ゾーンの時刻ではありませんが \(予期したタイム ゾーン オフセットではありませんが\)、演算の結果は正しい時刻を表していることに留意してください。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual4.cs#4)]
+ [!code-vb[System.DateTimeOffset.Conceptual#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual4.vb#4)]  
+  
+## タイム ゾーンの時刻を使用した算術演算  
+ <xref:System.TimeZoneInfo> クラスには、タイム ゾーン間で時刻を変換するときに自動的に調整を適用する変換メソッドが数多く含まれています。  次に例を示します。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTime%2A> メソッドと <xref:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId%2A> メソッド。任意の 2 つのタイム ゾーン間で時刻を変換します。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTimeFromUtc%2A> メソッドと <xref:System.TimeZoneInfo.ConvertTimeToUtc%2A> メソッド。特定のタイム ゾーンの時刻から UTC、または UTC から特定のタイム ゾーンの時刻に変換します。  
+  
+ 詳細については、「[タイム ゾーン間での時刻の変換](../../../docs/standard/datetime/converting-between-time-zones.md)」を参照してください。  
+  
+ <xref:System.TimeZoneInfo> クラスでは、日付と時刻の算術演算を実行するとき、調整規則を自動的に適用するメソッドは提供されません。  ただし、タイム ゾーンの時刻を UTC 時刻に変換し、算術演算を実行して、UTC 時刻からタイム ゾーンの時刻に戻すことで、この処理を実行できます。  詳細については、「[方法 : 日付と時刻の演算でタイム ゾーンを使用する](../../../docs/standard/datetime/use-time-zones-in-arithmetic.md)」を参照してください。  
+  
+ たとえば、次のコードでは、2008 年 1 月 3 日 9 時追加した前のコードと似ています。に午前 2:00 に 2.5 時間かかります。  ここでは、日付と時刻の算術演算を実行して UTC 時刻から中部標準時に結果を変換する前に、中部標準時が UTC 時刻に変換されるため、結果の時刻には中部標準時ゾーンの夏時間への移行が反映されます。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual5.cs#5)]
+ [!code-vb[System.DateTimeOffset.Conceptual#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual5.vb#5)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [方法 : 日付と時刻の演算でタイム ゾーンを使用する](../../../docs/standard/datetime/use-time-zones-in-arithmetic.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/resolve-ambiguous-times.md b/docs/standard/datetime/resolve-ambiguous-times.md
index 6ac11b41d70..c5e6898640d 100644
--- a/docs/standard/datetime/resolve-ambiguous-times.md
+++ b/docs/standard/datetime/resolve-ambiguous-times.md
@@ -1,86 +1,60 @@
 ---
-title: "方法: あいまいな時刻を解決する"
-description: "あいまいな時刻を解決する方法"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/16/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: e86050c6-d16d-405e-8bba-7205945c9a81
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: f4ab3b4bf3487e70be7e885e9b8a2281927eb30e
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-resolve-ambiguous-times"></a>方法: あいまいな時刻を解決する
-
-あいまいな時刻とは、複数の世界協定時刻 (UTC) にマップされる時刻です。 これは、あるタイム ゾーンの夏時間から標準時間に移行する際など、時計の時刻を前に戻すときに発生します。 あいまいな時刻を処理する場合は、次のいずれかの操作を行います。
-
-* 時刻が UTC にどのようにマップされるかを想定します。 たとえば、あいまいな時刻は常にタイム ゾーンの標準時刻で表されると想定できます。
-
-* あいまいな時刻が、ユーザーによって入力されたデータ項目である場合は、あいまいさの解決をユーザーに任せることができます。
-
-この記事では、タイム ゾーンの標準時刻を表すと想定して、あいまいな時刻を解決する方法を示します。
-
-## <a name="to-map-an-ambiguous-time-to-a-time-zones-standard-time"></a>あいまいな時刻をタイム ゾーンの標準時刻にマップするには
-
-1. [System.TimeZoneInfo.IsAmbiguousTime(DateTime)](xref:System.TimeZoneInfo.IsAmbiguousTime(System.DateTime)) または [System.TimeZoneInfo.IsAmbiguousTime(DateTimeOffset)](xref:System.TimeZoneInfo.IsAmbiguousTime(System.DateTimeOffset)) メソッドを呼び出して、時刻があいまいかどうかを判断します。
-
-2. 時刻があいまいな場合は、タイム ゾーンの [BaseUtcOffset](xref:System.TimeZoneInfo.BaseUtcOffset) プロパティによって返される [TimeSpan](xref:System.TimeSpan) オブジェクトから時刻を減算します。
-
-3. `static` (Visual Basic では `Shared`) [SpecifyKind](xref:System.DateTime.SpecifyKind(System.DateTime,System.DateTimeKind)) メソッドを呼び出して、UTC の日付と時刻の値の [Kind](xref:System.DateTime.Kind) プロパティを [DateTimeKind.Utc](xref:System.DateTimeKind.Utc) に設定します。
-
-## <a name="example"></a>例
-
-次の例では、あいまいな時刻がローカル タイム ゾーンの標準時刻を表すと想定して、あいまいな [DateTime](xref:System.DateTime) を UTC に変換する方法を示しています。 
-
-```csharp
-private DateTime ResolveAmbiguousTime(DateTime ambiguousTime)
-{
-   // Time is not ambiguous
-   if (! TimeZoneInfo.Local.IsAmbiguousTime(ambiguousTime))
-   { 
-      return ambiguousTime; 
-   }
-   // Time is ambiguous
-   else
-   {
-      DateTime utcTime = DateTime.SpecifyKind(ambiguousTime - TimeZoneInfo.Local.BaseUtcOffset, 
-                                              DateTimeKind.Utc);      
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", 
-                        ambiguousTime, utcTime, utcTime.Kind.ToString());
-      return utcTime;            
-   }   
-}
-```
-
-```vb
-Private Function ResolveAmbiguousTime(ambiguousTime As Date) As Date
-   ' Time is not ambiguous
-   If Not TimeZoneInfo.Local.IsAmbiguousTime(ambiguousTime) Then 
-      Return TimeZoneInfo.ConvertTimeToUtc(ambiguousTime) 
-   ' Time is ambiguous
-   Else
-      Dim utcTime As Date = DateTime.SpecifyKind(ambiguousTime - TimeZoneInfo.Local.BaseUtcOffset, DateTimeKind.Utc)      
-      Console.WriteLine("{0} local time corresponds to {1} {2}.", ambiguousTime, utcTime, utcTime.Kind.ToString())
-      Return utcTime            
-   End If   
-End Function
-```
-
-この例は、渡された [DateTime](xref:System.DateTime) 値があいまいかどうかを判定する `ResolveAmbiguousTime` という名前のメソッドで構成されます。 値があいまいな場合、メソッドは対応する UTC 時刻を表す [DateTime](xref:System.DateTime) 値を返します。 このメソッドは、ローカル タイム ゾーンの [BaseUtcOffset](xref:System.TimeZoneInfo.BaseUtcOffset) プロパティの値をローカル時刻から減算して、この変換を行います。 
-
-通常、あいまいな時刻の処理では、[GetAmbiguousTimeOffsets](xref:System.TimeZoneInfo.GetAmbiguousTimeOffsets(System.DateTime)) メソッドを呼び出し、あいまいな時刻に対して考えられる UTC オフセットが格納されている [TimeSpan](xref:System.TimeSpan) オブジェクトの配列を取得します。 しかし、この例は、あいまいな時刻は常にタイム ゾーンの標準時刻にマップされるという想定に基づいています。 [BaseUtcOffset](xref:System.TimeZoneInfo.BaseUtcOffset) プロパティは、UTC とタイム ゾーンの標準時刻の間のオフセットを返します。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[方法: ユーザーがあいまいな時刻を解決できるようにする](let-users-resolve-ambiguous-times.md)
-
-
+title: "方法 : あいまいな時刻を解決する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "あいまいな時刻 [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], あいまいな時刻"
+ms.assetid: 2cf5fb25-492c-4875-9245-98cac8348e97
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : あいまいな時刻を解決する
+あいまいな時刻とは、複数の世界協定時刻 \(UTC: Coordinated Universal Time\) に対応する時刻です。  このようなことは、あるタイム ゾーンで夏時間から標準時間に移行する際など、クロック時刻を元に戻すときに発生します。  あいまいな時刻は、次のいずれかの方法で対処できます。  
+  
+-   UTC に対する時刻の対応方法を想定します。  たとえば、あいまいな時刻は常にタイム ゾーンの標準時刻を表す、などと想定できます。  
+  
+-   あいまいな時刻がユーザーによって入力されたデータの項目である場合は、あいまいさの解決をユーザーに任せることができます。  
+  
+ このトピックでは、タイム ゾーンの標準時刻を表すと想定することであいまいな時刻を解決する方法を示します。  
+  
+### あいまいな時刻をタイム ゾーンの標準時刻に対応させるには  
+  
+1.  <xref:System.TimeZoneInfo.IsAmbiguousTime%2A> メソッドを呼び出して、時刻があいまいかどうかを判定します。  
+  
+2.  時刻があいまいな場合は、タイム ゾーンの <xref:System.TimeZoneInfo.BaseUtcOffset%2A> プロパティによって返される <xref:System.TimeSpan> オブジェクトから時刻を減算します。  
+  
+3.  `static` \(Visual Basic .NET では `Shared`\) <xref:System.DateTime.SpecifyKind%2A> メソッドを呼び出して、UTC の日時値の <xref:System.DateTime.Kind%2A> プロパティに <xref:System.DateTimeKind?displayProperty=fullName> を設定します。  
+  
+## 使用例  
+ 次の例では、あいまいな時刻がローカル タイム ゾーンの標準時刻を表すと想定することで、あいまいな時刻を UTC に変換する方法を示します。  
+  
+ [!code-csharp[System.TimeZone2.Concepts#10](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Concepts/CS/TimeZone2Concepts.cs#10)]
+ [!code-vb[System.TimeZone2.Concepts#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Concepts/VB/TimeZone2Concepts.vb#10)]  
+  
+ この例は、渡された <xref:System.DateTime> 値があいまいかどうかを判定する `ResolveAmbiguousTime` という名前のメソッドで構成されます。  値があいまいな場合、メソッドは対応する UTC 時刻を表す <xref:System.DateTime> 値を返します。  メソッドは、ローカル タイム ゾーンの <xref:System.TimeZoneInfo.BaseUtcOffset%2A> プロパティの値をローカル時刻から減算することで、この変換を行います。  
+  
+ 通常、あいまいな時刻は、<xref:System.TimeZoneInfo.GetAmbiguousTimeOffsets%2A> メソッドを呼び出し、あいまいな時刻に対して可能性のある UTC オフセットが格納されている <xref:System.TimeSpan> オブジェクトの配列を取得することで処理します。  しかし、この例では、あいまいな時刻は常にタイム ゾーンの標準時刻に対応する、と断定的に想定しています。  <xref:System.TimeZoneInfo.BaseUtcOffset%2A> プロパティは、UTC とタイム ゾーンの標準時刻の間のオフセットを返します。  
+  
+ この例では、ローカル タイム ゾーンに対するすべての参照は、<xref:System.TimeZoneInfo.Local%2A?displayProperty=fullName> プロパティを通して行います。ローカル タイム ゾーンをオブジェクト変数に割り当てることはしません。  <xref:System.TimeZoneInfo.ClearCachedData%2A?displayProperty=fullName> メソッドを呼び出すと、ローカル タイム ゾーンが割り当てられているオブジェクトは無効になるので、これが推奨される方法です。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   <xref:System> 名前空間を `using` ステートメントでインポートする \(C\# のコードで必要\)。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [方法 : ユーザーがあいまいな時刻を解決できるようにする](../../../docs/standard/datetime/let-users-resolve-ambiguous-times.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md b/docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md
new file mode 100644
index 00000000000..87a75036bb2
--- /dev/null
+++ b/docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md
@@ -0,0 +1,62 @@
+---
+title: "方法 : 埋め込みリソースからタイム ゾーンを復元する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タイム ゾーン [.NET Framework], 逆シリアル化"
+  - "タイム ゾーン [.NET Framework], 復元"
+ms.assetid: 6b7b4de9-da07-47e3-8f4c-823f81798ee7
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# 方法 : 埋め込みリソースからタイム ゾーンを復元する
+このトピックでは、リソース ファイルに保存されているタイム ゾーンを復元する方法について説明します。  タイム ゾーンの保存に関する詳細と方法については、「[方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)」を参照してください。  
+  
+### 埋め込みリソースから TimeZoneInfo オブジェクトを逆シリアル化するには  
+  
+1.  取得するタイム ゾーンがカスタム タイム ゾーンではない場合は、<xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A> メソッドを使用してインスタンス化を試みます。  
+  
+2.  埋め込みリソース ファイルの完全修飾名およびリソース ファイルを含むアセンブリへの参照を渡して、<xref:System.Resources.ResourceManager> オブジェクトをインスタンス化します。  
+  
+     埋め込みリソース ファイルの完全修飾名がわからない場合は、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用してアセンブリのマニフェストを調べます。  `.mresource` エントリがリソースを示しています。  この例では、リソースの完全修飾名は `SerializeTimeZoneData.SerializedTimeZones` です。  
+  
+     リソース ファイルが、タイム ゾーンのインスタンス化コードと同じアセンブリに埋め込まれている場合は、`static` \(Visual Basic では `Shared`\) <xref:System.Reflection.Assembly.GetExecutingAssembly%2A> メソッドを呼び出すことで、リソース ファイルへの参照を取得できます。  
+  
+3.  <xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A> メソッドの呼び出しが失敗する場合、またはカスタム タイム ゾーンをインスタンス化する場合は、<xref:System.Resources.ResourceManager.GetString%2A?displayProperty=fullName> メソッドを呼び出して、シリアル化されたタイム ゾーンを含む文字列を取得します。  
+  
+4.  <xref:System.TimeZoneInfo.FromSerializedString%2A> メソッドを呼び出して、タイム ゾーン データを逆シリアル化します。  
+  
+## 使用例  
+ 次の例では、埋め込み .NET XML リソース ファイルに格納されている <xref:System.TimeZoneInfo> オブジェクトを逆シリアル化します。  
+  
+ [!code-csharp[TimeZone2.Serialization#3](../../../samples/snippets/csharp/VS_Snippets_CLR/TimeZone2.Serialization/cs/SerializeTimeZoneData.cs#3)]
+ [!code-vb[TimeZone2.Serialization#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/TimeZone2.Serialization/vb/SerializeTimeZoneData.vb#3)]  
+  
+ このコードは、アプリケーションで必要な <xref:System.TimeZoneInfo> オブジェクトが存在することを確認するための例外処理を示しています。  最初に、<xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A> メソッドを使用してレジストリから取得する方法で、<xref:System.TimeZoneInfo> オブジェクトのインスタンス化を試みます。  タイム ゾーンをインスタンス化できない場合は、埋め込みリソース ファイルから取得します。  
+  
+ カスタム タイム ゾーン \(<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを使用してインスタンス化されるタイム ゾーン\) のデータはレジストリに格納されていないので、Palmer, Antarctica のタイム ゾーンをインスタンス化するときは <xref:System.TimeZoneInfo.FindSystemTimeZoneById%2A> を呼び出しません。  代わりに、<xref:System.TimeZoneInfo.FromSerializedString%2A> メソッドを呼び出す前に、埋め込みリソース ファイルを直接調べてタイム ゾーンのデータを含む文字列を取得します。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Windows.Forms.dll および System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   次の名前空間をインポートする。  
+  
+     [!code-csharp[TimeZone2.Serialization#2](../../../samples/snippets/csharp/VS_Snippets_CLR/TimeZone2.Serialization/cs/SerializeTimeZoneData.cs#2)]
+     [!code-vb[TimeZone2.Serialization#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/TimeZone2.Serialization/vb/SerializeTimeZoneData.vb#2)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)   
+ [方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/save-time-zones-to-an-embedded-resource.md b/docs/standard/datetime/save-time-zones-to-an-embedded-resource.md
new file mode 100644
index 00000000000..276de988998
--- /dev/null
+++ b/docs/standard/datetime/save-time-zones-to-an-embedded-resource.md
@@ -0,0 +1,87 @@
+---
+title: "方法 : 埋め込みリソースにタイム ゾーンを保存する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タイム ゾーン オブジェクト [.NET Framework], 保存"
+  - "タイム ゾーン オブジェクト [.NET Framework], シリアル化"
+  - "タイム ゾーン [.NET Framework], 保存"
+ms.assetid: 3c96d83a-a057-4496-abb0-8f4b12712558
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 埋め込みリソースにタイム ゾーンを保存する
+タイム ゾーンに対応したアプリケーションでは、多くの場合、特定のタイム ゾーンが存在する必要があります。  しかし、個別の <xref:System.TimeZoneInfo> オブジェクトを使用できるかどうかはローカル システムのレジストリに格納されている情報に依存するので、通常は使用できるタイム ゾーンであっても存在しない場合があります。  さらに、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドを使用することでインスタンス化されるカスタム タイム ゾーンについての情報は、他のタイム ゾーン情報とは異なりレジストリに格納されません。  このようなタイム ゾーンを必要なときに確実に使用できるようにするには、タイム ゾーンをシリアル化して保存し、必要になったら逆シリアル化して復元します。  
+  
+ 通常、<xref:System.TimeZoneInfo> オブジェクトのシリアル化は、タイム ゾーンに対応するアプリケーションとは関係なく行われます。  シリアル化された <xref:System.TimeZoneInfo> オブジェクトの保持に使用するデータ ストアによっては、セットアップ ルーチンまたはインストール ルーチンの一部として \(たとえば、データがレジストリのアプリケーション キーに格納されるとき\)、または最終的なアプリケーションがコンパイルされる前に実行するユーティリティ ルーチンの一部として \(たとえば、シリアル化されたデータが .NET XML リソース \(.resx\) ファイルに格納されるとき\)、タイム ゾーンのデータをシリアル化できます。  
+  
+ アプリケーションと共にコンパイルされるリソース ファイル以外に、複数のデータ ストアをタイム ゾーン情報に使用できます。  次に例を示します。  
+  
+-   レジストリ。  アプリケーションでは、HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Time Zones というサブキーを使用するのではなく、アプリケーション自体のキーのサブキーを使用してカスタム タイム ゾーン データを格納する必要があります。  
+  
+-   構成ファイル。  
+  
+-   その他のシステム ファイル。  
+  
+### .resx ファイルにシリアル化してタイム ゾーンを保存するには  
+  
+1.  既存のタイム ゾーンを取得するか、新しいタイム ゾーンを作成します。  
+  
+     既存のタイム ゾーンを取得する方法については、「[方法 : 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする](../../../docs/standard/datetime/access-utc-and-local.md)」および「[方法 : TimeZoneInfo オブジェクトをインスタンス化する](../../../docs/standard/datetime/instantiate-time-zone-info.md)」を参照してください。  
+  
+     新しいタイム ゾーンを作成するには、<xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドのオーバーロードの 1 つを呼び出します。  詳細については、「[方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)」および「[方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)」を参照してください。  
+  
+2.  <xref:System.TimeZoneInfo.ToSerializedString%2A> メソッドを呼び出して、タイム ゾーンのデータを含む文字列を作成します。  
+  
+3.  .resx ファイルの名前、および必要に応じてファイルへのパスを <xref:System.IO.StreamWriter> クラスのコンストラクターに渡して、<xref:System.IO.StreamWriter> オブジェクトをインスタンス化します。  
+  
+4.  <xref:System.IO.StreamWriter> オブジェクトを <xref:System.Resources.ResXResourceWriter> クラスのコンストラクターに渡して、<xref:System.Resources.ResXResourceWriter> オブジェクトをインスタンス化します。  
+  
+5.  タイム ゾーンのシリアル化された文字列を、<xref:System.Resources.ResXResourceWriter.AddResource%2A?displayProperty=fullName> メソッドに渡します。  
+  
+6.  <xref:System.Resources.ResXResourceWriter.Generate%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+7.  <xref:System.Resources.ResXResourceWriter.Close%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+8.  <xref:System.IO.StreamWriter.Close%2A> メソッドを呼び出して、<xref:System.IO.StreamWriter> オブジェクトを閉じます。  
+  
+9. 生成された .resx ファイルを、アプリケーションの Visual Studio プロジェクトに追加します。  
+  
+10. Visual Studio の **\[プロパティ\]** ウィンドウを使用して、.resx ファイルの **\[ビルド アクション\]** プロパティが **\[埋め込まれたリソース\]** に設定されていることを確認します。  
+  
+## 使用例  
+ 次の例では、中部標準時を表す <xref:System.TimeZoneInfo> オブジェクトと、Palmer Station, Antarctica 時刻を表す <xref:System.TimeZoneInfo> オブジェクトを、SerializedTimeZones.resx という名前の .NET XML リソース ファイルにシリアル化します。  普通、中部標準時はレジストリで定義されています。Palmer Station, Antarctica はカスタム タイム ゾーンです。  
+  
+ [!code-csharp[TimeZone2.Serialization#1](../../../samples/snippets/csharp/VS_Snippets_CLR/TimeZone2.Serialization/cs/SerializeTimeZoneData.cs#1)]
+ [!code-vb[TimeZone2.Serialization#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/TimeZone2.Serialization/vb/SerializeTimeZoneData.vb#1)]  
+  
+ この例では、コンパイル時にリソース ファイルで使用できるように <xref:System.TimeZoneInfo> オブジェクトをシリアル化します。  
+  
+ <xref:System.Resources.ResXResourceWriter.Generate%2A?displayProperty=fullName> メソッドは完全なヘッダー情報を .NET XML リソース ファイルに追加するので、既存のファイルにリソースを追加するためには使用できません。  この例では、SerializedTimeZones.resx ファイルを検査することでこのことに対処しています。ファイルが存在する場合は、シリアル化した 2 つのタイム ゾーン以外のすべてのリソースを、汎用の <xref:System.Collections.Generic.Dictionary%602> オブジェクトに格納します。  その後、既存のファイルを削除し、既存のリソースを新しい SerializedTimeZones.resx ファイルに追加します。  シリアル化したタイム ゾーンのデータも、このファイルに追加します。  
+  
+ リソースのキー \(つまり **\[名前\]**\) フィールドでは、空白を含む文字列は指定できません。  タイム ゾーン識別子をリソース ファイルに割り当てる前に、<xref:System.String.Replace%28System.String%2CSystem.String%29> メソッドを呼び出して識別子に含まれるすべての空白を除去します。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Windows.Forms.dll および System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   次の名前空間をインポートする。  
+  
+     [!code-csharp[TimeZone2.Serialization#2](../../../samples/snippets/csharp/VS_Snippets_CLR/TimeZone2.Serialization/cs/SerializeTimeZoneData.cs#2)]
+     [!code-vb[TimeZone2.Serialization#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/TimeZone2.Serialization/vb/SerializeTimeZoneData.vb#2)]  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [タイム ゾーンの概要](../../../docs/standard/datetime/time-zone-overview.md)   
+ [方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/saving-and-restoring-time-zones.md b/docs/standard/datetime/saving-and-restoring-time-zones.md
new file mode 100644
index 00000000000..d56c175e08e
--- /dev/null
+++ b/docs/standard/datetime/saving-and-restoring-time-zones.md
@@ -0,0 +1,73 @@
+---
+title: "タイム ゾーンの保存と復元 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "逆シリアル化 [.NET Framework], タイム ゾーン"
+  - "復元 (タイム ゾーンを)"
+  - "保存 (タイム ゾーンを)"
+  - "シリアル化 [.NET Framework], タイム ゾーン"
+  - "タイム ゾーン オブジェクト [.NET Framework], 逆シリアル化"
+  - "タイム ゾーン オブジェクト [.NET Framework], 復元"
+  - "タイム ゾーン オブジェクト [.NET Framework], 保存"
+  - "タイム ゾーン オブジェクト [.NET Framework], シリアル化"
+  - "タイム ゾーン [.NET Framework], 復元"
+  - "タイム ゾーン [.NET Framework], 保存"
+ms.assetid: 4028b310-e7ce-49d4-a646-1e83bfaf6f9d
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# タイム ゾーンの保存と復元
+<xref:System.TimeZoneInfo> クラスは、レジストリを利用して、定義されているタイム ゾーン データを取得します。  ただし、レジストリは動的な構造です。  さらに、レジストリに格納されているタイム ゾーンの情報は、主として、現在の年の時刻の調整と変換を行うためにオペレーティング システムによって使用されます。  このため、正確なタイム ゾーン データに依存するアプリケーションには 2 つの大きな影響があります。  
+  
+-   アプリケーションが必要とするタイム ゾーンが、レジストリで定義されていない、レジストリで名前が変更されている、またはレジストリから削除されている可能性があります。  
+  
+-   レジストリで定義されているタイム ゾーンに、過去のタイム ゾーンの変換に必要な特定の調整ルールに関する情報が含まれない可能性があります。  
+  
+ <xref:System.TimeZoneInfo> クラスは、これらの制約に対処するため、タイム ゾーン データのシリアル化 \(保存\) と逆シリアル化 \(復元\) をサポートします。  
+  
+## タイム ゾーンのシリアル化と逆シリアル化  
+ タイム ゾーン データのシリアル化と逆シリアル化によるタイム ゾーンの保存と復元に関係するメソッド呼び出しは 2 つだけです。  
+  
+-   <xref:System.TimeZoneInfo> オブジェクトをシリアル化するには、オブジェクトの <xref:System.TimeZoneInfo.ToSerializedString%2A> メソッドを呼び出します。  このメソッドはパラメーターを受け取らず、タイム ゾーン情報が格納された文字列を返します。  
+  
+-   シリアル化された文字列から <xref:System.TimeZoneInfo> オブジェクトを逆シリアル化するには、その文字列を `static` \(Visual Basic では `Shared`\) <xref:System.TimeZoneInfo.FromSerializedString%2A?displayProperty=fullName> メソッドに渡します。  
+  
+## シリアル化と逆シリアル化のシナリオ  
+ <xref:System.TimeZoneInfo> オブジェクトを文字列に保存 \(シリアル化\) し、後で使用するときに復元 \(逆シリアル化\) できると、<xref:System.TimeZoneInfo> クラスの実用性と柔軟性が向上します。  このセクションでは、シリアル化と逆シリアル化が最も役に立ついくつかの状況を調べます。  
+  
+### アプリケーションでのタイム ゾーン データのシリアル化と逆シリアル化  
+ シリアル化されたタイム ゾーンは、必要に応じて文字列から復元できます。  レジストリから取得したタイム ゾーンが特定の日付範囲内の日時を正しく変換できない場合は、アプリケーションでこれを行うことがあります。  たとえば、Windows XP のレジストリのタイム ゾーン データは単一の調整規則をサポートしますが、Windows Vista のレジストリで定義されているタイム ゾーンは通常 2 つの調整規則についての情報を提供します。  つまり、過去の時刻変換が正しく行われない可能性があります。  タイム ゾーン データのシリアル化と逆シリアル化により、このような制約に対処できます。  
+  
+ 次の例では、米国の中部標準時ゾーンが導入される前に 1883 ~ 1917 年まで米国東部標準時タイム ゾーンを表すように、調整規則のない <xref:System.TimeZoneInfo> のカスタム クラスを定義します。  このカスタム タイム ゾーンを、グローバル スコープを持つ変数にシリアル化します。  タイム ゾーン変換メソッド `ConvertUtcTime` に世界協定時刻 \(UTC\) を渡して変換します。  1917 年以前の日時の場合は、カスタム東部標準時ゾーンがシリアル化された文字列から復元されて、レジストリから取得されたタイム ゾーンの代わりに使用されます。  
+  
+ [!code-csharp[System.TimeZone2.Serialization.1#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Serialization.1/cs/Serialization.cs#1)]
+ [!code-vb[System.TimeZone2.Serialization.1#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Serialization.1/vb/Serialization.vb#1)]  
+  
+### タイム ゾーンの例外の処理  
+ レジストリは動的な構造なので、その内容は偶然に、または意図的に変更される可能性があります。  タイム ゾーンはレジストリで定義されている必要があり、アプリケーションの正常な実行に必要ですが、つまり、これが存在しなくなる可能性があります。  タイム ゾーンのシリアル化と逆シリアル化がサポートされていないと、<xref:System.TimeZoneNotFoundException> が発生した場合は、アプリケーションを終了してこれを処理するしか方法がありません。  一方、タイム ゾーンのシリアル化と逆シリアル化を使用すると、予期しない <xref:System.TimeZoneNotFoundException> が発生しても、シリアル化された文字列から必要なタイム ゾーンを復元することで対処でき、アプリケーションは実行を継続できます。  
+  
+ 次の例では、カスタムの中部標準時ゾーンを作成してシリアル化します。  その後、レジストリから中部標準時ゾーンの取得を試みます。  取得操作で <xref:System.TimeZoneNotFoundException> または <xref:System.InvalidTimeZoneException> がスローされる場合は、例外ハンドラーがタイム ゾーンを逆シリアル化します。  
+  
+ [!code-csharp[System.TimeZone2.Serialization.2#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.TimeZone2.Serialization.2/cs/Serialization2.cs#1)]
+ [!code-vb[System.TimeZone2.Serialization.2#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.TimeZone2.Serialization.2/vb/Serialization2.vb#1)]  
+  
+### シリアル化した文字列の格納と必要時の復元  
+ 前の例では、タイム ゾーン情報を文字列変数に格納し、必要ときはこれを復元しました。  ただし、シリアル化されたタイム ゾーン情報を格納している文字列自体は、外部ファイル、アプリケーションに埋め込まれたリソース ファイル、レジストリなどストレージ メディアに格納できます \(カスタム タイム ゾーンに関する情報は、レジストリではシステムのタイム ゾーン キーとは別に格納する必要があります\)。  
+  
+ シリアル化されたタイム ゾーン文字列をこの方法で格納すると、タイム ゾーン作成ルーチンもアプリケーション自体とは別になります。  たとえば、タイム ゾーン作成ルーチンは、アプリケーションが使用できる過去のタイム ゾーンの履歴情報を格納するデータ ファイルを実行および作成できます。  データ ファイルは、アプリケーションと共にインストールできます。また、アプリケーションでタイム ゾーンが必要になったときは、データ ファイルを開き、格納されている 1 つ以上のタイム ゾーンを逆シリアル化できます。  
+  
+ 埋め込みリソースを使用してシリアル化されたタイム ゾーン データを格納する例については、「[方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)」および「[方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)」を参照してください。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/time-zone-overview.md b/docs/standard/datetime/time-zone-overview.md
index bb8d5c0a6d3..9fd513da5f5 100644
--- a/docs/standard/datetime/time-zone-overview.md
+++ b/docs/standard/datetime/time-zone-overview.md
@@ -1,63 +1,77 @@
 ---
-title: "タイム ゾーンの概要"
-description: "タイム ゾーンの概要"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/16/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: e3a10f62-d403-4441-8621-adc964e32c07
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 200d502d12750a28d2a54058f53b4bbef78973c7
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="time-zone-overview"></a>タイム ゾーンの概要
-
-[System.TimeZoneInfo](xref:System.TimeZoneInfo) クラスを使用すると、タイム ゾーン対応アプリケーションを簡単に作成できます。 [TimeZoneInfo](xref:System.TimeZoneInfo) クラスは、ローカル タイム ゾーンと世界協定時刻 (UTC) での使用をサポートしています。また、レジストリに事前に定義されている情報については、任意のタイム ゾーンを使用できます。 [TimeZoneInfo](xref:System.TimeZoneInfo) を使用して、システムに情報がないカスタムのタイム ゾーンを定義することもできます。
-
-## <a name="time-zone-essentials"></a>タイム ゾーンの基本
-
-タイム ゾーンは、同じ時刻が使用されている地域です。 常にではありませんが、通常、隣接するタイム ゾーンは&1; 時間違いです。 世界のタイム ゾーンの時刻は、世界協定時刻 (UTC) からのオフセットとして表されます。
-
-世界のタイム ゾーンの多くは、夏時間をサポートしています。 夏時間では、春や初夏には時刻を&1; 時間進め、晩夏や秋には通常 (または標準) の時間に戻すことで、日中の時間を最大化しようと試みます。 こうした標準時間前後の変更は、調整規則と呼ばれます。
-
-特定のタイム ゾーンの夏時間前後の移行は、固定調整規則または浮動調整規則で定義できます。 固定調整規則では、毎年、夏時間前後の移行が行われる特定の日付を設定します。 たとえば、毎年 10 月 25 日に行われる夏時間から標準時間への移行は、固定調整規則に従います。 浮動調整規則の方がはるかに一般的です。浮動調整規則では、夏時間への移行、または夏時間からの移行について特定の月の特定の週の特定の曜日が設定されます。 たとえば、3 月の第&3; 日曜日に行われる標準時間から夏時間への移行は、浮動調整規則に従います。
-
-調整規則をサポートするタイム ゾーンの場合、夏時間前後の移行によって、2 つの変則的な時刻が生じます。無効な時刻とあいまいな時刻です。 無効な時刻は、標準時間から夏時間への移行で生じる存在しない時刻です。 たとえば、移行が特定の日付の午前 2:00 に行われ、 時刻が午前 3:00 に変更される場合、午前 2:00 から 午前 2:59:99 までの時刻は 無効です。 あいまいな時刻は、1 つのタイム ゾーンで&2; つの時刻にマップできる時刻です。 あいまいな時刻は夏時間から標準時間への移行で生じます。 たとえば、移行が特定の日付の午前 2:00 に行われ、 時刻が午前 1:00 に変更される場合、午前 1:00 から 午前 1:59:99 までの時刻は 標準時間または夏時間のいずれにでも解釈できます。 
-
-## <a name="time-zone-terminology"></a>タイム ゾーンの用語
-
-次の表は、タイム ゾーンを使用し、タイム ゾーン対応アプリケーションを開発するときに一般的に使用される用語の定義一覧です。
-
-用語 | 定義
----- | ----------
-調整規則 | 標準時間から夏時間へ、および夏時間から標準時間への移行が行われるタイミングを定義した規則。 各調整規則には、規則を適用する期間を定義する開始日と終了日 (たとえば、1986 年 1 月 1 日から 2020 年 12 月 31 日に調整規則が適用されます)、差分 (調整規則を適用した結果として標準時間が変更される時間)、調整期間中に移行が行われる特定の日付と時刻に関する情報が含まれています。 移行は、固定規則または浮動規則に従う可能性があります。
-あいまいな時刻 | 1 つのタイム ゾーンで&2; つの時刻にマップできる時刻です。 あいまいな時刻は、あるタイム ゾーンの夏時間から標準時間に移行する際など、時計の時刻を前に戻すときに発生します。 たとえば、移行が特定の日付の午前 2:00 に行われ、 時刻が午前 1:00 に変更される場合、午前 1:00 から 午前 1:59:99 までの時刻は 標準時間または夏時間のいずれにでも解釈できます。 
-固定規則 | 夏時間前後の移行について特定の日付を設定する調整規則。 たとえば、毎年 10 月 25 日に行われる夏時間から標準時間への移行は、固定調整規則に従います。
-浮動規則 | 浮動調整規則の方がはるかに一般的です。浮動調整規則では、夏時間への移行、または夏時間からの移行について特定の月の特定の週の特定の曜日が設定されます。 たとえば、3 月の第&3; 日曜日に行われる標準時間から夏時間への移行は、浮動調整規則に従います。
-無効な時刻 | 標準時間から夏時間への移行中に生じる存在しない時刻。 無効な時刻は、あるタイム ゾーンの標準時間から夏時間に移行する際など、時計の時刻を前に進めるときに発生します。 たとえば、移行が特定の日付の午前 2:00 に行われ、 時刻が午前 3:00 に変更される場合、午前 2:00 から 午前 2:59:99 までの時刻は 無効です。
-移行時間 | 特定のタイム ゾーンで実施される夏時間と標準時間の切り替えなど、特定の時間切り替えに関する情報。
-
-## <a name="time-zones-and-the-timezoneinfo-class"></a>タイム ゾーンと TimeZoneInfo クラス
-
-.NET の [System.TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトは、オペレーティング システムで提供されている情報に基づいて、タイム ゾーンを表します。 オペレーティング システム上の [TimeZoneInfo](xref:System.TimeZoneInfo) クラスの依存関係は、タイム ゾーン対応アプリケーションが、すべてのオペレーティング システムで特定のタイム ゾーンが定義されていることを特定できないことを示します。 そのため、(ローカルのタイム ゾーンまたは UTC を示すタイム ゾーン以外の) 特定のタイム ゾーンをインスタンス化する場合、例外処理を使用する必要があります。 また、必要な [TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトをインスタンス化できない場合でもアプリケーションを続行できる何らかの方法も用意する必要があります。
-
-各タイム ゾーンは、UTC からのベース オフセットと、既存の調整規則を反映した UTC からのオフセットによって表されるため、あるタイム ゾーンの時刻は、簡単に別のタイム ゾーンの時間に変換できます。 この目的で、[TimeZoneInfo](xref:System.TimeZoneInfo) オブジェクトには、次のようにいくつかの変換メソッドが含まれています。
-
-* [ConvertTime(DateTime, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo))。[System.DateTime](xref:System.DateTime) を特定のタイム ゾーンの時間に変換します。
-
-* [ConvertTime(DateTime, TimeZoneInfo, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo,System.TimeZoneInfo))。[DateTime](xref:System.DateTime) をあるタイム ゾーンから別のタイム ゾーンに変換します。
-
-* [ConvertTime(DateTimeOffset, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTimeOffset,System.TimeZoneInfo))。[System.DateTimeOffset](xref:System.DateTimeOffset) を特定のタイム ゾーンの時間に変換します。 
-
-タイム ゾーン間の時間を変換する方法の詳細については、「[タイム ゾーン間での時刻の変換](converting-between-time-zones.md)」を参照してください。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
+title: "タイム ゾーンの概要 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "調整規則 [.NET Framework]"
+  - "あいまいな時刻 [.NET Framework]"
+  - "夏時間 [.NET Framework]"
+  - "固定規則 [.NET Framework]"
+  - "浮動規則 [.NET Framework]"
+  - "無効な時刻 [.NET Framework]"
+  - "タイム ゾーン [.NET Framework], タイム ゾーンの概要"
+  - "タイム ゾーン [.NET Framework], 作成"
+  - "タイム ゾーン [.NET Framework], 用語"
+  - "TimeZoneInfo クラス, TimeZoneInfo クラスの概要"
+  - "切り替え時刻 [.NET Framework]"
+ms.assetid: c4b7ed01-5e38-4959-a3b6-ef9765d6ccf1
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# タイム ゾーンの概要
+<xref:System.TimeZoneInfo> クラスを使用すると、タイム ゾーンに対応したアプリケーションを簡単に作成できます。  <xref:System.TimeZone> クラスは、ローカル タイム ゾーンと世界協定時刻 \(UTC: Coordinated Universal Time\) の処理をサポートします。  <xref:System.TimeZoneInfo> クラスは、これら両方のゾーンに加えて、レジストリで情報が定義されている任意のタイム ゾーンもサポートします。  また、<xref:System.TimeZoneInfo> を使用すると、システムに情報のないカスタム タイム ゾーンを定義することもできます。  
+  
+## タイム ゾーンの基本事項  
+ タイム ゾーンとは、同じ時間を使用する地理的な領域です。  必ずではありませんが、一般には、隣接するタイム ゾーンの時間差は 1 時間です。  世界のすべてのタイム ゾーンの時刻は、UTC からのオフセットとして表すことができます。  
+  
+ 世界のタイム ゾーンの多くは、夏時間をサポートしています。  夏時間とは、日中の時間を最大にするために、春または初夏に時刻を 1 時間進めて、晩夏または秋に通常の \(標準の\) 時刻に戻すことです。  標準時刻に対するこのような変更は、調整規則と呼ばれます。  
+  
+ 特定のタイム ゾーンにおける夏時間の開始および終了時の切り替えは、固定調整規則または浮動調整規則のいずれかで定義できます。  固定調整規則では、夏時間への切り替えや夏時間からの切り替えを毎年同じ日に行います。  たとえば、夏時間から標準時間への切り替えを毎年 10 月 25 日に行うのは、固定調整規則です。  これよりも一般的なのが浮動調整規則で、特定の月の特定の週の特定の曜日に、夏時間への切り替えや夏時間からの切り替えを行います。  たとえば、標準時間から夏時間への切り替えを、3 月の第 3 日曜日に行うのは、浮動調整規則です。  
+  
+ 調整規則をサポートするタイム ゾーンでは、標準時間と夏時間の切り替えの際に、2 種類の異常な時刻、つまり無効な時刻とあいまいな時刻が発生します。  無効な時刻とは、標準時間から夏時間への切り替えによって発生する、存在しない時刻です。  たとえば、この遷移が発生し、日 2:00 で発生し、午前 3:00 の通常の間隔と午前 2:00 間の 2:59 に変更する時間の場合: 99 の場合は無効です。  あいまいな時刻とは、1 つのタイム ゾーン内の 2 つの異なる時刻に対応する可能性のある時刻です。  このような時刻は、夏時間から標準時間への切り替えによって発生します。  たとえば、この遷移が発生し、日 2:00 で発生し、午前 1:00 の通常の間隔と午前 1:00 間の 1:59 に変更する時間の場合: 99 の場合、標準時か夏時間数として解釈できます。  
+  
+## タイム ゾーンの用語  
+ 次の表では、タイム ゾーンを使用するとき、およびタイム ゾーンに対応するアプリケーションを開発するときによく使用される用語を定義します。  
+  
+|語句|定義|  
+|--------|--------|  
+|調整規則|標準時間から夏時間への切り替え、および夏時間から標準時間への切り替えをいつ行うかを定義する規則。  各調整規則には、規則の適用期間を定義する開始日と終了日 \(たとえば、1986 年 1 月 1 日から 2006 年 12 月 31 日まで適用される調整規則\)、デルタ \(調整規則を適用した結果として標準時間から変化する時間数\)、および調整の期間中に切り替えを行う特定の日時に関する情報が含まれます。  切り替えは、固定規則または浮動規則に従って行うことができます。|  
+|あいまいな時刻|1 つのタイム ゾーン内の 2 つの異なる時刻に対応する可能性のある時刻。  このようなことは、あるタイム ゾーンで夏時間から標準時間に移行する際など、クロック時刻を元に戻すときに発生します。  たとえば、この遷移が発生し、日 2:00 で発生し、午前 1:00 の通常の間隔と午前 1:00 間の 1:59 に変更する時間の場合: 99 の場合、標準時か夏時間数として解釈できます。|  
+|固定規則|夏時間への切り替えまたは夏時間からの切り替えを特定の日付に設定する調整規則。  たとえば、夏時間から標準時間への切り替えを毎年 10 月 25 日に行うのは、固定調整規則です。|  
+|可変規則|夏時間への切り替えまたは夏時間からの切り替えを、特定の月の特定の週の特定の曜日に設定する調整規則。  たとえば、標準時間から夏時間への切り替えを、3 月の第 3 日曜日に行うのは、浮動調整規則です。|  
+|無効な時刻|標準時間から夏時間への切り替えによって発生する、存在しない時刻。  このようなことは、あるタイム ゾーンで標準時間から夏時間に移行する際など、クロック時刻を先に進めるときに発生します。  たとえば、この遷移が発生し、日 2:00 で発生し、午前 3:00 の通常の間隔と午前 2:00 間の 2:59 に変更する時間の場合: 99 の場合は無効です。|  
+|切り替え時間|特定のタイム ゾーンで実施される夏時間と標準時間との間の切り替えなど、特定の時間切り替えに関する情報。|  
+  
+## タイム ゾーンと TimeZoneInfo クラス  
+ .NET Framework では、<xref:System.TimeZoneInfo> オブジェクトがタイム ゾーンを表します。  <xref:System.TimeZoneInfo> クラスに含まれる <xref:System.TimeZoneInfo.GetAdjustmentRules%2A> メソッドは、<xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトの配列を返します。  この配列の各要素は、特定の期間における夏時間の切り替えに関する情報を提供します \(夏時間をサポートしないタイム ゾーンの場合、メソッドは空の配列を返します\)。各 <xref:System.TimeZoneInfo.AdjustmentRule> オブジェクトには <xref:System.TimeZoneInfo.AdjustmentRule.DaylightTransitionStart%2A> プロパティと <xref:System.TimeZoneInfo.AdjustmentRule.DaylightTransitionEnd%2A> プロパティがあり、夏時間への切り替えおよび夏時間からの切り替えを行う特定の日時を定義します。  <xref:System.TimeZoneInfo.TransitionTime.IsFixedDateRule%2A> プロパティは、切り替えが固定か浮動かを示します。  
+  
+ .NET Framework は、Windows オペレーティング システムによって提供されてレジストリに格納されているタイム ゾーン情報に依存します。  地球には多くのタイム ゾーンがあるため、既存の全タイム ゾーンをレジストリで表すことはできません。  さらに、レジストリは動的な構造なので、定義されているタイム ゾーンが追加または削除される場合があります。  そして、レジストリにタイム ゾーンの履歴データが残されているとは限りません。  たとえば、Windows XP では、レジストリには 1 セットのタイム ゾーン調整に関するデータしか格納されません。  Windows Vista では、動的なタイム ゾーン データがサポートされています。つまり、1 つのタイム ゾーンに複数の調整規則を保持することができ、それぞれの規則は特定の年範囲に適用されます。  ただし、Windows Vista のレジストリで定義されていて、夏時間をサポートするほとんどのタイム ゾーンには、1 つまたは 2 つの調整規則しか定義されていません。  
+  
+ <xref:System.TimeZoneInfo> クラスがレジストリに依存するということは、タイム ゾーンに対応するアプリケーションにとって、特定のタイム ゾーンがレジストリで定義されているかどうかは不確定であることを意味します。  したがって、特定のタイム ゾーン \(ローカル タイム ゾーンまたは UTC を表すタイム ゾーンを除く\) をインスタンス化しようとする場合は、例外処理を行う必要があります。  また、必要な <xref:System.TimeZoneInfo> オブジェクトをレジストリからインスタンス化できない場合でも、アプリケーションが動作を続けられるようにするなんらかの手段を用意する必要があります。  
+  
+ 必要なタイム ゾーンがない状況に対応できるように、<xref:System.TimeZoneInfo> クラスには <xref:System.TimeZoneInfo.CreateCustomTimeZone%2A> メソッドが含まれており、レジストリで見つからないカスタム タイム ゾーンを作成するために使用できます。  カスタム タイム ゾーンの作成の詳細については、「[方法 : 調整規則のないタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-without-adjustment-rules.md)」および「[方法 : 調整規則のあるタイム ゾーンを作成する](../../../docs/standard/datetime/create-time-zones-with-adjustment-rules.md)」を参照してください。  さらに、<xref:System.TimeZoneInfo.ToSerializedString%2A> メソッドを使用すると、新しく作成したタイム ゾーンを文字列に変換し、データ ストア \(データベース、テキスト ファイル、レジストリ、アプリケーション リソースなど\) に保存できます。  その後で <xref:System.TimeZoneInfo.FromSerializedString%2A> メソッドを使用して、この文字列を <xref:System.TimeZoneInfo> オブジェクトに変換して戻すことができます。  詳細については、「[方法 : 埋め込みリソースにタイム ゾーンを保存する](../../../docs/standard/datetime/save-time-zones-to-an-embedded-resource.md)」および「[方法 : 埋め込みリソースからタイム ゾーンを復元する](../../../docs/standard/datetime/restore-time-zones-from-an-embedded-resource.md)」を参照してください。  
+  
+ 各タイム ゾーンは、UTC からのベース オフセットおよび既存の調整規則を反映する UTC からのオフセットによって表されるので、あるタイム ゾーンの時刻は、他のタイム ゾーンの時刻に簡単に変換できます。  この目的のため、<xref:System.TimeZoneInfo> オブジェクトには次のような変換メソッドが含まれます。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTimeFromUtc%2A> は、指定したタイム ゾーンの時刻に UTC を変換します。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTimeToUtc%2A> は、指定したタイム ゾーンの時刻を UTC に変換します。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTime%2A> は、指定したあるタイム ゾーンの時刻を、指定した別のタイム ゾーンの時刻に変換します。  
+  
+-   <xref:System.TimeZoneInfo.ConvertTimeBySystemTimeZoneId%2A> は、パラメーターとして \(<xref:System.TimeZoneInfo> オブジェクトではなく\) タイム ゾーン ID を使用し、指定したあるタイム ゾーンの時刻を、指定した別のタイム ゾーンの時刻に変換します。  
+  
+ タイム ゾーン間での時刻の変換の詳細については、「[タイム ゾーン間での時刻の変換](../../../docs/standard/datetime/converting-between-time-zones.md)」を参照してください。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/use-time-zones-in-arithmetic.md b/docs/standard/datetime/use-time-zones-in-arithmetic.md
index e4f52b38866..50768f36d17 100644
--- a/docs/standard/datetime/use-time-zones-in-arithmetic.md
+++ b/docs/standard/datetime/use-time-zones-in-arithmetic.md
@@ -1,174 +1,67 @@
 ---
-title: "方法 : 日付と時刻の演算でタイム ゾーンを使用する"
-description: "方法 : 日付と時刻の演算でタイム ゾーンを使用する"
-keywords: .NET, .NET Core
-author: stevehoag
-ms.author: shoag
-ms.date: 08/16/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 26870cdc-1709-4978-831b-ff2a2f24856f
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: a86471972d42adcbc412cc8eeb300410ca8a9c42
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="how-to-use-time-zones-in-date-and-time-arithmetic"></a>方法 : 日付と時刻の演算でタイム ゾーンを使用する
-
-通常、[System.DateTimeOffset](xref:System.DateTimeOffset) の値を使用して日付と時刻の演算を実行するときに、結果にはタイム ゾーンの調整規則が反映されません。 これは、日時の値のタイム ゾーンを明確に識別できる場合でも同じです。 この記事では、特定のタイム ゾーンに属する日時の値の算術演算を実行する方法について説明します。 算術演算の結果には、タイム ゾーンの調整規則が反映されます。
-
-## <a name="to-apply-adjustment-rules-to-date-and-time-arithmetic"></a>日付と時刻の演算に調整規則を適用するには
-
-1. なんらかの方法を実装して、日付と時刻の値と、その値が属するタイム ゾーンを密接に結び付けます。 たとえば、日付と時刻の値とそのタイム ゾーンの両方を含む構造体を宣言します。 次の例では、この方法を使用して [DateTimeOffset](xref:System.DateTimeOffset) の値とそのタイム ゾーンをリンクします。
-
-    ```csharp
-    // Define a structure for DateTime values for internal use only
-    internal struct TimeWithTimeZone
-    {
-    TimeZoneInfo TimeZone;
-    DateTimeOffset Time;
-    }
-    ```
-
-    ```vb
-    ' Define a structure for DateTime values for internal use only
-    Friend Structure TimeWithTimeZone
-       Dim TimeZone As TimeZoneInfo
-       Dim Time As Date
-    End Structure
-    ```
-    
-2. [TimeZoneInfo.ConvertTime(DateTime, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo)) メソッドを呼び出して、時刻を世界協定時刻 (UTC) に変換します。
-
-3. UTC 時刻で算術演算を実行します。
-
-4. [TimeZoneInfo.ConvertTime(DateTime, TimeZoneInfo)](xref:System.TimeZoneInfo.ConvertTime(System.DateTime,System.TimeZoneInfo)) メソッドを呼び出して、時刻を UTC から元の時刻に関連付けられているタイム ゾーンに変換します。 
-
-## <a name="example"></a>例
-
-次の例では、中部標準時の 2008 年 3 月 9 日午前 1 時 30 分に、2 時間 30 分を 加えます。 夏時間へのタイム ゾーンの切り替えは、30 分後の 2008 年 3 月 9 日午前 2 時に 発生します。 この例は前に示した 4 つの手順に従うため、結果は正しい時刻である 2008 年 3 月 9 日午前 5 時に なります。 
-
-```csharp
-using System;
-
-public struct TimeZoneTime
-{
-   public TimeZoneInfo TimeZone;
-   public DateTimeOffset Time;
-
-   public TimeZoneTime(TimeZoneInfo tz, DateTimeOffset time)
-   {
-      if (tz == null) 
-         throw new ArgumentNullException("The time zone cannot be a null reference.");
-
-      this.TimeZone = tz;
-      this.Time = time;   
-   }
-
-   public TimeZoneTime AddTime(TimeSpan interval)
-   {
-      // Convert time to UTC
-      DateTimeOffset utcTime = TimeZoneInfo.ConvertTime(this.Time, TimeZoneInfo.Utc);      
-      // Add time interval to time
-      utcTime = utcTime.Add(interval);
-      // Convert time back to time in time zone
-      return new TimeZoneTime(this.TimeZone, TimeZoneInfo.ConvertTime(utcTime, this.TimeZone));
-   }
-}
-
-public class TimeArithmetic
-{
-   public const string tzName = "Central Standard Time";
-
-   public static void Main()
-   {
-      try
-      {
-         TimeZoneTime cstTime1, cstTime2;
-
-         TimeZoneInfo cst = TimeZoneInfo.FindSystemTimeZoneById(tzName);
-         DateTime time1 = new DateTime(2008, 3, 9, 1, 30, 0);          
-         TimeSpan twoAndAHalfHours = new TimeSpan(2, 30, 0);
-
-         cstTime1 = new TimeZoneTime(cst, 
-                        new DateTimeOffset(time1, cst.GetUtcOffset(time1)));
-         cstTime2 = cstTime1.AddTime(twoAndAHalfHours);
-         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, 
-                                                    twoAndAHalfHours.ToString(),  
-                                                    cstTime2.Time);
-      }
-      catch
-      {
-         Console.WriteLine("Unable to find {0}.", tzName);
-      }
-   }
-}
-```
-
-```vb
-Public Structure TimeZoneTime
-   Public TimeZone As TimeZoneInfo
-   Public Time As Date
-
-   Public Sub New(tz As TimeZoneInfo, time As Date)
-      If tz Is Nothing Then _
-         Throw New ArgumentNullException("The time zone cannot be a null reference.")
-
-      Me.TimeZone = tz
-      Me.Time = time
-   End Sub
-
-   Public Function AddTime(interval As TimeSpan) As TimeZoneTime
-      ' Convert time to UTC
-      Dim utcTime As DateTime = TimeZoneInfo.ConvertTimeToUtc(Me.Time, _
-                                                              Me.TimeZone)      
-      ' Add time interval to time
-      utcTime = utcTime.Add(interval)
-      ' Convert time back to time in time zone
-      Return New TimeZoneTime(Me.TimeZone, TimeZoneInfo.ConvertTime(utcTime, _
-                              TimeZoneInfo.Utc, Me.TimeZone))
-   End Function
-End Structure
-
-Module TimeArithmetic
-   Public Const tzName As String = "Central Standard Time"
-
-   Public Sub Main()
-      Try
-         Dim cstTime1, cstTime2 As TimeZoneTime
-
-         Dim cst As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById(tzName)
-         Dim time1 As Date = #03/09/2008 1:30AM#
-         Dim twoAndAHalfHours As New TimeSpan(2, 30, 0)
-
-         cstTime1 = New TimeZoneTime(cst, time1)
-         cstTime2 = cstTime1.AddTime(twoAndAHalfHours)
-
-         Console.WriteLine("{0} + {1} hours = {2}", cstTime1.Time, _
-                                                    twoAndAHalfHours.ToString(), _ 
-                                                    cstTime2.Time)  
-      Catch
-         Console.WriteLine("Unable to find {0}.", tzName)
-      End Try   
-   End Sub   
-End Module
-```
-
-最初に UTC に変換せず、単に [DateTimeOffset](xref:System.DateTimeOffset) 値に対してこの加算を実行すると、結果には正しい時刻が反映されますが、その時刻に対して指定されたタイム ゾーンのオフセットは反映されません。 
-
-[DateTimeOffset](xref:System.DateTimeOffset) 値は、属している可能性のあるどのタイム ゾーンとも関連付けられていません。 タイム ゾーンの調整規則が自動的に適用されるような方法で日付と時刻の演算を実行するには、日付と時刻の値の属するタイム ゾーンがすぐに識別できる状態でなければなりません。 つまり、日時と関連付けられているタイム ゾーンを密に結合する必要があります。 これは、次のようないくつかの方法で行うことができます。
-
-* アプリケーションで使用されるすべての時刻が、特定のタイム ゾーンに属するものと仮定します。 この方法は、適切な場合もありますが、柔軟性が限られ、移植性が制限される可能性もあります。
-
-* 日時と関連付けられているタイム ゾーンを型のフィールドとして組み込むことで、両者を密に結合する型を定義します。 コード例ではこの方法を使用して、日時とタイム ゾーンを&2; つのメンバー フィールドに格納する構造体を定義しています。
-
-## <a name="see-also"></a>関連項目
-
-[日付、時刻およびタイム ゾーン](index.md)
-
-[日付と時刻を使用した算術演算の実行](performing-arithmetic-operations.md)
-
+title: "方法 : 日付と時刻の演算でタイム ゾーンを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/10/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "算術演算 [.NET Framework], 日付と時刻"
+  - "日付 [.NET Framework], 加算と減算"
+  - "タイム ゾーン [.NET Framework], 算術演算"
+ms.assetid: 83dd898d-1338-415d-8cd6-445377ab7871
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 日付と時刻の演算でタイム ゾーンを使用する
+通常、<xref:System.DateTime> 値または <xref:System.DateTimeOffset> 値を使用して日付と時刻の演算を実行するとき、その結果にはタイム ゾーン調整規則は反映されません。  これは、日時の値のタイム ゾーンを明確に識別できる場合 \(<xref:System.DateTime.Kind%2A> プロパティが <xref:System.DateTimeKind> に設定されている場合など\) でも同じです。  このトピックでは、特定のタイム ゾーンに属する日時の値の算術演算を実行する方法について説明します。  算術演算の結果には、タイム ゾーンの調整規則が反映されます。  
+  
+### 日付と時刻の演算に調整規則を適用するには  
+  
+1.  なんらかの方法を実装して、日時の値と、その値が属するタイム ゾーンを密接に結び付ます。  たとえば、日時の値とそのタイム ゾーンの両方を含む構造体を宣言します。  次の例では、この方法を使用して <xref:System.DateTime> 値とそのタイム ゾーンをリンクします。  
+  
+     [!code-csharp[System.DateTimeOffset.Conceptual#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual6.cs#6)]
+     [!code-vb[System.DateTimeOffset.Conceptual#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual6.vb#6)]  
+  
+2.  <xref:System.TimeZoneInfo.ConvertTimeToUtc%2A> メソッドまたは <xref:System.TimeZoneInfo.ConvertTime%2A> メソッドを呼び出して、時刻を世界協定時刻 \(UTC: Coordinated Universal Time\) に変換します。  
+  
+3.  UTC 時刻で算術演算を実行します。  
+  
+4.  <xref:System.TimeZoneInfo.ConvertTime%28System.DateTime%2CSystem.TimeZoneInfo%29?displayProperty=fullName> メソッドを呼び出して、UTC の時刻から、元の時刻に関連付けられたタイム ゾーンの時刻に変換します。  
+  
+## 使用例  
+ 次の例では、中部標準時の 2008 年 3 月 9 日午前 1 時 30 分に、2 時間 30 分を加えます。  夏時間 30 分にタイム ゾーンの移行が 2008 \(3 年 12 月 9 日の午前 2:00 に、後で発生します。  例では、前のセクションに記載されている手順に従って 4 から 2008 年 1 月 3 日 9 時に午前 5:00 と、結果は正しい時刻を報告します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#8](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual8.cs#8)]
+ [!code-vb[System.DateTimeOffset.Conceptual#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual8.vb#8)]  
+  
+ <xref:System.DateTime> 値と <xref:System.DateTimeOffset> 値はどちらも、どのタイム ゾーンとも関連付けられていません。  タイム ゾーンの調整規則が自動的に適用されるような方法で日付と時刻の演算を実行するには、日時の値の属するタイム ゾーンがすぐに識別できる状態であることが必要です。  つまり、日時とそのタイム ゾーンを密に結合する必要があります。  そのためには、次に示すようにいくつかの方法があります。  
+  
+-   アプリケーションで使用されるすべての時刻が、特定のタイム ゾーンに属するものと仮定します。  この方法は、適切な場合もありますが、柔軟性が限られ、移植性が制限される可能性もあります。  
+  
+-   日時とそのタイム ゾーンを型のフィールドとして組み込むことで、両者を密に結合する型を定義します。  このコード例では、この方法を使用して、日時とタイム ゾーンを 2 つのメンバー フィールドに格納する構造体を定義しています。  
+  
+ この例は、タイム ゾーンの調整規則が結果に適用されるように <xref:System.DateTime> 値の算術演算を実行する方法を示しています。  ただし、<xref:System.DateTimeOffset> 値も同じように簡単に使用できます。  次の例では、<xref:System.DateTime> 値の代わりに <xref:System.DateTimeOffset> を使用するように、元の例のコードを適合させる方法を示します。  
+  
+ [!code-csharp[System.DateTimeOffset.Conceptual#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/cs/Conceptual6.cs#7)]
+ [!code-vb[System.DateTimeOffset.Conceptual#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.DateTimeOffset.Conceptual/vb/Conceptual6.vb#7)]  
+  
+ 最初に UTC に変換せず、単純に <xref:System.DateTimeOffset> 値に対してこの加算を実行すると、結果には正しい時刻が反映されますが、その時刻に対して指定されたタイム ゾーンのオフセットは反映されません。  
+  
+## コードのコンパイル  
+ この例には、次の項目が必要です。  
+  
+-   System.Core.dll への参照をプロジェクトに追加する。  
+  
+-   <xref:System> 名前空間を `using` ステートメントでインポートする \(C\# のコードで必要\)。  
+  
+## 参照  
+ [日付、時刻、およびタイム ゾーン](../../../docs/standard/datetime/index.md)   
+ [日付と時刻を使用した算術演算の実行](../../../docs/standard/datetime/performing-arithmetic-operations.md)
\ No newline at end of file
diff --git a/docs/standard/datetime/working-with-calendars.md b/docs/standard/datetime/working-with-calendars.md
new file mode 100644
index 00000000000..62ffbf16bc0
--- /dev/null
+++ b/docs/standard/datetime/working-with-calendars.md
@@ -0,0 +1,185 @@
+---
+title: "カレンダーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "予定表, グローバル アプリケーション"
+  - "カルチャ, 予定表"
+  - "グローバル アプリケーション, 予定表"
+  - "グローバリゼーション [.NET Framework], 予定表"
+  - "国際対応のアプリケーション [.NET Framework], 予定表"
+  - "国際対応アプリケーション, 予定表"
+ms.assetid: 0c1534e5-979b-4c8a-a588-1c24301aefb3
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# カレンダーの使用
+日時の値は特定の時点を表しますが、その文字列形式はカルチャに依存し、特定のカルチャで日時の値の表示に使用される規則と、そのカルチャで使用される暦の両方に応じて決まります。  このトピックでは、.NET Framework でサポートされる暦を紹介し、Calendar クラスを使用した日付の値の操作について説明します。  
+  
+## .NET Framework の暦  
+ .NET Framework の暦はすべて、基本の暦の実装を提供する <xref:System.Globalization.Calendar?displayProperty=fullName> クラスから派生します。  <xref:System.Globalization.Calendar> クラスを継承するクラスの 1 つに <xref:System.Globalization.EastAsianLunisolarCalendar> クラスがあります。これは、すべての太陰太陽暦の基本クラスです。  .NET Framework には、次の暦の実装が含まれています。  
+  
+-   <xref:System.Globalization.ChineseLunisolarCalendar>。中国の太陰太陽暦を表します。  
+  
+-   <xref:System.Globalization.GregorianCalendar>。グレゴリオ暦を表します。  この暦は、<xref:System.Globalization.GregorianCalendarTypes?displayProperty=fullName> 列挙体で定義されるサブタイプ \(アラビア語や中東フランス語など\) にさらに分けられます。  <xref:System.Globalization.GregorianCalendar.CalendarType%2A?displayProperty=fullName> プロパティは、グレゴリオ暦のサブタイプを指定します。  
+  
+-   <xref:System.Globalization.HebrewCalendar>。ヘブライ暦を表します。  
+  
+-   <xref:System.Globalization.HijriCalendar>。回教暦を表します。  
+  
+-   <xref:System.Globalization.JapaneseCalendar>。和暦を表します。  
+  
+-   <xref:System.Globalization.JapaneseLunisolarCalendar>。日本の太陰太陽暦を表します。  
+  
+-   <xref:System.Globalization.JulianCalendar>。ユリウス暦を表します。  
+  
+-   <xref:System.Globalization.KoreanCalendar>。韓国暦を表します。  
+  
+-   <xref:System.Globalization.KoreanLunisolarCalendar>。韓国の太陰太陽暦を表します。  
+  
+-   <xref:System.Globalization.PersianCalendar>。ペルシャ暦を表します。  
+  
+-   <xref:System.Globalization.TaiwanCalendar>。台湾暦を表します。  
+  
+-   <xref:System.Globalization.TaiwanLunisolarCalendar>。台湾の太陰太陽暦を表します。  
+  
+-   <xref:System.Globalization.ThaiBuddhistCalendar>。タイ仏暦を表します。  
+  
+-   <xref:System.Globalization.UmAlQuraCalendar>。ウムアルクラ暦を表します。  
+  
+ 暦は、次の 2 とおりの方法で使用できます。  
+  
+-   特定のカルチャで使用される暦として使用する。  <xref:System.Globalization.CultureInfo> オブジェクトにはそれぞれ、現在の暦 \(オブジェクトで現在使用している暦\) があります。  あらゆる日付と時刻の値の文字列形式には、現在のカルチャとその現在の暦が自動的に反映されます。  通常、現在の暦は、カルチャの既定の暦になります。  <xref:System.Globalization.CultureInfo> オブジェクトには、それ以外に、オプションの暦 \(そのカルチャで使用できるその他の暦\) も含まれています。  
+  
+-   特定のカルチャに依存しないスタンドアロンの暦として使用する。  この場合、暦が反映された値として日付を表すには、<xref:System.Globalization.Calendar> のメソッドを使用します。  
+  
+ <xref:System.Globalization.ChineseLunisolarCalendar>、<xref:System.Globalization.JapaneseLunisolarCalendar>、<xref:System.Globalization.JulianCalendar>、<xref:System.Globalization.KoreanLunisolarCalendar>、<xref:System.Globalization.PersianCalendar>、および <xref:System.Globalization.TaiwanLunisolarCalendar> の 6 つの Calendar クラスは、スタンドアロンの暦としてのみ使用できます。  これらは、どのカルチャでも、既定の暦またはオプションの暦としては使用されません。  
+  
+## 暦とカルチャ  
+ 各カルチャには既定の暦があり、<xref:System.Globalization.CultureInfo.Calendar%2A?displayProperty=fullName> プロパティで定義されます。  <xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> プロパティは、特定のカルチャでサポートされるすべての暦を指定する <xref:System.Globalization.Calendar> オブジェクトの配列を返します。これには、そのカルチャの既定の暦も含まれます。  
+  
+ <xref:System.Globalization.CultureInfo.Calendar%2A?displayProperty=fullName> プロパティと <xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> プロパティの例を次に示します。  この例では、タイ語 \(タイ\) と日本語 \(日本\) のカルチャの `CultureInfo` オブジェクトをそれぞれ作成し、それらの既定の暦とオプションの暦を表示します。  どちらについても、カルチャの既定の暦は <xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> コレクションにも含まれます。  
+  
+ [!code-csharp[Conceptual.Calendars#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/calendarinfo1.cs#1)]
+ [!code-vb[Conceptual.Calendars#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/calendarinfo1.vb#1)]  
+  
+ 特定の <xref:System.Globalization.CultureInfo> オブジェクトで現在使用されている暦は、カルチャの <xref:System.Globalization.DateTimeFormatInfo.Calendar%2A?displayProperty=fullName> プロパティで定義されます。  カルチャの <xref:System.Globalization.DateTimeFormatInfo> オブジェクトは、<xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティから返されます。  カルチャの作成時の既定値は <xref:System.Globalization.CultureInfo.Calendar%2A?displayProperty=fullName> プロパティの値と同じですが、  カルチャの現在の暦は、<xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> プロパティから返される配列に含まれる任意の暦に変更することができます。  現在の暦を <xref:System.Globalization.CultureInfo.OptionalCalendars%2A?displayProperty=fullName> プロパティの値に含まれない暦に設定しようとすると、<xref:System.ArgumentException> がスローされます。  
+  
+ アラビア語 \(サウジアラビア\) のカルチャで使用する暦を変更する例を次に示します。  まず、<xref:System.DateTime> 値をインスタンス化し、現在のカルチャ \(この例では英語 \(米国\)\) と現在のカルチャの暦 \(この例ではグレゴリオ暦\) を使用して日付を表示します。  次に、現在のカルチャをアラビア語 \(サウジアラビア\) に変更し、そのカルチャの既定のウムアルクラ暦を使用して日付を表示します。  さらに、`CalendarExists` メソッドを呼び出して、アラビア語 \(サウジアラビア\) のカルチャで回教暦がサポートされているかどうかを判別します。  この暦はサポートされているため、現在の暦を回教暦に変更し、日付をもう一度表示します。  いずれの場合も、日付は、現在のカルチャの現在の暦を使用して表示されます。  
+  
+ [!code-csharp[Conceptual.Calendars#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/changecalendar2.cs#2)]
+ [!code-vb[Conceptual.Calendars#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/changecalendar2.vb#2)]  
+  
+## 日付と暦  
+ <xref:System.Globalization.Calendar> 型のパラメーターを含み、指定した暦の値を日付の要素 \(月、日、および年\) に反映できるコンストラクターは例外として、<xref:System.DateTime> と <xref:System.DateTimeOffset> の値は、どちらも常にグレゴリオ暦に基づきます。  つまり、たとえば <xref:System.DateTime.Year%2A?displayProperty=fullName> プロパティはグレゴリオ暦の年を返し、<xref:System.DateTime.Day%2A?displayProperty=fullName> プロパティはグレゴリオ暦の月の日付を返します。  
+  
+> [!IMPORTANT]
+>  日付の値とその文字列形式で処理が異なることに注意してください。  日付の値はグレゴリオ暦に基づき、文字列形式は特定のカルチャの現在の暦に基づきます。  
+  
+ 次の例は、<xref:System.DateTime> のプロパティと、それに対応する <xref:System.Globalization.Calendar> のメソッドの違いを示しています。  この例では、現在のカルチャはアラビア語 \(エジプト\)、現在の暦はウムアルクラ暦です。  <xref:System.DateTime> 値は、2011 年の 7 番目の月の 15 番目の日に設定されています。  この値は、明らかにグレゴリオ暦の日付と解釈されます。<xref:System.DateTime.ToString%28System.String%2CSystem.IFormatProvider%29?displayProperty=fullName> メソッドでインバリアント カルチャの規則を使用した場合に、これらと同じ値が返されるためです。  現在のカルチャの規則を使用して書式指定された日付の文字列形式は 14\/08\/32 です。これは、この日付に相当するウムアルクラ暦の日付です。  次に、`DateTime` と `Calendar` のメンバーを使用して、<xref:System.DateTime> 値の日、月、および年が返されます。  いずれの場合も、<xref:System.DateTime> のメンバーから返される値にはグレゴリオ暦の値が反映され、<xref:System.Globalization.UmAlQuraCalendar> のメンバーから返される値にはウムアルクラ暦の値が反映されます。  
+  
+ [!code-csharp[Conceptual.Calendars#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/datesandcalendars2.cs#3)]
+ [!code-vb[Conceptual.Calendars#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/datesandcalendars2.vb#3)]  
+  
+### 暦に基づく日付のインスタンス化  
+ <xref:System.DateTime> と <xref:System.DateTimeOffset> の値はグレゴリオ暦に基づくため、別の暦の日、月、または年の値を使用する場合は、<xref:System.Globalization.Calendar> 型のパラメーターを含むオーバーロードされたコンストラクターを呼び出して日付の値をインスタンス化する必要があります。  また、特定の暦の <xref:System.Globalization.Calendar.ToDateTime%2A?displayProperty=fullName> メソッドのいずれかのオーバーロードを呼び出して、特定の暦の値に基づいて <xref:System.DateTime> オブジェクトをインスタンス化することもできます。  
+  
+ 次の例では、<xref:System.Globalization.HebrewCalendar> オブジェクトを <xref:System.DateTime> コンストラクターに渡して 1 つの <xref:System.DateTime> 値をインスタンス化し、<xref:System.Globalization.HebrewCalendar.ToDateTime%28System.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName> メソッドを呼び出してもう 1 つの <xref:System.DateTime> 値をインスタンス化しています。  2 つの値はヘブライ暦の同一の値を使用して作成されるため、<xref:System.DateTime.Equals%2A?displayProperty=fullName> メソッドを呼び出すと、2 つの <xref:System.DateTime> 値が等しいことが示されます。  
+  
+ [!code-csharp[Conceptual.Calendars#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/instantiatehcdate1.cs#4)]
+ [!code-vb[Conceptual.Calendars#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/instantiatehcdate1.vb#4)]  
+  
+### 現在の暦での日付の表現  
+ 日時書式指定メソッドでは、日付を文字列に変換する際に、常に現在の暦を使用します。  つまり、年、月、および日の文字列形式には現在の暦が反映され、必ずしもグレゴリオ暦が反映されるとは限りません。  
+  
+ 次の例は、現在の暦が日付の文字列形式にどのように影響するかを示しています。  この例では、現在のカルチャを中国語 \(繁体字、台湾\) に変更し、日付の値をインスタンス化します。  その後、現在の暦と日付を表示し、現在の暦を <xref:System.Globalization.TaiwanCalendar> に変更して、現在の暦と日付をもう一度表示します。  最初に日付を表示したときは、日付がグレゴリオ暦の日付として表され、  2 回目に表示したときは、台湾暦の日付として表されます。  
+  
+ [!code-csharp[Conceptual.Calendars#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/currentcalendar1.cs#5)]
+ [!code-vb[Conceptual.Calendars#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/currentcalendar1.vb#5)]  
+  
+### 現在の暦以外での日付の表現  
+ 特定のカルチャの現在の暦以外の暦を使用して日付を表すには、その <xref:System.Globalization.Calendar> オブジェクトのメソッドを呼び出す必要があります。  たとえば、<xref:System.Globalization.Calendar.GetYear%2A?displayProperty=fullName>、<xref:System.Globalization.Calendar.GetMonth%2A?displayProperty=fullName>、および <xref:System.Globalization.Calendar.GetDayOfMonth%2A?displayProperty=fullName> の各メソッドは、それぞれ年、月、および日を、特定の暦を反映した値に変換します。  
+  
+> [!WARNING]
+>  一部の暦はどのカルチャのオプションの暦にもなっていないため、そのような暦で日付を表す場合は、常に Calendar のメソッドを呼び出す必要があります。  これは、<xref:System.Globalization.EastAsianLunisolarCalendar> クラス、<xref:System.Globalization.JulianCalendar> クラス、および <xref:System.Globalization.PersianCalendar> クラスから派生したすべての暦に当てはまります。  
+  
+ 次の例では、<xref:System.Globalization.JulianCalendar> オブジェクトを使用して、ユリウス暦の 1905 年 1 月 9 日という日付をインスタンス化します。  この日付を既定の暦 \(グレゴリオ暦\) を使用して表示した場合は、1905 年 1 月 22 日と表されます。  <xref:System.Globalization.JulianCalendar> の各メソッドを呼び出すことで、この日付をユリウス暦で表すことができます。  
+  
+ [!code-csharp[Conceptual.Calendars#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/noncurrentcalendar1.cs#6)]
+ [!code-vb[Conceptual.Calendars#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/noncurrentcalendar1.vb#6)]  
+  
+### 暦と日付範囲  
+ 暦でサポートされている最も古い日付は、暦の <xref:System.Globalization.Calendar.MinSupportedDateTime%2A?displayProperty=fullName> プロパティによって示されます。  <xref:System.Globalization.GregorianCalendar> クラスでは、その日付は西暦 0001 年 1 月 1 日 です。.NET Framework の他のほとんどのカレンダーでは、それより後の日付がサポートされています。  暦でサポートされている最も古い日付より前の日付と時刻の値を処理しようとすると、<xref:System.ArgumentOutOfRangeException> 例外がスローされます。  
+  
+ ただし、重要な例外が 1 つあります。  <xref:System.DateTime> オブジェクトと <xref:System.DateTimeOffset> オブジェクトの既定の \(初期化されていない\) 値は、<xref:System.Globalization.GregorianCalendar.MinSupportedDateTime%2A?displayProperty=fullName> 値と同じです。  西暦 0001 年 1 月 1 日をサポートしていない暦でこの日付を書式設定しようとすると、書式指定子を指定しない場合、書式設定メソッドは "G" \(一般の日付と時刻のパターン\) 書式指定子でなく、"s" \(並べ替え可能な日付と時刻のパターン\) 書式指定子を使用します。  その結果、書式設定操作は <xref:System.ArgumentOutOfRangeException> 例外をスローしません。  代わりに、サポートされていない日付を返します。  この問題を、次の例で説明します。この例は、現在のカルチャが日本語 \(日本\) に設定されていれば和暦で、アラビア語 \(エジプト\) に設定されていればウムアルクラ暦で、<xref:System.DateTime.MinValue?displayProperty=fullName> の値を表示します。  また、現在のカルチャを英語 \(米国\) に設定し、これらの各 <xref:System.Globalization.CultureInfo> オブジェクトで <xref:System.DateTime.ToString%28System.IFormatProvider%29?displayProperty=fullName> メソッドを呼び出します。  どの場合も、並べ替え可能な日付と時刻のパターンを使用して、日付が表示されます。  
+  
+ [!code-csharp[Conceptual.Calendars#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/minsupporteddatetime1.cs#11)]
+ [!code-vb[Conceptual.Calendars#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/minsupporteddatetime1.vb#11)]  
+  
+## 時代 \(年号\) の使用  
+ 暦では通常、日付が時代 \(年号\) に分けられます。  ただし、.NET Framework の <xref:System.Globalization.Calendar> クラスでは、暦で定義されるすべての時代 \(年号\) がサポートされているわけではなく、ほとんどの <xref:System.Globalization.Calendar> クラスでは 1 つの時代 \(年号\) しかサポートされていません。  複数の時代 \(年号\) をサポートしているのは、<xref:System.Globalization.JapaneseCalendar> クラスと <xref:System.Globalization.JapaneseLunisolarCalendar> クラスだけです。  
+  
+### 時代 \(年号\) とその名前  
+ .NET Framework では、特定の暦の実装でサポートされる時代 \(年号\) を表す整数が、<xref:System.Globalization.Calendar.Eras%2A?displayProperty=fullName> 配列に逆順で格納されています。  現在の時代 \(年号\) のインデックスは 0 で、複数の時代 \(年号\) をサポートする <xref:System.Globalization.Calendar> クラスの場合は、後に続く各インデックスが前の時代 \(年号\) に対応します。  <xref:System.Globalization.Calendar.Eras%2A?displayProperty=fullName> 配列における現在の時代 \(年号\) のインデックスは、静的な <xref:System.Globalization.Calendar.CurrentEra?displayProperty=fullName> プロパティで定義されます。これは定数であり、値は常に 0 になります。  個々の <xref:System.Globalization.Calendar> クラスには、現在の時代 \(年号\) の値を返す静的フィールドも含まれています。  これらを次の表に示します。  
+  
+|Calendar クラス|現在の時代 \(年号\) のフィールド|  
+|------------------|-------------------------|  
+|<xref:System.Globalization.ChineseLunisolarCalendar>|<xref:System.Globalization.ChineseLunisolarCalendar.ChineseEra>|  
+|<xref:System.Globalization.GregorianCalendar>|<xref:System.Globalization.GregorianCalendar.ADEra>|  
+|<xref:System.Globalization.HebrewCalendar>|<xref:System.Globalization.HebrewCalendar.HebrewEra>|  
+|<xref:System.Globalization.HijriCalendar>|<xref:System.Globalization.HijriCalendar.HijriEra>|  
+|<xref:System.Globalization.JapaneseLunisolarCalendar>|<xref:System.Globalization.JapaneseLunisolarCalendar.JapaneseEra>|  
+|<xref:System.Globalization.JulianCalendar>|<xref:System.Globalization.JulianCalendar.JulianEra>|  
+|<xref:System.Globalization.KoreanCalendar>|<xref:System.Globalization.KoreanCalendar.KoreanEra>|  
+|<xref:System.Globalization.KoreanLunisolarCalendar>|<xref:System.Globalization.KoreanLunisolarCalendar.GregorianEra>|  
+|<xref:System.Globalization.PersianCalendar>|<xref:System.Globalization.PersianCalendar.PersianEra>|  
+|<xref:System.Globalization.ThaiBuddhistCalendar>|<xref:System.Globalization.ThaiBuddhistCalendar.ThaiBuddhistEra>|  
+|<xref:System.Globalization.UmAlQuraCalendar>|<xref:System.Globalization.UmAlQuraCalendar.UmAlQuraEra>|  
+  
+ 特定の時代 \(年号\) を表す数値に対応する名前は、その数値を <xref:System.Globalization.DateTimeFormatInfo.GetEraName%2A?displayProperty=fullName> メソッドまたは <xref:System.Globalization.DateTimeFormatInfo.GetAbbreviatedEraName%2A?displayProperty=fullName> メソッドに渡すことで取得できます。  次の例では、これらのメソッドを呼び出して、<xref:System.Globalization.GregorianCalendar> クラスでサポートされる時代 \(年号\) に関する情報を取得しています。  
+  
+ [!code-csharp[Conceptual.Calendars#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/instantiatewithera1.cs#7)]
+ [!code-vb[Conceptual.Calendars#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/instantiatewithera1.vb#7)]  
+  
+ また、"g" カスタム日時書式指定文字列では、日付と時刻の文字列形式に暦の時代 \(年号\) の名前が含まれます。  詳細については、「[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)」を参照してください。  
+  
+### 時代 \(年号\) を含む日付のインスタンス化  
+ 複数の時代 \(年号\) をサポートする 2 つの <xref:System.Globalization.Calendar> クラスでは、特定の年、月、および日の値で構成される日付があいまいになることがあります。たとえば、<xref:System.Globalization.JapaneseCalendar> では、4 つのすべての時代 \(年号\) に数値が 1 ～ 15 になる年があります。  通常、時代 \(年号\) が指定されていない場合は、日時および暦のどちらのメソッドでも、値が現在の時代 \(年号\) に属すると見なされます。  複数の時代 \(年号\) をサポートする <xref:System.Globalization.Calendar> クラスの日付をインスタンス化するときに時代 \(年号\) を明示的に指定するには、<xref:System.Globalization.Calendar.ToDateTime%28System.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName> メソッドを呼び出します。  このメソッドを使用すると、時代 \(年号\) を、暦の年、月、日、時、分、秒、およびミリ秒と共に明示的に指定できます。  
+  
+ 次の例では、<xref:System.Globalization.Calendar.ToDateTime%28System.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%2CSystem.Int32%29?displayProperty=fullName> メソッドを使用して、<xref:System.Globalization.JapaneseCalendar> クラスでサポートされるそれぞれの時代 \(年号\) の同じ日付 \(2 番目の年の最初の月の最初の日\) をインスタンス化しています。  その後、和暦とグレゴリオ暦の両方で日付を表示しています。  また、この例では <xref:System.DateTime> コンストラクターも呼び出して、時代 \(年号\) を指定せずに日付の値を作成した場合は現在の時代 \(年号\) の日付が作成されることを示しています。  
+  
+ [!code-csharp[Conceptual.Calendars#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/instantiatewithera1.cs#7)]
+ [!code-vb[Conceptual.Calendars#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/instantiatewithera1.vb#7)]  
+  
+### 時代 \(年号\) を含む暦の日付の表現  
+ <xref:System.Globalization.CultureInfo> オブジェクトの現在の暦が、時代 \(年号\) をサポートする <xref:System.Globalization.Calendar> オブジェクトである場合は、完全な日付と時刻、長い日付、および短い日付の各パターンにおいて、日付と時刻の値の文字列形式に時代 \(年号\) が含まれます。  それらの日付パターンを表示する例を次に示します。現在のカルチャは日本 \(日本語\)、現在の暦は和暦です。  
+  
+ [!code-csharp[Conceptual.Calendars#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/formatstrings1.cs#8)]
+ [!code-vb[Conceptual.Calendars#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/formatstrings1.vb#8)]  
+  
+> [!WARNING]
+>  .NET Framework の Calendar クラスの中で、複数の時代 \(年号\) の日付をサポートし、かつ <xref:System.Globalization.CultureInfo> オブジェクトの現在の暦にもできるクラスは、<xref:System.Globalization.JapaneseCalendar> クラスだけです。このクラスは、具体的には、日本語 \(日本\) のカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトの現在の暦にすることができます。  
+  
+ どの暦の場合も、"g" カスタム書式指定子の結果の文字列には時代 \(年号\) が含まれます。  次の例では、"MM\-dd\-yyyy g" というカスタム書式指定文字列を使用して、結果の文字列に時代 \(年号\) を含めています。現在の暦はグレゴリオ暦です。  
+  
+ [!code-csharp[Conceptual.Calendars#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/formatstrings2.cs#9)]
+ [!code-vb[Conceptual.Calendars#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/formatstrings2.vb#9)]  
+  
+ 日付の文字列形式を現在の暦以外の暦で表す場合は、<xref:System.Globalization.Calendar> クラスの <xref:System.Globalization.Calendar.GetEra%2A?displayProperty=fullName> メソッドを <xref:System.Globalization.Calendar.GetYear%2A?displayProperty=fullName>、<xref:System.Globalization.Calendar.GetMonth%2A?displayProperty=fullName>、および <xref:System.Globalization.Calendar.GetDayOfMonth%2A?displayProperty=fullName> の各メソッドと一緒に使用して、日付とそれが属する時代 \(年号\) を明確に示すことができます。  <xref:System.Globalization.JapaneseLunisolarCalendar> クラスを使用した具体的な例を次に示します。  ただし、時代 \(年号\) を表す整数ではなく、名前または省略形を結果の文字列に含めるには、<xref:System.Globalization.DateTimeFormatInfo> オブジェクトをインスタンス化し、その現在の暦を <xref:System.Globalization.JapaneseCalendar> にする必要があります \(<xref:System.Globalization.JapaneseLunisolarCalendar> 暦をカルチャの現在の暦にすることはできませんが、この場合は 2 つの暦で同じ時代 \(年号\) が共有されます\)。  
+  
+ [!code-csharp[Conceptual.Calendars#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.calendars/cs/formatstrings3.cs#10)]
+ [!code-vb[Conceptual.Calendars#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.calendars/vb/formatstrings3.vb#10)]  
+  
+## 参照  
+ [方法 : グレゴリオ暦以外の暦の日付を表示する](../../../docs/standard/base-types/how-to-display-dates-in-non-gregorian-calendars.md)   
+ [サンプル: 暦の週の範囲のユーティリティ](http://code.msdn.microsoft.com/NET-Framework-4-Calendar-3360a84a)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/TOC.md b/docs/standard/design-guidelines/TOC.md
new file mode 100644
index 00000000000..9e2fc984d62
--- /dev/null
+++ b/docs/standard/design-guidelines/TOC.md
@@ -0,0 +1,49 @@
+# [名前付けのガイドライン](naming-guidelines.md)
+# [クラスまたは構造体の選択](choosing-between-class-and-struct.md)
+# [一般的な設計パターン](common-design-patterns.md)
+# [属性](属性.md)
+# [アセンブリと Dll の名前](names-of-assemblies-and-dlls.md)
+# [列挙型デザイン](enum.md)
+# [静的クラスのデザイン](static-class.md)
+# [一般的な名前付け規則](general-naming-conventions.md)
+# [抽象クラスのデザイン](abstract-class.md)
+# [封印](sealing.md)
+# [パラメーターの名前を付ける](naming-parameters.md)
+# [シリアル化](シリアル化.md)
+# [等値演算子](equality-operators.md)
+# [例外のデザイン ガイドライン](exceptions.md)
+# [コンス トラクターのデザイン](constructor.md)
+# [型のメンバーの名前](names-of-type-members.md)
+# [標準の例外の型を使用します。](using-standard-exception-types.md)
+# [プロテクト メンバー](protected-members.md)
+# [名前空間の名前](names-of-namespaces.md)
+# [インターフェイスのデザイン](interface.md)
+# [封印されていないクラス](unsealed-classes.md)
+# [メンバーのオーバー ロード](member-overloading.md)
+# [仮想メンバー](virtual-members.md)
+# [リソースの名前付け](naming-resources.md)
+# [クラス、構造体、およびインターフェイスの名前](names-of-classes-structs-and-interfaces.md)
+# [System.Xml の使用法](system-xml-usage.md)
+# [フィールドのデザイン](field.md)
+# [型デザインのガイドライン](type.md)
+# [イベントのデザイン](event.md)
+# [配列](arrays.md)
+# [Framework デザイン ガイドライン](index.md)
+# [拡張メソッド](extension-methods.md)
+# [例外のスロー](exception-throwing.md)
+# [大文字と小文字の表記規則](capitalization-conventions.md)
+# [イベントとコールバック](events-and-callbacks.md)
+# [使用方法のガイドライン](usage-guidelines.md)
+# [パラメーターのデザイン](parameter-design.md)
+# [例外とパフォーマンス](exceptions-and-performance.md)
+# [抽象化を実装するための基本クラス](base-classes-for-implementing-abstractions.md)
+# [演算子のオーバー ロード](operator-overloads.md)
+# [Dispose パターン](dispose-pattern.md)
+# [コレクション](guidelines-for-collections.md)
+# [依存関係プロパティ](dependency-properties.md)
+# [構造体のデザイン](struct.md)
+# [機能拡張のデザイン](designing-for-extensibility.md)
+# [入れ子にされた型](nested-types.md)
+# [プロパティのデザイン](property.md)
+# [メンバー デザインのガイドライン](member.md)
+# [抽象化 (抽象型とインターフェイス)](abstractions-abstract-types-and-interfaces.md)
diff --git a/docs/standard/design-guidelines/abstract-class.md b/docs/standard/design-guidelines/abstract-class.md
new file mode 100644
index 00000000000..bf84af1e88c
--- /dev/null
+++ b/docs/standard/design-guidelines/abstract-class.md
@@ -0,0 +1,52 @@
+---
+title: "抽象クラスのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "デザインのガイドラインを入力、抽象クラス"
+  - "抽象クラスのデザイン ガイドライン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] クラス"
+  - "抽象クラス [.NET Framework]"
+  - "クラス [.NET Framework] のデザイン ガイドライン"
+  - "クラス型の設計ガイドライン"
+ms.assetid: d3646e6d-5c1f-4922-8fb0-ec5effb30d60
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 抽象クラスのデザイン
+**X のしないで** 抽象型のパブリックまたはプロテクトの内部コンス トラクターを定義します。  
+  
+ コンス トラクターは、ユーザーが型のインスタンスを作成する必要がある場合にのみ、パブリックにする必要があります。 抽象型のインスタンスを作成することはできませんのでパブリック コンス トラクターを持つ抽象型が正しくされていないに設計され、ユーザーに誤解を招きやすい。  
+  
+ **✓ は** 抽象クラス内で、保護されているか、内部コンス トラクターを定義します。  
+  
+ プロテクト コンス トラクターはより一般的なでき、単にサブタイプが作成されるときは、自己の初期化を実行する基本クラスです。  
+  
+ クラスを定義するアセンブリを抽象クラスの具象実装を制限するため、内部コンス トラクターを使用できます。  
+  
+ **✓ は** を出荷するそれぞれの抽象クラスから継承する少なくとも 1 つの具象型を提供します。  
+  
+ これにより、抽象クラスの設計を検証します。 たとえば、  <xref:System.IO.FileStream?displayProperty=fullName> の実装には、 <xref:System.IO.Stream?displayProperty=fullName> 抽象クラスです。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/abstractions-abstract-types-and-interfaces.md b/docs/standard/design-guidelines/abstractions-abstract-types-and-interfaces.md
new file mode 100644
index 00000000000..e63969d109a
--- /dev/null
+++ b/docs/standard/design-guidelines/abstractions-abstract-types-and-interfaces.md
@@ -0,0 +1,52 @@
+---
+title: "抽象化 (抽象型とインターフェイス) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "抽象インターフェイス [.NET Framework]"
+  - "抽象インターフェイス [.NET Framework]"
+  - "抽象型 [.NET Framework]"
+  - "抽象型 [.NET Framework]"
+ms.assetid: 0a632bc7-9b03-44ee-8842-c82f88672a45
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 抽象化 (抽象型とインターフェイス)
+抽象化は、コントラクトの説明がコントラクトの完全な実装を提供しない型です。 抽象化は通常インターフェイスまたは抽象クラスとして実装され適切に定義された一連のコントラクトを実装する型の必要なセマンティクスを説明するリファレンス ドキュメントになります。 .NET Framework で最も重要な抽象化のものが <xref:System.IO.Stream>, 、<xref:System.Collections.Generic.IEnumerable%601>, 、および <xref:System.Object>です。  
+  
+ 抽象化のコントラクトをサポートする具象型を実装して、フレームワーク Api がかかります \(で動作\) でこの具象型を使用してフレームワークを拡張することができます、抽象化します。  
+  
+ 時の試練に耐え得ることが有益な意味のある抽象化は、設計することは困難です。 メインの難易度がこれ以上ない数が減少して、メンバーの適切なセットを取得しています。 抽象化のメンバーが多すぎる場合は、難しいかを実装することが不可能になります。 保証された機能が少なすぎますメンバーが存在、多くの興味深いシナリオで役に立たないになります。  
+  
+ フレームワークで多くの抽象化も低下するために、フレームワークの使いやすさです。 非常に具体的な実装と抽象化で動作している Api の大きい画像に組み込む方法を理解していなくても抽象化を理解しにくいは多くの場合です。 また、抽象化とそのメンバーの名前は必ずしも抽象を多くの場合に暗号のような印象は交え、その使用状況を理解していなくても。  
+  
+ ただし、抽象化は、その他の拡張メカニズムは、多くの場合、一致しないする非常に強力な機能拡張を提供します。 多くのアーキテクチャ パターン、プラグインの中核は制御の反転 \(IoC\)、パイプライン、やなどです。 フレームワークの容易性を高めることが重要です。 適切な抽象化を使用すれば、単体テストするために大量の依存関係を消去できます。 要するに、抽象化は最新のオブジェクト指向フレームワークのいる豊富な機能を担当します。  
+  
+ **X のしないで** いくつかの具体的な実装と抽象化を使用する Api を開発することにより、テストしない抽象化を提供します。  
+  
+ **✓ は** 抽象化を設計するときは、抽象クラスとインターフェイス間慎重に選択します。  
+  
+ **✓ を検討してください** の抽象化の具体的な実装のテストの参照を提供します。 このようなテストは、実装が正しく、コントラクトを実装するかどうかをテストするユーザーを許可する必要があります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/arrays.md b/docs/standard/design-guidelines/arrays.md
new file mode 100644
index 00000000000..fe0b93e8d73
--- /dev/null
+++ b/docs/standard/design-guidelines/arrays.md
@@ -0,0 +1,44 @@
+---
+title: "配列 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 配列"
+  - "配列 [.NET Framework] の使用に関するガイドライン"
+  - "空の配列"
+ms.assetid: 66a1b3d8-6f3f-4715-b235-e1ff95e32d8e
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 配列
+**✓ は** パブリック Api の配列にコレクションの使用を希望します。[コレクション](../../../docs/standard/design-guidelines/guidelines-for-collections.md) セクションでは、コレクションと配列の間での選択方法の詳細を説明します。  
+  
+ **X のしないで** 読み取り専用配列フィールドを使用します。 フィールド自体は読み取り専用と、変更できない配列内の要素を変更することができます。  
+  
+ **✓ を検討してください** 多次元配列ではなくジャグ配列を使用します。  
+  
+ ジャグ配列は、要素も配列を含む配列です。 小さいは無駄な空間データ \(たとえば、スパース マトリックス\) セットによって多次元配列と比較する、さまざまなサイズの要素を構成する配列ができます。 さらに、CLR は、一部のシナリオで、実行時のより優れたパフォーマンスを発生する可能性がありますので、ジャグ配列のインデックス操作を最適化します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ <xref:System.Array>   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/base-classes-for-implementing-abstractions.md b/docs/standard/design-guidelines/base-classes-for-implementing-abstractions.md
new file mode 100644
index 00000000000..3e867244b87
--- /dev/null
+++ b/docs/standard/design-guidelines/base-classes-for-implementing-abstractions.md
@@ -0,0 +1,48 @@
+---
+title: "抽象化を実装するための基本クラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "抽象化 [.NET Framework]"
+  - "基本クラス、抽象化"
+ms.assetid: 37a2d9a4-9721-482a-a40f-eee2c1d97875
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 抽象化を実装するための基本クラス
+厳密に言えば、クラス別のクラスの派生元が、基本クラスになります。 ここでは、ただし、基本クラスは、主に共通の抽象化するため、または一部を再利用するには、他のクラスの既定の実装が継承を目的としたクラス。 基本クラスは、通常、階層のルートに抽象化し、下部にあるいくつかのカスタム実装の間の継承階層の中央に配置できます。  
+  
+ これらは、抽象化を実装するための実装のヘルパーとして機能します。 たとえば、項目の順序付けられたコレクションのフレームワークの抽象化の 1 つは、 <xref:System.Collections.Generic.IList%601> インターフェイスです。 実装する <xref:System.Collections.Generic.IList%601> は重要でとなるため、フレームワーク、複数の基本クラスなど、 <xref:System.Collections.ObjectModel.Collection%601> と <xref:System.Collections.ObjectModel.KeyedCollection%602>, 、カスタム コレクションを実装するためのヘルパーとして機能します。  
+  
+ 基本クラスは通常ありません自体には、抽象化として処理するために適していますが多すぎるの実装を含んでいる傾向があるためです。 たとえば、 `Collection<T>` 基本クラスには、多数非ジェネリックが実装している事実に関係の実装にはが含まれています。 `IList` \(非ジェネリック コレクションをより適切に統合\) へのインターフェイスとそのフィールドのいずれかでメモリに格納された項目のコレクションであるという事実にします。  
+  
+ 既に説明したようには、基本クラスは抽象化を実装する必要があるユーザーに非常に貴重なヘルプを提供することができます、同時に重大な責任を立つことができます。 継承階層の深さを増やしおよびをので概念的には、フレームワークが複雑になる、サーフェス領域を追加します。 そのため、フレームワークのユーザーに大きな価値を提供する場合にのみ、基本クラスを使用してください。 これらを基本クラスから継承する代わりに、内部の実装への委任で大文字を積極的に検討するフレームワークを実装するときにのみ値を提供する場合に避ける必要があります。  
+  
+ **✓ を検討してください** 抽象メンバーが含まれている場合でものための基底クラスの抽象です。 これをユーザーに明確に伝達する、クラスが継承するためだけに設計されています。  
+  
+ **✓ を検討してください** の主要なシナリオの種類から別の名前空間の基本クラスを配置することです。 定義上は、基本クラスは、高度な機能拡張シナリオを想定してし、そのため、大半のユーザーに重要ではありません。  
+  
+ **X 回避** クラスは、パブリック Api で使用する場合に"Base"サフィックスを持つ基本クラスの名前します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/capitalization-conventions.md b/docs/standard/design-guidelines/capitalization-conventions.md
new file mode 100644
index 00000000000..172ada4ebab
--- /dev/null
+++ b/docs/standard/design-guidelines/capitalization-conventions.md
@@ -0,0 +1,119 @@
+---
+title: "大文字と小文字の表記規則 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "camel 形式で名前 [.NET Framework]"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 大文字と小文字"
+  - "Pascal 形式名 [.NET Framework]"
+  - "大文字小文字の区別、大文字と小文字の表記規則"
+  - "大文字と小文字の名前 [.NET Framework]"
+ms.assetid: 4c4ea526-9203-486f-b72d-29d61c5b3c6d
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 大文字と小文字の表記規則
+単純なメソッドを使用するためのこの章のレイアウトのガイドラインの場合、型、メンバー、および読みやすいパラメーターの識別子を作成、一貫した適用時にされます。  
+  
+## 識別子の大文字と小文字の規則  
+ 識別子内の単語を区別するためには、識別子内の各単語の最初の文字を大文字に変換します。 アンダー スコアは、単語を区別するために使用しないでまたは識別子で任意の場所に言えば、します。 識別子の使用によって、識別子の大文字にする 2 つの適切な方法があります。  
+  
+-   Pascal 表記を使用  
+  
+-   camel 表記  
+  
+ パラメーター名以外のすべての識別子に使用する、pascal 表記を使用規則は、次の例に示すように、\(2 文字の長さを頭字語を含む\) の各単語の最初の文字を大文字になります。  
+  
+ `PropertyDescriptor`   
+ `HtmlTag`  
+  
+ 特殊なケースは、次の識別子に示すように、両方の文字を大文字に、2 文字の頭字語に。  
+  
+ `IOStream`  
+  
+ パラメーター名専用に使用される、camel 表記規則では、次の例に示すように、最初の単語以外の各単語の最初の文字が大文字にします。 例に示すも camel 形式の識別子で始まる 2 文字の頭字語は小文字の両方です。  
+  
+ `propertyDescriptor`   
+ `ioStream`   
+ `htmlTag`  
+  
+ **✓ は** pascal 表記を使用を使用して、すべてのパブリック メンバー、型、および名前空間名の複数の単語で構成されます。  
+  
+ **✓ は** パラメーター名の camel 表記を使用します。  
+  
+ 次の表では、さまざまな種類の識別子の大文字と小文字の規則について説明します。  
+  
+|識別子|大文字小文字の区別|例|  
+|---------|---------------|-------|  
+|Namespace|Pascal 形式|`namespace System.Security { ... }`|  
+|型|Pascal 形式|`public class StreamReader { ... }`|  
+|インターフェイス|Pascal 形式|`public interface IEnumerable { ... }`|  
+|メソッド|Pascal 形式|`public class Object {` <br />  `public virtual string ToString();` <br /> `}`|  
+|プロパティ|Pascal 形式|`public class String {` <br />  `public int Length { get; }` <br /> `}`|  
+|イベント|Pascal 形式|`public class Process {` <br />  `public event EventHandler Exited;` <br /> `}`|  
+|フィールド|Pascal 形式|`public class MessageQueue {` <br />  `public static readonly TimeSpan` <br /> `InfiniteTimeout;` <br /> `}` <br /> `public struct UInt32 {` <br />  `public const Min = 0;` <br /> `}`|  
+|列挙値|Pascal 形式|`public enum FileMode {` <br />  `Append,` <br />  `...` <br /> `}`|  
+|パラメーター|キャメル形式|`public class Convert {` <br />  `public static int ToInt32(string value);` <br /> `}`|  
+  
+## 複合語の大文字と一般的な用語  
+ ほとんどの複合語は、大文字と小文字の単語として扱われます。  
+  
+ **X のしないで** いわゆる閉じた形式の複合語の各単語を大文字に変換します。  
+  
+ これらは、複合語がエンドポイントなどの 1 つの単語として書き込まれます。 大文字と小文字のガイドライン、するためには、1 つの単語として閉じた形式の複合語を扱います。 複合語が閉形式で記述されたかどうかを判断するのにには、現在の辞書を使用します。  
+  
+|Pascal 形式|キャメル形式|Not|  
+|---------------|------------|---------|  
+|`BitFlag`|`bitFlag`|`Bitflag`|  
+|`Callback`|`callback`|`CallBack`|  
+|`Canceled`|`canceled`|`Cancelled`|  
+|`DoNot`|`doNot`|`Don't`|  
+|`Email`|`email`|`EMail`|  
+|`Endpoint`|`endpoint`|`EndPoint`|  
+|`FileName`|`fileName`|`Filename`|  
+|`Gridline`|`gridline`|`GridLine`|  
+|`Hashtable`|`hashtable`|`HashTable`|  
+|`Id`|`id`|`ID`|  
+|`Indexes`|`indexes`|`Indices`|  
+|`LogOff`|`logOff`|`LogOut`|  
+|`LogOn`|`logOn`|`LogIn`|  
+|`Metadata`|`metadata`|`MetaData, metaData`|  
+|`Multipanel`|`multipanel`|`MultiPanel`|  
+|`Multiview`|`multiview`|`MultiView`|  
+|`Namespace`|`namespace`|`NameSpace`|  
+|`Ok`|`ok`|`OK`|  
+|`Pi`|`pi`|`PI`|  
+|`Placeholder`|`placeholder`|`PlaceHolder`|  
+|`SignIn`|`signIn`|`SignOn`|  
+|`SignOut`|`signOut`|`SignOff`|  
+|`UserName`|`userName`|`Username`|  
+|`WhiteSpace`|`whiteSpace`|`Whitespace`|  
+|`Writable`|`writable`|`Writeable`|  
+  
+## 大文字と小文字の区別  
+ CLR で実行できる言語は、いくつかが、大文字小文字の区別をサポートするために必要はありません。 でも、言語サポートする場合、他の言語、フレームワークにアクセスする可能性を持っていません。 したがって、外部アクセス可能なすべての Api は、同じコンテキストで 2 つの名前を区別するためだけの場合に使用できません。  
+  
+ **X のしないで** すべてのプログラミング言語が大文字小文字を区別と見なされます。 できません。 名前は、単独で大文字と小文字が異なることはできません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/choosing-between-class-and-struct.md b/docs/standard/design-guidelines/choosing-between-class-and-struct.md
new file mode 100644
index 00000000000..82c6d020298
--- /dev/null
+++ b/docs/standard/design-guidelines/choosing-between-class-and-struct.md
@@ -0,0 +1,68 @@
+---
+title: "クラスまたは構造体の選択 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 構造体"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] クラス"
+  - "クラスと構造体 [.NET Framework]"
+  - "クラス [.NET Framework] のデザイン ガイドライン"
+  - "型のデザインのガイドライン、構造体"
+  - "構造体 [.NET Framework] のデザイン ガイドライン"
+  - "および構造体、クラス [.NET Framework]"
+  - "クラス型の設計ガイドライン"
+ms.assetid: f8b8ec9b-0ba7-4dea-aadf-a93395cd804f
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# クラスまたは構造体の選択
+すべての framework デザイナーに直面基本的な設計上の決定の 1 つは、クラス \(参照型\)、または構造体 \(値型\) として型を設計するかどうかです。 参照型と値の型の動作の違いをよく理解は、この選択を行うに不可欠です。  
+  
+ 参照型と検討します。 値の型の最初の違いは参照型が、ガベージ コレクション ヒープに割り当てられている値の型はスタックまたは型を含むにインラインで割り当てられ、スタックがアンワインドされるときに割り当て解除は、またはその親の型が割り当て解除されたを取得します。 したがって、値型の割り当てと解放は、一般的な参照型の割り当てと解放より安価では。  
+  
+ 次に、参照型の配列ではの不一致、つまり、配列要素に、ヒープ上に存在する参照型のインスタンスへの参照のみが割り当てられます。 値型の配列には、インライン、つまり配列の要素が値型の実際のインスタンスが割り当てられます。 そのため、値型の配列の割り当てと解放は参照型の配列の割り当てと解放よりもかなり安価です。 さらに、ほとんどの場合は、値型の配列と、参照の局所性程度が高くが発生します。  
+  
+ 次の相違点は、メモリ使用量に関連します。 値型にボックス化を実装するインターフェイスの 1 つまたは参照型にキャストされるときです。 ボックス化解除された得られる値の型にキャストするとき。 ボックスが、ヒープ上に割り当てられたされガベージ コレクション、あまりボックス化とボックス化解除されるオブジェクトであるため、ヒープ、ガベージ コレクターと最終的には、アプリケーションのパフォーマンスに影響を及ぼすことができます。  これに対し、このようなボックス化は行われませんように参照型にキャストされます。  
+  
+ 次に、参照型の割り当ては、値型の割り当て値全体をコピーする一方、参照をコピーします。 そのため、大規模な参照型の割り当てでは、大きな値の型の割り当てより安価です。  
+  
+ 最後に、値によって渡される値型は、参照型は、参照によって渡されます。 参照型のインスタンスへの変更では、インスタンスを指すすべての参照に影響します。 値型のインスタンスは、値によって渡されるときにコピーされます。 値型のインスタンスが変更されたときに、もちろんは変わりませんは、そのコピーのいずれか。 コピーがユーザーによって明示的に作成されませんが、引数が渡されるまたは返される値を返すときに暗黙的に作成されたであるために、変更可能な値の型は多くのユーザーが混乱することができます。 そのため、値型は変更できません。  
+  
+ 経験上、として、framework の型の大部分は、クラスをする必要があります。 ただし、状況によっては、値型の特性やすく構造体を使用した方が適切があります。  
+  
+ **✓ を検討してください** 型のインスタンスが小型でよく有効期間の短い、またはその他のオブジェクトに埋め込まれている一般的場合は、クラスの代わりに構造体を定義することです。  
+  
+ **X 回避** 型にすべての次の特性がある存在しない限り、構造体を定義します。  
+  
+-   プリミティブ型のような単一の値を論理的に表す \(`int`, 、`double`, などです。\)。  
+  
+-   16 バイト未満のサイズのインスタンスがあります。  
+  
+-   変更可能なことはできません。  
+  
+-   頻繁にボックス化することはありません。  
+  
+ その他の場合は、クラスとして、型を定義する必要があります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/common-design-patterns.md b/docs/standard/design-guidelines/common-design-patterns.md
new file mode 100644
index 00000000000..b1d2d9ae510
--- /dev/null
+++ b/docs/standard/design-guidelines/common-design-patterns.md
@@ -0,0 +1,38 @@
+---
+title: "一般的な設計パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリのデザイン パターン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] のデザイン パターン"
+ms.assetid: f7bd1361-4ab2-4132-972d-a044b8f197e1
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 一般的な設計パターン
+ソフトウェア パターン、パターン言語、およびパターンの非常に幅広いトピックに対処する antipatterns に数多くの書籍があります。 したがって、ガイドラインと、.NET Framework Api の設計で頻繁に使用するパターンの非常に限定されたセットに関連付けられているディスカッションについても説明します。  
+  
+## このセクションの内容  
+ [依存関係プロパティ](../../../docs/standard/design-guidelines/dependency-properties.md)  
+ [Dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/constructor.md b/docs/standard/design-guidelines/constructor.md
new file mode 100644
index 00000000000..e63423281d9
--- /dev/null
+++ b/docs/standard/design-guidelines/constructor.md
@@ -0,0 +1,93 @@
+---
+title: "コンス トラクターのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "メンバー デザインのガイドライン、コンス トラクター"
+  - "コンス トラクター、設計のガイドライン"
+  - "インスタンス コンストラクター"
+  - "型コンス トラクター"
+  - "仮想メンバー"
+  - "型のコンス トラクター"
+  - "既定のコンス トラクター"
+  - "静的コンストラクター"
+ms.assetid: b4496afe-5fa7-4bb0-85ca-70b0ef21e6fc
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# コンス トラクターのデザイン
+コンス トラクターの 2 種類があります: コンス トラクターとインスタンス コンス トラクターを入力します。  
+  
+ 型コンス トラクターは、静的および型を使用する前に、CLR で実行されます。 インスタンス コンス トラクターは、型のインスタンスが作成されたときに実行します。  
+  
+ 型コンス トラクターは、すべてのパラメーターを使用できません。 インスタンス コンス トラクターは、次のことです。 パラメーターを受け取りませんインスタンス コンス トラクターは、既定のコンス トラクターとも呼ばれます。  
+  
+ コンス トラクターは、型のインスタンスを作成する最も自然な方法です。 ほとんどの開発者は検索し、別の \(工場出荷時のメソッド\) などのインスタンスを作成する方法を検討する前に、コンス トラクターを使用しようとします。  
+  
+ **✓ を検討してください** シンプル、理想的には、既定のコンス トラクターを提供します。  
+  
+ 簡単なコンス トラクターがパラメーターの数が非常に少ないと、すべてのパラメーターは、プリミティブまたは列挙型。 このような単純なコンス トラクターは、フレームワークのユーザビリティを向上させます。  
+  
+ **✓ を検討してください** 目的の操作のセマンティクスは、新しいインスタンスの構築に直接マップされない場合や、不自然コンス トラクターのデザイン ガイドラインに従う場合は、コンス トラクターではなく静的ファクトリ メソッドを使用しています。  
+  
+ **✓ は** 主要なプロパティを設定するためのショートカットとしてコンス トラクターのパラメーターを使用します。  
+  
+ 意味的に同じことはありませんいくつかのプロパティ セットの後に空のコンス トラクターを使用して、複数の引数を持つコンス トラクターを使用します。  
+  
+ **✓ は** 単にプロパティを設定するコンス トラクターのパラメーターが使用されている場合は、コンス トラクターのパラメーターとプロパティに同じ名前を使用します。  
+  
+ このようなパラメーターとプロパティの唯一の違い大文字小文字の区別する必要があります。  
+  
+ **✓ は** 、コンス トラクターで最低限の作業です。  
+  
+ コンス トラクターは、キャプチャ以外処理がコンス トラクターのパラメーターを実行しないで必要があります。 その他の処理のコストは、必要になるまでに遅延する必要があります。  
+  
+ **✓ は** 該当する場合は、インスタンス コンス トラクターから例外をスローします。  
+  
+ **✓ は** このようなコンス トラクターが必要な場合に、クラスのパブリックの既定のコンス トラクターを明示的に宣言します。  
+  
+ 型のコンス トラクターを明示的に宣言しない、多くの言語 \(c\# など\) するときに、パブリックの既定のコンス トラクターが自動的に追加します。 \(抽象クラスは、保護されているコンス トラクターを取得します\)。  
+  
+ クラスにパラメーター化されたコンス トラクターを追加すると、コンパイラは既定のコンス トラクターを追加できなくなります。 これにより、多くの場合、偶発的な重大な変更が原因です。  
+  
+ **X 回避** 構造体で、既定のコンス トラクターを明示的に定義します。  
+  
+ これにより、配列の作成より速く、既定のコンス トラクターが定義されていない場合はないため、配列内のすべてのスロット上で実行します。 など、C\# の場合は、多くのコンパイラがそのためのパラメーターなしのコンス トラクターを持つ構造体を許可しないことに注意してください。  
+  
+ **X 回避** コンス トラクター内のオブジェクトでの仮想メンバーを呼び出すことです。  
+  
+ 大多数の派生型のコンス トラクターが実行されていない完全にまだ場合でも、仮想メンバーを呼び出すことに呼び出される最派生のオーバーライドによりされます。  
+  
+### 型のコンス トラクターのガイドライン  
+ **✓ は** 静的コンス トラクターをプライベートに設定します。  
+  
+ クラスのコンス トラクターとも呼ばれます。 静的コンス トラクターを使用して、型を初期化します。 CLR は、型の最初のインスタンスを作成またはその型の静的メンバーが呼び出される前に静的コンス トラクターを呼び出します。 ユーザーには、静的コンス トラクターが呼び出されたときに制御がありません。 静的コンス トラクターがプライベートでない場合は、CLR 以外のコードから呼び出すことができます。 コンス トラクターで実行される操作によって予期しない動作ができます。 C\# コンパイラでは、静的コンス トラクターをプライベートを強制します。  
+  
+ **X のしないで** 静的コンス トラクターから例外をスローします。  
+  
+ 型コンス トラクターから例外がスローされた場合、型が使用可能な現在のアプリケーション ドメインで  
+  
+ **✓ を検討してください** 、ランタイムが明示的に定義された静的コンス トラクターがない型のパフォーマンスを最適化することがあるために、静的コンス トラクターを明示的に使用するのではなく、静的フィールドをインラインを初期化します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/dependency-properties.md b/docs/standard/design-guidelines/dependency-properties.md
new file mode 100644
index 00000000000..a2aa5042161
--- /dev/null
+++ b/docs/standard/design-guidelines/dependency-properties.md
@@ -0,0 +1,112 @@
+---
+title: "依存関係プロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 212cfb1e-cec4-4047-94a6-47209b387f6f
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 依存関係プロパティ
+依存関係プロパティ \(DP\) は、たとえば、型の変数 \(フィールド\) に格納することではなくプロパティ ストア内の値を格納する標準プロパティです。  
+  
+ 割り当てられた依存プロパティは、オブジェクトとそのコンテナーの間のリレーションシップを記述する「プロパティ」を表す、Get および Set の静的メソッドとしてモデル化された依存関係プロパティの種類 \(の位置など、 `Button` 上のオブジェクト、 `Panel` コンテナー\) です。  
+  
+ **✓ は** プロパティをスタイル設定、トリガー、データ バインディング、アニメーション、動的リソース、および継承などの WPF 機能をサポートする必要がある場合は、依存関係プロパティを提供します。  
+  
+## 依存関係プロパティのデザイン  
+ **✓ は** から継承 <xref:System.Windows.DependencyObject>, 、または依存関係プロパティを実装する場合、そのサブタイプのいずれかです。 種類は、プロパティ ストアの非常に効率的な実装を提供し、自動的に WPF データ バインドをサポートします。  
+  
+ **✓ は** は、通常の CLR プロパティとパブリック静的な読み取り専用フィールドのインスタンスを格納する指定 <xref:System.Windows.DependencyProperty?displayProperty=fullName> 各依存関係プロパティ。  
+  
+ **✓ は** インスタンス メソッドを呼び出すことによって依存関係プロパティを実装する <xref:System.Windows.DependencyObject.GetValue%2A?displayProperty=fullName> と <xref:System.Windows.DependencyObject.SetValue%2A?displayProperty=fullName>です。  
+  
+ **✓ は** "Property"を使用してプロパティの名前をアスタリスクの依存関係プロパティの静的フィールドの名前  
+  
+ **X のしないで** 代わりにメタデータの設定は、コード内の依存関係プロパティの既定値を明示的に設定します。  
+  
+ プロパティの既定値を明示的に設定すると、スタイルなどのなんらかの暗黙的な方法で設定されているからそのプロパティをできない場合があります。  
+  
+ **X のしないで** 静的フィールドにアクセスする標準的なコード以外のプロパティ アクセサーにコードを追加します。  
+  
+ 静的フィールドを直接使用することはありませんとコードが実行プロパティ、スタイルなどの暗黙的な方法でスタイル処理のためです。  
+  
+ **X のしないで** 依存関係プロパティを使用してセキュリティで保護されたデータを格納します。 でもプライベート依存関係プロパティは、パブリックにアクセスできます。  
+  
+## 接続されている依存関係プロパティのデザイン  
+ 前のセクションで説明されている依存関係プロパティは宣言型の組み込みのプロパティを表しますたとえば、 `Text` プロパティは、プロパティの `TextButton`, 、それを宣言します。 特殊な依存関係プロパティは、接続されている依存関係プロパティです。  
+  
+ 添付プロパティの典型的な例は、 <xref:System.Windows.Controls.Grid.Column%2A?displayProperty=fullName> プロパティです。 プロパティ ボタン \(いないグリッドの\) 列の位置を表すは、「その」ボタンをグリッドで、グリッドで、ボタンが含まれている場合にのみ該当します。  
+  
+```  
+<Grid>  
+    <Grid.ColumnDefinitions>  
+        <ColumnDefinition />  
+        <ColumnDefinition />  
+    </Grid.ColumnDefinitions>  
+  
+    <Button Grid.Column="0">Click</Button>  
+    <Button Grid.Column="1">Clack</Button>  
+</Grid>  
+```  
+  
+ 添付プロパティの定義は、アクセサーが静的の Get と Set メソッドで表されること以外に、通常の依存関係プロパティのほとんどの場合ようになります。  
+  
+```  
+public class Grid {  
+  
+    public static int GetColumn(DependencyObject obj) {  
+        return (int)obj.GetValue(ColumnProperty);  
+    }  
+  
+    public static void SetColumn(DependencyObject obj, int value) {  
+        obj.SetValue(ColumnProperty,value);  
+    }  
+  
+    public static readonly DependencyProperty ColumnProperty =  
+        DependencyProperty.RegisterAttached(  
+            "Column",  
+            typeof(int),  
+            typeof(Grid)  
+    );  
+}  
+```  
+  
+## 依存関係プロパティの検証  
+ プロパティは、多くの場合、検証と呼ばれるものを実装します。 プロパティの値を変更しようとは、検証ロジックを実行します。  
+  
+ 残念なことに依存関係プロパティ アクセサーの場合は、任意の検証コードを含めることはできません。 代わりに、依存関係プロパティの検証ロジックは、プロパティの登録時に指定する必要があります。  
+  
+ **X のしないで** プロパティのアクセサーの依存関係プロパティの検証ロジックを配置します。 代わりに、検証コールバックを渡す `DependencyProperty.Register` メソッドです。  
+  
+## 依存関係プロパティの変更通知  
+ **X のしないで** 依存関係プロパティのアクセサーで変更通知のロジックを実装します。 依存関係プロパティには、変更通知のコールバックを指定する必要がある組み込みの変更通知機能があり、 <xref:System.Windows.PropertyMetadata>です。  
+  
+## 依存関係プロパティの値の強制型変換  
+ プロパティ ストアが実際に変更される前に、set アクセス操作子、プロパティ set アクセス操作子に渡された値が変更されたときにプロパティの強制型変換が行われます。  
+  
+ **X のしないで** 依存関係プロパティのアクセサーに強制変換ロジックを実装します。  
+  
+ 依存関係プロパティが、組み込みの強制型変換機能を持っているし、強制型変換のコールバックを指定することで使用できます、 `PropertyMetadata`です。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [一般的な設計パターン](../../../docs/standard/design-guidelines/common-design-patterns.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/designing-for-extensibility.md b/docs/standard/design-guidelines/designing-for-extensibility.md
new file mode 100644
index 00000000000..b4b62230bad
--- /dev/null
+++ b/docs/standard/design-guidelines/designing-for-extensibility.md
@@ -0,0 +1,47 @@
+---
+title: "機能拡張のデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリを拡張します。"
+  - ".NET framework クラス ライブラリによる拡張機能"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] の機能拡張"
+  - "クラス ライブラリの機能拡張 [.NET Framework]"
+ms.assetid: 1cdb8740-871a-456c-9bd9-db96ca8d79b3
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 機能拡張のデザイン
+フレームワークの設計の 1 つの重要な側面を行って、framework の機能拡張は慎重に考慮されていることを確認しています。 これは、コストとさまざまな機能拡張機構に関連付けられている利点を理解することが必要です。 この章では、拡張メカニズムを決定できます。\-サブクラス化、イベント、仮想メンバーを、コールバック、およびなど —、framework の要件を最も満たすことができます。  
+  
+ フレームワークの機能拡張を許可するように多くの方法があります。 コストが非常に強力に性能の低いが、低コストの範囲です。 、特定の機能拡張必要条件については、要件を満たしているコストが機能拡張機構を選択してください。 後で、複数の機能拡張を追加する通常できますが、重大な変更を導入することがなく離れた実行しないことができますのことに注意してください。  
+  
+## このセクションの内容  
+ [封印されていないクラス](../../../docs/standard/design-guidelines/unsealed-classes.md)  
+ [プロテクト メンバー](../../../docs/standard/design-guidelines/protected-members.md)  
+ [イベントとコールバック](../../../docs/standard/design-guidelines/events-and-callbacks.md)  
+ [仮想メンバー](../../../docs/standard/design-guidelines/virtual-members.md)  
+ [抽象化 \(抽象型とインターフェイス\)](../../../docs/standard/design-guidelines/abstractions-abstract-types-and-interfaces.md)  
+ [抽象化を実装するための基本クラス](../../../docs/standard/design-guidelines/base-classes-for-implementing-abstractions.md)  
+ [封印](../../../docs/standard/design-guidelines/sealing.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/dispose-pattern.md b/docs/standard/design-guidelines/dispose-pattern.md
new file mode 100644
index 00000000000..80cef75f8e3
--- /dev/null
+++ b/docs/standard/design-guidelines/dispose-pattern.md
@@ -0,0 +1,296 @@
+---
+title: "Dispose パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Dispose メソッド"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] Dispose メソッド"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] Finalize メソッド"
+  - "Dispose メソッド名をカスタマイズします。"
+  - "Finalize メソッド"
+ms.assetid: 31a6c13b-d6a2-492b-9a9f-e5238c983bcb
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# Dispose パターン
+すべてのプログラムは、それらの実行の進行中にメモリ、システムのハンドル、またはデータベース接続など、1 つまたは複数のシステム リソースを取得します。 開発者である、取得、使用後に解放する必要があるために、このようなシステム リソースの使用に注意してください。  
+  
+ CLR では、自動メモリ管理がサポートされています。 管理されるメモリ \(c\# 演算子を使用して割り当てられたメモリ `new`\) 明示的に解放する必要はありません。 ガベージ コレクター \(GC\) によって自動的に解放されます。 これにより開発者のメモリを解放して難しい面倒な作業から解放されは、.NET Framework によって提供される優れた生産性向上のための主な理由の 1 つでした。  
+  
+ 残念ながら、マネージ メモリは、さまざまな種類のシステム リソースの 1 つです。 ただし、マネージ メモリ以外のリソースは明示的に解放する必要あるし、アンマネージ リソースと呼びます。 GC はありませんされたこのようなアンマネージ リソースを管理する開発者の手にアンマネージ リソースを管理する責任があることを意味します。  
+  
+ CLR では、アンマネージ リソースを解放するときにいくつかのヘルプを提供します。<xref:System.Object?displayProperty=fullName> 仮想メソッドを宣言 <xref:System.Object.Finalize%2A> \(ファイナライザーとも呼ばれます\)、オブジェクトのメモリが GC によって回収され、上書きして、アンマネージ リソースを解放する前に、GC によって呼び出されます。 ファイナライザーのオーバーライドの種類は、ファイナライズ可能な型と呼ばれます。  
+  
+ ファイナライザーはクリーンアップの一部のシナリオで効果的なは、2 つの重要な欠点があります。  
+  
+-   GC はコレクションの対象オブジェクトを検出すると、ファイナライザーが呼び出されます。 これは、不定一定時間、リソースは必要ありません後に行われます。 開発者がでしたか、リソースおよびリソースが実際には、ファイナライザーで解放と時間を解放するまでの遅延は、リソースは \(大規模なアンマネージ メモリ バッファーなど\) の使用にコストがかかる場合や、多くの不足しているリソース \(リソースを簡単に使い果たされることができます\) を取得するプログラムで受け入れられない可能性があります。  
+  
+-   CLR は、ファイナライザーを呼び出す必要がある場合は、次の回ガベージ コレクション \(コレクションの間で実行するファイナライザー\) のするまで、オブジェクトのメモリのコレクションを延期にする必要があります。 これは、オブジェクトのメモリ \(およびすべてのオブジェクトを参照\) が、長期間に解放されないことを意味します。  
+  
+ そのため、ファイナライザーでのみ証明書利用者不適切となる多くのシナリオが不足しているリソースを処理する場合は、アンマネージ リソースをできるだけ早く再利用する必要がある場合または高パフォーマンスの高いシナリオがこれで、追加した GC オーバーヘッドの終了処理は許容されません。  
+  
+ フレームワークは、提供、 <xref:System.IDisposable?displayProperty=fullName> インターフェイスが必要でないと、すぐには、アンマネージ リソースを解放する手動の方法を開発者に提供するために実装する必要があります。 また、提供、 <xref:System.GC.SuppressFinalize%2A?displayProperty=fullName> するように、GC が知ることができるメソッド、オブジェクトは手動で破棄され、その場合、オブジェクトのメモリを再要求できる前、終了する必要はありません。 実装する型、 `IDisposable` インターフェイスを破棄できる型と呼びます。  
+  
+ Dispose パターンの目的は、使用状況とファイナライザーの実装を標準化して、 `IDisposable` インターフェイスです。  
+  
+ パターンの主な動機がの実装の複雑さを軽減するには、 <xref:System.Object.Finalize%2A> と <xref:System.IDisposable.Dispose%2A> メソッドです。 複雑なメソッドがいくつかのコード パスが \(相違点は後で説明\) を共有するという事実に由来します。 さらに、確定的なリソース管理のための言語サポートの進化に関連するパターンの一部の要素の歴史的な理由があります。  
+  
+ **✓ は** 破棄可能な型のインスタンスを含む型の Dispose の基本的なパターンを実装します。 参照してください、 [基本的な Dispose パターン](#basic_pattern) セクションについては、基本的なパターンです。  
+  
+ 型が破棄可能なその他のオブジェクトの有効期間を担当する場合は、開発者にも、それらを破棄する方法必要があります。 コンテナーを使用して `Dispose` メソッドは、これを可能にする便利な方法です。  
+  
+ **✓ は** 基本的な Dispose パターンを実装し、保持しているリソースに明示的に解放する必要があると、ファイナライザーを持たない型にファイナライザーを提供します。  
+  
+ たとえば、このパターンは、アンマネージ メモリ バッファーを格納する型で実装する必要があります。[ファイナライズ可能な型](#finalizable_types) ファイナライザーを実装する関連のガイドラインについて説明します。  
+  
+ **✓ を検討してください** クラス自体を保持しないことは、アンマネージ リソースまたは破棄可能なオブジェクトはサブタイプがある可能性が、基本的な Dispose パターンを実装します。  
+  
+ これの良い例は、 <xref:System.IO.Stream?displayProperty=fullName> クラスです。 すべてのリソースを保持しないする抽象基本クラスが、そのサブクラスのほとんどはし、このため、このパターンを実装します。  
+  
+<a name="basic_pattern"></a>   
+## 基本的な Dispose パターン  
+ パターンの基本的な実装には、実装が含まれます、 `System.IDisposable` インターフェイスと宣言する、 `Dispose(bool)` 間で共有するすべてのリソースのクリーンアップ ロジックを実装するメソッド、 `Dispose` メソッドと省略可能な終了します。  
+  
+ 次の例は、基本的なパターンの単純な実装を示しています。  
+  
+```  
+public class DisposableResourceHolder : IDisposable {  
+  
+    private SafeHandle resource; // handle to a resource  
+  
+    public DisposableResourceHolder(){  
+        this.resource = ... // allocates the resource  
+    }  
+  
+    public void Dispose(){  
+        Dispose(true);  
+        GC.SuppressFinalize(this);  
+    }  
+  
+    protected virtual void Dispose(bool disposing){  
+        if (disposing){  
+            if (resource!= null) resource.Dispose();  
+        }  
+    }  
+}  
+```  
+  
+ ブール型パラメーター `disposing` からメソッドが呼び出されたかどうかを示す、 `IDisposable.Dispose` 実装またはファイナライザーからです。`Dispose(bool)` 実装は、その他の参照オブジェクト \(前のサンプルのリソース フィールドなど\) にアクセスする前に、パラメーターを確認する必要があります。 このようなオブジェクトから、メソッドが呼び出されたときにのみアクセスできる、 `IDisposable.Dispose` 実装 \(ときに、 `disposing` パラメーターが true に等しい\)。 メソッドは、ファイナライザーから呼び出される場合 \(`disposing` は false\)、その他のオブジェクトにアクセスしないようにします。 理由は、オブジェクトが予期しない順序で完了処理され、そのため、またはその依存関係のいずれかが既にファイナライズされていることです。  
+  
+ また、このセクションでは、Dispose パターンを実装しない基数を持つクラスに適用されます。 既にパターンを実装するクラスから継承している場合はオーバーライドするだけで、 `Dispose(bool)` 追加のリソースのクリーンアップ ロジックを提供します。  
+  
+ **✓ は** 宣言保護された仮想 void `Dispose(bool disposing)` アンマネージ リソースの解放に関連するすべてのロジックを一元化するメソッドです。  
+  
+ リソースのクリーンアップをすべては、このメソッドで発生する必要があります。 メソッドは、両方のファイナライザーから呼び出されると、 `IDisposable.Dispose` メソッドです。 パラメーターは、ファイナライザーの内部から呼び出されている場合は false になります。 終了処理中に実行されるコードは、ファイナライズ可能なその他のオブジェクトにアクセスしていないことを確認することを使用してください。 ファイナライザーを実装の詳細は、次のセクションで記述されます。  
+  
+```  
+protected virtual void Dispose(bool disposing){  
+    if (disposing){  
+        if (resource!= null) resource.Dispose();  
+    }  
+}  
+```  
+  
+ **✓ は** 実装、 `IDisposable` を単純に呼び出してインターフェイス `Dispose(true)` 続けて `GC.SuppressFinalize(this)`します。  
+  
+ 呼び出し `SuppressFinalize` 場合にのみ発生 `Dispose(true)` 正常に実行されます。  
+  
+```  
+public void Dispose(){  
+    Dispose(true);  
+    GC.SuppressFinalize(this);  
+}  
+```  
+  
+ **X のしないで** パラメーターなしで行う `Dispose` 仮想メソッドです。  
+  
+ `Dispose(bool)` メソッドは、1 つのサブクラスによってオーバーライドする必要があります。  
+  
+```  
+// bad design  
+public class DisposableResourceHolder : IDisposable {  
+    public virtual void Dispose(){ ... }  
+    protected virtual void Dispose(bool disposing){ ... }  
+}  
+  
+// good design  
+public class DisposableResourceHolder : IDisposable {  
+    public void Dispose(){ ... }  
+    protected virtual void Dispose(bool disposing){ ... }  
+}  
+```  
+  
+ **X のしないで** のすべてのオーバー ロードを宣言、 `Dispose` メソッド以外の `Dispose()` と `Dispose(bool)`です。  
+  
+ `Dispose` このパターンを体系化し、実装者、ユーザー、およびコンパイラの間で混乱を回避するために予約語を考慮必要があります。 一部の言語は、特定の種類に自動的にこのパターンを実装することもできます。  
+  
+ **✓ は** を許可する、 `Dispose(bool)` に複数回呼び出されるメソッド。 メソッドは、最初に呼び出した後何もしないこともできます。  
+  
+```  
+public class DisposableResourceHolder : IDisposable {  
+  
+    bool disposed = false;  
+  
+    protected virtual void Dispose(bool disposing){  
+        if(disposed) return;  
+        // cleanup  
+        ...  
+        disposed = true;  
+    }  
+}  
+```  
+  
+ **X 回避** 内から例外がスロー `Dispose(bool)` 限り重要な状況で格納しているプロセスが破損しています \(リークするなどの共有状態の整合性がありません。\)。  
+  
+ ユーザーが期待するへの呼び出し `Dispose` 例外は発生しません。  
+  
+ 場合 `Dispose` 例外を発生させることが、さらに finally ブロックのクリーンアップ ロジックは実行されません。 この問題を回避するは、ユーザーはすべての呼び出しをラップする必要が `Dispose` \(内で、finally ブロック\!\) try ブロックで非常に複雑なクリーンアップのハンドラーにつながります。 実行されている場合、 `Dispose(bool disposing)` メソッド、破棄が false の場合も例外をスローさせることはありません。 そうにより、ファイナライザーのコンテキスト内に実行する場合、プロセスは終了します。  
+  
+ **✓ は** スロー、 <xref:System.ObjectDisposedException> すべてのメンバーのオブジェクトが破棄された後に使用できないからです。  
+  
+```  
+public class DisposableResourceHolder : IDisposable {  
+    bool disposed = false;  
+    SafeHandle resource; // handle to a resource  
+  
+    public void DoSomething(){  
+           if(disposed) throw new ObjectDisposedException(...);  
+        // now call some native methods using the resource   
+            ...  
+    }  
+    protected virtual void Dispose(bool disposing){  
+        if(disposed) return;  
+        // cleanup  
+        ...  
+        disposed = true;  
+    }  
+}  
+```  
+  
+ **✓ を検討してください** メソッドを提供する `Close()`, に加え、 `Dispose()`, 、領域に一般的な用語が閉じるかどうか。  
+  
+ その場合であることが重要、 `Close` 実装と同じ `Dispose` を実装することを検討してください、 `IDisposable.Dispose` メソッドに明示的にします。  
+  
+```  
+public class Stream : IDisposable {  
+    IDisposable.Dispose(){  
+        Close();  
+    }  
+    public void Close(){  
+        Dispose(true);  
+        GC.SuppressFinalize(this);  
+    }  
+}  
+```  
+  
+<a name="finalizable_types"></a>   
+## ファイナライズ可能な型  
+ ファイナライズ可能な型はファイナライザーをオーバーライドし、\[ファイナライズ コード パスを提供することによって、基本的な Dispose パターンを拡張する型は、 `Dispose(bool)` メソッドです。  
+  
+ ファイナライザーは、主な理由は、実行中に、システムの状態に関する \(通常は有効な\) 仮定をすることはできません、正しく実装する非常に困難です。 次のガイドラインは、慎重に検討に考慮する必要があります。  
+  
+ しないようにだけに適用のガイドラインに注意してください、 `Finalize` メソッド、ファイナライザーがコードから呼び出されます。 つまり、ロジック内で実行されますが、基本的な Dispose パターン定義済みの場合 `Dispose(bool disposing)` ときに、 `disposing` パラメーターを false にします。  
+  
+ 基本クラス既にファイナライズ可能なは、基本的な Dispose パターンを実装オーバーライドしないでください `Finalize` 再度します。 だけオーバーライドする代わりに、 `Dispose(bool)` 追加のリソースのクリーンアップ ロジックを提供します。  
+  
+ 次のコードでは、ファイナライズ可能な型の例を示します。  
+  
+```  
+public class ComplexResourceHolder : IDisposable {  
+  
+    private IntPtr buffer; // unmanaged memory buffer  
+    private SafeHandle resource; // disposable handle to a resource  
+  
+    public ComplexResourceHolder(){  
+        this.buffer = ... // allocates memory  
+        this.resource = ... // allocates the resource  
+    }  
+  
+    protected virtual void Dispose(bool disposing){  
+            ReleaseBuffer(buffer); // release unmanaged memory  
+        if (disposing){ // release other disposable objects  
+            if (resource!= null) resource.Dispose();  
+        }  
+    }  
+  
+    ~ ComplexResourceHolder(){  
+        Dispose(false);  
+    }  
+  
+    public void Dispose(){  
+        Dispose(true);  
+        GC.SuppressFinalize(this);  
+    }  
+}  
+```  
+  
+ **X 回避** ファイナライズ可能な型を作成します。  
+  
+ いかなる場合においてと思われる、ファイナライザーが必要なを慎重に検討します。 実際のパフォーマンスとコードの両方の複雑性の観点から、ファイナライザーを持つインスタンスに関連付けられているコストです。 などのリソースのラッパーを使用して必要に応じて <xref:System.Runtime.InteropServices.SafeHandle> を可能な場合は、アンマネージ リソースをカプセル化、その場合、ファイナライザーが不要になるラッパーが、独自のリソースのクリーンアップを行うためです。  
+  
+ **X のしないで** ファイナライズ可能な値の型を作成します。  
+  
+ 実際には参照型のみが、CLR でファイナライズを取得し、したがってしようと値の型にファイナライザーを配置することは無視されます。 C\# および C\+\+ コンパイラは、この規則を適用します。  
+  
+ **✓ は** 型は独自のファイナライザーがない、アンマネージ リソースを解放する必要がある場合、型をファイナライズ可能なためです。  
+  
+ ファイナライザーを実装するときに呼び出します `Dispose(false)` 内のすべてのリソースのクリーンアップ ロジックを配置し、 `Dispose(bool disposing)` メソッドです。  
+  
+```  
+public class ComplexResourceHolder : IDisposable {  
+  
+    ~ ComplexResourceHolder(){  
+        Dispose(false);  
+    }  
+  
+    protected virtual void Dispose(bool disposing){  
+        ...  
+    }  
+}  
+```  
+  
+ **✓ は** ファイナライズ可能なすべての種類の基本的な Dispose パターンを実装します。  
+  
+ これにより、型のユーザーはこのため、ファイナライザーにはそれらのリソースの確定的なクリーンアップを明示的に実行することを意味します。  
+  
+ **X のしないで** 、それらは既にファイナライズされている重大なリスクがあるため、ファイナライザーのコード パスでファイナライズ可能なオブジェクトにアクセスします。  
+  
+ たとえば、別のファイナライズ可能なオブジェクト B を参照しているファイナライズ可能なオブジェクト A に確実に使用できません B a のファイナライザー、またはその逆です。 \(クリティカル ファイナライズの弱い順序保証\) する場合を除きランダムな順序では、ファイナライザーが呼び出されます。  
+  
+ また、注意してを静的変数に格納されているオブジェクトが取得アプリケーション ドメインのアンロード中またはプロセスの終了中に、特定の時点でそれを収集します。 ファイナライズ可能なオブジェクト \(または静的変数に格納された値を使用する静的メソッドを呼び出す\) を参照する静的変数ができないにアクセスする場合は安全な <xref:System.Environment.HasShutdownStarted%2A?displayProperty=fullName> は true を返します。  
+  
+ **✓ は** ように、 `Finalize` 保護されているメソッド。  
+  
+ C\#、C\+\+、および VB.NET の開発者は、次のガイドラインを適用するコンパイラでは、役に立つため、これについて心配する必要はありません。  
+  
+ **X のしないで** システムに重大な障害を除く、ファイナライザーのロジックから let 例外エスケープします。  
+  
+ ファイナライザーは例外が、CLR がシャット ダウン \(.NET Framework version 2.0\)、現在のプロセス全体を実行して適切な方法で解放されているリソースを別のファイナライザーを妨げています。  
+  
+ **✓ を検討してください** を作成してクリティカル ファイナライズ可能なオブジェクトを使用して \(を含む型階層を持つ型 <xref:System.Runtime.ConstrainedExecution.CriticalFinalizerObject>\) のファイナライザー絶対が実行される強制的なアプリケーション ドメインが発生しても状況をアンロードし、スレッドの中止します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ <xref:System.IDisposable.Dispose%2A?displayProperty=fullName>   
+ <xref:System.Object.Finalize%2A?displayProperty=fullName>   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [一般的な設計パターン](../../../docs/standard/design-guidelines/common-design-patterns.md)   
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/enum.md b/docs/standard/design-guidelines/enum.md
new file mode 100644
index 00000000000..192c7784904
--- /dev/null
+++ b/docs/standard/design-guidelines/enum.md
@@ -0,0 +1,111 @@
+---
+title: "列挙型デザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "型のデザインのガイドライン、列挙型"
+  - "単純な列挙体"
+  - "列挙体 [.NET Framework] のデザイン ガイドライン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 列挙型"
+  - "フラグ列挙体"
+ms.assetid: dd53c952-9d9a-4736-86ff-9540e815d545
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 列挙型デザイン
+列挙型は、特殊な値の型です。 列挙値の 2 種類があります。 単純な列挙型、およびフラグの列挙型。  
+  
+ 単純な列挙型は、選択肢の小さな閉じたセットを表します。 シンプルな列挙体の一般的な例は、色のセットです。  
+  
+ フラグ列挙型は、列挙値のビットごとの演算をサポートするために設計されています。 フラグ列挙体の一般的な例では、オプションの一覧を示します。  
+  
+ **✓ は** を厳密に型パラメーター、プロパティ、列挙型を使用し、戻り値のセットを表す値。  
+  
+ **✓ は** 列挙型を静的な定数の代わりに使用をお勧めします。  
+  
+ **X のしないで** 集合 \(など、オペレーティング システムのバージョン、友人などの名前\) に列挙型を使用します。  
+  
+ **X のしないで** 将来使用するは、予約済みの列挙値を指定します。  
+  
+ 値は、後の段階で既存の列挙体を常に単純に追加できます。 参照してください [列挙体に値を追加する](#add_value) 列挙体に値を追加することの詳細についてです。 予約済みの値は煩雑に実際の値のセットをユーザー エラーが発生する傾向がありますだけです。  
+  
+ **X 回避** 1 つだけの値を持つ列挙型を公開することです。  
+  
+ C Api の将来の拡張性を確保するための一般的な方法では、メソッド シグネチャに予約されているパラメーターを追加します。 このような予約済みのパラメーターは、1 つの既定値を持つ列挙型として表現できます。 これは、マネージ Api で実行する必要がありますされません。 メソッドのオーバー ロードとは、将来リリースされるパラメーターを追加できます。  
+  
+ **X のしないで** 列挙型に sentinel 値を含めます。  
+  
+ フレームワーク開発者に役立つ場合がありますが、sentinel 値は、フレームワークのユーザーが混乱します。 列挙型で表されるセットから、値のいずれかがするのではなく、列挙型の状態を追跡するために使用されます。  
+  
+ **✓ は** 単純な列挙型のゼロの値を指定します。  
+  
+ 値を"None"のように呼び出すことを検討してください。 このような値がこの特定の列挙型に対して適切でない場合列挙型の最も一般的な既定値は、基になる値の 0 割り当てる必要があります。  
+  
+ **✓ を検討してください** を使用して <xref:System.Int32> \(大半のプログラミング言語の既定値\) 列挙型の基になる型として、次のいずれかが当てはまる場合を除き。  
+  
+-   列挙型はフラグ列挙体を 32 を超えるフラグが設定されてしたり、将来さらにが見込まれます。  
+  
+-   基になる型が異なるする必要がある <xref:System.Int32> さまざまなサイズを持つ列挙型を指定して、アンマネージ コードと相互運用性を容易にします。  
+  
+-   小規模な基になる型は、領域が大幅に節約になります。 制御フローの引数として主に使用される列挙型の場合、サイズもほとんど違いを します。 サイズの削減が大きなある場合。  
+  
+    -   非常に頻繁にインスタンス化された構造体またはクラス内のフィールドとして使用する列挙型を予測します。  
+  
+    -   ユーザー インスタンスの列挙の大規模な配列またはコレクションを作成するとします。  
+  
+    -   シリアル化する列挙型のインスタンスの数が多いはずです。  
+  
+ メモリ内の使用方法は、マネージ オブジェクトは常にことに留意して `DWORD`\-固定されているため、複数の列挙型、またはインスタンスの合計サイズは最大ラウンドを常にので違いするためにで小規模な列挙体をパックするインスタンスの他の小さな構造を効果的に必要な `DWORD`です。  
+  
+ **✓ は** フラグの列挙型には複数形の名詞または名詞句と単数形の名詞または名詞句と単純な列挙型の名前します。  
+  
+ **X のしないで** 拡張 <xref:System.Enum?displayProperty=fullName> 直接します。  
+  
+ <xref:System.Enum?displayProperty=fullName> 特殊な CLR が使用をユーザー定義の列挙体を作成します。 大半のプログラミング言語では、この機能にアクセスできるプログラミングの要素を提供します。 C\# などの `enum` 列挙体を定義するキーワードを使用します。  
+  
+<a name="design"></a>   
+### フラグ列挙型を設計します。  
+ **✓ は** 適用、 <xref:System.FlagsAttribute?displayProperty=fullName> フラグ列挙体にします。 単純な列挙体にはこの属性は適用されません。  
+  
+ **✓ は** ようにする自由にビットごとの OR 演算を使用して、フラグ列挙値に 2 の累乗を使用します。  
+  
+ **✓ を検討してください** フラグの組み合わせを使用して通常の特別な列挙値を提供することです。  
+  
+ ビットごとの演算は、高度な概念では単純な作業は必要ありません。<xref:System.IO.FileAccess> このような特殊な値の例に示します。  
+  
+ **X 回避** 特定の値の組み合わせが有効なフラグ列挙型を作成します。  
+  
+ **X 回避** 値が「すべてのフラグをクリアする」を表すし、次のガイドラインの規定に従って、適切な名前はしない限り、列挙値がゼロのフラグを設定を使用します。  
+  
+ **✓ は** フラグの列挙値のゼロ値に名前を `None`します。 フラグ列挙型の値常にということになる"すべてのフラグがクリアされます"  
+  
+<a name="add_value"></a>   
+### 列挙体に値を追加します。  
+ 既に出荷した後に、列挙型に値を追加する必要があることを検出することがよくなります。 アプリケーションの互換性の問題がある可能性が新しく追加された値が既存の API から返されるためには品質の低いアプリケーションで、新しい値を正しく処理されない可能性があります。  
+  
+ **✓ を検討してください** 互換性に関する小さなリスクに関係なく、列挙型に値を追加します。  
+  
+ 列挙型への追加によるアプリケーション互換性に関する実際のデータがある場合は、新旧の値を返す新しい API の追加を検討しを続行する古い値だけが返される以前の API の使用を避けます。 既存のアプリケーションの互換性を維持するようになります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/equality-operators.md b/docs/standard/design-guidelines/equality-operators.md
new file mode 100644
index 00000000000..2eaca430ad8
--- /dev/null
+++ b/docs/standard/design-guidelines/equality-operators.md
@@ -0,0 +1,63 @@
+---
+title: "等値演算子 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] Equals メソッド"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 等値演算子"
+  - "等値演算子 (= =) [.NET Framework]"
+  - "Equals メソッド"
+  - "= 演算子 (等値) [.NET Framework]"
+ms.assetid: bc496a91-fefb-4ce0-ab4c-61f09964119a
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 等値演算子
+ここではオーバー ロードの等値演算子について説明し、指す `operator==` と `operator!=` 等値演算子とします。  
+  
+ **X のしないで** 等値演算子のいずれかのオーバー ロードします。  
+  
+ **✓ は** いることを確認 <xref:System.Object.Equals%2A?displayProperty=fullName> 等値演算子は、同じセマンティクスと類似のパフォーマンス特性があるとします。  
+  
+ 多くの場合、つまり、この `Object.Equals` 等値演算子はオーバー ロード時に上書きする必要があります。  
+  
+ **X 回避** 等値演算子から例外をスローします。  
+  
+ たとえば、引数のいずれかがスローする代わりに null の場合は false を返す `NullReferenceException`します。  
+  
+## 値の型で等値演算子  
+ **✓ は** 等しいかどうかが意味のある場合は、値型で等値演算子をオーバー ロードします。  
+  
+ ほとんどのプログラミング言語での既定の実装はありません `operator==` 値型です。  
+  
+## 参照型で等値演算子  
+ **X 回避** 変更可能な参照型で等値演算子のオーバー ロードします。  
+  
+ 多くの言語では、参照型に関する組み込みの等値演算子があります。 組み込み演算子は通常、参照の等価性を実装し、値の等価性を既定の動作が変更されたときに、多くの開発者が驚かれるでしょう。 します。  
+  
+ 不変性をより参照の等価性と値の等価性の間の違いに注意をはるかに困難になるために、変更できない参照型の場合この問題が軽減されます。  
+  
+ **X 回避** が実装の参照の等価性の場合よりも大幅に遅れる場合は、参照型で等値演算子をオーバー ロードします。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/event.md b/docs/standard/design-guidelines/event.md
new file mode 100644
index 00000000000..089c71f6898
--- /dev/null
+++ b/docs/standard/design-guidelines/event.md
@@ -0,0 +1,85 @@
+---
+title: "イベントのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "前のイベント"
+  - "イベント [.NET Framework] のデザイン ガイドライン"
+  - "メンバー デザインのガイドライン、イベント"
+  - "イベント デザインのガイドラインのイベント ハンドラー [.NET Framework]"
+  - "後のイベント"
+  - "署名、イベント処理"
+ms.assetid: 67b3c6e2-6a8f-480d-a78f-ebeeaca1b95a
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# イベントのデザイン
+イベントは、コールバック \(ユーザー コードを呼び出すために、フレームワークを許可するコンストラクト\) の最もよく使用される形式です。 その他のコールバック機構には、デリゲート、仮想メンバー、およびインターフェイス ベースのプラグインを取得するメンバーが含まれます。 ユーザビリティに関する調査からのデータは、開発者の大部分が使いやすいその他のコールバック メカニズムを使用しているよりも、イベントを使用することを示します。 イベントは、Visual Studio および多くの言語とうまく統合されています。  
+  
+ イベントの 2 つのグループがあることを確認することが重要: 前のイベント、および状態が変更された後に発生するイベントと呼ばれるシステムの変更の状態の前に発生したイベントには、後のイベントと呼ばれます。 イベントの前の例としては `Form.Closing`, 、フォームが閉じられる前にこれが発生します。 イベントの後の例としては `Form.Closed`, 、フォームが閉じられた後は、発生します。  
+  
+ **✓ は** イベントではなく"fire"や「トリガー」の「生成」という用語を使用して  
+  
+ **✓ は** を使用して <xref:System.EventHandler%601?displayProperty=fullName> イベント ハンドラーとして使用する新しいデリゲートを手動で作成する代わりにします。  
+  
+ **✓ を検討してください** のサブクラスを使用して <xref:System.EventArgs> イベントの引数としてを除いて確信イベントがイベント処理メソッドでは、対象のデータを実行する必要はありませんがいる場合に使用できます、 `EventArgs` を直接入力します。  
+  
+ API を使用して、出荷する場合は、 `EventArgs` を直接しないことができます互換性を損なうことがなく、イベントに実行されるように、データを追加します。 サブクラスを使用する場合でもかどうか最初に完全に空ことができます必要なときに、サブクラスにプロパティを追加します。  
+  
+ **✓ は** 各イベントを発生させる保護された仮想メソッドを使用します。 これは、構造体、シール クラス、または静的イベントが、封印されていないクラスで静的でないイベントに適用できるのみです。  
+  
+ メソッドの目的は、上書きを使用して、イベントを処理する派生クラスの手段を提供します。 オーバーライドは、派生クラスで基本クラス イベントを処理するより柔軟で、高速より自然な方法です。 規則では、メソッドの名前は"On"で起動し、直後に、イベントの名前を付ける。  
+  
+ 派生クラスは、そのオーバーライドで、メソッドの基本実装を呼び出していないを選択できます。 正常に動作する基本クラスに必要なメソッドでどのような処理を含めないことでこれを準備します。  
+  
+ **✓ は** イベントを発生させるプロテクト メソッドにパラメーターを 1 つを実行します。  
+  
+ パラメーターに名前を付ける `e` と、イベント引数クラスとして自動的に入力する必要があります。  
+  
+ **X のしないで** 非静的イベントを発生させる場合、送信側として null を渡します。  
+  
+ **✓ は** 静的イベントを発生させる場合、送信側として null を渡します。  
+  
+ **X のしないで** イベントを発生させるときにイベント データ パラメーターとして null を渡します。  
+  
+ 渡す必要があります `EventArgs.Empty` イベント処理メソッドに、データの受け渡ししたくない場合。 開発者は、いない null にするには、このパラメーターを期待しています。  
+  
+ **✓ を検討してください** エンド ユーザーで取り消すことができるイベントの発生します。 これは、前のイベントにのみ適用されます。  
+  
+ 使用 <xref:System.ComponentModel.CancelEventArgs?displayProperty=fullName> またはエンドユーザーのイベントをキャンセルできるイベントの引数としてそのサブクラスです。  
+  
+### カスタム イベント ハンドラーのデザイン  
+ 場合がある `EventHandler<T>` 、framework がジェネリックをサポートしないと、CLR の以前のバージョンを使用する必要がある場合など、使用することはできません。 このような場合は、デザインおよびカスタム イベント ハンドラーのデリゲートを作成する必要があります。  
+  
+ **✓ は** イベント ハンドラーの void の戻り値の型を使用します。  
+  
+ イベント ハンドラーは、おそらく複数のオブジェクト上のメソッドを処理する複数のイベントを呼び出すことができます。 イベント処理メソッドの戻り値が許可された場合は、イベントの呼び出しごとの複数の戻り値があります。  
+  
+ **✓ は** を使用して `object` イベント ハンドラーの最初のパラメーターの型とそれを呼び出す `sender`します。  
+  
+ **✓ は** を使用して <xref:System.EventArgs?displayProperty=fullName> またはそのサブクラスのイベント ハンドラーの 2 番目のパラメーターの型としてそれを呼び出す `e`します。  
+  
+ **X のしないで** イベント ハンドラーに 3 つ以上のパラメーターがあります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/events-and-callbacks.md b/docs/standard/design-guidelines/events-and-callbacks.md
new file mode 100644
index 00000000000..cc2b28f758f
--- /dev/null
+++ b/docs/standard/design-guidelines/events-and-callbacks.md
@@ -0,0 +1,58 @@
+---
+title: "イベントとコールバック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "機能拡張のイベント [.NET Framework]"
+  - "メソッド [.NET Framework], コールバック"
+  - "コールバック メソッド"
+  - "コールバック"
+ms.assetid: 48b55c60-495f-4089-9396-97f9122bba7c
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# イベントとコールバック
+コールバックはするがデリゲートからユーザー コードにコールバックするためのフレームワーク機能拡張ポイントです。 これらのデリゲートは、メソッドのパラメーターを通じて通常フレームワークに渡されます。  
+  
+ イベントは、コールバックのデリゲート \(イベント ハンドラー\) を提供するための便利で一貫した構文をサポートする特殊なケースです。 さらに、Visual Studio のステートメント入力候補および設計者は、イベント ベースの Api を使用してヘルプを提供します。 \(「[イベントのデザイン](../../../docs/standard/design-guidelines/event.md)」を参照\)。  
+  
+ **✓ を検討してください** コールバックを使用して、フレームワークによって実行されるカスタム コードを提供できるようにします。  
+  
+ **✓ を検討してください** イベントを使用したオブジェクト指向設計を理解することがなくても、フレームワークの動作をカスタマイズできるようにします。  
+  
+ **✓ は** 、広い範囲の開発者になじみのある、ステートメント入力候補の Visual Studio に統合されているために、イベントを単純なコールバックよりも優先されます。  
+  
+ **X 回避** パフォーマンスが重視される Api でコールバックを使用します。  
+  
+ **✓ は** 新しい `Func<...>`, 、`Action<...>`, 、または `Expression<...>` になったコールバック Api を定義するときに、カスタム デリゲートではなく型です。  
+  
+ `Func<...>` `Action<...>` 汎用デリゲートを表します。`Expression<...>` コンパイルして、後でも呼び出すことができますが、実行時にできる表します関数定義シリアル化およびリモート プロセスに渡されます。  
+  
+ **✓ は** を測定し、使用するパフォーマンスの影響について理解する `Expression<...>`, 、使用する代わりに `Func<...>` と `Action<...>` デリゲート。  
+  
+ `Expression<...>` ほとんどの場合と同じ論理的には種類が `Func<...>` と `Action<...>` デリゲート。 主な違いは、デリゲートがローカル処理のシナリオで使用するものであります。式は有益なリモート プロセスまたはコンピューターで式を評価するが適しています。  
+  
+ **✓ は** デリゲートを呼び出すことによって任意のコードを実行するかを理解し、セキュリティ、正確性、および互換性の影響を与える可能性です。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/exception-throwing.md b/docs/standard/design-guidelines/exception-throwing.md
new file mode 100644
index 00000000000..ca0109f500a
--- /dev/null
+++ b/docs/standard/design-guidelines/exception-throwing.md
@@ -0,0 +1,79 @@
+---
+title: "例外のスロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "例外のスロー"
+  - "明示的に例外のスロー"
+  - "例外はスローされず、設計のガイドライン"
+ms.assetid: 5388e02b-52f5-460e-a2b5-eeafe60eeebe
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 例外のスロー
+このセクションで説明した例外のスローのガイドラインでは、実行エラーの意味を適切な定義が必要です。 メンバーには、ことはできませんが、実行エラーが発生した \(どのようなメンバー名を意味します\) を実行するように設計します。 たとえば場合、 `OpenFile` メソッドは、開いているファイル ハンドルを呼び出し元に戻すことはできません、実行エラーと考えることができます。  
+  
+ ほとんどの開発者が慣れ親しんで除算などの使用状況のエラーを 0 または null 参照例外を使用します。 Framework では、例外は、実行エラーを含むすべてのエラー条件に使用されます。  
+  
+ **X のしないで** エラー コードを返します。  
+  
+ 例外は、フレームワークにエラーを報告の主要な手段です。  
+  
+ **✓ は** 例外をスローして実行の失敗を報告します。  
+  
+ **✓ を検討してください** を呼び出して、プロセスを終了して `System.Environment.FailFast` \(.NET Framework 2.0 の機能\)、コードがさらに実行に対して安全ではないような状況が発生すると、例外をスローする代わりにします。  
+  
+ **X のしないで** 可能であれば、通常の制御、フローの例外を使用します。  
+  
+ システム障害、潜在的な競合状態を持つ操作を除くためユーザーは、例外をスローしないコードを記述できるフレームワークの設計者が Api を設計する必要があります。 たとえば、ユーザーは、例外をスローしないコードを記述できるようにメンバーを呼び出す前に前提条件をチェックする方法を提供できます。  
+  
+ 別のメンバーの前提条件の確認に使用するメンバーは、テスト担当者と呼ばし、実際に実行するメンバーは、渡ってと呼ばれます。  
+  
+ される場合もあります Tester\-doer パターンが許容できないレベルのパフォーマンスのオーバーヘッドを持つことができます。 このような場合いわゆる Try 解析パターンを考慮する必要があります \(を参照してください [例外とパフォーマンス](../../../docs/standard/design-guidelines/exceptions-and-performance.md) の詳細\)。  
+  
+ **✓ を検討してください** パフォーマンスに与える影響の例外をスローします。 1 秒あたり 100 を超える throw レートは、ほとんどのアプリケーションのパフォーマンスに著しい影響を与える可能性があります。  
+  
+ **✓ は** ドキュメント メンバーの違反があったため、一般に呼び出し可能なメンバーによってスローされたすべての例外 \(システムの障害\) ではなくコントラクトおよびコントラクトの一部として処理します。  
+  
+ コントラクトの一部である例外は、次に 1 つのバージョンから変更しないでください \(つまり、例外の種類を変更しないで、および新しい例外を追加してはならない\)。  
+  
+ **X のしないで** いるかどうかをスローをパブリック メンバーに基づいていくつかのオプションです。  
+  
+ **X のしないで** 戻り値として例外を返すパブリック メンバーまたは `out` パラメーター。  
+  
+ それらをスローする代わりに、パブリック Api からの例外を返す例外ベースのエラー報告の利点の多くが果たせなくなります。  
+  
+ **✓ を検討してください** 例外ビルダー メソッドを使用します。  
+  
+ 一般的な場所から同一の例外をスローします。 コードの肥大化を回避するには、例外を作成し、それらのプロパティを初期化するヘルパー メソッドを使用します。  
+  
+ また、例外をスローするメンバーが取得されないインライン展開されます。 Throw ステートメント ビルダー内を移動すると、メンバーのインライン化すことができます。  
+  
+ **X のしないで** 例外フィルター ブロックから例外をスローします。  
+  
+ 例外フィルターでは、例外が発生したときに、CLR で例外をキャッチし、フィルターが false を返します。 この動作は、フィルターが実行し、明示的に false を返すことを区別することはできませんし、つまり、デバッグが困難にします。  
+  
+ **X 回避** 明示的に finally ブロックから例外をスローします。 暗黙的にスローされるスローされる例外をスローするメソッドを呼び出すことが容認あります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/exceptions-and-performance.md b/docs/standard/design-guidelines/exceptions-and-performance.md
new file mode 100644
index 00000000000..c134654b9e2
--- /dev/null
+++ b/docs/standard/design-guidelines/exceptions-and-performance.md
@@ -0,0 +1,87 @@
+---
+title: "例外とパフォーマンス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "tester-doer パターン"
+  - "TryParse パターン"
+  - "例外のスロー"
+  - "パフォーマンスの例外"
+  - "パフォーマンスの例外をスロー"
+ms.assetid: 3ad6aad9-08e6-4232-b336-0e301f2493e6
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 例外とパフォーマンス
+例外に関連する一般的な懸念事項の 1 つは、定期的に失敗するコードの例外を使用している場合、実装のパフォーマンスがされる許容です。 これはもっともです。 メンバーは、例外をスローするときに、パフォーマンスが極端に遅くにできます。 ただし、エラー コードの使用を許可しない例外のガイドラインに厳密に準拠しつつ、良好なパフォーマンスを実現することができます。 このセクションで説明した 2 つのパターンでは、これを行う方法を提案します。  
+  
+ **X のしないで** エラー コードを使用して、例外がパフォーマンスに悪影響を及ぼす影響する問題があるためです。  
+  
+ パフォーマンスを向上させる Tester\-doer パターンまたは Try 解析パターンは、次の 2 つのセクションで説明されているのいずれかを使用することができます。  
+  
+## Tester\-doer パターン  
+ 場合があります、メンバーを 2 つに分割することにより、例外のスローを持つメンバーのパフォーマンスを向上することができます。 見て、 <xref:System.Collections.Generic.ICollection%601.Add%2A> のメソッド、 <xref:System.Collections.Generic.ICollection%601> インターフェイスです。  
+  
+```  
+ICollection<int> numbers = ...   
+numbers.Add(1);  
+```  
+  
+ メソッド `Add` コレクションは読み取り専用の場合にスローします。 これは、メソッドの呼び出しが多くの場合、失敗を想定している場所のシナリオでパフォーマンス問題であることができます。 問題を緩和する方法の 1 つは、値を追加する前に、コレクションが書き込み可能かどうかをテストします。  
+  
+```  
+ICollection<int> numbers = ...   
+...  
+if(!numbers.IsReadOnly){  
+    numbers.Add(1);  
+}  
+```  
+  
+ プロパティであるこの例では、条件をテストに使用するメンバー `IsReadOnly`, 、テスト担当者と呼びます。 スロー元可能性のある操作を実行するために使用するメンバー、 `Add` 例では、メソッドは、渡ってと呼ばれます。  
+  
+ **✓ を検討してください** Tester\-doer パターンに例外をスローするメンバーの共通のシナリオのパフォーマンスの問題を回避する例外に関連します。  
+  
+## Try 解析パターン  
+ 非常に高く、パフォーマンスが重視される Api では、前のセクションで説明した Tester\-doer パターンよりもさらに高速のパターンを使用してください。 メンバーのセマンティクスの一部の場合、適切に定義されたテストを作成するメンバーの名前を調整するためのパターンを呼び出します。 たとえば、 <xref:System.DateTime> を定義、 <xref:System.DateTime.Parse%2A> 文字列の解析に失敗した場合に例外をスローするメソッドです。 対応するも定義されて <xref:System.DateTime.TryParse%2A> を解析しようとするには false が返されます解析は失敗し、正常に解析を使用して、結果を返す場合、 `out` パラメーター。  
+  
+```  
+public struct DateTime {  
+    public static DateTime Parse(string dateTime){   
+        ...   
+    }  
+    public static bool TryParse(string dateTime, out DateTime result){  
+        ...  
+    }  
+}  
+```  
+  
+ このパターンを使用する場合は、厳密な用語で try 機能を定義する必要があります。 メンバーは、適切に定義された try 以外の何らかの理由で失敗した場合、メンバーが対応する例外をスローする必要があります。  
+  
+ **✓ を検討してください** Try 解析パターンに例外をスローするメンバーの共通のシナリオのパフォーマンスの問題を回避する例外に関連します。  
+  
+ **✓ は** このパターンを実装するメソッドにプレフィックス"Try"とブール値の戻り値の型を使用します。  
+  
+ **✓ は** Try 解析パターンを使用する各メンバーの例外のスローを持つメンバーを提供します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/exceptions.md b/docs/standard/design-guidelines/exceptions.md
new file mode 100644
index 00000000000..bc547945687
--- /dev/null
+++ b/docs/standard/design-guidelines/exceptions.md
@@ -0,0 +1,41 @@
+---
+title: "例外のデザイン ガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "例外 [.NET Framework] のデザイン ガイドライン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 例外"
+  - "例外のエラー [.NET Framework]"
+  - "エラーの報告"
+ms.assetid: bc177b2f-7528-4ae4-83db-aacfb04b86d0
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 例外のデザイン ガイドライン
+例外処理には、エラーの戻り値ベースのレポートに比べて多くの利点があります。 適切なフレームワークの設計では、アプリケーション開発者は例外の恩恵を受け、ことができます。 ここでは、例外の利点について説明し、それらを効果的に使用するためのガイドラインを示します。  
+  
+## このセクションの内容  
+ [例外のスロー](../../../docs/standard/design-guidelines/exception-throwing.md)  
+ [標準の例外の型を使用します。](../../../docs/standard/design-guidelines/using-standard-exception-types.md)  
+ [例外とパフォーマンス](../../../docs/standard/design-guidelines/exceptions-and-performance.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/extension-methods.md b/docs/standard/design-guidelines/extension-methods.md
new file mode 100644
index 00000000000..de95fd9e173
--- /dev/null
+++ b/docs/standard/design-guidelines/extension-methods.md
@@ -0,0 +1,61 @@
+---
+title: "拡張メソッド | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 5de945cb-88f4-49d7-b0e6-f098300cf357
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# 拡張メソッド
+拡張メソッドは、言語の機能により、インスタンス メソッドの呼び出しの構文を使用して呼び出される静的メソッドです。 これらのメソッドは、パラメーターを操作するメソッドは、インスタンスを表す 1 つ以上を取得する必要があります。  
+  
+ このような拡張メソッドを定義するクラスは、「スポンサー」クラスと呼ばれ、静的として宣言する必要があります。 拡張メソッドを使用するには、スポンサー クラスを定義する名前空間をインポートいずれかの必要があります。  
+  
+ **X 回避** いないこと、特にお持ちでない型で拡張メソッドを定義します。  
+  
+ 型のソース コードを所有している場合は、通常のインスタンス メソッドを代わりに使用を検討してください。 所有していない場合に、メソッドを追加するには、十分に注意します。 拡張メソッドを多めに使用では、これらのメソッドがあるように設計されていない種類の Api に混乱が生じる可能性があります。  
+  
+ **✓ を検討してください** で、次のシナリオのいずれかの拡張メソッドを使用します。  
+  
+-   ヘルパーを提供するには、コア インターフェイスの観点から機能を言った場合、インターフェイスのすべての実装に関連する機能を記述できます。 具体的な実装は、インターフェイスそれ以外の場合に割り当てることができないためにです。 たとえば、 `LINQ to Objects` 演算子は、すべての拡張メソッドとして実装されます <xref:System.Collections.Generic.IEnumerable%601> 型です。 このため、いずれか `IEnumerable<>` 実装は、LINQ で自動的に有効にします。  
+  
+-   インスタンス メソッドがいくつかの型への依存関係が、このような依存関係をどのように導入するときに、依存関係管理ルールが分割されます。 依存関係など <xref:System.String> に <xref:System.Uri?displayProperty=fullName> 望ましいとは言えませんので `String.ToUri()` を返すインスタンス メソッド `System.Uri` 依存関係管理の観点から間違ったデザインになります。 静的拡張メソッド `Uri.ToUri(this string str)` 返す `System.Uri` 程度設計を向上するようになります。  
+  
+ **X 回避** の拡張メソッドを定義する <xref:System.Object?displayProperty=fullName>です。  
+  
+ VB のユーザーは、拡張メソッドの構文を使用してオブジェクト参照にこのようなメソッドを呼び出すことができるされません。 VB が vb の場合は参照を宣言するオブジェクトが遅延する上のすべてのメソッド呼び出しを強制的にバインドされているため、このようなメソッドの呼び出しをサポートしていません \(と呼ばれる実際のメンバーは実行時に決定されます\)、拡張メソッドへのバインドはコンパイル時 \(事前バインド\) に決まります。  
+  
+ ガイドラインは、同じバインド動作が存在するその他の言語に適用されることに注意してください。 または、拡張メソッドがサポートされていません。  
+  
+ **X のしないで** インターフェイスにメソッドの追加や管理の依存関係がある場合を除いて、拡張の型と同じ名前空間の拡張メソッドを配置します。  
+  
+ **X 回避** 異なる名前空間にある場合でも、同じシグネチャを持つ 2 つ以上の拡張メソッドを定義します。  
+  
+ **✓ を検討してください** 、型がインターフェイスで、拡張メソッドは、ほとんどまたはすべての状況で使用する場合、拡張の型と同じ名前空間に拡張メソッドを定義します。  
+  
+ **X のしないで** 通常他の機能に関連付けられている名前空間の機能を実装する拡張メソッドを定義します。 代わりに、所属する機能に関連付けられている名前空間で定義します。  
+  
+ **X 回避** 拡張メソッド \(たとえば、「拡張」\) に専用の名前空間の汎用名前付けします。 わかりやすい名前を使用して \(たとえば、「ルーティング」\) 代わりにします。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/field.md b/docs/standard/design-guidelines/field.md
new file mode 100644
index 00000000000..2bfbe191813
--- /dev/null
+++ b/docs/standard/design-guidelines/field.md
@@ -0,0 +1,57 @@
+---
+title: "フィールドのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "フィールドのデザイン ガイドライン"
+  - "読み取り専用フィールド"
+  - "メンバー デザインのガイドライン、フィールド"
+ms.assetid: 7cb4b0f3-7a10-4c93-b84d-733f7134fcf8
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# フィールドのデザイン
+カプセル化の原理は、オブジェクト指向設計に最も重要な概念の 1 つです。 この原則は、オブジェクト内に格納されているデータはそのオブジェクトにのみアクセスできることを示しています。  
+  
+ 原則を解釈する便利な方法は以外のコードを型のメンバーを損なうことがなくその型 \(名前または種類の変更\) のフィールドへの変更ができるように、型を設計する必要があります。 すぐに、この解釈は、プライベートのすべてのフィールドである必要がありますを意味します。  
+  
+ 必要であるため、このようなフィールドほとんど定義では、決してを変更する、この厳密な制限から定数と静的な読み取り専用フィールドを除外しました  
+  
+ **X のしないで** パブリックまたはプロテクト インスタンス フィールドを提供します。  
+  
+ パブリックまたはプロテクトにする代わりにフィールドにアクセスするためのプロパティを指定する必要があります。  
+  
+ **✓ は** 定数フィールドは決して変化しない定数に使用します。  
+  
+ コンパイラは、const フィールドの値を直接コードを呼び出す焼き付けます。 そのため、const 値は、互換性の問題の危険を回避しない変更できます。  
+  
+ **✓ は** のパブリック静的を使用して `readonly` フィールドの定義済みのオブジェクト インスタンス。  
+  
+ 型の定義済みのインスタンスがある場合により読み取り専用で、型自体の静的フィールドをパブリックとしてと宣言します。  
+  
+ **X のしないで** に変更可能な型のインスタンスを割り当てる `readonly` フィールドです。  
+  
+ 変更可能な型は、オブジェクトのインスタンスは後で変更できるインスタンスの型です。 たとえば、配列、ほとんどのコレクション、およびストリームは変更可能な型が、 <xref:System.Int32?displayProperty=fullName>, 、<xref:System.Uri?displayProperty=fullName>, 、および <xref:System.String?displayProperty=fullName> はすべて不変です。 参照型のフィールドに対する読み取り専用修飾子には、置き換えられるのフィールドに格納されているインスタンスができなくなりますが、フィールドのインスタンス データのインスタンスを変更するメンバーを呼び出すことによって変更を妨げることはできません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/general-naming-conventions.md b/docs/standard/design-guidelines/general-naming-conventions.md
new file mode 100644
index 00000000000..b5b8e2cb54d
--- /dev/null
+++ b/docs/standard/design-guidelines/general-naming-conventions.md
@@ -0,0 +1,113 @@
+---
+title: "一般的な名前付け規則 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "名前 [.NET Framework] の競合"
+  - "型名の競合"
+  - "言語固有の型名"
+  - "名前付けのガイドラインについては、名前 [.NET Framework]"
+  - "名前 [.NET Framework] の省略形"
+  - "省略形名前付けのガイドライン"
+  - "頭字語の名前付けのガイドライン"
+  - "ハンガリアン記法"
+  - "型名の名前 [.NET Framework]"
+  - "頭字語の名前 [.NET Framework]"
+ms.assetid: d3a77ea1-75d2-4969-a8c3-3e1e3e1aaedc
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 一般的な名前付け規則
+このセクションでは、一般的な名前付け規則単語の選択に関連する言語固有の名前を使用しないようにする方法の省略形と頭字語、および推奨事項の使用に関するガイドラインについて説明します。  
+  
+## 単語の選択  
+ **✓ は** 読みやすい識別子の名前を選択します。  
+  
+ という名前のプロパティなど `HorizontalAlignment` 英語 \- よりも読みやすく、 `AlignmentHorizontal`です。  
+  
+ **✓ は** 簡潔さよりも読みやすさを優先します。  
+  
+ プロパティ名 `CanScrollHorizontally` よりも優れて `ScrollableX` \(x 軸にあいまいな参照\)。  
+  
+ **X のしないで** アンダー スコア、ハイフン、またはその他の英数字以外の文字を使用します。  
+  
+ **X のしないで** ハンガリアン記法を使用します。  
+  
+ **X 回避** 広くのキーワードと競合する識別子を使用してプログラミング言語を使用します。  
+  
+ ルール 4 の共通言語仕様 \(CLS\)、に従って準拠のすべての言語は、その言語のキーワードを識別子として使用する名前付きの項目にアクセスできるようにするメカニズムを提供する必要があります。 C\# の場合、たとえば、使用して、ここではエスケープ メカニズムとして @ です。 ただしよりも、エスケープ シーケンスでメソッドを使用するよりずっと困難であるために、一般的なキーワードを回避することをお勧めではまだです。  
+  
+## 省略形と頭字語を使用します。  
+ **X のしないで** 識別子名の一部としての省略形または短縮形を使用します。  
+  
+ たとえば、使用して `GetWindow` なく `GetWin`です。  
+  
+ **X のしないで** 広く受け入れられているとは、必要な場合にのみの場合でもある頭字語を使用します。  
+  
+## 言語固有の名前を回避します。  
+ **✓ は** 型の名前に言語固有のキーワードではなく、意味的にわかりやすい名前を使用します。  
+  
+ たとえば、 `GetLength` よりも優れた名前は、 `GetInt`です。  
+  
+ **✓ は** 識別子には、その型以外の意味があるないときは、まれなケースで言語固有の名前ではなく、汎用の CLR 型名を使用します。  
+  
+ 変換するメソッドなど、 <xref:System.Int64> はという名前で `ToInt64`, ではなく、 `ToLong` \(ため <xref:System.Int64> 、c\# の CLR 名である\-特定のエイリアス `long`\)。 次の表は、CLR 型名 \(およびその c\#、Visual Basic および C\+\+ の対応する型名\) を使用していくつかの基本データ型を表示します。  
+  
+|C\#|Visual Basic|C\+\+|CLR|  
+|---------|------------------|-----------|---------|  
+|**sbyte**|**SByte**|**char**|**SByte**|  
+|**byte**|**Byte**|**unsigned char**|**Byte**|  
+|**short**|**短い名前**|**short**|**Int16**|  
+|**ushort**|**UInt16**|**unsigned short**|**UInt16**|  
+|**int**|**整数**|**int**|**Int32**|  
+|**uint**|**UInt32**|**unsigned int**|**UInt32**|  
+|**long**|**Long**|**\_\_int64**|**Int64**|  
+|**ulong**|**UInt64**|**unsigned \_\_int64**|**UInt64**|  
+|**float**|**Single**|**float**|**Single**|  
+|**double**|**倍精度浮動小数点型**|**double**|**倍精度浮動小数点型**|  
+|**bool**|**ブール型**|**bool**|**ブール型**|  
+|**char**|**Char**|**wchar\_t**|**Char**|  
+|**string**|**String**|**String**|**String**|  
+|**object**|**オブジェクト**|**オブジェクト**|**オブジェクト**|  
+  
+ **✓ は**  共通名を使用して `value` または `item`, 、繰り返し型の名前識別子が特別な意味を持たないし、パラメーターの型が重要ではないまれなケースではなく。  
+  
+## 既存の Api の新しいバージョンの名前を付ける  
+ **✓ は** 既存の API の新しいバージョンを作成するときに、古い API のような名前を使用します。  
+  
+ これにより、Api の間のリレーションシップを強調表示します。  
+  
+ **✓ は** 既存の API の新しいバージョンを示すプレフィックスではなく、サフィックスの追加を希望します。  
+  
+ これは、ドキュメントについてを参照するときに検出、コンピュータは Intellisense を使用するか。 古いバージョンの API はほとんどのブラウザーおよび Intellisense は、アルファベット順に識別子を表示するために、新しい Api の近くに整理されます。  
+  
+ **✓ を検討してください** サフィックスまたはプレフィックスを追加する代わりに、まったく新しいが意味のある識別子を使用します。  
+  
+ **✓ は** 数値のサフィックスを使用して、既存の API の名前 \(つまり、業界標準である\) 場合は、意味のある唯一の名前は、追加、意味のある場合はサフィックス \(または名前を変更する\)、適切なオプション場合は特に、既存の API の新しいバージョンを示します。  
+  
+ **X のしないで** "Ex"\(または類似\) を使用して、同じ API の以前のバージョンを区別するために識別子のサフィックスです。  
+  
+ **✓ は** 32 ビット整数ではなく、64 ビット整数 \(長整数\) を操作する Api のバージョンを導入するときは、「64」サフィックスを使用します。 のみ、既存の 32 ビット API が存在するときに、この方法を実行する必要があります。64 ビット版のみで新しい Api のことを実行しません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/guidelines-for-collections.md b/docs/standard/design-guidelines/guidelines-for-collections.md
new file mode 100644
index 00000000000..475401b8494
--- /dev/null
+++ b/docs/standard/design-guidelines/guidelines-for-collections.md
@@ -0,0 +1,143 @@
+---
+title: "コレクションに関するガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 297b8f1d-b11f-4dc6-960a-8e990817304e
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# コレクションに関するガイドライン
+任意の型が共通の特性を持つオブジェクトのグループを操作する際に、コレクションを見なすことができます。 実装するには、このような型に適したはほぼ必ず <xref:System.Collections.IEnumerable> または <xref:System.Collections.Generic.IEnumerable%601>, 、ここでおのみ考慮されるようにコレクションには、これらのインターフェイスの一方または両方を実装する型。  
+  
+ **X のしないで** のパブリック Api で弱く型指定されたコレクションを使用します。  
+  
+ すべての戻り値およびコレクションのアイテムを表すパラメーターの型は、\(これは、コレクションのパブリック メンバーにのみ適用されます\) の基本型の正確な項目の種類にする必要があります。  
+  
+ **X のしないで** を使用して <xref:System.Collections.ArrayList> または <xref:System.Collections.Generic.List%601> パブリック Api のです。  
+  
+ これらの型は、パブリック Api ではなく、内部の実装で使用するためのデータ構造です。`List<T>` パフォーマンスと電力消費の Api と柔軟性 cleanness を犠牲に最適です。 たとえば、返された場合 `List<T>`, はこれまでできませんクライアント コードは、コレクションを変更する場合は、通知を受信することです。 また、 `List<T>` など多くのメンバーの公開 <xref:System.Collections.Generic.List%601.BinarySearch%2A>, が役に立たないか多くのシナリオに該当します。 次の 2 つのセクションでは、パブリック Api の使用専用に設計された型 \(抽象化\) について説明します。  
+  
+ **X のしないで** を使用して `Hashtable` または `Dictionary<TKey,TValue>` パブリック Api のです。  
+  
+ これらの型は、内部の実装で使用するためのデータ構造です。 パブリック Api を使用する必要があります <xref:System.Collections.IDictionary>, 、`IDictionary <TKey, TValue>`, 、またはいずれかまたは両方のインターフェイスを実装するカスタム型です。  
+  
+ **X のしないで** を使用して <xref:System.Collections.Generic.IEnumerator%601>, 、<xref:System.Collections.IEnumerator>, 、またはその他の型以外の戻り値の型として実装して、これらのインターフェイスのいずれかを `GetEnumerator` メソッドです。  
+  
+ 型以外の場合、メソッドから列挙子を返す `GetEnumerator` では使用できません、 `foreach` ステートメントです。  
+  
+ **X のしないで** 両方を実装する `IEnumerator<T>` と `IEnumerable<T>` 同じ型にします。 非ジェネリック インターフェイスにも当てはまります `IEnumerator` と `IEnumerable`です。  
+  
+## コレクションのパラメーター  
+ **✓ は** 型の専門性の最も可能性のあるパラメーターの種類として使用します。 ほとんどのメンバーをコレクションのパラメーターを使用すること、 `IEnumerable<T>` インターフェイスです。  
+  
+ **X 回避** を使用して <xref:System.Collections.Generic.ICollection%601> または <xref:System.Collections.ICollection> にアクセスするだけのパラメーターとして、 `Count` プロパティです。  
+  
+ 代わりに、 `IEnumerable<T>` または `IEnumerable` して動的にオブジェクトが実装されているかどうかを確認する `ICollection<T>` または `ICollection`です。  
+  
+## コレクションのプロパティと戻り値  
+ **X のしないで** 設定可能なコレクション プロパティを提供します。  
+  
+ ユーザーは、まずコレクションを消去して、新しい内容を追加し、コレクションの内容を置き換えることができます。 コレクション全体を置き換える一般的なシナリオがある場合は、提供することを検討してください、 `AddRange` コレクション メソッド。  
+  
+ **✓ は** を使用して `Collection<T>` またはそのサブクラスの `Collection<T>` プロパティまたは戻り値を表す読み取り\/書き込みのコレクション。  
+  
+ 場合 `Collection<T>` いくつかの要件を満たしていません \(など、コレクションは実装する必要があります <xref:System.Collections.IList>\) を実装することによってカスタム コレクションを使用して `IEnumerable<T>`, 、`ICollection<T>`, 、または <xref:System.Collections.Generic.IList%601>です。  
+  
+ **✓ は** を使用して <xref:System.Collections.ObjectModel.ReadOnlyCollection%601>, のサブクラス `ReadOnlyCollection<T>`, 、まれなケースで、または `IEnumerable<T>` プロパティまたは戻り値を表す読み取り専用コレクション。  
+  
+ 一般に、使用 `ReadOnlyCollection<T>`します。 いくつかの要件を満たしていない場合 \(など、コレクションは実装する必要があります `IList`\) を実装することによってカスタム コレクションを使用して `IEnumerable<T>`, 、`ICollection<T>`, 、または `IList<T>`です。 カスタムの読み取り専用コレクションを実装する場合は、実装 `ICollection<T>.ReadOnly` false を返します。  
+  
+ あるか、唯一のシナリオをサポートすることが順方向専用のイテレーションであることを確認する場合、単に使用できます `IEnumerable<T>`します。  
+  
+ **✓ を検討してください** コレクションを直接使用する代わりにジェネリックの基本コレクションのサブクラスを使用します。  
+  
+ これにより、優れた名前し基本コレクション型ではないヘルパー メンバーを追加するためです。 これは、特に高水準の Api に該当します。  
+  
+ **✓ を検討してください** のサブクラスを返す `Collection<T>` または `ReadOnlyCollection<T>` から非常に一般的に使用されるメソッドとプロパティ。  
+  
+ これによりするヘルパー メソッドを追加またはコレクションの実装を将来を変更することが可能です。  
+  
+ **✓ を検討してください** コレクションに格納された項目が一意キーを持つ場合は、キー付きのコレクションを使用する \(名前、Id などです。\)。 キー付きコレクションは、整数値とキーの両方でインデックスを作成できるとを継承して実装は通常コレクション `KeyedCollection<TKey,TItem>`します。  
+  
+ 通常、キー付きのコレクションは、メモリ フット プリントが大きくし、メモリのオーバーヘッドが、キーの利点を上回る場合使用しないでです。  
+  
+ **X のしないで** プロパティのコレクションまたはコレクションを返すメソッドから null 値を返します。 代わりに、空のコレクションまたは空の配列を返します。  
+  
+ 一般的な規則は、null および空の \(項目が 0\) コレクション、配列があることと同じ扱われます。  
+  
+### スナップショットとライブのコレクション  
+ 時刻である時点の状態を表すコレクションは、スナップショットのコレクションと呼ばれます。 たとえば、データベース クエリから返された行を含むコレクションには、スナップショットがあります。 常に現在の状態を表すコレクションは、ライブのコレクションと呼ばれます。 たとえば、一連の `ComboBox` 項目は、ライブのコレクション。  
+  
+ **X のしないで** プロパティからのスナップショットのコレクションを返します。 プロパティは、ライブのコレクションを返す必要があります。  
+  
+ プロパティの getter が非常に軽量な操作をする必要があります。 スナップショットを返すには、o \(n\) 操作の内部コレクションのコピーを作成する必要があります。  
+  
+ **✓ は** スナップショット コレクションまたはライブのいずれかを使用して `IEnumerable<T>` \(またはそのサブタイプ\) は揮発性のコレクションを表すため \(つまり、変更可能なコレクションを明示的に変更することがなく\)。  
+  
+ 一般に、共有リソース \(ディレクトリ内のファイルなど\) を表すすべてのコレクションは、揮発性です。 このようなコレクションは、非常に困難か不可能実装は、単に前方参照専用の列挙子にしない限り、ライブのコレクションとして実装するにです。  
+  
+## 配列またはコレクションの選択  
+ **✓ は** コレクションを配列よりも優先されます。  
+  
+ コレクションは、内容を制御するため、時間の経過と共に進化させることができますおよびがより使いやすくします。 さらに、読み取り専用のシナリオの配列の使用はお勧めできません、配列の複製のコストが非常に大きいためです。 使いやすさの調査によると、一部の開発者と感じるユーザー コレクション ベースの Api を使用します。  
+  
+ ただし、低レベルの Api を開発する場合、読み取り\/書き込みシナリオの配列を使用する方がよい場合があります。 配列である、メモリの使用量、ワーキング セットを軽減して、ランタイムが最適化されるため、配列内の要素へのアクセスが高速化します。  
+  
+ **✓ を検討してください** 低レベルの Api で配列を使用する、メモリ消費量を最小限に抑え、パフォーマンスを最大化します。  
+  
+ **✓ は** バイトのコレクションではなくバイト配列を使用します。  
+  
+ **X のしないで** プロパティをプロパティの getter を呼び出すたびに新しい配列 \(内部配列のコピーなど\) を返す必要がある場合は、プロパティの配列を使用します。  
+  
+## カスタム コレクションを実装します。  
+ **✓ を検討してください** から継承する `Collection<T>`, 、`ReadOnlyCollection<T>`, 、または `KeyedCollection<TKey,TItem>` 新しいコレクションを設計するとき。  
+  
+ **✓ は** 実装 `IEnumerable<T>` 新しいコレクションを設計するとき。 実装を検討 `ICollection<T>` も `IList<T>` 理にかなっています。  
+  
+ このようなカスタム コレクションを実装するには場合、によって確立された API パターンに従う `Collection<T>` と `ReadOnlyCollection<T>` 限り近くにします。 つまり、同じメンバーを明示的に実装する、これら 2 つのコレクションの名前となどのように、パラメーターの名前します。  
+  
+ **✓ を検討してください** 非ジェネリック コレクション インターフェイスを実装する \(`IList` と `ICollection`\) 場合は、コレクションは多くの場合する Api に渡される入力としてこれらのインターフェイスを取得します。  
+  
+ **X 回避** 型に、コレクションの概念に関係のない複雑な Api でコレクション インターフェイスを実装します。  
+  
+ **X のしないで** などの非ジェネリックの基本コレクションから継承 `CollectionBase`します。 使用 `Collection<T>`, 、`ReadOnlyCollection<T>`, 、および `KeyedCollection<TKey,TItem>` 代わりにします。  
+  
+### カスタム コレクションの名前を付ける  
+ コレクション \(型を実装する `IEnumerable`\) 主に 2 つの理由が作成されます: 既存のデータ構造とは異なるパフォーマンス特性の構造に固有の操作と多くの場合は、新しいデータ構造を作成するには \(1\) \(など  <xref:System.Collections.Generic.List%601>, 、<xref:System.Collections.Generic.LinkedList%601>, 、<xref:System.Collections.Generic.Stack%601>\)、および特定の項目のセットを保持するための特殊なコレクションを作成するには \(2\) \(など  <xref:System.Collections.Specialized.StringCollection>\)。 データ構造は、アプリケーションやライブラリの内部の実装で最もよく使用されます。 専用コレクションは、\(プロパティおよびパラメーターの型\) としての Api で公開するには、主にします。  
+  
+ **✓ は** を実装する抽象化の名前に「辞書」サフィックスを使用して `IDictionary` または `IDictionary<TKey,TValue>`です。  
+  
+ **✓ は** を実装する型の名前に「コレクション」サフィックスを使用 `IEnumerable` \(またはその子孫のいずれかの\) 項目のリストを表すとします。  
+  
+ **✓ は** カスタム データ構造に適切なデータ構造の名前を使用します。  
+  
+ **X 回避** コレクションの抽象化の名前に"LinkedList"または「ハッシュ」などの特定の実装を暗に示してのサフィックスを使用します。  
+  
+ **✓ を検討してください** コレクションが付いている項目の種類の名前を付けることです。 たとえば、型の項目を格納するコレクション `Address` \(実装 `IEnumerable<Address>`\) はという名前で `AddressCollection`します。 プレフィックス"I"項目の種類が、インターフェイスの場合は、項目の種類を省略できます。 したがって、一連の <xref:System.IDisposable> 項目を呼び出すことができる `DisposableCollection`です。  
+  
+ **✓ を検討してください** 、対応する書き込み可能なコレクションを追加する場合や、フレームワークに既に存在する場合に、読み取り専用のコレクション名に"ReadOnly"プレフィックスを使用します。  
+  
+ たとえば、文字列の読み取り専用コレクションを呼び出す必要があります `ReadOnlyStringCollection`します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/index.md b/docs/standard/design-guidelines/index.md
new file mode 100644
index 00000000000..3b23b2c3519
--- /dev/null
+++ b/docs/standard/design-guidelines/index.md
@@ -0,0 +1,64 @@
+---
+title: "Framework デザイン ガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework クラス ライブラリのライブラリ"
+  - "クラス ライブラリ デザイン ガイドライン [.NET Framework]"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework]"
+ms.assetid: 5fbcaf4f-ea2a-4d20-b0d6-e61dee202b4b
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Framework デザイン ガイドライン
+このセクションでは、ライブラリを拡張し、.NET Framework と対話するをデザインのガイドラインを示します。 目標は、ライブラリの設計者が開発に使用するプログラミング言語とは独立統一されたプログラミング モデルを提供することにより、API の一貫性と使いやすさをことを確認のためです。 .NET Framework を拡張するクラスやコンポーネントを開発する際に、これらのデザイン ガイドラインに従うことをお勧めします。 一貫性のないライブラリ デザイン悪影響を及ぼす開発者の生産性に影響することはお導入します。  
+  
+ ガイドラインは、条件付け簡単な推奨方法として構成 `Do`, 、`Consider`, 、`Avoid`, 、および `Do not`です。 次のガイドラインは、さまざまなソリューション間のトレードオフを理解するクラス ライブラリのデザイナーを支援するものです。 優れたライブラリ デザインではこれらのデザイン ガイドラインに違反することが必要とする状況である可能性があります。 このような場合はまれと、明確で有利な決定の理由は、重要です。  
+  
+ 次のガイドラインがの著書から抜粋した *Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリ \(第 2 版\) 用のパターン*, は Cwalina、Brad エイブラムスによるします。  
+  
+## このセクションの内容  
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)  
+ アセンブリ、名前空間、型、およびクラス ライブラリ内のメンバーの名前付けのガイドラインを提供します。  
+  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)  
+ 静的な抽象クラス、インターフェイス、列挙体、構造体、およびその他の種類を使用するためのガイドラインを提供します。  
+  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)  
+ 設計とプロパティ、メソッド、コンス トラクター、フィールド、イベント、演算子、およびパラメーターの使用に関するガイドラインを提供します。  
+  
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)  
+ イベントや仮想メンバーは、コールバック関数を使用して、サブクラス化などの機能拡張機構について説明し、フレームワークの要件に最適なメカニズムを選択する方法を説明します。  
+  
+ [例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)  
+ デザイン、スロー、および例外をキャッチの設計ガイドラインについて説明します。  
+  
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)  
+ 配列、属性、およびコレクションなどの一般的な型を使用して、シリアル化のサポート、等値演算子のオーバー ロードするためのガイドラインについて説明します。  
+  
+ [一般的な設計パターン](../../../docs/standard/design-guidelines/common-design-patterns.md)  
+ 選択して、依存関係プロパティと、dispose パターンを実装するためのガイドラインを提供します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [概要](../../../docs/framework/get-started/overview.md)   
+ [.NET Framework のロードマップ](http://msdn.microsoft.com/ja-jp/0b46b7c6-9163-4f99-8e58-0d1ee7da8c67)   
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/interface.md b/docs/standard/design-guidelines/interface.md
new file mode 100644
index 00000000000..cce78530a44
--- /dev/null
+++ b/docs/standard/design-guidelines/interface.md
@@ -0,0 +1,63 @@
+---
+title: "インターフェイスのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "インターフェイス [.NET Framework] のデザイン ガイドライン"
+  - "型のデザインのガイドライン、インターフェイス"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] インターフェイス"
+ms.assetid: a016bd18-6710-4358-9438-9f190a295392
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# インターフェイスのデザイン
+ほとんどの Api は、クラスと構造体を使用して、最適なモデル化、またはインターフェイスがより適切な唯一のオプションの場合もあります。  
+  
+ CLR は多重継承をサポートしていません \(つまり、CLR クラスできない複数の基本クラスから継承\) が、基本クラスから継承するだけでなく、1 つまたは複数のインターフェイスを実装する型。 したがって、インターフェイスは、多重継承の効果を実現するためによく使用されます。 たとえば、 <xref:System.IDisposable> インターフェイスにより、参加する継承階層の独立した disposability をサポートする型です。  
+  
+ どの定義で、インターフェイスは、適切なその他の状況では、いくつかの値の型を含むいくつかの種類によってサポートされる共通のインターフェイスを作成するのにです。 値型が以外の型から継承できない <xref:System.ValueType>, 、インターフェイスを実装することができますは、共通の基本型を提供するためには、唯一のオプションは、インターフェイスを使用しています。  
+  
+ **✓ は** 一部共通の API を値型を含む一連の型でサポートする必要がある場合は、インターフェイスを定義します。  
+  
+ **✓ を検討してください** 既に別の型から継承した型でその機能をサポートする必要がある場合は、インターフェイスを定義します。  
+  
+ **X 回避** マーカー インターフェイス \(メンバーを持たないインターフェイス\) を使用します。  
+  
+ 特定の特性 \(マーカー\) されているクラスをマークする必要がある場合は、一般に、インターフェイスではなく、カスタム属性を使用します。  
+  
+ **✓ は** インターフェイスの実装は、少なくとも 1 つの型を提供します。  
+  
+ これにより、インターフェイスの設計を検証します。 たとえば、 <xref:System.Collections.Generic.List%601> の実装には、 <xref:System.Collections.Generic.IList%601> インターフェイスです。  
+  
+ **✓ は** を定義する各インターフェイスを使用するには、少なくとも 1 つの API を提供 \(パラメーターやプロパティとして、インターフェイスを取得するメソッドは、インターフェイスとして型指定された\)。  
+  
+ これにより、インターフェイスのデザインを検証します。 たとえば、 <xref:System.Collections.Generic.List%601.Sort%2A?displayProperty=fullName> 消費、 <xref:System.Collections.Generic.IComparer%601?displayProperty=fullName> インターフェイスです。  
+  
+ **X のしないで** 以前に出荷されたインターフェイスにメンバーを追加します。  
+  
+ この操作と、インターフェイスの実装が損なわします。 バージョン管理の問題を回避するために、新しいインターフェイスを作成する必要があります。  
+  
+ これらのガイドライン」に記載されている状況以外でマネージ コードの再利用可能なライブラリをデザイン インターフェイスではなく、クラスを選択してください、一般に。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/member-overloading.md b/docs/standard/design-guidelines/member-overloading.md
new file mode 100644
index 00000000000..a23442da24c
--- /dev/null
+++ b/docs/standard/design-guidelines/member-overloading.md
@@ -0,0 +1,73 @@
+---
+title: "メンバーのオーバー ロード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "既定の引数"
+  - "オーバー ロードされたメンバー [.NET Framework]"
+  - "オーバー ロード メンバーのデザイン ガイドライン [.NET Framework]"
+  - "オーバーロードされたメンバー"
+  - "メンバーの署名"
+ms.assetid: 964ba19e-8b94-4b5b-b1e3-5a0b531a0bb1
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# メンバーのオーバー ロード
+メンバーのオーバー ロードでは、数やパラメーターの種類においてのみ異なる場合、同じ名前が、同じ型に 2 つ以上のメンバーを作成することを意味します。 などの次に、 `WriteLine` メソッドはオーバー ロードします。  
+  
+```  
+public static class Console {  
+    public void WriteLine();  
+    public void WriteLine(string value);  
+    public void WriteLine(bool value);  
+    ...  
+}  
+  
+```  
+  
+ メソッド、コンス トラクター、およびインデックス付きプロパティは、パラメーターを持つことができます、ためメンバーのみがオーバー ロードできます。  
+  
+ オーバー ロードでは、使いやすさ、生産性、および再利用可能なライブラリの読みやすさを向上させるための最も重要な手法の 1 つです。 パラメーターの数のオーバー ロードにより、コンス トラクターおよびメソッドの単純なバージョンを提供できます。 パラメーターの型のオーバー ロードにより、さまざまな種類の選択されたセットに対して同じ操作を実行するメンバーに対して同じメンバー名を使用できます。  
+  
+ **✓ は** 短いオーバー ロードで使用される既定値を示すためにわかりやすいパラメーター名を使用しようとしています。  
+  
+ **X 回避** オーバー ロードのパラメーター名は任意で変更します。 1 つのオーバー ロードのパラメーターは、別のオーバー ロードのパラメーターと同じ入力を表している場合のパラメーターは、同じ名前である必要があります。  
+  
+ **X 回避** メンバーはオーバー ロードのパラメーターの順序で一貫性のあるできません。 同じ名前のパラメーターは、すべてのオーバー ロード内の同じ位置に表示されます。  
+  
+ **✓ は** 最長のオーバー ロードだけを仮想化 \(機能拡張が必要な場合\)。 短いオーバー ロードは必要がありますから長いオーバー ロードを呼び出すだけです。  
+  
+ **X のしないで** を使用して `ref` または `out` オーバー ロードされたメンバーに対する修飾子です。  
+  
+ 一部の言語では、次のようにオーバー ロードの呼び出しを解決できません。 さらに、このようなオーバー ロード通常完全に異なるセマンティクスを持つし、おそらく必要がありますされませんオーバー ロードが 2 つの個別のメソッド代わりに。  
+  
+ **X のしないで** 同じ位置および類似した種類のパラメーターを使用して、まだ異なるセマンティクスを持つオーバー ロードがあります。  
+  
+ **✓ は**  許可 `null` 省略可能な引数に渡されます。  
+  
+ **✓ は** メンバーの既定の引数を持つメンバーを定義するのではなく、オーバー ロードを使用します。  
+  
+ 既定の引数は、CLS 準拠ではありません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/member.md b/docs/standard/design-guidelines/member.md
new file mode 100644
index 00000000000..24439003d7f
--- /dev/null
+++ b/docs/standard/design-guidelines/member.md
@@ -0,0 +1,50 @@
+---
+title: "メンバー デザインのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "メンバー デザインのガイドラインは、メンバーのデザイン ガイドライン [.NET Framework]"
+  - "メンバー [.NET Framework] のデザイン ガイドライン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] のメンバー"
+  - "メンバー デザインのガイドライン [.NET Framework]"
+ms.assetid: 0ce93180-1d7b-4f8c-9306-f828b2d66b8f
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# メンバー デザインのガイドライン
+メソッド、プロパティ、イベント、コンス トラクター、およびフィールドは、メンバーとしてまとめて呼ばれます。 メンバーが、最終的に、フレームワークのエンドユーザーに、framework の機能が公開されていることを意味します。  
+  
+ メンバーは、仮想または非仮想、具体的なまたは抽象クラスで静的メソッドまたはインスタンスにすることができ、ユーザー補助機能のいくつかの異なるスコープができます。 このすべてのバリエーション驚異的な表現力には、同時に、framework デザイナー側注意が必要です。  
+  
+ この章では、任意の型のメンバーをデザインするときに従う必要が基本的なガイドラインを提供します。  
+  
+## このセクションの内容  
+ [メンバーのオーバー ロード](../../../docs/standard/design-guidelines/member-overloading.md)  
+ [プロパティのデザイン](../../../docs/standard/design-guidelines/property.md)  
+ [コンス トラクターのデザイン](../../../docs/standard/design-guidelines/constructor.md)  
+ [イベントのデザイン](../../../docs/standard/design-guidelines/event.md)  
+ [フィールドのデザイン](../../../docs/standard/design-guidelines/field.md)  
+ [拡張メソッド](../../../docs/standard/design-guidelines/extension-methods.md)  
+ [演算子のオーバー ロード](../../../docs/standard/design-guidelines/operator-overloads.md)  
+ [パラメーターのデザイン](../../../docs/standard/design-guidelines/parameter-design.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/names-of-assemblies-and-dlls.md b/docs/standard/design-guidelines/names-of-assemblies-and-dlls.md
new file mode 100644
index 00000000000..450b73dba37
--- /dev/null
+++ b/docs/standard/design-guidelines/names-of-assemblies-and-dlls.md
@@ -0,0 +1,50 @@
+---
+title: "アセンブリと Dll の名前 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Dll の名前 [.NET Framework]"
+  - "アセンブリの名前 [.NET Framework]"
+  - "アセンブリ [.NET Framework] の名前"
+  - "Dll 名"
+ms.assetid: e800b610-31b4-4949-9c14-cb60e9f254be
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# アセンブリと Dll の名前
+アセンブリは、配置とマネージ コード アプリケーションの id の単位です。 アセンブリは、1 つまたは複数のファイルにまたがることができます、通常このアセンブリは、DLL と一対一をマップします。 そのため、このセクションでは、のみ DLL の名前付け規則、その後、アセンブリの名前付け規則にマップできますがについて説明します。  
+  
+ **✓ は** アセンブリ System.Data などの機能の大きなチャンクを提案する Dll の名前を選択します。  
+  
+ アセンブリと DLL の名前、名前空間の名前に対応する必要はありませんが、アセンブリの名前を付けるときは、名前空間の名前を以下にすることができます。 適切な経験則では、アセンブリに含まれるアセンブリの共通のプレフィックスに基づいた DLL の名前です。 たとえば、2 つの名前空間を持つアセンブリ `MyCompany.MyTechnology.FirstFeature` と `MyCompany.MyTechnology.SecondFeature`, を呼び出す `MyCompany.MyTechnology.dll`します。  
+  
+ **✓ を検討してください** Dll を次のパターンに従って名前付け。  
+  
+ `<Company>.<Component>.dll`  
+  
+ ここで `<Component>` ピリオドで区切られた 1 つまたは複数の句が含まれています。 例:  
+  
+ `Litware.Controls.dll`。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/names-of-classes-structs-and-interfaces.md b/docs/standard/design-guidelines/names-of-classes-structs-and-interfaces.md
new file mode 100644
index 00000000000..1e5b009a735
--- /dev/null
+++ b/docs/standard/design-guidelines/names-of-classes-structs-and-interfaces.md
@@ -0,0 +1,116 @@
+---
+title: "クラス、構造体、およびインターフェイスの名前 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "型名、ガイドライン"
+  - "名前のクラス [.NET Framework]"
+  - "列挙体 [.NET Framework] の名前"
+  - "名前 [.NET Framework] インターフェイス"
+  - "一般的な型名"
+  - "型名の名前 [.NET Framework]"
+  - "クラスの名前 [.NET Framework]"
+  - "名前のインターフェイス [.NET Framework]"
+  - "ジェネリック型パラメーター"
+ms.assetid: 87a4b0da-ed64-43b1-ac43-968576c444ce
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# クラス、構造体、およびインターフェイスの名前
+次の名前付けのガイドラインは、一般的な種類の名前付けに適用されます。  
+  
+ **✓ は** クラスと構造体には名詞または名詞句、pascal 表記を使用を使用して名前を付けます。  
+  
+ これは、動詞句とという名前のメソッドと型名を区別します。  
+  
+ **✓ は** 形容詞句、または場合によって名詞または名詞句のインターフェイスの名前します。  
+  
+ 名詞と名詞句をめったに使用する必要があり、抽象クラスとインターフェイスではなく、型があることを示す可能性があります。  
+  
+ **X のしないで** クラス名のプレフィックス \("C"など\) を指定します。  
+  
+ **✓ を検討してください** 、基本クラスの名前のクラスを派生の名前を終了します。  
+  
+ これはとても読みにくいはであり、関係を明確に説明します。 コード内のいくつかの例に示します: `ArgumentOutOfRangeException`, が付いての `Exception`, 、および `SerializableAttribute`, が付いての `Attribute`です。 ただし、これは次のガイドラインを適用することで、適切な判断を使用するにはなど、 `Button` クラスは、一種の `Control` イベントが `Control` 名前に表示されません。  
+  
+ **✓ は** インターフェイス名のプレフィックス文字では、型がインターフェイスであることを示します。  
+  
+ たとえば、 `IComponent` \(わかりやすい名詞\) `ICustomAttributeProvider` \(名詞句\)、および `IPersistable` \(形容詞\) は適切なインターフェイス名。 同様に他の種類名の省略形を回避します。  
+  
+ **✓ は** だけで、"I"プレフィックスのインターフェイス名、クラスがインターフェイスの標準的な実装であるクラス – インターフェイスのペアを定義するときに名前が異なることを確認します。  
+  
+## ジェネリック型パラメーターの名前  
+ ジェネリックは .NET Framework 2.0 に追加されました。 機能の導入と呼ばれる識別子の新しい種類 *パラメーター入力*します。  
+  
+ **✓ は** 1 文字の名前が完全に説明し、わかりやすい名前と値を追加していない限り、わかりやすい名前を持つジェネリック型パラメーターの名前します。  
+  
+ **✓ を検討してください** を使用して `T` 単一文字の型パラメーターが 1 つの型の型のパラメーター名として。  
+  
+```  
+public int IComparer<T> { ... }  
+public delegate bool Predicate<T>(T item);  
+public struct Nullable<T> where T:struct { ... }  
+```  
+  
+ **✓ は** 説明的な型のパラメーター名のプレフィックス `T`します。  
+  
+```  
+public interface ISessionChannel<TSession> where TSession : ISession{  
+    TSession Session { get; }  
+}  
+```  
+  
+ **✓ を検討してください** 制約を示す名前、パラメーターの型パラメーターに配置されます。  
+  
+ パラメーターに制約があるなど `ISession` という `TSession`します。  
+  
+## 一般的な種類の名前  
+ **✓ は** から派生した、または特定の .NET Framework 型を実装する型の名前を付けるときは、次の表に記載されているガイドラインに従ってください。  
+  
+|基本データ型|型の派生と実装ガイドライン|  
+|------------|-------------------|  
+|`System.Attribute`|**✓ は** カスタム属性クラスの名前にサフィックス"Attribute"を追加します。 カスタム属性クラスの名前にサフィックス"Attribute"を追加します。|  
+|`System.Delegate`|**✓ は** イベントで使用されているデリゲートの名前にサフィックス"EventHandler"を追加します。<br /><br /> **✓ は** 以外のイベント ハンドラーとして使用されているデリゲートの名前に"Callback"サフィックスを追加します。<br /><br /> **X のしないで** デリゲートに「Delegate」サフィックスを追加します。|  
+|`System.EventArgs`|**✓ は** "EventArgs"サフィックスを追加|  
+|`System.Enum`|**X のしないで** このクラスから派生、代わりに使用する言語でサポートされているキーワードを使用して、たとえば、C\# の場合、enum キーワードを使用します。<br /><br /> **X のしないで** 「列挙」または"Flag"サフィックスを追加|  
+|`System.Exception`|**✓ は** 「例外」サフィックスを追加|  
+|`IDictionary` <br /> `IDictionary<TKey,TValue>`|**✓ は** 「辞書」サフィックスを追加 なお `IDictionary` は、コレクションの特定の型ですが、このガイドラインに依存している一般的なコレクション ガイドラインよりも優先されます。|  
+|`IEnumerable` <br /> `ICollection` <br /> `IList` <br /> `IEnumerable<T>` <br /> `ICollection<T>` <br /> `IList<T>`|**✓ は** 「コレクション」サフィックスを追加|  
+|`System.IO.Stream`|**✓ は** 「ストリーム」サフィックスを追加|  
+|`CodeAccessPermission IPermission`|**✓ は** 「アクセス」サフィックスを追加|  
+  
+## 列挙体の名前を付ける  
+ 一般に列挙型 \(列挙型とも呼ばれます\) の名前にすることは \(pascal 表記を使用など\) 標準的な型の名前付け規則に従う必要があります。 ただし、この列挙型に適用する追加のガイドラインがあります。  
+  
+ **✓ は** の値がビット フィールドでない場合は、列挙体の単数形の型名を使用します。  
+  
+ **✓ は** フラグ列挙体とも呼ばれます。 の値として、ビット フィールドを持つ列挙体の複数形の型名を使用します。  
+  
+ **X のしないで** 列挙型の型名で、「列挙」サフィックスを使用します。  
+  
+ **X のしないで** 「フラグの設定」を使用するか列挙型に"Flags"サフィックスが名前を入力します。  
+  
+ **X のしないで** リッチ テキストを持つ列挙型などの列挙値の名前 \(たとえば、"ad"ADO 列挙型にします。\)、"rtf"にプレフィックスを使用します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/names-of-namespaces.md b/docs/standard/design-guidelines/names-of-namespaces.md
new file mode 100644
index 00000000000..dc273634a12
--- /dev/null
+++ b/docs/standard/design-guidelines/names-of-namespaces.md
@@ -0,0 +1,100 @@
+---
+title: "名前空間の名前 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "名前 [.NET Framework] の競合"
+  - "名前空間の名前 [.NET Framework]"
+  - "型名の競合"
+  - "名前空間 [.NET Framework] の名前"
+  - "型名の名前 [.NET Framework]"
+ms.assetid: a49058d2-0276-43a7-9502-04adddf857b2
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 名前空間の名前
+として他の名前付けのガイドラインと名前空間の名前を付けるときの目標を作成するための十分なわかりやすくするためにどのような名前空間のコンテンツがある可能性がすぐにわかるフレームワークを使用するプログラマにとってします。 次のテンプレートは、名前空間の名前付けに関する一般的な規則を指定します。  
+  
+ `<Company>.(<Product>|<Technology>)[.<Feature>][.<Subnamespace>]`  
+  
+ 例を次に示します。  
+  
+ `Fabrikam.Math`   
+ `Litware.Security`  
+  
+ **✓ は** 名前空間名を同じ名前の異なる会社から名前空間を防ぐために会社名のプレフィックスします。  
+  
+ **✓ は** 名前空間の名前の 2 番目のレベルで、バージョンに依存しない安定した製品名を使用します。  
+  
+ **X のしないで** 企業内のグループ名の有効期間の短いする傾向があるため、名前空間の階層内の名前の基準として組織階層を使用します。 関連するテクノロジのグループの周囲の名前空間の階層を整理します。  
+  
+ **✓ 操作を行います** 期間が設定された、pascal 表記を使用し、別の名前空間のコンポーネントを使用して \(例: `Microsoft.Office.PowerPoint`\)。 お客様のブランドは、従来とは異なる大文字と小文字を使用している場合は、一般的な名前空間の大文字と小文字から以上逸脱している場合でも、ブランドで定義された大文字と小文字に従ってください。  
+  
+ **✓ を検討してください** 適切な場所に複数形の名前空間の名前を使用します。  
+  
+ たとえば、使用して `System.Collections` の代わりに `System.Collection`します。 ブランド名や略語は、この規則の例外をただしです。 たとえば、使用して `System.IO` の代わりに `System.IOs`します。  
+  
+ **X のしないで** その名前空間、名前空間と型に同じ名前を使用します。  
+  
+ たとえば、使用しないでください `Debug` 、名前空間と名前を指定し、またという名前のクラスを提供 `Debug` 同じ名前空間。 いくつかのコンパイラでは、完全に修飾するには、このような型が必要です。  
+  
+### 名前空間と型名の競合  
+ **X のしないで** など、ジェネリック型の名前が導入 `Element`, 、`Node`, 、`Log`, 、および `Message`です。  
+  
+ 名前を入力する可能性は競合シナリオで共通の非常に高い確率があります。 ジェネリック型の名前を修飾する必要があります \(`FormElement`, 、`XmlNode`, 、`EventLog`, 、`SoapMessage`\)。  
+  
+ 異なるカテゴリの名前空間の型名の競合を回避するための特定のガイドラインがあります。  
+  
+-   **アプリケーション モデルの名前空間**  
+  
+     1 つのアプリケーション モデルに属する名前空間は同時に、非常によく使用しますが、他のアプリケーション モデルの名前空間と併用することはほぼありません。 たとえば、 <xref:System.Windows.Forms?displayProperty=fullName> と共に名前空間が使用する非常にまれ、 <xref:System.Web.UI?displayProperty=fullName> 名前空間。 よく知られているアプリケーション モデルの名前空間のグループの一覧を次に示します。  
+  
+     `System.Windows*`   
+     `System.Web.UI*`  
+  
+     **X のしないで** 1 つのアプリケーション モデル内で名前空間の型に同じ名前を指定します。  
+  
+     たとえば、という名前の型を追加しない `Page` に、 <xref:System.Web.UI.Adapters?displayProperty=fullName> 名前空間、ため、 <xref:System.Web.UI?displayProperty=fullName> 名前空間に既にという名前の型が含まれています `Page`します。  
+  
+-   **インフラストラクチャの名前空間**  
+  
+     このグループには、あまり一般的なアプリケーションの開発時にインポートされる名前空間が含まれています。 たとえば、 `.Design` ツールのプログラミングの開発時に名前空間が主に使用します。 これらの名前空間内の型との競合の回避は重要ではありません。  
+  
+-   **コア名前空間**  
+  
+     すべてのコア名前空間を含める `System` 名前空間、アプリケーション モデルの名前空間とインフラストラクチャの名前空間を除外します。 その他のコア名前空間が含まれます `System`, 、`System.IO`, 、`System.Xml`, 、および `System.Net`です。  
+  
+     **X のしないで** を指定します。 コア名前空間のすべての型と競合する名前を入力します。  
+  
+     たとえば、使用しないで `Stream` 型名として。 競合する <xref:System.IO.Stream?displayProperty=fullName>, 、非常によく型を使用します。  
+  
+-   **テクノロジ名前空間のグループ**  
+  
+     このカテゴリには、同じ最初の 2 つの名前空間ノードを持つすべての名前空間が含まれています。 `(<Company>.<Technology>*`\)、など `Microsoft.Build.Utilities` と `Microsoft.Build.Tasks`です。 1 つのテクノロジに属している型が互いに競合しないことが重要です。  
+  
+     **X のしないで** 1 つのテクノロジでは、他の種類と競合する型の名前を割り当てます。  
+  
+     **X のしないで** \(ない場合、このテクノロジは、アプリケーション モデルで使用するものではありません\) テクノロジの名前空間の型とのアプリケーション モデルの名前空間の型名の競合が発生します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/names-of-type-members.md b/docs/standard/design-guidelines/names-of-type-members.md
new file mode 100644
index 00000000000..d14d6ffe722
--- /dev/null
+++ b/docs/standard/design-guidelines/names-of-type-members.md
@@ -0,0 +1,117 @@
+---
+title: "型のメンバーの名前 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "イベント [.NET Framework] の名前"
+  - "名前のメソッド [.NET Framework]"
+  - "型のメンバー"
+  - "[.NET Framework] ダイアログ ボックスのプロパティ名"
+  - "フィールド名"
+  - "フィールド名"
+  - "型のメンバーの名前 [.NET Framework]"
+  - "型のメンバー [.NET Framework]"
+ms.assetid: af5a0903-36af-4c2a-b848-cf959affeaa5
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 型のメンバーの名前
+メンバーの型が加えられた: メソッド、プロパティ、イベント、コンス トラクター、およびフィールドです。 次のセクションでは、型のメンバーの名前付けのガイドラインについて説明します。  
+  
+## メソッドの名前  
+ メソッドはアクションを実行する手段になっているために、デザインのガイドラインは動詞または動詞句メソッド名にすることが必要です。 またこのガイドラインに従うとは、メソッドの名前に名詞または形容詞句であるプロパティと型の名前を区別するために機能します。  
+  
+ **✓ は** 動詞または動詞句であるメソッドの名前を付けます。  
+  
+```  
+public class String {  
+    public int CompareTo(...);  
+    public string[] Split(...);  
+    public string Trim();  
+}  
+  
+```  
+  
+## プロパティの名前  
+ その他のメンバーとは異なりは、名詞句または形容詞名にプロパティを指定する必要があります。 プロパティは、データを参照し、プロパティの名前に反映されるためです。 プロパティ名は、pascal 表記を使用が常に使用されます。  
+  
+ **✓ は** 名詞、名詞句、または形容詞として解釈を使用してプロパティを指定します。  
+  
+ **X のしないで** 次の例のように、"Get"メソッドの名前に一致するプロパティがあります。  
+  
+ `public string TextWriter { get {...} set {...} }`   
+ `public string GetTextWriter(int value) { ... }`  
+  
+ このパターンでは、通常、プロパティが、メソッドを実際にする必要がありますを示します。  
+  
+ **✓ は** "List"または「コレクション」の前に、単数形の語句を使用する代わりにコレクション内の項目を記述する複数形の語句でコレクションのプロパティの名前  
+  
+ **✓ は** 肯定フレーズでブール型プロパティの名前 \(`CanSeek` の代わりに `CantSeek`\)。 ブール型プロパティもプレフィックスを必要に応じて、"Is"と"、"したり、「は、」値を追加する場合に限定します。  
+  
+ **✓ を検討してください** プロパティの型と同じ名前を提供します。  
+  
+ たとえば、次のプロパティ正しく取得および設定という名前の列挙値 `Color`, プロパティの名前を指定するため、 `Color`:  
+  
+```  
+public enum Color {...}  
+public class Control {  
+    public Color Color { get {...} set {...} }  
+}  
+```  
+  
+## イベントの名前  
+ イベントは、常に何らかのアクションでは、いずれかの問題であるか、1 つが発生したことを指します。 そのためと同様にメソッド、イベントが、動詞と名前付き動詞の時制を使用して、イベントが発生すると時間を指定します。  
+  
+ **✓ は** イベントの名前は動詞または動詞句にします。  
+  
+ 例としては、 `Clicked`, 、`Painting`, 、`DroppedDown`, 、という具合です。  
+  
+ **✓ は** 現在と過去時制を使用しての前後の概念でイベントの名前を付けます。  
+  
+ たとえば、ウィンドウが閉じられる前に発生する close イベントが呼び出されます `Closing`, 、ウィンドウが閉じられた後に発生する 1 つと呼ばれる、 `Closed`です。  
+  
+ **X のしないで** "Before"または"After"プレフィックスまたは postfixes を示す前と後のイベントを使用します。 使用して現在と過去時制前述のようです。  
+  
+ **✓ は** "EventHandler"サフィックスを持つイベント ハンドラー \(デリゲートがイベントの種類として使用\) という名前を次の例で示すようにします。  
+  
+ `public delegate void ClickedEventHandler(object sender, ClickedEventArgs e);`  
+  
+ **✓ は** という名前の 2 つのパラメーターを使用して `sender` と `e` イベント ハンドラーにします。  
+  
+ Sender パラメーターでは、イベントを発生させたオブジェクトを表します。 型の sender パラメーターは、通常 `object`, より具体的な種類を使用することはあっても、です。  
+  
+ **✓ は** イベントという名前を"EventArgs"サフィックスを持つ引数クラスです。  
+  
+## フィールドの名前  
+ フィールドの名前付けのガイドラインは、静的なパブリック、プロテクト フィールドに適用されます。 内部、プライベート フィールドが、ガイドラインが対応していないとでは、パブリックまたはプロテクトのインスタンス フィールドは許可されていない、 [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)します。  
+  
+ **✓ は** フィールド名に pascal 表記を使用を使用します。  
+  
+ **✓ は** 名詞、名詞句、または形容詞として解釈を使用してフィールドの名前します。  
+  
+ **X のしないで** フィールド名にプレフィックスを使用します。  
+  
+ たとえば、使わない「g \_」または「s \_」を静的フィールドを示します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/naming-guidelines.md b/docs/standard/design-guidelines/naming-guidelines.md
new file mode 100644
index 00000000000..dc61a7440be
--- /dev/null
+++ b/docs/standard/design-guidelines/naming-guidelines.md
@@ -0,0 +1,53 @@
+---
+title: "名前付けのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "名前付けのガイドラインについては、名前 [.NET Framework]"
+  - "名前付けのガイドライン [.NET Framework]"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] の名前"
+  - "名前を書式指定 [.NET Framework]"
+  - "クラス ライブラリの要素名の識別子"
+  - "名前 [.NET Framework]"
+  - "形式の名前付けのガイドライン [.NET Framework]"
+ms.assetid: fc076d66-9b5f-42d3-aa65-61d970c794a3
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 名前付けのガイドライン
+次の一貫性のある一連のフレームワークの開発に名前付け規則と、フレームワークの使いやすさに大きな金額を指定できます。 これにより、広範囲に分散されたプロジェクトで多くの開発者によって使用されるフレームワークことができます。 フォームの一貫性、超えるフレームワーク要素の名前は、簡単に認識する必要があるとして各要素の機能を伝達する必要があります。  
+  
+ この章の目的は、開発者に即時意味のある名前に一貫性のある名前付け規則のセットを提供します。  
+  
+ 一般的なコード開発のガイドラインは、コード全体でより一貫性のある名前付けになると、これらの名前付け規則を採用すること、ただし必要があるだけは公開される Api に適用 \(パブリックまたはプロテクト型とメンバー、および明示的に実装されたインターフェイス\)。  
+  
+## このセクションの内容  
+ [大文字と小文字の表記規則](../../../docs/standard/design-guidelines/capitalization-conventions.md)  
+ [一般的な名前付け規則](../../../docs/standard/design-guidelines/general-naming-conventions.md)  
+ [アセンブリと Dll の名前](../../../docs/standard/design-guidelines/names-of-assemblies-and-dlls.md)  
+ [名前空間の名前](../../../docs/standard/design-guidelines/names-of-namespaces.md)  
+ [クラス、構造体、およびインターフェイスの名前](../../../docs/standard/design-guidelines/names-of-classes-structs-and-interfaces.md)  
+ [型のメンバーの名前](../../../docs/standard/design-guidelines/names-of-type-members.md)  
+ [パラメーターの名前を付ける](../../../docs/standard/design-guidelines/naming-parameters.md)  
+ [リソースの名前付け](../../../docs/standard/design-guidelines/naming-resources.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/naming-parameters.md b/docs/standard/design-guidelines/naming-parameters.md
new file mode 100644
index 00000000000..8487ab00bfb
--- /dev/null
+++ b/docs/standard/design-guidelines/naming-parameters.md
@@ -0,0 +1,51 @@
+---
+title: "パラメーターの名前を付ける | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "パラメーター名"
+  - "パラメーターの名前 [.NET Framework]"
+ms.assetid: ca3c956e-725a-441b-b4e3-eab5d472f41c
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# パラメーターの名前を付ける
+読みやすさの明らかなため、以外には、パラメーターがドキュメントでは、デザイナーで表示される Intellisense とクラス参照機能を提供するビジュアル デ ザイン ツールとためパラメーター名に関するガイドラインに従う必要があります。  
+  
+ **✓ は** パラメーター名の camel 表記を使用します。  
+  
+ **✓ は** わかりやすいパラメーター名を使用します。  
+  
+ **✓ を検討してください** パラメーターの型ではなく、パラメーターの意味に基づく名前を使用します。  
+  
+### 演算子のオーバー ロードのパラメーターの名前を付ける  
+ **✓ は** を使用して `left` と `right` パラメーターに意味がない場合は、二項演算子のオーバー ロード パラメーター名にします。  
+  
+ **✓ は** を使用して `value` の単項演算子のオーバー ロードのパラメーター名、パラメーターの意味がない場合。  
+  
+ **✓ を検討してください** 大きな価値が増加している場合、オーバー ロードのパラメーターの演算子にわかりやすい名前。  
+  
+ **X のしないで** 使用略語や数値の添字演算子のオーバー ロードのパラメーターの名前。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/naming-resources.md b/docs/standard/design-guidelines/naming-resources.md
new file mode 100644
index 00000000000..e3a03a34316
--- /dev/null
+++ b/docs/standard/design-guidelines/naming-resources.md
@@ -0,0 +1,55 @@
+---
+title: "リソースの名前付け | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "リソースのローカライズされた名前 [.NET Framework]"
+  - "ローカリゼーションでは、名前付けのガイドライン"
+  - "リソース名"
+  - "名前付けのガイドライン、グローバル アプリケーション"
+  - "名前付けのガイドライン、国際対応のアプリケーション"
+ms.assetid: 8b0e97f3-7877-44fd-bc76-e05d36d5d79c
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# リソースの名前付け
+場合プロパティと同様、特定のオブジェクトを使用してローカライズ可能なリソースを参照できる、ので、リソースの名前付けのガイドラインは、プロパティのガイドラインに似ています。  
+  
+ **✓ は** リソース キーで pascal 表記を使用を使用します。  
+  
+ **✓ は** 短い識別子ではなくわかりやすいを提供します。  
+  
+ **X のしないで** メインの CLR 言語の言語に固有のキーワードを使用します。  
+  
+ **✓ は** のみ英数字とアンダー スコアのリソースの名前付けに使用します。  
+  
+ **✓ は** 例外メッセージ リソースの名前付け規則を使用します。  
+  
+ リソース識別子は、例外の種類名と、例外の短い識別子にする必要があります。  
+  
+ `ArgumentExceptionIllegalCharacters`   
+ `ArgumentExceptionInvalidName`   
+ `ArgumentExceptionFileNameIsMalformed`  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [名前付けのガイドライン](../../../docs/standard/design-guidelines/naming-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/nested-types.md b/docs/standard/design-guidelines/nested-types.md
new file mode 100644
index 00000000000..f48bcdbdc84
--- /dev/null
+++ b/docs/standard/design-guidelines/nested-types.md
@@ -0,0 +1,60 @@
+---
+title: "入れ子にされた型 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "入れ子にされた型"
+  - "パブリックな入れ子になった型"
+  - "型のデザインのガイドライン、入れ子にされた型"
+  - "入れ子にされた型"
+  - "型のメンバー [.NET Framework]"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] の入れ子になった型"
+ms.assetid: 12feb7f0-b793-4d96-b090-42d6473bab8c
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 入れ子にされた型
+入れ子にされた型は、外側の型と呼ばれる別の種類のスコープ内で定義されている型です。 入れ子にされた型は、それを囲む型のすべてのメンバーへのアクセスを持ちます。 たとえば、プライベート フィールドの定義の外側の型と、外側の型のすべての先祖で定義されたフィールドを保護するアクセス権があります。  
+  
+ 一般に、控え目入れ子にされた型に使用する必要があります。 直接呼び出すべきではないいくつかの理由があります。 一部の開発者は、概念を完全に習熟していません。 これらの開発者では、入れ子にされた型の変数の宣言の構文を使用してなどいない可能性があります、します。 入れ子にされた型は非常に緊密にもと連動して、外側の型では、そのため、汎用的な型にすることが適していません。  
+  
+ 入れ子にされた型は、包含する型の実装の詳細をモデル化に最適です。 エンドユーザーは、入れ子にされた型の変数を宣言する必要はほとんどすることはほぼありません、入れ子にされた型を明示的にインスタンス化する必要があります。 たとえば、コレクションの列挙子は、そのコレクションの入れ子にされた型にできます。 列挙子は通常その外側の型でインスタンス化し、多くの言語では、foreach ステートメントをサポート、ため列挙子の変数は、エンドユーザーによって宣言されていることはほとんどありませんが存在します。  
+  
+ **✓ は** 入れ子にされた型とその外側の型間の関係のあるメンバーのアクセシビリティのセマンティクスの要件を満たしているときに、入れ子にされた型を使用します。  
+  
+ **X のしないで** 、論理的なグループとしてパブリック入れ子にされた型を使用して構築; この名前空間を使用します。  
+  
+ **X 回避** 入れ子にされた型を公開します。 唯一の例外は、入れ子にされた型の変数をサブクラスまたはその他の高度なカスタマイズ シナリオなどのまれなシナリオでのみ宣言する必要があるかどうかです。  
+  
+ **X のしないで** 型がそれを含む型の外部で参照される可能性が高い場合は、入れ子にされた型を使用します。  
+  
+ たとえば、クラスで定義されているメソッドに渡される列挙型をクラスに入れ子にされた型として定義する必要があります。  
+  
+ **X のしないで** クライアント コードでインスタンス化する必要がある場合は、入れ子にされた型を使用します。  型のパブリック コンス トラクターの場合、必要がありますされていない入れ子にします。  
+  
+ 型がそれ自体では、framework 内の場所を示すためにだと型をインスタンス化する場合 \(できます作成し、これを使用して作業し、外側の型を使用することがなく破棄\)、つまり入れ子にしてはいけないとします。 内部型必要がありますいない広範囲に再利用、外部型の関係のない外部の型にも一切します。  
+  
+ **X のしないで** インターフェイスのメンバーとして入れ子にされた型を定義します。 多くの言語は、このようなコンストラクトをサポートしていません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/operator-overloads.md b/docs/standard/design-guidelines/operator-overloads.md
new file mode 100644
index 00000000000..51aaff67619
--- /dev/null
+++ b/docs/standard/design-guidelines/operator-overloads.md
@@ -0,0 +1,127 @@
+---
+title: "演算子のオーバー ロード | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "[.NET Framework] ダイアログ ボックスの演算子のオーバー ロード"
+  - "名前 [.NET Framework] のオーバー ロードされた演算子"
+  - "メンバー デザインのガイドライン, オペレーター"
+  - "オーバーロードされた演算子"
+ms.assetid: 37585bf2-4c27-4dee-849a-af70e3338cc1
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 演算子のオーバー ロード
+演算子のオーバー ロードでは、組み込みの言語プリミティブに存在した場合のように表示されるフレームワークの種類を許可します。  
+  
+ 許可されている、いくつかの状況で便利ですが、慎重に行って演算子のオーバー ロードを使用してください。 演算子のオーバー ロードがされて悪用の簡単な方法があります。 操作に演算子を使用するフレームワークの設計者の起動時など、多くの場合があります。 次のガイドラインは、演算子のオーバー ロードを使用するタイミングと方法を決定するのに役立ちます。  
+  
+ **X 回避** を除くいえますプリミティブ \(組み込み\) 型のような種類の演算子のオーバー ロードを定義します。  
+  
+ **✓ を検討してください** プリミティブ型のように感じがする型の演算子のオーバー ロードを定義します。  
+  
+ たとえば、 <xref:System.String?displayProperty=fullName> が `operator==` と `operator!=` を定義します。  
+  
+ **✓ は** 演算子のオーバー ロードを数値を表現する構造体の定義 \(など <xref:System.Decimal?displayProperty=fullName>\)。  
+  
+ **X のしないで** 演算子のオーバー ロードを定義するときに、利かせようです。  
+  
+ 演算子のオーバー ロードは、順番を一見して、操作の結果はどのくらいにする場合に便利です。 合理的に 1 を減算するたとえば、 <xref:System.DateTime> 別の `DateTime` を取得し、 <xref:System.TimeSpan>です。 ただし、共用体の 2 つのデータベース クエリに論理演算子を使用するか、ストリームに書き込むシフト演算子を使用する適切ではありません。  
+  
+ **X のしないで** オーバー ロードを定義する型のオペランドの少なくとも 1 つがない場合、演算子がオーバー ロードを提供します。  
+  
+ **✓ は** 演算子は対称的にオーバー ロードします。  
+  
+ たとえば、オーバー ロードする場合、 `operator==`, 、オーバー ロードもする必要があります、 `operator!=`です。 同様に、オーバー ロードする場合、 `operator<`, 、オーバー ロードする必要がありますも、 `operator>`, 、という具合です。  
+  
+ **✓ を検討してください** 各オーバー ロードされた演算子に対応するフレンドリ名を持つメソッドを指定します。  
+  
+ 多くの言語は、演算子のオーバー ロードをサポートしていません。 このため、演算子をオーバー ロードする型が同等の機能は、適切なドメイン固有の名前を持つセカンダリ メソッドを含めることをお勧めします。  
+  
+ 次の表には、演算子と対応するわかりやすいメソッド名の一覧が含まれています。  
+  
+|C\# 演算子シンボル|メタデータ名|フレンドリ名|  
+|-----------------|------------|------------|  
+|`N/A`|`op_Implicit`|`To<TypeName>/From<TypeName>`|  
+|`N/A`|`op_Explicit`|`To<TypeName>/From<TypeName>`|  
+|`+ (binary)`|`op_Addition`|`Add`|  
+|`- (binary)`|`op_Subtraction`|`Subtract`|  
+|`* (binary)`|`op_Multiply`|`Multiply`|  
+|`/`|`op_Division`|`Divide`|  
+|`%`|`op_Modulus`|`Mod or Remainder`|  
+|`^`|`op_ExclusiveOr`|`Xor`|  
+|`& (binary)`|`op_BitwiseAnd`|`BitwiseAnd`|  
+|`&#124;`|`op_BitwiseOr`|`BitwiseOr`|  
+|`&&`|`op_LogicalAnd`|`And`|  
+|`&#124;&#124;`|`op_LogicalOr`|`Or`|  
+|`=`|`op_Assign`|`Assign`|  
+|`<<`|`op_LeftShift`|`LeftShift`|  
+|`>>`|`op_RightShift`|`RightShift`|  
+|`N/A`|`op_SignedRightShift`|`SignedRightShift`|  
+|`N/A`|`op_UnsignedRightShift`|`UnsignedRightShift`|  
+|`==`|`op_Equality`|`Equals`|  
+|`!=`|`op_Inequality`|`Equals`|  
+|`>`|`op_GreaterThan`|`CompareTo`|  
+|`<`|`op_LessThan`|`CompareTo`|  
+|`>=`|`op_GreaterThanOrEqual`|`CompareTo`|  
+|`<=`|`op_LessThanOrEqual`|`CompareTo`|  
+|`*=`|`op_MultiplicationAssignment`|`Multiply`|  
+|`-=`|`op_SubtractionAssignment`|`Subtract`|  
+|`^=`|`op_ExclusiveOrAssignment`|`Xor`|  
+|`<<=`|`op_LeftShiftAssignment`|`LeftShift`|  
+|`%=`|`op_ModulusAssignment`|`Mod`|  
+|`+=`|`op_AdditionAssignment`|`Add`|  
+|`&=`|`op_BitwiseAndAssignment`|`BitwiseAnd`|  
+|`&#124;=`|`op_BitwiseOrAssignment`|`BitwiseOr`|  
+|`,`|`op_Comma`|`Comma`|  
+|`/=`|`op_DivisionAssignment`|`Divide`|  
+|`--`|`op_Decrement`|`Decrement`|  
+|`++`|`op_Increment`|`Increment`|  
+|`- (unary)`|`op_UnaryNegation`|`Negate`|  
+|`+ (unary)`|`op_UnaryPlus`|`Plus`|  
+|`~`|`op_OnesComplement`|`OnesComplement`|  
+  
+### 演算子をオーバー ロード \= \=  
+ オーバー ロード `operator ==` はかなり複雑になります。 演算子のセマンティクスをなどその他のいくつかのメンバーと互換性がある必要がある <xref:System.Object.Equals%2A?displayProperty=fullName>です。  
+  
+### 変換演算子  
+ 変換演算子は、単項演算子を別の型に変換できるようにします。 演算子は、オペランドまたは戻り値の型のいずれかの静的メンバーとして定義する必要があります。 変換演算子の 2 種類があります。 明示的および暗黙的なです。  
+  
+ **X のしないで** 場合は、エンドユーザーがこのような変換が明確に予期しない変換演算子が用意されています。  
+  
+ **X のしないで** 型のドメインの外部での変換演算子を定義します。  
+  
+ たとえば、 <xref:System.Int32>, 、<xref:System.Double>, 、および <xref:System.Decimal> はすべての数値型に対し <xref:System.DateTime> はありません。 そのためがあってはなりません変換への変換演算子、 `Double(long)` に、 `DateTime`です。 コンス トラクターは、このような場合が優先されます。  
+  
+ **X のしないで** 変換が損失を伴う可能性がある場合は、暗黙的な変換演算子を提供します。  
+  
+ などがないことから、暗黙の変換 `Double` に `Int32` ため `Double` よりも広い範囲を持つ `Int32`です。 変換の損失を伴う可能性がある場合でも、明示的な変換演算子を指定できます。  
+  
+ **X のしないで** 暗黙的なキャストから例外をスローします。  
+  
+ エンドユーザーがないかもしれません変換が行われているために、何が起こっているかを理解するため非常に困難です。  
+  
+ **✓ は** スロー <xref:System.InvalidCastException?displayProperty=fullName> 損失を伴う変換でキャスト演算子への呼び出しの結果、その演算子のコントラクトでは、損失を伴う変換することはできません。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/parameter-design.md b/docs/standard/design-guidelines/parameter-design.md
new file mode 100644
index 00000000000..9731a81194a
--- /dev/null
+++ b/docs/standard/design-guidelines/parameter-design.md
@@ -0,0 +1,170 @@
+---
+title: "パラメーターのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "メンバー デザインのガイドライン [.NET Framework] パラメーター"
+  - "パラメーターであるメンバー [.NET Framework]"
+  - "パラメーターの名前 [.NET Framework]"
+  - "パラメーターの設計ガイドライン"
+  - "予約済みのパラメーター"
+ms.assetid: 3f33bf46-4a7b-43b3-bb78-1ffebe0dcfa6
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# パラメーターのデザイン
+このセクションでは、引数をチェックするためのガイドラインを使用してセクションをなど、パラメーターの設計でさまざまなガイドラインを提供します。 さらで説明するガイドラインを参照してください [パラメーターの名前を付ける](../../../docs/standard/design-guidelines/naming-parameters.md)します。  
+  
+ **✓ は** メンバーに必要な機能を提供する、少なくとも派生パラメーター型を使用します。  
+  
+ たとえば、コレクションを列挙して、コンソールに各項目を印刷する方法を設計する必要があるとします。 このようなメソッドを実行する必要があります <xref:System.Collections.IEnumerable> 、パラメーターとしていない <xref:System.Collections.ArrayList> または <xref:System.Collections.IList>, などです。  
+  
+ **X のしないで** 予約済みのパラメーターを使用します。  
+  
+ さらに、メンバーへの入力が将来のバージョンで必要な場合は、新しいオーバー ロードを追加できます。  
+  
+ **X のしないで** ポインター、ポインターの配列またはパラメーターとして多次元配列を受け取るメソッドがパブリックに公開します。  
+  
+ ポインター、および多次元配列比較的しにくいを適切に使用します。 ほとんどの場合に、Api はこれらの型をパラメーターとしてを防ぐために再設計することができます。  
+  
+ **✓ は** すべて配置 `out` で値をすべてのパラメーターと `ref` パラメーター \(除外パラメーター配列\) にパラメーターのオーバー ロード間の順序に一貫性がない場合でも \(を参照してください [メンバーのオーバー ロード](../../../docs/standard/design-guidelines/member-overloading.md)\)。  
+  
+ `out` パラメーターは、余分な戻り値として見なすことができ、理解しやすく、メソッド シグネチャは、グループ化します。  
+  
+ **✓ は** メンバーをオーバーライドする場合のパラメーターの名前を付けるか、インターフェイス メンバーの実装で一貫しています。  
+  
+ これには、メソッド間の関係向上と通信します。  
+  
+### 列挙型とブール型のパラメーターの選択  
+ **✓ は** メンバーが 2 つ以上のブール型パラメーターを持っている場合は、列挙型を使用します。  
+  
+ **X のしないで** はなくなりますが必要な 3 つ以上の値を確認してから、ブール値を使用します。  
+  
+ 列挙型にも、値の将来的な拡張する余地の値に説明されている列挙型に追加するすべての問題に注意する必要があります [列挙型デザイン](../../../docs/standard/design-guidelines/enum.md)します。  
+  
+ **✓ を検討してください** が本当に 2 つの状態の値でのみを使用して、ブール型プロパティを初期化するコンス トラクターのパラメーターをブール値を使用します。  
+  
+### 引数の検証  
+ **✓ は** パブリック、プロテクト、または明示的に実装されたメンバーに渡される引数を検証します。 スロー <xref:System.ArgumentException?displayProperty=fullName>, 、または検証に失敗した場合、そのサブクラスのいずれかです。  
+  
+ 実際の検証とは限りませんが、パブリックまたはプロテクト メンバー自体で発生することに注意します。 プライベートまたは内部ルーチン内の下位レベルで実行できます。 重要な点は、エンドユーザーに公開されている領域全体を引数を調べることです。  
+  
+ **✓ は** スロー <xref:System.ArgumentNullException> null 引数が渡され、メンバーが null の引数をサポートしていない場合。  
+  
+ **✓ は** 列挙型のパラメーターを検証します。  
+  
+ 列挙型の引数は列挙型で定義されている範囲であるとは限りません。 CLR は、値が列挙型で定義されていない場合でも、任意の整数値を列挙型の値にキャストできます。  
+  
+ **X のしないで** を使用して <xref:System.Enum.IsDefined%2A?displayProperty=fullName> 列挙型の範囲を確認します。  
+  
+ **✓ は** 変更可能な引数は、検証後で変更された可能性に注意してください。  
+  
+ メンバーが高度なセキュリティの場合は、コピーを作成し、検証および引数を処理することをお勧めしています。  
+  
+### パラメーターの引き渡し  
+ Framework デザイナーの観点からは、パラメーターの主な 3 つのグループ: 値渡しのパラメーター、 `ref` パラメーター、および `out` パラメーター。  
+  
+ 引数が値渡しでパラメーターを通じて渡されると、メンバーは、実際に渡された引数のコピーを受け取ります。 引数が値型の場合、引数のコピーは、スタックに配置します。 引数が参照型の場合は、参照のコピーは、スタックに配置します。 パラメーターの値渡しを c\#、VB.NET、および C\+\+ では、既定値などの最も一般的な CLR 言語です。  
+  
+ 引数を渡すとき、 `ref` パラメーター、メンバーは実際に渡された引数への参照を受け取ります。 引数が値型の場合、引数への参照はスタックに配置します。 引数が参照型の場合、参照への参照がスタックに配置します。`Ref` パラメーターは、呼び出し元によって渡される引数を変更するメンバーを許可するように使用できます。  
+  
+ `Out` パラメーターはのような `ref` に多少の違いのパラメーターです。 割り当てられていないし、いくつかの値を割り当てる前に、メンバーの本体で読み取ることができません、パラメーターが初期状態と見なされます。 また、パラメーターはメンバーを返す前にいくつかの値を割り当てるがあります。  
+  
+ **X 回避** を使用して `out` または `ref` パラメーター。  
+  
+ 使用して `out` または `ref` パラメーターには、ポインター、値型と参照型の違いの理解および複数の戻り値を持つメソッドの処理の使用経験が必要です。 違いも、 `out` と `ref` パラメーターはあまり理解されていません。 開発者全般に向けて設計フレームワーク開発者ではユーザー扱い方を習得することは期待する必要があります `out` または `ref` パラメーター。  
+  
+ **X のしないで** 参照型は参照渡しされます。  
+  
+ 参照を交換するために使用するメソッドなど、ルールをいくつかの例外があります。  
+  
+### 可変個のパラメーターを持つメンバー  
+ メンバーを可変個の引数を受け取ることができますが、配列パラメーターを提供することによって表されます。 たとえば、 <xref:System.String> 、次のメソッドを提供します。  
+  
+```  
+public class String {  
+    public static string Format(string format, object[] parameters);  
+}  
+```  
+  
+ ユーザーが呼び出すことができますし、 <xref:System.String.Format%2A?displayProperty=fullName> メソッドを次のとおりです。  
+  
+ `String.Format("File {0} not found in {1}",new object[]{filename,directory});`  
+  
+ 配列パラメーターに、c\# params キーワードを追加すると、いわゆる params 配列パラメーターにパラメーターを変更し、一時配列を作成するショートカットを提供します。  
+  
+```  
+public class String {  
+    public static string Format(string format, params object[] parameters);  
+}  
+```  
+  
+ これにより、引数リストで直接、配列要素を渡すことによって、メソッドを呼び出すユーザーです。  
+  
+ `String.Format("File {0} not found in {1}",filename,directory);`  
+  
+ パラメーター リストの最後のパラメーターにのみ、params キーワードを追加できることに注意してください。  
+  
+ **✓ を検討してください** で少数の要素の配列を渡すには、エンドユーザーの予定がある場合、配列パラメーターに、params キーワードを追加します。 多数の要素が渡されることに共通のシナリオと正常な場合ユーザーは可能性がありますこれらの要素のインラインとにかくに渡さないため、params キーワードは必要はありません。  
+  
+ **X 回避** params 配列を使用して、呼び出し元がほとんど常に入力している既に配列の場合。  
+  
+ たとえば、バイト配列パラメーターを持つメンバーは個々 のバイトを渡すことによってことはほぼありませんというです。 このため、.NET Framework でのバイト配列パラメーターは、params キーワードを使わないでください。  
+  
+ **X のしないで** params 配列パラメーターを受け取るメンバーによって、配列が変更された場合に、params 配列を使用します。  
+  
+ 呼び出しサイトで一時配列に多くのコンパイラがメンバーに引数を有効にするため、配列は、一時オブジェクトである可能性があり、したがって配列へのすべての変更は失われます。  
+  
+ **✓ を検討してください** 単純なオーバー ロードで、params キーワードを使用する場合でもより複雑なオーバー ロードでは使用できませんでした。  
+  
+ すべてのオーバー ロードされていない場合でも、1 つのオーバー ロードではパラメーター配列を持つユーザーは値のかどうかを考えてください。  
+  
+ **✓ は** params キーワードを使用できるように、順序付けられたパラメーターを実行してください。  
+  
+ **✓ を検討してください** 少数の非常に高く、パフォーマンスが重視される Api の引数による呼び出しに対して特別なオーバー ロードとコード パスを提供します。  
+  
+ これにより、引数の数が少ない、API が呼び出されたときに、配列オブジェクトを作成しないようにします。 によって、配列パラメーターの単数形を取得し、数値のサフィックスを追加するには、パラメーターの名前を形成します。  
+  
+ 完全なコード パスを特別なケースに配列を作成するだけでなく、一般的なメソッドを呼び出す場合、これを行うだけする必要があります。  
+  
+ **✓ は** params 配列引数として null を渡すことがあります。  
+  
+ 配列が処理する前に null でないことを検証する必要があります。  
+  
+ **X のしないで** を使用して、 `varargs` メソッド、それ以外の場合、省略記号ボタンと呼ばれます。  
+  
+ C などのいくつかの CLR 言語と呼ばれる変数のパラメーター リストを渡す場合の代替の規則をサポートする `varargs` メソッドです。 規則には CLS 準拠ではないため、フレームワークの使用を避けてください。  
+  
+### ポインター パラメーター  
+ 一般に、ポインターは、適切に設計されたマネージ コード フレームワークの面積パブリックにする必要があります表示されません。 ほとんどの場合、ポインターをカプセル化する必要があります。 ただし、ポインターは相互運用性の理由から、必要な場合によっては、ポインターを使用して、このような場合は、適切です。  
+  
+ **✓ は** ポインターは CLS 準拠ではないために、ポインター引数を受け取り、メンバーの代替を提供します。  
+  
+ **X 回避** 高価な引数がポインター引数のチェックを実行します。  
+  
+ **✓ は** ポインターを持つメンバーの設計時に共通のポインターに関連する規則に従います。  
+  
+ たとえば、必要はありません開始インデックスを渡す単純なポインターの算術演算は、同じ結果を得るを使用できるためです。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/property.md b/docs/standard/design-guidelines/property.md
new file mode 100644
index 00000000000..5de9fc160bc
--- /dev/null
+++ b/docs/standard/design-guidelines/property.md
@@ -0,0 +1,102 @@
+---
+title: "プロパティのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "メンバー デザインのガイドライン、プロパティ"
+  - "プロパティ [.NET Framework] のデザイン ガイドライン"
+ms.assetid: 127cbc0c-cbed-48fd-9c89-7c5d4f98f163
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# プロパティのデザイン
+プロパティはメソッドに厳密には非常に似ていますは、使用シナリオの観点からはまったく異なります。 これらは、スマート フィールドと考える必要があります。 フィールドの呼び出しの構文とメソッドの柔軟性があります。  
+  
+ **✓ は** 取得専用プロパティを作成する場合は、呼び出し元では、プロパティの値を変更できません。  
+  
+ 留意した場合の種類プロパティが変更可能な参照型、プロパティが取得専用の場合でも、プロパティの値を変更することができます。  
+  
+ **X のしないで** 設定専用のプロパティまたはプロパティを get アクセス操作子よりも広範なアクセシビリティを持つ set アクセス操作子を提供します。  
+  
+ たとえば、パブリックな setter と保護された getter プロパティは使用しないでいます。  
+  
+ プロパティの get アクセス操作子を提供できない場合は、代わりにメソッドとしての機能を実装します。 メソッド名での開始を検討してください `Set` 内容は指定済みの場合、プロパティに従います。 たとえば、 <xref:System.AppDomain> というメソッドを持ち `SetCachePath` というセット取り専用プロパティではなく `CachePath`です。  
+  
+ **✓ は** 実用的な既定値は、すべてのプロパティを既定の設定、セキュリティ ホールやそれほど非効率的なコードで発生しないことを確認します。  
+  
+ **✓ は** を使用する場合でも、この結果、オブジェクトの場合は、一時的な無効な状態で、任意の順序で設定するプロパティです。  
+  
+ 一般的に、いくつかの値を 1 つのプロパティの無効になるポイントを相互に関連する 2 つ以上のプロパティの同じオブジェクトに対して他のプロパティの値が割り当てられます。 このような場合オブジェクトによって、相互に関連するプロパティをまとめて使用実際になるまで無効な状態に起因する例外を延期する必要があります。  
+  
+ **✓ は** プロパティ set アクセス操作子が例外をスローした場合は、前の値を保持します。  
+  
+ **X 回避** プロパティの getter から例外をスローします。  
+  
+ プロパティの getter は単純な操作をする必要があり、すべての前提条件のないです。 Getter が例外をスローする場合にする必要がありますおそらくに再設計するメソッドです。 このルールは、インデクサーの場合、引数の検証の結果として例外を考えて行うには適用されませんに注意してください。  
+  
+### インデックス付きプロパティのデザイン  
+ インデックス付きプロパティは、パラメーターを持つことができますし、配列のインデックス処理のような特別な構文を使用して呼び出すことができる特別なプロパティです。  
+  
+ インデックス付きプロパティは、インデクサーとも呼ばれます。 インデクサーは、論理的なコレクション内の項目へのアクセスを提供する Api でのみ使用する必要があります。 たとえば、文字列は、一連の文字、やでインデクサー <xref:System.String?displayProperty=fullName> その文字にアクセスするようになりました。  
+  
+ **✓ を検討してください** インデクサーを使用して、内部配列に格納されたデータへのアクセスを提供します。  
+  
+ **✓ を検討してください** 項目のコレクションを表す型のインデクサーを提供します。  
+  
+ **X 回避** 1 つ以上のパラメーターを持つプロパティを使用してインデックスを作成します。  
+  
+ 設計には、複数のパラメーターが必要とする場合は、実際に、プロパティは、論理的な集合をアクセサーを表すかどうかを再確認します。 そうでない場合は、代わりにメソッドを使用します。 まず、メソッド名で `Get` または `Set`です。  
+  
+ **X 回避** 以外のパラメーターの型を持つインデクサー <xref:System.Int32?displayProperty=fullName>, 、<xref:System.Int64?displayProperty=fullName>, 、<xref:System.String?displayProperty=fullName>, 、<xref:System.Object?displayProperty=fullName>, 、または列挙型。  
+  
+ 設計には、その他の種類のパラメーターが必要とする場合は、厳密 API が、論理的な集合を本当にアクセサーを表すかどうかを再評価します。 そうでない場合は、メソッドを使用します。 まず、メソッド名で `Get` または `Set`です。  
+  
+ **✓ は** 名前を使用して `Item` のインデックス付きプロパティを明らかに向上名がある場合を除き、\(などを参照してください、 <xref:System.String.Chars%2A> プロパティを `System.String`\)。  
+  
+ インデクサーは、C\# の場合は、Item という名前の既定でです。<xref:System.Runtime.CompilerServices.IndexerNameAttribute> をこの名前をカスタマイズできます。  
+  
+ **X のしないで** インデクサーとセマンティクス的に同等のメソッドの両方を提供します。  
+  
+ **X のしないで** 1 つ以上のファミリの 1 つの型のオーバー ロードされたインデクサーを提供します。  
+  
+ これは、c\# コンパイラによって強制されます。  
+  
+ **X のしないで** を使用して既定以外のインデックス付きプロパティです。  
+  
+ これは、c\# コンパイラによって強制されます。  
+  
+### プロパティ変更通知イベント  
+ プロパティの値の変更のユーザーに通知するイベントを提供する便利な場合があります。 たとえば、 `System.Windows.Forms.Control` を生成、 `TextChanged` の値の後にイベントの `Text` プロパティが変更されました。  
+  
+ **✓ を検討してください** 高水準の api \(通常、デザイナー コンポーネント\) のプロパティの値が変更されたときに通知イベントを発生させる変更します。  
+  
+ ユーザーがオブジェクトのプロパティを変更する場合を判断するための適切なシナリオがある場合、オブジェクトには、プロパティの変更通知イベントを発生させます。  
+  
+ ただし、オーバーヘッドの基本型やコレクションなどの低レベルの Api のようなイベントを発生させるのには価値がある可能性がありますはありません。 たとえば、 <xref:System.Collections.Generic.List%601> 新しい項目がリストに追加されたときに、このようなイベントを生成しませんが、 `Count` プロパティが変更されました。  
+  
+ **✓ を検討してください** 外的要因を使用して、プロパティの値が変更されたときに、通知イベントを発生させる変更します。  
+  
+ 何らかの外的要因 \(的に以外のオブジェクトでメソッドを呼び出すことによって\) を使用して、プロパティ値が変更された場合、値が変更されが変更されたことを開発者にイベントを示しています。 その良い例が、 `Text` テキスト ボックス コントロールのプロパティです。 内のテキストを入力すると、 `TextBox`, 、プロパティの値が自動的に変更します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [メンバー デザインのガイドライン](../../../docs/standard/design-guidelines/member.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/protected-members.md b/docs/standard/design-guidelines/protected-members.md
new file mode 100644
index 00000000000..00ab253d498
--- /dev/null
+++ b/docs/standard/design-guidelines/protected-members.md
@@ -0,0 +1,48 @@
+---
+title: "プロテクト メンバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "保護されているメンバー [.NET Framework]"
+  - "プロテクト メンバー"
+  - "クラス [.NET Framework] の封印されていません。"
+  - "メンバーの保護されているクラス [.NET Framework]"
+  - "封印されていないクラス"
+  - "クラスの動作をカスタマイズします。"
+ms.assetid: aa0b58ee-3956-494d-ab48-471ae5db8740
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# プロテクト メンバー
+単独でプロテクト メンバーは、すべての機能拡張を指定しないが、高い拡張性により、サブクラス化をより強力なことができます。 メインのパブリック インターフェイスを不必要に複雑にせず、高度なカスタマイズ オプションを公開する、使用できます。  
+  
+ フレームワークの設計者は、「保護」の名前は、セキュリティに関する誤った認識を移すことができるため、保護されたメンバーには注意する必要があります。 サブクラス封印されていないクラスとメンバーへのアクセスが保護することがすべてのユーザーと、防御的なコーディング手法がパブリック メンバーを使用をプロテクト メンバーに適用するため、同じ。  
+  
+ **✓ を検討してください** プロテクト メンバーは高度なカスタマイズを使用します。  
+  
+ **✓ は** セキュリティ、ドキュメント、および互換性の分析を行うための public と封印されていないクラスでプロテクト メンバーを処理します。  
+  
+ クラスから継承するすべてのユーザーと、プロテクト メンバーにアクセスします。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/sealing.md b/docs/standard/design-guidelines/sealing.md
new file mode 100644
index 00000000000..c1ba2fb5fce
--- /dev/null
+++ b/docs/standard/design-guidelines/sealing.md
@@ -0,0 +1,63 @@
+---
+title: "封印 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "機能拡張の制限"
+  - "シール クラス [.NET Framework]"
+  - "カスタマイズの防止"
+  - "シール クラス"
+ms.assetid: cc42267f-bb7a-427a-845e-df97408528d4
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 封印
+オブジェクト指向フレームワークの機能の 1 つは、開発者が拡張および framework デザイナーによって予期しない方法でそれらをカスタマイズできます。 これは、両方の電源および拡張可能なデザインの危険性です。 ご利用のフレームワークを設計するときは、そのため、必要なときは、機能拡張の慎重に設計し、危険な場合は、機能拡張を制限するために非常に重要です。  
+  
+ 機能拡張を防ぐ強力なメカニズムをシールするとします。 クラスまたは個別のメンバーのいずれかを封印することができます。 クラスをシールすると、ユーザーがクラスから継承できなくなります。 メンバーをシールすると、ユーザーが特定のメンバーをオーバーライドできなくなります。  
+  
+ **X のしないで** これを行うには相応の理由をしなくてもクラスをシールします。  
+  
+ 機能拡張シナリオを想定することはできませんので、クラスをシールすることは相応の理由ではありません。 Framework ユーザーが便利なメンバーを追加するなど、さまざまな明確な理由のクラスから継承したいです。 参照してください [封印されていないクラス](../../../docs/standard/design-guidelines/unsealed-classes.md) 明確な理由の例についてはユーザーが型を継承します。  
+  
+ クラスをシールする理由を以下に示します。  
+  
+-   クラスは、静的クラスです。 「[静的クラスのデザイン](../../../docs/standard/design-guidelines/static-class.md)」を参照してください。  
+  
+-   クラスは、継承されたプロテクト メンバーにセキュリティに影響する機密情報を格納します。  
+  
+-   クラスは、多くの仮想メンバーを継承し、それらを個別に封印した場合のコストは封印されていないクラスを残すことのメリットを上回ります。  
+  
+-   クラスは、非常に高速なランタイム ルックアップを必要とする属性です。 Sealed 属性には、封印されていないものよりもわずかに高いパフォーマンス レベルがあります。 「[属性](../../../docs/standard/design-guidelines/属性.md)」を参照してください。  
+  
+ **X のしないで** sealed 型でプロテクト仮想メンバーを宣言します。  
+  
+ 定義上、シールされた型からは継承できません。 つまり、sealed 型でプロテクト メンバーを呼び出すことができない、sealed 型で仮想メソッドをオーバーライドすることはできません。  
+  
+ **✓ を検討してください** をオーバーライドするメンバーをシールします。  
+  
+ 仮想メンバーの概要に起因する問題 \(で説明した [仮想メンバー](../../../docs/standard/design-guidelines/virtual-members.md)\) 少しほどには同様に、上書きを適用します。 上書きの封印を開発者から隠ぺい継承階層の時点からこれらの問題です。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)   
+ [封印されていないクラス](../../../docs/standard/design-guidelines/unsealed-classes.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/static-class.md b/docs/standard/design-guidelines/static-class.md
new file mode 100644
index 00000000000..3dc01f984bd
--- /dev/null
+++ b/docs/standard/design-guidelines/static-class.md
@@ -0,0 +1,52 @@
+---
+title: "静的クラスのデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "型のデザインのガイドライン、静的クラス"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] クラス"
+  - "静的クラス [.NET Framework]"
+  - "静的クラス [.NET Framework]"
+  - "クラス [.NET Framework] のデザイン ガイドライン"
+  - "クラス型の設計ガイドライン"
+ms.assetid: d67c14d8-c4dd-443f-affb-4ccae677c9b6
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 静的クラスのデザイン
+静的クラスが静的メンバーのみが含まれるクラスとして定義されている \(もちろんから継承されたインスタンスのメンバーだけでなく <xref:System.Object?displayProperty=fullName> とコンス トラクターはプライベート可能性があります\)。 一部の言語では、静的クラスの組み込みサポートを提供します。 C\# 2.0 以降では、クラスが静的に宣言されると、シール、抽象クラスで、あるインスタンス メンバーをオーバーライドまたは宣言されていることができます。  
+  
+ 静的クラスは、純粋なオブジェクト指向設計と単純さのバランスです。 その他の操作へのショートカットを提供によく使用されます \(よう <xref:System.IO.File?displayProperty=fullName>\)、拡張メソッド、または完全なオブジェクト指向のラッパーが保証されているいない機能の保持者 \(など <xref:System.Environment?displayProperty=fullName>\)。  
+  
+ **✓ は** 静的クラスは控えめに使用します。  
+  
+ 静的クラスは、オブジェクト指向のコア フレームワークのサポート クラスとしてのみ使用する必要があります。  
+  
+ **X のしないで** 雑バケットとして静的クラスを処理します。  
+  
+ **X のしないで** 宣言または静的クラスのインスタンス メンバーをオーバーライドします。  
+  
+ **✓ は** シール、抽象クラスで静的クラスを宣言し、使用するプログラミング言語には静的クラスの組み込みサポートがない場合、プライベート インスタンス コンス トラクターを追加します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/struct.md b/docs/standard/design-guidelines/struct.md
new file mode 100644
index 00000000000..95eafbda0a4
--- /dev/null
+++ b/docs/standard/design-guidelines/struct.md
@@ -0,0 +1,62 @@
+---
+title: "構造体のデザイン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 構造体"
+  - "構造体の割り当てを解除"
+  - "構造体の割り当てください。"
+  - "値型、構造体"
+  - "構造の設計"
+  - "型のデザインのガイドライン、構造体"
+  - "構造体 [.NET Framework] のデザイン ガイドライン"
+ms.assetid: 1f48b2d8-608c-4be6-9ba4-d8f203ed9f9f
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 構造体のデザイン
+ほとんどの場合、汎用的な値の型は構造体、c\# のキーワードと呼ばれます。 このセクションでは、一般的な構造体のデザインのガイドラインを示します。  
+  
+ **X のしないで** 構造体の既定のコンス トラクターを提供します。  
+  
+ このガイドラインに従うには、配列の項目ごとに、コンス トラクターを実行することがなく作成する構造体の配列が使用できます。 C\# で許可しないことを既定のコンス トラクターを持つ構造体に注意してください。  
+  
+ **X のしないで** 変更可能な値の型を定義します。  
+  
+ 変更可能な値の型には、いくつかの問題があります。 たとえば、プロパティ get アクセス操作子が値型を返すときに、呼び出し元は、コピーを受け取ります。 コピーが暗黙的に作成されるため、開発者は、コピー、および元の値ではなくを変化することに注意してください限りません。 また、一部の言語 \(動的言語、特に\) では、できるコピーによって、ローカル変数を逆参照されたときにも、ために、変更可能な値の型を使用して問題があります。  
+  
+ **✓ は** すべてのインスタンス データの状態が 0 に設定されているように、false の場合、または null \(該当する場合\) は無効です。  
+  
+ 無効なインスタンスの偶発的な作成を禁止これは、構造体の配列が作成されるときです。  
+  
+ **✓ は** 実装 <xref:System.IEquatable%601> を値の型。  
+  
+ <xref:System.Object.Equals%2A?displayProperty=fullName> 値型のメソッドとボックス化、および既定の実装はリフレクションを使用しているため、非常に効率です。<xref:System.IEquatable%601.Equals%2A> 多くのパフォーマンスを向上させることができ、できる機構を実装するため、ボックス化は発生しません。  
+  
+ **X のしないで** 明示的に延長 <xref:System.ValueType>します。 実際には、ほとんどの言語は、これを防ぐ。  
+  
+ 通常、構造体では、非常に役に立ちますが、小規模で、1 つ、変更できないの値がないボックス化する多くの場合にのみ使用する必要があります。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [型デザインのガイドライン](../../../docs/standard/design-guidelines/type.md)   
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [クラスまたは構造体の選択](../../../docs/standard/design-guidelines/choosing-between-class-and-struct.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/system-xml-usage.md b/docs/standard/design-guidelines/system-xml-usage.md
new file mode 100644
index 00000000000..74d78747aea
--- /dev/null
+++ b/docs/standard/design-guidelines/system-xml-usage.md
@@ -0,0 +1,41 @@
+---
+title: "System.Xml の使用法 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: 82302f0d-a621-4c6f-b57d-999bd61f21a6
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 4
+---
+# System.Xml の使用法
+このセクションでに存在するいくつかの型の使用方法について説明 <xref:System.Xml?displayProperty=fullName> XML データを表現するために使用する名前空間。  
+  
+ **X のしないで** を使用して <xref:System.Xml.XmlNode> または <xref:System.Xml.XmlDocument> XML データを表現します。 インスタンスの使用をお勧め <xref:System.Xml.XPath.IXPathNavigable>, 、<xref:System.Xml.XmlReader>, 、<xref:System.Xml.XmlWriter>, 、または型を細分化 <xref:System.Xml.Linq.XNode> 代わりにします。`XmlNode``XmlDocument` パブリック Api で公開するために設計されていません。  
+  
+ **✓ は** を使用して `XmlReader`, 、`IXPathNavigable`, 、または型を細分化 `XNode` メンバーや XML を戻り値の入力または出力として。  
+  
+ 代わりにこれらの抽象化を使用して `XmlDocument`, 、`XmlNode`, 、または <xref:System.Xml.XPath.XPathDocument>, を公開する仮想の XML データ ソースで作業を行うされ、メモリ内の XML ドキュメントの特定の実装からメソッドが分離されるため、 `XNode`, 、`XmlReader`, 、または <xref:System.Xml.XPath.XPathNavigator>です。  
+  
+ **X のしないで** サブクラス `XmlDocument` を基になるオブジェクト モデルまたはデータ ソースの XML ビューを表す型を作成するかどうか。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/type.md b/docs/standard/design-guidelines/type.md
new file mode 100644
index 00000000000..c3f2771a16d
--- /dev/null
+++ b/docs/standard/design-guidelines/type.md
@@ -0,0 +1,59 @@
+---
+title: "型デザインのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "型デザインのガイドライン"
+  - "型デザインのガイドラインについての型のデザイン ガイドライン"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 型のデザインのガイドライン"
+  - "型 [.NET Framework] のデザイン ガイドライン"
+ms.assetid: 6b49314e-8bba-43ea-97ca-4e0255812f95
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 型デザインのガイドライン
+CLR の観点からは、型の 2 つのカテゴリがあります: 参照型と値の型、型それぞれ独自の特定の設計規則に以上の論理グループに分割してフレームワーク デザインの詳細については、目的が、します。  
+  
+ クラスは、参照型の一般的なケースです。 ほとんどのフレームワークの型の大部分を構成します。 クラスは、サポートされる他のオブジェクト指向の機能の豊富なをし、一般的な適用性を的な人気を支払わなかったです。 基本クラスと抽象クラスは、拡張機能に関連する、特別な論理グループです。  
+  
+ インターフェイスは、参照型と値の型の両方によって実装可能な型の型です。 したがって、参照型と値の型のポリモーフィックな階層のルートとして使用することができます。 さらに、インターフェイスは、CLR によってネイティブでサポートされていない多重継承をシミュレートするために使用できます。  
+  
+ 構造体は、値型の一般的な場合があり、小規模でシンプルな型、言語プリミティブのように予約されている必要があります。  
+  
+ 列挙型は、日、週、コンソールの色のなどの値の短いセットを定義するのに使用される値型の特殊なケースです。  
+  
+ 静的クラスは、型の静的メンバーのコンテナーを示すものです。 その他の操作へのショートカットを提供するよく使用されます。  
+  
+ デリゲート、例外、属性、配列、およびコレクションは、特別な用途のためのもので、参照型のすべての特殊なケースとの設計と使用法に関するガイドラインはこのドキュメントで他の場所で説明します。  
+  
+ **✓ は** 各タイプが適切に定義された一連の関連するメンバーは、ランダムな関連性のない機能のコレクションだけでなくであることを確認します。  
+  
+## このセクションの内容  
+ [クラスまたは構造体の選択](../../../docs/standard/design-guidelines/choosing-between-class-and-struct.md)  
+ [抽象クラスのデザイン](../../../docs/standard/design-guidelines/abstract-class.md)  
+ [静的クラスのデザイン](../../../docs/standard/design-guidelines/static-class.md)  
+ [インターフェイスのデザイン](../../../docs/standard/design-guidelines/interface.md)  
+ [構造体のデザイン](../../../docs/standard/design-guidelines/struct.md)  
+ [列挙型デザイン](../../../docs/standard/design-guidelines/enum.md)  
+ [入れ子にされた型](../../../docs/standard/design-guidelines/nested-types.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/unsealed-classes.md b/docs/standard/design-guidelines/unsealed-classes.md
new file mode 100644
index 00000000000..0ad6ed6855c
--- /dev/null
+++ b/docs/standard/design-guidelines/unsealed-classes.md
@@ -0,0 +1,44 @@
+---
+title: "封印されていないクラス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス [.NET Framework] の封印されていません。"
+  - "封印されていないクラス"
+  - "クラスの継承"
+ms.assetid: 9a3bd505-90f5-4053-9f0d-3cf5fa3d3ebf
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 封印されていないクラス
+シール クラスは継承できませんし、機能拡張は、します。 これに対し、封印されていないクラスから継承できるクラスと呼びます。  
+  
+ **✓ を検討してください** 安価で提供する優れた方法まだ非常に役に立ちますフレームワークへの拡張機能として、仮想メンバーまたはプロテクト メンバーを追加なしで封印されていないクラスを使用します。  
+  
+ 多くの場合、開発者はカスタム コンス トラクター、新しいメソッドは、メソッドのオーバー ロードなどのための便利なメンバーを追加するために封印されていないクラスから継承したいと考えているとします。 たとえば、  `System.Messaging.MessageQueue` が封印されていないと、できるので、ユーザーがその既定値を特定のキューのパスにカスタムのキューを作成する特定のシナリオ用の API を単純化するカスタム メソッドを追加します。  
+  
+ 既定では、ほとんどのプログラミング言語でクラスが封印されていない、フレームワークのほとんどのクラスに対して推奨される既定ではもできます。 封印されていない型によって提供される拡張機能は、フレームワークのユーザーが非常にありがたいと封印されていない型に関連付けられた相対的に低いテスト コストによりを提供する非常に低価格です。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)   
+ [封印](../../../docs/standard/design-guidelines/sealing.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/usage-guidelines.md b/docs/standard/design-guidelines/usage-guidelines.md
new file mode 100644
index 00000000000..b41bfc0ce0d
--- /dev/null
+++ b/docs/standard/design-guidelines/usage-guidelines.md
@@ -0,0 +1,46 @@
+---
+title: "使用方法のガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] の使用に関するガイドライン"
+ms.assetid: 42215ffa-a099-4a26-b14e-fb2bdb6f95b7
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 使用方法のガイドライン
+このセクションには、パブリックにアクセスできる Api で一般的な種類の使用に関するガイドラインが含まれています。 組み込みフレームワーク型 \(シリアル化属性など\) および一般的な演算子のオーバー ロードの直接の使用状況を処理します。  
+  
+ <xref:System.IDisposable?displayProperty=fullName> インターフェイスは、このセクションで説明されていないは、後ほど、 [Dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md) セクションです。  
+  
+> [!NOTE]
+>  組み込みの .NET Framework 型のガイドラインと他の一般的な方法に関する追加情報には、次のリファレンス トピックを参照してください: <xref:System.DateTime?displayProperty=fullName>, 、<xref:System.DateTimeOffset?displayProperty=fullName>, 、<xref:System.ICloneable?displayProperty=fullName>, 、<xref:System.IComparable%601?displayProperty=fullName>, 、<xref:System.IEquatable%601?displayProperty=fullName>, 、<xref:System.Nullable%601?displayProperty=fullName>, 、<xref:System.Object?displayProperty=fullName>, 、<xref:System.Uri?displayProperty=fullName>です。  
+  
+## このセクションの内容  
+ [配列](../../../docs/standard/design-guidelines/arrays.md)  
+ [属性](../../../docs/standard/design-guidelines/属性.md)  
+ [コレクション クラス](../../../amples/snippets/cpp/VS_Snippets_Misc/cx_collections/cpp/collections.vcxproj)  
+ [シリアル化](../../../docs/standard/design-guidelines/シリアル化.md)  
+ [System.Xml の使用法](../../../docs/standard/design-guidelines/system-xml-usage.md)  
+ [等値演算子](../../../docs/standard/design-guidelines/equality-operators.md)  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/using-standard-exception-types.md b/docs/standard/design-guidelines/using-standard-exception-types.md
new file mode 100644
index 00000000000..e8fab3339aa
--- /dev/null
+++ b/docs/standard/design-guidelines/using-standard-exception-types.md
@@ -0,0 +1,78 @@
+---
+title: "標準の例外の型を使用します。 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "標準の種類の例外をスロー"
+  - "キャッチ (例外の)"
+  - "例外のキャッチ"
+  - "例外のスロー"
+ms.assetid: ab22ce03-78f9-4dca-8824-c7ed3bdccc27
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 標準の例外の型を使用します。
+このセクションでは、フレームワークとその使用方法の詳細な情報によって提供される標準の例外について説明します。 一覧は完全ではではありません。 その他のフレームワークの例外の種類の使用状況の .NET Framework リファレンス ドキュメントを参照してください。  
+  
+## 例外と SystemException  
+ **X のしないで** スロー <xref:System.Exception?displayProperty=fullName> または <xref:System.SystemException?displayProperty=fullName>です。  
+  
+ **X のしないで** キャッチ `System.Exception` または `System.SystemException` framework コードで再スローする場合を除き、します。  
+  
+ **X 回避** キャッチ `System.Exception` または `System.SystemException`, では、トップレベルの例外ハンドラーです。  
+  
+## ApplicationException  
+ **X のしないで** スローまたはそれから派生 <xref:System.ApplicationException>します。  
+  
+## InvalidOperationException  
+ **✓ は** スロー、 <xref:System.InvalidOperationException> オブジェクトが状態が適切である場合。  
+  
+## ArgumentException、ArgumentNullException、および ArgumentOutOfRangeException  
+ **✓ は** スロー <xref:System.ArgumentException> または不正な引数がメンバーに渡された場合は、そのサブタイプのいずれかです。 該当する場合は、最派生例外の種類を選びます。  
+  
+ **✓ は** 設定、 `ParamName` プロパティのサブクラスのいずれかをスローするときに `ArgumentException`します。  
+  
+ このプロパティは、例外がスローされる原因となったパラメーターの名前を表します。 コンス トラクター オーバー ロードのいずれかを使用して、プロパティを設定できることに注意してください。  
+  
+ **✓ は** を使用して `value` プロパティ set アクセス操作子の暗黙の value パラメーターの名前。  
+  
+## NullReferenceException、IndexOutOfRangeException、およびです \(accessviolationexception\)  
+ **X のしないで** 明示的または暗黙的にスローする、api で公開されている呼び出し可能 <xref:System.NullReferenceException>, 、<xref:System.AccessViolationException>, 、または <xref:System.IndexOutOfRangeException>です。 これらの例外は予約されているとおよびほとんどの場合は、バグを示す場合に、実行エンジンによってスローされます。  
+  
+ 引数に、これらの例外がスローされないようにチェックを行います。 これらの例外をスローすることは、時間の経過と共に変わる可能性があるメソッドの実装の詳細を公開します。  
+  
+## StackOverflowException  
+ **X のしないで** を明示的にスロー <xref:System.StackOverflowException>します。 CLR によってのみ、例外が明示的にスローする必要があります。  
+  
+ **X のしないで** キャッチ `StackOverflowException`します。  
+  
+ ほとんどでは、任意のスタック オーバーフローが存在する場合に整合性があるマネージ コードを記述することはできません。 CLR のアンマネージ部分一貫して任意のスタック オーバーフローから取り除くではなく移動を適切に定義された場所スタックがオーバーフローしたプローブを使用しています。  
+  
+## OutOfMemoryException  
+ **X のしないで** を明示的にスロー <xref:System.OutOfMemoryException>します。 この例外では、CLR インフラストラクチャによってのみがスローされます。  
+  
+## ComException、SEHException、および ExecutionEngineException  
+ **X のしないで** を明示的にスロー <xref:System.Runtime.InteropServices.COMException>,  、<xref:System.ExecutionEngineException>, 、および <xref:System.Runtime.InteropServices.SEHException>です。 これらの例外では、CLR インフラストラクチャによってのみがスローされます。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)
\ No newline at end of file
diff --git a/docs/standard/design-guidelines/virtual-members.md b/docs/standard/design-guidelines/virtual-members.md
new file mode 100644
index 00000000000..312d607c6cc
--- /dev/null
+++ b/docs/standard/design-guidelines/virtual-members.md
@@ -0,0 +1,53 @@
+---
+title: "仮想メンバー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "オーバーライド可能なメンバー"
+  - "仮想メンバー"
+  - "仮想メンバー [.NET Framework]"
+ms.assetid: 8ff4eb97-0364-43ec-8a02-934b5cd94d19
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 仮想メンバー
+このため、サブクラスの動作を変更する、仮想メンバーをオーバーライドできます。 それらはそれらのもたらす拡張性の観点からのコールバックとよく似ていますが、実行のパフォーマンスとメモリの消費に関して優れています。 また、仮想メンバーは、特別な既存の型 \(特殊化\) の種類を作成する必要のあるシナリオで複数な操作です。  
+  
+ 仮想メンバーは、コールバックとイベントよりパフォーマンスが向上は、非仮想メソッドをより実行はされません。  
+  
+ 仮想メンバーの主な短所は、仮想メンバーの動作はコンパイル時にのみ変更できます。 コールバックの動作は、実行時に変更できます。  
+  
+ コールバック \(とそれよりコールバックの他の情報\) などの仮想メンバーは、設計、テスト、および仮想メンバーへの呼び出しが予測できない方法でオーバーライドされることができ、任意のコードを実行できるためのメンテナンス コストがかかる。 またより多くの労力は通常、設計およびそれらを文書化のコストが高いために、仮想メンバーの契約を明確に定義する要求されます。  
+  
+ **X のしないで** メンバーをそのためには相応の理由があり、設計、テスト、および仮想メンバーの保守に関連するすべてのコストを認識している場合を除き、仮想化します。  
+  
+ 仮想メンバーは、変更を行う際に互換性を損なうことがなくに関して厳格に構成します。 また、これらは非仮想メンバーよりも低速仮想メンバーへの呼び出しがインライン関数ではないためにほとんどの場合です。  
+  
+ **✓ を検討してください** に何がどうしても必要なだけの機能拡張を制限することです。  
+  
+ **✓ は** 仮想メンバーのアクセシビリティは public で保護されたアクセシビリティを使用します。 パブリック メンバーが利用拡張 \(必要な場合\) プロテクト仮想メンバーを呼び出すことによってできます。  
+  
+ クラスのパブリック メンバーは、そのクラスの直接のコンシューマー向けの機能の適切なセットを提供する必要があります。 仮想メンバーが、サブクラスで無効にするように設計し、保護されたアクセシビリティがスコープを使用する場所へのすべての仮想機能拡張ポイントを有効にします。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [機能拡張のデザイン](../../../docs/standard/design-guidelines/designing-for-extensibility.md)
\ No newline at end of file
diff --git "a/docs/standard/design-guidelines/\343\202\267\343\203\252\343\202\242\343\203\253\345\214\226.md" "b/docs/standard/design-guidelines/\343\202\267\343\203\252\343\202\242\343\203\253\345\214\226.md"
new file mode 100644
index 00000000000..a29a605bcd7
--- /dev/null
+++ "b/docs/standard/design-guidelines/\343\202\267\343\203\252\343\202\242\343\203\253\345\214\226.md"
@@ -0,0 +1,115 @@
+---
+title: "Serialization1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/14/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+ms.assetid: bebb27ac-9712-4196-9931-de19fc04dbac
+caps.latest.revision: 4
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+---
+# シリアル化
+シリアル化は、オブジェクトを簡単に永続化または転送できる形式に変換するプロセスです。 たとえば、オブジェクトをシリアル化、HTTP を使用して、移行先のマシンで逆シリアル化したインターネット経由で転送できます。  
+  
+ .NET Framework では、さまざまなシリアル化のシナリオ用に最適化された 3 つの主なシリアル化テクノロジを提供します。 次の表には、これらのテクノロジとこれらのテクノロジに関連する主な Framework 型が一覧表示します。  
+  
+|**テクノロジ名**|**メインの種類**|**シナリオ**|  
+|----------------|----------------|--------------|  
+|**データ コントラクト シリアル化**|<xref:System.Runtime.Serialization.DataContractAttribute> <br /> <xref:System.Runtime.Serialization.DataMemberAttribute> <br /> <xref:System.Runtime.Serialization.DataContractSerializer> <br /> <xref:System.Runtime.Serialization.NetDataContractSerializer> <br /> <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer> <br /> <xref:System.Runtime.Serialization.ISerializable>|永続化全般<br />Web サービス<br />JSON|  
+|**XML シリアル化**|<xref:System.Xml.Serialization.XmlSerializer>|XML の構造を完全に制御を使用して XML 形式|  
+|**ランタイム シリアル化 \(バイナリおよび SOAP\)**|<xref:System.SerializableAttribute> <br /> <xref:System.Runtime.Serialization.ISerializable> <br /> <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter> <br /> <xref:System.Runtime.Serialization.Formatters.Soap.SoapFormatter>|.NET リモート処理|  
+  
+ **✓ は** 新しい型をデザインするときにシリアル化について考えてみるとします。  
+  
+## サポートに適切なシリアル化テクノロジを選択します。  
+ **✓ を検討してください** データ コントラクト シリアル化をサポートする場合は、型のインスタンスが永続化したり、Web サービスで使用する必要があります。  
+  
+ **✓ を検討してください** データ コントラクト シリアル化ではなく XML にシリアル化をサポートする場合は、型がシリアル化する場合に生成される XML 形式より詳細に制御する必要があります。  
+  
+ いくつかの相互運用性、XML を使用する必要があるシナリオの作成でサポートされていないデータ コントラクト シリアル化、たとえば、XML 属性を作成する必要があります。  
+  
+ **✓ を検討してください** ランタイム シリアル化をサポートする場合は、型のインスタンスは、.NET リモート処理境界を通過する必要があります。  
+  
+ **X 回避** ランタイム シリアル化または XML シリアル化をサポートする一般的な永続化のためだけです。 代わりに、データ コントラクト シリアル化を使用します。  
+  
+## データ コントラクトのシリアル化のサポート  
+ 型は、適用することによってデータ コントラクト シリアル化をサポートする、 <xref:System.Runtime.Serialization.DataContractAttribute> 型に、 <xref:System.Runtime.Serialization.DataMemberAttribute> 型のメンバー \(フィールドおよびプロパティ\) にします。  
+  
+ **✓ を検討してください** データ メンバーを種類 public の場合は、型は、部分信頼で使用できます。  
+  
+ 完全な信頼でデータ コントラクト シリアライザーがシリアル化し、非パブリックな型とメンバーを逆シリアル化が、パブリック メンバーのみをシリアル化および部分信頼で逆シリアル化します。  
+  
+ **✓ は** を持つすべてのプロパティに getter および setter を実装する <xref:System.Runtime.Serialization.DataMemberAttribute>です。 データ コントラクト シリアライザーでは、getter と setter のシリアル化可能と見なされる種類の両方が必要です。 \(.NET Framework 3.5 SP1 でいくつかのコレクション プロパティできる取得専用\)。 型は、部分信頼で使用しない場合、は、プロパティの一方または両方が非パブリックがあります。  
+  
+ **✓ を検討してください** 逆シリアル化されたインスタンスを初期化するため、シリアル化コールバックを使用します。  
+  
+ オブジェクトが逆シリアル化時に、コンス トラクターは呼び出されません。 \(ルールの例外があります。 マークされたコレクションのコンス トラクター <xref:System.Runtime.Serialization.CollectionDataContractAttribute> 逆シリアル化中に呼び出されます\)。 そのため、通常の構築時に実行される任意のロジックは、シリアル化コールバックのいずれかとして実装する必要があります。  
+  
+ `OnDeserializedAttribute` 最もよく使用されるコールバック属性です。 ファミリの他の属性は、 <xref:System.Runtime.Serialization.OnDeserializingAttribute>,  、<xref:System.Runtime.Serialization.OnSerializingAttribute>, 、および <xref:System.Runtime.Serialization.OnSerializedAttribute>です。 これらは、それぞれ逆シリアル化、シリアル化の前後に最後に、シリアル化する前に実行されるコールバックをマークする使用できます。  
+  
+ **✓ を検討してください** を使用して、 <xref:System.Runtime.Serialization.KnownTypeAttribute> を複雑なオブジェクト グラフを逆シリアル化時に使用する具象型を示します。  
+  
+ **✓ は** を作成またはシリアル化できる型を変更するときに、上位および下位互換性を検討してください。  
+  
+ ストリームの種類の将来のバージョンをシリアル化されることに注意してくださいは、型の現在のバージョンに逆シリアル化することができ、その逆です。  
+  
+ データ メンバーもプライベートで内部、変更できないこと、名前、種類、または型の将来のバージョンでの順序も明示的なパラメーターのデータ コントラクト属性を使用したコントラクトを保持するために特別な注意を踏まない限りを理解しておいてください。  
+  
+ シリアル化できる型を変更する場合は、シリアル化の互換性をテストします。 以前のバージョンに新しいバージョンを逆シリアル化しようとし、その逆です。  
+  
+ **✓ を検討してください** を実装する <xref:System.Runtime.Serialization.IExtensibleDataObject> 種類の異なるバージョン間のラウンド トリップを許可するようにします。  
+  
+ インターフェイスは、あるデータが失われないラウンドトリッピングの間にすることを確認するシリアライザーを使用します。<xref:System.Runtime.Serialization.IExtensibleDataObject.ExtensionData%2A?displayProperty=fullName> を現在のバージョンでは、不明な型の将来のバージョンからデータを格納するプロパティを使用し、そのため、データ メンバーに格納されることはできません。 現在のバージョンは後でシリアル化し、今後のバージョンに逆シリアル化と、追加のデータはシリアル化ストリームに使用できます。  
+  
+## XML シリアル化のサポート  
+ データ コントラクト シリアル化は、主な \(既定\)、.NET Framework でのシリアル化テクノロジがシリアル化のシナリオでデータ コントラクト シリアル化がサポートされていません。 たとえば、ことはできませんした XML シリアライザーによって生成または使用の形状を完全に制御します。 そのような微調整が必要な場合は、XML シリアル化、使用するがあり、型は、このシリアル化テクノロジをサポートするために設計する必要があります。  
+  
+ **X 回避** 生成される XML の構造を制御する非常に強力な理由がない限り、XML シリアル化、専用の型をデザインします。 このシリアル化テクノロジは、前のセクションで説明したデータ コントラクト シリアル化によって置き換えられました。  
+  
+ **✓ を検討してください** を実装する、 <xref:System.Xml.Serialization.IXmlSerializable> インターフェイスの XML シリアル化属性を適用することによって提供される内容よりもシリアル化された XML の形状より詳細に制御する場合。 2 つの方法で、インターフェイスの <xref:System.Xml.Serialization.IXmlSerializable.ReadXml%2A> と <xref:System.Xml.Serialization.IXmlSerializable.WriteXml%2A>, をシリアル化された XML ストリームを完全に制御できるようにします。 適用することで、型の生成を取得する XML スキーマを制御することも、 `XmlSchemaProviderAttribute`です。  
+  
+## ランタイム シリアル化のサポート  
+ ランタイム シリアル化は、.NET リモート処理で使用されるテクノロジです。 .NET リモート処理を使用して、型を変換すると思われる場合は、実行時シリアル化をサポートしているかどうかを確認する必要があります。  
+  
+ ランタイム シリアル化の基本的なサポートを適用することで指定することができます、 <xref:System.SerializableAttribute>, 、しより高度なシナリオでは、単純なランタイム シリアル化可能なパターンを実装する必要が \(実装 <xref:System.Runtime.Serialization.ISerializable> し、シリアル化コンス トラクターを提供\)。  
+  
+ **✓ を検討してください** ランタイム シリアル化をサポートする場合は、型が .NET リモート処理で使用されます。 たとえば、 <xref:System.AddIn?displayProperty=fullName> 名前空間は、.NET リモート処理を使用し、これで、すべての型の間で交換 `System.AddIn` アドインは、ランタイムのシリアル化をサポートする必要があります。  
+  
+ **✓ を検討してください** シリアル化プロセスを完全に制御する場合、ランタイム シリアル化可能なパターンを実装します。 たとえば、データを変換する場合シリアル化または、逆シリアル化を取得します。  
+  
+ パターンは非常に単純です。 実装を行うだけで済みますが、 <xref:System.Runtime.Serialization.ISerializable> インターフェイスし、オブジェクトが逆シリアル化時に使用される特殊なコンス トラクターを提供します。  
+  
+ **✓ は** シリアル化コンス トラクターを保護して、型指定されており、ここでのサンプルに示すとおりに正確にという名前の 2 つのパラメーターを提供します。  
+  
+```  
+[Serializable]  
+public class Person : ISerializable {  
+    protected Person(SerializationInfo info, StreamingContext context) {  
+        ...  
+    }  
+}  
+```  
+  
+ **✓ は** 実装、 `ISerializable` メンバーに明示的にします。  
+  
+ **✓ は** にリンク確認要求を適用 <xref:System.Runtime.Serialization.ISerializable.GetObjectData%2A?displayProperty=fullName> 実装します。 これにより、コアおよびランタイムのシリアライザーは、メンバーへのアクセス権を持つのみ完全に信頼できます。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git "a/docs/standard/design-guidelines/\345\261\236\346\200\247.md" "b/docs/standard/design-guidelines/\345\261\236\346\200\247.md"
new file mode 100644
index 00000000000..cfab8a527dd
--- /dev/null
+++ "b/docs/standard/design-guidelines/\345\261\236\346\200\247.md"
@@ -0,0 +1,63 @@
+---
+title: "Attributes1 | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/14/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-clr"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "属性 [.NET Framework]"
+  - "クラス ライブラリ デザインのガイドライン [.NET Framework] 属性"
+ms.assetid: ee0038ef-b247-4747-a650-3c5c5cd58d8b
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+---
+# 属性
+<xref:System.Attribute?displayProperty=fullName> カスタム属性を定義するために使用する基本クラスです。  
+  
+ 属性は、アセンブリ、型、メンバー、およびパラメーターなどのプログラミング要素に追加できる注釈です。 アセンブリのメタデータに格納されていてリフレクション Api を使用して実行時にアクセスできます。 たとえば、フレームワークが定義されて、 <xref:System.ObsoleteAttribute>, 、これは、型またはメンバーは廃止されていることを示すために、型またはメンバーに適用できます。  
+  
+ 属性には、属性に関連するその他のデータを受け渡す 1 つまたは複数のプロパティがあります。 たとえば、 `ObsoleteAttribute` のリリースに関する追加情報を含めることが、型またはメンバーが推奨されないと、古い API を置き換える新しい Api の説明。  
+  
+ 属性を適用すると、属性の一部のプロパティを指定してください。 これらはときと、必要なプロパティまたは必須の引数の位置指定のコンス トラクターのパラメーターとして表されます。 たとえば、 <xref:System.Diagnostics.ConditionalAttribute.ConditionString%2A> のプロパティ、 <xref:System.Diagnostics.ConditionalAttribute> 必須プロパティです。  
+  
+ 必ずしもしなくても、属性が適用されたときに指定するプロパティは省略可能なプロパティ \(または省略可能な引数\) と呼ばれます。 設定可能なプロパティによって表されます。 コンパイラは、この属性が適用されるときに、これらのプロパティを設定する特別な構文を提供します。 たとえば、 <xref:System.AttributeUsageAttribute.Inherited%2A?displayProperty=fullName> プロパティは省略可能な引数を表します。  
+  
+ **✓ は** 「属性」サフィックスを持つカスタム属性クラスの名前  
+  
+ **✓ は** 適用、 <xref:System.AttributeUsageAttribute> カスタム属性にします。  
+  
+ **✓ は** 省略可能な引数の設定可能なプロパティを提供します。  
+  
+ **✓ は** 必須の引数の取得専用プロパティを提供します。  
+  
+ **✓ は** 必須の引数に対応するプロパティを初期化するコンス トラクターのパラメーターを指定します。 各パラメーターは、対応するプロパティとして \(大文字小文字が異なる\) では、同じ名前が必要です。  
+  
+ **X 回避** 省略可能な引数に対応するプロパティを初期化するコンス トラクターのパラメーターを指定します。  
+  
+ つまり、コンス トラクターと setter の両方で設定できるプロパティがありません。 このガイドラインは、どの引数が必要ですし、これが必要であり、同じ処理を行うことの 2 つの方法のことを回避できます明示的に指定します。  
+  
+ **X 回避** カスタム属性のコンス トラクターのオーバー ロードします。  
+  
+ コンス トラクターの 1 つだけのことを明確に伝達をユーザーにどの引数が必須とオプションです。  
+  
+ **✓ は** 可能であれば、カスタム属性クラスをシールします。 これにより、属性の検索高速化します。  
+  
+ *部分 © 2005年、2009 Microsoft Corporation します。 All rights reserved.*  
+  
+ *翔泳社からのアクセス許可によって検出 [Framework デザイン ガイドライン: 規則が、表現方法と再利用可能な .NET ライブラリを 2 nd Edition パターン](http://www.informit.com/store/framework-design-guidelines-conventions-idioms-and-9780321545619) は Cwalina Brad エイブラムスによる、Microsoft Windows の開発シリーズの一部として Addison\-wesley Professional、2008 年 10 月 22 日を公開します。*  
+  
+## 参照  
+ [Framework デザイン ガイドライン](../../../docs/standard/design-guidelines/index.md)   
+ [使用方法のガイドライン](../../../docs/standard/design-guidelines/usage-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/events/TOC.md b/docs/standard/events/TOC.md
new file mode 100644
index 00000000000..7fad33ac63d
--- /dev/null
+++ b/docs/standard/events/TOC.md
@@ -0,0 +1,8 @@
+# [オブサーバー デザイン パターンのベスト プラクティス](observer-design-pattern-best-practices.md)
+# [イベント](index.md)
+# [方法: オブザーバーを実装する](how-to-implement-an-observer.md)
+# [方法: プロバイダーを実装する](how-to-implement-a-provider.md)
+# [方法 : Web フォーム アプリケーションでイベントを利用する](how-to-consume-events-in-a-web-forms-application.md)
+# [方法 : イベントを発生させる/処理する](how-to-raise-and-consume-events.md)
+# [オブサーバー デザイン パターン](observer-design-pattern.md)
+# [方法 : イベント プロパティを使用して複数のイベントを処理する](how-to-handle-multiple-events-using-event-properties.md)
diff --git a/docs/standard/events/how-to-consume-events-in-a-web-forms-application.md b/docs/standard/events/how-to-consume-events-in-a-web-forms-application.md
new file mode 100644
index 00000000000..208e03bdbd7
--- /dev/null
+++ b/docs/standard/events/how-to-consume-events-in-a-web-forms-application.md
@@ -0,0 +1,56 @@
+---
+title: "方法 : Web フォーム アプリケーションでイベントを利用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント [.NET Framework]、Web フォーム"
+  - "Web フォーム コントロール、およびイベント"
+  - "イベントハンドラー [.NET Framework]、Web フォーム"
+  - "イベント [.NET Framework]、使用"
+  - "Web フォーム、イベント処理"
+ms.assetid: 73bf8638-c4ec-4069-b0bb-a1dc79b92e32
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 方法 : Web フォーム アプリケーションでイベントを利用する
+ASP.NET Web フォーム アプリケーションの一般的なシナリオに応じて特定のアクション コントロールをユーザーがクリックするかをにコントロールと Web ページを設定する場合は、次に実行します。  たとえば、<xref:System.Web.UI.WebControls.Button?displayProperty=fullName> のコントロールは、ユーザーが Web ページでクリックしたときに、イベントを発生させます。  そのイベントを処理することで、アプリケーションでは、そのボタンのクリックに対して適切なアプリケーション ロジックを実行できます。  
+  
+### Web ページ上のボタン クリック イベントを処理するには  
+  
+1.  、次のステップで定義するメソッドの名前に `OnClick` の値が設定されている <xref:System.Web.UI.WebControls.Button> のコントロールを含む ASP.NET Web ページ \(Web フォーム ページ\) を作成します。  
+  
+    ```xml  
+    <asp:Button ID="Button1" runat="server" Text="Click Me" OnClick="Button1_Click" />  
+    ```  
+  
+2.  `OnClick` 値の名前があり、<xref:System.Web.UI.WebControls.Button.Click> イベントのデリゲート シグネチャに一致する定義するイベント ハンドラーを定義します。  
+  
+    ```csharp  
+    protected void Button1_Click(object sender, EventArgs e)  
+    {  
+        // perform action  
+    }  
+    ```  
+  
+    ```vb  
+    Protected Sub Button1_Click(sender As Object, e As EventArgs) Handles Button1.Click  
+        ' perform action  
+    End Sub  
+    ```  
+  
+     <xref:System.Web.UI.WebControls.Button.Click> イベントでは、デリゲート型に <xref:System.EventHandler> クラスを使用し、イベント データに <xref:System.EventArgs> クラスを使用します。  ASP.NET ページ フレームワークは、自動的に <xref:System.EventHandler> のインスタンスを作成し、<xref:System.Web.UI.WebControls.Button> インスタンスの <xref:System.Web.UI.WebControls.Button.Click> イベント、このデリゲート インスタンスを追加するコードを生成します。  
+  
+3.  手順 2 で定義したイベント ハンドラー メソッドでは、イベントが発生したときに必要な操作を実行するコードを追加します。  
+  
+## 参照  
+ [イベント](../../../docs/standard/events/index.md)
\ No newline at end of file
diff --git a/docs/standard/events/how-to-handle-multiple-events-using-event-properties.md b/docs/standard/events/how-to-handle-multiple-events-using-event-properties.md
new file mode 100644
index 00000000000..953ad53d1e0
--- /dev/null
+++ b/docs/standard/events/how-to-handle-multiple-events-using-event-properties.md
@@ -0,0 +1,57 @@
+---
+title: "方法 : イベント プロパティを使用して複数のイベントを処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント処理 [.NET Framework], 複数のイベントで"
+  - "イベント プロパティ [.NET Framework]"
+  - "イベント [.NET Framework], 複数の"
+  - "複数のイベント [.NET Framework]"
+ms.assetid: 30047cba-e2fd-41c6-b9ca-2ad7a49003db
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : イベント プロパティを使用して複数のイベントを処理する
+イベント プロパティを使用するには、イベントを発生させるクラスにイベント プロパティを定義し、そのイベントを処理するクラスにイベント プロパティのデリゲートを設定します。  1 つのクラスにイベント プロパティを複数実装するには、そのクラス内部に、各イベント用に定義されたデリゲートを格納および保持する必要があります。  通常は、イベント キーをインデックスとするデリゲート コレクションを実装することによってこれを実現します。  
+  
+ イベントのデリゲートを格納するには、<xref:System.ComponentModel.EventHandlerList> クラスを使用するか、独自のコレクションを実装します。  コレクション クラスには、イベント キーに基づいてイベント ハンドラー デリゲートに対する設定、アクセス、および取得を行うメソッドを用意する必要があります。  たとえば、<xref:System.Collections.Hashtable> クラスを使用したり、<xref:System.Collections.DictionaryBase> クラスからカスタム クラスを派生させたりできます。  デリゲート コレクションの実装の詳細をクラスの外部に公開する必要はありません。  
+  
+ クラス内の各イベント プロパティには、add アクセサー メソッドおよび remove アクセサー メソッドを定義します。  イベント プロパティの add アクセサーは、入力デリゲート インスタンスをデリゲート コレクションに追加します。  イベント プロパティの remove アクセサーは、デリゲート コレクションから入力デリゲート インスタンスを削除します。  これらのイベント プロパティ アクセサーでは、イベント プロパティに定義済みのキーを使用して、デリゲート コレクションに対するインスタンスの追加や削除を行います。  
+  
+### イベント プロパティを使用して複数のイベントを処理するには  
+  
+1.  イベントを発生させるクラスにデリゲート コレクションを定義します。  
+  
+2.  各イベントについて、キーを定義します。  
+  
+3.  イベントを発生させるクラスにイベント プロパティを定義します。  
+  
+4.  デリゲート コレクションを使用して、各イベント プロパティに対する add アクセサーおよび remove アクセサーを実装します。  
+  
+5.  パブリック イベント プロパティを使用して、イベントを処理するクラスのイベント ハンドラー デリゲートの追加と削除を行います。  
+  
+## 使用例  
+ 各イベントのデリゲートを格納するために `MouseDown` を使用して、`MouseUp` イベント プロパティおよび <xref:System.ComponentModel.EventHandlerList> イベント プロパティを実装する C\# コードの例を次に示します。  イベント プロパティ コンストラクトのキーワードは、太字で示されています。  
+  
+> [!NOTE]
+>  イベント プロパティは、[!INCLUDE[vbprvblong](../../../includes/vbprvblong-md.md)] ではサポートされていません。  
+  
+ [!code-cpp[Conceptual.Events.Other#31](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.events.other/cpp/example3.cpp#31)]
+ [!code-csharp[Conceptual.Events.Other#31](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.events.other/cs/example3.cs#31)]
+ [!code-vb[Conceptual.Events.Other#31](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.events.other/vb/example3.vb#31)]  
+  
+## 参照  
+ <xref:System.ComponentModel.EventHandlerList?displayProperty=fullName>   
+ [イベント](../../../docs/standard/events/index.md)   
+ [System.Web.UI.Control.Events](frlrfSystemWebUIControlClassEventsTopic)   
+ [How to: Declare Custom Events To Conserve Memory](../Topic/How%20to:%20Declare%20Custom%20Events%20To%20Conserve%20Memory%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/standard/events/how-to-implement-a-provider.md b/docs/standard/events/how-to-implement-a-provider.md
new file mode 100644
index 00000000000..9a7afc72ad4
--- /dev/null
+++ b/docs/standard/events/how-to-implement-a-provider.md
@@ -0,0 +1,68 @@
+---
+title: "方法: プロバイダーを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "オブサーバー デザイン パターン [.NET Framework]、プロバイダーを実装する"
+  - "プロバイダー [.NET Framework]、オブサーバー デザイン パターンでの"
+  - "オブサーバー [.NET Framework]、オブサーバー デザイン パターンでの"
+ms.assetid: 790b5d8b-d546-40a6-beeb-151b574e5ee5
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: プロバイダーを実装する
+オブザーバー デザイン パターンでは、データを監視して通知を送信するプロバイダーと、プロバイダーからの通知 \(コールバック\) を受信する 1 つ以上のオブザーバーとを区別する必要があります。  このトピックでは、プロバイダーを作成する方法について説明します。  関連トピックの「[方法: オブザーバーを実装する](../../../docs/standard/events/how-to-implement-an-observer.md)」では、オブザーバーを作成する方法について説明します。  
+  
+### プロバイダーを作成するには  
+  
+1.  プロバイダーがオブザーバーに送信するデータを定義します。  プロバイダーとそれがオブザーバーに送信するデータは 1 つの型にすることもできますが、通常は別々の型で表されます。  たとえば、温度監視アプリケーションの場合、`Temperature` 構造で、プロバイダー \(次の手順で定義する `TemperatureMonitor` クラスで表されるプロバイダー\) が監視するデータと、サブスクライブするオブザーバーを定義します。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/data.cs#1)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/data.vb#1)]  
+  
+2.  <xref:System.IObservable%601?displayProperty=fullName> インターフェイスを実装する型であるデータ プロバイダーを定義します。  プロバイダーのジェネリック型引数は、プロバイダーがオブザーバーに送信する型です。  次の例では、ジェネリック型引数の `Temperature` を使用して構築された <xref:System.IObservable%601?displayProperty=fullName> の実装である `TemperatureMonitor` クラスを定義しています。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#2)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#2)]  
+  
+3.  各オブザーバーに適切に通知できるように、プロバイダーでオブザーバーへの参照を保存する方法を決めます。  一般に、この目的には、汎用 <xref:System.Collections.Generic.List%601> オブジェクトなどのコレクション オブジェクトが使用されます。  次の例では、`TemperatureMonitor` クラス コンストラクターでインスタンス化されるプライベート <xref:System.Collections.Generic.List%601> オブジェクトを定義しています。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#3)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#3)]  
+  
+4.  サブスクライバーが通知の受信をいつでも中止できるように、プロバイダーがサブスクライバーに返すことができる <xref:System.IDisposable> 実装を定義します。  次の例では、入れ子になった `Unsubscriber` クラスを定義しています。このクラスがインスタンス化されるときに、サブスクライバーのコレクションへの参照とサブスクライバーへの参照が渡されます。  このコードによって、サブスクライバーがオブジェクトの <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> 実装を呼び出して、サブスクライバーのコレクションから自身を削除できるようになります。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#4)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#4)]  
+  
+5.  <xref:System.IObservable%601.Subscribe%2A?displayProperty=fullName> メソッドを実装します。  これは <xref:System.IObserver%601?displayProperty=fullName> インターフェイスへの参照が渡されるメソッドであり、手順 3. で設計したオブジェクトに保存する必要があります。  このメソッドはその後、手順 4. で開発した <xref:System.IDisposable> 実装を返す必要があります。  `TemperatureMonitor` クラスの <xref:System.IObservable%601.Subscribe%2A> メソッドの実装の例を次に示します。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#5)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#5)]  
+  
+6.  オブザーバーの <xref:System.IObserver%601.OnNext%2A?displayProperty=fullName>、<xref:System.IObserver%601.OnError%2A?displayProperty=fullName>、および <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> の各実装を呼び出して、オブザーバーに適切に通知します。  場合によっては、エラーが発生したときに、プロバイダーが <xref:System.IObserver%601.OnError%2A> メソッドを呼び出さないことがあります。  たとえば、次の `GetTemperature` メソッドは、5 秒ごとに温度データを読み取るモニターをシミュレートし、前回の読み取りから温度が 0.1 度以上変化した場合にオブザーバーに通知します。  デバイスが温度を報告しない場合 \(つまり値が null の場合\) は、プロバイダーはオブザーバーに伝送が完了したことを通知します。  `GetTemperature` メソッドは、各オブザーバーの <xref:System.IObserver%601.OnCompleted%2A> メソッドを呼び出すだけでなく、<xref:System.Collections.Generic.List%601> のコレクションをクリアすることに注意してください。  この場合、プロバイダーは、オブザーバーの <xref:System.IObserver%601.OnError%2A> メソッドを呼び出しません。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#6)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#6)]  
+  
+## 使用例  
+ 温度監視アプリケーションの <xref:System.IObservable%601> の実装を定義するための完全なソース コードの例を次に示します。  オブザーバーに送信されるデータである `Temperature` 構造と、<xref:System.IObservable%601> の実装である `TemperatureMonitor` クラスが含まれます。  
+  
+ [!code-csharp[Conceptual.ObserverDesign.HowTo#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/provider.cs#7)]
+ [!code-vb[Conceptual.ObserverDesign.HowTo#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/provider.vb#7)]  
+  
+## 参照  
+ <xref:System.IObservable%601>   
+ [オブサーバー デザイン パターン](../../../docs/standard/events/observer-design-pattern.md)   
+ [方法: オブザーバーを実装する](../../../docs/standard/events/how-to-implement-an-observer.md)   
+ [オブサーバー デザイン パターンのベスト プラクティス](../../../docs/standard/events/observer-design-pattern-best-practices.md)
\ No newline at end of file
diff --git a/docs/standard/events/how-to-implement-an-observer.md b/docs/standard/events/how-to-implement-an-observer.md
new file mode 100644
index 00000000000..0b02d882381
--- /dev/null
+++ b/docs/standard/events/how-to-implement-an-observer.md
@@ -0,0 +1,57 @@
+---
+title: "方法: オブザーバーを実装する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "オブサーバー [.NET Framework]、オブサーバー デザイン パターン"
+  - "オブサーバー デザイン パターン [.NET Framework]、オブサーバーを実装する"
+ms.assetid: 8ecfa9f5-b500-473d-bcf0-5652ffb1e53d
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: オブザーバーを実装する
+オブザーバー デザイン パターンでは、通知の登録を行うオブザーバーと、データの監視および 1 つ以上のオブザーバーへの通知の送信を行うプロバイダーとを区別する必要があります。  このトピックでは、オブザーバーを作成する方法について説明します。  関連トピックの「[方法: プロバイダーを実装する](../../../docs/standard/events/how-to-implement-a-provider.md)」では、プロバイダーを作成する方法について説明します。  
+  
+### オブザーバーを作成するには  
+  
+1.  <xref:System.IObserver%601?displayProperty=fullName> インターフェイスを実装する型であるオブザーバーを定義します。  たとえば、次のコードでは、ジェネリック型引数の `Temperature` を使用して構築された <xref:System.IObserver%601?displayProperty=fullName> の実装である `TemperatureReporter` という型を定義しています。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/observer.cs#8)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/observer.vb#8)]  
+  
+2.  プロバイダーによって <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> の実装が呼び出される前にオブザーバーが通知の受信を中止できる場合は、プロバイダーの <xref:System.IObservable%601.Subscribe%2A?displayProperty=fullName> メソッドから返される <xref:System.IDisposable> の実装を保持するプライベート変数を定義します。  また、プロバイダーの <xref:System.IObservable%601.Subscribe%2A> メソッドを呼び出し、返される <xref:System.IDisposable> オブジェクトを格納するサブスクリプション メソッドを定義する必要があります。  たとえば、次のコードでは、`unsubscriber` というプライベート変数を定義し、プロバイダーの <xref:System.IObservable%601.Subscribe%2A> メソッドを呼び出して返されたオブジェクトを `unsubscriber` 変数に代入する `Subscribe` メソッドを定義しています。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/observer.cs#9)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/observer.vb#9)]  
+  
+3.  必要に応じて、プロバイダーによって <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> の実装が呼び出される前にオブザーバーが通知の受信を中止できるようにするメソッドを定義します。  次の例では、`Unsubscribe` メソッドを定義しています。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/observer.cs#10)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/observer.vb#10)]  
+  
+4.  <xref:System.IObserver%601> インターフェイスによって定義される 3 つのメソッド \(<xref:System.IObserver%601.OnNext%2A?displayProperty=fullName>、<xref:System.IObserver%601.OnError%2A?displayProperty=fullName>、および <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName>\) を実装します。  プロバイダーおよびアプリケーションの必要に応じて、<xref:System.IObserver%601.OnError%2A> メソッドと <xref:System.IObserver%601.OnCompleted%2A> メソッドは、スタブ実装にすることができます。  <xref:System.IObserver%601.OnError%2A> メソッドは渡された <xref:System.Exception> オブジェクトを例外として処理せず、<xref:System.IObserver%601.OnCompleted%2A> メソッドはプロバイダーの <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装を自由に呼び出すことができる点に注意してください。  `TemperatureReporter` クラスの <xref:System.IObserver%601> の実装例を次に示します。  
+  
+     [!code-csharp[Conceptual.ObserverDesign.HowTo#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/observer.cs#11)]
+     [!code-vb[Conceptual.ObserverDesign.HowTo#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/observer.vb#11)]  
+  
+## 使用例  
+ 温度監視アプリケーションの <xref:System.IObserver%601> を実装する `TemperatureReporter` クラスの完全なソース コード例を次に示します。  
+  
+ [!code-csharp[Conceptual.ObserverDesign.HowTo#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesign.howto/cs/observer.cs#12)]
+ [!code-vb[Conceptual.ObserverDesign.HowTo#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesign.howto/vb/observer.vb#12)]  
+  
+## 参照  
+ <xref:System.IObserver%601>   
+ [オブサーバー デザイン パターン](../../../docs/standard/events/observer-design-pattern.md)   
+ [方法: プロバイダーを実装する](../../../docs/standard/events/how-to-implement-a-provider.md)   
+ [オブサーバー デザイン パターンのベスト プラクティス](../../../docs/standard/events/observer-design-pattern-best-practices.md)
\ No newline at end of file
diff --git a/docs/standard/events/how-to-raise-and-consume-events.md b/docs/standard/events/how-to-raise-and-consume-events.md
new file mode 100644
index 00000000000..f3682342b7d
--- /dev/null
+++ b/docs/standard/events/how-to-raise-and-consume-events.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : イベントを発生させる/処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "イベント [.NET Framework], 発生"
+  - "イベント [.NET Framework], サンプル"
+  - "発生 (イベントを)"
+ms.assetid: 42afade7-3a02-4f2e-868b-95845f302f8f
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : イベントを発生させる/処理する
+このトピックの例では、イベントを使用する方法を示します。  ここでは、<xref:System.EventHandler> デリゲートと <xref:System.EventHandler%601> デリゲート、およびカスタム デリゲートの例を使用して、データを持つイベントと持たないイベントを示します。  
+  
+ この例では、「[イベント](../../../docs/standard/events/index.md)」で説明されている概念を使用します。  
+  
+## 使用例  
+ 最初の例は、データを持たないイベントを発生させて処理する方法を示しています。  この例には、`ThresholdReached` という名前のイベントを持つ、`Counter` という名前のクラスが含まれます。  このイベントは、カウンター値がしきい値と等しいか、またはそれを超えた場合に発生します。  イベントのデータが指定されていないため、<xref:System.EventHandler> デリゲートはイベントに関連付けられます。  
+  
+ [!code-csharp[EventsOverview#5](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programnodata.cs#5)]
+ [!code-vb[EventsOverview#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1nodata.vb#5)]  
+  
+## 使用例  
+ 次の例は、データを持つイベントを発生させて処理する方法を示しています。  <xref:System.EventHandler%601> デリゲートはイベントに関連付けられ、カスタム イベント データ オブジェクトのインスタンスが提供されます。  
+  
+ [!code-cpp[EventsOverview#6](../../../samples/snippets/cpp/VS_Snippets_CLR/eventsoverview/cpp/programwithdata.cpp#6)]
+ [!code-csharp[EventsOverview#6](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programwithdata.cs#6)]
+ [!code-vb[EventsOverview#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1withdata.vb#6)]  
+  
+## 使用例  
+ 次の例は、イベントのデリゲートを宣言する方法を示しています。  デリゲートの名前は `ThresholdReachedEventHandler` です。  これはあくまでも一例です。  通常は、<xref:System.EventHandler> デリゲートまたは <xref:System.EventHandler%601> デリゲートを使用できるため、イベントのデリゲートを宣言する必要はありません。  ジェネリックを使用できないレガシ コードでクラスを使用できるようにするなど、ごくまれに、デリゲートの宣言が必要になることがあります。  
+  
+ [!code-csharp[EventsOverview#7](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programwithdelegate.cs#7)]
+ [!code-vb[EventsOverview#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1withdelegate.vb#7)]  
+  
+## 参照  
+ [イベント](../../../docs/standard/events/index.md)
\ No newline at end of file
diff --git a/docs/standard/events/index.md b/docs/standard/events/index.md
new file mode 100644
index 00000000000..bc5d1030eeb
--- /dev/null
+++ b/docs/standard/events/index.md
@@ -0,0 +1,98 @@
+---
+title: "イベントの処理と発生 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [.NET Framework], イベント"
+  - "デリゲート モデル (イベントの)"
+  - "イベント [.NET Framework]"
+ms.assetid: b6f65241-e0ad-4590-a99f-200ce741bb1f
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# イベントの処理と発生
+.NET Framework でのイベントは、デリゲート モデルに基づいています。  デリゲート モデルはオブザーバー デザイン パターンに従って、サブスクライバーがプロバイダーに登録して通知を受信できるようにします。  イベントの送信元がイベント発生の通知をプッシュしたら、イベント レシーバーはその通知を受信して、通知に対する応答を定義します。  ここでは、デリゲート モデルの主要コンポーネント、アプリケーションでイベントを利用する方法、およびコードでイベントを実装する方法について説明します。  
+  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでのイベントの処理については、「[イベントとルーティング イベントの概要](http://go.microsoft.com/fwlink/p/?LinkId=261485)」を参照してください。  
+  
+## イベント  
+ イベントは、アクションの発生を知らせるために、オブジェクトによって送信されるメッセージです。  アクションは、ユーザーがボタンのクリックなどの対話的操作を行った場合や、プロパティの値の変更など、なんらかのプログラム ロジックによって発生します。  イベントを発生させるオブジェクトを "イベントの送信元" と呼びます。  イベントの送信元は、発生させたイベントをどのオブジェクトまたはメソッドが受信する \(処理する\) かについての情報を持っていません。  このイベントはイベントの送信元のメンバーです。たとえば、<xref:System.Web.UI.WebControls.Button.Click> イベントは <xref:System.Web.UI.WebControls.Button> クラスのメンバーであり、<xref:System.ComponentModel.INotifyPropertyChanged.PropertyChanged> イベントは <xref:System.ComponentModel.INotifyPropertyChanged> インターフェイスを実装するクラスのメンバーです。  
+  
+ イベントを定義するには、イベント クラスのシグネチャで `event` \(C\# の場合\) または `Event` \(Visual Basic の場合\) のキーワードを使用し、イベントにデリゲートの型を指定します。  デリゲートについては、次のセクションで説明します。  
+  
+ 通常、イベントを発生させるには、`protected` や `virtual` \(C\# の場合\)、または `Protected` や `Overridable` \(Visual Basic の場合\) としてマークされたメソッドを追加します。  このメソッドには `On`*EventName* という形式で名前を付けます \(`OnDataReceived` など\)。  また、イベント データ オブジェクトを指定するパラメーターを 1 つ指定する必要があります。  このメソッドを指定すると、イベントを発生させるためのロジックを派生クラスでオーバーライドできます。  派生クラスは常に基底クラスの `On`*EventName* メソッドを呼び出して、登録されたデリゲートがイベントを必ず受信できるようにします。  
+  
+ 次の例は、`ThresholdReached` という名前のイベントを宣言する方法を示しています。  イベントは <xref:System.EventHandler> デリゲートに関連付けられ、`OnThresholdReached` という名前のメソッドで発生します。  
+  
+ [!code-csharp[EventsOverview#1](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programtruncated.cs#1)]
+ [!code-vb[EventsOverview#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1truncated.vb#1)]  
+  
+## デリゲート  
+ デリゲートは、メソッドへの参照を保持する型です。  デリゲートは、自身が参照するメソッドの戻り値とパラメーターを表示するシグネチャで宣言され、このシグネチャに一致するメソッドへの参照だけを保持できます。  これにより、デリゲートはタイプ セーフな関数ポインターやコールバックと同等の機能を持つことができます。  デリゲート クラスは、宣言すると、定義は不要です。  
+  
+ .NET Framework でのデリゲートの用途は多数あります。  イベントのコンテキストでは、デリゲートは、イベント ソースとイベントを処理するコードの間を仲介するもの、つまりポインター的な機構です。  デリゲートをイベントに関連付けるには、デリゲート型をイベント宣言に追加します。  デリゲートの詳細については、「<xref:System.Delegate> クラス」を参照してください。  
+  
+ .NET Framework には <xref:System.EventHandler> デリゲートおよび <xref:System.EventHandler%601> デリゲートが用意されており、ほとんどのイベント シナリオがサポートされます。  <xref:System.EventHandler> デリゲートは、イベント データを含まないすべてのイベントに対して使用します。  <xref:System.EventHandler%601> デリゲートは、イベントに関するデータを含むイベントに使用します。  これらのデリゲートには戻り値の型の値がなく、2 つのパラメーター \(イベント ソース用オブジェクトとイベント データ用オブジェクト\) を受け取ります。  
+  
+ デリゲートはマルチキャストであるため、複数のイベント処理メソッドへの参照を保持できます。  詳細については、<xref:System.Delegate> のリファレンス ページを参照してください。  デリゲートでは、イベント処理を柔軟に、そして詳細に制御できます。  デリゲートは、イベントに対して登録されているイベント ハンドラーのリストを管理することで、そのイベントを発生させるクラスのイベント ディスパッチャーとして動作します。  
+  
+ <xref:System.EventHandler> デリゲートおよび <xref:System.EventHandler%601> デリゲートが動作しないシナリオについては、デリゲートを定義できます。  デリゲートの定義が必要なシナリオは非常にまれで、たとえば、ジェネリックを認識しないコードを使用する必要がある場合などです。  デリゲートには、宣言内で `delegate` キーワード \(C\# の場合\) および `Delegate` キーワード \(Visual Basic の場合\) を使用してマークします。  次の例は、`ThresholdReachedEventHandler` という名前のデリゲートを宣言する方法を示しています。  
+  
+ [!code-csharp[EventsOverview#4](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programtruncated.cs#4)]
+ [!code-vb[EventsOverview#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1truncated.vb#4)]  
+  
+## イベント データ  
+ イベントに関連付けられたデータは、イベント データ クラスを使用して提供できます。  .NET Framework には、アプリケーションで使用できるイベント データ クラスが多数用意されています。  たとえば、<xref:System.IO.Ports.SerialDataReceivedEventArgs> クラスは、<xref:System.IO.Ports.SerialPort.DataReceived?displayProperty=fullName> イベントのイベント データ クラスです。  .NET Framework の名前付けパターンでは、すべてのイベント データ クラス名の末尾に `EventArgs` が付きます。  イベントに関連付けられているイベント データ クラスは、そのイベントのデリゲートを見ればわかります。  たとえば、<xref:System.IO.Ports.SerialDataReceivedEventHandler> デリゲートには、パラメーターの 1 つとして <xref:System.IO.Ports.SerialDataReceivedEventArgs> クラスが含まれます。  
+  
+ <xref:System.EventArgs> は、すべてのイベント データ クラスの基本型です。  また、<xref:System.EventArgs> は、イベントにデータが関連付けられていないときに使用するクラスでもあります。  何かが発生したことを他のクラスに通知することのみが目的のイベント、つまり、データの受け渡しを必要としないイベントを作成する場合は、デリゲートの 2 番目のパラメーターとして <xref:System.EventArgs> クラスを追加します。  データが指定されていない場合は、<xref:System.EventArgs.Empty?displayProperty=fullName> 値を渡すことができます。  <xref:System.EventHandler> デリゲートには、パラメーターとして <xref:System.EventArgs> クラスが含まれます。  
+  
+ カスタマイズされたイベント データ クラスを作成する場合は、<xref:System.EventArgs>から派生したクラスを作成し、イベントに関連するデータを渡すのに必要なメンバーを指定します。  通常は、.NET Framework と同じ名前付けパターンを使用する必要があり、イベント データ クラス名の末尾には `EventArgs` が付きます。  
+  
+ 次の例は、`ThresholdReachedEventArgs` という名前のイベント データを示しています。  これには、発生したイベントに応じた特定のプロパティが含まれます。  
+  
+ [!code-csharp[EventsOverview#3](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programtruncated.cs#3)]
+ [!code-vb[EventsOverview#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1truncated.vb#3)]  
+  
+## イベント ハンドラー  
+ イベントに応答するには、イベント レシーバーのイベント ハンドラー メソッドを定義します。  このメソッドは、処理するイベントのデリゲートのシグネチャと一致する必要があります。  イベント ハンドラーでは、ユーザーがボタンをクリックしたときにユーザー入力を収集するなど、イベントが発生したときに必要なアクションを実行します。  イベントが発生したときに通知を受け取るには、イベント ハンドラー メソッドがイベントをサブスクライブする必要があります。  
+  
+ 次の例は、<xref:System.EventHandler> デリゲートのシグネチャと一致する、`c_ThresholdReached` という名前のイベント ハンドラー メソッドを示しています。  メソッドは、`ThresholdReached` イベントをサブスクライブします。  
+  
+ [!code-csharp[EventsOverview#2](../../../samples/snippets/csharp/VS_Snippets_CLR/eventsoverview/cs/programtruncated.cs#2)]
+ [!code-vb[EventsOverview#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/eventsoverview/vb/module1truncated.vb#2)]  
+  
+## 静的イベント ハンドラーと動的イベント ハンドラー  
+ .NET Framework を使用すると、静的または動的にイベント通知のためのサブスクライバーを登録できます。  静的なイベント ハンドラーは、処理対象のイベントのクラスの有効期間にわたって有効になります。  動的なイベント ハンドラーは、プログラムの実行中、通常は条件付きのプログラム ロジックに応答する形で、明示的にアクティブ化または非アクティブ化されます。  たとえば、特定の条件下でのみイベント通知が必要な場合や、複数のイベント ハンドラーを持つアプリケーションで、実行時の条件に応じて適切なハンドラーを決定する場合などに使用できます。  前のセクションの例は、イベント ハンドラーを動的に追加する方法を示しています。  詳細については、「[Events](../Topic/Events%20\(Visual%20Basic\).md)」および「[イベント](../Topic/Events%20\(C%23%20Programming%20Guide\).md)」を参照してください。  
+  
+## 複数のイベントの発生  
+ クラスで複数のイベントを発生させる場合、コンパイラでは、イベント デリゲートのインスタンスごとに 1 つのフィールドが生成されます。  イベントの数が多い場合は、デリゲート 1 つあたり 1 フィールドというストレージ コストが許容されない可能性があります。  このような状況に備えて、.NET Framework には、イベント デリゲートを格納するために任意に選択した別のデータ構造と一緒に使用できる、イベント プロパティが用意されています。  
+  
+ イベント プロパティは、イベント アクセサーを伴うイベント宣言によって構成されます。  イベント アクセサーは、ストレージ データ構造におけるイベント デリゲート インスタンスの追加または削除を定義するメソッドです。  イベント プロパティを使用すると、イベント プロパティは各イベント デリゲートを呼び出す前に取得する必要があるので、イベント フィールドよりも低速です。  つまり、メモリを取るか、速度を取るかの比較検討になります。  クラスで、発生頻度の低いイベントを数多く定義する場合は、イベント プロパティを実装することをお勧めします。  詳細については、「[方法 : イベント プロパティを使用して複数のイベントを処理する](../../../docs/standard/events/how-to-handle-multiple-events-using-event-properties.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[方法 : イベントを発生させる\/処理する](../../../docs/standard/events/how-to-raise-and-consume-events.md)|イベントの発生例と実装例が含まれます。|  
+|[方法 : イベント プロパティを使用して複数のイベントを処理する](../../../docs/standard/events/how-to-handle-multiple-events-using-event-properties.md)|イベント プロパティを使用して複数のイベントを処理する方法を示します。|  
+|[オブサーバー デザイン パターン](../../../docs/standard/events/observer-design-pattern.md)|サブスクライバーがプロバイダーに登録して、通知を受信できるようにするデザイン パターンについて説明します。|  
+|[方法 : Web フォーム アプリケーションでイベントを利用する](../../../docs/standard/events/how-to-consume-events-in-a-web-forms-application.md)|Web フォーム コントロールによって発生したイベントを処理する方法を示します。|  
+  
+## 参照  
+ <xref:System.EventHandler>   
+ <xref:System.EventHandler%601>   
+ <xref:System.EventArgs>   
+ <xref:System.Delegate>   
+ [イベントとルーティング イベントの概要](http://go.microsoft.com/fwlink/?LinkId=261485)   
+ [Events](../Topic/Events%20\(Visual%20Basic\).md)   
+ [イベント](../Topic/Events%20\(C%23%20Programming%20Guide\).md)
\ No newline at end of file
diff --git a/docs/standard/events/observer-design-pattern-best-practices.md b/docs/standard/events/observer-design-pattern-best-practices.md
new file mode 100644
index 00000000000..e9a807f1db8
--- /dev/null
+++ b/docs/standard/events/observer-design-pattern-best-practices.md
@@ -0,0 +1,63 @@
+---
+title: "オブサーバー デザイン パターンのベスト プラクティス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "最適な使用方法 [.NET Framework], オブサーバー デザイン パターン"
+  - "オブサーバー デザイン パターン [.NET Framework], 推奨される手順"
+ms.assetid: c834760f-ddd4-417f-abb7-a059679d5b8c
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# オブサーバー デザイン パターンのベスト プラクティス
+.NET Framework では、オブザーバー デザイン パターンは、一連のインターフェイスとして実装されます。  <xref:System.IObservable%601?displayProperty=fullName> インターフェイスはデータ プロバイダーを表し、データ プロバイダーはオブザーバーで通知のサブスクリプションを解除できるようにする <xref:System.IDisposable> 実装も提供します。  <xref:System.IObserver%601?displayProperty=fullName> インターフェイスはオブザーバーを表します。  このトピックでは、これらのインターフェイスを使用してオブザーバー デザイン パターンを実装するときに、開発者が適用することが望ましいベスト プラクティスについて説明します。  
+  
+## スレッド処理  
+ 通常、プロバイダーは、何らかのコレクション オブジェクトで表されるサブスクライバー リストに特定のオブザーバーを追加することで、<xref:System.IObservable%601.Subscribe%2A?displayProperty=fullName> メソッドを実装し、サブスクライバー リストから特定のオブザーバーを削除することで、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> メソッドを実装します。  オブザーバーは、これらのメソッドをいつでも呼び出すことができます。  また、プロバイダー\/オブザーバーのコントラクトでは、<xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> コールバック メソッドの後にだれがサブスクリプションを解除するかが指定されていないため、プロバイダーとオブザーバーの両方で同じメンバーをリストから削除しようとする可能性があります。  このような可能性があるため、<xref:System.IObservable%601.Subscribe%2A> メソッドと <xref:System.IDisposable.Dispose%2A> メソッドはどちらもスレッド セーフである必要があります。  通常、これには、[同時実行コレクション](../../../docs/standard/parallel-programming/data-structures-for-parallel-programming.md)またはロックの使用が必要です。  非スレッド セーフの実装では、スレッド セーフではないことが明示的に記載されている必要があります。  
+  
+ その他の保証は、プロバイダー\/オブザーバーのコントラクトの最上部のレイヤーで指定されている必要があります。  実装側で要件を追加する場合には、ユーザーがオブザーバー コントラクトについて混乱しないように明確に示す必要があります。  
+  
+## 例外処理  
+ データ プロバイダーとオブザーバーの結合は疎であるため、オブザーバー デザイン パターンの例外は情報提供を目的としています。  このことは、プロバイダーとオブザーバーがオブザーバー デザイン パターンの例外を処理する方法に影響します。  
+  
+### プロバイダー \-\- OnError メソッドの呼び出し  
+ <xref:System.IObserver%601.OnError%2A> メソッドは、<xref:System.IObserver%601.OnNext%2A?displayProperty=fullName> メソッドと同様に、オブザーバーへの情報メッセージとして使用されます。  ただし、<xref:System.IObserver%601.OnNext%2A> メソッドが、現在のデータまたは更新されたデータをオブザーバーに提供するように設計されているのに対して、<xref:System.IObserver%601.OnError%2A> メソッドは、プロバイダーが有効なデータを提供できないことを示すように設計されています。  
+  
+ 例外を処理して <xref:System.IObserver%601.OnError%2A> メソッドを呼び出す場合、プロバイダーが次のベスト プラクティスに従うことをお勧めします。  
+  
+-   プロバイダーに固有の要件がある場合、プロバイダーは独自の例外を処理する必要があります。  
+  
+-   プロバイダーは、オブザーバーが特定の方法で例外を処理することを期待または要求しないようにします。  
+  
+-   更新を提供する機能を損なうような例外を処理する場合、プロバイダーは <xref:System.IObserver%601.OnError%2A> メソッドを呼び出す必要があります。  このような例外の情報はオブザーバーに渡すことができます。  それ以外の場合は、オブザーバーに例外を通知する必要はありません。  
+  
+ プロバイダーが <xref:System.IObserver%601.OnError%2A> メソッドまたは <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> メソッドを呼び出すと、それ以上の通知は行われなくなるため、プロバイダーはそのオブザーバーのサブスクリプションを解除することができます。  ただし、オブザーバーも、<xref:System.IObserver%601.OnError%2A> 通知または <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName> 通知を受信する前と後の両方を含め、いつでも自分自身のサブスクリプションを解除できます。  オブザーバー デザイン パターンでは、プロバイダーとオブザーバーのどちらがサブスクリプションの解除を行うかは指定しません。そのため、両方でサブスクリプションの解除を試みる可能性があります。  通常、オブザーバーは、サブスクリプションを解除すると、サブスクライバーのコレクションから削除されます。  シングルスレッド アプリケーションでは、削除を試みる前に、オブジェクト参照が有効であること、およびオブジェクトがサブスクライバーのコレクションのメンバーであることを、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装で確認する必要があります。  マルチスレッド アプリケーションでは、<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName> オブジェクトなどのスレッド セーフなコレクション オブジェクトを使用する必要があります。  
+  
+### オブザーバー \-\- OnError メソッドの実装  
+ プロバイダーからエラー通知を受信した場合、オブザーバーは例外を情報として処理する必要がありますが、特定のアクションの実行は要求されません。  
+  
+ プロバイダーからの <xref:System.IObserver%601.OnError%2A> メソッド呼び出しに応答する場合、オブザーバーが次のベスト プラクティスに従うことをお勧めします。  
+  
+-   <xref:System.IObserver%601.OnNext%2A> または <xref:System.IObserver%601.OnError%2A> などのインターフェイス実装からオブザーバーが例外をスローすることを回避するようにします。  オブザーバーが例外をスローする場合は、これらの例外が未処理になることを想定する必要があります。  
+  
+-   呼び出し履歴を保持するために、<xref:System.IObserver%601.OnError%2A> メソッドに渡された <xref:System.Exception> オブジェクトをスローするオブザーバーは、オブジェクトをスローする前に例外をラップする必要があります。  このためには、標準の例外オブジェクトを使用する必要があります。  
+  
+## その他のベスト プラクティス  
+ <xref:System.IObservable%601.Subscribe%2A?displayProperty=fullName> メソッドで登録を解除しようとすると、null 参照になる場合があります。  そのため、この方法は避けることをお勧めします。  
+  
+ 1 つのオブザーバーを複数のプロバイダーにアタッチすることは可能ですが、推奨パターンは、<xref:System.IObserver%601> インスタンスを 1 つの <xref:System.IObservable%601> インスタンスにのみアタッチすることです。  
+  
+## 参照  
+ [オブサーバー デザイン パターン](../../../docs/standard/events/observer-design-pattern.md)   
+ [方法: オブザーバーを実装する](../../../docs/standard/events/how-to-implement-an-observer.md)   
+ [方法: プロバイダーを実装する](../../../docs/standard/events/how-to-implement-a-provider.md)
\ No newline at end of file
diff --git a/docs/standard/events/observer-design-pattern.md b/docs/standard/events/observer-design-pattern.md
new file mode 100644
index 00000000000..87e74a0007e
--- /dev/null
+++ b/docs/standard/events/observer-design-pattern.md
@@ -0,0 +1,98 @@
+---
+title: "オブサーバー デザイン パターン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "IObservable(Of T) インターフェイス"
+  - "IObservable<T> インターフェイス"
+  - "IObserver(Of T) インターフェイス"
+  - "IObserver<T> インターフェイス"
+  - "オブサーバー デザイン パターン [.NET Framework]"
+ms.assetid: 3680171f-f522-453c-aa4a-54f755a78f88
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# オブサーバー デザイン パターン
+オブザーバー デザイン パターンでは、プロバイダーにサブスクライバーを登録して通知を受信することができます。  このデザイン パターンは、プッシュ ベースの通知を必要とするあらゆるシナリオに適しています。  このパターンでは、1 つの*プロバイダー* \(*サブジェクト*または*観察可能なオブジェクト*とも呼ばれます\) と、0 個以上の*オブザーバー*を定義します。  プロバイダーにオブザーバーを登録すると、あらかじめ定義した条件、イベント、または状態変化が発生するたびに、プロバイダーのいずれかのメソッドが呼び出されて自動的にすべてのオブザーバーに通知されます。  このメソッド呼び出しで、プロバイダーからオブザーバーに現在の状態の情報を提供することもできます。  .NET Framework でオブザーバー デザイン パターンを適用するには、ジェネリック インターフェイスの <xref:System.IObservable%601?displayProperty=fullName> および <xref:System.IObserver%601?displayProperty=fullName> を実装します。  ジェネリック型パラメーターは、通知情報を提供する型を表します。  
+  
+## パターンの適用  
+ オブザーバー デザイン パターンは、データ ソース \(ビジネス ロジック\) 層とユーザー インターフェイス \(表示\) 層のように、2 つの異なるコンポーネントまたはアプリケーション層を明確に分離できるため、分散型のプッシュ ベースの通知に適しています。  このパターンは、プロバイダーがコールバックを使用して現在の情報をクライアントに提供するあらゆる場面で実装できます。  
+  
+ このパターンを実装するために必要なものを以下に示します。  
+  
+-   プロバイダー \(サブジェクト\)。オブザーバーに通知を送信するオブジェクトです。  プロバイダーは、<xref:System.IObservable%601> インターフェイスを実装するクラスまたは構造体で、  <xref:System.IObservable%601.Subscribe%2A?displayProperty=fullName> という 1 つのメソッドを実装する必要があります。このメソッドは、プロバイダーからの通知を受信するオブザーバーによって呼び出されます。  
+  
+-   オブザーバー。プロバイダーからの通知を受信するオブジェクトです。  オブザーバーは、<xref:System.IObserver%601> インターフェイスを実装するクラスまたは構造体で、  オブザーバーでは、次の 3 つのメソッドを実装する必要があります。これらはすべてプロバイダーによって呼び出されます。  
+  
+    -   <xref:System.IObserver%601.OnNext%2A?displayProperty=fullName>。新しい情報または現在の情報をオブザーバーに提供します。  
+  
+    -   <xref:System.IObserver%601.OnError%2A?displayProperty=fullName>。エラーが発生したことをオブザーバーに通知します。  
+  
+    -   <xref:System.IObserver%601.OnCompleted%2A?displayProperty=fullName>。プロバイダーが通知の送信を完了したことを示します。  
+  
+-   プロバイダーがオブザーバーを追跡するための機構。  通常、プロバイダーでは、<xref:System.Collections.Generic.List%601?displayProperty=fullName> オブジェクトなどのコンテナー オブジェクトを使用して、通知にサブスクライブした <xref:System.IObserver%601> の実装への参照を保持します。  このようにストレージ コンテナーを使用すると、プロバイダーで必要に応じていくつでもオブザーバーを処理できます。  オブザーバーが通知を受信する順序は定義されていないため、プロバイダーで自由に順序を決定できます。  
+  
+-   通知が完了したときにプロバイダーがオブザーバーを削除できるようにするための <xref:System.IDisposable> の実装。  オブザーバーは、<xref:System.IDisposable> の実装への参照を <xref:System.IObservable%601.Subscribe%2A> メソッドから受け取ります。このため、プロバイダーが通知の送信を終了する前に、オブザーバーで <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> メソッドを呼び出してサブスクリプションを解除することもできます。  
+  
+-   プロバイダーがオブザーバーに送信するデータを含むオブジェクト。  このオブジェクトの型は、<xref:System.IObservable%601> インターフェイスと <xref:System.IObserver%601> インターフェイスのジェネリック型パラメーターに対応します。  このオブジェクトは、<xref:System.IObservable%601> の実装と同じにすることもできますが、別の型にするのが最も一般的です。  
+  
+> [!NOTE]
+>  オブザーバー デザイン パターンを実装するだけでなく、<xref:System.IObservable%601> インターフェイスと <xref:System.IObserver%601> インターフェイスを使用して構築されたライブラリを使用することもできます。  たとえば、[.NET \(Rx\) の反応拡張](http://go.microsoft.com/fwlink/?LinkId=186345) は、非同期プログラミングをサポートする一連の拡張メソッドと LINQ 標準シーケンス演算子で構成します。  
+  
+## パターンの実装  
+ 次の例では、オブザーバー デザイン パターンを使用して、空港の手荷物受取所の情報システムを実装します。  `BaggageInfo` クラスは、到着便と、各便の手荷物の受け取り場所に関する情報を提供します。  これを次の例に示します。  
+  
+ [!code-csharp[Conceptual.ObserverDesignPattern#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesignpattern/cs/provider.cs#1)]
+ [!code-vb[Conceptual.ObserverDesignPattern#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesignpattern/vb/provider.vb#1)]  
+  
+ `BaggageHandler` クラスは、到着便と手荷物の受け取り場所に関する情報を受け取るクラスです。  その内部では、次の 2 つのコレクションが保持されます。  
+  
+-   `observers` \- 更新された情報を受け取るクライアントのコレクション。  
+  
+-   `flights` \- 飛行機の便と、各便に割り当てられた手荷物の受け取り場所のコレクション。  
+  
+ どちらのコレクションも、`BaggageHandler` クラスのコンストラクターでインスタンス化されるジェネリック <xref:System.Collections.Generic.List%601> オブジェクトによって表されます。  `BaggageHandler` クラスのソース コードを次の例に示します。  
+  
+ [!code-csharp[Conceptual.ObserverDesignPattern#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesignpattern/cs/provider.cs#2)]
+ [!code-vb[Conceptual.ObserverDesignPattern#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesignpattern/vb/provider.vb#2)]  
+  
+ 更新された情報を受け取るクライアントは、`BaggageHandler.Subscribe` メソッドを呼び出します。  以前に通知をサブスクライブしたことがないクライアントの場合は、クライアントの <xref:System.IObserver%601> の実装への参照が `observers` コレクションに追加されます。  
+  
+ オーバーロードされた `BaggageHandler.BaggageStatus` メソッドは、特定の便の手荷物が処理中であるか処理済みになったかを通知するために呼び出されます。  処理中の場合は、飛行機の便の番号、出発空港、および手荷物の受け取り場所がメソッドに渡されます。  処理済みの場合は、飛行機の便の番号のみがメソッドに渡されます。  手荷物が処理中の場合、メソッドは、渡された `BaggageInfo` の情報が `flights` コレクションに存在するかどうかを確認します。  存在しない場合は、メソッドによりその情報が追加され、各オブザーバーの `OnNext` メソッドが呼び出されます。  荷物を降ろさない便の場合、メソッドは、その便の情報が `flights` コレクションに格納されているかどうかを確認します。  格納されている場合、メソッドは、各オブザーバーの `OnNext` メソッドを呼び出し、`flights` コレクションから `BaggageInfo` オブジェクトを削除します。  
+  
+ 1 日の最終便が到着して手荷物の処理が完了すると、`BaggageHandler.LastBaggageClaimed` メソッドが呼び出されます。  このメソッドは、各オブザーバーの `OnCompleted` メソッドを呼び出して、すべての通知が完了したことを示します。その後、`observers` コレクションをクリアします。  
+  
+ プロバイダーの <xref:System.IObservable%601.Subscribe%2A> メソッドが返す <xref:System.IDisposable> の実装を使用すると、<xref:System.IObserver%601.OnCompleted%2A> メソッドが呼び出される前に、オブザーバーで通知の受信を中止できます。  この `Unsubscriber(Of BaggageInfo)` クラスのソース コードを次の例に示します。  このクラスが `BaggageHandler.Subscribe` メソッドでインスタンス化されるときに、`observers` コレクションへの参照と、コレクションに追加されるオブザーバーへの参照が渡されます。  これらの参照はローカル変数に割り当てられます。  オブジェクトの `Dispose` メソッドが呼び出されると、オブザーバーがまだ `observers` コレクションに存在するかどうかが確認され、存在する場合、そのオブザーバーは削除されます。  
+  
+ [!code-csharp[Conceptual.ObserverDesignPattern#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesignpattern/cs/provider.cs#3)]
+ [!code-vb[Conceptual.ObserverDesignPattern#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesignpattern/vb/provider.vb#3)]  
+  
+ 次の例は、`ArrivalsMonitor` という名前の <xref:System.IObserver%601> の実装を示しています。これは、手荷物受取所の情報を表示する基本クラスです。  情報は、出発地名のアルファベット順に表示されます。  `ArrivalsMonitor` のメソッドは、`overridable` \(Visual Basic\) または `virtual` \(C\#\) としてマークされているため、派生クラスによりすべてオーバーライドできます。  
+  
+ [!code-csharp[Conceptual.ObserverDesignPattern#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesignpattern/cs/observer.cs#4)]
+ [!code-vb[Conceptual.ObserverDesignPattern#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesignpattern/vb/observer.vb#4)]  
+  
+ `ArrivalsMonitor` クラスには、`Subscribe` メソッドと `Unsubscribe` メソッドが含まれています。  `Subscribe` メソッドにより、このクラスは、<xref:System.IObservable%601.Subscribe%2A> の呼び出しから返された <xref:System.IDisposable> の実装をプライベート変数に保存できます。  `Unsubscribe` メソッドにより、このクラスは、プロバイダーの <xref:System.IDisposable.Dispose%2A> の実装を呼び出して通知のサブスクリプションを解除できます。  `ArrivalsMonitor` は、<xref:System.IObserver%601.OnNext%2A>、<xref:System.IObserver%601.OnError%2A>、<xref:System.IObserver%601.OnCompleted%2A> の各メソッドの実装も提供します。  そのうち、かなりの量のコードが含まれるのは <xref:System.IObserver%601.OnNext%2A> の実装だけです。  このメソッドは、到着便の出発空港と手荷物の受け取り場所に関する情報を並べ替えて保持する、プライベートなジェネリック <xref:System.Collections.Generic.List%601> オブジェクトを操作します。  `BaggageHandler` クラスから新しい便の到着が報告されると、<xref:System.IObserver%601.OnNext%2A> メソッドの実装はその便に関する情報をリストに追加します。  `BaggageHandler` クラスからその便の手荷物の処理が完了したことが報告されると、<xref:System.IObserver%601.OnNext%2A> メソッドはその便をリストから削除します。  変更が発生するたびに、リストが並べ替えられてコンソールに表示されます。  
+  
+ 次の例に含まれているアプリケーション エントリ ポイントは、`BaggageHandler` クラスのインスタンスと、`ArrivalsMonitor` クラスの 2 つのインスタンスを作成し、`BaggageHandler.BaggageStatus` メソッドを使用して到着便に関する情報を追加および削除します。  いずれの場合も、オブザーバーが更新を受け取って、手荷物受取所の情報を正しく表示します。  
+  
+ [!code-csharp[Conceptual.ObserverDesignPattern#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.observerdesignpattern/cs/program.cs#5)]
+ [!code-vb[Conceptual.ObserverDesignPattern#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.observerdesignpattern/vb/module1.vb#5)]  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[オブサーバー デザイン パターンのベスト プラクティス](../../../docs/standard/events/observer-design-pattern-best-practices.md)|オブザーバー デザイン パターンを実装するアプリケーションを開発するときのベスト プラクティスについて説明します。|  
+|[方法: プロバイダーを実装する](../../../docs/standard/events/how-to-implement-a-provider.md)|温度監視アプリケーションのプロバイダーを実装するための手順について説明します。|  
+|[方法: オブザーバーを実装する](../../../docs/standard/events/how-to-implement-an-observer.md)|温度監視アプリケーションのオブザーバーを実装するための手順について説明します。|
\ No newline at end of file
diff --git a/docs/standard/exceptions/TOC.md b/docs/standard/exceptions/TOC.md
new file mode 100644
index 00000000000..7e230a39fb0
--- /dev/null
+++ b/docs/standard/exceptions/TOC.md
@@ -0,0 +1,11 @@
+# [例外](index.md)
+# [例外階層](exception-hierarchy.md)
+# [例外の推奨事項](best-practices-for-exceptions.md)
+# [例外処理の基本事項](exception-handling-fundamentals.md)
+# [COM 相互運用の例外の処理](handling-com-interop-exceptions.md)
+# [Exception クラスとプロパティ](exception-class-and-properties.md)
+# [ユーザー フィルター例外ハンドラーの使用](using-user-filtered-exception-handlers.md)
+# [方法 : 例外を明示的にスローする](how-to-explicitly-throw-exceptions.md)
+# [方法 : finally ブロックを使用する](how-to-use-finally-blocks.md)
+# [方法 : ユーザー定義の例外を作成する](how-to-create-user-defined-exceptions.md)
+# [方法 : catch ブロックで特定の例外を使用する](how-to-use-specific-exceptions-in-a-catch-block.md)
diff --git a/docs/standard/exceptions/best-practices-for-exceptions.md b/docs/standard/exceptions/best-practices-for-exceptions.md
new file mode 100644
index 00000000000..a3292418d95
--- /dev/null
+++ b/docs/standard/exceptions/best-practices-for-exceptions.md
@@ -0,0 +1,113 @@
+---
+title: "例外の推奨事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外, 推奨される手順"
+ms.assetid: f06da765-235b-427a-bfb6-47cd219af539
+caps.latest.revision: 28
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 28
+---
+# 例外の推奨事項
+適切にデザインされたアプリケーションは、アプリケーションのクラッシュを防ぐために、例外やエラーを処理します。  ここでは、例外の処理と作成のためのベスト プラクティスについて説明します。  
+  
+## 例外処理  
+ 次の一覧に、アプリケーションで例外を処理するための一般的なガイドラインを示します。  
+  
+-   例外処理コード \(`try`\/`catch` ブロック\) を適切に使用します。  例外処理を実行せずに、発生する可能性のあるエラーの条件をプログラムによってチェックすることもできます。  
+  
+     **プログラムによるチェック**。  接続が閉じているかどうかをチェックする `if` ステートメントを次のコード例に示します。  閉じていない場合、コード例は例外をスローせずに接続を閉じます。  
+  
+     [!code-cpp[Conceptual.Exception.Handling#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.exception.handling/cpp/source.cpp#2)]
+     [!code-csharp[Conceptual.Exception.Handling#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.exception.handling/cs/source.cs#2)]
+     [!code-vb[Conceptual.Exception.Handling#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.exception.handling/vb/source.vb#2)]  
+  
+     **例外処理**。  次の例は、`try`\/`catch` ブロックを使用して接続を確認し、接続が閉じられていない場合は例外をスローします。  
+  
+     [!code-cpp[Conceptual.Exception.Handling#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.exception.handling/cpp/source.cpp#3)]
+     [!code-csharp[Conceptual.Exception.Handling#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.exception.handling/cs/source.cs#3)]
+     [!code-vb[Conceptual.Exception.Handling#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.exception.handling/vb/source.vb#3)]  
+  
+     例外処理を使用するかどうかは、予期されるイベント発生頻度によって決まります。  
+  
+    -   イベントが頻繁には発生しない場合、つまり、イベントが本当に例外的であり、エラー \(予期しないファイルの終端の検出など\) を示す場合に、例外処理を使用します。  例外処理を使用すると、通常の状況では、実行されるコードが少なくなります。  
+  
+    -   イベントが頻繁に発生し、通常の実行の一部であると見なせる場合は、プログラムによってエラーをチェックする方法を使用します。  プログラムによってエラーをチェックすると、例外が発生した場合に、より多くのコードが実行されます。  
+  
+-   例外が発生する可能性のあるコードの前後に `try`\/`catch` ブロックを配置し、必要に応じて `finally` ブロックを使用してリソースをクリーンアップします。  このように配置することで、`try` ステートメントで例外が発生すると、`catch` ステートメントが例外を処理し、`finally` ステートメントは例外の発生の有無にかかわらずリソースを閉じるかまたは解放します。  
+  
+-   `catch` ブロックでは、常に特定の例外から一般的な例外の順に例外を配置します。  この手法により、まず特定の例外が処理され、次にこの例外がより一般的な `catch` ブロックに渡されます。  
+  
+## 例外の作成と発生  
+ 次の一覧では、独自の例外の作成と、それをいつ発生させるかについてのガイドラインを示します。  詳細については、「[例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)」を参照してください。  
+  
+-   通常の使用状態では例外が返されないようにクラスをデザインします。  たとえば、<xref:System.IO.FileStream> クラスには、ファイルの終端に到達したかどうかを判別するために役立つメソッドが用意されています。  これにより、ファイルの終端を越えて読み取りを実行しようとした場合にも例外がスローされません。  ファイルの終端の読み取り方法を示すコード例を次に示します。  
+  
+     [!code-cpp[Conceptual.Exception.Handling#5](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.exception.handling/cpp/source.cpp#5)]
+     [!code-csharp[Conceptual.Exception.Handling#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.exception.handling/cs/source.cs#5)]
+     [!code-vb[Conceptual.Exception.Handling#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.exception.handling/vb/source.vb#5)]  
+  
+-   エラー コードや HRESULT を返す代わりに、例外をスローします。  
+  
+-   非常に一般的なエラーの場合は、例外をスローする代わりに null を返します。  非常に一般的なエラーは、通常の制御の流れと見なすことができます。  このような場合は、null を返すことによって、アプリケーションのパフォーマンスへの影響を最小限に抑えることができます。  
+  
+-   ほとんどの場合、事前に定義されている .NET Framework 例外タイプを使用します。  事前定義の例外クラスが適用されない場合に限り、新しい例外クラスを導入します。  
+  
+-   オブジェクトの現在の状態に対して、プロパティの設定またはメソッドの呼び出しが適切でない場合は、<xref:System.InvalidOperationException> をスローします。  
+  
+-   無効なパラメーターが渡された場合は、<xref:System.ArgumentException> 例外または <xref:System.ArgumentException> の派生クラスをスローします。  
+  
+-   ほとんどのアプリでは、<xref:System.Exception> クラスからカスタム例外を派生します。  <xref:System.ApplicationException> クラスからの派生によって大きな価値が付加されることはありません。  
+  
+-   例外クラス名の終わりに "Exception" という単語を付けてください。  次に例を示します。  
+  
+     [!code-cpp[Conceptual.Exception.Handling#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.exception.handling/cpp/source.cpp#4)]
+     [!code-csharp[Conceptual.Exception.Handling#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.exception.handling/cs/source.cs#4)]
+     [!code-vb[Conceptual.Exception.Handling#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.exception.handling/vb/source.vb#4)]  
+  
+-   C\# および C\+\+ では、独自の例外クラスを作成するときに、少なくとも 3 つの共通コンストラクターを使用します。それらは、既定のコンストラクター、文字列メッセージを受け取るコンストラクター、および文字列メッセージと内部例外を受け取るコンストラクターです。  例については、「[方法 : ユーザー定義の例外を作成する](../../../docs/standard/exceptions/how-to-create-user-defined-exceptions.md)」を参照してください。  
+  
+    1.  既定の値を使用する <xref:System.Exception.%23ctor>。  
+  
+    2.  文字列メッセージを受け取る <xref:System.Exception.%23ctor%28System.String%29>。  
+  
+    3.  文字列メッセージと内部例外を受け取る <xref:System.Exception.%23ctor%28System.String%2CSystem.Exception%29>。  
+  
+-   ユーザー定義例外を作成するときには例外のメタデータを使用できるようにしてください。アプリ ドメイン間で例外が発生した場合や、リモート処理で必要となります。  たとえば、アプリ ドメイン A によってアプリ ドメイン B が作成され、このドメイン B で例外をスローするコードが実行されるとします。  アプリ ドメイン A で例外を適切にキャッチして処理するには、ドメイン A が、アプリ ドメイン B によりスローされた例外が格納されているアセンブリを検出できる必要があります。  アプリ ドメイン B がスローした例外が、ドメイン A のアプリケーション ベースではなくドメイン B のアプリケーション ベースにあるアセンブリに格納されている場合、ドメイン A は例外を検出できないため、共通言語ランタイムが <xref:System.IO.FileNotFoundException> 例外をスローします。  このような状況を回避するには、例外情報が格納されているアセンブリを次のいずれかの方法で配置します。  
+  
+    -   2 つのアプリ ドメインが共有する共通アプリケーション ベースにアセンブリを配置する。  
+  
+         または  
+  
+    -   ドメインが共通アプリケーション ベースを共有していない場合には、例外情報が格納されているアセンブリに厳密な名前で署名し、グローバル アセンブリ キャッシュにこのアセンブリを配置する。  
+  
+-   すべての例外に、ローカライズした説明文字列を含めます。  ユーザーに対して表示されるエラー メッセージは、例外クラスではなく、スローされた例外の説明文字列から派生されます。  
+  
+-   文法的に正しいエラー メッセージを使用します。句点も含めてください。  例外の説明文字列の文の末尾には、必ず句点を使用します。  たとえば、"ログ テーブルがオーバーフローしました。" は、適切な説明文字列です。  
+  
+-   プログラムからアクセスできるように、<xref:System.Exception> のプロパティを設定します。  プログラミングの点で追加情報が役立つ場合にだけ、\(説明文字列以外の\) 例外の追加プロパティを含めてください。  たとえば、<xref:System.IO.FileNotFoundException> には <xref:System.IO.FileNotFoundException.FileName%2A> プロパティがあります。  
+  
+-   例外がスローされたステートメントからスタック トレースが開始され、例外をキャッチした `catch` ステートメントでトレースが終了します。  `throw` ステートメントを配置する位置を決定するときには、このことに注意してください。  
+  
+-   例外ビルダー メソッドを使用します。  一般に、クラスはクラス実装内の複数の位置で同一の例外をスローします。  コードが長くなることを防ぐため、例外を作成して返すヘルパー メソッドを使用します。  次に例を示します。  
+  
+     [!code-cpp[Conceptual.Exception.Handling#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.exception.handling/cpp/source.cpp#6)]
+     [!code-csharp[Conceptual.Exception.Handling#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.exception.handling/cs/source.cs#6)]
+     [!code-vb[Conceptual.Exception.Handling#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.exception.handling/vb/source.vb#6)]  
+  
+     例外のコンストラクターを使用して例外を作成することもできます。  この方法は、<xref:System.ArgumentException> などのグローバル例外クラスに適しています。  
+  
+-   例外をスローするときに、中間結果を削除します。  呼び出し元が、メソッドから例外がスローされるときに副作用が発生しないと仮定できる必要があります。  
+  
+## 参照  
+ [例外](../../../docs/standard/exceptions/index.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/exception-class-and-properties.md b/docs/standard/exceptions/exception-class-and-properties.md
new file mode 100644
index 00000000000..978285391c9
--- /dev/null
+++ b/docs/standard/exceptions/exception-class-and-properties.md
@@ -0,0 +1,57 @@
+---
+title: "Exception クラスとプロパティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外クラス"
+  - "例外, 例外クラス"
+ms.assetid: e2e1f8c4-e7b4-467d-9a66-13c90861221d
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# Exception クラスとプロパティ
+<xref:System.Exception> クラスは、例外の継承元である基本クラスです。  ほとんどの例外オブジェクトは、**Exception** の派生クラスのインスタンスです。ただし、<xref:System.Object> クラスから派生したオブジェクトも例外としてスローできます。  一部の言語では、**Exception** の派生オブジェクト以外のオブジェクトのスロー操作とキャッチ操作がサポートされていません。  ほとんどの場合には、**Exception** オブジェクトだけをスローおよびキャッチすることをお勧めします。  
+  
+ **Exception** クラスには、例外を理解するときに役立つプロパティがいくつかあります。  このようなプロパティを次に示します。  
+  
+-   <xref:System.Exception.StackTrace%2A> プロパティ。  
+  
+     このプロパティにはスタック トレースが格納されています。エラーが発生した位置を判別するときに、このスタック トレースを使用できます。  デバッグ情報が使用できる場合には、スタック トレースにソース ファイル名とプログラム行番号が記述されます。  
+  
+-   <xref:System.Exception.InnerException%2A> プロパティ。  
+  
+     このプロパティによって、例外処理中に一連の例外が作成および保持されます。  また、既にキャッチされた例外を格納する新しい例外を作成するときにもこのプロパティを使用できます。  最初に発生した例外を、**InnerException** プロパティで作成された 2 番目の例外によって捕捉できるため、2 番目の例外を処理するコードが追加情報をチェックできます。  
+  
+     たとえば、ファイルを読み込み、データの書式を設定するメソッドがあるとします。  このメソッドのコードがファイルを読み込もうとしたときに、FileException がスローされたとします。  メソッドは FileException をキャッチし、BadFormatException をスローします。  この場合は、FileException を BadFormatException の **InnerException** プロパティに保存できます。  
+  
+     例外がスローされた原因を判別する呼び出し元の判別機能を向上させるには、ヘルパー ルーチンがスローした例外をキャッチしてから発生したエラーを詳しく示す例外をスローするメソッドを使用します。  エラーを詳しく示す例外を新規に作成して、最初に発生した例外に対して内部例外参照を設定できます。  次に、このエラーを詳しく示す例外を呼び出し元にスローできます。  この機能により、最初にスローされた例外で終了する、一連のリンクされた例外を作成できます。  
+  
+-   <xref:System.Exception.Message%2A> プロパティ。  
+  
+     このプロパティは、例外の原因に関する詳細情報を提供します。  **Message** は、例外をスローしたスレッドの <xref:System.Threading.Thread.CurrentUICulture%2A?displayProperty=fullName> プロパティで指定された言語で表示されます。  
+  
+-   <xref:System.Exception.HelpLink%2A> プロパティ。  
+  
+     このプロパティは、例外の原因に関する詳細情報が記述されたヘルプ ファイルの URL \(または URN\) を保持します。  
+  
+-   <xref:System.Exception.Data%2A> プロパティ  
+  
+     このプロパティは、キーと値のペア内に任意のデータを保持できる IDictionary です。  
+  
+ **Exception** の継承クラスのほとんどは **Exception** を継承するだけであり、追加メンバーを実装せず、追加機能も提供しません。  したがって、例外に関する最も重要な情報は、例外の階層、例外名、および例外に格納されている情報から得られます。  
+  
+## 参照  
+ [例外階層](../../../docs/standard/exceptions/exception-hierarchy.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)   
+ [例外の推奨事項](../../../docs/standard/exceptions/best-practices-for-exceptions.md)   
+ [例外](../../../docs/standard/exceptions/index.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/exception-handling-fundamentals.md b/docs/standard/exceptions/exception-handling-fundamentals.md
new file mode 100644
index 00000000000..84ded44bd59
--- /dev/null
+++ b/docs/standard/exceptions/exception-handling-fundamentals.md
@@ -0,0 +1,52 @@
+---
+title: "例外処理の基本事項 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "共通言語ランタイム, 例外"
+  - "例外, 例"
+  - "ランタイム, 例外"
+ms.assetid: e865d48c-b862-4448-833e-09fcd48adf6b
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 例外処理の基本事項
+共通言語ランタイムは、例外オブジェクトとプロテクト ブロック コードの概念に基づいた例外処理モデルをサポートしています。  例外が発生すると、その例外を表すオブジェクトがランタイムによって作成されます。  独自の例外クラスを作成するには、適切な基本例外の派生クラスを使用します。  
+  
+ ランタイムを使用するすべての言語で、例外は類似した方法で処理されます。  各言語で、try、catch、finally の各ブロックを使用した構造化例外処理が使用されます。  このセクションでは、基本的な例外処理のいくつかの例を示して説明します。  
+  
+## このセクションの内容  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)  
+ try ブロックと catch ブロックを使用して例外を処理する方法について説明します。  
+  
+ [方法 : catch ブロックで特定の例外を使用する](../../../docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md)  
+ 特定の例外をキャッチする方法について説明します。  
+  
+ [方法 : 例外を明示的にスローする](../../../docs/standard/exceptions/how-to-explicitly-throw-exceptions.md)  
+ 例外をスローする方法と、例外をキャッチして再びスローする方法について説明します。  
+  
+ [方法 : ユーザー定義の例外を作成する](../../../docs/standard/exceptions/how-to-create-user-defined-exceptions.md)  
+ 独自の例外クラスを作成する方法について説明します。  
+  
+ [ユーザー フィルター ハンドラーの使用](../../../docs/standard/exceptions/using-user-filtered-exception-handlers.md)  
+ フィルター例外を設定する方法について説明します。  
+  
+ [方法 : finally ブロックを使用する](../../../docs/standard/exceptions/how-to-use-finally-blocks.md)  
+ 例外ブロックでの finally ステートメントの使用方法について説明します。  
+  
+## 関連項目  
+ [例外](../../../docs/standard/exceptions/index.md)  
+ 共通言語ランタイムの例外を概説します。  
+  
+ [Exception クラスとプロパティ](../../../docs/standard/exceptions/exception-class-and-properties.md)  
+ 例外オブジェクトの要素について説明します。
\ No newline at end of file
diff --git a/docs/standard/exceptions/exception-hierarchy.md b/docs/standard/exceptions/exception-hierarchy.md
new file mode 100644
index 00000000000..cb635642e73
--- /dev/null
+++ b/docs/standard/exceptions/exception-hierarchy.md
@@ -0,0 +1,64 @@
+---
+title: "例外階層 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外の種類"
+  - "ランタイム例外"
+  - "基本例外"
+  - "ApplicationException クラス"
+  - "共通言語ランタイム例外"
+  - "COM 相互運用, 例外"
+  - "例外階層"
+ms.assetid: f7d68675-be06-40fb-a555-05f0c5a6f66b
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 例外階層
+例外は、実行中のプログラムによって生成される例外と、共通言語ランタイムによって生成される例外の&2; 種類に分類されます。 さらに、アプリケーションまたはランタイムによってスロー可能な例外の階層もあります。  
+  
+ <xref:System.Exception?displayProperty=fullName>クラスは、例外の基底クラスです。 いくつかの例外クラスから直接継承<xref:System.Exception>も含め、 <xref:System.ApplicationException>と<xref:System.SystemException>します。 これらの&2; つのクラスがほぼすべてのランタイム例外の基礎を成しています。  
+  
+ ほとんどの例外から直接派生した<xref:System.Exception>ない機能、および新しいメンバーを追加します。 たとえば、 <xref:System.InvalidCastException>クラスの階層構造を次に示します。  
+  
+ <xref:System.Object><xref:System.Exception> <xref:System.SystemException> <xref:System.InvalidCastException>  
+  
+ ランタイムの適切な派生クラスをスローする<xref:System.SystemException>エラーが発生したとき。 このようなエラーは、実行時チェックのエラー (配列範囲外エラーなど) が原因で発生します。また、任意のメソッドの実行中に発生することがあります。 新しい例外を作成するアプリケーションをデザインする場合からそれらの例外を派生する必要があります、<xref:System.Exception>クラスです。 キャッチすることはお勧めできません、 <xref:System.SystemException>でもなく、プログラミングをスローすることをお勧め、 <xref:System.SystemException>アプリケーションにします。  
+  
+ 最も重大な例外、または回復不可能な状態で、ランタイムによってスローされた — を含める<xref:System.ExecutionEngineException>、 <xref:System.StackOverflowException>と<xref:System.OutOfMemoryException>します。  
+  
+ 相互運用の例外の派生元<xref:System.SystemException>によってさらに拡張および<xref:System.Runtime.InteropServices.ExternalException>します。 たとえば、 <xref:System.Runtime.InteropServices.COMException> COM 相互運用機能の操作中にスローされる例外は、その派生元で<xref:System.Runtime.InteropServices.ExternalException>します。 <xref:System.ComponentModel.Win32Exception>と<xref:System.Runtime.InteropServices.SEHException>からも派生<xref:System.Runtime.InteropServices.ExternalException>します。  
+  
+## <a name="hierarchy-of-runtime-exceptions"></a>ランタイム例外の階層  
+ ランタイムに起因する例外の基本セット<xref:System.SystemException>個々 の命令を実行するときにそれをスローします。 次の表に、ランタイムから提供される標準例外と、派生クラスを作成する場合の条件を階層の順番に示します。  
+  
+|例外の種類|基本型|説明|例|  
+|--------------------|---------------|-----------------|-------------|  
+|[例外](../../../docs/standard/exceptions/exception-class-and-properties.md)|<xref:System.Object>|すべての例外の基底クラスです。|なし (この例外の派生クラスを使用)。|  
+|<xref:System.SystemException>|<xref:System.Exception>|ランタイムで生成されるすべてのエラーの基底クラスです。|なし (この例外の派生クラスを使用)。|  
+|<xref:System.IndexOutOfRangeException>|<xref:System.SystemException>|配列のインデックスが誤っている場合にのみ、ランタイムによってスローされます。|次のように、配列に対して配列の有効範囲外のインデックスを付けた場合。<br /><br /> `var i = arr[arr.Length + 1];`<br /><br /> `Dim i = arr(arr.Length + 1)`|  
+|<xref:System.NullReferenceException>|<xref:System.SystemException>|null オブジェクトが参照された場合にのみ、ランタイムによってスローされます。|`object o = null; string s = o.ToString();`<br /><br /> `Dim o As Object = Nothing Dim s As String = o.ToString()`|  
+|<xref:System.AccessViolationException>|<xref:System.SystemException>|無効なメモリがアクセスされた場合にのみ、ランタイムによってスローされます。|アンマネージ コードまたは安全でないマネージ コードと相互運用されていて、無効なポインターが使用された場合に発生します。|  
+|<xref:System.InvalidOperationException>|<xref:System.SystemException>|無効な状態の場合にメソッドによってスローされます。|列挙子の呼び出し`GetNext`基になるコレクションから項目を削除した後のメソッドです。|  
+|<xref:System.ArgumentException>|<xref:System.SystemException>|すべての引数の例外の基底クラスです。|なし (この例外の派生クラスを使用)。|  
+|<xref:System.ArgumentNullException>|<xref:System.ArgumentException>|null の引数を許可しないメソッドによってスローされます。|`String s = null; int i = "Calculate".IndexOf(s);`<br /><br /> `Dim s As String = Nothing Dim i As Integer = "Calculate".IndexOf(s)`|  
+|<xref:System.ArgumentOutOfRangeException>|<xref:System.ArgumentException>|引数が特定の範囲内にあることを検査するメソッドによってスローされます。|`String s = "string"; s = s.Substring(s.Length + 1);`<br /><br /> `Dim s As String = "string" s = s.Substring(s.Length + 1)`|  
+|<xref:System.Runtime.InteropServices.ExternalException>|<xref:System.SystemException>|ランタイム外部の環境で発生した例外、およびランタイム外部の環境で対象とされる例外の基底クラスです。|なし (この例外の派生クラスを使用)。|  
+|<xref:System.Runtime.InteropServices.COMException>|<xref:System.Runtime.InteropServices.ExternalException>|COM HRESULT 情報をカプセル化する例外です。|COM 相互運用機能で使用されます。|  
+|<xref:System.Runtime.InteropServices.SEHException>|<xref:System.Runtime.InteropServices.ExternalException>|Win32 構造化例外処理情報をカプセル化する例外です。|アンマネージ コード相互運用機能で使用されます。|  
+  
+## <a name="see-also"></a>関連項目  
+ [Exception クラスとプロパティ](../../../docs/standard/exceptions/exception-class-and-properties.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)   
+ [例外の推奨事項](../../../docs/standard/exceptions/best-practices-for-exceptions.md)   
+ [例外](../../../docs/standard/exceptions/index.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/handling-com-interop-exceptions.md b/docs/standard/exceptions/handling-com-interop-exceptions.md
new file mode 100644
index 00000000000..c5626195550
--- /dev/null
+++ b/docs/standard/exceptions/handling-com-interop-exceptions.md
@@ -0,0 +1,38 @@
+---
+title: "COM 相互運用の例外の処理 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "error-reference"
+helpviewer_keywords: 
+  - "COM 相互運用機能, 例外"
+  - "例外, COM 相互運用機能"
+  - "例外, アンマネージ コード"
+  - "HRESULT"
+  - "アンマネージ コード, 例外"
+ms.assetid: e6104aa8-8e5f-4069-b864-def85579c96c
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# COM 相互運用の例外の処理
+マネージ コードとアンマネージ コードは、例外を処理するために一緒に操作できます。  マネージ コードでメソッドが例外をスローすると、共通言語ランタイムは、HRESULT を COM オブジェクトに渡すことができます。  アンマネージ コードでメソッドが失敗して、失敗を示す HRESULT を返した場合、ランタイムはマネージ コードでキャッチできる例外をスローします。  
+  
+ ランタイムは、HRESULT を COM 相互運用からの自動的にマップして、より詳細な例外を取得します。  たとえば、E\_ACCESSDENIED は <xref:System.UnauthorizedAccessException> になり、E\_OUTOFMEMORY は <xref:System.OutOfMemoryException> になるなどです。  
+  
+ HRESULT がカスタムの結果であるか、またはランタイムで不明な場合は、ランタイムがジェネリック <xref:System.Runtime.InteropServices.COMException> をクライアントに渡します。  **COMException** の **ErrorCode** プロパティには、HRESULT 値が含まれます。  
+  
+## IErrorInfo の処理  
+ エラーが COM からマネージ コードに渡された場合、ランタイムは例外オブジェクトにエラー情報を入れます。  IErrorInfo をサポートして HRESULT を返す COM オブジェクトは、この情報をマネージ コードの例外に提供します。  たとえば、ランタイムは、COM エラーからの説明を例外の <xref:System.Exception.Message%2A> プロパティにマップします。  HRESULT が追加のエラー情報を提供しない場合、ランタイムは例外のプロパティの多くに既定値を指定します。  
+  
+ アンマネージ コードでメソッドが失敗した場合、例外をマネージ コードのセグメントに渡すことができます。  「[HRESULT と例外](../../../docs/framework/interop/how-to-map-hresults-and-exceptions.md)」のトピックには、HRESULT がランタイム例外オブジェクトにマップする方法を示す表が含まれています。  
+  
+## 参照  
+ [例外](../../../docs/standard/exceptions/index.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/how-to-create-user-defined-exceptions.md b/docs/standard/exceptions/how-to-create-user-defined-exceptions.md
new file mode 100644
index 00000000000..986517d7a82
--- /dev/null
+++ b/docs/standard/exceptions/how-to-create-user-defined-exceptions.md
@@ -0,0 +1,42 @@
+---
+title: "方法 : ユーザー定義の例外を作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外, 例"
+  - "例外, ユーザー定義"
+  - "ユーザー定義例外"
+ms.assetid: 25819a5a-f915-4fc8-b924-a76915674e04
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : ユーザー定義の例外を作成する
+ユーザーがプログラムによってエラー条件を識別できるようにする場合は、独自のユーザー定義例外を作成できます。  .NET Framework には、<xref:System.Exception> 基本クラスから最終的に派生した例外クラスの階層があります。  各クラスによって特定の例外が定義されているため、多くの場合は例外を作成する必要はありません。  <xref:System.Exception> クラスの派生クラスを独自の例外クラスとして作成することもできます。  
+  
+ 独自の例外を作成するときには、ユーザー定義例外のクラス名の終わりに "Exception" という単語を付けておくと、コーディングの点で便利です。また、推奨される 3 つの共通コンストラクターを実装すると便利です。この推奨コンストラクターを実装する例を次に示します。  
+  
+> [!NOTE]
+>  リモート処理機能を使用する場合には、サーバー \(呼び出される側\) とクライアント \(プロキシ オブジェクトまたは呼び出し元\) がユーザー定義例外のメタデータを使用できるようにしてください。  たとえば、別のアプリケーション ドメインのメソッドを呼び出すコードは、リモート呼び出しによってスローされる例外が含まれているアセンブリを検出できる必要があります。  詳細については、「[例外処理の実施](../../../docs/standard/exceptions/best-practices-for-exceptions.md)」を参照してください。  
+  
+ 次の例では、新しい例外クラス `EmployeeListNotFoundException` は <xref:System.Exception> から派生しています。  3 つのコンストラクターはクラスで定義されていて、それぞれ異なるパラメーターを使用します。  
+  
+## 使用例  
+ [!code-cpp[dg_exceptionDesign#14](../../../samples/snippets/cpp/VS_Snippets_CLR/dg_exceptionDesign/cpp/example2.cpp#14)]
+ [!code-csharp[dg_exceptionDesign#14](../../../samples/snippets/csharp/VS_Snippets_CLR/dg_exceptionDesign/cs/example2.cs#14)]
+ [!code-vb[dg_exceptionDesign#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/dg_exceptionDesign/vb/example2.vb#14)]  
+  
+## 参照  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)   
+ [方法 : catch ブロックで特定の例外を使用する](../../../docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md)   
+ [例外の推奨事項](../../../docs/standard/exceptions/best-practices-for-exceptions.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/how-to-explicitly-throw-exceptions.md b/docs/standard/exceptions/how-to-explicitly-throw-exceptions.md
new file mode 100644
index 00000000000..76d12ed9e17
--- /dev/null
+++ b/docs/standard/exceptions/how-to-explicitly-throw-exceptions.md
@@ -0,0 +1,38 @@
+---
+title: "方法 : 例外を明示的にスローする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外, スロー"
+  - "例外, try/catch ブロック"
+  - "FileNotFoundException クラス"
+  - "暗黙のスロー (例外の)"
+  - "try/catch ブロック"
+ms.assetid: 72bdd157-caa9-4478-9ee3-cb4500b84528
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : 例外を明示的にスローする
+例外を明示的にスローするには、`throw` ステートメントを使用します。  キャッチした例外を再びスローするときにも、`throw` ステートメントを使用します。  実際のコードでは、デバッグ時に詳細情報を提供するために、再スローする例外に情報を追加すると便利です。  
+  
+ try ブロックと catch ブロックを使用して、発生する可能性のある <xref:System.IO.FileNotFoundException> をキャッチするコード例を次に示します。  try ブロックの後に続く catch ブロックは、データ ファイルが見つからない場合に <xref:System.IO.FileNotFoundException> をキャッチして、メッセージをコンソールに出力します。  その後の throw ステートメントでは、新しい <xref:System.IO.FileNotFoundException> をスローし、この例外にテキスト情報を追加します。  
+  
+## 使用例  
+ [!code-csharp[Exception.Throwing#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Exception.Throwing/CS/throw.cs#1)]
+ [!code-vb[Exception.Throwing#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Exception.Throwing/VB/throw.vb#1)]  
+  
+## 参照  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)   
+ [方法 : catch ブロックで特定の例外を使用する](../../../docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md)   
+ [方法 : finally ブロックを使用する](../../../docs/standard/exceptions/how-to-use-finally-blocks.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/how-to-use-finally-blocks.md b/docs/standard/exceptions/how-to-use-finally-blocks.md
new file mode 100644
index 00000000000..44394a7f52c
--- /dev/null
+++ b/docs/standard/exceptions/how-to-use-finally-blocks.md
@@ -0,0 +1,39 @@
+---
+title: "方法 : finally ブロックを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ArgumentOutOfRangeException クラス"
+  - "例外, finally ブロック"
+  - "例外, try/catch ブロック"
+  - "finally ブロック"
+  - "try/catch ブロック"
+ms.assetid: 4b9c0137-04af-4468-91d1-b9014df8ddd2
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : finally ブロックを使用する
+例外が発生すると、処理が中止され、最も近い例外ハンドラーへ制御が渡されます。  このため、常に呼び出されるはずのコード行が実行されないことがよくあります。  例外がスローされても、ファイルのクローズなどの一部のリソース クリーンアップ処理は常に実行されます。  クリーンアップ処理を常に実行するには、finally ブロックを使用します。  例外がスローされたかどうかに関係なく、finally ブロックは常に実行されます。  
+  
+ try ブロックと catch ブロックを使用して <xref:System.ArgumentOutOfRangeException> をキャッチするコード例を次に示します。  `Main` メソッドは 2 つの配列を作成し、1 つの配列をもう 1 つの配列へコピーしようとします。  このコピー操作により **ArgumentOutOfRangeException** が生成されるため、コンソールへエラーが出力されます。  finally ブロックは、コピー操作の結果に関係なく実行されます。  
+  
+## 使用例  
+ [!code-cpp[CodeTryCatchFinallyExample#3](../../../samples/snippets/cpp/VS_Snippets_CLR/CodeTryCatchFinallyExample/CPP/source2.cpp#3)]
+ [!code-csharp[CodeTryCatchFinallyExample#3](../../../samples/snippets/csharp/VS_Snippets_CLR/CodeTryCatchFinallyExample/CS/source2.cs#3)]
+ [!code-vb[CodeTryCatchFinallyExample#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CodeTryCatchFinallyExample/VB/source2.vb#3)]  
+  
+## 参照  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)   
+ [方法 : 例外を明示的にスローする](../../../docs/standard/exceptions/how-to-explicitly-throw-exceptions.md)   
+ [方法 : ユーザー定義の例外を作成する](../../../docs/standard/exceptions/how-to-create-user-defined-exceptions.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md b/docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md
new file mode 100644
index 00000000000..465a0c7aef2
--- /dev/null
+++ b/docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md
@@ -0,0 +1,41 @@
+---
+title: "方法 : catch ブロックで特定の例外を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "catch ブロック"
+  - "例外, try/catch ブロック"
+  - "try/catch ブロック"
+ms.assetid: 12af9ff3-8587-4f31-90cf-6c2244e0fdae
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : catch ブロックで特定の例外を使用する
+発生した例外はスタックに渡され、いずれかの catch ブロックで処理されます。  catch ステートメントの順序は重要です。  一般例外の catch ブロックの前に、特定の例外を対象とした catch ブロックを配置します。このように配置しないと、コンパイラからエラーが発行される可能性があります。  適切な catch ブロックを判別するために、例外の種類と、catch ブロックに指定されている例外の名前が一致するかどうかが調べられます。  特定の catch ブロックが存在しないが、一般の catch ブロックが存在する場合には、一般の catch ブロックによって例外がキャッチされます。  
+  
+ try ブロックと catch ブロックを使用して <xref:System.InvalidCastException> をキャッチするコード例を次に示します。  このコード例では、従業員レベル \(`Emlevel`\) のプロパティだけを持つ `Employee` クラスが作成されます。  `PromoteEmployee` メソッドは、オブジェクトを受け取り、従業員レベルをインクリメントするメソッドです。  <xref:System.DateTime> インスタンスが `PromoteEmployee` メソッドに渡されると、**InvalidCastException** が発生します。  
+  
+## 使用例  
+ [!code-cpp[CatchException#2](../../../samples/snippets/cpp/VS_Snippets_CLR/CatchException/CPP/catchexception1.cpp#2)]
+ [!code-csharp[CatchException#2](../../../samples/snippets/csharp/VS_Snippets_CLR/CatchException/CS/catchexception1.cs#2)]
+ [!code-vb[CatchException#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CatchException/VB/catchexception1.vb#2)]  
+  
+ catch ブロックによってキャッチされなかった例外は、共通言語ランタイムによってキャッチされます。  ランタイムの構成に応じて、デバッグ ダイアログ ボックスが表示されるか、またはプログラムにより処理が停止されて例外情報のダイアログ ボックスが表示されます。  デバッグの詳細については、「[アプリケーションのデバッグとプロファイリング](../../../docs/framework/debug-trace-profile/index.md)」を参照してください。  
+  
+## 参照  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)   
+ [方法 : 例外を明示的にスローする](../../../docs/standard/exceptions/how-to-explicitly-throw-exceptions.md)   
+ [方法 : ユーザー定義の例外を作成する](../../../docs/standard/exceptions/how-to-create-user-defined-exceptions.md)   
+ [方法 : finally ブロックを使用する](../../../docs/standard/exceptions/how-to-use-finally-blocks.md)   
+ [Exception クラスとプロパティ](../../../docs/standard/exceptions/exception-class-and-properties.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)
\ No newline at end of file
diff --git a/docs/standard/exceptions/index.md b/docs/standard/exceptions/index.md
new file mode 100644
index 00000000000..a634246736a
--- /dev/null
+++ b/docs/standard/exceptions/index.md
@@ -0,0 +1,130 @@
+---
+title: "例外の処理とスロー | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "共通言語ランタイム, 例外"
+  - "エラー [.NET Framework], 例外"
+  - "例外 [.NET Framework]"
+  - "例外 [.NET Framework], 処理"
+  - "例外 [.NET Framework], スロー"
+  - "フィルター処理 (例外の)"
+  - "ランタイム, 例外"
+ms.assetid: f99a1d29-a2a8-47af-9707-9909f9010735
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 例外の処理とスロー
+<a name="top"></a> アプリケーションは、実行中に発生するエラーを一貫した方法で処理できなければなりません。 共通言語ランタイムは、一貫した方法でアプリケーションにエラーを通知するためのモデルを提供します。 .NET Framework のすべての操作は、例外をスローすることによってエラーを示します。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [.NET Framework における例外](#exceptions_in_the_net_framework)  
+  
+-   [例外:従来のエラー処理メソッド](#exceptions_vs_traditional_errorhandling_methods)  
+  
+-   [ランタイムが例外を管理する方法](#how_the_runtime_manages_exceptions)  
+  
+-   [ランタイム例外のフィルター処理](#filtering_runtime_exceptions)  
+  
+-   [関連トピック](#related_topics)  
+  
+-   [参照](#reference)  
+  
+<a name="exceptions_in_the_net_framework"></a>   
+## .NET Framework における例外  
+ 例外とは、プログラムを実行することによって発生するエラー状態または予期しない動作のことです。 例外が発生する原因として、コードまたは呼び出したコード \(たとえば共有ライブラリ\) 内に障害がある、オペレーティング システム リソースを使用できない、予期しない状態 \(たとえば検証できないコード\) を共通言語ランタイムが検出したなどがあります。 アプリケーションは、他の状態からではなく、これらの状態のうちのいくつかから回復できます。 ほとんどのアプリケーション例外から回復できますが、ほとんどのランタイム例外からは回復できません。  
+  
+ .NET Framework では、例外は <xref:System.Exception?displayProperty=fullName> クラスから継承されるオブジェクトです。 例外は問題が発生したコード領域からスローされます。 例外は、アプリケーションが処理するかプログラムが終了するまで、スタックに渡されます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="exceptions_vs_traditional_errorhandling_methods"></a>   
+## 例外:従来のエラー処理メソッド  
+ 言語のエラー処理モデルは従来、エラーを検出してそれに対応したハンドラーを見つける言語固有の方法か、オペレーティング システムが備えているエラー処理機構のいずれかを使用していました。 ランタイムは、次の機能を含んだ例外処理を実装します。  
+  
+-   例外を生成する言語または例外を処理する言語に関係なく、例外を処理します。  
+  
+-   例外を処理するための特定の言語構文を必要とせず、各言語が独自の構文を定義できます。  
+  
+-   プロセス間で、さらにはコンピューターの境界を越えて例外をスローできます。  
+  
+ 例外には、リターン コードなどの他のエラー通知メソッドに優る利点がいくつかあります。 エラーが通知されずに進行することがありません。 無効な値がシステムに伝わり続けることがありません。 リターン コードを確認する必要がありません。 プログラムの信頼性を高めるための例外処理コードを簡単に追加できます。 最後に、ランタイムの例外処理は、Windows ベースの C\+\+ エラーの処理よりも高速です。  
+  
+ 実行スレッドはコードのマネージ ブロックとアンマネージ ブロックを定期的にスキャンするので、ランタイムはマネージまたはアンマネージのどちらのコードでも例外をスローまたはキャッチできます。 アンマネージ コードには、C\+\+ スタイルの SEH 例外と COM ベースの HRESULT の両方を含めることができます。  
+  
+<a name="how_the_runtime_manages_exceptions"></a>   
+## ランタイムが例外を管理する方法  
+ ランタイムは、例外オブジェクトとコードの保護ブロックに基づいた例外処理モデルを使用します。 例外が発生すると、その例外を表す <xref:System.Exception> オブジェクトが作成されます。  
+  
+ ランタイムは、実行可能ファイルごとに例外情報テーブルを作成します。 実行可能ファイルの各メソッドには、例外情報テーブルで例外処理情報 \(空の場合がある\) の配列が関連付けられています。 配列内の各エントリは、コードの保護ブロック、そのコードに関連付けられた例外フィルター、例外ハンドラー \(`catch` ステートメント\) を示します。 この例外テーブルは非常に効率的なので、例外が発生していない場合にプロセッサ時間やメモリ使用のパフォーマンスが低下する原因にはなりません。 リソースを使用するのは、例外が発生したときだけです。  
+  
+ 例外情報テーブルは、保護ブロックに対応する 4 つのタイプの例外ハンドラーを表します。  
+  
+-   `finally` ハンドラー。ブロックが終了するときに必ず実行され、通常の制御フローによって発生するか、未処理の例外によって発生します。  
+  
+-   フォールト ハンドラー。例外が発生すると必ず実行されますが、通常の制御フローの完了時には実行されません。  
+  
+-   タイプ フィルター ハンドラー。指定したクラスまたはその派生クラスのすべての例外を処理します。  
+  
+-   ユーザー フィルター ハンドラー。ユーザー指定のコードを実行して、関連付けられたハンドラーで例外を処理するか、次の保護ブロックに例外を渡すかを判断します。  
+  
+ どの言語でも、その仕様に従ってこれらの例外ハンドラーを実装しています。 たとえば Visual Basic では、`catch` ステートメント内の変数比較 \(`When` キーワードを使用\) を通してユーザー フィルター ハンドラーにアクセスできます。一方 C\# では、ユーザー フィルター ハンドラーを実装していません。  
+  
+ 例外が発生すると、ランタイムは次の 2 段階プロセスを開始します。  
+  
+1.  ランタイムは、次のようにする最初の保護ブロックの配列を検索します。  
+  
+    -   現在実行中の命令が含まれている領域を保護する。  
+  
+    -   例外ハンドラーが含まれているか、例外を処理するフィルターが含まれている。  
+  
+2.  一致すると、ランタイムは例外を記述する <xref:System.Exception> オブジェクトを作成します。 ランタイムは次に、例外が発生したステートメントと例外を処理するステートメントの間のすべての `finally` またはフォールト ステートメントを実行します。 例外ハンドラーの順序は重要です。最も内側の例外ハンドラーが最初に評価されます。 例外ハンドラーは例外をキャッチするルーチンのローカル変数とローカル メモリにアクセスできるが、例外がスローされるときの中間値は失われるということにも注意してください。  
+  
+     現在のメソッドで一致しない場合、ランタイムは、現在のメソッドの各呼び出し元を検索し、スタックの最後までこのパスを続けます。 呼び出し元で一致しない場合、ランタイムはデバッガーに例外にアクセスさせます。 例外にデバッガーが付いていなければ、ランタイムは <xref:System.AppDomain.UnhandledException?displayProperty=fullName> イベントを発生させます。 このイベントのリスナーが存在しない場合、ランタイムはスタック トレースをダンプし、アプリケーションを終了します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="filtering_runtime_exceptions"></a>   
+## ランタイム例外のフィルター処理  
+ キャッチして処理する例外を、タイプでまたは何らかのユーザー定義条件でフィルター処理できます。  
+  
+ タイプ フィルター ハンドラーは、特定のタイプの例外 \(またはその派生クラス\) を管理します。 次の例は、特定の例外 \(この場合は <xref:System.IO.FileNotFoundException>\) をキャッチすることを意図して設計されたタイプ フィルター ハンドラーを示しています。  
+  
+ [!code-cpp[CatchException#5](../../../samples/snippets/cpp/VS_Snippets_CLR/CatchException/CPP/catchexception3.cpp#5)]
+ [!code-csharp[CatchException#5](../../../samples/snippets/csharp/VS_Snippets_CLR/CatchException/CS/catchexception3.cs#5)]
+ [!code-vb[CatchException#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CatchException/VB/catchexception3.vb#5)]  
+  
+ ユーザー フィルター例外ハンドラーは、ユーザーが例外に対して定義した要件に基づいて、例外をキャッチして処理します。 この方法による例外のフィルター処理の詳細については、「[キャッチ ブロックでの特定の例外の使用](../../../docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[Exception クラスとプロパティ](../../../docs/standard/exceptions/exception-class-and-properties.md)|例外オブジェクトの要素について説明します。|  
+|[例外階層](../../../docs/standard/exceptions/exception-hierarchy.md)|ほとんどの例外が派生する例外について説明します。|  
+|[例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)|キャッチ、スロー、最後にステートメントを使用して例外を処理する方法について説明します。|  
+|[例外の推奨事項](../../../docs/standard/exceptions/best-practices-for-exceptions.md)|例外を処理するための推奨方法について説明します。|  
+|[COM 相互運用の例外の処理](../../../docs/standard/exceptions/handling-com-interop-exceptions.md)|アンマネージ コードでスローおよびキャッチされた例外を処理する方法について説明します。|  
+|[方法: HRESULT に例外を割り当てる](../../../docs/framework/interop/how-to-map-hresults-and-exceptions.md)|マネージ コードとアンマネージ コード間の例外のマッピングについて説明します。|  
+  
+<a name="reference"></a>   
+## 参照  
+ <xref:System.Exception?displayProperty=fullName>  
+  
+ <xref:System.ApplicationException?displayProperty=fullName>  
+  
+ <xref:System.SystemException?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/exceptions/using-user-filtered-exception-handlers.md b/docs/standard/exceptions/using-user-filtered-exception-handlers.md
new file mode 100644
index 00000000000..61ecb0e1e0a
--- /dev/null
+++ b/docs/standard/exceptions/using-user-filtered-exception-handlers.md
@@ -0,0 +1,56 @@
+---
+title: "ユーザー フィルター例外ハンドラーの使用 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "例外, ユーザー フィルター"
+  - "ユーザー フィルター例外"
+ms.assetid: aa80d155-060d-41b4-a636-1ceb424afee8
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ユーザー フィルター例外ハンドラーの使用
+現在 Visual Basic では、ユーザー フィルター例外をサポートしています。  ユーザー フィルター例外ハンドラーは、独自に定義された例外の条件に基づいて例外をキャッチおよび処理します。  これらのハンドラーでは、**Catch** ステートメントを **When** キーワードと一緒に使用します。  
+  
+ 特定の例外オブジェクトが複数のエラーに対応するときにこの手法を使用すると便利です。  通常、このような例外オブジェクトには、エラーに関連付けられた特定のエラー コードが格納されているプロパティがあります。  **Catch** 句で処理する特定のエラーだけを選択するには、エラー コード プロパティを使用した式を作成します。  
+  
+ `When` キーワードが指定された **Catch** ステートメントを次の Visual Basic コード例に示します。  
+  
+```  
+Try  
+      'Try statements.  
+   Catch When Err = VBErr_ClassLoadException  
+      'Catch statements.  
+End Try  
+```  
+  
+ ユーザー フィルター句の式が制限されることはありません。  ユーザー フィルター式の実行中に例外が発生すると、その例外は破棄され、そのフィルター式は false と評価されたと見なされます。  この場合、共通言語ランタイムでは、現在の例外に対応するハンドラーの検索が継続されます。  
+  
+## 特定の例外とユーザー フィルター句の組み合わせ  
+ catch ステートメントには、特定の例外とユーザー フィルター句の両方を記述できます。  ランタイムでは、特定の例外が最初にテストされます。  特定の例外がテストを通過すると、次にユーザー フィルターが実行されます。  汎用フィルターには、クラス フィルターで宣言されている変数への参照を含めることができます。  2 つのフィルター句の順序は一定であり、変更できないことに注意してください。  
+  
+ `ClassLoadException` という例外が指定された **Catch** ステートメントと、**When** キーワードを使用したユーザー フィルター句の Visual Basic コード例を次に示します。  
+  
+```  
+Try  
+      'Try statements.  
+   Catch cle As ClassLoadException When cle.IsRecoverable()  
+      'Catch statements.  
+End Try  
+```  
+  
+## 参照  
+ [方法 : Try ブロックと Catch ブロックを使用して例外をキャッチする](../../../docs/standard/exceptions/how-to-use-the-try-catch-block-to-catch-exceptions.md)   
+ [方法 : catch ブロックで特定の例外を使用する](../../../docs/standard/exceptions/how-to-use-specific-exceptions-in-a-catch-block.md)   
+ [例外の推奨事項](../../../docs/standard/exceptions/best-practices-for-exceptions.md)   
+ [例外処理の基本事項](../../../docs/standard/exceptions/exception-handling-fundamentals.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/TOC.md b/docs/standard/garbage-collection/TOC.md
new file mode 100644
index 00000000000..9b8bc15f6b0
--- /dev/null
+++ b/docs/standard/garbage-collection/TOC.md
@@ -0,0 +1,13 @@
+# [Memory Management and Garbage Collection](memory-management-and-gc.md)
+# [Dispose メソッドの実装](implementing-dispose.md)
+# [Garbage Collection Notifications](notifications.md)
+# [Garbage Collection and Performance](performance.md)
+# [Optimization for Shared Web Hosting](optimization-for-shared-web-hosting.md)
+# [Cleaning Up Unmanaged Resources](unmanaged.md)
+# [Latency Modes](latency.md)
+# [Using Objects That Implement IDisposable](using-objects.md)
+# [Weak References](weak-references.md)
+# [Fundamentals of Garbage Collection](fundamentals.md)
+# [Application Domain Resource Monitoring](app-domain-resource-monitoring.md)
+# [Garbage Collection](index.md)
+# [発生したコレクション](induced.md)
diff --git a/docs/standard/garbage-collection/app-domain-resource-monitoring.md b/docs/standard/garbage-collection/app-domain-resource-monitoring.md
new file mode 100644
index 00000000000..9d7d5114c95
--- /dev/null
+++ b/docs/standard/garbage-collection/app-domain-resource-monitoring.md
@@ -0,0 +1,94 @@
+---
+title: "Application Domain Resource Monitoring | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "monitoring managed memory use by application domain"
+  - "application domains, memory use"
+  - "memory use, monitoring"
+  - "application domains, resource monitoring"
+ms.assetid: 318bedf8-7f35-4f00-b34a-2b7b8e3fa315
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Application Domain Resource Monitoring
+アプリケーション ドメインのリソース監視 \(ARM\) を使用すると、ホストでアプリケーション ドメインによる CPU とメモリの使用状況を監視できます。  これは、ASP.NET など、長時間実行されるプロセスで多数のアプリケーション ドメインを使用するホストで役立ちます。  プロセス全体のパフォーマンスに悪影響を及ぼしているアプリケーションのアプリケーション ドメインをホストでアンロードできます。ただし、問題となっているアプリケーションを特定できる場合に限ります。  ARM を使用することで、そのような判断の際に役立つ情報が提供されます。  
+  
+ たとえば、ホスティング サービスが ASP.NET サーバーで多数のアプリケーションを実行している場合があります。  プロセスの特定のアプリケーションによるメモリ使用量が多くなりすぎたり、プロセッサ時間が長くなりすぎたりした場合、ホスティング サービスで ARM を使用すると、問題の原因になっているアプリケーション ドメインを特定できます。  
+  
+ ARM は軽量のため、実行中のアプリケーションで問題なく使用できます。  情報を確認するときは、Windows イベント トレーシング \(ETW\) を使用するか、マネージ API またはネイティブ API から直接アクセスします。  
+  
+## リソース監視の有効化  
+ ARM を有効にする方法は 4 つあります。共通言語ランタイム \(CLR\) の起動時に構成ファイルを指定するか、アンマネージ ホスト API を使用するか、マネージ コードを使用するか、ARM ETW イベントをリッスンします。  
+  
+ ARM を有効にすると、プロセス内のアプリケーション ドメインに関するデータの収集がすぐに開始されます。  ARM を有効にする前にアプリケーション ドメインが作成されていた場合の累積データは、アプリケーション ドメインの作成時点ではなく、ARM を有効にした時点からの累積データです。ARM を有効にすると、後で無効にすることはできません。  
+  
+-   CLR の起動時に [\<appDomainResourceMonitoring\>](../../../docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md) 要素を構成ファイルに追加し、`true`へ `enabled` 属性を設定することで ARM を有効にすることができます。  値が `false` \(既定\) の場合、ARM が起動時には有効にならないだけで、他のアクティブ化方法を使用して後から有効にすることができます。  
+  
+-   ホストで ARM を有効にするには、[ICLRAppDomainResourceMonitor](../../../ocs/framework/unmanaged-api/hosting/iclrappdomainresourcemonitor-interface.md) ホスト インターフェイスを要求します。  このインターフェイスが正常に取得されると、ARM が有効になります。  
+  
+-   マネージ コードで ARM を有効にするには、static \(Visual Basic では `Shared`\) の <xref:System.AppDomain.MonitoringIsEnabled%2A?displayProperty=fullName> プロパティを `true` に設定します。  プロパティを設定すると、すぐに ARM が有効になります。  
+  
+-   起動後に ARM を有効にするには、ETW イベントをリッスンします。  `AppDomainResourceManagementKeyword` キーワードを使用してパブリック プロバイダー `Microsoft-Windows-DotNETRuntime` を有効にすると、ARM が有効になり、すべてのアプリケーション ドメインのイベントの生成が開始されます。  データをアプリケーション ドメインおよびスレッドと関連付けるには、さらに `ThreadingKeyword` キーワードを指定して `Microsoft-Windows-DotNETRuntimeRundown` プロバイダーを有効にする必要があります。  
+  
+## ARM の使用  
+ ARM を使用すると、アプリケーション ドメインによって使用されている合計プロセッサ時間と、メモリの使用状況に関する 3 種類の情報が得られます。  
+  
+-   **アプリケーション ドメインの合計プロセッサ時間 \(秒\)**: アプリケーション ドメインの有効期間中に実行に時間を費やしたすべてのスレッドについて、オペレーティング システムから報告されたスレッド時間を合計した時間です。  ブロック状態またはスリープ状態のスレッドはプロセッサ時間を消費しません。  ネイティブ コードを呼び出すスレッドの場合、スレッドがネイティブ コードで費やした時間は、呼び出しを行ったアプリケーション ドメインの時間に加算されます。  
+  
+    -   マネージ API: <xref:System.AppDomain.MonitoringTotalProcessorTime%2A?displayProperty=fullName> プロパティ。  
+  
+    -   ホスト API: [ICLRAppDomainResourceMonitor::GetCurrentCpuTime](../Topic/ICLRAppDomainResourceMonitor::GetCurrentCpuTime%20Method.md) メソッド。  
+  
+    -   ETW イベント: `ThreadCreated` イベント、`ThreadAppDomainEnter` イベント、および `ThreadTerminated` イベント。  プロバイダーおよびキーワードの詳細については、「[CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)」の「アプリケーション ドメインのリソース監視イベント」を参照してください。  
+  
+-   **有効期間中にアプリケーション ドメインによって行われたマネージ割り当ての合計 \(バイト\)**: 割り当てオブジェクトの有効期間が短い場合があるため、アプリケーション ドメインによるすべてのメモリ使用が、割り当ての合計に必ずしも反映されるとは限りません。  ただし、アプリケーションで大量のオブジェクトの割り当てや解放を行う場合、割り当てのコストが問題になる可能性があります。  
+  
+    -   マネージ API: <xref:System.AppDomain.MonitoringTotalAllocatedMemorySize%2A?displayProperty=fullName> プロパティ。  
+  
+    -   ホスト API: [ICLRAppDomainResourceMonitor::GetCurrentAllocated](../Topic/ICLRAppDomainResourceMonitor::GetCurrentAllocated%20Method.md) メソッド。  
+  
+    -   ETW イベント: `AppDomainMemAllocated` イベント、`Allocated` フィールド。  
+  
+-   **アプリケーション ドメインによって参照される、最後のフル ブロッキング コレクションで残ったマネージ メモリ \(バイト\)**: この数値は、フル ブロッキング コレクションの後にしか正確になりません \(対照的なのは同時実行コレクションです。同時実行コレクションはバックグラウンドで実行され、アプリケーションがブロックされません\)。フル ブロッキング コレクションは、たとえば <xref:System.GC.Collect?displayProperty=fullName> メソッド オーバーロードで実行されます。  
+  
+    -   マネージ API: <xref:System.AppDomain.MonitoringSurvivedMemorySize%2A?displayProperty=fullName> プロパティ。  
+  
+    -   ホスト API: [ICLRAppDomainResourceMonitor::GetCurrentSurvived](../Topic/ICLRAppDomainResourceMonitor::GetCurrentSurvived%20Method.md) メソッド、`pAppDomainBytesSurvived` パラメーター。  
+  
+    -   ETW イベント: `AppDomainMemSurvived` イベント、`Survived` フィールド。  
+  
+-   **プロセスよって参照される、最後のフル ブロッキング コレクションで残った合計マネージ メモリ \(バイト\)**: 個々のアプリケーション ドメインで残ったメモリをこの数値と比較できます。  
+  
+    -   マネージ API: <xref:System.AppDomain.MonitoringSurvivedProcessMemorySize%2A?displayProperty=fullName> プロパティ。  
+  
+    -   ホスト API: [ICLRAppDomainResourceMonitor::GetCurrentSurvived](../Topic/ICLRAppDomainResourceMonitor::GetCurrentSurvived%20Method.md) メソッド、`pTotalBytesSurvived` パラメーター。  
+  
+    -   ETW イベント: `AppDomainMemSurvived` イベント、`ProcessSurvived` フィールド。  
+  
+### フル ブロッキング コレクションがいつ実行されたか確認する  
+ 残ったメモリのカウントのうちどの時点のものが正確かを判断するには、フル ブロッキング コレクションがいつ発生したかを確認する必要があります。  そのための方法は、ARM の統計情報を調べるのに使用する API によって異なります。  
+  
+#### マネージ API  
+ <xref:System.AppDomain> クラスのプロパティを使用する場合は、<xref:System.GC.RegisterForFullGCNotification%2A?displayProperty=fullName> メソッドを使用してフル コレクションの通知を登録できます。  使用するしきい値は重要ではありません。コレクションが開始されるまでではなく、コレクションが完了するまで待機するからです。  その後、<xref:System.GC.WaitForFullGCComplete%2A?displayProperty=fullName> メソッドを呼び出して、フル コレクションが完了するまでブロックします。  ループでメソッドを呼び出し、メソッドから制御が戻るたびに必要な分析を実行するスレッドを作成できます。  
+  
+ また、<xref:System.GC.CollectionCount%2A?displayProperty=fullName> メソッドを定期的に呼び出して、ジェネレーション 2 のコレクションの数が増加していないかどうかを確認する方法もあります。  ただし、ポーリング間隔によっては、この手法ではフル コレクションの発生を正確に特定できない場合があります。  
+  
+#### ホスト API  
+ アンマネージ ホスト API を使用する場合は、ホストで CLR の [IHostGCManager](../../../ocs/framework/unmanaged-api/hosting/ihostgcmanager-interface.md) インターフェイスの実装を渡す必要があります。  この CLR は、コレクションの実行中に中断されたスレッドの実行を再開すると [IHostGCManager::SuspensionEnding](../Topic/IHostGCManager::SuspensionEnding%20Method.md) メソッドを呼び出します。  完了したコレクションのジェネレーションがメソッドのパラメーターとして CLR から渡されるため、そのコレクションがフル コレクションだったかどうかをホストで確認できます。  残ったメモリを [IHostGCManager::SuspensionEnding](../Topic/IHostGCManager::SuspensionEnding%20Method.md) メソッドの実装で照会すると、カウントが更新された後ですぐ取得できるようになります。  
+  
+## 参照  
+ <xref:System.AppDomain.MonitoringIsEnabled%2A?displayProperty=fullName>   
+ [ICLRAppDomainResourceMonitor インターフェイス](../../../ocs/framework/unmanaged-api/hosting/iclrappdomainresourcemonitor-interface.md)   
+ [\<appDomainResourceMonitoring\>](../../../docs/framework/configure-apps/file-schema/runtime/appdomainresourcemonitoring-element.md)   
+ [CLR ETW イベント](../../../docs/framework/performance/clr-etw-events.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/fundamentals.md b/docs/standard/garbage-collection/fundamentals.md
new file mode 100644
index 00000000000..669d51f1a99
--- /dev/null
+++ b/docs/standard/garbage-collection/fundamentals.md
@@ -0,0 +1,304 @@
+---
+title: "Fundamentals of Garbage Collection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "garbage collection, generations"
+  - "garbage collection, background garbage collection"
+  - "garbage collection, concurrent garbage collection"
+  - "garbage collection, server garbage collection"
+  - "garbage collection, workstation garbage collection"
+  - "garbage collection, managed heap"
+ms.assetid: 67c5a20d-1be1-4ea7-8a9a-92b0b08658d2
+caps.latest.revision: 51
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 51
+---
+# Fundamentals of Garbage Collection
+<a name="top"></a> 共通言語ランタイム \(CLR\) では、自動メモリ マネージャーとしてガベージ コレクターを使用できます。 次のような利点があります。  
+  
+-   アプリケーションを開発するときにメモリを解放する必要がありません。  
+  
+-   オブジェクトが効率的にマネージ ヒープに割り当てられます。  
+  
+-   使用されなくなったオブジェクトが解放され、メモリがクリアされてその後の割り当てに使用できるようになります。 マネージ オブジェクトは自動的にクリーンな内容で開始されるため、コンストラクターでデータ フィールドごとに初期化する必要はありません。  
+  
+-   オブジェクトで別のオブジェクトの内容を使用できなくすることで、メモリの安全が確保されます。  
+  
+ このトピックでは、ガベージ コレクションの主要な概念について説明します。 このチュートリアルは、次のセクションで構成されています。  
+  
+-   [メモリの基礎](#fundamentals_of_memory)  
+  
+-   [ガベージ コレクションの条件](#conditions_for_a_garbage_collection)  
+  
+-   [マネージ ヒープ](#the_managed_heap)  
+  
+-   [ジェネレーション](#generations)  
+  
+-   [ガベージ コレクションの実行時の動作](#what_happens_during_a_garbage_collection)  
+  
+-   [アンマネージ リソースの操作](#manipulating_unmanaged_resources)  
+  
+-   [ワークステーションとサーバーのガベージ コレクション](#workstation_and_server_garbage_collection)  
+  
+-   [同時実行ガベージ コレクション](#concurrent_garbage_collection)  
+  
+-   [バックグラウンド ワークステーション ガベージ コレクション](#background_garbage_collection)  
+  
+-   [バックグラウンド サーバー ガベージ コレクション](#background_server_garbage_collection)  
+  
+<a name="fundamentals_of_memory"></a>   
+## メモリの基礎  
+ CLR のメモリに関する重要な概念の概要を以下に示します。  
+  
+-   各プロセスは、分離された独自の仮想アドレス空間を持ちます。 同じコンピューターのすべてのプロセスが同じ物理メモリとページ ファイル \(存在する場合\) を共有します。  
+  
+-   32 ビット コンピューターでは、各プロセスが既定で 2 GB のユーザー モード仮想アドレス空間を持ちます。  
+  
+-   アプリケーション開発者が操作するのは仮想アドレス空間だけで、直接物理メモリを操作することはありません。 マネージ ヒープの仮想メモリの割り当てと解放はガベージ コレクターによって行われます。  
+  
+     ネイティブ コードを記述する場合は、Win32 関数を使用して仮想アドレス空間を操作します。 ネイティブ ヒープの仮想メモリの割り当てと解放はこれらの関数によって行われます。  
+  
+-   仮想メモリには次の 3 つの状態があります。  
+  
+    -   空き。 参照されていない、割り当てに使用できるメモリ ブロックです。  
+  
+    -   予約済み。 使用できるように確保された、他の割り当て要求には使用できないメモリ ブロックです。 ただし、このメモリ ブロックがコミットされるまではデータを格納できません。  
+  
+    -   コミット済み。 物理ストレージに割り当てられたメモリ ブロックです。  
+  
+-   仮想アドレス空間は、断片化することがあります。 断片化とは、アドレス空間に複数の空きブロック \(ホールとも呼ばれます\) がある状態です。 仮想メモリの割り当てが要求された場合、仮想メモリ マネージャーは、その割り当て要求を満たすのに十分な大きさの単一の空きブロックを見つけなければなりません。 2 GB の空き領域があっても、そのすべての領域が 1 つのアドレス ブロックにないと、2 GB の領域を必要とする割り当ては失敗します。  
+  
+-   メモリが足りなくなるのは、予約する仮想アドレス空間が足りなくなった場合か、コミットする物理領域が足りなくなった場合です。  
+  
+ ページ ファイルは、物理メモリの圧迫度 \(物理メモリに対する需要\) が低い場合にも使用されます。 最初に物理メモリの圧迫度が高まると、データを格納するための領域を確保するために物理メモリのデータの一部がページ ファイルにバックアップされますが、 そのデータは必要になるまでページングされないため、物理メモリの圧迫度が非常に低い状況でページングが発生する可能性もあります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="conditions_for_a_garbage_collection"></a>   
+## ガベージ コレクションの条件  
+ ガベージ コレクションは、次のいずれかの条件に当てはまる場合に発生します。  
+  
+-   システムの物理メモリが少ない場合。  
+  
+-   マネージ ヒープで割り当てられたオブジェクトによって使用されているメモリが、許容されるしきい値を超える場合。 このしきい値は、プロセスの進行に合わせて絶えず調整されます。  
+  
+-   <xref:System.GC.Collect%2A?displayProperty=fullName> メソッドが呼び出された場合。 ほとんどの場合、ガベージ コレクターは継続して実行されるため、このメソッドを呼び出す必要はありません。 このメソッドは、主に特別な状況やテストで使用されます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="the_managed_heap"></a>   
+## マネージ ヒープ  
+ ガベージ コレクターは、CLR によって初期化された後、オブジェクトを格納および管理するためのメモリのセグメントを割り当てます。 オペレーティング システムのネイティブ ヒープに対し、このメモリのことをマネージ ヒープと呼びます。  
+  
+ マネージ ヒープはマネージ プロセスごとに割り当てられます。 プロセス内のすべてのスレッドは、同じヒープにオブジェクト用のメモリを割り当てます。  
+  
+ メモリを予約するために、ガベージ コレクターは Win32 [VirtualAlloc](http://go.microsoft.com/fwlink/?LinkId=179047) 関数を呼び出し、マネージ アプリケーション用のメモリのセグメントを一度に 1 つずつ予約します。 また、ガベージ コレクターは、必要に応じてセグメントを予約したり、Win32 [VirtualFree](http://go.microsoft.com/fwlink/?LinkId=179050) 関数を呼び出すことで \(オブジェクトのセグメントをクリアしてから\) セグメントを解放してオペレーティング システムに戻したりします。  
+  
+> [!IMPORTANT]
+>  ガベージ コレクターによって割り当てらるセグメントのサイズは実装に固有であり、定期的な更新プログラムによる場合を含め、いつでも変更されることがあります。 アプリでは、セグメント サイズを推測することや、特定のセグメント サイズに依存することを絶対に避けてください。また、セグメントの割り当てに使用可能なメモリの量を構成しようとしてもなりません。  
+  
+ ヒープに割り当てられたオブジェクトが少ないほど、ガベージ コレクターの処理も少なくなります。 そのため、オブジェクトを割り当てるときに、必要な量より多く割り当てないようにしてください。たとえば、15 バイトしか必要がないときに 32 バイトの配列を割り当てないようにしてください。  
+  
+ ガベージ コレクションがトリガーされると、ガベージ コレクターは、使用されなくなったオブジェクトに占有されているメモリを解放します。 この解放プロセスでは、まとめて移動できるように有効なオブジェクトを圧縮し、使用されなくなったスペースを削除することで、ヒープを小さくします。 これにより、一緒に割り当てられたオブジェクトが同じマネージ ヒープにまとめられ、局所性が保持されます。  
+  
+ ガベージ コレクションの割り込みの動作 \(頻度と期間\) は、割り当てのボリュームとマネージ ヒープ上の残ったメモリの量によって決まります。  
+  
+ ヒープは、大きなオブジェクト ヒープと小さなオブジェクト ヒープの 2 つを累積したものと見なすことができます。  
+  
+ 大きなオブジェクト ヒープには、85,000 バイトを超える非常に大きなオブジェクトが格納されます。 大きなオブジェクト ヒープの中のオブジェクトは、通常は配列になります。 インスタンス オブジェクトが極端に大きくなることはほとんどありません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="generations"></a>   
+## ジェネレーション  
+ ヒープは、有効期間が長いオブジェクトと有効期間が短いオブジェクトに対処できるようにジェネレーションにまとめられます。 ガベージ コレクションは主に、通常はヒープのごく一部だけを占有する有効期間が短いオブジェクトを解放する場合に発生します。 ヒープのオブジェクトのジェネレーションには次の 3 つがあります。  
+  
+-   **ジェネレーション 0**。 これは一番最初のジェネレーションで、有効期間が短いオブジェクトが格納されます。 有効期間が短いオブジェクトには、たとえば、テンポラリ変数などがあります。 ガベージ コレクションは、このジェネレーションで最も頻繁に発生します。  
+  
+     オブジェクトが新しく割り当てられると、大きなオブジェクトの場合以外は、オブジェクトの新しいジェネレーションが形成されて暗黙的にジェネレーション 0 のコレクションになります。大きなオブジェクトの場合は、ジェネレーション 2 のコレクションの大きなオブジェクトのヒープに割り当てられます。  
+  
+     ジェネレーション 0 では、ほとんどのオブジェクトがガベージ コレクションで解放され、次のジェネレーションには残りません。  
+  
+-   **ジェネレーション 1**。 このジェネレーションには有効期間が短いオブジェクトが格納されます。有効期間が短いオブジェクトと有効期間が長いオブジェクトの間のバッファーとして機能します。  
+  
+-   **ジェネレーション 2**。 このジェネレーションには、有効期間が長いオブジェクトが格納されます。 有効期間が長いオブジェクトには、たとえば、プロセスの存続期間を通じて有効な静的データを含むサーバー アプリケーションのオブジェクトなどがあります。  
+  
+ ガベージ コレクションは、条件に応じて特定のジェネレーションで発生します。 ジェネレーションのコレクションでは、そのジェネレーションとそれよりも前のすべてのジェネレーションのオブジェクトがコレクションの対象になります。 ジェネレーション 2 のガベージ コレクションは、すべてのジェネレーションのすべてのオブジェクト \(つまり、マネージ ヒープのすべてのオブジェクト\) を解放することから、フル ガベージ コレクションとも呼ばれます。  
+  
+### 存続と昇格  
+ ガベージ コレクションで解放されなかったオブジェクトは残存オブジェクトと呼ばれ、次のジェネレーションに昇格されます。 ジェネレーション 0 のガベージ コレクションでごみではないと判断されたオブジェクトは、ジェネレーション 1 に昇格されます。ジェネレーション 1 のガベージ コレクションでごみではないと判断されたオブジェクトは、ジェネレーション 2 に昇格されます。ジェネレーション 2 のガベージ コレクションでごみではないと判断されたオブジェクトは、ジェネレーション 2 に残ります。  
+  
+ ガベージ コレクターは、ジェネレーションでごみではないと判断される割合が高いことを検出すると、そのジェネレーションに対する割り当てのしきい値を高くして、次のジェネレーションで十分なサイズの解放されたメモリを受け取ることができるようにします。 CLR は、アプリケーションのワーキング セットが大きくなりすぎないようにすることと、ガベージ コレクションに時間がかかりすぎないようにすることに注意して、それらの 2 つの優先事項のバランスを絶えず調整します。  
+  
+### 短期のジェネレーションとセグメント  
+ ジェネレーション 0 および 1 のオブジェクトは有効期間が短いことから、それらのジェネレーションのことを短期ジェネレーションと呼びます。  
+  
+ 短期ジェネレーションは、短期セグメントと呼ばれるメモリ セグメントに割り当てる必要があります。 ガベージ コレクターによって新しいセグメントが取得されると、いずれも新しい短期セグメントになり、ジェネレーション 0 のガベージ コレクションで残ったオブジェクトが格納されます。 古い短期セグメントは新しいジェネレーション 2 のセグメントになります。  
+  
+ 短期セグメントのサイズは、システムが 32 ビット 64 ビットのどちらであるか、および実行されているガベージ コレクターの種類に応じて異なります。 既定の値を次の表に示します。  
+  
+||32 ビット|64 ビット|  
+|-|------------|------------|  
+|ワークステーションの GC|16 MB|256 MB|  
+|サーバーの GC|64 MB|4 GB|  
+|サーバーの GC \(論理 CPU が 4 個以上の場合\)|32 MB|2 GB|  
+|サーバーの GC \(論理 CPU が 8 個以上の場合\)|16 MB|1 GB|  
+  
+ 短期セグメントには、ジェネレーション 2 のオブジェクトも含めることができます。 ジェネレーション 2 のオブジェクトでは複数のセグメントを使用できます \(プロセスでの必要に応じてメモリが許容できる限りいくつでも使用できます\)。  
+  
+ 短期ガベージ コレクションによって解放されるメモリの量は、短期セグメントのサイズまでに限られます。 解放されるメモリの量は、使用されなくなったオブジェクトに占有されていた領域に比例します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="what_happens_during_a_garbage_collection"></a>   
+## ガベージ コレクションの実行時の動作  
+ ガベージ コレクションには次のフェーズがあります。  
+  
+-   マーキング フェーズ。有効なすべてのオブジェクトを探し、そのリストを作成します。  
+  
+-   再配置フェーズ。圧縮するオブジェクトへの参照を更新します。  
+  
+-   圧縮フェーズ。使用されなくなったオブジェクトに占有されている領域を解放し、残ったオブジェクトを圧縮します。 圧縮フェーズでは、ガベージ コレクションで残ったオブジェクトをセグメントの後ろに移動します。  
+  
+     ジェネレーション 2 のコレクションでは複数のセグメントを占有できるため、ジェネレーション 2 に昇格されたオブジェクトはより古いセグメントに移動できます。 ジェネレーション 1 とジェネレーション 2 の残存オブジェクトは、どちらもジェネレーション 2 に昇格されるため、別のセグメントに移動できます。  
+  
+     通常、大きなオブジェクト ヒープは圧縮されません。これは、大きなオブジェクトをコピーするとパフォーマンスが低下するためです。 ただし [!INCLUDE[net_v451](../../../includes/net-v451-md.md)] 以降では、<xref:System.Runtime.GCSettings.LargeObjectHeapCompactionMode%2A?displayProperty=fullName> プロパティを使用して、大きなオブジェクト ヒープを必要に応じて圧縮できます。  
+  
+ ガベージ コレクターは、次の情報に基づいてオブジェクトが有効かどうかを判断します。  
+  
+-   **スタック ルート**。 Just\-In\-Time \(JIT\) コンパイラとスタック ウォーカーによって提供されるスタック変数。  
+  
+-   **ガベージ コレクション ハンドル**。 マネージ オブジェクトを参照するハンドル。これらのハンドルは、ユーザー コードまたは共通言語ランタイムで割り当てることができます。  
+  
+-   **静的データ**。 他のオブジェクトを参照している可能性があるアプリケーション ドメインの静的オブジェクト。 静的オブジェクトはそれぞれのアプリケーション ドメインで追跡されます。  
+  
+ ガベージ コレクションが開始される前に、そのガベージ コレクションをトリガーしたスレッドを除くすべてのマネージ スレッドが中断されます。  
+  
+ 次の図は、ガベージ コレクションを発生させて他のスレッドの中断を引き起こすスレッドを示しています。  
+  
+ ![スレッドがガベージ コレクションを発生させる場合](../../../docs/standard/garbage-collection/media/gc-triggered.png "GC\_Triggered")  
+ガベージ コレクションを発生させるスレッド  
+  
+ [ページのトップへ](#top)  
+  
+<a name="manipulating_unmanaged_resources"></a>   
+## アンマネージ リソースの操作  
+ ガベージ コレクターではマネージ ヒープのメモリのみを追跡するため、マネージ オブジェクトでネイティブのファイル ハンドルを使用してアンマネージ オブジェクトを参照している場合は、そのアンマネージ オブジェクトを明示的に解放する必要があります。  
+  
+ マネージ オブジェクトのユーザーは、オブジェクトで使用されているネイティブ リソースを破棄できません。 そのため、クリーンアップを行うには、マネージ オブジェクトをファイナライズ可能にします。 ファイナライズは、オブジェクトが使用されなくなったときに実行するクリーンアップ アクションで構成されます。 マネージ オブジェクトが使用されなくなると、ファイナライザー メソッドで指定されたクリーンアップ アクションが実行されます。  
+  
+ ファイナライズ可能なオブジェクトが使用されなくなったことが検出されると、クリーンアップ アクションを実行するためにファイナライザーによってキューに入れられますが、オブジェクト自体は次のジェネレーションに昇格されます。 そのため、そのジェネレーションで次のガベージ コレクション \(次回のガベージ コレクションではない場合もあります\) が発生するまで、オブジェクトが解放されたかどうかは確認できません。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="workstation_and_server_garbage_collection"></a>   
+## ワークステーションとサーバーのガベージ コレクション  
+ ガベージ コレクターは、さまざまなシナリオに対応できるように自動的に調整されます。 構成ファイルの設定を使って、作業負荷の特性に基づいてガベージ コレクションの種類を設定できます。 CLR には、次の種類のガベージ コレクションが用意されています。  
+  
+-   ワークステーションのガベージ コレクション。すべてのクライアント ワークステーションとスタンドアロンの PC を対象としたオプションです。 これは、ランタイム構成スキーマの [\<gcServer\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md)の既定の設定です。  
+  
+     ワークステーションのガベージ コレクションは、同時実行または非同時実行のどちらかで実行できます。 同時実行ガベージ コレクションでは、ガベージ コレクションの実行中にマネージ スレッドの操作を続けることができます。  
+  
+     [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、同時実行ガベージ コレクションに代わるものとしてバックグラウンド ガベージ コレクションが使用されます。  
+  
+-   サーバーのガベージ コレクション。高いスループットとスケーラビリティが必要なサーバー アプリケーションを対象としたオプションです。 サーバーのガベージ コレクションは、非同時実行ガベージ コレクションまたはバックグラウンド ガベージ コレクションである場合があります。  
+  
+ 次の図は、サーバー上でガベージ コレクションを実行する専用のスレッドを示しています。  
+  
+ ![サーバー ガベージ コレクションのスレッド](../../../docs/standard/garbage-collection/media/gc-server.png "GC\_Server")  
+サーバー ガベージ コレクション  
+  
+### ガベージ コレクションの構成  
+ ランタイム構成スキーマの [\<gcServer\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md)を使用して、CLR で実行するガベージ コレクションの種類を指定できます。 この要素の `enabled` 属性が `false` \(既定値\) に設定されている場合、ワークステーションのガベージ コレクションが実行されます。`enabled` 属性を `true` に設定すると、サーバーのガベージ コレクションが実行されます。  
+  
+ 同時実行ガベージ コレクションは、ランタイム構成スキーマの [\<gcConcurrent\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)を使用して指定します。 既定値は `enabled` です。 この設定は、同時実行ガベージ コレクションとバックグラウンド ガベージ コレクションの両方を制御します。  
+  
+ サーバーのガベージ コレクションは、アンマネージ ホスト インターフェイスを使用して指定することもできます。 ASP.NET および SQL Server では、アプリケーションがそのいずれかの環境内でホストされている場合、自動的にサーバーのガベージ コレクションが有効になることに注意してください。  
+  
+### ワークステーションとサーバーのガベージ コレクションの比較  
+ ワークステーションのガベージ コレクションにおける、スレッド処理とパフォーマンスについての注意点を次に示します。  
+  
+-   コレクションは、ガベージ コレクションをトリガーしたユーザー スレッドで、それと同じ優先順位で実行されます。 ユーザー スレッドは一般に通常の優先順位で実行されるため、その場合 \(通常の優先順位のスレッドで実行された場合\)、ガベージ コレクターの CPU 時間が他のスレッドと競合します。  
+  
+     ネイティブ コードを実行しているスレッドは中断されません。  
+  
+-   プロセッサが 1 つしかないコンピューターでは、[\<gcServer\>](../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md) の設定に関係なく、常にワークステーションのガベージ コレクションが使用されます。 サーバーのガベージ コレクションを指定した場合、CLR は、同時実行を無効にしてワークステーションのガベージ コレクションを使用します。  
+  
+ サーバーのガベージ コレクションにおける、スレッド処理とパフォーマンスについての注意点を次に示します。  
+  
+-   コレクションは、`THREAD_PRIORITY_HIGHEST` の優先順位で実行される複数の専用スレッドで実行されます。  
+  
+-   ヒープおよびガベージ コレクションを実行するための専用スレッドは CPU ごとに 1 つずつ用意され、複数のヒープのコレクションが同時に行われます。 各ヒープには小さなオブジェクト ヒープと大きなオブジェクト ヒープがあり、どのヒープもユーザー コードからアクセスできます。 異なるヒープのオブジェクトを相互に参照できます。  
+  
+-   複数のガベージ コレクション スレッドが連携して処理を行うため、同じサイズのヒープを処理した場合、サーバーのガベージ コレクションの方がワークステーションのガベージ コレクションよりも高速です。  
+  
+-   一般に、サーバーのガベージ コレクションの方が、格納されるセグメントのサイズは大きくなります。 ただし、これは一般論に過ぎません。セグメントのサイズは実装に固有であり、変更されることがあります。 アプリをチューニングする時に、ガベージ コレクターによって割り当てられるセグメントのサイズに関して何らかの仮定をすることは避けてください。  
+  
+-   サーバーのガベージ コレクションでは、リソースが大量に消費されることがあります。 たとえば、4 つのプロセッサを搭載したコンピューターで 12 のプロセスを実行する場合、そのすべてでサーバーのガベージ コレクションを使用するには、48 の専用のガベージ コレクション スレッドが必要です。 メモリの負荷が高い状況で、すべてのプロセスがガベージ コレクションの処理を開始した場合、ガベージ コレクターは 48 のスレッドをスケジュールすることになります。  
+  
+ 実行するアプリケーションのインスタンスが数百に及ぶ場合は、同時実行ガベージ コレクションを無効にしてワークステーションのガベージ コレクションを使用することを検討してください。 これによって、コンテキストの切り替えが少なくなり、パフォーマンスが向上します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="concurrent_garbage_collection"></a>   
+## 同時実行ガベージ コレクション  
+ ワークステーションまたはサーバーのガベージ コレクションでは、同時実行ガベージ コレクションを有効にすることで、複数のスレッドを同時に実行できます。同時実行ガベージ コレクションでは、コレクションの実行中は、ほとんどの場合、ガベージ コレクションの処理を行う専用のスレッドが使用されます。 このオプションは、ジェネレーション 2 のガベージ コレクションにのみ影響します。ジェネレーション 0 と 1 の処理はすぐに終了するため、常に非同時実行で行われます。  
+  
+ 同時実行ガベージ コレクションでは、コレクションの一時停止を最小限にすることで、インタラクティブ アプリケーションの応答性を高めることができます。 マネージ スレッドは、同時実行ガベージ コレクションのスレッドが実行されている間も、ほぼ常に処理を続けることができます。 そのため、ガベージ コレクションの実行中の一時停止が短くなります。  
+  
+ 複数のプロセスを実行している場合にパフォーマンスを向上させるには、同時実行ガベージ コレクションを無効にします。[\<gcConcurrent\> 要素](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)をアプリの構成ファイルに追加し、`enabled` 属性の値を `"false"` に設定することで、これを行うことができます。  
+  
+ 同時実行ガベージ コレクションは、専用のスレッドで実行されます。 既定では、CLR は、同時実行ガベージ コレクションを有効にしてワークステーションのガベージ コレクションを実行します。 これは、シングルプロセッサのコンピューターでもマルチプロセッサのコンピューターでも同じです。  
+  
+ 同時実行ガベージ コレクションの実行中にヒープに小さなオブジェクトを割り当てる機能は、同時実行ガベージ コレクションの開始時に短期セグメントに残っていたオブジェクトによって制限されます。 セグメントの最後に達した後は、同時実行ガベージ コレクションが終了するまで、小さなオブジェクトを割り当てる必要があるマネージ スレッドは中断されたままになります。  
+  
+ 同時実行ガベージ コレクションのワーキング セットは、同時実行コレクションの実行中にオブジェクトを割り当てることができるように \(非同時実行ガベージ コレクションに比べて\) 若干大きくなっています。 ただし、オブジェクトを割り当てるとそれもワーキング セットの一部になるため、パフォーマンスに影響することがあります。 基本的に、同時実行ガベージ コレクションでは、ある程度の CPU およびメモリと引き換えに一時停止が短くなります。  
+  
+ 次の図は、別々の専用のスレッドで実行される同時実行ガベージ コレクションを示しています。  
+  
+ ![同時実行ガベージ コレクションのスレッド](../../../docs/standard/garbage-collection/media/gc-concurrent.png "GC\_Concurrent")  
+同時実行ガベージ コレクション  
+  
+ [ページのトップへ](#top)  
+  
+<a name="background_garbage_collection"></a>   
+## バックグラウンド ワークステーション ガベージ コレクション  
+ バックグラウンド ガベージ コレクションでは、ジェネレーション 2 のコレクションの実行中に、必要に応じて短期ジェネレーション \(0 および 1\) のコレクションが行われます。 バックグラウンド ガベージ コレクションの設定はありません。同時実行ガベージ コレクションを有効にすると自動的に有効になります。 バックグラウンド ガベージ コレクションは同時実行ガベージ コレクションに代わるものです。 同時実行ガベージ コレクションと同様に、バックグラウンド ガベージ コレクションは専用のスレッドで実行され、ジェネレーション 2 のコレクションにのみ適用されます。  
+  
+> [!NOTE]
+>  バックグラウンド ガベージ コレクションは、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降のバージョンでのみ使用できます。[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、ワークステーションのガベージ コレクションのみがサポートされます。 .NET Framework 4.5 以降では、バックグラウンド ガベージ コレクションは、ワークステーションとサーバーのガベージ コレクションの両方で使用できます。  
+  
+ バックグラウンド ガベージ コレクションの実行中に行われる短期ジェネレーションに対するコレクションのことを、フォアグラウンド ガベージ コレクションと呼びます。 フォアグラウンド ガベージ コレクションが発生すると、マネージ スレッドはすべて中断されます。  
+  
+ バックグラウンド ガベージ コレクションの実行中にジェネレーション 0 に十分なオブジェクトが割り当てられていれば、CLR はジェネレーション 0 またはジェネレーション 1 のフォアグラウンド ガベージ コレクションを実行します。 バックグラウンド ガベージ コレクションの専用スレッドは、フォアグラウンド ガベージ コレクションの要求がないかどうかをセーフ ポイントで頻繁に確認します。 要求があると、バックグラウンド コレクションを中断して、フォアグラウンド ガベージ コレクションを実行します。 フォアグラウンド ガベージ コレクションが完了すると、バックグラウンド ガベージ コレクションの専用スレッドとユーザー スレッドが再開されます。  
+  
+ バックグラウンド ガベージ コレクションでは、バックグラウンド ガベージ コレクションの実行中に短期ガベージ コレクションが発生する可能性があるため、同時実行ガベージ コレクションによる割り当ての制限が解除されます。 つまり、バックグラウンド ガベージ コレクションで短期ジェネレーションの使用されなくなったオブジェクトを削除でき、また、ジェネレーション 1 のガベージ コレクションの実行中に必要に応じてヒープを拡張することもできます。  
+  
+ 次の図は、ワークステーション上の別々の専用スレッドで実行されるバックグラウンド ガベージ コレクションを示しています。  
+  
+ ![バックグラウンド ワークステーション ガベージ コレクション](../../../docs/standard/garbage-collection/media/backgroundworkstn.png "BackgroundWorkstn")  
+バックグラウンド ワークステーション ガベージ コレクション  
+  
+ [ページのトップへ](#top)  
+  
+<a name="background_server_garbage_collection"></a>   
+## バックグラウンド サーバー ガベージ コレクション  
+ .NET Framework 4.5 以降では、サーバーのバックグラウンド ガベージ コレクションは、サーバーのガベージ コレクションの既定のモードです。 このモードを選択するには、ランタイム構成スキーマで [\<gcServer\>](../../../docs/framework/configure-apps/file-schema/runtime/gcserver-element.md) 要素の `enabled` 属性を `true` に設定します。 このモードは、前のセクションで説明したワークステーションのバックグラウンド ガベージ コレクションと同様に機能しますが、いくつかの違いがあります。 ワークステーションのバックグラウンド ガベージ コレクションでは専用のバックグラウンド ガベージ コレクション スレッドを 1 つ使用します。これに対して、サーバーのバックグラウンド ガベージ コレクションでは複数のスレッドを使用し、通常、論理プロセッサごとに専用のスレッドが使用されます。 ワークステーションのバックグラウンド ガベージ コレクション スレッドとは異なり、これらのスレッドはタイムアウトになりません。  
+  
+ 次の図は、サーバー上の別々の専用スレッドで実行されるバックグラウンド ガベージ コレクションを示しています。  
+  
+ ![バックグラウンド サーバー ガベージ コレクション](../../../docs/standard/garbage-collection/media/backgroundserver.png "BackgroundServer")  
+バックグラウンド サーバー ガベージ コレクション  
+  
+## 参照  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/implementing-dispose.md b/docs/standard/garbage-collection/implementing-dispose.md
new file mode 100644
index 00000000000..890501c72fa
--- /dev/null
+++ b/docs/standard/garbage-collection/implementing-dispose.md
@@ -0,0 +1,168 @@
+---
+title: "Dispose メソッドの実装 | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Dispose メソッド"
+  - "ガベージ コレクション、Dispose メソッド"
+ms.assetid: eb4e1af0-3b48-4fbc-ad4e-fc2f64138bf9
+caps.latest.revision: 44
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 44
+---
+# Dispose メソッドの実装
+アプリケーションによって使用されるアンマネージ リソースを解放するための <xref:System.IDisposable.Dispose%2A> メソッドを実装します。 .NET Framework ガベージ コレクターは、アンマネージ メモリの割り当てや解放を行いません。  
+  
+ 呼ばれる、オブジェクトを破棄するパターン、 [dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md)オブジェクトの有効期間に順番が付けられます。 Dispose パターンは、ファイルおよびパイプ ハンドル、レジストリ ハンドル、待機ハンドル、アンマネージ メモリ ブロックのポインターなど、アンマネージ リソースにアクセスするオブジェクトでのみ使用されます。 これは、使用されていないマネージ オブジェクトの解放にはガベージ コレクターが非常に有効ですが、アンマネージ オブジェクトは解放できないためです。  
+  
+ Dispose パターンには&2; 種類あります。  
+  
+-   型で使用する各アンマネージ リソースをセーフ ハンドル (つまり、<xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName> から派生したクラス) でラップします。 この場合、<xref:System.IDisposable> インターフェイスと追加の `Dispose(Boolean)` メソッドを実装します。 これは推奨される方法で、<xref:System.Object.Finalize%2A?displayProperty=fullName> メソッドをオーバーライドする必要がありません。  
+  
+    > [!NOTE]
+    >  <xref:Microsoft.Win32.SafeHandles?displayProperty=fullName> 名前空間には <xref:System.Runtime.InteropServices.SafeHandle> から派生した一連のクラスが用意されています。これらのクラスは「[セーフ ハンドルの使用](#SafeHandles)」にリストされています。 アンマネージ リソースを解放できるクラスが見つからない場合は、<xref:System.Runtime.InteropServices.SafeHandle> の独自のサブクラスを実装できます。  
+  
+-   実装する、 <xref:System.IDisposable>インターフェイスと追加`Dispose(Boolean)`メソッドもオーバーライド、 <xref:System.Object.Finalize%2A?displayProperty=fullName>メソッドです。 <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装が型のコンシューマーによって呼び出されなかった場合にアンマネージ リソースが破棄されるように、<xref:System.Object.Finalize%2A> をオーバーライドする必要があります。 前の項目で説明された推奨される方法を使用すると、<xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName> クラスが代わりにこれを実行します。  
+  
+ <xref:System.IDisposable.Dispose%2A> メソッドが複数回呼び出される場合でも、例外をスローすることなく呼び出されるようにして、リソースが常に適切にクリーンアップされるようにする必要があります。  
+  
+> [!IMPORTANT]
+>  C++ プログラマならを実装していない、 <xref:System.IDisposable.Dispose%2A>メソッドです。 「デストラクターとファイナライザー」セクションの指示に従って、代わりに、[する方法: 定義消費クラスと構造体 (C + +/CLI)](../Topic/How%20to:%20Define%20and%20Consume%20Classes%20and%20Structs%20\(C++-CLI\).md)します。 以降、.NET Framework 2.0 では、C++ コンパイラはリソースの確定的な破棄をサポートしの直接の実装を許可しない、 <xref:System.IDisposable.Dispose%2A>メソッドです。  
+  
+ <xref:System.GC.KeepAlive%2A?displayProperty=fullName> メソッドのコード例では、再利用するオブジェクトのメンバーがまだ実行中の場合でも、ガベージ コレクションがファイナライザーを実行しようとします。 呼び出すことをお勧めします<xref:System.GC.KeepAlive%2A>メソッド、時間がかかるの最後に<xref:System.IDisposable.Dispose%2A>メソッドです。  
+  
+<a name="Dispose2"></a>   
+## <a name="dispose-and-disposeboolean"></a>Dispose() と Dispose(Boolean)  
+ <xref:System.IDisposable> インターフェイスでは、パラメーターのない <xref:System.IDisposable.Dispose%2A> メソッドを&1; つ実装する必要があります。 しかし、Dispose パターンでは&2; 種類の `Dispose` メソッドを実装する必要があります。  
+  
+-   public で非仮想 (Visual Basic では `NonInheritable`) の <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装。パラメーターはありません。  
+  
+-   protected で仮想 (Visual Basic では `Overridable`) の `Dispose` メソッド。シグネチャは次のとおりです。  
+  
+     [!code-csharp[Conceptual.Disposable#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/dispose1.cs#8)]
+     [!code-vb[Conceptual.Disposable#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/dispose1.vb#8)]  
+  
+### <a name="the-dispose-overload"></a>Dispose() オーバーロード  
+ この public で非仮想 (Visual Basic では `NonInheritable`)、パラメーターなしの `Dispose` メソッドは、型のコンシューマーによって呼び出されるため、その目的は、アンマネージ リソースを解放し、ファイナライザーが存在する場合、それを実行する必要がないことを示すことです。 このため、次のような標準的な実装があります。  
+  
+ [!code-csharp[Conceptual.Disposable#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/dispose1.cs#7)]
+ [!code-vb[Conceptual.Disposable#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/dispose1.vb#7)]  
+  
+ `Dispose` メソッドはオブジェクトのクリーンアップをすべて実行するため、ガベージ コレクターはもはやオブジェクトの <xref:System.Object.Finalize%2A?displayProperty=fullName> のオーバーライドを呼び出す必要はありません。 そのため、呼び出しを<xref:System.GC.SuppressFinalize%2A>メソッドにより、ガベージ コレクターによるファイナライザーの実行します。 型にファイナライザーの呼び出しにないかどうかは<xref:System.GC.SuppressFinalize%2A?displayProperty=fullName>も何も起こりません。 アンマネージ リソースを解放する実際の作業は `Dispose` メソッドの&2; 番目のオーバーロードによって実行されることに注意してください。  
+  
+### <a name="the-disposeboolean-overload"></a>Dispose(Boolean) オーバーロード  
+ 2 番目のオーバー ロードでは、`disposing`パラメーターは、<xref:System.Boolean>メソッドの呼び出し元となるかどうかを示す、 <xref:System.IDisposable.Dispose%2A>メソッド (その値は`true`) それともファイナライザーか (その値は`false`)。  
+  
+ メソッドの本体は&2; つのコード ブロックで構成されます。  
+  
+-   アンマネージ リソースを解放するブロック。 このブロックは、`disposing` パラメーターの値に関係なく実行されます。  
+  
+-   マネージ リソースを解放する条件付きブロック。 このブロックは、`disposing` の値が `true` の場合に実行されます。 解放するマネージ リソースには、次のオブジェクトを含めることができます。  
+  
+     **実装するマネージ オブジェクト<xref:System.IDisposable>します。**  
+     条件付きブロックを使用して <xref:System.IDisposable.Dispose%2A> の実装を呼び出すことができます。 呼び出す必要がありますをアンマネージ リソースをラップするセーフ ハンドルを使用した場合、 <xref:System.Runtime.InteropServices.SafeHandle.Dispose%28System.Boolean%29?displayProperty=fullName>ここでの実装です。  
+  
+     **大量のメモリを消費するか、不足しているリソースを消費するマネージ オブジェクト。**  
+     これらのオブジェクトを `Dispose` メソッドで明示的に解放すると、ガベージ コレクターによって非確定的に解放される場合よりも迅速に解放されます。  
+  
+ メソッドの呼び出し元がファイナライザーの場合 (つまり、`disposing` が `false` の場合)、アンマネージ リソースを解放するコードだけが実行されます。 ガベージ コレクターが終了処理の際にマネージ オブジェクトを破棄する順序は定義されていないため、値 `Dispose` を指定した `false` オーバーロードを呼び出すことで、既に解放されている可能性のあるマネージ リソースをファイナライザーが解放しようとすることを防止できます。  
+  
+## <a name="implementing-the-dispose-pattern-for-a-base-class"></a>基底クラスでの Dispose パターンの実装  
+ 基底クラスで Dispose パターンを実装する場合、以下の項目を用意する必要があります。  
+  
+> [!IMPORTANT]
+>  すべての基底クラスを実装するには、このパターンを実装する必要があります<xref:System.IDisposable>されない`sealed`(`NotInheritable` Visual Basic で)。  
+  
+-   `Dispose(Boolean)` メソッドを呼び出す <xref:System.IDisposable.Dispose%2A> の実装。  
+  
+-   リソースを解放する実際の作業を実行する `Dispose(Boolean)` メソッド。  
+  
+-   アンマネージ リソースをラップする <xref:System.Runtime.InteropServices.SafeHandle> から派生したクラス (推奨)、または、<xref:System.Object.Finalize%2A?displayProperty=fullName> メソッドのオーバーライド。 <xref:System.Runtime.InteropServices.SafeHandle> クラスには、コーディングが不要なファイナライザーが用意されています。  
+  
+ セーフ ハンドルを使用して基底クラスで Dispose パターンを実装する一般的なパターンを次に示します。  
+  
+ [!code-csharp[System.IDisposable#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.idisposable/cs/base1.cs#3)]
+ [!code-vb[System.IDisposable#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.idisposable/vb/base1.vb#3)]  
+  
+> [!NOTE]
+>  前の例では、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> オブジェクトを使用してパターンを示しています。代わりに、<xref:System.Runtime.InteropServices.SafeHandle> から派生した任意のオブジェクトを使用することもできます。 例では、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> オブジェクトを正しくインスタンス化していないことに注意してください。  
+  
+ <xref:System.Object.Finalize%2A?displayProperty=fullName> をオーバーライドして基底クラスで Dispose パターンを実装する一般的なパターンを次に示します。  
+  
+ [!code-csharp[System.IDisposable#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.idisposable/cs/base2.cs#5)]
+ [!code-vb[System.IDisposable#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.idisposable/vb/base2.vb#5)]  
+  
+> [!NOTE]
+>  オーバーライドする、C# の場合は、 <xref:System.Object.Finalize%2A?displayProperty=fullName>定義することで、[デストラクター](../Topic/Destructors%20\(C%23%20Programming%20Guide\).md)します。  
+  
+## <a name="implementing-the-dispose-pattern-for-a-derived-class"></a>派生クラスでの Dispose パターンの実装  
+ <xref:System.IDisposable> インターフェイスを実装するクラスから派生したクラスは、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の基底クラスでの実装が派生クラスに継承されるため、<xref:System.IDisposable> を実装しないでください。 代わりに、派生クラスで Dispose パターンを実装するには、以下の項目を用意します。  
+  
+-   基底クラスのメソッドをオーバーライドして、派生クラスのリソースを解放する実際の作業を実行する `protected``Dispose(Boolean)` メソッド。 このメソッドは、基底クラスの `Dispose(Boolean)` メソッドも呼び出して、それに `true` 引数の値として `disposing` を渡す必要があります。  
+  
+-   アンマネージ リソースをラップする <xref:System.Runtime.InteropServices.SafeHandle> から派生したクラス (推奨)、または、<xref:System.Object.Finalize%2A?displayProperty=fullName> メソッドのオーバーライド。 <xref:System.Runtime.InteropServices.SafeHandle> クラスには、コーディングが不要なファイナライザーが用意されています。 ファイナライザーを用意する場合は、`Dispose(Boolean)` 引数を `disposing` として `false` オーバーロードを呼び出す必要があります。  
+  
+ セーフ ハンドルを使用して派生クラスで Dispose パターンを実装する一般的なパターンを次に示します。  
+  
+ [!code-csharp[System.IDisposable#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.idisposable/cs/derived1.cs#4)]
+ [!code-vb[System.IDisposable#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.idisposable/vb/derived1.vb#4)]  
+  
+> [!NOTE]
+>  前の例では、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> オブジェクトを使用してパターンを示しています。代わりに、<xref:System.Runtime.InteropServices.SafeHandle> から派生した任意のオブジェクトを使用することもできます。 例では、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> オブジェクトを正しくインスタンス化していないことに注意してください。  
+  
+ <xref:System.Object.Finalize%2A?displayProperty=fullName> をオーバーライドして派生クラスで Dispose パターンを実装する一般的なパターンを次に示します。  
+  
+ [!code-csharp[System.IDisposable#6](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.idisposable/cs/derived2.cs#6)]
+ [!code-vb[System.IDisposable#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.idisposable/vb/derived2.vb#6)]  
+  
+> [!NOTE]
+>  オーバーライドする、C# の場合は、 <xref:System.Object.Finalize%2A?displayProperty=fullName>定義することで、[デストラクター](../Topic/Destructors%20\(C%23%20Programming%20Guide\).md)します。  
+  
+<a name="SafeHandles"></a>   
+## <a name="using-safe-handles"></a>セーフ ハンドルの使用  
+ オブジェクトのファイナライザーのコードを記述することは、正しく行わないと問題が発生する可能性がある複雑なタスクです。 そのため、ファイナライザーを実装するのではなく、<xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName> オブジェクトを構築することをお勧めします。  
+  
+ <xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName> クラスから派生したクラスは、処理を中断することなくハンドルの割り当てと解放を行うことで、オブジェクトの有効期間に関する問題を単純化します。 セーフ ハンドルは、アプリケーション ドメインのアンロード中に確実に実行されるクリティカル ファイナライザーを含んでいます。 セーフ ハンドルを使用する利点の詳細については、次を参照してください。 <xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName>します。 <xref:Microsoft.Win32.SafeHandles> 名前空間の次の派生クラスは、セーフ ハンドルを提供します。  
+  
+-   ファイル、メモリ マップ ファイル、パイプのための <xref:Microsoft.Win32.SafeHandles.SafeFileHandle>、<xref:Microsoft.Win32.SafeHandles.SafeMemoryMappedFileHandle>、<xref:Microsoft.Win32.SafeHandles.SafePipeHandle> クラス。  
+  
+-   メモリ ビューのための <xref:Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle> クラス。  
+  
+-   暗号の構成要素のための <xref:Microsoft.Win32.SafeHandles.SafeNCryptKeyHandle>、<xref:Microsoft.Win32.SafeHandles.SafeNCryptProviderHandle>、<xref:Microsoft.Win32.SafeHandles.SafeNCryptSecretHandle> クラス。  
+  
+-   レジストリ キーのための <xref:Microsoft.Win32.SafeHandles.SafeRegistryHandle> クラス。  
+  
+-   待機ハンドルのための <xref:Microsoft.Win32.SafeHandles.SafeWaitHandle> クラス。  
+  
+<a name="base"></a>   
+## <a name="using-a-safe-handle-to-implement-the-dispose-pattern-for-a-base-class"></a>セーフ ハンドルを使用した基底クラスでの Dispose パターンの実装  
+ 次の例は、セーフ ハンドルを使用してアンマネージ リソースをカプセル化する、基底クラス `DisposableStreamResource` での Dispose パターンを示します。 例では、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> を使用して、開いているファイルを表す <xref:System.IO.Stream> オブジェクトをラップする `DisposableResource` クラスを定義しています。 `DisposableResource` メソッドには、ファイル ストリームの合計バイト数を返す `Size` プロパティも含まれています。  
+  
+ [!code-csharp[Conceptual.Disposable#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/base1.cs#9)]
+ [!code-vb[Conceptual.Disposable#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/base1.vb#9)]  
+  
+<a name="derived"></a>   
+## <a name="using-a-safe-handle-to-implement-the-dispose-pattern-for-a-derived-class"></a>セーフ ハンドルを使用した派生クラスでの Dispose パターンの実装  
+ 次の例は、前の例で挙げた `DisposableStreamResource2` クラスを継承した派生クラス `DisposableStreamResource` での Dispose パターンを示します。 このクラスは `WriteFileInfo` メソッドを追加し、<xref:Microsoft.Win32.SafeHandles.SafeFileHandle> オブジェクトを使用して書き込み可能ファイル ハンドルをラップしています。  
+  
+ [!code-csharp[Conceptual.Disposable#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/derived1.cs#10)]
+ [!code-vb[Conceptual.Disposable#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/derived1.vb#10)]  
+  
+## <a name="see-also"></a>関連項目  
+ <xref:System.GC.SuppressFinalize%2A>   
+ <xref:System.IDisposable>   
+ <xref:System.IDisposable.Dispose%2A?displayProperty=fullName>   
+ <xref:Microsoft.Win32.SafeHandles>   
+ <xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName>   
+ <xref:System.Object.Finalize%2A?displayProperty=fullName>   
+ [方法: クラスと構造体定義および使用 (C + +/CLI)](../Topic/How%20to:%20Define%20and%20Consume%20Classes%20and%20Structs%20\(C++-CLI\).md)   
+ [Dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/index.md b/docs/standard/garbage-collection/index.md
new file mode 100644
index 00000000000..6df5579eb05
--- /dev/null
+++ b/docs/standard/garbage-collection/index.md
@@ -0,0 +1,69 @@
+---
+title: "Garbage Collection | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "memory, garbage collection"
+  - "garbage collection, automatic memory management"
+  - "GC [.NET Framework]"
+  - "memory, allocating"
+  - "common language runtime, garbage collection"
+  - "garbage collector"
+  - "cleanup operations"
+  - "garbage collection"
+  - "memory, releasing"
+  - "common language runtime, automatic memory management"
+  - "automatic memory management"
+  - "runtime, automatic memory management"
+  - "runtime, garbage collection"
+  - "garbage collection, about"
+ms.assetid: 22b6cb97-0c80-4eeb-a2cf-5ed7655e37f9
+caps.latest.revision: 36
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 36
+---
+# Garbage Collection
+.NET Framework のガベージ コレクターは、アプリケーションのメモリの割り当ておよび解放を管理します。  新しいオブジェクトを生成するたびに、共通言語ランタイムは、マネージ ヒープからオブジェクトにメモリを割り当てます。  マネージ ヒープに使用可能なアドレス空間がある限り、ランタイムは新しいオブジェクト用に領域の割り当てを続けます。  しかし、メモリの大きさは無限ではありません。  最終的には、ガベージ コレクターが、一部のメモリを解放するためにガベージ コレクションを実行する必要があります。  コレクションの実行に最適な時期は、ガベージ コレクターの最適化エンジンが、割り当てられるオブジェクトの状況に応じて決定します。  コレクションを実行する場合、ガベージ コレクターは、アプリケーションによって使用されなくなったオブジェクトがマネージ ヒープにあるかどうかをチェックし、使われていないオブジェクトのメモリを再利用するために必要な操作を実行します。  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[Fundamentals of Garbage Collection](../../../docs/standard/garbage-collection/fundamentals.md)|ガベージ コレクションの動作、マネージ ヒープに対するオブジェクトの割り当て方法、およびその他の主要な概念について説明します。|  
+|[Garbage Collection and Performance](../../../docs/standard/garbage-collection/performance.md)|ガベージ コレクションとパフォーマンスの問題を診断するために使用できるパフォーマンス チェックについて説明します。|  
+|[発生したコレクション](../../../docs/standard/garbage-collection/induced.md)|ガベージ コレクションがどのように行われるかについて説明します。|  
+|[Latency Modes](../../../docs/standard/garbage-collection/latency.md)|ガベージ コレクションの割り込みの動作を決定するモードについて説明します。|  
+|[Optimization for Shared Web Hosting](../../../docs/standard/garbage-collection/optimization-for-shared-web-hosting.md)|複数の小規模な Web サイトで共有されているサーバーで、ガベージ コレクションを最適化する方法について説明します。|  
+|[Garbage Collection Notifications](../../../docs/standard/garbage-collection/notifications.md)|フル ガベージ コレクションが近づいたときと完了したときを検出する方法について説明します。|  
+|[Application Domain Resource Monitoring](../../../docs/standard/garbage-collection/app-domain-resource-monitoring.md)|アプリケーション ドメインによる CPU とメモリの使用状況を監視する方法について説明します。|  
+|[Weak References](../../../docs/standard/garbage-collection/weak-references.md)|アプリケーションからオブジェクトへのアクセスを許容したまま、そのオブジェクトをガベージ コレクターが収集できるようにする機能について説明します。|  
+  
+## 参照  
+ <xref:System.GC?displayProperty=fullName>  
+  
+ <xref:System.GCCollectionMode?displayProperty=fullName>  
+  
+ <xref:System.GCNotificationStatus?displayProperty=fullName>  
+  
+ <xref:System.Runtime.GCLatencyMode?displayProperty=fullName>  
+  
+ <xref:System.Runtime.GCSettings?displayProperty=fullName>  
+  
+ <xref:System.Runtime.GCSettings.LargeObjectHeapCompactionMode%2A?displayProperty=fullName>  
+  
+ <xref:System.Object.Finalize%2A?displayProperty=fullName>  
+  
+ <xref:System.IDisposable?displayProperty=fullName>  
+  
+## 参照  
+ [Cleaning Up Unmanaged Resources](../../../docs/standard/garbage-collection/unmanaged.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/induced.md b/docs/standard/garbage-collection/induced.md
new file mode 100644
index 00000000000..78281cd8aa0
--- /dev/null
+++ b/docs/standard/garbage-collection/induced.md
@@ -0,0 +1,45 @@
+---
+title: "発生したコレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ガベージ コレクション、強制"
+ms.assetid: 019008fe-4708-4e65-bebf-04fd9941e149
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 発生したコレクション
+ほとんどの場合、コレクションの実行に最適なタイミングはガベージ コレクターが判断できるので、ガベージ コレクターに任せるのが良い方法です。  ただし、ごくまれに、強制的にコレクションを実行するとアプリケーションのパフォーマンスが向上する場合があります。  このような場合は、<xref:System.GC.Collect%2A?displayProperty=fullName> メソッドを使用してガベージ コレクションを強制的に実行できます。  
+  
+ アプリケーションのコードの特定の位置で、使用しているメモリ量が大きく減少する場合は、<xref:System.GC.Collect%2A?displayProperty=fullName> メソッドを使用します。  たとえば、複数のコントロールのある複雑なダイアログ ボックスを使用するアプリケーションでは、ダイアログ ボックスを閉じるときに <xref:System.GC.Collect%2A> を呼び出すと、ダイアログ ボックスの使用メモリが直ちに再利用されてパフォーマンスが向上する可能性があります。  適切でない回数でガベージ コレクターがオブジェクトの再利用を試みるとパフォーマンスが低下する場合があるので、アプリケーションではあまり頻繁にガベージ コレクションを強制しないでください。  次のセクションで説明するように、コレクションの効果がある場合にのみ、<xref:System.GC.Collect%2A> のメソッドに対して収集する <xref:System.GCCollectionMode?displayProperty=fullName> の列挙値を指定できます。  
+  
+## GC コレクション モード  
+ <xref:System.GCCollectionMode> 値を含む <xref:System.GC.Collect%2A?displayProperty=fullName> メソッド オーバーロードの 1 つを使用して、強制的コレクションの動作を次のように指定できます。  
+  
+|`GCCollectionMode` の値|説明|  
+|---------------------------|--------|  
+|<xref:System.GCCollectionMode>|実行中のバージョンの .NET Framework の既定のガベージ コレクション設定を使用します。|  
+|<xref:System.GCCollectionMode>|直ちにガベージ コレクションを強制的に実行します。  これは、<xref:System.GC.Collect?displayProperty=fullName> オーバーロードを呼び出すのと同じです。  結果として、すべてのジェネレーションのフル ブロッキング コレクションになります。<br /><br /> また、直ちにフル ブロッキング ガベージ コレクションを強制的に実行する前に、<xref:System.Runtime.GCSettings.LargeObjectHeapCompactionMode%2A?displayProperty=fullName> プロパティを <xref:System.Runtime.GCLargeObjectHeapCompactionMode?displayProperty=fullName> に設定して、大きなオブジェクト ヒープを圧縮することもできます。|  
+|<xref:System.GCCollectionMode>|オブジェクトを再利用するのに現在が最適なときかどうかをガベージ コレクターが判断できるようにします。<br /><br /> ガベージ コレクターは、コレクションの実行を正当化できるほど効果がないと判断して、オブジェクトを再利用せずに戻る場合があります。|  
+  
+## バックグラウンドまたはブロッキング コレクション  
+ <xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%2CSystem.Boolean%29?displayProperty=fullName> メソッド オーバーロードを呼び出して、発生するコレクションがブロッキング コレクションであるかどうかを指定できます。  実行されるコレクションの型は、メソッドの `mode` と `blocking` のパラメーターの組み合わせによって異なります。  `mode` は <xref:System.GCCollectionMode> 列挙体のメンバーです。`blocking` は <xref:System.Boolean> 値です。  `mode` と `blocking` 引数の相互作用を次の表にまとめます。  
+  
+|`mode`|`blocking` \= `true`|`blocking` \= `false`|  
+|------------|--------------------------|---------------------------|  
+|<xref:System.GCCollectionMode> または <xref:System.GCCollectionMode>|ブロッキング コレクションはできるだけ早く実行されます。  バックグラウンド コレクションが実行中でジェネレーションが 0 または 1 の場合、<xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%2CSystem.Boolean%29> メソッドは直ちにブロッキング コレクションをトリガーし、コレクションが終了すると制御を戻します。  バックグラウンド コレクションが実行中で `generation` パラメーターが 2 の場合、メソッドはバックグラウンド コレクションの終了を待機し、ジェネレーション 2 のブロッキング コレクションをトリガーして、制御を戻します。|コレクションはできるだけ早く実行されます。  <xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%2CSystem.Boolean%29> メソッドはバックグラウンド コレクションを要求しますが、それは保証されず、状況によってはブロッキング コレクションが実行される場合もあります。  バックグラウンド コレクションが既に実行中の場合、メソッドはすぐに制御を返します。|  
+|<xref:System.GCCollectionMode>|ガベージ コレクターおよび `generation` パラメーターの状態によっては、ブロッキング コレクションが実行される場合があります。  ガベージ コレクターは最適なパフォーマンスを提供しようとします。|ガベージ コレクターの状態によっては、コレクションが実行される場合があります。  <xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%2CSystem.Boolean%29> メソッドはバックグラウンド コレクションを要求しますが、それは保証されず、状況によってはブロッキング コレクションが実行される場合もあります。  ガベージ コレクターは最適なパフォーマンスを提供しようとします。  バックグラウンド コレクションが既に実行中の場合、メソッドはすぐに制御を返します。|  
+  
+## 参照  
+ [Latency Modes](../../../docs/standard/garbage-collection/latency.md)   
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/latency.md b/docs/standard/garbage-collection/latency.md
new file mode 100644
index 00000000000..142ed222733
--- /dev/null
+++ b/docs/standard/garbage-collection/latency.md
@@ -0,0 +1,64 @@
+---
+title: "Latency Modes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "garbage collection, intrusiveness"
+  - "garbage collection, latency modes"
+ms.assetid: 96278bb7-6eab-4612-8594-ceebfc887d81
+caps.latest.revision: 41
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 41
+---
+# Latency Modes
+オブジェクトを再利用するには、ガベージ コレクターはアプリケーションで実行中のすべてのスレッドを停止する必要があります。  状況によっては、アプリケーションがデータの取得やコンテンツの表示を行うときなど、重要なときにフル ガベージ コレクションが発生し、パフォーマンスが低下することがあります。  ガベージ コレクターが作業に悪影響を与える度合いを調整するには、<xref:System.Runtime.GCSettings.LatencyMode%2A?displayProperty=fullName> プロパティを <xref:System.Runtime.GCLatencyMode?displayProperty=fullName> 値のいずれかに設定することができます。  
+  
+ Latency \(待機時間\) は、ガベージ コレクターが実行中のアプリケーションに割って入る時間を指します。  待機時間が短い場合、ガベージ コレクターがオブジェクトを再利用する処理は控えめになり、アプリケーションに悪影響を与える度合いが下がります。  <xref:System.Runtime.GCLatencyMode?displayProperty=fullName> 列挙体には、待機時間の短い設定として次の 2 つがあります。  
+  
+-   <xref:System.Runtime.GCLatencyMode> では、ジェネレーション 2 のガベージ コレクションが停止し、ジェネレーション 0 および 1 のみガベージ コレクションが実行されます。  これは、短時間の場合にのみ使用できます。  この設定を長時間にわたって使用すると、システムのメモリが不足してガベージ コレクターがガベージ コレクションをトリガーした場合に、アプリケーションが少しの間停止したり、高速性を必要とする操作が中断されたりすることがあります。  この設定は、ワークステーションのガベージ コレクションでのみ使用できます。  
+  
+-   <xref:System.Runtime.GCLatencyMode> では、フォアグラウンドのジェネレーション 2 のガベージ コレクションが停止し、ジェネレーション 0 および 1 とバックグラウンドのジェネレーション 2 のガベージ コレクションのみが実行されます。  これは長時間にわたって使用でき、ワークステーションとサーバーの両方のガベージ コレクションで使用できます。  この設定は、[同時実行ガベージ コレクション](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)が無効の場合には使用できません。  
+  
+ 待機時間の短い設定になっている場合でも、次の状況ではジェネレーション 2 のガベージ コレクションの停止が解除されます。  
+  
+-   システムがオペレーティング システムからメモリ不足の通知を受け取った場合。  
+  
+-   アプリケーション コードから <xref:System.GC.Collect%2A?displayProperty=fullName> メソッドを呼び出し、`generation` パラメーターに 2 を指定してガベージ コレクションを実行した場合。  
+  
+ 次の表に、<xref:System.Runtime.GCLatencyMode> の各値を使用するアプリケーション シナリオを示します。  
+  
+|待機時間モード|アプリケーション シナリオ|  
+|-------------|-------------------|  
+|<xref:System.Runtime.GCLatencyMode>|UI 操作のないアプリケーションの場合、またはサーバー側の操作の場合に使用します。<br /><br /> これは、[同時実行ガベージ コレクション](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)が無効の場合の既定モードです。|  
+|<xref:System.Runtime.GCLatencyMode>|UI を持つほとんどのアプリケーションの場合に使用します。<br /><br /> これは、[同時実行ガベージ コレクション](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md)が有効の場合の既定モードです。|  
+|<xref:System.Runtime.GCLatencyMode>|ガベージ コレクターからの割り込みにより重大な影響を受け、高速性を必要とする、短期間の操作を実行するアプリケーションの場合に使用します。  たとえば、アニメーションのレンダリングやデータの取得機能を実行するアプリケーションなどがあります。|  
+|<xref:System.Runtime.GCLatencyMode>|ガベージ コレクターからの割り込みにより重大な影響を受け、高速性を必要とする、さほど処理時間を必要としないものの長時間になる可能性のある操作を実行するアプリケーションの場合に使用します。  たとえば、取引時間中に市場データの変化に応じて迅速な応答時間を必要とするアプリケーションなどがあります。<br /><br /> このモードでは、マネージ ヒープのサイズが他のモードより大きくなります。  マネージ ヒープは最適化されないため、断片化の割合が高くなる可能性があります。  十分なメモリが使用可能であることを確認してください。|  
+  
+## 待機時間の短いモードの使用に関するガイドライン  
+ <xref:System.Runtime.GCLatencyMode> モードを使用する場合は、次のガイドラインを検討してください。  
+  
+-   待機時間を短くする期間は、できるだけ短くします。  
+  
+-   待機時間を短くする期間中は、大量のメモリを割り当てないようにします。  ガベージ コレクションによって再利用されるオブジェクトの数が少なくなるため、メモリ不足の通知が発生する可能性があります。  
+  
+-   待機時間の短いモードの間は、割り当ての数、特に大きなオブジェクト ヒープや固定されたオブジェクトへの割り当ての数を最小限に抑えます。  
+  
+-   割り当てられる可能性のあるスレッドに注意します。  <xref:System.Runtime.GCSettings.LatencyMode%2A> プロパティの設定はプロセス全体に適用されるため、割り当てられた他のスレッドで <xref:System.OutOfMemoryException> が発生する可能性があります。  
+  
+-   待機時間の短いコードを制約された実行領域にラップします \(詳細については、「[制約された実行領域](../../../docs/framework/performance/constrained-execution-regions.md)」を参照してください\)。  
+  
+-   待機時間を短くする期間中でも、<xref:System.GC.Collect%28System.Int32%2CSystem.GCCollectionMode%29?displayProperty=fullName> メソッドを呼び出せばジェネレーション 2 のガベージ コレクションを強制できます。  
+  
+## 参照  
+ <xref:System.GC?displayProperty=fullName>   
+ [発生したコレクション](../../../docs/standard/garbage-collection/induced.md)   
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/media/backgroundserver.png b/docs/standard/garbage-collection/media/backgroundserver.png
new file mode 100644
index 00000000000..b2ea2f1e454
Binary files /dev/null and b/docs/standard/garbage-collection/media/backgroundserver.png differ
diff --git a/docs/standard/garbage-collection/media/backgroundworkstn.png b/docs/standard/garbage-collection/media/backgroundworkstn.png
new file mode 100644
index 00000000000..e4b79f1df64
Binary files /dev/null and b/docs/standard/garbage-collection/media/backgroundworkstn.png differ
diff --git a/docs/standard/garbage-collection/media/gc-concurrent.png b/docs/standard/garbage-collection/media/gc-concurrent.png
new file mode 100644
index 00000000000..4f2cf1ebb95
Binary files /dev/null and b/docs/standard/garbage-collection/media/gc-concurrent.png differ
diff --git a/docs/standard/garbage-collection/media/gc-server.png b/docs/standard/garbage-collection/media/gc-server.png
new file mode 100644
index 00000000000..d9848a1019a
Binary files /dev/null and b/docs/standard/garbage-collection/media/gc-server.png differ
diff --git a/docs/standard/garbage-collection/media/gc-triggered.png b/docs/standard/garbage-collection/media/gc-triggered.png
new file mode 100644
index 00000000000..7e1a88c7546
Binary files /dev/null and b/docs/standard/garbage-collection/media/gc-triggered.png differ
diff --git a/docs/standard/garbage-collection/memory-management-and-gc.md b/docs/standard/garbage-collection/memory-management-and-gc.md
new file mode 100644
index 00000000000..ee24c9644d0
--- /dev/null
+++ b/docs/standard/garbage-collection/memory-management-and-gc.md
@@ -0,0 +1,34 @@
+---
+title: "Memory Management and Garbage Collection in the .NET Framework | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "GC [.NET Framework]"
+  - "memory management [.NET Framework]"
+  - "garbage collection [.NET Framework profiling]"
+ms.assetid: fd0462f7-57ad-4858-bf62-958378873602
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Memory Management and Garbage Collection in the .NET Framework
+このセクションでは、.NET Framework でのメモリの管理について説明します。  
+  
+## このセクションの内容  
+ [Cleaning Up Unmanaged Resources](../../../docs/standard/garbage-collection/unmanaged.md)  
+ アンマネージ リソースの適切な管理とクリーンアップの方法について説明します。  
+  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)  
+ .NET Framework のガベージ コレクターについて説明します。  
+  
+## 関連項目  
+ [開発ガイド](../../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/notifications.md b/docs/standard/garbage-collection/notifications.md
new file mode 100644
index 00000000000..7c7fb7c0340
--- /dev/null
+++ b/docs/standard/garbage-collection/notifications.md
@@ -0,0 +1,126 @@
+---
+title: "Garbage Collection Notifications | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "garbage collection, notifications"
+ms.assetid: e12d8e74-31e3-4035-a87d-f3e66f0a9b89
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# Garbage Collection Notifications
+共通言語ランタイムによるフル ガベージ コレクション \(つまり、ジェネレーション 2 のコレクション\) がパフォーマンスに悪影響を及ぼす可能性がある場合があります。  これは、特に大量の要求を処理するサーバーで問題になります。このような環境では、長時間のガベージ コレクションにより要求がタイムアウトします。  重要な処理を実行している最中にフル ガベージ コレクションが実行されないようにするために、フル ガベージ コレクションが近づいていることが通知されます。これを受けて、作業負荷を別のサーバー インスタンスにリダイレクトするためのアクションを実行できます。  現在のサーバー インスタンスが要求を処理する必要がなければ、ガベージ コレクションをユーザーが強制的に実行することもできます。  
+  
+ <xref:System.GC.RegisterForFullGCNotification%2A> メソッドは、フル ガベージ コレクションが近づいていることをランタイムが検知したときに通知を発生するように登録します。  この通知には、フル ガベージ コレクションが近づいている場合と、フル ガベージ コレクションが完了した場合の 2 つがあります。  
+  
+> [!WARNING]
+>  ガベージ コレクションをブロックのみ通知を発生させてします。  [\<gcConcurrent\>](../../../docs/framework/configure-apps/file-schema/runtime/gcconcurrent-element.md) 構成要素が有効になっている場合、バックグラウンド ガベージ コレクションが通知を発生させません。  
+  
+ 通知が発生したことを判断するには、<xref:System.GC.WaitForFullGCApproach%2A> メソッドおよび <xref:System.GC.WaitForFullGCComplete%2A> メソッドを使用します。  一般に、これらのメソッドを `while` ループ内で使用し、通知の状態を表す <xref:System.GCNotificationStatus> 列挙型を継続的に取得します。  その値が <xref:System.GCNotificationStatus> であれば、以下のいずれかの処理を実行します。  
+  
+-   <xref:System.GC.WaitForFullGCApproach%2A> メソッドで取得した通知を受け、作業負荷をリダイレクトします。ガベージ コレクションを手動で強制的に実行することもできます。  
+  
+-   <xref:System.GC.WaitForFullGCComplete%2A> メソッドで取得した通知を受け、現在のサーバー インスタンスで再度要求を処理できるようにします。  情報を収集することもできます。  たとえば、<xref:System.GC.CollectionCount%2A> メソッドを使用して、ガベージ コレクションの回数を記録できます。  
+  
+ <xref:System.GC.WaitForFullGCApproach%2A> メソッドと <xref:System.GC.WaitForFullGCComplete%2A> メソッドは、連携して動作するように設計されています。  どちらか一方だけを使用すると、結果が不定になります。  
+  
+## フル ガベージ コレクション  
+ ランタイムでフル ガベージ コレクションが発生するのは、以下に示すいくつかのシナリオに該当する場合です。  
+  
+-   十分なメモリがジェネレーション 2 に移動され、次のジェネレーション 2 のガベージ コレクションが発生する場合。  
+  
+-   十分なメモリが、大きいオブジェクトのヒープに移動され、次のジェネレーション 2 のガベージ コレクションが発生する場合。  
+  
+-   その他の要因により、ジェネレーション 1 のガベージ コレクションがジェネレーション 2 のガベージ コレクションに移行する場合。  
+  
+ <xref:System.GC.RegisterForFullGCNotification%2A> メソッドで指定するしきい値は、最初の 2 つのシナリオに該当します。  ただし、最初のシナリオでは、以下の 2 つの理由から、指定したしきい値に比例したタイミングで常に通知を受け取るとは限りません。  
+  
+-   ランタイムは、パフォーマンス上の理由から、小さなオブジェクトの割り当てをチェックしません。  
+  
+-   メモリがジェネレーション 2 に移動されるのは、ジェネレーション 1 のガベージ コレクションが実行された場合だけです。  
+  
+ 3 番目のシナリオも、通知を受け取るタイミングに不確定性が生じる原因になります。  保証されるわけではないものの、この間要求をリダイレクトしたり、都合の良いときに自分でガベージ コレクションを強制的に実行したりして、タイミングの悪いフル ガベージ コレクションの影響を緩和することは有効な方法です。  
+  
+## 通知しきい値パラメーター  
+ <xref:System.GC.RegisterForFullGCNotification%2A> メソッドには、ジェネレーション 2 のオブジェクトと大きなオブジェクトのヒープのしきい値を指定する 2 つのパラメーターがあります。  これらの値を超えると、ガベージ コレクションの通知が発行されます。  次の表でこれらのパラメーターについて説明します。  
+  
+|パラメーター|説明|  
+|------------|--------|  
+|`maxGenerationThreshold`|ジェネレーション 2 に移動されたオブジェクトに基づいて通知を発行するタイミングを指定する、1 ～ 99 の数値。|  
+|`largeObjectHeapThreshold`|大きなオブジェクトのヒープに割り当てられたオブジェクトに基づいて通知を発行するタイミングを指定する、1 ～ 99 の数値。|  
+  
+ 指定した値が大きすぎると、通知を受け取る可能性が高まりますが、ランタイムでガベージ コレクションが実行されるまでに長い時間待つことになります。  ガベージ コレクションを手動で強制的に実行すると、ランタイムでガベージ コレクションが実行される場合よりも多くのオブジェクトが解放されます。  
+  
+ 指定した値が小さすぎると、通知を受け取るのに十分な時間がないうちにガベージ コレクションが実行される可能性があります。  
+  
+## 例  
+  
+### 説明  
+ 次の例では、サーバーのグループが受信した Web 要求を処理します。  要求の処理による作業負荷をシミュレートするため、バイト配列が <xref:System.Collections.Generic.List%601> コレクションに追加されています。  各サーバーはガベージ コレクションの通知を登録し、ユーザー メソッド `WaitForFullGCProc` でスレッドを開始して、<xref:System.GC.WaitForFullGCApproach%2A> メソッドと <xref:System.GC.WaitForFullGCComplete%2A> メソッドで返される <xref:System.GCNotificationStatus> 列挙型を継続的に監視します。  
+  
+ <xref:System.GC.WaitForFullGCApproach%2A> メソッドと <xref:System.GC.WaitForFullGCComplete%2A> メソッドは、通知が発行されると、それぞれのイベント処理用ユーザー メソッドを呼び出します。  
+  
+-   `OnFullGCApproachNotify`  
+  
+     このメソッドはユーザー メソッド `RedirectRequests` を呼び出し、要求をキューに格納するサーバーに対して、このサーバーへの要求の送信を一時停止するよう指示します。  この動作は、それ以上オブジェクトが割り当てられないように、クラスレベル変数 `bAllocate` に `false` を設定することでシミュレートされます。  
+  
+     次に、ユーザー メソッド `FinishExistingRequests` が呼び出され、保留中のサーバー要求の処理を終了します。  この動作は、<xref:System.Collections.Generic.List%601> コレクションをクリアすることでシミュレートされます。  
+  
+     最後に、作業負荷が軽いため、ガベージ コレクションが強制的に実行されます。  
+  
+-   `OnFullGCCompleteNotify`  
+  
+     サーバーがフル ガベージ コレクションの影響を受ける可能性が低くなったため、ユーザー メソッド `AcceptRequests` を呼び出し、要求の受付を再開します。  この動作は、`bAllocate` 変数に `true` を設定し、オブジェクトの <xref:System.Collections.Generic.List%601> コレクションへの追加を再開することでシミュレートされます。  
+  
+ この例の `Main` メソッドのコードを次に示します。  
+  
+ [!code-cpp[GCNotification#2](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#2)]
+ [!code-csharp[GCNotification#2](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#2)]
+ [!code-vb[GCNotification#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#2)]  
+  
+ 次のコードは、ユーザー メソッド `WaitForFullGCProc` のコードであり、ガベージ コレクションの通知を継続的にチェックする while ループが含まれています。  
+  
+ [!code-cpp[GCNotification#8](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#8)]
+ [!code-csharp[GCNotification#8](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#8)]
+ [!code-vb[GCNotification#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#8)]  
+  
+ 次のコードは、`OnFullGCApproachNotify` メソッドのコードです。  
+  
+ `WaitForFullGCProc` メソッド  
+  
+ [!code-cpp[GCNotification#5](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#5)]
+ [!code-csharp[GCNotification#5](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#5)]
+ [!code-vb[GCNotification#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#5)]  
+  
+ 次のコードは、`OnFullGCApproachComplete` メソッドのコードです。  
+  
+ `WaitForFullGCProc` メソッド  
+  
+ [!code-cpp[GCNotification#6](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#6)]
+ [!code-csharp[GCNotification#6](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#6)]
+ [!code-vb[GCNotification#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#6)]  
+  
+ 次のコードは、`OnFullGCApproachNotify` メソッドと `OnFullGCCompleteNotify` メソッドから呼び出されるユーザー メソッドです。  このユーザー メソッドは、要求のリダイレクト、既存の要求の終了、フル ガベージ コレクションの実行後の要求の受け付け再開を実行します。  
+  
+ [!code-cpp[GCNotification#9](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#9)]
+ [!code-csharp[GCNotification#9](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#9)]
+ [!code-vb[GCNotification#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#9)]  
+  
+ コード例全体を次に示します。  
+  
+ [!code-cpp[GCNotification#1](../../../samples/snippets/cpp/VS_Snippets_CLR/GCNotification/cpp/program.cpp#1)]
+ [!code-csharp[GCNotification#1](../../../samples/snippets/csharp/VS_Snippets_CLR/GCNotification/cs/Program.cs#1)]
+ [!code-vb[GCNotification#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/GCNotification/vb/program.vb#1)]  
+  
+## 参照  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/optimization-for-shared-web-hosting.md b/docs/standard/garbage-collection/optimization-for-shared-web-hosting.md
new file mode 100644
index 00000000000..57c5ae10efa
--- /dev/null
+++ b/docs/standard/garbage-collection/optimization-for-shared-web-hosting.md
@@ -0,0 +1,52 @@
+---
+title: "Optimization for Shared Web Hosting | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "garbage collection, Web hosting"
+  - "garbage collection, optimizing"
+  - "garbage collection, shared Web hosting"
+ms.assetid: be98c0ab-7ef8-409f-8a0d-cb6e5b75ff20
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Optimization for Shared Web Hosting
+複数の小さい Web サイトをホストすることで共有されるサーバーを管理する場合は、.NET Framework ディレクトリにある Aspnet.config ファイルの `runtime` ノードに次の `gcTrimCommitOnLowMemory` の設定を追加することで、パフォーマンスを最適化し、サイトの容量を増やすことができます。  
+  
+ `<gcTrimCommitOnLowMemory enabled="true|false"/>`  
+  
+> [!NOTE]
+>  この設定が推奨されるのは、共有 Web ホストのシナリオだけです。  
+  
+ ガベージ コレクターは将来の割り当てのためにメモリを保持しているので、コミットされる領域は、厳密に必要な量より多くなる場合があります。  この領域を減らして、システム メモリに高負荷がかかるときに備えることができます。  このコミットされる領域を少なくすると、パフォーマンスが向上し、より多くのサイトをホストできるようになります。  
+  
+ `gcTrimCommitOnLowMemory` の設定を有効にすると、ガベージ コレクターは、システム メモリの負荷を評価し、負荷が 90% に達するとトリミング モードに移行します。  その後、負荷が 85% 以下に低下するまで、トリミング モードを維持します。  
+  
+ 状況によっては、ガベージ コレクターは `gcTrimCommitOnLowMemory` の設定が現在のアプリケーションに対して効果がないと判断して、設定を無視する場合があります。  
+  
+## 例  
+ 次の XML フラグメントは、`gcTrimCommitOnLowMemory` の設定を有効にする方法を示しています。  省略記号は、`runtime` ノードでの他の設定を示します。  
+  
+```  
+<?xml version="1.0" encoding="UTF-8"?>  
+<configuration>  
+    <runtime>  
+    . . .  
+    <gcTrimCommitOnLowMemory enabled="true"/>  
+    </runtime>  
+    . . .  
+</configuration>  
+```  
+  
+## 参照  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/performance.md b/docs/standard/garbage-collection/performance.md
new file mode 100644
index 00000000000..3e14d1568da
--- /dev/null
+++ b/docs/standard/garbage-collection/performance.md
@@ -0,0 +1,786 @@
+---
+title: "Garbage Collection and Performance | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "garbage collection, troubleshooting"
+  - "garbage collection, performance"
+ms.assetid: c203467b-e95c-4ccf-b30b-953eb3463134
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# Garbage Collection and Performance
+ここでは、ガベージ コレクションおよびメモリ使用に関連する問題について説明します。  マネージ ヒープに関する問題について取り上げ、ガベージ コレクションによるアプリケーションに対する影響を最小限に抑える方法を説明します。  問題を調査するために使用できる手順のリンクを問題ごとに示してあります。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [パフォーマンス分析ツール](#performance_analysis_tools)  
+  
+-   [パフォーマンスに関する問題のトラブルシューティング](#troubleshooting_performance_issues)  
+  
+-   [トラブルシューティングのガイドライン](#troubleshooting_guidelines)  
+  
+-   [パフォーマンス チェックの手順](#performance_check_procedures)  
+  
+<a name="performance_analysis_tools"></a>   
+## パフォーマンス分析ツール  
+ 以下のセクションでは、メモリ使用とガベージ コレクションに関する問題を調査するために使用できるツールについて説明します。  このトピックの後半で説明する[手順](#performance_check_procedures)では、これらのツールを使用します。  
+  
+<a name="perf_counters"></a>   
+### メモリ パフォーマンス カウンター  
+ パフォーマンス カウンターを使用してパフォーマンス データを収集できます。  手順については、「[ランタイム プロファイリング](../../../docs/framework/debug-trace-profile/runtime-profiling.md)」を参照してください。  ガベージ コレクターに関する情報は、.NET CLR Memory カテゴリのパフォーマンス カウンターから提供されます。詳細については、「[.NET Framework のパフォーマンス カウンター](../../../docs/framework/debug-trace-profile/performance-counters.md)」を参照してください。  
+  
+<a name="sos"></a>   
+### SOS キーを使ったデバッグ  
+ [Windows デバッガー \(WinDbg\)](http://go.microsoft.com/fwlink/?LinkId=186482) を使用して、マネージ ヒープのオブジェクトを検査できます。  
+  
+ WinDbg をインストールするには、[WDK および開発者用ツールの Web サイト](http://go.microsoft.com/fwlink/?LinkID=103787)から Windows 用デバッグ ツールをインストールします。  
+  
+<a name="etw"></a>   
+### ガベージ コレクション ETW イベント  
+ Windows イベント トレーシング \(ETW\) は、.NET Framework のプロファイリングとデバッグのサポートを補足するトレース システムです。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、[ガベージ コレクション ETW イベント](../../../docs/framework/performance/garbage-collection-etw-events.md)により、統計的な観点からマネージ ヒープを分析するための有益な情報が得られるようになりました。  たとえば、ガベージ コレクションの発生前に発生する `GCStart_V1` イベントでは、次の情報が提供されます。  
+  
+-   収集されるオブジェクトのジェネレーション  
+  
+-   ガベージ コレクションが発生した理由  
+  
+-   ガベージ コレクションの種類 \(同時実行または非同時実行\)  
+  
+ ETW イベント ログは効率的であり、ガベージ コレクションに関連するパフォーマンスの問題がマスクされることはありません。  ETW イベントと組み合わせてプロセス独自のイベントを提供できます。  ログを記録すると、アプリケーションのイベントとガベージ コレクションのイベントの両方を相互に関連付けて、ヒープの問題がいつどのようにして発生するかを特定できます。  たとえば、サーバー アプリケーションでは、クライアント要求の開始時と終了時にイベントを提供することができます。  
+  
+<a name="profiling_api"></a>   
+### プロファイル API  
+ 共通言語ランタイム \(CLR\) のプロファイル インターフェイスは、ガベージ コレクションの影響を受けたオブジェクトに関する詳細な情報を提供します。  プロファイラーでは、ガベージ コレクションの開始時と終了時に通知を受け取り、  各ジェネレーションにおけるオブジェクトの識別情報など、マネージ ヒープのオブジェクトに関するレポートを提供することができます。  詳細については、「[プロファイルの概要](../../../ocs/framework/unmanaged-api/profiling/profiling-overview.md)」を参照してください。  
+  
+ プロファイラーでは包括的な情報を提供できますが、  複雑なプロファイラーを使用すると、アプリケーションの動作が変更される可能性があります。  
+  
+### アプリケーション ドメインのリソース監視  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、アプリケーション ドメインのリソース監視 \(ARM\) を使用して、ホストでアプリケーション ドメインによる CPU とメモリの使用状況を監視できます。  詳細については、「[Application Domain Resource Monitoring](../../../docs/standard/garbage-collection/app-domain-resource-monitoring.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="troubleshooting_performance_issues"></a>   
+## パフォーマンスに関する問題のトラブルシューティング  
+ まず最初に、[本当にガベージ コレクションの問題なのかどうかを確認します](#IsGC)。  ガベージ コレクションの問題であることがわかったら、次の一覧から問題を選択してトラブルシューティングを行います。  
+  
+-   [メモリ不足の例外がスローされる](#Issue_OOM)  
+  
+-   [プロセスによるメモリ使用量が多すぎる](#Issue_TooMuchMemory)  
+  
+-   [ガベージ コレクターによるオブジェクトの解放に時間がかかる](#Issue_NotFastEnough)  
+  
+-   [マネージ ヒープが過度に断片化される](#Issue_Fragmentation)  
+  
+-   [ガベージ コレクションの一時停止が長すぎる](#Issue_LongPauses)  
+  
+-   [ジェネレーション 0 が大きすぎる](#Issue_Gen0)  
+  
+-   [ガベージ コレクションの実行時の CPU 使用率が高すぎる](#Issue_HighCPU)  
+  
+<a name="Issue_OOM"></a>   
+### 問題: メモリ不足の例外がスローされる  
+ <xref:System.OutOfMemoryException> マネージ例外がスローされる正当な状況としては、次の 2 つがあります。  
+  
+-   仮想メモリが不足している。  
+  
+     ガベージ コレクターは、サイズがあらかじめ決められたセグメント単位でシステムのメモリを割り当てます。  割り当てで追加のセグメントが必要になっとときに、プロセスの仮想メモリ空間に連続する空きブロックが残っていなければ、マネージ ヒープの割り当ては失敗します。  
+  
+-   十分な物理メモリを確保できない。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[メモリ不足の例外がマネージ例外かどうかを確認する。](#OOMIsManaged)<br /><br /> [予約できる仮想メモリの量を確認する。](#GetVM)<br /><br /> [十分な物理メモリがあるかどうかを確認する。](#Physical)|  
+  
+ 例外が正当なものでないと判断した場合は、マイクロソフト カスタマー サポート サービスにお問い合わせください。その際、次の情報をご連絡ください。  
+  
+-   メモリ不足のマネージ例外を含む履歴  
+  
+-   完全なメモリ ダンプ  
+  
+-   メモリ不足の例外が正当なものでないことを証明するデータ \(仮想メモリまたは物理メモリに問題がないことを示すデータなど\)  
+  
+<a name="Issue_TooMuchMemory"></a>   
+### 問題: プロセスによるメモリ使用量が多すぎる  
+ 一般的な前提として、メモリ使用量が多すぎる場合については、Windows タスク マネージャーの **\[パフォーマンス\]** タブのメモリ使用量の表示で確認できます。  ただし、この表示はワーキング セットに関するもので、仮想メモリの使用量に関する情報ではありません。  
+  
+ マネージ ヒープが原因であると判断した場合は、一定の期間にわたってマネージ ヒープを測定し、パターンを確認する必要があります。  
+  
+ マネージ ヒープが原因でないと判断した場合は、ネイティブ デバッグを使用する必要があります。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[予約できる仮想メモリの量を確認する。](#GetVM)<br /><br /> [マネージ ヒープでコミットしているメモリの量を確認する。](#ManagedHeapCommit)<br /><br /> [マネージ ヒープで予約されているメモリの量を確認する。](#ManagedHeapReserve)<br /><br /> [ジェネレーション 2 の大きいオブジェクトを確認する。](#ExamineGen2)<br /><br /> [オブジェクトへの参照を確認する。](#ObjRef)|  
+  
+<a name="Issue_NotFastEnough"></a>   
+### 問題: ガベージ コレクターによるオブジェクトの解放に時間がかかる  
+ ガベージ コレクションでオブジェクトが通常どおりに解放されていないように見える場合は、それらのオブジェクトに対する強い参照がないかどうかを確認する必要があります。  
+  
+ この問題は、死んだ状態のオブジェクトを含むジェネレーションに対してガベージ コレクションが行われていない場合にも発生します。死んだ状態のオブジェクトは、そのオブジェクトのファイナライザーが実行されていないことを示します。  たとえば、シングルスレッド アパートメント \(STA\) のアプリケーションを実行している場合に、ファイナライザー キューを処理するスレッドがファイナライザーの呼び出しに失敗すると、この状態になる可能性があります。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[オブジェクトへの参照を確認する。](#ObjRef)<br /><br /> [ファイナライザーが実行されたかどうかを確認する。](#Induce)<br /><br /> [終了待機中のオブジェクトがないかどうかを確認する。](#Finalize)|  
+  
+<a name="Issue_Fragmentation"></a>   
+### 問題: マネージ ヒープが過度に断片化される  
+ 断片化レベルは、ジェネレーションに割り当てられたメモリの合計に占める空き領域の割合として計算されます。  ジェネレーション 2 の場合、許容される断片化レベルは 20% 以下です。  ジェネレーション 2 は非常に大きくなる可能性があるため、断片化の割合の方が絶対値より重要になります。  
+  
+ ジェネレーション 0 は、新しいオブジェクトが割り当てられるジェネレーションなので、空き領域が多くても問題はありません。  
+  
+ 断片化は常に大きなオブジェクト ヒープで発生します。大きなオブジェクト ヒープは圧縮されないからです。  隣接する空きオブジェクトは、大きなオブジェクトの割り当て要求を満たすために必然的に 1 つの領域にまとめられます。  
+  
+ 断片化が問題になるのは、ジェネレーション 1 とジェネレーション 2 です。  これらのジェネレーションで、ガベージ コレクションの終了後に大量の空き領域ある場合は、アプリケーションのオブジェクトの使用方法を変更する必要がある可能性があります。長期間のオブジェクトの有効期間を再評価することを検討してください。  
+  
+ オブジェクトの固定が過度に行われていると断片化レベルが高くなることがあります。  断片化レベルが高い場合は、固定されているオブジェクトが多すぎる可能性があります。  
+  
+ 仮想メモリの断片化によってガベージ コレクターがセグメントを追加できなくなっている場合、次のような原因が考えられます。  
+  
+-   多数の小さなアセンブリの読み込みとアンロードが頻繁に行われている。  
+  
+-   アンマネージ コードとの相互運用時に保持される COM オブジェクトへの参照が多すぎる。  
+  
+-   大きな一時オブジェクトが作成されているために、大きなオブジェクト ヒープでヒープ セグメントの割り当てと解放が頻繁に行われている。  
+  
+     アプリケーションで CLR をホストする際には、セグメントを保持するようにガベージ コレクターに要求することができます。  これにより、セグメント割り当ての頻度が減少します。  そのためには、[STARTUP\_FLAGS 列挙型](../../../ocs/framework/unmanaged-api/hosting/startup-flags-enumeration.md) の STARTUP\_HOARD\_GC\_VM フラグを使用します。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[マネージ ヒープの空き領域の容量を確認する。](#Fragmented)<br /><br /> [固定されたオブジェクトの数を確認する。](#Pinned)|  
+  
+ 正当な理由もないのに断片化が発生していると思われる場合は、マイクロソフト カスタマー サポート サービスにお問い合わせください。  
+  
+<a name="Issue_LongPauses"></a>   
+### 問題: ガベージ コレクションの一時停止が長すぎる  
+ ガベージ コレクションはソフト リアルタイムで動作するため、アプリケーションはある程度の一時停止に耐えられなければなりません。  ソフト リアルタイムの基準では、95% の操作が時間どおりに完了する必要があります。  
+  
+ 同時実行ガベージ コレクションでは、コレクションの実行中もマネージ スレッドを実行できるため、一時停止は最小限に抑えられます。  
+  
+ 短期ガベージ コレクション \(ジェネレーション 0 および 1\) は数ミリ秒しかかからないため、一般に一時停止を減らすことは不可能です。  一方、ジェネレーション 2 のコレクションでは、アプリケーションによる割り当て要求のパターンを変更することによって一時停止を減らすことができます。  
+  
+ より正確な方法として、[ガベージ コレクション ETW イベント](../../../docs/framework/performance/garbage-collection-etw-events.md)を使用することもできます。  一連のイベントにタイム スタンプを追加して区別することにより、コレクションのタイミングを特定できます。  コレクションのシーケンス全体には、実行エンジンの中断、ガベージ コレクション自体、および実行エンジンの再開が含まれます。  
+  
+ [Garbage Collection Notifications](../../../docs/standard/garbage-collection/notifications.md)を使用すると、サーバーでジェネレーション 2 のコレクションが発生しそうかどうか、要求を別のサーバーに再ルーティングすることで一時停止の問題を緩和できるかどうかを確認できます。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[ガベージ コレクションの継続時間を確認する。](#TimeInGC)<br /><br /> [ガベージ コレクションが発生した原因を確認する。](#Triggered)|  
+  
+<a name="Issue_Gen0"></a>   
+### 問題: ジェネレーション 0 が大きすぎる  
+ 64 ビット システムでは、ジェネレーション 0 のオブジェクトの数が増える傾向があります。ワークステーションのガベージ コレクションではなくサーバーのガベージ コレクションを使用している場合は特にその傾向が強くなります。  それらの環境では、ジェネレーション 0 のガベージ コレクションをトリガーするしきい値が高いので、ジェネレーション 0 のコレクションが非常に大きくなる可能性があるためです。  アプリケーションで、ガベージ コレクションがトリガーされる前により多くのメモリを割り当てると、パフォーマンスが向上します。  
+  
+<a name="Issue_HighCPU"></a>   
+### 問題: ガベージ コレクションの実行時の CPU 使用率が高すぎる  
+ ガベージ コレクションの実行時には CPU 使用率が高くなります。  ガベージ コレクションに大量の処理時間が費やされている場合は、コレクションの発生頻度が高すぎるか、コレクションの継続時間が長すぎます。  マネージ ヒープに対するオブジェクトの割り当ての速度を上げるとガベージ コレクションの発生頻度が高くなります。  割り当ての速度を下げるとガベージ コレクションの発生頻度が低くなります。  
+  
+ 割り当ての速度を監視するには、`Allocated Bytes/second` パフォーマンス カウンターを使用します。  詳細については、「[.NET Framework のパフォーマンス カウンター](../../../docs/framework/debug-trace-profile/performance-counters.md)」を参照してください。  
+  
+ コレクションの継続時間は、主に、割り当て後に残ったオブジェクトの数によって決まります。  コレクションの対象となるオブジェクトが数多く残っていると、ガベージ コレクターが大量のメモリを処理しなければならなくなります。  残存オブジェクトの圧縮には時間がかかります。  コレクションの実行中に処理されたオブジェクトの数を確認するには、デバッガーで特定のジェネレーションのガベージ コレクションの終了時にブレークポイントを設定します。  
+  
+|パフォーマンス チェック|  
+|------------------|  
+|[CPU の使用率が高いのはガベージ コレクションのためかどうかを確認する。](#HighCPU)<br /><br /> [ガベージ コレクションの終了時にブレークポイントを設定する。](#GenBreak)|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="troubleshooting_guidelines"></a>   
+## トラブルシューティングのガイドライン  
+ ここでは、調査を開始するときに考慮する必要があるガイドラインについて説明します。  
+  
+### ワークステーションのガベージ コレクションかサーバーのガベージ コレクションか  
+ 使用しているガベージ コレクションの種類が正しいかどうかを確認します。  アプリケーションで複数のスレッドおよびオブジェクト インスタンスを使用する場合は、ワークステーションのガベージ コレクションではなくサーバーのガベージ コレクションを使用します。  サーバーのガベージ コレクションは複数のスレッドで動作しますが、ワークステーションのガベージ コレクションでは、アプリケーションの複数のインスタンスでそれぞれ専用のガベージ コレクション スレッドを実行する必要があるため、CPU 時間の競合が発生します。  
+  
+ 負荷が低く、バックグラウンドでタスクを実行することの少ないアプリケーション \(サービスなど\) では、同時実行ガベージ コレクションを無効にしてワークステーションのガベージ コレクションを使用できます。  
+  
+### いつマネージ ヒープのサイズを測定するか  
+ プロファイラーを使用しない場合、パフォーマンスの問題を効果的に診断するには、一貫した測定パターンを確立する必要があります。  スケジュールを確立する際の考慮事項を以下に示します。  
+  
+-   ジェネレーション 2 のガベージ コレクションの後に測定する場合は、マネージ ヒープ全体からガベージ \(死んだ状態のオブジェクト\) がなくなっています。  
+  
+-   ジェネレーション 0 のガベージ コレクションの直後に測定する場合は、ジェネレーション 1 と 2 のオブジェクトのコレクションはまだ行われていません。  
+  
+-   ガベージ コレクションの直前に測定する場合は、どのくらいの割り当てが行われるとガベージ コレクションが開始されるのかが測定されます。  
+  
+-   ガベージ コレクションの実行中に測定するのには問題があります。ガベージ コレクターのデータ構造が走査可能な状態になっていないので、完全な結果が得られない可能性があるためです。  これは仕様に基づく制限事項です。  
+  
+-   同時実行ガベージ コレクションを有効にしてワークステーションのガベージ コレクションを使用している場合は、解放されたオブジェクトが圧縮されないため、ヒープ サイズが変わらなかったり大きくなっていたりすることがあります \(断片化のために大きく見えることがあります\)。  
+  
+-   ジェネレーション 2 の同時実行ガベージ コレクションは、物理メモリの負荷が高すぎると延期されます。  
+  
+ マネージ ヒープを測定するためのブレークポイントを設定する方法を以下に示します。  
+  
+<a name="GenBreak"></a>   
+##### ガベージ コレクションの終了時にブレークポイントを設定するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg で、次のコマンドを入力します。  
+  
+     **bp mscorwks\!WKS::GCHeap::RestartEE "j \(dwo\(mscorwks\!WKS::GCHeap::GcCondemnedGeneration\)\=\=2\) 'kb';'g'"**  
+  
+     **GcCondemnedGeneration** は、目的のジェネレーションに設定します。  このコマンドにはプライベート シンボルが必要です。  
+  
+     これにより、ジェネレーション 2 のオブジェクトがガベージ コレクションのために解放された後に **RestartEE** が実行されると、実行が中断されます。  
+  
+     サーバーのガベージ コレクションでは、**RestartEE** を呼び出すスレッドは 1 つだけなので、ジェネレーション 2 のガベージ コレクションの実行中に 1 回だけブレークポイントが発生します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="performance_check_procedures"></a>   
+## パフォーマンス チェックの手順  
+ ここでは、パフォーマンスの問題の原因を切り分けるための以下の手順について説明します。  
+  
+-   [問題の原因がガベージ コレクションにあるかどうかを確認する。](#IsGC)  
+  
+-   [メモリ不足の例外がマネージ例外かどうかを確認する。](#OOMIsManaged)  
+  
+-   [予約できる仮想メモリの量を確認する。](#GetVM)  
+  
+-   [十分な物理メモリがあるかどうかを確認する。](#Physical)  
+  
+-   [マネージ ヒープでコミットしているメモリの量を確認する。](#ManagedHeapCommit)  
+  
+-   [マネージ ヒープで予約されているメモリの量を確認する。](#ManagedHeapReserve)  
+  
+-   [ジェネレーション 2 の大きいオブジェクトを確認する。](#ExamineGen2)  
+  
+-   [オブジェクトへの参照を確認する。](#ObjRef)  
+  
+-   [ファイナライザーが実行されたかどうかを確認する。](#Induce)  
+  
+-   [終了待機中のオブジェクトがないかどうかを確認する。](#Finalize)  
+  
+-   [マネージ ヒープの空き領域の容量を確認する。](#Fragmented)  
+  
+-   [固定されたオブジェクトの数を確認する。](#Pinned)  
+  
+-   [ガベージ コレクションの継続時間を確認する。](#TimeInGC)  
+  
+-   [ガベージ コレクションが発生した原因を確認する。](#Triggered)  
+  
+-   [CPU の使用率が高いのはガベージ コレクションのためかどうかを確認する。](#HighCPU)  
+  
+<a name="IsGC"></a>   
+##### 問題の原因がガベージ コレクションにあるかどうかを確認するには  
+  
+-   次の 2 つのメモリ パフォーマンス カウンターを調べます。  
+  
+    -   **% Time in GC**。  前回のガベージ コレクション サイクルの後にガベージ コレクションの実行に費やされた経過時間の割合を表示します。  このカウンターを使用すると、ガベージ コレクターがマネージ ヒープの領域を確保するために費やしている時間が長すぎないかどうかを確認できます。  ガベージ コレクションに費やされている時間が比較的短い場合は、マネージ ヒープ以外のリソースに問題があると考えられます。  このカウンターは、同時実行ガベージ コレクションやバックグラウンド ガベージ コレクションでは正確な値が得られない可能性があります。  
+  
+    -   **\# Total committed Bytes**。  ガベージ コレクターによって現在コミットされている仮想メモリの量を表示します。  このカウンターを使用すると、アプリケーションが使用しているメモリのうちガベージ コレクターによって消費されているメモリが多すぎないかどうかを確認できます。  
+  
+     ほとんどのメモリ パフォーマンス カウンターは、各ガベージ コレクションの終了時に更新されます。  そのため、情報を得ようとしている時点の状態が反映されていない場合もあります。  
+  
+<a name="OOMIsManaged"></a>   
+##### メモリ不足の例外がマネージ例外かどうかを確認するには  
+  
+1.  SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、**pe** \(print exception\) コマンドを入力します。  
+  
+     **\!pe**  
+  
+     マネージ例外の場合は、次の例のように、<xref:System.OutOfMemoryException> が例外の種類として表示されます。  
+  
+    ```  
+    Exception object: 39594518  
+    Exception type: System.OutOfMemoryException  
+    Message: <none>  
+    InnerException: <none>  
+    StackTrace (generated):  
+    ```  
+  
+2.  出力に例外が明記されていない場合は、メモリ不足の例外が発生したスレッドを特定する必要があります。  デバッガーで次のコマンドを入力して、すべてのスレッドとその呼び出し履歴を表示します。  
+  
+     **~\*kb**  
+  
+     履歴に例外の呼び出しが含まれているスレッドは、`RaiseTheException` 引数によって示されます。  これはマネージ例外オブジェクトです。  
+  
+    ```  
+    28adfb44 7923918f 5b61f2b4 00000000 5b61f2b4 mscorwks!RaiseTheException+0xa0   
+    ```  
+  
+3.  次のコマンドを使用して、入れ子になった例外をダンプします。  
+  
+     **\!pe \-nested**  
+  
+     例外が見つからない場合、そのメモリ不足の例外は、アンマネージ コードで発生した例外です。  
+  
+<a name="GetVM"></a>   
+##### 予約できる仮想メモリの量を確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg で次のコマンドを入力して、最も大きな空き領域を取得します。  
+  
+     **\!address \-summary**  
+  
+     次の例のように、最も大きな空き領域が表示されます。  
+  
+    ```  
+    Largest free region: Base 54000000 - Size 0003A980  
+    ```  
+  
+     この例では、最も大きな空き領域のサイズは約 24000 KB \(16 進形式では 3A980\) です。  これは、ガベージ コレクターのセグメントに必要なサイズよりはるかに小さいサイズです。  
+  
+     または  
+  
+-   **vmstat** コマンドを使用します。  
+  
+     **\!vmstat**  
+  
+     MAXIMUM 列の最大値が最も大きな空き領域です。以下に例を示します。  
+  
+    ```  
+    TYPE        MINIMUM   MAXIMUM     AVERAGE   BLK COUNT   TOTAL  
+    ~~~~        ~~~~~~~   ~~~~~~~     ~~~~~~~   ~~~~~~~~~~  ~~~~  
+    Free:  
+    Small       8K        64K         46K       36          1,671K  
+    Medium      80K       864K        349K      3           1,047K  
+    Large       1,384K    1,278,848K  151,834K  12          1,822,015K  
+    Summary     8K        1,278,848K  35,779K   51          1,824,735K  
+    ```  
+  
+<a name="Physical"></a>   
+##### 十分な物理メモリがあるかどうかを確認するには  
+  
+1.  Windows タスク マネージャーを起動します。  
+  
+2.  **\[パフォーマンス\]** タブで、コミットの値を確認します   \(Windows 7 では **\[システム\]** の **\[コミット \(KB\)\]**\)。  
+  
+     **\[合計\]** が **\[制限値\]** に近い場合は、物理メモリが不足しています。  
+  
+<a name="ManagedHeapCommit"></a>   
+##### マネージ ヒープでコミットしているメモリの量を確認するには  
+  
+-   マネージ ヒープでコミットしているバイト数を確認するには、`# Total committed bytes` メモリ パフォーマンス カウンターを使用します。  ガベージ コレクターは、セグメントのチャンクを必要に応じてコミットします。すべてを同時にコミットするのではありません。  
+  
+    > [!NOTE]
+    >  `# Bytes in all Heaps` パフォーマンス カウンターは使用しないでください。このパフォーマンス カウンターによって表されるのは、マネージ ヒープの実際のメモリ使用量ではありません。  この値にはジェネレーションのサイズが含まれますが、それは、実質的にはジェネレーションのしきい値 \(ジェネレーションがオブジェクトでいっぱいになった場合にガベージ コレクションが発生するサイズ\) です。  したがって、この値は、通常は 0 になります。  
+  
+<a name="ManagedHeapReserve"></a>   
+##### マネージ ヒープで予約されているメモリの量を確認するには  
+  
+-   `# Total reserved bytes` メモリ パフォーマンス カウンターを使用します。  
+  
+     ガベージ コレクターはメモリをセグメント単位で予約します。セグメントの開始位置を特定するには **eeheap** コマンドを使用します。  
+  
+    > [!IMPORTANT]
+    >  ガベージ コレクターが各セグメントに割り当てるメモリ量を判別することは可能ですが、セグメント サイズは実装に固有であり、定期的な更新プログラムによる場合を含め、いつでも変更されることがあります。  アプリでは、セグメント サイズを推測することや、特定のセグメント サイズに依存することを絶対に避けてください。また、セグメントの割り当てに使用可能なメモリの量を構成しようとしてもなりません。  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、次のコマンドを入力します。  
+  
+     **\!eeheap \-gc**  
+  
+     この結果は次のようになります。  
+  
+    ```  
+    Number of GC Heaps: 2  
+    ------------------------------  
+    Heap 0 (002db550)  
+    generation 0 starts at 0x02abe29c  
+    generation 1 starts at 0x02abdd08  
+    generation 2 starts at 0x02ab0038  
+    ephemeral segment allocation context: none  
+     segment    begin allocated     size  
+    02ab0000 02ab0038  02aceff4 0x0001efbc(126908)  
+    Large object heap starts at 0x0aab0038  
+     segment    begin allocated     size  
+    0aab0000 0aab0038  0aab2278 0x00002240(8768)  
+    Heap Size   0x211fc(135676)  
+    ------------------------------  
+    Heap 1 (002dc958)  
+    generation 0 starts at 0x06ab1bd8  
+    generation 1 starts at 0x06ab1bcc  
+    generation 2 starts at 0x06ab0038  
+    ephemeral segment allocation context: none  
+     segment    begin allocated     size  
+    06ab0000 06ab0038  06ab3be4 0x00003bac(15276)  
+    Large object heap starts at 0x0cab0038  
+     segment    begin allocated     size  
+    0cab0000 0cab0038  0cab0048 0x00000010(16)  
+    Heap Size    0x3bbc(15292)  
+    ------------------------------  
+    GC Heap Size   0x24db8(150968)  
+    ```  
+  
+     "segment" によって示されるアドレスがセグメントの開始アドレスです。  
+  
+<a name="ExamineGen2"></a>   
+##### ジェネレーション 2 の大きいオブジェクトを確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、次のコマンドを入力します。  
+  
+     **\!dumpheap –stat**  
+  
+     **dumpheap** は、マネージ ヒープが大きいと完了までにしばらくかかります。  
+  
+     最も多くの領域を使用しているオブジェクトは出力の最後の数行に表示されるため、そこを分析します。  次に例を示します。  
+  
+    ```  
+    2c6108d4   173712     14591808 DevExpress.XtraGrid.Views.Grid.ViewInfo.GridCellInfo  
+    00155f80      533     15216804      Free  
+    7a747c78   791070     15821400 System.Collections.Specialized.ListDictionary+DictionaryNode  
+    7a747bac   700930     19626040 System.Collections.Specialized.ListDictionary  
+    2c64e36c    78644     20762016 DevExpress.XtraEditors.ViewInfo.TextEditViewInfo  
+    79124228   121143     29064120 System.Object[]  
+    035f0ee4    81626     35588936 Toolkit.TlkOrder  
+    00fcae40     6193     44911636 WaveBasedStrategy.Tick_Snap[]  
+    791242ec    40182     90664128 System.Collections.Hashtable+bucket[]  
+    790fa3e0  3154024    137881448 System.String  
+    Total 8454945 objects  
+    ```  
+  
+     最後の行のオブジェクトは文字列で、最も多くの領域を占有しています。  したがって、アプリケーションで文字列オブジェクトを最適化する方法を調べます。  サイズが 150 ～ 200 バイトの文字列を表示するには、次のコマンドを入力します。  
+  
+     **\!dumpheap \-type System.String \-min 150 \-max 200**  
+  
+     結果の例を次に示します。  
+  
+    ```  
+    Address  MT           Size  Gen  
+    1875d2c0 790fa3e0      152    2 System.String HighlightNullStyle_Blotter_PendingOrder-11_Blotter_PendingOrder-11  
+    …  
+    ```  
+  
+     ID に文字列の代わりに整数を使用すると、効率を改善できます。  同じ文字列が何千回も繰り返し使用されている場合は、文字列インターンの使用を検討します。  文字列インターンの詳細については、<xref:System.String.Intern%2A?displayProperty=fullName> メソッドのリファレンス トピックを参照してください。  
+  
+<a name="ObjRef"></a>   
+##### オブジェクトへの参照を確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg で次のコマンドを入力して、オブジェクトへの参照を表示します。  
+  
+     **\!gcroot**  
+  
+     `-or-`  
+  
+-   特定のオブジェクトの参照を確認するには、アドレスを含めます。  
+  
+     **\!gcroot 1c37b2ac**  
+  
+     履歴で見つかるルートは誤検出である可能性があります。  詳細については、コマンド `!help gcroot` を使用してください。  
+  
+    ```  
+    ebx:Root:19011c5c(System.Windows.Forms.Application+ThreadContext)->  
+    19010b78(DemoApp.FormDemoApp)->  
+    19011158(System.Windows.Forms.PropertyStore)->  
+    … [omitted]  
+    1c3745ec(System.Data.DataTable)->  
+    1c3747a8(System.Data.DataColumnCollection)->  
+    1c3747f8(System.Collections.Hashtable)->  
+    1c376590(System.Collections.Hashtable+bucket[])->  
+    1c376c98(System.Data.DataColumn)->  
+    1c37b270(System.Data.Common.DoubleStorage)->  
+    1c37b2ac(System.Double[])  
+    Scan Thread 0 OSTHread 99c  
+    Scan Thread 6 OSTHread 484  
+    ```  
+  
+     **gcroot** コマンドは、完了までに時間がかかることがあります。  ガベージ コレクションによって解放されないオブジェクトはライブ オブジェクトです。  したがって、そのオブジェクトを直接的または間接的に参照しているルートがあるため、**gcroot** でそのオブジェクトへのパス情報が返されます。  返されたグラフを調べて、それらのオブジェクトがまだ参照されている理由を確認する必要があります。  
+  
+<a name="Induce"></a>   
+##### ファイナライザーが実行されたかどうかを確認するには  
+  
+-   次のコードを含むテスト プログラムを実行します。  
+  
+    ```  
+    GC.Collect();  
+    GC.WaitForPendingFinalizers();  
+    GC.Collect();  
+    ```  
+  
+     このテストで問題が解決される場合は、ファイナライザーが実行されていないためにガベージ コレクターによって解放されないオブジェクトがあったことになります。  <xref:System.GC.WaitForPendingFinalizers%2A?displayProperty=fullName> メソッドを使用すると、ファイナライザーがタスクを完了できるようになるため、問題が解決されます。  
+  
+<a name="Finalize"></a>   
+##### 終了待機中のオブジェクトがないかどうかを確認するには  
+  
+1.  SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、次のコマンドを入力します。  
+  
+     **\!finalizequeue**  
+  
+     終了準備が完了しているオブジェクトの数を確認します。  その数が多い場合は、それらのファイナライザーが実行されない理由、または実行が遅れている理由を調べる必要があります。  
+  
+2.  スレッドの出力を取得するには、次のコマンドを入力します。  
+  
+     **threads \-special**  
+  
+     次のような出力が表示されます。  
+  
+    ```  
+       OSID     Special thread type  
+    2    cd0    DbgHelper   
+    3    c18    Finalizer   
+    4    df0    GC SuspendEE   
+    ```  
+  
+     ファイナライザー スレッドは、現在実行されているファイナライザーを示します \(存在する場合\)。  実行中のファイナライザー スレッドが存在しない場合は、処理の開始を通知するイベントを待機しています。  ファイナライザー スレッドは、ほとんどの場合この状態にあります。THREAD\_HIGHEST\_PRIORITY で実行されるので、実行するファイナライザーがあればすぐに実行されるためです。  
+  
+<a name="Fragmented"></a>   
+##### マネージ ヒープの空き領域の容量を確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、次のコマンドを入力します。  
+  
+     **\!dumpheap \-type Free \-stat**  
+  
+     このコマンドは、次の例に示すように、マネージ ヒープのすべての空きオブジェクトの合計サイズを表示します。  
+  
+    ```  
+    total 230 objects  
+    Statistics:  
+          MT    Count    TotalSize Class Name  
+    00152b18      230     40958584      Free  
+    Total 230 objects  
+    ```  
+  
+-   ジェネレーション 0 の空き領域を確認するには、次のコマンドを入力して、ジェネレーション別のメモリ消費情報を表示します。  
+  
+     **\!eeheap \-gc**  
+  
+     次のような出力が表示されます。  最後の行には短期セグメントが表示されています。  
+  
+    ```  
+    Heap 0 (0015ad08)  
+    generation 0 starts at 0x49521f8c  
+    generation 1 starts at 0x494d7f64  
+    generation 2 starts at 0x007f0038  
+    ephemeral segment allocation context: none  
+    segment  begin     allocated  size  
+    00178250 7a80d84c  7a82f1cc   0x00021980(137600)  
+    00161918 78c50e40  78c7056c   0x0001f72c(128812)  
+    007f0000 007f0038  047eed28   0x03ffecf0(67103984)  
+    3a120000 3a120038  3a3e84f8   0x002c84c0(2917568)  
+    46120000 46120038  49e05d04   0x03ce5ccc(63855820)  
+    ```  
+  
+-   ジェネレーション 0 によって使用されている領域を計算します。  
+  
+     **?  49e05d04\-0x49521f8c**  
+  
+     この結果は次のようになります。  ジェネレーション 0 は約 9 MB です。  
+  
+    ```  
+    Evaluate expression: 9321848 = 008e3d78  
+    ```  
+  
+-   次のコマンドは、ジェネレーション 0 の範囲にある空き領域をダンプします。  
+  
+     **\!dumpheap \-type Free \-stat 0x49521f8c 49e05d04**  
+  
+     この結果は次のようになります。  
+  
+    ```  
+    ------------------------------  
+    Heap 0  
+    total 409 objects  
+    ------------------------------  
+    Heap 1  
+    total 0 objects  
+    ------------------------------  
+    Heap 2  
+    total 0 objects  
+    ------------------------------  
+    Heap 3  
+    total 0 objects  
+    ------------------------------  
+    total 409 objects  
+    Statistics:  
+          MT    Count TotalSize Class Name  
+    0015a498      409   7296540      Free  
+    Total 409 objects  
+    ```  
+  
+     この出力は、ヒープのジェネレーション 0 の部分で 9 MB の領域がオブジェクトに使用されていて、7 MB が空いていることを示しています。  この分析から、ジェネレーション 0 がどの程度断片化に関与しているのかがわかります。  この分のヒープ使用量は、長期間のオブジェクトによる断片化の原因となる合計容量から除外する必要があります。  
+  
+<a name="Pinned"></a>   
+##### 固定されたオブジェクトの数を確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで、次のコマンドを入力します。  
+  
+     **\!gchandles**  
+  
+     次の例に示すように、固定ハンドルの数を含む統計情報が表示されます。  
+  
+    ```  
+    GC Handle Statistics:  
+    Strong Handles:      29  
+    Pinned Handles:      10  
+    ```  
+  
+<a name="TimeInGC"></a>   
+##### ガベージ コレクションの継続時間を確認するには  
+  
+-   `% Time in GC` メモリ パフォーマンス カウンターを調べます。  
+  
+     この値は、サンプル間隔の時間を使用して計算します。  このカウンターは各ガベージ コレクションの終了時に更新されるため、サンプル間隔の間にコレクションが発生しなかった場合は前のサンプルと同じ値になります。  
+  
+     コレクションの時間は、サンプル間隔の時間にパーセント値を掛けて計算します。  
+  
+     次のデータには 4 つのサンプリング間隔が示されています。サンプリング間隔の時間は 2 秒で、8 秒間にわたって調査が行われています。  `Gen0`、`Gen1`、`Gen2` の各列には、そのジェネレーションでその間隔の間に発生したガベージ コレクションの番号が表示されています。  
+  
+    ```  
+    Interval    Gen0    Gen1    Gen2    % Time in GC  
+           1       9       3       1              10  
+           2      10       3       1               1  
+           3      11       3       1               3  
+           4      11       3       1               3  
+    ```  
+  
+     この情報からは、ガベージ コレクションが発生した時間はわかりませんが、特定の時間間隔の間に発生したガベージ コレクションの番号を特定できます。  最悪のケースでは、ジェネレーション 0 の 10 番目のガベージ コレクションが間隔 2 の開始時に終了し、ジェネレーション 0 の 11 番目のガベージ コレクションが間隔 5 の終了時に終了したことになります。  10 番目のガベージ コレクションが終了してから 11 番目のガベージ コレクションが終了するまでの時間は約 2 秒で、パフォーマンス カウンターの値は 3% になっているため、ジェネレーション 0 の 11 番目のガベージ コレクションの継続時間は 60 ミリ秒 \(2 秒 \* 3%\) になります。  
+  
+     次の例には 5 つの間隔があります。  
+  
+    ```  
+    Interval    Gen0    Gen1    Gen2     % Time in GC  
+           1       9       3       1                3  
+           2      10       3       1                1  
+           3      11       4       2                1  
+           4      11       4       2                1  
+           5      11       4       2               20  
+    ```  
+  
+     ジェネレーション 2 の 2 番目のガベージ コレクションは、間隔 3 の間に開始され、間隔 5 で終了しています。  最悪のケースでは、このガベージ コレクションの前のガベージ コレクションは、間隔 2 の開始時に終了したジェネレーション 0 のコレクションで、このジェネレーション 2 のガベージ コレクション自体は、間隔 5 の終了時に終了したことになります。  したがって、そのジェネレーション 0 のガベージ コレクションが終了してからこのジェネレーション 2 のガベージ コレクションが終了するまでの時間は 4 秒になります。  `% Time in GC` カウンターの値は 20% なので、このジェネレーション 2 のガベージ コレクションの継続時間は最大で 800 ミリ秒 \(4 秒 \* 20%\) になります。  
+  
+-   [ガベージ コレクション ETW イベント](../../../docs/framework/performance/garbage-collection-etw-events.md)を使用してガベージ コレクションの長さを確認し、その情報を分析してガベージ コレクションの継続時間を特定することもできます。  
+  
+     たとえば、次のデータは、非同時実行ガベージ コレクションの実行中に発生したイベント シーケンスを示しています。  
+  
+    ```  
+    Timestamp    Event name  
+    513052        GCSuspendEEBegin_V1  
+    513078        GCSuspendEEEnd  
+    513090        GCStart_V1  
+    517890        GCEnd_V1  
+    517894        GCHeapStats  
+    517897        GCRestartEEBegin  
+    517918        GCRestartEEEnd  
+    ```  
+  
+     マネージ スレッドの中断に 26 マイクロ秒かかっています \(`GCSuspendEEEnd` – `GCSuspendEEBegin_V1`\)。  
+  
+     実際のガベージ コレクションに 4.8 ミリ秒かかっています \(`GCEnd_V1` – `GCStart_V1`\)。  
+  
+     マネージ スレッドの再開に 21 マイクロ秒かかっています \(`GCRestartEEEnd` – `GCRestartEEBegin`\)。  
+  
+     次の例は、バックグラウンド ガベージ コレクションの出力を示しています。この出力には、process、thread、および event field が含まれています   \(すべてのデータが示されているわけではありません\)。  
+  
+    ```  
+    timestamp(us)    event name            process    thread    event field  
+    42504385        GCSuspendEEBegin_V1    Test.exe    4372             1  
+    42504648        GCSuspendEEEnd         Test.exe    4372          
+    42504816        GCStart_V1             Test.exe    4372        102019  
+    42504907        GCStart_V1             Test.exe    4372        102020  
+    42514170        GCEnd_V1               Test.exe    4372          
+    42514204        GCHeapStats            Test.exe    4372        102020  
+    42832052        GCRestartEEBegin       Test.exe    4372          
+    42832136        GCRestartEEEnd         Test.exe    4372          
+    63685394        GCSuspendEEBegin_V1    Test.exe    4744             6  
+    63686347        GCSuspendEEEnd         Test.exe    4744          
+    63784294        GCRestartEEBegin       Test.exe    4744          
+    63784407        GCRestartEEEnd         Test.exe    4744          
+    89931423        GCEnd_V1               Test.exe    4372        102019  
+    89931464        GCHeapStats            Test.exe    4372          
+    ```  
+  
+     42504816 の `GCStart_V1` イベントは、前のフィールドが `1` であるため、バックグラウンド ガベージ コレクションを示します。  これは、次の番号のガベージ コレクションになります。  102019.  
+  
+     バックグラウンド ガベージ コレクションを開始する前に短期ガベージ コレクションを実行する必要があるため、`GCStart` イベントが発生します。  これは、次の番号のガベージ コレクションになります。  102020.  
+  
+     42514170 の時点で、ガベージ コレクションの番号は  102020 になり、終了します。  この時点でマネージ スレッドが再開されます。  スレッド 4372 で以上の処理が完了すると、バックグラウンド ガベージ コレクションがトリガーされます。  
+  
+     スレッド 4744 で中断が発生します。  このバックグラウンド ガベージ コレクションによってマネージ スレッドが中断されるのはこのときだけです。  この中断の期間は約 99 ミリ秒です \(\(63784407\-63685394\)\/1000\)。  
+  
+     バックグラウンド ガベージ コレクションの `GCEnd` イベントは 89931423 で発生しています。  したがって、このバックグラウンド ガベージ コレクションの継続時間は約 47 秒になります \(\(89931423\-42504816\)\/1000\)。  
+  
+     マネージ スレッドの実行中には短期ガベージ コレクションが何度も発生する可能性があります。  
+  
+<a name="Triggered"></a>   
+##### ガベージ コレクションが発生した原因を確認するには  
+  
+-   SOS デバッガー拡張が読み込まれた WinDbg または Visual Studio デバッガーで次のコマンドを入力して、すべてのスレッドとその呼び出し履歴を表示します。  
+  
+     **~\*kb**  
+  
+     次のような出力が表示されます。  
+  
+    ```  
+    0012f3b0 79ff0bf8 mscorwks!WKS::GCHeap::GarbageCollect   
+    0012f454 30002894 mscorwks!GCInterface::CollectGeneration+0xa4  
+    0012f490 79fa22bd fragment_ni!request.Main(System.String[])+0x48  
+    ```  
+  
+     オペレーティング システムからのメモリ不足の通知によってガベージ コレクションが発生した場合も同じような呼び出し履歴になりますが、その場合はスレッドがファイナライザー スレッドになります。  ファイナライザー スレッドは、非同期のメモリ不足の通知を受け取って、ガベージ コレクションを発生させます。  
+  
+     メモリの割り当てによってガベージ コレクションが発生した場合は、次のような履歴になります。  
+  
+    ```  
+    0012f230 7a07c551 mscorwks!WKS::GCHeap::GarbageCollectGeneration  
+    0012f2b8 7a07cba8 mscorwks!WKS::gc_heap::try_allocate_more_space+0x1a1  
+    0012f2d4 7a07cefb mscorwks!WKS::gc_heap::allocate_more_space+0x18  
+    0012f2f4 7a02a51b mscorwks!WKS::GCHeap::Alloc+0x4b  
+    0012f310 7a02ae4c mscorwks!Alloc+0x60  
+    0012f364 7a030e46 mscorwks!FastAllocatePrimitiveArray+0xbd  
+    0012f424 300027f4 mscorwks!JIT_NewArr1+0x148  
+    000af70f 3000299f fragment_ni!request..ctor(Int32, Single)+0x20c  
+    0000002a 79fa22bd fragment_ni!request.Main(System.String[])+0x153  
+    ```  
+  
+     最終的に Just\-In\-Time ヘルパー \(`JIT_New*`\) が `GCHeap::GarbageCollectGeneration` を呼び出します。  ジェネレーション 2 のガベージ コレクションが割り当てによって発生していると判断された場合は、ジェネレーション 2 のガベージ コレクションの対象になっているオブジェクトを確認し、それを回避する方法を特定する必要があります。  そのためには、ジェネレーション 2 のガベージ コレクションの開始時と終了時の違いを確認し、ジェネレーション 2 のコレクションを発生させたオブジェクトを特定します。  
+  
+     たとえば、ジェネレーション 2 のコレクションの開始時の情報を表示するには、デバッガーで次のコマンドを入力します。  
+  
+     **\!dumpheap –stat**  
+  
+     出力の例を以下に示します \(最も多くの領域を使用しているオブジェクトのみが示されています\)。  
+  
+    ```  
+    79124228    31857      9862328 System.Object[]  
+    035f0384    25668     11601936 Toolkit.TlkPosition  
+    00155f80    21248     12256296      Free  
+    79103b6c   297003     13068132 System.Threading.ReaderWriterLock  
+    7a747ad4   708732     14174640 System.Collections.Specialized.HybridDictionary  
+    7a747c78   786498     15729960 System.Collections.Specialized.ListDictionary+DictionaryNode  
+    7a747bac   700298     19608344 System.Collections.Specialized.ListDictionary  
+    035f0ee4    89192     38887712 Toolkit.TlkOrder  
+    00fcae40     6193     44911636 WaveBasedStrategy.Tick_Snap[]  
+    7912c444    91616     71887080 System.Double[]  
+    791242ec    32451     82462728 System.Collections.Hashtable+bucket[]  
+    790fa3e0  2459154    112128436 System.String  
+    Total 6471774 objects  
+    ```  
+  
+     ジェネレーション 2 の終了時にも同じコマンドを実行します。  
+  
+     **\!dumpheap –stat**  
+  
+     出力の例を以下に示します \(最も多くの領域を使用しているオブジェクトのみが示されています\)。  
+  
+    ```  
+    79124228    26648      9314256 System.Object[]  
+    035f0384    25668     11601936 Toolkit.TlkPosition  
+    79103b6c   296770     13057880 System.Threading.ReaderWriterLock  
+    7a747ad4   708730     14174600 System.Collections.Specialized.HybridDictionary  
+    7a747c78   786497     15729940 System.Collections.Specialized.ListDictionary+DictionaryNode  
+    7a747bac   700298     19608344 System.Collections.Specialized.ListDictionary  
+    00155f80    13806     34007212      Free  
+    035f0ee4    89187     38885532 Toolkit.TlkOrder  
+    00fcae40     6193     44911636 WaveBasedStrategy.Tick_Snap[]  
+    791242ec    32370     82359768 System.Collections.Hashtable+bucket[]  
+    790fa3e0  2440020    111341808 System.String  
+    Total 6417525 objects  
+    ```  
+  
+     出力の末尾から `double[]` オブジェクトがなくなっているため、これらがコレクションの対象になったことがわかります。  これらのオブジェクトは約 70 MB を占めています。  その他のオブジェクトはあまり変更されていません。  したがって、これらの `double[]` オブジェクトが、このジェネレーション 2 のガベージ コレクションが発生した原因です。  ガベージ コレクションが発生した原因がわかったら、今度は、これらの `double[]` オブジェクトが存在する理由と、死んだ状態になった理由を特定します。  コードの開発者にたずねることも、**gcroot** コマンドを使用して確認することもできます。  
+  
+<a name="HighCPU"></a>   
+##### CPU の使用率が高いのはガベージ コレクションのためかどうかを確認するには  
+  
+-   `% Time in GC` メモリ パフォーマンス カウンターの値と処理時間を互いに関連付けます。  
+  
+     `% Time in GC` の値と処理時間が同時に急激に増加している場合は、CPU の使用率が高いのはガベージ コレクションのためです。  それ以外の場合は、アプリケーションのプロファイリングを実行して、使用率の高い箇所を見つけます。  
+  
+## 参照  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/unmanaged.md b/docs/standard/garbage-collection/unmanaged.md
new file mode 100644
index 00000000000..6d718f053e7
--- /dev/null
+++ b/docs/standard/garbage-collection/unmanaged.md
@@ -0,0 +1,60 @@
+---
+title: "Cleaning Up Unmanaged Resources | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Close method"
+  - "Dispose method"
+  - "garbage collector"
+  - "garbage collection, unmanaged resources"
+  - "cleanup operations"
+  - "explicit cleanups"
+  - "unmanaged resource cleanup"
+  - "Finalize method"
+ms.assetid: a17b0066-71c2-4ba4-9822-8e19332fc213
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Cleaning Up Unmanaged Resources
+アプリケーションで作成するオブジェクトの大部分については、.NET Framework のガベージ コレクターにメモリ管理を任せることができます。  しかし、アンマネージ リソースを含むオブジェクトを作成する場合は、アプリケーションでそのオブジェクトの使用が終了した時点で、そのリソースを明示的に解放する必要があります。  アンマネージ リソースの種類で最も一般的なのは、ファイル、ウィンドウ、ネットワーク接続、データベース接続などのオペレーティング システム リソースをラップしたオブジェクトです。  ガベージ コレクターは、アンマネージ リソースをカプセル化したオブジェクトを有効期間全体にわたって監視できますが、アンマネージ リソースを解放しクリーンアップする方法については情報を持っていません。  
+  
+ 型でアンマネージ リソースを使用している場合は、次のようにする必要があります。  
+  
+-   [Dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md)を実装します。  これは、アンマネージ リソースの確定的解放を有効にするために <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装を提供する必要があります。  型のコンシューマーはオブジェクト \(および使用するリソース\) が不要になると <xref:System.IDisposable.Dispose%2A> を呼び出します。  <xref:System.IDisposable.Dispose%2A> メソッドはアンマネージ リソースを直ちに解放します。  
+  
+-   型のコンシューマーが <xref:System.IDisposable.Dispose%2A> の呼び出しを忘れた場合にアンマネージ リソースを解放します。  これには、2 つの方法があります。  
+  
+    -   アンマネージ リソースをラップするセーフ ハンドルを使用します。  この手法を使用することをお勧めします。  セーフ ハンドルは <xref:System.Runtime.InteropServices.SafeHandle?displayProperty=fullName> クラスから派生し、堅牢な <xref:System.Object.Finalize%2A> メソッドを含みます。  セーフ ハンドルを使用するときは、単純に <xref:System.IDisposable> インターフェイスを実装し、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装でセーフ ハンドルの <xref:System.Runtime.InteropServices.SafeHandle.Dispose%2A> メソッドを呼び出します。  セーフ ハンドルのファイナライザーは、<xref:System.IDisposable.Dispose%2A> メソッドが呼び出されなかった場合、ガベージ コレクターによって自動的に呼び出されます。  
+  
+         または  
+  
+    -   <xref:System.Object.Finalize%2A?displayProperty=fullName> メソッドをオーバーライドします。  終了処理では、型のコンシューマーが <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> を呼び出してアンマネージ リソースを確定的に破棄しなかった場合に、リソースを非確定的に解放できます。  ただし、オブジェクトの終了処理は複雑でエラーが発生しやすい操作であるため、独自のファイナライザーを用意する代わりに、セーフ ハンドルを使用することをお勧めします。  
+  
+ これで型のコンシューマーは、<xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装を直接呼び出して、アンマネージ リソースで使用されるメモリを解放することができます。  <xref:System.IDisposable.Dispose%2A> メソッドを適切に実装すると、セーフ ハンドルの <xref:System.Object.Finalize%2A> メソッドまたは <xref:System.Object.Finalize%2A?displayProperty=fullName> メソッドの独自のオーバーライドは、<xref:System.IDisposable.Dispose%2A> メソッドが呼び出されなかった場合にリソースをクリーンアップするための安全装置になります。  
+  
+## このセクションの内容  
+ [Implementing a Dispose Method](../../../docs/standard/garbage-collection/implementing-dispose.md)  
+ アンマネージ リソースを解放する [Dispose パターン](../../../docs/standard/design-guidelines/dispose-pattern.md)を実装する方法について説明します。  
+  
+ [Using Objects That Implement IDisposable](../../../docs/standard/garbage-collection/using-objects.md)  
+ 型のコンシューマーが <xref:System.IDisposable.Dispose%2A> の実装を確実に呼び出す方法について説明します。  このためには、C\# の `using` ステートメントまたは Visual Basic の `Using` ステートメントを使用することをお勧めします。  
+  
+## 関連項目  
+ <xref:System.IDisposable?displayProperty=fullName>  
+ アンマネージ リソースの解放のための <xref:System.IDisposable.Dispose%2A> メソッドを定義します。  
+  
+ <xref:System.Object.Finalize%2A?displayProperty=fullName>  
+ アンマネージ リソースが <xref:System.IDisposable.Dispose%2A> メソッドによって解放されない場合に、オブジェクトの終了処理を提供します。  
+  
+ <xref:System.GC.SuppressFinalize%2A?displayProperty=fullName>  
+ 終了処理を抑制します。  このメソッドは、慣例的に `Dispose` メソッドから呼び出され、ファイナライザーが実行されないようにします。
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/using-objects.md b/docs/standard/garbage-collection/using-objects.md
new file mode 100644
index 00000000000..319fc511845
--- /dev/null
+++ b/docs/standard/garbage-collection/using-objects.md
@@ -0,0 +1,66 @@
+---
+title: "Using Objects That Implement IDisposable | Microsoft Docs"
+ms.custom: ""
+ms.date: "04/07/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Dispose method"
+  - "try/finally block"
+  - "garbage collection, encapsulating resources"
+ms.assetid: 81b2cdb5-c91a-4a31-9c83-eadc52da5cf0
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Using Objects That Implement IDisposable
+共通言語ランタイムのガベージ コレクターは、アンマネージ オブジェクトによって使用されているメモリを解放しますが、アンマネージ リソースを使用する型は、このアンマネージ メモリが解放されるように <xref:System.IDisposable> インターフェイスを実装します。  <xref:System.IDisposable> を実装するオブジェクトを使い終わったら、オブジェクトの <xref:System.IDisposable.Dispose%2A?displayProperty=fullName> の実装を呼び出す必要があります。  2 つの方法のいずれかでこれを行うことができます。  
+  
+-   C\# の **using** ステートメントまたは Visual Basic の `Using` ステートメントを使用します。  
+  
+-   `try`\/`finally` ブロックを実装します。  
+  
+## using ステートメント  
+ C\# の **using** ステートメントおよび Visual Basic の `Using` ステートメントを使うと、オブジェクトの作成時やクリーンアップ時に記述する必要のあるコードが簡略化されます。  **using** ステートメントは、1 つ以上のリソースを取得し、指定されたステートメントを実行し、オブジェクトを自動的に破棄します。  ただし、**using** ステートメントは、オブジェクトが構築されるメソッドのスコープ内で使用されるオブジェクトに対してのみ有効です。  
+  
+ 次の例では、`using` ステートメントを使用して <xref:System.IO.StreamReader?displayProperty=fullName> オブジェクトを作成し解放します。  
+  
+ [!code-csharp[Conceptual.Disposable#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/using1.cs#1)]
+ [!code-vb[Conceptual.Disposable#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/using1.vb#1)]  
+  
+ <xref:System.IO.StreamReader> クラスは <xref:System.IDisposable> インターフェイスを実装し、これはアンマネージ リソースを使用することを示していますが、例では <xref:System.IO.StreamReader.Dispose%2A?displayProperty=fullName> メソッドを明示的に呼び出していないことに注意してください。  C\# または Visual Basic コンパイラが `using` ステートメントを見つけると、明示的に `try`\/`finally` ブロックを含む次のコードと同等の中間言語 \(IL\) を生成します。  
+  
+ [!code-csharp[Conceptual.Disposable#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/using3.cs#3)]
+ [!code-vb[Conceptual.Disposable#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/using3.vb#3)]  
+  
+ また、C\# の **using** ステートメントでは、単一のステートメントで複数のリソースを取得できます。そのようなステートメントは、内部的には複数の **using** ステートメントを入れ子にした場合と同等です。  次の例では、2 つの異なるファイルの内容を読み取るために、<xref:System.IO.StreamReader> の 2 つのオブジェクトをインスタンス化します。  
+  
+ [!code-csharp[Conceptual.Disposable#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/using4.cs#4)]  
+  
+## Try\/Finally ブロック  
+ `using` ステートメントで `try`\/`finally` ブロックをラップする代わりに、`try`\/`finally` ブロックを直接実装することもできます。  これは、個人のコーディング スタイルであることも、次のいずれかの理由からそうすることもあります。  
+  
+-   `try` ブロックでスローされた例外をすべて処理する `catch` ブロックを含めるため。  そうしないと、`try`\/`catch` ブロックがない場合に `using` ブロック内でスローされた例外と同様に、`using` ステートメントによってスローされた例外は処理されません。  
+  
+-   宣言されたブロックに対してスコープがローカルでない <xref:System.IDisposable> を実装するオブジェクトをインスタンス化するため。  
+  
+ 次の例は前の例に似ていますが、`try`\/`catch`\/`finally` ブロックを使用して、<xref:System.IO.StreamReader> オブジェクトのインスタンス化、使用、破棄を実行し、<xref:System.IO.StreamReader> コンストラクターと <xref:System.IO.StreamReader.ReadToEnd%2A> メソッドによってスローされた例外を処理しています。  <xref:System.IDisposable.Dispose%2A> メソッドを呼び出す前に <xref:System.IDisposable> を実装するオブジェクトが `null` でないことを `finally` ブロックのコードがチェックしていることに注意してください。  これを行わない場合、実行時に <xref:System.NullReferenceException> 例外が発生する可能性があります。  
+  
+ [!code-csharp[Conceptual.Disposable#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.disposable/cs/using5.cs#6)]
+ [!code-vb[Conceptual.Disposable#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.disposable/vb/using5.vb#6)]  
+  
+ この基本パターンを利用できるのは、プログラミング言語で `using` ステートメントがサポートされていないが、<xref:System.IDisposable.Dispose%2A> メソッドを直接呼び出すことはできるため、`try`\/`finally` ブロックの実装を選択した場合、または実装する必要がある場合です。  
+  
+ 使用言語が <xref:System.IDisposable.Dispose%2A> メソッドの直接の呼び出しをサポートしていない場合は \(C\+\+ など\)、一般にその言語のデストラクター構文を使用できます。  
+  
+## 参照  
+ [Cleaning Up Unmanaged Resources](../../../docs/standard/garbage-collection/unmanaged.md)   
+ [using ステートメント](../Topic/using%20Statement%20\(C%23%20Reference\).md)   
+ [Using Statement](../Topic/Using%20Statement%20\(Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/standard/garbage-collection/weak-references.md b/docs/standard/garbage-collection/weak-references.md
new file mode 100644
index 00000000000..0ab5cc0f385
--- /dev/null
+++ b/docs/standard/garbage-collection/weak-references.md
@@ -0,0 +1,60 @@
+---
+title: "Weak References | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "weak references, short"
+  - "weak references, using"
+  - "weak references, long"
+  - "garbage collection, weak references"
+ms.assetid: 6a600fe5-3af3-4c64-82da-10a0a8e2d79b
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Weak References
+アプリケーションのコードがオブジェクトにアクセスできる間、そのアプリケーションで使用中のオブジェクトをガベージ コレクターが収集できません。  このようなアプリケーションは、そのオブジェクトに対する強い参照を持つアプリケーションと呼ばれます。  
+  
+ 弱い参照では、アプリケーションがオブジェクトをアクセスしている間もガベージ コレクターがオブジェクトを収集することが許可されます。  弱い参照は、強い参照が存在しない場合に、オブジェクトが収集されるまでの不確定の期間中のみ有効です。  弱い参照を使用するときでも、該当オブジェクトが収集されるのを防止するため、アプリケーションで強い参照を取得できます。  ただし、強い参照が再確立する前にガベージ コレクターがオブジェクトにアクセスするリスクは常にあります。  
+  
+ 弱い参照は、多くのメモリを使用するがガベージ コレクションでクリアされても簡単に再作成できるオブジェクトに使用すると便利です。  
+  
+ Windows フォーム アプリケーションのツリー ビューで、ユーザーに対して複雑な階層構造のオプションが表示されているとします。  基になるデータが大きい場合は、ユーザーがアプリケーションで他の操作をしている間、メモリ内にツリーを保持することは、効率がよくありません。  
+  
+ ユーザーが、アプリケーションの別の部分に切り替えているときは、<xref:System.WeakReference> クラスを使用してツリーへの弱い参照を作成し、強い参照をすべて破棄できます。  ユーザーがツリーに戻ったときに、アプリケーションはツリーへの強い参照の取得を試み、成功すると、ツリーの再作成は行いません。  
+  
+ オブジェクトへの弱い参照を確立するには、追跡するオブジェクトのインスタンスを使用して、<xref:System.WeakReference> を作成します。  オブジェクトと <xref:System.WeakReference.Target%2A> のプロパティを設定し、`null`への元のオブジェクトへの参照を設定します。  コード例については、クラス ライブラリの <xref:System.WeakReference> を参照してください。  
+  
+## 短期間の弱い参照および長期間の弱い参照  
+ 短期間の弱い参照または長期間の弱い参照を作成できます。  
+  
+-   Short  
+  
+     短期間の弱い参照のターゲットは、ガベージ コレクションでオブジェクトがクリアされると `null` になります。  弱い参照自体はマネージ オブジェクトで、他のマネージ オブジェクトと同様、ガベージ コレクションの対象です。短期間の弱い参照は、<xref:System.WeakReference> の既定のコンストラクターです。  
+  
+-   Long  
+  
+     長期間の弱い参照は、オブジェクトの <xref:System.Object.Finalize%2A> メソッドが呼び出された後に保持されます。  これにより、オブジェクトが再作成できるようになりますが、オブジェクトの状態は予測できません。  長期間の参照を使用するには、<xref:System.WeakReference> コンストラクターに `true` を指定します。  
+  
+     オブジェクトの型に <xref:System.Object.Finalize%2A> メソッドがない場合は、短期間の弱い参照の機能が適用され、弱い参照の有効期間は、ターゲットが収集されるまでの間になります。ターゲットの収集は、ファイナライザーの実行後は、いつでも起きる可能性があります。  
+  
+ 強い参照を確立し、オブジェクトを再び使用するには、<xref:System.WeakReference> の <xref:System.WeakReference.Target%2A> プロパティをそのオブジェクトの型にキャストします。  <xref:System.WeakReference.Target%2A> プロパティによって `null` が返される場合は、そのオブジェクトは収集済みです。それ以外の場合は、アプリケーションがそのオブジェクトに対する強い参照を再び取得しているため、使用し続けることができます。  
+  
+## 弱い参照を使用するにあたってのガイドライン  
+ 終了処理後のオブジェクトの状態が予測できないため、長期間の弱い参照は必要な場合にのみ使用してください。  
+  
+ 小さいオブジェクトに対しては、弱い参照を使用しないでください。ポインター自体が同程度の大きさであるか、より大きい場合があるためです。  
+  
+ メモリ管理の問題の自動的な解決方法として、弱い参照を使用しないでください。  代わりに、アプリケーションのオブジェクトを処理するための効果的なキャッシュ ポリシーを作成します。  
+  
+## 参照  
+ [Garbage Collection](../../../docs/standard/garbage-collection/index.md)
\ No newline at end of file
diff --git a/docs/standard/generics/TOC.md b/docs/standard/generics/TOC.md
new file mode 100644
index 00000000000..c8c791c2816
--- /dev/null
+++ b/docs/standard/generics/TOC.md
@@ -0,0 +1,5 @@
+# [ジェネリック インターフェイス](interfaces.md)
+# [.NET Framework のジェネリック コレクション](collections.md)
+# [配列とリストの操作に使用する汎用デリゲート](delegates-for-manipulating-arrays-and-lists.md)
+# [ジェネリック](index.md)
+# [共変性と反変性](covariance-and-contravariance.md)
diff --git a/docs/standard/generics/collections.md b/docs/standard/generics/collections.md
new file mode 100644
index 00000000000..c6080f15733
--- /dev/null
+++ b/docs/standard/generics/collections.md
@@ -0,0 +1,59 @@
+---
+title: ".NET Framework のジェネリック コレクション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック コレクション [.NET Framework]"
+  - "ジェネリック [.NET Framework], コレクション"
+ms.assetid: 5b646751-6ab7-465c-916c-b1a76aefa9f5
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# .NET Framework のジェネリック コレクション
+このトピックでは、.NET Framework のジェネリック コレクション クラスとその他のジェネリック型について概説します。  
+  
+## .NET Framework のジェネリック コレクション  
+ .NET Framework クラス ライブラリでは、<xref:System.Collections.Generic> および <xref:System.Collections.ObjectModel> の名前空間に多数のジェネリック コレクション クラスが用意されています。  これらのクラスについて詳しくは、「[一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)」を参照してください。  
+  
+### System.Collections.Generic  
+ ジェネリック コレクション型の多くは、非ジェネリック型に直接類似しています。  <xref:System.Collections.Generic.Dictionary%602> は、<xref:System.Collections.Hashtable> のジェネリック バージョンです。これは列挙体のために <xref:System.Collections.DictionaryEntry> ではなくジェネリック構造体 <xref:System.Collections.Generic.KeyValuePair%602> を使用します。  
+  
+ <xref:System.Collections.Generic.List%601> は <xref:System.Collections.ArrayList> のジェネリック バージョンです。  ジェネリックの <xref:System.Collections.Generic.Queue%601> および <xref:System.Collections.Generic.Stack%601> クラスには、非ジェネリックのバージョンに対応するものがあります。  
+  
+ <xref:System.Collections.Generic.SortedList%602> には、ジェネリックおよび非ジェネリックのバージョンがあります。  どちらのバージョンも、ディクショナリとリストのハイブリッドです。  <xref:System.Collections.Generic.SortedDictionary%602> ジェネリック クラスは純粋なディクショナリであり、対応する非ジェネリックのバージョンはありません。  
+  
+ <xref:System.Collections.Generic.LinkedList%601> ジェネリック クラスは、実際のリンク リストです。  これには、対応する非ジェネリックのバージョンはありません。  
+  
+### System.Collections.ObjectModel  
+ <xref:System.Collections.ObjectModel.Collection%601> ジェネリック クラスは、独自のジェネリック コレクション型を派生させるための基本クラスを提供します。  <xref:System.Collections.ObjectModel.ReadOnlyCollection%601> クラスは、<xref:System.Collections.Generic.IList%601> ジェネリック インターフェイスを実装する任意の型から、読み取り専用のコレクションを生成するための簡単な方法を提供します。  <xref:System.Collections.ObjectModel.KeyedCollection%602> ジェネリック クラスは、独自のキーを含むオブジェクトを格納するための方法を提供します。  
+  
+## その他のジェネリック型  
+ <xref:System.Nullable%601> ジェネリック構造体により、`null` が割り当て可能であるかのように値型を使用できます。  これは、値型が含まれるフィールドが欠落している可能性のあるデータベース クエリで作業するときに便利です。  ジェネリック型パラメーターには、任意の値型を指定できます。  
+  
+> [!NOTE]
+>  C\# には null 許容型の構文があるので、その言語では <xref:System.Nullable%601> を明示的に使用する必要はありません。  
+  
+ <xref:System.ArraySegment%601> ジェネリック構造体は、任意の型の 0 から始まる 1 次元の配列内で、要素の範囲を区切る方法を提供します。  ジェネリック型パラメーターは、配列の要素の型です。  
+  
+ <xref:System.EventHandler%601> ジェネリック デリゲートにより、イベントが [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] によって使用されるイベント処理パターンに従う場合に、イベントを処理するためにデリゲート型を宣言する必要がなくなります。  たとえば、イベントのデータを保持するために、<xref:System.EventArgs> から派生した `MyEventArgs` クラスを作成したとします。  その場合、イベントを次のように宣言できます。  
+  
+ [!code-cpp[Conceptual.Generics.Overview#7](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.generics.overview/cpp/source2.cpp#7)]
+ [!code-csharp[Conceptual.Generics.Overview#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.generics.overview/cs/source2.cs#7)]
+ [!code-vb[Conceptual.Generics.Overview#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.generics.overview/vb/source2.vb#7)]  
+  
+## 参照  
+ <xref:System.Collections.Generic?displayProperty=fullName>   
+ <xref:System.Collections.ObjectModel?displayProperty=fullName>   
+ [ジェネリック](../../../docs/standard/generics/index.md)   
+ [配列とリストの操作に使用する汎用デリゲート](../../../docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md)   
+ [ジェネリック インターフェイス](../../../docs/standard/generics/interfaces.md)
\ No newline at end of file
diff --git a/docs/standard/generics/covariance-and-contravariance.md b/docs/standard/generics/covariance-and-contravariance.md
new file mode 100644
index 00000000000..95739285285
--- /dev/null
+++ b/docs/standard/generics/covariance-and-contravariance.md
@@ -0,0 +1,194 @@
+---
+title: "ジェネリックの共変性と反変性 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリックの共変性と反変性"
+  - "ジェネリック型パラメーター"
+  - "ジェネリック, 共変性と反変性"
+  - "ジェネリック, 分散"
+ms.assetid: 2678dc63-c7f9-4590-9ddc-0a4df684d42e
+caps.latest.revision: 24
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# ジェネリックの共変性と反変性
+<a name="top"></a> 共変性と反変性は、元の指定よりも弱い派生型 \(具体性が低い\) と強い派生型 \(具体性が高い\) を使用する能力を示す用語です。 ジェネリック型パラメーターは、ジェネリック型の代入と使用の柔軟性を向上させるために、共変性と反変性をサポートしています。 型システムにおいて、共変性、反変性、および不変性は、次のように定義されます。 各例では、基底クラスが `Base` という名前であり、派生クラスが `Derived` という名前であるとします。  
+  
+-   `Covariance`  
+  
+     最初に指定された型よりも強い派生型を使用できるようにします。  
+  
+     `IEnumerable<Derived>` \(Visual Basic では `IEnumerable(Of Derived)`\) のインスタンスを `IEnumerable<Base>` 型の変数に割り当てることができます。  
+  
+-   `Contravariance`  
+  
+     最初に指定された型よりも一般的な \(弱い派生の\) 型を使用できるようにします。  
+  
+     `IEnumerable<Base>` \(Visual Basic では `IEnumerable(Of Base)`\) のインスタンスを `IEnumerable<Derived>` 型の変数に割り当てることができます。  
+  
+-   `Invariance`  
+  
+     最初に指定された型のみを使用できることを意味します。そのため、不変のジェネリック型パラメーターは、共変でも反変でもありません。  
+  
+     `IEnumerable<Base>` \(Visual Basic では `IEnumerable(Of Base)`\) のインスタンスを `IEnumerable<Derived>` 型の変数に割り当てることはできず、その逆もできません。  
+  
+ 共変の型パラメーターでは、次のコードで示されているように、通常の [ポリモーフィズム](../Topic/Polymorphism%20\(C%23%20Programming%20Guide\).md) と非常によく似た代入を実行できます。  
+  
+ [!code-csharp[CoContraSimpleIEnum#1](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontrasimpleienum/cs/example.cs#1)]
+ [!code-vb[CoContraSimpleIEnum#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontrasimpleienum/vb/example.vb#1)]  
+  
+ <xref:System.Collections.Generic.List%601> クラスは <xref:System.Collections.Generic.IEnumerable%601> インターフェイスを実装するため、`List<Derived>` \(Visual Basic では `List(Of Derived)`\) は `IEnumerable<Derived>` を実装します。 共変の型パラメーターが後の処理を行います。  
+  
+ 一方、反変性は直感に反するように見えます。 次の例では、`Action<Base>` 型 \(Visual Basic では `Action(Of Base)`\) のデリゲートを作成し、次にそのデリゲートを `Action<Derived>` 型の変数に代入します。  
+  
+ [!code-csharp[CoContraSimpleAction#1](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontrasimpleaction/cs/example.cs#1)]
+ [!code-vb[CoContraSimpleAction#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontrasimpleaction/vb/example.vb#1)]  
+  
+ これは逆方向のように見えますが、コンパイルして実行できるタイプ セーフ コードです。 ラムダ式は代入先のデリゲートに一致するため、`Base` 型のパラメーターを 1 つ受け取って戻り値を返さないメソッドを定義します。`Action<Derived>` デリゲートの型パラメーター `T` は反変であるため、結果として得られたデリゲートは <xref:System.Action%601> 型の変数に代入できます。`T` はパラメーター型を指定するため、コードはタイプ セーフです。`Action<Base>` 型のデリゲートが `Action<Derived>` 型のデリゲートであるかのように呼び出される場合、その引数は `Derived` 型である必要があります。 メソッドのパラメーターは `Base` 型であるため、この引数は、基になるメソッドに常に安全に渡すことができます。  
+  
+ 一般に、共変の型パラメーターはデリゲートの戻り値の型として使用でき、反変の型パラメーターはパラメーター型として使用できます。 インターフェイスについては、共変の型パラメーターをインターフェイスのメソッドの戻り値の型として使用でき、反変の型パラメーターをインターフェイスのメソッドのパラメーター型として使用できます。  
+  
+ 共変性と反変性は、"分散" と総称されます。 共変または反変としてマークされていないジェネリック型パラメーターは、*不変*と呼ばれます。 共通言語ランタイムにおける分散について、簡潔な概要を示します。  
+  
+-   [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] のバリアント型パラメーターは、ジェネリック インターフェイス型と汎用デリゲート型に制限されています。  
+  
+-   ジェネリック インターフェイス型や汎用デリゲート型では、共変と反変の両方の型パラメーターを使用できます。  
+  
+-   分散が適用されるのは参照型のみです。バリアント型パラメーターに対して値型を指定すると、その型パラメーターが、結果の構築型で不変になります。  
+  
+-   分散は、デリゲートの組み合わせには適用されません。 つまり、`Action<Derived>` 型と `Action<Base>` 型 \(Visual Basic では `Action(Of Derived)` と `Action(Of Base)`\) の 2 つのデリゲートがある場合、結果はタイプ セーフになりますが、2 つ目のデリゲートに 1 つ目のデリゲートを組み合わせることはできません。 分散によって 2 つ目のデリゲートを `Action<Derived>` 型の変数に代入できますが、デリゲートを組み合わせることができるのは、それらの型が完全に一致している場合だけです。  
+  
+ 以降では、共変と反変の型パラメーターについて詳しく説明します。  
+  
+-   [共変の型パラメーターを持つジェネリック インターフェイス](#InterfaceCovariantTypeParameters)  
+  
+-   [反変のジェネリック型パラメーターを持つジェネリック インターフェイス](#InterfaceCovariantTypeParameters)  
+  
+-   [バリアント型パラメーターを持つ汎用デリゲート](#DelegateVariantTypeParameters)  
+  
+-   [バリアント ジェネリック インターフェイスとバリアント汎用デリゲートの定義](#DefiningVariantTypeParameters)  
+  
+-   [バリアント ジェネリック インターフェイス型とバリアント汎用デリゲート型の一覧](#VariantList)  
+  
+<a name="InterfaceCovariantTypeParameters"></a>   
+## 共変の型パラメーターを持つジェネリック インターフェイス  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降には、共変の型パラメーターを持つジェネリック インターフェイスがいくつかあります \(<xref:System.Collections.Generic.IEnumerable%601>、<xref:System.Collections.Generic.IEnumerator%601>、<xref:System.Linq.IQueryable%601>、<xref:System.Linq.IGrouping%602> など\)。 これらのインターフェイスのすべての型パラメーターは共変のみであるため、型パラメーターはメンバーの戻り値の型だけに使用されます。  
+  
+ 共変の型パラメーターの例を以下に示します。 ここでは 2 つの型が定義されています。`Base` には、`PrintBases` \(Visual Basic では `IEnumerable<Base>`\) を受け取って要素を出力する `IEnumerable(Of Base)` という静的メソッドがあります。`Derived` は `Base` を継承します。 この例は、空の `List<Derived>` \(Visual Basic では `List(Of Derived)`\) を作成し、その型を `PrintBases` に渡して、キャストすることなく、`IEnumerable<Base>` 型の変数に代入できることを示しています。<xref:System.Collections.Generic.List%601> は、共変の型パラメーターを 1 つ持つ <xref:System.Collections.Generic.IEnumerable%601> を実装します。`IEnumerable<Derived>` のインスタンスを `IEnumerable<Base>` の代わりに使用できるのは、この共変の型パラメーターがあるためです。  
+  
+ [!code-csharp[CoContravarianceInClrGenericI#1](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravarianceinclrgenerici/cs/example.cs#1)]
+ [!code-vb[CoContravarianceInClrGenericI#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravarianceinclrgenerici/vb/example.vb#1)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="InterfaceContravariantTypeParameters"></a>   
+## 反変のジェネリック型パラメーターを持つジェネリック インターフェイス  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降には、反変の型パラメーターを持つジェネリック インターフェイスがいくつかあります \(<xref:System.Collections.Generic.IComparer%601>、<xref:System.IComparable%601>、<xref:System.Collections.Generic.IEqualityComparer%601> など\)。 これらのインターフェイスの型パラメーターは反変のみであるため、これらの型パラメーターは、インターフェイスのメンバーのパラメーター型としてのみ使用されます。  
+  
+ 反変の型パラメーターの例を以下に示します。 この例では、`MustInherit` プロパティを使用して抽象 \(Visual Basic では `Shape`\) `Area` クラスを定義しています。 また、`ShapeAreaComparer` \(Visual Basic では `IComparer<Shape>`\) を実装する `IComparer(Of Shape)` クラスを定義しています。<xref:System.Collections.Generic.IComparer%601.Compare%2A?displayProperty=fullName> メソッドの実装は `Area` プロパティの値に基づくため、`ShapeAreaComparer` を使用して、領域で `Shape` オブジェクトを並べ替えることができます。  
+  
+ `Circle` クラスは `Shape` を継承し、`Area` をオーバーライドします。 この例では、<xref:System.Collections.Generic.SortedSet%601> \(Visual Basic では `Circle`\) を受け取るコンストラクターを使用して、`IComparer<Circle>` オブジェクトの `IComparer(Of Circle)` を作成します。 ただし、`IComparer<Circle>` を渡す代わりに、`ShapeAreaComparer` を実装する `IComparer<Shape>` オブジェクトを渡します。 この例では、`Shape` ジェネリック インターフェイスの型パラメーターは反変であるため、コードがより強い派生型 \(`Circle`\) の比較子を要求している場合に、より弱い派生型 \(<xref:System.Collections.Generic.IComparer%601>\) の比較子を渡すことができます。  
+  
+ 新しい `Circle` オブジェクトを `SortedSet<Circle>` に追加すると、新しい要素が既存の要素と比較されるたびに `IComparer<Shape>.Compare` オブジェクトの `IComparer(Of Shape).Compare` メソッド \(Visual Basic では `ShapeAreaComparer` メソッド\) が呼び出されます。 このメソッドのパラメーターの型 \(`Shape`\) は、渡される型 \(`Circle`\) より弱い派生型なので、この呼び出しはタイプ セーフです。 反変性により、`ShapeAreaComparer` で、単一の型のコレクションおよび `Shape` から派生した型の混合コレクションを並べ替えることができるようになります。  
+  
+ [!code-csharp[CoContravarianceInClrGenericI2#1](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravarianceinclrgenerici2/cs/example.cs#1)]
+ [!code-vb[CoContravarianceInClrGenericI2#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravarianceinclrgenerici2/vb/example.vb#1)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="DelegateVariantTypeParameters"></a>   
+## バリアント型パラメーターを持つ汎用デリゲート  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、`Func` などの <xref:System.Func%602> 汎用デリゲートに、共変の戻り値の型と反変のパラメーターの型があります。`Action` などの <xref:System.Action%602> 汎用デリゲートには、反変のパラメーターの型があります。 したがって、より強い派生型のパラメーターと、より弱い派生型の戻り値 \(`Func` 汎用デリゲートの場合\) を持つ変数に、デリゲートを代入できます。  
+  
+> [!NOTE]
+>  `Func` 汎用デリゲートの最後のジェネリック型パラメーターは、デリゲート シグネチャの戻り値の型を指定します。 他のジェネリック型パラメーターは反変 \(`out` キーワード\) ですが、この最後のジェネリック型パラメーターは共変 \(`in` キーワード\) です。  
+  
+ 次に例を示します。 コードの最初の部分では、`Base` という名前のクラスと、`Derived` を継承する `Base` という名前のクラスを定義しています。その他に、`static` という名前の `Shared` \(Visual Basic では `MyMethod`\) メソッドを持つクラスも定義されています。 このメソッドは、`Base` のインスタンスを受け取り、`Derived` のインスタンスを返します  \(引数が `Derived` のインスタンスの場合は、それが `MyMethod` によって返されます。引数が `Base` のインスタンスの場合は、`MyMethod` によって `Derived` の新しいインスタンスが返されます\)。`Main()` では、`Func<Base, Derived>` を表す `Func(Of Base, Derived)` \(Visual Basic では `MyMethod`\) のインスタンスを作成して、変数 `f1` に格納しています。  
+  
+ [!code-csharp[CoContravarianceDelegates#2](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravariancedelegates/cs/example.cs#2)]
+ [!code-vb[CoContravarianceDelegates#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravariancedelegates/vb/example.vb#2)]  
+  
+ コードの 2 番目の部分は、このデリゲートを `Func<Base, Base>` \(Visual Basic では `Func(Of Base, Base)`\) 型の変数に代入できることを示しています。これは、戻り値の型が共変であるためです。  
+  
+ [!code-csharp[CoContravarianceDelegates#3](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravariancedelegates/cs/example.cs#3)]
+ [!code-vb[CoContravarianceDelegates#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravariancedelegates/vb/example.vb#3)]  
+  
+ コードの 3 番目の部分は、このデリゲートを `Func<Derived, Derived>` \(Visual Basic では `Func(Of Derived, Derived)`\) 型の変数に代入できることを示しています。これは、パラメーターの型が反変であるためです。  
+  
+ [!code-csharp[CoContravarianceDelegates#4](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravariancedelegates/cs/example.cs#4)]
+ [!code-vb[CoContravarianceDelegates#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravariancedelegates/vb/example.vb#4)]  
+  
+ コードの最後の部分は、このデリゲートを `Func<Derived, Base>` \(Visual Basic では `Func(Of Derived, Base)`\) 型の変数に代入できることを示しています。これは、反変のパラメーターの型と共変の戻り値の型の両方の効果の組み合わせによるものです。  
+  
+ [!code-csharp[CoContravarianceDelegates#5](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravariancedelegates/cs/example.cs#5)]
+ [!code-vb[CoContravarianceDelegates#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravariancedelegates/vb/example.vb#5)]  
+  
+### 汎用デリゲートと非汎用デリゲートの分散  
+ 上のコードでは、`MyMethod` のシグネチャが、構築された汎用デリゲート `Func<Base, Derived>` \(Visual Basic では `Func(Of Base, Derived)`\) のシグネチャと厳密に一致しています。 この例から、より強い派生型のパラメーターとより弱い派生型の戻り値を持つ変数やメソッド パラメーターにこの汎用デリゲートを格納できることと、そのためには、すべてのデリゲート型が汎用デリゲート型 <xref:System.Func%602> から構築されている必要があることがわかります。  
+  
+ これは重要なポイントです。 汎用デリゲートの型パラメーターの共変性と反変性の効果は、通常のデリゲート バインディングの共変性と反変性の効果 \(「[デリゲートの分散](../Topic/Variance%20in%20Delegates%20\(C%23%20and%20Visual%20Basic\).md)」を参照\) に似ていますが、 デリゲート バインディングの分散は、バリアント型パラメーターを持つ汎用デリゲート型だけでなく、すべてのデリゲート型で使用できます。 さらに、デリゲート バインディングの分散では、より限定的なパラメーターの型とより限定的でない戻り値の型を持つ任意のデリゲートにメソッドをバインドできますが、汎用デリゲートの代入を使用できるのは、両方のデリゲート型が同じジェネリック型定義から構築されている場合のみです。  
+  
+ デリゲート バインディングの分散とジェネリック型パラメーターの分散の両方の効果を組み合わせた例を以下に示します。 ここでは、3 つの型を含む型階層を定義しています。`Type1` が最も弱い派生型で、`Type3` が最も強い派生型です。 通常のデリゲート バインディングの分散を使用して、パラメーターの型が `Type1` で戻り値の型が `Type3` のメソッドを、パラメーターの型が `Type2` で戻り値の型が `Type2` の汎用デリゲートにバインドしています。 その結果、得られた汎用デリゲートを、ジェネリック型パラメーターの共変性と反変性を使用して、`Type3` 型のパラメーターと `Type1` 型の戻り値を持つ汎用デリゲート型の変数に代入しています。 2 回目の代入では、変数型とデリゲート型の両方が同じジェネリック型定義 \(この場合は <xref:System.Func%602>\) から構築されている必要があります。  
+  
+ [!code-csharp[CoContravarianceDelegatesGenRelaxed#1](../../../samples/snippets/csharp/VS_Snippets_CLR/cocontravariancedelegatesgenrelaxed/cs/example.cs#1)]
+ [!code-vb[CoContravarianceDelegatesGenRelaxed#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/cocontravariancedelegatesgenrelaxed/vb/example.vb#1)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="DefiningVariantTypeParameters"></a>   
+## バリアント ジェネリック インターフェイスとバリアント汎用デリゲートの定義  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、Visual Basic と C\# の両方で、インターフェイスやデリゲートのジェネリック型パラメーターを共変または反変としてマークするためのキーワードがサポートされています。  
+  
+> [!NOTE]
+>  ジェネリック型パラメーターの分散注釈は .NET Framework Version 2.0 以降の共通言語ランタイムでサポートされていますが、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の前までは、クラスを [Ilasm.exe \(IL アセンブラー\)](../../../docs/framework/tools/ilasm-exe-il-assembler.md) でコンパイルするか、動的アセンブリに出力することにより、Microsoft Intermediate Language \(MSIL\) を使用してこれらの注釈を含むジェネリック クラスを定義する必要がありました。  
+  
+ 共変の型パラメーターをマークするには、`out` キーワード \(Visual Basic では `Out` キーワード、[MSIL アセンブラー](../../../docs/framework/tools/ilasm-exe-il-assembler.md)では `+`\) を使用します。 共変の型パラメーターは、インターフェイスに属するメソッドの戻り値として使用したり、デリゲートの戻り値の型として使用したりできます。 インターフェイス メソッドのジェネリック型制約として使用することはできません。  
+  
+> [!NOTE]
+>  インターフェイスのメソッドに汎用デリゲート型のパラメーターがある場合は、インターフェイス型の共変の型パラメーターを使用してデリゲート型の反変の型パラメーターを指定できます。  
+  
+ 反変の型パラメーターをマークするには、`in` キーワード \(Visual Basic では `In` キーワード、[MSIL アセンブラー](../../../docs/framework/tools/ilasm-exe-il-assembler.md)では `-`\) を使用します。 反変の型パラメーターは、インターフェイスに属するメソッドのパラメーターの型として使用したり、デリゲートのパラメーターの型として使用したりできます。 インターフェイス メソッドのジェネリック型制約として使用することもできます。  
+  
+ バリアント型パラメーターを持つことができるのは、インターフェイス型とデリゲート型だけです。 インターフェイス型やデリゲート型は、共変と反変の両方の型パラメーターを持つことができます。  
+  
+ Visual Basic と C\# では、共変および反変の型パラメーターの使用規則に違反したり、インターフェイスとデリゲート以外の型の型パラメーターに共変性や反変性の注釈を追加したりすることは許可されません。[MSIL アセンブラー](../../../docs/framework/tools/ilasm-exe-il-assembler.md)ではそのようなチェックは行われませんが、規則に違反する型を読み込もうとすると <xref:System.TypeLoadException> がスローされます。  
+  
+ 詳細とコード例については、「[ジェネリック インターフェイスの分散](../Topic/Variance%20in%20Generic%20Interfaces%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="VariantList"></a>   
+## バリアント ジェネリック インターフェイス型とバリアント汎用デリゲート型の一覧  
+ 共変または反変、あるいはその両方の型パラメーターを持つ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] のインターフェイス型とデリゲート型を以下に示します。  
+  
+|型|共変の型パラメーター|反変の型パラメーター|  
+|-------|----------------|----------------|  
+|<xref:System.Action%601> ～ <xref:System.Action%6016>||はい|  
+|<xref:System.Comparison%601>||はい|  
+|<xref:System.Converter%602>|はい|はい|  
+|<xref:System.Func%601>|はい||  
+|<xref:System.Func%602> ～ <xref:System.Func%6017>|はい|はい|  
+|<xref:System.IComparable%601>||はい|  
+|<xref:System.Predicate%601>||はい|  
+|<xref:System.Collections.Generic.IComparer%601>||はい|  
+|<xref:System.Collections.Generic.IEnumerable%601>|はい||  
+|<xref:System.Collections.Generic.IEnumerator%601>|はい||  
+|<xref:System.Collections.Generic.IEqualityComparer%601>||はい|  
+|<xref:System.Linq.IGrouping%602>|はい||  
+|<xref:System.Linq.IOrderedEnumerable%601>|はい||  
+|<xref:System.Linq.IOrderedQueryable%601>|はい||  
+|<xref:System.Linq.IQueryable%601>|はい||  
+  
+## 参照  
+ [共変性と反変性](../Topic/Covariance%20and%20Contravariance%20\(C%23%20and%20Visual%20Basic\).md)   
+ [デリゲートの分散](../Topic/Variance%20in%20Delegates%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md b/docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md
new file mode 100644
index 00000000000..25c3e1d3cf8
--- /dev/null
+++ b/docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md
@@ -0,0 +1,54 @@
+---
+title: "配列とリストの操作に使用する汎用デリゲート | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配列 [.NET Framework], 汎用デリゲート"
+  - "チェーン (デリゲートを)"
+  - "デリゲート [.NET Framework], 汎用デリゲート"
+  - "汎用デリゲート [.NET Framework]"
+  - "ジェネリック [.NET Framework], デリゲート"
+  - "リスト [.NET Framework], 汎用デリゲート"
+ms.assetid: 416be383-cc61-4102-9b1b-88b51adb963e
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 配列とリストの操作に使用する汎用デリゲート
+ここでは、配列またはコレクションの要素に対して実行される変換、検索述語、およびアクションの汎用デリゲートの概要について説明します。  
+  
+## 配列とリストの操作に使用する汎用デリゲート  
+ <xref:System.Action%601> 汎用デリゲートは、指定した型の要素に対して何らかのアクションを実行するメソッドを表します。  要素に対して必要なアクションを実行するメソッドを作成し、そのメソッドを表す <xref:System.Action%601> デリゲートのインスタンスを作成した後、配列とデリゲートを静的ジェネリック メソッド <xref:System.Array.ForEach%2A?displayProperty=fullName> に渡すことができます。  このメソッドは、配列の各要素に対して呼び出されます。  
+  
+ <xref:System.Collections.Generic.List%601> ジェネリック クラスにも、<xref:System.Action%601> デリゲートを使用する <xref:System.Collections.Generic.List%601.ForEach%2A> メソッドが用意されています。  このメソッドはジェネリックではありません。  
+  
+> [!NOTE]
+>  これは、ジェネリック型とジェネリック メソッドに関する興味深い点です。  <xref:System.Array> はジェネリック型ではないため、<xref:System.Array.ForEach%2A?displayProperty=fullName> メソッドは static \(Visual Basic では `Shared`\) かつジェネリックであることが必要です。<xref:System.Array.ForEach%2A?displayProperty=fullName> に型を指定して動作させることができるのは、このメソッドが独自の型パラメーター リストを保持しているからです。  これに対して、非ジェネリック <xref:System.Collections.Generic.List%601.ForEach%2A?displayProperty=fullName> メソッドは <xref:System.Collections.Generic.List%601> ジェネリック クラスに属しています。したがって、このメソッドは、このクラスの型パラメーターを使用しているにすぎません。  このクラスは厳密に型指定されているため、メソッドをインスタンス メソッドにすることができます。  
+  
+ <xref:System.Predicate%601> 汎用デリゲートは、特定の要素が定義されている基準を満たしているかどうかを判断するメソッドを表します。  <xref:System.Array> の静的ジェネリック メソッドである <xref:System.Array.Exists%2A>、<xref:System.Array.Find%2A>、<xref:System.Array.FindAll%2A>、<xref:System.Array.FindIndex%2A>、<xref:System.Array.FindLast%2A>、<xref:System.Array.FindLastIndex%2A>、および <xref:System.Array.TrueForAll%2A> でこのデリゲートを使用することにより、要素または要素のセットを検索できます。  
+  
+ <xref:System.Predicate%601> は、<xref:System.Collections.Generic.List%601> ジェネリック クラスの対応する非ジェネリック インスタンス メソッドも使用します。  
+  
+ <xref:System.Comparison%601> 汎用デリゲートを使用すると、ネイティブな並べ替え順序のない配列またはリストの要素の並べ替え順序を指定したり、ネイティブな並べ替え順序をオーバーライドしたりできます。  比較を実行するメソッドを作成し、そのメソッドを表す <xref:System.Comparison%601> デリゲートのインスタンスを作成した後、配列とデリゲートを [Array.Sort\<T\>\(T\<xref:System.Array.Sort%60%601%28%60%600%5B%5D%2CSystem.Comparison%7B%60%600%7D%29?displayProperty=fullName> 静的ジェネリック メソッドに渡します。  <xref:System.Collections.Generic.List%601> ジェネリック クラスには、対応するインスタンス メソッド オーバーロードである <xref:System.Collections.Generic.List%601.Sort%28System.Comparison%7B%600%7D%29?displayProperty=fullName> が用意されています。  
+  
+ <xref:System.Converter%602> 汎用デリゲートを使用すると、2 つの型の間での変換を定義し、一方の型の配列をもう一方の型の配列に変換したり、一方の型のリストをもう一方の型のリストに変換したりできます。  既存のリストの要素を新しい型に変換するメソッドを作成し、そのメソッドを表すデリゲート インスタンスを作成したら、<xref:System.Array.ConvertAll%2A?displayProperty=fullName> 静的ジェネリック メソッドを使用して、元の配列から新しい型の配列を生成します。また、元のリストから新しい型のリストを生成する場合は、<xref:System.Collections.Generic.List%601.ConvertAll%2A?displayProperty=fullName> ジェネリック インスタンス メソッドを使用します。  
+  
+### デリゲートのチェーン  
+ これらのデリゲートを使用するメソッドの多くは、別のメソッドに渡すことのできる配列またはリストを返します。  たとえば、配列の特定の要素を選択して新しい型に変換し、新しい配列に保存すると、<xref:System.Array.FindAll%2A> ジェネリック メソッドによって返される配列を <xref:System.Array.ConvertAll%2A> ジェネリック メソッドに渡すことができます。  新しい要素の型にネイティブな並べ替え順序がない場合は、<xref:System.Array.ConvertAll%2A> ジェネリック メソッドによって返された配列を [Sort\<T\>\(T\<xref:System.Array.Sort%60%601%28%60%600%5B%5D%2CSystem.Comparison%7B%60%600%7D%29> ジェネリック メソッドに渡すことができます。  
+  
+## 参照  
+ <xref:System.Collections.Generic?displayProperty=fullName>   
+ <xref:System.Collections.ObjectModel?displayProperty=fullName>   
+ [ジェネリック](../../../docs/standard/generics/index.md)   
+ [.NET Framework のジェネリック コレクション](../../../docs/standard/generics/collections.md)   
+ [ジェネリック インターフェイス](../../../docs/standard/generics/interfaces.md)   
+ [共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)
\ No newline at end of file
diff --git a/docs/standard/generics/index.md b/docs/standard/generics/index.md
new file mode 100644
index 00000000000..309e9198ff8
--- /dev/null
+++ b/docs/standard/generics/index.md
@@ -0,0 +1,184 @@
+---
+title: ".NET Framework におけるジェネリック | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ジェネリック メソッド, 型推論"
+  - "ジェネリック [.NET Framework], コレクション"
+  - "ジェネリック インターフェイス [.NET Framework]"
+  - "構築ジェネリック型"
+  - "入れ子になったジェネリック型"
+  - "ジェネリック型定義"
+  - "ジェネリック クラス [.NET Framework]"
+  - "ジェネリック [.NET Framework], インターフェイス"
+  - "ジェネリック [.NET Framework], 概要"
+  - "ジェネリック [.NET Framework]"
+  - "ジェネリック コレクション [.NET Framework]"
+  - "汎用デリゲート [.NET Framework]"
+  - "ジェネリック型引数"
+  - "ジェネリック [.NET Framework], デリゲート"
+  - "ジェネリック [.NET Framework], 機能"
+  - "制約 [.NET Framework]"
+  - "ジェネリック型"
+  - "ジェネリック型パラメーター"
+ms.assetid: 2994d786-c5c7-4666-ab23-4c83129fe39c
+caps.latest.revision: 23
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# .NET Framework におけるジェネリック
+<a name="top"></a> ジェネリックを使用すると、操作対象のデータ型に厳密に合わせてメソッド、クラス、構造体、またはインターフェイスを調整できます。 たとえば、任意の型のキーと値が許可される <xref:System.Collections.Hashtable> クラスを使用する代わりに、<xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスを使用して、キーに使用できる型と、値に使用できる型を指定できます。 ジェネリックの利点として、コードの再利用性やタイプ セーフの向上などを挙げることができます。  
+  
+ このトピックでは、.NET Framework におけるジェネリックの概要と、ジェネリック型またはジェネリック メソッドの概要について説明します。 このチュートリアルは、次のセクションで構成されています。  
+  
+-   [ジェネリックの定義と使用](#defining_and_using_generics)  
+  
+-   [ジェネリックの用語](#generics_terminology)  
+  
+-   [クラス ライブラリと言語サポート](#class_library_and_language_support)  
+  
+-   [入れ子にされた型とジェネリック](#nested_types_and_generics)  
+  
+-   [関連トピック](#related_topics)  
+  
+-   [参照](#reference)  
+  
+<a name="defining_and_using_generics"></a>   
+## ジェネリックの定義と使用  
+ ジェネリックは、格納または使用される 1 つ以上の型のプレースホルダー \(型パラメーター\) を持つクラス、構造体、インターフェイス、およびメソッドです。 ジェネリック コレクション クラスでは、格納するオブジェクトの型のプレースホルダーとして、型パラメーターを使用することがあります。型パラメーターは、そのフィールドの型やそのメソッドのパラメーター型として出現します。 ジェネリック メソッドでは、その戻り値の型として、またはいずれかの仮パラメーターの型として、型パラメーターを使用します。 単純なジェネリック クラスの定義を次のコードに示します。  
+  
+ [!code-cpp[Conceptual.Generics.Overview#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.generics.overview/cpp/source.cpp#2)]
+ [!code-csharp[Conceptual.Generics.Overview#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.generics.overview/cs/source.cs#2)]
+ [!code-vb[Conceptual.Generics.Overview#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.generics.overview/vb/source.vb#2)]  
+  
+ ジェネリック クラスのインスタンスを作成する場合は、型パラメーターを置き換える実際の型を指定します。 これで、構築されたジェネリック クラスと呼ばれる新しいジェネリック クラスが確立され、この中では、型パラメーターが、出現するすべての場所で、選択した型に置き換えられています。 次のコードに示すように、結果は選択した型に合わせたタイプ セーフなクラスになります。  
+  
+ [!code-cpp[Conceptual.Generics.Overview#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.generics.overview/cpp/source.cpp#3)]
+ [!code-csharp[Conceptual.Generics.Overview#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.generics.overview/cs/source.cs#3)]
+ [!code-vb[Conceptual.Generics.Overview#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.generics.overview/vb/source.vb#3)]  
+  
+<a name="generics_terminology"></a>   
+### ジェネリックの用語  
+ .NET Framework におけるジェネリックの説明では、次の用語が使用されます。  
+  
+-   *ジェネリック型定義*は、テンプレートとして機能するクラス、構造体、またはインターフェイスの宣言で、格納または使用できる型のプレースホルダーを含みます。 たとえば、<xref:System.Collections.Generic.Dictionary%602?displayProperty=fullName> クラスには、キーと値の 2 つの型を含めることができます。 ジェネリック型定義は単なるテンプレートであるため、ジェネリック型定義のクラス、構造体、またはインターフェイスのインスタンスを作成することはできません。  
+  
+-   *ジェネリック型パラメーター* \(または*型パラメーター*\) は、ジェネリック型定義またはジェネリック メソッド定義のプレースホルダーです。<xref:System.Collections.Generic.Dictionary%602?displayProperty=fullName> ジェネリック型には、そのキーと値の型を表す 2 つの型パラメーター `TKey` と `TValue` があります。  
+  
+-   *構築ジェネリック型* \(または*構築型*\) は、ジェネリック型定義のジェネリック型パラメーターに型を指定することによって得られる結果です。  
+  
+-   *ジェネリック型引数*は、ジェネリック型パラメーターを置き換える任意の型です。  
+  
+-   一般的な用語である*ジェネリック型*には、構築型とジェネリック型定義の両方が含まれます。  
+  
+-   ジェネリック型パラメーターの*共変性*と*反変性*を使用すると、型引数がターゲットの構築型よりも強い派生型 \(共変性\) または弱い派生型 \(反変性\) である構築ジェネリック型を使用できます。 共変性と反変性は、"分散" と総称されます。 詳細については、「[共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)」を参照してください。  
+  
+-   *制約*は、ジェネリック型パラメーターに適用される制限です。 たとえば、型パラメーターを、<xref:System.Collections.Generic.IComparer%601?displayProperty=fullName> ジェネリック インターフェイスを実装する型に制限して、型のインスタンスを並べ替えることができるようにできます。 また、型パラメーターを、特定の基本クラスや既定のコンストラクターを持つ型、または参照型や値型に制約できます。 ジェネリック型のユーザーは、制約を満たさない型引数に置き換えることはできません。  
+  
+-   *ジェネリック メソッド定義*は、ジェネリック型パラメーターのリストと仮パラメーターのリストの 2 つのパラメーター リストを持つメソッドです。 次のコードに示すように、型パラメーターは、戻り値の型または仮パラメーターの型として指定できます。  
+  
+ [!code-cpp[Conceptual.Generics.Overview#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.generics.overview/cpp/source.cpp#4)]
+ [!code-csharp[Conceptual.Generics.Overview#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.generics.overview/cs/source.cs#4)]
+ [!code-vb[Conceptual.Generics.Overview#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.generics.overview/vb/source.vb#4)]  
+  
+ ジェネリック メソッドはジェネリック型または非ジェネリック型で指定できます。 メソッドがジェネリック型に属している、またはメソッドに仮パラメーターがあり、その型が外側の型のジェネリック パラメーターであるという理由だけでは、そのメソッドがジェネリックであるとは言えないことに注意してください。 メソッドは、独自の型パラメーター リストを持つ場合にのみジェネリックとなります。 次のコードでは、`G` メソッドのみがジェネリックです。  
+  
+ [!code-cpp[Conceptual.Generics.Overview#5](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.generics.overview/cpp/source.cpp#5)]
+ [!code-csharp[Conceptual.Generics.Overview#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.generics.overview/cs/source.cs#5)]
+ [!code-vb[Conceptual.Generics.Overview#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.generics.overview/vb/source.vb#5)]  
+  
+ [ページのトップへ](#top)  
+  
+<a name="advantages_limitations"></a>   
+## ジェネリックの利点と欠点  
+ ジェネリック コレクションやジェネリック デリゲートを使用することには多くの利点があります。  
+  
+-   インライン関数はタイプ セーフです。 ジェネリックによって、タイプ セーフの負担がユーザーからコンパイラに移ります。 コンパイル時に正しいデータ型が適用されるため、これをテストするためのコードを記述する必要はありません。 型キャストの必要性や、ランタイム エラーが発生する可能性が減少します。  
+  
+-   コードは少なければ少ないほど再利用が容易になります。 基本型から継承してメンバーをオーバーライドする必要はありません。 たとえば、<xref:System.Collections.Generic.LinkedList%601> はすぐに使える状態になっています。 たとえば、次の変数宣言で文字列のリンク リストを作成できます。  
+  
+     [!code-cpp[HowToGeneric#24](../../../samples/snippets/cpp/VS_Snippets_CLR/HowToGeneric/cpp/source2.cpp#24)]
+     [!code-csharp[HowToGeneric#24](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToGeneric/CS/source2.cs#24)]
+     [!code-vb[HowToGeneric#24](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToGeneric/VB/source2.vb#24)]  
+  
+-   パフォーマンスが向上します。 通常、ジェネリック コレクション型では、値型をボックス化する必要がないため、値型の格納と操作のパフォーマンスが向上します。  
+  
+-   汎用デリゲートによって、複数のデリゲート クラスを作成せずにタイプ セーフなコールバックを使用できます。 たとえば、<xref:System.Predicate%601> 汎用デリゲートを使用すると、特定の型を対象とした独自の検索条件を実装するメソッドを作成し、<xref:System.Array>、<xref:System.Array.Find%2A>、<xref:System.Array.FindLast%2A> などの <xref:System.Array.FindAll%2A> 型のメソッドと共に自分のメソッドを使用することができます。  
+  
+-   ジェネリックによって、動的に生成されるコードが簡略化されます。 動的に生成されるコードでジェネリックを使用する場合、型を生成する必要がありません。 これにより、アセンブリ全体を生成する代わりに軽量の動的メソッドを使用できるシナリオの数が増えます。 詳細については、「方法: 動的メソッドを定義および実行する」および DynamicMethod を参照してください。  
+  
+ ジェネリックの制限事項を次に示します。  
+  
+-   ジェネリック型は、<xref:System.MarshalByRefObject> などのほとんどの基本クラスから派生できます \(制約を使用して、ジェネリック型パラメーターが <xref:System.MarshalByRefObject> のような基本クラスから派生することを要求できます\)。 ただし、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] では、コンテキスト バインドのジェネリック型はサポートしていません。 ジェネリック型は、<xref:System.ContextBoundObject> から派生できますが、その型のインスタンスを作成しようとすると、<xref:System.TypeLoadException> が発生します。  
+  
+-   列挙型にジェネリック型パラメーターを含めることはできません。 列挙型が、単なる偶然によってジェネリックのみになる可能性はあります \(たとえば、Visual Basic、C\#、または C\+\+ を使用して定義されたジェネリック型に入れ子にされているため\)。 詳細については、「[共通型システム](../../../docs/standard/base-types/common-type-system.md)」の「列挙型」を参照してください。  
+  
+-   軽量の動的メソッドをジェネリックにすることはできません。  
+  
+-   Visual Basic、C\#、および C\+\+ で、ジェネリック型に囲まれている入れ子にされた型は、外側のすべての型の型パラメーターに型が割り当てられていない限り、インスタンス化できません。 言い換えると、リフレクションでは、これらの言語を使用して定義されている入れ子にされた型には、その外側のすべての型の型パラメーターが含まれます。 これによって、外側の型の型パラメーターを、入れ子にされた型のメンバー定義で使用できます。 詳細については、「<xref:System.Type.MakeGenericType%2A>」の「入れ子にされた型」を参照してください。  
+  
+    > [!NOTE]
+    >  動的アセンブリでコードを出力するか [Ilasm.exe \(IL アセンブラー\)](../../../docs/framework/tools/ilasm-exe-il-assembler.md) を使用して定義されている入れ子にされた型に、外側の型の型パラメーターを含める必要はありません。ただし、これらを含んでいない場合、型パラメーターは入れ子にされたクラスのスコープから外れます。  
+  
+     詳細については、「<xref:System.Type.MakeGenericType%2A>」の「入れ子にされた型」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="class_library_and_language_support"></a>   
+## クラス ライブラリと言語サポート  
+ .NET Framework では、次の名前空間に多数のジェネリック コレクション クラスが用意されています。  
+  
+-   <xref:System.Collections.Generic> 名前空間には、<xref:System.Collections.Generic.List%601> ジェネリック クラスや <xref:System.Collections.Generic.Dictionary%602> ジェネリック クラスなど、.NET Framework で用意されているほとんどのジェネリック コレクション型がカタログされています。  
+  
+-   <xref:System.Collections.ObjectModel> 名前空間には、<xref:System.Collections.ObjectModel.ReadOnlyCollection%601> ジェネリック クラスなど、クラスのユーザーにオブジェクト モデルを公開するために役立つ追加のジェネリック コレクション型がカタログされています。  
+  
+ 並べ替えと等価比較を実装するためのジェネリック インターフェイスは、イベント ハンドラー、変換、および検索述語の汎用デリゲート型と共に、<xref:System> 名前空間に用意されています。  
+  
+ ジェネリックのサポートは、ジェネリック型とジェネリック メソッドを調べるために <xref:System.Reflection> 名前空間に追加され、ジェネリック型とジェネリック メソッドを含む動的アセンブリを出力するために <xref:System.Reflection.Emit> に追加され、さらにジェネリックを含むソース グラフを生成するために <xref:System.CodeDom> に追加されています。  
+  
+ 共通言語ランタイムでは、Microsoft Intermediate Language \(MSIL\) のジェネリック型をサポートするために、新しいオペコードとプレフィックスを提供しています \(<xref:System.Reflection.Emit.OpCodes.Stelem>、<xref:System.Reflection.Emit.OpCodes.Ldelem>、<xref:System.Reflection.Emit.OpCodes.Unbox_Any>、<xref:System.Reflection.Emit.OpCodes.Constrained>、<xref:System.Reflection.Emit.OpCodes.Readonly> など\)。  
+  
+ Visual C\+\+、C\#、および Visual Basic のすべてで、ジェネリックの定義と使用が完全にサポートされています。 言語サポートの詳細については、「[Visual Basic におけるジェネリック型](../Topic/Generic%20Types%20in%20Visual%20Basic%20\(Visual%20Basic\).md)」、「[ジェネリックの概要](../Topic/Introduction%20to%20Generics%20\(C%23%20Programming%20Guide\).md)」、および「[Overview of Generics in Visual C\+\+](../Topic/Overview%20of%20Generics%20in%20Visual%20C++.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="nested_types_and_generics"></a>   
+## 入れ子にされた型とジェネリック  
+ ジェネリック型に入れ子にされている型は、外側のジェネリック型の型パラメーターに依存している可能性があります。 共通言語ランタイムでは、独自のジェネリック型パラメーターがない場合でも、入れ子にされた型をジェネリックと見なします。 入れ子にされた型のインスタンスを作成するときに、外側のすべてのジェネリック型の型引数を指定する必要があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[.NET Framework のジェネリック コレクション](../../../docs/standard/generics/collections.md)|.NET Framework のジェネリック コレクション クラスとその他のジェネリック型について説明します。|  
+|[配列とリストの操作に使用する汎用デリゲート](../../../docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md)|配列またはコレクションの要素に対して実行される変換、検索述語、およびアクションの汎用デリゲートについて説明します。|  
+|[ジェネリック インターフェイス](../../../docs/standard/generics/interfaces.md)|ジェネリック型のファミリ間に共通する機能を提供するジェネリック インターフェイスについて説明します。|  
+|[共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)|ジェネリック型パラメーターの共変性と反変性について説明します。|  
+|[一般的に使用されるコレクション型](../../../docs/standard/collections/commonly-used-collection-types.md)|ジェネリック型など、.NET Framework のコレクション型の特性と使用シナリオの概要について説明します。|  
+|[ジェネリック コレクションを使用する状況](../../../docs/standard/collections/when-to-use-generic-collections.md)|ジェネリック コレクション型を使用するケースを決定するための一般的な規則について説明します。|  
+|[方法: リフレクション出力を使用してジェネリック型を定義する](../../../docs/framework/reflection-and-codedom/how-to-define-a-generic-type-with-reflection-emit.md)|ジェネリック型とジェネリック メソッドを含む動的アセンブリの生成方法について説明します。|  
+|[Visual Basic におけるジェネリック型](../Topic/Generic%20Types%20in%20Visual%20Basic%20\(Visual%20Basic\).md)|ジェネリック型の使用方法や定義方法に関するトピックなど、Visual Basic ユーザー向けにジェネリック機能について説明します。|  
+|[ジェネリックの概要](../Topic/Introduction%20to%20Generics%20\(C%23%20Programming%20Guide\).md)|C\# ユーザー向けにジェネリック型の定義方法や使用方法の概要について説明します。|  
+|[Overview of Generics in Visual C\+\+](../Topic/Overview%20of%20Generics%20in%20Visual%20C++.md)|ジェネリックとテンプレートの違いなど、C\+\+ ユーザー向けにジェネリック機能について説明します。|  
+  
+<a name="reference"></a>   
+## 参照  
+ <xref:System.Collections.Generic>  
+  
+ <xref:System.Collections.ObjectModel>  
+  
+ <xref:System.Reflection.Emit.OpCodes?displayProperty=fullName>  
+  
+ [ページのトップへ](#top)
\ No newline at end of file
diff --git a/docs/standard/generics/interfaces.md b/docs/standard/generics/interfaces.md
new file mode 100644
index 00000000000..a43f57d6228
--- /dev/null
+++ b/docs/standard/generics/interfaces.md
@@ -0,0 +1,55 @@
+---
+title: "ジェネリック インターフェイス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "同等比較 [.NET Framework]"
+  - "ジェネリック インターフェイス [.NET Framework]"
+  - "ジェネリック [.NET Framework], インターフェイス"
+  - "順序付け比較 [.NET Framework]"
+ms.assetid: 88bf5b04-d371-4edb-ba38-01ec7cabaacf
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# ジェネリック インターフェイス
+このトピックでは、ジェネリック型のファミリ間に共通する機能を提供するジェネリック インターフェイスについて概説します。  
+  
+## ジェネリック インターフェイス  
+ ジェネリック インターフェイスは、順序付け比較や等価比較、およびジェネリック コレクション型で共有される機能のために、非ジェネリック インターフェイスに対応するタイプ セーフな機能を提供します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、いくつかのジェネリック インターフェイスの型パラメーターが共変または反変としてマークされ、それらのインターフェイスを実装する型をより柔軟に割り当てたり使用したりできます。  「[共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)」を参照してください。  
+  
+### 等価比較と順序付け比較  
+ <xref:System> 名前空間で、<xref:System.IComparable%601?displayProperty=fullName> と <xref:System.IEquatable%601?displayProperty=fullName> ジェネリック インターフェイスは、対応する非ジェネリック インターフェイスと同じように、順序付け比較と等価比較の方法をそれぞれ定義します。  型は、そのような比較を実行する機能を提供するために、これらのインターフェイスを実装します。  
+  
+ <xref:System.Collections.Generic> 名前空間で、<xref:System.Collections.Generic.IComparer%601> と <xref:System.Collections.Generic.IEqualityComparer%601> ジェネリック インターフェイスは、<xref:System.IComparable%601?displayProperty=fullName> や <xref:System.IEquatable%601?displayProperty=fullName> ジェネリック インターフェイスを実装しない型のために、順序付け比較または等価比較を定義する方法を提供します。また、実装する型のために、それらの関係を再定義する方法も提供します。  これらのインターフェイスは、多くのジェネリック コレクション クラスのメソッドやコンストラクターで使用されます。  たとえば、ジェネリック <xref:System.Collections.Generic.IComparer%601> オブジェクトを <xref:System.Collections.Generic.SortedDictionary%602> クラスのコンストラクターに渡して、ジェネリック <xref:System.IComparable%601?displayProperty=fullName> を実装しない型の並べ替え順序を指定することができます。  ジェネリック <xref:System.Collections.Generic.IComparer%601> 実装を使用して配列やリストを並べ替えるための、<xref:System.Array.Sort%2A?displayProperty=fullName> ジェネリック静的メソッドと <xref:System.Collections.Generic.List%601.Sort%2A?displayProperty=fullName> インスタンス メソッドのオーバーロードがあります。  
+  
+ <xref:System.Collections.Generic.Comparer%601> と <xref:System.Collections.Generic.EqualityComparer%601> ジェネリック クラスは、<xref:System.Collections.Generic.IComparer%601> と <xref:System.Collections.Generic.IEqualityComparer%601> ジェネリック インターフェイスの実装の基本クラスを提供し、それぞれの <xref:System.Collections.Generic.Comparer%601.Default%2A?displayProperty=fullName> および <xref:System.Collections.Generic.EqualityComparer%601.Default%2A?displayProperty=fullName> プロパティによって、既定の順序付け比較と等価比較を提供します。  
+  
+### コレクションの機能  
+ <xref:System.Collections.Generic.ICollection%601> ジェネリック インターフェイスは、ジェネリック コレクション型の基本インターフェイスです。  これは、要素を追加、削除、コピー、および列挙するための基本的な機能を提供します。  <xref:System.Collections.Generic.ICollection%601> は、ジェネリック <xref:System.Collections.Generic.IEnumerable%601> と非ジェネリック <xref:System.Collections.IEnumerable> の両方から継承します。  
+  
+ <xref:System.Collections.Generic.IList%601> ジェネリック インターフェイスは、インデックス付きの取得のための手段により、<xref:System.Collections.Generic.ICollection%601> ジェネリック インターフェイスが機能拡張されたものです。  
+  
+ <xref:System.Collections.Generic.IDictionary%602> ジェネリック インターフェイスは、キー付きの取得のための手段により、<xref:System.Collections.Generic.ICollection%601> ジェネリック インターフェイスが機能拡張されたものです。  .NET Framework の基本クラス ライブラリのジェネリック ディクショナリ型は、非ジェネリック <xref:System.Collections.IDictionary> インターフェイスも実装します。  
+  
+ <xref:System.Collections.Generic.IEnumerable%601> ジェネリック インターフェイスは、ジェネリック列挙子の構造体を提供します。  ジェネリック列挙子によって実装される <xref:System.Collections.Generic.IEnumerator%601> ジェネリック インターフェイスは、非ジェネリック <xref:System.Collections.IEnumerator> インターフェイスを継承します。型パラメーター `T` に依存しない <xref:System.Collections.IEnumerator.MoveNext%2A> および <xref:System.Collections.IEnumerator.Reset%2A> メンバーは、非ジェネリック インターフェイスにのみ表示されます。  つまり、非ジェネリック インターフェイスのコンシューマーはすべて、ジェネリック インターフェイスも使用できます。  
+  
+## 参照  
+ <xref:System.Collections.Generic?displayProperty=fullName>   
+ <xref:System.Collections.ObjectModel?displayProperty=fullName>   
+ [ジェネリック](../../../docs/standard/generics/index.md)   
+ [.NET Framework のジェネリック コレクション](../../../docs/standard/generics/collections.md)   
+ [配列とリストの操作に使用する汎用デリゲート](../../../docs/standard/generics/delegates-for-manipulating-arrays-and-lists.md)   
+ [共変性と反変性](../../../docs/standard/generics/covariance-and-contravariance.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/TOC.md b/docs/standard/globalization-localization/TOC.md
new file mode 100644
index 00000000000..fc49b03ce56
--- /dev/null
+++ b/docs/standard/globalization-localization/TOC.md
@@ -0,0 +1,11 @@
+# [カルチャを認識しない配列の操作の実行](performing-culture-insensitive-string-operations-in-arrays.md)
+# [推奨される国際対応アプリケーション開発手順](best-practices-for-developing-world-ready-apps.md)
+# [カルチャを認識しない文字列操作](culture-insensitive-string-operations.md)
+# [カルチャを認識しない文字列比較の実行](performing-culture-insensitive-string-comparisons.md)
+# [グローバライズとローカライズ](index.md)
+# [カルチャを認識しない大文字と小文字の変更の実行](performing-culture-insensitive-case-changes.md)
+# [カルチャを認識しないコレクションの操作の実行](performing-culture-insensitive-string-operations-in-collections.md)
+# [カルチャを認識しない文字列操作の実行](performing-culture-insensitive-string-operations.md)
+# [グローバリゼーション](globalization.md)
+# [ローカリゼーション](localization.md)
+# [ローカライズ化の確認](localizability-review.md)
diff --git a/docs/standard/globalization-localization/best-practices-for-developing-world-ready-apps.md b/docs/standard/globalization-localization/best-practices-for-developing-world-ready-apps.md
new file mode 100644
index 00000000000..afd6da62685
--- /dev/null
+++ b/docs/standard/globalization-localization/best-practices-for-developing-world-ready-apps.md
@@ -0,0 +1,109 @@
+---
+title: "推奨される国際対応アプリケーション開発手順 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グローバル アプリケーション、ベスト プラクティス"
+  - "国際対応アプリケーション、ベスト プラクティス"
+  - "グローバリゼーション [.NET Framework]、ベスト プラクティス"
+  - "国際対応のアプリケーション [.NET Framework]、ベスト プラクティス"
+ms.assetid: f08169c7-aad8-4ec3-9a21-9ebd3b89986c
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# 推奨される国際対応アプリケーション開発手順
+このセクションでは、推奨される国際対応アプリケーション開発手順について説明します。  
+  
+## 推奨されるグローバリゼーション手順  
+  
+1.  アプリケーションを内部的に Unicode アプリケーションにします。  
+  
+2.  データの操作と書式指定には、<xref:System.Globalization> 名前空間のカルチャ認識クラスを使用します。  
+  
+    -   並べ替えには <xref:System.Globalization.SortKey> クラスと <xref:System.Globalization.CompareInfo> クラスを使用します。  
+  
+    -   文字列比較には、<xref:System.Globalization.CompareInfo> クラスを使用します。  
+  
+    -   日付と時刻の書式指定には、<xref:System.Globalization.DateTimeFormatInfo> クラスを使用します。  
+  
+    -   数値書式指定には、<xref:System.Globalization.NumberFormatInfo> クラスを使用します。  
+  
+    -   グレゴリオ暦とグレゴリオ暦以外の暦には、<xref:System.Globalization.Calendar> クラスまたは特定のカレンダー実装を使用します。  
+  
+3.  状況に応じて、<xref:System.Globalization.CultureInfo?displayProperty=fullName> クラスのカルチャ プロパティ設定を使用します。  日付と時刻や数値の書式指定などの書式指定処理には、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティを使用します。  リソースを取得するには、<xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName> プロパティを使用します。  `CurrentCulture` プロパティと `CurrentUICulture` プロパティはスレッドごとに設定できることに注意してください。  
+  
+4.  <xref:System.Text> 名前空間のエンコーディング クラスを使用して、アプリケーションでの各種エンコーディングのデータの読み取り操作と書き込み操作を有効にします。  常に ASCII データが使用されるとは限らないことに注意してください。  どのようなテキスト入力でも、各種の言語の文字が使用される可能性があります。  たとえば、アプリケーションは、サーバー名、ディレクトリ名、ファイル名、ユーザー名、および URL に含まれる各種言語の文字を受け入れる必要があります。  
+  
+5.  <xref:System.Text.UTF8Encoding> クラスを使用する場合は、セキュリティ上の理由から、このクラスに用意されているエラー検出機能を使用してください。  エラー検出機能を有効にするには、`throwOnInvalidBytes` パラメーターを受け取るコンストラクターを使用してクラスのインスタンスを作成し、このパラメーターの値を `true` に設定します。  
+  
+6.  文字列は、できるだけ全体を 1 つのまとまりとして扱い、個々の文字の連続として処理しないようにします。  これは特に部分文字列の並べ替えと検索で重要です。  これにより、組み合わせ文字の解析に関連する問題の発生を防ぐことができます。  
+  
+7.  <xref:System.Drawing> 名前空間のクラスを使用してテキストを表示します。  
+  
+8.  オペレーティング システム間での一貫性を維持するため、ユーザー設定によって <xref:System.Globalization.CultureInfo> がオーバーライドされないようにしてください。  `useUserOverride` パラメーターを受け取る `CultureInfo` コンストラクターを使用し、このパラメーターを `false` に設定してください。  
+  
+9. 国際対応オペレーティング システムで、国際対応データを使用してアプリケーションの機能をテストします。  
+  
+10. 文字列比較操作または大文字と小文字の変更操作の結果に基づいてセキュリティ上の決定を行う場合は、アプリケーションで実行する操作がカルチャに依存しないようにします。  こうすることで、`CultureInfo.CurrentCulture` の値が結果に影響を及ぼすことがなくなります。  カルチャに依存した文字列比較により矛盾した結果がどのように生成されるかを示す例については、[文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md) の「現在のカルチャを使用する文字列比較」を参照してください。  
+  
+## 推奨されるローカリゼーション手順  
+  
+1.  ローカライズ可能なすべてのリソースをリソース専用 DLL へ移動します。  ローカライズ可能リソースには、文字列、エラー メッセージ、ダイアログ ボックス、メニュー、埋め込みオブジェクト リソースなどのユーザー インターフェイス要素があります。  
+  
+2.  文字列やユーザー インターフェイス リソースをハードコーディングしないでください。  
+  
+3.  ローカライズできないリソースをリソース専用 DLL に含めないでください。  ローカライズを行う翻訳者を混乱させる原因となります。  
+  
+4.  文字列を実行時に連結して使う方法は避けてください。  連結される文字列は、英語の語順に依存することが多く、ほかの言語でのローカライズ作業が困難になります。  
+  
+5.  "Empty Folder" のように、構成要素の文法的な役割によって複数の翻訳が存在するあいまいな文字列を使用しないでください。  たとえば、"empty" は動詞または形容詞として解釈できるため、イタリア語やフランス語などの言語での翻訳結果が異なることがあります。  
+  
+6.  アプリケーションではテキストが含まれているイメージやアイコンを使用しないでください。  このようなイメージやアイコンのローカライズには時間と労力がかかります。  
+  
+7.  ユーザー インターフェイスの文字列は、表示領域に余裕がある程度の長さにしておいてください。  言語によっては、ユーザー インターフェイスが他の言語よりも 50 ～ 75% 長い領域を必要とする場合があります。  
+  
+8.  カルチャに基づいてリソースを取得するには、<xref:System.Resources.ResourceManager?displayProperty=fullName> クラスを使用します。  
+  
+9. Windows フォームのダイアログ ボックスを作成するには Visual Studio を使用します。このように作成されたダイアログ ボックスは、[Windows フォーム リソース エディター \(Winres.exe\)](../../../docs/framework/tools/winres-exe-windows-forms-resource-editor.md) を使用してローカライズできます。  Windows フォームのダイアログ ボックスを手動でコーディングしないでください。  
+  
+10. 専門的なローカライズ \(翻訳\) 作業を計画してください。  
+  
+11. リソースの作成とローカライズの詳細については、「[アプリケーションのリソース](../../../docs/framework/resources/index.md)」を参照してください。  
+  
+## 推奨される ASP.NET アプリケーションのグローバライズ手順  
+  
+1.  <xref:System.Globalization.CultureInfo.CurrentUICulture%2A> プロパティおよび <xref:System.Globalization.CultureInfo.CurrentCulture%2A> プロパティをアプリケーションで明示的に設定します。  既定値には依存しないでください。  
+  
+2.  ASP.NET アプリケーションはマネージ アプリケーションであり、カルチャに基づいた情報の取得、表示、および操作では、ほかのマネージ アプリケーションと同じクラスを使用できます。  
+  
+3.  ASP.NET では次に示す 3 種類のエンコーディングを指定できる点に注意してください。  
+  
+    -   requestEncoding は、クライアントのブラウザーから受信されたエンコーディングを指定します。  
+  
+    -   responseEncoding は、クライアント ブラウザーへ送信するエンコーディングを指定します。  ほとんどの場合、このエンコーディングは requestEncoding に指定されたエンコーディングと同一です。  
+  
+    -   fileEncoding は、.aspx、.asmx、.asax の各ファイルの解析の既定エンコーディングを指定します。  
+  
+4.  ASP.NET アプリケーション内の次の 3 か所で、requestEncoding、responseEncoding、fileEncoding、culture、uiCulture の各属性の値を指定します。  
+  
+    -   Web.config ファイルのグローバリゼーション セクション。  Web.config ファイルは、ASP.NET アプリケーションの外部ファイルです。  詳細については、「[\<globalization\> 要素](http://msdn.microsoft.com/ja-jp/e2dffc8e-ebd2-439b-a2fd-e3ac5e620da7)」を参照してください。  
+  
+    -   ページ ディレクティブ。  アプリケーションがページを処理している時点では、ファイルは既に読み取られています。  そのため、fileEncoding と requestEncoding を指定するには遅すぎます。  ページ ディレクティブでは uiCulture、Culture、および responseEncoding だけを指定できます。  
+  
+    -   アプリケーション コード \(プログラムで指定\)。  この設定は、要求ごとに変更できます。  ページ ディレクティブの場合と同様に、アプリケーション コードの処理時点では、fileEncoding と requestEncoding の指定は遅すぎます。  アプリケーション コードでは、uiCulture、Culture、および responseEncoding だけを指定できます。  
+  
+5.  uiCulture 値には、ブラウザー受け入れ言語を設定できます。  
+  
+## 参照  
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/culture-insensitive-string-operations.md b/docs/standard/globalization-localization/culture-insensitive-string-operations.md
new file mode 100644
index 00000000000..283fda44675
--- /dev/null
+++ b/docs/standard/globalization-localization/culture-insensitive-string-operations.md
@@ -0,0 +1,40 @@
+---
+title: "カルチャを認識しない文字列操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "大文字と小文字を区別する比較"
+  - "カルチャ, カルチャを認識しない文字列操作"
+  - "カルチャを認識しない文字列操作"
+  - "カルチャを認識する文字列操作"
+  - "グローバリゼーション [.NET Framework], カルチャを認識しない文字列操作"
+  - "ローカリゼーション [.NET Framework], カルチャを認識しない文字列操作"
+  - "文字列 [.NET Framework], カルチャを認識しない文字列操作"
+  - "国際対応アプリケーション, カルチャを認識しない文字列操作"
+ms.assetid: e6e2bb94-a95d-44e2-b68c-cfdd1db77784
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# カルチャを認識しない文字列操作
+カルチャを認識する文字列操作は、カルチャごとにユーザーに結果を表示するようデザインされたアプリケーションを作成する場合に役立ちます。  既定では、カルチャを認識するメソッドは、使用するカルチャを現在のスレッドの <xref:System.Globalization.CultureInfo.CurrentCulture%2A> プロパティから取得します。  
+  
+ ただし、カルチャを認識する文字列操作は、必ずしも望ましい動作ではありません。  結果をカルチャに依存させない場合に、カルチャを認識する操作を使用すると、カスタムの大文字と小文字の対応規則および並べ替え規則を使用するカルチャでのアプリケーション コードの実行が失敗することがあります。  たとえば、[文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md) の記事の「現在のカルチャを使用する文字列比較」を参照してください。  
+  
+ 文字列操作でカルチャに依存するかどうかは、アプリケーションで結果をどのように使用するかに基づいて決定する必要があります。  ユーザーに結果を表示する場合は、通常、カルチャを認識する文字列操作を実行する必要があります。  たとえば、アプリケーションがローカライズされた文字列を並べ替えてリスト ボックスに表示する場合は、カルチャを認識する並べ替えを実行します。  
+  
+ 内部的に使用される文字列に対する操作は、通常、カルチャを認識しないようにします。  一般的に、アプリケーションがファイル名、永続形式、エンド ユーザーに表示されないシンボル情報などの処理を実行する場合には、文字列操作の結果がカルチャごとに変わらないようにする必要があります。  たとえば、XML タグとして認識されるかどうかを調べるために文字列を比較するアプリケーションでは、比較操作でカルチャを認識しないでください。  また、セキュリティに関する決定が文字列の比較操作や大文字と小文字の変更操作の結果に基づいて行われる場合は、この操作がカルチャを認識しないようにして、操作の結果が <xref:System.Globalization.CultureInfo.CurrentCulture%2A> の値に影響されないようにする必要があります。  
+  
+ 開発するアプリケーションにローカリゼーションとグローバリゼーションに対応するためのコードが含まれているかどうかに関係なく、.NET Framework のメソッドは既定ではカルチャを認識する結果を取得することに注意してください。  このトピックの目的は、アプリケーションがこれらのメソッドを使用してカルチャを認識しない結果を取得するための正しい方法を示すことです。  
+  
+## 参照  
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/globalization.md b/docs/standard/globalization-localization/globalization.md
new file mode 100644
index 00000000000..61b5cf1881c
--- /dev/null
+++ b/docs/standard/globalization-localization/globalization.md
@@ -0,0 +1,381 @@
+---
+title: "グローバリゼーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "グローバリゼーション [.NET Framework]、グローバリゼーションについて"
+  - "グローバル アプリケーション、グローバリゼーション"
+  - "国際対応のアプリケーション [.NET Framework]、グローバリゼーション"
+  - "国際対応アプリケーション、グローバリゼーション"
+  - "アプリケーション開発 [.NET Framework]、グローバリゼーション"
+  - "カルチャ、グローバリゼーション"
+ms.assetid: 4e919934-6b19-42f2-b770-275a4fae87c9
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# グローバリゼーション
+グローバリゼーションとは、さまざまな文化圏 \(カルチャ\) のユーザー向けに、ローカライズされたインターフェイスと、その地域に合ったデータをサポートするような、国際対応アプリの設計と開発をいいます。 設計フェーズに着手する前に、アプリでサポートするカルチャを決定してください。 アプリは既定値として 1 つのカルチャまたは地域を対象としますが、別のカルチャまたは地域のユーザーに簡単に拡張できるようにアプリを設計および作成できます。  
+  
+ 開発者には、自分のカルチャによって形成されるユーザー インターフェイスとデータに関する前提があります。 たとえば、米国の英語圏の開発者は、日付と時刻のデータを形式 `MM/dd/yyyy hh:mm:ss` の文字列としてシリアル化することは、十分理にかなっていると考えます。 ただし、別のカルチャのシステムでその文字列を逆シリアル化すると、<xref:System.FormatException> 例外がスローされるか、正しくないデータが生成される可能性があります。 グローバリゼーションにより、このようなカルチャ固有の前提を識別し、それがアプリの設計またはコードに影響しないようにすることができます。  
+  
+ 次のセクションでは、グローバライズされたアプリで文字列、日付と時刻の値、および数値を処理するときに考慮する必要がある重要な問題および使用できるベスト プラクティスについて説明します。  
+  
+-   [文字列を処理する](../../../docs/standard/globalization-localization/globalization.md#HandlingStrings)  
+  
+    -   [Unicode を内部で使用する](../../../docs/standard/globalization-localization/globalization.md#Strings_Unicode)  
+  
+    -   [リソース ファイルを使用する](../../../docs/standard/globalization-localization/globalization.md#Strings_Resources)  
+  
+    -   [文字列を検索して比較する](../../../docs/standard/globalization-localization/globalization.md#Strings_Searching)  
+  
+    -   [文字列の等価性をテストする](../../../docs/standard/globalization-localization/globalization.md#Strings_Equality)  
+  
+    -   [文字列の順序付けと並べ替えを実行する](../../../docs/standard/globalization-localization/globalization.md#Strings_Ordering)  
+  
+    -   [文字列の連結を回避する](../../../docs/standard/globalization-localization/globalization.md#Strings_Concat)  
+  
+-   [日付と時刻を処理する](../../../docs/standard/globalization-localization/globalization.md#DatesAndTimes)  
+  
+    -   [日付と時刻を保持する](../../../docs/standard/globalization-localization/globalization.md#DatesAndTimes_Persist)  
+  
+    -   [日付と時刻を表示する](../../../docs/standard/globalization-localization/globalization.md#DatesAndTimes_Display)  
+  
+    -   [シリアル化とタイム ゾーンへの対応](../../../docs/standard/globalization-localization/globalization.md#DatesAndTimes_TimeZones)  
+  
+    -   [日付と時刻の演算を実行する](../../../docs/standard/globalization-localization/globalization.md#DatesAndTimes_Arithmetic)  
+  
+-   [数値を処理する](../../../docs/standard/globalization-localization/globalization.md#Numbers)  
+  
+    -   [数値を表示する](../../../docs/standard/globalization-localization/globalization.md#Numbers_Display)  
+  
+    -   [数値を保持する](../../../docs/standard/globalization-localization/globalization.md#Numbers_Persist)  
+  
+-   [カルチャ固有の設定を使用する](../../../docs/standard/globalization-localization/globalization.md#Cultures)  
+  
+<a name="HandlingStrings"></a>   
+## 文字列を処理する  
+ カルチャまたは地域ごとに異なる文字と文字セットを使用し、異なる方法で並べ替える可能性があるため、文字と文字列の処理は、グローバリゼーションで主な焦点となります。 このセクションでは、グローバライズされたアプリで文字列を使用するための推奨事項について説明します。  
+  
+<a name="Strings_Unicode"></a>   
+### Unicode を内部で使用する  
+ 既定では、.NET Framework では Unicode 文字列を使用します。 Unicode 文字列は、ゼロ個以上の <xref:System.Char> オブジェクトで構成され、それぞれが UTF\-16 コード単位を表します。 世界中で使用されているすべての文字セットのほとんどすべての文字に対して、Unicode 表現があります。  
+  
+ Windows オペレーティング システムを含む、多くのアプリケーションとオペレーティング システムでは、文字セットを表すためにコード ページを使用できます。 コード ページには、通常、0x00 から 0x7F までの標準 ASCII 値が含まれ、0x80 から 0xFF までの残りの値に他の文字をマップします。 0x80 から 0xFF までの値の解釈は特定のコード ページによって異なります。 このため、可能な場合は、グローバライズされたアプリでコード ページを使用しないようにします。  
+  
+ 次の例では、システムの既定のコード ページとデータが保存されたコード ページとが異なる場合にコード ページのデータを解釈する危険性を示しています  \(このシナリオをシミュレートするため、例では、異なるコード ページを明示的に指定します\)。 最初に、ギリシャ文字の大文字で構成される配列を定義します。 コード ページ 737 \(MS\-DOS ギリシャ語とも呼ばれます\) を使用してそれらをバイト配列にエンコードし、バイト配列をファイルに保存します。 ファイルを取得し、そのバイト配列をコード ページ 737 を使用してデコードした場合、元の文字が復元されます。 ただし、ファイルを取得して、そのバイト配列をコード ページ 1252 \(または Windows\-1252。ラテン語アルファベットの文字を表します\) を使用してデコードした場合、元の文字は失われます。  
+  
+ [!code-csharp[Conceptual.Globalization#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/codepages1.cs#1)]
+ [!code-vb[Conceptual.Globalization#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/codepages1.vb#1)]  
+  
+ Unicode を使用することで、同じコード単位を必ず同じ文字にマップでき、同じ文字を必ず同じバイト配列にマップできます。  
+  
+<a name="Strings_Resources"></a>   
+### リソース ファイルを使用する  
+ 単一のカルチャまたは地域を対象とするアプリを開発する場合でも、ユーザー インターフェイスに表示される文字列などのリソースを格納するためにリソース ファイルを使用する必要があります。 リソースを直接コードに追加しないでください。 リソース ファイルの使用には、次の利点があります。  
+  
+-   すべての文字列が単一の場所に存在します。 ソース コード全体を検索して、特定の言語またはカルチャに合わせて変更する文字列を特定する必要はありません。  
+  
+-   文字列を複製する必要がありません。 リソース ファイルを使用しない開発者は、多くの場合、複数のソース コード ファイルで同じ文字列を定義します。 この重複により、文字列を変更するときに 1 つ以上のインスタンスを見落とす可能性が高くなります。  
+  
+-   イメージ、バイナリ データなどの文字列以外のリソースを個別のスタンドアロン ファイルに格納するのではなく、リソース ファイルに格納できるので、それらが簡単に取得できます。  
+  
+ ローカライズされたアプリを作成する場合、リソース ファイルを使用することには特に利点があります。 サテライト アセンブリにリソースを配置すると <xref:System.Globalization.CultureInfo.CurrentUICulture%2A?displayProperty=fullName> プロパティで定義されているユーザーの現在の UI カルチャに基づいて、共通言語ランタイムが自動的にカルチャに応じたリソースを選択します。 適切なカルチャ固有のリソースを提供し、<xref:System.Resources.ResourceManager> オブジェクトを正しくインスタンス化するか、厳密に型指定されたリソース クラスを使用すると、ランタイムは適切なリソースの取得の詳細を処理します。  
+  
+ リソース ファイルの作成の詳細については、「[リソース ファイルの作成](../../../docs/framework/resources/creating-resource-files-for-desktop-apps.md)」を参照してください。 サテライト アセンブリの作成と配置の詳細については、「[サテライト アセンブリの作成](../../../docs/framework/resources/creating-satellite-assemblies-for-desktop-apps.md)」および「[リソースのパッケージ化と配置](../../../docs/framework/resources/packaging-and-deploying-resources-in-desktop-apps.md)」を参照してください。  
+  
+<a name="Strings_Searching"></a>   
+### 文字列を検索して比較する  
+ 文字列は、できるだけ全体を 1 つのまとまりとして扱い、個々の文字の連続として処理しない必要があります。 これは、部分文字列を並べ替えたり、検索したりするときに、組み合わせ文字の解析に関する問題を防ぐうえで特に重要です。  
+  
+> [!TIP]
+>  <xref:System.Globalization.StringInfo> クラスを使用して、文字列の個別の文字ではなく、テキスト要素を操作できます。  
+  
+ 文字列の検索と比較でよくある間違いは、それぞれが <xref:System.Char> オブジェクトによって表される文字のコレクションとして文字列を処理することです。 実際に、1 つの文字が 1 つ、2 つ、またはそれ以上の <xref:System.Char> オブジェクトによって形成される場合があります。 このような文字は、アルファベットが、Unicode 基本ラテン文字の範囲 \(U\+0021 ～ U\+007E\) 外にある文字で構成されるカルチャの文字列に最もよくみられます。 次の例では、文字列で LATIN CAPITAL LETTER A WITH GRAVE 文字 \(U\+00C0\) のインデックスを検索します。 ただし、この文字は、1 つのコード単位 \(U\+00C0\) または複合文字 \(2 つのコード単位: U\+0021 と U\+007E\) という 2 つの方法で表現できます。 この場合、この文字は、文字列インスタンスで 2 つの <xref:System.Char> オブジェクト \(U\+0021 と U\+007E\) によって表されます。 このコード例では、<xref:System.String.IndexOf%28System.Char%29?displayProperty=fullName> オーバーロードと <xref:System.String.IndexOf%28System.String%29?displayProperty=fullName> オーバーロードを呼び出して、文字列インスタンスでのこの文字の位置を検索しますが、この 2 つは異なる結果を返します。 最初のメソッド呼び出しでは <xref:System.Char> 引数を指定しているので、序数に基づく比較が実行され、一致を見つけることができません。 2 番目の呼び出しでは <xref:System.String> 引数を指定しているので、カルチャに依存した比較が実行され、一致が見つかります。  
+  
+ [!code-csharp[Conceptual.Globalization#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/search1.cs#18)]
+ [!code-vb[Conceptual.Globalization#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/search1.vb#18)]  
+  
+ <xref:System.StringComparison> メソッド、<xref:System.String.IndexOf%28System.String%2CSystem.StringComparison%29?displayProperty=fullName> メソッドなど <xref:System.String.LastIndexOf%28System.String%2CSystem.StringComparison%29?displayProperty=fullName> パラメーターを含むオーバーロードを呼び出して、この例のあいまいさ \(異なる結果を返すメソッドの 2 つの類似オーバーロードの呼び出し\) の一部を回避できます。  
+  
+ ただし、検索が常にカルチャに依存しているとは限りません。 検索の目的がセキュリティ上の決定をするか、またはリソースへのアクセスを許可または拒否することである場合、次のセクションで説明するように序数に基づく比較を実行する必要があります。  
+  
+<a name="Strings_Equality"></a>   
+### 文字列の等価性をテストする  
+ 2 つの文字列が並べ替え順序で並ぶ方法を確認するのではなく、2 つの文字列の等価性をテストする場合は、<xref:System.String.Equals%2A?displayProperty=fullName>、<xref:System.String.Compare%2A?displayProperty=fullName> などの文字列比較メソッドの代わりに <xref:System.Globalization.CompareInfo.Compare%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ 等価性の比較は、通常、条件付きでリソースにアクセスするために実行します。 たとえば、パスワードを確認したり、ファイルがあることを確認したりするために等価性の比較を実行する場合があります。 このような非言語的な比較は、カルチャに依存するのではなく、常に序数に基づいて実行する必要があります。 一般に、パスワードなどの文字列の場合は <xref:System.String.Equals%28System.String%2CSystem.StringComparison%29?displayProperty=fullName> の値を使用して、ファイル名、URI などの文字列の場合は <xref:System.String.Equals%28System.String%2CSystem.String%2CSystem.StringComparison%29?displayProperty=fullName> の値を使用して、インスタンス <xref:System.StringComparison?displayProperty=fullName> メソッドまたは静的 <xref:System.StringComparison?displayProperty=fullName> メソッドを呼び出す必要があります。  
+  
+ 等価性の比較では、<xref:System.String.Equals%2A?displayProperty=fullName> メソッドを呼び出すのではなく、検索したり、部分文字列を比較したりすることがあります。 場合によっては、部分文字列検索を使用して、その部分文字列が別の文字列と等しいかどうかを確認できます。 この比較の目的が非言語的である場合、検索はカルチャに依存するのではなく、序数に基づいて実行する必要があります。  
+  
+ 次の例は、非言語的なデータに対してカルチャに依存した検索を実行することの危険性を示しています。`AccessesFileSystem` メソッドは、部分文字列 "FILE" で始まる URI のファイル システムのアクセスを禁止するように設計されています。 これを実行するため、カルチャに依存し、大文字と小文字を区別しない比較を実行して、URI の先頭と文字列 "FILE" を比較します。 ファイル システムにアクセスする URI は "FILE:" または "file:" で始まる可能性があるため、"i" \(U\+0069\) は常に "I" \(U\+0049\) と等価の小文字表現であるという暗黙の前提があります。 ただし、トルコ語およびアゼルバイジャン語には、"i" の大文字として "İ" \(U\+0130\) があります。 このような相違があるため、カルチャに依存した比較を使用すると、ファイル システムのアクセスを禁止する必要がある場合でもそのアクセスが許可されます。  
+  
+ [!code-csharp[Conceptual.Globalization#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/equals1.cs#12)]
+ [!code-vb[Conceptual.Globalization#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/equals1.vb#12)]  
+  
+ 次の例に示すように、大文字と小文字を無視する序数に基づく比較を実行して、この問題を回避できます。  
+  
+ [!code-csharp[Conceptual.Globalization#13](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/equals2.cs#13)]
+ [!code-vb[Conceptual.Globalization#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/equals2.vb#13)]  
+  
+<a name="Strings_Ordering"></a>   
+### 文字列の順序付けと並べ替えを実行する  
+ 通常、ユーザー インターフェイスの表示順序が指定された文字列は、カルチャに基づいて並べ替える必要があります。 ほとんどの場合、このような文字列比較は、文字列を並べ替える <xref:System.Array.Sort%2A?displayProperty=fullName>、<xref:System.Collections.Generic.List%601.Sort%2A?displayProperty=fullName> などのメソッドを呼び出すと、.NET Framework によって暗黙的に処理されます。 既定では、文字列は、現在のカルチャの並べ替え規則を使用して並べ替えられます。 次の例では、文字列の配列を英語 \(米国\) カルチャとスウェーデン語 \(スウェーデン\) カルチャの規則を使用して並べ替えたときの違いを示しています。  
+  
+ [!code-csharp[Conceptual.Globalization#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/sort1.cs#14)]
+ [!code-vb[Conceptual.Globalization#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/sort1.vb#14)]  
+  
+ カルチャに依存した文字列比較は、各カルチャの <xref:System.Globalization.CompareInfo> プロパティによって返される <xref:System.Globalization.CultureInfo.CompareInfo%2A?displayProperty=fullName> オブジェクトによって定義されます。<xref:System.String.Compare%2A?displayProperty=fullName> メソッド オーバーロードを使用するカルチャに依存した文字列比較では、<xref:System.Globalization.CompareInfo> オブジェクトも使用します。  
+  
+ .NET Framework は、文字列データのカルチャに依存した並べ替えを実行するためにテーブルを使用します。 並べ替えのウエイトと文字列の正規化に関するデータが入ったこれらのテーブルの内容は、特定のバージョンの .NET Framework によって実装される Unicode 規格のバージョンによって決まります。 次の表は、特定のバージョンの .NET Framework によって実装される Unicode のバージョンです。 サポートされている Unicode バージョンの一覧は、文字の比較と並べ替えに対してのみ適用されます。カテゴリ別での Unicode 文字の分類には適用されません。 詳細については、記事「<xref:System.String>」 の「Strings and The Unicode Standard」 \(文字列と Unicode 標準\) セクションを参照してください。  
+  
+|.NET Framework のバージョン|オペレーティング システム|Unicode バージョン|  
+|---------------------------|-------------------|-------------------|  
+|.NET Framework 2.0|すべてのオペレーティング システム|Unicode 4.1|  
+|.NET Framework 3.0|すべてのオペレーティング システム|Unicode 4.1|  
+|.NET Framework 3.5|すべてのオペレーティング システム|Unicode 4.1|  
+|.NET Framework 4|すべてのオペレーティング システム|Unicode 5.0|  
+|.NET Framework 4.5|[!INCLUDE[win7](../../../includes/win7-md.md)]|Unicode 5.0|  
+|.NET Framework 4.5|[!INCLUDE[win8](../../../includes/win8-md.md)]|Unicode 6.0|  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] では、文字列の比較および並べ替えは、オペレーティング システムによって異なります。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行される [!INCLUDE[win7](../../../includes/win7-md.md)] は、Unicode 5.0 を実装する独自のテーブルからデータを取得します。[!INCLUDE[net_v45](../../../includes/net-v45-md.md)] で実行される [!INCLUDE[win8](../../../includes/win8-md.md)] は、Unicode 6.0 を実装するオペレーティング システム テーブルからデータを取得します。 カルチャに依存した並べ替えが実行されたデータをシリアル化する場合は、<xref:System.Globalization.SortVersion> クラスを使用して、.NET Framework およびオペレーティング システムの並べ替え順序と一致するように、シリアル化されたデータをいつ並べ替える必要があるかを判断できます。 例については、<xref:System.Globalization.SortVersion> クラスに関するトピックを参照してください。  
+  
+ 広範なカルチャ固有の並べ替えを文字列データに対して実行するアプリの場合、<xref:System.Globalization.SortKey> クラスを使用して文字列を比較できます。 並べ替えキーは、特定の文字列のアルファベット順、大文字と小文字の区別、発音の区別など、カルチャ固有の並べ替えウェイトを反映しています。 並べ替えキーを使用した比較はバイナリであるため、<xref:System.Globalization.CompareInfo> オブジェクトを暗黙的または明示的に使用する比較よりも高速です。<xref:System.Globalization.CompareInfo.GetSortKey%2A?displayProperty=fullName> メソッドに文字列を渡すことによって、特定の文字列のカルチャ固有の並べ替えキーを作成します。  
+  
+ 次の例は、前の例と似ています。 ただし、暗黙的に <xref:System.Array.Sort%28System.Array%29?displayProperty=fullName> メソッドを呼び出す <xref:System.Globalization.CompareInfo.Compare%2A?displayProperty=fullName> メソッドを呼び出すのではなく、インスタンス化して、<xref:System.Collections.Generic.IComparer%601?displayProperty=fullName> メソッドに渡す、並べ替えキーを比較する [Array.Sort\<T\>\(T\<xref:System.Array.Sort%60%601%28%60%600%5B%5D%2CSystem.Collections.Generic.IComparer%7B%60%600%7D%29?displayProperty=fullName> 実装を定義しています。  
+  
+ [!code-csharp[Conceptual.Globalization#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/sortkey1.cs#15)]
+ [!code-vb[Conceptual.Globalization#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/sortkey1.vb#15)]  
+  
+<a name="Strings_Concat"></a>   
+### 文字列の連結を回避する  
+ 可能な限り、文字列を実行時に連結して使う方法は避けてください。 連結される文字列は、他のローカライズ言語には当てはまらない、アプリの元の言語の語順に依存することが多く、ローカライズ作業が困難になります。  
+  
+<a name="DatesAndTimes"></a>   
+## 日付と時刻を処理する  
+ 日付と時刻の値を処理する方法は、その値をユーザー インターフェイスに表示するのか、保持するのかによって異なります。 このセクションでは、両方の使用を検討します。 また、日付と時刻を操作するときにタイム ゾーンの相違と算術演算を処理する方法についても説明します。  
+  
+<a name="DatesAndTimes_Display"></a>   
+### 日付と時刻を表示する  
+ 通常、日付と時刻をユーザー インターフェイスに表示するときには、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティと、<xref:System.Globalization.DateTimeFormatInfo> プロパティによって返される `CultureInfo.CurrentCulture.DateTimeFormat` オブジェクトで定義されているユーザーのカルチャの書式指定規則を使用する必要があります。 次のメソッドのいずれかを使用して日付の書式を設定すると、現在のカルチャの書式指定規則が自動的に使用されます。  
+  
+-   パラメーターなしの <xref:System.DateTime.ToString?displayProperty=fullName> メソッド  
+  
+-   書式指定文字列を含む <xref:System.DateTime.ToString%28System.String%29?displayProperty=fullName> メソッド  
+  
+-   パラメーターなしの <xref:System.DateTimeOffset.ToString?displayProperty=fullName> メソッド  
+  
+-   書式指定文字列を含む <xref:System.DateTimeOffset.ToString%28System.String%29?displayProperty=fullName>  
+  
+-   日付と共に使用した場合、[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)機能  
+  
+ 次の例では、2012 年 10 月 11 日の日の出と日没のデータを 2 回表示します。 最初に、現在のカルチャをクロアチア語 \(クロアチア\) に設定し、次に英語 \(英国\) に設定します。 どちらの場合も、日付と時刻はそのカルチャに適した書式で表示されます。  
+  
+ [!code-csharp[Conceptual.Globalization#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates1.cs#2)]
+ [!code-vb[Conceptual.Globalization#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates1.vb#2)]  
+  
+<a name="DatesAndTimes_Persist"></a>   
+### 日付と時刻を保持する  
+ 日付と時刻のデータはカルチャによって異なる可能性がある書式で保持しないでください。 これは、データの破損または実行時例外が発生する一般的なプログラミング エラーです。 次の例では、英語 \(米国\) カルチャの書式指定規則を使用して文字列として 2 つの日付 \(2013 年 1 月 9 日と 2013 年 8 月 18 日\) をシリアル化します。 データが英語 \(米国\) カルチャの規則を使用して取得および解析されると、正常に復元されます。 ただし、英語 \(英国\) カルチャの規則を使用して取得および解析されると、最初の日付は 9 月 1 日と間違って解釈され、グレゴリオ暦には 18 番目の月がないため 2 番目の日付は解析されません。  
+  
+ [!code-csharp[Conceptual.Globalization#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates2.cs#3)]
+ [!code-vb[Conceptual.Globalization#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates2.vb#3)]  
+  
+ この問題は、次の 3 つのうちいずれかの方法で回避できます。  
+  
+-   文字列ではなくバイナリ形式で日付と時刻をシリアル化します。  
+  
+-   ユーザーのカルチャに関係なく同じであるカスタム書式指定文字列を使用して日付と時刻の文字列表現を保存および解析します。  
+  
+-   インバリアント カルチャの書式指定規則を使用して文字列を保存します。  
+  
+ 次の例では、最後のアプローチを示します。 この例では、静的 <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されるインバリアント カルチャの書式指定規則を使用します。  
+  
+ [!code-csharp[Conceptual.Globalization#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates3.cs#4)]
+ [!code-vb[Conceptual.Globalization#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates3.vb#4)]  
+  
+<a name="DatesAndTimes_TimeZones"></a>   
+### シリアル化とタイム ゾーンへの対応  
+ 日付と時刻の値は、一般的な時刻 \("店舗は 2013 年 1 月 2 日の午前 9 時に開店します"\) から特定の時点 \("生年月日: 2013 年 1 月 2 日午前 6 時 32 分 00 秒"\) まで、多様に解釈できます。 時刻の値が特定の時点を表し、それをシリアル化された値から復元する場合、ユーザーの地理的場所またはタイム ゾーンに関係なく同じ特定の時点を表すことを確認する必要があります。  
+  
+ この問題を説明する例を次に示します。 この例では、1 つのローカル日付と時刻の値を、3 つの[標準書式](../../../docs/standard/base-types/standard-date-and-time-format-strings.md) \(一般の日付と長い形式の時刻の "G"、並べ替え可能な日付と時刻の "s"、およびラウンド トリップする日付と時刻の "o"\) の文字列として、およびバイナリ形式で保存します。  
+  
+ [!code-csharp[Conceptual.Globalization#10](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates4.cs#10)]
+ [!code-vb[Conceptual.Globalization#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates4.vb#10)]  
+  
+ シリアル化されたシステムと同じタイム ゾーンのシステムでデータを復元すると、出力に示すように、逆シリアル化された日付と時刻の値は正確に元の値を反映しています。  
+  
+```  
+  
+'3/30/2013 6:00:00 PM' --> 3/30/2013 6:00:00 PM Unspecified  
+'2013-03-30T18:00:00' --> 3/30/2013 6:00:00 PM Unspecified  
+'2013-03-30T18:00:00.0000000-07:00' --> 3/30/2013 6:00:00 PM Local  
+  
+3/30/2013 6:00:00 PM Local  
+  
+```  
+  
+ ただし、別のタイム ゾーンのシステムでデータを復元する場合は、"o" \(ラウンド トリップ\) 標準書式指定文字列を使用して書式設定された日付と時刻の値だけがタイム ゾーン情報を維持して、同じ時点を表します。 日付と時刻のデータがロマンス標準時ゾーンのシステムで復元されたときの出力を次に示します。  
+  
+```  
+  
+'3/30/2013 6:00:00 PM' --> 3/30/2013 6:00:00 PM Unspecified  
+'2013-03-30T18:00:00' --> 3/30/2013 6:00:00 PM Unspecified  
+'2013-03-30T18:00:00.0000000-07:00' --> 3/31/2013 3:00:00 AM Local  
+  
+3/30/2013 6:00:00 PM Local  
+  
+```  
+  
+ データが逆シリアル化されるシステムのタイム ゾーンに関係なく 1 つの時点を表す日付と時刻の値を正確に反映するには、次のいずれかの方法を使用できます。  
+  
+-   "o" \(ラウンド トリップ\) 標準書式指定文字列を使用して値を文字列として保存します。 その後、ターゲット システムで逆シリアル化します。  
+  
+-   値を UTC に変換し、"r" \(RFC1123\) 標準書式指定文字列を使用して文字列として保存します。 その後、ターゲット システムで逆シリアル化し、現地時刻に変換します。  
+  
+-   値を UTC に変換し、"u" \(世界共通の並べ替え可能な日付と時刻\) 標準書式指定文字列を使用して文字列として保存します。 その後、ターゲット システムで逆シリアル化し、現地時刻に変換します。  
+  
+-   値を UTC に変換し、バイナリ形式で保存します。 その後、ターゲット システムで逆シリアル化し、現地時刻に変換します。  
+  
+ 各方法の例を次に示します。  
+  
+ [!code-csharp[Conceptual.Globalization#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates8.cs#11)]
+ [!code-vb[Conceptual.Globalization#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates8.vb#11)]  
+  
+ データを太平洋標準時ゾーンのシステムでシリアル化し、ロマンス標準時ゾーンのシステムで逆シリアル化すると、次の出力が表示されます。  
+  
+```  
+  
+'2013-03-30T18:00:00.0000000-07:00' --> 3/31/2013 3:00:00 AM Local  
+'Sun, 31 Mar 2013 01:00:00 GMT' --> 3/31/2013 3:00:00 AM Local  
+'2013-03-31 01:00:00Z' --> 3/31/2013 3:00:00 AM Local  
+  
+3/31/2013 3:00:00 AM Local  
+  
+```  
+  
+ 詳細については、「[タイム ゾーン間での時刻の変換](../../../docs/standard/datetime/converting-between-time-zones.md)」を参照してください。  
+  
+<a name="DatesAndTimes_Arithmetic"></a>   
+### 日付と時刻の演算を実行する  
+ <xref:System.DateTime> 型と <xref:System.DateTimeOffset> 型は、算術演算をサポートします。 2 つの日付の値の差を計算したり、日付の値に特定の時間間隔を加算または減算したりできます。 ただし、日付と時刻の値に対する算術演算では、タイム ゾーンとタイム ゾーン調整規則が考慮されません。 このため、時点を表す値に対して日付と時刻の算術を実行すると、不正確な結果が返されることがあります。  
+  
+ たとえば、太平洋標準時から太平洋夏時間への切り替えは、3 月の第 2 日曜日、2013 年の場合は 3 月 10 日に行われます。 次の例に示すように、太平洋標準時ゾーンのシステムで、2013 年 3 月 9 日午前 10 時 30 分の 48 時間後に当たる日付と時刻を計算した場合、結果は 2013 年 3 月 11 日午前 10 時 30 分となり、その間の時間調整は考慮されません。  
+  
+ [!code-csharp[Conceptual.Globalization#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates5.cs#8)]
+ [!code-vb[Conceptual.Globalization#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates5.vb#8)]  
+  
+ 日付と時刻の値に対する算術演算によって正確な結果を生成するには、次の手順を実行します。  
+  
+1.  ソース タイム ゾーンの時刻を UTC に変換します。  
+  
+2.  算術演算を実行します。  
+  
+3.  結果が日付と時刻の値である場合、UTC からソース タイム ゾーンの時刻に変換します。  
+  
+ 次の例は前の例と似ていますが、この 3 つの手順を実行することで、2013 年 3 月 9 日午前 10 時 30 分に 48 時間が正しく追加されています。  
+  
+ [!code-csharp[Conceptual.Globalization#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/dates6.cs#9)]
+ [!code-vb[Conceptual.Globalization#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/dates6.vb#9)]  
+  
+ 詳細については、「[日付と時刻を使用した算術演算の実行](../../../docs/standard/datetime/performing-arithmetic-operations.md)」を参照してください。  
+  
+### 日付要素のカルチャに依存した名前を使用する  
+ アプリによっては、月または曜日の名前を表示することが必要になる場合があります。 これを実行するために、次のようなコードが一般に使用されます。  
+  
+ [!code-csharp[Conceptual.Globalization#19](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/monthname1.cs#19)]
+ [!code-vb[Conceptual.Globalization#19](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/monthname1.vb#19)]  
+  
+ ただし、このコードは曜日の名前を必ず英語で返します。 多くの場合、月の名前を抽出するコードには、さらに柔軟性がありません。 一般に、このようなコードでは特定の言語の月の名前を使用した 12 か月の暦を前提としています。  
+  
+ 次の例に示すように、[カスタム日時書式指定文字列](../../../docs/standard/base-types/custom-date-and-time-format-strings.md)または <xref:System.Globalization.DateTimeFormatInfo> オブジェクトのプロパティを使用すると、ユーザーのカルチャの曜日または月の名前を反映する文字列を簡単に抽出できます。 この例では、現在のカルチャをフランス語 \(フランス\) に変更し、2013 年 7 月 1 日の曜日の名前と月の名前を表示します。  
+  
+ [!code-csharp[Conceptual.Globalization#20](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/monthname2.cs#20)]
+ [!code-vb[Conceptual.Globalization#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/monthname2.vb#20)]  
+  
+<a name="Numbers"></a>   
+## 数値を処理する  
+ 数値の処理は、数値をユーザー インターフェイスに表示するのか、保持するのかによって異なります。 このセクションでは、両方の使用を検討します。  
+  
+> [!NOTE]
+>  解析操作と書式設定操作では、.NET Framework は基本ラテン文字 0 ～ 9 \(U\+0030 ～ U\+0039\) だけを数字として認識します。  
+  
+<a name="Numbers_Display"></a>   
+### 数値を表示する  
+ 通常、数値をユーザー インターフェイスに表示するときには、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> プロパティと、<xref:System.Globalization.NumberFormatInfo> プロパティによって返される `CultureInfo.CurrentCulture.NumberFormat` オブジェクトで定義されているユーザーのカルチャの書式指定規則を使用する必要があります。 次のメソッドのいずれかを使用して日付の書式を設定すると、現在のカルチャの書式指定規則が自動的に使用されます。  
+  
+-   任意の数値型のパラメーターなしの `ToString` メソッド  
+  
+-   書式指定文字列を引数として含む任意の数値型の `ToString(String)` メソッド  
+  
+-   数値と共に使用した場合、[複合書式指定](../../../docs/standard/base-types/composite-formatting.md)機能  
+  
+ 次の例では、パリ \(フランス\) の毎月の平均気温を表示します。 この例では、最初にデータを表示する前に現在のカルチャをフランス語 \(フランス\) に設定し、次に英語 \(米国\) に設定します。 どちらの場合も、月の名前と気温はそのカルチャに適した形式で表示されます。 この 2 つのカルチャでは、気温の値に使用する小数点記号が異なります。 また、この例では、"MMMM" カスタム日時書式指定文字列を使用して月の正式名を表示し、<xref:System.Globalization.DateTimeFormatInfo.MonthNames%2A?displayProperty=fullName> 配列で最も長い月の名前の長さを確認することで、結果の文字列の月の名前に適切な領域を割り当てます。  
+  
+ [!code-csharp[Conceptual.Globalization#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/numbers1.cs#5)]
+ [!code-vb[Conceptual.Globalization#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/numbers1.vb#5)]  
+  
+<a name="Numbers_Persist"></a>   
+### 数値を保持する  
+ 数値データはカルチャ固有の書式で保持しないでください。 これは、データの破損または実行時例外が発生する一般的なプログラミング エラーです。 次の例では、10 個のランダムな浮動小数点数を生成し、英語 \(米国\) カルチャの書式指定規則を使用して文字列としてシリアル化します。 データが英語 \(米国\) カルチャの規則を使用して取得および解析されると、正常に復元されます。 ただし、この数値をフランス語 \(フランス\) カルチャの規則を使用して取得および解析すると、使用する小数点記号が異なるため、数値はいずれも解析できません。  
+  
+ [!code-csharp[Conceptual.Globalization#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/numbers2.cs#6)]
+ [!code-vb[Conceptual.Globalization#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/numbers2.vb#6)]  
+  
+ この問題を回避するには、次の方法のいずれかを使用します。  
+  
+-   ユーザーのカルチャに関係なく同じであるカスタム書式指定文字列を使用して数値の文字列表現を保存および解析します。  
+  
+-   <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> プロパティによって返されるインバリアント カルチャの書式指定規則を使用して文字列として数値を保存します。  
+  
+-   文字列形式ではなく、バイナリで数値をシリアル化します。  
+  
+ 次の例では、最後のアプローチを示します。 この例では、<xref:System.Double> 値の配列をシリアル化し、英語 \(米国\) カルチャとフランス語 \(フランス\) カルチャの書式指定規則を使用して逆シリアル化して、表示します。  
+  
+ [!code-csharp[Conceptual.Globalization#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/numbers3.cs#7)]
+ [!code-vb[Conceptual.Globalization#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/numbers3.vb#7)]  
+  
+ 通貨値のシリアル化は特殊なケースです。 通貨値は、それが表現されている通貨の単位に依存するため、独立した数値として扱う意味はほとんどありません。 ただし、通貨値を、通貨記号を含んだ書式設定された文字列として保存する場合、次の例に示すように、既定のカルチャが異なる通貨記号を使用するシステムで逆シリアル化できません。  
+  
+ [!code-csharp[Conceptual.Globalization#16](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/currency1.cs#16)]
+ [!code-vb[Conceptual.Globalization#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/currency1.vb#16)]  
+  
+ 代わりに、カルチャの名前など、カルチャに関する情報と共に数値をシリアル化して、値とその通貨記号が現在のカルチャと関係なく逆シリアル化できるようにする必要があります。 次の例では、2 つメンバーを使用して `CurrencyValue` 構造体を定義することでこれを実行しています。2 つのメンバーは、<xref:System.Decimal> 値とその値が属するカルチャの名前です。  
+  
+ [!code-csharp[Conceptual.Globalization#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.globalization/cs/currency2.cs#17)]
+ [!code-vb[Conceptual.Globalization#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.globalization/vb/currency2.vb#17)]  
+  
+<a name="Cultures"></a>   
+## カルチャ固有の設定を使用する  
+ .NET Framework では、特定のカルチャまたは地域は <xref:System.Globalization.CultureInfo> クラスによって表されます。 そのプロパティの一部は、カルチャのある側面に関する特定の情報を提供するオブジェクトを返します。  
+  
+-   <xref:System.Globalization.CultureInfo.CompareInfo%2A?displayProperty=fullName> プロパティは、カルチャによる文字列の比較方法および並べ替え方法に関する情報を含んだ <xref:System.Globalization.CompareInfo> オブジェクトを返します。  
+  
+-   <xref:System.Globalization.CultureInfo.DateTimeFormat%2A?displayProperty=fullName> プロパティは、日付と時刻のデータの書式設定で使用されるカルチャ固有の情報を提供する <xref:System.Globalization.DateTimeFormatInfo> オブジェクトを返します。  
+  
+-   <xref:System.Globalization.CultureInfo.NumberFormat%2A?displayProperty=fullName> プロパティは、数値データの書式設定で使用されるカルチャ固有の情報を提供する <xref:System.Globalization.NumberFormatInfo> オブジェクトを返します。  
+  
+-   <xref:System.Globalization.CultureInfo.TextInfo%2A?displayProperty=fullName> プロパティは、カルチャの書記体系に関する情報を提供する <xref:System.Globalization.TextInfo> オブジェクトを返します。  
+  
+ 一般に、特定の <xref:System.Globalization.CultureInfo> プロパティおよび関連するオブジェクトの値について何も想定しないでください。 代わりに、次の理由により、カルチャ固有のデータは変更される可能性があると考える必要があります。  
+  
+-   個々のプロパティ値は、データが修正された、より優れたデータが使用可能になった、カルチャ固有の規則が変更されたなどの理由で、時間と共に変更または修正される可能性があります。  
+  
+-   個々のプロパティ値は、.NET Framework のバージョンまたはオペレーティング システムのバージョン間で異なる場合があります。  
+  
+-   .NET Framework では置換カルチャをサポートしています。 これにより、既存の標準カルチャを補足または既存の標準カルチャを完全に置き換える新しいカスタム カルチャを定義できます。  
+  
+-   ユーザーは、コントロール パネルの **\[地域と言語\]** アプリを使用してカルチャ固有の設定をカスタマイズできます。<xref:System.Globalization.CultureInfo> オブジェクトをインスタンス化するときに、<xref:System.Globalization.CultureInfo.%23ctor%28System.String%2CSystem.Boolean%29?displayProperty=fullName> コンストラクターを呼び出すことでこのようなユーザーによるカスタマイズを反映するかどうかを決定できます。 通常は、エンド ユーザーのアプリでは、ユーザー設定を尊重して、ユーザー自身が予期する形式でデータを表示する必要があります。  
+  
+## 参照  
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)   
+ [文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/index.md b/docs/standard/globalization-localization/index.md
new file mode 100644
index 00000000000..81e9a006912
--- /dev/null
+++ b/docs/standard/globalization-localization/index.md
@@ -0,0 +1,79 @@
+---
+title: ".NET Framework アプリケーションのグローバライズとローカライズ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [.NET Framework], グローバリゼーション"
+  - "グローバル アプリケーション"
+  - "グローバリゼーション [.NET Framework], エンコーディング"
+  - "国際対応のアプリケーション [.NET Framework]"
+  - "国際化"
+  - "多言語アプリケーション開発"
+  - "国際対応アプリケーション"
+ms.assetid: 9a59696b-d89b-45bd-946d-c75da4732d02
+caps.latest.revision: 42
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 42
+---
+# .NET Framework アプリケーションのグローバライズとローカライズ
+1 つ以上の言語にローカライズされるアプリケーションなど、[国際対応アプリケーション](http://msdn.microsoft.com/goglobal/bb978433.aspx)を開発するには、グローバリゼーション、ローカライズ対象の確認、およびローカリゼーションの 3 つの手順が必要です。  
+  
+ [グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md)  
+ これは、特定のカルチャや言語に依存せず、すべてのユーザーに対して、ローカライズされたユーザー インターフェイスと、その地域に合ったデータをサポートするような、アプリケーションの設計と開発を行う手順です。  これはカルチャ固有の前提に基づかない決定によって設計とプログラミングを行うことです。  グローバライズされたアプリケーションは、ローカライズされていなくても、後から比較的容易に 1 つ以上の言語にローカライズできるように設計開発されています。  
+  
+ [ローカライズ化の確認](../../../docs/standard/globalization-localization/localizability-review.md)  
+ この手順により、アプリケーションのコードと設計をレビューして、ローカライズが容易になるようにし、ローカライズのための潜在的な問題点を識別し、アプリケーションの実行可能コードがリソースから分離されていることを確認します。  グローバリゼーションの段階が効果的なものであれば、ローカリゼーション レビューはグローバリゼーションの過程で行われた設計とコーディングの決定を確認するものになります。  ローカライズ対象の確認の段階では、ローカライズの段階でアプリケーションのソース コードを変更する必要がないように、残っている問題を特定します。  
+  
+ [ローカリゼーション](../../../docs/standard/globalization-localization/localization.md)  
+ この手順では、特定のカルチャまたは地域に合わせてアプリケーションをカスタマイズします。  グローバリゼーションとローカライズ対象の確認を適切に行うと、ローカリゼーションでは主にユーザー インターフェイスの翻訳作業が行われます。  
+  
+ この 3 つの手順に従うことにより、次の 2 つの利点があります。  
+  
+-   米国英語などのような 1 つのカルチャだけをサポートするアプリケーションを、  他のカルチャもサポートするように変更する作業を行う必要がなくなります。  
+  
+-   ローカライズされたアプリケーションが、より安定してバグがより少ないものになります。  
+  
+ .NET Framework には、国際対応アプリケーションやローカライズされたアプリケーションの開発の拡張サポートが備わっています。  特に、.NET Framework クラス ライブラリの多くの型メンバーは、現在のユーザーのカルチャまたは特定のカルチャの規則を表す値を返すことができ、グローバリゼーションに役立ちます。  また、.NET Framework はサテライト アセンブリをサポートし、アプリケーションのローカライズ プロセスを容易にします。  
+  
+ 詳細については、「[Go Global Developer Center](http://go.microsoft.com/fwlink/?LinkId=235015)」を参照してください。  
+  
+## このセクションの内容  
+ [グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md)  
+ 国際対応アプリケーションを作成するための最初の手順を説明します。カルチャや言語に依存しないアプリケーションの設計とコーディングを行います。  
+  
+ [ローカライズ化の確認](../../../docs/standard/globalization-localization/localizability-review.md)  
+ ローカライズされたアプリケーションを作成するための 2 つ目の手順を説明します。ローカライズのための潜在的な問題点を識別します。  
+  
+ [ローカリゼーション](../../../docs/standard/globalization-localization/localization.md)  
+ ローカライズされたアプリケーションを作成するための最後の手順を説明します。特定の地域またはカルチャのために、アプリケーションのユーザー インターフェイスをカスタマイズします。  
+  
+ [カルチャを認識しない文字列操作](../../../docs/standard/globalization-localization/culture-insensitive-string-operations.md)  
+ 既定ではカルチャが識別される .NET Framework のメソッドやクラスを使用して、カルチャが識別されない結果を取得する方法について説明します。  
+  
+ [推奨される国際対応アプリケーション開発手順](../../../docs/standard/globalization-localization/best-practices-for-developing-world-ready-apps.md)  
+ 国際対応 ASP.NET アプリケーションのグローバリゼーション、ローカリゼーション、および開発の推奨手順について説明します。  
+  
+## 関連項目  
+ <xref:System.Globalization?displayProperty=fullName> 名前空間  
+ 言語、国\/地域、使用する暦、日付、通貨、通知の書式パターン、文字列の並べ替え順序など、カルチャ関連の情報を定義するクラスが含まれています。  
+  
+ <xref:System.Resources> 名前空間  
+ リソースを作成、操作、および使用するためのクラスが格納されている名前空間です。  
+  
+ <xref:System.Text> 名前空間  
+ ASCII、ANSI、Unicode、およびその他の文字エンコーディングを表すクラスが格納されている名前空間です。  
+  
+ [Resgen.exe \(リソース ファイル ジェネレーター\)](../../../docs/framework/tools/resgen-exe-resource-file-generator.md)  
+ Resgen.exe を使用して .txt ファイルと XML ベース リソース フォーマット \(.resx\) ファイルを共通言語ランタイムのバイナリ .resources ファイルに変換する方法について説明します。  
+  
+ [Winres.exe \(Windows フォーム リソース エディター\)](../../../docs/framework/tools/winres-exe-windows-forms-resource-editor.md)  
+ Winres.exe を使用して Windows フォームのフォームをローカライズする方法について説明します。
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/localizability-review.md b/docs/standard/globalization-localization/localizability-review.md
new file mode 100644
index 00000000000..d82a124f73b
--- /dev/null
+++ b/docs/standard/globalization-localization/localizability-review.md
@@ -0,0 +1,81 @@
+---
+title: "ローカライズ化の確認 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "国際対応アプリケーション、ローカライズ可能性"
+  - "アプリケーション開発 [.NET Framework]、ローカライズ"
+  - "ローカライズ可能性 [.NET Framework]"
+  - "国際対応のアプリケーション [.NET Framework]、ローカライズ可能性"
+  - "グローバリゼーション [.NET Framework]、ローカライズ可能性"
+  - "カルチャ、ローカライズ可能性"
+  - "ローカリゼーション [.NET Framework]、ローカライズ可能性"
+  - "グローバル アプリケーション、ローカライズ可能性"
+  - "ローカライズ (リソースを)"
+ms.assetid: 3aee2fbb-de47-4e37-8fe4-ddebb9719247
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# ローカライズ化の確認
+ローカライズ対象の確認は、国際対応アプリケーションの開発中間ステップです。  グローバライズ済みアプリケーションがローカライズ可能であるかをチェックし、ユーザー インターフェイスのコードや特別な処理を必要とする要素を特定することができます。  この手順では、ローカリゼーション プロセス機能がアプリケーションに問題がないことを確認できます。  ローカライズ対象の確認によって発生させるすべての問題が扱われたら、アプリケーションはローカライズ可能です。  ローカライズ対象の確認が終わったら、ローカリゼーション プロセス中にソース・コードを変更する必要がありません。  
+  
+ ローカライズ対象の確認は、3 種類のチェックで構成されます。T:  
+  
+-   [グローバリゼーションの手法が実装されます。](#global)  
+  
+-   [カルチャに依存したな機能が正しく処理されます。](#culture)  
+  
+-   [International Data でアプリケーションをテストしているか。](#test)  
+  
+<a name="global"></a>   
+## グローバリゼーションの推奨事項を実装する  
+ 対象のローカリゼーションを使用してアプリケーションを実行すると、[グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md) のトピックで説明されている推奨事項に設計および開発するローカライズ対象の確認は主に、品質保証のパスです。  それ以外の場合、この段階で [グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md)"を確認し、実装するようにローカリゼーションを防ぐソース・コード内のエラーを修正します。  
+  
+<a name="culture"></a>   
+## カルチャに依存した機能を処理する  
+ .NET Framework は、カルチャによって大きく異なる複数の領域をプログラムではサポートされません。  ほとんどの場合、次のようなハンドル機能領域にカスタム コードを記述する必要があります:  
+  
+-   アドレス。  
+  
+-   電話番号。  
+  
+-   用紙サイズ。  
+  
+-   長さ、Weight、区分、ボリューム、温度に使用する測定単位。  .NET Framework が測定単位の変換のための組み込みサポートを提供しませんが、次の例に示すように、特定の国または地域のメトリック表記を使用するかどうかを判断するために <xref:System.Globalization.RegionInfo.IsMetric%2A?displayProperty=fullName> のプロパティを使用できます。  
+  
+     [!code-csharp[Conceptual.Localizability#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.localizability/cs/ismetric1.cs#1)]
+     [!code-vb[Conceptual.Localizability#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.localizability/vb/ismetric1.vb#1)]  
+  
+<a name="test"></a>   
+## アプリケーションをテストする  
+ アプリケーションをローカライズする前に、オペレーティング システムの各国語バージョンの各種言語のデータを使用して、アプリケーションをテストする必要があります。  ユーザー インターフェイスのほとんどはこの時点でローカライズされないが、次のような問題を検出する:  
+  
+-   オペレーティング システムのバージョンで正しく逆シリアル化せず、シリアル化されたデータ。  
+  
+-   現在のカルチャの規則を反映する数値データ。  たとえば、数が正しい桁区切り記号、小数点記号、または通貨記号と表示される場合があります。  
+  
+-   現在のカルチャの規則を反映する日付と時刻のデータ。  たとえば、月を表し、日が誤った順序で使用できる数値日付の区切り記号は正しくない場合があります。また、タイム ゾーン情報が正しくない場合があります。  
+  
+-   アプリケーションの既定のカルチャを指定しなかったため検出できないリソース。  
+  
+-   特定のカルチャの異なる順序で表示される文字列。  
+  
+-   同等の文字列比較または比較はに予想外の結果が生じます。  
+  
+ アプリケーション、処理されたカルチャに依存したな機能を適切に開発する場合、テストの実行中に発生したローカリゼーション問題で識別され、対処してグローバリゼーションの推奨事項に従っている場合、次の手順 [ローカリゼーション](../../../docs/standard/globalization-localization/localization.md)、に進むことができます。  
+  
+## 参照  
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)   
+ [ローカリゼーション](../../../docs/standard/globalization-localization/localization.md)   
+ [グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/localization.md b/docs/standard/globalization-localization/localization.md
new file mode 100644
index 00000000000..40a284c40e4
--- /dev/null
+++ b/docs/standard/globalization-localization/localization.md
@@ -0,0 +1,43 @@
+---
+title: "ローカリゼーション | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アプリケーション開発 [.NET Framework], ローカリゼーション"
+  - "コード ブロック"
+  - "カルチャ, ローカリゼーション"
+  - "グローバル アプリケーション, ローカリゼーション"
+  - "グローバリゼーション [.NET Framework], ローカリゼーション"
+  - "国際対応のアプリケーション [.NET Framework], ローカリゼーション"
+  - "ローカリゼーション [.NET Framework], ローカリゼーションの概要"
+  - "ローカライズ (リソースを)"
+  - "ユーザー インターフェイス ブロック"
+  - "国際対応アプリケーション, ローカリゼーション"
+ms.assetid: 49d520d7-92d7-44ee-bb24-8b615db1d41b
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# ローカリゼーション
+ローカリゼーションとは、アプリケーションのリソースを、アプリケーションでサポートする各カルチャのローカライズ バージョンへ翻訳する作業です。  [ローカライズ化の確認](../../../docs/standard/globalization-localization/localizability-review.md) ステップで、グローバライズ済みアプリケーションがローカライズ可能であることを確認してから、ローカリゼーションを開始してください。  
+  
+ ローカライズ可能なアプリケーションは、すべてのユーザー インターフェイス要素が格納されているブロックと、実行可能コードが格納されているブロックに分かれています。  ユーザー インターフェイス ブロックには、ニュートラル カルチャのローカライズ可能ユーザー インターフェイス要素 \(文字列、エラー メッセージ、ダイアログ ボックス、メニュー、埋め込みオブジェクト リソースなど\) だけが格納されています。  コード ブロックには、サポートされるすべてのカルチャで使用されるアプリケーション コードだけが格納されています。  共通言語ランタイムでサポートされているサテライト アセンブリ リソース モデルでは、アプリケーションの実行可能コードとリソースが分離されます。  このモデルの実装方法の詳細については、「[デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)」を参照してください。  
+  
+ アプリケーションのローカライズ バージョンごとに、サテライト アセンブリを追加します。このアセンブリには、対象カルチャの適切な言語に翻訳されたローカライズ済みユーザー インターフェイス ブロックが格納されます。  コード ブロックは、すべてのカルチャで同一です。  ユーザー インターフェイス ブロックのローカライズ バージョンとコード ブロックの組み合わせにより、アプリケーションのローカライズ バージョンが実現します。  
+  
+ [!INCLUDE[winsdklong](../../../includes/winsdklong-md.md)] に収録されている Windows フォーム リソース エディター \(Winres.exe\) を使用すると、Windows フォームを対象カルチャに合わせて簡単にローカライズできます。  このツールの使用方法については、「[Winres.exe \(Windows フォーム リソース エディター\)](../../../docs/framework/tools/winres-exe-windows-forms-resource-editor.md)」を参照してください。  
+  
+## 参照  
+ [グローバライズとローカライズ](../../../docs/standard/globalization-localization/index.md)   
+ [ローカライズ化の確認](../../../docs/standard/globalization-localization/localizability-review.md)   
+ [グローバリゼーション](../../../docs/standard/globalization-localization/globalization.md)   
+ [デスクトップ アプリケーションのリソース](../../../docs/framework/resources/index.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md b/docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md
new file mode 100644
index 00000000000..21c381985e9
--- /dev/null
+++ b/docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md
@@ -0,0 +1,78 @@
+---
+title: "カルチャを認識しない大文字と小文字の変更の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "String.ToLower メソッド"
+  - "カルチャ、大文字と小文字の区別"
+  - "Char.ToLower メソッド"
+  - "大文字と小文字、変更 (カルチャを認識しない文字列での)"
+  - "Char.ToUpper メソッド"
+  - "カルチャを認識しない文字列操作、大文字と小文字の変更"
+  - "String.ToUpper メソッド"
+  - "culture パラメーター"
+ms.assetid: 822d551c-c69a-4191-82f4-183d82c9179c
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# カルチャを認識しない大文字と小文字の変更の実行
+<xref:System.String.ToUpper%2A?displayProperty=fullName>、<xref:System.String.ToLower%2A?displayProperty=fullName>、<xref:System.Char.ToUpper%2A?displayProperty=fullName>、<xref:System.Char.ToLower%2A?displayProperty=fullName> の各メソッドには、パラメーターを受け取らないオーバーロードが用意されています。  既定では、パラメーターを使用しないこれらのオーバーロードは、<xref:System.Globalization.CultureInfo.CurrentCulture%2A?displayProperty=fullName> の値に基づいて大文字と小文字の変更を実行します。  このため、大文字と小文字を区別する結果がカルチャによって異なる場合があります。  大文字と小文字の変更がカルチャに依存するかどうかを明確にするには、`culture` パラメーターを明示的に指定する必要があるこれらのメソッドのオーバーロードを使用する必要があります。  大文字と小文字の変更がカルチャに依存する場合は、`culture` パラメーターとして `CultureInfo.CurrentCulture` を指定します。  大文字と小文字の変更がカルチャに依存しない場合は、`culture` パラメーターとして `CultureInfo.InvariantCulture` を指定します。  
+  
+ 後で検索しやすいように文字列の大文字と小文字を変換する場合があります。  文字列をこのように使用する場合は、`culture` パラメーターとして `CultureInfo.InvariantCulture` を指定する必要があります。<xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> の値が、大文字と小文字を変更してから検索が実行されるまでの間に変更される可能性があるからです。  
+  
+ セキュリティに関する決定が文字列の大文字と小文字の変更操作に基づいて行われる場合は、この操作がカルチャに依存しないようにして、操作の結果が `CultureInfo.CurrentCulture` の値により影響されないようにする必要があります。  カルチャに依存した文字列操作によって矛盾した結果がどのように生成されるかを示す例については、[文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md) の記事の「現在のカルチャを使用する文字列比較」の記事を参照してください。  
+  
+## String.ToUpper メソッドと String.ToLower メソッドの使用  
+ コードをわかりやすくするために、`culture` パラメーターを明示的に指定できる `String.ToUpper` メソッドと `String.ToLower` メソッドのオーバーロードを常に使用することをお勧めします。  識別子の検索を実行するコード例を次に示します。  `key.ToLower` 操作は既定ではカルチャを認識しますが、この動作はコードを見ても明確ではありません。  
+  
+### 例  
+  
+```vb  
+Shared Function LookupKey(key As String) As Object  
+   Return internalHashtable(key.ToLower())  
+End Function  
+  
+```  
+  
+```csharp  
+static object LookupKey(string key)   
+{  
+    return internalHashtable[key.ToLower()];  
+}  
+```  
+  
+ `key.ToLower` 操作がカルチャに依存しないようにする場合は、前の例を次のように変更して、大文字と小文字を変更するときに明示的に `CultureInfo.InvariantCulture` を使用します。  
+  
+```vb  
+Shared Function LookupKey(key As String) As Object  
+    Return internalHashtable(key.ToLower(CultureInfo.InvariantCulture))  
+End Function  
+  
+```  
+  
+```csharp  
+static object LookupKey(string key)   
+{  
+    return internalHashtable[key.ToLower(CultureInfo.InvariantCulture)];  
+}  
+```  
+  
+## Char.ToUpper メソッドと Char.ToLower メソッドの使用  
+ `Char.ToUpper` メソッドおよび `Char.ToLower` メソッドはそれぞれ `String.ToUpper` メソッドおよび `String.ToLower` メソッドと同じ特性を持っていますが、影響を受けるカルチャはトルコ語 \(トルコ\) およびアゼルバイジャン語 \(ラテン、アゼルバイジャン\) だけです。  単一の文字の大文字と小文字の区別が異なるのは、この 2 つのカルチャだけです。  この固有の大文字と小文字の対応の詳細については、<xref:System.String> クラスに関するトピックの「Casing \(大文字と小文字の指定\)」を参照してください。  コードをわかりやすくし、結果の一貫性を確保するために、`culture` パラメーターを明示的に指定できるこれらのメソッドのオーバーロードを常に使用することをお勧めします。  
+  
+## 参照  
+ <xref:System.String.ToUpper%2A?displayProperty=fullName>   
+ <xref:System.String.ToLower%2A?displayProperty=fullName>   
+ <xref:System.Char.ToUpper%2A?displayProperty=fullName>   
+ <xref:System.Char.ToLower%2A?displayProperty=fullName>   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md b/docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md
new file mode 100644
index 00000000000..8bfa9c45921
--- /dev/null
+++ b/docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md
@@ -0,0 +1,47 @@
+---
+title: "カルチャを認識しない文字列比較の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "culture パラメーター"
+  - "カルチャを認識しない文字列操作, 比較"
+  - "文字列比較 [.NET Framework], カルチャを認識しない"
+  - "String.Compare メソッド"
+  - "String.CompareTo メソッド"
+  - "文字列 [.NET Framework], 比較"
+ms.assetid: abae50ef-32f7-4a50-a540-fd256fd1aed0
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# カルチャを認識しない文字列比較の実行
+既定では、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドはカルチャを認識し、大文字と小文字を区別する比較を実行します。  また、このメソッドには、使用するカルチャを `culture` パラメーターで指定し、使用する比較規則を `comparisonType` パラメーターで指定できる、複数のオーバーロードが含まれています。  既定のオーバーロードの代わりにこれらのメソッドを呼び出すと、特定のメソッド呼び出しで使用する規則に関するあいまいさが解消され、特定の比較がカルチャに依存するかどうかが明確になります。  
+  
+> [!NOTE]
+>  <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドの両方のオーバーロードでは、カルチャに依存した比較と大文字と小文字を区別する比較を実行します。このメソッドを使用してカルチャに依存しない比較を実行することはできません。  コードをわかりやすくするために、<xref:System.String.Compare%2A?displayProperty=fullName> メソッドを代わりに使用することをお勧めします。  
+  
+ カルチャに依存する操作の場合は、`comparisonType` パラメーターとして <xref:System.StringComparison?displayProperty=fullName> 列挙値または <xref:System.StringComparison?displayProperty=fullName> 列挙値を指定します。  現在のカルチャ以外の指定されたカルチャを使用して、カルチャに依存した比較を実行する場合は、 パラメーターとして、そのカルチャを表す <xref:System.Globalization.CultureInfo> オブジェクトを指定します。  
+  
+ <xref:System.String.Compare%2A?displayProperty=fullName> メソッドでサポートされている、カルチャに依存しない文字列比較は、言語的な比較 \(インバリアント カルチャの並べ替え規則に基づきます\) または非言語的な比較 \(文字列内の文字の序数値に基づきます\) です。  カルチャに依存しないほとんどの文字列比較は非言語的な比較です。  このような比較の場合は、`comparisonType` パラメーターとして <xref:System.StringComparison?displayProperty=fullName> 列挙値または <xref:System.StringComparison?displayProperty=fullName> 列挙値を指定します。  たとえば、セキュリティに関する決定 \(ユーザー名やパスワードの比較など\) が文字列比較の結果に基づいて行われる場合は、この操作をカルチャに依存しない非言語的な比較に指定して、操作の結果が特定のカルチャまたは言語の規則に影響されないようにする必要があります  
+  
+ 複数のカルチャからの対応する文字列を一貫した方法で言語的に処理する場合は、カルチャに依存しない言語的な文字列比較を使用します。  たとえば、アプリケーションのリスト ボックスに表示する単語の一覧で複数の文字セットが使用されている場合などに、現在のカルチャに関係なく同じ順序で単語を表示することが必要になります。  カルチャに依存しない言語的な比較用に、英語の言語規則に基づくインバリアント カルチャが .NET Framework によって定義されています。  カルチャに依存しない言語的な比較を実行するには、`comparisonType` パラメーターとして <xref:System.StringComparison?displayProperty=fullName> または <xref:System.StringComparison?displayProperty=fullName> を指定します。  
+  
+ 次の例では、カルチャに依存しない 2 つの非言語的な文字列比較を実行します。  最初の例では大文字小文字が区別されますが、2 番目の例では区別されません。  
+  
+ [!code-csharp[Conceptual.Strings.CultureInsensitiveComparison#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.strings.cultureinsensitivecomparison/cs/cultureinsensitive1.cs#1)]
+ [!code-vb[Conceptual.Strings.CultureInsensitiveComparison#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.strings.cultureinsensitivecomparison/vb/cultureinsensitive1.vb#1)]  
+  
+## 参照  
+ <xref:System.String.Compare%2A?displayProperty=fullName>   
+ <xref:System.String.CompareTo%2A?displayProperty=fullName>   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)   
+ [文字列を使用するためのベスト プラクティス](../../../docs/standard/base-types/best-practices-strings.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-arrays.md b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-arrays.md
new file mode 100644
index 00000000000..9d61e455f9a
--- /dev/null
+++ b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-arrays.md
@@ -0,0 +1,32 @@
+---
+title: "カルチャを認識しない配列の操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "配列 [.NET Framework], カルチャを認識しない文字列操作"
+  - "comparer パラメーター"
+  - "カルチャを認識しない文字列操作, 配列で"
+ms.assetid: f12922e1-6234-4165-8896-63f0653ab478
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# カルチャを認識しない配列の操作の実行
+<xref:System.Array.Sort%2A?displayProperty=fullName> メソッドおよび <xref:System.Array.BinarySearch%2A?displayProperty=fullName> メソッドのオーバーロードは、既定では <xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティを使用してカルチャを認識する並べ替えを実行します。  これらのメソッドによって返されるカルチャを認識する結果は、並べ替えの順序が異なるため、カルチャごとに異なる可能性があります。  カルチャに依存する動作が行われないようにするには、`comparer` パラメーターを受け付けるこのメソッドのオーバーロードを使用します。  `comparer` パラメーターは、配列内の要素を比較するときに使用する <xref:System.Collections.IComparer> の実装を指定します。  このパラメーターには、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> を使用するカスタム インバリアント比較子クラスを指定します。  カスタム インバリアント比較子クラスの例については、「[カルチャを認識しないコレクションの操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md)」の「SortedList クラスの使用」を参照してください。  
+  
+ **メモ** 比較メソッドに **CultureInfo.InvariantCulture** を渡すと、カルチャに依存しない比較が実行されます。  ただし、この場合、ファイル パス、レジストリ キー、環境変数などに関する非言語的な比較は行われません。  また、比較結果に基づくセキュリティの決定もサポートされません。  非言語的な比較を行う場合、または結果に基づくセキュリティの決定をサポートする場合は、<xref:System.StringComparison> 値を受け取る比較メソッドを使用し、  <xref:System.StringComparison> を渡す必要があります。  
+  
+## 参照  
+ <xref:System.Array.Sort%2A?displayProperty=fullName>   
+ <xref:System.Array.BinarySearch%2A?displayProperty=fullName>   
+ <xref:System.Collections.IComparer>   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md
new file mode 100644
index 00000000000..37926cb3b1e
--- /dev/null
+++ b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md
@@ -0,0 +1,149 @@
+---
+title: "カルチャを認識しないコレクションの操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ArrayList.Sort メソッド"
+  - "CaseInsensitiveComparer クラス, 使用"
+  - "CaseInsensitiveHashCodeProvider クラス, 使用"
+  - "コレクション [.NET Framework], カルチャを認識しない文字列操作"
+  - "CollectionsUtil.CreateCaseInsensitiveHashtable メソッド"
+  - "culture パラメーター"
+  - "カルチャを認識しない文字列操作, コレクション"
+  - "SortedList クラス, カルチャを認識しない文字列操作"
+ms.assetid: 5cdc9396-a64b-4615-a1cd-b605db4c5983
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# カルチャを認識しないコレクションの操作の実行
+<xref:System.Collections> 名前空間には、既定の動作でカルチャに依存するクラスとメンバーがあります。  <xref:System.Collections.CaseInsensitiveComparer> クラスと <xref:System.Collections.CaseInsensitiveHashCodeProvider> クラスの既定のコンストラクターは、<xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> プロパティを使用して新しいインスタンスを初期化します。  [CollectionsUtil.CreateCaseInsensitiveHashTable](frlrfSystemCollectionsSpecializedCollectionsUtilClassCreateCaseInsensitiveHashtableTopic) メソッドのすべてのオーバーロードは、既定で `Thread.CurrentCulture` プロパティを使用して <xref:System.Collections.Hashtable> クラスの新しいインスタンスを作成します。  <xref:System.Collections.ArrayList.Sort%2A?displayProperty=fullName> メソッドのオーバーロードは、既定で `Thread.CurrentCulture` を使用してカルチャに依存した並べ替えを実行します。  文字列をキーとして使用する場合、<xref:System.Collections.SortedList> の並べ替えと検索は `Thread.CurrentCulture` の影響を受けることがあります。  `Collections` 名前空間のこれらのクラスおよびメソッドからカルチャに依存しない結果を取得するには、後で説明する使用に関する推奨事項に従ってください。  
+  
+ **メモ** 比較メソッドに <xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> を渡すと、カルチャに依存しない比較が実行されます。  ただし、この場合、ファイル パス、レジストリ キー、環境変数などに関する非言語的な比較は行われません。  また、比較結果に基づくセキュリティの決定もサポートされません。  非言語的な比較を行う場合、または結果に基づくセキュリティの決定をサポートする場合は、<xref:System.StringComparison> 値を受け取る比較メソッドを使用し、  <xref:System.StringComparison> を渡す必要があります。  
+  
+## CaseInsensitiveComparer クラスと CaseInsensitiveHashCodeProvider クラスの使用  
+ `CaseInsensitiveHashCodeProvider` と `CaseInsensitiveComparer` の既定のコンストラクターは、`Thread.CurrentCulture` を使用してクラスの新しいインスタンスを初期化するため、その動作はカルチャに依存します。  次のコード例に示す `Hashtable` のコンストラクターは、`CaseInsensitiveHashCodeProvider` と `CaseInsensitiveComparer` の既定のコンストラクターを使用しているため、カルチャに依存します。  
+  
+```vb  
+internalHashtable = New Hashtable(CaseInsensitiveHashCodeProvider.Default, CaseInsensitiveComparer.Default)  
+  
+```  
+  
+```csharp  
+internalHashtable = new Hashtable(CaseInsensitiveHashCodeProvider.Default, CaseInsensitiveComparer.Default);  
+```  
+  
+ `CaseInsensitiveComparer` クラスと `CaseInsensitiveHashCodeProvider` クラスを使用してカルチャに依存しない `Hashtable` を作成するには、`culture` パラメーターを受け取るコンストラクターを使用してこれらのクラスの新しいインスタンスを初期化します。  `culture` パラメーターには、<xref:System.Globalization.CultureInfo.InvariantCulture%2A?displayProperty=fullName> を指定します。  カルチャに依存しない `Hashtable` のコンストラクターを次のコード例に示します。  
+  
+```vb  
+internalHashtable = New Hashtable(New  
+    CaseInsensitiveHashCodeProvider(CultureInfo.InvariantCulture),  
+    New CaseInsensitiveComparer(CultureInfo.InvariantCulture))  
+  
+```  
+  
+```csharp  
+internalHashtable = new Hashtable(new CaseInsensitiveHashCodeProvider  
+    (CultureInfo.InvariantCulture),   
+    new CaseInsensitiveComparer(CultureInfo.InvariantCulture));  
+```  
+  
+## CollectionsUtil.CreateCaseInsensitiveHashTable メソッドの使用  
+ `CollectionsUtil.CreateCaseInsensitiveHashTable` メソッドは、文字列の大文字と小文字の区別を無視する `Hashtable` クラスの新しいインスタンスを作成するための便利なショートカットです。  ただし、`CollectionsUtil.CreateCaseInsensitiveHashTable` メソッドのオーバーロードはすべて `Thread.CurrentCulture` プロパティを使用するため、カルチャに依存します。  このメソッドを使用して、カルチャに依存しない `Hashtable` を作成することはできません。  カルチャに依存しない `Hashtable` を作成するには、`culture` パラメーターを受け取る `Hashtable` のコンストラクターを使用します。  `culture` パラメーターには、`CultureInfo.InvariantCulture` を指定します。  カルチャに依存しない `Hashtable` のコンストラクターを次のコード例に示します。  
+  
+```vb  
+internalHashtable = New Hashtable(New  
+    CaseInsensitiveHashCodeProvider(CultureInfo.InvariantCulture),  
+    New CaseInsensitiveComparer(CultureInfo.InvariantCulture))  
+  
+```  
+  
+```csharp  
+internalHashtable = new Hashtable(new CaseInsensitiveHashCodeProvider  
+    (CultureInfo.InvariantCulture),   
+    new CaseInsensitiveComparer(CultureInfo.InvariantCulture));  
+```  
+  
+<a name="cpconperformingculture-insensitivestringoperationsincollectionsanchor1"></a>   
+## SortedList クラスの使用  
+ `SortedList` は、キーで並べ替えられ、キーやインデックスでアクセスできるキーと値の組み合わせのコレクションを表します。  文字列がキーである `SortedList` を使用すると、並べ替えおよび検索が `Thread.CurrentCulture` プロパティの影響を受ける可能性があります。  `SortedList` の動作がカルチャに依存しないようにするには、`comparer` パラメーターを受け取るコンストラクターを使用して `SortedList` を作成します。  `comparer` パラメーターは、キーを比較するときに使用する <xref:System.Collections.IComparer> の実装を指定します。  このパラメーターには、`CultureInfo.InvariantCulture` を使用してキーを比較するカスタム比較子クラスを指定します。  `SortedList` コンストラクターの `comparer` パラメーターとして指定できる、カルチャに依存しないカスタム比較子クラスの例を次に示します。  
+  
+```vb  
+Imports System  
+Imports System.Collections  
+Imports System.Globalization  
+  
+Friend Class InvariantComparer  
+    Implements IComparer   
+    Private m_compareInfo As CompareInfo  
+    Friend Shared [Default] As New InvariantComparer()  
+  
+    Friend Sub New()  
+        m_compareInfo = CultureInfo.InvariantCulture.CompareInfo  
+    End Sub     
+  
+    Public Function Compare(a As Object, b As Object) As Integer _  
+            Implements IComparer.Compare  
+        Dim sa As String = CType(a, String)  
+        Dim sb As String = CType(b, String)  
+        If Not (sa Is Nothing) And Not (sb Is Nothing) Then  
+            Return m_compareInfo.Compare(sa, sb)  
+        Else  
+            Return Comparer.Default.Compare(a, b)  
+        End If  
+    End Function  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.Collections;  
+using System.Globalization;  
+  
+internal class InvariantComparer : IComparer   
+{  
+    private CompareInfo m_compareInfo;  
+    internal static readonly InvariantComparer Default = new  
+        InvariantComparer();  
+  
+    internal InvariantComparer()   
+    {  
+        m_compareInfo = CultureInfo.InvariantCulture.CompareInfo;  
+    }  
+  
+    public int Compare(Object a, Object b)  
+    {  
+        String sa = a as String;  
+        String sb = b as String;  
+        if (sa != null && sb != null)  
+            return m_compareInfo.Compare(sa, sb);  
+        else  
+            return Comparer.Default.Compare(a,b);  
+    }  
+}  
+```  
+  
+ 一般的に、カスタム インバリアント比較子を指定せずに、文字列に対して `SortedList` を使用した場合は、リストが作成された後に `Thread.CurrentCulture` を変更するとリストが無効になることがあります。  
+  
+## ArrayList.Sort メソッドの使用  
+ `ArrayList.Sort` メソッドのオーバーロードは、既定で `Thread.CurrentCulture` プロパティを使用してカルチャに依存した並べ替えを実行します。  結果は、並べ替えの順序が異なるため、カルチャごとに異なることがあります。  動作がカルチャに依存しないようにするには、`IComparer` 実装を受け取るこのメソッドのオーバーロードを使用します。  `comparer` パラメーターには、`CultureInfo.InvariantCulture` を使用するカスタム インバリアント比較子クラスを指定します。  カスタム インバリアント比較子クラスの例については、「[SortedList クラスの使用](#cpconperformingculture-insensitivestringoperationsincollectionsanchor1)」を参照してください。  
+  
+## 参照  
+ <xref:System.Collections.CaseInsensitiveComparer>   
+ <xref:System.Collections.CaseInsensitiveHashCodeProvider>   
+ <xref:System.Collections.ArrayList.Sort%2A?displayProperty=fullName>   
+ <xref:System.Collections.SortedList>   
+ <xref:System.Collections.Hashtable>   
+ <xref:System.Collections.IComparer>   
+ [カルチャを認識しない文字列操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md)   
+ [CollectionsUtil.CreateCaseInsensitiveHashTable メソッド](frlrfSystemCollectionsSpecializedCollectionsUtilClassCreateCaseInsensitiveHashtableTopic)
\ No newline at end of file
diff --git a/docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md
new file mode 100644
index 00000000000..0549cfd76fa
--- /dev/null
+++ b/docs/standard/globalization-localization/performing-culture-insensitive-string-operations.md
@@ -0,0 +1,47 @@
+---
+title: "カルチャを認識しない文字列操作の実行 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "大文字小文字マップ"
+  - "カスタムの大文字小文字マップ"
+  - "カルチャ、カスタムの並べ替え規則"
+  - "カスタムの並べ替え規則"
+  - "カルチャを認識しない文字列の操作、オプション (実行のための)"
+  - "カルチャ、カスタムの大文字小文字マップ"
+  - "カルチャを認識しない文字列操作、メソッドのオーバーロード"
+ms.assetid: 579ef891-1f83-4c63-9ebd-2f40406b5b91
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# カルチャを認識しない文字列操作の実行
+カルチャに依存した文字列操作が既定の動作になっているほとんどの .NET Framework メソッドには、<xref:System.Globalization.CultureInfo> パラメーターを渡すことによってカルチャを明示的に指定できるオーバーロード メソッドが用意されています。  これらのオーバーロードによって、大文字小文字のマップおよび並べ替え規則のカルチャによる違いを排除し、カルチャに依存しない結果を確保できます。  
+  
+ ここでは、既定ではカルチャを認識する .NET Framework のメソッドを使用して、カルチャを認識しない文字列操作を実行する方法を説明します。  
+  
+## このセクションの内容  
+ [カルチャを認識しない文字列比較の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-comparisons.md)  
+ <xref:System.String.Compare%2A?displayProperty=fullName> メソッドおよび <xref:System.String.CompareTo%2A?displayProperty=fullName> メソッドを使用してカルチャに依存しない文字列比較を実行する方法について説明します。  
+  
+ [カルチャを認識しない大文字と小文字の変更の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-case-changes.md)  
+ <xref:System.String.ToUpper%2A?displayProperty=fullName>、<xref:System.String.ToLower%2A?displayProperty=fullName>、<xref:System.Char.ToUpper%2A?displayProperty=fullName>、<xref:System.Char.ToLower%2A?displayProperty=fullName> の各メソッドを使用してカルチャに依存しない大文字と小文字の変換を実行する方法について説明します。  
+  
+ [カルチャを認識しないコレクションの操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-collections.md)  
+ [CaseInsensitiveComparer クラス](frlrfSystemCollectionsCaseInsensitiveComparerClassTopic)、<xref:System.Collections.CaseInsensitiveHashCodeProvider> クラス、[SortedList クラス](frlrfSystemCollectionsSortedListClassTopic)、[ArrayList.Sort メソッド](https://msdn.microsoft.com/en-us/library/system.collections.arraylist.sort.aspx)、および [CollectionsUtil.CreateCaseInsensitiveHashtable メソッド](frlrfSystemCollectionsSpecializedCollectionsUtilClassCreateCaseInsensitiveHashtableTopic)を使用して、コレクションでカルチャに依存しない操作を実行する方法について説明します。  
+  
+ [カルチャを認識しない配列の操作の実行](../../../docs/standard/globalization-localization/performing-culture-insensitive-string-operations-in-arrays.md)  
+ <xref:System.Array.Sort%2A?displayProperty=fullName> メソッドおよび <xref:System.Array.BinarySearch%2A?displayProperty=fullName> メソッドを使用してカルチャに依存しない配列の操作を実行する方法について説明します。  
+  
+## 関連項目  
+ [カルチャを認識しない文字列操作](../../../docs/standard/globalization-localization/culture-insensitive-string-operations.md)  
+ 文字列操作を実行する際にカルチャに注意する理由について説明し、カルチャを認識する操作を実行するときとカルチャを認識しない操作を実行するときのガイドラインを示します。
\ No newline at end of file
diff --git a/docs/standard/io/TOC.md b/docs/standard/io/TOC.md
new file mode 100644
index 00000000000..62434761469
--- /dev/null
+++ b/docs/standard/io/TOC.md
@@ -0,0 +1,29 @@
+# [方法 : 分離ストレージでストアを取得する](how-to-obtain-stores-for-isolated-storage.md)
+# [方法 : 分離ストレージ内でファイルの読み取りと書き込みを行う](how-to-read-and-write-to-files-in-isolated-storage.md)
+# [方法 : ファイルからテキストを読み取る](how-to-read-text-from-a-file.md)
+# [方法 : 分離ストレージ内でファイルおよびディレクトリを検索する](how-to-find-existing-files-and-directories-in-isolated-storage.md)
+# [方法 : ファイルを圧縮して抽出する](how-to-compress-and-extract-files.md)
+# [方法: ローカルのプロセス間通信で匿名パイプを使用する](how-to-use-anonymous-pipes-for-local-interprocess-communication.md)
+# [方法: 分離ストレージの領域不足状態に備える](how-to-anticipate-out-of-space-conditions-with-isolated-storage.md)
+# [方法 : 新しく作成されたデータ ファイルに対して読み書きする](how-to-read-and-write-to-a-newly-created-data-file.md)
+# [非同期ファイル I/O](非同期ファイル-i-o.md)
+# [ストリームの構成](composing-streams.md)
+# [共通 I/O タスク](commons-tasks.md)
+# [分離ストレージ](isolated-storage.md)
+# [メモリ マップト ファイル](memory-mapped-files.md)
+# [方法 : 分離ストレージでファイルおよびディレクトリを削除する](how-to-delete-files-and-directories-in-isolated-storage.md)
+# [方法: ディレクトリとファイルを列挙する](how-to-enumerate-directories-and-files.md)
+# [パイプ](pipe-operations.md)
+# [方法 : ログ ファイルを開いて情報を追加する](how-to-open-and-append-to-a-log-file.md)
+# [方法 : ディレクトリをコピーする](how-to-copy-directories.md)
+# [方法 : アクセス制御リスト エントリを追加または削除する](how-to-add-or-remove-access-control-list-entries.md)
+# [ファイルおよびストリーム入出力](index.md)
+# [方法: ネットワークのプロセス間通信で名前付きパイプを使用する](how-to-use-named-pipes-for-network-interprocess-communication.md)
+# [方法 : 分離ストレージでストアを削除する](how-to-delete-stores-in-isolated-storage.md)
+# [方法 : 分離ストレージでファイルおよびディレクトリを作成する](how-to-create-files-and-directories-in-isolated-storage.md)
+# [方法 : 文字列から文字を読み取る](how-to-read-characters-from-a-string.md)
+# [方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う](how-to-convert-between-dotnet-streams-and-winrt-streams.md)
+# [分離のタイプ](types-of-isolation.md)
+# [方法 : 文字列に文字を書き込む](how-to-write-characters-to-a-string.md)
+# [方法 : 分離ストレージでストアを列挙する](how-to-enumerate-stores-for-isolated-storage.md)
+# [方法 : ファイルにテキストを書き込む](how-to-write-text-to-a-file.md)
diff --git a/docs/standard/io/commons-tasks.md b/docs/standard/io/commons-tasks.md
new file mode 100644
index 00000000000..4b3f9181291
--- /dev/null
+++ b/docs/standard/io/commons-tasks.md
@@ -0,0 +1,62 @@
+---
+title: "共通 I/O タスク | Microsoft Docs"
+ms.custom: ""
+ms.date: "12/15/2016"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "I/O, 一般的なタスク"
+ms.assetid: bf00c380-706a-4e38-b829-454a480629fc
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+---
+# 共通 I/O タスク
+<xref:System.IO> 名前空間には、読み取り、書き込みなどの各種アクションをファイル、ディレクトリ、およびストリーム上で実行できるようにするいくつかのクラスが用意されています。  詳細については、「[ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)」を参照してください。  
+  
+## 共通ファイル タスク  
+  
+|目的|参照項目|  
+|--------|----------|  
+|テキスト ファイルの作成|<xref:System.IO.File.CreateText%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.CreateText%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.File.Create%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.Create%2A?displayProperty=fullName> メソッド|  
+|テキスト ファイルへの書き込み|[方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)<br /><br /> [方法: テキスト ファイルを記述する](../Topic/How%20to:%20Write%20a%20Text%20File%20\(C++-CLI\).md)|  
+|テキスト ファイルからの読み取り|[方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)|  
+|ファイルへのテキストの追加|[方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)<br /><br /> <xref:System.IO.File.AppendText%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.AppendText%2A?displayProperty=fullName> メソッド|  
+|ファイル名の変更またはファイルの移動|<xref:System.IO.File.Move%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.MoveTo%2A?displayProperty=fullName> メソッド|  
+|ファイルの削除|<xref:System.IO.File.Delete%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.Delete%2A?displayProperty=fullName> メソッド|  
+|ファイルのコピー|<xref:System.IO.File.Copy%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.CopyTo%2A?displayProperty=fullName> メソッド|  
+|ファイルのサイズの取得|<xref:System.IO.FileInfo.Length%2A?displayProperty=fullName> プロパティ|  
+|ファイルの属性の取得|<xref:System.IO.File.GetAttributes%2A?displayProperty=fullName> メソッド|  
+|ファイルの属性の設定|<xref:System.IO.File.SetAttributes%2A?displayProperty=fullName> メソッド|  
+|ファイルが存在するかどうかの確認|<xref:System.IO.File.Exists%2A?displayProperty=fullName> メソッド|  
+|バイナリ ファイルからの読み取り|[方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)|  
+|バイナリ ファイルへの書き込み|[方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)|  
+|ファイル名拡張子の取得|<xref:System.IO.Path.GetExtension%2A?displayProperty=fullName> メソッド|  
+|ファイルの絶対パスの取得|<xref:System.IO.Path.GetFullPath%2A?displayProperty=fullName> メソッド|  
+|パスからのファイル名と拡張子の取得|<xref:System.IO.Path.GetFileName%2A?displayProperty=fullName> メソッド|  
+|ファイルの拡張子の変更|<xref:System.IO.Path.ChangeExtension%2A?displayProperty=fullName> メソッド|  
+  
+## 共通ディレクトリ タスク  
+  
+|目的|参照項目|  
+|--------|----------|  
+|My Documents などの特別なフォルダー内のファイルへのアクセス|[方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)|  
+|ディレクトリの作成|<xref:System.IO.Directory.CreateDirectory%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.FileInfo.Directory%2A?displayProperty=fullName> プロパティ|  
+|サブディレクトリの作成|<xref:System.IO.DirectoryInfo.CreateSubdirectory%2A?displayProperty=fullName> メソッド|  
+|ディレクトリ名の変更またはディレクトリの移動|<xref:System.IO.Directory.Move%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.DirectoryInfo.MoveTo%2A?displayProperty=fullName> メソッド|  
+|ディレクトリのコピー|[方法 : ディレクトリをコピーする](../../../docs/standard/io/how-to-copy-directories.md)|  
+|ディレクトリの削除|<xref:System.IO.Directory.Delete%2A?displayProperty=fullName> メソッド<br /><br /> <xref:System.IO.DirectoryInfo.Delete%2A?displayProperty=fullName> メソッド|  
+|ディレクトリ内のファイルとサブディレクトリの確認|[方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)|  
+|ディレクトリのサイズの確認|<xref:System.IO.Directory?displayProperty=fullName> クラス|  
+|ディレクトリが存在するかどうかの確認|<xref:System.IO.Directory.Exists%2A?displayProperty=fullName> メソッド|  
+  
+## 参照  
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [ストリームの構成](../../../docs/standard/io/composing-streams.md)   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)
\ No newline at end of file
diff --git a/docs/standard/io/composing-streams.md b/docs/standard/io/composing-streams.md
new file mode 100644
index 00000000000..5d6c99f19f6
--- /dev/null
+++ b/docs/standard/io/composing-streams.md
@@ -0,0 +1,49 @@
+---
+title: "ストリームの構成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストリーム、基本ストリーム"
+  - "I/O [.NET Framework]、構成 (ストリームの)"
+  - "Stream クラス、構成 (ストリームの)"
+  - "基本ストリーム"
+  - "ストリーム、バッキング ストア"
+ms.assetid: da761658-a535-4f26-a452-b30df47f73d5
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# ストリームの構成
+バッキング ストアとは、ディスクやメモリのようなストレージ メディアのことです。  各種のバッキング ストアのそれぞれが、<xref:System.IO.Stream> クラスの実装として独自のストリームを実装しています。  各ストリーム型は、関連付けられたバッキング ストアからバイトを読み取ったり書き込んだりします。  バッキング ストアに関連付けられたストリームは、基本ストリームと呼ばれます。  基本ストリームには、ストリームをバッキング ストアに関連付けるために必要なパラメーターを持つコンストラクターがあります。  たとえば、<xref:System.IO.FileStream> には、プロセス間でファイルを共有する方法を指定するパス パラメーターなどを指定するコンストラクターがあります。  
+  
+ <xref:System.IO> クラスは、ストリームを簡単に構成できるようにデザインされています。  基本ストリームは、必要な機能を提供する 1 つ以上のパススルー ストリームに結合できます。  必要な型を簡単に読み取ったり書き込んだりできるように、チェインの末尾にリーダーまたはライターを結合できます。  
+  
+ 既存の `MyFile.txt` をバッファリングするために、`MyFile.txt` に対して **FileStream** を作成するコードの例を次に示します。**FileStreams** は、既定でバッファリングされます。次に、**FileStream** から文字を読み取るために <xref:System.IO.StreamReader> を作成します。FileStream は、コンストラクター引数として **StreamReader** に渡されます  <xref:System.IO.StreamReader.ReadLine%2A> は、<xref:System.IO.StreamReader.Peek%2A> が文字を検出できなくなるまで文字を読み取ります。  
+  
+ [!code-cpp[System.IO.StreamReader#20](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.StreamReader/CPP/source2.cpp#20)]
+ [!code-csharp[System.IO.StreamReader#20](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.StreamReader/CS/source2.cs#20)]
+ [!code-vb[System.IO.StreamReader#20](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamReader/VB/source2.vb#20)]  
+  
+ 既存の `MyFile.txt` をバッファリングするために、`MyFile.txt` に対して **FileStream** を作成するコードの例を次に示します。**FileStreams** は、既定でバッファリングされます。次に、**FileStream** からバイトを読み取るための **BinaryReader** を作成します。FileStream は、コンストラクター引数として **StreamReader** に渡されます  <xref:System.IO.BinaryReader.ReadByte%2A> は、<xref:System.IO.BinaryReader.PeekChar%2A> がバイトを検出できなくなるまでバイトを読み取ります。  
+  
+ [!code-cpp[System.IO.StreamReader#21](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.StreamReader/CPP/source3.cpp#21)]
+ [!code-csharp[System.IO.StreamReader#21](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.StreamReader/CS/source3.cs#21)]
+ [!code-vb[System.IO.StreamReader#21](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamReader/VB/source3.vb#21)]  
+  
+## 参照  
+ <xref:System.IO.StreamReader>   
+ <xref:System.IO.StreamReader.ReadLine%2A?displayProperty=fullName>   
+ <xref:System.IO.StreamReader.Peek%2A?displayProperty=fullName>   
+ <xref:System.IO.FileStream>   
+ <xref:System.IO.BinaryReader>   
+ <xref:System.IO.BinaryReader.ReadByte%2A?displayProperty=fullName>   
+ <xref:System.IO.BinaryReader.PeekChar%2A?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/io/how-to-add-or-remove-access-control-list-entries.md b/docs/standard/io/how-to-add-or-remove-access-control-list-entries.md
new file mode 100644
index 00000000000..cf3a6664b37
--- /dev/null
+++ b/docs/standard/io/how-to-add-or-remove-access-control-list-entries.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : アクセス制御リスト エントリを追加または削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "アクセス制御エントリ [.NET Framework]"
+  - "アクセス制御リスト [.NET Framework]"
+  - "ACE [.NET Framework]"
+  - "ACL [.NET Framework]"
+  - "I/O [.NET Framework], アクセス制御リストのエントリ"
+ms.assetid: 53758b39-bd9b-4640-bb04-cad5ed8d0abf
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : アクセス制御リスト エントリを追加または削除する
+ファイルでアクセス制御リスト \(ACL\) エントリを追加または削除するには、<xref:System.Security.AccessControl.FileSecurity> または <xref:System.Security.AccessControl.DirectorySecurity> オブジェクトをファイルまたはディレクトリから取得して変更し、元のファイルまたはディレクトリに適用する必要があります。  
+  
+### ファイルで ACL エントリの追加または削除を行うには  
+  
+1.  <xref:System.IO.File.GetAccessControl%2A> メソッドを呼び出して、ファイルの現在の ACL エントリを含む <xref:System.Security.AccessControl.FileSecurity> オブジェクトを取得します。  
+  
+2.  手順 1. から返された <xref:System.Security.AccessControl.FileSecurity> オブジェクトで ACL エントリの追加または削除を行います。  
+  
+3.  <xref:System.Security.AccessControl.FileSecurity> オブジェクトを <xref:System.IO.File.SetAccessControl%2A> メソッドに渡し、変更を適用します。  
+  
+### ディレクトリで ACL エントリの追加または削除を行うには  
+  
+1.  <xref:System.IO.Directory.GetAccessControl%2A> メソッドを呼び出して、ディレクトリの現在の ACL エントリを含む <xref:System.Security.AccessControl.DirectorySecurity> オブジェクトを取得します。  
+  
+2.  手順 1. から返された <xref:System.Security.AccessControl.DirectorySecurity> オブジェクトで ACL エントリの追加または削除を行います。  
+  
+3.  <xref:System.Security.AccessControl.DirectorySecurity> オブジェクトを <xref:System.IO.Directory.SetAccessControl%2A> メソッドに渡し、変更を適用します。  
+  
+## 使用例  
+ [!code-cpp[IO.File.GetAccessControl-SetAccessControl#1](../../../samples/snippets/cpp/VS_Snippets_CLR/IO.File.GetAccessControl-SetAccessControl/cpp/sample.cpp#1)]
+ [!code-csharp[IO.File.GetAccessControl-SetAccessControl#1](../../../samples/snippets/csharp/VS_Snippets_CLR/IO.File.GetAccessControl-SetAccessControl/CS/sample.cs#1)]
+ [!code-vb[IO.File.GetAccessControl-SetAccessControl#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/IO.File.GetAccessControl-SetAccessControl/VB/sample.vb#1)]  
+  
+## コードのコンパイル  
+ この例を実行するには、有効なユーザーまたはグループ アカウントを指定する必要があります。  この例では <xref:System.IO.File> オブジェクトを使用していますが、<xref:System.IO.FileInfo>、<xref:System.IO.Directory>、および <xref:System.IO.DirectoryInfo> クラスにも同じ手順が使用されます。
\ No newline at end of file
diff --git a/docs/standard/io/how-to-anticipate-out-of-space-conditions-with-isolated-storage.md b/docs/standard/io/how-to-anticipate-out-of-space-conditions-with-isolated-storage.md
new file mode 100644
index 00000000000..513ec73d0d5
--- /dev/null
+++ b/docs/standard/io/how-to-anticipate-out-of-space-conditions-with-isolated-storage.md
@@ -0,0 +1,51 @@
+---
+title: "方法: 分離ストレージの領域不足状態に備える | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストア、クォータ"
+  - "分離ストレージ、クォータ"
+  - "量 (使用する分離ストレージの)"
+  - "制限 (使用する分離ストレージに対する)"
+  - "ストア、クォータ"
+  - "ストア、領域不足の状態"
+  - "データ ストレージ (分離ストレージを使用した)、クォータ"
+  - "格納 (分離ストレージを使用したデータの)、クォータ"
+  - "領域 (分離ストレージの残りの)"
+  - "データ ストア、領域不足の状態"
+  - "格納 (分離ストレージを使用したデータの)、領域不足の状態"
+  - "クォータ (分離ストレージの)"
+  - "分離ストレージ、領域不足の状態"
+  - "データ ストレージ (分離ストレージを使用した)、領域不足の状態"
+ms.assetid: e35d4535-3732-421e-b1a3-37412e036145
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法: 分離ストレージの領域不足状態に備える
+分離ストレージを使用するコードは、分離ストレージ ファイルおよびディレクトリが格納されているデータ コンパートメントの最大サイズを指定する[クォータ](../../../docs/standard/io/isolated-storage.md#quotas)によって制約されます。  クォータは、セキュリティ ポリシーによって定義され、管理者が構成できます。  データを書き込むときに最大許容サイズを超えると <xref:System.IO.IsolatedStorage.IsolatedStorageException> 例外がスローされ、操作は失敗します。  これにより、データ ストレージがいっぱいになると、アプリケーションに要求を拒否させる不当なサービス拒否攻撃を防止できます。  
+  
+ 指定した書き込みがこのような理由で失敗する可能性があるかどうかを判断できるように、<xref:System.IO.IsolatedStorage.IsolatedStorage> クラスには、<xref:System.IO.IsolatedStorage.IsolatedStorage.AvailableFreeSpace%2A>、<xref:System.IO.IsolatedStorage.IsolatedStorage.UsedSize%2A>、および <xref:System.IO.IsolatedStorage.IsolatedStorage.Quota%2A> の 3 つの読み取り専用プロパティが用意されています。  ストアへの書き込みがストアの最大許容サイズを超過するかどうかを判断するためにこれらのプロパティを使用できます。  分離ストレージは同時にアクセスできることに注意してください。; したがって、残りのストレージの量を計算するときに、も、そのストアに書き込むまでに使用できます。  ただし、使用できるメモリの上限に達するとしているかどうかを確認するには、ストアの最大サイズを使用できます。  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorage.Quota%2A> のプロパティはアセンブリの証拠によって正しく機能します。  したがって、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForAssembly%2A>、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForDomain%2A>、または <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のメソッドを使用して作成された <xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトにのみこのプロパティを取得する必要があります。   他の方法で作成された<xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクト \(たとえば、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator%2A> のメソッドから返されるオブジェクト\) 正確な最大サイズを返します。  
+  
+## 例  
+ 分離されたストアを取得し、いくつかのファイルを作成して、<xref:System.IO.IsolatedStorage.IsolatedStorage.AvailableFreeSpace%2A> プロパティを取得するコード例を次に示します。  残りの容量は、バイト数で報告されます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#8](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source7.cpp#8)]
+ [!code-csharp[Conceptual.IsolatedStorage#8](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source7.cs#8)]
+ [!code-vb[Conceptual.IsolatedStorage#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source7.vb#8)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)   
+ [方法 : 分離ストレージでストアを取得する](../../../docs/standard/io/how-to-obtain-stores-for-isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-compress-and-extract-files.md b/docs/standard/io/how-to-compress-and-extract-files.md
new file mode 100644
index 00000000000..9f9eb26b002
--- /dev/null
+++ b/docs/standard/io/how-to-compress-and-extract-files.md
@@ -0,0 +1,68 @@
+---
+title: "方法 : ファイルを圧縮して抽出する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "I/O [.NET Framework]、圧縮"
+  - "圧縮"
+  - "圧縮 (ファイルを)"
+ms.assetid: e9876165-3c60-4c84-a272-513e47acf579
+caps.latest.revision: 19
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : ファイルを圧縮して抽出する
+<xref:System.IO.Compression> の名前空間は、ファイル、およびストリームを圧縮および圧縮解除するための型が含まれています。  、圧縮ファイルの内容を読み取って変更するには、これらの型を使用する:  
+  
+-   <xref:System.IO.Compression.ZipFile>  
+  
+-   <xref:System.IO.Compression.ZipArchive>  
+  
+-   <xref:System.IO.Compression.ZipArchiveEntry>  
+  
+-   <xref:System.IO.Compression.DeflateStream>  
+  
+-   <xref:System.IO.Compression.GZipStream>  
+  
+ 次の例では、圧縮ファイルとする関数の中に作業するときに実行されます。  
+  
+## 使用例  
+ この例で <xref:System.IO.Compression.ZipFile> クラスを使用して .zip ファイル名拡張子を持つ圧縮ファイルを作成および取得する方法を示します。  次に新しいフォルダーが完成した新しい抽出 .zip ファイルに含まれ、フォルダーの内容を圧縮します。  <xref:System.IO.Compression.ZipFile> クラスを使用するには、プロジェクトで `System.IO.Compression.FileSystem` アセンブリを参照する必要があります。  
+  
+ [!code-csharp[System.IO.Compression.ZipFile#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.compression.zipfile/cs/program1.cs#1)]
+ [!code-vb[System.IO.Compression.ZipFile#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.compression.zipfile/vb/program1.vb#1)]  
+  
+## 使用例  
+ 次の例は、既存の .zip ファイルの内容を反復処理し .txt の拡張子を持つファイルを取得する方法を示します。  これは <xref:System.IO.Compression.ZipArchive> クラスおよび圧縮ファイルのエントリをチェックする既存の .zip ファイルにアクセスするために <xref:System.IO.Compression.ZipArchiveEntry> クラスを使用します。  これは <xref:System.IO.Compression.ZipArchiveEntry> オブジェクトに拡張メソッド \(<xref:System.IO.Compression.ZipFileExtensions.ExtractToFile%2A>\) を使用します。  拡張メソッドは <xref:System.IO.Compression.ZipFileExtensions?displayProperty=fullName> クラスで使用できます。  <xref:System.IO.Compression.ZipFileExtensions> クラスを使用するには、プロジェクトで `System.IO.Compression.FileSystem` アセンブリを参照する必要があります。  
+  
+ [!code-csharp[System.IO.Compression.ZipArchive#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.compression.ziparchive/cs/program1.cs#1)]
+ [!code-vb[System.IO.Compression.ZipArchive#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.compression.ziparchive/vb/program1.vb#1)]  
+  
+## 使用例  
+ 次の例は、既存の .zip ファイルにアクセスするために <xref:System.IO.Compression.ZipArchive> クラスを使用して、圧縮ファイルに新しいファイルを追加します。  新しいファイルは既存の .zip ファイルに追加するときに圧縮される取得します。  
+  
+ [!code-csharp[System.IO.Compression.ZipArchiveMode#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.compression.ziparchivemode/cs/program1.cs#1)]
+ [!code-vb[System.IO.Compression.ZipArchiveMode#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.compression.ziparchivemode/vb/program1.vb#1)]  
+  
+## 使用例  
+ データを圧縮および圧縮解除するために <xref:System.IO.Compression.GZipStream> と <xref:System.IO.Compression.DeflateStream> クラスを使用できます。  これらは同じ圧縮アルゴリズムを使用します。  .gz の拡張子を持つファイルに書き込まれた <xref:System.IO.Compression.GZipStream> の圧縮オブジェクトは <xref:System.IO.Compression.GZipStream>によって提供されるメソッドに加え、の標準ツールを使用して圧縮解除することができます。  次の例では、<xref:System.IO.Compression.GZipStream> クラスを使用して、ファイルのディレクトリを圧縮および圧縮解除する方法を示します。  
+  
+ [!code-csharp[IO.Compression.GZip1#1](../../../samples/snippets/csharp/VS_Snippets_CLR/IO.Compression.GZip1/CS/gziptest.cs#1)]
+ [!code-vb[IO.Compression.GZip1#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/IO.Compression.GZip1/VB/gziptest.vb#1)]  
+  
+## 参照  
+ <xref:System.IO.Compression.ZipArchive>   
+ <xref:System.IO.Compression.ZipFile>   
+ <xref:System.IO.Compression.ZipArchiveEntry>   
+ <xref:System.IO.Compression.DeflateStream>   
+ <xref:System.IO.Compression.GZipStream>   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md b/docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md
new file mode 100644
index 00000000000..42862e06f81
--- /dev/null
+++ b/docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md
@@ -0,0 +1,86 @@
+---
+title: "方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+ms.assetid: 23a763ea-8348-4244-9f8c-a4280b870b47
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う
+Windows ストア アプリ用 .NET Framework は、完全な .NET Framework のサブセットです。 Windows ストア アプリのセキュリティおよびその他の要件のために、ファイルを開いたり読み取ったりするために使用する .NET Framework API の完全なセットを使用できません。 詳細については、[「Windows ストア アプリ用 .NET の概要」](http://msdn.microsoft.com/library/windows/apps/br230302.aspx)を参照してください。 ただし、他のストリームの処理操作のために .NET Framework API を使用することもできます。 これらのストリームを操作するには、<xref:System.IO.MemoryStream> や <xref:System.IO.FileStream> などの .NET Framework ストリーム型と、[IInputStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.iinputstream.aspx)、[IOutputStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.ioutputstream.aspx)、[IRandomAccessStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.irandomaccessstream.aspx) などの Windows ランタイム ストリームの間で変換が必要になる場合があります。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions> クラスには、これらの変換を簡単にするメソッドが含まれています。 ただし、.NET Framework と Windows ランタイムのストリームには、これらのメソッドの使用結果に影響する、根本的な違いがあります。 詳細については、以下のセクションで説明します。  
+  
+<a name="BKMK_ConvertingfromaWindowsRuntimestreamtoaNETFrameworkstream"></a>   
+## Windows ランタイム ストリームから .NET Framework ストリームへの変換  
+ 次の <xref:System.IO.WindowsRuntimeStreamExtensions> メソッドのうちの 1 つを使用して、Windows ランタイム ストリームから .NET Framework ストリームに変換できます。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions.AsStream%2A>  
+ Windows ランタイムのランダムアクセス ストリームを、Windows ストア アプリ用 .NET のサブセットのマネージ ストリームに変換します。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForWrite%2A>  
+ Windows ランタイムの出力ストリームを、Windows ストア アプリ用 .NET のサブセットのマネージ ストリームに変換します。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForRead%2A>  
+ Windows ランタイムの入力ストリームを、Windows ストア アプリ用 .NET のサブセットのマネージ ストリームに変換します。  
+  
+ Windows ランタイムには、読み取り専用、書き込み専用、または読み取りと書き込みをサポートするストリーム型があり、これらの機能は Windows ランタイム ストリームを .NET Framework ストリームに変換した場合にも維持されます。 さらに、Windows ランタイム ストリームを .NET Framework ストリームに変換してから元に戻すと、元の Windows ランタイム インスタンスに戻ります。 変換する Windows ランタイム ストリームの機能と一致する変換メソッドを使用することをお勧めします。 ただし、[IRandomAccessStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.irandomaccessstream.aspx) は読み取りも書き込みも可能なので \([IOutputStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.ioutputstream.aspx) と [IInputStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.iinputstream.aspx) の両方を実装しているので\)、どの変換メソッドを使用しても元のストリームの機能を保持できます。 たとえば、<xref:System.IO.WindowsRuntimeStreamExtensions.AsStreamForRead%2A> を使用して [IRandomAccessStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.irandomaccessstream.aspx) を変換すると、変換された .NET Framework ストリームは読み取りだけに制限されず、書き込みも可能になります。  
+  
+#### Windows ランタイム ランダムアクセス ストリームから .NET Framework ストリームに変換するには  
+  
+-   <xref:System.IO.WindowsRuntimeStreamExtensions.AsStream%2A> メソッドを使用します。  
+  
+     ユーザーにファイルを選択するように要求し、Windows ランタイム API で開いて、.NET Framework のストリームに変換し、読み取ってテキスト ブロックへ出力する方法を次のコード例に示します。 このシナリオでは、通常、結果を出力する前に .NET Framework API でストリームを処理します。  
+  
+     この例を実行するには、`TextBlock1` という名前のテキスト ブロックと `Button1` という名前のボタンを含む Windows ストア XAML アプリを作成する必要があります。 ボタン クリック イベントは、例に示す `button1_Click` メソッドに関連付けられている必要があります。  
+  
+     [!code-csharp[System.IO.WindowsRuntimeStreamExtensionsEx#Imports](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/cs/mainpage.xaml.cs#imports)]
+     [!code-vb[System.IO.WindowsRuntimeStreamExtensionsEx#Imports](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/vb/mainpage.xaml.vb#imports)]  
+    [!code-csharp[System.IO.WindowsRuntimeStreamExtensionsEx#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/cs/mainpage.xaml.cs#1)]
+    [!code-vb[System.IO.WindowsRuntimeStreamExtensionsEx#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/vb/mainpage.xaml.vb#1)]  
+  
+<a name="BKMK_ConvertingfromaNETFrameworkstreamtoaWindowsRuntimestream"></a>   
+## .NET Framework ストリームから Windows ランタイム ストリームへの変換  
+ 次の <xref:System.IO.WindowsRuntimeStreamExtensions> メソッドのうちの 1 つを使用して、.NET Framework ストリームから Windows ランタイム ストリームに変換できます。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions.AsInputStream%2A>  
+ Windows ストア アプリ用 .NET のサブセットのマネージ ストリームを Windows ランタイムの入力ストリームに変換します。  
+  
+ <xref:System.IO.WindowsRuntimeStreamExtensions.AsOutputStream%2A>  
+ Windows ストア アプリ用 .NET のサブセットのマネージ ストリームを、Windows ランタイムの出力ストリームに変換します。  
+  
+ [AsRandomAccessStream](../../../docs/standard/cross-platform/windowsruntimestreamextensions-asrandomaccessstream-method.md)  
+ Windows ストア アプリ用 .NET のサブセットのマネージ ストリームを Windows ランタイムでの読み取りまたは書き込みに使用できるランダムアクセス ストリームに変換します。  
+  
+ .NET Framework ストリームを Windows ランタイム ストリームに変換する場合、変換されたストリームの機能は元のストリームによって異なります。 たとえば、元のストリームが読み取りと書き込みの両方をサポートしている場合、<xref:System.IO.WindowsRuntimeStreamExtensions.AsInputStream%2A> を呼び出してストリームを変換すると、返される型は `IRandomAccessStream` になります。この型は `IInputStream` と `IOutputStream` を実装し、読み取りと書き込みをサポートします。  
+  
+ .NET Framework ストリームは、変換後も複製をサポートしません。 つまり、.NET Framework ストリームを Windows Runtime ストリームに変換し、[CloneStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.randomaccessstreamoverstream.clonestream.aspx) を呼び出す [GetInputStreamAt](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.inmemoryrandomaccessstream.getinputstreamat.aspx) または [GetOutputStreamAt](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.irandomaccessstream.getoutputstreamat.aspx) を呼び出すか、[CloneStream](http://msdn.microsoft.com/library/windows/apps/windows.storage.streams.randomaccessstreamoverstream.clonestream.aspx) を直接呼び出すと、例外が発生します。  
+  
+#### .NET Framework ストリームから Windows ランタイム ランダムアクセス ストリームに変換するには  
+  
+-   次の例に示すように、[AsRandomAccessStream](../../../docs/standard/cross-platform/windowsruntimestreamextensions-asrandomaccessstream-method.md) メソッドを使用します。  
+  
+    > [!IMPORTANT]
+    >  使用している .NET Framework ストリームがシークをサポートすること、またはそれを実行するストリームにコピーすることを確認します。 この確認には、<xref:System.IO.Stream.CanSeek%2A?displayProperty=fullName> プロパティを使用できます。  
+  
+     この例を実行するには、.NET Framework 4.5.1 を対象とし、`TextBlock2` という名前のテキスト ブロックと `Button2` という名前のボタンを含む、Windows ストア XAML アプリを作成する必要があります。 ボタン クリック イベントはこの例に示す `button2_Click` メソッドに関連付けられている必要があります。  
+  
+     [!code-csharp[System.IO.WindowsRuntimeStreamExtensionsEx#Imports](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/cs/mainpage.xaml.cs#imports)]
+     [!code-vb[System.IO.WindowsRuntimeStreamExtensionsEx#Imports](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/vb/mainpage.xaml.vb#imports)]  
+    [!code-csharp[System.IO.WindowsRuntimeStreamExtensionsEx#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/cs/mainpage.xaml.cs#2)]
+    [!code-vb[System.IO.WindowsRuntimeStreamExtensionsEx#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.windowsruntimestreamextensionsex/vb/mainpage.xaml.vb#2)]  
+  
+## 参照  
+ [クイック スタート: ファイルの読み取りと書き込み \(Windows\)](http://msdn.microsoft.com/library/windows/apps/hh464978.aspx)   
+ [Windows ストア アプリ用 .NET の概要](http://msdn.microsoft.com/library/windows/apps/br230302.aspx)   
+ [Windows ストア アプリ用 .NET – サポートされている API](http://msdn.microsoft.com/library/windows/apps/br230232.aspx)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-copy-directories.md b/docs/standard/io/how-to-copy-directories.md
new file mode 100644
index 00000000000..bb7e2946097
--- /dev/null
+++ b/docs/standard/io/how-to-copy-directories.md
@@ -0,0 +1,40 @@
+---
+title: "方法 : ディレクトリをコピーする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コピー (ディレクトリを)"
+  - "ディレクトリ [.NET Framework], コピー"
+  - "ディレクトリのコピー"
+  - "I/O [.NET Framework], コピー (ディレクトリを)"
+  - "サブディレクトリのコピー"
+ms.assetid: 5a969765-e5f8-4b4e-977e-90e2b0a1fe3c
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : ディレクトリをコピーする
+この例では、I\/O クラスを使用して、別の場所にディレクトリの内容を同期的にコピーする方法について説明します。 ユーザーは、サブディレクトリもコピーするかどうかを指定できます。 サブディレクトリをコピーする場合、この例で使用するメソッドは、コピーするディレクトリがなくなるまで、各サブディレクトリ上で自身を呼び出し、再帰的にコピーを行います。  
+  
+ ファイルを非同期的にコピーする例については、「[非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[System.IO.Directory_Copy#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.Directory_Copy/cs/program.cs#1)]
+ [!code-vb[System.IO.Directory_Copy#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.Directory_Copy/vb/Program.vb#1)]  
+  
+## 参照  
+ <xref:System.IO.FileInfo>   
+ <xref:System.IO.DirectoryInfo>   
+ <xref:System.IO.FileStream>   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [共通 I\/O タスク](../../../docs/standard/io/commons-tasks.md)   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-create-files-and-directories-in-isolated-storage.md b/docs/standard/io/how-to-create-files-and-directories-in-isolated-storage.md
new file mode 100644
index 00000000000..dcdb3f7faa8
--- /dev/null
+++ b/docs/standard/io/how-to-create-files-and-directories-in-isolated-storage.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 分離ストレージでファイルおよびディレクトリを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ディレクトリ [.NET Framework]、分離ストレージ"
+  - "ファイル [.NET Framework]、分離ストレージ"
+  - "分離ストレージ、作成 (ファイルとディレクトリを)"
+  - "データ ストア、作成 (ファイルとディレクトリを)"
+  - "データ ストレージ (分離ストレージを使用した)、作成 (ファイルとディレクトリを)"
+  - "ストア、作成 (ファイルとディレクトリを)"
+  - "格納 (分離ストレージを使用したデータの)、作成 (ファイルとディレクトリを)"
+ms.assetid: 2ca4d2a4-809b-4f00-bc08-bf4a64d3a5c3
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 分離ストレージでファイルおよびディレクトリを作成する
+分離ストアを取得した後で、データを格納するためのディレクトリおよびファイルを作成できます。  ストア内では、ファイル名およびディレクトリ名が、仮想ファイル システムのルートからのパスを使用して指定されています。  
+  
+ ディレクトリを作成するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.CreateDirectory%2A?displayProperty=fullName> のインスタンス メソッドを使用します。  存在しないディレクトリのサブディレクトリを指定すると、ディレクトリとサブディレクトリの両方が作成されます。  既存のディレクトリを指定すると、ディレクトリを作成せずにメソッドは、例外はスローされません。  ただし、無効な文字が含まれているディレクトリ名を指定した場合、<xref:System.IO.IsolatedStorage.IsolatedStorageException> 例外がスローされます。  
+  
+ ファイルを作成するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.CreateFile%2A?displayProperty=fullName> のメソッドを使用します。  
+  
+ Windows オペレーティング システムでは、分離ストレージ ファイル名やディレクトリ名は大文字と小文字を区別しないです。  つまり、`ThisFile.txt`という名前のファイルを作成し、1 個のファイルのみが作成されると、`THISFILE.TXT`という名前のファイルを作成します。  表示目的では、ファイル名の元の大文字\/小文字が維持されます。  
+  
+## 例  
+ 分離ストア内にファイルおよびディレクトリを作成する方法を次のコード例で示します。  
+  
+ [!code-csharp[Conceptual.IsolatedStorage#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source.cs#1)]
+ [!code-vb[Conceptual.IsolatedStorage#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source.vb#1)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-delete-files-and-directories-in-isolated-storage.md b/docs/standard/io/how-to-delete-files-and-directories-in-isolated-storage.md
new file mode 100644
index 00000000000..2d52e9ddf68
--- /dev/null
+++ b/docs/standard/io/how-to-delete-files-and-directories-in-isolated-storage.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 分離ストレージでファイルおよびディレクトリを削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストレージ (分離ストレージを使用した)、削除 (ファイルとディレクトリを)"
+  - "ディレクトリ [.NET Framework]、分離ストレージ"
+  - "ファイル [.NET Framework]、分離ストレージ"
+  - "分離ストレージ、削除 (ファイルとディレクトリを)"
+  - "データ ストア、削除 (ファイルとディレクトリを)"
+  - "ストア、作成 (ファイルとディレクトリを)"
+  - "削除 (分離ストレージ ファイル内のファイルを)"
+  - "格納 (分離ストレージを使用したデータの)、削除 (ファイルとディレクトリを)"
+  - "削除 (分離ストレージ ファイル内のディレクトリを)"
+ms.assetid: 8fcc0dea-435b-4d40-ba4d-ba056265c202
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 分離ストレージでファイルおよびディレクトリを削除する
+分離ストレージ ファイル内のディレクトリやファイルを削除できます。  ストア内では、ファイル名やディレクトリ名は、オペレーティング システムの依存で、仮想ファイル システムのルートに関連するように指定します。  そのため、Windows オペレーティング システムでは大文字と小文字が区別されません。  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile?displayProperty=fullName> クラスには、ディレクトリやファイルを削除するための 2 種類のメソッドを指定する: <xref:System.IO.IsolatedStorage.IsolatedStorageFile.DeleteDirectory%2A> と <xref:System.IO.IsolatedStorage.IsolatedStorageFile.DeleteFile%2A>。  <xref:System.IO.IsolatedStorage.IsolatedStorageException> 例外は、存在しないファイルやディレクトリを削除しようとするとスローされます。  名前にワイルドカード文字を含める場合は、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.DeleteDirectory%2A> は <xref:System.IO.IsolatedStorage.IsolatedStorageException> の例外と <xref:System.IO.IsolatedStorage.IsolatedStorageFile.DeleteFile%2A> をスロー <xref:System.ArgumentException> の例外をスローします。  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile.DeleteDirectory%2A> のメソッドはディレクトリにファイルまたはサブディレクトリが含まれている場合は失敗します。  既存のファイルおよびディレクトリを取得するために <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetFileNames%2A> と <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetDirectoryNames%2A> のメソッドを使用できます。  ストアの仮想ファイル システムの検索の詳細については、「[方法 : 分離ストレージ内でファイルおよびディレクトリを検索する](../../../docs/standard/io/how-to-find-existing-files-and-directories-in-isolated-storage.md)」を参照してください。  
+  
+## 例  
+ ディレクトリとファイルをいくつか作成し、その後で削除するコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#4](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source4.cpp#4)]
+ [!code-csharp[Conceptual.IsolatedStorage#4](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source4.cs#4)]
+ [!code-vb[Conceptual.IsolatedStorage#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source4.vb#4)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile?displayProperty=fullName>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-delete-stores-in-isolated-storage.md b/docs/standard/io/how-to-delete-stores-in-isolated-storage.md
new file mode 100644
index 00000000000..e6903ba3c79
--- /dev/null
+++ b/docs/standard/io/how-to-delete-stores-in-isolated-storage.md
@@ -0,0 +1,43 @@
+---
+title: "方法 : 分離ストレージでストアを削除する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストア、削除"
+  - "データ ストア、削除"
+  - "削除 (ストアを)"
+  - "削除 (ストアを)"
+  - "分離ストレージ、削除 (ストアを)"
+  - "格納 (分離ストレージを使用したデータの)、削除 (ストアを)"
+  - "データ ストレージ (分離ストレージを使用した)、削除 (ストアを)"
+ms.assetid: 3947e333-5af6-4601-b2f1-24d4d6129cf3
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 分離ストレージでストアを削除する
+分離ストレージ ファイルを削除するため、<xref:System.IO.IsolatedStorage.IsolatedStorageFile> クラスは 2 つのメソッドを提供します。  
+  
+-   インスタンス メソッド <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove> は引数を使わず、そのインスタンス メソッドを呼び出すストアを削除します。 この操作にアクセス許可は必要ありません。 ストアにアクセスできるすべてのコードは、その内部の一部のデータやすべてのデータを削除できます。  
+  
+-   静的メソッド <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove%28System.IO.IsolatedStorage.IsolatedStorageScope%29> は <xref:System.IO.IsolatedStorage.IsolatedStorageScope> 列挙値を使い、コードを実行するユーザーのすべてのストアを削除します。 この操作を実行するには、<xref:System.Security.Permissions.IsolatedStorageContainment> の値に対する <xref:System.Security.Permissions.IsolatedStorageFilePermission> アクセス許可が必要です。  
+  
+## 例  
+ 静的 <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove%2A> メソッドとインスタンス <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove%2A> メソッドの使い方を次のコード例に示します。 クラスは、次の 2 つのストアを取得します。1 つは、ユーザーとアセンブリで使うように分離して、もう 1 つは、ユーザー、ドメイン、アセンブリで使うように分離します。 次に、分離ストレージ ファイル `isoStore1` の <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove> メソッドを呼び出すことにより、ユーザー、ドメイン、アセンブリのストアが削除されます。 その後、静的メソッド <xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove%28System.IO.IsolatedStorage.IsolatedStorageScope%29> を呼び出すことによって、ユーザーの残りのストアすべてを削除します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source3.cpp#3)]
+ [!code-csharp[Conceptual.IsolatedStorage#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source3.cs#3)]
+ [!code-vb[Conceptual.IsolatedStorage#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source3.vb#3)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-enumerate-directories-and-files.md b/docs/standard/io/how-to-enumerate-directories-and-files.md
new file mode 100644
index 00000000000..c1f5ed049cc
--- /dev/null
+++ b/docs/standard/io/how-to-enumerate-directories-and-files.md
@@ -0,0 +1,70 @@
+---
+title: "方法: ディレクトリとファイルを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "I/O [.NET Framework]、列挙 (ディレクトリとファイルを)"
+ms.assetid: 86b69a08-3bfa-4e5f-b4e1-3b7cb8478215
+caps.latest.revision: 18
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# 方法: ディレクトリとファイルを列挙する
+名前の一連の列挙可能なコレクションを返すメソッドを使用して、ディレクトリとファイルを列挙できます。  また、<xref:System.IO.DirectoryInfo>、<xref:System.IO.FileInfo>、または <xref:System.IO.FileSystemInfo> の各オブジェクトの列挙可能なコレクションを返すメソッドも使用できます。  列挙可能なコレクションには、ディレクトリや大量のファイルを使用すると、配列よりもパフォーマンスが優れています。  
+  
+ これらのメソッドから取得した列挙可能なコレクションを使用して、<xref:System.Collections.Generic.List%601> クラスなどのコレクション クラスのコンストラクターの <xref:System.Collections.Generic.IEnumerable%601> パラメーターを指定することもできます。  
+  
+ ディレクトリまたはファイルの名前のみを取得するには、<xref:System.IO.Directory> クラスの列挙メソッドを使用します。  ディレクトリまたはファイルのその他のプロパティを取得するには、<xref:System.IO.DirectoryInfo> クラスおよび <xref:System.IO.FileSystemInfo> クラスを使用します。  
+  
+ 列挙可能なコレクションを返すメソッドの説明を次の表に示します。  
+  
+|列挙する対象|返される列挙可能なコレクション|使用するメソッド|  
+|------------|---------------------|--------------|  
+|ディレクトリ|ディレクトリ名|<xref:System.IO.Directory.EnumerateDirectories%2A?displayProperty=fullName>|  
+||ディレクトリ情報 \(<xref:System.IO.DirectoryInfo>\)|<xref:System.IO.DirectoryInfo.EnumerateDirectories%2A?displayProperty=fullName>|  
+|ファイル|ファイル名|<xref:System.IO.Directory.EnumerateFiles%2A?displayProperty=fullName>|  
+||ファイル情報 \(<xref:System.IO.FileInfo>\)|<xref:System.IO.DirectoryInfo.EnumerateFiles%2A?displayProperty=fullName>|  
+|ファイル システム情報|ファイル システム エントリ|<xref:System.IO.Directory.EnumerateFileSystemEntries%2A?displayProperty=fullName>|  
+||ファイル システム情報 \(<xref:System.IO.FileSystemInfo>\)|<xref:System.IO.DirectoryInfo.EnumerateFileSystemInfos%2A?displayProperty=fullName>|  
+  
+ <xref:System.IO.SearchOption> の列挙体に用意されている <xref:System.IO.SearchOption> の検索オプションを使用して、親ディレクトリのサブディレクトリ内のすべてのファイルを列挙できますが、承認されていないアクセスの例外 \(<xref:System.UnauthorizedAccessException>\) は列挙体が不完全になる可能性があります。  このような例外が発生する可能性がある場合は、まずディレクトリを列挙してからファイルを列挙することで、例外をキャッチして続行できます。  
+  
+### ディレクトリ名を列挙するには  
+  
+-   <xref:System.IO.Directory.EnumerateDirectories%28System.String%29?displayProperty=fullName> メソッドを使用して、指定したパスに存在する最上位ディレクトリ名のリストを取得します。  
+  
+     [!code-csharp[System.IO.EnumDirs1#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.enumdirs1/cs/program.cs#1)]
+     [!code-vb[System.IO.EnumDirs1#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.enumdirs1/vb/program.vb#1)]  
+  
+### ディレクトリとそのサブディレクトリ内のファイル名を列挙するには  
+  
+-   ディレクトリと \(必要に応じて\) サブディレクトリを検索し、指定された検索パターンと一致するファイル名の一覧を取得するに <xref:System.IO.Directory.EnumerateFiles%28System.String%2CSystem.String%2CSystem.IO.SearchOption%29?displayProperty=fullName> のメソッドを使用します。  
+  
+     [!code-csharp[System.IO.Directory.EnumerateFiles#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.directory.enumeratefiles/cs/program.cs#1)]
+     [!code-vb[System.IO.Directory.EnumerateFiles#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.directory.enumeratefiles/vb/program.vb#1)]  
+  
+### DirectoryInfo オブジェクトのコレクションを列挙するには  
+  
+-   <xref:System.IO.DirectoryInfo.EnumerateDirectories%2A?displayProperty=fullName> メソッドを使用して、最上位ディレクトリのコレクションを取得します。  
+  
+     [!code-csharp[System.IO.DirectoryInfo.EnumDirs#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.directoryinfo.enumdirs/cs/program.cs#1)]
+     [!code-vb[System.IO.DirectoryInfo.EnumDirs#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.directoryinfo.enumdirs/vb/module1.vb#1)]  
+  
+### すべてのディレクトリ内の FileInfo オブジェクトのコレクションを列挙するには  
+  
+-   <xref:System.IO.DirectoryInfo.EnumerateFiles%2A?displayProperty=fullName> メソッドを使用して、すべてのディレクトリ内の指定した検索パターンに一致するファイルのコレクションを取得します。  この例では、まず最上位ディレクトリを列挙して発生の可能性がある承認されていないアクセスの例外をキャッチし、次にファイルを列挙します。  
+  
+     [!code-csharp[System.IO.DirectoryInfo.EnumerateDirectories#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.directoryinfo.enumeratedirectories/cs/program.cs#1)]
+     [!code-vb[System.IO.DirectoryInfo.EnumerateDirectories#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.directoryinfo.enumeratedirectories/vb/program.vb#1)]  
+  
+## 参照  
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-enumerate-stores-for-isolated-storage.md b/docs/standard/io/how-to-enumerate-stores-for-isolated-storage.md
new file mode 100644
index 00000000000..f2c73984b31
--- /dev/null
+++ b/docs/standard/io/how-to-enumerate-stores-for-isolated-storage.md
@@ -0,0 +1,37 @@
+---
+title: "方法 : 分離ストレージでストアを列挙する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "列挙 (ストアを)"
+  - "データ ストレージ (分離ストレージを使用した)、列挙 (ストアを)"
+  - "格納 (分離ストレージを使用したデータの)、列挙 (ストアを)"
+  - "ストア、列挙"
+  - "分離ストレージ、列挙 (ストアを)"
+  - "データ ストア、列挙"
+ms.assetid: 0fcf279a-f241-48f0-8034-2e3d331f1fcb
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 分離ストレージでストアを列挙する
+<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator%2A?displayProperty=fullName> の静的メソッドを使用して、現在のユーザーのすべての分離ストアを列挙できます。  このメソッドは <xref:System.IO.IsolatedStorage.IsolatedStorageScope> 値を受け取り、<xref:System.IO.IsolatedStorage.IsolatedStorageFile> 列挙子を返します。  ストアを列挙するには、<xref:System.Security.Permissions.IsolatedStorageContainment> 値を指定する <xref:System.Security.Permissions.IsolatedStorageFilePermission> のアクセス許可が必要です。  <xref:System.IO.IsolatedStorage.IsolatedStorageScope> 値の <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator%2A> のメソッドを呼び出すと、現在のユーザーに対して定義されている <xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトの配列を返します。  
+  
+## 例  
+ 次のコード例は、ユーザーおよびアセンブリ別に分離されたストアを作成し、いくつかのファイルを、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator%2A> のメソッドを使用して取得しますそれらのファイルを取得します。  
+  
+ [!code-csharp[Conceptual.IsolatedStorage#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source2.cs#2)]
+ [!code-vb[Conceptual.IsolatedStorage#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-find-existing-files-and-directories-in-isolated-storage.md b/docs/standard/io/how-to-find-existing-files-and-directories-in-isolated-storage.md
new file mode 100644
index 00000000000..6c87bca8748
--- /dev/null
+++ b/docs/standard/io/how-to-find-existing-files-and-directories-in-isolated-storage.md
@@ -0,0 +1,45 @@
+---
+title: "方法 : 分離ストレージ内でファイルおよびディレクトリを検索する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストア、検索 (ファイルとディレクトリを)"
+  - "検索 (分離ストレージ ファイル内のファイルを)"
+  - "ディレクトリ [.NET Framework]、分離ストレージ"
+  - "分離ストレージ、検索 (ファイルとディレクトリを)"
+  - "データ ストレージ (分離ストレージを使用した)、検索 (ファイルとディレクトリを)"
+  - "ファイル [.NET Framework]、分離ストレージ"
+  - "データ ストア、検索 (ファイルとディレクトリを)"
+  - "検索 (分離ストレージ ファイル内のディレクトリを)"
+  - "格納 (分離ストレージを使用したデータの)、検索 (ファイルとディレクトリを)"
+ms.assetid: eb28458a-6161-4e7a-9ada-30ef93761b5c
+caps.latest.revision: 12
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# 方法 : 分離ストレージ内でファイルおよびディレクトリを検索する
+分離ストレージのディレクトリを検索するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetDirectoryNames%2A?displayProperty=fullName> のメソッドを使用します。  このメソッドは検索パターンを表す文字列を取得します。  検索パターンで単一文字を表すワイルドカード文字 \(複数の文字をアスタリスク \(\*\) ワイルドカード文字を両方使用してワイルドカード文字は名前の最後の部分で使用する必要があります。  たとえば、`directory1/*ect*` は有効な検索文字列ですが、`*ect*/directory2` は無効です。  
+  
+ ファイルを検索するには、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetFileNames%2A?displayProperty=fullName> のメソッドを使用します。  <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetDirectoryNames%2A> に適用される検索文字列がワイルドカード文字の制限は <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetFileNames%2A>に適用されます。  
+  
+ これらのメソッドのいずれも再帰的ではありません; <xref:System.IO.IsolatedStorage.IsolatedStorageFile> クラスには、ストア内のすべてのディレクトリまたはファイルを指定するためのメソッドは用意されていません。  ただし、再帰的なメソッドは次のコード例に示します。  
+  
+## 例  
+ 分離ストア内にファイルおよびディレクトリを作成する方法を次のコード例で示します。  最初に、ユーザーの分離されたストア、ドメインおよびアセンブリに `isoStore` の変数が取得され、表示されます。  <xref:System.IO.IsolatedStorage.IsolatedStorageFile.CreateDirectory%2A> のメソッドを使用して複数の異なるディレクトリを設定するために使用されます <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream.%23ctor%28System.String%2CSystem.IO.FileMode%2CSystem.IO.IsolatedStorage.IsolatedStorageFile%29> のコンストラクターはこれらのディレクトリにあるファイルを作成します。  次に、`GetAllDirectories` メソッドの結果全体を検索します。  このメソッドは、現在のディレクトリ内のすべてのディレクトリ名は、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetDirectoryNames%2A> を使用します。  これらの名前は配列に格納され、その `GetAllDirectories` は自分自身を呼び出し、見つかった各ディレクトリに渡します。  その結果、すべてのディレクトリ名は配列で返されます。  次に、`GetAllFiles` メソッドを呼び出します。  このすべてのディレクトリの名前を検索メソッドの呼び出し `GetAllDirectories`、そのファイルが <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetFileNames%2A> のメソッドを使用して各ディレクトリを確認します。  結果は、表示のために配列で返されます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#9](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source8.cpp#9)]
+ [!code-csharp[Conceptual.IsolatedStorage#9](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source8.cs#9)]
+ [!code-vb[Conceptual.IsolatedStorage#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source8.vb#9)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-obtain-stores-for-isolated-storage.md b/docs/standard/io/how-to-obtain-stores-for-isolated-storage.md
new file mode 100644
index 00000000000..2640c285b62
--- /dev/null
+++ b/docs/standard/io/how-to-obtain-stores-for-isolated-storage.md
@@ -0,0 +1,64 @@
+---
+title: "方法 : 分離ストレージでストアを取得する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストア、取得"
+  - "格納 (分離ストレージを使用したデータの)、取得 (ストアを)"
+  - "分離ストレージ、取得 (ストアを)"
+  - "データ ストア、取得"
+  - "データ ストレージ (分離ストレージを使用した)、取得 (ストアを)"
+ms.assetid: fcb6b178-d526-47c4-b029-e946f880f9db
+caps.latest.revision: 19
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# 方法 : 分離ストレージでストアを取得する
+分離ストアは、データ コンパートメント内の仮想ファイル システムを公開します。  <xref:System.IO.IsolatedStorage.IsolatedStorageFile> クラスは分離ストアと対話するためのメソッドを提供します。  ストアの作成および取得するために、<xref:System.IO.IsolatedStorage.IsolatedStorageFile> は 3 個の静的メソッドを提供し、T:  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForAssembly%2A> は、ユーザーおよびアセンブリ別に分離されたストレージが返されます。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForDomain%2A>、ドメイン、およびアセンブリ別に分離されたストレージが返されます。  
+  
+     メソッドは両方とも、呼び出しコードに属するストアを取得します。  
+  
+-   静的メソッド <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> は、スコープ パラメーターの組み合わせを渡すことによって指定される分離ストアを返します。  
+  
+ 次のコードは、ユーザー、ドメイン、およびアセンブリ別に分離されたストアを返します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#6](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source6.cpp#6)]
+ [!code-csharp[Conceptual.IsolatedStorage#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source6.cs#6)]
+ [!code-vb[Conceptual.IsolatedStorage#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source6.vb#6)]  
+  
+ ローミング ストアは、ローミング ユーザー プロファイルを行う必要があることを指定するために <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のメソッドを使用できます。  このプロパティを設定する方法の詳細については [分離のタイプ](../../../docs/standard/io/types-of-isolation.md)を参照してください。  
+  
+ 既定では、異なるアセンブリから取得される分離ストアは、異なるストアです。  <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のメソッドのパラメーターのアセンブリまたはドメインの証拠を渡すことにより、異なるアセンブリまたはドメインのストアにアクセスできます。  別のアセンブリまたはドメインのストアにアクセスするには、アプリケーション ドメイン ID 別の分離ストレージにアクセスするためのアクセス許可が必要です。  詳細については、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> メソッド オーバーロードを参照します。  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForAssembly%2A>、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForDomain%2A>と <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のメソッドは <xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトを返します。  場面に応じてどの分離タイプを使用するのが適切かを判断するには、「[分離のタイプ](../../../docs/standard/io/types-of-isolation.md)」を参照してください。  分離ストレージ ファイル オブジェクトがある場合は、分離ストレージのメソッドを使用して、ファイルやディレクトリの読み取り、書き込み、作成、および削除を行うことができます。  
+  
+ コードはコードにストアを取得するための十分なアクセス権がない <xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトを渡すことを防ぐ機構はありません。  ドメインおよびアセンブリの ID や分離ストレージのアクセス許可の確認は、<xref:System.IO.IsolatedStorage.IsolatedStorage> オブジェクトへの参照が取得されたとき、つまり、通常は <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForAssembly%2A> メソッド、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForDomain%2A> メソッド、または <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> メソッドでしか実行されません。  したがって、<xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトへの参照の保護は、その参照を使用するコードで行う必要があります。  
+  
+## 例  
+ 次のコードは、ユーザーおよびアセンブリ別に分離されたストアを取得するクラスの簡単な例を示します。  コードは <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のメソッドに渡す引数に <xref:System.IO.IsolatedStorage.IsolatedStorageScope?displayProperty=fullName> に追加することによって、ユーザー、ドメイン、およびアセンブリ別に分離されたストアを取得するように変更できます。  
+  
+ コードを実行すると、ストアは、コマンド ラインに" **StoreAdm \/LIST** の入力によって作成されたことを確認できます。  これは [分離ストレージ ツール \(Storeadm.exe\)](../../../docs/framework/tools/storeadm-exe-isolated-storage-tool.md) を実行し、ユーザーの現在の分離ストアが一覧表示されます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#7](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source6.cpp#7)]
+ [!code-csharp[Conceptual.IsolatedStorage#7](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source6.cs#7)]
+ [!code-vb[Conceptual.IsolatedStorage#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source6.vb#7)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ <xref:System.IO.IsolatedStorage.IsolatedStorageScope>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)   
+ [分離のタイプ](../../../docs/standard/io/types-of-isolation.md)   
+ [共通言語ランタイムのアセンブリ](../../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-open-and-append-to-a-log-file.md b/docs/standard/io/how-to-open-and-append-to-a-log-file.md
new file mode 100644
index 00000000000..6db3c740ced
--- /dev/null
+++ b/docs/standard/io/how-to-open-and-append-to-a-log-file.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : ログ ファイルを開いて情報を追加する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ログ ファイル、開く"
+  - "ストリーム、オープンと追加 (ログ ファイルの)"
+  - "ログ ファイル、追加"
+  - "I/O [.NET Framework]、ログ ファイル"
+ms.assetid: 74423362-1721-49cb-aa0a-e04005f72a06
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : ログ ファイルを開いて情報を追加する
+<xref:System.IO.StreamWriter> と <xref:System.IO.StreamReader> は、文字をストリームに書き込んだり、文字をストリームから読み取ったりします。  入力用として `log.txt` ファイルを開くか、ファイルが存在しない場合は作成し、ファイルの末尾に情報を追加するコードの例を次に示します。  その後で、ファイルの内容を表示するために標準出力に書き込みます。  この例に代わる方法として、情報を 1 つの文字列または文字列配列として格納できます。また、<xref:System.IO.File.WriteAllText%2A> または <xref:System.IO.File.WriteAllLines%2A> メソッドを使用して同じ機能を実行することもできます。  
+  
+> [!NOTE]
+>  Visual Basic では、ログ ファイルの作成、またはログ ファイルへの書き込みを行う場合に、<xref:Microsoft.VisualBasic.Logging.Log> クラスまたは <xref:Microsoft.VisualBasic.FileIO.FileSystem> クラスに用意されているメソッドとプロパティを使用することもできます。  
+  
+## 使用例  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source2.cs#2)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.IO.StreamWriter>   
+ <xref:System.IO.StreamReader>   
+ <xref:System.IO.File.AppendText%2A?displayProperty=fullName>   
+ <xref:System.IO.File.OpenText%2A?displayProperty=fullName>   
+ <xref:System.IO.StreamReader.ReadLine%2A?displayProperty=fullName>   
+ [方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)   
+ [方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)   
+ [方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)   
+ [方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)   
+ [方法 : 文字列から文字を読み取る](../../../docs/standard/io/how-to-read-characters-from-a-string.md)   
+ [方法 : 文字列に文字を書き込む](../../../docs/standard/io/how-to-write-characters-to-a-string.md)   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md b/docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md
new file mode 100644
index 00000000000..8c45ea7d592
--- /dev/null
+++ b/docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md
@@ -0,0 +1,48 @@
+---
+title: "方法 : 新しく作成されたデータ ファイルに対して読み書きする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "BinaryReader クラス, 例"
+  - "BinaryWriter クラス, 例"
+  - "I/O [.NET Framework], 読み取り (データを)"
+  - "I/O [.NET Framework], 書き込み (データの)"
+  - "ストリーム, 読み取りと書き込み (データの)"
+ms.assetid: e209d949-31e8-44ea-8e38-87f9093f3093
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法 : 新しく作成されたデータ ファイルに対して読み書きする
+<xref:System.IO.BinaryWriter> クラスおよび <xref:System.IO.BinaryReader?displayProperty=fullName> クラスは、文字列ではない形式でデータを書き込んだり読み取ったりするために使用します。  `Test.data` と呼ばれる新しい空のファイル ストリームに対するデータの書き込みと読み取りを実行するコードの例を次に示します。  現在のディレクトリにデータ ファイルを作成した後、そのファイルに関連付けた <xref:System.IO.BinaryWriter> オブジェクトと <xref:System.IO.BinaryReader> オブジェクトを作成し、<xref:System.IO.BinaryWriter> オブジェクトを使用して整数 0 ～ 10 を `Test.data` に書き込みます。ファイル ポインターはファイルの末尾に残っています。  <xref:System.IO.BinaryReader> オブジェクトはファイル ポインターを起点に戻してから、指定された内容を読み出します。  
+  
+## 使用例  
+ [!code-cpp[System.IO.BinaryReaderWriter#7](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.BinaryReaderWriter/CPP/source6.cpp#7)]
+ [!code-csharp[System.IO.BinaryReaderWriter#7](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.BinaryReaderWriter/CS/source6.cs#7)]
+ [!code-vb[System.IO.BinaryReaderWriter#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.BinaryReaderWriter/VB/source6.vb#7)]  
+  
+## 信頼性の高いプログラミング  
+ `Test.data` が既に現在のディレクトリに存在する場合は、<xref:System.IO.IOException> 例外がスローされます。  ファイル ストリームを初期化するときにファイル モード オプション <xref:System.IO.FileMode?displayProperty=fullName> を使用すると、例外がスローされずに新しいファイルが必ず作成されます。  
+  
+## 参照  
+ <xref:System.IO.BinaryReader>   
+ <xref:System.IO.BinaryWriter>   
+ <xref:System.IO.FileStream>   
+ <xref:System.IO.FileStream.Seek%2A?displayProperty=fullName>   
+ <xref:System.IO.SeekOrigin>   
+ [方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)   
+ [方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)   
+ [方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)   
+ [方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)   
+ [方法 : 文字列から文字を読み取る](../../../docs/standard/io/how-to-read-characters-from-a-string.md)   
+ [方法 : 文字列に文字を書き込む](../../../docs/standard/io/how-to-write-characters-to-a-string.md)   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-read-and-write-to-files-in-isolated-storage.md b/docs/standard/io/how-to-read-and-write-to-files-in-isolated-storage.md
new file mode 100644
index 00000000000..eb6a47ce289
--- /dev/null
+++ b/docs/standard/io/how-to-read-and-write-to-files-in-isolated-storage.md
@@ -0,0 +1,46 @@
+---
+title: "方法 : 分離ストレージ内でファイルの読み取りと書き込みを行う | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストレージ (分離ストレージを使用した), 読み取りと書き込み (ファイルの)"
+  - "データ ストア, 読み取りと書き込み (ファイルの)"
+  - "ファイル, 分離ストレージ"
+  - "分離ストレージ, 読み取りと書き込み (ファイルの)"
+  - "読み取り (データを)"
+  - "読み取り (ストア内のファイルを)"
+  - "ストア, 読み取りと書き込み (ファイルの)"
+  - "格納 (分離ストレージを使用したデータの), 読み取りと書き込み (ファイルの)"
+  - "書き込み (ストア内のファイルへの)"
+ms.assetid: f977ebdc-1b55-475a-bc3d-3376470b08ae
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# 方法 : 分離ストレージ内でファイルの読み取りと書き込みを行う
+から読み取ったり、またはファイルに、分離ストアに書き込むには、ストリーム リーダー \(<xref:System.IO.StreamReader> オブジェクト\) またはストリーム ライター \(<xref:System.IO.StreamWriter> オブジェクト\) を持つ <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream> オブジェクトを使用します。  
+  
+## 例  
+ 次のコード例は TestStore.txt という名前のストアにファイルがあるかどうかを分離ストアをチェックします。  存在しない場合は、ファイルを作成して「Hello Isolated Storage」と書き込みます。  TestStore.txt が既に存在する場合は、このコード例では、ファイルから読み込みます。  
+  
+ [!code-csharp[Conceptual.IsolatedStorage#5](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source5.cs#5)]
+ [!code-vb[Conceptual.IsolatedStorage#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source5.vb#5)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile>   
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream>   
+ <xref:System.IO.FileMode?displayProperty=fullName>   
+ <xref:System.IO.FileAccess?displayProperty=fullName>   
+ <xref:System.IO.StreamReader?displayProperty=fullName>   
+ <xref:System.IO.StreamWriter?displayProperty=fullName>   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-read-characters-from-a-string.md b/docs/standard/io/how-to-read-characters-from-a-string.md
new file mode 100644
index 00000000000..424bb25cab7
--- /dev/null
+++ b/docs/standard/io/how-to-read-characters-from-a-string.md
@@ -0,0 +1,51 @@
+---
+title: "方法 : 文字列から文字を読み取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "読み取り (文字列から文字を)"
+  - "データ ストリーム、読み取り (文字列から文字を)"
+  - "I/O [.NET Framework]、読み取り (文字列から文字を)"
+  - "読み取り (データを)、文字列"
+  - "ストリーム、読み取り (文字列から文字を)"
+ms.assetid: 27ea5e52-6db8-42d8-980a-50bcfc7fd270
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : 文字列から文字を読み取る
+次のコード例は文字列からの文字の同期的にと非同期的に読み込む方法を説明します。  
+  
+## 使用例  
+ この例では、文字列から 13 文字を同期的に読み取り、配列に格納し、その文字を表示します。  次に、文字列内の残りの文字を読み取り、6 番目の要素で開始される配列に格納し、その配列の内容を表示します。  
+  
+ [!code-cpp[Conceptual.StringReader#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.stringreader/cpp/source.cpp#1)]
+ [!code-csharp[Conceptual.StringReader#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.stringreader/cs/source.cs#1)]
+ [!code-vb[Conceptual.StringReader#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.stringreader/vb/source.vb#1)]  
+  
+## 使用例  
+ 次の例 <xref:System.Windows.Controls.TextBox> のコントロールからのすべての文字を非同期的に読み取り、配列に格納します。  これは <xref:System.Windows.Controls.TextBlock> のコントロールに改行に続く行に、非同期的に各文字または空白文字を書き込みます。  
+  
+ [!code-csharp[Conceptual.StringReader#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.stringreader/cs/source2.cs#2)]
+ [!code-vb[Conceptual.StringReader#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.stringreader/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.IO.StringReader>   
+ <xref:System.IO.StringReader.Read%2A?displayProperty=fullName>   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)   
+ [NIB: How to: Create a Directory Listing](http://msdn.microsoft.com/ja-jp/4d2772b1-b991-4532-a8a6-6ef733277e69)   
+ [方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)   
+ [方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)   
+ [方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)   
+ [方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)   
+ [方法 : 文字列に文字を書き込む](../../../docs/standard/io/how-to-write-characters-to-a-string.md)   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-read-text-from-a-file.md b/docs/standard/io/how-to-read-text-from-a-file.md
new file mode 100644
index 00000000000..bc49a36c1df
--- /dev/null
+++ b/docs/standard/io/how-to-read-text-from-a-file.md
@@ -0,0 +1,55 @@
+---
+title: "方法 : ファイルからテキストを読み取る | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストリーム, 読み取り (ファイルからテキストを)"
+  - "I/O [.NET Framework], 読み取り (ファイルからテキストを)"
+  - "読み取り (データを), テキスト ファイル"
+  - "読み取り (テキスト ファイルを)"
+  - "ストリーム, 読み取り (ファイルからテキストを)"
+ms.assetid: ed180baa-dfc6-4c69-a725-46e87edafb27
+caps.latest.revision: 23
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# 方法 : ファイルからテキストを読み取る
+次に、.NET デスクトップ アプリを使用してテキスト ファイルから同期でテキストを読み取る方法と非同期でテキストを読み取る方法の例を示します。  どちらの例でも、<xref:System.IO.StreamReader> クラスのインスタンスを作成する場合に、ファイルの相対パスまたは絶対パスを指定します。  次の例では、TestFile.txt という名前のファイルがアプリケーションと同じフォルダーにあることを前提とします。  
+  
+ Windows ランタイムではファイルに対する読み取りと書き込みに別のストリーム型が用意されているため、これらのコード例は Windows ストア アプリの開発には適用されません。  Windows ストア アプリのコンテキスト内のファイルからテキストを読み取る方法を示す例については、「[クイック スタート: ファイルの読み取りと書き込み](http://msdn.microsoft.com/library/windows/apps/hh758325.aspx)」を参照してください。  .NET Framework ストリームと Windows ランタイム ストリームを変換する方法を示す例は、「[方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う](../../../docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md)」を参照してください。  
+  
+## 使用例  
+ 最初の例では、コンソール アプリケーション内での同期読み取り操作を示します。  この例では、ストリーム リーダーを使用してテキスト ファイルを開き、内容を文字列にコピーして、文字列をコンソールに出力します。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source3.cs#3)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source3.vb#3)]  
+  
+## 使用例  
+ 2 番目の例では、Windows Presentation Foundation \(WPF\) アプリケーション内での非同期読み取り操作を示します。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#6](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source6.cs#6)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source6.vb#6)]  
+  
+## 参照  
+ <xref:System.IO.StreamReader>   
+ <xref:System.IO.File.OpenText%2A?displayProperty=fullName>   
+ <xref:System.IO.StreamReader.ReadLine%2A?displayProperty=fullName>   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)   
+ [NIB: How to: Create a Directory Listing](http://msdn.microsoft.com/ja-jp/4d2772b1-b991-4532-a8a6-6ef733277e69)   
+ [クイック スタート: ファイルの読み取りと書き込み](http://msdn.microsoft.com/library/windows/apps/hh758325.aspx)   
+ [方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う](../../../docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md)   
+ [方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)   
+ [方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)   
+ [方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)   
+ [方法 : 文字列から文字を読み取る](../../../docs/standard/io/how-to-read-characters-from-a-string.md)   
+ [方法 : 文字列に文字を書き込む](../../../docs/standard/io/how-to-write-characters-to-a-string.md)   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md b/docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md
new file mode 100644
index 00000000000..f648d96e988
--- /dev/null
+++ b/docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md
@@ -0,0 +1,50 @@
+---
+title: "方法: ローカルのプロセス間通信で匿名パイプを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "匿名パイプ [.NET Framework]"
+  - "ローカル コンピューターでの通信 [.NET Framework], パイプ"
+  - "一方向の通信 [.NET Framework]"
+  - "親子間の通信 [.NET Framework]"
+  - "パイプ [.NET Framework]"
+ms.assetid: e7773c77-c646-4a01-8a96-a003d59fc4c9
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法: ローカルのプロセス間通信で匿名パイプを使用する
+匿名パイプは、ローカル コンピューターでのプロセス間通信を実現します。  名前付きパイプと比較して提供する機能は少なくなりますが、オーバーヘッドも小さくなります。  匿名パイプを使用して、ローカル コンピューター上で容易にプロセス間通信を実行できます。  匿名パイプを使用してネットワーク経由の通信を行うことはできません。  
+  
+ 匿名パイプを実装するには、<xref:System.IO.Pipes.AnonymousPipeServerStream> クラスと <xref:System.IO.Pipes.AnonymousPipeClientStream> クラスを使用します。  
+  
+## 使用例  
+ 次に、匿名パイプを使用して、親プロセスから子プロセスに文字列を送信する方法の例を示します。  この例では、<xref:System.IO.Pipes.PipeDirection> の <xref:System.IO.Pipes.PipeDirection> 値を使用して、親プロセス内に <xref:System.IO.Pipes.AnonymousPipeServerStream> オブジェクトを作成しています。  次に、親プロセスは、クライアント ハンドルを使用して子プロセスを作成し、<xref:System.IO.Pipes.AnonymousPipeClientStream> オブジェクトを作成します。  子プロセスには、<xref:System.IO.Pipes.PipeDirection> の <xref:System.IO.Pipes.PipeDirection> 値が指定されています。  
+  
+ 次に、親プロセスはユーザー指定の文字列を子プロセスに送信します。  この文字列は、子プロセスのコンソールに表示されます。  
+  
+ サーバー プロセスの例を次に示します。  
+  
+ [!code-cpp[System.IO.Pipes.AnonymousPipeServerStream_Sample#01](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeServerStream_Sample/cpp/program.cpp#01)]
+ [!code-csharp[System.IO.Pipes.AnonymousPipeServerStream_Sample#01](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeServerStream_Sample/cs/Program.cs#01)]
+ [!code-vb[System.IO.Pipes.AnonymousPipeServerStream_Sample#01](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeServerStream_Sample/vb/program.vb#01)]  
+  
+## 使用例  
+ クライアント プロセスの例を次に示します。  サーバー プロセスはクライアント プロセスを開始し、開始したプロセスをクライアント ハンドルに渡します。  クライアント コードから生成される実行可能ファイルの名前は `pipeClient.exe` とします。サーバー プロセスを実行する前に、このファイルをサーバーの実行可能ファイルと同じディレクトリにコピーします。  
+  
+ [!code-cpp[System.IO.Pipes.AnonymousPipeClientStream_Sample#01](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeClientStream_Sample/cpp/program.cpp#01)]
+ [!code-csharp[System.IO.Pipes.AnonymousPipeClientStream_Sample#01](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeClientStream_Sample/cs/Program.cs#01)]
+ [!code-vb[System.IO.Pipes.AnonymousPipeClientStream_Sample#01](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.Pipes.AnonymousPipeClientStream_Sample/vb/program.vb#01)]  
+  
+## 参照  
+ [パイプ](../../../docs/standard/io/pipe-operations.md)   
+ [方法: ネットワークのプロセス間通信で名前付きパイプを使用する](../../../docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md b/docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md
new file mode 100644
index 00000000000..d0dc9009b3e
--- /dev/null
+++ b/docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md
@@ -0,0 +1,52 @@
+---
+title: "方法: ネットワークのプロセス間通信で名前付きパイプを使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "全二重通信 [.NET Framework], 名前付きパイプ"
+  - "偽装 [.NET Framework], 名前付きパイプ"
+  - "メッセージ ベースの通信 [.NET Framework], 名前付きパイプ"
+  - "複数接続 (名前付きパイプを使用した)"
+  - "名前付きパイプ [.NET Framework]"
+  - "ネットワーク通信 [.NET Framework], 名前付きパイプ"
+  - "パイプ [.NET Framework]"
+ms.assetid: 4e4d7e64-9f1b-4026-98f7-20488ac7b42b
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 方法: ネットワークのプロセス間通信で名前付きパイプを使用する
+名前付きパイプは、パイプ サーバーと 1 つ以上のパイプ クライアントとの間でのプロセス間通信を提供します。  名前付きパイプには、ローカル コンピューター上のプロセス間通信を提供する匿名パイプと比較して、より多くの機能が用意されています。  名前付きパイプは、ネットワーク上の複数のサーバー インスタンスでの全二重通信、メッセージ ベースの通信、およびクライアント偽装をサポートしています。偽装を使用すると、プロセスを接続してリモート サーバー上で独自のアクセス許可セットを使用できます。  
+  
+ 名前付きパイプを実装するには、<xref:System.IO.Pipes.NamedPipeServerStream> クラスと <xref:System.IO.Pipes.NamedPipeClientStream> クラスを使用します。  
+  
+## 使用例  
+ <xref:System.IO.Pipes.NamedPipeServerStream> クラスを使用して、名前付きパイプを作成する例を次に示します。  この例では、サーバー プロセスは 4 つのスレッドを作成します。  各スレッドは、1 つのクライアント接続を受け入れます。  接続されたクライアント プロセスは、サーバーにファイル名を提供します。  クライアントに十分なアクセス許可がある場合は、サーバー プロセスはファイルを開き、その内容をクライアントに送り返します。  
+  
+ [!code-cpp[System.IO.Pipes.NamedPipeServerStream_ImpersonationSample1#01](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.IO.Pipes.NamedPipeServerStream_ImpersonationSample1/cpp/program.cpp#01)]
+ [!code-csharp[System.IO.Pipes.NamedPipeServerStream_ImpersonationSample1#01](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.Pipes.NamedPipeServerStream_ImpersonationSample1/cs/Program.cs#01)]
+ [!code-vb[System.IO.Pipes.NamedPipeServerStream_ImpersonationSample1#01](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.Pipes.NamedPipeServerStream_ImpersonationSample1/vb/program.vb#01)]  
+  
+## 使用例  
+ 次の例は、<xref:System.IO.Pipes.NamedPipeClientStream> クラスを使用するクライアント プロセスを示したものです。  クライアントはサーバー プロセスに接続し、サーバーにファイル名を送信します。  この例では偽装を使用しているため、クライアント アプリケーションを実行している ID はファイルにアクセスする権限を持っている必要があります。  サーバーは、ファイルの内容をクライアントに送り返します。  その後、ファイルの内容がコンソールに表示されます。  
+  
+ [!code-csharp[System.IO.Pipes.NamedPipeClientStream_ImpersonationSample1#01](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.IO.Pipes.NamedPipeClientStream_ImpersonationSample1/cs/Program.cs#01)]
+ [!code-vb[System.IO.Pipes.NamedPipeClientStream_ImpersonationSample1#01](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.Pipes.NamedPipeClientStream_ImpersonationSample1/vb/program.vb#01)]  
+  
+## 信頼性の高いプログラミング  
+ ここで例示したクライアント プロセスとサーバー プロセスは、同じコンピューターで実行することを意図しているため、<xref:System.IO.Pipes.NamedPipeClientStream> オブジェクトには、`"."` というサーバー名が提供されます。  クライアント プロセスとサーバー プロセスを異なるコンピューター上で実行する場合、`"."` はサーバー プロセスを実行するコンピューターのネットワーク名で置換されます。  
+  
+## 参照  
+ <xref:System.Security.Principal.TokenImpersonationLevel>   
+ <xref:System.IO.Pipes.NamedPipeServerStream.GetImpersonationUserName%2A>   
+ [パイプ](../../../docs/standard/io/pipe-operations.md)   
+ [方法: ローカルのプロセス間通信で匿名パイプを使用する](../../../docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-write-characters-to-a-string.md b/docs/standard/io/how-to-write-characters-to-a-string.md
new file mode 100644
index 00000000000..93749559f4a
--- /dev/null
+++ b/docs/standard/io/how-to-write-characters-to-a-string.md
@@ -0,0 +1,50 @@
+---
+title: "方法 : 文字列に文字を書き込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストリーム、書き込み (文字列への文字の)"
+  - "書き込み (文字列への文字の)"
+  - "ストリーム、書き込み (文字列への文字の)"
+  - "I/O [.NET Framework]、書き込み (文字列への文字の)"
+ms.assetid: 1222cbeb-0760-44bf-9888-914a2a37174b
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : 文字列に文字を書き込む
+次のコード例は文字列に文字配列から文字を同期的にと非同期的に書き込みます。  
+  
+## 使用例  
+ 次の例では、配列から文字列に 5 文字を同期的に書き込みます。  
+  
+ [!code-csharp[Conceptual.StringBuilder#9](../../../samples/snippets/csharp/VS_Snippets_CLR/Conceptual.StringBuilder/cs/example2.cs#9)]
+ [!code-vb[Conceptual.StringBuilder#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Conceptual.StringBuilder/vb/example2.vb#9)]  
+  
+## 使用例  
+ 次の例 <xref:System.Windows.Controls.TextBox> のコントロールからのすべての文字を非同期的に読み取り、配列に格納します。  これは <xref:System.Windows.Controls.TextBlock> のコントロールに改行に続く行に、非同期的に各文字または空白文字を書き込みます。  
+  
+ [!code-csharp[Conceptual.StringReader#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.stringreader/cs/source2.cs#2)]
+ [!code-vb[Conceptual.StringReader#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.stringreader/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.IO.StringWriter>   
+ <xref:System.IO.StringWriter.Write%2A?displayProperty=fullName>   
+ <xref:System.Text.StringBuilder>   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)   
+ [方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)   
+ [方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)   
+ [方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)   
+ [方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)   
+ [方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)   
+ [方法 : 文字列から文字を読み取る](../../../docs/standard/io/how-to-read-characters-from-a-string.md)
\ No newline at end of file
diff --git a/docs/standard/io/how-to-write-text-to-a-file.md b/docs/standard/io/how-to-write-text-to-a-file.md
new file mode 100644
index 00000000000..b143403521e
--- /dev/null
+++ b/docs/standard/io/how-to-write-text-to-a-file.md
@@ -0,0 +1,94 @@
+---
+title: "方法 : ファイルにテキストを書き込む | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "書き込み (テキストをファイルに)"
+  - "I/O [.NET Framework]、書き込み (テキストをファイルに)"
+  - "ストリーム、書き込み (テキストをファイルに)"
+  - "データ ストリーム、書き込み (テキストをファイルに)"
+ms.assetid: 060cbe06-2adf-4337-9e7b-961a5c840208
+caps.latest.revision: 29
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# 方法 : ファイルにテキストを書き込む
+このトピックでは、.NET Framework アプリケーションまたは [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリのファイルにテキストを書き込むためのさまざまな方法について説明します。 テキストをファイルに書き込むには、一般に次のクラスおよびメソッドを使用します。  
+  
+-   <xref:System.IO.StreamWriter> \- 同期的にファイルに書き込むメソッド \(<xref:System.IO.StreamWriter.Write%2A> または <xref:System.IO.TextWriter.WriteLine%2A>\) あるいは非同期的に書き込むメソッド \(<xref:System.IO.StreamWriter.WriteAsync%2A> と <xref:System.IO.StreamWriter.WriteLineAsync%2A>\) が含まれています。  
+  
+-   <xref:System.IO.File> – .NET Framework アプリケーションで使用します。 ファイルにテキストを書き込む静的メソッド \(<xref:System.IO.File.WriteAllLines%2A> と <xref:System.IO.File.WriteAllText%2A>\)、あるいはファイルにテキストを追加する静的メソッド \(<xref:System.IO.File.AppendAllLines%2A>、<xref:System.IO.File.AppendAllText%2A>、または <xref:System.IO.File.AppendText%2A>\) があります。  
+  
+-   [FileIO](https://msdn.microsoft.com/library/windows/apps/windows.storage.fileio.aspx) \- [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリで使用します。 ファイルにテキストを書き込む非同期メソッド \([WriteLinesAsync](https://msdn.microsoft.com/library/windows/apps/windows.storage.fileio.writelinesasync.aspx) または [WriteTextAsync](https://msdn.microsoft.com/library/windows/apps/windows.storage.fileio.writetextasync.aspx)\)、あるいはファイルにテキストを追加する非同期メソッド \([AppendLinesAsync](https://msdn.microsoft.com/library/windows/apps/windows.storage.fileio.appendlinesasync.aspx) または [AppendTextAsync](https://msdn.microsoft.com/library/windows/apps/windows.storage.fileio.appendtextasync.aspx)\) が含まれています。  
+  
+ 実行するタスクに焦点を合わせるために、サンプルは単純化されています。 このため、サンプルでは最小限のエラー チェックと、\(例外が存在する場合は\) 最小限の例外処理だけを行います。 通常、実際のアプリケーションではこれよりも信頼性の高いエラー チェックと例外処理を行います。  
+  
+## 使用例  
+ 次の例に、<xref:System.IO.StreamWriter> クラスを使用して、新しいファイルにテキストを一度に 1 行ずつ同期的に書き込む方法を示します。 新しいテキスト ファイルは、ユーザーの \[マイ ドキュメント\] フォルダーに保存されます。`using` ステートメントで <xref:System.IO.StreamWriter> オブジェクトが宣言され、インスタンス化されるため、<xref:System.IO.StreamWriter.Dispose%2A> メソッドが呼び出され、それによってストリームが自動的にフラッシュされて閉じられます。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#WriteLine](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source.cs#writeline)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#WriteLine](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source.vb#writeline)]  
+  
+## 使用例  
+ 次の例に、<xref:System.IO.StreamWriter> クラスを使用して、既存のファイルにテキストを追加する方法を示します。 この例では、前の例と同じテキスト ファイルを使用しています。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#AppendText](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source.cs#appendtext)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#AppendText](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source.vb#appendtext)]  
+  
+## 使用例  
+ 次の例に、<xref:System.IO.StreamWriter> クラスを使用して、新しいファイルにテキストを非同期的に書き込む方法を示します。<xref:System.IO.StreamWriter.WriteAsync%2A> メソッドを呼び出すには、このメソッドの呼び出しを `async` メソッドに含める必要があります。 新しいテキスト ファイルは、ユーザーの \[マイ ドキュメント\] フォルダーに保存されます。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#WriteAsync](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source.cs#writeasync)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#WriteAsync](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source.vb#writeasync)]  
+  
+## 使用例  
+ 次の例に、<xref:System.IO.File> クラスを使用して、新しいファイルにテキストを書き込み、この同じファイルに新しいテキスト行を追加する方法を示します。<xref:System.IO.File.WriteAllText%2A> および <xref:System.IO.File.AppendAllLines%2A> メソッドは、ファイルを自動的に開き、閉じます。<xref:System.IO.File.WriteAllText%2A> メソッドに指定したパスが既に存在する場合、ファイルは上書きされます。  
+  
+ [!code-csharp[Conceptual.BasicIO.TextFiles#WriteFile](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.basicio.textfiles/cs/source.cs#writefile)]
+ [!code-vb[Conceptual.BasicIO.TextFiles#WriteFile](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.basicio.textfiles/vb/source.vb#writefile)]  
+  
+## 使用例  
+ 次の例では、ユーザーの入力を [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでテキスト ファイルに非同期的に書き込む方法を示します。 セキュリティの考慮事項により、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリからファイルを開くには、一般に [FileOpenPicker](http://msdn.microsoft.com/library/windows/apps/windows.storage.pickers.fileopenpicker.aspx) コントロールを使用する必要があります。 この例では、テキスト ファイルを表示するため `FileOpenPicker` がフィルター処理されます。  
+  
+```xaml  
+<Page  
+    x:Class="OpenFileWindowsStore.MainPage"  
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"  
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"  
+    xmlns:local="using:OpenFileWindowsStore"  
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"  
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"  
+    mc:Ignorable="d">  
+  
+    <Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">  
+        <Button Content="save text to a file" HorizontalAlignment="Left" Margin="103,417,0,0" VerticalAlignment="Top"   
+                Width="329" Height="86" FontSize="35" Click="Button_Click"/>  
+        <TextBox Name="UserInputTextBox"  FontSize="18" HorizontalAlignment="Left" Margin="106,146,0,0"   
+                 TextWrapping="Wrap" Text="Write some text here, and select a file to write it to." VerticalAlignment="Top"   
+                 Height="201" Width="558" AcceptsReturn="True"/>  
+        <TextBlock Name="StatusTextBox" HorizontalAlignment="Left" Margin="106,570,0,147" TextWrapping="Wrap" Text="Status:"   
+                   VerticalAlignment="Center" Height="51" Width="1074" FontSize="18" />  
+    </Grid>  
+</Page>  
+```  
+  
+ [!code-csharp[OpenFileWindowsStore#Code](../../../samples/snippets/csharp/VS_Snippets_CLR/openfilewindowsstore/cs/mainpage.xaml.cs#code)]
+ [!code-vb[OpenFileWindowsStore#Code](../../../samples/snippets/visualbasic/VS_Snippets_CLR/openfilewindowsstore/vb/mainpage.xaml.vb#code)]  
+  
+## 参照  
+ <xref:System.IO.StreamWriter>   
+ <xref:System.IO.File.CreateText%2A?displayProperty=fullName>   
+ [方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)   
+ [方法 : 新しく作成されたデータ ファイルに対して読み書きする](../../../docs/standard/io/how-to-read-and-write-to-a-newly-created-data-file.md)   
+ [方法 : ログ ファイルを開いて情報を追加する](../../../docs/standard/io/how-to-open-and-append-to-a-log-file.md)   
+ [方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/index.md b/docs/standard/io/index.md
new file mode 100644
index 00000000000..860a78b3d1b
--- /dev/null
+++ b/docs/standard/io/index.md
@@ -0,0 +1,169 @@
+---
+title: "ファイルおよびストリーム入出力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "データ ストリーム, I/O"
+  - "ファイル, I/O"
+  - "I/O [.NET Framework]"
+  - "IO 名前空間"
+  - "ストリーム, I/O"
+  - "System.IO 名前空間"
+ms.assetid: 4f4a33a9-66b7-4cd7-a285-4ad3e4276cd2
+caps.latest.revision: 33
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 29
+---
+# ファイルおよびストリーム入出力
+ファイルおよびストリーム I\/O \(入出力\) とは、ストレージ メディアとの間のデータの転送を指します。  .NET Framework では、[System.IO](http://go.microsoft.com/fwlink/?LinkId=231142) 名前空間に、データ ストリームおよびファイルで同期的および非同期的に読み取りと書き込みを有効にする型が用意されています。  これらの名前空間には、ファイルを圧縮および圧縮解除する型、パイプとシリアル ポート経由の通信を有効にする型もあります。  
+  
+ ファイルとは、バイトを順序立てて格納する名前付きのコレクションであり、永続ストレージを保有します。  ファイルを操作するときには、ディレクトリ パス、ディスク ストレージ、ファイル名、ディレクトリ名を操作します。  これに対し、ストリームは、バッキング ストアの読み取りと書き込みに使用できるバイトのシーケンスです。バッキング ストアは、複数のストレージ メディアのいずれかになります \(たとえば、ディスク、メモリ\)。  ディスク以外にいくつかのバッキング ストアが存在するのと同じように、ファイル ストリーム以外にも、ネットワーク ストリーム、メモリ ストリーム、パイプ ストリームなど、さまざまなストリームが存在します。  
+  
+## ファイルとディレクトリ  
+ <xref:System.IO?displayProperty=fullName> 名前空間の型を使用して、ファイルとディレクトリを操作できます。  たとえば、ファイルとディレクトリに対するプロパティを取得および設定したり、検索条件に基づいて、ファイルとディレクトリのコレクションを取得したりできます。  
+  
+ 一般的なファイルおよびディレクトリのクラスを次に示します。  
+  
+-   <xref:System.IO.File> \- ファイルを作成、コピー、削除、移動、およびオープンするための静的メソッドを提供し、<xref:System.IO.FileStream> オブジェクトの作成を支援します。  
+  
+-   <xref:System.IO.FileInfo> \- ファイルを作成、コピー、削除、移動、およびオープンするためのインスタンス メソッドを提供し、<xref:System.IO.FileStream> オブジェクトの作成を支援します。  
+  
+-   <xref:System.IO.Directory> \- ディレクトリやサブディレクトリを作成、移動、および反復処理するための静的メソッドを提供します。  
+  
+-   <xref:System.IO.DirectoryInfo> \- ディレクトリやサブディレクトリを作成、移動、および反復処理するためのインスタンス メソッドを提供します。  
+  
+-   <xref:System.IO.Path> \- 複数のプラットフォームにまたがってディレクトリ文字列を処理するためのメソッドおよびプロパティを提供します。  
+  
+ これらのクラスに加えて、Visual Basic のユーザーは、ファイル I\/O 用の <xref:Microsoft.VisualBasic.FileIO.FileSystem?displayProperty=fullName> クラスに用意されているメソッドとプロパティを使用できます。  
+  
+ 「[方法 : ディレクトリをコピーする](../../../docs/standard/io/how-to-copy-directories.md)」、「[方法 : ディレクトリ一覧を作成する](http://msdn.microsoft.com/ja-jp/4d2772b1-b991-4532-a8a6-6ef733277e69)」、および「[方法: ディレクトリとファイルを列挙する](../../../docs/standard/io/how-to-enumerate-directories-and-files.md)」を参照してください。  
+  
+## ストリーム  
+ 抽象基底クラス <xref:System.IO.Stream> は、バイトの読み取りと書き込みをサポートします。  ストリームを表すすべてのクラスは、<xref:System.IO.Stream> クラスから継承されます。  <xref:System.IO.Stream> クラスとその派生クラスは、データ ソースやリポジトリの共通ビューを提供し、プログラマがオペレーティング システムや基になるデバイスに固有の詳細事項を考慮する必要をなくします。  
+  
+ ストリームには次の 3 つの基本的な操作が含まれます。  
+  
+-   読み取り \- ストリームからバイト配列などのデータ構造体にデータを転送します。  
+  
+-   書き込み \- データ ソースからストリームにデータを転送します。  
+  
+-   シーク \- ストリーム内の現在位置を照会および変更します。  
+  
+ 基になるデータ ソースまたはリポジトリによっては、ストリームがサポートできる機能が上記の一部に限られる場合があります。  たとえば、<xref:System.IO.Pipes.PipeStream> クラスは、シークをサポートしません。  ストリームの <xref:System.IO.Stream.CanRead%2A>、<xref:System.IO.Stream.CanWrite%2A>、および <xref:System.IO.Stream.CanSeek%2A> の各プロパティで、そのストリームがサポートする操作を指定します。  
+  
+ 一般的なストリーム クラスを次に示します。  
+  
+-   <xref:System.IO.FileStream> – ファイルの読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream> – 分離ストレージのファイルの読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.MemoryStream> – バッキング ストアとしてメモリの読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.BufferedStream> – 読み取り操作と書き込み操作のパフォーマンスを向上します。  
+  
+-   <xref:System.Net.Sockets.NetworkStream> – ネットワーク ソケットを介して読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.Pipes.PipeStream> – 匿名パイプと名前付きパイプを介して読み取りと書き込みを実行します。  
+  
+-   <xref:System.Security.Cryptography.CryptoStream> – データ ストリームを暗号変換にリンクします。  
+  
+ ストリームを非同期的に操作する例については、「[非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)」を参照してください。  
+  
+## リーダーとライター  
+ <xref:System.IO?displayProperty=fullName> 名前空間には、ストリームからエンコードされた文字を読み取ったり、ストリームに書き込んだりするための型も用意されています。  通常、ストリームはバイトの入出力用に設計されています。  リーダー型とライター型は、ストリームが操作を完了できるように、バイトとの間でエンコードされた文字の変換を処理します。  各リーダー クラスとライター クラスは、クラスの `BaseStream` プロパティから取得できるストリームに関連付けられます。  
+  
+ 一般的なリーダー クラスとライター クラスを次に示します。  
+  
+-   <xref:System.IO.BinaryReader> および <xref:System.IO.BinaryWriter> – バイナリ値としてプリミティブ データ型の読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.StreamReader> および <xref:System.IO.StreamWriter> – 文字とバイトを相互変換するエンコーディング値を使用して、文字の読み取りと書き込みを実行します。  
+  
+-   <xref:System.IO.StringReader> および <xref:System.IO.StringWriter> – 文字列から文字を読み取り、文字列に文字を書き込みます。  
+  
+-   <xref:System.IO.TextReader> および <xref:System.IO.TextWriter> – バイナリ データを除く、文字と文字列の読み取りと書き込みを行う他のリーダーとライターの抽象基底クラスとして機能します。  
+  
+ 「[方法 : ファイルからテキストを読み取る](../../../docs/standard/io/how-to-read-text-from-a-file.md)」、「[方法 : ファイルにテキストを書き込む](../../../docs/standard/io/how-to-write-text-to-a-file.md)」、「[方法 : 文字列から文字を読み取る](../../../docs/standard/io/how-to-read-characters-from-a-string.md)」、および「[方法 : 文字列に文字を書き込む](../../../docs/standard/io/how-to-write-characters-to-a-string.md)」を参照してください。  
+  
+## 非同期 I\/O 操作  
+ 大量のデータを読み取ったり書き込んだりすると、リソースが大量に消費されることがあります。  アプリケーションのユーザーに対する応答性を維持する必要がある場合は、これらのタスクを非同期的に実行する必要があります。  同期 I\/O 操作の場合、大量のリソースを消費する操作が完了するまで UI スレッドがブロックされます。  [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリを開発するときには非同期 I\/O 操作を使用して、アプリが動作しなくなったと受け取られないようにします。  
+  
+ `Async`、<xref:System.IO.Stream.CopyToAsync%2A>、<xref:System.IO.Stream.FlushAsync%2A>、および <xref:System.IO.Stream.ReadAsync%2A> の各メソッドのように、非同期メンバーの名前には <xref:System.IO.Stream.WriteAsync%2A> が含まれています。  これらのメソッドは、`async` キーワードおよび `await` キーワードと共に使用します。  
+  
+ 詳細については、「[非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)」を参照してください。  
+  
+## \[圧縮\]  
+ 圧縮とは、保管するためにファイルのサイズを小さくするプロセスのことです。  圧縮解除は、圧縮ファイルの内容を抽出し、その内容を使用可能な形式にするプロセスです。  <xref:System.IO.Compression?displayProperty=fullName> 名前空間には、ファイルおよびストリームを圧縮および圧縮解除するための型が含まれています。  
+  
+ 次のクラスは、ファイルおよびストリームを圧縮および圧縮解除するときによく使用します。  
+  
+-   <xref:System.IO.Compression.ZipArchive> – ZIP アーカイブのエントリを作成および取得します。  
+  
+-   <xref:System.IO.Compression.ZipArchiveEntry> – 圧縮ファイルを表します。  
+  
+-   <xref:System.IO.Compression.ZipFile> – 圧縮パッケージの作成、抽出、およびオープンを行います。  
+  
+-   <xref:System.IO.Compression.ZipFileExtensions> – 圧縮パッケージのエントリを作成および抽出します。  
+  
+-   <xref:System.IO.Compression.DeflateStream> – Deflate アルゴリズムを使用してストリームを圧縮および圧縮解除します。  
+  
+-   <xref:System.IO.Compression.GZipStream> – gzip データ形式のストリームを圧縮および圧縮解除します。  
+  
+ 「[方法 : ファイルを圧縮して抽出する](../../../docs/standard/io/how-to-compress-and-extract-files.md)」を参照してください。  
+  
+## 分離ストレージ  
+ 分離ストレージは、コードと保存データを関連付ける標準化された方法を定義することにより、分離性と安全性を提供するデータ ストレージ機構です。  ストレージは、ユーザー、アセンブリ、および \(必要に応じて\) ドメイン別に分離された仮想ファイル システムを提供します。  分離ストレージは、アプリケーションにユーザー ファイルへのアクセス許可がない場合に特に便利です。  コンピューターのセキュリティ ポリシーによって制御される方法でアプリケーションの設定またはファイルを保存できます。  
+  
+ 分離ストレージは [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリには使用できません。代わりに、[Windows.Storage](http://msdn.microsoft.com/library/windows/apps/windows.storage.aspx) 名前空間のアプリケーション データ クラスを使用します。  Windows デベロッパー センター内の「[アプリケーション データ](http://go.microsoft.com/fwlink/?LinkId=229175)」を参照してください。  
+  
+ 次のクラスは、分離ストレージを実装するときによく使用します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorage> – 分離ストレージの実装の基底クラスを提供します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFile> – ファイルとディレクトリを格納している分離ストレージ領域を提供します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream> \- 分離ストレージ内のファイルを公開します。  
+  
+ 「[分離ストレージ](../../../docs/standard/io/isolated-storage.md)」を参照してください。  
+  
+## Windows ストア アプリの I\/O 操作  
+ [!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] には、ストリームの読み取りと書き込みを行うための型の多くが含まれています。ただし、このセットにすべての .NET Framework I\/O 型が含まれているわけではありません。  
+  
+ 次に、I\/O 操作を [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリで使用する場合に注意する必要がある重要な違いを示します。  
+  
+-   <xref:System.IO.File>、<xref:System.IO.FileInfo>、<xref:System.IO.Directory>、<xref:System.IO.DirectoryInfo> など、特にファイル操作に関連する型は、[!INCLUDE[net_win8_profile](../../../includes/net-win8-profile-md.md)] に含まれていません。  代わりに、[StorageFile](http://msdn.microsoft.com/library/windows/apps/windows.storage.storagefile.aspx)、[StorageFolder](http://msdn.microsoft.com/library/windows/apps/windows.storage.storagefolder.aspx) など、[!INCLUDE[wrt](../../../includes/wrt-md.md)] の [Windows.Storage](http://msdn.microsoft.com/library/windows/apps/windows.storage.aspx) 名前空間の型を使用します。  
+  
+-   分離ストレージは使用できません。代わりに、[アプリケーション データ](http://go.microsoft.com/fwlink/?LinkId=229175)を使用します。  
+  
+-   UI スレッドをブロックしないように、<xref:System.IO.Stream.ReadAsync%2A>、<xref:System.IO.Stream.WriteAsync%2A> などの非同期メソッドを使用します。  
+  
+-   パス ベース圧縮の型 <xref:System.IO.Compression.ZipFile> と <xref:System.IO.Compression.ZipFileExtensions> は使用できません。  代わりに、[Windows.Storage.Compression](http://msdn.microsoft.com/library/windows/apps/windows.storage.compression.aspx) 名前空間の型を使用します。  
+  
+ 必要に応じて、.NET Framework ストリームと Windows ランタイム ストリームを変換できます。  詳細については、「[方法: .NET Framework ストリームと Windows ランタイム ストリームの間で変換を行う](../../../docs/standard/io/how-to-convert-between-dotnet-streams-and-winrt-streams.md)」または「<xref:System.IO.WindowsRuntimeStreamExtensions>」を参照してください。  
+  
+ [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでの I\/O 操作の詳細については、Windows デベロッパー センターの「[クイック スタート: ファイルの読み取りと書き込み](http://go.microsoft.com/fwlink/p/?LinkId=243072)」を参照してください。  
+  
+## I\/O とセキュリティ  
+ <xref:System.IO?displayProperty=fullName> 名前空間のクラスを使用する場合、アクセス制御リスト \(ACL: Access Control List\) などのオペレーティング システムのセキュリティ要件に従い、ファイルとディレクトリへのアクセスを制御する必要があります。  この要件の他にも、<xref:System.Security.Permissions.FileIOPermission> で指定されている要件を満たす必要があります。  ACL はプログラムで管理できます。  詳細については、「[方法 : アクセス制御リスト エントリを追加または削除する](../../../docs/standard/io/how-to-add-or-remove-access-control-list-entries.md)」を参照してください。  
+  
+ 既定のセキュリティ ポリシーでは、インターネットまたはイントラネットのアプリケーションはユーザーのコンピューターのファイルにアクセスできません。  したがって、インターネットまたはイントラネットを経由してダウンロードされるコードを記述する場合に、物理ファイル パスを必要とする I\/O クラスを使用しないでください。  代わりに、従来の .NET Framework アプリケーション用の[分離ストレージ](../../../docs/standard/io/isolated-storage.md)を使用するか、[!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリ用の[アプリケーション データ](http://go.microsoft.com/fwlink/?LinkId=229175) を使用します。  
+  
+ セキュリティ チェックが実行されるのは、ストリームが構築されている場合だけです。  したがって、ストリームを開いて、そのストリームを信頼度の低いコードやアプリケーション ドメインに渡さないでください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[共通 I\/O タスク](../../../docs/standard/io/commons-tasks.md)|ファイル、ディレクトリ、およびストリームに関連する I\/O タスクの一覧、および各タスクの関連するコンテンツと例へのリンクを示します。|  
+|[非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)|非同期 I\/O のパフォーマンス上の利点と基本的な操作について説明します。|  
+|[分離ストレージ](../../../docs/standard/io/isolated-storage.md)|コードと保存データを関連付ける標準的な方法を定義することにより、分離性と安全性を提供するデータ ストレージ機構について説明します。|  
+|[パイプ](../../../docs/standard/io/pipe-operations.md)|.NET Framework での匿名パイプ操作と名前付きパイプ操作について説明します。|  
+|[メモリ マップト ファイル](../../../docs/standard/io/memory-mapped-files.md)|ディスク上のファイルの内容を仮想メモリ内に格納するメモリ マップト ファイルについて説明します。  メモリ マップト ファイルは、非常に大きなファイルを編集したり、プロセス間通信用の共有メモリを作成したりするために使用できます。|
\ No newline at end of file
diff --git a/docs/standard/io/isolated-storage.md b/docs/standard/io/isolated-storage.md
new file mode 100644
index 00000000000..5feec907727
--- /dev/null
+++ b/docs/standard/io/isolated-storage.md
@@ -0,0 +1,191 @@
+---
+title: "分離ストレージ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "コード, 分離ストレージ"
+  - "データ ストレージ (分離ストレージを使用した)"
+  - "データ ストレージ (分離ストレージを使用した), オプション"
+  - "データ ストレージ (分離ストレージを使用した), 使用しない場合"
+  - "分離ストレージ"
+  - "分離ストレージ, オプション"
+  - "分離ストレージ, 使用しない場合"
+  - "分離"
+  - "位置 (ファイル システム内の分離ストレージの)"
+  - "標準化 (ストレージ システムを)"
+  - "ストア"
+  - "格納 (分離ストレージを使用したデータの)"
+  - "格納 (分離ストレージを使用したデータの), オプション"
+  - "格納 (分離ストレージを使用したデータの), 使用しない場合"
+ms.assetid: aff939d7-9e49-46f2-a8cd-938d3020e94e
+caps.latest.revision: 32
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 31
+---
+# 分離ストレージ
+<a name="top"></a> [!INCLUDE[desktop_appname](../../../includes/desktop-appname-md.md)] アプリでは、分離ストレージは、コードと保存データを関連付ける標準化された方法を定義することにより、分離性と安全性を提供するデータ ストレージ機構です。 標準化には、ほかにも利点があります。 管理者は分離ストレージの操作用にデザインされたツールを使用して、ファイルのストレージ領域の構成、セキュリティ ポリシーの設定、および不要なデータの削除を行うことができます。 分離ストレージを使用すると、ファイル システムの安全な場所を指定するための固有のパスを指定する必要がなくなり、分離ストレージのアクセス権限を持たない他のアプリケーションからデータを保護できます。 アプリケーションのストレージ領域の場所を示すハードコーディングされた情報は不要になります。  
+  
+> [!IMPORTANT]
+>  分離ストレージは [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでは使用できません。 代わりに、`Windows.Storage` API に含まれる [!INCLUDE[wrt](../../../includes/wrt-md.md)] 名前空間内のアプリケーション データ クラスを使用して、ローカル データとローカル ファイルを格納します。 詳細については、Windows デベロッパー センターの[アプリケーション データ](http://go.microsoft.com/fwlink/?LinkId=229175)に関する説明を参照してください。  
+  
+ このトピックは、次のセクションで構成されています。  
+  
+-   [データ コンパートメントとデータ ストア](#data_compartments_and_stores)  
+  
+-   [分離ストレージのクォータ](#quotas)  
+  
+-   [安全なアクセス](#secure_access)  
+  
+-   [許可されるアクセス権限とセキュリティのリスク](#allowed_usage)  
+  
+-   [分離ストレージの場所](#isolated_storage_locations)  
+  
+-   [分離ストレージの作成、列挙、および削除](#isolated_storage_tasks)  
+  
+-   [分離ストレージのシナリオ](#scenarios_for_isolated_storage)  
+  
+-   [関連トピック](#related_topics)  
+  
+-   [参照](#reference)  
+  
+<a name="data_compartments_and_stores"></a>   
+## データ コンパートメントとデータ ストア  
+ アプリケーションでファイルにデータを格納する場合は、ファイル名とストレージの場所を慎重に選択して、ストレージの場所が他のアプリケーションに知られたり、無防備に破壊されたりする可能性を最小限に抑える必要があります。 このような問題を管理するための標準的なシステムが適切な場所に用意されていないと、ストレージの問題点を最小限に抑える特別な技術の開発が複雑になり、信頼できる結果が得られません。  
+  
+ 分離ストレージを使用すると、データは常にユーザーおよびアセンブリ別に分離されます。 アセンブリの発生元または厳密な名前などの資格情報によって、アセンブリの ID が決定されます。 また、同様の資格情報を使用して、データをアプリケーション ドメイン別に分離することもできます。  
+  
+ 分離ストレージを使用している場合、アプリケーションはコードの ID のいくつかの側面 \(発行元や署名など\) に関連付けられた固有のデータ コンパートメントにデータを保存します。 データ コンパートメントは抽象概念であり、特定の記憶場所ではありません。データ コンパートメントは、データが格納される実際のディレクトリ位置が含まれている、ストアと呼ばれる 1 つ以上の分離ストレージ ファイルで構成されています。 たとえば、アプリケーションがそのアプリケーションに関連付けられたデータ コンパートメントを持ち、ファイル システムのディレクトリがそのアプリケーションのデータを実際に保存するストアを実装します。 ストアには、ユーザー設定情報からアプリケーション状態まで、どのような種類のデータでも保存できます。 開発者にとって、データ コンパートメントの場所は明確ではありません。 通常、ストアはクライアントに常駐しますが、サーバー アプリケーションがユーザーを偽装することによって機能し、分離ストアを使用して情報を格納することもあります。 また、サーバー上の分離ストレージには、情報と共にユーザーのローミング プロファイルを格納できます。これにより、情報はローミング ユーザーと共に移動します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="quotas"></a>   
+## 分離ストレージのクォータ  
+ クォータは、使用できる分離ストレージの量に対する制限です。 クォータには、ファイル領域のバイト数だけでなく、ストア内のディレクトリやその他の情報に関連するオーバーヘッドも含まれます。 分離ストレージは許容クォータを使用します。許容クォータは、<xref:System.Security.Permissions.IsolatedStoragePermission> オブジェクトを使用して設定されるストレージ制限です。 クォータを超えるデータを書き込もうとすると、<xref:System.IO.IsolatedStorage.IsolatedStorageException> 例外がスローされます。  セキュリティ ポリシーによって、コードに与えるアクセス許可が決定されます。セキュリティ ポリシーは、.NET Framework 構成ツール \(Mscorcfg.msc\) を使用して修正できます。<xref:System.Security.Permissions.IsolatedStoragePermission> を与えられたコードは、<xref:System.Security.Permissions.IsolatedStoragePermission.UserQuota%2A> プロパティで許容されたストレージの範囲内だけに限定されます。 しかし、別のユーザー ID を提示することにより許容クォータを無視できるため、許容クォータはコードの動作に対する厳格な制限ではなく、動作方法についての指針として使用されます。  
+  
+ ローミング ストアに対しては、クォータは適用されません。 そのため、ローミング ストアを使用するコードに対しては、少し高いレベルのアクセス許可が必要になります。 列挙値 <xref:System.Security.Permissions.IsolatedStorageContainment> および <xref:System.Security.Permissions.IsolatedStorageContainment> により、ローミング ユーザーの分離ストレージを使用するためのアクセス許可を指定します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="secure_access"></a>   
+## 安全なアクセス  
+ 分離ストレージを使用すると、完全な権限を与えられていないアプリケーションでも、コンピューターのセキュリティ ポリシーによって制御される方法でデータを格納できます。 分離ストレージは、慎重に実行する必要のあるダウンロードされるコンポーネントに対しては、特に有益です。 標準の I\/O 機構を使用してファイル システムにアクセスする場合に、この種のコード アクセス許可がセキュリティ ポリシーによって与えられるのは非常にまれです。 ただし、既定では、ローカル コンピューター、ローカル ネットワーク、またはインターネットから実行するコードには、分離ストレージを使用する権限が与えられています。  
+  
+ 管理者は、適切な信頼レベルに基づいて、アプリケーションやユーザーが利用できる分離ストレージの容量を制限できます。 また、管理者は、ユーザーの永続的なデータを完全に削除できます。 分離ストレージを作成したり、分離ストレージにアクセスしたりするには、適切な <xref:System.Security.Permissions.IsolatedStorageFilePermission> アクセス許可を持っている必要があります。  
+  
+ 分離ストレージにアクセスするには、必要なすべてのネイティブ プラットフォーム オペレーティング システム権限が必要です。 どのユーザーにファイル システムを使用する権限を与えるかを制御するアクセス制御リスト \(ACL: Access Control List\) の要件を満たしている必要があります。 .NET Framework のアプリケーションには、分離ストレージにアクセスするためのオペレーティング システム権限が既にあります。ただし、アプリケーションがプラットフォーム固有の偽装を行っていない場合だけです。 偽装している場合は、アプリケーションが偽装しているユーザー ID に対して分離ストレージにアクセスするための適切なオペレーティング システム権限が与えられていることをアプリケーションで確認する責任があります。 偽装によるアクセスは、Web から実行またはダウンロードされたコードで、特定のユーザーに関連付けられたストレージ領域を読み取ったり書き込んだりする場合には都合のよい方法です。  
+  
+ 共通言語ランタイムは、<xref:System.Security.Permissions.IsolatedStorageFilePermission> オブジェクトを使用して分類ストレージへのアクセスを制御します。 各オブジェクトには、次の値を指定するプロパティがあります。  
+  
+-   許可するアクセス権限。許可するアクセスの種類を指定します。 値は <xref:System.Security.Permissions.IsolatedStorageContainment> 列挙体のメンバーです。 これらの値の詳細については、次のセクションの表を参照してください。  
+  
+-   ストレージ クォータ。前述のセクションを参照してください。  
+  
+ コードが最初にストアを開く場合、ランタイムが <xref:System.Security.Permissions.IsolatedStorageFilePermission> アクセス許可を要求します。 コードに与えられている権限の程度に応じて、このアクセス許可を与えるかどうかが決定されます。 アクセス許可が与えられた場合は、セキュリティ ポリシーとコードからの <xref:System.Security.Permissions.IsolatedStorageFilePermission> の要求によって、許可される使用法とストレージ クォータの値が決定されます。 セキュリティ ポリシーは、.NET Framework 構成ツール \(Mscorcfg.msc\) を使用して設定します。 それぞれの呼び出し元に最低限適切なアクセス権限が与えられていることを確認するために、コール スタック内のすべての呼び出し元がチェックされます。 ランタイムは、ファイルを保存するストアを開いたコードまたは作成したコードに与えられているクォータもチェックします。 これらの条件を満たしている場合に、アクセス許可が与えられます。 クォータは、ストアにファイルが書き込まれるたびに再チェックされます。  
+  
+ 共通言語ランタイムは、適切な <xref:System.Security.Permissions.IsolatedStorageFilePermission> をすべてセキュリティ ポリシーに基づいて与えるため、アプリケーションのコードはアクセス許可を要求する必要はありません。 しかし、<xref:System.Security.Permissions.IsolatedStorageFilePermission> を含め、アプリケーションに必要な特定のアクセス許可を要求するのにはそれなりの理由があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="allowed_usage"></a>   
+## 許可されるアクセス権限とセキュリティのリスク  
+ <xref:System.Security.Permissions.IsolatedStorageFilePermission> で指定されたアクセス権限によって、コードが分離ストレージを成および使用する権限のレベルが決まります。 アクセス許可に指定されているアクセス権限と分離タイプの対応関係をまとめた表を次に示します。また、それぞれのアクセス権限に関係するセキュリティのリスクを要約も示します。  
+  
+|アクセス権限|分離タイプ|セキュリティのリスク|  
+|------------|-----------|----------------|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|分離ストレージの使用は不可。|セキュリティのリスクはありません。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|ユーザー、ドメイン、およびアセンブリ別の分離。 各アセンブリがドメイン内にサブストアを 1 つ持っています。 このアクセス許可を使用するストアは、さらに、暗黙にコンピューター別にも分離されます。|このアクセス許可レベルでは、権限なしの承認されない使用に対してリソースが保護されません。ただし、クォータを適用すると、承認されない使用に対する保護を強化できます。 このような認証されない使用は、サービス不能攻撃と呼ばれます。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|`DomainIsolationByUser` と同じですが、ローミング ユーザー プロファイルが有効で、クォータが適用されていない場合は、ストアは移動先の場所に保存されます。|クォータを使用できないため、ストレージ リソースはサービス不能攻撃に対して、より攻撃されやすくなります。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|ユーザーおよびアセンブリ別の分離。 このアクセス許可を使用するストアは、さらに、暗黙にコンピューター別にも分離されます。|このレベルでは、サービス不能攻撃の防止を強化するためにクォータが適用されます。 別のドメインの同じアセンブリがこのストアにアクセスできるので、アプリケーション間で情報がリークする可能性が大きくなります。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|`AssemblyIsolationByUser` と同じですが、ローミング ユーザー プロファイルが有効で、クォータが適用されていない場合は、ストアは移動先の場所に保存されます。|`AssemblyIsolationByUser` と同じですが、クォータが適用されないため、サービス不能攻撃のリスクが大きくなります。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|ユーザー別の分離。 通常、管理ツールやデバッグ ツールのみ、このレベルのアクセス許可が使用されます。|このアクセス許可によるアクセスでは、アセンブリの分離とは関係なく、ユーザーの分離ストレージ ファイルやディレクトリはどれも表示または削除できます。 情報のリークとデータ消失のリスクだけでなく、ほかのリスクもあります。|  
+|<xref:System.Security.Permissions.IsolatedStorageContainment>|全ユーザー、ドメイン、およびアセンブリ別の分離。 通常、管理ツールやデバッグ ツールのみ、このレベルのアクセス許可が使用されます。|このアクセス許可では、すべてのユーザーのすべての分離ストアがあらゆるリスクにさらされる可能性があります。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="isolated_storage_locations"></a>   
+## 分離ストレージの場所  
+ オペレーティング システムのファイル システムを使用して分離ストレージの変化を検査すると役立つ場合があります。 また、分離ストレージ ファイルの場所を知る必要がある場合もあります。 分離ストレージ ファイルの場所は、オペレーティングによって異なります。 いくつかの一般的なオペレーティング システムで、分離ストレージが作成されるルート位置を次の表に示します。 このルート位置の下の Microsoft\\IsolatedStorage のディレクトリを検索してください。 ファイル システムの分離ストレージを表示するには、隠しファイルやフォルダーが表示されるようにフォルダーの設定を変更する必要があります。  
+  
+|オペレーティング システム|ファイル システム上の位置|  
+|-------------------|-------------------|  
+|Windows 2000、Windows XP、Windows Server 2003 \(Windows NT 4.0 からのアップグレード\)|ローミングに対応したストア \=<br /><br /> \<SYSTEMROOT\>\\Profiles\\\<user\>\\Application Data<br /><br /> ローミングに対応しないストア \=<br /><br /> \<SYSTEMROOT\>\\Profiles\\\<user\>\\Local Settings\\Application Data|  
+|Windows 2000 \- クリーン インストール \(および Windows 98 と Windows NT 3.51 からのアップグレード\)|ローミングに対応したストア \=<br /><br /> \<SYSTEMDRIVE\>\\Documents and Settings\\\<user\>\\Application Data<br /><br /> ローミングに対応しないストア \=<br /><br /> \<SYSTEMDRIVE\>\\Documents and Settings\\\<user\>\\Local Settings\\Application Data|  
+|Windows XP、Windows Server 2003 \- クリーン インストール \(および Windows 2000 と Windows 98 からのアップグレード\)|ローミングに対応したストア \=<br /><br /> \<SYSTEMDRIVE\>\\Documents and Settings\\\<user\>\\Application Data<br /><br /> ローミングに対応しないストア \=<br /><br /> \<SYSTEMDRIVE\>\\Documents and Settings\\\<user\>\\Local Settings\\Application Data|  
+|[!INCLUDE[win8](../../../includes/win8-md.md)]、Windows 7、Windows Server 2008、Windows Vista|ローミングに対応したストア \=<br /><br /> \<SYSTEMDRIVE\>\\Users\\\<user\>\\AppData\\Roaming<br /><br /> ローミングに対応しないストア \=<br /><br /> \<SYSTEMDRIVE\>\\Users\\\<user\>\\AppData\\Local|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="isolated_storage_tasks"></a>   
+## 分離ストレージの作成、列挙、および削除  
+ .NET Framework には、<xref:System.IO.IsolatedStorage> 名前空間に、分離ストレージを必要とするタスクの実行に役立つ 3 つのクラスが用意されています。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFile>。<xref:System.IO.IsolatedStorage.IsolatedStorage?displayProperty=fullName> の派生クラスであり、格納されたアセンブリおよびアプリケーション ファイルの基本的な管理を提供します。<xref:System.IO.IsolatedStorage.IsolatedStorageFile> クラスのインスタンスは、ファイル システム内に存在する 1 つのストアを表します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream>。<xref:System.IO.FileStream?displayProperty=fullName> の派生クラスであり、ストア内のファイルへのアクセスを提供します。  
+  
+-   <xref:System.IO.IsolatedStorage.IsolatedStorageScope> クラス。適切な分離タイプのストアの作成および選択を可能にする列挙体です。  
+  
+ 分離ストレージ クラスを使用すると、分離ストレージの作成、列挙、および削除を行うことができます。 これらの作業を実行するためのメソッドは、<xref:System.IO.IsolatedStorage.IsolatedStorageFile> オブジェクトを通じて使用できます。 操作によっては、分離ストレージを管理する権限を表す <xref:System.Security.Permissions.IsolatedStorageFilePermission> アクセス許可が必要です。また、ファイルやディレクトリにアクセスするためのオペレーティング システム権限が必要な場合もあります。  
+  
+ 分離ストレージに関する一般的な作業を具体的に説明する一連の例については、「[関連トピック](#related_topics)」に示す「方法」トピックを参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="scenarios_for_isolated_storage"></a>   
+## 分離ストレージのシナリオ  
+ 分離ストレージは、次の 4 つのシナリオを含め、さまざまな状況で役立ちます。  
+  
+-   ダウンロードされたコントロール。 通常の I\/O クラスを使用して、インターネットからダウンロードしたマネージ コード コントロールをハード ドライブに書き込むことはできません。ただし、分離ストレージを使用することにより、ユーザーの設定やアプリケーション状態を永続化できます。  
+  
+-   共有コンポーネント ストレージ。 アプリケーション間で共有されるコンポーネントで分離ストレージを使用することにより、データ ストアへのアクセスを制限できます。  
+  
+-   サーバー ストレージ。 サーバー アプリケーションでは、アプリケーションに対する要求を行う多数のユーザーに個別のストアを提供するために分離ストレージを使用できます。 分離ストレージは常にユーザー別に分離されているため、サーバーは、要求を行うユーザーを偽装する必要があります。 サーバーがユーザーを偽装する場合、データは、プリンシパルの ID \(アプリケーションがアプリケーションのユーザーを識別するために使用する ID と同じ ID\) に基づいて分離されます。  
+  
+-   ローミング。 アプリケーションでは、分離ストレージをローミング ユーザー プロファイルと共に使用することもできます。 分離ストレージとローミング ユーザー プロファイルを一緒に使用することにより、ユーザーの分離ストアは、プロファイルと共に移動します。  
+  
+ 分離ストレージを使用してはならないのは、次のような場合です。  
+  
+-   暗号化されていないキー、パスワードなど、重要な機密情報の格納。分離ストレージは信頼性の高いコード、アンマネージ コード、またはコンピューターの信頼されるユーザーからは保護されていません。  
+  
+-   コードの格納。  
+  
+-   管理者が制御する構成設定と配置設定の格納。 ユーザー設定は管理者が制御しないので、構成設定とは見なされません。  
+  
+ 多くのアプリケーションでは、データベースを使用してデータを格納し、分離しています。データベースを使用する場合は、データベースの 1 行または複数の行で 1 人の特定のユーザーのストレージを表します。 ユーザー数が少ない場合、データベースを使用するオーバーヘッドが重要である場合、またはデータベース機能が存在しない場合は、データベースの代わりに分離ストレージを使用できます。 また、データベース内の行よりも複雑で柔軟性のあるストレージがアプリケーションに必要な場合でも、分離ストレージによって実行可能な選択肢が用意されます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[分離のタイプ](../../../docs/standard/io/types-of-isolation.md)|さまざまなタイプの分離を説明します。|  
+|[方法 : 分離ストレージでストアを取得する](../../../docs/standard/io/how-to-obtain-stores-for-isolated-storage.md)|<xref:System.IO.IsolatedStorage.IsolatedStorageFile> クラスを使用して、ユーザーおよびアセンブリ別に分離されたストアを取得する例を示します。|  
+|[方法 : 分離ストレージでストアを列挙する](../../../docs/standard/io/how-to-enumerate-stores-for-isolated-storage.md)|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetEnumerator%2A?displayProperty=fullName> メソッドを使用して、特定のユーザーのすべての分離ストレージのサイズを計算する方法を示します。|  
+|[方法 : 分離ストレージでストアを削除する](../../../docs/standard/io/how-to-delete-stores-in-isolated-storage.md)|<xref:System.IO.IsolatedStorage.IsolatedStorageFile.Remove%2A?displayProperty=fullName> メソッドを 2 とおりの方法で使用して、分離ストアを削除する方法を示します。|  
+|[方法: 分離ストレージの領域不足状態に備える](../../../docs/standard/io/how-to-anticipate-out-of-space-conditions-with-isolated-storage.md)|分離ストアの残りの領域を計測する方法を示します。|  
+|[方法 : 分離ストレージでファイルおよびディレクトリを作成する](../../../docs/standard/io/how-to-create-files-and-directories-in-isolated-storage.md)|分離ストア内にファイルやディレクトリを作成する例を示します。|  
+|[方法 : 分離ストレージ内でファイルおよびディレクトリを検索する](../../../docs/standard/io/how-to-find-existing-files-and-directories-in-isolated-storage.md)|分離ストレージ内のディレクトリ構造やファイルを読み取る方法を示します。|  
+|[方法 : 分離ストレージ内でファイルの読み取りと書き込みを行う](../../../docs/standard/io/how-to-read-and-write-to-files-in-isolated-storage.md)|分離ストレージ ファイルに文字列を書き込み、その文字列を読み取る例を示します。|  
+|[方法 : 分離ストレージでファイルおよびディレクトリを削除する](../../../docs/standard/io/how-to-delete-files-and-directories-in-isolated-storage.md)|分離ストレージのファイルやディレクトリを削除する方法を示します。|  
+|[ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)|ファイルとデータ ストリームに同期的および非同期的にアクセスする方法を説明します。|  
+  
+<a name="reference"></a>   
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorage?displayProperty=fullName>  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFile?displayProperty=fullName>  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageFileStream?displayProperty=fullName>  
+  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageScope?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/io/media/memmappersisted.png b/docs/standard/io/media/memmappersisted.png
new file mode 100644
index 00000000000..cec15f87d30
Binary files /dev/null and b/docs/standard/io/media/memmappersisted.png differ
diff --git a/docs/standard/io/media/typesofisolation.gif b/docs/standard/io/media/typesofisolation.gif
new file mode 100644
index 00000000000..beea6c174c3
Binary files /dev/null and b/docs/standard/io/media/typesofisolation.gif differ
diff --git a/docs/standard/io/memory-mapped-files.md b/docs/standard/io/memory-mapped-files.md
new file mode 100644
index 00000000000..81f93e7552c
--- /dev/null
+++ b/docs/standard/io/memory-mapped-files.md
@@ -0,0 +1,149 @@
+---
+title: "メモリ マップト ファイル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "プロセス間通信"
+  - "メモリ マップト ファイル"
+ms.assetid: a483d1b5-64aa-45b6-86ef-11b859f7f02e
+caps.latest.revision: 24
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# メモリ マップト ファイル
+メモリ マップト ファイルには、仮想メモリ内のファイルの内容が含まれています。  ファイルとメモリ空間の間のこのマッピングによって、複数のプロセスを含むアプリケーションは、メモリを直接読み書きすることでファイルを変更できます。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、MSDN ライブラリの「[Managing Memory\-Mapped Files in Win32 \(Win32 でのメモリマップ ファイルの管理\)](http://go.microsoft.com/fwlink/?linkid=180801)」で説明されているように、マネージ コードを使用して、ネイティブ Windows 関数がメモリ マップト ファイルにアクセスする場合と同じ方法でメモリ マップト ファイルにアクセスできます。  
+  
+ メモリ マップト ファイルには次の 2 種類があります。  
+  
+-   永続化メモリ マップト ファイル  
+  
+     永続化ファイルは、ディスク上のソース ファイルに関連付けられているメモリ マップト ファイルです。  最後のプロセスがファイルの操作を終了すると、データがディスク上のソース ファイルに保存されます。  これらのメモリ マップト ファイルは、きわめて大きなソース ファイルの操作に適しています。  
+  
+-   非永続化メモリ マップト ファイル  
+  
+     非永続化ファイルは、ディスク上のファイルに関連付けられていないメモリ マップト ファイルです。  最後のプロセスがファイルの操作を終了すると、データが失われ、ガベージ コレクションによってファイルが解放されます。  これらのファイルは、プロセス間通信 \(IPC\) 用の共有メモリの作成に適しています。  
+  
+## プロセス、ビュー、およびメモリ管理  
+ メモリ マップト ファイルは、複数のプロセス間で共有できます。  ファイルを作成したプロセスによって割り当てられている共通名を使用して、複数のプロセスを同じメモリ マップト ファイルにマップできます。  
+  
+ メモリ マップト ファイルを操作するには、メモリ マップト ファイル全体またはその一部のビューを作成する必要があります。  また、メモリ マップト ファイルの同じ部分に対するマルチ ビューを作成し、それによって同時実行メモリを作成することもできます。  2 つのビューが同時実行されるには、それらのビューを同じメモリ マップト ファイルから作成する必要があります。  
+  
+ ファイルがメモリ マッピングで使用できるアプリケーションの論理メモリ空間のサイズ \(32 ビット コンピューターでは 2 GB\) よりも大きい場合にも、マルチ ビューが必要になる可能性があります。  
+  
+ ビューには、ストリーム アクセス ビューとランダム アクセス ビューの 2 種類があります。  ファイルへの順次アクセスにはストリーム アクセス ビューを使用します。これは、非永続化ファイルと IPC に推奨されます。  ランダム アクセス ビューは、永続化ファイルの操作に適しています。  
+  
+ メモリ マップト ファイルへは、オペレーティング システムのメモリ マネージャーを通じてアクセスするため、ファイルは複数のページに自動的に分割され、必要に応じてアクセスされます。  メモリ管理を自分で行う必要はありません。  
+  
+ 次の図に、複数のプロセスがどのように同じメモリ マップト ファイルへの複数の重なるビューを同時に持つことができるかを示します。  
+  
+ ![メモリ マップ ファイルへのビューを表示します。](../../../docs/standard/io/media/memmappersisted.png "MemMapPersisted")  
+メモリ マップト ファイルへの複数の重なるビュー  
+  
+## メモリ マップト ファイルのプログラミング  
+ メモリ マップト ファイル オブジェクトとそのメンバーを使用するための手引きを次の表に示します。  
+  
+|タスク|使用するメソッドまたはプロパティ|  
+|---------|----------------------|  
+|ディスク上のファイルからの永続化メモリ マップト ファイルを表す <xref:System.IO.MemoryMappedFiles.MemoryMappedFile> オブジェクトを取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateFromFile%2A?displayProperty=fullName> メソッド|  
+|\(ディスク上のファイルに関連付けられていない\) 非永続化メモリ マップト ファイルを表す <xref:System.IO.MemoryMappedFiles.MemoryMappedFile> オブジェクトを取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateNew%2A?displayProperty=fullName> メソッド<br /><br /> または<br /><br /> <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateOrOpen%2A?displayProperty=fullName> メソッド|  
+|既存の \(永続化または非永続化\) メモリ マップト ファイルの <xref:System.IO.MemoryMappedFiles.MemoryMappedFile> オブジェクトを取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.OpenExisting%2A?displayProperty=fullName> メソッド|  
+|メモリ マップト ファイルへの順次アクセス ビューを表す <xref:System.IO.UnmanagedMemoryStream> オブジェクトを取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateViewStream%2A?displayProperty=fullName> メソッド|  
+|メモリ マップト ファイルへのランダム アクセス ビューを表す <xref:System.IO.UnmanagedMemoryAccessor> を取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateViewAccessor%2A?displayProperty=fullName> メソッド|  
+|アンマネージ コードで使用するために <xref:Microsoft.Win32.SafeHandles.SafeMemoryMappedViewHandle> オブジェクトを取得する。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.SafeMemoryMappedFileHandle%2A?displayProperty=fullName> プロパティ。<br /><br /> または<br /><br /> <xref:System.IO.MemoryMappedFiles.MemoryMappedViewAccessor.SafeMemoryMappedViewHandle%2A?displayProperty=fullName> プロパティ。<br /><br /> または<br /><br /> <xref:System.IO.MemoryMappedFiles.MemoryMappedViewStream.SafeMemoryMappedViewHandle%2A?displayProperty=fullName> プロパティ。|  
+|ビューが作成されるまで、メモリ割り当てを延期する \(非永続化ファイルのみ\)。<br /><br /> \(現在のシステム ページ サイズを確認するには、<xref:System.Environment.SystemPageSize%2A?displayProperty=fullName> プロパティを使用します\)。|<xref:System.IO.MemoryMappedFiles.MemoryMappedFileOptions?displayProperty=fullName> 値を持つ <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateNew%2A> メソッド<br /><br /> または<br /><br /> <xref:System.IO.MemoryMappedFiles.MemoryMappedFileOptions> 列挙体をパラメーターとして持つ <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateOrOpen%2A> メソッド。|  
+  
+### Security  
+ <xref:System.IO.MemoryMappedFiles.MemoryMappedFileAccess> 列挙体をパラメーターとして受け取る次のメソッドを使用して、メモリ マップト ファイルの作成時にアクセス権を適用できます。  
+  
+-   <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateFromFile%2A?displayProperty=fullName>  
+  
+-   <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateNew%2A?displayProperty=fullName>  
+  
+-   <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateOrOpen%2A?displayProperty=fullName>  
+  
+ <xref:System.IO.MemoryMappedFiles.MemoryMappedFileRights> をパラメーターとして受け取る <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.OpenExisting%2A> メソッドを使用して、既存のメモリ マップト ファイルを開く操作に対するアクセス権を指定できます。  
+  
+ また、定義済みのアクセス規則が格納されている <xref:System.IO.MemoryMappedFiles.MemoryMappedFileSecurity> オブジェクトを含めることもできます。  
+  
+ メモリ マップト ファイルに新規または変更済みのアクセス規則を適用するには、<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.SetAccessControl%2A> メソッドを使用します。  既存のファイルからアクセス規則または監査規則を取得するには、<xref:System.IO.MemoryMappedFiles.MemoryMappedFile.GetAccessControl%2A> メソッドを使用します。  
+  
+## 例  
+  
+### 永続化メモリ マップト ファイル  
+ <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateFromFile%2A> メソッドは、ディスク上の既存のファイルからメモリ マップト ファイルを作成します。  
+  
+ 次の例では、きわめて大きなファイルの一部のメモリ マップト ビューを作成し、その一部分を操作します。  
+  
+ [!code-csharp[MemoryMappedFiles.MemoryMappedFile.CreateFromFile#1](../../../samples/snippets/csharp/VS_Snippets_CLR/memorymappedfiles.memorymappedfile.createfromfile/cs/program.cs#1)]
+ [!code-vb[MemoryMappedFiles.MemoryMappedFile.CreateFromFile#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/memorymappedfiles.memorymappedfile.createfromfile/vb/program.vb#1)]  
+  
+ 別のプロセスに対して同じメモリ マップト ファイルを開く例を、次に示します。  
+  
+ [!code-csharp[MemoryMappedFiles.MemoryMappedFile.OpenExisting#1](../../../samples/snippets/csharp/VS_Snippets_CLR/memorymappedfiles.memorymappedfile.openexisting/cs/program.cs#1)]
+ [!code-vb[MemoryMappedFiles.MemoryMappedFile.OpenExisting#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/memorymappedfiles.memorymappedfile.openexisting/vb/program.vb#1)]  
+  
+### 非永続化メモリ マップト ファイル  
+ <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateNew%2A> メソッドおよび <xref:System.IO.MemoryMappedFiles.MemoryMappedFile.CreateOrOpen%2A> メソッドは、ディスク上の既存のファイルに対応付けられないメモリ マップト ファイルを作成します。  
+  
+ 次の例は、メモリ マップト ファイルにブール値を書き込む、3 つの独立したプロセス \(コンソール アプリケーション\) で構成されます。  次の順序で処理が実行されます。  
+  
+1.  `Process A` がメモリ マップト ファイルを作成し、値を書き込みます。  
+  
+2.  `Process B` がメモリ マップト ファイルを開き、値を書き込みます。  
+  
+3.  `Process C` がメモリ マップト ファイルを開き、値を書き込みます。  
+  
+4.  `Process A` がメモリ マップト ファイルの値を読み込み、表示します。  
+  
+5.  `Process A` がメモリ マップト ファイルの処理を終了すると、ガベージ コレクションによってファイルが直ちにクリアされます。  
+  
+ この例を実行するには、次の手順に従います。  
+  
+1.  アプリケーションをコンパイルし、3 つのコマンド プロンプト ウィンドウを開きます。  
+  
+2.  最初のコマンド プロンプト ウィンドウで、`Process A` を実行します。  
+  
+3.  2 つ目のコマンド プロンプト ウィンドウで、`Process B` を実行します。  
+  
+4.  `Process A` に戻り、Enter キーを押します。  
+  
+5.  3 つ目のコマンド プロンプト ウィンドウで、`Process C` を実行します。  
+  
+6.  `Process A` に戻り、Enter キーを押します。  
+  
+ `Process A` の出力は次のとおりです。  
+  
+```  
+Start Process B and press ENTER to continue.  
+Start Process C and press ENTER to continue.  
+Process A says: True  
+Process B says: False  
+Process C says: True  
+```  
+  
+ **プロセス A**  
+  
+ [!code-csharp[System.IO.MemoryMappedFiles_IPC_X#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_x/cs/program.cs#1)]
+ [!code-vb[System.IO.MemoryMappedFiles_IPC_X#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_x/vb/program.vb#1)]  
+  
+ **プロセス B**  
+  
+ [!code-csharp[System.IO.MemoryMappedFiles_IPC_A#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_a/cs/program.cs#1)]
+ [!code-vb[System.IO.MemoryMappedFiles_IPC_A#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_a/vb/program.vb#1)]  
+  
+ **プロセス C**  
+  
+ [!code-csharp[System.IO.MemoryMappedFiles_IPC_B#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_b/cs/program.cs#1)]
+ [!code-vb[System.IO.MemoryMappedFiles_IPC_B#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.memorymappedfiles_ipc_b/vb/program.vb#1)]  
+  
+## 参照  
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)
\ No newline at end of file
diff --git a/docs/standard/io/pipe-operations.md b/docs/standard/io/pipe-operations.md
new file mode 100644
index 00000000000..467c6d02986
--- /dev/null
+++ b/docs/standard/io/pipe-operations.md
@@ -0,0 +1,46 @@
+---
+title: ".NET Framework でのパイプ操作 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "パイプ [.NET Framework]"
+  - "パイプ操作 [.NET Framework]"
+  - "プロセス間通信 [.NET Framework]、パイプ"
+  - "I/O [.NET Framework]、パイプ"
+ms.assetid: 7b964ebd-7a4f-4d28-8194-7841f9e4c702
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# .NET Framework でのパイプ操作
+パイプは、プロセス間通信を行うための手段を提供します。  次の 2 種類のパイプがあります。  
+  
+-   匿名パイプ  
+  
+     匿名パイプは、ローカル コンピューターでのプロセス間通信を実現します。  匿名パイプは、名前付きパイプと比較してオーバーヘッドは小さくなりますが、提供するサービスも限定されます。  匿名パイプは一方向であり、ネットワーク経由では使用できません。  1 つのサーバー インスタンスのみをサポートします。  匿名パイプは、スレッド間または親子のプロセス間での通信に有用です。親子のプロセス間の通信では、子プロセスが作成されたときに、パイプ ハンドルを子プロセスに簡単に渡すことができます。  
+  
+     .NET Framework では、<xref:System.IO.Pipes.AnonymousPipeServerStream> と <xref:System.IO.Pipes.AnonymousPipeClientStream> クラスを使用して、匿名パイプを実装します。  
+  
+     「[方法: ローカルのプロセス間通信で匿名パイプを使用する](../../../docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md)」を参照してください。  
+  
+-   名前付きパイプ  
+  
+     名前付きパイプは、パイプ サーバーと 1 つ以上のパイプ クライアントとの間でのプロセス間通信を提供します。  名前付きパイプでは、一方向または双方向のパイプを使用できます。  メッセージ ベースの通信をサポートし、複数のクライアントが同じパイプ名を使用してサーバーに対して同時に接続できます。  名前付きパイプは、偽装もサポートしています。偽装を使用すると、プロセス間接続において、リモート サーバー上で独自のアクセス許可を使用できます。  
+  
+     .NET Framework では、<xref:System.IO.Pipes.NamedPipeServerStream> と <xref:System.IO.Pipes.NamedPipeClientStream> クラスを使用して、名前付きパイプを実装します。  
+  
+     「[方法: ネットワークのプロセス間通信で名前付きパイプを使用する](../../../docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md)」を参照してください。  
+  
+## 参照  
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [方法: ローカルのプロセス間通信で匿名パイプを使用する](../../../docs/standard/io/how-to-use-anonymous-pipes-for-local-interprocess-communication.md)   
+ [方法: ネットワークのプロセス間通信で名前付きパイプを使用する](../../../docs/standard/io/how-to-use-named-pipes-for-network-interprocess-communication.md)
\ No newline at end of file
diff --git a/docs/standard/io/types-of-isolation.md b/docs/standard/io/types-of-isolation.md
new file mode 100644
index 00000000000..5cdc4deb135
--- /dev/null
+++ b/docs/standard/io/types-of-isolation.md
@@ -0,0 +1,111 @@
+---
+title: "分離のタイプ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "格納 (分離ストレージを使用したデータの)、アクセス (分離ストレージへの)"
+  - "格納 (分離ストレージを使用したデータの)、分離タイプ"
+  - "認証 [.NET Framework]、分離ストレージ"
+  - "アセンブリ [.NET Framework]、ID"
+  - "分離ストレージ、アクセス"
+  - "データ ストレージ (分離ストレージを使用した)、分離タイプ"
+  - "データ ストレージ (分離ストレージを使用した)、アクセス (分離ストレージへの)"
+  - "ドメイン ID"
+  - "分離ストレージ、タイプ"
+  - "ユーザー認証、分離ストレージ"
+ms.assetid: 14812988-473f-44ae-b75f-fd5c2f21fb7b
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# 分離のタイプ
+分離ストレージへのアクセスは、常にその分離ストレージを作成したユーザーに制限されます。  この種の分離を実装するために、共通言語ランタイムは、オペレーティング システムによって認識されるユーザー ID と同じユーザー ID、つまり、ストアを開いたときにコードを実行しているプロセスに関連付けられている ID を使用します。  この ID は認証されたユーザー ID ですが、現在のユーザーの ID は偽装によって動的に変更される場合もあります。  
+  
+ 分離ストレージへのアクセスは、アプリケーションのドメイン、アセンブリ、またはアセンブリだけに関連付けられた ID に基づいて制限されます。  ランタイムは、これらの ID を次の方法で取得します。  
+  
+-   ドメイン ID は Web アプリケーションの場合は、完全な URL である可能性があるアプリケーションの証拠を表します。  シェルによってホストされるコードの場合は、ドメイン ID は、アプリケーションのディレクトリ パスが基になります。  たとえば、実行可能ファイルをパス C:\\Office\\MyApp.exe から実行する場合、ドメイン ID は C:\\Office\\MyApp.exe です。  
+  
+-   アセンブリ ID は、アセンブリの証拠です。  アセンブリ ID は、アセンブリの暗号化デジタル署名から取得できます。アセンブリ ID は、[厳密な名前](../../../docs/framework/app-domains/strong-named-assemblies.md)、アセンブリのソフトウェア発行元、またはアセンブリの URL ID のいずれかです。  アセンブリが厳密な名前とソフトウェア発行元 ID の両方を持つ場合は、ソフトウェア発行元 ID が使用されます。  インターネットからダウンロードされ、署名されていないアセンブリの場合は、URL ID が使用されます。  アセンブリと厳密な名前の詳細については、「[アセンブリを使用したプログラミング](../../../docs/framework/app-domains/programming-with-assemblies.md)」を参照してください。  
+  
+-   ローミング ストアは、ローミング ユーザー プロファイルを持つユーザーと共に移動します。  ファイルはネットワーク ディレクトリに書き込まれ、ユーザーがログインする任意のコンピューターにダウンロードにされます。  ローミング ユーザー プロファイルの詳細については、「<xref:System.IO.IsolatedStorage.IsolatedStorageScope?displayProperty=fullName>」を参照してください。  
+  
+ ユーザー ID、ドメイン ID、およびアセンブリ ID の概念を組み合わせることにより、分離ストレージは、次の 2 とおりの方法でデータを分離できます。それぞれの分離方法には、そのアクセス権限について使用法の例があります。  
+  
+-   [ユーザーとアセンブリ別の分離](#UserAssembly)  
+  
+-   [ユーザー、ドメイン、およびアセンブリ別の分離](#UserDomainAssembly)  
+  
+ どちらかの分離にも、ローミング ユーザー プロファイルを組み合わせることができます。  詳細については、セクション [分離ストレージとローミング](#Roaming)を参照します。  
+  
+ ストアを分離する方法をさまざまなスコープで示す図を次に示します。  
+  
+ ![ユーザーとアセンブリ別の分離](../../../docs/standard/io/media/typesofisolation.gif "typesofisolation")  
+分離ストレージのタイプ  
+  
+ 特定のコンピューターに固有のストレージ機能を使用するためにコンピューター別に分離されたローミング ストアを除き、分離ストレージは暗黙的常になっていることに注意してください。  
+  
+> [!IMPORTANT]
+>  分離ストレージは [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリでは使用できません。  代わりに、[!INCLUDE[wrt](../../../includes/wrt-md.md)] API に含まれる `Windows.Storage` 名前空間内のアプリケーション データ クラスを使用して、ローカル データとローカル ファイルを格納します。  詳細については、Windows デベロッパー センターの[アプリケーション データ](http://go.microsoft.com/fwlink/?LinkId=229175)に関する説明を参照してください。  
+  
+<a name="UserAssembly"></a>   
+## ユーザーおよびアセンブリによる分離  
+ データ ストアを使用するアセンブリは、アプリケーションのドメインからアクセスできるようにする必要がある場合は、ユーザーおよびアセンブリ別の分離が適しています。  一般に、このような場面では、分離ストレージは複数のアプリケーションにまたがって適用されるデータを格納するために使用され、ユーザーの名前やライセンス情報などの特定のアプリケーションには関連付けられません。  ユーザーおよびアセンブリ別に分離されたストレージにアクセスするには、アプリケーション間で情報を転送する権限を持っている必要があります。  一般に、ユーザーおよびアセンブリ別の分離は、イントラネットでは可能ですが、インターネットでは使用できません。  静的な <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A?displayProperty=fullName> のメソッドを呼び出し、この種類の分離のユーザーおよびアセンブリ <xref:System.IO.IsolatedStorage.IsolatedStorageScope> からのストレージに渡します。  
+  
+ 次のコード例は、ユーザーおよびアセンブリ別に分離されたストアを取得します。  ストアには、`isoFile`  オブジェクトを通じてアクセスできます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#17](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source11.cpp#17)]
+ [!code-csharp[Conceptual.IsolatedStorage#17](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source11.cs#17)]
+ [!code-vb[Conceptual.IsolatedStorage#17](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source11.vb#17)]  
+  
+ 証拠パラメーターの使用例については、<xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%28System.IO.IsolatedStorage.IsolatedStorageScope%2CSystem.Security.Policy.Evidence%2CSystem.Type%2CSystem.Security.Policy.Evidence%2CSystem.Type%29>を参照してください。  
+  
+ 簡便な方法として <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetUserStoreForAssembly%2A> メソッドを使用するコード例を次に示します。  この方法は、ローミング可能なストアを開くときは使用できません。; <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のような場合に使用します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#18](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source11.cpp#18)]
+ [!code-csharp[Conceptual.IsolatedStorage#18](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source11.cs#18)]
+ [!code-vb[Conceptual.IsolatedStorage#18](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source11.vb#18)]  
+  
+<a name="UserDomainAssembly"></a>   
+## ユーザー、ドメイン、およびアセンブリによる分離  
+ アプリケーションのプライベートなデータ ストアを必要とするサードパーティのアセンブリを使用する場合は、プライベート データを格納する目的で分離ストレージを使用できます。  ユーザー、ドメイン、およびアセンブリ別の分離では、データにアクセスできるのは、所定のアセンブリのコードだけであり、またそのストアの作成時に実行中であったアプリケーションがそのストアを使用し、さらにそのストアを所有するユーザーがそのアプリケーションを実行しているときだけです。  ユーザー、ドメイン、およびアセンブリ別の分離では、サードパーティのアセンブリがほかのアプリケーションにデータをリークするのを防ぐことができます。  分離ストレージを使用する必要があり、どのタイプの分離を使用するか判断できない場合は、このタイプの分離を既定として選択してください。  <xref:System.IO.IsolatedStorage.IsolatedStorageFile> の <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> の静的なメソッドを呼び出し、ユーザー、ドメイン、およびアセンブリ <xref:System.IO.IsolatedStorage.IsolatedStorageScope> ではこの種類の分離ストレージが返されます。  
+  
+ ユーザー、ドメイン、およびアセンブリ別に分離されたストアを取得するコード例を次に示します。  ストアには、`isoFile` オブジェクトを通じてアクセスできます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#14](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source10.cpp#14)]
+ [!code-csharp[Conceptual.IsolatedStorage#14](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source10.cs#14)]
+ [!code-vb[Conceptual.IsolatedStorage#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source10.vb#14)]  
+  
+ 簡便な方法として、別のメソッドを使用するコード例を次に示します。  この方法は、ローミング可能なストアを開くときは使用できません。; <xref:System.IO.IsolatedStorage.IsolatedStorageFile.GetStore%2A> のような場合に使用します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#15](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source10.cpp#15)]
+ [!code-csharp[Conceptual.IsolatedStorage#15](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source10.cs#15)]
+ [!code-vb[Conceptual.IsolatedStorage#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source10.vb#15)]  
+  
+<a name="Roaming"></a>   
+## 分離ストレージとローミング  
+ ローミング ユーザー プロファイルはユーザーがネットワークの ID を設定し、ネットワーク コンピューターにログインするときにその ID が使用できるすべてのパーソナル化された設定に対する Windows 機能です。  分離ストレージを使用するアセンブリは、ユーザーの分離ストレージとローミング ユーザー プロファイルとともに移動するように指定できます。  ローミングは、ユーザーやアセンブリ別の分離、またはユーザー、ドメイン、およびアセンブリ別の分離と組み合わせて使用できます。  ローミング スコープが使用されていない場合は、ローミング ユーザー プロファイルを使用しても、ストアは移動しません。  
+  
+ ユーザーおよびアセンブリ別に分離されたローミング ストアを取得するコード例を次に示します。  ストアには、`isoFile`  オブジェクトを通じてアクセスできます。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#11](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source9.cpp#11)]
+ [!code-csharp[Conceptual.IsolatedStorage#11](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source9.cs#11)]
+ [!code-vb[Conceptual.IsolatedStorage#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source9.vb#11)]  
+  
+ ドメイン スコープを追加すると、ユーザー、ドメイン、およびアプリケーション別に分離されたローミング ストアを作成できます。  ドメイン スコープを追加するコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.IsolatedStorage#12](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.isolatedstorage/cpp/source9.cpp#12)]
+ [!code-csharp[Conceptual.IsolatedStorage#12](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.isolatedstorage/cs/source9.cs#12)]
+ [!code-vb[Conceptual.IsolatedStorage#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.isolatedstorage/vb/source9.vb#12)]  
+  
+## 参照  
+ <xref:System.IO.IsolatedStorage.IsolatedStorageScope>   
+ [分離ストレージ](../../../docs/standard/io/isolated-storage.md)
\ No newline at end of file
diff --git "a/docs/standard/io/\351\235\236\345\220\214\346\234\237\343\203\225\343\202\241\343\202\244\343\203\253-i-o.md" "b/docs/standard/io/\351\235\236\345\220\214\346\234\237\343\203\225\343\202\241\343\202\244\343\203\253-i-o.md"
new file mode 100644
index 00000000000..09d7adedc5e
--- /dev/null
+++ "b/docs/standard/io/\351\235\236\345\220\214\346\234\237\343\203\225\343\202\241\343\202\244\343\203\253-i-o.md"
@@ -0,0 +1,64 @@
+---
+title: "非同期ファイル I-O | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/03/2017"
+ms.prod: ".net-framework-4.6"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-bcl"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ストリーム, 同期ストリーム"
+  - "非同期 I/O"
+  - "同期 I/O"
+  - "ストリーム, 非同期ストリーム"
+  - "I/O [.NET Framework], 非同期 I/O"
+  - "ストリーム クラス, 同期 I/O"
+  - "データ ストリーム, 非同期ストリーム"
+  - "ストリーム クラス, 非同期 I/O"
+  - "複数の I/O 要求"
+  - "データ ストリーム, 同期ストリーム"
+ms.assetid: dbdd55e7-d6b9-4f9e-8abb-ab0edd4457f7
+caps.latest.revision: 23
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+---
+# 非同期ファイル I/O
+非同期操作では、メイン スレッドをブロックすることなくリソース使用量の多い I\/O 操作を実行できます。 このパフォーマンスに関する考慮事項は、時間のかかるストリーム操作によって UI スレッドがブロックされ、アプリが動作していないと見なされる可能性がある [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] アプリまたは[!INCLUDE[desktop_appname](../../../includes/desktop-appname-md.md)] アプリで特に重要です。  
+  
+ [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] 以降の I\/O 型には非同期操作を単純化する非同期メソッドが含まれています。 非同期のメソッドの名前には `Async` が含まれます \(<xref:System.IO.Stream.ReadAsync%2A>、<xref:System.IO.Stream.WriteAsync%2A>、<xref:System.IO.Stream.CopyToAsync%2A>、<xref:System.IO.Stream.FlushAsync%2A>、<xref:System.IO.TextReader.ReadLineAsync%2A>、<xref:System.IO.TextReader.ReadToEndAsync%2A> など\)。 これらの非同期のメソッドは、<xref:System.IO.Stream>、<xref:System.IO.FileStream>、<xref:System.IO.MemoryStream> などのストリーム クラスと、<xref:System.IO.TextReader>、<xref:System.IO.TextWriter> などのストリームとの間の読み取り\/書き込みに使用されるクラスに実装されます。  
+  
+ .NET Framework 4 およびそれ以前のバージョンで非同期 I\/O 操作を実装するには、<xref:System.IO.Stream.BeginRead%2A>、<xref:System.IO.Stream.EndRead%2A> などのメソッドを使用する必要があります。 これらのメソッドは、レガシ コードをサポートするために [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] でも使用できますが、非同期 I\/O 操作は非同期のメソッドを使用して実装する方が簡単です。  
+  
+ [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] 以降、Visual Studio には非同期プログラミング向けの 2 つのキーワードが用意されています。  
+  
+-   `Async` \(Visual Basic\) 修飾子または `async` \(C\#\) 修飾子。非同期操作を含むメソッドをマークするために使用されます。  
+  
+-   `Await` \(Visual Basic\) 演算子または `await` \(C\#\) 演算子。非同期のメソッドの結果に適用されます。  
+  
+ 非同期 I\/O 操作を実装するには、これらのキーワードを非同期のメソッドと組み合わせて使用します。次に例を示します。 詳細については、「[Async および Await を使用した非同期プログラミング](../Topic/Asynchronous%20Programming%20with%20Async%20and%20Await%20\(C%23%20and%20Visual%20Basic\).md)」を参照してください。  
+  
+ 次の例では、2 つの <xref:System.IO.FileStream> オブジェクトを使用して、ファイルをディレクトリ間で非同期にコピーする方法を示します。 非同期のメソッドを呼び出すので、<xref:System.Web.UI.WebControls.Button.Click> コントロールの <xref:System.Windows.Controls.Button> イベント ハンドラーは `async` 修飾子でマークされていることに注意してください。  
+  
+ [!code-csharp[Asynchronous_File_IO_async#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Asynchronous_File_IO_async/cs/example.cs#1)]
+ [!code-vb[Asynchronous_File_IO_async#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example.vb#1)]  
+  
+ 次の例は前述の例と似ていますが、<xref:System.IO.StreamReader> オブジェクトと <xref:System.IO.StreamWriter> オブジェクトを使用して、テキスト ファイルの内容の読み取り\/書き込みを非同期で行います。  
+  
+ [!code-csharp[Asynchronous_File_IO_async#2](../../../samples/snippets/csharp/VS_Snippets_CLR/Asynchronous_File_IO_async/cs/example2.cs#2)]
+ [!code-vb[Asynchronous_File_IO_async#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example2.vb#2)]  
+  
+ 次の例では、分離コード ファイルと XAML ファイルを使用して <xref:System.IO.Stream> アプリでファイルを [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] として開き、<xref:System.IO.StreamReader> クラスのインスタンスを使用してその内容を読み取る方法を示します。 ここでは、非同期のメソッドを使用して、ファイルをストリームとして開き、ファイルの内容を読み取ります。  
+  
+ [!code-csharp[System.IO.WindowsRuntimeStorageExtensions#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestorageextensions/cs/blankpage.xaml.cs#2)]
+ [!code-vb[System.IO.WindowsRuntimeStorageExtensions#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.io.windowsruntimestorageextensions/vb/blankpage.xaml.vb#2)]  
+  
+ [!code-xml[System.IO.WindowsRuntimeStorageExtensions#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.io.windowsruntimestorageextensions/cs/blankpage.xaml#1)]  
+  
+## 参照  
+ <xref:System.IO.Stream>   
+ [ファイルおよびストリーム入出力](../../../docs/standard/io/index.md)   
+ [Async および Await を使用した非同期プログラミング](../Topic/Asynchronous%20Programming%20with%20Async%20and%20Await%20\(C%23%20and%20Visual%20Basic\).md)
\ No newline at end of file
diff --git a/docs/standard/language-independence-and-language-independent-components.md b/docs/standard/language-independence-and-language-independent-components.md
new file mode 100644
index 00000000000..465bb099119
--- /dev/null
+++ b/docs/standard/language-independence-and-language-independent-components.md
@@ -0,0 +1,590 @@
+---
+title: "言語への非依存性、および言語非依存コンポーネント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "CLS"
+  - "共通言語ランタイム, 言語の相互運用性"
+  - "共通言語仕様"
+  - "言語間の相互運用性"
+  - "言語の相互運用性"
+  - "ランタイム, 言語の相互運用性"
+ms.assetid: 4f0b77d0-4844-464f-af73-6e06bedeafc6
+caps.latest.revision: 35
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 33
+---
+# 言語への非依存性、および言語非依存コンポーネント
+.NET Framework は言語に依存しません。  つまり、C\+\+\/CLI、Eiffel、F\#、IronPython、IronRuby、PowerBuilder、Visual Basic、Visual COBOL、Windows PowerShell など、.NET Framework を対象とする多くの言語の 1 つを開発に使用できます。  .NET Framework 用に開発されたクラス ライブラリの型とメンバーには、最初に記述された言語を知らなくてもアクセスできます。元の言語の規則に従う必要もありません。  コンポーネントを開発しているのであれば、コンポーネントの言語にかかわらず、すべての .NET Framework アプリからそのコンポーネントにアクセスできます。  
+  
+> [!NOTE]
+>  この記事の最初の部分では、言語に依存しないコンポーネント、つまり、どの言語で記述されたアプリからでも使用できるコンポーネントの作成について説明します。  また、複数の言語で記述されたソース コードから 1 つのコンポーネントまたはアプリを作成することもできます。この記事の 2 番目のパートにある「[言語間の相互運用性](#CrossLang)」を参照してください。  
+  
+ 任意の言語で記述された他のオブジェクトと完全に対話するには、すべての言語に共通の機能だけを呼び出し側に公開するようにオブジェクトを実装する必要があります。  この共通の機能セットは、生成されたアセンブリに適用される規則のセットである、共通言語仕様 \(CLS: Common Language Specification\) によって定義されます。  共通言語仕様は、「[Standard ECMA\-335: Common Language Infrastructure \(標準の ECMA\-335: 共通言語基盤\)](http://go.microsoft.com/fwlink/?LinkID=116487)」の第 1 部の第 7 ～ 11 項で定義されています。  
+  
+ コンポーネントが共通言語仕様に準拠している場合は、CLS に準拠することが保証され、CLS をサポートするすべてのプログラミング言語で記述されたアセンブリのコードからアクセスできます。  コンパイル時にコンポーネントが共通言語仕様に準拠しているかどうかを確認するには、<xref:System.CLSCompliantAttribute> 属性をソース コードに適用します。  詳細については、「[CLSCompliantAttribute 属性](#CLSAttribute)」を参照してください。  
+  
+ この記事の内容:  
+  
+-   [CLS 準拠の規則](#Rules)  
+  
+    -   [型および型メンバーのシグネチャ](#Types)  
+  
+    -   [名前付け規則](#naming)  
+  
+    -   [型変換](#conversion)  
+  
+    -   [配列](#arrays)  
+  
+    -   [インターフェイス](#Interfaces)  
+  
+    -   [列挙](#enums)  
+  
+    -   [一般的な型メンバー](#members)  
+  
+    -   [メンバーのアクセシビリティ](#MemberAccess)  
+  
+    -   [ジェネリック型とメンバー](#Generics)  
+  
+    -   [コンストラクター](#ctors)  
+  
+    -   [プロパティ](#properties)  
+  
+    -   [イベント](#events)  
+  
+    -   [Overloads](#overloads)  
+  
+    -   [例外](#exceptions)  
+  
+    -   [属性](#attributes)  
+  
+-   [CLSCompliantAttribute 属性](#CLSAttribute)  
+  
+-   [言語間の相互運用性](#CrossLang)  
+  
+<a name="Rules"></a>   
+## CLS 準拠の規則  
+ ここでは、CLS に準拠したコンポーネントを作成するための規則について説明します。  規則の一覧については、「[Standard ECMA\-335: Common Language Infrastructure \(標準の ECMA\-335: 共通言語基盤\)](http://go.microsoft.com/fwlink/?LinkID=116487)」の第 1 部の第 11 項を参照してください。  
+  
+> [!NOTE]
+>  共通言語仕様では、コンシューマー \(プログラムによって CLS 準拠のコンポーネントにアクセスする開発者\)、フレームワーク \(言語コンパイラを使用して CLS 準拠のライブラリを作成する開発者\)、およびエクステンダー \(CLS 準拠のコンポーネントを作成する言語コンパイラ、コード パーサーなどのツールを作成する開発者\) に適用する、CLS 準拠の各規則について説明します。  ここでは、フレームワークに適用するときの規則に焦点を当てます。  エクステンダーに適用する一部の規則は、Reflection.Emit を使用して作成されたアセンブリに適用されることもあります。  
+  
+ 言語に依存しないコンポーネントをデザインするには、コンポーネントのパブリック インターフェイスに CLS 準拠の規則を適用するだけです。  プライベートな実装は仕様に準拠する必要はありません。  
+  
+> [!IMPORTANT]
+>  CLS 準拠の規則は、コンポーネントのパブリック インターフェイスにのみ適用されます。プライベート実装には適用されません。  
+  
+ たとえば、<xref:System.Byte> 以外の符号なし整数は CLS に準拠していません。  次の例の `Person` クラスは型 `Age` の <xref:System.UInt16> プロパティを公開するので、次のコードではコンパイラの警告が表示されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#1](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/public1.cs#1)]
+ [!code-vb[Conceptual.CLSCompliant#1](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/public1.vb#1)]  
+  
+ `Person` クラスを CLS 準拠にするには、`Age` プロパティの型を <xref:System.UInt16> から、CLS 準拠の 16 ビット符号付き整数である <xref:System.> Int16?qualifyHint=False&autoUpgrade=True に変更します。  プライベート `personAge` フィールドの型を変更する必要はありません。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#2](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/public2.cs#2)]
+ [!code-vb[Conceptual.CLSCompliant#2](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/public2.vb#2)]  
+  
+ ライブラリのパブリック インターフェイスは、次の要素で構成されます。  
+  
+-   パブリック クラスの定義。  
+  
+-   パブリック クラスのパブリック メンバーの定義、および派生クラスからアクセスできるメンバー \(つまり、protected メンバー\) の定義。  
+  
+-   パブリック クラスのパブリック メソッドのパラメーターおよび戻り値の型、派生クラスからアクセスできるメソッドのパラメーターおよび戻り値の型。  
+  
+ CLS 準拠の規則を次の表に示します。  この規則は、「[Standard ECMA\-335: Common Language Infrastructure \(標準の ECMA\-335: 共通言語基盤\)](http://go.microsoft.com/fwlink/?LinkID=116487)」\(Copyright 2012: Ecma International\) からの引用です。  これらの規則の詳細については、以降のセクションを参照してください。  
+  
+|カテゴリ|参照トピック|ルール|規則番号|  
+|----------|------------|---------|----------|  
+|ユーザー補助|[メンバーのアクセシビリティ](#MemberAccess)|継承されたメソッドをオーバーライドする場合、アクセシビリティは変更してはいけない。ただし、別のアセンブリから継承されたメソッドをアクセシビリティ `family-or-assembly` でオーバーライドする場合は除く。  この場合、アクセシビリティは `family` にすること。|10|  
+|ユーザー補助|[メンバーのアクセシビリティ](#MemberAccess)|型およびメンバーの可視性およびアクセシビリティについて、メンバーのシグネチャに指定されている型は、そのメンバーが可視でアクセス可能な場合、必ず可視でアクセス可能でなければいけない。  たとえば、アセンブリ外部から参照できるパブリックなメソッドには、アセンブリ内部でだけ可視である型が引数として含まれていてはいけない。  メンバーのシグネチャに使用されているジェネリック型のインスタンスを構成する型の可視性およびアクセシビリティは、メンバーが可視でアクセス可能の場合、必ず可視でアクセス可能でなければいけない。  たとえば、アセンブリ外部から参照できるメンバーのシグネチャに指定されているジェネリック型のインスタンスに、アセンブリ内部でだけ可視である型の汎用引数が含まれていてはいけない。|12|  
+|配列|[配列](#arrays)|配列は、要素が CLS 準拠型で、すべての次元でインデックス番号が 0 から始まらなければならない。  項目が配列の場合、オーバーロードどうしを区別するには配列要素の型を必要とする。  オーバーロードが 2 つ以上の配列型に基づく場合、要素型は名前付きの型でなければいけない。|16|  
+|属性|[属性](#attributes)|属性の型 <xref:System.Attribute?displayProperty=fullName>、またはそれを継承する型である。|41|  
+|属性|[属性](#attributes)|CLS ではカスタム属性のエンコーディングのサブセットのみ使用できる。  これらのエンコーディングに表示される型 \(第 4 部を参照\) は、<xref:System.Type?displayProperty=fullName>、<xref:System.String?displayProperty=fullName>、<xref:System.Char?displayProperty=fullName>、<xref:System.Boolean?displayProperty=fullName>、<xref:System.Byte?displayProperty=fullName>、<xref:System.Int16?displayProperty=fullName>、<xref:System.Int32?displayProperty=fullName>、<xref:System.Int64?displayProperty=fullName>、<xref:System.Single?displayProperty=fullName>、<xref:System.Double?displayProperty=fullName>、CLS 準拠の基底の整数型に基づく列挙型のみである。|34|  
+|属性|[属性](#attributes)|CLS では、公開参照される必須の修飾子 \(`modreq`、第 2 部を参照\) は使用できない。ただし、認識しないオプションの修飾子 \(`modopt`、第 2 部を参照\) は使用できる。|35|  
+|コンストラクター|[コンストラクター](#ctors)|オブジェクト コンストラクターでは、継承しているインスタンス データへのアクセスが発生する前に、基底クラスのインスタンス コンストラクターを呼び出さなければいけない  \(コンストラクターが不要である値型は除く\)。|21|  
+|コンストラクター|[コンストラクター](#ctors)|オブジェクト コンストラクターがオブジェクトの作成時以外で呼び出されてはならず、またオブジェクトが 2 度初期化されてもいけない。|22|  
+|列挙|[列挙](#enums)|enum の基になる型は組み込みの CLS 整数型、フィールド名は "value\_\_" であり、そのフィールドには `RTSpecialName` のマークが付けられる。|7|  
+|列挙|[列挙](#enums)|enum には 2 種類あり、<xref:System.FlagsAttribute?displayProperty=fullName> カスタム属性 \(第 4 部のライブラリを参照\) の有無で区別する。  片方は名前付き整数値を表し、もう片方は名前付きビット フラグを表す。名前付きビット フラグは、それを組み合わせて名前のない値を生成できる。  `enum` の値は、指定した値に限定されない。|9|  
+|列挙|[列挙](#enums)|enum のリテラルな静的フィールドの型は、その enum 自体の型である。|9|  
+|イベント|[イベント](#events)|イベントを実装するメソッドは、メタデータ内で `SpecialName` のマークが付けられる。|29|  
+|イベント|[イベント](#events)|イベントとイベントのアクセサーのアクセシビリティは同一である。|30|  
+|イベント|[イベント](#events)|イベントの `add` メソッドおよび `remove` メソッドは、どちらもあってもなくてもよい。|31|  
+|イベント|[イベント](#events)|`add` メソッドおよび `remove` メソッドは、それぞれパラメーターを 1 つ使用する。このパラメーターの型がイベントの型を規定する。また、パラメーターの型は <xref:System.Delegate?displayProperty=fullName> の派生でなければいけない。|32|  
+|イベント|[イベント](#events)|イベントは、特定の名前付けパターンに従わなくてはいけない。  CLS 規則 29 で触れられている `SpecialName` 属性は、適切な名前比較で無視され、識別子規則に従わなければいけない。|33|  
+|例外|[例外](#exceptions)|スローできるオブジェクト型は、<xref:System.Exception?displayProperty=fullName>、またはそれを継承する型である。  ただし、CLS 準拠のメソッドで他の型の例外のスローをブロックする必要はない。|40|  
+|全般|[CLS 準拠: 規則](#Rules)|CLS 規則は、型の構成部分のうち、その型を定義しているアセンブリの外部からアクセスまたは参照できる部分にのみ適用される。|1|  
+|全般|[CLS 準拠: 規則](#Rules)|CLS 非準拠型のメンバーを CLS 準拠と指定しない。|2|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|入れ子になった型は、少なくともその外側の型と同じ数のジェネリック パラメーターを持つ。  入れ子にされた型のジェネリック パラメーターは、それを囲む型のジェネリック パラメーターと、位置によって対応します。|42|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|ジェネリック型の名前は、入れ子にされない型で宣言される型パラメーターの数をエンコードする必要がある。入れ子にされる場合は、上記の規則に従って、型に新しく組み込まれる型パラメーターの数をエンコードする必要がある。|43|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|ジェネリック型は必要な制約を再宣言して、基本型またはインターフェイスの制約がジェネリック型の制約で確実に満たされるようにする必要がある。|4444|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|ジェネリック パラメーターの制約として使用される型は CLS に準拠する必要がある。|45|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|インスタンス化されたジェネリック型のメンバー \(入れ子になった型も含む\) の可視性およびアクセシビリティは、ジェネリック型の全体の宣言ではなく、特定のインスタンス化に対してスコープが設定される必要がある。  この場合でも、CLS 規則 12 の可視性規則とアクセシビリティ規則は同様に適用される。|46|  
+|ジェネリック|[ジェネリック型とメンバー](#Generics)|抽象メソッドまたは仮想ジェネリック メソッドごとに、既定の具体的な実装がある。|47|  
+|インターフェイス|[インターフェイス](#interfaces)|CLS 準拠のインターフェイスでは、CLS に準拠しないメソッドを実装するために、これらを定義する必要はない。|18|  
+|インターフェイス|[インターフェイス](#interfaces)|CLS 準拠インターフェイスでは、静的メソッドを定義してはいけない。また、フィールドも定義してはいけない。|19|  
+|メンバー|[一般的な型メンバー](#members)|グローバルで静的な \(static\) フィールドとメソッドは CLS 準拠ではありません。|36|  
+|メンバー|\-\-|静的リテラル値の指定には、フィールド初期化メタデータを使用する。  CLS 準拠のリテラルには、そのリテラルと同じ型 \(または、そのリテラルが `enum` の場合は基本型\) の値がフィールド初期化メタデータに指定されている必要がある。|13|  
+|メンバー|[一般的な型メンバー](#members)|vararg 制約は CLS の一部ではなく、CLS でサポートする呼び出し規約だけが標準のマネージ呼び出し規約である。|15|  
+|名前付け規則|[名前付け規則](#naming)|アセンブリは、識別子の頭文字および構成文字として使用できる文字セットを規定する Unicode Standard 3.0 の『Technical Report 15』の「Annex 7」に従う必要がある。詳細については、http:\/\/www.unicode.org\/unicode\/reports\/tr15\/tr15\-18.html を参照。  識別子は、Unicode 正規形 C に定義されている標準形式で記述する必要がある。  CLS で 2 つの識別子が同じと見なされるのは、小文字マッピング \(Unicode のロケール非依存で 1 対 1 の小文字による対応付け\) が同じ場合である。  つまり、CLS で 2 つの識別子が異なる場合、大文字小文字の違いだけではない。  ただし、継承された定義をオーバーライドする場合、CLI では元の宣言と厳密に同じエンコーディングの使用が求められる。|4|  
+|オーバーロード|[名前付け規則](#naming)|CLS 準拠のスコープに導入されるすべての名前は、完全に独立した種類でなければいけない。ただし、名前が同じでオーバーロードによって解決できる場合を除く。  CTS では 1 つの型でメソッドとフィールドとに同じ名前を使用できるが、CLS では使用できない。|5|  
+|オーバーロード|[名前付け規則](#naming)|フィールドおよび入れ子になった型について、CTS ではシグネチャでの区別が可能だが、CLS では識別子の比較だけで区別できる必要がある。  CLS 規則 39 の指定を除き、識別子の比較により名前が同じであるメソッド、プロパティ、およびイベントでは、相違点は戻り値の型だけに限定されない。|6|  
+|オーバーロード|[Overloads](#overloads)|プロパティおよびメソッドのみオーバーロードできる。|37|  
+|オーバーロード|[Overloads](#overloads)|プロパティおよびメソッドは、パラメーターの数値と型にのみ基づいてオーバーロードできる。ただし、戻り値の型に基づいてオーバーロードできる変換演算子の `op_Implicit` と o`op_Explicit` は例外である。|38|  
+|オーバーロード|\-\-|型で宣言された複数の CLS 準拠のメソッドに同じ名前が指定されている場合、特定の一連の型のインスタンス化において、これらのメソッドのパラメーターと戻り値の型は同じである。また、これらの型のインスタンス化で、すべてのメソッドをセマンティクス レベルで等価にする必要がある。|48|  
+|型|[型および型メンバーのシグネチャ](#Types)|<xref:System.Object?displayProperty=fullName> は CLS 準拠である。  これ以外のあらゆる CLS 準拠クラスは CLS 準拠クラスの継承でなければならない。|23|  
+|プロパティ|[プロパティ](#properties)|プロパティの getter メソッドおよび setter メソッドを実装するメソッドは、メタデータで `SpecialName` とマークする。|24|  
+|プロパティ|[プロパティ](#properties)|プロパティ アクセサーはすべて静的、すべて仮想、またはすべてインスタンスになる。|26|  
+|プロパティ|[プロパティ](#properties)|プロパティの型は、getter の戻り値の型であり、かつ setter の最後の引数の型でなければいけない。  プロパティのパラメーターの型は、getter へのパラメーターの型であり、かつ setter の最後のパラメーター以外のすべての型でなければいけない。  すべての型は CLS 準拠でなければならない。また、マネージ ポインターであってはいけない。つまり、参照渡しではいけない。|27|  
+|プロパティ|[プロパティ](#properties)|プロパティは、特定の名前付けパターンに従わなくてはいけない。  CLS 規則 24 で触れられている `SpecialName` 属性は、適切な名前比較で無視され、識別子規則に従わなければいけない。  プロパティには getter メソッド、setter メソッド、またはこの両方が必ずなければいけない。|28|  
+|型変換|[型変換](#conversion)|`op_Implicit` または `op_Explicit` が指定されている場合は、強制変換のための別の方法を用意する必要がある。|39|  
+|型|[型および型メンバーのシグネチャ](#Types)|ボックス化された値型は CLS 準拠ではない。|3|  
+|型|[型および型メンバーのシグネチャ](#Types)|シグネチャに出現するすべての型は CLS 準拠でなければいけない。  ジェネリック型のインスタンスを構成するすべての型は CLS 準拠でなければいけない。|11|  
+|型|[型および型メンバーのシグネチャ](#Types)|型指定された参照は CLS 準拠ではありません。|14|  
+|型|[型および型メンバーのシグネチャ](#Types)|アンマネージ ポインター型は CLS 準拠ではない。|17|  
+|型|[型および型メンバーのシグネチャ](#Types)|CLS 準拠のクラス、値型、およびインターフェイスでは、CLS に準拠しないメンバーの実装は不要である。|20|  
+  
+<a name="Types"></a>   
+### 型および型メンバーのシグネチャ  
+ <xref:System.Object?displayProperty=fullName> 型は CLS に準拠しており、.NET Framework 型システムのすべてのオブジェクト型の基本型です。  .NET Framework の継承は暗黙的また明示的に行われます。たとえば、<xref:System.String> クラスは <xref:System.Object> クラスから暗黙的に継承します。また、<xref:System.Globalization.CultureNotFoundException> クラスは、<xref:System.ArgumentException> クラスから明示的に継承し、これは <xref:System.SystemException> クラスから明示的に継承します。そして、このクラスは <xref:System.Exception> クラスから明示的に継承します。  派生型を CLS 準拠にするには、その基本型も CLS に準拠している必要があります。  
+  
+ 次の例は、基本型が CLS に準拠していない派生型を示しています。  これは、符号なし 32 ビット整数をカウンターとして使用する `Counter` 基底クラスを定義します。  クラスには、符号なし整数をラップすることでカウンター機能が用意されます。このため、クラスは CLS 非準拠としてマークされます。  結果として、派生クラス `NonZeroCounter` も CLS に準拠しなくなります。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#12](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/type3.cs#12)]
+ [!code-vb[Conceptual.CLSCompliant#12](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/type3.vb#12)]  
+  
+ メソッドの戻り値の型、プロパティ型を含め、メンバー シグネチャに表示されるすべての型が CLS に準拠する必要があります。  さらに、ジェネリック型の場合は、次の要件もあります。  
+  
+-   ジェネリック型のインスタンスを構成するすべての型が、CLS に準拠する必要があります。  
+  
+-   ジェネリック パラメーターで制約として使用されるすべての型が、CLS に準拠する必要があります。  
+  
+ .NET Framework の[共通型システム](../../docs/standard/base-types/common-type-system.md)には、共通言語ランタイムが直接サポートする組み込み型がいくつか含まれ、アセンブリのメタデータで特別にエンコードされています。  これらの組み込み型のうち、次の表に示す型は CLS に準拠しています。  
+  
+|CLS 準拠型|説明|  
+|-------------|--------|  
+|<xref:System.Byte>|8 ビット符号なし整数|  
+|<xref:System.Int16>|16 ビット符号付き整数|  
+|<xref:System.Int32>|32 ビット符号付き整数|  
+|<xref:System.Int64>|64 ビット符号付き整数|  
+|<xref:System.Single>|単精度浮動小数点数値|  
+|<xref:System.Double>|倍精度浮動小数点数値|  
+|<xref:System.Boolean>|`true` or `false` 値型|  
+|<xref:System.Char>|UTF\-16 でエンコードされたコード単位|  
+|<xref:System.Decimal>|10 進浮動小数点数以外|  
+|<xref:System.IntPtr>|プラットフォーム定義サイズのポインターまたはハンドル|  
+|<xref:System.String>|0 個以上の <xref:System.Char> オブジェクトのコレクション|  
+  
+ 次の表に示す組み込み型は CLS に準拠していません。  
+  
+|非準拠型|説明|CLS に準拠する代替|  
+|----------|--------|-----------------|  
+|<xref:System.SByte>|8 ビット符号付き整数データ型|<xref:System.Int16>|  
+|<xref:System.TypedReference>|オブジェクトとそのランタイム型へのポインター|なし|  
+|<xref:System.UInt16>|16 ビット符号なし整数|<xref:System.Int32>|  
+|<xref:System.UInt32>|32 ビット符号なし整数|<xref:System.Int64>|  
+|<xref:System.UInt64>|64 ビット符号なし整数|<xref:System.Int64> \(オーバーフローの可能性あり\)、<xref:System.Numerics.BigInteger>、または <xref:System.Double>|  
+|<xref:System.UIntPtr>|符号なしポインターまたはハンドル|<xref:System.IntPtr>|  
+  
+ .NET Framework のクラス ライブラリまたはその他のクラス ライブラリには、CLS に準拠していない他の型が含まれる場合があります。次に例を示します。  
+  
+-   ボックス化された値型。  次の C\# コード例では、`int*` という名前の型 `Value` のパブリック プロパティを持つクラスを作成します。  `int*` はボックス化された値型であるため、コンパイラは CLS 非準拠としてフラグを設定します。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#26](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/box2.cs#26)]  
+  
+-   型指定された参照。オブジェクトへの参照および型への参照を含む特別なコンストラクトです。  型指定された参照は、.NET Framework では <xref:System.TypedReference> クラスによって表されます。  
+  
+ 型が CLS に準拠していない場合は、<xref:System.CLSCompliantAttribute> 値が `isCompliant` に指定された `false` 属性を適用する必要があります。  詳細については、「[CLSCompliantAttribute 属性](#CLSAttribute)」を参照してください。  
+  
+ 次の例は、メソッド シグネチャとジェネリック型のインスタンス化で発生する CLS 準拠の問題を示しています。  ここでは、`InvoiceItem` クラスを、型 <xref:System.UInt32> のプロパティ、型 `Nullable(Of UInt32)` のプロパティ、および型 <xref:System.UInt32> と `Nullable(Of UInt32)` のパラメーターが指定されたコンストラクターで定義します。  この例をコンパイルしようとすると、4 つのコンパイラの警告が表示されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#3](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/type1.cs#3)]
+ [!code-vb[Conceptual.CLSCompliant#3](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/type1.vb#3)]  
+  
+ コンパイラの警告が表示されないようにするには、`InvoiceItem` パブリック インターフェイスの CLS 非準拠型を準拠型に置き換えます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#4](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/type2.cs#4)]
+ [!code-vb[Conceptual.CLSCompliant#4](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/type2.vb#4)]  
+  
+ ここで示した特定の型以外にも、CLS に準拠していないカテゴリはいくつかあります。  たとえば、アンマネージ ポインター型やアンマネージ関数ポインター型などです。  次の例では、整数へのポインターを使用して整数の配列を作成するので、コンパイラの警告が生成されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#5](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/unmanagedptr1.cs#5)]  
+  
+ CLS 準拠の抽象クラス \(つまり、`abstract` \(C\# の場合\) または `MustInherit` \(Visual Basic の場合\) とマークされたクラス\) については、そのクラスのすべてのメンバーも CLS に準拠にする必要があります。  
+  
+<a name="naming"></a>   
+### 名前付け規則  
+ 一部のプログラミング言語は大文字と小文字が区別されるので、識別子 \(名前空間、型、メンバーの名前など\) は、大文字と小文字が違うだけで相違します。  2 つの識別子が同じと見なされるのは、小文字マッピングが同じ場合です。  次の C\# コード例では、2 つのパブリック クラス、`Person` および `person` を定義します。  このクラスは大文字と小文字のみが異なるので、コンパイラは CLS 非準拠としてフラグを設定します。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#16](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/naming1.cs#16)]  
+  
+ 名前空間、型、メンバーの名前など、プログラミング言語の識別子は[Unicode Standard 3.0 の Technical Report 15 の Annex 7](http://www.unicode.org/reports/tr15/tr15-18.html) に準拠する必要があります。  これによって、次のことが起こります。  
+  
+-   識別子の最初の文字は Unicode の大文字と小文字、大文字と小文字の組み合わせ、修飾子文字、その他の文字、または文字数の番号を指定できます。  Unicode 文字のカテゴリの詳細については、「<xref:System.Globalization.UnicodeCategory?displayProperty=fullName> 列挙体」を参照してください。  
+  
+-   2 文字目以降には、最初の文字で使用できる文字のほかに、非空白記号、空白結合記号、10 進数、接続符号、書式指定コードを使用できます。  
+  
+ 識別子を比較する場合は、その前に書式設定コードを除外してから、識別子を Unicode 正規形 C に変換する必要があります。これは 1 つの文字を、UTF\-16 でエンコードされた複数のコード単位で表すことができるからです。  同じコード単位を Unicode 正規形 C で生成する文字シーケンスは CLS に準拠していません。  次の例では、最初にオングストローム文字 \(U\+212B\) である `Å` という名前のプロパティを定義し、次に、上に丸が付く LATIN の大文字 A \(U\+00C5\) である `Å` という名前のプロパティを定義します。  C\# と Visual Basic の両方のコンパイラが、CLS 非準拠としてソース コードにフラグを設定します。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#17](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/naming1.cs#17)]
+ [!code-vb[Conceptual.CLSCompliant#17](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/naming1.vb#17)]  
+  
+ 特定のスコープ内のメンバー名 \(アセンブリ内の名前空間、名前空間内の型、型内のメンバーなど\) は一意である必要があります。ただし、オーバーロードによって解決される名前は除きます。  この要件は、共通型システムの要件よりも厳格です。共通型システムでは、スコープ内のメンバーは種類が異なっていれば、たとえば、種類がメソッドのメンバーとフィールドのメンバーは、同じ名前を持つことができます。  特に、型メンバーの場合は次の要件もあります。  
+  
+-   フィールドと入れ子になった型は名前でのみ識別されます。  
+  
+-   名前が同じメソッド、プロパティ、およびイベントは、戻り値の型以外で区別できるようにする必要があります。  
+  
+ 次の例は、メンバー名がスコープ内で一意でなければならない要件を示しています。  ここでは、`Converter` という名前の 4 つのメンバーを含む `Conversion` という名前のクラスを定義します。  3 つがメソッドで、1 つはプロパティです。  <xref:System.Int64> パラメーターを含むメソッドには一意の名前が付けられますが、<xref:System.Int32> パラメーターが指定された 2 つのメソッドには一意の名前は付けられません。これは戻り値がメンバーのシグネチャの一部と見なされないからです。  また、`Conversion` プロパティもこの要件に違反しています。プロパティの名前は、オーバーロードされたメソッドと同じにできないからです。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#19](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/naming3.cs#19)]
+ [!code-vb[Conceptual.CLSCompliant#19](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/naming3.vb#19)]  
+  
+ 個々の言語に一意のキーワードが含まれるので、共通言語ランタイムを対象にする言語も、キーワードと一致する識別子 \(型名など\) を参照するための機構を用意する必要があります。  たとえば、`case` は、C\# と Visual Basic のキーワードです。  ただし、次の Visual Basic コード例では、左右の中かっこを使用して、`case` キーワードと `case` という名前のクラスを明確に区別できます。  それ以外の場合は、エラー メッセージ "キーワードは、識別子として有効ではありません" が表示され、コンパイルできません。  
+  
+ [!code-vb[Conceptual.CLSCompliant#22](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/keyword1.vb#22)]  
+  
+ 次の C\# コード例では、`case` シンボルを使用して `@` クラスをインスタンス化することで、識別子と言語キーワードを区別できます。  これがないと、C\# コンパイラによって 2 つのエラー メッセージ "型が必要です" および "'case' は無効です" が表示されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#23](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/keyword2.cs#23)]  
+  
+<a name="conversion"></a>   
+### 型変換  
+ 共通言語仕様では、次の 2 つの変換演算子が定義されます。  
+  
+-   `op_Implicit`。データまたは精度の損失につながらない拡大変換に使用されます。  たとえば、<xref:System.Decimal> 構造体には、整数型の値と `op_Implicit` 値を <xref:System.Char> 値に変換できるように、オーバーロードされた <xref:System.Decimal> 演算子が含まれます。  
+  
+-   `op_Explicit`。絶対値 \(狭い範囲の値に変換される値\) または精度の損失につながる可能性がある縮小変換に使用されます。  たとえば、<xref:System.Decimal> 構造体には、`op_Explicit` 値と <xref:System.Double> 値を <xref:System.Single> に変換し、<xref:System.Decimal> 値を整数値、<xref:System.Decimal>、<xref:System.Double>、および <xref:System.Single> に変換できるように、オーバーロードされた <xref:System.Char> 演算子が含まれます。  
+  
+ ただし、すべての言語で、演算子のオーバーロードまたはカスタム演算子の定義がサポートされているわけではありません。  これらの変換演算子を実装する場合は、他の方法で変換を実行する方法も用意する必要があります。  ここでは、`From`*Xxx* メソッドおよび `To`*Xxx* メソッドを用意することをお勧めします。  
+  
+ 次の例では、CLS に準拠する暗黙的な変換と明示的な変換を定義します。  ここでは、符号付き倍精度浮動小数点数を表す `UDouble` クラスを作成します。  暗黙的な変換については、`UDouble` から <xref:System.Double>、明示的な変換については、`UDouble` から <xref:System.Single>、<xref:System.Double> から `UDouble`、および <xref:System.Single> から `UDouble` への例を示しています。  また、暗黙的な変換演算子の代替として `ToDouble` メソッドを、明示的な変換演算子の代替として `ToSingle`、`FromDouble`、`FromSingle` の各メソッドを定義します。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#15](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/convert1.cs#15)]
+ [!code-vb[Conceptual.CLSCompliant#15](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/convert1.vb#15)]  
+  
+<a name="arrays"></a>   
+### 配列  
+ CLS 準拠の配列は、次の規則に従います。  
+  
+-   配列の次元の下限値は 0 にする必要があります。  次の例では、下限が 1 の CLS 非準拠の配列を作成します。  <xref:System.CLSCompliantAttribute> 属性の有無に関係なく、コンパイラでは、`Numbers.GetTenPrimes` メソッドによって返される配列が CLS に準拠していないことは検出されません。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#8](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/array1.cs#8)]
+     [!code-vb[Conceptual.CLSCompliant#8](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/array1.vb#8)]  
+  
+-   すべての配列の要素が、CLS 準拠の型で構成されている必要があります。  次の例では、CLS 非準拠の配列を返す 2 つのメソッドを定義します。  最初のメソッドは、<xref:System.UInt32> 値の配列を返します。  2 番目のメソッドは <xref:System.Object> 値と <xref:System.Int32> 値を含む <xref:System.UInt32> 配列を返します。  最初の配列は <xref:System.UInt32> 型であるため、コンパイラによって非準拠として識別されますが、2 番目の配列に CLS 非準拠の要素が含まれていることは認識されません。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#9](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/array2.cs#9)]
+     [!code-vb[Conceptual.CLSCompliant#9](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/array2.vb#9)]  
+  
+-   配列パラメーターを持つメソッドのオーバーロードの解決は、配列であるという事実とその要素型に基づきます。  したがって、次のオーバーロードされた `GetSquares` メソッドの定義は CLS に準拠しています。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#10](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/array3.cs#10)]
+     [!code-vb[Conceptual.CLSCompliant#10](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/array3.vb#10)]  
+  
+<a name="Interfaces"></a>   
+### インターフェイス  
+ CLS 準拠のインターフェイスでは、プロパティ、イベント、および仮想メソッド \(実装のないメソッド\) を定義できます。  次の項目は、このインターフェイスには指定できません。  
+  
+-   静的メソッドまたは静的フィールド。  インターフェイスで静的メンバーを定義すると、C\# と Visual Basic の両方のコンパイラでコンパイラ エラーが発生します。  
+  
+-   フィールド。  インターフェイスでフィールドを定義すると、C\# と Visual Basic の両方のコンパイラでコンパイラ エラーが発生します。  
+  
+-   CLS に準拠していないメソッド。  たとえば、次のインターフェイス定義には、CLS 非準拠とマークされているメソッド、`INumber.GetUnsigned` が含まれています。  この例では、コンパイラの警告が生成されます。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#6](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/interface2.cs#6)]
+     [!code-vb[Conceptual.CLSCompliant#6](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/interface2.vb#6)]  
+  
+     この規則のため、CLS に準拠している型は、CLS に準拠していないメンバーを実装する必要はありません。  CLS 準拠のフレームワークによって、CLS に非準拠のインターフェイスを実装するクラスが公開されている場合、そのフレームワークには、CLS 非準拠のすべてのメンバーの具象実装も用意する必要があります。  
+  
+ CLS 準拠の言語コンパイラでは、クラスによって、複数のインターフェイスにある同じ名前およびシグネチャを持つメンバーを個別に実装できるようにすることも必要です。  C\# と Visual Basic の両方が[明示的なインターフェイス実装](../Topic/Explicit%20Interface%20Implementation%20\(C%23%20Programming%20Guide\).md)をサポートしており、同じ名前を持つメソッドを別々に実装できます。  Visual Basic では `Implements` キーワードもサポートされているので、特定のメンバーが実装するインターフェイスおよびメンバーを明示的に指定できます。  次の例は、明示的なインターフェイス実装として `Temperature` インターフェイスおよび `ICelsius` インターフェイスを実装する `IFahrenheit` クラスを定義することで、このシナリオを示しています。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#24](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/eii1.cs#24)]
+ [!code-vb[Conceptual.CLSCompliant#24](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/eii1.vb#24)]  
+  
+<a name="enums"></a>   
+### 列挙  
+ CLS 準拠の列挙型は、次の規則に従う必要があります。  
+  
+-   列挙体の基になる型は、組み込みの CLS 準拠の整数 \(<xref:System.Byte>、<xref:System.Int16>、<xref:System.Int32>、または <xref:System.Int64>\) である必要があります。  たとえば、次のコードでは、基になる型が <xref:System.UInt32> の列挙体を定義しようとしますが、コンパイラの警告が生成されます。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#7](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/enum3.cs#7)]
+     [!code-vb[Conceptual.CLSCompliant#7](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/enum3.vb#7)]  
+  
+-   列挙型には、`Value__` 属性でマークされた <xref:System.Reflection.FieldAttributes?displayProperty=fullName> という名前の単一インスタンス フィールドが必要です。  これにより、フィールド値を暗黙的に参照できます。  
+  
+-   列挙体には、その列挙体自体の型と同じ型を持つリテラルな静的フィールドが含まれます。  たとえば、`State` および `State.On` の値を持つ `State.Off` 列挙体を定義すると、`State.On` と `State.Off` は両方ともリテラルな静的フィールドで、その型は `State` です。  
+  
+-   列挙体は 2 種類あります。  
+  
+    -   同時に指定できない一連の名前付き整数値を表す列挙体。  この列挙体の型は、<xref:System.FlagsAttribute?displayProperty=fullName> カスタム属性が存在しないことによって示されます。  
+  
+    -   名前のない値を生成するために結合できる一連のビット フラグを表す列挙体。  この列挙体の型は、<xref:System.FlagsAttribute?displayProperty=fullName> カスタム属性が存在することによって示されます。  
+  
+     詳細については、<xref:System.Enum> 構造体のドキュメントを参照してください。  
+  
+-   列挙体の値は、その列挙体の指定された値に限定されません。  つまり、列挙体の値の範囲は、その列挙体の基になる値の範囲です。  <xref:System.Enum.IsDefined%2A?displayProperty=fullName> メソッドを使用すると、指定された値が列挙体のメンバーかどうかを確認できます。  
+  
+<a name="members"></a>   
+### 一般的な型メンバー  
+ 共通言語仕様では、すべてのフィールドとメソッドに、特定のクラスのメンバーとしてアクセスする必要があります。  したがって、グローバルな静的フィールドおよび静的メソッド \(つまり、型とは別に定義された静的フィールドまたは静的メソッド\) は CLS に準拠していません。  グローバル フィールドまたはグローバル メソッドをソース コードに追加しようとすると、C\# と Visual Basic の両方のコンパイラでコンパイラ エラーが発生します。  
+  
+ 共通言語仕様では、標準のマネージ呼び出し規約のみがサポートされます。  アンマネージ呼び出し規約と、`varargs` キーワードでマークされた可変個引数リストを持つメソッドはサポートされません。  標準のマネージ呼び出し規約と互換性がある可変個引数リストについては、<xref:System.ParamArrayAttribute> キーワード \(C\# の場合\)、`params` キーワード \(Visual Basic の場合\) など、`ParamArray` 属性または個々の言語の実装を使用します。  
+  
+<a name="MemberAccess"></a>   
+### メンバーのアクセシビリティ  
+ 継承されたメンバーをオーバーライドしても、そのメンバーのアクセシビリティは変更できません。  たとえば、基底クラスのパブリック メソッドは、派生クラスのプライベート メソッドではオーバーライドできません。  ただし例外が 1 つあります。あるアセンブリ内にある、別のアセンブリの型でオーバーライドされた `protected internal` メンバー \(C\# の場合\) または `Protected Friend` メンバー \(Visual Basic の場合\) です。  この場合、オーバーライドのアクセシビリティは `Protected` です。  
+  
+ 次の例は、<xref:System.CLSCompliantAttribute> 属性が `true` で、`Person` の派生クラス `Animal` が、`Species` プロパティのアクセシビリティをパブリックからプライベートに変更しようとするときに発生するエラーを示しています。  アクセシビリティがパブリックに変更されると、コンパイルが正常に行われます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#28](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/accessibility1.cs#28)]
+ [!code-vb[Conceptual.CLSCompliant#28](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/accessibility1.vb#28)]  
+  
+ メンバーにアクセスできる場合は必ず、そのメンバーのシグネチャの型にアクセスできなければなりません。  たとえば、これは、パブリック メンバーには、型がプライベート、プロテクト、または内部のパラメーターを含められないことを意味します。  次の例は、`StringWrapper` クラス コンストラクターが、文字列値のラップ方法を決定する内部 `StringOperationType` 列挙値を公開した場合に発生するコンパイラ エラーを示しています。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#27](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/accessibility3.cs#27)]
+ [!code-vb[Conceptual.CLSCompliant#27](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/accessibility3.vb#27)]  
+  
+<a name="Generics"></a>   
+### ジェネリック型とメンバー  
+ 入れ子になった型には、少なくともその外側の型と同じ数のジェネリック パラメーターが必要です。  このジェネリック パラメーターは、外側の型のジェネリック パラメーターに位置によって対応します。  ジェネリック型に新しいジェネリック パラメーターを含めることもできます。  
+  
+ 外側の型のジェネリック型パラメーターと、その入れ子になった型の関係は、個別の言語構文によって非表示になっていることがあります。  次の例では、入れ子になった 2 つのクラス、`Outer<T>` および `Inner1A` が、ジェネリック型 `Inner1B<U>` に含まれます。  各クラスが `ToString` から継承した <xref:System.Object.ToString%2A?displayProperty=fullName> メソッドへの呼び出しは、入れ子になった各クラスに、その外側のクラスの型パラメーターが含まれていることを示しています。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#29](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/nestedgenerics2.cs#29)]
+ [!code-vb[Conceptual.CLSCompliant#29](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/nestedgenerics2.vb#29)]  
+  
+ ジェネリック型の名前は、フォーム *name*```*n* でエンコードされます。ここで、*name* は型の名前、``` は文字リテラル、*n* は型で宣言されたパラメーターの数、入れ子になったジェネリック型の場合は、新しく導入された型パラメーターの数です。  ジェネリック型の名前のエンコーディングは、主に、リフレクションを使用してライブラリ内の CLS 準拠のジェネリック型にアクセスする開発者が使用します。  
+  
+ 制約がジェネリック型に適用される場合は、制約として使用されるすべての型も CLS に準拠している必要があります。  次の例では、CLS に準拠していない `BaseClass` という名前のクラスと、型パラメーターが `BaseCollection` から派生しなければならない `BaseClass` という名前のジェネリック クラスを定義します。  ただし、`BaseClass` が CLS に準拠していないので、コンパイラによって警告が生成されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#34](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/generics5.cs#34)]
+ [!code-vb[Conceptual.CLSCompliant#34](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/generics5.vb#34)]  
+  
+ ジェネリック型がジェネリック基本型から派生している場合、そのジェネリック型は、基本型に対する制約も必ず満たすように制約を再宣言する必要があります。  次の例では、任意の数値型を表すことができる `Number<T>` を定義します。  また、浮動小数点値を表す `FloatingPoint<T>` クラスも定義します。  ただし、ソース コードはコンパイルされません。`Number<T>` \(T は値型\) の制約は `FloatingPoint<T>` に適用されないからです。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#30](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/generics2a.cs#30)]
+ [!code-vb[Conceptual.CLSCompliant#30](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/generics2a.vb#30)]  
+  
+ 制約が `FloatingPoint<T>` クラスに追加されると、コンパイルが正常に行われます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#31](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/generics2.cs#31)]
+ [!code-vb[Conceptual.CLSCompliant#31](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/generics2.vb#31)]  
+  
+ 共通言語仕様では、入れ子になった型とプロテクト メンバーに対して従来のインスタンス化ごとのモデルが適用されます。  オープン ジェネリック型では、フィールドまたはメンバーのシグネチャに、入れ子になったプロテクト ジェネリック型の特定のインスタンス化が含まれている場合、これらのフィールドやメンバーは公開できません。  ジェネリックの基底クラスやインターフェイスについて特定のインスタンス化を拡張する非ジェネリック型では、フィールドまたはメンバーのシグネチャに、入れ子になったプロテクト ジェネリック型の別のインスタンス化が含まれている場合、これらのフィールドやメンバーは公開できません。  
+  
+ 次の例では、ジェネリック型 `C1<T>` \(Visual Basic の場合は `C1(Of T)`\)、およびプロテクト クラス `C1<T>.N` \(Visual Basic の場合は `C1(Of T).N`\) を定義します。  `C1<T>` には、2 つのメソッド `M1` と `M2` があります。  ただし、`M1` は、`C1<int>.N` \(`C1(Of Integer).N`\) オブジェクトを C1\<T\> \(`C1(Of T)`\) から返そうとするので、CLS に準拠していません。  2 番目の `C2` クラスは、 `C1<long>` \(`C1(Of Long)`\) から派生しています。  これには、`M3` と `M4` の 2 つのメソッドがあります。  `M3` は、`C1<int>.N` \(`C1(Of Integer).N`\) オブジェクトを `C1<long>` のサブクラスから返そうとするので、CLS に準拠していません。  言語コンパイラはさらに制限されている可能性があります。  この例では、Visual Basic で `M4` をコンパイルしようとするとエラーが表示されます。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#32](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/generics4.cs#32)]
+ [!code-vb[Conceptual.CLSCompliant#32](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/generics4.vb#32)]  
+  
+<a name="ctors"></a>   
+### コンストラクター  
+ CLS 準拠のクラスと構造体のコンストラクターは、次の規則に従う必要があります。  
+  
+-   派生クラスのコンストラクターは、継承されたインスタンス データにアクセスする前に、基底クラスのインスタンス コンストラクターを呼び出す必要があります。  これは、基底クラスのコンストラクターは派生クラスには継承されないからです。  この規則は、直接継承をサポートしない構造体に適用されません。  
+  
+     次の例に示すように、コンパイラは、通常、CLS 準拠とは別にこの規則を適用します。  これにより、`Doctor` クラスから派生した `Person` クラスが作成されますが、`Doctor` クラスでは、継承されたインスタンス フィールドを初期化するための `Person` クラス コンストラクターは呼び出されません。  
+  
+     [!code-csharp[Conceptual.CLSCompliant#11](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/ctor1.cs#11)]
+     [!code-vb[Conceptual.CLSCompliant#11](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/ctor1.vb#11)]  
+  
+-   オブジェクト作成以外の目的で、オブジェクト コンストラクターを呼び出すことはできません。  また、オブジェクトを 2 度初期化することもできません。  たとえば、これは <xref:System.Object.MemberwiseClone%2A?displayProperty=fullName> メソッド、および <xref:System.Runtime.Serialization.Formatters.Binary.BinaryFormatter.Deserialize%2A?displayProperty=fullName> などの逆シリアル化メソッドでは、コンストラクターを呼び出してはいけないことを意味します。  
+  
+<a name="properties"></a>   
+### プロパティ  
+ CLS 準拠型のプロパティは、次の規則に従う必要があります。  
+  
+-   プロパティには setter、getter、またはこの両方が必ず必要です。  アセンブリでは、これらは特殊なメソッドとして実装されます。つまり、個別のメソッドとして \(getter は `get_`*propertyname*、setter は `set_`*propertyname* という名前で\) 表示され、アセンブリのメタデータでは `SpecialName` としてマークされます。  C\# コンパイラおよび Visual Basic コンパイラでは、この規則が自動的に適用されます。<xref:System.CLSCompliantAttribute> 属性を適用する必要はありません。  
+  
+-   プロパティの型は、プロパティ get アクセス操作子、および set アクセス操作子の最後の引数の戻り値の型です。  これらの型は CLS に準拠している必要があり、引数を参照によってプロパティに割り当てることはできません \(つまり、マネージ ポインターにできません\)。  
+  
+-   プロパティに get アクセス操作子と set アクセス操作子の両方がある場合は、両方が仮想、両方が静的、または両方がインスタンスである必要があります。  C\# コンパイラおよび Visual Basic コンパイラでは、この規則がプロパティ定義構文によって自動的に適用されます。  
+  
+<a name="events"></a>   
+### イベント  
+ イベントは、名前と型によって定義されます。  イベントの型は、イベントの表示に使用されるデリゲートです。  たとえば、<xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントは <xref:System.ResolveEventHandler> 型です。  イベント自体のほか、イベント名に基づく名前の 3 つのメソッドがイベントの実装を提供し、アセンブリのメタデータで `SpecialName` としてマークされています。  
+  
+-   イベント ハンドラーを追加するメソッド \(`add_`*EventName*\)。  たとえば、<xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントのイベント サブスクリプション メソッドの名前は `add_AssemblyResolve` です。  
+  
+-   イベント ハンドラーを削除するメソッド \(`remove_`*EventName*\)。  たとえば、<xref:System.AppDomain.AssemblyResolve?displayProperty=fullName> イベントの削除メソッドの名前は `remove_AssemblyResolve` です。  
+  
+-   イベントが発生したことを示すメソッド \(`raise_`*EventName*\)。  
+  
+> [!NOTE]
+>  イベントに関する共通言語仕様の規則は、ほとんどが言語コンパイラによって実装され、コンポーネント開発者が意識せずに使用できます。  
+  
+ イベントの追加、削除、発生の各メソッドには同じアクセシビリティが必要です。  また、すべてが、静的メソッド、インスタンス メソッド、仮想メソッドのいずれかでなければなりません。  イベントを追加および削除するメソッドには、イベント デリゲート型の型を持つパラメーターが 1 つあります。  追加メソッドおよび削除メソッドは両方とも存在するか、両方存在しないかのいずれかでなければなりません。  
+  
+ 次の例では、2 つのポイントの気温の差がしきい値と等しいか、それを超えた場合に `Temperature` イベントを発生させる、`TemperatureChanged` という名前の CLS 準拠クラスを定義します。  `Temperature` クラスは、イベント ハンドラーを選択的に実行できるように、`raise_TemperatureChanged` メソッドを明示的に定義します。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#20](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/event1.cs#20)]
+ [!code-vb[Conceptual.CLSCompliant#20](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/event1.vb#20)]  
+  
+<a name="overloads"></a>   
+### Overloads  
+ 共通言語仕様では、次の要件がオーバーロード メンバーに適用されます。  
+  
+-   メンバーは、パラメーターの数および型に基づいてオーバーロードできます。  オーバーロードを区別するときに、呼び出し規約、戻り値の型、メソッドまたはそのパラメーターに適用されているカスタム修飾子、およびパラメーターが値渡しか参照渡しかは考慮されません。  例については、「[名前付け規則](#naming)」で、名前がスコープ内で一意であることを要求する要件のコードを参照してください。  
+  
+-   プロパティおよびメソッドのみオーバーロードできる。  フィールドとイベントはオーバーロードできません。  
+  
+-   ジェネリック メソッドは、ジェネリック パラメーターの数に基づいてオーバーロードできます。  
+  
+> [!NOTE]
+>  `op_Explicit` 演算子および `op_Implicit` 演算子にはこの規則が適用されず、戻り値は、オーバーロード解決のためのメソッド シグネチャの一部として見なされません。  この 2 つの演算子は、そのパラメーターと戻り値の両方に基づいてオーバーロードできます。  
+  
+<a name="exceptions"></a>   
+### 例外  
+ 例外オブジェクトは <xref:System.Exception?displayProperty=fullName>、または <xref:System.Exception?displayProperty=fullName> の別の派生型から派生する必要があります。  次の例は、`ErrorClass` というカスタム クラスを例外処理に使用したときに発生するコンパイラ エラーを示しています。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#13](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/exceptions1.cs#13)]
+ [!code-vb[Conceptual.CLSCompliant#13](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/exceptions1.vb#13)]  
+  
+ このエラーを修正するには、`ErrorClass` から継承するように <xref:System.Exception?displayProperty=fullName> クラスを指定する必要があります。  また、`Message` プロパティはオーバーライドする必要があります。  次の例では、このエラーを修正して CLS 準拠の `ErrorClass` クラスを定義します。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#14](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/exceptions2.cs#14)]
+ [!code-vb[Conceptual.CLSCompliant#14](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/exceptions2.vb#14)]  
+  
+<a name="attributes"></a>   
+### 属性  
+ .NET Framework アセンブリでは、カスタム属性に拡張可能機構が用意されており、そのカスタム属性を格納し、アセンブリ、型、メンバー、メソッド パラメーターなどのプログラミング オブジェクトに関するメタデータを取得します。  カスタム属性は <xref:System.Attribute?displayProperty=fullName>、または <xref:System.Attribute?displayProperty=fullName> の派生型から派生する必要があります。  
+  
+ 規則に違反する例を次に示します。  この例では、`NumericAttribute` から派生していない <xref:System.Attribute?displayProperty=fullName> クラスを定義します。  コンパイラ エラーは、CLS 非準拠の属性が適用されている場合にのみ発生します。クラスが定義されているときではありません。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#18](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/attribute1.cs#18)]
+ [!code-vb[Conceptual.CLSCompliant#18](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/attribute1.vb#18)]  
+  
+ CLS 準拠の属性のコンストラクターまたはプロパティは、次の型のみを公開できます。  
+  
+-   <xref:System.Boolean>  
+  
+-   <xref:System.Byte>  
+  
+-   <xref:System.Char>  
+  
+-   <xref:System.Double>  
+  
+-   <xref:System.Int16>  
+  
+-   <xref:System.Int32>  
+  
+-   <xref:System.Int64>  
+  
+-   <xref:System.Single>  
+  
+-   <xref:System.String>  
+  
+-   <xref:System.Type>  
+  
+-   基になる型が <xref:System.Byte>、<xref:System.Int16>、<xref:System.Int32>、または <xref:System.Int64> である列挙体の型。  
+  
+ 次の例では、`DescriptionAttribute` から派生する <xref:System.Attribute> クラスを定義します。  クラス コンストラクターには型 `Descriptor` のパラメーターがあるので、クラスは CLS に準拠していません。  C\# コンパイラでは警告が出力されますが、コンパイルは正常に行われます。一方、Visual Basic コンパイラでは警告もエラーも出力されません。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#33](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/attribute2.cs#33)]
+ [!code-vb[Conceptual.CLSCompliant#33](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/attribute2.vb#33)]  
+  
+<a name="CLSAttribute"></a>   
+## CLSCompliantAttribute 属性  
+ <xref:System.CLSCompliantAttribute> 属性は、プログラム要素が共通言語仕様でコンパイルされているかどうかを示すために使用されます。  <xref:System.CLSCompliantAttribute.%23ctor%28System.Boolean%29?displayProperty=fullName> コンストラクターには、プログラム要素が CLS に準拠しているかどうかを示す 1 つの必須パラメーター、`isCompliant` が含まれます。  
+  
+ コンパイル時に、CLS 準拠が前提とされる非準拠要素が検出され、警告が出力されます。  非準拠として明示的に宣言された型またはメンバーに対しては、警告は出力されません。  
+  
+ コンポーネント開発者は、次の 2 とおりの目的で <xref:System.CLSCompliantAttribute> 属性を使用できます。  
+  
+-   コンポーネントによって公開されたパブリック インターフェイスの CLS 準拠部分と CLS 非準拠部分を定義する。  この属性を使用して特定のプログラム要素を CLS 準拠としてマークすると、.NET Framework を対象とするすべてのツールおよび言語から、これらの要素に必ずアクセスできるようになります。  
+  
+-   コンポーネント ライブラリのパブリック インターフェイスが CLS に準拠するプログラム要素のみを公開するように保証する。  要素が CLS 非準拠の場合は、通常、警告が表示されます。  
+  
+> [!WARNING]
+>  言語コンパイラでは、<xref:System.CLSCompliantAttribute> 属性が使用されているかどうかに関係なく、CLS 準拠の規則が適用される場合があります。  たとえば、インターフェイスの静的メンバーを定義すると CLS の規則に違反します。  ただし、インターフェイスで `static` メンバー \(C\# の場合\) または `Shared` メンバー \(Visual Basic の場合\) を定義すると、C\# と Visual Basic の両方のコンパイラでエラー メッセージが表示され、アプリはコンパイルされません。  
+  
+ <xref:System.CLSCompliantAttribute> 属性は、値 <xref:System.AttributeUsageAttribute> が指定された <xref:System.AttributeTargets?displayProperty=fullName> 属性でマークされます。  この値を使用すると、<xref:System.CLSCompliantAttribute> 属性を、アセンブリ、モジュール、型 \(クラス、構造体、列挙体、インターフェイス、およびデリゲート\)、型パラメーター \(コンストラクター、メソッド、プロパティ、フィールド、およびイベント\)、パラメーター、ジェネリック パラメーター、戻り値など、すべてのプログラム要素に適用できます。  ただし、実際は、アセンブリ、型、および型メンバーだけに属性を適用することをお勧めします。  そうしないと、属性は、コンパイラによってライブラリのパブリック インターフェイスで非準拠パラメーター、ジェネリック パラメーター、または戻り値が検出されたときに必ず無視され、コンパイラ警告が引き続き生成されます。  
+  
+ <xref:System.CLSCompliantAttribute> 属性の値は、内包型プログラム要素によって継承されます。  たとえば、アセンブリが CLS 準拠としてマークされている場合は、その型も CLS に準拠します。  型が CLS 準拠としてマークされている場合は、その入れ子になった型とメンバーも CLS に準拠します。  
+  
+ 継承された準拠状況を明示的にオーバーライドするには、<xref:System.CLSCompliantAttribute> 属性を、格納されているプログラム要素に適用します。  たとえば、<xref:System.CLSCompliantAttribute> 値が `isCompliant` に指定された `false` 属性を使用すると、準拠アセンブリで非準拠型を定義できます。また、`isCompliant` 値が `true` に指定された属性を使用すると、非準拠アセンブリで準拠型を定義できます。  準拠型で非準拠メンバーを定義することもできます。  ただし、非準拠型は準拠メンバーを持つことができないので、`isCompliant` 値が `true` に指定された属性では非準拠型から継承をオーバーライドできません。  
+  
+ コンポーネントを開発するときは必ず、<xref:System.CLSCompliantAttribute> 属性を使用して、アセンブリ、その型、およびそのメンバーが CLS に準拠しているかどうかを指定することをお勧めします。  
+  
+ CLS 準拠のコンポーネントを作成するには:  
+  
+1.  <xref:System.CLSCompliantAttribute> を使用して、CLS 準拠としてアセンブリをマークします。  
+  
+2.  アセンブリ内の CLS に準拠していない公開された型を、非準拠としてマークします。  
+  
+3.  CLS 準拠の型の公開されたメンバーを、非準拠としてマークします。  
+  
+4.  CLS 非準拠メンバーの CLS 準拠の代替を指定します。  
+  
+ 非準拠の型とメンバーすべてを正常にマークした場合、非準拠の警告は出力されません。  ただし、どのメンバーが CLS に準拠していないかを提示し、CLS 準拠の代替を製品ドキュメントに示すことをお勧めします。  
+  
+ 次の例では、<xref:System.CLSCompliantAttribute> 属性を使用して、CLS 準拠のアセンブリと、2 つの CLS 非準拠のメンバーを持つ型、`CharacterUtilities` を定義します。  両メンバーとも `CLSCompliant(false)` 属性でタグ付けされているので、警告は生成されません。  また、クラスには、両方のメソッド用の CLS 準拠の代替も用意されています。  通常、CLS 準拠の代替を用意するには、2 つのオーバーロードを `ToUTF16` メソッドに追加するだけです。  ただし、戻り値に基づいてメソッドをオーバーロードできないので、CLS 準拠のメソッドの名前は、非準拠のメソッドの名前とは異なります。  
+  
+ [!code-csharp[Conceptual.CLSCompliant#35](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.clscompliant/cs/indicator3.cs#35)]
+ [!code-vb[Conceptual.CLSCompliant#35](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.clscompliant/vb/indicator3.vb#35)]  
+  
+ ライブラリではなくアプリを開発している場合 \(つまり、他のアプリ開発者が使用できる型またはメンバーを公開しない場合\)、アプリが使用するプログラム要素は、そのプログラム要素が使用する言語でサポートされていない場合に CLS に準拠する必要があります。  この場合、CLS 非準拠の要素を使用しようとすると、言語コンパイラによってエラーが生成されます。  
+  
+<a name="CrossLang"></a>   
+## 言語間の相互運用性  
+ 言語に依存しないということは、いくつか意味があります。  たとえば、ある言語で記述された型を、別の言語で記述されたアプリからシームレスに利用することができます。これについては、記事「[Language Independence and Language\-Independent Components \(言語非依存性と言語に依存しないコンポーネント\)](../../docs/standard/language-independence-and-language-independent-components.md)」で説明しました。  また、複数の言語で記述されたコードを 1 つの .NET .NET Framework アセンブリにまとめることもできます。ここでは、この点について焦点を当てて説明します。  
+  
+ 次の例では、`NumericLib` および `StringLib` という 2 つのクラスを含む Utilities.dll という名前のクラス ライブラリを作成して言語間の相互運用性を示します。  `NumericLib` クラスは C\# で記述され、`StringLib` クラスは Visual Basic で記述されています。  以下は StringUtil.vb のソース コードで、`ToTitleCase` クラスに `StringLib` という単一のメンバーが含まれます。  
+  
+ [!code-vb[Conceptual.CrossLanguage#1](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.crosslanguage/vb/stringutil.vb#1)]  
+  
+ 以下は NumberUtil.cs のソース コードで、`NumericLib` および `IsEven` という 2 つのメンバーを持つ `NearZero` クラスを定義しています。  
+  
+ [!code-csharp[Conceptual.CrossLanguage#2](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.crosslanguage/cs/numberutil.cs#2)]  
+  
+ 単一のアセンブリに 2 つのクラスをパッケージ化するには、モジュールにコンパイルする必要があります。  Visual Basic のソース コード ファイルをモジュールにコンパイルするには、次のコマンドを使用します。  
+  
+```  
+vbc /t:module StringUtil.vb   
+```  
+  
+ Visual Basic コンパイラのコマンド ライン構文の詳細については、「[コマンド ラインからのビルド](../Topic/Building%20from%20the%20Command%20Line%20\(Visual%20Basic\).md)」を参照してください。  
+  
+ C\# のソース コード ファイルをモジュールにコンパイルするには、次のコマンドを使用します。  
+  
+```  
+csc /t:module NumberUtil.cs  
+```  
+  
+ C\# コンパイラのコマンド ライン構文の詳細については、「[csc.exe を使用したコマンド ラインからのビルド](../../ocs/csharp/language-reference/compiler-options/command-line-building-with-csc-exe.md)」を参照してください。  
+  
+ 次に、[リンク ツール \(Link.exe\)](../Topic/Linker%20Options.md) を使用してアセンブリに 2 つのモジュールをコンパイルします。  
+  
+```  
+link numberutil.netmodule stringutil.netmodule /out:UtilityLib.dll /dll   
+```  
+  
+ 次の例では、その後 `NumericLib.NearZero` メソッドおよび `StringLib.ToTitleCase` メソッドを呼び出します。  Visual Basic コードと C\# コードは、両方のクラスのメソッドにアクセスできることに注意してください。  
+  
+ [!code-csharp[Conceptual.CrossLanguage#3](../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.crosslanguage/cs/useutilities1.cs#3)]
+ [!code-vb[Conceptual.CrossLanguage#3](../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.crosslanguage/vb/useutilities1.vb#3)]  
+  
+ Visual Basic コードをコンパイルするには、次のコマンドを使用します。  
+  
+```  
+vbc example.vb /r:UtilityLib.dll  
+```  
+  
+ C\# でコンパイルするには、コンパイラの名前を **vbc** から **csc** に変更し、ファイル拡張子を .vb から .cs に変更します。  
+  
+```  
+csc example.cs /r:UtilityLib.dll  
+```  
+  
+## 参照  
+ <xref:System.CLSCompliantAttribute>
\ No newline at end of file
diff --git a/docs/standard/managed-execution-process.md b/docs/standard/managed-execution-process.md
new file mode 100644
index 00000000000..68cd72ebdfc
--- /dev/null
+++ b/docs/standard/managed-execution-process.md
@@ -0,0 +1,123 @@
+---
+title: "マネージ実行プロセス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ソース コード言語"
+  - "コード, マネージ実行プロセス"
+  - "ランタイム, マネージ実行プロセス"
+  - "ソース コードのコンパイル, マネージ実行プロセス"
+  - "マネージ実行プロセス"
+  - "共通言語ランタイム, マネージ実行プロセス"
+ms.assetid: 476b03dc-2b12-49a7-b067-41caeaa2f533
+caps.latest.revision: 20
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# マネージ実行プロセス
+<a name="introduction"></a> マネージ実行プロセスで実行される主な手順を次に示します。詳細については、後で説明します。  
+  
+1.  [コンパイラを選択します](#choosing_a_compiler)。  
+  
+     共通言語ランタイムが提供する機能を利用するためには、共通言語ランタイムに対応した言語コンパイラを使用する必要があります。  
+  
+2.  [コードを MSIL にコンパイルします](#compiling_to_msil)。  
+  
+     コンパイルを実行するとソース コードが Microsoft Intermediate Language \(MSIL\) に変換され、必要なメタデータが生成されます。  
+  
+3.  [MSIL からネイティブ コードにコンパイルします](#compiling_msil_to_native_code)。  
+  
+     実行時に、ジャスト イン タイム \(JIT\) コンパイラによって MSIL がネイティブ コードに変換されます。 このコンパイルの実行時に、コードは検証プロセスで確認される必要があります。この検証プロセスでは、MSIL とメタデータが調べられ、コードがタイプ セーフかどうかが確認されます。  
+  
+4.  [コードを実行します](#running_code)。  
+  
+     共通言語ランタイムは、実行を可能にするインフラストラクチャと実行時に使用できるサービスを提供します。  
+  
+<a name="choosing_a_compiler"></a>   
+## コンパイラの選択  
+ 共通言語ランタイム \(CLR: Common Language Runtime\) によって提供される機能を活用するには、Visual Basic、C\#、Visual C\+\+、F\# などのランタイムに対応した言語コンパイラか、Eiffel、Perl、COBOL などのサードパーティのコンパイラを使用する必要があります。  
+  
+ 共通言語ランタイムは多言語実行環境であるため、さまざまなデータ型と言語機能をサポートしています。 使用する言語コンパイラによって、利用できる共通言語ランタイムの機能が決まり、その機能を使用してコードをデザインすることになります。 記述するコードの構文を決定するのは、共通言語ランタイムではなく、使用するコンパイラです。 作成したコンポーネントを他の言語で記述されたコンポーネントでも完全に使用できるようにするためには、そのコンポーネントからエクスポートされた型が、[言語への非依存性、および言語非依存コンポーネント](../../docs/standard/language-independence-and-language-independent-components.md) \(CLS\) に規定されている言語機能だけを公開するようにする必要があります。<xref:System.CLSCompliantAttribute> 属性を使用することにより、コードを確実に CLS に準拠させることができます。 詳細については、「[言語への非依存性、および言語非依存コンポーネント](../../docs/standard/language-independence-and-language-independent-components.md)」を参照してください。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="compiling_to_msil"></a>   
+## MSIL へのコンパイル  
+ マネージ コードへのコンパイル時に、コンパイラはソース コードを MSIL \(Microsoft Intermediate Language\) に変換します。MSIL は CPU に依存しない一連の命令で、効率的にネイティブ コードに変換できます。 MSIL には、オブジェクトに対する読み込み、格納、初期化、および呼び出し用の命令の他に、算術演算と論理演算、制御フロー、DMA \(Direct Memory Access\)、例外処理、およびその他の操作のための命令も含まれています。 コードを実行する前に、MSIL を CPU 固有のコードに変換する必要があります。通常、この変換は [Just\-In\-Time \(JIT\) コンパイラ](#compiling_msil_to_native_code)によって行われます。 共通言語ランタイムはサポートするコンピューター アーキテクチャごとに JIT コンパイラを提供しているため、同じ MSIL セットを JIT コンパイルして、サポートされているすべてのアーキテクチャで実行できます。  
+  
+ コンパイラは、MSIL を生成するときにメタデータも生成します。 メタデータには、コード内の型について、それぞれの型の定義、型のメンバーのシグネチャ、コードが参照するメンバー、共通言語ランタイムが実行時に使用するその他のデータなどが記述されています。 MSIL とメタデータは、実行可能ファイルのファイル形式として使用されてきた従来の Microsoft PE と COFF \(Common Object File Format\) に基づき、それらを拡張した移植可能な実行可能 \(PE: Portable Executable\) ファイルに格納されます。 MSIL、ネイティブ コード、およびメタデータを保存できるこのファイル形式を使用すると、オペレーティング システムが共通言語ランタイムのイメージを認識できるようになります。 MSIL と共にメタデータがこのファイルに格納されるため、コードは自己記述型になります。つまり、タイプ ライブラリまたはインターフェイス定義言語 \(IDL: Interface Definition Language\) は必要ありません。 共通言語ランタイムは、実行時にこのファイルから必要に応じてメタデータを検出および抽出します。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="compiling_msil_to_native_code"></a>   
+## MSIL からネイティブ コードへのコンパイル  
+ Microsoft Intermediate Language \(MSIL\) は、実行する前に、共通言語ランタイムに対して、対象コンピューターのアーキテクチャ用のネイティブ コードにコンパイルしておく必要があります。[!INCLUDE[dnprdnshort](../../includes/dnprdnshort-md.md)] には、この変換を実行する 2 つの方法が用意されています。  
+  
+-   .NET Framework の Just\-In\-Time \(JIT\) コンパイラ  
+  
+-   .NET Framework [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../docs/framework/tools/ngen-exe-native-image-generator.md)。  
+  
+### JIT コンパイラによるコンパイル  
+ JIT コンパイルは、アプリケーション実行時に、アセンブリの内容が読み込まれて実行される際に、オン デマンドで MSIL をネイティブ コードに変換します。 共通言語ランタイムには、サポートされる CPU アーキテクチャごとに JIT コンパイラが用意されているため、開発者は MSIL アセンブリのセットを作成し、それを JIT でコンパイルして、異なるマシン アーキテクチャを持つさまざまなコンピューター上で実行できます。 ただし、マネージ コードがプラットフォーム固有のネイティブ API またはプラットフォーム固有のクラス ライブラリを呼び出す場合、そのコードはそのオペレーティング システムでしか実行されません。  
+  
+ JIT コンパイルは、実行時に呼び出されることがないコードがある可能性を考慮しています。 つまり、PE ファイル内にあるすべての MSIL をネイディブ コードに変換するために時間とメモリを費やす代わりに、実行時に必要とされる MSIL を変換し、結果として生成されるネイティブ コードをメモリに保存することで、そのプロセスのコンテキスト内の後続の呼び出しがこれを利用できるようにします。 型が読み込まれて初期化されるとき、ローダーはスタブを作成し、その型の各メソッドにそれを結び付けます。 メソッドが初めて呼び出されるとき、スタブは JIT コンパイラに制御を渡します。JIT コンパイラはそのメソッド用の MSIL をネイティブ コードに変換して、生成されたネイティブ コードを直接指すようスタブを変更します。 このため、JIT でコンパイルされたメソッドに対する後続の呼び出しでは、ネイティブ コードが直接実行されます。  
+  
+### NGen.exe を使用したインストール時のコード生成  
+ JIT コンパイラは、アセンブリの MSIL を、そのアセンブリで定義されている個々のメソッドが呼び出されるときにネイティブ コードに変換するため、実行時のパフォーマンスが低下します。 ほとんどの場合、このパフォーマンスの低下は許容範囲内です。 より重要な点として、JIT コンパイラが生成したコードは、コンパイルを起動したプロセスにバインドされます。 複数のプロセスの間でこれを共有することはできません。 生成されたコードを、1 つのアプリケーションの複数の呼び出しの間で、または 1 つのアセンブリ セットを共有する複数のプロセスの間で共有できるようにするために、共通言語ランタイムは事前コンパイル モードをサポートします。 この事前コンパイル モードは [Ngen.exe \(ネイティブ イメージ ジェネレーター\)](../../docs/framework/tools/ngen-exe-native-image-generator.md) を使用して、JIT コンパイラと同様に MSIL アセンブリをネイティブ コードに変換します。 ただし、Ngen.exe の動作は、以下の 3 つの点で JIT コンパイラの動作と異なります。  
+  
+-   MSIL からネイティブ コードへの変換を、アプリケーション実行中ではなく、実行前に行います。  
+  
+-   メソッドを 1 つずつコンパイルするのではなく、アセンブリ全体を一度にコンパイルします。  
+  
+-   生成したコードを、ディスク上のファイルとしてネイティブ イメージ キャッシュに保持します。  
+  
+### コードの検証  
+ コード検証の省略を許可するセキュリティ ポリシーを管理者が設定していない限り、MSIL からネイティブ コードへのコンパイル時に、MSIL コードは検証プロセスを通過する必要があります。 この検証プロセスでは、コードがタイプ セーフかどうかを確認するために、MSIL とメタデータが調べられます。タイプ セーフなコードとは、アクセス権限を与えられているメモリ位置だけにアクセスするコードを意味します。 タイプ セーフは、オブジェクトを相互に分離するため、不注意や悪意による破損からオブジェクトを保護するために役立ちます。 また、コードに対するセキュリティ制限が強制適用されることも保証されます。  
+  
+ 共通言語ランタイムは、検証可能なタイプ セーフ コードが次の条件を満たすことを前提としています。  
+  
+-   型への参照には参照される型との間に完全な互換性がある。  
+  
+-   適切に定義された操作だけがオブジェクトに対して呼び出される。  
+  
+-   ID が正しい。  
+  
+ 検証プロセスでは、MSIL コードが調べられ、適切に定義された型だけを使用してメモリ位置にアクセスしたりメソッドを呼び出したりするかどうかが確認されます。 たとえば、オブジェクトのフィールドにアクセスするときにメモリ位置をオーバーランできるようなコードは許可されません。 また、不正な MSIL があるとタイプ セーフ規則に違反する可能性があるため、MSIL が正しく生成されているかどうかも調べられます。 検証プロセスは適切に定義されたタイプ セーフ コードのセットを許可します。許可されるコードはタイプ セーフなコードだけです。 ただし、タイプ セーフなコードの中にも、検証プロセスの制約事項のために検証を通過しないコードがあります。また、言語によっては、デザイン上、検証可能なタイプ セーフ コードが生成されない場合もあります。 セキュリティ ポリシーがタイプ セーフなコードを必要とするにもかかわらず、コードが検証を通過しない場合には、そのコードの実行時に例外がスローされます。  
+  
+ [ページのトップへ](#introduction)  
+  
+<a name="running_code"></a>   
+## コードの実行  
+ 共通言語ランタイムは、マネージ実行を可能にするインフラストラクチャと実行時に使用できるサービスを提供します。 メソッドは、実行する前にプロセッサ固有のコードにコンパイルされている必要があります。 対応する MSIL が生成されているメソッドは、初めて呼び出されたときに JIT コンパイルされてから実行されます。 次にこのメソッドが実行されるときには、JIT コンパイル済みの既存のネイティブ コードが実行されます。 JIT コンパイルからコード実行までのプロセスは、実行が完了するまで繰り返されます。  
+  
+ 実行時に、マネージ コードは、ガベージ コレクション、セキュリティ、アンマネージ コードとの相互運用性、言語間デバッグ サポート、強化された配置とバージョン管理のサポートなどのさまざまなサービスを利用できます。  
+  
+ Microsoft [!INCLUDE[winxp](../../includes/winxp-md.md)] および [!INCLUDE[windowsver](../../includes/windowsver-md.md)] では、オペレーティング システム ローダーが COFF ヘッダー内のビットを調べることにより、マネージ モジュールをチェックします。 設定されたビットはマネージ モジュールを意味します。 ローダーがマネージ モジュールを検出すると、mscoree.dll が読み込まれます。マネージ モジュール イメージが読み込まれるときとアンロードされるときには、`_CorValidateImage` および `_CorImageUnloading` がローダーに通知します。`_CorValidateImage` は、次のアクションを実行します。  
+  
+1.  コードが有効なマネージ コードであることを確認します。  
+  
+2.  イメージのエントリ ポイントをランタイムのエントリ ポイントに変更します。  
+  
+ 64 ビット Windows では、`_CorValidateImage` は、メモリ内のイメージを PE32 から PE32\+ 形式に変換することによって変更します。  
+  
+ [ページのトップへ](#introduction)  
+  
+## 参照  
+ [概要](../../docs/framework/get-started/overview.md)   
+ [言語への非依存性、および言語非依存コンポーネント](../../docs/standard/language-independence-and-language-independent-components.md)   
+ [メタデータと自己言及的なコンポーネント](../../docs/standard/metadata-and-self-describing-components.md)   
+ [Ilasm.exe \(IL アセンブラー\)](../../docs/framework/tools/ilasm-exe-il-assembler.md)   
+ [セキュリティ](../../docs/standard/security/index.md)   
+ [アンマネージ コードとの相互運用](../../docs/framework/interop/index.md)   
+ [配置](../../docs/framework/deployment/net-framework-and-applications.md)   
+ [共通言語ランタイムのアセンブリ](../../docs/framework/app-domains/assemblies-in-the-common-language-runtime.md)   
+ [アプリケーション ドメイン](../../docs/framework/app-domains/application-domains.md)
\ No newline at end of file
diff --git a/docs/standard/metadata-and-self-describing-components.md b/docs/standard/metadata-and-self-describing-components.md
new file mode 100644
index 00000000000..38075f38b5c
--- /dev/null
+++ b/docs/standard/metadata-and-self-describing-components.md
@@ -0,0 +1,174 @@
+---
+title: "メタデータと自己言及的なコンポーネント | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "共通言語ランタイム, メタデータ"
+  - "コンポーネント [.NET Framework], メタデータ"
+  - "言語, 相互運用性"
+  - "メタデータ, メタデータの概要"
+  - "PE ファイル, メタデータ"
+  - "移植可能な実行可能 (PE) ファイル, メタデータ"
+  - "ランタイム, メタデータ"
+  - "自己言及的なファイル"
+ms.assetid: 3dd13c5d-a508-455b-8dce-0a852882a5a7
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# メタデータと自己言及的なコンポーネント
+以前は、ある 1 つの言語で記述されたソフトウェア コンポーネント \(.exe または .dll\) で、別の言語で記述されたコンポーネントを使用するのは簡単ではありませんでした。  COM により、この問題が解決するための手段が提供されるようになりました。  .NET Framework では、コンパイラからすべてのモジュールやアセンブリに追加の宣言情報を挿入できるようになり、コンポーネントの相互運用性が大幅に強化されています。  メタデータと呼ばれるこの情報により、コンポーネント間のシームレスな相互作用がサポートされます。  
+  
+ メタデータはプログラムを説明するバイナリ情報であり、共通言語ランタイムのポータブル実行可能 \(PE\) ファイルまたはメモリのいずれかに格納されます。  コードを PE ファイルとしてコンパイルすると、PE ファイルの特定の部分にメタデータが挿入され、コードは Microsoft Intermediate Language \(MSIL\) に変換されて PE ファイル内の別の部分に挿入されます。  モジュール内またはアセンブリ内で定義され、参照されているすべての型およびメンバーは、メタデータ内部に記述されます。  コードを実行すると、ランタイムはメタデータをメモリに読み込み、コードのクラス、メンバー、継承などの情報を検索するためにメタデータを参照します。  
+  
+ メタデータには、コードに定義されているすべての型およびメンバーが言語に中立的な形で記述されています。  メタデータには、次の情報が格納されいてます。  
+  
+-   アセンブリに関する記述  
+  
+    -   ID \(名前、バージョン、カルチャ、公開キー\)  
+  
+    -   エクスポートされる型  
+  
+    -   そのアセンブリが依存している他のアセンブリ  
+  
+    -   実行のために必要なセキュリティ アクセス許可  
+  
+-   型に関する説明  
+  
+    -   名前、参照可能範囲、基底クラス、および実装されているインターフェイス  
+  
+    -   メンバー \(メソッド、フィールド、プロパティ、イベント、入れ子になった型\)  
+  
+-   属性。  
+  
+    -   型やメンバーを修飾する追加の記述要素  
+  
+## メタデータの利点  
+ メタデータは、プログラミング モデルを簡素化するうえで重要な役割を果たします。これにより、インターフェイス定義言語 \(IDL: Interface Definition Language\) ファイル、ヘッダー ファイル、およびその他のコンポーネント参照の外部メソッドは一切不要になります。  メタデータを使用すると、.NET Framework の各言語は、開発者やユーザーからは見えない、言語に依存しない形式で自動的に記述されるようになります。  また、属性を使用することにより、メタデータを拡張することもできます。  メタデータの主な利点は、次のとおりです。  
+  
+-   自己言及的なファイル  
+  
+     共通言語ランタイム モジュールおよびアセンブリは、自己言及的なファイルです。  モジュールのメタデータには、他のモジュールと相互作用するのに必要なすべての情報が含まれています。  メタデータは自動的に COM の IDL の機能を提供するため、ユーザーは 1 つのファイルを定義と実装の両方に使用できます。  また、ランタイム モジュールやアセンブリをオペレーティング システムに登録する必要もありません。  これにより、ランタイムが使用する記述は常にコンパイル済みファイル内の実際のコードに反映されるため、アプリケーションの信頼性が高くなります。  
+  
+-   言語の相互運用性と簡単なコンポーネント ベースのデザイン  
+  
+     メタデータは、他の言語で記述されている PE ファイルからクラスを継承するのに必要な、コンパイル済みコードについてのすべての情報を提供します。  明示的なマーシャリングや相互運用可能なカスタム コードの使用を考慮せずに、マネージ言語 \(共通言語ランタイムに変換される言語\) で記述された任意のクラスのインスタンスを作成できます。  
+  
+-   属性。  
+  
+     .NET Framework を使用すると、コンパイル済みファイル内で "属性" と呼ばれる特定の種類のメタデータを宣言できます。  属性は、.NET Framework 全体で使用され、実行時のプログラムの動作を詳細に制御します。  また、ユーザー定義のカスタム属性によって、独自に作成したメタデータを .NET Framework のファイルに挿入できます。  詳細については、「[属性](../../docs/standard/attributes/index.md)」を参照してください。  
+  
+## メタデータと PE ファイルの構造  
+ メタデータと Microsoft Intermediate Language \(MSIL\) は、それぞれ、.NET Framework のポータブル実行可能 \(PE\) ファイルの別のセクションに格納されます。  ファイルのメタデータ部分には、一連のテーブルとヒープ データの構造が格納されています。  MSIL 部分には、PE ファイルのメタデータ部分を参照する MSIL とメタデータ トークンが格納されています。  コードの MSIL を表示する [MSIL 逆アセンブラー \(Ildasm.exe\)](../../docs/framework/tools/ildasm-exe-il-disassembler.md) のようなツールを使用すると、メタデータ トークンが表示される場合があります。  
+  
+### メタデータのテーブルおよびヒープ  
+ 各メタデータ テーブルには、プログラムの要素に関する情報が保持されています。  たとえば、1 つのメタデータ テーブルにはコード内のクラスが記述されており、別のテーブルにはフィールドが記述されています。  コードに 10 個のクラスが存在する場合、クラス テーブルには、各クラスごとに 1 行、つまり 10 行が存在します。  メタデータ テーブルは、他のテーブルおよびヒープを参照します。  たとえば、クラスのメタデータ テーブルは、メソッドのテーブルを参照します。  
+  
+ また、メタデータは、4 つのヒープ構造 \(文字列、BLOB、ユーザー文字列、および GUID\) に情報を格納します。  型やメンバーに名前を付けるために使用する文字列はすべて、文字列ヒープに格納されています。  たとえば、特定のメソッドの名前はメソッド テーブルに直接は格納されず、メソッド テーブルから文字列ヒープ内に格納されているメソッドの名前を参照します。  
+  
+### メタデータ トークン  
+ 各メタデータ テーブルのそれぞれの行は、メタデータ トークンによって、PE ファイルの MSIL 部分内で一意に識別されます。  メタデータ トークンは、概念上、ポインターに類似しており、特定のメタデータ テーブルを参照します。  
+  
+ メタデータ トークンは、4 バイトで構成される数値です。  最上位バイトは、特定のトークンの参照先であるメタデータ テーブル \(メソッド、型など\) を表します。  残り 3 バイトは、記述されているプログラミング要素と対応する、メタデータ テーブル内の行を指定します。  たとえば、C\# 言語でメソッドを定義し、そのメソッドを PE ファイルとしてコンパイルすると、PE ファイルの MSIL 部分に次のようなメタデータ トークンが格納されます。  
+  
+```  
+0x06000004  
+```  
+  
+ 最上位バイト \(`0x06`\) は、**MethodDef** トークンであることを示します。  下位 3 バイト \(`000004`\) は、**MethodDef** テーブル内の、このメソッドの定義を記述する情報に対応する 4 行目を参照するように、共通言語ランタイムに指示します。  
+  
+### PE ファイル内のメタデータ  
+ プログラムを共通言語ランタイムとしてコンパイルすると、プログラムは 3 つの部分で構成される PE ファイルに変換されます。  各部分の内容を説明する表を次に示します。  
+  
+|PE セクション|PE セクションの内容|  
+|--------------|-----------------|  
+|PE ヘッダー|PE ファイルの主要なセクションのインデックスとエントリ ポイントのアドレス。<br /><br /> ランタイムはこの情報に基づいてファイルを PE ファイルとして識別し、実行開始位置と、メモリにプログラムをいつ読み込むかを判断します。|  
+|MSIL の命令|コードを構成する Microsoft Intermediate Language \(MSIL\) の命令。  ほとんどの MSIL 命令には、メタデータ トークンが付いています。|  
+|メタデータ|メタデータ テーブルおよびヒープ。  ランタイムはこのセクションを使用してコード内のすべての型およびメンバーに関する情報を記録します。  また、このセクションには、カスタム属性やセキュリティ情報も格納されています。|  
+  
+## 実行時のメタデータの使用  
+ メタデータと、共通言語ランタイムでのメタデータの役割をより深く理解するために、簡単なプログラムを作成し、メタデータがその有効期間中にどのように機能するかを示します。  `MyApp` と呼ばれるクラス内の 2 つのメソッドを表すコードの例を次に示します。  `Main` メソッドは、プログラムのエントリ ポイントです。`Add` メソッドは、2 つの整数引数の合計値を返します。  
+  
+```vb  
+Public Class MyApp  
+   Public Shared Sub Main()  
+      Dim ValueOne As Integer = 10  
+      Dim ValueTwo As Integer = 20  
+      Console.WriteLine("The Value is: {0}", Add(ValueOne, ValueTwo))  
+   End Sub  
+  
+   Public Shared Function Add(One As Integer, Two As Integer) As Integer  
+      Return (One + Two)  
+   End Function  
+End Class  
+```  
+  
+```csharp  
+using System;    
+public class MyApp  
+{  
+   public static int Main()  
+   {  
+      int ValueOne = 10;  
+      int ValueTwo = 20;           
+      Console.WriteLine("The Value is: {0}", Add(ValueOne, ValueTwo));  
+      return 0;  
+   }  
+   public static int Add(int One, int Two)  
+   {  
+      return (One + Two);  
+   }  
+}  
+```  
+  
+ このコードを実行すると、ランタイムがモジュールをメモリに読み込み、このクラスのメタデータを調べます。  モジュールを読み込んだ後、ランタイムはメソッドの Microsoft Intermediate Language \(MSIL\) ストリームを詳細に分析して、そのストリームを高速のネイティブ機械語命令に変換します。  ランタイムはジャスト イン タイム \(JIT\) コンパイラを使用して、それぞれのメソッドを必要なときに 1 つずつ、MSIL 命令からネイティブ マシン語コードに変換します。  
+  
+ 上記のコードの `Main` 関数によって生成された MSIL の一部の例を次に示します。  MSIL とメタデータは、[MSIL 逆アセンブラー \(Ildasm.exe\)](../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用することにより、任意の .NET Framework アプリケーションから表示できます。  
+  
+```  
+.entrypoint  
+.maxstack  3  
+.locals ([0] int32 ValueOne,  
+         [1] int32 ValueTwo,  
+         [2] int32 V_2,  
+         [3] int32 V_3)  
+IL_0000:  ldc.i4.s   10  
+IL_0002:  stloc.0  
+IL_0003:  ldc.i4.s   20  
+IL_0005:  stloc.1  
+IL_0006:  ldstr      "The Value is: {0}"  
+IL_000b:  ldloc.0  
+IL_000c:  ldloc.1  
+IL_000d:  call int32 ConsoleApplication.MyApp::Add(int32,int32) /* 06000003 */  
+```  
+  
+ JIT コンパイラはこのメソッド全体の MSIL を読み取って詳細に分析し、このメソッドの効率的なネイティブ命令を生成します。  `IL_000d`で、`Add` メソッドのメタデータ トークン \(`/*` `06000003 */`\) が検出されます。ランタイムは、このトークンを使用して **MethodDef** テーブルの 3 行目を調べます。  
+  
+ **メソッドが記述されているメタデータ トークンによって参照される、`Add`MethodDef** テーブルの一部の例を次の表に示します。  このアセンブリにはほかにもメタデータ テーブルが存在し、それぞれ独自の値を持っていますが、ここでは、このテーブルだけを参照します。  
+  
+|行|Relative Virtual Address \(RVA\)|ImplFlags|フラグ|名前<br /><br /> \(文字列ヒープを指す\)|Signature \(BLOB ヒープを指す\)|  
+|-------|--------------------------------------|---------------|---------|--------------------------|-------------------------------|  
+|1|0x00002050|IL<br /><br /> マネージ|パブリック<br /><br /> ReuseSlot<br /><br /> SpecialName<br /><br /> RTSpecialName<br /><br /> .ctor|.ctor \(コンストラクター\)||  
+|2|0x00002058|IL<br /><br /> マネージ|パブリック<br /><br /> スタティック<br /><br /> ReuseSlot|Main|文字列|  
+|3|0x0000208c|IL<br /><br /> マネージ|パブリック<br /><br /> スタティック<br /><br /> ReuseSlot|追加|int, int, int|  
+  
+ このテーブルの各列には、コードについての重要な情報が格納されています。  ランタイムは **RVA**列を使用して、このメソッドを定義する MSIL の開始メモリ アドレスを計算します。  **ImplFlags** および **Flags** 列には、このメソッドを記述するビットマスク \(たとえば、メソッドがパブリックかプライベートかを記述するビットマスク\) が格納されています。  **Name** 列は、文字列ヒープからメソッドの名前へのインデックスとなります。  **Signature** 列は、BLOB ヒープ内のメソッドのシグネチャ定義へのインデックスとなります。  
+  
+ ランタイムは 3 行目の **RVA** 列から必要なオフセット アドレスを計算し、計算したオフセット アドレスを JIT コンパイラに返します。JIT コンパイラは計算された新しいアドレスに移動します。  JIT コンパイラは、新しいアドレスから、別のメタデータ トークンを検出するまで MSIL の処理を続行し、処理を繰り返します。  
+  
+ ランタイムは、メタデータを使用することにより、コードを読み込み、ネイティブ機械語命令に変換するのに必要なすべての情報にアクセスできます。  このように、メタデータによって自己言及的なファイルが使用可能になり、メタデータと共通型システムを組み合わせて使用することで、言語間で継承が可能になります。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[属性](../../docs/standard/attributes/index.md)|属性の適用方法、カスタム属性の記述方法、および属性に格納されている情報の取得方法を説明します。|
\ No newline at end of file
diff --git a/docs/standard/numerics.md b/docs/standard/numerics.md
index d8f83798720..829f453a122 100644
--- a/docs/standard/numerics.md
+++ b/docs/standard/numerics.md
@@ -1,78 +1,85 @@
 ---
-title: ".NET Core における数値"
-description: ".NET Core における数値"
-keywords: .NET, .NET Core
-author: rpetrusha
-ms.author: ronpet
-ms.date: 06/20/2016
-ms.topic: article
-ms.prod: .net
-ms.technology: dotnet-standard
-ms.devlang: dotnet
-ms.assetid: 6b8696be-55f5-4b66-98f3-69ff827c2c49
-translationtype: Human Translation
-ms.sourcegitcommit: 90fe68f7f3c4b46502b5d3770b1a2d57c6af748a
-ms.openlocfilehash: 8e2aad830bdaccad6e8184fa462dd0d3157fd6c9
-ms.lasthandoff: 03/02/2017
-
----
-
-# <a name="numerics-in-net-core"></a>.NET Core における数値
-
-.NET Core は、標準の数値整数と浮動小数点プリミティブをサポートしています。さらに、理論上の上限や下限のない整数型の [System.Numerics.BigInteger](https://docs.microsoft.com/dotnet/core/api/System.Numerics.BigInteger)、複素数を表す型の [System.Numerics.Complex](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Complex)、[System.Numerics](https://docs.microsoft.com/dotnet/core/api/System.Numerics) 名前空間の Single Instruction Multiple Data ([SIMD](https://en.wikipedia.org/wiki/SIMD)) 対応ベクター型のセットもサポートしています。 
-
-## <a name="integral-types"></a>整数型
-
-.NET Core は、1 バイトから&8; バイトの長さの、符号付き整数と符号なし整数の両方をサポートしています。 次の表では、整数型とそのサイズをリストし、符号付きか符号なしかを示し、その範囲を記述しています。 すべての整数は、値型です。 
-
-型 | 符号付き/符号なし | サイズ (バイト) | 最小値 | 最大値
----- | --------------- | ------------ | ------------- | -------------
-[System.Byte](https://docs.microsoft.com/dotnet/core/api/System.Byte) | 符号なし | 1 | 0 | 255
-[System.Int16](https://docs.microsoft.com/dotnet/core/api/System.Int16) | 符号付き | 2 | -32,768 | 32,767
-[System.Int32](https://docs.microsoft.com/dotnet/core/api/System.Int32) | 符号付き | 4 | -2,147,483,648 | 2,147,483,647
-[System.Int64](https://docs.microsoft.com/dotnet/core/api/System.Int64) | 符号付き | 9 | -9,223,372,036,854,775,808 | 9,223,372,036,854,775,807
-[System.SByte](https://docs.microsoft.com/dotnet/core/api/System.SByte) | 符号付き | 1 | -128 | 127
-[System.UInt16](https://docs.microsoft.com/dotnet/core/api/System.UInt16) | 符号なし | 2 | 0 | 65,535
-[System.UInt32](https://docs.microsoft.com/dotnet/core/api/System.UInt32) | 符号なし | 4 | 0 | 4,294,967,295
-[System.UInt64](https://docs.microsoft.com/dotnet/core/api/System.UInt64) | 符号なし | 9 | 0 | 18,446,744,073,709,551,615
-
-各整数型は、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。 各整数には、等価比較と相対比較、数値の文字列形式から整数への変換、および整数から文字列形式への変換を実行するメソッドも含まれています。 丸め処理や&2; つの整数のより小さいか大きい値の識別など、標準の演算子によって処理される上記以外の数値演算は、[System.Math](https://docs.microsoft.com/dotnet/core/api/System.Math) クラスから使用可能です。 [System.BitConverter](https://docs.microsoft.com/dotnet/core/api/System.BitConverter) クラスを使用して、整数値の個々のビットを操作することもできます。 
-     
-符号なし整数型が CLS に準拠していないことに注意してください。 詳細については、[.NET 共通型システムと共通言語仕様](common-type-system.md)に関するページを参照してください。
-
-## <a name="floating-point-types"></a>浮動小数点型
-
-.NET Core には、次の表に示す&3; つプリミティブ浮動小数点型が含まれています。 
-
-型 | サイズ (バイト) | 最小値 | 最大値
----- | ------------ | ------------- | -------------
-[System.Double](https://docs.microsoft.com/dotnet/core/api/System.Double) | 9 | -1.79769313486232e308 | 1.79769313486232e308
-[System.Single](https://docs.microsoft.com/dotnet/core/api/System.Single) | 4 | -3.402823e38 | 3.402823e38
-[System.Decimal](https://docs.microsoft.com/dotnet/core/api/System.Decimal) | 16 | -79,228,162,514,264,337,593,543,950,335 | 79,228,162,514,264,337,593,543,950,335
-   
-各浮動小数点型は、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。 それぞれには、等価比較と相対比較、数値の文字列形式から浮動小数点数への変換、および浮動小数点数から文字列形式への変換を実行するメソッドも含まれています。 いくつかの追加の数学、代数、および三角関数の演算も、`Math` クラスから使用可能です。 `BitConverter` クラスを使用して、`Double` および `Single` の値の個々のビットを操作することもできます。 `Decimal` 構造体には、10 進値の個々のビットを操作するための独自のメソッド (`Decimal.GetBits` と `Decimal.Decimal(Int32())`)、および追加の数学演算を実行するための独自のメソッド セットがあります。 
-
-`Double` と `Single` の型は、本来正確ではない値 (太陽系の&2; つの星の間の距離など)、および高い精度や小さな丸め誤差の検出が必要ではないアプリケーションでの使用が想定されています。 より高い精度が要求され、丸め誤差が許容されないケースでは、`Decimal` 型を使用する必要があります。
-
-## <a name="biginteger"></a>BigInteger
-
-[System.Numerics.BigInteger](https://docs.microsoft.com/dotnet/core/api/System.Numerics.BigInteger) は、理論的には値に上限や下限がない、サイズの大きい任意の整数を表す不変の型です。 `BigInteger` 型のメソッドは、他の整数型のメソッドとかなり類似しています。  
-
-## <a name="complex"></a>複合
-
-[System.Numerics.Complex](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Complex) 型は、複素数つまり実数部と虚数部のある数を表します。 これは、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。さらに数学、代数、および三角関数のメソッドもサポートします。 
-
-## <a name="simd-enabled-vector-types"></a>SIMD 対応ベクター型
-
-`System.Numerics` 名前空間には、.NET Core 用の SIMD 対応ベクター型のセットが含まれています。 SIMD では、一部の操作をハードウェア レベルで並列に処理できます。その結果、ベクターに対して計算を実行する数値演算アプリ、科学系アプリ、グラフィックス アプリでは、パフォーマンスが大幅に向上します。 
-
-.NET Core の SIMD 対応ベクター型には、次のものが含まれます。 
-
-* `Single` 型の 2、3、および 4 次元ベクターである [System.Numerics.Vector2](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Vector2)、[System.Numerics.Vector3](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Vector3)、および [System.Numerics.Vector4](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Vector4)。
-
-* 任意のプリミティブな数値型のベクターを作成できる [Vector&lt;T&gt;](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Vector-1) 構造体。 プリミティブな数値型には、Decimal を除く System 名前空間のすべての数値型が含まれます。
-
-* 3 x 2 行列を表す [System.Numerics.Matrix3x2](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Matrix3x2) と、4 x 4 行列を表す [System.Numerics.Matrix4x4](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Matrix4x4) の 2 つのマトリックス型。 
-
-* 3 次元平面を表す [System.Numerics.Plane](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Plane) 型と&3; 次元物理回転をエンコードするために使用されるベクターを表す [System.Numerics.Quaternion](https://docs.microsoft.com/dotnet/core/api/System.Numerics.Quaternion) 型。
-
+title: ".NET Framework における数値 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "SIMD"
+  - "System.Numerics.Vectors"
+  - "ベクター"
+  - "指数計算"
+  - "複合"
+  - "数値"
+  - "BigInteger"
+ms.assetid: dfebc18e-acde-4510-9fa7-9a0f4aa3bd11
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# .NET Framework における数値
+.NET Framework が、標準数値整数と浮動小数点型のプリミティブをサポートしているだけでなく<xref:System.Numerics.BigInteger>、整数型の理論上の上限や下限のない<xref:System.Numerics.Complex>、複素数を表す型およびの SIMD が有効なベクター型のセット、 <xref:System.Numerics>名前空間。  
+  
+ さらに、System.Numerics.Vectors vectory 型の SIMD が有効なライブラリは、NuGet パッケージとしてリリースされました。  
+  
+## <a name="integral-types"></a>整数型  
+ .NET Framework は、1 バイトから&8; バイトの長さの、符号付き整数と符号なし整数の両方をサポートしています。 次の表では、整数型とそのサイズをリストし、符号付きか符号なしかを示し、その範囲を記述しています。 すべての整数は、値型です。  
+  
+|型|符号付き/符号なし|サイズ (バイト)|最小値|最大値|  
+|----------|----------------------|--------------------|-------------------|-------------------|  
+|<xref:System.Byte?displayProperty=fullName>|符号なし|1|0|255|  
+|<xref:System.Int16?displayProperty=fullName>|符号付き|2|-32,768|32,767|  
+|<xref:System.Int32?displayProperty=fullName>|符号付き|4|-2,147,483,648|2,147,483,647|  
+|<xref:System.Int64?displayProperty=fullName>|符号付き|9|-9,223,372,036,854,775,808|9,223,372,036,854,775,807|  
+|<xref:System.SByte?displayProperty=fullName>|符号付き|1|-128|127|  
+|<xref:System.UInt16?displayProperty=fullName>|符号なし|2|0|65,535|  
+|<xref:System.UInt32?displayProperty=fullName>|符号なし|4|0|4,294,967,295|  
+|<xref:System.UInt64?displayProperty=fullName>|符号なし|9|0|18,446,744,073,709,551,615|  
+  
+ 各整数型は、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。 各整数には、等価比較と相対比較、数値の文字列形式から整数への変換、および整数から文字列形式への変換を実行するメソッドも含まれています。 以外の数値演算など処理される標準の演算子によって丸め処理や&2; つの整数のより小さいか大きい値の識別はから利用可能な<xref:System.Math>クラスです。 使用して個々 のビット整数の値も扱える、 <xref:System.BitConverter>クラスです。  
+  
+ 符号なし整数型が CLS に準拠していないことに注意してください。 詳細については、次を参照してください。[言語非依存および言語非依存コンポーネント](../../docs/standard/language-independence-and-language-independent-components.md)します。  
+  
+## <a name="floating-point-types"></a>浮動小数点型  
+ .NET Framework には、次の表にリストされている&3; つプリミティブ浮動小数点型が含まれています。  
+  
+|型|サイズ (バイト単位)|最小要件|最大|  
+|----------|-----------------------|-------------|-------------|  
+|<xref:System.Double?displayProperty=fullName>|9|-1.79769313486232e308|1.79769313486232e308|  
+|<xref:System.Single?displayProperty=fullName>|4|-3.402823e38|3.402823e38|  
+|<xref:System.Decimal?displayProperty=fullName>|16|-79,228,162,514,264,337,593,543,950,335|79,228,162,514,264,337,593,543,950,335|  
+  
+ 各浮動小数点型は、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。 それぞれには、等価比較と相対比較、数値の文字列形式から浮動小数点数への変換、および浮動小数点数から文字列形式への変換を実行するメソッドも含まれています。 いくつかの追加の数学、代数、および三角関数演算もから利用可能な<xref:System.Math>クラスです。 また、個別のビットを使用することができます<xref:System.Double>と<xref:System.Single>を使用して値、 <xref:System.BitConverter>クラスです。 <xref:System.Decimal?displayProperty=fullName>構造体には独自のメソッド<xref:System.Decimal.GetBits%2A?displayProperty=fullName>と[Decimal.Decimal (Int32\<xref:System.Decimal.%23ctor%28System.Int32%5B%5D%29?displayProperty=fullName>、10 進数の値を扱っての個々 のビット単位だけでなく、独自の数値演算を実行するためのメソッドのセットです。  
+  
+ <xref:System.Double>と<xref:System.Single>性質がない値 (太陽系の&2; つの星の間の距離) などの正確なおよびを高い精度や小さな丸め誤差の不要なアプリケーションを使用する型が想定されています。 使用する必要があります、 <xref:System.Decimal?displayProperty=fullName>より高い内のケースの型は、精度が要求され、エラーの丸め処理を行うには、  
+  
+## <a name="biginteger"></a>BigInteger  
+ <xref:System.Numerics.BigInteger?displayProperty=fullName> は、理論的には値に上限や下限がない、サイズの大きい任意の整数を表す不変の型です。 メソッド、 <xref:System.Numerics.BigInteger>型とかなり類似して、他の整数型。  
+  
+## <a name="complex"></a>複合  
+ <xref:System.Numerics.Complex>型は、複素数つまり実数部と虚数部で番号を表します。 これは、算術、比較、等価、明示的な変換、および暗黙的な変換の演算子の標準セットをサポートします。さらに数学、代数、および三角関数のメソッドもサポートします。  
+  
+## <a name="simd-enabled-vector-types"></a>SIMD 対応ベクター型  
+ <xref:System.Numerics>名前空間には、.NET Framework 用の SIMD が有効なベクター型のセットが含まれています。 SIMD (Single Instruction Multiple Data operations) では、一部の操作をハードウェア レベルで並列に処理できます。その結果、ベクターに対して計算を実行する数値演算アプリ、科学系アプリ、グラフィックス アプリでは、パフォーマンスが大幅に向上します。  
+  
+ .NET Framework の SIMD 対応ベクター型には、次のものが含まれます。  さらに、System.Numerics.Vectors には、平面型と四元数型が含まれます。  
+  
+-   <xref:System.Numerics.Vector2>、 <xref:System.Numerics.Vector3>、および<xref:System.Numerics.Vector4> 2、3、および型の 4 次元ベクトルである型<xref:System.Single>します。  
+  
+-   2 つのマトリックス型<xref:System.Numerics.Matrix3x2>、3 × 2 行列を表すと<xref:System.Numerics.Matrix4x4>、4 × 4 行列を表します。  
+  
+-   <xref:System.Numerics.Plane>と<xref:System.Numerics.Quaternion>型です。  
+  
+ SimD 対応のベクター型は IL に実装されているので、これを SimD 非対応のハードウェアや JIT コンパイラで使用できます。 SIMD 命令の利点を活用するために、64 ビットのアプリはマネージ コード用の新しい 64 ビット JIT コンパイラ (.NET Framework 4.6 に含まれる) でコンパイルする必要があります。これは、x64 プロセッサがターゲットの場合に SIMD のサポートを追加します。  
+  
+ として SIMD をダウンロードすることも、 [NuGet パッケージ](http://www.nuget.org/packages/System.Numerics.Vectors)します。  NuGET パッケージは、ジェネリック型も含まれています。<xref:System.Numerics.Vector%601>構造体の任意のプリミティブ数値型のベクターを作成することができます。 (プリミティブ数値型のすべての数値型を含む、<xref:System>以外の名前空間<xref:System.Decimal>)。さらに、<xref:System.Numerics.Vector%601>構造体には、ベクターを使用する場合に呼び出すことのできる便利なメソッドのライブラリが用意されています。  
+  
+## <a name="see-also"></a>関連項目  
+ [アプリケーションの基本事項](../../docs/standard/application-essentials.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-processing-and-concurrency.md b/docs/standard/parallel-processing-and-concurrency.md
new file mode 100644
index 00000000000..95c7e457015
--- /dev/null
+++ b/docs/standard/parallel-processing-and-concurrency.md
@@ -0,0 +1,44 @@
+---
+title: "Parallel Processing and Concurrency in the .NET Framework | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET Framework, parallel processing"
+  - "parallel processing [.NET Framework]"
+  - "concurrency [.NET Framework]"
+  - ".NET Framework, concurrency"
+ms.assetid: e573faa8-0212-44b1-a850-ce85dc54f47f
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Parallel Processing and Concurrency in the .NET Framework
+.NET Framework には、ユーザーのコンピューターのパフォーマンスを最大化しながら、アプリケーションのユーザーに対する応答性を維持するために、複数の実行スレッドを使用する方法がいくつか用意されています。  
+  
+## このセクションの内容  
+ [Threading](../../docs/standard/threading/index.md)  
+ .NET Framework に用意されている基本的な同時実行および同期のための機構について説明します。  
+  
+ [Asynchronous Programming Patterns](../../docs/standard/asynchronous-programming-patterns/index.md)  
+ .NET Framework でサポートされている 3 種類の非同期パターンのプログラミングの概要が記載されています。  
+  
+-   [Asynchronous Programming Model \(APM\)](../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md) \(レガシ\)  
+  
+-   [Event\-based Asynchronous Pattern \(EAP\)](../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md) \(レガシ\)  
+  
+-   [Task\-based Asynchronous Pattern \(TAP\)](../../docs/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md) \(新規開発に推奨\)  
+  
+ [Parallel Programming](../../docs/standard/parallel-programming/index.md)  
+ 並行開発を簡素化し、スレッドやスレッド プールを直接操作することなく、効率的で詳細かつスケーラブルな並列コードを自然な表現方法で記述できるようになるタスク ベースのプログラミング モデルについて説明します。  
+  
+## 参照  
+ [開発ガイド](../../docs/framework/development-guide.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/TOC.md b/docs/standard/parallel-programming/TOC.md
new file mode 100644
index 00000000000..2a8e72bc8e9
--- /dev/null
+++ b/docs/standard/parallel-programming/TOC.md
@@ -0,0 +1,64 @@
+# [How to: Perform Action When a Dataflow Block Receives Data](how-to-perform-action-when-a-dataflow-block-receives-data.md)
+# [How to: Cancel a Dataflow Block](how-to-cancel-a-dataflow-block.md)
+# [How to: Implement a Partitioner for Static Partitioning](how-to-implement-a-partitioner-for-static-partitioning.md)
+# [How to: Wrap EAP Patterns in a Task](how-to-wrap-eap-patterns-in-a-task.md)
+# [Introduction to PLINQ](introduction-to-plinq.md)
+# [How to: Use JoinBlock to Read Data From Multiple Sources](how-to-use-joinblock-to-read-data-from-multiple-sources.md)
+# [Merge Options in PLINQ](merge-options-in-plinq.md)
+# [TPL and Traditional .NET Framework Asynchronous Programming](tpl-and-traditional-async-programming.md)
+# [How to: Specify the Execution Mode in PLINQ](how-to-specify-the-execution-mode-in-plinq.md)
+# [How to: Specify the Degree of Parallelism in a Dataflow Block](how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md)
+# [How to: Write a Simple Parallel.ForEach Loop](how-to-write-a-simple-parallel-foreach-loop.md)
+# [Attached and Detached Child Tasks](attached-and-detached-child-tasks.md)
+# [How to: Implement Dynamic Partitions](how-to-implement-dynamic-partitions.md)
+# [How to: Speed Up Small Loop Bodies](how-to-speed-up-small-loop-bodies.md)
+# [How to: Control Ordering in a PLINQ Query](how-to-control-ordering-in-a-plinq-query.md)
+# [How to: Return a Value from a Task](how-to-return-a-value-from-a-task.md)
+# [How to: Prevent a Child Task from Attaching to its Parent](how-to-prevent-a-child-task-from-attaching-to-its-parent.md)
+# [例外処理](exception-handling-task-parallel-library.md)
+# [Data Structures for Parallel Programming](data-structures-for-parallel-programming.md)
+# [Task Parallel Library (TPL)](task-parallel-library-tpl.md)
+# [How to: Create Pre-Computed Tasks](how-to-create-pre-computed-tasks.md)
+# [Walkthrough: Creating a Custom Dataflow Block Type](walkthrough-creating-a-custom-dataflow-block-type.md)
+# [How to: Unwrap a Nested Task](how-to-unwrap-a-nested-task.md)
+# [How to: Cancel a Parallel.For or ForEach Loop](how-to-cancel-a-parallel-for-or-foreach-loop.md)
+# [Walkthrough: Using Dataflow in a Windows Forms Application](walkthrough-using-dataflow-in-a-windows-forms-application.md)
+# [For Further Reading](for-further-reading-parallel-programming.md)
+# [How to: Create and Execute a Simple PLINQ Query](how-to-create-and-execute-a-simple-plinq-query.md)
+# [Custom Partitioners for PLINQ and TPL](custom-partitioners-for-plinq-and-tpl.md)
+# [How to: Write a Simple Parallel.For Loop](how-to-write-a-simple-parallel-for-loop.md)
+# [How to: Handle Exceptions in a PLINQ Query](how-to-handle-exceptions-in-a-plinq-query.md)
+# [How to: Cancel a PLINQ Query](how-to-cancel-a-plinq-query.md)
+# [Using TPL with Other Asynchronous Patterns](using-tpl-with-other-asynchronous-patterns.md)
+# [Potential Pitfalls with PLINQ](potential-pitfalls-with-plinq.md)
+# [How to: Use Parallel.Invoke to Execute Parallel Operations](how-to-use-parallel-invoke-to-execute-parallel-operations.md)
+# [Walkthrough: Creating a Dataflow Pipeline](walkthrough-creating-a-dataflow-pipeline.md)
+# [How to: Write a Parallel.For Loop with Thread-Local Variables](how-to-write-a-parallel-for-loop-with-thread-local-variables.md)
+# [Lambda Expressions in PLINQ and TPL](lambda-expressions-in-plinq-and-tpl.md)
+# [データフロー](dataflow-task-parallel-library.md)
+# [Walkthrough: Using BatchBlock and BatchedJoinBlock to Improve Efficiency](walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md)
+# [How to: Write a Custom PLINQ Aggregate Function](how-to-write-a-custom-plinq-aggregate-function.md)
+# [方法: Parallel クラスを使用してファイル ディレクトリを反復処理する](how-to-iterate-file-directories-with-the-parallel-class.md)
+# [Understanding Speedup in PLINQ](understanding-speedup-in-plinq.md)
+# [How to: Handle Exceptions in Parallel Loops](how-to-handle-exceptions-in-parallel-loops.md)
+# [PLINQ Data Sample](plinq-data-sample.md)
+# [Parallel Programming](index.md)
+# [How to: Measure PLINQ Query Performance](how-to-measure-plinq-query-performance.md)
+# [How to: Implement a Producer-Consumer Dataflow Pattern](how-to-implement-a-producer-consumer-dataflow-pattern.md)
+# [Task Parallelism](task-based-asynchronous-programming.md)
+# [How to: Traverse a Binary Tree with Parallel Tasks](how-to-traverse-a-binary-tree-with-parallel-tasks.md)
+# [How to: Unlink Dataflow Blocks](how-to-unlink-dataflow-blocks.md)
+# [Data Parallelism](data-parallelism-task-parallel-library.md)
+# [Task Cancellation](task-cancellation.md)
+# [Parallel LINQ (PLINQ)](parallel-linq-plinq.md)
+# [Parallel Diagnostic Tools](parallel-diagnostic-tools.md)
+# [How to: Iterate File Directories with PLINQ](how-to-iterate-file-directories-with-plinq.md)
+# [How to: Specify a Task Scheduler in a Dataflow Block](how-to-specify-a-task-scheduler-in-a-dataflow-block.md)
+# [How to: Write a Parallel.ForEach Loop with Thread-Local Variables](how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md)
+# [Potential Pitfalls in Data and Task Parallelism](potential-pitfalls-in-data-and-task-parallelism.md)
+# [How to: Write Messages to and Read Messages from a Dataflow Block](how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md)
+# [How to: Combine Parallel and Sequential LINQ Queries](how-to-combine-parallel-and-sequential-linq-queries.md)
+# [Order Preservation in PLINQ](order-preservation-in-plinq.md)
+# [How to: Specify Merge Options in PLINQ](how-to-specify-merge-options-in-plinq.md)
+# [Chaining Tasks by Using Continuation Tasks](chaining-tasks-by-using-continuation-tasks.md)
+# [How to: Cancel a Task and Its Children](how-to-cancel-a-task-and-its-children.md)
diff --git a/docs/standard/parallel-programming/attached-and-detached-child-tasks.md b/docs/standard/parallel-programming/attached-and-detached-child-tasks.md
new file mode 100644
index 00000000000..b74dba6c968
--- /dev/null
+++ b/docs/standard/parallel-programming/attached-and-detached-child-tasks.md
@@ -0,0 +1,84 @@
+---
+title: "Attached and Detached Child Tasks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, child tasks"
+ms.assetid: c95788bf-90a6-4e96-b7bc-58e36a228cc5
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# Attached and Detached Child Tasks
+*子タスク* \(または*入れ子のタスク*\) は、<xref:System.Threading.Tasks.Task?displayProperty=fullName>親タスクと呼ばれる、別のタスクのユーザー デリゲートで作成された、 *のインスタンスです。* 子タスクはデタッチまたはアタッチできます。  *デタッチされた子タスク*は、親とは独立して実行されるタスクです。   *アタッチされた子タスク* は、<xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションで作成される入れ子式のタスクです。その親は、明示的にも既定でも、子タスクがアタッチされることを禁止しません。  タスクでは、システム リソースが許す限り、任意の数のアタッチされた子タスクおよびデタッチされた子タスクを作成できます。  
+  
+ 以下の表に、2 種類の子タスクの基本的な相違点を示します。  
+  
+|カテゴリ|デタッチされた子タスク|アタッチされた子タスク|  
+|----------|-----------------|-----------------|  
+|親は子タスクが完了するまで待機します。|いいえ|はい|  
+|親は子タスクによってスローされた例外を反映します。|いいえ|はい|  
+|親のステータスは子のステータスに依存します。|いいえ|はい|  
+  
+ ほとんどの場合、デタッチされた子タスクを使用することをお勧めします。他のタスクとの関係は複雑度が低いためです。  こうした理由から、既定では親タスク内に作成されたタスクはデタッチされており、アタッチされた子タスクを作成する場合は <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを明示的に指定する必要があります。  
+  
+## デタッチされた子タスク  
+ 子タスクは親タスクによって作成されますが、既定では親タスクに依存しません。  次の例では、親タスクが単に 1 つの子タスクを作成します。  このコード例を複数回実行すると、出力がここに示したものとは異なり、またコードを実行するたびに出力が変わる場合があることに気付くことがあります。  これは親タスクと子タスクが、それぞれ独立して実行されるために生じます。子タスクはデタッチされたタスクです。  この例は親タスクの完了のみを待機します。コンソール アプリが終了する前には、子タスクは実行または完了しないことがあります。  
+  
+ [!code-csharp[TPL_ChildTasks#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_childtasks/cs/nested1.cs#1)]
+ [!code-vb[TPL_ChildTasks#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_childtasks/vb/nested1.vb#1)]  
+  
+ 子タスクが <xref:System.Threading.Tasks.Task%601> オブジェクトではなく <xref:System.Threading.Tasks.Task> オブジェクトによって表される場合、デタッチされた子タスクであっても、子の <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティにアクセスして、親タスクが子タスクの完了を待機することを確認できます。  次の例に示すように、<xref:System.Threading.Tasks.Task%601.Result%2A> プロパティはタスクが完了するまでブロックします。  
+  
+ [!code-csharp[TPL_ChildTasks#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_childtasks/cs/childtasks.cs#4)]
+ [!code-vb[TPL_ChildTasks#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_childtasks/vb/tpl_childtasks.vb#4)]  
+  
+## アタッチされた子タスク  
+ デタッチされた子タスクとは異なり、アタッチされた子タスクは親と緊密に同期します。  次の例に示すように、タスクの作成ステートメントで <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用すると、前の例のデタッチされた子タスクを、アタッチされた子タスクに変更できます。  このコードでは、アタッチされた子タスクは親の前に完了します。  その結果、この例の出力結果は、コードを実行するたびに同じになります。  
+  
+ [!code-csharp[TPL_ChildTasks#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_childtasks/cs/child1.cs#2)]
+ [!code-vb[TPL_ChildTasks#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_childtasks/vb/child1.vb#2)]  
+  
+ アタッチされた子タスクを使用すると、非同期操作の厳密に同期されたグラフを作成できます。  
+  
+ ただし、その親タスクが子タスクのアタッチを禁止していない場合にのみ、子タスクは親タスクにアタッチできます。  親タスクは、親タスクのクラスのコンストラクターの <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションまたは <xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドで指定することで、明示的に子タスクが親タスクにアタッチできないようにすることができます。  親タスクが <xref:System.Threading.Tasks.Task.Run%2A?displayProperty=fullName> メソッドを呼び出して作成された場合、親タスクは暗黙的に子タスクをアタッチできないようにします。  次に例を示します。  親タスクが <xref:System.Threading.Tasks.TaskFactory.StartNew%28System.Action%29?displayProperty=fullName> メソッドではなく <xref:System.Threading.Tasks.Task.Run%28System.Action%29?displayProperty=fullName> メソッドを呼び出して作成される点を除き、これは前の例と同一です。  子タスクはその親にアタッチすることができないため、例からの出力は予測できません。  <xref:System.Threading.Tasks.Task.Run%2A?displayProperty=fullName> のオーバーロードにおける既定のタスクの作成オプションには <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> が含まれるため、この例は、「デタッチされた子タスク」セクションの最初の例と機能的に同等です。  
+  
+ [!code-csharp[TPL_ChildTasks#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_childtasks/cs/child1a.cs#3)]
+ [!code-vb[TPL_ChildTasks#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_childtasks/vb/child1a.vb#3)]  
+  
+## 子タスクでの例外  
+ デタッチされた子タスクが例外をスローする場合、その例外は入れ子でないタスクの場合と同様に監視するか、または親タスク内で直接処理する必要があります。  アタッチされた子タスクが例外をスローした場合、例外は自動的に親タスクに反映され、タスクの <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティへのアクセスを待機するか、アクセスを試みるスレッドに戻されます。  したがって、アタッチされた子タスクを使用することで、呼び出し元のスレッドの <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> の呼び出しの 1 つの場所ですべての例外を処理できます。  詳細については、「[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)」を参照してください。  
+  
+## キャンセルと子タスク  
+ タスクの取り消し処理は他の処理と連携して行われます。  つまり、キャンセル可能であるためには、すべてのアタッチされた子タスク、またはデタッチされた子タスクが、キャンセル トークンの状態を監視する必要があります。  1 つのキャンセル要求を使用して親とその子をすべて取り消す場合は、同じトークンをすべてのタスクに引数として渡し、各タスクの要求に応答するためのロジックを各タスクに提供します。  詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」および「[How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)」を参照してください。  
+  
+### 親が取り消された場合  
+ 子タスクが開始される前に親が取り消された場合、子は開始されません。  子タスクが既に開始された後に親が取り消された場合、子はそれ自体にキャンセル ロジックが適用されていない限り、完了まで実行されます。  詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」を参照してください。  
+  
+### デタッチされた子タスクが取り消された場合  
+ デタッチされた子タスクが、そのタ親に渡されたのと同じトークンを使用して取り消された場合、親は子タスクを待機せず、例外も反映されません。例外は、他の処理と連携したキャセル処理として扱われるためです。  この動作は最上位のタスクと同じです。  
+  
+### アタッチされた子タスクが取り消された場合  
+ アタッチされた子タスクが、その親タスクに渡されたのと同じトークンを使用して取り消された場合、<xref:System.Threading.Tasks.TaskCanceledException> が <xref:System.AggregateException> 内の連結されたスレッドに反映されます。  アタッチされた子タスクのグラフにまで反映されるすべてのエラーが発生している例外に加え、問題のないすべての例外も処理できるようにするため、親タスクを待機する必要があります。  
+  
+ 詳細については、「[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)」を参照してください。  
+  
+## 子タスクがその親にアタッチされないようにする  
+ 子タスクがスローした未処理の例外は親タスクに反映されます。  この動作を使うと、タスク ツリーを走査することなく、1 つのルート タスクのすべての子タスクの例外を確認することができます。  ただし、親タスクは他のコードからのアタッチを想定していない場合には、例外の反映は問題となる場合があります。  たとえば、<xref:System.Threading.Tasks.Task> オブジェクトのサードパーティ ライブラリのコンポーネントを呼び出すアプリケーションを考えてみます。  サードパーティのライブラリのコンポーネントが <xref:System.Threading.Tasks.Task> オブジェクトを作成し、親タスクにアタッチするように <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> を指定する場合は、子タスクで発生するハンドルされない例外はすべて親に反映されます。  これによりメイン アプリケーションで予期しない動作が発生することがあります。  
+  
+ 子タスクが親タスクにアタッチされないようにするには、親の <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> または <xref:System.Threading.Tasks.Task> オブジェクトを作成するときに、<xref:System.Threading.Tasks.Task%601> オプションを指定します。  タスクがその親にアタッチしようとし、親が <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを指定する場合、子タスクは親にアタッチされず、<xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションが指定されなかったかのように実行されます。  
+  
+ 子タスクが適時に完了しない場合には、子タスクがその親にアタッチしないようにすることをお勧めします。  親タスクは、すべての子タスクが終了するまで完了しないため、長時間実行される子タスクによって、アプリケーション全体のパフォーマンスの低下を生じる場合があります。  タスクがその親タスクにアタッチしないようにすることにより、アプリケーションのパフォーマンスを向上させる方法の例については、「[How to: Prevent a Child Task from Attaching to its Parent](../../../docs/standard/parallel-programming/how-to-prevent-a-child-task-from-attaching-to-its-parent.md)」を参照してください。  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md b/docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md
new file mode 100644
index 00000000000..0e3c2b082ef
--- /dev/null
+++ b/docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md
@@ -0,0 +1,154 @@
+---
+title: "Chaining Tasks by Using Continuation Tasks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, continuations"
+ms.assetid: 0b45e9a2-de28-46ce-8212-1817280ed42d
+caps.latest.revision: 30
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 30
+---
+# Chaining Tasks by Using Continuation Tasks
+非同期プログラミングでは、非同期操作で完了時に 2 番目の操作を呼び出してデータを渡すのが一般的です。 これまで、この処理はコールバック メソッドを使用して行っていました。 タスク並列ライブラリでは、*継続タスク*に同じ機能が用意されています。 継続タスク \(単に "継続" とも呼ばれます\) とは、別のタスク \("*継続元*" と呼ばれます\) が終了したときにそのタスクによって呼び出される非同期タスクのことです。  
+  
+ 継続は比較的簡単に使用できますが、強力な機能と柔軟性を備えています。 たとえば、次のように操作できます。  
+  
+-   継続元のデータを継続に渡します。  
+  
+-   継続を呼び出す場合、呼び出さない場合についての正確な条件を指定します。  
+  
+-   継続が開始される前、または継続の実行中に継続を取り消します。  
+  
+-   継続をスケジュールする方法についてのヒントを提供します。  
+  
+-   同じ継続元から複数の継続を呼び出します。  
+  
+-   複数の継続元のすべてまたはいずれか 1 つが完了したときに 1 つの継続を呼び出します。  
+  
+-   任意の長さで連続して継続を実行します。  
+  
+-   継続元によってスローされた例外を処理するために継続を使用します。  
+  
+## 継続について  
+ 継続とは、<xref:System.Threading.Tasks.TaskStatus> 状態で作成されるタスクです。 継続は、その継続元タスクが完了すると自動的に開始されます。 ユーザー コード内の継続で <xref:System.Threading.Tasks.Task.Start%2A?displayProperty=fullName> を呼び出すと、<xref:System.InvalidOperationException?displayProperty=fullName> 例外がスローされます。  
+  
+ 継続はそれ自体が <xref:System.Threading.Tasks.Task> であり、継続が開始されたスレッドをブロックするわけではありません。 継続タスクが終了するまでブロックするには、<xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+## 1 つの継続元に対する継続の作成  
+ <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> メソッドを呼び出して、継続元が完了した時点で実行される継続を作成します。 次の例は、基本的なパターンを示しています \(わかりやすくするために、例外処理は省略されています\)。 現在の曜日の名前を示す <xref:System.DayOfWeek> オブジェクトを返す継続元タスク `taskA` が実行されます。 継続元が完了すると、継続タスク `taskB` に継続元が渡され、その結果を示す文字列が表示されます。  
+  
+ [!code-csharp[TPL_Continuations#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/simple1.cs#1)]
+ [!code-vb[TPL_Continuations#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/simple1.vb#1)]  
+  
+## 複数の継続元に対する継続の作成  
+ タスク グループの一部または全部のタスクが完了したときに実行される継続を作成することもできます。 すべての継続元タスクが完了した時点で継続を実行するには、静的 \(Visual Basic では `Shared`\) <xref:System.Threading.Tasks.Task.WhenAll%2A?displayProperty=fullName> メソッドまたはインスタンス <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A?displayProperty=fullName> メソッドを呼び出します。 いずれかの継続元タスクが完了した時点で継続を実行するには、静的 \(Visual Basic では `Shared`\) <xref:System.Threading.Tasks.Task.WhenAny%2A?displayProperty=fullName> メソッドまたはインスタンス <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+ <xref:System.Threading.Tasks.Task.WhenAll%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Task.WhenAny%2A?displayProperty=fullName> オーバーロードの呼び出しによって、呼び出しスレッドがブロックされることはない点に注意してください。  ただし、通常、返された <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティを取得するために <xref:System.Threading.Tasks.Task.WhenAll%28System.Collections.Generic.IEnumerable%7BSystem.Threading.Tasks.Task%7D%29?displayProperty=fullName> メソッドと [Task.WhenAll\(Task\<xref:System.Threading.Tasks.Task.WhenAll%28System.Threading.Tasks.Task%5B%5D%29?displayProperty=fullName> メソッドを除いたすべてを呼び出しますが、そうした場合は呼び出しスレッドがブロックされます。  
+  
+ 次の例では、<xref:System.Threading.Tasks.Task.WhenAll%28System.Collections.Generic.IEnumerable%7BSystem.Threading.Tasks.Task%7D%29?displayProperty=fullName> メソッドを呼び出し、10 個の継続元タスクの結果を反映する継続タスクを作成します。 各継続元タスクは、1 から 10 までの範囲内のインデックス値を二乗します。 継続元が正常に完了すると \(その <xref:System.Threading.Tasks.Task.Status%2A?displayProperty=fullName> プロパティが <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName>\)、継続の <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティは、各継続元から返される <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> 値の配列になります。 この例では、1 から 10 までのすべての数値の二乗の合計を計算するため、これらを追加します。  
+  
+ [!code-csharp[TPL_Continuations#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/whenall1.cs#5)]
+ [!code-vb[TPL_Continuations#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/whenall1.vb#5)]  
+  
+## 継続のオプション  
+ 単一タスクの継続を作成する場合、<xref:System.Threading.Tasks.Task.ContinueWith%2A> 列挙体の値を取得する <xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> オーバーロードを使用して、継続の開始条件を指定できます。 たとえば、継続元が正常に完了した場合のみ、または違反状態で完了した場合にのみ継続を実行するように指定できます。 継続元で継続を呼び出す準備ができているときに条件が true でない場合、継続は直接 <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態に遷移し、継続タスクを開始できません。  
+  
+ 複数タスク継続メソッド \(<xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A?displayProperty=fullName> メソッドのオーバーロードなど\) の多くには、<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> パラメーターも含まれています。 ただし、すべての <xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> 列挙体メンバーのサブセットだけが有効です。<xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> 列挙体に対応する値がある <xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> 値を指定できます \(<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName>、<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName>、<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> など\)。 複数タスクの継続で `NotOn` または `OnlyOn` オプションのいずれかを指定すると、実行時に <xref:System.ArgumentOutOfRangeException> 例外がスローされます。  
+  
+ タスクの継続のオプションの詳細については、「<xref:System.Threading.Tasks.TaskContinuationOptions>」を参照してください。  
+  
+## 継続へのデータの受け渡し  
+ <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> メソッドは、継続元への参照を、継続のユーザー デリゲートに引数として渡します。 継続元が <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> オブジェクトで、そのタスクが完了まで実行された場合、継続はそのタスクの <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティにアクセスできます。  
+  
+ <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティは、タスクが完了するまでブロックします。 ただし、タスクがキャンセルまたは違反になった場合は、<xref:System.Threading.Tasks.Task%601.Result%2A> プロパティにアクセスしようとすると <xref:System.AggregateException> 例外がスローされます。 この問題を回避するには、次の例で示すように <xref:System.Threading.Tasks.TaskContinuationOptions> オプションを使用します。  
+  
+ [!code-csharp[TPL_Continuations#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/result1.cs#2)]
+ [!code-vb[TPL_Continuations#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/result1.vb#2)]  
+  
+ 継続元が正常に完了するまで実行されなかった場合でも継続を実行する場合は、例外を防ぐ必要があります。 1 つの方法として、継続元の <xref:System.Threading.Tasks.Task.Status%2A?displayProperty=fullName> プロパティをテストし、状態が <xref:System.Threading.Tasks.TaskStatus> でも <xref:System.Threading.Tasks.TaskStatus> でもない場合にのみ <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティへのアクセスを試みるようにします。 また、継続元の <xref:System.Threading.Tasks.Task.Exception%2A> プロパティを調べることもできます。 詳細については、「[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)」を参照してください。 次の例では、前の例を変更して、状態が <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> の場合にだけ継続元の <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティにアクセスするようにします。  
+  
+ [!code-csharp[TPL_Continuations#7](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/result2.cs#7)]
+ [!code-vb[TPL_Continuations#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/result2.vb#7)]  
+  
+## 継続のキャンセル  
+ 継続の <xref:System.Threading.Tasks.Task.Status%2A?displayProperty=fullName> プロパティが <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態になるのは、次のような場合です。  
+  
+-   キャンセル要求への応答として <xref:System.OperationCanceledException> 例外をスローした場合。 他のタスクと同様に、例外には継続に渡されたのと同じトークンが含まれ、連携によるキャンセルの受信確認として扱われます。  
+  
+-   <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティが `true` である <xref:System.Threading.CancellationToken?displayProperty=fullName> が継続に渡された場合。 この場合、継続は開始されずに、<xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態に遷移します。  
+  
+-   継続の <xref:System.Threading.Tasks.TaskContinuationOptions> 引数により設定された条件が満たされないために、継続が実行されない場合。 たとえば、継続元が <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態になった場合、<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> オプションが渡された継続は <xref:System.Threading.Tasks.TaskStatus> 状態に遷移し、実行されません。  
+  
+ タスクとその継続が同じ論理的操作の 2 つの部分を表す場合は、次の例に示すように、同じキャンセル トークンを両方のタスクに渡すことができます。 これは、33 で割り切れる整数のリストを生成する継続元からなります。このリストは継続に渡されます。 次に継続により、このリストが表示されます。 継続元と継続の両方は、ランダムな間隔で定期的に一時停止します。 さらに、<xref:System.Threading.Timer?displayProperty=fullName> オブジェクトを使用して、5 秒のタイムアウト間隔の経過後に `Elapsed` メソッドが実行されます。<xref:System.Threading.CancellationTokenSource.Cancel%2A?displayProperty=fullName> メソッドが呼び出され、これにより現在実行中のタスクが <xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A?displayProperty=fullName> メソッドを呼び出します。 継続元またはその継続の実行時に <xref:System.Threading.CancellationTokenSource.Cancel%2A?displayProperty=fullName> メソッドが呼び出されるかどうかは、ランダムに生成される一時停止の期間に基づきます。 継続元が取り消された場合、継続は開始されません。 継続元が取り消されない場合は、継続を取り消すためにそのトークンを引き続き使用できます。  
+  
+ [!code-csharp[TPL_Continuations#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/cancellation1.cs#3)]
+ [!code-vb[TPL_Continuations#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/cancellation1.vb#3)]  
+  
+ また、継続の作成時に <xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> オプションを指定することで、キャンセル トークンを継続に指定せずに、継続元が取り消された場合に継続を実行しないようにできます。 単純な例を次に示します。  
+  
+ [!code-csharp[TPL_Continuations#8](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/cancellation2.cs#8)]
+ [!code-vb[TPL_Continuations#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/cancellation2.vb#8)]  
+  
+ 継続が <xref:System.Threading.Tasks.TaskStatus> 状態になると、それらの継続に指定された <xref:System.Threading.Tasks.TaskContinuationOptions> によっては後続の継続に影響を与える場合があります。  
+  
+ 破棄された継続は開始されません。  
+  
+## 継続タスクと子タスク  
+ 継続は、継続元とアタッチされたすべての子タスクが完了するまでは実行されません。 継続は、デタッチされた子タスクの終了は待機しません。 次の 2 つの例に、継続を作成する継続元にアタッチされる子タスクと、継続元からデタッチされる子タスクを示します。 次の例では、すべての子タスクの完了後にのみ継続が実行されます。この例を複数回実行する場合、出力は毎回同一になります。 この例では、<xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドを呼び出して継続元を起動していることに注意してください。これは、<xref:System.Threading.Tasks.Task.Run%2A?displayProperty=fullName> メソッドは、既定のタスク作成オプションが <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> である親タスクを既定で作成するためです。  
+  
+ [!code-csharp[TPL_Continuations#9](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/attached1.cs#9)]
+ [!code-vb[TPL_Continuations#9](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/attached1.vb#9)]  
+  
+ ただし子タスクが継続元からデタッチされると、子タスクの状態に関係なく、継続元が終了するとただちに継続が実行されます。 その結果、次の例を複数回実行すると、タスク スケジューラによる子タスクの処理方法に応じて、異なる出力が生成されることがあります。  
+  
+ [!code-csharp[TPL_Continuations#10](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/detached1.cs#10)]
+ [!code-vb[TPL_Continuations#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/detached1.vb#10)]  
+  
+ 継続元の最終的な状態は、アタッチされた子タスクの最終的な状態に依存します。 デタッチされた子タスクの状態は、親には影響しません。 詳細については、「[Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)」を参照してください。  
+  
+## 状態と継続の関連付け  
+ 任意の状態とタスクの継続を関連付けることができます。<xref:System.Threading.Tasks.Task.ContinueWith%2A> メソッドは、それぞれが継続の状態を表す <xref:System.Object> 値を受け取る、オーバーロードされたバージョンを提供します。 後でこの状態オブジェクトにアクセスするには、<xref:System.Threading.Tasks.Task.AsyncState%2A?displayProperty=fullName> プロパティを使用します。 値を指定しない場合、この状態オブジェクトは `null` です。  
+  
+ 継続の状態は、TPL を使用するために、[非同期プログラミング モデル \(APM\)](../../../docs/standard/asynchronous-programming-patterns/asynchronous-programming-model-apm.md) を使った既存のコードを変換する場合に有用です。 APM では通常、**Begin*Method*** メソッドでオブジェクト状態を指定し、後から <xref:System.IAsyncResult.AsyncState%2A?displayProperty=fullName> プロパティを使って、その状態にアクセスします。<xref:System.Threading.Tasks.Task.ContinueWith%2A> メソッドを使用すると、APM を使用するコードを TPL を使用するように変換するときに、この状態を維持できます。  
+  
+ 継続の状態は、<xref:System.Threading.Tasks.Task> デバッガーで [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] オブジェクトを使用するときにも有用です。 たとえば、**\[並列タスク\]** ウィンドウの **\[タスク\]** の列に、各タスクの状態オブジェクトの文字列表現が表示されます。**\[並列タスク\]** ウィンドウの詳細については、[\[タスク\] ウィンドウの使用](../Topic/Using%20the%20Tasks%20Window.md) を参照してください。  
+  
+ 継続の状態の使用方法を次の例に示します。 この例では、継続タスクのチェーンを作成します。 各タスクは <xref:System.DateTime> メソッドの `state` パラメーターの現在時刻である、<xref:System.Threading.Tasks.Task.ContinueWith%2A> オブジェクトを提供します。<xref:System.DateTime> の各オブジェクトは継続タスクが作成された時刻を表します。 各タスクは、結果として、タスクが終了する時刻を表す秒の <xref:System.DateTime> オブジェクトを生成します。 この例では、すべてのタスクが終了した後に、作成時刻および各継続タスクの終了時刻が表示されます。  
+  
+ [!code-csharp[TPL_ContinuationState#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuationstate/cs/continuationstate.cs#1)]
+ [!code-vb[TPL_ContinuationState#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuationstate/vb/continuationstate.vb#1)]  
+  
+## 継続からスローされた例外の処理  
+ 継続元と継続の関係は、親と子の関係とは異なります。 継続によってスローされた例外は継続元へは反映されません。 したがって、継続によってスローされた例外は、他のタスクでの処理と同様、次のように処理します。  
+  
+-   <xref:System.Threading.Tasks.Task.Wait%2A> メソッド、<xref:System.Threading.Tasks.Task.WaitAll%2A> メソッド、または <xref:System.Threading.Tasks.Task.WaitAny%2A> メソッドを使用するか、ジェネリック メソッドを使用して、継続での待機を指定します。 次の例に示すように、継続元とその継続は、同じ `try` ステートメントで待機できます。  
+  
+     [!code-csharp[TPL_Continuations#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/exception1.cs#6)]
+     [!code-vb[TPL_Continuations#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/exception1.vb#6)]  
+  
+-   最初の継続の <xref:System.Threading.Tasks.Task.Exception%2A> プロパティを確認するには、2 番目の継続を使用します。 次の例でタスクは、存在しないファイルからの読み取りを試行します。 その後、継続により、継続元タスクの例外に関する情報が表示されます。  
+  
+     [!code-csharp[TPL_Continuations#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/exception2.cs#4)]
+     [!code-vb[TPL_Continuations#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/exception2.vb#4)]  
+  
+     <xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> オプションを指定して実行されたため、継続が実行されるのは、継続元で例外が発生し、継続元の <xref:System.Threading.Tasks.Task.Exception%2A> プロパティが `null` ではないと推測できる場合だけです。 継続元で例外がスローされたかどうかに関係なく継続が実行される場合は、次のコード フラグメントに示すように、例外処理を試行する前に、継続元の <xref:System.Threading.Tasks.Task.Exception%2A> プロパティが `null` ではないことを確認する必要があります。  
+  
+     [!code-csharp[TPL_Continuations#11](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_continuations/cs/exception2.cs#11)]
+     [!code-vb[TPL_Continuations#11](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_continuations/vb/exception2.vb#11)]  
+  
+     詳細については、「[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)」および「[NIB: 方法: タスクがスローした例外を処理する](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)」を参照してください。  
+  
+-   アタッチされた子タスクで、<xref:System.Threading.Tasks.TaskContinuationOptions?displayProperty=fullName> オプションを使用して継続が作成された場合、アタッチされているその他の子と同様、その例外は親によって呼び出し元のスレッドに反映されます。 詳細については、「[Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)」を参照してください。  
+  
+## 参照  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md b/docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md
new file mode 100644
index 00000000000..26581413b6a
--- /dev/null
+++ b/docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md
@@ -0,0 +1,127 @@
+---
+title: "Custom Partitioners for PLINQ and TPL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, partitioners"
+ms.assetid: 96153688-9a01-47c4-8430-909cee9a2887
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Custom Partitioners for PLINQ and TPL
+データ ソース上で操作を並列化する場合の必須の手順の 1 つは、ソースを複数のスレッドによって同時にアクセスできる複数のセクションに*パーティション分割*することです。  PLINQ およびタスク並列ライブラリ \(TPL: Task Parallel Library\) には、並列クエリまたは <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループを記述するときに透過的に機能する既定のパーティショナーが用意されています。  より高度なシナリオでは、独自のパーティショナーをプラグインできます。  
+  
+## パーティション分割の種類  
+ データ ソースは、さまざまな方法でパーティション分割できます。  最も効率的なのは、ソースを複数のサブシーケンスに物理的に分離するのではなく、複数のスレッドが協調して元のソース シーケンスを処理する方法です。  配列や、長さが事前にわかっている <xref:System.Collections.IList> コレクションなどの他のインデックス付きソースの場合は、*範囲パーティション分割*が最も簡単なパーティション分割です。  各スレッドは、一意の開始インデックスおよび終了インデックスを受け取ります。そのため、他のスレッドで上書きしたり、上書きされたりすることなく、ソースの範囲を処理できます。  範囲パーティション分割に伴う唯一のオーバーヘッドは、最初に範囲を作成する作業です。その後は、追加の同期は不要です。  したがって、作業負荷が均等に分割されている限り、優れたパフォーマンスを実現できます。  範囲パーティション分割の欠点は、あるスレッドが早く終了した場合、他のスレッドが作業を終了するのを支援できないことです。  
+  
+ リンク リストまたは長さがわからない他のコレクションの場合は、*チャンク パーティション分割*を使用できます。  チャンク パーティション分割では、並列ループまたは並列クエリ内のすべてのスレッドまたはタスクが、1 つのチャンク内のソース要素をいくつか使用し、それらのソース要素を処理し、その後追加の要素を取得します。  パーティショナーは、すべての要素が配布され、重複する要素が存在しないことを保証します。  チャンクは、任意のサイズにすることができます。  たとえば、「[How to: Implement Dynamic Partitions](../../../docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md)」で示されているパーティショナーは、1 つの要素のみを含むチャンクを作成します。  チャンクが大きすぎない限り、この種類のパーティション分割は、本質的に負荷分散を実行します。これは、スレッドへの要素の割り当てが事前に決定されないからです。  ただし、スレッドが別のチャンクを取得する必要があるたびに、パーティショナーが同期のオーバーヘッドを発生させます。  これらのケースで発生する同期の量は、チャンクのサイズに反比例します。  
+  
+ 一般に、範囲パーティション分割の方が高速なのは、デリゲートの実行時間が短時間から中程度までの長さであり、ソースに多数の要素があり、かつ各パーティションの総作業量がほぼ等価である場合のみです。  したがってチャンク パーティション分割の方が、ほとんどのケースで高速です。  要素が少ないか、またはデリゲートの実行時間が長いソースでは、チャンク パーティション分割と範囲パーティション分割のパフォーマンスがほぼ等しくなります。  
+  
+ TPL パーティショナーは、動的な数のパーティションもサポートします。  つまり、たとえば <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループが新しいタスクを作成するときに、パーティションをその場で作成できます。  この機能により、パーティショナーをループ自体と共に拡大縮小できます。  動的パーティショナーも、本質的に負荷分散を実行します。  カスタム パーティショナーを作成するときは、<xref:System.Threading.Tasks.Parallel.ForEach%2A> ループから使用できるようにするために、動的パーティション分割をサポートする必要があります。  
+  
+### PLINQ 用の負荷分散パーティショナーの構成  
+ <xref:System.Collections.Concurrent.Partitioner.Create%2A?displayProperty=fullName> メソッドの一部のオーバーロードを使用すると、配列または <xref:System.Collections.IList> ソース用のパーティショナーを作成し、スレッド間で作業負荷の分散を試みるかどうかを指定できます。  負荷分散を実行するようにパーティショナーを構成した場合、チャンク パーティション分割が使用され、要素は要求時に小さいチャンクで各パーティションに渡されます。  この方法は、ループまたはクエリの全体が完了するまで、すべてのパーティションに処理する要素があることを保証するのに役立ちます。  追加のオーバーロードを使用すると、任意の <xref:System.Collections.IEnumerable> ソースを負荷分散パーティション分割できます。  
+  
+ 一般に、負荷分散では、パーティションで比較的頻繁にパーティショナーに要素を要求する必要があります。  これに対し、静的パーティション分割を実行するパーティショナーでは、範囲パーティション分割またはチャンク パーティション分割を使用して、各パーティショナーに要素を一度に割り当てることができます。  この方法では、負荷分散よりもオーバーヘッドが少なくて済みますが、あるスレッドが他のスレッドよりもはるかに多くの作業を行う場合は、実行時間が長くなることがあります。  既定では、IList または配列が渡された場合、PLINQ は常に負荷分散なしの範囲パーティション分割を使用します。  PLINQ で負荷分散を有効にするには、次の例に示すように、`Partitioner.Create` メソッドを使用します。  
+  
+ [!code-csharp[TPL_Partitioners#02](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_partitioners/cs/partitioners.cs#02)]
+ [!code-vb[TPL_Partitioners#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_partitioners/vb/partitionsnippets_vb.vb#02)]  
+  
+ 特定のシナリオで負荷分散を使用するかどうかを判断する最適な方法は、典型的な負荷およびコンピューター構成の下で操作が完了するまでにどのくらいの時間がかかるかを実験し、計測することです。  たとえば、静的パーティション分割は、少数のコアしか持たないマルチコア コンピューターでは速度が飛躍的に向上することがありますが、比較的多くのコアを持つコンピューターでは速度が低下することがあります。  
+  
+ 次の表に、<xref:System.Collections.Concurrent.Partitioner.Create%2A> メソッドで使用できるオーバーロードを示します。  これらのパーティショナーは、PLINQ または <xref:System.Threading.Tasks.Task> での使用に限定されるわけではありません。  これらのパーティショナーは、任意のカスタム parallel コンストラクトでも使用できます。  
+  
+|オーバーロード|負荷分散の使用|  
+|-------------|-------------|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%60%601%28System.Collections.Generic.IEnumerable%7B%60%600%7D%29>|常時|  
+|[Create\<TSource\>\(TSource\<xref:System.Collections.Concurrent.Partitioner.Create%60%601%28%60%600%5B%5D%2CSystem.Boolean%29>|ブール型の引数を true と指定した場合|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%60%601%28System.Collections.Generic.IList%7B%60%600%7D%2CSystem.Boolean%29>|ブール型の引数を true と指定した場合|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%28System.Int32%2CSystem.Int32%29>|なし|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%28System.Int32%2CSystem.Int32%2CSystem.Int32%29>|なし|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%28System.Int64%2CSystem.Int64%29>|なし|  
+|<xref:System.Collections.Concurrent.Partitioner.Create%28System.Int64%2CSystem.Int64%2CSystem.Int64%29>|なし|  
+  
+### Parallel.ForEach 用の静的範囲パーティショナーの構成  
+ <xref:System.Threading.Tasks.Parallel.For%2A> ループでは、ループの本体がデリゲートとしてメソッドに提供されます。  このデリゲートを呼び出すコストは、仮想メソッドの呼び出しとほぼ同じです。  シナリオによっては、並列ループの本体が小さく、各ループ反復でデリゲートを呼び出すコストが膨大になることがあります。  そのような状況では、いずれかの <xref:System.Collections.Concurrent.Partitioner.Create%2A> オーバーロードを使用して、ソース要素に対する範囲パーティション分割の <xref:System.Collections.Generic.IEnumerable%601> を作成できます。  その後、この範囲のコレクションを、本体が通常の `for` ループで構成される <xref:System.Threading.Tasks.Parallel.ForEach%2A> メソッドに渡すことができます。  この方法の利点は、デリゲートを呼び出すコストが、要素ごとに 1 回ではなく、範囲ごとに 1 回しか発生しないことです。  基本的なパターンを次の例に示します。  
+  
+ [!code-csharp[TPL_Partitioners#01](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_partitioners/cs/partitioner01.cs#01)]
+ [!code-vb[TPL_Partitioners#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_partitioners/vb/partitionercreate01.vb#01)]  
+  
+ ループ内のすべてのスレッドは、指定されたサブ範囲の開始インデックス値と終了インデックス値を含む独自の <xref:System.Tuple%602> を受け取ります。  内側の `for` ループでは、`fromInclusive` 値および `toExclusive` 値を使用して、配列または <xref:System.Collections.IList> を直接ループ処理します。  
+  
+ <xref:System.Collections.Concurrent.Partitioner.Create%2A> オーバーロードのいずれかを使用すると、パーティションのサイズと、パーティションの数を指定できます。  このオーバーロードは、要素ごとの作業がきわめて少なく、要素ごとに 1 回の仮想メソッド呼び出しでもパフォーマンスに大きな影響が及ぶシナリオで使用できます。  
+  
+## カスタム パーティショナー  
+ シナリオによっては、独自のパーティショナーを実装するのが適切か、または必須である場合があります。  たとえば、クラスの内部構造に関する知識に基づいて、カスタム コレクション クラスを既定のパーティショナーよりも効率的にパーティション分割できる場合があります。  または、ソース コレクションの異なる場所にある要素を処理するのにかかる時間についての知識に基づいて、可変サイズの範囲パーティションを作成する必要がある場合があります。  
+  
+ 基本的なカスタム パーティショナーを作成するには、<xref:System.Collections.Concurrent.Partitioner%601?displayProperty=fullName> からクラスを派生させ、次の表に示すように仮想メソッドをオーバーライドします。  
+  
+|||  
+|-|-|  
+|<xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A>|このメソッドは、メイン スレッドによって 1 回呼び出され、IList\(IEnumerator\(TSource\)\) を返します。  ループまたはクエリ内の各ワーカー スレッドでは、リスト上で `GetEnumerator` を呼び出して、個別のパーティションに対する <xref:System.Collections.Generic.IEnumerator%601> を取得できます。|  
+|<xref:System.Collections.Concurrent.Partitioner%601.SupportsDynamicPartitions%2A>|<xref:System.Collections.Concurrent.Partitioner%601.GetDynamicPartitions%2A> を実装した場合は `true` を返し、それ以外の場合は `false` を返します。|  
+|<xref:System.Collections.Concurrent.Partitioner%601.GetDynamicPartitions%2A>|<xref:System.Collections.Concurrent.Partitioner%601.SupportsDynamicPartitions%2A> が `true` の場合、このメソッドを必要に応じて <xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A> の代わりに呼び出すことができます。|  
+  
+ 結果が並べ替え可能である必要がある場合、または要素へのインデックス付きアクセスが必要な場合、<xref:System.Collections.Concurrent.OrderablePartitioner%601?displayProperty=fullName> から派生させて、次の表に示すように仮想メソッドをオーバーライドします。  
+  
+|||  
+|-|-|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetPartitions%2A>|このメソッドは、メイン スレッドによって 1 回呼び出され、`IList(IEnumerator(TSource))` を返します。  ループまたはクエリ内の各ワーカー スレッドでは、リスト上で `GetEnumerator` を呼び出して、個別のパーティションに対する <xref:System.Collections.Generic.IEnumerator%601> を取得できます。|  
+|<xref:System.Collections.Concurrent.Partitioner%601.SupportsDynamicPartitions%2A>|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetDynamicPartitions%2A> を実装した場合は `true` を返し、それ以外の場合は false を返します。|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetDynamicPartitions%2A>|通常は <xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderableDynamicPartitions%2A> を単純に呼び出します。|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderableDynamicPartitions%2A>|<xref:System.Collections.Concurrent.Partitioner%601.SupportsDynamicPartitions%2A> が `true` の場合、このメソッドを必要に応じて <xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A> の代わりに呼び出すことができます。|  
+  
+ 次の表に、3 種類の負荷分散パーティショナーで <xref:System.Collections.Concurrent.OrderablePartitioner%601> クラスを実装する方法の詳細を示します。  
+  
+|メソッド\/プロパティ|負荷分散なしの IList\/配列|負荷分散ありの IList\/配列|IEnumerable|  
+|-----------------|-----------------------|-----------------------|-----------------|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderablePartitions%2A>|範囲パーティション分割を使用|指定された partitionCount のリストに最適化されたチャンク パーティション分割を使用|静的な数のパーティションを作成することにより、チャンク パーティション分割を使用|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderableDynamicPartitions%2A?displayProperty=fullName>|サポートしていない機能にアクセスしたときの例外をスロー|リストおよび動的なパーティションに最適化されたチャンク パーティション分割を使用|動的な数のパーティションを作成することにより、チャンク パーティション分割を使用|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.KeysOrderedInEachPartition%2A>|`true` を返す|`true` を返す|`true` を返す|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.KeysOrderedAcrossPartitions%2A>|`true` を返す|`false` を返す|`false` を返す|  
+|<xref:System.Collections.Concurrent.OrderablePartitioner%601.KeysNormalized%2A>|`true` を返す|`true` を返す|`true` を返す|  
+|<xref:System.Collections.Concurrent.Partitioner%601.SupportsDynamicPartitions%2A>|`false` を返す|`true` を返す|`true` を返す|  
+  
+### 動的パーティション  
+ パーティショナーを <xref:System.Threading.Tasks.Parallel.ForEach%2A> メソッドで使用する場合、動的な数のパーティションを返すことができる必要があります。  これは、パーティショナーがループの実行中の任意の時点で、新しいパーティションの列挙子をオンデマンドで供給できることを意味します。  基本的に、ループで新しい並列タスクを追加するたびに、そのタスク用の新しいパーティションが要求されます。  データが順序付け可能である必要がある場合は、<xref:System.Collections.Concurrent.OrderablePartitioner%601?displayProperty=fullName> から派生させて、各パーティション内の各項目に一意のインデックスが割り当てられるようにします。  
+  
+ 詳細および使用例については、「[How to: Implement Dynamic Partitions](../../../docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md)」を参照してください。  
+  
+### パーティショナーのコントラクト  
+ カスタム パーティショナーを実装するときは、次のガイドラインに従って、PLINQ および TPL 内の <xref:System.Threading.Tasks.Parallel.ForEach%2A> との適切な相互作用を保証します。  
+  
+-   <xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A> が `partitionsCount` に 0 以下の引数を指定して呼び出された場合は、<xref:System.ArgumentOutOfRangeException> をスローします。  PLINQ および TPL が 0 と等しい `partitionCount` を渡すことはありませんが、このような場合に備えることをお勧めします。  
+  
+-   <xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A> および <xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderablePartitions%2A> では、常に `partitionsCount` 個のパーティションを返す必要があります。  パーティショナーがデータを使い果たし、要求された数のパーティションを作成できない場合、このメソッドでは残りのパーティションのそれぞれについて、空の列挙子を返す必要があります。  それ以外の場合、PLINQ と TPL はいずれも <xref:System.InvalidOperationException> をスローします。  
+  
+-   <xref:System.Collections.Concurrent.Partitioner%601.GetPartitions%2A>、<xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderablePartitions%2A>、<xref:System.Collections.Concurrent.Partitioner%601.GetDynamicPartitions%2A>、および <xref:System.Collections.Concurrent.OrderablePartitioner%601.GetOrderableDynamicPartitions%2A> では、`null` \(Visual Basic では `Nothing` \) を返さないようにします。  返した場合、PLINQ または TPL は <xref:System.InvalidOperationException> をスローします。  
+  
+-   パーティションを返すメソッドでは、データ ソースを完全かつ一意に列挙できるパーティションを常に返す必要があります。  パーティショナーの設計により特別に必要な場合を除いて、データ ソース内の項目が重複したり、スキップされたりすることがないようにします。  この規則に従わないと、出力順序が乱れる場合があります。  
+  
+-   次のブール型の getter では、常に以下の値を正確に返して、出力順序が乱れないようにする必要があります。  
+  
+    -   `KeysOrderedInEachPartition`: 各パーティションは、昇順のキー インデックスを持つ要素を返します。  
+  
+    -   `KeysOrderedAcrossPartitions`: 返されるすべてのパーティションについて、パーティション *i* のキー インデックスは、パーティション *i*\-1 のキー インデックスよりも大きくなります。  
+  
+    -   `KeysNormalized`: すべてのキー インデックスは、0 から始まりギャップなしで単調に増加します。  
+  
+-   どのインデックスも一意である必要があります。  インデックスを重複させることはできません。  この規則に従わないと、出力順序が乱れる場合があります。  
+  
+-   どのインデックスも負数以外である必要があります。  この規則に従わないと、PLINQ または TPL が例外をスローする場合があります。  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [How to: Implement Dynamic Partitions](../../../docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md)   
+ [How to: Implement a Partitioner for Static Partitioning](../../../docs/standard/parallel-programming/how-to-implement-a-partitioner-for-static-partitioning.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/data-parallelism-task-parallel-library.md b/docs/standard/parallel-programming/data-parallelism-task-parallel-library.md
new file mode 100644
index 00000000000..cd0236c0528
--- /dev/null
+++ b/docs/standard/parallel-programming/data-parallelism-task-parallel-library.md
@@ -0,0 +1,58 @@
+---
+title: "Data Parallelism (Task Parallel Library) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallelism, data"
+ms.assetid: 3f05f33f-f1da-4b16-81c2-9ceff1bef449
+caps.latest.revision: 25
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 25
+---
+# Data Parallelism (Task Parallel Library)
+*データの並列化*とは、ソース コレクションまたは配列の要素に対して、同じ操作を同時に \(つまり、並列で\) 実行するシナリオを意味します。  データの並列化操作では、複数のスレッドが異なるセグメント上で同時に操作できるようにソース コレクションがパーティション分割されます。  
+  
+ タスク並列ライブラリ \(TPL\) は <xref:System.Threading.Tasks.Parallel?displayProperty=fullName> クラスによって、データの並列化をサポートします。  このクラスでは、[for](../Topic/for%20\(C%23%20Reference\).md) ループおよび [foreach](../Topic/foreach,%20in%20\(C%23%20Reference\).md) ループ \(Visual Basic では `For` および `For Each`\) をメソッド ベースで並列実装できます。  <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> ループまたは <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> ループに対するループのロジックは、順次ループを記述する場合と同等に記述します。  スレッドまたはキューの作業項目を作成する必要はありません。  基本のループでは、ロックを取得する必要はありません。  TPL では低水準の作業はすべて自動的に行われます。  <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> の使用方法の詳細については、ドキュメント「[Patterns for Parallel Programming: Understanding and Applying Parallel Patterns with the .NET Framework 4 \(並列プログラミングのパターン: .NET Framework 4 の並列パターンの理解と適用\)](http://www.microsoft.com/download/details.aspx?id=19222)」をダウンロードしてください。  次のコード例では、単純な `foreach` ループおよびそのループに相当する並列を示しています。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して TPL でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+ [!code-csharp[TPL#20](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl/cs/tpl.cs#20)]
+ [!code-vb[TPL#20](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl/vb/tpl_vb.vb#20)]  
+  
+ 並列ループを実行すると、TPL はデータ ソースをパーティション分割して、ループで複数の部分を同時に操作できるようにします。  背後では、タスク スケジューラが、システム リソースおよび作業負荷に基づいてタスクをパーティション分割します。  作業負荷のバランスが崩れると、可能な場合、スケジューラは複数のスレッドとプロセッサ間で作業を再配分します。  
+  
+> [!NOTE]
+>  固有のカスタム パーティショナーまたはスケジューラを使うこともできます。  詳細については、「[Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)」および「[Task Schedulers](../Topic/Task%20Schedulers.md)」を参照してください。  
+  
+ <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドおよび <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> メソッドの両方に、ループの実行を停止または中断させるオーバーロードが複数ある場合は、その他のスレッドのループ状態の監視、スレッド ローカルの状態の維持、スレッド ローカル オブジェクトの終了、同時実行の程度の制御などを行います。  この機能を有効にするヘルパー要素には、<xref:System.Threading.Tasks.ParallelLoopState>、<xref:System.Threading.Tasks.ParallelOptions>、<xref:System.Threading.Tasks.ParallelLoopResult>、<xref:System.Threading.CancellationToken>、および <xref:System.Threading.CancellationTokenSource> があります。  
+  
+ 詳細については、「[Patterns of Parallel Programming \(並列プログラミングのパターン\)](http://go.microsoft.com/fwlink/p/?LinkId=265491)」を参照してください。  
+  
+ PLINQ では、宣言構文またはクエリ形式の構文によるデータの並列化がサポートされています。  詳細については、「[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)」を参照してください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[How to: Write a Simple Parallel.For Loop](../../../docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md)|任意の配列またはインデックス可能な <xref:System.Threading.Tasks.Parallel.For%2A> ソース コレクションに対して <xref:System.Collections.Generic.IEnumerable%601> ループを記述する方法について説明します。|  
+|[How to: Write a Simple Parallel.ForEach Loop](../../../docs/standard/parallel-programming/how-to-write-a-simple-parallel-foreach-loop.md)|任意の <xref:System.Threading.Tasks.Parallel.ForEach%2A> ソース コレクションに対して <xref:System.Collections.Generic.IEnumerable%601> ループを記述する方法について説明します。|  
+|[How to: Stop or Break from a Parallel.For Loop](http://msdn.microsoft.com/ja-jp/de52e4f1-9346-4ad5-b582-1a4d54dc7f7e)|並列ループを停止するかまたは抜けて、そのアクションがすべてのスレッドに通知されるようにする方法について説明します。|  
+|[How to: Write a Parallel.For Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md)|各スレッドが他のスレッドからは見えないプライベート変数を維持する <xref:System.Threading.Tasks.Parallel.For%2A> ループを記述する方法と、ループが完了したときにすべてのスレッドの結果を同期する方法について説明します。|  
+|[How to: Write a Parallel.ForEach Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md)|各スレッドが他のスレッドからは見えないプライベート変数を維持する <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループを記述する方法と、ループが完了したときにすべてのスレッドの結果を同期する方法について説明します。|  
+|[How to: Cancel a Parallel.For or ForEach Loop](../../../docs/standard/parallel-programming/how-to-cancel-a-parallel-for-or-foreach-loop.md)|<xref:System.Threading.CancellationToken?displayProperty=fullName> を使用して並列ループを取り消す方法について説明します。|  
+|[How to: Speed Up Small Loop Bodies](../../../docs/standard/parallel-programming/how-to-speed-up-small-loop-bodies.md)|ループの本体がごく小さい場合に実行速度を向上させる方法の 1 つを説明します。|  
+|[Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)|タスク並列ライブラリの概要を示します。|  
+|[Parallel Programming](../../../docs/standard/parallel-programming/index.md)|.NET Framework の並列プログラミングについて説明します。|  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/data-structures-for-parallel-programming.md b/docs/standard/parallel-programming/data-structures-for-parallel-programming.md
new file mode 100644
index 00000000000..3405e0be9c9
--- /dev/null
+++ b/docs/standard/parallel-programming/data-structures-for-parallel-programming.md
@@ -0,0 +1,78 @@
+---
+title: "Data Structures for Parallel Programming | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "data structures, multi-threading"
+ms.assetid: bdc82f2f-4754-45a1-a81e-fe2e9c30cef9
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Data Structures for Parallel Programming
+.NET Framework Version 4 では、並列プログラミングに役立つ新しい型がいくつか導入されています。たとえば、一連の同時実行コレクション クラス、軽量な同期プリミティブ、限定的な初期化などです。  これらの型は、タスク並列ライブラリや PLINQ などのマルチスレッド アプリケーション コードで使用できます。  
+  
+## 同時実行コレクション クラス  
+ <xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間のコレクション クラスには、スレッド セーフな追加操作と削除操作が用意されており、できる限りロックを回避する一方で、ロックが必要な場合は粒度の細かいロックを使用できます。  .NET Framework Version 1.0 および 2.0 で導入されたコレクションとは異なり、同時実行コレクション クラスでは、項目にアクセスするときにロックを取得するユーザー コードを必要としません。  同時実行コレクション クラスでは、複数のスレッドが 1 つのコレクションに項目を追加したり、コレクションから項目を削除したりする場合に、<xref:System.Collections.ArrayList?displayProperty=fullName>、<xref:System.Collections.Generic.List%601?displayProperty=fullName> などの型で \(ユーザーが実装したロックを使用して\) パフォーマンスを大幅に向上させることができます。  
+  
+ 次の表は、新しい同時実行コレクション クラスの一覧です。  
+  
+|型|説明|  
+|-------|--------|  
+|<xref:System.Collections.Concurrent.BlockingCollection%601?displayProperty=fullName>|<xref:System.Collections.Concurrent.IProducerConsumerCollection%601?displayProperty=fullName> を実装するスレッド セーフなコレクションに、ブロッキングと範囲指定の機能を提供します。  スロットが使用できないか、コレクションがいっぱいになった場合に、producer スレッドがブロックを実行します。  コレクションが空の場合、consumer スレッドがブロックを実行します。  また、この型は consumer と producer によってブロックされないアクセスもサポートしています。  <xref:System.Collections.Concurrent.BlockingCollection%601> は、<xref:System.Collections.Generic.IEnumerable%601> をサポートするコレクション クラスにブロッキングおよび境界を提供する基本クラスまたはバッキング ストアとして使用できます。|  
+|<xref:System.Collections.Concurrent.ConcurrentBag%601?displayProperty=fullName>|スケーラブルな操作の追加と取得を提供するスレッド セーフなバッグの実装。|  
+|<xref:System.Collections.Concurrent.ConcurrentDictionary%602?displayProperty=fullName>|同時実行されるスケーラブルなディクショナリ型。|  
+|<xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName>|同時実行されるスケーラブルな FIFO キュー。|  
+|<xref:System.Collections.Concurrent.ConcurrentStack%601?displayProperty=fullName>|同時実行されるスケーラブルな LIFO スタック。|  
+  
+ 詳細については、「[スレッド セーフなコレクション](../../../docs/standard/collections/thread-safe/index.md)」を参照してください。  
+  
+## 同期プリミティブ  
+ 従来のマルチスレッド コードに見られる負荷の高いロック機構を使用する代わりに <xref:System.Threading?displayProperty=fullName> 名前空間の新しい同期プリミティブを使用すると、粒度の細かい同時実行とパフォーマンスの向上が実現されます。  <xref:System.Threading.Barrier?displayProperty=fullName>、<xref:System.Threading.CountdownEvent?displayProperty=fullName> などの新しい型の場合、.NET Framework の以前のリリースには同等の型がありません。  
+  
+ 新しい同期型の一覧を次に示します。  
+  
+|型|説明|  
+|-------|--------|  
+|<xref:System.Threading.Barrier?displayProperty=fullName>|各タスクが到着を通知してから一部またはすべてのタスクが到着するまでブロックするポイントを指定して、複数のスレッドが並列のアルゴリズムで実行できるようにします。  詳細については、「[Barrier](../../../docs/standard/threading/barrier.md)」を参照してください。|  
+|<xref:System.Threading.CountdownEvent?displayProperty=fullName>|容易な連結方法を提供して、フォークと結合の方法を簡略化します。  詳細については、「[CountdownEvent](../../../docs/standard/threading/countdownevent.md)」を参照してください。|  
+|<xref:System.Threading.ManualResetEventSlim?displayProperty=fullName>|<xref:System.Threading.ManualResetEvent?displayProperty=fullName> に似た同期プリミティブです。  <xref:System.Threading.ManualResetEventSlim> は軽量ですが、プロセス間通信での使用に限定されます。  詳細については、「[ManualResetEvent and ManualResetEventSlim](../../../docs/standard/threading/manualresetevent-and-manualreseteventslim.md)」を参照してください。|  
+|<xref:System.Threading.SemaphoreSlim?displayProperty=fullName>|リソースまたはリソースのプールに同時にアクセスできるスレッドの数を制限する同期プリミティブです。  詳細については、「[Semaphore and SemaphoreSlim](../../../docs/standard/threading/semaphore-and-semaphoreslim.md)」を参照してください。|  
+|<xref:System.Threading.SpinLock?displayProperty=fullName>|クォンタムを生成するまでの一定期間内に、ループまたは*スピン*で待機するロックの取得を試みるスレッドを発生させるロック プリミティブで、一度に 1 つしか指定できません。  ロックの待機時間が短いことが予測される場合、<xref:System.Threading.SpinLock> ではその他の形式のロックよりも高いパフォーマンスが得られます。  詳細については、「[SpinLock](../../../docs/standard/threading/spinlock.md)」を参照してください。|  
+|<xref:System.Threading.SpinWait?displayProperty=fullName>|指定された時刻にスピンし、スピン カウントが超過した場合は最終的にスレッドを待機状態にする、小さくて軽量な型です。詳細については、「[SpinWait](../../../docs/standard/threading/spinwait.md)」を参照してください。|  
+  
+ 詳細については、次のトピックを参照してください。  
+  
+-   [How to: Use SpinLock for Low\-Level Synchronization](../../../docs/standard/threading/how-to-use-spinlock-for-low-level-synchronization.md)  
+  
+-   [How to: Synchronize Concurrent Operations with a Barrier](../../../docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md).  
+  
+## 限定的な初期化クラス  
+ 限定的な初期化を使用すると、オブジェクトのメモリは必要になるまで割り当てられません。  限定的な初期化では、プログラムの有効期間内でオブジェクトの割り当てを均等に展開することによって、パフォーマンスが向上します。  <xref:System.Lazy%601> の型をラップすることにより、任意のカスタム型の限定的な初期化を有効にできます。  
+  
+ 限定的な初期化の型の一覧を次に示します。  
+  
+|型|説明|  
+|-------|--------|  
+|<xref:System.Lazy%601?displayProperty=fullName>|軽量でスレッド セーフな限定的な初期化を提供します。|  
+|<xref:System.Threading.ThreadLocal%601?displayProperty=fullName>|初期化関数を限定的に呼び出す各スレッドで、スレッドごとに限定的に初期化された値を提供します。|  
+|<xref:System.Threading.LazyInitializer?displayProperty=fullName>|専用の限定的な初期化インスタンスを割り当てる必要を回避する静的メソッドを提供します。  代わりに、参照を使用して、ターゲットがアクセスされるときに初期化されていることを確認します。|  
+  
+ 詳細については、「[限定的な初期化](../../../docs/framework/performance/lazy-initialization.md)」を参照してください。  
+  
+## 例外の集約  
+ <xref:System.AggregateException?displayProperty=fullName> 型を使用して、別のスレッドで同時にスローされた複数の例外をキャプチャし、単一の例外として連結しているスレッドに返すことができます。  <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型、<xref:System.Threading.Tasks.Parallel?displayProperty=fullName> 型、および PLINQ は、この目的で幅広く <xref:System.AggregateException> を使用します。  詳細については、「[NIB: How to: Handle Exceptions Thrown by Tasks](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)」および「[How to: Handle Exceptions in a PLINQ Query](../../../docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Collections.Concurrent?displayProperty=fullName>   
+ <xref:System.Threading?displayProperty=fullName>   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/dataflow-task-parallel-library.md b/docs/standard/parallel-programming/dataflow-task-parallel-library.md
new file mode 100644
index 00000000000..95eebcd770b
--- /dev/null
+++ b/docs/standard/parallel-programming/dataflow-task-parallel-library.md
@@ -0,0 +1,287 @@
+---
+title: "データフロー (タスク並列ライブラリ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タスク並列ライブラリ、データフロー"
+  - "TPL データフロー ライブラリ"
+ms.assetid: 643575d0-d26d-4c35-8de7-a9c403e97dd6
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# データフロー (タスク並列ライブラリ)
+<a name="top"></a>タスク並列ライブラリ (TPL) は、同時実行対応アプリケーションの堅牢性を強化するためにデータ フロー コンポーネントを提供します。 これらのデータ フロー コンポーネントと総称として、 *TPL データフロー ライブラリ*します。 データ フロー モデルは、粒度の粗いデータ フローおよびパイプライン処理タスクのためのインプロセス メッセージ パッシングを提供し、アクター ベースのプログラミング モデルを推進します。 データ フロー コンポーネントは、TPL の種類とスケジュール インフラストラクチャの上でビルドされ、C#、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]、および同期プログラミングの F# 言語のサポートを統合します。 相互に非同期通信を行う必要がある複数の操作を行う場合、またはデータが使用可能になったときにデータを処理する場合に、これらのデータ フロー コンポーネントは役立ちます。 たとえば、Web カメラからのイメージ データを処理するアプリケーションを考えてみます。 データ フロー モデルを使用すると、イメージ フレームが使用可能になったときに、それをアプリケーションで処理できます。 場合は、アプリケーションは、イメージ フレームを向上させる、たとえば、輝度修正や赤目補正などを実行することによって作成、*パイプライン*データ フロー コンポーネントのです。 パイプラインの各ステージは、イメージを変換するために、TPL が提供する機能のような、粒度の粗い並列機能を使用する場合があります。  
+  
+ ここでは、TPL データ フロー ライブラリの概要を示します。 プログラミング モデル、定義済みのデータ フロー ブロックの型、およびアプリケーションの特定の要件を満たすためのデータ フロー ブロックの構成方法を説明します。  
+  
+> [!TIP]
+>  TPL データフロー ライブラリ (<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName>名前空間) と一緒に配布されませんが、[!INCLUDE[net_v45](../../../includes/net-v45-md.md)]です。 インストールする、 <xref:System.Threading.Tasks.Dataflow>名前空間でプロジェクトを開きます[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)]、選択**NuGet パッケージの管理**プロジェクト メニュー オンラインで検索から、`Microsoft.Tpl.Dataflow`パッケージです。  
+  
+ このドキュメントは、次のトピックに分かれています。  
+  
+-   [プログラミング モデル](#model)  
+  
+-   [定義済みのデータ フロー ブロックの型](#predefined_types)  
+  
+-   [データ フロー ブロックの動作を構成します。](#behavior)  
+  
+-   [カスタム データ フロー ブロック](#custom)  
+  
+<a name="model"></a>   
+## <a name="programming-model"></a>プログラミング モデル  
+ TPL データ フロー ライブラリはメッセージ パッシングおよび、並列化され、CPU 負荷が高く、I/O 負荷が高く、スループットが高く、待機時間が短いアプリケーションのための基盤を提供します。 また、システム上でのデータのバッファリング方法や移動について、明示的に制御できます。 データ フロー プログラミング モデルの理解を深めるため、非同期的にディスクからイメージを読み込み、それらの合成イメージを作成するアプリケーションを考えてみます。 従来のプログラミング モデルでは、通常、タスクを協調させ、共有データにアクセスするには、コールバックおよびロックなどの同期オブジェクトを使用する必要があります。 データ フロー プログラミング モデルを使用すると、イメージがディスクから読み込まれたときにそれを処理する、データ フロー オブジェクトを作成できます。 データ フロー モデルでは、データが使用可能になったときの処理方法と、データ間の依存関係を宣言します。 ランタイムがデータ間の依存関係を管理するため、通常は共有データへのアクセスの同期要件を回避できます。 さらに、ランタイムのスケジュールは非同期のデータの到着に基づいて動作するため、基になるスレッドを効率的に管理することによって、データ フローの応答性とスループットが向上します。 データ フロー プログラミング モデルを使用して Windows フォーム アプリケーションでイメージ処理を実装する例を[チュートリアル: Windows フォーム アプリケーションでのデータ フローを使用して](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)します。  
+  
+### <a name="sources-and-targets"></a>ソースとターゲット  
+ TPL データ フローのライブラリから成る*データフロー ブロック*バッファリングと処理データ構造体でデータがあります。 TPL データ フロー ブロックの&3; 種類の定義:*ソース ブロック*、*ターゲット ブロック*、および*伝達子ブロック*します。 ソース ブロックはデータのソースとして機能し、それを読み取ることができます。 ターゲット ブロックはデータのレシーバーとして機能し、それに書き込むことができます。 伝達子ブロックは、ソース ブロックとターゲット ブロックのどちらとしても機能し、読み取りも書き込みもできます。 TPL を定義、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601?displayProperty=fullName>ソースを表し、インターフェイス<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601?displayProperty=fullName>ターゲットを表し、および<xref:System.Threading.Tasks.Dataflow.IPropagatorBlock%602?displayProperty=fullName>によって伝達子を表す</TInput, TOutput>。 <xref:System.Threading.Tasks.Dataflow.IPropagatorBlock%602>両方から継承<xref:System.Threading.Tasks.Dataflow.ISourceBlock%601>、および<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>します。\</TInput, TOutput>  
+  
+ TPL データ フローのライブラリを実装するいくつかの定義済みのデータ フロー ブロックの型を提供する、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601>、 <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>、および<xref:System.Threading.Tasks.Dataflow.IPropagatorBlock%602>インターフェイス\</TInput, TOutput>。 これらのデータ フロー ブロックの型が、セクションでは、このドキュメントで説明されている[データ フロー ブロックの型の定義済みの](#predefined_types)です。  
+  
+### <a name="connecting-blocks"></a>ブロックの接続  
+ フォームにデータ フロー ブロックを接続することができます*パイプライン*、データ フロー ブロックのリニア シーケンスであるまたは*ネットワーク*、データ フロー ブロックのグラフであります。 パイプラインは、ネットワークの&1; つの形態です。 パイプラインまたはネットワークでは、データが使用可能になると、ソースはターゲットに非同期的にデータを伝達します。 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A?displayProperty=fullName>メソッドは、ターゲット ブロックにソース データフロー ブロックをリンクします。 ソースは、ターゲットにリンクしないか、または複数のターゲットにリンクできます。ターゲットはソースからリンクされないか、または複数のソースからリンクできます。 パイプラインまたはネットワークとの間でデータ フロー ブロックを同時に追加または削除できます。 定義済みのデータ フロー ブロックの型は、リンクとリンク解除のすべてのスレッド セーフな側面を処理します。  
+  
+ 例の基本的なパイプラインを作成するデータ フロー ブロックを接続する場合は、次を参照してください。[チュートリアル: データフロー パイプラインの作成](../../../docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md)します。 複雑なネットワークを形成するデータフロー ブロックを接続する例を参照してください。[チュートリアル: Windows フォーム アプリケーションでのデータ フローを使用して](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)します。 ソースは、メッセージをターゲットに提供した後、元のターゲットをリンク解除は、次を参照してください。[方法: データフロー ブロックのリンクを解除](../../../docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md)します。  
+  
+#### <a name="filtering"></a>フィルター処理  
+ 呼び出すと、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A?displayProperty=fullName>を対象のソースをリンクする方法、ターゲット ブロックが受け入れるか、そのメッセージの値に基づいてメッセージが拒否されたかどうかを決定するデリゲートを指定することができます。 このフィルター機構は、データ フロー ブロックが特定の値のみを確実に受信するために便利な方法です。 定義済みのデータ フロー ブロックの型のほとんどの場合に、ソース ブロックが複数のターゲット ブロックに接続されている場合は、ターゲット ブロックがメッセージを拒否すると、ソースはそのメッセージを次のターゲットに提供します。 ソースがターゲットにメッセージを提供する順序はソースによって定義され、ソースの種類によって異なる場合があります。 1 つのターゲットがメッセージを受け入れると、ほとんどのソース ブロックの型がメッセージの提供を停止します。 この規則の例外は、 <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>クラスは、いくつかのターゲットがメッセージを拒否する場合でも、各メッセージをすべてのターゲットを提供します。 例のフィルタ リングを使用して、特定のメッセージのみを処理する場合は、次を参照してください。[チュートリアル: Windows フォーム アプリケーションでのデータ フローを使用して](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)します。  
+  
+> [!IMPORTANT]
+>  それぞれの定義済みのソースのデータ フロー ブロックの型は、メッセージを受信した順にそれが伝達されることを保証するため、ソース ブロックは各メッセージを読み取ってから、次のメッセージを処理する必要があります。 したがって、フィルター処理を使用して複数のターゲットをソースに接続する場合、各メッセージを少なくとも&1; つのターゲット ブロックが受信するようにします。 そうしない場合、アプリケーションでデッドロックが発生する可能性があります。  
+  
+### <a name="message-passing"></a>メッセージ パッシング  
+ 概念に関連するデータ フロー プログラミング モデル*メッセージ パッシング*メッセージを送信するプログラムの独立したコンポーネントを相互通信、です。 アプリケーション コンポーネント間でメッセージを伝達する方法の&1; つを呼び出すことです、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A>と<xref:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync%2A?displayProperty=fullName>をターゲット データ フロー ブロック ポストにメッセージを送信する方法 (<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A>同期します。<xref:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync%2A>非同期的に動作)、および<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Receive%2A>、 <xref:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync%2A>と<xref:System.Threading.Tasks.Dataflow.DataflowBlock.TryReceive%2A>メソッドのソース ブロックからメッセージを受信します。 入力データをヘッド ノード (ターゲット ブロック) に送信し、出力データをパイプラインのターミナル ノードまたはネットワーク (1 つ以上のソース ブロック) のターミナル ノードから受信することにより、これらのメソッドとデータ フロー パイプラインまたはネットワークを結合することができます。 使用することも、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Choose%2A>メソッドの先頭から読み取り、使用可能なデータがあり、そのデータに対して操作を実行する指定されたソースのです。  
+  
+ ソース ブロックでは、ターゲット ブロックにデータを提供を呼び出して、 <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601.OfferMessage%2A?displayProperty=fullName>メソッドです。 ターゲット ブロックは、提供されたメッセージに、3 つの方法のうちの&1; つで応答します。メッセージを受け入れるか、メッセージを拒否するか、またはメッセージを延期できます。 ターゲットがメッセージを受け入れるときに、 <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601.OfferMessage%2A>メソッドが返す<xref:System.Threading.Tasks.Dataflow.DataflowMessageStatus>します。 ターゲットがメッセージを拒否すると、 <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601.OfferMessage%2A>メソッドが返す<xref:System.Threading.Tasks.Dataflow.DataflowMessageStatus>します。 ターゲットは、元のすべてのメッセージを受信しないことが必要な場合<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601.OfferMessage%2A>返します<xref:System.Threading.Tasks.Dataflow.DataflowMessageStatus>します。 その戻り値を受信した後は、定義済みのソース ブロックの型は、リンクされたターゲットにメッセージを提供せず、自動的にそのターゲットからリンク解除します。  
+  
+ ターゲット ブロックが後で使用できるメッセージを延期すると、 <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601.OfferMessage%2A>メソッドが返す<xref:System.Threading.Tasks.Dataflow.DataflowMessageStatus>します。 メッセージを延期したターゲット ブロックはそれ以降の呼び出し、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.ReserveMessage%2A?displayProperty=fullName>メソッドを提供されたメッセージを予約しようとしています。 この時点で、メッセージはまだ使用できてターゲット ブロックから使用できるか、または他のターゲットに取得されています。 ターゲット ブロックがメッセージを後で必要または必要としないメッセージを呼び出し、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.ConsumeMessage%2A?displayProperty=fullName>または<xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.ReleaseReservation%2A>メソッドをそれぞれします。 通常は、メッセージの予約は、最短一致のモードで動作するデータ フロー ブロックの型で使用されます。 最短一致のモードについては、このドキュメントの後で説明します。 延期されたメッセージを予約せずに、ターゲット ブロックは使用することも、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.ConsumeMessage%2A?displayProperty=fullName>メソッドを直接延期されたメッセージを使用しようとしています。  
+  
+### <a name="dataflow-block-completion"></a>データ フロー ブロックの完了  
+ データ フロー ブロックの概念をサポートも*完了*します。 完了した状態にあるデータ フロー ブロックは、処理を実行しません。 各データフロー ブロックが関連付けられている<xref:System.Threading.Tasks.Task?displayProperty=fullName>と呼ばれるオブジェクト、*完了タスク*ブロックの完了ステータスを表します。 待つため、<xref:System.Threading.Tasks.Task>オブジェクトの完了タスクを使用して終了するには、1 つを待機できるまたはデータフローの以上のターミナル ノードが終了するネットワークです。 <xref:System.Threading.Tasks.Dataflow.IDataflowBlock>インターフェイスを定義、<xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete%2A>メソッドで、データ フロー ブロックの要求を完了するを通知するには、および<xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Completion%2A>プロパティで、データ フロー ブロックの完了タスクを返します。 両方とも<xref:System.Threading.Tasks.Dataflow.ISourceBlock%601>と<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>継承、 <xref:System.Threading.Tasks.Dataflow.IDataflowBlock>インターフェイスです。  
+  
+ データ フロー ブロックがエラーなしで完了したか、1 つのエラーが発生したか、複数のエラーが発生したか、取り消されたかを知る&2; つの方法があります。 最初の方法は、 <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName>完了タスクでのメソッド、 `try` - `catch`ブロック (`Try` - `Catch` Visual Basic で)。 次の例を作成し、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトをスローする<xref:System.ArgumentOutOfRangeException> 、入力値が&0; よりも小さい場合です。 <xref:System.AggregateException>この例を呼び出す場合にスローされる<xref:System.Threading.Tasks.Task.Wait%2A>完了タスクです。 <xref:System.ArgumentOutOfRangeException>を通じてアクセス、 <xref:System.AggregateException.InnerExceptions%2A>のプロパティ、 <xref:System.AggregateException>オブジェクトです。  
+  
+ [!code-csharp[TPLDataflow_Overview#10](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#10)]
+ [!code-vb[TPLDataflow_Overview#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#10)]  
+  
+ この例は、例外が実行データ フロー ブロックのデリゲートで処理されない場合を示します。 そのようなブロックの本体で例外を処理することをお勧めします。 そのようにできない場合は、ブロックはそれが取り消されたように動作し、受信メッセージを処理しません。  
+  
+ データ フロー ブロックが明示的に取り消されたときに、 <xref:System.AggregateException>オブジェクトを含む<xref:System.OperationCanceledException>で、 <xref:System.AggregateException.InnerExceptions%2A>プロパティです。 データ フローの取り消しの詳細については、このドキュメントの後の「取り消しの有効化」を参照してください。  
+  
+ データ フロー ブロックの完了ステータスを決定する&2; 番目の方法は、完了タスクの継続を使用するか、または C# と Visual Basic の非同期言語機能を使用して、完了したタスクを非同期的に待つことです。 提供するデリゲート、 <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName>メソッドには、<xref:System.Threading.Tasks.Task>継続元タスクを表すオブジェクト。 場合、<xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Completion%2A>プロパティを継続のデリゲートは完了タスクを受け取ります。 次の例似ていますが、1 つ前を使用して、 <xref:System.Threading.Tasks.Task.ContinueWith%2A>データ フロー操作全体の状態を出力する完了タスクを作成する方法です。  
+  
+ [!code-csharp[TPLDataflow_Overview#11](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#11)]
+ [!code-vb[TPLDataflow_Overview#11](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#11)]  
+  
+ などのプロパティを使用することもできます。 <xref:System.Threading.Tasks.Task.IsCanceled%2A>データ フロー ブロックの完了ステータスに関する追加情報を決定する継続タスクの本体にです。 継続タスクと取り消し処理およびエラー処理に関係の詳細については、次を参照してください。[を使用して継続タスクをタスクの連結](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)、[タスクのキャンセル](../../../docs/standard/parallel-programming/task-cancellation.md)、[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)、および[NIB: 方法: タスクがスローした例外を処理](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)します。  
+  
+ [[go to top](#top)]  
+  
+<a name="predefined_types"></a>   
+## <a name="predefined-dataflow-block-types"></a>定義済みのデータ フロー ブロックの型  
+ TPL データ フロー ライブラリは、いくつかの定義済みのデータ フロー ブロックの型を提供します。 これらの型は&3; つのカテゴリに分けられます。*バッファリング ブロック*、*実行ブロック*、および*ブロックをグループ化*します。 次のセクションでは、これらの種類を構成するブロックの型について説明します。  
+  
+### <a name="buffering-blocks"></a>バッファリング ブロック  
+ バッファリング ブロックはデータ コンシューマーが使用するデータを保持します。 TPL データ フロー ライブラリは、3 つのバッファリング ブロックの型を提供します。 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601?displayProperty=fullName>、 <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601?displayProperty=fullName>、および<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601?displayProperty=fullName>します。  
+  
+#### <a name="bufferblockt"></a>BufferBlock(T)  
+ <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>クラスは汎用的な非同期メッセージング構造体を表します。 このクラスでは、複数のソースが書き込むことができるメッセージ、または複数のターゲットが読み取ることができるメッセージの先入れ先出し (FIFO) のキューを格納します。 ターゲットがからのメッセージを受信すると、 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>オブジェクト、そのメッセージはメッセージ キューから削除します。 したがって、ですが、 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>オブジェクトは、複数のターゲットを持つことが、1 つだけのターゲットは各メッセージを受信します。 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>クラスは、複数のメッセージを別のコンポーネントに渡すし、そのコンポーネントは、各メッセージを受信する必要がある場合に便利です。  
+  
+ 次の基本的な例がいくつか投稿<xref:System.Int32>値を<xref:System.Threading.Tasks.Dataflow.BufferBlock%601>オブジェクトし、そのオブジェクトからそれらの値を読み取ります。  
+  
+ [!code-csharp[TPLDataflow_Overview#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#1)]
+ [!code-vb[TPLDataflow_Overview#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#1)]  
+  
+ メッセージの読み取りし、書き込みにする方法を示すコード例全体について、 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>オブジェクトは、「[する方法: メッセージを記述し、データ フロー ブロックからメッセージの読み取り](../../../docs/standard/parallel-programming/how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md)します。  
+  
+#### <a name="broadcastblockt"></a>BroadcastBlock(T)  
+ <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>クラスは、別のコンポーネントを複数のメッセージを渡す必要がありますが、そのコンポーネントには、最新の値のみが必要がある場合に便利です。 また、このクラスは、メッセージを複数のコンポーネントにブロードキャストする場合にも便利です。  
+  
+ 次の基本的な例の投稿、<xref:System.Double>値を<xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>オブジェクトと、そのオブジェクトから複数回読み込みます、値の読み取り。 値はから削除されないため<xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>オブジェクト毎回同じ値を使用できるで読み取られた後。  
+  
+ [!code-csharp[TPLDataflow_Overview#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#2)]
+ [!code-vb[TPLDataflow_Overview#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#2)]  
+  
+ 使用する方法を示すコード例全体について<xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>複数のターゲット ブロックにメッセージを送信するを参照してください。[方法: データフロー ブロックでタスク スケジューラを指定する](../../../docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md)します。  
+  
+#### <a name="writeonceblockt"></a>WriteOnceBlock(T)  
+ <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>クラスに似ています、 <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>クラスのことを除いて、 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクトに&1; 回しか書き込むことができます。 考えることができます<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> c# に似ている[読み取り専用](../Topic/readonly%20\(C%23%20Reference\).md)([読み取り専用](../Topic/ReadOnly%20\(Visual%20Basic\).md)で[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]) ことを除いて、キーワード、 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクトを変更できなくなるは、構築時にの代わりに値を受信後します。 ように、 <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>クラス、ターゲットからメッセージを受信するときに、 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクト、そのメッセージはそのオブジェクトから削除されません。 そのため、複数のターゲットがメッセージのコピーを受信します。 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>クラスは、複数のメッセージの最初のだけを伝達する場合に便利です。  
+  
+ 次の基本的な例を複数ポストバック<xref:System.String>値を<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクトとし、その値をそのオブジェクトから読み込みます。 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクトは、1 回に書き込むことが後にのみ、 <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>オブジェクトがメッセージを受け取り、それ以降のメッセージを破棄します。  
+  
+ [!code-csharp[TPLDataflow_Overview#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#3)]
+ [!code-vb[TPLDataflow_Overview#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#3)]  
+  
+ 使用する方法を示すコード例全体について<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>に終了した最初の操作の値を提供するには、次を参照してください。[方法: データフロー ブロックのリンクを解除](../../../docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md)します。  
+  
+### <a name="execution-blocks"></a>実行ブロック  
+ 実行ブロックは、受け取ったデータのそれぞれに、ユーザーが指定したデリゲートを呼び出します。 TPL データ フロー ライブラリは、次の&3; つの実行ブロックの型: <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602?displayProperty=fullName>、および<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602?displayProperty=fullName>.\</TInput, TOutput> \</TInput, TOutput>  
+  
+#### <a name="actionblockt"></a>ActionBlock(T)  
+ <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>クラスは、データを受け取るとデリゲートを呼び出すターゲット ブロックです。 考えてみてください、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトとしてデータに使用可能な場合に非同期的に実行できるデリゲートです。 提供するデリゲート、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトは、型であることができます<xref:System.Action>または型`System.Func\<TInput, Task>`します。 使用すると、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトを<xref:System.Action>、各入力要素の処理は、デリゲートが返されたときに完了したと見なされます。 使用すると、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトを`System.Func\<TInput, Task>`、各入力要素の処理が完了した場合にのみと見なさ返された<xref:System.Threading.Tasks.Task>オブジェクトが終了しました。 これら&2; つのメカニズムを使用すると、使用することができます<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>各入力要素の同期および非同期で処理するためです。  
+  
+ 次の基本的な例を複数ポストバック<xref:System.Int32>値を<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトです。 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>オブジェクトは、コンソールにそれらの値を出力します。 次にこの例では、ブロックを完了した状態に設定し、すべてのデータ フロー タスクの終了を待機します。  
+  
+ [!code-csharp[TPLDataflow_Overview#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#4)]
+ [!code-vb[TPLDataflow_Overview#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#4)]  
+  
+ デリゲートを使用する方法を説明する完全な例については、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>を参照してください[方法: 実行アクションと、データ フロー ブロックでデータを受信](../../../docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md)します。  
+  
+#### <a name="transformblocktinput-toutput"></a>TransformBlock(TInput, TOutput)  
+ <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>クラスに似ています、 <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>クラスをターゲットとして、両方のソースとして動作する点が異なります\</TInput, TOutput>。 デリゲートに渡すことが、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>オブジェクトが型の値を返す`TOutput`</TInput, TOutput>。 提供するデリゲート、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>オブジェクトは、型であることができます`System.Func<TInput, TOutput>`または型`System.Func<TInput, Task>`\</TInput, TOutput>。 使用すると、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>オブジェクトを`System.Func\<TInput, TOutput>`、各入力要素の処理は、デリゲートが返されたときに完了したと見なされます</TInput, TOutput>。 使用すると、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>オブジェクトと共に使用`System.Func<TInput, Task<TOutput>>`、各入力要素の処理が完了した場合にのみと見なさ返された<xref:System.Threading.Tasks.Task>オブジェクトが終了した\</TInput, TOutput>。 同様に<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、これら&2; つのメカニズムを使用すると、使用することができます<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>各入力要素の同期および非同期で処理するためです\</TInput, TOutput>。  
+  
+ 次の基本的な例を作成し、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>入力の平方根を計算するオブジェクト</TInput, TOutput>。 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>オブジェクトは<xref:System.Int32>入力として値を生成<xref:System.Double>出力としての値\</TInput, TOutput>。  
+  
+ [!code-csharp[TPLDataflow_Overview#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#5)]
+ [!code-vb[TPLDataflow_Overview#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#5)]  
+  
+ 使用する完全な例について<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>では、Windows フォーム アプリケーションでイメージ処理を実行するデータ フロー ブロックのネットワーク、[チュートリアル: Windows フォーム アプリケーションでのデータ フローを使用して](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)\</TInput, TOutput>。  
+  
+#### <a name="transformmanyblocktinput-toutput"></a>TransformManyBlock(TInput, TOutput)  
+ <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>クラスに似ています、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>クラスのことを除いて<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>各入力値に値を出力&1; つのみの代わりに、値を入力ごとに&0; 個以上の出力値を生成します</TInput, TOutput></TInput, TOutput></TInput, TOutput>。 提供するデリゲート、 <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>オブジェクトは、型であることができます`System.Func<TInput, IEnumerable<TOutput>>`または`type System.Func<TInput, Task<IEnumerable<TOutput>>>`\</TInput, TOutput>。 使用すると、 <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>オブジェクトを`System.Func<TInput, IEnumerable<TOutput>>`、各入力要素の処理は、デリゲートが返されたときに完了したと見なされます</TInput, TOutput>。 使用すると、 <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>オブジェクトを`System.Func<TInput, Task<IEnumerable<TOutput>>>`、各入力要素の処理が完了される場合にのみと見なさ返された`System.Threading.Tasks.Task<IEnumerable<TOutput>>`オブジェクトが終了した\</TInput, TOutput>。  
+  
+ 次の基本的な例を作成し、 <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>を個々 の文字のシーケンスに文字列を分割するオブジェクト</TInput, TOutput>。 <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>オブジェクトは<xref:System.String>入力として値を生成<xref:System.Char>出力としての値\</TInput, TOutput>。  
+  
+ [!code-csharp[TPLDataflow_Overview#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#6)]
+ [!code-vb[TPLDataflow_Overview#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#6)]  
+  
+ 使用する完全な例について<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>データフロー パイプラインの各入力に複数の独立した出力を生成するを参照してください[チュートリアル: データフロー パイプラインの作成](../../../docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md)。\</TInput, TOutput> 。  
+  
+#### <a name="degree-of-parallelism"></a>並列化の次数  
+ 各<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>、および<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>ブロックが処理できるようになるまで、オブジェクトのバッファーがメッセージを入力します</TInput, TOutput></TInput, TOutput>。 既定では、これらのクラスはメッセージを受信した順序で、一度に&1; つずつ処理します。 有効にする並列処理の次数を指定することも<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>と<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>同時に複数のメッセージを処理するオブジェクト\</TInput, TOutput>\</TInput, TOutput>。 同時実行に関する詳細については、このドキュメントの後の「並列化の次数の指定」のセクションを参照してください。 例については、同時に複数のメッセージを処理する、実行データフロー ブロックを有効にする並列処理の次数を設定する、次を参照してください。[方法: データフロー ブロックで並列処理の次数を指定](../../../docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md)します。  
+  
+#### <a name="summary-of-delegate-types"></a>デリゲート型の概要  
+ 次の表に、デリゲート型を提供できる<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>、および<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>のオブジェクト\</TInput, TOutput>\</TInput, TOutput>。 このテーブルでは、デリゲート型が同期的または非同期的に動作するかどうかについても示しています。  
+  
+|型|同期的なデリゲート型|非同期的なデリゲート型|  
+|----------|-------------------------------|--------------------------------|  
+|<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>|`System.Action`|`System.Func\<TInput, Task>`|  
+|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602></TInput, TOutput>|`System.Func\<TInput, TOutput>`2`|`System.Func<TInput, Task<TOutput>>`|  
+|<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602></TInput, TOutput>|`System.Func<TInput, IEnumerable<TOutput>>`|`System.Func<TInput, Task<IEnumerable<TOutput>>>`|  
+  
+ 実行ブロックの型を使用する場合にラムダ式を使用することもできます。 実行ブロックでラムダ式を使用する方法を示しています。 たとえば、次を参照してください。[方法: 実行アクションと、データ フロー ブロックでデータを受信](../../../docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md)します。  
+  
+### <a name="grouping-blocks"></a>グループ化ブロック  
+ グループ化ブロックは、さまざまな制約の下で&1; つ以上のソースからデータをまとめます。 TPL データ フロー ライブラリは、3 つの結合ブロックの型: <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>、および<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>.\</T1, T2> \</T1, T2>  
+  
+#### <a name="batchblockt"></a>BatchBlock(T)  
+ <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>クラスは、出力データの配列に、バッチと呼ばれる入力データのセットを結合します。 作成するときに、各バッチのサイズを指定する、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトです。 ときに、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトは、指定した数の入力要素を受け取ると、それらの要素を格納する配列を非同期的に伝達します。 場合、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトは、完了状態に設定されていますが、バッチを形成するための十分な要素を含んでいない、残りの入力要素を含む最終的な配列を伝達します。  
+  
+ <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>クラスは、どちらかで動作*最長一致*または*最短*モードです。 既定では最長一致モードで、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトすべてメッセージを受け取り、提供される、指定した数の要素を受け取った後に、配列を伝達します。 最短一致モードで、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトは、十分なソースが、バッチを形成するブロックへのメッセージを提供するまで、すべての受信メッセージを延期します。 最長一致モードでは通常、最短一致モードよりも処理のオーバーヘッドが低いため、パフォーマンスがよくなります。 ただし、アトミックな方法で複数のソースの使用量を調整する必要がある場合、最短一致モードを使用できます。 最短一致モードを設定して指定<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.Greedy%2A>に`False`で、`dataflowBlockOptions`内のパラメーター、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601.%23ctor%2A>コンス トラクターです。  
+  
+ 次の基本的な例がいくつか投稿<xref:System.Int32>値を<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>バッチに&10; 個の要素を保持するオブジェクト。 すべての値が伝達されることを保証するために、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>、この例では、<xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete%2A>メソッドです。 <xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete%2A>メソッドのセット、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトを完了した状態にあり、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトは残りの要素を最終バッチとして伝達します。  
+  
+ [!code-csharp[TPLDataflow_Overview#7](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#7)]
+ [!code-vb[TPLDataflow_Overview#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#7)]  
+  
+ 使用するコード例全体について<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>データベース挿入操作の効率を向上させるために、次を参照してください。[チュートリアル: BatchBlock および BatchedJoinBlock 効率の向上に使用](../../../docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md)します。  
+  
+#### <a name="joinblockt1-t2-"></a>JoinBlock(T1, T2, ...)  
+ <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>と<xref:System.Threading.Tasks.Dataflow.JoinBlock%603>クラスが入力要素を収集し、それを反映<xref:System.Tuple%602?displayProperty=fullName>または<xref:System.Tuple%603?displayProperty=fullName>をそれらの要素を含むオブジェクト\</T1, T2, T3>\</T1, T2>\</T1, T2, T3>\</T1, T2>。 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>と<xref:System.Threading.Tasks.Dataflow.JoinBlock%603>からクラスを継承しない<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>.</T1, T2, T3> </T1, T2> 代わりに、プロパティを提供する<xref:System.Threading.Tasks.Dataflow.JoinBlock%602.Target1%2A>、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602.Target2%2A>、および<xref:System.Threading.Tasks.Dataflow.JoinBlock%603.Target3%2A>を実装する<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>します。  
+  
+ ような<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>と<xref:System.Threading.Tasks.Dataflow.JoinBlock%603> 、最長一致モードまたは最短一致モードで動作します</T1, T2, T3></T1, T2>。 既定では最長一致モードで、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>または<xref:System.Threading.Tasks.Dataflow.JoinBlock%603>オブジェクトが提供され、各ターゲットには、少なくとも&1; つのメッセージを受信した後、タプルを伝達して、すべてのメッセージを受け取り</T1, T2, T3></T1, T2>。 最短一致モードで、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%602>または<xref:System.Threading.Tasks.Dataflow.JoinBlock%603>タプルを作成するために必要なデータがすべてのターゲットに提供されるまで、オブジェクトがすべての受信メッセージを延期します\</T1, T2, T3>\</T1, T2>。 この時点で、ブロックは&2; フェーズ コミット プロトコルによって、ソースからすべての必要な項目をアトミックに取得します。 この延期により、他のエンティティは当面の間データを使用でき、システム全体が進行できます。  
+  
+ 次の基本的な例をケースを示しています、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%603>オブジェクトが複数のデータ値を計算する必要があります</T1, T2, T3>。 この例で作成、 <xref:System.Threading.Tasks.Dataflow.JoinBlock%603>&2; を必要とするオブジェクト<xref:System.Int32>値と<xref:System.Char>算術演算を実行するために\</T1, T2, T3>。  
+  
+ [!code-csharp[TPLDataflow_Overview#8](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#8)]
+ [!code-vb[TPLDataflow_Overview#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#8)]  
+  
+ 使用するコード例全体について<xref:System.Threading.Tasks.Dataflow.JoinBlock%602>協調的なリソースを共有する最短一致モードでのオブジェクトを参照してください[方法: JoinBlock を使用して複数のソースからのデータ読み取りに](../../../docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md)\</T1, T2>。  
+  
+#### <a name="batchedjoinblockt1-t2-"></a>BatchedJoinBlock(T1, T2, ...)  
+ <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>と<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%603>クラスは入力要素のバッチを収集し、それを反映`System.Tuple(IList(T1), IList(T2))`または`System.Tuple(IList(T1), IList(T2), IList(T3))`をそれらの要素を含むオブジェクト\</T1, T2, T3>\</T1, T2>。 考えてみてください<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>の組み合わせとして<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>と<xref:System.Threading.Tasks.Dataflow.JoinBlock%602>.</T1, T2> </T1, T2> 作成するときに、各バッチのサイズを指定する<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>オブジェクト\</T1, T2>。 <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>プロパティも提供<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602.Target1%2A>と<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602.Target2%2A>を実装する<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>します。\</T1, T2> 指定した数の入力要素がすべてのターゲット間でから受信したときに、 <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>オブジェクトは非同期的に伝達、`System.Tuple(IList(T1), IList(T2))`をそれらの要素を含むオブジェクト\</T1, T2>。  
+  
+ 次の基本的な例を作成し、 <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602> 、結果を保持するオブジェクト<xref:System.Int32>値、およびエラーである<xref:System.Exception>のオブジェクト</T1, T2>。 この例は、複数の操作を実行し、結果を書き込む、 <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602.Target1%2A>プロパティ、およびエラーを<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602.Target2%2A>プロパティの<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>オブジェクト\</T1, T2>。 操作の成功と失敗の数はわからないため、事前に、 <xref:System.Collections.Generic.IList%601>オブジェクトは、0 個以上の値を受け取り、各ターゲットを有効にします。  
+  
+ [!code-csharp[TPLDataflow_Overview#9](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_overview/cs/program.cs#9)]
+ [!code-vb[TPLDataflow_Overview#9](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_overview/vb/program.vb#9)]  
+  
+ 使用するコード例全体について<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>結果と、プログラムがデータベースから読み取るときに発生したすべての例外の両方をキャプチャするを参照してください[チュートリアル: BatchBlock および BatchedJoinBlock 効率の向上に使用](../../../docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md)。\</T1, T2> 。  
+  
+ [[go to top](#top)]  
+  
+<a name="behavior"></a>   
+## <a name="configuring-dataflow--block-behavior"></a>データフロー ブロックの動作を構成する  
+ 提供することによって追加のオプションを有効にすることができます、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions?displayProperty=fullName>データ フロー ブロックの型のコンス トラクターにオブジェクトです。 これらのオプションは、基になるタスクと並列化の次数を管理するスケジューラなどの動作を制御します。 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions>派生は、特定のデータ フロー ブロックの型に固有の動作を指定する型があります。 各データ フロー ブロックの型に関連付けられているオプション型の概要を次の表に示します。  
+  
+|データ フロー ブロックの型|<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions>型|  
+|-------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|  
+|<xref:System.Threading.Tasks.Dataflow.BufferBlock%601>|<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601>|<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601>|<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>|<xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>\</TInput, TOutput>|<xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>\</TInput, TOutput>|<xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>|<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.JoinBlock%602>\</T1, T2>|<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions>|  
+|<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>\</T1, T2>|<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions>|  
+  
+ ブロックのオプションで使用可能な重要なデータ フローに関する追加情報を提供する次のセクションで、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions?displayProperty=fullName>、 <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions?displayProperty=fullName>、および<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions?displayProperty=fullName>クラスです。  
+  
+### <a name="specifying-the-task-scheduler"></a>タスク スケジューラの指定  
+ すべての定義済みのデータ フロー ブロックは TPL タスク スケジューリング メカニズムを使って、ターゲットへのデータの伝達、ソースからのデータの受け取り、データが使用可能になったときのユーザー定義のデリゲートの実行、などのアクティビティを実行します。 <xref:System.Threading.Tasks.TaskScheduler>タスクのスレッドにキューに配置するタスク スケジューラを表す抽象クラスです。 既定のタスク スケジューラ<xref:System.Threading.Tasks.TaskScheduler.Default%2A>を使用して、 <xref:System.Threading.ThreadPool>クラスをキューにして、作業を実行します。 既定のタスク スケジューラを設定して上書きできます、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler%2A>プロパティのデータ フロー ブロック オブジェクトを構築するとき。  
+  
+ 同じタスク スケジューラが複数のデータ フロー ブロックを管理する場合、それらにポリシーを強制的に適用できます。 たとえば、複数のデータ フロー ブロックはそれぞれ同じの排他スケジューラを対象とする構成<xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair>オブジェクトに、これらのブロックにわたって実行をシリアル化するすべての作業です。 同様に、これらのブロックが同一の同時スケジューラをターゲットに構成されている場合<xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair>オブジェクト、およびそのスケジューラが設定されている最大同時実行レベルは、これらのブロックのすべての操作が同時操作の数に制限されます。 使用する例については、 <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair>を並列で発生しますが、書き込み操作に他のすべての操作ののみ発生する可能性は、「の読み取り操作を有効にするクラス[方法: データフロー ブロックでタスク スケジューラを指定する](../../../docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md)です。 TPL のタスク スケジューラに関する詳細については、次を参照してください。、 <xref:System.Threading.Tasks.TaskScheduler>クラスに関するトピック。  
+  
+### <a name="specifying-the-degree-of-parallelism"></a>並列化の次数の指定  
+ 既定では、TPL データフロー ライブラリが提供する&3; つの実行ブロックの型<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>、および<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>、一度に&1; つのメッセージを処理します\</TInput, TOutput>\</TInput, TOutput>。 これらのデータ フロー ブロックの型は、メッセージを受け取った順番でそれを処理します。 これらのデータ フロー ブロックがメッセージを同時に処理を有効にするには設定、 <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A?displayProperty=fullName>プロパティのデータ フロー ブロック オブジェクトを構築するとき。  
+  
+ 既定値の<xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A>は 1 で、データ フロー ブロックが一度に 1 つのメッセージを処理することを保証します。 このプロパティに 1 を超える値に設定すると、データ フロー ブロックは複数のメッセージを同時に処理できます。 このプロパティを設定<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.Unbounded?displayProperty=fullName>により、基になるタスク スケジューラは最大同時実行の程度を管理します。  
+  
+> [!IMPORTANT]
+>  並列処理の最大範囲に 1 を超える数を指定すると、複数のメッセージを同時に処理するため、メッセージが受信した順序で処理されない場合があります。 ただし、ブロックからメッセージが出力される順序は正しく並べ替えられます。  
+  
+ <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A>プロパティは並列処理の最大限度を表しますは、データ フロー ブロックは、指定より低い並列化の度合いで実行可能性があります。 機能要件を満たすため、または使用可能なシステム リソースの不足のため、データ フロー ブロックは、より低い並列化の度合いを使う場合があります。 データ フロー ブロックは、指定より大きな並列化を選択することはありません。  
+  
+ 値、 <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A>プロパティは、各データ フロー ブロックのオブジェクトに排他的です。 たとえば、4 つのデータ フロー ブロックのオブジェクトが並列処理の最大範囲にそれぞれ 1 を指定した場合、4 つすべてのデータ フロー ブロック オブジェクトを並列に実行できる場合もあります。  
+  
+ 例の並列で実行する時間のかかる操作を有効にする並列処理の最大限度を設定する場合は、次を参照してください。[方法: データフロー ブロックで並列処理の次数を指定](../../../docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md)します。  
+  
+### <a name="specifying-the-number-of-messages-per-task"></a>タスクごとのメッセージ数の指定  
+ 定義済みのデータ フロー ブロックの型は、複数の入力要素を処理するタスクを使用します。 これによって、データを処理するために必要なタスクのオブジェクトの数を最小限に抑えることができ、アプリケーションを効率的に実行できます。 ただし、一連のデータ フロー ブロックのタスクがデータを処理する場合、他のデータ フロー ブロックのタスクはメッセージをキューに置いて処理の時間を待機する必要がある場合があります。 データ フロー タスク間での高い公平性を有効にするには設定、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.MaxMessagesPerTask%2A>プロパティです。 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.MaxMessagesPerTask%2A>に設定されている<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.Unbounded?displayProperty=fullName>、既定値は、データ フロー ブロックが使用するタスクが、使用可能な限り多くのメッセージを処理します。 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.MaxMessagesPerTask%2A>以外の値に設定されて<xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.Unbounded>、最大でこのあたりのメッセージの数を処理、データ フロー ブロック<xref:System.Threading.Tasks.Task>オブジェクトです。 設定が、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.MaxMessagesPerTask%2A>プロパティは、タスク間で公平性を向上できますその場合は、必要以上のタスクを作成するには、システムがあり、パフォーマンスが低下することができます。  
+  
+### <a name="enabling-cancellation"></a>取り消しの有効化  
+ TPL はタスクが協調的な方法によって取り消しの調整をできる機構を提供します。 この取り消し機構に参加するデータフロー ブロックを有効にするには設定、 <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A>プロパティです。 ときにこの<xref:System.Threading.CancellationToken>オブジェクトが取り消された状態に設定されている場合、このトークンを監視するすべてのデータ フロー ブロックは、現在の項目の実行を完了しますが、後続の項目は開始されません。 また、これらのデータ フロー ブロックはすべてのバッファリングされたメッセージをクリアし、すべてのソースとターゲット ブロックへの接続を解放し、取り消し状態に遷移します。 取り消し状態に遷移すると、<xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Completion%2A>プロパティには、<xref:System.Threading.Tasks.Task.Status%2A>プロパティに設定<xref:System.Threading.Tasks.TaskStatus>処理中に例外が発生した場合を除き、します。 その場合は、<xref:System.Threading.Tasks.Task.Status%2A>に設定されている<xref:System.Threading.Tasks.TaskStatus>します。  
+  
+ 例については、Windows フォーム アプリケーションで取り消しを使用する方法については、次を参照してください。[方法: データフロー ブロックをキャンセル](../../../docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md)します。 TPL での取り消し処理の詳細については、次を参照してください。[タスクのキャンセル](../../../docs/standard/parallel-programming/task-cancellation.md)します。  
+  
+### <a name="specifying-greedy-versus-non-greedy-behavior"></a>最長一致と最短一致の動作の指定  
+ 複数のグループ化データ フロー ブロックの型は、どちらかで動作できる*最長一致*または*最短*モードです。 既定では、定義済みのデータ フロー ブロックの型は、最長一致モードで動作します。  
+  
+ 結合などのブロック<xref:System.Threading.Tasks.Dataflow.JoinBlock%602>、最長一致モードでは、結合に使用する、対応するデータがまだ使用できない場合でも、ブロックがそのデータを即座に受け入れることを意味します</T1, T2>。 最短一致モードは、ターゲットのそれぞれで結合が完了できるように使用可能になるまで、ブロックがすべての受信メッセージを延期することを意味します。 延期されたメッセージのいずれかが使用できなくなった場合、結合ブロックは延期されたすべてのメッセージを解放し、プロセスを再起動します。 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>クラス、最長一致と最短一致の動作は似ていますが、最短一致モードでは、下にあることを除いて、 <xref:System.Threading.Tasks.Dataflow.BatchBlock%601>オブジェクトが、バッチを完了する別のソースから利用可能なために十分なするまで、すべての受信メッセージを延期します。  
+  
+ データ フロー ブロックに最短一致モードを指定する<xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.Greedy%2A>に`False`します。 例については、最短一致モードを使用して、データ ソースをより効率的に共有する複数の結合ブロックを有効にする方法については、次を参照してください。[方法: JoinBlock を使用して複数のソースからのデータ読み取りを](../../../docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md)します。  
+  
+ [[go to top](#top)]  
+  
+<a name="custom"></a>   
+## <a name="custom-dataflow-blocks"></a>カスタム データ フロー ブロック  
+ TPL データ フロー ライブラリは多くの定義済みブロックの型を提供しますが、カスタム動作を実行する追加のブロックの型を作成できます。 実装、 <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601>または<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>インターフェイスを直接またはを使用して、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Encapsulate%2A>既存のブロックの型の動作をカプセル化する複雑なブロックを構築するメソッド\</TInput, TOutput>。 カスタム データ フロー ブロックの機能を実装する方法を示す例については、次を参照してください。[チュートリアル: カスタム データフロー ブロックの型を作成する](../../../docs/standard/parallel-programming/walkthrough-creating-a-custom-dataflow-block-type.md)です。  
+  
+ [[go to top](#top)]  
+  
+## <a name="related-topics"></a>関連トピック  
+  
+|タイトル|説明|  
+|-----------|-----------------|  
+|[方法: メッセージを書き込むし、データ フロー ブロックからメッセージを読み取る](../../../docs/standard/parallel-programming/how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md)|メッセージを書き込むし、メッセージを読み取る方法を示しています、 <xref:System.Threading.Tasks.Dataflow.BufferBlock%601>オブジェクトです。|  
+|[方法: プロデューサー/コンシューマーのデータフロー パターンを実装します。](../../../docs/standard/parallel-programming/how-to-implement-a-producer-consumer-dataflow-pattern.md)|データ フロー モデルを使ってプロデューサー/コンシューマー パターンを実装し、プロデューサーがデータ フロー ブロックにメッセージを送信して、コンシューマーがそのブロックからメッセージを読み取る方法を示します。|  
+|[方法: データフロー ブロックがデータを受信すると、操作を実行](../../../docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md)|実行データ フロー ブロックの型にデリゲートを提供する方法について説明<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、 <xref:System.Threading.Tasks.Dataflow.TransformBlock%602>、および<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>.\</TInput, TOutput> \</TInput, TOutput>|  
+|[チュートリアル: データフロー パイプラインの作成](../../../docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md)|Web からテキストをダウンロードし、そのテキストの操作を実行する、データ フロー パイプラインを作成する方法について説明します。|  
+|[方法: データフロー ブロックのリンクを解除](../../../docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md)|使用する方法を示しています、<xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A>ソースをターゲットにメッセージを提供した後、ソースからターゲット ブロックのリンクを解除するメソッドです。|  
+|[チュートリアル: Windows フォーム アプリケーションでのデータ フローの使用](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)|Windows フォーム アプリケーションでイメージ処理を実行する、データ フロー ブロックのネットワークを作成する方法を示します。|  
+|[方法: データフロー ブロックをキャンセル](../../../docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md)|Windows フォーム アプリケーションで取り消しを使う方法を説明します。|  
+|[方法: JoinBlock を使用して、複数のソースからデータを読み取る](../../../docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md)|使用する方法について説明します<xref:System.Threading.Tasks.Dataflow.JoinBlock%602>最短一致モードを使用して、データ ソースをより効率的に共有する複数の結合ブロックを有効にする方法と、複数のソースからデータがある場合、操作を実行するクラス\</T1, T2>。|  
+|[方法: データフロー ブロックで並列処理の次数を指定](../../../docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md)|設定する方法について説明します、 <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A>プロパティを同時に複数のメッセージを処理する、実行データフロー ブロックを有効にします。|  
+|[方法: データフロー ブロックでタスク スケジューラを指定します。](../../../docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md)|アプリケーションでデータ フローを使用する場合に特定のタスク スケジューラを関連付ける方法を示します。|  
+|[チュートリアル: BatchBlock および BatchedJoinBlock を効率を向上させるために使用します。](../../../docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md)|使用する方法について説明します<xref:System.Threading.Tasks.Dataflow.BatchBlock%601>データベースの効率を向上させるためにクラスの挿入操作、および使用する方法、 <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602>結果と、プログラムがデータベースから読み取るときに発生したすべての例外の両方をキャプチャするクラス\</T1, T2>。|  
+|[チュートリアル: カスタム データフロー ブロックの型を作成します。](../../../docs/standard/parallel-programming/walkthrough-creating-a-custom-dataflow-block-type.md)|カスタム動作を実装するデータ フロー ブロックの型を作成する&2; とおりの方法を示します。|  
+|[タスク並列ライブラリ (TPL)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)|[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] アプリケーションの並列処理と並列プログラミングを簡略化するライブラリである TPL を紹介します。|
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/exception-handling-task-parallel-library.md b/docs/standard/parallel-programming/exception-handling-task-parallel-library.md
new file mode 100644
index 00000000000..be7b86389ab
--- /dev/null
+++ b/docs/standard/parallel-programming/exception-handling-task-parallel-library.md
@@ -0,0 +1,96 @@
+---
+title: "例外処理 (タスク並列ライブラリ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "タスク、例外"
+ms.assetid: beb51e50-9061-4d3d-908c-56a4f7c2e8c1
+caps.latest.revision: 21
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 21
+---
+# 例外処理 (タスク並列ライブラリ)
+タスク内で実行中のユーザー コードによってスローされた、ハンドルされない例外は、呼び出し元のスレッドに反映されます。ただし、このトピックの後半で説明している特定の状況を除きます。 静的な、またはインスタンスの <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> メソッドまたは <xref:System.Threading.Tasks.Task%601.Wait%2A?displayProperty=fullName> メソッドの 1 つを使用し、その呼び出しを `try`\/`catch` ステートメント内に入れて例外を処理すると、例外が反映されます。 タスクが、アタッチされた子タスクの親である場合、または複数のタスクを待機している場合、複数の例外がスローされることがあります。  
+  
+ 呼び出し元のスレッドにすべての例外を反映するために、Task インフラストラクチャが例外を <xref:System.AggregateException> インスタンスにラップします。<xref:System.AggregateException> 例外には、スローされた元のすべての例外を調べるために列挙できる <xref:System.AggregateException.InnerExceptions%2A> プロパティがあり、個々に処理したり未処理にしたりできます。 また、<xref:System.AggregateException.Handle%2A?displayProperty=fullName> メソッドを使用して元の例外を処理することもできます。  
+  
+ 例外が 1 つだけスローされた場合でも、次の例のように <xref:System.AggregateException> 例外にラップされます。  
+  
+ [!code-csharp[TPL_Exceptions#21](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/handling21.cs#21)]
+ [!code-vb[TPL_Exceptions#21](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/handling21.vb#21)]  
+  
+ ハンドルされない例外は、<xref:System.AggregateException> をキャッチして、内部例外を確認しないことで回避できます。 ただし、並列でない状況で基本的な <xref:System.Exception> の種類をキャッチする場合と類似しているため、この操作はお勧めしません。 特定の操作を取得することなく例外をキャッチして回復しようとすると、プログラムが中間状態のままになるおそれがあります。  
+  
+ <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> または <xref:System.Threading.Tasks.Task%601.Wait%2A?displayProperty=fullName> メソッドを呼び出してタスクの完了を待機する処理を行わない場合は、次の例のようにタスクの <xref:System.Threading.Tasks.Task.Exception%2A> プロパティから <xref:System.AggregateException> 例外を取得することもできます。 詳細については、このトピックの「[Task.Exception プロパティによる例外の確認](#ExceptionProp)」セクションを参照してください。  
+  
+ [!code-csharp[TPL_Exceptions#29](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/handling22.cs#29)]
+ [!code-vb[TPL_Exceptions#29](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/handling22.vb#29)]  
+  
+ 例外を反映するタスクを待機しない場合、またはタスクの <xref:System.Threading.Tasks.Task.Exception%2A> プロパティにアクセスする場合、例外はタスクがガベージ コレクトされるときに .NET の例外ポリシーに従ってエスカレートされます。  
+  
+ 連結しているスレッドへ例外が上方向に通知されると、例外が発生した後も、タスクによって一部の項目の処理が続行される可能性があります。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されることがあります。 このエラーは問題にはなりません。 F5 キーを押して続行し、以下の例に示す例外処理動作を確認できます。 Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\]** メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\] で **\[マイ コードのみを有効にする\]** チェック ボックスをオフにします。  
+  
+## アタッチされた子タスクと入れ子の AggregateExceptions  
+ タスクに、例外をスローする子タスクがアタッチされている場合、その例外は親タスクに反映される前に <xref:System.AggregateException> でラップされます。つまり、呼び出し元のスレッドに反映される前に、その例外が固有の <xref:System.AggregateException> でラップされるということです。 このような場合、<xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> または <xref:System.Threading.Tasks.Task%601.Wait%2A?displayProperty=fullName> または <xref:System.Threading.Tasks.Task.WaitAny%2A> または <xref:System.Threading.Tasks.Task.WaitAll%2A> の各メソッドでキャッチされた <xref:System.AggregateException> 例外の <xref:System.AggregateException.InnerExceptions%2A> プロパティには、違反の原因となった元の例外ではなく、1 つ以上の <xref:System.AggregateException> インスタンスが含まれます。 入れ子の <xref:System.AggregateException> 例外を反復処理しなくて済むようにするには、<xref:System.AggregateException.Flatten%2A> メソッドを使用して入れ子の <xref:System.AggregateException> をすべて削除します。これにより、<xref:System.AggregateException.InnerExceptions%2A?displayProperty=fullName> プロパティに元の例外が含まれるようになります。 次の例では、入れ子の <xref:System.AggregateException> インスタンスが 1 つのループで平坦化され、処理されています。  
+  
+ [!code-csharp[TPL_Exceptions#22](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/flatten2.cs#22)]
+ [!code-vb[TPL_Exceptions#22](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/flatten2.vb#22)]  
+  
+ また、次の例のように、<xref:System.AggregateException.Flatten%2A?displayProperty=fullName> メソッドを使用して、単一の <xref:System.AggregateException> インスタンス内の複数のタスクによってスローされた複数の <xref:System.AggregateException> インスタンスから内部例外を再スローすることもできます。  
+  
+ [!code-csharp[TPL_Exceptions#13](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/taskexceptions2.cs#13)]
+ [!code-vb[TPL_Exceptions#13](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/taskexceptions2.vb#13)]  
+  
+## デタッチされた子タスクの例外  
+ 既定では、子タスクはデタッチされた状態で作成されます。 デタッチされたタスクからスローされた例外は、処理されるか、直接の親に再スローされる必要があります。これらの例外は、アタッチされた子タスクが反映されるのとは異なる方法で、呼び出し元のスレッドに反映されます。 最上位の親では、デタッチされた子からの例外を手動で再スローすることで、<xref:System.AggregateException> にラップして、呼び出し元のスレッドに反映させることができます。  
+  
+ [!code-csharp[TPL_Exceptions#23](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/detached21.cs#23)]
+ [!code-vb[TPL_Exceptions#23](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/detached21.vb#23)]  
+  
+ 子タスク内の例外を確認するために継続を使用する場合でも、親タスクによって例外を確認する必要があります。  
+  
+## 他の処理との連携によるキャンセル処理を示す例外  
+ タスク内のユーザー コードがキャンセル要求に応答する場合の正しいプロシージャは、その要求が伝えられたキャセル トークンに渡すために <xref:System.OperationCanceledException> をスローすることです。 例外が反映される前に、タスク インスタンスによって、例外内のトークンがそのタスクが作成されたときに渡されたトークンと比較されます。 それらが同じである場合、タスクは <xref:System.Threading.Tasks.TaskCanceledException> でラップされた <xref:System.AggregateException> を反映します。これは、内部例外を調べると確認できます。 ただし、呼び出し元のスレッドがタスクを待機していない場合、このような特定の例外は反映されません。 詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」を参照してください。  
+  
+ [!code-csharp[TPL_Exceptions#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/exceptions.cs#4)]
+ [!code-vb[TPL_Exceptions#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/tpl_exceptions.vb#4)]  
+  
+## 内部例外をフィルター処理する Handle メソッドの使用  
+ <xref:System.AggregateException.Handle%2A?displayProperty=fullName> メソッドを使用すると、"処理済み" として扱うことのできる例外をフィルターで除外できます。追加のロジックを使用する必要はありません。<xref:System.AggregateException.Handle%28System.Func%7BSystem.Exception%2CSystem.Boolean%7D%29?displayProperty=fullName> メソッドに用意されているユーザー デリゲートでは、例外の種類、その <xref:System.Exception.Message%2A> プロパティ、またはその例外に問題がないかどうかを判別できるその他の情報を調べることができます。 デリゲートが `false` を返す例外は、<xref:System.AggregateException.Handle%2A?displayProperty=fullName> メソッドが返された直後に新しい <xref:System.AggregateException> インスタンスで再スローされます。  
+  
+ 次の例は、機能的には、<xref:System.AggregateException.InnerExceptions%2A?displayProperty=fullName> コレクション内の各例外を調べるこのトピックの最初の例と同じです。  代わりに、この例外ハンドラーでは、例外ごとに <xref:System.AggregateException.Handle%2A?displayProperty=fullName> メソッドのオブジェクトを呼び出し、`CustomException` インスタンスでない例外のみを再スローしています。  
+  
+ [!code-csharp[TPL_Exceptions#26](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/handlemethod21.cs#26)]
+ [!code-vb[TPL_Exceptions#26](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/handlemethod21.vb#26)]  
+  
+ 次の例はさらに複雑です。<xref:System.AggregateException.Handle%2A?displayProperty=fullName> メソッドを使用して、ファイルの列挙時に <xref:System.UnauthorizedAccessException> 例外の特別な処理を行っています。  
+  
+ [!code-csharp[TPL_Exceptions#12](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/taskexceptions.cs#12)]
+ [!code-vb[TPL_Exceptions#12](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/taskexceptions.vb#12)]  
+  
+<a name="ExceptionProp"></a>   
+## Task.Exception プロパティによる例外の確認  
+ タスクが <xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態で完了した場合、その <xref:System.Threading.Tasks.Task.Exception%2A> プロパティを調べることで違反の原因となった例外を見つけることができます。<xref:System.Threading.Tasks.Task.Exception%2A> プロパティを確認する場合は、次の例に示すように、継続元タスクが違反した場合にのみ実行される継続を使用することをお勧めします。  
+  
+ [!code-csharp[TPL_Exceptions#27](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/exceptionprop21.cs#27)]
+ [!code-vb[TPL_Exceptions#27](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/exceptionprop21.vb#27)]  
+  
+ 実際のアプリケーションでは、継続のデリゲートで例外に関する詳細情報を記録して、新しいタスクを作成して例外から回復することが考えられます。  
+  
+## UnobservedTaskException イベント  
+ 信頼関係のないプラグインをホストするときなど、シナリオによっては、問題のない例外がよく発生する場合や、難しすぎてすべてを手動で観察できなくなる場合があります。 このような場合、<xref:System.Threading.Tasks.TaskScheduler.UnobservedTaskException?displayProperty=fullName> イベントを処理できます。 ハンドラーに渡される <xref:System.Threading.Tasks.UnobservedTaskExceptionEventArgs?displayProperty=fullName> インスタンスを使用して、観察されない例外が連結しているスレッドに反映されないようにすることができます。  
+  
+## 参照  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/for-further-reading-parallel-programming.md b/docs/standard/parallel-programming/for-further-reading-parallel-programming.md
new file mode 100644
index 00000000000..eeba11c5b98
--- /dev/null
+++ b/docs/standard/parallel-programming/for-further-reading-parallel-programming.md
@@ -0,0 +1,36 @@
+---
+title: "For Further Reading (Parallel Programming) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, further reading"
+ms.assetid: 98aee307-dde6-4cad-bb58-078497b8064f
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# For Further Reading (Parallel Programming)
+次のリソースには、.NET Framework における並列プログラミングについての追加情報が含まれています。  
+  
+-   [並列 Developer Center 計算](http://go.microsoft.com/fwlink/?LinkID=160570) MSDN Web サイトの .NET Framework およびネイティブ C\+\+ の並列プログラミングに関する最新のコンテンツおよびフォーラム ポストへのリンクがあります。  
+  
+-   [.NET のブログとの Parallel Programming](http://go.microsoft.com/fwlink/?LinkID=169627) MSDN ブログ サイトは .NET Framework における並列プログラミングに関する詳しい記事を紹介します。  
+  
+-   [同時実行ビジュアライザー ブログ](http://go.microsoft.com/fwlink/?LinkID=169630) MSDN ブログ サイトは [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)]の一部のエディションに付属している新しいパフォーマンス プロファイリング ツールについて説明します。  
+  
+-   [並列拡張フォーラム](http://go.microsoft.com/fwlink/?LinkID=169628) MSDN フォーラム サイトが並列プログラミングに関する質疑応答またはオンになります。  
+  
+-   [並列拡張機能の例](http://go.microsoft.com/fwlink/?LinkID=165717) MSDN Code Gallery Web サイトのページには、中級および高度な並列プログラミング技法を紹介する多くの例が含まれています。  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Parallel Programming のパターン: .NET Framework 4 の Understanding and Applying Parallel Patterns](http://go.microsoft.com/fwlink/?LinkID=185142)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md b/docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md
new file mode 100644
index 00000000000..815ef35686a
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md
@@ -0,0 +1,104 @@
+---
+title: "How to: Cancel a Dataflow Block | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "dataflow blocks, canceling in TPL"
+  - "TPL dataflow library,canceling dataflow blocks"
+ms.assetid: fbddda0d-da3b-4ec8-a1d6-67ab8573fcd7
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# How to: Cancel a Dataflow Block
+ここでは、アプリケーションのキャンセルを可能にする方法を示しています。  この例では、作業項目がキャンセルのデータフロー パイプラインと、結果がアクティブである場所を示すために、Windows のフォームを使用します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+### Windows フォーム アプリケーションを作成するには  
+  
+1.  C\# または Visual Basic **\[Windows フォーム アプリケーション\]** のプロジェクトを作成します。  次の手順では、プロジェクトは `CancellationWinForms`という名前です。  
+  
+2.  メイン フォームのフォーム デザイナーで、Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の Form1.vb\) は、<xref:System.Windows.Forms.ToolStrip> のコントロールを追加します。  
+  
+3.  <xref:System.Windows.Forms.ToolStrip> のコントロールに <xref:System.Windows.Forms.ToolStripButton> のコントロールを追加します。  作業項目を追加するに <xref:System.Windows.Forms.ToolStripItemDisplayStyle> に <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> のプロパティと <xref:System.Windows.Forms.ToolStripItem.Text%2A> のプロパティを設定します。  
+  
+4.  <xref:System.Windows.Forms.ToolStrip> のコントロールに秒の <xref:System.Windows.Forms.ToolStripButton> のコントロールを追加します。  キャンセルに <xref:System.Windows.Forms.ToolStripItemDisplayStyle>に <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> のプロパティ、<xref:System.Windows.Forms.ToolStripItem.Text%2A> のプロパティ、および `False`に <xref:System.Windows.Forms.ToolStripItem.Enabled%2A> のプロパティを設定します。  
+  
+5.  <xref:System.Windows.Forms.ToolStrip> のコントロールへの <xref:> System.Windows.Forms.ToolStripProgressBar?qualifyHint=False&autoUpgrade=True の 4 種類のオブジェクトを追加します。  
+  
+## データフロー パイプラインの作成  
+ ここでは、データ フローのパイプラインを作成する方法と、作業の処理方法を説明し、プログレス バーを更新します。  
+  
+#### データフロー パイプラインを作成します。  
+  
+1.  プロジェクトで、System.Threading.Tasks.Dataflow.dll への参照を追加します。  
+  
+2.  Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の Form1.vb\) が `using` の次のステートメント \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`Imports`\) が含まれていることを確認します。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#1)]
+     [!code-vb[TPLDataflow_CancellationWinForms#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#1)]  
+  
+3.  `Form1` クラスの内部の型として `WorkItem` クラスを追加します。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#2)]
+     [!code-vb[TPLDataflow_CancellationWinForms#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#2)]  
+  
+4.  `Form1` クラスに次のデータ メンバーを追加します。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#3)]
+     [!code-vb[TPLDataflow_CancellationWinForms#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#3)]  
+  
+5.  `Form1` クラスに次のメソッド、`CreatePipeline`を追加します。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#4)]
+     [!code-vb[TPLDataflow_CancellationWinForms#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#4)]  
+  
+ `incrementProgress` と `decrementProgress` のデータ フローのブロックがユーザー インターフェイスで機能するため、これらの操作がユーザー インターフェイス スレッドで発生することが重要です。  構築中にこれを実行するには、これらのオブジェクトは、<xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName>に <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler%2A> のプロパティ セットを持つ <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions> オブジェクトを提供します。  <xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName> のメソッドは、現在の同期コンテキストの作業を実行 <xref:System.Threading.Tasks.TaskScheduler> オブジェクトを作成します。  `Form1` のコンストラクターがユーザー インターフェイス スレッドから呼び出されるため、`incrementProgress` と `decrementProgress` のデータ フローのブロックの操作では、ユーザー インターフェイス スレッドで実行されます。  
+  
+ この例では、パイプラインのメンバーを構築するときに <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A> のプロパティを設定します。  <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A> のプロパティが完全にデータ フローの実行をブロックするため、すべてのパイプラインはユーザー取り消しの完了後にアクション作り直されなければなり、パイプラインによりも多くの作業項目を追加する必要があります。  操作がキャンセルされた後に他の作業を実行できるように、データ フローのブロックを取り消す方法を示す例については、[Walkthrough: Using Dataflow in a Windows Forms Application](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)を参照してください。  
+  
+## ユーザー インターフェイスにデータフロー パイプラインをアタッチできます。  
+ ここでは、ユーザー インターフェイスにデータフロー パイプラインを追加する方法について説明します。  パイプラインを作成し、パイプラインに作業項目を追加すると、追加作業項目ボタンのイベント ハンドラーによって制御されます。  取り消し処理はキャンセル ボタンで開始します。  ユーザーがこれらのボタンのいずれかをクリックすると、適切なアクションを非同期的に開始されます。  
+  
+#### データフロー パイプラインをユーザー インターフェイスに接続するには  
+  
+1.  メイン フォームのフォーム デザイナーで、作業項目の追加ボタン <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成します。  
+  
+2.  追加の作業項目ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベントを実装してください。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#5)]
+     [!code-vb[TPLDataflow_CancellationWinForms#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#5)]  
+  
+3.  メイン フォームのフォーム デザイナーで、キャンセル ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> のイベント ハンドラーのイベント ハンドラーを作成します。  
+  
+4.  キャンセル ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> のイベント ハンドラーを実装してください。  
+  
+     [!code-csharp[TPLDataflow_CancellationWinForms#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#6)]
+     [!code-vb[TPLDataflow_CancellationWinForms#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#6)]  
+  
+## 使用例  
+ 次の例は、Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の Form1.vb\) の完全なコードを示しています。  
+  
+ [!code-csharp[TPLDataflow_CancellationWinForms#100](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_cancellationwinforms/cs/cancellationwinforms/form1.cs#100)]
+ [!code-vb[TPLDataflow_CancellationWinForms#100](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_cancellationwinforms/vb/cancellationwinforms/form1.vb#100)]  
+  
+ 次の図では、実行中のアプリケーションを示します。  
+  
+ ![Windows フォーム アプリケーション](../../../docs/standard/parallel-programming/media/tpldataflow-cancellation.png "TPLDataflow\_Cancellation")  
+  
+## 信頼性の高いプログラミング  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-cancel-a-parallel-for-or-foreach-loop.md b/docs/standard/parallel-programming/how-to-cancel-a-parallel-for-or-foreach-loop.md
new file mode 100644
index 00000000000..b65f429e9d0
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-cancel-a-parallel-for-or-foreach-loop.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Cancel a Parallel.For or ForEach Loop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel foreach loop, how to cancel"
+  - "parallel for loops, how to cancel"
+ms.assetid: 9d19b591-ea95-4418-8ea7-b6266af9905b
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# How to: Cancel a Parallel.For or ForEach Loop
+<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドおよび <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> メソッドは、キャンセル トークンを使用したキャンセルをサポートしています。  一般的なキャンセルの詳細については、「[キャンセル](../../../docs/standard/threading/cancellation-in-managed-threads.md)」を参照してください。  並列ループでは、<xref:System.Threading.CancellationToken> を <xref:System.Threading.Tasks.ParallelOptions> パラメーターのメソッドに指定し、並列呼び出しを try\-catch ブロックで囲みます。  
+  
+## 使用例  
+ 次の例は、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> への呼び出しを取り消す方法を示しています。  同じ方法を <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> の呼び出しにも適用できます。  
+  
+ [!code-csharp[TPL_Parallel#29](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/parallel_cancel.cs#29)]
+ [!code-vb[TPL_Parallel#29](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/cancelloop.vb#29)]  
+  
+ トークンによって、キャンセルが <xref:System.Threading.Tasks.ParallelOptions> インスタンスで指定されたトークンと同じであることが示された場合、並列ループは取り消し時に単一の <xref:System.OperationCanceledException> をスローします。  その他のトークンによってキャンセルが発生した場合、ループは <xref:System.OperationCanceledException> と共に <xref:System.AggregateException> を InnerException としてスローします。  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md b/docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md
new file mode 100644
index 00000000000..df86554cdaf
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md
@@ -0,0 +1,57 @@
+---
+title: "How to: Cancel a PLINQ Query | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to cancel"
+  - "cancellation, PLINQ"
+ms.assetid: 80b14640-edfa-4153-be1b-3e003d3e9c1a
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# How to: Cancel a PLINQ Query
+次の例では、PLINQ クエリを取り消す 2 とおりの方法を示します。  最初の例では、そのほとんどがデータ走査で構成されるクエリを取り消す方法を示します。  2 番目の例では、負荷の大きいユーザー関数を含むクエリを取り消す方法を示します。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されます。このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\]** メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\] で \[マイ コードのみ\] チェック ボックスをオフにします。  
+>   
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[PLINQ#16](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#16)]
+ [!code-vb[PLINQ#16](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#16)]  
+  
+ PLINQ のフレームワークでは、単一の <xref:System.OperationCanceledException> は <xref:System.AggregateException?displayProperty=fullName> に組み込まれないため、<xref:System.OperationCanceledException> を独立した catch ブロックとして扱う必要があります。  一つ以上のユーザー デリゲートが OperationCanceledException PLINQ が <xref:System.AggregateException?displayProperty=fullName>ではなく単一の <xref:System.OperationCanceledException> \(externalCT\) を出力 \(externalCT\) \(外部 <xref:System.Threading.CancellationToken?displayProperty=fullName>を使用\)、他の例外スローしないし、クエリが `AsParallel().WithCancellation(externalCT)`と定義されている。  ただし、1 つのユーザー デリゲートが <xref:System.OperationCanceledException> をスローし、別のデリゲートがその他の例外の種類をスローした場合は、両方の例外が <xref:System.AggregateException> に組み込まれます。  
+  
+ キャンセルの一般的なガイダンスを次に示します。  
+  
+1.  ユーザー デリゲートのキャンセルを実行する場合は、PLINQ に外部の <xref:System.Threading.CancellationToken> を示して、<xref:System.OperationCanceledException>\(externalCT\) をスローする必要があります。  
+  
+2.  キャンセルが発生したときに別の例外がスローされていない場合は、<xref:System.AggregateException> ではなく、<xref:System.OperationCanceledException> を処理する必要があります。  
+  
+## 使用例  
+ 次の例は、ユーザー コードに負荷の大きい関数が含まれる場合に、キャンセルを処理する方法を示しています。  
+  
+ [!code-csharp[PLINQ#17](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#17)]
+ [!code-vb[PLINQ#17](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#17)]  
+  
+ キャンセルをユーザー コードで処理する場合、クエリの定義で <xref:System.Linq.ParallelEnumerable.WithCancellation%2A> を使用する必要はありません。  ただし、<xref:System.Linq.ParallelEnumerable.WithCancellation%2A> はクエリのパフォーマンスに影響を与えず、クエリ演算子とユーザー コードによってキャンセルを処理できるようになるため、これを使用することをお勧めします。  
+  
+ システムの応答性を確認するため、ミリ秒ごとに一度程度の頻度でキャンセルをチェックすることをお勧めします。ただし、適切な期間と見なされるのは最大で 10 ミリ秒です。  この頻度によってコードのパフォーマンスが低下することはありません。  
+  
+ たとえば、コードで、クエリ結果を反復処理している foreach \(Visual Basic では For Each\) ループを中断したときなど、列挙子が破棄された場合、クエリは取り消されますが、例外がスローされることはありません。  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)   
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md b/docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md
new file mode 100644
index 00000000000..8ef74b56fe7
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md
@@ -0,0 +1,49 @@
+---
+title: "How to: Cancel a Task and Its Children | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to cancel"
+ms.assetid: 08574301-8331-4719-ad50-9cf7f6ff3048
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# How to: Cancel a Task and Its Children
+以下の例では、次のタスクを実行する方法を説明します。  
+  
+1.  取り消すことができるタスクを作成し、開始します。  
+  
+2.  キャンセル トークンをユーザー デリゲートに渡し、必要に応じてタスク インスタンスにも渡します。  
+  
+3.  ユーザー デリゲート内のキャンセル要求を確認し、これに応答します。  
+  
+4.  必要に応じて、タスクが取り消された呼び出し元のスレッドを確認します。  
+  
+ 呼び出し元のスレッドは、タスクを強制終了せず、キャンセルが要求されたことを通知するだけです。  タスクが既に実行中である場合、ユーザー デリゲートが要求を確認して適切に応答します。  タスクを実行する前にキャンセルが要求された場合、ユーザー デリゲートは実行されず、タスク オブジェクトは Canceled 状態に遷移します。  
+  
+## 使用例  
+ 次の例は、キャンセル要求に応答して <xref:System.Threading.Tasks.Task> およびその子を終了する方法を示しています。  また、ユーザー デリゲートが <xref:System.Threading.Tasks.TaskCanceledException> をスローして終了した場合、タスクの終了を待つために、呼び出し元スレッドが必要に応じて <xref:System.Threading.Tasks.Task.Wait%2A> メソッドまたは <xref:System.Threading.Tasks.Task.WaitAll%2A> メソッドを使用できることも示しています。  この例では `try/catch` ブロックを使用して、呼び出し元スレッドで例外を処理する必要があります。  
+  
+ [!code-csharp[TPL_Cancellation#04](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_cancellation/cs/cancel1.cs#04)]
+ [!code-vb[TPL_Cancellation#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_cancellation/vb/cancel1.vb#04)]  
+  
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスは、<xref:System.Threading.CancellationTokenSource?displayProperty=fullName> の型および <xref:System.Threading.CancellationToken?displayProperty=fullName> の型に基づくキャンセル モデルに完全に統合されています。  詳細については、「[Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)」および「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Threading.CancellationTokenSource?displayProperty=fullName>   
+ <xref:System.Threading.CancellationToken?displayProperty=fullName>   
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName>   
+ <xref:System.Threading.Tasks.Task%601?displayProperty=fullName>   
+ [Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)   
+ [Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-combine-parallel-and-sequential-linq-queries.md b/docs/standard/parallel-programming/how-to-combine-parallel-and-sequential-linq-queries.md
new file mode 100644
index 00000000000..5a50e4c9e54
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-combine-parallel-and-sequential-linq-queries.md
@@ -0,0 +1,37 @@
+---
+title: "How to: Combine Parallel and Sequential LINQ Queries | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel queries, combine parallel and sequential"
+ms.assetid: 1167cfe6-c8aa-4096-94ba-c66c3a4edf4c
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# How to: Combine Parallel and Sequential LINQ Queries
+この例では、<xref:System.Linq.ParallelEnumerable.AsSequential%2A> メソッドを使用して、クエリのすべての後続演算子を順次処理するよう PLINQ に指示する方法を示します。  一般的に、順次処理は並列処理よりも時間がかかりますが、正しい結果を生成するために必要な場合があります。  
+  
+> [!WARNING]
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、<xref:System.Linq.ParallelEnumerable.AsSequential%2A> が必要で、クエリの直前の句で設定された順序を維持するシナリオを示しています。  
+  
+ [!code-csharp[PLINQ#24](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#24)]
+ [!code-vb[PLINQ#24](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#24)]  
+  
+## コードのコンパイル  
+ このコードをコンパイルして実行するには、コードを [PLINQ Data Sample](../../../docs/standard/parallel-programming/plinq-data-sample.md) プロジェクトに貼り付け、`Main` からメソッドを呼び出す行を追加し、F5 キーを押します。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-control-ordering-in-a-plinq-query.md b/docs/standard/parallel-programming/how-to-control-ordering-in-a-plinq-query.md
new file mode 100644
index 00000000000..e5002054da3
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-control-ordering-in-a-plinq-query.md
@@ -0,0 +1,51 @@
+---
+title: "How to: Control Ordering in a PLINQ Query | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to control ordering"
+ms.assetid: c67eccc7-004d-4b2f-987e-919cbbd62ef7
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# How to: Control Ordering in a PLINQ Query
+以下の例では、<xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 拡張メソッドを使用して PLINQ クエリの順序を制御する方法を示します。  
+  
+> [!WARNING]
+>  これらの例は使用法を示すことを主な目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が速い場合もあれば遅い場合もあります。  
+  
+## 使用例  
+ 次の例では、ソース シーケンスの順序を維持します。  この操作が必要になるのは、たとえば、正確な結果を生成するためにクエリ演算子で順序ありのソース シーケンスが求められる場合です。  
+  
+ [!code-csharp[PLINQ#12](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#12)]
+ [!code-vb[PLINQ#12](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#12)]  
+  
+## 使用例  
+ 次の例は、ソース シーケンスで順序付けが求められるクエリ演算子を示しています。  これらの演算子は、順序なしのシーケンスで動作しますが、予測できない結果を生成する場合があります。  
+  
+ [!code-csharp[PLINQ#14](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#14)]
+ [!code-vb[PLINQ#14](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#14)]  
+  
+ このメソッドを実行するには、[PLINQ Data Sample](../../../docs/standard/parallel-programming/plinq-data-sample.md) プロジェクトの PLINQDataSample クラスに貼り付け、F5 キーを押します。  
+  
+## 使用例  
+ 次の例は、クエリの最初の部分で順序を維持した後に、join 句のパフォーマンスを向上させるために順序を削除し、最終的な結果に順序を再適用する方法を示しています。  
+  
+ [!code-csharp[PLINQ#15](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#15)]
+ [!code-vb[PLINQ#15](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#15)]  
+  
+ このメソッドを実行するには、[PLINQ Data Sample](../../../docs/standard/parallel-programming/plinq-data-sample.md) プロジェクトの PLINQDataSample クラスに貼り付け、F5 キーを押します。  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-create-and-execute-a-simple-plinq-query.md b/docs/standard/parallel-programming/how-to-create-and-execute-a-simple-plinq-query.md
new file mode 100644
index 00000000000..4d73e773b67
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-create-and-execute-a-simple-plinq-query.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Create and Execute a Simple PLINQ Query | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to create"
+ms.assetid: 983b4213-bddd-4a44-9262-cbe59186df4c
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# How to: Create and Execute a Simple PLINQ Query
+次の例に、ソース シーケンスに対する <xref:System.Linq.ParallelEnumerable.AsParallel%2A> 拡張メソッドを使用して単純な並列 LINQ クエリを作成し、<xref:System.Linq.ParallelEnumerable.ForAll%2A> メソッドを使用して、そのクエリを実行する方法を示します。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して PLINQ でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[PLINQ#11](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/create1.cs#11)]
+ [!code-vb[PLINQ#11](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/create1.vb#11)]  
+  
+ この例で示しているのは、結果シーケンスの順序付けが重要ではない場合に、並列 LINQ クエリを作成して実行する基本的なパターンです。通常、順序なしのクエリは、順序ありのクエリより高速になります。  このクエリはソースを、複数のスレッドで非同期的に実行した複数のタスクにパーティション分割します。  各タスクが完了する順序は、その特定のパーティションに含まれる要素を処理するために必要な作業量だけでなく、オペレーティング システムが各スレッドをどのようにスケジュールするかといった外部要因にも依存します。  この例は、使用方法を示すことを意図したものであるため、同等の順次的な LINQ to Objects クエリほど高速ではない可能性があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  クエリに含まれる要素の順序を保持する方法の詳細については、「[How to: Control Ordering in a PLINQ Query](../../../docs/standard/parallel-programming/how-to-control-ordering-in-a-plinq-query.md)」を参照してください。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-create-pre-computed-tasks.md b/docs/standard/parallel-programming/how-to-create-pre-computed-tasks.md
new file mode 100644
index 00000000000..85bd5a048c6
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-create-pre-computed-tasks.md
@@ -0,0 +1,46 @@
+---
+title: "How to: Create Pre-Computed Tasks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, creating pre-computed"
+ms.assetid: a73eafa2-1f49-4106-a19e-997186029b58
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# How to: Create Pre-Computed Tasks
+このドキュメントでは、キャッシュに保持されている非同期ダウンロード操作の結果を取得するために <xref:System.Threading.Tasks.Task.FromResult%2A?displayProperty=fullName> のメソッドを使用する方法について説明します。  <xref:System.Threading.Tasks.Task.FromResult%2A> メソッドの戻り <xref:System.Threading.Tasks.Task%601> の終了するオブジェクトを保持する <xref:System.Threading.Tasks.Task%601.Result%2A> のプロパティとして指定した値。  このメソッドは <xref:System.Threading.Tasks.Task%601> オブジェクトの結果があらかじめ計算されている <xref:System.Threading.Tasks.Task%601> オブジェクトを返す、非同期操作を実行する場合に便利です。  
+  
+## 使用例  
+ 次の例は、Web から文字列をダウンロードします。  これは `DownloadStringAsync` のメソッドを定義します。  このメソッドは、Web から文字列を非同期にダウンロードします。  この例では、前の操作の結果をキャッシュに <xref:System.Collections.Concurrent.ConcurrentDictionary%602> オブジェクトを使用します。  入力アドレスがこのキャッシュに保持されている場合、`DownloadStringAsync` はそのアドレスで <xref:System.Threading.Tasks.Task%601> オブジェクトを保持するために <xref:System.Threading.Tasks.Task.FromResult%2A> コンテンツのメソッドを使用します。  それ以外の場合は `DownloadStringAsync` は、Web からファイルをダウンロードし、結果をキャッシュに追加します。  
+  
+ [!code-csharp[TPL_CachedDownloads#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_cacheddownloads/cs/cacheddownloads.cs#1)]
+ [!code-vb[TPL_CachedDownloads#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_cacheddownloads/vb/cacheddownloads.vb#1)]  
+  
+ この例は、複数の文字列をダウンロードするために 2 回必要な時間を計算します。  ダウンロード操作の 2 番目のセットが結果をキャッシュに保持されるため、最初の設定よりも時間がかかります。  <xref:System.Threading.Tasks.Task.FromResult%2A> のメソッドは `DownloadStringAsync` のメソッドがこれらの事前計算結果を保持する <xref:System.Threading.Tasks.Task%601> オブジェクトを作成できるようになります。  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`CachedDownloads.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`CachedDownloads.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe CachedDownloads.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe CachedDownloads.vb**  
+  
+## 信頼性の高いプログラミング  
+  
+## 参照  
+ [Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md b/docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md
new file mode 100644
index 00000000000..118dcd07acc
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md
@@ -0,0 +1,54 @@
+---
+title: "How to: Handle Exceptions in a PLINQ Query | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to handle exceptions"
+ms.assetid: 8d56ff9b-a571-4d31-b41f-80c0b51b70a5
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# How to: Handle Exceptions in a PLINQ Query
+このトピックの最初の例では、PLINQ クエリの実行時にスローされる <xref:System.AggregateException?displayProperty=fullName> の処理方法を示します。  2 番目の例では、デリゲート内で例外がスローされる場所のできるだけ近くに try\-catch ブロックを配置する方法を示します。  こうすると、発生の直後に例外をキャッチしてクエリの実行を続行できる可能性があります。  連結しているスレッドへ例外が上方向へ通知されると、例外が発生した後も、クエリによって一部の項目の処理が続行される可能性があります。  
+  
+ 場合によっては、PLINQ が順次実行に戻り、例外が発生すると、例外が直接反映され、<xref:System.AggregateException> にラップされないことがあります。  また、<xref:System.Threading.ThreadAbortException> は常に直接反映されます。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されます。このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\]** メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\] で \[マイ コードのみ\] チェック ボックスをオフにします。  
+>   
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、スローされる <xref:System.AggregateException?displayProperty=fullName> をキャッチするクエリを実行するコードの近くに try\-catch ブロックを配置する方法を示しています。  
+  
+ [!code-csharp[PLINQ#41](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#41)]
+ [!code-vb[PLINQ#41](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#41)]  
+  
+ この例では、例外がスローされた後にクエリを続行することはできません。  アプリケーション コードが例外をキャッチするまでに、PLINQ はすべてのスレッド上でクエリを停止しています。  
+  
+## 使用例  
+ 次の例は、例外をキャッチしてクエリの実行を続行できるようにするため、try\-catch ブロックをデリゲートに配置する方法を示しています。  
+  
+ [!code-csharp[PLINQ#42](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#42)]
+ [!code-vb[PLINQ#42](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#42)]  
+  
+## コードのコンパイル  
+  
+-   これらの例をコンパイルして実行するには、これらのコードを PLINQ データのサンプルにコピーして、Main からメソッドを呼び出します。  
+  
+## 信頼性の高いプログラミング  
+ プログラムの状態を破損しないようにするため、処理方法がわからない場合は、例外をキャッチしないでください。  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-handle-exceptions-in-parallel-loops.md b/docs/standard/parallel-programming/how-to-handle-exceptions-in-parallel-loops.md
new file mode 100644
index 00000000000..072c25cffed
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-handle-exceptions-in-parallel-loops.md
@@ -0,0 +1,37 @@
+---
+title: "How to: Handle Exceptions in Parallel Loops | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel loops, how to handle exceptions"
+ms.assetid: 512f0d5a-4636-4875-b766-88f20044f143
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# How to: Handle Exceptions in Parallel Loops
+<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> のオーバーロード には、スローされる可能性のある例外を処理する特別な仕組みはありません。  この点では、標準の `for` ループおよび `foreach` ループ \(Visual Basic では `For` と `For Each`\) と似ており、処理されない例外でループはすぐに終了します。  
+  
+ 独自の例外処理のロジックを並列ループに追加する場合は、同様の例外が複数のスレッドに同時にスローされるケース、および特定のスレッドにスローされる例外が、別のスレッドに別の例外をスローするケースを処理してください。  <xref:System.AggregateException?displayProperty=fullName> のループからすべての例外をラップすることで、両方のケースを処理できます。   考えられる方法の 1 つの例を次に示します。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されることがあります。 このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\] メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\]** で \[マイ コードのみ\] チェック ボックスをオフにします。  
+  
+## 使用例  
+ この例では、すべての例外がキャッチされた後に <xref:System.AggregateException?displayProperty=fullName> にラップされ、スローされます。    呼び出し元は、どの例外を処理するかを決定できます。  
+  
+ [!code-csharp[TPL_Exceptions#08](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_exceptions/cs/exceptions.cs#08)]
+ [!code-vb[TPL_Exceptions#08](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_exceptions/vb/exceptionsinloops.vb#08)]  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-implement-a-partitioner-for-static-partitioning.md b/docs/standard/parallel-programming/how-to-implement-a-partitioner-for-static-partitioning.md
new file mode 100644
index 00000000000..40bb2159120
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-implement-a-partitioner-for-static-partitioning.md
@@ -0,0 +1,30 @@
+---
+title: "How to: Implement a Partitioner for Static Partitioning | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to create a static partitioner"
+ms.assetid: f4410508-cac6-4ba7-bef1-c5e68b2794f3
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# How to: Implement a Partitioner for Static Partitioning
+静的パーティション分割を実行する、PLINQ 用の簡単なカスタム パーティショナーを実装する方法の 1 つを次の例に示します。  このパーティショナーは動的パーティションをサポートしないため、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> からは使用できません。  このパーティショナーは、各要素により処理時間が増大するデータ ソースでは、既定の範囲パーティショナーよりも速度が向上する場合があります。  
+  
+## 使用例  
+ [!code-csharp[TPL_Partitioners#05](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_partitioners/cs/partitioners.cs#05)]  
+  
+ この例のパーティションは、各要素により処理時間が直線的に増加するという前提に基づいています。  実際には、この方法で処理時間を予測するのは困難な場合があります。  特定のデータ ソースで静的パーティショナーを使用する場合、ソース用にパーティション分割式を最適化するか、負荷分散ロジックを追加するか、または「[How to: Implement Dynamic Partitions](../../../docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md)」に示すチャンク パーティション分割方法を使用できます。  
+  
+## 参照  
+ [Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-implement-a-producer-consumer-dataflow-pattern.md b/docs/standard/parallel-programming/how-to-implement-a-producer-consumer-dataflow-pattern.md
new file mode 100644
index 00000000000..48a79222ecb
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-implement-a-producer-consumer-dataflow-pattern.md
@@ -0,0 +1,57 @@
+---
+title: "How to: Implement a Producer-Consumer Dataflow Pattern | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TPL dataflow library, implementing producer-consumer pattern"
+  - "Task Parallel Library, dataflows"
+  - "producer-consumer patterns, implementing [TPL]"
+ms.assetid: 47a1d38c-fe9c-44aa-bd15-937bd5659b0b
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# How to: Implement a Producer-Consumer Dataflow Pattern
+このドキュメントでは、プロデューサー\/コンシューマー パターンを実装するために TPL データ フローのライブラリを使用する方法について説明します。  このパターンでは、*プロデューサー*がメッセージをメッセージ ブロックに送信し、*コンシューマー*がそのブロックからメッセージを読み取ります。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 使用例  
+ 次の例は、データ フローを使用する基本的な生産者コンシューマー モデルです。  `Produce` のメソッドは <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601?displayProperty=fullName> オブジェクトにデータの任意のバイトが含まれ、`Consume` のメソッドが <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601?displayProperty=fullName> オブジェクトからバイトを読み取る配列を作成します。  、派生型ではなく <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601> と <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601> インターフェイスの機能によって、さまざまなデータ フロー ブロック型で動作できる再利用可能なコードを記述できます。  この例では <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> クラスを使用します。  <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> クラスは、ソース ブロックとターゲット ブロックとして機能するため、プロデューサーおよびコンシューマーは転送データの共有オブジェクトを使用できます。  
+  
+ `Produce` のメソッドの呼び出し同期的にターゲット ブロックにデータを書き込むループの <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A> のメソッド。  `Produce` のメソッドはターゲット ブロックにすべてのデータを作成したら、ブロックには使用できる追加データがないことを示すために <xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete%2A> のメソッドを呼び出します。  `Consume` のメソッドは [async](../Topic/async%20\(C%23%20Reference\).md) と [待機します。](../Topic/await%20\(C%23%20Reference\).md) の演算子 \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の[Async](../Topic/Async%20\(Visual%20Basic\).md) と [待機します。](../Topic/Await%20Operator%20\(Visual%20Basic\).md)\) 非同期的に <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601> オブジェクトから受け取ったバイト数の合計を計算します。  ソース ブロックに使用できるデータがある場合に、ソース ブロックには使用できる追加のデータがない場合は、非同期的に機能するには、`Consume` のメソッドの呼び出し通知を受け取る <xref:System.Threading.Tasks.Dataflow.DataflowBlock.OutputAvailableAsync%2A> のメソッド。  
+  
+ [!code-csharp[TPLDataflow_ProducerConsumer#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_producerconsumer/cs/dataflowproducerconsumer.cs#1)]
+ [!code-vb[TPLDataflow_ProducerConsumer#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_producerconsumer/vb/dataflowproducerconsumer.vb#1)]  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DataflowProducerConsumer.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DataflowProducerConsumer.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowProducerConsumer.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowProducerConsumer.vb**  
+  
+## 信頼性の高いプログラミング  
+ この例では、ソース データを処理するために、1 個のコンシューマーを使用します。  アプリケーションで複数のコンシューマーがある場合は、次の例に示すように、ソース ブロックからデータを読み取るために、<xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceive%2A> のメソッドを使用します。  
+  
+ [!code-csharp[TPLDataflow_ProducerConsumer#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_producerconsumer/cs/dataflowproducerconsumer.cs#2)]
+ [!code-vb[TPLDataflow_ProducerConsumer#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_producerconsumer/vb/dataflowproducerconsumer.vb#2)]  
+  
+ データを使用できない場合に <xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceive%2A> メソッドの戻り `False`。  複数のときにコンシューマーがデータが <xref:System.Threading.Tasks.Dataflow.DataflowBlock.OutputAvailableAsync%2A>の呼び出し後にまだ利用できるという保証この機能のソース ブロックに同時にアクセスする必要があります。  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md b/docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md
new file mode 100644
index 00000000000..0f20d9c22c0
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-implement-dynamic-partitions.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Implement Dynamic Partitions | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to create a dynamic partitioner"
+ms.assetid: c875ad12-a161-43e6-ad1c-3d6927c536a7
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# How to: Implement Dynamic Partitions
+次の例では、動的パーティション分割を実装し、特定のオーバーロードの <xref:System.Threading.Tasks.Parallel.ForEach%2A> および PLINQ から使用できる、カスタムの <xref:System.Collections.Concurrent.OrderablePartitioner%601?displayProperty=fullName> を実装する方法を示します。  
+  
+## 使用例  
+ パーティションで列挙子に対して <xref:System.Collections.IEnumerator.MoveNext%2A> を呼び出すたびに、パーティションにリスト要素が 1 つ提供されます。  PLINQ および <xref:System.Threading.Tasks.Parallel.ForEach%2A> の場合、パーティションは <xref:System.Threading.Tasks.Task> インスタンスです。  複数のスレッドで要求が同時に発生するため、現在のインデックスへのアクセスが同期されます。  
+  
+ [!code-csharp[TPL_Partitioners#04](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_partitioners/cs/partitioners.cs#04)]
+ [!code-vb[TPL_Partitioners#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_partitioners/vb/dynamicpartitioner.vb#04)]  
+  
+ これは、各チャンクが 1 つの要素で構成されたチャンク パーティション分割の一例です。  一度により多くの要素を提供することで、ロックの競合を減らすことができるため、理論上はパフォーマンスを向上させることができます。  ただし、大きなチャンクでは、すべての処理が完了するまですべてのスレッドをビジー状態に維持するために、ある時点で追加の負荷分散ロジックが必要になる場合があります。  
+  
+## 参照  
+ [Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)   
+ [How to: Implement a Partitioner for Static Partitioning](../../../docs/standard/parallel-programming/how-to-implement-a-partitioner-for-static-partitioning.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-iterate-file-directories-with-plinq.md b/docs/standard/parallel-programming/how-to-iterate-file-directories-with-plinq.md
new file mode 100644
index 00000000000..1c8243afbad
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-iterate-file-directories-with-plinq.md
@@ -0,0 +1,44 @@
+---
+title: "How to: Iterate File Directories with PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to iterate directories"
+ms.assetid: 354e8ce3-35c4-431c-99ca-7661d1f3901b
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Iterate File Directories with PLINQ
+この例では、ファイル ディレクトリに対する操作を簡単に並列化する 2 とおりの方法を示します。  最初のクエリでは、<xref:System.IO.Directory.GetFiles%2A> メソッドを使用して、ディレクトリとすべてのサブディレクトリ内のファイル名の配列を作成します。  配列全体の値が設定されるまでこのメソッドから制御が戻らないため、操作の開始時に待機時間が発生する可能性があります。  ただし、配列が作成されたら、PLINQ は配列を迅速に並列処理できます。  
+  
+ 2 番目のクエリでは、即座に結果を返し始める静的な <xref:System.IO.Directory.EnumerateDirectories%2A> メソッドと <xref:System.IO.DirectoryInfo.EnumerateFiles%2A> メソッドを使用します。  この方法は、最初の例に比べると、処理時間が多くの要素に左右される可能性がありますが、大規模なディレクトリ ツリーを反復処理するときには処理が速くなる場合があります。  
+  
+> [!WARNING]
+>  これらの例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は、単純なシナリオ \(ツリー内のすべてのディレクトリにアクセスできる場合、ファイル サイズがそれほど大きくない場合、アクセス時間が重要ではない場合\) において、ファイル ディレクトリを反復処理する方法を示しています。  この方法では、ファイル名の配列が作成されている間、最初に待機時間が発生します。  
+  
+ [!code-csharp[PLINQ#33](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqfileiteration.cs#33)]  
+  
+## 使用例  
+ 次の例は、単純なシナリオ \(ツリー内のすべてのディレクトリにアクセスできる場合、ファイル サイズがそれほど大きくない場合、アクセス時間が重要ではない場合\) において、ファイル ディレクトリを反復処理する方法を示しています。  この方法では、前の例よりも迅速に結果を生成し始めます。  
+  
+ [!code-csharp[PLINQ#34](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqfileiteration.cs#34)]  
+  
+ <xref:System.IO.Directory.GetFiles%2A> を使用する場合は、ツリー内のすべてのディレクトリに対して必要なアクセス許可があることを確認してください。  アクセス許可がないと例外がスローされ、結果は返されません。  PLINQ クエリで <xref:System.IO.Directory.EnumerateDirectories%2A> を使用する場合、反復処理を続行できるように I\/O 例外を適切に処理することが問題となります。  コードで I\/O 例外または承認されていないアクセスの例外を処理する必要がある場合は、「[方法: Parallel クラスを使用してファイル ディレクトリを反復処理する](../../../docs/standard/parallel-programming/how-to-iterate-file-directories-with-the-parallel-class.md)」で説明する方法を検討することをお勧めします。  
+  
+ I\/O の待機時間が問題になる場合は、たとえば、ネットワーク上のファイル I\/O と、[TPL and Traditional .NET Framework Asynchronous Programming](../../../docs/standard/parallel-programming/tpl-and-traditional-async-programming.md) とこれ [ブログの投稿](http://go.microsoft.com/fwlink/?LinkID=186458)で説明されている非同期 I\/O の手法の 1 を使用することを検討してください。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-iterate-file-directories-with-the-parallel-class.md b/docs/standard/parallel-programming/how-to-iterate-file-directories-with-the-parallel-class.md
new file mode 100644
index 00000000000..1639513040b
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-iterate-file-directories-with-the-parallel-class.md
@@ -0,0 +1,37 @@
+---
+title: "方法: Parallel クラスを使用してファイル ディレクトリを反復処理する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "並列ループ、ディレクトリを反復処理する方法"
+ms.assetid: 555e9f48-f53d-4774-9bcf-3e965c732ec5
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法: Parallel クラスを使用してファイル ディレクトリを反復処理する
+多くの場合、ファイル反復処理は簡単に並列化できる操作です。  「[How to: Iterate File Directories with PLINQ](../../../docs/standard/parallel-programming/how-to-iterate-file-directories-with-plinq.md)」では、さまざまなシナリオでこのタスクを最も簡単に実行する方法について説明しています。  ただし、ファイル システムへのアクセス時に発生する可能性のある多くの種類の例外をコードで処理する必要がある場合は、複雑さが生じることがあります。  次の例は、この問題への対処方法の 1 つを示しています。  この例では、スタック ベースの反復処理を使用して、指定されたディレクトリにあるすべてのファイルとフォルダーを走査し、コードで各種例外をキャッチして処理できるようにしています。  例外を処理する方法は開発者に委ねられています。  
+  
+## 使用例  
+ 次の例では、ディレクトリの反復処理は順次実行されますが、ファイルの処理は並列で実行されます。  これは、ディレクトリのファイル占有率が大きい場合に最適な方法と考えられます。  また、ディレクトリの反復処理を並列化し、各ファイルに順次アクセスすることもできます。  多数のプロセッサを搭載したコンピューターを明確に対象としている場合を除き、両方のループを並列化するのは効率的とは言えません。  ただし、どの場合もアプリケーションを徹底的にテストして、最適な方法を決定する必要があります。  
+  
+ [!code-csharp[TPL_Parallel#08](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/parallel_file.cs#08)]
+ [!code-vb[TPL_Parallel#08](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/fileiteration08.vb#08)]  
+  
+ この例では、ファイル I\/O を同期的に実行します。  大きなファイルを処理する場合やネットワーク接続が低速の場合は、ファイルに非同期にアクセスするよりも望ましいと考えられます。  非同期 I\/O の手法を並列反復処理と組み合わせることができます。  詳細については、「[TPL and Traditional .NET Framework Asynchronous Programming](../../../docs/standard/parallel-programming/tpl-and-traditional-async-programming.md)」を参照してください。  
+  
+ この例では、ローカル変数 `fileCount` を使用して、処理済みファイルの合計数を示すカウントを管理します。  この変数は複数のタスクから同時にアクセスされる可能性があるため、この変数へのアクセスは <xref:System.Threading.Interlocked.Add%2A?displayProperty=fullName> メソッドの呼び出しによって同期されています。  
+  
+ メイン スレッドで例外がスローされた場合、<xref:System.Threading.Tasks.Parallel.ForEach%2A> メソッドによって開始されたスレッドが引き続き実行されることがあります。  これらのスレッドを停止するには、例外ハンドラーで Boolean 変数を設定し、並列ループを反復処理するたびに値をチェックします。  例外がスローされたことを値が示している場合は、<xref:System.Threading.Tasks.ParallelLoopState> 変数を使用してループを停止または中断します。  詳細については、「[How to: Stop or Break from a Parallel.For Loop](http://msdn.microsoft.com/ja-jp/de52e4f1-9346-4ad5-b582-1a4d54dc7f7e)」を参照してください。  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md b/docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md
new file mode 100644
index 00000000000..7038f658b38
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md
@@ -0,0 +1,33 @@
+---
+title: "How to: Measure PLINQ Query Performance | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to measure performance"
+ms.assetid: 491ba43b-2c10-473d-9aab-e2cb96446711
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# How to: Measure PLINQ Query Performance
+この例では、<xref:System.Diagnostics.Stopwatch> クラスを使用して PLINQ クエリの実行に要する時間を測定します。  
+  
+## 使用例  
+ この例では、空の `foreach` ループ \(Visual Basic では `For Each`\) を使用して、クエリの実行に要する時間を測定します。  実際のコードでは、通常、ループにはその他の処理手順が含まれ、クエリの総実行時間に追加されます。  ストップウォッチは、クエリの実行が開始されるループの直前まで開始されません。  さらに詳細な計測が必要な場合は、`ElapsedMilliseconds` の代わりに `ElapsedTicks` プロパティを使用できます。  
+  
+ [!code-csharp[PLINQ#19](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/measure2.cs#19)]
+ [!code-vb[PLINQ#19](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/measure2.vb#19)]  
+  
+ 総実行時間は、クエリの実装を試している場合には便利なメトリックですが、常に全体の状況を表すわけではありません。  クエリ スレッドのスレッドどうし、およびその他の実行プロセスとの相互作用をより詳しくわかりやすく表示するには、同時実行ビジュアライザーを使用します。  詳細については、「[同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md)」を参照してください。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md b/docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md
new file mode 100644
index 00000000000..875cf838fa2
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-perform-action-when-a-dataflow-block-receives-data.md
@@ -0,0 +1,61 @@
+---
+title: "How to: Perform Action When a Dataflow Block Receives Data | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, receiving data"
+ms.assetid: fc2585dc-965e-4632-ace7-73dd02684ed3
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Perform Action When a Dataflow Block Receives Data
+*実行データ フローのブロック型は* データを受け取ったときにユーザーが指定したデリゲートを呼び出します。  <xref:System.Threading.Tasks.Dataflow.ActionBlock%601?displayProperty=fullName>、<xref:System.Threading.Tasks.Dataflow.TransformBlock%602?displayProperty=fullName>と <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602?displayProperty=fullName> クラスは実行データ フローのブロック型です。  `delegate` の実行データ フローのブロックに処理関数を提供するとキーワード \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`Sub`\)、<xref:System.Action%601>、<xref:System.Func%602>、またはラムダ式を使用できます。  このドキュメントでは、実行ブロックにアクションを実行する場合に <xref:System.Func%602> とラムダ式を使用する方法について説明します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 使用例  
+ 次の例は、ディスク上のファイルの読み取りにデータ フローを使用し、ゼロと同じファイルのバイト数を計算します。  このパラメーターは、ファイルを読み取り、それをコンソールにゼロ バイト数を印刷するために、バイト数を計算するために <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> と <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> を使用します。  <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> オブジェクトはブロックがデータを受信するときに処理を実行するに <xref:System.Func%602> オブジェクトを指定します。  <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトは、コンソールに読み取り、バイト数を出力するためにラムダ式を使用します。  
+  
+ [!code-csharp[TPLDataflow_ExecutionBlocks#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_executionblocks/cs/dataflowexecutionblocks.cs#1)]
+ [!code-vb[TPLDataflow_ExecutionBlocks#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_executionblocks/vb/dataflowexecutionblocks.vb#1)]  
+  
+ <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> オブジェクトにラムダ式を使用できますが `CountBytes` のメソッドが他のコードを有効にするために、この例では <xref:System.Func%602>。  <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトは、実行する作業がこのタスクに固有であり、他のコードから役に立つとは異なります。ラムダ式を使用します。  ラムダ式は、タスク並列ライブラリでどのように動作するか詳細については、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md) ドキュメントのデリゲート型の概要セクションは、<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>と <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602> オブジェクトに割り当てることのできるデリゲート型をまとめたものです。  この表では、デリゲート型を同期的または非同期的に実行するかどうかを指定します。  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DataflowExecutionBlocks.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DataflowExecutionBlocks.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowExecutionBlocks.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowExecutionBlocks.vb**  
+  
+## 信頼性の高いプログラミング  
+ この例では <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> オブジェクトからデータ フローのブロックのタスクを同期的に実行 <xref:System.Func%602> 型のデリゲートを示します。  データ フローのブロックを非同期的に実行できるようにするには、データ フローのブロックに <xref:System.Func%601> 型のデリゲートを提供します。  データ フローのブロックを非同期的に実行すると、データ フローのブロックのタスクは <xref:System.Threading.Tasks.Task%601> から返されたオブジェクトのみが完了すると完了します。  次の例では `CountBytes` のメソッドを変更し、[async](../Topic/async%20\(C%23%20Reference\).md) を使用し、非同期的にあるバイト数の合計を計算する [待機します。](../Topic/await%20\(C%23%20Reference\).md) の演算子 \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の[Async](../Topic/Async%20\(Visual%20Basic\).md) と [待機します。](../Topic/Await%20Operator%20\(Visual%20Basic\).md)\) を指定されたファイルにゼロを返します。  <xref:System.IO.FileStream.ReadAsync%2A> メソッドは、ファイルの読み取り操作を非同期的に実行します。  
+  
+ [!code-csharp[TPLDataflow_ExecutionBlocks#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_executionblocks/cs/dataflowexecutionblocks.cs#2)]
+ [!code-vb[TPLDataflow_ExecutionBlocks#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_executionblocks/vb/dataflowexecutionblocks.vb#2)]  
+  
+ 実行データ フローのブロックで操作を非同期にラムダ式を使用できます。  次の例では、非同期的に作業を行うためにラムダ式を使用する場合は、前の例で使用した <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> オブジェクトを変更します。  
+  
+ [!code-csharp[TPLDataflow_ExecutionBlocks#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_executionblocks/cs/dataflowexecutionblocks.cs#3)]
+ [!code-vb[TPLDataflow_ExecutionBlocks#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_executionblocks/vb/dataflowexecutionblocks.vb#3)]  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-prevent-a-child-task-from-attaching-to-its-parent.md b/docs/standard/parallel-programming/how-to-prevent-a-child-task-from-attaching-to-its-parent.md
new file mode 100644
index 00000000000..0f76d57062d
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-prevent-a-child-task-from-attaching-to-its-parent.md
@@ -0,0 +1,46 @@
+---
+title: "How to: Prevent a Child Task from Attaching to its Parent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, preventing attachments"
+ms.assetid: c0fb85d4-9e80-4905-9f65-29acc54201c4
+caps.latest.revision: 5
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# How to: Prevent a Child Task from Attaching to its Parent
+このドキュメントに示します。親タスクに子タスクが接続するようにする方法を示します。  子タスクがその親に役立つ接続を書き込むサード パーティによって、タスクを使用して、コンポーネントを呼び出すとされないようにです。  たとえば、<xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> オブジェクトを作成するために <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用してサードパーティのコンポーネントはコードで長時間、または未処理の例外をスローすれば問題を引き起こす可能性があります。  
+  
+## 使用例  
+ 次の例では、子タスクがその親にアタッチされることを防ぐ効果が既定のオプションを使用して結果を比較します。  この例では、<xref:System.Threading.Tasks.Task> オブジェクトを使用して、サードパーティのライブラリに <xref:System.Threading.Tasks.Task> オブジェクトを呼び出しを作成します。  サードパーティのライブラリは <xref:System.Threading.Tasks.Task> オブジェクトを作成するために <xref:System.Threading.Tasks.TaskCreationOptions> オプションを使用します。  アプリケーションは、親タスクを作成すると、<xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用します。  このオプションが子タスクの <xref:System.Threading.Tasks.TaskCreationOptions> 仕様を削除するようにランタイムに指示します。  
+  
+ [!code-csharp[TPL_DenyChildAttach#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_denychildattach/cs/denychildattach.cs#1)]
+ [!code-vb[TPL_DenyChildAttach#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_denychildattach/vb/denychildattach.vb#1)]  
+  
+ すべての子タスクが完了するまで親タスクが完了しないため、長期間の子タスクにより、アプリケーション全体が不完全に実行できます。  この例では、アプリケーションが親タスクを作成する既定のオプションを使用する場合に、子タスクは親タスクの完了前に終了する必要があります。  アプリケーションが <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用すると、子は親にアタッチされません。  したがって、アプリケーションが親タスクの完了後に、子タスクを生成する前に、追加の処理を実行します。  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DenyChildAttach.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DenyChildAttach.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe DenyChildAttach.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe DenyChildAttach.vb**  
+  
+## 信頼性の高いプログラミング  
+  
+## 参照  
+ [Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md b/docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md
new file mode 100644
index 00000000000..d9d76d07741
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Return a Value from a Task | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to return a value"
+ms.assetid: c4bc0f44-eba2-4e96-9e03-1cc787461e61
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Return a Value from a Task
+この例では、<xref:System.Threading.Tasks.Task%601?displayProperty=fullName> の型を使用して <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティから値を返す方法を示します。  C:\\Users\\Public\\Pictures\\Sample Pictures\\ ディレクトリが存在している必要があり、それがファイルを含んでいる必要があります。  
+  
+## 使用例  
+ [!code-csharp[TPL#10](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl/cs/returnavalue10.cs#10)]
+ [!code-vb[TPL#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl/vb/10_returnavalue.vb#10)]  
+  
+ <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティは、タスクが終了するまで呼び出し元のスレッドをブロックします。  
+  
+ 1 つの <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> の結果を継続タスクに渡す方法を確認するには、「[継続タスクを使用したタスクの連結](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)」を参照してください。  
+  
+## 参照  
+ [Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md b/docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md
new file mode 100644
index 00000000000..d04ed09d1ba
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-specify-a-task-scheduler-in-a-dataflow-block.md
@@ -0,0 +1,87 @@
+---
+title: "How to: Specify a Task Scheduler in a Dataflow Block | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TPL dataflow library, linking to task scheduler in TPL"
+  - "Task Parallel Library, dataflows"
+  - "task scheduler, linking from TPL"
+ms.assetid: 27ece374-ed5b-49ef-9cec-b20db34a65e8
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# How to: Specify a Task Scheduler in a Dataflow Block
+このドキュメントでは、アプリケーションでデータ フローを使用する場合に特定のタスク スケジューラを関連付ける方法を示します。  この例では、Windows フォーム アプリケーションの <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair?displayProperty=fullName> クラスを使用して、リーダー タスクがアクティブである場合と、ライター タスクがアクティブである場合を示します。  また、<xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName> メソッドを使用してデータ フロー ブロックを有効にし、ユーザー インターフェイス スレッドで実行できるようにします。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+### Windows フォーム アプリケーションを作成するには  
+  
+1.  [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] または Visual Basic **Windows フォーム アプリケーション** プロジェクトを作成します。  次の手順では、プロジェクトの名前は `WriterReadersWinForms` です。  
+  
+2.  メイン フォーム Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の Form1.vb\) のフォーム デザイナーで、4 つの <xref:System.Windows.Forms.CheckBox> コントロールを追加します。  <xref:System.Windows.Forms.Control.Text%2A> プロパティを、`checkBox1` に対しては「リーダー 1」に、`checkBox2` に対しては「リーダー 2」に、`checkBox3` に対しては「リーダー 3」に、そして `checkBox4` に対しては「ライター」に設定します。  コントロールごとに、<xref:System.Windows.Forms.Control.Enabled%2A> プロパティを `False` に設定します。  
+  
+3.  フォームに <xref:System.Windows.Forms.Timer> コントロールを追加します。  <xref:System.Windows.Forms.Timer.Interval%2A> プロパティを `2500` に設定します。  
+  
+## データ フロー機能の追加  
+ このセクションでは、アプリケーションに参加するデータ フロー ブロックを作成する方法と、各データ フロー ブロックをタスク スケジューラとを関連付ける方法について説明します。  
+  
+#### アプリケーションにデータ フロー機能を追加するには  
+  
+1.  プロジェクトで、System.Threading.Tasks.Dataflow.dll への参照を追加します。  
+  
+2.  Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の Form1.vb\) が次の `using` ステートメント \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の `Imports`\) を含むことを確認します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#1)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#1)]  
+  
+3.  <xref:System.Threading.Tasks.Dataflow.BroadcastBlock%601> データ メンバーを `Form1` クラスに追加します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#2)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#2)]  
+  
+4.  `Form1` コンストラクターで、`InitializeComponent` の呼び出しの後に、<xref:System.Windows.Forms.CheckBox> オブジェクトの状態を切り替える <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトを作成します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#3)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#3)]  
+  
+5.  `Form1` コンストラクターで、1 つの <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair> オブジェクトと 4 つの <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクト \(各 <xref:System.Windows.Forms.CheckBox> オブジェクトに 1 つの <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクト\) を作成します。  それぞれの <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトに対して <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions> オブジェクトを指定します。このオブジェクトの <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler%2A> プロパティは、リーダーの場合は <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair.ConcurrentScheduler%2A> プロパティに設定し、ライターの場合は <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair.ExclusiveScheduler%2A> プロパティに設定します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#4)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#4)]  
+  
+6.  `Form1` コンストラクターで、<xref:System.Windows.Forms.Timer> オブジェクトを開始します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#5)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#5)]  
+  
+7.  メイン フォームのフォーム デザイナーで、タイマーの <xref:System.Windows.Forms.Timer.Tick> イベントのイベント ハンドラーを作成します。  
+  
+8.  タイマーに <xref:System.Windows.Forms.Timer.Tick> イベントを実装します。  
+  
+     [!code-csharp[TPLDataflow_WriterReadersWinForms#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#6)]
+     [!code-vb[TPLDataflow_WriterReadersWinForms#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#6)]  
+  
+ `toggleCheckBox` データ フロー ブロックはユーザー インターフェイスで機能するので、この操作をユーザー インターフェイス スレッドで実行することが重要です。  これを実現するため、構築時にこのオブジェクトは <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler%2A> プロパティが <xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName> に設定された <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions> オブジェクトを提供します。  <xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A> メソッドは、現行の同期コンテキストで作業を実行する <xref:System.Threading.Tasks.TaskScheduler> オブジェクトを作成します。  `Form1` コンストラクターはユーザー インターフェイス スレッドから呼び出されるので、`toggleCheckBox` データ フロー ブロックに対するアクションも、ユーザー インターフェイス スレッドで実行されます。  
+  
+ この例では、<xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair> クラスを使用していくつかのデータ フロー ブロックが同時に実行できるようにし、別の 1 つのデータ フロー ブロックが、同じ <xref:System.Threading.Tasks.ConcurrentExclusiveSchedulerPair> オブジェクトで実行するその他すべてのデータ フロー ブロックに対して排他的に実行するようにします。  この手法は、複数のデータ フロー ブロックが 1 つのリソースを共有し、一部のデータ フロー ブロックがそのリソースへの排他アクセスを必要とする場合に、手動でそのリソースへのアクセスを同期する必要がなくなるため、便利です。  手動で同期する必要がなくなることで、コードの効率性が向上する可能性があります。  
+  
+## 使用例  
+ 次の例は、Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の Form1.vb\) のコード全体を示しています。  
+  
+ [!code-csharp[TPLDataflow_WriterReadersWinForms#100](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/cs/writerreaderswinforms/form1.cs#100)]
+ [!code-vb[TPLDataflow_WriterReadersWinForms#100](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_writerreaderswinforms/vb/writerreaderswinforms/form1.vb#100)]  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md b/docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md
new file mode 100644
index 00000000000..5541067cf7c
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md
@@ -0,0 +1,37 @@
+---
+title: "How to: Specify Merge Options in PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to use merge options"
+ms.assetid: 0f33b527-e91a-4550-a39a-e63e396fd831
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Specify Merge Options in PLINQ
+ここでは、PLINQ クエリで後続のすべての演算子に適用するマージ オプションを指定する例を示します。  マージ オプションは明示的に設定する必要はありませんが、設定するとパフォーマンスが向上する場合があります。  マージ オプションの詳細については、「[Merge Options in PLINQ](../../../docs/standard/parallel-programming/merge-options-in-plinq.md)」を参照してください。  
+  
+> [!WARNING]
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ 次の例は基本的なシナリオでのマージ オプションで、順序なしのソースを用いてすべての要素に負荷の大きい関数を適用する動作を示しています。  
+  
+ [!code-csharp[PLINQ#23](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#23)]
+ [!code-vb[PLINQ#23](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#23)]  
+  
+ <xref:System.Linq.ParallelMergeOptions> オプションによって、最初の要素が生成されるまでに余分な待機時間が発生する場合は、<xref:System.Linq.ParallelMergeOptions> オプションを使用すると結果要素を高速かつスムーズに生成できます。  
+  
+## 参照  
+ <xref:System.Linq.ParallelMergeOptions>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md b/docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md
new file mode 100644
index 00000000000..af979993c4c
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-specify-the-degree-of-parallelism-in-a-dataflow-block.md
@@ -0,0 +1,52 @@
+---
+title: "How to: Specify the Degree of Parallelism in a Dataflow Block | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "dataflow block, specifying parallelism in TPL"
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, specifying parallelism"
+ms.assetid: e4088541-ee05-40db-95f5-147cfe62fde7
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Specify the Degree of Parallelism in a Dataflow Block
+このドキュメントでは、<xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A?displayProperty=fullName> プロパティを設定して、実行データフロー ブロックが一度に複数のメッセージを処理できるようにする方法について説明します。  実行時間の長い計算を実行し、並行してメッセージの処理からメリットを得るデータ フロー ブロックがある場合は、これを行うと役立ちます。  この例では、<xref:System.Threading.Tasks.Dataflow.ActionBlock%601?displayProperty=fullName> クラスを使用して、同時に複数のデータフローの操作を実行しますが、TPL データフロー ライブラリが提供する定義済みの実行ブロック <xref:System.Threading.Tasks.Dataflow.ActionBlock%601>、<xref:System.Threading.Tasks.Dataflow.TransformBlock%602?displayProperty=fullName>、および <xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602?displayProperty=fullName> のいずれかで並列処理の最大範囲を指定することができます。  
+  
+> [!TIP]
+>  TPL データフロー ライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 使用例  
+ 次の例では、2 つのデータ フローの計算を実行し、それぞれの計算に必要な経過時間を出力します。  最初の計算では、既定である、並列処理の最大範囲 1 を指定します。  並列処理の最大範囲 1 を指定すると、データフロー ブロックが順番にメッセージを処理します。  2 番目の計算は、使用可能なプロセッサの数に相当する並列処理の最大範囲を指定する点以外は、最初の計算と似ています。  これにより、データフフロー ブロックは複数の操作を並行して実行できます。  
+  
+ [!code-csharp[TPLDataflow_DegreeOfParallelism#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_degreeofparallelism/cs/dataflowdegreeofparallelism.cs#1)]
+ [!code-vb[TPLDataflow_DegreeOfParallelism#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_degreeofparallelism/vb/dataflowdegreeofparallelism.vb#1)]  
+  
+## コードのコンパイル  
+ コード例をコピーし、Visual Studio プロジェクトに貼り付けるか、`DataflowDegreeOfParallelism` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の場合は `DataflowDegreeOfParallelism.vb`\) という名前のファイルに貼り付けてから、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行します。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowDegreeOfParallelism.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowDegreeOfParallelism.vb**  
+  
+## 信頼性の高いプログラミング  
+ 既定では、定義済みの各データフロー ブロックは、メッセージが受信される順序でメッセージを処理します。  並列処理の最大範囲に 1 を超える数を指定すると、複数のメッセージが同時に処理されますが、メッセージはそれでも受信した順序で処理されます。  
+  
+ <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions.MaxDegreeOfParallelism%2A> プロパティは並列処理の最大範囲を表すため、データ フロー ブロックは、指定より低い並列化の度合いで実行される場合があります。  機能要件を満たすため、または使用可能なシステム リソースの不足が原因で、データフロー ブロックは、より小さい並列処理の範囲を使う場合があります。  データフロー ブロックが、指定より大きな並列処理の範囲を選択することはありません。  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md b/docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md
new file mode 100644
index 00000000000..a964cf3c929
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md
@@ -0,0 +1,38 @@
+---
+title: "How to: Specify the Execution Mode in PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to use execution mode"
+ms.assetid: e52ff26c-c5d3-4fab-9fec-c937fb387963
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Specify the Execution Mode in PLINQ
+この例では、PLINQ に既定のヒューリスティックをバイパスさせ、クエリの形態に関係なくクエリを並列化する方法を示します。  
+  
+> [!WARNING]
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[PLINQ#22](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#22)]
+ [!code-vb[PLINQ#22](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#22)]  
+  
+ PLINQ は、並列化を利用しやすくするために設計されています。  ただし、すべてのクエリが並列実行の利点を活用できるわけではありません。  たとえば、負荷が非常に小さい単一のユーザー デリゲートを含むクエリの場合、順次実行の方が速度が速くなります。  これは、並列化して実行できるようにすることで発生するオーバーヘッドが、並列化で高速にする場合の負荷より大きいためです。  このため、PLINQ はすべてのクエリを自動的に並列化しません。  最初に、クエリの形態とクエリを構成しているさまざまな演算子を調べます。  この分析に基づいて、既定の実行モードの PLINQ によって、クエリの一部またはすべてを順次実行するかどうかが決定されます。  ただし、PLINQ が分析から判断するよりも、ユーザーの方がクエリをより詳しく理解している場合があります。  たとえば、デリゲートの負荷が非常に大きいため、クエリで並列化を使用する方が良いとわかっているとします。  このような場合は、<xref:System.Linq.ParallelEnumerable.WithExecutionMode%2A> メソッドを使用し、<xref:System.Linq.ParallelExecutionMode> 値を指定することで、クエリを常に並列実行するよう PLINQ に指示できます。  
+  
+## コードのコンパイル  
+ このコードをコピーして [PLINQ Data Sample](../../../docs/standard/parallel-programming/plinq-data-sample.md) に貼り付けて、`Main` からメソッドを呼び出します。  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable.AsSequential%2A>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-speed-up-small-loop-bodies.md b/docs/standard/parallel-programming/how-to-speed-up-small-loop-bodies.md
new file mode 100644
index 00000000000..721d13fc843
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-speed-up-small-loop-bodies.md
@@ -0,0 +1,34 @@
+---
+title: "How to: Speed Up Small Loop Bodies | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel loops, how to speed up"
+ms.assetid: c7a66677-cb59-4cbf-969a-d2e8fc61a6ce
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# How to: Speed Up Small Loop Bodies
+<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> ループの本体が小さい場合、[for](../Topic/for%20\(C%23%20Reference\).md) ループ \(C\#\)、[For](http://msdn.microsoft.com/ja-jp/c470a263-9b49-4308-8fd6-8592b84a7980) ループ \(Visual Basic\) など、同等の連続したループよりパフォーマンスが低下する可能性があります。  パフォーマンスの低下は、データのパーティション分割と、各ループのイテレーションでデリゲートを呼び出す負荷によって発生します。  このようなシナリオに対処するため、<xref:System.Collections.Concurrent.Partitioner> クラスには <xref:System.Collections.Concurrent.Partitioner.Create%2A?displayProperty=fullName> メソッドが用意されています。このメソッドにより、デリゲートがイテレーションごとに 1 回ではなく、パーティションごとに 1 回だけ呼び出されるように、デリゲートの本体に順次ループを提供できるようになります。  詳細については、「[Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[TPL_Partitioners#01](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_partitioners/cs/partitioner01.cs#01)]
+ [!code-vb[TPL_Partitioners#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_partitioners/vb/partitionercreate01.vb#01)]  
+  
+ この例で示す方法は、ループが最小限の作業を実行するときに便利です。  作業がより負荷の大きい処理になるにつれ、既定のパーティショナーで <xref:System.Threading.Tasks.Parallel.For%2A> ループまたは <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループを使用すると、同じまたはそれ以上のパフォーマンスが得られることがあります。  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)   
+ [反復子](../Topic/Iterators%20\(C%23%20and%20Visual%20Basic\).md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-traverse-a-binary-tree-with-parallel-tasks.md b/docs/standard/parallel-programming/how-to-traverse-a-binary-tree-with-parallel-tasks.md
new file mode 100644
index 00000000000..9940a6ff230
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-traverse-a-binary-tree-with-parallel-tasks.md
@@ -0,0 +1,31 @@
+---
+title: "How to: Traverse a Binary Tree with Parallel Tasks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to traverse a tree"
+ms.assetid: 4265d169-6c69-4f36-b10d-b7ae7f72f4df
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Traverse a Binary Tree with Parallel Tasks
+次の例は、ツリーのデータ構造を走査する場合の並列タスクを 2 とおり示しています。  ツリーの作成は演習として残されています。  
+  
+## 使用例  
+ [!code-csharp[TPL#16](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl/cs/tpl.cs#16)]
+ [!code-vb[TPL#16](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl/vb/treewalk.vb#16)]  
+  
+ 2 つのメソッドは機能的に同じです。  <xref:System.Threading.Tasks.TaskFactory.StartNew%2A> メソッドを使用してタスクを作成および実行し、タスクでの待機や例外処理に使用できるタスクからハンドルを取得します。  
+  
+## 参照  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md b/docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md
new file mode 100644
index 00000000000..1be04d5e3a8
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-unlink-dataflow-blocks.md
@@ -0,0 +1,53 @@
+---
+title: "How to: Unlink Dataflow Blocks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "dataflow blocks, unlinking in TPL"
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, unlinking dataflow blocks"
+ms.assetid: 40f0208d-4618-47f7-85cf-4913d07d2d7d
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Unlink Dataflow Blocks
+このドキュメントでは、ソースのデータ フローのターゲット ブロックのリンクを解除方法について説明します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 使用例  
+ 次の例は、呼び出しの各値を計算する `TrySolution` のメソッド <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> の 3 種類のオブジェクトを作成します。  この例では、最初の呼び出しから `TrySolution` に結果だけを終了する必要があります。  
+  
+ [!code-csharp[TPLDataflow_ReceiveAny#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_receiveany/cs/dataflowreceiveany.cs#1)]
+ [!code-vb[TPLDataflow_ReceiveAny#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_receiveany/vb/dataflowreceiveany.vb#1)]  
+  
+ 完了が、この例 `ReceiveFromAny(T)` のメソッドを定義する場合、最初の <xref:System.Threading.Tasks.Dataflow.TransformBlock%602> から値を受け取るには使用します。  `ReceiveFromAny(T)` のメソッドは <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601> オブジェクトの配列を受け取り、<xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> オブジェクトにオブジェクトにリンクします。  ターゲット ブロックにソース データ フローのブロックのリンクに <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A> のメソッドを使用すると、ソースとターゲットのデータが使用可能になったときにメッセージを伝達します。  提供されること <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> クラスの最初のメッセージだけを受け取るため、`ReceiveFromAny(T)` のメソッドは <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Receive%2A> のメソッドを呼び出して結果を生成します。  これは <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> オブジェクトに提供される最初のメッセージを生成します。  <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A> のメソッドに <xref:System.Boolean> パラメーターを使用するオーバーロードされたバージョン、ターゲットが 1 回のソースからメッセージを受信すると `True`に設定されている場合、ターゲットからソース ブロックを解除するように指示する `unlinkAfterOne` があります。  <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> オブジェクトがメッセージを受信するとソースの配列と <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> オブジェクトとの関係が不要なため <xref:System.Threading.Tasks.Dataflow.WriteOnceBlock%601> オブジェクトは、ソースからリンクが解除されることが重要です。  
+  
+ これらの 1 つが計算値、`TrySolution` のメソッドの戻り `ReceiveFromAny(T)` 呼び出しの後で実行 <xref:System.Threading.CancellationToken> オブジェクトを取得した後に、残りの呼び出しが終了することを `TrySolution` を有効にします。  <xref:System.Threading.CancellationToken> オブジェクトがキャンセルされた場合に <xref:System.Threading.SpinWait.SpinUntil%2A> メソッドは true を返します。  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DataflowReceiveAny.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DataflowReceiveAny.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowReceiveAny.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowReceiveAny.vb**  
+  
+## 信頼性の高いプログラミング  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-unwrap-a-nested-task.md b/docs/standard/parallel-programming/how-to-unwrap-a-nested-task.md
new file mode 100644
index 00000000000..59e202cf181
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-unwrap-a-nested-task.md
@@ -0,0 +1,49 @@
+---
+title: "How to: Unwrap a Nested Task | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to unwrap nested tasks"
+ms.assetid: a0769dd2-0f6d-48ca-8418-a9d39de7f450
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# How to: Unwrap a Nested Task
+次の例に示すように、メソッドからタスクを返し、その後待機するか、またはそのタスクから処理を続行することができます。  
+  
+ [!code-csharp[TPL_Unwrap#01](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_unwrap/cs/unwrapprogram.cs#01)]
+ [!code-vb[TPL_Unwrap#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_unwrap/vb/snippets1-3.vb#01)]  
+  
+ 前の例では、<xref:System.Threading.Tasks.Task%601.Result%2A> プロパティは `string` \(Visual Basic では `String`\) 型です。  
+  
+ しかし、シナリオによっては、タスクを別のタスク内で作成し、入れ子のタスクを返す必要がある場合があります。  この場合、外側のタスクの `TResult` は、それ自体がタスクです。  次の例では、Result プロパティは C\# では `Task<Task<string>>`、Visual Basic では `Task(Of Task(Of String))` です。  
+  
+ [!code-csharp[TPL_Unwrap#02](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_unwrap/cs/unwrapprogram.cs#02)]
+ [!code-vb[TPL_Unwrap#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_unwrap/vb/snippets1-3.vb#02)]  
+  
+ 外側のタスクのラップを解除し、元のタスクとその <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティを取得するコードを記述することもできますが、例外とキャンセル要求を処理する必要があるため、そのようなコードを記述するのは容易ではありません。  この状況では、次の例に示すように、いずれかの <xref:System.Threading.Tasks.TaskExtensions.Unwrap%2A> 拡張メソッドを使用することをお勧めします。  
+  
+ [!code-csharp[TPL_UnWrap#03](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_unwrap/cs/unwrapprogram.cs#03)]
+ [!code-vb[TPL_UnWrap#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_unwrap/vb/snippets1-3.vb#03)]  
+  
+ <xref:System.Threading.Tasks.TaskExtensions.Unwrap%2A> メソッドを使用して、任意の `Task<Task>` または `Task<Task<TResult>>` \(Visual Basic では `Task(Of Task)` または `Task(Of Task(Of TResult))`\) を `Task` または `Task<TResult>` \(Visual Basic では `Task(Of TResult)`\) に変換できます。  新しいタスクは、入れ子の内側のタスクを完全に表し、キャンセル状態とすべての例外を含みます。  
+  
+## 使用例  
+ <xref:System.Threading.Tasks.TaskExtensions.Unwrap%2A> 拡張メソッドを使用する方法を次の例に示します。  
+  
+ [!code-csharp[TPL_UnWrap#04](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_unwrap/cs/unwrapprogram.cs#04)]
+ [!code-vb[TPL_UnWrap#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_unwrap/vb/snippet04.vb#04)]  
+  
+## 参照  
+ <xref:System.Threading.Tasks.TaskExtensions?displayProperty=fullName>   
+ [Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md b/docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md
new file mode 100644
index 00000000000..aecac292014
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-use-joinblock-to-read-data-from-multiple-sources.md
@@ -0,0 +1,52 @@
+---
+title: "How to: Use JoinBlock to Read Data From Multiple Sources | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, joining blocks in"
+  - "dataflow blocks, joining in TPL"
+ms.assetid: e9c1ada4-ac57-4704-87cb-2f5117f8151d
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# How to: Use JoinBlock to Read Data From Multiple Sources
+データを複数のソースから使用できる場合は、このドキュメントにアクションを実行するために <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> クラスを使用する方法を示します。  、複数を有効にするには、非最長一致モードを使用する方法を示します。データ ソースを効率的に共有するブロックを示します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 使用例  
+ 次の例では、リソースが使用できるようになると 3 リソースの種類、`NetworkResource`、`FileResource`と `MemoryResource`を定義し、操作を実行したものです。  この例では、最初の操作と 2 番目の操作を実行するに `FileResource` と `MemoryResource` のペアを実行するに `NetworkResource` と `MemoryResource` のペアが必要です。  必要なすべてのリソースを使用するときに、これらの操作を実行できるようにするため、この例では <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> クラス。  <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> オブジェクトはすべてのソースからデータを受け取ると、この例の <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトであるターゲットにそのデータを反映させます。  `MemoryResource` の共有プールから読み取り <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> オブジェクトは、どちらも表示します。  
+  
+ [!code-csharp[TPLDataflow_NonGreedyJoin#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_nongreedyjoin/cs/nongreedyjoin.cs#1)]
+ [!code-vb[TPLDataflow_NonGreedyJoin#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_nongreedyjoin/vb/nongreedyjoin.vb#1)]  
+  
+ `MemoryResource` オブジェクトの共有プールを効率的に使用できるようにするために、この例では、非最長一致モードで動作する <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> オブジェクトを作成する `False` に <xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions.Greedy%2A> のプロパティ セットを持つ <xref:System.Threading.Tasks.Dataflow.GroupingDataflowBlockOptions> オブジェクトを示します。  最短一致の結合ブロックは 1 が各ソースから使用できるようになるまですべての受信メッセージを遅らせます。  遅延メッセージのいずれかが別のブロックを受け入れた場合は、join ブロックはプロセスを再起動します。  非最長一致モードを有効にする他のブロックとしてある場合にデータを待たせる一つ以上のソース ブロックを共有するブロックを結合します。  この例では、`MemoryResource` オブジェクトが `memoryResources` のプールに追加した場合、1 番目と 2 番目のデータ ソースを受け取るようにブロックを前方作業を進めることができます。  この例では、既定では最長一致のモードを使用すると、1 がブロックを `MemoryResource` オブジェクトを受け取り、使用できるようにするには、2 番目のリソースを待機することがあります結合します。  ただし、他の `MemoryResource` join オブジェクトが他に結合するブロックを以降にブロックに使用できる 2 番目のデータ ソースがある場合は行うことができません。  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DataflowNonGreedyJoin.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DataflowNonGreedyJoin.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowNonGreedyJoin.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowNonGreedyJoin.vb**  
+  
+## 信頼性の高いプログラミング  
+ 最短一致の結合の使用は、アプリケーションでデッドロックを防止できます。  ソフトウェア アプリケーションで、2 つ以上のプロセスがそれぞれリソースを確保し、別のプロセスがリソースを解放するのをお互いに待機すると、*デッドロック*が発生します。  <xref:System.Threading.Tasks.Dataflow.JoinBlock%602> の 2 種類のオブジェクトを定義するアプリケーションがあるとします。  オブジェクトは、それぞれ 2 とおりの共有ソース ブロックからデータを読み取ります。  最長モードでは、この 1 つが join ブロックは最初のソースから読み取り、リソースを解放するために両方のブロックを相互に待機する他を結合するため、2 番目は、二つ目のソースからブロックを読み取り、アプリケーション デッドロックの可能性がある結合します。  非最長一致モードでは、各ソースからは、すべてのデータを使用して、デッドロックの危険性が削除された場合だけブロックを読み取ります結合します。  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-use-parallel-invoke-to-execute-parallel-operations.md b/docs/standard/parallel-programming/how-to-use-parallel-invoke-to-execute-parallel-operations.md
new file mode 100644
index 00000000000..72fb0d67057
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-use-parallel-invoke-to-execute-parallel-operations.md
@@ -0,0 +1,44 @@
+---
+title: "How to: Use Parallel.Invoke to Execute Parallel Operations | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "task parallelism in .NET"
+  - "parallel programming, task parallelism"
+ms.assetid: 6b3ecd79-dec9-4ce1-abf4-62e5392a59c6
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# How to: Use Parallel.Invoke to Execute Parallel Operations
+この例では、タスク並列ライブラリの <xref:System.Threading.Tasks.Parallel.Invoke%2A> を使用して操作を並列化する方法を示します。  共有データ ソースで 3 つの操作が実行されます。  操作によってソースが変更されるわけではないため、簡単に並列実行できます。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して TPL でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[TPL_Parallel#06](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/parallelinvoke.cs#06)]
+ [!code-vb[TPL_Parallel#06](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/parallelinvoke.vb#06)]  
+  
+ なお、<xref:System.Threading.Tasks.Parallel.Invoke%2A> を使用すると、どの操作を同時に実行するかを示すだけで、ランタイムによりすべてのスレッドのスケジュール詳細が処理され、ホスト コンピューター上のコア数も自動的に調整されます。  
+  
+ この例では、データではなく操作を並列化します。  別の方法としては、PLINQ を使用して LINQ クエリを並列化し、クエリを順番に実行できます。  また、PLINQ を使用してデータを並列化することもできます。  もう 1 つのオプションとしては、クエリとタスクの両方を並列化する方法もあります。  プロセッサの数が比較的少ないホスト コンピューターでは、オーバーヘッドの発生によってパフォーマンスが低下しますが、プロセッサ数の多いコンピューターではパフォーマンスは適切に調整されます。  
+  
+## コードのコンパイル  
+  
+-   この例の全体をコピーして、Microsoft Visual Studio 2010 プロジェクトに貼り付けて F5 キーを押します。  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [How to: Wait on One or More Tasks to Complete](../Topic/How%20to:%20Wait%20on%20One%20or%20More%20Tasks%20to%20Complete.md)   
+ [How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-wrap-eap-patterns-in-a-task.md b/docs/standard/parallel-programming/how-to-wrap-eap-patterns-in-a-task.md
new file mode 100644
index 00000000000..9d98bcea536
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-wrap-eap-patterns-in-a-task.md
@@ -0,0 +1,29 @@
+---
+title: "How to: Wrap EAP Patterns in a Task | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, how to wrap EAP patterns"
+ms.assetid: f11ed467-af2f-4504-8a2e-299a6c36d44e
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Wrap EAP Patterns in a Task
+次の例に <xref:System.Threading.Tasks.TaskCompletionSource%601>を使用して 1 個のタスクとして Event\-based Asynchronous Pattern \(EAP\) 操作の任意のシーケンスを公開する方法を示します。  この例では、<xref:System.Threading.CancellationToken> を使用して <xref:System.Net.WebClient> オブジェクトで組み込みのキャンセル メソッドを呼び出す方法も示しています。  
+  
+## 使用例  
+ [!code-csharp[FromAsync#08](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#08)]
+ [!code-vb[FromAsync#08](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#08)]  
+  
+## 参照  
+ [TPL and Traditional .NET Framework Asynchronous Programming](../../../docs/standard/parallel-programming/tpl-and-traditional-async-programming.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-a-custom-plinq-aggregate-function.md b/docs/standard/parallel-programming/how-to-write-a-custom-plinq-aggregate-function.md
new file mode 100644
index 00000000000..c8410b02b41
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-a-custom-plinq-aggregate-function.md
@@ -0,0 +1,39 @@
+---
+title: "How to: Write a Custom PLINQ Aggregate Function | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, how to create aggregate function"
+ms.assetid: 5a70dd49-ab2a-4798-b551-196ee7042b1a
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# How to: Write a Custom PLINQ Aggregate Function
+この例では、<xref:System.Linq.ParallelEnumerable.Aggregate%2A> メソッドを使用してカスタムの集計関数をソース シーケンスに適用する方法を示します。  
+  
+> [!WARNING]
+>  この例は使用法を示すことを目的としており、同等の LINQ to Objects 順次クエリよりも実行速度が遅い場合があります。  高速化の詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 使用例  
+ 次の例では、整数のシーケンスの標準偏差を計算します。  
+  
+ [!code-csharp[PLINQ#31](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#31)]
+ [!code-vb[PLINQ#31](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#31)]  
+  
+ この例では、PLINQ に固有の Aggregate 標準クエリ演算子のオーバーロードを使用します。  このオーバーロードでは、3 つ目の入力パラメーターとして <xref:System.Func%603?displayProperty=fullName> を使用します。  このデリゲートでは、すべてのスレッドの結果をまとめてから、集計結果での最終的な計算が実行されます。  この例では、すべてのスレッドからの合計が追加されます。  
+  
+ ラムダ式の本体が単一の式から構成される場合、<xref:System.Func%602?displayProperty=fullName> デリゲートの戻り値は式の値になります。  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable>   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md b/docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md
new file mode 100644
index 00000000000..cf645eac69d
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md
@@ -0,0 +1,52 @@
+---
+title: "How to: Write a Parallel.For Loop with Thread-Local Variables | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel for loops, how to use local state"
+ms.assetid: 68384064-7ee7-41e2-90e3-71f00bde01bb
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# How to: Write a Parallel.For Loop with Thread-Local Variables
+次の例に、<xref:System.Threading.Tasks.Parallel.For%2A> ループによって生成される個別のタスクごとの状態を、スレッド ローカル変数を使用して格納および取得する方法を示します。  スレッド ローカル変数を使用することで、共有状態への多数のアクセスを同期するオーバーヘッドを回避できます。  反復処理ごとに共有リソースを作成する代わりに、タスクの反復処理のすべてが完了するまで、値を計算して格納します。  この場合、最終結果を共有リソースに 1 回書き込んだり、別のメソッドに渡したりすることができます。  
+  
+## 使用例  
+ <xref:System.Threading.Tasks.Parallel.For%60%601%28System.Int32%2CSystem.Int32%2CSystem.Func%7B%60%600%7D%2CSystem.Func%7BSystem.Int32%2CSystem.Threading.Tasks.ParallelLoopState%2C%60%600%2C%60%600%7D%2CSystem.Action%7B%60%600%7D%29> メソッドを呼び出して、100 万個の要素からなる配列の値の合計を計算する例を次に示します。  各要素の値は、そのインデックスに相当します。  
+  
+ [!code-csharp[TPL_Parallel#05](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/forandforeach_simple.cs#05)]
+ [!code-vb[TPL_Parallel#05](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/forwiththreadlocal.vb#05)]  
+  
+ すべての <xref:System.Threading.Tasks.Parallel.For%2A> メソッドで、最初の 2 つのパラメーターが最初と最後の反復値を指定します。  メソッドのこのオーバーロードでは、3 番目のパラメーターでローカル状態を初期化します。  このコンテキストでのローカル状態は、現在のスレッドで実行されるループの最初の反復処理の直前から最後の反復処理の直後までの有効期限を持つ変数を意味します。  
+  
+ 3 番目のパラメーターの型は <xref:System.Func%601> です。ここで、`TResult` はスレッド ローカル状態を格納する変数の型です。  この型は、ジェネリックの <xref:System.Threading.Tasks.Parallel.For%60%601%28System.Int32%2CSystem.Int32%2CSystem.Func%7B%60%600%7D%2CSystem.Func%7BSystem.Int32%2CSystem.Threading.Tasks.ParallelLoopState%2C%60%600%2C%60%600%7D%2CSystem.Action%7B%60%600%7D%29> メソッドの呼び出し時に提供されるジェネリック型引数によって定義されます \(この例では、<xref:System.Int64>\)。  型引数は、コンパイラに対し、スレッド ローカル状態を格納するために使用する一時変数の型を指定します。  この例では、式 `() => 0` \(Visual Basic の場合は `Function() 0`\) でスレッド ローカル変数をゼロに初期化します。  ジェネリック型引数が参照型またはユーザー定義の値型である場合は、以下のような式になります。  
+  
+```csharp  
+() => new MyClass()  
+```  
+  
+```vb  
+Function() new MyClass()  
+```  
+  
+ 4 番目のパラメーターは、ループのロジックを定義します。  パラメーター値は、シグネチャが `Func<int, ParallelLoopState, long, long>` \(C\# の場合\) または `Func(Of Integer, ParallelLoopState, Long, Long)` \(Visual Basic の場合\) となっているデリゲートまたはラムダ式でなければなりません。  最初のパラメーターは、ループのその特定の反復処理に対するループ カウンターの値です。  2 番目のパラメーターは、ループを抜けるために使用できる <xref:System.Threading.Tasks.ParallelLoopState> オブジェクトです。このオブジェクトは、<xref:System.Threading.Tasks.Parallel> クラスによって各ループの発生時に提供されます。  3 番目のパラメーターは、スレッド ローカル変数です。  最後のパラメーターは、戻り値の型です。  この例の場合、型は <xref:System.Threading.Tasks.Parallel.For%2A> 型引数で指定されているため、<xref:System.Int64> になります。  その変数の名前は `subtotal` です。これは、ラムダ式によって返されます。  この戻り値が、ループの次の反復処理で `subtotal` を初期化するために使用されます。  この最後のパラメーターは、各反復処理に渡されて、最後の反復処理が完了した時点で `localFinally` デリゲートに渡される値であるとも考えられます。  
+  
+ 5 番目のパラメーターが定義するメソッドは、特定のスレッドでのすべての反復処理が完了した時点で 1 回だけ呼び出されます。  この場合も、入力引数の型は <xref:System.Threading.Tasks.Parallel.For%60%601%28System.Int32%2CSystem.Int32%2CSystem.Func%7B%60%600%7D%2CSystem.Func%7BSystem.Int32%2CSystem.Threading.Tasks.ParallelLoopState%2C%60%600%2C%60%600%7D%2CSystem.Action%7B%60%600%7D%29> メソッドの型引数、および本体のラムダ式によって返される型と一致します。  この例では、スレッド セーフな方法で、この値をクラス スコープで変数に追加するために、<xref:System.Threading.Interlocked.Add%2A?displayProperty=fullName> メソッドを呼び出します。  スレッド ローカル変数を使用することで、このクラス変数をループのすべての反復処理で作成する手間を省きました。  
+  
+ ラムダ式の使用方法の詳細については、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md b/docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md
new file mode 100644
index 00000000000..ebafd4d0438
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md
@@ -0,0 +1,55 @@
+---
+title: "How to: Write a Parallel.ForEach Loop with Thread-Local Variables | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel foreach loop, how to use local state"
+ms.assetid: 24b10041-b30b-45cb-aa65-66cf568ca76d
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# How to: Write a Parallel.ForEach Loop with Thread-Local Variables
+スレッド ローカル変数を持つ <xref:System.Threading.Tasks.Parallel.ForEach%2A> メソッドを記述する方法を次の例に示します。  <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループが実行されると、そのソース コレクションが複数のパーティションに分割されます。  各パーティションには、"スレッド ローカル" 変数が個別にコピーされます   \("スレッド ローカル" という用語は少し不正確です。1 つのスレッド上で 2 つのパーティションが実行されることがあるからです\)。  
+  
+ この例のコードおよびパラメーターは、対応する <xref:System.Threading.Tasks.Parallel.For%2A> メソッドによく似ています。  詳細については、「[How to: Write a Parallel.For Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md)」を参照してください。  
+  
+ <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループでスレッド ローカル変数を使用するには、2 つのタイプのパラメーターを取るメソッド オーバーロードのうち、いずれか 1 つを呼び出す必要があります。  最初の型パラメーター `TSource` でソース要素の型を指定し、2 番目の型パラメーター `TLocal` でスレッド ローカル変数の型を指定します。  
+  
+## 使用例  
+ 以下の例では、<xref:System.Threading.Tasks.Parallel.ForEach%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%601%7D%2CSystem.Func%7B%60%600%2CSystem.Threading.Tasks.ParallelLoopState%2C%60%601%2C%60%601%7D%2CSystem.Action%7B%60%601%7D%29?displayProperty=fullName> のオーバーロードを呼び出して、100 万個の要素からなる配列の合計を計算します。  このオーバーロードには、4 つのパラメータがあります。  
+  
+-   `source`。データ ソースです。  これは、<xref:System.Collections.Generic.IEnumerable%601> を実装する必要があります。  この例のデータ ソースは、<xref:System.Linq.Enumerable.Range%2A?displayProperty=fullName> によって返される、100 万個のメンバーからなる `IEnumerable<Int32>` オブジェクトです。  
+  
+-   `localInit`。またはスレッド ローカル変数を初期化する関数です。  この関数は、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> 操作が実行される各パーティションで 1 回呼び出されます。  この例では、スレッド ローカル変数がゼロに初期化されます。  
+  
+-   `body`。ループの各反復処理に対して並列ループで呼び出される <xref:System.Func%604> です。  シグニチャは `Func\<TSource, ParallelLoopState, TLocal, TLocal>` です。  プログラマはデリゲートのコードを作成します。入力パラメーターはループから渡されます。これらの入力パラメーターは以下のとおりです。  
+  
+    -   <xref:System.Collections.Generic.IEnumerable%601> の現在の要素。  
+  
+    -   <xref:System.Threading.Tasks.ParallelLoopState> 変数。デリゲートのコードで、ループの状態を確認するために使用できます。  
+  
+    -   スレッド ローカル変数。  
+  
+     デリゲートからスレッド ローカル変数が返されると、その変数は、その特定のパーティションで実行されるループの次の反復処理に渡されます。  ループ パーティションごとに、この変数の個別のインスタンスが保持されます。  
+  
+     この例では、デリゲートによって個々の整数の値がスレッド ローカル変数に追加されます。スレッド ローカル変数には、そのパーティションで順次追加される整数要素の値の現在の合計が保持されます。  
+  
+-   `localFinally`。各パーティションでのループ操作が完了した時点で、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> によって呼び出される `Action<TLocal>` デリゲート。  <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> メソッドは、`Action<TLocal>` デリゲートに、このスレッド \(ループ パーティション\) のスレッド ローカル変数の最終値を返します。プログラマは、このパーティションの結果と他のパーティションの結果を結合するために必要な操作を実行するコードを作成します。  このデリゲートは、複数のタスクで同時に呼び出すことができます。  このため、この例では `total` 変数へのアクセスを同期するために <xref:System.Threading.Interlocked.Add%28System.Int32%40%2CSystem.Int32%29?displayProperty=fullName> メソッドが使用されます。  デリゲート型は <xref:System.Action%601> であるため、戻り値はありません。  
+  
+ [!code-csharp[TPL_Parallel#04](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/foreachthreadlocal.cs#04)]
+ [!code-vb[TPL_Parallel#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/foreachthreadlocal.vb#04)]  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [How to: Write a Parallel.For Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md)   
+ [Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md
new file mode 100644
index 00000000000..a0ec9160b25
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md
@@ -0,0 +1,71 @@
+---
+title: "How to: Write a Simple Parallel.For Loop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Parallel.For, How to Write"
+  - "for loop, parallel construction in .NET"
+  - "parallel for loops, how to use"
+ms.assetid: 9029ba7f-a9d1-4526-8c84-c88716dba5d4
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# How to: Write a Simple Parallel.For Loop
+このトピックでは、<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドを示す 2 つの例を示しています。  最初の例では <xref:System.Threading.Tasks.Parallel.For%28System.Int64%2CSystem.Int64%2CSystem.Action%7BSystem.Int64%7D%29?displayProperty=fullName> メソッドのオーバー ロードを使用し、2 番目の例では <xref:System.Threading.Tasks.Parallel.For%28System.Int32%2CSystem.Int32%2CSystem.Action%7BSystem.Int32%7D%29?displayProperty=fullName> のオーバー ロードを使用しています。これらは <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドの 2 つの最も単純なオーバーロードです。  <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドのこれらの 2 つのオーバー ロードは、ループをキャンセルする必要がない場合、ループのイテレーションから抜ける場合、またはいずれかのスレッドローカル状態を維持する場合に使用します。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して TPL でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+ 最初の例では、1 つのディレクトリ内のファイルのサイズを計算します。  2 つ目の例では、2 つの行列の積を計算します。  
+  
+## 使用例  
+ この例は、ディレクトリ内のファイルの合計サイズを計算する単純なコマンド ライン ユーティリティです。  引数として 1 つのディレクトリ パスを必要とし、対象のディレクトリ内のファイルの数と合計サイズを報告します。  ディレクトリが存在することを確認したら、<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドを使用してディレクトリ内のファイルを列挙し、そのファイルのサイズを決定します。  そして、各ファイル サイズが `totalSize` 変数に追加されます。  加算処理は、アトミックな操作として実行できるように、<xref:System.Threading.Interlocked.Add%2A?displayProperty=fullName> を呼び出して実行されることに注意してください。  そうしない場合、複数のタスクが同時に `totalSize` 変数を更新しようとすることがあります。  
+  
+ [!code-csharp[Conceptual.Parallel.For#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.parallel.for/cs/for1.cs#1)]
+ [!code-vb[Conceptual.Parallel.For#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.parallel.for/vb/for1.vb#1)]  
+  
+## 使用例  
+ この例では、<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> メソッドを使用して 2 つの行列の積を計算します。  また、<xref:System.Diagnostics.Stopwatch?displayProperty=fullName> クラスを使用して並列ループと並列ではないループのパフォーマンスを比較する方法も示しています。  大量の出力が生成されるため、この例では出力をファイルにリダイレクトできることに注意してください。  
+  
+ [!code-csharp[TPL_Parallel#01](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/simpleparallelfor.cs#01)]
+ [!code-vb[TPL_Parallel#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/simpleparallelfor.vb#01)]  
+  
+ ループを含む任意のコードを並列処理する場合、1 つの重要な目標は、並列処理のオーバーヘッドがパフォーマンス上の利点を無にするところまで並列化しすぎることなく、できるだけプロセッサを活用することです。  この特殊な例では、内側のループで実行される作業があまり多くないため、外側のループのみが並列化されています。  少量の作業と不適切なキャッシュの影響が組み合わさって、結果として入れ子になった並列ループのパフォーマンスが低下することがあります。  このため、大部分のシステムでは、外側のループだけを並列化することで、最大限の効果を得ることができると言えます。  
+  
+## デリゲート  
+ この <xref:System.Threading.Tasks.Parallel.For%2A> のオーバーロードの 3 番目のパラメーターは、`Action<int>` 型 \(C\#\) または`Action(Of Integer)` 型 \(Visual Basic\) のデリゲートです。  `Action` デリゲートは、0 種類、1 種類、または 16 種類のパラメーターのいずれがあっても常に void を返します。  Visual Basic では、`Action` の動作は `Sub` で定義されます。  例では、ラムダ式を使用してデリゲートを作成していますが、他の方法でも同様にデリゲートを作成することができます。  詳細については、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+## イテレーション値  
+ デリゲートは、値が現在のイテレーションである 1 つの入力パラメーターを受け取ります。  このイテレーション値はランタイムによって提供され、その開始値は、現在のスレッドで処理されているソースのセグメント \(パーティション\) の最初の要素のインデックスです。  
+  
+ 同時実行レベルをより細かく制御する必要がある場合は、<xref:System.Threading.Tasks.Parallel.For%28System.Int32%2CSystem.Int32%2CSystem.Threading.Tasks.ParallelOptions%2CSystem.Action%7BSystem.Int32%2CSystem.Threading.Tasks.ParallelLoopState%7D%29?displayProperty=fullName> などの <xref:System.Threading.Tasks.ParallelOptions?displayProperty=fullName> 入力パラメーターを受け取るいずれかのオーバーロードを使用します。  
+  
+## 戻り値と例外処理  
+ すべてのスレッドが完了すると、<xref:System.Threading.Tasks.Parallel.For%2A> は <xref:System.Threading.Tasks.ParallelLoopResult?displayProperty=fullName> オブジェクトを返します。  この戻り値は、手動でループのイテレーションを停止したり抜けたりする場合に役立ちます。完了まで実行した最後のイテレーションなどの情報を <xref:System.Threading.Tasks.ParallelLoopResult> が格納しているためです。  いずれかのスレッドで 1 つ以上の例外が発生した場合、<xref:System.AggregateException?displayProperty=fullName> がスローされます。  
+  
+ この例のコードでは、戻り値に <xref:System.Threading.Tasks.Parallel.For%2A> は使用されません。  
+  
+## 分析とパフォーマンス  
+ パフォーマンス ウィザードを使用すると、コンピューター上の CPU 使用率を表示できます。  試しに、マトリックスの列と行の数を増やします。  マトリックスが大きいほど、並列バージョンとシーケンシャル バージョンの計算の間でパフォーマンスの違いが大きくなります。  マトリックスが小さい場合、並列ループを設定する際のオーバーヘッドがあるため、シーケンシャル バージョンのほうが高速に実行します。  
+  
+ コンソールやファイル システムなどの共有リソースへの同期呼び出しを行うと、並列ループのパフォーマンスが大幅に低下します。  パフォーマンスを測定する際は、ループ内の <xref:System.Console.WriteLine%2A?displayProperty=fullName> などの呼び出しを避けるようにしてください。  
+  
+## コードのコンパイル  
+  
+-   このコードを切り取って、Visual Studio 2010 プロジェクトに貼り付けます。  
+  
+## 参照  
+ <xref:System.Threading.Tasks.Parallel.For%2A>   
+ <xref:System.Threading.Tasks.Parallel.ForEach%2A>   
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-a-simple-parallel-foreach-loop.md b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-foreach-loop.md
new file mode 100644
index 00000000000..5a8a8af5b50
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-a-simple-parallel-foreach-loop.md
@@ -0,0 +1,54 @@
+---
+title: "How to: Write a Simple Parallel.ForEach Loop | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "foreach, parallel version"
+  - "parallel programming, foreach"
+ms.assetid: cb5fab92-1c19-499e-ae91-8b7525dd875f
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# How to: Write a Simple Parallel.ForEach Loop
+この例では、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> ループを使用して <xref:System.Collections.IEnumerable?displayProperty=fullName> データ ソースまたは <xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> データ ソースを対象にデータを並列化する方法を示します。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して PLINQ でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+## 使用例  
+ [!code-csharp[TPL_Parallel#03](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/simpleforeach.cs#03)]
+ [!code-vb[TPL_Parallel#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/simpleforeach.vb#03)]  
+  
+ <xref:System.Threading.Tasks.Parallel.ForEach%2A> ループは <xref:System.Threading.Tasks.Parallel.For%2A> ループと同様に動作します。  ソース コレクションがパーティション分割され、システム環境に基づいて複数のスレッドに処理がスケジュールされます。  システム上のプロセッサの数が多いほど、並列メソッドの実行速度は速くなります。  ソース コレクションの中には、ソースのサイズおよび実行される作業の種類によっては、順次ループが早くなるものがあります。  パフォーマンスの詳細については、「[Potential Pitfalls in Data and Task Parallelism](../../../docs/standard/parallel-programming/potential-pitfalls-in-data-and-task-parallelism.md)」を参照してください。  
+  
+ 並列ループの詳細については、「[How to: Write a Simple Parallel.For Loop](../../../docs/standard/parallel-programming/how-to-write-a-simple-parallel-for-loop.md)」を参照してください。  
+  
+ 非ジェネリック コレクションで <xref:System.Threading.Tasks.Parallel.ForEach%2A> を使用するには、次の例に示すように、<xref:System.Linq.Enumerable.Cast%2A> 拡張メソッドを使用してコレクションをジェネリック コレクションに変換します。  
+  
+ [!code-csharp[TPL_Parallel#07](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_parallel/cs/nongeneric.cs#07)]
+ [!code-vb[TPL_Parallel#07](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_parallel/vb/nongeneric.vb#07)]  
+  
+ Parallel LINQ \(PLINQ\) を使用して、<xref:System.Collections.Generic.IEnumerable%601> データ ソースの処理を並列化することもできます。  PLINQ により、宣言型のクエリ構文を使用してループの動作を表現できます。  詳細については、「[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)」を参照してください。  
+  
+## コードのコンパイル  
+  
+-   このコードをコピーして [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] 2010 コンソール アプリケーション プロジェクトに貼り付けます。  
+  
+-   System.Drawing.dll への参照を追加します。  
+  
+-   F5 キーを押します。  
+  
+## 参照  
+ [Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md b/docs/standard/parallel-programming/how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md
new file mode 100644
index 00000000000..178ea6cb475
--- /dev/null
+++ b/docs/standard/parallel-programming/how-to-write-messages-to-and-read-messages-from-a-dataflow-block.md
@@ -0,0 +1,71 @@
+---
+title: "How to: Write Messages to and Read Messages from a Dataflow Block | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, reading and writing messages"
+ms.assetid: 1a9bf078-aa82-46eb-b95a-f87237f028c5
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Write Messages to and Read Messages from a Dataflow Block
+このドキュメントでは、メッセージを書き込んでデータ フローのブロックからメッセージを読み取るために TPL データ フローのライブラリを使用する方法について説明します。  TPL データ フローのライブラリには、メッセージをへの書き込み、データ フローのブロックからメッセージを読み取ります。に同期および非同期のメソッドを提供します。  ここでは <xref:System.Threading.Tasks.Dataflow.BufferBlock%601?displayProperty=fullName> クラスを使用します。  <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> クラスはメッセージをバッファーに格納し、メッセージ ソースとターゲット メッセージとして機能します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## への同期的に書き込み、データ フローのブロックから読み取ります。  
+ 次の例では、同じオブジェクトからの読み取り <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> のデータ フローのブロックと <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Receive%2A> メソッドの書き込みに <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A> のメソッドを使用します。  
+  
+ [!code-csharp[TPLDataflow_ReadWrite#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_readwrite/cs/dataflowreadwrite.cs#2)]
+ [!code-vb[TPLDataflow_ReadWrite#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_readwrite/vb/dataflowreadwrite.vb#2)]  
+  
+ また、次の例に示すように、データ フローのブロックから、読み取りに <xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceive%2A> のメソッドを使用できます。  <xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceive%2A> のメソッドは、データとしてときどきポーリングするときに現在のスレッドをブロックする場合に便利です。  
+  
+ [!code-csharp[TPLDataflow_ReadWrite#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_readwrite/cs/dataflowreadwrite.cs#3)]
+ [!code-vb[TPLDataflow_ReadWrite#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_readwrite/vb/dataflowreadwrite.vb#3)]  
+  
+ <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A> のメソッドが同期的に動作するため、前の例の <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> オブジェクトは、2 番目のループがデータを読み込んだりする前にすべてのデータが表示されます。  次の例では <xref:System.Threading.Tasks.Parallel.Invoke%2A> を使用してから読み取り、メッセージ ブロックに同時に書き込みを行うために最初の例を拡張します。  <xref:System.Threading.Tasks.Parallel.Invoke%2A> が操作を同時に実行するため、これらの値は、特定の順序に <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> オブジェクトに書き込まれません。  
+  
+ [!code-csharp[TPLDataflow_ReadWrite#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_readwrite/cs/dataflowreadwrite.cs#4)]
+ [!code-vb[TPLDataflow_ReadWrite#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_readwrite/vb/dataflowreadwrite.vb#4)]  
+  
+## への非同期的に書き込み、データ フローのブロックから読み取ります。  
+ 次の例は、非同期的に非同期的に同じからオブジェクトの読み取り <xref:System.Threading.Tasks.Dataflow.BufferBlock%601> オブジェクトと <xref:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync%2A> メソッドの書き込みに <xref:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync%2A> のメソッドを使用します。  この例では、非同期的にデータを送信し、ターゲット ブロックからデータを読み取るために [async](../Topic/async%20\(C%23%20Reference\).md) と [待機します。](../Topic/await%20\(C%23%20Reference\).md) の演算子 \(Visual Basic で[Async](../Topic/Async%20\(Visual%20Basic\).md) と [待機します。](../Topic/Await%20Operator%20\(Visual%20Basic\).md)\) を使用します。  <xref:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync%2A> のメソッドは、データ フローのブロックがメッセージを延期するようにする必要がある場合に便利です。  <xref:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync%2A> のメソッドがそのデータが使用できるようになるとデータに適用する場合に便利です。  メッセージをメッセージ ブロック間に反映させるか詳細については、[データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)セクションのメッセージ パッシングを参照します。  
+  
+ [!code-csharp[TPLDataflow_ReadWrite#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_readwrite/cs/dataflowreadwrite.cs#5)]
+ [!code-vb[TPLDataflow_ReadWrite#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_readwrite/vb/dataflowreadwrite.vb#5)]  
+  
+## 完全なコード例  
+ 次の例では、このドキュメントの完全なコードを示しています。  
+  
+ [!code-csharp[TPLDataflow_ReadWrite#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_readwrite/cs/dataflowreadwrite.cs#1)]
+ [!code-vb[TPLDataflow_ReadWrite#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_readwrite/vb/dataflowreadwrite.vb#1)]  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`DataflowReadWrite.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`DataflowReadWrite.vb`\) という、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowReadWrite.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll DataflowReadWrite.vb**  
+  
+## 次の手順  
+ この例からの読み込みメッセージ ブロックに直接書き込む方法を示します。  データ フローのブロックのリニア シーケンスである、または *ネットワーク*接続してフォームのデータ フローのブロックのグラフである *パイプライン*からデータ フローのブロックを区切ります。  パイプラインまたはネットワークでは、データが使用可能になると、ソースはターゲットに非同期的にデータを伝達します。  基本的なデータフロー パイプラインを作成する方法の例については、[Walkthrough: Creating a Dataflow Pipeline](../../../docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md)を参照してください。  より複雑なデータ フロー ネットワークを作成する例については、[Walkthrough: Using Dataflow in a Windows Forms Application](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)を参照してください。  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/index.md b/docs/standard/parallel-programming/index.md
new file mode 100644
index 00000000000..f04176b3bd2
--- /dev/null
+++ b/docs/standard/parallel-programming/index.md
@@ -0,0 +1,41 @@
+---
+title: "Parallel Programming in the .NET Framework | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel programming"
+ms.assetid: 4d83c690-ad2d-489e-a2e0-b85b898a672d
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Parallel Programming in the .NET Framework
+多くのパーソナル コンピューターとワークステーションには、複数スレッドの同時実行を可能にする 2 つまたは 4 つのコア \(CPU\) があります。  近い将来、コンピューターは、これよりはるかに多くのコアを搭載すると予想されています。  現在および将来のハードウェアを活用するには、コードを並列化して複数のプロセッサに負荷を分散します。  以前は、並列化には低水準のスレッドおよびロックの操作が必要でした。  [!INCLUDE[vs_dev10_long](../../../includes/vs-dev10-long-md.md)] および [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] では、新しいランタイム、新しいクラス ライブラリの型、および新しい診断ツールを提供することで、並列プログラミングのサポートを強化しています。  これらの機能により並行開発が簡素化され、スレッドやスレッド プールを直接操作することなく、効率的で詳細な、拡張性のある並列コードを自然な表現方法で記述できるようになります。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] の並列プログラミング アーキテクチャの高度な概要を次の図に示します。  
+  
+ ![.NET 並列プログラミング アーキテクチャ](../../../docs/standard/parallel-programming/media/tpl-architecture.png "TPL\_Architecture")  
+  
+## 関連トピック  
+  
+|テクノロジ|説明|  
+|-----------|--------|  
+|[Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)|並列バージョンの <xref:System.Threading.Tasks.Parallel?displayProperty=fullName> ループおよび `For` ループを含む `ForEach` クラスに関するドキュメントと、非同期操作の推奨される表現方法を表す <xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスに関するドキュメントが用意されています。|  
+|[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)|さまざまなシナリオでパフォーマンスを大幅に向上させる、LINQ to Objects の並列実装です。|  
+|[Data Structures for Parallel Programming](../../../docs/standard/parallel-programming/data-structures-for-parallel-programming.md)|スレッド セーフなコレクション クラス、軽量な同期型、および限定的な初期化の種類に関するドキュメントへのリンクを示します。|  
+|[Parallel Diagnostic Tools](../../../docs/standard/parallel-programming/parallel-diagnostic-tools.md)|Visual Studio デバッガーのタスク ウィンドウと並列スタック ウィンドウに関するドキュメントと、デバッグおよび並列コードのパフォーマンスの調整に使用できる [!INCLUDE[vsprvsts](../../../includes/vsprvsts-md.md)] プロファイラーの一連のビューで構成される[同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md)に関するドキュメントへのリンクを示します。|  
+|[Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)|パーティションのしくみと、既定のパーティションの設定方法または新しいパーティションの作成方法について説明します。|  
+|[Task Schedulers](../Topic/Task%20Schedulers.md)|スケジューラのしくみと既定のスケジューラの構成方法について説明します。|  
+|[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)|C\# および Visual Basic のラムダ式について簡単に説明し、PLINQ およびタスク並列ライブラリでラムダ式を使用する方法を示します。|  
+|[For Further Reading](../../../docs/standard/parallel-programming/for-further-reading-parallel-programming.md)|.NET Framework での並列プログラミングに関する追加のドキュメントとサンプル リソースへのリンクを示します。|  
+  
+## 参照  
+ [Patterns for Parallel Programming: Understanding and Applying Parallel Patterns with the .NET Framework 4 \(並列プログラミングのパターン: .NET Framework 4 での並列パターンの理解と適用\)](http://go.microsoft.com/fwlink/?LinkID=185142)   
+ [Samples for Parallel Programming with the .NET Framework \(.NET Framework による並列プログラミングのサンプル\)](http://code.msdn.microsoft.com/Samples-for-Parallel-b4b76364)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/introduction-to-plinq.md b/docs/standard/parallel-programming/introduction-to-plinq.md
new file mode 100644
index 00000000000..c8ff11f9f8f
--- /dev/null
+++ b/docs/standard/parallel-programming/introduction-to-plinq.md
@@ -0,0 +1,126 @@
+---
+title: "Introduction to PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, introduction to"
+ms.assetid: eaa720d8-8999-4eb7-8df5-3c19ca61cad0
+caps.latest.revision: 22
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 22
+---
+# Introduction to PLINQ
+## 並列クエリとは  
+ 統合言語クエリ \(LINQ\) は [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] で導入されました。これはタイプ セーフな方法で任意の <xref:System.Collections.IEnumerable?displayProperty=fullName> または <xref:System.Collections.Generic.IEnumerable%601?displayProperty=fullName> のデータ ソースを照会する、統一されたモデルです。  LINQ to Objects とは、<xref:System.Collections.Generic.List%601> や配列などのメモリ内コレクションに対して実行される LINQ クエリの名前です。  この記事では、LINQ の基礎を理解していることを前提としています。  詳細については、「[LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)」を参照してください。  
+  
+ Parallel LINQ \(PLINQ\) は、LINQ パターンの並列実装です。  PLINQ クエリは、あらゆる意味において、並列ではない LINQ to Objects クエリに似ています。  PLINQ クエリは、[!INCLUDE[vbteclinq](../../../includes/vbteclinq-md.md)] の順次クエリと同様、メモリ内の <xref:System.Collections.IEnumerable> または <xref:System.Collections.Generic.IEnumerable%601> データ ソースで実行され、遅延実行が存在するので、クエリが列挙されるまでは実行されません。  主な相違点は、PLINQ は、システムのすべてのプロセッサを十分に活用しようとする点です。  そのために、データ ソースをセグメントにパーティション分割し、複数のプロセッサで個々のワーカー スレッドの各セグメントに対してクエリを並行実行します。  多くの場合、並行実行によって、クエリは非常に高速に処理されます。  
+  
+ 一部の種類のクエリについては、データ ソースに <xref:System.Linq.ParallelEnumerable.AsParallel%2A> クエリ操作を追加して並行実行することで、レガシ コードよりも大幅なパフォーマンスの向上を PLINQ で実現できます。  ただし、並列処理にはある程度の複雑さが伴うため、すべてのクエリ操作が PLINQ でより速く実行されるわけではありません。  実際、一部のクエリについては、並列化によって処理速度が遅くなります。  そのため、順序付けなどの問題が並列クエリに与える影響を理解しておく必要があります。  詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して PLINQ でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+ この記事の残りの部分では、主な PLINQ クラスの概要を紹介し、PLINQ クエリの作成方法について説明します。  各セクションには、詳細情報とコード例へのリンクも含まれています。  
+  
+## ParallelEnumerable クラス  
+ <xref:System.Linq.ParallelEnumerable?displayProperty=fullName> クラスは、ほぼすべての PLINQ 機能を公開します。このクラスと、その他の <xref:System.Linq?displayProperty=fullName> 名前空間の型は、System.Core.dll アセンブリにコンパイルされます。  Visual Studio の既定の C\# プロジェクトと Visual Basic プロジェクトは、どちらもアセンブリを参照し、名前空間をインポートします。  
+  
+ <xref:System.Linq.ParallelEnumerable> には、LINQ to Objects がサポートするすべての標準クエリ演算子の実装が含まれていますが、各演算子の並列化は試行しません。  [!INCLUDE[vbteclinq](../../../includes/vbteclinq-md.md)] についての情報が必要な場合は、「[Introduction to LINQ](../../../ocs/visual-basic/programming-guide/language-features/linq/introduction-to-linq.md)」を参照してください。  
+  
+ <xref:System.Linq.ParallelEnumerable> クラスには、標準クエリ演算子に加え、並行実行固有の動作を可能にする一連のメソッドが含まれています。  次の表に、これらの PLINQ 固有のメソッドを示します。  
+  
+|ParallelEnumerable 演算子|説明|  
+|----------------------------|--------|  
+|<xref:System.Linq.ParallelEnumerable.AsParallel%2A>|PLINQ のエントリ ポイント。  可能な場合は、クエリの残りの部分は並列化されることを示します。|  
+|<xref:System.Linq.ParallelEnumerable.AsSequential%2A>|クエリの残りの部分は、並列ではない LINQ クエリとして順次実行されることを示します。|  
+|<xref:System.Linq.ParallelEnumerable.AsOrdered%2A>|PLINQ は、クエリの残り部分について、または orderby \(Visual Basic の場合は Order By\) 句を使用するなどして順序が変更されるまでは、ソース シーケンスの順序を保持する必要があることを示します。|  
+|<xref:System.Linq.ParallelEnumerable.AsUnordered%2A>|クエリの残りの部分の PLINQ では、ソース シーケンスの順序を保持する必要がないことを示します。|  
+|<xref:System.Linq.ParallelEnumerable.WithCancellation%2A>|PLINQ は、提示されたキャンセル トークンの状態を定期的に監視し、要求された場合は、実行を取り消す必要があることを示します。|  
+|<xref:System.Linq.ParallelEnumerable.WithDegreeOfParallelism%2A>|クエリを並列化するために PLINQ が使用する必要がある、プロセッサの最大数を示します。|  
+|<xref:System.Linq.ParallelEnumerable.WithMergeOptions%2A>|PLINQ が並列化の結果を consumer スレッドの単一のシーケンスに再マージできる場合は、その方法についてのヒントを示します。|  
+|<xref:System.Linq.ParallelEnumerable.WithExecutionMode%2A>|既定の動作が順次実行である場合でも、PLINQ がクエリを並列化する必要があるかどうかを指定します。|  
+|<xref:System.Linq.ParallelEnumerable.ForAll%2A>|マルチスレッドの列挙型メソッド。クエリの結果の反復処理とは異なり、先に consumer スレッドに再マージしなくても、結果を並列処理できます。|  
+|<xref:System.Linq.ParallelEnumerable.Aggregate%2A> オーバーロード|PLINQ 固有のオーバーロードで、スレッド ローカルのパーティション上で中間的な集約を行うと共に、すべてのパーティションの結果を結合する最終的なアグリゲーション関数も使用できます。|  
+  
+## オプトイン モデル  
+ クエリを記述するときに、次の例に示すようにデータ ソースの <xref:System.Linq.ParallelEnumerable.AsParallel%2A?displayProperty=fullName> 拡張メソッドを呼び出し、PLINQ を有効にします。  
+  
+ [!code-csharp[PLINQ#1](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinq2_cs.cs#1)]
+ [!code-vb[PLINQ#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#1)]  
+  
+ <xref:System.Linq.ParallelEnumerable.AsParallel%2A> 拡張メソッドは、それ以降のクエリ演算子 \(この場合は `where` および `select`\) を <xref:System.Linq.ParallelEnumerable?displayProperty=fullName> の実装にバインドします。  
+  
+## 実行モード  
+ 既定では、PLINQ は保守的です。  PLINQ インフラストラクチャは、実行時に、クエリの全体的な構造を分析します。  並列化によってクエリを高速化できることが見込まれる場合は、PLINQ は、同時実行できるタスクにソース シーケンスをパーティション分割します。  クエリの並列化が安全ではない場合は、PLINQ はクエリを順次実行します。  PLINQ で、負荷が高くなる可能性がある並列アルゴリズムと負荷が低い順次アルゴリズムを選ぶ必要がある場合は、既定では順次アルゴリズムが選択されます。  並列アルゴリズムを選択するよう PLINQ に指示するには、<xref:System.Linq.ParallelEnumerable.WithExecutionMode%2A> メソッドと <xref:System.Linq.ParallelExecutionMode?displayProperty=fullName> 列挙型を使用します。  これは、テストと測定の結果、特定のクエリで並列化の方が速く実行されることが判明している場合に便利です。  詳細については、「[How to: Specify the Execution Mode in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md)」を参照してください。  
+  
+## 並列化の次数  
+ 既定では、PLINQ はホスト コンピューター上のすべてのプロセッサを最大 64 個まで使用します。  <xref:System.Linq.ParallelEnumerable.WithDegreeOfParallelism%2A> メソッドを使用すると、指定されたプロセッサ数よりも多くのプロセッサを使用するよう、PLINQ に指示できます。  これは、コンピューター上で実行されるその他のプロセスが、一定の CPU 時間を確保できるようにする場合に便利です。  次のスニペットでは、クエリが最大で 2 つのプロセッサしか使用できないように制限します。  
+  
+ [!code-csharp[PLINQ#5](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#5)]
+ [!code-vb[PLINQ#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#5)]  
+  
+ クエリが、ファイル I\/O など計算主体ではない作業を大量に実行している場合は、マシンのコア数よりも大きい並列化の次数を指定することをお勧めします。  
+  
+## 順序ありの並列クエリと順序なしの並列クエリ  
+ 一部のクエリでは、クエリ演算子は、ソース シーケンスの順序を保持する結果を生成する必要があります。  そのために、PLINQ には <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 演算子が用意されています。  <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> は、<xref:System.Linq.ParallelEnumerable.AsSequential%2A> とは異なります。  <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> シーケンスは並列で処理されますが、その結果はバッファーに格納されて並べ替えられます。  通常、順序を保持するには追加の処理が必要となるため、<xref:System.Linq.ParallelEnumerable.AsOrdered%2A> シーケンスの処理は、既定の <xref:System.Linq.ParallelEnumerable.AsUnordered%2A> シーケンスよりも遅くなることがあります。  特定の順序ありの並列操作が、同じ操作の順次処理よりも高速であるかどうかは、さまざまな要因によって左右されます。  
+  
+ 次のコード例に、順序の維持を有効にする方法を示します。  
+  
+ [!code-csharp[PLINQ#3](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinq2_cs.cs#3)]
+ [!code-vb[PLINQ#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#3)]  
+  
+ 詳細については、「[Order Preservation in PLINQ](../../../docs/standard/parallel-programming/order-preservation-in-plinq.md)」を参照してください。  
+  
+## 並列クエリと順次クエリ  
+ 一部の操作では、ソース データを順次提供する必要があります。  <xref:System.Linq.ParallelEnumerable> クエリ演算子は、必要に応じて、順次モードに自動的に切り替わります。  ユーザー定義のクエリ演算子と、順次実行を必要とするユーザー デリゲート向けに、PLINQ では <xref:System.Linq.ParallelEnumerable.AsSequential%2A> メソッドを使用できます。  <xref:System.Linq.ParallelEnumerable.AsSequential%2A> を使用すると、それ以降のクエリの演算子は、<xref:System.Linq.ParallelEnumerable.AsParallel%2A> が再度呼び出されるまで順次実行されます。  詳細については、「[How to: Combine Parallel and Sequential LINQ Queries](../../../docs/standard/parallel-programming/how-to-combine-parallel-and-sequential-linq-queries.md)」を参照してください。  
+  
+## クエリ結果のマージのオプション  
+ PLINQ クエリが並列実行される場合、`foreach` ループ \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の場合は `For Each`\) による消費、またはリストや配列への挿入を行うことができるよう、各ワーカー スレッドからの結果をメイン スレッドに再マージする必要があります。  結果をより迅速に生成する場合など、特定のマージ操作を指定すると便利なこともあります。  そのために、PLINQ では <xref:System.Linq.ParallelEnumerable.WithMergeOptions%2A> メソッドと <xref:System.Linq.ParallelMergeOptions> 列挙型をサポートしています。  詳細については、「[Merge Options in PLINQ](../../../docs/standard/parallel-programming/merge-options-in-plinq.md)」を参照してください。  
+  
+## ForAll 演算子  
+ [!INCLUDE[vbteclinq](../../../includes/vbteclinq-md.md)] の順次クエリでは、`foreach` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の場合は `For Each`\) ループで列挙されるか、<xref:System.Linq.ParallelEnumerable.ToList%2A>、<xref:System.Linq.ParallelEnumerable.ToArray%2A>、<xref:System.Linq.ParallelEnumerable.ToDictionary%2A> などのメソッドを呼び出すまで、クエリの実行は延期されます。  PLINQ では、`foreach` を使用してクエリを実行し、結果を反復処理することもできます。  ただし、`foreach` 自体は並列実行されないので、ループが実行されるスレッドに、すべての並列タスクの出力を再マージする必要があります。  PLINQ では、クエリ結果の最終的な順序を維持する必要がある場合や、結果を順次的に処理している場合は \(たとえば、各要素に対して `Console.WriteLine` を呼び出している場合など\)、`foreach` を使用できます。  順序の維持が必要ない場合や、結果の処理自体を並列化できる場合にクエリ実行を高速化するには、<xref:System.Linq.ParallelEnumerable.ForAll%2A> メソッドで PLINQ クエリを実行します。  <xref:System.Linq.ParallelEnumerable.ForAll%2A> は、この最終的なマージ ステップを実行しません。  <xref:System.Linq.ParallelEnumerable.ForAll%2A> メソッドを使用するコード例を次に示します。  ここで <xref:System.Collections.Concurrent.ConcurrentBag%601?displayProperty=fullName> が使用されるのは、項目を削除せずに、同時に複数スレッドの追加を行うために最適化されるためです。  
+  
+ [!code-csharp[PLINQ#4](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinq2_cs.cs#4)]
+ [!code-vb[PLINQ#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#4)]  
+  
+ 次の図に、クエリ実行における `foreach` と <xref:System.Linq.ParallelEnumerable.ForAll%2A> の相違点を示します。  
+  
+ ![ForAll とForEach](../../../docs/standard/parallel-programming/media/vs-isvnt-allvseach.png "VS\_ISVNT\_ALLvsEACH")  
+  
+## キャンセル  
+ PLINQ は、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] のキャンセルの型に統合されています \(詳細については、「[Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)」を参照してください\)。そのため、順次的な LINQ to Objects クエリとは異なり、PLINQ クエリは取り消すことができます。  キャンセル可能な PLINQ クエリを作成するには、クエリで <xref:System.Linq.ParallelEnumerable.WithCancellation%2A> 演算子を使用し、引数として <xref:System.Threading.CancellationToken> インスタンスを指定します。  トークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティが true に設定されていると、PLINQ はそれに気付き、すべてのスレッドの処理を中止して <xref:System.OperationCanceledException> をスローします。  
+  
+ キャンセル トークンが設定された後も、PLINQ クエリが一部の要素の処理を継続する可能性があります。  
+  
+ 応答性を高めるため、長時間にわたるユーザー デリゲートのキャンセル要求に対応することもできます。  詳細については、「[How to: Cancel a PLINQ Query](../../../docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md)」を参照してください。  
+  
+## 例外  
+ PLINQ クエリが実行されると、異なるスレッドから複数の例外が同時にスローされることがあります。  また、例外を処理するコードが、例外をスローしたコードとは異なるスレッドにあることもあります。  PLINQ では <xref:System.AggregateException> 型を使用し、クエリによってスローされたすべての例外をカプセル化し、それらの例外を呼び出し元のスレッドにマーシャリングします。  呼び出し元のクエリでは、try\-catch ブロックが 1 つだけ必要です。  ただし、<xref:System.AggregateException> でカプセル化されたすべての例外を反復処理し、安全に回復できる例外をキャッチできます。  まれに、<xref:System.AggregateException> にラップされていない例外がスローされ、<xref:System.Threading.ThreadAbortException> もラップされていないことがあります。  
+  
+ 連結しているスレッドへ例外が上方向へ通知されると、例外が発生した後も、クエリによって一部の項目の処理が続行される可能性があります。  
+  
+ 詳細については、「[How to: Handle Exceptions in a PLINQ Query](../../../docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md)」を参照してください。  
+  
+## カスタム パーティショナー  
+ ソース データの特性を活用するカスタム パーティショナーを記述することによって、クエリのパフォーマンスを向上できる場合があります。  クエリでは、カスタム パーティショナー自体は、クエリの対象となる列挙可能なオブジェクトです。  
+  
+ [!code-csharp[PLINQ#2](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinq2_cs.cs#2)]
+ [!code-vb[PLINQ#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq3.vb#2)]  
+  
+ PLINQ は、固定数のパーティションをサポートしています \(ただし、負荷分散の目的で、これらのパーティションに対してデータが実行時に動的に再割り当てされることもあります\)。  <xref:System.Threading.Tasks.Parallel.For%2A> および <xref:System.Threading.Tasks.Parallel.ForEach%2A> は動的なパーティション分割しかサポートしていないので、パーティションの数は実行時に変化します。  詳細については、「[Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)」を参照してください。  
+  
+## PLINQ のパフォーマンスの測定  
+ クエリは、多くの場合並列化できますが、並列クエリの設定に伴うオーバーヘッドは、並列化によって得られるパフォーマンスの利点よりも大きくなります。  クエリが大量の計算を実行しない場合、またはデータ ソースが小さい場合、PLINQ クエリは、順次的な LINQ to Objects クエリよりも低速になります。  Visual Studio Team Server の Parallel Performance Analyzer を使用し、さまざまなクエリのパフォーマンスの比較、処理のボトルネックの場所の特定、クエリが並行処理されているか順次処理されているかの確認を行うことができます。  詳細については、「[同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md)」および「[How to: Measure PLINQ Query Performance](../../../docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md)」を参照してください。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)   
+ [Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md b/docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md
new file mode 100644
index 00000000000..01aeacc9784
--- /dev/null
+++ b/docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md
@@ -0,0 +1,41 @@
+---
+title: "Lambda Expressions in PLINQ and TPL | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Func delegate, creating with lambda expression"
+  - "Action delegate, creating with lambda expression"
+  - "lambda expressions, with Action and Func"
+ms.assetid: 645b2c17-29d0-4ffa-8684-430743cc2f2d
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Lambda Expressions in PLINQ and TPL
+タスク並列ライブラリ \(TPL: Task Parallel Library\) には、デリゲートの <xref:System.Func%601?displayProperty=fullName> 系または <xref:System.Action?displayProperty=fullName> 系を入力パラメーターとして取得する多くのメソッドが用意されています。  これらのデリゲートを使用して、カスタムのプログラム ロジックを並列ループ、タスク、またはクエリに渡します。  PLINQ と同様に、TPL のコード例では、ラムダ式を使用してこれらのデリゲートのインスタンスをインライン コード ブロックとして作成しています。  ここでは、Func および Action について簡単に紹介し、タスク並列ライブラリと PLINQ のラムダ式を使用する方法について説明します。  
+  
+ **メモ** 一般的なデリゲートの詳細については、「[デリゲート](../Topic/Delegates%20\(C%23%20Programming%20Guide\).md)」および「[Delegates](../Topic/Delegates%20\(Visual%20Basic\).md)」を参照してください。  C\# および [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] におけるラムダ式の詳細については、「[ラムダ式](../Topic/Lambda%20Expressions%20\(C%23%20Programming%20Guide\).md)」および「[Lambda Expressions](../Topic/Lambda%20Expressions%20\(Visual%20Basic\).md)」を参照してください。  
+  
+## Func デリゲート  
+ `Func` デリゲートは、値を返すメソッドをカプセル化します。  Func シグネチャでは、常に最後または右端の型パラメーターで戻り値の型が指定されます。  コンパイラ エラーの一般的な原因の 1 つは、<xref:System.Func%602?displayProperty=fullName> に 2 つの入力パラメーターを渡そうとすることです。実際には、この型が受け取る入力パラメーターは 1 つだけです。  Framework クラス ライブラリでは、<xref:System.Func%601?displayProperty=fullName>、<xref:System.Func%602?displayProperty=fullName>、<xref:System.Func%603?displayProperty=fullName> などから <xref:System.Func%6017?displayProperty=fullName> まで、17 の `Func` のバージョンが定義されています。  
+  
+## Action デリゲート  
+ <xref:System.Action?displayProperty=fullName> デリゲートは、値を返さないメソッド \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の Sub\) または [void](../Topic/void%20\(C%23%20Reference\).md) を返すメソッドをカプセル化します。  Action の型シグネチャでは、型パラメーターは入力パラメーターのみを表します。  Func と同様、Framework クラス ライブラリでは 17 バージョンの Action が定義されています。この中には型パラメーターを持たないものから、16 の型パラメーターを持つものまであります。  
+  
+## 例  
+ <xref:System.Threading.Tasks.Parallel.ForEach%60%602%28System.Collections.Generic.IEnumerable%7B%60%600%7D%2CSystem.Func%7B%60%601%7D%2CSystem.Func%7B%60%600%2CSystem.Threading.Tasks.ParallelLoopState%2C%60%601%2C%60%601%7D%2CSystem.Action%7B%60%601%7D%29?displayProperty=fullName> メソッドの次の例は、ラムダ式を使用して Func デリゲートと Action デリゲートの両方を表現する方法を示しています。  
+  
+ [!code-csharp[System.Threading.Tasks.Parallel#02](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.threading.tasks.parallel/cs/parallelforeach.cs#02)]
+ [!code-vb[System.Threading.Tasks.Parallel#02](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.threading.tasks.parallel/vb/parallelforeach.vb#02)]  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/media/dataflowwinforms.png b/docs/standard/parallel-programming/media/dataflowwinforms.png
new file mode 100644
index 00000000000..b0fe3b061a2
Binary files /dev/null and b/docs/standard/parallel-programming/media/dataflowwinforms.png differ
diff --git a/docs/standard/parallel-programming/media/tpl-architecture.png b/docs/standard/parallel-programming/media/tpl-architecture.png
new file mode 100644
index 00000000000..e343ff74362
Binary files /dev/null and b/docs/standard/parallel-programming/media/tpl-architecture.png differ
diff --git a/docs/standard/parallel-programming/media/tpldataflow-cancellation.png b/docs/standard/parallel-programming/media/tpldataflow-cancellation.png
new file mode 100644
index 00000000000..8101b852e27
Binary files /dev/null and b/docs/standard/parallel-programming/media/tpldataflow-cancellation.png differ
diff --git a/docs/standard/parallel-programming/media/tpldataflow-compositeimages.gif b/docs/standard/parallel-programming/media/tpldataflow-compositeimages.gif
new file mode 100644
index 00000000000..ea1add9617e
Binary files /dev/null and b/docs/standard/parallel-programming/media/tpldataflow-compositeimages.gif differ
diff --git a/docs/standard/parallel-programming/media/vs-isvnt-allvseach.png b/docs/standard/parallel-programming/media/vs-isvnt-allvseach.png
new file mode 100644
index 00000000000..be559316b2d
Binary files /dev/null and b/docs/standard/parallel-programming/media/vs-isvnt-allvseach.png differ
diff --git a/docs/standard/parallel-programming/merge-options-in-plinq.md b/docs/standard/parallel-programming/merge-options-in-plinq.md
new file mode 100644
index 00000000000..acd31f14a72
--- /dev/null
+++ b/docs/standard/parallel-programming/merge-options-in-plinq.md
@@ -0,0 +1,71 @@
+---
+title: "Merge Options in PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, merge options"
+ms.assetid: e8f7be3b-88de-4f33-ab14-dc008e76c1ba
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# Merge Options in PLINQ
+クエリが並列実行される場合、PLINQ は、複数のスレッドが別の部分 \(通常は別のスレッド\) で同時に動作できるよう、ソース シーケンスをパーティション分割します。  結果が、`foreach` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の `For Each`\) ループなど、1 つのスレッドで消費される場合は、すべてのスレッドからの結果を 1 つのシーケンスに再度マージする必要があります。  PLINQ によって実行されるマージの種類は、クエリに存在する演算子に依存します。  たとえば、結果に対して新しい順序を課す演算子は、すべてのスレッドからのすべての要素をバッファーに格納する必要があります。  \(アプリケーション ユーザーの観点でもある\) consumer スレッドの観点からは、完全にバッファーに格納されたクエリは、最初の結果を生成するまでに長時間にわたって実行される可能性があります。  他の演算子は、既定では部分的にバッファーに格納され、結果はバッチで生成されます。  <xref:System.Linq.ParallelEnumerable.ForAll%2A> という演算子は、既定ではバッファーに格納されません。  すべてのスレッドからの全要素を直ちに生成します。  
+  
+ 次の例に示すように、<xref:System.Linq.ParallelEnumerable.WithMergeOptions%2A> メソッドを使用して、実行するマージの種類を示すヒントを PLINQ に提供できます。  
+  
+ [!code-csharp[PLINQ#26](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#26)]
+ [!code-vb[PLINQ#26](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#26)]  
+  
+ コード例全体については、「[How to: Specify Merge Options in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md)」を参照してください。  
+  
+ 特定のクエリが要求されたオプションをサポートできない場合は、そのオプションは無視されます。  ほとんどの場合は、PLINQ クエリに対してマージ オプションを指定する必要はありません。  ただし、場合によっては、テストと測定によって、既定以外のモードで最も効率よくクエリが実行されることが判明することもあります。  このオプションの一般的な用途は、チャンク マージ演算子を強制的に処理してその結果をストリーミングし、より応答性の高いユーザー インターフェイスを提供することです。  
+  
+## ParallelMergeOptions  
+ <xref:System.Linq.ParallelMergeOptions> 列挙型には、サポートされるクエリの形態について、1 つのスレッドで結果が消費されたときにクエリの最終的な出力がどのように生成されるかを指定する、次のオプションが含まれます。  
+  
+-   `Not Buffered`  
+  
+     <xref:System.Linq.ParallelMergeOptions> オプションを使用すると、処理された各要素が生成されると同時に各スレッドから返されます。  この動作は出力の "ストリーミング" と同じです。  クエリに <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 演算子がある場合、`NotBuffered` はソース要素の順番を保持します。  `NotBuffered` は、結果が使用可能になると同時に結果の生成を開始しますが、すべての結果が生成されるまでの合計時間は、他のマージ操作にかかる合計時間よりも長くなることがあります。  
+  
+-   `Auto Buffered`  
+  
+     <xref:System.Linq.ParallelMergeOptions> オプションを使用すると、要素を収集してバッファーに格納し、その後定期的に consumer スレッドにバッファーの内容を一度に生成します。  これは、`NotBuffered` の "ストリーミング" 動作を使用する代わりに、ソース データを "チャンク" として生成するのと同じです。  `AutoBuffered` では、consumer スレッドで最初の要素を使用できるようになるまで、`NotBuffered` よりも長い時間がかかることがあります。  バッファーのサイズと正確な生成動作を構成できないため、クエリに関連するさまざまな要因に左右されることがあります。  
+  
+-   `FullyBuffered`  
+  
+     <xref:System.Linq.ParallelMergeOptions> オプションを使用すると、要素が生成される前に、クエリ全体の出力がバッファーに格納されます。  このオプションを使用すると、consumer スレッドで最初の要素が使用できるようになるまで時間がかかることがありますが、完全な結果は、他のオプションを使用するよりも短時間で生成されます。  
+  
+## マージ オプションをサポートするクエリ演算子  
+ 次の表に、すべてのマージ オプションをサポートする演算子を示します。ただし、ここに示す制約があります。  
+  
+|演算子|制約|  
+|---------|--------|  
+|<xref:System.Linq.ParallelEnumerable.AsEnumerable%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Cast%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Concat%2A>|配列ソースまたはリスト ソースしか持たない、順序なしのクエリ|  
+|<xref:System.Linq.ParallelEnumerable.DefaultIfEmpty%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.OfType%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Reverse%2A>|配列ソースまたはリスト ソースしか持たない、順序なしのクエリ|  
+|<xref:System.Linq.ParallelEnumerable.Select%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.SelectMany%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Skip%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Take%2A>|なし。|  
+|<xref:System.Linq.ParallelEnumerable.Where%2A>|なし。|  
+  
+ その他すべての PLINQ クエリ演算子は、ユーザー指定のマージ オプションを無視することがあります。  <xref:System.Linq.ParallelEnumerable.Reverse%2A> や <xref:System.Linq.ParallelEnumerable.OrderBy%2A> のようなクエリ演算子は、すべての要素が生成され、並べ替えられるまでは、どの要素も生成できません。  したがって、<xref:System.Linq.ParallelEnumerable.Reverse%2A> などの演算子も含むクエリで <xref:System.Linq.ParallelMergeOptions> が使用される場合、マージ動作は、その演算子が結果を生成するまで、クエリには適用されません。  
+  
+ マージ オプションを処理する一部の演算子の機能は、ソース シーケンスの種類と、クエリの前半で <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 演算子が使用されたかどうかによって異なります。  <xref:System.Linq.ParallelEnumerable.ForAll%2A> は常に <xref:System.Linq.ParallelMergeOptions> であり、要素を即座に生成します。  <xref:System.Linq.ParallelEnumerable.OrderBy%2A> は常に <xref:System.Linq.ParallelMergeOptions> です。したがって、要素を生成する前にリスト全体を並べ替える必要があります。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)   
+ [How to: Specify Merge Options in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/order-preservation-in-plinq.md b/docs/standard/parallel-programming/order-preservation-in-plinq.md
new file mode 100644
index 00000000000..609a0b2dba9
--- /dev/null
+++ b/docs/standard/parallel-programming/order-preservation-in-plinq.md
@@ -0,0 +1,128 @@
+---
+title: "Order Preservation in PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, order preservation"
+ms.assetid: 10d202bc-19e1-4b5c-bbf1-9a977322a9ca
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Order Preservation in PLINQ
+PLINQ では、正確性を維持しながらパフォーマンスを最大にすることが重要です。  クエリをできるだけ速く実行する一方で、正確な結果を生成する必要があります。  正確性のために、ソース シーケンスの順序の維持が必要な場合がありますが、順序付けには負荷がかかります。  したがって、既定では、PLINQ はソース シーケンスの順序を維持しません。  この点で、PLINQ は [!INCLUDE[vbtecdlinq](../../../includes/vbtecdlinq-md.md)] と似ていますが、順序を維持する LINQ to Objects とは異なります。  
+  
+ 既定の動作をオーバーライドするには、ソース シーケンス上で <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 演算子を使用して、順序の維持を有効にします。  その後、<xref:System.Linq.ParallelEnumerable.AsUnordered%2A> メソッドを使用して、クエリでの順序の維持を無効にできます。  どちらの方法でも、クエリを並列実行するか順次実行するかを決定するヒューリスティックに基づいてクエリが処理されます。  詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+ 次の例では、結果を順序付けず、条件に一致するすべての要素をフィルター処理する、順序なしの並列クエリを示しています。  
+  
+ [!code-csharp[PLINQ#8](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#8)]
+ [!code-vb[PLINQ#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#8)]  
+  
+ このクエリでは、ソース シーケンスで条件を満たす最初の 1000 都市が生成されるとは限らず、条件を満たす一連の 1000 都市が生成されます。  PLINQ クエリ演算子は、同時実行タスクとして処理される複数のサブシーケンスにソース シーケンスをパーティション分割します。  順序の維持が指定されていない場合、パーティションごとの結果はクエリの次のステージに任意の順序で渡されます。  また、パーティションでは、残りの要素の処理が続行される前に、結果のサブセットが生成される場合があります。  結果の順序は毎回異なることがあります。  この動作は、オペレーティング システムによるスレッドのスケジュール方法に依存するため、アプリケーションでは制御できません。  
+  
+ 次の例では、ソース シーケンス上で <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> 演算子を使用して、既定の動作をオーバーライドしています。  この例では <xref:System.Linq.ParallelEnumerable.Take%2A> メソッドにより、ソース シーケンスで条件を満たす最初の 1000 都市が返されます。  
+  
+ [!code-csharp[PLINQ#9](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#9)]
+ [!code-vb[PLINQ#9](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#9)]  
+  
+ ただし、このクエリは順序なしのクエリと同じ速度では実行されません。パーティション全体とマージ時刻で元の順序を追跡し、順序が一貫していることを確認する必要があるためです。  したがって、<xref:System.Linq.ParallelEnumerable.AsOrdered%2A> は、必要な場合にのみ、クエリの該当部分に限って使用することをお勧めします。  順序を維持する必要がなくなったら、<xref:System.Linq.ParallelEnumerable.AsUnordered%2A> を使用して無効にします。  2 つのクエリを組み合わせてこの処理を行う例を次に示します。  
+  
+ [!code-csharp[PLINQ#6](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#6)]
+ [!code-vb[PLINQ#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#6)]  
+  
+ PLINQ は、残りのクエリに対し、順序を強制する演算子によって生成されるシーケンスの順序を維持することに注意してください。  つまり、<xref:System.Linq.ParallelEnumerable.OrderBy%2A> や <xref:System.Linq.ParallelEnumerable.ThenBy%2A> の演算子に続いて <xref:System.Linq.ParallelEnumerable.AsOrdered%2A> が呼び出されるのと同じように処理されます。  
+  
+## クエリ演算子と順序付け  
+ 次のクエリ演算子は、クエリ内のすべての後続演算子で順序を維持するか、または <xref:System.Linq.ParallelEnumerable.AsUnordered%2A> が呼び出されるまで順序を維持します。  
+  
+-   <xref:System.Linq.ParallelEnumerable.OrderBy%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.OrderByDescending%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.ThenBy%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.ThenByDescending%2A>  
+  
+ 次の PLINQ クエリ演算子では、正確な結果を生成するために順序ありのソース シーケンスが必要となる場合があります。  
+  
+-   <xref:System.Linq.ParallelEnumerable.Reverse%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.SequenceEqual%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.TakeWhile%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.SkipWhile%2A>  
+  
+-   <xref:System.Linq.ParallelEnumerable.Zip%2A>  
+  
+ PLINQ クエリ演算子の中には、ソース シーケンスが順序ありか順序なしかによって動作が異なるものがあります。  次の表に、これらの演算子の一覧を示します。  
+  
+|演算子|ソース シーケンスが順序ありの場合の結果|ソース シーケンスが順序なしの場合の結果|  
+|---------|--------------------------|--------------------------|  
+|<xref:System.Linq.ParallelEnumerable.Aggregate%2A>|非結合演算子または非可換演算子の場合は非確定の出力|非結合演算子または非可換演算子の場合は非確定の出力|  
+|<xref:System.Linq.ParallelEnumerable.All%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Any%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.AsEnumerable%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Average%2A>|非結合演算子または非可換演算子の場合は非確定の出力|非結合演算子または非可換演算子の場合は非確定の出力|  
+|<xref:System.Linq.ParallelEnumerable.Cast%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Concat%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Count%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.DefaultIfEmpty%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Distinct%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.ElementAt%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.ElementAtOrDefault%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.Except%2A>|順序なしの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.First%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.FirstOrDefault%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.ForAll%2A>|非確定的に並列実行|非確定的に並列実行|  
+|<xref:System.Linq.ParallelEnumerable.GroupBy%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.GroupJoin%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Intersect%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Join%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Last%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.LastOrDefault%2A>|指定された要素を返す|任意の要素|  
+|<xref:System.Linq.ParallelEnumerable.LongCount%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Min%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.OrderBy%2A>|シーケンスを並べ替え|新規に順序付けられたセクションを開始|  
+|<xref:System.Linq.ParallelEnumerable.OrderByDescending%2A>|シーケンスを並べ替え|新規に順序付けられたセクションを開始|  
+|<xref:System.Linq.ParallelEnumerable.Range%2A>|該当なし \(<xref:System.Linq.ParallelEnumerable.AsParallel%2A> の既定と同じ\)|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Repeat%2A>|該当なし \(<xref:System.Linq.ParallelEnumerable.AsParallel%2A> の既定と同じ\)|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Reverse%2A>|逆方向|処理を行わない|  
+|<xref:System.Linq.ParallelEnumerable.Select%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Select%2A> \(インデックス付き\)|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.SelectMany%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.SelectMany%2A> \(インデックス付き\)|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.SequenceEqual%2A>|順序ありの比較|順序なしの比較|  
+|<xref:System.Linq.ParallelEnumerable.Single%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.SingleOrDefault%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.Skip%2A>|最初の *n* 要素をスキップ|すべての *n* 要素をスキップ|  
+|<xref:System.Linq.ParallelEnumerable.SkipWhile%2A>|順序ありの結果|非確定。  現在の任意の順序で SkipWhile を実行|  
+|<xref:System.Linq.ParallelEnumerable.Sum%2A>|非結合演算子または非可換演算子の場合は非確定の出力|非結合演算子または非可換演算子の場合は非確定の出力|  
+|<xref:System.Linq.ParallelEnumerable.Take%2A>|最初の `n` 要素を取得|`n` 要素を取得|  
+|<xref:System.Linq.ParallelEnumerable.TakeWhile%2A>|順序ありの結果|非確定。  現在の任意の順序で TakeWhile を実行|  
+|<xref:System.Linq.ParallelEnumerable.ThenBy%2A>|`OrderBy` を補足|`OrderBy` を補足|  
+|<xref:System.Linq.ParallelEnumerable.ThenByDescending%2A>|`OrderBy` を補足|`OrderBy` を補足|  
+|<xref:System.Linq.ParallelEnumerable.ToArray%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.ToDictionary%2A>|該当なし|該当なし|  
+|<xref:System.Linq.ParallelEnumerable.ToList%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.ToLookup%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Union%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Where%2A>|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Where%2A> \(インデックス付き\)|順序ありの結果|順序なしの結果|  
+|<xref:System.Linq.ParallelEnumerable.Zip%2A>|順序ありの結果|順序なしの結果|  
+  
+ 順序なしの結果はアクティブにシャッフルされるわけではありません。適用される特別な順序ロジックがないだけです。  順序なしのクエリでソース シーケンスの順序が保持される場合もあります。  インデックス付きの Select 演算子を使用するクエリの場合、PLINQ ではインデックスが増加する順に出力要素が出力されることは保証しますが、どのインデックスがどの要素に割り当てられるかについては一切保証しません。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/parallel-diagnostic-tools.md b/docs/standard/parallel-programming/parallel-diagnostic-tools.md
new file mode 100644
index 00000000000..2c70abc6f08
--- /dev/null
+++ b/docs/standard/parallel-programming/parallel-diagnostic-tools.md
@@ -0,0 +1,37 @@
+---
+title: "Parallel Diagnostic Tools | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel programming, debugging and profiling tools"
+ms.assetid: 38f7302a-ddf6-4179-ba19-f49e00395b9f
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Parallel Diagnostic Tools
+[!INCLUDE[vs_dev10_ext](../../../includes/vs-dev10-ext-md.md)] には、マルチスレッド アプリケーションのデバッグとプロファイリングを行うための広範なサポートが用意されています。  
+  
+## デバッグ  
+ Visual Studio デバッガーは、並列アプリケーションをデバッグするための新しいウィンドウを追加します。  詳細については、次のトピックを参照してください。  
+  
+-   [\[並列スタック\] ウィンドウの使用](../Topic/Using%20the%20Parallel%20Stacks%20Window.md)  
+  
+-   [\[タスク\] ウィンドウの使用](../Topic/Using%20the%20Tasks%20Window.md)  
+  
+-   [チュートリアル: 並行アプリケーションのデバッグ](../Topic/Walkthrough:%20Debugging%20a%20Parallel%20Application.md).  
+  
+## プロファイル  
+ 同時実行ビジュアライザー レポート ビューを使用すると、並列プログラムのスレッドが相互にやり取りする方法、およびシステム上の他のプロセスのスレッドとやり取りする方法を視覚化できます。  詳細については、「[同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md)」を参照してください。  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/parallel-linq-plinq.md b/docs/standard/parallel-programming/parallel-linq-plinq.md
new file mode 100644
index 00000000000..6cb630575ee
--- /dev/null
+++ b/docs/standard/parallel-programming/parallel-linq-plinq.md
@@ -0,0 +1,60 @@
+---
+title: "Parallel LINQ (PLINQ) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ, overview"
+ms.assetid: 3d4d0cd3-bde4-490b-99e7-f4e41be96455
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Parallel LINQ (PLINQ)
+Parallel LINQ \(PLINQ\) は、LINQ to Objects の並列実装です。  PLINQ では LINQ 標準クエリ演算子の完全なセットを T:System.Linq 名前空間の拡張メソッドとして実装します。また、並列操作用の追加の演算子も備えています。  PLINQ では並列プログラミングの機能が強化され、LINQ 構文が簡略化され読みやすくなっています。  タスク並列ライブラリを対象としたコードと同様に、PLINQ クエリでは、ホスト コンピューターの性能に基づいて同時実行の程度が調整されます。  
+  
+ 多くの場合、PLINQ により、ホスト コンピューター上で使用できるコアをより効率的に使用することで、LINQ to Objects クエリの処理速度が大幅に向上します。  このようにパフォーマンスが向上することで、デスクトップ上の演算性能が高まります。  
+  
+## このセクションの内容  
+ [Introduction to PLINQ](../../../docs/standard/parallel-programming/introduction-to-plinq.md)  
+  
+ [Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)  
+  
+ [Order Preservation in PLINQ](../../../docs/standard/parallel-programming/order-preservation-in-plinq.md)  
+  
+ [Merge Options in PLINQ](../../../docs/standard/parallel-programming/merge-options-in-plinq.md)  
+  
+ [How to: Create and Execute a Simple PLINQ Query](../../../docs/standard/parallel-programming/how-to-create-and-execute-a-simple-plinq-query.md)  
+  
+ [How to: Control Ordering in a PLINQ Query](../../../docs/standard/parallel-programming/how-to-control-ordering-in-a-plinq-query.md)  
+  
+ [How to: Combine Parallel and Sequential LINQ Queries](../../../docs/standard/parallel-programming/how-to-combine-parallel-and-sequential-linq-queries.md)  
+  
+ [How to: Handle Exceptions in a PLINQ Query](../../../docs/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query.md)  
+  
+ [How to: Cancel a PLINQ Query](../../../docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md)  
+  
+ [How to: Write a Custom PLINQ Aggregate Function](../../../docs/standard/parallel-programming/how-to-write-a-custom-plinq-aggregate-function.md)  
+  
+ [How to: Specify the Execution Mode in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md)  
+  
+ [How to: Specify Merge Options in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-merge-options-in-plinq.md)  
+  
+ [How to: Iterate File Directories with PLINQ](../../../docs/standard/parallel-programming/how-to-iterate-file-directories-with-plinq.md)  
+  
+ [How to: Measure PLINQ Query Performance](../../../docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md)  
+  
+ [PLINQ Data Sample](../../../docs/standard/parallel-programming/plinq-data-sample.md)  
+  
+## 参照  
+ <xref:System.Linq.ParallelEnumerable>   
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [LINQ \(Language\-Integrated Query\)](../Topic/LINQ%20\(Language-Integrated%20Query\).md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/plinq-data-sample.md b/docs/standard/parallel-programming/plinq-data-sample.md
new file mode 100644
index 00000000000..a7a872a68e0
--- /dev/null
+++ b/docs/standard/parallel-programming/plinq-data-sample.md
@@ -0,0 +1,868 @@
+---
+title: "PLINQ Data Sample | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, sample data"
+ms.assetid: 4fccbb35-eaa5-44e9-a252-a5c3d4bc7604
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# PLINQ Data Sample
+このサンプルには、.csv 形式のデータ例、および Customers、Products、Orders および Order Details のメモリ内コレクションに変換するメソッドが含まれています。  PLINQ をさらに試す場合は、その他のトピックのコード例をこのトピックのコードに貼り付けて、`Main` メソッドからこれを呼び出すことができます。  また、独自の PLINQ クエリでこのデータを使用することもできます。  
+  
+ このデータは、Northwind データベースのサブセットを表します。  50 の顧客レコードが含まれていますが、すべてのフィールドを網羅しているわけではありません。  Orders の行のサブセットおよび Customer ごとに対応する Order\_Detail データが含まれています。  すべての製品が含まれます。  
+  
+> [!NOTE]
+>  データセットの大きさは、基本の `where` 句および `select` 句だけを含むクエリに対して PLINQ が LINQ to Objects より速いことを示すには十分ではありません。  このような小さいデータセットで速度が向上するのを確認するには、データセット内の各要素で負荷の大きい操作を含むクエリを使用します。  
+  
+### このサンプルをセットアップするには  
+  
+1.  Visual Basic または Visual C\# のコンソール アプリケーション プロジェクトを作成します。  
+  
+2.  Module1.vb または Program.cs のコンテンツを、次の手順に従ったコードを使用して置き換えます。  
+  
+3.  **\[プロジェクト\]** メニューの **\[新しい項目の追加\]** をクリックします。  **\[テキスト ファイル\]** をクリックし、**\[OK\]** をクリックします。  このトピック内のデータをコピーし、新しいテキスト ファイルに貼り付けます。  **\[ファイル\]** メニューの **\[上書き保存\]** をクリックして、ファイル名に「Plinqdata.csv」と入力し、ソース コード ファイルが格納されているフォルダーに保存します。  
+  
+4.  F5 キーを押して、プロジェクトが正常にビルドされ、実行されることを検証します。  次の出力がコンソール ウィンドウに表示されます。  
+  
+    ```  
+    Customer count: 50  
+    Product count: 77  
+    Order count: 190  
+    Order Details count: 483  
+    Press any key to exit.  
+    ```  
+  
+ [!code-csharp[PLINQ#50](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#50)]
+ [!code-vb[PLINQ#50](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinqsnippets1.vb#50)]  
+  
+## Data  
+  
+```  
+CUSTOMERS  
+ALFKI,Alfreds Futterkiste,Obere Str. 57,Berlin,12209  
+ANATR,Ana Trujillo Emparedados y helados,Avda. de la Constitución 2222,México D.F.,05021  
+ANTON,Antonio Moreno Taquería,Mataderos  2312,México D.F.,05023  
+AROUT,Around the Horn,120 Hanover Sq.,London,WA1 1DP  
+BERGS,Berglunds snabbköp,Berguvsvägen  8,Luleå,S-958 22  
+BLAUS,Blauer See Delikatessen,Forsterstr. 57,Mannheim,68306  
+BLONP,Blondesddsl père et fils,24, place Kléber,Strasbourg,67000  
+BOLID,Bólido Comidas preparadas,C/ Araquil, 67,Madrid,28023  
+BONAP,Bon app',12, rue des Bouchers,Marseille,13008  
+BOTTM,Bottom-Dollar Markets,23 Tsawassen Blvd.,Tsawassen,T2F 8M4  
+BSBEV,B's Beverages,Fauntleroy Circus,London,EC2 5NT  
+CACTU,Cactus Comidas para llevar,Cerrito 333,Buenos Aires,1010  
+CENTC,Centro comercial Moctezuma,Sierras de Granada 9993,México D.F.,05022  
+CHOPS,Chop-suey Chinese,Hauptstr. 29,Bern,3012  
+COMMI,Comércio Mineiro,Av. dos Lusíadas, 23,Sao Paulo,05432-043  
+CONSH,Consolidated Holdings,Berkeley Gardens 12  Brewery,London,WX1 6LT  
+DRACD,Drachenblut Delikatessen,Walserweg 21,Aachen,52066  
+DUMON,Du monde entier,67, rue des Cinquante Otages,Nantes,44000  
+EASTC,Eastern Connection,35 King George,London,WX3 6FW  
+ERNSH,Ernst Handel,Kirchgasse 6,Graz,8010  
+FAMIA,Familia Arquibaldo,Rua Orós, 92,Sao Paulo,05442-030  
+FISSA,FISSA Fabrica Inter. Salchichas S.A.,C/ Moralzarzal, 86,Madrid,28034  
+FOLIG,Folies gourmandes,184, chaussée de Tournai,Lille,59000  
+FOLKO,Folk och fä HB,Åkergatan 24,Bräcke,S-844 67  
+FRANK,Frankenversand,Berliner Platz 43,München,80805  
+FRANR,France restauration,54, rue Royale,Nantes,44000  
+FRANS,Franchi S.p.A.,Via Monte Bianco 34,Torino,10100  
+FURIB,Furia Bacalhau e Frutos do Mar,Jardim das rosas n. 32,Lisboa,1675  
+GALED,Galería del gastrónomo,Rambla de Cataluña, 23,Barcelona,08022  
+GODOS,Godos Cocina Típica,C/ Romero, 33,Sevilla,41101  
+GOURL,Gourmet Lanchonetes,Av. Brasil, 442,Campinas,04876-786  
+GREAL,Great Lakes Food Market,2732 Baker Blvd.,Eugene,97403  
+GROSR,GROSELLA-Restaurante,5ª Ave. Los Palos Grandes,Caracas,1081  
+HANAR,Hanari Carnes,Rua do Paço, 67,Rio de Janeiro,05454-876  
+HILAA,HILARION-Abastos,Carrera 22 con Ave. Carlos Soublette #8-35,San Cristóbal,5022  
+HUNGC,Hungry Coyote Import Store,City Center Plaza 516 Main St.,Elgin,97827  
+HUNGO,Hungry Owl All-Night Grocers,8 Johnstown Road,Cork,  
+ISLAT,Island Trading,Garden House Crowther Way,Cowes,PO31 7PJ  
+KOENE,Königlich Essen,Maubelstr. 90,Brandenburg,14776  
+LACOR,La corne d'abondance,67, avenue de l'Europe,Versailles,78000  
+LAMAI,La maison d'Asie,1 rue Alsace-Lorraine,Toulouse,31000  
+LAUGB,Laughing Bacchus Wine Cellars,1900 Oak St.,Vancouver,V3F 2K1  
+LAZYK,Lazy K Kountry Store,12 Orchestra Terrace,Walla Walla,99362  
+LEHMS,Lehmanns Marktstand,Magazinweg 7,Frankfurt a.M.,60528  
+LETSS,Let's Stop N Shop,87 Polk St. Suite 5,San Francisco,94117  
+LILAS,LILA-Supermercado,Carrera 52 con Ave. Bolívar #65-98 Llano Largo,Barquisimeto,3508  
+LINOD,LINO-Delicateses,Ave. 5 de Mayo Porlamar,I. de Margarita,4980  
+LONEP,Lonesome Pine Restaurant,89 Chiaroscuro Rd.,Portland,97219  
+MAGAA,Magazzini Alimentari Riuniti,Via Ludovico il Moro 22,Bergamo,24100  
+MAISD,Maison Dewey,Rue Joseph-Bens 532,Bruxelles,B-1180  
+END CUSTOMERS  
+  
+ORDERS  
+10250,HANAR,7/8/1996 12:00:00 AM,7/12/1996 12:00:00 AM  
+10253,HANAR,7/10/1996 12:00:00 AM,7/16/1996 12:00:00 AM  
+10254,CHOPS,7/11/1996 12:00:00 AM,7/23/1996 12:00:00 AM  
+10257,HILAA,7/16/1996 12:00:00 AM,7/22/1996 12:00:00 AM  
+10258,ERNSH,7/17/1996 12:00:00 AM,7/23/1996 12:00:00 AM  
+10263,ERNSH,7/23/1996 12:00:00 AM,7/31/1996 12:00:00 AM  
+10264,FOLKO,7/24/1996 12:00:00 AM,8/23/1996 12:00:00 AM  
+10265,BLONP,7/25/1996 12:00:00 AM,8/12/1996 12:00:00 AM  
+10267,FRANK,7/29/1996 12:00:00 AM,8/6/1996 12:00:00 AM  
+10275,MAGAA,8/7/1996 12:00:00 AM,8/9/1996 12:00:00 AM  
+10278,BERGS,8/12/1996 12:00:00 AM,8/16/1996 12:00:00 AM  
+10279,LEHMS,8/13/1996 12:00:00 AM,8/16/1996 12:00:00 AM  
+10280,BERGS,8/14/1996 12:00:00 AM,9/12/1996 12:00:00 AM  
+10283,LILAS,8/16/1996 12:00:00 AM,8/23/1996 12:00:00 AM  
+10284,LEHMS,8/19/1996 12:00:00 AM,8/27/1996 12:00:00 AM  
+10289,BSBEV,8/26/1996 12:00:00 AM,8/28/1996 12:00:00 AM  
+10290,COMMI,8/27/1996 12:00:00 AM,9/3/1996 12:00:00 AM  
+10296,LILAS,9/3/1996 12:00:00 AM,9/11/1996 12:00:00 AM  
+10297,BLONP,9/4/1996 12:00:00 AM,9/10/1996 12:00:00 AM  
+10298,HUNGO,9/5/1996 12:00:00 AM,9/11/1996 12:00:00 AM  
+10300,MAGAA,9/9/1996 12:00:00 AM,9/18/1996 12:00:00 AM  
+10303,GODOS,9/11/1996 12:00:00 AM,9/18/1996 12:00:00 AM  
+10307,LONEP,9/17/1996 12:00:00 AM,9/25/1996 12:00:00 AM  
+10309,HUNGO,9/19/1996 12:00:00 AM,10/23/1996 12:00:00 AM  
+10315,ISLAT,9/26/1996 12:00:00 AM,10/3/1996 12:00:00 AM  
+10317,LONEP,9/30/1996 12:00:00 AM,10/10/1996 12:00:00 AM  
+10318,ISLAT,10/1/1996 12:00:00 AM,10/4/1996 12:00:00 AM  
+10321,ISLAT,10/3/1996 12:00:00 AM,10/11/1996 12:00:00 AM  
+10323,KOENE,10/7/1996 12:00:00 AM,10/14/1996 12:00:00 AM  
+10325,KOENE,10/9/1996 12:00:00 AM,10/14/1996 12:00:00 AM  
+10327,FOLKO,10/11/1996 12:00:00 AM,10/14/1996 12:00:00 AM  
+10328,FURIB,10/14/1996 12:00:00 AM,10/17/1996 12:00:00 AM  
+10330,LILAS,10/16/1996 12:00:00 AM,10/28/1996 12:00:00 AM  
+10331,BONAP,10/16/1996 12:00:00 AM,10/21/1996 12:00:00 AM  
+10335,HUNGO,10/22/1996 12:00:00 AM,10/24/1996 12:00:00 AM  
+10337,FRANK,10/24/1996 12:00:00 AM,10/29/1996 12:00:00 AM  
+10340,BONAP,10/29/1996 12:00:00 AM,11/8/1996 12:00:00 AM  
+10342,FRANK,10/30/1996 12:00:00 AM,11/4/1996 12:00:00 AM  
+10343,LEHMS,10/31/1996 12:00:00 AM,11/6/1996 12:00:00 AM  
+10347,FAMIA,11/6/1996 12:00:00 AM,11/8/1996 12:00:00 AM  
+10350,LAMAI,11/11/1996 12:00:00 AM,12/3/1996 12:00:00 AM  
+10351,ERNSH,11/11/1996 12:00:00 AM,11/20/1996 12:00:00 AM  
+10352,FURIB,11/12/1996 12:00:00 AM,11/18/1996 12:00:00 AM  
+10355,AROUT,11/15/1996 12:00:00 AM,11/20/1996 12:00:00 AM  
+10357,LILAS,11/19/1996 12:00:00 AM,12/2/1996 12:00:00 AM  
+10358,LAMAI,11/20/1996 12:00:00 AM,11/27/1996 12:00:00 AM  
+10360,BLONP,11/22/1996 12:00:00 AM,12/2/1996 12:00:00 AM  
+10362,BONAP,11/25/1996 12:00:00 AM,11/28/1996 12:00:00 AM  
+10363,DRACD,11/26/1996 12:00:00 AM,12/4/1996 12:00:00 AM  
+10364,EASTC,11/26/1996 12:00:00 AM,12/4/1996 12:00:00 AM  
+10365,ANTON,11/27/1996 12:00:00 AM,12/2/1996 12:00:00 AM  
+10366,GALED,11/28/1996 12:00:00 AM,12/30/1996 12:00:00 AM  
+10368,ERNSH,11/29/1996 12:00:00 AM,12/2/1996 12:00:00 AM  
+10370,CHOPS,12/3/1996 12:00:00 AM,12/27/1996 12:00:00 AM  
+10371,LAMAI,12/3/1996 12:00:00 AM,12/24/1996 12:00:00 AM  
+10373,HUNGO,12/5/1996 12:00:00 AM,12/11/1996 12:00:00 AM  
+10375,HUNGC,12/6/1996 12:00:00 AM,12/9/1996 12:00:00 AM  
+10378,FOLKO,12/10/1996 12:00:00 AM,12/19/1996 12:00:00 AM  
+10380,HUNGO,12/12/1996 12:00:00 AM,1/16/1997 12:00:00 AM  
+10381,LILAS,12/12/1996 12:00:00 AM,12/13/1996 12:00:00 AM  
+10382,ERNSH,12/13/1996 12:00:00 AM,12/16/1996 12:00:00 AM  
+10383,AROUT,12/16/1996 12:00:00 AM,12/18/1996 12:00:00 AM  
+10384,BERGS,12/16/1996 12:00:00 AM,12/20/1996 12:00:00 AM  
+10386,FAMIA,12/18/1996 12:00:00 AM,12/25/1996 12:00:00 AM  
+10389,BOTTM,12/20/1996 12:00:00 AM,12/24/1996 12:00:00 AM  
+10391,DRACD,12/23/1996 12:00:00 AM,12/31/1996 12:00:00 AM  
+10394,HUNGC,12/25/1996 12:00:00 AM,1/3/1997 12:00:00 AM  
+10395,HILAA,12/26/1996 12:00:00 AM,1/3/1997 12:00:00 AM  
+10396,FRANK,12/27/1996 12:00:00 AM,1/6/1997 12:00:00 AM  
+10400,EASTC,1/1/1997 12:00:00 AM,1/16/1997 12:00:00 AM  
+10404,MAGAA,1/3/1997 12:00:00 AM,1/8/1997 12:00:00 AM  
+10405,LINOD,1/6/1997 12:00:00 AM,1/22/1997 12:00:00 AM  
+10408,FOLIG,1/8/1997 12:00:00 AM,1/14/1997 12:00:00 AM  
+10410,BOTTM,1/10/1997 12:00:00 AM,1/15/1997 12:00:00 AM  
+10411,BOTTM,1/10/1997 12:00:00 AM,1/21/1997 12:00:00 AM  
+10413,LAMAI,1/14/1997 12:00:00 AM,1/16/1997 12:00:00 AM  
+10414,FAMIA,1/14/1997 12:00:00 AM,1/17/1997 12:00:00 AM  
+10415,HUNGC,1/15/1997 12:00:00 AM,1/24/1997 12:00:00 AM  
+10422,FRANS,1/22/1997 12:00:00 AM,1/31/1997 12:00:00 AM  
+10423,GOURL,1/23/1997 12:00:00 AM,2/24/1997 12:00:00 AM  
+10425,LAMAI,1/24/1997 12:00:00 AM,2/14/1997 12:00:00 AM  
+10426,GALED,1/27/1997 12:00:00 AM,2/6/1997 12:00:00 AM  
+10431,BOTTM,1/30/1997 12:00:00 AM,2/7/1997 12:00:00 AM  
+10434,FOLKO,2/3/1997 12:00:00 AM,2/13/1997 12:00:00 AM  
+10436,BLONP,2/5/1997 12:00:00 AM,2/11/1997 12:00:00 AM  
+10444,BERGS,2/12/1997 12:00:00 AM,2/21/1997 12:00:00 AM  
+10445,BERGS,2/13/1997 12:00:00 AM,2/20/1997 12:00:00 AM  
+10449,BLONP,2/18/1997 12:00:00 AM,2/27/1997 12:00:00 AM  
+10453,AROUT,2/21/1997 12:00:00 AM,2/26/1997 12:00:00 AM  
+10456,KOENE,2/25/1997 12:00:00 AM,2/28/1997 12:00:00 AM  
+10457,KOENE,2/25/1997 12:00:00 AM,3/3/1997 12:00:00 AM  
+10460,FOLKO,2/28/1997 12:00:00 AM,3/3/1997 12:00:00 AM  
+10464,FURIB,3/4/1997 12:00:00 AM,3/14/1997 12:00:00 AM  
+10466,COMMI,3/6/1997 12:00:00 AM,3/13/1997 12:00:00 AM  
+10467,MAGAA,3/6/1997 12:00:00 AM,3/11/1997 12:00:00 AM  
+10468,KOENE,3/7/1997 12:00:00 AM,3/12/1997 12:00:00 AM  
+10470,BONAP,3/11/1997 12:00:00 AM,3/14/1997 12:00:00 AM  
+10471,BSBEV,3/11/1997 12:00:00 AM,3/18/1997 12:00:00 AM  
+10473,ISLAT,3/13/1997 12:00:00 AM,3/21/1997 12:00:00 AM  
+10476,HILAA,3/17/1997 12:00:00 AM,3/24/1997 12:00:00 AM  
+10480,FOLIG,3/20/1997 12:00:00 AM,3/24/1997 12:00:00 AM  
+10484,BSBEV,3/24/1997 12:00:00 AM,4/1/1997 12:00:00 AM  
+10485,LINOD,3/25/1997 12:00:00 AM,3/31/1997 12:00:00 AM  
+10486,HILAA,3/26/1997 12:00:00 AM,4/2/1997 12:00:00 AM  
+10488,FRANK,3/27/1997 12:00:00 AM,4/2/1997 12:00:00 AM  
+10490,HILAA,3/31/1997 12:00:00 AM,4/3/1997 12:00:00 AM  
+10491,FURIB,3/31/1997 12:00:00 AM,4/8/1997 12:00:00 AM  
+10492,BOTTM,4/1/1997 12:00:00 AM,4/11/1997 12:00:00 AM  
+10494,COMMI,4/2/1997 12:00:00 AM,4/9/1997 12:00:00 AM  
+10497,LEHMS,4/4/1997 12:00:00 AM,4/7/1997 12:00:00 AM  
+10501,BLAUS,4/9/1997 12:00:00 AM,4/16/1997 12:00:00 AM  
+10507,ANTON,4/15/1997 12:00:00 AM,4/22/1997 12:00:00 AM  
+10509,BLAUS,4/17/1997 12:00:00 AM,4/29/1997 12:00:00 AM  
+10511,BONAP,4/18/1997 12:00:00 AM,4/21/1997 12:00:00 AM  
+10512,FAMIA,4/21/1997 12:00:00 AM,4/24/1997 12:00:00 AM  
+10519,CHOPS,4/28/1997 12:00:00 AM,5/1/1997 12:00:00 AM  
+10521,CACTU,4/29/1997 12:00:00 AM,5/2/1997 12:00:00 AM  
+10522,LEHMS,4/30/1997 12:00:00 AM,5/6/1997 12:00:00 AM  
+10528,GREAL,5/6/1997 12:00:00 AM,5/9/1997 12:00:00 AM  
+10529,MAISD,5/7/1997 12:00:00 AM,5/9/1997 12:00:00 AM  
+10532,EASTC,5/9/1997 12:00:00 AM,5/12/1997 12:00:00 AM  
+10535,ANTON,5/13/1997 12:00:00 AM,5/21/1997 12:00:00 AM  
+10538,BSBEV,5/15/1997 12:00:00 AM,5/16/1997 12:00:00 AM  
+10539,BSBEV,5/16/1997 12:00:00 AM,5/23/1997 12:00:00 AM  
+10541,HANAR,5/19/1997 12:00:00 AM,5/29/1997 12:00:00 AM  
+10544,LONEP,5/21/1997 12:00:00 AM,5/30/1997 12:00:00 AM  
+10550,GODOS,5/28/1997 12:00:00 AM,6/6/1997 12:00:00 AM  
+10551,FURIB,5/28/1997 12:00:00 AM,6/6/1997 12:00:00 AM  
+10558,AROUT,6/4/1997 12:00:00 AM,6/10/1997 12:00:00 AM  
+10568,GALED,6/13/1997 12:00:00 AM,7/9/1997 12:00:00 AM  
+10573,ANTON,6/19/1997 12:00:00 AM,6/20/1997 12:00:00 AM  
+10581,FAMIA,6/26/1997 12:00:00 AM,7/2/1997 12:00:00 AM  
+10582,BLAUS,6/27/1997 12:00:00 AM,7/14/1997 12:00:00 AM  
+10589,GREAL,7/4/1997 12:00:00 AM,7/14/1997 12:00:00 AM  
+10600,HUNGC,7/16/1997 12:00:00 AM,7/21/1997 12:00:00 AM  
+10614,BLAUS,7/29/1997 12:00:00 AM,8/1/1997 12:00:00 AM  
+10616,GREAL,7/31/1997 12:00:00 AM,8/5/1997 12:00:00 AM  
+10617,GREAL,7/31/1997 12:00:00 AM,8/4/1997 12:00:00 AM  
+10621,ISLAT,8/5/1997 12:00:00 AM,8/11/1997 12:00:00 AM  
+10629,GODOS,8/12/1997 12:00:00 AM,8/20/1997 12:00:00 AM  
+10634,FOLIG,8/15/1997 12:00:00 AM,8/21/1997 12:00:00 AM  
+10635,MAGAA,8/18/1997 12:00:00 AM,8/21/1997 12:00:00 AM  
+10638,LINOD,8/20/1997 12:00:00 AM,9/1/1997 12:00:00 AM  
+10643,ALFKI,8/25/1997 12:00:00 AM,9/2/1997 12:00:00 AM  
+10645,HANAR,8/26/1997 12:00:00 AM,9/2/1997 12:00:00 AM  
+10649,MAISD,8/28/1997 12:00:00 AM,8/29/1997 12:00:00 AM  
+10652,GOURL,9/1/1997 12:00:00 AM,9/8/1997 12:00:00 AM  
+10656,GREAL,9/4/1997 12:00:00 AM,9/10/1997 12:00:00 AM  
+10660,HUNGC,9/8/1997 12:00:00 AM,10/15/1997 12:00:00 AM  
+10662,LONEP,9/9/1997 12:00:00 AM,9/18/1997 12:00:00 AM  
+10665,LONEP,9/11/1997 12:00:00 AM,9/17/1997 12:00:00 AM  
+10677,ANTON,9/22/1997 12:00:00 AM,9/26/1997 12:00:00 AM  
+10685,GOURL,9/29/1997 12:00:00 AM,10/3/1997 12:00:00 AM  
+10690,HANAR,10/2/1997 12:00:00 AM,10/3/1997 12:00:00 AM  
+10692,ALFKI,10/3/1997 12:00:00 AM,10/13/1997 12:00:00 AM  
+10697,LINOD,10/8/1997 12:00:00 AM,10/14/1997 12:00:00 AM  
+10702,ALFKI,10/13/1997 12:00:00 AM,10/21/1997 12:00:00 AM  
+10707,AROUT,10/16/1997 12:00:00 AM,10/23/1997 12:00:00 AM  
+10709,GOURL,10/17/1997 12:00:00 AM,11/20/1997 12:00:00 AM  
+10710,FRANS,10/20/1997 12:00:00 AM,10/23/1997 12:00:00 AM  
+10726,EASTC,11/3/1997 12:00:00 AM,12/5/1997 12:00:00 AM  
+10729,LINOD,11/4/1997 12:00:00 AM,11/14/1997 12:00:00 AM  
+10731,CHOPS,11/6/1997 12:00:00 AM,11/14/1997 12:00:00 AM  
+10734,GOURL,11/7/1997 12:00:00 AM,11/12/1997 12:00:00 AM  
+10746,CHOPS,11/19/1997 12:00:00 AM,11/21/1997 12:00:00 AM  
+10753,FRANS,11/25/1997 12:00:00 AM,11/27/1997 12:00:00 AM  
+10760,MAISD,12/1/1997 12:00:00 AM,12/10/1997 12:00:00 AM  
+10763,FOLIG,12/3/1997 12:00:00 AM,12/8/1997 12:00:00 AM  
+10782,CACTU,12/17/1997 12:00:00 AM,12/22/1997 12:00:00 AM  
+10789,FOLIG,12/22/1997 12:00:00 AM,12/31/1997 12:00:00 AM  
+10797,DRACD,12/25/1997 12:00:00 AM,1/5/1998 12:00:00 AM  
+10807,FRANS,12/31/1997 12:00:00 AM,1/30/1998 12:00:00 AM  
+10819,CACTU,1/7/1998 12:00:00 AM,1/16/1998 12:00:00 AM  
+10825,DRACD,1/9/1998 12:00:00 AM,1/14/1998 12:00:00 AM  
+10835,ALFKI,1/15/1998 12:00:00 AM,1/21/1998 12:00:00 AM  
+10853,BLAUS,1/27/1998 12:00:00 AM,2/3/1998 12:00:00 AM  
+10872,GODOS,2/5/1998 12:00:00 AM,2/9/1998 12:00:00 AM  
+10874,GODOS,2/6/1998 12:00:00 AM,2/11/1998 12:00:00 AM  
+10881,CACTU,2/11/1998 12:00:00 AM,2/18/1998 12:00:00 AM  
+10887,GALED,2/13/1998 12:00:00 AM,2/16/1998 12:00:00 AM  
+10892,MAISD,2/17/1998 12:00:00 AM,2/19/1998 12:00:00 AM  
+10896,MAISD,2/19/1998 12:00:00 AM,2/27/1998 12:00:00 AM  
+10928,GALED,3/5/1998 12:00:00 AM,3/18/1998 12:00:00 AM  
+10937,CACTU,3/10/1998 12:00:00 AM,3/13/1998 12:00:00 AM  
+10952,ALFKI,3/16/1998 12:00:00 AM,3/24/1998 12:00:00 AM  
+10969,COMMI,3/23/1998 12:00:00 AM,3/30/1998 12:00:00 AM  
+10987,EASTC,3/31/1998 12:00:00 AM,4/6/1998 12:00:00 AM  
+11026,FRANS,4/15/1998 12:00:00 AM,4/28/1998 12:00:00 AM  
+11036,DRACD,4/20/1998 12:00:00 AM,4/22/1998 12:00:00 AM  
+11042,COMMI,4/22/1998 12:00:00 AM,5/1/1998 12:00:00 AM  
+END ORDERS  
+  
+ORDER DETAILS  
+10250,41,7.7000,10,0  
+10250,51,42.4000,35,0.15  
+10250,65,16.8000,15,0.15  
+10253,31,10.0000,20,0  
+10253,39,14.4000,42,0  
+10253,49,16.0000,40,0  
+10254,24,3.6000,15,0.15  
+10254,55,19.2000,21,0.15  
+10254,74,8.0000,21,0  
+10257,27,35.1000,25,0  
+10257,39,14.4000,6,0  
+10257,77,10.4000,15,0  
+10258,2,15.2000,50,0.2  
+10258,5,17.0000,65,0.2  
+10258,32,25.6000,6,0.2  
+10263,16,13.9000,60,0.25  
+10263,24,3.6000,28,0  
+10263,30,20.7000,60,0.25  
+10263,74,8.0000,36,0.25  
+10264,2,15.2000,35,0  
+10264,41,7.7000,25,0.15  
+10265,17,31.2000,30,0  
+10265,70,12.0000,20,0  
+10267,40,14.7000,50,0  
+10267,59,44.0000,70,0.15  
+10267,76,14.4000,15,0.15  
+10275,24,3.6000,12,0.05  
+10275,59,44.0000,6,0.05  
+10278,44,15.5000,16,0  
+10278,59,44.0000,15,0  
+10278,63,35.1000,8,0  
+10278,73,12.0000,25,0  
+10279,17,31.2000,15,0.25  
+10280,24,3.6000,12,0  
+10280,55,19.2000,20,0  
+10280,75,6.2000,30,0  
+10283,15,12.4000,20,0  
+10283,19,7.3000,18,0  
+10283,60,27.2000,35,0  
+10283,72,27.8000,3,0  
+10284,27,35.1000,15,0.25  
+10284,44,15.5000,21,0  
+10284,60,27.2000,20,0.25  
+10284,67,11.2000,5,0.25  
+10289,3,8.0000,30,0  
+10289,64,26.6000,9,0  
+10290,5,17.0000,20,0  
+10290,29,99.0000,15,0  
+10290,49,16.0000,15,0  
+10290,77,10.4000,10,0  
+10296,11,16.8000,12,0  
+10296,16,13.9000,30,0  
+10296,69,28.8000,15,0  
+10297,39,14.4000,60,0  
+10297,72,27.8000,20,0  
+10298,2,15.2000,40,0  
+10298,36,15.2000,40,0.25  
+10298,59,44.0000,30,0.25  
+10298,62,39.4000,15,0  
+10300,66,13.6000,30,0  
+10300,68,10.0000,20,0  
+10303,40,14.7000,40,0.1  
+10303,65,16.8000,30,0.1  
+10303,68,10.0000,15,0.1  
+10307,62,39.4000,10,0  
+10307,68,10.0000,3,0  
+10309,4,17.6000,20,0  
+10309,6,20.0000,30,0  
+10309,42,11.2000,2,0  
+10309,43,36.8000,20,0  
+10309,71,17.2000,3,0  
+10315,34,11.2000,14,0  
+10315,70,12.0000,30,0  
+10317,1,14.4000,20,0  
+10318,41,7.7000,20,0  
+10318,76,14.4000,6,0  
+10321,35,14.4000,10,0  
+10323,15,12.4000,5,0  
+10323,25,11.2000,4,0  
+10323,39,14.4000,4,0  
+10325,6,20.0000,6,0  
+10325,13,4.8000,12,0  
+10325,14,18.6000,9,0  
+10325,31,10.0000,4,0  
+10325,72,27.8000,40,0  
+10327,2,15.2000,25,0.2  
+10327,11,16.8000,50,0.2  
+10327,30,20.7000,35,0.2  
+10327,58,10.6000,30,0.2  
+10328,59,44.0000,9,0  
+10328,65,16.8000,40,0  
+10328,68,10.0000,10,0  
+10330,26,24.9000,50,0.15  
+10330,72,27.8000,25,0.15  
+10331,54,5.9000,15,0  
+10335,2,15.2000,7,0.2  
+10335,31,10.0000,25,0.2  
+10335,32,25.6000,6,0.2  
+10335,51,42.4000,48,0.2  
+10337,23,7.2000,40,0  
+10337,26,24.9000,24,0  
+10337,36,15.2000,20,0  
+10337,37,20.8000,28,0  
+10337,72,27.8000,25,0  
+10340,18,50.0000,20,0.05  
+10340,41,7.7000,12,0.05  
+10340,43,36.8000,40,0.05  
+10342,2,15.2000,24,0.2  
+10342,31,10.0000,56,0.2  
+10342,36,15.2000,40,0.2  
+10342,55,19.2000,40,0.2  
+10343,64,26.6000,50,0  
+10343,68,10.0000,4,0.05  
+10343,76,14.4000,15,0  
+10347,25,11.2000,10,0  
+10347,39,14.4000,50,0.15  
+10347,40,14.7000,4,0  
+10347,75,6.2000,6,0.15  
+10350,50,13.0000,15,0.1  
+10350,69,28.8000,18,0.1  
+10351,38,210.8000,20,0.05  
+10351,41,7.7000,13,0  
+10351,44,15.5000,77,0.05  
+10351,65,16.8000,10,0.05  
+10352,24,3.6000,10,0  
+10352,54,5.9000,20,0.15  
+10355,24,3.6000,25,0  
+10355,57,15.6000,25,0  
+10357,10,24.8000,30,0.2  
+10357,26,24.9000,16,0  
+10357,60,27.2000,8,0.2  
+10358,24,3.6000,10,0.05  
+10358,34,11.2000,10,0.05  
+10358,36,15.2000,20,0.05  
+10360,28,36.4000,30,0  
+10360,29,99.0000,35,0  
+10360,38,210.8000,10,0  
+10360,49,16.0000,35,0  
+10360,54,5.9000,28,0  
+10362,25,11.2000,50,0  
+10362,51,42.4000,20,0  
+10362,54,5.9000,24,0  
+10363,31,10.0000,20,0  
+10363,75,6.2000,12,0  
+10363,76,14.4000,12,0  
+10364,69,28.8000,30,0  
+10364,71,17.2000,5,0  
+10365,11,16.8000,24,0  
+10366,65,16.8000,5,0  
+10366,77,10.4000,5,0  
+10368,21,8.0000,5,0.1  
+10368,28,36.4000,13,0.1  
+10368,57,15.6000,25,0  
+10368,64,26.6000,35,0.1  
+10370,1,14.4000,15,0.15  
+10370,64,26.6000,30,0  
+10370,74,8.0000,20,0.15  
+10371,36,15.2000,6,0.2  
+10373,58,10.6000,80,0.2  
+10373,71,17.2000,50,0.2  
+10375,14,18.6000,15,0  
+10375,54,5.9000,10,0  
+10378,71,17.2000,6,0  
+10380,30,20.7000,18,0.1  
+10380,53,26.2000,20,0.1  
+10380,60,27.2000,6,0.1  
+10380,70,12.0000,30,0  
+10381,74,8.0000,14,0  
+10382,5,17.0000,32,0  
+10382,18,50.0000,9,0  
+10382,29,99.0000,14,0  
+10382,33,2.0000,60,0  
+10382,74,8.0000,50,0  
+10383,13,4.8000,20,0  
+10383,50,13.0000,15,0  
+10383,56,30.4000,20,0  
+10384,20,64.8000,28,0  
+10384,60,27.2000,15,0  
+10386,24,3.6000,15,0  
+10386,34,11.2000,10,0  
+10389,10,24.8000,16,0  
+10389,55,19.2000,15,0  
+10389,62,39.4000,20,0  
+10389,70,12.0000,30,0  
+10391,13,4.8000,18,0  
+10394,13,4.8000,10,0  
+10394,62,39.4000,10,0  
+10395,46,9.6000,28,0.1  
+10395,53,26.2000,70,0.1  
+10395,69,28.8000,8,0  
+10396,23,7.2000,40,0  
+10396,71,17.2000,60,0  
+10396,72,27.8000,21,0  
+10400,29,99.0000,21,0  
+10400,35,14.4000,35,0  
+10400,49,16.0000,30,0  
+10404,26,24.9000,30,0.05  
+10404,42,11.2000,40,0.05  
+10404,49,16.0000,30,0.05  
+10405,3,8.0000,50,0  
+10408,37,20.8000,10,0  
+10408,54,5.9000,6,0  
+10408,62,39.4000,35,0  
+10410,33,2.0000,49,0  
+10410,59,44.0000,16,0  
+10411,41,7.7000,25,0.2  
+10411,44,15.5000,40,0.2  
+10411,59,44.0000,9,0.2  
+10413,1,14.4000,24,0  
+10413,62,39.4000,40,0  
+10413,76,14.4000,14,0  
+10414,19,7.3000,18,0.05  
+10414,33,2.0000,50,0  
+10415,17,31.2000,2,0  
+10415,33,2.0000,20,0  
+10422,26,24.9000,2,0  
+10423,31,10.0000,14,0  
+10423,59,44.0000,20,0  
+10425,55,19.2000,10,0.25  
+10425,76,14.4000,20,0.25  
+10426,56,30.4000,5,0  
+10426,64,26.6000,7,0  
+10431,17,31.2000,50,0.25  
+10431,40,14.7000,50,0.25  
+10431,47,7.6000,30,0.25  
+10434,11,16.8000,6,0  
+10434,76,14.4000,18,0.15  
+10436,46,9.6000,5,0  
+10436,56,30.4000,40,0.1  
+10436,64,26.6000,30,0.1  
+10436,75,6.2000,24,0.1  
+10444,17,31.2000,10,0  
+10444,26,24.9000,15,0  
+10444,35,14.4000,8,0  
+10444,41,7.7000,30,0  
+10445,39,14.4000,6,0  
+10445,54,5.9000,15,0  
+10449,10,24.8000,14,0  
+10449,52,5.6000,20,0  
+10449,62,39.4000,35,0  
+10453,48,10.2000,15,0.1  
+10453,70,12.0000,25,0.1  
+10456,21,8.0000,40,0.15  
+10456,49,16.0000,21,0.15  
+10457,59,44.0000,36,0  
+10460,68,10.0000,21,0.25  
+10460,75,6.2000,4,0.25  
+10464,4,17.6000,16,0.2  
+10464,43,36.8000,3,0  
+10464,56,30.4000,30,0.2  
+10464,60,27.2000,20,0  
+10466,11,16.8000,10,0  
+10466,46,9.6000,5,0  
+10467,24,3.6000,28,0  
+10467,25,11.2000,12,0  
+10468,30,20.7000,8,0  
+10468,43,36.8000,15,0  
+10470,18,50.0000,30,0  
+10470,23,7.2000,15,0  
+10470,64,26.6000,8,0  
+10471,7,24.0000,30,0  
+10471,56,30.4000,20,0  
+10473,33,2.0000,12,0  
+10473,71,17.2000,12,0  
+10476,55,19.2000,2,0.05  
+10476,70,12.0000,12,0  
+10480,47,7.6000,30,0  
+10480,59,44.0000,12,0  
+10484,21,8.0000,14,0  
+10484,40,14.7000,10,0  
+10484,51,42.4000,3,0  
+10485,2,15.2000,20,0.1  
+10485,3,8.0000,20,0.1  
+10485,55,19.2000,30,0.1  
+10485,70,12.0000,60,0.1  
+10486,11,16.8000,5,0  
+10486,51,42.4000,25,0  
+10486,74,8.0000,16,0  
+10488,59,44.0000,30,0  
+10488,73,12.0000,20,0.2  
+10490,59,44.0000,60,0  
+10490,68,10.0000,30,0  
+10490,75,6.2000,36,0  
+10491,44,15.5000,15,0.15  
+10491,77,10.4000,7,0.15  
+10492,25,11.2000,60,0.05  
+10492,42,11.2000,20,0.05  
+10494,56,30.4000,30,0  
+10497,56,30.4000,14,0  
+10497,72,27.8000,25,0  
+10497,77,10.4000,25,0  
+10501,54,7.4500,20,0  
+10507,43,46.0000,15,0.15  
+10507,48,12.7500,15,0.15  
+10509,28,45.6000,3,0  
+10511,4,22.0000,50,0.15  
+10511,7,30.0000,50,0.15  
+10511,8,40.0000,10,0.15  
+10512,24,4.5000,10,0.15  
+10512,46,12.0000,9,0.15  
+10512,47,9.5000,6,0.15  
+10512,60,34.0000,12,0.15  
+10519,10,31.0000,16,0.05  
+10519,56,38.0000,40,0  
+10519,60,34.0000,10,0.05  
+10521,35,18.0000,3,0  
+10521,41,9.6500,10,0  
+10521,68,12.5000,6,0  
+10522,1,18.0000,40,0.2  
+10522,8,40.0000,24,0  
+10522,30,25.8900,20,0.2  
+10522,40,18.4000,25,0.2  
+10528,11,21.0000,3,0  
+10528,33,2.5000,8,0.2  
+10528,72,34.8000,9,0  
+10529,55,24.0000,14,0  
+10529,68,12.5000,20,0  
+10529,69,36.0000,10,0  
+10532,30,25.8900,15,0  
+10532,66,17.0000,24,0  
+10535,11,21.0000,50,0.1  
+10535,40,18.4000,10,0.1  
+10535,57,19.5000,5,0.1  
+10535,59,55.0000,15,0.1  
+10538,70,15.0000,7,0  
+10538,72,34.8000,1,0  
+10539,13,6.0000,8,0  
+10539,21,10.0000,15,0  
+10539,33,2.5000,15,0  
+10539,49,20.0000,6,0  
+10541,24,4.5000,35,0.1  
+10541,38,263.5000,4,0.1  
+10541,65,21.0500,36,0.1  
+10541,71,21.5000,9,0.1  
+10544,28,45.6000,7,0  
+10544,67,14.0000,7,0  
+10550,17,39.0000,8,0.1  
+10550,19,9.2000,10,0  
+10550,21,10.0000,6,0.1  
+10550,61,28.5000,10,0.1  
+10551,16,17.4500,40,0.15  
+10551,35,18.0000,20,0.15  
+10551,44,19.4500,40,0  
+10558,47,9.5000,25,0  
+10558,51,53.0000,20,0  
+10558,52,7.0000,30,0  
+10558,53,32.8000,18,0  
+10558,73,15.0000,3,0  
+10568,10,31.0000,5,0  
+10573,17,39.0000,18,0  
+10573,34,14.0000,40,0  
+10573,53,32.8000,25,0  
+10581,75,7.7500,50,0.2  
+10582,57,19.5000,4,0  
+10582,76,18.0000,14,0  
+10589,35,18.0000,4,0  
+10600,54,7.4500,4,0  
+10600,73,15.0000,30,0  
+10614,11,21.0000,14,0  
+10614,21,10.0000,8,0  
+10614,39,18.0000,5,0  
+10616,38,263.5000,15,0.05  
+10616,56,38.0000,14,0  
+10616,70,15.0000,15,0.05  
+10616,71,21.5000,15,0.05  
+10617,59,55.0000,30,0.15  
+10621,19,9.2000,5,0  
+10621,23,9.0000,10,0  
+10621,70,15.0000,20,0  
+10621,71,21.5000,15,0  
+10629,29,123.7900,20,0  
+10629,64,33.2500,9,0  
+10634,7,30.0000,35,0  
+10634,18,62.5000,50,0  
+10634,51,53.0000,15,0  
+10634,75,7.7500,2,0  
+10635,4,22.0000,10,0.1  
+10635,5,21.3500,15,0.1  
+10635,22,21.0000,40,0  
+10638,45,9.5000,20,0  
+10638,65,21.0500,21,0  
+10638,72,34.8000,60,0  
+10643,28,45.6000,15,0.25  
+10643,39,18.0000,21,0.25  
+10643,46,12.0000,2,0.25  
+10645,18,62.5000,20,0  
+10645,36,19.0000,15,0  
+10649,28,45.6000,20,0  
+10649,72,34.8000,15,0  
+10652,30,25.8900,2,0.25  
+10652,42,14.0000,20,0  
+10656,14,23.2500,3,0.1  
+10656,44,19.4500,28,0.1  
+10656,47,9.5000,6,0.1  
+10660,20,81.0000,21,0  
+10662,68,12.5000,10,0  
+10665,51,53.0000,20,0  
+10665,59,55.0000,1,0  
+10665,76,18.0000,10,0  
+10677,26,31.2300,30,0.15  
+10677,33,2.5000,8,0.15  
+10685,10,31.0000,20,0  
+10685,41,9.6500,4,0  
+10685,47,9.5000,15,0  
+10690,56,38.0000,20,0.25  
+10690,77,13.0000,30,0.25  
+10692,63,43.9000,20,0  
+10697,19,9.2000,7,0.25  
+10697,35,18.0000,9,0.25  
+10697,58,13.2500,30,0.25  
+10697,70,15.0000,30,0.25  
+10702,3,10.0000,6,0  
+10702,76,18.0000,15,0  
+10707,55,24.0000,21,0  
+10707,57,19.5000,40,0  
+10707,70,15.0000,28,0.15  
+10709,8,40.0000,40,0  
+10709,51,53.0000,28,0  
+10709,60,34.0000,10,0  
+10710,19,9.2000,5,0  
+10710,47,9.5000,5,0  
+10726,4,22.0000,25,0  
+10726,11,21.0000,5,0  
+10729,1,18.0000,50,0  
+10729,21,10.0000,30,0  
+10729,50,16.2500,40,0  
+10731,21,10.0000,40,0.05  
+10731,51,53.0000,30,0.05  
+10734,6,25.0000,30,0  
+10734,30,25.8900,15,0  
+10734,76,18.0000,20,0  
+10746,13,6.0000,6,0  
+10746,42,14.0000,28,0  
+10746,62,49.3000,9,0  
+10746,69,36.0000,40,0  
+10753,45,9.5000,4,0  
+10753,74,10.0000,5,0  
+10760,25,14.0000,12,0.25  
+10760,27,43.9000,40,0  
+10760,43,46.0000,30,0.25  
+10763,21,10.0000,40,0  
+10763,22,21.0000,6,0  
+10763,24,4.5000,20,0  
+10782,31,12.5000,1,0  
+10789,18,62.5000,30,0  
+10789,35,18.0000,15,0  
+10789,63,43.9000,30,0  
+10789,68,12.5000,18,0  
+10797,11,21.0000,20,0  
+10807,40,18.4000,1,0  
+10819,43,46.0000,7,0  
+10819,75,7.7500,20,0  
+10825,26,31.2300,12,0  
+10825,53,32.8000,20,0  
+10835,59,55.0000,15,0  
+10835,77,13.0000,2,0.2  
+10853,18,62.5000,10,0  
+10872,55,24.0000,10,0.05  
+10872,62,49.3000,20,0.05  
+10872,64,33.2500,15,0.05  
+10872,65,21.0500,21,0.05  
+10874,10,31.0000,10,0  
+10881,73,15.0000,10,0  
+10887,25,14.0000,5,0  
+10892,59,55.0000,40,0.05  
+10896,45,9.5000,15,0  
+10896,56,38.0000,16,0  
+10928,47,9.5000,5,0  
+10928,76,18.0000,5,0  
+10937,28,45.6000,8,0  
+10937,34,14.0000,20,0  
+10952,6,25.0000,16,0.05  
+10952,28,45.6000,2,0  
+10969,46,12.0000,9,0  
+10987,7,30.0000,60,0  
+10987,43,46.0000,6,0  
+10987,72,34.8000,20,0  
+11026,18,62.5000,8,0  
+11026,51,53.0000,10,0  
+11036,13,6.0000,7,0  
+11036,59,55.0000,30,0  
+11042,44,19.4500,15,0  
+11042,61,28.5000,4,0  
+END ORDER DETAILS  
+  
+PRODUCTS  
+1,Chai,18.0000  
+2,Chang,19.0000  
+3,Aniseed Syrup,10.0000  
+4,Chef Anton's Cajun Seasoning,22.0000  
+5,Chef Anton's Gumbo Mix,21.3500  
+6,Grandma's Boysenberry Spread,25.0000  
+7,Uncle Bob's Organic Dried Pears,30.0000  
+8,Northwoods Cranberry Sauce,40.0000  
+9,Mishi Kobe Niku,97.0000  
+10,Ikura,31.0000  
+11,Queso Cabrales,21.0000  
+12,Queso Manchego La Pastora,38.0000  
+13,Konbu,6.0000  
+14,Tofu,23.2500  
+15,Genen Shouyu,15.5000  
+16,Pavlova,17.4500  
+17,Alice Mutton,39.0000  
+18,Carnarvon Tigers,62.5000  
+19,Teatime Chocolate Biscuits,9.2000  
+20,Sir Rodney's Marmalade,81.0000  
+21,Sir Rodney's Scones,10.0000  
+22,Gustaf's Knäckebröd,21.0000  
+23,Tunnbröd,9.0000  
+24,Guaraná Fantástica,4.5000  
+25,NuNuCa Nuß-Nougat-Creme,14.0000  
+26,Gumbär Gummibärchen,31.2300  
+27,Schoggi Schokolade,43.9000  
+28,Rössle Sauerkraut,45.6000  
+29,Thüringer Rostbratwurst,123.7900  
+30,Nord-Ost Matjeshering,25.8900  
+31,Gorgonzola Telino,12.5000  
+32,Mascarpone Fabioli,32.0000  
+33,Geitost,2.5000  
+34,Sasquatch Ale,14.0000  
+35,Steeleye Stout,18.0000  
+36,Inlagd Sill,19.0000  
+37,Gravad lax,26.0000  
+38,Côte de Blaye,263.5000  
+39,Chartreuse verte,18.0000  
+40,Boston Crab Meat,18.4000  
+41,Jack's New England Clam Chowder,9.6500  
+42,Singaporean Hokkien Fried Mee,14.0000  
+43,Ipoh Coffee,46.0000  
+44,Gula Malacca,19.4500  
+45,Rogede sild,9.5000  
+46,Spegesild,12.0000  
+47,Zaanse koeken,9.5000  
+48,Chocolade,12.7500  
+49,Maxilaku,20.0000  
+50,Valkoinen suklaa,16.2500  
+51,Manjimup Dried Apples,53.0000  
+52,Filo Mix,7.0000  
+53,Perth Pasties,32.8000  
+54,Tourtière,7.4500  
+55,Pâté chinois,24.0000  
+56,Gnocchi di nonna Alice,38.0000  
+57,Ravioli Angelo,19.5000  
+58,Escargots de Bourgogne,13.2500  
+59,Raclette Courdavault,55.0000  
+60,Camembert Pierrot,34.0000  
+61,Sirop d'érable,28.5000  
+62,Tarte au sucre,49.3000  
+63,Vegie-spread,43.9000  
+64,Wimmers gute Semmelknödel,33.2500  
+65,Louisiana Fiery Hot Pepper Sauce,21.0500  
+66,Louisiana Hot Spiced Okra,17.0000  
+67,Laughing Lumberjack Lager,14.0000  
+68,Scottish Longbreads,12.5000  
+69,Gudbrandsdalsost,36.0000  
+70,Outback Lager,15.0000  
+71,Flotemysost,21.5000  
+72,Mozzarella di Giovanni,34.8000  
+73,Röd Kaviar,15.0000  
+74,Longlife Tofu,10.0000  
+75,Rhönbräu Klosterbier,7.7500  
+76,Lakkalikööri,18.0000  
+77,Original Frankfurter grüne Soße,13.0000  
+END PRODUCTS  
+  
+```  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/potential-pitfalls-in-data-and-task-parallelism.md b/docs/standard/parallel-programming/potential-pitfalls-in-data-and-task-parallelism.md
new file mode 100644
index 00000000000..a00ee8576ce
--- /dev/null
+++ b/docs/standard/parallel-programming/potential-pitfalls-in-data-and-task-parallelism.md
@@ -0,0 +1,87 @@
+---
+title: "Potential Pitfalls in Data and Task Parallelism | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallel programming, pitfalls"
+ms.assetid: 1e357177-e699-4b8f-9e49-56d3513ed128
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Potential Pitfalls in Data and Task Parallelism
+<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> を使用すると、多くの場合、通常の順次ループよりもパフォーマンスが大幅に向上します。  ただし、ループを並列化すると、複雑性が増すため、シーケンシャル コードにおいて一般的でない問題、またはめったにない問題を引き起こす場合があります。  このトピックでは、並列ループを記述するときに避ける必要がある点について示します。  
+  
+## 並列が常に速いとは限らないことを理解する  
+ 場合によっては、並列ループは同等の順次ループよりも実行速度が遅くなることがあります。  基本的には、反復処理が少なく高速なユーザー デリゲートを使用する並列ループでは、実行速度が大幅に向上することはほとんどありません。  ただし、パフォーマンスには多くの要因が関係するため、常に実際の結果を測定することをお勧めします。  
+  
+## 共有メモリの位置への書き込みを回避する  
+ シーケンシャル コードでは、静的変数またはクラス フィールドから読み取ったり、これらの場所に書き込んだりすることは珍しくありません。  ただし、複数のスレッドがこれらの変数に同時にアクセスしているときは、著しい競合状態になる場合がよくあります。  ロックを使用して変数へのアクセスを同期させることもできますが、同期のコストによってパフォーマンスが低下するおそれがあります。  このため、並列ループにおける共有状態へのアクセスは、できるだけ回避するか、少なくとも制限することをお勧めします。  この場合の最適な方法は、ループの実行中に <xref:System.Threading.ThreadLocal%601?displayProperty=fullName> 変数を使用してスレッド ローカルの状態を格納する、<xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> のオーバーロードを使用することです。  詳細については、「[How to: Write a Parallel.For Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-for-loop-with-thread-local-variables.md)」および「[How to: Write a Parallel.ForEach Loop with Thread\-Local Variables](../../../docs/standard/parallel-programming/how-to-write-a-parallel-foreach-loop-with-thread-local-variables.md)」を参照してください。  
+  
+## 過剰な並列化を避ける  
+ 並列ループを使用すると、ソース コレクションのパーティション分割およびワーカー スレッドの同期でオーバーヘッド コストが発生します。  並列化の利点は、コンピューター上のプロセッサ数によってさらに制限されます。  1 つのプロセッサで複数の計算主体のスレッドを実行しても、高速にはなりません。  このため、ループを過剰に並列化しないように注意する必要があります。  
+  
+ 過剰な並列化における最も一般的なシナリオは、入れ子のループが発生することです。  多くの場合、次の条件のうち 1 つ以上に当てはまらない限り、外側のループのみを並列化するのが最適です。  
+  
+-   内側のループが非常に長い。  
+  
+-   各順序で負荷の大きい計算を実行している \(この例で示した操作の負荷は大きくありません\)。  
+  
+-   対象のシステムに、`cust.Orders` でクエリを並列化して生成されるスレッドの数を十分に処理できるプロセッサが備わっている。  
+  
+ ほとんどの場合、適切なクエリの形を決定する最適な方法は、テストして計測することです。  
+  
+## スレッド セーフでないメソッドへの呼び出しを回避する  
+ 並列ループからスレッド セーフでないインスタンス メソッドへの書き込みを行うと、プログラムで検知されない可能性があるデータ破損が発生するおそれがあります。  例外が発生する可能性もあります。  次の例では、複数のスレッドが、クラスでサポートされていない <xref:System.IO.FileStream.WriteByte%2A?displayProperty=fullName> メソッドの同時呼び出しを試みます。  
+  
+ [!code-csharp[TPL_Pitfalls#04](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_pitfalls/cs/pitfalls.cs#04)]
+ [!code-vb[TPL_Pitfalls#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_pitfalls/vb/pitfalls_vb.vb#04)]  
+  
+## スレッド セーフなメソッドへの呼び出しを制限する  
+ .NET Framework のほとんどの静的メソッドはスレッド セーフであり、複数のスレッドから同時に呼び出すことができます。  ただし、これらの場合でも、関連する同期によってはクエリの処理速度が著しく低下する場合があります。  
+  
+> [!NOTE]
+>  これは、クエリ内に <xref:System.Console.WriteLine%2A> への呼び出しをいくつか挿入することでテストできます。  このメソッドは、ドキュメント例でデモのために使用されています。必要がない限り並列ループでは使用しないでください。  
+  
+## スレッドの関係に注意する  
+ シングルスレッド アパートメント \(STA: Single\-Threaded Apartment\) コンポーネント向けの COM 相互運用性、Windows フォーム、WPF \(Windows Presentation Foundation\) などのテクノロジでは、特定のスレッドで実行するコードを必要とするスレッドの関係が制限される場合があります。  たとえば、Windows フォームと WPF では、コントロールへのアクセスは、そのコントロールが作成されたスレッド上でしか行うことができません。  つまり、例を挙げると、UI スレッド上のみで処理をスケジュールするようにスレッド スケジューラを構成しない限り、並列ループからはリスト コントロールを更新できません。  詳細については、「[How to: Schedule Work on the User Interface \(UI\) Thread](../Topic/How%20to:%20Schedule%20Work%20on%20the%20User%20Interface%20\(UI\)%20Thread.md)」を参照してください。  
+  
+## Parallel.Invoke によって呼び出されるデリゲートで待機する場合は注意する  
+ 状況によっては、タスク並列ライブラリでタスクをインライン展開します。つまり、現在実行されているスレッドでそのタスクが実行されます \(詳細については、「[Task Schedulers](../Topic/Task%20Schedulers.md)」を参照してください\)。場合によっては、このパフォーマンスの最適化により、デッドロックが発生することがあります。  たとえば、2 つのタスクで同じデリゲート コードを実行するとします。また、そのデリゲート コードは、イベントが発生することを通知し、もう一方のタスクが通知するまで待機するとします。  この場合、2 番目のタスクが 1 番目のタスクと同じスレッド上にインライン展開され、1 番目のタスクが待機状態になると、2 番目のタスクはイベントを通知できなくなってしまいます。  このような問題を避けるため、待機操作に対してタイムアウトを指定するか、明示的なスレッド コンストラクターを使用して、一方のタスクが他方のタスクをブロックしないようにすることができます。  
+  
+## ForEach、For、および ForAll の反復処理が常に並列実行されるとは限らないことを理解する  
+ <xref:System.Threading.Tasks.Parallel.For%2A>、<xref:System.Threading.Tasks.Parallel.ForEach%2A>、または <xref:System.Linq.ParallelEnumerable.ForAll%2A> の各ループにおける個々の反復処理が必ずしも並列実行されるとは限らないことに注意してください。  したがって、反復処理の並列実行の正確性、または特定の順序による反復処理の実行の正確性に依存するコードは記述しないようにしてください。  たとえば、次のコードではデッドロックが発生する可能性があります。  
+  
+ [!code-csharp[TPL_Pitfalls#01](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_pitfalls/cs/pitfalls.cs#01)]
+ [!code-vb[TPL_Pitfalls#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_pitfalls/vb/pitfalls_vb.vb#01)]  
+  
+ この例では、1 つの反復処理はイベントを設定し、その他の反復処理はそのイベントを待機します。  待機の反復処理は、イベント設定の反復処理が完了するまで完了できません。  ただし、待機の反復処理によって、並列ループの実行に使用されるすべてのスレッドがブロックされ、イベント設定の反復処理がまったく実行されなくなる可能性があります。  この場合、イベント設定の反復処理が実行されず、待機の反復処理が待機したままの状態になるデッドロックが発生します。  
+  
+ つまり、処理を適切に進めるには、並列ループの特定の反復処理でそのループの別の反復処理を待機するのは避ける必要があります。  並列ループにおいて、反復処理が逆の順序で順次スケジュールされた場合、デッドロックが発生します。  
+  
+## UI スレッドでの並列ループの実行は避ける  
+ アプリケーションのユーザー インターフェイス \(UI\) では、その応答性を保つ必要があります。  並列化が必要になる量の処理が 1 つの操作で行われる場合、その操作を UI スレッドで実行するのは良い方法ではありません。代わりに、バックグラウンド スレッドで実行されるその操作をオフロードしてください。  たとえば、特定のデータを計算し、その結果を UI コントロールに表示するために、並列ループを使用する場合は、UI イベント ハンドラーで直接実行するのではなく、タスク インスタンス内でループを実行することを検討する必要があります。主な計算が完了したときにだけ、UI 更新を UI スレッドにマーシャリングするようにします。  
+  
+ UI スレッドで並列ループを実行する場合は、そのループ内から UI コントロールを更新しないように注意する必要があります。  UI スレッドで実行されている並列ループ内から UI コントロールを更新しようとすると、UI 更新の呼び出し方法によっては、状態の破損、例外、更新の遅れ、さらにはデッドロックが発生する場合があります。  次の例では、並列ループが実行されている UI スレッドは、すべての反復処理が完了するまでループによってブロックされます。  ただし、このループの反復処理がバックグラウンド スレッドで実行されると \(<xref:System.Threading.Tasks.Parallel.For%2A> と同じ処理を行う\)、Invoke の呼び出しによって UI スレッドにメッセージが送信され、そのメッセージが処理されるのを待機することになります。  <xref:System.Threading.Tasks.Parallel.For%2A> を実行中の UI スレッドはブロックされているので、メッセージが処理されることはなく、UI スレッドでデッドロックが発生します。  
+  
+ [!code-csharp[TPL_Pitfalls#02](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_pitfalls/cs/pitfalls.cs#02)]
+ [!code-vb[TPL_Pitfalls#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_pitfalls/vb/pitfalls_vb.vb#02)]  
+  
+ タスク インスタンス内でループを実行することによってこのデッドロックを避ける方法を次の例に示します。  UI スレッドはループによってブロックされず、メッセージを処理できます。  
+  
+ [!code-csharp[TPL_Pitfalls#03](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_pitfalls/cs/pitfalls.cs#03)]
+ [!code-vb[TPL_Pitfalls#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_pitfalls/vb/pitfalls_vb.vb#03)]  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Potential Pitfalls with PLINQ](../../../docs/standard/parallel-programming/potential-pitfalls-with-plinq.md)   
+ [Parallel Programming のパターン: .NET Framework 4 の Understanding and Applying Parallel Patterns](http://go.microsoft.com/fwlink/?LinkID=185142)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/potential-pitfalls-with-plinq.md b/docs/standard/parallel-programming/potential-pitfalls-with-plinq.md
new file mode 100644
index 00000000000..431d26c4470
--- /dev/null
+++ b/docs/standard/parallel-programming/potential-pitfalls-with-plinq.md
@@ -0,0 +1,124 @@
+---
+title: "Potential Pitfalls with PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, pitfalls"
+ms.assetid: 75a38b55-4bc4-488a-87d5-89dbdbdc76a2
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Potential Pitfalls with PLINQ
+PLINQ を使用すると、多くの場合、連続した LINQ to Objects クエリのパフォーマンスが大幅に向上します。  ただし、クエリの実行を並列化すると、複雑性が増すため、シーケンシャル コードにおいて一般的でない問題、またはめったにない問題を引き起こす場合があります。  このトピックでは、PLINQ クエリを記述するときに避ける必要がある点について示します。  
+  
+## 並列が常に速いとは限らないことを理解する  
+ 並列化することで、PLINQ クエリの実行速度が同等の LINQ to Objects より遅くなる場合があります。  基本の方針としては、クエリのソース要素を少なくし、高速化の可能性が低いユーザー デリゲートを使用することです。  ただし、パフォーマンスには多くの要因が関係するため、実際の結果を測定してから、PLINQ を使用するかどうかを決定することをお勧めします。  詳細については、「[Understanding Speedup in PLINQ](../../../docs/standard/parallel-programming/understanding-speedup-in-plinq.md)」を参照してください。  
+  
+## 共有メモリの位置への書き込みを回避する  
+ シーケンシャル コードでは、静的変数またはクラス フィールドから読み取ったり、これらの場所に書き込んだりすることは珍しくありません。  ただし、複数のスレッドがこれらの変数に同時にアクセスしているときは、著しい競合状態になる場合がよくあります。  ロックを使用して変数へのアクセスを同期させることもできますが、同期のコストによってパフォーマンスが低下するおそれがあります。  このため、PLINQ クエリにおける共有状態へのアクセスは、できるだけ回避するか、少なくとも制限することをお勧めします。  
+  
+## 過剰な並列化を避ける  
+ `AsParallel` 演算子を使用すると、ソース コレクションのパーティション分割およびワーカー スレッドの同期でオーバーヘッド コストが発生します。  並列化の利点は、コンピューター上のプロセッサ数によってさらに制限されます。  1 つのプロセッサで複数の計算主体のスレッドを実行しても、高速にはなりません。  このため、クエリを過剰に並列化しないように注意する必要があります。  
+  
+ 過剰な並列化における最も一般的なシナリオは、次のスニペットで示すように、入れ子のクエリが発生することです。  
+  
+ [!code-csharp[PLINQ#20](../../../samples/snippets/csharp/VS_Snippets_Misc/plinq/cs/plinqsamples.cs#20)]
+ [!code-vb[PLINQ#20](../../../samples/snippets/visualbasic/VS_Snippets_Misc/plinq/vb/plinq2_vb.vb#20)]  
+  
+ この場合、次の条件のうち 1 つ以上が適用されない限り、外部データ ソース \(customers\) のみを並列化するのが最適です。  
+  
+-   内部データ ソース \(cust.Orders\) が非常に長い。  
+  
+-   各順序で負荷の大きい計算を実行している \(この例で示した操作の負荷は大きくありません\)。  
+  
+-   対象のシステムに、`cust.Orders` でクエリを並列化して生成されるスレッドの数を十分に処理できるプロセッサが備わっている。  
+  
+ ほとんどの場合、適切なクエリの形を決定する最適な方法は、テストして計測することです。  詳細については、「[How to: Measure PLINQ Query Performance](../../../docs/standard/parallel-programming/how-to-measure-plinq-query-performance.md)」を参照してください。  
+  
+## スレッド セーフでないメソッドへの呼び出しを回避する  
+ スレッド セーフでないインスタンス メソッドを PLINQ クエリから記述すると、プログラムで検知されない可能性があるデータ破損が発生するおそれがあります。  例外が発生する可能性もあります。  次の例では、複数のスレッドが、クラスでサポートされていない `Filestream.Write` メソッドの同時呼び出しを試みます。  
+  
+```vb  
+Dim fs As FileStream = File.OpenWrite(…)  
+a.Where(...).OrderBy(...).Select(...).ForAll(Sub(x) fs.Write(x))  
+```  
+  
+```csharp  
+FileStream fs = File.OpenWrite(...);  
+a.Where(...).OrderBy(...).Select(...).ForAll(x => fs.Write(x));  
+```  
+  
+## スレッド セーフなメソッドへの呼び出しを制限する  
+ .NET Framework のほとんどの静的メソッドはスレッド セーフであり、複数のスレッドから同時に呼び出すことができます。  ただし、これらの場合でも、関連する同期によってはクエリの処理速度が著しく低下する場合があります。  
+  
+> [!NOTE]
+>  これは、クエリ内に <xref:System.Console.WriteLine%2A> への呼び出しをいくつか挿入することでテストできます。  このメソッドは、ドキュメント例でデモのために使用されています。PLINQ クエリでは使用しないでください。  
+  
+## 不要な並べ替え操作を回避する  
+ PLINQ を使用して 1 つのクエリを並列で実行すると、ソース シーケンスがパーティションに分割され、複数のスレッド上で同時に操作できるようになります。  既定では、パーティションが処理される順序と生成される結果は予測できません \(`OrderBy` などの演算子を除く\)。  PLINQ に、ソース シーケンスの順序を維持するように指示することもできますが、この操作はパフォーマンスの低下を招きます。  推奨される手順は、可能であれば、順序の維持に依存しないようにクエリを構成することです。  詳細については、「[Order Preservation in PLINQ](../../../docs/standard/parallel-programming/order-preservation-in-plinq.md)」を参照してください。  
+  
+## できる限り ForEach より ForAll を優先する  
+ PLINQ では複数のスレッドで 1 つのクエリを実行しますが、`foreach` ループ \(Visual Basic の場合は `For Each`\) の結果を処理する場合、クエリ結果は 1 つのスレッドにマージされてから列挙子によって連続してアクセスされる必要があります。  これが避けられない場合もありますが、可能な場合は常に、`ForAll` メソッドを使用して各スレッドで固有の結果を出力できるようにします。たとえば、<xref:System.Collections.Concurrent.ConcurrentBag%601?displayProperty=fullName> などのスレッド セーフなコレクションに書き込みます。  
+  
+ つまり、同じ問題が <xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName>`source.AsParallel().Where().ForAll(...)` に厳密にどのように適用されます。  
+  
+ `Parallel.ForEach(source.AsParallel().Where(), ...)`.  
+  
+## スレッドの関係に注意する  
+ シングルスレッド アパートメント \(STA: Single\-Threaded Apartment\) コンポーネント向けの COM 相互運用性、Windows フォーム、WPF \(Windows Presentation Foundation\) などのテクノロジでは、特定のスレッドで実行するコードを必要とするスレッドの関係が制限される場合があります。  たとえば、Windows フォームと WPF では、コントロールへのアクセスは、そのコントロールが作成されたスレッド上でしか行うことができません。  PLINQ クエリで Windows フォーム コントロールの共有状態にアクセスしようとすると、デバッガーを実行中である場合は例外が発生します \(この設定はオフにできます\)。ただし、クエリが UI スレッドで処理される場合は、コードが実行されるスレッドは 1 つだけであるため、クエリ結果を列挙する `foreach` ループからコントロールにアクセスできます。  
+  
+## ForEach、For、および ForAll の反復処理が常に並列実行されるとは限らないことを理解する  
+ <xref:System.Threading.Tasks.Parallel.For%2A?displayProperty=fullName>、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName>、または <xref:System.Linq.ParallelEnumerable.ForAll%2A> の各ループにおける個々の反復処理が必ずしも並列実行されるとは限らないことに注意してください。  したがって、反復処理の並列実行の正確性、または特定の順序による反復処理の実行の正確性に依存するコードは記述しないようにしてください。  
+  
+ たとえば、次のコードではデッドロックが発生する可能性があります。  
+  
+```vb  
+Dim mre = New ManualResetEventSlim()  
+    Enumerable.Range(0, ProcessorCount * 100).AsParallel().ForAll(Sub(j)   
+  
+                                                     If j = Environment.ProcessorCount Then  
+  
+                                                         Console.WriteLine("Set on {0} with value of {1}", Thread.CurrentThread.ManagedThreadId, j)  
+                                                         mre.Set()  
+  
+                                                     Else  
+  
+                                                         Console.WriteLine("Waiting on {0} with value of {1}", Thread.CurrentThread.ManagedThreadId, j)  
+                                                         mre.Wait()  
+                                                     End If  
+    End Sub) ' deadlocks  
+```  
+  
+```csharp  
+ManualResetEventSlim mre = new ManualResetEventSlim();  
+            Enumerable.Range(0, ProcessorCount * 100).AsParallel().ForAll((j) =>  
+            {  
+                if (j == Environment.ProcessorCount)  
+                {  
+                    Console.WriteLine("Set on {0} with value of {1}", Thread.CurrentThread.ManagedThreadId, j);  
+                    mre.Set();  
+                }  
+                else  
+                {  
+                    Console.WriteLine("Waiting on {0} with value of {1}", Thread.CurrentThread.ManagedThreadId, j);  
+                    mre.Wait();  
+                }  
+            }); //deadlocks  
+```  
+  
+ この例では、1 つの反復処理はイベントを設定し、その他の反復処理はそのイベントを待機します。  待機の反復処理は、イベント設定の反復処理が完了するまで完了できません。  ただし、待機の反復処理によって、並列ループの実行に使用されるすべてのスレッドがブロックされ、イベント設定の反復処理がまったく実行されなくなる可能性があります。  この場合、イベント設定の反復処理が実行されず、待機の反復処理が待機したままの状態になるデッドロックが発生します。  
+  
+ つまり、処理を適切に進めるには、並列ループの特定の反復処理でそのループの別の反復処理を待機するのは避ける必要があります。  並列ループにおいて、反復処理が逆の順序で順次スケジュールされた場合、デッドロックが発生します。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/task-based-asynchronous-programming.md b/docs/standard/parallel-programming/task-based-asynchronous-programming.md
new file mode 100644
index 00000000000..b869ed5ffd2
--- /dev/null
+++ b/docs/standard/parallel-programming/task-based-asynchronous-programming.md
@@ -0,0 +1,278 @@
+---
+title: "Task Parallelism (Task Parallel Library) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "parallelism, task"
+ms.assetid: 458b5e69-5210-45e5-bc44-3888f86abd6f
+caps.latest.revision: 51
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 47
+---
+# Task Parallelism (Task Parallel Library)
+タスク並列ライブラリ \(TPL\) は、非同期操作を表す*タスク*の概念に基づいています。  いくつかの点で、タスクはスレッドまたは <xref:System.Threading.ThreadPool> 作業項目に似ていますが、高いレベルで抽象化しています。  *タスクの並列化*とは、1 つ以上の独立したタスクを同時に実行することです。  タスクが提供する主な利点は次の 2 つです。  
+  
+-   システム リソースをより効率的かつスケーラブルに利用する。  
+  
+     背後では、タスクは <xref:System.Threading.ThreadPool> へのキューとして配置されます。これはスレッド数を判別および調整し、負荷分散によってスループットを最大化する、アルゴリズムを使用して強化されています。  これによりタスクが比較的軽量化されるため、多数のタスクを作成して粒度の高い並列化を実現できます。  
+  
+-   スレッドまたは作業項目より、プログラムによる制御を詳細に行うことができる。  
+  
+     タスクおよびタスクを中心に構築されたフレームワークでは、待機、キャンセル、継続、信頼性の高い例外処理、詳細なステータス、カスタムのスケジュール設定などをサポートする豊富な API が用意されています。  
+  
+ この 2 つの理由により、.NET Framework では、マルチスレッド、非同期および並列コードを記述するために、TPL で API を使用することをお勧めしています。  
+  
+## 暗黙的なタスクの作成と実行  
+ <xref:System.Threading.Tasks.Parallel.Invoke%2A?displayProperty=fullName> メソッドには、任意の数のステートメントを同時に実行する便利な方法が用意されています。  作業項目ごとに <xref:System.Action> デリゲートに渡すだけです。  これらのデリゲートを最も簡単に作成するには、ラムダ式を使用します。  ラムダ式では、名前付きメソッドを呼び出したり、コード インラインを指定したりできます。  次の例では、2 つのタスクを同時に作成および開始する基本の <xref:System.Threading.Tasks.Parallel.Invoke%2A> 呼び出しを示しています。  最初のタスクは `DoSomeWork` という名のメソッドを呼び出すラムダ式によって表され、2 番目のタスクは `DoSomeOtherWork` という名のメソッドを呼び出すラムダ式によって表されます。  
+  
+> [!NOTE]
+>  ここでは、ラムダ式を使用して TPL でデリゲートを定義します。  C\# または Visual Basic のラムダ式についての情報が必要な場合は、「[Lambda Expressions in PLINQ and TPL](../../../docs/standard/parallel-programming/lambda-expressions-in-plinq-and-tpl.md)」を参照してください。  
+  
+ [!code-csharp[TPL#21](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl/cs/tpl.cs#21)]
+ [!code-vb[TPL#21](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl/vb/tpl_vb.vb#21)]  
+  
+> [!NOTE]
+>  <xref:System.Threading.Tasks.Task> によって背後で作成される <xref:System.Threading.Tasks.Parallel.Invoke%2A> インスタンスの数は、指定するデリゲートの数と等しくなくてもかまいません。  TPL では、特に多数のデリゲートによるさまざまな最適化方法を採用しています。  
+  
+ 詳細については、「[How to: Use Parallel.Invoke to Execute Parallel Operations](../../../docs/standard/parallel-programming/how-to-use-parallel-invoke-to-execute-parallel-operations.md)」を参照してください。  
+  
+ タスクの実行をさらに制御する場合、またはタスクから値を返す場合、<xref:System.Threading.Tasks.Task> オブジェクトをより明示的に操作する必要があります。  
+  
+## 明示的なタスクの作成と実行  
+ 値を返さないタスクは、<xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスによって表されます。  値を返すタスクは、<xref:System.Threading.Tasks.Task%601?displayProperty=fullName> から継承された <xref:System.Threading.Tasks.Task> クラスで表されます。  タスク オブジェクトはインフラストラクチャの詳細を処理し、タスクの有効期間内に呼び出し元のスレッドからアクセスできるメソッドとプロパティを提供します。  たとえば、タスクの <xref:System.Threading.Tasks.Task.Status%2A> プロパティに任意のタイミングでアクセスして、タスクが開始されたか、完了まで実行されたか、取り消されたか、または例外がスローされたかどうかを確認できます。  状態は、<xref:System.Threading.Tasks.TaskStatus> 列挙型によって表されます。  
+  
+ タスクを作成するときは、タスクが実行するコードをカプセル化するユーザー デリゲートを指定します。  このデリゲートは名前付きデリゲート、匿名メソッド、またはラムダ式として表すことができます。  ラムダ式には、次の例で示すような名前付きメソッドへの呼び出しを含めることができます。  この例は <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> メソッドの呼び出しを含み、コンソール モードのアプリケーションが終了する前にタスクの実行が完了するようにしていることに注意してください。  
+  
+ [!code-csharp[TPL_TaskIntro#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/lambda1.cs#1)]
+ [!code-vb[TPL_TaskIntro#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/lambda1.vb#1)]  
+  
+ <xref:System.Threading.Tasks.Task.Run%2A?displayProperty=fullName> メソッドを使用して、一度の操作でタスクを作成および開始することもできます。  タスクを管理するため、<xref:System.Threading.Tasks.Task.Run%2A> メソッドは、現在のスレッドに関連付けられたタスク スケジューラにかかわらず、既定のタスク スケジューラを使用します。  <xref:System.Threading.Tasks.Task.Run%2A> メソッドは、タスクの作成とスケジュールの詳細な制御が必要ない場合に、タスクを作成および開始するために適しています。  
+  
+ [!code-csharp[TPL_TaskIntro#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/run1.cs#2)]
+ [!code-vb[TPL_TaskIntro#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/run1.vb#2)]  
+  
+ <xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドを使用して、一度の操作でタスクを作成および開始することもできます。  次の例に示すように、作成とスケジュール設定を分ける必要がない場合、追加のタスク作成オプションまたは特定のスケジューラを使う必要がある場合、または <xref:System.Threading.Tasks.Task.AsyncState%2A> のプロパティを使用して、タスクに追加の状態を渡す必要がある場合は、このメソッドを使用します。  
+  
+ [!code-csharp[TPL_TaskIntro#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/startnew1.cs#3)]
+ [!code-vb[TPL_TaskIntro#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/startnew1.vb#3)]  
+  
+ <xref:System.Threading.Tasks.Task> および <xref:System.Threading.Tasks.Task%601> はそれぞれ、<xref:System.Threading.Tasks.Task.Factory%2A> の既定のインスタンスを返す、静的な <xref:System.Threading.Tasks.TaskFactory> プロパティを公開するので、メソッドを `Task.Factory.StartNew()` として呼び出すことができます。  また、次の例のタスクは <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> 型であるため、それぞれのタスクは計算の結果を格納するパブリックな <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティを持ちます。  タスクは非同期に実行され、任意の順序で完了されることがあります。  計算が終了する前に <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティにアクセスした場合、このプロパティは値が使用可能な状態になるまで呼び出しスレッドをブロックします。  
+  
+ [!code-csharp[TPL_TaskIntro#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/result1.cs#4)]
+ [!code-vb[TPL_TaskIntro#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/result1.vb#4)]  
+  
+ 詳細については、「[How to: Return a Value from a Task](../../../docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md)」を参照してください。  
+  
+ ラムダ式を使用してデリゲートを作成すると、ソース コード内の該当ポイントで参照できるすべての変数にアクセスできます。  ただし、特にループ内では、ラムダによって変数が予想どおりにキャプチャされない場合があります。  ラムダでは、反復処理が実行されるたびに変更された値をキャプチャするのではなく、最終値だけがキャプチャされます。  この問題を説明する例を次に示します。  これは `CustomData` オブジェクトをインスタンス化するラムダ式にループ カウンターを渡し、オブジェクトの識別子としてループ カウンターを使用します。  この例の出力結果が示すように、`CustomData` の各オブジェクトは同じ識別子を持ちます。  
+  
+ [!code-csharp[TPL_TaskIntro#22](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/iteration1b.cs#22)]
+ [!code-vb[TPL_TaskIntro#22](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/iteration1b.vb#22)]  
+  
+ 反復処理が実行されるたびに値にアクセスできるようにするには、コンストラクターによって状態オブジェクトをタスクに提供します。  次の例では、ラムダ式に渡される `CustomData` オブジェクトを作成するときに、ループ カウンターを使用して前の例を変更しています。  この例の出力結果が示すように、`CustomData` の各オブジェクトは、オブジェクトがインスタンス化されたときのループ カウンターの値に基づいて、一意の識別子を持ちます。  
+  
+ [!code-csharp[TPL_TaskIntro#21](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/iteration1a.cs#21)]
+ [!code-vb[TPL_TaskIntro#21](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/iteration1a.vb#21)]  
+  
+ この状態は、タスク デリゲートに引数として渡されます。<xref:System.Threading.Tasks.Task.AsyncState%2A?displayProperty=fullName> プロパティを使用することで、タスク オブジェクトから状態にアクセスできます。  次の例は、前の例を変更したものです。  <xref:System.Threading.Tasks.Task.AsyncState%2A> プロパティを使用して、ラムダ式に渡される `CustomData` オブジェクトに関する情報を表示します。  
+  
+ [!code-csharp[TPL_TaskIntro#23](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/asyncstate.cs#23)]
+ [!code-vb[TPL_TaskIntro#23](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/asyncstate.vb#23)]  
+  
+## タスク ID  
+ 各タスクは、アプリケーション ドメイン内で一意に識別され、<xref:System.Threading.Tasks.Task.Id%2A?displayProperty=fullName> プロパティを使用してアクセスできる整数の ID を受け取ります。  この ID は、Visual Studio デバッガーの **\[並列スタック\]** ウィンドウおよび **\[タスク\]** ウィンドウでタスク情報を確認する場合に役立ちます。  この ID は ID が要求されるまでは作成されません。したがって、タスクの ID はプログラムが実行されるたびに異なる場合があります。  デバッガーでタスク ID を表示する方法の詳細については、「[\[タスク\] ウィンドウの使用](../Topic/Using%20the%20Tasks%20Window.md)」と「[\[並列スタック\] ウィンドウの使用](../Topic/Using%20the%20Parallel%20Stacks%20Window.md)」を参照してください。  
+  
+## タスクの作成オプション  
+ タスクを作成するほとんどの API には、<xref:System.Threading.Tasks.TaskCreationOptions> パラメーターを受け入れるオーバーロードが用意されています。  これらのオプションのいずれかを指定することで、タスク スケジューラにスレッド プール上のタスクをスケジュールする方法を指示できます。  タスクの作成オプションの一覧を次に示します。  
+  
+|<xref:System.Threading.Tasks.TaskCreationOptions> パラメーター値|説明|  
+|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|オプションを指定しなかった場合の既定値です。  スケジューラは既定のヒューリスティックを使用してタスクをスケジュールします。|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|先に作成されたタスクが先に実行され、後から作成されたタスクは後から実行されるように、タスクのスケジュールを指定します。|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|実行に時間のかかる操作を表すタスクであることを示します。|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|子が存在する場合、現在のタスクにアタッチされた子としてタスクを作成するように指定します。  詳細については、「[Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)」を参照してください。|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|内側のタスクが `AttachedToParent` オプションを指定すると、そのタスクはアタッチされた子タスクにならないことを指定します。|  
+|<xref:System.Threading.Tasks.TaskCreationOptions>|<xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> または <xref:System.Threading.Tasks.Task%601.ContinueWith%2A?displayProperty=fullName> などのメソッドを特定のタスクから呼び出して作成されたタスクのタスク スケジューラは、このタスクが実行されているスケジューラではなく、既定のスケジューラであることを指定します。|  
+  
+ このオプションは、ビットごとの **OR** 演算を使用して組み合わせることができます。  次の例は、<xref:System.Threading.Tasks.TaskCreationOptions> オプションと <xref:System.Threading.Tasks.TaskContinuationOptions> オプションが指定されたタスクを示しています。  
+  
+ [!code-csharp[TPL_TaskIntro#03](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/taskintro.cs#03)]
+ [!code-vb[TPL_TaskIntro#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/tpl_intro.vb#03)]  
+  
+## タスク、スレッド、およびカルチャ  
+ 各スレッドにはカルチャと UI カルチャが関連付けられています。それぞれのカルチャは <xref:System.Threading.Thread.CurrentCulture%2A?displayProperty=fullName> と <xref:System.Threading.Thread.CurrentUICulture%2A?displayProperty=fullName> プロパティにより定義されています。  スレッドのカルチャは、書式設定、解析、並べ替え、文字列比較などの操作で使用されます。  スレッドの UI カルチャはリソースの検索で使用されます。  通常、<xref:System.Globalization.CultureInfo.DefaultThreadCurrentCulture%2A?displayProperty=fullName> プロパティと <xref:System.Globalization.CultureInfo.DefaultThreadCurrentUICulture%2A?displayProperty=fullName> プロパティを使用してアプリケーション ドメイン内のすべてのスレッドの既定のカルチャを指定していない限り、スレッドの既定のカルチャと既定の UI カルチャはシステム カルチャによって定義されます。  スレッドのカルチャを明示的に設定して新しいスレッドを開始すると、新しいスレッドは呼び出し元スレッドのカルチャを継承せず、既定のシステム カルチャがそのカルチャとして使用されます。  [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以前のバージョンの .NET Framework を対象とするアプリのタスク ベース プログラミング モデルは、この方針に準拠します。  
+  
+> [!IMPORTANT]
+>  呼び出し元スレッドのカルチャは、タスクのコンテキストの一部として、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] で*実行される*アプリではなく、[!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を*対象とした*アプリに適用されます。  Visual Studio 内部でプロジェクトを作成する場合、**\[新しいプロジェクト\]** ダイアログ ボックスの上部にあるドロップダウン リストから特定バージョンの .NET Framework を選択すると、そのバージョンを対象にできます。また、Visual Studio 外部では <xref:System.Runtime.Versioning.TargetFrameworkAttribute> 属性を使用できます。  [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以前のバージョンの .NET Framework を対象とするアプリ、または特定のバージョンの .NET Framework を対象としないアプリでは、引き続きタスクのカルチャは、タスクが実行されているスレッドのカルチャによって決まります。  
+  
+ [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以降を対象とするアプリでは、タスクがスレッド プールのスレッドで非同期に実行されている場合でも、呼び出し元スレッドのカルチャが各タスクに継承されます。  
+  
+ 簡単な例を次に示します。  <xref:System.Runtime.Versioning.TargetFrameworkAttribute> 属性を使用して [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] を対象とし、アプリの現在のカルチャをフランス語 \(フランス\)、またはフランス語 \(フランス\) が現在のカルチャである場合は英語 \(米国\) に変更します。  次に、変更後のカルチャの通貨値として書式設定された数値を返す `formatDelegate` という名前のデリゲートを呼び出します。  デリゲートは、同期タスクまたは非同期タスクのいずれの場合でも、予期される結果を返すことに注意してください。これは、非同期タスクは呼び出し元スレッドのカルチャを継承するためです。  
+  
+ [!code-csharp[System.Globalization.CultureInfo.Class.Async#5](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.globalization.cultureinfo.class.async/cs/asyncculture1.cs#5)]
+ [!code-vb[System.Globalization.CultureInfo.Class.Async#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.globalization.cultureinfo.class.async/vb/asyncculture1.vb#5)]  
+  
+ Visual Studio を使用している場合、プロジェクトを **\[新しいプロジェクト\]** ダイアログで作成する際に、<xref:System.Runtime.Versioning.TargetFrameworkAttribute> 属性を省略して、代わりに .NET Framework 4.6 を対象として選択できます。  
+  
+ [!INCLUDE[net_v46](../../../includes/net-v46-md.md)] 以前のバージョンの .NET Framework を対象とするアプリの動作が出力に反映されるようにするため、ソース コードから <xref:System.Runtime.Versioning.TargetFrameworkAttribute> 属性を削除します。  出力には、呼び出し元スレッドのカルチャではなく、既定のシステム カルチャの書式指定規則が反映されます。  
+  
+ 非同期タスクとカルチャの詳細については、「<xref:System.Globalization.CultureInfo>」トピックの「カルチャおよび非同期タスク ベースの操作」を参照してください。  
+  
+## タスクの継続の作成  
+ <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> および <xref:System.Threading.Tasks.Task%601.ContinueWith%2A?displayProperty=fullName> メソッドで、*継続元タスク*が終了したときに開始されるタスクを指定できます。  継続タスクのデリゲートは継続元タスクへの参照を渡し、継続元タスクのステータスを調査できるようにし、また <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> プロパティの値を取得して、継続元の出力を継続への入力として使用できるようにします。  
+  
+ 次の例では、`getData` タスクは <xref:System.Threading.Tasks.TaskFactory.StartNew%60%601%28System.Func%7B%60%600%7D%29?displayProperty=fullName> メソッドの呼び出しによって開始されます。  `processData` タスクは `getData` が終了したときに自動的に開始され、`displayData` は `processData` が終了したときに開始されます。  `getData` は、`processData` タスクの `getData` プロパティを使用して <xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> タスクがアクセス可能な、整数の配列を生成します。  `processData` はその配列を処理し、<xref:System.Threading.Tasks.Task%601.ContinueWith%60%601%28System.Func%7BSystem.Threading.Tasks.Task%7B%600%7D%2C%60%600%7D%29?displayProperty=fullName> メソッドに渡されるラムダ式の戻り値の型から推論される型を持つ結果を返します。  `displayData` タスクは、`processData` が終了したときに自動的に実行され、<xref:System.Tuple%603> ラムダ式が返した `processData` オブジェクトは、`displayData` タスクの `processData` プロパティを使用して、<xref:System.Threading.Tasks.Task%601.Result%2A?displayProperty=fullName> タスクからアクセス可能です。  `displayData` タスクは `processData` タスクから結果を受け取り、同様の方法を使用して \(プログラムで使用できるようになったと\) 推論される型を持つ結果を <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティで生成します。  
+  
+ [!code-csharp[TPL_TaskIntro#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/continuations1.cs#5)]
+ [!code-vb[TPL_TaskIntro#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/continuations1.vb#5)]  
+  
+ <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> がインスタンス メソッドであるため、<xref:System.Threading.Tasks.Task%601> のオブジェクトをそれぞれの継続元タスクにインスタンス化する代わりに、メソッド呼び出しを連結することができます。  次の例は前の例と機能的には同じものですが、呼び出しを <xref:System.Threading.Tasks.Task.ContinueWith%2A?displayProperty=fullName> メソッドに連結している点が異なります。  メソッドの呼び出しチェーンによって返される <xref:System.Threading.Tasks.Task%601> オブジェクトが最終的な継続タスクであることに注意してください。  
+  
+ [!code-csharp[TPL_TaskIntro#24](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/continuations2.cs#24)]
+ [!code-vb[TPL_TaskIntro#24](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/continuations2.vb#24)]  
+  
+ <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A> メソッドおよび <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A> メソッドを使用すると、複数のタスクから継続できます。  
+  
+ 詳細については、「[Chaining Tasks by Using Continuation Tasks](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)」を参照してください。  
+  
+## デタッチされた子タスクの作成  
+ タスクで実行中のユーザー コードで新しいタスクを作成し、<xref:System.Threading.Tasks.TaskCreationOptions> オプションを指定しない場合、新しいタスクはどのような方法でも親タスクとは同期されません。  非同期タスクのこの型は、*デタッチされた入れ子のタスク*、または*デタッチされた子タスク*と呼ばれます。  次の例は、デタッチされた子タスクを 1 つ作成するタスクを示しています。  
+  
+ [!code-csharp[TPL_TaskIntro#07](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/taskintro.cs#07)]
+ [!code-vb[TPL_TaskIntro#07](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/tpl_intro.vb#07)]  
+  
+ 親タスクはデタッチされた子タスクの終了を待機しないことに注意してください。  
+  
+## 子タスクの作成  
+ タスクで実行中のユーザー コードで <xref:System.Threading.Tasks.TaskCreationOptions> オプションを使用してタスクを作成すると、新しいタスクは親タスクに*アタッチされた子タスク*になります。  <xref:System.Threading.Tasks.TaskCreationOptions> オプションを使用すると、構成されたタスクの並列化を表現できます。親タスクは、すべてのアタッチされた子タスクが終了するのを暗黙的に待機するためです。  次の例は、アタッチされた子タスクを 10 個作成する親タスクを示しています。  この例は <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> メソッドを呼び出して親タスクの完了を待機しているが、アタッチされた子タスクの完了を明示的には待機する必要がないことに注意してください。  
+  
+ [!code-csharp[TPL_TaskIntro#8](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/child1.cs#8)]
+ [!code-vb[TPL_TaskIntro#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/child1.vb#8)]  
+  
+ 親タスクは <xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用して、他のタスクが親タスクにアタッチすることを防ぐことができます。  詳細については、「[Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)」を参照してください。  
+  
+## タスクの完了を待機する  
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型と <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> 型には、タスクが終了するまで待機できる <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Tasks.Task%601.Wait%2A?displayProperty=fullName> メソッドのオーバーロードがいくつか用意されています。  さらに、静的な <xref:System.Threading.Tasks.Task.WaitAll%2A?displayProperty=fullName> メソッドおよび <xref:System.Threading.Tasks.Task.WaitAny%2A?displayProperty=fullName> メソッドのオーバーロードにより、一部またはすべてのタスクの配列が終了するまで待機できます。  
+  
+ 通常は、タスクを待機するのは次のいずれかの場合です。  
+  
+-   メイン スレッドが、タスクで計算される最終的な結果に依存する。  
+  
+-   タスクからスローされる可能性のある例外を処理する必要がある。  
+  
+-   アプリケーションは、すべてのタスクが実行を完了する前に終了する場合があります。  たとえば、コンソール アプリケーションは `Main` \(アプリケーションのエントリ ポイント\) のすべての同期コードが実行されると、すぐに終了します。  
+  
+ 次の例は、例外処理を含まない基本的なパターンを示しています。  
+  
+ [!code-csharp[TPL_TaskIntro#06](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_taskintro/cs/taskintro.cs#06)]
+ [!code-vb[TPL_TaskIntro#06](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_taskintro/vb/tpl_intro.vb#06)]  
+  
+ 例外処理を示す例については、「[NIB: How to: Handle Exceptions Thrown by Tasks](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)」を参照してください。  
+  
+ タイムアウトを指定できるオーバーロードおよび別の <xref:System.Threading.CancellationToken> を入力パラメーターとして受け取るオーバーロードの中には、プログラムによって、またはユーザーの入力に応答して待機自体を取り消すことができるものがあります。  
+  
+ タスクを待機する場合は、<xref:System.Threading.Tasks.TaskCreationOptions?displayProperty=fullName> オプションを使用して作成されたタスクのすべての子タスクを暗黙的に待機します。  タスクが既に完了している場合、直ちに <xref:System.Threading.Tasks.Task.Wait%2A?displayProperty=fullName> が返されます。  タスクで発生した例外は、<xref:System.Threading.Tasks.Task.Wait%2A> メソッドがタスクの完了後に呼び出された場合でも <xref:System.Threading.Tasks.Task.Wait%2A> メソッドによってスローされます。  
+  
+ 詳細については、「[How to: Wait on One or More Tasks to Complete](../Topic/How%20to:%20Wait%20on%20One%20or%20More%20Tasks%20to%20Complete.md)」を参照してください。  
+  
+## タスクを構成する  
+ <xref:System.Threading.Tasks.Task> と <xref:System.Threading.Tasks.Task%601> クラスは複数のメソッドを提供し、これらは共通のパターンを実装したり、C\#、[!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]、および F\# によって提供される非同期言語機能を使うために、複数のタスクを構成するのに役立ちます。  このセクションでは <xref:System.Threading.Tasks.Task.WhenAll%2A>、<xref:System.Threading.Tasks.Task.WhenAny%2A>、<xref:System.Threading.Tasks.Task.Delay%2A> および <xref:System.Threading.Tasks.Task.FromResult%2A> メソッドについて説明します。  
+  
+### Task.WhenAll  
+ <xref:System.Threading.Tasks.Task.WhenAll%2A?displayProperty=fullName> メソッドは、複数の <xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> オブジェクトが終了するのを、非同期的に待機します。  提供されるオーバーロード バージョンにより、不均一なタスクのセットを待機することができます。  たとえば、1 回のメソッド呼び出しで完了する、複数の <xref:System.Threading.Tasks.Task> および <xref:System.Threading.Tasks.Task%601> オブジェクトを待機できます。  
+  
+### Task.WhenAny  
+ <xref:System.Threading.Tasks.Task.WhenAny%2A?displayProperty=fullName> メソッドは、複数の <xref:System.Threading.Tasks.Task> の 1 つ、または <xref:System.Threading.Tasks.Task%601> オブジェクトが終了するのを、非同期的に待機します。  <xref:System.Threading.Tasks.Task.WhenAll%2A?displayProperty=fullName> メソッドと同様に、このメソッドはオーバーロード バージョンを提供し、これによって不均一なタスクのセットを待機することができます。  <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドは、特に次のシナリオに役立ちます。  
+  
+-   重複した操作。  多くの方法で実行できるアルゴリズムまたは操作を検討してください。  <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使用すると、最初の操作を完了して残りの操作を取り消すように、操作を選択できます。  
+  
+-   インタリーブされた操作。  複数の操作を開始して、それらの操作のすべてが完了し、各操作が完了したら <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使って結果を処理できるようにします。  1 つの操作が完了したら、1 つ以上の追加タスクを開始できます。  
+  
+-   制限された操作。  <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使用して、前のシナリオを拡張し、同時操作の数を制限することができます。  
+  
+-   有効期限切れの操作。  <xref:System.Threading.Tasks.Task.WhenAny%2A> メソッドを使うと、1 つ以上のタスクと特定の時間後に終了する 1 つのタスクから選択できます。たとえば、<xref:System.Threading.Tasks.Task.Delay%2A> メソッドが返すタスクなどです。  <xref:System.Threading.Tasks.Task.Delay%2A> メソッドについては、次のセクションで説明します。  
+  
+### Task.Delay  
+ <xref:System.Threading.Tasks.Task.Delay%2A?displayProperty=fullName> メソッドは、指定時間後に終了する <xref:System.Threading.Tasks.Task> オブジェクトを生成します。  このメソッドを使用すると、データのポーリングをときどき行うループをビルドしたり、タイムアウトを使用したり、ユーザー入力の処理を遅延させたりすることができます。  
+  
+### Task\(T\).FromResult  
+ <xref:System.Threading.Tasks.Task.FromResult%2A?displayProperty=fullName> メソッドを使用すると、あらかじめ計算された結果を保持する <xref:System.Threading.Tasks.Task%601> オブジェクトを作成できます。  このメソッドは <xref:System.Threading.Tasks.Task%601> オブジェクトの結果があらかじめ計算されている <xref:System.Threading.Tasks.Task%601> オブジェクトを返す、非同期操作を実行する場合に便利です。  キャッシュに保持されている非同期ダウンロード操作の結果を取得する <xref:System.Threading.Tasks.Task.FromResult%2A> の使用例の詳細については、「[How to: Create Pre\-Computed Tasks](../../../docs/standard/parallel-programming/how-to-create-pre-computed-tasks.md)」を参照してください。  
+  
+## タスクでの例外処理  
+ タスクで 1 つ以上の例外がスローされると、例外は <xref:System.AggregateException> 例外でラップされます。  例外はタスクに連結されたスレッドに反映されます。通常は、タスクの終了を待機しているスレッドか、または <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティにアクセスするスレッドです。  この動作では、.NET Framework ポリシーが適用され、既定ではすべてのハンドルされない例外によってプロセスが終了されます。  呼び出し元のコードは `try``catch` ブロックで、次のいずれかを使用して、例外を処理できます。  
+  
+-   <xref:System.Threading.Tasks.Task.Wait%2A> メソッド  
+  
+-   <xref:System.Threading.Tasks.Task.WaitAll%2A> メソッド  
+  
+-   <xref:System.Threading.Tasks.Task.WaitAny%2A> メソッド  
+  
+-   <xref:System.Threading.Tasks.Task%601.Result%2A> プロパティ  
+  
+ 連結しているスレッドでも、タスクがガベージ コレクトされる前に <xref:System.Threading.Tasks.Task.Exception%2A> プロパティにアクセスすることで例外を処理できます。  このプロパティにアクセスすると、ハンドルされない例外が、オブジェクトが最終処理されたときにプロセスを終了する例外の反映動作をトリガーしないようにできます。  
+  
+ 例外とタスクの詳細については、「[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)」と「[NIB: How to: Handle Exceptions Thrown by Tasks](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)」を参照してください。  
+  
+## タスクの取り消し  
+ `Task` クラスは他の処理と連携したキャンセル処理をサポートしており、.NET Framework 4 で導入された <xref:System.Threading.CancellationTokenSource?displayProperty=fullName> クラスおよび <xref:System.Threading.CancellationToken?displayProperty=fullName> クラスと完全に統合されています。  <xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスの多くのコンストラクターは、<xref:System.Threading.CancellationToken> オブジェクトを入力パラメーターとして受け取ります。  <xref:System.Threading.Tasks.TaskFactory.StartNew%2A> および <xref:System.Threading.Tasks.Task.Run%2A> オーバーロードの多くも、<xref:System.Threading.CancellationToken> パラメーターを含みます。  
+  
+ <xref:System.Threading.CancellationTokenSource> クラスを使用すると、トークンを作成し、後でキャンセル要求を発行できます。  このトークンを <xref:System.Threading.Tasks.Task> に引数として渡し、同じトークンをキャンセル要求に応答するユーザー デリゲートで参照します。  
+  
+ 詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」と「[How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)」を参照してください。  
+  
+## TaskFactory クラス  
+ <xref:System.Threading.Tasks.TaskFactory> クラスには、タスクおよび継続タスクの作成と開始について、一般的なパターンをカプセル化する静的メソッドが用意されています。  
+  
+-   最も一般的なパターンは、1 つのステートメントで 1 つのタスクを作成および開始する <xref:System.Threading.Tasks.TaskFactory.StartNew%2A> です。  
+  
+-   複数の継続元から継続タスクを作成する場合は、<xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A> メソッドまたは <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A> メソッドを使用するか、<xref:System.Threading.Tasks.Task%601> クラスの同等のメソッドを使用します。  詳細については、「[Chaining Tasks by Using Continuation Tasks](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)」を参照してください。  
+  
+-   `BeginX` インスタンスまたは `EndX` インスタンスで非同期プログラミング モデルの <xref:System.Threading.Tasks.Task> メソッドおよび <xref:System.Threading.Tasks.Task%601> メソッドをカプセル化するには、<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A> メソッドを使用します。  詳細については、「[TPL and Traditional .NET Framework Asynchronous Programming](../../../docs/standard/parallel-programming/tpl-and-traditional-async-programming.md)」を参照してください。  
+  
+ 既定の <xref:System.Threading.Tasks.TaskFactory> へは、<xref:System.Threading.Tasks.Task> クラスまたは <xref:System.Threading.Tasks.Task%601> クラス上の静的なプロパティとしてアクセスできます。  <xref:System.Threading.Tasks.TaskFactory> を直接インスタンス化し、さまざまなオプションを指定することもできます。たとえば、<xref:System.Threading.CancellationToken>、<xref:System.Threading.Tasks.TaskCreationOptions> オプション、<xref:System.Threading.Tasks.TaskContinuationOptions> オプション、<xref:System.Threading.Tasks.TaskScheduler> などです。  タスク ファクトリを作成するときに指定されるオプションは、タスク ファクトリで作成したすべてのタスクに適用されます。ただし、<xref:System.Threading.Tasks.Task> が <xref:System.Threading.Tasks.TaskCreationOptions> 列挙型を使用して作成された場合は例外で、タスクのオプションによってタスク ファクトリのオプションがオーバーライドされます。  
+  
+## デリゲートなしのタスク  
+ <xref:System.Threading.Tasks.Task> を使用して、固有のユーザー デリゲートではなく外部コンポーネントによって実行される非同期操作をカプセル化する場合があります。  操作が非同期プログラミング モデルの Begin\/End パターンに基づいている場合、<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A> メソッドを使用できます。  そうでない場合は、<xref:System.Threading.Tasks.TaskCompletionSource%601> オブジェクトを使用して、タスク内の操作をラップして、<xref:System.Threading.Tasks.Task> を外部からプログラミング可能にする利点を活用できます。たとえば、例外の反映および継続のサポートです。  詳細については、「<xref:System.Threading.Tasks.TaskCompletionSource%601>」を参照してください。  
+  
+## カスタム スケジューラ  
+ アプリケーションまたはライブラリのほとんどの開発者は、タスクを実行するプロセッサ、他のタスクと動作を同期する方法、<xref:System.Threading.ThreadPool?displayProperty=fullName> でスケジュールする方法などについては気にしません。  気にするのは、ホスト コンピューター上でできるだけ効率的に実行することだけです。  スケジュールの詳細についてより詳細に制御する必要がある場合、タスク並列ライブラリでは、既定のタスク スケジューラの設定を構成でき、さらにカスタム スケジューラを利用することもできます。  詳細については、「<xref:System.Threading.Tasks.TaskScheduler>」を参照してください。  
+  
+## 関連のデータ構造  
+ TPL には、並列のシナリオおよび順次的なシナリオの両方に役立つ複数の新しいパブリック型があります。  これらの型には、<xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間における、スレッド セーフで、高速、スケーラブルなコレクション クラス、および新しい同期の型が含まれます。たとえば、<xref:System.Threading.Semaphore?displayProperty=fullName> および <xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> は、特定の種類の作業負荷に関しては、先行タスクより効率的です。  その他の .NET Framework 4 の新しい型には、<xref:System.Threading.Barrier?displayProperty=fullName> と <xref:System.Threading.SpinLock?displayProperty=fullName> があり、以前のリリースでは利用できなかった機能が用意されています。  詳細については、「[Data Structures for Parallel Programming](../../../docs/standard/parallel-programming/data-structures-for-parallel-programming.md)」を参照してください。  
+  
+## カスタムのタスクの型  
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName> または <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> から継承しないことをお勧めします。  代わりに、<xref:System.Threading.Tasks.Task.AsyncState%2A> プロパティを使用して、追加のデータまたは状態を <xref:System.Threading.Tasks.Task> オブジェクトまたは <xref:System.Threading.Tasks.Task%601> オブジェクトに関連付けることをおすすめします。  拡張メソッドを使用して、<xref:System.Threading.Tasks.Task> クラスおよび <xref:System.Threading.Tasks.Task%601> クラスの機能を拡張することもできます。  拡張メソッドの詳細については、「[拡張メソッド](../Topic/Extension%20Methods%20\(C%23%20Programming%20Guide\).md)」と「[拡張メソッド](../Topic/Extension%20Methods%20\(Visual%20Basic\).md)」を参照してください。  
+  
+ <xref:System.Threading.Tasks.Task> または <xref:System.Threading.Tasks.Task%601> から継承する必要がある場合、<xref:System.Threading.Tasks.Task.Run%2A>、<xref:System.Threading.Tasks.Task.Run%2A>、または <xref:System.Threading.Tasks.TaskFactory?displayProperty=fullName>, <xref:System.Threading.Tasks.TaskFactory%601?displayProperty=fullName>、または <xref:System.Threading.Tasks.TaskCompletionSource%601?displayProperty=fullName> の各クラスを使用して、カスタムのタスクの型のインスタンスを作成することはできません。これらのクラスで作成されるのは、<xref:System.Threading.Tasks.Task> および <xref:System.Threading.Tasks.Task%601> オブジェクトだけであるためです。  また、<xref:System.Threading.Tasks.Task>、<xref:System.Threading.Tasks.Task%601>、<xref:System.Threading.Tasks.TaskFactory>、および <xref:System.Threading.Tasks.TaskFactory%601> で提供されるタスク継続機構でも、<xref:System.Threading.Tasks.Task> オブジェクトと <xref:System.Threading.Tasks.Task%601> オブジェクトしか作成されないため、これらの機構を使用してカスタムのタスクの型のインスタンスを作成することはできません。  
+  
+## 関連トピック  
+  
+|||  
+|-|-|  
+|タイトル|説明|  
+|[Chaining Tasks by Using Continuation Tasks](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)|継続の機能について説明します。|  
+|[Attached and Detached Child Tasks](../../../docs/standard/parallel-programming/attached-and-detached-child-tasks.md)|アタッチされた子タスクとデタッチされた子タスクの違いについて説明します。|  
+|[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)|<xref:System.Threading.Tasks.Task> オブジェクトに組み込まれているキャンセルのサポートについて説明します。|  
+|[例外処理](../../../docs/standard/parallel-programming/exception-handling-task-parallel-library.md)|同時実行スレッド上の例外を処理する方法について説明します。|  
+|[How to: Use Parallel.Invoke to Execute Parallel Operations](../../../docs/standard/parallel-programming/how-to-use-parallel-invoke-to-execute-parallel-operations.md)|<xref:System.Threading.Tasks.Parallel.Invoke%2A> の使用方法について説明します。|  
+|[How to: Return a Value from a Task](../../../docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md)|タスクから値を返す方法について説明します。|  
+|[How to: Wait on One or More Tasks to Complete](../Topic/How%20to:%20Wait%20on%20One%20or%20More%20Tasks%20to%20Complete.md)|タスクの終了を待機する方法について説明します。|  
+|[How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)|タスクを取り消す方法について説明します。|  
+|[NIB: How to: Handle Exceptions Thrown by Tasks](http://msdn.microsoft.com/ja-jp/d6c47ec8-9de9-4880-beb3-ff19ae51565d)|タスクがスローした例外を処理する方法について説明します。|  
+|[How to: Create Pre\-Computed Tasks](../../../docs/standard/parallel-programming/how-to-create-pre-computed-tasks.md)|キャッシュに保持されている非同期ダウンロード操作の結果を取得する <xref:System.Threading.Tasks.Task.FromResult%2A?displayProperty=fullName> メソッドの使用例の詳細について説明します。|  
+|[How to: Traverse a Binary Tree with Parallel Tasks](../../../docs/standard/parallel-programming/how-to-traverse-a-binary-tree-with-parallel-tasks.md)|タスクを使用してバイナリ ツリーを走査する方法について説明します。|  
+|[How to: Unwrap a Nested Task](../../../docs/standard/parallel-programming/how-to-unwrap-a-nested-task.md)|<xref:System.Threading.Tasks.TaskExtensions.Unwrap%2A> 拡張メソッドの使用方法を説明します。|  
+|[Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)|<xref:System.Threading.Tasks.Parallel.For%2A> および <xref:System.Threading.Tasks.Parallel.ForEach%2A> を使用してデータを対象に並列ループを作成する方法について説明しています。|  
+|[Parallel Programming](../../../docs/standard/parallel-programming/index.md)|.NET Framework 並列プログラミングのトップ レベル ノード。|  
+  
+## 参照  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)   
+ [Samples for Parallel Programming with the .NET Framework \(.NET Framework による並列プログラミングのサンプル\)](http://code.msdn.microsoft.com/Samples-for-Parallel-b4b76364)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/task-cancellation.md b/docs/standard/parallel-programming/task-cancellation.md
new file mode 100644
index 00000000000..8933940b02d
--- /dev/null
+++ b/docs/standard/parallel-programming/task-cancellation.md
@@ -0,0 +1,46 @@
+---
+title: "Task Cancellation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, cancellation"
+  - "asynchronous task cancellation"
+ms.assetid: 3ecf1ea9-e399-4a6a-a0d6-8475f48dcb28
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Task Cancellation
+<xref:System.Threading.Tasks.Task?displayProperty=fullName> クラスおよび <xref:System.Threading.Tasks.Task%601?displayProperty=fullName> クラスは、.NET Framework のキャンセル トークンを使用したキャンセルをサポートしています。 詳細については、「[Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)」を参照してください。 Task クラスのキャンセル処理では、キャンセル可能な操作を表すユーザー デリゲートと、キャンセルを要求したコードが連携します。  キャンセル処理が正常に実行されるためには、要求コードが <xref:System.Threading.CancellationTokenSource.Cancel%2A?displayProperty=fullName> メソッドを呼び出し、ユーザー デリゲートが操作を適時に終了する必要があります。 次のオプションのいずれかを使用して操作を終了できます。  
+  
+-   デリゲートから戻ります。 多くの場合、この処理で十分ですが、この方法で取り消されたタスク インスタンスは、<xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態ではなく、<xref:System.Threading.Tasks.TaskStatus?displayProperty=fullName> 状態に遷移します。  
+  
+-   <xref:System.OperationCanceledException> をスローし、これをキャンセルが要求されたトークンに渡します。 これを行うには、<xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> メソッドを使用する方法をお勧めします。 この方法で取り消されたタスクは Canceled 状態に遷移し、タスクがキャンセル要求に応答したことを確認するために呼び出し元のコードによって使用されます。  
+  
+ 次の例は、例外をスローするタスクのキャンセルの基本的なパターンを示しています。 ユーザー デリゲートとタスク インスタンス自体にトークンが渡されることに注意してください。  
+  
+ [!code-csharp[TPL_Cancellation#02](../../../samples/snippets/csharp/VS_Snippets_Misc/tpl_cancellation/cs/snippet02.cs#02)]
+ [!code-vb[TPL_Cancellation#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpl_cancellation/vb/module1.vb#02)]  
+  
+ この例より完全なコード例については、「[How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)」を参照してください。  
+  
+ タスク インスタンスがユーザー コードによってスローされた <xref:System.OperationCanceledException> を確認した場合は、例外のトークンと関連付けられたトークン \(タスクを作成した API に渡されたトークン\) とを比較します。 これらのトークンが同一であり、トークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティから true が返されると、タスクはこれをキャンセルの受信確認と解釈し、Canceled 状態に遷移します。<xref:System.Threading.Tasks.Task.Wait%2A> メソッドまたは <xref:System.Threading.Tasks.Task.WaitAll%2A> メソッドを使用してタスクを待機しない場合、タスクの状態は <xref:System.Threading.Tasks.TaskStatus> に設定されます。  
+  
+ タスクが Canceled 状態に遷移するのを待っていると、<xref:System.Threading.Tasks.TaskCanceledException?displayProperty=fullName> 例外 \(<xref:System.AggregateException> 例外にラップされている\) がスローされます。 この例外は、障害のある状況ではなく、正常なキャンセル処理を示すことに注意してください。 このため、タスクの <xref:System.Threading.Tasks.Task.Exception%2A> プロパティは `null` を返します。  
+  
+ トークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティが false を返した場合、または例外のトークンがタスクのトークンと一致しない場合、<xref:System.OperationCanceledException> は標準の例外のように扱われるため、タスクは Faulted 状態に遷移します。 他の例外が存在する場合も、タスクが Faulted 状態に遷移することに注意してください。 完了したタスクの状態は <xref:System.Threading.Tasks.Task.Status%2A> プロパティで取得できます。  
+  
+ キャンセルが要求された後も、タスクが一部の項目の処理を継続する可能性があります。  
+  
+## 参照  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)   
+ [How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/task-parallel-library-tpl.md b/docs/standard/parallel-programming/task-parallel-library-tpl.md
new file mode 100644
index 00000000000..cdb0b316902
--- /dev/null
+++ b/docs/standard/parallel-programming/task-parallel-library-tpl.md
@@ -0,0 +1,42 @@
+---
+title: "Task Parallel Library (TPL) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - ".NET, concurrency in"
+  - ".NET, parallel programming in"
+  - "Parallel Programming"
+ms.assetid: b8f99f43-9104-45fd-9bff-385a20488a23
+caps.latest.revision: 37
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# Task Parallel Library (TPL)
+タスク並列ライブラリ \(TPL: Task Parallel Library\) は、<xref:System.Threading?displayProperty=fullName> 名前空間および <xref:System.Threading.Tasks?displayProperty=fullName> 名前空間におけるパブリック型と API のセットです。  TPL の目的は、アプリケーションに並列処理と同時実行を追加するプロセスを簡略化して、開発者の生産性を高めることです。  TPL は、使用可能なすべてのプロセッサを最も効率的に使用するように、同時実行の程度を動的に拡大します。  さらに TPL は、作業のパーティション分割、<xref:System.Threading.ThreadPool> 上のスレッドのスケジュール、キャンセルのサポート、状態管理、および他の低水準の詳細を処理します。  TPL を使用すると、コードのパフォーマンスが大幅に向上し、目的を達成するためのプログラミング作業に集中できます。  
+  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、マルチスレッド コードおよび並列コードを作成するときに TPL をお勧めします。  ただし、すべてのコードが並列化に適している訳ではありません。ループの各反復処理で少量の作業のみを実行する場合、または多数の反復処理のために実行しない場合、並列化のオーバーヘッドによってコードの実行が遅くなる可能性があります。  さらに、マルチスレッド コードのような並列化によって、プログラムの実行がより複雑になります。  TPL はマルチスレッドのシナリオを簡略化しますが、たとえばロック、デッドロックおよび競合状態のスレッド処理の基本的な概念を理解し、TPL を効率的に使用することをお勧めします。  
+  
+## 関連トピック  
+  
+|||  
+|-|-|  
+|Title|説明|  
+|[Data Parallelism](../../../docs/standard/parallel-programming/data-parallelism-task-parallel-library.md)|並列の `for` ループおよび `foreach` ループ \(Visual Basic では `For` および `For Each`\) を作成する方法について説明します。|  
+|[Task Parallelism](../../../docs/standard/parallel-programming/task-based-asynchronous-programming.md)|<xref:System.Threading.Tasks.Parallel.Invoke%2A?displayProperty=fullName> を使用して暗黙的にタスクを作成および実行する方法、または <xref:System.Threading.Tasks.Task> オブジェクトを直接使用して明示的にタスクを作成および実行する方法について説明します。|  
+|[データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)|相互に非同期通信を行う必要がある複数の操作を処理する場合、またはデータが使用可能になったときにデータを処理する場合に、TPL データ フロー ライブラリのデータ フロー コンポーネントを使用する方法について説明します。|  
+|[Using TPL with Other Asynchronous Patterns](../../../docs/standard/parallel-programming/using-tpl-with-other-asynchronous-patterns.md)|TPL と他の非同期パターンを .NET で使用する方法について説明します。|  
+|[Potential Pitfalls in Data and Task Parallelism](../../../docs/standard/parallel-programming/potential-pitfalls-in-data-and-task-parallelism.md)|一般的な落とし穴とその回避方法について説明します。|  
+|[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)|LINQ クエリでデータの並列化を達成する方法について説明します。|  
+|[Parallel Programming](../../../docs/standard/parallel-programming/index.md)|.NET 並列プログラミングのトップ レベル ノード。|  
+  
+## 参照  
+ [Samples for Parallel Programming with the .NET Framework \(.NET Framework による並列プログラミングのサンプル\)](http://code.msdn.microsoft.com/Samples-for-Parallel-b4b76364)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/tpl-and-traditional-async-programming.md b/docs/standard/parallel-programming/tpl-and-traditional-async-programming.md
new file mode 100644
index 00000000000..9a0a7fad3b8
--- /dev/null
+++ b/docs/standard/parallel-programming/tpl-and-traditional-async-programming.md
@@ -0,0 +1,124 @@
+---
+title: "TPL and Traditional .NET Framework Asynchronous Programming | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks, with other asynchronous models"
+ms.assetid: e7b31170-a156-433f-9f26-b1fc7cd1776f
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# TPL and Traditional .NET Framework Asynchronous Programming
+.NET Framework の I\/O バインドの非同期操作および計算主体の非同期操作には、次の 2 つの標準パターンがあります。  
+  
+-   非同期操作が Begin\/End メソッドのペアによって表される非同期プログラミング モデル \(APM\)。<xref:System.IO.FileStream.BeginRead%2A?displayProperty=fullName>、<xref:System.IO.Stream.EndRead%2A?displayProperty=fullName> など。  
+  
+-   イベントベースの非同期パターン \(EAP\)。たとえば <xref:System.Net.WebClient.DownloadStringAsync%2A?displayProperty=fullName> や <xref:System.Net.WebClient.DownloadStringCompleted?displayProperty=fullName> など、 *OperationName*Async および *OperationName*Completed という名前のメソッドとイベントのペアによって非同期操作が表されています。  \(EAP は、.NET Framework Version 2.0 で導入されました\)。  
+  
+ タスク並列ライブラリ \(TPL\) は、これらの非同期パターンと共にさまざまな方法で使用されます。  ライブラリ使用時に、APM 操作と EAP 操作をタスクとして公開するか、または APM パターンを公開し、タスク オブジェクトを使用して内部的に実装することができます。  どちらの場合でも、タスク オブジェクトを使用することでコードを簡易化し、次のような便利な機能を活用できます。  
+  
+-   タスクの継続の形で、タスク開始後に随時コールバックを登録する。  
+  
+-   `Begin_` および <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A> メソッド、または <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A> メソッドまたは <xref:System.Threading.Tasks.Task.WaitAll%2A> メソッドを使用し、<xref:System.Threading.Tasks.Task.WaitAny%2A> メソッドに対する応答として実行される複数の操作を調整する。  
+  
+-   非同期 I\/O バインド操作と計算主体の操作を、同じタスク オブジェクトにカプセル化する。  
+  
+-   タスク オブジェクトの状態を監視する。  
+  
+-   <xref:System.Threading.Tasks.TaskCompletionSource%601> を使用し、タスク オブジェクトへの操作の状態をマーシャリングする。  
+  
+## APM 操作のタスクへのラッピング  
+ <xref:System.Threading.Tasks.TaskFactory?displayProperty=fullName> クラスと <xref:System.Threading.Tasks.TaskFactory%601?displayProperty=fullName> クラスには、1 つの <xref:System.Threading.Tasks.Task> インスタンスまたは <xref:System.Threading.Tasks.Task%601> インスタンスに APM の Begin\/End メソッドのペアをカプセル化できる <xref:System.Threading.Tasks.TaskFactory.FromAsync%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Tasks.TaskFactory%601.FromAsync%2A?displayProperty=fullName> メソッドの複数のオーバーロードが用意されています。  さまざまなオーバーロードが、0 ～ 3 個の入力パラメーターを持つ Begin\/End メソッドのペアに対応します。  
+  
+ 値 \(Visual Basic の場合は `Function`\) を返す `End` メソッドを持つペアの場合は、<xref:System.Threading.Tasks.Task%601> を作成する <xref:System.Threading.Tasks.TaskFactory%601> のメソッドを使用します。  Void \(Visual Basic の場合は `Sub`\) を返す `End` メソッドの場合は、<xref:System.Threading.Tasks.Task> を作成する <xref:System.Threading.Tasks.TaskFactory> のメソッドを使用します。  
+  
+ ごくまれなケースですが、`Begin` メソッドが 3 個以上のパラメーターを持つ場合や、`ref` パラメーターまたは `out` パラメーターが含まれる場合は、`FromAsync` メソッドだけをカプセル化する `End` オーバーロードが追加で提供されます。  
+  
+ <xref:System.IO.FileStream.BeginRead%2A?displayProperty=fullName> メソッドおよび <xref:System.IO.FileStream.EndRead%2A?displayProperty=fullName> メソッドと一致する `FromAsync` オーバーロードの署名を、次のコード例に示します。  このオーバーロードは、次のように、3 つの入力パラメーターを取ります。  
+  
+ [!code-csharp[FromAsync#01](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#01)]
+ [!code-vb[FromAsync#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#01)]  
+  
+ 1 つ目のパラメーターは <xref:System.Func%606> デリゲートで、<xref:System.IO.FileStream.BeginRead%2A?displayProperty=fullName> メソッドの署名と一致します。  2 つ目のパラメーターは、<xref:System.Func%602> を受け取り、<xref:System.IAsyncResult> を返す `TResult` デリゲートです。  <xref:System.IO.FileStream.EndRead%2A> は整数を返すので、コンパイラは `TResult` の型を <xref:System.Int32> と推論し、タスクの型を <xref:System.Threading.Tasks.Task> と推論します。  最後の 4 つのパラメーターは、<xref:System.IO.FileStream.BeginRead%2A?displayProperty=fullName> メソッドのパラメーターと同じです。  
+  
+-   ファイル データを格納するバッファー。  
+  
+-   データ書き込みの開始位置を示すバッファー内のオフセット。  
+  
+-   ファイルから読み取る最大データ量。  
+  
+-   コールバックに渡されるユーザー定義の状態データを格納する、オプションのオブジェクト。  
+  
+### コールバック関数での ContinueWith の使用  
+ バイト数だけでなく、ファイルのデータにアクセスする必要がある場合は、<xref:System.Threading.Tasks.TaskFactory.FromAsync%2A> メソッドだけでは不十分です。  代わりに、<xref:System.Threading.Tasks.Task> プロパティにファイル データが含まれている `Result` を使用します。  これを実行するには、元のタスクに継続を追加します。  継続は、通常、<xref:System.AsyncCallback> デリゲートによって実行される作業を実行します。  継続元が完了したとき、およびデータ バッファーが満杯になったときに呼び出されます   \(<xref:System.IO.FileStream> オブジェクトは、返される前に終了している必要があります\)。  
+  
+ <xref:System.Threading.Tasks.Task> クラスの BeginRead\/EndRead ペアをカプセル化する <xref:System.IO.FileStream> を返す方法を、次の例に示します。  
+  
+ [!code-csharp[FromAsync#03](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#03)]
+ [!code-vb[FromAsync#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#03)]  
+  
+ このメソッドは、次のようにして呼び出すことができます。  
+  
+ [!code-csharp[FromAsync#04](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#04)]
+ [!code-vb[FromAsync#04](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#04)]  
+  
+### カスタム状態データの提供  
+ 一般的な <xref:System.IAsyncResult> 操作では、<xref:System.AsyncCallback> デリゲートにカスタム状態データが必要な場合、最終的にコールバック メソッドに渡される `Begin` オブジェクトにデータをパッケージ化できるよう、<xref:System.IAsyncResult> メソッドの最後のパラメーターを通じてカスタム状態データを渡す必要があります。  通常、`FromAsync` メソッドが使用される場合は必要ありません。  カスタム データが継続に対して既知の場合は、継続のデリゲートで直接キャプチャできます。  次の例は前の例と似ていますが、継続は継続元の `Result` プロパティを検証せずに、継続のユーザー デリゲートに直接アクセスできるカスタム状態データを検証します。  
+  
+ [!code-csharp[FromAsync#05](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#05)]
+ [!code-vb[FromAsync#05](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#05)]  
+  
+### 複数の FromAsync タスクの同期化  
+ 静的な <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A> メソッドと <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAny%2A> メソッドは、`FromAsync` メソッドと共に使用することによって、柔軟性を強化できます。  複数の非同期 I\/O 操作を開始し、継続を実行する前にすべての操作が完了するまで待機する方法を次の例に示します。  
+  
+ [!code-csharp[FromAsync#06](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#06)]
+ [!code-vb[FromAsync#06](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#06)]  
+  
+### End メソッドだけの FromAsync タスク  
+ ごくまれなケースですが、`Begin` メソッドに 3 個以上の入力パラメーターが必要な場合や、`ref` パラメーターまたは `out` パラメーターが含まれる場合は、`FromAsync` など、<xref:System.Threading.Tasks.TaskFactory%601.FromAsync%28System.IAsyncResult%2CSystem.Func%7BSystem.IAsyncResult%2C%600%7D%29?displayProperty=fullName> メソッドだけを表す `End` オーバーロードを使用します。  これらのメソッドは、<xref:System.IAsyncResult> が渡され、それをタスクにカプセル化するシナリオでも使用できます。  
+  
+ [!code-csharp[FromAsync#07](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#07)]
+ [!code-vb[FromAsync#07](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#07)]  
+  
+### FromAsync タスクの開始とキャンセル  
+ `FromAsync` メソッドから返されるタスクの状態は WaitingForActivation で、タスク作成後のある時点でシステムによって開始されます。  このようなタスクで Start を呼び出そうとすると、例外が発生します。  
+  
+ 基になる .NET Framework の API は、現時点ではファイルまたはネットワーク I\/O の処理中の取り消しをサポートしていないので、`FromAsync` タスクを取り消すことはできません。  `FromAsync` の呼び出しをカプセル化するメソッドにキャンセル機能を追加することはできますが、キャンセルに応答できるのは `FromAsync` が呼び出される前、または完了した後 \(たとえば、継続タスク上など\) だけです。  
+  
+ <xref:System.Net.WebClient> など、EAP をサポートするいくつかのクラスはキャンセルをサポートしていないため、ネイティブのキャンセル機能を統合するには、キャンセル トークンを使用します。  
+  
+## 複雑な EAP 操作のタスクとしての公開  
+ TPL は、`FromAsync` 系のメソッドが <xref:System.IAsyncResult> パターンをラップするのとは異なる方法で、イベント ベースの非同期操作をカプセル化するよう特別に設計されたメソッドを提供します。  ただし、TPL は <xref:System.Threading.Tasks.TaskCompletionSource%601?displayProperty=fullName> クラスを提供するので、これを使用して任意の操作セットを <xref:System.Threading.Tasks.Task%601> として表すことができます。  操作は、同期または非同期、I\/O バインドまたは計算主体、またはその両方です。  
+  
+ <xref:System.Threading.Tasks.TaskCompletionSource%601> を使用し、非同期の <xref:System.Net.WebClient> 操作を基本的な <xref:System.Threading.Tasks.Task%601> としてクライアント コードに公開する方法を、次の例に示します。  このメソッドを使用すると、Web URL の配列および検索対象の用語または名前を入力し、各サイトで検索用語が使用される回数を返すことができます。  
+  
+ [!code-csharp[FromAsync#10](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/snippet10.cs#10)]
+ [!code-vb[FromAsync#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/snippet10.vb#10)]  
+  
+ 追加の例外処理を含み、クライアント コードからメソッドを呼び出す方法を示す、より包括的な例については、「[How to: Wrap EAP Patterns in a Task](../../../docs/standard/parallel-programming/how-to-wrap-eap-patterns-in-a-task.md)」を参照してください。  
+  
+ <xref:System.Threading.Tasks.TaskCompletionSource%601> によって作成されたタスクは、その TaskCompletionSource によって開始されるので、ユーザー コードがそのタスクで Start メソッドを呼び出さないようにする必要があります。  
+  
+## タスクを使用した APM パターンの実装  
+ 一部のシナリオでは、API で Begin\/End メソッド ペアを使用することにより、<xref:System.IAsyncResult> を直接公開する方が望ましいこともあります。  たとえば、既存の API との一貫性を保ちたいときや、このパターンを必要とする自動ツールがある場合などです。  そのような場合は、タスクを使用し、APM パターンを内部的に実装する方法を簡素化できます。  
+  
+ タスクを使用し、長期間実行される計算主体のメソッドに APM の Begin\/End メソッド ペアを実装する方法を、次の例に示します。  
+  
+ [!code-csharp[FromAsync#09](../../../samples/snippets/csharp/VS_Snippets_Misc/fromasync/cs/fromasync.cs#09)]
+ [!code-vb[FromAsync#09](../../../samples/snippets/visualbasic/VS_Snippets_Misc/fromasync/vb/module1.vb#09)]  
+  
+## StreamExtensions サンプル コードの使用  
+ MSDN Web サイトの「[.NET Framework 4 による並列プログラミングのサンプル](http://go.microsoft.com/fwlink/?LinkID=165717)」 の Streamextensions.cs ファイルには、非同期ファイルおよびネットワーク I\/O に対してタスク オブジェクトを使用する参照実装がいくつか含まれています。  
+  
+## 参照  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/understanding-speedup-in-plinq.md b/docs/standard/parallel-programming/understanding-speedup-in-plinq.md
new file mode 100644
index 00000000000..83f3325adf9
--- /dev/null
+++ b/docs/standard/parallel-programming/understanding-speedup-in-plinq.md
@@ -0,0 +1,90 @@
+---
+title: "Understanding Speedup in PLINQ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "PLINQ queries, performance tuning"
+ms.assetid: 53706c7e-397d-467a-98cd-c0d1fd63ba5e
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Understanding Speedup in PLINQ
+PLINQ の主な目的は、マルチコア コンピューターでクエリのデリゲートを並列で実行することにより、LINQ to Objects クエリの実行を高速化することです。  PLINQ は、ソース コレクションの各要素の処理が独立し、個別のデリゲート間に共有状態がない場合に、最大のパフォーマンスを発揮します。  このような操作は、LINQ to Objects および PLINQ では一般的であり、複数のスレッドでのスケジュール設定が容易であることから、"*適切な並列*" とも言われます。  しかし、すべてのクエリが適切な並列操作だけで構成されるわけではありません。ほとんどの場合、クエリには、並列化できない演算子や、並列実行では速度が低下する演算子がいくつか含まれています。  また、完全に適切な並列クエリでも、PLINQ ではデータ ソースをパーティション分割して作業をスレッド上でスケジュールし、通常はクエリが完了したときに結果をマージする必要があります。  これらすべての操作により、並列化の計算コストが増えます。このような並列化を加えることによるコストを、*オーバーヘッド*といいます。  PLINQ クエリで最適なパフォーマンスを実現するには、適切な並列の部分を最大化し、オーバーヘッドを要する部分を最小化することが目標です。  ここでは、できる限り効率的で、正しい結果を生成する PLINQ クエリを記述するのに役立つ情報を示します。  
+  
+## PLINQ クエリのパフォーマンスに影響を与える要因  
+ ここでは、並列クエリのパフォーマンスに影響を与える最も重要な要因をいくつか示します。  これらは一般的な説明であり、これだけではすべてのケースのクエリのパフォーマンスを予測するには不十分です。  当然ながら、一連の代表的な構成および負荷を使用して、コンピューターで特定のクエリの実際のパフォーマンスを計測することが重要です。  
+  
+1.  作業全体の計算コスト。  
+  
+     高速化を実現するには、PLINQ クエリの適切な並列処理が、オーバーヘッドを相殺するのに十分な量である必要があります。  この量は、各デリゲートの計算コストを、ソース コレクション内の要素の数で乗算して表すことができます。  操作を並列化できると仮定した場合、その操作の計算コストが大きいほど、高速化の可能性は高くなります。  たとえば、関数の実行に 1 ミリ秒かかる場合、1,000 個の要素に対する順次クエリを実行するには 1 秒かかりますが、4 つのコアを備えるコンピューター上で並列クエリを実行した場合は 250 ミリ秒しかかかりません。  これにより、750 ミリ秒の高速化が実現します。  関数を各要素に対して実行するのに 1 秒かかる場合は、750 秒の高速化が実現します。  デリゲートがきわめて高コストである場合、PLINQ は、項目が数個しかないソース コレクションで大幅な高速化を実現することがあります。  逆に、デリゲートが低コストである小さなソース コレクションは、通常、PLINQ にふさわしい候補ではありません。  
+  
+     次の例では、queryA が PLINQ にふさわしい候補、Select 関数に大量の処理が含まれているからです。queryB は、Select ステートメントに十分な処理が、並列化のオーバーヘッドによって高速化ほとんどまたはすべてが相殺されるため、ふさわしい候補ではありません。  
+  
+    ```vb  
+    Dim queryA = From num In numberList.AsParallel()  
+                 Select ExpensiveFunction(num); 'good for PLINQ  
+  
+    Dim queryB = From num In numberList.AsParallel()  
+                 Where num Mod 2 > 0  
+                 Select num; 'not as good for PLINQ  
+    ```  
+  
+    ```csharp  
+    var queryA = from num in numberList.AsParallel()  
+                 select ExpensiveFunction(num); //good for PLINQ  
+  
+    var queryB = from num in numberList.AsParallel()  
+                 where num % 2 > 0  
+                 select num; //not as good for PLINQ  
+  
+    ```  
+  
+2.  システムの論理コアの数 \(並列化の程度\)。  
+  
+     このポイントは、前のセクションの当然の帰結です。適切な並列クエリは、マシンのコア数が多いほど高速に実行されます。これは、より多くの同時スレッド間で処理を分割できるからです。  高速化の総量は、クエリの処理全体の何パーセントが並列化可能であるかによって異なります。  ただし、すべてのクエリが、8 コアのコンピューターでは 4 コアのコンピューターの 2 倍の速さで実行されるとは考えないでください。  最適なパフォーマンスを得るためにクエリを調整するときは、さまざまなコア数のコンピューターで実際の結果を計測することが重要です。  このポイントは 1 番目のポイントに関連しています。より多くのコンピューティング リソースを利用するには、より大きなデータセットが必要です。  
+  
+3.  操作の数と種類。  
+  
+     PLINQ には、ソース シーケンス内の要素の順序を維持する必要がある状況に備えて、AsOrdered 演算子が用意されています。  順序操作にはコストがかかりますが、このコストは通常はそれほど大きくありません。  同様に、GroupBy 操作と Join 操作でもオーバーヘッドが生じます。  PLINQ は、ソース コレクション内の要素を任意の順序で処理でき、それらの要素を準備完了と同時に次の演算子に渡すことができる場合に、最大のパフォーマンスを発揮します。  詳細については、「[Order Preservation in PLINQ](../../../docs/standard/parallel-programming/order-preservation-in-plinq.md)」を参照してください。  
+  
+4.  クエリ実行の形式。  
+  
+     ToArray または ToList を呼び出してクエリの結果を格納する場合、すべての並列スレッドの結果を単一のデータ構造にマージする必要があります。  この場合、計算コストが必ず生じます。  同様に、foreach \(Visual Basic では For Each\) ループを使用して結果を反復処理する場合、ワーカー スレッドの結果を列挙子スレッドにシリアル化する必要があります。  しかし、各スレッドの結果に基づいて何らかのアクションを実行するだけであれば、ForAll メソッドを使用して、この処理を複数のスレッドで実行できます。  
+  
+5.  マージ オプションの種類。  
+  
+     PLINQ は、出力をバッファーに格納し、それをチャンク単位で生成するか、結果セット全体が生成された後で一度に生成するように構成するか、または個別の結果を生成時にストリーミングするように構成できます。  前者の場合は、全体的な実行時間が減少し、後者の場合は、生成される要素間の遅延が減少します。マージ オプションは、クエリのパフォーマンス全体に大きな影響を与えるとは限りませんが、ユーザーが結果を目にするまでの時間を制御するため、知覚されるパフォーマンスに影響を与えることがあります。  詳細については、「[Merge Options in PLINQ](../../../docs/standard/parallel-programming/merge-options-in-plinq.md)」を参照してください。  
+  
+6.  パーティション分割の種類。  
+  
+     場合によっては、インデックス可能なソース コレクションに対する PLINQ クエリで、作業負荷のバランスが崩れることがあります。  この場合、カスタム パーティショナーを作成することにより、クエリのパフォーマンスを改善できることがあります。  詳細については、「[Custom Partitioners for PLINQ and TPL](../../../docs/standard/parallel-programming/custom-partitioners-for-plinq-and-tpl.md)」を参照してください。  
+  
+## PLINQ が順次モードを選択するケース  
+ PLINQ は、少なくとも順次実行した場合と同じ速さでクエリを実行しようと常に試みます。  PLINQ は、ユーザー デリゲートの計算コストの大きさや、入力ソースの大きさは確認しませんが、クエリの特定の "形態"は確認します。具体的には、クエリの並列モードでの実行を低速化させる原因となるクエリ演算子または演算子の組み合わせを検索します。  そのような形態を見つけた場合、PLINQ は、既定で順次モードに戻ります。  
+  
+ しかし、特定のクエリのパフォーマンスを計測した後で、実際には並列モードのほうが高速に実行されることがわかる場合があります。  そのような場合、<xref:System.Linq.ParallelEnumerable.WithExecutionMode%2A?displayProperty=fullName> メソッドを通じて <xref:System.Linq.ParallelExecutionMode> フラグを使用して、クエリを並列化するように PLINQ に指示できます。  詳細については、「[How to: Specify the Execution Mode in PLINQ](../../../docs/standard/parallel-programming/how-to-specify-the-execution-mode-in-plinq.md)」を参照してください。  
+  
+ PLINQ が既定で順次モードで実行するクエリの形態は次のとおりです。  
+  
+-   元のインデックスを削除または再配列した順序設定またはフィルター処理の演算子の後に、Select 句、インデックス付きの Where 句、インデックス付きの SelectMany 句、または ElementAt 句を含むクエリ。  
+  
+-   Take 演算子、TakeWhile 演算子、Skip 演算子、または SkipWhile 演算子を含み、ソース シーケンスのインデックスが元の順序ではないクエリ。  
+  
+-   データ ソースの 1 つがに順序付けられたインデックスがあると、Zip または SequenceEquals を含むクエリは他のデータ ソースがです \(つまり配列または IList \(T\)\)。  
+  
+-   Concat を含むクエリ。ただし、Concat がインデックス可能なデータ ソースに適用されている場合を除きます。  
+  
+-   Reverse を含むクエリ。ただし、Reverse がインデックス可能なデータ ソースに適用されている場合を除きます。  
+  
+## 参照  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/using-tpl-with-other-asynchronous-patterns.md b/docs/standard/parallel-programming/using-tpl-with-other-asynchronous-patterns.md
new file mode 100644
index 00000000000..9826eebda51
--- /dev/null
+++ b/docs/standard/parallel-programming/using-tpl-with-other-asynchronous-patterns.md
@@ -0,0 +1,32 @@
+---
+title: "Using TPL with Other Asynchronous Patterns | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "tasks and APM"
+ms.assetid: 7add905b-ff60-4353-af79-5089038d9a08
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Using TPL with Other Asynchronous Patterns
+タスク並列ライブラリでは、さまざまな方法で従来の .NET Framework の非同期プログラミング パターンで使用できます。  
+  
+## このセクションの内容  
+ [TPL and Traditional .NET Framework Asynchronous Programming](../../../docs/standard/parallel-programming/tpl-and-traditional-async-programming.md)  
+ <xref:System.Threading.Tasks.Task> オブジェクトが非同期プログラミング Model \(APM\) および Event\-based Asynchronous Pattern \(EAP\) とともに使用されるかを説明します。  
+  
+ [How to: Wrap EAP Patterns in a Task](../../../docs/standard/parallel-programming/how-to-wrap-eap-patterns-in-a-task.md)  
+ <xref:System.Threading.Tasks.Task> オブジェクトを使用して EAP パターンをカプセル化する方法を示します。  
+  
+## 参照  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/walkthrough-creating-a-custom-dataflow-block-type.md b/docs/standard/parallel-programming/walkthrough-creating-a-custom-dataflow-block-type.md
new file mode 100644
index 00000000000..3f674fee8e7
--- /dev/null
+++ b/docs/standard/parallel-programming/walkthrough-creating-a-custom-dataflow-block-type.md
@@ -0,0 +1,71 @@
+---
+title: "Walkthrough: Creating a Custom Dataflow Block Type | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, creating custom dataflow blocks"
+  - "dataflow blocks, creating custom in TPL"
+ms.assetid: a6147146-0a6a-4d9b-ab0f-237b3c1ac691
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Walkthrough: Creating a Custom Dataflow Block Type
+TPL データ フローのライブラリのさまざまな機能を有効にするには、いくつかのデータ フロー ブロック型がありますが、カスタム ブロック型を作成できます。  ここでは、カスタム動作を実装するデータ フロー ブロック型を作成する方法について説明します。  
+  
+## 必須コンポーネント  
+ この説明を読む前に [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md) を読み込みます。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## スライド式ウィンドウのデータ フローのブロックの定義  
+ 値を挿入し、スライド式ウィンドウで出力することはバッファーに格納されていることを必要とするデータ フロー アプリケーションがあるとします。  たとえば、入力値{0、1、2、3、4、5、および 3 のウィンドウ サイズに、スライド式ウィンドウのデータ フローのブロックが出力配列{0、1、2}、{1} {2、3、2、3、4 を生成および} {3、4、5\)。  以下のセクションでは、カスタム動作を実装するデータ フロー ブロック型を作成するには 2 とおりの方法について説明します。  最初の方法は、1 種類の伝達子ブロックに <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601> オブジェクトと <xref:System.Threading.Tasks.Dataflow.ITargetBlock%601> オブジェクトの機能を結合するに <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Encapsulate%2A> のメソッドを使用します。  2 番目の方法は <xref:System.Threading.Tasks.Dataflow.IPropagatorBlock%602> から派生し、カスタム動作を実行する既存の機能を組み合わせて使用するクラスを定義します。  
+  
+## スライド式ウィンドウのデータ フローのブロックを定義してカプセル化のメソッドを使用します。  
+ 次の例では、ソースとターゲットの伝達子ブロックを作成するために <xref:System.Threading.Tasks.Dataflow.DataflowBlock.Encapsulate%2A> のメソッドを使用します。  伝達子ブロックは、ソース ブロックとターゲット ブロックがデータの受信側と sender として機能するようにします。  
+  
+ この方法は、カスタム データ フロー機構を必要とするが、追加のメソッド、プロパティ、またはフィールドを提供する型が必要ではない場合に便利です。  
+  
+ [!code-csharp[TPLDataflow_SlidingWindowBlock#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_slidingwindowblock/cs/slidingwindowblock.cs#1)]
+ [!code-vb[TPLDataflow_SlidingWindowBlock#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_slidingwindowblock/vb/slidingwindowblock.vb#1)]  
+  
+## スライド式ウィンドウのデータ フローのブロックを定義して IPropagatorBlock からの派生  
+ 次の例は、`SlidingWindowBlock` クラスを示しています。  このクラスは <xref:System.Threading.Tasks.Dataflow.IPropagatorBlock%602> からデータ ソースおよびターゲットとして機能するように派生します。  前の例では、`SlidingWindowBlock` クラスは、既存のデータ フロー ブロック型に基づいています。  ただし、`SlidingWindowBlock` クラスは、<xref:System.Threading.Tasks.Dataflow.ISourceBlock%601>、<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601>と <xref:System.Threading.Tasks.Dataflow.IDataflowBlock> インターフェイスで必要なメソッドを実装します。  これらのメソッドはすべて定義済みのなデータ フロー ブロック型のメンバーに作業を転送します。  たとえば、`Post` のメソッドは、<xref:System.Threading.Tasks.Dataflow.ITargetBlock%601> オブジェクトである `m_target` データ メンバーと作業が遅延されます。  
+  
+ この方法は、カスタム データ フロー機構を必要とし、さらにメソッド、プロパティ、またはフィールドを提供する型が必要となる場合に便利です。  たとえば、`SlidingWindowBlock` クラスは、<xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601> から <xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceive%2A> と <xref:System.Threading.Tasks.Dataflow.IReceivableSourceBlock%601.TryReceiveAll%2A> のメソッドを提供するために派生します。  `SlidingWindowBlock` クラスは、スライド式ウィンドウの要素の数を取得する `WindowSize` のプロパティを使用して、拡張機能を示します。  
+  
+ [!code-csharp[TPLDataflow_SlidingWindowBlock#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_slidingwindowblock/cs/slidingwindowblock.cs#2)]
+ [!code-vb[TPLDataflow_SlidingWindowBlock#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_slidingwindowblock/vb/slidingwindowblock.vb#2)]  
+  
+## 完全な例  
+ 次の例では、このチュートリアルの完全なコードを示しています。  、ブロックに記述し、そこから読み込み、結果をコンソールに出力するメソッドでスライド式ウィンドウのブロックを使用する方法を示します。  
+  
+ [!code-csharp[TPLDataflow_SlidingWindowBlock#100](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_slidingwindowblock/cs/slidingwindowblock.cs#100)]
+ [!code-vb[TPLDataflow_SlidingWindowBlock#100](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_slidingwindowblock/vb/slidingwindowblock.vb#100)]  
+  
+## コードのコンパイル  
+ プログラム例をコピーし、Visual Studio のプロジェクトに貼り付けるか、`SlidingWindowBlock.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`SlidingWindowBlock.vb`\) という名前で、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行してファイルに貼り付けます。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll SlidingWindowBlock.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll SlidingWindowBlock.vb**  
+  
+## 次の手順  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md b/docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md
new file mode 100644
index 00000000000..94d8e84151b
--- /dev/null
+++ b/docs/standard/parallel-programming/walkthrough-creating-a-dataflow-pipeline.md
@@ -0,0 +1,134 @@
+---
+title: "Walkthrough: Creating a Dataflow Pipeline | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "dataflow pipelines, creating with TPL"
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, creating dataflow pipeline"
+ms.assetid: 69308f82-aa22-4ac5-833d-e748533b58e8
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Walkthrough: Creating a Dataflow Pipeline
+<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Receive%2A?displayProperty=fullName>、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.ReceiveAsync%2A?displayProperty=fullName>、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.TryReceive%2A?displayProperty=fullName> の各メソッドを使用すると、ソース ブロックからメッセージを受信できますが、メッセージ ブロックに接続して*データフロー パイプライン*を形成することもできます。  データフロー パイプラインは一連のコンポーネント、または*データフロー ブロック*です。それぞれがより大きな目標を達成するための特定のタスクを実行します。  データフロー パイプラインのすべてのデータフロー ブロックは、他のデータフロー ブロックからメッセージを受け取ったときに処理を実行します。  これは、自動車製造の組み立てラインに例えることができます。  各車両が組み立てラインを通過する際、あるステーションではフレームを組み立て、次のステーションではエンジンを設置するなどです。  組み立てラインでは、複数の車両を同時に組み立てることができるため、一度に車両全体を組み立てるよりスループットが向上します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+ このドキュメントでは、Web サイトから書籍『*The Iliad of Homer*』 \(ホメロスのイリアッド\) をダウンロードしてから、個々の単語と一致するテキストを、最初の単語の文字を逆方向にして検索するデータフロー パイプラインについて説明します。  このドキュメントでは、データフロー パイプラインは、次の手順で構成しています。  
+  
+1.  パイプラインに参加しているデータフロー ブロックを作成します。  
+  
+2.  各データフロー ブロックを、パイプラインの次のブロックに接続します。  各ブロックは、入力として、パイプラインの前のブロックの出力を受信します。  
+  
+3.  各データフロー ブロックでは、前のブロックの終了後、次のブロックで完了状態に設定する継続タスクを作成します。  
+  
+4.  データをパイプラインの先頭に送信します。  
+  
+5.  パイプラインの先頭を完了としてマークします。  
+  
+6.  パイプラインのすべての作業が完了するまで待機します。  
+  
+## 必須コンポーネント  
+ このチュートリアルを開始する前に、「[データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)」をお読みください。  
+  
+## コンソール アプリケーションの作成  
+ [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で、[!INCLUDE[csprcs](../../../includes/csprcs-md.md)] または [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] コンソール アプリケーション プロジェクトを作成します。  System.Threading.Tasks.Dataflow.dll への参照を追加します。  
+  
+ 別の方法として、ファイルを作成し、名前を `ReverseWords.cs` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の場合は `ReverseWords.vb`\) と指定します。続いて、Visual Studio のコマンド プロンプト ウィンドウで次のコマンドを実行して、プロジェクトをコンパイルします。  
+  
+ [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]  
+  
+ **csc.exe \/r:System.Threading.Tasks.Dataflow.dll ReverseWords.cs**  
+  
+ [!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]  
+  
+ **vbc.exe \/r:System.Threading.Tasks.Dataflow.dll ReverseWords.vb**  
+  
+ 次のコードをプロジェクトに追加して、基本のアプリケーションを作成します。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#2)]
+ [!code-vb[TPLDataflow_Palindromes#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#2)]  
+  
+## データフロー ブロックの作成  
+ 次のコードを `Main` メソッドに追加して、パイプラインに参加するデータフロー ブロックを作成します。  次の表は、パイプラインの各メンバーの役割をまとめたものです。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#3)]
+ [!code-vb[TPLDataflow_Palindromes#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#3)]  
+  
+|メンバー|型|説明|  
+|----------|-------|--------|  
+|`downloadString`|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>|Web から書籍のテキストをダウンロードします。|  
+|`createWordList`|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>|書籍のテキストを単語の配列に区切ります。|  
+|`filterWordList`|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>|単語の配列から短い単語を削除し、結果として得られる単語をアルファベット順に並べ、重複部分を削除します。|  
+|`findReversedWords`|<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602>|フィルター処理した単語の配列のコレクションにある全単語のうち、逆方向の単語の配列も発生するものを検索します。|  
+|`printReversedWords`|<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>|単語と、関連する逆方向の単語をコンソールに表示します。|  
+  
+ この例のデータフロー パイプラインの複数の手順を 1 つの手順に結合することができますが、この例では、大規模なタスクを実行するために複数の独立したデータ フロー タスクを構成する概念を示します。  この例では、<xref:System.Threading.Tasks.Dataflow.TransformBlock%602> を使用して、パイプラインの各メンバーが入力データで操作を実行し、結果をパイプラインの次の手順に送ることができるようにします。  パイプラインの `findReversedWords` のメンバーは、各入力に複数の独立した出力を生成するため、<xref:System.Threading.Tasks.Dataflow.TransformManyBlock%602> オブジェクトになります。  パイプラインの末尾の `printReversedWords` は、入力で操作を実行しますが、結果を生成しないため、<xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトになります。  
+  
+## パイプラインの形成  
+ 各ブロックをパイプラインの次のブロックに接続するには、次のコードを追加します。  
+  
+ <xref:System.Threading.Tasks.Dataflow.DataflowBlock.LinkTo%2A> メソッドを呼び出してソース データフロー ブロックをターゲット データフロー ブロックに接続すると、データが使用可能になったときにソース データフロー ブロックがターゲット ブロックにデータを反映させます。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#4)]
+ [!code-vb[TPLDataflow_Palindromes#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#4)]  
+  
+## 完了タスクの作成  
+ すべてのデータを処理した後、各データフロー ブロックが最後の操作を実行できるようにするには、次のコードを追加します。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#5)]
+ [!code-vb[TPLDataflow_Palindromes#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#5)]  
+  
+ パイプラインを介して完了を反映させるには、各完了タスクで次のデータフロー ブロックを完了状態に設定します。  たとえば、パイプラインの先頭が完了状態に設定されると、残りのバッファーに格納されたメッセージがすべて処理され、その後完了タスクが実行されます。完了タスクでは、パイプラインの 2 番目のメンバーを完了状態に設定します。  同様に、パイプラインの 2 番目のメンバーでバッファーに格納された残りのメッセージがすべて処理され、その後完了タスクが実行されます。完了タスクでは、パイプラインの 3 番目のメンバーを完了状態に設定します。  このプロセスは、パイプラインのすべてのメンバーが完了するまで続行します。  この例では、キーワード `delegate` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の `Function`\) を使用して継続タスクを定義します。  
+  
+## パイプラインへのデータの送信  
+ 書籍『*The Iliad of Homer*』\(ホメロスのイリアッド\) の URL をデータフローのパイプラインの先頭に送信するには、次のコードを追加します。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#6)]
+ [!code-vb[TPLDataflow_Palindromes#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#6)]  
+  
+ この例では、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.Post%2A?displayProperty=fullName> を使用して、同期的にパイプラインの先頭にデータを送信します。  データフロー ノードにデータを非同期的に送信する必要がある場合は、<xref:System.Threading.Tasks.Dataflow.DataflowBlock.SendAsync%2A?displayProperty=fullName> メソッドを使用します。  
+  
+## パイプラインのアクティビティの完了  
+ パイプラインの先頭を完了済みとしてマークするには、次のコードを追加します。  パイプラインの先頭では、バッファに格納されているすべてのメッセージを処理した後、継続タスクが実行されます。  この継続タスクは、パイプラインを介して完了の状態を反映します。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#7](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#7)]
+ [!code-vb[TPLDataflow_Palindromes#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#7)]  
+  
+ この例では、処理するために 1 つの URL をデータフロー パイプラインを介して送信します。  パイプラインを介して複数の入力を送信する場合は、すべての入力を送信した後に <xref:System.Threading.Tasks.Dataflow.IDataflowBlock.Complete%2A?displayProperty=fullName> メソッドを呼び出します。  アプリケーションに、適切に定義されたポイントがない \(データが使用できなくなっているか、アプリケーションがパイプラインの終了を待つ必要がない\) 場合は、この手順を省略できます。  
+  
+## パイプラインの終了までの待機  
+ パイプラインの終了まで待機するには、次のコードを追加します。  この例では、継続タスクを使用して、パイプラインを介して完了を反映させるため、全体の操作はパイプラインの末尾が終了したときに終了します。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#8](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#8)]
+ [!code-vb[TPLDataflow_Palindromes#8](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#8)]  
+  
+ データフローの完了は、いずれかのスレッドから、または複数のスレッドから同時に待つことができます。  
+  
+## 完全な例  
+ 次の例は、このチュートリアルのコード全体を示しています。  
+  
+ [!code-csharp[TPLDataflow_Palindromes#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_palindromes/cs/dataflowpalindromes.cs#1)]
+ [!code-vb[TPLDataflow_Palindromes#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_palindromes/vb/dataflowpalindromes.vb#1)]  
+  
+## 次の手順  
+ この例では、データフロー パイプラインを介して処理するために 1 つの URL を送信しています。  パイプラインを介して複数の入力値を送信する場合は、自動車工場で部品が通過する方法に似た並列処理の形式をアプリケーションに導入することができます。  パイプラインの最初のメンバーが結果を 2 番目のメンバーに送信する場合、最初のメンバーは、2 番目のメンバーが最初のメンバーの結果を処理するときに、並行して別のアイテムを処理できます。  
+  
+ データフロー パイプラインを使用して実現されるを並列処理は、*粒度の粗い並列処理*として知られています。これは一般に、より少なくて大きいタスクを構成するためです。  データフロー パイプラインでは、より小さく実行時間の短いタスクによる、より*粒度の細かい並列処理*も行えます。  この例では、パイプラインの `findReversedWords` メンバーは、<xref:System.Threading.Tasks.Parallel.ForEach%2A?displayProperty=fullName> メソッドを使用して、作業リストの複数の項目を並行して処理します。  粒度の粗いパイプラインで粒度の細かい並列処理を行うと、全体のスループットが向上します。  
+  
+ また、ソース データフロー ブロックを複数のターゲット ブロックに接続すると、*データフロー ネットワーク*を作成することができます。  オーバー ロードされたバージョンの <xref:System.Threading.Tasks.Dataflow.DataflowBlock.LinkTo%2A> メソッドは、ターゲット ブロックがその値に基づいて各メッセージを受け入れるかどうかを定義する <xref:System.Predicate%601> オブジェクトを受け取ります。  ソースとして動作するほとんどのデータフロー ブロック型では、接続されたすべてのターゲット ブロックにメッセージを提供します。これは、いずれかのブロックがそのメッセージを受け入れるまで、ターゲット ブロックが接続された順序で行われます。  このフィルター機構を使用すると、特定のデータはあるパスを通り、その他のデータは別のパスを通るように仕向ける、接続されたデータフロー ブロックの体系を作成することができます。  フィルター処理を使用してデータフロー ネットワークを作成する例については、「[Walkthrough: Using Dataflow in a Windows Forms Application](../../../docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md)」を参照してください。  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md b/docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md
new file mode 100644
index 00000000000..d166c6911f4
--- /dev/null
+++ b/docs/standard/parallel-programming/walkthrough-using-batchblock-and-batchedjoinblock-to-improve-efficiency.md
@@ -0,0 +1,124 @@
+---
+title: "Walkthrough: Using BatchBlock and BatchedJoinBlock to Improve Efficiency | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Task Parallel Library, dataflows"
+  - "TPL dataflow library, improving efficiency"
+ms.assetid: 5beb4983-80c2-4f60-8c51-a07f9fd94cb3
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Walkthrough: Using BatchBlock and BatchedJoinBlock to Improve Efficiency
+TPL データ フロー ライブラリが提供する <xref:System.Threading.Tasks.Dataflow.BatchBlock%601?displayProperty=fullName> および <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602?displayProperty=fullName> クラスを使って、1 つ以上のソースからデータを受信してバッファーに格納し、それを 1 つのコレクションとして反映することができます。  このバッチ メカニズムは、1 つ以上のソースからデータを収集し、複数のデータ要素をバッチとして処理する場合に便利です。  例として、データフローを使ってレコードをデータベースに挿入するアプリケーションについて考えてみましょう。  この操作は、1 つずつ順番にではなく、複数の項目が同時に挿入される場合により効率的となります。  このドキュメントでは、<xref:System.Threading.Tasks.Dataflow.BatchBlock%601> クラスを使用して、そのようなデータベースの挿入操作を効率的に行う方法について説明します。  また、<xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602> クラスを使用して、プログラムでデータベースを読み取る場合に、その結果と発生する例外の両方をキャプチャする方法について説明します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## 必須コンポーネント  
+  
+1.  このチュートリアルを開始する前に、ドキュメント「[データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)」の結合のブロックのセクションを参照してください。  
+  
+2.  コンピューターに Northwind データベース \(Northwind.sdf\) のコピーがあることを確認します。  このファイルは通常は、%Program Files%\\Microsoft SQL Server Compact Edition\\v3.5\\Samples\\ フォルダーに置かれています。  
+  
+    > [!IMPORTANT]
+    >  Windows のバージョンによっては、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] が管理者以外のモードで実行されている場合には、Northwind.sdf に接続できません。  Northwind.sdf に接続するには、**\[管理者として実行\]** モードで、[!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] または [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] のコマンド プロンプトを開始します。  
+  
+ このチュートリアルは、次のセクションで構成されています。  
+  
+-   [コンソール アプリケーションの作成](#creating)  
+  
+-   [Employee クラスの定義](#employeeClass)  
+  
+-   [従業員データベースの操作の定義](#operations)  
+  
+-   [バッファリングを使用しない従業員データのデータベースへの追加](#nonBuffering)  
+  
+-   [バッファリングを使用した従業員データのデータベースへの追加](#buffering)  
+  
+-   [バッファリングされた結合を使用した従業員データのデータベースからの読み込み](#bufferedJoin)  
+  
+-   [完全な例](#complete)  
+  
+<a name="creating"></a>   
+## コンソール アプリケーションの作成  
+  
+<a name="consoleApp"></a>   
+1.  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)] で Visual C\# または Visual Basic の **\[コンソール アプリケーション\]** プロジェクトを作成します。  このドキュメントでは、プロジェクトの名前を `DataflowBatchDatabase` とします。  
+  
+2.  プロジェクトで、System.Data.SqlServerCe.dll への参照と System.Threading.Tasks.Dataflow.dll への参照を追加します。  
+  
+3.  Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の Form1.vb\) が次の `using` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)] の `Imports`\) ステートメントを含むことを確認します。  
+  
+     [!code-csharp[TPLDataflow_BatchDatabase#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#1)]
+     [!code-vb[TPLDataflow_BatchDatabase#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#1)]  
+  
+4.  `Program` クラスに次のデータ メンバーを追加します。  
+  
+     [!code-csharp[TPLDataflow_BatchDatabase#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#2)]
+     [!code-vb[TPLDataflow_BatchDatabase#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#2)]  
+  
+<a name="employeeClass"></a>   
+## Employee クラスの定義  
+ `Program` クラスに `Employee` クラスを追加します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#3)]
+ [!code-vb[TPLDataflow_BatchDatabase#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#3)]  
+  
+ `Employee` クラスには、`EmployeeID`、`LastName`、および `FirstName` という 3 つのプロパティが含まれています。  これらのプロパティは、Northwind データベースの `Employees` テーブルの `Employee ID`、`Last Name` および `First Name` の列に対応します。  このデモでは、`Employee` クラスは、プロパティに任意の値を持つ `Employee` オブジェクトを作成する、`Random` メソッドを定義します。  
+  
+<a name="operations"></a>   
+## 従業員データベースの操作の定義  
+ `Program` クラスに `InsertEmployees`、`GetEmployeeCount` および `GetEmployeeID` メソッドを追加します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#4)]
+ [!code-vb[TPLDataflow_BatchDatabase#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#4)]  
+  
+ `InsertEmployees` メソッドは、データベースに新しい従業員レコードを追加します。  `GetEmployeeCount` メソッドは `Employees` テーブルのエントリの数を取得します。  `GetEmployeeID` メソッドは、指定された名前を持つ最初の従業員 ID を取得します。  これらの各メソッドは、Northwind データベースへの接続文字列を受け取り、`System.Data.SqlServerCe` 名前空間の機能を使用して、データベースと通信します。  
+  
+<a name="nonBuffering"></a>   
+## バッファリングを使用しない従業員データのデータベースへの追加  
+ `Program` クラスに `AddEmployees` および `PostRandomEmployees` メソッドを追加します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#5)]
+ [!code-vb[TPLDataflow_BatchDatabase#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#5)]  
+  
+ `AddEmployees` メソッドは、データベースにデータ フローを使用して任意の従業員データを追加します。  それは、`InsertEmployees` メソッドを呼び出す <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトを作成して、従業員のエントリをデータベースに追加します。  次に `AddEmployees` メソッドは、`PostRandomEmployees` メソッドを呼び出して、複数の `Employee` オブジェクトを <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトへポストします。  次に `AddEmployees` メソッドは、すべての挿入操作が終了するまで待機します。  
+  
+<a name="buffering"></a>   
+## バッファリングを使用した従業員データのデータベースへの追加  
+ `Program` クラスに `AddEmployeesBatched` メソッドを追加します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#6)]
+ [!code-vb[TPLDataflow_BatchDatabase#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#6)]  
+  
+ このメソッドは `AddEmployees` に似ていますが、<xref:System.Threading.Tasks.Dataflow.BatchBlock%601> クラスを使用して複数の `Employee` オブジェクトをバッファリングしてから、それらのオブジェクトを <xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトに送信する点が異なります。  <xref:System.Threading.Tasks.Dataflow.BatchBlock%601> クラスは複数の要素を 1 つのコレクションとして反映させるため、<xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトは `Employee` オブジェクトの配列として動作するように変更されます。  `AddEmployees` メソッドと同様に、`AddEmployeesBatched` は `PostRandomEmployees` メソッドを呼び出して複数の `Employee` オブジェクトをポストしますが、`AddEmployeesBatched` はこれらのオブジェクトを <xref:System.Threading.Tasks.Dataflow.BatchBlock%601> オブジェクトにポストします。  また `AddEmployeesBatched`  メソッドは、すべての挿入操作が終了するまで待機します。  
+  
+<a name="bufferedJoin"></a>   
+## バッファリングされた結合を使用した従業員データのデータベースからの読み込み  
+ `Program` クラスに `GetRandomEmployees` メソッドを追加します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#7](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#7)]
+ [!code-vb[TPLDataflow_BatchDatabase#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#7)]  
+  
+ このメソッドは任意の従業員の情報をコンソールに出力します。  それは複数の任意の `Employee` オブジェクトを作成し、`GetEmployeeID` メソッドを呼び出して、各オブジェクトの一意の識別子を取得します。  指定された姓名に一致する従業員がいない場合には `GetEmployeeID` メソッドは例外をスローするため、`GetRandomEmployees` メソッドは <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602> クラスを使用して、`GetEmployeeID` の呼び出しが成功した場合には `Employee` オブジェクトを格納し、呼び出しが失敗した場合には <xref:System.Exception?displayProperty=fullName> オブジェクトを格納します。  この例では、<xref:System.Threading.Tasks.Dataflow.ActionBlock%601> オブジェクトは、`Employee` オブジェクトのリストと <xref:System.Exception> オブジェクトのリストを持つ <xref:System.Tuple%602> オブジェクトで動作します。  <xref:System.Threading.Tasks.Dataflow.BatchedJoinBlock%602> オブジェクトは、受け取った `Employee` および <xref:System.Exception> オブジェクトの数の合計がバッチのサイズと等しくなったときに、このデータを反映します。  
+  
+<a name="complete"></a>   
+## 完全な例  
+ 完全なコード例を次に示します。  `Main` メソッドは、バッチされたデータベースの挿入の実行に必要な時間と、非バッチでのデータベースの挿入の実行時間を比較します。  また、バッファリングされた結合を使用した従業員データのデータベースから読み取りと、エラーの報告についても示します。  
+  
+ [!code-csharp[TPLDataflow_BatchDatabase#100](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_batchdatabase/cs/dataflowbatchdatabase.cs#100)]
+ [!code-vb[TPLDataflow_BatchDatabase#100](../../../samples/snippets/visualbasic/VS_Snippets_Misc/tpldataflow_batchdatabase/vb/dataflowbatchdatabase.vb#100)]  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md b/docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md
new file mode 100644
index 00000000000..b1643c517d3
--- /dev/null
+++ b/docs/standard/parallel-programming/walkthrough-using-dataflow-in-a-windows-forms-application.md
@@ -0,0 +1,145 @@
+---
+title: "Walkthrough: Using Dataflow in a Windows Forms Application | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "TPL dataflow library, in Windows Forms"
+  - "Task Parallel Library, dataflows"
+  - "Windows Forms, and TPL"
+ms.assetid: 9c65cdf7-660c-409f-89ea-59d7ec8e127c
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# Walkthrough: Using Dataflow in a Windows Forms Application
+ここでは、Windows フォーム アプリケーションでイメージ処理を実行するデータ フローのブロックのネットワークを作成する方法を示します。  
+  
+ この例では、指定されたフォルダーから、イメージ ファイルを読み込み、複合イメージを生成し、結果を表示します。  例はネットワークでイメージをルーティングするためにデータ フロー モデルを使用します。  データ フロー モデルでは、プログラムの独立したコンポーネントどうしがメッセージを送信することによって通信します。  メッセージを受信したコンポーネントは、アクションを実行し、別のコンポーネントが結果を渡します。  このモデルと制御フロー モデルを比較してください。制御フロー モデルでは、アプリケーションは制御構造 \(条件付きステートメントやループなど\) を使用してプログラムでの操作順序を制御します。  
+  
+## 必須コンポーネント  
+ このチュートリアルを開始する前に [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md) を読み込みます。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+> [!TIP]
+>  TPL データ フローのライブラリ \(<xref:System.Threading.Tasks.Dataflow?displayProperty=fullName> 名前空間\) は [!INCLUDE[net_v45](../../../includes/net-v45-md.md)] と一緒に配布されません。  <xref:System.Threading.Tasks.Dataflow> 名前空間をインストールするには、[!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] でプロジェクトを開き、\[プロジェクト\] メニューの **\[NuGet パッケージの管理\]** をクリックし、`Microsoft.Tpl.Dataflow` パッケージをオンラインで検索します。  
+  
+## セクション  
+ このチュートリアルは、次のセクションで構成されています。  
+  
+-   [Windows フォーム アプリケーションの作成](#winforms)  
+  
+-   [データ フロー ネットワークの作成](#network)  
+  
+-   [ユーザー インターフェイスからデータ フロー ネットワークをアタッチできます。](#ui)  
+  
+-   [完全な例](#complete)  
+  
+<a name="winforms"></a>   
+## Windows フォーム アプリケーションの作成  
+ ここでは、基本の Windows フォーム アプリケーションを作成し、メイン フォームにコントロールを追加する方法について説明します。  
+  
+#### Windows フォーム アプリケーションを作成するには  
+  
+1.  [!INCLUDE[vsprvs](../../../includes/vsprvs-md.md)]で、Visual Basic または [!INCLUDE[csprcs](../../../includes/csprcs-md.md)]**\[Windows フォーム アプリケーション\]** のプロジェクトを作成します。  このドキュメントでは、プロジェクトは `CompositeImages`という名前です。  
+  
+2.  メイン フォームのフォーム デザイナーで、Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の Form1.vb\) は、<xref:System.Windows.Forms.ToolStrip> のコントロールを追加します。  
+  
+3.  <xref:System.Windows.Forms.ToolStrip> のコントロールに <xref:System.Windows.Forms.ToolStripButton> のコントロールを追加します。  フォルダーを選択するに <xref:System.Windows.Forms.ToolStripItemDisplayStyle> に <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> のプロパティと <xref:System.Windows.Forms.ToolStripItem.Text%2A> のプロパティを設定します。  
+  
+4.  <xref:System.Windows.Forms.ToolStrip> のコントロールに秒の <xref:System.Windows.Forms.ToolStripButton> のコントロールを追加します。  キャンセルに <xref:System.Windows.Forms.ToolStripItemDisplayStyle>に <xref:System.Windows.Forms.ToolStripItem.DisplayStyle%2A> のプロパティ、<xref:System.Windows.Forms.ToolStripItem.Text%2A> のプロパティ、および `False`に <xref:System.Windows.Forms.ToolStripItem.Enabled%2A> のプロパティを設定します。  
+  
+5.  メイン フォームに <xref:System.Windows.Forms.PictureBox> オブジェクトを追加します。  <xref:System.Windows.Forms.Control.Dock%2A> プロパティを <xref:System.Windows.Forms.DockStyle> に設定します。  
+  
+<a name="network"></a>   
+## データ フロー ネットワークの作成  
+ このセクションでは、イメージ処理を実行するデータ フロー ネットワークを作成する方法について説明します。  
+  
+#### データ フロー ネットワークを作成するには  
+  
+1.  プロジェクトに System.Threading.Tasks.Dataflow.dll への参照を追加します。  
+  
+2.  Form1.cs \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の Form1.vb\) が `using` Next \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`Using`\) ステートメントが含まれていることを確認する:  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#1](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#1)]  
+  
+3.  `Form1` クラスに次のデータ メンバーを追加する:  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#2](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#2)]  
+  
+4.  `Form1` クラスに次のメソッド、`CreateImageProcessingNetwork`を追加します。  このメソッドは、イメージ処理ネットワークを作成します。  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#3](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#3)]  
+  
+5.  `LoadBitmaps` メソッドを実装します。  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#4](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#4)]  
+  
+6.  `CreateCompositeBitmap` メソッドを実装します。  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#5](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#5)]  
+  
+    > [!NOTE]
+    >  `CreateCompositeBitmap` のメソッドの C\# バージョンは <xref:System.Drawing.Bitmap?displayProperty=fullName> オブジェクトを効率的に処理を有効にするには、ポインターを使用します。  したがって、[アンセーフ](../Topic/unsafe%20\(C%23%20Reference\).md) キーワードの使用をプロジェクトの **\[アンセーフ コードの許可\]** オプションを有効にする必要があります。  この方法の詳細については [!INCLUDE[csprcs](../../../includes/csprcs-md.md)] のプロジェクトのアンセーフ コードを有効にする [\[ビルド\] ページ \(プロジェクト デザイナー\) \(C\#\)](../Topic/Build%20Page,%20Project%20Designer%20\(C%23\).md)を参照します。  
+  
+ ネットワークのメンバーを次の表に示します。  
+  
+|メンバー|型|説明|  
+|----------|-------|--------|  
+|`loadBitmaps`|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>|フォルダーのパスを入力として受け取り、出力として <xref:System.Drawing.Bitmap> オブジェクトのコレクションを生成します。|  
+|`createCompositeBitmap`|<xref:System.Threading.Tasks.Dataflow.TransformBlock%602>|<xref:System.Drawing.Bitmap> オブジェクトのコレクションを入力として受け取り、出力として複合のビットマップを作成します。|  
+|`displayCompositeBitmap`|<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>|フォームの構成のビットマップを表示します。|  
+|`operationCancelled`|<xref:System.Threading.Tasks.Dataflow.ActionBlock%601>|イメージを表示するためにキャンセル操作が表示され、ユーザーが別のフォルダーを選択することができます。|  
+  
+ ネットワークを形成するデータ フローのブロックを接続するには、この例では <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A> のメソッドを使用します。  <xref:System.Threading.Tasks.Dataflow.ISourceBlock%601.LinkTo%2A> のメソッドはターゲット ブロックがメッセージを受け入れるか拒否するかどうかを確認 <xref:System.Predicate%601> オブジェクトを受け取るオーバーロードされたバージョンが含まれています。  このフィルター処理機能によって、専用の特定の値にメッセージ ブロックを有効にします。  この例では、ネットワークの 2 とおりの方法は 1 とおりに分岐することができます。  メイン分岐はディスクからイメージを読み込みましたり、複合イメージおよび表示するイメージのフォームを作成します。  代替の分岐には、現在の操作をキャンセルします。  <xref:System.Predicate%601> オブジェクトがメイン分岐に沿ってデータ フローのブロックが特定のメッセージの拒否によって代替分岐をに切り替えることができます。  たとえば、ユーザーが操作をキャンセルした場合は、データ フローのブロック `createCompositeBitmap` が出力として `null` \([!INCLUDE[vbprvb](../../../includes/vbprvb-md.md)]の`Nothing`\) を生成します。  データ フローのブロック `displayCompositeBitmap` は `null` の入力値を拒否ので、メッセージが `operationCancelled`に用意されています。  データ フローのブロック `operationCancelled` はすべてのメッセージを受け入れるため、イメージを操作がキャンセルされたことを示すために表示されます。  
+  
+ 次の図は、イメージ処理ネットワークを示しています。  
+  
+ ![画像処理ネットワーク](../../../docs/standard/parallel-programming/media/dataflowwinforms.png "DataflowWinForms")  
+  
+ `displayCompositeBitmap` と `operationCancelled` のデータ フローのブロックがユーザー インターフェイスで機能するため、これらの操作がユーザー インターフェイス スレッドで発生することが重要です。  、構築中に行うには、これをこれらのオブジェクトにはそれぞれ <xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName>に <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.TaskScheduler%2A> のプロパティ セットを持つ <xref:System.Threading.Tasks.Dataflow.ExecutionDataflowBlockOptions> オブジェクトを提供します。  <xref:System.Threading.Tasks.TaskScheduler.FromCurrentSynchronizationContext%2A?displayProperty=fullName> のメソッドは、現在の同期コンテキストの作業を実行 <xref:System.Threading.Tasks.TaskScheduler> オブジェクトを作成します。  `CreateImageProcessingNetwork` のメソッドがユーザー インターフェイス スレッドで実行されるフォルダー選択ボタンのハンドラーから呼び出されるため、`displayCompositeBitmap` と `operationCancelled` のデータ フローのブロックの操作では、ユーザー インターフェイス スレッドで実行されます。  
+  
+ この例では <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A> のプロパティを設定する代わりに <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A> のプロパティが完全にデータ フローのブロックの実行を取り消すため、共有キャンセル トークンを使用します。  キャンセル トークンが、ユーザーは一つ以上の操作を取り消す場合でも、この例が同じデータ フロー ネットワークを複数回再利用できるようになります。  完全にデータ フローのブロックの実行を取り消すために <xref:System.Threading.Tasks.Dataflow.DataflowBlockOptions.CancellationToken%2A> の使用例については [How to: Cancel a Dataflow Block](../../../docs/standard/parallel-programming/how-to-cancel-a-dataflow-block.md)を参照してください。  
+  
+<a name="ui"></a>   
+## ユーザー インターフェイスからデータ フロー ネットワークをアタッチできます。  
+ ここでは、ユーザー インターフェイスにデータ フロー ネットワークに接続する方法について説明します。  複合イメージの作成および操作のキャンセルが、選択したフォルダーおよび Cancel ボタンから開始されます。  ユーザーがこれらのボタンのいずれかを選択すると、適切なアクションを非同期的に開始されます。  
+  
+#### データ フロー ネットワークをユーザー インターフェイスに接続するには  
+  
+1.  メイン フォームのフォーム デザイナーで、選択したフォルダー ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成します。  
+  
+2.  選択したフォルダー ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベントを実装してください。  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#6](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#6)]  
+  
+3.  メイン フォームのフォーム デザイナーで、キャンセル ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベントのイベント ハンドラーを作成します。  
+  
+4.  キャンセル ボタンの <xref:System.Windows.Forms.ToolStripItem.Click> イベントを実装してください。  
+  
+     [!code-csharp[TPLDataflow_CompositeImages#7](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#7)]  
+  
+<a name="complete"></a>   
+## 完全な例  
+ 次の例では、このチュートリアルの完全なコードを示しています。  
+  
+ [!code-csharp[TPLDataflow_CompositeImages#100](../../../samples/snippets/csharp/VS_Snippets_Misc/tpldataflow_compositeimages/cs/compositeimages/form1.cs#100)]  
+  
+ 次の図は\\Sample の Pictures\\ の共通フォルダーの一般的な出力が表示されます。  
+  
+ ![Windows フォーム アプリケーション](../../../docs/standard/parallel-programming/media/tpldataflow-compositeimages.gif "TPLDataflow\_CompositeImages")  
+  
+## 次の手順  
+  
+## 参照  
+ [データフロー](../../../docs/standard/parallel-programming/dataflow-task-parallel-library.md)
\ No newline at end of file
diff --git a/docs/standard/security/TOC.md b/docs/standard/security/TOC.md
new file mode 100644
index 00000000000..7e2b820ad2b
--- /dev/null
+++ b/docs/standard/security/TOC.md
@@ -0,0 +1,33 @@
+# [暗号サービス](cryptographic-services.md)
+# [セキュリティと競合状態](security-and-race-conditions.md)
+# [方法 : 非対称キーで XML 要素を復号化する](how-to-decrypt-xml-elements-with-asymmetric-keys.md)
+# [方法 : 共通キーで XML 要素を暗号化する](how-to-encrypt-xml-elements-with-symmetric-keys.md)
+# [暗号スキームの作成](creating-a-cryptographic-scheme.md)
+# [プリンシパル オブジェクトの置き換え](replacing-a-principal-object.md)
+# [暗号化と復号化のためのキーの生成](generating-keys-for-encryption-and-decryption.md)
+# [方法 : X.509 証明書で XML 要素を復号化する](how-to-decrypt-xml-elements-with-x-509-certificates.md)
+# [偽装と復帰](impersonating-and-reverting.md)
+# [方法 : ハードウェア暗号化デバイスにアクセスする](how-to-access-hardware-encryption-devices.md)
+# [チュートリアル : 暗号化アプリケーションの作成](walkthrough-creating-a-cryptographic-application.md)
+# [暗号署名](cryptographic-signatures.md)
+# [プリンシパル オブジェクトと ID オブジェクト](principal-and-identity-objects.md)
+# [方法 : XML ドキュメントのデジタル署名を検証する](how-to-verify-the-digital-signatures-of-xml-documents.md)
+# [方法 : 非対称キーで XML 要素を暗号化する](how-to-encrypt-xml-elements-with-asymmetric-keys.md)
+# [データの復号化](decrypting-data.md)
+# [セキュリティ](index.md)
+# [方法 : デジタル署名で XML ドキュメントに署名する](how-to-sign-xml-documents-with-digital-signatures.md)
+# [セキュリティとユーザー入力](security-and-user-input.md)
+# [データの暗号化](encrypting-data.md)
+# [方法 : X.509 証明書で XML 要素を暗号化する](how-to-encrypt-xml-elements-with-x-509-certificates.md)
+# [セキュリティと実行時のコード生成](security-and-on-the-fly-code-generation.md)
+# [方法 : データ保護を使用する](how-to-use-data-protection.md)
+# [方法 : 共通キーで XML 要素を復号化する](how-to-decrypt-xml-elements-with-symmetric-keys.md)
+# [ロール ベース セキュリティ](role-based-security.md)
+# [方法 : WindowsPrincipal プロジェクトを作成する](how-to-create-a-windowsprincipal-object.md)
+# [安全なコーディングのガイドライン](secure-coding-guidelines.md)
+# [方法 : GenericPrincipal オブジェクトと GenericIdentity オブジェクトを作成する](how-to-create-genericprincipal-and-genericidentity-objects.md)
+# [セキュリティの基本概念](key-security-concepts.md)
+# [ハッシュ コードによるデータの整合性の保証](ensuring-data-integrity-with-hash-codes.md)
+# [暗号モデル](cryptography-model.md)
+# [状態データの保護](securing-state-data.md)
+# [方法 : キー コンテナーに非対称キーを格納する](how-to-store-asymmetric-keys-in-a-key-container.md)
diff --git a/docs/standard/security/creating-a-cryptographic-scheme.md b/docs/standard/security/creating-a-cryptographic-scheme.md
new file mode 100644
index 00000000000..e5f40b2d727
--- /dev/null
+++ b/docs/standard/security/creating-a-cryptographic-scheme.md
@@ -0,0 +1,45 @@
+---
+title: "暗号スキームの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework], 作成 (暗号化スキームを)"
+  - "暗号化 [.NET Framework], 作成 (暗号化スキームを)"
+ms.assetid: d40c509f-5a5e-46cc-94cb-a951e9ab6843
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 暗号スキームの作成
+.NET Framework の暗号化コンポーネントを組み合わせて、データの暗号化と復号化を行うさまざまなスキームを作成することができます。  
+  
+ データの暗号化と復号化の単純な暗号スキームでは、次の手順を指定することがあります。  
+  
+1.  暗号化側と復号化側は、公開キーと秘密キーのペアを生成する。  
+  
+2.  暗号化側と復号化側は、公開キーを交換する。  
+  
+3.  暗号化側と復号化側は、たとえば TripleDES 暗号化の秘密キーを生成する。続いて、相手側の公開キーを使用して新規作成されたキーを暗号化する。  
+  
+4.  暗号化側と復号化側は、相手側にデータを送信し、特定の順序で相手側の秘密キーを自分の秘密キーと組み合わせて、新しい秘密キーを作成する。  
+  
+5.  暗号化側と復号化側は、対称暗号化を使って会話を開始する。  
+  
+ 暗号スキームの作成は簡単な作業ではありません。  暗号化の使用の詳細については、http:\/\/msdn.microsoft.com\/library のプラットフォーム SDK ドキュメントにある「暗号化」トピックを参照してください。  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/cryptographic-services.md b/docs/standard/security/cryptographic-services.md
new file mode 100644
index 00000000000..9bc548c15b3
--- /dev/null
+++ b/docs/standard/security/cryptographic-services.md
@@ -0,0 +1,324 @@
+---
+title: "暗号サービス | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework]"
+  - "パターン (派生クラスの継承の)"
+  - "デジタル署名"
+  - "非対称暗号化アルゴリズム"
+  - "デジタル署名, 公開キー システム"
+  - "公開キー"
+  - "復号化 [.NET Framework]"
+  - "秘密キー"
+  - "MAC アルゴリズム"
+  - "暗号アルゴリズム"
+  - "秘密キー, 概要"
+  - "暗号化 [.NET Framework]"
+  - "セキュリティ [.NET Framework], 暗号化"
+  - "暗号化サービス"
+  - "対称暗号化アルゴリズム"
+  - "hash"
+  - "メッセージ認証コード (MAC)"
+  - "派生クラスの継承"
+  - "暗号化 [.NET Framework], 情報"
+  - "乱数生成"
+ms.assetid: f96284bc-7b73-44b5-ac59-fac613ad09f8
+caps.latest.revision: 34
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 34
+---
+# 暗号サービス
+<a name="top"></a> インターネットなどの公衆ネットワークには、エンティティ間の通信を保護する手段が用意されていません。 公衆ネットワークを経由した通信は、不当な第三者によって読み取られたり、さらには変更されたりするおそれがあります。 暗号化を使用すると、データが表示されないように保護し、データが変更されたかどうかを検出する方法を提供し、通常は安全でないチャネル上に安全な通信手段を確立できます。 たとえば、暗号化アルゴリズムを使用してデータを暗号化し、暗号化された状態で送信できます。送信先の相手は、後でこのデータを復号化できます。 暗号化されたデータを第三者が傍受したとしても、復号化するのは困難です。  
+  
+ .NET Framework では、<xref:System.Security.Cryptography?displayProperty=fullName> 名前空間のクラスが暗号化のさまざまな詳細事項を自動的に管理します。 アンマネージ Microsoft Cryptography API \(CryptoAPI\) 用のラッパーもあれば、純粋なマネージ実装もあります。 これらのクラスを使用するにあたって、暗号の専門家になる必要はありません。 いずれかの暗号化アルゴリズム クラスのインスタンスを新しく作成すると、使いやすいようにキーが自動生成されます。また、既定のプロパティは可能な限り安全に保たれます。  
+  
+ ここでは、ClickOnce マニフェスト、Suite B、[!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] で提供される CNG \(Cryptography Next Generation\) サポートなど、.NET Framework でサポートされる暗号化の機能および方法の概要について説明します。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [暗号プリミティブ](#primitives)  
+  
+-   [共有キー暗号方式](#secret_key)  
+  
+-   [公開キー暗号方式](#public_key)  
+  
+-   [デジタル署名](#digital_signatures)  
+  
+-   [ハッシュ値](#hash_values)  
+  
+-   [乱数生成](#random_numbers)  
+  
+-   [ClickOnce マニフェスト](#clickonce)  
+  
+-   [Suite B のサポート](#suite_b)  
+  
+-   [関連トピック](#related_topics)  
+  
+ 暗号化の詳細と、暗号によるセキュリティをアプリケーションに追加できる Microsoft のサービス、コンポーネント、およびツールの詳細については、このドキュメントの「セキュリティ」セクションで、Win32 および COM 開発に関するトピックを参照してください。  
+  
+<a name="primitives"></a>   
+## 暗号プリミティブ  
+ 暗号化が使用される一般的な状況では、二者 \(ここでは Alice と Bob\) が安全でないチャネルを経由して通信します。 Alice と Bob は、通信が第三者に傍受されたとしても、内容は理解されないという保証を必要としています。 また、Alice と Bob は離れた場所にいるため、Alice には、Bob から受け取る情報が送信中に変更されていないという保証が必要です。 さらに Alice には、Bob のふりをしただれかからではなく、本当に Bob からの情報を受け取ることができるという保証が必要です。  
+  
+ 暗号化は、次の目標を達成するために使用されます。  
+  
+-   機密性。ユーザーの ID またはデータが読み取られないように保護するために役立ちます。  
+  
+-   データの整合性。データが変更されないように保護するために役立ちます。  
+  
+-   信憑性。データが特定の人から送信されることを保証します。  
+  
+-   否認不可。特定の人がメッセージを送信したことを拒否することを防止します。  
+  
+ これらの目標を達成するために、暗号プリミティブと呼ばれるアルゴリズムと手法の組み合わせを使用して暗号スキームを作成します。 暗号プリミティブとその用途の一覧を次の表に示します。  
+  
+|暗号プリミティブ|使用|  
+|--------------|--------|  
+|共有キー暗号方式 \(対称暗号化方式\)|データに対して変換処理を実行し、データが第三者に読み取られるのを防ぎます。 このタイプの暗号方式では、単一の共有キーを使用してデータの暗号化と復号化が行われます。|  
+|公開キー暗号方式 \(非対称暗号化方式\)|データに対して変換処理を実行し、データが第三者に読み取られるのを防ぎます。 このタイプの暗号方式では、公開キーと秘密キーのペアを使用してデータの暗号化と復号化が行われます。|  
+|署名の暗号化|送信元に固有のデジタル署名を作成することで、データが特定の人から送信されたことを確認することに役立ちます。 この処理でもハッシュ関数が使用されます。|  
+|暗号ハッシュ|任意の長さのデータを固定長のバイト シーケンスに変換します。 ハッシュは統計的に一意となります。つまり、異なる 2 バイトのシーケンスが同一の値にハッシュされることはありません。|  
+  
+ [ページのトップへ](#top)  
+  
+<a name="secret_key"></a>   
+## 共有キー暗号方式  
+ 共有キー暗号方式のアルゴリズムでは、単一の共有キーを使用したデータの暗号化と復号化が行われます。 キーを取得した人はだれでもデータを復号化したり、独自のデータを暗号化したりできるため、承認されていないエージェントがアクセスしてデータの作成者になりすますことができないように、キーを保護する必要があります。  
+  
+ 共有キー暗号方式は対称暗号化方式とも呼ばれます。これは、暗号化と復号化で同じキーが使用されるためです。 共有キー暗号化アルゴリズムは \(公開キー アルゴリズムと比較して\) 非常に高速であり、大量のデータ ストリームに対して暗号変換を実行する場合に適しています。 RSA などの非対称暗号化アルゴリズムは、暗号化できるデータ量に数学的に制限があります。 通常、対称暗号化アルゴリズムではこれらの問題は発生しません。  
+  
+ データをブロック単位で暗号化するときには、ブロック暗号と呼ばれる共有キー アルゴリズムの種類が使用されます。 DES \(Data Encryption Standard\)、TripleDES、AES \(Advanced Encryption Standard\) などのブロック暗号では、*n* バイトの入力ブロックが、暗号化されたバイト数の出力ブロックに変換されます。 バイト シーケンスを暗号化または復号化する場合は、ブロック単位で行う必要があります。*8* は小さいため \(DES および TripleDES では 8 バイト、AES では 16 バイト \(既定\)、24 バイト、または 32 バイト\)、*8* よりも大きいデータ値は 1 ブロックずつ暗号化する必要があります。*8* よりも小さいデータ値を処理するためには、*8* に拡張する必要があります。  
+  
+ ブロック暗号の 1 つに、ECB \(Electronic Codebook\) モードと呼ばれる単純な形式があります。 ECB モードは、初期化ベクターを使用して最初の平文ブロックを初期化しないため、安全とは見なされません。 秘密キーを *k* とする場合、初期化ベクターを使用しない単純なブロック暗号では、同じ平文の入力ブロックは同じ暗号文の出力ブロックに暗号化されます。 したがって、入力平文ストリーム内に重複するブロックがある場合、暗号文ストリームにも重複するブロックが生成されることになります。 このような重複する出力ブロックが存在すると、アルゴリズムで弱い暗号化が使用されていて、攻撃が可能なモードであることが、承認されていないユーザーにわかります。 このため、ECB 暗号モードは分析に対してきわめて脆弱で、最終的にキーが検出されます。  
+  
+ 基底クラス ライブラリに用意されているブロック暗号クラスでは、暗号ブロック チェイン \(CBC: Cipher Block Chaining\) と呼ばれる既定のチェイン モードが使用されます。ただし、この既定のモードは必要に応じて変更できます。  
+  
+ CBC 暗号は、初期化ベクター \(IV: Initialization Vector\) を使用して平文の最初のブロックを暗号化することにより、ECB 暗号に関連する問題を回避します。 平文の後続の各ブロックは、前の暗号文ブロックを使用してビットごとの排他的 OR \(`XOR`\) 演算を実行してから、暗号化されます。 このため、各平文ブロックは、前のすべてのブロックに依存します。 このシステムを使用した場合は、承認されていないユーザーが共通メッセージ ヘッダーを知っていたとしても、その情報からキーをリバース エンジニアリングすることはできません。  
+  
+ CBC 暗号によって暗号化されたデータを解読する 1 つの方法は、考えられるすべてのキーを徹底的に探索することです。 ただし、暗号化の実行時に使用したキーのサイズによっては、どれほど高速なコンピューターを使用してもかなりの時間がかかるため、この探索方法は現実的ではありません。 キーのサイズを大きくするほど、復号化は困難になります。 暗号化することにより、暗号データの復号化が理論的に不可能になるわけではありませんが、復号化にかかるコストを大きくできます。 3 か月をかけて徹底的な探索を行っても、取得されたデータが数日間しか意味を持たないとすると、その探索方法は実用的とはいえません。  
+  
+ 共有キー暗号方式の弱点は、両者のキーと IV を一致させ、それぞれの値を転送しておく必要がある点です。 IV は秘密情報とは見なされないため、平文のメッセージで転送できます。 しかし、キーは承認されていないユーザーから保護する必要があります。 このような問題のため、共有キー暗号方式は公開キー暗号方式と併用されることがよくあります。公開キー暗号方式は、キーと IV の値を秘密に通信するために使用されます。  
+  
+ 安全でないチャネルを経由して Alice と Bob が通信しようとしている場合は、次のように共有キー暗号方式を使用することが考えられます。Alice と Bob は、特定の 1 つのアルゴリズム \(たとえば AES\) と、特定のキーおよび IV を使用することに合意します。 Alice はメッセージを作成し、メッセージを送信するためのネットワーク ストリーム \(名前付きパイプやネットワーク電子メールが考えられます\) を作成します。 次に、キーと IV を使用してテキストを暗号化し、暗号化されたメッセージと IV をインターネット経由で Bob に送信します。 暗号化されたテキストを受信した Bob は、IV とあらかじめ決めてあるキーを使用して復号化を行います。 通信が傍受されたとしても、傍受した人にはキーがわからないため、元のメッセージが復元されることはありません。 このシナリオでは、秘密にしておく必要があるのはキーだけです。 実際のシナリオでは、Alice または Bob のどちらかが共有キーを生成し、公開キー \(非対称\) 暗号方式を使用して相手に共有 \(対称\) キーを転送することになります。 公開キー暗号方式の詳細については、次のセクションを参照してください。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、共有キー暗号化アルゴリズムを実装する次のクラスが用意されています。  
+  
+-   <xref:System.Security.Cryptography.AesManaged> \([!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] で導入\)。  
+  
+-   <xref:System.Security.Cryptography.DESCryptoServiceProvider>。  
+  
+-   <xref:System.Security.Cryptography.HMACSHA1>。これは、暗号ハッシュ関数を共有キーと組み合わせて使用することで計算されるメッセージ認証コードを表すため、技術的には共有キー アルゴリズムです。 後で説明する「[ハッシュ値](#hash_values)」を参照してください。  
+  
+-   <xref:System.Security.Cryptography.RC2CryptoServiceProvider>。  
+  
+-   <xref:System.Security.Cryptography.RijndaelManaged>。  
+  
+-   <xref:System.Security.Cryptography.TripleDESCryptoServiceProvider>。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="public_key"></a>   
+## 公開キー暗号方式  
+ 公開キー暗号方式では、承認されていないユーザーから保護する必要のある秘密キーと、だれに公開してもかまわない公開キーが使用されます。 公開キーと秘密キーは正確にリンクされ、公開キーで暗号化されたデータは、対応する秘密キーでしか復号化できません。また、秘密キーで署名されたデータは、対応する公開キーでしか検査できません。 公開キーはだれに公開してもかまいません。公開キーは、秘密キーの所有者に送信するデータを暗号化するために使用されます。 公開キー暗号化アルゴリズムは、非対称アルゴリズムとしても知られています。これは、データの暗号化に 1 つのキーが使用され、データの復号化に別のキーが使用されるためです。 基本的な暗号化規則でキーの再使用を禁止し、いずれのキーも通信セッションごとに一意にする必要があります。 ただし、実際には、非対称キーの寿命は長いことが一般的です。  
+  
+ 二者 \(ここでは Alice と Bob\) は、次のように公開キーの暗号化を使用できます。まず、Alice が公開キー\/秘密キーのペアを生成します。 暗号メッセージを Alice に送信するとき、Bob は Alice に公開キーを送信するように依頼します。 Alice は安全でないネットワークを通して Bob に公開キーを送信し、Bob はこのキーを使用してメッセージを暗号化します。 Bob は暗号メッセージを Alice に送信し、Alice は自分の秘密キーを使用してメッセージを復号化します。 公衆ネットワークなどの安全でないチャネル経由で Alice のキーを受信した場合、Bob は man\-in\-the\-middle 攻撃に対して無防備になります。 したがって、Bob は所有している Alice の公開キーの正しいコピーを使用して、Alice であることを検証する必要があります。  
+  
+ Alice の公開キーの転送中に、承認されていないエージェントによってキーが傍受される可能性があります。 さらに、同じエージェントが Bob からの暗号メッセージを傍受する可能性もあります。 しかし、公開キーを使用してもメッセージを復号化することはできません。 メッセージを復号化できるのは Alice の秘密キーだけですが、これは送信されていません。 Alice は Bob への返信メッセージを暗号化するときに自分の秘密キーを使用しません。公開キーを持つ人は、だれでもそのメッセージを復号化できるためです。 Alice から Bob にメッセージを返信するときには、Alice が Bob の公開キーをたずね、その公開キーを使用してメッセージを暗号化します。 その後、Bob は自分の秘密キーを使用してメッセージを復号化します。  
+  
+ このシナリオでは、Alice と Bob は公開キー \(非対称\) 暗号方式を使用して共有 \(対称\) キーを転送し、その他のセッションでは共有キー暗号方式を使用することになります。  
+  
+ 次の一覧を使用して、公開キーと共有キーの暗号化アルゴリズムを比較します。  
+  
+-   公開キー暗号化アルゴリズムでは固定バッファー サイズが使用されますが、共有キー暗号化アルゴリズムでは可変長バッファーが使用されます。  
+  
+-   公開キー アルゴリズムでは少量のデータしか暗号化できないため、共有キー アルゴリズムのようにデータをチェインしてストリームを作成することはできません。 したがって、非対称操作では対称操作と同じストリーミング モデルは使用されません。  
+  
+-   公開キーの暗号化方式では、秘密キーの暗号化と比較してキーのキースペース \(使用できる値の範囲\) が大幅に広がります。 そのため、公開キーの暗号化では、あらゆるキーを試すような徹底的な攻撃の影響を受けにくくなります。  
+  
+-   送信元の身元を検証する方法が存在する場合、公開キーは保護する必要なく簡単に配布できます。  
+  
+-   いくつかの公開キー アルゴリズム \(Diffie\-Hellman 以外の RSA や DSA など\) では、データの送信元の身元を検査するデジタル署名を作成できます。  
+  
+-   公開キー アルゴリズムは秘密キー アルゴリズムと比較してきわめて低速であり、大量のデータを暗号化するようには設計されていません。 公開キー アルゴリズムが便利なのは、少量のデータを転送する場合に限られます。 一般に、公開キー暗号方式は、共有キー アルゴリズムで使われるキーと IV を暗号化するために使用されます。 キーと IV を転送した後の残りのセッションでは、共有キー暗号方式が使用されます。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、公開キー暗号化アルゴリズムを実装する次のクラスが用意されています。  
+  
+-   <xref:System.Security.Cryptography.DSACryptoServiceProvider>  
+  
+-   <xref:System.Security.Cryptography.RSACryptoServiceProvider>  
+  
+-   <xref:System.Security.Cryptography.ECDiffieHellman> \(基底クラス\)  
+  
+-   <xref:System.Security.Cryptography.ECDiffieHellmanCng>  
+  
+-   <xref:System.Security.Cryptography.ECDiffieHellmanCngPublicKey> \(基底クラス\)  
+  
+-   <xref:System.Security.Cryptography.ECDiffieHellmanKeyDerivationFunction> \(基底クラス\)  
+  
+-   <xref:System.Security.Cryptography.ECDsaCng>  
+  
+ RSA は暗号化と署名の両方に使用できますが、DSA は署名にのみ使用可能で、Diffie\-Hellman はキー生成にのみ使用可能です。 一般に、秘密キー アルゴリズムに比べて、公開キー アルゴリズムの使用には多くの制限があります。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="digital_signatures"></a>   
+## デジタル署名  
+ 公開キー アルゴリズムは、デジタル署名を形成するためにも使用できます。 デジタル署名は、\(送信元の公開キーを信頼している場合に\) 送信元の ID を認証したり、データの整合性を保護することを支援したりします。 Alice によって生成された公開キーを使用すると、Alice のデータの受信者は、Alice のデータに添付されたデジタル署名と Alice の公開キーを比較することによって、データの送信元が Alice かどうかを検査できます。  
+  
+ Alice は、公開キー暗号方式を使用してメッセージにデジタル署名を添付するために、まずメッセージに対してハッシュ アルゴリズムを適用してメッセージ ダイジェストを作成します。 このメッセージ ダイジェストは、一意でコンパクトなデータ表現です。 次に Alice は、自分の秘密キーを使用してメッセージ ダイジェストを暗号化し、個人用の署名を作成します。 Bob は、メッセージと署名を受信したときに Alice の公開キーを使用して署名を復号化し、メッセージ ダイジェストを復元します。そして、Alice が使用したのと同じハッシュ アルゴリズムを使用してメッセージをハッシュします。 Bob が計算したメッセージ ダイジェストが Alice から受け取ったメッセージ ダイジェストと正確に一致する場合、そのメッセージは秘密キーの所有者から送信されたことになり、データも変更されていないことが保証されます。 Alice が秘密キーの所有者であることが確かならば、Bob にはメッセージが Alice から送信されたことがわかります。  
+  
+> [!NOTE]
+>  送信者の公開キーは公開された情報であり、通常はデジタル署名の書式に含まれるため、だれでも署名を検査できます。 この方法では、メッセージの秘密性は保持されません。メッセージを秘密にしておくためには、メッセージ自体も暗号化する必要があります。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、デジタル署名アルゴリズムを実装する次のクラスが用意されています。  
+  
+-   <xref:System.Security.Cryptography.DSACryptoServiceProvider>  
+  
+-   <xref:System.Security.Cryptography.RSACryptoServiceProvider>  
+  
+-   <xref:System.Security.Cryptography.ECDsa> \(基底クラス\)  
+  
+-   <xref:System.Security.Cryptography.ECDsaCng>  
+  
+ [ページのトップへ](#top)  
+  
+<a name="hash_values"></a>   
+## ハッシュ値  
+ ハッシュ アルゴリズムは、任意の長さのバイナリ値を、ハッシュ値と呼ばれるより小さい固定長のバイナリ値に変換します。 ハッシュ値は、ひとまとまりのデータを数値で表現したものです。 平文の段落のハッシュを計算してから、段落の 1 文字だけでも変更すると、その後のハッシュでは別の値が生成されることになります。 強力な暗号化におけるハッシュは、値が大幅に変わります。 たとえば、メッセージの 1 ビットを変更すると、強力なハッシュ関数では 50% 異なる出力が生成されます。 多くの入力値が同じ出力値にハッシュされる場合があります。 ただし、同一の値にハッシュされる 2 つの異なる入力を見つけることは、計算上不可能です。  
+  
+ 二者 \(ここでは Alice と Bob\) は、ハッシュ関数を使用してメッセージの整合性を確保できます。 Alice と Bob はハッシュ アルゴリズムを選択してメッセージに署名します。 Alice はメッセージを書き込み、選択したアルゴリズムを使用してそのメッセージのハッシュを作成します。 そして、次のいずれかの方法を使用します。  
+  
+-   Alice はプレーンテキスト メッセージとハッシュしたメッセージ \(デジタル署名\) を Bob に送信します。 Bob はメッセージを受信してハッシュ値を計算し、算出したハッシュ値を Alice から受け取ったハッシュ値と比較します。 ハッシュ値が同一の場合、メッセージは変更されていません。 ハッシュ値が同一でない場合は、Alice がメッセージを作成した後でその内容が変更されています。  
+  
+     残念ながら、この方法では送信元の信頼性を保証できません。 どのユーザーでも Alice を偽装して Bob にメッセージを送信できます。 だれもが同じハッシュ アルゴリズムを使用してメッセージに署名できます。Bob が判断できるのは、メッセージがその署名と一致するかどうかだけです。 これは、一種の man\-in\-the\-middle 攻撃です。 詳細については、「[NIB: CNG \(Cryptography Next Generation\) のセキュリティで保護された通信の例](http://msdn.microsoft.com/ja-jp/8048e94e-054a-417b-87c6-4f5e26710e6e)」を参照してください。  
+  
+-   Alice はセキュリティで保護されていないパブリック チャネルを使用して、Bob にプレーンテキスト メッセージを送信します。 そして、セキュリティで保護されたプライベート チャネルを使用して、Bob にハッシュしたメッセージを送信します。 Bob はプレーンテキスト メッセージを受信し、ハッシュを計算して、プライベートに交換したハッシュと比較します。 ハッシュが一致すると、Bob は次の 2 つのことを判断できます。  
+  
+    -   メッセージが変更されていないこと。  
+  
+    -   メッセージの送信元 \(Alice\) は認証されていること。  
+  
+     このしくみを機能させるために、Alice は元のハッシュ値を Bob 以外の人から隠す必要があります。  
+  
+-   Alice はセキュリティで保護されていないパブリック チャネルを使用して Bob にプレーンテキスト メッセージを送信し、パブリックに参照できる Web サイトにハッシュしたメッセージを配置します。  
+  
+     この方法は、だれかがハッシュ値を変更することを防ぐことで、メッセージの改ざんを防止します。 メッセージとそのハッシュ値はどのユーザーでも読み取ることができますが、ハッシュ値を変更できるのは Alice だけです。 Alice を偽装しようとする攻撃者は、Alice の Web サイトにアクセスする必要があります。  
+  
+ Alice のメッセージはプレーンテキストで送信されるため、前に説明した方法では、Alice のメッセージがだれかから読み取られないように防ぐことはできません。 セキュリティを完全にするには、一般に、デジタル署名 \(メッセージ署名\) と暗号化が必要です。  
+  
+ [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、ハッシュ アルゴリズムを実装する次のクラスが用意されています。  
+  
+-   <xref:System.Security.Cryptography.HMACSHA1>。  
+  
+-   <xref:System.Security.Cryptography.MACTripleDES>。  
+  
+-   <xref:System.Security.Cryptography.MD5CryptoServiceProvider>。  
+  
+-   <xref:System.Security.Cryptography.RIPEMD160>。  
+  
+-   <xref:System.Security.Cryptography.SHA1Managed>。  
+  
+-   <xref:System.Security.Cryptography.SHA256Managed>。  
+  
+-   <xref:System.Security.Cryptography.SHA384Managed>。  
+  
+-   <xref:System.Security.Cryptography.SHA512Managed>。  
+  
+-   SHA \(Secure Hash Algorithm\)、MD5 \(Message Digest 5\)、および RIPEMD\-160 の各アルゴリズムすべての HMAC バリアント。  
+  
+-   すべての SHA アルゴリズムの CryptoServiceProvider 実装 \(マネージ コード ラッパー\)。  
+  
+-   すべての MD5 アルゴリズムおよび SHA アルゴリズムの CNG \(Cryptography Next Generation\) 実装。  
+  
+> [!NOTE]
+>  1996 年に MD5 に設計上の欠陥が発見され、代わりに SHA\-1 が推奨されました。 2004 年には、新しい欠陥が発見され、MD5 は安全なアルゴリズムと見なされなくなりました。 SHA\-1 アルゴリズムも安全でないことがわかり、現在は SHA\-2 が推奨されています。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="random_numbers"></a>   
+## 乱数生成  
+ 乱数生成は、多くの暗号化操作に欠かせない部分です。 たとえば、暗号キーはできるだけランダムにして、再現できないようにする必要があります。 暗号乱数ジェネレーターは、予測される確率が 50% よりも低い、計算上は不可能な出力を生成しなければなりません。 したがって、当て推量をされた場合でも予測できないような手段を使用する必要があります。[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] に含まれるクラスは、乱数ジェネレーターを使用して暗号キーを生成します。  
+  
+ 乱数ジェネレーター アルゴリズムは、<xref:System.Security.Cryptography.RNGCryptoServiceProvider> クラスに実装されています。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="clickonce"></a>   
+## ClickOnce マニフェスト  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] では、次の暗号化クラスを使用して、[ClickOnce テクノロジ](../Topic/ClickOnce%20Security%20and%20Deployment.md)を使用して配置されたアプリケーションのマニフェストの署名に関する情報を取得および検証できます。  
+  
+-   <xref:System.Security.Cryptography.ManifestSignatureInformation> クラスは、<xref:System.Security.Cryptography.ManifestSignatureInformation.VerifySignature%2A> メソッド オーバーロードの使用時に、マニフェストの署名に関する情報を取得します。  
+  
+-   検証するマニフェストを指定するには、<xref:System.Security.ManifestKinds> 列挙体を使用します。 検証の結果は、<xref:System.Security.Cryptography.SignatureVerificationResult> のいずれかの列挙値になります。  
+  
+-   <xref:System.Security.Cryptography.ManifestSignatureInformationCollection> クラスは、検証された署名の <xref:System.Security.Cryptography.ManifestSignatureInformation> オブジェクトの読み取り専用コレクションを提供します。  
+  
+ 特定の署名情報を提供するクラスとしては、他にも次のようなものがあります。  
+  
+-   <xref:System.Security.Cryptography.StrongNameSignatureInformation> は、マニフェストの厳密な名前の署名情報を保持します。  
+  
+-   <xref:System.Security.Cryptography.X509Certificates.AuthenticodeSignatureInformation> は、マニフェストの Authenticode 署名情報を表します。  
+  
+-   <xref:System.Security.Cryptography.X509Certificates.TimestampInformation> は、Authenticode 署名のタイム スタンプ情報を保持します。  
+  
+-   <xref:System.Security.Cryptography.X509Certificates.TrustStatus> は、Authenticode 署名が信頼済みかどうかを簡単な方法でチェックできます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="suite_b"></a>   
+## Suite B のサポート  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] は、米国国家安全保障局 \(NSA: National Security Agency\) によって公開された暗号化アルゴリズム Suite B セットをサポートしています。 Suite B の詳細については、「[NSA の Suite B 暗号化に関するファクト シート](http://go.microsoft.com/fwlink/?LinkId=100111)」を参照してください。  
+  
+ 次のアルゴリズムが含まれています。  
+  
+-   キー サイズが 128 ビット、192 ビット、および 256 ビットの AES \(Advanced Encryption Standard\) アルゴリズム。暗号化に使用されます。  
+  
+-   Secure Hash Algorithm \(SHA\-1、SHA\-256、SHA\-384、および SHA\-512\)。ハッシュ化に使用されます  \(通常、最後の 3 つはまとめて SHA\-2 と呼ばれます\)。  
+  
+-   256 ビット、384 ビット、および 521 ビットの素数の曲線を使用した ECDSA \(Elliptic Curve Digital Signature Algorithm\)。署名に使用されます。 NSA のドキュメントでは、これらの曲線が具体的に定義され、P\-256、P\-384、および P\-521 と呼ばれています。 このアルゴリズムは、<xref:System.Security.Cryptography.ECDsaCng> クラスによって提供されます。 秘密キーを使用して署名したり、公開キーを使用した署名を検証したりできます。  
+  
+-   256 ビット、384 ビット、および 521 ビットの素数の曲線を使用した ECDH \(Elliptic Curve Diffie\-Hellman\) アルゴリズム。キーの交換と秘密協定に使用されます。 このアルゴリズムは、<xref:System.Security.Cryptography.ECDiffieHellmanCng> クラスによって提供されます。  
+  
+ 新たに追加された <xref:System.Security.Cryptography.AesCryptoServiceProvider>、<xref:System.Security.Cryptography.SHA256CryptoServiceProvider>、<xref:System.Security.Cryptography.SHA384CryptoServiceProvider>、<xref:System.Security.Cryptography.SHA512CryptoServiceProvider> の各クラスでは、連邦情報処理規格 \(FIPS: Federal Information Processing Standard\) によって認定された AES、SHA\-256、SHA\-384、および SHA\-512 実装のマネージ コード ラッパーを使用できます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="cng"></a>   
+## CNG \(Cryptography Next Generation\) クラス  
+ CNG のクラスには、ネイティブ CNG 関数を扱うマネージ ラッパーが用意されています  \(CNG は CryptoAPI に代わるものです\)。 これらのクラスは、名前の一部に "Cng" が使用されています。 CNG ラッパー クラスの中心は、CNG キーのストレージと使用を抽象化する <xref:System.Security.Cryptography.CngKey> キー コンテナー クラスです。 このクラスにより、キー ペアまたは公開キーを安全に格納したり、単純な文字列名を使って参照したりすることが可能になります。 楕円曲線ベースの <xref:System.Security.Cryptography.ECDsaCng> 署名クラスおよび <xref:System.Security.Cryptography.ECDiffieHellmanCng> 暗号化クラスは、<xref:System.Security.Cryptography.CngKey> オブジェクトを使用できます。  
+  
+ <xref:System.Security.Cryptography.CngKey> クラスは、キーを開く、作成する、削除する、エクスポートするなど、さまざまな補足的な操作に使用されます。 また、ネイティブ関数を直接呼び出すときに使用する、基になるキー ハンドルへのアクセスも提供します。  
+  
+ [!INCLUDE[net_v35_short](../../../includes/net-v35-short-md.md)] には、次のような CNG に関連したクラスも含まれています。  
+  
+-   <xref:System.Security.Cryptography.CngProvider> は、キー ストレージ プロバイダーを管理します。  
+  
+-   <xref:System.Security.Cryptography.CngAlgorithm> は、CNG アルゴリズムを管理します。  
+  
+-   <xref:System.Security.Cryptography.CngProperty> は、よく使用される主要なプロパティを管理します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="related_topics"></a>   
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[暗号モデル](../../../docs/standard/security/cryptography-model.md)|基底クラス ライブラリに暗号化がどのように実装されているかについて説明します。|  
+|[チュートリアル : 暗号化アプリケーションの作成](../../../docs/standard/security/walkthrough-creating-a-cryptographic-application.md)|基本的な暗号化タスクと復号化タスクについて説明します。|  
+|[暗号化クラスの設定](../../../docs/framework/configure-apps/configure-cryptography-classes.md)|アルゴリズム名を暗号クラスに割り当てる方法と、オブジェクト ID を暗号化アルゴリズムに割り当てる方法について説明します。|
\ No newline at end of file
diff --git a/docs/standard/security/cryptographic-signatures.md b/docs/standard/security/cryptographic-signatures.md
new file mode 100644
index 00000000000..43fb2d3e636
--- /dev/null
+++ b/docs/standard/security/cryptographic-signatures.md
@@ -0,0 +1,110 @@
+---
+title: "暗号署名 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework], シグネチャ"
+  - "デジタル署名"
+  - "デジタル署名, 概要"
+  - "デジタル署名, 生成"
+  - "デジタル署名, 検査"
+  - "デジタル署名, XML 署名"
+  - "暗号化 [.NET Framework], シグネチャ"
+  - "生成 (署名を)"
+  - "セキュリティ [.NET Framework], シグネチャ"
+  - "シグネチャ, 暗号化"
+  - "署名 (XML に)"
+  - "検査 (署名を)"
+  - "XML 署名"
+ms.assetid: aa87cb7f-e608-4a81-948b-c9b8a1225783
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 暗号署名
+<a name="top"></a> 暗号デジタル署名は、公開キー アルゴリズムを使用してデータの整合性を提供します。 デジタル署名を使用してデータに署名すると、第三者が署名を検証し、データが署名者から発信され、署名後に変更されていないことを証明できます。 デジタル署名の詳細については、「[暗号サービス](../../../docs/standard/security/cryptographic-services.md)」を参照してください。  
+  
+ ここでは、<xref:System.Security.Cryptography?displayProperty=fullName> 名前空間のクラスを使用してデジタル署名を生成して検証する方法について説明します。  
+  
+-   [署名の生成](#generate)  
+  
+-   [署名の検証](#verify)  
+  
+<a name="generate"></a>   
+## 署名の生成  
+ デジタル署名は、通常、大きなデータを表現するハッシュ値に適用されます。 ハッシュ値にデジタル署名を適用する例を次に示します。 まず、<xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスの新しいインスタンスを作成して、公開キー\/秘密キーのペアを生成します。 次に、<xref:System.Security.Cryptography.RSACryptoServiceProvider> を <xref:System.Security.Cryptography.RSAPKCS1SignatureFormatter> クラスの新しいインスタンスに渡します。 これにより、デジタル署名を実際に実行する <xref:System.Security.Cryptography.RSAPKCS1SignatureFormatter> に秘密キーが渡されます。 ハッシュ コードに署名するためには、使用するハッシュ アルゴリズムを指定する必要があります。 この例では、SHA1 アルゴリズムを使用します。 最後に、<xref:System.Security.Cryptography.AsymmetricSignatureFormatter.CreateSignature%2A> メソッドを呼び出して署名を実行します。  
+  
+```vb  
+Imports System Imports System.Security.Cryptography Module Module1 Sub Main() 'The hash value to sign. Dim HashValue As Byte() = {59, 4, 248, 102, 77, 97, 142, 201, 210, 12, 224, 93, 25, 41, 100, 197, 213, 134, 130, 135} 'The value to hold the signed value. Dim SignedHashValue() As Byte 'Generate a public/private key pair. Dim RSA As New RSACryptoServiceProvider() 'Create an RSAPKCS1SignatureFormatter object and pass it 'the RSACryptoServiceProvider to transfer the private key. Dim RSAFormatter As New RSAPKCS1SignatureFormatter(RSA) 'Set the hash algorithm to SHA1. RSAFormatter.SetHashAlgorithm("SHA1") 'Create a signature for HashValue and assign it to 'SignedHashValue. SignedHashValue = RSAFormatter.CreateSignature(HashValue) End Sub End Module using System; using System.Security.Cryptography;  
+  
+```  
+  
+```csharp  
+class Class1 { static void Main() { //The hash value to sign. byte[] HashValue = {59,4,248,102,77,97,142,201,210,12,224,93,25,41,100,197,213,134,130,135}; //The value to hold the signed value. byte[] SignedHashValue; //Generate a public/private key pair. RSACryptoServiceProvider RSA = new RSACryptoServiceProvider(); //Create an RSAPKCS1SignatureFormatter object and pass it the //RSACryptoServiceProvider to transfer the private key. RSAPKCS1SignatureFormatter RSAFormatter = new RSAPKCS1SignatureFormatter(RSA); //Set the hash algorithm to SHA1. RSAFormatter.SetHashAlgorithm("SHA1"); //Create a signature for HashValue and assign it to //SignedHashValue. SignedHashValue = RSAFormatter.CreateSignature(HashValue); } }  
+```  
+  
+### XML ファイルへの署名  
+ .NET Framework に用意されている <xref:System.Security.Cryptography.Xml> 名前空間を使用すると、XML に署名できます。 XML が特定のソースから送信されたことを検証する場合は、XML への署名が重要です。 たとえば、XML を使用する株価情報サービスを使用している場合であれば、署名されているかどうかによって XML のソースを検証できます。  
+  
+ この名前空間のクラスは、World Wide Web コンソーシアムの「[XML 署名の構文と処理に関する勧告](http://go.microsoft.com/fwlink/?LinkId=136777)」に従っています。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="verify"></a>   
+## 署名の検証  
+ データが特定の関係者によって署名されたことを検証するには、次の情報が必要です。  
+  
+-   データに署名した関係者の公開キー。  
+  
+-   デジタル署名。  
+  
+-   署名されたデータ。  
+  
+-   署名者が使用したハッシュ アルゴリズム。  
+  
+ <xref:System.Security.Cryptography.RSAPKCS1SignatureFormatter> クラスによって署名された署名を検証するには、<xref:System.Security.Cryptography.RSAPKCS1SignatureDeformatter> クラスを使用します。<xref:System.Security.Cryptography.RSAPKCS1SignatureDeformatter> クラスに対しては、署名者の公開キーを提供する必要があります。 公開キーを指定するには、剰余値と指数部の値が必要になります  \(これらの値は、公開キーと秘密キーのペアの作成者が提供する必要があります\)。 まず、署名を検証する公開キーを保持するための <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトを作成します。次に、<xref:System.Security.Cryptography.RSAParameters> 構造体を、公開キーを指定する剰余値と指数部の値で初期化します。  
+  
+ 次のコードは、<xref:System.Security.Cryptography.RSAParameters> 構造体の作成を示しています。`Modulus` プロパティは `ModulusData` というバイト配列の値に設定し、`Exponent` プロパティは `ExponentData` というバイト配列の値に設定します。  
+  
+```vb  
+Dim RSAKeyInfo As RSAParameters RSAKeyInfo.Modulus = ModulusData RSAKeyInfo.Exponent = ExponentData  
+  
+```  
+  
+```csharp  
+RSAParameters RSAKeyInfo; RSAKeyInfo.Modulus = ModulusData; RSAKeyInfo.Exponent = ExponentData;  
+```  
+  
+ <xref:System.Security.Cryptography.RSAParameters> オブジェクトを作成した後、<xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスの新しいインスタンスを <xref:System.Security.Cryptography.RSAParameters> で指定した値に初期設定できます。 次に、<xref:System.Security.Cryptography.RSACryptoServiceProvider> を <xref:System.Security.Cryptography.RSAPKCS1SignatureDeformatter> のコンストラクターに渡してキーを転送します。  
+  
+ このプロセスを説明する例を次に示します。 この例で、`HashValue` と `SignedHashValue` は、リモートにいる関係者から提供されるバイト配列です。 リモートにいる関係者は、SHA1 アルゴリズムを使用して `HashValue` に署名し、デジタル署名 `SignedHashValue` を生成します。 、  
+  
+ <xref:System.Security.Cryptography.RSAPKCS1SignatureDeformatter.VerifySignature%2A?displayProperty=fullName> メソッドは、デジタル署名が有効であることと、そのデジタル署名を使用して `HashValue` が署名されたことを検証します。  
+  
+```vb  
+Dim RSA As New RSACryptoServiceProvider() RSA.ImportParameters(RSAKeyInfo) Dim RSADeformatter As New RSAPKCS1SignatureDeformatter(RSA) RSADeformatter.SetHashAlgorithm("SHA1") If RSADeformatter.VerifySignature(HashValue, SignedHashValue) Then Console.WriteLine("The signature is valid.") Else Console.WriteLine("The signture is not valid.") End If  
+  
+```  
+  
+```csharp  
+RSACryptoServiceProvider RSA = new RSACryptoServiceProvider(); RSA.ImportParameters(RSAKeyInfo); RSAPKCS1SignatureDeformatter RSADeformatter = new RSAPKCS1SignatureDeformatter(RSA); RSADeformatter.SetHashAlgorithm("SHA1"); if(RSADeformatter.VerifySignature(HashValue, SignedHashValue)) { Console.WriteLine("The signature is valid."); } else { Console.WriteLine("The signature is not valid."); }  
+```  
+  
+ 上記のコードでは、署名が有効であれば "`The signature is valid`" を表示し、署名が無効であれば "`The signature is not valid`" を表示します。  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/cryptography-model.md b/docs/standard/security/cryptography-model.md
new file mode 100644
index 00000000000..724ce3c121e
--- /dev/null
+++ b/docs/standard/security/cryptography-model.md
@@ -0,0 +1,101 @@
+---
+title: ".NET Framework の暗号モデル | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework], モデル"
+  - "暗号化 [.NET Framework], モデル"
+ms.assetid: 12fecad4-fbab-432a-bade-2f05976a2971
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# .NET Framework の暗号モデル
+.NET Framework は、多くの標準的な暗号化アルゴリズムの実装を提供します。  これらのアルゴリズムは簡単に使用でき、またできるだけ安全な既定のプロパティを提供しています。  さらに、オブジェクトの継承、ストリームの設計、および構成の .NET Framework の暗号モデルは非常に拡張性に優れています。  
+  
+## オブジェクトの継承  
+ .NET Framework のセキュリティ システムは、拡張可能な派生クラス継承のパターンを実装しています。  階層は次のとおりです。  
+  
+-   <xref:System.Security.Cryptography.SymmetricAlgorithm>、<xref:System.Security.Cryptography.AsymmetricAlgorithm> または <xref:System.Security.Cryptography.HashAlgorithm> などのアルゴリズム型クラス。  このレベルは抽象レベルです。  
+  
+-   <xref:System.Security.Cryptography.Aes>、<xref:System.Security.Cryptography.RC2>、または <xref:System.Security.Cryptography.ECDiffieHellman> など、アルゴリズム型クラスから継承されるアルゴリズム クラス。  このレベルは抽象レベルです。  
+  
+-   <xref:System.Security.Cryptography.AesManaged>、<xref:System.Security.Cryptography.RC2CryptoServiceProvider>、または <xref:System.Security.Cryptography.ECDiffieHellmanCng> など、アルゴリズム クラスから継承されるアルゴリズム クラスの実装。  このレベルは完全に実装されます。  
+  
+ 派生クラスのこのパターンを使用すると、新しいアルゴリズムの追加、または既存アルゴリズムの新規実装の追加を簡単に行えます。  たとえば、新しい公開キー アルゴリズムを作成するには、<xref:System.Security.Cryptography.AsymmetricAlgorithm> クラスから継承します。  特定のアルゴリズムの実装を新しく作成するには、そのアルゴリズムの非抽象派生クラスを作成します。  
+  
+## .NET Framework でアルゴリズムを実装する方法  
+ アルゴリズムに使用できるさまざまな実装例として、対称アルゴリズムを検討します。  すべての対称アルゴリズムのベースは <xref:System.Security.Cryptography.SymmetricAlgorithm> であり、次のアルゴリズムによって継承されます。  
+  
+1.  <xref:System.Security.Cryptography.Aes>  
+  
+2.  <xref:System.Security.Cryptography.DES>  
+  
+3.  <xref:System.Security.Cryptography.RC2>  
+  
+4.  <xref:System.Security.Cryptography.Rijndael>  
+  
+5.  <xref:System.Security.Cryptography.TripleDES>  
+  
+ <xref:System.Security.Cryptography.Aes> は、<xref:System.Security.Cryptography.AesCryptoServiceProvider> と <xref:System.Security.Cryptography.AesManaged> の 2 つのクラスによって継承されます。  <xref:System.Security.Cryptography.AesCryptoServiceProvider> クラスは Aes の Windows 暗号化 API \(CAPI\) 実装のラッパーですが、<xref:System.Security.Cryptography.AesManaged> クラスは全体がマネージ コードで書かれています。  さらに、マネージ実装と CAPI 実装に加え、3 つ目の実装、Cryptography Next Generation \(CNG\) もあります。  CNG アルゴリズムの例が <xref:System.Security.Cryptography.ECDiffieHellmanCng> です。  CNG アルゴリズムは、Windows Vista 以降のバージョンで利用可能です。  
+  
+ ご自身にとって最適な実装を選択できます。  マネージ実装は、.NET Framework をサポートするすべてのプラットフォームで利用できます。  CAPI 実装は、以前のオペレーティング システムで使用可能ですが、開発中止となっています。  CNG はまさに最新の実装であり、新しい開発が行われます。  ただし、マネージ実装は連邦情報処理規格 \(FIPS: Federal Information Processing Standard\) に認定されておらず、ラッパー クラスよりも低速である場合があります。  
+  
+## ストリーム デザイン  
+ 共通言語ランタイムは、対称アルゴリズムおよびハッシュ アルゴリズムを実装するためのストリーム指向デザインを使用しています。  この設計の中心となるは、<xref:System.IO.Stream> クラスから派生する <xref:System.Security.Cryptography.CryptoStream> クラスです。  ストリーム ベースの暗号化オブジェクトは、単一の標準インターフェイス \(`CryptoStream`\) をサポートし、オブジェクトのデータ転送部分を処理します。  すべてのオブジェクトは標準のインターフェイス上に構築されるため、複数のオブジェクト \(ハッシュ オブジェクトに続く暗号化オブジェクトなど\) を連結したり、データ用の中間ストレージなしでデータ上で複数の操作を実行したりできます。  また、ストリーミング モデルを使用して、より小さなオブジェクトからオブジェクトを構築することもできます。  たとえば、複合暗号化とハッシュ アルゴリズムは 1 つのストリーム オブジェクトと見ることができますが、このオブジェクトは一連の複数のストリーム オブジェクトから作成されているかもしれません。  
+  
+## 暗号化の構成  
+ 暗号化の構成によって、アルゴリズムの特定の実装のアルゴリズム名への解決が可能になり、.NET Framework の暗号化クラスの機能を拡張できます。  アルゴリズムの独自のハードウェアまたはソフトウェア実装を追加して、実装を任意のアルゴリズム名にマップすることができます。  構成ファイルでアルゴリズムを指定しない場合は、既定の設定が使用されます。  暗号化の構成の詳細については、「[暗号化クラスの構成](../../../docs/framework/configure-apps/configure-cryptography-classes.md)」を参照してください。  
+  
+## アルゴリズムの選択  
+ データの整合性、データのプライバシー保護、またはキー生成など、さまざまな理由のためにアルゴリズムを選択することができます。  対称アルゴリズムおよびハッシュ アルゴリズムは、整合性の理由 \(変更の防止\) またはプライバシー上の理由 \(表示の防止\) のいずれかのためにデータを保護することを意図しています。  ハッシュ アルゴリズムは、主にデータの整合性用に使用されます。  
+  
+ アプリケーションで推奨されるアルゴリズムの一覧を示します。  
+  
+-   データのプライバシー :  
+  
+    -   <xref:System.Security.Cryptography.Aes>  
+  
+-   データの整合性 :  
+  
+    -   <xref:System.Security.Cryptography.HMACSHA256>  
+  
+    -   <xref:System.Security.Cryptography.HMACSHA512>  
+  
+-   デジタル署名 :  
+  
+    -   <xref:System.Security.Cryptography.ECDsa>  
+  
+    -   <xref:System.Security.Cryptography.RSA>  
+  
+-   キー交換 :  
+  
+    -   <xref:System.Security.Cryptography.ECDiffieHellman>  
+  
+    -   <xref:System.Security.Cryptography.RSA>  
+  
+-   乱数生成 :  
+  
+    -   <xref:System.Security.Cryptography.RNGCryptoServiceProvider>  
+  
+-   パスワードからのキー生成 :  
+  
+    -   <xref:System.Security.Cryptography.Rfc2898DeriveBytes>  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/decrypting-data.md b/docs/standard/security/decrypting-data.md
new file mode 100644
index 00000000000..8bc6674bc65
--- /dev/null
+++ b/docs/standard/security/decrypting-data.md
@@ -0,0 +1,78 @@
+---
+title: "データの復号化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非対称復号化"
+  - "データ [.NET Framework], 復号化"
+  - "復号化"
+  - "対称復号化"
+ms.assetid: 9b266b6c-a9b2-4d20-afd8-b3a0d8fd48a0
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# データの復号化
+復号化は、暗号化の逆の操作です。 秘密キーの暗号化では、データの暗号化に使用されたキーと IV の両方を把握しておく必要があります。 公開キーの暗号化では、公開キー \(データが秘密キーで暗号化された場合\) または秘密キー \(データが公開キーで暗号化された場合\) のいずれかを把握しておく必要があります。  
+  
+## 対称復号化  
+ 対称アルゴリズムで暗号化されたデータの復号化は、対称アルゴリズムでデータを暗号化する際に使用するプロセスと似ています。<xref:System.Security.Cryptography.CryptoStream> クラスは、任意のマネージ ストリーム オブジェクトから読み取られたデータを復号化するために、.NET Framework が提供する対称暗号化クラスと共に使用されます。  
+  
+ 次の例は、<xref:System.Security.Cryptography.RijndaelManaged> クラスのインスタンスを新規作成して、これを <xref:System.Security.Cryptography.CryptoStream> オブジェクトの復号化に使用する方法を示しています。 この例では、まず **RijndaelManaged** クラスのインスタンスを新規作成します。 次に、**CryptoStream** オブジェクトを作成して、`MyStream` というマネージ ストリームの値に初期化します。 次に、**RijndaelManaged** クラスの **CreateDecryptor** メソッドに、暗号化で使用されたキーおよび IV と同じキーと IV が渡されます。これが **CryptoStream** コンストラクターに渡されます。 最後に、ストリームに対する読み取りのアクセスを指定するために、**CryptoStreamMode.Read** 列挙体が **CryptoStream** コンストラクターに渡されます。  
+  
+```vb  
+Dim RMCrypto As New RijndaelManaged() Dim CryptStream As New CryptoStream(MyStream, RMCrypto.CreateDecryptor(RMCrypto.Key, RMCrypto.IV), CryptoStreamMode.Read)  
+  
+```  
+  
+```csharp  
+RijndaelManaged RMCrypto = new RijndaelManaged(); CryptoStream CryptStream = new CryptoStream(MyStream, RMCrypto.CreateDecryptor(Key, IV), CryptoStreamMode.Read);  
+```  
+  
+ 次の例は、ストリームの作成、ストリームの復号化、ストリームからの読み取り、およびストリームを閉じるプロセス全体を示しています。 リッスンしているオブジェクトに接続する際にネットワーク ストリームを初期化する <xref:System.Net.Sockets.TcpListener> オブジェクトが作成されます。 ネットワーク ストリームは、**CryptoStream** クラスと **RijndaelManaged** クラスを使用して復号化されます。 この例は、キーの値と IV の値が正常に転送されたか、以前に一致していたことを前提としています。 これらの値の暗号化および転送に必要なコードは示されていません。  
+  
+```vb  
+Imports System Imports System.Net.Sockets Imports System.Threading Imports System.IO Imports System.Net Imports System.Security.Cryptography Module Module1 Sub Main() 'The key and IV must be the same values that were used 'to encrypt the stream. Dim Key As Byte() = {&H1, &H2, &H3, &H4, &H5, &H6, &H7, &H8, &H9, &H10, &H11, &H12, &H13, &H14, &H15, &H16} Dim IV As Byte() = {&H1, &H2, &H3, &H4, &H5, &H6, &H7, &H8, &H9, &H10, &H11, &H12, &H13, &H14, &H15, &H16} Try 'Initialize a TCPListener on port 11000 'using the current IP address. Dim TCPListen As New TcpListener(IPAddress.Any, 11000) 'Start the listener. TCPListen.Start() 'Check for a connection every five seconds. While Not TCPListen.Pending() Console.WriteLine("Still listening. Will try in 5 seconds.") Thread.Sleep(5000) End While 'Accept the client if one is found. Dim TCP As TcpClient = TCPListen.AcceptTcpClient() 'Create a network stream from the connection. Dim NetStream As NetworkStream = TCP.GetStream() 'Create a new instance of the RijndaelManaged class 'and decrypt the stream. Dim RMCrypto As New RijndaelManaged() 'Create an instance of the CryptoStream class, pass it the NetworkStream, and decrypt 'it with the Rijndael class using the key and IV. Dim CryptStream As New CryptoStream(NetStream, RMCrypto.CreateDecryptor(Key, IV), CryptoStreamMode.Read) 'Read the stream. Dim SReader As New StreamReader(CryptStream) 'Display the message. Console.WriteLine("The decrypted original message: {0}", SReader.ReadToEnd()) 'Close the streams. SReader.Close() NetStream.Close() TCP.Close() 'Catch any exceptions. Catch Console.WriteLine("The Listener Failed.") End Try End Sub End Module  
+  
+```  
+  
+```csharp  
+using System; using System.Net.Sockets; using System.Threading; using System.IO; using System.Net; using System.Security.Cryptography; class Class1 { static void Main(string[] args) { //The key and IV must be the same values that were used //to encrypt the stream. byte[] Key = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16}; byte[] IV = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16}; try { //Initialize a TCPListener on port 11000 //using the current IP address. TcpListener TCPListen = new TcpListener(IPAdress.Any, 11000); //Start the listener. TCPListen.Start(); //Check for a connection every five seconds. while(!TCPListen.Pending()) { Console.WriteLine("Still listening. Will try in 5 seconds."); Thread.Sleep(5000); } //Accept the client if one is found. TcpClient TCP = TCPListen.AcceptTcpClient(); //Create a network stream from the connection. NetworkStream NetStream = TCP.GetStream(); //Create a new instance of the RijndaelManaged class // and decrypt the stream. RijndaelManaged RMCrypto = new RijndaelManaged(); //Create a CryptoStream, pass it the NetworkStream, and decrypt //it with the Rijndael class using the key and IV. CryptoStream CryptStream = new CryptoStream(NetStream, RMCrypto.CreateDecryptor(Key, IV), CryptoStreamMode.Read); //Read the stream. StreamReader SReader = new StreamReader(CryptStream); //Display the message. Console.WriteLine("The decrypted original message: {0}", SReader.ReadToEnd()); //Close the streams. SReader.Close(); NetStream.Close(); TCP.Close(); } //Catch any exceptions. catch { Console.WriteLine("The Listener Failed."); } } }  
+```  
+  
+ 前のサンプルを機能させるには、リスナーに対して暗号化された接続を行う必要があります。 接続では、リスナーで使用するキー、IV、およびアルゴリズムと同じものを使用する必要があります。 このような接続が行われた場合、メッセージが復号化され、コンソールに表示されます。  
+  
+## 非対称復号化  
+ 通常は、パーティ \(パーティ A\) は、公開キーと秘密キーの両方を生成し、メモリ内、または暗号化キー コンテナーのいずれかに格納します。  パーティ A は公開キーを別のパーティ \(パーティ B\) に送信します。  パーティ B は、公開キーを使用して、データを暗号化してからパーティ A にデータを返信します。パーティ A は、データを受信すると、対応する秘密キーを使用して暗号化を解除します。  復号化は、パーティ B がデータの暗号化に使用した公開キーに対応する秘密キーをパーティ A が使用する場合にのみ成功します。  
+  
+ セキュリティで保護された暗号化キー コンテナーに非対称キーを格納する方法と、その後非対称キーを取得する方法については、「[方法 : キー コンテナーに非対称キーを格納する](../../../docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md)」を参照してください。  
+  
+ 次の例は、対称キーと IV を表す 2 つのバイト配列の復号化を示しています。  第三者に簡単に送信できる形式で <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトから非対称の公開キーを抽出する方法については、「[データの暗号化](../../../docs/standard/security/encrypting-data.md)」を参照してください。  
+  
+```vb  
+'Create a new instance of the RSACryptoServiceProvider class. Dim RSA As New RSACryptoServiceProvider() ' Export the public key information and send it to a third party. ' Wait for the third party to encrypt some data and send it back. 'Decrypt the symmetric key and IV. SymmetricKey = RSA.Decrypt(EncryptedSymmetricKey, False) SymmetricIV = RSA.Decrypt(EncryptedSymmetricIV, False)  
+  
+```  
+  
+```csharp  
+//Create a new instance of the RSACryptoServiceProvider class. RSACryptoServiceProvider RSA = new RSACryptoServiceProvider(); // Export the public key information and send it to a third party. // Wait for the third party to encrypt some data and send it back. //Decrypt the symmetric key and IV. SymmetricKey = RSA.Decrypt( EncryptedSymmetricKey, false); SymmetricIV = RSA.Decrypt( EncryptedSymmetricIV , false);  
+```  
+  
+## 参照  
+ [暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)   
+ [データの暗号化](../../../docs/standard/security/encrypting-data.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/encrypting-data.md b/docs/standard/security/encrypting-data.md
new file mode 100644
index 00000000000..7c1d73fa36d
--- /dev/null
+++ b/docs/standard/security/encrypting-data.md
@@ -0,0 +1,91 @@
+---
+title: "データの暗号化 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非対称暗号化"
+  - "暗号化 [.NET Framework], 非対称"
+  - "暗号化 [.NET Framework], 共通"
+  - "対称暗号化"
+ms.assetid: 7ecce51f-db5f-4bd4-9321-cceb6fcb2a77
+caps.latest.revision: 16
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# データの暗号化
+対称暗号化と非対称暗号化は、異なるプロセスを使用して実行されます。 対称暗号化は、ストリーム上で実行されるため、大量のデータの暗号化に役立ちます。 非対称暗号化は、少ないバイト数で実行されるため、少量のデータにのみ役立ちます。  
+  
+## 対称暗号化  
+ マネージ対称暗号化クラスは、ストリームに読み取られるデータを暗号化する <xref:System.Security.Cryptography.CryptoStream> という特別なストリーム クラスと共に使用されます。**CryptoStream** クラスは、マネージ ストリーム クラスを使用して初期化されます。クラスは、\(暗号化アルゴリズムを実装するクラスから作成された\) <xref:System.Security.Cryptography.ICryptoTransform> インターフェイス、および **CryptoStream** に対して許可されたアクセスの種類について記述した <xref:System.Security.Cryptography.CryptoStreamMode> 列挙体を実装します。**CryptoStream** クラスは、<xref:System.IO.Stream> クラスから派生する任意のクラス \(<xref:System.IO.FileStream>、<xref:System.IO.MemoryStream>、<xref:System.Net.Sockets.NetworkStream> など\) を使用して初期化できます。  これらのクラスを使用すると、さまざまなストリーム オブジェクトの対称暗号化を実行できます。  
+  
+ 次の例は、Rijndael 暗号化アルゴリズムを実装する <xref:System.Security.Cryptography.RijndaelManaged> クラスの新しいインスタンスを作成し、これを使用して **CryptoStream** クラスで暗号化を実行する方法を示しています。 この例では、**CryptoStream**  は `MyStream` と呼ばれるストリーム オブジェクトで初期化されています。これは任意の種類のマネージ ストリームにすることができます。**RijndaelManaged** クラスの **CreateEncryptor** メソッドには、暗号化で使用されるキーと IV が渡されます。 この場合、`RMCrypto` から生成された既定のキーと IV が使用されます。 最後に、ストリームへの書き込みのアクセスを指定する **CryptoStreamMode.Write** が渡されます。  
+  
+```vb  
+Dim RMCrypto As New RijndaelManaged() Dim CryptStream As New CryptoStream(MyStream, RMCrypto.CreateEncryptor(RMCrypto.Key, RMCrypto.IV), CryptoStreamMode.Write)  
+  
+```  
+  
+```csharp  
+RijndaelManaged RMCrypto = new RijndaelManaged(); CryptoStream CryptStream = new CryptoStream(MyStream, RMCrypto.CreateEncryptor(), CryptoStreamMode.Write);  
+```  
+  
+ このコードの実行後に **CryptoStream** オブジェクトに書き込まれたデータはすべて、Rijndael アルゴリズムを使用して暗号化されます。  
+  
+ 次の例は、ストリームの作成、ストリームの暗号化、ストリームへの書き込み、およびストリームを閉じるプロセス全体を示しています。 この例では、**CryptoStream** クラスと **RijndaelManaged** クラスを使用して暗号化されたネットワーク ストリームを作成します。<xref:System.IO.StreamWriter> クラスを使用して、暗号化されたストリームにメッセージが書き込まれます。  
+  
+> [!NOTE]
+>  また、この例を使用してファイルに書き込むこともできます。 それを行うには、<xref:System.Net.Sockets.TcpClient> の参照を削除し、<xref:System.Net.Sockets.NetworkStream> を <xref:System.IO.FileStream> に置き換えます。  
+  
+```vb  
+Imports System Imports System.IO Imports System.Security.Cryptography Imports System.Net.Sockets Module Module1 Sub Main() Try 'Create a TCP connection to a listening TCP process. 'Use "localhost" to specify the current computer or 'replace "localhost" with the IP address of the 'listening process. Dim TCP As New TcpClient("localhost", 11000) 'Create a network stream from the TCP connection. Dim NetStream As NetworkStream = TCP.GetStream() 'Create a new instance of the RijndaelManaged class 'and encrypt the stream. Dim RMCrypto As New RijndaelManaged() Dim Key As Byte() = {&H1, &H2, &H3, &H4, &H5, &H6, &H7, &H8, &H9, &H10, &H11, &H12, &H13, &H14, &H15, &H16} Dim IV As Byte() = {&H1, &H2, &H3, &H4, &H5, &H6, &H7, &H8, &H9, &H10, &H11, &H12, &H13, &H14, &H15, &H16} 'Create a CryptoStream, pass it the NetworkStream, and encrypt 'it with the Rijndael class. Dim CryptStream As New CryptoStream(NetStream, RMCrypto.CreateEncryptor(Key, IV), CryptoStreamMode.Write) 'Create a StreamWriter for easy writing to the 'network stream. Dim SWriter As New StreamWriter(CryptStream) 'Write to the stream. SWriter.WriteLine("Hello World!") 'Inform the user that the message was written 'to the stream. Console.WriteLine("The message was sent.") 'Close all the connections. SWriter.Close() CryptStream.Close() NetStream.Close() TCP.Close() Catch 'Inform the user that an exception was raised. Console.WriteLine("The connection failed.") End Try End Sub End Module  
+  
+```  
+  
+```csharp  
+using System; using System.IO; using System.Security.Cryptography; using System.Net.Sockets; public class main { public static void Main(string[] args) { try { //Create a TCP connection to a listening TCP process. //Use "localhost" to specify the current computer or //replace "localhost" with the IP address of the //listening process. TcpClient TCP = new TcpClient("localhost",11000); //Create a network stream from the TCP connection. NetworkStream NetStream = TCP.GetStream(); //Create a new instance of the RijndaelManaged class // and encrypt the stream. RijndaelManaged RMCrypto = new RijndaelManaged(); byte[] Key = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16}; byte[] IV = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16}; //Create a CryptoStream, pass it the NetworkStream, and encrypt //it with the Rijndael class. CryptoStream CryptStream = new CryptoStream(NetStream, RMCrypto.CreateEncryptor(Key, IV), CryptoStreamMode.Write); //Create a StreamWriter for easy writing to the //network stream. StreamWriter SWriter = new StreamWriter(CryptStream); //Write to the stream. SWriter.WriteLine("Hello World!"); //Inform the user that the message was written //to the stream. Console.WriteLine("The message was sent."); //Close all the connections. SWriter.Close(); CryptStream.Close(); NetStream.Close(); TCP.Close(); } catch { //Inform the user that an exception was raised. Console.WriteLine("The connection failed."); } } }  
+```  
+  
+ 前の例を正しく実行するためには、<xref:System.Net.Sockets.TcpClient> クラスで指定された IP アドレスとポート番号をリッスンしているプロセスが存在する必要があります。 リッスンしているプロセスが存在する場合は、コードがリッスンしているプロセスに接続して、Rijndael の対称アルゴリズムを使用してストリームを暗号化し、"Hello World\!" を ストリームに書き込みます。 コードが正常に実行された場合、コンソールに次のテキストが表示されます。  
+  
+```  
+The message was sent.  
+```  
+  
+ ただし、リッスンしているプロセスが見つからないか、例外が発生した場合、コードによってコンソールに次のテキストが表示されます。  
+  
+```  
+The connection failed.  
+```  
+  
+## 非対称暗号化  
+ 非対称アルゴリズムは、通常は対称キーと IV の暗号化など、少量のデータの暗号化に使用されます。 通常、非対称暗号化を行う個人や組織は、別のパーティによって生成された公開キーを使用します。<xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスは、この目的のために、.NET Framework によって提供されます。  
+  
+ 次の例では、公開キーの情報を使用して対称キーと IV を暗号化します。 サード パーティの公開キーを表す 2 つのバイト配列が初期化されます。<xref:System.Security.Cryptography.RSAParameters> オブジェクトがこれらの値に初期化されます。 次に、**RSAParameters** オブジェクトが \(このオブジェクトが表す公開キーと共に\) <xref:System.Security.Cryptography.RSACryptoServiceProvider.ImportParameters%2A?displayProperty=fullName> メソッドを使用して **RSACryptoServiceProvider** にインポートされます。 最後に、<xref:System.Security.Cryptography.RijndaelManaged> クラスが作成した秘密キーと IV が暗号化されます。 この例では、システムに 128 ビット暗号化がインストールされている必要があります。  
+  
+```vb  
+Imports System Imports System.Security.Cryptography Module Module1 Sub Main() 'Initialize the byte arrays to the public key information. Dim PublicKey As Byte() =  {214, 46, 220, 83, 160, 73, 40, 39, 201, 155, 19,202, 3, 11, 191, 178, 56, 74, 90, 36, 248, 103, 18, 144, 170, 163, 145, 87, 54, 61, 34, 220, 222, 207, 137, 149, 173, 14, 92, 120, 206, 222, 158, 28, 40, 24, 30, 16, 175, 108, 128, 35, 230, 118, 40, 121, 113, 125, 216, 130, 11, 24, 90, 48, 194, 240, 105, 44, 76, 34, 57, 249, 228, 125, 80, 38, 9, 136, 29, 117, 207, 139, 168, 181, 85, 137, 126, 10, 126, 242, 120, 247, 121, 8, 100, 12, 201, 171, 38, 226, 193, 180, 190, 117, 177, 87, 143, 242, 213, 11, 44, 180, 113, 93, 106, 99, 179, 68, 175, 211, 164, 116, 64, 148, 226, 254, 172, 147} Dim Exponent As Byte() = {1, 0, 1} 'Create values to store encrypted symmetric keys. Dim EncryptedSymmetricKey() As Byte Dim EncryptedSymmetricIV() As Byte 'Create a new instance of the RSACryptoServiceProvider class. Dim RSA As New RSACryptoServiceProvider() 'Create a new instance of the RSAParameters structure. Dim RSAKeyInfo As New RSAParameters() 'Set RSAKeyInfo to the public key values. RSAKeyInfo.Modulus = PublicKey RSAKeyInfo.Exponent = Exponent 'Import key parameters into RSA. RSA.ImportParameters(RSAKeyInfo) 'Create a new instance of the RijndaelManaged class. Dim RM As New RijndaelManaged() 'Encrypt the symmetric key and IV. EncryptedSymmetricKey = RSA.Encrypt(RM.Key, False) EncryptedSymmetricIV = RSA.Encrypt(RM.IV, False) End Sub End Module  
+  
+```  
+  
+```csharp  
+using System; using System.Security.Cryptography; class Class1 { static void Main() { //Initialize the byte arrays to the public key information. byte[] PublicKey = {214,46,220,83,160,73,40,39,201,155,19,202,3,11,191,178,56, 74,90,36,248,103,18,144,170,163,145,87,54,61,34,220,222, 207,137,149,173,14,92,120,206,222,158,28,40,24,30,16,175, 108,128,35,230,118,40,121,113,125,216,130,11,24,90,48,194, 240,105,44,76,34,57,249,228,125,80,38,9,136,29,117,207,139, 168,181,85,137,126,10,126,242,120,247,121,8,100,12,201,171, 38,226,193,180,190,117,177,87,143,242,213,11,44,180,113,93, 106,99,179,68,175,211,164,116,64,148,226,254,172,147}; byte[] Exponent = {1,0,1}; //Create values to store encrypted symmetric keys. byte[] EncryptedSymmetricKey; byte[] EncryptedSymmetricIV; //Create a new instance of the RSACryptoServiceProvider class. RSACryptoServiceProvider RSA = new RSACryptoServiceProvider(); //Create a new instance of the RSAParameters structure. RSAParameters RSAKeyInfo = new RSAParameters(); //Set RSAKeyInfo to the public key values. RSAKeyInfo.Modulus = PublicKey; RSAKeyInfo.Exponent = Exponent; //Import key parameters into RSA. RSA.ImportParameters(RSAKeyInfo); //Create a new instance of the RijndaelManaged class. RijndaelManaged RM = new RijndaelManaged(); //Encrypt the symmetric key and IV. EncryptedSymmetricKey = RSA.Encrypt(RM.Key, false); EncryptedSymmetricIV = RSA.Encrypt(RM.IV, false); } }  
+```  
+  
+## 参照  
+ [暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)   
+ [データの復号化](../../../docs/standard/security/decrypting-data.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/ensuring-data-integrity-with-hash-codes.md b/docs/standard/security/ensuring-data-integrity-with-hash-codes.md
new file mode 100644
index 00000000000..4c46121cc85
--- /dev/null
+++ b/docs/standard/security/ensuring-data-integrity-with-hash-codes.md
@@ -0,0 +1,68 @@
+---
+title: "ハッシュ コードによるデータの整合性の保証 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "確認 (ハッシュ コードを)"
+  - "暗号化 [.NET Framework], ハッシュ"
+  - "データの整合性"
+  - "暗号化 [.NET Framework], ハッシュ"
+  - "生成 (ハッシュを)"
+  - "ハッシュ"
+  - "検査 (ハッシュ コードを)"
+ms.assetid: 33660f33-b70f-4dca-8c87-ab35cfc2961a
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# ハッシュ コードによるデータの整合性の保証
+ハッシュ値は、データを一意に識別する固定長の数値です。  ハッシュ値は、大量のデータを非常に小さな数値として表現するため、デジタル署名と一緒に使用されます。  大きな値で署名するよりも、ハッシュ値を使用すれば効率的に署名できます。  ハッシュ値は、安全でないチャネルを介して送信されたデータの整合性を検証するためにも役立ちます。  受信したデータのハッシュ値を送信したデータのハッシュ値と比較すると、データが変更されたかどうかを判断できます。  
+  
+ このトピックでは、<xref:System.Security.Cryptography?displayProperty=fullName> 名前空間のクラスを使用してハッシュ コードの生成と検証を実行する方法について説明します。  
+  
+## ハッシュの生成  
+ マネージ ハッシュ クラスでは、バイト配列またはマネージ ストリーム オブジェクトのいずれかをハッシュできます。  SHA1 ハッシュ アルゴリズムを使用して文字列のハッシュ値を作成する例を次に示します。  この例では、<xref:System.Text.UnicodeEncoding> クラスを使用して文字列をバイト配列に変換し、<xref:System.Security.Cryptography.SHA1Managed> クラスを使用してバイト配列をハッシュします。  ハッシュ値はコンソールに表示されます。  
+  
+ [!code-csharp[GeneratingAHash#1](../../../samples/snippets/csharp/VS_Snippets_CLR/generatingahash/cs/program.cs#1)]
+ [!code-vb[GeneratingAHash#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/generatingahash/vb/program.vb#1)]  
+  
+ 上記のコードは、次の文字列をコンソールに表示します。  
+  
+ `59 4 248 102 77 97 142 201 210 12 224 93 25 41 100 197 213 134 130 135`  
+  
+## ハッシュの検証  
+ データをハッシュ値と比較すると、整合性を判断できます。  通常、データは特定のタイミングでハッシュされ、ハッシュ値はなんらかの方法で保護されます。  後でデータをもう一度ハッシュし、保護されている値と比較できます。  ハッシュ値が一致する場合、データは変更されていません。  値が一致しない場合は、データが破損しています。  このシステムを機能させるには、保護されたハッシュを暗号化するか、信頼されていないあらゆる対象に対して内密を保つ必要があります。  
+  
+ 文字列の前のハッシュ値を新しいハッシュ値と比較する例を次に示します。  この例では、ループ処理でハッシュ値の各バイトをすべて比較します。  
+  
+ [!code-csharp[VerifyingAHash#1](../../../samples/snippets/csharp/VS_Snippets_CLR/verifyingahash/cs/program.cs#1)]
+ [!code-vb[VerifyingAHash#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/verifyingahash/vb/program.vb#1)]  
+  
+ 2 つのハッシュ値が一致する場合は、上記のコードによってコンソールに次のように表示されます。  
+  
+```  
+The hash codes match.  
+```  
+  
+ 一致しない場合は、次のように表示されます。  
+  
+```  
+The hash codes do not match.  
+```  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/generating-keys-for-encryption-and-decryption.md b/docs/standard/security/generating-keys-for-encryption-and-decryption.md
new file mode 100644
index 00000000000..0b1f374624e
--- /dev/null
+++ b/docs/standard/security/generating-keys-for-encryption-and-decryption.md
@@ -0,0 +1,94 @@
+---
+title: "暗号化と復号化のためのキーの生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非対称キー [.NET Framework]"
+  - "暗号化 [.NET Framework], キー"
+  - "暗号化 [.NET Framework], キー"
+  - "キー, 非対称"
+  - "キー, 暗号化と復号化"
+  - "キー, 共通"
+  - "共通キー"
+ms.assetid: c197dfc9-a453-4226-898d-37a16638056e
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 暗号化と復号化のためのキーの生成
+キーの作成と管理は、暗号プロセスの重要な部分です。 対称アルゴリズムでは、キーと初期化ベクター \(IV\) を作成する必要があります。 キーは、データの暗号化解除を許可しないユーザーに対しては秘密にする必要があります。 IV は秘密にする必要はありませんが、セッションごとに変更する必要があります。 非対称アルゴリズムでは、公開キーと秘密キーを作成する必要があります。 公開キーはだれに公開してもかまいせんが、秘密キーを知らせる相手は、公開キーで暗号化されたデータを復号化する人だけにします。 このセクションでは、対称アルゴリズムと非対称アルゴリズムの両方について、キーを作成して管理する方法を説明します。  
+  
+## 共通キー  
+ .NET Framework に用意されている対称暗号化クラスでは、データを暗号化および復号化するために、キーと新しい初期化ベクター \(IV\) が必要になります。 いずれかのマネージ対称暗号化クラスの新しいインスタンスを作成するとき、既定のコンストラクターを使用すると、常に新しいキーと IV が自動的に作成されます。 自分のデータを復号化できるようにする相手は、自分と同じキーおよび IV を所有し、同じアルゴリズムを使用する必要があります。 一般に、キーと IV はセッションごとに新しく作成する必要があり、キーも IV も格納して後のセッションで使用することは望ましくありません。  
+  
+ 通常、共通キーと IV を離れた場所にいる人へ送信するためには、非対称暗号化方式を使用して共通キーを暗号化します。 これらの値を暗号化せずに安全でないネットワーク経由で送信することは、値を傍受した人ならだれでもデータを暗号化解除できるようになるため危険です。 暗号化を使用したデータ交換の詳細については、「[暗号スキームの作成](../../../docs/standard/security/creating-a-cryptographic-scheme.md)」を参照してください。  
+  
+ TripleDES アルゴリズムを実装する <xref:System.Security.Cryptography.TripleDESCryptoServiceProvider> クラスの新しいインスタンスの作成方法を次の例に示します。  
+  
+```vb  
+Dim TDES As TripleDESCryptoServiceProvider = new TripleDESCryptoServiceProvider()  
+  
+```  
+  
+```csharp  
+TripleDESCryptoServiceProvider TDES = new TripleDESCryptoServiceProvider();  
+```  
+  
+ 上記のコードを実行すると新しいキーと IV が生成され、それぞれ **Key** プロパティと **IV** プロパティに設定されます。  
+  
+ 複数のキーを生成する必要が生じることもあります。 このような状況では、対称アルゴリズムを実装するクラスの新しいインスタンスを作成し、次に **GenerateKey** および **GenerateIV** メソッドを呼び出すことによって新しいキーと IV を作成します。 非対称暗号化クラスの新しいインスタンスの作成後に新しいキーと IV を作成する方法を次のコード例に示します。  
+  
+```vb  
+Dim TDES As TripleDESCryptoServiceProvider = new TripleDESCryptoServiceProvider() TDES.GenerateIV() TDES.GenerateKey()  
+  
+```  
+  
+```csharp  
+TripleDESCryptoServiceProvider TDES = new TripleDESCryptoServiceProvider(); TDES.GenerateIV(); TDES.GenerateKey();  
+```  
+  
+ 上記のコードを実行すると、**TripleDESCryptoServiceProvider** の新しいインスタンスの作成時にキーと IV が生成されます。**GenerateKey** メソッドと **GenerateIV** メソッドを呼び出すと、別のキーと IV が作成されます。  
+  
+## 非対称キー  
+ .NET Framework には、非対称暗号化方式のための <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスと <xref:System.Security.Cryptography.DSACryptoServiceProvider> クラスが用意されています。 これらのクラスの既定のコンストラクターを使用して新しいインスタンスを作成すると、公開キーと秘密キーのペアが作成されます。 非対称キーは、複数のセッションで使用できるように格納したり、1 つのセッション専用として生成したりできます。 公開キーは一般に公開できますが、秘密キーは厳密に保護する必要があります。  
+  
+ 非対称アルゴリズム クラスの新しいインスタンスを作成すると、公開キーと秘密キーのペアが常に生成されます。 クラスの新しいインスタンスを作成したら、次の 2 つの方法のどちらかを使ってキー情報を取得できます。  
+  
+-   <xref:System.Security.Cryptography.RSA.ToXmlString%2A> メソッド。キー情報の XML 表現を返します。  
+  
+-   <xref:System.Security.Cryptography.RSACryptoServiceProvider.ExportParameters%2A> メソッド。キー情報を保持する <xref:System.Security.Cryptography.RSAParameters> 構造体を返します。  
+  
+ どちらのメソッドにも、公開キー情報だけを返すのか、または公開キー情報と秘密キー情報の両方を返すのかを示すブール値を渡すことができます。<xref:System.Security.Cryptography.RSACryptoServiceProvider.ImportParameters%2A> メソッドを使用すると、**RSACryptoServiceProvider** クラスを初期化して **RSAParameters** 構造体の値を設定できます。  
+  
+ 非対称秘密キーは、ローカル コンピューターにそのまま平文として保存しないでください。 秘密キーを格納する必要がある場合は、キー コンテナーを使用することをお勧めします。 秘密キーをキー コンテナーに格納する方法の詳細については、「[方法 : キー コンテナーに非対称キーを格納する](../../../docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md)」を参照してください。  
+  
+ 次のコード例では、**RSACryptoServiceProvider** クラスの新しいインスタンスを作成し、公開キーと秘密キーのペアを作成して、公開キー情報を **RSAParameters** 構造体に保存します。  
+  
+```vb  
+'Generate a public/private key pair. Dim RSA as RSACryptoServiceProvider = new RSACryptoServiceProvider() 'Save the public key information to an RSAParameters structure. Dim RSAKeyInfo As RSAParameters = RSA.ExportParameters(false)  
+  
+```  
+  
+```csharp  
+//Generate a public/private key pair. RSACryptoServiceProvider RSA = new RSACryptoServiceProvider(); //Save the public key information to an RSAParameters structure. RSAParameters RSAKeyInfo = RSA.ExportParameters(false);  
+```  
+  
+## 参照  
+ [データの暗号化](../../../docs/standard/security/encrypting-data.md)   
+ [データの復号化](../../../docs/standard/security/decrypting-data.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)   
+ [方法 : キー コンテナーに非対称キーを格納する](../../../docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-access-hardware-encryption-devices.md b/docs/standard/security/how-to-access-hardware-encryption-devices.md
new file mode 100644
index 00000000000..1aa64e696c0
--- /dev/null
+++ b/docs/standard/security/how-to-access-hardware-encryption-devices.md
@@ -0,0 +1,66 @@
+---
+title: "方法 : ハードウェア暗号化デバイスにアクセスする | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化"
+  - "CspParameters"
+  - "暗号化"
+  - "ハードウェアの暗号化"
+  - "キー カード"
+ms.assetid: b0e734df-6eb4-4b16-b48c-6f0fe82d5f17
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# 方法 : ハードウェア暗号化デバイスにアクセスする
+ハードウェア暗号化デバイスにアクセスするには、<xref:System.Security.Cryptography.CspParameters> クラスを使用します。  たとえば、このクラスを使用すると、アプリケーションをスマート カード、ハードウェアの乱数ジェネレーター、または特定の暗号化アルゴリズムのハードウェア実装と統合することができます。  
+  
+ <xref:System.Security.Cryptography.CspParameters> クラスは、正しくインストールされたハードウェア暗号化デバイスにアクセスする暗号化サービス プロバイダー \(CSP\) を作成します。  レジストリ エディター \(Regedit.exe\)  を使用してレジストリ キー \(HKEY\_LOCAL\_MACHINE\\Software\\Microsoft\\Cryptography\\Defaults\\Provider\) を調べることで、CSP を使用できるかどうかを確認できます。  
+  
+### キー カードを使用してデータに署名するには  
+  
+1.  整数のプロバイダー型とプロバイダーの名前をコンストラクターに渡す、<xref:System.Security.Cryptography.CspParameters> クラスのインスタンスを新規作成します。  
+  
+2.  新規作成された <xref:System.Security.Cryptography.CspParameters> オブジェクトの <xref:System.Security.Cryptography.CspParameters.Flags%2A> プロパティに適切なフラグを渡します。  たとえば、<xref:System.Security.Cryptography.CspProviderFlags> フラグを渡します。  
+  
+3.  <xref:System.Security.Cryptography.CspParameters> オブジェクトをコンストラクターに渡す、<xref:System.Security.Cryptography.AsymmetricAlgorithm> クラス \(<xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスなど\) のインスタンスを新規作成します。  
+  
+4.  `Sign` メソッドのいずれかを使用してデータに署名し、`Verify` メソッドのいずれかを使用してデータを確認します。  
+  
+### ハードウェアの乱数ジェネレーターを使用して乱数を生成するには  
+  
+1.  整数のプロバイダー型とプロバイダーの名前をコンストラクターに渡す、<xref:System.Security.Cryptography.CspParameters> クラスのインスタンスを新規作成します。  
+  
+2.  <xref:System.Security.Cryptography.CspParameters> オブジェクトをコンストラクターに渡す、<xref:System.Security.Cryptography.RNGCryptoServiceProvider> のインスタンスを新規作成します。  
+  
+3.  <xref:System.Security.Cryptography.RNGCryptoServiceProvider.GetBytes%2A> メソッドまたは <xref:System.Security.Cryptography.RNGCryptoServiceProvider.GetNonZeroBytes%2A> メソッドを使用してランダムな値を作成します。  
+  
+## 使用例  
+ 次のコード例は、スマート カードを使用してデータに署名する方法を示しています。  このコード例は、スマート カードを公開する <xref:System.Security.Cryptography.CspParameters> オブジェクトを作成してから、CSP を使用して <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトを初期化します。  コード例では、続いて幾らかのデータの署名と確認を行います。  
+  
+ [!code-cpp[Cryptography.SmartCardCSP#1](../../../samples/snippets/cpp/VS_Snippets_CLR/Cryptography.SmartCardCSP/CPP/Cryptography.SmartCardCSP.cpp#1)]
+ [!code-csharp[Cryptography.SmartCardCSP#1](../../../samples/snippets/csharp/VS_Snippets_CLR/Cryptography.SmartCardCSP/CS/example.cs#1)]
+ [!code-vb[Cryptography.SmartCardCSP#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/Cryptography.SmartCardCSP/VB/example.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   <xref:System> 名前空間と <xref:System.Security.Cryptography> 名前空間を含めます。  
+  
+-   スマート カード リーダーとドライバーをコンピューターにインストールしておく必要があります。  
+  
+-   カード リーダー固有の情報を使用して、<xref:System.Security.Cryptography.CspParameters> オブジェクトを初期化する必要があります。  詳細については、カード リーダーのドキュメントを参照してください。
\ No newline at end of file
diff --git a/docs/standard/security/how-to-create-a-windowsprincipal-object.md b/docs/standard/security/how-to-create-a-windowsprincipal-object.md
new file mode 100644
index 00000000000..276ee83ffc8
--- /dev/null
+++ b/docs/standard/security/how-to-create-a-windowsprincipal-object.md
@@ -0,0 +1,87 @@
+---
+title: "方法 : WindowsPrincipal プロジェクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プリンシパル オブジェクト, 作成"
+  - "セキュリティ [.NET Framework], 作成 (WindowsPrincipal オブジェクトを)"
+  - "セキュリティ [.NET Framework], プリンシパル"
+  - "WindowsPrincipal オブジェクト, 作成"
+ms.assetid: 56eb10ca-e61d-4ed2-af7a-555fc4c25a25
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : WindowsPrincipal プロジェクトを作成する
+コードが役割ベースの検証を繰り返し実行する必要があるか、1 回だけ実行する必要があるかによって、<xref:System.Security.Principal.WindowsPrincipal> オブジェクトを作成する方法は 2 つあります。  
+  
+ コードが役割ベースの検証を繰り返し実行する必要がある場合、次の最初の手順のほうが、生成されるオーバーヘッドが少なくなります。  コードが役割ベースの検証を 1 回だけ実行する必要がある場合、次の 2 番目の手順を使用して <xref:System.Security.Principal.WindowsPrincipal> オブジェクトを作成できます。  
+  
+### 繰り返し検証で WindowsPrincipal オブジェクトを作成するには  
+  
+1.  静的な <xref:System.AppDomain.CurrentDomain%2A?displayProperty=fullName> プロパティによって返される <xref:System.AppDomain> オブジェクトの <xref:System.AppDomain.SetPrincipalPolicy%2A> メソッドを呼び出し、新しいポリシーの内容を示す <xref:System.Security.Principal.PrincipalPolicy> 列挙値があるメソッドに渡します。  サポートされる値は <xref:System.Security.Principal.PrincipalPolicy>、<xref:System.Security.Principal.PrincipalPolicy>、および <xref:System.Security.Principal.PrincipalPolicy> です。  次のコードは、このメソッドの呼び出しを示しています。  
+  
+    ```csharp  
+    AppDomain.CurrentDomain.SetPrincipalPolicy(  
+        PrincipalPolicy.WindowsPrincipal);  
+    ```  
+  
+    ```vb  
+    AppDomain.CurrentDomain.SetPrincipalPolicy( _  
+        PrincipalPolicy.WindowsPrincipal)  
+    ```  
+  
+2.  ポリシーの設定により、静的な <xref:System.Threading.Thread.CurrentPrincipal%2A?displayProperty=fullName> プロパティを使用して、現在の Windows ユーザーをカプセル化するプリンシパルを取得します。  プロパティの戻り値の型は <xref:System.Security.Principal.IPrincipal> であるため、結果を <xref:System.Security.Principal.WindowsPrincipal> 型にキャストする必要があります。  次のコードは、新しい <xref:System.Security.Principal.WindowsPrincipal> オブジェクトを、現在のスレッドに関連付けられたプリンシパルの値に初期化します。  
+  
+    ```csharp  
+    WindowsPrincipal MyPrincipal =   
+        (WindowsPrincipal) Thread.CurrentPrincipal;  
+    ```  
+  
+    ```vb  
+    Dim MyPrincipal As WindowsPrincipal = _  
+        CType(Thread.CurrentPrincipal, WindowsPrincipal)   
+    ```  
+  
+3.  プリンシパル オブジェクトが作成されると、いくつかのメソッドのいずれかを使用して検証できます。  
+  
+### 1 回の検証用に WindowsPrincipal オブジェクトを作成するには  
+  
+1.  静的な <xref:System.Security.Principal.WindowsIdentity.GetCurrent%2A?displayProperty=fullName> メソッドを呼び出して新しい <xref:System.Security.Principal.WindowsIdentity> オブジェクトを初期化します。このメソッドは、現在の Windows アカウントに対してクエリを実行し、そのアカウントに関する情報を新規作成された ID オブジェクトに配置します。  次のコードは、<xref:System.Security.Principal.WindowsIdentity> オブジェクトを新規作成し、これを現在の認証済みユーザーに初期化します。  
+  
+    ```csharp  
+    WindowsIdentity MyIdentity = WindowsIdentity.GetCurrent();  
+    ```  
+  
+    ```vb  
+    Dim MyIdentity As WindowsIdentity = WindowsIdentity.GetCurrent()  
+    ```  
+  
+2.  <xref:System.Security.Principal.WindowsPrincipal> オブジェクトを新規作成し、これに前の手順で作成された <xref:System.Security.Principal.WindowsIdentity> オブジェクトの値を渡します。  
+  
+    ```csharp  
+    WindowsPrincipal MyPrincipal = new WindowsPrincipal(MyIdentity);  
+    ```  
+  
+    ```vb  
+    Dim MyPrincipal As New WindowsPrincipal(MyIdentity)  
+    ```  
+  
+3.  プリンシパル オブジェクトが作成されると、いくつかのメソッドのいずれかを使用して検証できます。  
+  
+## 参照  
+ [プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-create-genericprincipal-and-genericidentity-objects.md b/docs/standard/security/how-to-create-genericprincipal-and-genericidentity-objects.md
new file mode 100644
index 00000000000..7f377da7b7f
--- /dev/null
+++ b/docs/standard/security/how-to-create-genericprincipal-and-genericidentity-objects.md
@@ -0,0 +1,154 @@
+---
+title: "方法 : GenericPrincipal オブジェクトと GenericIdentity オブジェクトを作成する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "作成 (GenericIdentity オブジェクトを)"
+  - "作成 (GenericPrincipal オブジェクトを)"
+  - "GenericIdentity オブジェクト"
+  - "GenericPrincipal オブジェクト"
+ms.assetid: 465694cf-258b-4747-9dae-35b01a5bcdbb
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : GenericPrincipal オブジェクトと GenericIdentity オブジェクトを作成する
+<xref:System.Security.Principal.GenericIdentity> クラスを <xref:System.Security.Principal.GenericPrincipal> クラスと組み合わせて使用することによって、Windows NT ドメインや Windows 2000 ドメインから独立して存在する承認スキームを作成できます。  
+  
+### GenericPrincipal オブジェクトを作成するには  
+  
+1.  ID クラスの新しいインスタンスを作成し、インスタンスに付ける名前で初期化します。  新しい **GenericIdentity** オブジェクトを作成し、名前 `MyUser` で初期化するコードを次に示します。  
+  
+    ```vb  
+    Dim MyIdentity As New GenericIdentity("MyUser")  
+    ```  
+  
+    ```csharp  
+    GenericIdentity MyIdentity = new GenericIdentity("MyUser");  
+    ```  
+  
+2.  **GenericPrincipal** クラスの新しいインスタンスを作成し、前に作成した **GenericIdentity** オブジェクトと、プリンシパルに関連付けるロールを表す文字列の配列で、このインスタンスを初期化します。  管理者のロールとユーザーのロールを表す文字列の配列を指定するコード例を次に示します。  **GenericPrincipal** は、前の **GenericIdentity** と文字列配列で初期化されます。  
+  
+    ```vb  
+    Dim MyStringArray As String() = {"Manager", "Teller"}  
+    DIm MyPrincipal As New GenericPrincipal(MyIdentity, MyStringArray)  
+    ```  
+  
+    ```csharp  
+    String[] MyStringArray = {"Manager", "Teller"};  
+    GenericPrincipal MyPrincipal = new GenericPrincipal(MyIdentity, MyStringArray);  
+    ```  
+  
+3.  次のコードを使用して、プリンシパルを現在のスレッドに結合します。  この方法は、プリンシパルが 2 回以上検証される必要がある場合、アプリケーション内で実行されている他のコードによって検証される必要がある場合、または <xref:System.Security.Permissions.PrincipalPermission> オブジェクトによって検証される必要がある場合に便利です。  このような場合でも、プリンシパル オブジェクトをスレッドに結合せずにロール ベースの検証を行うことができます。  詳細については、「[プリンシパル オブジェクトの置き換え](../../../docs/standard/security/replacing-a-principal-object.md)」を参照してください。  
+  
+    ```vb  
+    Thread.CurrentPrincipal = MyPrincipal  
+    ```  
+  
+    ```csharp  
+    Thread.CurrentPrincipal = MyPrincipal;  
+    ```  
+  
+## 使用例  
+ **GenericPrincipal** と **GenericIdentity** のインスタンスを作成する方法を示すコードを次に示します。  このコードは、各オブジェクトの値をコンソールに表示します。  
+  
+```vb  
+Imports System  
+Imports System.Security.Principal  
+Imports System.Threading  
+  
+Public Class Class1  
+  
+    Public Shared Sub Main()  
+        ' Create generic identity.  
+        Dim MyIdentity As New GenericIdentity("MyIdentity")  
+  
+        ' Create generic principal.  
+        Dim MyStringArray As String() =  {"Manager", "Teller"}  
+        Dim MyPrincipal As New GenericPrincipal(MyIdentity, MyStringArray)  
+  
+        ' Attach the principal to the current thread.  
+        ' This is not required unless repeated validation must occur,  
+        ' other code in your application must validate, or the   
+        ' PrincipalPermisson object is used.   
+        Thread.CurrentPrincipal = MyPrincipal  
+  
+        ' Print values to the console.  
+        Dim Name As String = MyPrincipal.Identity.Name  
+        Dim Auth As Boolean = MyPrincipal.Identity.IsAuthenticated  
+        Dim IsInRole As Boolean = MyPrincipal.IsInRole("Manager")  
+  
+        Console.WriteLine("The Name is: {0}", Name)  
+        Console.WriteLine("The IsAuthenticated is: {0}", Auth)  
+        Console.WriteLine("Is this a Manager? {0}", IsInRole)  
+  
+    End Sub  
+  
+End Class  
+```  
+  
+```csharp  
+using System;  
+using System.Security.Principal;  
+using System.Threading;  
+  
+public class Class1  
+{  
+    public static int Main(string[] args)  
+    {  
+    // Create generic identity.  
+    GenericIdentity MyIdentity = new GenericIdentity("MyIdentity");  
+  
+    // Create generic principal.  
+    String[] MyStringArray = {"Manager", "Teller"};  
+    GenericPrincipal MyPrincipal =   
+        new GenericPrincipal(MyIdentity, MyStringArray);  
+  
+    // Attach the principal to the current thread.  
+    // This is not required unless repeated validation must occur,  
+    // other code in your application must validate, or the   
+    // PrincipalPermisson object is used.   
+    Thread.CurrentPrincipal = MyPrincipal;  
+  
+    // Print values to the console.  
+    String Name =  MyPrincipal.Identity.Name;  
+    bool Auth =  MyPrincipal.Identity.IsAuthenticated;   
+    bool IsInRole =  MyPrincipal.IsInRole("Manager");  
+  
+    Console.WriteLine("The Name is: {0}", Name);  
+    Console.WriteLine("The IsAuthenticated is: {0}", Auth);  
+    Console.WriteLine("Is this a Manager? {0}", IsInRole);  
+  
+    return 0;  
+    }  
+}  
+```  
+  
+ 実行されると、アプリケーションは次のような出力を表示します。  
+  
+```  
+The Name is: MyIdentity  
+The IsAuthenticated is: True  
+Is this a Manager? True  
+```  
+  
+## 参照  
+ <xref:System.Security.Principal.GenericIdentity>   
+ <xref:System.Security.Principal.GenericPrincipal>   
+ <xref:System.Security.Permissions.PrincipalPermission>   
+ [プリンシパル オブジェクトの置き換え](../../../docs/standard/security/replacing-a-principal-object.md)   
+ [プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-decrypt-xml-elements-with-asymmetric-keys.md b/docs/standard/security/how-to-decrypt-xml-elements-with-asymmetric-keys.md
new file mode 100644
index 00000000000..84a42b992ba
--- /dev/null
+++ b/docs/standard/security/how-to-decrypt-xml-elements-with-asymmetric-keys.md
@@ -0,0 +1,92 @@
+---
+title: "方法 : 非対称キーで XML 要素を復号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非対称キー"
+  - "復号化"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.RSACryptoServiceProvider クラス"
+  - "XML の暗号化"
+ms.assetid: dd5de491-dafe-4b94-966d-99714b2e754a
+caps.latest.revision: 14
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# 方法 : 非対称キーで XML 要素を復号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化および復号化することができます。  XML 暗号化は、データが簡単に読み取られる心配なく、暗号化された XML データを交換または保存する標準的な方法です。  XML 暗号化の基準の詳細については、World Wide Web Consortium \(W3C\) の推奨事項「[XML 署名の構文と処理](http://go.microsoft.com/fwlink/?LinkID=136777)」を参照してください。  
+  
+ この手順の例では、「[方法 : 非対称キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md)」に記載する方法を使用して暗号化された XML 要素を復号化しています。  \<`EncryptedData`\> 要素を検出し、要素を復号化してから、要素を元のプレーン テキストの XML 要素に置き換えます。  
+  
+ この例では、2 つのキーを使用して XML 要素を復号化します。  以前に生成された RSA プライベート キーをキー コンテナーから取得します。次に、RSA キーを使用して \<`EncryptedData`\> 要素の \<`EncryptedKey`\> 要素に格納されているセッション キーを復号化します。  例では、セッション キーを使用して XML 要素を復号化します。  
+  
+ この例は、複数のアプリケーションが暗号化されたデータを共有する必要がある状況や、1 つのアプリケーションが、実行する時間の間に暗号化されたデータを保存する必要がある状況に適しています。  
+  
+### 非対称キーで XML 要素を復号化するには  
+  
+1.  <xref:System.Security.Cryptography.CspParameters> オブジェクトを作成し、キーのコンテナーの名前を指定します。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#2)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#2)]  
+  
+2.  <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトを使用して、コンテナーから以前に生成された非対称キーを取得します。  <xref:System.Security.Cryptography.CspParameters> オブジェクトを <xref:System.Security.Cryptography.RSACryptoServiceProvider> コンストラクターに渡すと、キー コンテナーからキーが自動的に取得されます。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#3)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#3)]  
+  
+3.  <xref:System.Security.Cryptography.Xml.EncryptedXml> オブジェクトを新規作成してドキュメントを復号化します。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#5)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#5)]  
+  
+4.  復号化が必要なドキュメント内で RSA キーと要素と関連付けるには、キーと名前のマッピングを追加します。  ドキュメントを暗号化したときに使用したキーと同じ名前を使用する必要があります。  この名前は、手順 1 で指定されたキー コンテナー内のキーを識別するために使用する名前とは別であることに注意してください。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#6)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#6)]  
+  
+5.  \<`EncryptedData`\> 要素を復号化するには、<xref:System.Security.Cryptography.Xml.EncryptedXml.DecryptDocument%2A> メソッドを呼び出します。  このメソッドは、RSA キーを使用してセッション キーを復号化してから、自動的にセッション キーを使用して、XML 要素を復号化します。  また、\<`EncryptedData`\> 要素を元のプレーン テキストに自動的に置き換えます。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#7)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#7)]  
+  
+6.  XML ドキュメントを保存します。  
+  
+     [!code-csharp[HowToDecryptXMLElementAsymmetric#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#8)]
+     [!code-vb[HowToDecryptXMLElementAsymmetric#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#8)]  
+  
+## 使用例  
+ この例では、`test.xml` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  さらに、「[方法 : 非対称キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md)」に記載する方法を使用して暗号化された XML 要素が `test.xml` に含まれていることも前提としています。  
+  
+ [!code-csharp[HowToDecryptXMLElementAsymmetric#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/cs/sample.cs#1)]
+ [!code-vb[HowToDecryptXMLElementAsymmetric#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementAsymmetric/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 対称暗号化キーをプレーンテキストで保存したり、対称キーをコンピューター間でプレーンテキストで転送したりしないでください。  加えて、非対称キー ペアの秘密キーをプレーンテキストで保存または転送しないでください。  対称暗号化キーと非対称暗号化キーの詳細については、「[暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)」を参照してください。  
+  
+ キーをソース コードに直接埋め込まないでください。  埋め込まれたキーは、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用するか、メモ帳などのテキスト エディターでアセンブリを開くことで簡単に読み取ることができます。  
+  
+ 暗号化キーを使用して完了したら、各バイトをゼロ \(0\) にするか、マネージ暗号化クラスの <xref:System.Security.Cryptography.SymmetricAlgorithm.Clear%2A> メソッドを呼び出してメモリから消去します。  暗号化キーは、デバッガーによってメモリから読み取られるか、メモリの位置がディスクにページングされている場合はハード ドライブから読み取られることがあります。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : 非対称キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-decrypt-xml-elements-with-symmetric-keys.md b/docs/standard/security/how-to-decrypt-xml-elements-with-symmetric-keys.md
new file mode 100644
index 00000000000..7ac663102cf
--- /dev/null
+++ b/docs/standard/security/how-to-decrypt-xml-elements-with-symmetric-keys.md
@@ -0,0 +1,93 @@
+---
+title: "方法 : 共通キーで XML 要素を復号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "復号化"
+  - "Rijndael"
+  - "共通キー"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.RijndaelManaged クラス"
+  - "XML の暗号化"
+ms.assetid: 6038aff0-f92c-4e29-a618-d793410410d8
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# 方法 : 共通キーで XML 要素を復号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化することができます。  XML の暗号化を使用すると、データが簡単に読み取られる心配をせずに機密性の高い XML を格納またはトランスポートできます。  このコード例では、Rijndael としても知られる Advanced Encryption Standard \(AES\) アルゴリズムを使用して XML 要素を復号化します。  
+  
+ この手順を使用して XML 要素を暗号化する方法については、「[方法 : 共通キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md)」を参照してください。  
+  
+ XML データの暗号化に AES のような対称アルゴリズムを使用するときは、XML データの暗号化と復号化に同じキーを使用する必要があります。  この手順の例では、暗号化された XML が同じキーを使用して暗号化されたこと、および暗号化側と復号化側で使用するアルゴリズムとキーが一致していることを前提としています。  この例では、暗号化された XML 内での AES キーの格納や暗号化は行いません。  
+  
+ この例は、1 つのアプリケーションが、メモリ内に格納されたセッション キーに基づいて、またはパスワードから派生した暗号強度の高いキーに基づいてデータを暗号化する必要がある状況に適しています。  複数のアプリケーションが暗号化された XML データを共有する必要がある場合は、非対称アルゴリズムまたは X.509 証明書に基づく暗号化スキームの使用を検討してください。  
+  
+### 対称キーで XML 要素を復号化するには  
+  
+1.  [方法 : 共通キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md) で説明する手法を使用して、以前に生成されたキーで XML 要素を暗号化します。  
+  
+2.  暗号化された XML を含む <xref:System.Xml.XmlDocument> オブジェクトにある \<`EncryptedData`\> 要素 \(XML 暗号化基準で定義\) を検索し、その要素を表す <xref:System.Xml.XmlElement> オブジェクトを新規作成します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#10)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#10)]  
+  
+3.  以前に作成した <xref:System.Xml.XmlElement> オブジェクトから XML の生データを読み込んで <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトを作成します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#11)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#11)]  
+  
+4.  <xref:System.Security.Cryptography.Xml.EncryptedXml> オブジェクトを新規作成し、これを使用して、暗号化に使用したキーと同じキーで XML データを復号化します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#12)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#12)]  
+  
+5.  暗号化された要素を、XML ドキュメント内の新しく復号化されたプレーンテキストの要素に置き換えます。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#13](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#13)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#13)]  
+  
+## 使用例  
+ この例では、`"test.xml"` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  また、`"test.xml"` には `"creditcard"` 要素が含まれることも前提としています。  次の XML を `test.xml` というファイルに配置し、この例で使用することができます。  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+  
+```  
+  
+ [!code-csharp[HowToEncryptXMLElementSymmetric#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#1)]
+ [!code-vb[HowToEncryptXMLElementSymmetric#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 暗号化キーをプレーンテキストで保存したり、コンピューター間でプレーンテキストでキーを転送したりしないでください。  
+  
+ 対称暗号化キーを使用して完了したら、各バイトをゼロ \(0\) にするか、マネージ暗号化クラスの <xref:System.Security.Cryptography.SymmetricAlgorithm.Clear%2A> メソッドを呼び出してメモリから消去します。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : 共通キーで XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-decrypt-xml-elements-with-x-509-certificates.md b/docs/standard/security/how-to-decrypt-xml-elements-with-x-509-certificates.md
new file mode 100644
index 00000000000..224805a5aa2
--- /dev/null
+++ b/docs/standard/security/how-to-decrypt-xml-elements-with-x-509-certificates.md
@@ -0,0 +1,89 @@
+---
+title: "方法 : X.509 証明書で XML 要素を復号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "証明書, X.509 証明書"
+  - "復号化"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.X509Certificate2 クラス"
+  - "X.509 証明書"
+  - "XML の暗号化"
+ms.assetid: bd015722-d88d-408d-8ca8-e4e475c441ed
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 方法 : X.509 証明書で XML 要素を復号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化および復号化することができます。  XML 暗号化は、データが簡単に読み取られる心配なく、暗号化された XML データを交換または保存する標準的な方法です。  XML 暗号化の規格の詳細については、http:\/\/www.w3.org\/TR\/xmldsig\-core\/ にある World Wide Web Consortium \(W3C\) の XML 暗号化の仕様を参照してください。  
+  
+ この例では、「[方法 : X.509 証明書で XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-x-509-certificates.md)」に記載する方法を使用して暗号化された XML 要素を復号化しています。  \<`EncryptedData`\> 要素を検出し、要素を復号化してから、要素を元のプレーン テキストの XML 要素に置き換えます。  
+  
+ この手順のコード例では、現在のユーザー アカウントのローカルの証明書ストアから X.509 証明書を使用して XML 要素を復号化しています。  この例では、<xref:System.Security.Cryptography.Xml.EncryptedXml.DecryptDocument%2A> メソッドを使用して、自動的に X.509 証明書を取得します。また、\<`EncryptedData`\> 要素の \<`EncryptedKey`\> 要素に格納されたセッション キーを復号化します。  次に、<xref:System.Security.Cryptography.Xml.EncryptedXml.DecryptDocument%2A> メソッドは、自動的にセッション キーを使用して XML 要素を復号化します。  
+  
+ この例は、複数のアプリケーションが暗号化されたデータを共有する必要がある状況、または 1 つのアプリケーションが、実行する時間の間に暗号化されたデータを保存する必要がある状況に適しています。  
+  
+### X.509 キーで XML 要素を復号化するには  
+  
+1.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、復号化する XML 要素が含まれています。  
+  
+     [!code-csharp[HowToDecryptXMLElementX509#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementX509/cs/sample.cs#2)]
+     [!code-vb[HowToDecryptXMLElementX509#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementX509/vb/sample.vb#2)]  
+  
+2.  <xref:System.Xml.XmlDocument> オブジェクトをコンストラクターに渡して <xref:System.Security.Cryptography.Xml.EncryptedXml> オブジェクトを新規作成します。  
+  
+     [!code-csharp[HowToDecryptXMLElementX509#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementX509/cs/sample.cs#3)]
+     [!code-vb[HowToDecryptXMLElementX509#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementX509/vb/sample.vb#3)]  
+  
+3.  <xref:System.Security.Cryptography.Xml.EncryptedXml.DecryptDocument%2A> メソッドを使用して XML ドキュメントを復号化します。  
+  
+     [!code-csharp[HowToDecryptXMLElementX509#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementX509/cs/sample.cs#4)]
+     [!code-vb[HowToDecryptXMLElementX509#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementX509/vb/sample.vb#4)]  
+  
+4.  <xref:System.Xml.XmlDocument> オブジェクトを保存します。  
+  
+     [!code-csharp[HowToDecryptXMLElementX509#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementX509/cs/sample.cs#5)]
+     [!code-vb[HowToDecryptXMLElementX509#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementX509/vb/sample.vb#5)]  
+  
+## 使用例  
+ この例では、`"test.xml"` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  また、`"test.xml"` には `"creditcard"` 要素が含まれることも前提としています。  次の XML を `test.xml` というファイルに配置し、この例で使用することができます。  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+  
+```  
+  
+ [!code-csharp[HowToDecryptXMLElementX509#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToDecryptXMLElementX509/cs/sample.cs#1)]
+ [!code-vb[HowToDecryptXMLElementX509#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToDecryptXMLElementX509/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ この例で使用される X.509 証明書は、テスト専用です。  アプリケーションは、信頼された証明機関が生成する X.509 証明書、または Microsoft Windows 証明書サーバーによって生成された証明書を使用する必要があります。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : X.509 証明書で XML 要素を暗号化する](../../../docs/standard/security/how-to-encrypt-xml-elements-with-x-509-certificates.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md b/docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md
new file mode 100644
index 00000000000..073288379e1
--- /dev/null
+++ b/docs/standard/security/how-to-encrypt-xml-elements-with-asymmetric-keys.md
@@ -0,0 +1,154 @@
+---
+title: "方法 : 非対称キーで XML 要素を暗号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Advanced Encryption Standard アルゴリズム"
+  - "AES アルゴリズム"
+  - "非対称キー [.NET Framework]"
+  - "暗号化 [.NET Framework], 非対称キー"
+  - "暗号化 [.NET Framework], 非対称キー"
+  - "キー コンテナー"
+  - "Rijndael"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.RSACryptoServiceProvider クラス"
+  - "XML の暗号化"
+ms.assetid: a164ba4f-e596-4bbe-a9ca-f214fe89ed48
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 非対称キーで XML 要素を暗号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化することができます。  XML 暗号化は、データが簡単に読み取られる心配なく、暗号化された XML データを交換または保存する標準的な方法です。  XML 暗号化の規格の詳細については、http:\/\/www.w3.org\/TR\/xmldsig\-core\/ にある World Wide Web Consortium \(W3C\) の XML 暗号化の仕様を参照してください。  
+  
+ XML 暗号化を使用すると、任意の XML 要素またはドキュメントを、暗号化された XML データを含む \<`EncryptedData`\> 要素があるドキュメントに置き換えることができます。  また、\<`EncryptedData`\> 要素には、暗号化時に使用されたキーとプロセスに関する情報が含まれているサブ要素を含めることもできます。  XML 暗号化を使用すると、ドキュメントに複数の暗号化された要素を含められるだけでなく、要素を複数回暗号化することができます。  この手順のコード例は、\<`EncryptedData`\> 要素および後の復号化時に使用するいくつかの他のサブ要素の作成方法を示しています。  
+  
+ この例では、2 つのキーを使用して XML 要素を暗号化します。  RSA の公開キーと秘密キーのペアを生成し、キーのペアをセキュリティで保護されたキー コンテナーに保存します。  この例では、Rijndael アルゴリズムとも呼ばれる Advanced Encryption Standard \(AES\) アルゴリズムを使用して、別のセッション キーを作成します。  この例では、XML ドキュメントの暗号化に AES セッション キーを使用してから、AES セッション キーを暗号化するために RSA 公開キーを使用しています。  最後に、この例では、暗号化された AES セッション キーと暗号化された XML データを、新しい \<`EncryptedData`\> 要素内の XML ドキュメントに保存します。  
+  
+ XML 要素を復号化するには、キー コンテナーから RSA 秘密キーを取得し、これを使用してセッション キーを復号化してから、セッション キーを使用してドキュメントを復号化します。  この手順を使用して暗号化された XML 要素を復号化する方法の詳細については、「[方法 : 非対称キーで XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-asymmetric-keys.md)」を参照してください。  
+  
+ この例は、複数のアプリケーションが暗号化されたデータを共有する必要がある状況や、1 つのアプリケーションが、実行する時間の間に暗号化されたデータを保存する必要がある状況に適しています。  
+  
+### 非対称キーで XML 要素を暗号化するには  
+  
+1.  <xref:System.Security.Cryptography.CspParameters> オブジェクトを作成し、キー コンテナーの名前を指定します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#2)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#2)]  
+  
+2.  <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスを使用して対称キーを生成します。  <xref:System.Security.Cryptography.CspParameters> オブジェクトを <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスのコンストラクターに渡すと、キーは自動的にキー コンテナーに保存されます。  このキーは、AES のセッション キーの暗号化に使用され、後で復号化するために取得することができます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#3)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#3)]  
+  
+3.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、暗号化する XML 要素が含まれています。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#4)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#4)]  
+  
+4.  <xref:System.Xml.XmlDocument> オブジェクトで指定された要素を検索し、暗号化する要素を表す新しい <xref:System.Xml.XmlElement> オブジェクトを作成します。  この例では、`"creditcard"` 要素が暗号化されます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#5)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#5)]  
+  
+5.  <xref:System.Security.Cryptography.RijndaelManaged> クラスを使用してセッション キーを新規作成します。  このキーは、XML 要素を暗号化してから、このキー自体が暗号化されて XML ドキュメントに配置されます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#6)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#6)]  
+  
+6.  <xref:System.Security.Cryptography.Xml.EncryptedXml> クラスのインスタンスを新規作成し、これを使用して、セッション キーによって指定された要素を暗号化します。  <xref:System.Security.Cryptography.Xml.EncryptedXml.EncryptData%2A> メソッドは、暗号化された要素を、暗号化されたバイトの配列として返します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#7)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#7)]  
+  
+7.  <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトを構築し、暗号化された XML 要素の URL 識別子をそれに読み込みます。  この URL 識別子は、復号化側に、XML に暗号化された要素が含まれていることを知らせます。  \[<xref:System.Security.Cryptography.Xml.EncryptedXml.XmlEncElementUrl>\] フィールドを使用すると、URL 識別子を指定することができます。  プレーン テキストの XML 要素は、この <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトによってカプセル化された \<`EncryptedData`\> 要素に置き換えられます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#8)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#8)]  
+  
+8.  セッション キーの生成に使用する暗号化アルゴリズムの URL 識別子に初期化された <xref:System.Security.Cryptography.Xml.EncryptionMethod> オブジェクトを作成します。  <xref:System.Security.Cryptography.Xml.EncryptionMethod> オブジェクトを <xref:System.Security.Cryptography.Xml.EncryptedType.EncryptionMethod%2A> プロパティに渡します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#9)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#9)]  
+  
+9. 暗号化されたセッション キーを格納する <xref:System.Security.Cryptography.Xml.EncryptedKey> オブジェクトを作成します。  セッション キーを暗号化し、<xref:System.Security.Cryptography.Xml.EncryptedKey> オブジェクトに追加して、セッション キーの名前とキーの識別子の URL を入力します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#10)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#10)]  
+  
+10. 暗号化されたデータを特定のセッション キーにマップする <xref:System.Security.Cryptography.Xml.DataReference> オブジェクトを新規作成します。  \(省略可能\) この手順を使用すると、XML ドキュメントの複数の部分が 1 つのキーによって暗号化されたことを簡単に指定できます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#11)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#11)]  
+  
+11. 暗号化されたキーを <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトに追加します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#12)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#12)]  
+  
+12. RSA キーの名前を指定する <xref:System.Security.Cryptography.Xml.KeyInfo> オブジェクトを新規作成します。  このオブジェクトを <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトに追加します。  これにより、復号化側は、適切な非対称キーを識別して、セッション キーを復号化する際に使用できるようになります。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#13](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#13)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#13)]  
+  
+13. 暗号化された要素のデータを <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトに追加します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#14](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#14)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#14](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#14)]  
+  
+14. 元の <xref:System.Xml.XmlDocument> オブジェクトの要素を <xref:System.Security.Cryptography.Xml.EncryptedData> 要素に置き換えます。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#15](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#15)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#15](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#15)]  
+  
+15. <xref:System.Xml.XmlDocument> オブジェクトを保存します。  
+  
+     [!code-csharp[HowToEncryptXMLElementAsymmetric#16](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#16)]
+     [!code-vb[HowToEncryptXMLElementAsymmetric#16](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#16)]  
+  
+## 使用例  
+ この例では、`"test.xml"` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  また、`"test.xml"` には `"creditcard"` 要素が含まれることも前提としています。  次の XML を `test.xml` というファイルに配置し、この例で使用することができます。  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+  
+```  
+  
+ [!code-csharp[HowToEncryptXMLElementAsymmetric#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/cs/sample.cs#1)]
+ [!code-vb[HowToEncryptXMLElementAsymmetric#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementAsymmetric/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 対称暗号化キーをプレーンテキストで保存したり、対称キーをコンピューター間でプレーンテキストで転送したりしないでください。  加えて、非対称キー ペアの秘密キーをプレーンテキストで保存または転送しないでください。  対称暗号化キーと非対称暗号化キーの詳細については、「[暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)」を参照してください。  
+  
+ キーをソース コードに直接埋め込まないでください。  埋め込まれたキーは、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用するか、メモ帳などのテキスト エディターでアセンブリを開くことで簡単に読み取ることができます。  
+  
+ 暗号化キーを使用して完了したら、各バイトをゼロ \(0\) にするか、マネージ暗号化クラスの <xref:System.Security.Cryptography.SymmetricAlgorithm.Clear%2A> メソッドを呼び出してメモリから消去します。  暗号化キーは、デバッガーによってメモリから読み取られるか、メモリの位置がディスクにページングされている場合はハード ドライブから読み取られることがあります。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : 非対称キーで XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-asymmetric-keys.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md b/docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md
new file mode 100644
index 00000000000..c29ad17252f
--- /dev/null
+++ b/docs/standard/security/how-to-encrypt-xml-elements-with-symmetric-keys.md
@@ -0,0 +1,113 @@
+---
+title: "方法 : 共通キーで XML 要素を暗号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "Advanced Encryption Standard アルゴリズム"
+  - "AES アルゴリズム"
+  - "暗号化 [.NET Framework], 共通キー"
+  - "暗号化 [.NET Framework], 共通キー"
+  - "Rijndael"
+  - "共通キー"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.RijndaelManaged クラス"
+  - "XML の暗号化"
+ms.assetid: d8461a44-aa2c-4ef4-b3e4-ab7cbaaee1b5
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : 共通キーで XML 要素を暗号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化することができます。  XML の暗号化を使用すると、データが簡単に読み取られる心配をせずに機密性の高い XML を格納またはトランスポートできます。  この手順では、Advanced Encryption Standard \(AES\) アルゴリズム \(Rijndael としても知られる\) を使用して XML 要素を復号化します。  
+  
+ この手順を使用して暗号化された XML 要素を復号化する方法については、「[方法 : 共通キーで XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-symmetric-keys.md)」を参照してください。  
+  
+ XML データの暗号化に AES のような対称アルゴリズムを使用するときは、XML データの暗号化と復号化に同じキーを使用する必要があります。  この手順の例では、暗号化された XML が同じキーを使用して復号化されること、および暗号化側と復号化側で使用するアルゴリズムとキーが一致していることを前提としています。  この例では、暗号化された XML 内での AES キーの格納や暗号化は行いません。  
+  
+ この例は、1 つのアプリケーションが、メモリ内に格納されたセッション キーに基づいて、またはパスワードから派生した暗号強度の高いキーに基づいてデータを暗号化する必要がある状況に適しています。  複数のアプリケーションが暗号化された XML データを共有する必要がある場合は、非対称アルゴリズムまたは X.509 証明書に基づく暗号化スキームの使用を検討してください。  
+  
+### 対称キーで XML 要素を暗号化するには  
+  
+1.  <xref:System.Security.Cryptography.RijndaelManaged> クラスを使用して対称キーを生成します。  このキーは、XML 要素の暗号化に使用されます。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#2)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#2)]  
+  
+2.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、暗号化する XML 要素が含まれています。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#3)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#3)]  
+  
+3.  <xref:System.Xml.XmlDocument> オブジェクトで指定された要素を検索し、暗号化する要素を表す新しい <xref:System.Xml.XmlElement> オブジェクトを作成します。  この例では、`"creditcard"` 要素が暗号化されます。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#4)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#4)]  
+  
+4.  <xref:System.Security.Cryptography.Xml.EncryptedXml> クラスの新しいインスタンスを作成し、これを使用して対称キーで <xref:System.Xml.XmlElement> を暗号化します。  <xref:System.Security.Cryptography.Xml.EncryptedXml.EncryptData%2A> メソッドは、暗号化された要素を、暗号化されたバイトの配列として返します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#5)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#5)]  
+  
+5.  <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトを構築し、XML 暗号化要素の URL 識別子を読み込みます。  この URL 識別子は、復号化側に、XML に暗号化された要素が含まれていることを知らせます。  <xref:System.Security.Cryptography.Xml.EncryptedXml.XmlEncElementUrl> フィールドを使用して URL 識別子を指定することができます。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#6)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#6)]  
+  
+6.  キーの生成に使用する暗号化アルゴリズムの URL 識別子に初期化された <xref:System.Security.Cryptography.Xml.EncryptionMethod> オブジェクトを作成します。  <xref:System.Security.Cryptography.Xml.EncryptionMethod> オブジェクトを <xref:System.Security.Cryptography.Xml.EncryptedType.EncryptionMethod%2A> プロパティに渡します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#7)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#7)]  
+  
+7.  暗号化された要素のデータを <xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトに追加します。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#8)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#8)]  
+  
+8.  元の <xref:System.Xml.XmlDocument> オブジェクトの要素を <xref:System.Security.Cryptography.Xml.EncryptedData> 要素に置き換えます。  
+  
+     [!code-csharp[HowToEncryptXMLElementSymmetric#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#9)]
+     [!code-vb[HowToEncryptXMLElementSymmetric#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#9)]  
+  
+## 使用例  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+  
+```  
+  
+ [!code-csharp[HowToEncryptXMLElementSymmetric#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/cs/sample.cs#1)]
+ [!code-vb[HowToEncryptXMLElementSymmetric#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementSymmetric/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 暗号化キーをプレーンテキストで保存したり、コンピューター間でプレーンテキストでキーを転送したりしないでください。  代わりに、セキュリティで保護されたキー コンテナーを使用して暗号化キーを格納します。  
+  
+ 暗号化キーを使用して完了したら、各バイトをゼロ \(0\) にするか、マネージ暗号化クラスの <xref:System.Security.Cryptography.SymmetricAlgorithm.Clear%2A> メソッドを呼び出してメモリから消去します。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : 共通キーで XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-symmetric-keys.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-encrypt-xml-elements-with-x-509-certificates.md b/docs/standard/security/how-to-encrypt-xml-elements-with-x-509-certificates.md
new file mode 100644
index 00000000000..3ba726144ad
--- /dev/null
+++ b/docs/standard/security/how-to-encrypt-xml-elements-with-x-509-certificates.md
@@ -0,0 +1,128 @@
+---
+title: "方法 : X.509 証明書で XML 要素を暗号化する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "証明書, X.509 証明書"
+  - "暗号化 [.NET Framework], X.509 証明書"
+  - "暗号化 [.NET Framework], X.509 証明書"
+  - "System.Security.Cryptography.EncryptedXml クラス"
+  - "System.Security.Cryptography.X509Certificate2 クラス"
+  - "X.509 証明書"
+  - "XML の暗号化"
+ms.assetid: 761f1c66-631c-47af-aa86-ad9c50cfa453
+caps.latest.revision: 15
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : X.509 証明書で XML 要素を暗号化する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用して、XML ドキュメント内の要素を暗号化することができます。  XML の暗号化は、データが簡単に読み取られる心配なく、暗号化された XML データを交換または保存する標準的な方法です。  XML 暗号化の基準の詳細については、http:\/\/www.w3.org\/TR\/xmldsig\-core\/ にある World Wide Web Consortium \(W3C\) の XML 暗号化の仕様を参照してください。  
+  
+ XML の暗号化を使用すると、任意の XML 要素またはドキュメントを、暗号化された XML データを含む \<`EncryptedData`\> 要素があるドキュメントに置き換えることができます。  \<`EncryptedData`\> 要素には、暗号化時に使用されたキーとプロセスに関する情報が含まれているサブ要素を含めることができます。  XML の暗号化を使用すると、ドキュメントに複数の暗号化された要素を含められるだけでなく、要素を複数回暗号化することができます。  この手順のコード例は、\<`EncryptedData`\> 要素の作成方法と共に、後の復号化時に使用するいくつかのその他のサブ要素の作成方法を示しています。  
+  
+ この例では、2 つのキーを使用して XML 要素を復号化します。  [Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md) を使用してテストの X.509 証明書を生成し、この証明書を証明書ストアに保存します。  この例では、プログラムを使用して証明書を取得し、これを使用して <xref:System.Security.Cryptography.Xml.EncryptedXml.Encrypt%2A> メソッドで XML 要素を暗号化します。  内部的には、<xref:System.Security.Cryptography.Xml.EncryptedXml.Encrypt%2A> メソッドは別のセッション キーを作成し、これを使用して XML ドキュメントを暗号化します。  このメソッドでは、セッション キーを暗号化し、新しい \<`EncryptedData`\> 要素内に暗号化された XML と共に保存します。  
+  
+ XML 要素を復号化するには、<xref:System.Security.Cryptography.Xml.EncryptedXml.DecryptDocument%2A> メソッドを呼び出します。これにより、ストアから X.509 証明書が自動的に取得され、必要な復号化が実行されます。  この手順を使用して暗号化された XML 要素を復号化する方法の詳細については、「[方法 : X.509 証明書で XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-x-509-certificates.md)」を参照してください。  
+  
+ この例は、複数のアプリケーションが暗号化されたデータを共有する必要がある状況や、1 つのアプリケーションが、実行する時間の間に暗号化されたデータを保存する必要がある状況に適しています。  
+  
+### X.509 証明書で XML 要素を暗号化するには  
+  
+1.  [Makecert.exe \(証明書作成ツール\)](../Topic/Makecert.exe%20\(Certificate%20Creation%20Tool\).md) を使用してテストの X.509 証明書を生成し、ローカル ユーザーのストアに配置します。  交換キーを生成する必要があり、このキーをエクスポート可能にする必要があります。  次のコマンドを実行します。  
+  
+    ```  
+    makecert -r -pe -n "CN=XML_ENC_TEST_CERT" -b 01/01/2005 -e 01/01/2010 -sky exchange -ss my  
+    ```  
+  
+2.  <xref:System.Security.Cryptography.X509Certificates.X509Store> オブジェクトを作成し、このオブジェクトを現在のユーザー ストアを開くように初期化します。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#2)]
+     [!code-vb[HowToEncryptXMLElementX509#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#2)]  
+  
+3.  ストアを読み取り専用モードで開きます。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#3)]
+     [!code-vb[HowToEncryptXMLElementX509#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#3)]  
+  
+4.  <xref:System.Security.Cryptography.X509Certificates.X509Certificate2Collection> を、ストア内のすべての証明書で初期化します。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#4)]
+     [!code-vb[HowToEncryptXMLElementX509#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#4)]  
+  
+5.  ストア内の証明書を列挙し、適切な名前を持つ証明書を検索します。  この例では、証明書の名前は `"CN=XML_ENC_TEST_CERT"` です。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#5)]
+     [!code-vb[HowToEncryptXMLElementX509#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#5)]  
+  
+6.  証明書が見つかったら、ストアを閉じます。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#6)]
+     [!code-vb[HowToEncryptXMLElementX509#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#6)]  
+  
+7.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、暗号化する XML 要素が含まれています。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#7)]
+     [!code-vb[HowToEncryptXMLElementX509#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#7)]  
+  
+8.  <xref:System.Xml.XmlDocument> オブジェクトで指定された要素を検索し、暗号化する要素を表す新しい <xref:System.Xml.XmlElement> オブジェクトを作成します。  この例では、`"creditcard"` 要素が暗号化されます。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#8)]
+     [!code-vb[HowToEncryptXMLElementX509#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#8)]  
+  
+9. <xref:System.Security.Cryptography.Xml.EncryptedXml> クラスのインスタンスを新規作成し、これを使用して、X.509 証明書によって指定された要素を暗号化します。  <xref:System.Security.Cryptography.Xml.EncryptedXml.Encrypt%2A> メソッドは、暗号化された要素を、<xref:System.Security.Cryptography.Xml.EncryptedData> オブジェクトとして返します。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#9)]
+     [!code-vb[HowToEncryptXMLElementX509#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#9)]  
+  
+10. 元の <xref:System.Xml.XmlDocument> オブジェクトの要素を <xref:System.Security.Cryptography.Xml.EncryptedData> 要素に置き換えます。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#10)]
+     [!code-vb[HowToEncryptXMLElementX509#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#10)]  
+  
+11. <xref:System.Xml.XmlDocument> オブジェクトを保存します。  
+  
+     [!code-csharp[HowToEncryptXMLElementX509#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#11)]
+     [!code-vb[HowToEncryptXMLElementX509#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#11)]  
+  
+## 使用例  
+ この例では、`"test.xml"` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  また、`"test.xml"` には `"creditcard"` 要素が含まれることも前提としています。  次の XML を `test.xml` というファイルに配置し、この例で使用することができます。  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+  
+```  
+  
+ [!code-csharp[HowToEncryptXMLElementX509#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToEncryptXMLElementX509/cs/sample.cs#1)]
+ [!code-vb[HowToEncryptXMLElementX509#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToEncryptXMLElementX509/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ この例で使用される X.509 証明書は、テスト専用です。  アプリケーションは、信頼された証明機関が生成する X.509 証明書、または Microsoft Windows 証明書サーバーによって生成された証明書を使用する必要があります。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : X.509 証明書で XML 要素を復号化する](../../../docs/standard/security/how-to-decrypt-xml-elements-with-x-509-certificates.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md b/docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md
new file mode 100644
index 00000000000..a696711efdf
--- /dev/null
+++ b/docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md
@@ -0,0 +1,129 @@
+---
+title: "方法 : デジタル署名で XML ドキュメントに署名する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "デジタル署名, XML 署名"
+  - "シグネチャ, XML 署名"
+  - "署名 (XML に)"
+  - "System.Security.Cryptography.RSACryptoServiceProvider クラス"
+  - "System.Security.Cryptography.SignedXml クラス"
+  - "XML デジタル署名"
+  - "XML 署名"
+ms.assetid: 99692ac1-d8c9-42d7-b1bf-2737b01037e4
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# 方法 : デジタル署名で XML ドキュメントに署名する
+<xref:System.Security.Cryptography.Xml> 名前空間のクラスを使用すると、XML ドキュメントまたは XML ドキュメントの一部にデジタル署名で署名することができます。  XML デジタル署名 \(XMLDSIG\) を使用すると、データが署名後に変更されなかったことを確認できます。  XMLDSIG の基準の詳細については、World Wide Web Consortium \(W3C\) の推奨事項「[XML 署名の構文と処理](http://go.microsoft.com/fwlink/?LinkID=136777)」を参照してください。  
+  
+ この手順のコード例は、XML ドキュメント全体にデジタル署名する方法、および \<`Signature`\> 要素内のドキュメントに署名を付す方法を示しています。  この例では、RSA 署名キーを作成し、キーをセキュリティで保護されたキー コンテナーに追加してから、キーを使用して XML ドキュメントにデジタル署名しています。  キーは、XML デジタル署名を確認するために取得したり、別の XML ドキュメントの署名に使用したりすることができます。  
+  
+ この手順を使用して作成された XML デジタル署名を確認する方法については、「[方法 : XML ドキュメントのデジタル署名を検証する](../../../docs/standard/security/how-to-verify-the-digital-signatures-of-xml-documents.md)」を参照してください。  
+  
+### XML ドキュメントにデジタル署名するには  
+  
+1.  <xref:System.Security.Cryptography.CspParameters> オブジェクトを作成し、キー コンテナーの名前を指定します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#2)]
+     [!code-vb[HowToSignXMLDocumentRSA#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#2)]  
+  
+2.  <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスを使用して非対称キーを生成します。  <xref:System.Security.Cryptography.CspParameters> オブジェクトを <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスのコンストラクターに渡すと、キーは自動的にキー コンテナーに保存されます。  このキーは、XML ドキュメントの署名に使用されます。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#3)]
+     [!code-vb[HowToSignXMLDocumentRSA#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#3)]  
+  
+3.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、暗号化する XML 要素が含まれています。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#4)]
+     [!code-vb[HowToSignXMLDocumentRSA#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#4)]  
+  
+4.  <xref:System.Security.Cryptography.Xml.SignedXml> オブジェクトを新規作成し、それに <xref:System.Xml.XmlDocument> オブジェクトを渡します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#5)]
+     [!code-vb[HowToSignXMLDocumentRSA#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#5)]  
+  
+5.  署名する RSA キーを <xref:System.Security.Cryptography.Xml.SignedXml> オブジェクトに追加します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#6)]
+     [!code-vb[HowToSignXMLDocumentRSA#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#6)]  
+  
+6.  署名内容について記述する <xref:System.Security.Cryptography.Xml.Reference> オブジェクトを作成します。  ドキュメント全体に署名するには、<xref:System.Security.Cryptography.Xml.Reference.Uri%2A> プロパティを `""` に設定します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#7)]
+     [!code-vb[HowToSignXMLDocumentRSA#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#7)]  
+  
+7.  <xref:System.Security.Cryptography.Xml.XmlDsigEnvelopedSignatureTransform> オブジェクトを <xref:System.Security.Cryptography.Xml.Reference> オブジェクトに追加します。  変換を使用すると、検証側は、署名側が使用した方法と同一の方法で XML データを表すことができます。  XML データはさまざまな方法で表すことができるため、この手順は検証にとって重要です。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#8)]
+     [!code-vb[HowToSignXMLDocumentRSA#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#8)]  
+  
+8.  <xref:System.Security.Cryptography.Xml.Reference> オブジェクトを <xref:System.Security.Cryptography.Xml.SignedXml> オブジェクトに追加します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#9](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#9)]
+     [!code-vb[HowToSignXMLDocumentRSA#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#9)]  
+  
+9. <xref:System.Security.Cryptography.Xml.SignedXml.ComputeSignature%2A> メソッドを呼び出して署名を計算します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#10](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#10)]
+     [!code-vb[HowToSignXMLDocumentRSA#10](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#10)]  
+  
+10. 署名の XML 表記 \(\<`Signature`\> 要素\) を取得して、新しい <xref:System.Xml.XmlElement> オブジェクトに保存します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#11](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#11)]
+     [!code-vb[HowToSignXMLDocumentRSA#11](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#11)]  
+  
+11. <xref:System.Xml.XmlDocument> オブジェクトに要素を追加します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#12](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#12)]
+     [!code-vb[HowToSignXMLDocumentRSA#12](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#12)]  
+  
+12. ドキュメントを保存します。  
+  
+     [!code-csharp[HowToSignXMLDocumentRSA#13](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#13)]
+     [!code-vb[HowToSignXMLDocumentRSA#13](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#13)]  
+  
+## 使用例  
+ この例では、`test.xml` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  次の XML を `test.xml` というファイルに配置し、この例で使用することができます。  
+  
+```  
+<root>  
+    <creditcard>  
+        <number>19834209</number>  
+        <expiry>02/02/2002</expiry>  
+    </creditcard>  
+</root>  
+```  
+  
+ [!code-csharp[HowToSignXMLDocumentRSA#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToSignXMLDocumentRSA/cs/sample.cs#1)]
+ [!code-vb[HowToSignXMLDocumentRSA#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToSignXMLDocumentRSA/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 非対称キー ペアの秘密キーをプレーンテキストで保存または転送しないでください。  対称暗号化キーと非対称暗号化キーの詳細については、「[暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)」を参照してください。  
+  
+ 秘密キーをソース コードに直接埋め込まないでください。  埋め込まれたキーは、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用するか、メモ帳などのテキスト エディターでアセンブリを開くことで簡単に読み取ることができます。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : XML ドキュメントのデジタル署名を検証する](../../../docs/standard/security/how-to-verify-the-digital-signatures-of-xml-documents.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md b/docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md
new file mode 100644
index 00000000000..9f89ef911b1
--- /dev/null
+++ b/docs/standard/security/how-to-store-asymmetric-keys-in-a-key-container.md
@@ -0,0 +1,237 @@
+---
+title: "方法 : キー コンテナーに非対称キーを格納する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "非対称キー [.NET Framework]"
+  - "暗号化 [.NET Framework], 非対称キー"
+  - "復号化キー"
+  - "暗号化 [.NET Framework], 非対称キー"
+  - "暗号化キー"
+  - "キー, 非対称"
+  - "キー, 格納 (キー コンテナーに)"
+  - "格納 (非対称キーを)"
+ms.assetid: 0dbcbd8d-0dcf-40e9-9f0c-e3f162d35ccc
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 方法 : キー コンテナーに非対称キーを格納する
+非対称秘密キーは、ローカル コンピューターにそのまま平文として保存しないでください。  秘密キーを格納する必要がある場合は、キー コンテナーを使用することをお勧めします。  キー コンテナーの詳細については、「[Understanding Machine\-Level and User\-Level RSA Key Containers](../Topic/Understanding%20Machine-Level%20and%20User-Level%20RSA%20Key%20Containers.md)」を参照してください。  
+  
+### 非対称キーを作成し、キー コンテナーに格納するには  
+  
+1.  <xref:System.Security.Cryptography.CspParameters> クラスの新しいインスタンスを作成し、キー コンテナーを呼び出すときに使用する名前を <xref:System.Security.Cryptography.CspParameters.KeyContainerName?displayProperty=fullName> フィールドに渡します。  
+  
+2.  <xref:System.Security.Cryptography.AsymmetricAlgorithm> クラスから派生したクラス \(通常は **RSACryptoServiceProvider** または **DSACryptoServiceProvider**\) の新しいインスタンスを作成し、前に作成した **CspParameters**オブジェクトをそのコンストラクターに渡します。  
+  
+### キー コンテナーからキーを削除するには  
+  
+1.  **CspParameters** クラスの新しいインスタンスを作成し、キー コンテナーを呼び出すときに使用する名前を **CspParameters.KeyContainerName** フィールドに渡します。  
+  
+2.  **AsymmetricAlgorithm** クラスから派生したクラス \(通常は **RSACryptoServiceProvider** または **DSACryptoServiceProvider**\) の新しいインスタンスを作成し、前に作成した **CspParameters** オブジェクトをそのコンストラクターに渡します。  
+  
+3.  **AsymmetricAlgorithm** から派生したクラスの **PersistKeyInCSP** プロパティを **false** \(Visual Basic では **False**\) に設定します。  
+  
+4.  **AsymmetricAlgorithm** から派生したクラスの **Clear** メソッドを呼び出します。  このメソッドは、クラスのすべてのリソースを解放し、キー コンテナーを消去します。  
+  
+## 使用例  
+ 非対称キーを作成し、それをキー コンテナーへ格納し、後でキーを取得し、最後にキー コンテナーからキーを削除する方法の例を次に示します。  
+  
+ `GenKey_SaveInContainer` メソッドと `GetKeyFromContainer` メソッドのコードは類似していることに注意してください。  <xref:System.Security.Cryptography.CspParameters> オブジェクトのキー コンテナー名を指定した場合、<xref:System.Security.Cryptography.AsymmetricAlgorithm> プロパティまたは <xref:System.Security.Cryptography.RSACryptoServiceProvider.PersistKeyInCsp%2A> プロパティを true に設定して、指定したキー コンテナーを <xref:System.Security.Cryptography.DSACryptoServiceProvider.PersistKeyInCsp%2A> オブジェクトに渡すと、次のような処理が行われます。  指定した名前のキー コンテナーが存在しない場合、コンテナーが作成されてキーが保持されます。  指定した名前のキー コンテナーが存在する場合、そのコンテナー内のキーが現在の <xref:System.Security.Cryptography.AsymmetricAlgorithm> オブジェクトに自動的に読み込まれます。  つまり、最初に実行される `GenKey_SaveInContainer` メソッドのコードはこのキーを保持し、2 番目に実行される `GetKeyFromContainer` メソッドのコードはこのキーを読み込みます。  
+  
+```vb  
+Imports System  
+Imports System.IO  
+Imports System.Security.Cryptography  
+ _  
+  
+Public Class StoreKey  
+  
+    Public Shared Sub Main()  
+        Try  
+            ' Create a key and save it in a container.  
+            GenKey_SaveInContainer("MyKeyContainer")  
+  
+            ' Retrieve the key from the container.  
+            GetKeyFromContainer("MyKeyContainer")  
+  
+            ' Delete the key from the container.  
+            DeleteKeyFromContainer("MyKeyContainer")  
+  
+            ' Create a key and save it in a container.  
+            GenKey_SaveInContainer("MyKeyContainer")  
+  
+            ' Delete the key from the container.  
+            DeleteKeyFromContainer("MyKeyContainer")  
+        Catch e As CryptographicException  
+            Console.WriteLine(e.Message)  
+        End Try  
+    End Sub  
+  
+    Public Shared Sub GenKey_SaveInContainer(ByVal ContainerName As String)  
+        ' Create the CspParameters object and set the key container   
+        ' name used to store the RSA key pair.  
+        Dim cp As New CspParameters()  
+        cp.KeyContainerName = ContainerName  
+  
+        ' Create a new instance of RSACryptoServiceProvider that accesses  
+        ' the key container MyKeyContainerName.  
+        Dim rsa As New RSACryptoServiceProvider(cp)  
+  
+        ' Display the key information to the console.  
+        Console.WriteLine("Key added to container:  {0}", rsa.ToXmlString(True))  
+    End Sub  
+  
+    Public Shared Sub GetKeyFromContainer(ByVal ContainerName As String)  
+        ' Create the CspParameters object and set the key container   
+        '  name used to store the RSA key pair.  
+        Dim cp As New CspParameters()  
+        cp.KeyContainerName = ContainerName  
+  
+        ' Create a new instance of RSACryptoServiceProvider that accesses  
+        ' the key container MyKeyContainerName.  
+        Dim rsa As New RSACryptoServiceProvider(cp)  
+  
+        ' Display the key information to the console.  
+        Console.WriteLine("Key retrieved from container : {0}", rsa.ToXmlString(True))  
+    End Sub  
+  
+    Public Shared Sub DeleteKeyFromContainer(ByVal ContainerName As String)  
+        ' Create the CspParameters object and set the key container   
+        '  name used to store the RSA key pair.  
+        Dim cp As New CspParameters()  
+        cp.KeyContainerName = ContainerName  
+  
+        ' Create a new instance of RSACryptoServiceProvider that accesses  
+        ' the key container.  
+        Dim rsa As New RSACryptoServiceProvider(cp)  
+  
+        ' Delete the key entry in the container.  
+        rsa.PersistKeyInCsp = False  
+  
+        ' Call Clear to release resources and delete the key from the container.  
+        rsa.Clear()  
+  
+        Console.WriteLine("Key deleted.")  
+    End Sub  
+End Class  
+  
+```  
+  
+```csharp  
+using System;  
+using System.IO;  
+using System.Security.Cryptography;  
+  
+public class StoreKey  
+  
+{  
+    public static void Main()  
+    {  
+        try  
+        {  
+            // Create a key and save it in a container.  
+            GenKey_SaveInContainer("MyKeyContainer");  
+  
+            // Retrieve the key from the container.  
+            GetKeyFromContainer("MyKeyContainer");  
+  
+            // Delete the key from the container.  
+            DeleteKeyFromContainer("MyKeyContainer");  
+  
+            // Create a key and save it in a container.  
+            GenKey_SaveInContainer("MyKeyContainer");  
+  
+            // Delete the key from the container.  
+            DeleteKeyFromContainer("MyKeyContainer");  
+        }  
+        catch(CryptographicException e)  
+        {  
+            Console.WriteLine(e.Message);  
+        }  
+  
+    }  
+  
+    public static void GenKey_SaveInContainer(string ContainerName)  
+    {  
+        // Create the CspParameters object and set the key container   
+        // name used to store the RSA key pair.  
+        CspParameters cp = new CspParameters();  
+        cp.KeyContainerName = ContainerName;  
+  
+        // Create a new instance of RSACryptoServiceProvider that accesses  
+        // the key container MyKeyContainerName.  
+        RSACryptoServiceProvider rsa = new RSACryptoServiceProvider(cp);  
+  
+        // Display the key information to the console.  
+        Console.WriteLine("Key added to container: \n  {0}", rsa.ToXmlString(true));  
+    }  
+  
+    public static void GetKeyFromContainer(string ContainerName)  
+    {  
+        // Create the CspParameters object and set the key container   
+        // name used to store the RSA key pair.  
+        CspParameters cp = new CspParameters();  
+        cp.KeyContainerName = ContainerName;  
+  
+        // Create a new instance of RSACryptoServiceProvider that accesses  
+        // the key container MyKeyContainerName.  
+        RSACryptoServiceProvider rsa = new RSACryptoServiceProvider(cp);  
+  
+        // Display the key information to the console.  
+        Console.WriteLine("Key retrieved from container : \n {0}", rsa.ToXmlString(true));  
+    }  
+  
+    public static void DeleteKeyFromContainer(string ContainerName)  
+    {  
+        // Create the CspParameters object and set the key container   
+        // name used to store the RSA key pair.  
+        CspParameters cp = new CspParameters();  
+        cp.KeyContainerName = ContainerName;  
+  
+        // Create a new instance of RSACryptoServiceProvider that accesses  
+        // the key container.  
+        RSACryptoServiceProvider rsa = new RSACryptoServiceProvider(cp);  
+  
+        // Delete the key entry in the container.  
+        rsa.PersistKeyInCsp = false;  
+  
+        // Call Clear to release resources and delete the key from the container.  
+        rsa.Clear();  
+  
+        Console.WriteLine("Key deleted.");  
+    }  
+}  
+```  
+  
+```Output  
+  
+            Key added to container:  
+<RSAKeyValue> Key Information A</RSAKeyValue>  
+Key retrieved from container :  
+<RSAKeyValue> Key Information A</RSAKeyValue>  
+Key deleted.  Key added to container:  
+<RSAKeyValue> Key Information B</RSAKeyValue>  
+Key deleted.    
+```  
+  
+## 参照  
+ [暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)   
+ [データの暗号化](../../../docs/standard/security/encrypting-data.md)   
+ [データの復号化](../../../docs/standard/security/decrypting-data.md)   
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/security/how-to-use-data-protection.md b/docs/standard/security/how-to-use-data-protection.md
new file mode 100644
index 00000000000..61cd31bc2d4
--- /dev/null
+++ b/docs/standard/security/how-to-use-data-protection.md
@@ -0,0 +1,77 @@
+---
+title: "方法 : データ保護を使用する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework], データ保護 API"
+  - "データ [.NET Framework], 復号化"
+  - "データ [.NET Framework], 暗号化"
+  - "データ保護 API [.NET Framework]"
+  - "復号化"
+  - "DPAPI"
+  - "暗号化 [.NET Framework], データ保護 API"
+  - "ProtectedData クラス, ProtectedData クラスの概要"
+  - "ProtectedMemory クラス, ProtectedMemory クラスの概要"
+ms.assetid: 606698b0-cb1a-42ca-beeb-0bea34205d20
+caps.latest.revision: 11
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 方法 : データ保護を使用する
+.NET Framework では、データ保護 API \(DPAPI\) へのアクセスを提供しています。DPAPI を使用すると、現在のユーザー アカウントまたはコンピューターからの情報を使用してデータを暗号化できます。  DPAPI を使用すると、暗号化キーを明示的に生成および格納するという困難な問題を軽減できます。  
+  
+ <xref:System.Security.Cryptography.ProtectedMemory> クラスを使用すると、メモリ内のバイト配列を暗号化できます。  この機能は、Microsoft Windows XP 以降のオペレーティング システムで使用できます。  現在のプロセスによって暗号化されるメモリは、現在のプロセスのみ、すべてのプロセス、または同じユーザーのコンテキストによって復号化されることを指定できます。  <xref:System.Security.Cryptography.ProtectedMemory> オプションの詳しい説明については、「<xref:System.Security.Cryptography.MemoryProtectionScope> 列挙型」を参照してください。  
+  
+ バイト配列のコピーを暗号化するには、<xref:System.Security.Cryptography.ProtectedData> クラスを使用します。  この機能は、Microsoft Windows 2000 以降のオペレーティング システムで使用できます。  現在のユーザー アカウントによって暗号化されたデータは、同じユーザー アカウントによってのみ復号化できることを指定できます。あるいは、現在のユーザー アカウントによって暗号化されたデータは、コンピューター上の任意のアカウントによって復号化できることを指定できます。  <xref:System.Security.Cryptography.ProtectedData> オプションの詳しい説明については、「<xref:System.Security.Cryptography.DataProtectionScope> 列挙型」を参照してください。  
+  
+### データの保護を使用してメモリ内のデータを暗号化するには  
+  
+1.  暗号化するバイト配列、エントロピ、およびメモリ保護スコープを渡す際に、静的な <xref:System.Security.Cryptography.ProtectedMemory.Protect%2A> メソッドを呼び出します。  
+  
+### データ保護を使用してメモリ内のデータを復号化するには  
+  
+1.  復号化するバイト配列およびメモリ保護スコープを渡す際に、静的な <xref:System.Security.Cryptography.ProtectedMemory.Unprotect%2A> メソッドを呼び出します。  
+  
+### データ保護を使用してファイルやストリームのデータを暗号化するには  
+  
+1.  ランダム エントロピを作成します。  
+  
+2.  暗号化するバイト配列、エントロピ、およびデータ保護スコープを渡す際に、静的な <xref:System.Security.Cryptography.ProtectedData.Protect%2A> メソッドを呼び出します。  
+  
+3.  ファイルまたはストリームに暗号化されたデータを書き込みます。  
+  
+### データ保護を使用してファイルやストリームからデータを復号化するには  
+  
+1.  ファイルまたはストリームから暗号化されたデータを読み取ります。  
+  
+2.  復号化するバイト配列およびデータ保護スコープを渡す際に、静的な <xref:System.Security.Cryptography.ProtectedData.Unprotect%2A> メソッドを呼び出します。  
+  
+## 使用例  
+ 次のコード例は、暗号化と復号化の 2 つの形式を示しています。  最初に、コード例では、メモリ内のバイト配列を暗号化してから復号化します。  次に、コード例では、バイト配列のコピーを暗号化し、ファイルに保存して、そのファイルからデータを読み込み、その後データを復号化しています。  例では、元のデータ、暗号化されたデータ、および復号化されたデータが表示されます。  
+  
+ [!code-csharp[DPAPI-HowTO#1](../../../samples/snippets/csharp/VS_Snippets_CLR/DPAPI-HowTO/cs/sample.cs#1)]
+ [!code-vb[DPAPI-HowTO#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/DPAPI-HowTO/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   `System.Security.dll` への参照を含めます。  
+  
+-   <xref:System>、<xref:System.IO>、<xref:System.Security.Cryptography>、および <xref:System.Text> 名前空間を含めます。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.ProtectedMemory>   
+ <xref:System.Security.Cryptography.ProtectedData>
\ No newline at end of file
diff --git a/docs/standard/security/how-to-verify-the-digital-signatures-of-xml-documents.md b/docs/standard/security/how-to-verify-the-digital-signatures-of-xml-documents.md
new file mode 100644
index 00000000000..83e88a1a4ac
--- /dev/null
+++ b/docs/standard/security/how-to-verify-the-digital-signatures-of-xml-documents.md
@@ -0,0 +1,95 @@
+---
+title: "方法 : XML ドキュメントのデジタル署名を検証する | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "確認 (署名を)"
+  - "デジタル署名, 検査"
+  - "シグネチャ, 暗号化"
+  - "System.Security.Cryptography.RSACryptoServiceProvider クラス"
+  - "System.Security.Cryptography.SignedXml クラス"
+  - "検査 (署名を)"
+  - "XML デジタル署名"
+ms.assetid: a4d5ceb1-b9f5-47e8-9e4a-a2b39110002f
+caps.latest.revision: 8
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# 方法 : XML ドキュメントのデジタル署名を検証する
+<xref:System.Security.Cryptography.Xml> 名前空間にあるクラスを使用すると、デジタル署名で署名された XML データを検証できます。  XML デジタル署名 \(XMLDSIG\) を使用すると、データが署名後に変更されなかったことを確認できます。  XMLDSIG 標準の詳細については、Wide Web Consortium \(W3C\) 仕様 \(http:\/\/www.w3.org\/TR\/xmldsig\-core\/\) を参照してください。  
+  
+ この手順のコード例では、\<`Signature`\> 要素に格納されている XML デジタル署名の検証方法を示します。  この例では、キー コンテナーから RSA 公開キーを取得してから、キーを使用して署名を確認します。  
+  
+ この手法を使用して検証できるデジタル署名を作成する方法については、「[方法 : デジタル署名で XML ドキュメントに署名する](../../../docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md)」を参照してください。  
+  
+### XML ドキュメントのデジタル署名を検証するには  
+  
+1.  ドキュメントを検証するには、署名に使用した非対称キーと同じ非対称キーを使用する必要があります。  <xref:System.Security.Cryptography.CspParameters> オブジェクトを作成し、署名に使用したキー コンテナーの名前を指定します。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#2](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#2)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#2)]  
+  
+2.  <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスを使用して公開キーを取得します。  <xref:System.Security.Cryptography.CspParameters> オブジェクトを <xref:System.Security.Cryptography.RSACryptoServiceProvider> クラスのコンストラクターに渡すと、キー コンテナーからキーが名前順で自動的に読み込まれます。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#3](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#3)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#3)]  
+  
+3.  ディスクから XML ファイルを読み込んで <xref:System.Xml.XmlDocument> オブジェクトを作成します。  <xref:System.Xml.XmlDocument> オブジェクトには、確認対象の署名済みの XML ドキュメントが含まています。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#4](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#4)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#4)]  
+  
+4.  <xref:System.Security.Cryptography.Xml.SignedXml> オブジェクトを新規作成し、それに <xref:System.Xml.XmlDocument> オブジェクトを渡します。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#5](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#5)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#5)]  
+  
+5.  \<`signature`\> 要素を検索し、<xref:System.Xml.XmlNodeList> オブジェクトを新規作成します。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#6](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#6)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#6)]  
+  
+6.  最初の \<`signature`\> 要素の XML を <xref:System.Security.Cryptography.Xml.SignedXml> オブジェクトに読み込みます。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#7](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#7)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#7)]  
+  
+7.  <xref:System.Security.Cryptography.Xml.SignedXml.CheckSignature%2A> メソッドと RSA の公開キーを使用して署名を確認します。  このメソッドは、成功または失敗を示すブール値を返します。  
+  
+     [!code-csharp[HowToVerifyXMLDocumentRSA#8](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#8)]
+     [!code-vb[HowToVerifyXMLDocumentRSA#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#8)]  
+  
+## 使用例  
+ この例では、`"test.xml"` という名前のファイルがコンパイル済みのプログラムと同じディレクトリに存在することを前提としています。  `"test.xml"` ファイルは、「[方法 : デジタル署名で XML ドキュメントに署名する](../../../docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md)」で説明する手法を使用して署名する必要があります。  
+  
+ [!code-csharp[HowToVerifyXMLDocumentRSA#1](../../../samples/snippets/csharp/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/cs/sample.cs#1)]
+ [!code-vb[HowToVerifyXMLDocumentRSA#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/HowToVerifyXMLDocumentRSA/vb/sample.vb#1)]  
+  
+## コードのコンパイル  
+  
+-   この例をコンパイルするには、`System.Security.dll` への参照を含める必要があります。  
+  
+-   名前空間 <xref:System.Xml>、<xref:System.Security.Cryptography>、および <xref:System.Security.Cryptography.Xml> を含めます。  
+  
+## .NET Framework セキュリティ  
+ 非対称キー ペアの秘密キーをプレーンテキストで保存または転送しないでください。  対称暗号化キーと非対称暗号化キーの詳細については、「[暗号化と復号化のためのキーの生成](../../../docs/standard/security/generating-keys-for-encryption-and-decryption.md)」を参照してください。  
+  
+ 秘密キーをソース コードに直接埋め込まないでください。  埋め込まれたキーは、[Ildasm.exe \(IL 逆アセンブラー\)](../../../docs/framework/tools/ildasm-exe-il-disassembler.md) を使用するか、メモ帳などのテキスト エディターでアセンブリを開くことで簡単に読み取ることができます。  
+  
+## 参照  
+ <xref:System.Security.Cryptography.Xml>   
+ [方法 : デジタル署名で XML ドキュメントに署名する](../../../docs/standard/security/how-to-sign-xml-documents-with-digital-signatures.md)
\ No newline at end of file
diff --git a/docs/standard/security/impersonating-and-reverting.md b/docs/standard/security/impersonating-and-reverting.md
new file mode 100644
index 00000000000..7168b503374
--- /dev/null
+++ b/docs/standard/security/impersonating-and-reverting.md
@@ -0,0 +1,76 @@
+---
+title: "偽装と復帰 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "偽装 (Windows アカウントを)"
+  - "セキュリティ [.NET Framework], 偽装 (Windows アカウントを)"
+  - "WindowsIdentity オブジェクト, 偽装"
+ms.assetid: b93d402c-6c28-4f50-b2bc-d9607dc3e470
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# 偽装と復帰
+場合によっては、Windows NT アカウント トークンを取得して、Windows アカウントを偽装する必要があります。 たとえば、ASP.NET ベースのアプリケーションが、時間によって複数のユーザーの代わりに操作しなければならない場合があります。 その場合、アプリケーションはインターネット インフォメーション サービス \(IIS\) から管理者を表すトークンを受け入れて、そのユーザーを偽装し、操作を実行してから前の ID に戻ります。 続いて、IIS から管理者より権限が少ないユーザーを表すトークンを受け入れ、操作を実行してから、また元に戻ります。  
+  
+ アプリケーションが、IIS によって現在のスレッドにアタッチされていない Windows アカウントを偽装しなければならない場合は、そのアカウントのトークンを取得し、そのトークンを使用してアカウントをアクティブ化する必要があります。 それには、次のタスクを実行します。  
+  
+1.  アンマネージ **LogonUser** メソッドを呼び出すことによって、特定のユーザーのアカウント トークンを取得します。 このメソッドは、.NET Framework の基底クラス ライブラリには含まれていませんが、アンマネージ **advapi32.dll** 内にあります。 アンマネージ コード内のメソッドへのアクセスは高度な操作であり、ここでは説明しません。 詳細については、「[アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)」を参照してください。**LogonUser** メソッドと **advapi32.dll** の詳細については、プラットフォーム SDK ドキュメントを参照してください。  
+  
+2.  **WindowsIdentity** クラスの新しいインスタンスを作成し、トークンを渡します。 次のコードに、この呼び出しを示します。ここで、`hToken` は Windows トークンを表します。  
+  
+    ```csharp  
+    WindowsIdentity ImpersonatedIdentity = new WindowsIdentity(hToken);  
+  
+    ```  
+  
+    ```vb  
+    Dim ImpersonatedIdentity As New WindowsIdentity(hToken)  
+    ```  
+  
+3.  このコードに示されているように、<xref:System.Security.Principal.WindowsImpersonationContext> クラスの新しいインスタンスを作成し、そのインスタンスを、初期化されたクラスの <xref:System.Security.Principal.WindowsIdentity.Impersonate%2A?displayProperty=fullName> メソッドで初期化することで、偽装を開始します。  
+  
+    ```csharp  
+    WindowsImpersonationContext MyImpersonation = ImpersonatedIdentity.Impersonate();  
+  
+    ```  
+  
+    ```vb  
+    WindowsImpersonationContext MyImpersonation = ImpersonatedIdentity.Impersonate()  
+    ```  
+  
+4.  偽装する必要がなくなったら、以下のコードに示されているように <xref:System.Security.Principal.WindowsImpersonationContext.Undo%2A?displayProperty=fullName> メソッドを呼び出して、偽装を元に戻します。  
+  
+    ```csharp  
+    MyImpersonation.Undo();  
+  
+    ```  
+  
+    ```vb  
+    MyImpersonation.Undo()  
+    ```  
+  
+ 信頼されるコードが既に <xref:System.Security.Principal.WindowsPrincipal> オブジェクトをスレッドにアタッチしている場合は、アカウント トークンを取らないインスタンス メソッド **Impersonate** を呼び出すことができます。 この方法が役立つのは、スレッドで **WindowsPrincipal** オブジェクトが表しているユーザーが、現在プロセスが実行されているユーザーではない場合のみです。 このような状態は、たとえば、Windows 認証を有効にして、偽装を無効にした ASP.NET を使用している場合に発生することがあります。 その場合、プロセスはインターネット インフォメーション サービス \(IIS\) で構成されたアカウントで実行されますが、現在のプリンシパルは、ページにアクセスしている Windows ユーザーを表しています。  
+  
+ **Impersonate** と **Undo** のいずれも、現在の呼び出しコンテキストに関連する **Principal** オブジェクト \(<xref:System.Security.Principal.IPrincipal>\) を変更しないことに注意してください。 偽装と元に戻す操作によって変更されるのは、現在のオペレーティング システム プロセスに関連付けたトークンです。  
+  
+## 参照  
+ <xref:System.Security.Principal.WindowsIdentity>   
+ <xref:System.Security.Principal.WindowsImpersonationContext>   
+ [プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)   
+ [アンマネージ コードとの相互運用](../../../docs/framework/interop/index.md)
\ No newline at end of file
diff --git a/docs/standard/security/index.md b/docs/standard/security/index.md
new file mode 100644
index 00000000000..533d5592240
--- /dev/null
+++ b/docs/standard/security/index.md
@@ -0,0 +1,56 @@
+---
+title: ".NET Framework におけるセキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - ".NET Framework, セキュリティ"
+  - "アプリケーション開発 [.NET Framework], セキュリティ"
+  - "セキュリティ [.NET Framework]"
+  - "セキュリティ [.NET Framework], セキュリティの概要"
+ms.assetid: 9a9621d7-8883-4a4f-a874-65e8e09e20a6
+caps.latest.revision: 37
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 37
+---
+# .NET Framework におけるセキュリティ
+共通言語ランタイムと .NET Framework には、開発者が安全なコードを簡単に作成したり、システム管理者が保護されたリソースへのアクセスを可能にするコードに付与されたアクセス許可をカスタマイズしたりできるようにするための便利なクラスとサービスが多数用意されています。 さらに、ランタイムおよび .NET Framework には、暗号とロール ベース セキュリティを簡単に利用できるようにする有用なクラスとサービスも用意されています。  
+  
+## このセクションの内容  
+ [セキュリティの変更点](../../../docs/framework/security/security-changes.md)  
+ .NET Framework セキュリティ システムの重要な変更について説明します。  
+  
+ [セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)  
+ 共通言語ランタイムのセキュリティ機能の概要を説明します。 このセクションは開発者およびシステム管理者を対象としています。  
+  
+ [ロール ベース セキュリティ](../../../docs/standard/security/role-based-security.md)  
+ コード内でロール ベースのセキュリティと対話する方法について説明します。 このセクションは開発者を対象としています。  
+  
+ [暗号モデル](../../../docs/standard/security/cryptography-model.md)  
+ .NET Framework によって提供される暗号サービスの概要を説明します。 このセクションは開発者を対象としています。  
+  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)  
+ 信頼できる .NET Framework アプリケーションを作成するときの最適な実施方法について説明します。 このセクションは開発者を対象としています。  
+  
+ [アンマネージ コードの安全なコーディングのガイドライン](../../../docs/framework/security/secure-coding-guidelines-for-unmanaged-code.md)  
+ アンマネージ コードを呼び出す際のベスト プラクティスとセキュリティに関する注意事項について、いくつか説明します。  
+  
+ [Windows Identity Foundation](../../../docs/framework/security/windows-identity-foundation.md)  
+ アプリケーションでクレーム ベースの ID を実装する方法について説明します。  
+  
+## 関連項目  
+ [開発ガイド](../../../docs/framework/development-guide.md)  
+ アプリケーションの作成、構成、デバッグ、セキュリティ、配置、および動的プログラミング、相互運用性、拡張性、メモリ管理、スレッド処理に関する情報を含む、アプリケーション開発用の主要な技術領域とタスクのすべてについての手引書です。
\ No newline at end of file
diff --git a/docs/standard/security/key-security-concepts.md b/docs/standard/security/key-security-concepts.md
new file mode 100644
index 00000000000..5fde8691d54
--- /dev/null
+++ b/docs/standard/security/key-security-concepts.md
@@ -0,0 +1,122 @@
+---
+title: "セキュリティの基本概念 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "アクセス許可 [.NET Framework]"
+  - "セキュリティ [.NET Framework], セキュリティの概要"
+  - "不正侵入"
+ms.assetid: 3cfced4f-ea02-4e66-ae98-d69286363e98
+caps.latest.revision: 22
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 20
+---
+# セキュリティの基本概念
+Microsoft .NET Framework では、セキュリティ透過、コード アクセス セキュリティ、およびロールベース セキュリティを使用できます。これらのセキュリティ機構は、モバイル コードに関するセキュリティ上の処理に役立ち、各ユーザーにどのような権限を与えるかをコンポーネントで決定できるようにします。  これらのセキュリティ機構は単純で一貫性のあるモデルを使用するため、コード アクセス セキュリティの知識がある開発者は、ロール ベース セキュリティを簡単に使用できます。また、ロール ベース セキュリティの知識がある開発者も、コード アクセス セキュリティを簡単に使用できます。  コード アクセス セキュリティとロール ベース セキュリティのいずれも、共通言語ランタイムによって提供される共通のインフラストラクチャを使用して実装されます。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、セキュリティ透過が既定の適用機構になっています。  セキュリティ透過によって、アプリケーションの一部として実行されるコードがインフラストラクチャの一部として実行されるコードから分離されます。  詳しくは、「[透過的セキュリティ コード](../../../docs/framework/misc/security-transparent-code.md)」をご覧ください。  
+  
+ コード アクセス セキュリティとロール ベース セキュリティは、同じモデルとインフラストラクチャを使用するため、基になる概念のいくつかが共通します。ここでは、これらの概念について説明します。  .NET Framework のコード アクセス セキュリティとロール ベース セキュリティの説明を読む前に、これらの共通概念について理解しておいてください。  
+  
+## セキュリティ アクセス許可  
+ 共通言語ランタイムを使用すると、コードが実行できる操作を、実行するためのアクセス許可をそのコードが持つ操作だけに限定できます。  ランタイムはアクセス許可と呼ばれるオブジェクトを使用して、マネージ コードに制限を課します。  ランタイムは、いくつかの名前空間の中に組み込みアクセス許可クラスを備えているほか、カスタムのアクセス許可クラスのデザインおよび実装をサポートします。  
+  
+ アクセス許可には次の 2 種類があり、それぞれ固有の目的があります。  
+  
+-   コード アクセス許可は、保護されているリソースに対するアクセス権や、保護されている操作を実行する権限を表します。  
+  
+-   ロール ベースのセキュリティ権限により、ユーザー \(またはユーザーのために行動するエージェント\) が特定の ID を持っているかどうか、または特定のロールに所属しているかどうかを検出するメカニズムが実現されます。  <xref:System.Security.Permissions.PrincipalPermission> が、唯一のロール ベース セキュリティ アクセス許可です。  
+  
+ セキュリティ アクセス許可は、アクセス許可クラス \(強制セキュリティ\) の形式か、アクセス許可クラスを表す属性 \(宣言セキュリティ\) の形式にできます。  セキュリティ アクセス許可の基本クラスは <xref:System.Security.CodeAccessPermission?displayProperty=fullName> で、セキュリティ アクセス許可属性の基本クラスは <xref:System.Security.Permissions.CodeAccessSecurityAttribute?displayProperty=fullName> です。  
+  
+ アセンブリの形式のアプリケーションには、アプリケーション ドメインに読み込まれるときに一連のアクセス許可が付与されます。  この付与は、通常、<xref:System.Security.SecurityManager.GetStandardSandbox%2A?displayProperty=fullName> メソッドによって決定される定義済みのアクセス許可セットを使用して行われます。  許可セットにより、コードが利用できるアクセス許可が決まります。  ランタイムは、コードの生成場所 \(ローカル コンピューター、ローカル イントラネット、インターネットなど\) に基づいてアクセス許可を与えます。  コードがサンドボックスに読み込まれる場合は、コードに特別なアクセス許可を付与することもできます。  サンドボックスにおけるコードの実行について詳しくは、「[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)」をご覧ください。  
+  
+ アクセス許可の主な用途は次のとおりです。  
+  
+-   ライブラリ コードは、呼び出し元が特定のアクセス許可を持つことを確認要求できます。  コードにアクセス許可に対する <xref:System.Security.CodeAccessPermission.Demand%2A> を配置すると、そのコードを使用するすべてのコードは、実行するときにそのアクセス許可が必要になります。  確認要求は、呼び出し元が特定のリソースへのアクセス権を有するかどうかを判断したり、呼び出し元の身元を調査したりするために使用できます。  
+  
+-   コードでは、アクセス許可を使用して、保護するリソースへのアクセスを拒否できます。  <xref:System.Security.Permissions.SecurityAction?displayProperty=fullName> を使用すると、制限されたアクセス許可セットを指定して、他のすべてのアクセス許可を暗黙的に拒否できます。  ただし、意図的な悪用を防ぐ目的で <xref:System.Security.Permissions.SecurityAction> を使用してアクセスを禁止することはお勧めしません。  暗黙的に拒否されたアクセス許可を許可セット内に有する呼び出されたアセンブリは、使用するアクセス許可に対して <xref:System.Security.Permissions.SecurityAction?displayProperty=fullName> を実行することにより、拒否されたアクセス許可をオーバーライドできます。  たとえば、<xref:System.Security.Permissions.UIPermission> のみを許可し、本来 <xref:System.Security.Permissions.FileIOPermission> を持つアセンブリを呼び出した場合、アセンブリは <xref:System.Security.Permissions.FileIOPermission> に対して <xref:System.Security.Permissions.SecurityAction> を実行するだけで、ファイル操作を実行できるようになります。  参照されたアセンブリ内の信頼できないコードからリソースを安全に保護する唯一の方法は、そのコードを、それらのアクセス許可を含まない許可セットにより実行することです。  
+  
+### コード アクセス許可  
+ コード アクセス許可は、リソースと操作が権限なしに使用されないように保護するアクセス許可オブジェクトです。  コード アクセス許可は、マネージ コードにセキュリティ制限を適用するための共通言語ランタイムの機構の基本的な部分です。  
+  
+ 各コード アクセス許可は、次の権限のいずれかを表します。  
+  
+-   ファイルや環境変数など、保護されたリソースにアクセスする権限。  
+  
+-   アンマネージ コードへのアクセスなど、保護された操作を実行するための権限。  
+  
+ すべてのコード アクセス許可は、コードで要求または確認要求できます。コードに与えられる許可の種類は、ランタイムが決定します。  
+  
+ 各コード アクセス許可は、<xref:System.Security.CodeAccessPermission> クラスから派生します。つまり、すべてのコード アクセス許可には、**Demand**、**Assert**、**Deny**、**PermitOnly**、**IsSubsetOf**、**Intersect**、および **Union** などの共通のメソッドがあります。  
+  
+> [!IMPORTANT]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、<xref:System.Security.Permissions.SecurityAction>、<xref:System.Security.Permissions.SecurityAction>、<xref:System.Security.Permissions.SecurityAction>、<xref:System.Security.Permissions.SecurityAction> の各アクセス許可要求を適用するためのランタイム サポートは削除されています。  これらの要求は、[!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降に基づくコードで使用しないでください。  この点と他の変更内容について詳しくは、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」をご覧ください。  
+  
+### ロール ベース セキュリティ アクセス許可  
+ <xref:System.Security.Permissions.PrincipalPermission> はロール ベース セキュリティ アクセス許可で、ユーザーが指定の ID を持っているかどうか、特定のロールのメンバーかどうかを判別するのに使用できます。  **PrincipalPermission** は、.NET Framework クラス ライブラリに用意されている唯一のロール ベース セキュリティ アクセス許可です。  
+  
+## タイプ セーフとセキュリティ  
+ タイプ セーフなコードは、アクセス権限を与えられているメモリ位置にだけアクセスします。  この場合のタイプ セーフとは、メモリのタイプ セーフの意味です。広い意味でのタイプ セーフと混同しないでください。 たとえば、タイプ セーフなコードは、他のオブジェクトのプライベート フィールドから値を読み取ることができません。  適切に定義された許容される方法でだけ、タイプにアクセスします。  
+  
+ ジャスト イン タイム \(JIT: Just\-In\-Time\) コンパイル時に、オプションの検査プロセスは、ネイティブなマシン コードに JIT コンパイルされるメソッドのメタデータと Microsoft Intermediate Language \(MSIL\) を調べて、タイプ セーフかどうかを確認します。  コードに検査を省略するためのアクセス許可がある場合、このプロセスは省略されます。  検査の詳細については、「[マネージ実行プロセス](../../../docs/standard/managed-execution-process.md)」を参照してください。  
+  
+ タイプ セーフの検査はマネージ コードの実行に必須ではありませんが、アセンブリの分離とセキュリティの適用において、タイプ セーフであることが重要な意味を持ちます。  コードがタイプ セーフであると、共通言語ランタイムはアセンブリを互いに完全に分離できます。  アセンブリが互いに分離していると、アセンブリどうしが悪い影響を及ぼしあうことがなく、アプリケーションの信頼性が向上します。  タイプ セーフなコンポーネントは、信頼されるレベルが異なっていても、同じプロセスで安全に実行できます。  コードがタイプ セーフでないと、望ましくない副作用が生じることがあります。  たとえば、ランタイムは、マネージ コードがネイティブ \(アンマネージ\) コードにアクセスしたり、不正な操作を実行することを防止できません。  コードがタイプ セーフであると、ランタイムのセキュリティ適用機構によって、必要なアクセス許可を持たないコードがネイティブ コードにアクセスすることはできません。  タイプ セーフでないすべてのコードは、列挙子メンバー <xref:System.Security.Permissions.SecurityPermission> が渡された <xref:System.Security.Permissions.SecurityPermissionAttribute.SkipVerification%2A> を与えられていないと実行できません。  
+  
+ 詳細については、「[NIB: Writing Verifiably Type\-Safe Code](http://msdn.microsoft.com/ja-jp/d18f10ef-3b48-4f47-8726-96714021547b)」をご覧ください。  
+  
+## プリンシパル  
+ プリンシパルは、ユーザーの ID とロールを表し、ユーザーの代わりを務めます。  .NET Framework のロール ベース セキュリティでは、次の 3 種類のプリンシパルがサポートされています。  
+  
+-   汎用プリンシパルは、Windows のユーザーとロールとは無関係に存在するユーザーとロールを表します。  
+  
+-   Windows プリンシパルは、Windows のユーザーとそのロール \(または Windows グループ\) を表します。  Windows プリンシパルは、他のユーザーを偽装できます。つまり、Windows プリンシパルは、あるユーザーに属する ID を提示し、そのユーザーの代わりにリソースにアクセスできます。  
+  
+-   カスタム プリンシパルは、アプリケーションが必要に応じて自由に定義できます。  カスタム プリンシパルによって、プリンシパルの ID とロールの基本概念を拡張できます。  
+  
+ 詳しくは、「[プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)」をご覧ください。  
+  
+## 認証  
+ 認証とは、ユーザーの資格情報を調べ、資格情報をなんらかの権限に対して検証することによって、プリンシパルの身元 を発見および確認するプロセスです。  認証時に得られる情報は、コードで直接使用できます。  また、.NET Framework のロール ベース セキュリティを使用して、現在のユーザーを認証したり、そのプリンシパルにコードへのアクセスを許可するかどうかを判断したりできます。  特定のロールに関してプリンシパルを認証する方法の例については、<xref:System.Security.Principal.WindowsPrincipal.IsInRole%2A?displayProperty=fullName> メソッドのオーバーロードを参照してください。  たとえば、<xref:System.Security.Principal.WindowsPrincipal.IsInRole%28System.String%29?displayProperty=fullName> オーバーロードを使用すると、現在のユーザーが Administrators グループのメンバーであるかどうかを判断できます。  
+  
+ さまざまな認証メカニズムが現在使用されていて、その多くを .NET Framework のロール ベース セキュリティと一緒に使用できます。  最も一般に使用されている認証機構としては、基本認証、ダイジェスト認証、パスポート認証、オペレーティング システム認証 \(NTLM 認証や Kerberos 認証など\)、およびアプリケーション定義の認証機構などがあります。  
+  
+### 例  
+ 以下の例では、アクティブ プリンシパルが管理者である必要があります。  `name` パラメーターは `null` で、これにより、管理者ユーザーがこの確認要求を渡すことを許可されます。  
+  
+> [!NOTE]
+>  Windows Vista では、ユーザー アカウント制御 \(UAC: User Account Control\) でユーザーの権限が決定されます。  ユーザーが組み込みの Administrators グループのメンバーである場合、そのユーザーには標準ユーザー アクセス トークンおよび管理者アクセス トークンの 2 つのランタイム アクセス トークンが割り当てられています。  既定では、ユーザーは標準ユーザー ロールに所属します。  管理者であることを要求するコードを実行するには、最初に、ユーザーの権限を標準ユーザーから管理者に昇格させる必要があります。  この操作は、アプリケーションの起動時にアプリケーション アイコンを右クリックし、管理者として実行することを指定して行うことができます。  
+  
+ [!code-cpp[Classic PrincipalPermission Example#1](../../../samples/snippets/cpp/VS_Snippets_CLR_Classic/classic PrincipalPermission Example/CPP/source.cpp#1)]
+ [!code-csharp[Classic PrincipalPermission Example#1](../../../samples/snippets/csharp/VS_Snippets_CLR_Classic/classic PrincipalPermission Example/CS/source.cs#1)]
+ [!code-vb[Classic PrincipalPermission Example#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_Classic/classic PrincipalPermission Example/VB/source.vb#1)]  
+  
+ 次の例は、プリンシパルの ID と、プリンシパルで使用できるロールを判別する方法を示しています。  この例のアプリケーションは、現在のユーザーがアプリケーションの使用を許可するロールに含まれていることを確認できます。  
+  
+ [!code-cpp[System.Security.Principal.WindowsBuiltInRole Example#1](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Security.Principal.WindowsBuiltInRole Example/CPP/source.cpp#1)]
+ [!code-csharp[System.Security.Principal.WindowsBuiltInRole Example#1](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Security.Principal.WindowsBuiltInRole Example/CS/source.cs#1)]
+ [!code-vb[System.Security.Principal.WindowsBuiltInRole Example#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Security.Principal.WindowsBuiltInRole Example/VB/source.vb#1)]  
+  
+## 承認  
+ 承認とは、要求されたアクションの実行をプリンシパルに許可するかどうかを判断するプロセスです。  承認は認証の後に行われ、プリンシパルの ID とロールについての情報を使用して、そのプリンシパルがアクセスできるリソースを判断します。  承認は、.NET Framework のロール ベース セキュリティを使用して実装できます。  
+  
+## Internal Virtual キーワードのセキュリティ関連事項  
+ アプリケーションのセキュリティは、C\# の [internal](../Topic/internal%20\(C%23%20Reference\).md) [virtual](../Topic/virtual%20\(C%23%20Reference\).md) 修飾子 \(Visual Basic の [Overloads](../Topic/Overloads%20\(Visual%20Basic\).md) [Overridable](../Topic/Overridable%20\(Visual%20Basic\).md) [Friend](../Topic/Friend%20\(Visual%20Basic\).md) 修飾子\) でマークされているメンバーに基づいて構築しないでください。  これらの修飾子でマークされたメンバーは、現在のアセンブリ内の他のメンバーによってのみオーバーライドされますが、この規則は C\# 言語と Visual Basic 言語だけによって強制されています。  ランタイムはこの規則を強制しません。  このため、Microsoft Intermediate Language \(MSIL\) やこの規則を強制しない言語を使用すると、C\# で **internal virtual** としてマークされたメンバーおよび Visual Basic で **Overloads Overridable Friend** としてマークされたメンバーがオーバーライドされる可能性があります。  
+  
+## 参照  
+ [セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)
\ No newline at end of file
diff --git a/docs/standard/security/principal-and-identity-objects.md b/docs/standard/security/principal-and-identity-objects.md
new file mode 100644
index 00000000000..e698b86612d
--- /dev/null
+++ b/docs/standard/security/principal-and-identity-objects.md
@@ -0,0 +1,60 @@
+---
+title: "プリンシパル オブジェクトと ID オブジェクト | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "GenericIdentity オブジェクト"
+  - "GenericPrincipal オブジェクト"
+  - "ID オブジェクト, ID オブジェクトの概要"
+  - "プリンシパル オブジェクト, プリンシパル オブジェクトの概要"
+  - "セキュリティ [.NET Framework], ID オブジェクト"
+  - "セキュリティ [.NET Framework], プリンシパル"
+  - "WindowsIdentity オブジェクト"
+  - "WindowsPrincipal オブジェクト"
+ms.assetid: aa5930ad-f3d7-40aa-b6f6-c6edcd5c64f7
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# プリンシパル オブジェクトと ID オブジェクト
+マネージ コードは、[Identity](frlrfSystemSecurityPrincipalIIdentityClassTopic) オブジェクトへの参照が含まれる [Principal](frlrfSystemSecurityPrincipalIPrincipalClassTopic) オブジェクトを通じて、プリンシパルの ID またはロールを検出できます。  ID オブジェクトとプリンシパル オブジェクトは、ユーザー アカウントとグループ アカウントなど、よく知られた概念にたとえることができます。  ほとんどのネットワーク環境では、ユーザー アカウントは人またはプログラムを表し、グループ アカウントはユーザーの特定のカテゴリとユーザーの所有する権限を表します。  これと同様に、.NET Framework の ID オブジェクトはユーザーを表し、ロールはメンバーシップとセキュリティ コンテキストを表します。  .NET Framework のプリンシパル オブジェクトは、ID オブジェクトとロールの両方をカプセル化します。.NET Framework アプリケーションは、ID に基づいて、またはより一般的にはロール メンバーシップに基づいて、プリンシパルに権限を与えます。  
+  
+## ID オブジェクト  
+ ID オブジェクトは、検証するユーザーまたはエンティティについての情報をカプセル化します。  ID オブジェクトには、その最も基本的なレベルに名前と認証の種類が含まれます。  名前は、ユーザー名または Windows アカウント名です。認証の種類は、サポートされるログオン プロトコル \(Kerberos V5 など\) またはカスタム値です。  .NET Framework は、カスタムのログオン手順のほとんどで使用できる <xref:System.Security.Principal.GenericIdentity> オブジェクトと、アプリケーションで Windows 認証を利用するときに使用できる、より特化した <xref:System.Security.Principal.WindowsIdentity> オブジェクトを定義します。  また、カスタム ユーザー情報をカプセル化する独自の ID クラスを定義できます。  
+  
+ <xref:System.Security.Principal.IIdentity> インターフェイスは、名前と認証の種類 \(Kerberos V5 や NTLM など\) にアクセスするためのプロパティを定義します。  すべての **Identity** クラスは、**IIdentity** インターフェイスを実装します。  **Identity** オブジェクトと、スレッドが現在実行されている Windows NT プロセス トークンとの間に必要とされる関係はありません。  ただし、**Identity** オブジェクトが **WindowsIdentity** オブジェクトである場合は、ID が Windows NT セキュリティ トークンを表すものと想定されます。  
+  
+## プリンシパル オブジェクト  
+ プリンシパル オブジェクトは、コードが実行されているセキュリティ コンテキストを表します。  ロール ベース セキュリティを実装するアプリケーションは、プリンシパル オブジェクトに関連付けられたロールに基づいて権限を与えます。  ID オブジェクトと同様に、.NET Framework には <xref:System.Security.Principal.GenericPrincipal> オブジェクトと <xref:System.Security.Principal.WindowsPrincipal> オブジェクトが用意されています。  独自のカスタム プリンシパル クラスを定義することもできます。  
+  
+ <xref:System.Security.Principal.IPrincipal> インターフェイスは、関連付けられた **Identity** オブジェクトにアクセスするためのプロパティと、**Principal** オブジェクトによって識別されるユーザーが特定のロールのメンバーかどうかを調べるためのメソッドを定義します。  すべての **Principal** クラスは、**IPrincipal** インターフェイス、およびその他の必要なプロパティとメソッドを実装します。  たとえば、共通言語ランタイムには **WindowsPrincipal** クラスが用意されています。このクラスは、Windows NT グループ メンバーシップまたは Windows 2000 グループ メンバーシップをロールに割り当てるための追加機能を実装します。  
+  
+ **Principal** オブジェクトは、アプリケーション ドメイン \(<xref:System.AppDomain>\) 内の呼び出しコンテキスト \(<xref:System.Runtime.Remoting.Messaging.CallContext>\) オブジェクトにバインドされています。  新しい **AppDomain** ごとに既定の呼び出しコンテキストが作成されるため、**Principal** オブジェクトを承認するために使用できる呼び出しコンテキストが必ず存在します。  新しいスレッドが作成されると、そのスレッドに対して **CallContext** オブジェクトも作成されます。  **Principal** オブジェクトの参照は、作成元スレッドから新しいスレッドの **CallContext** に自動的にコピーされます。  スレッドの作成元に属す **Principal** オブジェクトを特定できない場合、ランタイムは **Principal** オブジェクトと **Identity** オブジェクトを作成するための既定のポリシーに従います。  
+  
+ アプリケーション ドメインに固有の設定可能なポリシーは、新しいアプリケーション ドメインに関連付ける **Principal** オブジェクトの種類を決定するための規則を定義します。  セキュリティ ポリシーによって許可される場合、ランタイムは、現在の実行スレッドに関連付けられたオペレーティング システム トークンを反映する **Principal** オブジェクトと **Identity** オブジェクトを作成できます。  ランタイムは、既定では、認証されていないユーザーを表す **Principal** オブジェクトと **Identity** オブジェクトを使用します。  ランタイムは、既定の **Principal** オブジェクトと **Identity** オブジェクトを、これらのオブジェクトにコードがアクセスを試みるまで作成しません。  
+  
+ アプリケーション ドメインを作成する信頼されるコードは、既定の **Principal** オブジェクトと **Identity** オブジェクトの構築を制御するアプリケーション ドメイン ポリシーを設定できます。  アプリケーション ドメイン固有のポリシーは、そのアプリケーション ドメイン内のすべての実行スレッドに適用されます。  アンマネージの信頼される側のホストには、本来このポリシーを設定する能力がありますが、このポリシーを設定するマネージ コードは、ドメイン ポリシーを制御するための <xref:System.Security.Permissions.SecurityPermission?displayProperty=fullName> を持っている必要があります。  
+  
+ 同じプロセス内 \(つまり同じコンピューター上\) の他のアプリケーション ドメインに **Principal** オブジェクトを転送する場合、リモート処理インフラストラクチャは、呼び出し元のコンテキストに関連付けられた **Principal** オブジェクトへの参照を、呼び出される側のコンテキストにコピーします。  
+  
+## 参照  
+ [方法 : WindowsPrincipal プロジェクトを作成する](../../../docs/standard/security/how-to-create-a-windowsprincipal-object.md)   
+ [方法 : GenericPrincipal オブジェクトと GenericIdentity オブジェクトを作成する](../../../docs/standard/security/how-to-create-genericprincipal-and-genericidentity-objects.md)   
+ [プリンシパル オブジェクトの置き換え](../../../docs/standard/security/replacing-a-principal-object.md)   
+ [偽装と復帰](../../../docs/standard/security/impersonating-and-reverting.md)   
+ [ロール ベース セキュリティ](../../../docs/standard/security/role-based-security.md)   
+ [セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)
\ No newline at end of file
diff --git a/docs/standard/security/replacing-a-principal-object.md b/docs/standard/security/replacing-a-principal-object.md
new file mode 100644
index 00000000000..9ba253d46fa
--- /dev/null
+++ b/docs/standard/security/replacing-a-principal-object.md
@@ -0,0 +1,45 @@
+---
+title: "プリンシパル オブジェクトの置き換え | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "プリンシパル オブジェクト, 置換"
+  - "セキュリティ [.NET Framework], プリンシパル"
+  - "セキュリティ [.NET Framework], 置き換え (プリンシパル オブジェクトを)"
+ms.assetid: c323687e-b196-487b-beba-f38f9b3f961b
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# プリンシパル オブジェクトの置き換え
+認証サービスを提供するアプリケーションでは、特定のスレッドの**プリンシパル** オブジェクト \(<xref:System.Security.Principal.IPrincipal>\) を置換する必要があります。 さらに、虚偽の ID やロールを要求することにより、悪意をもってアタッチされた不適切な**プリンシパル**がアプリケーションのセキュリティに問題を生じさせるため、セキュリティ システムを活用して**プリンシパル** オブジェクトを置き換える機能を保護する必要があります。 そのため、**プリンシパル** オブジェクトを置き換える機能を必要とするアプリケーションに、プリンシパルを制御するための <xref:System.Security.Permissions.SecurityPermission?displayProperty=fullName> オブジェクトを付与する必要があります。 \(ロール ベースのセキュリティ チェックを実行する、または**プリンシパル** オブジェクトを作成するために、このアクセス許可は必要がないことに注意してください。\)  
+  
+ 次のタスクを実行することによって、現在の**プリンシパル** オブジェクトを置き換えることができます。  
+  
+1.  置き換える**プリンシパル** オブジェクトと関連付けられている **ID** オブジェクトを作成します。  
+  
+2.  新しい**プリンシパル** オブジェクトを呼び出しコンテキストにアタッチします。  
+  
+## 例  
+ 次の例では、汎用プリンシパル オブジェクトを作成し、それを使用してスレッドのプリンシパルを設定する方法を示します。  
+  
+ [!code-csharp[SetCurrentPrincipal#1](../../../samples/snippets/csharp/VS_Snippets_CLR/SetCurrentPrincipal/CS/program.cs#1)]
+ [!code-vb[SetCurrentPrincipal#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/SetCurrentPrincipal/VB/program.vb#1)]  
+  
+## 参照  
+ <xref:System.Security.Permissions.SecurityPermission?displayProperty=fullName>   
+ [プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)
\ No newline at end of file
diff --git a/docs/standard/security/role-based-security.md b/docs/standard/security/role-based-security.md
new file mode 100644
index 00000000000..eba06bf3588
--- /dev/null
+++ b/docs/standard/security/role-based-security.md
@@ -0,0 +1,51 @@
+---
+title: "ロール ベース セキュリティ | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "認証 [.NET Framework], プリンシパル"
+  - "アクセス許可 [.NET Framework], プリンシパル"
+  - "プリンシパル [.NET Framework]"
+  - "ロールベースのセキュリティ, ロール ベース セキュリティの概要"
+  - "ロールベースのセキュリティ, プリンシパル"
+  - "セキュリティ [.NET Framework], ロール ベース"
+  - "ユーザー認証, プリンシパル"
+ms.assetid: 578cc32b-5654-4d8b-9d8c-ebcbc5c75390
+caps.latest.revision: 13
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# ロール ベース セキュリティ
+財務アプリケーションや業務アプリケーションでは、ポリシーを適用するためにロールが使用されることがよくあります。  たとえば、要求を出しているユーザーが指定のロールのメンバーかどうかに基づいて、処理するトランザクションのサイズにアプリケーションが制限を課すことがあります。  たとえば、事務員には指定のしきい値よりも小さいトランザクションを処理する権限が与えられ、スーパーバイザにはより高いしきい値が与えられ、その上司にはさらに高いしきい値が与えられる \(または制限がまったくない\)、という場合です。  アプリケーションで 1 つのアクションを完了するために複数の承認を必要とするときにも、ロール ベース セキュリティを使用できます。  たとえば、どの社員も購買の要求を生成できるものの、その要求を仕入先に送信できる購買発注に変換できるのは購買部門だけにする場合などが考えられます。  
+  
+ .NET Framework のロール ベース セキュリティでは、関連付けられた ID で構築されるプリンシパルについての情報を現在のスレッドで使用できるようにすることによって、承認をサポートします。  この場合の ID \(および ID を利用して定義されるプリンシパル\) は、Windows アカウントに基づく ID か、または Windows アカウントとは無関係のカスタム ID です。  .NET Framework アプリケーションは、プリンシパルの ID、ロール メンバーシップ、またはその両方に基づいて、承認の決定を行うことができます。  ロールとは、セキュリティに関して同じ特権を持つプリンシパルの名前付きセット \(窓口係や責任者など\) です。  プリンシパルは、1 つ以上のロールのメンバーであることができます。  このため、アプリケーションはロール メンバーシップを使用して、要求されたアクションを実行する権限がプリンシパルにあるかどうかを決定できます。  
+  
+ 使いやすさ、およびコード アクセス セキュリティとの一貫性を実現するため、.NET Framework のロール ベース セキュリティには <xref:System.Security.Permissions.PrincipalPermission?displayProperty=fullName> オブジェクトが用意されています。共通言語ランタイムは、このオブジェクトを使用することによって、コード アクセス セキュリティ チェックに似た方法で承認を実行できます。  <xref:System.Security.Permissions.PrincipalPermission> クラスは、プリンシパルが一致している必要のある ID またはロールを表し、宣言セキュリティ チェックと強制セキュリティ チェックの両方と互換性があります。  プリンシパルの ID 情報に直接アクセスし、必要なときに、コード内でロール チェックと ID チェックを実行することもできます。  
+  
+ .NET Framework のロール ベース セキュリティには、幅広いアプリケーションのニーズを満たせるだけの柔軟性と拡張性があります。  COM\+ 1.0 Services などの既存の認証インフラストラクチャと相互運用する方法と、カスタムの認証システムを作成する方法のどちらかを選択できます。  ロール ベース セキュリティは、主にサーバー上で処理される ASP.NET Web アプリケーションでの使用に適しています。  とはいえ、.NET Framework のロール ベース セキュリティは、クライアントとサーバーのどちらでも使用できます。  
+  
+ このセクションを読む前に、「[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)」に説明されている内容を理解しておいてください。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[プリンシパル オブジェクトと ID オブジェクト](../../../docs/standard/security/principal-and-identity-objects.md)|Windows ID と Windows プリンシパル、汎用 ID と汎用プリンシパルの両方について、セットアップと管理方法を説明します。|  
+|[セキュリティの基本概念](../../../docs/standard/security/key-security-concepts.md)|.NET Framework のセキュリティを使用する前に理解しておく必要のある、基本的な概念について説明します。|  
+  
+## 参照  
+ <xref:System.Security.Permissions.PrincipalPermission?displayProperty=fullName>
\ No newline at end of file
diff --git a/docs/standard/security/secure-coding-guidelines.md b/docs/standard/security/secure-coding-guidelines.md
new file mode 100644
index 00000000000..abc58d52f83
--- /dev/null
+++ b/docs/standard/security/secure-coding-guidelines.md
@@ -0,0 +1,86 @@
+---
+title: "安全なコーディングのガイドライン | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ"
+  - "コード セキュリティ, オプション"
+  - "コード, セキュリティ"
+  - "コンポーネント [.NET Framework], セキュリティ"
+  - "ライブラリ コード (保護されたリソースを公開する)"
+  - "マネージ ラッパー (ネイティブなコード実装の)"
+  - "再利用可能なコンポーネント"
+  - "安全なコーディング"
+  - "安全なコーディング, オプション"
+  - "セキュリティ [.NET Framework], コーディングのガイドライン"
+  - "セキュリティに中立的なコード"
+ms.assetid: 4f882d94-262b-4494-b0a6-ba9ba1f5f177
+caps.latest.revision: 20
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# 安全なコーディングのガイドライン
+エビデンスベース セキュリティとコード アクセス セキュリティは、セキュリティを実現するための強力で明示的なメカニズムを提供します。 ほとんどのアプリケーション コードは、.NET Framework によって実装されるインフラストラクチャを単純に使用することができます。 場合によっては、アプリケーション特有の追加のセキュリティが必要になります。これは、セキュリティ システムを拡張するか、または新しい特有の方法を使用して構築されます。  
+  
+ .NET Framework によって課されるアクセス許可やコード内で課される他の手段により防御機構を設けて、悪意のあるコードが知られたくない情報を入手したり、他の望ましくないアクションを実行したりすることを防ぐ必要があります。 また、信頼されるコードを使用するすべての想定されるシナリオで、セキュリティと使いやすさのバランスを取る必要があります。  
+  
+ この概要では、セキュリティ システムと連携するようコードを設計するさまざまな方法を説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、.NET Framework のセキュリティ モデルと用語に重要な変更が加えられています。 これらの変更について詳しくは、「[セキュリティの変更点](../../../docs/framework/security/security-changes.md)」をご覧ください。  
+  
+## コード アクセス セキュリティと部分的に信頼できるコード  
+ .NET Framework には、コード アクセス セキュリティ \(CAS\) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework ではコード アクセス セキュリティはコードの分離を保証しないため、部分的にしか信頼できないコード \(特に発生元が不明なコード\) とのセキュリティ境界としてコード アクセス セキュリティを使用してはなりません。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+  
+ このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。  
+  
+## セキュリティ中立なコード  
+ セキュリティ中立なコードは、セキュリティ システムに対して明示的な操作を何も行いません。 これは何であれ自分が受け取ったアクセス許可を使用して動作します。 保護された操作 \(ファイルの使用やネットワーキングなど\) に関連したセキュリティ例外をアプリケーションがキャッチしなかった場合はハンドルされない例外になるとはいえ、セキュリティ中立なコードは .NET Framework のセキュリティ テクノロジを活用します。  
+  
+ セキュリティ中立なライブラリは、理解しておくべき特別な特性を持っています。 ファイルを使用したり、アンマネージ コードを呼び出したりする API 要素をライブラリで提供していると仮定します。これらの操作に対応するアクセス許可を持っていないコードは、記述どおりに動作しません。 しかし、コードがアクセス許可を持っているとしても、そのコードを呼び出すアプリケーション コードが同じアクセス許可を持っていなければ、正しく機能しません。 呼び出し元のコードが正しいアクセス許可を持っていない場合、コード アクセス セキュリティのスタック ウォークの結果として <xref:System.Security.SecurityException> が発生します。  
+  
+## 再利用可能なコンポーネントではないアプリケーション コード  
+ 作成するコードがアプリケーションの一部であって、他のコードから呼び出されることがなければ、セキュリティは単純であり、特殊なコーディングは不要な場合があります。 ただし、悪意のあるコードがそのコードを呼び出す可能性があることを忘れないでください。 悪意のあるコードによるリソースへのアクセスをコード アクセス セキュリティが阻止する可能性もありますが、機密情報を含んだフィールドやプロパティの値をそのようなコードが読み取ることも考えられます。  
+  
+ また、コードがインターネットやその他の信頼できないソースからのユーザー入力を受け付ける場合には、悪意のある入力にも注意する必要があります。  
+  
+## ネイティブ コードの実装のマネージ ラッパー  
+ 一般にこのシナリオは、何らかの有用な機能がネイティブ コードで実装されており、これをマネージ コードで利用したいというケースに該当します。 マネージ ラッパーは、プラットフォーム呼び出しか COM 相互運用を使用して簡単に作成できます。 ただしこの場合には、操作を成功させるために、ラッパーの呼び出し元がアンマネージ コードの権利を持っている必要があります。 つまり既定のポリシーでは、イントラネットやインターネットからダウンロードされたコードはラッパーでは機能しません。  
+  
+ これらのラッパーを使用するすべてのアプリケーションにアンマネージ コードの権利を与えるよりも、これらの権利をラッパー コードのみに与える方が望ましいと言えます。 基になる機能が何もリソースを公開しておらず、かつ実装も同様に安全である場合、ラッパーは、自分の権利をアサートしさえすれば、あらゆるコードが自分を通して呼び出しを行えるようにできます。 リソースが関係する場合のセキュリティ コーディングは、次のセクションで説明するライブラリ コードのケースと同じです。 ラッパーはこれらのリソースに対して呼び出し元を公開する可能性があるため、ネイティブ コードの安全性を慎重に確認する必要があり、その責任はラッパーにあります。  
+  
+## 保護されたリソースを公開するライブラリ コード  
+ これはセキュリティ コーディングのアプローチとして最も強力なものであるため、方法を間違えるなら最も危険性の高いものともなります。ライブラリは他のコードに対し、\(.NET Framework のクラスが使用するリソースのアクセス許可を課すのと同じように\) 他の手段では使用できない特定のリソースにアクセスするためのインターフェイスとして機能します。 どこでリソースを公開しようと、コードはまずそのリソースに適したアクセス許可を要求し \(つまりセキュリティ チェックを実行しなければなりません\)、それから通常は実際の操作を実行するための権利をアサートする必要があります。  
+  
+## 関連トピック  
+  
+|タイトル|説明|  
+|----------|--------|  
+|[方法 : サンドボックスで部分信頼コードを実行する](../../../docs/framework/misc/how-to-run-partially-trusted-code-in-a-sandbox.md)|制限されたセキュリティ環境で、部分的に信頼されたアプリケーションを実行する方法について説明します。これにより、付与されるコード アクセス許可が制限されます。|  
+|[状態データの保護](../../../docs/standard/security/securing-state-data.md)|プライベート メンバーを保護する方法について説明します。|  
+|[メソッド アクセスの保護](../../../docs/framework/misc/securing-method-access.md)|部分的に信頼されたコードによって呼び出されることからメソッドを保護する方法について説明します。|  
+|[ラッパー コードの保護](../../../docs/framework/misc/securing-wrapper-code.md)|他のコードをラップするコードのセキュリティ問題について説明します。|  
+|[セキュリティとパブリックの読み取り専用配列フィールド](../../../docs/framework/misc/security-and-public-read-only-array-fields.md)|.NET Framework ライブラリ内にある、パブリックな読み取り専用の配列を使用するコードのセキュリティ問題について説明します。|  
+|[例外処理の保護](../../../docs/framework/misc/securing-exception-handling.md)|例外を処理するためのセキュリティ問題について説明します。|  
+|[セキュリティとユーザー入力](../../../docs/standard/security/security-and-user-input.md)|ユーザー入力を受け取るアプリケーションのセキュリティ問題について説明します。|  
+|[セキュリティとリモート処理の考慮事項](../../../docs/framework/misc/security-and-remoting-considerations.md)|アプリケーション ドメインをまたいで通信するアプリケーションのセキュリティ問題について説明します。|  
+|[セキュリティとシリアル化](../../../docs/framework/misc/security-and-serialization.md)|オブジェクトをシリアル化するときのセキュリティ問題について説明します。|  
+|[セキュリティと競合状態](../../../docs/standard/security/security-and-race-conditions.md)|コードで競合状態を回避する方法について説明します。|  
+|[セキュリティと実行時のコード生成](../../../docs/standard/security/security-and-on-the-fly-code-generation.md)|動的なコードを生成するアプリケーションのセキュリティ問題について説明します。|  
+|[セキュリティとセットアップの問題](../Topic/Security%20and%20Setup%20Issues.md)|アプリケーションのテストとセットアップに関する注意点について説明します。|  
+|[コード アクセス セキュリティ](../../../docs/framework/misc/code-access-security.md)|.NET Framework のコード アクセス セキュリティについて詳しく説明し、コードで使用するための手順を示します。|  
+|[ロール ベース セキュリティ](../../../docs/standard/security/role-based-security.md)|.NET Framework のロールベース セキュリティについて詳しく説明し、コードで使用するための手順を示します。|
\ No newline at end of file
diff --git a/docs/standard/security/securing-state-data.md b/docs/standard/security/securing-state-data.md
new file mode 100644
index 00000000000..e7443a9fa13
--- /dev/null
+++ b/docs/standard/security/securing-state-data.md
@@ -0,0 +1,47 @@
+---
+title: "状態データの保護 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, 状態データ"
+  - "安全なコーディング, 状態データ"
+  - "セキュリティ [.NET Framework], 状態データ"
+  - "状態データのセキュリティ"
+ms.assetid: 12671309-2877-43fe-a3df-6863507e712d
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# 状態データの保護
+重要情報を処理するアプリケーション、または任意の種類のセキュリティ決定を行うアプリケーションは、扱うデータを自分自身の制御下に置き、他の悪意の可能性のあるコードが直接それらのデータにアクセスできないようにする必要があります。  データをメモリ内で保護する最も良い方法は、データをプライベート変数または内部変数 \(同じアセンブリ内だけにスコープを制限\) として宣言することです。  しかし、このデータがアクセスを受ける場合は、次の点を認識する必要があります。  
+  
+-   リフレクション機構を使用すると、オブジェクトを参照できる信頼度の高いコードはプライベート メンバーを取得および設定できます。  
+  
+-   シリアル化を使用すると、信頼度の高いコードがオブジェクトに対応するシリアル化された形式のデータにアクセスできる場合は、そのコードは効率よくプライベート メンバーを取得および設定できます。  
+  
+-   デバッグ時には、このデータを読み取られる可能性があります。  
+  
+ どのメソッドおよびプロパティも、意図しない方法でこれらのデータを公開しないようにしてください。  
+  
+ クラスとその派生クラスへのアクセスを制限することにより、データが保護された状態であると宣言する方法もあります。  しかし、公開の度合いが高まるため、次の対策を講じる必要があります。  
+  
+-   クラスからの派生を許可するコードを制御します。この方法として、同じアセンブリだけに派生を制限するか、または「[メソッド アクセスの保護](../../../docs/framework/misc/securing-method-access.md)」に記述されている宣言セキュリティを使用し、コードをクラスから派生させるために ID またはアクセス許可を要求します。  
+  
+-   派生したすべてのクラスが同じ保護機能を実装しているかどうか、またはシールされているかどうかを確認します。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/security/security-and-on-the-fly-code-generation.md b/docs/standard/security/security-and-on-the-fly-code-generation.md
new file mode 100644
index 00000000000..683092bb37e
--- /dev/null
+++ b/docs/standard/security/security-and-on-the-fly-code-generation.md
@@ -0,0 +1,43 @@
+---
+title: "セキュリティと実行時のコード生成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, 実行時のコード生成"
+  - "実行時のコード生成"
+  - "安全なコーディング, 実行時のコード生成"
+  - "セキュリティ [.NET Framework], 実行時のコード生成"
+ms.assetid: 6d221724-bb21-4d76-90c3-0ee2a2e69be2
+caps.latest.revision: 10
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# セキュリティと実行時のコード生成
+ライブラリによっては、コードを生成し、それを実行することによって、呼び出し元のためになんらかの処理を行います。  基本的に問題となるのは、より低い信頼度のコードの代わりに生成し、そのコードをより高い信頼度で実行することです。  呼び出し側がコードの生成に影響を及ぼすと問題はさらに悪化するため、安全と考えられるコードだけが生成されることを確認してください。  
+  
+ 常に、どのようなコードが生成されているのかを知る必要があります。  これは、ユーザーから取得する値を厳しく制御することが必要であることを意味します。これらの値は、引用符で囲まれた文字列、ID、またはそれ以外です。引用符で囲まれた文字列は予期しないコード要素を含まないようにエスケープ処理が必要で、ID は有効な ID かどうかをチェックする必要があります。  コンパイルされたアセンブリは変更できるため、変更によってその ID に異常な文字が含まれると、セキュリティが脅かされます。このため、ID にも危険性があります。ただし、これがセキュリティ脆弱性になることは稀です。  
+  
+ リフレクション出力を指定してコードを生成することをお勧めします。これは、上記の多くの問題を防ぐのに役立ちます。  
+  
+ コードをコンパイルするときに、悪意のあるプログラムがなんらかの方法でコードを変更できるかどうかを考慮します。  コンパイラがソース コードを読み取る前、またはコードが .dll を読み込む前に、悪意のあるコードがソース コードを変更できる時間的なすきまがないかどうかを確認します。  ある場合は、コード アクセス セキュリティまたはファイル システムのアクセス制御リストを適切に使用して、これらのファイルが格納されているディレクトリを保護する必要があります。  
+  
+ 生成されたコードに呼び出し元が影響を及ぼし、コンパイラ エラーが発生するような場合は、この部分がセキュリティ脆弱性になる可能性があります。  
+  
+ <xref:System.Security.Permissions.SecurityAction> または [Deny](http://msdn.microsoft.com/ja-jp/6b4d2e01-c504-4ac3-b50e-d6f5e7f5df25) を使用して、生成されたコードをできる限り低いアクセス許可の設定で実行してください。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/security/security-and-race-conditions.md b/docs/standard/security/security-and-race-conditions.md
new file mode 100644
index 00000000000..399c82021d4
--- /dev/null
+++ b/docs/standard/security/security-and-race-conditions.md
@@ -0,0 +1,116 @@
+---
+title: "セキュリティと競合状態 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, 競合状態"
+  - "競合状態"
+  - "安全なコーディング, 競合状態"
+  - "セキュリティ [.NET Framework], 競合状態"
+ms.assetid: ea3edb80-b2e8-4e85-bfed-311b20cb59b6
+caps.latest.revision: 9
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# セキュリティと競合状態
+競合状態によって生じるセキュリティ ホールの可能性についても考慮する必要があります。  この問題は、いくつかの状況で発生します。  開発者が注意しなければならない主な事項を、以下のサブトピックで説明します。  
+  
+## Dispose メソッドでの競合状態  
+ クラスの **Dispose** メソッドが同期されていない場合は、**Dispose** 内のクリーンアップ コードが複数回実行されることがあります。この例を次に示します。詳細については「[Garbage Collection](../../../docs/standard/garbage-collection/index.md)」を参照してください。  
+  
+```vb  
+Sub Dispose()  
+    If Not (myObj Is Nothing) Then  
+       Cleanup(myObj)  
+       myObj = Nothing  
+    End If  
+End Sub  
+  
+```  
+  
+```csharp  
+void Dispose()   
+{  
+    if( myObj != null )   
+    {  
+        Cleanup(myObj);  
+        myObj = null;  
+    }  
+}  
+```  
+  
+ この **Dispose** の実装は同期されていないため、`Cleanup` は最初のスレッドによって呼び出され、`_myObj` が **null** に設定される前に、2 番目のスレッドによって呼び出される可能性があります。  `Cleanup` コードが実行されたときに何が起こるかによって、セキュリティの問題となるかどうかが決まります。  同期されていない **Dispose** 実装で最も問題になるのが、ファイルなどのリソース ハンドルの使用についてです。  廃棄が適切でないと誤ったハンドルが使用され、これがセキュリティ脆弱性を招く可能性があります。  
+  
+## コンストラクターでの競合状態  
+ アプリケーションによっては、クラスのコンストラクターが完全に実行される前に、他のスレッドがクラス メンバーにアクセスすることがあります。  すべてのクラスのコンストラクターを調べ、このようなことが起きてもセキュリティの問題が発生しないことを確認してください。必要であれば、スレッドを同期します。  
+  
+## キャッシュされたオブジェクトとの競合状態  
+ セキュリティ情報をキャッシュするコード、またはコード アクセス セキュリティの [Assert](../../../docs/framework/misc/using-the-assert-method.md) 操作を使用するコードは、クラスの他の部分が適切に同期されていないと、競合状態に対する脆弱性を持ちます。この例を次に示します。  
+  
+```vb  
+Sub SomeSecureFunction()  
+    If SomeDemandPasses() Then  
+        fCallersOk = True  
+        DoOtherWork()  
+        fCallersOk = False()  
+    End If  
+End Sub  
+  
+Sub DoOtherWork()  
+    If fCallersOK Then  
+        DoSomethingTrusted()  
+    Else  
+        DemandSomething()  
+        DoSomethingTrusted()  
+    End If  
+End Sub  
+  
+```  
+  
+```csharp  
+void SomeSecureFunction()   
+{  
+    if(SomeDemandPasses())   
+    {  
+        fCallersOk = true;  
+        DoOtherWork();  
+        fCallersOk = false();  
+    }  
+}  
+void DoOtherWork()   
+{  
+    if( fCallersOK )   
+    {  
+        DoSomethingTrusted();  
+    }  
+    else   
+    {  
+        DemandSomething();  
+        DoSomethingTrusted();  
+    }  
+}  
+```  
+  
+ 同じオブジェクトを使用して別のスレッドから呼び出される `DoOtherWork` への別のパスがあるときは、信頼関係のない呼び出し元が要求を通してしまう可能性があります。  
+  
+ コードがセキュリティ情報をキャッシュする場合は、この脆弱性について確認する必要があります。  
+  
+## ファイナライザーでの競合状態  
+ 静的リソースまたはアンマネージ リソースを参照し、そのファイナライザー内で解放されるオブジェクトには、競合状態が発生する可能性があります。  クラスのファイナライザーで操作されるリソースを複数のオブジェクトで共有している場合は、オブジェクトはそのリソースへのすべてのアクセスを同期する必要があります。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/security/security-and-user-input.md b/docs/standard/security/security-and-user-input.md
new file mode 100644
index 00000000000..bf733acaf6e
--- /dev/null
+++ b/docs/standard/security/security-and-user-input.md
@@ -0,0 +1,71 @@
+---
+title: "セキュリティとユーザー入力 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "コード セキュリティ, ユーザー入力"
+  - "安全なコーディング, ユーザー入力"
+  - "セキュリティ [.NET Framework], ユーザー入力"
+  - "ユーザー入力, セキュリティ"
+ms.assetid: 9141076a-96c9-4b01-93de-366bb1d858bc
+caps.latest.revision: 7
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 5
+---
+# セキュリティとユーザー入力
+さまざまな種類の入力 \(Web 要求または URL からのデータ、Microsoft Windows フォーム アプリケーションを制御する入力など\) で得られるユーザー データは、他のデータを呼び出すときのパラメーターとして直接使用されることがあり、コードに悪影響を与える可能性があります。  この状況は、悪意のあるコードが異常なパラメーターを使用してコードを呼び出すことに類似しているため、同様の対策が必要です。  ユーザー入力を安全にすることは、実際には非常に難しいことです。信頼できない可能性があるデータの存在を追跡するためのスタック フレームがないからです。  
+  
+ これらは、セキュリティとは無関係に見えるコード内に存在しながら、他のコードを通じて悪意のあるデータを通してしまうため、最も微妙で最も見つけるのが難しいセキュリティ バグと言えます。  これらのバグを探すには、さまざまな種類の入力データを追跡し、可能な値の範囲を推測し、さらにこのデータを見ているコードがこれらのすべてのケースを処理できるのかを考慮します。  値の範囲をチェックし、コードが処理できないデータを拒否することによって、これらのバグを修正できます。  
+  
+ ユーザー データに関して、考慮が必要な点を以下に示します。  
+  
+-   サーバー応答内のどのユーザー データも、クライアント上のサーバー側のコンテキストで実行されます。  Web サーバーがユーザー データを受け取り、返される Web ページに挿入するように、サーバーからたとえば **\<script\>** タグを含めて、実行される可能性があります。  
+  
+-   クライアントは任意の URL を要求できるため、注意が必要です。  
+  
+-   次のような異常なパスまたは不正なパスについて考慮します。  
+  
+    -   。\\、非常に長いパス。  
+  
+    -   ワイルドカード文字 \(\*\) の使用。  
+  
+    -   トークンの拡張 \(%token%\)。  
+  
+    -   特殊な意味を持つ異常な形式のパス。  
+  
+    -   代替ファイル システム ストリーム名。たとえば、`filename::$DATA` など。  
+  
+    -   `longfilename` に対する `longfi~1` などのファイル名の短縮バージョン。  
+  
+-   Eval\(userdata\) は任意のことを実行できるため、注意が必要です。  
+  
+-   いくつかのユーザー データを持つ名前への遅延バインディングには注意が必要です。  
+  
+-   Web データを処理する場合は、許可するさまざまなエスケープの形式について考慮します。次のような形式があります。  
+  
+    -   16 進エスケープ \(%nn\)。  
+  
+    -   Unicode エスケープ \(%nnn\)。  
+  
+    -   Overlong UTF\-8 エスケープ \(%nn%nn\)。  
+  
+    -   二重エスケープ \(%nn が %mmnn になります。%mm は '%' のエスケープです\)。  
+  
+-   複数の標準形式が含まれるユーザー名には注意が必要です。  たとえば、Microsoft Windows 2000 では、MYDOMAIN\\*username* 形式または *username*@mydomain.example.com 形式のいずれかを使用します。  
+  
+## 参照  
+ [安全なコーディングのガイドライン](../../../docs/standard/security/secure-coding-guidelines.md)
\ No newline at end of file
diff --git a/docs/standard/security/walkthrough-creating-a-cryptographic-application.md b/docs/standard/security/walkthrough-creating-a-cryptographic-application.md
new file mode 100644
index 00000000000..11f9e9f4bb5
--- /dev/null
+++ b/docs/standard/security/walkthrough-creating-a-cryptographic-application.md
@@ -0,0 +1,220 @@
+---
+title: "チュートリアル : 暗号化アプリケーションの作成 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+dev_langs: 
+  - "VB"
+  - "CSharp"
+  - "C++"
+  - "jsharp"
+helpviewer_keywords: 
+  - "暗号化 [.NET Framework], アプリケーションの例"
+  - "暗号化 [.NET Framework], 暗号化アプリケーションの例"
+  - "暗号化 [.NET Framework], 例"
+ms.assetid: abf48c11-1e72-431d-9562-39cf23e1a8ff
+caps.latest.revision: 17
+author: "mairaw"
+ms.author: "mairaw"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# チュートリアル : 暗号化アプリケーションの作成
+このチュートリアルでは、コンテンツの暗号化および復号化の方法を示します。  コード例は、Windows フォーム アプリケーション向けに設計されています。  このアプリケーションは、スマート カードを使用するなどの実際のシナリオは示していません。  代わりに、暗号化と復号化の基礎を示しています。  
+  
+ このチュートリアルでは、次の暗号化のガイドラインを使用します。  
+  
+-   自動生成される <xref:System.Security.Cryptography.SymmetricAlgorithm.Key%2A> と <xref:System.Security.Cryptography.SymmetricAlgorithm.IV%2A> を使用すると、対称アルゴリズムである <xref:System.Security.Cryptography.RijndaelManaged> クラスでデータの暗号化と復号化を行えます。  
+  
+-   非対称アルゴリズムである <xref:System.Security.Cryptography.RSACryptoServiceProvider> を使用すると、<xref:System.Security.Cryptography.RijndaelManaged> で暗号化されたデータのキーの暗号化と復号化を行えます。  非対称アルゴリズムは、キーなどの少量のデータに最適です。  
+  
+    > [!NOTE]
+    >  暗号化されたコンテンツを他のユーザーと交換するのではなく、コンピューター上のデータを保護する場合は、<xref:System.Security.Cryptography.ProtectedData> クラスまたは <xref:System.Security.Cryptography.ProtectedMemory> クラスの使用を検討してください。  
+  
+ 次の表は、このトピックの暗号化のタスクをまとめたものです。  
+  
+|タスク|説明|  
+|---------|--------|  
+|Windows フォーム アプリケーションの作成|アプリケーションを実行するために必要なコントロールの一覧を表示します。|  
+|グローバル オブジェクトの宣言|文字列のパスの変数、<xref:System.Security.Cryptography.CspParameters>、および <xref:System.Security.Cryptography.RSACryptoServiceProvider> を宣言して、<xref:System.Windows.Forms.Form> クラスのグローバル コンテキストを指定します。|  
+|非対称キーの作成|非対称の公開キーと秘密キーの値のペアを作成し、これにキー コンテナー名を割り当てます。|  
+|ファイルの暗号化|暗号化するファイルを選択するダイアログ ボックスを表示し、ファイルを暗号化します。|  
+|ファイルの復号化|復号化する暗号化されたファイルを選択するダイアログ ボックスを表示し、ファイルを復号化します。|  
+|秘密キーの取得|キー コンテナー名を使用して、完全なキーのペアを取得します。|  
+|公開キーのエクスポート|パブリック パラメーターのみで XML ファイルにキーを保存します。|  
+|公開キーのインポート|キーを XML ファイルからキー コンテナーに読み込みます。|  
+|アプリケーションのテスト|このアプリケーションをテストするための手順を一覧に示します。|  
+  
+## 必須コンポーネント  
+ このチュートリアルを実行するには、次のコンポーネントが必要です。  
+  
+-   <xref:System.IO> 名前空間と <xref:System.Security.Cryptography> 名前空間への参照。  
+  
+## Windows フォーム アプリケーションの作成  
+ このチュートリアルにあるほとんどのコード例は、ボタン コントロールのイベント ハンドラーとして設計されています。  次の表は、サンプル アプリケーションに必要なコントロールと、コード例に一致する必要な名前を示しています。  
+  
+|コントロール|名前|テキストのプロパティ \(必要に応じて\)|  
+|------------|--------|---------------------------|  
+|<xref:System.Windows.Forms.Button>|`buttonEncryptFile`|ファイルの暗号化|  
+|<xref:System.Windows.Forms.Button>|`buttonDecryptFile`|ファイルの復号化|  
+|<xref:System.Windows.Forms.Button>|`buttonCreateAsmKeys`|キーの作成|  
+|<xref:System.Windows.Forms.Button>|`buttonExportPublicKey`|公開キーのエクスポート|  
+|<xref:System.Windows.Forms.Button>|`buttonImportPublicKey`|公開キーのインポート|  
+|<xref:System.Windows.Forms.Button>|`buttonGetPrivateKey`|秘密キーの取得|  
+|<xref:System.Windows.Forms.Label>|`label1`||  
+|<xref:System.Windows.Forms.OpenFileDialog>|`openFileDialog1`||  
+|<xref:System.Windows.Forms.OpenFileDialog>|`openFileDialog2`||  
+  
+ ボタンのイベント ハンドラーを作成するには、Visual Studio デザイナーでボタンをダブルクリックします。  
+  
+## グローバル オブジェクトの宣言  
+ 次のコードをフォームのコンストラクターに追加します。  環境とユーザー設定のための文字列変数を編集します。  
+  
+ [!code-csharp[CryptoWalkThru#1](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#1)]
+ [!code-vb[CryptoWalkThru#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#1)]  
+  
+## 非対称キーの作成  
+ この作業では、<xref:System.Security.Cryptography.RijndaelManaged> キーの暗号化と復号化を行う非対称キーを作成します。  このキーは、コンテンツの暗号化に使用されたもので、ラベル コントロールにキー コンテナー名を表示します。  
+  
+ 次のコードを \[`Create Keys`\] ボタン \(`buttonCreateAsmKeys_Click`\) の `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#2](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#2)]
+ [!code-vb[CryptoWalkThru#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#2)]  
+  
+## ファイルの暗号化  
+ この作業には、\[`Encrypt File`\] ボタン \(`buttonEncryptFile_Click`\) のイベント ハンドラー メソッドと `EncryptFile` メソッドという 2 つのメソッドが含まれています。  最初のメソッドは、ファイルを選択するためのダイアログ ボックスを表示し、暗号化を実行する 2 番目のメソッドにファイル名を渡します。  
+  
+ 暗号化されたコンテンツ、キー、および IV は、すべて 1 つの <xref:System.IO.FileStream> に保存されます。これを暗号化パッケージといいます。  
+  
+ この `EncryptFile` メソッドは以下を実行します。  
+  
+1.  コンテンツを暗号化する <xref:System.Security.Cryptography.RijndaelManaged> 対称アルゴリズムを作成します。  
+  
+2.  <xref:System.Security.Cryptography.RijndaelManaged> キーを暗号化する <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトを作成します。  
+  
+3.  ソース ファイルの <xref:System.IO.FileStream> の読み取りと暗号化を行う <xref:System.Security.Cryptography.CryptoStream> オブジェクト \(バイトのブロック\) を使用して、暗号化ファイルの対象の <xref:System.IO.FileStream> オブジェクトにします。  
+  
+4.  暗号化されたキーと IV の長さを決定し、長さの値のバイト配列を作成します。  
+  
+5.  暗号化されたパッケージにキー、IV、および長さの値を書き込みます。  
+  
+ 暗号化パッケージでは、次の形式を使用します。  
+  
+-   キーの長さ: 0 \- 3 バイト  
+  
+-   IV の長さ: 4 \- 7 バイト  
+  
+-   暗号化されたキー  
+  
+-   IV  
+  
+-   暗号化テキスト  
+  
+ キーと IV の長さを使用すると、暗号化パッケージのすべての部分の開始点と長さを決定することができます。これを使用してファイルを復号化します。  
+  
+ 次のコードを \[`Encrypt File`\] ボタン \(`buttonEncryptFile_Click`\) の `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#3](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#3)]
+ [!code-vb[CryptoWalkThru#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#3)]  
+  
+ フォームに次の `EncryptFile` メソッドを追加します。  
+  
+ [!code-csharp[CryptoWalkThru#5](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#5)]
+ [!code-vb[CryptoWalkThru#5](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#5)]  
+  
+## ファイルの復号化  
+ この作業には、\[`Decrypt File`\] ボタン \(`buttonEncryptFile_Click`\) のイベント ハンドラー メソッドと `DecryptFile` メソッドという 2 つのメソッドが含まれています。  最初のメソッドは、ファイルを選択するためのダイアログ ボックスを表示し、復号化を実行する 2 番目のメソッドにファイル名を渡します。  
+  
+ `Decrypt` メソッドは以下を実行します。  
+  
+1.  コンテンツを復号化する <xref:System.Security.Cryptography.RijndaelManaged> の対称アルゴリズムを作成します。  
+  
+2.  暗号化されたキーと IV の長さを取得するには、暗号化パッケージの <xref:System.IO.FileStream> の最初の 8 バイトを読み取ってバイト配列にします。  
+  
+3.  キーと IV を暗号化パッケージから抽出してバイト配列にします。  
+  
+4.  <xref:System.Security.Cryptography.RijndaelManaged> キーを復号化する <xref:System.Security.Cryptography.RSACryptoServiceProvider> オブジェクトを作成します。  
+  
+5.  <xref:System.Security.Cryptography.CryptoStream> オブジェクトを使用して、<xref:System.IO.FileStream> の暗号化パッケージの暗号テキスト セクションをバイトのブロックで読み取って復号化し、復号化されたファイルの <xref:System.IO.FileStream> オブジェクトにします。  これが終了すると、復号化は完了です。  
+  
+ 次のコードを、\[`Decrypt File`\] ボタンの `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#4](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#4)]
+ [!code-vb[CryptoWalkThru#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#4)]  
+  
+ フォームに次の `DecryptFile` メソッドを追加します。  
+  
+ [!code-csharp[CryptoWalkThru#6](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#6)]
+ [!code-vb[CryptoWalkThru#6](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#6)]  
+  
+## 公開キーのエクスポート  
+ この作業では、\[`Create Keys`\] ボタンによって作成されたキーをファイルに保存します。  パブリック パラメーターのみがエクスポートされます。  
+  
+ この作業では、アリスがボブに公開キーを与えるシナリオをシミュレーションします。そうすることで、ボブはアリスのファイルを暗号化できるようになります。  ボブとその公開キーを持つ他のユーザーはファイルを復号化できなくなります。彼らはプライベート パラメーターを持つ完全なキーのペアを持っていないためです。  
+  
+ 次のコードを、\[`Export Public Key`\] ボタン \(`buttonExportPublicKey_Click`\) の `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#8](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#8)]
+ [!code-vb[CryptoWalkThru#8](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#8)]  
+  
+## 公開キーのインポート  
+ この作業では、\[`Export Public Key`\] ボタンによって作成されたパブリック パラメーターのみを持つキーを読み込み、キー コンテナー名として設定します。  
+  
+ この作業では、ボブがアリスのファイルを暗号化できるように、ボブがパブリック パラメーターのみを持つアリスのキーを読み込むシナリオをシミュレーションします。  
+  
+ 次のコードを、\[`Import Public Key`\] ボタン \(`buttonImportPublicKey_Click`\) の `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#9](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#9)]
+ [!code-vb[CryptoWalkThru#9](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#9)]  
+  
+## 秘密キーの取得  
+ この作業では、\[`Create Keys`\] ボタンを使用して作成されたキーの名前にキー コンテナー名を設定します。  キー コンテナーには、プライベート パラメーターを持つ完全なキーのペアが格納されます。  
+  
+ この作業では、アリスが自分の秘密キーを使用してボブが暗号化したファイルを復号化するシナリオをシミュレーションします。  
+  
+ 次のコードを、\[`Get Private Key`\] ボタン \(`buttonGetPrivateKey_Click`\) の `Click` イベント ハンドラーとして追加します。  
+  
+ [!code-csharp[CryptoWalkThru#7](../../../samples/snippets/csharp/VS_Snippets_CLR/CryptoWalkThru/cs/Form1.cs#7)]
+ [!code-vb[CryptoWalkThru#7](../../../samples/snippets/visualbasic/VS_Snippets_CLR/CryptoWalkThru/vb/Form1.vb#7)]  
+  
+## アプリケーションのテスト  
+ アプリケーションをビルドしたら、次のテスト シナリオを実行します。  
+  
+#### キーの作成、暗号化、および復号化を行うには  
+  
+1.  \[`Create Keys`\] ボタンをクリックします。  ラベルはキー名を表示し、完全なキーのペアであることを示します。  
+  
+2.  \[`Export Public Key`\] ボタンをクリックします。  公開キーのパラメーターのエクスポートにより現在のキーは変更されないことに注意してください。  
+  
+3.  \[`Encrypt File`\] ボタンをクリックして、ファイルを選択します。  
+  
+4.  \[`Decrypt File`\] ボタンをクリックして、暗号化したファイルを選択します。  
+  
+5.  復号化したファイルを調べます。  
+  
+6.  次のシナリオで保持されたキー コンテナーを取得するテストを実行するには、アプリケーションを閉じて再起動します。  
+  
+#### 公開キーを使用して暗号化するには  
+  
+1.  \[`Import Public Key`\] ボタンをクリックします。  ラベルはキー名を表示し、公開キーのみであることを示します。  
+  
+2.  \[`Encrypt File`\] ボタンをクリックして、ファイルを選択します。  
+  
+3.  \[`Decrypt File`\] ボタンをクリックして、暗号化したファイルを選択します。  復号化するには秘密キーが必要であるため、これは失敗します。  
+  
+ このシナリオでは、公開キーのみによる別のユーザーのファイルの暗号化をデモンストレーションします。  通常、そのユーザーは公開キーのみを与え、秘密キーは復号化のため与えないでおきます。  
+  
+#### 秘密キーを使用して復号化するには  
+  
+1.  \[`Get Private Key`\] ボタンをクリックします。  ラベルはキー名を表示し、完全なキーのペアであるかどうかを示します。  
+  
+2.  \[`Decrypt File`\] ボタンをクリックし、暗号化したファイルを選択します。  復号化するための完全なキーのペアがあるため、これは成功します。  
+  
+## 参照  
+ [暗号サービス](../../../docs/standard/security/cryptographic-services.md)
\ No newline at end of file
diff --git a/docs/standard/threading/TOC.md b/docs/standard/threading/TOC.md
new file mode 100644
index 00000000000..fd605dbf2ba
--- /dev/null
+++ b/docs/standard/threading/TOC.md
@@ -0,0 +1,42 @@
+# [SpinLock](spinlock.md)
+# [CountdownEvent](countdownevent.md)
+# [Cancellation in Managed Threads](cancellation-in-managed-threads.md)
+# [Thread.Suspend, Garbage Collection, and Safe Points](thread-suspend-garbage-collection-and-safe-points.md)
+# [Managed Threading Best Practices](managed-threading-best-practices.md)
+# [How to: Synchronize Concurrent Operations with a Barrier](how-to-synchronize-concurrent-operations-with-a-barrier.md)
+# [Destroying Threads](destroying-threads.md)
+# [Canceling Threads Cooperatively](canceling-threads-cooperatively.md)
+# [Foreground and Background Threads](foreground-and-background-threads.md)
+# [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)
+# [Interlocked Operations](interlocked-operations.md)
+# [How to: Listen for Cancellation Requests by Polling](how-to-listen-for-cancellation-requests-by-polling.md)
+# [Thread Local Storage: Thread-Relative Static Fields and Data Slots](thread-local-storage-thread-relative-static-fields-and-data-slots.md)
+# [Synchronizing Data for Multithreading](synchronizing-data-for-multithreading.md)
+# [Overview of Synchronization Primitives](overview-of-synchronization-primitives.md)
+# [How to: Use SpinWait to Implement a Two-Phase Wait Operation](how-to-use-spinwait-to-implement-a-two-phase-wait-operation.md)
+# [Managed Threading Basics](managed-threading-basics.md)
+# [How to: Use SpinLock for Low-Level Synchronization](how-to-use-spinlock-for-low-level-synchronization.md)
+# [Pausing and Resuming Threads](pausing-and-resuming-threads.md)
+# [Mutexes](mutexes.md)
+# [Using Threads and Threading](using-threads-and-threading.md)
+# [Reader-Writer Locks](reader-writer-locks.md)
+# [How to: Register Callbacks for Cancellation Requests](how-to-register-callbacks-for-cancellation-requests.md)
+# [Threading](index.md)
+# [Semaphore and SemaphoreSlim](semaphore-and-semaphoreslim.md)
+# [Timers](timers.md)
+# [How to: Listen for Multiple Cancellation Requests](how-to-listen-for-multiple-cancellation-requests.md)
+# [How to: Listen for Cancellation Requests That Have Wait Handles](how-to-listen-for-cancellation-requests-that-have-wait-handles.md)
+# [AutoResetEvent](autoresetevent.md)
+# [Scheduling Threads](scheduling-threads.md)
+# [マネージ スレッドの状態](managed-thread-states.md)
+# [How to: Enable Thread-Tracking Mode in SpinLock](how-to-enable-thread-tracking-mode-in-spinlock.md)
+# [Barrier](barrier.md)
+# [Threads and Threading](threads-and-threading.md)
+# [Creating Threads and Passing Data at Start Time](creating-threads-and-passing-data-at-start-time.md)
+# [Managed and Unmanaged Threading in Windows](managed-and-unmanaged-threading-in-windows.md)
+# [ManualResetEvent and ManualResetEventSlim](manualresetevent-and-manualreseteventslim.md)
+# [SpinWait](spinwait.md)
+# [The Managed Thread Pool](the-managed-thread-pool.md)
+# [Threading Objects and Features](threading-objects-and-features.md)
+# [EventWaitHandle](eventwaithandle.md)
+# [Exceptions in Managed Threads](exceptions-in-managed-threads.md)
diff --git a/docs/standard/threading/autoresetevent.md b/docs/standard/threading/autoresetevent.md
new file mode 100644
index 00000000000..8b2750a92c3
--- /dev/null
+++ b/docs/standard/threading/autoresetevent.md
@@ -0,0 +1,35 @@
+---
+title: "AutoResetEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], AutoResetEvent class"
+  - "AutoResetEvent class"
+ms.assetid: 6d39c48d-6b37-4a9b-8631-f2924cfd9c18
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# AutoResetEvent
+<xref:System.Threading.AutoResetEvent> クラスは、ローカル待機ハンドル イベントを表します。これは、待機中の 1 つのスレッドが解放された後、シグナル状態になったときに自動的にリセットされます。  このクラスは、基本クラス <xref:System.Threading.EventWaitHandle> の特殊なケースです。  自動的にリセットされるイベントの使用と特徴については、[EventWaitHandle](../../../docs/standard/threading/eventwaithandle.md) の概念を説明したドキュメントを参照してください。  
+  
+ 待機中の 1 つのスレッドが解放されると、<xref:System.Threading.AutoResetEvent> オブジェクトはシステムによって自動的に非シグナル状態にリセットされます。  待機中のスレッドがない場合、イベント オブジェクトはシグナル状態のままです。  <xref:System.Threading.AutoResetEvent> は、`bManualReset` 引数を `false` に指定する Win32 `CreateEvent` 呼び出しと同じです。  
+  
+ <xref:System.Threading.AutoResetEvent> の使用例については、「[Monitor](../Topic/Monitors.md)」を参照してください。  
+  
+## 参照  
+ <xref:System.Threading.ManualResetEvent>   
+ <xref:System.Threading.Monitor>   
+ [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [Wait Handles](../Topic/Wait%20Handles.md)
\ No newline at end of file
diff --git a/docs/standard/threading/barrier.md b/docs/standard/threading/barrier.md
new file mode 100644
index 00000000000..166178b1804
--- /dev/null
+++ b/docs/standard/threading/barrier.md
@@ -0,0 +1,55 @@
+---
+title: "Barrier (.NET Framework) | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization primitives, Barrier"
+ms.assetid: 613a8bc7-6a28-4795-bd6c-1abd9050478f
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Barrier (.NET Framework)
+*バリア*とは、複数のスレッド \(*参加要素*と呼ばれます\) が段階的に 1 つのアルゴリズムで同時に動作できるようにするユーザー定義の同期プリミティブです。  各参加要素は、コードのバリア ポイントに到達するまで実行されます。  バリアは、作業の 1 つのフェーズの終了を表します。  参加要素は、バリアに到達すると、すべての参加要素が同じバリアに到達するまでブロックされます。  すべての参加要素がバリアに到達した後、必要に応じて、フェーズ後の処理を呼び出すことができます。  フェーズ後の処理を使用すると、他のすべてのスレッドがブロックされた状態のまま 1 つのスレッドでアクションを実行できます。  アクションが実行された後、参加要素のブロックはすべて解除されます。  
+  
+ 基本的なバリア パターンを次のコード スニペットに示します。  
+  
+ [!code-csharp[CDS_Barrier#02](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_barrier/cs/barrier.cs#02)]
+ [!code-vb[CDS_Barrier#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_barrier/vb/barrier_vb.vb#02)]  
+  
+ コード例全体については、「[How to: Synchronize Concurrent Operations with a Barrier](../../../docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md)」を参照してください。  
+  
+## 参加要素の追加と削除  
+ <xref:System.Threading.Barrier> を作成するときは、参加要素の数を指定します。  また、参加要素は、いつでも動的に追加または削除できます。  たとえば、1 つの参加要素がその処理を終えた場合に、結果を保存し、そのスレッドの実行を停止してから、<xref:System.Threading.Barrier.RemoveParticipant%2A> を呼び出してバリアの参加要素の数を 1 つ減らすことができます。  <xref:System.Threading.Barrier.AddParticipant%2A> を呼び出して参加要素を追加すると、戻り値によって現在のフェーズ数が示されます。この値は、追加した新しい参加要素の作業を初期化するのに役立つことがあります。  
+  
+## 破損したバリア  
+ いずれかの参加要素がバリアに到達できない場合、デッドロックが発生することがあります。  このようなデッドロックを避けるには、<xref:System.Threading.Barrier.SignalAndWait%2A> メソッドのオーバーロードを使用して、タイムアウト期間とキャンセル トークンを指定します。  すべての参加要素は、次のフェーズに進む前に、これらのオーバーロードから返されるブール値をチェックできます。  
+  
+## フェーズ後の例外  
+ フェーズ後のデリゲートから例外がスローされる場合、その例外は <xref:System.Threading.BarrierPostPhaseException> オブジェクトでラップされ、このオブジェクトがすべての参加要素に伝達されます。  
+  
+## バリアと ContinueWhenAll  
+ バリアは、スレッドで複数のフェーズをループ処理する場合に特に便利です。  コードで作業のフェーズが 1 つか 2 つしか必要ない場合は、次のような何らかの暗黙的な結合と共に <xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトを使用することを検討してください。  
+  
+-   <xref:System.Threading.Tasks.TaskFactory.ContinueWhenAll%2A>  
+  
+-   <xref:System.Threading.Tasks.Parallel.Invoke%2A>  
+  
+-   <xref:System.Threading.Tasks.Parallel.ForEach%2A>  
+  
+-   <xref:System.Threading.Tasks.Parallel.For%2A>  
+  
+ 詳細については、「[Chaining Tasks by Using Continuation Tasks](../../../docs/standard/parallel-programming/chaining-tasks-by-using-continuation-tasks.md)」を参照してください。  
+  
+## 参照  
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [How to: Synchronize Concurrent Operations with a Barrier](../../../docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md)
\ No newline at end of file
diff --git a/docs/standard/threading/canceling-threads-cooperatively.md b/docs/standard/threading/canceling-threads-cooperatively.md
new file mode 100644
index 00000000000..9463b71484a
--- /dev/null
+++ b/docs/standard/threading/canceling-threads-cooperatively.md
@@ -0,0 +1,28 @@
+---
+title: "Canceling Threads Cooperatively | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threads, cancellation"
+ms.assetid: d2d6d5fd-e263-4fa0-847b-2fc3e0d82337
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Canceling Threads Cooperatively
+[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] より前のバージョンの .NET Framework には、開始されたスレッドを協調的に取り消す手段は組み込まれていませんでした。 それに対して、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、<xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトや PLINQ クエリを取り消す場合と同様に、キャンセル トークンを使用してスレッドを取り消すことができます。<xref:System.Threading.Thread?displayProperty=fullName> クラスにはキャンセル トークンのサポートは組み込まれていませんが、<xref:System.Threading.ParameterizedThreadStart> デリゲートを受け取る <xref:System.Threading.Thread> コンストラクターを使用して、トークンをスレッド プロシージャに渡すことができます。 この方法を次の例に示します。  
+  
+ [!code-csharp[Cancellation#14](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/CooperativeThreads.cs#14)]
+ [!code-vb[Cancellation#14](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/CooperativeThreads.vb#14)]  
+  
+## 参照  
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)
\ No newline at end of file
diff --git a/docs/standard/threading/cancellation-in-managed-threads.md b/docs/standard/threading/cancellation-in-managed-threads.md
new file mode 100644
index 00000000000..aa1da9d15ad
--- /dev/null
+++ b/docs/standard/threading/cancellation-in-managed-threads.md
@@ -0,0 +1,153 @@
+---
+title: "Cancellation in Managed Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "cancellation in .NET, overview"
+ms.assetid: eea11fe5-d8b0-4314-bb5d-8a58166fb1c3
+caps.latest.revision: 23
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 23
+---
+# Cancellation in Managed Threads
+[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降で、非同期操作または長時間にわたる同期操作に対する連携によるキャンセルのための統一されたモデルが .NET Framework に導入されました。  このモデルは、キャンセル トークンと呼ばれる軽量のオブジェクトに基づいています。  新しいスレッドまたは新しいタスクの作成などによって 1 つ以上のキャンセル可能な操作を呼び出すオブジェクトは、各操作にトークンを渡します。  次いで、個々の操作は他の操作にトークンのコピーを渡すことができます。  その後、トークンを作成したオブジェクトは、操作が実行している処理を停止するように、そのトークンを使用してその操作に要求できます。  キャンセル要求は、要求側のオブジェクトからのみ発行できます。各リスナーは要求を確認し、適切な時に定期的にその要求に応答する必要があります。  
+  
+ 連携によるキャンセル処理モデルを実装するための一般的なパターンは次のとおりです。  
+  
+-   <xref:System.Threading.CancellationTokenSource> オブジェクトのインスタンスを作成します。このオブジェクトでは、個々のキャンセル トークンへのキャンセル通知を管理し、送信します。  
+  
+-   <xref:System.Threading.CancellationTokenSource.Token%2A?displayProperty=fullName> プロパティによって返されるトークンを、キャンセルをリッスンしているそれぞれのタスクまたはスレッドに渡します。  
+  
+-   それぞれのタスクまたはスレッドに対し、キャンセルに応答するメカニズムを提供します。  
+  
+-   キャンセルの通知を提供する <xref:System.Threading.CancellationTokenSource.Cancel%2A?displayProperty=fullName> メソッドを呼び出します。  
+  
+> [!IMPORTANT]
+>  <xref:System.Threading.CancellationTokenSource> クラスは、<xref:System.IDisposable> インターフェイスを実装します。  キャンセル トークン ソースの使用を終えた後は、必ず <xref:System.Threading.CancellationTokenSource.Dispose%2A?displayProperty=fullName> メソッドを呼び出して、キャンセル トークン ソースが保持しているアンマネージ リソースを解放する必要があります。  
+  
+ トークンのソースとそのトークンのすべてのコピーの間の関係を次の図に示します。  
+  
+ ![CancellationTokenSource とキャンセル トークン](../../../docs/standard/threading/media/vs-cancellationtoken.png "VS\_CancellationToken")  
+  
+ 新しいキャンセル モデルによって、キャンセルに対応したアプリケーションやライブラリの作成が簡単になりました。このモデルでは次の機能がサポートされます。  
+  
+-   キャンセルは連携によって行われ、リスナーに強制されません。  リスナー側でキャンセル要求に応じた適切な終了方法を決定できます。  
+  
+-   要求とリッスンが区別して行われます。  キャンセルをいつ要求するか \(もし要求する場合\) は、キャンセル可能な操作を呼び出すオブジェクトの側で制御できます。  
+  
+-   要求側のオブジェクトは、1 回のメソッド呼び出しでトークンのすべてのコピーにキャンセル要求を発行できます。  
+  
+-   リスナーは、複数のトークンを 1 つの*リンク トークン*に結合して同時にリッスンできます。  
+  
+-   ライブラリ コードからのキャンセル要求をユーザー コードで確認して応答したり、ユーザー コードからのキャンセル要求をライブラリ コードで確認して応答したりすることができます。  
+  
+-   リスナーはポーリング、コールバックの登録、または待機ハンドルの待機により、キャンセル要求の通知を受け取ることができます。  
+  
+## キャンセルの型  
+ キャンセル フレームワークは、関連する一連の型として実装されます。それらの型を次の表に示します。  
+  
+|型名|説明|  
+|--------|--------|  
+|<xref:System.Threading.CancellationTokenSource>|キャンセル トークンを作成するオブジェクトです。そのトークンのすべてのコピーに対するキャンセル要求の発行も、このオブジェクトで行います。|  
+|<xref:System.Threading.CancellationToken>|1 つ以上のリスナーに渡される軽量な値型で、通常はメソッド パラメーターとして渡されます。  リスナーはポーリング、コールバック、または待機ハンドルによってトークンの `IsCancellationRequested` プロパティの値を監視します。|  
+|<xref:System.OperationCanceledException>|この例外のコンストラクターのオーバーロードで、<xref:System.Threading.CancellationToken> をパラメーターとして受け入れます。  リスナーは必要に応じてこの例外をスローすることができます。この例外により、キャンセルのソースを確認し、キャンセル要求にそのリスナーが応答したことを他のリスナーに通知します。|  
+  
+ この新しいキャンセル モデルは、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] のいくつかの型に統合されています。最も重要なものは、<xref:System.Threading.Tasks.Parallel?displayProperty=fullName>、<xref:System.Threading.Tasks.Task?displayProperty=fullName>、<xref:System.Threading.Tasks.Task%601?displayProperty=fullName>、および <xref:System.Linq.ParallelEnumerable?displayProperty=fullName> です。  新しいライブラリおよびアプリケーション コードでは、すべてこの新しいキャンセル モデルを使用することをお勧めします。  
+  
+## コード例  
+ 次の例では、要求側のオブジェクトで <xref:System.Threading.CancellationTokenSource> オブジェクトを作成した後、その <xref:System.Threading.CancellationTokenSource.Token%2A> プロパティをキャンセル可能な操作に渡します。  要求を受け取る側の操作では、ポーリングによってトークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティの値を監視します。  値が `true` になったら、リスナーは適切な方法で終了できます。  この例では、メソッドの終了だけを行っています。多くの場合はこの処理だけで十分です。  
+  
+> [!NOTE]
+>  この例では、新しいキャンセル フレームワークが従来の API と互換性があることを示すために、<xref:System.Threading.ThreadPool.QueueUserWorkItem%2A> メソッドを使用しています。  推奨される新しい <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型を使用した例については、「[How to: Cancel a Task and Its Children](../../../docs/standard/parallel-programming/how-to-cancel-a-task-and-its-children.md)」を参照してください。  
+  
+ [!code-csharp[Cancellation#1](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex1.cs#1)]
+ [!code-vb[Cancellation#1](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex1.vb#1)]  
+  
+## 操作のキャンセルとオブジェクトのキャンセル  
+ 新しいキャンセル フレームワークでは、キャンセルとは、オブジェクトのキャンセルではなく操作のキャンセルのことを指します。  キャンセル要求とは、必要なクリーンアップの実行後にできるだけ早く操作を停止するようにという要求です。  1 つのキャンセル トークンは 1 つの "キャンセル可能な操作" を参照している必要がありますが、その操作がプログラムに実装されている場合があります。  トークンの <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティを `true` に設定した後に、`false` に再設定することはできません。  そのため、キャンセルが完了したキャンセル トークンを再利用することはできません。  
+  
+ オブジェクトのキャンセル機構が必要な場合は、<xref:System.Threading.CancellationToken.Register%2A?displayProperty=fullName> メソッドを呼び出すことにより、操作のキャンセル機構に基づいて実装できます。次に例を示します。  
+  
+ [!code-csharp[Cancellation#2](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/objectcancellation1.cs#2)]
+ [!code-vb[Cancellation#2](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/objectcancellation1.vb#2)]  
+  
+ キャンセル可能な複数の操作の同時処理がオブジェクトでサポートされている場合は、キャンセル可能な各操作への入力として別々のトークンを渡します。  こうすることで、他の操作には影響を与えずに 1 つの操作を取り消すことができます。  
+  
+## キャンセル要求のリッスンと応答  
+ キャンセル可能な操作の実装者は、ユーザー デリゲート内で、キャンセル要求に応じた操作の終了方法を決定します。  多くの場合、ユーザー デリゲートでは、必要なクリーンアップのみ実行してから、できるだけ早く制御を戻すことができます。  
+  
+ ただし、より複雑なケースでは、キャンセルが発生したことをユーザー デリゲートからライブラリ コードに通知する必要がある場合があります。  そのような場合、操作を終了するための正しい方法はユーザー デリゲートから <xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> メソッドを呼び出すことです。これにより、<xref:System.OperationCanceledException> がスローされます。  ライブラリ コードでは、ユーザー デリゲートのスレッドでこの例外をキャッチし、例外のトークンを調べて、この例外が連携によるキャンセルを示すのか、それ以外の例外的な状況を示すのかを判断できます。  
+  
+ <xref:System.Threading.Tasks.Task> クラスはこの方法で <xref:System.OperationCanceledException> を処理します。  詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」を参照してください。  
+  
+### ポーリングによるリッスン  
+ ループや再帰を伴う長時間にわたる計算では、<xref:System.Threading.CancellationToken.IsCancellationRequested%2A?displayProperty=fullName> プロパティの値を定期的にポーリングすることによってキャンセル要求をリッスンできます。  その値が `true` の場合、メソッドはできるだけ早くクリーンアップを行って終了する必要があります。  最適なポーリング間隔はアプリケーションの種類によって異なります。  プログラムごとに、最適なポーリング間隔を開発者が決定します。  ポーリング自体がパフォーマンスに大きく影響することはありません。  ポーリングを行う方法の 1 つの例を次に示します。  
+  
+ [!code-csharp[Cancellation#3](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex11.cs#3)]
+ [!code-vb[Cancellation#3](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex11.vb#3)]  
+  
+ さらに完全に近い例については、「[How to: Listen for Cancellation Requests by Polling](../../../docs/standard/threading/how-to-listen-for-cancellation-requests-by-polling.md)」を参照してください。  
+  
+### コールバックの登録によるリッスン  
+ 操作によっては、キャンセル トークンの値を定期的に確認できないことによりブロックされる場合があります。  そのような場合は、キャンセル要求を受け取ったときにメソッドのブロックを解除するコールバック メソッドを登録できます。  
+  
+ <xref:System.Threading.CancellationToken.Register%2A> メソッドは、特にこの目的のために使用される <xref:System.Threading.CancellationTokenRegistration> オブジェクトを返します。  <xref:System.Threading.CancellationToken.Register%2A> メソッドを使用して非同期 Web 要求を取り消す方法を次の例に示します。  
+  
+ [!code-csharp[Cancellation#4](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex4.cs#4)]
+ [!code-vb[Cancellation#4](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex4.vb#4)]  
+  
+ <xref:System.Threading.CancellationTokenRegistration> オブジェクトは、スレッドの同期を管理し、適切な時点でコールバックの実行を中止できるようにします。  
+  
+ システムの応答性を確保し、デッドロックを回避するには、コールバックの登録時に次のガイドラインに従ってください。  
+  
+-   コールバック メソッドは同期的に呼び出され、コールバックが戻るまで <xref:System.Threading.CancellationTokenSource.Cancel%2A> の呼び出しは戻りません。そのため、コールバック メソッドは高速に動作する必要があります。  
+  
+-   コールバックの実行中に <xref:System.Threading.CancellationTokenRegistration.Dispose%2A> を呼び出し、そのコールバックが待機しているロックを保持する場合は、プログラムのデッドロックが発生する可能性があります。  `Dispose` が戻った後に、コールバックで使用されていたすべてのリソースを解放してください。  
+  
+-   コールバックでは、手動によるスレッド処理を実行したり、<xref:System.Threading.SynchronizationContext> を使用したりしないでください。  特定のスレッドでコールバックを実行する必要がある場合は、<xref:System.Threading.CancellationTokenRegistration?displayProperty=fullName> コンストラクターを使用します。これにより、ターゲットの syncContext がアクティブな <xref:System.Threading.SynchronizationContext.Current%2A?displayProperty=fullName> であることを指定できます。  コールバックで手動によるスレッド処理を実行すると、デッドロックが発生する可能性があります。  
+  
+ さらに完全に近い例については、「[How to: Register Callbacks for Cancellation Requests](../../../docs/standard/threading/how-to-register-callbacks-for-cancellation-requests.md)」を参照してください。  
+  
+### 待機ハンドルを使用したリッスン  
+ <xref:System.Threading.ManualResetEvent?displayProperty=fullName> や <xref:System.Threading.Semaphore?displayProperty=fullName> などの同期プリミティブを待機している間、キャンセル可能な操作をブロックできる場合は、<xref:System.Threading.CancellationToken.WaitHandle%2A?displayProperty=fullName> プロパティを使用してその操作がイベントとキャンセル要求の両方を待機するようにできます。  キャンセル トークンの待機ハンドルは、キャンセル要求への応答としてシグナル状態になります。メソッドは <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドの戻り値を使用して、キャンセル トークンがシグナル状態であったかどうかを判断できます。  操作はその後、状況に合わせて、そのまま終了するか、<xref:System.OperationCanceledException> をスローします。  
+  
+ [!code-csharp[Cancellation#5](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex9.cs#5)]
+ [!code-vb[Cancellation#5](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex9.vb#5)]  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] を対象とする新しいコードでは、<xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> と <xref:System.Threading.SemaphoreSlim?displayProperty=fullName> はどちらも、`Wait` メソッドで新しいキャンセル フレームワークをサポートしています。  メソッドに <xref:System.Threading.CancellationToken> を渡すことができ、キャンセルが要求されると、イベントが起動して <xref:System.OperationCanceledException> がスローされます。  
+  
+ [!code-csharp[Cancellation#6](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex10.cs#6)]
+ [!code-vb[Cancellation#6](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex10.vb#6)]  
+  
+ さらに完全に近い例については、「[How to: Listen for Cancellation Requests That Have Wait Handles](../../../docs/standard/threading/how-to-listen-for-cancellation-requests-that-have-wait-handles.md)」を参照してください。  
+  
+### 同時に複数のトークンをリッスンする  
+ リスナーでは、複数のキャンセル トークンを同時にリッスンしなければならない場合もあります。  たとえば、キャンセル可能な操作で、メソッド パラメーターの引数として外部から渡されるトークンのほかに、内部のキャンセル トークンも監視する必要がある場合などです。  これを行うには、複数のトークンを 1 つのトークンに結合できるリンク トークン ソースを作成します。次に例を示します。  
+  
+ [!code-csharp[Cancellation#7](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex13.cs#7)]
+ [!code-vb[Cancellation#7](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex13.vb#7)]  
+  
+ 処理の終了後にリンク トークン ソースに対して `Dispose` を呼び出す必要があることに注意してください。  さらに完全に近い例については、「[How to: Listen for Multiple Cancellation Requests](../../../docs/standard/threading/how-to-listen-for-multiple-cancellation-requests.md)」を参照してください。  
+  
+## ライブラリ コードとユーザー コードの連携  
+ 統合キャンセル フレームワークでは、ライブラリ コードとユーザー コードを連携させ、どちらのコードからも他方のコードを取り消せるようにすることができます。  円滑な連携のためには、それぞれで以下のガイドラインに従う必要があります。  
+  
+-   ライブラリ コードでキャンセル可能な操作を提供する場合は、ユーザー コードからキャンセルを要求できるように、外部のキャンセル トークンを受け入れるパブリック メソッドも提供します。  
+  
+-   ライブラリ コードからユーザー コードを呼び出す場合は、ライブラリ コードで  OperationCanceledException\(externalToken\) を常にエラー例外として解釈するのではなく、*連携によるキャンセル*としても解釈するようにします。  
+  
+-   ユーザー デリゲートでは、ライブラリ コードからのキャンセル要求に定期的に応答するようにします。  
+  
+ <xref:System.Threading.Tasks.Task?displayProperty=fullName> および <xref:System.Linq.ParallelEnumerable?displayProperty=fullName> は、これらのガイドラインに従ったクラスの例です。  詳細については、「[Task Cancellation](../../../docs/standard/parallel-programming/task-cancellation.md)」および「[How to: Cancel a PLINQ Query](../../../docs/standard/parallel-programming/how-to-cancel-a-plinq-query.md)」を参照してください。  
+  
+## 参照  
+ [Managed Threading Basics](../../../docs/standard/threading/managed-threading-basics.md)
\ No newline at end of file
diff --git a/docs/standard/threading/countdownevent.md b/docs/standard/threading/countdownevent.md
new file mode 100644
index 00000000000..5cb8c11c996
--- /dev/null
+++ b/docs/standard/threading/countdownevent.md
@@ -0,0 +1,52 @@
+---
+title: "CountdownEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization primitives, CountdownEvent"
+ms.assetid: eec3812a-e20f-4ecd-bfef-6921d508b708
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# CountdownEvent
+<xref:System.Threading.CountdownEvent?displayProperty=fullName> は、一定回数シグナル状態になった後で、その待機スレッドのブロックを解除する同期プリミティブです。  <xref:System.Threading.CountdownEvent> は、イベントをシグナル状態にする前に手動で変数をデクリメントする必要があり、通常は <xref:System.Threading.ManualResetEvent> または <xref:System.Threading.ManualResetEventSlim> を使用するようなシナリオを想定して設計されています。  たとえば、fork\/join シナリオでは、シグナル カウントが 5 の <xref:System.Threading.CountdownEvent> を作成し、スレッド プールで 5 つの作業項目を開始して、各作業項目の完了時に <xref:System.Threading.CountdownEvent.Signal%2A> を呼び出すようにします。  <xref:System.Threading.CountdownEvent.Signal%2A> が呼び出されるたびに、シグナル カウントは 1 ずつ減少します。  メイン スレッドでは、シグナル カウントが 0 になるまで <xref:System.Threading.CountdownEvent.Wait%2A> の呼び出しがブロックされます。  
+  
+> [!NOTE]
+>  レガシ バージョンの .NET Framework の同期 API と対話する必要のないコードでは、より簡単な方法で fork\/join 並列化の表現を実現できる <xref:System.Threading.Tasks.Task?displayProperty=fullName> オブジェクトと <xref:System.Threading.Tasks.Parallel.Invoke%2A> メソッドのいずれかまたはその両方の使用を検討してください。  
+  
+ <xref:System.Threading.CountdownEvent> には、次のような追加機能があります。  
+  
+-   キャンセル トークンを使用して待機操作を取り消すことができます。  
+  
+-   インスタンスの作成後にシグナル カウントをインクリメントできます。  
+  
+-   <xref:System.Threading.CountdownEvent.Reset%2A> メソッドの呼び出しによって <xref:System.Threading.CountdownEvent.Wait%2A> から戻った後に、インスタンスを再利用できます。  
+  
+-   インスタンスは <xref:System.Threading.WaitHandle> を公開するため、<xref:System.Threading.WaitHandle.WaitAll%2A> などの他の .NET Framework 同期 API と統合できます。  
+  
+## 基本的な使用法  
+ <xref:System.Threading.ThreadPool> 作業項目と共に <xref:System.Threading.CountdownEvent> を使用する方法を次の例に示します。  
+  
+ [!code-csharp[CDS_CountdownEvent#01](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_countdownevent/cs/countdownevent.cs#01)]
+ [!code-vb[CDS_CountdownEvent#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_countdownevent/vb/module1.vb#01)]  
+  
+## キャンセルを有効にした CountdownEvent  
+ キャンセル トークンを使用して <xref:System.Threading.CountdownEvent> に対する待機操作を取り消す方法を次の例に示します。  基本的なパターンは、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] で導入された統合キャンセルのモデルに従っています。  詳細については、「[Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)」を参照してください。  
+  
+ [!code-csharp[CDS_CountdownEvent#02](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_countdownevent/cs/countdownevent.cs#02)]
+ [!code-vb[CDS_CountdownEvent#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_countdownevent/vb/canceleventwait.vb#02)]  
+  
+ 待機操作が、そのシグナル状態を設定するスレッドを取り消しているのではない点に注意してください。  通常、キャンセルは論理的な操作に対して適用されます。これには、イベントの待機と、その待機によって同期されるすべての作業項目が含まれることがあります。  この例では、作業項目がキャンセル要求に応答できるように、同一のキャンセル トークンのコピーが各作業項目に渡されます。  
+  
+## 参照  
+ [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)
\ No newline at end of file
diff --git a/docs/standard/threading/creating-threads-and-passing-data-at-start-time.md b/docs/standard/threading/creating-threads-and-passing-data-at-start-time.md
new file mode 100644
index 00000000000..f5ea8bbf347
--- /dev/null
+++ b/docs/standard/threading/creating-threads-and-passing-data-at-start-time.md
@@ -0,0 +1,64 @@
+---
+title: "Creating Threads and Passing Data at Start Time | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], creating"
+  - "threading [.NET Framework], passing data to threads"
+  - "threading [.NET Framework], retrieving data from threads"
+ms.assetid: 52b32222-e185-4f42-91a7-eaca65c0ab6d
+caps.latest.revision: 18
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 18
+---
+# Creating Threads and Passing Data at Start Time
+オペレーティング システム プロセスが作成されると、オペレーティング システムは、元のアプリケーション ドメインを含め、そのプロセスにコードを実行するためのスレッドを挿入します。  その時点からは、アプリケーション ドメインを作成したり、破棄したりする場合に、必ずしもオペレーティング システム スレッドを作成したり、破棄したりする必要はありません。  実行されているコードがマネージ コードの場合は、<xref:System.Threading.Thread> 型の静的な <xref:System.Threading.Thread.CurrentThread%2A> プロパティを取得すると、現在のアプリケーション ドメインで実行しているスレッドの <xref:System.Threading.Thread> オブジェクトを取得できます。  このトピックでは、スレッドの作成について説明し、データをスレッド プロシージャに渡す代替手段について説明します。  
+  
+## スレッドの作成  
+ <xref:System.Threading.Thread> オブジェクトを作成すると、新しいマネージ スレッドが作成されます。  <xref:System.Threading.Thread> クラスには <xref:System.Threading.ThreadStart> デリゲートまたは <xref:System.Threading.ParameterizedThreadStart> デリゲートを受け取るコンストラクターがあり、このデリゲートは <xref:System.Threading.Thread.Start%2A> メソッドを呼び出す際に新しいスレッドが呼び出すメソッドをラップします。  <xref:System.Threading.Thread.Start%2A> を複数回呼び出すと、<xref:System.Threading.ThreadStateException> がスローされます。  
+  
+ <xref:System.Threading.Thread.Start%2A> メソッドは即座に制御を返すため、新しいスレッドが開始される前に制御が戻ることも少なくありません。  <xref:System.Threading.Thread.ThreadState%2A> プロパティと <xref:System.Threading.Thread.IsAlive%2A> プロパティを使用すると、任意の時点のスレッドの状態を特定できますが、この 2 つのプロパティは、スレッドの活動を同期するために使用すべきではありません。  
+  
+> [!NOTE]
+>  スレッドが開始した後は、<xref:System.Threading.Thread> オブジェクトへの参照を保持する必要はありません。  スレッドの実行は、スレッド プロシージャが終了するまで継続します。  
+  
+ 別のオブジェクトでインスタンス メソッドと静的メソッドを呼び出すために 2 つの新しいスレッドを作成するコード例を次に示します。  
+  
+ [!code-cpp[System.Threading.ThreadStart2#2](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CPP/source2.cpp#2)]
+ [!code-csharp[System.Threading.ThreadStart2#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CS/source2.cs#2)]
+ [!code-vb[System.Threading.ThreadStart2#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Threading.ThreadStart2/VB/source2.vb#2)]  
+  
+## スレッドにデータを渡し、スレッドからデータを取得する  
+ .NET Framework Version 2.0 では、<xref:System.Threading.Thread.Start%2A?displayProperty=fullName> メソッド オーバーロードを呼び出す際に <xref:System.Threading.ParameterizedThreadStart> デリゲートによってデータを含むオブジェクトをスレッドに簡単に渡すことができます。  コード例については、<xref:System.Threading.ParameterizedThreadStart> を参照してください。  
+  
+ <xref:System.Threading.ParameterizedThreadStart> デリゲートの使用は、<xref:System.Threading.Thread.Start%2A?displayProperty=fullName> メソッドのオーバーロードが任意のオブジェクトを受け入れるため、タイプ セーフなデータ伝達方法ではありません。  代わりに、スレッド プロシージャとデータをヘルパー クラスにカプセル化し、<xref:System.Threading.ThreadStart> デリゲートを使用してスレッド プロシージャを実行します。  この方法を次の 2 つのコード例に示します。  
+  
+ 非同期呼び出しからデータを返す場所はないため、どちらのデリゲートにも戻り値はありません。  スレッド メソッドの結果を取得するには、コールバック メソッドを使用できます。以下の 2 番目のコードで、その例を示します。  
+  
+ [!code-cpp[System.Threading.ThreadStart2#3](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CPP/source3.cpp#3)]
+ [!code-csharp[System.Threading.ThreadStart2#3](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CS/source3.cs#3)]
+ [!code-vb[System.Threading.ThreadStart2#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Threading.ThreadStart2/VB/source3.vb#3)]  
+  
+### コールバック メソッドによるデータの取得  
+ スレッドからデータを取得するコールバック メソッドの例を次に示します。  データとスレッド メソッドを含むクラスのコンストラクターは、コールバック メソッドを表すデリゲートも受け取ります。スレッド メソッドの最後で、コールバック デリゲートを呼び出します。  
+  
+ [!code-cpp[System.Threading.ThreadStart2#4](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CPP/source4.cpp#4)]
+ [!code-csharp[System.Threading.ThreadStart2#4](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Threading.ThreadStart2/CS/source4.cs#4)]
+ [!code-vb[System.Threading.ThreadStart2#4](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Threading.ThreadStart2/VB/source4.vb#4)]  
+  
+## 参照  
+ <xref:System.Threading.Thread>   
+ <xref:System.Threading.ThreadStart>   
+ <xref:System.Threading.ParameterizedThreadStart>   
+ <xref:System.Threading.Thread.Start%2A?displayProperty=fullName>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)
\ No newline at end of file
diff --git a/docs/standard/threading/destroying-threads.md b/docs/standard/threading/destroying-threads.md
new file mode 100644
index 00000000000..89e428c0fe8
--- /dev/null
+++ b/docs/standard/threading/destroying-threads.md
@@ -0,0 +1,73 @@
+---
+title: "Destroying Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "destroying threads"
+  - "threading [.NET Framework], destroying threads"
+ms.assetid: df54e648-c5d1-47c9-bd29-8e4438c1db6d
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Destroying Threads
+マネージ スレッドを完全に停止するには、<xref:System.Threading.Thread.Abort%2A> メソッドを使用します。  <xref:System.Threading.Thread.Abort%2A> を呼び出すと、共通言語ランタイムが対象スレッドに <xref:System.Threading.ThreadAbortException> をスローします。対象スレッドはこの例外をキャッチできます。  詳細については、「<xref:System.Threading.Thread.Abort%2A?displayProperty=fullName>」を参照してください。  
+  
+> [!NOTE]
+>  スレッドがアンマネージ コードを実行しているときに、その <xref:System.Threading.Thread.Abort%2A> メソッドが呼び出された場合、ランタイムはスレッドを <xref:System.Threading.ThreadState?displayProperty=fullName> とマークします。  スレッドがマネージ コードに戻ると例外がスローされます。  
+  
+ スレッドは、一度アボートされると、再起動できません。  
+  
+ <xref:System.Threading.Thread.Abort%2A> メソッドを呼び出しても、対象スレッドは <xref:System.Threading.ThreadAbortException> をキャッチし、`finally` ブロック内の任意の量のコードを実行できるため、すぐには中止されません。  スレッドが終了するまで待機する必要がある場合は、<xref:System.Threading.Thread.Join%2A?displayProperty=fullName> を呼び出すことができます。  <xref:System.Threading.Thread.Join%2A?displayProperty=fullName> はブロッキング呼び出しで、スレッドが実際に実行を停止するか、オプションのタイムアウト間隔が経過するまで制御が戻りません。  中止されたスレッドは、<xref:System.Threading.Thread.ResetAbort%2A> メソッドを呼び出したり、`finally` ブロックで非バインド処理を実行したりする可能性があります。そのため、タイムアウトを指定していない場合、待機の終了は保証されません。  
+  
+ <xref:System.Threading.Thread.Join%2A?displayProperty=fullName> メソッドの呼び出しを待機しているスレッドは、<xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> を呼び出す他のスレッドによって中断される可能性があります。  
+  
+## ThreadAbortException の処理  
+ 独自のコードから <xref:System.Threading.Thread.Abort%2A> を呼び出した結果、またはスレッドが動作しているアプリケーション ドメインをアンロード \(<xref:System.AppDomain.Unload%2A?displayProperty=fullName> は <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> を使用してスレッドを終了します\) した結果としてスレッドが中止されるようにする場合、スレッドは、次のコードに示すように <xref:System.Threading.ThreadAbortException> を処理し、`finally` 句の最終処理を実行する必要があります。  
+  
+```vb  
+Try  
+    ' Code that is executing when the thread is aborted.  
+Catch ex As ThreadAbortException  
+    ' Clean-up code can go here.  
+    ' If there is no Finally clause, ThreadAbortException is  
+    ' re-thrown by the system at the end of the Catch clause.   
+Finally  
+    ' Clean-up code can go here.  
+End Try  
+' Do not put clean-up code here, because the exception   
+' is rethrown at the end of the Finally clause.  
+```  
+  
+```csharp  
+try   
+{  
+    // Code that is executing when the thread is aborted.  
+}   
+catch (ThreadAbortException ex)   
+{  
+    // Clean-up code can go here.  
+    // If there is no Finally clause, ThreadAbortException is  
+    // re-thrown by the system at the end of the Catch clause.   
+}  
+// Do not put clean-up code here, because the exception   
+// is rethrown at the end of the Finally clause.  
+```  
+  
+ `finally` 句の末尾、または `finally` 句が存在しない場合は `catch` 句の末尾で、<xref:System.Threading.ThreadAbortException> がシステムによって再スローされるため、`catch` 句または `finally` 句にクリーンアップ コードを配置する必要があります。  
+  
+ この例外をシステムが再スローしないようにするには、<xref:System.Threading.Thread.ResetAbort%2A?displayProperty=fullName> メソッドを呼び出します。  ただし、この操作は、独自のコードが原因で <xref:System.Threading.ThreadAbortException> が生成された場合に限定する必要があります。  
+  
+## 参照  
+ <xref:System.Threading.ThreadAbortException>   
+ <xref:System.Threading.Thread>   
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)
\ No newline at end of file
diff --git a/docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md b/docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md
new file mode 100644
index 00000000000..92f4887a6a5
--- /dev/null
+++ b/docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md
@@ -0,0 +1,51 @@
+---
+title: "EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "wait handles"
+  - "threading [.NET Framework], EventWaitHandle class"
+  - "event wait handles [.NET Framework]"
+ms.assetid: cd94fc34-ac15-427f-b723-a1240a4fab7d
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent
+イベント待機ハンドルにより、スレッドは相互に通知を行い、相手の通知を待機して動作を同期できます。  これらの同期イベントは Win32 待機ハンドルに基づいており、通知されたときに自動的にリセットされるイベントと手動でリセットするイベントの 2 種類に分けられます。  
+  
+ イベント待機ハンドルは、<xref:System.Threading.Monitor> クラスと同様の多くの同期シナリオで有効です。  イベント待機ハンドルは、多くの場合、<xref:System.Threading.Monitor.Wait%2A?displayProperty=fullName> メソッドや <xref:System.Threading.Monitor.Pulse%2A?displayProperty=fullName> メソッドよりも簡単に使用でき、通知をより細かく制御できます。  名前付きイベント待機ハンドルは、アプリケーション ドメイン間やプロセス間で動作を同期させるためにも使用できます。これに対し、モニターはアプリケーション ドメインに対してローカルです。  
+  
+## このセクションの内容  
+ [EventWaitHandle](../../../docs/standard/threading/eventwaithandle.md)  
+ <xref:System.Threading.EventWaitHandle> クラスは、自動または手動のリセット イベントを表します。また、ローカル イベントまたは名前付きシステム イベントのいずれかです。  
+  
+ [AutoResetEvent](../../../docs/standard/threading/autoresetevent.md)  
+ <xref:System.Threading.AutoResetEvent> クラスは <xref:System.Threading.EventWaitHandle> から派生し、自動的にリセットされるローカル イベントを表します。  
+  
+ [ManualResetEvent and ManualResetEventSlim](../../../docs/standard/threading/manualresetevent-and-manualreseteventslim.md)  
+ <xref:System.Threading.ManualResetEvent> クラスは <xref:System.Threading.EventWaitHandle> から派生し、手動でリセットする必要があるローカル イベントを表します。  <xref:System.Threading.ManualResetEventSlim> クラスは、同じプロセス内のイベントに使用できる軽量でさらに高速なバージョンです。  
+  
+ [CountdownEvent](../../../docs/standard/threading/countdownevent.md)  
+ <xref:System.Threading.CountdownEvent> クラスは、待機ハンドルを使用するコードで fork\/join 並列化パターンを実装する簡単な方法を提供します。  
+  
+## 関連項目  
+ [Wait Handles](../Topic/Wait%20Handles.md)  
+ <xref:System.Threading.WaitHandle> クラスは、<xref:System.Threading.EventWaitHandle>、<xref:System.Threading.Semaphore>、および <xref:System.Threading.Mutex> クラスの基本クラスです。  すべての種類の待機ハンドルを使用する場合に役立つ <xref:System.Threading.WaitHandle.SignalAndWait%2A> や <xref:System.Threading.WaitHandle.WaitAll%2A> などの静的メソッドを含みます。  
+  
+## 参照  
+ <xref:System.Threading.EventWaitHandle>   
+ <xref:System.Threading.WaitHandle>   
+ <xref:System.Threading.AutoResetEvent>   
+ <xref:System.Threading.ManualResetEvent>   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [Managed Threading Basics](../../../docs/standard/threading/managed-threading-basics.md)
\ No newline at end of file
diff --git a/docs/standard/threading/eventwaithandle.md b/docs/standard/threading/eventwaithandle.md
new file mode 100644
index 00000000000..3e02862957f
--- /dev/null
+++ b/docs/standard/threading/eventwaithandle.md
@@ -0,0 +1,74 @@
+---
+title: "EventWaitHandle | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], EventWaitHandle class"
+  - "EventWaitHandle class"
+  - "event wait handles [.NET Framework]"
+  - "threading [.NET Framework], cross-process synchronization"
+ms.assetid: 11ee0b38-d663-4617-b793-35eb6c64e9fc
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# EventWaitHandle
+<xref:System.Threading.EventWaitHandle> クラスを使用すると、スレッドは通知および通知の待機により、互いに通信できます。  イベント待機ハンドル \(単にイベントとも呼ばれます\) は、通知を受けて、1 つ以上の待機中のイベントを解放できる待機ハンドルです。  通知を受けると、イベント待機ハンドルは手動または自動でリセットされます。  <xref:System.Threading.EventWaitHandle> クラスは、ローカルのイベント待機ハンドル \(ローカル イベント\) または名前付きのシステム イベント待機ハンドル \(名前付きのイベントまたはシステム イベント。すべてのプロセスから参照できます\) を表すことができます。  
+  
+> [!NOTE]
+>  イベント待機ハンドルは、通常 .NET Framework でイベントと呼ばれるものとは異なります。  デリゲートやイベント ハンドラーは関連していません。  "イベント" という言葉で説明されているのは、それらがこれまでオペレーティング システム イベントと呼ばれており、待機ハンドルの通知はイベントが発生した待機中のスレッドを示すためです。  
+  
+ ローカル イベント待機ハンドルと名前付きイベント待機ハンドルはどちらも、システム同期オブジェクトを使用します。これは <xref:Microsoft.Win32.SafeHandles.SafeWaitHandle> ラッパーによって保護されており、リソースが確実に解放されるようにします。  <xref:System.Threading.WaitHandle.System%23IDisposable%23Dispose%2A> メソッドを使用すると、オブジェクトを使い終わったらすぐにリソースを解放できます。  
+  
+## 自動的にリセットされるイベント待機ハンドル  
+ 自動リセット イベントを作成するには、<xref:System.Threading.EventWaitHandle> オブジェクトを作成するときに <xref:System.Threading.EventResetMode?displayProperty=fullName> を指定します。  その名前が示すとおり、この同期イベントは通知を受けたときに、単一の待機中のスレッドを解放した後、に自動的にリセットされます。  イベントを通知するには、その <xref:System.Threading.EventWaitHandle.Set%2A> メソッドを呼び出します。  
+  
+ 通常、自動リセット イベントは、単一のスレッドのリソースに一度に排他アクセスを提供するために使用されます。  スレッドは、<xref:System.Threading.WaitHandle.WaitOne%2A> メソッドを呼び出してリソースを要求します。  他のスレッドに待機ハンドルがない場合、メソッドは `true` を返し、呼び出し元スレッドはリソースの制御権を持ちます。  
+  
+> [!IMPORTANT]
+>  あらゆる同期機構と同様に、すべてのコード パスが適切な待機ハンドルを待ってから、保護されているリソースにアクセスする必要があります。  スレッドの同期は連携しています。  
+  
+ 自動リセット イベントが通知を受けたとき、大気中のスレッドがない場合は、スレッドが待機中になるまでシグナル状態のままです。  イベントはスレッドを解放してすぐにリセットされ、以降のスレッドをブロックします。  
+  
+## 手動でリセットされるイベント待機ハンドル  
+ 手動リセット イベントを作成するには、<xref:System.Threading.EventWaitHandle> オブジェクトを作成するときに <xref:System.Threading.EventResetMode?displayProperty=fullName> を指定します。  その名前が示すとおり、この同期イベントは、通知を受けた後に手動でリセットする必要があります。  <xref:System.Threading.EventWaitHandle.Reset%2A> メソッドを呼び出してリセットするまで、イベント ハンドルを待っているスレッドはすぐに続行され、ブロックされません。  
+  
+ 手動リセット イベントは、家畜を囲うゲートのように動作します。  イベントが通知を受けないと、待機中のスレッドは柵の中の馬のようにブロックされます。  イベントが通知を受けると、その <xref:System.Threading.EventWaitHandle.Set%2A> メソッドを呼び出して、すべての待機中のスレッドは続行できます。  イベントは、その <xref:System.Threading.EventWaitHandle.Reset%2A> メソッドが呼び出されるまで、シグナル状態のままです。  これにより、手動リセット イベントは、1 つのスレッドがタスクを終えるまで待機させる必要のあるスレッドを保持する理想的な方法となっています。  
+  
+ 馬が柵を出るのと同様に、解放されたスレッドがオペレーティング システムによってスケジュールされ、実行が再開されるには時間がかかります。  すべてのスレッドの実行が再開される前に <xref:System.Threading.EventWaitHandle.Reset%2A> メソッドが呼び出された場合、残りのスレッドは再びブロックされます。  再開されるスレッドとブロックされるスレッドは、システムのロード、スケジューラを待っているスレッドの数など、ランダムな要素によって異なります。  イベントを通知したスレッドが通知後に終了した場合 \(これは最も一般的な使用パターンです\)、これは問題ではありません。  すべての待機中のスレッドが再開された後で、イベントを通知したスレッドに新しいタスクを開始させる場合は、すべての待機中のスレッドが再開されるまで、そのスレッドをブロックする必要があります。  それ以外の場合は競合状態で、コードの動作は予測できません。  
+  
+## 自動イベントと手動イベントの共通の機能  
+ 通常、ブロックされていないスレッドが <xref:System.Threading.EventWaitHandle.Set%2A> メソッドを呼び出して、いずれかの待機中のスレッド \(自動リセット イベントの場合\) またはそれらすべて \(手動リセット イベントの場合\) を解放するまで、1 つ以上のスレッドが <xref:System.Threading.EventWaitHandle> でブロックします。  スレッドは、静的な <xref:System.Threading.WaitHandle.SignalAndWait%2A?displayProperty=fullName> メソッドを呼び出すことにより、<xref:System.Threading.EventWaitHandle> の通知とブロックを分割できない操作として行うことができます。  
+  
+ <xref:System.Threading.EventWaitHandle> オブジェクトは、静的な <xref:System.Threading.WaitHandle.WaitAll%2A?displayProperty=fullName> および <xref:System.Threading.WaitHandle.WaitAny%2A?displayProperty=fullName> メソッドと共に使用できます。  <xref:System.Threading.EventWaitHandle> および <xref:System.Threading.Mutex> クラスはいずれも <xref:System.Threading.WaitHandle> から派生するため、両方のクラスをこれらのメソッドで使用できます。  
+  
+### 名前付きのイベント  
+ Windows オペレーティング システムでは、イベント待機ハンドルに名前を付けることができます。  名前付きのイベントはシステム全体で使用されます。  つまり、いったん名前付きのイベントを作成すると、すべてのプロセスのすべてのスレッドがそれを参照できます。  したがって、名前付きのイベントを使用して、スレッドだけでなくプロセスのアクティビティも同期できます。  
+  
+ 名前付きのシステム イベントを表す <xref:System.Threading.EventWaitHandle> オブジェクトを作成するには、イベントの名前を指定するいずれかのコンストラクターを使用します。  
+  
+> [!NOTE]
+>  名前付きのイベントはシステム全体で使用されるため、複数の <xref:System.Threading.EventWaitHandle> オブジェクトで同じ名前付きイベントを表すことができます。  コンストラクターまたは <xref:System.Threading.EventWaitHandle.OpenExisting%2A> メソッドを呼び出すたびに、新しい <xref:System.Threading.EventWaitHandle> オブジェクトが作成されます。  同じ名前を繰り返し指定すると、同じ名前付きイベントを表す複数のオブジェクトを作成できます。  
+  
+ 名前付きのイベントを使用する際には注意が必要です。  それらはシステム全体で使用されるので、別のプロセスが同じ名前を使用すると、スレッドが予期せずにブロックされる場合があります。  悪意のあるコードが同じコンピューターで実行されると、サービス拒否攻撃の基本としてこれが使用される場合があります。  
+  
+ アクセス制御セキュリティを使用して、名前付きのイベントを表す <xref:System.Threading.EventWaitHandle> オブジェクトを保護します。可能であれば <xref:System.Security.AccessControl.EventWaitHandleSecurity> オブジェクトを指定するコンストラクターを使用します。  また、<xref:System.Threading.EventWaitHandle.SetAccessControl%2A> メソッドを使用してアクセス制御セキュリティを適用できます。ただし、こうすると、イベント待機ハンドルが作成されてから保護されるまでの間に、脆弱性が生じます。  アクセス制御セキュリティでイベントを保護すると、悪意のある攻撃を防ぐのに役立ちますが、予期しない名前の衝突の問題解決にはなりません。  
+  
+> [!NOTE]
+>  <xref:System.Threading.EventWaitHandle> クラスとは異なり、派生したクラスである <xref:System.Threading.AutoResetEvent> および <xref:System.Threading.ManualResetEvent> は、ローカルの待機ハンドルのみを表すことができます。  名前付きのシステム イベントを表すことはできません。  
+  
+## 参照  
+ <xref:System.Threading.EventWaitHandle>   
+ <xref:System.Threading.WaitHandle>   
+ <xref:System.Threading.AutoResetEvent>   
+ <xref:System.Threading.ManualResetEvent>   
+ [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)
\ No newline at end of file
diff --git a/docs/standard/threading/exceptions-in-managed-threads.md b/docs/standard/threading/exceptions-in-managed-threads.md
new file mode 100644
index 00000000000..67bba9bf6a4
--- /dev/null
+++ b/docs/standard/threading/exceptions-in-managed-threads.md
@@ -0,0 +1,86 @@
+---
+title: "Exceptions in Managed Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "unhandled exceptions,in managed threads"
+  - "threading [.NET Framework],unhandled exceptions"
+  - "threading [.NET Framework],exceptions in managed threads"
+  - "managed threading"
+ms.assetid: 11294769-2e89-43cb-890e-ad4ad79cfbee
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Exceptions in Managed Threads
+.NET Framework のバージョン 2.0 以降では、共通言語ランタイムはスレッド内のほとんどの未処理の例外をそのまま続行させます。  ほとんどの場合、これは未処理の例外によってアプリケーションが終了することを意味します。  
+  
+> [!NOTE]
+>  これは、スレッド プールのスレッド内での未処理の例外など、多数の未処理の例外に関する安全策を提供している、.NET Framework Version 1.0 および 1.1 からの重要な変更です。  このトピックの「[以前のバージョンからの変更](#ChangeFromPreviousVersions)」を参照してください。  
+  
+ 共通言語ランタイムには、プログラム フローの制御に使用する特定の未処理の例外について、次のような安全策が用意されています。  
+  
+-   <xref:System.Threading.Thread.Abort%2A> が呼び出されると、スレッドで <xref:System.Threading.ThreadAbortException> がスローされる。  
+  
+-   スレッドが実行中のアプリケーション ドメインがアンロードされると、スレッドで <xref:System.AppDomainUnloadedException> がスローされます。  
+  
+-   共通言語ランタイムまたはホスト プロセスは、内部例外をスローすることによってスレッドを終了します。  
+  
+ 共通言語ランタイムによって作成されたスレッドでこれらの例外が処理されない場合、その例外によってスレッドは終了しますが、共通言語ランタイムは例外を続行させません。  
+  
+ メイン スレッドまたはアンマネージ コードからランタイムに入ったスレッドでこれらの例外が処理されない場合、例外は通常どおり続行するため、アプリケーションが終了します。  
+  
+> [!NOTE]
+>  マネージ コードが例外ハンドラーをインストールする機会を得る前に、ランタイムは未処理の例外をスローできます。  マネージ コードにこのような例外を処理する機会がない場合でも、例外を続行させることができます。  
+  
+## 開発時におけるスレッド処理の問題の露呈  
+ アプリケーションを終了せずに、スレッドが暗黙に失敗したまま放置されていると、プログラミングの深刻な問題が検出されない状態になる可能性があります。  長期間実行されるサービスや他のアプリケーションでは、これは特に問題となります。  スレッドが失敗すると、プログラムの状態が徐々に破損します。  アプリケーションのパフォーマンスが低下する場合もあれば、アプリケーションがハングする場合もあります。  
+  
+ スレッド内で未処理の例外を続行させておき、結果としてオペレーティング システムにそのプログラムを終了させることで、開発およびテスト中にこのような問題が明らかになります。  プログラムの終了に関するエラー報告はデバッグをサポートします。  
+  
+<a name="ChangeFromPreviousVersions"></a>   
+## 以前のバージョンからの変更  
+ 最も重要な変更は、マネージ スレッドに関する変更です。  .NET Framework Version 1.0 および 1.1 では、共通言語ランタイムには、次の状況での未処理の例外に関する安全策が用意されています。  
+  
+-   スレッド プールのスレッドの未処理の例外は存在しません。  タスクが例外をスローし、その例外が処理されない場合、ランタイムは例外のスタック トレースをコンソールに出力し、スレッドをスレッド プールに戻します。  
+  
+-   <xref:System.Threading.Thread> クラスの <xref:System.Threading.Thread.Start%2A> メソッドで作成されたスレッドの未処理の例外は存在しません。  このようなスレッド上で実行中のコードが例外をスローし、その例外が処理されない場合、ランタイムは例外のスタック トレースをコンソールに出力し、スレッドを適切に終了します。  
+  
+-   ファイナライザー スレッドの未処理の例外は存在しません。  ファイナライザーが例外をスローし、その例外が処理されない場合、ランタイムは例外のスタック トレースをコンソールに出力し、ファイナライザー スレッドがファイナライザーの実行を再開できるようにします。  
+  
+ マネージ スレッドのフォアグラウンドまたはバックグラウンドのステータスは、この動作に影響しません。  
+  
+ アンマネージ コードで作成されたスレッドの未処理の例外の場合、微妙な相違点があります。  ランタイムの JIT アタッチ ダイアログは、ネイティブ コードを通ってきたスレッド内でのマネージ例外またはネイティブ例外に関する、オペレーティング システム ダイアログより優先されます。  プロセスは常に終了します。  
+  
+### コードの移行  
+ 通常は、この変更によってこれまでに認識されていないプログラミングの問題が明らかになるため、問題を修正できます。  ただし、プログラマがランタイムの安全策 \(スレッドを終了するなど\) を利用する場合もあります。  状況によっては、プログラマは次の移行方法のいずれかを検討する必要があります。  
+  
+-   シグナルを受信したときに、スレッドが適切に終了するようにコードを再構築します。  
+  
+-   <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> メソッドを使用して、スレッドを中止します。  
+  
+-   プロセスを終了できるように、スレッドを中止する必要がある場合は、スレッドをバックグラウンド スレッドにして、プロセス終了時にスレッドが自動的に終了するようにします。  
+  
+ どのような場合でも、方法は例外に関するデザイン ガイドラインに従う必要があります。  「[例外のデザイン ガイドライン](../../../docs/standard/design-guidelines/exceptions.md)」を参照してください。  
+  
+### アプリケーション互換性フラグ  
+ 一時的な互換性対策として、管理者はアプリケーション構成ファイルの `<runtime>` セクションに互換性フラグを配置できます。  これにより、共通言語ランタイムを Version 1.0 および 1.1 の動作に戻すことができます。  
+  
+```  
+<legacyUnhandledExceptionPolicy enabled="1"/>  
+```  
+  
+## ホストのオーバーライド  
+ .NET Framework Version 2.0 では、アンマネージ ホストはホスト API の [ICLRPolicyManager](../../../ocs/framework/unmanaged-api/hosting/iclrpolicymanager-interface.md) インターフェイスを使用して、共通言語ランタイムの既定の未処理の例外ポリシーをオーバーライドできます。  [ICLRPolicyManager::SetUnhandledExceptionPolicy](../Topic/ICLRPolicyManager::SetUnhandledExceptionPolicy%20Method.md) 関数を使用して、未処理の例外のポリシーを設定します。  
+  
+## 参照  
+ [Managed Threading Basics](../../../docs/standard/threading/managed-threading-basics.md)
\ No newline at end of file
diff --git a/docs/standard/threading/foreground-and-background-threads.md b/docs/standard/threading/foreground-and-background-threads.md
new file mode 100644
index 00000000000..4d82e32c9a4
--- /dev/null
+++ b/docs/standard/threading/foreground-and-background-threads.md
@@ -0,0 +1,42 @@
+---
+title: "Foreground and Background Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], foreground"
+  - "threading [.NET Framework], background"
+  - "foreground threads"
+  - "background threads"
+ms.assetid: cfe0d632-dd35-47e0-91ad-f742a444005e
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Foreground and Background Threads
+マネージ スレッドは、バックグラウンド スレッドかフォアグラウンド スレッドのどちらかです。  バックグラウンド スレッドは、マネージ実行環境を実行されたままにしない点を除き、フォアグラウンド スレッドと同じです。  すべてのフォアグラウンド スレッドがマネージ プロセス \(.exe ファイルがマネージ アセンブリであるプロセス\) で停止されると、システムはすべてのバックグラウンド スレッドを停止し、シャットダウンします。  
+  
+> [!NOTE]
+>  プロセスの終了によってランタイムがバックグラウンド スレッドを停止する場合、スレッドで例外はスローされません。  ただし、<xref:System.AppDomain.Unload%2A?displayProperty=fullName> メソッドがアプリケーション ドメインをアンロードしたためにスレッドが停止する場合、フォアグラウンドとバックグラウンドの両方のスレッドで <xref:System.Threading.ThreadAbortException> がスローされます。  
+  
+ スレッドがバックグラウンド スレッドかフォアグランド スレッドかを特定したり、その状態を変更したりするには、<xref:System.Threading.Thread.IsBackground%2A?displayProperty=fullName> プロパティを使用します。  <xref:System.Threading.Thread.IsBackground%2A> プロパティを `true` に設定すると、スレッドをいつでもバックグラウンド スレッドに変更できます。  
+  
+> [!IMPORTANT]
+>  スレッドの状態 \(フォアグランドまたはバックグラウンド\) は、スレッドで処理されない例外の結果には影響しません。  .NET Framework Version 2.0 では、フォアグランド スレッドまたはバックグラウンド スレッドで処理されない例外が発生すると、アプリケーションが終了します。  「[Exceptions in Managed Threads](../../../docs/standard/threading/exceptions-in-managed-threads.md)」を参照してください。  
+  
+ マネージ スレッド プールに属しているスレッド \(つまり、<xref:System.Threading.Thread.IsThreadPoolThread%2A> プロパティが `true` のスレッド\) はバックグラウンド スレッドです。  アンマネージ コードからマネージ実行環境に入るすべてのスレッドは、バックグラウンド スレッドとしてマークされます。  新しい <xref:System.Threading.Thread> オブジェクトを作成および起動して生成されたすべてのスレッドは、既定でフォアグラウンド スレッドです。  
+  
+ ソケット接続などの動作を監視するためにスレッドを使用する場合、スレッドによってプロセスが終了しないように、<xref:System.Threading.Thread.IsBackground%2A> プロパティを `true` に設定します。  
+  
+## 参照  
+ <xref:System.Threading.Thread.IsBackground%2A?displayProperty=fullName>   
+ <xref:System.Threading.Thread>   
+ <xref:System.Threading.ThreadAbortException>
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-enable-thread-tracking-mode-in-spinlock.md b/docs/standard/threading/how-to-enable-thread-tracking-mode-in-spinlock.md
new file mode 100644
index 00000000000..8986aac268e
--- /dev/null
+++ b/docs/standard/threading/how-to-enable-thread-tracking-mode-in-spinlock.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Enable Thread-Tracking Mode in SpinLock | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "SpinLock, how to enable thread-tracking"
+ms.assetid: 62ee2e68-0bdd-4869-afc9-f0a57a11ae01
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Enable Thread-Tracking Mode in SpinLock
+<xref:System.Threading.SpinLock?displayProperty=fullName> は、待機時間が非常に短いシナリオに使用できる下位レベルの相互排他ロックです。  <xref:System.Threading.SpinLock> は再入不可能です。  スレッドがロックに入った後、再入するには、まず適切にロックを終了する必要があります。  通常、ロックに再入しようとするとデッドロックが発生します。デッドロックのデバッグは非常に困難な場合があります。  開発が簡単になるように、<xref:System.Threading.SpinLock?displayProperty=fullName> はスレッド追跡モードをサポートしています。このモードでは、スレッドが既に保持しているロックに再入しようとすると例外がスローされます。  これにより、ロックを適切に終了しなかったポイントを簡単に特定できるようになります。  スレッド追跡モードを有効にするには、ブール型の入力パラメーターを受け取る <xref:System.Threading.SpinLock> コンストラクターを使用し、引数として `true` を渡します。  開発段階およびテスト段階が完了した後は、パフォーマンスが向上するようにスレッド追跡モードを無効にしてください。  
+  
+## 使用例  
+ スレッド追跡モードの例を次に示します。  ロックを適切に終了する行は、コーディング エラーをシミュレートするためにコメント アウトされています。このエラーの結果は、次のいずれかになります。  
+  
+-   引数に `true` \(Visual Basic では `True`\) を使用して <xref:System.Threading.SpinLock> が作成された場合は、例外がスローされます。  
+  
+-   引数に `false` \(Visual Basic では `False`\) を使用して <xref:System.Threading.SpinLock> が作成された場合は、デッドロックが発生します。  
+  
+ [!code-csharp[CDS_SpinLock#01](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_spinlock/cs/spinlockdemo.cs#01)]
+ [!code-vb[CDS_SpinLock#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_spinlock/vb/spinlock_threadtracking.vb#01)]  
+  
+## 参照  
+ [SpinLock](../../../docs/standard/threading/spinlock.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-listen-for-cancellation-requests-by-polling.md b/docs/standard/threading/how-to-listen-for-cancellation-requests-by-polling.md
new file mode 100644
index 00000000000..61ba36a644a
--- /dev/null
+++ b/docs/standard/threading/how-to-listen-for-cancellation-requests-by-polling.md
@@ -0,0 +1,35 @@
+---
+title: "How to: Listen for Cancellation Requests by Polling | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "cancellation, how to poll for requests"
+ms.assetid: c7f2f022-d08e-4e00-b4eb-ae84844cb1bc
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# How to: Listen for Cancellation Requests by Polling
+次の例では、ユーザー コードでキャンセル トークンを一定の間隔でポーリングして、呼び出し元のスレッドからキャンセルが要求されたかどうかを確認する 1 つの方法を示します。  この例では <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型を使用しますが、<xref:System.Threading.ThreadPool?displayProperty=fullName> 型または <xref:System.Threading.Thread?displayProperty=fullName> 型によって直接作成された非同期操作にも同じパターンが適用されます。  
+  
+## 使用例  
+ ポーリングには、ブール型の <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティの値を定期的に読み取ることができる、ある種のループまたは再帰コードが必要です。  <xref:System.Threading.Tasks.Task?displayProperty=fullName> 型を使用し、呼び出し元のスレッドでタスクが完了するのを待つ場合は、<xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> メソッドを使用して、プロパティを確認し、例外をスローできます。  このメソッドを使用すると、要求への応答として正しい例外をスローすることができます。  <xref:System.Threading.Tasks.Task> を使用する場合は、<xref:System.OperationCanceledException> を手動でスローするよりもこのメソッドを呼び出す方が良い方法です。  例外をスローする必要がない場合は、プロパティを確認し、プロパティが `true` のときはメソッドから制御を戻すだけです。  
+  
+ [!code-csharp[Cancellation#11](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex11.cs#11)]
+ [!code-vb[Cancellation#11](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex11.vb#11)]  
+  
+ <xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> の呼び出しは非常に高速で、ループのオーバーヘッドが大きくなることはありません。  
+  
+ <xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> を呼び出す場合、キャンセルへの応答として行う作業が例外のスロー以外にもあるときは、<xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティを明示的に確認するだけで済みます。  この例では、実際にはコードからプロパティに 2 回アクセスすることがわかります。1 回は明示的なアクセスで、もう 1 回は <xref:System.Threading.CancellationToken.ThrowIfCancellationRequested%2A> メソッドです。  ただし、<xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティの読み取り操作にはアクセスごとに volatile の読み取り命令が 1 つあるだけなので、2 回のアクセスはパフォーマンスの観点からも特に問題ではありません。  やはり、<xref:System.OperationCanceledException> を手動でスローするよりもこのメソッドを呼び出すことをお勧めします。  
+  
+## 参照  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-listen-for-cancellation-requests-that-have-wait-handles.md b/docs/standard/threading/how-to-listen-for-cancellation-requests-that-have-wait-handles.md
new file mode 100644
index 00000000000..c7d482660ac
--- /dev/null
+++ b/docs/standard/threading/how-to-listen-for-cancellation-requests-that-have-wait-handles.md
@@ -0,0 +1,40 @@
+---
+title: "How to: Listen for Cancellation Requests That Have Wait Handles | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "cancellation, waiting with wait handles"
+ms.assetid: 6e2aa49b-fc84-4bcf-962b-17db98b7edcb
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Listen for Cancellation Requests That Have Wait Handles
+メソッドは、イベントの通知を待機しているときにブロックされると、キャンセル トークンの値を確認できず、適時に応答することもできません。  最初の例では、統合キャンセル フレームワークをネイティブにはサポートしない <xref:System.Threading.ManualResetEvent?displayProperty=fullName> などのイベントを使用している場合にこの問題を解決する方法を示します。  2 番目の例では、統合キャンセルをサポートする <xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> を使用した効率的な方法を示します。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されることがあります。このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\]** メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\] で \[マイ コードのみ\] チェック ボックスをオフにします。  
+  
+## 使用例  
+ 次の例では、<xref:System.Threading.ManualResetEvent> を使用して、統合キャンセルをサポートしない待機ハンドルのブロックを解除する方法を示します。  
+  
+ [!code-csharp[Cancellation#9](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex9.cs#9)]
+ [!code-vb[Cancellation#9](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex9.vb#9)]  
+  
+## 使用例  
+ 次の例では、<xref:System.Threading.ManualResetEventSlim> を使用して、統合キャンセルをサポートするコーディネーション プリミティブのブロックを解除する方法を示します。  <xref:System.Threading.Semaphore>`Slim` や <xref:System.Threading.CountdownEvent> など、その他の軽量なコーディネーション プリミティブで、同じ方法を使用できます。  
+  
+ [!code-csharp[Cancellation#10](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex10.cs#10)]
+ [!code-vb[Cancellation#10](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex10.vb#10)]  
+  
+## 参照  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-listen-for-multiple-cancellation-requests.md b/docs/standard/threading/how-to-listen-for-multiple-cancellation-requests.md
new file mode 100644
index 00000000000..adc0371f1b9
--- /dev/null
+++ b/docs/standard/threading/how-to-listen-for-multiple-cancellation-requests.md
@@ -0,0 +1,39 @@
+---
+title: "How to: Listen for Multiple Cancellation Requests | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "cancellation tokens, joining"
+  - "LinkedTokenSource, how to"
+ms.assetid: 6f4f3804-2ed7-41b4-a97a-6e32b93f6e05
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Listen for Multiple Cancellation Requests
+この例では、同時に 2 つのキャンセル トークンを待機して、どちらのトークンから要求があっても操作を取り消すことができるようにする方法を示します。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されることがあります。このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\]** メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\] で \[マイ コードのみ\] チェック ボックスをオフにします。  
+  
+## 使用例  
+ 次の例では、<xref:System.Threading.CancellationTokenSource.CreateLinkedTokenSource%2A> メソッドを使用して、2 つのトークンを 1 つのトークンに結合します。  これにより、結合後のトークンを、キャンセル トークンを 1 つしか引数として受け取らないメソッドに渡すことができます。  この例では、クラス外から渡されるトークンと、クラス内で生成されるトークンの両方をメソッドで監視する必要がある一般的なシナリオを示します。  
+  
+ [!code-csharp[Cancellation#13](../../../samples/snippets/csharp/VS_Snippets_Misc/cancellation/cs/cancellationex13.cs#13)]
+ [!code-vb[Cancellation#13](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cancellation/vb/cancellationex13.vb#13)]  
+  
+ 結合後のトークンが <xref:System.OperationCanceledException> をスローする場合、その例外に渡されるトークンは結合後のトークンであり、元のトークンのどちらでもありません。  どちらのトークンが取り消されたかを判断するには、元のトークンの状態を直接確認します。  
+  
+ この例では、<xref:System.AggregateException> がスローされることはありませんが、現実的な状況ではタスク デリゲートからスローされる <xref:System.OperationCanceledException> と他のすべての例外は、<xref:System.OperationCanceledException> にラップされるので、ここではキャッチされています。  
+  
+## 参照  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-register-callbacks-for-cancellation-requests.md b/docs/standard/threading/how-to-register-callbacks-for-cancellation-requests.md
new file mode 100644
index 00000000000..4e9d53d7be4
--- /dev/null
+++ b/docs/standard/threading/how-to-register-callbacks-for-cancellation-requests.md
@@ -0,0 +1,36 @@
+---
+title: "How to: Register Callbacks for Cancellation Requests | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "cancellation, how to register callbacks"
+ms.assetid: 8838dd75-18ed-4b8b-b322-cd4531faac64
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# How to: Register Callbacks for Cancellation Requests
+次の例では、トークンを作成したオブジェクトに対する <xref:System.Threading.CancellationTokenSource.Cancel%2A> の呼び出しにより <xref:System.Threading.CancellationToken.IsCancellationRequested%2A> プロパティが true になったときに呼び出されるデリゲートを登録する方法を示します。  この方法は、統合キャンセル フレームワークをネイティブにはサポートしていない非同期操作を取り消す場合や、非同期操作の終了を待機している可能性のあるメソッドのブロックを解除する場合に使用できます。  
+  
+> [!NOTE]
+>  \[マイ コードのみ\] が有効になっている場合、Visual Studio では、例外をスローする行で処理が中断され、"ユーザー コードで処理されない例外" に関するエラー メッセージが表示されることがあります。 このエラーは問題にはなりません。  F5 キーを押して、処理が中断された箇所から続行し、以下の例に示す例外処理動作を確認できます。  Visual Studio による処理が最初のエラーで中断しないようにするには、**\[ツール\] メニューの \[オプション\]、\[デバッグ\] の順にクリックし、\[全般\]** で \[マイ コードのみ\] チェック ボックスをオフにします。  
+  
+## 使用例  
+ 次の例では、<xref:System.Net.WebClient.CancelAsync%2A> メソッドを、キャンセル トークンを通じてキャンセルが要求されたときに呼び出されるメソッドとして登録します。  
+  
+ [!code-csharp[Conceptual.Cancellation.Callback#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.cancellation.callback/cs/howtoexample1.cs#1)]
+ [!code-vb[Conceptual.Cancellation.Callback#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.cancellation.callback/vb/howtoexample1.vb#1)]  
+  
+ コールバックを登録するときにキャンセルが既に要求されていても、コールバックは必ず呼び出されます。  このような場合、進行中の非同期操作がないと <xref:System.Net.WebClient.CancelAsync%2A> メソッドは何も実行しないので、このメソッドの呼び出しは常に安全です。  
+  
+## 参照  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md b/docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md
new file mode 100644
index 00000000000..35f35c5d773
--- /dev/null
+++ b/docs/standard/threading/how-to-synchronize-concurrent-operations-with-a-barrier.md
@@ -0,0 +1,33 @@
+---
+title: "How to: Synchronize Concurrent Operations with a Barrier | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Barrier, how to use"
+ms.assetid: e1a253ff-e0fb-4df8-95ff-d01a90d4cb19
+caps.latest.revision: 10
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 10
+---
+# How to: Synchronize Concurrent Operations with a Barrier
+以下の例では、<xref:System.Threading.Barrier> を使用して同時実行タスクを同期する方法を示します。  
+  
+## 使用例  
+ 以下のプログラムの目的は、ランダム化アルゴリズムを使用して単語を再シャッフルすることにより、同じフェーズで 2 つのスレッドがそれぞれソリューションの半分を探すために必要なイテレーション \(またはフェーズ\) の数をカウントすることです。  各スレッドで単語がシャッフルされた後、バリアのフェーズ後の操作によって、文中の単語の表示順序が正しいかどうかを確認するために 2 つの結果が比較されます。  
+  
+ [!code-csharp[CDS_Barrier#01](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_barrier/cs/barrier.cs#01)]
+ [!code-vb[CDS_Barrier#01](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_barrier/vb/barrier_vb.vb#01)]  
+  
+ <xref:System.Threading.Barrier> は、すべてのタスクがバリアに到達するまで、並行操作の個々のタスクが続行されないようにするオブジェクトです。  これは、1 つの並行操作が複数のフェーズで行われ、各フェーズでタスク間の同期が必要となる場合に便利です。  この例では、操作に 2 つのフェーズがあります。  最初のフェーズでは、各タスクはバッファーの対応する領域をデータで埋めます。  各タスクは、その領域を埋め終わると、続行できる状態になったことをバリアに通知し、待機します。  すべてのタスクがバリアに通知すると、ブロックが解除され、2 番目のフェーズが開始されます。  2 番目のフェーズでは、各タスクからすべてのデータにアクセスするため、その時点までにすべてのデータが生成されている必要があります。バリアが必要になるのはこのためです。  バリアがないと、最初に完了したタスクが、他のタスクがまだ埋め終わっていないバッファーから読み取ろうとする可能性があります。  同様の方法で、任意の数のフェーズを同期できます。  
+  
+## 参照  
+ [Data Structures for Parallel Programming](../../../docs/standard/parallel-programming/data-structures-for-parallel-programming.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-use-spinlock-for-low-level-synchronization.md b/docs/standard/threading/how-to-use-spinlock-for-low-level-synchronization.md
new file mode 100644
index 00000000000..1b23f6f0475
--- /dev/null
+++ b/docs/standard/threading/how-to-use-spinlock-for-low-level-synchronization.md
@@ -0,0 +1,37 @@
+---
+title: "How to: Use SpinLock for Low-Level Synchronization | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "SpinLock, how to use"
+ms.assetid: a9ed3e4e-4f29-4207-b730-ed0a51ecbc19
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# How to: Use SpinLock for Low-Level Synchronization
+<xref:System.Threading.SpinLock> の使用方法を次の例に示します。  
+  
+## 使用例  
+ この例では、クリティカル セクションが実行する作業量は最小限であるため、<xref:System.Threading.SpinLock> に適しています。  作業量が少し増えると、<xref:System.Threading.SpinLock> のパフォーマンスは標準的なロックよりも高くなります。  ただし、特定の時点から、標準的なロックよりも SpinLock の方が負荷が高くなります。  プロファイリング ツールの同時実行プロファイリング機能では、どの種類のロックを使用するとプログラムのパフォーマンスがより高くなるかを確認できます。  詳細については、「[同時実行ビジュアライザー](../Topic/Concurrency%20Visualizer.md)」を参照してください。  
+  
+ [!code-csharp[CDS_SpinLock#02](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_spinlock/cs/spinlockdemo.cs#02)]
+ [!code-vb[CDS_SpinLock#02](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_spinlock/vb/spinlock_vb.vb#02)]  
+  
+ <xref:System.Threading.SpinLock> は、共有リソースに対するロックの保持が長時間にはならない場合に便利です。  このような場合、マルチコア コンピューターでは、ロックが解放されるまで数サイクルの間、ブロックされたスレッドをスピンさせると効率的です。  スピンにより、スレッドはブロックされなくなりますが、これは CPU 負荷の高いプロセスです。  ハイパースレッディングに対応したシステムでは、<xref:System.Threading.SpinLock> は特定の状況でスピンを停止して、論理プロセッサ リソースの不足や優先順位の逆転が発生するのを防ぎます。  
+  
+ この例では <xref:System.Collections.Generic.Queue%601?displayProperty=fullName> クラスを使用しているため、マルチスレッド アクセスにはユーザーによる同期が必要となります。  .NET Framework Version 4 を対象とするアプリケーションでは、ユーザー ロックを必要としない <xref:System.Collections.Concurrent.ConcurrentQueue%601?displayProperty=fullName> を使用する方法もあります。  
+  
+ <xref:System.Threading.SpinLock.Exit%2A> の呼び出しでは `false` \(Visual Basic では `False`\) を使用していることに注意してください。  これにより、最適なパフォーマンスが得られます。  メモリ フェンスを使用するには、IA64 アーキテクチャで `true` \(`True`\) を指定します。これにより、書き込みバッファーがフラッシュされるので、ロックを使用して他のスレッドを終了できるようになります。  
+  
+## 参照  
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/how-to-use-spinwait-to-implement-a-two-phase-wait-operation.md b/docs/standard/threading/how-to-use-spinwait-to-implement-a-two-phase-wait-operation.md
new file mode 100644
index 00000000000..ff0dd780b1f
--- /dev/null
+++ b/docs/standard/threading/how-to-use-spinwait-to-implement-a-two-phase-wait-operation.md
@@ -0,0 +1,36 @@
+---
+title: "How to: Use SpinWait to Implement a Two-Phase Wait Operation | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "SpinWait, how to synchronize two-phase wait"
+ms.assetid: b2ac4e4a-051a-4f65-b4b9-f8e103aff195
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# How to: Use SpinWait to Implement a Two-Phase Wait Operation
+<xref:System.Threading.SpinWait?displayProperty=fullName> オブジェクトを使用して 2 フェーズ待機操作を実装する方法を次の例に示します。  最初のフェーズでは、同期オブジェクト `Latch` は、ロックが使用可能になったかどうかをチェックしながら数サイクルの間スピンします。  2 番目のフェーズでは、ロックが使用可能になると、<xref:System.Threading.ManualResetEvent?displayProperty=fullName> を使用して待機を実行することなく、`Wait` メソッドから制御が戻ります。それ以外の場合は、`Wait` は待機を実行します。  
+  
+## 使用例  
+ この例は、Latch 同期プリミティブの非常に基本的な実装を示しています。  このデータ構造体は、待機時間が非常に短くなると予測される場合に使用できます。  この例は、デモンストレーションのためだけに作成されています。  ラッチ タイプの機能がプログラムに必要な場合は、<xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> の使用を検討してください。  
+  
+ [!code-csharp[CDS_SpinWait#03](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_spinwait/cs/spinwait03.cs#03)]
+ [!code-vb[CDS_SpinWait#03](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_spinwait/vb/spinwait2.vb#03)]  
+  
+ このラッチでは、`SpinOnce` を次に呼び出して <xref:System.Threading.SpinWait> がスレッドのタイム スライスを譲渡することになるまでの間だけ、<xref:System.Threading.SpinWait> オブジェクトを使用してその場でスピンします。  その時点で、<xref:System.Threading.ManualResetEvent> で <xref:System.Threading.WaitHandle.WaitOne%2A> を呼び出し、タイムアウト値の残りを渡すことによって、ラッチのコンテキスト スイッチが行われます。  
+  
+ ログ出力から、Latch が <xref:System.Threading.ManualResetEvent> を使用せずにロックを取得することでどの程度パフォーマンスを向上させることができたかがわかります。  
+  
+## 参照  
+ [SpinWait](../../../docs/standard/threading/spinwait.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/index.md b/docs/standard/threading/index.md
new file mode 100644
index 00000000000..7db97d584f4
--- /dev/null
+++ b/docs/standard/threading/index.md
@@ -0,0 +1,68 @@
+---
+title: "Managed Threading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], about threading"
+  - "managed threading"
+ms.assetid: 7b46a7d9-c6f1-46d1-a947-ae97471bba87
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Managed Threading
+アプリケーションを開発する場合、プロセッサがシングルまたはマルチのいずれの場合でも、アプリケーションにユーザーとの迅速な対話を提供する必要があります。これはアプリケーションがほかの処理の実行中であっても同じことです。  アプリケーションによるユーザーへの迅速な応答を維持すると同時に、ユーザー イベントの合間やその処理中にプロセッサを使用する最も強力な方法は、複数の実行スレッドを使用することです。  ここでは、スレッド処理の基本概念について、マネージ スレッド処理の概念と使用方法を中心に説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、<xref:System.Threading.Tasks.Parallel?displayProperty=fullName> クラスと <xref:System.Threading.Tasks.Task?displayProperty=fullName> クラス、[Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)、<xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間の新しい同時実行コレクション クラス、およびスレッドではなくタスクの概念に基づく新しいプログラミング モデルによって、マルチスレッド プログラミングが大幅に簡略化されます。  詳細については、「[Parallel Programming](../../../docs/standard/parallel-programming/index.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Managed Threading Basics](../../../docs/standard/threading/managed-threading-basics.md)  
+ マネージ スレッド処理の概要と、マルチ スレッドをどのようなときに使用するかについて説明します。  
+  
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)  
+ スレッドの作成、開始、一時停止、再開、および中止について説明します。  
+  
+ [Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)  
+ 同期のレベル、デッドロックと競合状態の回避方法、シングル プロセッサのコンピューターとマルチ プロセッサのコンピューターの問題など、スレッド処理の各種の注意点について説明します。  
+  
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)  
+ スレッドの動作や、別のスレッドによってアクセスされるオブジェクトのデータを同期するために使用するマネージ クラスについて説明し、スレッド プールのスレッドの概要を示します。  
+  
+## 関連項目  
+ <xref:System.Threading>  
+ マネージ スレッドを使用したり同期したりするためのクラスを含みます。  
+  
+ <xref:System.Collections.Concurrent>  
+ 複数のスレッドで使用する安全なコレクション クラスを含みます。  
+  
+ <xref:System.Threading.Tasks>  
+ 同時処理タスクを作成およびスケジュールするためのクラスを含みます。  
+  
+## 関連項目  
+ [アプリケーション ドメイン](../../../docs/framework/app-domains/application-domains.md)  
+ アプリケーション ドメインの概要と共通言語基盤によるアプリケーション ドメインの使用について説明します。  
+  
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)  
+ 非同期 I\/O のパフォーマンス上の利点と基本的な操作について説明します。  
+  
+ [Event\-based Asynchronous Pattern \(EAP\)](../../../docs/standard/asynchronous-programming-patterns/event-based-asynchronous-pattern-eap.md)  
+ 非同期プログラミングの概要を説明します。  
+  
+ [Calling Synchronous Methods Asynchronously](../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)  
+ デリゲートの組み込み機能を使用してスレッド プールのスレッドでメソッドを呼び出す方法を示します。  
+  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)  
+ アプリケーションで複数のスレッドを簡単に使用できるようにする並列プログラミング ライブラリについて説明します。  
+  
+ [Parallel LINQ \(PLINQ\)](../../../docs/standard/parallel-programming/parallel-linq-plinq.md)  
+ 複数のプロセッサを利用するために、クエリを並列で実行するシステムについて説明します。
\ No newline at end of file
diff --git a/docs/standard/threading/interlocked-operations.md b/docs/standard/threading/interlocked-operations.md
new file mode 100644
index 00000000000..59c234f2d9f
--- /dev/null
+++ b/docs/standard/threading/interlocked-operations.md
@@ -0,0 +1,64 @@
+---
+title: "Interlocked Operations | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "Interlocked class, about Interlocked class"
+  - "threading [.NET Framework], Interlocked class"
+ms.assetid: cbda7114-c752-4f3e-ada1-b1e8dd262f2b
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Interlocked Operations
+<xref:System.Threading.Interlocked> クラスは、複数のスレッドが共有する変数へのアクセスを同期化するメソッドを提供します。  この変数が共有メモリにある場合、各プロセスのスレッドがこの機構を使用できます。  インタロックされた操作はアトミックです。つまり、操作全体が 1 つの単位のため、同じ変数の別のインタロックされた操作によって中断されることはありません。  これは、メモリ アドレスから値を読み込んだ後、変更して格納できるようになる前にスレッドを中断できるプリエンプティブ マルチスレッドのオペレーティング システムで重要です。  
+  
+ <xref:System.Threading.Interlocked> クラスには、次の操作があります。  
+  
+-   .NET Framework Version 2.0 では、<xref:System.Threading.Interlocked.Add%2A> メソッドは変数に整数値を追加して変数の新しい値を返します。  
+  
+-   .NET Framework Version 2.0 では、<xref:System.Threading.Interlocked.Read%2A> メソッドはアトミック操作として 64 ビットの整数値を読み込みます。  これは、64 ビットの整数の読み込みが、通常、アトミック操作ではない 32 ビットのオペレーティング システムで有効です。  
+  
+-   <xref:System.Threading.Interlocked.Increment%2A> メソッドと <xref:System.Threading.Interlocked.Decrement%2A> メソッドは、変数をインクリメントまたはデクリメントした値を返します。  
+  
+-   <xref:System.Threading.Interlocked.Exchange%2A> メソッドは、指定された変数で値をアトミックに交換して値を返し、新しい値で置き換えます。  .NET Framework Version 2.0 では、任意の参照型の変数に対してこのメソッドのジェネリック オーバーロードを使用してこの交換を実行できます。  「<xref:System.Threading.Interlocked.Exchange%60%601%28%60%600%40%2C%60%600%29>」を参照してください。  
+  
+-   <xref:System.Threading.Interlocked.CompareExchange%2A> メソッドも 2 つの値を交換しますが、比較の結果しだいです。  .NET Framework Version 2.0 では、任意の参照型の変数に対してこのメソッドのジェネリック オーバーロードを使用してこの交換を実行できます。  「<xref:System.Threading.Interlocked.CompareExchange%60%601%28%60%600%40%2C%60%600%2C%60%600%29>」を参照してください。  
+  
+ 今日のプロセッサでは、多くの場合、<xref:System.Threading.Interlocked> クラスのメソッドは単一の命令で実装できます。  このように、高性能の同期機能を提供するこれらのメソッドによって、スピン ロックなどのより高水準の同期機構を構築できます。  
+  
+ <xref:System.Threading.Monitor> クラスと <xref:System.Threading.Interlocked> クラスを組み合わせて使用する例については、「[監視](../Topic/Monitors.md)」を参照してください。  
+  
+## CompareExchange の例  
+ <xref:System.Threading.Interlocked.CompareExchange%2A> メソッドは、単純なインクリメントまたはデクリメントよりも複雑な計算を保護するために使用できます。  浮動小数点値として格納されている現在の合計に対して加算を行うスレッド セーフ メソッドの例を次に示します。整数に対しては、<xref:System.Threading.Interlocked.Add%2A> メソッドを使用する方法が簡単です。完全なコード例については、単精度と倍精度の浮動小数点引数 \(<xref:System.Threading.Interlocked.CompareExchange%28System.Single%40%2CSystem.Single%2CSystem.Single%29> と <xref:System.Threading.Interlocked.CompareExchange%28System.Double%40%2CSystem.Double%2CSystem.Double%29>\) を受け取る <xref:System.Threading.Interlocked.CompareExchange%2A> のオーバーロードを参照してください。  
+  
+ [!code-cpp[Conceptual.Interlocked#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interlocked/cpp/source1.cpp#1)]
+ [!code-csharp[Conceptual.Interlocked#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interlocked/cs/source1.cs#1)]
+ [!code-vb[Conceptual.Interlocked#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interlocked/vb/source1.vb#1)]  
+  
+## Exchange と CompareExchange の型指定されていないオーバーロード  
+ <xref:System.Threading.Interlocked.Exchange%2A> メソッドと <xref:System.Threading.Interlocked.CompareExchange%2A> メソッドには、<xref:System.Object> 型の引数を受け取るオーバーロードがあります。  各オーバーロードの第 1 引数は `ref Object` \(Visual Basic では `ByRef … As Object`\) で、この引数に渡す変数の型は <xref:System.Object> 型である必要があります。このメソッドを呼び出すときに、第 1 引数を <xref:System.Object> 型にキャストするだけでは不十分です。  
+  
+> [!NOTE]
+>  .NET Framework Version 2.0 では、<xref:System.Threading.Interlocked.Exchange%2A> メソッドと <xref:System.Threading.Interlocked.CompareExchange%2A> メソッドのジェネリック オーバーロードを使用して厳密に型指定された変数を交換します。  
+  
+ 一度だけ設定できる `ClassA` 型のプロパティのコード例を次に示します。このプロパティは、.NET Framework Version 1.0 または 1.1 で実装できます。  
+  
+ [!code-cpp[Conceptual.Interlocked#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.interlocked/cpp/source2.cpp#2)]
+ [!code-csharp[Conceptual.Interlocked#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.interlocked/cs/source2.cs#2)]
+ [!code-vb[Conceptual.Interlocked#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.interlocked/vb/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.Threading.Interlocked>   
+ <xref:System.Threading.Monitor>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/managed-and-unmanaged-threading-in-windows.md b/docs/standard/threading/managed-and-unmanaged-threading-in-windows.md
new file mode 100644
index 00000000000..bc26e15953c
--- /dev/null
+++ b/docs/standard/threading/managed-and-unmanaged-threading-in-windows.md
@@ -0,0 +1,75 @@
+---
+title: "Managed and Unmanaged Threading in Windows | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], unmanaged"
+  - "threading [.NET Framework], managed"
+  - "managed threading"
+ms.assetid: 4fb6452f-c071-420d-9e71-da16dee7a1eb
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Managed and Unmanaged Threading in Windows
+共通言語ランタイムにより作成されたスレッド、マネージ環境に入ってコードを実行するランタイム外部で作成されたスレッドなど、すべてのスレッドの管理は、<xref:System.Threading.Thread> クラスを使用して行われます。 ランタイムは、プロセス内のスレッドのうち、マネージ実行環境内でコードを実行したすべてのスレッドを監視します。 その他のスレッドは追跡しません。 ランタイムがマネージ オブジェクトを COM オブジェクトとしてアンマネージ環境に公開するため、スレッドは COM 相互運用を使用してマネージ実行環境に入ることができます。また、COM [DllGetClassObject](https://msdn.microsoft.com/en-us/library/ms680760.aspx) 関数やプラットフォーム呼び出しを介してマネージ実行環境に入ることもできます。  
+  
+ ただしアンマネージ スレッドが COM 呼び出し可能ラッパーなどを介してランタイムに入ると、システムがそのスレッド ローカル ストアで内部マネージ <xref:System.Threading.Thread> オブジェクトを検索します。 このオブジェクトが見つかった場合、ランタイムは既にこのスレッドを認識しています。 見つからない場合、ランタイムは新しい <xref:System.Threading.Thread> オブジェクトを作成し、そのスレッドのスレッド ローカル ストアにインストールします。  
+  
+ マネージ スレッド処理では、<xref:System.Threading.Thread.GetHashCode%2A?displayProperty=fullName> は安定したマネージ スレッド ID です。 この値は、取得されたアプリケーション ドメインに関係なく、スレッドの有効期間にわたって他のスレッドの値と競合することはありません。  
+  
+> [!NOTE]
+>  オペレーティング システム **ThreadId** とマネージ スレッドの間には固定的な関係はありません。これは、アンマネージ ホストがマネージ スレッドとアンマネージ スレッドの間の関係を制御できるためです。 特に、高度なホストはファイバー API を使用して、多数のマネージ スレッドを同一オペレーティング システム スレッドに対してスケジュールしたり、マネージ スレッドを異なるオペレーティング システム スレッド間で移動したりできます。  
+  
+## WIn32 スレッド処理とマネージ スレッド処理の対応付け  
+ Win32 スレッド処理要素とほぼそれに対応するランタイムの対応付けを次の表に示します。 この対応付けは、同一の機能性を示すものではありません。 たとえば **TerminateThread** は **finally** 句の実行やリソースの解放は行わず、また防止することはできません。 ただし <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> はすべてのロールバック コードを実行し、すべてのリソースを解放します。また、<xref:System.Threading.Thread.ResetAbort%2A> を使用して拒否することができます。 機能について推測する前に、このドキュメントを詳しくお読みください。  
+  
+|Win32|共通言語ランタイム|  
+|-----------|---------------|  
+|**CreateThread**|**Thread** と <xref:System.Threading.ThreadStart> の組み合わせ|  
+|**TerminateThread**|<xref:System.Threading.Thread.Abort%2A?displayProperty=fullName>|  
+|**SuspendThread**|<xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName>|  
+|**ResumeThread**|<xref:System.Threading.Thread.Resume%2A?displayProperty=fullName>|  
+|**Sleep**|<xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName>|  
+|スレッド ハンドルの **WaitForSingleObject**|<xref:System.Threading.Thread.Join%2A?displayProperty=fullName>|  
+|**ExitThread**|同等の機能がありません|  
+|**GetCurrentThread**|<xref:System.Threading.Thread.CurrentThread%2A?displayProperty=fullName>|  
+|**SetThreadPriority**|<xref:System.Threading.Thread.Priority%2A?displayProperty=fullName>|  
+|同等の機能がありません|<xref:System.Threading.Thread.Name%2A?displayProperty=fullName>|  
+|同等の機能がありません|<xref:System.Threading.Thread.IsBackground%2A?displayProperty=fullName>|  
+|**CoInitializeEx** \(OLE32.DLL\) に類似|<xref:System.Threading.Thread.ApartmentState%2A?displayProperty=fullName>|  
+  
+## マネージ スレッドと COM アパートメント  
+ マネージ スレッドには、[シングル スレッド](http://msdn.microsoft.com/library/windows/desktop/ms680112.aspx) アパートメントをホストするか、[マルチ スレッド](http://msdn.microsoft.com/library/windows/desktop/ms693421.aspx) アパートメントをホストするかを示すようマークすることができます。 \(COM スレッド アーキテクチャの詳細については、「[プロセス、スレッド、アパートメント](http://msdn.microsoft.com/library/windows/desktop/ms693344.aspx)」を参照してください。\)<xref:System.Threading.Thread.GetApartmentState%2A> クラスの <xref:System.Threading.Thread.SetApartmentState%2A>、<xref:System.Threading.Thread.TrySetApartmentState%2A>、および <xref:System.Threading.Thread> の各スレッドは、スレッドのアパートメント状態を返して割り当てます。 状態が設定されていない場合、<xref:System.Threading.Thread.GetApartmentState%2A> は <xref:System.Threading.ApartmentState?displayProperty=fullName> を返します。  
+  
+ プロパティは、スレッドが <xref:System.Threading.ThreadState?displayProperty=fullName> 状態の場合にのみ設定することができます。設定できるのは、1 つのスレッドにつき 1 回だけです。  
+  
+ スレッド開始前にアパートメントの状態が設定されていない場合、このスレッドはマルチスレッド アパートメント \(MTA\) として初期化されます。 ファイナライザー スレッドと、<xref:System.Threading.ThreadPool> により制御されるすべてのスレッドは MTA です。  
+  
+> [!IMPORTANT]
+>  アプリケーションのスタートアップ コードでは、アパートメントの状態を制御する方法は、<xref:System.MTAThreadAttribute> または <xref:System.STAThreadAttribute> をエントリ ポイント プロシージャに適用する方法だけです。 .NET Framework 1.0 と 1.1 では、<xref:System.Threading.Thread.ApartmentState%2A> プロパティを最初のコード行として設定できます。 .NET Framework 2.0 ではこの設定は許可されていません。  
+  
+ COM に対して公開されるマネージ オブジェクトは、フリー スレッド マーシャラーを集約した場合と同様に動作します。 つまり、フリースレッドな方法ですべての COM アパートメントから呼び出すことができます。 このフリー スレッドな動作を示さないマネージ オブジェクトは、<xref:System.EnterpriseServices.ServicedComponent> または <xref:System.Runtime.InteropServices.StandardOleMarshalObject> から派生したオブジェクトだけです。  
+  
+ マネージ環境では、コンテキストおよびコンテキストにバインディングされたインスタンスを使用しない場合には <xref:System.Runtime.Remoting.Contexts.SynchronizationAttribute> はサポートされません。[Enterprise Services](../Topic/System.EnterpriseServices.md) を使用する場合は、オブジェクトは <xref:System.EnterpriseServices> \(<xref:System.ContextBoundObject> から派生したオブジェクト\) から派生したものでなければなりません。  
+  
+ マネージ コードは、COM オブジェクトを呼び出すときには常に COM 規則に従います。 つまり、OLE32 によって示される COM アパートメント プロキシと COM\+ 1.0 コンテキスト ラッパーを介して呼び出します。  
+  
+## ブロッキングの問題  
+ アンマネージ コードでスレッドをブロックしているオペレーティング システムに対し、そのスレッドがアンマネージ呼び出しを実行する場合、ランタイムは <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> または <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> に対してその呼び出しを制御しません。<xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> では、スレッドが再びマネージ コードに入ると、ランタイムはスレッドを **Abort** 対象としてマークし、スレッドを制御します。 アンマネージ ブロックではなくマネージ ブロックを使用することをお勧めします。<xref:System.Threading.WaitHandle.WaitOne%2A?displayProperty=fullName>、<xref:System.Threading.WaitHandle.WaitAny%2A?displayProperty=fullName>、<xref:System.Threading.WaitHandle.WaitAll%2A?displayProperty=fullName>、<xref:System.Threading.Monitor.Enter%2A?displayProperty=fullName>、<xref:System.Threading.Monitor.TryEnter%2A?displayProperty=fullName>、<xref:System.Threading.Thread.Join%2A?displayProperty=fullName>、<xref:System.GC.WaitForPendingFinalizers%2A?displayProperty=fullName> などはすべて <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> に応答します。 また、スレッドがシングルスレッド アパート内にある場合、これらのマネージ ブロック操作はすべて、スレッドがブロックされている間でもアパートメント内で正しくメッセージ ポンプを行います。  
+  
+## 参照  
+ <xref:System.Threading.Thread.ApartmentState%2A?displayProperty=fullName>   
+ <xref:System.Threading.ThreadState>   
+ <xref:System.EnterpriseServices.ServicedComponent>   
+ <xref:System.Threading.Thread>   
+ <xref:System.Threading.Monitor>
\ No newline at end of file
diff --git a/docs/standard/threading/managed-thread-states.md b/docs/standard/threading/managed-thread-states.md
new file mode 100644
index 00000000000..cd31890172e
--- /dev/null
+++ b/docs/standard/threading/managed-thread-states.md
@@ -0,0 +1,59 @@
+---
+title: "マネージ スレッドの状態 | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "スレッド [.NET Framework]、状態"
+ms.assetid: 63890d5e-6025-4a7c-aaf0-d8bfd54b455f
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# マネージ スレッドの状態
+プロパティ <xref:System.Threading.Thread.ThreadState%2A?displayProperty=fullName> には、スレッドの現在の状態を示すビット マスクが用意されています。 スレッドは、<xref:System.Threading.ThreadState> 列挙型に含まれる状態のうち、常に少なくとも 1 つの状態となり、同時に複数の状態になることもあります。  
+  
+> [!IMPORTANT]
+>  スレッドの状態は、いくつかのデバッグ シナリオでのみ必要になります。 スレッドの動作を同期化する目的でコード内でスレッドの状態を使用しないでください。  
+  
+ マネージ スレッドを作成すると、そのスレッドは <xref:System.Threading.ThreadState> 状態になります。 スレッドは、オペレーティング システムによって起動状態にされるまで、<xref:System.Threading.ThreadState> 状態のままです。<xref:System.Threading.Thread.Start%2A> を呼び出すと、スレッドを開始できることをオペレーティング システムに通知できますが、スレッドの状態は変化しません。  
+  
+ マネージ環境に入ってくるアンマネージ スレッドは、既に起動状態になっています。 スレッドがいったん起動状態になると、さまざまなアクションによってスレッドの状態が変更される可能性があります。 状態が変更される原因となるアクションと、対応する新しい状態を次の表に示します。  
+  
+|アクション|変更後の新しい状態|  
+|-----------|---------------|  
+|<xref:System.Threading.Thread> クラスのコンストラクターが呼び出される。|<xref:System.Threading.ThreadState>|  
+|別のスレッドが <xref:System.Threading.Thread.Start%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|スレッドが <xref:System.Threading.Thread.Start%2A?displayProperty=fullName> に応答して実行を開始する。|<xref:System.Threading.ThreadState>|  
+|スレッドが <xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|スレッドが別のオブジェクトで <xref:System.Threading.Monitor.Wait%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|スレッドが別のスレッドで <xref:System.Threading.Thread.Join%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|別のスレッドが <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|スレッドが <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> 要求に応答する。|<xref:System.Threading.ThreadState>|  
+|別のスレッドが <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|別のスレッドが <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> を呼び出す。|<xref:System.Threading.ThreadState>|  
+|スレッドが <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> に応答する。|<xref:System.Threading.ThreadState> の後 <xref:System.Threading.ThreadState>|  
+  
+ <xref:System.Threading.ThreadState> 状態の値は 0 のため、ビット テストを実行しても、この状態を検出できません。 代わりに、擬似コードによる次のテストを実行できます。  
+  
+```  
+if ((state & (Unstarted | Stopped)) == 0)   // implies Running     
+```  
+  
+ スレッドは、どの時点でも複数の状態にあることがよくあります。 たとえば、<xref:System.Threading.Monitor.Wait%2A?displayProperty=fullName> 呼び出しでスレッドがブロックされ、別のスレッドが同じスレッドに対して <xref:System.Threading.Thread.Abort%2A> を呼び出した場合、スレッドは同時に <xref:System.Threading.ThreadState> 状態と <xref:System.Threading.ThreadState> 状態になります。 この場合、スレッドは、<xref:System.Threading.Monitor.Wait%2A> への呼び出しから戻るか中断されるとすぐに、<xref:System.Threading.ThreadAbortException> を受け取ります。  
+  
+ スレッドは、<xref:System.Threading.Thread.Start%2A> への呼び出しの結果として <xref:System.Threading.ThreadState> 状態から出ると、<xref:System.Threading.ThreadState> 状態に戻ることはできません。 また、スレッドは <xref:System.Threading.ThreadState> 状態から出ることはできません。  
+  
+## 参照  
+ <xref:System.Threading.ThreadAbortException>   
+ <xref:System.Threading.Thread>   
+ <xref:System.Threading.ThreadState>   
+ [Threading](../../../docs/standard/threading/index.md)
\ No newline at end of file
diff --git a/docs/standard/threading/managed-threading-basics.md b/docs/standard/threading/managed-threading-basics.md
new file mode 100644
index 00000000000..53d62f6ba6f
--- /dev/null
+++ b/docs/standard/threading/managed-threading-basics.md
@@ -0,0 +1,75 @@
+---
+title: "Managed Threading Basics | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "multiple threads"
+  - "threading [.NET Framework], multiple threads"
+  - "threading [.NET Framework], about threading"
+  - "managed threading"
+ms.assetid: b2944911-0e8f-427d-a8bb-077550618935
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Managed Threading Basics
+このセクションの最初の 5 つのトピックでは、どのようなときにマネージ スレッド処理を使うかと、いくつかの基本的な機能について説明します。  追加機能を提供するクラスの詳細については、「[Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)」と「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+ このセクションの残りのトピックでは、マネージ スレッド処理での Windows オペレーティング システムとのやり取りなど、より詳細な内容について説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、マルチスレッド プログラムでのタスクとデータの並列化に使用できる API が Task Parallel Library および PLINQ に用意されています。  詳細については、「[Parallel Programming](../../../docs/standard/parallel-programming/index.md)」を参照してください。  
+  
+## このセクションの内容  
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)  
+ マルチ スレッドの長所と短所について説明し、スレッドを作成したり、スレッド プールのスレッドを使用したりするシナリオの概要について説明します。  
+  
+ [Exceptions in Managed Threads](../../../docs/standard/threading/exceptions-in-managed-threads.md)  
+ さまざまなバージョンの .NET Framework のスレッドにおいて未処理の例外の動作について説明します。特にアプリケーションの終了を引き起こす状況について説明します。  
+  
+ [Synchronizing Data for Multithreading](../../../docs/standard/threading/synchronizing-data-for-multithreading.md)  
+ マルチ スレッドで使用されるクラスのデータを同期する方法について説明します。  
+  
+ [マネージ スレッドの状態](../../../docs/standard/threading/managed-thread-states.md)  
+ 基本的なスレッド状態と、スレッドが実行されているかどうかを検出する方法について説明します。  
+  
+ [Foreground and Background Threads](../../../docs/standard/threading/foreground-and-background-threads.md)  
+ フォアグラウンド スレッドとバックグラウンド スレッドの違いについて説明します。  
+  
+ [Managed and Unmanaged Threading in Windows](../../../docs/standard/threading/managed-and-unmanaged-threading-in-windows.md)  
+ マネージ スレッド処理とアンマネージ スレッド処理との関係、Windows のスレッド処理 API に対応するマネージ スレッドのメソッド、および COM アパートメントとマネージ スレッドとのやり取りについて説明します。  
+  
+ [Thread.Suspend, Garbage Collection, and Safe Points](../../../docs/standard/threading/thread-suspend-garbage-collection-and-safe-points.md)  
+ スレッドの中断とガベージ コレクションについて説明します。  
+  
+ [Thread Local Storage: Thread\-Relative Static Fields and Data Slots](../../../docs/standard/threading/thread-local-storage-thread-relative-static-fields-and-data-slots.md)  
+ スレッド相対のストレージ機構について説明します。  
+  
+ [Cancellation in Managed Threads](../../../docs/standard/threading/cancellation-in-managed-threads.md)  
+ キャンセル トークンを使用して非同期または長時間にわたる同期操作を取り消す方法について説明します。  
+  
+## 関連項目  
+ <xref:System.Threading.Thread>  
+ **Thread** クラスのリファレンス ドキュメントです。このクラスは、アンマネージ コードから作成されたか、マネージ アプリケーションで作成されたかにかかわらず、マネージ スレッドを表します。  
+  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ ユーザー インターフェイス オブジェクトと組み合わせてマルチスレッドを実装する安全な方法を示します。  
+  
+## 関連項目  
+ [Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)  
+ 複数のスレッドのアクティビティを同期するために使用するマネージ クラスについて説明します。  
+  
+ [Managed Threading Best Practices](../../../docs/standard/threading/managed-threading-best-practices.md)  
+ マルチスレッド処理に関連する一般的な問題、およびその問題を回避する方法について説明します。  
+  
+ [Parallel Programming](../../../docs/standard/parallel-programming/index.md)  
+ 非同期のマルチスレッド .NET Framework アプリケーションを簡単に作成できるようにするタスク並列ライブラリおよび PLINQ について説明します。
\ No newline at end of file
diff --git a/docs/standard/threading/managed-threading-best-practices.md b/docs/standard/threading/managed-threading-best-practices.md
new file mode 100644
index 00000000000..cfee9887db1
--- /dev/null
+++ b/docs/standard/threading/managed-threading-best-practices.md
@@ -0,0 +1,202 @@
+---
+title: "Managed Threading Best Practices | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], design guidelines"
+  - "threading [.NET Framework], best practices"
+  - "managed threading"
+ms.assetid: e51988e7-7f4b-4646-a06d-1416cee8d557
+caps.latest.revision: 19
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 19
+---
+# Managed Threading Best Practices
+マルチスレッドには慎重なプログラミングが必要です。  ほとんどのタスクでは、スレッド プールのスレッドを使って実行の要求をキューに置くことによって、処理の複雑さを軽減できます。  このトピックでは、マルチ スレッド動作の調整や、ブロックするスレッドの処理など、より難しい状況について説明します。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、マルチスレッド プログラミングの複雑さとリスクを軽減する API が Task Parallel Library および PLINQ に用意されています。  詳細については、「[Parallel Programming](../../../docs/standard/parallel-programming/index.md)」を参照してください。  
+  
+## デッドロックと競合状態  
+ マルチスレッドはスループットと応答速度の問題を解決しますが、その一方で、デッドロックと競合状態という新たな問題を発生させます。  
+  
+### デッドロック  
+ デッドロックは、2 つのスレッドのうちの一方が、もう一方によって既にロックされているリソースをロックしようとすると発生します。  こうなると、どちらのスレッドも続行できなくなります。  
+  
+ マネージ スレッド処理クラスの多くのメソッドには、ロックアウトを検出するためのタイムアウト機能が用意されています。  たとえば、現在のインスタンスへのロックの取得を試みるコードを次に示します。  ロックが 300 ミリ秒の間に得られない場合は、<xref:System.Threading.Monitor.TryEnter%2A?displayProperty=fullName> は **false** を返します。  
+  
+```vb  
+If Monitor.TryEnter(lockObject, 300) Then  
+    Try  
+        ' Place code protected by the Monitor here.  
+    Finally  
+        Monitor.Exit(Me)  
+    End Try  
+Else  
+    ' Code to execute if the attempt times out.  
+End If  
+```  
+  
+```csharp  
+if (Monitor.TryEnter(lockObject, 300)) {  
+    try {  
+        // Place code protected by the Monitor here.  
+    }  
+    finally {  
+        Monitor.Exit(this);  
+    }  
+}  
+else {  
+    // Code to execute if the attempt times out.  
+}  
+```  
+  
+### 競合状態  
+ 競合状態は、2 つ以上のスレッドのうちのどれが特定のコード ブロックに最初に到達するかによって、プログラムの結果が変わってしまうバグのことです。  プログラムを何回か実行すると、異なる結果が得られ、実行の結果は予測できません。  
+  
+ 競合状態の簡単な例として、フィールドのインクリメントがあります。  クラスにプライベートの **static** フィールド \(Visual Basic では **Shared**\) があり、このフィールドは、`objCt++;` \(C\# の場合\) または `objCt += 1` \(Visual Basic の場合\) のようなコードを使用して、クラスのインスタンスが生成されるたびにインクリメントされるものとします。  この演算によって、`objCt` からレジスタへの値の読み込み、値のインクリメント、および `objCt` への値の格納が行われます。  
+  
+ マルチスレッドされたアプリケーションでは、値の読み込みとインクリメントを行ったスレッドが、この 3 つの処理を実行する別のスレッドに先を越される可能性があります。最初のスレッドは、実行を再開して値を格納するとき、待機中に値が変更されたかどうかを考慮せずに、`objCt` の値を上書きしてしまいます。  
+  
+ このような特定の競合状態は、<xref:System.Threading.Interlocked.Increment%2A?displayProperty=fullName> など、<xref:System.Threading.Interlocked> クラスのメソッドを使用することによって容易に回避できます。  複数のスレッド間でデータを同期する他の手法については、「[マルチスレッド処理のためのデータの同期](../../../docs/standard/threading/synchronizing-data-for-multithreading.md)」を参照してください。  
+  
+ 競合状態は、複数のスレッドの動作を同期するときにも発生します。  コードを記述するときには、そのコードの行 \(または行を構成する各マシン命令\) を実行するスレッドが別のスレッドに追い越された場合に何が起きるのかを考慮しておく必要があります。  
+  
+## プロセッサの数  
+ ほとんどのコンピューターは、タブレットや携帯電話のような小型のデバイスでさえも、複数のプロセッサ \(コアともいいます\) を持ちます。  シングル プロセッサ コンピューターでも動作するソフトウェアを開発する場合は、マルチスレッドによってシングル プロセッサ コンピューターとマルチプロセッサ コンピューターとで異なる問題が解決される点に注意してください。  
+  
+### マルチプロセッサ コンピューター  
+ マルチスレッドによって、スループットが大幅に向上します。  10 個のプロセッサは 1 個のプロセッサの 10 倍の仕事をします。ただし、これは仕事が分割され、10 個のプロセッサが同時に働いた場合です。スレッドを使用すると、簡単な方法で仕事を分割し、プロセッサの能力を活用できます。  マルチプロセッサ コンピューターでマルチスレッドを使用する場合は、次の点に注意が必要です。  
+  
+-   同時に実行できるスレッドの数は、プロセッサの数によって制限されます。  
+  
+-   実行されているフォアグラウンド スレッドの数がプロセッサの数よりも少ないときだけ、バックグラウンド スレッドが実行されます。  
+  
+-   スレッドで <xref:System.Threading.Thread.Start%2A?displayProperty=fullName> メソッドを呼び出しても、プロセッサの数と待機中のスレッドの数によっては、スレッドがすぐに開始されない場合があります。  
+  
+-   競合状態は、別のスレッドによる予期していなかった割り込みがあった場合に発生するだけでなく、別々のプロセッサで実行されている 2 つのスレッドが特定のコード ブロックに到達するタイミングによって発生する場合もあります。  
+  
+### シングル プロセッサ コンピューター  
+ マルチスレッドによって、ユーザーへの応答速度が向上し、アイドル時間はバックグランド タスクに使用されます。  シングル プロセッサ コンピューターでマルチスレッドを使用するときは、次の点に注意が必要です。  
+  
+-   各瞬間には、1 つのスレッドだけが実行されています。  
+  
+-   バックグラウンド スレッドは、メイン ユーザー スレッドがアイドル状態のときだけ実行されます。  フォアグラウンド スレッドが連続して実行されると、バックグラウンド スレッドのプロセッサ時間が少なくなります。  
+  
+-   スレッドで <xref:System.Threading.Thread.Start%2A?displayProperty=fullName> メソッドを呼び出しても、現在実行中のスレッドがプロセッサを解放するか、オペレーティング システムによって割り込まれるまでは、スレッドの実行が開始されません。  
+  
+-   スレッドが別のスレッドに割り込まれてしまい、特定のコード ブロックに先に到達されてしまう可能性をプログラマが予測できていない場合に、競合状態が発生しやすくなります。  
+  
+## 静的メンバーと静的コンストラクター  
+ クラスは、そのクラス コンストラクター \(C\# では `static` コンストラクター、Visual Basic では `Shared Sub New`\) の実行が完了するまで初期化されません。  初期化されていない型のコードの実行を防止するため、共通言語ランタイムは、クラス コンストラクターの実行が完了するまで、他のスレッドからのそのクラスの `static` メンバー \(Visual Basic では `Shared` メンバー\) 呼び出しをすべてブロックします。  
+  
+ たとえば、クラス コンストラクターが新しいスレッドを起動し、そのスレッドのプロシージャがクラスの `static` メンバーを呼び出した場合、その新しいスレッドは、クラス コンストラクターが完了するまでブロックされます。  
+  
+ このことは、`static` コンストラクターを持つことができるすべての型に当てはまります。  
+  
+## 一般的な推奨事項  
+ マルチスレッドを使用するときは、以下のガイドラインを考慮してください。  
+  
+-   他のスレッドを終了させるために <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> を使用することは避けてください。  他のスレッドの **Abort** を呼び出すことは、そのスレッドの処理がどこまで到達しているかを把握せずに例外をスローするのと同じことになります。  
+  
+-   <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> を使用して複数のスレッドの動作を同期することは避けてください。  <xref:System.Threading.Mutex>、<xref:System.Threading.ManualResetEvent>、<xref:System.Threading.AutoResetEvent>、および <xref:System.Threading.Monitor> を使用してください。  
+  
+-   メイン プログラムから、イベントなどを使用して、ワーカー スレッドの実行を制御しないでください。  ワーカー スレッドの側で、作業ができるようになるまでの待機、作業の実行、および実行終了後のプログラムへの通知を行うように、プログラムをデザインします。  ワーカー スレッドによるブロックを行わない場合は、スレッド プールのスレッドを使用することを考慮します。  ワーカー スレッドがブロックを行う場合は、<xref:System.Threading.Monitor.PulseAll%2A?displayProperty=fullName> が役立ちます。  
+  
+-   ロック オブジェクトとして型を使用しないでください。  つまり、C\# の `lock(typeof(X))`、Visual Basic の `SyncLock(GetType(X))` などのコードを使用すること、または <xref:System.Threading.Monitor.Enter%2A?displayProperty=fullName> を <xref:System.Type> オブジェクトと組み合わせて使用することを避けます。  <xref:System.Type?displayProperty=fullName> のインスタンスは、1 つの型につきアプリケーション ドメインごとに 1 つのみです。  ロックする型がパブリックの場合、自分以外のコードでもその型をロックできるため、デッドロックになる可能性があります。  詳細については、「[信頼性に関するベスト プラクティス](../../../docs/framework/performance/reliability-best-practices.md)」を参照してください。  
+  
+-   インスタンスをロックする場合 \(たとえば、C\# の `lock(this)`、Visual Basic の `SyncLock(Me)`\) には注意してください。  アプリケーション内の、その型以外の他のコードがオブジェクトをロックすると、デッドロックが発生する場合があります。  
+  
+-   モニター状態に入った \(ロックを取得した\) スレッドは、モニター状態である間に例外が発生した場合でも、必ずモニター状態から出すようにします。  C\# の [lock](../Topic/lock%20Statement%20\(C%23%20Reference\).md) ステートメントと Visual Basic の [SyncLock](../../../ocs/visual-basic/language-reference/statements/synclock-statement.md) ステートメントは、**finally** ブロックを使用して <xref:System.Threading.Monitor.Exit%2A?displayProperty=fullName> が呼び出されるようにすることで、この動作を自動的に提供します。  **Exit** を確実に呼び出すことができない場合は、**Mutex** を使用するようにデザインを変更することを考慮します。  ミューテックスは、現在それを保持しているスレッドが終了すると、自動的に解放されます。  
+  
+-   マルチ スレッドは異なるリソースを必要とするタスクに使用し、1 つのリソースに複数のスレッドを割り当てることがないように注意します。  たとえば、I\/O を含む作業であれば、その作業専用のスレッドを用意すると有益です。I\/O 操作の間、このスレッドはブロックを行いますが、他のスレッドは実行できるからです。  ユーザー入力も、専用のスレッドが役に立つリソースの 1 つです。  シングル プロセッサのコンピューターでは、計算中心のタスクがユーザー入力や I\/O タスクと共存することはできますが、計算中心タスクどうしは競合してしまいます。  
+  
+-   単純な状態変更については、`lock` ステートメント \(Visual Basic では `SyncLock`\) ではなく、<xref:System.Threading.Interlocked> クラスのメソッドの使用を検討します。  `lock` ステートメントは汎用的なツールとして優れていますが、<xref:System.Threading.Interlocked> クラスは、分離不可能な状態であることが必要な更新のパフォーマンスに優れています。  内部的には、競合がない場合は、単一の lock プレフィックスが実行されます。  コードの校閲で、次に示す例のようなコードを探します。  最初の例では、状態変数をインクリメントしています。  
+  
+    ```vb  
+    SyncLock lockObject  
+        myField += 1  
+    End SyncLock  
+    ```  
+  
+    ```csharp  
+    lock(lockObject)   
+    {  
+        myField++;  
+    }  
+    ```  
+  
+     `lock` ステートメントの代わりに <xref:System.Threading.Interlocked.Increment%2A> メソッドを次のように使用すると、パフォーマンスを向上できます。  
+  
+    ```vb  
+    System.Threading.Interlocked.Increment(myField)  
+    ```  
+  
+    ```csharp  
+    System.Threading.Interlocked.Increment(myField);  
+    ```  
+  
+    > [!NOTE]
+    >  .NET Framework Version 2.0 では、1 より大きなインクリメントでのアトミック更新を <xref:System.Threading.Interlocked.Add%2A> メソッドで実現できます。  
+  
+     2 番目の例では、参照型の変数を、null 参照 \(Visual Basic では `Nothing`\) の場合にのみ更新しています。  
+  
+    ```vb  
+    If x Is Nothing Then  
+        SyncLock lockObject  
+            If x Is Nothing Then  
+                x = y  
+            End If  
+        End SyncLock  
+    End If  
+    ```  
+  
+    ```csharp  
+    if (x == null)  
+    {  
+        lock (lockObject)  
+        {  
+            if (x == null)  
+            {  
+                x = y;  
+            }  
+        }  
+    }  
+    ```  
+  
+     この代わりに <xref:System.Threading.Interlocked.CompareExchange%2A> メソッドを次のように使用すると、パフォーマンスを向上できます。  
+  
+    ```vb  
+    System.Threading.Interlocked.CompareExchange(x, y, Nothing)  
+    ```  
+  
+    ```csharp  
+    System.Threading.Interlocked.CompareExchange(ref x, y, null);  
+    ```  
+  
+    > [!NOTE]
+    >  .NET Framework Version 2.0 では、<xref:System.Threading.Interlocked.CompareExchange%2A> メソッドに、任意の参照型のタイプ セーフな置換に使用できるジェネリック オーバーロードがあります。  
+  
+## クラス ライブラリに関する推奨事項  
+ マルチスレッド用のクラス ライブラリをデザインするときには、次のガイドラインを検討します。  
+  
+-   可能な限り、同期の必要を避けるようにします。  これは、頻繁に使用するコードの場合に特に言えます。  たとえば、競合状態をなくすのではなく、競合状態に対応できるようにアルゴリズムを調整できる場合があります。  不要な同期があると、パフォーマンスが低下し、デッドロックや競合状態が発生する可能性が生じます。  
+  
+-   静的なデータ \(Visual Basic では `Shared`\) は既定でスレッド セーフにします。  
+  
+-   インスタンス データは既定でスレッド セーフにしないようにします。  スレッド セーフなコードを作成するロックを追加すると、パフォーマンスが低下し、ロックの競合が増加し、デッドロックが発生する可能性が生じます。  一般的なアプリケーション モデルでは、一度にユーザー コードを実行するスレッドは 1 つだけにして、スレッド セーフを実現する必要を最小限に抑えます。  この理由から、.NET Framework のクラス ライブラリは既定ではスレッド セーフではないことが必要です。  
+  
+-   静的状態を変更する静的メソッドは提供しないでください。  一般的なサーバーのシナリオでは、静的状態は要求間で共有されます。つまり、複数のスレッドがそのコードを同時に実行できます。  これにより、スレッド処理のバグが発生する可能性が高くなります。  要求間で共有されないインスタンスにデータをカプセル化するデザイン パターンの使用を検討してください。  加えて、静的なデータを同期する場合は、状態を変更する呼び出しが静的メソッド間にあると、デッドロックや冗長な同期が生じる可能性があり、パフォーマンスに悪影響を及ぼします。  
+  
+## 参照  
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)
\ No newline at end of file
diff --git a/docs/standard/threading/manualresetevent-and-manualreseteventslim.md b/docs/standard/threading/manualresetevent-and-manualreseteventslim.md
new file mode 100644
index 00000000000..b52ffb03705
--- /dev/null
+++ b/docs/standard/threading/manualresetevent-and-manualreseteventslim.md
@@ -0,0 +1,35 @@
+---
+title: "ManualResetEvent and ManualResetEventSlim | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], ManualResetEvent class"
+  - "ManualResetEvent class, about ManualResetEvent class"
+ms.assetid: 465fdcf9-ba24-4d8d-a43f-d983b7cb0cc6
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# ManualResetEvent and ManualResetEventSlim
+<xref:System.Threading.ManualResetEvent?displayProperty=fullName> クラスは、シグナル状態になった後に手動でリセットする必要があるローカル待機ハンドル イベントを表します。  このクラスが表すのは、基本クラス <xref:System.Threading.EventWaitHandle?displayProperty=fullName> の特殊なケースです。  手動リセット イベントの使用方法と機能については、[EventWaitHandle](../../../docs/standard/threading/eventwaithandle.md) の概念についてのトピックを参照してください。  
+  
+ <xref:System.Threading.ManualResetEvent> オブジェクトは、その <xref:System.Threading.EventWaitHandle.Reset%2A?displayProperty=fullName> メソッドが呼び出されるまで、シグナル状態のままです。  待機スレッド、つまりイベントがシグナル状態になるまで待機するスレッドは、そのオブジェクトがシグナル状態である間にいくつでも解放できます。  <xref:System.Threading.ManualResetEvent> は、`bManualReset` 引数を `true` に指定する Win32 `CreateEvent` 呼び出しと同じです。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)]では、待機時間が非常に短くなると予測される場合、およびイベントがプロセスの境界を通過しない場合にパフォーマンスが向上するように<xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> クラスを使用できます。  <xref:System.Threading.ManualResetEventSlim> は シグナル状態にするためにイベントを待機している間、以下の間にビジー スピンを使用します。  待機時間が短い場合は、待機ハンドルよりもスピンを使用する方が負荷が大幅に低くなります。  ただし、一定期間内にイベントがシグナル状態にならない場合、<xref:System.Threading.ManualResetEventSlim> では通常のイベント ハンドル待機を使用します。  
+  
+## 参照  
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [Wait Handles](../Topic/Wait%20Handles.md)   
+ [AutoResetEvent](../../../docs/standard/threading/autoresetevent.md)   
+ [SpinWait](../../../docs/standard/threading/spinwait.md)   
+ [Semaphore and SemaphoreSlim](../../../docs/standard/threading/semaphore-and-semaphoreslim.md)
\ No newline at end of file
diff --git a/docs/standard/threading/media/vs-cancellationtoken.png b/docs/standard/threading/media/vs-cancellationtoken.png
new file mode 100644
index 00000000000..b06064a4f0e
Binary files /dev/null and b/docs/standard/threading/media/vs-cancellationtoken.png differ
diff --git a/docs/standard/threading/mutexes.md b/docs/standard/threading/mutexes.md
new file mode 100644
index 00000000000..a0a4ca85f66
--- /dev/null
+++ b/docs/standard/threading/mutexes.md
@@ -0,0 +1,64 @@
+---
+title: "Mutexes | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "wait handles"
+  - "threading [.NET Framework], Mutex class"
+  - "Mutex class, about Mutex class"
+  - "threading [.NET Framework], cross-process synchronization"
+ms.assetid: 9dd06e25-12c0-4a9e-855a-452dc83803e2
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Mutexes
+<xref:System.Threading.Mutex> オブジェクトを使用すると、リソースへの排他アクセスを提供できます。  <xref:System.Threading.Mutex> クラスは <xref:System.Threading.Monitor> クラスより多くのシステム リソースを使用しますが、アプリケーションのドメイン境界を越えてマーシャリングでき、複数の待機操作と共に使用でき、異なるプロセスのスレッドを同期するために使用できます。  マネージ同期メカニズムの比較については、「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+ コード例については <xref:System.Threading.Mutex.%23ctor%2A> コンストラクターのリファレンス ドキュメントを参照してください。  
+  
+## ミューテックスの使用  
+ スレッドは、ミューテックスの <xref:System.Threading.WaitHandle.WaitOne%2A> メソッドを呼び出して所有権を要求します。  この呼び出しは、ミューテックスが使用できるようになるまで、またはオプションのタイムアウト間隔が経過するまでブロックします。  所有しているスレッドがない場合、ミューテックスはシグナル状態になります。  
+  
+ スレッドは、<xref:System.Threading.Mutex.ReleaseMutex%2A> メソッドを呼び出してミューテックスを解放します。  ミューテックスにはスレッド アフィニティがあり、解放できるのはスレッドが所有するミューテックスだけです。  スレッドが所有していないミューテックスを解放すると、スレッドで <xref:System.ApplicationException> がスローされます。  
+  
+ <xref:System.Threading.Mutex> クラスは <xref:System.Threading.WaitHandle> から派生し、<xref:System.Threading.WaitHandle> の静的な <xref:System.Threading.WaitHandle.WaitAll%2A> メソッドまたは <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドを呼び出して、他の待機ハンドルと組み合わせて <xref:System.Threading.Mutex> の所有権を要求できます。  
+  
+ <xref:System.Threading.Mutex> を所有するスレッドは、待機要求呼び出しを繰り返し行うときに、実行をブロックせずに同じ <xref:System.Threading.Mutex> を指定できます。ただし呼び出しと同じ回数だけ <xref:System.Threading.Mutex> を解放して、その所有権を解放する必要があります。  
+  
+## 放棄されたミューテックス  
+ スレッドが <xref:System.Threading.Mutex> を解放せずに終了した場合、ミューテックスは放棄されたと言います。  ミューテックスが保護しているリソースが矛盾した状態で残る可能性があるため、多くの場合、これは重大なプログラミング エラーを示します。  .NET Framework Version 2.0 では、ミューテックスを取得する次のスレッドで <xref:System.Threading.AbandonedMutexException> がスローされます。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、放棄された <xref:System.Threading.Mutex> はシグナル状態になり、次に待機中のスレッドが所有権を取得します。  待機中のスレッドがない場合、<xref:System.Threading.Mutex> はシグナル状態のままになります。  例外をスローすることはありません。  
+  
+ システム全体で有効なミューテックスの場合、放棄されたミューテックスは、アプリケーションが \(たとえば Windows タスク マネージャーを使用して\) 強制終了されたことを示す場合があります。  
+  
+## ローカル ミューテックスとシステム ミューテックス  
+ ミューテックスには、ローカル ミューテックスと名前付きシステム ミューテックスの 2 つの種類があります。  名前を受け入れるコンストラクターを使用して <xref:System.Threading.Mutex> オブジェクトを作成すると、そのオブジェクトがその名前のオペレーティング システム オブジェクトに関連付けられます。  名前付きシステム ミューテックスは、オペレーティング システムを介して参照でき、プロセスの活動を同期化する目的で使用できます。  同じ名前付きシステム ミューテックスを表す複数の <xref:System.Threading.Mutex> オブジェクトを作成できます。また、<xref:System.Threading.Mutex.OpenExisting%2A> メソッドを使用して、既存の名前付きシステム ミューテックスを開くことができます。  
+  
+ ローカル ミューテックスは、現在のプロセス内部でのみ存在します。  ローカル ミューテックスは、ローカル <xref:System.Threading.Mutex> オブジェクトを参照するプロセス内のどのスレッドからでも使用できます。  各 <xref:System.Threading.Mutex> オブジェクトは個別のローカル ミューテックスです。  
+  
+### システム ミューテックスのアクセス制御セキュリティ  
+ .NET Framework Version 2.0 では、名前付きシステム オブジェクトに対して Windows アクセス制御セキュリティを照会して設定できます。  システム オブジェクトはグローバルで、外部のコードでもロックできるため、システム ミューテックスは作成した時点から保護することをお勧めします。  
+  
+ ミューテックスのアクセス制御セキュリティの詳細については、<xref:System.Security.AccessControl.MutexSecurity> クラスと <xref:System.Security.AccessControl.MutexAccessRule> クラス、<xref:System.Security.AccessControl.MutexRights> 列挙体、<xref:System.Threading.Mutex> クラスの <xref:System.Threading.Mutex.GetAccessControl%2A>、<xref:System.Threading.Mutex.SetAccessControl%2A>、<xref:System.Threading.Mutex.OpenExisting%2A> の各メソッド、および<xref:System.Threading.Mutex.%23ctor%28System.Boolean%2CSystem.String%2CSystem.Boolean%40%2CSystem.Security.AccessControl.MutexSecurity%29> コンストラクターを参照してください。  
+  
+## 参照  
+ <xref:System.Threading.Mutex>   
+ <xref:System.Threading.Mutex.%23ctor%2A>   
+ <xref:System.Security.AccessControl.MutexSecurity>   
+ <xref:System.Security.AccessControl.MutexAccessRule>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [監視](../Topic/Monitors.md)   
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)
\ No newline at end of file
diff --git a/docs/standard/threading/overview-of-synchronization-primitives.md b/docs/standard/threading/overview-of-synchronization-primitives.md
new file mode 100644
index 00000000000..c78a679ab78
--- /dev/null
+++ b/docs/standard/threading/overview-of-synchronization-primitives.md
@@ -0,0 +1,183 @@
+---
+title: "Overview of Synchronization Primitives | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization, threads"
+  - "threading [.NET Framework],synchronizing threads"
+  - "managed threading"
+ms.assetid: b782bcb8-da6a-4c6a-805f-2eb46d504309
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Overview of Synchronization Primitives
+.NET Framework には、スレッドの相互作用を制御したり競合状態を回避したりするためのさまざまな同期プリミティブが用意されています。  これらは、大きくは 3 つのカテゴリ \(ロック、シグナリング、インタロックされた操作\) に分類することができます。  
+  
+ これらのカテゴリはきちんと整理されたものでも、明確に定義されたものでもありません。つまり、複数のカテゴリの特性を持つ同期機構もあります。たとえば、1 つのスレッドを同時に解放するイベントは、機能的にロックに似ています。また、ロックの解放はシグナルと考えることができます。インタロックされた操作を使用してロックを作成できます。  しかし、これらのカテゴリは有用です。  
+  
+ スレッド同期は協調的であるということを忘れないようにするのが重要です。  1 つのスレッドが同期機構をバイパスして、保護リソースに直接アクセスしただけで、その同期機構は有効でなくなります。  
+  
+ この概要は、次のセクションで構成されています。  
+  
+-   [ロック](#locking)  
+  
+-   [シグナリング](#signaling)  
+  
+-   [軽量同期の種類](#lightweight_synchronization_types)  
+  
+-   [SpinWait](#spinwait)  
+  
+-   [インタロックされた操作](#interlocked_operations)  
+  
+<a name="locking"></a>   
+## ロック  
+ ロックは、リソースの制御を一度に 1 つのスレッドに渡したり、指定された数のスレッドに渡したりします。  ロックが使用されているときに排他ロックを要求したスレッドは、ロックが使用可能になるまでブロックされます。  
+  
+### 排他ロック  
+ ロックの最も単純な形式は C\# `lock` ステートメント \(Visual Basic では `SyncLock`\) であり、これでコード ブロックへのアクセスを制御します。  このようなブロックはしばしば、クリティカル セクションと呼ばれます。  `lock` ステートメントは <xref:System.Threading.Monitor> クラスの <xref:System.Threading.Monitor.Enter%2A> メソッドと <xref:System.Threading.Monitor.Exit%2A> メソッドを使用して実装され、`try…catch…finally` を使用してロックが解放されるようにします。  
+  
+ 一般的に、`lock` ステートメントを使用して小さいコード ブロックを保護して、1 つのメソッドより広げないようにするのが、<xref:System.Threading.Monitor> クラスを使用するための最適な方法です。  <xref:System.Threading.Monitor> クラスは強力ですが、孤立したロックやデッドロックが発生しやすくなります。  
+  
+#### Monitor クラス  
+ <xref:System.Threading.Monitor> クラスは、`lock` ステートメントと併せて使用できる追加機能を備えています。  
+  
+-   <xref:System.Threading.Monitor.TryEnter%2A> メソッドは、ブロックされている間に指定時間間隔後にリソースが解放されるのを待機するスレッドを可能にします。  このメソッドは、成功または失敗を示すブール値を返します。この値を使用して、デッドロックの可能性を検出して回避できます。  
+  
+-   <xref:System.Threading.Monitor.Wait%2A> メソッドは、クリティカル セクション内のスレッドで呼び出されます。  このメソッドは、リソースが再び使用可能になるまでリソースの制御を放棄し、ブロックされます。  
+  
+-   <xref:System.Threading.Monitor.Pulse%2A> メソッドと <xref:System.Threading.Monitor.PulseAll%2A> メソッドは、ロックを解放しようとしているスレッドや、1 つ以上のスレッドを実行待ちキューに入れるために <xref:System.Threading.Monitor.Wait%2A> を呼び出そうとしているスレッドを可能にして、それらのスレッドがロックを取得できるようにします。  
+  
+ <xref:System.Threading.Monitor.Wait%2A> メソッドのオーバーロードでのタイムアウトは、待機中のスレッドが実行待ちキューにエスケープすることを可能にします。  
+  
+ <xref:System.Threading.Monitor> クラスは、ロックに使用されるオブジェクトが <xref:System.MarshalByRefObject> から派生していれば、複数のアプリケーション ドメインでロックを提供できます。  
+  
+ <xref:System.Threading.Monitor> にはスレッド アフィニティがあります。  つまり、モニターに入ったスレッドは、<xref:System.Threading.Monitor.Exit%2A> または <xref:System.Threading.Monitor.Wait%2A> を呼び出すことによって終了しなければなりません。  
+  
+ <xref:System.Threading.Monitor> クラスはインスタンス化可能ではありません。  このメソッドは静的 \(Visual Basic では `Shared`\) であり、インスタンス化可能ロック オブジェクトに対して作用します。  
+  
+ 概念的概要については、「[監視](../Topic/Monitors.md)」を参照してください。  
+  
+#### Mutex クラス  
+ スレッドは、<xref:System.Threading.Mutex> をその <xref:System.Threading.WaitHandle.WaitOne%2A> メソッドのオーバーロードを呼び出すことによって要求します。  スレッドが待機を中止することができるように、タイムアウトを使用するオーバーロードが用意されています。  <xref:System.Threading.Monitor> クラスとは異なり、ミューテックスはローカルもグローバルも可能です。  グローバル ミューテックスは名前付きミューテックスとも呼ばれ、オペレーティング システム全体で可視です。したがって、複数のアプリケーション ドメインまたはプロセス内のスレッドの同期化に使用できます。  ローカル ミューテックスは <xref:System.MarshalByRefObject> から派生し、アプリケーション ドメインの境界を越えて使用できます。  
+  
+ さらに、<xref:System.Threading.Mutex> は <xref:System.Threading.WaitHandle> から派生します。これは、<xref:System.Threading.WaitHandle.WaitAll%2A> メソッド、<xref:System.Threading.WaitHandle.WaitAny%2A> メソッド、<xref:System.Threading.WaitHandle.SignalAndWait%2A> メソッドなど、<xref:System.Threading.WaitHandle> が提供するシグナリング機構とともに使用できることを意味します。  
+  
+ <xref:System.Threading.Monitor> と同様に、<xref:System.Threading.Mutex> にはスレッド アフィニティがあります。  <xref:System.Threading.Monitor> とは異なり、<xref:System.Threading.Mutex> はインスタンス化可能オブジェクトです。  
+  
+ 概念的概要については、「[Mutexes](../../../docs/standard/threading/mutexes.md)」を参照してください。  
+  
+#### SpinLock クラス  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降、<xref:System.Threading.Monitor> にとって必要なオーバーヘッドのためにパフォーマンスが低下する場合は、<xref:System.Threading.SpinLock> クラスを使用できるようになりました。  <xref:System.Threading.SpinLock> は、ロックされたクリティカル セクションを検出すると、ロックが使用可能になるまで単にループ内をスピンします。  ロックが保持される時間が非常に短い場合は、ブロックよりもスピンのほうがパフォーマンスがよいことがあります。  ただし、ロックが保持される期間が数十サイクル以上の場合、<xref:System.Threading.SpinLock> は <xref:System.Threading.Monitor> と同様のパフォーマンスを示しますが、使用する CPU サイクルが多くなるため、他のスレッドやプロセスのパフォーマンスが低下する可能性があります。  
+  
+### 他のロック  
+ ロックは排他的である必要はありません。  多くの場合、限定された数のスレッドがリソースに同時にアクセスすることを許可すると有用です。  セマフォおよびリーダー\/ライター ロックは、このようなプールされたリソース アクセスを制御することを意図して設計されています。  
+  
+#### ReaderWriterLock クラス  
+ <xref:System.Threading.ReaderWriterLockSlim> クラスは、データを変更するスレッド \(ライター\) がリソースへの排他アクセスを必要とするケースに対処します。  ライターがアクティブでない場合は、任意の数のリーダーが \(たとえば <xref:System.Threading.ReaderWriterLockSlim.EnterReadLock%2A> メソッドを呼び出して\) リソースにアクセスできます。  スレッドが \(たとえば <xref:System.Threading.ReaderWriterLockSlim.EnterWriteLock%2A> メソッドを呼び出して\) 排他アクセスを要求すると、後続のリーダーの要求は、既存のすべてのリーダーがロックを終了し、ライターがロックに参加して終了するまでブロックされます。  
+  
+ <xref:System.Threading.ReaderWriterLockSlim> にはスレッド アフィニティがあります。  
+  
+ 概念的概要については、「[Reader\-Writer Locks](../../../docs/standard/threading/reader-writer-locks.md)」を参照してください。  
+  
+#### Semaphore クラス  
+ <xref:System.Threading.Semaphore> クラスは、指定した数のスレッドがリソースにアクセスできるようにします。  リソースを要求する追加のスレッドは、スレッドがセマフォを解放するまでブロックされます。  
+  
+ <xref:System.Threading.Mutex> クラスと同様に、<xref:System.Threading.Semaphore> は <xref:System.Threading.WaitHandle> から派生します。  また、<xref:System.Threading.Mutex> と同様に、<xref:System.Threading.Semaphore> はローカルもグローバルも可能です。  アプリケーション ドメインの境界を越えて使用できます。  
+  
+ <xref:System.Threading.Monitor>、<xref:System.Threading.Mutex>、<xref:System.Threading.ReaderWriterLock> とは異なり、<xref:System.Threading.Semaphore> にはスレッド アフィニティがありません。  これは、1 つのスレッドがセマフォを取得して別のスレッドがそれを解放するシナリオで使用できることを意味します。  
+  
+ 概念的概要については、「[Semaphore and SemaphoreSlim](../../../docs/standard/threading/semaphore-and-semaphoreslim.md)」を参照してください。  
+  
+ <xref:System.Threading.SemaphoreSlim?displayProperty=fullName> は、1 つのプロセス境界内の同期化のための軽量セマフォです。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="signaling"></a>   
+## シグナリング  
+ 別のスレッドからのシグナルを待機する最も簡単な方法は、<xref:System.Threading.Thread.Join%2A> メソッドを呼び出すことです。これにより、他方のスレッドが完了するまでブロックされます。  <xref:System.Threading.Thread.Join%2A> には、ブロックされたスレッドが指定時間間隔経過後に待機から抜け出すことを許可する 2 つのオーバーロードがあります。  
+  
+ 待機ハンドルは、待機機能とシグナリング機能の非常に豊富なセットを提供します。  
+  
+### 待機ハンドル  
+ 待機ハンドルは <xref:System.Threading.WaitHandle> クラスから派生し、このクラスは <xref:System.MarshalByRefObject> から派生します。  したがって、待機ハンドルを使用して、アプリケーション ドメインの境界を越えてスレッドのアクティビティを同期させることができます。  
+  
+ インスタンス メソッド <xref:System.Threading.WaitHandle.WaitOne%2A> か、静的メソッド <xref:System.Threading.WaitHandle.WaitAll%2A>、<xref:System.Threading.WaitHandle.WaitAny%2A>、<xref:System.Threading.WaitHandle.SignalAndWait%2A> のいずれかを呼び出すことによって、スレッドは待機ハンドルでブロックされます。  それらがどのように解放されるかは、呼び出されたメソッドと待機ハンドルの種類に応じて決まります。  
+  
+ 概念的概要については、「[Wait Handles](../Topic/Wait%20Handles.md)」を参照してください。  
+  
+#### イベント待機ハンドル  
+ イベント待機ハンドルには、<xref:System.Threading.EventWaitHandle> クラスとその派生クラスの <xref:System.Threading.AutoResetEvent> および <xref:System.Threading.ManualResetEvent> が含まれます。  <xref:System.Threading.EventWaitHandle.Set%2A> メソッドを呼び出すか <xref:System.Threading.WaitHandle.SignalAndWait%2A> メソッドを使用してイベント待機ハンドルに通知されると、スレッドはイベント待機ハンドルから解放されます。  
+  
+ イベント待機ハンドルは、通知されるたびにスレッドが 1 つだけ通過できるようにする回転ドアのように、自身を自動的にリセットします。あるいは、通知されるまで閉じていてだれかが閉じるまで開いているゲートのように、手動でリセットされる必要があります。  名前が示すとおり、<xref:System.Threading.AutoResetEvent> と <xref:System.Threading.ManualResetEvent> はそれぞれ前者と後者を表します。  <xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> は、1 つのプロセス境界内の同期化のための軽量イベントです。  
+  
+ <xref:System.Threading.EventWaitHandle> はイベントのいずれかの種類を表すことができ、ローカルもグローバルも可能です。  派生クラスの <xref:System.Threading.AutoResetEvent> と <xref:System.Threading.ManualResetEvent> は常にローカルです。  
+  
+ イベント待機ハンドルにはスレッド アフィニティがありません。  どのスレッドもイベント待機ハンドルに通知できます。  
+  
+ 概念的概要については、「[EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)」を参照してください。  
+  
+#### Mutex クラスと Semaphore クラス  
+ <xref:System.Threading.Mutex> クラスと <xref:System.Threading.Semaphore> クラスは、<xref:System.Threading.WaitHandle> から派生するので、<xref:System.Threading.WaitHandle> の静的メソッドとともに使用できます。  たとえば、スレッドは <xref:System.Threading.WaitHandle.WaitAll%2A> メソッドを使用して、「<xref:System.Threading.EventWaitHandle> に通知された」、「<xref:System.Threading.Mutex> が解放された」、「<xref:System.Threading.Semaphore> が解放された」の 3 つの条件がすべて該当するまで待機できます。  同じように、スレッドは <xref:System.Threading.WaitHandle.WaitAny%2A> メソッドを使用して、それらの条件のいずれか 1 つが該当するまで待機することができます。  
+  
+ <xref:System.Threading.Mutex> または <xref:System.Threading.Semaphore> にとって、通知されるということは解放されるということを意味します。  いずれかの種類が <xref:System.Threading.WaitHandle.SignalAndWait%2A> メソッドの最初の引数として使用されると、それが解放されます。  スレッド アフィニティのある <xref:System.Threading.Mutex> については、呼び出し元のスレッドがミューテックスを所有していなければ、例外がスローされます。  既に説明したように、セマフォにはスレッド アフィニティがありません。  
+  
+#### バリア  
+ <xref:System.Threading.Barrier> クラスは、複数のスレッドを周期的に同期させるようにするためのものです。その結果、それらすべてが同じポイントでブロックされ、他のすべてのスレッドが完了するのを待機するようになります。  バリアは、1 つまたは複数のスレッドが、アルゴリズムの次のフェーズに進む前に別のスレッドの結果を必要とする場合に有用です。  詳細については、「[Barrier](../../../docs/standard/threading/barrier.md)」を参照してください。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="lightweight_synchronization_types"></a>   
+## 軽量同期の種類  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降、高速パフォーマンスが得られる同期プリミティブを使用できるようになりました。この場合、待機ハンドルなど Win32 カーネル オブジェクトへの高コストの依存が可能な限り回避されます。  これらのタイプは一般に、待機時間が短く、かつオリジナルの同期タイプを試してみて満足できないことが分かったときだけ使用するようにしてください。  プロセス間通信を必要とするシナリオでは、軽量タイプを使用できません。  
+  
+-   <xref:System.Threading.SemaphoreSlim?displayProperty=fullName> は <xref:System.Threading.Semaphore?displayProperty=fullName> の軽量バージョンです。  
+  
+-   <xref:System.Threading.ManualResetEventSlim?displayProperty=fullName> は <xref:System.Threading.ManualResetEvent?displayProperty=fullName> の軽量バージョンです。  
+  
+-   <xref:System.Threading.CountdownEvent?displayProperty=fullName> は、そのカウントが 0 になると通知されるようになるイベントを表します。  
+  
+-   <xref:System.Threading.Barrier?displayProperty=fullName> は、マスター スレッドによる制御を必要とせずに複数のスレッドを相互に同期させることができるようにします。  バリアは、指定されたポイントにすべてのスレッドが達するまで各スレッドが続行するのを防止します。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="spinwait"></a>   
+## SpinWait  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降、<xref:System.Threading.SpinWait?displayProperty=fullName> 構造体を使用できるようになりました。この構造体は、イベントが通知されるか条件が満たされるのをスレッドが待機する必要があるが、待機ハンドルを使用するかあるいは現在のスレッドをブロックする際に必要な待機時間よりも実際の待機時間が短いと思われる場合に使用します。  <xref:System.Threading.SpinWait> を使用することにより、待機中はスピンし、指定した時間内に条件が満たされなかった場合のみ \(たとえば待機またはスリープして\) 譲渡するための短い時間を指定できます。  
+  
+ [ページのトップへ](#top)  
+  
+<a name="interlocked_operations"></a>   
+## インタロックされた操作  
+ インタロックされた操作とは、<xref:System.Threading.Interlocked> クラスの静的メソッドによって実行される、メモリ位置に対する単純なアトミック操作のことです。  それらのアトミック操作としては、32 ビット プラットフォーム上の 64 ビット値を対象とした追加、インクリメントとデクリメント、交換、比較による条件付き交換、読み取りの各操作があります。  
+  
+> [!NOTE]
+>  アトミック性の保証は個々 の操作に限定されます。複数の操作を 1 つの単位として実行する必要がある場合は、より粒度の粗い同期機構を使用する必要があります。  
+  
+ これらの操作は、どれもロックやシグナルではありませんが、ロックやシグナルの作成に使用できます。  これらは Windows オペレーティング システムのネイティブなので、インタロックされた操作は非常に高速です。  
+  
+ インタロックされた操作を揮発性メモリの保証下で使用して、強力な非ブロッキング同時実行を示すアプリケーションを作成できます。  ただし、高度な低レベル プログラミングが必要になるので、ほとんどの目的では、単純ロックを選択したほうが適切です。  
+  
+ 概念的概要については、「[Interlocked Operations](../../../docs/standard/threading/interlocked-operations.md)」を参照してください。  
+  
+## 参照  
+ [Synchronizing Data for Multithreading](../../../docs/standard/threading/synchronizing-data-for-multithreading.md)   
+ [監視](../Topic/Monitors.md)   
+ [Mutexes](../../../docs/standard/threading/mutexes.md)   
+ [Semaphore and SemaphoreSlim](../../../docs/standard/threading/semaphore-and-semaphoreslim.md)   
+ [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)   
+ [Wait Handles](../Topic/Wait%20Handles.md)   
+ [Interlocked Operations](../../../docs/standard/threading/interlocked-operations.md)   
+ [Reader\-Writer Locks](../../../docs/standard/threading/reader-writer-locks.md)   
+ [Barrier](../../../docs/standard/threading/barrier.md)   
+ [SpinWait](../../../docs/standard/threading/spinwait.md)   
+ [SpinLock](../../../docs/standard/threading/spinlock.md)
\ No newline at end of file
diff --git a/docs/standard/threading/pausing-and-resuming-threads.md b/docs/standard/threading/pausing-and-resuming-threads.md
new file mode 100644
index 00000000000..e7fd8674bfa
--- /dev/null
+++ b/docs/standard/threading/pausing-and-resuming-threads.md
@@ -0,0 +1,61 @@
+---
+title: "Pausing and Resuming Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "resuming threads"
+  - "threading [.NET Framework], pausing"
+  - "pausing threads"
+ms.assetid: 9fce4859-a19d-4506-b082-7dd0792688ca
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Pausing and Resuming Threads
+スレッドの活動を同期する最も一般的な方法は、スレッドのブロックと解放を行うか、コード領域またはオブジェクトをロックすることです。  ロックとブロックのしくみの詳細については、「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+ また、スレッドそのものをスリープ状態にすることもできます。  スレッドがブロックされているかまたはスリープ状態の場合は、<xref:System.Threading.ThreadInterruptedException> を使用して待機状態を解除できます。  
+  
+## Thread.Sleep メソッド  
+ <xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> メソッドを呼び出すと、現在のスレッドはすぐに <xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> に渡した何ミリ秒かの間ブロックされ、残りのタイム スライスはもう一方のスレッドに明け渡されます。  もう一方のスレッドが他方のスレッドに対して <xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> を呼び出すことはできません。  
+  
+ <xref:System.Threading.Timeout.Infinite?displayProperty=fullName> を指定して <xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> を呼び出すと、スレッドは、<xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> を呼び出す別のスレッドによって中断されるまで、または <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> によって中止されるまで、スリープ状態になります。  
+  
+## スレッドの中断  
+ 待機中のスレッドに割り込むには、ブロックされているスレッドに対して <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> を呼び出して <xref:System.Threading.ThreadInterruptedException> をスローさせることができます。これにより、待機中のスレッドは中断され、ブロックしている呼び出しから抜け出します。  スレッドは、<xref:System.Threading.ThreadInterruptedException> をキャッチし、操作を継続するために適切な処理を行う必要があります。  スレッドがこの例外を無視した場合は、ランタイムがこの例外をキャッチし、そのスレッドを停止します。  
+  
+> [!NOTE]
+>  <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> が呼び出されたときに対象となるスレッドがブロックされていない場合、スレッドはブロックされるまで中断されません。  スレッドがまったくブロックされない場合は、中断されることなく完了することがあります。  
+  
+ 待機がマネージ待機である場合、<xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> はどちらもすぐにスレッドを起動します。  待機がアンマネージ待機の場合 \(プラットフォームが Win32 `WaitForSingleObject` 関数を呼び出した場合など\)、<xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> はどちらも、スレッドがマネージ コードに戻るか、またはマネージ コードを呼び出すまで、そのスレッドを制御できません。  マネージ コードの動作は次のとおりです。  
+  
+-   <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> はスレッドをどのような待機からも起動し、これによって起動先のスレッドで <xref:System.Threading.ThreadInterruptedException> がスローされます。  
+  
+-   <xref:System.Threading.Thread.Abort%2A?displayProperty=fullName> は、スレッドで <xref:System.Threading.ThreadAbortException> がスローされる点を除き、<xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> と同様です。  詳細については、「[スレッドの破棄](../../../docs/standard/threading/destroying-threads.md)」を参照してください。  
+  
+## 中断と再開 \(古い形式\)  
+ <xref:System.Threading.Thread> クラスには、スレッドの一時停止と再開を行う 2 つのメソッドとして <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> が含まれています。  ただし、これらのメソッドの使用は推奨されません。  
+  
+> [!IMPORTANT]
+>  .NET Framework version 2.0 以降で、<xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> メソッドは古い形式としてマークされており、今後のリリースで削除される予定です。  
+>   
+>  <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> メソッドは一般にアプリケーションに役立つことはなく、同期メカニズムと混同してはなりません。  <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> と <xref:System.Threading.Thread.Resume%2A?displayProperty=fullName> は、制御されているスレッドの連携に依存していないため、侵害性が高く、デッドロック \(別のスレッドが必要とするリソースを保持するスレッドを一時停止した場合など\) のような深刻なアプリケーション問題の原因となる可能性があります。  
+  
+ アプリケーションによっては、パフォーマンスを向上させるために、スレッドの優先順位を制御する必要があります。  スレッドの優先順位を制御するには、<xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> ではなく <xref:System.Threading.Thread.Priority%2A?displayProperty=fullName> プロパティを使用してください。  
+  
+## 参照  
+ <xref:System.Threading.Thread>   
+ <xref:System.Threading.ThreadInterruptedException>   
+ <xref:System.Threading.ThreadAbortException>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)   
+ [Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)
\ No newline at end of file
diff --git a/docs/standard/threading/reader-writer-locks.md b/docs/standard/threading/reader-writer-locks.md
new file mode 100644
index 00000000000..1da3c27cd80
--- /dev/null
+++ b/docs/standard/threading/reader-writer-locks.md
@@ -0,0 +1,38 @@
+---
+title: "Reader-Writer Locks | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "ReaderWriterLock class, about ReaderWriterLock class"
+  - "threading [.NET Framework], ReaderWriterLock class"
+ms.assetid: 8c71acf2-2c18-4f4d-8cdb-0728639265fd
+caps.latest.revision: 11
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 11
+---
+# Reader-Writer Locks
+<xref:System.Threading.ReaderWriterLockSlim> クラスを使用すると、複数のスレッドが同時に 1 つのリソースを読み出すことができまが、リソースに書き込むためには、排他的なロックを待機する必要があります。  
+  
+ アプリケーションでは、<xref:System.Threading.ReaderWriterLockSlim> を使用して、リソースを共有しているスレッドの協調的な同期をとることができます。  ロックは <xref:System.Threading.ReaderWriterLockSlim> 自体によって制御されます。  
+  
+ 他のスレッド同期機構と同様に、<xref:System.Threading.ReaderWriterLockSlim> によって提供されるロックを回避するスレッドがないようにすることが必要です。  1 つの方法として、共有リソースをカプセル化するクラスをデザインする方法があります。  このクラスは、プライベートな共有リソースにアクセスするメンバーを提供します。このメンバーは、プライベートな <xref:System.Threading.ReaderWriterLockSlim> を使用して同期を行います。  たとえば、<xref:System.Threading.ReaderWriterLockSlim> クラスのコード例を参照してください。  <xref:System.Threading.ReaderWriterLockSlim> は効率的に動作するようにデザインされているので、個々のオブジェクトの同期に使用できます。  
+  
+ 読み取り操作と書き込み操作の時間を最小限にするように、アプリケーションの構造をデザインしてください。  書き込みロックは排他的なので、書き込み操作の時間が長いと、その分、スループットが低下します。  読み取り操作時間が長いと、書き込みスレッドを待たせることになります。また、書き込みアクセスのために待機しているスレッドが 1 つでもあると、読み取りアクセスを要求するスレッドもブロックされます。  
+  
+> [!NOTE]
+>  [!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] には、<xref:System.Threading.ReaderWriterLockSlim> と <xref:System.Threading.ReaderWriterLock> という 2 つのリーダー\/ライター ロックがあります。  すべての新規開発で、<xref:System.Threading.ReaderWriterLockSlim> を使用することをお勧めします。  <xref:System.Threading.ReaderWriterLockSlim> は <xref:System.Threading.ReaderWriterLock> と似ていますが、再帰の規則や、ロック状態のアップグレードおよびダウングレードの規則が簡素化されています。  <xref:System.Threading.ReaderWriterLockSlim> は、デッドロックの可能性を大幅に回避します。  さらに、<xref:System.Threading.ReaderWriterLockSlim> のパフォーマンスは <xref:System.Threading.ReaderWriterLock> と比較して格段に優れています。  
+  
+## 参照  
+ <xref:System.Threading.ReaderWriterLockSlim>   
+ <xref:System.Threading.ReaderWriterLock>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/scheduling-threads.md b/docs/standard/threading/scheduling-threads.md
new file mode 100644
index 00000000000..8bd52ef4127
--- /dev/null
+++ b/docs/standard/threading/scheduling-threads.md
@@ -0,0 +1,29 @@
+---
+title: "Scheduling Threads | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], scheduling"
+  - "scheduling threads"
+ms.assetid: 67e4a0eb-3095-4ea7-b20f-908faa476277
+caps.latest.revision: 6
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 6
+---
+# Scheduling Threads
+すべてのスレッドには、スレッド優先順位が割り当てられます。  共通言語ランタイム内で作成されたスレッドには、初期状態で **ThreadPriority.Normal** の優先順位が割り当てられます。  ランタイムがの外部で作成されたスレッドは、マネージ環境に入る前に設定されていた優先順位が維持されます。  任意のスレッドの優先順位を取得または設定するには、**Thread.Priority** プロパティを使用します。  
+  
+ スレッドの実行は、優先順位に基づいてスケジュールされます。  スレッドがランタイム内で実行されている場合でも、オペレーティング システムは、すべてのスレッドにプロセッサ タイム スライスを割り当てます。  スレッドの実行順序を決定するために使用されるスケジューリング アルゴリズムの詳細は、オペレーティング システムによって異なります。  オペレーティング システムによっては、実行可能なスレッドの中で最も優先順位の高いスレッドが常に最初に実行されるようにスケジュールされます。  同じ優先順位を持つ複数のスレッドがすべて実行可能である場合、スケジューラは、その優先順位にあるスレッド間を循環することで各スレッドに一定の実行用タイム スライスを与えます。  より優先順位の高いスレッドが実行可能である限り、それよりも優先順位の低いスレッドは実行されません。  特定の優先順位を持つ実行可能なスレッドがなくなると、スケジューラは次に低い優先順位に移り、その優先順位にあるスレッドの実行をスケジュールします。  より優先順位の高いスレッドが実行可能になった場合も、それよりも優先順位の低いスレッドの代わりに優先順位の高いスレッドが実行されます。  また、オペレーティング システムは、アプリケーションのユーザー インターフェイスをフォアグラウンドとバックグラウンド間で移動させながら、スレッドの優先順位を動的に調整することもできます。  オペレーティング システムによっては、別のスケジューリング アルゴリズムが使用される場合があります。  
+  
+## 参照  
+ [Using Threads and Threading](../../../docs/standard/threading/using-threads-and-threading.md)   
+ [Managed and Unmanaged Threading in Windows](../../../docs/standard/threading/managed-and-unmanaged-threading-in-windows.md)
\ No newline at end of file
diff --git a/docs/standard/threading/semaphore-and-semaphoreslim.md b/docs/standard/threading/semaphore-and-semaphoreslim.md
new file mode 100644
index 00000000000..b60a6f1ae41
--- /dev/null
+++ b/docs/standard/threading/semaphore-and-semaphoreslim.md
@@ -0,0 +1,56 @@
+---
+title: "Semaphore and SemaphoreSlim | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "counting semaphores"
+  - "semaphores"
+  - "threading [.NET Framework], cross-process synchronization"
+  - "Semaphore class, about Semaphore class"
+  - "SemaphoreSlim class, about SemaphoreSlim class"
+  - "threading [.NET Framework], Semaphore class"
+ms.assetid: 7722a333-b974-47a2-a7c0-f09097fb644e
+caps.latest.revision: 17
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 17
+---
+# Semaphore and SemaphoreSlim
+<xref:System.Threading.Semaphore?displayProperty=fullName> クラスは、名前付きセマフォ \(システム全体\) またはローカル セマフォを表します。  これは、Win32 セマフォ オブジェクトの Thin ラッパーです。  Win32 セマフォは、リソースのプールへのアクセスの制御に使用できるカウント セマフォです。  
+  
+ <xref:System.Threading.SemaphoreSlim> クラスは軽量で高速のセマフォを表しており、非常に短い待機時間が期待されている場合に単一プロセス内で待機のために使用できます。  <xref:System.Threading.SemaphoreSlim> は、共通言語ランタイム \(CLR\) により提供される同期プリミティブに可能な限り依存します。  ただし、複数のセマフォでの待機をサポートする必要がある場合は、遅れて初期化されるカーネル ベースの待機ハンドルも提供します。  <xref:System.Threading.SemaphoreSlim> はキャンセル トークンの使用もサポートしていますが、名前付きセマフォや、同期での待機ハンドルの使用はサポートしていません。  
+  
+## 制限されているリソースの管理  
+ スレッドは、<xref:System.Threading.WaitHandle.WaitOne%2A> メソッドを呼び出してセマフォに入ります。このメソッドは <xref:System.Threading.WaitHandle> クラスから継承されるか \(<xref:System.Threading.Semaphore?displayProperty=fullName> オブジェクトの場合\)、<xref:System.Threading.SemaphoreSlim.Wait%2A?displayProperty=fullName> メソッドまたは <xref:System.Threading.SemaphoreSlim.WaitAsync%2A?displayProperty=fullName> メソッドから継承されます \(<xref:System.Threading.SemaphoreSlim> オブジェクトの場合\)。  呼び出しが戻されると、セマフォのカウントがデクリメントします。  スレッドがエントリを要求し、カウントがゼロの場合、そのスレッドはブロックされます。  スレッドが <xref:System.Threading.Semaphore.Release%2A?displayProperty=fullName> メソッドまたは <xref:System.Threading.SemaphoreSlim.Release%2A?displayProperty=fullName> メソッドを呼び出してセマフォを解放すると、ブロックされたスレッドがセマフォに入ることができるようになります。  ブロックされたスレッドがセマフォに入る順序には、先入れ先出し \(FIFO\) や後入れ先出し \(LIFO\) などの決まった順序がありません。  
+  
+ スレッドは、<xref:System.Threading.Semaphore?displayProperty=fullName> オブジェクトの <xref:System.Threading.WaitHandle.WaitOne%2A> メソッドまたは <xref:System.Threading.SemaphoreSlim> オブジェクトの <xref:System.Threading.SemaphoreSlim.Wait%2A> メソッドを繰り返し呼び出すことで、セマフォに複数回入ることができます。  セマフォを解放するために、スレッドは、<xref:System.Threading.Semaphore.Release?displayProperty=fullName> メソッド オーバーロードまたは <xref:System.Threading.SemaphoreSlim.Release?displayProperty=fullName> メソッド オーバーロードを同じ回数呼び出すか、<xref:System.Threading.Semaphore.Release%28System.Int32%29?displayProperty=fullName> メソッド オーバーロードまたは <xref:System.Threading.SemaphoreSlim.Release%28System.Int32%29?displayProperty=fullName> メソッド オーバーロードを呼び出して、解放するエントリ数を指定します。  
+  
+### セマフォとスレッド ID  
+ この 2 つの種類のセマフォは、<xref:System.Threading.WaitHandle.WaitOne%2A>、<xref:System.Threading.SemaphoreSlim.Wait%2A>、<xref:System.Threading.Semaphore.Release%2A>、および <xref:System.Threading.SemaphoreSlim.Release%2A?displayProperty=fullName> の各メソッドの呼び出しでスレッド ID を適用しません。  たとえば、セマフォの一般的な使用シナリオでは、producer スレッドと consumer スレッドが使用され、一方のスレッドが常にセマフォ カウントをインクリメントし、もう一方のスレッドが常にセマフォ カウントをデクリメントします。  
+  
+ プログラマは、スレッドによるセマフォの解放回数が多くなりすぎないようにする必要があります。  たとえば、セマフォの最大カウントが 2 で、スレッド A とスレッド B が両方ともセマフォに入るとします。  スレッド B がプログラミング エラーのために `Release` を 2 回呼び出した場合、この呼び出しは両方とも成功します。  セマフォのカウントがいっぱいになっているときに、スレッド A も `Release` を呼び出すと、<xref:System.Threading.SemaphoreFullException> がスローされます。  
+  
+## 名前付きセマフォ  
+ Windows オペレーティング システムでは、セマフォに名前を付けることができます。  名前付きセマフォはシステム全体でのセマフォです。  つまり、名前付きセマフォは、作成されると、すべてのプロセスのすべてのスレッドで認識されるようになります。  そのため、名前付きセマフォは、プロセスおよびスレッドのアクティビティを同期するために使用できます。  
+  
+ 名前を指定するコンストラクターのいずれかを使用して、名前付きシステム セマフォを表す <xref:System.Threading.Semaphore> オブジェクトを作成できます。  
+  
+> [!NOTE]
+>  名前付きセマフォはシステム全体でのセマフォであるため、同じ名前付きセマフォを表す複数の <xref:System.Threading.Semaphore> オブジェクトが存在する可能性があります。  コンストラクターまたは <xref:System.Threading.Semaphore.OpenExisting%2A?displayProperty=fullName> メソッドを呼び出すたびに、新しい <xref:System.Threading.Semaphore> オブジェクトが作成されます。  同じ名前を繰り返し指定すると、同じ名前付きセマフォを表す複数のオブジェクトが作成されます。  
+  
+ 名前付きセマフォを使用する際には注意する必要があります。  システム全体でのセマフォであるため、同じ名前を使用する別のプロセスが予期せずセマフォに入る可能性があります。  同じコンピューター上で実行される悪意のあるコードが、これをサービス拒否攻撃の土台として使用する可能性があります。  
+  
+ アクセス制御セキュリティを使用して、名前付きセマフォを表す <xref:System.Threading.Semaphore> オブジェクトを保護します。可能であれば <xref:System.Security.AccessControl.SemaphoreSecurity?displayProperty=fullName> オブジェクトを指定するコンストラクターを使用して保護します。  <xref:System.Threading.Semaphore.SetAccessControl%2A?displayProperty=fullName> メソッドを使用してアクセス制御セキュリティを適用することもできますが、この場合、セマフォが作成されてから保護されるまでの間に無防備な時間帯が生じてしまいます。  アクセス制御セキュリティによりセマフォを保護すると、悪意のある攻撃を防ぐことができますが、意図しない名前の競合の問題の解決にはなりません。  
+  
+## 参照  
+ <xref:System.Threading.Semaphore>   
+ <xref:System.Threading.SemaphoreSlim>   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/spinlock.md b/docs/standard/threading/spinlock.md
new file mode 100644
index 00000000000..c3f2d3d2cd7
--- /dev/null
+++ b/docs/standard/threading/spinlock.md
@@ -0,0 +1,33 @@
+---
+title: "SpinLock | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization primitives, SpinLock"
+ms.assetid: f9af93bb-7a0d-4ba5-afe8-74f48b6b6958
+caps.latest.revision: 8
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 8
+---
+# SpinLock
+<xref:System.Threading.SpinLock> 構造体は、ロックの取得待機中にスピンする下位レベルの相互排他的な同期プリミティブです。  マルチコア コンピューターで、待機時間が短くなると予測され、競合が最小限に抑えられる場合、<xref:System.Threading.SpinLock> は他の種類のロックよりも優れたパフォーマンスを示すことがあります。  ただし、<xref:System.Threading.SpinLock> を使用するのは、<xref:System.Threading.Monitor?displayProperty=fullName> メソッドまたは <xref:System.Threading.Interlocked> メソッドによってプログラムのパフォーマンスが大幅に低下していることがプロファイリングにより判明している場合に限定することをお勧めします。  
+  
+ <xref:System.Threading.SpinLock> は、ロックをまだ取得していない場合でも、スレッドのタイム スライスを明け渡す可能性があります。  このようにすることで、スレッドの優先順位の逆転を防止し、ガベージ コレクターが処理を進められるようにします。  <xref:System.Threading.SpinLock> を使用する場合は、スレッドでロックが保持される期間を非常に短くし、ロックの保持中はブロックできないようにしてください。  
+  
+ SpinLock は値型であるため、2 つのコピーで同じロックを参照する場合は、参照渡しで明示的に渡す必要があります。  
+  
+ この型の使用方法の詳細については、「<xref:System.Threading.SpinLock?displayProperty=fullName>」を参照してください。  例については、「[How to: Use SpinLock for Low\-Level Synchronization](../../../docs/standard/threading/how-to-use-spinlock-for-low-level-synchronization.md)」を参照してください。  
+  
+ <xref:System.Threading.SpinLock> では、*スレッド* *追跡*モードがサポートされています。このモードは開発フェーズで使用でき、特定の時間にロックを保持しているスレッドを追跡するのに役立ちます。  スレッド追跡モードはデバッグに非常に有用ですが、パフォーマンスを低下させる可能性があるため、プログラムのリリース バージョンでは無効にすることをお勧めします。  詳細については、「[How to: Enable Thread\-Tracking Mode in SpinLock](../../../docs/standard/threading/how-to-enable-thread-tracking-mode-in-spinlock.md)」を参照してください。  
+  
+## 参照  
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/spinwait.md b/docs/standard/threading/spinwait.md
new file mode 100644
index 00000000000..82a7af77b0e
--- /dev/null
+++ b/docs/standard/threading/spinwait.md
@@ -0,0 +1,35 @@
+---
+title: "SpinWait | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization primitives, SpinWait"
+ms.assetid: 36012f42-34e5-4f86-adf4-973f433ed6c6
+caps.latest.revision: 9
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 9
+---
+# SpinWait
+<xref:System.Threading.SpinWait?displayProperty=fullName> は軽量な同期型で、負荷が高いコンテキスト スイッチやカーネル イベントに必要なカーネル遷移を避けるために下位レベルのシナリオで使用できます。  マルチコア コンピューターでは、リソースの保持時間が長くならないと予測される場合、待機中のスレッドを数十または数百サイクルの間ユーザー モードでスピンさせてから、リソースの取得を再試行した方が効率的です。  スピン後にリソースを使用できる場合は、数千サイクルを節約したことになります。  リソースをまだ使用できない場合でも、数サイクルを消費しただけであり、カーネル ベースの待機に移行できます。  スピン後に待機というこの組み合わせは、*2 フェーズ待機操作*と呼ばれることがあります。  
+  
+ <xref:System.Threading.SpinWait> は、<xref:System.Threading.ManualResetEvent> などのカーネル イベントをラップする .NET Framework 型と共に使用するように設計されています。  また、<xref:System.Threading.SpinWait> は、1 つのプログラムで基本的なスピン機能のために単独で使用することもできます。  
+  
+ <xref:System.Threading.SpinWait> は単なる空のループではありません。  一般的に、適切なスピン動作を提供するためには慎重に実装する必要があり、長時間 \(おおよそ、カーネル遷移に要する時間\) スピンすると、コンテキスト スイッチが開始されます。  たとえば、シングルコア コンピューターでは、スピンはすべてのスレッドの進行をブロックするので、<xref:System.Threading.SpinWait> はスレッドのタイム スライスを直ちに譲渡します。  マルチコア コンピューターでも、<xref:System.Threading.SpinWait> は、待機中のスレッドがより優先順位の高いスレッドやガベージ コレクターをブロックしないように譲渡します。  したがって、<xref:System.Threading.SpinWait> を 2 フェーズ待機操作で使用する場合は、<xref:System.Threading.SpinWait> 自体がコンテキスト スイッチを開始する前にカーネル待機を呼び出すことをお勧めします。  <xref:System.Threading.SpinWait> には <xref:System.Threading.SpinWait.NextSpinWillYield%2A> プロパティがあり、<xref:System.Threading.SpinWait.SpinOnce%2A> に対する毎回の呼び出しの前にこのプロパティをチェックできます。  このプロパティから `true` が返された場合、独自の待機操作が開始されます。  例については、「[How to: Use SpinWait to Implement a Two\-Phase Wait Operation](../../../docs/standard/threading/how-to-use-spinwait-to-implement-a-two-phase-wait-operation.md)」を参照してください。  
+  
+ 2 フェーズ待機操作は実行せずに、特定の条件が満たされるまでスピンを行うだけの場合は、Windows オペレーティング システム環境で問題を発生させることなく、<xref:System.Threading.SpinWait> を有効にしてコンテキスト スイッチを実行できます。  ロック制御の不要なスタックの <xref:System.Threading.SpinWait> を次の基本的な例に示します。  高パフォーマンスのスレッド セーフ スタックが必要な場合は、<xref:System.Collections.Concurrent.ConcurrentStack%601?displayProperty=fullName> の使用を検討してください。  
+  
+ [!code-csharp[CDS_SpinWait#05](../../../samples/snippets/csharp/VS_Snippets_Misc/cds_spinwait/cs/spinwait.cs#05)]
+ [!code-vb[CDS_SpinWait#05](../../../samples/snippets/visualbasic/VS_Snippets_Misc/cds_spinwait/vb/cds_spinwait1.vb#05)]  
+  
+## 参照  
+ <xref:System.Threading.Thread.SpinWait%2A>   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/synchronizing-data-for-multithreading.md b/docs/standard/threading/synchronizing-data-for-multithreading.md
new file mode 100644
index 00000000000..781bbc36169
--- /dev/null
+++ b/docs/standard/threading/synchronizing-data-for-multithreading.md
@@ -0,0 +1,79 @@
+---
+title: "Synchronizing Data for Multithreading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "synchronization, threads"
+  - "threading [.NET Framework], synchronizing threads"
+  - "managed threading"
+ms.assetid: b980eb4c-71d5-4860-864a-6dfe3692430a
+caps.latest.revision: 16
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 16
+---
+# Synchronizing Data for Multithreading
+複数のスレッドが同じオブジェクトのプロパティとメソッドを呼び出す場合は、これらの呼び出しを同期することが重要です。  同期しないと、1 つのスレッドが行っていることを別のスレッドが中断し、オブジェクトが無効な状態になってしまうことがあります。  メンバーがこのような干渉を受けないように保護されているクラスを、スレッド セーフと呼びます。  
+  
+ 共通言語基盤には、インスタンスと静的メンバーへのアクセスを同期するいくつかの方法が用意されています。  
+  
+-   同期されたコード領域。  <xref:System.Threading.Monitor> クラス、またはこのクラスのコンパイラ サポートを使用して、パフォーマンスを向上させながら、同期を必要とするコード ブロックだけを同期できます。  
+  
+-   手動同期。  .NET Framework クラス ライブラリに用意されている同期オブジェクトを使用できます。  <xref:System.Threading.Monitor> クラスについての説明が記載されている「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+-   同期されたコンテキスト。  <xref:System.Runtime.Remoting.Contexts.SynchronizationAttribute> を使用すると、<xref:System.ContextBoundObject> オブジェクトに対して単純な自動同期を有効にできます。  
+  
+-   <xref:System.Collections.Concurrent?displayProperty=fullName> 名前空間のコレクション クラス。  これらのクラスには、同期された追加操作および削除操作が組み込まれています。  詳細については、「[スレッド セーフなコレクション](../../../docs/standard/collections/thread-safe/index.md)」を参照してください。  
+  
+ 共通言語ランタイムにはスレッド モデルが用意されていて、要件に応じたさまざまな方法で同期することができる多数のカテゴリにクラスを分類できます。  次の表で、各同期カテゴリで提供されるフィールドおよびメソッドに対する同期サポートを示します。  
+  
+|分類|グローバル フィールド|静的フィールド|静的メソッド|インスタンス フィールド|インスタンス メソッド|特定のコード ブロック|  
+|--------|-----------------|-------------|------------|------------------|-----------------|-----------------|  
+|同期なし|No|No|No|No|No|No|  
+|同期されたコンテキスト|No|No|No|Yes|Yes|No|  
+|同期されたコード領域|No|No|マークされている場合のみ|No|マークされている場合のみ|マークされている場合のみ|  
+|手動同期|手動|手動|手動|手動|手動|手動|  
+  
+## 同期なし  
+ これは、オブジェクトに対する既定の設定です。  どのスレッドも、すべてのメソッドやフィールドにいつでもアクセスできます。  ただし、これらのオブジェクトにアクセスできるスレッドは一度に 1 つだけです。  
+  
+## 手動同期  
+ .NET Framework クラス ライブラリには、スレッドを同期するためのさまざまなクラスが用意されています。  「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+## 同期されたコード領域  
+ <xref:System.Threading.Monitor> クラスまたはコンパイラ キーワードを使用して、コード ブロック、インスタンス メソッド、および静的メソッドを同期できます。  同期された静的フィールドはサポートされません。  
+  
+ Visual Basic および C\# のいずれも、コード ブロックに特定の言語キーワードのマークを付けることをサポートしています。特定の言語キーワードとは、C\# では `lock` ステートメント、Visual Basic では `SyncLock` ステートメントです。  コードがスレッドによって実行されると、ロックの取得が試みられます。  ロックが既に別のスレッドに取得されている場合は、ロックが使用できるようになるまで、そのスレッドがブロックされます。  同期されているコード ブロック部分の実行をスレッドが終了すると、終了方法に関係なく、ロックが解放されます。  
+  
+> [!NOTE]
+>  `lock` ステートメントおよび `SyncLock` ステートメントは、<xref:System.Threading.Monitor.Enter%2A?displayProperty=fullName> および <xref:System.Threading.Monitor.Exit%2A?displayProperty=fullName> を使用して実装されるため、<xref:System.Threading.Monitor> の他のメソッドを、同期された領域内でこれらと組み合わせて使用できます。  
+  
+ また、メソッドを **MethodImplAttribute** および **MethodImplOptions.Synchronized** で修飾することもできます。この処理は、**Monitor** またはメソッド全体をロックするためのコンパイラ キーワードの 1 つを使用した場合と同じ結果になります。  
+  
+ <xref:System.Threading.Thread.Interrupt%2A?displayProperty=fullName> を使用すると、同期されたコード領域へのアクセスの待機などのブロック操作から、スレッドを切り離すことができます。  また、この **Thread.Interrupt** を使用することで、<xref:System.Threading.Thread.Sleep%2A?displayProperty=fullName> などの操作からスレッドを切り離すこともできます。  
+  
+> [!IMPORTANT]
+>  `static` メソッド \(Visual Basic では `Shared` メソッド\) をプロテクトするために、型 \(C\# の `typeof(MyType)`、Visual Basic の `GetType(MyType)`、または C\+\+ の `MyType::typeid`\) をロックしないでください。  代わりに、プライベート静的オブジェクトを使用してください。  同様に、C\# の `this` \(Visual Basic の場合は `Me`\) を使用してインスタンス メソッドをロックしないでください。  代わりに、プライベート オブジェクトを使用してください。  クラスまたはインスタンスは、独自のコード以外のコードでもロックできますが、デッドロックやパフォーマンス上の問題を引き起こす可能性があります。  
+  
+### コンパイラ サポート  
+ Visual Basic と C\# は、どちらも <xref:System.Threading.Monitor.Enter%2A?displayProperty=fullName> と <xref:System.Threading.Monitor.Exit%2A?displayProperty=fullName> を使用してオブジェクトをロックする言語キーワードをサポートします。  Visual Basic は [SyncLock](../../../ocs/visual-basic/language-reference/statements/synclock-statement.md) ステートメントをサポートし、C\# は [lock](../Topic/lock%20Statement%20\(C%23%20Reference\).md) ステートメントをサポートします。  
+  
+ どちらの場合も、コード ブロックで例外がスローされると、**lock** または **SyncLock** によって取得されたロックが自動的に解放されます。  C\# コンパイラおよび Visual Basic コンパイラは、**try** ブロックおよび **finally** ブロックを生成します。try ブロックは先頭に **Monitor.Enter** を含み、**finally** ブロックは **Monitor.Exit** を含みます。  **lock** ブロックまたは **SyncLock** ブロック内で例外がスローされると、**finally** ハンドラーが実行されて、任意のクリーンアップ処理を実行できるようになります。  
+  
+## 同期されたコンテキスト  
+ 任意の **ContextBoundObject** で **SynchronizationAttribut** を使用して、すべてのインスタンス メソッドおよびインスタンス フィールドを同期できます。  同じコンテキスト ドメイン内のすべてのオブジェクトは、同じロックを共有します。  複数のスレッドがメソッドやフィールドにアクセスできますが、これらのオブジェクトに一度にアクセスできるのは 1 つのスレッドだけです。  
+  
+## 参照  
+ <xref:System.Runtime.Remoting.Contexts.SynchronizationAttribute>   
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)   
+ [Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)   
+ [SyncLock Statement](../../../ocs/visual-basic/language-reference/statements/synclock-statement.md)   
+ [lock ステートメント](../Topic/lock%20Statement%20\(C%23%20Reference\).md)
\ No newline at end of file
diff --git a/docs/standard/threading/the-managed-thread-pool.md b/docs/standard/threading/the-managed-thread-pool.md
new file mode 100644
index 00000000000..0fbcae18e4f
--- /dev/null
+++ b/docs/standard/threading/the-managed-thread-pool.md
@@ -0,0 +1,151 @@
+---
+title: "The Managed Thread Pool | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "thread pooling [.NET Framework]"
+  - "thread pools [.NET Framework]"
+  - "threading [.NET Framework], thread pool"
+  - "threading [.NET Framework], pooling"
+ms.assetid: 2be05b06-a42e-4c9d-a739-96c21d673927
+caps.latest.revision: 24
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 24
+---
+# The Managed Thread Pool
+<xref:System.Threading.ThreadPool> クラスを使用すると、システムによって管理されるワーカー スレッドのプールがアプリケーションに提供されます。これを利用すると、開発者は、スレッド管理ではなくアプリケーション タスクに注意を集中できるようになります。  バックグラウンド処理が必要な短いタスクがある場合、マネージ スレッド プールを使用すると、複数のスレッドを簡単に利用できます。  たとえば、[!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、スレッド プールのスレッドで非同期タスクを実行する <xref:System.Threading.Tasks.Task> オブジェクトと <xref:System.Threading.Tasks.Task%601> オブジェクトを作成できます。  
+  
+> [!NOTE]
+>  [!INCLUDE[net_v20SP1_long](../../../includes/net-v20sp1-long-md.md)] 以降では、[!INCLUDE[dnprdnshort](../../../includes/dnprdnshort-md.md)] の以前のリリースでボトルネックとして識別されていた 3 つの重要な分野 \(キューへのタスクの配置、スレッド プールのスレッドのディスパッチ、および I\/O 完了スレッドのディスパッチ\) において、スレッド プールのスループットが大幅に向上しています。  この機能を使用するには、アプリケーションで [!INCLUDE[net_v35_long](../../../includes/net-v35-long-md.md)] 以降を対象とする必要があります。  
+  
+ ユーザー インターフェイスと対話するバックグラウンド タスクの場合、.NET Framework Version 2.0 では、ユーザー インターフェイス スレッドで生成されたイベントを使用して通信する <xref:System.ComponentModel.BackgroundWorker> クラスも利用できます。  
+  
+ .NET Framework では、非同期 I\/O 完了、タイマー コールバック、登録済みの待機操作、デリゲートを使用した非同期メソッド呼び出し、<xref:System.Net> ソケット接続などのさまざまな目的でスレッド プールのスレッドを使用します。  
+  
+## スレッド プールのスレッドを使用しない場合  
+ 次のような場合は、スレッド プールのスレッドを使用する代わりに独自のスレッドを作成して管理する方が適切です。  
+  
+-   フォア グラウンド スレッドが必要な場合。  
+  
+-   スレッドに特定の優先順位を設定する必要がある場合。  
+  
+-   スレッドを長時間にわたってブロックするタスクがある場合。  スレッド プールには最大数のスレッドが存在するため、多数のスレッド プール スレッドがブロックされると、タスクを開始できなくなることがあります。  
+  
+-   スレッドをシングルスレッド アパートメント内に配置する必要がある場合。  <xref:System.Threading.ThreadPool> スレッドはすべてマルチスレッド アパートメント内にあります。  
+  
+-   安定した ID をスレッドに関連付ける必要がある場合、またはスレッドを特定のタスク専用にする必要がある場合。  
+  
+## スレッド プールの特徴  
+ スレッド プールのスレッドはバックグラウンド スレッドです。  「[Foreground and Background Threads](../../../docs/standard/threading/foreground-and-background-threads.md)」を参照してください。  各スレッドは、既定のスタック サイズを使用し、既定の優先順位で実行されます。また、各スレッドはマルチスレッド アパートメント内にあります。  
+  
+ プロセスごとにスレッド プールが 1 つだけあります。  
+  
+### スレッド プールのスレッドでの例外  
+ スレッド プールのスレッドで未処理の例外が発生すると、プロセスが終了します。  この規則には、次の 3 つの例外があります。  
+  
+-   <xref:System.Threading.Thread.Abort%2A> が呼び出されたため、スレッド プールのスレッドに <xref:System.Threading.ThreadAbortException> がスローされる。  
+  
+-   アプリケーション ドメインがアンロードされるため、スレッド プールのスレッドに <xref:System.AppDomainUnloadedException> がスローされる。  
+  
+-   共通言語ランタイムまたはホスト プロセスがスレッドを終了する。  
+  
+ 詳細については、「[Exceptions in Managed Threads](../../../docs/standard/threading/exceptions-in-managed-threads.md)」を参照してください。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、スレッド プールのスレッドの未処理の例外は、共通言語ランタイムによって通知なしにトラップされます。  このため、アプリケーション状態が破損し、最終的にアプリケーションが停止することになり、デバッグが困難になることがあります。  
+  
+### スレッド プールのスレッドの最大数  
+ スレッド プールのキューに配置できる操作の数は、使用できるメモリの容量によってのみ制限されますが、スレッド プールでは、プロセス内で同時にアクティブにできるスレッドの数が制限されます。  [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降では、プロセスのスレッド プールの既定のサイズは、仮想アドレス空間のサイズなど、いくつかの要素によって決まります。  スレッドの数は、プロセスで <xref:System.Threading.ThreadPool.GetMaxThreads%2A> メソッドを呼び出せば確認できます。  
+  
+ スレッドの最大数を制御するには、<xref:System.Threading.ThreadPool.GetMaxThreads%2A> メソッドと <xref:System.Threading.ThreadPool.SetMaxThreads%2A> メソッドを使用します。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、スレッド プールのサイズはマネージ コードから設定できません。  共通言語ランタイムをホストするコードでは、mscoree.h で定義された `CorSetMaxThreads` を使用してサイズを設定できます。  
+  
+### スレッド プールの最小値  
+ スレッド プールでは、カテゴリごとに指定された最小値に達するまで、要求に応じて新しいワーカー スレッドまたは I\/O 完了スレッドが提供されます。  これらの最小値は、<xref:System.Threading.ThreadPool.GetMinThreads%2A> メソッドを使用して取得できます。  
+  
+> [!NOTE]
+>  要求が少ないときは、スレッド プールの実際のスレッド数が最小値を下回る場合があります。  
+  
+ スレッド プールの最小値に達すると、追加のスレッドが作成されるか、いくつかのタスクが完了するまで待機状態になります。  [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降では、スループットを最適化するために、スレッド プールでワーカー スレッドの作成と破棄が行われます。スループットは、タスクの単位時間あたりの完了数として定義されます。  スレッドが少なすぎると使用可能なリソースが最適に使用されない可能性があり、スレッドが多すぎるとリソースの競合が増える可能性があります。  
+  
+> [!CAUTION]
+>  アイドル スレッドの最小数は、<xref:System.Threading.ThreadPool.SetMinThreads%2A> メソッドを使用して増やすことができます。  ただし、これらの値を必要以上に大きくすると、パフォーマンスの問題が発生する可能性があります。  同時に開始するタスクの数が多すぎる場合は、すべてのタスクで処理速度が低下する可能性があります。  ほとんどの場合、スレッドを割り当てるためのスレッド プール独自のアルゴリズムを使用することでスレッド プールのパフォーマンスが向上します。  
+  
+## セキュリティ チェックのスキップ  
+ スレッド プールでは、<xref:System.Threading.ThreadPool.UnsafeQueueUserWorkItem%2A?displayProperty=fullName> メソッドと <xref:System.Threading.ThreadPool.UnsafeRegisterWaitForSingleObject%2A?displayProperty=fullName> メソッドも使用できます。  これらのメソッドは、呼び出し元のスタックが、キューに配置されているタスクの実行時に行われるセキュリティ チェックと無関係であることが確認できる場合にのみ使用します。  <xref:System.Threading.ThreadPool.QueueUserWorkItem%2A>と <xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A> は、どちらも呼び出し元のスタックを取り込みます。このスタックは、スレッドがタスクの実行を開始するときにスレッド プールのスレッドのスタックにマージされます。  セキュリティ チェックが必要な場合は、そのスタック全体をチェックする必要があります。  チェックは安全性を提供しますが、パフォーマンスへの影響もあります。  
+  
+## スレッド プールの使用  
+ [!INCLUDE[net_v40_short](../../../includes/net-v40-short-md.md)] 以降でスレッド プールを使用する場合は、[Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)を使用すると最も簡単です。  <xref:System.Threading.Tasks.Task> や <xref:System.Threading.Tasks.Task%601> などの並列ライブラリの型では、既定でスレッド プールのスレッドを使用してタスクが実行されます。  また、マネージ コードから <xref:System.Threading.ThreadPool.QueueUserWorkItem%2A?displayProperty=fullName> \(またはアンマネージ コードから `CorQueueUserWorkItem`\) を呼び出し、タスクを実行するメソッドを表す <xref:System.Threading.WaitCallback> デリゲートを渡すことによってスレッド プールを使用することもできます。  スレッド プールを使用するもう 1 つの方法として、待機操作の関連ワーク アイテムをキューに置く方法もあります。これには、<xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A?displayProperty=fullName> メソッドを使用し、<xref:System.Threading.WaitHandle> を渡します。その WaitHandle がシグナル状態になるかタイムアウトになると、<xref:System.Threading.WaitOrTimerCallback> デリゲートによって表されるメソッドが呼び出されます。  スレッド プールのスレッドを使用してコールバック メソッドが呼び出されます。  
+  
+## ThreadPool の例  
+ このセクションのコード例では、<xref:System.Threading.Tasks.Task> クラス、<xref:System.Threading.ThreadPool.QueueUserWorkItem%2A?displayProperty=fullName> メソッド、および <xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A?displayProperty=fullName> メソッドを使用したスレッド プールの例を示します。  
+  
+-   [タスク並列ライブラリを使用した非同期タスクの実行](#TaskParallelLibrary)  
+  
+-   [QueueUserWorkItem を使用した非同期のコード実行](#ExecuteCodeWithQUWI)  
+  
+-   [QueueUserWorkItem へのタスク データの供給](#TaskDataForQUWI)  
+  
+-   [RegisterWaitForSingleObject の使用](#RegisterWaitForSingleObject)  
+  
+<a name="TaskParallelLibrary"></a>   
+### タスク並列ライブラリを使用した非同期タスクの実行  
+ 次の例では、<xref:System.Threading.Tasks.TaskFactory.StartNew%2A?displayProperty=fullName> メソッドを呼び出すことにより、<xref:System.Threading.Tasks.Task> オブジェクトを作成して使用する方法を示します。  <xref:System.Threading.Tasks.Task%601> クラスを使用して非同期タスクから値を返す方法の例については、「[How to: Return a Value from a Task](../../../docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md)」を参照してください。  
+  
+ [!code-csharp[System.Threading.Tasks.Task#01](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.threading.tasks.task/cs/startnew.cs#01)]
+ [!code-vb[System.Threading.Tasks.Task#01](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.threading.tasks.task/vb/startnew.vb#01)]  
+  
+<a name="ExecuteCodeWithQUWI"></a>   
+### QueueUserWorkItem を使用した非同期のコード実行  
+ 次の例では、`ThreadProc` メソッドで表される単純なタスクを <xref:System.Threading.ThreadPool.QueueUserWorkItem%2A> メソッドを使用してキューに置きます。  
+  
+ [!code-cpp[Conceptual.ThreadPool#1](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.threadpool/cpp/source1.cpp#1)]
+ [!code-csharp[Conceptual.ThreadPool#1](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.threadpool/cs/source1.cs#1)]
+ [!code-vb[Conceptual.ThreadPool#1](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.threadpool/vb/source1.vb#1)]  
+  
+<a name="TaskDataForQUWI"></a>   
+### QueueUserWorkItem へのタスク データの供給  
+ <xref:System.Threading.ThreadPool.QueueUserWorkItem%2A> メソッドを使用してタスクをキューに置き、そのタスクにデータを与えるコード例を次に示します。  
+  
+ [!code-cpp[Conceptual.ThreadPool#2](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.threadpool/cpp/source2.cpp#2)]
+ [!code-csharp[Conceptual.ThreadPool#2](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.threadpool/cs/source2.cs#2)]
+ [!code-vb[Conceptual.ThreadPool#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.threadpool/vb/source2.vb#2)]  
+  
+<a name="RegisterWaitForSingleObject"></a>   
+### RegisterWaitForSingleObject の使用  
+ 次の例では、スレッド処理のいくつかの機能について説明します。  
+  
+-   <xref:System.Threading.ThreadPool> スレッドで実行するタスクを、<xref:System.Threading.ThreadPool.RegisterWaitForSingleObject%2A> メソッドを使用してキューに配置します。  
+  
+-   <xref:System.Threading.AutoResetEvent> を使用して、実行するようにタスクに通知します。  「[EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)」を参照してください。  
+  
+-   <xref:System.Threading.WaitOrTimerCallback> デリゲートを使用して、タイムアウトと通知の両方を処理します。  
+  
+-   <xref:System.Threading.RegisteredWaitHandle> を使用して、キューに置かれたタスクを取り消します。  
+  
+ [!code-cpp[Conceptual.ThreadPool#3](../../../samples/snippets/cpp/VS_Snippets_CLR/conceptual.threadpool/cpp/source3.cpp#3)]
+ [!code-csharp[Conceptual.ThreadPool#3](../../../samples/snippets/csharp/VS_Snippets_CLR/conceptual.threadpool/cs/source3.cs#3)]
+ [!code-vb[Conceptual.ThreadPool#3](../../../samples/snippets/visualbasic/VS_Snippets_CLR/conceptual.threadpool/vb/source3.vb#3)]  
+  
+## 参照  
+ <xref:System.Threading.ThreadPool>   
+ <xref:System.Threading.Tasks.Task>   
+ <xref:System.Threading.Tasks.Task%601>   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)   
+ [How to: Return a Value from a Task](../../../docs/standard/parallel-programming/how-to-return-a-value-from-a-task.md)   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)   
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)   
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)   
+ [Timers](../../../docs/standard/threading/timers.md)
\ No newline at end of file
diff --git a/docs/standard/threading/thread-local-storage-thread-relative-static-fields-and-data-slots.md b/docs/standard/threading/thread-local-storage-thread-relative-static-fields-and-data-slots.md
new file mode 100644
index 00000000000..725079a8590
--- /dev/null
+++ b/docs/standard/threading/thread-local-storage-thread-relative-static-fields-and-data-slots.md
@@ -0,0 +1,69 @@
+---
+title: "Thread Local Storage: Thread-Relative Static Fields and Data Slots | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], local storage"
+  - "threading [.NET Framework], thread-relative static fields"
+  - "local thread storage"
+  - "TLS"
+ms.assetid: c633a4dc-a790-4ed1-96b5-f72bd968b284
+caps.latest.revision: 13
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 13
+---
+# Thread Local Storage: Thread-Relative Static Fields and Data Slots
+1 つのスレッドとアプリケーション ドメインに固有のデータを格納するには、マネージ スレッド ローカル ストレージ \(TLS: Thread Local Storage\) を使用します。  .NET Framework は、マネージ TLS の使用に関して、スレッド相対静的フィールドとデータ スロットという 2 つの機構を備えています。  
+  
+-   コンパイル時に要件を正確に予測できる場合は、スレッド相対静的フィールド \(Visual Basic ではスレッド相対 `Shared` フィールド\) を使用します。  スレッド相対静的フィールドは、最適なパフォーマンスを提供します。  また、コンパイル時に型チェックを利用することもできます。  
+  
+-   実行時にならないと実際の要件がわからない場合は、データ スロットを使用します。  データ スロットは、スレッド相対静的フィールドと比べると低速で使いにくく、データは <xref:System.Object> 型として格納されるため、使用前に適切な型にキャストする必要があります。  
+  
+ アンマネージ C\+\+ では、`TlsAlloc` を使用してスロットを動的に割り当て、`__declspec(thread)` で変数をスレッド相対ストレージに割り当てることを宣言します。  スレッド相対静的フィールドおよびデータ スロットには、この動作のマネージ バージョンが用意されています。  
+  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] では、<xref:System.Threading.ThreadLocal%601?displayProperty=fullName> クラスを使用して、最初に利用されるときに初期化されるスレッドローカル オブジェクトを作成できます。  詳細については、「[限定的な初期化](../../../docs/framework/performance/lazy-initialization.md)」を参照してください。  
+  
+## マネージ TLS でのデータの一意性  
+ スレッド相対静的フィールドとデータ スロットのどちらを使用しても、マネージ TLS でのデータはスレッドとアプリケーション ドメインの組み合わせに対して一意になります。  
+  
+-   アプリケーション ドメインでは、両方のスレッドが同じフィールドまたはスロットを使用していたとしても、一方のスレッドが、もう一方のスレッドからのデータを変更することはできません。  
+  
+-   あるスレッドが、複数のアプリケーション ドメインで使用される 1 つのフィールドまたはスロットにアクセスする場合、値はアプリケーション ドメインごとに維持されます。  
+  
+ たとえば、スレッドがスレッド相対静的フィールドの値を設定し、別のアプリケーション ドメインに移動して、設定したフィールドの値を取得した場合、2 番目のアプリケーション ドメインで取得した値は、最初のアプリケーション ドメインでの値とは異なります。  2 番目のアプリケーション ドメインのフィールドに新しい値を設定しても、最初のアプリケーション ドメインにあるフィールドの値には影響しません。  
+  
+ 同様に、スレッドが、異なる 2 つのアプリケーション ドメインで 2 つの名前付きデータ スロットを取得した場合、最初のアプリケーション ドメインのデータと 2 番目のアプリケーション ドメインのデータは、それぞれ独立性を確保します \(無関係な状態が維持されます\)。  
+  
+## スレッド相対静的フィールド  
+ スレッドとアプリケーション ドメインの組み合わせに対し、データの一部が常に一意であることがわかっている場合は、静的フィールドに <xref:System.ThreadStaticAttribute> 属性を適用します。  フィールドの使用法は、他の静的フィールドと同様です。  フィールドのデータは、使用する各スレッドに対して一意です。  
+  
+ スレッド相対静的フィールドは、データ スロットと比較してパフォーマンスが優れており、コンパイル時の型チェックも可能です。  
+  
+ すべてのクラス コンストラクター コードはそのフィールドにアクセスする最初のコンテキストの最初のスレッドで実行されることに注意してください。  同じアプリケーション ドメイン内にある、その他のスレッドまたはコンテキストについては、これらのフィールドが参照型の場合は `null` \(Visual Basic では `Nothing`\) に、値型の場合は既定値に初期化されます。  したがって、クラス コンストラクターを使用してスレッド相対静的フィールドを初期化しないでください。  スレッド相対静的フィールドの初期化を回避し、これらのフィールドは `null` \(`Nothing`\) または既定値に初期化されると仮定します。  
+  
+## データ スロット  
+ .NET Framework には、スレッドとアプリケーション ドメインの組み合わせに対して一意の、動的なデータ スロットが用意されています。  このデータ スロットには 2 つのタイプがあります。名前付きスロットと名前のないスロットです。  いずれも、<xref:System.LocalDataStoreSlot> 構造体を使用して実装されます。  
+  
+-   名前付きデータ スロットを作成するには、<xref:System.Threading.Thread.AllocateNamedDataSlot%2A?displayProperty=fullName> メソッドまたは <xref:System.Threading.Thread.GetNamedDataSlot%2A?displayProperty=fullName> メソッドを使用します。  既存の名前付きスロットへの参照を取得するには、その名前を <xref:System.Threading.Thread.GetNamedDataSlot%2A> メソッドに渡します。  
+  
+-   名前のないデータ スロットを作成するには、<xref:System.Threading.Thread.AllocateDataSlot%2A?displayProperty=fullName> メソッドを使用します。  
+  
+ 名前付きスロットと名前のないスロットはいずれも、<xref:System.Threading.Thread.SetData%2A?displayProperty=fullName> メソッドと <xref:System.Threading.Thread.GetData%2A?displayProperty=fullName> メソッドを使用して、スロット内のデータの設定や取得を行います。  これらは静的メソッドであり、現在実行中であるスレッドのデータを操作する役割を果たします。  
+  
+ 名前付きスロットは、必要なときに <xref:System.Threading.Thread.GetNamedDataSlot%2A> メソッドにスロットの名前を渡してスロットを取得できるという利点があります \(名前のないスロットの場合は、スロットへの参照を維持する必要があります\)。  ただし、他のコンポーネントがそのスレッド相対ストレージに対して同じ名前を使用しており、1 つのスレッドが、あるコンポーネントとその他のコンポーネントからコードを実行する場合、この 2 つのコンポーネントが互いのデータを破損する可能性があります \(このシナリオでは、2 つのコンポーネントが同じアプリケーション ドメイン内で実行されており、同じデータを共有するようには設計されていないことを前提としています\)。  
+  
+## 参照  
+ <xref:System.ContextStaticAttribute>   
+ <xref:System.Threading.Thread.GetNamedDataSlot%2A?displayProperty=fullName>   
+ <xref:System.ThreadStaticAttribute>   
+ <xref:System.Runtime.Remoting.Messaging.CallContext>   
+ [Threading](../../../docs/standard/threading/index.md)
\ No newline at end of file
diff --git a/docs/standard/threading/thread-suspend-garbage-collection-and-safe-points.md b/docs/standard/threading/thread-suspend-garbage-collection-and-safe-points.md
new file mode 100644
index 00000000000..96521bf2d7a
--- /dev/null
+++ b/docs/standard/threading/thread-suspend-garbage-collection-and-safe-points.md
@@ -0,0 +1,37 @@
+---
+title: "Thread.Suspend, Garbage Collection, and Safe Points | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "suspending threads"
+  - "safe points"
+  - "threading [.NET Framework], suspending"
+  - "threading [.NET Framework], garbage collection"
+  - "garbage collection, threads"
+ms.assetid: e8f58e17-2714-4821-802a-f8eb3b2baa62
+caps.latest.revision: 7
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 7
+---
+# Thread.Suspend, Garbage Collection, and Safe Points
+スレッドで <xref:System.Threading.Thread.Suspend%2A?displayProperty=fullName> を呼び出すと、システムはスレッドの中断が要求されたことを認識しますが、スレッドを実際に中断する前に、スレッドがセーフ ポイントに達するまで待機して、その実行を許可します。  スレッドのセーフ ポイントとは、ガベージ コレクションを行うことができる、実行中のポイントのことです。  
+  
+ セーフ ポイントに達した後は、中断されたスレッドがマネージ コード内でこれ以上進行しないことが、ランタイムによって保証されます。  マネージ コードの外部で実行されているスレッドは、いつでもガベージ コレクションを実行でき、このスレッドの実行は、マネージ コードの実行の再開を試みるまで継続されます。  
+  
+> [!NOTE]
+>  ガベージ コレクションを実行するには、そのコレクションを実行しているスレッドを除き、すべてのスレッドを中断する必要があります。  各スレッドを中断するには、そのスレッドをセーフ ポイントに移動する必要があります。  
+  
+## 参照  
+ <xref:System.Threading.Thread>   
+ <xref:System.GC>   
+ [Threading](../../../docs/standard/threading/index.md)   
+ [自動メモリ管理](../../../docs/standard/automatic-memory-management.md)
\ No newline at end of file
diff --git a/docs/standard/threading/threading-objects-and-features.md b/docs/standard/threading/threading-objects-and-features.md
new file mode 100644
index 00000000000..976a2b91f76
--- /dev/null
+++ b/docs/standard/threading/threading-objects-and-features.md
@@ -0,0 +1,79 @@
+---
+title: "Threading Objects and Features | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], features"
+  - "managed threading"
+ms.assetid: 239b2e8d-581b-4ca3-992b-0e8525b9321c
+caps.latest.revision: 15
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 15
+---
+# Threading Objects and Features
+.NET Framework には、マルチスレッド アプリケーションの作成と管理に役立つ多くのオブジェクトが用意されています。  マネージ スレッドは、<xref:System.Threading.Thread> クラスによって表されます。  <xref:System.Threading.ThreadPool> クラスを使用すると、マルチスレッドのバックグラウンド タスクを簡単に作成し、管理できます。  <xref:System.ComponentModel.BackgroundWorker> クラスは、ユーザー インターフェイスと対話するタスクについてそれと同じことを実現します。  <xref:System.Threading.Timer> クラスは、指定された間隔でバックグラウンド タスクを実行します。  
+  
+ さらに、.NET Framework Version 2.0 で導入された <xref:System.Threading.Semaphore> クラスや <xref:System.Threading.EventWaitHandle> クラスなど、スレッドの活動を同期するクラスも数多くあります。  これらのクラスの機能の比較については、「[Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)」を参照してください。  
+  
+## このセクションの内容  
+ [The Managed Thread Pool](../../../docs/standard/threading/the-managed-thread-pool.md)  
+ **ThreadPool** クラスについて説明します。このクラスを利用すると、開発者はスレッド管理を意識する必要なしに、スレッドにタスクの実行を要求できます。  
+  
+ [Timers](../../../docs/standard/threading/timers.md)  
+ **Timer** を使用して、指定された時間に呼び出されるデリゲートを指定する方法を説明します。  
+  
+ [監視](../Topic/Monitors.md)  
+ **Monitor** クラスを使用してメンバーへのアクセスを同期したり、または独自の種類のスレッド管理を構築したりする方法を説明します。  
+  
+ [Wait Handles](../Topic/Wait%20Handles.md)  
+ <xref:System.Threading.WaitHandle> クラスについて説明します。このクラスは、イベント待機ハンドル、ミューテックス、およびセマフォ用の抽象基底クラスで、複数の同期イベントを待機できるようにします。  
+  
+ [EventWaitHandle, AutoResetEvent, CountdownEvent, ManualResetEvent](../../../docs/standard/threading/eventwaithandle-autoresetevent-countdownevent-manualresetevent.md)  
+ 通知を行ったり通知を待機したりすることによりスレッドの活動を同期するために使用するマネージ イベント待機ハンドルについて説明します。  
+  
+ [Mutexes](../../../docs/standard/threading/mutexes.md)  
+ オブジェクトへのアクセスの同期、または独自の同期機構の構築を <xref:System.Threading.Mutex>を使用して行う方法を説明します。  
+  
+ [Interlocked Operations](../../../docs/standard/threading/interlocked-operations.md)  
+ <xref:System.Threading.Interlocked> クラスを使用して、値の増減と値の格納をアトミックな 1 回の操作で実行する方法を説明します。  
+  
+ [Reader\-Writer Locks](../../../docs/standard/threading/reader-writer-locks.md)  
+ 単一ライター\/複数リーダーのセマンティクスを実装するロックを定義します。  
+  
+ [Semaphore and SemaphoreSlim](../../../docs/standard/threading/semaphore-and-semaphoreslim.md)  
+ <xref:System.Threading.Semaphore> オブジェクトについて説明し、このオブジェクトを使用して、制限されたリソースへのアクセスを制御する方法を示します。  
+  
+ [Overview of Synchronization Primitives](../../../docs/standard/threading/overview-of-synchronization-primitives.md)  
+ マネージ スレッドをロックおよび同期するために用意されている .NET Framework のクラスの機能を比較します。  
+  
+ [Barrier](../../../docs/standard/threading/barrier.md)  
+ 段階的な操作におけるスレッドの調整のためのバリア パターンを実装する <xref:System.Threading.Barrier> オブジェクトについて説明します。  
+  
+ [SpinLock](../../../docs/standard/threading/spinlock.md)  
+ 特定の下位レベルのシナリオで Monitor クラスの代わりに軽量のプリミティブとして使用できる <xref:System.Threading.SpinLock> について説明します。  
+  
+ [SpinWait](../../../docs/standard/threading/spinwait.md)  
+ カーネル ベースの待機を開始する前にビジー スピンを実行する下位レベルの同期プリミティブである <xref:System.Threading.SpinWait> について説明します。  
+  
+## 関連項目  
+ <xref:System.Threading.Thread>  
+ **Thread** クラスのリファレンス ドキュメントです。このクラスは、アンマネージ コードから作成されたか、マネージ アプリケーションで作成されたかにかかわらず、マネージ スレッドを表します。  
+  
+ <xref:System.ComponentModel.BackgroundWorker>  
+ ユーザー インターフェイスと対話し、ユーザー インターフェイス スレッドで生成されるイベントを介して通信するバックグラウンド タスクを有効にします。  
+  
+## 関連項目  
+ [非同期ファイル I\/O](../../../docs/standard/io/非同期ファイル-i-o.md)  
+ 入力\/出力操作が完了した場合にのみ非同期 I\/O 完了ポートがスレッド プールを使用して処理を要求する方法について説明します。  
+  
+ [Task Parallel Library \(TPL\)](../../../docs/standard/parallel-programming/task-parallel-library-tpl.md)  
+ [!INCLUDE[net_v40_long](../../../includes/net-v40-long-md.md)] 以降でマルチスレッド プログラミングのための推奨される方法について説明します。
\ No newline at end of file
diff --git a/docs/standard/threading/threads-and-threading.md b/docs/standard/threading/threads-and-threading.md
new file mode 100644
index 00000000000..d766041fccc
--- /dev/null
+++ b/docs/standard/threading/threads-and-threading.md
@@ -0,0 +1,100 @@
+---
+title: "Threads and Threading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "multiple threads"
+  - "threading [.NET Framework]"
+  - "threading [.NET Framework], multiple threads"
+ms.assetid: 5baac3aa-e603-4fa6-9f89-0f2c1084e6b1
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Threads and Threading
+オペレーティング システムは、実行中の各アプリケーションをプロセスを使用して分離します。  スレッドとは、オペレーティング システムがプロセッサ時間を割り当てる対象の基本単位です。複数のスレッドが、そのプロセス内でコードを実行できます。  各スレッドは、例外ハンドラー、スケジューリングの優先順位、およびスレッド コンテキストをスケジュールされるまでの間保存するために使用する一連の構造体を保持します。  スレッド コンテキストは、スレッドがシームレスに実行を再開するために必要な、スレッドの CPU レジスタおよびスタックのセットを含むすべての情報を、該当するホスト プロセスのアドレス空間に格納します。  
+  
+ .NET Framework は、オペレーティング システム プロセスを、<xref:System.AppDomain?displayProperty=fullName> で表されるアプリケーション ドメインと呼ばれる軽量なマネージ サブプロセスへとさらに分割します。  <xref:System.Threading.Thread?displayProperty=fullName> で表される 1 つ以上のマネージ スレッドが、同じマネージ プロセス内にある任意の数のアプリケーション ドメインで実行できます。  各アプリケーション ドメインは最初はシングル スレッドですが、そのアプリケーション ドメイン内のコードで追加のアプリケーション ドメインやスレッドを作成できます。  そのため、マネージ スレッドは、同じマネージ プロセス内のアプリケーション ドメイン間を自由に移動できます。1 つのスレッドだけを複数のアプリケーション ドメイン間で移動させることもできます。  
+  
+ プリエンプティブなマルチタスクをサポートするオペレーティング システムは、複数のプロセスからの複数のスレッドを同時に実行できます。  システムは、使用できるプロセッサ時間をこれを必要とするスレッド間で分割し、各スレッドにプロセッサ タイム スライスを順次割り当てることによってこれを実現します。  現在実行中のスレッドはタイム スライスが経過すると中断され、別のスレッドが実行を再開します。  システムは、スレッドを切り替えるときに、切り替える前のスレッドのスレッド コンテキストを保存し、スレッド キュー内にある次のスレッドの保存済みスレッド コンテキストを再読み込みします。  
+  
+ タイム スライスの長さは、オペレーティング システムやプロセッサによって異なります。  各タイム スライスは短いため、プロセッサが 1 つしか存在しない場合でも、複数のスレッドが同時に実行しているように見えます。  マルチプロセッサ システムでは、実行可能スレッドが複数の有効なプロセッサに分散されているため、実際に複数のスレッドが同時に実行されます。  
+  
+## 複数のスレッドを使用する場合  
+ ユーザーとの対話を必要とするソフトウェアは、ユーザーのアクティビティにできるだけ迅速に反応して、充実したパフォーマンスを提供する必要があります。  ただし、同時にこのソフトウェアは、ユーザーにデータを表示するために必要な計算をできるだけ高速に行う必要もあります。  アプリケーションが 1 つの実行スレッドだけを使用する場合は、[非同期プログラミング](../../../docs/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously.md)を [.NET Framework リモート処理](http://msdn.microsoft.com/ja-jp/eccb1d31-0a22-417a-97fd-f4f1f3aa4462)、または ASP.NET を使用して作成された [XML Web サービス](http://msdn.microsoft.com/ja-jp/1e64af78-d705-4384-b08d-591a45f4379c)と組み合わせることで、使用しているコンピューターの処理時間だけでなく他のコンピューターの処理時間も利用できます。これにより、ユーザーへの応答を速くし、アプリケーションのデータ処理時間を短縮できます。  また、多くの I\/O 操作を行う場合は、I\/O 完了ポートを使用すると、アプリケーションの応答を速くすることができます。  
+  
+### 複数のスレッドを使用するメリット  
+ ユーザーへの応答の高速化と、ジョブの実行に必要なデータの処理をほぼ同時に実現できる最も強力な方法は、複数のスレッドを使用することです。  シングル プロセッサのコンピューターで複数のスレッドを使用すると、ユーザー イベント間の短い時間を利用してバックグラウンドでデータが処理されることによって、この効果が得られます。  たとえば、別のスレッドが同じアプリケーション内でスプレッドシートのほかの部分を再計算している間に、そのスプレッドシートを編集できます。  
+  
+ 同じアプリケーションをマルチ プロセッサのコンピューターで実行すると、変更しなくてもパフォーマンスが大幅に向上します。  単一のアプリケーション ドメインで複数のスレッドを使用すると、次のタスクを実行できます。  
+  
+-   ネットワーク経由での Web サーバーやデータベースとの通信。  
+  
+-   時間のかかる処理の実行。  
+  
+-   さまざまな優先順位のタスクの区別。  たとえば、優先順位の高いスレッドは速度が重視されるタスクを管理し、優先順位の低いスレッドはほかのタスクを実行します。  
+  
+-   ユーザー インターフェイスによる迅速な応答と、バックグラウンド タスクへの割り当て時間の両立。  
+  
+### 複数のスレッドを使用するデメリット  
+ オペレーティング システム リソースの使用を最小にしてパフォーマンスを向上させるには、使用するスレッドをできるだけ少なくすることをお勧めします。  また、アプリケーションをデザインするときは、スレッド処理にはリソース要件があること、競合が発生する可能性があることを考慮する必要があります。  リソース要件は次のとおりです。  
+  
+-   システムは、プロセス、**AppDomain** オブジェクト、およびスレッドが必要とするコンテキスト情報を格納するためにメモリを消費します。  そのため、使用できるメモリの量によって、作成できるプロセス、**AppDomain** オブジェクト、およびスレッドの数は制限されます。  
+  
+-   多数のスレッドを追跡するには、プロセッサ時間を大量に消費します。  スレッドが多すぎると、ほとんどのスレッドで処理に重大な影響がでます。  現在のスレッドのほとんどが 1 つのプロセスにある場合は、ほかのプロセスにあるスレッドのスケジュール頻度が低下します。  
+  
+-   多数のスレッドを使用したコードの実行は制御が複雑なため、多くのバグの原因となる可能性があります。  
+  
+-   スレッドを破棄するには、発生する可能性がある問題を認識して対処する必要があります。  
+  
+ リソースへの共有アクセスを提供すると、競合が発生する場合があります。  競合を回避するには、共有リソースへのアクセスとの同期をとるか、またはアクセスを制御する必要があります。  同じアプリケーション ドメインまたは異なるアプリケーション ドメインで、アクセスを正しく同期することに失敗すると、デッドロック \(2 つのスレッドがお互いの完了を待って応答しなくなる状態\) や競合状態 \(2 つのイベントのタイミングによって予測できない動作が生じたために、異常な結果が発生した場合\) などの問題が生じる可能性があります。  システムには、複数のスレッド間でのリソース共有を調整するための同期オブジェクトが用意されています。  スレッド数を減らすことで、より簡単にリソースの同期がとれるようになります。  
+  
+ 同期を必要とするリソースは、次のとおりです。  
+  
+-   システム リソース \(通信ポートなど\)  
+  
+-   複数のプロセスによって共有されるリソース \(ファイル ハンドルなど\)  
+  
+-   複数のスレッドによってアクセスされる単一のアプリケーション ドメインのリソース \(グローバル フィールド、静的フィールド、インスタンス フィールドなど\)  
+  
+### スレッド処理とアプリケーションのデザイン  
+ 一般に、他のスレッドをブロックしない比較的短いタスクを特定のスケジューリングを指定せずに実行する場合、複数のスレッドを処理する最も簡単な方法は、<xref:System.Threading.ThreadPool> クラスを使用することです。  ただし、次に示すように、独自のスレッドを作成した方がよい場合も多くあります。  
+  
+-   タスクに特定の優先順位を設定する必要がある場合。  
+  
+-   タスクが長時間実行して、ほかのタスクをブロックする可能性がある場合。  
+  
+-   スレッドをシングルスレッド アパートメント内に配置する必要がある場合 \(すべての **ThreadPool** スレッドがマルチスレッド アパートメント内にある場合\)。  
+  
+-   スレッドに関連付けられた、確立された ID が必要な場合。  たとえば、そのスレッドをアボートまたは中断したり、名前で探索したりするには、専用のスレッドを使用する必要があります。  
+  
+-   ユーザー インターフェイスと対話するバックグラウンド スレッドを実行する必要がある場合、.NET Framework Version 2.0 では、イベントを使用し、ユーザー インターフェイス スレッドへのスレッド間マーシャリングによって通信する <xref:System.ComponentModel.BackgroundWorker> コンポーネントを利用できます。  
+  
+### スレッド処理と例外  
+ スレッドで例外を処理します。  スレッドで処理できない例外が発生すると、バックグラウンド スレッドの場合でも、通常、プロセスが終了します。  この規則には、次の 3 つの例外があります。  
+  
+-   <xref:System.Threading.Thread.Abort%2A> が呼び出されると、スレッドで <xref:System.Threading.ThreadAbortException> がスローされる。  
+  
+-   アプリケーション ドメインがアンロードされるため、スレッドに <xref:System.AppDomainUnloadedException> がスローされる。  
+  
+-   共通言語ランタイムまたはホスト プロセスがスレッドを終了する。  
+  
+ 詳細については、「[Exceptions in Managed Threads](../../../docs/standard/threading/exceptions-in-managed-threads.md)」を参照してください。  
+  
+> [!NOTE]
+>  .NET Framework Version 1.0 および 1.1 では、共通言語ランタイムが、スレッド プール スレッドなどで一部の例外を通知なしにトラップします。  このため、アプリケーション状態が破損し、最終的にアプリケーションが停止することにより、デバッグが困難になることがあります。  
+  
+## 参照  
+ <xref:System.Threading.ThreadPool>   
+ <xref:System.ComponentModel.BackgroundWorker>   
+ [Synchronizing Data for Multithreading](../../../docs/standard/threading/synchronizing-data-for-multithreading.md)   
+ [The Managed Thread Pool](../../../docs/standard/threading/the-managed-thread-pool.md)
\ No newline at end of file
diff --git a/docs/standard/threading/timers.md b/docs/standard/threading/timers.md
new file mode 100644
index 00000000000..61b37bb0d69
--- /dev/null
+++ b/docs/standard/threading/timers.md
@@ -0,0 +1,38 @@
+---
+title: "Timers | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], timers"
+  - "timers, about timers"
+ms.assetid: 7091500d-be18-499b-a942-95366ce185e5
+caps.latest.revision: 12
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 12
+---
+# Timers
+タイマーとは、指定時刻に指定のデリゲートを呼び出す軽量オブジェクトのことです。  スレッド プール内の 1 つのスレッドが、待機操作を実行します。  
+  
+ <xref:System.Threading.Timer?displayProperty=fullName> クラスの使用法は単純です。  **Timer** を作成するには、コールバック メソッドへの <xref:System.Threading.TimerCallback> デリゲート、コールバックに渡される状態を表すオブジェクト、最初に発生する時間、およびコールバック呼び出しの間隔を表す時間を渡します。  保留中のタイマーをキャンセルするには、**Timer.Dispose** 関数を呼び出します。  
+  
+> [!NOTE]
+>  他にも 2 つのタイマー クラスがあります。  <xref:System.Windows.Forms.Timer?displayProperty=fullName> クラスは、ビジュアルなデザイナーを操作するコントロールで、ユーザー インターフェイスのコンテキストで使用するように設計されています。このクラスは、ユーザー インターフェイス スレッドでイベントを発生させます。  <xref:System.Timers.Timer?displayProperty=fullName> クラスは <xref:System.ComponentModel.Component> から派生するため、ビジュアルなデザイナーで使用できます。このクラスもイベントを発生させますが、イベントは <xref:System.Threading.ThreadPool> スレッドで発生します。  <xref:System.Threading.Timer?displayProperty=fullName> クラスは <xref:System.Threading.ThreadPool> スレッドでコールバックを行い、イベント モデルは使用しません。  またこのクラスは、状態オブジェクトをコールバック メソッドに提供します。他のタイマーは状態オブジェクトを提供しません。  このクラスは、非常に軽量です。  
+  
+ 次のコード例は、1 秒 \(1000 ミリ秒\) 後に起動し、Enter キーを押すまで 1 秒ごとに時を刻むタイマーを開始します。  実行中にタイマーがガベージ コレクションの対象とならないように、このタイマーへの参照を含む変数はクラス レベルのフィールドとします。  積極的なガベージ コレクションの詳細については、「<xref:System.GC.KeepAlive%2A>」を参照してください。  
+  
+ [!code-cpp[System.Threading.Timer#2](../../../samples/snippets/cpp/VS_Snippets_CLR_System/system.Threading.Timer/CPP/source2.cpp#2)]
+ [!code-csharp[System.Threading.Timer#2](../../../samples/snippets/csharp/VS_Snippets_CLR_System/system.Threading.Timer/CS/source2.cs#2)]
+ [!code-vb[System.Threading.Timer#2](../../../samples/snippets/visualbasic/VS_Snippets_CLR_System/system.Threading.Timer/VB/source2.vb#2)]  
+  
+## 参照  
+ <xref:System.Threading.Timer>   
+ [Threading Objects and Features](../../../docs/standard/threading/threading-objects-and-features.md)
\ No newline at end of file
diff --git a/docs/standard/threading/using-threads-and-threading.md b/docs/standard/threading/using-threads-and-threading.md
new file mode 100644
index 00000000000..95cd8b52c15
--- /dev/null
+++ b/docs/standard/threading/using-threads-and-threading.md
@@ -0,0 +1,50 @@
+---
+title: "Using Threads and Threading | Microsoft Docs"
+ms.custom: ""
+ms.date: "03/30/2017"
+ms.prod: ".net"
+ms.reviewer: ""
+ms.suite: ""
+ms.technology: 
+  - "dotnet-standard"
+ms.tgt_pltfrm: ""
+ms.topic: "article"
+helpviewer_keywords: 
+  - "threading [.NET Framework], about threading"
+  - "managed threading"
+ms.assetid: 9b5ec2cd-121b-4d49-b075-222cf26f2344
+caps.latest.revision: 14
+author: "rpetrusha"
+ms.author: "ronpet"
+manager: "wpickett"
+caps.handback.revision: 14
+---
+# Using Threads and Threading
+このセクションの各トピックでは、マネージ スレッドを作成して管理する方法、マネージ スレッドにデータを渡して結果を取得する方法、およびスレッドの破棄や <xref:System.Threading.ThreadAbortException> の処理を行う方法について説明します。  
+  
+## このセクションの内容  
+ [Creating Threads and Passing Data at Start Time](../../../docs/standard/threading/creating-threads-and-passing-data-at-start-time.md)  
+ データを新しいスレッドに渡す方法とデータを取り戻す方法を含め、マネージ スレッドの作成について説明します。  
+  
+ [Pausing and Resuming Threads](../../../docs/standard/threading/pausing-and-resuming-threads.md)  
+ マネージ スレッドを一時中断および再開した場合の動作について説明します。  
+  
+ [Destroying Threads](../../../docs/standard/threading/destroying-threads.md)  
+ マネージ スレッドを破棄した場合の影響、および <xref:System.Threading.ThreadAbortException> の処理方法について説明します。  
+  
+ [Scheduling Threads](../../../docs/standard/threading/scheduling-threads.md)  
+ スレッドの優先順位とそれがスレッドのスケジューリングに及ぼす影響について説明します。  
+  
+## 関連項目  
+ <xref:System.Threading.Thread>  
+ <xref:System.Threading.Thread> クラスのリファレンス ドキュメントです。このクラスは、アンマネージ コードから作成されたか、マネージ アプリケーションで作成されたかにかかわらず、マネージ スレッドを表します。  
+  
+ <xref:System.Threading.ThreadStart>  
+ パラメーターのないスレッド プロシージャを表す <xref:System.Threading.ThreadStart> デリゲートのリファレンス ドキュメントです。  
+  
+ <xref:System.Threading.ParameterizedThreadStart>  
+ スレッド プロシージャにデータを渡す簡単な方法を示します。ただし、厳密な型指定は行いません。  
+  
+## 関連項目  
+ [Threads and Threading](../../../docs/standard/threading/threads-and-threading.md)  
+ マネージ スレッド処理の概要を説明します。
\ No newline at end of file
diff --git a/includes/ado-orcas-long-md.md b/includes/ado-orcas-long-md.md
new file mode 100644
index 00000000000..f0359b8f6e4
--- /dev/null
+++ b/includes/ado-orcas-long-md.md
@@ -0,0 +1 @@
+ADO.NET 3.0
\ No newline at end of file
diff --git a/includes/ado-whidbey-long-md.md b/includes/ado-whidbey-long-md.md
new file mode 100644
index 00000000000..84e4a3f81cb
--- /dev/null
+++ b/includes/ado-whidbey-long-md.md
@@ -0,0 +1 @@
+ADO.NET 2.0
\ No newline at end of file
diff --git a/includes/adonet-edm-md.md b/includes/adonet-edm-md.md
new file mode 100644
index 00000000000..de5e298ae19
--- /dev/null
+++ b/includes/adonet-edm-md.md
@@ -0,0 +1 @@
+エンティティ データ モデル
\ No newline at end of file
diff --git a/includes/adonet-ef-md.md b/includes/adonet-ef-md.md
new file mode 100644
index 00000000000..5153cabe4fa
--- /dev/null
+++ b/includes/adonet-ef-md.md
@@ -0,0 +1 @@
+Entity Framework
\ No newline at end of file
diff --git a/includes/ajax-current-short-md.md b/includes/ajax-current-short-md.md
new file mode 100644
index 00000000000..1f2bba75f75
--- /dev/null
+++ b/includes/ajax-current-short-md.md
@@ -0,0 +1 @@
+Microsoft Ajax
\ No newline at end of file
diff --git a/includes/arrowhead-md.md b/includes/arrowhead-md.md
new file mode 100644
index 00000000000..f24dbf9be9a
--- /dev/null
+++ b/includes/arrowhead-md.md
@@ -0,0 +1 @@
+.NET Framework Client Profile
\ No newline at end of file
diff --git a/includes/avalon1-md.md b/includes/avalon1-md.md
new file mode 100644
index 00000000000..ec2f2b4ecea
--- /dev/null
+++ b/includes/avalon1-md.md
@@ -0,0 +1 @@
+Windows Presentation Foundation (WPF)
\ No newline at end of file
diff --git a/includes/avalon2-md.md b/includes/avalon2-md.md
new file mode 100644
index 00000000000..92826b01ec3
--- /dev/null
+++ b/includes/avalon2-md.md
@@ -0,0 +1 @@
+WPF
\ No newline at end of file
diff --git a/includes/compact-md.md b/includes/compact-md.md
new file mode 100644
index 00000000000..f09d3f50950
--- /dev/null
+++ b/includes/compact-md.md
@@ -0,0 +1 @@
+.NET Compact Framework
\ No newline at end of file
diff --git a/includes/compact-v35-short-md.md b/includes/compact-v35-short-md.md
new file mode 100644
index 00000000000..87edab7a69c
--- /dev/null
+++ b/includes/compact-v35-short-md.md
@@ -0,0 +1 @@
+.NET Compact Framework 3.5
\ No newline at end of file
diff --git a/includes/crabout-md.md b/includes/crabout-md.md
new file mode 100644
index 00000000000..e1ea43f7612
--- /dev/null
+++ b/includes/crabout-md.md
@@ -0,0 +1 @@
+詳細情報:
\ No newline at end of file
diff --git a/includes/crdefault-md.md b/includes/crdefault-md.md
new file mode 100644
index 00000000000..6a2f3f3c969
--- /dev/null
+++ b/includes/crdefault-md.md
@@ -0,0 +1 @@
+詳細については、次のトピックを参照してください。
\ No newline at end of file
diff --git a/includes/crexample-md.md b/includes/crexample-md.md
new file mode 100644
index 00000000000..631d0dc648e
--- /dev/null
+++ b/includes/crexample-md.md
@@ -0,0 +1 @@
+例 :
\ No newline at end of file
diff --git a/includes/crlist-md.md b/includes/crlist-md.md
new file mode 100644
index 00000000000..4c2fbb30898
--- /dev/null
+++ b/includes/crlist-md.md
@@ -0,0 +1 @@
+下記のリスト
\ No newline at end of file
diff --git a/includes/csharp-orcas-long-md.md b/includes/csharp-orcas-long-md.md
new file mode 100644
index 00000000000..34adb1074bb
--- /dev/null
+++ b/includes/csharp-orcas-long-md.md
@@ -0,0 +1 @@
+Visual C# 2008
\ No newline at end of file
diff --git a/includes/csprcs-md.md b/includes/csprcs-md.md
new file mode 100644
index 00000000000..baeb5a5d616
--- /dev/null
+++ b/includes/csprcs-md.md
@@ -0,0 +1 @@
+Visual C#
\ No newline at end of file
diff --git a/includes/csprcslong-md.md b/includes/csprcslong-md.md
new file mode 100644
index 00000000000..0190f9c8971
--- /dev/null
+++ b/includes/csprcslong-md.md
@@ -0,0 +1 @@
+Visual C# 2005
\ No newline at end of file
diff --git a/includes/desktop-appname-md.md b/includes/desktop-appname-md.md
new file mode 100644
index 00000000000..d2f7aa156df
--- /dev/null
+++ b/includes/desktop-appname-md.md
@@ -0,0 +1 @@
+デスクトップ
\ No newline at end of file
diff --git a/includes/dnprdnext-md.md b/includes/dnprdnext-md.md
new file mode 100644
index 00000000000..a85e933d2f6
--- /dev/null
+++ b/includes/dnprdnext-md.md
@@ -0,0 +1 @@
+.NET Framework 2.0
\ No newline at end of file
diff --git a/includes/dnprdnlong-md.md b/includes/dnprdnlong-md.md
new file mode 100644
index 00000000000..a85e933d2f6
--- /dev/null
+++ b/includes/dnprdnlong-md.md
@@ -0,0 +1 @@
+.NET Framework 2.0
\ No newline at end of file
diff --git a/includes/dnprdnshort-md.md b/includes/dnprdnshort-md.md
new file mode 100644
index 00000000000..578b265eda1
--- /dev/null
+++ b/includes/dnprdnshort-md.md
@@ -0,0 +1 @@
+.NET Framework
\ No newline at end of file
diff --git a/includes/dublin-md.md b/includes/dublin-md.md
new file mode 100644
index 00000000000..ca45e628cb9
--- /dev/null
+++ b/includes/dublin-md.md
@@ -0,0 +1 @@
+Windows Server AppFabric のホスト機能
\ No newline at end of file
diff --git a/includes/dublin2-md.md b/includes/dublin2-md.md
new file mode 100644
index 00000000000..c55615dc04e
--- /dev/null
+++ b/includes/dublin2-md.md
@@ -0,0 +1 @@
+ホスト機能
\ No newline at end of file
diff --git a/includes/esql-md.md b/includes/esql-md.md
new file mode 100644
index 00000000000..454e7fd1848
--- /dev/null
+++ b/includes/esql-md.md
@@ -0,0 +1 @@
+Entity SQL
\ No newline at end of file
diff --git a/includes/fileexplorer-md.md b/includes/fileexplorer-md.md
new file mode 100644
index 00000000000..485d30a3dc5
--- /dev/null
+++ b/includes/fileexplorer-md.md
@@ -0,0 +1 @@
+エクスプローラー
\ No newline at end of file
diff --git a/includes/iis60-md.md b/includes/iis60-md.md
new file mode 100644
index 00000000000..8b2834828a2
--- /dev/null
+++ b/includes/iis60-md.md
@@ -0,0 +1 @@
+インターネット インフォメーション サービス (IIS) 6.0
\ No newline at end of file
diff --git a/includes/iis601-md.md b/includes/iis601-md.md
new file mode 100644
index 00000000000..cf2284ff92d
--- /dev/null
+++ b/includes/iis601-md.md
@@ -0,0 +1 @@
+IIS 6.0
\ No newline at end of file
diff --git a/includes/iisver-md.md b/includes/iisver-md.md
new file mode 100644
index 00000000000..67f5b1fa851
--- /dev/null
+++ b/includes/iisver-md.md
@@ -0,0 +1 @@
+IIS 7.0
\ No newline at end of file
diff --git a/includes/indigo1-md.md b/includes/indigo1-md.md
new file mode 100644
index 00000000000..98b719c6a72
--- /dev/null
+++ b/includes/indigo1-md.md
@@ -0,0 +1 @@
+Windows Communication Foundation (WCF)
\ No newline at end of file
diff --git a/includes/indigo2-md.md b/includes/indigo2-md.md
new file mode 100644
index 00000000000..75f27fcc2a2
--- /dev/null
+++ b/includes/indigo2-md.md
@@ -0,0 +1 @@
+WCF
\ No newline at end of file
diff --git a/includes/infocard-md.md b/includes/infocard-md.md
new file mode 100644
index 00000000000..4c1f24ace17
--- /dev/null
+++ b/includes/infocard-md.md
@@ -0,0 +1 @@
+CardSpace
\ No newline at end of file
diff --git a/includes/jsprjscript-md.md b/includes/jsprjscript-md.md
new file mode 100644
index 00000000000..7f88927ed24
--- /dev/null
+++ b/includes/jsprjscript-md.md
@@ -0,0 +1 @@
+JScript
\ No newline at end of file
diff --git a/includes/linq-dataset-md.md b/includes/linq-dataset-md.md
new file mode 100644
index 00000000000..7cb495733db
--- /dev/null
+++ b/includes/linq-dataset-md.md
@@ -0,0 +1 @@
+LINQ to DataSet
\ No newline at end of file
diff --git a/includes/linq-entities-md.md b/includes/linq-entities-md.md
new file mode 100644
index 00000000000..d8baff284c8
--- /dev/null
+++ b/includes/linq-entities-md.md
@@ -0,0 +1 @@
+LINQ to Entities
\ No newline at end of file
diff --git a/includes/lserver-md.md b/includes/lserver-md.md
new file mode 100644
index 00000000000..a655b05d8c5
--- /dev/null
+++ b/includes/lserver-md.md
@@ -0,0 +1 @@
+Windows Server 2008
\ No newline at end of file
diff --git a/includes/msconame-md.md b/includes/msconame-md.md
new file mode 100644
index 00000000000..a655b05d8c5
--- /dev/null
+++ b/includes/msconame-md.md
@@ -0,0 +1 @@
+Windows Server 2008
\ No newline at end of file
diff --git a/includes/ndptecclick-md.md b/includes/ndptecclick-md.md
new file mode 100644
index 00000000000..9354b8371a8
--- /dev/null
+++ b/includes/ndptecclick-md.md
@@ -0,0 +1 @@
+ClickOnce
\ No newline at end of file
diff --git a/includes/ndptecgdi-md.md b/includes/ndptecgdi-md.md
new file mode 100644
index 00000000000..dca1dfd7aac
--- /dev/null
+++ b/includes/ndptecgdi-md.md
@@ -0,0 +1 @@
+GDI
\ No newline at end of file
diff --git a/includes/ndptecgdiplus-md.md b/includes/ndptecgdiplus-md.md
new file mode 100644
index 00000000000..5b0edbf8453
--- /dev/null
+++ b/includes/ndptecgdiplus-md.md
@@ -0,0 +1 @@
+GDI+
\ No newline at end of file
diff --git a/includes/net-client-v40-long-md.md b/includes/net-client-v40-long-md.md
new file mode 100644
index 00000000000..6eb2fced46b
--- /dev/null
+++ b/includes/net-client-v40-long-md.md
@@ -0,0 +1 @@
+.NET Framework 4 Client Profile
\ No newline at end of file
diff --git a/includes/net-core-md.md b/includes/net-core-md.md
new file mode 100644
index 00000000000..f53daf1278b
--- /dev/null
+++ b/includes/net-core-md.md
@@ -0,0 +1 @@
+.NET Core
\ No newline at end of file
diff --git a/includes/net-native-md.md b/includes/net-native-md.md
new file mode 100644
index 00000000000..e4b04f97331
--- /dev/null
+++ b/includes/net-native-md.md
@@ -0,0 +1 @@
+.NET Native
\ No newline at end of file
diff --git a/includes/net-portable-md.md b/includes/net-portable-md.md
new file mode 100644
index 00000000000..556960e748f
--- /dev/null
+++ b/includes/net-portable-md.md
@@ -0,0 +1 @@
+ポータブル クラス ライブラリ
\ No newline at end of file
diff --git a/includes/net-security-note-md.md b/includes/net-security-note-md.md
new file mode 100644
index 00000000000..22aaa548f2a
--- /dev/null
+++ b/includes/net-security-note-md.md
@@ -0,0 +1,6 @@
+> [!CAUTION]
+>  コード アクセス セキュリティと部分的に信頼できるコード  
+>   
+>  .NET Framework には、コード アクセス セキュリティ (CAS) と呼ばれる、同一アプリケーションで実行される各種コードにさまざまな信頼レベルを強制的に適用するメカニズムが備わっています。  .NET Framework のコード アクセス セキュリティは、コードの実行元や他の ID 情報に基づいてセキュリティ境界を適用するメカニズムとして使用しないでください。 現在、部分的に信頼されるコード (特に実行元が不明なコード) では、コード アクセス セキュリティと透過的セキュリティ コードがセキュリティ境界としてサポートされないように、ガイダンスを更新しています。 発生元の不明なコードの読み込みと実行に関しては、他のセキュリティ対策を適切に導入することなく行わないようにしてください。  
+>   
+>  このポリシーは .NET Framework のすべてのバージョンに適用されますが、Silverlight に含まれる .NET Framework には適用されません。
\ No newline at end of file
diff --git a/includes/net-v10-short-md.md b/includes/net-v10-short-md.md
new file mode 100644
index 00000000000..2fa845562a3
--- /dev/null
+++ b/includes/net-v10-short-md.md
@@ -0,0 +1 @@
+.NET Framework 1.0
\ No newline at end of file
diff --git a/includes/net-v11-long-md.md b/includes/net-v11-long-md.md
new file mode 100644
index 00000000000..cee1774a1ff
--- /dev/null
+++ b/includes/net-v11-long-md.md
@@ -0,0 +1 @@
+.NET Framework 1.1
\ No newline at end of file
diff --git a/includes/net-v11-short-md.md b/includes/net-v11-short-md.md
new file mode 100644
index 00000000000..cee1774a1ff
--- /dev/null
+++ b/includes/net-v11-short-md.md
@@ -0,0 +1 @@
+.NET Framework 1.1
\ No newline at end of file
diff --git a/includes/net-v20sp1-long-md.md b/includes/net-v20sp1-long-md.md
new file mode 100644
index 00000000000..8c0ce41f6b4
--- /dev/null
+++ b/includes/net-v20sp1-long-md.md
@@ -0,0 +1 @@
+.NET Framework 2.0 Service Pack 1
\ No newline at end of file
diff --git a/includes/net-v20sp1-short-md.md b/includes/net-v20sp1-short-md.md
new file mode 100644
index 00000000000..9cf1b8e62db
--- /dev/null
+++ b/includes/net-v20sp1-short-md.md
@@ -0,0 +1 @@
+.NET Framework 2.0 SP1
\ No newline at end of file
diff --git a/includes/net-v30-long-md.md b/includes/net-v30-long-md.md
new file mode 100644
index 00000000000..8ed710fd7bf
--- /dev/null
+++ b/includes/net-v30-long-md.md
@@ -0,0 +1 @@
+.NET Framework 3.0
\ No newline at end of file
diff --git a/includes/net-v30-short-md.md b/includes/net-v30-short-md.md
new file mode 100644
index 00000000000..8ed710fd7bf
--- /dev/null
+++ b/includes/net-v30-short-md.md
@@ -0,0 +1 @@
+.NET Framework 3.0
\ No newline at end of file
diff --git a/includes/net-v35-long-md.md b/includes/net-v35-long-md.md
new file mode 100644
index 00000000000..ac0a01c24e9
--- /dev/null
+++ b/includes/net-v35-long-md.md
@@ -0,0 +1 @@
+ .NET Framework 3.5 
\ No newline at end of file
diff --git a/includes/net-v35-short-md.md b/includes/net-v35-short-md.md
new file mode 100644
index 00000000000..3b3e17628c7
--- /dev/null
+++ b/includes/net-v35-short-md.md
@@ -0,0 +1 @@
+.NET Framework 3.5
\ No newline at end of file
diff --git a/includes/net-v35sp1-long-md.md b/includes/net-v35sp1-long-md.md
new file mode 100644
index 00000000000..a4bbf5adf40
--- /dev/null
+++ b/includes/net-v35sp1-long-md.md
@@ -0,0 +1 @@
+.NET Framework 3.5 Service Pack 1
\ No newline at end of file
diff --git a/includes/net-v35sp1-short-md.md b/includes/net-v35sp1-short-md.md
new file mode 100644
index 00000000000..0f46ca34db3
--- /dev/null
+++ b/includes/net-v35sp1-short-md.md
@@ -0,0 +1 @@
+.NET Framework 3.5 SP1
\ No newline at end of file
diff --git a/includes/net-v40-long-md.md b/includes/net-v40-long-md.md
new file mode 100644
index 00000000000..a6ccdbf9fb7
--- /dev/null
+++ b/includes/net-v40-long-md.md
@@ -0,0 +1 @@
+.NET Framework 4
\ No newline at end of file
diff --git a/includes/net-v40-short-md.md b/includes/net-v40-short-md.md
new file mode 100644
index 00000000000..a6ccdbf9fb7
--- /dev/null
+++ b/includes/net-v40-short-md.md
@@ -0,0 +1 @@
+.NET Framework 4
\ No newline at end of file
diff --git a/includes/net-v45-md.md b/includes/net-v45-md.md
new file mode 100644
index 00000000000..7b4bf0fb0dc
--- /dev/null
+++ b/includes/net-v45-md.md
@@ -0,0 +1 @@
+.NET Framework 4.5
\ No newline at end of file
diff --git a/includes/net-v451-md.md b/includes/net-v451-md.md
new file mode 100644
index 00000000000..81ec8b4536e
--- /dev/null
+++ b/includes/net-v451-md.md
@@ -0,0 +1 @@
+.NET Framework 4.5.1
\ No newline at end of file
diff --git a/includes/net-v452-md.md b/includes/net-v452-md.md
new file mode 100644
index 00000000000..5db8902ca2f
--- /dev/null
+++ b/includes/net-v452-md.md
@@ -0,0 +1 @@
+.NET Framework 4.5.2
\ No newline at end of file
diff --git a/includes/net-v46-md.md b/includes/net-v46-md.md
new file mode 100644
index 00000000000..f091db4a79c
--- /dev/null
+++ b/includes/net-v46-md.md
@@ -0,0 +1 @@
+.NET Framework 4.6
\ No newline at end of file
diff --git a/includes/net-v461-md.md b/includes/net-v461-md.md
new file mode 100644
index 00000000000..f12ccd97aa6
--- /dev/null
+++ b/includes/net-v461-md.md
@@ -0,0 +1 @@
+.NET Framework 4.6.1
\ No newline at end of file
diff --git a/includes/net-v462-md.md b/includes/net-v462-md.md
new file mode 100644
index 00000000000..5386eb0cfae
--- /dev/null
+++ b/includes/net-v462-md.md
@@ -0,0 +1 @@
+.NET Framework 4.6.2
\ No newline at end of file
diff --git a/includes/net-win8-profile-md.md b/includes/net-win8-profile-md.md
new file mode 100644
index 00000000000..58072a750f3
--- /dev/null
+++ b/includes/net-win8-profile-md.md
@@ -0,0 +1 @@
+Windows 8.x ストア アプリ用 .NET
\ No newline at end of file
diff --git a/includes/netfx-current-long-md.md b/includes/netfx-current-long-md.md
new file mode 100644
index 00000000000..f12ccd97aa6
--- /dev/null
+++ b/includes/netfx-current-long-md.md
@@ -0,0 +1 @@
+.NET Framework 4.6.1
\ No newline at end of file
diff --git a/includes/netfx-current-short-md.md b/includes/netfx-current-short-md.md
new file mode 100644
index 00000000000..f12ccd97aa6
--- /dev/null
+++ b/includes/netfx-current-short-md.md
@@ -0,0 +1 @@
+.NET Framework 4.6.1
\ No newline at end of file
diff --git a/includes/netfx35-long-md.md b/includes/netfx35-long-md.md
new file mode 100644
index 00000000000..137eaf9672c
--- /dev/null
+++ b/includes/netfx35-long-md.md
@@ -0,0 +1 @@
+.NET Framework version 3.5
\ No newline at end of file
diff --git a/includes/netfx35-short-md.md b/includes/netfx35-short-md.md
new file mode 100644
index 00000000000..3b3e17628c7
--- /dev/null
+++ b/includes/netfx35-short-md.md
@@ -0,0 +1 @@
+.NET Framework 3.5
\ No newline at end of file
diff --git a/includes/netfx40-long-md.md b/includes/netfx40-long-md.md
new file mode 100644
index 00000000000..159059ada1c
--- /dev/null
+++ b/includes/netfx40-long-md.md
@@ -0,0 +1 @@
+.NET Framework version 4
\ No newline at end of file
diff --git a/includes/netfx40-short-md.md b/includes/netfx40-short-md.md
new file mode 100644
index 00000000000..a6ccdbf9fb7
--- /dev/null
+++ b/includes/netfx40-short-md.md
@@ -0,0 +1 @@
+.NET Framework 4
\ No newline at end of file
diff --git a/includes/note-settings-general-md.md b/includes/note-settings-general-md.md
new file mode 100644
index 00000000000..f9ce3a4d6e4
--- /dev/null
+++ b/includes/note-settings-general-md.md
@@ -0,0 +1,2 @@
+> [!NOTE]
+>  次の手順で参照している Visual Studio ユーザー インターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。 これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。 詳細については、「[IDE をカスタマイズする](../Topic/Personalizing%20the%20Visual%20Studio%20IDE.md)」をご覧ください。
\ No newline at end of file
diff --git a/includes/ofprword-md.md b/includes/ofprword-md.md
new file mode 100644
index 00000000000..4c0765a254f
--- /dev/null
+++ b/includes/ofprword-md.md
@@ -0,0 +1 @@
+Microsoft Word
\ No newline at end of file
diff --git a/includes/silverlight-md.md b/includes/silverlight-md.md
new file mode 100644
index 00000000000..df62f960fed
--- /dev/null
+++ b/includes/silverlight-md.md
@@ -0,0 +1 @@
+Silverlight
\ No newline at end of file
diff --git a/includes/sqprsqext-md.md b/includes/sqprsqext-md.md
new file mode 100644
index 00000000000..bebd01bc914
--- /dev/null
+++ b/includes/sqprsqext-md.md
@@ -0,0 +1 @@
+Microsoft SQL Server 2005
\ No newline at end of file
diff --git a/includes/sqprsqlong-md.md b/includes/sqprsqlong-md.md
new file mode 100644
index 00000000000..f2d5b72816d
--- /dev/null
+++ b/includes/sqprsqlong-md.md
@@ -0,0 +1 @@
+SQL Server 2005
\ No newline at end of file
diff --git a/includes/ss2k-md.md b/includes/ss2k-md.md
new file mode 100644
index 00000000000..3fe9a5c1949
--- /dev/null
+++ b/includes/ss2k-md.md
@@ -0,0 +1 @@
+SQL Server 2000
\ No newline at end of file
diff --git a/includes/ssastoria-md.md b/includes/ssastoria-md.md
new file mode 100644
index 00000000000..7ccf532a05d
--- /dev/null
+++ b/includes/ssastoria-md.md
@@ -0,0 +1 @@
+WCF Data Services
\ No newline at end of file
diff --git a/includes/ssew-md.md b/includes/ssew-md.md
new file mode 100644
index 00000000000..d3ab3d9099e
--- /dev/null
+++ b/includes/ssew-md.md
@@ -0,0 +1 @@
+SQL Server Compact 3.5
\ No newline at end of file
diff --git a/includes/sskatmai-md.md b/includes/sskatmai-md.md
new file mode 100644
index 00000000000..109b6faeed2
--- /dev/null
+++ b/includes/sskatmai-md.md
@@ -0,0 +1 @@
+SQL Server 2008
\ No newline at end of file
diff --git a/includes/sskilimanjaro-md.md b/includes/sskilimanjaro-md.md
new file mode 100644
index 00000000000..16f111e6b9c
--- /dev/null
+++ b/includes/sskilimanjaro-md.md
@@ -0,0 +1 @@
+SQL Server 2008 R2
\ No newline at end of file
diff --git a/includes/ssnoversion-md.md b/includes/ssnoversion-md.md
new file mode 100644
index 00000000000..9b0ee94fd50
--- /dev/null
+++ b/includes/ssnoversion-md.md
@@ -0,0 +1 @@
+SQL Server
\ No newline at end of file
diff --git a/includes/ssodatafull-md.md b/includes/ssodatafull-md.md
new file mode 100644
index 00000000000..bf750eec6f2
--- /dev/null
+++ b/includes/ssodatafull-md.md
@@ -0,0 +1 @@
+Open Data Protocol (OData)
\ No newline at end of file
diff --git a/includes/ssodatashort-md.md b/includes/ssodatashort-md.md
new file mode 100644
index 00000000000..52fc7f5729f
--- /dev/null
+++ b/includes/ssodatashort-md.md
@@ -0,0 +1 @@
+OData
\ No newline at end of file
diff --git a/includes/ssversion2000-md.md b/includes/ssversion2000-md.md
new file mode 100644
index 00000000000..3fe9a5c1949
--- /dev/null
+++ b/includes/ssversion2000-md.md
@@ -0,0 +1 @@
+SQL Server 2000
\ No newline at end of file
diff --git a/includes/ssversion2005-md.md b/includes/ssversion2005-md.md
new file mode 100644
index 00000000000..f2d5b72816d
--- /dev/null
+++ b/includes/ssversion2005-md.md
@@ -0,0 +1 @@
+SQL Server 2005
\ No newline at end of file
diff --git a/includes/tla2sharptla-2d-md.md b/includes/tla2sharptla-2d-md.md
new file mode 100644
index 00000000000..23190149962
--- /dev/null
+++ b/includes/tla2sharptla-2d-md.md
@@ -0,0 +1 @@
+2-D
\ No newline at end of file
diff --git a/includes/tla2sharptla-3d-md.md b/includes/tla2sharptla-3d-md.md
new file mode 100644
index 00000000000..a8b112e9f71
--- /dev/null
+++ b/includes/tla2sharptla-3d-md.md
@@ -0,0 +1 @@
+3-D
\ No newline at end of file
diff --git a/includes/tla2sharptla-aa-md.md b/includes/tla2sharptla-aa-md.md
new file mode 100644
index 00000000000..9231d8a28c1
--- /dev/null
+++ b/includes/tla2sharptla-aa-md.md
@@ -0,0 +1 @@
+Active Accessibility
\ No newline at end of file
diff --git a/includes/tla2sharptla-actx-md.md b/includes/tla2sharptla-actx-md.md
new file mode 100644
index 00000000000..120da910f13
--- /dev/null
+++ b/includes/tla2sharptla-actx-md.md
@@ -0,0 +1 @@
+ActiveX
\ No newline at end of file
diff --git a/includes/tla2sharptla-adonet-md.md b/includes/tla2sharptla-adonet-md.md
new file mode 100644
index 00000000000..7b6552e6405
--- /dev/null
+++ b/includes/tla2sharptla-adonet-md.md
@@ -0,0 +1 @@
+ADO.NET
\ No newline at end of file
diff --git a/includes/tla2sharptla-api-md.md b/includes/tla2sharptla-api-md.md
new file mode 100644
index 00000000000..7a095357330
--- /dev/null
+++ b/includes/tla2sharptla-api-md.md
@@ -0,0 +1 @@
+API
\ No newline at end of file
diff --git a/includes/tla2sharptla-apisharpplural-md.md b/includes/tla2sharptla-apisharpplural-md.md
new file mode 100644
index 00000000000..7a095357330
--- /dev/null
+++ b/includes/tla2sharptla-apisharpplural-md.md
@@ -0,0 +1 @@
+API
\ No newline at end of file
diff --git a/includes/tla2sharptla-argb-md.md b/includes/tla2sharptla-argb-md.md
new file mode 100644
index 00000000000..061590f4b45
--- /dev/null
+++ b/includes/tla2sharptla-argb-md.md
@@ -0,0 +1 @@
+ARGB
\ No newline at end of file
diff --git a/includes/tla2sharptla-at-md.md b/includes/tla2sharptla-at-md.md
new file mode 100644
index 00000000000..6d908af2ccb
--- /dev/null
+++ b/includes/tla2sharptla-at-md.md
@@ -0,0 +1 @@
+支援技術
\ No newline at end of file
diff --git a/includes/tla2sharptla-atsharpplural-md.md b/includes/tla2sharptla-atsharpplural-md.md
new file mode 100644
index 00000000000..6d908af2ccb
--- /dev/null
+++ b/includes/tla2sharptla-atsharpplural-md.md
@@ -0,0 +1 @@
+支援技術
\ No newline at end of file
diff --git a/includes/tla2sharptla-avalonwinfx-md.md b/includes/tla2sharptla-avalonwinfx-md.md
new file mode 100644
index 00000000000..578b265eda1
--- /dev/null
+++ b/includes/tla2sharptla-avalonwinfx-md.md
@@ -0,0 +1 @@
+.NET Framework
\ No newline at end of file
diff --git a/includes/tla2sharptla-baml-md.md b/includes/tla2sharptla-baml-md.md
new file mode 100644
index 00000000000..e45e928c49a
--- /dev/null
+++ b/includes/tla2sharptla-baml-md.md
@@ -0,0 +1 @@
+BAML
\ No newline at end of file
diff --git a/includes/tla2sharptla-bmp-md.md b/includes/tla2sharptla-bmp-md.md
new file mode 100644
index 00000000000..5245bf4b7a6
--- /dev/null
+++ b/includes/tla2sharptla-bmp-md.md
@@ -0,0 +1 @@
+BMP
\ No newline at end of file
diff --git a/includes/tla2sharptla-caf-md.md b/includes/tla2sharptla-caf-md.md
new file mode 100644
index 00000000000..cbbf1fee287
--- /dev/null
+++ b/includes/tla2sharptla-caf-md.md
@@ -0,0 +1 @@
+Annotations Framework
\ No newline at end of file
diff --git a/includes/tla2sharptla-cas-md.md b/includes/tla2sharptla-cas-md.md
new file mode 100644
index 00000000000..4fd5b3ccdda
--- /dev/null
+++ b/includes/tla2sharptla-cas-md.md
@@ -0,0 +1 @@
+CAS
\ No newline at end of file
diff --git a/includes/tla2sharptla-clickonce-md.md b/includes/tla2sharptla-clickonce-md.md
new file mode 100644
index 00000000000..9354b8371a8
--- /dev/null
+++ b/includes/tla2sharptla-clickonce-md.md
@@ -0,0 +1 @@
+ClickOnce
\ No newline at end of file
diff --git a/includes/tla2sharptla-clr-md.md b/includes/tla2sharptla-clr-md.md
new file mode 100644
index 00000000000..24584f2c1f2
--- /dev/null
+++ b/includes/tla2sharptla-clr-md.md
@@ -0,0 +1 @@
+CLR
\ No newline at end of file
diff --git a/includes/tla2sharptla-com-md.md b/includes/tla2sharptla-com-md.md
new file mode 100644
index 00000000000..2ce1fe653b3
--- /dev/null
+++ b/includes/tla2sharptla-com-md.md
@@ -0,0 +1 @@
+COM
\ No newline at end of file
diff --git a/includes/tla2sharptla-cpp-md.md b/includes/tla2sharptla-cpp-md.md
new file mode 100644
index 00000000000..ec2d88efe3e
--- /dev/null
+++ b/includes/tla2sharptla-cpp-md.md
@@ -0,0 +1 @@
+C++
\ No newline at end of file
diff --git a/includes/tla2sharptla-cppcli-md.md b/includes/tla2sharptla-cppcli-md.md
new file mode 100644
index 00000000000..cb77abc1a58
--- /dev/null
+++ b/includes/tla2sharptla-cppcli-md.md
@@ -0,0 +1 @@
+C++/CLI
\ No newline at end of file
diff --git a/includes/tla2sharptla-cshrp-md.md b/includes/tla2sharptla-cshrp-md.md
new file mode 100644
index 00000000000..9fe41fc4939
--- /dev/null
+++ b/includes/tla2sharptla-cshrp-md.md
@@ -0,0 +1 @@
+C#
\ No newline at end of file
diff --git a/includes/tla2sharptla-ct-md.md b/includes/tla2sharptla-ct-md.md
new file mode 100644
index 00000000000..22ced9d4254
--- /dev/null
+++ b/includes/tla2sharptla-ct-md.md
@@ -0,0 +1 @@
+ClearType
\ No newline at end of file
diff --git a/includes/tla2sharptla-dll-md.md b/includes/tla2sharptla-dll-md.md
new file mode 100644
index 00000000000..cd5760ea67d
--- /dev/null
+++ b/includes/tla2sharptla-dll-md.md
@@ -0,0 +1 @@
+[DLL]
\ No newline at end of file
diff --git a/includes/tla2sharptla-dpi-md.md b/includes/tla2sharptla-dpi-md.md
new file mode 100644
index 00000000000..98a0f7fb82e
--- /dev/null
+++ b/includes/tla2sharptla-dpi-md.md
@@ -0,0 +1 @@
+dpi
\ No newline at end of file
diff --git a/includes/tla2sharptla-dx-md.md b/includes/tla2sharptla-dx-md.md
new file mode 100644
index 00000000000..71d221e075a
--- /dev/null
+++ b/includes/tla2sharptla-dx-md.md
@@ -0,0 +1 @@
+DirectX
\ No newline at end of file
diff --git a/includes/tla2sharptla-emf-md.md b/includes/tla2sharptla-emf-md.md
new file mode 100644
index 00000000000..f67d8c748b6
--- /dev/null
+++ b/includes/tla2sharptla-emf-md.md
@@ -0,0 +1 @@
+EMF
\ No newline at end of file
diff --git a/includes/tla2sharptla-gac-md.md b/includes/tla2sharptla-gac-md.md
new file mode 100644
index 00000000000..c80f3fa6c7d
--- /dev/null
+++ b/includes/tla2sharptla-gac-md.md
@@ -0,0 +1 @@
+ GAC 
\ No newline at end of file
diff --git a/includes/tla2sharptla-gdi-md.md b/includes/tla2sharptla-gdi-md.md
new file mode 100644
index 00000000000..dca1dfd7aac
--- /dev/null
+++ b/includes/tla2sharptla-gdi-md.md
@@ -0,0 +1 @@
+GDI
\ No newline at end of file
diff --git a/includes/tla2sharptla-gdiplus-md.md b/includes/tla2sharptla-gdiplus-md.md
new file mode 100644
index 00000000000..5b0edbf8453
--- /dev/null
+++ b/includes/tla2sharptla-gdiplus-md.md
@@ -0,0 +1 @@
+GDI+
\ No newline at end of file
diff --git a/includes/tla2sharptla-gif-md.md b/includes/tla2sharptla-gif-md.md
new file mode 100644
index 00000000000..2b7e197afed
--- /dev/null
+++ b/includes/tla2sharptla-gif-md.md
@@ -0,0 +1 @@
+GIF
\ No newline at end of file
diff --git a/includes/tla2sharptla-gui-md.md b/includes/tla2sharptla-gui-md.md
new file mode 100644
index 00000000000..70fac1bcb13
--- /dev/null
+++ b/includes/tla2sharptla-gui-md.md
@@ -0,0 +1 @@
+GUI
\ No newline at end of file
diff --git a/includes/tla2sharptla-html-md.md b/includes/tla2sharptla-html-md.md
new file mode 100644
index 00000000000..3225efc49a9
--- /dev/null
+++ b/includes/tla2sharptla-html-md.md
@@ -0,0 +1 @@
+HTML
\ No newline at end of file
diff --git a/includes/tla2sharptla-http-md.md b/includes/tla2sharptla-http-md.md
new file mode 100644
index 00000000000..7031821f57c
--- /dev/null
+++ b/includes/tla2sharptla-http-md.md
@@ -0,0 +1 @@
+HTTP
\ No newline at end of file
diff --git a/includes/tla2sharptla-ide-md.md b/includes/tla2sharptla-ide-md.md
new file mode 100644
index 00000000000..ab59b86315f
--- /dev/null
+++ b/includes/tla2sharptla-ide-md.md
@@ -0,0 +1 @@
+IDE
\ No newline at end of file
diff --git a/includes/tla2sharptla-idsharpplural-md.md b/includes/tla2sharptla-idsharpplural-md.md
new file mode 100644
index 00000000000..be816a577c6
--- /dev/null
+++ b/includes/tla2sharptla-idsharpplural-md.md
@@ -0,0 +1 @@
+ID
\ No newline at end of file
diff --git a/includes/tla2sharptla-ie-md.md b/includes/tla2sharptla-ie-md.md
new file mode 100644
index 00000000000..44bb34c8f97
--- /dev/null
+++ b/includes/tla2sharptla-ie-md.md
@@ -0,0 +1 @@
+Internet Explorer
\ No newline at end of file
diff --git a/includes/tla2sharptla-ie6-md.md b/includes/tla2sharptla-ie6-md.md
new file mode 100644
index 00000000000..e880d15a013
--- /dev/null
+++ b/includes/tla2sharptla-ie6-md.md
@@ -0,0 +1 @@
+Microsoft Internet Explorer 6
\ No newline at end of file
diff --git a/includes/tla2sharptla-ie6sp2-md.md b/includes/tla2sharptla-ie6sp2-md.md
new file mode 100644
index 00000000000..0e7f01b0274
--- /dev/null
+++ b/includes/tla2sharptla-ie6sp2-md.md
@@ -0,0 +1 @@
+IE6 SP2
\ No newline at end of file
diff --git a/includes/tla2sharptla-ie7-md.md b/includes/tla2sharptla-ie7-md.md
new file mode 100644
index 00000000000..95495b465f0
--- /dev/null
+++ b/includes/tla2sharptla-ie7-md.md
@@ -0,0 +1 @@
+Internet Explorer 7
\ No newline at end of file
diff --git a/includes/tla2sharptla-iegeneric-md.md b/includes/tla2sharptla-iegeneric-md.md
new file mode 100644
index 00000000000..44bb34c8f97
--- /dev/null
+++ b/includes/tla2sharptla-iegeneric-md.md
@@ -0,0 +1 @@
+Internet Explorer
\ No newline at end of file
diff --git a/includes/tla2sharptla-iis5-md.md b/includes/tla2sharptla-iis5-md.md
new file mode 100644
index 00000000000..52cb694d40f
--- /dev/null
+++ b/includes/tla2sharptla-iis5-md.md
@@ -0,0 +1 @@
+ IIS 
\ No newline at end of file
diff --git a/includes/tla2sharptla-ime-md.md b/includes/tla2sharptla-ime-md.md
new file mode 100644
index 00000000000..df6794acd4f
--- /dev/null
+++ b/includes/tla2sharptla-ime-md.md
@@ -0,0 +1 @@
+IME
\ No newline at end of file
diff --git a/includes/tla2sharptla-intellisense-md.md b/includes/tla2sharptla-intellisense-md.md
new file mode 100644
index 00000000000..a620522df34
--- /dev/null
+++ b/includes/tla2sharptla-intellisense-md.md
@@ -0,0 +1 @@
+IntelliSense
\ No newline at end of file
diff --git a/includes/tla2sharptla-jpeg-md.md b/includes/tla2sharptla-jpeg-md.md
new file mode 100644
index 00000000000..d4d1537f685
--- /dev/null
+++ b/includes/tla2sharptla-jpeg-md.md
@@ -0,0 +1 @@
+JPEG
\ No newline at end of file
diff --git a/includes/tla2sharptla-lhcshrp-md.md b/includes/tla2sharptla-lhcshrp-md.md
new file mode 100644
index 00000000000..9fe41fc4939
--- /dev/null
+++ b/includes/tla2sharptla-lhcshrp-md.md
@@ -0,0 +1 @@
+C#
\ No newline at end of file
diff --git a/includes/tla2sharptla-lhsdk-md.md b/includes/tla2sharptla-lhsdk-md.md
new file mode 100644
index 00000000000..6da97bda29c
--- /dev/null
+++ b/includes/tla2sharptla-lhsdk-md.md
@@ -0,0 +1 @@
+Windows SDK
\ No newline at end of file
diff --git a/includes/tla2sharptla-metro-md.md b/includes/tla2sharptla-metro-md.md
new file mode 100644
index 00000000000..bc32e60a990
--- /dev/null
+++ b/includes/tla2sharptla-metro-md.md
@@ -0,0 +1 @@
+XPS
\ No newline at end of file
diff --git a/includes/tla2sharptla-mime-md.md b/includes/tla2sharptla-mime-md.md
new file mode 100644
index 00000000000..59664a72a19
--- /dev/null
+++ b/includes/tla2sharptla-mime-md.md
@@ -0,0 +1 @@
+MIME
\ No newline at end of file
diff --git a/includes/tla2sharptla-ms-md.md b/includes/tla2sharptla-ms-md.md
new file mode 100644
index 00000000000..a04fcf98800
--- /dev/null
+++ b/includes/tla2sharptla-ms-md.md
@@ -0,0 +1 @@
+Microsoft
\ No newline at end of file
diff --git a/includes/tla2sharptla-msbuild-md.md b/includes/tla2sharptla-msbuild-md.md
new file mode 100644
index 00000000000..3ff1ea73f85
--- /dev/null
+++ b/includes/tla2sharptla-msbuild-md.md
@@ -0,0 +1 @@
+MSBuild
\ No newline at end of file
diff --git a/includes/tla2sharptla-mswin-md.md b/includes/tla2sharptla-mswin-md.md
new file mode 100644
index 00000000000..1058cb39495
--- /dev/null
+++ b/includes/tla2sharptla-mswin-md.md
@@ -0,0 +1 @@
+Windows
\ No newline at end of file
diff --git a/includes/tla2sharptla-net-md.md b/includes/tla2sharptla-net-md.md
new file mode 100644
index 00000000000..d49ef201e75
--- /dev/null
+++ b/includes/tla2sharptla-net-md.md
@@ -0,0 +1 @@
+.NET
\ No newline at end of file
diff --git a/includes/tla2sharptla-netframewk-md.md b/includes/tla2sharptla-netframewk-md.md
new file mode 100644
index 00000000000..4de25f024d0
--- /dev/null
+++ b/includes/tla2sharptla-netframewk-md.md
@@ -0,0 +1 @@
+フレームワーク
\ No newline at end of file
diff --git a/includes/tla2sharptla-netframewkattrsharpplural-md.md b/includes/tla2sharptla-netframewkattrsharpplural-md.md
new file mode 100644
index 00000000000..120deaf1f6c
--- /dev/null
+++ b/includes/tla2sharptla-netframewkattrsharpplural-md.md
@@ -0,0 +1 @@
+.NET Framework 属性
\ No newline at end of file
diff --git a/includes/tla2sharptla-ole2-0-md.md b/includes/tla2sharptla-ole2-0-md.md
new file mode 100644
index 00000000000..7b863931c4a
--- /dev/null
+++ b/includes/tla2sharptla-ole2-0-md.md
@@ -0,0 +1 @@
+OLE 2.0
\ No newline at end of file
diff --git a/includes/tla2sharptla-opentype-md.md b/includes/tla2sharptla-opentype-md.md
new file mode 100644
index 00000000000..fad0b0bfa09
--- /dev/null
+++ b/includes/tla2sharptla-opentype-md.md
@@ -0,0 +1 @@
+OpenType
\ No newline at end of file
diff --git a/includes/tla2sharptla-pinvoke-md.md b/includes/tla2sharptla-pinvoke-md.md
new file mode 100644
index 00000000000..e72557c4ea4
--- /dev/null
+++ b/includes/tla2sharptla-pinvoke-md.md
@@ -0,0 +1 @@
+PInvoke
\ No newline at end of file
diff --git a/includes/tla2sharptla-png-md.md b/includes/tla2sharptla-png-md.md
new file mode 100644
index 00000000000..67461379f1f
--- /dev/null
+++ b/includes/tla2sharptla-png-md.md
@@ -0,0 +1 @@
+PNG
\ No newline at end of file
diff --git a/includes/tla2sharptla-sdk-md.md b/includes/tla2sharptla-sdk-md.md
new file mode 100644
index 00000000000..bb3427d9181
--- /dev/null
+++ b/includes/tla2sharptla-sdk-md.md
@@ -0,0 +1 @@
+SDK
\ No newline at end of file
diff --git a/includes/tla2sharptla-sdl-md.md b/includes/tla2sharptla-sdl-md.md
new file mode 100644
index 00000000000..bf798a56736
--- /dev/null
+++ b/includes/tla2sharptla-sdl-md.md
@@ -0,0 +1 @@
+SDL
\ No newline at end of file
diff --git a/includes/tla2sharptla-sql-md.md b/includes/tla2sharptla-sql-md.md
new file mode 100644
index 00000000000..3b069a9fd1d
--- /dev/null
+++ b/includes/tla2sharptla-sql-md.md
@@ -0,0 +1 @@
+SQL
\ No newline at end of file
diff --git a/includes/tla2sharptla-tiff-md.md b/includes/tla2sharptla-tiff-md.md
new file mode 100644
index 00000000000..915ecc800dd
--- /dev/null
+++ b/includes/tla2sharptla-tiff-md.md
@@ -0,0 +1 @@
+TIFF
\ No newline at end of file
diff --git a/includes/tla2sharptla-titlexaml-md.md b/includes/tla2sharptla-titlexaml-md.md
new file mode 100644
index 00000000000..7d3d6afaedc
--- /dev/null
+++ b/includes/tla2sharptla-titlexaml-md.md
@@ -0,0 +1 @@
+XAML
\ No newline at end of file
diff --git a/includes/tla2sharptla-tpc-md.md b/includes/tla2sharptla-tpc-md.md
new file mode 100644
index 00000000000..834bcfc55be
--- /dev/null
+++ b/includes/tla2sharptla-tpc-md.md
@@ -0,0 +1 @@
+Tablet PC
\ No newline at end of file
diff --git a/includes/tla2sharptla-tpclssdk-md.md b/includes/tla2sharptla-tpclssdk-md.md
new file mode 100644
index 00000000000..2d89c570bd6
--- /dev/null
+++ b/includes/tla2sharptla-tpclssdk-md.md
@@ -0,0 +1 @@
+Tablet PC SDK 1.7
\ No newline at end of file
diff --git a/includes/tla2sharptla-truetype-md.md b/includes/tla2sharptla-truetype-md.md
new file mode 100644
index 00000000000..5766cce3612
--- /dev/null
+++ b/includes/tla2sharptla-truetype-md.md
@@ -0,0 +1 @@
+TrueType
\ No newline at end of file
diff --git a/includes/tla2sharptla-tsf-md.md b/includes/tla2sharptla-tsf-md.md
new file mode 100644
index 00000000000..75757cf69c5
--- /dev/null
+++ b/includes/tla2sharptla-tsf-md.md
@@ -0,0 +1 @@
+TSF
\ No newline at end of file
diff --git a/includes/tla2sharptla-ui-md.md b/includes/tla2sharptla-ui-md.md
new file mode 100644
index 00000000000..f599d5c5cad
--- /dev/null
+++ b/includes/tla2sharptla-ui-md.md
@@ -0,0 +1 @@
+UI
\ No newline at end of file
diff --git a/includes/tla2sharptla-uiautomation-md.md b/includes/tla2sharptla-uiautomation-md.md
new file mode 100644
index 00000000000..d8c9672a7cb
--- /dev/null
+++ b/includes/tla2sharptla-uiautomation-md.md
@@ -0,0 +1 @@
+UI オートメーション
\ No newline at end of file
diff --git a/includes/tla2sharptla-uisharpplural-md.md b/includes/tla2sharptla-uisharpplural-md.md
new file mode 100644
index 00000000000..f599d5c5cad
--- /dev/null
+++ b/includes/tla2sharptla-uisharpplural-md.md
@@ -0,0 +1 @@
+UI
\ No newline at end of file
diff --git a/includes/tla2sharptla-unc-md.md b/includes/tla2sharptla-unc-md.md
new file mode 100644
index 00000000000..3ef318cdd7b
--- /dev/null
+++ b/includes/tla2sharptla-unc-md.md
@@ -0,0 +1 @@
+UNC
\ No newline at end of file
diff --git a/includes/tla2sharptla-unicode-md.md b/includes/tla2sharptla-unicode-md.md
new file mode 100644
index 00000000000..a0388044512
--- /dev/null
+++ b/includes/tla2sharptla-unicode-md.md
@@ -0,0 +1 @@
+Unicode
\ No newline at end of file
diff --git a/includes/tla2sharptla-uri-md.md b/includes/tla2sharptla-uri-md.md
new file mode 100644
index 00000000000..f80712e1292
--- /dev/null
+++ b/includes/tla2sharptla-uri-md.md
@@ -0,0 +1 @@
+URI
\ No newline at end of file
diff --git a/includes/tla2sharptla-urisharpplural-md.md b/includes/tla2sharptla-urisharpplural-md.md
new file mode 100644
index 00000000000..f80712e1292
--- /dev/null
+++ b/includes/tla2sharptla-urisharpplural-md.md
@@ -0,0 +1 @@
+URI
\ No newline at end of file
diff --git a/includes/tla2sharptla-url-md.md b/includes/tla2sharptla-url-md.md
new file mode 100644
index 00000000000..e6a755c451b
--- /dev/null
+++ b/includes/tla2sharptla-url-md.md
@@ -0,0 +1 @@
+URL
\ No newline at end of file
diff --git a/includes/tla2sharptla-visualb-md.md b/includes/tla2sharptla-visualb-md.md
new file mode 100644
index 00000000000..777515bcd7e
--- /dev/null
+++ b/includes/tla2sharptla-visualb-md.md
@@ -0,0 +1 @@
+Visual Basic
\ No newline at end of file
diff --git a/includes/tla2sharptla-visualbnet-md.md b/includes/tla2sharptla-visualbnet-md.md
new file mode 100644
index 00000000000..9654edd1e64
--- /dev/null
+++ b/includes/tla2sharptla-visualbnet-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic .NET
\ No newline at end of file
diff --git a/includes/tla2sharptla-visualcpp-md.md b/includes/tla2sharptla-visualcpp-md.md
new file mode 100644
index 00000000000..c6d2435e98d
--- /dev/null
+++ b/includes/tla2sharptla-visualcpp-md.md
@@ -0,0 +1 @@
+Visual C++
\ No newline at end of file
diff --git a/includes/tla2sharptla-visualstu-md.md b/includes/tla2sharptla-visualstu-md.md
new file mode 100644
index 00000000000..fe15234ba36
--- /dev/null
+++ b/includes/tla2sharptla-visualstu-md.md
@@ -0,0 +1 @@
+Visual Studio
\ No newline at end of file
diff --git a/includes/tla2sharptla-visualstu2005-md.md b/includes/tla2sharptla-visualstu2005-md.md
new file mode 100644
index 00000000000..33fb76fddc1
--- /dev/null
+++ b/includes/tla2sharptla-visualstu2005-md.md
@@ -0,0 +1 @@
+Visual Studio 2005
\ No newline at end of file
diff --git a/includes/tla2sharptla-wcsdk-md.md b/includes/tla2sharptla-wcsdk-md.md
new file mode 100644
index 00000000000..6da97bda29c
--- /dev/null
+++ b/includes/tla2sharptla-wcsdk-md.md
@@ -0,0 +1 @@
+Windows SDK
\ No newline at end of file
diff --git a/includes/tla2sharptla-wdp-md.md b/includes/tla2sharptla-wdp-md.md
new file mode 100644
index 00000000000..42498a289c9
--- /dev/null
+++ b/includes/tla2sharptla-wdp-md.md
@@ -0,0 +1 @@
+Windows Media Photo
\ No newline at end of file
diff --git a/includes/tla2sharptla-wic-md.md b/includes/tla2sharptla-wic-md.md
new file mode 100644
index 00000000000..7f0f032d7ad
--- /dev/null
+++ b/includes/tla2sharptla-wic-md.md
@@ -0,0 +1 @@
+WPF イメージング
\ No newline at end of file
diff --git a/includes/tla2sharptla-win-md.md b/includes/tla2sharptla-win-md.md
new file mode 100644
index 00000000000..1058cb39495
--- /dev/null
+++ b/includes/tla2sharptla-win-md.md
@@ -0,0 +1 @@
+Windows
\ No newline at end of file
diff --git a/includes/tla2sharptla-win32-md.md b/includes/tla2sharptla-win32-md.md
new file mode 100644
index 00000000000..df14f554429
--- /dev/null
+++ b/includes/tla2sharptla-win32-md.md
@@ -0,0 +1 @@
+Win32
\ No newline at end of file
diff --git a/includes/tla2sharptla-winclient-md.md b/includes/tla2sharptla-winclient-md.md
new file mode 100644
index 00000000000..92826b01ec3
--- /dev/null
+++ b/includes/tla2sharptla-winclient-md.md
@@ -0,0 +1 @@
+WPF
\ No newline at end of file
diff --git a/includes/tla2sharptla-winevents-md.md b/includes/tla2sharptla-winevents-md.md
new file mode 100644
index 00000000000..3ed1753d52d
--- /dev/null
+++ b/includes/tla2sharptla-winevents-md.md
@@ -0,0 +1 @@
+WinEvents
\ No newline at end of file
diff --git a/includes/tla2sharptla-winforms-md.md b/includes/tla2sharptla-winforms-md.md
new file mode 100644
index 00000000000..64713036cb6
--- /dev/null
+++ b/includes/tla2sharptla-winforms-md.md
@@ -0,0 +1 @@
+Windows フォーム
\ No newline at end of file
diff --git a/includes/tla2sharptla-winformssharpinitcap-md.md b/includes/tla2sharptla-winformssharpinitcap-md.md
new file mode 100644
index 00000000000..64713036cb6
--- /dev/null
+++ b/includes/tla2sharptla-winformssharpinitcap-md.md
@@ -0,0 +1 @@
+Windows フォーム
\ No newline at end of file
diff --git a/includes/tla2sharptla-winfx-md.md b/includes/tla2sharptla-winfx-md.md
new file mode 100644
index 00000000000..578b265eda1
--- /dev/null
+++ b/includes/tla2sharptla-winfx-md.md
@@ -0,0 +1 @@
+.NET Framework
\ No newline at end of file
diff --git a/includes/tla2sharptla-winfxsdk-md.md b/includes/tla2sharptla-winfxsdk-md.md
new file mode 100644
index 00000000000..6da97bda29c
--- /dev/null
+++ b/includes/tla2sharptla-winfxsdk-md.md
@@ -0,0 +1 @@
+Windows SDK
\ No newline at end of file
diff --git a/includes/tla2sharptla-winfxwebapp-md.md b/includes/tla2sharptla-winfxwebapp-md.md
new file mode 100644
index 00000000000..6d0f65efa85
--- /dev/null
+++ b/includes/tla2sharptla-winfxwebapp-md.md
@@ -0,0 +1 @@
+XBAP
\ No newline at end of file
diff --git a/includes/tla2sharptla-wininstall-md.md b/includes/tla2sharptla-wininstall-md.md
new file mode 100644
index 00000000000..e1189836a48
--- /dev/null
+++ b/includes/tla2sharptla-wininstall-md.md
@@ -0,0 +1 @@
+Windows インストーラー
\ No newline at end of file
diff --git a/includes/tla2sharptla-winnetsvrfam-md.md b/includes/tla2sharptla-winnetsvrfam-md.md
new file mode 100644
index 00000000000..5e9d928e681
--- /dev/null
+++ b/includes/tla2sharptla-winnetsvrfam-md.md
@@ -0,0 +1 @@
+Windows Server 2003
\ No newline at end of file
diff --git a/includes/tla2sharptla-winvista-md.md b/includes/tla2sharptla-winvista-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/tla2sharptla-winvista-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/tla2sharptla-winxp-md.md b/includes/tla2sharptla-winxp-md.md
new file mode 100644
index 00000000000..e0723a78af5
--- /dev/null
+++ b/includes/tla2sharptla-winxp-md.md
@@ -0,0 +1 @@
+Microsoft Windows XP
\ No newline at end of file
diff --git a/includes/tla2sharptla-winxpsp2-md.md b/includes/tla2sharptla-winxpsp2-md.md
new file mode 100644
index 00000000000..04a512a7f73
--- /dev/null
+++ b/includes/tla2sharptla-winxpsp2-md.md
@@ -0,0 +1 @@
+Windows XP SP2
\ No newline at end of file
diff --git a/includes/tla2sharptla-wpf-md.md b/includes/tla2sharptla-wpf-md.md
new file mode 100644
index 00000000000..92826b01ec3
--- /dev/null
+++ b/includes/tla2sharptla-wpf-md.md
@@ -0,0 +1 @@
+WPF
\ No newline at end of file
diff --git a/includes/tla2sharptla-wys-md.md b/includes/tla2sharptla-wys-md.md
new file mode 100644
index 00000000000..8a4594dc56a
--- /dev/null
+++ b/includes/tla2sharptla-wys-md.md
@@ -0,0 +1 @@
+WYSIWYG
\ No newline at end of file
diff --git a/includes/tla2sharptla-xaml-md.md b/includes/tla2sharptla-xaml-md.md
new file mode 100644
index 00000000000..7d3d6afaedc
--- /dev/null
+++ b/includes/tla2sharptla-xaml-md.md
@@ -0,0 +1 @@
+XAML
\ No newline at end of file
diff --git a/includes/tla2sharptla-xbap-md.md b/includes/tla2sharptla-xbap-md.md
new file mode 100644
index 00000000000..6d0f65efa85
--- /dev/null
+++ b/includes/tla2sharptla-xbap-md.md
@@ -0,0 +1 @@
+XBAP
\ No newline at end of file
diff --git a/includes/tla2sharptla-xbapsharpplural-md.md b/includes/tla2sharptla-xbapsharpplural-md.md
new file mode 100644
index 00000000000..6d0f65efa85
--- /dev/null
+++ b/includes/tla2sharptla-xbapsharpplural-md.md
@@ -0,0 +1 @@
+XBAP
\ No newline at end of file
diff --git a/includes/tla2sharptla-xml-md.md b/includes/tla2sharptla-xml-md.md
new file mode 100644
index 00000000000..f86a2f5fe92
--- /dev/null
+++ b/includes/tla2sharptla-xml-md.md
@@ -0,0 +1 @@
+XML
\ No newline at end of file
diff --git a/includes/tla2sharptla-xpath-md.md b/includes/tla2sharptla-xpath-md.md
new file mode 100644
index 00000000000..24c85005bc9
--- /dev/null
+++ b/includes/tla2sharptla-xpath-md.md
@@ -0,0 +1 @@
+XPath
\ No newline at end of file
diff --git a/includes/tla2sharptla-xps-md.md b/includes/tla2sharptla-xps-md.md
new file mode 100644
index 00000000000..bc32e60a990
--- /dev/null
+++ b/includes/tla2sharptla-xps-md.md
@@ -0,0 +1 @@
+XPS
\ No newline at end of file
diff --git a/includes/tlasharptla-2d-md.md b/includes/tlasharptla-2d-md.md
new file mode 100644
index 00000000000..23190149962
--- /dev/null
+++ b/includes/tlasharptla-2d-md.md
@@ -0,0 +1 @@
+2-D
\ No newline at end of file
diff --git a/includes/tlasharptla-3d-md.md b/includes/tlasharptla-3d-md.md
new file mode 100644
index 00000000000..a8b112e9f71
--- /dev/null
+++ b/includes/tlasharptla-3d-md.md
@@ -0,0 +1 @@
+3-D
\ No newline at end of file
diff --git a/includes/tlasharptla-aa-md.md b/includes/tlasharptla-aa-md.md
new file mode 100644
index 00000000000..53bf1bc086c
--- /dev/null
+++ b/includes/tlasharptla-aa-md.md
@@ -0,0 +1 @@
+Microsoft Active Accessibility
\ No newline at end of file
diff --git a/includes/tlasharptla-actx-md.md b/includes/tlasharptla-actx-md.md
new file mode 100644
index 00000000000..7f6399fc84d
--- /dev/null
+++ b/includes/tlasharptla-actx-md.md
@@ -0,0 +1 @@
+Microsoft ActiveX
\ No newline at end of file
diff --git a/includes/tlasharptla-adonet-md.md b/includes/tlasharptla-adonet-md.md
new file mode 100644
index 00000000000..7b6552e6405
--- /dev/null
+++ b/includes/tlasharptla-adonet-md.md
@@ -0,0 +1 @@
+ADO.NET
\ No newline at end of file
diff --git a/includes/tlasharptla-aero-md.md b/includes/tlasharptla-aero-md.md
new file mode 100644
index 00000000000..596f97cb2ad
--- /dev/null
+++ b/includes/tlasharptla-aero-md.md
@@ -0,0 +1 @@
+Windows Aero
\ No newline at end of file
diff --git a/includes/tlasharptla-api-md.md b/includes/tlasharptla-api-md.md
new file mode 100644
index 00000000000..7a095357330
--- /dev/null
+++ b/includes/tlasharptla-api-md.md
@@ -0,0 +1 @@
+API
\ No newline at end of file
diff --git a/includes/tlasharptla-apisharpplural-md.md b/includes/tlasharptla-apisharpplural-md.md
new file mode 100644
index 00000000000..7a095357330
--- /dev/null
+++ b/includes/tlasharptla-apisharpplural-md.md
@@ -0,0 +1 @@
+API
\ No newline at end of file
diff --git a/includes/tlasharptla-argb-md.md b/includes/tlasharptla-argb-md.md
new file mode 100644
index 00000000000..061590f4b45
--- /dev/null
+++ b/includes/tlasharptla-argb-md.md
@@ -0,0 +1 @@
+ARGB
\ No newline at end of file
diff --git a/includes/tlasharptla-ascii-md.md b/includes/tlasharptla-ascii-md.md
new file mode 100644
index 00000000000..290822646f5
--- /dev/null
+++ b/includes/tlasharptla-ascii-md.md
@@ -0,0 +1 @@
+ASCII
\ No newline at end of file
diff --git a/includes/tlasharptla-aspnet-md.md b/includes/tlasharptla-aspnet-md.md
new file mode 100644
index 00000000000..f41705de76e
--- /dev/null
+++ b/includes/tlasharptla-aspnet-md.md
@@ -0,0 +1 @@
+ASP.NET
\ No newline at end of file
diff --git a/includes/tlasharptla-at-md.md b/includes/tlasharptla-at-md.md
new file mode 100644
index 00000000000..6d908af2ccb
--- /dev/null
+++ b/includes/tlasharptla-at-md.md
@@ -0,0 +1 @@
+支援技術
\ No newline at end of file
diff --git a/includes/tlasharptla-avalonwinfx-md.md b/includes/tlasharptla-avalonwinfx-md.md
new file mode 100644
index 00000000000..53910744e82
--- /dev/null
+++ b/includes/tlasharptla-avalonwinfx-md.md
@@ -0,0 +1 @@
+Microsoft .NET Framework
\ No newline at end of file
diff --git a/includes/tlasharptla-baml-md.md b/includes/tlasharptla-baml-md.md
new file mode 100644
index 00000000000..b70230b1a48
--- /dev/null
+++ b/includes/tlasharptla-baml-md.md
@@ -0,0 +1 @@
+バイナリ XAML (BAML)
\ No newline at end of file
diff --git a/includes/tlasharptla-bits-md.md b/includes/tlasharptla-bits-md.md
new file mode 100644
index 00000000000..88e13b8a92e
--- /dev/null
+++ b/includes/tlasharptla-bits-md.md
@@ -0,0 +1 @@
+Microsoft バックグラウンド インテリジェント転送サービス (BITS)
\ No newline at end of file
diff --git a/includes/tlasharptla-bmp-md.md b/includes/tlasharptla-bmp-md.md
new file mode 100644
index 00000000000..883bcdc5978
--- /dev/null
+++ b/includes/tlasharptla-bmp-md.md
@@ -0,0 +1 @@
+ビットマップ (BMP)
\ No newline at end of file
diff --git a/includes/tlasharptla-caf-md.md b/includes/tlasharptla-caf-md.md
new file mode 100644
index 00000000000..0b4f564eed7
--- /dev/null
+++ b/includes/tlasharptla-caf-md.md
@@ -0,0 +1 @@
+Microsoft Annotations Framework
\ No newline at end of file
diff --git a/includes/tlasharptla-cas-md.md b/includes/tlasharptla-cas-md.md
new file mode 100644
index 00000000000..d901a87b5cc
--- /dev/null
+++ b/includes/tlasharptla-cas-md.md
@@ -0,0 +1 @@
+コード アクセス セキュリティ (CAS)
\ No newline at end of file
diff --git a/includes/tlasharptla-clickonce-md.md b/includes/tlasharptla-clickonce-md.md
new file mode 100644
index 00000000000..9354b8371a8
--- /dev/null
+++ b/includes/tlasharptla-clickonce-md.md
@@ -0,0 +1 @@
+ClickOnce
\ No newline at end of file
diff --git a/includes/tlasharptla-clr-md.md b/includes/tlasharptla-clr-md.md
new file mode 100644
index 00000000000..b6e8f65da16
--- /dev/null
+++ b/includes/tlasharptla-clr-md.md
@@ -0,0 +1 @@
+共通言語ランタイム (CLR)
\ No newline at end of file
diff --git a/includes/tlasharptla-cls-md.md b/includes/tlasharptla-cls-md.md
new file mode 100644
index 00000000000..e4a4436a0f3
--- /dev/null
+++ b/includes/tlasharptla-cls-md.md
@@ -0,0 +1 @@
+共通言語仕様 (CLS)
\ No newline at end of file
diff --git a/includes/tlasharptla-com-md.md b/includes/tlasharptla-com-md.md
new file mode 100644
index 00000000000..f1468262b1c
--- /dev/null
+++ b/includes/tlasharptla-com-md.md
@@ -0,0 +1 @@
+コンポーネント オブジェクト モデル (COM)
\ No newline at end of file
diff --git a/includes/tlasharptla-cpp-md.md b/includes/tlasharptla-cpp-md.md
new file mode 100644
index 00000000000..ec2d88efe3e
--- /dev/null
+++ b/includes/tlasharptla-cpp-md.md
@@ -0,0 +1 @@
+C++
\ No newline at end of file
diff --git a/includes/tlasharptla-cppcli-md.md b/includes/tlasharptla-cppcli-md.md
new file mode 100644
index 00000000000..cb77abc1a58
--- /dev/null
+++ b/includes/tlasharptla-cppcli-md.md
@@ -0,0 +1 @@
+C++/CLI
\ No newline at end of file
diff --git a/includes/tlasharptla-cshrp-md.md b/includes/tlasharptla-cshrp-md.md
new file mode 100644
index 00000000000..9fe41fc4939
--- /dev/null
+++ b/includes/tlasharptla-cshrp-md.md
@@ -0,0 +1 @@
+C#
\ No newline at end of file
diff --git a/includes/tlasharptla-css-md.md b/includes/tlasharptla-css-md.md
new file mode 100644
index 00000000000..03636166271
--- /dev/null
+++ b/includes/tlasharptla-css-md.md
@@ -0,0 +1 @@
+カスケード スタイル シート (CSS)
\ No newline at end of file
diff --git a/includes/tlasharptla-ct-md.md b/includes/tlasharptla-ct-md.md
new file mode 100644
index 00000000000..7fdeadc7a22
--- /dev/null
+++ b/includes/tlasharptla-ct-md.md
@@ -0,0 +1 @@
+Microsoft ClearType
\ No newline at end of file
diff --git a/includes/tlasharptla-d3d-md.md b/includes/tlasharptla-d3d-md.md
new file mode 100644
index 00000000000..3f71ed67000
--- /dev/null
+++ b/includes/tlasharptla-d3d-md.md
@@ -0,0 +1 @@
+Microsoft Direct3D
\ No newline at end of file
diff --git a/includes/tlasharptla-dhtml-md.md b/includes/tlasharptla-dhtml-md.md
new file mode 100644
index 00000000000..4bb20d3ad2d
--- /dev/null
+++ b/includes/tlasharptla-dhtml-md.md
@@ -0,0 +1 @@
+ダイナミック HTML (DHTML)
\ No newline at end of file
diff --git a/includes/tlasharptla-dipixelsharpplural-md.md b/includes/tlasharptla-dipixelsharpplural-md.md
new file mode 100644
index 00000000000..3b64f1b197f
--- /dev/null
+++ b/includes/tlasharptla-dipixelsharpplural-md.md
@@ -0,0 +1 @@
+デバイスに依存しない単位 (1 単位は&1;/96 インチ)
\ No newline at end of file
diff --git a/includes/tlasharptla-dll-md.md b/includes/tlasharptla-dll-md.md
new file mode 100644
index 00000000000..47b0e4e4bba
--- /dev/null
+++ b/includes/tlasharptla-dll-md.md
@@ -0,0 +1 @@
+ダイナミック リンク ライブラリ (DLL)
\ No newline at end of file
diff --git a/includes/tlasharptla-dpi-md.md b/includes/tlasharptla-dpi-md.md
new file mode 100644
index 00000000000..38cf78124bc
--- /dev/null
+++ b/includes/tlasharptla-dpi-md.md
@@ -0,0 +1 @@
+ドット/インチ (dpi)
\ No newline at end of file
diff --git a/includes/tlasharptla-dx-md.md b/includes/tlasharptla-dx-md.md
new file mode 100644
index 00000000000..89f25213363
--- /dev/null
+++ b/includes/tlasharptla-dx-md.md
@@ -0,0 +1 @@
+Microsoft DirectX
\ No newline at end of file
diff --git a/includes/tlasharptla-emf-md.md b/includes/tlasharptla-emf-md.md
new file mode 100644
index 00000000000..887ad775092
--- /dev/null
+++ b/includes/tlasharptla-emf-md.md
@@ -0,0 +1 @@
+拡張メタファイル (EMF)
\ No newline at end of file
diff --git a/includes/tlasharptla-exif-md.md b/includes/tlasharptla-exif-md.md
new file mode 100644
index 00000000000..fda8263a8ee
--- /dev/null
+++ b/includes/tlasharptla-exif-md.md
@@ -0,0 +1 @@
+Exchangeable Image File (Exif)
\ No newline at end of file
diff --git a/includes/tlasharptla-gac-md.md b/includes/tlasharptla-gac-md.md
new file mode 100644
index 00000000000..68a7dd0e22e
--- /dev/null
+++ b/includes/tlasharptla-gac-md.md
@@ -0,0 +1 @@
+グローバル アセンブリ キャッシュ (GAC)
\ No newline at end of file
diff --git a/includes/tlasharptla-gdi-md.md b/includes/tlasharptla-gdi-md.md
new file mode 100644
index 00000000000..47599990ee5
--- /dev/null
+++ b/includes/tlasharptla-gdi-md.md
@@ -0,0 +1 @@
+Microsoft Windows グラフィックス デバイス インターフェイス (GDI)
\ No newline at end of file
diff --git a/includes/tlasharptla-gdiplus-md.md b/includes/tlasharptla-gdiplus-md.md
new file mode 100644
index 00000000000..143855e7bc8
--- /dev/null
+++ b/includes/tlasharptla-gdiplus-md.md
@@ -0,0 +1 @@
+Microsoft Windows GDI+
\ No newline at end of file
diff --git a/includes/tlasharptla-gif-md.md b/includes/tlasharptla-gif-md.md
new file mode 100644
index 00000000000..e31b9049fb1
--- /dev/null
+++ b/includes/tlasharptla-gif-md.md
@@ -0,0 +1 @@
+グラフィックス インターチェンジ形式 (GIF)
\ No newline at end of file
diff --git a/includes/tlasharptla-gpu-md.md b/includes/tlasharptla-gpu-md.md
new file mode 100644
index 00000000000..e449410517d
--- /dev/null
+++ b/includes/tlasharptla-gpu-md.md
@@ -0,0 +1 @@
+グラフィック処理装置 (GPU)
\ No newline at end of file
diff --git a/includes/tlasharptla-gui-md.md b/includes/tlasharptla-gui-md.md
new file mode 100644
index 00000000000..fad09e2bada
--- /dev/null
+++ b/includes/tlasharptla-gui-md.md
@@ -0,0 +1 @@
+グラフィカル ユーザー インターフェイス (GUI)
\ No newline at end of file
diff --git a/includes/tlasharptla-guisharpplural-md.md b/includes/tlasharptla-guisharpplural-md.md
new file mode 100644
index 00000000000..fad09e2bada
--- /dev/null
+++ b/includes/tlasharptla-guisharpplural-md.md
@@ -0,0 +1 @@
+グラフィカル ユーザー インターフェイス (GUI)
\ No newline at end of file
diff --git a/includes/tlasharptla-html-md.md b/includes/tlasharptla-html-md.md
new file mode 100644
index 00000000000..3225efc49a9
--- /dev/null
+++ b/includes/tlasharptla-html-md.md
@@ -0,0 +1 @@
+HTML
\ No newline at end of file
diff --git a/includes/tlasharptla-ide-md.md b/includes/tlasharptla-ide-md.md
new file mode 100644
index 00000000000..63ca44f7804
--- /dev/null
+++ b/includes/tlasharptla-ide-md.md
@@ -0,0 +1 @@
+統合開発環境 (IDE)
\ No newline at end of file
diff --git a/includes/tlasharptla-idsharpplural-md.md b/includes/tlasharptla-idsharpplural-md.md
new file mode 100644
index 00000000000..41911cf6248
--- /dev/null
+++ b/includes/tlasharptla-idsharpplural-md.md
@@ -0,0 +1 @@
+識別子 (ID)
\ No newline at end of file
diff --git a/includes/tlasharptla-ie-md.md b/includes/tlasharptla-ie-md.md
new file mode 100644
index 00000000000..a0e6d7ff79e
--- /dev/null
+++ b/includes/tlasharptla-ie-md.md
@@ -0,0 +1 @@
+Microsoft Internet Explorer
\ No newline at end of file
diff --git a/includes/tlasharptla-ie6-md.md b/includes/tlasharptla-ie6-md.md
new file mode 100644
index 00000000000..e880d15a013
--- /dev/null
+++ b/includes/tlasharptla-ie6-md.md
@@ -0,0 +1 @@
+Microsoft Internet Explorer 6
\ No newline at end of file
diff --git a/includes/tlasharptla-ie6sp2-md.md b/includes/tlasharptla-ie6sp2-md.md
new file mode 100644
index 00000000000..a8470bdbf81
--- /dev/null
+++ b/includes/tlasharptla-ie6sp2-md.md
@@ -0,0 +1 @@
+Microsoft Internet Explorer 6 (SP2)
\ No newline at end of file
diff --git a/includes/tlasharptla-ie7-md.md b/includes/tlasharptla-ie7-md.md
new file mode 100644
index 00000000000..7e19a10469c
--- /dev/null
+++ b/includes/tlasharptla-ie7-md.md
@@ -0,0 +1 @@
+Windows Internet Explorer 7
\ No newline at end of file
diff --git a/includes/tlasharptla-iegeneric-md.md b/includes/tlasharptla-iegeneric-md.md
new file mode 100644
index 00000000000..2563bf1452e
--- /dev/null
+++ b/includes/tlasharptla-iegeneric-md.md
@@ -0,0 +1 @@
+Windows Internet Explorer
\ No newline at end of file
diff --git a/includes/tlasharptla-ifd-md.md b/includes/tlasharptla-ifd-md.md
new file mode 100644
index 00000000000..c1226fe8eaa
--- /dev/null
+++ b/includes/tlasharptla-ifd-md.md
@@ -0,0 +1 @@
+イメージ ファイル ディレクトリ (IFD)
\ No newline at end of file
diff --git a/includes/tlasharptla-iis50-md.md b/includes/tlasharptla-iis50-md.md
new file mode 100644
index 00000000000..ba86af901df
--- /dev/null
+++ b/includes/tlasharptla-iis50-md.md
@@ -0,0 +1 @@
+Microsoft インターネット インフォメーション サービス (IIS) 5.0
\ No newline at end of file
diff --git a/includes/tlasharptla-iis60-md.md b/includes/tlasharptla-iis60-md.md
new file mode 100644
index 00000000000..7390adb88c7
--- /dev/null
+++ b/includes/tlasharptla-iis60-md.md
@@ -0,0 +1 @@
+Microsoft インターネット インフォメーション サービス (IIS) 6.0
\ No newline at end of file
diff --git a/includes/tlasharptla-iis70-md.md b/includes/tlasharptla-iis70-md.md
new file mode 100644
index 00000000000..3bfe7f98d2e
--- /dev/null
+++ b/includes/tlasharptla-iis70-md.md
@@ -0,0 +1 @@
+Microsoft インターネット インフォメーション サービス (IIS) 7.0
\ No newline at end of file
diff --git a/includes/tlasharptla-imesharpplural-md.md b/includes/tlasharptla-imesharpplural-md.md
new file mode 100644
index 00000000000..fc4bb42c624
--- /dev/null
+++ b/includes/tlasharptla-imesharpplural-md.md
@@ -0,0 +1 @@
+入力方式エディター (IME)
\ No newline at end of file
diff --git a/includes/tlasharptla-iptc-md.md b/includes/tlasharptla-iptc-md.md
new file mode 100644
index 00000000000..6b6a70ab5fc
--- /dev/null
+++ b/includes/tlasharptla-iptc-md.md
@@ -0,0 +1 @@
+国際新聞通信委員会 (IPTC)
\ No newline at end of file
diff --git a/includes/tlasharptla-jpeg-md.md b/includes/tlasharptla-jpeg-md.md
new file mode 100644
index 00000000000..d4d1537f685
--- /dev/null
+++ b/includes/tlasharptla-jpeg-md.md
@@ -0,0 +1 @@
+JPEG
\ No newline at end of file
diff --git a/includes/tlasharptla-jpegorg-md.md b/includes/tlasharptla-jpegorg-md.md
new file mode 100644
index 00000000000..5936d841425
--- /dev/null
+++ b/includes/tlasharptla-jpegorg-md.md
@@ -0,0 +1 @@
+Joint Photographics Experts Group (JPEG)
\ No newline at end of file
diff --git a/includes/tlasharptla-lhcshrp-md.md b/includes/tlasharptla-lhcshrp-md.md
new file mode 100644
index 00000000000..9fe41fc4939
--- /dev/null
+++ b/includes/tlasharptla-lhcshrp-md.md
@@ -0,0 +1 @@
+C#
\ No newline at end of file
diff --git a/includes/tlasharptla-lhsdk-md.md b/includes/tlasharptla-lhsdk-md.md
new file mode 100644
index 00000000000..fc75fdfade4
--- /dev/null
+++ b/includes/tlasharptla-lhsdk-md.md
@@ -0,0 +1 @@
+Windows Software Development Kit (SDK)
\ No newline at end of file
diff --git a/includes/tlasharptla-longhorn-md.md b/includes/tlasharptla-longhorn-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/tlasharptla-longhorn-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/tlasharptla-longhorn2-md.md b/includes/tlasharptla-longhorn2-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/tlasharptla-longhorn2-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/tlasharptla-mcxmlnsv1-md.md b/includes/tlasharptla-mcxmlnsv1-md.md
new file mode 100644
index 00000000000..24b44042eb3
--- /dev/null
+++ b/includes/tlasharptla-mcxmlnsv1-md.md
@@ -0,0 +1 @@
+http://schemas.openxmlformats.org/markup-compatibility/2006
\ No newline at end of file
diff --git a/includes/tlasharptla-mdi-md.md b/includes/tlasharptla-mdi-md.md
new file mode 100644
index 00000000000..473811a8c02
--- /dev/null
+++ b/includes/tlasharptla-mdi-md.md
@@ -0,0 +1 @@
+マルチドキュメント インターフェイス (MDI)
\ No newline at end of file
diff --git a/includes/tlasharptla-metro-md.md b/includes/tlasharptla-metro-md.md
new file mode 100644
index 00000000000..b0d87920a46
--- /dev/null
+++ b/includes/tlasharptla-metro-md.md
@@ -0,0 +1 @@
+XML Paper Specification (XPS)
\ No newline at end of file
diff --git a/includes/tlasharptla-mime-md.md b/includes/tlasharptla-mime-md.md
new file mode 100644
index 00000000000..dfe9753fb7a
--- /dev/null
+++ b/includes/tlasharptla-mime-md.md
@@ -0,0 +1 @@
+Multipurpose Internet Mail Extensions (MIME)
\ No newline at end of file
diff --git a/includes/tlasharptla-mmc-md.md b/includes/tlasharptla-mmc-md.md
new file mode 100644
index 00000000000..3d097dc8c2e
--- /dev/null
+++ b/includes/tlasharptla-mmc-md.md
@@ -0,0 +1 @@
+Microsoft 管理コンソール (MMC)
\ No newline at end of file
diff --git a/includes/tlasharptla-ms-md.md b/includes/tlasharptla-ms-md.md
new file mode 100644
index 00000000000..a04fcf98800
--- /dev/null
+++ b/includes/tlasharptla-ms-md.md
@@ -0,0 +1 @@
+Microsoft
\ No newline at end of file
diff --git a/includes/tlasharptla-msbuild-md.md b/includes/tlasharptla-msbuild-md.md
new file mode 100644
index 00000000000..de4524474b1
--- /dev/null
+++ b/includes/tlasharptla-msbuild-md.md
@@ -0,0 +1 @@
+Microsoft Build Engine (MSBuild)
\ No newline at end of file
diff --git a/includes/tlasharptla-mssharpinitcap-md.md b/includes/tlasharptla-mssharpinitcap-md.md
new file mode 100644
index 00000000000..a04fcf98800
--- /dev/null
+++ b/includes/tlasharptla-mssharpinitcap-md.md
@@ -0,0 +1 @@
+Microsoft
\ No newline at end of file
diff --git a/includes/tlasharptla-mswin-md.md b/includes/tlasharptla-mswin-md.md
new file mode 100644
index 00000000000..1058cb39495
--- /dev/null
+++ b/includes/tlasharptla-mswin-md.md
@@ -0,0 +1 @@
+Windows
\ No newline at end of file
diff --git a/includes/tlasharptla-mxdw-md.md b/includes/tlasharptla-mxdw-md.md
new file mode 100644
index 00000000000..049b823ec3b
--- /dev/null
+++ b/includes/tlasharptla-mxdw-md.md
@@ -0,0 +1 @@
+Microsoft XPS Document Writer
\ No newline at end of file
diff --git a/includes/tlasharptla-net-md.md b/includes/tlasharptla-net-md.md
new file mode 100644
index 00000000000..ed5316af359
--- /dev/null
+++ b/includes/tlasharptla-net-md.md
@@ -0,0 +1 @@
+Microsoft .NET
\ No newline at end of file
diff --git a/includes/tlasharptla-netframewk-md.md b/includes/tlasharptla-netframewk-md.md
new file mode 100644
index 00000000000..53910744e82
--- /dev/null
+++ b/includes/tlasharptla-netframewk-md.md
@@ -0,0 +1 @@
+Microsoft .NET Framework
\ No newline at end of file
diff --git a/includes/tlasharptla-netframewkattr-md.md b/includes/tlasharptla-netframewkattr-md.md
new file mode 100644
index 00000000000..120deaf1f6c
--- /dev/null
+++ b/includes/tlasharptla-netframewkattr-md.md
@@ -0,0 +1 @@
+.NET Framework 属性
\ No newline at end of file
diff --git a/includes/tlasharptla-opc-md.md b/includes/tlasharptla-opc-md.md
new file mode 100644
index 00000000000..9ccd0d9bfe5
--- /dev/null
+++ b/includes/tlasharptla-opc-md.md
@@ -0,0 +1 @@
+Open Packaging Conventions (OPC)
\ No newline at end of file
diff --git a/includes/tlasharptla-opentype-md.md b/includes/tlasharptla-opentype-md.md
new file mode 100644
index 00000000000..fad0b0bfa09
--- /dev/null
+++ b/includes/tlasharptla-opentype-md.md
@@ -0,0 +1 @@
+OpenType
\ No newline at end of file
diff --git a/includes/tlasharptla-outlook-md.md b/includes/tlasharptla-outlook-md.md
new file mode 100644
index 00000000000..624028563d0
--- /dev/null
+++ b/includes/tlasharptla-outlook-md.md
@@ -0,0 +1 @@
+Microsoft Outlook
\ No newline at end of file
diff --git a/includes/tlasharptla-pinvoke-md.md b/includes/tlasharptla-pinvoke-md.md
new file mode 100644
index 00000000000..0d12b408f92
--- /dev/null
+++ b/includes/tlasharptla-pinvoke-md.md
@@ -0,0 +1 @@
+プラットフォーム呼び出しサービス (PInvoke)
\ No newline at end of file
diff --git a/includes/tlasharptla-png-md.md b/includes/tlasharptla-png-md.md
new file mode 100644
index 00000000000..1a288fd6a96
--- /dev/null
+++ b/includes/tlasharptla-png-md.md
@@ -0,0 +1 @@
+ポータブル ネットワーク グラフィックス (PNG)
\ No newline at end of file
diff --git a/includes/tlasharptla-rgb-md.md b/includes/tlasharptla-rgb-md.md
new file mode 100644
index 00000000000..17c90f8dc7e
--- /dev/null
+++ b/includes/tlasharptla-rgb-md.md
@@ -0,0 +1 @@
+RGB
\ No newline at end of file
diff --git a/includes/tlasharptla-rm-md.md b/includes/tlasharptla-rm-md.md
new file mode 100644
index 00000000000..5544a658b59
--- /dev/null
+++ b/includes/tlasharptla-rm-md.md
@@ -0,0 +1 @@
+Microsoft Windows Rights Management \(RM\)
\ No newline at end of file
diff --git a/includes/tlasharptla-sdk-md.md b/includes/tlasharptla-sdk-md.md
new file mode 100644
index 00000000000..d2344f26ba9
--- /dev/null
+++ b/includes/tlasharptla-sdk-md.md
@@ -0,0 +1 @@
+ソフトウェア開発キット (SDK)
\ No newline at end of file
diff --git a/includes/tlasharptla-sdl-md.md b/includes/tlasharptla-sdl-md.md
new file mode 100644
index 00000000000..b335c6a7071
--- /dev/null
+++ b/includes/tlasharptla-sdl-md.md
@@ -0,0 +1 @@
+Microsoft セキュリティ開発ライフサイクル (SDL)
\ No newline at end of file
diff --git a/includes/tlasharptla-sql-md.md b/includes/tlasharptla-sql-md.md
new file mode 100644
index 00000000000..d1e9f6c72ff
--- /dev/null
+++ b/includes/tlasharptla-sql-md.md
@@ -0,0 +1 @@
+構造化照会言語 (SQL)
\ No newline at end of file
diff --git a/includes/tlasharptla-tiff-md.md b/includes/tlasharptla-tiff-md.md
new file mode 100644
index 00000000000..68948a6cc5f
--- /dev/null
+++ b/includes/tlasharptla-tiff-md.md
@@ -0,0 +1 @@
+Tagged Image File Format (TIFF)
\ No newline at end of file
diff --git a/includes/tlasharptla-titlewinclient-md.md b/includes/tlasharptla-titlewinclient-md.md
new file mode 100644
index 00000000000..92826b01ec3
--- /dev/null
+++ b/includes/tlasharptla-titlewinclient-md.md
@@ -0,0 +1 @@
+WPF
\ No newline at end of file
diff --git a/includes/tlasharptla-titlexaml-md.md b/includes/tlasharptla-titlexaml-md.md
new file mode 100644
index 00000000000..7d3d6afaedc
--- /dev/null
+++ b/includes/tlasharptla-titlexaml-md.md
@@ -0,0 +1 @@
+XAML
\ No newline at end of file
diff --git a/includes/tlasharptla-tpc-md.md b/includes/tlasharptla-tpc-md.md
new file mode 100644
index 00000000000..834bcfc55be
--- /dev/null
+++ b/includes/tlasharptla-tpc-md.md
@@ -0,0 +1 @@
+Tablet PC
\ No newline at end of file
diff --git a/includes/tlasharptla-truetype-md.md b/includes/tlasharptla-truetype-md.md
new file mode 100644
index 00000000000..39747723bc0
--- /dev/null
+++ b/includes/tlasharptla-truetype-md.md
@@ -0,0 +1 @@
+TrueType®
\ No newline at end of file
diff --git a/includes/tlasharptla-tsf-md.md b/includes/tlasharptla-tsf-md.md
new file mode 100644
index 00000000000..2556e5fe5f5
--- /dev/null
+++ b/includes/tlasharptla-tsf-md.md
@@ -0,0 +1 @@
+テキスト サービス フレームワーク (TSF)
\ No newline at end of file
diff --git a/includes/tlasharptla-ui-md.md b/includes/tlasharptla-ui-md.md
new file mode 100644
index 00000000000..c36b4b85e3f
--- /dev/null
+++ b/includes/tlasharptla-ui-md.md
@@ -0,0 +1 @@
+ユーザー インターフェイス (UI)
\ No newline at end of file
diff --git a/includes/tlasharptla-uiautomation-md.md b/includes/tlasharptla-uiautomation-md.md
new file mode 100644
index 00000000000..4cc21ca4004
--- /dev/null
+++ b/includes/tlasharptla-uiautomation-md.md
@@ -0,0 +1 @@
+Microsoft UI オートメーション
\ No newline at end of file
diff --git a/includes/tlasharptla-uisharpinitcap-md.md b/includes/tlasharptla-uisharpinitcap-md.md
new file mode 100644
index 00000000000..c36b4b85e3f
--- /dev/null
+++ b/includes/tlasharptla-uisharpinitcap-md.md
@@ -0,0 +1 @@
+ユーザー インターフェイス (UI)
\ No newline at end of file
diff --git a/includes/tlasharptla-uisharpplural-md.md b/includes/tlasharptla-uisharpplural-md.md
new file mode 100644
index 00000000000..c36b4b85e3f
--- /dev/null
+++ b/includes/tlasharptla-uisharpplural-md.md
@@ -0,0 +1 @@
+ユーザー インターフェイス (UI)
\ No newline at end of file
diff --git a/includes/tlasharptla-uispy-md.md b/includes/tlasharptla-uispy-md.md
new file mode 100644
index 00000000000..3bbc7695828
--- /dev/null
+++ b/includes/tlasharptla-uispy-md.md
@@ -0,0 +1 @@
+UI Spy
\ No newline at end of file
diff --git a/includes/tlasharptla-unc-md.md b/includes/tlasharptla-unc-md.md
new file mode 100644
index 00000000000..9282ff33288
--- /dev/null
+++ b/includes/tlasharptla-unc-md.md
@@ -0,0 +1 @@
+汎用名前付け規則 (UCS)
\ No newline at end of file
diff --git a/includes/tlasharptla-unicode-md.md b/includes/tlasharptla-unicode-md.md
new file mode 100644
index 00000000000..a0388044512
--- /dev/null
+++ b/includes/tlasharptla-unicode-md.md
@@ -0,0 +1 @@
+Unicode
\ No newline at end of file
diff --git a/includes/tlasharptla-uri-md.md b/includes/tlasharptla-uri-md.md
new file mode 100644
index 00000000000..112d659f00c
--- /dev/null
+++ b/includes/tlasharptla-uri-md.md
@@ -0,0 +1 @@
+Uniform Resource Identifier (URI)
\ No newline at end of file
diff --git a/includes/tlasharptla-urisharpplural-md.md b/includes/tlasharptla-urisharpplural-md.md
new file mode 100644
index 00000000000..112d659f00c
--- /dev/null
+++ b/includes/tlasharptla-urisharpplural-md.md
@@ -0,0 +1 @@
+Uniform Resource Identifier (URI)
\ No newline at end of file
diff --git a/includes/tlasharptla-url-md.md b/includes/tlasharptla-url-md.md
new file mode 100644
index 00000000000..e6a755c451b
--- /dev/null
+++ b/includes/tlasharptla-url-md.md
@@ -0,0 +1 @@
+URL
\ No newline at end of file
diff --git a/includes/tlasharptla-vb6-md.md b/includes/tlasharptla-vb6-md.md
new file mode 100644
index 00000000000..ae29f898761
--- /dev/null
+++ b/includes/tlasharptla-vb6-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic 6.0
\ No newline at end of file
diff --git a/includes/tlasharptla-vcshrp-md.md b/includes/tlasharptla-vcshrp-md.md
new file mode 100644
index 00000000000..c2b6fdaa9b4
--- /dev/null
+++ b/includes/tlasharptla-vcshrp-md.md
@@ -0,0 +1 @@
+Microsoft Visual C#
\ No newline at end of file
diff --git a/includes/tlasharptla-visualb-md.md b/includes/tlasharptla-visualb-md.md
new file mode 100644
index 00000000000..701504fd7ea
--- /dev/null
+++ b/includes/tlasharptla-visualb-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic
\ No newline at end of file
diff --git a/includes/tlasharptla-visualbnet-md.md b/includes/tlasharptla-visualbnet-md.md
new file mode 100644
index 00000000000..9654edd1e64
--- /dev/null
+++ b/includes/tlasharptla-visualbnet-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic .NET
\ No newline at end of file
diff --git a/includes/tlasharptla-visualbscrpt-md.md b/includes/tlasharptla-visualbscrpt-md.md
new file mode 100644
index 00000000000..f25249f7b02
--- /dev/null
+++ b/includes/tlasharptla-visualbscrpt-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic Scripting Edition (VBScript)
\ No newline at end of file
diff --git a/includes/tlasharptla-visualcpp-md.md b/includes/tlasharptla-visualcpp-md.md
new file mode 100644
index 00000000000..f60d81ab056
--- /dev/null
+++ b/includes/tlasharptla-visualcpp-md.md
@@ -0,0 +1 @@
+Microsoft Visual C++
\ No newline at end of file
diff --git a/includes/tlasharptla-visualstu-md.md b/includes/tlasharptla-visualstu-md.md
new file mode 100644
index 00000000000..5f8ebc7ff9a
--- /dev/null
+++ b/includes/tlasharptla-visualstu-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio
\ No newline at end of file
diff --git a/includes/tlasharptla-visualstu2005-md.md b/includes/tlasharptla-visualstu2005-md.md
new file mode 100644
index 00000000000..aedf061c2e3
--- /dev/null
+++ b/includes/tlasharptla-visualstu2005-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio 2005
\ No newline at end of file
diff --git a/includes/tlasharptla-w3c-md.md b/includes/tlasharptla-w3c-md.md
new file mode 100644
index 00000000000..15f12bbe3ce
--- /dev/null
+++ b/includes/tlasharptla-w3c-md.md
@@ -0,0 +1 @@
+World Wide Web Consortium (W3C)
\ No newline at end of file
diff --git a/includes/tlasharptla-wdp-md.md b/includes/tlasharptla-wdp-md.md
new file mode 100644
index 00000000000..d184490a59f
--- /dev/null
+++ b/includes/tlasharptla-wdp-md.md
@@ -0,0 +1 @@
+Microsoft Windows Media Photo
\ No newline at end of file
diff --git a/includes/tlasharptla-wic-md.md b/includes/tlasharptla-wic-md.md
new file mode 100644
index 00000000000..65980dc89ff
--- /dev/null
+++ b/includes/tlasharptla-wic-md.md
@@ -0,0 +1 @@
+Microsoft Windows Presentation Foundation イメージング コンポーネント
\ No newline at end of file
diff --git a/includes/tlasharptla-win-md.md b/includes/tlasharptla-win-md.md
new file mode 100644
index 00000000000..09919ea7bee
--- /dev/null
+++ b/includes/tlasharptla-win-md.md
@@ -0,0 +1 @@
+Microsoft Windows
\ No newline at end of file
diff --git a/includes/tlasharptla-win-update-md.md b/includes/tlasharptla-win-update-md.md
new file mode 100644
index 00000000000..dcee70c3157
--- /dev/null
+++ b/includes/tlasharptla-win-update-md.md
@@ -0,0 +1 @@
+Microsoft Windows Update
\ No newline at end of file
diff --git a/includes/tlasharptla-win32-md.md b/includes/tlasharptla-win32-md.md
new file mode 100644
index 00000000000..df14f554429
--- /dev/null
+++ b/includes/tlasharptla-win32-md.md
@@ -0,0 +1 @@
+Win32
\ No newline at end of file
diff --git a/includes/tlasharptla-winclient-md.md b/includes/tlasharptla-winclient-md.md
new file mode 100644
index 00000000000..ec2f2b4ecea
--- /dev/null
+++ b/includes/tlasharptla-winclient-md.md
@@ -0,0 +1 @@
+Windows Presentation Foundation (WPF)
\ No newline at end of file
diff --git a/includes/tlasharptla-winexpl-md.md b/includes/tlasharptla-winexpl-md.md
new file mode 100644
index 00000000000..75e09dc7919
--- /dev/null
+++ b/includes/tlasharptla-winexpl-md.md
@@ -0,0 +1 @@
+Microsoft Windows エクスプローラー
\ No newline at end of file
diff --git a/includes/tlasharptla-winforms-md.md b/includes/tlasharptla-winforms-md.md
new file mode 100644
index 00000000000..64713036cb6
--- /dev/null
+++ b/includes/tlasharptla-winforms-md.md
@@ -0,0 +1 @@
+Windows フォーム
\ No newline at end of file
diff --git a/includes/tlasharptla-winfx-md.md b/includes/tlasharptla-winfx-md.md
new file mode 100644
index 00000000000..53910744e82
--- /dev/null
+++ b/includes/tlasharptla-winfx-md.md
@@ -0,0 +1 @@
+Microsoft .NET Framework
\ No newline at end of file
diff --git a/includes/tlasharptla-winfxsdk-md.md b/includes/tlasharptla-winfxsdk-md.md
new file mode 100644
index 00000000000..fc75fdfade4
--- /dev/null
+++ b/includes/tlasharptla-winfxsdk-md.md
@@ -0,0 +1 @@
+Windows Software Development Kit (SDK)
\ No newline at end of file
diff --git a/includes/tlasharptla-winfxwebappsharpplural-md.md b/includes/tlasharptla-winfxwebappsharpplural-md.md
new file mode 100644
index 00000000000..8be9f658053
--- /dev/null
+++ b/includes/tlasharptla-winfxwebappsharpplural-md.md
@@ -0,0 +1 @@
+XAML ブラウザー アプリケーション (XBAP)
\ No newline at end of file
diff --git a/includes/tlasharptla-wininstall-md.md b/includes/tlasharptla-wininstall-md.md
new file mode 100644
index 00000000000..40b9e0e1d8c
--- /dev/null
+++ b/includes/tlasharptla-wininstall-md.md
@@ -0,0 +1 @@
+Microsoft Windows インストーラー
\ No newline at end of file
diff --git a/includes/tlasharptla-winmedia-md.md b/includes/tlasharptla-winmedia-md.md
new file mode 100644
index 00000000000..7501b7a1cda
--- /dev/null
+++ b/includes/tlasharptla-winmedia-md.md
@@ -0,0 +1 @@
+Microsoft Windows Media
\ No newline at end of file
diff --git a/includes/tlasharptla-winnetsvrfam-md.md b/includes/tlasharptla-winnetsvrfam-md.md
new file mode 100644
index 00000000000..e20849463a2
--- /dev/null
+++ b/includes/tlasharptla-winnetsvrfam-md.md
@@ -0,0 +1 @@
+Microsoft Windows Server 2003
\ No newline at end of file
diff --git a/includes/tlasharptla-winnetsvrfamsp1-md.md b/includes/tlasharptla-winnetsvrfamsp1-md.md
new file mode 100644
index 00000000000..bd572b9ca27
--- /dev/null
+++ b/includes/tlasharptla-winnetsvrfamsp1-md.md
@@ -0,0 +1 @@
+Microsoft Windows Server 2003 (SP1)
\ No newline at end of file
diff --git a/includes/tlasharptla-winvista-md.md b/includes/tlasharptla-winvista-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/tlasharptla-winvista-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/tlasharptla-winxp-md.md b/includes/tlasharptla-winxp-md.md
new file mode 100644
index 00000000000..e0723a78af5
--- /dev/null
+++ b/includes/tlasharptla-winxp-md.md
@@ -0,0 +1 @@
+Microsoft Windows XP
\ No newline at end of file
diff --git a/includes/tlasharptla-winxpsp2-md.md b/includes/tlasharptla-winxpsp2-md.md
new file mode 100644
index 00000000000..dff79382946
--- /dev/null
+++ b/includes/tlasharptla-winxpsp2-md.md
@@ -0,0 +1 @@
+Microsoft Windows XP Service Pack 2 (SP2)
\ No newline at end of file
diff --git a/includes/tlasharptla-wmp-md.md b/includes/tlasharptla-wmp-md.md
new file mode 100644
index 00000000000..64ccfac2dc7
--- /dev/null
+++ b/includes/tlasharptla-wmp-md.md
@@ -0,0 +1 @@
+Microsoft Windows Media Player
\ No newline at end of file
diff --git a/includes/tlasharptla-word-md.md b/includes/tlasharptla-word-md.md
new file mode 100644
index 00000000000..4c0765a254f
--- /dev/null
+++ b/includes/tlasharptla-word-md.md
@@ -0,0 +1 @@
+Microsoft Word
\ No newline at end of file
diff --git a/includes/tlasharptla-workflow-md.md b/includes/tlasharptla-workflow-md.md
new file mode 100644
index 00000000000..ffd4b425ff7
--- /dev/null
+++ b/includes/tlasharptla-workflow-md.md
@@ -0,0 +1 @@
+Windows Workflow Foundation
\ No newline at end of file
diff --git a/includes/tlasharptla-wpf-md.md b/includes/tlasharptla-wpf-md.md
new file mode 100644
index 00000000000..ec2f2b4ecea
--- /dev/null
+++ b/includes/tlasharptla-wpf-md.md
@@ -0,0 +1 @@
+Windows Presentation Foundation (WPF)
\ No newline at end of file
diff --git a/includes/tlasharptla-wpfbrowserappproj-md.md b/includes/tlasharptla-wpfbrowserappproj-md.md
new file mode 100644
index 00000000000..396727c010f
--- /dev/null
+++ b/includes/tlasharptla-wpfbrowserappproj-md.md
@@ -0,0 +1 @@
+XAML ブラウザー アプリケーション (WPF)
\ No newline at end of file
diff --git a/includes/tlasharptla-wpfxmlnsv1-md.md b/includes/tlasharptla-wpfxmlnsv1-md.md
new file mode 100644
index 00000000000..c3ac9ff53a1
--- /dev/null
+++ b/includes/tlasharptla-wpfxmlnsv1-md.md
@@ -0,0 +1 @@
+http://schemas.microsoft.com/winfx/2006/xaml/presentation
\ No newline at end of file
diff --git a/includes/tlasharptla-wys-md.md b/includes/tlasharptla-wys-md.md
new file mode 100644
index 00000000000..31cce07ed37
--- /dev/null
+++ b/includes/tlasharptla-wys-md.md
@@ -0,0 +1 @@
+"What You See Is What You Get" (WYSIWYG)
\ No newline at end of file
diff --git a/includes/tlasharptla-xaml-md.md b/includes/tlasharptla-xaml-md.md
new file mode 100644
index 00000000000..64155c7f9ba
--- /dev/null
+++ b/includes/tlasharptla-xaml-md.md
@@ -0,0 +1 @@
+Extensible Application Markup Language (XAML)
\ No newline at end of file
diff --git a/includes/tlasharptla-xamlsharpinitcap-md.md b/includes/tlasharptla-xamlsharpinitcap-md.md
new file mode 100644
index 00000000000..64155c7f9ba
--- /dev/null
+++ b/includes/tlasharptla-xamlsharpinitcap-md.md
@@ -0,0 +1 @@
+Extensible Application Markup Language (XAML)
\ No newline at end of file
diff --git a/includes/tlasharptla-xamlxmlnsv1-md.md b/includes/tlasharptla-xamlxmlnsv1-md.md
new file mode 100644
index 00000000000..b9fd82d7dfa
--- /dev/null
+++ b/includes/tlasharptla-xamlxmlnsv1-md.md
@@ -0,0 +1 @@
+http://schemas.microsoft.com/winfx/2006/xaml
\ No newline at end of file
diff --git a/includes/tlasharptla-xbap-md.md b/includes/tlasharptla-xbap-md.md
new file mode 100644
index 00000000000..8be9f658053
--- /dev/null
+++ b/includes/tlasharptla-xbap-md.md
@@ -0,0 +1 @@
+XAML ブラウザー アプリケーション (XBAP)
\ No newline at end of file
diff --git a/includes/tlasharptla-xbapsharpplural-md.md b/includes/tlasharptla-xbapsharpplural-md.md
new file mode 100644
index 00000000000..8be9f658053
--- /dev/null
+++ b/includes/tlasharptla-xbapsharpplural-md.md
@@ -0,0 +1 @@
+XAML ブラウザー アプリケーション (XBAP)
\ No newline at end of file
diff --git a/includes/tlasharptla-xl-md.md b/includes/tlasharptla-xl-md.md
new file mode 100644
index 00000000000..45a379d7eac
--- /dev/null
+++ b/includes/tlasharptla-xl-md.md
@@ -0,0 +1 @@
+Microsoft Excel
\ No newline at end of file
diff --git a/includes/tlasharptla-xml-md.md b/includes/tlasharptla-xml-md.md
new file mode 100644
index 00000000000..f86a2f5fe92
--- /dev/null
+++ b/includes/tlasharptla-xml-md.md
@@ -0,0 +1 @@
+XML
\ No newline at end of file
diff --git a/includes/tlasharptla-xmldom-md.md b/includes/tlasharptla-xmldom-md.md
new file mode 100644
index 00000000000..76ef7b33c73
--- /dev/null
+++ b/includes/tlasharptla-xmldom-md.md
@@ -0,0 +1 @@
+XML ドキュメント オブジェクト モデル (DOM)
\ No newline at end of file
diff --git a/includes/tlasharptla-xmp-md.md b/includes/tlasharptla-xmp-md.md
new file mode 100644
index 00000000000..395e08728db
--- /dev/null
+++ b/includes/tlasharptla-xmp-md.md
@@ -0,0 +1 @@
+拡張可能メタデータ プラットフォーム (XMP)
\ No newline at end of file
diff --git a/includes/tlasharptla-xps-md.md b/includes/tlasharptla-xps-md.md
new file mode 100644
index 00000000000..b0d87920a46
--- /dev/null
+++ b/includes/tlasharptla-xps-md.md
@@ -0,0 +1 @@
+XML Paper Specification (XPS)
\ No newline at end of file
diff --git a/includes/tsql-md.md b/includes/tsql-md.md
new file mode 100644
index 00000000000..4b57ddad132
--- /dev/null
+++ b/includes/tsql-md.md
@@ -0,0 +1 @@
+Transact-SQL
\ No newline at end of file
diff --git a/includes/vb-current-short-md.md b/includes/vb-current-short-md.md
new file mode 100644
index 00000000000..777515bcd7e
--- /dev/null
+++ b/includes/vb-current-short-md.md
@@ -0,0 +1 @@
+Visual Basic
\ No newline at end of file
diff --git a/includes/vb-orcas-long-md.md b/includes/vb-orcas-long-md.md
new file mode 100644
index 00000000000..5ea91318d24
--- /dev/null
+++ b/includes/vb-orcas-long-md.md
@@ -0,0 +1 @@
+Visual Basic 2008
\ No newline at end of file
diff --git a/includes/vbprvb-md.md b/includes/vbprvb-md.md
new file mode 100644
index 00000000000..777515bcd7e
--- /dev/null
+++ b/includes/vbprvb-md.md
@@ -0,0 +1 @@
+Visual Basic
\ No newline at end of file
diff --git a/includes/vbprvbext-md.md b/includes/vbprvbext-md.md
new file mode 100644
index 00000000000..d2677871c70
--- /dev/null
+++ b/includes/vbprvbext-md.md
@@ -0,0 +1 @@
+Microsoft Visual Basic 2005
\ No newline at end of file
diff --git a/includes/vbprvblong-md.md b/includes/vbprvblong-md.md
new file mode 100644
index 00000000000..34139d90424
--- /dev/null
+++ b/includes/vbprvblong-md.md
@@ -0,0 +1 @@
+Visual Basic 2005
\ No newline at end of file
diff --git a/includes/vbtecdlinq-md.md b/includes/vbtecdlinq-md.md
new file mode 100644
index 00000000000..52781fca7e9
--- /dev/null
+++ b/includes/vbtecdlinq-md.md
@@ -0,0 +1 @@
+LINQ to SQL
\ No newline at end of file
diff --git a/includes/vbteclinq-md.md b/includes/vbteclinq-md.md
new file mode 100644
index 00000000000..28c6d25f691
--- /dev/null
+++ b/includes/vbteclinq-md.md
@@ -0,0 +1 @@
+LINQ
\ No newline at end of file
diff --git a/includes/vbteclinqext-md.md b/includes/vbteclinqext-md.md
new file mode 100644
index 00000000000..d855d42cd76
--- /dev/null
+++ b/includes/vbteclinqext-md.md
@@ -0,0 +1 @@
+統合言語クエリ (LINQ: Language-Integrated Query)
\ No newline at end of file
diff --git a/includes/vcpransi-md.md b/includes/vcpransi-md.md
new file mode 100644
index 00000000000..77364e050ee
--- /dev/null
+++ b/includes/vcpransi-md.md
@@ -0,0 +1 @@
+ANSI
\ No newline at end of file
diff --git a/includes/vcpritanium-md.md b/includes/vcpritanium-md.md
new file mode 100644
index 00000000000..6f421d66285
--- /dev/null
+++ b/includes/vcpritanium-md.md
@@ -0,0 +1 @@
+Itanium
\ No newline at end of file
diff --git a/includes/vcprvc-md.md b/includes/vcprvc-md.md
new file mode 100644
index 00000000000..c6d2435e98d
--- /dev/null
+++ b/includes/vcprvc-md.md
@@ -0,0 +1 @@
+Visual C++
\ No newline at end of file
diff --git a/includes/vs-current-long-md.md b/includes/vs-current-long-md.md
new file mode 100644
index 00000000000..e42d5412a81
--- /dev/null
+++ b/includes/vs-current-long-md.md
@@ -0,0 +1 @@
+Visual Studio 2012
\ No newline at end of file
diff --git a/includes/vs-current-short-md.md b/includes/vs-current-short-md.md
new file mode 100644
index 00000000000..fe15234ba36
--- /dev/null
+++ b/includes/vs-current-short-md.md
@@ -0,0 +1 @@
+Visual Studio
\ No newline at end of file
diff --git a/includes/vs-dev10-ext-md.md b/includes/vs-dev10-ext-md.md
new file mode 100644
index 00000000000..b41a7e6dcff
--- /dev/null
+++ b/includes/vs-dev10-ext-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio 2010
\ No newline at end of file
diff --git a/includes/vs-dev10-long-md.md b/includes/vs-dev10-long-md.md
new file mode 100644
index 00000000000..eaf2ee2b1c2
--- /dev/null
+++ b/includes/vs-dev10-long-md.md
@@ -0,0 +1 @@
+Visual Studio 2010
\ No newline at end of file
diff --git a/includes/vs-dev11-ext-md.md b/includes/vs-dev11-ext-md.md
new file mode 100644
index 00000000000..af7697e5649
--- /dev/null
+++ b/includes/vs-dev11-ext-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio 2012
\ No newline at end of file
diff --git a/includes/vs-dev11-long-md.md b/includes/vs-dev11-long-md.md
new file mode 100644
index 00000000000..e42d5412a81
--- /dev/null
+++ b/includes/vs-dev11-long-md.md
@@ -0,0 +1 @@
+Visual Studio 2012
\ No newline at end of file
diff --git a/includes/vs-dev12-md.md b/includes/vs-dev12-md.md
new file mode 100644
index 00000000000..19c512da049
--- /dev/null
+++ b/includes/vs-dev12-md.md
@@ -0,0 +1 @@
+Visual Studio 2013
\ No newline at end of file
diff --git a/includes/vs-dev14-md.md b/includes/vs-dev14-md.md
new file mode 100644
index 00000000000..bbfd799366a
--- /dev/null
+++ b/includes/vs-dev14-md.md
@@ -0,0 +1 @@
+Visual Studio 2015
\ No newline at end of file
diff --git a/includes/vs-orcas-long-md.md b/includes/vs-orcas-long-md.md
new file mode 100644
index 00000000000..80f0fb84087
--- /dev/null
+++ b/includes/vs-orcas-long-md.md
@@ -0,0 +1 @@
+Visual Studio 2008
\ No newline at end of file
diff --git a/includes/vs-ordesigner-long-md.md b/includes/vs-ordesigner-long-md.md
new file mode 100644
index 00000000000..00424e0c8fe
--- /dev/null
+++ b/includes/vs-ordesigner-long-md.md
@@ -0,0 +1 @@
+Object Relational Designer
\ No newline at end of file
diff --git a/includes/vs-ordesigner-short-md.md b/includes/vs-ordesigner-short-md.md
new file mode 100644
index 00000000000..0480e403930
--- /dev/null
+++ b/includes/vs-ordesigner-short-md.md
@@ -0,0 +1 @@
+O/R デザイナー
\ No newline at end of file
diff --git a/includes/vs2010-md.md b/includes/vs2010-md.md
new file mode 100644
index 00000000000..eaf2ee2b1c2
--- /dev/null
+++ b/includes/vs2010-md.md
@@ -0,0 +1 @@
+Visual Studio 2010
\ No newline at end of file
diff --git a/includes/vsindigo-md.md b/includes/vsindigo-md.md
new file mode 100644
index 00000000000..98b719c6a72
--- /dev/null
+++ b/includes/vsindigo-md.md
@@ -0,0 +1 @@
+Windows Communication Foundation (WCF)
\ No newline at end of file
diff --git a/includes/vsorcas-md.md b/includes/vsorcas-md.md
new file mode 100644
index 00000000000..9e6c99a9c07
--- /dev/null
+++ b/includes/vsorcas-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio 2008
\ No newline at end of file
diff --git a/includes/vsprvs-md.md b/includes/vsprvs-md.md
new file mode 100644
index 00000000000..fe15234ba36
--- /dev/null
+++ b/includes/vsprvs-md.md
@@ -0,0 +1 @@
+Visual Studio
\ No newline at end of file
diff --git a/includes/vsprvsext-md.md b/includes/vsprvsext-md.md
new file mode 100644
index 00000000000..aedf061c2e3
--- /dev/null
+++ b/includes/vsprvsext-md.md
@@ -0,0 +1 @@
+Microsoft Visual Studio 2005
\ No newline at end of file
diff --git a/includes/vsprvslong-md.md b/includes/vsprvslong-md.md
new file mode 100644
index 00000000000..33fb76fddc1
--- /dev/null
+++ b/includes/vsprvslong-md.md
@@ -0,0 +1 @@
+Visual Studio 2005
\ No newline at end of file
diff --git a/includes/vsprvsts-md.md b/includes/vsprvsts-md.md
new file mode 100644
index 00000000000..1ffe7b2ea6f
--- /dev/null
+++ b/includes/vsprvsts-md.md
@@ -0,0 +1 @@
+Visual Studio アプリケーション ライフサイクル管理
\ No newline at end of file
diff --git a/includes/vstecado-md.md b/includes/vstecado-md.md
new file mode 100644
index 00000000000..7b6552e6405
--- /dev/null
+++ b/includes/vstecado-md.md
@@ -0,0 +1 @@
+ADO.NET
\ No newline at end of file
diff --git a/includes/vstecasp-md.md b/includes/vstecasp-md.md
new file mode 100644
index 00000000000..f41705de76e
--- /dev/null
+++ b/includes/vstecasp-md.md
@@ -0,0 +1 @@
+ASP.NET
\ No newline at end of file
diff --git a/includes/vstecasplong-md.md b/includes/vstecasplong-md.md
new file mode 100644
index 00000000000..04bf8881097
--- /dev/null
+++ b/includes/vstecasplong-md.md
@@ -0,0 +1 @@
+ASP.NET 2.0
\ No newline at end of file
diff --git a/includes/vstecwinfx-md.md b/includes/vstecwinfx-md.md
new file mode 100644
index 00000000000..44eea9d5b55
--- /dev/null
+++ b/includes/vstecwinfx-md.md
@@ -0,0 +1 @@
+WinFX
\ No newline at end of file
diff --git a/includes/vsultshort-md.md b/includes/vsultshort-md.md
new file mode 100644
index 00000000000..c24469703aa
--- /dev/null
+++ b/includes/vsultshort-md.md
@@ -0,0 +1 @@
+Visual Studio Ultimate
\ No newline at end of file
diff --git a/includes/wf-md.md b/includes/wf-md.md
new file mode 100644
index 00000000000..4292088cb74
--- /dev/null
+++ b/includes/wf-md.md
@@ -0,0 +1 @@
+Windows Workflow Foundation (WF)
\ No newline at end of file
diff --git a/includes/wf1-md.md b/includes/wf1-md.md
new file mode 100644
index 00000000000..c99b2aafaa7
--- /dev/null
+++ b/includes/wf1-md.md
@@ -0,0 +1 @@
+WF
\ No newline at end of file
diff --git a/includes/wf2-md.md b/includes/wf2-md.md
new file mode 100644
index 00000000000..ffd4b425ff7
--- /dev/null
+++ b/includes/wf2-md.md
@@ -0,0 +1 @@
+Windows Workflow Foundation
\ No newline at end of file
diff --git a/includes/wfd1-md.md b/includes/wfd1-md.md
new file mode 100644
index 00000000000..6019d18fc6e
--- /dev/null
+++ b/includes/wfd1-md.md
@@ -0,0 +1 @@
+Windows ワークフロー デザイナー
\ No newline at end of file
diff --git a/includes/wfd2-md.md b/includes/wfd2-md.md
new file mode 100644
index 00000000000..29e7ae2df14
--- /dev/null
+++ b/includes/wfd2-md.md
@@ -0,0 +1 @@
+ワークフロー デザイナー
\ No newline at end of file
diff --git a/includes/win7-client-firstref-md.md b/includes/win7-client-firstref-md.md
new file mode 100644
index 00000000000..55bbce130fb
--- /dev/null
+++ b/includes/win7-client-firstref-md.md
@@ -0,0 +1 @@
+Windows°7 オペレーティング システム
\ No newline at end of file
diff --git a/includes/win7-client-secondref-md.md b/includes/win7-client-secondref-md.md
new file mode 100644
index 00000000000..062fce950f1
--- /dev/null
+++ b/includes/win7-client-secondref-md.md
@@ -0,0 +1 @@
+Windows°7
\ No newline at end of file
diff --git a/includes/win7-md.md b/includes/win7-md.md
new file mode 100644
index 00000000000..0bef53745cf
--- /dev/null
+++ b/includes/win7-md.md
@@ -0,0 +1 @@
+Windows 7
\ No newline at end of file
diff --git a/includes/win8-appname-long-md.md b/includes/win8-appname-long-md.md
new file mode 100644
index 00000000000..2d563392335
--- /dev/null
+++ b/includes/win8-appname-long-md.md
@@ -0,0 +1 @@
+Windows 8.x ストア
\ No newline at end of file
diff --git a/includes/win8-appstore-long-md.md b/includes/win8-appstore-long-md.md
new file mode 100644
index 00000000000..51095b4e1b1
--- /dev/null
+++ b/includes/win8-appstore-long-md.md
@@ -0,0 +1 @@
+Windows ストア
\ No newline at end of file
diff --git a/includes/win8-md.md b/includes/win8-md.md
new file mode 100644
index 00000000000..f851b514732
--- /dev/null
+++ b/includes/win8-md.md
@@ -0,0 +1 @@
+Windows 8
\ No newline at end of file
diff --git a/includes/win81-md.md b/includes/win81-md.md
new file mode 100644
index 00000000000..bcc2351f5f1
--- /dev/null
+++ b/includes/win81-md.md
@@ -0,0 +1 @@
+Windows 8.1
\ No newline at end of file
diff --git a/includes/win98-md.md b/includes/win98-md.md
new file mode 100644
index 00000000000..290b6ca32bc
--- /dev/null
+++ b/includes/win98-md.md
@@ -0,0 +1 @@
+Windows 98
\ No newline at end of file
diff --git a/includes/winblue-server-2-md.md b/includes/winblue-server-2-md.md
new file mode 100644
index 00000000000..c1db122e4fa
--- /dev/null
+++ b/includes/winblue-server-2-md.md
@@ -0,0 +1 @@
+Windows Server 2012 R2
\ No newline at end of file
diff --git a/includes/windowsver-md.md b/includes/windowsver-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/windowsver-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/winsdk-md.md b/includes/winsdk-md.md
new file mode 100644
index 00000000000..6da97bda29c
--- /dev/null
+++ b/includes/winsdk-md.md
@@ -0,0 +1 @@
+Windows SDK
\ No newline at end of file
diff --git a/includes/winsdklong-md.md b/includes/winsdklong-md.md
new file mode 100644
index 00000000000..fc75fdfade4
--- /dev/null
+++ b/includes/winsdklong-md.md
@@ -0,0 +1 @@
+Windows Software Development Kit (SDK)
\ No newline at end of file
diff --git a/includes/winsdkshort-md.md b/includes/winsdkshort-md.md
new file mode 100644
index 00000000000..6da97bda29c
--- /dev/null
+++ b/includes/winsdkshort-md.md
@@ -0,0 +1 @@
+Windows SDK
\ No newline at end of file
diff --git a/includes/winserver8-md.md b/includes/winserver8-md.md
new file mode 100644
index 00000000000..918f6d7ac6a
--- /dev/null
+++ b/includes/winserver8-md.md
@@ -0,0 +1 @@
+Windows Server 2012
\ No newline at end of file
diff --git a/includes/winxp-md.md b/includes/winxp-md.md
new file mode 100644
index 00000000000..936c76a97d4
--- /dev/null
+++ b/includes/winxp-md.md
@@ -0,0 +1 @@
+Windows XP
\ No newline at end of file
diff --git a/includes/winxpfamily-md.md b/includes/winxpfamily-md.md
new file mode 100644
index 00000000000..bcedaf827b8
--- /dev/null
+++ b/includes/winxpfamily-md.md
@@ -0,0 +1 @@
+Windows XP Home Edition、Windows XP Professional、Windows Server 2003
\ No newline at end of file
diff --git a/includes/winxpsvr-md.md b/includes/winxpsvr-md.md
new file mode 100644
index 00000000000..5e9d928e681
--- /dev/null
+++ b/includes/winxpsvr-md.md
@@ -0,0 +1 @@
+Windows Server 2003
\ No newline at end of file
diff --git a/includes/wiprlhext-md.md b/includes/wiprlhext-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/wiprlhext-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/wpfdesigner-current-long-md.md b/includes/wpfdesigner-current-long-md.md
new file mode 100644
index 00000000000..82e1233fccc
--- /dev/null
+++ b/includes/wpfdesigner-current-long-md.md
@@ -0,0 +1 @@
+WPF Designer for Visual Studio
\ No newline at end of file
diff --git a/includes/wpfdesigner-current-short-md.md b/includes/wpfdesigner-current-short-md.md
new file mode 100644
index 00000000000..bfe60036c23
--- /dev/null
+++ b/includes/wpfdesigner-current-short-md.md
@@ -0,0 +1 @@
+WPF デザイナー
\ No newline at end of file
diff --git a/includes/wrt-md.md b/includes/wrt-md.md
new file mode 100644
index 00000000000..cebdaac27d9
--- /dev/null
+++ b/includes/wrt-md.md
@@ -0,0 +1 @@
+Windows ランタイム
\ No newline at end of file
diff --git a/includes/ws2003-md.md b/includes/ws2003-md.md
new file mode 100644
index 00000000000..5e9d928e681
--- /dev/null
+++ b/includes/ws2003-md.md
@@ -0,0 +1 @@
+Windows Server 2003
\ No newline at end of file
diff --git a/includes/ws2003r2-md.md b/includes/ws2003r2-md.md
new file mode 100644
index 00000000000..b8d00f41ac1
--- /dev/null
+++ b/includes/ws2003r2-md.md
@@ -0,0 +1 @@
+Windows Server 2003 R2
\ No newline at end of file
diff --git a/includes/ws2003sp1-md.md b/includes/ws2003sp1-md.md
new file mode 100644
index 00000000000..63ecc4f9ad7
--- /dev/null
+++ b/includes/ws2003sp1-md.md
@@ -0,0 +1 @@
+Windows Server 2003 SP1
\ No newline at end of file
diff --git a/includes/wv-md.md b/includes/wv-md.md
new file mode 100644
index 00000000000..394a749f72d
--- /dev/null
+++ b/includes/wv-md.md
@@ -0,0 +1 @@
+Windows Vista
\ No newline at end of file
diff --git a/includes/wxp-md.md b/includes/wxp-md.md
new file mode 100644
index 00000000000..936c76a97d4
--- /dev/null
+++ b/includes/wxp-md.md
@@ -0,0 +1 @@
+Windows XP
\ No newline at end of file
diff --git a/includes/wxppro-md.md b/includes/wxppro-md.md
new file mode 100644
index 00000000000..15f02f47fdc
--- /dev/null
+++ b/includes/wxppro-md.md
@@ -0,0 +1 @@
+Windows XP Professional
\ No newline at end of file
diff --git a/includes/wxpsp2-md.md b/includes/wxpsp2-md.md
new file mode 100644
index 00000000000..04a512a7f73
--- /dev/null
+++ b/includes/wxpsp2-md.md
@@ -0,0 +1 @@
+Windows XP SP2
\ No newline at end of file